@opengeni/sdk 3.3.2 → 3.7.0-canary.0

package/dist/types.d.ts

@@ -51,6 +51,74 @@ export type GatewayRealtimeConnectResponse = {
     instructions: string;
     replay: false;
 };
+export type ToolGatewayIdentity = {
+    serverId: string;
+    toolName: string;
+};
+export type ToolGatewayCatalogEntry = {
+    identity: ToolGatewayIdentity;
+    modelName: string;
+    codemodePath: string[];
+    title?: string | undefined;
+    description?: string | undefined;
+    inputSchema: Record<string, unknown>;
+    outputSchema?: Record<string, unknown> | undefined;
+    annotations?: Record<string, unknown> | undefined;
+    icons?: Array<Record<string, unknown>> | undefined;
+    source: "opengeni" | "files" | "docs" | "mcp" | "codex_apps" | "interaction";
+    approval: "none" | "human" | "policy";
+};
+export type ToolGatewayCatalog = {
+    version: 1;
+    accountId: string;
+    workspaceId: string;
+    generation: number;
+    digest: string;
+    createdAt: string;
+    entries: ToolGatewayCatalogEntry[];
+};
+export type ToolGatewayResult = {
+    content: Array<{
+        type: string;
+        [key: string]: unknown;
+    }>;
+    structuredContent?: Record<string, unknown> | undefined;
+    isError?: boolean | undefined;
+    _meta?: Record<string, unknown> | undefined;
+    [key: string]: unknown;
+};
+export type ToolGatewayCallRequest = {
+    operationId?: string | undefined;
+    catalogDigest: string;
+    identity: ToolGatewayIdentity;
+    arguments: Record<string, unknown>;
+    siteArtifactId?: string | undefined;
+    siteVersionId?: string | undefined;
+    approvalToken?: string | undefined;
+};
+export type ToolGatewayApprovalRequest = {
+    operationId: string;
+    catalogDigest: string;
+    identity: ToolGatewayIdentity;
+    arguments: Record<string, unknown>;
+};
+export type ToolGatewayApprovalResponse = {
+    operationId: string;
+    catalogDigest: string;
+    identity: ToolGatewayIdentity;
+    approvalToken: string;
+    expiresAt: string;
+};
+export type ToolGatewayCallResponse = {
+    operationId: string;
+    catalogDigest: string;
+    result: ToolGatewayResult;
+};
+export type ToolGatewayDeclarationsResponse = {
+    catalogDigest: string;
+    moduleSpecifier: string;
+    source: string;
+};
 export type ActivateCodexRealtimeConnectionRequest = {
     operationId: string;
     browserInstanceId: string;
@@ -442,6 +510,7 @@ export type McpConnectionAuthoritySelection = {
 };
 export type McpServerConnectionRef = {
     connectionId?: string | undefined;
+    authoritySource?: "host" | undefined;
     provider?: string | undefined;
     providerDomain: string;
     kind?: ConnectionKind | undefined;
@@ -494,6 +563,7 @@ export type CreateConnectionRequest = {
     grantedScopes?: string[] | undefined;
     expiresAt?: string | null | undefined;
     metadata?: Record<string, unknown> | undefined;
+    operationId?: string | undefined;
 };
 export type PersonalGitHubConnectionMetadata = {
     credentialRole: "opengeni_github_personal";
@@ -841,6 +911,8 @@ export type UpdateConnectionRequest = {
     grantedScopes?: string[] | undefined;
     expiresAt?: string | null | undefined;
     metadata?: Record<string, unknown> | undefined;
+    expectedVersion?: number | undefined;
+    operationId?: string | undefined;
 };
 export type ConnectionResponse = {
     connection: ConnectionMetadata;
@@ -1358,7 +1430,7 @@ export type SessionHumanInputRequest = {
     createdAt: string;
     updatedAt: string;
 };
-export declare const SESSION_EVENT_TYPES: readonly ["session.created", "session.variable_sets.updated", "session.runtime.configured", "session.event.envelope_omitted", "session.status.changed", "session.realtime.started", "session.realtime.ended", "session.requiresAction", "session.humanInput.requested", "session.context.compaction.requested", "session.context.compaction.started", "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", "turn.startup.phase.started", "turn.startup.phase.completed", "turn.startup.phase.failed", "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", "session.command.backgrounded", "session.command.finished", "sandbox.command.output.delta", "artifact.created", "goal.set", "goal.updated", "goal.progress", "goal.rewrite.proposed", "goal.rewrite.rejected", "goal.completed", "goal.paused", "goal.resumed", "goal.cleared", "goal.held", "goal.continuation", "system.update.pending", "system.update.delivered", "system.update.superseded", "system.update.cancelled", "system.update.settled", "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.visibility.changed", "session.personal_resources.attached", "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"];
+export declare const SESSION_EVENT_TYPES: readonly ["session.created", "session.variable_sets.updated", "session.runtime.configured", "session.event.envelope_omitted", "session.status.changed", "session.realtime.started", "session.realtime.ended", "session.requiresAction", "session.humanInput.requested", "session.context.compaction.requested", "session.context.compaction.started", "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", "turn.startup.phase.started", "turn.startup.phase.completed", "turn.startup.phase.failed", "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", "session.command.backgrounded", "session.command.finished", "session.wait.started", "session.wait.finished", "sandbox.command.output.delta", "artifact.created", "goal.set", "goal.updated", "goal.progress", "goal.rewrite.proposed", "goal.rewrite.rejected", "goal.completed", "goal.paused", "goal.resumed", "goal.cleared", "goal.held", "goal.continuation", "system.update.pending", "system.update.delivered", "system.update.superseded", "system.update.cancelled", "system.update.settled", "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.visibility.changed", "session.personal_resources.attached", "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"];
 export type KnownSessionEventType = (typeof SESSION_EVENT_TYPES)[number];
 /**
  * Event types the SDK knows about today, kept open so a newer OpenGeni server
@@ -1371,6 +1443,8 @@ export type SessionEvent = {
     sessionId: string;
     /** Per-session sequence number: positive, contiguous, strictly increasing. */
     sequence: number;
+    /** Server-owned durable high-water mark for a synthetic compact event. */
+    coveredThrough?: number | undefined;
     type: SessionEventType;
     payload: unknown;
     occurredAt: string;
@@ -1486,7 +1560,9 @@ export type ToolAuthNeededPayload = {
     providerDomain: string;
     provider?: string | undefined;
     connectionId?: string | null | undefined;
+    authoritySource?: "host" | undefined;
     reason: "missing_connection" | "expired" | "insufficient_scope" | "refresh_failed" | "personal_authority_unavailable" | "unsupported_auth" | "resource_scope_unavailable";
+    hostReason?: "missing_connection" | "expired" | "insufficient_scope" | "refresh_failed" | "personal_authority_unavailable" | "unsupported_auth" | "resource_scope_unavailable" | undefined;
     scopes?: string[] | undefined;
     resource?: string | undefined;
     selectedResources?: Array<{
@@ -1549,7 +1625,7 @@ export type CodexFleetDecisionEventPayload = {
     actual: {
         outcome: "selected" | "waiting" | "none";
         candidateKey: string | null;
-        reason: "lease_reused" | "pin" | "rotation" | "active" | "all_capped" | "none";
+        reason: "lease_reused" | "pin" | "rotation" | "active" | "all_capped" | "allocator_disabled" | "none";
     };
     comparison: CodexFleetShadowComparison;
     replay: {
@@ -1669,11 +1745,16 @@ export type FsTreeNode = {
     truncated: boolean;
 };
 export type FsEncoding = "utf8" | "base64";
+export type FileSystemRouteIdentity = {
+    epoch: number;
+    root: string;
+};
 export type FsListRequest = {
     path?: string;
     depth?: number;
     maxEntries?: number;
     includeHidden?: boolean;
+    route?: FileSystemRouteIdentity;
 };
 export type FsListResponse = {
     root: FsTreeNode;
@@ -1690,6 +1771,7 @@ export type FsReadRequest = {
     path: string;
     encoding?: FsEncoding;
     maxBytes?: number;
+    route?: FileSystemRouteIdentity;
 };
 export type FsReadResponse = {
     path: string;
@@ -1716,6 +1798,7 @@ export type FsWriteRequest = {
     content: string;
     overwrite?: boolean;
     createParents?: boolean;
+    route?: FileSystemRouteIdentity;
 };
 export type FsWriteResponse = {
     path: string;
@@ -1725,6 +1808,7 @@ export type FsWriteResponse = {
 export type FsDeleteRequest = {
     path: string;
     recursive?: boolean;
+    route?: FileSystemRouteIdentity;
 };
 export type FsDeleteResponse = {
     revision: number;
@@ -1734,6 +1818,7 @@ export type FsMoveRequest = {
     newPath: string;
     overwrite?: boolean;
     createParents?: boolean;
+    route?: FileSystemRouteIdentity;
 };
 export type FsMoveResponse = {
     path: string;
@@ -1743,6 +1828,7 @@ export type FsMoveResponse = {
 export type FsMkdirRequest = {
     path: string;
     recursive?: boolean;
+    route?: FileSystemRouteIdentity;
 };
 export type FsMkdirResponse = {
     path: string;
@@ -2205,6 +2291,8 @@ export type CreateSessionRequest = {
     resources?: ResourceRef[] | undefined;
     /** Inline skills fixed onto this session; omitted children inherit them. */
     skills?: SessionSkill[] | undefined;
+    /** Installed session-selected Skill identities to freeze onto this session at creation. */
+    installedSkillIds?: string[] | undefined;
     tools?: ToolRef[] | undefined;
     metadata?: Record<string, unknown> | undefined;
     model?: string | undefined;
@@ -2240,7 +2328,7 @@ export type KnownPermission = (typeof KNOWN_PERMISSIONS)[number];
  * can introduce permissions without breaking older SDK consumers.
  */
 export type Permission = KnownPermission | (string & {});
-export type FirstPartyMcpToolName = "set_session_title" | "goal_set" | "goal_update" | "goal_progress" | "goal_wait" | "goal_complete" | "goal_pause" | "memory_search" | "memory_save" | "memory_correct" | "preference_registry_summary" | "preference_registry_get" | "task_notes_list" | "task_note_save" | "task_note_archive" | "task_note_replace" | "work_claim_upsert" | "work_claim_release" | "knowledge_propose" | "knowledge_correct" | "task_note_promote_knowledge" | "task_note_promote_instruction_policy" | "task_note_promote_preference" | "instruction_policy_propose" | "preference_propose" | "remember" | "remember_confirm" | "company_profile_propose" | "company_profile_confirm" | "sandboxes_list" | "sandbox_attach" | "sandbox_swap" | "run_on" | "sandbox_provision" | "connected_machine_remove" | "rig_list" | "rig_get" | "rig_propose_change" | "rig_verify" | "rig_promote" | "sessions_list" | "session_get" | "session_events" | "session_wait" | "session_create" | "session_send_message" | "session_pause" | "session_resume" | "session_steer" | "session_human_input_respond" | "set_other_session_title" | "interaction_discover" | "browser_open" | "browser_tabs" | "browser_observe" | "browser_act" | "browser_clipboard" | "browser_debug" | "browser_auth" | "interaction_request_human" | "browser_identity" | "browser_publish" | "browser_lifecycle" | "computer_open" | "computer_targets" | "computer_observe" | "computer_clipboard" | "computer_act" | "computer_lifecycle" | "variable_set_list" | "environment_list" | "variable_set_get_variable" | "variable_set_set_variable" | "environment_set_variable" | "capability_catalog_search" | "capability_authorization_request" | "github_connect_link" | "github_repositories_list" | "social_connections_list" | "social_posts_recent" | "social_daily_analysis_context" | "social_search_live" | "social_mentions_live" | "social_thread_fetch" | "social_posts_sync" | "social_post_reply" | "x_accounts_list" | "x_search_live" | "x_mentions_live" | "x_thread_fetch" | "x_posts_sync" | "x_post_reply" | "reddit_accounts_list" | "reddit_search_live" | "reddit_mentions_live" | "reddit_thread_fetch" | "reddit_posts_sync" | "reddit_post_reply" | "scheduled_tasks_list" | "scheduled_tasks_get" | "scheduled_tasks_create" | "scheduled_tasks_update" | "scheduled_tasks_pause" | "scheduled_tasks_resume" | "scheduled_tasks_trigger" | "scheduled_tasks_delete" | "scheduled_task_runs_list" | "slack_bot_list_channels" | "slack_bot_search" | "slack_bot_channel_history" | "slack_bot_thread_replies" | "slack_bot_list_users" | "slack_bot_list_files" | "slack_bot_file_info" | "slack_bot_file_content" | "slack_bot_post_message" | "slack_bot_delete_message" | "fiken_companies_list" | "fiken_contacts_list" | "fiken_contact_create" | "fiken_products_list" | "fiken_invoices_list" | "fiken_invoice_get" | "fiken_invoice_draft_create" | "fiken_bank_accounts_list" | "fiken_purchases_list" | "fiken_sales_list" | "atlassian_sources_list" | "atlassian_search" | "atlassian_get" | "sandbox_file_publish" | "artifacts_list" | "artifacts_get_source" | "artifacts_create" | "artifacts_publish" | "artifacts_rollback" | "editable_artifact_list" | "editable_artifact_create" | "editable_artifact_import" | "editable_artifact_get" | "editable_artifact_inspect" | "editable_artifact_apply" | "editable_artifact_export" | "editable_artifact_export_status";
+export type FirstPartyMcpToolName = "set_session_title" | "goal_set" | "goal_update" | "goal_progress" | "wait_for_input" | "goal_complete" | "goal_pause" | "memory_search" | "memory_save" | "memory_correct" | "preference_registry_summary" | "preference_registry_get" | "task_notes_list" | "task_note_save" | "task_note_archive" | "task_note_replace" | "work_claim_upsert" | "work_claim_release" | "knowledge_propose" | "knowledge_correct" | "task_note_promote_knowledge" | "task_note_promote_instruction_policy" | "task_note_promote_preference" | "instruction_policy_propose" | "preference_propose" | "remember" | "remember_confirm" | "company_profile_propose" | "company_profile_confirm" | "sandboxes_list" | "sandbox_attach" | "sandbox_swap" | "run_on" | "sandbox_provision" | "connected_machine_remove" | "rig_list" | "rig_get" | "rig_propose_change" | "rig_verify" | "rig_promote" | "sessions_list" | "session_get" | "session_events" | "session_wait" | "command_wait" | "session_create" | "session_send_message" | "session_pause" | "session_resume" | "session_steer" | "session_human_input_respond" | "set_other_session_title" | "interaction_discover" | "browser_open" | "browser_tabs" | "browser_observe" | "browser_act" | "browser_clipboard" | "browser_debug" | "browser_auth" | "interaction_request_human" | "browser_identity" | "browser_publish" | "browser_lifecycle" | "computer_open" | "computer_targets" | "computer_observe" | "computer_clipboard" | "computer_act" | "computer_lifecycle" | "variable_set_list" | "environment_list" | "variable_set_get_variable" | "variable_set_set_variable" | "environment_set_variable" | "capability_catalog_search" | "capability_authorization_request" | "github_connect_link" | "github_repositories_list" | "social_connections_list" | "social_posts_recent" | "social_daily_analysis_context" | "social_search_live" | "social_mentions_live" | "social_thread_fetch" | "social_posts_sync" | "social_post_reply" | "x_accounts_list" | "x_search_live" | "x_mentions_live" | "x_thread_fetch" | "x_posts_sync" | "x_post_reply" | "reddit_accounts_list" | "reddit_search_live" | "reddit_mentions_live" | "reddit_thread_fetch" | "reddit_posts_sync" | "reddit_post_reply" | "scheduled_tasks_list" | "scheduled_tasks_get" | "scheduled_tasks_create" | "scheduled_tasks_update" | "scheduled_tasks_pause" | "scheduled_tasks_resume" | "scheduled_tasks_trigger" | "scheduled_tasks_delete" | "scheduled_task_runs_list" | "slack_bot_list_channels" | "slack_bot_search" | "slack_bot_channel_history" | "slack_bot_thread_replies" | "slack_bot_list_users" | "slack_bot_list_files" | "slack_bot_file_info" | "slack_bot_file_content" | "slack_bot_post_message" | "slack_bot_delete_message" | "fiken_companies_list" | "fiken_contacts_list" | "fiken_contact_create" | "fiken_products_list" | "fiken_invoices_list" | "fiken_invoice_get" | "fiken_invoice_draft_create" | "fiken_bank_accounts_list" | "fiken_purchases_list" | "fiken_sales_list" | "atlassian_sources_list" | "atlassian_search" | "atlassian_get" | "sandbox_file_publish" | "artifacts_list" | "artifacts_get_source" | "artifacts_create" | "artifacts_publish" | "artifacts_rollback" | "artifacts_archive" | "artifacts_restore" | "editable_artifact_list" | "editable_artifact_create" | "editable_artifact_import" | "editable_artifact_get" | "editable_artifact_inspect" | "editable_artifact_apply" | "editable_artifact_export" | "editable_artifact_export_status";
 export type ProductAccessMode = "local" | "configured" | "managed";
 export type ModelCapabilitySupportV1 = "supported" | "unsupported" | "unknown";
 export type ModelCapabilityStateV1 = {
@@ -2287,14 +2375,19 @@ export type ModelCredentialSourceV1 = {
 } | {
     kind: "workspace_connection";
     mechanism: "api_key";
+} | {
+    kind: "organization_connection";
+    mechanism: "api_key";
 };
 export type ModelBillingAttributionV1 = {
-    upstreamPayer: "deployment" | "workspace" | "connected_subscription";
+    upstreamPayer: "deployment" | "workspace" | "organization" | "connected_subscription";
     metering: "opengeni_credits" | "external";
 };
+export type ModelCostClassV1 = "free" | "credits" | "subscription" | "workspace" | "organization";
 export type ModelPricingV1 = {
     inputMicrosPerMillionTokens: number;
     cachedInputMicrosPerMillionTokens?: number | undefined;
+    cacheWriteMicrosPerMillionTokens?: number | undefined;
     outputMicrosPerMillionTokens: number;
     marginBps?: number | undefined;
 };
@@ -2320,7 +2413,7 @@ export type ClientModel = {
     provider: string;
     providerLabel: string;
     api: "responses" | "chat";
-    source?: "opengeni" | "codex" | "supergrok" | "workspace_gateway" | undefined;
+    source?: "opengeni" | "codex" | "supergrok" | "workspace_gateway" | "openrouter" | undefined;
     contextWindowTokens?: number | undefined;
     schemaVersion?: 1 | undefined;
     aliases?: string[] | undefined;
@@ -2336,6 +2429,7 @@ export type ClientModel = {
     } | undefined;
     credentialSource?: ModelCredentialSourceV1 | undefined;
     billing?: ModelBillingAttributionV1 | undefined;
+    cost?: ModelCostClassV1 | undefined;
     capabilities?: ModelCapabilitiesV1 | undefined;
     pricing?: ModelPricingScheduleV1 | undefined;
     definitionVersion?: string | undefined;
@@ -2361,6 +2455,55 @@ export type WorkspaceModelCatalogModel = ClientModel & {
 export type WorkspaceModelCatalogResponse = {
     models: WorkspaceModelCatalogModel[];
 };
+export type WorkspaceGatewayCustomModel = {
+    id: string;
+    upstreamModelId: string;
+    label: string | null;
+    version: number;
+    createdAt: string;
+    updatedAt: string;
+};
+export type WorkspaceGatewayCustomModelsResponse = {
+    models: WorkspaceGatewayCustomModel[];
+};
+export type CreateWorkspaceGatewayCustomModelRequest = {
+    operationId: string;
+    upstreamModelId: string;
+    label?: string | undefined;
+};
+export type DeleteWorkspaceGatewayCustomModelRequest = {
+    expectedVersion: number;
+    operationId: string;
+};
+export type WorkspaceOpenRouterCustomModel = WorkspaceGatewayCustomModel;
+export type WorkspaceOpenRouterCustomModelsResponse = {
+    models: WorkspaceOpenRouterCustomModel[];
+};
+export type CreateWorkspaceOpenRouterCustomModelRequest = CreateWorkspaceGatewayCustomModelRequest;
+export type DeleteWorkspaceOpenRouterCustomModelRequest = DeleteWorkspaceGatewayCustomModelRequest;
+export type OrganizationModelProviderKind = "vercel_gateway" | "openrouter";
+export type OrganizationModelProviderConnection = {
+    providerKind: OrganizationModelProviderKind;
+    status: "active" | "revoked";
+    version: number;
+    createdAt: string;
+    updatedAt: string;
+};
+export type UpsertOrganizationModelProviderConnectionRequest = {
+    operationId: string;
+    expectedVersion?: number | undefined;
+    apiKey: string;
+};
+export type RevokeOrganizationModelProviderConnectionRequest = {
+    operationId: string;
+    expectedVersion: number;
+};
+export type OrganizationProviderCustomModel = WorkspaceGatewayCustomModel;
+export type OrganizationProviderCustomModelsResponse = {
+    models: OrganizationProviderCustomModel[];
+};
+export type CreateOrganizationProviderCustomModelRequest = CreateWorkspaceGatewayCustomModelRequest;
+export type DeleteOrganizationProviderCustomModelRequest = DeleteWorkspaceGatewayCustomModelRequest;
 /**
  * The workspace's hard model/provider allowlist. `null` means unrestricted for
  * that dimension; an empty array is an explicit total block.
@@ -2393,6 +2536,12 @@ export type CodexConnectionStatus = {
         label?: string | null;
         chatgptAccountId?: string | null;
     } | null;
+    /** Live model-catalog probe result for the active account only. */
+    activeAccountValid?: boolean;
+    /** Cached readiness of any account in the effective worker pool. */
+    poolReady?: boolean;
+    /** Cached unpinned worker routability; rotation-off remains active-pointer-only. */
+    workerRoutable?: boolean;
     /** How many Codex accounts the workspace has connected. */
     accountCount?: number;
     source?: WorkspaceCodexSubscriptionSource;
@@ -3086,6 +3235,16 @@ export type CreateOrganizationResponse = {
     organization: OrganizationSummary;
     workspaceId: string;
 };
+export type CreateAdditionalOrganizationRequest = {
+    name: string;
+    workspaceName: string;
+    operationId: string;
+};
+export type CreateAdditionalOrganizationResponse = {
+    organization: OrganizationSummary;
+    workspaceId: string;
+    personalWorkspaceId: string;
+};
 export type UpdateOrganizationNameRequest = {
     name: string;
     expectedUpdatedAt: string;
@@ -3544,7 +3703,7 @@ export type SessionGoalContinuation = {
     observedRevision: number;
     nextAttemptAt: string | null;
     lastError: string | null;
-    /** Agent-stated reason for a `held_for_input` hold; null otherwise. */
+    /** Agent-stated reason for a `wait_for_input` hold; null otherwise. */
     holdReason?: string | null | undefined;
 };
 export type SessionGoal = {
@@ -3718,8 +3877,28 @@ export type SessionQueueSnapshot = {
 };
 export type SessionPendingInputPreview = Pick<SessionSystemUpdate, "id" | "sessionId" | "kind" | "classification" | "sourceId" | "summary" | "createdAt">;
 export type SystemUpdateClassification = "success" | "failure" | "action_required" | "info";
-export type SessionSystemUpdateKind = "scheduled_occurrence" | "goal_continuation" | "agent_message" | "agent_steer_instruction" | "child_terminal_result" | "media_generation_result" | "child_requires_action" | "child_requires_action_resolved" | "child_paused" | "child_waiting_capacity" | "child_progress";
+export type SessionSystemUpdateKind = "scheduled_occurrence" | "goal_continuation" | "agent_message" | "agent_steer_instruction" | "session_wait_timeout" | "background_command_result" | "child_terminal_result" | "media_generation_result" | "child_requires_action" | "child_requires_action_resolved" | "child_paused" | "child_waiting_capacity" | "child_progress";
 export type SessionSystemUpdateState = "pending" | "delivered" | "cancelled" | "superseded" | "failed";
+export type SessionSystemUpdatePayload = {
+    type: "session_wait_timeout";
+    waitTurnId: string;
+    deadlineAt: string;
+    reason: string;
+    [key: string]: unknown;
+} | {
+    type: "background_command_result";
+    commandId: string;
+    state: "exited" | "lost";
+    exitCode: number | null;
+    reason: string;
+    outputLocator: {
+        eventType: "sandbox.command.output.delta";
+        commandId: string;
+    };
+    [key: string]: unknown;
+} | ({
+    type: Exclude<SessionSystemUpdateKind, "session_wait_timeout" | "background_command_result">;
+} & Record<string, unknown>);
 export type SessionSystemUpdate = {
     id: string;
     sessionId: string;
@@ -3728,7 +3907,7 @@ export type SessionSystemUpdate = {
     sourceId: string;
     dedupeKey: string;
     summary: string;
-    payload: Record<string, unknown>;
+    payload: SessionSystemUpdatePayload;
     lineage: Record<string, unknown>;
     state: SessionSystemUpdateState;
     deliveredTurnId: string | null;
@@ -4744,9 +4923,11 @@ export type CapabilityPackSkillFile = {
 export type CapabilityPackSkill = {
     name: string;
     description?: string | undefined;
+    /** Omitted means workspace-wide; session_selected requires explicit session attachment. */
+    activationMode?: "workspace_managed" | "session_selected" | undefined;
     files: CapabilityPackSkillFile[];
 };
-export type SessionSkill = CapabilityPackSkill;
+export type SessionSkill = Omit<CapabilityPackSkill, "activationMode">;
 export type CapabilityPackVariableSetSpec = {
     description: string;
     requiredVariables: string[];
@@ -4830,6 +5011,7 @@ export type RegisterCapabilityPackRequest = {
     skills?: {
         name: string;
         description?: string | undefined;
+        activationMode?: "workspace_managed" | "session_selected" | undefined;
         files: CapabilityPackSkillFile[];
     }[] | undefined;
     components?: ({
@@ -5194,6 +5376,7 @@ export type CapabilityCatalogItem = {
     /** The connection backing this enabled installation, or null when none is involved. */
     connectionRef: {
         connectionId?: string | undefined;
+        authoritySource?: "host" | undefined;
         providerDomain: string;
         kind: string;
         subjectScope?: "subject" | "workspace" | undefined;
@@ -5776,6 +5959,32 @@ export type GitHubAppInfo = {
 export type GitHubRepositoriesResponse = {
     repositories: GitHubRepository[];
 };
+export type VerifyPublicGitHubRepositoryRefRequest = {
+    url: string;
+    ref: string;
+};
+export type VerifyPublicGitHubRepositoryRefResponse = {
+    owner: string;
+    name: string;
+    fullName: string;
+    canonicalUrl: string;
+    cloneUrl: string;
+    defaultBranch: string;
+    ref: string;
+    commitSha: string;
+};
+export type GitHubRepositoryBranch = {
+    name: string;
+    isDefault: boolean;
+};
+export type ListGitHubRepositoryBranchesOptions = {
+    cursor?: number | undefined;
+    limit?: number | undefined;
+};
+export type GitHubRepositoryBranchesResponse = {
+    branches: GitHubRepositoryBranch[];
+    nextCursor: number | null;
+};
 export type CreateGitHubAppManifestRequest = {
     appName?: string | undefined;
     organization?: string | undefined;
@@ -5846,12 +6055,16 @@ export type InsightsModelUsageRow = {
     creditUsd: number;
     estimatedProviderUsd: number;
     estimatedProviderCostKnownCalls: number;
+    equivalentCreditUsd: number;
+    equivalentCreditCostKnownCalls: number;
 };
 export type InsightsSeriesPoint = {
     label: string;
     modelCostUsd: number;
     estimatedProviderUsd: number;
     estimatedProviderCostKnownCalls: number;
+    equivalentCreditUsd: number;
+    equivalentCreditCostKnownCalls: number;
     warmSeconds: number;
     inputTokens: number;
     outputTokens: number;
@@ -5880,6 +6093,8 @@ export type InsightsSpendDriver = {
     creditUsd: number;
     estimatedProviderUsd: number;
     estimatedProviderCostKnownCalls: number;
+    equivalentCreditUsd: number;
+    equivalentCreditCostKnownCalls: number;
     tokens: number;
     cacheHitPct: number;
     pctOfCreditUsd: number;
@@ -5921,6 +6136,8 @@ export type InsightsScheduleRow = {
     creditUsd: number | null;
     estimatedProviderUsd: number | null;
     estimatedProviderCostKnownCalls: number | null;
+    equivalentCreditUsd: number | null;
+    equivalentCreditCostKnownCalls: number | null;
     tokens: number | null;
     cacheHitPct: number | null;
     billing: InsightsBillingPath | null;
@@ -5944,6 +6161,7 @@ export type InsightsModelCallRow = {
     totalTokens: number | null;
     creditUsd: number;
     estimatedProviderUsd: number | null;
+    equivalentCreditUsd: number | null;
     pricingSource: InsightsPricingSource | null;
 };
 export type ModelContextContributionSource = "workspace_instruction_policy" | "legacy_workspace_instructions" | "preference_registry_descriptor" | "company_profile" | "legacy_memory_v1" | "runtime_skill_catalog";
@@ -5994,6 +6212,10 @@ export type WorkspaceInsightsSnapshot = {
     priorEstimatedProviderUsd: number;
     estimatedProviderCostKnownCalls: number;
     priorEstimatedProviderCostKnownCalls: number;
+    equivalentCreditUsd: number;
+    priorEquivalentCreditUsd: number;
+    equivalentCreditCostKnownCalls: number;
+    priorEquivalentCreditCostKnownCalls: number;
     modelCalls: number;
     priorInputTokens: number;
     priorTotalTokens: number;

package/dist/workspace-artifacts.d.ts

@@ -1,3 +1,12 @@
+import type { ToolGatewayIdentity } from "./types.js";
+export type WorkspaceArtifactSourceFile = {
+    path: string;
+    content: string;
+};
+export type WorkspaceArtifactSourceBundle = {
+    entrypoint: string;
+    files: WorkspaceArtifactSourceFile[];
+};
 export type WorkspaceArtifactVersion = {
     id: string;
     accountId: string;
@@ -7,6 +16,9 @@ export type WorkspaceArtifactVersion = {
     contentType: "text/html";
     contentSha256: string;
     sizeBytes: number;
+    sourceSha256: string | null;
+    sourceSizeBytes: number | null;
+    requestedTools: ToolGatewayIdentity[];
     sourceSessionId: string | null;
     sourceTurnId: string | null;
     sourceAttemptId: string | null;
@@ -32,7 +44,7 @@ export type WorkspaceArtifactEvent = {
     accountId: string;
     workspaceId: string;
     artifactId: string;
-    type: "published" | "rolled_back";
+    type: "published" | "rolled_back" | "archived" | "restored";
     fromVersionId: string | null;
     toVersionId: string;
     sourceSessionId: string | null;
@@ -46,6 +58,7 @@ export type WorkspaceArtifactEvent = {
 export type WorkspaceArtifactListOptions = {
     limit?: number;
     cursor?: string;
+    status?: WorkspaceArtifact["status"];
 };
 export type WorkspaceArtifactListResponse = {
     artifacts: WorkspaceArtifact[];
@@ -65,6 +78,8 @@ export type WorkspaceArtifactContentResponse = {
     contentType: "text/html";
     contentSha256: string;
     html: string;
+    source: WorkspaceArtifactSourceBundle;
+    requestedTools: ToolGatewayIdentity[];
 };
 export type WorkspaceArtifactMutationResponse = {
     artifact: WorkspaceArtifact;
@@ -77,12 +92,16 @@ export type CreateWorkspaceArtifactRequest = {
     title: string;
     description?: string | null;
     html: string;
+    source?: WorkspaceArtifactSourceBundle;
+    requestedTools?: ToolGatewayIdentity[];
     idempotencyKey: string;
 };
 export type PublishWorkspaceArtifactVersionRequest = {
     title?: string;
     description?: string | null;
     html: string;
+    source?: WorkspaceArtifactSourceBundle;
+    requestedTools?: ToolGatewayIdentity[];
     expectedCurrentVersionId: string;
     idempotencyKey: string;
 };
@@ -92,3 +111,9 @@ export type RollbackWorkspaceArtifactRequest = {
     reason: string;
     idempotencyKey: string;
 };
+export type SetWorkspaceArtifactStatusRequest = {
+    status: "active" | "archived";
+    expectedCurrentVersionId: string;
+    reason: string;
+    idempotencyKey: string;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opengeni/sdk",
-  "version": "3.3.2",
+  "version": "3.7.0-canary.0",
   "description": "Framework-agnostic TypeScript SDK for the OpenGeni API: typed client, session lifecycle, SSE event streaming with reconnect + replay-by-sequence, and proxy re-streaming helpers.",
   "license": "Apache-2.0",
   "repository": {
@@ -34,6 +34,14 @@
       "types": "./dist/browser.d.ts",
       "import": "./dist/browser.js"
     },
+    "./site": {
+      "types": "./dist/site.d.ts",
+      "import": "./dist/site.js"
+    },
+    "./github-repositories": {
+      "types": "./dist/github-repositories.d.ts",
+      "import": "./dist/github-repositories.js"
+    },
     "./document-authority": {
       "types": "./dist/document-authority.d.ts",
       "import": "./dist/document-authority.js"
@@ -89,6 +97,10 @@
     "./gateway-realtime-transport": {
       "types": "./dist/gateway-realtime-transport.d.ts",
       "import": "./dist/gateway-realtime-transport.js"
+    },
+    "./model-picker-order": {
+      "types": "./dist/model-picker-order.d.ts",
+      "import": "./dist/model-picker-order.js"
     }
   },
   "publishConfig": {
@@ -101,7 +113,7 @@
     "prepublishOnly": "bash ../../scripts/prepublish-guard"
   },
   "dependencies": {
-    "@opengeni/contracts": "^2.9.2"
+    "@opengeni/contracts": "^2.13.0-canary.0"
   },
   "engines": {
     "node": ">=18"