@opengeni/sdk 0.48.0 → 0.57.0

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-import type { WorkspaceTranscriptionPolicy } from "./transcription";
+import type { WorkspaceTranscriptionPolicy } from "./transcription.js";
 export type CodexRealtimeWebrtcVersion = "v3";
 export type CodexRealtimeVoice = "juniper" | "maple" | "spruce" | "ember" | "vale" | "breeze" | "arbor" | "sol" | "cove";
 export type CodexRealtimeWebrtcRequest = {
@@ -112,11 +112,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,11 +184,12 @@ 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;
         token: string | null;
+        expiresAt: string | null;
         reason: CapabilityUnavailableReason | null;
     };
     Git: {
@@ -255,6 +256,8 @@ export type StreamRevokedPayload = {
 export type AttachViewerRequest = {
     viewerId?: string | undefined;
     desktop?: boolean | undefined;
+    terminal?: boolean | undefined;
+    files?: boolean | undefined;
 };
 export type ViewerHolder = {
     viewerId: string;
@@ -271,11 +274,12 @@ export type AttachViewerResponse = ViewerHolder & {
     streamToken: string | null;
     streamExpiresAt: string | null;
     resolution: [number, number] | null;
-    transport: "vnc-ws" | null;
-    client: "novnc" | null;
+    transport: "vnc-ws" | "relay-frames" | null;
+    client: "novnc" | "frames" | null;
     terminalUrl: string | null;
     terminalToken: string | null;
-    terminalTransport: "pty-ws" | null;
+    terminalExpiresAt: string | null;
+    terminalTransport: "pty-ws" | "relay-pty" | null;
 };
 export type AcknowledgeStreamRequest = {
     acknowledgeUnredacted?: boolean | undefined;
@@ -318,7 +322,7 @@ export type RepositoryResourceRef = {
     githubInstallationId?: number | undefined;
     githubRepositoryId?: number | undefined;
 };
-/** Value mirror of `@opengeni/contracts`; parity-tested without adding an SDK runtime dependency. */
+/** Value mirror of `@opengeni/contracts`; parity-tested without importing it from ordinary SDK entries. */
 export declare const DEFAULT_FILE_RESOURCE_MOUNT_ROOT: ".opengeni/files";
 export type FileResourceRef = {
     kind: "file";
@@ -371,6 +375,7 @@ export type GoalSpec = {
     text: string;
     successCriteria?: string | undefined;
     maxAutoContinuations?: number | undefined;
+    mutationPolicy?: SessionGoalMutationPolicy | undefined;
 };
 export type SessionMcpServerInput = {
     id: string;
@@ -465,10 +470,48 @@ 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;
 };
+export type SlackInstallationBindingState = "active" | "quarantined";
+export type SlackInstallationBinding = {
+    id: string;
+    accountId: string;
+    accountName: string;
+    workspaceId: string;
+    workspaceName: string;
+    connectionId: string;
+    connectionStatus: ConnectionStatus;
+    connectionVersion: number;
+    slackTeamId: string;
+    slackTeamName: string;
+    botId: string;
+    botUserId: string;
+    botDisplayName: "OpenGeni";
+    state: SlackInstallationBindingState;
+    quarantineReason: string | null;
+    version: number;
+    createdAt: string;
+    updatedAt: string;
+};
+export type ListSlackInstallationBindingsResponse = {
+    bindings: SlackInstallationBinding[];
+};
 export type GoogleDriveTargetScope = "user" | "workspace" | "organization";
 export type ConnectorDocumentDestinationAuthority = "organization" | "workspace" | "personal";
 export type ConnectorDocumentDestinationSelection = {
@@ -501,12 +544,14 @@ export type GoogleDriveSelectedSource = {
     /** @deprecated Missing destinations resolve to the current workspace boundary. */
     targetScope?: GoogleDriveTargetScope | undefined;
     syncCadence: GoogleDriveSyncCadence;
+    syncEnabled: boolean;
+    configGeneration: number;
     readPolicy: GoogleDriveReadPolicy;
     selectedAt: string;
 };
 export type GoogleDriveConnectionMetadata = {
     credentialRole: "google_drive_metadata";
-    credentialLabel: "Google Drive metadata browser";
+    credentialLabel: "Google Drive read-only source sync" | "Google Drive metadata browser";
     googlePermissionId: string;
     googleEmail: string;
     googleDisplayName: string | null;
@@ -552,14 +597,111 @@ export type GoogleDriveBrowseResponse = {
     nextPageToken: string | null;
     incompleteSearch: boolean;
 };
+export type AtlassianSourceKind = "jira_project" | "confluence_space";
+export type AtlassianSyncCadence = "manual" | "hourly" | "daily";
+export type AtlassianReadPolicy = "allow" | "ask" | "block";
+export type AtlassianConnectionLifecycle = {
+    state: "active" | "paused" | "token_revoked" | "app_removed" | "disconnected" | "reconnect_required" | "reconsent_required";
+    recoverable: boolean;
+    observedAt: string;
+};
+export type AtlassianSelectedSource = {
+    id: string;
+    cloudId: string;
+    siteName: string;
+    siteUrl: string;
+    resourceId: string;
+    key: string;
+    name: string;
+    kind: AtlassianSourceKind;
+    destination?: ConnectorDocumentDestination | undefined;
+    syncCadence: AtlassianSyncCadence;
+    syncEnabled: boolean;
+    configGeneration: number;
+    readPolicy: AtlassianReadPolicy;
+    selectedAt: string;
+};
+export type AtlassianConnectionMetadata = {
+    credentialRole: "atlassian_knowledge";
+    credentialLabel: "Atlassian read-only knowledge sync";
+    atlassianAccountId: string;
+    displayName: string;
+    email?: string | null | undefined;
+    sites: Array<{
+        cloudId: string;
+        name: string;
+        url: string;
+        products: Array<"jira" | "confluence">;
+    }>;
+    verifiedAt: string;
+    accessMode: "readonly";
+    lifecycle?: AtlassianConnectionLifecycle | undefined;
+    documentDestination?: ConnectorDocumentDestination | undefined;
+    selectedSources: AtlassianSelectedSource[];
+    [key: string]: unknown;
+};
+export type AtlassianOAuthStartResponse = {
+    authorizationUrl: string;
+    expiresAt: string;
+};
+export type AtlassianLifecycleActionRequest = {
+    action: "pause" | "resume";
+    expectedVersion: number;
+};
+export type AtlassianDisconnectRequest = {
+    expectedVersion: number;
+    idempotencyKey: string;
+};
+export type AtlassianBrowseItem = {
+    id: string;
+    cloudId: string;
+    siteName: string;
+    siteUrl: string;
+    resourceId: string;
+    key: string;
+    name: string;
+    kind: AtlassianSourceKind;
+    description: string | null;
+    webUrl: string;
+};
+export type AtlassianBrowseResponse = {
+    connection: ConnectionMetadata;
+    items: AtlassianBrowseItem[];
+};
 export type SaveGoogleDriveSourceRequest = {
     sources: Array<Pick<GoogleDriveBrowseItem, "id" | "name" | "mimeType" | "driveId">>;
     destination?: ConnectorDocumentDestinationSelection | undefined;
     /** @deprecated Legacy requests resolve to workspace authority. */
     targetScope?: GoogleDriveTargetScope | undefined;
     syncCadence: GoogleDriveSyncCadence;
+    syncEnabled: boolean;
     readPolicy: GoogleDriveReadPolicy;
 };
+export type GoogleDriveKnowledgeSourceItem = {
+    id: string;
+    name: string;
+    mimeType: string;
+    driveId?: string | undefined;
+    sourceKind: "my_drive" | "shared_drive" | "folder";
+    includeDescendants: boolean;
+};
+export type GoogleDriveKnowledgeSourceDestination = {
+    authorityKind: ConnectorDocumentDestinationAuthority;
+    authorityAccountId: string;
+    authorityWorkspaceId?: string | undefined;
+    authoritySubjectId?: string | undefined;
+    collectionId?: string | undefined;
+};
+export type GoogleDriveKnowledgeSourceConfig = {
+    sources: GoogleDriveKnowledgeSourceItem[];
+    destination: GoogleDriveKnowledgeSourceDestination;
+    syncCadence: GoogleDriveSyncCadence;
+    readPolicy: GoogleDriveReadPolicy;
+};
+export type SaveGoogleDriveIntegrationSourceRequest = SaveGoogleDriveSourceRequest & {
+    expectedVersion?: number | undefined;
+    idempotencyKey: string;
+};
 export type UpdateConnectionRequest = {
     providerDomain?: string | undefined;
     subjectId?: string | null | undefined;
@@ -677,6 +819,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[];
@@ -739,6 +883,49 @@ export type SessionListResponse = {
     sessions: Session[];
     nextCursor: string | null;
 };
+/** Compact, bounded session projection for workspace agent-topology browsers. */
+export type AgentTopologySession = {
+    id: string;
+    title: string | null;
+    titleTruncated: boolean;
+    parentSessionId: string | null;
+    rootSessionId: string;
+    nestedAgentDepth: number;
+    ancestorPath: Array<{
+        id: string;
+        title: string | null;
+        titleTruncated: boolean;
+    }>;
+    status: SessionStatus;
+    pause: {
+        state: "active" | "paused";
+        additionalBlockerCount: number;
+        source: {
+            kind: "session" | "workspace";
+            sessionId?: string | undefined;
+            displayName: string;
+            displayNameTruncated: boolean;
+        } | null;
+    };
+    children: {
+        directChildren: number;
+        totalDescendants: number;
+        runningDescendants: number;
+        queuedDescendants: number;
+        attentionDescendants: number;
+        pausedDescendants: number;
+        failedDescendants: number;
+        truncated: boolean;
+    };
+    createdAt: string;
+    updatedAt: string;
+};
+export type AgentTopologyPageResponse = {
+    sessions: AgentTopologySession[];
+    total: number;
+    hasMore: boolean;
+    nextCursor: string | null;
+};
 export type UpdateSessionPinRequest = {
     pinned: boolean;
     expectedVersion?: number;
@@ -754,6 +941,30 @@ export type SessionLineageResponse = {
 };
 export type SessionTurnStatus = "queued" | "running" | "requires_action" | "recovering" | "waiting_capacity" | "completed" | "failed" | "cancelled" | "superseded" | "withdrawn_for_edit";
 export type SessionTurnSource = "user" | "scheduled_task" | "api" | "goal" | "system" | "compaction";
+export type TimelineAnnotationSourceKind = "user_message" | "assistant_message" | "tool_output";
+export type TimelineAnnotationSourceEventType = "user.message" | "agent.message.completed" | "agent.toolCall.output";
+export type TimelineAnnotationSource = {
+    kind: TimelineAnnotationSourceKind;
+    eventId: string;
+    eventType: TimelineAnnotationSourceEventType;
+    sequence: number;
+    turnId: string | null;
+    startOffset: number;
+    endOffset: number;
+    contextBefore: string;
+    contextAfter: string;
+    label?: string | undefined;
+};
+export type DraftTimelineAnnotation = {
+    id: string;
+    source: TimelineAnnotationSource;
+    quote: string;
+    note: string;
+};
+export type SubmittedTimelineAnnotation = DraftTimelineAnnotation;
+export type TimelineAnnotation = DraftTimelineAnnotation & {
+    ordinal: number;
+};
 export type SessionTurn = {
     id: string;
     workspaceId: string;
@@ -764,6 +975,7 @@ export type SessionTurn = {
     source: SessionTurnSource;
     position: number;
     prompt: string;
+    annotations?: TimelineAnnotation[] | undefined;
     resources: ResourceRef[];
     tools: ToolRef[];
     toolsProvided?: boolean | undefined;
@@ -842,7 +1054,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
@@ -979,6 +1191,15 @@ export type ToolAuthNeededPayload = {
     }> | undefined;
     authorizationUrl?: string | undefined;
     subjectId?: string | null | undefined;
+    capability?: {
+        id: string;
+        name: string;
+        kind: CapabilityKind;
+        source: CapabilitySource;
+        action: "connect" | "add_credentials" | "enable";
+        rationale: string;
+        requiredVariables: string[];
+    } | undefined;
 };
 export type AgentTextDeltaPayload = {
     text: string;
@@ -1227,6 +1448,9 @@ export type GitStatusRequest = {
 export type GitStatusResponse = {
     isRepo: boolean;
     head: string | null;
+    /** Exact commit object identity. null for unborn/non-repositories; absent on
+     *  legacy adapters. */
+    headOid?: string | null | undefined;
     detached: boolean;
     upstream: string | null;
     ahead: number;
@@ -1349,6 +1573,9 @@ export type WorkspaceCaptureFile = {
 export type WorkspaceCaptureRepo = {
     root: string;
     head: string | null;
+    /** Exact HEAD commit object identity. null for unborn repositories; absent
+     *  on legacy captures. */
+    headOid?: string | null | undefined;
     detached: boolean;
     upstream: string | null;
     ahead: number;
@@ -1493,6 +1720,8 @@ export type ScheduledTaskRunMode = "new_session_per_run" | "reusable_session" |
 export type ScheduledTaskOverlapPolicy = "allow_concurrent" | "skip" | "buffer_one";
 export type ScheduledTaskDayOfWeek = "SUNDAY" | "MONDAY" | "TUESDAY" | "WEDNESDAY" | "THURSDAY" | "FRIDAY" | "SATURDAY";
 export type ScheduledTaskScheduleSpec = {
+    type: "manual";
+} | {
     type: "once";
     runAt: string;
     timeZone: string;
@@ -1520,6 +1749,50 @@ export type ScheduledTaskAgentConfig = {
     goal?: GoalSpec | undefined;
     maxNestedAgentDepth?: number | undefined;
 };
+export type ScopedKnowledgeScope = {
+    kind: "organization";
+    workspaceId: null;
+    subjectId: null;
+} | {
+    kind: "workspace";
+    workspaceId: string;
+    subjectId: null;
+} | {
+    kind: "personal";
+    workspaceId: string | null;
+    subjectId: string;
+};
+export type KnowledgeSourceSyncLimits = {
+    maxItems: number;
+    maxBytes: number;
+    maxFileBytes: number;
+    maxProviderRequests: number;
+    maxElapsedSeconds: number;
+    maxConcurrency: number;
+    maxFailureDetails: number;
+};
+export type ScheduledTaskAction = {
+    kind: "agent_turn";
+} | {
+    kind: "knowledge_source_sync";
+    sourceId: string;
+    sourceGeneration: number;
+    sourceLifecycleGeneration: number;
+    sourceConfigGeneration: number;
+    controlWorkspaceId: string;
+    providerCoordinationKey: string;
+    connection: {
+        connectionId: string;
+        connectionVersion: number;
+        providerDomain: string;
+        kind: ConnectionKind;
+        ownerSubjectId: string;
+    };
+    destination: ScopedKnowledgeScope;
+    initiatingSubjectId: string;
+    allDescendants: boolean;
+    limits: KnowledgeSourceSyncLimits;
+};
 export type ScheduledTask = {
     id: string;
     accountId: string;
@@ -1530,6 +1803,7 @@ export type ScheduledTask = {
     temporalScheduleId: string;
     runMode: ScheduledTaskRunMode;
     overlapPolicy: ScheduledTaskOverlapPolicy;
+    action: ScheduledTaskAction;
     agentConfig: ScheduledTaskAgentConfig;
     createdBy?: TurnInitiator | undefined;
     createdByContext?: TurnInitiatorContext | undefined;
@@ -1581,14 +1855,14 @@ export type CreateSessionRequest = {
         groupId: string;
     } | undefined;
 };
-export declare const KNOWN_PERMISSIONS: readonly ["account:read", "account:admin", "members:manage", "workspace:create", "billing:read", "billing:manage", "workspace:read", "workspace:admin", "sessions:create", "sessions:read", "sessions:control", "stream:view", "stream:control", "stream:acknowledge", "files:upload", "files:read", "files:write", "terminal:attach", "documents:manage", "documents:search", "scheduled_tasks:manage", "scheduled_tasks:run", "github:manage", "github:use", "api_keys:manage", "connections:read", "connections:write", "environments:manage", "environments:use", "variable-sets:list", "variable-sets:read", "variable-sets:write", "variable-sets:manage", "variable-sets:use", "secrets:list", "secrets:read", "secrets:write", "mcp_servers:attach", "toolspace:call", "goals:manage", "enrollments:read", "enrollments:manage", "rigs:use", "rigs:manage", "artifacts:read", "artifacts:publish"];
+export declare const KNOWN_PERMISSIONS: readonly ["account:read", "account:admin", "members:manage", "workspace:create", "billing:read", "billing:manage", "workspace:read", "workspace:admin", "sessions:create", "sessions:read", "sessions:control", "stream:view", "stream:control", "stream:acknowledge", "files:upload", "files:read", "files:write", "terminal:attach", "documents:manage", "documents:search", "scheduled_tasks:manage", "scheduled_tasks:run", "github:manage", "github:use", "api_keys:manage", "connections:read", "connections:write", "environments:manage", "environments:use", "variable-sets:list", "variable-sets:read", "variable-sets:write", "variable-sets:manage", "variable-sets:use", "secrets:list", "secrets:read", "secrets:write", "mcp_servers:attach", "codemode:call", "goals:manage", "enrollments:read", "enrollments:manage", "rigs:use", "rigs:manage", "artifacts:read", "artifacts:publish"];
 export type KnownPermission = (typeof KNOWN_PERMISSIONS)[number];
 /**
  * Permissions the SDK knows about today, kept open so a newer OpenGeni server
  * 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" | "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" | "variable_set_list" | "environment_list" | "variable_set_get_variable" | "variable_set_set_variable" | "environment_set_variable" | "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" | "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" | "artifacts_list" | "artifacts_get_source" | "artifacts_create" | "artifacts_publish" | "artifacts_rollback";
+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 = {
@@ -1631,7 +1905,7 @@ export type ModelCredentialSourceV1 = {
     mechanism: "api_key" | "azure_ad_bearer";
 } | {
     kind: "connected_subscription";
-    provider: "codex";
+    provider: "codex" | "xai";
 } | {
     kind: "workspace_connection";
     mechanism: "api_key";
@@ -1668,7 +1942,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;
@@ -1912,6 +2186,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";
@@ -1937,7 +2288,7 @@ export type ClientAuthConfig = {
     mode: "managedSession";
     session: "cookie";
 };
-export declare const OPENGENI_API_CONTRACT_REVISION: "2026-07-workspace-artifacts-v1";
+export declare const OPENGENI_API_CONTRACT_REVISION: "2026-08-social-provider-tools-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";
@@ -1961,6 +2312,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;
@@ -2091,6 +2447,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;
@@ -2113,6 +2478,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;
@@ -2125,7 +2492,7 @@ export type WorkspaceSettings = {
 };
 export type WorkspaceSlackReactionSummonSettings = {
     enabled: boolean;
-    emoji: string;
+    emoji: "genie";
     channelPolicy: {
         mode: "bot_member";
     } | {
@@ -2147,6 +2514,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;
@@ -2216,8 +2584,64 @@ export type UpdateWorkspaceMemberRequest = {
     role?: string | undefined;
     permissions: Permission[];
 };
+export type SlackUserLinkAccessRequestStatus = "prepared" | "pending" | "completed" | "denied" | "cancelled" | "expired";
+/** Token-free durable projection of one signed Slack identity-link intent. */
+export type SlackUserLinkAccessRequest = {
+    id: string;
+    workspaceId: string;
+    workspaceDisplayName: string | null;
+    subjectLabel: string | null;
+    status: SlackUserLinkAccessRequestStatus;
+    version: number;
+    expiresAt: string;
+    requestedAt: string | null;
+    decidedAt: string | null;
+    completedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+};
+export type PrepareSlackUserLinkAccessRequest = {
+    linkToken: string;
+};
+export type SlackUserLinkAccessMutationRequest = {
+    expectedVersion: number;
+    idempotencyKey: string;
+};
+export type ApproveSlackUserLinkAccessRequest = SlackUserLinkAccessMutationRequest & {
+    role?: string | undefined;
+    permissions: Permission[];
+};
+export type ListSlackUserLinkAccessRequestsResponse = {
+    requests: SlackUserLinkAccessRequest[];
+};
 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 = {
@@ -2241,6 +2665,8 @@ export type SessionGoal = {
     pausedReason: string | null;
     createdBy: SessionGoalCreatedBy;
     version: number;
+    objectiveRevision: number;
+    mutationPolicy: SessionGoalMutationPolicy;
     autoContinuations: number;
     noProgressStreak: number;
     maxAutoContinuations: number | null;
@@ -2253,6 +2679,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;
@@ -2314,6 +2746,7 @@ export type SessionCommandReceipt = {
 export type ComposerDraft = {
     revision: number;
     text: string;
+    annotations?: DraftTimelineAnnotation[] | undefined;
     resources: ResourceRef[];
     model: string;
     reasoningEffort: ReasoningEffort;
@@ -2363,7 +2796,7 @@ 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";
+export type SessionSystemUpdateKind = "scheduled_occurrence" | "goal_continuation" | "agent_message" | "agent_steer_instruction" | "child_terminal_result" | "media_generation_result";
 export type SessionSystemUpdateState = "pending" | "delivered" | "cancelled" | "superseded" | "failed";
 export type SessionSystemUpdate = {
     id: string;
@@ -2471,9 +2904,12 @@ export type ScheduledTaskAgentConfigInput = {
     goal?: GoalSpec | undefined;
     maxNestedAgentDepth?: number | undefined;
 };
-export type CreateScheduledTaskRequest = {
+export type CreateAgentScheduledTaskRequest = {
     name: string;
     schedule: ScheduledTaskScheduleSpec;
+    action?: {
+        kind: "agent_turn";
+    } | undefined;
     runMode?: ScheduledTaskRunMode | undefined;
     targetSessionId?: string | null | undefined;
     overlapPolicy?: ScheduledTaskOverlapPolicy | undefined;
@@ -2485,12 +2921,24 @@ export type CreateScheduledTaskRequest = {
     rigId?: string | null | undefined;
     metadata?: Record<string, unknown> | undefined;
 };
+export type CreateKnowledgeSourceSyncScheduledTaskRequest = {
+    name: string;
+    schedule: ScheduledTaskScheduleSpec;
+    action: Extract<ScheduledTaskAction, {
+        kind: "knowledge_source_sync";
+    }>;
+    overlapPolicy?: "skip" | "buffer_one" | undefined;
+    status?: ScheduledTaskStatus | undefined;
+    metadata?: Record<string, unknown> | undefined;
+};
+export type CreateScheduledTaskRequest = CreateAgentScheduledTaskRequest | CreateKnowledgeSourceSyncScheduledTaskRequest;
 export type UpdateScheduledTaskRequest = {
     name?: string | undefined;
     schedule?: ScheduledTaskScheduleSpec | undefined;
     runMode?: ScheduledTaskRunMode | undefined;
     targetSessionId?: string | null | undefined;
     overlapPolicy?: ScheduledTaskOverlapPolicy | undefined;
+    action?: ScheduledTaskAction | undefined;
     agentConfig?: ScheduledTaskAgentConfigInput | undefined;
     status?: ScheduledTaskStatus | undefined;
     variableSetId?: string | null | undefined;
@@ -2499,8 +2947,31 @@ export type UpdateScheduledTaskRequest = {
     rigId?: string | null | undefined;
     metadata?: Record<string, unknown> | undefined;
 };
-export type ScheduledTaskRunStatus = "queued" | "dispatched" | "failed";
-export type ScheduledTaskTriggerType = "scheduled" | "manual";
+export type ScheduledTaskRunStatus = "queued" | "dispatched" | "succeeded" | "skipped" | "failed";
+export type KnowledgeSourceSyncRunSummary = {
+    phase: "queued" | "inventory" | "transfer" | "index" | "checkpoint" | "completed" | "failed";
+    scanned: number;
+    imported: number;
+    unchanged: number;
+    skipped: number;
+    failed: number;
+    bytes: number;
+    providerRequests: number;
+    elapsedMs: number;
+    indexed: number;
+    aclPending: number;
+    retryable: boolean;
+    limitReached: "items" | "bytes" | "file_bytes" | "provider_requests" | "elapsed_time" | null;
+    checkpointed: boolean;
+    reconnectRequired: boolean;
+    failures: Array<{
+        externalObjectId: string;
+        code: "authority_changed" | "connection_reconnect_required" | "provider_unavailable" | "provider_rejected" | "provider_payload_invalid" | "content_unsupported" | "content_too_large" | "resource_limit" | "item_processing_failed" | "indexing_failed" | "internal_failure";
+        retryable: boolean;
+        message: string;
+    }>;
+};
+export type ScheduledTaskTriggerType = "scheduled" | "manual" | "initial" | "provider_event" | "retry" | "repair";
 export type ScheduledTaskRun = {
     id: string;
     accountId: string;
@@ -2512,6 +2983,10 @@ export type ScheduledTaskRun = {
     firedAt: string;
     sessionId: string | null;
     triggerEventId: string | null;
+    actionKind: "agent_turn" | "knowledge_source_sync";
+    knowledgeSyncRunId: string | null;
+    knowledgeSummary: KnowledgeSourceSyncRunSummary | null;
+    completedAt: string | null;
     error: string | null;
     createdAt: string;
     updatedAt: string;
@@ -2570,6 +3045,36 @@ export type RigCheck = {
     name: string;
     command: string;
 };
+export type RigProviderImageBuildStatus = "building" | "ready" | "failed" | "unsupported";
+export type RigProviderImage = {
+    backend: SandboxBackend;
+    provider: string;
+    status: RigProviderImageBuildStatus;
+    contentHash: string;
+    setupHash: string;
+    sourceImage: string | null;
+    buildRequestId: string;
+    imageId: string | null;
+    imageDigest: string | null;
+    artifactId: string | null;
+    providerBindingKeyHash: string | null;
+    coldBootValidation?: {
+        version: 1;
+        checkedAt: string;
+    } | undefined;
+    provenance: {
+        kind: "rig_verification";
+        targetKind: "change" | "version";
+        targetId: string;
+    };
+    startedAt: string;
+    finishedAt: string | null;
+    error: {
+        code: string;
+        message: string;
+        retryable: boolean;
+    } | null;
+};
 export type RigVersion = {
     id: string;
     rigId: string;
@@ -2580,6 +3085,7 @@ export type RigVersion = {
     credentialHooks: string[];
     defaultVariableSetIds: string[];
     changelog: string | null;
+    providerImages: Partial<Record<SandboxBackend, RigProviderImage>>;
     createdBy: string | null;
     active: boolean;
     createdAt: string;
@@ -2588,6 +3094,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;
@@ -2680,7 +3212,9 @@ export type FileAsset = {
 export declare const RETAINED_OUTPUT_DEFAULT_PAGE_BYTES: number;
 export declare const RETAINED_OUTPUT_MAX_PAGE_BYTES: number;
 export declare const COMPUTER_SCREENSHOT_MAX_BYTES: number;
-export type RetainedOutputKind = "tool_result" | "assistant_completion" | "internal_update" | "event_media" | "computer_screenshot" | "file";
+export declare const GENERATED_IMAGE_MAX_BYTES: number;
+export declare const GENERATED_VIDEO_MAX_BYTES: number;
+export type RetainedOutputKind = "tool_result" | "assistant_completion" | "internal_update" | "event_media" | "computer_screenshot" | "generated_image" | "generated_video" | "file";
 export type RetainedOutputUnavailableReason = "not_retained" | "pending" | "failed" | "expired" | "deleted" | "missing_storage" | "storage_write_failed" | "quota_exceeded" | "invalid_content" | "oversized" | "unsupported";
 export type RetainedArtifactReference = {
     available: true;
@@ -2714,6 +3248,114 @@ export type RetainedArtifactUnavailable = {
     reason: RetainedOutputUnavailableReason;
 };
 export type RetainedArtifactMetadata = RetainedArtifactReference | RetainedArtifactUnavailable;
+export type GeneratedImageReceipt = {
+    type: "generated_image";
+    artifact: RetainedArtifactReference;
+    sandboxPath: string;
+};
+export type VideoGenerationSourceMode = "text" | "first_frame" | "first_and_last_frames" | "image_reference" | "video_reference";
+export type VideoGenerationResolution = "480p" | "720p";
+export type VideoGenerationAspectRatio = "16:9" | "4:3" | "1:1" | "3:4" | "9:16" | "21:9" | "adaptive";
+export type VideoGenerationModelCapability = {
+    modelId: string;
+    label: string;
+    providerLabel: string;
+    sourceModes: VideoGenerationSourceMode[];
+    resolutions: VideoGenerationResolution[];
+    aspectRatios: VideoGenerationAspectRatio[];
+    duration: {
+        minSeconds: number;
+        maxSeconds: number;
+        stepSeconds: number;
+    };
+    supportsAudio: boolean;
+};
+export type VideoGenerationCapabilities = {
+    schemaVersion: 1;
+    capabilityRevision: string;
+    defaultModelId: string;
+    models: VideoGenerationModelCapability[];
+};
+export type VideoGenerationPolicy = {
+    schemaVersion: 1;
+    revision: number;
+    fundingSource: VideoGenerationFundingSource;
+    enabledModelIds: string[];
+    defaultModelId: string | null;
+};
+export type UpdateVideoGenerationPolicyRequest = {
+    expectedRevision: number;
+    fundingSource: VideoGenerationFundingSource;
+    enabledModelIds: string[];
+    defaultModelId: string | null;
+};
+export type VideoGenerationFundingSource = "opengeni_credits" | "workspace_gateway" | "supergrok_subscription";
+export type VideoGenerationFundingOption = {
+    source: VideoGenerationFundingSource;
+    label: string;
+    description: string;
+    available: boolean;
+    unavailableReason: string | null;
+};
+export type WorkspaceVideoGenerationSettings = {
+    schemaVersion: 1;
+    policy: VideoGenerationPolicy;
+    fundingOptions: VideoGenerationFundingOption[];
+    availableModels: VideoGenerationModelCapability[];
+    capabilities: VideoGenerationCapabilities | null;
+};
+export type GeneratedVideoFacts = {
+    durationSeconds: number;
+    width: number;
+    height: number;
+    fps: number;
+    hasAudio: boolean;
+    videoCodec: "h264";
+    audioCodec: "aac" | null;
+};
+export type GeneratedVideoReceipt = {
+    type: "generated_video";
+    schemaVersion: 1;
+    operationId: string;
+    artifact: RetainedArtifactReference;
+    video: GeneratedVideoFacts;
+    sandboxPath: string;
+};
+export type VideoGenerationTerminalFailureStatus = "provider_failed" | "retention_failed" | "cancelled_before_submit" | "outcome_unknown";
+export type MediaGenerationResult = {
+    type: "media_generation_result";
+    schemaVersion: 1;
+    status: "ready";
+    operationId: string;
+    receipt: GeneratedVideoReceipt;
+} | {
+    type: "media_generation_result";
+    schemaVersion: 1;
+    status: VideoGenerationTerminalFailureStatus;
+    operationId: string;
+    boundedPublicReason: string;
+};
+export type VideoGenerationPublicStatus = "preparing" | "prepared" | "accepted" | "provider_started" | "retaining" | "completed" | VideoGenerationTerminalFailureStatus;
+export type VideoGenerationOperationSummary = {
+    schemaVersion: 1;
+    operationId: string;
+    modelId: string;
+    status: VideoGenerationPublicStatus;
+    createdAt: string;
+    updatedAt: string;
+    terminal: MediaGenerationResult | null;
+};
+/** Ephemeral source minted for native browser playback; never persist the URL. */
+export type VideoArtifactPlaybackSource = {
+    schemaVersion: 1;
+    artifactId: string;
+    url: string;
+    expiresAt: string;
+    contentType: "video/mp4";
+    sizeBytes: number;
+    sha256: string;
+    acceptRanges: "bytes";
+};
 export type RetainedArtifactContentOptions = {
     /** One RFC-style bytes range, for example `bytes=1048576-2097151`. */
     range?: string | undefined;
@@ -2727,16 +3369,21 @@ export type RetainedArtifactContent = {
     contentRange: string | null;
     acceptRanges: "bytes";
 };
-export type RetainedScreenshotDownloadOptions = {
+export type RetainedArtifactDownloadOptions = {
     signal?: AbortSignal | undefined;
     /** Retry transient range failures; bounded to 0..3, default 2. */
     maxRetries?: number | undefined;
 };
+export type RetainedScreenshotDownloadOptions = RetainedArtifactDownloadOptions;
 export type RetainedScreenshotDownload = {
     metadata: RetainedArtifactMetadata;
     /** Null when metadata truth says the screenshot is unavailable. */
     bytes: Uint8Array | null;
 };
+export type RetainedArtifactDownload = {
+    artifact: RetainedArtifactReference;
+    bytes: Uint8Array;
+};
 export type CreateFileUploadRequest = {
     filename: string;
     contentType: string;
@@ -3015,6 +3662,43 @@ export type CapabilityPackVariableSetSpec = {
     requiredVariables: string[];
     required: boolean;
 };
+export type CapabilityPackComponentReference = {
+    key: string;
+    kind: "plugin";
+    pluginKey: string;
+    version: string;
+    manifestDigest: string;
+    required: boolean;
+} | {
+    key: string;
+    kind: "skill";
+    capabilityId: string;
+    contentSha256: string;
+    required: boolean;
+} | {
+    key: string;
+    kind: "integration";
+    capabilityId: string;
+    instanceKey: string;
+    revisionId: string;
+    contentSha256: string;
+    required: boolean;
+} | {
+    key: string;
+    kind: "facet";
+    capabilityId: string;
+    instanceKey: string;
+    facetKey: string;
+    bindingKey: string;
+    configDigest: string;
+    required: boolean;
+};
+export type CapabilityPackRigRequirement = {
+    description?: string | undefined;
+    required: boolean;
+    rigId?: string | undefined;
+    requireVerified: boolean;
+};
 export type CapabilityPack = {
     id: string;
     name: string;
@@ -3029,6 +3713,8 @@ export type CapabilityPack = {
         } | undefined;
     } | undefined;
     skills: CapabilityPackSkill[];
+    components: CapabilityPackComponentReference[];
+    rig?: CapabilityPackRigRequirement | undefined;
     tools: ToolRef[];
     connectors: CapabilityPackConnector[];
     knowledge: CapabilityPackKnowledge[];
@@ -3055,6 +3741,43 @@ export type RegisterCapabilityPackRequest = {
         description?: string | undefined;
         files: CapabilityPackSkillFile[];
     }[] | undefined;
+    components?: ({
+        key: string;
+        kind: "plugin";
+        pluginKey: string;
+        version: string;
+        manifestDigest: string;
+        required?: boolean | undefined;
+    } | {
+        key: string;
+        kind: "skill";
+        capabilityId: string;
+        contentSha256: string;
+        required?: boolean | undefined;
+    } | {
+        key: string;
+        kind: "integration";
+        capabilityId: string;
+        instanceKey: string;
+        revisionId: string;
+        contentSha256: string;
+        required?: boolean | undefined;
+    } | {
+        key: string;
+        kind: "facet";
+        capabilityId: string;
+        instanceKey: string;
+        facetKey: string;
+        bindingKey: string;
+        configDigest: string;
+        required?: boolean | undefined;
+    })[] | undefined;
+    rig?: {
+        description?: string | undefined;
+        required?: boolean | undefined;
+        rigId?: string | undefined;
+        requireVerified?: boolean | undefined;
+    } | undefined;
     tools?: ToolRef[] | undefined;
     connectors?: {
         id: string;
@@ -3096,13 +3819,18 @@ export type WorkspaceRegisteredPack = {
     createdAt: string;
     updatedAt: string;
 };
-export type PackInstallationStatus = "active" | "disabled";
+export type PackInstallationStatus = "installing" | "active" | "needs_attention" | "disabled";
 export type PackInstallation = {
     id: string;
     accountId: string;
     workspaceId: string;
     packId: string;
     status: PackInstallationStatus;
+    version: number;
+    manifestSnapshot: CapabilityPack | null;
+    manifestDigest: string | null;
+    selectedRigId: string | null;
+    installedBySubjectId: string | null;
     metadata: Record<string, unknown>;
     enabledAt: string;
     updatedAt: string;
@@ -3113,6 +3841,73 @@ export type EnablePackRequest = {
     environmentId?: string | undefined;
     metadata?: Record<string, unknown> | undefined;
 };
+export type PackComponentResolutionStatus = "ready" | "missing" | "mismatch";
+export type PackComponentResolution = {
+    key: string;
+    kind: "plugin" | "skill" | "integration" | "facet" | "inline_skill";
+    capabilityId: string;
+    required: boolean;
+    status: PackComponentResolutionStatus;
+    expectedDigest: string;
+    actualDigest: string | null;
+    resolvedId: string | null;
+    label: string;
+};
+export type PackRigResolution = {
+    required: boolean;
+    status: "not_required" | "ready" | "missing" | "mismatch" | "unverified";
+    requestedRigId: string | null;
+    rigId: string | null;
+    rigVersionId: string | null;
+    name: string | null;
+    image: string | null;
+};
+export type PreviewPackInstallationRequest = {
+    rigId?: string | undefined;
+    variableSetId?: string | undefined;
+};
+export type PackInstallationPreview = {
+    packId: string;
+    packVersion: string;
+    manifestDigest: string;
+    installationVersion: number | null;
+    action: "install" | "update" | "repair";
+    ready: boolean;
+    blockers: string[];
+    components: PackComponentResolution[];
+    rig: PackRigResolution;
+    variableSetId: string | null;
+    legacyInlineSkillCount: number;
+    legacySandboxImage: string | null;
+};
+export type InstallPackRequest = {
+    expectedManifestDigest: string;
+    expectedInstallationVersion?: number | undefined;
+    rigId?: string | undefined;
+    variableSetId?: string | undefined;
+    idempotencyKey: string;
+    metadata?: Record<string, unknown> | undefined;
+};
+export type PackUninstallPreview = {
+    packId: string;
+    installed: boolean;
+    installationVersion: number | null;
+    components: Array<{
+        key: string;
+        kind: "plugin" | "skill" | "integration" | "facet" | "inline_skill";
+        capabilityId: string;
+        retainedByOtherOwners: boolean;
+    }>;
+};
+export type UninstallPackRequest = {
+    expectedInstallationVersion: number;
+    idempotencyKey: string;
+};
+export type UninstallPackResult = {
+    packId: string;
+    status: "not_installed" | "uninstalled";
+    retainedComponents: string[];
+};
 export type ListPacksResponse = {
     packs: CapabilityPack[];
     installations: PackInstallation[];
@@ -3126,6 +3921,15 @@ export type CapabilitySource = "built_in" | "library" | "configured" | "public_r
 export type CapabilityInstallationStatus = "active" | "disabled";
 export type CapabilityCatalogAuthKind = "oauth2" | "api_key" | "none" | "unknown";
 export type CapabilityCatalogTier = "verified" | "community";
+export type CapabilityLifecycleStatus = "available" | "installed" | "connected" | "ready" | "needs_attention" | "unavailable" | "managed";
+export type CapabilityReadiness = "ready" | "setup_required" | "attention" | "unavailable";
+export type CapabilityAction = "install" | "connect" | "configure" | "update" | "repair" | "disconnect" | "uninstall" | "inspect";
+export type CapabilityLifecycle = {
+    status: CapabilityLifecycleStatus;
+    readiness: CapabilityReadiness;
+    detail: string | null;
+    managedBy: "deployment" | "platform" | "workspace" | null;
+};
 export type CapabilityRuntime = {
     available: boolean;
     mcpServerId?: string | undefined;
@@ -3165,7 +3969,11 @@ export type CapabilityCatalogItem = {
     staleAt: string | null;
     tools: ToolRef[];
     runtime: CapabilityRuntime;
+    lifecycle: CapabilityLifecycle;
+    actions: CapabilityAction[];
+    /** @deprecated Use lifecycle and actions. */
     enabled: boolean;
+    /** @deprecated Use lifecycle.detail. */
     enabledReason: string | null;
     /** The connection backing this enabled installation, or null when none is involved. */
     connectionRef: {
@@ -3196,7 +4004,7 @@ export type CapabilityCatalogResponse = {
 };
 export type CreateCapabilityCatalogItemRequest = {
     id?: string | undefined;
-    kind: Exclude<CapabilityKind, "pack">;
+    kind: "mcp";
     source?: CapabilitySource | undefined;
     name: string;
     description?: string | undefined;
@@ -3218,20 +4026,468 @@ 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[];
     source: "official_mcp_registry";
     sourceUrl: string;
 };
+export type SkillImportSource = "github" | "skills_sh";
+export type SkillInstallationSource = "library" | "github" | "skills_sh" | "pack";
+export type PreviewSkillImportRequest = {
+    url: string;
+};
+export type SkillImportFileSummary = {
+    path: string;
+    byteSize: number;
+    contentSha256: string;
+};
+export type SkillImportPreview = {
+    source: SkillImportSource;
+    sourceUrl: string;
+    repositoryUrl: string;
+    owner: string;
+    repository: string;
+    sourcePath: string;
+    sourceCommit: string;
+    name: string;
+    description: string;
+    contentSha256: string;
+    totalBytes: number;
+    files: SkillImportFileSummary[];
+    warnings: string[];
+    installed: boolean;
+    installationVersion: number | null;
+};
+export type InstallSkillRequest = {
+    url: string;
+    expectedSourceCommit: string;
+    expectedContentSha256: string;
+    expectedInstallationVersion?: number | undefined;
+};
+export type InstallLibrarySkillRequest = {
+    expectedVersion: string;
+    expectedContentSha256: string;
+    expectedInstallationVersion?: number | undefined;
+};
+export type InstalledSkill = {
+    capabilityId: string;
+    pluginId: string;
+    pluginVersionId: string;
+    facetId: string;
+    pluginInstallationId: string;
+    facetInstallationId: string;
+    installationVersion: number;
+    source: SkillInstallationSource;
+    version: string;
+    sourceUrl: string;
+    sourceCommit: string;
+    contentSha256: string;
+    name: string;
+    status: "installed";
+};
+export type CapabilityComponentOwner = {
+    kind: "direct" | "plugin" | "pack" | "migration";
+    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;
+    installationVersion: number | null;
+    directOwner: CapabilityComponentOwner | null;
+    remainingOwners: CapabilityComponentOwner[];
+    removesRuntimeSkill: boolean;
+};
+export type UninstallSkillRequest = {
+    expectedInstallationVersion: number;
+};
+export type UninstallSkillResult = {
+    capabilityId: string;
+    status: "not_installed" | "uninstalled" | "retained_by_other_owners";
+    remainingOwners: CapabilityComponentOwner[];
+};
+export type ApiIntegrationProtocol = "openapi" | "graphql";
+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 IntegrationFacetBindingSummary = {
+    id: string;
+    facetKey: string;
+    kind: Exclude<IntegrationFacetKind, "tools">;
+    bindingKey: string;
+    displayName: string;
+    connectionId: string | null;
+    status: IntegrationFacetStatus;
+    config: Record<string, unknown>;
+    version: number;
+    hasCursor: boolean;
+    lastSuccessAt: string | null;
+    lastErrorCode: string | null;
+    createdAt: string;
+    updatedAt: string;
+};
+export type IntegrationInstanceFacetsResponse = {
+    capabilityId: string;
+    instanceKey: string;
+    providerDomain: string;
+    connectionId: string | null;
+    facets: {
+        definition: IntegrationFacetDefinitionSummary;
+        binding: IntegrationFacetBindingSummary | null;
+    }[];
+};
+export type UpsertIntegrationFacetRequest = {
+    displayName: string;
+    config?: Record<string, unknown> | undefined;
+    expectedVersion?: number | undefined;
+    idempotencyKey: string;
+};
+export type MutateIntegrationFacetRequest = {
+    expectedVersion: number;
+    idempotencyKey: string;
+};
+export type IntegrationFacetMutationResult = {
+    capabilityId: string;
+    instanceKey: string;
+    facetKey: string;
+    status: "configured" | "paused" | "active";
+    binding: IntegrationFacetBindingSummary;
+};
+export type IntegrationFacetRemovalResult = {
+    capabilityId: string;
+    instanceKey: string;
+    facetKey: string;
+    status: "not_configured" | "removed" | "retained_by_other_owners";
+    binding: IntegrationFacetBindingSummary | null;
+    remainingOwners: CapabilityComponentOwner[];
+};
+export type IntegrationDefinitionSummary = {
+    id: string;
+    name: string;
+    summary: string;
+    protocol: "openapi";
+    provider: {
+        id: "google" | "microsoft";
+        domain: string;
+    };
+    authentication: {
+        kind: "oauth2";
+        scopes: string[];
+    };
+    facets: IntegrationFacetDefinitionSummary[];
+};
+export type ListIntegrationDefinitionsResponse = {
+    definitions: IntegrationDefinitionSummary[];
+};
+export type IntegrationSource = {
+    kind: "definition";
+    definitionId: string;
+} | {
+    kind: "openapi";
+    url: string;
+    baseUrl?: string | undefined;
+} | {
+    kind: "graphql";
+    endpoint: string;
+    name?: string | undefined;
+} | {
+    kind: "auto";
+    url: string;
+    baseUrl?: string | undefined;
+};
+export type PreviewApiIntegrationRequest = {
+    source: IntegrationSource;
+    connectionId?: string | undefined;
+    ownership?: ConnectionOwnership | undefined;
+};
+export type ApiIntegrationOAuthStartRequest = {
+    definitionId: string;
+    ownership?: ConnectionOwnership | undefined;
+    connectionId?: string | undefined;
+    returnPath?: string | undefined;
+};
+export type ApiIntegrationAuthPreview = {
+    kind: "none";
+} | {
+    kind: "oauth2";
+    providerDomain: string;
+    scopes: string[];
+} | {
+    kind: "api_key";
+    providerDomain: string;
+    carrier: "header" | "query" | "cookie";
+    name: string;
+} | {
+    kind: "http";
+    providerDomain: string;
+    scheme: string;
+};
+export type ApiIntegrationToolPreview = {
+    id: string;
+    operationKey: string;
+    name: string;
+    description: string;
+    safety: "read" | "write" | "destructive";
+    approvalMode: "never" | "ask";
+    deprecated: boolean;
+};
+export type ApiIntegrationPreview = {
+    source: IntegrationSource;
+    definitionId: string;
+    definitionProvenance: IntegrationDefinitionProvenance;
+    protocol: ApiIntegrationProtocol;
+    capabilityId: string;
+    pluginKey: string;
+    serverId: string;
+    name: string;
+    description: string | null;
+    provider: string | null;
+    providerDomain: string;
+    baseUrl: string;
+    sourceUrl: string | null;
+    revisionId: string;
+    contentSha256: string;
+    auth: ApiIntegrationAuthPreview;
+    connectionId: string | null;
+    connectionOwnership: ConnectionOwnership | null;
+    tools: ApiIntegrationToolPreview[];
+    warnings: string[];
+};
+export type InstallApiIntegrationRequest = {
+    source: IntegrationSource;
+    expectedRevisionId: string;
+    expectedContentSha256: string;
+    connectionId?: string | undefined;
+    ownership?: ConnectionOwnership | undefined;
+    instanceKey?: string | undefined;
+    displayName?: string | undefined;
+    expectedInstanceVersion?: number | undefined;
+    allowedTools?: string[] | undefined;
+};
+export type InstalledApiIntegration = {
+    capabilityId: string;
+    pluginId: string;
+    pluginVersionId: string;
+    integrationFacetId: string;
+    apiFacetId: string;
+    pluginInstallationId: string;
+    integrationFacetInstallationId: string;
+    apiFacetInstallationId: string;
+    installationVersion: number;
+    instanceId: string;
+    instanceKey: string;
+    displayName: string;
+    instanceVersion: number;
+    revisionId: string;
+    serverId: string;
+    status: "installed";
+};
+export type ApiIntegrationInstallationSummary = {
+    capabilityId: string;
+    pluginKey: string;
+    installationVersion: number;
+    instanceId: string;
+    instanceKey: string;
+    displayName: string;
+    instanceVersion: number;
+    serverId: string;
+    name: string;
+    description: string | null;
+    protocol: ApiIntegrationProtocol;
+    definitionId: string;
+    definitionProvenance: IntegrationDefinitionProvenance;
+    providerDomain: string;
+    baseUrl: string;
+    sourceUrl: string | null;
+    connected: boolean;
+    requiresConnection: boolean;
+    connectionId: string | null;
+    ownership: "workspace" | "personal" | "none";
+    allowedTools: string[];
+    toolCount: number;
+    approvalRequiredToolCount: number;
+    revisionId: string;
+    contentSha256: string;
+};
+export type ListApiIntegrationsResponse = {
+    integrations: ApiIntegrationInstallationSummary[];
+};
+export type ApiIntegrationUninstallPreview = {
+    capabilityId: string;
+    instanceKey: string;
+    displayName: string | null;
+    installed: boolean;
+    installationVersion: number | null;
+    instanceVersion: number | null;
+    directOwner: CapabilityComponentOwner | null;
+    remainingOwners: CapabilityComponentOwner[];
+    removesRuntimeIntegration: boolean;
+    removesDefinition: boolean;
+};
+export type UninstallApiIntegrationRequest = {
+    expectedInstallationVersion: number;
+    expectedInstanceVersion: number;
+};
+export type UninstallApiIntegrationResult = {
+    capabilityId: string;
+    instanceKey: string;
+    status: "not_installed" | "uninstalled" | "retained_by_other_owners";
+    remainingOwners: CapabilityComponentOwner[];
+    definitionStatus: "retained" | "disabled";
+};
+export type PluginManifestComponent = {
+    key: string;
+    kind: "skill";
+    url: string;
+} | {
+    key: string;
+    kind: "integration";
+    source: IntegrationSource;
+} | {
+    key: string;
+    kind: "mcp";
+    serverId: string;
+};
+export type PluginManifest = {
+    schemaVersion: 1;
+    pluginKey: string;
+    version: string;
+    name: string;
+    description: string;
+    category: string;
+    tags: string[];
+    components: PluginManifestComponent[];
+};
+export type PluginComponentBinding = {
+    connectionId?: string | undefined;
+    instanceKey?: string | undefined;
+    displayName?: string | undefined;
+};
+export type PreviewPluginRequest = {
+    url: string;
+    bindings?: Record<string, PluginComponentBinding> | undefined;
+};
+export type PluginComponentPreview = {
+    key: string;
+    kind: "skill" | "integration" | "mcp";
+    name: string;
+    capabilityId: string;
+    digest: string;
+    connectionRequired: boolean;
+    connectionId: string | null;
+    instanceKey: string | null;
+    displayName: string | null;
+    facts: Record<string, unknown>;
+};
+export type PluginUpdateDiff = {
+    fromVersion: string | null;
+    toVersion: string;
+    added: string[];
+    removed: string[];
+    changed: string[];
+    unchanged: string[];
+};
+export type PluginPreview = {
+    sourceUrl: string;
+    manifest: PluginManifest;
+    manifestDigest: string;
+    installed: boolean;
+    installationVersion: number | null;
+    components: PluginComponentPreview[];
+    diff: PluginUpdateDiff;
+};
+export type InstallPluginRequest = {
+    url: string;
+    expectedManifestDigest: string;
+    expectedComponents: Array<{
+        key: string;
+        digest: string;
+    }>;
+    bindings?: Record<string, PluginComponentBinding> | undefined;
+    idempotencyKey: string;
+    expectedInstallationVersion?: number | undefined;
+};
+export type InstalledPlugin = {
+    pluginKey: string;
+    version: string;
+    pluginId: string;
+    pluginVersionId: string;
+    pluginInstallationId: string;
+    installationVersion: number;
+    componentCount: number;
+    status: "installed";
+};
+export type PluginInstallationSummary = {
+    pluginKey: string;
+    version: string;
+    name: string;
+    description: string;
+    category: string;
+    tags: string[];
+    sourceUrl: string | null;
+    manifestDigest: string;
+    installationVersion: number;
+    componentCount: number;
+    status: "active" | "needs_attention";
+    installedAt: string;
+    updatedAt: string;
+};
+export type ListInstalledPluginsResponse = {
+    plugins: PluginInstallationSummary[];
+};
+export type PluginUninstallPreview = {
+    pluginKey: string;
+    installed: boolean;
+    version: string | null;
+    installationVersion: number | null;
+    components: Array<{
+        capabilityId: string;
+        kind: "skill" | "integration" | "mcp";
+        retainedByOtherOwners: boolean;
+    }>;
+};
+export type UninstallPluginRequest = {
+    expectedInstallationVersion: number;
+    idempotencyKey: string;
+};
+export type UninstallPluginResult = {
+    pluginKey: string;
+    status: "not_installed" | "uninstalled";
+    retainedComponents: string[];
+};
 export type GitHubRepository = {
     id: number;
     installationId: number;
@@ -3302,7 +4558,7 @@ export type BillingBalance = {
     currency: "usd";
     updatedAt: string;
 };
-export declare const KNOWN_USAGE_EVENT_TYPES: readonly ["agent_run.created", "agent_run.completed", "model.tokens", "model.cost", "file.uploaded", "file.deleted", "document.indexed", "scheduled_task.fired", "api_key.request", "sandbox.warm_seconds", "sandbox.warm_cost"];
+export declare const KNOWN_USAGE_EVENT_TYPES: readonly ["agent_run.created", "agent_run.completed", "model.tokens", "model.cost", "file.uploaded", "file.deleted", "document.indexed", "scheduled_task.fired", "knowledge_source_sync.fired", "knowledge_source_sync.completed", "knowledge_source_sync.items", "knowledge_source_sync.bytes", "api_key.request", "sandbox.warm_seconds", "sandbox.warm_cost"];
 export type KnownUsageEventType = (typeof KNOWN_USAGE_EVENT_TYPES)[number];
 export type UsageEventType = KnownUsageEventType | (string & {});
 export type UsageEvent = {
@@ -3333,6 +4589,7 @@ export type BillingUsageResponse = {
 };
 export type InsightsRange = "today" | "week" | "month" | "ytd";
 export type InsightsBillingPath = "opengeni_credits" | "external";
+export type InsightsPricingSource = "configured_list_price" | "gateway_reported";
 export type InsightsModelUsageRow = {
     id: string;
     model: string;
@@ -3342,16 +4599,31 @@ export type InsightsModelUsageRow = {
     inputTokens: number;
     outputTokens: number;
     cachedTokens: number;
+    cacheInputTokens: number;
     cacheWriteTokens: number;
     reasoningTokens: number;
+    totalTokens: number;
+    tokenKnownCalls: number;
+    cacheKnownCalls: number;
     creditUsd: number;
+    estimatedProviderUsd: number;
+    estimatedProviderCostKnownCalls: number;
 };
 export type InsightsSeriesPoint = {
     label: string;
     modelCostUsd: number;
+    estimatedProviderUsd: number;
+    estimatedProviderCostKnownCalls: number;
     warmSeconds: number;
     inputTokens: number;
+    outputTokens: number;
     cachedTokens: number;
+    cacheInputTokens: number;
+    cacheWriteTokens: number;
+    reasoningTokens: number;
+    totalTokens: number;
+    tokenKnownCalls: number;
+    cacheKnownCalls: number;
     cacheHitPct: number;
     calls: number;
 };
@@ -3368,9 +4640,12 @@ export type InsightsSpendDriver = {
     groupBy: "root_session" | "schedule";
     label: string;
     creditUsd: number;
+    estimatedProviderUsd: number;
+    estimatedProviderCostKnownCalls: number;
     tokens: number;
     cacheHitPct: number;
     pctOfCreditUsd: number;
+    pctOfTokens: number;
     deltaUsdVsPrior: number;
 };
 export type InsightsWarmGroupRow = {
@@ -3406,16 +4681,42 @@ export type InsightsScheduleRow = {
     name: string;
     fires: number;
     creditUsd: number | null;
+    estimatedProviderUsd: number | null;
+    estimatedProviderCostKnownCalls: number | null;
     tokens: number | null;
     cacheHitPct: number | null;
     billing: InsightsBillingPath | null;
 };
+export type InsightsModelCallRow = {
+    id: string;
+    occurredAt: string;
+    recordedAt: string;
+    sessionId: string;
+    sessionTitle: string;
+    turnId: string;
+    provider: string;
+    providerApi: string;
+    model: string;
+    billing: InsightsBillingPath;
+    inputTokens: number | null;
+    outputTokens: number | null;
+    cachedTokens: number | null;
+    cacheWriteTokens: number | null;
+    reasoningTokens: number | null;
+    totalTokens: number | null;
+    creditUsd: number;
+    estimatedProviderUsd: number | null;
+    pricingSource: InsightsPricingSource | null;
+};
 export type WorkspaceInsightsSnapshot = {
     range: InsightsRange;
     rangeLabel: string;
     priorLabel: string;
     seriesLabel: string;
     cacheSeriesLabel: string;
+    windowStart: string;
+    windowEnd: string;
+    generatedAt: string;
     timezone: "UTC";
     models: InsightsModelUsageRow[];
     facets: InsightsModelFacet[];
@@ -3423,6 +4724,7 @@ export type WorkspaceInsightsSnapshot = {
     depth: InsightsDepthBucket[];
     drivers: InsightsSpendDriver[];
     schedules: InsightsScheduleRow[];
+    recentCalls: InsightsModelCallRow[];
     warmSeconds: number;
     priorWarmSeconds: number;
     warmGroups: InsightsWarmGroupRow[];
@@ -3434,7 +4736,13 @@ export type WorkspaceInsightsSnapshot = {
     priorWorkspaceCreditUsd: number;
     creditUsd: number;
     priorCreditUsd: number;
+    estimatedProviderUsd: number;
+    priorEstimatedProviderUsd: number;
+    estimatedProviderCostKnownCalls: number;
+    priorEstimatedProviderCostKnownCalls: number;
+    modelCalls: number;
     priorInputTokens: number;
+    priorTotalTokens: number;
     priorCacheHitPct: number;
     priorCalls: number;
     goalsActive: number;
@@ -3475,6 +4783,7 @@ export type UserMessageEventInput = {
     clientEventId?: string | undefined;
     payload: {
         text: string;
+        annotations?: SubmittedTimelineAnnotation[] | undefined;
         turnInstructions?: string | undefined;
         resources?: ResourceRef[] | undefined;
         model?: string | undefined;
@@ -3574,9 +4883,13 @@ export type RemoveEnrollmentResponse = {
     machineName: string | null;
     lastSeenAt: string | null;
     revokedAt: string | null;
-    code: "active_route" | "active_commands" | "active_lease" | "recovery_pending" | "not_selfhosted" | null;
+    code: "active_route" | "active_commands" | "machine_home" | "active_lease" | "recovery_pending" | "not_selfhosted" | null;
     message: string;
     action: string;
+    dependentSessions: Array<{
+        id: string;
+        title: string | null;
+    }>;
 };
 /** POST /v1/workspaces/:ws/sessions/:sessionId/active-sandbox — swap a session's
  *  active sandbox. `target` is a `MachineView.sandboxId`, or "session"/"default"