@opengeni/sdk 0.20.0 → 0.25.0

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;
 };
@@ -346,6 +352,33 @@ type ResourceRef = RepositoryResourceRef | FileResourceRef;
 type ToolRef = {
     kind: "mcp";
     id: string;
+    optional?: boolean | undefined;
+};
+type SessionToolPolicy = {
+    mode: "workspace_default" | "explicit" | "inherited" | "legacy";
+    inheritedFromSessionId: string | null;
+};
+type SessionEffectiveToolPolicy = {
+    mode: SessionToolPolicy["mode"];
+    inheritedFromSessionId: string | null;
+    selectedIds: string[];
+    effectiveIds: string[];
+    mandatoryIds: string[];
+    lazyRouter: {
+        state: "required" | "disabled";
+        deferredIds: string[];
+    };
+    configuredIds: string[];
+    droppedIds: string[];
+    counts: {
+        selected: number;
+        effective: number;
+        mandatory: number;
+        deferred: number;
+        configured: number;
+        dropped: number;
+    };
+    idsTruncated: boolean;
 };
 type GoalSpec = {
     text: string;
@@ -368,14 +401,23 @@ type SessionMcpCredentialUpdateInput = {
     id: string;
     headers: Record<string, string>;
 };
+type SessionMcpApprovalPolicy = boolean | string[];
 type SessionMcpServerMetadata = {
     id: string;
     name: string | null;
     url: string;
     headerNames: string[];
     credentialVersion: number;
+    requireApproval: SessionMcpApprovalPolicy;
     connectionRef: McpServerConnectionRef | null;
 };
+type UpdateSessionMcpApprovalPolicyRequest = {
+    requireApproval: SessionMcpApprovalPolicy;
+};
+type UpdateSessionMcpApprovalPolicyResponse = {
+    server: SessionMcpServerMetadata;
+    effectiveFrom: "next_attempt";
+};
 type ConnectionKind = "oauth2" | "api_key" | "app_install" | "delegated";
 type ConnectionStatus = "active" | "needs_reauth" | "revoked" | "error";
 type McpServerConnectionRef = {
@@ -486,6 +528,8 @@ type Session = {
     instructions: string | null;
     resources: ResourceRef[];
     tools: ToolRef[];
+    toolPolicy?: SessionToolPolicy | undefined;
+    effectiveToolPolicy?: SessionEffectiveToolPolicy | undefined;
     metadata: Record<string, unknown>;
     /** Frozen creator fact; later turns carry their own independent initiator. */
     createdBy: TurnInitiator;
@@ -504,6 +548,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;
@@ -577,6 +628,7 @@ type SessionTurn = {
     prompt: string;
     resources: ResourceRef[];
     tools: ToolRef[];
+    toolsProvided?: boolean | undefined;
     model: string;
     reasoningEffort: ReasoningEffort;
     sandboxBackend: SandboxBackend;
@@ -652,7 +704,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.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", "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", "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
@@ -677,9 +729,11 @@ type SessionEvent = {
     duplicateReason?: string | null | undefined;
 };
 type SessionEventSemanticClass = "control" | "terminal" | "failure" | "checkpoint" | "tool_receipt" | "provider_account";
+type SessionEventLatestClass = SessionEventSemanticClass | "receipt";
 type SessionEventPayloadMode = "none" | "summary" | "full";
 type SessionEventReadMode = "monitoring" | "forensic";
 type SessionEventReadDirection = "after" | "before";
+type SessionEventResultMode = "events" | "compact";
 type SessionEventListCommonOptions = {
     after?: number;
     before?: number;
@@ -688,6 +742,7 @@ type SessionEventListCommonOptions = {
     mode?: SessionEventReadMode;
     direction?: SessionEventReadDirection;
     payloadMode?: SessionEventPayloadMode;
+    resultMode?: "events";
 };
 type SessionEventListOptions = SessionEventListCommonOptions & ({
     latest?: never;
@@ -697,12 +752,62 @@ type SessionEventListOptions = SessionEventListCommonOptions & ({
     excludeClasses?: SessionEventSemanticClass[];
 } | {
     /** Exclusive lookup for the newest event in exactly this semantic class. */
-    latest: SessionEventSemanticClass;
+    latest: SessionEventLatestClass;
     includeTypes?: never;
     excludeTypes?: never;
     includeClasses?: never;
     excludeClasses?: never;
 });
+type SessionEventCompactResult = {
+    version: 1;
+    semanticClass: SessionEventSemanticClass;
+    source: {
+        id: string;
+        type: SessionEventType;
+        sequence: number;
+        occurredAt: string;
+        turnId: string | null;
+        turnGeneration: number | null;
+        turnAttemptId: string | null;
+        turnAssociation: SessionEvent["turnAssociation"];
+    };
+    id: string;
+    type: SessionEventType;
+    sequence: number;
+    occurredAt: string;
+    turnId: string | null;
+    turnGeneration: number | null;
+    turnAttemptId: string | null;
+    turnAssociation: SessionEvent["turnAssociation"];
+    coveredSequence: {
+        first: number;
+        last: number;
+    };
+    status: "completed" | "failed" | "cancelled" | "superseded" | "checkpoint" | "receipt" | "unknown";
+    text: string | null;
+    output: unknown;
+    result: unknown;
+    failure: {
+        error: string | null;
+        code: string | null;
+        retryable: boolean | null;
+        recovery: string | null;
+    } | null;
+    checkpoint: unknown;
+    receipt: unknown;
+    truncation: {
+        truncated: boolean;
+        fields: string[];
+        originalBytes: number | null;
+        deliveredBytes: number;
+    };
+};
+type SessionEventCompactResultOptions = {
+    latest: SessionEventLatestClass;
+    resultMode: "compact";
+    mode?: SessionEventReadMode;
+    payloadMode?: SessionEventPayloadMode;
+};
 type SessionEventPage = {
     events: SessionEvent[];
     mode: SessionEventReadMode;
@@ -756,6 +861,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";
@@ -831,7 +992,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 = {
@@ -1121,8 +1282,8 @@ type TerminalExecRequest = {
 type TerminalExecResponse = {
     stdout: string;
     stderr: string;
-    exitCode: number | null;
-    running: boolean;
+    exitCode: number;
+    running: false;
     wallTimeSeconds: number;
 };
 type PtyOpenRequest = {
@@ -1195,6 +1356,7 @@ type ScheduledTaskAgentConfig = {
     reasoningEffort?: ReasoningEffort | undefined;
     sandboxBackend?: SandboxBackend | undefined;
     goal?: GoalSpec | undefined;
+    maxNestedAgentDepth?: number | undefined;
 };
 type ScheduledTask = {
     id: string;
@@ -1237,6 +1399,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" | {
@@ -1251,6 +1415,65 @@ type KnownPermission = (typeof KNOWN_PERMISSIONS)[number];
  */
 type Permission = KnownPermission | (string & {});
 type ProductAccessMode = "local" | "configured" | "managed";
+type ModelCapabilitySupportV1 = "supported" | "unsupported" | "unknown";
+type ModelCapabilityStateV1 = {
+    upstream: ModelCapabilitySupportV1;
+    runnable: boolean;
+};
+type ModelCapabilitiesV1 = {
+    reasoning: ModelCapabilityStateV1 & {
+        efforts: ReasoningEffort[];
+        defaultEffort: ReasoningEffort | null;
+        required: boolean;
+    };
+    functionCalling: ModelCapabilityStateV1;
+    structuredOutput: ModelCapabilityStateV1;
+    hostedTools: {
+        webSearch: ModelCapabilityStateV1;
+        xSearch: ModelCapabilityStateV1;
+        codeExecution: ModelCapabilityStateV1;
+    };
+    inputModalities: Array<"text" | "image" | "audio">;
+    outputModalities: Array<"text" | "image" | "audio">;
+    transports: {
+        sse: ModelCapabilityStateV1;
+        responsesWebSocket: ModelCapabilityStateV1;
+        realtimeAudio: ModelCapabilityStateV1;
+    };
+    latencyModes: Array<{
+        id: "standard" | "priority" | "fast";
+        upstream: ModelCapabilitySupportV1;
+        runnable: boolean;
+        billingMultiplierBps?: number | undefined;
+    }>;
+};
+type ModelCredentialSourceV1 = {
+    kind: "deployment";
+    mechanism: "api_key" | "azure_ad_bearer";
+} | {
+    kind: "connected_subscription";
+    provider: "codex";
+} | {
+    kind: "workspace_connection";
+    mechanism: "api_key";
+};
+type ModelBillingAttributionV1 = {
+    upstreamPayer: "deployment" | "workspace" | "connected_subscription";
+    metering: "opengeni_credits" | "external";
+};
+type ModelPricingV1 = {
+    inputMicrosPerMillionTokens: number;
+    cachedInputMicrosPerMillionTokens?: number | undefined;
+    outputMicrosPerMillionTokens: number;
+    marginBps?: number | undefined;
+};
+type ModelPricingScheduleV1 = {
+    default: ModelPricingV1;
+    inputTokenTiers?: Array<{
+        minimumInputTokens: number;
+        pricing: ModelPricingV1;
+    }> | undefined;
+};
 /**
  * One model a client may select at send time, plus the provider that serves it.
  * The wire API (`responses` | `chat`) lets a client reason about provider
@@ -1265,6 +1488,42 @@ type ClientModel = {
     providerLabel: string;
     api: "responses" | "chat";
     contextWindowTokens?: number | undefined;
+    schemaVersion?: 1 | undefined;
+    aliases?: string[] | undefined;
+    deployment?: {
+        upstreamModelId: string;
+        wireApi: "responses" | "chat";
+    } | undefined;
+    executionLimits?: {
+        contextWindowTokens: number | null;
+        effectiveContextWindowTokens: number | null;
+        autoCompactTokenLimit: number | null;
+        toolOutputTruncationTokens: number | null;
+    } | undefined;
+    credentialSource?: ModelCredentialSourceV1 | undefined;
+    billing?: ModelBillingAttributionV1 | undefined;
+    capabilities?: ModelCapabilitiesV1 | undefined;
+    pricing?: ModelPricingScheduleV1 | undefined;
+    definitionVersion?: string | undefined;
+};
+type ModelAvailabilityV1 = {
+    status: "available" | "unavailable" | "degraded" | "unknown";
+    selectable: boolean;
+    reason: "missing_credential" | "needs_reauth" | "credential_not_ready" | "not_entitled" | "provider_unhealthy" | "policy_blocked" | "unsupported" | null;
+    checkedAt: string | null;
+};
+type ModelCredentialReadinessV1 = {
+    status: "ready" | "not_ready" | "error";
+    reason: "missing_credential" | "needs_reauth" | "prerequisites_missing" | "resolver_error" | "observation_stale" | null;
+    basis: "configuration" | "connection" | "resolver";
+    checkedAt: string | null;
+};
+type WorkspaceModelCatalogModel = ClientModel & {
+    credentialReadiness: ModelCredentialReadinessV1;
+    availability: ModelAvailabilityV1;
+};
+type WorkspaceModelCatalogResponse = {
+    models: WorkspaceModelCatalogModel[];
 };
 /**
  * Connection state of a workspace's Codex (ChatGPT) subscription, returned by
@@ -1313,6 +1572,11 @@ type CodexUsagePayload = {
     weekly: CodexUsageWindow | null;
     limitReached: boolean;
     fetchedAt: string;
+    /** Authoritative count-only summary from /wham/usage; never synthesized rows. */
+    rateLimitResetCredits?: {
+        availableCount: number;
+        credits: null;
+    } | null;
     /** Present only on an auth/refresh failure path. */
     reason?: "needs_relogin";
     additionalLimits?: Array<{
@@ -1344,6 +1608,73 @@ type CodexAccount = {
     weekly?: CodexUsageWindow | null;
     usageCheckedAt?: string | null;
     exhaustedUntil?: string | null;
+    /** Controls only NEW automatic allocations. */
+    allocatorEnabled: boolean;
+    /** Independent OCC sequence; credential/token `version` is never exposed. */
+    allocatorVersion: number;
+    allocatorUpdatedAt?: string | null;
+    /** Cached authoritative summary count, never detailed redemption authority. */
+    resetCreditAvailableCount?: number | null;
+    resetCreditsCheckedAt?: string | null;
+};
+type CodexResetCredit = {
+    id: string;
+    resetType: "codexRateLimits" | "unknown";
+    status: "available" | "redeeming" | "redeemed" | "unknown";
+    /** Unix seconds from the provider contract. */
+    grantedAt: number;
+    /** Unix seconds, or null when the provider reports no expiry. */
+    expiresAt: number | null;
+    title: string | null;
+    description: string | null;
+    /** True only for fresh, complete, owning-human provider detail. */
+    actionable: boolean;
+};
+/** Owning-human recovery metadata. It contains no token, browser-session hash, or provider key. */
+type CodexResetRedemptionRecovery = {
+    attemptId: string;
+    creditId: string;
+    status: "provider_started" | "completed";
+    outcome: "reset" | "nothingToReset" | "noCredit" | "alreadyRedeemed" | null;
+    providerStartedAt: string | null;
+    completedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+};
+type CodexAccountOverview = {
+    accountId: string;
+    usage: {
+        source: "provider" | "cache" | "none";
+        fetchedAt: string | null;
+        stale: boolean;
+        error: string | null;
+        value: CodexUsagePayload | null;
+    };
+    resetCredits: {
+        source: "provider" | "cache" | "none";
+        fetchedAt: string | null;
+        stale: boolean;
+        error: string | null;
+        detailState: "detailed" | "count_only" | "capped" | "unsupported" | "unknown" | "error";
+        detailsComplete: boolean;
+        availableCount: number | null;
+        credits: CodexResetCredit[];
+    };
+    canRedeem: boolean;
+    /** Owning managed-cookie human may replay durable completion without a healthy provider token. */
+    canResumeRedemption: boolean;
+    /** Durable owner-scoped ambiguity/completion discovery; never redemption authority for agents. */
+    redemptions: CodexResetRedemptionRecovery[];
+};
+/** Independently settled live overview keyed by workspace credential id. */
+type CodexOverviewResponse = {
+    accounts: Record<string, CodexAccountOverview>;
+};
+type CodexAllocatorUpdate = {
+    allocatorEnabled: boolean;
+    allocatorVersion: number;
+    allocatorUpdatedAt: string | null;
+    changed: boolean;
 };
 /** Per-workspace Codex rotation/active settings. P1: rotation inert, only activeCredentialId loads. */
 type CodexRotationSettings = {
@@ -1492,11 +1823,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 = {
@@ -1562,6 +1895,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;
@@ -1579,6 +1922,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;
 };
@@ -1648,12 +1993,33 @@ type ComposerDraft = {
     text: string;
     resources: ResourceRef[];
     tools: ToolRef[];
+    /** False inherits the session policy; true preserves an explicit array. */
+    toolsProvided: boolean;
     model: string;
     reasoningEffort: ReasoningEffort;
     sourceTurnId: string | null;
     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[];
+    model: string;
+    reasoningEffort: ReasoningEffort;
+    options: NewSessionDraftOptions;
+    updatedAt: string | null;
+};
 type SessionQueueSnapshot = {
     version: number;
     effectiveControl: EffectiveSessionControl;
@@ -1751,6 +2117,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;
@@ -1761,6 +2130,7 @@ type ScheduledTaskAgentConfigInput = {
     reasoningEffort?: ReasoningEffort | undefined;
     sandboxBackend?: SandboxBackend | undefined;
     goal?: GoalSpec | undefined;
+    maxNestedAgentDepth?: number | undefined;
 };
 type CreateScheduledTaskRequest = {
     name: string;
@@ -1962,6 +2332,49 @@ type FileAsset = {
     createdAt: string;
     updatedAt: string;
 };
+/** Mirrors the closed, provider-neutral retained-output contract. */
+declare const RETAINED_OUTPUT_DEFAULT_PAGE_BYTES: number;
+declare const RETAINED_OUTPUT_MAX_PAGE_BYTES: number;
+type RetainedOutputKind = "tool_result" | "assistant_completion" | "internal_update" | "event_media" | "file";
+type RetainedOutputUnavailableReason = "not_retained" | "pending" | "failed" | "expired" | "deleted" | "missing_storage" | "storage_write_failed" | "unsupported";
+type RetainedArtifactReference = {
+    available: true;
+    artifactId: string;
+    kind: RetainedOutputKind;
+    contentType: string;
+    originalBytes: number;
+    sha256: string;
+    retainedAt: string;
+    retention: {
+        policy: "workspace_file";
+        expiresAt: null;
+    };
+    retrieval: {
+        method: "GET";
+        path: string;
+        acceptRanges: "bytes";
+        maxRangeBytes: number;
+    };
+};
+type RetainedArtifactUnavailable = {
+    available: false;
+    artifactId: string;
+    reason: RetainedOutputUnavailableReason;
+};
+type RetainedArtifactMetadata = RetainedArtifactReference | RetainedArtifactUnavailable;
+type RetainedArtifactContentOptions = {
+    /** One RFC-style bytes range, for example `bytes=1048576-2097151`. */
+    range?: string | undefined;
+    signal?: AbortSignal | undefined;
+};
+type RetainedArtifactContent = {
+    bytes: Uint8Array;
+    status: 200 | 206;
+    contentType: string;
+    contentLength: number;
+    contentRange: string | null;
+    acceptRanges: "bytes";
+};
 type CreateFileUploadRequest = {
     filename: string;
     contentType: string;
@@ -2304,6 +2717,11 @@ type CapabilityRuntime = {
     mcpServerId?: string | undefined;
     transport?: string | undefined;
     notes: string | null;
+    /** Secret-safe server-derived registry exposure state. */
+    catalogTrust?: {
+        state: "trusted" | "legacy_active" | "unverified";
+        reason: "trusted_source" | "verified_probe" | "active_installation_compatibility" | "missing_verification";
+    } | undefined;
 };
 type CapabilityCatalogItem = {
     id: string;
@@ -2566,6 +2984,9 @@ type MachineView = {
     state: MachineState;
     active: boolean;
     isSessionGroup: boolean;
+    workspaceGeneration: number | null;
+    archiveGeneration: number | null;
+    archiveComplete: boolean;
     os: string;
     arch: string;
     hasDisplay: boolean;
@@ -2604,7 +3025,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";
@@ -2798,8 +3219,16 @@ 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 one attached MCP server's approval policy. The change is captured
+     * by the next claimed attempt; already-claimed work keeps its immutable
+     * policy snapshot.
+     */
+    updateSessionMcpApprovalPolicy(workspaceId: string, sessionId: string, serverId: string, request: UpdateSessionMcpApprovalPolicyRequest): Promise<UpdateSessionMcpApprovalPolicyResponse>;
     listSessions(workspaceId: string, options?: {
         limit?: number;
         parentSessionId?: string | null;
@@ -2811,6 +3240,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>;
@@ -2888,7 +3319,15 @@ declare class OpenGeniClient {
      */
     listEvents(workspaceId: string, sessionId: string, options?: SessionEventListOptions): Promise<SessionEvent[]>;
     /** Bounded durable/monitoring page plus exact projection and cursor facts. */
+    listEventPage(workspaceId: string, sessionId: string, options: SessionEventCompactResultOptions): Promise<SessionEventCompactResult | null>;
     listEventPage(workspaceId: string, sessionId: string, options?: SessionEventListOptions): Promise<SessionEventPage>;
+    /**
+     * Fetch the authoritative newest-sequence semantic result directly. This is
+     * the callback-loss recovery path: it reads one compact durable result and
+     * never creates a model turn. `latest: "receipt"` aliases `tool_receipt`;
+     * turn generation remains scoped retry metadata.
+     */
+    getLatestEventResult(workspaceId: string, sessionId: string, options?: Omit<SessionEventCompactResultOptions, "resultMode">): Promise<SessionEventCompactResult | null>;
     /** POST a user/control event to the session. Returns the accepted event. */
     sendEvent(workspaceId: string, sessionId: string, event: ClientSessionEventInput): Promise<SessionEvent>;
     sendMessage(workspaceId: string, sessionId: string, message: string | SendMessageInput): Promise<SessionEvent>;
@@ -3061,6 +3500,8 @@ declare class OpenGeniClient {
      * knowledge of the host setup; safe to call before any auth is established.
      */
     getClientConfig(): Promise<ClientConfig>;
+    /** Authenticated model definitions plus workspace-specific selectability. */
+    getWorkspaceModelCatalog(workspaceId: string): Promise<WorkspaceModelCatalogResponse>;
     /** The caller's access context: subject, account + workspace grants, defaults. */
     getAccessContext(): Promise<AccessContext>;
     listWorkspaces(): Promise<Workspace[]>;
@@ -3167,6 +3608,13 @@ declare class OpenGeniClient {
      */
     uploadFile(workspaceId: string, input: UploadFileInput): Promise<FileAsset>;
     getFile(workspaceId: string, fileId: string): Promise<FileAsset>;
+    /** Read provider-neutral retained evidence metadata; never returns a storage location. */
+    getRetainedArtifact(workspaceId: string, artifactId: string): Promise<RetainedArtifactMetadata>;
+    /**
+     * Read at most one authenticated retained-evidence range from the API. This
+     * deliberately does not use the ordinary signed file-download URL.
+     */
+    getRetainedArtifactContent(workspaceId: string, artifactId: string, options?: RetainedArtifactContentOptions): Promise<RetainedArtifactContent>;
     /** Mint a short-lived signed download URL for a ready file. */
     createFileDownloadUrl(workspaceId: string, fileId: string): Promise<FileDownloadUrlResponse>;
     createDocumentBase(workspaceId: string, request: CreateDocumentBaseRequest): Promise<DocumentBase>;
@@ -3267,6 +3715,8 @@ declare class OpenGeniClient {
     refreshCodexUsage(workspaceId: string): Promise<{
         usage: CodexUsageMap;
     }>;
+    /** Live independently-settled quota + reset-credit overview for every account. */
+    codexOverview(workspaceId: string): Promise<CodexOverviewResponse>;
     /** Disconnect ALL accounts (legacy workspace-wide). Prefer `disconnectCodexAccount`. */
     codexDisconnect(workspaceId: string): Promise<{
         disconnected: boolean;
@@ -3283,6 +3733,11 @@ declare class OpenGeniClient {
         rotationEnabled?: boolean;
         rotationStrategy?: CodexRotationSettings["rotationStrategy"];
     }): Promise<CodexRotationSettings>;
+    /** Toggle only NEW automatic allocations under independent allocator OCC. */
+    setCodexAccountAllocator(workspaceId: string, accountId: string, input: {
+        enabled: boolean;
+        expectedVersion: number;
+    }): Promise<CodexAllocatorUpdate>;
     /** Disconnect ONE Codex account by id (re-picks active when the removed one was active). */
     disconnectCodexAccount(workspaceId: string, accountId: string): Promise<{
         disconnected: boolean;
@@ -3302,9 +3757,13 @@ declare class OpenGeniClient {
 /** Error for a non-2xx OpenGeni API response. */
 declare class OpenGeniApiError extends Error {
     readonly status: number;
+    readonly code: string | undefined;
     readonly body: string;
     constructor(status: number, body: string);
 }
+/** 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 {
     readonly expected: string;
@@ -3520,4 +3979,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 CodexAccountSwitchedPayload, type CodexAccountsResponse, type CodexConnectPoll, type CodexConnectStart, type CodexConnectionStatus, 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 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, 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 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 SessionEvent, type SessionEventListOptions, type SessionEventPage, type SessionEventPayloadMode, type SessionEventReadDirection, type SessionEventReadMode, type SessionEventSemanticClass, type SessionEventStreamTransport, type SessionEventType, type SessionGoal, type SessionGoalCreatedBy, type SessionGoalStatus, type SessionHumanInputRequest, type SessionLineageResponse, type SessionListResponse, 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 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 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 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 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 NewSessionDraft, type NewSessionDraftOptions, type OAuthStartRequest, type OAuthStartResponse, OPENGENI_API_CONTRACT_HEADER, OPENGENI_API_CONTRACT_REVISION, 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 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 };