@opengeni/sdk 0.57.0 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (291) hide show
  1. package/README.md +1017 -26
  2. package/dist/accounts.d.ts +153 -0
  3. package/dist/accounts.js +307 -0
  4. package/dist/accounts.js.map +1 -0
  5. package/dist/adapters/express.d.ts +31 -0
  6. package/dist/adapters/express.js +87 -0
  7. package/dist/adapters/express.js.map +1 -0
  8. package/dist/adapters/hono.d.ts +16 -0
  9. package/dist/adapters/hono.js +8 -0
  10. package/dist/adapters/hono.js.map +1 -0
  11. package/dist/adapters/next.d.ts +29 -0
  12. package/dist/adapters/next.js +22 -0
  13. package/dist/adapters/next.js.map +1 -0
  14. package/dist/allowance-refusal.d.ts +2 -0
  15. package/dist/allowance-refusal.js +50 -0
  16. package/dist/allowance-refusal.js.map +1 -0
  17. package/dist/artifact-catalog.d.ts +31 -0
  18. package/dist/artifact-client.d.ts +23 -11
  19. package/dist/artifacts.d.ts +1 -1
  20. package/dist/artifacts.js +7 -5
  21. package/dist/automations-client.d.ts +17 -0
  22. package/dist/automations.d.ts +3 -0
  23. package/dist/automations.js +84 -0
  24. package/dist/automations.js.map +1 -0
  25. package/dist/browser.d.ts +11 -0
  26. package/dist/browser.js +47 -0
  27. package/dist/browser.js.map +1 -0
  28. package/dist/chat/fold.d.ts +75 -0
  29. package/dist/chat/handler.d.ts +41 -0
  30. package/dist/chat/http.d.ts +67 -0
  31. package/dist/chat/ids.d.ts +34 -0
  32. package/dist/chat/index.d.ts +9 -0
  33. package/dist/chat/index.js +1694 -0
  34. package/dist/chat/index.js.map +1 -0
  35. package/dist/chat/openai.d.ts +30 -0
  36. package/dist/chat/opengeni.d.ts +128 -0
  37. package/dist/chat/types.d.ts +207 -0
  38. package/dist/chat/vercel.d.ts +49 -0
  39. package/dist/chats.d.ts +8 -0
  40. package/dist/{chunk-JDLDDRNE.js → chunk-2UXZUCEZ.js} +291 -34
  41. package/dist/chunk-2UXZUCEZ.js.map +1 -0
  42. package/dist/chunk-4SMEOV3P.js +246 -0
  43. package/dist/chunk-4SMEOV3P.js.map +1 -0
  44. package/dist/{chunk-JRPFWI6T.js → chunk-AH5D5Q5V.js} +31 -35
  45. package/dist/chunk-AH5D5Q5V.js.map +1 -0
  46. package/dist/chunk-APXVSSSY.js +301 -0
  47. package/dist/chunk-APXVSSSY.js.map +1 -0
  48. package/dist/chunk-DUVIYER4.js +639 -0
  49. package/dist/chunk-DUVIYER4.js.map +1 -0
  50. package/dist/{chunk-PKQ377ED.js → chunk-FG3OO5LM.js} +2686 -611
  51. package/dist/chunk-FG3OO5LM.js.map +1 -0
  52. package/dist/chunk-GZYZT22T.js +260 -0
  53. package/dist/chunk-GZYZT22T.js.map +1 -0
  54. package/dist/chunk-HMGADJGZ.js +150 -0
  55. package/dist/chunk-HMGADJGZ.js.map +1 -0
  56. package/dist/{chunk-YKZME56C.js → chunk-KWADQ227.js} +3 -3
  57. package/dist/{chunk-YKZME56C.js.map → chunk-KWADQ227.js.map} +1 -1
  58. package/dist/chunk-LY2K6ELJ.js +126 -0
  59. package/dist/chunk-LY2K6ELJ.js.map +1 -0
  60. package/dist/chunk-MOTJYIYL.js +340 -0
  61. package/dist/chunk-MOTJYIYL.js.map +1 -0
  62. package/dist/{chunk-ST5DDKJP.js → chunk-NC57YMUO.js} +121 -3
  63. package/dist/chunk-NC57YMUO.js.map +1 -0
  64. package/dist/chunk-RWKB6YZG.js +1270 -0
  65. package/dist/chunk-RWKB6YZG.js.map +1 -0
  66. package/dist/chunk-U6CV2SXO.js +195 -0
  67. package/dist/chunk-U6CV2SXO.js.map +1 -0
  68. package/dist/chunk-UM4ZXXJR.js +9 -0
  69. package/dist/chunk-UM4ZXXJR.js.map +1 -0
  70. package/dist/chunk-V6GIY62B.js +229 -0
  71. package/dist/chunk-V6GIY62B.js.map +1 -0
  72. package/dist/chunk-WU6GQG25.js +268 -0
  73. package/dist/chunk-WU6GQG25.js.map +1 -0
  74. package/dist/{chunk-VWE2QIVO.js → chunk-XNG7YGR3.js} +23 -6
  75. package/dist/chunk-XNG7YGR3.js.map +1 -0
  76. package/dist/{chunk-HJ3HHUT5.js → chunk-YIKA2QT4.js} +33 -2
  77. package/dist/chunk-YIKA2QT4.js.map +1 -0
  78. package/dist/chunk-ZKPY6YAJ.js +135 -0
  79. package/dist/chunk-ZKPY6YAJ.js.map +1 -0
  80. package/dist/client.d.ts +740 -94
  81. package/dist/codex-realtime-controller.d.ts +3 -0
  82. package/dist/codex-realtime-controller.js +2 -2
  83. package/dist/codex-realtime-v3.d.ts +13 -2
  84. package/dist/company-brain.d.ts +22 -0
  85. package/dist/company-profile.d.ts +14 -1
  86. package/dist/core.d.ts +9 -3
  87. package/dist/core.js +25 -6
  88. package/dist/deprecation.d.ts +47 -0
  89. package/dist/document-authority-client.d.ts +51 -0
  90. package/dist/document-authority.d.ts +2 -0
  91. package/dist/document-authority.js +12 -0
  92. package/dist/document-authority.js.map +1 -0
  93. package/dist/editable-artifacts/browser-session.d.ts +7 -3
  94. package/dist/editable-artifacts/controller.d.ts +4 -1
  95. package/dist/editable-artifacts/errors.d.ts +1 -1
  96. package/dist/editable-artifacts/http-live-transport.d.ts +6 -2
  97. package/dist/editable-artifacts/index.d.ts +2 -0
  98. package/dist/editable-artifacts/open-failure.d.ts +9 -0
  99. package/dist/editable-artifacts/types.d.ts +6 -3
  100. package/dist/editable-artifacts/worker/kernel-adapter.d.ts +1 -1
  101. package/dist/editable-artifacts-worker.js +44 -17
  102. package/dist/editable-artifacts-worker.js.map +1 -1
  103. package/dist/editable-artifacts.js +240 -121
  104. package/dist/editable-artifacts.js.map +1 -1
  105. package/dist/embedding-client.d.ts +129 -0
  106. package/dist/errors.d.ts +36 -1
  107. package/dist/feedback.d.ts +23 -0
  108. package/dist/gateway-realtime-transport.js +1 -1
  109. package/dist/github-repositories.d.ts +10 -0
  110. package/dist/github-repositories.js +36 -0
  111. package/dist/github-repositories.js.map +1 -0
  112. package/dist/index.d.ts +56 -11
  113. package/dist/index.js +242 -125
  114. package/dist/index.js.map +1 -1
  115. package/dist/interaction.d.ts +84 -1
  116. package/dist/interaction.js +6 -1
  117. package/dist/knowledge.d.ts +7 -0
  118. package/dist/knowledge.js +20 -0
  119. package/dist/knowledge.js.map +1 -0
  120. package/dist/message-links.d.ts +68 -0
  121. package/dist/model-context.d.ts +68 -0
  122. package/dist/model-display.d.ts +2 -0
  123. package/dist/model-display.js +15 -0
  124. package/dist/model-display.js.map +1 -0
  125. package/dist/model-picker-order.d.ts +1 -0
  126. package/dist/model-picker-order.js +10 -0
  127. package/dist/model-picker-order.js.map +1 -0
  128. package/dist/organization-integration-policy.d.ts +26 -0
  129. package/dist/organization-integration-policy.js +26 -0
  130. package/dist/organization-integration-policy.js.map +1 -0
  131. package/dist/organization-private-session-settings.d.ts +6 -0
  132. package/dist/organization-private-session-settings.js +22 -0
  133. package/dist/organization-private-session-settings.js.map +1 -0
  134. package/dist/organization-user-setup.d.ts +8 -0
  135. package/dist/organization-user-setup.js +16 -0
  136. package/dist/organization-user-setup.js.map +1 -0
  137. package/dist/pr-review-client.d.ts +16 -0
  138. package/dist/pr-review.d.ts +4 -0
  139. package/dist/pr-review.js +62 -0
  140. package/dist/pr-review.js.map +1 -0
  141. package/dist/preference-registry.d.ts +9 -1
  142. package/dist/proxy.d.ts +7 -5
  143. package/dist/realtime.d.ts +3 -1
  144. package/dist/realtime.js +6 -6
  145. package/dist/realtime.js.map +1 -1
  146. package/dist/retained-artifacts.d.ts +5 -1
  147. package/dist/session-history-import.d.ts +22 -0
  148. package/dist/session-history-import.js +36 -0
  149. package/dist/session-history-import.js.map +1 -0
  150. package/dist/session-list-entries.d.ts +1 -0
  151. package/dist/session-list-entries.js +7 -0
  152. package/dist/session-list-entries.js.map +1 -0
  153. package/dist/session-message-search.d.ts +53 -0
  154. package/dist/session-proxy-client.d.ts +24 -0
  155. package/dist/session-proxy.d.ts +245 -0
  156. package/dist/session-proxy.js +24 -0
  157. package/dist/session-proxy.js.map +1 -0
  158. package/dist/session-titles.d.ts +2 -0
  159. package/dist/site-browser-entry.d.ts +1 -0
  160. package/dist/site-browser-runtime.gen.d.ts +1 -0
  161. package/dist/site-document.d.ts +5 -0
  162. package/dist/site-document.js +20 -0
  163. package/dist/site-document.js.map +1 -0
  164. package/dist/site-document.test.d.ts +1 -0
  165. package/dist/site-http.d.ts +16 -0
  166. package/dist/site-tool-bridge.d.ts +44 -0
  167. package/dist/site.d.ts +101 -0
  168. package/dist/site.js +49 -0
  169. package/dist/site.js.map +1 -0
  170. package/dist/skills.d.ts +75 -0
  171. package/dist/stream.d.ts +2 -0
  172. package/dist/tenant-workspaces.d.ts +47 -0
  173. package/dist/tenant-workspaces.js +8 -0
  174. package/dist/tenant-workspaces.js.map +1 -0
  175. package/dist/tool-auth.d.ts +87 -0
  176. package/dist/tool-auth.js +23 -0
  177. package/dist/tool-auth.js.map +1 -0
  178. package/dist/tool-display-metadata.d.ts +3 -0
  179. package/dist/tools-FXBLUWAE.js +12 -0
  180. package/dist/tools-FXBLUWAE.js.map +1 -0
  181. package/dist/tools.d.ts +61 -0
  182. package/dist/types.d.ts +2863 -424
  183. package/dist/usage-allowances.d.ts +36 -0
  184. package/dist/usage-allowances.js +80 -0
  185. package/dist/usage-allowances.js.map +1 -0
  186. package/dist/workspace-artifacts.d.ts +33 -5
  187. package/dist/workspace-instruction-policies.d.ts +24 -2
  188. package/dist/workspace-integrations.d.ts +74 -0
  189. package/dist/workspace-integrations.js +65 -0
  190. package/dist/workspace-integrations.js.map +1 -0
  191. package/dist/workspace-learning.d.ts +124 -0
  192. package/dist/workspace-state.d.ts +8 -71
  193. package/package.json +108 -3
  194. package/src/accounts.ts +443 -0
  195. package/src/adapters/express.ts +136 -0
  196. package/src/adapters/hono.ts +18 -0
  197. package/src/adapters/next.ts +42 -0
  198. package/src/allowance-refusal.ts +5 -0
  199. package/src/artifact-catalog.ts +41 -0
  200. package/src/artifact-client.ts +43 -52
  201. package/src/artifacts.ts +7 -1
  202. package/src/automations-client.ts +124 -0
  203. package/src/automations.ts +15 -0
  204. package/src/browser.ts +54 -0
  205. package/src/chat/fold.ts +431 -0
  206. package/src/chat/handler.ts +240 -0
  207. package/src/chat/http.ts +257 -0
  208. package/src/chat/ids.ts +85 -0
  209. package/src/chat/index.ts +87 -0
  210. package/src/chat/openai.ts +439 -0
  211. package/src/chat/opengeni.ts +722 -0
  212. package/src/chat/types.ts +219 -0
  213. package/src/chat/vercel.ts +204 -0
  214. package/src/chats.ts +16 -0
  215. package/src/client.ts +4084 -515
  216. package/src/codex-realtime-controller.ts +235 -5
  217. package/src/codex-realtime-v3.ts +162 -31
  218. package/src/codex-realtime.ts +1 -1
  219. package/src/company-brain.ts +59 -0
  220. package/src/company-profile.ts +17 -1
  221. package/src/core.ts +23 -1
  222. package/src/deprecation.ts +149 -0
  223. package/src/document-authority-client.ts +219 -0
  224. package/src/document-authority.ts +17 -0
  225. package/src/editable-artifacts/browser-session.ts +36 -22
  226. package/src/editable-artifacts/controller.ts +102 -47
  227. package/src/editable-artifacts/errors.ts +2 -0
  228. package/src/editable-artifacts/http-live-transport.ts +62 -37
  229. package/src/editable-artifacts/index.ts +6 -0
  230. package/src/editable-artifacts/open-failure.ts +79 -0
  231. package/src/editable-artifacts/storage.ts +31 -40
  232. package/src/editable-artifacts/types.ts +6 -3
  233. package/src/editable-artifacts/worker/kernel-adapter.ts +23 -7
  234. package/src/editable-artifacts/worker/runtime.ts +26 -13
  235. package/src/editable-artifacts/worker/wire-codec.ts +23 -5
  236. package/src/embedding-client.ts +519 -0
  237. package/src/errors.ts +169 -2
  238. package/src/feedback.ts +20 -0
  239. package/src/gateway-realtime-transport.ts +3 -3
  240. package/src/github-repositories.ts +60 -0
  241. package/src/index.ts +561 -41
  242. package/src/interaction.ts +276 -4
  243. package/src/knowledge.ts +72 -0
  244. package/src/message-links.ts +178 -0
  245. package/src/model-context.ts +112 -0
  246. package/src/model-display.ts +10 -0
  247. package/src/model-picker-order.ts +6 -0
  248. package/src/organization-integration-policy.ts +54 -0
  249. package/src/organization-private-session-settings.ts +33 -0
  250. package/src/organization-user-setup.ts +31 -0
  251. package/src/pr-review-client.ts +92 -0
  252. package/src/pr-review.ts +17 -0
  253. package/src/preference-registry.ts +11 -0
  254. package/src/proxy.ts +17 -6
  255. package/src/realtime.ts +1 -0
  256. package/src/retained-artifacts.ts +101 -0
  257. package/src/session-history-import.ts +84 -0
  258. package/src/session-list-entries.ts +1 -0
  259. package/src/session-message-search.ts +47 -0
  260. package/src/session-proxy-client.ts +64 -0
  261. package/src/session-proxy.ts +1473 -0
  262. package/src/session-titles.ts +10 -0
  263. package/src/site-browser-entry.ts +6 -0
  264. package/src/site-browser-runtime.gen.ts +2 -0
  265. package/src/site-document.test.ts +64 -0
  266. package/src/site-document.ts +18 -0
  267. package/src/site-http.ts +162 -0
  268. package/src/site-tool-bridge.ts +146 -0
  269. package/src/site.ts +585 -0
  270. package/src/skills.ts +69 -0
  271. package/src/sse.ts +8 -2
  272. package/src/stream.ts +38 -4
  273. package/src/tenant-workspaces.ts +148 -0
  274. package/src/tool-auth.ts +301 -0
  275. package/src/tool-display-metadata.ts +19 -0
  276. package/src/tools.ts +396 -0
  277. package/src/types.ts +3346 -501
  278. package/src/usage-allowances.ts +189 -0
  279. package/src/workspace-artifacts.ts +40 -6
  280. package/src/workspace-instruction-policies.ts +26 -1
  281. package/src/workspace-integrations.ts +402 -0
  282. package/src/workspace-learning.ts +138 -0
  283. package/src/workspace-state.ts +8 -82
  284. package/dist/chunk-GU6JF75T.js +0 -119
  285. package/dist/chunk-GU6JF75T.js.map +0 -1
  286. package/dist/chunk-HJ3HHUT5.js.map +0 -1
  287. package/dist/chunk-JDLDDRNE.js.map +0 -1
  288. package/dist/chunk-JRPFWI6T.js.map +0 -1
  289. package/dist/chunk-PKQ377ED.js.map +0 -1
  290. package/dist/chunk-ST5DDKJP.js.map +0 -1
  291. package/dist/chunk-VWE2QIVO.js.map +0 -1
package/dist/client.d.ts CHANGED
@@ -1,14 +1,76 @@
1
+ import type { ClaudeSubscriptionAccountsResponse, ClaudeSubscriptionAccount, ClaudeSubscriptionOAuthStartRequest, ClaudeSubscriptionSetupTokenRequest, SubscriptionPoolSettings } from "@opengeni/contracts";
2
+ import type { ArtifactCatalogListOptions, ArtifactCatalogListResponse } from "./artifact-catalog.js";
3
+ import type { SessionMessageSearchRequest, SessionMessageSearchResponse, SessionMessagePreview, SessionMessagePreviewReference } from "./session-message-search.js";
4
+ import type { KnowledgeOriginalFileDownload, AgentLearningContext, AgentLearningSettingsRecord, AgentLearningOverrideRecord, SaveAgentLearningSettingsRequest, KnowledgeEntryListRequest, KnowledgeEntryListResponse, KnowledgeReviewBatchListRequest, KnowledgeReviewBatchListResponse, KnowledgeEntryRecord, KnowledgeEntrySaveRequest, KnowledgeEntryWriteReceipt, KnowledgeEntryReviewRequest, KnowledgeEntryBatchReviewRequest, KnowledgeEntryRestoreRequest, AgentInstructionReviewRequest, AgentInstructionReceipt, AgentInstructionReviewListResponse } from "./knowledge.js";
5
+ import type { RollbackWorkspaceArtifactRequest, SetWorkspaceArtifactStatusRequest, WorkspaceArtifactDetailResponse, WorkspaceArtifactListOptions, WorkspaceArtifactListResponse, WorkspaceArtifactMutationResponse } from "./workspace-artifacts.js";
6
+ import type { CreateFeedbackRequest, Feedback, FeedbackSubmissionResponse } from "./feedback.js";
7
+ import type { CreateWorkspaceWebhookRequest, CreateWorkspaceWebhookResponse, GetWorkspaceCredentialProviderResponse, ListWorkspaceWebhookDeliveriesResponse, ListWorkspaceWebhooksResponse, PutWorkspaceCredentialProviderRequest, PutWorkspaceCredentialProviderResponse, UpdateWorkspaceWebhookRequest, WorkspaceSandboxImages, WorkspaceWebhook, WorkspaceWebhookDelivery } from "./workspace-integrations.js";
8
+ import type { OpenGeniToolsFacade } from "./tools.js";
1
9
  import { type SessionEventStreamTransport, type StreamSessionEventsOptions } from "./stream.js";
10
+ import type { SessionModelContextResponse } from "./model-context.js";
11
+ import { type OpenGeniDeprecationHandler } from "./deprecation.js";
12
+ import type { SkillRecord, SkillSummary, SkillWriteReceipt, SaveWorkspaceSkillRequest, RemoveWorkspaceSkillRequest, ApplyWorkspaceSkillRevisionRequest } from "./skills.js";
2
13
  import { type WorkspaceControlStreamTransport } from "./workspace-control-stream.js";
3
14
  import { type WorkspaceInteractionRevisionStreamTransport } from "./interaction-revision-stream.js";
4
15
  import { type WorkspaceLiveStreamOptions, type WorkspaceLiveStreamTransport } from "./workspace-live-stream.js";
5
- import { OpenGeniInteractionClient, type AuthRun, type AuthRunListOptions, type AuthRunListResponse, type AuthRunMutationResponse, type AttachedBrowserDevice, type AttachedBrowserDeviceListOptions, type AttachedBrowserDeviceListResponse, type BrowserActionReceipt, type BrowserActionRequest, type BrowserClipboard, type BrowserDiagnosticBatch, type BrowserDiagnosticsOptions, type BrowserDownload, type BrowserDownloadListResponse, type BrowserDownloadSaveRequest, type BrowserDownloadSaveResponse, type BrowserIdentity, type BrowserIdentityListOptions, type BrowserIdentityListResponse, type BrowserIdentityMutationResponse, type BrowserObservation, type BrowserOpenTargetRequest, type BrowserSession, type BrowserSessionAttachment, type BrowserSessionAttachmentRequest, type BrowserSessionHeartbeatResponse, type BrowserSessionLifecycleRequest, type BrowserSessionListResponse, type BrowserSessionMutationResponse, type BrowserTargetListResponse, type BrowserRevisionListResponse, type ComputerActionReceipt, type ComputerActionRequest, type ComputerClipboard, type ComputerObservation, type ComputerSession, type ComputerSessionAttachment, type ComputerSessionAttachmentRequest, type ComputerSessionHeartbeatResponse, type ComputerSessionLifecycleRequest, type ComputerSessionListResponse, type ComputerSessionMutationResponse, type ComputerTargetListResponse, type CreateBrowserIdentityRequest, type CreateBrowserSessionRequest, type CreateComputerSessionRequest, type CreateInteractionInterventionRequest, type CreateNetworkRouteRequest, type CreateSiteAuthConnectionRequest, type ExternalAuthInteractiveRequest, type ExternalAuthInteractiveResponse, type ExternalAuthRunRequest, type ExternalAuthRunResponse, type InteractionIntervention, type InteractionInterventionListOptions, type InteractionInterventionListResponse, type InteractionInterventionMutationResponse, type NetworkRoute, type NetworkRouteListOptions, type NetworkRouteListResponse, type NetworkRouteMutationResponse, type ProtectedAuthFillRequest, type ProtectedAuthFillResponse, type PublishBrowserRevisionRequest, type PublishBrowserRevisionResponse, type ReportAuthRunRequest, type ResolveInteractionInterventionRequest, type SiteAuthConnection, type SiteAuthConnectionListOptions, type SiteAuthConnectionListResponse, type SiteAuthConnectionMutationResponse, type StartAuthRunRequest, type UpdateNetworkRouteRequest, type UpdateBrowserIdentityRequest, type UpdateSiteAuthConnectionRequest, type VerifyAuthRunRequest, type WorkspaceInteractionRevisionEvent } from "./interaction.js";
6
- import type { AccessContext, ActivateCodexRealtimeConnectionRequest, AddWorkspaceMemberRequest, ApiKey, BillingEntitlementsResponse, CodexAccount, CodexAccountsResponse, CodexAppsUpdate, CodexRotationSettings, CodexOverviewResponse, CodexAllocatorUpdate, CodexConnectionStatus, CodexRealtimeWebrtcRequest, CodexRealtimeWebrtcResponse, GatewayRealtimeConnectRequest, GatewayRealtimeConnectResponse, CodexConnectPoll, CodexConnectStart, CodexUsage, CodexUsageMap, SuperGrokAccount, SuperGrokAccountsResponse, SuperGrokAccountScope, SuperGrokAllocatorUpdate, SuperGrokConnectionStatus, SuperGrokConnectPoll, SuperGrokConnectStart, SuperGrokRotationSettings, BillingSummary, BillingUsageResponse, InsightsRange, WorkspaceInsightsResponse, BeginSessionRealtimeRequest, CapabilityCatalogItem, CapabilityCatalogResponse, CapabilityInstallation, ApiIntegrationPreview, ApiIntegrationOAuthStartRequest, ApiIntegrationUninstallPreview, InstallApiIntegrationRequest, InstalledApiIntegration, IntegrationFacetMutationResult, IntegrationFacetRemovalResult, IntegrationInstanceFacetsResponse, ListIntegrationDefinitionsResponse, ListApiIntegrationsResponse, MutateIntegrationFacetRequest, PreviewApiIntegrationRequest, UninstallApiIntegrationRequest, UninstallApiIntegrationResult, UpsertIntegrationFacetRequest, PreviewPluginRequest, PluginPreview, InstallPluginRequest, InstalledPlugin, ListInstalledPluginsResponse, PluginUninstallPreview, UninstallPluginRequest, UninstallPluginResult, AddDocumentRequest, CreateKnowledgeDropRequest, MoveDocumentRequest, ClientConfig, WorkspaceModelCatalogResponse, WorkspaceRealtimeModelCatalogResponse, ClientSessionEventInput, CompactSessionContextResult, ConnectionMetadata, CreateApiKeyRequest, CreateApiKeyResponse, CreateCapabilityCatalogItemRequest, InstallSkillRequest, InstallLibrarySkillRequest, InstalledSkill, ListInstalledSkillsResponse, CreateCheckoutRequest, CreateCheckoutResponse, OpenGeniSlackBotInstallRequest, OpenGeniSlackBotInstallStart, SlackReactionChannelListResponse, FikenInstallRequest, FikenOAuthStartRequest, FikenOAuthStartResponse, CreateConnectionRequest, CreateDocumentBaseRequest, CreateFileUploadRequest, CreateFileUploadResponse, CreateGitHubAppManifestRequest, CreateGitHubAppManifestResponse, CreateKnowledgeMemoryRequest, CreateScheduledTaskRequest, CreateSessionRequest, CreateSessionResponse, CreateVariableSetRequest, CreateRigRequest, CreateWorkspaceRequest, DeviceEnrollmentApproveResponse, DeviceEnrollmentDenyResponse, DeviceEnrollmentLookupResponse, MintEnrollTokenResponse, EndSessionRealtimeRequest, DiscoverMcpCapabilitiesResponse, Document, DocumentBase, DocumentSearchRequest, DocumentSearchResponse, EnableCapabilityRequest, EnablePackRequest, FileAsset, FileDownloadUrlResponse, GetPackResponse, GitHubAppInfo, GitHubRepositoriesResponse, GoogleDriveBrowseResponse, GoogleDriveDisconnectRequest, SaveGoogleDriveIntegrationSourceRequest, GoogleDriveLifecycleActionRequest, KnowledgeMemory, KnowledgeMemorySearchRequest, ListManagedOrganizationMembershipsResponse, ListPacksResponse, MachinesResponse, MetricSample, RemoveEnrollmentRequest, RemoveEnrollmentResponse, SwapActiveSandboxRequest, SwapActiveSandboxResponse, InstallPackRequest, PackInstallationPreview, PrepareSlackUserLinkAccessRequest, SlackUserLinkAccessMutationRequest, SlackUserLinkAccessRequest, ApproveSlackUserLinkAccessRequest, PackInstallation, PackUninstallPreview, LatencyMode, ReasoningEffort, RetainedScreenshotDownload, RetainedScreenshotDownloadOptions, RetainedArtifactDownload, RetainedArtifactDownloadOptions, RetainedArtifactReference, RetainedArtifactContent, RetainedArtifactContentOptions, RetainedArtifactMetadata, UpdateVideoGenerationPolicyRequest, VideoArtifactPlaybackSource, VideoGenerationOperationSummary, VideoGenerationPolicy, WorkspaceVideoGenerationSettings, RegisterCapabilityPackRequest, ResourceRef, PreviewPackInstallationRequest, PreviewSkillImportRequest, ScheduledTask, ScheduledTaskRun, Session, SessionListResponse, AgentTopologyPageResponse, UpdateSessionChannelRequest, UpdateSessionPinRequest, UninstallPackRequest, UninstallPackResult, SessionEvent, SessionEventCompactResult, SessionEventCompactResultOptions, SessionEventListOptions, SessionEventPage, SessionGoal, SessionGoalRevision, SessionHumanInputRequest, SessionLineageResponse, SessionRealtimeMutationResponse, SyncSessionRealtimeLedgerRequest, SyncSessionRealtimeLedgerResponse, RenewSessionRealtimeRequest, SessionMcpCredentialUpdateInput, SubmittedTimelineAnnotation, UpdateSessionMcpApprovalPolicyRequest, UpdateSessionMcpApprovalPolicyResponse, SessionQueueSnapshot, SessionQueueMutationResponse, ComposerDraft, DeleteSessionQueueItemRequest, EditSessionQueueItemRequest, MoveSessionQueueItemRequest, NewSessionDraft, SaveComposerDraftRequest, SaveNewSessionDraftRequest, SteerSessionQueueItemRequest, SessionControlResponse, WorkspaceInferenceControlResponse, WorkspaceControlEvent, SessionTurn, SubmitHumanInputResponseRequest, SessionCapabilities, AttachViewerRequest, AttachViewerResponse, AcknowledgeStreamRequest, AcknowledgeStreamResponse, ViewerHeartbeatRequest, ViewerHeartbeatResponse, FsListRequest, FsListResponse, FsListBatchRequest, FsListBatchResponse, FsReadRequest, FsReadResponse, FsWriteRequest, FsWriteResponse, FsDeleteRequest, FsDeleteResponse, FsMoveRequest, FsMoveResponse, FsMkdirRequest, FsMkdirResponse, GitStatusRequest, GitStatusResponse, GitDiffRequest, GitDiffResponse, GitReadBatchRequest, GitReadBatchResponse, GitLogRequest, GitLogResponse, GitShowRequest, GitShowResponse, GetWorkspaceCaptureResponse, GetWorkspaceCaptureFileResponse, TerminalExecRequest, TerminalExecResponse, PtyOpenRequest, PtyOpenResponse, PtyWriteRequest, PtyResizeRequest, PtyCloseRequest, ToolRef, TranscribeAudioResponse, TranscriptionRecordingListResponse, TranscriptionRecordingResponse, UploadTranscriptionRecordingChunkResponse, UpdateConnectionRequest, UpdateKnowledgeMemoryRequest, UpdateScheduledTaskRequest, UpdateSessionGoalRequest, ApplySessionGoalRevisionRequest, UpdateSessionRequest, UpdateSessionToolPolicyRequest, UpdateVariableSetRequest, UpdateRigRequest, UpdateWorkspaceMemberRequest, UpdateWorkspaceRequest, UpdateWorkspaceSettingsRequest, SetWorkspaceDefaultRigRequest, UploadFileInput, VariableSet, VariableSetSecret, VariableSetVariableMetadata, Channel, CreateChannelRequest, UpdateChannelRequest, Rig, RigVersion, RigChange, ProposeRigChangeRequest, WorkspaceMember, WorkspaceMemorySearchRequest, WorkspaceMemorySearchResponse, WorkspaceRegisteredPack, Workspace, SlackInstallationBinding, OAuthStartRequest, OAuthStartResponse, SocialConnection, SocialOAuthStartRequest, SkillImportPreview, SkillUninstallPreview, UninstallSkillRequest, UninstallSkillResult } from "./types.js";
16
+ import { OpenGeniInteractionClient, type AuthRun, type AuthRunListOptions, type AuthRunListResponse, type AuthRunMutationResponse, type AttachedBrowserDevice, type AttachedBrowserDeviceListOptions, type AttachedBrowserDeviceListResponse, type BrowserActionReceipt, type BrowserActionRequest, type BrowserScreenshotOptions, type BrowserClipboard, type BrowserDiagnosticBatch, type BrowserDomReadRequest, type BrowserDomReadResponse, type BrowserDiagnosticsOptions, type BrowserDownload, type BrowserDownloadListResponse, type BrowserDownloadSaveRequest, type BrowserDownloadSaveResponse, type BrowserIdentity, type BrowserIdentityListOptions, type BrowserIdentityListResponse, type BrowserIdentityMutationResponse, type BrowserObservation, type BrowserFrame, type BrowserOpenTargetRequest, type BrowserSession, type BrowserSessionAttachment, type BrowserSessionAttachmentRequest, type BrowserSessionHeartbeatResponse, type BrowserSessionLifecycleRequest, type BrowserSessionListResponse, type BrowserSessionMutationResponse, type BrowserTargetState, type BrowserTargetListResponse, type BrowserRevisionListResponse, type ComputerActionReceipt, type ComputerActionRequest, type ComputerClipboard, type ComputerFrame, type ComputerObservation, type ComputerSession, type ComputerSessionAttachment, type ComputerSessionAttachmentRequest, type ComputerSessionHeartbeatResponse, type ComputerSessionInputPosture, type ComputerSessionLifecycleRequest, type ComputerSessionListResponse, type ComputerSessionMutationResponse, type ComputerTargetListResponse, type CreateBrowserIdentityRequest, type CreateBrowserSessionRequest, type CreateComputerSessionRequest, type CreateInteractionInterventionRequest, type CreateNetworkRouteRequest, type CreateSiteAuthConnectionRequest, type ExternalAuthInteractiveRequest, type ExternalAuthInteractiveResponse, type ExternalAuthRunRequest, type ExternalAuthRunResponse, type InteractionIntervention, type InteractionInterventionListOptions, type InteractionInterventionListResponse, type InteractionInterventionMutationResponse, type NetworkRoute, type NetworkRouteListOptions, type NetworkRouteListResponse, type NetworkRouteMutationResponse, type ProtectedAuthFillRequest, type ProtectedAuthFillResponse, type PublishBrowserRevisionRequest, type PublishBrowserRevisionResponse, type ReportAuthRunRequest, type ResolveInteractionInterventionRequest, type SiteAuthConnection, type SiteAuthConnectionListOptions, type SiteAuthConnectionListResponse, type SiteAuthConnectionMutationResponse, type StartAuthRunRequest, type UpdateNetworkRouteRequest, type UpdateBrowserIdentityRequest, type UpdateSiteAuthConnectionRequest, type VerifyAuthRunRequest, type WorkspaceInteractionRevisionEvent } from "./interaction.js";
17
+ import type { AccessContext, ActivateCodexRealtimeConnectionRequest, AddWorkspaceMemberRequest, ApiKey, BillingEntitlementsResponse, CodexAccount, CodexAccountsResponse, SessionCodexAccountsResponse, CodexAppsUpdate, CodexRotationSettings, CodexOverviewResponse, CodexAllocatorUpdate, CodexConnectionStatus, CodexRealtimeWebrtcRequest, CodexRealtimeWebrtcResponse, GatewayRealtimeConnectRequest, GatewayRealtimeConnectResponse, CodexConnectPoll, CodexConnectStart, CodexUsage, CodexUsageMap, ModelConnectionAccessPolicy, ModelConnectionAccessResponse, SuperGrokAccount, SuperGrokAccountsResponse, SuperGrokAccountScope, SuperGrokAllocatorUpdate, SuperGrokConnectionStatus, SuperGrokConnectPoll, SuperGrokConnectStart, SuperGrokRotationSettings, BillingSummary, BillingUsageResponse, InsightsRange, WorkspaceInsightsResponse, BeginSessionRealtimeRequest, CapabilityCatalogItem, CapabilityCatalogResponse, ConnectorToolPermissionsResponse, UpdateConnectorToolPermissionsRequest, CapabilityInstallation, ApiIntegrationPreview, ApiIntegrationOAuthStartRequest, ApiIntegrationUninstallPreview, InstallApiIntegrationRequest, InstalledApiIntegration, IntegrationFacetMutationResult, IntegrationFacetRemovalResult, IntegrationInstanceFacetsResponse, ListIntegrationDefinitionsResponse, ListApiIntegrationsResponse, MutateIntegrationFacetRequest, PreviewApiIntegrationRequest, UninstallApiIntegrationRequest, UninstallApiIntegrationResult, UpsertIntegrationFacetRequest, PreviewPluginRequest, PluginPreview, InstallPluginRequest, InstalledPlugin, ListInstalledPluginsResponse, PluginUninstallPreview, UninstallPluginRequest, UninstallPluginResult, AddDocumentRequest, CreateKnowledgeDropRequest, MoveDocumentRequest, ClientConfig, WorkspaceModelAccessPolicy, WorkspaceModelCatalogResponse, WorkspaceGatewayCustomModel, WorkspaceGatewayCustomModelsResponse, CreateWorkspaceGatewayCustomModelRequest, DeleteWorkspaceGatewayCustomModelRequest, WorkspaceOpenRouterCustomModel, WorkspaceOpenRouterCustomModelsResponse, CreateWorkspaceOpenRouterCustomModelRequest, DeleteWorkspaceOpenRouterCustomModelRequest, OrganizationModelProviderKind, ClaudeSubscriptionUsage, ClaudeSubscriptionOAuthStartResponse, ClaudeSubscriptionOAuthCompleteRequest, ClaudeSubscriptionOAuthCompleteResponse, OrganizationModelProviderConnection, UpsertOrganizationModelProviderConnectionRequest, RevokeOrganizationModelProviderConnectionRequest, OrganizationProviderCustomModel, OrganizationProviderCustomModelsResponse, CreateOrganizationProviderCustomModelRequest, DeleteOrganizationProviderCustomModelRequest, WorkspaceRealtimeModelCatalogResponse, ClientSessionEventInput, UserMessageEventInput, CompactSessionContextResult, ConnectionMetadata, PersonalGitHubConnectionStatusResponse, PersonalGitHubDisconnectRequest, PersonalGitHubOAuthStartRequest, PersonalGitHubOAuthStartResponse, ListPersonalGitHubRepositoriesOptions, ListPersonalGitHubRepositoriesResponse, PersonalGitHubRepositorySelectionState, ReplacePersonalGitHubRepositorySelectionsRequest, VerifyPersonalGitHubRepositorySelectionsRequest, CreateApiKeyRequest, CreateApiKeyResponse, CreateOrganizationApiKeyRequest, OrganizationMcpConnection, OrganizationMcpConnectionList, OrganizationServiceAccount, ListOrganizationServiceAccountsResponse, CreateOrganizationServiceAccountRequest, UpdateOrganizationServiceAccountRequest, UpdateOrganizationMcpConnectionRequest, McpConnectionRequest, McpConnectionDecision, CreateCapabilityCatalogItemRequest, InstallSkillRequest, InstallLibrarySkillRequest, InstalledSkill, ListInstalledSkillsResponse, CreateBillingPortalRequest, CreateBillingPortalResponse, CreateCheckoutRequest, BillingCheckoutStatus, CreateCheckoutResponse, OpenGeniSlackBotInstallRequest, OpenGeniSlackBotInstallStart, SlackChannelRouteListResponse, SlackReactionChannelListResponse, UpdateSlackChannelRoutesRequest, FikenInstallRequest, FikenOAuthStartRequest, FikenOAuthStartResponse, CreateConnectionRequest, CreateDocumentBaseRequest, CreateFileUploadRequest, CreateFileUploadResponse, CreateGitHubAppManifestRequest, CreateGitHubAppManifestResponse, CreateScheduledTaskRequest, CreateSessionRequest, CreateSessionResponse, CreateVariableSetRequest, ResolveVariableSetAttachmentsRequest, ResolveVariableSetAttachmentsResponse, CreateRigRequest, CreateWorkspaceRequest, EnsureWorkspaceRequest, EnsureWorkspaceResponse, DeviceEnrollmentApproveRequest, DeviceEnrollmentApproveResponse, DeviceEnrollmentDenyResponse, DeviceEnrollmentLookupResponse, MintEnrollTokenResponse, EndSessionRealtimeRequest, DiscoverMcpCapabilitiesResponse, Document, DocumentBase, EnableCapabilityRequest, FileAsset, FileDownloadUrlResponse, GitHubActionPoliciesResponse, GitHubActionPolicyActorState, GitHubAppInfo, GitHubRepositoriesResponse, GoogleDriveBrowseResponse, GoogleDriveDisconnectRequest, SaveGoogleDriveIntegrationSourceRequest, GoogleDriveLifecycleActionRequest, ListOrganizationSessionsOptions, ListManagedOrganizationMembershipsResponse, ListUserResourceAuthoritiesOptions, ListUserResourceAuthoritiesResponse, UpdateGitHubActionPolicyRequest, RevokeUserResourceGrantResponse, ListOrganizationInvitationsPageResponse, ListOrganizationAdministrationMembersResponse, AcceptOrganizationInvitationRequest, AcceptOrganizationInvitationResponse, AcceptOrganizationRecoveryCustodyRequest, ConfigureOrganizationRecoveryPolicyRequest, CreateOrganizationInvitationRequest, CreateAdditionalOrganizationRequest, CreateAdditionalOrganizationResponse, CreateOrganizationRequest, CreateOrganizationResponse, CreateOrganizationWorkspaceRequest, OrganizationInvitation, OrganizationAdministrationOverview, OrganizationMember, OrganizationRecoveryMutationResponse, OrganizationRecoveryOperationCommandRequest, OrganizationRecoveryOverview, OrganizationSessionListResponse, OrganizationWorkspaceAccess, OrganizationWorkspaceAccessMember, OrganizationRetentionPolicy, OrganizationSummary, RevokeOrganizationInvitationRequest, RevokeOrganizationWorkspaceMemberRequest, RevokeOrganizationWorkspaceMemberResponse, PutOrganizationWorkspaceMemberRequest, UpdateOrganizationMemberRequest, UpdateOrganizationNameRequest, DisableOrganizationRecoveryPolicyRequest, StartOrganizationRecoveryOperationRequest, UpdateOrganizationWorkspaceRequest, UpdateOrganizationRetentionPolicyRequest, MachinesResponse, MetricSample, RemoveEnrollmentRequest, RemoveEnrollmentResponse, MachineOperationPolicy, UpdateMachineOperationPolicyRequest, UpdateMachineAgentResponse, SwapActiveSandboxRequest, SwapActiveSandboxResponse, PrepareSlackUserLinkAccessRequest, SlackUserLinkAccessMutationRequest, SlackUserLinkAccessRequest, ApproveSlackUserLinkAccessRequest, RetainedScreenshotDownload, RetainedScreenshotDownloadOptions, RetainedArtifactDownload, RetainedArtifactDownloadOptions, RetainedArtifactReference, RetainedArtifactContent, RetainedArtifactContentOptions, RetainedArtifactMetadata, UpdateVideoGenerationPolicyRequest, VideoArtifactPlaybackSource, VideoGenerationOperationSummary, VideoGenerationPolicy, WorkspaceVideoGenerationSettings, PreviewSkillImportRequest, ScheduledTask, ScheduledTaskAccessAttention, ScheduledTaskRun, ForkSessionRequest, ForkSessionResponse, Session, SessionStatus, WorkClaimSubjectType, SessionBackgroundCommandListResponse, CancelSessionBackgroundCommandResult, SessionListResponse, SessionListEntryResponse, SessionTenancyCreateCapabilities, AgentTopologyPageResponse, UpdateSessionChannelRequest, UpdateSessionAttentionRequest, UpdateSessionArchiveRequest, UpdateSessionPinRequest, UpdateSessionVisibilityRequest, UpdateSessionVisibilityResponse, SessionScopeSubjectId, SessionEvent, SessionEventCompactResult, SessionEventCompactResultOptions, SessionEventListOptions, SessionEventPage, SessionGoal, SessionGoalRevision, ListSessionGoalRevisionsOptions, ListSessionGoalRevisionsResponse, RejectSessionGoalRevisionRequest, RejectSessionGoalRevisionResponse, RollbackSessionGoalRevisionRequest, SessionHumanInputRequest, SessionLineageResponse, SessionRealtimeMutationResponse, SyncSessionRealtimeLedgerRequest, SyncSessionRealtimeLedgerResponse, RenewSessionRealtimeRequest, UpdateSessionMcpApprovalPolicyRequest, UpdateSessionMcpApprovalPolicyResponse, SessionQueueSnapshot, SessionQueueMutationResponse, SessionCommandReceipt, SessionPromptRouting, ComposerDraft, DeleteSessionQueueItemRequest, EditSessionQueueItemRequest, MoveSessionQueueItemRequest, NewSessionDraft, SaveComposerDraftRequest, SubmitComposerDraftRequest, SubmitComposerDraftResponse, SaveNewSessionDraftRequest, SteerSessionQueueItemRequest, SessionControlResponse, SessionRetryRequest, SandboxRecoveryProjection, SandboxRecoveryRequest, SandboxRecoveryResponse, SessionRetryResponse, WorkspaceInferenceControlResponse, WorkspaceControlEvent, SessionTurn, SubmitHumanInputResponseRequest, SessionCapabilities, AttachViewerRequest, AttachViewerResponse, AcknowledgeStreamRequest, AcknowledgeStreamResponse, ViewerHeartbeatRequest, ViewerHeartbeatResponse, FsListRequest, FsListResponse, FsListBatchRequest, FsListBatchResponse, FsReadRequest, FsReadResponse, PublishSandboxFileArtifactRequest, SandboxFileArtifactReceipt, FsWriteRequest, FsWriteResponse, FsDeleteRequest, FsDeleteResponse, FsMoveRequest, FsMoveResponse, FsMkdirRequest, FsMkdirResponse, GitStatusRequest, GitStatusResponse, GitDiffRequest, GitDiffResponse, GitReadBatchRequest, GitReadBatchResponse, GitLogRequest, GitLogResponse, GitShowRequest, GitShowResponse, GetWorkspaceCaptureResponse, GetWorkspaceCaptureFileResponse, TerminalExecRequest, TerminalExecResponse, PtyOpenRequest, PtyOpenResponse, PtyWriteRequest, PtyResizeRequest, PtyCloseRequest, TranscribeAudioResponse, TranscriptionRecordingListResponse, TranscriptionRecordingResponse, UploadTranscriptionRecordingChunkResponse, UpdateConnectionRequest, RefreshScheduledTaskAccessRequest, UpdateScheduledTaskRequest, UpdateSessionGoalRequest, ApplySessionGoalRevisionRequest, UpdateSessionRequest, UpdateSessionVariableSetsRequest, UpdateSessionToolPolicyRequest, UpdateSessionAgentRequest, UpdateVariableSetRequest, UpdateRigRequest, UpdateWorkspaceMemberRequest, UpdateWorkspaceModelAccessPolicyRequest, UpdateWorkspaceRequest, UpdateWorkspaceSettingsRequest, SetWorkspaceDefaultRigRequest, UploadFileInput, VariableSet, VariableSetSecret, VariableSetVariableMetadata, Channel, CreateChannelRequest, ReorderChannelsRequest, UpdateChannelRequest, Rig, RigVersion, RigChange, ProposeRigChangeRequest, WorkspaceMember, WorkspaceMemberCandidate, Workspace, SlackInstallationBinding, OAuthStartRequest, OAuthStartResponse, SocialConnection, SocialOAuthStartRequest, SkillImportPreview, SkillUninstallPreview, UninstallSkillRequest, UninstallSkillResult } from "./types.js";
7
18
  import type { ActivateWorkspaceInstructionPolicyRequest, CreateWorkspaceInstructionPolicyDraftRequest, CreateWorkspaceInstructionPolicyOnboardingProposalRequest, ImportLegacyWorkspaceInstructionPolicyDraftRequest, RollbackWorkspaceInstructionPolicyRequest, WorkspaceInstructionPolicyActivationResponse, WorkspaceInstructionPolicyDiffRequest, WorkspaceInstructionPolicyDiffResponse, WorkspaceInstructionPolicyListOptions, WorkspaceInstructionPolicyListResponse, WorkspaceInstructionPolicyOnboardingProposal, WorkspaceInstructionPolicyOnboardingProposalListOptions, WorkspaceInstructionPolicyOnboardingProposalListResponse, WorkspaceInstructionPolicyRevision } from "./workspace-instruction-policies.js";
8
- import type { ActivateCompanyProfileRevisionRequest, CompanyProfileDiffRequest, CompanyProfileDiffResponse, CompanyProfileListOptions, CompanyProfileListResponse, CompanyProfileMutationResponse, CompanyProfileRevision, RollbackCompanyProfileRequest, UpdateCompanyProfileRequest } from "./company-profile.js";
19
+ import type { GovernedLearningActivationUndoReceipt, WorkspaceLearningHistoryOptions, WorkspaceLearningHistoryResponse } from "./workspace-learning.js";
20
+ import type { ActivateCompanyProfileRevisionRequest, CompanyProfileAgentPolicy, CompanyProfileDiffRequest, CompanyProfileDiffResponse, CompanyProfileListOptions, CompanyProfileListResponse, CompanyProfileMutationResponse, CompanyProfileRevision, RollbackCompanyProfileRequest, UpdateCompanyProfileRequest, UpdateCompanyProfileAgentPolicyRequest } from "./company-profile.js";
9
21
  import type { WorkspaceStateExportResponse, WorkspaceStateGetOptions, WorkspaceStateResponse } from "./workspace-state.js";
10
22
  import type { ActivatePreferenceRegistryRevisionRequest, ChangePreferenceRegistryScopeRequest, CorrectPreferenceRegistryRequest, CreatePreferenceRegistryProposalRequest, DeactivatePreferenceRegistryRequest, PreferenceRegistryDetailResponse, PreferenceRegistryFullContent, PreferenceRegistryListOptions, PreferenceRegistryListResponse, PreferenceRegistryMutationResponse, PreferenceRegistryRecord, PreferenceRegistrySnapshot, RejectPreferenceRegistryProposalRequest, SupersedePreferenceRegistryRequest } from "./preference-registry.js";
11
- export type FetchLike = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
23
+ export type SessionListPageOptions = {
24
+ /** Complete content-free totals for an authorized root page. */
25
+ includeTotals?: boolean;
26
+ /** Filter attention rows before pagination. */
27
+ needsYouOnly?: boolean;
28
+ /** Created through this Site. In a Site-bound client, "current" resolves to its own Site. */
29
+ originSiteId?: string;
30
+ limit?: number;
31
+ parentSessionId?: string | null;
32
+ /** Only sessions carrying this exact opaque end-user label. */
33
+ scopeSubjectId?: SessionScopeSubjectId;
34
+ cursor?: string;
35
+ search?: string;
36
+ /** Restrict rows to one workspace project; null selects unfiled rows. */
37
+ channelId?: string | null;
38
+ /** Restrict rows to the exact frozen session creator identity. */
39
+ createdBy?: {
40
+ kind: "subject" | "service";
41
+ subjectId: string;
42
+ };
43
+ /** Inclusive ISO-8601 activity lower bound. */
44
+ updatedFrom?: string;
45
+ /** Exclusive ISO-8601 activity upper bound. */
46
+ updatedBefore?: string;
47
+ /** Inclusive ISO-8601 creation lower bound. */
48
+ createdFrom?: string;
49
+ /** Exclusive ISO-8601 creation upper bound. */
50
+ createdBefore?: string;
51
+ /** Return only the complete personal pinned projection. */
52
+ pinsOnly?: boolean;
53
+ /** Skip pinned details when the pinned section is loaded separately. Defaults to true. */
54
+ includePinned?: boolean;
55
+ /** Return archived root chats instead of the active session list. */
56
+ archivedOnly?: boolean;
57
+ sortBy?: "updatedAt" | "createdAt" | "name";
58
+ archiveStatus?: "active" | "archived" | "all";
59
+ /** Stop this caller's finite page read when its owning route is abandoned. */
60
+ signal?: AbortSignal | undefined;
61
+ };
62
+ /**
63
+ * Web-standard fetch response accepted by the SDK.
64
+ *
65
+ * The project global `Response` type includes Bun's non-standard `textStream()`
66
+ * method and the newer `bytes()` method. Fetch implementations such as Expo do
67
+ * not necessarily provide either member, and the SDK does not use them, so
68
+ * they must not be part of the adapter boundary.
69
+ */
70
+ export type FetchResponse = Omit<Response, "bytes" | "clone" | "textStream"> & {
71
+ clone(): FetchResponse;
72
+ };
73
+ export type FetchLike = (input: string | URL | Request, init?: RequestInit) => Promise<FetchResponse>;
12
74
  export type WorkspaceControlEventPage = {
13
75
  events: WorkspaceControlEvent[];
14
76
  bytes: number;
@@ -20,39 +82,85 @@ export type OpenGeniClientOptions = {
20
82
  baseUrl: string;
21
83
  /** OpenGeni API key, sent as `Authorization: Bearer <apiKey>`. */
22
84
  apiKey?: string;
85
+ /**
86
+ * Receives a notice (once per route per client) when the API advertises a
87
+ * `Deprecation`/`Sunset` header on a response. Defaults to a one-time
88
+ * `console.warn` per route; pass `false` to silence notices.
89
+ */
90
+ onDeprecation?: OpenGeniDeprecationHandler | false | undefined;
23
91
  /** Extra headers (static or computed per request) merged into every call. */
24
92
  headers?: Record<string, string> | (() => Record<string, string>);
25
93
  /** Custom fetch implementation. Defaults to the global `fetch`. */
26
94
  fetch?: FetchLike;
95
+ /**
96
+ * Optional causal clock for shared session projection GETs. The selected
97
+ * request generation is retained for observers that join after launch.
98
+ */
99
+ beginSharedRead?: (() => number) | undefined;
100
+ /** Positive deadline for interactive session commands. Defaults to 15 seconds. */
101
+ sessionCommandTimeoutMs?: number;
102
+ /**
103
+ * How this client treats an API that advertises a different
104
+ * `x-opengeni-api-contract` revision.
105
+ *
106
+ * - `"strict"`: fail with `OpenGeniApiContractMismatchError` so a browser
107
+ * page served alongside the API can reload onto the matching bundle.
108
+ * - `"compatible"`: keep working. Within a major release train the API is
109
+ * additive (see the compatibility policy), and the API admits bearer
110
+ * (API key / delegated token) mutations from older SDK revisions, so a
111
+ * backend pinned to an older SDK is not broken by every deployment.
112
+ *
113
+ * Defaults to `"strict"` in a browser client without an `apiKey`, and to
114
+ * `"compatible"` everywhere else.
115
+ */
116
+ apiContract?: "strict" | "compatible" | undefined;
27
117
  };
28
118
  /** Per-request cancellation for operations whose caller owns an AbortSignal. */
29
119
  export type OpenGeniRequestOptions = {
30
120
  signal?: AbortSignal | undefined;
121
+ timeoutMs?: number | undefined;
122
+ /** Opt-in void response handling for focused helpers using the shared transport. */
123
+ responseType?: "json" | "void";
31
124
  };
32
- export type SendMessageInput = {
33
- text: string;
34
- annotations?: SubmittedTimelineAnnotation[];
35
- /** System instructions scoped to this exact turn; never visible timeline text. */
36
- turnInstructions?: string;
37
- resources?: ResourceRef[];
38
- tools?: ToolRef[];
39
- model?: string;
40
- reasoningEffort?: ReasoningEffort;
41
- latencyMode?: LatencyMode;
125
+ export type SharedSessionReadOptions = {
126
+ /**
127
+ * Observe the selected shared network GET's actual start. A caller joining
128
+ * an already-started request receives its retained generation when the
129
+ * client has a `beginSharedRead` clock.
130
+ */
131
+ onRequestStart?: ((readGeneration?: number) => void) | undefined;
132
+ /**
133
+ * Stop this caller's interest in the shared read. The native request is
134
+ * aborted only after every caller that joined the same generation has
135
+ * stopped waiting for it.
136
+ */
137
+ signal?: AbortSignal | undefined;
138
+ };
139
+ export type GetSessionOptions = SharedSessionReadOptions & {
140
+ /**
141
+ * Require a network read generation that starts no earlier than this call.
142
+ * Concurrent callers targeting the same successor generation still share it.
143
+ */
144
+ fresh?: boolean;
145
+ };
146
+ export type GetSessionLineageOptions = SharedSessionReadOptions;
147
+ /** Follow-up prompt fields accepted by both queue and Steer. Session tools are updated separately. */
148
+ export type SendMessageInput = UserMessageEventInput["payload"] & {
42
149
  clientEventId?: string;
43
- controlEtag?: string;
44
- expectedDraftRevision?: number;
45
- mcpCredentialUpdates?: SessionMcpCredentialUpdateInput[];
46
150
  };
47
151
  export type SteerMessageResult = {
48
152
  /** The accepted `user.message` event. */
49
153
  accepted: SessionEvent;
50
154
  /** The exact turn created for this message in the same server transaction. */
51
155
  turn: SessionTurn;
156
+ /** Durable proof that this exact operation committed. */
157
+ receipt: SessionCommandReceipt;
158
+ /** Server-owned destination at admission time. */
159
+ routing: SessionPromptRouting;
52
160
  /** Number of live attempts durably asked to stop by this atomic Steer. */
53
- interruptionCount?: number;
161
+ interruptionCount: number;
54
162
  /** True when this response came from the command's immutable idempotency receipt. */
55
- replay?: boolean;
163
+ replay: boolean;
56
164
  };
57
165
  export type TranscribeAudioInput = {
58
166
  audio: Blob | File | Uint8Array;
@@ -79,19 +187,22 @@ export type FinalizeTranscriptionRecordingInput = {
79
187
  totalDurationMilliseconds: number;
80
188
  signal?: AbortSignal | undefined;
81
189
  };
82
- /**
83
- * Typed client for the OpenGeni public API. Framework-agnostic: only needs
84
- * WHATWG `fetch` + streams, so it runs in Node 18+, Bun, Deno, browsers, and
85
- * edge runtimes.
86
- */
87
190
  export declare class OpenGeniClient {
191
+ protected externalActorHeader?: string;
192
+ protected serviceInitiatorHeader?: string | undefined;
193
+ protected serviceContextHeader?: string | undefined;
88
194
  private readonly baseUrl;
89
- private readonly options;
195
+ protected readonly options: OpenGeniClientOptions;
90
196
  private readonly fetchImpl;
91
- private readonly readInFlight;
92
- private readonly readTrailing;
197
+ private readonly sessionCommandTimeoutMs;
198
+ private readonly apiContractStrict;
199
+ private readonly active;
200
+ private readonly generations;
201
+ private readonly queued;
93
202
  /** Resource-oriented Browser/Computer facade over this exact authenticated client. */
94
203
  readonly interaction: OpenGeniInteractionClient;
204
+ /** Dynamic typed tool facade backed by the canonical workspace gateway. */
205
+ readonly tools: OpenGeniToolsFacade;
95
206
  constructor(options: OpenGeniClientOptions);
96
207
  /** Make one finalization attempt for a recording; callers may retry retained audio. */
97
208
  transcribeAudio(workspaceId: string, input: TranscribeAudioInput): Promise<TranscribeAudioResponse>;
@@ -111,45 +222,126 @@ export declare class OpenGeniClient {
111
222
  signal?: AbortSignal | undefined;
112
223
  }): Promise<TranscriptionRecordingResponse>;
113
224
  createSession(workspaceId: string, request: CreateSessionRequest): Promise<CreateSessionResponse>;
114
- getNewSessionDraft(workspaceId: string): Promise<NewSessionDraft>;
225
+ getNewSessionDraft(workspaceId: string, options?: OpenGeniRequestOptions): Promise<NewSessionDraft>;
115
226
  saveNewSessionDraft(workspaceId: string, request: SaveNewSessionDraftRequest): Promise<NewSessionDraft>;
116
- getSession(workspaceId: string, sessionId: string, options?: {
117
- fresh?: boolean;
118
- }): Promise<Session>;
227
+ /** The workspace's HTTP credential provider, or null when none is configured. */
228
+ getWorkspaceCredentialProvider(workspaceId: string): Promise<GetWorkspaceCredentialProviderResponse>;
229
+ /**
230
+ * Create or update the workspace credential provider. The signing secret is
231
+ * returned only when the provider is first created; store it then.
232
+ */
233
+ putWorkspaceCredentialProvider(workspaceId: string, request: PutWorkspaceCredentialProviderRequest): Promise<PutWorkspaceCredentialProviderResponse>;
234
+ deleteWorkspaceCredentialProvider(workspaceId: string): Promise<void>;
235
+ listWorkspaceWebhooks(workspaceId: string): Promise<ListWorkspaceWebhooksResponse>;
236
+ /** Create a webhook. The signing secret is returned only in this response. */
237
+ createWorkspaceWebhook(workspaceId: string, request: CreateWorkspaceWebhookRequest): Promise<CreateWorkspaceWebhookResponse>;
238
+ updateWorkspaceWebhook(workspaceId: string, webhookId: string, request: UpdateWorkspaceWebhookRequest): Promise<WorkspaceWebhook>;
239
+ deleteWorkspaceWebhook(workspaceId: string, webhookId: string): Promise<void>;
240
+ listWorkspaceWebhookDeliveries(workspaceId: string, webhookId: string, options?: {
241
+ limit?: number;
242
+ }): Promise<ListWorkspaceWebhookDeliveriesResponse>;
243
+ /** Queue a delivered or failed delivery again with a fresh attempt budget. */
244
+ redeliverWorkspaceWebhookDelivery(workspaceId: string, webhookId: string, deliveryId: string): Promise<WorkspaceWebhookDelivery>;
245
+ /** Images this deployment lets a workspace choose as its default sandbox image. */
246
+ listWorkspaceSandboxImages(workspaceId: string): Promise<WorkspaceSandboxImages>;
247
+ /** Submit general feedback or a session/turn rating. Retain the key when retrying. */
248
+ createFeedback(workspaceId: string, request: CreateFeedbackRequest): Promise<FeedbackSubmissionResponse>;
249
+ /** Only this principal's submissions. No session filter means general feedback only. */
250
+ listOwnFeedback(workspaceId: string, options?: {
251
+ sessionId?: string;
252
+ limit?: number;
253
+ includeTurns?: boolean;
254
+ }): Promise<{
255
+ feedback: Feedback[];
256
+ }>;
257
+ getSession(workspaceId: string, sessionId: string, options?: GetSessionOptions): Promise<Session>;
258
+ /** Exact model-visible prefix captured from the latest provider request. */
259
+ getSessionModelContext(workspaceId: string, sessionId: string): Promise<SessionModelContextResponse>;
119
260
  updateSession(workspaceId: string, sessionId: string, request: UpdateSessionRequest): Promise<Session>;
261
+ /** Replace the complete ordered Variable Set selection at a quiescent turn boundary. */
262
+ updateSessionVariableSets(workspaceId: string, sessionId: string, request: UpdateSessionVariableSetsRequest): Promise<Session>;
263
+ /** Whether this exact authenticated principal may atomically create a private session. */
264
+ getSessionTenancyCreateCapabilities(workspaceId: string): Promise<SessionTenancyCreateCapabilities>;
265
+ /** Change an owned, fully quiescent session between private and workspace visibility. */
266
+ updateSessionVisibility(workspaceId: string, sessionId: string, request: UpdateSessionVisibilityRequest): Promise<UpdateSessionVisibilityResponse>;
267
+ /** Create an independent same-workspace fork with explicit destination visibility. */
268
+ forkSession(workspaceId: string, sessionId: string, request: ForkSessionRequest): Promise<ForkSessionResponse>;
120
269
  /** Replace the durable tool policy or explicitly adopt workspace defaults. */
121
270
  updateSessionToolPolicy(workspaceId: string, sessionId: string, request: UpdateSessionToolPolicyRequest): Promise<Session>;
271
+ /**
272
+ * Replace the session's agent configuration (capabilities, identity,
273
+ * instructions alias, renderer). Omitted fields keep their current values.
274
+ * Uses the tool-policy version (409 when stale) and applies from the next
275
+ * turn. A legacy session converts from its current effective state.
276
+ */
277
+ updateSessionAgent(workspaceId: string, sessionId: string, request: UpdateSessionAgentRequest): Promise<Session>;
122
278
  /**
123
279
  * Replace one attached MCP server's approval policy. The change is captured
124
280
  * by the next claimed attempt; already-claimed work keeps its immutable
125
281
  * policy snapshot.
126
282
  */
127
283
  updateSessionMcpApprovalPolicy(workspaceId: string, sessionId: string, serverId: string, request: UpdateSessionMcpApprovalPolicyRequest): Promise<UpdateSessionMcpApprovalPolicyResponse>;
284
+ /** Search durable visible user/assistant text, including unloaded history.
285
+ * Pages may be empty with hasMore=true. Never fall back to title search on
286
+ * older servers. Use listEventPage before/after the returned sequence for context.
287
+ */
288
+ searchSessionMessages(workspaceId: string, request: SessionMessageSearchRequest, options?: OpenGeniRequestOptions): Promise<SessionMessageSearchResponse>;
289
+ /** Read one selected search result's complete visible text when <=12,000
290
+ * UTF-16 units. Stale, duplicate or non-message references fail with 404.
291
+ * The response never includes audit payload fields such as modelContext.
292
+ */
293
+ getSessionMessagePreview(workspaceId: string, sessionId: string, reference: SessionMessagePreviewReference, options?: OpenGeniRequestOptions): Promise<SessionMessagePreview>;
128
294
  listSessions(workspaceId: string, options?: {
295
+ originSiteId?: string;
129
296
  limit?: number;
130
297
  parentSessionId?: string | null;
131
298
  search?: string;
299
+ /** Only sessions carrying this exact opaque end-user label. */
300
+ scopeSubjectId?: SessionScopeSubjectId;
132
301
  }): Promise<Session[]>;
302
+ /** Running and stopping commands only; settled results remain in session history. */
303
+ listSessionBackgroundCommands(workspaceId: string, sessionId: string, options?: OpenGeniRequestOptions): Promise<SessionBackgroundCommandListResponse>;
304
+ cancelSessionBackgroundCommand(workspaceId: string, sessionId: string, commandId: string): Promise<CancelSessionBackgroundCommandResult>;
133
305
  /** Pin-aware ordinary-session page with a stable keyset cursor. */
134
- listSessionPage(workspaceId: string, options?: {
135
- limit?: number;
136
- parentSessionId?: string | null;
137
- cursor?: string;
138
- search?: string;
139
- /** Return only the complete personal pinned projection. */
140
- pinsOnly?: boolean;
141
- }): Promise<SessionListResponse>;
306
+ listSessionPage(workspaceId: string, options?: SessionListPageOptions): Promise<SessionListResponse>;
307
+ /** Compact rail records; safely projects full pages from older APIs. */
308
+ listSessionSummaryPage(workspaceId: string, options?: SessionListPageOptions): Promise<SessionListEntryResponse>;
309
+ private requestSessionPage;
142
310
  /** Compact, bounded workspace agent hierarchy page. */
143
311
  listAgentTopology(workspaceId: string, options?: {
144
312
  limit?: number;
145
313
  parentSessionId?: string | null;
314
+ rootSessionId?: string;
146
315
  cursor?: string;
316
+ query?: string;
317
+ /** @deprecated use query. */
147
318
  search?: string;
319
+ statuses?: SessionStatus[];
320
+ activeOnly?: boolean;
321
+ recentHours?: number;
322
+ subject?: {
323
+ namespace: string;
324
+ type: WorkClaimSubjectType;
325
+ canonicalKey: string;
326
+ };
327
+ claimLimit?: number;
148
328
  }): Promise<AgentTopologyPageResponse>;
149
329
  /** Set this authenticated member's personal workspace pin for a session. */
150
330
  updateSessionPin(workspaceId: string, sessionId: string, request: UpdateSessionPinRequest): Promise<Session>;
151
- getSessionLineage(workspaceId: string, sessionId: string): Promise<SessionLineageResponse>;
152
- private singleFlightRead;
331
+ /** Set this authenticated member's explicit read/actively-working state. */
332
+ updateSessionAttention(workspaceId: string, sessionId: string, request: UpdateSessionAttentionRequest): Promise<Session>;
333
+ /** Archive or restore this authenticated member's root chat. */
334
+ updateSessionArchive(workspaceId: string, sessionId: string, request: UpdateSessionArchiveRequest): Promise<Session>;
335
+ /** Permanently delete one quiescent root session and its full descendant tree. */
336
+ deleteSession(workspaceId: string, sessionId: string): Promise<{
337
+ deletedSessionCount: number;
338
+ }>;
339
+ getSessionLineage(workspaceId: string, sessionId: string, options?: GetSessionLineageOptions): Promise<SessionLineageResponse>;
340
+ private sharedRead;
341
+ private queueRead;
342
+ private launchRead;
343
+ private consumeSharedRead;
344
+ private observeRead;
153
345
  /** Negotiate one server-mediated connected-Codex GPT-Live V3 WebRTC call. */
154
346
  negotiateCodexRealtimeWebrtc(workspaceId: string, sessionId: string, request: CodexRealtimeWebrtcRequest, options?: {
155
347
  signal?: AbortSignal | undefined;
@@ -177,9 +369,10 @@ export declare class OpenGeniClient {
177
369
  listTurns(workspaceId: string, sessionId: string, options?: {
178
370
  limit?: number;
179
371
  latestStarted?: boolean;
372
+ signal?: AbortSignal | undefined;
180
373
  }): Promise<SessionTurn[]>;
181
374
  /** Newest turn that durably emitted `turn.started`, or null before any admission. */
182
- getLatestStartedTurn(workspaceId: string, sessionId: string): Promise<SessionTurn | null>;
375
+ getLatestStartedTurn(workspaceId: string, sessionId: string, options?: OpenGeniRequestOptions): Promise<SessionTurn | null>;
183
376
  /**
184
377
  * List the workspace's machines (the Machines dashboard). Each enrolled
185
378
  * selfhosted machine carries its derived state + latest metrics +
@@ -190,6 +383,13 @@ export declare class OpenGeniClient {
190
383
  sessionId?: string;
191
384
  signal?: AbortSignal;
192
385
  }): Promise<MachinesResponse>;
386
+ /** Ask one authoritative Connected Machine runner to drain accepted work and
387
+ * install the exact signed version promoted for its channel. Progress is read
388
+ * from `listMachines`; completion requires the successor build identity. */
389
+ updateMachineAgent(workspaceId: string, enrollmentId: string): Promise<UpdateMachineAgentResponse>;
390
+ /** Revision-fenced update of a Connected Machine's optional command memory
391
+ * policy. Null byte limits preserve unrestricted machine access. */
392
+ updateMachineOperationPolicy(workspaceId: string, enrollmentId: string, request: UpdateMachineOperationPolicyRequest): Promise<MachineOperationPolicy>;
193
393
  /**
194
394
  * Read the downsampled (~1/min) metrics series for ONE machine over a time
195
395
  * window (default 1h). The samples are oldest-first (a left-to-right chart).
@@ -200,8 +400,9 @@ export declare class OpenGeniClient {
200
400
  /**
201
401
  * Remove one connected self-hosted machine enrollment. The control-plane
202
402
  * operation works while the agent is offline, revokes future reconnects,
203
- * retains history, and returns a typed blocker when active route/lease or
204
- * recovery dependencies make removal unsafe. `idempotencyKey` is replay-safe.
403
+ * retains history, and atomically detaches idle dependent sessions (a
404
+ * machine-home session becomes `backend:none`). Active turns, live leases,
405
+ * and recovery work remain typed blockers. `idempotencyKey` is replay-safe.
205
406
  */
206
407
  removeEnrollment(workspaceId: string, enrollmentId: string, request?: RemoveEnrollmentRequest): Promise<RemoveEnrollmentResponse>;
207
408
  /**
@@ -219,10 +420,7 @@ export declare class OpenGeniClient {
219
420
  * is the authoritative screen-control consent (whole-machine is mandatory/implicit).
220
421
  * Lands an enrollment + a selfhosted sandbox and unblocks the agent's poll.
221
422
  */
222
- approveDeviceEnrollment(workspaceId: string, request: {
223
- userCode: string;
224
- allowScreenControl?: boolean;
225
- }): Promise<DeviceEnrollmentApproveResponse>;
423
+ approveDeviceEnrollment(workspaceId: string, request: DeviceEnrollmentApproveRequest): Promise<DeviceEnrollmentApproveResponse>;
226
424
  /** Deny a pending device-enrollment flow (the explicit "no" at the approve page). */
227
425
  denyDeviceEnrollment(workspaceId: string, request: {
228
426
  userCode: string;
@@ -247,8 +445,15 @@ export declare class OpenGeniClient {
247
445
  swapActiveSandbox(workspaceId: string, sessionId: string, request: SwapActiveSandboxRequest): Promise<SwapActiveSandboxResponse>;
248
446
  listScheduledTasks(workspaceId: string, options?: {
249
447
  limit?: number;
448
+ offset?: number;
449
+ sessionId?: string;
250
450
  }): Promise<ScheduledTask[]>;
251
451
  getScheduledTask(workspaceId: string, taskId: string): Promise<ScheduledTask>;
452
+ /**
453
+ * Channels a person may choose as a scheduled task's fixed Slack destination:
454
+ * active, non-shared channels the selected OpenGeni bot already belongs to.
455
+ */
456
+ listScheduledTaskSlackChannels(workspaceId: string, connectionId: string, cursor?: string): Promise<SlackReactionChannelListResponse>;
252
457
  /**
253
458
  * Return the events from one bounded page. With no cursor, this uses the safe
254
459
  * semantic monitoring tail; pass explicit forensic options and a cursor for
@@ -305,8 +510,15 @@ export declare class OpenGeniClient {
305
510
  editQueueItem(workspaceId: string, sessionId: string, turnId: string, request: EditSessionQueueItemRequest): Promise<SessionQueueMutationResponse>;
306
511
  steerQueueItem(workspaceId: string, sessionId: string, turnId: string, request: SteerSessionQueueItemRequest): Promise<SessionQueueMutationResponse>;
307
512
  deleteQueueItem(workspaceId: string, sessionId: string, turnId: string, request: DeleteSessionQueueItemRequest): Promise<SessionQueueMutationResponse>;
308
- getComposerDraft(workspaceId: string, sessionId: string): Promise<ComposerDraft>;
513
+ getComposerDraft(workspaceId: string, sessionId: string, options?: OpenGeniRequestOptions): Promise<ComposerDraft>;
309
514
  saveComposerDraft(workspaceId: string, sessionId: string, request: SaveComposerDraftRequest): Promise<ComposerDraft>;
515
+ submitComposerDraft(workspaceId: string, sessionId: string, request: SubmitComposerDraftRequest): Promise<SubmitComposerDraftResponse>;
516
+ /** Inspect bounded checkpoint recovery eligibility without changing session state. */
517
+ getSandboxRecovery(workspaceId: string, sessionId: string): Promise<SandboxRecoveryProjection>;
518
+ /** Restore only the explicitly selected checkpoint; never retry a command. */
519
+ recoverSandbox(workspaceId: string, sessionId: string, request: SandboxRecoveryRequest): Promise<SandboxRecoveryResponse>;
520
+ /** Retry the exact failed turn. Keep clientEventId unchanged on transport retries. */
521
+ retrySession(workspaceId: string, sessionId: string, request: SessionRetryRequest): Promise<SessionRetryResponse>;
310
522
  controlSession(workspaceId: string, sessionId: string, request: {
311
523
  action: "pause" | "resume" | "cancel";
312
524
  reason?: string;
@@ -328,6 +540,9 @@ export declare class OpenGeniClient {
328
540
  clientEventId?: string;
329
541
  expectedControlEtag?: string;
330
542
  }): Promise<SessionControlResponse>;
543
+ setWorkspacePauseTimer(workspaceId: string, request: import("./types.js").WorkspacePauseTimerRequest): Promise<{
544
+ ok: boolean;
545
+ }>;
331
546
  setWorkspaceInferenceState(workspaceId: string, request: {
332
547
  action: "pause" | "resume";
333
548
  reason?: string;
@@ -366,9 +581,12 @@ export declare class OpenGeniClient {
366
581
  */
367
582
  steerMessage(workspaceId: string, sessionId: string, message: string | SendMessageInput): Promise<SteerMessageResult>;
368
583
  /** The session's goal. 404s when the session never had one. */
369
- getGoal(workspaceId: string, sessionId: string): Promise<SessionGoal>;
584
+ getGoal(workspaceId: string, sessionId: string, options?: SharedSessionReadOptions): Promise<SessionGoal>;
370
585
  updateGoal(workspaceId: string, sessionId: string, request: UpdateSessionGoalRequest): Promise<SessionGoal>;
371
586
  listGoalRevisions(workspaceId: string, sessionId: string): Promise<SessionGoalRevision[]>;
587
+ listGoalRevisionPage(workspaceId: string, sessionId: string, options?: ListSessionGoalRevisionsOptions): Promise<ListSessionGoalRevisionsResponse>;
588
+ rejectGoalRevision(workspaceId: string, sessionId: string, revisionId: string, request: RejectSessionGoalRevisionRequest): Promise<RejectSessionGoalRevisionResponse>;
589
+ rollbackGoalRevision(workspaceId: string, sessionId: string, revisionId: string, request: RollbackSessionGoalRevisionRequest): Promise<SessionGoal>;
372
590
  applyGoalRevision(workspaceId: string, sessionId: string, revisionId: string, request: ApplySessionGoalRevisionRequest): Promise<SessionGoal>;
373
591
  deleteGoal(workspaceId: string, sessionId: string): Promise<void>;
374
592
  /** Pause the goal loop: the session stops self-continuing until resumed. */
@@ -393,6 +611,8 @@ export declare class OpenGeniClient {
393
611
  fsListBatch(workspaceId: string, sessionId: string, request: FsListBatchRequest, options?: OpenGeniRequestOptions): Promise<FsListBatchResponse>;
394
612
  /** FileSystem: read a file (text or base64; binary-safe, size-capped). */
395
613
  fsRead(workspaceId: string, sessionId: string, request: FsReadRequest, options?: OpenGeniRequestOptions): Promise<FsReadResponse>;
614
+ /** Publish one exact sandbox file into permanent workspace artifact storage. */
615
+ publishSandboxFileArtifact(workspaceId: string, sessionId: string, request: PublishSandboxFileArtifactRequest, options?: OpenGeniRequestOptions): Promise<SandboxFileArtifactReceipt>;
396
616
  /** FileSystem: write a file (last-writer-wins; emits fs.changed). */
397
617
  fsWrite(workspaceId: string, sessionId: string, request: FsWriteRequest): Promise<FsWriteResponse>;
398
618
  /** FileSystem: delete a path (emits fs.changed). */
@@ -500,8 +720,11 @@ export declare class OpenGeniClient {
500
720
  listBrowserTargets(workspaceId: string, browserSessionId: string, options?: OpenGeniRequestOptions): Promise<BrowserTargetListResponse>;
501
721
  openBrowserTarget(workspaceId: string, browserSessionId: string, request?: BrowserOpenTargetRequest, options?: OpenGeniRequestOptions): Promise<BrowserObservation>;
502
722
  selectBrowserTarget(workspaceId: string, browserSessionId: string, targetId: string, options?: OpenGeniRequestOptions): Promise<BrowserObservation>;
723
+ captureBrowserTarget(workspaceId: string, browserSessionId: string, targetId: string, options?: OpenGeniRequestOptions, captureOptions?: BrowserScreenshotOptions): Promise<BrowserFrame>;
503
724
  closeBrowserTarget(workspaceId: string, browserSessionId: string, targetId: string, options?: OpenGeniRequestOptions): Promise<BrowserTargetListResponse>;
504
725
  observeBrowserTarget(workspaceId: string, browserSessionId: string, targetId: string, options?: OpenGeniRequestOptions): Promise<BrowserObservation>;
726
+ getBrowserTargetState(workspaceId: string, browserSessionId: string, targetId: string, options?: OpenGeniRequestOptions): Promise<BrowserTargetState>;
727
+ readBrowserDom(workspaceId: string, browserSessionId: string, targetId: string, request: BrowserDomReadRequest, options?: OpenGeniRequestOptions): Promise<BrowserDomReadResponse>;
505
728
  actInBrowser(workspaceId: string, browserSessionId: string, request: BrowserActionRequest, options?: OpenGeniRequestOptions): Promise<BrowserActionReceipt>;
506
729
  getBrowserActionReceipt(workspaceId: string, browserSessionId: string, operationId: string, options?: OpenGeniRequestOptions): Promise<BrowserActionReceipt>;
507
730
  listBrowserDiagnostics(workspaceId: string, browserSessionId: string, targetId: string, options?: BrowserDiagnosticsOptions): Promise<BrowserDiagnosticBatch>;
@@ -516,9 +739,11 @@ export declare class OpenGeniClient {
516
739
  listComputerSessions(workspaceId: string, options?: OpenGeniRequestOptions): Promise<ComputerSessionListResponse>;
517
740
  getComputerSession(workspaceId: string, computerSessionId: string, options?: OpenGeniRequestOptions): Promise<ComputerSession>;
518
741
  readComputerClipboard(workspaceId: string, computerSessionId: string, options?: OpenGeniRequestOptions): Promise<ComputerClipboard>;
742
+ getComputerInputPosture(workspaceId: string, computerSessionId: string, options?: OpenGeniRequestOptions): Promise<ComputerSessionInputPosture>;
519
743
  createComputerSession(workspaceId: string, request: CreateComputerSessionRequest, options?: OpenGeniRequestOptions): Promise<ComputerSessionMutationResponse>;
520
744
  listComputerTargets(workspaceId: string, computerSessionId: string, options?: OpenGeniRequestOptions): Promise<ComputerTargetListResponse>;
521
745
  observeComputerTarget(workspaceId: string, computerSessionId: string, targetId: string, options?: OpenGeniRequestOptions): Promise<ComputerObservation>;
746
+ captureComputerTarget(workspaceId: string, computerSessionId: string, targetId: string, options?: OpenGeniRequestOptions): Promise<ComputerFrame>;
522
747
  actInComputer(workspaceId: string, computerSessionId: string, request: ComputerActionRequest, options?: OpenGeniRequestOptions): Promise<ComputerActionReceipt>;
523
748
  getComputerActionReceipt(workspaceId: string, computerSessionId: string, operationId: string, options?: OpenGeniRequestOptions): Promise<ComputerActionReceipt>;
524
749
  attachComputerSession(workspaceId: string, computerSessionId: string, request: ComputerSessionAttachmentRequest, options?: OpenGeniRequestOptions): Promise<ComputerSessionAttachment>;
@@ -530,18 +755,199 @@ export declare class OpenGeniClient {
530
755
  * reasoning efforts, MCP servers, file-upload limits, and how the client is
531
756
  * expected to authenticate. Drives a composer's model picker without prior
532
757
  * knowledge of the host setup; safe to call before any auth is established.
758
+ * Authenticated calls resolve the caller's default workspace, or the exact
759
+ * `workspaceId` option, using the same selection rules as fresh session create.
533
760
  */
534
- getClientConfig(): Promise<ClientConfig>;
761
+ getClientConfig(options?: OpenGeniRequestOptions & {
762
+ workspaceId?: string;
763
+ }): Promise<ClientConfig>;
535
764
  /** Authenticated model definitions plus workspace-specific selectability. */
536
- getWorkspaceModelCatalog(workspaceId: string): Promise<WorkspaceModelCatalogResponse>;
765
+ getWorkspaceModelCatalog(workspaceId: string, options?: OpenGeniRequestOptions): Promise<WorkspaceModelCatalogResponse>;
766
+ /** List workspace-owned unpinned Vercel AI Gateway model slugs. */
767
+ listWorkspaceGatewayCustomModels(workspaceId: string): Promise<WorkspaceGatewayCustomModelsResponse>;
768
+ /** Add one exact upstream Vercel AI Gateway slug. */
769
+ createWorkspaceGatewayCustomModel(workspaceId: string, request: CreateWorkspaceGatewayCustomModelRequest): Promise<WorkspaceGatewayCustomModel>;
770
+ /** Remove one workspace custom Gateway model by its stable row id. */
771
+ deleteWorkspaceGatewayCustomModel(workspaceId: string, customModelId: string, request: DeleteWorkspaceGatewayCustomModelRequest): Promise<void>;
772
+ /** List workspace-owned unpinned OpenRouter model slugs. */
773
+ listWorkspaceOpenRouterCustomModels(workspaceId: string): Promise<WorkspaceOpenRouterCustomModelsResponse>;
774
+ /** Add one exact upstream OpenRouter slug. */
775
+ createWorkspaceOpenRouterCustomModel(workspaceId: string, request: CreateWorkspaceOpenRouterCustomModelRequest): Promise<WorkspaceOpenRouterCustomModel>;
776
+ /** Remove one workspace custom OpenRouter model by its stable row id. */
777
+ deleteWorkspaceOpenRouterCustomModel(workspaceId: string, customModelId: string, request: DeleteWorkspaceOpenRouterCustomModelRequest): Promise<void>;
778
+ /** Read metadata for one organization-owned model-provider connection. */
779
+ getWorkspaceClaudeSubscriptionUsage(workspaceId: string): Promise<ClaudeSubscriptionUsage>;
780
+ listClaudeSubscriptionAccounts(workspaceId: string): Promise<ClaudeSubscriptionAccountsResponse>;
781
+ activateClaudeSubscriptionAccount(workspaceId: string, accountId: string): Promise<{
782
+ activated: boolean;
783
+ accountId: string;
784
+ }>;
785
+ setClaudeSubscriptionRotationSettings(workspaceId: string, request: {
786
+ rotationEnabled: boolean;
787
+ }): Promise<SubscriptionPoolSettings>;
788
+ setClaudeSubscriptionAccountAllocator(workspaceId: string, accountId: string, request: {
789
+ enabled: boolean;
790
+ expectedVersion: number;
791
+ }): Promise<unknown>;
792
+ renameClaudeSubscriptionAccount(workspaceId: string, accountId: string, label: string | null): Promise<ClaudeSubscriptionAccount>;
793
+ disconnectClaudeSubscriptionAccount(workspaceId: string, accountId: string): Promise<unknown>;
794
+ getClaudeSubscriptionAccountUsage(workspaceId: string, accountId: string): Promise<ClaudeSubscriptionUsage>;
795
+ refreshClaudeSubscriptionAccountUsage(workspaceId: string, accountId: string): Promise<ClaudeSubscriptionUsage>;
796
+ listOrganizationClaudeSubscriptionAccounts(organizationId: string): Promise<ClaudeSubscriptionAccountsResponse>;
797
+ activateOrganizationClaudeSubscriptionAccount(organizationId: string, accountId: string): Promise<{
798
+ updated: boolean;
799
+ }>;
800
+ setOrganizationClaudeSubscriptionRotationSettings(organizationId: string, request: {
801
+ rotationEnabled: boolean;
802
+ }): Promise<SubscriptionPoolSettings>;
803
+ setOrganizationClaudeSubscriptionAccountAllocator(organizationId: string, accountId: string, request: {
804
+ enabled: boolean;
805
+ expectedVersion: number;
806
+ }): Promise<unknown>;
807
+ renameOrganizationClaudeSubscriptionAccount(organizationId: string, accountId: string, label: string | null): Promise<{
808
+ updated: boolean;
809
+ }>;
810
+ disconnectOrganizationClaudeSubscriptionAccount(organizationId: string, accountId: string): Promise<unknown>;
811
+ getOrganizationClaudeSubscriptionAccountUsage(organizationId: string, accountId: string): Promise<ClaudeSubscriptionUsage>;
812
+ refreshOrganizationClaudeSubscriptionAccountUsage(organizationId: string, accountId: string): Promise<ClaudeSubscriptionUsage>;
813
+ connectClaudeSubscriptionSetupToken(workspaceId: string, request: Omit<ClaudeSubscriptionSetupTokenRequest, "scope"> & {
814
+ scope?: "workspace" | "user";
815
+ }): Promise<ClaudeSubscriptionOAuthCompleteResponse>;
816
+ connectOrganizationClaudeSubscriptionSetupToken(organizationId: string, request: Omit<ClaudeSubscriptionSetupTokenRequest, "scope">): Promise<ClaudeSubscriptionOAuthCompleteResponse>;
817
+ /** Sign in with model and profile access; no inference request is made. */
818
+ startWorkspaceClaudeSubscriptionOAuth(workspaceId: string, request?: Partial<ClaudeSubscriptionOAuthStartRequest>): Promise<ClaudeSubscriptionOAuthStartResponse>;
819
+ completeWorkspaceClaudeSubscriptionOAuth(workspaceId: string, request: ClaudeSubscriptionOAuthCompleteRequest): Promise<ClaudeSubscriptionOAuthCompleteResponse>;
820
+ startOrganizationClaudeSubscriptionOAuth(organizationId: string, request?: Pick<ClaudeSubscriptionOAuthStartRequest, "reconnectAccountId">): Promise<ClaudeSubscriptionOAuthStartResponse>;
821
+ completeOrganizationClaudeSubscriptionOAuth(organizationId: string, request: ClaudeSubscriptionOAuthCompleteRequest): Promise<ClaudeSubscriptionOAuthCompleteResponse>;
822
+ refreshWorkspaceClaudeSubscriptionUsage(workspaceId: string): Promise<ClaudeSubscriptionUsage>;
823
+ getOrganizationClaudeSubscriptionUsage(organizationId: string): Promise<ClaudeSubscriptionUsage>;
824
+ refreshOrganizationClaudeSubscriptionUsage(organizationId: string): Promise<ClaudeSubscriptionUsage>;
825
+ /** Read metadata for one organization-owned model-provider connection. */
826
+ getOrganizationModelProviderConnection(organizationId: string, providerKind: OrganizationModelProviderKind): Promise<OrganizationModelProviderConnection | null>;
827
+ /** Connect or rotate one organization-owned provider credential. */
828
+ upsertOrganizationModelProviderConnection(organizationId: string, providerKind: OrganizationModelProviderKind, request: UpsertOrganizationModelProviderConnectionRequest): Promise<OrganizationModelProviderConnection>;
829
+ /** Revoke one organization-owned provider credential. */
830
+ revokeOrganizationModelProviderConnection(organizationId: string, providerKind: OrganizationModelProviderKind, request: RevokeOrganizationModelProviderConnectionRequest): Promise<OrganizationModelProviderConnection>;
831
+ /** List workspace-owned Claude model slugs. */
832
+ listWorkspaceClaudeCustomModels(workspaceId: string, providerKind: "anthropic" | "claude_subscription"): Promise<WorkspaceGatewayCustomModelsResponse>;
833
+ /** Add an immutable workspace-owned Claude model generation. */
834
+ createWorkspaceClaudeCustomModel(workspaceId: string, providerKind: "anthropic" | "claude_subscription", request: CreateWorkspaceGatewayCustomModelRequest): Promise<WorkspaceGatewayCustomModel>;
835
+ /** Retire a workspace-owned Claude model generation. */
836
+ deleteWorkspaceClaudeCustomModel(workspaceId: string, providerKind: "anthropic" | "claude_subscription", customModelId: string, request: DeleteWorkspaceGatewayCustomModelRequest): Promise<void>;
837
+ /** List organization-owned exact upstream model slugs. */
838
+ listOrganizationProviderCustomModels(organizationId: string, providerKind: OrganizationModelProviderKind): Promise<OrganizationProviderCustomModelsResponse>;
839
+ /** Add one organization-owned exact upstream model slug. */
840
+ createOrganizationProviderCustomModel(organizationId: string, providerKind: OrganizationModelProviderKind, request: CreateOrganizationProviderCustomModelRequest): Promise<OrganizationProviderCustomModel>;
841
+ /** Retire one organization-owned custom model. */
842
+ deleteOrganizationProviderCustomModel(organizationId: string, providerKind: OrganizationModelProviderKind, customModelId: string, request: DeleteOrganizationProviderCustomModelRequest): Promise<OrganizationProviderCustomModel>;
843
+ /** Read the workspace's hard provider/model allowlist. */
844
+ getWorkspaceModelAccessPolicy(workspaceId: string): Promise<WorkspaceModelAccessPolicy>;
845
+ /** Fully replace the workspace's hard provider/model allowlist. */
846
+ updateWorkspaceModelAccessPolicy(workspaceId: string, request: UpdateWorkspaceModelAccessPolicyRequest): Promise<WorkspaceModelAccessPolicy>;
537
847
  /** Authenticated realtime voice models and credential readiness. */
538
- getWorkspaceRealtimeModelCatalog(workspaceId: string): Promise<WorkspaceRealtimeModelCatalogResponse>;
539
- /** The caller's access context: subject, account + workspace grants, defaults. */
848
+ getWorkspaceRealtimeModelCatalog(workspaceId: string, options?: OpenGeniRequestOptions): Promise<WorkspaceRealtimeModelCatalogResponse>;
849
+ /**
850
+ * The caller's subject, grants, defaults, and optional direct API-key authority.
851
+ * `credential.effectiveWorkspacePermissions` expands workspace admin only for
852
+ * legacy keys; explicit policies retain exactly their selected grants. Full
853
+ * organization keys can provision shared workspaces, external members, and
854
+ * `asUser` sessions; user requests additionally need live membership.
855
+ * Organization-key scope excludes Personal workspaces. Neither key kind bypasses
856
+ * session visibility or the explicit `secrets:read` permission requirement. Credential
857
+ * metadata is omitted for `asUser`/external actors, humans, delegated tokens,
858
+ * other caller contexts, and older servers.
859
+ */
540
860
  getAccessContext(): Promise<AccessContext>;
541
861
  /** Active organization memberships proven by the current managed-human session. */
542
862
  listOrganizationMemberships(): Promise<ListManagedOrganizationMembershipsResponse>;
863
+ /** Bounded owner-only personal-resource authority page for one exact resource kind. */
864
+ listUserResourceAuthorities(workspaceId: string, options: ListUserResourceAuthoritiesOptions): Promise<ListUserResourceAuthoritiesResponse>;
865
+ /** Revoke an owner grant through the exact workspace it targets. */
866
+ revokeUserResourceGrant(workspaceId: string, grantId: string): Promise<RevokeUserResourceGrantResponse>;
867
+ /** Create a new organization owned by the current managed human. */
868
+ createOrganization(request: CreateOrganizationRequest): Promise<CreateOrganizationResponse>;
869
+ /** Create another organization owned by the current managed human. */
870
+ createAdditionalOrganization(request: CreateAdditionalOrganizationRequest): Promise<CreateAdditionalOrganizationResponse>;
871
+ /** Pending and historical invitations addressed to the current managed human. */
872
+ listOrganizationInvitations(options?: {
873
+ cursor?: string;
874
+ limit?: number;
875
+ }): Promise<ListOrganizationInvitationsPageResponse>;
876
+ /** Admin-only deterministic page of invitations for one organization. */
877
+ listOrganizationInvitationsForOrganization(organizationId: string, options?: {
878
+ cursor?: string;
879
+ limit?: number;
880
+ }): Promise<ListOrganizationInvitationsPageResponse>;
881
+ createOrganizationInvitation(organizationId: string, request: CreateOrganizationInvitationRequest): Promise<OrganizationInvitation>;
882
+ acceptOrganizationInvitation(invitationId: string, request: AcceptOrganizationInvitationRequest): Promise<AcceptOrganizationInvitationResponse>;
883
+ revokeOrganizationInvitation(organizationId: string, invitationId: string, request: RevokeOrganizationInvitationRequest): Promise<OrganizationInvitation>;
884
+ listOrganizationAdministrationMembers(organizationId: string): Promise<ListOrganizationAdministrationMembersResponse>;
885
+ /** @deprecated Use listOrganizationAdministrationMembers for its privacy-safe projection. */
886
+ listOrganizationMembers(organizationId: string): Promise<ListOrganizationAdministrationMembersResponse>;
887
+ /** Canonical organization identity and every non-personal workspace access roster. */
888
+ getOrganizationAdministrationOverview(organizationId: string): Promise<OrganizationAdministrationOverview>;
889
+ /** Create a shared workspace and grant its creator explicit workspace-admin access. */
890
+ createOrganizationWorkspace(organizationId: string, request: CreateOrganizationWorkspaceRequest): Promise<OrganizationWorkspaceAccess>;
891
+ /** Rename one shared workspace under an exact optimistic-concurrency fence. */
892
+ updateOrganizationWorkspace(organizationId: string, workspaceId: string, request: UpdateOrganizationWorkspaceRequest): Promise<OrganizationWorkspaceAccess>;
893
+ updateOrganizationWorkspaceSettings(organizationId: string, workspaceId: string, request: UpdateWorkspaceSettingsRequest): Promise<Workspace>;
894
+ /**
895
+ * Delete an organization (shared) workspace. Accepts an organization owner
896
+ * session or an organization API key with `workspace:admin` (for tenant
897
+ * offboarding); never deletes a Personal workspace. 409 until quiescent.
898
+ */
899
+ deleteOrganizationWorkspace(organizationId: string, workspaceId: string): Promise<void>;
900
+ putOrganizationWorkspaceMember(organizationId: string, workspaceId: string, membershipId: string, request: PutOrganizationWorkspaceMemberRequest): Promise<OrganizationWorkspaceAccessMember>;
901
+ revokeOrganizationWorkspaceMember(organizationId: string, workspaceId: string, membershipId: string, request: RevokeOrganizationWorkspaceMemberRequest): Promise<RevokeOrganizationWorkspaceMemberResponse>;
902
+ /** Rename the organization under an exact optimistic-concurrency fence. */
903
+ updateOrganizationName(organizationId: string, request: UpdateOrganizationNameRequest): Promise<OrganizationSummary>;
904
+ updateOrganizationMember(organizationId: string, membershipId: string, request: UpdateOrganizationMemberRequest): Promise<OrganizationMember>;
905
+ getOrganizationRetentionPolicy(organizationId: string): Promise<OrganizationRetentionPolicy>;
906
+ updateOrganizationRetentionPolicy(organizationId: string, request: UpdateOrganizationRetentionPolicyRequest): Promise<OrganizationRetentionPolicy>;
907
+ getOrganizationRecovery(organizationId: string): Promise<OrganizationRecoveryOverview>;
908
+ configureOrganizationRecoveryPolicy(organizationId: string, request: ConfigureOrganizationRecoveryPolicyRequest): Promise<OrganizationRecoveryMutationResponse>;
909
+ acceptOrganizationRecoveryCustody(organizationId: string, request: AcceptOrganizationRecoveryCustodyRequest): Promise<OrganizationRecoveryMutationResponse>;
910
+ disableOrganizationRecoveryPolicy(organizationId: string, request: DisableOrganizationRecoveryPolicyRequest): Promise<OrganizationRecoveryMutationResponse>;
911
+ startOrganizationRecoveryOperation(organizationId: string, request: StartOrganizationRecoveryOperationRequest): Promise<OrganizationRecoveryMutationResponse>;
912
+ approveOrganizationRecoveryOperation(organizationId: string, recoveryOperationId: string, request: OrganizationRecoveryOperationCommandRequest): Promise<OrganizationRecoveryMutationResponse>;
913
+ cancelOrganizationRecoveryOperation(organizationId: string, recoveryOperationId: string, request: OrganizationRecoveryOperationCommandRequest): Promise<OrganizationRecoveryMutationResponse>;
914
+ executeOrganizationRecoveryOperation(organizationId: string, recoveryOperationId: string, request: OrganizationRecoveryOperationCommandRequest): Promise<OrganizationRecoveryMutationResponse>;
915
+ searchPublicSkills(workspaceId: string, query: string): Promise<{
916
+ provider: "skills_sh";
917
+ query: string;
918
+ items: Array<{
919
+ id: string;
920
+ name: string;
921
+ source: string;
922
+ skillId: string;
923
+ url: string;
924
+ installs: number;
925
+ }>;
926
+ nextCursor: null;
927
+ }>;
543
928
  listWorkspaces(): Promise<Workspace[]>;
929
+ /** Uses this client's fixed actor and standard contract/error/abort handling.
930
+ * Disconnect revokes OpenGeni connection access, not upstream provider consent. */
931
+ connectTransport(): import("@opengeni/connect").ConnectTransport;
932
+ /** Browse first-party Atlassian sources without choosing or starting sync. */
933
+ browseAtlassianSources(workspaceId: string, connectionId: string): Promise<import("@opengeni/contracts/atlassian").AtlassianBrowseResponse>;
934
+ saveAtlassianSources(workspaceId: string, connectionId: string, request: import("@opengeni/contracts/atlassian").SaveAtlassianSourcesRequest): Promise<import("./types.js").ConnectionResponse>;
935
+ setAtlassianLifecycle(workspaceId: string, connectionId: string, request: import("@opengeni/contracts/atlassian").AtlassianLifecycleActionRequest): Promise<import("./types.js").ConnectionResponse>;
936
+ /** Begin durable setup. Completion requirements are provider-specific. */
937
+ beginConnect(workspaceId: string, request: {
938
+ providerId: string;
939
+ ownership: "personal" | "workspace";
940
+ returnUrl: string;
941
+ idempotencyKey: string;
942
+ reconnectAccountId?: string;
943
+ installationTarget?: import("@opengeni/contracts/connect").ConnectInstallationTarget;
944
+ }): Promise<import("@opengeni/contracts/connect").ConnectAttempt>;
544
945
  createWorkspace(request: CreateWorkspaceRequest): Promise<Workspace>;
946
+ /**
947
+ * Create an organization workspace once for a stable external tenant
948
+ * identity, or return the existing workspace without overwriting it.
949
+ */
950
+ ensureWorkspace(request: EnsureWorkspaceRequest): Promise<EnsureWorkspaceResponse>;
545
951
  getWorkspace(workspaceId: string): Promise<Workspace>;
546
952
  /** Read-time, secret-safe inventory of policy heads and visible workspace knowledge. */
547
953
  getWorkspaceState(workspaceId: string, options?: WorkspaceStateGetOptions): Promise<WorkspaceStateResponse>;
@@ -550,8 +956,13 @@ export declare class OpenGeniClient {
550
956
  updateWorkspace(workspaceId: string, request: UpdateWorkspaceRequest): Promise<Workspace>;
551
957
  /** Inspect immutable instruction-policy history, active heads, and activation audit evidence. */
552
958
  listWorkspaceInstructionPolicies(workspaceId: string, options?: WorkspaceInstructionPolicyListOptions): Promise<WorkspaceInstructionPolicyListResponse>;
959
+ /** Inspect the bounded, permission-filtered governed-learning timeline. */
960
+ getWorkspaceLearningHistory(workspaceId: string, options?: WorkspaceLearningHistoryOptions): Promise<WorkspaceLearningHistoryResponse>;
961
+ undoGovernedLearningActivation(workspaceId: string, activationReceiptId: string, request?: {
962
+ operationId?: string;
963
+ }): Promise<GovernedLearningActivationUndoReceipt>;
553
964
  getWorkspaceInstructionPolicyRevision(workspaceId: string, revisionId: string): Promise<WorkspaceInstructionPolicyRevision>;
554
- createWorkspaceInstructionPolicyDraft(workspaceId: string, request: CreateWorkspaceInstructionPolicyDraftRequest): Promise<WorkspaceInstructionPolicyRevision>;
965
+ createWorkspaceInstructionPolicyDraft(workspaceId: string, request: CreateWorkspaceInstructionPolicyDraftRequest, options?: OpenGeniRequestOptions): Promise<WorkspaceInstructionPolicyRevision>;
555
966
  /** List the newest immutable onboarding proposals and their inactive policy drafts. */
556
967
  listWorkspaceInstructionPolicyOnboardingProposals(workspaceId: string, options?: WorkspaceInstructionPolicyOnboardingProposalListOptions): Promise<WorkspaceInstructionPolicyOnboardingProposalListResponse>;
557
968
  /** Create one draft-only proposal against an exact active-policy baseline. */
@@ -559,11 +970,13 @@ export declare class OpenGeniClient {
559
970
  /** Import the stored legacy workspace override as an inactive charter draft. */
560
971
  importLegacyWorkspaceInstructionPolicyDraft(workspaceId: string, request?: ImportLegacyWorkspaceInstructionPolicyDraftRequest): Promise<WorkspaceInstructionPolicyRevision>;
561
972
  diffWorkspaceInstructionPolicyRevisions(workspaceId: string, request: WorkspaceInstructionPolicyDiffRequest): Promise<WorkspaceInstructionPolicyDiffResponse>;
562
- activateWorkspaceInstructionPolicyRevision(workspaceId: string, revisionId: string, request: ActivateWorkspaceInstructionPolicyRequest): Promise<WorkspaceInstructionPolicyActivationResponse>;
973
+ activateWorkspaceInstructionPolicyRevision(workspaceId: string, revisionId: string, request: ActivateWorkspaceInstructionPolicyRequest, options?: OpenGeniRequestOptions): Promise<WorkspaceInstructionPolicyActivationResponse>;
563
974
  rollbackWorkspaceInstructionPolicyRevision(workspaceId: string, request: RollbackWorkspaceInstructionPolicyRequest): Promise<WorkspaceInstructionPolicyActivationResponse>;
564
975
  /** Read the current organization profile plus immutable revision and activation history. */
565
976
  listCompanyProfile(workspaceId: string, options?: CompanyProfileListOptions): Promise<CompanyProfileListResponse>;
566
977
  getCompanyProfileRevision(workspaceId: string, revisionId: string): Promise<CompanyProfileRevision>;
978
+ getCompanyProfileAgentPolicy(workspaceId: string): Promise<CompanyProfileAgentPolicy>;
979
+ updateCompanyProfileAgentPolicy(workspaceId: string, request: UpdateCompanyProfileAgentPolicyRequest): Promise<CompanyProfileAgentPolicy>;
567
980
  updateCompanyProfile(workspaceId: string, request: UpdateCompanyProfileRequest): Promise<CompanyProfileMutationResponse>;
568
981
  diffCompanyProfileRevisions(workspaceId: string, request: CompanyProfileDiffRequest): Promise<CompanyProfileDiffResponse>;
569
982
  activateCompanyProfileRevision(workspaceId: string, revisionId: string, request: ActivateCompanyProfileRevisionRequest): Promise<CompanyProfileMutationResponse>;
@@ -586,9 +999,10 @@ export declare class OpenGeniClient {
586
999
  deleteWorkspace(workspaceId: string): Promise<void>;
587
1000
  /** The workspace's members (user + api_key subjects). */
588
1001
  listWorkspaceMembers(workspaceId: string): Promise<WorkspaceMember[]>;
1002
+ /** Active organization members who can be added to this workspace. */
1003
+ listWorkspaceMemberCandidates(workspaceId: string): Promise<WorkspaceMemberCandidate[]>;
589
1004
  /**
590
- * Add an already-registered user by email. 404s when no user with that email
591
- * exists (email invites for unknown users are deferred).
1005
+ * Add one active member selected from the workspace candidate inventory.
592
1006
  */
593
1007
  addWorkspaceMember(workspaceId: string, request: AddWorkspaceMemberRequest): Promise<WorkspaceMember>;
594
1008
  updateWorkspaceMember(workspaceId: string, subjectId: string, request: UpdateWorkspaceMemberRequest): Promise<WorkspaceMember>;
@@ -621,7 +1035,17 @@ export declare class OpenGeniClient {
621
1035
  listScheduledTaskRuns(workspaceId: string, taskId: string, options?: {
622
1036
  limit?: number;
623
1037
  }): Promise<ScheduledTaskRun[]>;
1038
+ /**
1039
+ * Re-freeze a task's connectors, connector accounts and OpenGeni tool policy
1040
+ * with the signed-in caller's current authority. Pass the `executionDigest`
1041
+ * of the task whose `policyDrift` was reviewed; a changed task returns 409.
1042
+ */
1043
+ refreshScheduledTaskAccess(workspaceId: string, taskId: string, request: RefreshScheduledTaskAccessRequest): Promise<ScheduledTask>;
1044
+ /** Schedules the caller can act on whose latest run could not use a connector. */
1045
+ listScheduledTaskAccessAttention(workspaceId: string): Promise<ScheduledTaskAccessAttention[]>;
624
1046
  listVariableSets(workspaceId: string): Promise<VariableSet[]>;
1047
+ /** Resolve only caller-supplied attachment ids without enumerating the catalog. */
1048
+ resolveVariableSetAttachments(workspaceId: string, request: ResolveVariableSetAttachmentsRequest): Promise<ResolveVariableSetAttachmentsResponse>;
625
1049
  createVariableSet(workspaceId: string, request: CreateVariableSetRequest): Promise<VariableSet>;
626
1050
  getVariableSet(workspaceId: string, variableSetId: string): Promise<VariableSet>;
627
1051
  getVariableSetVariable(workspaceId: string, variableSetId: string, name: string): Promise<VariableSetSecret>;
@@ -633,6 +1057,7 @@ export declare class OpenGeniClient {
633
1057
  listChannels(workspaceId: string): Promise<Channel[]>;
634
1058
  createChannel(workspaceId: string, request: CreateChannelRequest): Promise<Channel>;
635
1059
  updateChannel(workspaceId: string, channelId: string, request: UpdateChannelRequest): Promise<Channel>;
1060
+ reorderChannels(workspaceId: string, request: ReorderChannelsRequest): Promise<Channel[]>;
636
1061
  deleteChannel(workspaceId: string, channelId: string): Promise<void>;
637
1062
  /** Re-file a session into a channel (null = back to the unfiled inbox). */
638
1063
  updateSessionChannel(workspaceId: string, sessionId: string, request: UpdateSessionChannelRequest): Promise<Session>;
@@ -693,7 +1118,10 @@ export declare class OpenGeniClient {
693
1118
  * -> complete. Returns the ready `FileAsset`.
694
1119
  */
695
1120
  uploadFile(workspaceId: string, input: UploadFileInput): Promise<FileAsset>;
696
- getFile(workspaceId: string, fileId: string): Promise<FileAsset>;
1121
+ listFiles(workspaceId: string, options?: import("./types.js").FileListRequest): Promise<import("./types.js").FileListResponse>;
1122
+ getFile(workspaceId: string, fileId: string, options?: OpenGeniRequestOptions & {
1123
+ sessionId?: string | undefined;
1124
+ }): Promise<FileAsset>;
697
1125
  /** Read provider-neutral retained evidence metadata; never returns a storage location. */
698
1126
  getRetainedArtifact(workspaceId: string, artifactId: string): Promise<RetainedArtifactMetadata>;
699
1127
  /**
@@ -703,16 +1131,18 @@ export declare class OpenGeniClient {
703
1131
  getRetainedArtifactContent(workspaceId: string, artifactId: string, options?: RetainedArtifactContentOptions): Promise<RetainedArtifactContent>;
704
1132
  getSessionRetainedArtifact(workspaceId: string, sessionId: string, artifactId: string): Promise<RetainedArtifactMetadata>;
705
1133
  getSessionRetainedArtifactContent(workspaceId: string, sessionId: string, artifactId: string, options?: RetainedArtifactContentOptions): Promise<RetainedArtifactContent>;
706
- /** Assemble one permanent generated-image receipt from bounded authenticated ranges. */
1134
+ /** Assemble one permanent image or file artifact from bounded authenticated ranges. */
707
1135
  downloadRetainedArtifact(workspaceId: string, artifact: RetainedArtifactReference, options?: RetainedArtifactDownloadOptions): Promise<RetainedArtifactDownload>;
708
- /** Mint a short-lived, zero-copy browser source for a validated generated image. */
1136
+ /** Mint a short-lived, zero-copy browser source for a validated workspace artifact. */
709
1137
  createRetainedArtifactDownloadUrl(workspaceId: string, artifact: RetainedArtifactReference, options?: OpenGeniRequestOptions): Promise<FileDownloadUrlResponse>;
710
1138
  /** Assemble one retained screenshot from bounded authenticated API ranges. */
711
1139
  downloadRetainedScreenshot(workspaceId: string, sessionId: string, artifactId: string, options?: RetainedScreenshotDownloadOptions): Promise<RetainedScreenshotDownload>;
712
1140
  private downloadRetainedArtifactBytes;
713
1141
  private getRetainedArtifactContentAtPath;
714
1142
  /** Mint a short-lived signed download URL for a ready file. */
715
- createFileDownloadUrl(workspaceId: string, fileId: string, options?: OpenGeniRequestOptions): Promise<FileDownloadUrlResponse>;
1143
+ createFileDownloadUrl(workspaceId: string, fileId: string, options?: OpenGeniRequestOptions & {
1144
+ sessionId?: string | undefined;
1145
+ }): Promise<FileDownloadUrlResponse>;
716
1146
  /** Read the effective workspace policy and executable Seedance capabilities. */
717
1147
  getVideoGenerationSettings(workspaceId: string, options?: OpenGeniRequestOptions): Promise<WorkspaceVideoGenerationSettings>;
718
1148
  /** Replace the enabled video models/default under optimistic policy revision control. */
@@ -722,11 +1152,12 @@ export declare class OpenGeniClient {
722
1152
  /** Mint a short-lived zero-copy URL for native Range-based video playback. */
723
1153
  createVideoArtifactPlaybackSource(workspaceId: string, artifactId: string, options?: OpenGeniRequestOptions): Promise<VideoArtifactPlaybackSource>;
724
1154
  createDocumentBase(workspaceId: string, request: CreateDocumentBaseRequest): Promise<DocumentBase>;
725
- listDocumentBases(workspaceId: string): Promise<DocumentBase[]>;
726
1155
  getDocumentBase(workspaceId: string, baseId: string): Promise<DocumentBase>;
727
1156
  /** Index an uploaded file into the base. The file must be `ready`. */
728
1157
  addDocument(workspaceId: string, baseId: string, request: AddDocumentRequest): Promise<Document>;
729
1158
  listDocuments(workspaceId: string, baseId: string): Promise<Document[]>;
1159
+ /** Read the immutable source file through the Document's effective authority. */
1160
+ getDocumentOriginalFile(workspaceId: string, documentId: string): Promise<FileAsset>;
730
1161
  /**
731
1162
  * Drop raw text or an already-uploaded file into the workspace's Default
732
1163
  * base. When curation is enabled, it may name, summarize, categorize, and
@@ -739,51 +1170,93 @@ export declare class OpenGeniClient {
739
1170
  * targetBaseId, applies the document's stored curation suggestion.
740
1171
  */
741
1172
  moveDocument(workspaceId: string, documentId: string, request?: MoveDocumentRequest): Promise<Document>;
742
- /** Retry indexing for a failed document. */
743
- reindexDocument(workspaceId: string, baseId: string, documentId: string): Promise<Document>;
744
1173
  /**
745
1174
  * Delete a document from a base. Removes the document row and its indexed
746
1175
  * chunks while leaving the uploaded file asset available for other uses.
747
1176
  */
748
1177
  deleteDocument(workspaceId: string, baseId: string, documentId: string): Promise<void>;
749
- searchDocuments(workspaceId: string, baseId: string, request: Omit<DocumentSearchRequest, "baseIds">): Promise<DocumentSearchResponse>;
750
- searchKnowledge(workspaceId: string, request: DocumentSearchRequest): Promise<DocumentSearchResponse>;
751
- listKnowledgeMemories(workspaceId: string, request?: KnowledgeMemorySearchRequest): Promise<KnowledgeMemory[]>;
752
- getKnowledgeMemory(workspaceId: string, memoryId: string): Promise<KnowledgeMemory>;
753
- createKnowledgeMemory(workspaceId: string, request: CreateKnowledgeMemoryRequest): Promise<KnowledgeMemory>;
754
- updateKnowledgeMemory(workspaceId: string, memoryId: string, request: UpdateKnowledgeMemoryRequest): Promise<KnowledgeMemory>;
755
- /** Hybrid (semantic + keyword) search over the workspace's agent-visible memory. */
756
- searchWorkspaceMemories(workspaceId: string, request: WorkspaceMemorySearchRequest): Promise<WorkspaceMemorySearchResponse>;
1178
+ /** Unified retained sources, findings and groups. Only published entries are returned by default. */
1179
+ listKnowledgeEntries(workspaceId: string, request?: KnowledgeEntryListRequest): Promise<KnowledgeEntryListResponse>;
1180
+ getKnowledgeEntry(workspaceId: string, entryId: string, options?: {
1181
+ revisionId?: string;
1182
+ view?: "published" | "needs_review" | "archived" | "rejected";
1183
+ }): Promise<KnowledgeEntryRecord>;
1184
+ /** Open the original file associated with an accessible retained source revision. */
1185
+ createKnowledgeFileDownloadUrl(workspaceId: string, entryId: string, revisionId?: string): Promise<KnowledgeOriginalFileDownload>;
1186
+ saveKnowledgeEntry(workspaceId: string, request: KnowledgeEntrySaveRequest): Promise<KnowledgeEntryWriteReceipt>;
1187
+ reviewKnowledgeEntry(workspaceId: string, request: KnowledgeEntryReviewRequest): Promise<KnowledgeEntryWriteReceipt>;
1188
+ listKnowledgeReviewBatches(workspaceId: string, options?: KnowledgeReviewBatchListRequest): Promise<KnowledgeReviewBatchListResponse>;
1189
+ /** Atomically review up to 100 selected entries, including their pending dependencies. */
1190
+ reviewKnowledgeEntries(workspaceId: string, request: KnowledgeEntryBatchReviewRequest): Promise<{
1191
+ receipts: KnowledgeEntryWriteReceipt[];
1192
+ }>;
1193
+ listKnowledgeEntryHistory(workspaceId: string, entryId: string, beforeRevision?: number): Promise<{
1194
+ entries: KnowledgeEntryListResponse["entries"];
1195
+ beforeRevision: number | null;
1196
+ }>;
1197
+ restoreKnowledgeEntry(workspaceId: string, request: KnowledgeEntryRestoreRequest): Promise<KnowledgeEntryWriteReceipt>;
1198
+ archiveKnowledgeEntry(workspaceId: string, entryId: string, request: {
1199
+ operationId: string;
1200
+ expectedVersion: number;
1201
+ }): Promise<KnowledgeEntryWriteReceipt>;
1202
+ getAgentLearningSettings(workspaceId: string, scope: "workspace" | "personal" | "context", source?: AgentLearningContext): Promise<AgentLearningSettingsRecord>;
1203
+ saveAgentLearningSettings(workspaceId: string, request: SaveAgentLearningSettingsRequest): Promise<AgentLearningSettingsRecord>;
1204
+ listAgentLearningOverrides(workspaceId: string, scope: "workspace" | "personal"): Promise<AgentLearningOverrideRecord[]>;
1205
+ reviewAgentInstruction(workspaceId: string, request: AgentInstructionReviewRequest): Promise<AgentInstructionReceipt>;
1206
+ listAgentInstructionReviews(workspaceId: string, cursor?: string): Promise<AgentInstructionReviewListResponse>;
757
1207
  /** Deep-merge a settings patch into the workspace (preserves unknown keys). */
758
1208
  updateWorkspaceSettings(workspaceId: string, request: UpdateWorkspaceSettingsRequest): Promise<Workspace>;
759
1209
  setWorkspaceDefaultRig(workspaceId: string, request: SetWorkspaceDefaultRigRequest): Promise<Workspace>;
760
- /** Built-in + registered packs, with the workspace's installations. */
761
- listPacks(workspaceId: string): Promise<ListPacksResponse>;
762
- /** Register (or replace) a workspace-scoped pack from a manifest. */
763
- registerPack(workspaceId: string, manifest: RegisterCapabilityPackRequest): Promise<WorkspaceRegisteredPack>;
764
- getPack(workspaceId: string, packId: string): Promise<GetPackResponse>;
765
- enablePack(workspaceId: string, packId: string, request?: EnablePackRequest): Promise<PackInstallation>;
766
1210
  /** Resolve pinned components, Variable Set, and Rig requirements before installation. */
767
- previewPackInstallation(workspaceId: string, packId: string, request?: PreviewPackInstallationRequest): Promise<PackInstallationPreview>;
768
- /** Install, update, or repair a Pack from an exact previewed manifest. */
769
- installPack(workspaceId: string, packId: string, request: InstallPackRequest): Promise<PackInstallation>;
770
- /** Preview which Pack-owned components will be retained by other owners. */
771
- previewPackUninstall(workspaceId: string, packId: string): Promise<PackUninstallPreview>;
772
- /** Safely release Pack ownership and disable only now-ownerless components. */
773
- uninstallPack(workspaceId: string, packId: string, request: UninstallPackRequest): Promise<UninstallPackResult>;
774
- /** Unregister a workspace-scoped pack (built-in packs cannot be deleted). */
775
- deletePack(workspaceId: string, packId: string): Promise<void>;
776
- listPackInstallations(workspaceId: string): Promise<PackInstallation[]>;
777
1211
  listCapabilities(workspaceId: string): Promise<CapabilityCatalogResponse>;
778
1212
  /** Add a manual capability catalog item (e.g. a remote MCP server). */
779
1213
  createCapability(workspaceId: string, request: CreateCapabilityCatalogItemRequest): Promise<CapabilityCatalogItem>;
1214
+ getConnectorToolPermissions(workspaceId: string, capabilityId: string, options?: {
1215
+ signal?: AbortSignal;
1216
+ }): Promise<ConnectorToolPermissionsResponse>;
1217
+ updateConnectorToolPermissions(workspaceId: string, capabilityId: string, request: UpdateConnectorToolPermissionsRequest, options?: {
1218
+ signal?: AbortSignal;
1219
+ }): Promise<{
1220
+ saved: boolean;
1221
+ }>;
780
1222
  enableCapability(workspaceId: string, capabilityId: string, request?: EnableCapabilityRequest): Promise<CapabilityInstallation>;
781
1223
  disableCapability(workspaceId: string, capabilityId: string): Promise<CapabilityInstallation>;
1224
+ /** Read-only, permission-filtered workspace or session output discovery. */
1225
+ listArtifactCatalog(workspaceId: string, options?: ArtifactCatalogListOptions & {
1226
+ signal?: AbortSignal;
1227
+ }): Promise<ArtifactCatalogListResponse>;
1228
+ listWorkspaceArtifacts(workspaceId: string, options?: WorkspaceArtifactListOptions & {
1229
+ signal?: AbortSignal;
1230
+ }): Promise<WorkspaceArtifactListResponse>;
1231
+ getWorkspaceArtifact(workspaceId: string, artifactId: string, options?: {
1232
+ signal?: AbortSignal;
1233
+ }): Promise<WorkspaceArtifactDetailResponse>;
1234
+ /** Display-only HTML delivery: do not download the retained source bundle to render a Site. */
1235
+ getWorkspaceArtifactHtml(workspaceId: string, artifactId: string, options: {
1236
+ versionId: string;
1237
+ signal?: AbortSignal;
1238
+ }): Promise<string>;
1239
+ rollbackWorkspaceArtifact(workspaceId: string, artifactId: string, request: RollbackWorkspaceArtifactRequest, options?: {
1240
+ signal?: AbortSignal;
1241
+ }): Promise<WorkspaceArtifactMutationResponse>;
1242
+ setWorkspaceArtifactStatus(workspaceId: string, artifactId: string, request: SetWorkspaceArtifactStatusRequest, options?: {
1243
+ signal?: AbortSignal;
1244
+ }): Promise<WorkspaceArtifactMutationResponse>;
782
1245
  /** Search the official MCP registry for installable capabilities. */
783
1246
  discoverMcpCapabilities(workspaceId: string, options?: {
784
1247
  query?: string;
785
1248
  limit?: number;
786
1249
  }): Promise<DiscoverMcpCapabilitiesResponse>;
1250
+ discoverPlugins(workspaceId: string, options?: {
1251
+ id?: string;
1252
+ query?: string;
1253
+ provider?: string;
1254
+ offset?: number;
1255
+ }): Promise<import("@opengeni/contracts").PluginDiscoveryPage>;
1256
+ inspectMcpAuthentication(workspaceId: string, url: string): Promise<{
1257
+ kind: "oauth2" | "none" | "unknown";
1258
+ message?: string;
1259
+ }>;
787
1260
  /** List installed protocol-neutral OpenAPI and GraphQL Integrations. */
788
1261
  listApiIntegrations(workspaceId: string): Promise<ListApiIntegrationsResponse>;
789
1262
  /** List curated provider definitions without exposing deployment OAuth credentials. */
@@ -813,6 +1286,7 @@ export declare class OpenGeniClient {
813
1286
  removeIntegrationFacet(workspaceId: string, capabilityId: string, instanceKey: string, facetKey: string, request: MutateIntegrationFacetRequest): Promise<IntegrationFacetRemovalResult>;
814
1287
  private mutateIntegrationFacetLifecycle;
815
1288
  previewPlugin(workspaceId: string, request: PreviewPluginRequest): Promise<PluginPreview>;
1289
+ getInstalledPluginDetails(workspaceId: string, pluginKey: string): Promise<import("@opengeni/contracts").PluginDiscoveryItem>;
816
1290
  listInstalledPlugins(workspaceId: string): Promise<ListInstalledPluginsResponse>;
817
1291
  installPlugin(workspaceId: string, request: InstallPluginRequest): Promise<InstalledPlugin>;
818
1292
  previewPluginUninstall(workspaceId: string, pluginKey: string): Promise<PluginUninstallPreview>;
@@ -823,12 +1297,47 @@ export declare class OpenGeniClient {
823
1297
  installSkill(workspaceId: string, request: InstallSkillRequest): Promise<InstalledSkill>;
824
1298
  /** List Skills from the authoritative Plugin/Skill-Facet installation ledger. */
825
1299
  listInstalledSkills(workspaceId: string): Promise<ListInstalledSkillsResponse>;
1300
+ /** Shared authored/installed catalog metadata. File bodies are read on demand. */
1301
+ listWorkspaceSkills(workspaceId: string, options?: {
1302
+ cursor?: string;
1303
+ limit?: number;
1304
+ sessionId?: string;
1305
+ }): Promise<{
1306
+ skills: SkillSummary[];
1307
+ nextCursor: string | null;
1308
+ }>;
1309
+ readWorkspaceSkill(workspaceId: string, skillId: string, revisionId?: string): Promise<SkillRecord>;
1310
+ saveWorkspaceSkill(workspaceId: string, request: SaveWorkspaceSkillRequest): Promise<SkillWriteReceipt>;
1311
+ /** Permanently remove a personal/workspace Skill and all its saved revisions. */
1312
+ removeWorkspaceSkill(workspaceId: string, skillId: string, request: RemoveWorkspaceSkillRequest): Promise<SkillWriteReceipt>;
1313
+ approveWorkspaceSkill(workspaceId: string, skillId: string, request: ApplyWorkspaceSkillRevisionRequest): Promise<SkillWriteReceipt>;
1314
+ restoreWorkspaceSkill(workspaceId: string, skillId: string, request: ApplyWorkspaceSkillRevisionRequest): Promise<SkillWriteReceipt>;
1315
+ rejectWorkspaceSkill(workspaceId: string, skillId: string, request: ApplyWorkspaceSkillRevisionRequest): Promise<SkillWriteReceipt>;
826
1316
  /** Install one exact reviewed curated-library Skill through the Skill domain. */
827
1317
  installLibrarySkill(workspaceId: string, libraryId: string, request: InstallLibrarySkillRequest): Promise<InstalledSkill>;
828
1318
  previewSkillUninstall(workspaceId: string, capabilityId: string): Promise<SkillUninstallPreview>;
829
1319
  /** Remove the direct owner under an optimistic installation-version fence. */
830
1320
  uninstallSkill(workspaceId: string, capabilityId: string, request: UninstallSkillRequest): Promise<UninstallSkillResult>;
1321
+ /** This authenticated user's accounts across the organization, plus current-workspace shared accounts.
1322
+ * Inactive accounts are opt-in for settings display; execution pickers keep the active default. */
1323
+ listOwnConnectionAccounts(workspaceId: string, options?: {
1324
+ includeInactive?: boolean;
1325
+ }): Promise<ConnectionMetadata[]>;
831
1326
  listConnections(workspaceId: string): Promise<ConnectionMetadata[]>;
1327
+ /** Secret-free status for the caller's exact personal GitHub connection. */
1328
+ personalGitHubStatus(workspaceId: string): Promise<PersonalGitHubConnectionStatusResponse>;
1329
+ /** Start the dedicated personal GitHub authorization-code + PKCE flow. */
1330
+ startPersonalGitHubOAuth(workspaceId: string, request?: Omit<PersonalGitHubOAuthStartRequest, "connectionId">): Promise<PersonalGitHubOAuthStartResponse>;
1331
+ /** Re-authorize one exact personal GitHub Connection generation in place. */
1332
+ reconnectPersonalGitHub(workspaceId: string, connectionId: string, request?: Omit<PersonalGitHubOAuthStartRequest, "connectionId">): Promise<PersonalGitHubOAuthStartResponse>;
1333
+ /** Revoke one exact generation through an idempotent owner-only disconnect. */
1334
+ disconnectPersonalGitHub(workspaceId: string, connectionId: string, request: PersonalGitHubDisconnectRequest): Promise<ConnectionMetadata>;
1335
+ /** Browse one bounded page of repositories visible to one exact owner connection. */
1336
+ listPersonalGitHubRepositories(workspaceId: string, connectionId: string, options?: ListPersonalGitHubRepositoriesOptions): Promise<ListPersonalGitHubRepositoriesResponse>;
1337
+ /** Atomically replace the exact owner connection's selected repository set. */
1338
+ replacePersonalGitHubRepositorySelections(workspaceId: string, connectionId: string, request: ReplacePersonalGitHubRepositorySelectionsRequest): Promise<PersonalGitHubRepositorySelectionState>;
1339
+ /** Revalidate every selected repository without accepting provider URLs from the caller. */
1340
+ verifyPersonalGitHubRepositorySelections(workspaceId: string, connectionId: string, request: VerifyPersonalGitHubRepositorySelectionsRequest): Promise<PersonalGitHubRepositorySelectionState>;
832
1341
  /** List the secret-free Slack team -> OpenGeni tenant routing authority. */
833
1342
  listSlackInstallationBindings(workspaceId: string): Promise<SlackInstallationBinding[]>;
834
1343
  createConnection(workspaceId: string, request: CreateConnectionRequest): Promise<ConnectionMetadata>;
@@ -842,6 +1351,8 @@ export declare class OpenGeniClient {
842
1351
  /** Start the public Slack installation flow for the workspace-shared OpenGeni bot. */
843
1352
  startOpenGeniSlackBotInstall(workspaceId: string, request?: OpenGeniSlackBotInstallRequest): Promise<OpenGeniSlackBotInstallStart>;
844
1353
  listOpenGeniSlackReactionChannels(workspaceId: string, connectionId: string, cursor?: string): Promise<SlackReactionChannelListResponse>;
1354
+ listOpenGeniSlackChannelRoutes(workspaceId: string, connectionId: string): Promise<SlackChannelRouteListResponse>;
1355
+ updateOpenGeniSlackChannelRoutes(workspaceId: string, request: UpdateSlackChannelRoutesRequest): Promise<void>;
845
1356
  updateConnection(workspaceId: string, connectionId: string, request: UpdateConnectionRequest): Promise<ConnectionMetadata>;
846
1357
  deleteConnection(workspaceId: string, connectionId: string): Promise<ConnectionMetadata>;
847
1358
  disconnectGoogleDriveConnection(workspaceId: string, connectionId: string, request: GoogleDriveDisconnectRequest): Promise<ConnectionMetadata>;
@@ -860,6 +1371,9 @@ export declare class OpenGeniClient {
860
1371
  disconnectSocialConnection(workspaceId: string, connectionId: string): Promise<SocialConnection>;
861
1372
  /** Public, immutably-cached URL for a catalog item's logo, or null when the item has none. */
862
1373
  catalogAssetUrl(logoAssetPath: string | null): string | null;
1374
+ /** Read a passive catalog mark through this client's authenticated transport.
1375
+ * Useful when an embedding backend protects even public upstream assets. */
1376
+ downloadCatalogAsset(logoAssetPath: string, options?: OpenGeniRequestOptions): Promise<Blob>;
863
1377
  /** GitHub App server configuration plus truthful workspace binding status. */
864
1378
  getGitHubApp(workspaceId: string, options?: {
865
1379
  returnPath?: string;
@@ -867,6 +1381,10 @@ export declare class OpenGeniClient {
867
1381
  /** Build the GitHub owner-consent entry URL for fresh workspace-bound state. */
868
1382
  githubConnectUrl(workspaceId: string, state: string): string;
869
1383
  listGitHubRepositories(workspaceId: string): Promise<GitHubRepositoriesResponse>;
1384
+ /** Effective confirmation policy for each GitHub identity available to this caller. */
1385
+ getGitHubActionPolicies(workspaceId: string): Promise<GitHubActionPoliciesResponse>;
1386
+ /** Change one GitHub action group without broadening review or merge policy. */
1387
+ updateGitHubActionPolicy(workspaceId: string, request: UpdateGitHubActionPolicyRequest): Promise<GitHubActionPolicyActorState>;
870
1388
  /** Re-sync the installation's repository list from GitHub. */
871
1389
  syncGitHubRepositories(workspaceId: string): Promise<GitHubRepositoriesResponse>;
872
1390
  /** Remove one workspace binding without uninstalling the GitHub App itself. */
@@ -878,9 +1396,69 @@ export declare class OpenGeniClient {
878
1396
  createApiKey(workspaceId: string, request: CreateApiKeyRequest): Promise<CreateApiKeyResponse>;
879
1397
  /** Revoke an API key. Returns the revoked key. */
880
1398
  deleteApiKey(workspaceId: string, apiKeyId: string): Promise<ApiKey>;
1399
+ listOrganizationApiKeys(organizationId: string): Promise<ApiKey[]>;
1400
+ /** The returned `token` is shown once; only its prefix is stored. */
1401
+ createOrganizationApiKey(organizationId: string, request: CreateOrganizationApiKeyRequest): Promise<CreateApiKeyResponse>;
1402
+ /** Revoke an organization-scoped API key. Returns the revoked key. */
1403
+ deleteOrganizationApiKey(organizationId: string, apiKeyId: string): Promise<ApiKey>;
1404
+ /**
1405
+ * Agents people connected to the organization MCP server (`/v1/mcp`).
1406
+ * Everyone sees their own; owners and admins see everyone's. Browser only:
1407
+ * keys and agents are refused, so an agent can't widen its own access.
1408
+ */
1409
+ listOrganizationMcpConnections(organizationId: string): Promise<OrganizationMcpConnectionList>;
1410
+ /** Change what a connected agent can do and where; its next request uses it. Only its person. */
1411
+ updateOrganizationMcpConnection(organizationId: string, connectionId: string, request: UpdateOrganizationMcpConnectionRequest): Promise<OrganizationMcpConnection>;
1412
+ /** Disconnect an agent: every token it holds is refused from now on. */
1413
+ deleteOrganizationMcpConnection(organizationId: string, connectionId: string): Promise<void>;
1414
+ /** Service accounts: organization identities with no person behind them. */
1415
+ listOrganizationServiceAccounts(organizationId: string): Promise<ListOrganizationServiceAccountsResponse>;
1416
+ getOrganizationServiceAccount(organizationId: string, serviceAccountId: string): Promise<OrganizationServiceAccount>;
1417
+ /** Create a service account; give it keys with `createOrganizationApiKey({ serviceAccountId })`. */
1418
+ createOrganizationServiceAccount(organizationId: string, request: CreateOrganizationServiceAccountRequest): Promise<OrganizationServiceAccount>;
1419
+ /** Rename it or change its role; making it a member narrows its keys at once. */
1420
+ updateOrganizationServiceAccount(organizationId: string, serviceAccountId: string, request: UpdateOrganizationServiceAccountRequest): Promise<OrganizationServiceAccount>;
1421
+ /** Delete a service account; every key it holds is revoked at once. */
1422
+ deleteOrganizationServiceAccount(organizationId: string, serviceAccountId: string): Promise<void>;
1423
+ /** The pending sign-in an agent started; read by the web app's sign-in page. */
1424
+ getMcpConnectionRequest(requestToken: string): Promise<McpConnectionRequest>;
1425
+ /** Allow or deny an agent's sign-in. Returns where to send the browser next. */
1426
+ answerMcpConnectionRequest(requestToken: string, decision: McpConnectionDecision): Promise<{
1427
+ redirectTo: string;
1428
+ }>;
1429
+ /**
1430
+ * One page of sessions across every shared workspace of the organization the
1431
+ * caller may read within its live workspace scope (an organization API key or
1432
+ * organization owner). Each row carries its `workspaceId`; read events,
1433
+ * history, and files through the ordinary workspace methods. Personal
1434
+ * workspaces are never included and private sessions stay invisible.
1435
+ */
1436
+ listOrganizationSessions(organizationId: string, options?: ListOrganizationSessionsOptions): Promise<OrganizationSessionListResponse>;
1437
+ /**
1438
+ * Every session `listOrganizationSessions` would return, following
1439
+ * `nextCursor` page by page until the organization is exhausted. A page may
1440
+ * be shorter than `limit` while more pages remain, so callers must not treat
1441
+ * a short page as the end.
1442
+ */
1443
+ iterateOrganizationSessions(organizationId: string, options?: Omit<ListOrganizationSessionsOptions, "cursor">): AsyncGenerator<Session, void, undefined>;
881
1444
  getBilling(options?: {
882
1445
  accountId?: string;
883
1446
  }): Promise<BillingSummary>;
1447
+ getOrganizationUsageSummary(options: {
1448
+ accountId: string;
1449
+ period?: import("@opengeni/contracts").OrganizationUsagePeriod;
1450
+ }, requestOptions?: OpenGeniRequestOptions): Promise<import("@opengeni/contracts").OrganizationUsageSummary>;
1451
+ getOrganizationModelUsage(options: {
1452
+ accountId: string;
1453
+ period?: import("@opengeni/contracts").OrganizationUsagePeriod;
1454
+ afterWorkspaceId?: string;
1455
+ }, requestOptions?: OpenGeniRequestOptions): Promise<import("@opengeni/contracts/organization-model-usage").OrganizationModelUsage>;
1456
+ getOrganizationUsageWorkspacePage(options: {
1457
+ accountId: string;
1458
+ period?: import("@opengeni/contracts").OrganizationUsagePeriod;
1459
+ until: string;
1460
+ afterWorkspaceId?: string;
1461
+ }, requestOptions?: OpenGeniRequestOptions): Promise<import("@opengeni/contracts").OrganizationUsageWorkspacePage>;
884
1462
  getBillingUsage(options?: {
885
1463
  accountId?: string;
886
1464
  workspaceId?: string;
@@ -889,12 +1467,39 @@ export declare class OpenGeniClient {
889
1467
  range?: InsightsRange;
890
1468
  provider?: string;
891
1469
  model?: string;
1470
+ rootSessionId?: string;
1471
+ sessionId?: string;
1472
+ signal?: AbortSignal;
892
1473
  }): Promise<WorkspaceInsightsResponse>;
893
1474
  getBillingEntitlements(options?: {
894
1475
  accountId?: string;
895
1476
  }): Promise<BillingEntitlementsResponse>;
896
1477
  /** Start a Stripe checkout for prepaid credits. */
897
1478
  createBillingCheckout(request: CreateCheckoutRequest): Promise<CreateCheckoutResponse>;
1479
+ /**
1480
+ * Where one checkout stands, and whether its credits reached the balance.
1481
+ * Poll it after the customer returns from Stripe Checkout.
1482
+ */
1483
+ getBillingCheckout(checkoutSessionId: string, options?: {
1484
+ accountId?: string;
1485
+ }): Promise<BillingCheckoutStatus>;
1486
+ /** Open Stripe's hosted portal for invoices and payment information. */
1487
+ createBillingPortalSession(request?: CreateBillingPortalRequest): Promise<CreateBillingPortalResponse>;
1488
+ /** The URL of an API path on this client's base (relative when the base is relative). */
1489
+ apiUrl(path: string): string;
1490
+ /**
1491
+ * A client of the same class that adds `headers` to every request, keeping
1492
+ * this client's base URL, fetch, credentials, and actor attribution. Used to
1493
+ * scope a surface (for example an artifact viewer) to one host context.
1494
+ */
1495
+ withHeaders(headers: Readonly<Record<string, string>>): this;
1496
+ /**
1497
+ * Fetch an absolute URL under this client's base URL through its fetch and
1498
+ * headers. For transports the SDK builds itself (the editable-artifact live
1499
+ * transport), so host authentication stays in one place. A URL outside the
1500
+ * base is refused: credentials never leave the configured API.
1501
+ */
1502
+ fetchApi(input: string | URL, init?: RequestInit): Promise<Response>;
898
1503
  private headers;
899
1504
  private url;
900
1505
  /** Connection state + the codex models the workspace may select (empty until connected). */
@@ -919,6 +1524,8 @@ export declare class OpenGeniClient {
919
1524
  }>;
920
1525
  /** List every connected Codex account + the workspace active pointer + settings. */
921
1526
  listCodexAccounts(workspaceId: string): Promise<CodexAccountsResponse>;
1527
+ /** Session-authorized retry choices plus the current accepted account. */
1528
+ listSessionCodexAccounts(workspaceId: string, sessionId: string): Promise<SessionCodexAccountsResponse>;
922
1529
  /** Switch the workspace ACTIVE Codex account (the one unpinned sessions use). */
923
1530
  activateCodexAccount(workspaceId: string, accountId: string): Promise<{
924
1531
  activated: boolean;
@@ -946,12 +1553,47 @@ export declare class OpenGeniClient {
946
1553
  }>;
947
1554
  /** Rename a Codex account (label only in P1). */
948
1555
  renameCodexAccount(workspaceId: string, accountId: string, label: string | null): Promise<CodexAccount>;
949
- /** Pin (or unpin via "auto") a session's Codex account. Applies on the next turn. */
1556
+ /** Pin/unpin a Codex account. Overrides a capacity-blocked turn; otherwise applies next turn. */
950
1557
  pinSessionCodexAccount(workspaceId: string, sessionId: string, target: string): Promise<{
951
1558
  pinned: string;
1559
+ appliedTo?: "waiting_turn" | "next_turn";
1560
+ }>;
1561
+ /** Organization subscription management requires an administrator browser session. */
1562
+ getModelConnectionAccess(target: {
1563
+ scope: "organizations" | "workspaces";
1564
+ scopeId: string;
1565
+ kind: "codex" | "supergrok" | "vercel_gateway" | "openrouter" | "anthropic" | "claude_subscription";
1566
+ connectionId: string;
1567
+ }): Promise<ModelConnectionAccessResponse>;
1568
+ updateModelConnectionAccess(target: {
1569
+ scope: "organizations" | "workspaces";
1570
+ scopeId: string;
1571
+ kind: "codex" | "supergrok" | "vercel_gateway" | "openrouter" | "anthropic" | "claude_subscription";
1572
+ connectionId: string;
1573
+ }, policy: ModelConnectionAccessPolicy): Promise<ModelConnectionAccessPolicy>;
1574
+ listOrganizationSuperGrokAccounts(organizationId: string): Promise<SuperGrokAccountsResponse>;
1575
+ organizationSupergrokConnectStart(organizationId: string): Promise<SuperGrokConnectStart>;
1576
+ organizationSupergrokConnectPoll(organizationId: string, state: string): Promise<SuperGrokConnectPoll>;
1577
+ activateOrganizationSuperGrokAccount(organizationId: string, accountId: string): Promise<{
1578
+ updated: boolean;
1579
+ }>;
1580
+ setOrganizationSuperGrokRotationSettings(organizationId: string, patch: {
1581
+ rotationEnabled: boolean;
1582
+ }): Promise<SuperGrokRotationSettings>;
1583
+ setOrganizationSuperGrokAccountAllocator(organizationId: string, accountId: string, input: {
1584
+ enabled: boolean;
1585
+ expectedVersion: number;
1586
+ }): Promise<{
1587
+ updated: boolean;
1588
+ }>;
1589
+ renameOrganizationSuperGrokAccount(organizationId: string, accountId: string, label: string | null): Promise<{
1590
+ updated: boolean;
1591
+ }>;
1592
+ disconnectOrganizationSuperGrokAccount(organizationId: string, accountId: string): Promise<{
1593
+ disconnected: boolean;
952
1594
  }>;
953
1595
  supergrokStatus(workspaceId: string): Promise<SuperGrokConnectionStatus>;
954
- supergrokConnectStart(workspaceId: string, scope?: SuperGrokAccountScope): Promise<SuperGrokConnectStart>;
1596
+ supergrokConnectStart(workspaceId: string, scope?: Exclude<SuperGrokAccountScope, "organization">): Promise<SuperGrokConnectStart>;
955
1597
  supergrokConnectPoll(workspaceId: string, state: string): Promise<SuperGrokConnectPoll>;
956
1598
  listSuperGrokAccounts(workspaceId: string): Promise<SuperGrokAccountsResponse>;
957
1599
  activateSuperGrokAccount(workspaceId: string, accountId: string): Promise<{
@@ -971,9 +1613,13 @@ export declare class OpenGeniClient {
971
1613
  newActiveId: string | null;
972
1614
  }>;
973
1615
  /** Contract-checked JSON transport shared by opt-in typed SDK clients. */
1616
+ private requestSessionCommand;
1617
+ /** Contract-checked JSON transport shared by opt-in typed SDK clients. */
974
1618
  requestJson<T>(method: string, path: string, body?: unknown, query?: Record<string, string>, options?: OpenGeniRequestOptions): Promise<T>;
975
1619
  /** Authenticated, contract-checked response for bounded streaming downloads. */
976
- protected requestResponse(method: string, path: string, query?: Record<string, string>, options?: OpenGeniRequestOptions): Promise<Response>;
977
- /** Like `requestJson` for endpoints that respond with no body (204). */
978
- private requestVoid;
1620
+ protected requestResponse(method: string, path: string, query?: Record<string, string>, options?: OpenGeniRequestOptions & {
1621
+ accept?: string;
1622
+ }): Promise<FetchResponse>;
1623
+ /** Contract-checked transport shared by opt-in typed SDK clients for 204 responses. */
1624
+ requestVoid(method: string, path: string, body?: unknown): Promise<void>;
979
1625
  }