Skip to content

Open-source Grok Bot alternative for named AI teammates. Local-first desktop, web, and mobile clients with per-bot tools, instructions, and memory. Independent fork of T3 Code.

[codex] Sync app-server protocol, service tiers, and provider startup (#3036)

Julius Marmingeae7e88b0e0bc
diff --git a/apps/server/src/codexModelOptions.test.ts b/apps/server/src/codexModelOptions.test.ts
new file mode 100644
index 000000000..d035a60a4
--- /dev/null
+++ b/apps/server/src/codexModelOptions.test.ts
@@ -0,0 +1,22 @@
+import { assert, it } from "@effect/vitest";
+
+import { ProviderInstanceId } from "@t3tools/contracts";
+import { createModelSelection } from "@t3tools/shared/model";
+
+import { getCodexServiceTierOptionValue } from "./codexModelOptions.ts";
+
+it("returns the selected Codex service tier id", () => {
+ const selection = createModelSelection(ProviderInstanceId.make("codex"), "gpt-5.5", [
+ { id: "serviceTier", value: "flex" },
+ ]);
+
+ assert.equal(getCodexServiceTierOptionValue(selection), "flex");
+});
+
+it("keeps legacy persisted fast mode selections working", () => {
+ const selection = createModelSelection(ProviderInstanceId.make("codex"), "gpt-5.4", [
+ { id: "fastMode", value: true },
+ ]);
+
+ assert.equal(getCodexServiceTierOptionValue(selection), "fast");
+});
diff --git a/apps/server/src/codexModelOptions.ts b/apps/server/src/codexModelOptions.ts
new file mode 100644
index 000000000..43b8a3c18
--- /dev/null
+++ b/apps/server/src/codexModelOptions.ts
@@ -0,0 +1,14 @@
+import type { ModelSelection } from "@t3tools/contracts";
+import {
+ getModelSelectionBooleanOptionValue,
+ getModelSelectionStringOptionValue,
+} from "@t3tools/shared/model";
+
+export function getCodexServiceTierOptionValue(
+ modelSelection: ModelSelection | null | undefined,
+): string | undefined {
+ return (
+ getModelSelectionStringOptionValue(modelSelection, "serviceTier") ??
+ (getModelSelectionBooleanOptionValue(modelSelection, "fastMode") === true ? "fast" : undefined)
+ );
+}
diff --git a/apps/server/src/provider/Layers/CodexAdapter.test.ts b/apps/server/src/provider/Layers/CodexAdapter.test.ts
index 3ae98ec24..04ef44d54 100644
--- a/apps/server/src/provider/Layers/CodexAdapter.test.ts
+++ b/apps/server/src/provider/Layers/CodexAdapter.test.ts
@@ -271,7 +271,7 @@ validationLayer("CodexAdapterLive validation", (it) => {
provider: ProviderDriverKind.make("codex"),
threadId: asThreadId("thread-1"),
modelSelection: createModelSelection(ProviderInstanceId.make("codex"), "gpt-5.3-codex", [
- { id: "fastMode", value: true },
+ { id: "serviceTier", value: "priority" },
]),
runtimeMode: "full-access",
});
@@ -281,7 +281,7 @@ validationLayer("CodexAdapterLive validation", (it) => {
cwd: process.cwd(),
model: "gpt-5.3-codex",
providerInstanceId: ProviderInstanceId.make("codex"),
- serviceTier: "fast",
+ serviceTier: "priority",
threadId: asThreadId("thread-1"),
runtimeMode: "full-access",
});
@@ -344,7 +344,7 @@ sessionErrorLayer("CodexAdapterLive session errors", (it) => {
input: "hello",
modelSelection: createModelSelection(ProviderInstanceId.make("codex"), "gpt-5.3-codex", [
{ id: "reasoningEffort", value: "high" },
- { id: "fastMode", value: true },
+ { id: "serviceTier", value: "priority" },
]),
attachments: [],
}),
@@ -354,7 +354,7 @@ sessionErrorLayer("CodexAdapterLive session errors", (it) => {
input: "hello",
model: "gpt-5.3-codex",
effort: "high",
- serviceTier: "fast",
+ serviceTier: "priority",
});
}),
);
@@ -398,7 +398,7 @@ sessionErrorLayer("CodexAdapterLive session errors", (it) => {
"gpt-5.3-codex",
[
{ id: "reasoningEffort", value: "high" },
- { id: "fastMode", value: true },
+ { id: "serviceTier", value: "flex" },
],
),
attachments: [],
@@ -409,7 +409,7 @@ sessionErrorLayer("CodexAdapterLive session errors", (it) => {
input: "hello",
model: "gpt-5.3-codex",
effort: "high",
- serviceTier: "fast",
+ serviceTier: "flex",
});
}).pipe(Effect.provide(customLayer));
});
diff --git a/apps/server/src/provider/Layers/CodexAdapter.ts b/apps/server/src/provider/Layers/CodexAdapter.ts
index 9893cf6c1..8c9969e2b 100644
--- a/apps/server/src/provider/Layers/CodexAdapter.ts
+++ b/apps/server/src/provider/Layers/CodexAdapter.ts
@@ -37,10 +37,8 @@ import { ChildProcessSpawner } from "effect/unstable/process";
import * as CodexErrors from "effect-codex-app-server/errors";
import * as EffectCodexSchema from "effect-codex-app-server/schema";
-import {
- getModelSelectionBooleanOptionValue,
- getModelSelectionStringOptionValue,
-} from "@t3tools/shared/model";
+import { getModelSelectionStringOptionValue } from "@t3tools/shared/model";
+import { getCodexServiceTierOptionValue } from "../../codexModelOptions.ts";
import {
ProviderAdapterRequestError,
@@ -1380,6 +1378,10 @@ export const makeCodexAdapter = Effect.fn("makeCodexAdapter")(function* (
yield* Effect.suspend(() => stopSessionInternal(existing));
}
+ const serviceTier =
+ input.modelSelection?.instanceId === boundInstanceId
+ ? getCodexServiceTierOptionValue(input.modelSelection)
+ : undefined;
const runtimeInput: CodexSessionRuntimeOptions = {
threadId: input.threadId,
providerInstanceId: boundInstanceId,
@@ -1394,10 +1396,7 @@ export const makeCodexAdapter = Effect.fn("makeCodexAdapter")(function* (
...(input.modelSelection?.instanceId === boundInstanceId
? { model: input.modelSelection.model }
: {}),
- ...(input.modelSelection?.instanceId === boundInstanceId &&
- getModelSelectionBooleanOptionValue(input.modelSelection, "fastMode") === true
- ? { serviceTier: "fast" }
- : {}),
+ ...(serviceTier ? { serviceTier } : {}),
};
const sessionScope = yield* Scope.make("sequential");
let sessionScopeTransferred = false;
@@ -1513,9 +1512,9 @@ export const makeCodexAdapter = Effect.fn("makeCodexAdapter")(function* (
input.modelSelection?.instanceId === boundInstanceId
? getModelSelectionStringOptionValue(input.modelSelection, "reasoningEffort")
: undefined;
- const fastMode =
+ const serviceTier =
input.modelSelection?.instanceId === boundInstanceId
- ? getModelSelectionBooleanOptionValue(input.modelSelection, "fastMode")
+ ? getCodexServiceTierOptionValue(input.modelSelection)
: undefined;
return yield* session.runtime
.sendTurn({
@@ -1528,7 +1527,7 @@ export const makeCodexAdapter = Effect.fn("makeCodexAdapter")(function* (
effort: reasoningEffort as EffectCodexSchema.V2TurnStartParams__ReasoningEffort,
}
: {}),
- ...(fastMode === true ? { serviceTier: "fast" } : {}),
+ ...(serviceTier ? { serviceTier } : {}),
...(input.interactionMode !== undefined ? { interactionMode: input.interactionMode } : {}),
...(codexAttachments.length > 0 ? { attachments: codexAttachments } : {}),
})
diff --git a/apps/server/src/provider/Layers/CodexProvider.test.ts b/apps/server/src/provider/Layers/CodexProvider.test.ts
new file mode 100644
index 000000000..0e21b7630
--- /dev/null
+++ b/apps/server/src/provider/Layers/CodexProvider.test.ts
@@ -0,0 +1,104 @@
+import { assert, it } from "@effect/vitest";
+
+import { mapCodexModelCapabilities } from "./CodexProvider.ts";
+
+it("maps current Codex model capability fields", () => {
+ const capabilities = mapCodexModelCapabilities({
+ additionalSpeedTiers: [],
+ defaultReasoningEffort: "super-high",
+ description: "Test model",
+ displayName: "GPT Test",
+ hidden: false,
+ id: "gpt-test",
+ isDefault: true,
+ model: "gpt-test",
+ defaultServiceTier: "flex",
+ serviceTiers: [
+ {
+ id: "priority",
+ name: "Fast",
+ description: "Lower latency responses.",
+ },
+ {
+ id: "flex",
+ name: "Flex",
+ description: "Lower-cost asynchronous routing.",
+ },
+ ],
+ supportedReasoningEfforts: [
+ {
+ description: "Maximum reasoning",
+ reasoningEffort: "super-high",
+ },
+ ],
+ });
+
+ assert.deepStrictEqual(capabilities.optionDescriptors, [
+ {
+ id: "reasoningEffort",
+ label: "Reasoning",
+ type: "select",
+ options: [{ id: "super-high", label: "super-high", isDefault: true }],
+ currentValue: "super-high",
+ },
+ {
+ id: "serviceTier",
+ label: "Service Tier",
+ type: "select",
+ options: [
+ { id: "default", label: "Standard" },
+ {
+ id: "priority",
+ label: "Fast",
+ description: "Lower latency responses.",
+ },
+ {
+ id: "flex",
+ label: "Flex",
+ description: "Lower-cost asynchronous routing.",
+ isDefault: true,
+ },
+ ],
+ currentValue: "flex",
+ },
+ ]);
+});
+
+it("uses standard routing when the catalog has no default service tier", () => {
+ const capabilities = mapCodexModelCapabilities({
+ additionalSpeedTiers: ["fast"],
+ defaultReasoningEffort: "medium",
+ defaultServiceTier: null,
+ description: "Test model",
+ displayName: "GPT Test",
+ hidden: false,
+ id: "gpt-test",
+ isDefault: true,
+ model: "gpt-test",
+ serviceTiers: [
+ {
+ id: "priority",
+ name: "Fast",
+ description: "1.5x speed, increased usage",
+ },
+ ],
+ supportedReasoningEfforts: [],
+ });
+
+ assert.deepStrictEqual(capabilities.optionDescriptors, [
+ {
+ id: "serviceTier",
+ label: "Service Tier",
+ type: "select",
+ options: [
+ { id: "default", label: "Standard", isDefault: true },
+ {
+ id: "priority",
+ label: "Fast",
+ description: "1.5x speed, increased usage",
+ },
+ ],
+ currentValue: "default",
+ },
+ ]);
+});
diff --git a/apps/server/src/provider/Layers/CodexProvider.ts b/apps/server/src/provider/Layers/CodexProvider.ts
index 4d793194c..89d7421b2 100644
--- a/apps/server/src/provider/Layers/CodexProvider.ts
+++ b/apps/server/src/provider/Layers/CodexProvider.ts
@@ -17,6 +17,7 @@ import type {
ServerProvider,
ServerProviderState,
ModelCapabilities,
+ ProviderOptionDescriptor,
ServerProviderModel,
ServerProviderSkill,
} from "@t3tools/contracts";
@@ -44,7 +45,7 @@ export interface CodexAppServerProviderSnapshot {
readonly skills: ReadonlyArray<ServerProviderSkill>;
}
-const REASONING_EFFORT_LABELS: Record<CodexSchema.V2ModelListResponse__ReasoningEffort, string> = {
+const REASONING_EFFORT_LABELS: Readonly<Record<string, string>> = {
none: "None",
minimal: "Minimal",
low: "Low",
@@ -53,6 +54,12 @@ const REASONING_EFFORT_LABELS: Record<CodexSchema.V2ModelListResponse__Reasoning
xhigh: "Extra High",
};
+const DEFAULT_SERVICE_TIER_ID = "default";
+
+function reasoningEffortLabel(reasoningEffort: string): string {
+ return REASONING_EFFORT_LABELS[reasoningEffort] ?? reasoningEffort;
+}
+
function codexAccountAuthLabel(account: CodexSchema.V2GetAccountResponse["account"]) {
if (!account) return undefined;
if (account.type === "apiKey") return "OpenAI API Key";
@@ -93,46 +100,71 @@ function codexAccountEmail(account: CodexSchema.V2GetAccountResponse["account"])
return account.email;
}
-function mapCodexModelCapabilities(
+export function mapCodexModelCapabilities(
model: CodexSchema.V2ModelListResponse__Model,
): ModelCapabilities {
const reasoningOptions = model.supportedReasoningEfforts.map(({ reasoningEffort }) =>
reasoningEffort === model.defaultReasoningEffort
? {
id: reasoningEffort,
- label: REASONING_EFFORT_LABELS[reasoningEffort],
+ label: reasoningEffortLabel(reasoningEffort),
isDefault: true,
}
: {
id: reasoningEffort,
- label: REASONING_EFFORT_LABELS[reasoningEffort],
+ label: reasoningEffortLabel(reasoningEffort),
},
);
const defaultReasoning = reasoningOptions.find((option) => option.isDefault)?.id;
- const supportsFastMode = (model.additionalSpeedTiers ?? []).includes("fast");
+ const serviceTiers =
+ model.serviceTiers && model.serviceTiers.length > 0
+ ? model.serviceTiers
+ : (model.additionalSpeedTiers ?? []).map((id) => ({
+ id,
+ name: id === "fast" ? "Fast" : id,
+ description: "",
+ }));
+ const catalogDefaultServiceTier = serviceTiers.some(
+ (tier) => tier.id === model.defaultServiceTier,
+ )
+ ? model.defaultServiceTier
+ : null;
+ const defaultServiceTier = catalogDefaultServiceTier ?? DEFAULT_SERVICE_TIER_ID;
+ const optionDescriptors: ProviderOptionDescriptor[] = [];
+
+ if (reasoningOptions.length > 0) {
+ optionDescriptors.push({
+ id: "reasoningEffort",
+ label: "Reasoning",
+ type: "select",
+ options: reasoningOptions,
+ ...(defaultReasoning ? { currentValue: defaultReasoning } : {}),
+ });
+ }
+ if (serviceTiers.length > 0) {
+ optionDescriptors.push({
+ id: "serviceTier",
+ label: "Service Tier",
+ type: "select",
+ options: [
+ {
+ id: DEFAULT_SERVICE_TIER_ID,
+ label: "Standard",
+ ...(defaultServiceTier === DEFAULT_SERVICE_TIER_ID ? { isDefault: true } : {}),
+ },
+ ...serviceTiers.map((tier) => ({
+ id: tier.id,
+ label: tier.name,
+ ...(tier.description ? { description: tier.description } : {}),
+ ...(defaultServiceTier === tier.id ? { isDefault: true } : {}),
+ })),
+ ],
+ currentValue: defaultServiceTier,
+ });
+ }
+
return createModelCapabilities({
- optionDescriptors: [
- ...(reasoningOptions.length > 0
- ? [
- {
- id: "reasoningEffort",
- label: "Reasoning",
- type: "select" as const,
- options: reasoningOptions,
- ...(defaultReasoning ? { currentValue: defaultReasoning } : {}),
- },
- ]
- : []),
- ...(supportsFastMode
- ? [
- {
- id: "fastMode",
- label: "Fast Mode",
- type: "boolean" as const,
- },
- ]
- : []),
- ],
+ optionDescriptors,
});
}
diff --git a/apps/server/src/provider/Layers/ProviderRegistry.test.ts b/apps/server/src/provider/Layers/ProviderRegistry.test.ts
index 273cf22f3..56b80f6c4 100644
--- a/apps/server/src/provider/Layers/ProviderRegistry.test.ts
+++ b/apps/server/src/provider/Layers/ProviderRegistry.test.ts
@@ -594,6 +594,77 @@ it.layer(Layer.mergeAll(NodeServices.layer, ServerSettingsService.layerTest(), T
]);
});
+ it.effect("does not run provider probes during layer construction", () =>
+ Effect.gen(function* () {
+ const codexDriver = ProviderDriverKind.make("codex");
+ const codexInstanceId = ProviderInstanceId.make("codex");
+ const initialProvider = {
+ instanceId: codexInstanceId,
+ driver: codexDriver,
+ status: "warning",
+ enabled: true,
+ installed: false,
+ auth: { status: "unknown" },
+ checkedAt: "2026-06-10T00:00:00.000Z",
+ version: null,
+ message: "Checking Codex provider status.",
+ models: [],
+ slashCommands: [],
+ skills: [],
+ } as const satisfies ServerProvider;
+ const refreshCalls = yield* Ref.make(0);
+ const instance = {
+ instanceId: codexInstanceId,
+ driverKind: codexDriver,
+ continuationIdentity: {
+ driverKind: codexDriver,
+ continuationKey: "codex:instance:codex",
+ },
+ displayName: undefined,
+ enabled: true,
+ snapshot: {
+ maintenanceCapabilities: makeManualOnlyProviderMaintenanceCapabilities({
+ provider: codexDriver,
+ packageName: null,
+ }),
+ getSnapshot: Effect.succeed(initialProvider),
+ refresh: Ref.update(refreshCalls, (count) => count + 1).pipe(
+ Effect.andThen(Effect.never),
+ ),
+ streamChanges: Stream.empty,
+ },
+ adapter: {} as ProviderInstance["adapter"],
+ textGeneration: {} as ProviderInstance["textGeneration"],
+ } satisfies ProviderInstance;
+ const instanceRegistryLayer = Layer.succeed(ProviderInstanceRegistry, {
+ getInstance: (instanceId) =>
+ Effect.succeed(instanceId === codexInstanceId ? instance : undefined),
+ listInstances: Effect.succeed([instance]),
+ listUnavailable: Effect.succeed([]),
+ streamChanges: Stream.empty,
+ subscribeChanges: Effect.flatMap(PubSub.unbounded<void>(), PubSub.subscribe),
+ });
+ const scope = yield* Scope.make();
+ yield* Effect.addFinalizer(() => Scope.close(scope, Exit.void));
+ const runtimeServices = yield* Layer.build(
+ ProviderRegistryLive.pipe(
+ Layer.provideMerge(instanceRegistryLayer),
+ Layer.provideMerge(
+ ServerConfig.layerTest(process.cwd(), {
+ prefix: "t3-provider-registry-background-refresh-",
+ }),
+ ),
+ Layer.provideMerge(NodeServices.layer),
+ ),
+ ).pipe(Scope.provide(scope));
+ yield* Effect.gen(function* () {
+ const registry = yield* ProviderRegistry;
+ assert.deepStrictEqual(yield* registry.getProviders, [initialProvider]);
+ assert.strictEqual(yield* Ref.get(refreshCalls), 0);
+ }).pipe(Effect.provide(runtimeServices));
+ }),
+ );
+
it("persists merged provider snapshots for the providers that were refreshed", () => {
const previousProviders = [
{
@@ -1042,7 +1113,17 @@ it.layer(Layer.mergeAll(NodeServices.layer, ServerSettingsService.layerTest(), T
yield* Effect.gen(function* () {
const registry = yield* ProviderRegistry;
- const providers = yield* registry.getProviders;
+ let providers = yield* registry.getProviders;
+ for (
+ let attempts = 0;
+ attempts < 50 &&
+ providers.find((provider) => provider.instanceId === "codex_personal")?.status !==
+ "error";
+ attempts += 1
+ ) {
+ yield* Effect.yieldNow;
+ providers = yield* registry.getProviders;
+ }
const codexPersonal = providers.find(
(provider) => provider.instanceId === "codex_personal",
);
@@ -1072,9 +1153,7 @@ it.layer(Layer.mergeAll(NodeServices.layer, ServerSettingsService.layerTest(), T
// instance and rebuild it so a fresh probe runs with the new binary.
// This test drives the real settings stream → registry reconcile →
// aggregator sync pipeline and asserts that `getProviders` reflects
- // the new probe's outcome. If `syncLiveSources` stops awaiting the
- // rebuilt instance's refresh (previous bug mode), the aggregator
- // keeps the old snapshot and this test fails.
+ // the new background probe's outcome.
//
it.effect("re-probes when settings change the codex binaryPath", () =>
Effect.gen(function* () {
@@ -1124,7 +1203,18 @@ it.layer(Layer.mergeAll(NodeServices.layer, ServerSettingsService.layerTest(), T
// the two probe runs is `checkedAt` — each probe stamps a
// fresh DateTime, so we capture it and assert it advances
// after the settings mutation.
- const initialProviders = yield* registry.getProviders;
+ let initialProviders = yield* registry.getProviders;
+ for (
+ let attempts = 0;
+ attempts < 50 &&
+ initialProviders.find((provider) => provider.instanceId === "codex")?.status !==
+ "error";
+ attempts += 1
+ ) {
+ yield* TestClock.adjust("10 millis");
+ yield* Effect.yieldNow;
+ initialProviders = yield* registry.getProviders;
+ }
const initialCodex = initialProviders.find(
(provider) => provider.instanceId === "codex",
);
@@ -1144,8 +1234,8 @@ it.layer(Layer.mergeAll(NodeServices.layer, ServerSettingsService.layerTest(), T
// envelope changed because `binaryPath` differs → `entryEqual`
// is false). The registry's `Stream.runForEach(
// instanceRegistry.streamChanges, () => syncLiveSources)`
- // fires `syncLiveSources`, which subscribes + awaits a fresh
- // refresh on the rebuilt instance.
+ // fires `syncLiveSources`, which subscribes and launches a fresh
+ // background refresh on the rebuilt instance.
yield* serverSettings.updateSettings({
providers: {
codex: { enabled: true, binaryPath: secondMissing },
@@ -1158,7 +1248,11 @@ it.layer(Layer.mergeAll(NodeServices.layer, ServerSettingsService.layerTest(), T
for (let attempts = 0; attempts < 60; attempts += 1) {
const providers = yield* registry.getProviders;
const codex = providers.find((provider) => provider.instanceId === "codex");
- if (codex !== undefined && codex.checkedAt !== initialCheckedAt) {
+ if (
+ codex !== undefined &&
+ codex.status === "error" &&
+ codex.checkedAt !== initialCheckedAt
+ ) {
return providers;
}
yield* TestClock.adjust("50 millis");
diff --git a/apps/server/src/provider/Layers/ProviderRegistry.ts b/apps/server/src/provider/Layers/ProviderRegistry.ts
index 22a120f0a..2df63e538 100644
--- a/apps/server/src/provider/Layers/ProviderRegistry.ts
+++ b/apps/server/src/provider/Layers/ProviderRegistry.ts
@@ -492,16 +492,15 @@ export const ProviderRegistryLive = Layer.effect(
* - subscribe to each newly-added or rebuilt instance's
* `streamChanges` (so periodic + enrichment refreshes land in
* `providersRef`);
- * - force-refresh each newly-added/rebuilt instance and feed the
- * result directly into `providersRef`, bypassing the PubSub
- * attachment race that otherwise drops the initial probe;
+ * - read each newly-added/rebuilt instance's current snapshot after
+ * subscribing, closing the race with its independently-running
+ * background startup probe;
* - prune `providersRef` of instances that no longer exist.
*
- * Initial refreshes are awaited in parallel rather than forked, so
- * callers (layer build; `streamChanges` watcher) see fully-probed
- * state on return. This matters for layer build in particular:
- * consumers reading `getProviders` immediately after layer build
- * expect the probe to have already landed.
+ * Provider refreshes are owned by each managed provider and never run
+ * on this layer's construction path. Consumers see cached or pending
+ * snapshots immediately, then receive live probe results through the
+ * already-attached change stream.
*
* Per-instance subscription fibers are not tracked explicitly. When
* a rebuilt instance's old child scope closes, its PubSub shuts
@@ -543,27 +542,31 @@ export const ProviderRegistryLive = Layer.effect(
}
// Fork long-lived subscriptions to each new/rebuilt instance's
- // change stream BEFORE kicking off refreshes — if the driver's
- // own initial probe (line 140 in `makeManagedServerProvider`)
- // wins the refreshSemaphore race, its PubSub publish must land
- // in an active subscriber or the result is dropped.
+ // change stream before reading its current snapshot. If the
+ // driver's own initial probe finishes during this sync, either
+ // the current read or the active subscriber observes the result.
for (const [, instance] of newlyAdded) {
const source = buildSnapshotSource(instance);
yield* Stream.runForEach(source.streamChanges, (provider) =>
correlateSnapshotWithSource(source, provider).pipe(Effect.flatMap(syncProvider)),
).pipe(Effect.forkScoped);
}
+ yield* Effect.yieldNow;
- // Force-refresh every new/rebuilt instance in parallel and wait
- // for them all to complete. The refresh's result is piped
- // directly into `syncProvider`, so `providersRef` is populated
- // deterministically by the time this block returns — regardless
- // of PubSub subscription timing. Failures are logged and
- // swallowed so one bad driver can't wedge the whole registry.
+ // Snapshot current state without starting a probe. Managed providers
+ // launch their startup refresh independently, so this closes the
+ // subscription race without putting external work on the registry
+ // or HTTP server construction path.
yield* Effect.forEach(
newlyAdded,
([, instance]) =>
- refreshOneSource(buildSnapshotSource(instance)).pipe(Effect.ignoreCause({ log: true })),
+ Effect.gen(function* () {
+ const source = buildSnapshotSource(instance);
+ const provider = yield* source.getSnapshot;
+ yield* correlateSnapshotWithSource(source, provider).pipe(
+ Effect.flatMap(syncProvider),
+ );
+ }).pipe(Effect.ignoreCause({ log: true })),
{ concurrency: "unbounded", discard: true },
);
yield* upsertProviders(unavailableProviders, {
@@ -654,9 +657,9 @@ export const ProviderRegistryLive = Layer.effect(
// was dropped, which made any settings change that replaced an
// instance never propagate to the aggregator's `providersRef`.)
const instanceChanges = yield* instanceRegistry.subscribeChanges;
- // Initial sync: subscribe + kick off refreshes for every instance
- // present at boot. Run synchronously so consumers pulling immediately
- // after the layer build see the correct aggregator state.
+ // Initial sync attaches subscriptions and snapshots current state for
+ // every instance present at boot. Provider probes are already running in
+ // their managed background fibers and never block this layer.
yield* syncLiveSources;
// React to registry mutations — instance added / removed / rebuilt.
// `Stream.fromSubscription` builds a stream over the pre-acquired
diff --git a/apps/server/src/provider/makeManagedServerProvider.test.ts b/apps/server/src/provider/makeManagedServerProvider.test.ts
index 1f3ebeab0..ba1f01fe2 100644
--- a/apps/server/src/provider/makeManagedServerProvider.test.ts
+++ b/apps/server/src/provider/makeManagedServerProvider.test.ts
@@ -129,6 +129,7 @@ describe("makeManagedServerProvider", () => {
Effect.forkChild,
);
yield* Effect.yieldNow;
+ assert.strictEqual(yield* Ref.get(checkCalls), 1);
yield* Deferred.succeed(releaseCheck, undefined);
diff --git a/apps/server/src/provider/makeManagedServerProvider.ts b/apps/server/src/provider/makeManagedServerProvider.ts
index 2f07c5d50..88547fb3a 100644
--- a/apps/server/src/provider/makeManagedServerProvider.ts
+++ b/apps/server/src/provider/makeManagedServerProvider.ts
@@ -152,11 +152,7 @@ export const makeManagedServerProvider = Effect.fn("makeManagedServerProvider")(
return {
maintenanceCapabilities: input.maintenanceCapabilities,
- getSnapshot: input.getSettings.pipe(
- Effect.flatMap(applySnapshot),
- Effect.tapError(Effect.logError),
- Effect.orDie,
- ),
+ getSnapshot: Ref.get(snapshotStateRef).pipe(Effect.map((state) => state.snapshot)),
refresh: refreshSnapshot().pipe(Effect.tapError(Effect.logError), Effect.orDie),
get streamChanges() {
return Stream.fromPubSub(changesPubSub);
diff --git a/apps/server/src/textGeneration/CodexTextGeneration.test.ts b/apps/server/src/textGeneration/CodexTextGeneration.test.ts
index f72b8100b..cf0ad7d57 100644
--- a/apps/server/src/textGeneration/CodexTextGeneration.test.ts
+++ b/apps/server/src/textGeneration/CodexTextGeneration.test.ts
@@ -32,7 +32,7 @@ function makeFakeCodexBinary(
exitCode?: number;
stderr?: string;
requireImage?: boolean;
- requireFastServiceTier?: boolean;
+ requireServiceTier?: string;
requireReasoningEffort?: string;
forbidReasoningEffort?: boolean;
stdinMustContain?: string;
@@ -52,7 +52,7 @@ function makeFakeCodexBinary(
"#!/bin/sh",
'output_path=""',
'seen_image="0"',
- 'seen_fast_service_tier="0"',
+ 'seen_service_tier=""',
'seen_reasoning_effort=""',
"while [ $# -gt 0 ]; do",
' if [ "$1" = "--image" ]; then',
@@ -65,9 +65,11 @@ function makeFakeCodexBinary(
" fi",
' if [ "$1" = "--config" ]; then',
" shift",
- ' if [ "$1" = "service_tier=\\"fast\\"" ]; then',
- ' seen_fast_service_tier="1"',
- " fi",
+ ' case "$1" in',
+ " service_tier=*)",
+ ' seen_service_tier="$1"',
+ " ;;",
+ " esac",
' case "$1" in',
" model_reasoning_effort=*)",
' seen_reasoning_effort="$1"',
@@ -93,10 +95,10 @@ function makeFakeCodexBinary(
"fi",
]
: []),
- ...(input.requireFastServiceTier
+ ...(input.requireServiceTier
? [
- 'if [ "$seen_fast_service_tier" != "1" ]; then',
- ' printf "%s\\n" "missing fast service tier config" >&2',
+ `if [ "$seen_service_tier" != "service_tier=\\"${input.requireServiceTier}\\"" ]; then`,
+ ' printf "%s\\n" "unexpected service tier config: $seen_service_tier" >&2',
` exit 5`,
"fi",
]
@@ -161,7 +163,7 @@ function withFakeCodexEnv<A, E, R>(
exitCode?: number;
stderr?: string;
requireImage?: boolean;
- requireFastServiceTier?: boolean;
+ requireServiceTier?: string;
requireReasoningEffort?: string;
forbidReasoningEffort?: boolean;
stdinMustContain?: string;
@@ -209,7 +211,7 @@ it.layer(CodexTextGenerationTestLayer)("CodexTextGeneration", (it) => {
);
it.effect(
- "forwards codex fast mode and non-default reasoning effort into codex exec config",
+ "forwards codex service tier and non-default reasoning effort into codex exec config",
() =>
withFakeCodexEnv(
{
@@ -217,7 +219,7 @@ it.layer(CodexTextGenerationTestLayer)("CodexTextGeneration", (it) => {
subject: "Add important change",
body: "",
}),
- requireFastServiceTier: true,
+ requireServiceTier: "priority",
requireReasoningEffort: "xhigh",
stdinMustNotContain: "branch must be a short semantic git branch fragment",
},
@@ -229,7 +231,7 @@ it.layer(CodexTextGenerationTestLayer)("CodexTextGeneration", (it) => {
stagedPatch: "diff --git a/README.md b/README.md",
modelSelection: createModelSelection(ProviderInstanceId.make("codex"), "gpt-5.4", [
{ id: "reasoningEffort", value: "xhigh" },
- { id: "fastMode", value: true },
+ { id: "serviceTier", value: "priority" },
]),
}),
),
diff --git a/apps/server/src/textGeneration/CodexTextGeneration.ts b/apps/server/src/textGeneration/CodexTextGeneration.ts
index d42fb07aa..bebd0acf8 100644
--- a/apps/server/src/textGeneration/CodexTextGeneration.ts
+++ b/apps/server/src/textGeneration/CodexTextGeneration.ts
@@ -32,10 +32,8 @@ import {
sanitizeThreadTitle,
toJsonSchemaObject,
} from "./TextGenerationUtils.ts";
-import {
- getModelSelectionBooleanOptionValue,
- getModelSelectionStringOptionValue,
-} from "@t3tools/shared/model";
+import { getModelSelectionStringOptionValue } from "@t3tools/shared/model";
+import { getCodexServiceTierOptionValue } from "../codexModelOptions.ts";
const CODEX_GIT_TEXT_GENERATION_REASONING_EFFORT = "low";
const CODEX_TIMEOUT_MS = 180_000;
@@ -181,6 +179,7 @@ export const makeCodexTextGeneration = Effect.fn("makeCodexTextGeneration")(func
const reasoningEffort =
getModelSelectionStringOptionValue(modelSelection, "reasoningEffort") ??
CODEX_GIT_TEXT_GENERATION_REASONING_EFFORT;
+ const serviceTier = getCodexServiceTierOptionValue(modelSelection);
const command = ChildProcess.make(
codexConfig.binaryPath || "codex",
[
@@ -193,9 +192,7 @@ export const makeCodexTextGeneration = Effect.fn("makeCodexTextGeneration")(func
modelSelection.model,
"--config",
`model_reasoning_effort="${reasoningEffort}"`,
- ...(getModelSelectionBooleanOptionValue(modelSelection, "fastMode") === true
- ? ["--config", `service_tier="fast"`]
- : []),
+ ...(serviceTier ? ["--config", `service_tier="${serviceTier}"`] : []),
"--output-schema",
schemaPath,
"--output-last-message",
diff --git a/packages/effect-codex-app-server/scripts/generate.ts b/packages/effect-codex-app-server/scripts/generate.ts
index 7a7fa6c97..3deb45142 100644
--- a/packages/effect-codex-app-server/scripts/generate.ts
+++ b/packages/effect-codex-app-server/scripts/generate.ts
@@ -17,7 +17,7 @@ import {
} from "effect/unstable/http";
import { ChildProcess, ChildProcessSpawner } from "effect/unstable/process";
-const UPSTREAM_REF = "07b695190f30a450e4921f71f77473e564395c59";
+const UPSTREAM_REF = "b39f943a634a6e7ba86c3d6e8cf6d5f35e612566";
const USER_AGENT = "effect-codex-app-server-generator";
const GITHUB_API_BASE =
"https://api.github.com/repos/openai/codex/contents/codex-rs/app-server-protocol";
@@ -348,6 +348,7 @@ function resolveResponseTypeName(
const overrides: Record<string, string> = {
"account/logout": "LogoutAccountResponse",
"account/rateLimits/read": "GetAccountRateLimitsResponse",
+ "account/usage/read": "GetAccountTokenUsageResponse",
"config/batchWrite": "ConfigWriteResponse",
"config/mcpServer/reload": "McpServerRefreshResponse",
"config/value/write": "ConfigWriteResponse",
@@ -745,14 +746,16 @@ const generateFiles = Effect.fn("generateFiles")(function* () {
yield* Effect.log(`Generated Codex App Server schemas from ${UPSTREAM_REF}`);
yield* Effect.service(ChildProcessSpawner.ChildProcessSpawner).pipe(
- Effect.flatMap((spawner) => spawner.spawn(ChildProcess.make("bun", ["oxfmt", generatedDir]))),
+ Effect.flatMap((spawner) =>
+ spawner.spawn(ChildProcess.make("vp", ["fmt", generatedDir, "--write"])),
+ ),
Effect.flatMap((child) => child.exitCode),
Effect.tap((code) =>
code === 0
? Effect.void
: Effect.fail(
new GeneratorError({
- detail: `oxfmt failed with exit code ${code}`,
+ detail: `vp fmt failed with exit code ${code}`,
}),
),
),
diff --git a/packages/effect-codex-app-server/src/_generated/meta.gen.ts b/packages/effect-codex-app-server/src/_generated/meta.gen.ts
index 12c386216..ed39896bd 100644
--- a/packages/effect-codex-app-server/src/_generated/meta.gen.ts
+++ b/packages/effect-codex-app-server/src/_generated/meta.gen.ts
@@ -1,5 +1,5 @@
// This file is generated by the effect-codex-app-server package. Do not edit manually.
-// Upstream protocol ref: 07b695190f30a450e4921f71f77473e564395c59
+// Upstream protocol ref: b39f943a634a6e7ba86c3d6e8cf6d5f35e612566
import * as CodexSchema from "./schema.gen.ts";
@@ -9,8 +9,12 @@ export const CLIENT_REQUEST_METHODS = {
"thread/resume": "thread/resume",
"thread/fork": "thread/fork",
"thread/archive": "thread/archive",
+ "thread/delete": "thread/delete",
"thread/unsubscribe": "thread/unsubscribe",
"thread/name/set": "thread/name/set",
+ "thread/goal/set": "thread/goal/set",
+ "thread/goal/get": "thread/goal/get",
+ "thread/goal/clear": "thread/goal/clear",
"thread/metadata/update": "thread/metadata/update",
"thread/unarchive": "thread/unarchive",
"thread/compact/start": "thread/compact/start",
@@ -22,16 +26,19 @@ export const CLIENT_REQUEST_METHODS = {
"thread/read": "thread/read",
"thread/inject_items": "thread/inject_items",
"skills/list": "skills/list",
+ "skills/extraRoots/set": "skills/extraRoots/set",
"hooks/list": "hooks/list",
"marketplace/add": "marketplace/add",
"marketplace/remove": "marketplace/remove",
"marketplace/upgrade": "marketplace/upgrade",
"plugin/list": "plugin/list",
+ "plugin/installed": "plugin/installed",
"plugin/read": "plugin/read",
"plugin/skill/read": "plugin/skill/read",
"plugin/share/save": "plugin/share/save",
"plugin/share/updateTargets": "plugin/share/updateTargets",
"plugin/share/list": "plugin/share/list",
+ "plugin/share/checkout": "plugin/share/checkout",
"plugin/share/delete": "plugin/share/delete",
"app/list": "app/list",
"fs/readFile": "fs/readFile",
@@ -53,6 +60,7 @@ export const CLIENT_REQUEST_METHODS = {
"model/list": "model/list",
"modelProvider/capabilities/read": "modelProvider/capabilities/read",
"experimentalFeature/list": "experimentalFeature/list",
+ "permissionProfile/list": "permissionProfile/list",
"experimentalFeature/enablement/set": "experimentalFeature/enablement/set",
"mcpServer/oauth/login": "mcpServer/oauth/login",
"config/mcpServer/reload": "config/mcpServer/reload",
@@ -65,6 +73,7 @@ export const CLIENT_REQUEST_METHODS = {
"account/login/cancel": "account/login/cancel",
"account/logout": "account/logout",
"account/rateLimits/read": "account/rateLimits/read",
+ "account/usage/read": "account/usage/read",
"account/sendAddCreditsNudgeEmail": "account/sendAddCreditsNudgeEmail",
"feedback/upload": "feedback/upload",
"command/exec": "command/exec",
@@ -96,6 +105,7 @@ export const SERVER_REQUEST_METHODS = {
"item/permissions/requestApproval": "item/permissions/requestApproval",
"item/tool/call": "item/tool/call",
"account/chatgptAuthTokens/refresh": "account/chatgptAuthTokens/refresh",
+ "attestation/generate": "attestation/generate",
applyPatchApproval: "applyPatchApproval",
execCommandApproval: "execCommandApproval",
} as const;
@@ -105,12 +115,14 @@ export const SERVER_NOTIFICATION_METHODS = {
"thread/started": "thread/started",
"thread/status/changed": "thread/status/changed",
"thread/archived": "thread/archived",
+ "thread/deleted": "thread/deleted",
"thread/unarchived": "thread/unarchived",
"thread/closed": "thread/closed",
"skills/changed": "skills/changed",
"thread/name/updated": "thread/name/updated",
"thread/goal/updated": "thread/goal/updated",
"thread/goal/cleared": "thread/goal/cleared",
+ "thread/settings/updated": "thread/settings/updated",
"thread/tokenUsage/updated": "thread/tokenUsage/updated",
"turn/started": "turn/started",
"hook/started": "hook/started",
@@ -148,6 +160,7 @@ export const SERVER_NOTIFICATION_METHODS = {
"thread/compacted": "thread/compacted",
"model/rerouted": "model/rerouted",
"model/verification": "model/verification",
+ "turn/moderationMetadata": "turn/moderationMetadata",
warning: "warning",
guardianWarning: "guardianWarning",
deprecationNotice: "deprecationNotice",
@@ -178,8 +191,12 @@ export interface ClientRequestParamsByMethod {
readonly "thread/resume": CodexSchema.V2ThreadResumeParams;
readonly "thread/fork": CodexSchema.V2ThreadForkParams;
readonly "thread/archive": CodexSchema.V2ThreadArchiveParams;
+ readonly "thread/delete": CodexSchema.V2ThreadDeleteParams;
readonly "thread/unsubscribe": CodexSchema.V2ThreadUnsubscribeParams;
readonly "thread/name/set": CodexSchema.V2ThreadSetNameParams;
+ readonly "thread/goal/set": CodexSchema.V2ThreadGoalSetParams;
+ readonly "thread/goal/get": CodexSchema.V2ThreadGoalGetParams;
+ readonly "thread/goal/clear": CodexSchema.V2ThreadGoalClearParams;
readonly "thread/metadata/update": CodexSchema.V2ThreadMetadataUpdateParams;
readonly "thread/unarchive": CodexSchema.V2ThreadUnarchiveParams;
readonly "thread/compact/start": CodexSchema.V2ThreadCompactStartParams;
@@ -191,16 +208,19 @@ export interface ClientRequestParamsByMethod {
readonly "thread/read": CodexSchema.V2ThreadReadParams;
readonly "thread/inject_items": CodexSchema.V2ThreadInjectItemsParams;
readonly "skills/list": CodexSchema.V2SkillsListParams;
+ readonly "skills/extraRoots/set": CodexSchema.V2SkillsExtraRootsSetParams;
readonly "hooks/list": CodexSchema.V2HooksListParams;
readonly "marketplace/add": CodexSchema.V2MarketplaceAddParams;
readonly "marketplace/remove": CodexSchema.V2MarketplaceRemoveParams;
readonly "marketplace/upgrade": CodexSchema.V2MarketplaceUpgradeParams;
readonly "plugin/list": CodexSchema.V2PluginListParams;
+ readonly "plugin/installed": CodexSchema.V2PluginInstalledParams;
readonly "plugin/read": CodexSchema.V2PluginReadParams;
readonly "plugin/skill/read": CodexSchema.V2PluginSkillReadParams;
readonly "plugin/share/save": CodexSchema.V2PluginShareSaveParams;
readonly "plugin/share/updateTargets": CodexSchema.V2PluginShareUpdateTargetsParams;
readonly "plugin/share/list": CodexSchema.V2PluginShareListParams;
+ readonly "plugin/share/checkout": CodexSchema.V2PluginShareCheckoutParams;
readonly "plugin/share/delete": CodexSchema.V2PluginShareDeleteParams;
readonly "app/list": CodexSchema.V2AppsListParams;
readonly "fs/readFile": CodexSchema.V2FsReadFileParams;
@@ -222,6 +242,7 @@ export interface ClientRequestParamsByMethod {
readonly "model/list": CodexSchema.V2ModelListParams;
readonly "modelProvider/capabilities/read": CodexSchema.V2ModelProviderCapabilitiesReadParams;
readonly "experimentalFeature/list": CodexSchema.V2ExperimentalFeatureListParams;
+ readonly "permissionProfile/list": CodexSchema.V2PermissionProfileListParams;
readonly "experimentalFeature/enablement/set": CodexSchema.V2ExperimentalFeatureEnablementSetParams;
readonly "mcpServer/oauth/login": CodexSchema.V2McpServerOauthLoginParams;
readonly "config/mcpServer/reload": undefined;
@@ -234,6 +255,7 @@ export interface ClientRequestParamsByMethod {
readonly "account/login/cancel": CodexSchema.V2CancelLoginAccountParams;
readonly "account/logout": undefined;
readonly "account/rateLimits/read": undefined;
+ readonly "account/usage/read": undefined;
readonly "account/sendAddCreditsNudgeEmail": CodexSchema.V2SendAddCreditsNudgeEmailParams;
readonly "feedback/upload": CodexSchema.V2FeedbackUploadParams;
readonly "command/exec": CodexSchema.V2CommandExecParams;
@@ -259,8 +281,12 @@ export interface ClientRequestResponsesByMethod {
readonly "thread/resume": CodexSchema.V2ThreadResumeResponse;
readonly "thread/fork": CodexSchema.V2ThreadForkResponse;
readonly "thread/archive": CodexSchema.V2ThreadArchiveResponse;
+ readonly "thread/delete": CodexSchema.V2ThreadDeleteResponse;
readonly "thread/unsubscribe": CodexSchema.V2ThreadUnsubscribeResponse;
readonly "thread/name/set": CodexSchema.V2ThreadSetNameResponse;
+ readonly "thread/goal/set": CodexSchema.V2ThreadGoalSetResponse;
+ readonly "thread/goal/get": CodexSchema.V2ThreadGoalGetResponse;
+ readonly "thread/goal/clear": CodexSchema.V2ThreadGoalClearResponse;
readonly "thread/metadata/update": CodexSchema.V2ThreadMetadataUpdateResponse;
readonly "thread/unarchive": CodexSchema.V2ThreadUnarchiveResponse;
readonly "thread/compact/start": CodexSchema.V2ThreadCompactStartResponse;
@@ -272,16 +298,19 @@ export interface ClientRequestResponsesByMethod {
readonly "thread/read": CodexSchema.V2ThreadReadResponse;
readonly "thread/inject_items": CodexSchema.V2ThreadInjectItemsResponse;
readonly "skills/list": CodexSchema.V2SkillsListResponse;
+ readonly "skills/extraRoots/set": CodexSchema.V2SkillsExtraRootsSetResponse;
readonly "hooks/list": CodexSchema.V2HooksListResponse;
readonly "marketplace/add": CodexSchema.V2MarketplaceAddResponse;
readonly "marketplace/remove": CodexSchema.V2MarketplaceRemoveResponse;
readonly "marketplace/upgrade": CodexSchema.V2MarketplaceUpgradeResponse;
readonly "plugin/list": CodexSchema.V2PluginListResponse;
+ readonly "plugin/installed": CodexSchema.V2PluginInstalledResponse;
readonly "plugin/read": CodexSchema.V2PluginReadResponse;
readonly "plugin/skill/read": CodexSchema.V2PluginSkillReadResponse;
readonly "plugin/share/save": CodexSchema.V2PluginShareSaveResponse;
readonly "plugin/share/updateTargets": CodexSchema.V2PluginShareUpdateTargetsResponse;
readonly "plugin/share/list": CodexSchema.V2PluginShareListResponse;
+ readonly "plugin/share/checkout": CodexSchema.V2PluginShareCheckoutResponse;
readonly "plugin/share/delete": CodexSchema.V2PluginShareDeleteResponse;
readonly "app/list": CodexSchema.V2AppsListResponse;
readonly "fs/readFile": CodexSchema.V2FsReadFileResponse;
@@ -303,6 +332,7 @@ export interface ClientRequestResponsesByMethod {
readonly "model/list": CodexSchema.V2ModelListResponse;
readonly "modelProvider/capabilities/read": CodexSchema.V2ModelProviderCapabilitiesReadResponse;
readonly "experimentalFeature/list": CodexSchema.V2ExperimentalFeatureListResponse;
+ readonly "permissionProfile/list": CodexSchema.V2PermissionProfileListResponse;
readonly "experimentalFeature/enablement/set": CodexSchema.V2ExperimentalFeatureEnablementSetResponse;
readonly "mcpServer/oauth/login": CodexSchema.V2McpServerOauthLoginResponse;
readonly "config/mcpServer/reload": CodexSchema.V2McpServerRefreshResponse;
@@ -315,6 +345,7 @@ export interface ClientRequestResponsesByMethod {
readonly "account/login/cancel": CodexSchema.V2CancelLoginAccountResponse;
readonly "account/logout": CodexSchema.V2LogoutAccountResponse;
readonly "account/rateLimits/read": CodexSchema.V2GetAccountRateLimitsResponse;
+ readonly "account/usage/read": CodexSchema.V2GetAccountTokenUsageResponse;
readonly "account/sendAddCreditsNudgeEmail": CodexSchema.V2SendAddCreditsNudgeEmailResponse;
readonly "feedback/upload": CodexSchema.V2FeedbackUploadResponse;
readonly "command/exec": CodexSchema.V2CommandExecResponse;
@@ -346,6 +377,7 @@ export interface ServerRequestParamsByMethod {
readonly "item/permissions/requestApproval": CodexSchema.PermissionsRequestApprovalParams;
readonly "item/tool/call": CodexSchema.DynamicToolCallParams;
readonly "account/chatgptAuthTokens/refresh": CodexSchema.ChatgptAuthTokensRefreshParams;
+ readonly "attestation/generate": CodexSchema.AttestationGenerateParams;
readonly applyPatchApproval: CodexSchema.ApplyPatchApprovalParams;
readonly execCommandApproval: CodexSchema.ExecCommandApprovalParams;
}
@@ -358,6 +390,7 @@ export interface ServerRequestResponsesByMethod {
readonly "item/permissions/requestApproval": CodexSchema.PermissionsRequestApprovalResponse;
readonly "item/tool/call": CodexSchema.DynamicToolCallResponse;
readonly "account/chatgptAuthTokens/refresh": CodexSchema.ChatgptAuthTokensRefreshResponse;
+ readonly "attestation/generate": CodexSchema.AttestationGenerateResponse;
readonly applyPatchApproval: CodexSchema.ApplyPatchApprovalResponse;
readonly execCommandApproval: CodexSchema.ExecCommandApprovalResponse;
}
@@ -367,12 +400,14 @@ export interface ServerNotificationParamsByMethod {
readonly "thread/started": CodexSchema.V2ThreadStartedNotification;
readonly "thread/status/changed": CodexSchema.V2ThreadStatusChangedNotification;
readonly "thread/archived": CodexSchema.V2ThreadArchivedNotification;
+ readonly "thread/deleted": CodexSchema.V2ThreadDeletedNotification;
readonly "thread/unarchived": CodexSchema.V2ThreadUnarchivedNotification;
readonly "thread/closed": CodexSchema.V2ThreadClosedNotification;
readonly "skills/changed": CodexSchema.V2SkillsChangedNotification;
readonly "thread/name/updated": CodexSchema.V2ThreadNameUpdatedNotification;
readonly "thread/goal/updated": CodexSchema.V2ThreadGoalUpdatedNotification;
readonly "thread/goal/cleared": CodexSchema.V2ThreadGoalClearedNotification;
+ readonly "thread/settings/updated": CodexSchema.V2ThreadSettingsUpdatedNotification;
readonly "thread/tokenUsage/updated": CodexSchema.V2ThreadTokenUsageUpdatedNotification;
readonly "turn/started": CodexSchema.V2TurnStartedNotification;
readonly "hook/started": CodexSchema.V2HookStartedNotification;
@@ -410,6 +445,7 @@ export interface ServerNotificationParamsByMethod {
readonly "thread/compacted": CodexSchema.V2ContextCompactedNotification;
readonly "model/rerouted": CodexSchema.V2ModelReroutedNotification;
readonly "model/verification": CodexSchema.V2ModelVerificationNotification;
+ readonly "turn/moderationMetadata": CodexSchema.V2TurnModerationMetadataNotification;
readonly warning: CodexSchema.V2WarningNotification;
readonly guardianWarning: CodexSchema.V2GuardianWarningNotification;
readonly deprecationNotice: CodexSchema.V2DeprecationNoticeNotification;
@@ -435,8 +471,12 @@ export const CLIENT_REQUEST_PARAMS = {
"thread/resume": CodexSchema.V2ThreadResumeParams,
"thread/fork": CodexSchema.V2ThreadForkParams,
"thread/archive": CodexSchema.V2ThreadArchiveParams,
+ "thread/delete": CodexSchema.V2ThreadDeleteParams,
"thread/unsubscribe": CodexSchema.V2ThreadUnsubscribeParams,
"thread/name/set": CodexSchema.V2ThreadSetNameParams,
+ "thread/goal/set": CodexSchema.V2ThreadGoalSetParams,
+ "thread/goal/get": CodexSchema.V2ThreadGoalGetParams,
+ "thread/goal/clear": CodexSchema.V2ThreadGoalClearParams,
"thread/metadata/update": CodexSchema.V2ThreadMetadataUpdateParams,
"thread/unarchive": CodexSchema.V2ThreadUnarchiveParams,
"thread/compact/start": CodexSchema.V2ThreadCompactStartParams,
@@ -448,16 +488,19 @@ export const CLIENT_REQUEST_PARAMS = {
"thread/read": CodexSchema.V2ThreadReadParams,
"thread/inject_items": CodexSchema.V2ThreadInjectItemsParams,
"skills/list": CodexSchema.V2SkillsListParams,
+ "skills/extraRoots/set": CodexSchema.V2SkillsExtraRootsSetParams,
"hooks/list": CodexSchema.V2HooksListParams,
"marketplace/add": CodexSchema.V2MarketplaceAddParams,
"marketplace/remove": CodexSchema.V2MarketplaceRemoveParams,
"marketplace/upgrade": CodexSchema.V2MarketplaceUpgradeParams,
"plugin/list": CodexSchema.V2PluginListParams,
+ "plugin/installed": CodexSchema.V2PluginInstalledParams,
"plugin/read": CodexSchema.V2PluginReadParams,
"plugin/skill/read": CodexSchema.V2PluginSkillReadParams,
"plugin/share/save": CodexSchema.V2PluginShareSaveParams,
"plugin/share/updateTargets": CodexSchema.V2PluginShareUpdateTargetsParams,
"plugin/share/list": CodexSchema.V2PluginShareListParams,
+ "plugin/share/checkout": CodexSchema.V2PluginShareCheckoutParams,
"plugin/share/delete": CodexSchema.V2PluginShareDeleteParams,
"app/list": CodexSchema.V2AppsListParams,
"fs/readFile": CodexSchema.V2FsReadFileParams,
@@ -479,6 +522,7 @@ export const CLIENT_REQUEST_PARAMS = {
"model/list": CodexSchema.V2ModelListParams,
"modelProvider/capabilities/read": CodexSchema.V2ModelProviderCapabilitiesReadParams,
"experimentalFeature/list": CodexSchema.V2ExperimentalFeatureListParams,
+ "permissionProfile/list": CodexSchema.V2PermissionProfileListParams,
"experimentalFeature/enablement/set": CodexSchema.V2ExperimentalFeatureEnablementSetParams,
"mcpServer/oauth/login": CodexSchema.V2McpServerOauthLoginParams,
"config/mcpServer/reload": undefined,
@@ -491,6 +535,7 @@ export const CLIENT_REQUEST_PARAMS = {
"account/login/cancel": CodexSchema.V2CancelLoginAccountParams,
"account/logout": undefined,
"account/rateLimits/read": undefined,
+ "account/usage/read": undefined,
"account/sendAddCreditsNudgeEmail": CodexSchema.V2SendAddCreditsNudgeEmailParams,
"feedback/upload": CodexSchema.V2FeedbackUploadParams,
"command/exec": CodexSchema.V2CommandExecParams,
@@ -516,8 +561,12 @@ export const CLIENT_REQUEST_RESPONSES = {
"thread/resume": CodexSchema.V2ThreadResumeResponse,
"thread/fork": CodexSchema.V2ThreadForkResponse,
"thread/archive": CodexSchema.V2ThreadArchiveResponse,
+ "thread/delete": CodexSchema.V2ThreadDeleteResponse,
"thread/unsubscribe": CodexSchema.V2ThreadUnsubscribeResponse,
"thread/name/set": CodexSchema.V2ThreadSetNameResponse,
+ "thread/goal/set": CodexSchema.V2ThreadGoalSetResponse,
+ "thread/goal/get": CodexSchema.V2ThreadGoalGetResponse,
+ "thread/goal/clear": CodexSchema.V2ThreadGoalClearResponse,
"thread/metadata/update": CodexSchema.V2ThreadMetadataUpdateResponse,
"thread/unarchive": CodexSchema.V2ThreadUnarchiveResponse,
"thread/compact/start": CodexSchema.V2ThreadCompactStartResponse,
@@ -529,16 +578,19 @@ export const CLIENT_REQUEST_RESPONSES = {
"thread/read": CodexSchema.V2ThreadReadResponse,
"thread/inject_items": CodexSchema.V2ThreadInjectItemsResponse,
"skills/list": CodexSchema.V2SkillsListResponse,
+ "skills/extraRoots/set": CodexSchema.V2SkillsExtraRootsSetResponse,
"hooks/list": CodexSchema.V2HooksListResponse,
"marketplace/add": CodexSchema.V2MarketplaceAddResponse,
"marketplace/remove": CodexSchema.V2MarketplaceRemoveResponse,
"marketplace/upgrade": CodexSchema.V2MarketplaceUpgradeResponse,
"plugin/list": CodexSchema.V2PluginListResponse,
+ "plugin/installed": CodexSchema.V2PluginInstalledResponse,
"plugin/read": CodexSchema.V2PluginReadResponse,
"plugin/skill/read": CodexSchema.V2PluginSkillReadResponse,
"plugin/share/save": CodexSchema.V2PluginShareSaveResponse,
"plugin/share/updateTargets": CodexSchema.V2PluginShareUpdateTargetsResponse,
"plugin/share/list": CodexSchema.V2PluginShareListResponse,
+ "plugin/share/checkout": CodexSchema.V2PluginShareCheckoutResponse,
"plugin/share/delete": CodexSchema.V2PluginShareDeleteResponse,
"app/list": CodexSchema.V2AppsListResponse,
"fs/readFile": CodexSchema.V2FsReadFileResponse,
@@ -560,6 +612,7 @@ export const CLIENT_REQUEST_RESPONSES = {
"model/list": CodexSchema.V2ModelListResponse,
"modelProvider/capabilities/read": CodexSchema.V2ModelProviderCapabilitiesReadResponse,
"experimentalFeature/list": CodexSchema.V2ExperimentalFeatureListResponse,
+ "permissionProfile/list": CodexSchema.V2PermissionProfileListResponse,
"experimentalFeature/enablement/set": CodexSchema.V2ExperimentalFeatureEnablementSetResponse,
"mcpServer/oauth/login": CodexSchema.V2McpServerOauthLoginResponse,
"config/mcpServer/reload": CodexSchema.V2McpServerRefreshResponse,
@@ -572,6 +625,7 @@ export const CLIENT_REQUEST_RESPONSES = {
"account/login/cancel": CodexSchema.V2CancelLoginAccountResponse,
"account/logout": CodexSchema.V2LogoutAccountResponse,
"account/rateLimits/read": CodexSchema.V2GetAccountRateLimitsResponse,
+ "account/usage/read": CodexSchema.V2GetAccountTokenUsageResponse,
"account/sendAddCreditsNudgeEmail": CodexSchema.V2SendAddCreditsNudgeEmailResponse,
"feedback/upload": CodexSchema.V2FeedbackUploadResponse,
"command/exec": CodexSchema.V2CommandExecResponse,
@@ -603,6 +657,7 @@ export const SERVER_REQUEST_PARAMS = {
"item/permissions/requestApproval": CodexSchema.PermissionsRequestApprovalParams,
"item/tool/call": CodexSchema.DynamicToolCallParams,
"account/chatgptAuthTokens/refresh": CodexSchema.ChatgptAuthTokensRefreshParams,
+ "attestation/generate": CodexSchema.AttestationGenerateParams,
applyPatchApproval: CodexSchema.ApplyPatchApprovalParams,
execCommandApproval: CodexSchema.ExecCommandApprovalParams,
} as const;
@@ -615,6 +670,7 @@ export const SERVER_REQUEST_RESPONSES = {
"item/permissions/requestApproval": CodexSchema.PermissionsRequestApprovalResponse,
"item/tool/call": CodexSchema.DynamicToolCallResponse,
"account/chatgptAuthTokens/refresh": CodexSchema.ChatgptAuthTokensRefreshResponse,
+ "attestation/generate": CodexSchema.AttestationGenerateResponse,
applyPatchApproval: CodexSchema.ApplyPatchApprovalResponse,
execCommandApproval: CodexSchema.ExecCommandApprovalResponse,
} as const;
@@ -624,12 +680,14 @@ export const SERVER_NOTIFICATION_PARAMS = {
"thread/started": CodexSchema.V2ThreadStartedNotification,
"thread/status/changed": CodexSchema.V2ThreadStatusChangedNotification,
"thread/archived": CodexSchema.V2ThreadArchivedNotification,
+ "thread/deleted": CodexSchema.V2ThreadDeletedNotification,
"thread/unarchived": CodexSchema.V2ThreadUnarchivedNotification,
"thread/closed": CodexSchema.V2ThreadClosedNotification,
"skills/changed": CodexSchema.V2SkillsChangedNotification,
"thread/name/updated": CodexSchema.V2ThreadNameUpdatedNotification,
"thread/goal/updated": CodexSchema.V2ThreadGoalUpdatedNotification,
"thread/goal/cleared": CodexSchema.V2ThreadGoalClearedNotification,
+ "thread/settings/updated": CodexSchema.V2ThreadSettingsUpdatedNotification,
"thread/tokenUsage/updated": CodexSchema.V2ThreadTokenUsageUpdatedNotification,
"turn/started": CodexSchema.V2TurnStartedNotification,
"hook/started": CodexSchema.V2HookStartedNotification,
@@ -669,6 +727,7 @@ export const SERVER_NOTIFICATION_PARAMS = {
"thread/compacted": CodexSchema.V2ContextCompactedNotification,
"model/rerouted": CodexSchema.V2ModelReroutedNotification,
"model/verification": CodexSchema.V2ModelVerificationNotification,
+ "turn/moderationMetadata": CodexSchema.V2TurnModerationMetadataNotification,
warning: CodexSchema.V2WarningNotification,
guardianWarning: CodexSchema.V2GuardianWarningNotification,
deprecationNotice: CodexSchema.V2DeprecationNoticeNotification,
diff --git a/packages/effect-codex-app-server/src/_generated/namespaces.gen.ts b/packages/effect-codex-app-server/src/_generated/namespaces.gen.ts
index a676187df..74154a276 100644
--- a/packages/effect-codex-app-server/src/_generated/namespaces.gen.ts
+++ b/packages/effect-codex-app-server/src/_generated/namespaces.gen.ts
@@ -1,5 +1,5 @@
// This file is generated by the effect-codex-app-server package. Do not edit manually.
-// Upstream protocol ref: 07b695190f30a450e4921f71f77473e564395c59
+// Upstream protocol ref: b39f943a634a6e7ba86c3d6e8cf6d5f35e612566
import * as CodexSchema from "./schema.gen.ts";
@@ -74,6 +74,7 @@ export const v2 = {
GetAccountParams: CodexSchema.V2GetAccountParams,
GetAccountRateLimitsResponse: CodexSchema.V2GetAccountRateLimitsResponse,
GetAccountResponse: CodexSchema.V2GetAccountResponse,
+ GetAccountTokenUsageResponse: CodexSchema.V2GetAccountTokenUsageResponse,
GuardianWarningNotification: CodexSchema.V2GuardianWarningNotification,
HookCompletedNotification: CodexSchema.V2HookCompletedNotification,
HooksListParams: CodexSchema.V2HooksListParams,
@@ -112,13 +113,19 @@ export const v2 = {
ModelProviderCapabilitiesReadResponse: CodexSchema.V2ModelProviderCapabilitiesReadResponse,
ModelReroutedNotification: CodexSchema.V2ModelReroutedNotification,
ModelVerificationNotification: CodexSchema.V2ModelVerificationNotification,
+ PermissionProfileListParams: CodexSchema.V2PermissionProfileListParams,
+ PermissionProfileListResponse: CodexSchema.V2PermissionProfileListResponse,
PlanDeltaNotification: CodexSchema.V2PlanDeltaNotification,
+ PluginInstalledParams: CodexSchema.V2PluginInstalledParams,
+ PluginInstalledResponse: CodexSchema.V2PluginInstalledResponse,
PluginInstallParams: CodexSchema.V2PluginInstallParams,
PluginInstallResponse: CodexSchema.V2PluginInstallResponse,
PluginListParams: CodexSchema.V2PluginListParams,
PluginListResponse: CodexSchema.V2PluginListResponse,
PluginReadParams: CodexSchema.V2PluginReadParams,
PluginReadResponse: CodexSchema.V2PluginReadResponse,
+ PluginShareCheckoutParams: CodexSchema.V2PluginShareCheckoutParams,
+ PluginShareCheckoutResponse: CodexSchema.V2PluginShareCheckoutResponse,
PluginShareDeleteParams: CodexSchema.V2PluginShareDeleteParams,
PluginShareDeleteResponse: CodexSchema.V2PluginShareDeleteResponse,
PluginShareListParams: CodexSchema.V2PluginShareListParams,
@@ -146,6 +153,8 @@ export const v2 = {
SkillsChangedNotification: CodexSchema.V2SkillsChangedNotification,
SkillsConfigWriteParams: CodexSchema.V2SkillsConfigWriteParams,
SkillsConfigWriteResponse: CodexSchema.V2SkillsConfigWriteResponse,
+ SkillsExtraRootsSetParams: CodexSchema.V2SkillsExtraRootsSetParams,
+ SkillsExtraRootsSetResponse: CodexSchema.V2SkillsExtraRootsSetResponse,
SkillsListParams: CodexSchema.V2SkillsListParams,
SkillsListResponse: CodexSchema.V2SkillsListResponse,
TerminalInteractionNotification: CodexSchema.V2TerminalInteractionNotification,
@@ -158,9 +167,18 @@ export const v2 = {
ThreadClosedNotification: CodexSchema.V2ThreadClosedNotification,
ThreadCompactStartParams: CodexSchema.V2ThreadCompactStartParams,
ThreadCompactStartResponse: CodexSchema.V2ThreadCompactStartResponse,
+ ThreadDeletedNotification: CodexSchema.V2ThreadDeletedNotification,
+ ThreadDeleteParams: CodexSchema.V2ThreadDeleteParams,
+ ThreadDeleteResponse: CodexSchema.V2ThreadDeleteResponse,
ThreadForkParams: CodexSchema.V2ThreadForkParams,
ThreadForkResponse: CodexSchema.V2ThreadForkResponse,
ThreadGoalClearedNotification: CodexSchema.V2ThreadGoalClearedNotification,
+ ThreadGoalClearParams: CodexSchema.V2ThreadGoalClearParams,
+ ThreadGoalClearResponse: CodexSchema.V2ThreadGoalClearResponse,
+ ThreadGoalGetParams: CodexSchema.V2ThreadGoalGetParams,
+ ThreadGoalGetResponse: CodexSchema.V2ThreadGoalGetResponse,
+ ThreadGoalSetParams: CodexSchema.V2ThreadGoalSetParams,
+ ThreadGoalSetResponse: CodexSchema.V2ThreadGoalSetResponse,
ThreadGoalUpdatedNotification: CodexSchema.V2ThreadGoalUpdatedNotification,
ThreadInjectItemsParams: CodexSchema.V2ThreadInjectItemsParams,
ThreadInjectItemsResponse: CodexSchema.V2ThreadInjectItemsResponse,
@@ -189,6 +207,7 @@ export const v2 = {
ThreadRollbackResponse: CodexSchema.V2ThreadRollbackResponse,
ThreadSetNameParams: CodexSchema.V2ThreadSetNameParams,
ThreadSetNameResponse: CodexSchema.V2ThreadSetNameResponse,
+ ThreadSettingsUpdatedNotification: CodexSchema.V2ThreadSettingsUpdatedNotification,
ThreadShellCommandParams: CodexSchema.V2ThreadShellCommandParams,
ThreadShellCommandResponse: CodexSchema.V2ThreadShellCommandResponse,
ThreadStartedNotification: CodexSchema.V2ThreadStartedNotification,
@@ -205,6 +224,7 @@ export const v2 = {
TurnDiffUpdatedNotification: CodexSchema.V2TurnDiffUpdatedNotification,
TurnInterruptParams: CodexSchema.V2TurnInterruptParams,
TurnInterruptResponse: CodexSchema.V2TurnInterruptResponse,
+ TurnModerationMetadataNotification: CodexSchema.V2TurnModerationMetadataNotification,
TurnPlanUpdatedNotification: CodexSchema.V2TurnPlanUpdatedNotification,
TurnStartedNotification: CodexSchema.V2TurnStartedNotification,
TurnStartParams: CodexSchema.V2TurnStartParams,
diff --git a/packages/effect-codex-app-server/src/_generated/schema.gen.ts b/packages/effect-codex-app-server/src/_generated/schema.gen.ts
index 8cb1f622f..fb9329238 100644
--- a/packages/effect-codex-app-server/src/_generated/schema.gen.ts
+++ b/packages/effect-codex-app-server/src/_generated/schema.gen.ts
@@ -1,5 +1,5 @@
// This file is generated by the effect-codex-app-server package. Do not edit manually.
-// Upstream protocol ref: 07b695190f30a450e4921f71f77473e564395c59
+// Upstream protocol ref: b39f943a634a6e7ba86c3d6e8cf6d5f35e612566
import * as Schema from "effect/Schema";
@@ -48,6 +48,25 @@ export const ClientRequest__AbsolutePathBuf = Schema.String.annotate({
export type ClientRequest__AddCreditsNudgeCreditType = "credits" | "usage_limit";
export const ClientRequest__AddCreditsNudgeCreditType = Schema.Literals(["credits", "usage_limit"]);
+export type ClientRequest__AdditionalContextKind = "untrusted" | "application";
+export const ClientRequest__AdditionalContextKind = Schema.Literals(["untrusted", "application"]);
+
+export type ClientRequest__AgentMessageInputContent = {
+ readonly encrypted_content: string;
+ readonly type: "encrypted_content";
+};
+export const ClientRequest__AgentMessageInputContent = Schema.Union(
+ [
+ Schema.Struct({
+ encrypted_content: Schema.String,
+ type: Schema.Literal("encrypted_content").annotate({
+ title: "EncryptedContentAgentMessageInputContentType",
+ }),
+ }).annotate({ title: "EncryptedContentAgentMessageInputContent" }),
+ ],
+ { mode: "oneOf" },
+);
+
export type ClientRequest__ApprovalsReviewer = "user" | "auto_review" | "guardian_subagent";
export const ClientRequest__ApprovalsReviewer = Schema.Literals([
"user",
@@ -238,7 +257,7 @@ export const ClientRequest__ConfigReadParams = Schema.Struct({
Schema.Null,
]),
),
- includeLayers: Schema.optionalKey(Schema.Boolean.annotate({ default: false })),
+ includeLayers: Schema.optionalKey(Schema.Boolean),
});
export type ClientRequest__ExperimentalFeatureEnablementSetParams = {
@@ -254,6 +273,7 @@ export const ClientRequest__ExperimentalFeatureEnablementSetParams = Schema.Stru
export type ClientRequest__ExperimentalFeatureListParams = {
readonly cursor?: string | null;
readonly limit?: number | null;
+ readonly threadId?: string | null;
};
export const ClientRequest__ExperimentalFeatureListParams = Schema.Struct({
cursor: Schema.optionalKey(
@@ -275,6 +295,15 @@ export const ClientRequest__ExperimentalFeatureListParams = Schema.Struct({
Schema.Null,
]),
),
+ threadId: Schema.optionalKey(
+ Schema.Union([
+ Schema.String.annotate({
+ description:
+ "Optional loaded thread id. Pass this when showing feature state for an existing thread so enablement is computed from that thread's refreshed config, including project-local config for the thread's cwd.",
+ }),
+ Schema.Null,
+ ]),
+ ),
});
export type ClientRequest__ExternalAgentConfigDetectParams = {
@@ -322,7 +351,7 @@ export const ClientRequest__ExternalAgentConfigMigrationItemType = Schema.Litera
export type ClientRequest__FeedbackUploadParams = {
readonly classification: string;
readonly extraLogFiles?: ReadonlyArray<string> | null;
- readonly includeLogs: boolean;
+ readonly includeLogs?: boolean;
readonly reason?: string | null;
readonly tags?: { readonly [x: string]: string } | null;
readonly threadId?: string | null;
@@ -330,7 +359,7 @@ export type ClientRequest__FeedbackUploadParams = {
export const ClientRequest__FeedbackUploadParams = Schema.Struct({
classification: Schema.String,
extraLogFiles: Schema.optionalKey(Schema.Union([Schema.Array(Schema.String), Schema.Null])),
- includeLogs: Schema.Boolean,
+ includeLogs: Schema.optionalKey(Schema.Boolean),
reason: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
tags: Schema.optionalKey(
Schema.Union([Schema.Record(Schema.String, Schema.String), Schema.Null]),
@@ -338,43 +367,6 @@ export const ClientRequest__FeedbackUploadParams = Schema.Struct({
threadId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
});
-export type ClientRequest__FileSystemAccessMode = "read" | "write" | "none";
-export const ClientRequest__FileSystemAccessMode = Schema.Literals(["read", "write", "none"]);
-
-export type ClientRequest__FileSystemSpecialPath =
- | { readonly kind: "root" }
- | { readonly kind: "minimal" }
- | { readonly kind: "project_roots"; readonly subpath?: string | null }
- | { readonly kind: "tmpdir" }
- | { readonly kind: "slash_tmp" }
- | { readonly kind: "unknown"; readonly path: string; readonly subpath?: string | null };
-export const ClientRequest__FileSystemSpecialPath = Schema.Union(
- [
- Schema.Struct({ kind: Schema.Literal("root") }).annotate({
- title: "RootFileSystemSpecialPath",
- }),
- Schema.Struct({ kind: Schema.Literal("minimal") }).annotate({
- title: "MinimalFileSystemSpecialPath",
- }),
- Schema.Struct({
- kind: Schema.Literal("project_roots"),
- subpath: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
- }).annotate({ title: "KindFileSystemSpecialPath" }),
- Schema.Struct({ kind: Schema.Literal("tmpdir") }).annotate({
- title: "TmpdirFileSystemSpecialPath",
- }),
- Schema.Struct({ kind: Schema.Literal("slash_tmp") }).annotate({
- title: "SlashTmpFileSystemSpecialPath",
- }),
- Schema.Struct({
- kind: Schema.Literal("unknown"),
- path: Schema.String,
- subpath: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
- }),
- ],
- { mode: "oneOf" },
-);
-
export type ClientRequest__FsCopyParams = {
readonly destinationPath: string;
readonly recursive?: boolean;
@@ -514,7 +506,6 @@ export const ClientRequest__GetAccountParams = Schema.Struct({
Schema.Boolean.annotate({
description:
"When `true`, requests a proactive token refresh before returning.\n\nIn managed auth mode this triggers the normal refresh-token flow. In external auth mode this flag is ignored. Clients should refresh tokens themselves and call `account/login/start` with `chatgptAuthTokens`.",
- default: false,
}),
),
});
@@ -537,6 +528,7 @@ export const ClientRequest__ImageDetail = Schema.Literals(["auto", "low", "high"
export type ClientRequest__InitializeCapabilities = {
readonly experimentalApi?: boolean;
readonly optOutNotificationMethods?: ReadonlyArray<string> | null;
+ readonly requestAttestation?: boolean;
};
export const ClientRequest__InitializeCapabilities = Schema.Struct({
experimentalApi: Schema.optionalKey(
@@ -554,6 +546,12 @@ export const ClientRequest__InitializeCapabilities = Schema.Struct({
Schema.Null,
]),
),
+ requestAttestation: Schema.optionalKey(
+ Schema.Boolean.annotate({
+ description: "Opt into `attestation/generate` requests for upstream `x-oai-attestation`.",
+ default: false,
+ }),
+ ),
}).annotate({ description: "Client-declared capabilities negotiated during initialize." });
export type ClientRequest__LocalShellAction = {
@@ -768,9 +766,39 @@ export const ClientRequest__ModelListParams = Schema.Struct({
export type ClientRequest__ModelProviderCapabilitiesReadParams = {};
export const ClientRequest__ModelProviderCapabilitiesReadParams = Schema.Struct({});
-export type ClientRequest__PermissionProfileNetworkPermissions = { readonly enabled: boolean };
-export const ClientRequest__PermissionProfileNetworkPermissions = Schema.Struct({
- enabled: Schema.Boolean,
+export type ClientRequest__PermissionProfileListParams = {
+ readonly cursor?: string | null;
+ readonly cwd?: string | null;
+ readonly limit?: number | null;
+};
+export const ClientRequest__PermissionProfileListParams = Schema.Struct({
+ cursor: Schema.optionalKey(
+ Schema.Union([
+ Schema.String.annotate({
+ description: "Opaque pagination cursor returned by a previous call.",
+ }),
+ Schema.Null,
+ ]),
+ ),
+ cwd: Schema.optionalKey(
+ Schema.Union([
+ Schema.String.annotate({
+ description: "Optional working directory to resolve project config layers.",
+ }),
+ Schema.Null,
+ ]),
+ ),
+ limit: Schema.optionalKey(
+ Schema.Union([
+ Schema.Number.annotate({
+ description: "Optional page size; defaults to the full result set.",
+ format: "uint32",
+ })
+ .check(Schema.isInt())
+ .check(Schema.isGreaterThanOrEqualTo(0)),
+ Schema.Null,
+ ]),
+ ),
});
export type ClientRequest__Personality = "none" | "friendly" | "pragmatic";
@@ -778,14 +806,21 @@ export const ClientRequest__Personality = Schema.Literals(["none", "friendly", "
export type ClientRequest__PluginListMarketplaceKind =
| "local"
+ | "vertical"
| "workspace-directory"
| "shared-with-me";
export const ClientRequest__PluginListMarketplaceKind = Schema.Literals([
"local",
+ "vertical",
"workspace-directory",
"shared-with-me",
]);
+export type ClientRequest__PluginShareCheckoutParams = { readonly remotePluginId: string };
+export const ClientRequest__PluginShareCheckoutParams = Schema.Struct({
+ remotePluginId: Schema.String,
+});
+
export type ClientRequest__PluginShareDeleteParams = { readonly remotePluginId: string };
export const ClientRequest__PluginShareDeleteParams = Schema.Struct({
remotePluginId: Schema.String,
@@ -808,6 +843,15 @@ export const ClientRequest__PluginSharePrincipalType = Schema.Literals([
"workspace",
]);
+export type ClientRequest__PluginShareTargetRole = "reader" | "editor";
+export const ClientRequest__PluginShareTargetRole = Schema.Literals(["reader", "editor"]);
+
+export type ClientRequest__PluginShareUpdateDiscoverability = "UNLISTED" | "PRIVATE";
+export const ClientRequest__PluginShareUpdateDiscoverability = Schema.Literals([
+ "UNLISTED",
+ "PRIVATE",
+]);
+
export type ClientRequest__PluginSkillReadParams = {
readonly remoteMarketplaceName: string;
readonly remotePluginId: string;
@@ -831,24 +875,10 @@ export const ClientRequest__PluginsMigration = Schema.Struct({
pluginNames: Schema.Array(Schema.String),
});
-export type ClientRequest__ReasoningEffort =
- | "none"
- | "minimal"
- | "low"
- | "medium"
- | "high"
- | "xhigh";
-export const ClientRequest__ReasoningEffort = Schema.Literals([
- "none",
- "minimal",
- "low",
- "medium",
- "high",
- "xhigh",
-]).annotate({
- description:
- "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning",
-});
+export type ClientRequest__ReasoningEffort = string;
+export const ClientRequest__ReasoningEffort = Schema.String.annotate({
+ description: "A non-empty reasoning effort value advertised by the model.",
+}).check(Schema.isMinLength(1));
export type ClientRequest__ReasoningItemContent =
| { readonly text: string; readonly type: "reasoning_text" }
@@ -1012,13 +1042,21 @@ export const ClientRequest__SessionMigration = Schema.Struct({
title: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
});
-export type ClientRequest__SkillsListExtraRootsForCwd = {
- readonly cwd: string;
- readonly extraUserRoots: ReadonlyArray<string>;
+export type ClientRequest__SkillsListParams = {
+ readonly cwds?: ReadonlyArray<string>;
+ readonly forceReload?: boolean;
};
-export const ClientRequest__SkillsListExtraRootsForCwd = Schema.Struct({
- cwd: Schema.String,
- extraUserRoots: Schema.Array(Schema.String),
+export const ClientRequest__SkillsListParams = Schema.Struct({
+ cwds: Schema.optionalKey(
+ Schema.Array(Schema.String).annotate({
+ description: "When empty, defaults to the current session working directory.",
+ }),
+ ),
+ forceReload: Schema.optionalKey(
+ Schema.Boolean.annotate({
+ description: "When true, bypass the skills cache and re-scan skills from disk.",
+ }),
+ ),
});
export type ClientRequest__SortDirection = "asc" | "desc";
@@ -1069,6 +1107,31 @@ export const ClientRequest__ThreadArchiveParams = Schema.Struct({ threadId: Sche
export type ClientRequest__ThreadCompactStartParams = { readonly threadId: string };
export const ClientRequest__ThreadCompactStartParams = Schema.Struct({ threadId: Schema.String });
+export type ClientRequest__ThreadDeleteParams = { readonly threadId: string };
+export const ClientRequest__ThreadDeleteParams = Schema.Struct({ threadId: Schema.String });
+
+export type ClientRequest__ThreadGoalClearParams = { readonly threadId: string };
+export const ClientRequest__ThreadGoalClearParams = Schema.Struct({ threadId: Schema.String });
+
+export type ClientRequest__ThreadGoalGetParams = { readonly threadId: string };
+export const ClientRequest__ThreadGoalGetParams = Schema.Struct({ threadId: Schema.String });
+
+export type ClientRequest__ThreadGoalStatus =
+ | "active"
+ | "paused"
+ | "blocked"
+ | "usageLimited"
+ | "budgetLimited"
+ | "complete";
+export const ClientRequest__ThreadGoalStatus = Schema.Literals([
+ "active",
+ "paused",
+ "blocked",
+ "usageLimited",
+ "budgetLimited",
+ "complete",
+]);
+
export type ClientRequest__ThreadInjectItemsParams = {
readonly items: ReadonlyArray<unknown>;
readonly threadId: string;
@@ -1155,7 +1218,6 @@ export const ClientRequest__ThreadReadParams = Schema.Struct({
includeTurns: Schema.optionalKey(
Schema.Boolean.annotate({
description: "When true, include turns and their items from rollout history.",
- default: false,
}),
),
threadId: Schema.String,
@@ -1200,12 +1262,8 @@ export const ClientRequest__ThreadShellCommandParams = Schema.Struct({
export type ClientRequest__ThreadSortKey = "created_at" | "updated_at";
export const ClientRequest__ThreadSortKey = Schema.Literals(["created_at", "updated_at"]);
-export type ClientRequest__ThreadSource = "user" | "subagent" | "memory_consolidation";
-export const ClientRequest__ThreadSource = Schema.Literals([
- "user",
- "subagent",
- "memory_consolidation",
-]);
+export type ClientRequest__ThreadSource = string;
+export const ClientRequest__ThreadSource = Schema.String;
export type ClientRequest__ThreadSourceKind =
| "cli"
@@ -1249,6 +1307,9 @@ export const ClientRequest__TurnInterruptParams = Schema.Struct({
turnId: Schema.String,
});
+export type ClientRequest__TurnItemsView = "notLoaded" | "summary" | "full";
+export const ClientRequest__TurnItemsView = Schema.Literals(["notLoaded", "summary", "full"]);
+
export type ClientRequest__WindowsSandboxSetupMode = "elevated" | "unelevated";
export const ClientRequest__WindowsSandboxSetupMode = Schema.Literals(["elevated", "unelevated"]);
@@ -1265,11 +1326,11 @@ export const CommandExecutionRequestApprovalParams__AdditionalNetworkPermissions
enabled: Schema.optionalKey(Schema.Union([Schema.Boolean, Schema.Null])),
});
-export type CommandExecutionRequestApprovalParams__FileSystemAccessMode = "read" | "write" | "none";
+export type CommandExecutionRequestApprovalParams__FileSystemAccessMode = "read" | "write" | "deny";
export const CommandExecutionRequestApprovalParams__FileSystemAccessMode = Schema.Literals([
"read",
"write",
- "none",
+ "deny",
]);
export type CommandExecutionRequestApprovalParams__FileSystemSpecialPath =
@@ -1562,11 +1623,11 @@ export const PermissionsRequestApprovalParams__AdditionalNetworkPermissions = Sc
enabled: Schema.optionalKey(Schema.Union([Schema.Boolean, Schema.Null])),
});
-export type PermissionsRequestApprovalParams__FileSystemAccessMode = "read" | "write" | "none";
+export type PermissionsRequestApprovalParams__FileSystemAccessMode = "read" | "write" | "deny";
export const PermissionsRequestApprovalParams__FileSystemAccessMode = Schema.Literals([
"read",
"write",
- "none",
+ "deny",
]);
export type PermissionsRequestApprovalParams__FileSystemSpecialPath =
@@ -1616,11 +1677,11 @@ export const PermissionsRequestApprovalResponse__AdditionalNetworkPermissions =
enabled: Schema.optionalKey(Schema.Union([Schema.Boolean, Schema.Null])),
});
-export type PermissionsRequestApprovalResponse__FileSystemAccessMode = "read" | "write" | "none";
+export type PermissionsRequestApprovalResponse__FileSystemAccessMode = "read" | "write" | "deny";
export const PermissionsRequestApprovalResponse__FileSystemAccessMode = Schema.Literals([
"read",
"write",
- "none",
+ "deny",
]);
export type PermissionsRequestApprovalResponse__FileSystemSpecialPath =
@@ -1674,6 +1735,26 @@ export const ServerNotification__AccountLoginCompletedNotification = Schema.Stru
success: Schema.Boolean,
});
+export type ServerNotification__ActivePermissionProfile = {
+ readonly extends?: string | null;
+ readonly id: string;
+};
+export const ServerNotification__ActivePermissionProfile = Schema.Struct({
+ extends: Schema.optionalKey(
+ Schema.Union([
+ Schema.String.annotate({
+ description:
+ "Parent profile identifier from the selected permissions profile's `extends` setting, when present.",
+ }),
+ Schema.Null,
+ ]),
+ ),
+ id: Schema.String.annotate({
+ description:
+ "Identifier from `default_permissions` or the implicit built-in default, such as `:workspace` or a user-defined `[permissions.<id>]` profile.",
+ }),
+});
+
export type ServerNotification__AdditionalNetworkPermissions = {
readonly enabled?: boolean | null;
};
@@ -1728,16 +1809,58 @@ export const ServerNotification__AppScreenshot = Schema.Struct({
userPrompt: Schema.String,
});
+export type ServerNotification__ApprovalsReviewer = "user" | "auto_review" | "guardian_subagent";
+export const ServerNotification__ApprovalsReviewer = Schema.Literals([
+ "user",
+ "auto_review",
+ "guardian_subagent",
+]).annotate({
+ description:
+ "Configures who approval requests are routed to for review. Examples include sandbox escapes, blocked network access, MCP approval prompts, and ARC escalations. Defaults to `user`. `auto_review` uses a carefully prompted subagent to gather relevant context and apply a risk-based decision framework before approving or denying the request. The legacy value `guardian_subagent` is accepted for compatibility.",
+});
+
+export type ServerNotification__AskForApproval =
+ | "untrusted"
+ | "on-failure"
+ | "on-request"
+ | "never"
+ | {
+ readonly granular: {
+ readonly mcp_elicitations: boolean;
+ readonly request_permissions?: boolean;
+ readonly rules: boolean;
+ readonly sandbox_approval: boolean;
+ readonly skill_approval?: boolean;
+ };
+ };
+export const ServerNotification__AskForApproval = Schema.Union(
+ [
+ Schema.Literals(["untrusted", "on-failure", "on-request", "never"]),
+ Schema.Struct({
+ granular: Schema.Struct({
+ mcp_elicitations: Schema.Boolean,
+ request_permissions: Schema.optionalKey(Schema.Boolean.annotate({ default: false })),
+ rules: Schema.Boolean,
+ sandbox_approval: Schema.Boolean,
+ skill_approval: Schema.optionalKey(Schema.Boolean.annotate({ default: false })),
+ }),
+ }).annotate({ title: "GranularAskForApproval" }),
+ ],
+ { mode: "oneOf" },
+);
+
export type ServerNotification__AuthMode =
| "apikey"
| "chatgpt"
| "chatgptAuthTokens"
- | "agentIdentity";
+ | "agentIdentity"
+ | "personalAccessToken";
export const ServerNotification__AuthMode = Schema.Literals([
"apikey",
"chatgpt",
"chatgptAuthTokens",
"agentIdentity",
+ "personalAccessToken",
]).annotate({ description: "Authentication mode for OpenAI-backed providers." });
export type ServerNotification__AutoReviewDecisionSource = "agent";
@@ -1895,8 +2018,8 @@ export const ServerNotification__FileChangeOutputDeltaNotification = Schema.Stru
"Deprecated legacy notification for `apply_patch` textual output.\n\nThe server no longer emits this notification.",
});
-export type ServerNotification__FileSystemAccessMode = "read" | "write" | "none";
-export const ServerNotification__FileSystemAccessMode = Schema.Literals(["read", "write", "none"]);
+export type ServerNotification__FileSystemAccessMode = "read" | "write" | "deny";
+export const ServerNotification__FileSystemAccessMode = Schema.Literals(["read", "write", "deny"]);
export type ServerNotification__FileSystemSpecialPath =
| { readonly kind: "root" }
@@ -2005,6 +2128,8 @@ export type ServerNotification__HookEventName =
| "postCompact"
| "sessionStart"
| "userPromptSubmit"
+ | "subagentStart"
+ | "subagentStop"
| "stop";
export const ServerNotification__HookEventName = Schema.Literals([
"preToolUse",
@@ -2014,6 +2139,8 @@ export const ServerNotification__HookEventName = Schema.Literals([
"postCompact",
"sessionStart",
"userPromptSubmit",
+ "subagentStart",
+ "subagentStop",
"stop",
]);
@@ -2063,6 +2190,9 @@ export const ServerNotification__HookRunStatus = Schema.Literals([
export type ServerNotification__HookScope = "thread" | "turn";
export const ServerNotification__HookScope = Schema.Literals(["thread", "turn"]);
+export type ServerNotification__ImageDetail = "auto" | "low" | "high" | "original";
+export const ServerNotification__ImageDetail = Schema.Literals(["auto", "low", "high", "original"]);
+
export type ServerNotification__McpServerOauthLoginCompletedNotification = {
readonly error?: string | null;
readonly name: string;
@@ -2146,6 +2276,11 @@ export const ServerNotification__MessagePhase = Schema.Literals([
'Classifies an assistant message as interim commentary or final answer text.\n\nProviders do not emit this consistently, so callers must treat `None` as "phase unknown" and keep compatibility behavior for legacy models.',
});
+export type ServerNotification__ModeKind = "plan" | "default";
+export const ServerNotification__ModeKind = Schema.Literals(["plan", "default"]).annotate({
+ description: "Initial collaboration mode to use when the TUI starts.",
+});
+
export type ServerNotification__ModelRerouteReason = "highRiskCyberActivity";
export const ServerNotification__ModelRerouteReason = Schema.Literal("highRiskCyberActivity");
@@ -2199,6 +2334,9 @@ export const ServerNotification__PatchChangeKind = Schema.Union(
{ mode: "oneOf" },
);
+export type ServerNotification__Personality = "none" | "friendly" | "pragmatic";
+export const ServerNotification__Personality = Schema.Literals(["none", "friendly", "pragmatic"]);
+
export type ServerNotification__PlanDeltaNotification = {
readonly delta: string;
readonly itemId: string;
@@ -2330,23 +2468,21 @@ export const ServerNotification__RateLimitWindow = Schema.Struct({
export type ServerNotification__RealtimeConversationVersion = "v1" | "v2";
export const ServerNotification__RealtimeConversationVersion = Schema.Literals(["v1", "v2"]);
-export type ServerNotification__ReasoningEffort =
- | "none"
- | "minimal"
- | "low"
- | "medium"
- | "high"
- | "xhigh";
-export const ServerNotification__ReasoningEffort = Schema.Literals([
- "none",
- "minimal",
- "low",
- "medium",
- "high",
- "xhigh",
-]).annotate({
+export type ServerNotification__ReasoningEffort = string;
+export const ServerNotification__ReasoningEffort = Schema.String.annotate({
+ description: "A non-empty reasoning effort value advertised by the model.",
+}).check(Schema.isMinLength(1));
+
+export type ServerNotification__ReasoningSummary = "auto" | "concise" | "detailed" | "none";
+export const ServerNotification__ReasoningSummary = Schema.Union(
+ [
+ Schema.Literals(["auto", "concise", "detailed"]),
+ Schema.Literal("none").annotate({ description: "Option to disable reasoning summaries." }),
+ ],
+ { mode: "oneOf" },
+).annotate({
description:
- "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning",
+ "A summary of the reasoning performed by the model. This can be useful for debugging and understanding the model's reasoning process. See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#reasoning-summaries",
});
export type ServerNotification__ReasoningSummaryPartAddedNotification = {
@@ -2416,6 +2552,26 @@ export const ServerNotification__SkillsChangedNotification = Schema.Struct({}).a
"Notification emitted when watched local skill files change.\n\nTreat this as an invalidation signal and re-run `skills/list` with the client's current parameters when refreshed skill metadata is needed.",
});
+export type ServerNotification__SpendControlLimitSnapshot = {
+ readonly limit: string;
+ readonly remainingPercent: number;
+ readonly resetsAt: number;
+ readonly used: string;
+};
+export const ServerNotification__SpendControlLimitSnapshot = Schema.Struct({
+ limit: Schema.String,
+ remainingPercent: Schema.Number.annotate({ format: "int32" }).check(Schema.isInt()),
+ resetsAt: Schema.Number.annotate({ format: "int64" }).check(Schema.isInt()),
+ used: Schema.String,
+});
+
+export type ServerNotification__SubAgentActivityKind = "started" | "interacted" | "interrupted";
+export const ServerNotification__SubAgentActivityKind = Schema.Literals([
+ "started",
+ "interacted",
+ "interrupted",
+]);
+
export type ServerNotification__TerminalInteractionNotification = {
readonly itemId: string;
readonly processId: string;
@@ -2485,6 +2641,11 @@ export const ServerNotification__ThreadClosedNotification = Schema.Struct({
threadId: Schema.String,
});
+export type ServerNotification__ThreadDeletedNotification = { readonly threadId: string };
+export const ServerNotification__ThreadDeletedNotification = Schema.Struct({
+ threadId: Schema.String,
+});
+
export type ServerNotification__ThreadGoalClearedNotification = { readonly threadId: string };
export const ServerNotification__ThreadGoalClearedNotification = Schema.Struct({
threadId: Schema.String,
@@ -2493,11 +2654,15 @@ export const ServerNotification__ThreadGoalClearedNotification = Schema.Struct({
export type ServerNotification__ThreadGoalStatus =
| "active"
| "paused"
+ | "blocked"
+ | "usageLimited"
| "budgetLimited"
| "complete";
export const ServerNotification__ThreadGoalStatus = Schema.Literals([
"active",
"paused",
+ "blocked",
+ "usageLimited",
"budgetLimited",
"complete",
]);
@@ -2608,12 +2773,8 @@ export const ServerNotification__ThreadRealtimeTranscriptDoneNotification = Sche
"EXPERIMENTAL - final transcript text emitted when realtime completes a transcript part.",
});
-export type ServerNotification__ThreadSource = "user" | "subagent" | "memory_consolidation";
-export const ServerNotification__ThreadSource = Schema.Literals([
- "user",
- "subagent",
- "memory_consolidation",
-]);
+export type ServerNotification__ThreadSource = string;
+export const ServerNotification__ThreadSource = Schema.String;
export type ServerNotification__ThreadUnarchivedNotification = { readonly threadId: string };
export const ServerNotification__ThreadUnarchivedNotification = Schema.Struct({
@@ -2649,6 +2810,17 @@ export const ServerNotification__TurnDiffUpdatedNotification = Schema.Struct({
"Notification that the turn-level unified diff has changed. Contains the latest aggregated diff across all file changes in the turn.",
});
+export type ServerNotification__TurnModerationMetadataNotification = {
+ readonly metadata: unknown;
+ readonly threadId: string;
+ readonly turnId: string;
+};
+export const ServerNotification__TurnModerationMetadataNotification = Schema.Struct({
+ metadata: Schema.Unknown,
+ threadId: Schema.String,
+ turnId: Schema.String,
+});
+
export type ServerNotification__TurnPlanStepStatus = "pending" | "inProgress" | "completed";
export const ServerNotification__TurnPlanStepStatus = Schema.Literals([
"pending",
@@ -2742,6 +2914,9 @@ export const ServerRequest__AdditionalNetworkPermissions = Schema.Struct({
enabled: Schema.optionalKey(Schema.Union([Schema.Boolean, Schema.Null])),
});
+export type ServerRequest__AttestationGenerateParams = {};
+export const ServerRequest__AttestationGenerateParams = Schema.Struct({});
+
export type ServerRequest__ChatgptAuthTokensRefreshReason = "unauthorized";
export const ServerRequest__ChatgptAuthTokensRefreshReason = Schema.Literal("unauthorized");
@@ -2789,6 +2964,7 @@ export type ServerRequest__FileChangeRequestApprovalParams = {
readonly grantRoot?: string | null;
readonly itemId: string;
readonly reason?: string | null;
+ readonly startedAtMs: number;
readonly threadId: string;
readonly turnId: string;
};
@@ -2811,12 +2987,16 @@ export const ServerRequest__FileChangeRequestApprovalParams = Schema.Struct({
Schema.Null,
]),
),
+ startedAtMs: Schema.Number.annotate({
+ description: "Unix timestamp (in milliseconds) when this approval request started.",
+ format: "int64",
+ }).check(Schema.isInt()),
threadId: Schema.String,
turnId: Schema.String,
});
-export type ServerRequest__FileSystemAccessMode = "read" | "write" | "none";
-export const ServerRequest__FileSystemAccessMode = Schema.Literals(["read", "write", "none"]);
+export type ServerRequest__FileSystemAccessMode = "read" | "write" | "deny";
+export const ServerRequest__FileSystemAccessMode = Schema.Literals(["read", "write", "deny"]);
export type ServerRequest__FileSystemSpecialPath =
| { readonly kind: "root" }
@@ -2989,6 +3169,7 @@ export const V1InitializeParams__ClientInfo = Schema.Struct({
export type V1InitializeParams__InitializeCapabilities = {
readonly experimentalApi?: boolean;
readonly optOutNotificationMethods?: ReadonlyArray<string> | null;
+ readonly requestAttestation?: boolean;
};
export const V1InitializeParams__InitializeCapabilities = Schema.Struct({
experimentalApi: Schema.optionalKey(
@@ -3006,6 +3187,12 @@ export const V1InitializeParams__InitializeCapabilities = Schema.Struct({
Schema.Null,
]),
),
+ requestAttestation: Schema.optionalKey(
+ Schema.Boolean.annotate({
+ description: "Opt into `attestation/generate` requests for upstream `x-oai-attestation`.",
+ default: false,
+ }),
+ ),
}).annotate({ description: "Client-declared capabilities negotiated during initialize." });
export type V2AccountRateLimitsUpdatedNotification__CreditsSnapshot = {
@@ -3076,16 +3263,31 @@ export const V2AccountRateLimitsUpdatedNotification__RateLimitWindow = Schema.St
),
});
+export type V2AccountRateLimitsUpdatedNotification__SpendControlLimitSnapshot = {
+ readonly limit: string;
+ readonly remainingPercent: number;
+ readonly resetsAt: number;
+ readonly used: string;
+};
+export const V2AccountRateLimitsUpdatedNotification__SpendControlLimitSnapshot = Schema.Struct({
+ limit: Schema.String,
+ remainingPercent: Schema.Number.annotate({ format: "int32" }).check(Schema.isInt()),
+ resetsAt: Schema.Number.annotate({ format: "int64" }).check(Schema.isInt()),
+ used: Schema.String,
+});
+
export type V2AccountUpdatedNotification__AuthMode =
| "apikey"
| "chatgpt"
| "chatgptAuthTokens"
- | "agentIdentity";
+ | "agentIdentity"
+ | "personalAccessToken";
export const V2AccountUpdatedNotification__AuthMode = Schema.Literals([
"apikey",
"chatgpt",
"chatgptAuthTokens",
"agentIdentity",
+ "personalAccessToken",
]).annotate({ description: "Authentication mode for OpenAI-backed providers." });
export type V2AccountUpdatedNotification__PlanType =
@@ -3209,50 +3411,6 @@ export const V2CommandExecParams__CommandExecTerminalSize = Schema.Struct({
.check(Schema.isGreaterThanOrEqualTo(0)),
}).annotate({ description: "PTY size in character cells for `command/exec` PTY sessions." });
-export type V2CommandExecParams__FileSystemAccessMode = "read" | "write" | "none";
-export const V2CommandExecParams__FileSystemAccessMode = Schema.Literals(["read", "write", "none"]);
-
-export type V2CommandExecParams__FileSystemSpecialPath =
- | { readonly kind: "root" }
- | { readonly kind: "minimal" }
- | { readonly kind: "project_roots"; readonly subpath?: string | null }
- | { readonly kind: "tmpdir" }
- | { readonly kind: "slash_tmp" }
- | { readonly kind: "unknown"; readonly path: string; readonly subpath?: string | null };
-export const V2CommandExecParams__FileSystemSpecialPath = Schema.Union(
- [
- Schema.Struct({ kind: Schema.Literal("root") }).annotate({
- title: "RootFileSystemSpecialPath",
- }),
- Schema.Struct({ kind: Schema.Literal("minimal") }).annotate({
- title: "MinimalFileSystemSpecialPath",
- }),
- Schema.Struct({
- kind: Schema.Literal("project_roots"),
- subpath: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
- }).annotate({ title: "KindFileSystemSpecialPath" }),
- Schema.Struct({ kind: Schema.Literal("tmpdir") }).annotate({
- title: "TmpdirFileSystemSpecialPath",
- }),
- Schema.Struct({ kind: Schema.Literal("slash_tmp") }).annotate({
- title: "SlashTmpFileSystemSpecialPath",
- }),
- Schema.Struct({
- kind: Schema.Literal("unknown"),
- path: Schema.String,
- subpath: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
- }),
- ],
- { mode: "oneOf" },
-);
-
-export type V2CommandExecParams__PermissionProfileNetworkPermissions = {
- readonly enabled: boolean;
-};
-export const V2CommandExecParams__PermissionProfileNetworkPermissions = Schema.Struct({
- enabled: Schema.Boolean,
-});
-
export type V2ConfigBatchWriteParams__MergeStrategy = "replace" | "upsert";
export const V2ConfigBatchWriteParams__MergeStrategy = Schema.Literals(["replace", "upsert"]);
@@ -3328,28 +3486,31 @@ export const V2ConfigReadResponse__AskForApproval = Schema.Union(
{ mode: "oneOf" },
);
-export type V2ConfigReadResponse__ForcedLoginMethod = "chatgpt" | "api";
-export const V2ConfigReadResponse__ForcedLoginMethod = Schema.Literals(["chatgpt", "api"]);
-
-export type V2ConfigReadResponse__ReasoningEffort =
- | "none"
- | "minimal"
- | "low"
- | "medium"
- | "high"
- | "xhigh";
-export const V2ConfigReadResponse__ReasoningEffort = Schema.Literals([
- "none",
- "minimal",
- "low",
- "medium",
- "high",
- "xhigh",
+export type V2ConfigReadResponse__AutoCompactTokenLimitScope = "total" | "body_after_prefix";
+export const V2ConfigReadResponse__AutoCompactTokenLimitScope = Schema.Literals([
+ "total",
+ "body_after_prefix",
]).annotate({
description:
- "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning",
+ "Selects which part of the active context is charged against `model_auto_compact_token_limit`.",
});
+export type V2ConfigReadResponse__ForcedChatgptWorkspaceIds = string | ReadonlyArray<string>;
+export const V2ConfigReadResponse__ForcedChatgptWorkspaceIds = Schema.Union([
+ Schema.String,
+ Schema.Array(Schema.String),
+]).annotate({
+ description: "Backward-compatible API shape for ChatGPT workspace login restrictions.",
+});
+
+export type V2ConfigReadResponse__ForcedLoginMethod = "chatgpt" | "api";
+export const V2ConfigReadResponse__ForcedLoginMethod = Schema.Literals(["chatgpt", "api"]);
+
+export type V2ConfigReadResponse__ReasoningEffort = string;
+export const V2ConfigReadResponse__ReasoningEffort = Schema.String.annotate({
+ description: "A non-empty reasoning effort value advertised by the model.",
+}).check(Schema.isMinLength(1));
+
export type V2ConfigReadResponse__ReasoningSummary = "auto" | "concise" | "detailed" | "none";
export const V2ConfigReadResponse__ReasoningSummary = Schema.Union(
[
@@ -3444,10 +3605,18 @@ export const V2ConfigRequirementsReadResponse__AskForApproval = Schema.Union(
{ mode: "oneOf" },
);
+export type V2ConfigRequirementsReadResponse__ComputerUseRequirements = {
+ readonly allowLockedComputerUse?: boolean | null;
+};
+export const V2ConfigRequirementsReadResponse__ComputerUseRequirements = Schema.Struct({
+ allowLockedComputerUse: Schema.optionalKey(Schema.Union([Schema.Boolean, Schema.Null])),
+});
+
export type V2ConfigRequirementsReadResponse__ConfiguredHookHandler =
| {
readonly async: boolean;
readonly command: string;
+ readonly commandWindows?: string | null;
readonly statusMessage?: string | null;
readonly timeoutSec?: number | null;
readonly type: "command";
@@ -3459,6 +3628,7 @@ export const V2ConfigRequirementsReadResponse__ConfiguredHookHandler = Schema.Un
Schema.Struct({
async: Schema.Boolean,
command: Schema.String,
+ commandWindows: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
statusMessage: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
timeoutSec: Schema.optionalKey(
Schema.Union([
@@ -3486,10 +3656,10 @@ export const V2ConfigRequirementsReadResponse__NetworkDomainPermission = Schema.
"deny",
]);
-export type V2ConfigRequirementsReadResponse__NetworkUnixSocketPermission = "allow" | "none";
+export type V2ConfigRequirementsReadResponse__NetworkUnixSocketPermission = "allow" | "deny";
export const V2ConfigRequirementsReadResponse__NetworkUnixSocketPermission = Schema.Literals([
"allow",
- "none",
+ "deny",
]);
export type V2ConfigRequirementsReadResponse__ResidencyRequirement = "us";
@@ -3512,6 +3682,12 @@ export const V2ConfigRequirementsReadResponse__WebSearchMode = Schema.Literals([
"live",
]);
+export type V2ConfigRequirementsReadResponse__WindowsSandboxSetupMode = "elevated" | "unelevated";
+export const V2ConfigRequirementsReadResponse__WindowsSandboxSetupMode = Schema.Literals([
+ "elevated",
+ "unelevated",
+]);
+
export type V2ConfigValueWriteParams__MergeStrategy = "replace" | "upsert";
export const V2ConfigValueWriteParams__MergeStrategy = Schema.Literals(["replace", "upsert"]);
@@ -3831,6 +4007,19 @@ export const V2GetAccountRateLimitsResponse__RateLimitWindow = Schema.Struct({
),
});
+export type V2GetAccountRateLimitsResponse__SpendControlLimitSnapshot = {
+ readonly limit: string;
+ readonly remainingPercent: number;
+ readonly resetsAt: number;
+ readonly used: string;
+};
+export const V2GetAccountRateLimitsResponse__SpendControlLimitSnapshot = Schema.Struct({
+ limit: Schema.String,
+ remainingPercent: Schema.Number.annotate({ format: "int32" }).check(Schema.isInt()),
+ resetsAt: Schema.Number.annotate({ format: "int64" }).check(Schema.isInt()),
+ used: Schema.String,
+});
+
export type V2GetAccountResponse__PlanType =
| "free"
| "go"
@@ -3859,6 +4048,40 @@ export const V2GetAccountResponse__PlanType = Schema.Literals([
"unknown",
]);
+export type V2GetAccountTokenUsageResponse__AccountTokenUsageDailyBucket = {
+ readonly startDate: string;
+ readonly tokens: number;
+};
+export const V2GetAccountTokenUsageResponse__AccountTokenUsageDailyBucket = Schema.Struct({
+ startDate: Schema.String,
+ tokens: Schema.Number.annotate({ format: "int64" }).check(Schema.isInt()),
+});
+
+export type V2GetAccountTokenUsageResponse__AccountTokenUsageSummary = {
+ readonly currentStreakDays?: number | null;
+ readonly lifetimeTokens?: number | null;
+ readonly longestRunningTurnSec?: number | null;
+ readonly longestStreakDays?: number | null;
+ readonly peakDailyTokens?: number | null;
+};
+export const V2GetAccountTokenUsageResponse__AccountTokenUsageSummary = Schema.Struct({
+ currentStreakDays: Schema.optionalKey(
+ Schema.Union([Schema.Number.annotate({ format: "int64" }).check(Schema.isInt()), Schema.Null]),
+ ),
+ lifetimeTokens: Schema.optionalKey(
+ Schema.Union([Schema.Number.annotate({ format: "int64" }).check(Schema.isInt()), Schema.Null]),
+ ),
+ longestRunningTurnSec: Schema.optionalKey(
+ Schema.Union([Schema.Number.annotate({ format: "int64" }).check(Schema.isInt()), Schema.Null]),
+ ),
+ longestStreakDays: Schema.optionalKey(
+ Schema.Union([Schema.Number.annotate({ format: "int64" }).check(Schema.isInt()), Schema.Null]),
+ ),
+ peakDailyTokens: Schema.optionalKey(
+ Schema.Union([Schema.Number.annotate({ format: "int64" }).check(Schema.isInt()), Schema.Null]),
+ ),
+});
+
export type V2HookCompletedNotification__AbsolutePathBuf = string;
export const V2HookCompletedNotification__AbsolutePathBuf = Schema.String.annotate({
description:
@@ -3873,6 +4096,8 @@ export type V2HookCompletedNotification__HookEventName =
| "postCompact"
| "sessionStart"
| "userPromptSubmit"
+ | "subagentStart"
+ | "subagentStop"
| "stop";
export const V2HookCompletedNotification__HookEventName = Schema.Literals([
"preToolUse",
@@ -3882,6 +4107,8 @@ export const V2HookCompletedNotification__HookEventName = Schema.Literals([
"postCompact",
"sessionStart",
"userPromptSubmit",
+ "subagentStart",
+ "subagentStop",
"stop",
]);
@@ -3949,6 +4176,8 @@ export type V2HooksListResponse__HookEventName =
| "postCompact"
| "sessionStart"
| "userPromptSubmit"
+ | "subagentStart"
+ | "subagentStop"
| "stop";
export const V2HooksListResponse__HookEventName = Schema.Literals([
"preToolUse",
@@ -3958,6 +4187,8 @@ export const V2HooksListResponse__HookEventName = Schema.Literals([
"postCompact",
"sessionStart",
"userPromptSubmit",
+ "subagentStart",
+ "subagentStop",
"stop",
]);
@@ -3972,6 +4203,7 @@ export type V2HooksListResponse__HookSource =
| "sessionFlags"
| "plugin"
| "cloudRequirements"
+ | "cloudManagedConfig"
| "legacyManagedConfigFile"
| "legacyManagedConfigMdm"
| "unknown";
@@ -3983,6 +4215,7 @@ export const V2HooksListResponse__HookSource = Schema.Literals([
"sessionFlags",
"plugin",
"cloudRequirements",
+ "cloudManagedConfig",
"legacyManagedConfigFile",
"legacyManagedConfigMdm",
"unknown",
@@ -4010,6 +4243,8 @@ export type V2HookStartedNotification__HookEventName =
| "postCompact"
| "sessionStart"
| "userPromptSubmit"
+ | "subagentStart"
+ | "subagentStop"
| "stop";
export const V2HookStartedNotification__HookEventName = Schema.Literals([
"preToolUse",
@@ -4019,6 +4254,8 @@ export const V2HookStartedNotification__HookEventName = Schema.Literals([
"postCompact",
"sessionStart",
"userPromptSubmit",
+ "subagentStart",
+ "subagentStop",
"stop",
]);
@@ -4139,6 +4376,14 @@ export const V2ItemCompletedNotification__HookPromptFragment = Schema.Struct({
text: Schema.String,
});
+export type V2ItemCompletedNotification__ImageDetail = "auto" | "low" | "high" | "original";
+export const V2ItemCompletedNotification__ImageDetail = Schema.Literals([
+ "auto",
+ "low",
+ "high",
+ "original",
+]);
+
export type V2ItemCompletedNotification__McpToolCallError = { readonly message: string };
export const V2ItemCompletedNotification__McpToolCallError = Schema.Struct({
message: Schema.String,
@@ -4220,24 +4465,20 @@ export const V2ItemCompletedNotification__PatchChangeKind = Schema.Union(
{ mode: "oneOf" },
);
-export type V2ItemCompletedNotification__ReasoningEffort =
- | "none"
- | "minimal"
- | "low"
- | "medium"
- | "high"
- | "xhigh";
-export const V2ItemCompletedNotification__ReasoningEffort = Schema.Literals([
- "none",
- "minimal",
- "low",
- "medium",
- "high",
- "xhigh",
-]).annotate({
- description:
- "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning",
-});
+export type V2ItemCompletedNotification__ReasoningEffort = string;
+export const V2ItemCompletedNotification__ReasoningEffort = Schema.String.annotate({
+ description: "A non-empty reasoning effort value advertised by the model.",
+}).check(Schema.isMinLength(1));
+
+export type V2ItemCompletedNotification__SubAgentActivityKind =
+ | "started"
+ | "interacted"
+ | "interrupted";
+export const V2ItemCompletedNotification__SubAgentActivityKind = Schema.Literals([
+ "started",
+ "interacted",
+ "interrupted",
+]);
export type V2ItemCompletedNotification__TextElement = {
readonly byteRange: { readonly end: number; readonly start: number };
@@ -4318,9 +4559,9 @@ export const V2ItemGuardianApprovalReviewCompletedNotification__AutoReviewDecisi
export type V2ItemGuardianApprovalReviewCompletedNotification__FileSystemAccessMode =
| "read"
| "write"
- | "none";
+ | "deny";
export const V2ItemGuardianApprovalReviewCompletedNotification__FileSystemAccessMode =
- Schema.Literals(["read", "write", "none"]);
+ Schema.Literals(["read", "write", "deny"]);
export type V2ItemGuardianApprovalReviewCompletedNotification__FileSystemSpecialPath =
| { readonly kind: "root" }
@@ -4417,9 +4658,9 @@ export const V2ItemGuardianApprovalReviewStartedNotification__AdditionalNetworkP
export type V2ItemGuardianApprovalReviewStartedNotification__FileSystemAccessMode =
| "read"
| "write"
- | "none";
+ | "deny";
export const V2ItemGuardianApprovalReviewStartedNotification__FileSystemAccessMode =
- Schema.Literals(["read", "write", "none"]);
+ Schema.Literals(["read", "write", "deny"]);
export type V2ItemGuardianApprovalReviewStartedNotification__FileSystemSpecialPath =
| { readonly kind: "root" }
@@ -4578,6 +4819,14 @@ export const V2ItemStartedNotification__HookPromptFragment = Schema.Struct({
text: Schema.String,
});
+export type V2ItemStartedNotification__ImageDetail = "auto" | "low" | "high" | "original";
+export const V2ItemStartedNotification__ImageDetail = Schema.Literals([
+ "auto",
+ "low",
+ "high",
+ "original",
+]);
+
export type V2ItemStartedNotification__McpToolCallError = { readonly message: string };
export const V2ItemStartedNotification__McpToolCallError = Schema.Struct({
message: Schema.String,
@@ -4659,24 +4908,20 @@ export const V2ItemStartedNotification__PatchChangeKind = Schema.Union(
{ mode: "oneOf" },
);
-export type V2ItemStartedNotification__ReasoningEffort =
- | "none"
- | "minimal"
- | "low"
- | "medium"
- | "high"
- | "xhigh";
-export const V2ItemStartedNotification__ReasoningEffort = Schema.Literals([
- "none",
- "minimal",
- "low",
- "medium",
- "high",
- "xhigh",
-]).annotate({
- description:
- "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning",
-});
+export type V2ItemStartedNotification__ReasoningEffort = string;
+export const V2ItemStartedNotification__ReasoningEffort = Schema.String.annotate({
+ description: "A non-empty reasoning effort value advertised by the model.",
+}).check(Schema.isMinLength(1));
+
+export type V2ItemStartedNotification__SubAgentActivityKind =
+ | "started"
+ | "interacted"
+ | "interrupted";
+export const V2ItemStartedNotification__SubAgentActivityKind = Schema.Literals([
+ "started",
+ "interacted",
+ "interrupted",
+]);
export type V2ItemStartedNotification__TextElement = {
readonly byteRange: { readonly end: number; readonly start: number };
@@ -4753,6 +4998,23 @@ export const V2ListMcpServerStatusResponse__McpAuthStatus = Schema.Literals([
"oAuth",
]);
+export type V2ListMcpServerStatusResponse__McpServerInfo = {
+ readonly description?: string | null;
+ readonly icons?: ReadonlyArray<unknown> | null;
+ readonly name: string;
+ readonly title?: string | null;
+ readonly version: string;
+ readonly websiteUrl?: string | null;
+};
+export const V2ListMcpServerStatusResponse__McpServerInfo = Schema.Struct({
+ description: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ icons: Schema.optionalKey(Schema.Union([Schema.Array(Schema.Unknown), Schema.Null])),
+ name: Schema.String,
+ title: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ version: Schema.String,
+ websiteUrl: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+}).annotate({ description: "Presentation metadata advertised by an initialized MCP server." });
+
export type V2ListMcpServerStatusResponse__Resource = {
readonly _meta?: unknown;
readonly annotations?: unknown;
@@ -4915,24 +5177,10 @@ export const V2ModelListResponse__ModelUpgradeInfo = Schema.Struct({
upgradeCopy: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
});
-export type V2ModelListResponse__ReasoningEffort =
- | "none"
- | "minimal"
- | "low"
- | "medium"
- | "high"
- | "xhigh";
-export const V2ModelListResponse__ReasoningEffort = Schema.Literals([
- "none",
- "minimal",
- "low",
- "medium",
- "high",
- "xhigh",
-]).annotate({
- description:
- "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning",
-});
+export type V2ModelListResponse__ReasoningEffort = string;
+export const V2ModelListResponse__ReasoningEffort = Schema.String.annotate({
+ description: "A non-empty reasoning effort value advertised by the model.",
+}).check(Schema.isMinLength(1));
export type V2ModelReroutedNotification__ModelRerouteReason = "highRiskCyberActivity";
export const V2ModelReroutedNotification__ModelRerouteReason =
@@ -4942,6 +5190,81 @@ export type V2ModelVerificationNotification__ModelVerification = "trustedAccessF
export const V2ModelVerificationNotification__ModelVerification =
Schema.Literal("trustedAccessForCyber");
+export type V2PermissionProfileListResponse__PermissionProfileSummary = {
+ readonly description?: string | null;
+ readonly id: string;
+};
+export const V2PermissionProfileListResponse__PermissionProfileSummary = Schema.Struct({
+ description: Schema.optionalKey(
+ Schema.Union([
+ Schema.String.annotate({
+ description: "Optional user-facing description for display in clients.",
+ }),
+ Schema.Null,
+ ]),
+ ),
+ id: Schema.String.annotate({ description: "Available permission profile identifier." }),
+});
+
+export type V2PluginInstalledParams__AbsolutePathBuf = string;
+export const V2PluginInstalledParams__AbsolutePathBuf = Schema.String.annotate({
+ description:
+ "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.",
+});
+
+export type V2PluginInstalledResponse__AbsolutePathBuf = string;
+export const V2PluginInstalledResponse__AbsolutePathBuf = Schema.String.annotate({
+ description:
+ "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.",
+});
+
+export type V2PluginInstalledResponse__MarketplaceInterface = {
+ readonly displayName?: string | null;
+};
+export const V2PluginInstalledResponse__MarketplaceInterface = Schema.Struct({
+ displayName: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+});
+
+export type V2PluginInstalledResponse__PluginAuthPolicy = "ON_INSTALL" | "ON_USE";
+export const V2PluginInstalledResponse__PluginAuthPolicy = Schema.Literals([
+ "ON_INSTALL",
+ "ON_USE",
+]);
+
+export type V2PluginInstalledResponse__PluginInstallPolicy =
+ | "NOT_AVAILABLE"
+ | "AVAILABLE"
+ | "INSTALLED_BY_DEFAULT";
+export const V2PluginInstalledResponse__PluginInstallPolicy = Schema.Literals([
+ "NOT_AVAILABLE",
+ "AVAILABLE",
+ "INSTALLED_BY_DEFAULT",
+]);
+
+export type V2PluginInstalledResponse__PluginShareDiscoverability =
+ | "LISTED"
+ | "UNLISTED"
+ | "PRIVATE";
+export const V2PluginInstalledResponse__PluginShareDiscoverability = Schema.Literals([
+ "LISTED",
+ "UNLISTED",
+ "PRIVATE",
+]);
+
+export type V2PluginInstalledResponse__PluginSharePrincipalRole = "reader" | "editor" | "owner";
+export const V2PluginInstalledResponse__PluginSharePrincipalRole = Schema.Literals([
+ "reader",
+ "editor",
+ "owner",
+]);
+
+export type V2PluginInstalledResponse__PluginSharePrincipalType = "user" | "group" | "workspace";
+export const V2PluginInstalledResponse__PluginSharePrincipalType = Schema.Literals([
+ "user",
+ "group",
+ "workspace",
+]);
+
export type V2PluginInstallParams__AbsolutePathBuf = string;
export const V2PluginInstallParams__AbsolutePathBuf = Schema.String.annotate({
description:
@@ -4974,10 +5297,12 @@ export const V2PluginListParams__AbsolutePathBuf = Schema.String.annotate({
export type V2PluginListParams__PluginListMarketplaceKind =
| "local"
+ | "vertical"
| "workspace-directory"
| "shared-with-me";
export const V2PluginListParams__PluginListMarketplaceKind = Schema.Literals([
"local",
+ "vertical",
"workspace-directory",
"shared-with-me",
]);
@@ -5006,6 +5331,20 @@ export const V2PluginListResponse__PluginInstallPolicy = Schema.Literals([
"INSTALLED_BY_DEFAULT",
]);
+export type V2PluginListResponse__PluginShareDiscoverability = "LISTED" | "UNLISTED" | "PRIVATE";
+export const V2PluginListResponse__PluginShareDiscoverability = Schema.Literals([
+ "LISTED",
+ "UNLISTED",
+ "PRIVATE",
+]);
+
+export type V2PluginListResponse__PluginSharePrincipalRole = "reader" | "editor" | "owner";
+export const V2PluginListResponse__PluginSharePrincipalRole = Schema.Literals([
+ "reader",
+ "editor",
+ "owner",
+]);
+
export type V2PluginListResponse__PluginSharePrincipalType = "user" | "group" | "workspace";
export const V2PluginListResponse__PluginSharePrincipalType = Schema.Literals([
"user",
@@ -5040,6 +5379,14 @@ export const V2PluginReadResponse__AppSummary = Schema.Struct({
needsAuth: Schema.Boolean,
}).annotate({ description: "EXPERIMENTAL - app metadata summary for plugin responses." });
+export type V2PluginReadResponse__AppTemplateUnavailableReason =
+ | "NOT_CONFIGURED_FOR_WORKSPACE"
+ | "NO_ACTIVE_WORKSPACE";
+export const V2PluginReadResponse__AppTemplateUnavailableReason = Schema.Literals([
+ "NOT_CONFIGURED_FOR_WORKSPACE",
+ "NO_ACTIVE_WORKSPACE",
+]);
+
export type V2PluginReadResponse__HookEventName =
| "preToolUse"
| "permissionRequest"
@@ -5048,6 +5395,8 @@ export type V2PluginReadResponse__HookEventName =
| "postCompact"
| "sessionStart"
| "userPromptSubmit"
+ | "subagentStart"
+ | "subagentStop"
| "stop";
export const V2PluginReadResponse__HookEventName = Schema.Literals([
"preToolUse",
@@ -5057,6 +5406,8 @@ export const V2PluginReadResponse__HookEventName = Schema.Literals([
"postCompact",
"sessionStart",
"userPromptSubmit",
+ "subagentStart",
+ "subagentStop",
"stop",
]);
@@ -5073,6 +5424,20 @@ export const V2PluginReadResponse__PluginInstallPolicy = Schema.Literals([
"INSTALLED_BY_DEFAULT",
]);
+export type V2PluginReadResponse__PluginShareDiscoverability = "LISTED" | "UNLISTED" | "PRIVATE";
+export const V2PluginReadResponse__PluginShareDiscoverability = Schema.Literals([
+ "LISTED",
+ "UNLISTED",
+ "PRIVATE",
+]);
+
+export type V2PluginReadResponse__PluginSharePrincipalRole = "reader" | "editor" | "owner";
+export const V2PluginReadResponse__PluginSharePrincipalRole = Schema.Literals([
+ "reader",
+ "editor",
+ "owner",
+]);
+
export type V2PluginReadResponse__PluginSharePrincipalType = "user" | "group" | "workspace";
export const V2PluginReadResponse__PluginSharePrincipalType = Schema.Literals([
"user",
@@ -5080,6 +5445,12 @@ export const V2PluginReadResponse__PluginSharePrincipalType = Schema.Literals([
"workspace",
]);
+export type V2PluginShareCheckoutResponse__AbsolutePathBuf = string;
+export const V2PluginShareCheckoutResponse__AbsolutePathBuf = Schema.String.annotate({
+ description:
+ "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.",
+});
+
export type V2PluginShareListResponse__AbsolutePathBuf = string;
export const V2PluginShareListResponse__AbsolutePathBuf = Schema.String.annotate({
description:
@@ -5102,6 +5473,23 @@ export const V2PluginShareListResponse__PluginInstallPolicy = Schema.Literals([
"INSTALLED_BY_DEFAULT",
]);
+export type V2PluginShareListResponse__PluginShareDiscoverability =
+ | "LISTED"
+ | "UNLISTED"
+ | "PRIVATE";
+export const V2PluginShareListResponse__PluginShareDiscoverability = Schema.Literals([
+ "LISTED",
+ "UNLISTED",
+ "PRIVATE",
+]);
+
+export type V2PluginShareListResponse__PluginSharePrincipalRole = "reader" | "editor" | "owner";
+export const V2PluginShareListResponse__PluginSharePrincipalRole = Schema.Literals([
+ "reader",
+ "editor",
+ "owner",
+]);
+
export type V2PluginShareListResponse__PluginSharePrincipalType = "user" | "group" | "workspace";
export const V2PluginShareListResponse__PluginSharePrincipalType = Schema.Literals([
"user",
@@ -5129,6 +5517,9 @@ export const V2PluginShareSaveParams__PluginSharePrincipalType = Schema.Literals
"workspace",
]);
+export type V2PluginShareSaveParams__PluginShareTargetRole = "reader" | "editor";
+export const V2PluginShareSaveParams__PluginShareTargetRole = Schema.Literals(["reader", "editor"]);
+
export type V2PluginShareUpdateTargetsParams__PluginSharePrincipalType =
| "user"
| "group"
@@ -5139,6 +5530,40 @@ export const V2PluginShareUpdateTargetsParams__PluginSharePrincipalType = Schema
"workspace",
]);
+export type V2PluginShareUpdateTargetsParams__PluginShareTargetRole = "reader" | "editor";
+export const V2PluginShareUpdateTargetsParams__PluginShareTargetRole = Schema.Literals([
+ "reader",
+ "editor",
+]);
+
+export type V2PluginShareUpdateTargetsParams__PluginShareUpdateDiscoverability =
+ | "UNLISTED"
+ | "PRIVATE";
+export const V2PluginShareUpdateTargetsParams__PluginShareUpdateDiscoverability = Schema.Literals([
+ "UNLISTED",
+ "PRIVATE",
+]);
+
+export type V2PluginShareUpdateTargetsResponse__PluginShareDiscoverability =
+ | "LISTED"
+ | "UNLISTED"
+ | "PRIVATE";
+export const V2PluginShareUpdateTargetsResponse__PluginShareDiscoverability = Schema.Literals([
+ "LISTED",
+ "UNLISTED",
+ "PRIVATE",
+]);
+
+export type V2PluginShareUpdateTargetsResponse__PluginSharePrincipalRole =
+ | "reader"
+ | "editor"
+ | "owner";
+export const V2PluginShareUpdateTargetsResponse__PluginSharePrincipalRole = Schema.Literals([
+ "reader",
+ "editor",
+ "owner",
+]);
+
export type V2PluginShareUpdateTargetsResponse__PluginSharePrincipalType =
| "user"
| "group"
@@ -5149,6 +5574,22 @@ export const V2PluginShareUpdateTargetsResponse__PluginSharePrincipalType = Sche
"workspace",
]);
+export type V2RawResponseItemCompletedNotification__AgentMessageInputContent = {
+ readonly encrypted_content: string;
+ readonly type: "encrypted_content";
+};
+export const V2RawResponseItemCompletedNotification__AgentMessageInputContent = Schema.Union(
+ [
+ Schema.Struct({
+ encrypted_content: Schema.String,
+ type: Schema.Literal("encrypted_content").annotate({
+ title: "EncryptedContentAgentMessageInputContentType",
+ }),
+ }).annotate({ title: "EncryptedContentAgentMessageInputContent" }),
+ ],
+ { mode: "oneOf" },
+);
+
export type V2RawResponseItemCompletedNotification__ImageDetail =
| "auto"
| "low"
@@ -5418,6 +5859,14 @@ export const V2ReviewStartResponse__HookPromptFragment = Schema.Struct({
text: Schema.String,
});
+export type V2ReviewStartResponse__ImageDetail = "auto" | "low" | "high" | "original";
+export const V2ReviewStartResponse__ImageDetail = Schema.Literals([
+ "auto",
+ "low",
+ "high",
+ "original",
+]);
+
export type V2ReviewStartResponse__McpToolCallError = { readonly message: string };
export const V2ReviewStartResponse__McpToolCallError = Schema.Struct({ message: Schema.String });
@@ -5500,24 +5949,17 @@ export const V2ReviewStartResponse__PatchChangeKind = Schema.Union(
{ mode: "oneOf" },
);
-export type V2ReviewStartResponse__ReasoningEffort =
- | "none"
- | "minimal"
- | "low"
- | "medium"
- | "high"
- | "xhigh";
-export const V2ReviewStartResponse__ReasoningEffort = Schema.Literals([
- "none",
- "minimal",
- "low",
- "medium",
- "high",
- "xhigh",
-]).annotate({
- description:
- "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning",
-});
+export type V2ReviewStartResponse__ReasoningEffort = string;
+export const V2ReviewStartResponse__ReasoningEffort = Schema.String.annotate({
+ description: "A non-empty reasoning effort value advertised by the model.",
+}).check(Schema.isMinLength(1));
+
+export type V2ReviewStartResponse__SubAgentActivityKind = "started" | "interacted" | "interrupted";
+export const V2ReviewStartResponse__SubAgentActivityKind = Schema.Literals([
+ "started",
+ "interacted",
+ "interrupted",
+]);
export type V2ReviewStartResponse__TextElement = {
readonly byteRange: { readonly end: number; readonly start: number };
@@ -5614,13 +6056,10 @@ export const V2SkillsConfigWriteParams__AbsolutePathBuf = Schema.String.annotate
"A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.",
});
-export type V2SkillsListParams__SkillsListExtraRootsForCwd = {
- readonly cwd: string;
- readonly extraUserRoots: ReadonlyArray<string>;
-};
-export const V2SkillsListParams__SkillsListExtraRootsForCwd = Schema.Struct({
- cwd: Schema.String,
- extraUserRoots: Schema.Array(Schema.String),
+export type V2SkillsExtraRootsSetParams__AbsolutePathBuf = string;
+export const V2SkillsExtraRootsSetParams__AbsolutePathBuf = Schema.String.annotate({
+ description:
+ "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.",
});
export type V2SkillsListResponse__AbsolutePathBuf = string;
@@ -5663,12 +6102,6 @@ export const V2SkillsListResponse__SkillToolDependency = Schema.Struct({
value: Schema.String,
});
-export type V2ThreadForkParams__AbsolutePathBuf = string;
-export const V2ThreadForkParams__AbsolutePathBuf = Schema.String.annotate({
- description:
- "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.",
-});
-
export type V2ThreadForkParams__ApprovalsReviewer = "user" | "auto_review" | "guardian_subagent";
export const V2ThreadForkParams__ApprovalsReviewer = Schema.Literals([
"user",
@@ -5719,12 +6152,8 @@ export const V2ThreadForkParams__SandboxMode = Schema.Literals([
"danger-full-access",
]);
-export type V2ThreadForkParams__ThreadSource = "user" | "subagent" | "memory_consolidation";
-export const V2ThreadForkParams__ThreadSource = Schema.Literals([
- "user",
- "subagent",
- "memory_consolidation",
-]);
+export type V2ThreadForkParams__ThreadSource = string;
+export const V2ThreadForkParams__ThreadSource = Schema.String;
export type V2ThreadForkResponse__AbsolutePathBuf = string;
export const V2ThreadForkResponse__AbsolutePathBuf = Schema.String.annotate({
@@ -5823,47 +6252,6 @@ export const V2ThreadForkResponse__DynamicToolCallStatus = Schema.Literals([
"failed",
]);
-export type V2ThreadForkResponse__FileSystemAccessMode = "read" | "write" | "none";
-export const V2ThreadForkResponse__FileSystemAccessMode = Schema.Literals([
- "read",
- "write",
- "none",
-]);
-
-export type V2ThreadForkResponse__FileSystemSpecialPath =
- | { readonly kind: "root" }
- | { readonly kind: "minimal" }
- | { readonly kind: "project_roots"; readonly subpath?: string | null }
- | { readonly kind: "tmpdir" }
- | { readonly kind: "slash_tmp" }
- | { readonly kind: "unknown"; readonly path: string; readonly subpath?: string | null };
-export const V2ThreadForkResponse__FileSystemSpecialPath = Schema.Union(
- [
- Schema.Struct({ kind: Schema.Literal("root") }).annotate({
- title: "RootFileSystemSpecialPath",
- }),
- Schema.Struct({ kind: Schema.Literal("minimal") }).annotate({
- title: "MinimalFileSystemSpecialPath",
- }),
- Schema.Struct({
- kind: Schema.Literal("project_roots"),
- subpath: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
- }).annotate({ title: "KindFileSystemSpecialPath" }),
- Schema.Struct({ kind: Schema.Literal("tmpdir") }).annotate({
- title: "TmpdirFileSystemSpecialPath",
- }),
- Schema.Struct({ kind: Schema.Literal("slash_tmp") }).annotate({
- title: "SlashTmpFileSystemSpecialPath",
- }),
- Schema.Struct({
- kind: Schema.Literal("unknown"),
- path: Schema.String,
- subpath: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
- }),
- ],
- { mode: "oneOf" },
-);
-
export type V2ThreadForkResponse__GitInfo = {
readonly branch?: string | null;
readonly originUrl?: string | null;
@@ -5884,6 +6272,14 @@ export const V2ThreadForkResponse__HookPromptFragment = Schema.Struct({
text: Schema.String,
});
+export type V2ThreadForkResponse__ImageDetail = "auto" | "low" | "high" | "original";
+export const V2ThreadForkResponse__ImageDetail = Schema.Literals([
+ "auto",
+ "low",
+ "high",
+ "original",
+]);
+
export type V2ThreadForkResponse__McpToolCallError = { readonly message: string };
export const V2ThreadForkResponse__McpToolCallError = Schema.Struct({ message: Schema.String });
@@ -5966,31 +6362,17 @@ export const V2ThreadForkResponse__PatchChangeKind = Schema.Union(
{ mode: "oneOf" },
);
-export type V2ThreadForkResponse__PermissionProfileNetworkPermissions = {
- readonly enabled: boolean;
-};
-export const V2ThreadForkResponse__PermissionProfileNetworkPermissions = Schema.Struct({
- enabled: Schema.Boolean,
-});
+export type V2ThreadForkResponse__ReasoningEffort = string;
+export const V2ThreadForkResponse__ReasoningEffort = Schema.String.annotate({
+ description: "A non-empty reasoning effort value advertised by the model.",
+}).check(Schema.isMinLength(1));
-export type V2ThreadForkResponse__ReasoningEffort =
- | "none"
- | "minimal"
- | "low"
- | "medium"
- | "high"
- | "xhigh";
-export const V2ThreadForkResponse__ReasoningEffort = Schema.Literals([
- "none",
- "minimal",
- "low",
- "medium",
- "high",
- "xhigh",
-]).annotate({
- description:
- "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning",
-});
+export type V2ThreadForkResponse__SubAgentActivityKind = "started" | "interacted" | "interrupted";
+export const V2ThreadForkResponse__SubAgentActivityKind = Schema.Literals([
+ "started",
+ "interacted",
+ "interrupted",
+]);
export type V2ThreadForkResponse__TextElement = {
readonly byteRange: { readonly end: number; readonly start: number };
@@ -6026,12 +6408,8 @@ export const V2ThreadForkResponse__ThreadActiveFlag = Schema.Literals([
export type V2ThreadForkResponse__ThreadId = string;
export const V2ThreadForkResponse__ThreadId = Schema.String;
-export type V2ThreadForkResponse__ThreadSource = "user" | "subagent" | "memory_consolidation";
-export const V2ThreadForkResponse__ThreadSource = Schema.Literals([
- "user",
- "subagent",
- "memory_consolidation",
-]);
+export type V2ThreadForkResponse__ThreadSource = string;
+export const V2ThreadForkResponse__ThreadSource = Schema.String;
export type V2ThreadForkResponse__TurnStatus =
| "completed"
@@ -6077,14 +6455,66 @@ export const V2ThreadForkResponse__WebSearchAction = Schema.Union(
{ mode: "oneOf" },
);
+export type V2ThreadGoalGetResponse__ThreadGoalStatus =
+ | "active"
+ | "paused"
+ | "blocked"
+ | "usageLimited"
+ | "budgetLimited"
+ | "complete";
+export const V2ThreadGoalGetResponse__ThreadGoalStatus = Schema.Literals([
+ "active",
+ "paused",
+ "blocked",
+ "usageLimited",
+ "budgetLimited",
+ "complete",
+]);
+
+export type V2ThreadGoalSetParams__ThreadGoalStatus =
+ | "active"
+ | "paused"
+ | "blocked"
+ | "usageLimited"
+ | "budgetLimited"
+ | "complete";
+export const V2ThreadGoalSetParams__ThreadGoalStatus = Schema.Literals([
+ "active",
+ "paused",
+ "blocked",
+ "usageLimited",
+ "budgetLimited",
+ "complete",
+]);
+
+export type V2ThreadGoalSetResponse__ThreadGoalStatus =
+ | "active"
+ | "paused"
+ | "blocked"
+ | "usageLimited"
+ | "budgetLimited"
+ | "complete";
+export const V2ThreadGoalSetResponse__ThreadGoalStatus = Schema.Literals([
+ "active",
+ "paused",
+ "blocked",
+ "usageLimited",
+ "budgetLimited",
+ "complete",
+]);
+
export type V2ThreadGoalUpdatedNotification__ThreadGoalStatus =
| "active"
| "paused"
+ | "blocked"
+ | "usageLimited"
| "budgetLimited"
| "complete";
export const V2ThreadGoalUpdatedNotification__ThreadGoalStatus = Schema.Literals([
"active",
"paused",
+ "blocked",
+ "usageLimited",
"budgetLimited",
"complete",
]);
@@ -6212,6 +6642,14 @@ export const V2ThreadListResponse__HookPromptFragment = Schema.Struct({
text: Schema.String,
});
+export type V2ThreadListResponse__ImageDetail = "auto" | "low" | "high" | "original";
+export const V2ThreadListResponse__ImageDetail = Schema.Literals([
+ "auto",
+ "low",
+ "high",
+ "original",
+]);
+
export type V2ThreadListResponse__McpToolCallError = { readonly message: string };
export const V2ThreadListResponse__McpToolCallError = Schema.Struct({ message: Schema.String });
@@ -6294,24 +6732,17 @@ export const V2ThreadListResponse__PatchChangeKind = Schema.Union(
{ mode: "oneOf" },
);
-export type V2ThreadListResponse__ReasoningEffort =
- | "none"
- | "minimal"
- | "low"
- | "medium"
- | "high"
- | "xhigh";
-export const V2ThreadListResponse__ReasoningEffort = Schema.Literals([
- "none",
- "minimal",
- "low",
- "medium",
- "high",
- "xhigh",
-]).annotate({
- description:
- "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning",
-});
+export type V2ThreadListResponse__ReasoningEffort = string;
+export const V2ThreadListResponse__ReasoningEffort = Schema.String.annotate({
+ description: "A non-empty reasoning effort value advertised by the model.",
+}).check(Schema.isMinLength(1));
+
+export type V2ThreadListResponse__SubAgentActivityKind = "started" | "interacted" | "interrupted";
+export const V2ThreadListResponse__SubAgentActivityKind = Schema.Literals([
+ "started",
+ "interacted",
+ "interrupted",
+]);
export type V2ThreadListResponse__TextElement = {
readonly byteRange: { readonly end: number; readonly start: number };
@@ -6347,12 +6778,8 @@ export const V2ThreadListResponse__ThreadActiveFlag = Schema.Literals([
export type V2ThreadListResponse__ThreadId = string;
export const V2ThreadListResponse__ThreadId = Schema.String;
-export type V2ThreadListResponse__ThreadSource = "user" | "subagent" | "memory_consolidation";
-export const V2ThreadListResponse__ThreadSource = Schema.Literals([
- "user",
- "subagent",
- "memory_consolidation",
-]);
+export type V2ThreadListResponse__ThreadSource = string;
+export const V2ThreadListResponse__ThreadSource = Schema.String;
export type V2ThreadListResponse__TurnStatus =
| "completed"
@@ -6523,6 +6950,14 @@ export const V2ThreadMetadataUpdateResponse__HookPromptFragment = Schema.Struct(
text: Schema.String,
});
+export type V2ThreadMetadataUpdateResponse__ImageDetail = "auto" | "low" | "high" | "original";
+export const V2ThreadMetadataUpdateResponse__ImageDetail = Schema.Literals([
+ "auto",
+ "low",
+ "high",
+ "original",
+]);
+
export type V2ThreadMetadataUpdateResponse__McpToolCallError = { readonly message: string };
export const V2ThreadMetadataUpdateResponse__McpToolCallError = Schema.Struct({
message: Schema.String,
@@ -6613,24 +7048,20 @@ export const V2ThreadMetadataUpdateResponse__PatchChangeKind = Schema.Union(
{ mode: "oneOf" },
);
-export type V2ThreadMetadataUpdateResponse__ReasoningEffort =
- | "none"
- | "minimal"
- | "low"
- | "medium"
- | "high"
- | "xhigh";
-export const V2ThreadMetadataUpdateResponse__ReasoningEffort = Schema.Literals([
- "none",
- "minimal",
- "low",
- "medium",
- "high",
- "xhigh",
-]).annotate({
- description:
- "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning",
-});
+export type V2ThreadMetadataUpdateResponse__ReasoningEffort = string;
+export const V2ThreadMetadataUpdateResponse__ReasoningEffort = Schema.String.annotate({
+ description: "A non-empty reasoning effort value advertised by the model.",
+}).check(Schema.isMinLength(1));
+
+export type V2ThreadMetadataUpdateResponse__SubAgentActivityKind =
+ | "started"
+ | "interacted"
+ | "interrupted";
+export const V2ThreadMetadataUpdateResponse__SubAgentActivityKind = Schema.Literals([
+ "started",
+ "interacted",
+ "interrupted",
+]);
export type V2ThreadMetadataUpdateResponse__TextElement = {
readonly byteRange: { readonly end: number; readonly start: number };
@@ -6668,15 +7099,8 @@ export const V2ThreadMetadataUpdateResponse__ThreadActiveFlag = Schema.Literals(
export type V2ThreadMetadataUpdateResponse__ThreadId = string;
export const V2ThreadMetadataUpdateResponse__ThreadId = Schema.String;
-export type V2ThreadMetadataUpdateResponse__ThreadSource =
- | "user"
- | "subagent"
- | "memory_consolidation";
-export const V2ThreadMetadataUpdateResponse__ThreadSource = Schema.Literals([
- "user",
- "subagent",
- "memory_consolidation",
-]);
+export type V2ThreadMetadataUpdateResponse__ThreadSource = string;
+export const V2ThreadMetadataUpdateResponse__ThreadSource = Schema.String;
export type V2ThreadMetadataUpdateResponse__TurnStatus =
| "completed"
@@ -6809,6 +7233,14 @@ export const V2ThreadReadResponse__HookPromptFragment = Schema.Struct({
text: Schema.String,
});
+export type V2ThreadReadResponse__ImageDetail = "auto" | "low" | "high" | "original";
+export const V2ThreadReadResponse__ImageDetail = Schema.Literals([
+ "auto",
+ "low",
+ "high",
+ "original",
+]);
+
export type V2ThreadReadResponse__McpToolCallError = { readonly message: string };
export const V2ThreadReadResponse__McpToolCallError = Schema.Struct({ message: Schema.String });
@@ -6891,24 +7323,17 @@ export const V2ThreadReadResponse__PatchChangeKind = Schema.Union(
{ mode: "oneOf" },
);
-export type V2ThreadReadResponse__ReasoningEffort =
- | "none"
- | "minimal"
- | "low"
- | "medium"
- | "high"
- | "xhigh";
-export const V2ThreadReadResponse__ReasoningEffort = Schema.Literals([
- "none",
- "minimal",
- "low",
- "medium",
- "high",
- "xhigh",
-]).annotate({
- description:
- "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning",
-});
+export type V2ThreadReadResponse__ReasoningEffort = string;
+export const V2ThreadReadResponse__ReasoningEffort = Schema.String.annotate({
+ description: "A non-empty reasoning effort value advertised by the model.",
+}).check(Schema.isMinLength(1));
+
+export type V2ThreadReadResponse__SubAgentActivityKind = "started" | "interacted" | "interrupted";
+export const V2ThreadReadResponse__SubAgentActivityKind = Schema.Literals([
+ "started",
+ "interacted",
+ "interrupted",
+]);
export type V2ThreadReadResponse__TextElement = {
readonly byteRange: { readonly end: number; readonly start: number };
@@ -6944,12 +7369,8 @@ export const V2ThreadReadResponse__ThreadActiveFlag = Schema.Literals([
export type V2ThreadReadResponse__ThreadId = string;
export const V2ThreadReadResponse__ThreadId = Schema.String;
-export type V2ThreadReadResponse__ThreadSource = "user" | "subagent" | "memory_consolidation";
-export const V2ThreadReadResponse__ThreadSource = Schema.Literals([
- "user",
- "subagent",
- "memory_consolidation",
-]);
+export type V2ThreadReadResponse__ThreadSource = string;
+export const V2ThreadReadResponse__ThreadSource = Schema.String;
export type V2ThreadReadResponse__TurnStatus =
| "completed"
@@ -7029,11 +7450,21 @@ export const V2ThreadRealtimeStartedNotification__RealtimeConversationVersion =
"v2",
]);
-export type V2ThreadResumeParams__AbsolutePathBuf = string;
-export const V2ThreadResumeParams__AbsolutePathBuf = Schema.String.annotate({
- description:
- "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.",
-});
+export type V2ThreadResumeParams__AgentMessageInputContent = {
+ readonly encrypted_content: string;
+ readonly type: "encrypted_content";
+};
+export const V2ThreadResumeParams__AgentMessageInputContent = Schema.Union(
+ [
+ Schema.Struct({
+ encrypted_content: Schema.String,
+ type: Schema.Literal("encrypted_content").annotate({
+ title: "EncryptedContentAgentMessageInputContentType",
+ }),
+ }).annotate({ title: "EncryptedContentAgentMessageInputContent" }),
+ ],
+ { mode: "oneOf" },
+);
export type V2ThreadResumeParams__ApprovalsReviewer = "user" | "auto_review" | "guardian_subagent";
export const V2ThreadResumeParams__ApprovalsReviewer = Schema.Literals([
@@ -7218,6 +7649,16 @@ export const V2ThreadResumeParams__SandboxMode = Schema.Literals([
"danger-full-access",
]);
+export type V2ThreadResumeParams__SortDirection = "asc" | "desc";
+export const V2ThreadResumeParams__SortDirection = Schema.Literals(["asc", "desc"]);
+
+export type V2ThreadResumeParams__TurnItemsView = "notLoaded" | "summary" | "full";
+export const V2ThreadResumeParams__TurnItemsView = Schema.Literals([
+ "notLoaded",
+ "summary",
+ "full",
+]);
+
export type V2ThreadResumeResponse__AbsolutePathBuf = string;
export const V2ThreadResumeResponse__AbsolutePathBuf = Schema.String.annotate({
description:
@@ -7315,47 +7756,6 @@ export const V2ThreadResumeResponse__DynamicToolCallStatus = Schema.Literals([
"failed",
]);
-export type V2ThreadResumeResponse__FileSystemAccessMode = "read" | "write" | "none";
-export const V2ThreadResumeResponse__FileSystemAccessMode = Schema.Literals([
- "read",
- "write",
- "none",
-]);
-
-export type V2ThreadResumeResponse__FileSystemSpecialPath =
- | { readonly kind: "root" }
- | { readonly kind: "minimal" }
- | { readonly kind: "project_roots"; readonly subpath?: string | null }
- | { readonly kind: "tmpdir" }
- | { readonly kind: "slash_tmp" }
- | { readonly kind: "unknown"; readonly path: string; readonly subpath?: string | null };
-export const V2ThreadResumeResponse__FileSystemSpecialPath = Schema.Union(
- [
- Schema.Struct({ kind: Schema.Literal("root") }).annotate({
- title: "RootFileSystemSpecialPath",
- }),
- Schema.Struct({ kind: Schema.Literal("minimal") }).annotate({
- title: "MinimalFileSystemSpecialPath",
- }),
- Schema.Struct({
- kind: Schema.Literal("project_roots"),
- subpath: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
- }).annotate({ title: "KindFileSystemSpecialPath" }),
- Schema.Struct({ kind: Schema.Literal("tmpdir") }).annotate({
- title: "TmpdirFileSystemSpecialPath",
- }),
- Schema.Struct({ kind: Schema.Literal("slash_tmp") }).annotate({
- title: "SlashTmpFileSystemSpecialPath",
- }),
- Schema.Struct({
- kind: Schema.Literal("unknown"),
- path: Schema.String,
- subpath: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
- }),
- ],
- { mode: "oneOf" },
-);
-
export type V2ThreadResumeResponse__GitInfo = {
readonly branch?: string | null;
readonly originUrl?: string | null;
@@ -7376,6 +7776,14 @@ export const V2ThreadResumeResponse__HookPromptFragment = Schema.Struct({
text: Schema.String,
});
+export type V2ThreadResumeResponse__ImageDetail = "auto" | "low" | "high" | "original";
+export const V2ThreadResumeResponse__ImageDetail = Schema.Literals([
+ "auto",
+ "low",
+ "high",
+ "original",
+]);
+
export type V2ThreadResumeResponse__McpToolCallError = { readonly message: string };
export const V2ThreadResumeResponse__McpToolCallError = Schema.Struct({ message: Schema.String });
@@ -7458,31 +7866,17 @@ export const V2ThreadResumeResponse__PatchChangeKind = Schema.Union(
{ mode: "oneOf" },
);
-export type V2ThreadResumeResponse__PermissionProfileNetworkPermissions = {
- readonly enabled: boolean;
-};
-export const V2ThreadResumeResponse__PermissionProfileNetworkPermissions = Schema.Struct({
- enabled: Schema.Boolean,
-});
+export type V2ThreadResumeResponse__ReasoningEffort = string;
+export const V2ThreadResumeResponse__ReasoningEffort = Schema.String.annotate({
+ description: "A non-empty reasoning effort value advertised by the model.",
+}).check(Schema.isMinLength(1));
-export type V2ThreadResumeResponse__ReasoningEffort =
- | "none"
- | "minimal"
- | "low"
- | "medium"
- | "high"
- | "xhigh";
-export const V2ThreadResumeResponse__ReasoningEffort = Schema.Literals([
- "none",
- "minimal",
- "low",
- "medium",
- "high",
- "xhigh",
-]).annotate({
- description:
- "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning",
-});
+export type V2ThreadResumeResponse__SubAgentActivityKind = "started" | "interacted" | "interrupted";
+export const V2ThreadResumeResponse__SubAgentActivityKind = Schema.Literals([
+ "started",
+ "interacted",
+ "interrupted",
+]);
export type V2ThreadResumeResponse__TextElement = {
readonly byteRange: { readonly end: number; readonly start: number };
@@ -7518,12 +7912,8 @@ export const V2ThreadResumeResponse__ThreadActiveFlag = Schema.Literals([
export type V2ThreadResumeResponse__ThreadId = string;
export const V2ThreadResumeResponse__ThreadId = Schema.String;
-export type V2ThreadResumeResponse__ThreadSource = "user" | "subagent" | "memory_consolidation";
-export const V2ThreadResumeResponse__ThreadSource = Schema.Literals([
- "user",
- "subagent",
- "memory_consolidation",
-]);
+export type V2ThreadResumeResponse__ThreadSource = string;
+export const V2ThreadResumeResponse__ThreadSource = Schema.String;
export type V2ThreadResumeResponse__TurnStatus =
| "completed"
@@ -7656,6 +8046,14 @@ export const V2ThreadRollbackResponse__HookPromptFragment = Schema.Struct({
text: Schema.String,
});
+export type V2ThreadRollbackResponse__ImageDetail = "auto" | "low" | "high" | "original";
+export const V2ThreadRollbackResponse__ImageDetail = Schema.Literals([
+ "auto",
+ "low",
+ "high",
+ "original",
+]);
+
export type V2ThreadRollbackResponse__McpToolCallError = { readonly message: string };
export const V2ThreadRollbackResponse__McpToolCallError = Schema.Struct({ message: Schema.String });
@@ -7741,24 +8139,20 @@ export const V2ThreadRollbackResponse__PatchChangeKind = Schema.Union(
{ mode: "oneOf" },
);
-export type V2ThreadRollbackResponse__ReasoningEffort =
- | "none"
- | "minimal"
- | "low"
- | "medium"
- | "high"
- | "xhigh";
-export const V2ThreadRollbackResponse__ReasoningEffort = Schema.Literals([
- "none",
- "minimal",
- "low",
- "medium",
- "high",
- "xhigh",
-]).annotate({
- description:
- "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning",
-});
+export type V2ThreadRollbackResponse__ReasoningEffort = string;
+export const V2ThreadRollbackResponse__ReasoningEffort = Schema.String.annotate({
+ description: "A non-empty reasoning effort value advertised by the model.",
+}).check(Schema.isMinLength(1));
+
+export type V2ThreadRollbackResponse__SubAgentActivityKind =
+ | "started"
+ | "interacted"
+ | "interrupted";
+export const V2ThreadRollbackResponse__SubAgentActivityKind = Schema.Literals([
+ "started",
+ "interacted",
+ "interrupted",
+]);
export type V2ThreadRollbackResponse__TextElement = {
readonly byteRange: { readonly end: number; readonly start: number };
@@ -7794,12 +8188,8 @@ export const V2ThreadRollbackResponse__ThreadActiveFlag = Schema.Literals([
export type V2ThreadRollbackResponse__ThreadId = string;
export const V2ThreadRollbackResponse__ThreadId = Schema.String;
-export type V2ThreadRollbackResponse__ThreadSource = "user" | "subagent" | "memory_consolidation";
-export const V2ThreadRollbackResponse__ThreadSource = Schema.Literals([
- "user",
- "subagent",
- "memory_consolidation",
-]);
+export type V2ThreadRollbackResponse__ThreadSource = string;
+export const V2ThreadRollbackResponse__ThreadSource = Schema.String;
export type V2ThreadRollbackResponse__TurnStatus =
| "completed"
@@ -7845,6 +8235,109 @@ export const V2ThreadRollbackResponse__WebSearchAction = Schema.Union(
{ mode: "oneOf" },
);
+export type V2ThreadSettingsUpdatedNotification__AbsolutePathBuf = string;
+export const V2ThreadSettingsUpdatedNotification__AbsolutePathBuf = Schema.String.annotate({
+ description:
+ "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.",
+});
+
+export type V2ThreadSettingsUpdatedNotification__ActivePermissionProfile = {
+ readonly extends?: string | null;
+ readonly id: string;
+};
+export const V2ThreadSettingsUpdatedNotification__ActivePermissionProfile = Schema.Struct({
+ extends: Schema.optionalKey(
+ Schema.Union([
+ Schema.String.annotate({
+ description:
+ "Parent profile identifier from the selected permissions profile's `extends` setting, when present.",
+ }),
+ Schema.Null,
+ ]),
+ ),
+ id: Schema.String.annotate({
+ description:
+ "Identifier from `default_permissions` or the implicit built-in default, such as `:workspace` or a user-defined `[permissions.<id>]` profile.",
+ }),
+});
+
+export type V2ThreadSettingsUpdatedNotification__ApprovalsReviewer =
+ | "user"
+ | "auto_review"
+ | "guardian_subagent";
+export const V2ThreadSettingsUpdatedNotification__ApprovalsReviewer = Schema.Literals([
+ "user",
+ "auto_review",
+ "guardian_subagent",
+]).annotate({
+ description:
+ "Configures who approval requests are routed to for review. Examples include sandbox escapes, blocked network access, MCP approval prompts, and ARC escalations. Defaults to `user`. `auto_review` uses a carefully prompted subagent to gather relevant context and apply a risk-based decision framework before approving or denying the request. The legacy value `guardian_subagent` is accepted for compatibility.",
+});
+
+export type V2ThreadSettingsUpdatedNotification__AskForApproval =
+ | "untrusted"
+ | "on-failure"
+ | "on-request"
+ | "never"
+ | {
+ readonly granular: {
+ readonly mcp_elicitations: boolean;
+ readonly request_permissions?: boolean;
+ readonly rules: boolean;
+ readonly sandbox_approval: boolean;
+ readonly skill_approval?: boolean;
+ };
+ };
+export const V2ThreadSettingsUpdatedNotification__AskForApproval = Schema.Union(
+ [
+ Schema.Literals(["untrusted", "on-failure", "on-request", "never"]),
+ Schema.Struct({
+ granular: Schema.Struct({
+ mcp_elicitations: Schema.Boolean,
+ request_permissions: Schema.optionalKey(Schema.Boolean.annotate({ default: false })),
+ rules: Schema.Boolean,
+ sandbox_approval: Schema.Boolean,
+ skill_approval: Schema.optionalKey(Schema.Boolean.annotate({ default: false })),
+ }),
+ }).annotate({ title: "GranularAskForApproval" }),
+ ],
+ { mode: "oneOf" },
+);
+
+export type V2ThreadSettingsUpdatedNotification__ModeKind = "plan" | "default";
+export const V2ThreadSettingsUpdatedNotification__ModeKind = Schema.Literals([
+ "plan",
+ "default",
+]).annotate({ description: "Initial collaboration mode to use when the TUI starts." });
+
+export type V2ThreadSettingsUpdatedNotification__Personality = "none" | "friendly" | "pragmatic";
+export const V2ThreadSettingsUpdatedNotification__Personality = Schema.Literals([
+ "none",
+ "friendly",
+ "pragmatic",
+]);
+
+export type V2ThreadSettingsUpdatedNotification__ReasoningEffort = string;
+export const V2ThreadSettingsUpdatedNotification__ReasoningEffort = Schema.String.annotate({
+ description: "A non-empty reasoning effort value advertised by the model.",
+}).check(Schema.isMinLength(1));
+
+export type V2ThreadSettingsUpdatedNotification__ReasoningSummary =
+ | "auto"
+ | "concise"
+ | "detailed"
+ | "none";
+export const V2ThreadSettingsUpdatedNotification__ReasoningSummary = Schema.Union(
+ [
+ Schema.Literals(["auto", "concise", "detailed"]),
+ Schema.Literal("none").annotate({ description: "Option to disable reasoning summaries." }),
+ ],
+ { mode: "oneOf" },
+).annotate({
+ description:
+ "A summary of the reasoning performed by the model. This can be useful for debugging and understanding the model's reasoning process. See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#reasoning-summaries",
+});
+
export type V2ThreadStartedNotification__AbsolutePathBuf = string;
export const V2ThreadStartedNotification__AbsolutePathBuf = Schema.String.annotate({
description:
@@ -7935,6 +8428,14 @@ export const V2ThreadStartedNotification__HookPromptFragment = Schema.Struct({
text: Schema.String,
});
+export type V2ThreadStartedNotification__ImageDetail = "auto" | "low" | "high" | "original";
+export const V2ThreadStartedNotification__ImageDetail = Schema.Literals([
+ "auto",
+ "low",
+ "high",
+ "original",
+]);
+
export type V2ThreadStartedNotification__McpToolCallError = { readonly message: string };
export const V2ThreadStartedNotification__McpToolCallError = Schema.Struct({
message: Schema.String,
@@ -8022,24 +8523,20 @@ export const V2ThreadStartedNotification__PatchChangeKind = Schema.Union(
{ mode: "oneOf" },
);
-export type V2ThreadStartedNotification__ReasoningEffort =
- | "none"
- | "minimal"
- | "low"
- | "medium"
- | "high"
- | "xhigh";
-export const V2ThreadStartedNotification__ReasoningEffort = Schema.Literals([
- "none",
- "minimal",
- "low",
- "medium",
- "high",
- "xhigh",
-]).annotate({
- description:
- "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning",
-});
+export type V2ThreadStartedNotification__ReasoningEffort = string;
+export const V2ThreadStartedNotification__ReasoningEffort = Schema.String.annotate({
+ description: "A non-empty reasoning effort value advertised by the model.",
+}).check(Schema.isMinLength(1));
+
+export type V2ThreadStartedNotification__SubAgentActivityKind =
+ | "started"
+ | "interacted"
+ | "interrupted";
+export const V2ThreadStartedNotification__SubAgentActivityKind = Schema.Literals([
+ "started",
+ "interacted",
+ "interrupted",
+]);
export type V2ThreadStartedNotification__TextElement = {
readonly byteRange: { readonly end: number; readonly start: number };
@@ -8077,15 +8574,8 @@ export const V2ThreadStartedNotification__ThreadActiveFlag = Schema.Literals([
export type V2ThreadStartedNotification__ThreadId = string;
export const V2ThreadStartedNotification__ThreadId = Schema.String;
-export type V2ThreadStartedNotification__ThreadSource =
- | "user"
- | "subagent"
- | "memory_consolidation";
-export const V2ThreadStartedNotification__ThreadSource = Schema.Literals([
- "user",
- "subagent",
- "memory_consolidation",
-]);
+export type V2ThreadStartedNotification__ThreadSource = string;
+export const V2ThreadStartedNotification__ThreadSource = Schema.String;
export type V2ThreadStartedNotification__TurnStatus =
| "completed"
@@ -8190,12 +8680,8 @@ export const V2ThreadStartParams__SandboxMode = Schema.Literals([
"danger-full-access",
]);
-export type V2ThreadStartParams__ThreadSource = "user" | "subagent" | "memory_consolidation";
-export const V2ThreadStartParams__ThreadSource = Schema.Literals([
- "user",
- "subagent",
- "memory_consolidation",
-]);
+export type V2ThreadStartParams__ThreadSource = string;
+export const V2ThreadStartParams__ThreadSource = Schema.String;
export type V2ThreadStartParams__ThreadStartSource = "startup" | "clear";
export const V2ThreadStartParams__ThreadStartSource = Schema.Literals(["startup", "clear"]);
@@ -8297,47 +8783,6 @@ export const V2ThreadStartResponse__DynamicToolCallStatus = Schema.Literals([
"failed",
]);
-export type V2ThreadStartResponse__FileSystemAccessMode = "read" | "write" | "none";
-export const V2ThreadStartResponse__FileSystemAccessMode = Schema.Literals([
- "read",
- "write",
- "none",
-]);
-
-export type V2ThreadStartResponse__FileSystemSpecialPath =
- | { readonly kind: "root" }
- | { readonly kind: "minimal" }
- | { readonly kind: "project_roots"; readonly subpath?: string | null }
- | { readonly kind: "tmpdir" }
- | { readonly kind: "slash_tmp" }
- | { readonly kind: "unknown"; readonly path: string; readonly subpath?: string | null };
-export const V2ThreadStartResponse__FileSystemSpecialPath = Schema.Union(
- [
- Schema.Struct({ kind: Schema.Literal("root") }).annotate({
- title: "RootFileSystemSpecialPath",
- }),
- Schema.Struct({ kind: Schema.Literal("minimal") }).annotate({
- title: "MinimalFileSystemSpecialPath",
- }),
- Schema.Struct({
- kind: Schema.Literal("project_roots"),
- subpath: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
- }).annotate({ title: "KindFileSystemSpecialPath" }),
- Schema.Struct({ kind: Schema.Literal("tmpdir") }).annotate({
- title: "TmpdirFileSystemSpecialPath",
- }),
- Schema.Struct({ kind: Schema.Literal("slash_tmp") }).annotate({
- title: "SlashTmpFileSystemSpecialPath",
- }),
- Schema.Struct({
- kind: Schema.Literal("unknown"),
- path: Schema.String,
- subpath: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
- }),
- ],
- { mode: "oneOf" },
-);
-
export type V2ThreadStartResponse__GitInfo = {
readonly branch?: string | null;
readonly originUrl?: string | null;
@@ -8358,6 +8803,14 @@ export const V2ThreadStartResponse__HookPromptFragment = Schema.Struct({
text: Schema.String,
});
+export type V2ThreadStartResponse__ImageDetail = "auto" | "low" | "high" | "original";
+export const V2ThreadStartResponse__ImageDetail = Schema.Literals([
+ "auto",
+ "low",
+ "high",
+ "original",
+]);
+
export type V2ThreadStartResponse__McpToolCallError = { readonly message: string };
export const V2ThreadStartResponse__McpToolCallError = Schema.Struct({ message: Schema.String });
@@ -8440,31 +8893,17 @@ export const V2ThreadStartResponse__PatchChangeKind = Schema.Union(
{ mode: "oneOf" },
);
-export type V2ThreadStartResponse__PermissionProfileNetworkPermissions = {
- readonly enabled: boolean;
-};
-export const V2ThreadStartResponse__PermissionProfileNetworkPermissions = Schema.Struct({
- enabled: Schema.Boolean,
-});
+export type V2ThreadStartResponse__ReasoningEffort = string;
+export const V2ThreadStartResponse__ReasoningEffort = Schema.String.annotate({
+ description: "A non-empty reasoning effort value advertised by the model.",
+}).check(Schema.isMinLength(1));
-export type V2ThreadStartResponse__ReasoningEffort =
- | "none"
- | "minimal"
- | "low"
- | "medium"
- | "high"
- | "xhigh";
-export const V2ThreadStartResponse__ReasoningEffort = Schema.Literals([
- "none",
- "minimal",
- "low",
- "medium",
- "high",
- "xhigh",
-]).annotate({
- description:
- "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning",
-});
+export type V2ThreadStartResponse__SubAgentActivityKind = "started" | "interacted" | "interrupted";
+export const V2ThreadStartResponse__SubAgentActivityKind = Schema.Literals([
+ "started",
+ "interacted",
+ "interrupted",
+]);
export type V2ThreadStartResponse__TextElement = {
readonly byteRange: { readonly end: number; readonly start: number };
@@ -8500,12 +8939,8 @@ export const V2ThreadStartResponse__ThreadActiveFlag = Schema.Literals([
export type V2ThreadStartResponse__ThreadId = string;
export const V2ThreadStartResponse__ThreadId = Schema.String;
-export type V2ThreadStartResponse__ThreadSource = "user" | "subagent" | "memory_consolidation";
-export const V2ThreadStartResponse__ThreadSource = Schema.Literals([
- "user",
- "subagent",
- "memory_consolidation",
-]);
+export type V2ThreadStartResponse__ThreadSource = string;
+export const V2ThreadStartResponse__ThreadSource = Schema.String;
export type V2ThreadStartResponse__TurnStatus =
| "completed"
@@ -8664,6 +9099,14 @@ export const V2ThreadUnarchiveResponse__HookPromptFragment = Schema.Struct({
text: Schema.String,
});
+export type V2ThreadUnarchiveResponse__ImageDetail = "auto" | "low" | "high" | "original";
+export const V2ThreadUnarchiveResponse__ImageDetail = Schema.Literals([
+ "auto",
+ "low",
+ "high",
+ "original",
+]);
+
export type V2ThreadUnarchiveResponse__McpToolCallError = { readonly message: string };
export const V2ThreadUnarchiveResponse__McpToolCallError = Schema.Struct({
message: Schema.String,
@@ -8751,24 +9194,20 @@ export const V2ThreadUnarchiveResponse__PatchChangeKind = Schema.Union(
{ mode: "oneOf" },
);
-export type V2ThreadUnarchiveResponse__ReasoningEffort =
- | "none"
- | "minimal"
- | "low"
- | "medium"
- | "high"
- | "xhigh";
-export const V2ThreadUnarchiveResponse__ReasoningEffort = Schema.Literals([
- "none",
- "minimal",
- "low",
- "medium",
- "high",
- "xhigh",
-]).annotate({
- description:
- "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning",
-});
+export type V2ThreadUnarchiveResponse__ReasoningEffort = string;
+export const V2ThreadUnarchiveResponse__ReasoningEffort = Schema.String.annotate({
+ description: "A non-empty reasoning effort value advertised by the model.",
+}).check(Schema.isMinLength(1));
+
+export type V2ThreadUnarchiveResponse__SubAgentActivityKind =
+ | "started"
+ | "interacted"
+ | "interrupted";
+export const V2ThreadUnarchiveResponse__SubAgentActivityKind = Schema.Literals([
+ "started",
+ "interacted",
+ "interrupted",
+]);
export type V2ThreadUnarchiveResponse__TextElement = {
readonly byteRange: { readonly end: number; readonly start: number };
@@ -8806,12 +9245,8 @@ export const V2ThreadUnarchiveResponse__ThreadActiveFlag = Schema.Literals([
export type V2ThreadUnarchiveResponse__ThreadId = string;
export const V2ThreadUnarchiveResponse__ThreadId = Schema.String;
-export type V2ThreadUnarchiveResponse__ThreadSource = "user" | "subagent" | "memory_consolidation";
-export const V2ThreadUnarchiveResponse__ThreadSource = Schema.Literals([
- "user",
- "subagent",
- "memory_consolidation",
-]);
+export type V2ThreadUnarchiveResponse__ThreadSource = string;
+export const V2ThreadUnarchiveResponse__ThreadSource = Schema.String;
export type V2ThreadUnarchiveResponse__TurnStatus =
| "completed"
@@ -8943,6 +9378,14 @@ export const V2TurnCompletedNotification__HookPromptFragment = Schema.Struct({
text: Schema.String,
});
+export type V2TurnCompletedNotification__ImageDetail = "auto" | "low" | "high" | "original";
+export const V2TurnCompletedNotification__ImageDetail = Schema.Literals([
+ "auto",
+ "low",
+ "high",
+ "original",
+]);
+
export type V2TurnCompletedNotification__McpToolCallError = { readonly message: string };
export const V2TurnCompletedNotification__McpToolCallError = Schema.Struct({
message: Schema.String,
@@ -9030,24 +9473,20 @@ export const V2TurnCompletedNotification__PatchChangeKind = Schema.Union(
{ mode: "oneOf" },
);
-export type V2TurnCompletedNotification__ReasoningEffort =
- | "none"
- | "minimal"
- | "low"
- | "medium"
- | "high"
- | "xhigh";
-export const V2TurnCompletedNotification__ReasoningEffort = Schema.Literals([
- "none",
- "minimal",
- "low",
- "medium",
- "high",
- "xhigh",
-]).annotate({
- description:
- "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning",
-});
+export type V2TurnCompletedNotification__ReasoningEffort = string;
+export const V2TurnCompletedNotification__ReasoningEffort = Schema.String.annotate({
+ description: "A non-empty reasoning effort value advertised by the model.",
+}).check(Schema.isMinLength(1));
+
+export type V2TurnCompletedNotification__SubAgentActivityKind =
+ | "started"
+ | "interacted"
+ | "interrupted";
+export const V2TurnCompletedNotification__SubAgentActivityKind = Schema.Literals([
+ "started",
+ "interacted",
+ "interrupted",
+]);
export type V2TurnCompletedNotification__TextElement = {
readonly byteRange: { readonly end: number; readonly start: number };
@@ -9204,6 +9643,14 @@ export const V2TurnStartedNotification__HookPromptFragment = Schema.Struct({
text: Schema.String,
});
+export type V2TurnStartedNotification__ImageDetail = "auto" | "low" | "high" | "original";
+export const V2TurnStartedNotification__ImageDetail = Schema.Literals([
+ "auto",
+ "low",
+ "high",
+ "original",
+]);
+
export type V2TurnStartedNotification__McpToolCallError = { readonly message: string };
export const V2TurnStartedNotification__McpToolCallError = Schema.Struct({
message: Schema.String,
@@ -9291,24 +9738,20 @@ export const V2TurnStartedNotification__PatchChangeKind = Schema.Union(
{ mode: "oneOf" },
);
-export type V2TurnStartedNotification__ReasoningEffort =
- | "none"
- | "minimal"
- | "low"
- | "medium"
- | "high"
- | "xhigh";
-export const V2TurnStartedNotification__ReasoningEffort = Schema.Literals([
- "none",
- "minimal",
- "low",
- "medium",
- "high",
- "xhigh",
-]).annotate({
- description:
- "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning",
-});
+export type V2TurnStartedNotification__ReasoningEffort = string;
+export const V2TurnStartedNotification__ReasoningEffort = Schema.String.annotate({
+ description: "A non-empty reasoning effort value advertised by the model.",
+}).check(Schema.isMinLength(1));
+
+export type V2TurnStartedNotification__SubAgentActivityKind =
+ | "started"
+ | "interacted"
+ | "interrupted";
+export const V2TurnStartedNotification__SubAgentActivityKind = Schema.Literals([
+ "started",
+ "interacted",
+ "interrupted",
+]);
export type V2TurnStartedNotification__TextElement = {
readonly byteRange: { readonly end: number; readonly start: number };
@@ -9385,6 +9828,12 @@ export const V2TurnStartParams__AbsolutePathBuf = Schema.String.annotate({
"A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.",
});
+export type V2TurnStartParams__AdditionalContextKind = "untrusted" | "application";
+export const V2TurnStartParams__AdditionalContextKind = Schema.Literals([
+ "untrusted",
+ "application",
+]);
+
export type V2TurnStartParams__ApprovalsReviewer = "user" | "auto_review" | "guardian_subagent";
export const V2TurnStartParams__ApprovalsReviewer = Schema.Literals([
"user",
@@ -9425,6 +9874,9 @@ export const V2TurnStartParams__AskForApproval = Schema.Union(
{ mode: "oneOf" },
);
+export type V2TurnStartParams__ImageDetail = "auto" | "low" | "high" | "original";
+export const V2TurnStartParams__ImageDetail = Schema.Literals(["auto", "low", "high", "original"]);
+
export type V2TurnStartParams__ModeKind = "plan" | "default";
export const V2TurnStartParams__ModeKind = Schema.Literals(["plan", "default"]).annotate({
description: "Initial collaboration mode to use when the TUI starts.",
@@ -9433,24 +9885,10 @@ export const V2TurnStartParams__ModeKind = Schema.Literals(["plan", "default"]).
export type V2TurnStartParams__Personality = "none" | "friendly" | "pragmatic";
export const V2TurnStartParams__Personality = Schema.Literals(["none", "friendly", "pragmatic"]);
-export type V2TurnStartParams__ReasoningEffort =
- | "none"
- | "minimal"
- | "low"
- | "medium"
- | "high"
- | "xhigh";
-export const V2TurnStartParams__ReasoningEffort = Schema.Literals([
- "none",
- "minimal",
- "low",
- "medium",
- "high",
- "xhigh",
-]).annotate({
- description:
- "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning",
-});
+export type V2TurnStartParams__ReasoningEffort = string;
+export const V2TurnStartParams__ReasoningEffort = Schema.String.annotate({
+ description: "A non-empty reasoning effort value advertised by the model.",
+}).check(Schema.isMinLength(1));
export type V2TurnStartParams__ReasoningSummary = "auto" | "concise" | "detailed" | "none";
export const V2TurnStartParams__ReasoningSummary = Schema.Union(
@@ -9562,6 +10000,14 @@ export const V2TurnStartResponse__HookPromptFragment = Schema.Struct({
text: Schema.String,
});
+export type V2TurnStartResponse__ImageDetail = "auto" | "low" | "high" | "original";
+export const V2TurnStartResponse__ImageDetail = Schema.Literals([
+ "auto",
+ "low",
+ "high",
+ "original",
+]);
+
export type V2TurnStartResponse__McpToolCallError = { readonly message: string };
export const V2TurnStartResponse__McpToolCallError = Schema.Struct({ message: Schema.String });
@@ -9644,24 +10090,17 @@ export const V2TurnStartResponse__PatchChangeKind = Schema.Union(
{ mode: "oneOf" },
);
-export type V2TurnStartResponse__ReasoningEffort =
- | "none"
- | "minimal"
- | "low"
- | "medium"
- | "high"
- | "xhigh";
-export const V2TurnStartResponse__ReasoningEffort = Schema.Literals([
- "none",
- "minimal",
- "low",
- "medium",
- "high",
- "xhigh",
-]).annotate({
- description:
- "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning",
-});
+export type V2TurnStartResponse__ReasoningEffort = string;
+export const V2TurnStartResponse__ReasoningEffort = Schema.String.annotate({
+ description: "A non-empty reasoning effort value advertised by the model.",
+}).check(Schema.isMinLength(1));
+
+export type V2TurnStartResponse__SubAgentActivityKind = "started" | "interacted" | "interrupted";
+export const V2TurnStartResponse__SubAgentActivityKind = Schema.Literals([
+ "started",
+ "interacted",
+ "interrupted",
+]);
export type V2TurnStartResponse__TextElement = {
readonly byteRange: { readonly end: number; readonly start: number };
@@ -9728,6 +10167,15 @@ export const V2TurnStartResponse__WebSearchAction = Schema.Union(
{ mode: "oneOf" },
);
+export type V2TurnSteerParams__AdditionalContextKind = "untrusted" | "application";
+export const V2TurnSteerParams__AdditionalContextKind = Schema.Literals([
+ "untrusted",
+ "application",
+]);
+
+export type V2TurnSteerParams__ImageDetail = "auto" | "low" | "high" | "original";
+export const V2TurnSteerParams__ImageDetail = Schema.Literals(["auto", "low", "high", "original"]);
+
export type V2TurnSteerParams__TextElement = {
readonly byteRange: { readonly end: number; readonly start: number };
readonly placeholder?: string | null;
@@ -9792,25 +10240,6 @@ export const ApplyPatchApprovalResponse__NetworkPolicyAmendment = Schema.Struct(
host: Schema.String,
});
-export type ClientRequest__PermissionProfileModificationParams = {
- readonly path: ClientRequest__AbsolutePathBuf;
- readonly type: "additionalWritableRoot";
-};
-export const ClientRequest__PermissionProfileModificationParams = Schema.Union(
- [
- Schema.Struct({
- path: ClientRequest__AbsolutePathBuf,
- type: Schema.Literal("additionalWritableRoot").annotate({
- title: "AdditionalWritableRootPermissionProfileModificationParamsType",
- }),
- }).annotate({
- title: "AdditionalWritableRootPermissionProfileModificationParams",
- description: "Additional concrete directory that should be writable.",
- }),
- ],
- { mode: "oneOf" },
-);
-
export type ClientRequest__PluginInstallParams = {
readonly marketplacePath?: ClientRequest__AbsolutePathBuf | null;
readonly pluginName: string;
@@ -9822,6 +10251,30 @@ export const ClientRequest__PluginInstallParams = Schema.Struct({
remoteMarketplaceName: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
});
+export type ClientRequest__PluginInstalledParams = {
+ readonly cwds?: ReadonlyArray<ClientRequest__AbsolutePathBuf> | null;
+ readonly installSuggestionPluginNames?: ReadonlyArray<string> | null;
+};
+export const ClientRequest__PluginInstalledParams = Schema.Struct({
+ cwds: Schema.optionalKey(
+ Schema.Union([
+ Schema.Array(ClientRequest__AbsolutePathBuf).annotate({
+ description: "Optional working directories used to discover repo marketplaces.",
+ }),
+ Schema.Null,
+ ]),
+ ),
+ installSuggestionPluginNames: Schema.optionalKey(
+ Schema.Union([
+ Schema.Array(Schema.String).annotate({
+ description:
+ "Additional uninstalled plugin names that should be returned when present locally. This is used by mention surfaces that intentionally expose install entrypoints.",
+ }),
+ Schema.Null,
+ ]),
+ ),
+});
+
export type ClientRequest__PluginReadParams = {
readonly marketplacePath?: ClientRequest__AbsolutePathBuf | null;
readonly pluginName: string;
@@ -9893,6 +10346,13 @@ export const ClientRequest__SkillsConfigWriteParams = Schema.Struct({
),
});
+export type ClientRequest__SkillsExtraRootsSetParams = {
+ readonly extraRoots: ReadonlyArray<ClientRequest__AbsolutePathBuf>;
+};
+export const ClientRequest__SkillsExtraRootsSetParams = Schema.Struct({
+ extraRoots: Schema.Array(ClientRequest__AbsolutePathBuf),
+});
+
export type ClientRequest__SendAddCreditsNudgeEmailParams = {
readonly creditType: ClientRequest__AddCreditsNudgeCreditType;
};
@@ -9900,28 +10360,6 @@ export const ClientRequest__SendAddCreditsNudgeEmailParams = Schema.Struct({
creditType: ClientRequest__AddCreditsNudgeCreditType,
});
-export type ClientRequest__FileSystemPath =
- | { readonly path: ClientRequest__AbsolutePathBuf; readonly type: "path" }
- | { readonly pattern: string; readonly type: "glob_pattern" }
- | { readonly type: "special"; readonly value: ClientRequest__FileSystemSpecialPath };
-export const ClientRequest__FileSystemPath = Schema.Union(
- [
- Schema.Struct({
- path: ClientRequest__AbsolutePathBuf,
- type: Schema.Literal("path").annotate({ title: "PathFileSystemPathType" }),
- }).annotate({ title: "PathFileSystemPath" }),
- Schema.Struct({
- pattern: Schema.String,
- type: Schema.Literal("glob_pattern").annotate({ title: "GlobPatternFileSystemPathType" }),
- }).annotate({ title: "GlobPatternFileSystemPath" }),
- Schema.Struct({
- type: Schema.Literal("special").annotate({ title: "SpecialFileSystemPathType" }),
- value: ClientRequest__FileSystemSpecialPath,
- }).annotate({ title: "SpecialFileSystemPath" }),
- ],
- { mode: "oneOf" },
-);
-
export type ClientRequest__ContentItem =
| { readonly text: string; readonly type: "input_text" }
| {
@@ -9955,7 +10393,8 @@ export type ClientRequest__FunctionCallOutputContentItem =
readonly detail?: ClientRequest__ImageDetail | null;
readonly image_url: string;
readonly type: "input_image";
- };
+ }
+ | { readonly encrypted_content: string; readonly type: "encrypted_content" };
export const ClientRequest__FunctionCallOutputContentItem = Schema.Union(
[
Schema.Struct({
@@ -9971,6 +10410,12 @@ export const ClientRequest__FunctionCallOutputContentItem = Schema.Union(
title: "InputImageFunctionCallOutputContentItemType",
}),
}).annotate({ title: "InputImageFunctionCallOutputContentItem" }),
+ Schema.Struct({
+ encrypted_content: Schema.String,
+ type: Schema.Literal("encrypted_content").annotate({
+ title: "EncryptedContentFunctionCallOutputContentItemType",
+ }),
+ }).annotate({ title: "EncryptedContentFunctionCallOutputContentItem" }),
],
{ mode: "oneOf" },
).annotate({
@@ -9993,6 +10438,7 @@ export type ClientRequest__ListMcpServerStatusParams = {
readonly cursor?: string | null;
readonly detail?: ClientRequest__McpServerStatusDetail | null;
readonly limit?: number | null;
+ readonly threadId?: string | null;
};
export const ClientRequest__ListMcpServerStatusParams = Schema.Struct({
cursor: Schema.optionalKey(
@@ -10020,6 +10466,7 @@ export const ClientRequest__ListMcpServerStatusParams = Schema.Struct({
Schema.Null,
]),
),
+ threadId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
});
export type ClientRequest__ConfigEdit = {
@@ -10084,10 +10531,12 @@ export const ClientRequest__PluginListParams = Schema.Struct({
export type ClientRequest__PluginShareTarget = {
readonly principalId: string;
readonly principalType: ClientRequest__PluginSharePrincipalType;
+ readonly role: ClientRequest__PluginShareTargetRole;
};
export const ClientRequest__PluginShareTarget = Schema.Struct({
principalId: Schema.String,
principalType: ClientRequest__PluginSharePrincipalType,
+ role: ClientRequest__PluginShareTargetRole,
});
export type ClientRequest__Settings = {
@@ -10160,33 +10609,7 @@ export const ClientRequest__ThreadResumeParams = Schema.Struct({
threadId: Schema.String,
}).annotate({
description:
- "There are three ways to resume a thread: 1. By thread_id: load the thread from disk by thread_id and resume it. 2. By history: instantiate the thread from memory and resume it. 3. By path: load the thread from disk by path and resume it.\n\nThe precedence is: history > path > thread_id. If using history or path, the thread_id param will be ignored.\n\nPrefer using thread_id whenever possible.",
-});
-
-export type ClientRequest__SkillsListParams = {
- readonly cwds?: ReadonlyArray<string>;
- readonly forceReload?: boolean;
- readonly perCwdExtraUserRoots?: ReadonlyArray<ClientRequest__SkillsListExtraRootsForCwd> | null;
-};
-export const ClientRequest__SkillsListParams = Schema.Struct({
- cwds: Schema.optionalKey(
- Schema.Array(Schema.String).annotate({
- description: "When empty, defaults to the current session working directory.",
- }),
- ),
- forceReload: Schema.optionalKey(
- Schema.Boolean.annotate({
- description: "When true, bypass the skills cache and re-scan skills from disk.",
- }),
- ),
- perCwdExtraUserRoots: Schema.optionalKey(
- Schema.Union([
- Schema.Array(ClientRequest__SkillsListExtraRootsForCwd).annotate({
- description: "Optional per-cwd extra roots to scan as user-scoped skills.",
- }),
- Schema.Null,
- ]),
- ),
+ "There are three ways to resume a thread: 1. By thread_id: load the thread from disk by thread_id and resume it. 2. By history: instantiate the thread from memory and resume it. 3. By path: load the thread from disk by path and resume it.\n\nFor non-running threads, the precedence is: history > non-empty path > thread_id. If using history or a non-empty path for a non-running thread, the thread_id param will be ignored.\n\nIf thread_id identifies a running thread, app-server rejoins that thread and treats a non-empty path as a consistency check against the active rollout path. Empty string path values are treated as absent.\n\nPrefer using thread_id whenever possible.",
});
export type ClientRequest__MigrationDetails = {
@@ -10222,8 +10645,16 @@ export type ClientRequest__UserInput =
readonly text_elements?: ReadonlyArray<ClientRequest__TextElement>;
readonly type: "text";
}
- | { readonly type: "image"; readonly url: string }
- | { readonly path: string; readonly type: "localImage" }
+ | {
+ readonly detail?: ClientRequest__ImageDetail | null;
+ readonly type: "image";
+ readonly url: string;
+ }
+ | {
+ readonly detail?: ClientRequest__ImageDetail | null;
+ readonly path: string;
+ readonly type: "localImage";
+ }
| { readonly name: string; readonly path: string; readonly type: "skill" }
| { readonly name: string; readonly path: string; readonly type: "mention" };
export const ClientRequest__UserInput = Schema.Union(
@@ -10239,10 +10670,12 @@ export const ClientRequest__UserInput = Schema.Union(
type: Schema.Literal("text").annotate({ title: "TextUserInputType" }),
}).annotate({ title: "TextUserInput" }),
Schema.Struct({
+ detail: Schema.optionalKey(Schema.Union([ClientRequest__ImageDetail, Schema.Null])),
type: Schema.Literal("image").annotate({ title: "ImageUserInputType" }),
url: Schema.String,
}).annotate({ title: "ImageUserInput" }),
Schema.Struct({
+ detail: Schema.optionalKey(Schema.Union([ClientRequest__ImageDetail, Schema.Null])),
path: Schema.String,
type: Schema.Literal("localImage").annotate({ title: "LocalImageUserInputType" }),
}).annotate({ title: "LocalImageUserInput" }),
@@ -10260,6 +10693,21 @@ export const ClientRequest__UserInput = Schema.Union(
{ mode: "oneOf" },
);
+export type ClientRequest__ThreadGoalSetParams = {
+ readonly objective?: string | null;
+ readonly status?: ClientRequest__ThreadGoalStatus | null;
+ readonly threadId: string;
+ readonly tokenBudget?: number | null;
+};
+export const ClientRequest__ThreadGoalSetParams = Schema.Struct({
+ objective: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ status: Schema.optionalKey(Schema.Union([ClientRequest__ThreadGoalStatus, Schema.Null])),
+ threadId: Schema.String,
+ tokenBudget: Schema.optionalKey(
+ Schema.Union([Schema.Number.annotate({ format: "int64" }).check(Schema.isInt()), Schema.Null]),
+ ),
+});
+
export type ClientRequest__ThreadMetadataUpdateParams = {
readonly gitInfo?: ClientRequest__ThreadMetadataGitInfoUpdateParams | null;
readonly threadId: string;
@@ -10324,7 +10772,7 @@ export const ClientRequest__ThreadForkParams = Schema.Struct({
),
}).annotate({
description:
- "There are two ways to fork a thread: 1. By thread_id: load the thread from disk by thread_id and fork it into a new thread. 2. By path: load the thread from disk by path and fork it into a new thread.\n\nIf using path, the thread_id param will be ignored.\n\nPrefer using thread_id whenever possible.",
+ "There are two ways to fork a thread: 1. By thread_id: load the thread from disk by thread_id and fork it into a new thread. 2. By path: load the thread from disk by path and fork it into a new thread.\n\nIf using a non-empty path, the thread_id param will be ignored. Empty string path values are treated as absent.\n\nPrefer using thread_id whenever possible.",
});
export type ClientRequest__ThreadListParams = {
@@ -10920,6 +11368,49 @@ export const ServerNotification__FsChangedNotification = Schema.Struct({
}),
}).annotate({ description: "Filesystem watch notification emitted for `fs/watch` subscribers." });
+export type ServerNotification__SandboxPolicy =
+ | { readonly type: "dangerFullAccess" }
+ | { readonly networkAccess?: boolean; readonly type: "readOnly" }
+ | { readonly networkAccess?: "restricted" | "enabled"; readonly type: "externalSandbox" }
+ | {
+ readonly excludeSlashTmp?: boolean;
+ readonly excludeTmpdirEnvVar?: boolean;
+ readonly networkAccess?: boolean;
+ readonly type: "workspaceWrite";
+ readonly writableRoots?: ReadonlyArray<ServerNotification__AbsolutePathBuf>;
+ };
+export const ServerNotification__SandboxPolicy = Schema.Union(
+ [
+ Schema.Struct({
+ type: Schema.Literal("dangerFullAccess").annotate({
+ title: "DangerFullAccessSandboxPolicyType",
+ }),
+ }).annotate({ title: "DangerFullAccessSandboxPolicy" }),
+ Schema.Struct({
+ networkAccess: Schema.optionalKey(Schema.Boolean.annotate({ default: false })),
+ type: Schema.Literal("readOnly").annotate({ title: "ReadOnlySandboxPolicyType" }),
+ }).annotate({ title: "ReadOnlySandboxPolicy" }),
+ Schema.Struct({
+ networkAccess: Schema.optionalKey(
+ Schema.Literals(["restricted", "enabled"]).annotate({ default: "restricted" }),
+ ),
+ type: Schema.Literal("externalSandbox").annotate({
+ title: "ExternalSandboxSandboxPolicyType",
+ }),
+ }).annotate({ title: "ExternalSandboxSandboxPolicy" }),
+ Schema.Struct({
+ excludeSlashTmp: Schema.optionalKey(Schema.Boolean.annotate({ default: false })),
+ excludeTmpdirEnvVar: Schema.optionalKey(Schema.Boolean.annotate({ default: false })),
+ networkAccess: Schema.optionalKey(Schema.Boolean.annotate({ default: false })),
+ type: Schema.Literal("workspaceWrite").annotate({ title: "WorkspaceWriteSandboxPolicyType" }),
+ writableRoots: Schema.optionalKey(
+ Schema.Array(ServerNotification__AbsolutePathBuf).annotate({ default: [] }),
+ ),
+ }).annotate({ title: "WorkspaceWriteSandboxPolicy" }),
+ ],
+ { mode: "oneOf" },
+);
+
export type ServerNotification__AppMetadata = {
readonly categories?: ReadonlyArray<string> | null;
readonly developer?: string | null;
@@ -11041,11 +11532,13 @@ export type ServerNotification__McpServerStatusUpdatedNotification = {
readonly error?: string | null;
readonly name: string;
readonly status: ServerNotification__McpServerStartupState;
+ readonly threadId?: string | null;
};
export const ServerNotification__McpServerStatusUpdatedNotification = Schema.Struct({
error: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
name: Schema.String,
status: ServerNotification__McpServerStartupState,
+ threadId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
});
export type ServerNotification__MemoryCitation = {
@@ -11209,27 +11702,6 @@ export const ServerNotification__AccountUpdatedNotification = Schema.Struct({
planType: Schema.optionalKey(Schema.Union([ServerNotification__PlanType, Schema.Null])),
});
-export type ServerNotification__RateLimitSnapshot = {
- readonly credits?: ServerNotification__CreditsSnapshot | null;
- readonly limitId?: string | null;
- readonly limitName?: string | null;
- readonly planType?: ServerNotification__PlanType | null;
- readonly primary?: ServerNotification__RateLimitWindow | null;
- readonly rateLimitReachedType?: ServerNotification__RateLimitReachedType | null;
- readonly secondary?: ServerNotification__RateLimitWindow | null;
-};
-export const ServerNotification__RateLimitSnapshot = Schema.Struct({
- credits: Schema.optionalKey(Schema.Union([ServerNotification__CreditsSnapshot, Schema.Null])),
- limitId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
- limitName: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
- planType: Schema.optionalKey(Schema.Union([ServerNotification__PlanType, Schema.Null])),
- primary: Schema.optionalKey(Schema.Union([ServerNotification__RateLimitWindow, Schema.Null])),
- rateLimitReachedType: Schema.optionalKey(
- Schema.Union([ServerNotification__RateLimitReachedType, Schema.Null]),
- ),
- secondary: Schema.optionalKey(Schema.Union([ServerNotification__RateLimitWindow, Schema.Null])),
-});
-
export type ServerNotification__ThreadRealtimeStartedNotification = {
readonly realtimeSessionId?: string | null;
readonly threadId: string;
@@ -11241,15 +11713,32 @@ export const ServerNotification__ThreadRealtimeStartedNotification = Schema.Stru
version: ServerNotification__RealtimeConversationVersion,
}).annotate({ description: "EXPERIMENTAL - emitted when thread realtime startup is accepted." });
+export type ServerNotification__Settings = {
+ readonly developer_instructions?: string | null;
+ readonly model: string;
+ readonly reasoning_effort?: ServerNotification__ReasoningEffort | null;
+};
+export const ServerNotification__Settings = Schema.Struct({
+ developer_instructions: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ model: Schema.String,
+ reasoning_effort: Schema.optionalKey(
+ Schema.Union([ServerNotification__ReasoningEffort, Schema.Null]),
+ ),
+}).annotate({ description: "Settings for a collaboration mode." });
+
export type ServerNotification__RemoteControlStatusChangedNotification = {
readonly environmentId?: string | null;
+ readonly installationId: string;
+ readonly serverName: string;
readonly status: ServerNotification__RemoteControlConnectionStatus;
};
export const ServerNotification__RemoteControlStatusChangedNotification = Schema.Struct({
environmentId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ installationId: Schema.String,
+ serverName: Schema.String,
status: ServerNotification__RemoteControlConnectionStatus,
}).annotate({
- description: "Current remote-control connection status and environment id exposed to clients.",
+ description: "Current remote-control connection status and remote identity exposed to clients.",
});
export type ServerNotification__ServerRequestResolvedNotification = {
@@ -11261,14 +11750,47 @@ export const ServerNotification__ServerRequestResolvedNotification = Schema.Stru
threadId: Schema.String,
});
+export type ServerNotification__RateLimitSnapshot = {
+ readonly credits?: ServerNotification__CreditsSnapshot | null;
+ readonly individualLimit?: ServerNotification__SpendControlLimitSnapshot | null;
+ readonly limitId?: string | null;
+ readonly limitName?: string | null;
+ readonly planType?: ServerNotification__PlanType | null;
+ readonly primary?: ServerNotification__RateLimitWindow | null;
+ readonly rateLimitReachedType?: ServerNotification__RateLimitReachedType | null;
+ readonly secondary?: ServerNotification__RateLimitWindow | null;
+};
+export const ServerNotification__RateLimitSnapshot = Schema.Struct({
+ credits: Schema.optionalKey(Schema.Union([ServerNotification__CreditsSnapshot, Schema.Null])),
+ individualLimit: Schema.optionalKey(
+ Schema.Union([ServerNotification__SpendControlLimitSnapshot, Schema.Null]),
+ ),
+ limitId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ limitName: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ planType: Schema.optionalKey(Schema.Union([ServerNotification__PlanType, Schema.Null])),
+ primary: Schema.optionalKey(Schema.Union([ServerNotification__RateLimitWindow, Schema.Null])),
+ rateLimitReachedType: Schema.optionalKey(
+ Schema.Union([ServerNotification__RateLimitReachedType, Schema.Null]),
+ ),
+ secondary: Schema.optionalKey(Schema.Union([ServerNotification__RateLimitWindow, Schema.Null])),
+});
+
export type ServerNotification__UserInput =
| {
readonly text: string;
readonly text_elements?: ReadonlyArray<ServerNotification__TextElement>;
readonly type: "text";
}
- | { readonly type: "image"; readonly url: string }
- | { readonly path: string; readonly type: "localImage" }
+ | {
+ readonly detail?: ServerNotification__ImageDetail | null;
+ readonly type: "image";
+ readonly url: string;
+ }
+ | {
+ readonly detail?: ServerNotification__ImageDetail | null;
+ readonly path: string;
+ readonly type: "localImage";
+ }
| { readonly name: string; readonly path: string; readonly type: "skill" }
| { readonly name: string; readonly path: string; readonly type: "mention" };
export const ServerNotification__UserInput = Schema.Union(
@@ -11284,10 +11806,12 @@ export const ServerNotification__UserInput = Schema.Union(
type: Schema.Literal("text").annotate({ title: "TextUserInputType" }),
}).annotate({ title: "TextUserInput" }),
Schema.Struct({
+ detail: Schema.optionalKey(Schema.Union([ServerNotification__ImageDetail, Schema.Null])),
type: Schema.Literal("image").annotate({ title: "ImageUserInputType" }),
url: Schema.String,
}).annotate({ title: "ImageUserInput" }),
Schema.Struct({
+ detail: Schema.optionalKey(Schema.Union([ServerNotification__ImageDetail, Schema.Null])),
path: Schema.String,
type: Schema.Literal("localImage").annotate({ title: "LocalImageUserInputType" }),
}).annotate({ title: "LocalImageUserInput" }),
@@ -11786,6 +12310,7 @@ export const ToolRequestUserInputParams__ToolRequestUserInputQuestion = Schema.S
export type V2AccountRateLimitsUpdatedNotification__RateLimitSnapshot = {
readonly credits?: V2AccountRateLimitsUpdatedNotification__CreditsSnapshot | null;
+ readonly individualLimit?: V2AccountRateLimitsUpdatedNotification__SpendControlLimitSnapshot | null;
readonly limitId?: string | null;
readonly limitName?: string | null;
readonly planType?: V2AccountRateLimitsUpdatedNotification__PlanType | null;
@@ -11797,6 +12322,9 @@ export const V2AccountRateLimitsUpdatedNotification__RateLimitSnapshot = Schema.
credits: Schema.optionalKey(
Schema.Union([V2AccountRateLimitsUpdatedNotification__CreditsSnapshot, Schema.Null]),
),
+ individualLimit: Schema.optionalKey(
+ Schema.Union([V2AccountRateLimitsUpdatedNotification__SpendControlLimitSnapshot, Schema.Null]),
+ ),
limitId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
limitName: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
planType: Schema.optionalKey(
@@ -11918,28 +12446,6 @@ export const V2CommandExecParams__SandboxPolicy = Schema.Union(
{ mode: "oneOf" },
);
-export type V2CommandExecParams__FileSystemPath =
- | { readonly path: V2CommandExecParams__AbsolutePathBuf; readonly type: "path" }
- | { readonly pattern: string; readonly type: "glob_pattern" }
- | { readonly type: "special"; readonly value: V2CommandExecParams__FileSystemSpecialPath };
-export const V2CommandExecParams__FileSystemPath = Schema.Union(
- [
- Schema.Struct({
- path: V2CommandExecParams__AbsolutePathBuf,
- type: Schema.Literal("path").annotate({ title: "PathFileSystemPathType" }),
- }).annotate({ title: "PathFileSystemPath" }),
- Schema.Struct({
- pattern: Schema.String,
- type: Schema.Literal("glob_pattern").annotate({ title: "GlobPatternFileSystemPathType" }),
- }).annotate({ title: "GlobPatternFileSystemPath" }),
- Schema.Struct({
- type: Schema.Literal("special").annotate({ title: "SpecialFileSystemPathType" }),
- value: V2CommandExecParams__FileSystemSpecialPath,
- }).annotate({ title: "SpecialFileSystemPath" }),
- ],
- { mode: "oneOf" },
-);
-
export type V2ConfigBatchWriteParams__ConfigEdit = {
readonly keyPath: string;
readonly mergeStrategy: V2ConfigBatchWriteParams__MergeStrategy;
@@ -11954,7 +12460,8 @@ export const V2ConfigBatchWriteParams__ConfigEdit = Schema.Struct({
export type V2ConfigReadResponse__ConfigLayerSource =
| { readonly domain: string; readonly key: string; readonly type: "mdm" }
| { readonly file: string; readonly type: "system" }
- | { readonly file: string; readonly type: "user" }
+ | { readonly id: string; readonly name: string; readonly type: "enterpriseManaged" }
+ | { readonly file: string; readonly profile?: string | null; readonly type: "user" }
| { readonly dotCodexFolder: V2ConfigReadResponse__AbsolutePathBuf; readonly type: "project" }
| { readonly type: "sessionFlags" }
| {
@@ -11982,11 +12489,33 @@ export const V2ConfigReadResponse__ConfigLayerSource = Schema.Union(
title: "SystemConfigLayerSource",
description: "Managed config layer from a file (usually `managed_config.toml`).",
}),
+ Schema.Struct({
+ id: Schema.String.annotate({ description: "Stable identifier for the delivered layer." }),
+ name: Schema.String.annotate({
+ description:
+ "Admin-facing name for the delivered layer. This is surfaced in diagnostics so users know which cloud layer needs administrator attention.",
+ }),
+ type: Schema.Literal("enterpriseManaged").annotate({
+ title: "EnterpriseManagedConfigLayerSourceType",
+ }),
+ }).annotate({
+ title: "EnterpriseManagedConfigLayerSource",
+ description: "Enterprise-managed config layer delivered by the cloud config bundle.",
+ }),
Schema.Struct({
file: Schema.String.annotate({
description:
"A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.",
}),
+ profile: Schema.optionalKey(
+ Schema.Union([
+ Schema.String.annotate({
+ description:
+ "Name of the selected profile-v2 config layered on top of the base user config, when this layer represents one.",
+ }),
+ Schema.Null,
+ ]),
+ ),
type: Schema.Literal("user").annotate({ title: "UserConfigLayerSourceType" }),
}).annotate({
title: "UserConfigLayerSource",
@@ -12051,22 +12580,43 @@ export const V2ConfigRequirementsReadResponse__ConfiguredHookMatcherGroup = Sche
});
export type V2ConfigRequirementsReadResponse__ConfigRequirements = {
+ readonly allowAppshots?: boolean | null;
+ readonly allowManagedHooksOnly?: boolean | null;
readonly allowedApprovalPolicies?: ReadonlyArray<V2ConfigRequirementsReadResponse__AskForApproval> | null;
+ readonly allowedPermissionProfiles?: { readonly [x: string]: boolean } | null;
readonly allowedSandboxModes?: ReadonlyArray<V2ConfigRequirementsReadResponse__SandboxMode> | null;
readonly allowedWebSearchModes?: ReadonlyArray<V2ConfigRequirementsReadResponse__WebSearchMode> | null;
+ readonly allowedWindowsSandboxImplementations?: ReadonlyArray<V2ConfigRequirementsReadResponse__WindowsSandboxSetupMode> | null;
+ readonly computerUse?: V2ConfigRequirementsReadResponse__ComputerUseRequirements | null;
+ readonly defaultPermissions?: string | null;
readonly enforceResidency?: V2ConfigRequirementsReadResponse__ResidencyRequirement | null;
readonly featureRequirements?: { readonly [x: string]: boolean } | null;
};
export const V2ConfigRequirementsReadResponse__ConfigRequirements = Schema.Struct({
+ allowAppshots: Schema.optionalKey(Schema.Union([Schema.Boolean, Schema.Null])),
+ allowManagedHooksOnly: Schema.optionalKey(Schema.Union([Schema.Boolean, Schema.Null])),
allowedApprovalPolicies: Schema.optionalKey(
Schema.Union([Schema.Array(V2ConfigRequirementsReadResponse__AskForApproval), Schema.Null]),
),
+ allowedPermissionProfiles: Schema.optionalKey(
+ Schema.Union([Schema.Record(Schema.String, Schema.Boolean), Schema.Null]),
+ ),
allowedSandboxModes: Schema.optionalKey(
Schema.Union([Schema.Array(V2ConfigRequirementsReadResponse__SandboxMode), Schema.Null]),
),
allowedWebSearchModes: Schema.optionalKey(
Schema.Union([Schema.Array(V2ConfigRequirementsReadResponse__WebSearchMode), Schema.Null]),
),
+ allowedWindowsSandboxImplementations: Schema.optionalKey(
+ Schema.Union([
+ Schema.Array(V2ConfigRequirementsReadResponse__WindowsSandboxSetupMode),
+ Schema.Null,
+ ]),
+ ),
+ computerUse: Schema.optionalKey(
+ Schema.Union([V2ConfigRequirementsReadResponse__ComputerUseRequirements, Schema.Null]),
+ ),
+ defaultPermissions: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
enforceResidency: Schema.optionalKey(
Schema.Union([V2ConfigRequirementsReadResponse__ResidencyRequirement, Schema.Null]),
),
@@ -12087,7 +12637,8 @@ export const V2ConfigWarningNotification__TextRange = Schema.Struct({
export type V2ConfigWriteResponse__ConfigLayerSource =
| { readonly domain: string; readonly key: string; readonly type: "mdm" }
| { readonly file: string; readonly type: "system" }
- | { readonly file: string; readonly type: "user" }
+ | { readonly id: string; readonly name: string; readonly type: "enterpriseManaged" }
+ | { readonly file: string; readonly profile?: string | null; readonly type: "user" }
| { readonly dotCodexFolder: V2ConfigWriteResponse__AbsolutePathBuf; readonly type: "project" }
| { readonly type: "sessionFlags" }
| {
@@ -12115,11 +12666,33 @@ export const V2ConfigWriteResponse__ConfigLayerSource = Schema.Union(
title: "SystemConfigLayerSource",
description: "Managed config layer from a file (usually `managed_config.toml`).",
}),
+ Schema.Struct({
+ id: Schema.String.annotate({ description: "Stable identifier for the delivered layer." }),
+ name: Schema.String.annotate({
+ description:
+ "Admin-facing name for the delivered layer. This is surfaced in diagnostics so users know which cloud layer needs administrator attention.",
+ }),
+ type: Schema.Literal("enterpriseManaged").annotate({
+ title: "EnterpriseManagedConfigLayerSourceType",
+ }),
+ }).annotate({
+ title: "EnterpriseManagedConfigLayerSource",
+ description: "Enterprise-managed config layer delivered by the cloud config bundle.",
+ }),
Schema.Struct({
file: Schema.String.annotate({
description:
"A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.",
}),
+ profile: Schema.optionalKey(
+ Schema.Union([
+ Schema.String.annotate({
+ description:
+ "Name of the selected profile-v2 config layered on top of the base user config, when this layer represents one.",
+ }),
+ Schema.Null,
+ ]),
+ ),
type: Schema.Literal("user").annotate({ title: "UserConfigLayerSourceType" }),
}).annotate({
title: "UserConfigLayerSource",
@@ -12338,6 +12911,7 @@ export const V2FileChangePatchUpdatedNotification__FileUpdateChange = Schema.Str
export type V2GetAccountRateLimitsResponse__RateLimitSnapshot = {
readonly credits?: V2GetAccountRateLimitsResponse__CreditsSnapshot | null;
+ readonly individualLimit?: V2GetAccountRateLimitsResponse__SpendControlLimitSnapshot | null;
readonly limitId?: string | null;
readonly limitName?: string | null;
readonly planType?: V2GetAccountRateLimitsResponse__PlanType | null;
@@ -12349,6 +12923,9 @@ export const V2GetAccountRateLimitsResponse__RateLimitSnapshot = Schema.Struct({
credits: Schema.optionalKey(
Schema.Union([V2GetAccountRateLimitsResponse__CreditsSnapshot, Schema.Null]),
),
+ individualLimit: Schema.optionalKey(
+ Schema.Union([V2GetAccountRateLimitsResponse__SpendControlLimitSnapshot, Schema.Null]),
+ ),
limitId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
limitName: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
planType: Schema.optionalKey(
@@ -12522,8 +13099,16 @@ export type V2ItemCompletedNotification__UserInput =
readonly text_elements?: ReadonlyArray<V2ItemCompletedNotification__TextElement>;
readonly type: "text";
}
- | { readonly type: "image"; readonly url: string }
- | { readonly path: string; readonly type: "localImage" }
+ | {
+ readonly detail?: V2ItemCompletedNotification__ImageDetail | null;
+ readonly type: "image";
+ readonly url: string;
+ }
+ | {
+ readonly detail?: V2ItemCompletedNotification__ImageDetail | null;
+ readonly path: string;
+ readonly type: "localImage";
+ }
| { readonly name: string; readonly path: string; readonly type: "skill" }
| { readonly name: string; readonly path: string; readonly type: "mention" };
export const V2ItemCompletedNotification__UserInput = Schema.Union(
@@ -12539,10 +13124,16 @@ export const V2ItemCompletedNotification__UserInput = Schema.Union(
type: Schema.Literal("text").annotate({ title: "TextUserInputType" }),
}).annotate({ title: "TextUserInput" }),
Schema.Struct({
+ detail: Schema.optionalKey(
+ Schema.Union([V2ItemCompletedNotification__ImageDetail, Schema.Null]),
+ ),
type: Schema.Literal("image").annotate({ title: "ImageUserInputType" }),
url: Schema.String,
}).annotate({ title: "ImageUserInput" }),
Schema.Struct({
+ detail: Schema.optionalKey(
+ Schema.Union([V2ItemCompletedNotification__ImageDetail, Schema.Null]),
+ ),
path: Schema.String,
type: Schema.Literal("localImage").annotate({ title: "LocalImageUserInputType" }),
}).annotate({ title: "LocalImageUserInput" }),
@@ -12747,8 +13338,16 @@ export type V2ItemStartedNotification__UserInput =
readonly text_elements?: ReadonlyArray<V2ItemStartedNotification__TextElement>;
readonly type: "text";
}
- | { readonly type: "image"; readonly url: string }
- | { readonly path: string; readonly type: "localImage" }
+ | {
+ readonly detail?: V2ItemStartedNotification__ImageDetail | null;
+ readonly type: "image";
+ readonly url: string;
+ }
+ | {
+ readonly detail?: V2ItemStartedNotification__ImageDetail | null;
+ readonly path: string;
+ readonly type: "localImage";
+ }
| { readonly name: string; readonly path: string; readonly type: "skill" }
| { readonly name: string; readonly path: string; readonly type: "mention" };
export const V2ItemStartedNotification__UserInput = Schema.Union(
@@ -12764,10 +13363,16 @@ export const V2ItemStartedNotification__UserInput = Schema.Union(
type: Schema.Literal("text").annotate({ title: "TextUserInputType" }),
}).annotate({ title: "TextUserInput" }),
Schema.Struct({
+ detail: Schema.optionalKey(
+ Schema.Union([V2ItemStartedNotification__ImageDetail, Schema.Null]),
+ ),
type: Schema.Literal("image").annotate({ title: "ImageUserInputType" }),
url: Schema.String,
}).annotate({ title: "ImageUserInput" }),
Schema.Struct({
+ detail: Schema.optionalKey(
+ Schema.Union([V2ItemStartedNotification__ImageDetail, Schema.Null]),
+ ),
path: Schema.String,
type: Schema.Literal("localImage").annotate({ title: "LocalImageUserInputType" }),
}).annotate({ title: "LocalImageUserInput" }),
@@ -12790,6 +13395,7 @@ export type V2ListMcpServerStatusResponse__McpServerStatus = {
readonly name: string;
readonly resourceTemplates: ReadonlyArray<V2ListMcpServerStatusResponse__ResourceTemplate>;
readonly resources: ReadonlyArray<V2ListMcpServerStatusResponse__Resource>;
+ readonly serverInfo?: V2ListMcpServerStatusResponse__McpServerInfo | null;
readonly tools: { readonly [x: string]: V2ListMcpServerStatusResponse__Tool };
};
export const V2ListMcpServerStatusResponse__McpServerStatus = Schema.Struct({
@@ -12797,6 +13403,9 @@ export const V2ListMcpServerStatusResponse__McpServerStatus = Schema.Struct({
name: Schema.String,
resourceTemplates: Schema.Array(V2ListMcpServerStatusResponse__ResourceTemplate),
resources: Schema.Array(V2ListMcpServerStatusResponse__Resource),
+ serverInfo: Schema.optionalKey(
+ Schema.Union([V2ListMcpServerStatusResponse__McpServerInfo, Schema.Null]),
+ ),
tools: Schema.Record(Schema.String, V2ListMcpServerStatusResponse__Tool),
});
@@ -12809,40 +13418,40 @@ export const V2ModelListResponse__ReasoningEffortOption = Schema.Struct({
reasoningEffort: V2ModelListResponse__ReasoningEffort,
});
-export type V2PluginListResponse__MarketplaceLoadErrorInfo = {
- readonly marketplacePath: V2PluginListResponse__AbsolutePathBuf;
+export type V2PluginInstalledResponse__MarketplaceLoadErrorInfo = {
+ readonly marketplacePath: V2PluginInstalledResponse__AbsolutePathBuf;
readonly message: string;
};
-export const V2PluginListResponse__MarketplaceLoadErrorInfo = Schema.Struct({
- marketplacePath: V2PluginListResponse__AbsolutePathBuf,
+export const V2PluginInstalledResponse__MarketplaceLoadErrorInfo = Schema.Struct({
+ marketplacePath: V2PluginInstalledResponse__AbsolutePathBuf,
message: Schema.String,
});
-export type V2PluginListResponse__PluginInterface = {
+export type V2PluginInstalledResponse__PluginInterface = {
readonly brandColor?: string | null;
readonly capabilities: ReadonlyArray<string>;
readonly category?: string | null;
- readonly composerIcon?: V2PluginListResponse__AbsolutePathBuf | null;
+ readonly composerIcon?: V2PluginInstalledResponse__AbsolutePathBuf | null;
readonly composerIconUrl?: string | null;
readonly defaultPrompt?: ReadonlyArray<string> | null;
readonly developerName?: string | null;
readonly displayName?: string | null;
- readonly logo?: V2PluginListResponse__AbsolutePathBuf | null;
+ readonly logo?: V2PluginInstalledResponse__AbsolutePathBuf | null;
readonly logoUrl?: string | null;
readonly longDescription?: string | null;
readonly privacyPolicyUrl?: string | null;
readonly screenshotUrls: ReadonlyArray<string>;
- readonly screenshots: ReadonlyArray<V2PluginListResponse__AbsolutePathBuf>;
+ readonly screenshots: ReadonlyArray<V2PluginInstalledResponse__AbsolutePathBuf>;
readonly shortDescription?: string | null;
readonly termsOfServiceUrl?: string | null;
readonly websiteUrl?: string | null;
};
-export const V2PluginListResponse__PluginInterface = Schema.Struct({
+export const V2PluginInstalledResponse__PluginInterface = Schema.Struct({
brandColor: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
capabilities: Schema.Array(Schema.String),
category: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
composerIcon: Schema.optionalKey(
- Schema.Union([V2PluginListResponse__AbsolutePathBuf, Schema.Null]).annotate({
+ Schema.Union([V2PluginInstalledResponse__AbsolutePathBuf, Schema.Null]).annotate({
description: "Local composer icon path, resolved from the installed plugin package.",
}),
),
@@ -12864,7 +13473,7 @@ export const V2PluginListResponse__PluginInterface = Schema.Struct({
developerName: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
displayName: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
logo: Schema.optionalKey(
- Schema.Union([V2PluginListResponse__AbsolutePathBuf, Schema.Null]).annotate({
+ Schema.Union([V2PluginInstalledResponse__AbsolutePathBuf, Schema.Null]).annotate({
description: "Local logo path, resolved from the installed plugin package.",
}),
),
@@ -12879,7 +13488,7 @@ export const V2PluginListResponse__PluginInterface = Schema.Struct({
screenshotUrls: Schema.Array(Schema.String).annotate({
description: "Remote screenshot URLs from the plugin catalog.",
}),
- screenshots: Schema.Array(V2PluginListResponse__AbsolutePathBuf).annotate({
+ screenshots: Schema.Array(V2PluginInstalledResponse__AbsolutePathBuf).annotate({
description: "Local screenshot paths, resolved from the installed plugin package.",
}),
shortDescription: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
@@ -12887,8 +13496,8 @@ export const V2PluginListResponse__PluginInterface = Schema.Struct({
websiteUrl: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
});
-export type V2PluginListResponse__PluginSource =
- | { readonly path: V2PluginListResponse__AbsolutePathBuf; readonly type: "local" }
+export type V2PluginInstalledResponse__PluginSource =
+ | { readonly path: V2PluginInstalledResponse__AbsolutePathBuf; readonly type: "local" }
| {
readonly path?: string | null;
readonly refName?: string | null;
@@ -12897,10 +13506,10 @@ export type V2PluginListResponse__PluginSource =
readonly url: string;
}
| { readonly type: "remote" };
-export const V2PluginListResponse__PluginSource = Schema.Union(
+export const V2PluginInstalledResponse__PluginSource = Schema.Union(
[
Schema.Struct({
- path: V2PluginListResponse__AbsolutePathBuf,
+ path: V2PluginInstalledResponse__AbsolutePathBuf,
type: Schema.Literal("local").annotate({ title: "LocalPluginSourceType" }),
}).annotate({ title: "LocalPluginSource" }),
Schema.Struct({
@@ -12921,42 +13530,53 @@ export const V2PluginListResponse__PluginSource = Schema.Union(
{ mode: "oneOf" },
);
-export type V2PluginListResponse__PluginSharePrincipal = {
+export type V2PluginInstalledResponse__PluginSharePrincipal = {
readonly name: string;
readonly principalId: string;
- readonly principalType: V2PluginListResponse__PluginSharePrincipalType;
+ readonly principalType: V2PluginInstalledResponse__PluginSharePrincipalType;
+ readonly role: V2PluginInstalledResponse__PluginSharePrincipalRole;
};
-export const V2PluginListResponse__PluginSharePrincipal = Schema.Struct({
+export const V2PluginInstalledResponse__PluginSharePrincipal = Schema.Struct({
name: Schema.String,
principalId: Schema.String,
- principalType: V2PluginListResponse__PluginSharePrincipalType,
+ principalType: V2PluginInstalledResponse__PluginSharePrincipalType,
+ role: V2PluginInstalledResponse__PluginSharePrincipalRole,
});
-export type V2PluginReadResponse__PluginInterface = {
+export type V2PluginListResponse__MarketplaceLoadErrorInfo = {
+ readonly marketplacePath: V2PluginListResponse__AbsolutePathBuf;
+ readonly message: string;
+};
+export const V2PluginListResponse__MarketplaceLoadErrorInfo = Schema.Struct({
+ marketplacePath: V2PluginListResponse__AbsolutePathBuf,
+ message: Schema.String,
+});
+
+export type V2PluginListResponse__PluginInterface = {
readonly brandColor?: string | null;
readonly capabilities: ReadonlyArray<string>;
readonly category?: string | null;
- readonly composerIcon?: V2PluginReadResponse__AbsolutePathBuf | null;
+ readonly composerIcon?: V2PluginListResponse__AbsolutePathBuf | null;
readonly composerIconUrl?: string | null;
readonly defaultPrompt?: ReadonlyArray<string> | null;
readonly developerName?: string | null;
readonly displayName?: string | null;
- readonly logo?: V2PluginReadResponse__AbsolutePathBuf | null;
+ readonly logo?: V2PluginListResponse__AbsolutePathBuf | null;
readonly logoUrl?: string | null;
readonly longDescription?: string | null;
readonly privacyPolicyUrl?: string | null;
readonly screenshotUrls: ReadonlyArray<string>;
- readonly screenshots: ReadonlyArray<V2PluginReadResponse__AbsolutePathBuf>;
+ readonly screenshots: ReadonlyArray<V2PluginListResponse__AbsolutePathBuf>;
readonly shortDescription?: string | null;
readonly termsOfServiceUrl?: string | null;
readonly websiteUrl?: string | null;
};
-export const V2PluginReadResponse__PluginInterface = Schema.Struct({
+export const V2PluginListResponse__PluginInterface = Schema.Struct({
brandColor: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
capabilities: Schema.Array(Schema.String),
category: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
composerIcon: Schema.optionalKey(
- Schema.Union([V2PluginReadResponse__AbsolutePathBuf, Schema.Null]).annotate({
+ Schema.Union([V2PluginListResponse__AbsolutePathBuf, Schema.Null]).annotate({
description: "Local composer icon path, resolved from the installed plugin package.",
}),
),
@@ -12978,7 +13598,7 @@ export const V2PluginReadResponse__PluginInterface = Schema.Struct({
developerName: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
displayName: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
logo: Schema.optionalKey(
- Schema.Union([V2PluginReadResponse__AbsolutePathBuf, Schema.Null]).annotate({
+ Schema.Union([V2PluginListResponse__AbsolutePathBuf, Schema.Null]).annotate({
description: "Local logo path, resolved from the installed plugin package.",
}),
),
@@ -12993,7 +13613,7 @@ export const V2PluginReadResponse__PluginInterface = Schema.Struct({
screenshotUrls: Schema.Array(Schema.String).annotate({
description: "Remote screenshot URLs from the plugin catalog.",
}),
- screenshots: Schema.Array(V2PluginReadResponse__AbsolutePathBuf).annotate({
+ screenshots: Schema.Array(V2PluginListResponse__AbsolutePathBuf).annotate({
description: "Local screenshot paths, resolved from the installed plugin package.",
}),
shortDescription: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
@@ -13001,8 +13621,8 @@ export const V2PluginReadResponse__PluginInterface = Schema.Struct({
websiteUrl: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
});
-export type V2PluginReadResponse__PluginSource =
- | { readonly path: V2PluginReadResponse__AbsolutePathBuf; readonly type: "local" }
+export type V2PluginListResponse__PluginSource =
+ | { readonly path: V2PluginListResponse__AbsolutePathBuf; readonly type: "local" }
| {
readonly path?: string | null;
readonly refName?: string | null;
@@ -13011,10 +13631,10 @@ export type V2PluginReadResponse__PluginSource =
readonly url: string;
}
| { readonly type: "remote" };
-export const V2PluginReadResponse__PluginSource = Schema.Union(
+export const V2PluginListResponse__PluginSource = Schema.Union(
[
Schema.Struct({
- path: V2PluginReadResponse__AbsolutePathBuf,
+ path: V2PluginListResponse__AbsolutePathBuf,
type: Schema.Literal("local").annotate({ title: "LocalPluginSourceType" }),
}).annotate({ title: "LocalPluginSource" }),
Schema.Struct({
@@ -13035,68 +13655,209 @@ export const V2PluginReadResponse__PluginSource = Schema.Union(
{ mode: "oneOf" },
);
-export type V2PluginReadResponse__SkillInterface = {
- readonly brandColor?: string | null;
- readonly defaultPrompt?: string | null;
- readonly displayName?: string | null;
- readonly iconLarge?: V2PluginReadResponse__AbsolutePathBuf | null;
- readonly iconSmall?: V2PluginReadResponse__AbsolutePathBuf | null;
- readonly shortDescription?: string | null;
-};
-export const V2PluginReadResponse__SkillInterface = Schema.Struct({
- brandColor: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
- defaultPrompt: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
- displayName: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
- iconLarge: Schema.optionalKey(Schema.Union([V2PluginReadResponse__AbsolutePathBuf, Schema.Null])),
- iconSmall: Schema.optionalKey(Schema.Union([V2PluginReadResponse__AbsolutePathBuf, Schema.Null])),
- shortDescription: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
-});
-
-export type V2PluginReadResponse__PluginHookSummary = {
- readonly eventName: V2PluginReadResponse__HookEventName;
- readonly key: string;
-};
-export const V2PluginReadResponse__PluginHookSummary = Schema.Struct({
- eventName: V2PluginReadResponse__HookEventName,
- key: Schema.String,
-});
-
-export type V2PluginReadResponse__PluginSharePrincipal = {
+export type V2PluginListResponse__PluginSharePrincipal = {
readonly name: string;
readonly principalId: string;
- readonly principalType: V2PluginReadResponse__PluginSharePrincipalType;
+ readonly principalType: V2PluginListResponse__PluginSharePrincipalType;
+ readonly role: V2PluginListResponse__PluginSharePrincipalRole;
};
-export const V2PluginReadResponse__PluginSharePrincipal = Schema.Struct({
+export const V2PluginListResponse__PluginSharePrincipal = Schema.Struct({
name: Schema.String,
principalId: Schema.String,
- principalType: V2PluginReadResponse__PluginSharePrincipalType,
+ principalType: V2PluginListResponse__PluginSharePrincipalType,
+ role: V2PluginListResponse__PluginSharePrincipalRole,
});
-export type V2PluginShareListResponse__PluginInterface = {
+export type V2PluginReadResponse__PluginInterface = {
readonly brandColor?: string | null;
readonly capabilities: ReadonlyArray<string>;
readonly category?: string | null;
- readonly composerIcon?: V2PluginShareListResponse__AbsolutePathBuf | null;
+ readonly composerIcon?: V2PluginReadResponse__AbsolutePathBuf | null;
readonly composerIconUrl?: string | null;
readonly defaultPrompt?: ReadonlyArray<string> | null;
readonly developerName?: string | null;
readonly displayName?: string | null;
- readonly logo?: V2PluginShareListResponse__AbsolutePathBuf | null;
+ readonly logo?: V2PluginReadResponse__AbsolutePathBuf | null;
readonly logoUrl?: string | null;
readonly longDescription?: string | null;
readonly privacyPolicyUrl?: string | null;
readonly screenshotUrls: ReadonlyArray<string>;
- readonly screenshots: ReadonlyArray<V2PluginShareListResponse__AbsolutePathBuf>;
+ readonly screenshots: ReadonlyArray<V2PluginReadResponse__AbsolutePathBuf>;
readonly shortDescription?: string | null;
readonly termsOfServiceUrl?: string | null;
readonly websiteUrl?: string | null;
};
-export const V2PluginShareListResponse__PluginInterface = Schema.Struct({
+export const V2PluginReadResponse__PluginInterface = Schema.Struct({
brandColor: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
capabilities: Schema.Array(Schema.String),
category: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
composerIcon: Schema.optionalKey(
- Schema.Union([V2PluginShareListResponse__AbsolutePathBuf, Schema.Null]).annotate({
+ Schema.Union([V2PluginReadResponse__AbsolutePathBuf, Schema.Null]).annotate({
+ description: "Local composer icon path, resolved from the installed plugin package.",
+ }),
+ ),
+ composerIconUrl: Schema.optionalKey(
+ Schema.Union([
+ Schema.String.annotate({ description: "Remote composer icon URL from the plugin catalog." }),
+ Schema.Null,
+ ]),
+ ),
+ defaultPrompt: Schema.optionalKey(
+ Schema.Union([
+ Schema.Array(Schema.String).annotate({
+ description:
+ "Starter prompts for the plugin. Capped at 3 entries with a maximum of 128 characters per entry.",
+ }),
+ Schema.Null,
+ ]),
+ ),
+ developerName: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ displayName: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ logo: Schema.optionalKey(
+ Schema.Union([V2PluginReadResponse__AbsolutePathBuf, Schema.Null]).annotate({
+ description: "Local logo path, resolved from the installed plugin package.",
+ }),
+ ),
+ logoUrl: Schema.optionalKey(
+ Schema.Union([
+ Schema.String.annotate({ description: "Remote logo URL from the plugin catalog." }),
+ Schema.Null,
+ ]),
+ ),
+ longDescription: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ privacyPolicyUrl: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ screenshotUrls: Schema.Array(Schema.String).annotate({
+ description: "Remote screenshot URLs from the plugin catalog.",
+ }),
+ screenshots: Schema.Array(V2PluginReadResponse__AbsolutePathBuf).annotate({
+ description: "Local screenshot paths, resolved from the installed plugin package.",
+ }),
+ shortDescription: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ termsOfServiceUrl: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ websiteUrl: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+});
+
+export type V2PluginReadResponse__PluginSource =
+ | { readonly path: V2PluginReadResponse__AbsolutePathBuf; readonly type: "local" }
+ | {
+ readonly path?: string | null;
+ readonly refName?: string | null;
+ readonly sha?: string | null;
+ readonly type: "git";
+ readonly url: string;
+ }
+ | { readonly type: "remote" };
+export const V2PluginReadResponse__PluginSource = Schema.Union(
+ [
+ Schema.Struct({
+ path: V2PluginReadResponse__AbsolutePathBuf,
+ type: Schema.Literal("local").annotate({ title: "LocalPluginSourceType" }),
+ }).annotate({ title: "LocalPluginSource" }),
+ Schema.Struct({
+ path: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ refName: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ sha: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ type: Schema.Literal("git").annotate({ title: "GitPluginSourceType" }),
+ url: Schema.String,
+ }).annotate({ title: "GitPluginSource" }),
+ Schema.Struct({
+ type: Schema.Literal("remote").annotate({ title: "RemotePluginSourceType" }),
+ }).annotate({
+ title: "RemotePluginSource",
+ description:
+ "The plugin is available in the remote catalog. Download metadata is kept server-side and is not exposed through the app-server API.",
+ }),
+ ],
+ { mode: "oneOf" },
+);
+
+export type V2PluginReadResponse__SkillInterface = {
+ readonly brandColor?: string | null;
+ readonly defaultPrompt?: string | null;
+ readonly displayName?: string | null;
+ readonly iconLarge?: V2PluginReadResponse__AbsolutePathBuf | null;
+ readonly iconSmall?: V2PluginReadResponse__AbsolutePathBuf | null;
+ readonly shortDescription?: string | null;
+};
+export const V2PluginReadResponse__SkillInterface = Schema.Struct({
+ brandColor: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ defaultPrompt: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ displayName: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ iconLarge: Schema.optionalKey(Schema.Union([V2PluginReadResponse__AbsolutePathBuf, Schema.Null])),
+ iconSmall: Schema.optionalKey(Schema.Union([V2PluginReadResponse__AbsolutePathBuf, Schema.Null])),
+ shortDescription: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+});
+
+export type V2PluginReadResponse__AppTemplateSummary = {
+ readonly canonicalConnectorId?: string | null;
+ readonly description?: string | null;
+ readonly logoUrl?: string | null;
+ readonly logoUrlDark?: string | null;
+ readonly materializedAppIds: ReadonlyArray<string>;
+ readonly name: string;
+ readonly reason?: V2PluginReadResponse__AppTemplateUnavailableReason | null;
+ readonly templateId: string;
+};
+export const V2PluginReadResponse__AppTemplateSummary = Schema.Struct({
+ canonicalConnectorId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ description: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ logoUrl: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ logoUrlDark: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ materializedAppIds: Schema.Array(Schema.String),
+ name: Schema.String,
+ reason: Schema.optionalKey(
+ Schema.Union([V2PluginReadResponse__AppTemplateUnavailableReason, Schema.Null]),
+ ),
+ templateId: Schema.String,
+});
+
+export type V2PluginReadResponse__PluginHookSummary = {
+ readonly eventName: V2PluginReadResponse__HookEventName;
+ readonly key: string;
+};
+export const V2PluginReadResponse__PluginHookSummary = Schema.Struct({
+ eventName: V2PluginReadResponse__HookEventName,
+ key: Schema.String,
+});
+
+export type V2PluginReadResponse__PluginSharePrincipal = {
+ readonly name: string;
+ readonly principalId: string;
+ readonly principalType: V2PluginReadResponse__PluginSharePrincipalType;
+ readonly role: V2PluginReadResponse__PluginSharePrincipalRole;
+};
+export const V2PluginReadResponse__PluginSharePrincipal = Schema.Struct({
+ name: Schema.String,
+ principalId: Schema.String,
+ principalType: V2PluginReadResponse__PluginSharePrincipalType,
+ role: V2PluginReadResponse__PluginSharePrincipalRole,
+});
+
+export type V2PluginShareListResponse__PluginInterface = {
+ readonly brandColor?: string | null;
+ readonly capabilities: ReadonlyArray<string>;
+ readonly category?: string | null;
+ readonly composerIcon?: V2PluginShareListResponse__AbsolutePathBuf | null;
+ readonly composerIconUrl?: string | null;
+ readonly defaultPrompt?: ReadonlyArray<string> | null;
+ readonly developerName?: string | null;
+ readonly displayName?: string | null;
+ readonly logo?: V2PluginShareListResponse__AbsolutePathBuf | null;
+ readonly logoUrl?: string | null;
+ readonly longDescription?: string | null;
+ readonly privacyPolicyUrl?: string | null;
+ readonly screenshotUrls: ReadonlyArray<string>;
+ readonly screenshots: ReadonlyArray<V2PluginShareListResponse__AbsolutePathBuf>;
+ readonly shortDescription?: string | null;
+ readonly termsOfServiceUrl?: string | null;
+ readonly websiteUrl?: string | null;
+};
+export const V2PluginShareListResponse__PluginInterface = Schema.Struct({
+ brandColor: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ capabilities: Schema.Array(Schema.String),
+ category: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ composerIcon: Schema.optionalKey(
+ Schema.Union([V2PluginShareListResponse__AbsolutePathBuf, Schema.Null]).annotate({
description: "Local composer icon path, resolved from the installed plugin package.",
}),
),
@@ -13179,40 +13940,48 @@ export type V2PluginShareListResponse__PluginSharePrincipal = {
readonly name: string;
readonly principalId: string;
readonly principalType: V2PluginShareListResponse__PluginSharePrincipalType;
+ readonly role: V2PluginShareListResponse__PluginSharePrincipalRole;
};
export const V2PluginShareListResponse__PluginSharePrincipal = Schema.Struct({
name: Schema.String,
principalId: Schema.String,
principalType: V2PluginShareListResponse__PluginSharePrincipalType,
+ role: V2PluginShareListResponse__PluginSharePrincipalRole,
});
export type V2PluginShareSaveParams__PluginShareTarget = {
readonly principalId: string;
readonly principalType: V2PluginShareSaveParams__PluginSharePrincipalType;
+ readonly role: V2PluginShareSaveParams__PluginShareTargetRole;
};
export const V2PluginShareSaveParams__PluginShareTarget = Schema.Struct({
principalId: Schema.String,
principalType: V2PluginShareSaveParams__PluginSharePrincipalType,
+ role: V2PluginShareSaveParams__PluginShareTargetRole,
});
export type V2PluginShareUpdateTargetsParams__PluginShareTarget = {
readonly principalId: string;
readonly principalType: V2PluginShareUpdateTargetsParams__PluginSharePrincipalType;
+ readonly role: V2PluginShareUpdateTargetsParams__PluginShareTargetRole;
};
export const V2PluginShareUpdateTargetsParams__PluginShareTarget = Schema.Struct({
principalId: Schema.String,
principalType: V2PluginShareUpdateTargetsParams__PluginSharePrincipalType,
+ role: V2PluginShareUpdateTargetsParams__PluginShareTargetRole,
});
export type V2PluginShareUpdateTargetsResponse__PluginSharePrincipal = {
readonly name: string;
readonly principalId: string;
readonly principalType: V2PluginShareUpdateTargetsResponse__PluginSharePrincipalType;
+ readonly role: V2PluginShareUpdateTargetsResponse__PluginSharePrincipalRole;
};
export const V2PluginShareUpdateTargetsResponse__PluginSharePrincipal = Schema.Struct({
name: Schema.String,
principalId: Schema.String,
principalType: V2PluginShareUpdateTargetsResponse__PluginSharePrincipalType,
+ role: V2PluginShareUpdateTargetsResponse__PluginSharePrincipalRole,
});
export type V2RawResponseItemCompletedNotification__ContentItem =
@@ -13250,7 +14019,8 @@ export type V2RawResponseItemCompletedNotification__FunctionCallOutputContentIte
readonly detail?: V2RawResponseItemCompletedNotification__ImageDetail | null;
readonly image_url: string;
readonly type: "input_image";
- };
+ }
+ | { readonly encrypted_content: string; readonly type: "encrypted_content" };
export const V2RawResponseItemCompletedNotification__FunctionCallOutputContentItem = Schema.Union(
[
Schema.Struct({
@@ -13268,6 +14038,12 @@ export const V2RawResponseItemCompletedNotification__FunctionCallOutputContentIt
title: "InputImageFunctionCallOutputContentItemType",
}),
}).annotate({ title: "InputImageFunctionCallOutputContentItem" }),
+ Schema.Struct({
+ encrypted_content: Schema.String,
+ type: Schema.Literal("encrypted_content").annotate({
+ title: "EncryptedContentFunctionCallOutputContentItemType",
+ }),
+ }).annotate({ title: "EncryptedContentFunctionCallOutputContentItem" }),
],
{ mode: "oneOf" },
).annotate({
@@ -13460,8 +14236,16 @@ export type V2ReviewStartResponse__UserInput =
readonly text_elements?: ReadonlyArray<V2ReviewStartResponse__TextElement>;
readonly type: "text";
}
- | { readonly type: "image"; readonly url: string }
- | { readonly path: string; readonly type: "localImage" }
+ | {
+ readonly detail?: V2ReviewStartResponse__ImageDetail | null;
+ readonly type: "image";
+ readonly url: string;
+ }
+ | {
+ readonly detail?: V2ReviewStartResponse__ImageDetail | null;
+ readonly path: string;
+ readonly type: "localImage";
+ }
| { readonly name: string; readonly path: string; readonly type: "skill" }
| { readonly name: string; readonly path: string; readonly type: "mention" };
export const V2ReviewStartResponse__UserInput = Schema.Union(
@@ -13477,10 +14261,12 @@ export const V2ReviewStartResponse__UserInput = Schema.Union(
type: Schema.Literal("text").annotate({ title: "TextUserInputType" }),
}).annotate({ title: "TextUserInput" }),
Schema.Struct({
+ detail: Schema.optionalKey(Schema.Union([V2ReviewStartResponse__ImageDetail, Schema.Null])),
type: Schema.Literal("image").annotate({ title: "ImageUserInputType" }),
url: Schema.String,
}).annotate({ title: "ImageUserInput" }),
Schema.Struct({
+ detail: Schema.optionalKey(Schema.Union([V2ReviewStartResponse__ImageDetail, Schema.Null])),
path: Schema.String,
type: Schema.Literal("localImage").annotate({ title: "LocalImageUserInputType" }),
}).annotate({ title: "LocalImageUserInput" }),
@@ -13522,44 +14308,6 @@ export const V2SkillsListResponse__SkillDependencies = Schema.Struct({
tools: Schema.Array(V2SkillsListResponse__SkillToolDependency),
});
-export type V2ThreadForkParams__PermissionProfileModificationParams = {
- readonly path: V2ThreadForkParams__AbsolutePathBuf;
- readonly type: "additionalWritableRoot";
-};
-export const V2ThreadForkParams__PermissionProfileModificationParams = Schema.Union(
- [
- Schema.Struct({
- path: V2ThreadForkParams__AbsolutePathBuf,
- type: Schema.Literal("additionalWritableRoot").annotate({
- title: "AdditionalWritableRootPermissionProfileModificationParamsType",
- }),
- }).annotate({
- title: "AdditionalWritableRootPermissionProfileModificationParams",
- description: "Additional concrete directory that should be writable.",
- }),
- ],
- { mode: "oneOf" },
-);
-
-export type V2ThreadForkResponse__ActivePermissionProfileModification = {
- readonly path: V2ThreadForkResponse__AbsolutePathBuf;
- readonly type: "additionalWritableRoot";
-};
-export const V2ThreadForkResponse__ActivePermissionProfileModification = Schema.Union(
- [
- Schema.Struct({
- path: V2ThreadForkResponse__AbsolutePathBuf,
- type: Schema.Literal("additionalWritableRoot").annotate({
- title: "AdditionalWritableRootActivePermissionProfileModificationType",
- }),
- }).annotate({
- title: "AdditionalWritableRootActivePermissionProfileModification",
- description: "Additional concrete directory that should be writable.",
- }),
- ],
- { mode: "oneOf" },
-);
-
export type V2ThreadForkResponse__CommandAction =
| {
readonly command: string;
@@ -13611,28 +14359,6 @@ export const V2ThreadForkResponse__CollabAgentState = Schema.Struct({
status: V2ThreadForkResponse__CollabAgentStatus,
});
-export type V2ThreadForkResponse__FileSystemPath =
- | { readonly path: V2ThreadForkResponse__AbsolutePathBuf; readonly type: "path" }
- | { readonly pattern: string; readonly type: "glob_pattern" }
- | { readonly type: "special"; readonly value: V2ThreadForkResponse__FileSystemSpecialPath };
-export const V2ThreadForkResponse__FileSystemPath = Schema.Union(
- [
- Schema.Struct({
- path: V2ThreadForkResponse__AbsolutePathBuf,
- type: Schema.Literal("path").annotate({ title: "PathFileSystemPathType" }),
- }).annotate({ title: "PathFileSystemPath" }),
- Schema.Struct({
- pattern: Schema.String,
- type: Schema.Literal("glob_pattern").annotate({ title: "GlobPatternFileSystemPathType" }),
- }).annotate({ title: "GlobPatternFileSystemPath" }),
- Schema.Struct({
- type: Schema.Literal("special").annotate({ title: "SpecialFileSystemPathType" }),
- value: V2ThreadForkResponse__FileSystemSpecialPath,
- }).annotate({ title: "SpecialFileSystemPath" }),
- ],
- { mode: "oneOf" },
-);
-
export type V2ThreadForkResponse__MemoryCitation = {
readonly entries: ReadonlyArray<V2ThreadForkResponse__MemoryCitationEntry>;
readonly threadIds: ReadonlyArray<string>;
@@ -13767,8 +14493,16 @@ export type V2ThreadForkResponse__UserInput =
readonly text_elements?: ReadonlyArray<V2ThreadForkResponse__TextElement>;
readonly type: "text";
}
- | { readonly type: "image"; readonly url: string }
- | { readonly path: string; readonly type: "localImage" }
+ | {
+ readonly detail?: V2ThreadForkResponse__ImageDetail | null;
+ readonly type: "image";
+ readonly url: string;
+ }
+ | {
+ readonly detail?: V2ThreadForkResponse__ImageDetail | null;
+ readonly path: string;
+ readonly type: "localImage";
+ }
| { readonly name: string; readonly path: string; readonly type: "skill" }
| { readonly name: string; readonly path: string; readonly type: "mention" };
export const V2ThreadForkResponse__UserInput = Schema.Union(
@@ -13784,10 +14518,12 @@ export const V2ThreadForkResponse__UserInput = Schema.Union(
type: Schema.Literal("text").annotate({ title: "TextUserInputType" }),
}).annotate({ title: "TextUserInput" }),
Schema.Struct({
+ detail: Schema.optionalKey(Schema.Union([V2ThreadForkResponse__ImageDetail, Schema.Null])),
type: Schema.Literal("image").annotate({ title: "ImageUserInputType" }),
url: Schema.String,
}).annotate({ title: "ImageUserInput" }),
Schema.Struct({
+ detail: Schema.optionalKey(Schema.Union([V2ThreadForkResponse__ImageDetail, Schema.Null])),
path: Schema.String,
type: Schema.Literal("localImage").annotate({ title: "LocalImageUserInputType" }),
}).annotate({ title: "LocalImageUserInput" }),
@@ -13838,6 +14574,52 @@ export const V2ThreadForkResponse__SubAgentSource = Schema.Union(
{ mode: "oneOf" },
);
+export type V2ThreadGoalGetResponse__ThreadGoal = {
+ readonly createdAt: number;
+ readonly objective: string;
+ readonly status: V2ThreadGoalGetResponse__ThreadGoalStatus;
+ readonly threadId: string;
+ readonly timeUsedSeconds: number;
+ readonly tokenBudget?: number | null;
+ readonly tokensUsed: number;
+ readonly updatedAt: number;
+};
+export const V2ThreadGoalGetResponse__ThreadGoal = Schema.Struct({
+ createdAt: Schema.Number.annotate({ format: "int64" }).check(Schema.isInt()),
+ objective: Schema.String,
+ status: V2ThreadGoalGetResponse__ThreadGoalStatus,
+ threadId: Schema.String,
+ timeUsedSeconds: Schema.Number.annotate({ format: "int64" }).check(Schema.isInt()),
+ tokenBudget: Schema.optionalKey(
+ Schema.Union([Schema.Number.annotate({ format: "int64" }).check(Schema.isInt()), Schema.Null]),
+ ),
+ tokensUsed: Schema.Number.annotate({ format: "int64" }).check(Schema.isInt()),
+ updatedAt: Schema.Number.annotate({ format: "int64" }).check(Schema.isInt()),
+});
+
+export type V2ThreadGoalSetResponse__ThreadGoal = {
+ readonly createdAt: number;
+ readonly objective: string;
+ readonly status: V2ThreadGoalSetResponse__ThreadGoalStatus;
+ readonly threadId: string;
+ readonly timeUsedSeconds: number;
+ readonly tokenBudget?: number | null;
+ readonly tokensUsed: number;
+ readonly updatedAt: number;
+};
+export const V2ThreadGoalSetResponse__ThreadGoal = Schema.Struct({
+ createdAt: Schema.Number.annotate({ format: "int64" }).check(Schema.isInt()),
+ objective: Schema.String,
+ status: V2ThreadGoalSetResponse__ThreadGoalStatus,
+ threadId: Schema.String,
+ timeUsedSeconds: Schema.Number.annotate({ format: "int64" }).check(Schema.isInt()),
+ tokenBudget: Schema.optionalKey(
+ Schema.Union([Schema.Number.annotate({ format: "int64" }).check(Schema.isInt()), Schema.Null]),
+ ),
+ tokensUsed: Schema.Number.annotate({ format: "int64" }).check(Schema.isInt()),
+ updatedAt: Schema.Number.annotate({ format: "int64" }).check(Schema.isInt()),
+});
+
export type V2ThreadGoalUpdatedNotification__ThreadGoal = {
readonly createdAt: number;
readonly objective: string;
@@ -14046,8 +14828,16 @@ export type V2ThreadListResponse__UserInput =
readonly text_elements?: ReadonlyArray<V2ThreadListResponse__TextElement>;
readonly type: "text";
}
- | { readonly type: "image"; readonly url: string }
- | { readonly path: string; readonly type: "localImage" }
+ | {
+ readonly detail?: V2ThreadListResponse__ImageDetail | null;
+ readonly type: "image";
+ readonly url: string;
+ }
+ | {
+ readonly detail?: V2ThreadListResponse__ImageDetail | null;
+ readonly path: string;
+ readonly type: "localImage";
+ }
| { readonly name: string; readonly path: string; readonly type: "skill" }
| { readonly name: string; readonly path: string; readonly type: "mention" };
export const V2ThreadListResponse__UserInput = Schema.Union(
@@ -14063,10 +14853,12 @@ export const V2ThreadListResponse__UserInput = Schema.Union(
type: Schema.Literal("text").annotate({ title: "TextUserInputType" }),
}).annotate({ title: "TextUserInput" }),
Schema.Struct({
+ detail: Schema.optionalKey(Schema.Union([V2ThreadListResponse__ImageDetail, Schema.Null])),
type: Schema.Literal("image").annotate({ title: "ImageUserInputType" }),
url: Schema.String,
}).annotate({ title: "ImageUserInput" }),
Schema.Struct({
+ detail: Schema.optionalKey(Schema.Union([V2ThreadListResponse__ImageDetail, Schema.Null])),
path: Schema.String,
type: Schema.Literal("localImage").annotate({ title: "LocalImageUserInputType" }),
}).annotate({ title: "LocalImageUserInput" }),
@@ -14302,8 +15094,16 @@ export type V2ThreadMetadataUpdateResponse__UserInput =
readonly text_elements?: ReadonlyArray<V2ThreadMetadataUpdateResponse__TextElement>;
readonly type: "text";
}
- | { readonly type: "image"; readonly url: string }
- | { readonly path: string; readonly type: "localImage" }
+ | {
+ readonly detail?: V2ThreadMetadataUpdateResponse__ImageDetail | null;
+ readonly type: "image";
+ readonly url: string;
+ }
+ | {
+ readonly detail?: V2ThreadMetadataUpdateResponse__ImageDetail | null;
+ readonly path: string;
+ readonly type: "localImage";
+ }
| { readonly name: string; readonly path: string; readonly type: "skill" }
| { readonly name: string; readonly path: string; readonly type: "mention" };
export const V2ThreadMetadataUpdateResponse__UserInput = Schema.Union(
@@ -14319,10 +15119,16 @@ export const V2ThreadMetadataUpdateResponse__UserInput = Schema.Union(
type: Schema.Literal("text").annotate({ title: "TextUserInputType" }),
}).annotate({ title: "TextUserInput" }),
Schema.Struct({
+ detail: Schema.optionalKey(
+ Schema.Union([V2ThreadMetadataUpdateResponse__ImageDetail, Schema.Null]),
+ ),
type: Schema.Literal("image").annotate({ title: "ImageUserInputType" }),
url: Schema.String,
}).annotate({ title: "ImageUserInput" }),
Schema.Struct({
+ detail: Schema.optionalKey(
+ Schema.Union([V2ThreadMetadataUpdateResponse__ImageDetail, Schema.Null]),
+ ),
path: Schema.String,
type: Schema.Literal("localImage").annotate({ title: "LocalImageUserInputType" }),
}).annotate({ title: "LocalImageUserInput" }),
@@ -14558,8 +15364,16 @@ export type V2ThreadReadResponse__UserInput =
readonly text_elements?: ReadonlyArray<V2ThreadReadResponse__TextElement>;
readonly type: "text";
}
- | { readonly type: "image"; readonly url: string }
- | { readonly path: string; readonly type: "localImage" }
+ | {
+ readonly detail?: V2ThreadReadResponse__ImageDetail | null;
+ readonly type: "image";
+ readonly url: string;
+ }
+ | {
+ readonly detail?: V2ThreadReadResponse__ImageDetail | null;
+ readonly path: string;
+ readonly type: "localImage";
+ }
| { readonly name: string; readonly path: string; readonly type: "skill" }
| { readonly name: string; readonly path: string; readonly type: "mention" };
export const V2ThreadReadResponse__UserInput = Schema.Union(
@@ -14575,10 +15389,12 @@ export const V2ThreadReadResponse__UserInput = Schema.Union(
type: Schema.Literal("text").annotate({ title: "TextUserInputType" }),
}).annotate({ title: "TextUserInput" }),
Schema.Struct({
+ detail: Schema.optionalKey(Schema.Union([V2ThreadReadResponse__ImageDetail, Schema.Null])),
type: Schema.Literal("image").annotate({ title: "ImageUserInputType" }),
url: Schema.String,
}).annotate({ title: "ImageUserInput" }),
Schema.Struct({
+ detail: Schema.optionalKey(Schema.Union([V2ThreadReadResponse__ImageDetail, Schema.Null])),
path: Schema.String,
type: Schema.Literal("localImage").annotate({ title: "LocalImageUserInputType" }),
}).annotate({ title: "LocalImageUserInput" }),
@@ -14629,25 +15445,6 @@ export const V2ThreadReadResponse__SubAgentSource = Schema.Union(
{ mode: "oneOf" },
);
-export type V2ThreadResumeParams__PermissionProfileModificationParams = {
- readonly path: V2ThreadResumeParams__AbsolutePathBuf;
- readonly type: "additionalWritableRoot";
-};
-export const V2ThreadResumeParams__PermissionProfileModificationParams = Schema.Union(
- [
- Schema.Struct({
- path: V2ThreadResumeParams__AbsolutePathBuf,
- type: Schema.Literal("additionalWritableRoot").annotate({
- title: "AdditionalWritableRootPermissionProfileModificationParamsType",
- }),
- }).annotate({
- title: "AdditionalWritableRootPermissionProfileModificationParams",
- description: "Additional concrete directory that should be writable.",
- }),
- ],
- { mode: "oneOf" },
-);
-
export type V2ThreadResumeParams__ContentItem =
| { readonly text: string; readonly type: "input_text" }
| {
@@ -14681,7 +15478,8 @@ export type V2ThreadResumeParams__FunctionCallOutputContentItem =
readonly detail?: V2ThreadResumeParams__ImageDetail | null;
readonly image_url: string;
readonly type: "input_image";
- };
+ }
+ | { readonly encrypted_content: string; readonly type: "encrypted_content" };
export const V2ThreadResumeParams__FunctionCallOutputContentItem = Schema.Union(
[
Schema.Struct({
@@ -14697,6 +15495,12 @@ export const V2ThreadResumeParams__FunctionCallOutputContentItem = Schema.Union(
title: "InputImageFunctionCallOutputContentItemType",
}),
}).annotate({ title: "InputImageFunctionCallOutputContentItem" }),
+ Schema.Struct({
+ encrypted_content: Schema.String,
+ type: Schema.Literal("encrypted_content").annotate({
+ title: "EncryptedContentFunctionCallOutputContentItemType",
+ }),
+ }).annotate({ title: "EncryptedContentFunctionCallOutputContentItem" }),
],
{ mode: "oneOf" },
).annotate({
@@ -14704,25 +15508,6 @@ export const V2ThreadResumeParams__FunctionCallOutputContentItem = Schema.Union(
"Responses API compatible content items that can be returned by a tool call. This is a subset of ContentItem with the types we support as function call outputs.",
});
-export type V2ThreadResumeResponse__ActivePermissionProfileModification = {
- readonly path: V2ThreadResumeResponse__AbsolutePathBuf;
- readonly type: "additionalWritableRoot";
-};
-export const V2ThreadResumeResponse__ActivePermissionProfileModification = Schema.Union(
- [
- Schema.Struct({
- path: V2ThreadResumeResponse__AbsolutePathBuf,
- type: Schema.Literal("additionalWritableRoot").annotate({
- title: "AdditionalWritableRootActivePermissionProfileModificationType",
- }),
- }).annotate({
- title: "AdditionalWritableRootActivePermissionProfileModification",
- description: "Additional concrete directory that should be writable.",
- }),
- ],
- { mode: "oneOf" },
-);
-
export type V2ThreadResumeResponse__CommandAction =
| {
readonly command: string;
@@ -14774,28 +15559,6 @@ export const V2ThreadResumeResponse__CollabAgentState = Schema.Struct({
status: V2ThreadResumeResponse__CollabAgentStatus,
});
-export type V2ThreadResumeResponse__FileSystemPath =
- | { readonly path: V2ThreadResumeResponse__AbsolutePathBuf; readonly type: "path" }
- | { readonly pattern: string; readonly type: "glob_pattern" }
- | { readonly type: "special"; readonly value: V2ThreadResumeResponse__FileSystemSpecialPath };
-export const V2ThreadResumeResponse__FileSystemPath = Schema.Union(
- [
- Schema.Struct({
- path: V2ThreadResumeResponse__AbsolutePathBuf,
- type: Schema.Literal("path").annotate({ title: "PathFileSystemPathType" }),
- }).annotate({ title: "PathFileSystemPath" }),
- Schema.Struct({
- pattern: Schema.String,
- type: Schema.Literal("glob_pattern").annotate({ title: "GlobPatternFileSystemPathType" }),
- }).annotate({ title: "GlobPatternFileSystemPath" }),
- Schema.Struct({
- type: Schema.Literal("special").annotate({ title: "SpecialFileSystemPathType" }),
- value: V2ThreadResumeResponse__FileSystemSpecialPath,
- }).annotate({ title: "SpecialFileSystemPath" }),
- ],
- { mode: "oneOf" },
-);
-
export type V2ThreadResumeResponse__MemoryCitation = {
readonly entries: ReadonlyArray<V2ThreadResumeResponse__MemoryCitationEntry>;
readonly threadIds: ReadonlyArray<string>;
@@ -14930,8 +15693,16 @@ export type V2ThreadResumeResponse__UserInput =
readonly text_elements?: ReadonlyArray<V2ThreadResumeResponse__TextElement>;
readonly type: "text";
}
- | { readonly type: "image"; readonly url: string }
- | { readonly path: string; readonly type: "localImage" }
+ | {
+ readonly detail?: V2ThreadResumeResponse__ImageDetail | null;
+ readonly type: "image";
+ readonly url: string;
+ }
+ | {
+ readonly detail?: V2ThreadResumeResponse__ImageDetail | null;
+ readonly path: string;
+ readonly type: "localImage";
+ }
| { readonly name: string; readonly path: string; readonly type: "skill" }
| { readonly name: string; readonly path: string; readonly type: "mention" };
export const V2ThreadResumeResponse__UserInput = Schema.Union(
@@ -14947,10 +15718,12 @@ export const V2ThreadResumeResponse__UserInput = Schema.Union(
type: Schema.Literal("text").annotate({ title: "TextUserInputType" }),
}).annotate({ title: "TextUserInput" }),
Schema.Struct({
+ detail: Schema.optionalKey(Schema.Union([V2ThreadResumeResponse__ImageDetail, Schema.Null])),
type: Schema.Literal("image").annotate({ title: "ImageUserInputType" }),
url: Schema.String,
}).annotate({ title: "ImageUserInput" }),
Schema.Struct({
+ detail: Schema.optionalKey(Schema.Union([V2ThreadResumeResponse__ImageDetail, Schema.Null])),
path: Schema.String,
type: Schema.Literal("localImage").annotate({ title: "LocalImageUserInputType" }),
}).annotate({ title: "LocalImageUserInput" }),
@@ -15186,8 +15959,16 @@ export type V2ThreadRollbackResponse__UserInput =
readonly text_elements?: ReadonlyArray<V2ThreadRollbackResponse__TextElement>;
readonly type: "text";
}
- | { readonly type: "image"; readonly url: string }
- | { readonly path: string; readonly type: "localImage" }
+ | {
+ readonly detail?: V2ThreadRollbackResponse__ImageDetail | null;
+ readonly type: "image";
+ readonly url: string;
+ }
+ | {
+ readonly detail?: V2ThreadRollbackResponse__ImageDetail | null;
+ readonly path: string;
+ readonly type: "localImage";
+ }
| { readonly name: string; readonly path: string; readonly type: "skill" }
| { readonly name: string; readonly path: string; readonly type: "mention" };
export const V2ThreadRollbackResponse__UserInput = Schema.Union(
@@ -15203,10 +15984,16 @@ export const V2ThreadRollbackResponse__UserInput = Schema.Union(
type: Schema.Literal("text").annotate({ title: "TextUserInputType" }),
}).annotate({ title: "TextUserInput" }),
Schema.Struct({
+ detail: Schema.optionalKey(
+ Schema.Union([V2ThreadRollbackResponse__ImageDetail, Schema.Null]),
+ ),
type: Schema.Literal("image").annotate({ title: "ImageUserInputType" }),
url: Schema.String,
}).annotate({ title: "ImageUserInput" }),
Schema.Struct({
+ detail: Schema.optionalKey(
+ Schema.Union([V2ThreadRollbackResponse__ImageDetail, Schema.Null]),
+ ),
path: Schema.String,
type: Schema.Literal("localImage").annotate({ title: "LocalImageUserInputType" }),
}).annotate({ title: "LocalImageUserInput" }),
@@ -15257,6 +16044,64 @@ export const V2ThreadRollbackResponse__SubAgentSource = Schema.Union(
{ mode: "oneOf" },
);
+export type V2ThreadSettingsUpdatedNotification__SandboxPolicy =
+ | { readonly type: "dangerFullAccess" }
+ | { readonly networkAccess?: boolean; readonly type: "readOnly" }
+ | { readonly networkAccess?: "restricted" | "enabled"; readonly type: "externalSandbox" }
+ | {
+ readonly excludeSlashTmp?: boolean;
+ readonly excludeTmpdirEnvVar?: boolean;
+ readonly networkAccess?: boolean;
+ readonly type: "workspaceWrite";
+ readonly writableRoots?: ReadonlyArray<V2ThreadSettingsUpdatedNotification__AbsolutePathBuf>;
+ };
+export const V2ThreadSettingsUpdatedNotification__SandboxPolicy = Schema.Union(
+ [
+ Schema.Struct({
+ type: Schema.Literal("dangerFullAccess").annotate({
+ title: "DangerFullAccessSandboxPolicyType",
+ }),
+ }).annotate({ title: "DangerFullAccessSandboxPolicy" }),
+ Schema.Struct({
+ networkAccess: Schema.optionalKey(Schema.Boolean.annotate({ default: false })),
+ type: Schema.Literal("readOnly").annotate({ title: "ReadOnlySandboxPolicyType" }),
+ }).annotate({ title: "ReadOnlySandboxPolicy" }),
+ Schema.Struct({
+ networkAccess: Schema.optionalKey(
+ Schema.Literals(["restricted", "enabled"]).annotate({ default: "restricted" }),
+ ),
+ type: Schema.Literal("externalSandbox").annotate({
+ title: "ExternalSandboxSandboxPolicyType",
+ }),
+ }).annotate({ title: "ExternalSandboxSandboxPolicy" }),
+ Schema.Struct({
+ excludeSlashTmp: Schema.optionalKey(Schema.Boolean.annotate({ default: false })),
+ excludeTmpdirEnvVar: Schema.optionalKey(Schema.Boolean.annotate({ default: false })),
+ networkAccess: Schema.optionalKey(Schema.Boolean.annotate({ default: false })),
+ type: Schema.Literal("workspaceWrite").annotate({ title: "WorkspaceWriteSandboxPolicyType" }),
+ writableRoots: Schema.optionalKey(
+ Schema.Array(V2ThreadSettingsUpdatedNotification__AbsolutePathBuf).annotate({
+ default: [],
+ }),
+ ),
+ }).annotate({ title: "WorkspaceWriteSandboxPolicy" }),
+ ],
+ { mode: "oneOf" },
+);
+
+export type V2ThreadSettingsUpdatedNotification__Settings = {
+ readonly developer_instructions?: string | null;
+ readonly model: string;
+ readonly reasoning_effort?: V2ThreadSettingsUpdatedNotification__ReasoningEffort | null;
+};
+export const V2ThreadSettingsUpdatedNotification__Settings = Schema.Struct({
+ developer_instructions: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ model: Schema.String,
+ reasoning_effort: Schema.optionalKey(
+ Schema.Union([V2ThreadSettingsUpdatedNotification__ReasoningEffort, Schema.Null]),
+ ),
+}).annotate({ description: "Settings for a collaboration mode." });
+
export type V2ThreadStartedNotification__CommandAction =
| {
readonly command: string;
@@ -15442,8 +16287,16 @@ export type V2ThreadStartedNotification__UserInput =
readonly text_elements?: ReadonlyArray<V2ThreadStartedNotification__TextElement>;
readonly type: "text";
}
- | { readonly type: "image"; readonly url: string }
- | { readonly path: string; readonly type: "localImage" }
+ | {
+ readonly detail?: V2ThreadStartedNotification__ImageDetail | null;
+ readonly type: "image";
+ readonly url: string;
+ }
+ | {
+ readonly detail?: V2ThreadStartedNotification__ImageDetail | null;
+ readonly path: string;
+ readonly type: "localImage";
+ }
| { readonly name: string; readonly path: string; readonly type: "skill" }
| { readonly name: string; readonly path: string; readonly type: "mention" };
export const V2ThreadStartedNotification__UserInput = Schema.Union(
@@ -15459,10 +16312,16 @@ export const V2ThreadStartedNotification__UserInput = Schema.Union(
type: Schema.Literal("text").annotate({ title: "TextUserInputType" }),
}).annotate({ title: "TextUserInput" }),
Schema.Struct({
+ detail: Schema.optionalKey(
+ Schema.Union([V2ThreadStartedNotification__ImageDetail, Schema.Null]),
+ ),
type: Schema.Literal("image").annotate({ title: "ImageUserInputType" }),
url: Schema.String,
}).annotate({ title: "ImageUserInput" }),
Schema.Struct({
+ detail: Schema.optionalKey(
+ Schema.Union([V2ThreadStartedNotification__ImageDetail, Schema.Null]),
+ ),
path: Schema.String,
type: Schema.Literal("localImage").annotate({ title: "LocalImageUserInputType" }),
}).annotate({ title: "LocalImageUserInput" }),
@@ -15513,44 +16372,6 @@ export const V2ThreadStartedNotification__SubAgentSource = Schema.Union(
{ mode: "oneOf" },
);
-export type V2ThreadStartParams__PermissionProfileModificationParams = {
- readonly path: V2ThreadStartParams__AbsolutePathBuf;
- readonly type: "additionalWritableRoot";
-};
-export const V2ThreadStartParams__PermissionProfileModificationParams = Schema.Union(
- [
- Schema.Struct({
- path: V2ThreadStartParams__AbsolutePathBuf,
- type: Schema.Literal("additionalWritableRoot").annotate({
- title: "AdditionalWritableRootPermissionProfileModificationParamsType",
- }),
- }).annotate({
- title: "AdditionalWritableRootPermissionProfileModificationParams",
- description: "Additional concrete directory that should be writable.",
- }),
- ],
- { mode: "oneOf" },
-);
-
-export type V2ThreadStartResponse__ActivePermissionProfileModification = {
- readonly path: V2ThreadStartResponse__AbsolutePathBuf;
- readonly type: "additionalWritableRoot";
-};
-export const V2ThreadStartResponse__ActivePermissionProfileModification = Schema.Union(
- [
- Schema.Struct({
- path: V2ThreadStartResponse__AbsolutePathBuf,
- type: Schema.Literal("additionalWritableRoot").annotate({
- title: "AdditionalWritableRootActivePermissionProfileModificationType",
- }),
- }).annotate({
- title: "AdditionalWritableRootActivePermissionProfileModification",
- description: "Additional concrete directory that should be writable.",
- }),
- ],
- { mode: "oneOf" },
-);
-
export type V2ThreadStartResponse__CommandAction =
| {
readonly command: string;
@@ -15602,28 +16423,6 @@ export const V2ThreadStartResponse__CollabAgentState = Schema.Struct({
status: V2ThreadStartResponse__CollabAgentStatus,
});
-export type V2ThreadStartResponse__FileSystemPath =
- | { readonly path: V2ThreadStartResponse__AbsolutePathBuf; readonly type: "path" }
- | { readonly pattern: string; readonly type: "glob_pattern" }
- | { readonly type: "special"; readonly value: V2ThreadStartResponse__FileSystemSpecialPath };
-export const V2ThreadStartResponse__FileSystemPath = Schema.Union(
- [
- Schema.Struct({
- path: V2ThreadStartResponse__AbsolutePathBuf,
- type: Schema.Literal("path").annotate({ title: "PathFileSystemPathType" }),
- }).annotate({ title: "PathFileSystemPath" }),
- Schema.Struct({
- pattern: Schema.String,
- type: Schema.Literal("glob_pattern").annotate({ title: "GlobPatternFileSystemPathType" }),
- }).annotate({ title: "GlobPatternFileSystemPath" }),
- Schema.Struct({
- type: Schema.Literal("special").annotate({ title: "SpecialFileSystemPathType" }),
- value: V2ThreadStartResponse__FileSystemSpecialPath,
- }).annotate({ title: "SpecialFileSystemPath" }),
- ],
- { mode: "oneOf" },
-);
-
export type V2ThreadStartResponse__MemoryCitation = {
readonly entries: ReadonlyArray<V2ThreadStartResponse__MemoryCitationEntry>;
readonly threadIds: ReadonlyArray<string>;
@@ -15758,8 +16557,16 @@ export type V2ThreadStartResponse__UserInput =
readonly text_elements?: ReadonlyArray<V2ThreadStartResponse__TextElement>;
readonly type: "text";
}
- | { readonly type: "image"; readonly url: string }
- | { readonly path: string; readonly type: "localImage" }
+ | {
+ readonly detail?: V2ThreadStartResponse__ImageDetail | null;
+ readonly type: "image";
+ readonly url: string;
+ }
+ | {
+ readonly detail?: V2ThreadStartResponse__ImageDetail | null;
+ readonly path: string;
+ readonly type: "localImage";
+ }
| { readonly name: string; readonly path: string; readonly type: "skill" }
| { readonly name: string; readonly path: string; readonly type: "mention" };
export const V2ThreadStartResponse__UserInput = Schema.Union(
@@ -15775,10 +16582,12 @@ export const V2ThreadStartResponse__UserInput = Schema.Union(
type: Schema.Literal("text").annotate({ title: "TextUserInputType" }),
}).annotate({ title: "TextUserInput" }),
Schema.Struct({
+ detail: Schema.optionalKey(Schema.Union([V2ThreadStartResponse__ImageDetail, Schema.Null])),
type: Schema.Literal("image").annotate({ title: "ImageUserInputType" }),
url: Schema.String,
}).annotate({ title: "ImageUserInput" }),
Schema.Struct({
+ detail: Schema.optionalKey(Schema.Union([V2ThreadStartResponse__ImageDetail, Schema.Null])),
path: Schema.String,
type: Schema.Literal("localImage").annotate({ title: "LocalImageUserInputType" }),
}).annotate({ title: "LocalImageUserInput" }),
@@ -16054,8 +16863,16 @@ export type V2ThreadUnarchiveResponse__UserInput =
readonly text_elements?: ReadonlyArray<V2ThreadUnarchiveResponse__TextElement>;
readonly type: "text";
}
- | { readonly type: "image"; readonly url: string }
- | { readonly path: string; readonly type: "localImage" }
+ | {
+ readonly detail?: V2ThreadUnarchiveResponse__ImageDetail | null;
+ readonly type: "image";
+ readonly url: string;
+ }
+ | {
+ readonly detail?: V2ThreadUnarchiveResponse__ImageDetail | null;
+ readonly path: string;
+ readonly type: "localImage";
+ }
| { readonly name: string; readonly path: string; readonly type: "skill" }
| { readonly name: string; readonly path: string; readonly type: "mention" };
export const V2ThreadUnarchiveResponse__UserInput = Schema.Union(
@@ -16071,10 +16888,16 @@ export const V2ThreadUnarchiveResponse__UserInput = Schema.Union(
type: Schema.Literal("text").annotate({ title: "TextUserInputType" }),
}).annotate({ title: "TextUserInput" }),
Schema.Struct({
+ detail: Schema.optionalKey(
+ Schema.Union([V2ThreadUnarchiveResponse__ImageDetail, Schema.Null]),
+ ),
type: Schema.Literal("image").annotate({ title: "ImageUserInputType" }),
url: Schema.String,
}).annotate({ title: "ImageUserInput" }),
Schema.Struct({
+ detail: Schema.optionalKey(
+ Schema.Union([V2ThreadUnarchiveResponse__ImageDetail, Schema.Null]),
+ ),
path: Schema.String,
type: Schema.Literal("localImage").annotate({ title: "LocalImageUserInputType" }),
}).annotate({ title: "LocalImageUserInput" }),
@@ -16310,8 +17133,16 @@ export type V2TurnCompletedNotification__UserInput =
readonly text_elements?: ReadonlyArray<V2TurnCompletedNotification__TextElement>;
readonly type: "text";
}
- | { readonly type: "image"; readonly url: string }
- | { readonly path: string; readonly type: "localImage" }
+ | {
+ readonly detail?: V2TurnCompletedNotification__ImageDetail | null;
+ readonly type: "image";
+ readonly url: string;
+ }
+ | {
+ readonly detail?: V2TurnCompletedNotification__ImageDetail | null;
+ readonly path: string;
+ readonly type: "localImage";
+ }
| { readonly name: string; readonly path: string; readonly type: "skill" }
| { readonly name: string; readonly path: string; readonly type: "mention" };
export const V2TurnCompletedNotification__UserInput = Schema.Union(
@@ -16327,10 +17158,16 @@ export const V2TurnCompletedNotification__UserInput = Schema.Union(
type: Schema.Literal("text").annotate({ title: "TextUserInputType" }),
}).annotate({ title: "TextUserInput" }),
Schema.Struct({
+ detail: Schema.optionalKey(
+ Schema.Union([V2TurnCompletedNotification__ImageDetail, Schema.Null]),
+ ),
type: Schema.Literal("image").annotate({ title: "ImageUserInputType" }),
url: Schema.String,
}).annotate({ title: "ImageUserInput" }),
Schema.Struct({
+ detail: Schema.optionalKey(
+ Schema.Union([V2TurnCompletedNotification__ImageDetail, Schema.Null]),
+ ),
path: Schema.String,
type: Schema.Literal("localImage").annotate({ title: "LocalImageUserInputType" }),
}).annotate({ title: "LocalImageUserInput" }),
@@ -16542,8 +17379,16 @@ export type V2TurnStartedNotification__UserInput =
readonly text_elements?: ReadonlyArray<V2TurnStartedNotification__TextElement>;
readonly type: "text";
}
- | { readonly type: "image"; readonly url: string }
- | { readonly path: string; readonly type: "localImage" }
+ | {
+ readonly detail?: V2TurnStartedNotification__ImageDetail | null;
+ readonly type: "image";
+ readonly url: string;
+ }
+ | {
+ readonly detail?: V2TurnStartedNotification__ImageDetail | null;
+ readonly path: string;
+ readonly type: "localImage";
+ }
| { readonly name: string; readonly path: string; readonly type: "skill" }
| { readonly name: string; readonly path: string; readonly type: "mention" };
export const V2TurnStartedNotification__UserInput = Schema.Union(
@@ -16559,10 +17404,16 @@ export const V2TurnStartedNotification__UserInput = Schema.Union(
type: Schema.Literal("text").annotate({ title: "TextUserInputType" }),
}).annotate({ title: "TextUserInput" }),
Schema.Struct({
+ detail: Schema.optionalKey(
+ Schema.Union([V2TurnStartedNotification__ImageDetail, Schema.Null]),
+ ),
type: Schema.Literal("image").annotate({ title: "ImageUserInputType" }),
url: Schema.String,
}).annotate({ title: "ImageUserInput" }),
Schema.Struct({
+ detail: Schema.optionalKey(
+ Schema.Union([V2TurnStartedNotification__ImageDetail, Schema.Null]),
+ ),
path: Schema.String,
type: Schema.Literal("localImage").annotate({ title: "LocalImageUserInputType" }),
}).annotate({ title: "LocalImageUserInput" }),
@@ -16580,25 +17431,6 @@ export const V2TurnStartedNotification__UserInput = Schema.Union(
{ mode: "oneOf" },
);
-export type V2TurnStartParams__PermissionProfileModificationParams = {
- readonly path: V2TurnStartParams__AbsolutePathBuf;
- readonly type: "additionalWritableRoot";
-};
-export const V2TurnStartParams__PermissionProfileModificationParams = Schema.Union(
- [
- Schema.Struct({
- path: V2TurnStartParams__AbsolutePathBuf,
- type: Schema.Literal("additionalWritableRoot").annotate({
- title: "AdditionalWritableRootPermissionProfileModificationParamsType",
- }),
- }).annotate({
- title: "AdditionalWritableRootPermissionProfileModificationParams",
- description: "Additional concrete directory that should be writable.",
- }),
- ],
- { mode: "oneOf" },
-);
-
export type V2TurnStartParams__SandboxPolicy =
| { readonly type: "dangerFullAccess" }
| { readonly networkAccess?: boolean; readonly type: "readOnly" }
@@ -16661,8 +17493,16 @@ export type V2TurnStartParams__UserInput =
readonly text_elements?: ReadonlyArray<V2TurnStartParams__TextElement>;
readonly type: "text";
}
- | { readonly type: "image"; readonly url: string }
- | { readonly path: string; readonly type: "localImage" }
+ | {
+ readonly detail?: V2TurnStartParams__ImageDetail | null;
+ readonly type: "image";
+ readonly url: string;
+ }
+ | {
+ readonly detail?: V2TurnStartParams__ImageDetail | null;
+ readonly path: string;
+ readonly type: "localImage";
+ }
| { readonly name: string; readonly path: string; readonly type: "skill" }
| { readonly name: string; readonly path: string; readonly type: "mention" };
export const V2TurnStartParams__UserInput = Schema.Union(
@@ -16678,10 +17518,12 @@ export const V2TurnStartParams__UserInput = Schema.Union(
type: Schema.Literal("text").annotate({ title: "TextUserInputType" }),
}).annotate({ title: "TextUserInput" }),
Schema.Struct({
+ detail: Schema.optionalKey(Schema.Union([V2TurnStartParams__ImageDetail, Schema.Null])),
type: Schema.Literal("image").annotate({ title: "ImageUserInputType" }),
url: Schema.String,
}).annotate({ title: "ImageUserInput" }),
Schema.Struct({
+ detail: Schema.optionalKey(Schema.Union([V2TurnStartParams__ImageDetail, Schema.Null])),
path: Schema.String,
type: Schema.Literal("localImage").annotate({ title: "LocalImageUserInputType" }),
}).annotate({ title: "LocalImageUserInput" }),
@@ -16884,8 +17726,16 @@ export type V2TurnStartResponse__UserInput =
readonly text_elements?: ReadonlyArray<V2TurnStartResponse__TextElement>;
readonly type: "text";
}
- | { readonly type: "image"; readonly url: string }
- | { readonly path: string; readonly type: "localImage" }
+ | {
+ readonly detail?: V2TurnStartResponse__ImageDetail | null;
+ readonly type: "image";
+ readonly url: string;
+ }
+ | {
+ readonly detail?: V2TurnStartResponse__ImageDetail | null;
+ readonly path: string;
+ readonly type: "localImage";
+ }
| { readonly name: string; readonly path: string; readonly type: "skill" }
| { readonly name: string; readonly path: string; readonly type: "mention" };
export const V2TurnStartResponse__UserInput = Schema.Union(
@@ -16901,10 +17751,12 @@ export const V2TurnStartResponse__UserInput = Schema.Union(
type: Schema.Literal("text").annotate({ title: "TextUserInputType" }),
}).annotate({ title: "TextUserInput" }),
Schema.Struct({
+ detail: Schema.optionalKey(Schema.Union([V2TurnStartResponse__ImageDetail, Schema.Null])),
type: Schema.Literal("image").annotate({ title: "ImageUserInputType" }),
url: Schema.String,
}).annotate({ title: "ImageUserInput" }),
Schema.Struct({
+ detail: Schema.optionalKey(Schema.Union([V2TurnStartResponse__ImageDetail, Schema.Null])),
path: Schema.String,
type: Schema.Literal("localImage").annotate({ title: "LocalImageUserInputType" }),
}).annotate({ title: "LocalImageUserInput" }),
@@ -16928,8 +17780,16 @@ export type V2TurnSteerParams__UserInput =
readonly text_elements?: ReadonlyArray<V2TurnSteerParams__TextElement>;
readonly type: "text";
}
- | { readonly type: "image"; readonly url: string }
- | { readonly path: string; readonly type: "localImage" }
+ | {
+ readonly detail?: V2TurnSteerParams__ImageDetail | null;
+ readonly type: "image";
+ readonly url: string;
+ }
+ | {
+ readonly detail?: V2TurnSteerParams__ImageDetail | null;
+ readonly path: string;
+ readonly type: "localImage";
+ }
| { readonly name: string; readonly path: string; readonly type: "skill" }
| { readonly name: string; readonly path: string; readonly type: "mention" };
export const V2TurnSteerParams__UserInput = Schema.Union(
@@ -16945,10 +17805,12 @@ export const V2TurnSteerParams__UserInput = Schema.Union(
type: Schema.Literal("text").annotate({ title: "TextUserInputType" }),
}).annotate({ title: "TextUserInput" }),
Schema.Struct({
+ detail: Schema.optionalKey(Schema.Union([V2TurnSteerParams__ImageDetail, Schema.Null])),
type: Schema.Literal("image").annotate({ title: "ImageUserInputType" }),
url: Schema.String,
}).annotate({ title: "ImageUserInput" }),
Schema.Struct({
+ detail: Schema.optionalKey(Schema.Union([V2TurnSteerParams__ImageDetail, Schema.Null])),
path: Schema.String,
type: Schema.Literal("localImage").annotate({ title: "LocalImageUserInputType" }),
}).annotate({ title: "LocalImageUserInput" }),
@@ -17136,15 +17998,6 @@ export const ClientRequest__CommandExecParams = Schema.Struct({
"Run a standalone command (argv vector) in the server sandbox without creating a thread or turn.\n\nThe final `command/exec` response is deferred until the process exits and is sent only after all `command/exec/outputDelta` notifications for that connection have been emitted.",
});
-export type ClientRequest__FileSystemSandboxEntry = {
- readonly access: ClientRequest__FileSystemAccessMode;
- readonly path: ClientRequest__FileSystemPath;
-};
-export const ClientRequest__FileSystemSandboxEntry = Schema.Struct({
- access: ClientRequest__FileSystemAccessMode,
- path: ClientRequest__FileSystemPath,
-});
-
export type ClientRequest__FunctionCallOutputBody =
| string
| ReadonlyArray<ClientRequest__FunctionCallOutputContentItem>;
@@ -17197,10 +18050,12 @@ export const ClientRequest__PluginShareSaveParams = Schema.Struct({
});
export type ClientRequest__PluginShareUpdateTargetsParams = {
+ readonly discoverability: ClientRequest__PluginShareUpdateDiscoverability;
readonly remotePluginId: string;
readonly shareTargets: ReadonlyArray<ClientRequest__PluginShareTarget>;
};
export const ClientRequest__PluginShareUpdateTargetsParams = Schema.Struct({
+ discoverability: ClientRequest__PluginShareUpdateDiscoverability,
remotePluginId: Schema.String,
shareTargets: Schema.Array(ClientRequest__PluginShareTarget),
});
@@ -17229,6 +18084,7 @@ export const ClientRequest__ExternalAgentConfigMigrationItem = Schema.Struct({
export type ClientRequest__TurnStartParams = {
readonly approvalPolicy?: ClientRequest__AskForApproval | null;
readonly approvalsReviewer?: ClientRequest__ApprovalsReviewer | null;
+ readonly clientUserMessageId?: string | null;
readonly cwd?: string | null;
readonly effort?: ClientRequest__ReasoningEffort | null;
readonly input: ReadonlyArray<ClientRequest__UserInput>;
@@ -17252,6 +18108,7 @@ export const ClientRequest__TurnStartParams = Schema.Struct({
"Override where approval requests are routed for review on this turn and subsequent turns.",
}),
),
+ clientUserMessageId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
cwd: Schema.optionalKey(
Schema.Union([
Schema.String.annotate({
@@ -17307,11 +18164,13 @@ export const ClientRequest__TurnStartParams = Schema.Struct({
});
export type ClientRequest__TurnSteerParams = {
+ readonly clientUserMessageId?: string | null;
readonly expectedTurnId: string;
readonly input: ReadonlyArray<ClientRequest__UserInput>;
readonly threadId: string;
};
export const ClientRequest__TurnSteerParams = Schema.Struct({
+ clientUserMessageId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
expectedTurnId: Schema.String.annotate({
description:
"Required active turn id precondition. The request fails when it does not match the currently active turn.",
@@ -17610,6 +18469,7 @@ export type ServerNotification__HookRunSummary = {
| "sessionFlags"
| "plugin"
| "cloudRequirements"
+ | "cloudManagedConfig"
| "legacyManagedConfigFile"
| "legacyManagedConfigMdm"
| "unknown";
@@ -17641,6 +18501,7 @@ export const ServerNotification__HookRunSummary = Schema.Struct({
"sessionFlags",
"plugin",
"cloudRequirements",
+ "cloudManagedConfig",
"legacyManagedConfigFile",
"legacyManagedConfigMdm",
"unknown",
@@ -17678,15 +18539,28 @@ export const ServerNotification__FileChangePatchUpdatedNotification = Schema.Str
turnId: Schema.String,
});
+export type ServerNotification__CollaborationMode = {
+ readonly mode: ServerNotification__ModeKind;
+ readonly settings: ServerNotification__Settings;
+};
+export const ServerNotification__CollaborationMode = Schema.Struct({
+ mode: ServerNotification__ModeKind,
+ settings: ServerNotification__Settings,
+}).annotate({ description: "Collaboration mode for a Codex session." });
+
export type ServerNotification__AccountRateLimitsUpdatedNotification = {
readonly rateLimits: ServerNotification__RateLimitSnapshot;
};
export const ServerNotification__AccountRateLimitsUpdatedNotification = Schema.Struct({
rateLimits: ServerNotification__RateLimitSnapshot,
+}).annotate({
+ description:
+ "Sparse rolling rate-limit update.\n\nClients should merge available values into the most recent `account/rateLimits/read` response or refetch that snapshot. Nullable account metadata may be unavailable in a rolling update and does not clear a previously observed value.",
});
export type ServerNotification__ThreadItem =
| {
+ readonly clientId?: string | null;
readonly content: ReadonlyArray<ServerNotification__UserInput>;
readonly id: string;
readonly type: "userMessage";
@@ -17735,6 +18609,7 @@ export type ServerNotification__ThreadItem =
readonly error?: ServerNotification__McpToolCallError | null;
readonly id: string;
readonly mcpAppResourceUri?: string | null;
+ readonly pluginId?: string | null;
readonly result?: ServerNotification__McpToolCallResult | null;
readonly server: string;
readonly status: ServerNotification__McpToolCallStatus;
@@ -17764,6 +18639,13 @@ export type ServerNotification__ThreadItem =
readonly tool: "spawnAgent" | "sendInput" | "resumeAgent" | "wait" | "closeAgent";
readonly type: "collabAgentToolCall";
}
+ | {
+ readonly agentPath: string;
+ readonly agentThreadId: string;
+ readonly id: string;
+ readonly kind: ServerNotification__SubAgentActivityKind;
+ readonly type: "subAgentActivity";
+ }
| {
readonly action?: ServerNotification__WebSearchAction | null;
readonly id: string;
@@ -17789,6 +18671,7 @@ export type ServerNotification__ThreadItem =
export const ServerNotification__ThreadItem = Schema.Union(
[
Schema.Struct({
+ clientId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
content: Schema.Array(ServerNotification__UserInput),
id: Schema.String,
type: Schema.Literal("userMessage").annotate({ title: "UserMessageThreadItemType" }),
@@ -17900,6 +18783,7 @@ export const ServerNotification__ThreadItem = Schema.Union(
error: Schema.optionalKey(Schema.Union([ServerNotification__McpToolCallError, Schema.Null])),
id: Schema.String,
mcpAppResourceUri: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ pluginId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
result: Schema.optionalKey(
Schema.Union([ServerNotification__McpToolCallResult, Schema.Null]),
),
@@ -17979,6 +18863,15 @@ export const ServerNotification__ThreadItem = Schema.Union(
title: "CollabAgentToolCallThreadItemType",
}),
}).annotate({ title: "CollabAgentToolCallThreadItem" }),
+ Schema.Struct({
+ agentPath: Schema.String,
+ agentThreadId: Schema.String,
+ id: Schema.String,
+ kind: ServerNotification__SubAgentActivityKind,
+ type: Schema.Literal("subAgentActivity").annotate({
+ title: "SubAgentActivityThreadItemType",
+ }),
+ }).annotate({ title: "SubAgentActivityThreadItem" }),
Schema.Struct({
action: Schema.optionalKey(Schema.Union([ServerNotification__WebSearchAction, Schema.Null])),
id: Schema.String,
@@ -18190,6 +19083,7 @@ export type ServerRequest__CommandExecutionRequestApprovalParams = {
readonly proposedExecpolicyAmendment?: ReadonlyArray<string> | null;
readonly proposedNetworkPolicyAmendments?: ReadonlyArray<ServerRequest__NetworkPolicyAmendment> | null;
readonly reason?: string | null;
+ readonly startedAtMs: number;
readonly threadId: string;
readonly turnId: string;
};
@@ -18254,6 +19148,10 @@ export const ServerRequest__CommandExecutionRequestApprovalParams = Schema.Struc
Schema.Null,
]),
),
+ startedAtMs: Schema.Number.annotate({
+ description: "Unix timestamp (in milliseconds) when this approval request started.",
+ format: "int64",
+ }).check(Schema.isInt()),
threadId: Schema.String,
turnId: Schema.String,
});
@@ -18353,15 +19251,6 @@ export const V2AppsListResponse__AppInfo = Schema.Struct({
pluginDisplayNames: Schema.optionalKey(Schema.Array(Schema.String).annotate({ default: [] })),
}).annotate({ description: "EXPERIMENTAL - app metadata returned by app-list APIs." });
-export type V2CommandExecParams__FileSystemSandboxEntry = {
- readonly access: V2CommandExecParams__FileSystemAccessMode;
- readonly path: V2CommandExecParams__FileSystemPath;
-};
-export const V2CommandExecParams__FileSystemSandboxEntry = Schema.Struct({
- access: V2CommandExecParams__FileSystemAccessMode,
- path: V2CommandExecParams__FileSystemPath,
-});
-
export type V2ConfigReadResponse__ConfigLayer = {
readonly config: unknown;
readonly disabledReason?: string | null;
@@ -18385,11 +19274,9 @@ export const V2ConfigReadResponse__ConfigLayerMetadata = Schema.Struct({
});
export type V2ConfigReadResponse__ToolsV2 = {
- readonly view_image?: boolean | null;
readonly web_search?: V2ConfigReadResponse__WebSearchToolConfig | null;
};
export const V2ConfigReadResponse__ToolsV2 = Schema.Struct({
- view_image: Schema.optionalKey(Schema.Union([Schema.Boolean, Schema.Null])),
web_search: Schema.optionalKey(
Schema.Union([V2ConfigReadResponse__WebSearchToolConfig, Schema.Null]),
),
@@ -18481,6 +19368,7 @@ export type V2HookCompletedNotification__HookRunSummary = {
| "sessionFlags"
| "plugin"
| "cloudRequirements"
+ | "cloudManagedConfig"
| "legacyManagedConfigFile"
| "legacyManagedConfigMdm"
| "unknown";
@@ -18512,6 +19400,7 @@ export const V2HookCompletedNotification__HookRunSummary = Schema.Struct({
"sessionFlags",
"plugin",
"cloudRequirements",
+ "cloudManagedConfig",
"legacyManagedConfigFile",
"legacyManagedConfigMdm",
"unknown",
@@ -18554,6 +19443,7 @@ export type V2HookStartedNotification__HookRunSummary = {
| "sessionFlags"
| "plugin"
| "cloudRequirements"
+ | "cloudManagedConfig"
| "legacyManagedConfigFile"
| "legacyManagedConfigMdm"
| "unknown";
@@ -18585,6 +19475,7 @@ export const V2HookStartedNotification__HookRunSummary = Schema.Struct({
"sessionFlags",
"plugin",
"cloudRequirements",
+ "cloudManagedConfig",
"legacyManagedConfigFile",
"legacyManagedConfigMdm",
"unknown",
@@ -18598,6 +19489,7 @@ export const V2HookStartedNotification__HookRunSummary = Schema.Struct({
export type V2ItemCompletedNotification__ThreadItem =
| {
+ readonly clientId?: string | null;
readonly content: ReadonlyArray<V2ItemCompletedNotification__UserInput>;
readonly id: string;
readonly type: "userMessage";
@@ -18646,6 +19538,7 @@ export type V2ItemCompletedNotification__ThreadItem =
readonly error?: V2ItemCompletedNotification__McpToolCallError | null;
readonly id: string;
readonly mcpAppResourceUri?: string | null;
+ readonly pluginId?: string | null;
readonly result?: V2ItemCompletedNotification__McpToolCallResult | null;
readonly server: string;
readonly status: V2ItemCompletedNotification__McpToolCallStatus;
@@ -18677,6 +19570,13 @@ export type V2ItemCompletedNotification__ThreadItem =
readonly tool: "spawnAgent" | "sendInput" | "resumeAgent" | "wait" | "closeAgent";
readonly type: "collabAgentToolCall";
}
+ | {
+ readonly agentPath: string;
+ readonly agentThreadId: string;
+ readonly id: string;
+ readonly kind: V2ItemCompletedNotification__SubAgentActivityKind;
+ readonly type: "subAgentActivity";
+ }
| {
readonly action?: V2ItemCompletedNotification__WebSearchAction | null;
readonly id: string;
@@ -18702,6 +19602,7 @@ export type V2ItemCompletedNotification__ThreadItem =
export const V2ItemCompletedNotification__ThreadItem = Schema.Union(
[
Schema.Struct({
+ clientId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
content: Schema.Array(V2ItemCompletedNotification__UserInput),
id: Schema.String,
type: Schema.Literal("userMessage").annotate({ title: "UserMessageThreadItemType" }),
@@ -18817,6 +19718,7 @@ export const V2ItemCompletedNotification__ThreadItem = Schema.Union(
),
id: Schema.String,
mcpAppResourceUri: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ pluginId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
result: Schema.optionalKey(
Schema.Union([V2ItemCompletedNotification__McpToolCallResult, Schema.Null]),
),
@@ -18897,6 +19799,15 @@ export const V2ItemCompletedNotification__ThreadItem = Schema.Union(
title: "CollabAgentToolCallThreadItemType",
}),
}).annotate({ title: "CollabAgentToolCallThreadItem" }),
+ Schema.Struct({
+ agentPath: Schema.String,
+ agentThreadId: Schema.String,
+ id: Schema.String,
+ kind: V2ItemCompletedNotification__SubAgentActivityKind,
+ type: Schema.Literal("subAgentActivity").annotate({
+ title: "SubAgentActivityThreadItemType",
+ }),
+ }).annotate({ title: "SubAgentActivityThreadItem" }),
Schema.Struct({
action: Schema.optionalKey(
Schema.Union([V2ItemCompletedNotification__WebSearchAction, Schema.Null]),
@@ -18966,6 +19877,7 @@ export const V2ItemGuardianApprovalReviewStartedNotification__FileSystemSandboxE
export type V2ItemStartedNotification__ThreadItem =
| {
+ readonly clientId?: string | null;
readonly content: ReadonlyArray<V2ItemStartedNotification__UserInput>;
readonly id: string;
readonly type: "userMessage";
@@ -19014,6 +19926,7 @@ export type V2ItemStartedNotification__ThreadItem =
readonly error?: V2ItemStartedNotification__McpToolCallError | null;
readonly id: string;
readonly mcpAppResourceUri?: string | null;
+ readonly pluginId?: string | null;
readonly result?: V2ItemStartedNotification__McpToolCallResult | null;
readonly server: string;
readonly status: V2ItemStartedNotification__McpToolCallStatus;
@@ -19043,6 +19956,13 @@ export type V2ItemStartedNotification__ThreadItem =
readonly tool: "spawnAgent" | "sendInput" | "resumeAgent" | "wait" | "closeAgent";
readonly type: "collabAgentToolCall";
}
+ | {
+ readonly agentPath: string;
+ readonly agentThreadId: string;
+ readonly id: string;
+ readonly kind: V2ItemStartedNotification__SubAgentActivityKind;
+ readonly type: "subAgentActivity";
+ }
| {
readonly action?: V2ItemStartedNotification__WebSearchAction | null;
readonly id: string;
@@ -19068,6 +19988,7 @@ export type V2ItemStartedNotification__ThreadItem =
export const V2ItemStartedNotification__ThreadItem = Schema.Union(
[
Schema.Struct({
+ clientId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
content: Schema.Array(V2ItemStartedNotification__UserInput),
id: Schema.String,
type: Schema.Literal("userMessage").annotate({ title: "UserMessageThreadItemType" }),
@@ -19183,6 +20104,7 @@ export const V2ItemStartedNotification__ThreadItem = Schema.Union(
),
id: Schema.String,
mcpAppResourceUri: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ pluginId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
result: Schema.optionalKey(
Schema.Union([V2ItemStartedNotification__McpToolCallResult, Schema.Null]),
),
@@ -19263,6 +20185,15 @@ export const V2ItemStartedNotification__ThreadItem = Schema.Union(
title: "CollabAgentToolCallThreadItemType",
}),
}).annotate({ title: "CollabAgentToolCallThreadItem" }),
+ Schema.Struct({
+ agentPath: Schema.String,
+ agentThreadId: Schema.String,
+ id: Schema.String,
+ kind: V2ItemStartedNotification__SubAgentActivityKind,
+ type: Schema.Literal("subAgentActivity").annotate({
+ title: "SubAgentActivityThreadItemType",
+ }),
+ }).annotate({ title: "SubAgentActivityThreadItem" }),
Schema.Struct({
action: Schema.optionalKey(
Schema.Union([V2ItemStartedNotification__WebSearchAction, Schema.Null]),
@@ -19314,6 +20245,7 @@ export type V2ModelListResponse__Model = {
readonly additionalSpeedTiers?: ReadonlyArray<string>;
readonly availabilityNux?: V2ModelListResponse__ModelAvailabilityNux | null;
readonly defaultReasoningEffort: V2ModelListResponse__ReasoningEffort;
+ readonly defaultServiceTier?: string | null;
readonly description: string;
readonly displayName: string;
readonly hidden: boolean;
@@ -19338,6 +20270,14 @@ export const V2ModelListResponse__Model = Schema.Struct({
Schema.Union([V2ModelListResponse__ModelAvailabilityNux, Schema.Null]),
),
defaultReasoningEffort: V2ModelListResponse__ReasoningEffort,
+ defaultServiceTier: Schema.optionalKey(
+ Schema.Union([
+ Schema.String.annotate({
+ description: "Catalog default service tier id for this model, when one is configured.",
+ }),
+ Schema.Null,
+ ]),
+ ),
description: Schema.String,
displayName: Schema.String,
hidden: Schema.Boolean,
@@ -19358,18 +20298,61 @@ export const V2ModelListResponse__Model = Schema.Struct({
),
});
+export type V2PluginInstalledResponse__PluginShareContext = {
+ readonly creatorAccountUserId?: string | null;
+ readonly creatorName?: string | null;
+ readonly discoverability?: V2PluginInstalledResponse__PluginShareDiscoverability | null;
+ readonly remotePluginId: string;
+ readonly remoteVersion?: string | null;
+ readonly sharePrincipals?: ReadonlyArray<V2PluginInstalledResponse__PluginSharePrincipal> | null;
+ readonly shareUrl?: string | null;
+};
+export const V2PluginInstalledResponse__PluginShareContext = Schema.Struct({
+ creatorAccountUserId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ creatorName: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ discoverability: Schema.optionalKey(
+ Schema.Union([V2PluginInstalledResponse__PluginShareDiscoverability, Schema.Null]),
+ ),
+ remotePluginId: Schema.String,
+ remoteVersion: Schema.optionalKey(
+ Schema.Union([
+ Schema.String.annotate({
+ description: "Version of the remote shared plugin release when available.",
+ }),
+ Schema.Null,
+ ]),
+ ),
+ sharePrincipals: Schema.optionalKey(
+ Schema.Union([Schema.Array(V2PluginInstalledResponse__PluginSharePrincipal), Schema.Null]),
+ ),
+ shareUrl: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+});
+
export type V2PluginListResponse__PluginShareContext = {
readonly creatorAccountUserId?: string | null;
readonly creatorName?: string | null;
+ readonly discoverability?: V2PluginListResponse__PluginShareDiscoverability | null;
readonly remotePluginId: string;
- readonly shareTargets?: ReadonlyArray<V2PluginListResponse__PluginSharePrincipal> | null;
+ readonly remoteVersion?: string | null;
+ readonly sharePrincipals?: ReadonlyArray<V2PluginListResponse__PluginSharePrincipal> | null;
readonly shareUrl?: string | null;
};
export const V2PluginListResponse__PluginShareContext = Schema.Struct({
creatorAccountUserId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
creatorName: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ discoverability: Schema.optionalKey(
+ Schema.Union([V2PluginListResponse__PluginShareDiscoverability, Schema.Null]),
+ ),
remotePluginId: Schema.String,
- shareTargets: Schema.optionalKey(
+ remoteVersion: Schema.optionalKey(
+ Schema.Union([
+ Schema.String.annotate({
+ description: "Version of the remote shared plugin release when available.",
+ }),
+ Schema.Null,
+ ]),
+ ),
+ sharePrincipals: Schema.optionalKey(
Schema.Union([Schema.Array(V2PluginListResponse__PluginSharePrincipal), Schema.Null]),
),
shareUrl: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
@@ -19395,15 +20378,28 @@ export const V2PluginReadResponse__SkillSummary = Schema.Struct({
export type V2PluginReadResponse__PluginShareContext = {
readonly creatorAccountUserId?: string | null;
readonly creatorName?: string | null;
+ readonly discoverability?: V2PluginReadResponse__PluginShareDiscoverability | null;
readonly remotePluginId: string;
- readonly shareTargets?: ReadonlyArray<V2PluginReadResponse__PluginSharePrincipal> | null;
+ readonly remoteVersion?: string | null;
+ readonly sharePrincipals?: ReadonlyArray<V2PluginReadResponse__PluginSharePrincipal> | null;
readonly shareUrl?: string | null;
};
export const V2PluginReadResponse__PluginShareContext = Schema.Struct({
creatorAccountUserId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
creatorName: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ discoverability: Schema.optionalKey(
+ Schema.Union([V2PluginReadResponse__PluginShareDiscoverability, Schema.Null]),
+ ),
remotePluginId: Schema.String,
- shareTargets: Schema.optionalKey(
+ remoteVersion: Schema.optionalKey(
+ Schema.Union([
+ Schema.String.annotate({
+ description: "Version of the remote shared plugin release when available.",
+ }),
+ Schema.Null,
+ ]),
+ ),
+ sharePrincipals: Schema.optionalKey(
Schema.Union([Schema.Array(V2PluginReadResponse__PluginSharePrincipal), Schema.Null]),
),
shareUrl: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
@@ -19412,15 +20408,28 @@ export const V2PluginReadResponse__PluginShareContext = Schema.Struct({
export type V2PluginShareListResponse__PluginShareContext = {
readonly creatorAccountUserId?: string | null;
readonly creatorName?: string | null;
+ readonly discoverability?: V2PluginShareListResponse__PluginShareDiscoverability | null;
readonly remotePluginId: string;
- readonly shareTargets?: ReadonlyArray<V2PluginShareListResponse__PluginSharePrincipal> | null;
+ readonly remoteVersion?: string | null;
+ readonly sharePrincipals?: ReadonlyArray<V2PluginShareListResponse__PluginSharePrincipal> | null;
readonly shareUrl?: string | null;
};
export const V2PluginShareListResponse__PluginShareContext = Schema.Struct({
creatorAccountUserId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
creatorName: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ discoverability: Schema.optionalKey(
+ Schema.Union([V2PluginShareListResponse__PluginShareDiscoverability, Schema.Null]),
+ ),
remotePluginId: Schema.String,
- shareTargets: Schema.optionalKey(
+ remoteVersion: Schema.optionalKey(
+ Schema.Union([
+ Schema.String.annotate({
+ description: "Version of the remote shared plugin release when available.",
+ }),
+ Schema.Null,
+ ]),
+ ),
+ sharePrincipals: Schema.optionalKey(
Schema.Union([Schema.Array(V2PluginShareListResponse__PluginSharePrincipal), Schema.Null]),
),
shareUrl: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
@@ -19449,6 +20458,7 @@ export const V2ReviewStartResponse__TurnError = Schema.Struct({
export type V2ReviewStartResponse__ThreadItem =
| {
+ readonly clientId?: string | null;
readonly content: ReadonlyArray<V2ReviewStartResponse__UserInput>;
readonly id: string;
readonly type: "userMessage";
@@ -19497,6 +20507,7 @@ export type V2ReviewStartResponse__ThreadItem =
readonly error?: V2ReviewStartResponse__McpToolCallError | null;
readonly id: string;
readonly mcpAppResourceUri?: string | null;
+ readonly pluginId?: string | null;
readonly result?: V2ReviewStartResponse__McpToolCallResult | null;
readonly server: string;
readonly status: V2ReviewStartResponse__McpToolCallStatus;
@@ -19526,6 +20537,13 @@ export type V2ReviewStartResponse__ThreadItem =
readonly tool: "spawnAgent" | "sendInput" | "resumeAgent" | "wait" | "closeAgent";
readonly type: "collabAgentToolCall";
}
+ | {
+ readonly agentPath: string;
+ readonly agentThreadId: string;
+ readonly id: string;
+ readonly kind: V2ReviewStartResponse__SubAgentActivityKind;
+ readonly type: "subAgentActivity";
+ }
| {
readonly action?: V2ReviewStartResponse__WebSearchAction | null;
readonly id: string;
@@ -19551,6 +20569,7 @@ export type V2ReviewStartResponse__ThreadItem =
export const V2ReviewStartResponse__ThreadItem = Schema.Union(
[
Schema.Struct({
+ clientId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
content: Schema.Array(V2ReviewStartResponse__UserInput),
id: Schema.String,
type: Schema.Literal("userMessage").annotate({ title: "UserMessageThreadItemType" }),
@@ -19664,6 +20683,7 @@ export const V2ReviewStartResponse__ThreadItem = Schema.Union(
),
id: Schema.String,
mcpAppResourceUri: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ pluginId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
result: Schema.optionalKey(
Schema.Union([V2ReviewStartResponse__McpToolCallResult, Schema.Null]),
),
@@ -19743,6 +20763,15 @@ export const V2ReviewStartResponse__ThreadItem = Schema.Union(
title: "CollabAgentToolCallThreadItemType",
}),
}).annotate({ title: "CollabAgentToolCallThreadItem" }),
+ Schema.Struct({
+ agentPath: Schema.String,
+ agentThreadId: Schema.String,
+ id: Schema.String,
+ kind: V2ReviewStartResponse__SubAgentActivityKind,
+ type: Schema.Literal("subAgentActivity").annotate({
+ title: "SubAgentActivityThreadItemType",
+ }),
+ }).annotate({ title: "SubAgentActivityThreadItem" }),
Schema.Struct({
action: Schema.optionalKey(
Schema.Union([V2ReviewStartResponse__WebSearchAction, Schema.Null]),
@@ -19821,15 +20850,6 @@ export const V2SkillsListResponse__SkillMetadata = Schema.Struct({
),
});
-export type V2ThreadForkResponse__FileSystemSandboxEntry = {
- readonly access: V2ThreadForkResponse__FileSystemAccessMode;
- readonly path: V2ThreadForkResponse__FileSystemPath;
-};
-export const V2ThreadForkResponse__FileSystemSandboxEntry = Schema.Struct({
- access: V2ThreadForkResponse__FileSystemAccessMode,
- path: V2ThreadForkResponse__FileSystemPath,
-});
-
export type V2ThreadForkResponse__TurnError = {
readonly additionalDetails?: string | null;
readonly codexErrorInfo?: V2ThreadForkResponse__CodexErrorInfo | null;
@@ -19845,6 +20865,7 @@ export const V2ThreadForkResponse__TurnError = Schema.Struct({
export type V2ThreadForkResponse__ThreadItem =
| {
+ readonly clientId?: string | null;
readonly content: ReadonlyArray<V2ThreadForkResponse__UserInput>;
readonly id: string;
readonly type: "userMessage";
@@ -19893,6 +20914,7 @@ export type V2ThreadForkResponse__ThreadItem =
readonly error?: V2ThreadForkResponse__McpToolCallError | null;
readonly id: string;
readonly mcpAppResourceUri?: string | null;
+ readonly pluginId?: string | null;
readonly result?: V2ThreadForkResponse__McpToolCallResult | null;
readonly server: string;
readonly status: V2ThreadForkResponse__McpToolCallStatus;
@@ -19922,6 +20944,13 @@ export type V2ThreadForkResponse__ThreadItem =
readonly tool: "spawnAgent" | "sendInput" | "resumeAgent" | "wait" | "closeAgent";
readonly type: "collabAgentToolCall";
}
+ | {
+ readonly agentPath: string;
+ readonly agentThreadId: string;
+ readonly id: string;
+ readonly kind: V2ThreadForkResponse__SubAgentActivityKind;
+ readonly type: "subAgentActivity";
+ }
| {
readonly action?: V2ThreadForkResponse__WebSearchAction | null;
readonly id: string;
@@ -19947,6 +20976,7 @@ export type V2ThreadForkResponse__ThreadItem =
export const V2ThreadForkResponse__ThreadItem = Schema.Union(
[
Schema.Struct({
+ clientId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
content: Schema.Array(V2ThreadForkResponse__UserInput),
id: Schema.String,
type: Schema.Literal("userMessage").annotate({ title: "UserMessageThreadItemType" }),
@@ -20060,6 +21090,7 @@ export const V2ThreadForkResponse__ThreadItem = Schema.Union(
),
id: Schema.String,
mcpAppResourceUri: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ pluginId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
result: Schema.optionalKey(
Schema.Union([V2ThreadForkResponse__McpToolCallResult, Schema.Null]),
),
@@ -20139,6 +21170,15 @@ export const V2ThreadForkResponse__ThreadItem = Schema.Union(
title: "CollabAgentToolCallThreadItemType",
}),
}).annotate({ title: "CollabAgentToolCallThreadItem" }),
+ Schema.Struct({
+ agentPath: Schema.String,
+ agentThreadId: Schema.String,
+ id: Schema.String,
+ kind: V2ThreadForkResponse__SubAgentActivityKind,
+ type: Schema.Literal("subAgentActivity").annotate({
+ title: "SubAgentActivityThreadItemType",
+ }),
+ }).annotate({ title: "SubAgentActivityThreadItem" }),
Schema.Struct({
action: Schema.optionalKey(
Schema.Union([V2ThreadForkResponse__WebSearchAction, Schema.Null]),
@@ -20201,6 +21241,7 @@ export const V2ThreadListResponse__TurnError = Schema.Struct({
export type V2ThreadListResponse__ThreadItem =
| {
+ readonly clientId?: string | null;
readonly content: ReadonlyArray<V2ThreadListResponse__UserInput>;
readonly id: string;
readonly type: "userMessage";
@@ -20249,6 +21290,7 @@ export type V2ThreadListResponse__ThreadItem =
readonly error?: V2ThreadListResponse__McpToolCallError | null;
readonly id: string;
readonly mcpAppResourceUri?: string | null;
+ readonly pluginId?: string | null;
readonly result?: V2ThreadListResponse__McpToolCallResult | null;
readonly server: string;
readonly status: V2ThreadListResponse__McpToolCallStatus;
@@ -20278,6 +21320,13 @@ export type V2ThreadListResponse__ThreadItem =
readonly tool: "spawnAgent" | "sendInput" | "resumeAgent" | "wait" | "closeAgent";
readonly type: "collabAgentToolCall";
}
+ | {
+ readonly agentPath: string;
+ readonly agentThreadId: string;
+ readonly id: string;
+ readonly kind: V2ThreadListResponse__SubAgentActivityKind;
+ readonly type: "subAgentActivity";
+ }
| {
readonly action?: V2ThreadListResponse__WebSearchAction | null;
readonly id: string;
@@ -20303,6 +21352,7 @@ export type V2ThreadListResponse__ThreadItem =
export const V2ThreadListResponse__ThreadItem = Schema.Union(
[
Schema.Struct({
+ clientId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
content: Schema.Array(V2ThreadListResponse__UserInput),
id: Schema.String,
type: Schema.Literal("userMessage").annotate({ title: "UserMessageThreadItemType" }),
@@ -20416,6 +21466,7 @@ export const V2ThreadListResponse__ThreadItem = Schema.Union(
),
id: Schema.String,
mcpAppResourceUri: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ pluginId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
result: Schema.optionalKey(
Schema.Union([V2ThreadListResponse__McpToolCallResult, Schema.Null]),
),
@@ -20495,6 +21546,15 @@ export const V2ThreadListResponse__ThreadItem = Schema.Union(
title: "CollabAgentToolCallThreadItemType",
}),
}).annotate({ title: "CollabAgentToolCallThreadItem" }),
+ Schema.Struct({
+ agentPath: Schema.String,
+ agentThreadId: Schema.String,
+ id: Schema.String,
+ kind: V2ThreadListResponse__SubAgentActivityKind,
+ type: Schema.Literal("subAgentActivity").annotate({
+ title: "SubAgentActivityThreadItemType",
+ }),
+ }).annotate({ title: "SubAgentActivityThreadItem" }),
Schema.Struct({
action: Schema.optionalKey(
Schema.Union([V2ThreadListResponse__WebSearchAction, Schema.Null]),
@@ -20557,6 +21617,7 @@ export const V2ThreadMetadataUpdateResponse__TurnError = Schema.Struct({
export type V2ThreadMetadataUpdateResponse__ThreadItem =
| {
+ readonly clientId?: string | null;
readonly content: ReadonlyArray<V2ThreadMetadataUpdateResponse__UserInput>;
readonly id: string;
readonly type: "userMessage";
@@ -20605,6 +21666,7 @@ export type V2ThreadMetadataUpdateResponse__ThreadItem =
readonly error?: V2ThreadMetadataUpdateResponse__McpToolCallError | null;
readonly id: string;
readonly mcpAppResourceUri?: string | null;
+ readonly pluginId?: string | null;
readonly result?: V2ThreadMetadataUpdateResponse__McpToolCallResult | null;
readonly server: string;
readonly status: V2ThreadMetadataUpdateResponse__McpToolCallStatus;
@@ -20636,6 +21698,13 @@ export type V2ThreadMetadataUpdateResponse__ThreadItem =
readonly tool: "spawnAgent" | "sendInput" | "resumeAgent" | "wait" | "closeAgent";
readonly type: "collabAgentToolCall";
}
+ | {
+ readonly agentPath: string;
+ readonly agentThreadId: string;
+ readonly id: string;
+ readonly kind: V2ThreadMetadataUpdateResponse__SubAgentActivityKind;
+ readonly type: "subAgentActivity";
+ }
| {
readonly action?: V2ThreadMetadataUpdateResponse__WebSearchAction | null;
readonly id: string;
@@ -20661,6 +21730,7 @@ export type V2ThreadMetadataUpdateResponse__ThreadItem =
export const V2ThreadMetadataUpdateResponse__ThreadItem = Schema.Union(
[
Schema.Struct({
+ clientId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
content: Schema.Array(V2ThreadMetadataUpdateResponse__UserInput),
id: Schema.String,
type: Schema.Literal("userMessage").annotate({ title: "UserMessageThreadItemType" }),
@@ -20776,6 +21846,7 @@ export const V2ThreadMetadataUpdateResponse__ThreadItem = Schema.Union(
),
id: Schema.String,
mcpAppResourceUri: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ pluginId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
result: Schema.optionalKey(
Schema.Union([V2ThreadMetadataUpdateResponse__McpToolCallResult, Schema.Null]),
),
@@ -20856,6 +21927,15 @@ export const V2ThreadMetadataUpdateResponse__ThreadItem = Schema.Union(
title: "CollabAgentToolCallThreadItemType",
}),
}).annotate({ title: "CollabAgentToolCallThreadItem" }),
+ Schema.Struct({
+ agentPath: Schema.String,
+ agentThreadId: Schema.String,
+ id: Schema.String,
+ kind: V2ThreadMetadataUpdateResponse__SubAgentActivityKind,
+ type: Schema.Literal("subAgentActivity").annotate({
+ title: "SubAgentActivityThreadItemType",
+ }),
+ }).annotate({ title: "SubAgentActivityThreadItem" }),
Schema.Struct({
action: Schema.optionalKey(
Schema.Union([V2ThreadMetadataUpdateResponse__WebSearchAction, Schema.Null]),
@@ -20918,6 +21998,7 @@ export const V2ThreadReadResponse__TurnError = Schema.Struct({
export type V2ThreadReadResponse__ThreadItem =
| {
+ readonly clientId?: string | null;
readonly content: ReadonlyArray<V2ThreadReadResponse__UserInput>;
readonly id: string;
readonly type: "userMessage";
@@ -20966,6 +22047,7 @@ export type V2ThreadReadResponse__ThreadItem =
readonly error?: V2ThreadReadResponse__McpToolCallError | null;
readonly id: string;
readonly mcpAppResourceUri?: string | null;
+ readonly pluginId?: string | null;
readonly result?: V2ThreadReadResponse__McpToolCallResult | null;
readonly server: string;
readonly status: V2ThreadReadResponse__McpToolCallStatus;
@@ -20995,6 +22077,13 @@ export type V2ThreadReadResponse__ThreadItem =
readonly tool: "spawnAgent" | "sendInput" | "resumeAgent" | "wait" | "closeAgent";
readonly type: "collabAgentToolCall";
}
+ | {
+ readonly agentPath: string;
+ readonly agentThreadId: string;
+ readonly id: string;
+ readonly kind: V2ThreadReadResponse__SubAgentActivityKind;
+ readonly type: "subAgentActivity";
+ }
| {
readonly action?: V2ThreadReadResponse__WebSearchAction | null;
readonly id: string;
@@ -21020,6 +22109,7 @@ export type V2ThreadReadResponse__ThreadItem =
export const V2ThreadReadResponse__ThreadItem = Schema.Union(
[
Schema.Struct({
+ clientId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
content: Schema.Array(V2ThreadReadResponse__UserInput),
id: Schema.String,
type: Schema.Literal("userMessage").annotate({ title: "UserMessageThreadItemType" }),
@@ -21133,6 +22223,7 @@ export const V2ThreadReadResponse__ThreadItem = Schema.Union(
),
id: Schema.String,
mcpAppResourceUri: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ pluginId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
result: Schema.optionalKey(
Schema.Union([V2ThreadReadResponse__McpToolCallResult, Schema.Null]),
),
@@ -21212,6 +22303,15 @@ export const V2ThreadReadResponse__ThreadItem = Schema.Union(
title: "CollabAgentToolCallThreadItemType",
}),
}).annotate({ title: "CollabAgentToolCallThreadItem" }),
+ Schema.Struct({
+ agentPath: Schema.String,
+ agentThreadId: Schema.String,
+ id: Schema.String,
+ kind: V2ThreadReadResponse__SubAgentActivityKind,
+ type: Schema.Literal("subAgentActivity").annotate({
+ title: "SubAgentActivityThreadItemType",
+ }),
+ }).annotate({ title: "SubAgentActivityThreadItem" }),
Schema.Struct({
action: Schema.optionalKey(
Schema.Union([V2ThreadReadResponse__WebSearchAction, Schema.Null]),
@@ -21267,15 +22367,6 @@ export const V2ThreadResumeParams__FunctionCallOutputBody = Schema.Union([
Schema.Array(V2ThreadResumeParams__FunctionCallOutputContentItem),
]);
-export type V2ThreadResumeResponse__FileSystemSandboxEntry = {
- readonly access: V2ThreadResumeResponse__FileSystemAccessMode;
- readonly path: V2ThreadResumeResponse__FileSystemPath;
-};
-export const V2ThreadResumeResponse__FileSystemSandboxEntry = Schema.Struct({
- access: V2ThreadResumeResponse__FileSystemAccessMode,
- path: V2ThreadResumeResponse__FileSystemPath,
-});
-
export type V2ThreadResumeResponse__TurnError = {
readonly additionalDetails?: string | null;
readonly codexErrorInfo?: V2ThreadResumeResponse__CodexErrorInfo | null;
@@ -21291,6 +22382,7 @@ export const V2ThreadResumeResponse__TurnError = Schema.Struct({
export type V2ThreadResumeResponse__ThreadItem =
| {
+ readonly clientId?: string | null;
readonly content: ReadonlyArray<V2ThreadResumeResponse__UserInput>;
readonly id: string;
readonly type: "userMessage";
@@ -21339,6 +22431,7 @@ export type V2ThreadResumeResponse__ThreadItem =
readonly error?: V2ThreadResumeResponse__McpToolCallError | null;
readonly id: string;
readonly mcpAppResourceUri?: string | null;
+ readonly pluginId?: string | null;
readonly result?: V2ThreadResumeResponse__McpToolCallResult | null;
readonly server: string;
readonly status: V2ThreadResumeResponse__McpToolCallStatus;
@@ -21368,6 +22461,13 @@ export type V2ThreadResumeResponse__ThreadItem =
readonly tool: "spawnAgent" | "sendInput" | "resumeAgent" | "wait" | "closeAgent";
readonly type: "collabAgentToolCall";
}
+ | {
+ readonly agentPath: string;
+ readonly agentThreadId: string;
+ readonly id: string;
+ readonly kind: V2ThreadResumeResponse__SubAgentActivityKind;
+ readonly type: "subAgentActivity";
+ }
| {
readonly action?: V2ThreadResumeResponse__WebSearchAction | null;
readonly id: string;
@@ -21393,6 +22493,7 @@ export type V2ThreadResumeResponse__ThreadItem =
export const V2ThreadResumeResponse__ThreadItem = Schema.Union(
[
Schema.Struct({
+ clientId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
content: Schema.Array(V2ThreadResumeResponse__UserInput),
id: Schema.String,
type: Schema.Literal("userMessage").annotate({ title: "UserMessageThreadItemType" }),
@@ -21506,6 +22607,7 @@ export const V2ThreadResumeResponse__ThreadItem = Schema.Union(
),
id: Schema.String,
mcpAppResourceUri: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ pluginId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
result: Schema.optionalKey(
Schema.Union([V2ThreadResumeResponse__McpToolCallResult, Schema.Null]),
),
@@ -21585,6 +22687,15 @@ export const V2ThreadResumeResponse__ThreadItem = Schema.Union(
title: "CollabAgentToolCallThreadItemType",
}),
}).annotate({ title: "CollabAgentToolCallThreadItem" }),
+ Schema.Struct({
+ agentPath: Schema.String,
+ agentThreadId: Schema.String,
+ id: Schema.String,
+ kind: V2ThreadResumeResponse__SubAgentActivityKind,
+ type: Schema.Literal("subAgentActivity").annotate({
+ title: "SubAgentActivityThreadItemType",
+ }),
+ }).annotate({ title: "SubAgentActivityThreadItem" }),
Schema.Struct({
action: Schema.optionalKey(
Schema.Union([V2ThreadResumeResponse__WebSearchAction, Schema.Null]),
@@ -21647,6 +22758,7 @@ export const V2ThreadRollbackResponse__TurnError = Schema.Struct({
export type V2ThreadRollbackResponse__ThreadItem =
| {
+ readonly clientId?: string | null;
readonly content: ReadonlyArray<V2ThreadRollbackResponse__UserInput>;
readonly id: string;
readonly type: "userMessage";
@@ -21695,6 +22807,7 @@ export type V2ThreadRollbackResponse__ThreadItem =
readonly error?: V2ThreadRollbackResponse__McpToolCallError | null;
readonly id: string;
readonly mcpAppResourceUri?: string | null;
+ readonly pluginId?: string | null;
readonly result?: V2ThreadRollbackResponse__McpToolCallResult | null;
readonly server: string;
readonly status: V2ThreadRollbackResponse__McpToolCallStatus;
@@ -21724,6 +22837,13 @@ export type V2ThreadRollbackResponse__ThreadItem =
readonly tool: "spawnAgent" | "sendInput" | "resumeAgent" | "wait" | "closeAgent";
readonly type: "collabAgentToolCall";
}
+ | {
+ readonly agentPath: string;
+ readonly agentThreadId: string;
+ readonly id: string;
+ readonly kind: V2ThreadRollbackResponse__SubAgentActivityKind;
+ readonly type: "subAgentActivity";
+ }
| {
readonly action?: V2ThreadRollbackResponse__WebSearchAction | null;
readonly id: string;
@@ -21749,6 +22869,7 @@ export type V2ThreadRollbackResponse__ThreadItem =
export const V2ThreadRollbackResponse__ThreadItem = Schema.Union(
[
Schema.Struct({
+ clientId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
content: Schema.Array(V2ThreadRollbackResponse__UserInput),
id: Schema.String,
type: Schema.Literal("userMessage").annotate({ title: "UserMessageThreadItemType" }),
@@ -21864,6 +22985,7 @@ export const V2ThreadRollbackResponse__ThreadItem = Schema.Union(
),
id: Schema.String,
mcpAppResourceUri: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ pluginId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
result: Schema.optionalKey(
Schema.Union([V2ThreadRollbackResponse__McpToolCallResult, Schema.Null]),
),
@@ -21944,6 +23066,15 @@ export const V2ThreadRollbackResponse__ThreadItem = Schema.Union(
title: "CollabAgentToolCallThreadItemType",
}),
}).annotate({ title: "CollabAgentToolCallThreadItem" }),
+ Schema.Struct({
+ agentPath: Schema.String,
+ agentThreadId: Schema.String,
+ id: Schema.String,
+ kind: V2ThreadRollbackResponse__SubAgentActivityKind,
+ type: Schema.Literal("subAgentActivity").annotate({
+ title: "SubAgentActivityThreadItemType",
+ }),
+ }).annotate({ title: "SubAgentActivityThreadItem" }),
Schema.Struct({
action: Schema.optionalKey(
Schema.Union([V2ThreadRollbackResponse__WebSearchAction, Schema.Null]),
@@ -21991,6 +23122,15 @@ export const V2ThreadRollbackResponse__ThreadItem = Schema.Union(
{ mode: "oneOf" },
);
+export type V2ThreadSettingsUpdatedNotification__CollaborationMode = {
+ readonly mode: V2ThreadSettingsUpdatedNotification__ModeKind;
+ readonly settings: V2ThreadSettingsUpdatedNotification__Settings;
+};
+export const V2ThreadSettingsUpdatedNotification__CollaborationMode = Schema.Struct({
+ mode: V2ThreadSettingsUpdatedNotification__ModeKind,
+ settings: V2ThreadSettingsUpdatedNotification__Settings,
+}).annotate({ description: "Collaboration mode for a Codex session." });
+
export type V2ThreadStartedNotification__TurnError = {
readonly additionalDetails?: string | null;
readonly codexErrorInfo?: V2ThreadStartedNotification__CodexErrorInfo | null;
@@ -22006,6 +23146,7 @@ export const V2ThreadStartedNotification__TurnError = Schema.Struct({
export type V2ThreadStartedNotification__ThreadItem =
| {
+ readonly clientId?: string | null;
readonly content: ReadonlyArray<V2ThreadStartedNotification__UserInput>;
readonly id: string;
readonly type: "userMessage";
@@ -22054,6 +23195,7 @@ export type V2ThreadStartedNotification__ThreadItem =
readonly error?: V2ThreadStartedNotification__McpToolCallError | null;
readonly id: string;
readonly mcpAppResourceUri?: string | null;
+ readonly pluginId?: string | null;
readonly result?: V2ThreadStartedNotification__McpToolCallResult | null;
readonly server: string;
readonly status: V2ThreadStartedNotification__McpToolCallStatus;
@@ -22085,6 +23227,13 @@ export type V2ThreadStartedNotification__ThreadItem =
readonly tool: "spawnAgent" | "sendInput" | "resumeAgent" | "wait" | "closeAgent";
readonly type: "collabAgentToolCall";
}
+ | {
+ readonly agentPath: string;
+ readonly agentThreadId: string;
+ readonly id: string;
+ readonly kind: V2ThreadStartedNotification__SubAgentActivityKind;
+ readonly type: "subAgentActivity";
+ }
| {
readonly action?: V2ThreadStartedNotification__WebSearchAction | null;
readonly id: string;
@@ -22110,6 +23259,7 @@ export type V2ThreadStartedNotification__ThreadItem =
export const V2ThreadStartedNotification__ThreadItem = Schema.Union(
[
Schema.Struct({
+ clientId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
content: Schema.Array(V2ThreadStartedNotification__UserInput),
id: Schema.String,
type: Schema.Literal("userMessage").annotate({ title: "UserMessageThreadItemType" }),
@@ -22225,6 +23375,7 @@ export const V2ThreadStartedNotification__ThreadItem = Schema.Union(
),
id: Schema.String,
mcpAppResourceUri: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ pluginId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
result: Schema.optionalKey(
Schema.Union([V2ThreadStartedNotification__McpToolCallResult, Schema.Null]),
),
@@ -22305,6 +23456,15 @@ export const V2ThreadStartedNotification__ThreadItem = Schema.Union(
title: "CollabAgentToolCallThreadItemType",
}),
}).annotate({ title: "CollabAgentToolCallThreadItem" }),
+ Schema.Struct({
+ agentPath: Schema.String,
+ agentThreadId: Schema.String,
+ id: Schema.String,
+ kind: V2ThreadStartedNotification__SubAgentActivityKind,
+ type: Schema.Literal("subAgentActivity").annotate({
+ title: "SubAgentActivityThreadItemType",
+ }),
+ }).annotate({ title: "SubAgentActivityThreadItem" }),
Schema.Struct({
action: Schema.optionalKey(
Schema.Union([V2ThreadStartedNotification__WebSearchAction, Schema.Null]),
@@ -22352,15 +23512,6 @@ export const V2ThreadStartedNotification__ThreadItem = Schema.Union(
{ mode: "oneOf" },
);
-export type V2ThreadStartResponse__FileSystemSandboxEntry = {
- readonly access: V2ThreadStartResponse__FileSystemAccessMode;
- readonly path: V2ThreadStartResponse__FileSystemPath;
-};
-export const V2ThreadStartResponse__FileSystemSandboxEntry = Schema.Struct({
- access: V2ThreadStartResponse__FileSystemAccessMode,
- path: V2ThreadStartResponse__FileSystemPath,
-});
-
export type V2ThreadStartResponse__TurnError = {
readonly additionalDetails?: string | null;
readonly codexErrorInfo?: V2ThreadStartResponse__CodexErrorInfo | null;
@@ -22376,6 +23527,7 @@ export const V2ThreadStartResponse__TurnError = Schema.Struct({
export type V2ThreadStartResponse__ThreadItem =
| {
+ readonly clientId?: string | null;
readonly content: ReadonlyArray<V2ThreadStartResponse__UserInput>;
readonly id: string;
readonly type: "userMessage";
@@ -22424,6 +23576,7 @@ export type V2ThreadStartResponse__ThreadItem =
readonly error?: V2ThreadStartResponse__McpToolCallError | null;
readonly id: string;
readonly mcpAppResourceUri?: string | null;
+ readonly pluginId?: string | null;
readonly result?: V2ThreadStartResponse__McpToolCallResult | null;
readonly server: string;
readonly status: V2ThreadStartResponse__McpToolCallStatus;
@@ -22453,6 +23606,13 @@ export type V2ThreadStartResponse__ThreadItem =
readonly tool: "spawnAgent" | "sendInput" | "resumeAgent" | "wait" | "closeAgent";
readonly type: "collabAgentToolCall";
}
+ | {
+ readonly agentPath: string;
+ readonly agentThreadId: string;
+ readonly id: string;
+ readonly kind: V2ThreadStartResponse__SubAgentActivityKind;
+ readonly type: "subAgentActivity";
+ }
| {
readonly action?: V2ThreadStartResponse__WebSearchAction | null;
readonly id: string;
@@ -22478,6 +23638,7 @@ export type V2ThreadStartResponse__ThreadItem =
export const V2ThreadStartResponse__ThreadItem = Schema.Union(
[
Schema.Struct({
+ clientId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
content: Schema.Array(V2ThreadStartResponse__UserInput),
id: Schema.String,
type: Schema.Literal("userMessage").annotate({ title: "UserMessageThreadItemType" }),
@@ -22591,6 +23752,7 @@ export const V2ThreadStartResponse__ThreadItem = Schema.Union(
),
id: Schema.String,
mcpAppResourceUri: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ pluginId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
result: Schema.optionalKey(
Schema.Union([V2ThreadStartResponse__McpToolCallResult, Schema.Null]),
),
@@ -22670,6 +23832,15 @@ export const V2ThreadStartResponse__ThreadItem = Schema.Union(
title: "CollabAgentToolCallThreadItemType",
}),
}).annotate({ title: "CollabAgentToolCallThreadItem" }),
+ Schema.Struct({
+ agentPath: Schema.String,
+ agentThreadId: Schema.String,
+ id: Schema.String,
+ kind: V2ThreadStartResponse__SubAgentActivityKind,
+ type: Schema.Literal("subAgentActivity").annotate({
+ title: "SubAgentActivityThreadItemType",
+ }),
+ }).annotate({ title: "SubAgentActivityThreadItem" }),
Schema.Struct({
action: Schema.optionalKey(
Schema.Union([V2ThreadStartResponse__WebSearchAction, Schema.Null]),
@@ -22732,6 +23903,7 @@ export const V2ThreadUnarchiveResponse__TurnError = Schema.Struct({
export type V2ThreadUnarchiveResponse__ThreadItem =
| {
+ readonly clientId?: string | null;
readonly content: ReadonlyArray<V2ThreadUnarchiveResponse__UserInput>;
readonly id: string;
readonly type: "userMessage";
@@ -22780,6 +23952,7 @@ export type V2ThreadUnarchiveResponse__ThreadItem =
readonly error?: V2ThreadUnarchiveResponse__McpToolCallError | null;
readonly id: string;
readonly mcpAppResourceUri?: string | null;
+ readonly pluginId?: string | null;
readonly result?: V2ThreadUnarchiveResponse__McpToolCallResult | null;
readonly server: string;
readonly status: V2ThreadUnarchiveResponse__McpToolCallStatus;
@@ -22809,6 +23982,13 @@ export type V2ThreadUnarchiveResponse__ThreadItem =
readonly tool: "spawnAgent" | "sendInput" | "resumeAgent" | "wait" | "closeAgent";
readonly type: "collabAgentToolCall";
}
+ | {
+ readonly agentPath: string;
+ readonly agentThreadId: string;
+ readonly id: string;
+ readonly kind: V2ThreadUnarchiveResponse__SubAgentActivityKind;
+ readonly type: "subAgentActivity";
+ }
| {
readonly action?: V2ThreadUnarchiveResponse__WebSearchAction | null;
readonly id: string;
@@ -22834,6 +24014,7 @@ export type V2ThreadUnarchiveResponse__ThreadItem =
export const V2ThreadUnarchiveResponse__ThreadItem = Schema.Union(
[
Schema.Struct({
+ clientId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
content: Schema.Array(V2ThreadUnarchiveResponse__UserInput),
id: Schema.String,
type: Schema.Literal("userMessage").annotate({ title: "UserMessageThreadItemType" }),
@@ -22949,6 +24130,7 @@ export const V2ThreadUnarchiveResponse__ThreadItem = Schema.Union(
),
id: Schema.String,
mcpAppResourceUri: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ pluginId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
result: Schema.optionalKey(
Schema.Union([V2ThreadUnarchiveResponse__McpToolCallResult, Schema.Null]),
),
@@ -23029,6 +24211,15 @@ export const V2ThreadUnarchiveResponse__ThreadItem = Schema.Union(
title: "CollabAgentToolCallThreadItemType",
}),
}).annotate({ title: "CollabAgentToolCallThreadItem" }),
+ Schema.Struct({
+ agentPath: Schema.String,
+ agentThreadId: Schema.String,
+ id: Schema.String,
+ kind: V2ThreadUnarchiveResponse__SubAgentActivityKind,
+ type: Schema.Literal("subAgentActivity").annotate({
+ title: "SubAgentActivityThreadItemType",
+ }),
+ }).annotate({ title: "SubAgentActivityThreadItem" }),
Schema.Struct({
action: Schema.optionalKey(
Schema.Union([V2ThreadUnarchiveResponse__WebSearchAction, Schema.Null]),
@@ -23091,6 +24282,7 @@ export const V2TurnCompletedNotification__TurnError = Schema.Struct({
export type V2TurnCompletedNotification__ThreadItem =
| {
+ readonly clientId?: string | null;
readonly content: ReadonlyArray<V2TurnCompletedNotification__UserInput>;
readonly id: string;
readonly type: "userMessage";
@@ -23139,6 +24331,7 @@ export type V2TurnCompletedNotification__ThreadItem =
readonly error?: V2TurnCompletedNotification__McpToolCallError | null;
readonly id: string;
readonly mcpAppResourceUri?: string | null;
+ readonly pluginId?: string | null;
readonly result?: V2TurnCompletedNotification__McpToolCallResult | null;
readonly server: string;
readonly status: V2TurnCompletedNotification__McpToolCallStatus;
@@ -23170,6 +24363,13 @@ export type V2TurnCompletedNotification__ThreadItem =
readonly tool: "spawnAgent" | "sendInput" | "resumeAgent" | "wait" | "closeAgent";
readonly type: "collabAgentToolCall";
}
+ | {
+ readonly agentPath: string;
+ readonly agentThreadId: string;
+ readonly id: string;
+ readonly kind: V2TurnCompletedNotification__SubAgentActivityKind;
+ readonly type: "subAgentActivity";
+ }
| {
readonly action?: V2TurnCompletedNotification__WebSearchAction | null;
readonly id: string;
@@ -23195,6 +24395,7 @@ export type V2TurnCompletedNotification__ThreadItem =
export const V2TurnCompletedNotification__ThreadItem = Schema.Union(
[
Schema.Struct({
+ clientId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
content: Schema.Array(V2TurnCompletedNotification__UserInput),
id: Schema.String,
type: Schema.Literal("userMessage").annotate({ title: "UserMessageThreadItemType" }),
@@ -23310,6 +24511,7 @@ export const V2TurnCompletedNotification__ThreadItem = Schema.Union(
),
id: Schema.String,
mcpAppResourceUri: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ pluginId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
result: Schema.optionalKey(
Schema.Union([V2TurnCompletedNotification__McpToolCallResult, Schema.Null]),
),
@@ -23390,6 +24592,15 @@ export const V2TurnCompletedNotification__ThreadItem = Schema.Union(
title: "CollabAgentToolCallThreadItemType",
}),
}).annotate({ title: "CollabAgentToolCallThreadItem" }),
+ Schema.Struct({
+ agentPath: Schema.String,
+ agentThreadId: Schema.String,
+ id: Schema.String,
+ kind: V2TurnCompletedNotification__SubAgentActivityKind,
+ type: Schema.Literal("subAgentActivity").annotate({
+ title: "SubAgentActivityThreadItemType",
+ }),
+ }).annotate({ title: "SubAgentActivityThreadItem" }),
Schema.Struct({
action: Schema.optionalKey(
Schema.Union([V2TurnCompletedNotification__WebSearchAction, Schema.Null]),
@@ -23452,6 +24663,7 @@ export const V2TurnStartedNotification__TurnError = Schema.Struct({
export type V2TurnStartedNotification__ThreadItem =
| {
+ readonly clientId?: string | null;
readonly content: ReadonlyArray<V2TurnStartedNotification__UserInput>;
readonly id: string;
readonly type: "userMessage";
@@ -23500,6 +24712,7 @@ export type V2TurnStartedNotification__ThreadItem =
readonly error?: V2TurnStartedNotification__McpToolCallError | null;
readonly id: string;
readonly mcpAppResourceUri?: string | null;
+ readonly pluginId?: string | null;
readonly result?: V2TurnStartedNotification__McpToolCallResult | null;
readonly server: string;
readonly status: V2TurnStartedNotification__McpToolCallStatus;
@@ -23529,6 +24742,13 @@ export type V2TurnStartedNotification__ThreadItem =
readonly tool: "spawnAgent" | "sendInput" | "resumeAgent" | "wait" | "closeAgent";
readonly type: "collabAgentToolCall";
}
+ | {
+ readonly agentPath: string;
+ readonly agentThreadId: string;
+ readonly id: string;
+ readonly kind: V2TurnStartedNotification__SubAgentActivityKind;
+ readonly type: "subAgentActivity";
+ }
| {
readonly action?: V2TurnStartedNotification__WebSearchAction | null;
readonly id: string;
@@ -23554,6 +24774,7 @@ export type V2TurnStartedNotification__ThreadItem =
export const V2TurnStartedNotification__ThreadItem = Schema.Union(
[
Schema.Struct({
+ clientId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
content: Schema.Array(V2TurnStartedNotification__UserInput),
id: Schema.String,
type: Schema.Literal("userMessage").annotate({ title: "UserMessageThreadItemType" }),
@@ -23669,6 +24890,7 @@ export const V2TurnStartedNotification__ThreadItem = Schema.Union(
),
id: Schema.String,
mcpAppResourceUri: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ pluginId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
result: Schema.optionalKey(
Schema.Union([V2TurnStartedNotification__McpToolCallResult, Schema.Null]),
),
@@ -23749,6 +24971,15 @@ export const V2TurnStartedNotification__ThreadItem = Schema.Union(
title: "CollabAgentToolCallThreadItemType",
}),
}).annotate({ title: "CollabAgentToolCallThreadItem" }),
+ Schema.Struct({
+ agentPath: Schema.String,
+ agentThreadId: Schema.String,
+ id: Schema.String,
+ kind: V2TurnStartedNotification__SubAgentActivityKind,
+ type: Schema.Literal("subAgentActivity").annotate({
+ title: "SubAgentActivityThreadItemType",
+ }),
+ }).annotate({ title: "SubAgentActivityThreadItem" }),
Schema.Struct({
action: Schema.optionalKey(
Schema.Union([V2TurnStartedNotification__WebSearchAction, Schema.Null]),
@@ -23811,6 +25042,7 @@ export const V2TurnStartResponse__TurnError = Schema.Struct({
export type V2TurnStartResponse__ThreadItem =
| {
+ readonly clientId?: string | null;
readonly content: ReadonlyArray<V2TurnStartResponse__UserInput>;
readonly id: string;
readonly type: "userMessage";
@@ -23859,6 +25091,7 @@ export type V2TurnStartResponse__ThreadItem =
readonly error?: V2TurnStartResponse__McpToolCallError | null;
readonly id: string;
readonly mcpAppResourceUri?: string | null;
+ readonly pluginId?: string | null;
readonly result?: V2TurnStartResponse__McpToolCallResult | null;
readonly server: string;
readonly status: V2TurnStartResponse__McpToolCallStatus;
@@ -23888,6 +25121,13 @@ export type V2TurnStartResponse__ThreadItem =
readonly tool: "spawnAgent" | "sendInput" | "resumeAgent" | "wait" | "closeAgent";
readonly type: "collabAgentToolCall";
}
+ | {
+ readonly agentPath: string;
+ readonly agentThreadId: string;
+ readonly id: string;
+ readonly kind: V2TurnStartResponse__SubAgentActivityKind;
+ readonly type: "subAgentActivity";
+ }
| {
readonly action?: V2TurnStartResponse__WebSearchAction | null;
readonly id: string;
@@ -23913,6 +25153,7 @@ export type V2TurnStartResponse__ThreadItem =
export const V2TurnStartResponse__ThreadItem = Schema.Union(
[
Schema.Struct({
+ clientId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
content: Schema.Array(V2TurnStartResponse__UserInput),
id: Schema.String,
type: Schema.Literal("userMessage").annotate({ title: "UserMessageThreadItemType" }),
@@ -24024,6 +25265,7 @@ export const V2TurnStartResponse__ThreadItem = Schema.Union(
error: Schema.optionalKey(Schema.Union([V2TurnStartResponse__McpToolCallError, Schema.Null])),
id: Schema.String,
mcpAppResourceUri: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ pluginId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
result: Schema.optionalKey(
Schema.Union([V2TurnStartResponse__McpToolCallResult, Schema.Null]),
),
@@ -24103,6 +25345,15 @@ export const V2TurnStartResponse__ThreadItem = Schema.Union(
title: "CollabAgentToolCallThreadItemType",
}),
}).annotate({ title: "CollabAgentToolCallThreadItem" }),
+ Schema.Struct({
+ agentPath: Schema.String,
+ agentThreadId: Schema.String,
+ id: Schema.String,
+ kind: V2TurnStartResponse__SubAgentActivityKind,
+ type: Schema.Literal("subAgentActivity").annotate({
+ title: "SubAgentActivityThreadItemType",
+ }),
+ }).annotate({ title: "SubAgentActivityThreadItem" }),
Schema.Struct({
action: Schema.optionalKey(Schema.Union([V2TurnStartResponse__WebSearchAction, Schema.Null])),
id: Schema.String,
@@ -24148,38 +25399,6 @@ export const V2TurnStartResponse__ThreadItem = Schema.Union(
{ mode: "oneOf" },
);
-export type ClientRequest__PermissionProfileFileSystemPermissions =
- | {
- readonly entries: ReadonlyArray<ClientRequest__FileSystemSandboxEntry>;
- readonly globScanMaxDepth?: number | null;
- readonly type: "restricted";
- }
- | { readonly type: "unrestricted" };
-export const ClientRequest__PermissionProfileFileSystemPermissions = Schema.Union(
- [
- Schema.Struct({
- entries: Schema.Array(ClientRequest__FileSystemSandboxEntry),
- globScanMaxDepth: Schema.optionalKey(
- Schema.Union([
- Schema.Number.annotate({ format: "uint" })
- .check(Schema.isInt())
- .check(Schema.isGreaterThanOrEqualTo(1)),
- Schema.Null,
- ]),
- ),
- type: Schema.Literal("restricted").annotate({
- title: "RestrictedPermissionProfileFileSystemPermissionsType",
- }),
- }).annotate({ title: "RestrictedPermissionProfileFileSystemPermissions" }),
- Schema.Struct({
- type: Schema.Literal("unrestricted").annotate({
- title: "UnrestrictedPermissionProfileFileSystemPermissionsType",
- }),
- }).annotate({ title: "UnrestrictedPermissionProfileFileSystemPermissions" }),
- ],
- { mode: "oneOf" },
-);
-
export type ClientRequest__ExternalAgentConfigImportParams = {
readonly migrationItems: ReadonlyArray<ClientRequest__ExternalAgentConfigMigrationItem>;
};
@@ -24392,6 +25611,37 @@ export const ServerNotification__ErrorNotification = Schema.Struct({
willRetry: Schema.Boolean,
});
+export type ServerNotification__ThreadSettings = {
+ readonly activePermissionProfile?: ServerNotification__ActivePermissionProfile | null;
+ readonly approvalPolicy: ServerNotification__AskForApproval;
+ readonly approvalsReviewer: ServerNotification__ApprovalsReviewer;
+ readonly collaborationMode: ServerNotification__CollaborationMode;
+ readonly cwd: ServerNotification__AbsolutePathBuf;
+ readonly effort?: ServerNotification__ReasoningEffort | null;
+ readonly model: string;
+ readonly modelProvider: string;
+ readonly personality?: ServerNotification__Personality | null;
+ readonly sandboxPolicy: ServerNotification__SandboxPolicy;
+ readonly serviceTier?: string | null;
+ readonly summary?: ServerNotification__ReasoningSummary | null;
+};
+export const ServerNotification__ThreadSettings = Schema.Struct({
+ activePermissionProfile: Schema.optionalKey(
+ Schema.Union([ServerNotification__ActivePermissionProfile, Schema.Null]),
+ ),
+ approvalPolicy: ServerNotification__AskForApproval,
+ approvalsReviewer: ServerNotification__ApprovalsReviewer,
+ collaborationMode: ServerNotification__CollaborationMode,
+ cwd: ServerNotification__AbsolutePathBuf,
+ effort: Schema.optionalKey(Schema.Union([ServerNotification__ReasoningEffort, Schema.Null])),
+ model: Schema.String,
+ modelProvider: Schema.String,
+ personality: Schema.optionalKey(Schema.Union([ServerNotification__Personality, Schema.Null])),
+ sandboxPolicy: ServerNotification__SandboxPolicy,
+ serviceTier: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ summary: Schema.optionalKey(Schema.Union([ServerNotification__ReasoningSummary, Schema.Null])),
+});
+
export type ServerNotification__ItemCompletedNotification = {
readonly completedAtMs: number;
readonly item: ServerNotification__ThreadItem;
@@ -24524,65 +25774,74 @@ export const ServerRequest__McpElicitationMultiSelectEnumSchema = Schema.Union([
ServerRequest__McpElicitationTitledMultiSelectEnumSchema,
]);
-export type V2CommandExecParams__PermissionProfileFileSystemPermissions =
- | {
- readonly entries: ReadonlyArray<V2CommandExecParams__FileSystemSandboxEntry>;
- readonly globScanMaxDepth?: number | null;
- readonly type: "restricted";
- }
- | { readonly type: "unrestricted" };
-export const V2CommandExecParams__PermissionProfileFileSystemPermissions = Schema.Union(
- [
- Schema.Struct({
- entries: Schema.Array(V2CommandExecParams__FileSystemSandboxEntry),
- globScanMaxDepth: Schema.optionalKey(
- Schema.Union([
- Schema.Number.annotate({ format: "uint" })
- .check(Schema.isInt())
- .check(Schema.isGreaterThanOrEqualTo(1)),
- Schema.Null,
- ]),
- ),
- type: Schema.Literal("restricted").annotate({
- title: "RestrictedPermissionProfileFileSystemPermissionsType",
- }),
- }).annotate({ title: "RestrictedPermissionProfileFileSystemPermissions" }),
- Schema.Struct({
- type: Schema.Literal("unrestricted").annotate({
- title: "UnrestrictedPermissionProfileFileSystemPermissionsType",
- }),
- }).annotate({ title: "UnrestrictedPermissionProfileFileSystemPermissions" }),
- ],
- { mode: "oneOf" },
-);
-
-export type V2ConfigReadResponse__ProfileV2 = {
+export type V2ConfigReadResponse__Config = {
+ readonly analytics?: V2ConfigReadResponse__AnalyticsConfig | null;
readonly approval_policy?: V2ConfigReadResponse__AskForApproval | null;
readonly approvals_reviewer?: V2ConfigReadResponse__ApprovalsReviewer | null;
- readonly chatgpt_base_url?: string | null;
+ readonly compact_prompt?: string | null;
+ readonly desktop?: { readonly [x: string]: unknown } | null;
+ readonly developer_instructions?: string | null;
+ readonly forced_chatgpt_workspace_id?: V2ConfigReadResponse__ForcedChatgptWorkspaceIds | null;
+ readonly forced_login_method?: V2ConfigReadResponse__ForcedLoginMethod | null;
+ readonly instructions?: string | null;
readonly model?: string | null;
+ readonly model_auto_compact_token_limit?: number | null;
+ readonly model_auto_compact_token_limit_scope?: V2ConfigReadResponse__AutoCompactTokenLimitScope | null;
+ readonly model_context_window?: number | null;
readonly model_provider?: string | null;
readonly model_reasoning_effort?: V2ConfigReadResponse__ReasoningEffort | null;
readonly model_reasoning_summary?: V2ConfigReadResponse__ReasoningSummary | null;
readonly model_verbosity?: V2ConfigReadResponse__Verbosity | null;
+ readonly review_model?: string | null;
+ readonly sandbox_mode?: V2ConfigReadResponse__SandboxMode | null;
+ readonly sandbox_workspace_write?: V2ConfigReadResponse__SandboxWorkspaceWrite | null;
readonly service_tier?: string | null;
readonly tools?: V2ConfigReadResponse__ToolsV2 | null;
readonly web_search?: V2ConfigReadResponse__WebSearchMode | null;
readonly [x: string]: unknown;
};
-export const V2ConfigReadResponse__ProfileV2 = Schema.StructWithRest(
+export const V2ConfigReadResponse__Config = Schema.StructWithRest(
Schema.Struct({
+ analytics: Schema.optionalKey(
+ Schema.Union([V2ConfigReadResponse__AnalyticsConfig, Schema.Null]),
+ ),
approval_policy: Schema.optionalKey(
Schema.Union([V2ConfigReadResponse__AskForApproval, Schema.Null]),
),
approvals_reviewer: Schema.optionalKey(
Schema.Union([V2ConfigReadResponse__ApprovalsReviewer, Schema.Null]).annotate({
description:
- "[UNSTABLE] Optional profile-level override for where approval requests are routed for review. If omitted, the enclosing config default is used.",
+ "[UNSTABLE] Optional default for where approval requests are routed for review.",
}),
),
- chatgpt_base_url: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ compact_prompt: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ desktop: Schema.optionalKey(
+ Schema.Union([Schema.Record(Schema.String, Schema.Unknown), Schema.Null]),
+ ),
+ developer_instructions: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ forced_chatgpt_workspace_id: Schema.optionalKey(
+ Schema.Union([V2ConfigReadResponse__ForcedChatgptWorkspaceIds, Schema.Null]),
+ ),
+ forced_login_method: Schema.optionalKey(
+ Schema.Union([V2ConfigReadResponse__ForcedLoginMethod, Schema.Null]),
+ ),
+ instructions: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
model: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ model_auto_compact_token_limit: Schema.optionalKey(
+ Schema.Union([
+ Schema.Number.annotate({ format: "int64" }).check(Schema.isInt()),
+ Schema.Null,
+ ]),
+ ),
+ model_auto_compact_token_limit_scope: Schema.optionalKey(
+ Schema.Union([V2ConfigReadResponse__AutoCompactTokenLimitScope, Schema.Null]),
+ ),
+ model_context_window: Schema.optionalKey(
+ Schema.Union([
+ Schema.Number.annotate({ format: "int64" }).check(Schema.isInt()),
+ Schema.Null,
+ ]),
+ ),
model_provider: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
model_reasoning_effort: Schema.optionalKey(
Schema.Union([V2ConfigReadResponse__ReasoningEffort, Schema.Null]),
@@ -24593,6 +25852,13 @@ export const V2ConfigReadResponse__ProfileV2 = Schema.StructWithRest(
model_verbosity: Schema.optionalKey(
Schema.Union([V2ConfigReadResponse__Verbosity, Schema.Null]),
),
+ review_model: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ sandbox_mode: Schema.optionalKey(
+ Schema.Union([V2ConfigReadResponse__SandboxMode, Schema.Null]),
+ ),
+ sandbox_workspace_write: Schema.optionalKey(
+ Schema.Union([V2ConfigReadResponse__SandboxWorkspaceWrite, Schema.Null]),
+ ),
service_tier: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
tools: Schema.optionalKey(Schema.Union([V2ConfigReadResponse__ToolsV2, Schema.Null])),
web_search: Schema.optionalKey(
@@ -24693,6 +25959,60 @@ export const V2ItemGuardianApprovalReviewStartedNotification__AdditionalFileSyst
),
});
+export type V2PluginInstalledResponse__PluginSummary = {
+ readonly authPolicy: V2PluginInstalledResponse__PluginAuthPolicy;
+ readonly availability?: "DISABLED_BY_ADMIN" | "AVAILABLE";
+ readonly enabled: boolean;
+ readonly id: string;
+ readonly installPolicy: V2PluginInstalledResponse__PluginInstallPolicy;
+ readonly installed: boolean;
+ readonly interface?: V2PluginInstalledResponse__PluginInterface | null;
+ readonly keywords?: ReadonlyArray<string>;
+ readonly localVersion?: string | null;
+ readonly name: string;
+ readonly remotePluginId?: string | null;
+ readonly shareContext?: V2PluginInstalledResponse__PluginShareContext | null;
+ readonly source: V2PluginInstalledResponse__PluginSource;
+};
+export const V2PluginInstalledResponse__PluginSummary = Schema.Struct({
+ authPolicy: V2PluginInstalledResponse__PluginAuthPolicy,
+ availability: Schema.optionalKey(
+ Schema.Literals(["DISABLED_BY_ADMIN", "AVAILABLE"]).annotate({
+ description: "Availability state for installing and using the plugin.",
+ default: "AVAILABLE",
+ }),
+ ),
+ enabled: Schema.Boolean,
+ id: Schema.String,
+ installPolicy: V2PluginInstalledResponse__PluginInstallPolicy,
+ installed: Schema.Boolean,
+ interface: Schema.optionalKey(
+ Schema.Union([V2PluginInstalledResponse__PluginInterface, Schema.Null]),
+ ),
+ keywords: Schema.optionalKey(Schema.Array(Schema.String).annotate({ default: [] })),
+ localVersion: Schema.optionalKey(
+ Schema.Union([
+ Schema.String.annotate({
+ description: "Version of the locally materialized plugin package when available.",
+ }),
+ Schema.Null,
+ ]),
+ ),
+ name: Schema.String,
+ remotePluginId: Schema.optionalKey(
+ Schema.Union([
+ Schema.String.annotate({ description: "Backend remote plugin identifier when available." }),
+ Schema.Null,
+ ]),
+ ),
+ shareContext: Schema.optionalKey(
+ Schema.Union([V2PluginInstalledResponse__PluginShareContext, Schema.Null]).annotate({
+ description: "Remote sharing context associated with this plugin when available.",
+ }),
+ ),
+ source: V2PluginInstalledResponse__PluginSource,
+});
+
export type V2PluginListResponse__PluginSummary = {
readonly authPolicy: V2PluginListResponse__PluginAuthPolicy;
readonly availability?: "DISABLED_BY_ADMIN" | "AVAILABLE";
@@ -24702,7 +26022,9 @@ export type V2PluginListResponse__PluginSummary = {
readonly installed: boolean;
readonly interface?: V2PluginListResponse__PluginInterface | null;
readonly keywords?: ReadonlyArray<string>;
+ readonly localVersion?: string | null;
readonly name: string;
+ readonly remotePluginId?: string | null;
readonly shareContext?: V2PluginListResponse__PluginShareContext | null;
readonly source: V2PluginListResponse__PluginSource;
};
@@ -24720,7 +26042,21 @@ export const V2PluginListResponse__PluginSummary = Schema.Struct({
installed: Schema.Boolean,
interface: Schema.optionalKey(Schema.Union([V2PluginListResponse__PluginInterface, Schema.Null])),
keywords: Schema.optionalKey(Schema.Array(Schema.String).annotate({ default: [] })),
+ localVersion: Schema.optionalKey(
+ Schema.Union([
+ Schema.String.annotate({
+ description: "Version of the locally materialized plugin package when available.",
+ }),
+ Schema.Null,
+ ]),
+ ),
name: Schema.String,
+ remotePluginId: Schema.optionalKey(
+ Schema.Union([
+ Schema.String.annotate({ description: "Backend remote plugin identifier when available." }),
+ Schema.Null,
+ ]),
+ ),
shareContext: Schema.optionalKey(
Schema.Union([V2PluginListResponse__PluginShareContext, Schema.Null]).annotate({
description: "Remote sharing context associated with this plugin when available.",
@@ -24738,7 +26074,9 @@ export type V2PluginReadResponse__PluginSummary = {
readonly installed: boolean;
readonly interface?: V2PluginReadResponse__PluginInterface | null;
readonly keywords?: ReadonlyArray<string>;
+ readonly localVersion?: string | null;
readonly name: string;
+ readonly remotePluginId?: string | null;
readonly shareContext?: V2PluginReadResponse__PluginShareContext | null;
readonly source: V2PluginReadResponse__PluginSource;
};
@@ -24756,7 +26094,21 @@ export const V2PluginReadResponse__PluginSummary = Schema.Struct({
installed: Schema.Boolean,
interface: Schema.optionalKey(Schema.Union([V2PluginReadResponse__PluginInterface, Schema.Null])),
keywords: Schema.optionalKey(Schema.Array(Schema.String).annotate({ default: [] })),
+ localVersion: Schema.optionalKey(
+ Schema.Union([
+ Schema.String.annotate({
+ description: "Version of the locally materialized plugin package when available.",
+ }),
+ Schema.Null,
+ ]),
+ ),
name: Schema.String,
+ remotePluginId: Schema.optionalKey(
+ Schema.Union([
+ Schema.String.annotate({ description: "Backend remote plugin identifier when available." }),
+ Schema.Null,
+ ]),
+ ),
shareContext: Schema.optionalKey(
Schema.Union([V2PluginReadResponse__PluginShareContext, Schema.Null]).annotate({
description: "Remote sharing context associated with this plugin when available.",
@@ -24774,7 +26126,9 @@ export type V2PluginShareListResponse__PluginSummary = {
readonly installed: boolean;
readonly interface?: V2PluginShareListResponse__PluginInterface | null;
readonly keywords?: ReadonlyArray<string>;
+ readonly localVersion?: string | null;
readonly name: string;
+ readonly remotePluginId?: string | null;
readonly shareContext?: V2PluginShareListResponse__PluginShareContext | null;
readonly source: V2PluginShareListResponse__PluginSource;
};
@@ -24794,7 +26148,21 @@ export const V2PluginShareListResponse__PluginSummary = Schema.Struct({
Schema.Union([V2PluginShareListResponse__PluginInterface, Schema.Null]),
),
keywords: Schema.optionalKey(Schema.Array(Schema.String).annotate({ default: [] })),
+ localVersion: Schema.optionalKey(
+ Schema.Union([
+ Schema.String.annotate({
+ description: "Version of the locally materialized plugin package when available.",
+ }),
+ Schema.Null,
+ ]),
+ ),
name: Schema.String,
+ remotePluginId: Schema.optionalKey(
+ Schema.Union([
+ Schema.String.annotate({ description: "Backend remote plugin identifier when available." }),
+ Schema.Null,
+ ]),
+ ),
shareContext: Schema.optionalKey(
Schema.Union([V2PluginShareListResponse__PluginShareContext, Schema.Null]).annotate({
description: "Remote sharing context associated with this plugin when available.",
@@ -24811,6 +26179,12 @@ export type V2RawResponseItemCompletedNotification__ResponseItem =
readonly role: string;
readonly type: "message";
}
+ | {
+ readonly author: string;
+ readonly content: ReadonlyArray<V2RawResponseItemCompletedNotification__AgentMessageInputContent>;
+ readonly recipient: string;
+ readonly type: "agent_message";
+ }
| {
readonly content?: ReadonlyArray<V2RawResponseItemCompletedNotification__ReasoningItemContent> | null;
readonly encrypted_content?: string | null;
@@ -24880,6 +26254,7 @@ export type V2RawResponseItemCompletedNotification__ResponseItem =
readonly type: "image_generation_call";
}
| { readonly encrypted_content: string; readonly type: "compaction" }
+ | { readonly type: "compaction_trigger" }
| { readonly encrypted_content?: string | null; readonly type: "context_compaction" }
| { readonly type: "other" };
export const V2RawResponseItemCompletedNotification__ResponseItem = Schema.Union(
@@ -24895,6 +26270,12 @@ export const V2RawResponseItemCompletedNotification__ResponseItem = Schema.Union
role: Schema.String,
type: Schema.Literal("message").annotate({ title: "MessageResponseItemType" }),
}).annotate({ title: "MessageResponseItem" }),
+ Schema.Struct({
+ author: Schema.String,
+ content: Schema.Array(V2RawResponseItemCompletedNotification__AgentMessageInputContent),
+ recipient: Schema.String,
+ type: Schema.Literal("agent_message").annotate({ title: "AgentMessageResponseItemType" }),
+ }).annotate({ title: "AgentMessageResponseItem" }),
Schema.Struct({
content: Schema.optionalKey(
Schema.Union([
@@ -25012,6 +26393,11 @@ export const V2RawResponseItemCompletedNotification__ResponseItem = Schema.Union
encrypted_content: Schema.String,
type: Schema.Literal("compaction").annotate({ title: "CompactionResponseItemType" }),
}).annotate({ title: "CompactionResponseItem" }),
+ Schema.Struct({
+ type: Schema.Literal("compaction_trigger").annotate({
+ title: "CompactionTriggerResponseItemType",
+ }),
+ }).annotate({ title: "CompactionTriggerResponseItem" }),
Schema.Struct({
encrypted_content: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
type: Schema.Literal("context_compaction").annotate({
@@ -25092,38 +26478,6 @@ export const V2SkillsListResponse__SkillsListEntry = Schema.Struct({
skills: Schema.Array(V2SkillsListResponse__SkillMetadata),
});
-export type V2ThreadForkResponse__PermissionProfileFileSystemPermissions =
- | {
- readonly entries: ReadonlyArray<V2ThreadForkResponse__FileSystemSandboxEntry>;
- readonly globScanMaxDepth?: number | null;
- readonly type: "restricted";
- }
- | { readonly type: "unrestricted" };
-export const V2ThreadForkResponse__PermissionProfileFileSystemPermissions = Schema.Union(
- [
- Schema.Struct({
- entries: Schema.Array(V2ThreadForkResponse__FileSystemSandboxEntry),
- globScanMaxDepth: Schema.optionalKey(
- Schema.Union([
- Schema.Number.annotate({ format: "uint" })
- .check(Schema.isInt())
- .check(Schema.isGreaterThanOrEqualTo(1)),
- Schema.Null,
- ]),
- ),
- type: Schema.Literal("restricted").annotate({
- title: "RestrictedPermissionProfileFileSystemPermissionsType",
- }),
- }).annotate({ title: "RestrictedPermissionProfileFileSystemPermissions" }),
- Schema.Struct({
- type: Schema.Literal("unrestricted").annotate({
- title: "UnrestrictedPermissionProfileFileSystemPermissionsType",
- }),
- }).annotate({ title: "UnrestrictedPermissionProfileFileSystemPermissions" }),
- ],
- { mode: "oneOf" },
-);
-
export type V2ThreadForkResponse__Turn = {
readonly completedAt?: number | null;
readonly durationMs?: number | null;
@@ -25348,38 +26702,6 @@ export const V2ThreadReadResponse__Turn = Schema.Struct({
status: V2ThreadReadResponse__TurnStatus,
});
-export type V2ThreadResumeResponse__PermissionProfileFileSystemPermissions =
- | {
- readonly entries: ReadonlyArray<V2ThreadResumeResponse__FileSystemSandboxEntry>;
- readonly globScanMaxDepth?: number | null;
- readonly type: "restricted";
- }
- | { readonly type: "unrestricted" };
-export const V2ThreadResumeResponse__PermissionProfileFileSystemPermissions = Schema.Union(
- [
- Schema.Struct({
- entries: Schema.Array(V2ThreadResumeResponse__FileSystemSandboxEntry),
- globScanMaxDepth: Schema.optionalKey(
- Schema.Union([
- Schema.Number.annotate({ format: "uint" })
- .check(Schema.isInt())
- .check(Schema.isGreaterThanOrEqualTo(1)),
- Schema.Null,
- ]),
- ),
- type: Schema.Literal("restricted").annotate({
- title: "RestrictedPermissionProfileFileSystemPermissionsType",
- }),
- }).annotate({ title: "RestrictedPermissionProfileFileSystemPermissions" }),
- Schema.Struct({
- type: Schema.Literal("unrestricted").annotate({
- title: "UnrestrictedPermissionProfileFileSystemPermissionsType",
- }),
- }).annotate({ title: "UnrestrictedPermissionProfileFileSystemPermissions" }),
- ],
- { mode: "oneOf" },
-);
-
export type V2ThreadResumeResponse__Turn = {
readonly completedAt?: number | null;
readonly durationMs?: number | null;
@@ -25492,6 +26814,43 @@ export const V2ThreadRollbackResponse__Turn = Schema.Struct({
status: V2ThreadRollbackResponse__TurnStatus,
});
+export type V2ThreadSettingsUpdatedNotification__ThreadSettings = {
+ readonly activePermissionProfile?: V2ThreadSettingsUpdatedNotification__ActivePermissionProfile | null;
+ readonly approvalPolicy: V2ThreadSettingsUpdatedNotification__AskForApproval;
+ readonly approvalsReviewer: V2ThreadSettingsUpdatedNotification__ApprovalsReviewer;
+ readonly collaborationMode: V2ThreadSettingsUpdatedNotification__CollaborationMode;
+ readonly cwd: V2ThreadSettingsUpdatedNotification__AbsolutePathBuf;
+ readonly effort?: V2ThreadSettingsUpdatedNotification__ReasoningEffort | null;
+ readonly model: string;
+ readonly modelProvider: string;
+ readonly personality?: V2ThreadSettingsUpdatedNotification__Personality | null;
+ readonly sandboxPolicy: V2ThreadSettingsUpdatedNotification__SandboxPolicy;
+ readonly serviceTier?: string | null;
+ readonly summary?: V2ThreadSettingsUpdatedNotification__ReasoningSummary | null;
+};
+export const V2ThreadSettingsUpdatedNotification__ThreadSettings = Schema.Struct({
+ activePermissionProfile: Schema.optionalKey(
+ Schema.Union([V2ThreadSettingsUpdatedNotification__ActivePermissionProfile, Schema.Null]),
+ ),
+ approvalPolicy: V2ThreadSettingsUpdatedNotification__AskForApproval,
+ approvalsReviewer: V2ThreadSettingsUpdatedNotification__ApprovalsReviewer,
+ collaborationMode: V2ThreadSettingsUpdatedNotification__CollaborationMode,
+ cwd: V2ThreadSettingsUpdatedNotification__AbsolutePathBuf,
+ effort: Schema.optionalKey(
+ Schema.Union([V2ThreadSettingsUpdatedNotification__ReasoningEffort, Schema.Null]),
+ ),
+ model: Schema.String,
+ modelProvider: Schema.String,
+ personality: Schema.optionalKey(
+ Schema.Union([V2ThreadSettingsUpdatedNotification__Personality, Schema.Null]),
+ ),
+ sandboxPolicy: V2ThreadSettingsUpdatedNotification__SandboxPolicy,
+ serviceTier: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ summary: Schema.optionalKey(
+ Schema.Union([V2ThreadSettingsUpdatedNotification__ReasoningSummary, Schema.Null]),
+ ),
+});
+
export type V2ThreadStartedNotification__Turn = {
readonly completedAt?: number | null;
readonly durationMs?: number | null;
@@ -25548,38 +26907,6 @@ export const V2ThreadStartedNotification__Turn = Schema.Struct({
status: V2ThreadStartedNotification__TurnStatus,
});
-export type V2ThreadStartResponse__PermissionProfileFileSystemPermissions =
- | {
- readonly entries: ReadonlyArray<V2ThreadStartResponse__FileSystemSandboxEntry>;
- readonly globScanMaxDepth?: number | null;
- readonly type: "restricted";
- }
- | { readonly type: "unrestricted" };
-export const V2ThreadStartResponse__PermissionProfileFileSystemPermissions = Schema.Union(
- [
- Schema.Struct({
- entries: Schema.Array(V2ThreadStartResponse__FileSystemSandboxEntry),
- globScanMaxDepth: Schema.optionalKey(
- Schema.Union([
- Schema.Number.annotate({ format: "uint" })
- .check(Schema.isInt())
- .check(Schema.isGreaterThanOrEqualTo(1)),
- Schema.Null,
- ]),
- ),
- type: Schema.Literal("restricted").annotate({
- title: "RestrictedPermissionProfileFileSystemPermissionsType",
- }),
- }).annotate({ title: "RestrictedPermissionProfileFileSystemPermissions" }),
- Schema.Struct({
- type: Schema.Literal("unrestricted").annotate({
- title: "UnrestrictedPermissionProfileFileSystemPermissionsType",
- }),
- }).annotate({ title: "UnrestrictedPermissionProfileFileSystemPermissions" }),
- ],
- { mode: "oneOf" },
-);
-
export type V2ThreadStartResponse__Turn = {
readonly completedAt?: number | null;
readonly durationMs?: number | null;
@@ -25912,6 +27239,15 @@ export const ServerNotification__RequestPermissionProfile = Schema.Struct({
),
});
+export type ServerNotification__ThreadSettingsUpdatedNotification = {
+ readonly threadId: string;
+ readonly threadSettings: ServerNotification__ThreadSettings;
+};
+export const ServerNotification__ThreadSettingsUpdatedNotification = Schema.Struct({
+ threadId: Schema.String,
+ threadSettings: ServerNotification__ThreadSettings,
+});
+
export type ServerNotification__Thread = {
readonly agentNickname?: string | null;
readonly agentRole?: string | null;
@@ -25924,6 +27260,7 @@ export type ServerNotification__Thread = {
readonly id: string;
readonly modelProvider: string;
readonly name?: string | null;
+ readonly parentThreadId?: string | null;
readonly path?: string | null;
readonly preview: string;
readonly sessionId: string;
@@ -26002,6 +27339,15 @@ export const ServerNotification__Thread = Schema.Struct({
Schema.Null,
]),
),
+ parentThreadId: Schema.optionalKey(
+ Schema.Union([
+ Schema.String.annotate({
+ description:
+ "The ID of the parent thread. This will only be set if this thread is a subagent.",
+ }),
+ Schema.Null,
+ ]),
+ ),
path: Schema.optionalKey(
Schema.Union([
Schema.String.annotate({ description: "[UNSTABLE] Path to the thread on disk." }),
@@ -26100,96 +27446,6 @@ export const ServerRequest__McpElicitationEnumSchema = Schema.Union([
ServerRequest__McpElicitationLegacyTitledEnumSchema,
]);
-export type V2ConfigReadResponse__Config = {
- readonly analytics?: V2ConfigReadResponse__AnalyticsConfig | null;
- readonly approval_policy?: V2ConfigReadResponse__AskForApproval | null;
- readonly approvals_reviewer?: V2ConfigReadResponse__ApprovalsReviewer | null;
- readonly compact_prompt?: string | null;
- readonly developer_instructions?: string | null;
- readonly forced_chatgpt_workspace_id?: string | null;
- readonly forced_login_method?: V2ConfigReadResponse__ForcedLoginMethod | null;
- readonly instructions?: string | null;
- readonly model?: string | null;
- readonly model_auto_compact_token_limit?: number | null;
- readonly model_context_window?: number | null;
- readonly model_provider?: string | null;
- readonly model_reasoning_effort?: V2ConfigReadResponse__ReasoningEffort | null;
- readonly model_reasoning_summary?: V2ConfigReadResponse__ReasoningSummary | null;
- readonly model_verbosity?: V2ConfigReadResponse__Verbosity | null;
- readonly profile?: string | null;
- readonly profiles?: { readonly [x: string]: V2ConfigReadResponse__ProfileV2 };
- readonly review_model?: string | null;
- readonly sandbox_mode?: V2ConfigReadResponse__SandboxMode | null;
- readonly sandbox_workspace_write?: V2ConfigReadResponse__SandboxWorkspaceWrite | null;
- readonly service_tier?: string | null;
- readonly tools?: V2ConfigReadResponse__ToolsV2 | null;
- readonly web_search?: V2ConfigReadResponse__WebSearchMode | null;
- readonly [x: string]: unknown;
-};
-export const V2ConfigReadResponse__Config = Schema.StructWithRest(
- Schema.Struct({
- analytics: Schema.optionalKey(
- Schema.Union([V2ConfigReadResponse__AnalyticsConfig, Schema.Null]),
- ),
- approval_policy: Schema.optionalKey(
- Schema.Union([V2ConfigReadResponse__AskForApproval, Schema.Null]),
- ),
- approvals_reviewer: Schema.optionalKey(
- Schema.Union([V2ConfigReadResponse__ApprovalsReviewer, Schema.Null]).annotate({
- description:
- "[UNSTABLE] Optional default for where approval requests are routed for review.",
- }),
- ),
- compact_prompt: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
- developer_instructions: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
- forced_chatgpt_workspace_id: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
- forced_login_method: Schema.optionalKey(
- Schema.Union([V2ConfigReadResponse__ForcedLoginMethod, Schema.Null]),
- ),
- instructions: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
- model: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
- model_auto_compact_token_limit: Schema.optionalKey(
- Schema.Union([
- Schema.Number.annotate({ format: "int64" }).check(Schema.isInt()),
- Schema.Null,
- ]),
- ),
- model_context_window: Schema.optionalKey(
- Schema.Union([
- Schema.Number.annotate({ format: "int64" }).check(Schema.isInt()),
- Schema.Null,
- ]),
- ),
- model_provider: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
- model_reasoning_effort: Schema.optionalKey(
- Schema.Union([V2ConfigReadResponse__ReasoningEffort, Schema.Null]),
- ),
- model_reasoning_summary: Schema.optionalKey(
- Schema.Union([V2ConfigReadResponse__ReasoningSummary, Schema.Null]),
- ),
- model_verbosity: Schema.optionalKey(
- Schema.Union([V2ConfigReadResponse__Verbosity, Schema.Null]),
- ),
- profile: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
- profiles: Schema.optionalKey(
- Schema.Record(Schema.String, V2ConfigReadResponse__ProfileV2).annotate({ default: {} }),
- ),
- review_model: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
- sandbox_mode: Schema.optionalKey(
- Schema.Union([V2ConfigReadResponse__SandboxMode, Schema.Null]),
- ),
- sandbox_workspace_write: Schema.optionalKey(
- Schema.Union([V2ConfigReadResponse__SandboxWorkspaceWrite, Schema.Null]),
- ),
- service_tier: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
- tools: Schema.optionalKey(Schema.Union([V2ConfigReadResponse__ToolsV2, Schema.Null])),
- web_search: Schema.optionalKey(
- Schema.Union([V2ConfigReadResponse__WebSearchMode, Schema.Null]),
- ),
- }),
- [Schema.Record(Schema.String, Schema.Unknown)],
-);
-
export type V2ItemGuardianApprovalReviewCompletedNotification__RequestPermissionProfile = {
readonly fileSystem?: V2ItemGuardianApprovalReviewCompletedNotification__AdditionalFileSystemPermissions | null;
readonly network?: V2ItemGuardianApprovalReviewCompletedNotification__AdditionalNetworkPermissions | null;
@@ -26230,6 +27486,26 @@ export const V2ItemGuardianApprovalReviewStartedNotification__RequestPermissionP
),
});
+export type V2PluginInstalledResponse__PluginMarketplaceEntry = {
+ readonly interface?: V2PluginInstalledResponse__MarketplaceInterface | null;
+ readonly name: string;
+ readonly path?: V2PluginInstalledResponse__AbsolutePathBuf | null;
+ readonly plugins: ReadonlyArray<V2PluginInstalledResponse__PluginSummary>;
+};
+export const V2PluginInstalledResponse__PluginMarketplaceEntry = Schema.Struct({
+ interface: Schema.optionalKey(
+ Schema.Union([V2PluginInstalledResponse__MarketplaceInterface, Schema.Null]),
+ ),
+ name: Schema.String,
+ path: Schema.optionalKey(
+ Schema.Union([V2PluginInstalledResponse__AbsolutePathBuf, Schema.Null]).annotate({
+ description:
+ "Local marketplace file path when the marketplace is backed by a local file. Remote-only catalog marketplaces do not have a local path.",
+ }),
+ ),
+ plugins: Schema.Array(V2PluginInstalledResponse__PluginSummary),
+});
+
export type V2PluginListResponse__PluginMarketplaceEntry = {
readonly interface?: V2PluginListResponse__MarketplaceInterface | null;
readonly name: string;
@@ -26251,6 +27527,7 @@ export const V2PluginListResponse__PluginMarketplaceEntry = Schema.Struct({
});
export type V2PluginReadResponse__PluginDetail = {
+ readonly appTemplates: ReadonlyArray<V2PluginReadResponse__AppTemplateSummary>;
readonly apps: ReadonlyArray<V2PluginReadResponse__AppSummary>;
readonly description?: string | null;
readonly hooks: ReadonlyArray<V2PluginReadResponse__PluginHookSummary>;
@@ -26261,6 +27538,7 @@ export type V2PluginReadResponse__PluginDetail = {
readonly summary: V2PluginReadResponse__PluginSummary;
};
export const V2PluginReadResponse__PluginDetail = Schema.Struct({
+ appTemplates: Schema.Array(V2PluginReadResponse__AppTemplateSummary),
apps: Schema.Array(V2PluginReadResponse__AppSummary),
description: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
hooks: Schema.Array(V2PluginReadResponse__PluginHookSummary),
@@ -26276,14 +27554,12 @@ export const V2PluginReadResponse__PluginDetail = Schema.Struct({
export type V2PluginShareListResponse__PluginShareListItem = {
readonly localPluginPath?: V2PluginShareListResponse__AbsolutePathBuf | null;
readonly plugin: V2PluginShareListResponse__PluginSummary;
- readonly shareUrl: string;
};
export const V2PluginShareListResponse__PluginShareListItem = Schema.Struct({
localPluginPath: Schema.optionalKey(
Schema.Union([V2PluginShareListResponse__AbsolutePathBuf, Schema.Null]),
),
plugin: V2PluginShareListResponse__PluginSummary,
- shareUrl: Schema.String,
});
export type V2ThreadForkResponse__Thread = {
@@ -26298,6 +27574,7 @@ export type V2ThreadForkResponse__Thread = {
readonly id: string;
readonly modelProvider: string;
readonly name?: string | null;
+ readonly parentThreadId?: string | null;
readonly path?: string | null;
readonly preview: string;
readonly sessionId: string;
@@ -26362,7 +27639,164 @@ export const V2ThreadForkResponse__Thread = Schema.Struct({
]),
),
gitInfo: Schema.optionalKey(
- Schema.Union([V2ThreadForkResponse__GitInfo, Schema.Null]).annotate({
+ Schema.Union([V2ThreadForkResponse__GitInfo, Schema.Null]).annotate({
+ description: "Optional Git metadata captured when the thread was created.",
+ }),
+ ),
+ id: Schema.String,
+ modelProvider: Schema.String.annotate({
+ description: "Model provider used for this thread (for example, 'openai').",
+ }),
+ name: Schema.optionalKey(
+ Schema.Union([
+ Schema.String.annotate({ description: "Optional user-facing thread title." }),
+ Schema.Null,
+ ]),
+ ),
+ parentThreadId: Schema.optionalKey(
+ Schema.Union([
+ Schema.String.annotate({
+ description:
+ "The ID of the parent thread. This will only be set if this thread is a subagent.",
+ }),
+ Schema.Null,
+ ]),
+ ),
+ path: Schema.optionalKey(
+ Schema.Union([
+ Schema.String.annotate({ description: "[UNSTABLE] Path to the thread on disk." }),
+ Schema.Null,
+ ]),
+ ),
+ preview: Schema.String.annotate({
+ description: "Usually the first user message in the thread, if available.",
+ }),
+ sessionId: Schema.String.annotate({
+ description: "Session id shared by threads that belong to the same session tree.",
+ }),
+ source: Schema.Union(
+ [
+ Schema.Literals(["cli", "vscode", "exec", "appServer", "unknown"]),
+ Schema.Struct({ custom: Schema.String }).annotate({ title: "CustomSessionSource" }),
+ Schema.Struct({ subAgent: V2ThreadForkResponse__SubAgentSource }).annotate({
+ title: "SubAgentSessionSource",
+ }),
+ ],
+ { mode: "oneOf" },
+ ).annotate({
+ description: "Origin of the thread (CLI, VSCode, codex exec, codex app-server, etc.).",
+ }),
+ status: Schema.Union(
+ [
+ Schema.Struct({
+ type: Schema.Literal("notLoaded").annotate({ title: "NotLoadedThreadStatusType" }),
+ }).annotate({ title: "NotLoadedThreadStatus" }),
+ Schema.Struct({
+ type: Schema.Literal("idle").annotate({ title: "IdleThreadStatusType" }),
+ }).annotate({ title: "IdleThreadStatus" }),
+ Schema.Struct({
+ type: Schema.Literal("systemError").annotate({ title: "SystemErrorThreadStatusType" }),
+ }).annotate({ title: "SystemErrorThreadStatus" }),
+ Schema.Struct({
+ activeFlags: Schema.Array(V2ThreadForkResponse__ThreadActiveFlag),
+ type: Schema.Literal("active").annotate({ title: "ActiveThreadStatusType" }),
+ }).annotate({ title: "ActiveThreadStatus" }),
+ ],
+ { mode: "oneOf" },
+ ).annotate({ description: "Current runtime status for the thread." }),
+ threadSource: Schema.optionalKey(
+ Schema.Union([V2ThreadForkResponse__ThreadSource, Schema.Null]).annotate({
+ description: "Optional analytics source classification for this thread.",
+ }),
+ ),
+ turns: Schema.Array(V2ThreadForkResponse__Turn).annotate({
+ description:
+ "Only populated on `thread/resume`, `thread/rollback`, `thread/fork`, and `thread/read` (when `includeTurns` is true) responses. For all other responses and notifications returning a Thread, the turns field will be an empty list.",
+ }),
+ updatedAt: Schema.Number.annotate({
+ description: "Unix timestamp (in seconds) when the thread was last updated.",
+ format: "int64",
+ }).check(Schema.isInt()),
+});
+
+export type V2ThreadListResponse__Thread = {
+ readonly agentNickname?: string | null;
+ readonly agentRole?: string | null;
+ readonly cliVersion: string;
+ readonly createdAt: number;
+ readonly cwd: string;
+ readonly ephemeral: boolean;
+ readonly forkedFromId?: string | null;
+ readonly gitInfo?: V2ThreadListResponse__GitInfo | null;
+ readonly id: string;
+ readonly modelProvider: string;
+ readonly name?: string | null;
+ readonly parentThreadId?: string | null;
+ readonly path?: string | null;
+ readonly preview: string;
+ readonly sessionId: string;
+ readonly source:
+ | "cli"
+ | "vscode"
+ | "exec"
+ | "appServer"
+ | "unknown"
+ | { readonly custom: string }
+ | { readonly subAgent: V2ThreadListResponse__SubAgentSource };
+ readonly status:
+ | { readonly type: "notLoaded" }
+ | { readonly type: "idle" }
+ | { readonly type: "systemError" }
+ | {
+ readonly activeFlags: ReadonlyArray<V2ThreadListResponse__ThreadActiveFlag>;
+ readonly type: "active";
+ };
+ readonly threadSource?: V2ThreadListResponse__ThreadSource | null;
+ readonly turns: ReadonlyArray<V2ThreadListResponse__Turn>;
+ readonly updatedAt: number;
+};
+export const V2ThreadListResponse__Thread = Schema.Struct({
+ agentNickname: Schema.optionalKey(
+ Schema.Union([
+ Schema.String.annotate({
+ description:
+ "Optional random unique nickname assigned to an AgentControl-spawned sub-agent.",
+ }),
+ Schema.Null,
+ ]),
+ ),
+ agentRole: Schema.optionalKey(
+ Schema.Union([
+ Schema.String.annotate({
+ description: "Optional role (agent_role) assigned to an AgentControl-spawned sub-agent.",
+ }),
+ Schema.Null,
+ ]),
+ ),
+ cliVersion: Schema.String.annotate({
+ description: "Version of the CLI that created the thread.",
+ }),
+ createdAt: Schema.Number.annotate({
+ description: "Unix timestamp (in seconds) when the thread was created.",
+ format: "int64",
+ }).check(Schema.isInt()),
+ cwd: Schema.String.annotate({
+ description:
+ "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.",
+ }),
+ ephemeral: Schema.Boolean.annotate({
+ description: "Whether the thread is ephemeral and should not be materialized on disk.",
+ }),
+ forkedFromId: Schema.optionalKey(
+ Schema.Union([
+ Schema.String.annotate({
+ description: "Source thread id when this thread was created by forking another thread.",
+ }),
+ Schema.Null,
+ ]),
+ ),
+ gitInfo: Schema.optionalKey(
+ Schema.Union([V2ThreadListResponse__GitInfo, Schema.Null]).annotate({
description: "Optional Git metadata captured when the thread was created.",
}),
),
@@ -26376,153 +27810,15 @@ export const V2ThreadForkResponse__Thread = Schema.Struct({
Schema.Null,
]),
),
- path: Schema.optionalKey(
- Schema.Union([
- Schema.String.annotate({ description: "[UNSTABLE] Path to the thread on disk." }),
- Schema.Null,
- ]),
- ),
- preview: Schema.String.annotate({
- description: "Usually the first user message in the thread, if available.",
- }),
- sessionId: Schema.String.annotate({
- description: "Session id shared by threads that belong to the same session tree.",
- }),
- source: Schema.Union(
- [
- Schema.Literals(["cli", "vscode", "exec", "appServer", "unknown"]),
- Schema.Struct({ custom: Schema.String }).annotate({ title: "CustomSessionSource" }),
- Schema.Struct({ subAgent: V2ThreadForkResponse__SubAgentSource }).annotate({
- title: "SubAgentSessionSource",
- }),
- ],
- { mode: "oneOf" },
- ).annotate({
- description: "Origin of the thread (CLI, VSCode, codex exec, codex app-server, etc.).",
- }),
- status: Schema.Union(
- [
- Schema.Struct({
- type: Schema.Literal("notLoaded").annotate({ title: "NotLoadedThreadStatusType" }),
- }).annotate({ title: "NotLoadedThreadStatus" }),
- Schema.Struct({
- type: Schema.Literal("idle").annotate({ title: "IdleThreadStatusType" }),
- }).annotate({ title: "IdleThreadStatus" }),
- Schema.Struct({
- type: Schema.Literal("systemError").annotate({ title: "SystemErrorThreadStatusType" }),
- }).annotate({ title: "SystemErrorThreadStatus" }),
- Schema.Struct({
- activeFlags: Schema.Array(V2ThreadForkResponse__ThreadActiveFlag),
- type: Schema.Literal("active").annotate({ title: "ActiveThreadStatusType" }),
- }).annotate({ title: "ActiveThreadStatus" }),
- ],
- { mode: "oneOf" },
- ).annotate({ description: "Current runtime status for the thread." }),
- threadSource: Schema.optionalKey(
- Schema.Union([V2ThreadForkResponse__ThreadSource, Schema.Null]).annotate({
- description: "Optional analytics source classification for this thread.",
- }),
- ),
- turns: Schema.Array(V2ThreadForkResponse__Turn).annotate({
- description:
- "Only populated on `thread/resume`, `thread/rollback`, `thread/fork`, and `thread/read` (when `includeTurns` is true) responses. For all other responses and notifications returning a Thread, the turns field will be an empty list.",
- }),
- updatedAt: Schema.Number.annotate({
- description: "Unix timestamp (in seconds) when the thread was last updated.",
- format: "int64",
- }).check(Schema.isInt()),
-});
-
-export type V2ThreadListResponse__Thread = {
- readonly agentNickname?: string | null;
- readonly agentRole?: string | null;
- readonly cliVersion: string;
- readonly createdAt: number;
- readonly cwd: string;
- readonly ephemeral: boolean;
- readonly forkedFromId?: string | null;
- readonly gitInfo?: V2ThreadListResponse__GitInfo | null;
- readonly id: string;
- readonly modelProvider: string;
- readonly name?: string | null;
- readonly path?: string | null;
- readonly preview: string;
- readonly sessionId: string;
- readonly source:
- | "cli"
- | "vscode"
- | "exec"
- | "appServer"
- | "unknown"
- | { readonly custom: string }
- | { readonly subAgent: V2ThreadListResponse__SubAgentSource };
- readonly status:
- | { readonly type: "notLoaded" }
- | { readonly type: "idle" }
- | { readonly type: "systemError" }
- | {
- readonly activeFlags: ReadonlyArray<V2ThreadListResponse__ThreadActiveFlag>;
- readonly type: "active";
- };
- readonly threadSource?: V2ThreadListResponse__ThreadSource | null;
- readonly turns: ReadonlyArray<V2ThreadListResponse__Turn>;
- readonly updatedAt: number;
-};
-export const V2ThreadListResponse__Thread = Schema.Struct({
- agentNickname: Schema.optionalKey(
+ parentThreadId: Schema.optionalKey(
Schema.Union([
Schema.String.annotate({
description:
- "Optional random unique nickname assigned to an AgentControl-spawned sub-agent.",
+ "The ID of the parent thread. This will only be set if this thread is a subagent.",
}),
Schema.Null,
]),
),
- agentRole: Schema.optionalKey(
- Schema.Union([
- Schema.String.annotate({
- description: "Optional role (agent_role) assigned to an AgentControl-spawned sub-agent.",
- }),
- Schema.Null,
- ]),
- ),
- cliVersion: Schema.String.annotate({
- description: "Version of the CLI that created the thread.",
- }),
- createdAt: Schema.Number.annotate({
- description: "Unix timestamp (in seconds) when the thread was created.",
- format: "int64",
- }).check(Schema.isInt()),
- cwd: Schema.String.annotate({
- description:
- "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.",
- }),
- ephemeral: Schema.Boolean.annotate({
- description: "Whether the thread is ephemeral and should not be materialized on disk.",
- }),
- forkedFromId: Schema.optionalKey(
- Schema.Union([
- Schema.String.annotate({
- description: "Source thread id when this thread was created by forking another thread.",
- }),
- Schema.Null,
- ]),
- ),
- gitInfo: Schema.optionalKey(
- Schema.Union([V2ThreadListResponse__GitInfo, Schema.Null]).annotate({
- description: "Optional Git metadata captured when the thread was created.",
- }),
- ),
- id: Schema.String,
- modelProvider: Schema.String.annotate({
- description: "Model provider used for this thread (for example, 'openai').",
- }),
- name: Schema.optionalKey(
- Schema.Union([
- Schema.String.annotate({ description: "Optional user-facing thread title." }),
- Schema.Null,
- ]),
- ),
path: Schema.optionalKey(
Schema.Union([
Schema.String.annotate({ description: "[UNSTABLE] Path to the thread on disk." }),
@@ -26592,6 +27888,7 @@ export type V2ThreadMetadataUpdateResponse__Thread = {
readonly id: string;
readonly modelProvider: string;
readonly name?: string | null;
+ readonly parentThreadId?: string | null;
readonly path?: string | null;
readonly preview: string;
readonly sessionId: string;
@@ -26670,6 +27967,15 @@ export const V2ThreadMetadataUpdateResponse__Thread = Schema.Struct({
Schema.Null,
]),
),
+ parentThreadId: Schema.optionalKey(
+ Schema.Union([
+ Schema.String.annotate({
+ description:
+ "The ID of the parent thread. This will only be set if this thread is a subagent.",
+ }),
+ Schema.Null,
+ ]),
+ ),
path: Schema.optionalKey(
Schema.Union([
Schema.String.annotate({ description: "[UNSTABLE] Path to the thread on disk." }),
@@ -26739,6 +28045,7 @@ export type V2ThreadReadResponse__Thread = {
readonly id: string;
readonly modelProvider: string;
readonly name?: string | null;
+ readonly parentThreadId?: string | null;
readonly path?: string | null;
readonly preview: string;
readonly sessionId: string;
@@ -26817,6 +28124,15 @@ export const V2ThreadReadResponse__Thread = Schema.Struct({
Schema.Null,
]),
),
+ parentThreadId: Schema.optionalKey(
+ Schema.Union([
+ Schema.String.annotate({
+ description:
+ "The ID of the parent thread. This will only be set if this thread is a subagent.",
+ }),
+ Schema.Null,
+ ]),
+ ),
path: Schema.optionalKey(
Schema.Union([
Schema.String.annotate({ description: "[UNSTABLE] Path to the thread on disk." }),
@@ -26886,6 +28202,7 @@ export type V2ThreadResumeResponse__Thread = {
readonly id: string;
readonly modelProvider: string;
readonly name?: string | null;
+ readonly parentThreadId?: string | null;
readonly path?: string | null;
readonly preview: string;
readonly sessionId: string;
@@ -26964,6 +28281,15 @@ export const V2ThreadResumeResponse__Thread = Schema.Struct({
Schema.Null,
]),
),
+ parentThreadId: Schema.optionalKey(
+ Schema.Union([
+ Schema.String.annotate({
+ description:
+ "The ID of the parent thread. This will only be set if this thread is a subagent.",
+ }),
+ Schema.Null,
+ ]),
+ ),
path: Schema.optionalKey(
Schema.Union([
Schema.String.annotate({ description: "[UNSTABLE] Path to the thread on disk." }),
@@ -27033,6 +28359,7 @@ export type V2ThreadStartedNotification__Thread = {
readonly id: string;
readonly modelProvider: string;
readonly name?: string | null;
+ readonly parentThreadId?: string | null;
readonly path?: string | null;
readonly preview: string;
readonly sessionId: string;
@@ -27111,6 +28438,15 @@ export const V2ThreadStartedNotification__Thread = Schema.Struct({
Schema.Null,
]),
),
+ parentThreadId: Schema.optionalKey(
+ Schema.Union([
+ Schema.String.annotate({
+ description:
+ "The ID of the parent thread. This will only be set if this thread is a subagent.",
+ }),
+ Schema.Null,
+ ]),
+ ),
path: Schema.optionalKey(
Schema.Union([
Schema.String.annotate({ description: "[UNSTABLE] Path to the thread on disk." }),
@@ -27180,6 +28516,7 @@ export type V2ThreadStartResponse__Thread = {
readonly id: string;
readonly modelProvider: string;
readonly name?: string | null;
+ readonly parentThreadId?: string | null;
readonly path?: string | null;
readonly preview: string;
readonly sessionId: string;
@@ -27258,6 +28595,15 @@ export const V2ThreadStartResponse__Thread = Schema.Struct({
Schema.Null,
]),
),
+ parentThreadId: Schema.optionalKey(
+ Schema.Union([
+ Schema.String.annotate({
+ description:
+ "The ID of the parent thread. This will only be set if this thread is a subagent.",
+ }),
+ Schema.Null,
+ ]),
+ ),
path: Schema.optionalKey(
Schema.Union([
Schema.String.annotate({ description: "[UNSTABLE] Path to the thread on disk." }),
@@ -27327,6 +28673,7 @@ export type V2ThreadUnarchiveResponse__Thread = {
readonly id: string;
readonly modelProvider: string;
readonly name?: string | null;
+ readonly parentThreadId?: string | null;
readonly path?: string | null;
readonly preview: string;
readonly sessionId: string;
@@ -27405,6 +28752,15 @@ export const V2ThreadUnarchiveResponse__Thread = Schema.Struct({
Schema.Null,
]),
),
+ parentThreadId: Schema.optionalKey(
+ Schema.Union([
+ Schema.String.annotate({
+ description:
+ "The ID of the parent thread. This will only be set if this thread is a subagent.",
+ }),
+ Schema.Null,
+ ]),
+ ),
path: Schema.optionalKey(
Schema.Union([
Schema.String.annotate({ description: "[UNSTABLE] Path to the thread on disk." }),
@@ -27578,17 +28934,24 @@ export const ServerNotification__ThreadStartedNotification = Schema.Struct({
export type ServerRequest__PermissionsRequestApprovalParams = {
readonly cwd: ServerRequest__AbsolutePathBuf;
+ readonly environmentId?: string | null;
readonly itemId: string;
readonly permissions: ServerRequest__RequestPermissionProfile;
readonly reason?: string | null;
+ readonly startedAtMs: number;
readonly threadId: string;
readonly turnId: string;
};
export const ServerRequest__PermissionsRequestApprovalParams = Schema.Struct({
cwd: ServerRequest__AbsolutePathBuf,
+ environmentId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
itemId: Schema.String,
permissions: ServerRequest__RequestPermissionProfile,
reason: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ startedAtMs: Schema.Number.annotate({
+ description: "Unix timestamp (in milliseconds) when this approval request started.",
+ format: "int64",
+ }).check(Schema.isInt()),
threadId: Schema.String,
turnId: Schema.String,
});
@@ -27824,18 +29187,28 @@ export const McpServerElicitationRequestParams__McpElicitationSchema = Schema.St
export type ServerNotification__ItemGuardianApprovalReviewCompletedNotification = {
readonly action: ServerNotification__GuardianApprovalReviewAction;
+ readonly completedAtMs: number;
readonly decisionSource: ServerNotification__AutoReviewDecisionSource;
readonly review: ServerNotification__GuardianApprovalReview;
readonly reviewId: string;
+ readonly startedAtMs: number;
readonly targetItemId?: string | null;
readonly threadId: string;
readonly turnId: string;
};
export const ServerNotification__ItemGuardianApprovalReviewCompletedNotification = Schema.Struct({
action: ServerNotification__GuardianApprovalReviewAction,
+ completedAtMs: Schema.Number.annotate({
+ description: "Unix timestamp (in milliseconds) when this review completed.",
+ format: "int64",
+ }).check(Schema.isInt()),
decisionSource: ServerNotification__AutoReviewDecisionSource,
review: ServerNotification__GuardianApprovalReview,
reviewId: Schema.String.annotate({ description: "Stable identifier for this review." }),
+ startedAtMs: Schema.Number.annotate({
+ description: "Unix timestamp (in milliseconds) when this review started.",
+ format: "int64",
+ }).check(Schema.isInt()),
targetItemId: Schema.optionalKey(
Schema.Union([
Schema.String.annotate({
@@ -27856,6 +29229,7 @@ export type ServerNotification__ItemGuardianApprovalReviewStartedNotification =
readonly action: ServerNotification__GuardianApprovalReviewAction;
readonly review: ServerNotification__GuardianApprovalReview;
readonly reviewId: string;
+ readonly startedAtMs: number;
readonly targetItemId?: string | null;
readonly threadId: string;
readonly turnId: string;
@@ -27864,6 +29238,10 @@ export const ServerNotification__ItemGuardianApprovalReviewStartedNotification =
action: ServerNotification__GuardianApprovalReviewAction,
review: ServerNotification__GuardianApprovalReview,
reviewId: Schema.String.annotate({ description: "Stable identifier for this review." }),
+ startedAtMs: Schema.Number.annotate({
+ description: "Unix timestamp (in milliseconds) when this review started.",
+ format: "int64",
+ }).check(Schema.isInt()),
targetItemId: Schema.optionalKey(
Schema.Union([
Schema.String.annotate({
@@ -27997,6 +29375,16 @@ export const ApplyPatchApprovalResponse = Schema.Struct({
decision: ApplyPatchApprovalResponse__ReviewDecision,
}).annotate({ title: "ApplyPatchApprovalResponse" });
+export type AttestationGenerateParams = {};
+export const AttestationGenerateParams = Schema.Struct({}).annotate({
+ title: "AttestationGenerateParams",
+});
+
+export type AttestationGenerateResponse = { readonly token: string };
+export const AttestationGenerateResponse = Schema.Struct({
+ token: Schema.String.annotate({ description: "Opaque client attestation token." }),
+}).annotate({ title: "AttestationGenerateResponse" });
+
export type ChatgptAuthTokensRefreshParams = {
readonly previousAccountId?: string | null;
readonly reason: ChatgptAuthTokensRefreshParams__ChatgptAuthTokensRefreshReason;
@@ -28061,6 +29449,11 @@ export type ClientRequest =
readonly method: "thread/archive";
readonly params: ClientRequest__ThreadArchiveParams;
}
+ | {
+ readonly id: ClientRequest__RequestId;
+ readonly method: "thread/delete";
+ readonly params: ClientRequest__ThreadDeleteParams;
+ }
| {
readonly id: ClientRequest__RequestId;
readonly method: "thread/unsubscribe";
@@ -28071,6 +29464,21 @@ export type ClientRequest =
readonly method: "thread/name/set";
readonly params: ClientRequest__ThreadSetNameParams;
}
+ | {
+ readonly id: ClientRequest__RequestId;
+ readonly method: "thread/goal/set";
+ readonly params: ClientRequest__ThreadGoalSetParams;
+ }
+ | {
+ readonly id: ClientRequest__RequestId;
+ readonly method: "thread/goal/get";
+ readonly params: ClientRequest__ThreadGoalGetParams;
+ }
+ | {
+ readonly id: ClientRequest__RequestId;
+ readonly method: "thread/goal/clear";
+ readonly params: ClientRequest__ThreadGoalClearParams;
+ }
| {
readonly id: ClientRequest__RequestId;
readonly method: "thread/metadata/update";
@@ -28126,6 +29534,11 @@ export type ClientRequest =
readonly method: "skills/list";
readonly params: ClientRequest__SkillsListParams;
}
+ | {
+ readonly id: ClientRequest__RequestId;
+ readonly method: "skills/extraRoots/set";
+ readonly params: ClientRequest__SkillsExtraRootsSetParams;
+ }
| {
readonly id: ClientRequest__RequestId;
readonly method: "hooks/list";
@@ -28151,6 +29564,11 @@ export type ClientRequest =
readonly method: "plugin/list";
readonly params: ClientRequest__PluginListParams;
}
+ | {
+ readonly id: ClientRequest__RequestId;
+ readonly method: "plugin/installed";
+ readonly params: ClientRequest__PluginInstalledParams;
+ }
| {
readonly id: ClientRequest__RequestId;
readonly method: "plugin/read";
@@ -28176,6 +29594,11 @@ export type ClientRequest =
readonly method: "plugin/share/list";
readonly params: ClientRequest__PluginShareListParams;
}
+ | {
+ readonly id: ClientRequest__RequestId;
+ readonly method: "plugin/share/checkout";
+ readonly params: ClientRequest__PluginShareCheckoutParams;
+ }
| {
readonly id: ClientRequest__RequestId;
readonly method: "plugin/share/delete";
@@ -28281,6 +29704,11 @@ export type ClientRequest =
readonly method: "experimentalFeature/list";
readonly params: ClientRequest__ExperimentalFeatureListParams;
}
+ | {
+ readonly id: ClientRequest__RequestId;
+ readonly method: "permissionProfile/list";
+ readonly params: ClientRequest__PermissionProfileListParams;
+ }
| {
readonly id: ClientRequest__RequestId;
readonly method: "experimentalFeature/enablement/set";
@@ -28341,6 +29769,11 @@ export type ClientRequest =
readonly method: "account/rateLimits/read";
readonly params?: null;
}
+ | {
+ readonly id: ClientRequest__RequestId;
+ readonly method: "account/usage/read";
+ readonly params?: null;
+ }
| {
readonly id: ClientRequest__RequestId;
readonly method: "account/sendAddCreditsNudgeEmail";
@@ -28438,6 +29871,11 @@ export const ClientRequest = Schema.Union(
method: Schema.Literal("thread/archive").annotate({ title: "Thread/archiveRequestMethod" }),
params: ClientRequest__ThreadArchiveParams,
}).annotate({ title: "Thread/archiveRequest" }),
+ Schema.Struct({
+ id: ClientRequest__RequestId,
+ method: Schema.Literal("thread/delete").annotate({ title: "Thread/deleteRequestMethod" }),
+ params: ClientRequest__ThreadDeleteParams,
+ }).annotate({ title: "Thread/deleteRequest" }),
Schema.Struct({
id: ClientRequest__RequestId,
method: Schema.Literal("thread/unsubscribe").annotate({
@@ -28450,6 +29888,23 @@ export const ClientRequest = Schema.Union(
method: Schema.Literal("thread/name/set").annotate({ title: "Thread/name/setRequestMethod" }),
params: ClientRequest__ThreadSetNameParams,
}).annotate({ title: "Thread/name/setRequest" }),
+ Schema.Struct({
+ id: ClientRequest__RequestId,
+ method: Schema.Literal("thread/goal/set").annotate({ title: "Thread/goal/setRequestMethod" }),
+ params: ClientRequest__ThreadGoalSetParams,
+ }).annotate({ title: "Thread/goal/setRequest" }),
+ Schema.Struct({
+ id: ClientRequest__RequestId,
+ method: Schema.Literal("thread/goal/get").annotate({ title: "Thread/goal/getRequestMethod" }),
+ params: ClientRequest__ThreadGoalGetParams,
+ }).annotate({ title: "Thread/goal/getRequest" }),
+ Schema.Struct({
+ id: ClientRequest__RequestId,
+ method: Schema.Literal("thread/goal/clear").annotate({
+ title: "Thread/goal/clearRequestMethod",
+ }),
+ params: ClientRequest__ThreadGoalClearParams,
+ }).annotate({ title: "Thread/goal/clearRequest" }),
Schema.Struct({
id: ClientRequest__RequestId,
method: Schema.Literal("thread/metadata/update").annotate({
@@ -28523,6 +29978,13 @@ export const ClientRequest = Schema.Union(
method: Schema.Literal("skills/list").annotate({ title: "Skills/listRequestMethod" }),
params: ClientRequest__SkillsListParams,
}).annotate({ title: "Skills/listRequest" }),
+ Schema.Struct({
+ id: ClientRequest__RequestId,
+ method: Schema.Literal("skills/extraRoots/set").annotate({
+ title: "Skills/extraRoots/setRequestMethod",
+ }),
+ params: ClientRequest__SkillsExtraRootsSetParams,
+ }).annotate({ title: "Skills/extraRoots/setRequest" }),
Schema.Struct({
id: ClientRequest__RequestId,
method: Schema.Literal("hooks/list").annotate({ title: "Hooks/listRequestMethod" }),
@@ -28552,6 +30014,13 @@ export const ClientRequest = Schema.Union(
method: Schema.Literal("plugin/list").annotate({ title: "Plugin/listRequestMethod" }),
params: ClientRequest__PluginListParams,
}).annotate({ title: "Plugin/listRequest" }),
+ Schema.Struct({
+ id: ClientRequest__RequestId,
+ method: Schema.Literal("plugin/installed").annotate({
+ title: "Plugin/installedRequestMethod",
+ }),
+ params: ClientRequest__PluginInstalledParams,
+ }).annotate({ title: "Plugin/installedRequest" }),
Schema.Struct({
id: ClientRequest__RequestId,
method: Schema.Literal("plugin/read").annotate({ title: "Plugin/readRequestMethod" }),
@@ -28585,6 +30054,13 @@ export const ClientRequest = Schema.Union(
}),
params: ClientRequest__PluginShareListParams,
}).annotate({ title: "Plugin/share/listRequest" }),
+ Schema.Struct({
+ id: ClientRequest__RequestId,
+ method: Schema.Literal("plugin/share/checkout").annotate({
+ title: "Plugin/share/checkoutRequestMethod",
+ }),
+ params: ClientRequest__PluginShareCheckoutParams,
+ }).annotate({ title: "Plugin/share/checkoutRequest" }),
Schema.Struct({
id: ClientRequest__RequestId,
method: Schema.Literal("plugin/share/delete").annotate({
@@ -28704,6 +30180,13 @@ export const ClientRequest = Schema.Union(
}),
params: ClientRequest__ExperimentalFeatureListParams,
}).annotate({ title: "ExperimentalFeature/listRequest" }),
+ Schema.Struct({
+ id: ClientRequest__RequestId,
+ method: Schema.Literal("permissionProfile/list").annotate({
+ title: "PermissionProfile/listRequestMethod",
+ }),
+ params: ClientRequest__PermissionProfileListParams,
+ }).annotate({ title: "PermissionProfile/listRequest" }),
Schema.Struct({
id: ClientRequest__RequestId,
method: Schema.Literal("experimentalFeature/enablement/set").annotate({
@@ -28786,6 +30269,13 @@ export const ClientRequest = Schema.Union(
}),
params: Schema.optionalKey(Schema.Null),
}).annotate({ title: "Account/rateLimits/readRequest" }),
+ Schema.Struct({
+ id: ClientRequest__RequestId,
+ method: Schema.Literal("account/usage/read").annotate({
+ title: "Account/usage/readRequestMethod",
+ }),
+ params: Schema.optionalKey(Schema.Null),
+ }).annotate({ title: "Account/usage/readRequest" }),
Schema.Struct({
id: ClientRequest__RequestId,
method: Schema.Literal("account/sendAddCreditsNudgeEmail").annotate({
@@ -28891,6 +30381,15 @@ export const ClientRequest = Schema.Union(
{ mode: "oneOf" },
).annotate({ title: "ClientRequest", description: "Request from the client to the server." });
+export type ClientRequest__AdditionalContextEntry = {
+ readonly kind: ClientRequest__AdditionalContextKind;
+ readonly value: string;
+};
+export const ClientRequest__AdditionalContextEntry = Schema.Struct({
+ kind: ClientRequest__AdditionalContextKind,
+ value: Schema.String,
+});
+
export type ClientRequest__ByteRange = { readonly end: number; readonly start: number };
export const ClientRequest__ByteRange = Schema.Struct({
end: Schema.Number.annotate({ format: "uint" })
@@ -28901,6 +30400,27 @@ export const ClientRequest__ByteRange = Schema.Struct({
.check(Schema.isGreaterThanOrEqualTo(0)),
});
+export type ClientRequest__CapabilityRootLocation = {
+ readonly environmentId: string;
+ readonly path: string;
+ readonly type: "environment";
+};
+export const ClientRequest__CapabilityRootLocation = Schema.Union(
+ [
+ Schema.Struct({
+ environmentId: Schema.String,
+ path: Schema.String,
+ type: Schema.Literal("environment").annotate({
+ title: "EnvironmentCapabilityRootLocationType",
+ }),
+ }).annotate({
+ title: "EnvironmentCapabilityRootLocation",
+ description: "A path owned by an execution environment.",
+ }),
+ ],
+ { mode: "oneOf" },
+).annotate({ description: "Location used to resolve a selected capability root." });
+
export type ClientRequest__CollaborationMode = {
readonly mode: ClientRequest__ModeKind;
readonly settings: ClientRequest__Settings;
@@ -28928,71 +30448,6 @@ export const ClientRequest__DynamicToolSpec = Schema.Struct({
export type ClientRequest__NetworkAccess = "restricted" | "enabled";
export const ClientRequest__NetworkAccess = Schema.Literals(["restricted", "enabled"]);
-export type ClientRequest__PermissionProfile =
- | {
- readonly fileSystem: ClientRequest__PermissionProfileFileSystemPermissions;
- readonly network: ClientRequest__PermissionProfileNetworkPermissions;
- readonly type: "managed";
- }
- | { readonly type: "disabled" }
- | {
- readonly network: ClientRequest__PermissionProfileNetworkPermissions;
- readonly type: "external";
- };
-export const ClientRequest__PermissionProfile = Schema.Union(
- [
- Schema.Struct({
- fileSystem: ClientRequest__PermissionProfileFileSystemPermissions,
- network: ClientRequest__PermissionProfileNetworkPermissions,
- type: Schema.Literal("managed").annotate({ title: "ManagedPermissionProfileType" }),
- }).annotate({
- title: "ManagedPermissionProfile",
- description: "Codex owns sandbox construction for this profile.",
- }),
- Schema.Struct({
- type: Schema.Literal("disabled").annotate({ title: "DisabledPermissionProfileType" }),
- }).annotate({
- title: "DisabledPermissionProfile",
- description: "Do not apply an outer sandbox.",
- }),
- Schema.Struct({
- network: ClientRequest__PermissionProfileNetworkPermissions,
- type: Schema.Literal("external").annotate({ title: "ExternalPermissionProfileType" }),
- }).annotate({
- title: "ExternalPermissionProfile",
- description: "Filesystem isolation is enforced by an external caller.",
- }),
- ],
- { mode: "oneOf" },
-);
-
-export type ClientRequest__PermissionProfileSelectionParams = {
- readonly id: string;
- readonly modifications?: ReadonlyArray<ClientRequest__PermissionProfileModificationParams> | null;
- readonly type: "profile";
-};
-export const ClientRequest__PermissionProfileSelectionParams = Schema.Union(
- [
- Schema.Struct({
- id: Schema.String,
- modifications: Schema.optionalKey(
- Schema.Union([
- Schema.Array(ClientRequest__PermissionProfileModificationParams),
- Schema.Null,
- ]),
- ),
- type: Schema.Literal("profile").annotate({
- title: "ProfilePermissionProfileSelectionParamsType",
- }),
- }).annotate({
- title: "ProfilePermissionProfileSelectionParams",
- description:
- "Select a named built-in or user-defined profile and optionally apply bounded modifications that Codex knows how to validate.",
- }),
- ],
- { mode: "oneOf" },
-);
-
export type ClientRequest__ProcessTerminalSize = { readonly cols: number; readonly rows: number };
export const ClientRequest__ProcessTerminalSize = Schema.Struct({
cols: Schema.Number.annotate({
@@ -29009,6 +30464,9 @@ export const ClientRequest__ProcessTerminalSize = Schema.Struct({
.check(Schema.isGreaterThanOrEqualTo(0)),
}).annotate({ description: "PTY size in character cells for `process/spawn` PTY sessions." });
+export type ClientRequest__RealtimeConversationVersion = "v1" | "v2";
+export const ClientRequest__RealtimeConversationVersion = Schema.Literals(["v1", "v2"]);
+
export type ClientRequest__RealtimeOutputModality = "text" | "audio";
export const ClientRequest__RealtimeOutputModality = Schema.Literals(["text", "audio"]);
@@ -29062,6 +30520,12 @@ export type ClientRequest__ResponseItem =
readonly role: string;
readonly type: "message";
}
+ | {
+ readonly author: string;
+ readonly content: ReadonlyArray<ClientRequest__AgentMessageInputContent>;
+ readonly recipient: string;
+ readonly type: "agent_message";
+ }
| {
readonly content?: ReadonlyArray<ClientRequest__ReasoningItemContent> | null;
readonly encrypted_content?: string | null;
@@ -29131,6 +30595,7 @@ export type ClientRequest__ResponseItem =
readonly type: "image_generation_call";
}
| { readonly encrypted_content: string; readonly type: "compaction" }
+ | { readonly type: "compaction_trigger" }
| { readonly encrypted_content?: string | null; readonly type: "context_compaction" }
| { readonly type: "other" };
export const ClientRequest__ResponseItem = Schema.Union(
@@ -29144,6 +30609,12 @@ export const ClientRequest__ResponseItem = Schema.Union(
role: Schema.String,
type: Schema.Literal("message").annotate({ title: "MessageResponseItemType" }),
}).annotate({ title: "MessageResponseItem" }),
+ Schema.Struct({
+ author: Schema.String,
+ content: Schema.Array(ClientRequest__AgentMessageInputContent),
+ recipient: Schema.String,
+ type: Schema.Literal("agent_message").annotate({ title: "AgentMessageResponseItemType" }),
+ }).annotate({ title: "AgentMessageResponseItem" }),
Schema.Struct({
content: Schema.optionalKey(
Schema.Union([Schema.Array(ClientRequest__ReasoningItemContent), Schema.Null]),
@@ -29255,6 +30726,11 @@ export const ClientRequest__ResponseItem = Schema.Union(
encrypted_content: Schema.String,
type: Schema.Literal("compaction").annotate({ title: "CompactionResponseItemType" }),
}).annotate({ title: "CompactionResponseItem" }),
+ Schema.Struct({
+ type: Schema.Literal("compaction_trigger").annotate({
+ title: "CompactionTriggerResponseItemType",
+ }),
+ }).annotate({ title: "CompactionTriggerResponseItem" }),
Schema.Struct({
encrypted_content: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
type: Schema.Literal("context_compaction").annotate({
@@ -29268,13 +30744,36 @@ export const ClientRequest__ResponseItem = Schema.Union(
{ mode: "oneOf" },
);
-export type ClientRequest__ThreadGoalStatus = "active" | "paused" | "budgetLimited" | "complete";
-export const ClientRequest__ThreadGoalStatus = Schema.Literals([
- "active",
- "paused",
- "budgetLimited",
- "complete",
-]);
+export type ClientRequest__SelectedCapabilityRoot = {
+ readonly id: string;
+ readonly location: {
+ readonly environmentId: string;
+ readonly path: string;
+ readonly type: "environment";
+ };
+};
+export const ClientRequest__SelectedCapabilityRoot = Schema.Struct({
+ id: Schema.String.annotate({
+ description: "Stable identifier supplied by the capability selection platform.",
+ }),
+ location: Schema.Union(
+ [
+ Schema.Struct({
+ environmentId: Schema.String,
+ path: Schema.String,
+ type: Schema.Literal("environment").annotate({
+ title: "EnvironmentCapabilityRootLocationType",
+ }),
+ }).annotate({
+ title: "EnvironmentCapabilityRootLocation",
+ description: "A path owned by an execution environment.",
+ }),
+ ],
+ { mode: "oneOf" },
+ ).annotate({ description: "Location used to resolve a selected capability root." }),
+}).annotate({
+ description: "A user-selected root that can expose one or more runtime capabilities.",
+});
export type ClientRequest__ThreadMemoryMode = "enabled" | "disabled";
export const ClientRequest__ThreadMemoryMode = Schema.Literals(["enabled", "disabled"]);
@@ -29326,6 +30825,32 @@ export const ClientRequest__ThreadRealtimeStartTransport = Schema.Union(
{ mode: "oneOf" },
).annotate({ description: "EXPERIMENTAL - transport used by thread realtime." });
+export type ClientRequest__ThreadResumeInitialTurnsPageParams = {
+ readonly itemsView?: ClientRequest__TurnItemsView | null;
+ readonly limit?: number | null;
+ readonly sortDirection?: ClientRequest__SortDirection | null;
+};
+export const ClientRequest__ThreadResumeInitialTurnsPageParams = Schema.Struct({
+ itemsView: Schema.optionalKey(
+ Schema.Union([ClientRequest__TurnItemsView, Schema.Null]).annotate({
+ description: "How much item detail to include for each returned turn; defaults to summary.",
+ }),
+ ),
+ limit: Schema.optionalKey(
+ Schema.Union([
+ Schema.Number.annotate({ description: "Optional turn page size.", format: "uint32" })
+ .check(Schema.isInt())
+ .check(Schema.isGreaterThanOrEqualTo(0)),
+ Schema.Null,
+ ]),
+ ),
+ sortDirection: Schema.optionalKey(
+ Schema.Union([ClientRequest__SortDirection, Schema.Null]).annotate({
+ description: "Optional turn pagination direction; defaults to descending.",
+ }),
+ ),
+});
+
export type ClientRequest__TurnEnvironmentParams = {
readonly cwd: ClientRequest__AbsolutePathBuf;
readonly environmentId: string;
@@ -29335,9 +30860,6 @@ export const ClientRequest__TurnEnvironmentParams = Schema.Struct({
environmentId: Schema.String,
});
-export type ClientRequest__TurnItemsView = "notLoaded" | "summary" | "full";
-export const ClientRequest__TurnItemsView = Schema.Literals(["notLoaded", "summary", "full"]);
-
export type CommandExecutionRequestApprovalParams = {
readonly approvalId?: string | null;
readonly command?: string | null;
@@ -29348,6 +30870,7 @@ export type CommandExecutionRequestApprovalParams = {
readonly proposedExecpolicyAmendment?: ReadonlyArray<string> | null;
readonly proposedNetworkPolicyAmendments?: ReadonlyArray<CommandExecutionRequestApprovalParams__NetworkPolicyAmendment> | null;
readonly reason?: string | null;
+ readonly startedAtMs: number;
readonly threadId: string;
readonly turnId: string;
};
@@ -29413,6 +30936,10 @@ export const CommandExecutionRequestApprovalParams = Schema.Struct({
Schema.Null,
]),
),
+ startedAtMs: Schema.Number.annotate({
+ description: "Unix timestamp (in milliseconds) when this approval request started.",
+ format: "int64",
+ }).check(Schema.isInt()),
threadId: Schema.String,
turnId: Schema.String,
}).annotate({ title: "CommandExecutionRequestApprovalParams" });
@@ -29556,6 +31083,7 @@ export type FileChangeRequestApprovalParams = {
readonly grantRoot?: string | null;
readonly itemId: string;
readonly reason?: string | null;
+ readonly startedAtMs: number;
readonly threadId: string;
readonly turnId: string;
};
@@ -29578,6 +31106,10 @@ export const FileChangeRequestApprovalParams = Schema.Struct({
Schema.Null,
]),
),
+ startedAtMs: Schema.Number.annotate({
+ description: "Unix timestamp (in milliseconds) when this approval request started.",
+ format: "int64",
+ }).check(Schema.isInt()),
threadId: Schema.String,
turnId: Schema.String,
}).annotate({ title: "FileChangeRequestApprovalParams" });
@@ -29824,17 +31356,24 @@ export const McpServerElicitationRequestResponse = Schema.Struct({
export type PermissionsRequestApprovalParams = {
readonly cwd: PermissionsRequestApprovalParams__AbsolutePathBuf;
+ readonly environmentId?: string | null;
readonly itemId: string;
readonly permissions: PermissionsRequestApprovalParams__RequestPermissionProfile;
readonly reason?: string | null;
+ readonly startedAtMs: number;
readonly threadId: string;
readonly turnId: string;
};
export const PermissionsRequestApprovalParams = Schema.Struct({
cwd: PermissionsRequestApprovalParams__AbsolutePathBuf,
+ environmentId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
itemId: Schema.String,
permissions: PermissionsRequestApprovalParams__RequestPermissionProfile,
reason: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ startedAtMs: Schema.Number.annotate({
+ description: "Unix timestamp (in milliseconds) when this approval request started.",
+ format: "int64",
+ }).check(Schema.isInt()),
threadId: Schema.String,
turnId: Schema.String,
}).annotate({ title: "PermissionsRequestApprovalParams" });
@@ -29884,6 +31423,10 @@ export type ServerNotification =
readonly method: "thread/archived";
readonly params: ServerNotification__ThreadArchivedNotification;
}
+ | {
+ readonly method: "thread/deleted";
+ readonly params: ServerNotification__ThreadDeletedNotification;
+ }
| {
readonly method: "thread/unarchived";
readonly params: ServerNotification__ThreadUnarchivedNotification;
@@ -29908,6 +31451,10 @@ export type ServerNotification =
readonly method: "thread/goal/cleared";
readonly params: ServerNotification__ThreadGoalClearedNotification;
}
+ | {
+ readonly method: "thread/settings/updated";
+ readonly params: ServerNotification__ThreadSettingsUpdatedNotification;
+ }
| {
readonly method: "thread/tokenUsage/updated";
readonly params: ServerNotification__ThreadTokenUsageUpdatedNotification;
@@ -30049,6 +31596,10 @@ export type ServerNotification =
readonly method: "model/verification";
readonly params: ServerNotification__ModelVerificationNotification;
}
+ | {
+ readonly method: "turn/moderationMetadata";
+ readonly params: ServerNotification__TurnModerationMetadataNotification;
+ }
| { readonly method: "warning"; readonly params: ServerNotification__WarningNotification }
| {
readonly method: "guardianWarning";
@@ -30138,6 +31689,12 @@ export const ServerNotification = Schema.Union(
}),
params: ServerNotification__ThreadArchivedNotification,
}).annotate({ title: "Thread/archivedNotification" }),
+ Schema.Struct({
+ method: Schema.Literal("thread/deleted").annotate({
+ title: "Thread/deletedNotificationMethod",
+ }),
+ params: ServerNotification__ThreadDeletedNotification,
+ }).annotate({ title: "Thread/deletedNotification" }),
Schema.Struct({
method: Schema.Literal("thread/unarchived").annotate({
title: "Thread/unarchivedNotificationMethod",
@@ -30174,6 +31731,12 @@ export const ServerNotification = Schema.Union(
}),
params: ServerNotification__ThreadGoalClearedNotification,
}).annotate({ title: "Thread/goal/clearedNotification" }),
+ Schema.Struct({
+ method: Schema.Literal("thread/settings/updated").annotate({
+ title: "Thread/settings/updatedNotificationMethod",
+ }),
+ params: ServerNotification__ThreadSettingsUpdatedNotification,
+ }).annotate({ title: "Thread/settings/updatedNotification" }),
Schema.Struct({
method: Schema.Literal("thread/tokenUsage/updated").annotate({
title: "Thread/tokenUsage/updatedNotificationMethod",
@@ -30402,6 +31965,12 @@ export const ServerNotification = Schema.Union(
}),
params: ServerNotification__ModelVerificationNotification,
}).annotate({ title: "Model/verificationNotification" }),
+ Schema.Struct({
+ method: Schema.Literal("turn/moderationMetadata").annotate({
+ title: "Turn/moderationMetadataNotificationMethod",
+ }),
+ params: ServerNotification__TurnModerationMetadataNotification,
+ }).annotate({ title: "Turn/moderationMetadataNotification" }),
Schema.Struct({
method: Schema.Literal("warning").annotate({ title: "WarningNotificationMethod" }),
params: ServerNotification__WarningNotification,
@@ -30570,6 +32139,7 @@ export type ServerNotification__HookSource =
| "sessionFlags"
| "plugin"
| "cloudRequirements"
+ | "cloudManagedConfig"
| "legacyManagedConfigFile"
| "legacyManagedConfigMdm"
| "unknown";
@@ -30581,11 +32151,15 @@ export const ServerNotification__HookSource = Schema.Literals([
"sessionFlags",
"plugin",
"cloudRequirements",
+ "cloudManagedConfig",
"legacyManagedConfigFile",
"legacyManagedConfigMdm",
"unknown",
]);
+export type ServerNotification__NetworkAccess = "restricted" | "enabled";
+export const ServerNotification__NetworkAccess = Schema.Literals(["restricted", "enabled"]);
+
export type ServerNotification__ProcessOutputStream = "stdout" | "stderr";
export const ServerNotification__ProcessOutputStream = Schema.Literals([
"stdout",
@@ -30650,6 +32224,11 @@ export type ServerRequest =
readonly method: "account/chatgptAuthTokens/refresh";
readonly params: ServerRequest__ChatgptAuthTokensRefreshParams;
}
+ | {
+ readonly id: ServerRequest__RequestId;
+ readonly method: "attestation/generate";
+ readonly params: ServerRequest__AttestationGenerateParams;
+ }
| {
readonly id: ServerRequest__RequestId;
readonly method: "applyPatchApproval";
@@ -30729,6 +32308,16 @@ export const ServerRequest = Schema.Union(
}),
params: ServerRequest__ChatgptAuthTokensRefreshParams,
}).annotate({ title: "Account/chatgptAuthTokens/refreshRequest" }),
+ Schema.Struct({
+ id: ServerRequest__RequestId,
+ method: Schema.Literal("attestation/generate").annotate({
+ title: "Attestation/generateRequestMethod",
+ }),
+ params: ServerRequest__AttestationGenerateParams,
+ }).annotate({
+ title: "Attestation/generateRequest",
+ description: "Generate a fresh upstream attestation result on demand.",
+ }),
Schema.Struct({
id: ServerRequest__RequestId,
method: Schema.Literal("applyPatchApproval").annotate({
@@ -30905,7 +32494,11 @@ export type V2AccountRateLimitsUpdatedNotification = {
};
export const V2AccountRateLimitsUpdatedNotification = Schema.Struct({
rateLimits: V2AccountRateLimitsUpdatedNotification__RateLimitSnapshot,
-}).annotate({ title: "AccountRateLimitsUpdatedNotification" });
+}).annotate({
+ title: "AccountRateLimitsUpdatedNotification",
+ description:
+ "Sparse rolling rate-limit update.\n\nClients should merge available values into the most recent `account/rateLimits/read` response or refetch that snapshot. Nullable account metadata may be unavailable in a rolling update and does not clear a previously observed value.",
+});
export type V2AccountUpdatedNotification = {
readonly authMode?: V2AccountUpdatedNotification__AuthMode | null;
@@ -31160,44 +32753,6 @@ export const V2CommandExecParams = Schema.Struct({
export type V2CommandExecParams__NetworkAccess = "restricted" | "enabled";
export const V2CommandExecParams__NetworkAccess = Schema.Literals(["restricted", "enabled"]);
-export type V2CommandExecParams__PermissionProfile =
- | {
- readonly fileSystem: V2CommandExecParams__PermissionProfileFileSystemPermissions;
- readonly network: V2CommandExecParams__PermissionProfileNetworkPermissions;
- readonly type: "managed";
- }
- | { readonly type: "disabled" }
- | {
- readonly network: V2CommandExecParams__PermissionProfileNetworkPermissions;
- readonly type: "external";
- };
-export const V2CommandExecParams__PermissionProfile = Schema.Union(
- [
- Schema.Struct({
- fileSystem: V2CommandExecParams__PermissionProfileFileSystemPermissions,
- network: V2CommandExecParams__PermissionProfileNetworkPermissions,
- type: Schema.Literal("managed").annotate({ title: "ManagedPermissionProfileType" }),
- }).annotate({
- title: "ManagedPermissionProfile",
- description: "Codex owns sandbox construction for this profile.",
- }),
- Schema.Struct({
- type: Schema.Literal("disabled").annotate({ title: "DisabledPermissionProfileType" }),
- }).annotate({
- title: "DisabledPermissionProfile",
- description: "Do not apply an outer sandbox.",
- }),
- Schema.Struct({
- network: V2CommandExecParams__PermissionProfileNetworkPermissions,
- type: Schema.Literal("external").annotate({ title: "ExternalPermissionProfileType" }),
- }).annotate({
- title: "ExternalPermissionProfile",
- description: "Filesystem isolation is enforced by an external caller.",
- }),
- ],
- { mode: "oneOf" },
-);
-
export type V2CommandExecResizeParams = {
readonly processId: string;
readonly size: { readonly cols: number; readonly rows: number };
@@ -31372,7 +32927,7 @@ export const V2ConfigReadParams = Schema.Struct({
Schema.Null,
]),
),
- includeLayers: Schema.optionalKey(Schema.Boolean.annotate({ default: false })),
+ includeLayers: Schema.optionalKey(Schema.Boolean),
}).annotate({ title: "ConfigReadParams" });
export type V2ConfigReadResponse = {
@@ -31389,6 +32944,7 @@ export const V2ConfigReadResponse = Schema.Struct({
}).annotate({ title: "ConfigReadResponse" });
export type V2ConfigReadResponse__AppConfig = {
+ readonly approvals_reviewer?: V2ConfigReadResponse__ApprovalsReviewer | null;
readonly default_tools_approval_mode?: V2ConfigReadResponse__AppToolApproval | null;
readonly default_tools_enabled?: boolean | null;
readonly destructive_enabled?: boolean | null;
@@ -31397,6 +32953,9 @@ export type V2ConfigReadResponse__AppConfig = {
readonly tools?: V2ConfigReadResponse__AppToolsConfig | null;
};
export const V2ConfigReadResponse__AppConfig = Schema.Struct({
+ approvals_reviewer: Schema.optionalKey(
+ Schema.Union([V2ConfigReadResponse__ApprovalsReviewer, Schema.Null]),
+ ),
default_tools_approval_mode: Schema.optionalKey(
Schema.Union([V2ConfigReadResponse__AppToolApproval, Schema.Null]),
),
@@ -31460,6 +33019,8 @@ export type V2ConfigRequirementsReadResponse__ManagedHooksRequirements = {
readonly PreToolUse: ReadonlyArray<V2ConfigRequirementsReadResponse__ConfiguredHookMatcherGroup>;
readonly SessionStart: ReadonlyArray<V2ConfigRequirementsReadResponse__ConfiguredHookMatcherGroup>;
readonly Stop: ReadonlyArray<V2ConfigRequirementsReadResponse__ConfiguredHookMatcherGroup>;
+ readonly SubagentStart: ReadonlyArray<V2ConfigRequirementsReadResponse__ConfiguredHookMatcherGroup>;
+ readonly SubagentStop: ReadonlyArray<V2ConfigRequirementsReadResponse__ConfiguredHookMatcherGroup>;
readonly UserPromptSubmit: ReadonlyArray<V2ConfigRequirementsReadResponse__ConfiguredHookMatcherGroup>;
readonly managedDir?: string | null;
readonly windowsManagedDir?: string | null;
@@ -31472,6 +33033,8 @@ export const V2ConfigRequirementsReadResponse__ManagedHooksRequirements = Schema
PreToolUse: Schema.Array(V2ConfigRequirementsReadResponse__ConfiguredHookMatcherGroup),
SessionStart: Schema.Array(V2ConfigRequirementsReadResponse__ConfiguredHookMatcherGroup),
Stop: Schema.Array(V2ConfigRequirementsReadResponse__ConfiguredHookMatcherGroup),
+ SubagentStart: Schema.Array(V2ConfigRequirementsReadResponse__ConfiguredHookMatcherGroup),
+ SubagentStop: Schema.Array(V2ConfigRequirementsReadResponse__ConfiguredHookMatcherGroup),
UserPromptSubmit: Schema.Array(V2ConfigRequirementsReadResponse__ConfiguredHookMatcherGroup),
managedDir: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
windowsManagedDir: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
@@ -31703,6 +33266,7 @@ export const V2ExperimentalFeatureEnablementSetResponse = Schema.Struct({
export type V2ExperimentalFeatureListParams = {
readonly cursor?: string | null;
readonly limit?: number | null;
+ readonly threadId?: string | null;
};
export const V2ExperimentalFeatureListParams = Schema.Struct({
cursor: Schema.optionalKey(
@@ -31724,6 +33288,15 @@ export const V2ExperimentalFeatureListParams = Schema.Struct({
Schema.Null,
]),
),
+ threadId: Schema.optionalKey(
+ Schema.Union([
+ Schema.String.annotate({
+ description:
+ "Optional loaded thread id. Pass this when showing feature state for an existing thread so enablement is computed from that thread's refreshed config, including project-local config for the thread's cwd.",
+ }),
+ Schema.Null,
+ ]),
+ ),
}).annotate({ title: "ExperimentalFeatureListParams" });
export type V2ExperimentalFeatureListResponse = {
@@ -31804,7 +33377,7 @@ export const V2ExternalAgentConfigImportResponse = Schema.Struct({}).annotate({
export type V2FeedbackUploadParams = {
readonly classification: string;
readonly extraLogFiles?: ReadonlyArray<string> | null;
- readonly includeLogs: boolean;
+ readonly includeLogs?: boolean;
readonly reason?: string | null;
readonly tags?: { readonly [x: string]: string } | null;
readonly threadId?: string | null;
@@ -31812,7 +33385,7 @@ export type V2FeedbackUploadParams = {
export const V2FeedbackUploadParams = Schema.Struct({
classification: Schema.String,
extraLogFiles: Schema.optionalKey(Schema.Union([Schema.Array(Schema.String), Schema.Null])),
- includeLogs: Schema.Boolean,
+ includeLogs: Schema.optionalKey(Schema.Boolean),
reason: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
tags: Schema.optionalKey(
Schema.Union([Schema.Record(Schema.String, Schema.String), Schema.Null]),
@@ -32157,7 +33730,6 @@ export const V2GetAccountParams = Schema.Struct({
Schema.Boolean.annotate({
description:
"When `true`, requests a proactive token refresh before returning.\n\nIn managed auth mode this triggers the normal refresh-token flow. In external auth mode this flag is ignored. Clients should refresh tokens themselves and call `account/login/start` with `chatgptAuthTokens`.",
- default: false,
}),
),
}).annotate({ title: "GetAccountParams" });
@@ -32165,6 +33737,7 @@ export const V2GetAccountParams = Schema.Struct({
export type V2GetAccountRateLimitsResponse = {
readonly rateLimits: {
readonly credits?: V2GetAccountRateLimitsResponse__CreditsSnapshot | null;
+ readonly individualLimit?: V2GetAccountRateLimitsResponse__SpendControlLimitSnapshot | null;
readonly limitId?: string | null;
readonly limitName?: string | null;
readonly planType?: V2GetAccountRateLimitsResponse__PlanType | null;
@@ -32181,6 +33754,9 @@ export const V2GetAccountRateLimitsResponse = Schema.Struct({
credits: Schema.optionalKey(
Schema.Union([V2GetAccountRateLimitsResponse__CreditsSnapshot, Schema.Null]),
),
+ individualLimit: Schema.optionalKey(
+ Schema.Union([V2GetAccountRateLimitsResponse__SpendControlLimitSnapshot, Schema.Null]),
+ ),
limitId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
limitName: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
planType: Schema.optionalKey(
@@ -32217,6 +33793,20 @@ export const V2GetAccountResponse = Schema.Struct({
requiresOpenaiAuth: Schema.Boolean,
}).annotate({ title: "GetAccountResponse" });
+export type V2GetAccountTokenUsageResponse = {
+ readonly dailyUsageBuckets?: ReadonlyArray<V2GetAccountTokenUsageResponse__AccountTokenUsageDailyBucket> | null;
+ readonly summary: V2GetAccountTokenUsageResponse__AccountTokenUsageSummary;
+};
+export const V2GetAccountTokenUsageResponse = Schema.Struct({
+ dailyUsageBuckets: Schema.optionalKey(
+ Schema.Union([
+ Schema.Array(V2GetAccountTokenUsageResponse__AccountTokenUsageDailyBucket),
+ Schema.Null,
+ ]),
+ ),
+ summary: V2GetAccountTokenUsageResponse__AccountTokenUsageSummary,
+}).annotate({ title: "GetAccountTokenUsageResponse" });
+
export type V2GuardianWarningNotification = { readonly message: string; readonly threadId: string };
export const V2GuardianWarningNotification = Schema.Struct({
message: Schema.String.annotate({
@@ -32244,6 +33834,7 @@ export type V2HookCompletedNotification__HookSource =
| "sessionFlags"
| "plugin"
| "cloudRequirements"
+ | "cloudManagedConfig"
| "legacyManagedConfigFile"
| "legacyManagedConfigMdm"
| "unknown";
@@ -32255,6 +33846,7 @@ export const V2HookCompletedNotification__HookSource = Schema.Literals([
"sessionFlags",
"plugin",
"cloudRequirements",
+ "cloudManagedConfig",
"legacyManagedConfigFile",
"legacyManagedConfigMdm",
"unknown",
@@ -32295,6 +33887,7 @@ export type V2HookStartedNotification__HookSource =
| "sessionFlags"
| "plugin"
| "cloudRequirements"
+ | "cloudManagedConfig"
| "legacyManagedConfigFile"
| "legacyManagedConfigMdm"
| "unknown";
@@ -32306,6 +33899,7 @@ export const V2HookStartedNotification__HookSource = Schema.Literals([
"sessionFlags",
"plugin",
"cloudRequirements",
+ "cloudManagedConfig",
"legacyManagedConfigFile",
"legacyManagedConfigMdm",
"unknown",
@@ -32378,18 +33972,28 @@ export const V2ItemCompletedNotification__CommandExecutionSource = Schema.Litera
export type V2ItemGuardianApprovalReviewCompletedNotification = {
readonly action: V2ItemGuardianApprovalReviewCompletedNotification__GuardianApprovalReviewAction;
+ readonly completedAtMs: number;
readonly decisionSource: V2ItemGuardianApprovalReviewCompletedNotification__AutoReviewDecisionSource;
readonly review: V2ItemGuardianApprovalReviewCompletedNotification__GuardianApprovalReview;
readonly reviewId: string;
+ readonly startedAtMs: number;
readonly targetItemId?: string | null;
readonly threadId: string;
readonly turnId: string;
};
export const V2ItemGuardianApprovalReviewCompletedNotification = Schema.Struct({
action: V2ItemGuardianApprovalReviewCompletedNotification__GuardianApprovalReviewAction,
+ completedAtMs: Schema.Number.annotate({
+ description: "Unix timestamp (in milliseconds) when this review completed.",
+ format: "int64",
+ }).check(Schema.isInt()),
decisionSource: V2ItemGuardianApprovalReviewCompletedNotification__AutoReviewDecisionSource,
review: V2ItemGuardianApprovalReviewCompletedNotification__GuardianApprovalReview,
reviewId: Schema.String.annotate({ description: "Stable identifier for this review." }),
+ startedAtMs: Schema.Number.annotate({
+ description: "Unix timestamp (in milliseconds) when this review started.",
+ format: "int64",
+ }).check(Schema.isInt()),
targetItemId: Schema.optionalKey(
Schema.Union([
Schema.String.annotate({
@@ -32411,6 +34015,7 @@ export type V2ItemGuardianApprovalReviewStartedNotification = {
readonly action: V2ItemGuardianApprovalReviewStartedNotification__GuardianApprovalReviewAction;
readonly review: V2ItemGuardianApprovalReviewStartedNotification__GuardianApprovalReview;
readonly reviewId: string;
+ readonly startedAtMs: number;
readonly targetItemId?: string | null;
readonly threadId: string;
readonly turnId: string;
@@ -32419,6 +34024,10 @@ export const V2ItemGuardianApprovalReviewStartedNotification = Schema.Struct({
action: V2ItemGuardianApprovalReviewStartedNotification__GuardianApprovalReviewAction,
review: V2ItemGuardianApprovalReviewStartedNotification__GuardianApprovalReview,
reviewId: Schema.String.annotate({ description: "Stable identifier for this review." }),
+ startedAtMs: Schema.Number.annotate({
+ description: "Unix timestamp (in milliseconds) when this review started.",
+ format: "int64",
+ }).check(Schema.isInt()),
targetItemId: Schema.optionalKey(
Schema.Union([
Schema.String.annotate({
@@ -32502,6 +34111,7 @@ export type V2ListMcpServerStatusParams = {
readonly cursor?: string | null;
readonly detail?: V2ListMcpServerStatusParams__McpServerStatusDetail | null;
readonly limit?: number | null;
+ readonly threadId?: string | null;
};
export const V2ListMcpServerStatusParams = Schema.Struct({
cursor: Schema.optionalKey(
@@ -32529,6 +34139,7 @@ export const V2ListMcpServerStatusParams = Schema.Struct({
Schema.Null,
]),
),
+ threadId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
}).annotate({ title: "ListMcpServerStatusParams" });
export type V2ListMcpServerStatusResponse = {
@@ -32761,11 +34372,13 @@ export type V2McpServerStatusUpdatedNotification = {
readonly error?: string | null;
readonly name: string;
readonly status: V2McpServerStatusUpdatedNotification__McpServerStartupState;
+ readonly threadId?: string | null;
};
export const V2McpServerStatusUpdatedNotification = Schema.Struct({
error: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
name: Schema.String,
status: V2McpServerStatusUpdatedNotification__McpServerStartupState,
+ threadId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
}).annotate({ title: "McpServerStatusUpdatedNotification" });
export type V2McpServerToolCallParams = {
@@ -32903,6 +34516,58 @@ export const V2ModelVerificationNotification = Schema.Struct({
verifications: Schema.Array(V2ModelVerificationNotification__ModelVerification),
}).annotate({ title: "ModelVerificationNotification" });
+export type V2PermissionProfileListParams = {
+ readonly cursor?: string | null;
+ readonly cwd?: string | null;
+ readonly limit?: number | null;
+};
+export const V2PermissionProfileListParams = Schema.Struct({
+ cursor: Schema.optionalKey(
+ Schema.Union([
+ Schema.String.annotate({
+ description: "Opaque pagination cursor returned by a previous call.",
+ }),
+ Schema.Null,
+ ]),
+ ),
+ cwd: Schema.optionalKey(
+ Schema.Union([
+ Schema.String.annotate({
+ description: "Optional working directory to resolve project config layers.",
+ }),
+ Schema.Null,
+ ]),
+ ),
+ limit: Schema.optionalKey(
+ Schema.Union([
+ Schema.Number.annotate({
+ description: "Optional page size; defaults to the full result set.",
+ format: "uint32",
+ })
+ .check(Schema.isInt())
+ .check(Schema.isGreaterThanOrEqualTo(0)),
+ Schema.Null,
+ ]),
+ ),
+}).annotate({ title: "PermissionProfileListParams" });
+
+export type V2PermissionProfileListResponse = {
+ readonly data: ReadonlyArray<V2PermissionProfileListResponse__PermissionProfileSummary>;
+ readonly nextCursor?: string | null;
+};
+export const V2PermissionProfileListResponse = Schema.Struct({
+ data: Schema.Array(V2PermissionProfileListResponse__PermissionProfileSummary),
+ nextCursor: Schema.optionalKey(
+ Schema.Union([
+ Schema.String.annotate({
+ description:
+ "Opaque cursor to pass to the next call to continue after the last item. If None, there are no more items to return.",
+ }),
+ Schema.Null,
+ ]),
+ ),
+}).annotate({ title: "PermissionProfileListResponse" });
+
export type V2PlanDeltaNotification = {
readonly delta: string;
readonly itemId: string;
@@ -32920,6 +34585,47 @@ export const V2PlanDeltaNotification = Schema.Struct({
"EXPERIMENTAL - proposed plan streaming deltas for plan items. Clients should not assume concatenated deltas match the completed plan item content.",
});
+export type V2PluginInstalledParams = {
+ readonly cwds?: ReadonlyArray<V2PluginInstalledParams__AbsolutePathBuf> | null;
+ readonly installSuggestionPluginNames?: ReadonlyArray<string> | null;
+};
+export const V2PluginInstalledParams = Schema.Struct({
+ cwds: Schema.optionalKey(
+ Schema.Union([
+ Schema.Array(V2PluginInstalledParams__AbsolutePathBuf).annotate({
+ description: "Optional working directories used to discover repo marketplaces.",
+ }),
+ Schema.Null,
+ ]),
+ ),
+ installSuggestionPluginNames: Schema.optionalKey(
+ Schema.Union([
+ Schema.Array(Schema.String).annotate({
+ description:
+ "Additional uninstalled plugin names that should be returned when present locally. This is used by mention surfaces that intentionally expose install entrypoints.",
+ }),
+ Schema.Null,
+ ]),
+ ),
+}).annotate({ title: "PluginInstalledParams" });
+
+export type V2PluginInstalledResponse = {
+ readonly marketplaceLoadErrors?: ReadonlyArray<V2PluginInstalledResponse__MarketplaceLoadErrorInfo>;
+ readonly marketplaces: ReadonlyArray<V2PluginInstalledResponse__PluginMarketplaceEntry>;
+};
+export const V2PluginInstalledResponse = Schema.Struct({
+ marketplaceLoadErrors: Schema.optionalKey(
+ Schema.Array(V2PluginInstalledResponse__MarketplaceLoadErrorInfo).annotate({ default: [] }),
+ ),
+ marketplaces: Schema.Array(V2PluginInstalledResponse__PluginMarketplaceEntry),
+}).annotate({ title: "PluginInstalledResponse" });
+
+export type V2PluginInstalledResponse__PluginAvailability = "DISABLED_BY_ADMIN" | "AVAILABLE";
+export const V2PluginInstalledResponse__PluginAvailability = Schema.Literals([
+ "DISABLED_BY_ADMIN",
+ "AVAILABLE",
+]);
+
export type V2PluginInstallParams = {
readonly marketplacePath?: V2PluginInstallParams__AbsolutePathBuf | null;
readonly pluginName: string;
@@ -33010,6 +34716,30 @@ export const V2PluginReadResponse__PluginAvailability = Schema.Literals([
"AVAILABLE",
]);
+export type V2PluginShareCheckoutParams = { readonly remotePluginId: string };
+export const V2PluginShareCheckoutParams = Schema.Struct({
+ remotePluginId: Schema.String,
+}).annotate({ title: "PluginShareCheckoutParams" });
+
+export type V2PluginShareCheckoutResponse = {
+ readonly marketplaceName: string;
+ readonly marketplacePath: V2PluginShareCheckoutResponse__AbsolutePathBuf;
+ readonly pluginId: string;
+ readonly pluginName: string;
+ readonly pluginPath: V2PluginShareCheckoutResponse__AbsolutePathBuf;
+ readonly remotePluginId: string;
+ readonly remoteVersion?: string | null;
+};
+export const V2PluginShareCheckoutResponse = Schema.Struct({
+ marketplaceName: Schema.String,
+ marketplacePath: V2PluginShareCheckoutResponse__AbsolutePathBuf,
+ pluginId: Schema.String,
+ pluginName: Schema.String,
+ pluginPath: V2PluginShareCheckoutResponse__AbsolutePathBuf,
+ remotePluginId: Schema.String,
+ remoteVersion: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+}).annotate({ title: "PluginShareCheckoutResponse" });
+
export type V2PluginShareDeleteParams = { readonly remotePluginId: string };
export const V2PluginShareDeleteParams = Schema.Struct({ remotePluginId: Schema.String }).annotate({
title: "PluginShareDeleteParams",
@@ -33065,18 +34795,22 @@ export const V2PluginShareSaveResponse = Schema.Struct({
}).annotate({ title: "PluginShareSaveResponse" });
export type V2PluginShareUpdateTargetsParams = {
+ readonly discoverability: V2PluginShareUpdateTargetsParams__PluginShareUpdateDiscoverability;
readonly remotePluginId: string;
readonly shareTargets: ReadonlyArray<V2PluginShareUpdateTargetsParams__PluginShareTarget>;
};
export const V2PluginShareUpdateTargetsParams = Schema.Struct({
+ discoverability: V2PluginShareUpdateTargetsParams__PluginShareUpdateDiscoverability,
remotePluginId: Schema.String,
shareTargets: Schema.Array(V2PluginShareUpdateTargetsParams__PluginShareTarget),
}).annotate({ title: "PluginShareUpdateTargetsParams" });
export type V2PluginShareUpdateTargetsResponse = {
+ readonly discoverability: V2PluginShareUpdateTargetsResponse__PluginShareDiscoverability;
readonly principals: ReadonlyArray<V2PluginShareUpdateTargetsResponse__PluginSharePrincipal>;
};
export const V2PluginShareUpdateTargetsResponse = Schema.Struct({
+ discoverability: V2PluginShareUpdateTargetsResponse__PluginShareDiscoverability,
principals: Schema.Array(V2PluginShareUpdateTargetsResponse__PluginSharePrincipal),
}).annotate({ title: "PluginShareUpdateTargetsResponse" });
@@ -33227,14 +34961,18 @@ export const V2ReasoningTextDeltaNotification = Schema.Struct({
export type V2RemoteControlStatusChangedNotification = {
readonly environmentId?: string | null;
+ readonly installationId: string;
+ readonly serverName: string;
readonly status: V2RemoteControlStatusChangedNotification__RemoteControlConnectionStatus;
};
export const V2RemoteControlStatusChangedNotification = Schema.Struct({
environmentId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ installationId: Schema.String,
+ serverName: Schema.String,
status: V2RemoteControlStatusChangedNotification__RemoteControlConnectionStatus,
}).annotate({
title: "RemoteControlStatusChangedNotification",
- description: "Current remote-control connection status and environment id exposed to clients.",
+ description: "Current remote-control connection status and remote identity exposed to clients.",
});
export type V2ReviewStartParams = {
@@ -33370,10 +35108,21 @@ export const V2SkillsConfigWriteResponse = Schema.Struct({
effectiveEnabled: Schema.Boolean,
}).annotate({ title: "SkillsConfigWriteResponse" });
+export type V2SkillsExtraRootsSetParams = {
+ readonly extraRoots: ReadonlyArray<V2SkillsExtraRootsSetParams__AbsolutePathBuf>;
+};
+export const V2SkillsExtraRootsSetParams = Schema.Struct({
+ extraRoots: Schema.Array(V2SkillsExtraRootsSetParams__AbsolutePathBuf),
+}).annotate({ title: "SkillsExtraRootsSetParams" });
+
+export type V2SkillsExtraRootsSetResponse = {};
+export const V2SkillsExtraRootsSetResponse = Schema.Struct({}).annotate({
+ title: "SkillsExtraRootsSetResponse",
+});
+
export type V2SkillsListParams = {
readonly cwds?: ReadonlyArray<string>;
readonly forceReload?: boolean;
- readonly perCwdExtraUserRoots?: ReadonlyArray<V2SkillsListParams__SkillsListExtraRootsForCwd> | null;
};
export const V2SkillsListParams = Schema.Struct({
cwds: Schema.optionalKey(
@@ -33386,14 +35135,6 @@ export const V2SkillsListParams = Schema.Struct({
description: "When true, bypass the skills cache and re-scan skills from disk.",
}),
),
- perCwdExtraUserRoots: Schema.optionalKey(
- Schema.Union([
- Schema.Array(V2SkillsListParams__SkillsListExtraRootsForCwd).annotate({
- description: "Optional per-cwd extra roots to scan as user-scoped skills.",
- }),
- Schema.Null,
- ]),
- ),
}).annotate({ title: "SkillsListParams" });
export type V2SkillsListResponse = {
@@ -33464,6 +35205,19 @@ export const V2ThreadCompactStartResponse = Schema.Struct({}).annotate({
title: "ThreadCompactStartResponse",
});
+export type V2ThreadDeletedNotification = { readonly threadId: string };
+export const V2ThreadDeletedNotification = Schema.Struct({ threadId: Schema.String }).annotate({
+ title: "ThreadDeletedNotification",
+});
+
+export type V2ThreadDeleteParams = { readonly threadId: string };
+export const V2ThreadDeleteParams = Schema.Struct({ threadId: Schema.String }).annotate({
+ title: "ThreadDeleteParams",
+});
+
+export type V2ThreadDeleteResponse = {};
+export const V2ThreadDeleteResponse = Schema.Struct({}).annotate({ title: "ThreadDeleteResponse" });
+
export type V2ThreadForkParams = {
readonly approvalPolicy?: V2ThreadForkParams__AskForApproval | null;
readonly approvalsReviewer?: V2ThreadForkParams__ApprovalsReviewer | null;
@@ -33517,35 +35271,14 @@ export const V2ThreadForkParams = Schema.Struct({
}).annotate({
title: "ThreadForkParams",
description:
- "There are two ways to fork a thread: 1. By thread_id: load the thread from disk by thread_id and fork it into a new thread. 2. By path: load the thread from disk by path and fork it into a new thread.\n\nIf using path, the thread_id param will be ignored.\n\nPrefer using thread_id whenever possible.",
+ "There are two ways to fork a thread: 1. By thread_id: load the thread from disk by thread_id and fork it into a new thread. 2. By path: load the thread from disk by path and fork it into a new thread.\n\nIf using a non-empty path, the thread_id param will be ignored. Empty string path values are treated as absent.\n\nPrefer using thread_id whenever possible.",
});
-export type V2ThreadForkParams__PermissionProfileSelectionParams = {
- readonly id: string;
- readonly modifications?: ReadonlyArray<V2ThreadForkParams__PermissionProfileModificationParams> | null;
- readonly type: "profile";
-};
-export const V2ThreadForkParams__PermissionProfileSelectionParams = Schema.Union(
- [
- Schema.Struct({
- id: Schema.String,
- modifications: Schema.optionalKey(
- Schema.Union([
- Schema.Array(V2ThreadForkParams__PermissionProfileModificationParams),
- Schema.Null,
- ]),
- ),
- type: Schema.Literal("profile").annotate({
- title: "ProfilePermissionProfileSelectionParamsType",
- }),
- }).annotate({
- title: "ProfilePermissionProfileSelectionParams",
- description:
- "Select a named built-in or user-defined profile and optionally apply bounded modifications that Codex knows how to validate.",
- }),
- ],
- { mode: "oneOf" },
-);
+export type V2ThreadForkParams__AbsolutePathBuf = string;
+export const V2ThreadForkParams__AbsolutePathBuf = Schema.String.annotate({
+ description:
+ "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.",
+});
export type V2ThreadForkResponse = {
readonly approvalPolicy: V2ThreadForkResponse__AskForApproval;
@@ -33621,7 +35354,7 @@ export const V2ThreadForkResponse = Schema.Struct({
{ mode: "oneOf" },
).annotate({
description:
- "Legacy sandbox policy retained for compatibility. Experimental clients should prefer `permissionProfile` when they need exact runtime permissions.",
+ "Legacy sandbox policy retained for compatibility. Experimental clients should prefer `activePermissionProfile` for profile provenance.",
}),
serviceTier: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
thread: V2ThreadForkResponse__Thread,
@@ -33630,14 +35363,13 @@ export const V2ThreadForkResponse = Schema.Struct({
export type V2ThreadForkResponse__ActivePermissionProfile = {
readonly extends?: string | null;
readonly id: string;
- readonly modifications?: ReadonlyArray<V2ThreadForkResponse__ActivePermissionProfileModification>;
};
export const V2ThreadForkResponse__ActivePermissionProfile = Schema.Struct({
extends: Schema.optionalKey(
Schema.Union([
Schema.String.annotate({
description:
- "Parent profile identifier once permissions profiles support inheritance. This is currently always `null`.",
+ "Parent profile identifier from the selected permissions profile's `extends` setting, when present.",
}),
Schema.Null,
]),
@@ -33646,13 +35378,6 @@ export const V2ThreadForkResponse__ActivePermissionProfile = Schema.Struct({
description:
"Identifier from `default_permissions` or the implicit built-in default, such as `:workspace` or a user-defined `[permissions.<id>]` profile.",
}),
- modifications: Schema.optionalKey(
- Schema.Array(V2ThreadForkResponse__ActivePermissionProfileModification).annotate({
- description:
- "Bounded user-requested modifications applied on top of the named profile, if any.",
- default: [],
- }),
- ),
});
export type V2ThreadForkResponse__ApprovalsReviewer = "user" | "auto_review" | "guardian_subagent";
@@ -33711,44 +35436,6 @@ export const V2ThreadForkResponse__CommandExecutionSource = Schema.Literals([
export type V2ThreadForkResponse__NetworkAccess = "restricted" | "enabled";
export const V2ThreadForkResponse__NetworkAccess = Schema.Literals(["restricted", "enabled"]);
-export type V2ThreadForkResponse__PermissionProfile =
- | {
- readonly fileSystem: V2ThreadForkResponse__PermissionProfileFileSystemPermissions;
- readonly network: V2ThreadForkResponse__PermissionProfileNetworkPermissions;
- readonly type: "managed";
- }
- | { readonly type: "disabled" }
- | {
- readonly network: V2ThreadForkResponse__PermissionProfileNetworkPermissions;
- readonly type: "external";
- };
-export const V2ThreadForkResponse__PermissionProfile = Schema.Union(
- [
- Schema.Struct({
- fileSystem: V2ThreadForkResponse__PermissionProfileFileSystemPermissions,
- network: V2ThreadForkResponse__PermissionProfileNetworkPermissions,
- type: Schema.Literal("managed").annotate({ title: "ManagedPermissionProfileType" }),
- }).annotate({
- title: "ManagedPermissionProfile",
- description: "Codex owns sandbox construction for this profile.",
- }),
- Schema.Struct({
- type: Schema.Literal("disabled").annotate({ title: "DisabledPermissionProfileType" }),
- }).annotate({
- title: "DisabledPermissionProfile",
- description: "Do not apply an outer sandbox.",
- }),
- Schema.Struct({
- network: V2ThreadForkResponse__PermissionProfileNetworkPermissions,
- type: Schema.Literal("external").annotate({ title: "ExternalPermissionProfileType" }),
- }).annotate({
- title: "ExternalPermissionProfile",
- description: "Filesystem isolation is enforced by an external caller.",
- }),
- ],
- { mode: "oneOf" },
-);
-
export type V2ThreadForkResponse__SandboxPolicy =
| { readonly type: "dangerFullAccess" }
| { readonly networkAccess?: boolean; readonly type: "readOnly" }
@@ -33850,6 +35537,48 @@ export const V2ThreadGoalClearedNotification = Schema.Struct({ threadId: Schema.
title: "ThreadGoalClearedNotification",
});
+export type V2ThreadGoalClearParams = { readonly threadId: string };
+export const V2ThreadGoalClearParams = Schema.Struct({ threadId: Schema.String }).annotate({
+ title: "ThreadGoalClearParams",
+});
+
+export type V2ThreadGoalClearResponse = { readonly cleared: boolean };
+export const V2ThreadGoalClearResponse = Schema.Struct({ cleared: Schema.Boolean }).annotate({
+ title: "ThreadGoalClearResponse",
+});
+
+export type V2ThreadGoalGetParams = { readonly threadId: string };
+export const V2ThreadGoalGetParams = Schema.Struct({ threadId: Schema.String }).annotate({
+ title: "ThreadGoalGetParams",
+});
+
+export type V2ThreadGoalGetResponse = {
+ readonly goal?: V2ThreadGoalGetResponse__ThreadGoal | null;
+};
+export const V2ThreadGoalGetResponse = Schema.Struct({
+ goal: Schema.optionalKey(Schema.Union([V2ThreadGoalGetResponse__ThreadGoal, Schema.Null])),
+}).annotate({ title: "ThreadGoalGetResponse" });
+
+export type V2ThreadGoalSetParams = {
+ readonly objective?: string | null;
+ readonly status?: V2ThreadGoalSetParams__ThreadGoalStatus | null;
+ readonly threadId: string;
+ readonly tokenBudget?: number | null;
+};
+export const V2ThreadGoalSetParams = Schema.Struct({
+ objective: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ status: Schema.optionalKey(Schema.Union([V2ThreadGoalSetParams__ThreadGoalStatus, Schema.Null])),
+ threadId: Schema.String,
+ tokenBudget: Schema.optionalKey(
+ Schema.Union([Schema.Number.annotate({ format: "int64" }).check(Schema.isInt()), Schema.Null]),
+ ),
+}).annotate({ title: "ThreadGoalSetParams" });
+
+export type V2ThreadGoalSetResponse = { readonly goal: V2ThreadGoalSetResponse__ThreadGoal };
+export const V2ThreadGoalSetResponse = Schema.Struct({
+ goal: V2ThreadGoalSetResponse__ThreadGoal,
+}).annotate({ title: "ThreadGoalSetResponse" });
+
export type V2ThreadGoalUpdatedNotification = {
readonly goal: V2ThreadGoalUpdatedNotification__ThreadGoal;
readonly threadId: string;
@@ -34276,7 +36005,6 @@ export const V2ThreadReadParams = Schema.Struct({
includeTurns: Schema.optionalKey(
Schema.Boolean.annotate({
description: "When true, include turns and their items from rollout history.",
- default: false,
}),
),
threadId: Schema.String,
@@ -34530,35 +36258,14 @@ export const V2ThreadResumeParams = Schema.Struct({
}).annotate({
title: "ThreadResumeParams",
description:
- "There are three ways to resume a thread: 1. By thread_id: load the thread from disk by thread_id and resume it. 2. By history: instantiate the thread from memory and resume it. 3. By path: load the thread from disk by path and resume it.\n\nThe precedence is: history > path > thread_id. If using history or path, the thread_id param will be ignored.\n\nPrefer using thread_id whenever possible.",
+ "There are three ways to resume a thread: 1. By thread_id: load the thread from disk by thread_id and resume it. 2. By history: instantiate the thread from memory and resume it. 3. By path: load the thread from disk by path and resume it.\n\nFor non-running threads, the precedence is: history > non-empty path > thread_id. If using history or a non-empty path for a non-running thread, the thread_id param will be ignored.\n\nIf thread_id identifies a running thread, app-server rejoins that thread and treats a non-empty path as a consistency check against the active rollout path. Empty string path values are treated as absent.\n\nPrefer using thread_id whenever possible.",
});
-export type V2ThreadResumeParams__PermissionProfileSelectionParams = {
- readonly id: string;
- readonly modifications?: ReadonlyArray<V2ThreadResumeParams__PermissionProfileModificationParams> | null;
- readonly type: "profile";
-};
-export const V2ThreadResumeParams__PermissionProfileSelectionParams = Schema.Union(
- [
- Schema.Struct({
- id: Schema.String,
- modifications: Schema.optionalKey(
- Schema.Union([
- Schema.Array(V2ThreadResumeParams__PermissionProfileModificationParams),
- Schema.Null,
- ]),
- ),
- type: Schema.Literal("profile").annotate({
- title: "ProfilePermissionProfileSelectionParamsType",
- }),
- }).annotate({
- title: "ProfilePermissionProfileSelectionParams",
- description:
- "Select a named built-in or user-defined profile and optionally apply bounded modifications that Codex knows how to validate.",
- }),
- ],
- { mode: "oneOf" },
-);
+export type V2ThreadResumeParams__AbsolutePathBuf = string;
+export const V2ThreadResumeParams__AbsolutePathBuf = Schema.String.annotate({
+ description:
+ "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.",
+});
export type V2ThreadResumeParams__ResponseItem =
| {
@@ -34568,6 +36275,12 @@ export type V2ThreadResumeParams__ResponseItem =
readonly role: string;
readonly type: "message";
}
+ | {
+ readonly author: string;
+ readonly content: ReadonlyArray<V2ThreadResumeParams__AgentMessageInputContent>;
+ readonly recipient: string;
+ readonly type: "agent_message";
+ }
| {
readonly content?: ReadonlyArray<V2ThreadResumeParams__ReasoningItemContent> | null;
readonly encrypted_content?: string | null;
@@ -34637,6 +36350,7 @@ export type V2ThreadResumeParams__ResponseItem =
readonly type: "image_generation_call";
}
| { readonly encrypted_content: string; readonly type: "compaction" }
+ | { readonly type: "compaction_trigger" }
| { readonly encrypted_content?: string | null; readonly type: "context_compaction" }
| { readonly type: "other" };
export const V2ThreadResumeParams__ResponseItem = Schema.Union(
@@ -34650,6 +36364,12 @@ export const V2ThreadResumeParams__ResponseItem = Schema.Union(
role: Schema.String,
type: Schema.Literal("message").annotate({ title: "MessageResponseItemType" }),
}).annotate({ title: "MessageResponseItem" }),
+ Schema.Struct({
+ author: Schema.String,
+ content: Schema.Array(V2ThreadResumeParams__AgentMessageInputContent),
+ recipient: Schema.String,
+ type: Schema.Literal("agent_message").annotate({ title: "AgentMessageResponseItemType" }),
+ }).annotate({ title: "AgentMessageResponseItem" }),
Schema.Struct({
content: Schema.optionalKey(
Schema.Union([Schema.Array(V2ThreadResumeParams__ReasoningItemContent), Schema.Null]),
@@ -34761,6 +36481,11 @@ export const V2ThreadResumeParams__ResponseItem = Schema.Union(
encrypted_content: Schema.String,
type: Schema.Literal("compaction").annotate({ title: "CompactionResponseItemType" }),
}).annotate({ title: "CompactionResponseItem" }),
+ Schema.Struct({
+ type: Schema.Literal("compaction_trigger").annotate({
+ title: "CompactionTriggerResponseItemType",
+ }),
+ }).annotate({ title: "CompactionTriggerResponseItem" }),
Schema.Struct({
encrypted_content: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
type: Schema.Literal("context_compaction").annotate({
@@ -34774,6 +36499,32 @@ export const V2ThreadResumeParams__ResponseItem = Schema.Union(
{ mode: "oneOf" },
);
+export type V2ThreadResumeParams__ThreadResumeInitialTurnsPageParams = {
+ readonly itemsView?: V2ThreadResumeParams__TurnItemsView | null;
+ readonly limit?: number | null;
+ readonly sortDirection?: V2ThreadResumeParams__SortDirection | null;
+};
+export const V2ThreadResumeParams__ThreadResumeInitialTurnsPageParams = Schema.Struct({
+ itemsView: Schema.optionalKey(
+ Schema.Union([V2ThreadResumeParams__TurnItemsView, Schema.Null]).annotate({
+ description: "How much item detail to include for each returned turn; defaults to summary.",
+ }),
+ ),
+ limit: Schema.optionalKey(
+ Schema.Union([
+ Schema.Number.annotate({ description: "Optional turn page size.", format: "uint32" })
+ .check(Schema.isInt())
+ .check(Schema.isGreaterThanOrEqualTo(0)),
+ Schema.Null,
+ ]),
+ ),
+ sortDirection: Schema.optionalKey(
+ Schema.Union([V2ThreadResumeParams__SortDirection, Schema.Null]).annotate({
+ description: "Optional turn pagination direction; defaults to descending.",
+ }),
+ ),
+});
+
export type V2ThreadResumeResponse = {
readonly approvalPolicy: V2ThreadResumeResponse__AskForApproval;
readonly approvalsReviewer: "user" | "auto_review" | "guardian_subagent";
@@ -34848,7 +36599,7 @@ export const V2ThreadResumeResponse = Schema.Struct({
{ mode: "oneOf" },
).annotate({
description:
- "Legacy sandbox policy retained for compatibility. Experimental clients should prefer `permissionProfile` when they need exact runtime permissions.",
+ "Legacy sandbox policy retained for compatibility. Experimental clients should prefer `activePermissionProfile` for profile provenance.",
}),
serviceTier: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
thread: V2ThreadResumeResponse__Thread,
@@ -34857,14 +36608,13 @@ export const V2ThreadResumeResponse = Schema.Struct({
export type V2ThreadResumeResponse__ActivePermissionProfile = {
readonly extends?: string | null;
readonly id: string;
- readonly modifications?: ReadonlyArray<V2ThreadResumeResponse__ActivePermissionProfileModification>;
};
export const V2ThreadResumeResponse__ActivePermissionProfile = Schema.Struct({
extends: Schema.optionalKey(
Schema.Union([
Schema.String.annotate({
description:
- "Parent profile identifier once permissions profiles support inheritance. This is currently always `null`.",
+ "Parent profile identifier from the selected permissions profile's `extends` setting, when present.",
}),
Schema.Null,
]),
@@ -34873,13 +36623,6 @@ export const V2ThreadResumeResponse__ActivePermissionProfile = Schema.Struct({
description:
"Identifier from `default_permissions` or the implicit built-in default, such as `:workspace` or a user-defined `[permissions.<id>]` profile.",
}),
- modifications: Schema.optionalKey(
- Schema.Array(V2ThreadResumeResponse__ActivePermissionProfileModification).annotate({
- description:
- "Bounded user-requested modifications applied on top of the named profile, if any.",
- default: [],
- }),
- ),
});
export type V2ThreadResumeResponse__ApprovalsReviewer =
@@ -34944,44 +36687,6 @@ export const V2ThreadResumeResponse__CommandExecutionSource = Schema.Literals([
export type V2ThreadResumeResponse__NetworkAccess = "restricted" | "enabled";
export const V2ThreadResumeResponse__NetworkAccess = Schema.Literals(["restricted", "enabled"]);
-export type V2ThreadResumeResponse__PermissionProfile =
- | {
- readonly fileSystem: V2ThreadResumeResponse__PermissionProfileFileSystemPermissions;
- readonly network: V2ThreadResumeResponse__PermissionProfileNetworkPermissions;
- readonly type: "managed";
- }
- | { readonly type: "disabled" }
- | {
- readonly network: V2ThreadResumeResponse__PermissionProfileNetworkPermissions;
- readonly type: "external";
- };
-export const V2ThreadResumeResponse__PermissionProfile = Schema.Union(
- [
- Schema.Struct({
- fileSystem: V2ThreadResumeResponse__PermissionProfileFileSystemPermissions,
- network: V2ThreadResumeResponse__PermissionProfileNetworkPermissions,
- type: Schema.Literal("managed").annotate({ title: "ManagedPermissionProfileType" }),
- }).annotate({
- title: "ManagedPermissionProfile",
- description: "Codex owns sandbox construction for this profile.",
- }),
- Schema.Struct({
- type: Schema.Literal("disabled").annotate({ title: "DisabledPermissionProfileType" }),
- }).annotate({
- title: "DisabledPermissionProfile",
- description: "Do not apply an outer sandbox.",
- }),
- Schema.Struct({
- network: V2ThreadResumeResponse__PermissionProfileNetworkPermissions,
- type: Schema.Literal("external").annotate({ title: "ExternalPermissionProfileType" }),
- }).annotate({
- title: "ExternalPermissionProfile",
- description: "Filesystem isolation is enforced by an external caller.",
- }),
- ],
- { mode: "oneOf" },
-);
-
export type V2ThreadResumeResponse__SandboxPolicy =
| { readonly type: "dangerFullAccess" }
| { readonly networkAccess?: boolean; readonly type: "readOnly" }
@@ -35078,6 +36783,17 @@ export const V2ThreadResumeResponse__TurnItemsView = Schema.Literals([
"full",
]);
+export type V2ThreadResumeResponse__TurnsPage = {
+ readonly backwardsCursor?: string | null;
+ readonly data: ReadonlyArray<V2ThreadResumeResponse__Turn>;
+ readonly nextCursor?: string | null;
+};
+export const V2ThreadResumeResponse__TurnsPage = Schema.Struct({
+ backwardsCursor: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+ data: Schema.Array(V2ThreadResumeResponse__Turn),
+ nextCursor: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+});
+
export type V2ThreadRollbackParams = { readonly numTurns: number; readonly threadId: string };
export const V2ThreadRollbackParams = Schema.Struct({
numTurns: Schema.Number.annotate({
@@ -35103,6 +36819,7 @@ export type V2ThreadRollbackResponse = {
readonly id: string;
readonly modelProvider: string;
readonly name?: string | null;
+ readonly parentThreadId?: string | null;
readonly path?: string | null;
readonly preview: string;
readonly sessionId: string;
@@ -35183,6 +36900,15 @@ export const V2ThreadRollbackResponse = Schema.Struct({
Schema.Null,
]),
),
+ parentThreadId: Schema.optionalKey(
+ Schema.Union([
+ Schema.String.annotate({
+ description:
+ "The ID of the parent thread. This will only be set if this thread is a subagent.",
+ }),
+ Schema.Null,
+ ]),
+ ),
path: Schema.optionalKey(
Schema.Union([
Schema.String.annotate({ description: "[UNSTABLE] Path to the thread on disk." }),
@@ -35321,6 +37047,7 @@ export type V2ThreadRollbackResponse__Thread = {
readonly id: string;
readonly modelProvider: string;
readonly name?: string | null;
+ readonly parentThreadId?: string | null;
readonly path?: string | null;
readonly preview: string;
readonly sessionId: string;
@@ -35399,6 +37126,15 @@ export const V2ThreadRollbackResponse__Thread = Schema.Struct({
Schema.Null,
]),
),
+ parentThreadId: Schema.optionalKey(
+ Schema.Union([
+ Schema.String.annotate({
+ description:
+ "The ID of the parent thread. This will only be set if this thread is a subagent.",
+ }),
+ Schema.Null,
+ ]),
+ ),
path: Schema.optionalKey(
Schema.Union([
Schema.String.annotate({ description: "[UNSTABLE] Path to the thread on disk." }),
@@ -35501,6 +37237,21 @@ export const V2ThreadSetNameResponse = Schema.Struct({}).annotate({
title: "ThreadSetNameResponse",
});
+export type V2ThreadSettingsUpdatedNotification = {
+ readonly threadId: string;
+ readonly threadSettings: V2ThreadSettingsUpdatedNotification__ThreadSettings;
+};
+export const V2ThreadSettingsUpdatedNotification = Schema.Struct({
+ threadId: Schema.String,
+ threadSettings: V2ThreadSettingsUpdatedNotification__ThreadSettings,
+}).annotate({ title: "ThreadSettingsUpdatedNotification" });
+
+export type V2ThreadSettingsUpdatedNotification__NetworkAccess = "restricted" | "enabled";
+export const V2ThreadSettingsUpdatedNotification__NetworkAccess = Schema.Literals([
+ "restricted",
+ "enabled",
+]);
+
export type V2ThreadShellCommandParams = { readonly command: string; readonly threadId: string };
export const V2ThreadShellCommandParams = Schema.Struct({
command: Schema.String.annotate({
@@ -35672,6 +37423,27 @@ export const V2ThreadStartParams = Schema.Struct({
),
}).annotate({ title: "ThreadStartParams" });
+export type V2ThreadStartParams__CapabilityRootLocation = {
+ readonly environmentId: string;
+ readonly path: string;
+ readonly type: "environment";
+};
+export const V2ThreadStartParams__CapabilityRootLocation = Schema.Union(
+ [
+ Schema.Struct({
+ environmentId: Schema.String,
+ path: Schema.String,
+ type: Schema.Literal("environment").annotate({
+ title: "EnvironmentCapabilityRootLocationType",
+ }),
+ }).annotate({
+ title: "EnvironmentCapabilityRootLocation",
+ description: "A path owned by an execution environment.",
+ }),
+ ],
+ { mode: "oneOf" },
+).annotate({ description: "Location used to resolve a selected capability root." });
+
export type V2ThreadStartParams__DynamicToolSpec = {
readonly deferLoading?: boolean;
readonly description: string;
@@ -35687,32 +37459,36 @@ export const V2ThreadStartParams__DynamicToolSpec = Schema.Struct({
namespace: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
});
-export type V2ThreadStartParams__PermissionProfileSelectionParams = {
+export type V2ThreadStartParams__SelectedCapabilityRoot = {
readonly id: string;
- readonly modifications?: ReadonlyArray<V2ThreadStartParams__PermissionProfileModificationParams> | null;
- readonly type: "profile";
+ readonly location: {
+ readonly environmentId: string;
+ readonly path: string;
+ readonly type: "environment";
+ };
};
-export const V2ThreadStartParams__PermissionProfileSelectionParams = Schema.Union(
- [
- Schema.Struct({
- id: Schema.String,
- modifications: Schema.optionalKey(
- Schema.Union([
- Schema.Array(V2ThreadStartParams__PermissionProfileModificationParams),
- Schema.Null,
- ]),
- ),
- type: Schema.Literal("profile").annotate({
- title: "ProfilePermissionProfileSelectionParamsType",
+export const V2ThreadStartParams__SelectedCapabilityRoot = Schema.Struct({
+ id: Schema.String.annotate({
+ description: "Stable identifier supplied by the capability selection platform.",
+ }),
+ location: Schema.Union(
+ [
+ Schema.Struct({
+ environmentId: Schema.String,
+ path: Schema.String,
+ type: Schema.Literal("environment").annotate({
+ title: "EnvironmentCapabilityRootLocationType",
+ }),
+ }).annotate({
+ title: "EnvironmentCapabilityRootLocation",
+ description: "A path owned by an execution environment.",
}),
- }).annotate({
- title: "ProfilePermissionProfileSelectionParams",
- description:
- "Select a named built-in or user-defined profile and optionally apply bounded modifications that Codex knows how to validate.",
- }),
- ],
- { mode: "oneOf" },
-);
+ ],
+ { mode: "oneOf" },
+ ).annotate({ description: "Location used to resolve a selected capability root." }),
+}).annotate({
+ description: "A user-selected root that can expose one or more runtime capabilities.",
+});
export type V2ThreadStartParams__TurnEnvironmentParams = {
readonly cwd: V2ThreadStartParams__AbsolutePathBuf;
@@ -35797,7 +37573,7 @@ export const V2ThreadStartResponse = Schema.Struct({
{ mode: "oneOf" },
).annotate({
description:
- "Legacy sandbox policy retained for compatibility. Experimental clients should prefer `permissionProfile` when they need exact runtime permissions.",
+ "Legacy sandbox policy retained for compatibility. Experimental clients should prefer `activePermissionProfile` for profile provenance.",
}),
serviceTier: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
thread: V2ThreadStartResponse__Thread,
@@ -35806,14 +37582,13 @@ export const V2ThreadStartResponse = Schema.Struct({
export type V2ThreadStartResponse__ActivePermissionProfile = {
readonly extends?: string | null;
readonly id: string;
- readonly modifications?: ReadonlyArray<V2ThreadStartResponse__ActivePermissionProfileModification>;
};
export const V2ThreadStartResponse__ActivePermissionProfile = Schema.Struct({
extends: Schema.optionalKey(
Schema.Union([
Schema.String.annotate({
description:
- "Parent profile identifier once permissions profiles support inheritance. This is currently always `null`.",
+ "Parent profile identifier from the selected permissions profile's `extends` setting, when present.",
}),
Schema.Null,
]),
@@ -35822,13 +37597,6 @@ export const V2ThreadStartResponse__ActivePermissionProfile = Schema.Struct({
description:
"Identifier from `default_permissions` or the implicit built-in default, such as `:workspace` or a user-defined `[permissions.<id>]` profile.",
}),
- modifications: Schema.optionalKey(
- Schema.Array(V2ThreadStartResponse__ActivePermissionProfileModification).annotate({
- description:
- "Bounded user-requested modifications applied on top of the named profile, if any.",
- default: [],
- }),
- ),
});
export type V2ThreadStartResponse__ApprovalsReviewer = "user" | "auto_review" | "guardian_subagent";
@@ -35890,44 +37658,6 @@ export const V2ThreadStartResponse__CommandExecutionSource = Schema.Literals([
export type V2ThreadStartResponse__NetworkAccess = "restricted" | "enabled";
export const V2ThreadStartResponse__NetworkAccess = Schema.Literals(["restricted", "enabled"]);
-export type V2ThreadStartResponse__PermissionProfile =
- | {
- readonly fileSystem: V2ThreadStartResponse__PermissionProfileFileSystemPermissions;
- readonly network: V2ThreadStartResponse__PermissionProfileNetworkPermissions;
- readonly type: "managed";
- }
- | { readonly type: "disabled" }
- | {
- readonly network: V2ThreadStartResponse__PermissionProfileNetworkPermissions;
- readonly type: "external";
- };
-export const V2ThreadStartResponse__PermissionProfile = Schema.Union(
- [
- Schema.Struct({
- fileSystem: V2ThreadStartResponse__PermissionProfileFileSystemPermissions,
- network: V2ThreadStartResponse__PermissionProfileNetworkPermissions,
- type: Schema.Literal("managed").annotate({ title: "ManagedPermissionProfileType" }),
- }).annotate({
- title: "ManagedPermissionProfile",
- description: "Codex owns sandbox construction for this profile.",
- }),
- Schema.Struct({
- type: Schema.Literal("disabled").annotate({ title: "DisabledPermissionProfileType" }),
- }).annotate({
- title: "DisabledPermissionProfile",
- description: "Do not apply an outer sandbox.",
- }),
- Schema.Struct({
- network: V2ThreadStartResponse__PermissionProfileNetworkPermissions,
- type: Schema.Literal("external").annotate({ title: "ExternalPermissionProfileType" }),
- }).annotate({
- title: "ExternalPermissionProfile",
- description: "Filesystem isolation is enforced by an external caller.",
- }),
- ],
- { mode: "oneOf" },
-);
-
export type V2ThreadStartResponse__SandboxPolicy =
| { readonly type: "dangerFullAccess" }
| { readonly networkAccess?: boolean; readonly type: "readOnly" }
@@ -36261,6 +37991,17 @@ export const V2TurnInterruptResponse = Schema.Struct({}).annotate({
title: "TurnInterruptResponse",
});
+export type V2TurnModerationMetadataNotification = {
+ readonly metadata: unknown;
+ readonly threadId: string;
+ readonly turnId: string;
+};
+export const V2TurnModerationMetadataNotification = Schema.Struct({
+ metadata: Schema.Unknown,
+ threadId: Schema.String,
+ turnId: Schema.String,
+}).annotate({ title: "TurnModerationMetadataNotification" });
+
export type V2TurnPlanUpdatedNotification = {
readonly explanation?: string | null;
readonly plan: ReadonlyArray<V2TurnPlanUpdatedNotification__TurnPlanStep>;
@@ -36339,6 +38080,7 @@ export const V2TurnStartedNotification__TurnItemsView = Schema.Literals([
export type V2TurnStartParams = {
readonly approvalPolicy?: V2TurnStartParams__AskForApproval | null;
readonly approvalsReviewer?: V2TurnStartParams__ApprovalsReviewer | null;
+ readonly clientUserMessageId?: string | null;
readonly cwd?: string | null;
readonly effort?: V2TurnStartParams__ReasoningEffort | null;
readonly input: ReadonlyArray<V2TurnStartParams__UserInput>;
@@ -36362,6 +38104,7 @@ export const V2TurnStartParams = Schema.Struct({
"Override where approval requests are routed for review on this turn and subsequent turns.",
}),
),
+ clientUserMessageId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
cwd: Schema.optionalKey(
Schema.Union([
Schema.String.annotate({
@@ -36416,6 +38159,15 @@ export const V2TurnStartParams = Schema.Struct({
threadId: Schema.String,
}).annotate({ title: "TurnStartParams" });
+export type V2TurnStartParams__AdditionalContextEntry = {
+ readonly kind: V2TurnStartParams__AdditionalContextKind;
+ readonly value: string;
+};
+export const V2TurnStartParams__AdditionalContextEntry = Schema.Struct({
+ kind: V2TurnStartParams__AdditionalContextKind,
+ value: Schema.String,
+});
+
export type V2TurnStartParams__ByteRange = { readonly end: number; readonly start: number };
export const V2TurnStartParams__ByteRange = Schema.Struct({
end: Schema.Number.annotate({ format: "uint" })
@@ -36438,33 +38190,6 @@ export const V2TurnStartParams__CollaborationMode = Schema.Struct({
export type V2TurnStartParams__NetworkAccess = "restricted" | "enabled";
export const V2TurnStartParams__NetworkAccess = Schema.Literals(["restricted", "enabled"]);
-export type V2TurnStartParams__PermissionProfileSelectionParams = {
- readonly id: string;
- readonly modifications?: ReadonlyArray<V2TurnStartParams__PermissionProfileModificationParams> | null;
- readonly type: "profile";
-};
-export const V2TurnStartParams__PermissionProfileSelectionParams = Schema.Union(
- [
- Schema.Struct({
- id: Schema.String,
- modifications: Schema.optionalKey(
- Schema.Union([
- Schema.Array(V2TurnStartParams__PermissionProfileModificationParams),
- Schema.Null,
- ]),
- ),
- type: Schema.Literal("profile").annotate({
- title: "ProfilePermissionProfileSelectionParamsType",
- }),
- }).annotate({
- title: "ProfilePermissionProfileSelectionParams",
- description:
- "Select a named built-in or user-defined profile and optionally apply bounded modifications that Codex knows how to validate.",
- }),
- ],
- { mode: "oneOf" },
-);
-
export type V2TurnStartParams__TurnEnvironmentParams = {
readonly cwd: V2TurnStartParams__AbsolutePathBuf;
readonly environmentId: string;
@@ -36526,11 +38251,13 @@ export type V2TurnStartResponse__TurnItemsView = "notLoaded" | "summary" | "full
export const V2TurnStartResponse__TurnItemsView = Schema.Literals(["notLoaded", "summary", "full"]);
export type V2TurnSteerParams = {
+ readonly clientUserMessageId?: string | null;
readonly expectedTurnId: string;
readonly input: ReadonlyArray<V2TurnSteerParams__UserInput>;
readonly threadId: string;
};
export const V2TurnSteerParams = Schema.Struct({
+ clientUserMessageId: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
expectedTurnId: Schema.String.annotate({
description:
"Required active turn id precondition. The request fails when it does not match the currently active turn.",
@@ -36539,6 +38266,15 @@ export const V2TurnSteerParams = Schema.Struct({
threadId: Schema.String,
}).annotate({ title: "TurnSteerParams" });
+export type V2TurnSteerParams__AdditionalContextEntry = {
+ readonly kind: V2TurnSteerParams__AdditionalContextKind;
+ readonly value: string;
+};
+export const V2TurnSteerParams__AdditionalContextEntry = Schema.Struct({
+ kind: V2TurnSteerParams__AdditionalContextKind,
+ value: Schema.String,
+});
+
export type V2TurnSteerParams__ByteRange = { readonly end: number; readonly start: number };
export const V2TurnSteerParams__ByteRange = Schema.Struct({
end: Schema.Number.annotate({ format: "uint" })
diff --git a/packages/effect-codex-app-server/src/client.test.ts b/packages/effect-codex-app-server/src/client.test.ts
index 77b5a1635..8d301742a 100644
--- a/packages/effect-codex-app-server/src/client.test.ts
+++ b/packages/effect-codex-app-server/src/client.test.ts
@@ -152,4 +152,41 @@ it.layer(NodeServices.layer)("effect-codex-app-server client", (it) => {
assert.equal(initialized.userAgent, "mock-codex-app-server");
}),
);
+
+ it.effect("drains command stderr so large diagnostics cannot block protocol responses", () =>
+ Effect.gen(function* () {
+ const path = yield* Path.Path;
+ const scope = yield* Scope.make();
+ const clientLayer = CodexClient.layerCommand({
+ command: "node",
+ args: mockPeerArgs(yield* mockPeerPath),
+ cwd: path.join(import.meta.dirname, ".."),
+ env: {
+ CODEX_APP_SERVER_TEST_STDERR_BYTES: String(512 * 1024),
+ },
+ });
+ const context = yield* Layer.buildWithScope(clientLayer, scope);
+
+ const initialized = yield* Effect.gen(function* () {
+ const client = yield* CodexClient.CodexAppServerClient;
+ return yield* client.request("initialize", {
+ clientInfo: {
+ name: "effect-codex-app-server-test",
+ title: "Effect Codex App Server Test",
+ version: "0.0.0",
+ },
+ capabilities: {
+ experimentalApi: true,
+ optOutNotificationMethods: null,
+ },
+ });
+ }).pipe(
+ Effect.timeout("5 seconds"),
+ Effect.provide(context),
+ Effect.ensuring(Scope.close(scope, Exit.void)),
+ );
+
+ assert.equal(initialized.userAgent, "mock-codex-app-server");
+ }),
+ );
});
diff --git a/packages/effect-codex-app-server/src/client.ts b/packages/effect-codex-app-server/src/client.ts
index 7d409fce7..edc7d8b6c 100644
--- a/packages/effect-codex-app-server/src/client.ts
+++ b/packages/effect-codex-app-server/src/client.ts
@@ -4,6 +4,7 @@ import * as Layer from "effect/Layer";
import * as Schema from "effect/Schema";
import * as Scope from "effect/Scope";
import * as Stdio from "effect/Stdio";
+import * as Stream from "effect/Stream";
import { ChildProcess, ChildProcessSpawner } from "effect/unstable/process";
import * as CodexRpc from "./_generated/meta.gen.ts";
@@ -253,11 +254,15 @@ export const make = Effect.fn("effect-codex-app-server/CodexAppServerClient.make
export const layerChildProcess = (
handle: ChildProcessSpawner.ChildProcessHandle,
options: CodexAppServerClientOptions = {},
-): Layer.Layer<CodexAppServerClient> => {
- const stdio = makeChildStdio(handle);
- const terminationError = makeTerminationError(handle);
- return Layer.effect(CodexAppServerClient, make(stdio, options, terminationError));
-};
+): Layer.Layer<CodexAppServerClient> =>
+ Layer.effect(CodexAppServerClient, makeChildProcessClient(handle, options));
+
+const makeChildProcessClient = Effect.fn(
+ "effect-codex-app-server/CodexAppServerClient.makeChildProcessClient",
+)(function* (handle: ChildProcessSpawner.ChildProcessHandle, options: CodexAppServerClientOptions) {
+ yield* Stream.runDrain(handle.stderr).pipe(Effect.ignore, Effect.forkScoped);
+ return yield* make(makeChildStdio(handle), options, makeTerminationError(handle));
+});
export interface CodexAppServerCommandLayerOptions extends CodexAppServerClientOptions {
readonly command: string;
@@ -292,9 +297,5 @@ export const layerCommand = (
}),
),
);
- }).pipe(
- Effect.flatMap((handle) =>
- make(makeChildStdio(handle), options, makeTerminationError(handle)),
- ),
- ),
+ }).pipe(Effect.flatMap((handle) => makeChildProcessClient(handle, options))),
);
diff --git a/packages/effect-codex-app-server/src/protocol.test.ts b/packages/effect-codex-app-server/src/protocol.test.ts
index 2a1d964a9..79f785714 100644
--- a/packages/effect-codex-app-server/src/protocol.test.ts
+++ b/packages/effect-codex-app-server/src/protocol.test.ts
@@ -10,6 +10,8 @@ import { assert, it } from "@effect/vitest";
import * as CodexError from "./errors.ts";
import * as CodexProtocol from "./protocol.ts";
+import * as CodexRpc from "./rpc.ts";
+import * as CodexSchema from "./schema.ts";
import { makeInMemoryStdio } from "./_internal/stdio.ts";
const encodeUnknownJsonString = Schema.encodeUnknownSync(Schema.UnknownFromJsonString);
@@ -18,8 +20,28 @@ const encoder = new TextEncoder();
const encodeJsonl = (value: unknown) => encoder.encode(`${encodeUnknownJsonString(value)}\n`);
const decodeJson = Schema.decodeEffect(Schema.UnknownFromJsonString);
+const decodeAccountTokenUsageResponse = Schema.decodeUnknownEffect(
+ CodexRpc.CLIENT_REQUEST_RESPONSES["account/usage/read"],
+);
it.layer(NodeServices.layer)("effect-codex-app-server protocol", (it) => {
+ it.effect("maps account usage responses to the upstream token usage schema", () =>
+ Effect.gen(function* () {
+ assert.strictEqual(
+ CodexRpc.CLIENT_REQUEST_RESPONSES["account/usage/read"],
+ CodexSchema.V2GetAccountTokenUsageResponse,
+ );
+ const decoded = yield* decodeAccountTokenUsageResponse({
+ dailyUsageBuckets: [{ startDate: "2026-06-10", tokens: 42 }],
+ summary: { lifetimeTokens: 42 },
+ });
+ assert.deepEqual(decoded, {
+ dailyUsageBuckets: [{ startDate: "2026-06-10", tokens: 42 }],
+ summary: { lifetimeTokens: 42 },
+ });
+ }),
+ );
+
it.effect(
"encodes requests without a jsonrpc field and routes inbound requests and notifications",
() =>
diff --git a/packages/effect-codex-app-server/test/fixtures/codex-app-server-mock-peer.ts b/packages/effect-codex-app-server/test/fixtures/codex-app-server-mock-peer.ts
index 51668b5e2..f04f43dd7 100644
--- a/packages/effect-codex-app-server/test/fixtures/codex-app-server-mock-peer.ts
+++ b/packages/effect-codex-app-server/test/fixtures/codex-app-server-mock-peer.ts
@@ -34,6 +34,18 @@ const handleMethod = (message: Record<string, unknown>) => {
switch (method) {
case "initialize": {
+ const stderrBytes = Number(process.env.CODEX_APP_SERVER_TEST_STDERR_BYTES ?? 0);
+ if (Number.isFinite(stderrBytes) && stderrBytes > 0) {
+ process.stderr.write("x".repeat(stderrBytes), () => {
+ respond(message.id as number | string, {
+ userAgent: "mock-codex-app-server",
+ codexHome: process.cwd(),
+ platformFamily: process.platform === "win32" ? "windows" : "unix",
+ platformOs: process.platform === "darwin" ? "macos" : process.platform,
+ });
+ });
+ return;
+ }
respond(message.id as number | string, {
userAgent: "mock-codex-app-server",
codexHome: process.cwd(),