@opengeni/contracts 0.50.0 → 1.0.0

package/dist/subscription-account-pools.d.ts

@@ -0,0 +1,292 @@
+import { z } from "zod";
+/** Shared, secret-free account list contract for native subscription pools. */
+export declare const SubscriptionAccountSummary: z.ZodObject<{
+    id: z.ZodString;
+    scope: z.ZodEnum<{
+        organization: "organization";
+        user: "user";
+        workspace: "workspace";
+    }>;
+    subject: z.ZodString;
+    email: z.ZodNullable<z.ZodString>;
+    label: z.ZodNullable<z.ZodString>;
+    plan: z.ZodNullable<z.ZodString>;
+    status: z.ZodEnum<{
+        active: "active";
+        disabled: "disabled";
+        error: "error";
+        needs_relogin: "needs_relogin";
+    }>;
+    active: z.ZodBoolean;
+    expiresAt: z.ZodNullable<z.ZodString>;
+    lastRefreshAt: z.ZodNullable<z.ZodString>;
+    lastError: z.ZodNullable<z.ZodString>;
+    allocatorEnabled: z.ZodBoolean;
+    allocatorVersion: z.ZodNumber;
+    allocatorUpdatedAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type SubscriptionAccountSummary = z.infer<typeof SubscriptionAccountSummary>;
+export declare const SubscriptionPoolSettings: z.ZodObject<{
+    rotationEnabled: z.ZodBoolean;
+    rotationStrategy: z.ZodLiteral<"sharded">;
+    activeCredentialId: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export type SubscriptionPoolSettings = z.infer<typeof SubscriptionPoolSettings>;
+export declare const ClaudeSubscriptionAccount: z.ZodObject<{
+    id: z.ZodString;
+    scope: z.ZodEnum<{
+        organization: "organization";
+        user: "user";
+        workspace: "workspace";
+    }>;
+    subject: z.ZodString;
+    email: z.ZodNullable<z.ZodString>;
+    label: z.ZodNullable<z.ZodString>;
+    plan: z.ZodNullable<z.ZodString>;
+    status: z.ZodEnum<{
+        active: "active";
+        disabled: "disabled";
+        error: "error";
+        needs_relogin: "needs_relogin";
+    }>;
+    active: z.ZodBoolean;
+    expiresAt: z.ZodNullable<z.ZodString>;
+    lastRefreshAt: z.ZodNullable<z.ZodString>;
+    lastError: z.ZodNullable<z.ZodString>;
+    allocatorEnabled: z.ZodBoolean;
+    allocatorVersion: z.ZodNumber;
+    allocatorUpdatedAt: z.ZodNullable<z.ZodString>;
+    version: z.ZodNumber;
+    usage: z.ZodOptional<z.ZodObject<{
+        connected: z.ZodBoolean;
+        credentialVersion: z.ZodNullable<z.ZodNumber>;
+        windows: z.ZodArray<z.ZodObject<{
+            id: z.ZodEnum<{
+                five_hour: "five_hour";
+                overage: "overage";
+                seven_day: "seven_day";
+                seven_day_opus: "seven_day_opus";
+                seven_day_overage_included: "seven_day_overage_included";
+                seven_day_sonnet: "seven_day_sonnet";
+            }>;
+            usedPercent: z.ZodNullable<z.ZodNumber>;
+            resetsAt: z.ZodNullable<z.ZodString>;
+            status: z.ZodNullable<z.ZodEnum<{
+                allowed: "allowed";
+                allowed_warning: "allowed_warning";
+                rejected: "rejected";
+            }>>;
+            observedAt: z.ZodString;
+            source: z.ZodOptional<z.ZodEnum<{
+                provider: "provider";
+                response_headers: "response_headers";
+            }>>;
+        }, z.core.$strict>>;
+        observedAt: z.ZodNullable<z.ZodString>;
+        source: z.ZodNullable<z.ZodEnum<{
+            provider: "provider";
+            response_headers: "response_headers";
+        }>>;
+        refreshStatus: z.ZodEnum<{
+            available: "available";
+            not_checked: "not_checked";
+            reconnect: "reconnect";
+            scope_required: "scope_required";
+            unavailable: "unavailable";
+        }>;
+        refreshCheckedAt: z.ZodNullable<z.ZodString>;
+        requestStatus: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            status: z.ZodNullable<z.ZodEnum<{
+                allowed: "allowed";
+                allowed_warning: "allowed_warning";
+                rejected: "rejected";
+            }>>;
+            resetsAt: z.ZodNullable<z.ZodString>;
+            representativeClaim: z.ZodNullable<z.ZodEnum<{
+                five_hour: "five_hour";
+                overage: "overage";
+                seven_day: "seven_day";
+                seven_day_opus: "seven_day_opus";
+                seven_day_overage_included: "seven_day_overage_included";
+                seven_day_sonnet: "seven_day_sonnet";
+            }>>;
+            overageStatus: z.ZodNullable<z.ZodEnum<{
+                allowed: "allowed";
+                allowed_warning: "allowed_warning";
+                rejected: "rejected";
+            }>>;
+            overageResetsAt: z.ZodNullable<z.ZodString>;
+            upstreamModelId: z.ZodNullable<z.ZodString>;
+            observedAt: z.ZodString;
+            source: z.ZodOptional<z.ZodEnum<{
+                provider: "provider";
+                response_headers: "response_headers";
+            }>>;
+        }, z.core.$strict>>>;
+        requestRestrictions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            status: z.ZodNullable<z.ZodEnum<{
+                allowed: "allowed";
+                allowed_warning: "allowed_warning";
+                rejected: "rejected";
+            }>>;
+            resetsAt: z.ZodNullable<z.ZodString>;
+            representativeClaim: z.ZodNullable<z.ZodEnum<{
+                five_hour: "five_hour";
+                overage: "overage";
+                seven_day: "seven_day";
+                seven_day_opus: "seven_day_opus";
+                seven_day_overage_included: "seven_day_overage_included";
+                seven_day_sonnet: "seven_day_sonnet";
+            }>>;
+            overageStatus: z.ZodNullable<z.ZodEnum<{
+                allowed: "allowed";
+                allowed_warning: "allowed_warning";
+                rejected: "rejected";
+            }>>;
+            overageResetsAt: z.ZodNullable<z.ZodString>;
+            upstreamModelId: z.ZodNullable<z.ZodString>;
+            observedAt: z.ZodString;
+            source: z.ZodOptional<z.ZodEnum<{
+                provider: "provider";
+                response_headers: "response_headers";
+            }>>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ClaudeSubscriptionAccount = z.infer<typeof ClaudeSubscriptionAccount>;
+export declare const ClaudeSubscriptionAccountsResponse: z.ZodObject<{
+    accounts: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        scope: z.ZodEnum<{
+            organization: "organization";
+            user: "user";
+            workspace: "workspace";
+        }>;
+        subject: z.ZodString;
+        email: z.ZodNullable<z.ZodString>;
+        label: z.ZodNullable<z.ZodString>;
+        plan: z.ZodNullable<z.ZodString>;
+        status: z.ZodEnum<{
+            active: "active";
+            disabled: "disabled";
+            error: "error";
+            needs_relogin: "needs_relogin";
+        }>;
+        active: z.ZodBoolean;
+        expiresAt: z.ZodNullable<z.ZodString>;
+        lastRefreshAt: z.ZodNullable<z.ZodString>;
+        lastError: z.ZodNullable<z.ZodString>;
+        allocatorEnabled: z.ZodBoolean;
+        allocatorVersion: z.ZodNumber;
+        allocatorUpdatedAt: z.ZodNullable<z.ZodString>;
+        version: z.ZodNumber;
+        usage: z.ZodOptional<z.ZodObject<{
+            connected: z.ZodBoolean;
+            credentialVersion: z.ZodNullable<z.ZodNumber>;
+            windows: z.ZodArray<z.ZodObject<{
+                id: z.ZodEnum<{
+                    five_hour: "five_hour";
+                    overage: "overage";
+                    seven_day: "seven_day";
+                    seven_day_opus: "seven_day_opus";
+                    seven_day_overage_included: "seven_day_overage_included";
+                    seven_day_sonnet: "seven_day_sonnet";
+                }>;
+                usedPercent: z.ZodNullable<z.ZodNumber>;
+                resetsAt: z.ZodNullable<z.ZodString>;
+                status: z.ZodNullable<z.ZodEnum<{
+                    allowed: "allowed";
+                    allowed_warning: "allowed_warning";
+                    rejected: "rejected";
+                }>>;
+                observedAt: z.ZodString;
+                source: z.ZodOptional<z.ZodEnum<{
+                    provider: "provider";
+                    response_headers: "response_headers";
+                }>>;
+            }, z.core.$strict>>;
+            observedAt: z.ZodNullable<z.ZodString>;
+            source: z.ZodNullable<z.ZodEnum<{
+                provider: "provider";
+                response_headers: "response_headers";
+            }>>;
+            refreshStatus: z.ZodEnum<{
+                available: "available";
+                not_checked: "not_checked";
+                reconnect: "reconnect";
+                scope_required: "scope_required";
+                unavailable: "unavailable";
+            }>;
+            refreshCheckedAt: z.ZodNullable<z.ZodString>;
+            requestStatus: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                status: z.ZodNullable<z.ZodEnum<{
+                    allowed: "allowed";
+                    allowed_warning: "allowed_warning";
+                    rejected: "rejected";
+                }>>;
+                resetsAt: z.ZodNullable<z.ZodString>;
+                representativeClaim: z.ZodNullable<z.ZodEnum<{
+                    five_hour: "five_hour";
+                    overage: "overage";
+                    seven_day: "seven_day";
+                    seven_day_opus: "seven_day_opus";
+                    seven_day_overage_included: "seven_day_overage_included";
+                    seven_day_sonnet: "seven_day_sonnet";
+                }>>;
+                overageStatus: z.ZodNullable<z.ZodEnum<{
+                    allowed: "allowed";
+                    allowed_warning: "allowed_warning";
+                    rejected: "rejected";
+                }>>;
+                overageResetsAt: z.ZodNullable<z.ZodString>;
+                upstreamModelId: z.ZodNullable<z.ZodString>;
+                observedAt: z.ZodString;
+                source: z.ZodOptional<z.ZodEnum<{
+                    provider: "provider";
+                    response_headers: "response_headers";
+                }>>;
+            }, z.core.$strict>>>;
+            requestRestrictions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                status: z.ZodNullable<z.ZodEnum<{
+                    allowed: "allowed";
+                    allowed_warning: "allowed_warning";
+                    rejected: "rejected";
+                }>>;
+                resetsAt: z.ZodNullable<z.ZodString>;
+                representativeClaim: z.ZodNullable<z.ZodEnum<{
+                    five_hour: "five_hour";
+                    overage: "overage";
+                    seven_day: "seven_day";
+                    seven_day_opus: "seven_day_opus";
+                    seven_day_overage_included: "seven_day_overage_included";
+                    seven_day_sonnet: "seven_day_sonnet";
+                }>>;
+                overageStatus: z.ZodNullable<z.ZodEnum<{
+                    allowed: "allowed";
+                    allowed_warning: "allowed_warning";
+                    rejected: "rejected";
+                }>>;
+                overageResetsAt: z.ZodNullable<z.ZodString>;
+                upstreamModelId: z.ZodNullable<z.ZodString>;
+                observedAt: z.ZodString;
+                source: z.ZodOptional<z.ZodEnum<{
+                    provider: "provider";
+                    response_headers: "response_headers";
+                }>>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    activeAccountId: z.ZodNullable<z.ZodString>;
+    source: z.ZodEnum<{
+        organization: "organization";
+        user: "user";
+        workspace: "workspace";
+    }>;
+    organizationId: z.ZodString;
+    settings: z.ZodObject<{
+        rotationEnabled: z.ZodBoolean;
+        rotationStrategy: z.ZodLiteral<"sharded">;
+        activeCredentialId: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type ClaudeSubscriptionAccountsResponse = z.infer<typeof ClaudeSubscriptionAccountsResponse>;

package/dist/task-notes.d.ts

@@ -1,7 +1,7 @@
 import { z } from "zod";
 export declare const TASK_NOTE_TEXT_MAX_BYTES = 4096;
 export declare const TASK_NOTE_REASON_MAX_BYTES = 2048;
-export declare const TASK_NOTE_MAX_LIFETIME_DAYS = 30;
+export declare const TASK_NOTE_MAX_LIFETIME_DAYS = 90;
 export declare const TASK_NOTE_ACTIVE_RECORD_CAP = 500;
 export declare const TASK_NOTE_LIST_DEFAULT_LIMIT = 10;
 export declare const TASK_NOTE_LIST_MAX_LIMIT = 20;
@@ -93,6 +93,47 @@ export declare const TaskNoteMutationResult: z.ZodObject<{
     replayed: z.ZodBoolean;
 }, z.core.$strip>;
 export type TaskNoteMutationResult = z.infer<typeof TaskNoteMutationResult>;
+/** Atomic correction lineage: archive one exact v1 note and create one v1 replacement. */
+export declare const TaskNoteReplacementResult: z.ZodObject<{
+    operationId: z.ZodString;
+    inputHash: z.ZodString;
+    replaces: z.ZodObject<{
+        noteId: z.ZodString;
+        archivedVersion: z.ZodLiteral<2>;
+    }, z.core.$strip>;
+    replacement: z.ZodObject<{
+        id: z.ZodString;
+        rootSessionId: z.ZodString;
+        kind: z.ZodEnum<{
+            artifact: "artifact";
+            blocker: "blocker";
+            decision: "decision";
+            finding: "finding";
+            handoff: "handoff";
+            ownership: "ownership";
+        }>;
+        text: z.ZodString;
+        status: z.ZodEnum<{
+            active: "active";
+            archived: "archived";
+        }>;
+        version: z.ZodNumber;
+        expiresAt: z.ZodString;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+        archivedAt: z.ZodNullable<z.ZodString>;
+        provenance: z.ZodObject<{
+            actorKind: z.ZodEnum<{
+                human: "human";
+                service: "service";
+            }>;
+            sourceSessionId: z.ZodString;
+            sourceTurnId: z.ZodString;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+    replayed: z.ZodBoolean;
+}, z.core.$strip>;
+export type TaskNoteReplacementResult = z.infer<typeof TaskNoteReplacementResult>;
 export declare const TaskNoteListResponse: z.ZodObject<{
     notes: z.ZodArray<z.ZodObject<{
         id: z.ZodString;

package/dist/tool-catalog.d.ts

@@ -1,5 +1,6 @@
 import { z } from "zod";
 export declare const ATTEMPT_TOOL_CATALOG_VERSION: 1;
+export declare const TOOL_GATEWAY_CATALOG_VERSION: 1;
 export declare const ATTEMPT_TOOL_CATALOG_MAX_ENTRIES = 4096;
 export declare const ATTEMPT_TOOL_CATALOG_MAX_BYTES: number;
 export declare const ATTEMPT_TOOL_CATALOG_MAX_PATH_SEGMENTS = 8;
@@ -17,6 +18,12 @@ export declare const AttemptToolIdentity: z.ZodObject<{
     toolName: z.ZodString;
 }, z.core.$strict>;
 export type AttemptToolIdentity = z.infer<typeof AttemptToolIdentity>;
+/** Protocol-neutral tool identity shared by MCP, HTTP/SDK, agents, and Codemode. */
+export declare const ToolGatewayIdentity: z.ZodObject<{
+    serverId: z.ZodString;
+    toolName: z.ZodString;
+}, z.core.$strict>;
+export type ToolGatewayIdentity = AttemptToolIdentity;
 export declare const AttemptToolCatalogIcon: z.ZodObject<{
     src: z.ZodString;
     mimeType: z.ZodOptional<z.ZodString>;
@@ -39,6 +46,13 @@ export type AttemptToolAnnotations = z.infer<typeof AttemptToolAnnotations>;
 /** JSON Schema is preserved as received. Runtime byte/node guards remain authoritative. */
 export declare const AttemptToolJsonSchema: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
 export type AttemptToolJsonSchema = z.infer<typeof AttemptToolJsonSchema>;
+/** Presentation only; never parsed as execution or account authority. */
+export declare const ToolDisplayMetadata: z.ZodObject<{
+    toolName: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    accountLabel: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type ToolDisplayMetadata = z.infer<typeof ToolDisplayMetadata>;
 export declare const AttemptToolCatalogEntry: z.ZodObject<{
     identity: z.ZodObject<{
         serverId: z.ZodString;
@@ -81,6 +95,118 @@ export declare const AttemptToolCatalogEntry: z.ZodObject<{
     }>;
 }, z.core.$strict>;
 export type AttemptToolCatalogEntry = z.infer<typeof AttemptToolCatalogEntry>;
+/** One canonical gateway entry. Adapter-specific names are projections, never authority. */
+export declare const ToolGatewayCatalogEntry: z.ZodObject<{
+    identity: z.ZodObject<{
+        serverId: z.ZodString;
+        toolName: z.ZodString;
+    }, z.core.$strict>;
+    modelName: z.ZodString;
+    codemodePath: z.ZodArray<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    inputSchema: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+    outputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+    annotations: z.ZodOptional<z.ZodObject<{
+        title: z.ZodOptional<z.ZodString>;
+        readOnlyHint: z.ZodOptional<z.ZodBoolean>;
+        destructiveHint: z.ZodOptional<z.ZodBoolean>;
+        idempotentHint: z.ZodOptional<z.ZodBoolean>;
+        openWorldHint: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$loose>>;
+    icons: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        src: z.ZodString;
+        mimeType: z.ZodOptional<z.ZodString>;
+        sizes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        theme: z.ZodOptional<z.ZodEnum<{
+            dark: "dark";
+            light: "light";
+        }>>;
+    }, z.core.$strict>>>;
+    source: z.ZodEnum<{
+        codex_apps: "codex_apps";
+        docs: "docs";
+        files: "files";
+        interaction: "interaction";
+        mcp: "mcp";
+        opengeni: "opengeni";
+    }>;
+    approval: z.ZodEnum<{
+        human: "human";
+        none: "none";
+        policy: "policy";
+    }>;
+}, z.core.$strict>;
+export type ToolGatewayCatalogEntry = AttemptToolCatalogEntry;
+export declare const ToolGatewayCatalog: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    accountId: z.ZodString;
+    workspaceId: z.ZodString;
+    generation: z.ZodNumber;
+    digest: z.ZodString;
+    createdAt: z.ZodString;
+    entries: z.ZodArray<z.ZodObject<{
+        identity: z.ZodObject<{
+            serverId: z.ZodString;
+            toolName: z.ZodString;
+        }, z.core.$strict>;
+        modelName: z.ZodString;
+        codemodePath: z.ZodArray<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        inputSchema: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+        outputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+        annotations: z.ZodOptional<z.ZodObject<{
+            title: z.ZodOptional<z.ZodString>;
+            readOnlyHint: z.ZodOptional<z.ZodBoolean>;
+            destructiveHint: z.ZodOptional<z.ZodBoolean>;
+            idempotentHint: z.ZodOptional<z.ZodBoolean>;
+            openWorldHint: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$loose>>;
+        icons: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            src: z.ZodString;
+            mimeType: z.ZodOptional<z.ZodString>;
+            sizes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            theme: z.ZodOptional<z.ZodEnum<{
+                dark: "dark";
+                light: "light";
+            }>>;
+        }, z.core.$strict>>>;
+        source: z.ZodEnum<{
+            codex_apps: "codex_apps";
+            docs: "docs";
+            files: "files";
+            interaction: "interaction";
+            mcp: "mcp";
+            opengeni: "opengeni";
+        }>;
+        approval: z.ZodEnum<{
+            human: "human";
+            none: "none";
+            policy: "policy";
+        }>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ToolGatewayCatalog = z.infer<typeof ToolGatewayCatalog>;
+export declare const ToolGatewayCaller: z.ZodObject<{
+    kind: z.ZodEnum<{
+        browser: "browser";
+        codemode: "codemode";
+        http: "http";
+        mcp: "mcp";
+        model: "model";
+    }>;
+    subjectId: z.ZodString;
+}, z.core.$strict>;
+export type ToolGatewayCaller = z.infer<typeof ToolGatewayCaller>;
+/**
+ * MCP request `_meta` key naming the attempt surface that issued a call to the
+ * first-party server: `model` for a direct model tool call, `codemode` for a
+ * Codemode script. Only the worker's own tool gateway sets it, and only for the
+ * first-party server. A read reached the model's context only when it says
+ * `model`; a Codemode script may keep the output to itself.
+ */
+export declare const FIRST_PARTY_MCP_CALLER_META_KEY = "opengeniCaller";
 export declare const AttemptToolCatalog: z.ZodObject<{
     version: z.ZodLiteral<1>;
     accountId: z.ZodString;
@@ -328,6 +454,166 @@ export declare const AttemptToolResult: z.ZodObject<{
     _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
 }, z.core.$loose>;
 export type AttemptToolResult = z.infer<typeof AttemptToolResult>;
+export declare const ToolGatewayResult: z.ZodObject<{
+    content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+        text: z.ZodString;
+        annotations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+        _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+    }, z.core.$loose>, z.ZodObject<{
+        type: z.ZodLiteral<"image">;
+        data: z.ZodString;
+        mimeType: z.ZodString;
+        annotations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+        _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+    }, z.core.$loose>, z.ZodObject<{
+        type: z.ZodLiteral<"audio">;
+        data: z.ZodString;
+        mimeType: z.ZodString;
+        annotations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+        _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+    }, z.core.$loose>, z.ZodObject<{
+        type: z.ZodLiteral<"resource_link">;
+        name: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        uri: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        mimeType: z.ZodOptional<z.ZodString>;
+        size: z.ZodOptional<z.ZodNumber>;
+        icons: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            src: z.ZodString;
+            mimeType: z.ZodOptional<z.ZodString>;
+            sizes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            theme: z.ZodOptional<z.ZodEnum<{
+                dark: "dark";
+                light: "light";
+            }>>;
+        }, z.core.$strict>>>;
+        annotations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+        _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+    }, z.core.$loose>, z.ZodObject<{
+        type: z.ZodLiteral<"resource">;
+        resource: z.ZodUnion<readonly [z.ZodObject<{
+            uri: z.ZodString;
+            mimeType: z.ZodOptional<z.ZodString>;
+            text: z.ZodString;
+            _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+        }, z.core.$loose>, z.ZodObject<{
+            uri: z.ZodString;
+            mimeType: z.ZodOptional<z.ZodString>;
+            blob: z.ZodString;
+            _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+        }, z.core.$loose>]>;
+        annotations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+        _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+    }, z.core.$loose>], "type">>;
+    structuredContent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+    isError: z.ZodOptional<z.ZodBoolean>;
+    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+}, z.core.$loose>;
+export type ToolGatewayResult = AttemptToolResult;
+export declare const ToolGatewayCallRequest: z.ZodObject<{
+    operationId: z.ZodOptional<z.ZodString>;
+    catalogDigest: z.ZodString;
+    identity: z.ZodObject<{
+        serverId: z.ZodString;
+        toolName: z.ZodString;
+    }, z.core.$strict>;
+    arguments: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+    siteArtifactId: z.ZodOptional<z.ZodString>;
+    siteVersionId: z.ZodOptional<z.ZodString>;
+    approvalToken: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type ToolGatewayCallRequest = z.infer<typeof ToolGatewayCallRequest>;
+export declare const ToolGatewayApprovalRequest: z.ZodObject<{
+    operationId: z.ZodString;
+    catalogDigest: z.ZodString;
+    identity: z.ZodObject<{
+        serverId: z.ZodString;
+        toolName: z.ZodString;
+    }, z.core.$strict>;
+    arguments: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+}, z.core.$strict>;
+export type ToolGatewayApprovalRequest = z.infer<typeof ToolGatewayApprovalRequest>;
+export declare const ToolGatewayApprovalResponse: z.ZodObject<{
+    operationId: z.ZodString;
+    catalogDigest: z.ZodString;
+    identity: z.ZodObject<{
+        serverId: z.ZodString;
+        toolName: z.ZodString;
+    }, z.core.$strict>;
+    approvalToken: z.ZodString;
+    expiresAt: z.ZodString;
+}, z.core.$strict>;
+export type ToolGatewayApprovalResponse = z.infer<typeof ToolGatewayApprovalResponse>;
+export declare const ToolGatewayCallResponse: z.ZodObject<{
+    operationId: z.ZodString;
+    catalogDigest: z.ZodString;
+    result: z.ZodObject<{
+        content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"text">;
+            text: z.ZodString;
+            annotations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+            _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+        }, z.core.$loose>, z.ZodObject<{
+            type: z.ZodLiteral<"image">;
+            data: z.ZodString;
+            mimeType: z.ZodString;
+            annotations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+            _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+        }, z.core.$loose>, z.ZodObject<{
+            type: z.ZodLiteral<"audio">;
+            data: z.ZodString;
+            mimeType: z.ZodString;
+            annotations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+            _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+        }, z.core.$loose>, z.ZodObject<{
+            type: z.ZodLiteral<"resource_link">;
+            name: z.ZodString;
+            title: z.ZodOptional<z.ZodString>;
+            uri: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            mimeType: z.ZodOptional<z.ZodString>;
+            size: z.ZodOptional<z.ZodNumber>;
+            icons: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                src: z.ZodString;
+                mimeType: z.ZodOptional<z.ZodString>;
+                sizes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                theme: z.ZodOptional<z.ZodEnum<{
+                    dark: "dark";
+                    light: "light";
+                }>>;
+            }, z.core.$strict>>>;
+            annotations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+            _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+        }, z.core.$loose>, z.ZodObject<{
+            type: z.ZodLiteral<"resource">;
+            resource: z.ZodUnion<readonly [z.ZodObject<{
+                uri: z.ZodString;
+                mimeType: z.ZodOptional<z.ZodString>;
+                text: z.ZodString;
+                _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+            }, z.core.$loose>, z.ZodObject<{
+                uri: z.ZodString;
+                mimeType: z.ZodOptional<z.ZodString>;
+                blob: z.ZodString;
+                _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+            }, z.core.$loose>]>;
+            annotations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+            _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+        }, z.core.$loose>], "type">>;
+        structuredContent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+        isError: z.ZodOptional<z.ZodBoolean>;
+        _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+    }, z.core.$loose>;
+}, z.core.$strict>;
+export type ToolGatewayCallResponse = z.infer<typeof ToolGatewayCallResponse>;
+export declare const ToolGatewayDeclarationsResponse: z.ZodObject<{
+    catalogDigest: z.ZodString;
+    moduleSpecifier: z.ZodString;
+    source: z.ZodString;
+}, z.core.$strict>;
+export type ToolGatewayDeclarationsResponse = z.infer<typeof ToolGatewayDeclarationsResponse>;
 export declare const CodemodeOperationState: z.ZodEnum<{
     cancelled: "cancelled";
     completed: "completed";

package/dist/tool-result-spill.d.ts

@@ -0,0 +1,16 @@
+import { z } from "zod";
+/** Model-visible overflow of one tool result. Exact bytes live on a workspace File. */
+export declare const TOOL_RESULT_SPILLED_TYPE: "tool_result_spilled";
+export declare const TOOL_RESULT_SPILL_MEDIA_TYPE: "application/json";
+export declare const TOOL_RESULT_SPILL_MOUNT_PATH: "tool-results";
+export declare const ToolResultSpilledReceipt: z.ZodObject<{
+    type: z.ZodLiteral<"tool_result_spilled">;
+    sandboxPath: z.ZodNullable<z.ZodString>;
+    fileId: z.ZodString;
+    byteSize: z.ZodNumber;
+    mediaType: z.ZodLiteral<"application/json">;
+}, z.core.$strict>;
+export type ToolResultSpilledReceipt = z.infer<typeof ToolResultSpilledReceipt>;
+export declare function isToolResultSpilledReceipt(value: unknown): value is ToolResultSpilledReceipt;
+export declare function toolResultSpillSandboxPath(filename: string): string;
+export declare function toolResultSpillFilename(operationId: string): string;