@opengeni/sdk 0.52.1 → 1.0.1

package/src/types.ts

@@ -125,6 +125,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 = {
@@ -148,6 +150,7 @@ export type SyncSessionRealtimeLedgerResponse = {
 
 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"
@@ -158,7 +161,7 @@ export type SessionRealtimeModel =
 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;
@@ -282,7 +285,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;
@@ -416,7 +419,7 @@ export type AttachViewerResponse = ViewerHolder & {
   terminalUrl: string | null;
   terminalToken: string | null;
   terminalExpiresAt: string | null;
-  terminalTransport: "pty-ws" | null;
+  terminalTransport: "pty-ws" | "relay-pty" | null;
 };
 
 // Mirror of `@opengeni/contracts` AcknowledgeStreamRequest/Response — the
@@ -527,6 +530,7 @@ export type GoalSpec = {
   text: string;
   successCriteria?: string | undefined;
   maxAutoContinuations?: number | undefined;
+  mutationPolicy?: SessionGoalMutationPolicy | undefined;
 };
 
 export type SessionMcpServerInput = {
@@ -640,6 +644,23 @@ export type OpenGeniSlackBotInstallRequest = {
   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;
@@ -724,8 +745,9 @@ 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. */
@@ -733,8 +755,17 @@ export type GoogleDriveConnectionMetadata = {
   [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 = {
@@ -822,12 +853,18 @@ export type AtlassianConnectionMetadata = {
   selectedSources: AtlassianSelectedSource[];
   [key: string]: unknown;
 };
-export type AtlassianOAuthStartResponse = { authorizationUrl: string; expiresAt: string };
+export type AtlassianOAuthStartResponse = {
+  authorizationUrl: string;
+  expiresAt: string;
+};
 export type AtlassianLifecycleActionRequest = {
   action: "pause" | "resume";
   expectedVersion: number;
 };
-export type AtlassianDisconnectRequest = { expectedVersion: number; idempotencyKey: string };
+export type AtlassianDisconnectRequest = {
+  expectedVersion: number;
+  idempotencyKey: string;
+};
 export type AtlassianBrowseItem = {
   id: string;
   cloudId: string;
@@ -1028,6 +1065,8 @@ export type Session = {
   // rig-less session. Frozen at create; a later rig promote never moves them.
   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[];
@@ -1104,7 +1143,11 @@ export type AgentTopologySession = {
   parentSessionId: string | null;
   rootSessionId: string;
   nestedAgentDepth: number;
-  ancestorPath: Array<{ id: string; title: string | null; titleTruncated: boolean }>;
+  ancestorPath: Array<{
+    id: string;
+    title: string | null;
+    titleTruncated: boolean;
+  }>;
   status: SessionStatus;
   pause: {
     state: "active" | "paused";
@@ -1347,6 +1390,9 @@ export const SESSION_EVENT_TYPES = [
   "artifact.created",
   "goal.set",
   "goal.updated",
+  "goal.progress",
+  "goal.rewrite.proposed",
+  "goal.rewrite.rejected",
   "goal.completed",
   "goal.paused",
   "goal.resumed",
@@ -1386,6 +1432,7 @@ export const SESSION_EVENT_TYPES = [
   "terminal.pty.output.delta",
   "terminal.pty.exited",
   "session.title_set",
+  "session.visibility.changed",
   "session.mcp.approval_policy.updated",
   "session.tool_policy.updated",
   // Multi-account Codex (P1): the session's inference account changed.
@@ -2235,8 +2282,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;
   // Per-session agent persona/system instructions (org-visible metadata, not a
   // secret). Delivered system-level, composed AFTER the per-workspace persona —
   // how a host supplies per-agent-type prompts without leaking them into the
@@ -2354,6 +2401,7 @@ export type FirstPartyMcpToolName =
   | "set_session_title"
   | "goal_set"
   | "goal_update"
+  | "goal_progress"
   | "goal_complete"
   | "goal_pause"
   | "memory_search"
@@ -2361,6 +2409,9 @@ export type FirstPartyMcpToolName =
   | "memory_correct"
   | "preference_registry_summary"
   | "preference_registry_get"
+  | "task_notes_list"
+  | "task_note_save"
+  | "task_note_archive"
   | "sandboxes_list"
   | "sandbox_attach"
   | "sandbox_swap"
@@ -2386,13 +2437,17 @@ export type FirstPartyMcpToolName =
   | "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"
@@ -2442,6 +2497,16 @@ export type FirstPartyMcpToolName =
   | "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"
@@ -2504,7 +2569,7 @@ export type ModelCapabilitiesV1 = {
 
 export type ModelCredentialSourceV1 =
   | { kind: "deployment"; mechanism: "api_key" | "azure_ad_bearer" }
-  | { kind: "connected_subscription"; provider: "codex" }
+  | { kind: "connected_subscription"; provider: "codex" | "xai" }
   | { kind: "workspace_connection"; mechanism: "api_key" };
 
 export type ModelBillingAttributionV1 = {
@@ -2544,7 +2609,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;
@@ -2826,6 +2891,89 @@ export type CodexConnectPoll =
       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";
@@ -2848,7 +2996,7 @@ export type ClientAuthConfig =
 
 // Kept value-identical to @opengeni/contracts and pinned by the SDK contract
 // parity suite. The SDK has no runtime dependency on the Zod contracts package.
-export const OPENGENI_API_CONTRACT_REVISION = "2026-08-social-provider-tools-v1" as const;
+export const OPENGENI_API_CONTRACT_REVISION = "2026-08-model-context-v1" as const;
 export const OPENGENI_API_CONTRACT_HEADER = "x-opengeni-api-contract" as const;
 /** Bounded request/response identifier shared by browser, ingress, and API diagnostics. */
 export const OPENGENI_CORRELATION_HEADER = "x-opengeni-correlation-id" as const;
@@ -2870,6 +3018,13 @@ export type ClientConfig = {
   defaultReasoningEffort: ReasoningEffort;
   allowedReasoningEfforts: ReasoningEffort[];
   mcpServers: { 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 };
   /** Native browser microphone capture + server-side transcription capability. */
   voiceInput?: ClientVoiceInputConfig | undefined;
@@ -3040,6 +3195,17 @@ export type AccessContext = {
   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;
@@ -3063,6 +3229,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;
@@ -3097,6 +3265,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;
@@ -3229,6 +3398,39 @@ 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"
@@ -3272,6 +3474,8 @@ export type SessionGoal = {
   pausedReason: string | null;
   createdBy: SessionGoalCreatedBy;
   version: number;
+  objectiveRevision: number;
+  mutationPolicy: SessionGoalMutationPolicy;
   autoContinuations: number;
   noProgressStreak: number;
   maxAutoContinuations: number | null;
@@ -3282,10 +3486,18 @@ export type SessionGoal = {
   updatedAt: string;
 };
 
-export type UpdateSessionGoalRequest = {
-  status: "paused" | "active";
-  rationale?: string | undefined;
-};
+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;
@@ -3790,6 +4002,36 @@ export type RigVerificationHealth = {
   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;
@@ -4008,7 +4250,10 @@ export type UpdateVideoGenerationPolicyRequest = {
   defaultModelId: string | null;
 };
 
-export type VideoGenerationFundingSource = "opengeni_credits" | "workspace_gateway";
+export type VideoGenerationFundingSource =
+  | "opengeni_credits"
+  | "workspace_gateway"
+  | "supergrok_subscription";
 
 export type VideoGenerationFundingOption = {
   source: VideoGenerationFundingSource;
@@ -4502,10 +4747,10 @@ export type CapabilityPackComponentReference =
     }
   | {
       key: string;
-      kind: "feature";
+      kind: "facet";
       capabilityId: string;
       instanceKey: string;
-      featureKey: string;
+      facetKey: string;
       bindingKey: string;
       configDigest: string;
       required: boolean;
@@ -4591,10 +4836,10 @@ export type RegisterCapabilityPackRequest = {
           }
         | {
             key: string;
-            kind: "feature";
+            kind: "facet";
             capabilityId: string;
             instanceKey: string;
-            featureKey: string;
+            facetKey: string;
             bindingKey: string;
             configDigest: string;
             required?: boolean | undefined;
@@ -4689,7 +4934,7 @@ 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;
@@ -4744,7 +4989,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;
   }>;
@@ -4901,7 +5146,7 @@ export type CapabilityCatalogResponse = {
 
 export type CreateCapabilityCatalogItemRequest = {
   id?: string | undefined;
-  kind: Exclude<CapabilityKind, "pack">;
+  kind: "mcp";
   source?: CapabilitySource | undefined;
   name: string;
   description?: string | undefined;
@@ -4924,14 +5169,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 = {
@@ -4942,6 +5179,8 @@ export type DiscoverMcpCapabilitiesResponse = {
 
 export type SkillImportSource = "github" | "skills_sh";
 
+export type SkillInstallationSource = "library" | "github" | "skills_sh" | "pack";
+
 export type PreviewSkillImportRequest = {
   url: string;
 };
@@ -4977,6 +5216,12 @@ export type InstallSkillRequest = {
   expectedInstallationVersion?: number | undefined;
 };
 
+export type InstallLibrarySkillRequest = {
+  expectedVersion: string;
+  expectedContentSha256: string;
+  expectedInstallationVersion?: number | undefined;
+};
+
 export type InstalledSkill = {
   capabilityId: string;
   pluginId: string;
@@ -4985,7 +5230,8 @@ export type InstalledSkill = {
   pluginInstallationId: string;
   facetInstallationId: string;
   installationVersion: number;
-  source: SkillImportSource;
+  source: SkillInstallationSource;
+  version: string;
   sourceUrl: string;
   sourceCommit: string;
   contentSha256: string;
@@ -4999,6 +5245,34 @@ export type CapabilityComponentOwner = {
   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;
@@ -5019,31 +5293,32 @@ export type UninstallSkillResult = {
 };
 
 export type ApiIntegrationProtocol = "openapi" | "graphql";
+export type IntegrationDefinitionProvenance = "curated" | "workspace";
 
-export type IntegrationFeatureKind =
+export type IntegrationFacetKind =
   | "tools"
   | "knowledge_source"
   | "inbound_trigger"
   | "delivery_destination"
   | "identity_link";
 
-export type IntegrationFeatureStatus = "active" | "paused" | "needs_attention" | "disabled";
+export type IntegrationFacetStatus = "active" | "paused" | "needs_attention" | "disabled";
 
-export type IntegrationFeatureDefinitionSummary = {
-  featureKey: string;
-  kind: Exclude<IntegrationFeatureKind, "tools">;
+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;
@@ -5053,75 +5328,80 @@ export type IntegrationFeatureBindingSummary = {
   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; baseUrl?: string | undefined }
   | { kind: "graphql"; endpoint: string; name?: string | undefined }
   | { kind: "auto"; url: string; 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;
@@ -5149,10 +5429,10 @@ export type ApiIntegrationToolPreview = {
 };
 
 export type ApiIntegrationPreview = {
-  source: ApiIntegrationSource;
-  presetId: string | null;
+  source: IntegrationSource;
+  definitionId: string;
+  definitionProvenance: IntegrationDefinitionProvenance;
   protocol: ApiIntegrationProtocol;
-  integrationId: string;
   capabilityId: string;
   pluginKey: string;
   serverId: string;
@@ -5172,7 +5452,7 @@ export type ApiIntegrationPreview = {
 };
 
 export type InstallApiIntegrationRequest = {
-  source: ApiIntegrationSource;
+  source: IntegrationSource;
   expectedRevisionId: string;
   expectedContentSha256: string;
   connectionId?: string | undefined;
@@ -5214,7 +5494,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;
@@ -5261,7 +5542,7 @@ export type UninstallApiIntegrationResult = {
 
 export type PluginManifestComponent =
   | { key: string; kind: "skill"; url: string }
-  | { key: string; kind: "integration"; source: ApiIntegrationSource }
+  | { key: string; kind: "integration"; source: IntegrationSource }
   | { key: string; kind: "mcp"; serverId: string };
 
 export type PluginManifest = {
@@ -5737,7 +6018,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;