@opengeni/sdk 0.52.1 → 1.0.1

package/dist/types.d.ts

@@ -90,6 +90,8 @@ export type SessionRealtimeInboundEntry = {
     delegationItemId?: string | null | undefined;
     text?: string | null | undefined;
     payload?: Record<string, unknown> | undefined;
+    /** Model-visible application context attached to this exact realtime message. */
+    modelContext?: string | undefined;
 };
 export type SyncSessionRealtimeLedgerRequest = {
     browserInstanceId: string;
@@ -112,11 +114,11 @@ export type SyncSessionRealtimeLedgerResponse = {
     }>;
     outbound: SessionRealtimeLedgerEntry[];
 };
-export type SessionRealtimeModel = "gpt-live-1-boulder-alpha" | "opengeni-gateway/openai/gpt-realtime-2.1" | "opengeni-gateway/openai/gpt-realtime-mini" | "opengeni-gateway/xai/grok-voice-think-fast-2.0" | "workspace-gateway/openai/gpt-realtime-2.1" | "workspace-gateway/openai/gpt-realtime-mini" | "workspace-gateway/xai/grok-voice-think-fast-2.0";
+export type SessionRealtimeModel = "gpt-live-1-boulder-alpha" | "supergrok/grok-voice-think-fast-2.0" | "opengeni-gateway/openai/gpt-realtime-2.1" | "opengeni-gateway/openai/gpt-realtime-mini" | "opengeni-gateway/xai/grok-voice-think-fast-2.0" | "workspace-gateway/openai/gpt-realtime-2.1" | "workspace-gateway/openai/gpt-realtime-mini" | "workspace-gateway/xai/grok-voice-think-fast-2.0";
 export type WorkspaceRealtimeModelCatalogItem = {
     id: SessionRealtimeModel;
     label: string;
-    provider: "OpenGeni" | "Connected Codex" | "Your Gateway";
+    provider: "OpenGeni" | "Connected Codex" | "Connected SuperGrok" | "Your Gateway";
     description: string;
     available: boolean;
     unavailableReason: string | null;
@@ -184,7 +186,7 @@ export type SessionCapabilities = {
         reason: CapabilityUnavailableReason | null;
     };
     Terminal: {
-        transport: "sse-events" | "pty-ws" | null;
+        transport: "sse-events" | "pty-ws" | "relay-pty" | null;
         ptyCapable: boolean;
         shell: string;
         url: string | null;
@@ -279,7 +281,7 @@ export type AttachViewerResponse = ViewerHolder & {
     terminalUrl: string | null;
     terminalToken: string | null;
     terminalExpiresAt: string | null;
-    terminalTransport: "pty-ws" | null;
+    terminalTransport: "pty-ws" | "relay-pty" | null;
 };
 export type AcknowledgeStreamRequest = {
     acknowledgeUnredacted?: boolean | undefined;
@@ -375,6 +377,7 @@ export type GoalSpec = {
     text: string;
     successCriteria?: string | undefined;
     maxAutoContinuations?: number | undefined;
+    mutationPolicy?: SessionGoalMutationPolicy | undefined;
 };
 export type SessionMcpServerInput = {
     id: string;
@@ -469,6 +472,20 @@ export type OpenGeniSlackBotInstallRequest = {
     /** Existing OpenGeni Slack bot connection to reinstall in place. */
     connectionId?: string | undefined;
 };
+export type FikenInstallRequest = {
+    apiToken: string;
+    defaultCompanySlug?: string | undefined;
+    /** Existing Fiken connection to rewrite in place (reconnect). */
+    connectionId?: string | undefined;
+};
+export type FikenOAuthStartRequest = {
+    /** Existing Fiken connection to re-authorize in place (reconnect). */
+    connectionId?: string | undefined;
+};
+export type FikenOAuthStartResponse = {
+    authorizationUrl: string;
+    expiresAt: string;
+};
 export type OpenGeniSlackBotInstallStart = {
     authorizationUrl: string;
     expiresAt: string;
@@ -541,16 +558,25 @@ export type GoogleDriveConnectionMetadata = {
     googleEmail: string;
     googleDisplayName: string | null;
     verifiedAt: string;
-    accessMode: "metadata_readonly" | "readonly";
+    accessMode: "file_only" | "metadata_readonly" | "readonly";
     lifecycle?: GoogleDriveConnectionLifecycle | undefined;
+    outputDestination?: GoogleDriveOutputDestination | undefined;
     documentDestination?: ConnectorDocumentDestination | undefined;
     selectedSources?: GoogleDriveSelectedSource[] | undefined;
     /** @deprecated Read selectedSources; retained while existing connections migrate. */
     selectedSource?: GoogleDriveSelectedSource | null | undefined;
     [key: string]: unknown;
 };
+export type GoogleDriveOutputDestination = {
+    folderId: string;
+    folderName: string;
+    driveId: string | null;
+    location: "my_drive" | "shared_drive";
+    selectedAt: string;
+};
 export type GoogleDriveOAuthStartRequest = {
     connectionId?: string | undefined;
+    capability?: "source_read" | "publish" | undefined;
 };
 export type GoogleDriveOAuthStartResponse = {
     authorizationUrl: string;
@@ -804,6 +830,8 @@ export type Session = {
     environmentId: string | null;
     rigId: string | null;
     rigVersionId: string | null;
+    /** Workspace channel the session is filed under; null = unfiled (inbox). */
+    channelId: string | null;
     firstPartyMcpPermissions: string[] | null;
     firstPartyMcpTools: FirstPartyMcpToolName[];
     mcpServers: SessionMcpServerMetadata[];
@@ -1037,7 +1065,7 @@ export type SessionHumanInputRequest = {
     createdAt: string;
     updatedAt: string;
 };
-export declare const SESSION_EVENT_TYPES: readonly ["session.created", "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", "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", "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.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.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", "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.progress", "goal.rewrite.proposed", "goal.rewrite.rejected", "goal.completed", "goal.paused", "goal.resumed", "goal.cleared", "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.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
@@ -1806,8 +1834,8 @@ export type CreateSessionRequest = {
     initialMessage?: string | undefined;
     /** Create an idle session shell so realtime voice can be the first interaction. */
     startMode?: "realtime" | undefined;
-    /** System instructions scoped to the initial turn; never visible timeline text. */
-    turnInstructions?: string | undefined;
+    /** Model-visible application context attached to the initial user message; omitted by standard timeline rendering. */
+    modelContext?: string | undefined;
     instructions?: string | undefined;
     /** Immutable normalized prompt-policy role; distinct from membership roles. */
     policyRole?: string | undefined;
@@ -1845,7 +1873,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_complete" | "goal_pause" | "memory_search" | "memory_save" | "memory_correct" | "preference_registry_summary" | "preference_registry_get" | "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_create" | "session_send_message" | "session_pause" | "session_resume" | "session_steer" | "set_other_session_title" | "interaction_discover" | "browser_open" | "browser_tabs" | "browser_observe" | "browser_act" | "browser_debug" | "browser_identity" | "browser_publish" | "browser_lifecycle" | "computer_open" | "computer_targets" | "computer_observe" | "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_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" | "atlassian_sources_list" | "atlassian_search" | "atlassian_get" | "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" | "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" | "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_create" | "session_send_message" | "session_pause" | "session_resume" | "session_steer" | "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_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" | "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 ProductAccessMode = "local" | "configured" | "managed";
 export type ModelCapabilitySupportV1 = "supported" | "unsupported" | "unknown";
 export type ModelCapabilityStateV1 = {
@@ -1888,7 +1916,7 @@ export type ModelCredentialSourceV1 = {
     mechanism: "api_key" | "azure_ad_bearer";
 } | {
     kind: "connected_subscription";
-    provider: "codex";
+    provider: "codex" | "xai";
 } | {
     kind: "workspace_connection";
     mechanism: "api_key";
@@ -1925,7 +1953,7 @@ export type ClientModel = {
     provider: string;
     providerLabel: string;
     api: "responses" | "chat";
-    source?: "opengeni" | "codex" | "workspace_gateway" | undefined;
+    source?: "opengeni" | "codex" | "supergrok" | "workspace_gateway" | undefined;
     contextWindowTokens?: number | undefined;
     schemaVersion?: 1 | undefined;
     aliases?: string[] | undefined;
@@ -2169,6 +2197,83 @@ export type CodexConnectPoll = {
     accountId?: string;
     isActive?: boolean;
 };
+/** Explicit authority of one connected SuperGrok/xAI subscription account. */
+export type SuperGrokAccountScope = "workspace" | "user";
+/** Metadata-only connected SuperGrok account. Secret OAuth material never crosses the API. */
+export type SuperGrokAccount = {
+    id: string;
+    scope: SuperGrokAccountScope;
+    subject: string;
+    email?: string | null;
+    label?: string | null;
+    status: "active" | "needs_relogin" | "error";
+    active: boolean;
+    expiresAt?: string | null;
+    lastRefreshAt?: string | null;
+    lastError?: string | null;
+    allocatorEnabled: boolean;
+    allocatorVersion: number;
+    allocatorUpdatedAt?: string | null;
+    exhaustedUntil?: string | null;
+    quota?: {
+        usedPercent: number | null;
+        periodStart: string | null;
+        periodEnd: string | null;
+        subscriptionTier: string | null;
+        checkedAt: string | null;
+    } | null;
+};
+export type SuperGrokRotationSettings = {
+    rotationEnabled: boolean;
+    rotationStrategy: "sharded";
+    activeCredentialId: string | null;
+};
+/** GET /supergrok/accounts — visible accounts plus the workspace active pointer. */
+export type SuperGrokAccountsResponse = {
+    accounts: SuperGrokAccount[];
+    activeAccountId: string | null;
+    settings: SuperGrokRotationSettings;
+};
+export type SuperGrokConnectionStatus = {
+    connected: boolean;
+    valid?: boolean;
+    accountCount?: number;
+    models?: ClientModel[];
+    activeAccount?: {
+        id: string;
+        label?: string | null;
+        subject?: string | null;
+        scope: SuperGrokAccountScope;
+    } | null;
+};
+/** Workspace is the deliberately simple/default connection authority. */
+export type SuperGrokConnectStart = {
+    userCode: string;
+    verificationUri: string;
+    verificationUriComplete?: string | null;
+    intervalSeconds: number;
+    expiresInSeconds: number;
+    scope: SuperGrokAccountScope;
+    state: string;
+};
+export type SuperGrokConnectPoll = {
+    status: "pending" | "slow_down";
+    intervalSeconds?: number;
+} | {
+    status: "expired" | "denied";
+} | {
+    status: "connected";
+    accountId: string;
+    scope: SuperGrokAccountScope;
+    isActive: boolean;
+    email?: string | null;
+};
+export type SuperGrokAllocatorUpdate = {
+    allocatorEnabled: boolean;
+    allocatorVersion: number;
+    allocatorUpdatedAt: string | null;
+    changed: boolean;
+};
 /** Remaining usage/limits for one account. `usage` is the normalized P2 payload. */
 export type CodexUsage = {
     status: "ok" | "limit_reached" | "error" | "no-data";
@@ -2194,7 +2299,7 @@ export type ClientAuthConfig = {
     mode: "managedSession";
     session: "cookie";
 };
-export declare const OPENGENI_API_CONTRACT_REVISION: "2026-08-social-provider-tools-v1";
+export declare const OPENGENI_API_CONTRACT_REVISION: "2026-08-model-context-v1";
 export declare const OPENGENI_API_CONTRACT_HEADER: "x-opengeni-api-contract";
 /** Bounded request/response identifier shared by browser, ingress, and API diagnostics. */
 export declare const OPENGENI_CORRELATION_HEADER: "x-opengeni-correlation-id";
@@ -2218,6 +2323,11 @@ export type ClientConfig = {
         id: string;
         name: string;
     }[];
+    /** Deployment defaults and hard maximum for built-in OpenGeni session tools. */
+    firstPartyMcpTools?: {
+        default: FirstPartyMcpToolName[];
+        allowed: FirstPartyMcpToolName[];
+    } | undefined;
     fileUploads: {
         enabled: boolean;
         maxSizeBytes: number;
@@ -2348,6 +2458,15 @@ export type AccessContext = {
     defaultAccountId: string | null;
     defaultWorkspaceId: string | null;
 };
+export type ManagedOrganizationMembership = {
+    id: string;
+    organizationId: string;
+    status: "active";
+    personalWorkspaceId: string;
+};
+export type ListManagedOrganizationMembershipsResponse = {
+    memberships: ManagedOrganizationMembership[];
+};
 export type Workspace = {
     id: string;
     accountId: string;
@@ -2370,6 +2489,8 @@ export type Workspace = {
 };
 export type WorkspaceSettings = {
     memoryEnabled?: boolean | undefined;
+    /** Reversible Memory V1 prompt composition rollout. */
+    memoryPromptMode?: "legacy_standing" | "retrieval_only" | undefined;
     voiceInput?: WorkspaceVoiceInputSettings | undefined;
     transcription?: WorkspaceTranscriptionPolicy | undefined;
     maxNestedAgentDepth?: number | null | undefined;
@@ -2404,6 +2525,7 @@ export type WorkspaceVoiceInputSettings = {
 };
 export type UpdateWorkspaceSettingsRequest = {
     memoryEnabled?: boolean | undefined;
+    memoryPromptMode?: "legacy_standing" | "retrieval_only" | undefined;
     voiceInput?: WorkspaceVoiceInputSettings | undefined;
     transcription?: WorkspaceTranscriptionPolicy | undefined;
     maxNestedAgentDepth?: number | null | undefined;
@@ -2505,6 +2627,32 @@ export type ListSlackUserLinkAccessRequestsResponse = {
 };
 export type SessionGoalStatus = "active" | "paused" | "completed";
 export type SessionGoalCreatedBy = "api" | "agent" | "scheduled_task";
+export type SessionGoalMutationPolicy = "review_changes" | "preserve_intent" | "autonomous_adaptation";
+export type SessionGoalChangeKind = "refinement" | "adaptation" | "replacement";
+export type SessionGoalRevision = {
+    id: string;
+    accountId: string;
+    workspaceId: string;
+    sessionId: string;
+    goalId: string;
+    disposition: "applied" | "proposed" | "rejected";
+    changeKind: SessionGoalChangeKind;
+    baseObjectiveRevision: number;
+    resultObjectiveRevision: number | null;
+    text: string;
+    successCriteria: string | null;
+    mutationPolicy: SessionGoalMutationPolicy;
+    rationale: string;
+    actor: "agent" | "api" | "scheduled_task";
+    actorTurnId: string | null;
+    actorAttemptId: string | null;
+    proposalId: string | null;
+    createdAt: string;
+};
+export type ApplySessionGoalRevisionRequest = {
+    expectedObjectiveRevision: number;
+    rationale?: string | undefined;
+};
 export type SessionGoalContinuationState = "inactive" | "scheduled" | "running" | "blocked" | "invariant_broken";
 export 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";
 export type SessionGoalContinuation = {
@@ -2528,6 +2676,8 @@ export type SessionGoal = {
     pausedReason: string | null;
     createdBy: SessionGoalCreatedBy;
     version: number;
+    objectiveRevision: number;
+    mutationPolicy: SessionGoalMutationPolicy;
     autoContinuations: number;
     noProgressStreak: number;
     maxAutoContinuations: number | null;
@@ -2540,6 +2690,12 @@ export type SessionGoal = {
 export type UpdateSessionGoalRequest = {
     status: "paused" | "active";
     rationale?: string | undefined;
+} | {
+    text: string;
+    successCriteria?: string | null | undefined;
+    mutationPolicy?: SessionGoalMutationPolicy | undefined;
+    rationale: string;
+    expectedObjectiveRevision: number;
 };
 export type UpdateSessionRequest = {
     title: string;
@@ -2949,6 +3105,32 @@ export type RigVerificationHealth = {
     checkHealth: "passing" | "failing" | "unknown";
     lastVerifiedAt: string | null;
 };
+/**
+ * Workspace-shared channel organizing root sessions ("workstreams") by work
+ * type in the rail. Pure organizational metadata.
+ */
+export type Channel = {
+    id: string;
+    accountId: string;
+    workspaceId: string;
+    name: string;
+    description: string | null;
+    createdBy: string | null;
+    createdAt: string;
+    updatedAt: string;
+};
+export type CreateChannelRequest = {
+    name: string;
+    description?: string;
+};
+export type UpdateChannelRequest = {
+    name?: string;
+    description?: string | null;
+};
+/** Re-files one session; null moves it back to the unfiled inbox. */
+export type UpdateSessionChannelRequest = {
+    channelId: string | null;
+};
 export type Rig = {
     id: string;
     accountId: string;
@@ -3118,7 +3300,7 @@ export type UpdateVideoGenerationPolicyRequest = {
     enabledModelIds: string[];
     defaultModelId: string | null;
 };
-export type VideoGenerationFundingSource = "opengeni_credits" | "workspace_gateway";
+export type VideoGenerationFundingSource = "opengeni_credits" | "workspace_gateway" | "supergrok_subscription";
 export type VideoGenerationFundingOption = {
     source: VideoGenerationFundingSource;
     label: string;
@@ -3514,10 +3696,10 @@ export type CapabilityPackComponentReference = {
     required: boolean;
 } | {
     key: string;
-    kind: "feature";
+    kind: "facet";
     capabilityId: string;
     instanceKey: string;
-    featureKey: string;
+    facetKey: string;
     bindingKey: string;
     configDigest: string;
     required: boolean;
@@ -3593,10 +3775,10 @@ export type RegisterCapabilityPackRequest = {
         required?: boolean | undefined;
     } | {
         key: string;
-        kind: "feature";
+        kind: "facet";
         capabilityId: string;
         instanceKey: string;
-        featureKey: string;
+        facetKey: string;
         bindingKey: string;
         configDigest: string;
         required?: boolean | undefined;
@@ -3673,7 +3855,7 @@ export type EnablePackRequest = {
 export type PackComponentResolutionStatus = "ready" | "missing" | "mismatch";
 export type PackComponentResolution = {
     key: string;
-    kind: "plugin" | "skill" | "integration" | "feature" | "inline_skill";
+    kind: "plugin" | "skill" | "integration" | "facet" | "inline_skill";
     capabilityId: string;
     required: boolean;
     status: PackComponentResolutionStatus;
@@ -3723,7 +3905,7 @@ export type PackUninstallPreview = {
     installationVersion: number | null;
     components: Array<{
         key: string;
-        kind: "plugin" | "skill" | "integration" | "feature" | "inline_skill";
+        kind: "plugin" | "skill" | "integration" | "facet" | "inline_skill";
         capabilityId: string;
         retainedByOtherOwners: boolean;
     }>;
@@ -3833,7 +4015,7 @@ export type CapabilityCatalogResponse = {
 };
 export type CreateCapabilityCatalogItemRequest = {
     id?: string | undefined;
-    kind: Exclude<CapabilityKind, "pack">;
+    kind: "mcp";
     source?: CapabilitySource | undefined;
     name: string;
     description?: string | undefined;
@@ -3855,14 +4037,6 @@ export type EnableCapabilityRequest = {
      * API (responses expose header names only).
      */
     headers?: Record<string, string> | undefined;
-    /**
-     * Initial variableSet attachment for kind=pack capabilities — mirrors the
-     * dedicated POST /packs/:id/enable body. Required to enable an
-     * variableSet.required pack through this unified path; ignored otherwise.
-     */
-    variableSetId?: string | undefined;
-    /** @deprecated use variableSetId */
-    environmentId?: string | undefined;
 };
 export type DiscoverMcpCapabilitiesResponse = {
     items: CapabilityCatalogItem[];
@@ -3870,6 +4044,7 @@ export type DiscoverMcpCapabilitiesResponse = {
     sourceUrl: string;
 };
 export type SkillImportSource = "github" | "skills_sh";
+export type SkillInstallationSource = "library" | "github" | "skills_sh" | "pack";
 export type PreviewSkillImportRequest = {
     url: string;
 };
@@ -3901,6 +4076,11 @@ export type InstallSkillRequest = {
     expectedContentSha256: string;
     expectedInstallationVersion?: number | undefined;
 };
+export type InstallLibrarySkillRequest = {
+    expectedVersion: string;
+    expectedContentSha256: string;
+    expectedInstallationVersion?: number | undefined;
+};
 export type InstalledSkill = {
     capabilityId: string;
     pluginId: string;
@@ -3909,7 +4089,8 @@ export type InstalledSkill = {
     pluginInstallationId: string;
     facetInstallationId: string;
     installationVersion: number;
-    source: SkillImportSource;
+    source: SkillInstallationSource;
+    version: string;
     sourceUrl: string;
     sourceCommit: string;
     contentSha256: string;
@@ -3921,6 +4102,32 @@ export type CapabilityComponentOwner = {
     id: string;
     removable: boolean;
 };
+export type InstalledSkillSummary = {
+    capabilityId: string;
+    pluginKey: string;
+    installationVersion: number;
+    name: string;
+    description: string;
+    category: string;
+    tags: string[];
+    provenance: string;
+    source: SkillInstallationSource;
+    version: string;
+    sourceUrl: string;
+    repositoryUrl: string;
+    sourceCommit: string;
+    sourcePath: string;
+    contentSha256: string;
+    fileCount: number;
+    totalBytes: number;
+    license: string | null;
+    installedAt: string;
+    updatedAt: string;
+    owners: CapabilityComponentOwner[];
+};
+export type ListInstalledSkillsResponse = {
+    skills: InstalledSkillSummary[];
+};
 export type SkillUninstallPreview = {
     capabilityId: string;
     installed: boolean;
@@ -3938,22 +4145,23 @@ export type UninstallSkillResult = {
     remainingOwners: CapabilityComponentOwner[];
 };
 export type ApiIntegrationProtocol = "openapi" | "graphql";
-export type IntegrationFeatureKind = "tools" | "knowledge_source" | "inbound_trigger" | "delivery_destination" | "identity_link";
-export type IntegrationFeatureStatus = "active" | "paused" | "needs_attention" | "disabled";
-export type IntegrationFeatureDefinitionSummary = {
-    featureKey: string;
-    kind: Exclude<IntegrationFeatureKind, "tools">;
+export type IntegrationDefinitionProvenance = "curated" | "workspace";
+export type IntegrationFacetKind = "tools" | "knowledge_source" | "inbound_trigger" | "delivery_destination" | "identity_link";
+export type IntegrationFacetStatus = "active" | "paused" | "needs_attention" | "disabled";
+export type IntegrationFacetDefinitionSummary = {
+    facetKey: string;
+    kind: Exclude<IntegrationFacetKind, "tools">;
     configSchema: Record<string, unknown>;
     capabilities: Record<string, unknown>;
 };
-export type IntegrationFeatureBindingSummary = {
+export type IntegrationFacetBindingSummary = {
     id: string;
-    featureKey: string;
-    kind: Exclude<IntegrationFeatureKind, "tools">;
+    facetKey: string;
+    kind: Exclude<IntegrationFacetKind, "tools">;
     bindingKey: string;
     displayName: string;
     connectionId: string | null;
-    status: IntegrationFeatureStatus;
+    status: IntegrationFacetStatus;
     config: Record<string, unknown>;
     version: number;
     hasCursor: boolean;
@@ -3962,57 +4170,62 @@ export type IntegrationFeatureBindingSummary = {
     createdAt: string;
     updatedAt: string;
 };
-export type IntegrationInstanceFeaturesResponse = {
+export type IntegrationInstanceFacetsResponse = {
     capabilityId: string;
     instanceKey: string;
     providerDomain: string;
     connectionId: string | null;
-    features: {
-        definition: IntegrationFeatureDefinitionSummary;
-        binding: IntegrationFeatureBindingSummary | null;
+    facets: {
+        definition: IntegrationFacetDefinitionSummary;
+        binding: IntegrationFacetBindingSummary | null;
     }[];
 };
-export type UpsertIntegrationFeatureRequest = {
+export type UpsertIntegrationFacetRequest = {
     displayName: string;
     config?: Record<string, unknown> | undefined;
     expectedVersion?: number | undefined;
     idempotencyKey: string;
 };
-export type MutateIntegrationFeatureRequest = {
+export type MutateIntegrationFacetRequest = {
     expectedVersion: number;
     idempotencyKey: string;
 };
-export type IntegrationFeatureMutationResult = {
+export type IntegrationFacetMutationResult = {
     capabilityId: string;
     instanceKey: string;
-    featureKey: string;
+    facetKey: string;
     status: "configured" | "paused" | "active";
-    binding: IntegrationFeatureBindingSummary;
+    binding: IntegrationFacetBindingSummary;
 };
-export type IntegrationFeatureRemovalResult = {
+export type IntegrationFacetRemovalResult = {
     capabilityId: string;
     instanceKey: string;
-    featureKey: string;
+    facetKey: string;
     status: "not_configured" | "removed" | "retained_by_other_owners";
-    binding: IntegrationFeatureBindingSummary | null;
+    binding: IntegrationFacetBindingSummary | null;
     remainingOwners: CapabilityComponentOwner[];
 };
-export type ApiIntegrationPresetSummary = {
+export type IntegrationDefinitionSummary = {
     id: string;
     name: string;
     summary: string;
-    family: "google" | "microsoft";
     protocol: "openapi";
-    providerDomain: string;
-    scopes: string[];
-    features: IntegrationFeatureDefinitionSummary[];
+    provider: {
+        id: "google" | "microsoft";
+        domain: string;
+    };
+    authentication: {
+        kind: "oauth2";
+        scopes: string[];
+    };
+    facets: IntegrationFacetDefinitionSummary[];
 };
-export type ListApiIntegrationPresetsResponse = {
-    presets: ApiIntegrationPresetSummary[];
+export type ListIntegrationDefinitionsResponse = {
+    definitions: IntegrationDefinitionSummary[];
 };
-export type ApiIntegrationSource = {
-    kind: "preset";
-    presetId: string;
+export type IntegrationSource = {
+    kind: "definition";
+    definitionId: string;
 } | {
     kind: "openapi";
     url: string;
@@ -4027,12 +4240,12 @@ export type ApiIntegrationSource = {
     baseUrl?: string | undefined;
 };
 export type PreviewApiIntegrationRequest = {
-    source: ApiIntegrationSource;
+    source: IntegrationSource;
     connectionId?: string | undefined;
     ownership?: ConnectionOwnership | undefined;
 };
 export type ApiIntegrationOAuthStartRequest = {
-    presetId: string;
+    definitionId: string;
     ownership?: ConnectionOwnership | undefined;
     connectionId?: string | undefined;
     returnPath?: string | undefined;
@@ -4063,10 +4276,10 @@ export type ApiIntegrationToolPreview = {
     deprecated: boolean;
 };
 export type ApiIntegrationPreview = {
-    source: ApiIntegrationSource;
-    presetId: string | null;
+    source: IntegrationSource;
+    definitionId: string;
+    definitionProvenance: IntegrationDefinitionProvenance;
     protocol: ApiIntegrationProtocol;
-    integrationId: string;
     capabilityId: string;
     pluginKey: string;
     serverId: string;
@@ -4085,7 +4298,7 @@ export type ApiIntegrationPreview = {
     warnings: string[];
 };
 export type InstallApiIntegrationRequest = {
-    source: ApiIntegrationSource;
+    source: IntegrationSource;
     expectedRevisionId: string;
     expectedContentSha256: string;
     connectionId?: string | undefined;
@@ -4125,7 +4338,8 @@ export type ApiIntegrationInstallationSummary = {
     name: string;
     description: string | null;
     protocol: ApiIntegrationProtocol;
-    presetId: string | null;
+    definitionId: string;
+    definitionProvenance: IntegrationDefinitionProvenance;
     providerDomain: string;
     baseUrl: string;
     sourceUrl: string | null;
@@ -4172,7 +4386,7 @@ export type PluginManifestComponent = {
 } | {
     key: string;
     kind: "integration";
-    source: ApiIntegrationSource;
+    source: IntegrationSource;
 } | {
     key: string;
     kind: "mcp";
@@ -4581,7 +4795,7 @@ export type UserMessageEventInput = {
     payload: {
         text: string;
         annotations?: SubmittedTimelineAnnotation[] | undefined;
-        turnInstructions?: string | undefined;
+        modelContext?: string | undefined;
         resources?: ResourceRef[] | undefined;
         model?: string | undefined;
         reasoningEffort?: ReasoningEffort | undefined;