@opengeni/sdk 0.23.0 → 0.25.5

package/README.md

@@ -30,6 +30,34 @@ for await (const event of client.streamEvents(workspaceId, session.id)) {
 }
 ```
 
+## Error handling
+
+Non-2xx responses throw `OpenGeniApiError` with stable transport metadata:
+`status`, optional `code`, `retryable`, optional `correlationId`,
+`outcomeUnknown`, and a bounded structured `body`. The SDK sends a fresh bounded
+correlation ID on each API request and includes the safe returned reference in
+the display message.
+
+```ts
+import { OpenGeniApiError } from "@opengeni/sdk";
+
+try {
+  await client.sendMessage(workspaceId, sessionId, input);
+} catch (error) {
+  if (error instanceof OpenGeniApiError && error.outcomeUnknown) {
+    // Reconcile durable state, then retry only with input.clientEventId unchanged.
+  }
+  throw error;
+}
+```
+
+Error bodies are read only when they are JSON and no larger than 16 KiB; raw
+gateway HTML/plain text and oversized bodies are discarded. A controlled typed
+API rejection has `outcomeUnknown: false`. A raw `502`/`503`/`504` or an
+unexpected successful non-JSON response to a mutation has `outcomeUnknown:
+true` because the mutation might already have been accepted. Never turn that
+condition into a new operation by changing its idempotency key.
+
 ## Streaming guarantees
 
 `client.streamEvents(...)` (and the underlying `streamSessionEvents`) delivers
@@ -151,6 +179,30 @@ await client.resumeSession(workspaceId, sessionId, {
 await client.sendApprovalDecision(workspaceId, sessionId, { approvalId, decision: "approve" });
 ```
 
+## Session tool policy and native web search
+
+Omitting `tools` when creating a top-level session selects the current
+workspace-default capability policy. Supported Responses providers can then
+attach their native bounded web-search tool without requiring a sandbox.
+Passing `tools`, including `[]`, is an intentional fixed narrowing.
+
+Existing explicit sessions are not widened when a new default capability is
+introduced. Opt one in explicitly with the current optimistic-concurrency
+version; the audited change takes effect on its next attempt:
+
+```ts
+const session = await client.getSession(workspaceId, sessionId);
+const updated = await client.updateSessionToolPolicy(workspaceId, sessionId, {
+  mode: "workspace_default",
+  expectedVersion: session.toolPolicyVersion ?? 1,
+});
+```
+
+To keep a fixed MCP allow-list instead, use the backward-compatible explicit
+shape `{ tools, expectedVersion }`. `tool_search` discovers deferred MCP
+schemas; it is not public web search. Unsupported providers do not receive a
+cross-provider, MCP, or sandbox fallback.
+
 ## Goals
 
 ```ts

package/dist/index.d.ts

@@ -196,6 +196,9 @@ type SessionCapabilities = {
     os: SandboxOs;
     liveness: "cold" | "warming" | "warm" | "draining";
     leaseEpoch: number;
+    workspaceGeneration: number | null;
+    archiveGeneration: number | null;
+    archiveComplete: boolean;
     viewerHeartbeatIntervalMs: number;
     FileSystem: {
         available: boolean;
@@ -283,6 +286,9 @@ type ViewerHolder = {
     sandboxGroupId: string;
     liveness: "cold" | "warming" | "warm" | "draining";
     leaseEpoch: number;
+    workspaceGeneration: number | null;
+    archiveGeneration: number | null;
+    archiveComplete: boolean;
     viewerHeartbeatIntervalMs: number;
     dataPlaneUrl: string | null;
 };
@@ -352,6 +358,15 @@ type SessionToolPolicy = {
     mode: "workspace_default" | "explicit" | "inherited" | "legacy";
     inheritedFromSessionId: string | null;
 };
+type UpdateSessionToolPolicyRequest = {
+    mode: "workspace_default";
+    expectedVersion: number;
+} | {
+    /** Omitted for compatibility with the original explicit-only API. */
+    mode?: "explicit" | undefined;
+    tools: ToolRef[];
+    expectedVersion: number;
+};
 type SessionEffectiveToolPolicy = {
     mode: SessionToolPolicy["mode"];
     inheritedFromSessionId: string | null;
@@ -523,6 +538,7 @@ type Session = {
     resources: ResourceRef[];
     tools: ToolRef[];
     toolPolicy?: SessionToolPolicy | undefined;
+    toolPolicyVersion?: number | undefined;
     effectiveToolPolicy?: SessionEffectiveToolPolicy | undefined;
     metadata: Record<string, unknown>;
     /** Frozen creator fact; later turns carry their own independent initiator. */
@@ -542,6 +558,13 @@ type Session = {
     firstPartyMcpPermissions: string[] | null;
     mcpServers: SessionMcpServerMetadata[];
     parentSessionId: string | null;
+    /** Immutable server-authored nested-agent lineage and policy snapshot. */
+    rootSessionId: string;
+    nestedAgentDepth: number;
+    maxNestedAgentDepthOverride: number | null;
+    effectiveMaxNestedAgentDepth: number;
+    nestedAgentDepthPolicySource: "session" | "workspace" | "deployment" | "default";
+    nestedAgentDepthPolicySessionId: string | null;
     createIdempotencyKey: string | null;
     temporalWorkflowId: string | null;
     activeTurnId: string | null;
@@ -691,7 +714,7 @@ type SessionHumanInputRequest = {
     createdAt: string;
     updatedAt: string;
 };
-declare const SESSION_EVENT_TYPES: readonly ["session.created", "session.event.envelope_omitted", "session.status.changed", "session.requiresAction", "session.humanInput.requested", "session.context.compaction.requested", "session.context.compacted", "session.context.compaction.skipped", "session.context.cleared", "user.message", "user.pause", "user.approvalDecision", "user.humanInputResponse", "turn.queued", "turn.started", "turn.completed", "turn.failed", "turn.cancelled", "turn.superseded", "turn.recovery.requested", "turn.capacity_waiting", "agent.message.delta", "agent.message.completed", "agent.reasoning.delta", "agent.toolCall.created", "agent.toolCall.output", "agent.model.request", "agent.model.usage", "tool.auth_needed", "credential.auth_needed", "agent.updated", "rig.setup.started", "rig.setup.completed", "rig.setup.skipped", "rig.setup.failed", "sandbox.operation.started", "sandbox.operation.completed", "sandbox.operation.failed", "sandbox.command.output.delta", "artifact.created", "goal.set", "goal.updated", "goal.completed", "goal.paused", "goal.resumed", "goal.cleared", "goal.continuation", "system.update.pending", "system.update.delivered", "session.control.paused", "session.control.resumed", "session.control.steer_requested", "workspace.inference.paused", "workspace.inference.resumed", "session.queue.changed", "session.queue.prompt.cancelled", "session.queue.history", "turn.event.rejected_late", "memory.saved", "memory.corrected", "stream.url.rotated", "stream.opened", "stream.closed", "stream.revoked", "recording.started", "recording.available", "recording.failed", "fs.changed", "git.changed", "terminal.pty.started", "terminal.pty.output.delta", "terminal.pty.exited", "session.title_set", "session.mcp.approval_policy.updated", "codex.account.switched", "codex.credential.selected", "codex.capacity.waiting", "codex.capacity.resumed", "codex.capacity.superseded", "sandbox.box.created", "sandbox.box.lost", "sandbox.box.terminated", "sandbox.box.snapshot", "sandbox.env.drift", "session.route.reconciled", "workspace.revision.captured", "workspace.revision.degraded", "machine.op.failed", "machine.op.recovered", "machine.link.lost", "machine.link.restored", "machine.runner.restarted"];
+declare const SESSION_EVENT_TYPES: readonly ["session.created", "session.event.envelope_omitted", "session.status.changed", "session.requiresAction", "session.humanInput.requested", "session.context.compaction.requested", "session.context.compacted", "session.context.compaction.skipped", "session.context.cleared", "user.message", "user.pause", "user.approvalDecision", "user.humanInputResponse", "turn.queued", "turn.started", "turn.completed", "turn.failed", "turn.cancelled", "turn.superseded", "turn.recovery.requested", "turn.capacity_waiting", "agent.message.delta", "agent.message.completed", "agent.reasoning.delta", "agent.toolCall.created", "agent.toolCall.output", "agent.model.request", "agent.model.usage", "tool.auth_needed", "credential.auth_needed", "agent.updated", "rig.setup.started", "rig.setup.completed", "rig.setup.skipped", "rig.setup.failed", "sandbox.operation.started", "sandbox.operation.completed", "sandbox.operation.failed", "sandbox.command.output.delta", "artifact.created", "goal.set", "goal.updated", "goal.completed", "goal.paused", "goal.resumed", "goal.cleared", "goal.continuation", "system.update.pending", "system.update.delivered", "session.control.paused", "session.control.resumed", "session.control.steer_requested", "workspace.inference.paused", "workspace.inference.resumed", "session.queue.changed", "session.queue.prompt.cancelled", "session.queue.history", "turn.event.rejected_late", "memory.saved", "memory.corrected", "stream.url.rotated", "stream.opened", "stream.closed", "stream.revoked", "recording.started", "recording.available", "recording.failed", "fs.changed", "git.changed", "terminal.pty.started", "terminal.pty.output.delta", "terminal.pty.exited", "session.title_set", "session.mcp.approval_policy.updated", "session.tool_policy.updated", "codex.account.switched", "codex.credential.selected", "codex.fleet.decision", "codex.capacity.waiting", "codex.capacity.resumed", "codex.capacity.superseded", "sandbox.box.created", "sandbox.box.lost", "sandbox.box.terminated", "sandbox.box.snapshot", "sandbox.env.drift", "session.route.reconciled", "workspace.revision.captured", "workspace.revision.degraded", "machine.op.failed", "machine.op.recovered", "machine.link.lost", "machine.link.restored", "machine.runner.restarted"];
 type KnownSessionEventType = (typeof SESSION_EVENT_TYPES)[number];
 /**
  * Event types the SDK knows about today, kept open so a newer OpenGeni server
@@ -848,6 +871,62 @@ type AgentToolCallOutputPayload = {
 type SessionStatusChangedPayload = {
     status: SessionStatus;
 };
+type CodexFleetConfidence = "unknown" | "low" | "medium" | "high";
+type CodexFleetCacheState = "unknown" | "healthy" | "collapsed";
+type CodexFleetShadowComparison = "match" | "different_candidate" | "different_outcome" | "not_comparable_truncated";
+type CodexFleetDecisionScore = {
+    candidateKey: string;
+    eligible: boolean;
+    rejectionReason: "allocator_disabled" | "unavailable" | "cooling" | "quota_ceiling" | "overlay_isolation" | null;
+    quotaPressure: number;
+    leasePressure: number;
+    observedBurnPressure: number;
+    inferredBurnPressure: number;
+    runwayPressure: number;
+    uncertaintyPressure: number;
+    cacheAffinityBenefit: number;
+    cacheState: CodexFleetCacheState;
+    overlayPreferenceBenefit: number;
+    total: number;
+    confidence: CodexFleetConfidence;
+};
+type CodexFleetDecisionEventPayload = {
+    schemaVersion: 1;
+    mode: "shadow";
+    actual: {
+        outcome: "selected" | "waiting" | "none";
+        candidateKey: string | null;
+        reason: "lease_reused" | "pin" | "rotation" | "active" | "all_capped" | "none";
+    };
+    comparison: CodexFleetShadowComparison;
+    replay: {
+        schemaVersion: 1;
+        policyVersion: "adaptive-shadow-v1";
+        mode: "shadow";
+        input: {
+            candidates: Array<{
+                key: string;
+            }>;
+        } & Record<string, unknown>;
+        truncatedCandidateCount: number;
+        inputFingerprint: string;
+        decisionFingerprint: string;
+        decision: {
+            outcome: "selected" | "paced" | "none";
+            selectedCandidateKey: string | null;
+            reason: "fenced_in_flight" | "fenced_candidate_missing" | "admission_paced" | "no_eligible_candidate" | "overlay_isolated_empty" | "best_score" | "affinity_best" | "hysteresis_hold";
+            admission: {
+                outcome: "admit" | "pace";
+                reason: "fenced_in_flight" | "pacing_disabled" | "capacity_unknown" | "capacity_available" | "work_conserving_borrow" | "manager_priority" | "standard_starvation_bound" | "capacity_saturated" | "emergency_fuse";
+                borrowedIdleCapacity: boolean;
+            };
+            borrowedOverlayCapacity: boolean;
+            strandedEligibleCount: number;
+            confidence: CodexFleetConfidence;
+            scores: CodexFleetDecisionScore[];
+        };
+    } & Record<string, unknown>;
+};
 type RecordingMode = "manual" | "on-turn" | "on-verify";
 type RecordingCodec = "h264-mp4" | "vp9-webm";
 type RecordingContentType = "video/mp4" | "video/webm";
@@ -923,7 +1002,7 @@ type TerminalPtyOutputDeltaPayload = {
 type TerminalPtyExitedPayload = {
     ptyId: string;
     exitCode: number | null;
-    reason: "exit" | "killed" | "owner_gone" | "timeout";
+    reason: "exit" | "killed" | "owner_gone" | "timeout" | "lost";
 };
 type FsNodeType = "file" | "dir" | "symlink" | "other";
 type FsTreeNode = {
@@ -1213,8 +1292,8 @@ type TerminalExecRequest = {
 type TerminalExecResponse = {
     stdout: string;
     stderr: string;
-    exitCode: number | null;
-    running: boolean;
+    exitCode: number;
+    running: false;
     wallTimeSeconds: number;
 };
 type PtyOpenRequest = {
@@ -1287,6 +1366,7 @@ type ScheduledTaskAgentConfig = {
     reasoningEffort?: ReasoningEffort | undefined;
     sandboxBackend?: SandboxBackend | undefined;
     goal?: GoalSpec | undefined;
+    maxNestedAgentDepth?: number | undefined;
 };
 type ScheduledTask = {
     id: string;
@@ -1329,6 +1409,8 @@ type CreateSessionRequest = {
     goal?: GoalSpec | undefined;
     clientEventId?: string | undefined;
     idempotencyKey?: string | undefined;
+    expectedNewSessionDraftRevision?: number | undefined;
+    maxNestedAgentDepth?: number | undefined;
     firstPartyMcpPermissions?: string[] | undefined;
     mcpServers?: SessionMcpServerInput[] | undefined;
     sandbox?: "shared" | "new" | {
@@ -1668,6 +1750,8 @@ type ClientAuthConfig = {
 };
 declare const OPENGENI_API_CONTRACT_REVISION: "2026-07-turn-instructions-v1";
 declare const OPENGENI_API_CONTRACT_HEADER: "x-opengeni-api-contract";
+/** Bounded request/response identifier shared by browser, ingress, and API diagnostics. */
+declare const OPENGENI_CORRELATION_HEADER: "x-opengeni-correlation-id";
 /**
  * Public, unauthenticated-by-default client bootstrap config returned by
  * `GET /v1/config/client`: which models + reasoning efforts are exposed, the
@@ -1751,11 +1835,13 @@ type Workspace = {
 type WorkspaceSettings = {
     memoryEnabled?: boolean | undefined;
     transcription?: WorkspaceTranscriptionPolicy | undefined;
+    maxNestedAgentDepth?: number | null | undefined;
     [key: string]: unknown;
 };
 type UpdateWorkspaceSettingsRequest = {
     memoryEnabled?: boolean | undefined;
     transcription?: WorkspaceTranscriptionPolicy | undefined;
+    maxNestedAgentDepth?: number | null | undefined;
     [key: string]: unknown;
 };
 type SetWorkspaceDefaultRigRequest = {
@@ -1821,6 +1907,16 @@ type UpdateWorkspaceMemberRequest = {
 };
 type SessionGoalStatus = "active" | "paused" | "completed";
 type SessionGoalCreatedBy = "api" | "agent" | "scheduled_task";
+type SessionGoalContinuationState = "inactive" | "scheduled" | "running" | "blocked" | "invariant_broken";
+type SessionGoalContinuationReason = "goal_inactive" | "wake_pending" | "continuation_pending" | "human_work_pending" | "goal_turn_running" | "human_turn_running" | "workstream_paused" | "approval_required" | "provider_backpressure" | "session_cancelled" | "system_work_pending" | "missing_obligation";
+type SessionGoalContinuation = {
+    state: SessionGoalContinuationState;
+    reason: SessionGoalContinuationReason;
+    wakeRevision: number;
+    observedRevision: number;
+    nextAttemptAt: string | null;
+    lastError: string | null;
+};
 type SessionGoal = {
     id: string;
     accountId: string;
@@ -1838,6 +1934,8 @@ type SessionGoal = {
     noProgressStreak: number;
     maxAutoContinuations: number | null;
     metadata: Record<string, unknown>;
+    /** Optional for source compatibility; the API always supplies this projection. */
+    continuation?: SessionGoalContinuation | undefined;
     createdAt: string;
     updatedAt: string;
 };
@@ -1915,6 +2013,27 @@ type ComposerDraft = {
     sourceTurnVersion: number | null;
     updatedAt: string | null;
 };
+type NewSessionDraftOptions = {
+    sandboxBackend?: SandboxBackend | undefined;
+    targetSandboxId?: string | undefined;
+    workingDir?: string | undefined;
+    variableSetId?: string | undefined;
+    rigId?: string | undefined;
+    goal?: GoalSpec | undefined;
+    firstPartyMcpPermissions?: Permission[] | undefined;
+};
+type NewSessionDraft = {
+    revision: number;
+    text: string;
+    resources: ResourceRef[];
+    tools: ToolRef[];
+    /** False inherits the workspace-default MCP policy; true preserves an explicit array. */
+    toolsProvided: boolean;
+    model: string;
+    reasoningEffort: ReasoningEffort;
+    options: NewSessionDraftOptions;
+    updatedAt: string | null;
+};
 type SessionQueueSnapshot = {
     version: number;
     effectiveControl: EffectiveSessionControl;
@@ -2012,6 +2131,9 @@ type DeleteSessionQueueItemRequest = {
 type SaveComposerDraftRequest = Omit<ComposerDraft, "revision" | "sourceTurnId" | "sourceTurnVersion" | "updatedAt"> & {
     expectedRevision: number;
 };
+type SaveNewSessionDraftRequest = Omit<NewSessionDraft, "revision" | "updatedAt"> & {
+    expectedRevision: number;
+};
 /** Input shape for agent config on create/update (server applies defaults). */
 type ScheduledTaskAgentConfigInput = {
     prompt: string;
@@ -2022,6 +2144,7 @@ type ScheduledTaskAgentConfigInput = {
     reasoningEffort?: ReasoningEffort | undefined;
     sandboxBackend?: SandboxBackend | undefined;
     goal?: GoalSpec | undefined;
+    maxNestedAgentDepth?: number | undefined;
 };
 type CreateScheduledTaskRequest = {
     name: string;
@@ -2300,6 +2423,16 @@ type UploadFileInput = {
 type DocumentStatus = "queued" | "indexing" | "ready" | "failed";
 type KnowledgeSourceKind = "manual_upload" | "meeting_transcript" | "repository" | "email" | "chat" | "document" | "web" | "other";
 type DocumentSearchMode = "hybrid" | "vector" | "keyword";
+type DocumentVisibility = "workspace" | "private";
+type DocumentCurationStatus = "none" | "pending" | "suggested" | "auto_filed" | "failed";
+type DocumentCuration = {
+    suggestedBaseId: string | null;
+    suggestedBaseName: string | null;
+    confidence: number;
+    reason: string | null;
+    originalTitle: string | null;
+    model: string | null;
+};
 type DocumentBase = {
     id: string;
     workspaceId: string;
@@ -2327,6 +2460,13 @@ type Document = {
     sourceUpdatedAt: string | null;
     sourceVersion: string | null;
     aclTags: string[];
+    visibility: DocumentVisibility;
+    createdBy: string | null;
+    agentAccess: boolean;
+    summary: string | null;
+    topics: string[];
+    curationStatus: DocumentCurationStatus;
+    curation: DocumentCuration | null;
     createdAt: string;
     updatedAt: string;
 };
@@ -2370,6 +2510,19 @@ type AddDocumentRequest = {
     sourceUpdatedAt?: string | undefined;
     sourceVersion?: string | undefined;
     aclTags?: string[] | undefined;
+    visibility?: DocumentVisibility | undefined;
+    agentAccess?: boolean | undefined;
+};
+type CreateKnowledgeDropRequest = {
+    text?: string | undefined;
+    fileId?: string | undefined;
+    filename?: string | undefined;
+    title?: string | undefined;
+    visibility?: DocumentVisibility | undefined;
+    agentAccess?: boolean | undefined;
+};
+type MoveDocumentRequest = {
+    targetBaseId?: string | undefined;
 };
 type DocumentSearchRequest = {
     query: string;
@@ -2721,10 +2874,14 @@ type GitHubRepository = {
     accountType: string | null;
 };
 type GitHubRepositoryScope = "all" | "selected";
+type GitHubBindingStatus = "disabled" | "unbound" | "bound";
+type GitHubInstallationLifecycle = "active" | "suspended" | "deleted" | "unverified";
 type GitHubInstallationBinding = {
     installationId: number;
+    githubAccountId: number | null;
     accountLogin: string | null;
     accountType: string | null;
+    lifecycle: GitHubInstallationLifecycle;
     repositoryScope: GitHubRepositoryScope;
     repositoryCount: number;
     createdAt: string;
@@ -2732,12 +2889,14 @@ type GitHubInstallationBinding = {
 };
 type GitHubAppInfo = {
     configured: boolean;
+    /** Truthful workspace binding state; server App credentials alone are not a binding. */
+    status: GitHubBindingStatus;
     appId: string | null;
     clientId: string | null;
     appSlug: string | null;
-    /** Reserved compatibility field; null while new installation binding is disabled. */
+    /** Fresh GitHub-controlled installation/configuration consent entry point. */
     installUrl: string | null;
-    /** Reserved compatibility field; null while new installation binding is disabled. */
+    /** Compatibility alias for installUrl; no repository-admin chooser is exposed. */
     linkUrl: string | null;
     /** Installation bindings owned independently by this workspace. */
     installations: GitHubInstallationBinding[];
@@ -2875,6 +3034,9 @@ type MachineView = {
     state: MachineState;
     active: boolean;
     isSessionGroup: boolean;
+    workspaceGeneration: number | null;
+    archiveGeneration: number | null;
+    archiveComplete: boolean;
     os: string;
     arch: string;
     hasDisplay: boolean;
@@ -2913,7 +3075,7 @@ type SwapActiveSandboxResponse = {
     activeSandboxId: string | null;
     activeEpoch: number;
     reason?: string;
-    code?: "stale_pointer" | "offline_enrollment" | "unsupported_backend_context" | "transient_establishment" | "concurrent_swap";
+    code?: "stale_pointer" | "offline_enrollment" | "unsupported_backend_context" | "transient_establishment" | "concurrent_swap" | "recovery_in_progress" | "recovery_degraded" | "recovery_unrecoverable";
 };
 /** Mirror of `@opengeni/contracts` EnrollmentOs. */
 type EnrollmentOs = "linux" | "macos" | "windows";
@@ -3107,8 +3269,12 @@ declare class OpenGeniClient {
     private readonly fetchImpl;
     constructor(options: OpenGeniClientOptions);
     createSession(workspaceId: string, request: CreateSessionRequest): Promise<CreateSessionResponse>;
+    getNewSessionDraft(workspaceId: string): Promise<NewSessionDraft>;
+    saveNewSessionDraft(workspaceId: string, request: SaveNewSessionDraftRequest): Promise<NewSessionDraft>;
     getSession(workspaceId: string, sessionId: string): Promise<Session>;
     updateSession(workspaceId: string, sessionId: string, request: UpdateSessionRequest): Promise<Session>;
+    /** Replace the durable tool policy or explicitly adopt workspace defaults. */
+    updateSessionToolPolicy(workspaceId: string, sessionId: string, request: UpdateSessionToolPolicyRequest): Promise<Session>;
     /**
      * Replace one attached MCP server's approval policy. The change is captured
      * by the next claimed attempt; already-claimed work keeps its immutable
@@ -3126,6 +3292,8 @@ declare class OpenGeniClient {
         parentSessionId?: string | null;
         cursor?: string;
         search?: string;
+        /** Return only the complete personal pinned projection. */
+        pinsOnly?: boolean;
     }): Promise<SessionListResponse>;
     /** Set this authenticated member's personal workspace pin for a session. */
     updateSessionPin(workspaceId: string, sessionId: string, request: UpdateSessionPinRequest): Promise<Session>;
@@ -3507,6 +3675,18 @@ declare class OpenGeniClient {
     /** Index an uploaded file into the base. The file must be `ready`. */
     addDocument(workspaceId: string, baseId: string, request: AddDocumentRequest): Promise<Document>;
     listDocuments(workspaceId: string, baseId: string): Promise<Document[]>;
+    /**
+     * Drop raw text or an already-uploaded file into the workspace's Default
+     * base. When curation is enabled, it may name, summarize, categorize, and
+     * (confidence permitting) file the document into the best-matching base;
+     * provider=none leaves caller metadata and Default placement unchanged.
+     */
+    createKnowledgeDrop(workspaceId: string, request: CreateKnowledgeDropRequest): Promise<Document>;
+    /**
+     * Move a document (and its indexed chunks) to another base. With no
+     * targetBaseId, applies the document's stored curation suggestion.
+     */
+    moveDocument(workspaceId: string, documentId: string, request?: MoveDocumentRequest): Promise<Document>;
     /** Retry indexing for a failed document. */
     reindexDocument(workspaceId: string, baseId: string, documentId: string): Promise<Document>;
     /**
@@ -3552,12 +3732,9 @@ declare class OpenGeniClient {
     startConnectionOAuth(workspaceId: string, request: OAuthStartRequest): Promise<OAuthStartResponse>;
     /** Public, immutably-cached URL for a catalog item's logo, or null when the item has none. */
     catalogAssetUrl(logoAssetPath: string | null): string | null;
-    /** GitHub App configuration status; install/link URLs are null while new binding is disabled. */
+    /** GitHub App server configuration plus truthful workspace binding status. */
     getGitHubApp(workspaceId: string): Promise<GitHubAppInfo>;
-    /**
-     * Compatibility URL for previously issued state. New installation binding is
-     * disabled, so the endpoint validates state and terminates with HTTP 410.
-     */
+    /** Build the GitHub owner-consent entry URL for fresh workspace-bound state. */
     githubConnectUrl(workspaceId: string, state: string): string;
     listGitHubRepositories(workspaceId: string): Promise<GitHubRepositoriesResponse>;
     /** Re-sync the installation's repository list from GitHub. */
@@ -3641,8 +3818,23 @@ declare class OpenGeniClient {
 /** Error for a non-2xx OpenGeni API response. */
 declare class OpenGeniApiError extends Error {
     readonly status: number;
+    readonly code: string | undefined;
+    readonly retryable: boolean;
+    readonly correlationId: string | undefined;
+    /** True only when an uncontrolled transport failed after a mutation may have been accepted. */
+    readonly outcomeUnknown: boolean;
     readonly body: string;
-    constructor(status: number, body: string);
+    constructor(status: number, body: string, options?: {
+        code?: string | undefined;
+        retryable?: boolean | undefined;
+        correlationId?: string | undefined;
+        outcomeUnknown?: boolean | undefined;
+        displayMessage?: string | undefined;
+        mutation?: boolean | undefined;
+    });
+}
+/** A short-lived session-list snapshot cursor can no longer be continued. */
+declare class OpenGeniSessionListCursorError extends OpenGeniApiError {
 }
 /** The browser bundle and API disagree about their state-changing wire contract. */
 declare class OpenGeniApiContractMismatchError extends Error {
@@ -3859,4 +4051,4 @@ declare function ttydInputFrame(data: string): string;
 /** Build a client→server RESIZE frame: "1" + JSON.stringify({ columns, rows }). */
 declare function ttydResizeFrame(columns: number, rows: number): string;
 
-export { type AccessContext, type AccessGrant, type AccountGrant, type AccountRole, type AcknowledgeStreamRequest, type AcknowledgeStreamResponse, type AddDocumentRequest, type AddWorkspaceMemberRequest, type AgentMessageCompletedPayload, type AgentTextDeltaPayload, type AgentToolCallCreatedPayload, type AgentToolCallOutputPayload, type ApiKey, type AttachViewerRequest, type AttachViewerResponse, type BillingBalance, type BillingEntitlementsResponse, type BillingMode, type BillingSummary, type BillingUsageResponse, type CapabilityCatalogItem, type CapabilityCatalogResponse, type CapabilityInstallation, type CapabilityInstallationStatus, type CapabilityKind, type CapabilityPack, type CapabilityPackConnector, type CapabilityPackConnectorAuthModel, type CapabilityPackKnowledge, type CapabilityPackScheduledTaskTemplate, type CapabilityPackSkill, type CapabilityPackSkillFile, type CapabilityPackVariableSetSpec, type CapabilityRuntime, type CapabilitySource, type CapabilityUnavailableReason, type ClientAuthConfig, type ClientConfig, type ClientModel, type ClientSessionEventInput, type CodexAccount, type CodexAccountOverview, type CodexAccountSwitchedPayload, type CodexAccountsResponse, type CodexAllocatorUpdate, type CodexConnectPoll, type CodexConnectStart, type CodexConnectionStatus, type CodexOverviewResponse, type CodexResetCredit, type CodexResetRedemptionRecovery, type CodexRotationSettings, type CodexUsage, type CodexUsageMap, type CodexUsagePayload, type CodexUsageWindow, type CompactSessionContextResult, type CompleteFileUploadResponse, type ComposerDraft, type ComputerUseCapability, type ConnectionKind, type ConnectionMetadata, type ConnectionResponse, type ConnectionStatus, type CreateApiKeyRequest, type CreateApiKeyResponse, type CreateCapabilityCatalogItemRequest, type CreateCheckoutRequest, type CreateCheckoutResponse, type CreateConnectionRequest, type CreateDocumentBaseRequest, type CreateFileUploadRequest, type CreateFileUploadResponse, type CreateGitHubAppManifestRequest, type CreateGitHubAppManifestResponse, type CreateKnowledgeMemoryRequest, type CreateRigRequest, type CreateScheduledTaskRequest, type CreateSessionRequest, type CreateVariableSetRequest, type CreateWorkspaceEnvironmentRequest, type CreateWorkspaceRequest, DEFAULT_WORKSPACE_TRANSCRIPTION_POLICY, type DeleteSessionQueueItemRequest, type DesktopConnectionState, type DesktopRfbFactory, type DesktopRfbLike, type DesktopStreamCapability, type DesktopStreamEvent, type DeviceEnrollmentApproveRequest, type DeviceEnrollmentApproveResponse, type DeviceEnrollmentDenyRequest, type DeviceEnrollmentDenyResponse, type DeviceEnrollmentLookupMachine, type DeviceEnrollmentLookupRequest, type DeviceEnrollmentLookupResponse, type DiscoverMcpCapabilitiesResponse, type Document, type DocumentBase, type DocumentSearchMode, type DocumentSearchRequest, type DocumentSearchResponse, type DocumentSearchResult, type DocumentStatus, type EditSessionQueueItemRequest, type EffectiveControlBlocker, type EffectiveControlResumeOption, type EffectiveSessionControl, type EnableCapabilityRequest, type EnablePackRequest, type EnrollTokenExchangeRequest, type EnrollTokenExchangeResponse, type EnrollmentCredentials, type EnrollmentOs, type EntitlementValue, type Entitlements, type EntitlementsMode, type FetchLike, type FileAsset, type FileDownloadUrlResponse, type FileResourceRef, type FileStatus, type FileSystemCapability, type FileUploadData, type FsChangeKind, type FsChangedPayload, type FsDeleteRequest, type FsDeleteResponse, type FsEncoding, type FsListRequest, type FsListResponse, type FsMkdirRequest, type FsMkdirResponse, type FsMoveRequest, type FsMoveResponse, type FsNodeType, type FsReadRequest, type FsReadResponse, type FsTreeNode, type FsWriteRequest, type FsWriteResponse, type GetPackResponse, type GetWorkspaceCaptureFileResponse, type GetWorkspaceCaptureResponse, type GitCapability, type GitChangedPayload, type GitCommit, type GitCredentialBindingId, type GitCredentialProvider, type GitDiffHunk, type GitDiffLine, type GitDiffLineType, type GitDiffRequest, type GitDiffResponse, type GitFileDiff, type GitFileStatus, type GitFileStatusCode, type GitHubAppInfo, type GitHubInstallationBinding, type GitHubRepositoriesResponse, type GitHubRepository, type GitHubRepositoryScope, type GitLogRequest, type GitLogResponse, type GitRepositoryAccess, type GitShowRequest, type GitShowResponse, type GitStatusRequest, type GitStatusResponse, type GoalSpec, type HumanInputAnswer, type HumanInputOption, type HumanInputQuestion, type HumanInputQuestionKind, type HumanInputResponse, type IntegrationClientMetadata, KNOWN_PERMISSIONS, KNOWN_USAGE_EVENT_TYPES, type KnowledgeMemory, type KnowledgeMemoryKind, type KnowledgeMemorySearchRequest, type KnowledgeMemoryStatus, type KnowledgeSourceKind, type KnowledgeSourceRef, type KnownPermission, type KnownSessionEventType, type KnownUsageEventType, type LineageNode, type ListApiKeysResponse, type ListConnectionsResponse, type ListPacksResponse, type ListWorkspaceMembersResponse, type MachineKind, type MachineMetricsSeriesResponse, type MachineState, type MachineView, type MachinesResponse, type McpServerConnectionRef, type MetricSample, type MintEnrollTokenRequest, type MintEnrollTokenResponse, type ModelAvailabilityV1, type ModelBillingAttributionV1, type ModelCapabilitiesV1, type ModelCapabilityStateV1, type ModelCapabilitySupportV1, type ModelCredentialReadinessV1, type ModelCredentialSourceV1, type ModelPricingScheduleV1, type ModelPricingV1, type MoveSessionQueueItemRequest, type OAuthStartRequest, type OAuthStartResponse, OPENGENI_API_CONTRACT_HEADER, OPENGENI_API_CONTRACT_REVISION, OpenGeniApiContractMismatchError, OpenGeniApiError, OpenGeniClient, type OpenGeniClientOptions, type OpenGeniRequestOptions, OpenGeniStreamError, type PackInstallation, type PackInstallationStatus, type Permission, type ProductAccessMode, type ProposeRigChangeRequest, type ProxySessionEventStreamOptions, type PtyCloseRequest, type PtyOpenRequest, type PtyOpenResponse, type PtyResizeRequest, type PtyWriteRequest, RETAINED_OUTPUT_DEFAULT_PAGE_BYTES, RETAINED_OUTPUT_MAX_PAGE_BYTES, type ReasoningEffort, type RecordingAvailablePayload, type RecordingCapability, type RecordingCodec, type RecordingContentType, type RecordingFailedPayload, type RecordingFailedReason, type RecordingMode, type RecordingStartedPayload, type RegisterCapabilityPackRequest, type RepositoryResourceRef, type ResourceRef, type RetainedArtifactContent, type RetainedArtifactContentOptions, type RetainedArtifactMetadata, type RetainedArtifactReference, type RetainedArtifactUnavailable, type RetainedOutputKind, type RetainedOutputUnavailableReason, type Rig, type RigChange, type RigChangeKind, type RigChangeStatus, type RigChangeVerification, type RigCheck, type RigCheckResult, type RigDefinitionEditPayload, type RigSetupAppendPayload, type RigVersion, SESSION_EVENT_TYPES, type SandboxBackend, type SandboxCapabilityName, type SandboxCommandOutputDeltaPayload, type SandboxOs, type SaveComposerDraftRequest, type ScheduledTask, type ScheduledTaskAgentConfig, type ScheduledTaskAgentConfigInput, type ScheduledTaskDayOfWeek, type ScheduledTaskOverlapPolicy, type ScheduledTaskRun, type ScheduledTaskRunMode, type ScheduledTaskRunStatus, type ScheduledTaskScheduleSpec, type ScheduledTaskStatus, type ScheduledTaskTriggerType, type SendMessageInput, type ServiceTurnInitiator, type ServiceTurnInitiatorContext, type Session, type SessionCapabilities, type SessionCommandReceipt, type SessionControlResponse, type SessionEffectiveToolPolicy, type SessionEvent, type SessionEventCompactResult, type SessionEventCompactResultOptions, type SessionEventLatestClass, type SessionEventListOptions, type SessionEventPage, type SessionEventPayloadMode, type SessionEventReadDirection, type SessionEventReadMode, type SessionEventResultMode, type SessionEventSemanticClass, type SessionEventStreamTransport, type SessionEventType, type SessionGoal, type SessionGoalCreatedBy, type SessionGoalStatus, type SessionHumanInputRequest, type SessionLineageResponse, type SessionListResponse, type SessionMcpApprovalPolicy, type SessionMcpCredentialUpdateInput, type SessionMcpServerInput, type SessionMcpServerMetadata, type SessionQueueMutationResponse, type SessionQueueSnapshot, type SessionStatus, type SessionStatusChangedPayload, type SessionStructuredCapabilities, type SessionSummary, type SessionSystemUpdate, type SessionSystemUpdateKind, type SessionSystemUpdateState, type SessionToolPolicy, type SessionTurn, type SessionTurnSource, type SessionTurnStatus, type SetWorkspaceEnvironmentVariableRequest, type SseMessage, type SseReStreamOptions, type SteerMessageResult, type SteerSessionQueueItemRequest, type StreamClosedPayload, type StreamConnectionState, type StreamOpenedPayload, type StreamRevokedPayload, type StreamSessionEventsOptions, type StreamUrlRotatedPayload, type SubmitHumanInputResponseRequest, type SwapActiveSandboxRequest, type SwapActiveSandboxResponse, TTYD_SUBPROTOCOL, type TerminalCapability, type TerminalExecRequest, type TerminalExecResponse, type TerminalPtyExitedPayload, type TerminalPtyOutputDeltaPayload, type TerminalPtyStartedPayload, type ToolAuthNeededPayload, type ToolRef, type TranscriptionAdapter, type TranscriptionAdapterDescriptor, type TranscriptionAdapterStartContext, type TranscriptionAuthorization, type TranscriptionCredentialMode, type TranscriptionDiagnostic, type TranscriptionErrorCode, type TranscriptionEvent, type TranscriptionEventListener, type TranscriptionLifecycleStatus, type TranscriptionPolicyBlockReason, type TranscriptionResultMetadata, type TranscriptionSession, type TranscriptionSessionRequest, type TranscriptionSpeaker, type TranscriptionTargetSelection, type TranscriptionTimeSpan, type TranscriptionWord, TtydClientCommand, TtydServerCommand, type TurnInitiator, type UpdateConnectionRequest, type UpdateKnowledgeMemoryRequest, type UpdateRigRequest, type UpdateScheduledTaskRequest, type UpdateSessionGoalRequest, type UpdateSessionMcpApprovalPolicyRequest, type UpdateSessionMcpApprovalPolicyResponse, type UpdateSessionPinRequest, type UpdateSessionRequest, type UpdateVariableSetRequest, type UpdateWorkspaceEnvironmentRequest, type UpdateWorkspaceMemberRequest, type UpdateWorkspaceRequest, type UpdateWorkspaceSettingsRequest, type UploadFileInput, type UsageEvent, type UsageEventType, type UserApprovalDecisionEventInput, type UserHumanInputResponseEventInput, type UserMessageEventInput, type VariableSet, type VariableSetVariableMetadata, type ViewerHeartbeatRequest, type ViewerHeartbeatResponse, type ViewerHolder, type Workspace, type WorkspaceCaptureDegradedReason, type WorkspaceCaptureFile, type WorkspaceCaptureManifest, type WorkspaceCaptureRepo, type WorkspaceCaptureSignedUrl, type WorkspaceCaptureStats, type WorkspaceControlEvent, type WorkspaceControlEventPage, type WorkspaceControlStreamTransport, type WorkspaceEnvironment, type WorkspaceEnvironmentVariableMetadata, type WorkspaceInferenceControlResponse, type WorkspaceMember, type WorkspaceMemorySearchMode, type WorkspaceMemorySearchRequest, type WorkspaceMemorySearchResponse, type WorkspaceMemorySearchResult, type WorkspaceModelCatalogModel, type WorkspaceModelCatalogResponse, type WorkspaceRegisteredPack, type WorkspaceRevisionCapturedPayload, type WorkspaceRevisionDegradedPayload, type WorkspaceSettings, type WorkspaceTranscriptionPolicy, type WorkspaceTranscriptionTarget, applyUrlRotation, authorizeTranscriptionAdapter, createTranscriptionSessionRequest, desktopSocketUrl, formatSseEvent, isRetryableStreamError, nextDesktopState, parseSseStream, proxySessionEventStream, resolveWorkspaceTranscriptionPolicy, resumeSequenceFromRequest, sessionEventsToSseResponse, sessionEventsToSseStream, streamSessionEvents, streamWorkspaceControlEvents, terminalSocketUrl, ttydAuthFrame, ttydInputFrame, ttydResizeFrame };
+export { type AccessContext, type AccessGrant, type AccountGrant, type AccountRole, type AcknowledgeStreamRequest, type AcknowledgeStreamResponse, type AddDocumentRequest, type AddWorkspaceMemberRequest, type AgentMessageCompletedPayload, type AgentTextDeltaPayload, type AgentToolCallCreatedPayload, type AgentToolCallOutputPayload, type ApiKey, type AttachViewerRequest, type AttachViewerResponse, type BillingBalance, type BillingEntitlementsResponse, type BillingMode, type BillingSummary, type BillingUsageResponse, type CapabilityCatalogItem, type CapabilityCatalogResponse, type CapabilityInstallation, type CapabilityInstallationStatus, type CapabilityKind, type CapabilityPack, type CapabilityPackConnector, type CapabilityPackConnectorAuthModel, type CapabilityPackKnowledge, type CapabilityPackScheduledTaskTemplate, type CapabilityPackSkill, type CapabilityPackSkillFile, type CapabilityPackVariableSetSpec, type CapabilityRuntime, type CapabilitySource, type CapabilityUnavailableReason, type ClientAuthConfig, type ClientConfig, type ClientModel, type ClientSessionEventInput, type CodexAccount, type CodexAccountOverview, type CodexAccountSwitchedPayload, type CodexAccountsResponse, type CodexAllocatorUpdate, type CodexConnectPoll, type CodexConnectStart, type CodexConnectionStatus, type CodexFleetCacheState, type CodexFleetConfidence, type CodexFleetDecisionEventPayload, type CodexFleetDecisionScore, type CodexFleetShadowComparison, type CodexOverviewResponse, type CodexResetCredit, type CodexResetRedemptionRecovery, type CodexRotationSettings, type CodexUsage, type CodexUsageMap, type CodexUsagePayload, type CodexUsageWindow, type CompactSessionContextResult, type CompleteFileUploadResponse, type ComposerDraft, type ComputerUseCapability, type ConnectionKind, type ConnectionMetadata, type ConnectionResponse, type ConnectionStatus, type CreateApiKeyRequest, type CreateApiKeyResponse, type CreateCapabilityCatalogItemRequest, type CreateCheckoutRequest, type CreateCheckoutResponse, type CreateConnectionRequest, type CreateDocumentBaseRequest, type CreateFileUploadRequest, type CreateFileUploadResponse, type CreateGitHubAppManifestRequest, type CreateGitHubAppManifestResponse, type CreateKnowledgeDropRequest, type CreateKnowledgeMemoryRequest, type CreateRigRequest, type CreateScheduledTaskRequest, type CreateSessionRequest, type CreateVariableSetRequest, type CreateWorkspaceEnvironmentRequest, type CreateWorkspaceRequest, DEFAULT_WORKSPACE_TRANSCRIPTION_POLICY, type DeleteSessionQueueItemRequest, type DesktopConnectionState, type DesktopRfbFactory, type DesktopRfbLike, type DesktopStreamCapability, type DesktopStreamEvent, type DeviceEnrollmentApproveRequest, type DeviceEnrollmentApproveResponse, type DeviceEnrollmentDenyRequest, type DeviceEnrollmentDenyResponse, type DeviceEnrollmentLookupMachine, type DeviceEnrollmentLookupRequest, type DeviceEnrollmentLookupResponse, type DiscoverMcpCapabilitiesResponse, type Document, type DocumentBase, type DocumentCuration, type DocumentCurationStatus, type DocumentSearchMode, type DocumentSearchRequest, type DocumentSearchResponse, type DocumentSearchResult, type DocumentStatus, type DocumentVisibility, type EditSessionQueueItemRequest, type EffectiveControlBlocker, type EffectiveControlResumeOption, type EffectiveSessionControl, type EnableCapabilityRequest, type EnablePackRequest, type EnrollTokenExchangeRequest, type EnrollTokenExchangeResponse, type EnrollmentCredentials, type EnrollmentOs, type EntitlementValue, type Entitlements, type EntitlementsMode, type FetchLike, type FileAsset, type FileDownloadUrlResponse, type FileResourceRef, type FileStatus, type FileSystemCapability, type FileUploadData, type FsChangeKind, type FsChangedPayload, type FsDeleteRequest, type FsDeleteResponse, type FsEncoding, type FsListRequest, type FsListResponse, type FsMkdirRequest, type FsMkdirResponse, type FsMoveRequest, type FsMoveResponse, type FsNodeType, type FsReadRequest, type FsReadResponse, type FsTreeNode, type FsWriteRequest, type FsWriteResponse, type GetPackResponse, type GetWorkspaceCaptureFileResponse, type GetWorkspaceCaptureResponse, type GitCapability, type GitChangedPayload, type GitCommit, type GitCredentialBindingId, type GitCredentialProvider, type GitDiffHunk, type GitDiffLine, type GitDiffLineType, type GitDiffRequest, type GitDiffResponse, type GitFileDiff, type GitFileStatus, type GitFileStatusCode, type GitHubAppInfo, type GitHubBindingStatus, type GitHubInstallationBinding, type GitHubInstallationLifecycle, type GitHubRepositoriesResponse, type GitHubRepository, type GitHubRepositoryScope, type GitLogRequest, type GitLogResponse, type GitRepositoryAccess, type GitShowRequest, type GitShowResponse, type GitStatusRequest, type GitStatusResponse, type GoalSpec, type HumanInputAnswer, type HumanInputOption, type HumanInputQuestion, type HumanInputQuestionKind, type HumanInputResponse, type IntegrationClientMetadata, KNOWN_PERMISSIONS, KNOWN_USAGE_EVENT_TYPES, type KnowledgeMemory, type KnowledgeMemoryKind, type KnowledgeMemorySearchRequest, type KnowledgeMemoryStatus, type KnowledgeSourceKind, type KnowledgeSourceRef, type KnownPermission, type KnownSessionEventType, type KnownUsageEventType, type LineageNode, type ListApiKeysResponse, type ListConnectionsResponse, type ListPacksResponse, type ListWorkspaceMembersResponse, type MachineKind, type MachineMetricsSeriesResponse, type MachineState, type MachineView, type MachinesResponse, type McpServerConnectionRef, type MetricSample, type MintEnrollTokenRequest, type MintEnrollTokenResponse, type ModelAvailabilityV1, type ModelBillingAttributionV1, type ModelCapabilitiesV1, type ModelCapabilityStateV1, type ModelCapabilitySupportV1, type ModelCredentialReadinessV1, type ModelCredentialSourceV1, type ModelPricingScheduleV1, type ModelPricingV1, type MoveDocumentRequest, type MoveSessionQueueItemRequest, type NewSessionDraft, type NewSessionDraftOptions, type OAuthStartRequest, type OAuthStartResponse, OPENGENI_API_CONTRACT_HEADER, OPENGENI_API_CONTRACT_REVISION, OPENGENI_CORRELATION_HEADER, OpenGeniApiContractMismatchError, OpenGeniApiError, OpenGeniClient, type OpenGeniClientOptions, type OpenGeniRequestOptions, OpenGeniSessionListCursorError, OpenGeniStreamError, type PackInstallation, type PackInstallationStatus, type Permission, type ProductAccessMode, type ProposeRigChangeRequest, type ProxySessionEventStreamOptions, type PtyCloseRequest, type PtyOpenRequest, type PtyOpenResponse, type PtyResizeRequest, type PtyWriteRequest, RETAINED_OUTPUT_DEFAULT_PAGE_BYTES, RETAINED_OUTPUT_MAX_PAGE_BYTES, type ReasoningEffort, type RecordingAvailablePayload, type RecordingCapability, type RecordingCodec, type RecordingContentType, type RecordingFailedPayload, type RecordingFailedReason, type RecordingMode, type RecordingStartedPayload, type RegisterCapabilityPackRequest, type RepositoryResourceRef, type ResourceRef, type RetainedArtifactContent, type RetainedArtifactContentOptions, type RetainedArtifactMetadata, type RetainedArtifactReference, type RetainedArtifactUnavailable, type RetainedOutputKind, type RetainedOutputUnavailableReason, type Rig, type RigChange, type RigChangeKind, type RigChangeStatus, type RigChangeVerification, type RigCheck, type RigCheckResult, type RigDefinitionEditPayload, type RigSetupAppendPayload, type RigVersion, SESSION_EVENT_TYPES, type SandboxBackend, type SandboxCapabilityName, type SandboxCommandOutputDeltaPayload, type SandboxOs, type SaveComposerDraftRequest, type SaveNewSessionDraftRequest, type ScheduledTask, type ScheduledTaskAgentConfig, type ScheduledTaskAgentConfigInput, type ScheduledTaskDayOfWeek, type ScheduledTaskOverlapPolicy, type ScheduledTaskRun, type ScheduledTaskRunMode, type ScheduledTaskRunStatus, type ScheduledTaskScheduleSpec, type ScheduledTaskStatus, type ScheduledTaskTriggerType, type SendMessageInput, type ServiceTurnInitiator, type ServiceTurnInitiatorContext, type Session, type SessionCapabilities, type SessionCommandReceipt, type SessionControlResponse, type SessionEffectiveToolPolicy, type SessionEvent, type SessionEventCompactResult, type SessionEventCompactResultOptions, type SessionEventLatestClass, type SessionEventListOptions, type SessionEventPage, type SessionEventPayloadMode, type SessionEventReadDirection, type SessionEventReadMode, type SessionEventResultMode, type SessionEventSemanticClass, type SessionEventStreamTransport, type SessionEventType, type SessionGoal, type SessionGoalCreatedBy, type SessionGoalStatus, type SessionHumanInputRequest, type SessionLineageResponse, type SessionListResponse, type SessionMcpApprovalPolicy, type SessionMcpCredentialUpdateInput, type SessionMcpServerInput, type SessionMcpServerMetadata, type SessionQueueMutationResponse, type SessionQueueSnapshot, type SessionStatus, type SessionStatusChangedPayload, type SessionStructuredCapabilities, type SessionSummary, type SessionSystemUpdate, type SessionSystemUpdateKind, type SessionSystemUpdateState, type SessionToolPolicy, type SessionTurn, type SessionTurnSource, type SessionTurnStatus, type SetWorkspaceEnvironmentVariableRequest, type SseMessage, type SseReStreamOptions, type SteerMessageResult, type SteerSessionQueueItemRequest, type StreamClosedPayload, type StreamConnectionState, type StreamOpenedPayload, type StreamRevokedPayload, type StreamSessionEventsOptions, type StreamUrlRotatedPayload, type SubmitHumanInputResponseRequest, type SwapActiveSandboxRequest, type SwapActiveSandboxResponse, TTYD_SUBPROTOCOL, type TerminalCapability, type TerminalExecRequest, type TerminalExecResponse, type TerminalPtyExitedPayload, type TerminalPtyOutputDeltaPayload, type TerminalPtyStartedPayload, type ToolAuthNeededPayload, type ToolRef, type TranscriptionAdapter, type TranscriptionAdapterDescriptor, type TranscriptionAdapterStartContext, type TranscriptionAuthorization, type TranscriptionCredentialMode, type TranscriptionDiagnostic, type TranscriptionErrorCode, type TranscriptionEvent, type TranscriptionEventListener, type TranscriptionLifecycleStatus, type TranscriptionPolicyBlockReason, type TranscriptionResultMetadata, type TranscriptionSession, type TranscriptionSessionRequest, type TranscriptionSpeaker, type TranscriptionTargetSelection, type TranscriptionTimeSpan, type TranscriptionWord, TtydClientCommand, TtydServerCommand, type TurnInitiator, type UpdateConnectionRequest, type UpdateKnowledgeMemoryRequest, type UpdateRigRequest, type UpdateScheduledTaskRequest, type UpdateSessionGoalRequest, type UpdateSessionMcpApprovalPolicyRequest, type UpdateSessionMcpApprovalPolicyResponse, type UpdateSessionPinRequest, type UpdateSessionRequest, type UpdateSessionToolPolicyRequest, type UpdateVariableSetRequest, type UpdateWorkspaceEnvironmentRequest, type UpdateWorkspaceMemberRequest, type UpdateWorkspaceRequest, type UpdateWorkspaceSettingsRequest, type UploadFileInput, type UsageEvent, type UsageEventType, type UserApprovalDecisionEventInput, type UserHumanInputResponseEventInput, type UserMessageEventInput, type VariableSet, type VariableSetVariableMetadata, type ViewerHeartbeatRequest, type ViewerHeartbeatResponse, type ViewerHolder, type Workspace, type WorkspaceCaptureDegradedReason, type WorkspaceCaptureFile, type WorkspaceCaptureManifest, type WorkspaceCaptureRepo, type WorkspaceCaptureSignedUrl, type WorkspaceCaptureStats, type WorkspaceControlEvent, type WorkspaceControlEventPage, type WorkspaceControlStreamTransport, type WorkspaceEnvironment, type WorkspaceEnvironmentVariableMetadata, type WorkspaceInferenceControlResponse, type WorkspaceMember, type WorkspaceMemorySearchMode, type WorkspaceMemorySearchRequest, type WorkspaceMemorySearchResponse, type WorkspaceMemorySearchResult, type WorkspaceModelCatalogModel, type WorkspaceModelCatalogResponse, type WorkspaceRegisteredPack, type WorkspaceRevisionCapturedPayload, type WorkspaceRevisionDegradedPayload, type WorkspaceSettings, type WorkspaceTranscriptionPolicy, type WorkspaceTranscriptionTarget, applyUrlRotation, authorizeTranscriptionAdapter, createTranscriptionSessionRequest, desktopSocketUrl, formatSseEvent, isRetryableStreamError, nextDesktopState, parseSseStream, proxySessionEventStream, resolveWorkspaceTranscriptionPolicy, resumeSequenceFromRequest, sessionEventsToSseResponse, sessionEventsToSseStream, streamSessionEvents, streamWorkspaceControlEvents, terminalSocketUrl, ttydAuthFrame, ttydInputFrame, ttydResizeFrame };