@opengeni/sdk 3.1.0 → 3.1.2

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 (295) hide show
  1. package/README.md +1037 -71
  2. package/dist/accounts.d.ts +5 -1
  3. package/dist/accounts.js +13 -1
  4. package/dist/accounts.js.map +1 -1
  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/app-links.d.ts +42 -0
  18. package/dist/app-links.js +66 -0
  19. package/dist/app-links.js.map +1 -0
  20. package/dist/artifact-catalog.d.ts +40 -0
  21. package/dist/artifact-client.d.ts +20 -8
  22. package/dist/artifacts.d.ts +1 -1
  23. package/dist/artifacts.js +8 -6
  24. package/dist/automations.js +8 -2
  25. package/dist/automations.js.map +1 -1
  26. package/dist/azure-live-transport.d.ts +32 -0
  27. package/dist/browser.d.ts +7 -2
  28. package/dist/browser.js +27 -5
  29. package/dist/chat/fold.d.ts +75 -0
  30. package/dist/chat/handler.d.ts +41 -0
  31. package/dist/chat/http.d.ts +67 -0
  32. package/dist/chat/ids.d.ts +34 -0
  33. package/dist/chat/index.d.ts +9 -0
  34. package/dist/chat/index.js +1703 -0
  35. package/dist/chat/index.js.map +1 -0
  36. package/dist/chat/openai.d.ts +30 -0
  37. package/dist/chat/opengeni.d.ts +129 -0
  38. package/dist/chat/types.d.ts +207 -0
  39. package/dist/chat/vercel.d.ts +49 -0
  40. package/dist/chats.d.ts +8 -0
  41. package/dist/chunk-4AHR4KGA.js +301 -0
  42. package/dist/chunk-4AHR4KGA.js.map +1 -0
  43. package/dist/chunk-6HZGAIUE.js +1665 -0
  44. package/dist/chunk-6HZGAIUE.js.map +1 -0
  45. package/dist/chunk-7EWT3PV6.js +368 -0
  46. package/dist/chunk-7EWT3PV6.js.map +1 -0
  47. package/dist/{chunk-VYCTL62C.js → chunk-GZQSWAKD.js} +1 -1
  48. package/dist/chunk-GZQSWAKD.js.map +1 -0
  49. package/dist/chunk-JXXCTW5W.js +1392 -0
  50. package/dist/chunk-JXXCTW5W.js.map +1 -0
  51. package/dist/{chunk-YTAWBDO2.js → chunk-KADZ5PGG.js} +28 -2
  52. package/dist/chunk-KADZ5PGG.js.map +1 -0
  53. package/dist/{chunk-YKZME56C.js → chunk-KWADQ227.js} +3 -3
  54. package/dist/{chunk-YKZME56C.js.map → chunk-KWADQ227.js.map} +1 -1
  55. package/dist/{chunk-7ZXBPJZP.js → chunk-NEM5N6C6.js} +3902 -1457
  56. package/dist/chunk-NEM5N6C6.js.map +1 -0
  57. package/dist/{chunk-GW3EJ2GP.js → chunk-O7KANXC3.js} +86 -13
  58. package/dist/chunk-O7KANXC3.js.map +1 -0
  59. package/dist/{chunk-VUQZAB3O.js → chunk-OAKHWFSV.js} +28 -32
  60. package/dist/chunk-OAKHWFSV.js.map +1 -0
  61. package/dist/chunk-P7UWKORG.js +561 -0
  62. package/dist/chunk-P7UWKORG.js.map +1 -0
  63. package/dist/chunk-QGEIL4TR.js +195 -0
  64. package/dist/chunk-QGEIL4TR.js.map +1 -0
  65. package/dist/chunk-RJHCBZF7.js +270 -0
  66. package/dist/chunk-RJHCBZF7.js.map +1 -0
  67. package/dist/chunk-S3D75WSQ.js +340 -0
  68. package/dist/chunk-S3D75WSQ.js.map +1 -0
  69. package/dist/chunk-UM4ZXXJR.js +9 -0
  70. package/dist/chunk-UM4ZXXJR.js.map +1 -0
  71. package/dist/chunk-VPVMLM7Q.js +15 -0
  72. package/dist/chunk-VPVMLM7Q.js.map +1 -0
  73. package/dist/{chunk-C2H7HBNP.js → chunk-WVCJRSGJ.js} +119 -14
  74. package/dist/chunk-WVCJRSGJ.js.map +1 -0
  75. package/dist/chunk-XA7HVIHI.js +126 -0
  76. package/dist/chunk-XA7HVIHI.js.map +1 -0
  77. package/dist/{chunk-TX3EIENU.js → chunk-YDVPI7WT.js} +73 -2
  78. package/dist/chunk-YDVPI7WT.js.map +1 -0
  79. package/dist/chunk-YKIHNLWD.js +153 -0
  80. package/dist/chunk-YKIHNLWD.js.map +1 -0
  81. package/dist/chunk-ZDUBPV33.js +277 -0
  82. package/dist/chunk-ZDUBPV33.js.map +1 -0
  83. package/dist/client.d.ts +1065 -124
  84. package/dist/codex-realtime-controller.d.ts +13 -0
  85. package/dist/codex-realtime-controller.js +4 -2
  86. package/dist/codex-realtime-v3-wire.d.ts +3 -2
  87. package/dist/codex-realtime.d.ts +5 -1
  88. package/dist/company-brain.d.ts +1 -11
  89. package/dist/company-profile.d.ts +13 -0
  90. package/dist/core.d.ts +7 -2
  91. package/dist/core.js +25 -6
  92. package/dist/deprecation.d.ts +47 -0
  93. package/dist/document-authority-client.d.ts +24 -2
  94. package/dist/document-authority.js +7 -5
  95. package/dist/editable-artifacts/index.d.ts +1 -1
  96. package/dist/editable-artifacts/types.d.ts +12 -2
  97. package/dist/editable-artifacts.js +19 -3
  98. package/dist/editable-artifacts.js.map +1 -1
  99. package/dist/embedding-client.d.ts +129 -0
  100. package/dist/errors.d.ts +76 -1
  101. package/dist/feedback.d.ts +23 -0
  102. package/dist/gateway-realtime-transport.js +1 -1
  103. package/dist/github-repositories.d.ts +10 -0
  104. package/dist/github-repositories.js +36 -0
  105. package/dist/github-repositories.js.map +1 -0
  106. package/dist/index.d.ts +64 -11
  107. package/dist/index.js +566 -141
  108. package/dist/index.js.map +1 -1
  109. package/dist/insights-usage.d.ts +33 -0
  110. package/dist/insights-usage.js +7 -0
  111. package/dist/insights-usage.js.map +1 -0
  112. package/dist/interaction.d.ts +103 -71
  113. package/dist/interaction.js +4 -2
  114. package/dist/knowledge.d.ts +7 -0
  115. package/dist/knowledge.js +20 -0
  116. package/dist/knowledge.js.map +1 -0
  117. package/dist/known-tools.d.ts +4 -0
  118. package/dist/message-links.d.ts +68 -0
  119. package/dist/model-context.d.ts +68 -0
  120. package/dist/model-display.d.ts +2 -0
  121. package/dist/model-display.js +17 -0
  122. package/dist/model-display.js.map +1 -0
  123. package/dist/model-picker-order.d.ts +1 -0
  124. package/dist/model-picker-order.js +10 -0
  125. package/dist/model-picker-order.js.map +1 -0
  126. package/dist/organization-integration-policy.d.ts +26 -0
  127. package/dist/organization-integration-policy.js +26 -0
  128. package/dist/organization-integration-policy.js.map +1 -0
  129. package/dist/pr-review-client.d.ts +1 -1
  130. package/dist/pr-review.d.ts +1 -1
  131. package/dist/pr-review.js.map +1 -1
  132. package/dist/preference-registry.d.ts +1 -1
  133. package/dist/prepared-mcp-setup.d.ts +5 -0
  134. package/dist/proxy.d.ts +13 -11
  135. package/dist/realtime.d.ts +4 -2
  136. package/dist/realtime.js +253 -7
  137. package/dist/realtime.js.map +1 -1
  138. package/dist/session-history-import.d.ts +22 -0
  139. package/dist/session-history-import.js +36 -0
  140. package/dist/session-history-import.js.map +1 -0
  141. package/dist/session-list-entries.d.ts +1 -0
  142. package/dist/session-list-entries.js +7 -0
  143. package/dist/session-list-entries.js.map +1 -0
  144. package/dist/session-message-search.d.ts +53 -0
  145. package/dist/session-proxy-client.d.ts +28 -0
  146. package/dist/session-proxy.d.ts +334 -0
  147. package/dist/session-proxy.js +24 -0
  148. package/dist/session-proxy.js.map +1 -0
  149. package/dist/session-titles.d.ts +2 -0
  150. package/dist/session-usage-limits.d.ts +10 -0
  151. package/dist/session-usage-limits.js +43 -0
  152. package/dist/session-usage-limits.js.map +1 -0
  153. package/dist/shared-catalog-loader.d.ts +34 -0
  154. package/dist/site-bridge-host.d.ts +112 -0
  155. package/dist/site-bridge-host.js +285 -0
  156. package/dist/site-bridge-host.js.map +1 -0
  157. package/dist/site-browser-entry.d.ts +1 -0
  158. package/dist/site-browser-runtime.gen.d.ts +1 -0
  159. package/dist/site-data.d.ts +178 -0
  160. package/dist/site-document.d.ts +5 -0
  161. package/dist/site-document.js +20 -0
  162. package/dist/site-document.js.map +1 -0
  163. package/dist/site-document.test.d.ts +1 -0
  164. package/dist/site-http.d.ts +17 -0
  165. package/dist/site-sql.d.ts +31 -0
  166. package/dist/site-tool-bridge.d.ts +57 -0
  167. package/dist/site.d.ts +182 -0
  168. package/dist/site.js +62 -0
  169. package/dist/site.js.map +1 -0
  170. package/dist/skills.d.ts +75 -0
  171. package/dist/sse.d.ts +1 -1
  172. package/dist/stream.d.ts +2 -0
  173. package/dist/tenant-workspaces.d.ts +47 -0
  174. package/dist/tenant-workspaces.js +8 -0
  175. package/dist/tenant-workspaces.js.map +1 -0
  176. package/dist/tool-auth.d.ts +87 -0
  177. package/dist/tool-auth.js +23 -0
  178. package/dist/tool-auth.js.map +1 -0
  179. package/dist/tool-display-metadata.d.ts +3 -0
  180. package/dist/tools-37DCTCNZ.js +12 -0
  181. package/dist/tools-37DCTCNZ.js.map +1 -0
  182. package/dist/tools.d.ts +81 -0
  183. package/dist/transcription.d.ts +1 -1
  184. package/dist/types.d.ts +2848 -573
  185. package/dist/usage-allowances.d.ts +36 -0
  186. package/dist/usage-allowances.js +80 -0
  187. package/dist/usage-allowances.js.map +1 -0
  188. package/dist/vault-types.d.ts +236 -0
  189. package/dist/vaults-api.d.ts +57 -0
  190. package/dist/workspace-artifacts.d.ts +47 -5
  191. package/dist/workspace-instruction-policies.d.ts +2 -2
  192. package/dist/workspace-integrations.d.ts +74 -0
  193. package/dist/workspace-integrations.js +65 -0
  194. package/dist/workspace-integrations.js.map +1 -0
  195. package/dist/workspace-state.d.ts +8 -71
  196. package/package.json +99 -5
  197. package/src/accounts.ts +18 -0
  198. package/src/adapters/express.ts +136 -0
  199. package/src/adapters/hono.ts +18 -0
  200. package/src/adapters/next.ts +42 -0
  201. package/src/allowance-refusal.ts +5 -0
  202. package/src/app-links.ts +117 -0
  203. package/src/artifact-catalog.ts +51 -0
  204. package/src/artifact-client.ts +40 -49
  205. package/src/artifacts.ts +1 -0
  206. package/src/automations-client.ts +8 -2
  207. package/src/azure-live-transport.ts +286 -0
  208. package/src/browser.ts +37 -0
  209. package/src/chat/fold.ts +431 -0
  210. package/src/chat/handler.ts +240 -0
  211. package/src/chat/http.ts +257 -0
  212. package/src/chat/ids.ts +85 -0
  213. package/src/chat/index.ts +88 -0
  214. package/src/chat/openai.ts +439 -0
  215. package/src/chat/opengeni.ts +737 -0
  216. package/src/chat/types.ts +219 -0
  217. package/src/chat/vercel.ts +204 -0
  218. package/src/chats.ts +16 -0
  219. package/src/client.ts +5822 -1847
  220. package/src/codex-realtime-controller.ts +163 -8
  221. package/src/codex-realtime-v3-wire.ts +4 -3
  222. package/src/codex-realtime-v3.ts +12 -3
  223. package/src/codex-realtime.ts +11 -3
  224. package/src/company-brain.ts +0 -40
  225. package/src/company-profile.ts +13 -0
  226. package/src/core.ts +20 -0
  227. package/src/deprecation.ts +149 -0
  228. package/src/document-authority-client.ts +104 -1
  229. package/src/editable-artifacts/controller.ts +36 -2
  230. package/src/editable-artifacts/index.ts +1 -0
  231. package/src/editable-artifacts/types.ts +29 -16
  232. package/src/embedding-client.ts +519 -0
  233. package/src/errors.ts +303 -4
  234. package/src/feedback.ts +20 -0
  235. package/src/gateway-realtime-transport.ts +3 -3
  236. package/src/github-repositories.ts +60 -0
  237. package/src/index.ts +611 -64
  238. package/src/insights-usage.ts +61 -0
  239. package/src/interaction.ts +274 -93
  240. package/src/knowledge.ts +72 -0
  241. package/src/known-tools.ts +279 -0
  242. package/src/message-links.ts +178 -0
  243. package/src/model-context.ts +113 -0
  244. package/src/model-display.ts +11 -0
  245. package/src/model-picker-order.ts +6 -0
  246. package/src/organization-integration-policy.ts +54 -0
  247. package/src/pr-review-client.ts +1 -1
  248. package/src/pr-review.ts +1 -1
  249. package/src/preference-registry.ts +2 -0
  250. package/src/prepared-mcp-setup.ts +123 -0
  251. package/src/proxy.ts +23 -12
  252. package/src/realtime.ts +16 -6
  253. package/src/session-history-import.ts +84 -0
  254. package/src/session-list-entries.ts +1 -0
  255. package/src/session-message-search.ts +47 -0
  256. package/src/session-proxy-client.ts +68 -0
  257. package/src/session-proxy.ts +2098 -0
  258. package/src/session-titles.ts +10 -0
  259. package/src/session-usage-limits.ts +71 -0
  260. package/src/shared-catalog-loader.ts +169 -0
  261. package/src/site-bridge-host.ts +422 -0
  262. package/src/site-browser-entry.ts +6 -0
  263. package/src/site-browser-runtime.gen.ts +2 -0
  264. package/src/site-data.ts +372 -0
  265. package/src/site-document.test.ts +64 -0
  266. package/src/site-document.ts +18 -0
  267. package/src/site-http.ts +171 -0
  268. package/src/site-sql.ts +153 -0
  269. package/src/site-tool-bridge.ts +401 -0
  270. package/src/site.ts +867 -0
  271. package/src/skills.ts +69 -0
  272. package/src/sse.ts +9 -3
  273. package/src/stream.ts +33 -10
  274. package/src/tenant-workspaces.ts +148 -0
  275. package/src/tool-auth.ts +301 -0
  276. package/src/tool-display-metadata.ts +27 -0
  277. package/src/tools.ts +452 -0
  278. package/src/transcription.ts +3 -0
  279. package/src/types.ts +3216 -581
  280. package/src/usage-allowances.ts +189 -0
  281. package/src/vault-types.ts +293 -0
  282. package/src/vaults-api.ts +288 -0
  283. package/src/workspace-artifacts.ts +55 -6
  284. package/src/workspace-instruction-policies.ts +2 -1
  285. package/src/workspace-integrations.ts +402 -0
  286. package/src/workspace-state.ts +8 -82
  287. package/dist/chunk-7ZXBPJZP.js.map +0 -1
  288. package/dist/chunk-C2H7HBNP.js.map +0 -1
  289. package/dist/chunk-C4DJPZRU.js +0 -119
  290. package/dist/chunk-C4DJPZRU.js.map +0 -1
  291. package/dist/chunk-GW3EJ2GP.js.map +0 -1
  292. package/dist/chunk-TX3EIENU.js.map +0 -1
  293. package/dist/chunk-VUQZAB3O.js.map +0 -1
  294. package/dist/chunk-VYCTL62C.js.map +0 -1
  295. package/dist/chunk-YTAWBDO2.js.map +0 -1
package/dist/client.d.ts CHANGED
@@ -1,16 +1,85 @@
1
+ import type { ComputerNativeCallRequest, ComputerNativeReceipt } from "@opengeni/contracts";
2
+ import type { ClaudeSubscriptionAccountsResponse, ClaudeSubscriptionAccount, ClaudeSubscriptionOAuthStartRequest, ClaudeSubscriptionSetupTokenRequest, SubscriptionPoolSettings } from "@opengeni/contracts";
3
+ import { type WorkspaceInsightsUsageOptions, type OrganizationInsightsUsageOptions, type WorkspaceInsightsCallsOptions, type OrganizationInsightsCallsOptions, type InsightsCallsScope, type InsightsUsageResponse, type InsightsCallsResponse } from "./insights-usage.js";
4
+ import type { ArtifactCatalogKind, ArtifactCatalogListOptions, ArtifactCatalogListResponse, ArtifactPinResponse } from "./artifact-catalog.js";
5
+ import type { ToolActionReview, ToolReviewDetailsPage } from "@opengeni/contracts";
6
+ import type { SiteDataCollectionDefinitionRequest, SiteDataCollectionResponse, SiteDataDescribeResponse, SiteDataFileListResponse, SiteDataFileUrlResponse, SiteDataImportRequest, SiteDataImportResponse, SiteDataQueryRequest, SiteDataQueryResponse, SiteDataWriteRequest, SiteDataWriteResponse } from "@opengeni/contracts";
7
+ import type { SiteSqlDescribeResponse, SiteSqlExportFormat, SiteSqlImportRequest, SiteSqlImportResponse, SiteSqlInspectResponse, SiteSqlMigrateResponse, SiteSqlMigrationRequest, SiteSqlQueryDefinitionRequest, SiteSqlQueryResponse, SiteSqlResetResponse, SiteSqlRunRequest, SiteSqlRunResponse, SiteSqlSettingsRequest, SiteSqlStatementRequest } from "@opengeni/contracts";
8
+ import type { SiteAbuseReport, SiteAuthAuthorizeRequest, SiteAuthAuthorizeResponse, SiteHostnameAvailability, SiteLimitProfile, SitePlatformUsage, SitePublication, SitePublishWarningFix, SiteTakedownRequest, UpsertSitePublicationRequest } from "@opengeni/contracts";
9
+ import type { SessionMessageSearchRequest, SessionMessageSearchResponse, SessionMessagePreview, SessionMessagePreviewReference } from "./session-message-search.js";
10
+ import type { KnowledgeOriginalFileDownload, AgentLearningContext, AgentLearningSettingsRecord, AgentLearningOverrideRecord, SaveAgentLearningSettingsRequest, KnowledgeEntryListRequest, KnowledgeEntryListResponse, KnowledgeReviewBatchListRequest, KnowledgeReviewBatchListResponse, KnowledgeEntryRecord, KnowledgeEntrySaveRequest, KnowledgeEntryWriteReceipt, KnowledgeEntryReviewRequest, KnowledgeEntryBatchReviewRequest, KnowledgeEntryRestoreRequest, AgentInstructionReviewRequest, AgentInstructionReceipt, AgentInstructionReviewListResponse } from "./knowledge.js";
11
+ import type { RollbackWorkspaceArtifactRequest, SetWorkspaceArtifactStatusRequest, UpdateWorkspaceArtifactVisibilityRequest, UpdateWorkspaceArtifactVisibilityResponse, WorkspaceArtifactDetailResponse, WorkspaceArtifactListOptions, WorkspaceArtifactListResponse, WorkspaceArtifactMutationResponse } from "./workspace-artifacts.js";
12
+ import type { CreateFeedbackRequest, Feedback, FeedbackSubmissionResponse } from "./feedback.js";
13
+ import type { CreateWorkspaceWebhookRequest, CreateWorkspaceWebhookResponse, GetWorkspaceCredentialProviderResponse, ListWorkspaceWebhookDeliveriesResponse, ListWorkspaceWebhooksResponse, PutWorkspaceCredentialProviderRequest, PutWorkspaceCredentialProviderResponse, UpdateWorkspaceWebhookRequest, WorkspaceSandboxImages, WorkspaceWebhook, WorkspaceWebhookDelivery } from "./workspace-integrations.js";
14
+ import type { OpenGeniToolsFacade } from "./tools.js";
15
+ import { type VaultsApi } from "./vaults-api.js";
1
16
  import { type SessionEventStreamTransport, type StreamSessionEventsOptions } from "./stream.js";
17
+ import type { SessionModelContextResponse } from "./model-context.js";
18
+ import { type OpenGeniDeprecationHandler } from "./deprecation.js";
19
+ import type { SkillRecord, SkillSummary, SkillWriteReceipt, SaveWorkspaceSkillRequest, RemoveWorkspaceSkillRequest, ApplyWorkspaceSkillRevisionRequest } from "./skills.js";
2
20
  import { type WorkspaceControlStreamTransport } from "./workspace-control-stream.js";
3
21
  import { type WorkspaceInteractionRevisionStreamTransport } from "./interaction-revision-stream.js";
4
22
  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, WorkspaceModelAccessPolicy, WorkspaceModelCatalogResponse, WorkspaceRealtimeModelCatalogResponse, ClientSessionEventInput, UserMessageEventInput, CompactSessionContextResult, ConnectionMetadata, PersonalGitHubConnectionStatusResponse, PersonalGitHubDisconnectRequest, PersonalGitHubOAuthStartRequest, PersonalGitHubOAuthStartResponse, ListPersonalGitHubRepositoriesOptions, ListPersonalGitHubRepositoriesResponse, PersonalGitHubRepositorySelectionState, ReplacePersonalGitHubRepositorySelectionsRequest, VerifyPersonalGitHubRepositorySelectionsRequest, CreateApiKeyRequest, CreateApiKeyResponse, CreateCapabilityCatalogItemRequest, InstallSkillRequest, InstallLibrarySkillRequest, InstalledSkill, ListInstalledSkillsResponse, CreateBillingPortalRequest, CreateBillingPortalResponse, CreateCheckoutRequest, CreateCheckoutResponse, OpenGeniSlackBotInstallRequest, OpenGeniSlackBotInstallStart, SlackChannelRouteListResponse, SlackReactionChannelListResponse, UpdateSlackChannelRoutesRequest, FikenInstallRequest, FikenOAuthStartRequest, FikenOAuthStartResponse, CreateConnectionRequest, CreateDocumentBaseRequest, CreateFileUploadRequest, CreateFileUploadResponse, CreateGitHubAppManifestRequest, CreateGitHubAppManifestResponse, CreateKnowledgeMemoryRequest, CreateScheduledTaskRequest, CreateSessionRequest, CreateSessionResponse, CreateVariableSetRequest, ResolveVariableSetAttachmentsRequest, ResolveVariableSetAttachmentsResponse, CreateRigRequest, CreateWorkspaceRequest, DeviceEnrollmentApproveRequest, DeviceEnrollmentApproveResponse, DeviceEnrollmentDenyResponse, DeviceEnrollmentLookupResponse, MintEnrollTokenResponse, EndSessionRealtimeRequest, DiscoverMcpCapabilitiesResponse, Document, DocumentBase, DocumentSearchRequest, DocumentSearchResponse, EnableCapabilityRequest, EnablePackRequest, FileAsset, FileDownloadUrlResponse, GetPackResponse, GitHubAppInfo, GitHubRepositoriesResponse, GoogleDriveBrowseResponse, GoogleDriveDisconnectRequest, SaveGoogleDriveIntegrationSourceRequest, GoogleDriveLifecycleActionRequest, KnowledgeMemory, KnowledgeMemorySearchRequest, ListManagedOrganizationMembershipsResponse, ListUserResourceAuthoritiesOptions, ListUserResourceAuthoritiesResponse, IssueUserResourceGrantRequest, UserResourceGrantMutationResponse, RevokeUserResourceGrantResponse, ListOrganizationInvitationsPageResponse, ListOrganizationAdministrationMembersResponse, AcceptOrganizationInvitationRequest, AcceptOrganizationInvitationResponse, AcceptOrganizationRecoveryCustodyRequest, ConfigureOrganizationRecoveryPolicyRequest, CreateOrganizationInvitationRequest, CreateOrganizationRequest, CreateOrganizationResponse, CreateOrganizationWorkspaceRequest, OrganizationInvitation, OrganizationAdministrationOverview, OrganizationMember, OrganizationRecoveryMutationResponse, OrganizationRecoveryOperationCommandRequest, OrganizationRecoveryOverview, OrganizationWorkspaceAccess, OrganizationWorkspaceAccessMember, OrganizationRetentionPolicy, OrganizationSummary, RevokeOrganizationInvitationRequest, RevokeOrganizationWorkspaceMemberRequest, RevokeOrganizationWorkspaceMemberResponse, PutOrganizationWorkspaceMemberRequest, UpdateOrganizationMemberRequest, UpdateOrganizationNameRequest, DisableOrganizationRecoveryPolicyRequest, StartOrganizationRecoveryOperationRequest, UpdateOrganizationWorkspaceRequest, UpdateOrganizationRetentionPolicyRequest, ListPacksResponse, MachinesResponse, MetricSample, RemoveEnrollmentRequest, RemoveEnrollmentResponse, MachineOperationPolicy, UpdateMachineOperationPolicyRequest, UpdateMachineAgentResponse, SwapActiveSandboxRequest, SwapActiveSandboxResponse, InstallPackRequest, PackInstallationPreview, PrepareSlackUserLinkAccessRequest, SlackUserLinkAccessMutationRequest, SlackUserLinkAccessRequest, ApproveSlackUserLinkAccessRequest, PackInstallation, PackUninstallPreview, RetainedScreenshotDownload, RetainedScreenshotDownloadOptions, RetainedArtifactDownload, RetainedArtifactDownloadOptions, RetainedArtifactReference, RetainedArtifactContent, RetainedArtifactContentOptions, RetainedArtifactMetadata, UpdateVideoGenerationPolicyRequest, VideoArtifactPlaybackSource, VideoGenerationOperationSummary, VideoGenerationPolicy, WorkspaceVideoGenerationSettings, RegisterCapabilityPackRequest, PreviewPackInstallationRequest, PreviewSkillImportRequest, ScheduledTask, ScheduledTaskRun, ForkSessionRequest, ForkSessionResponse, Session, SessionStatus, WorkClaimSubjectType, SessionBackgroundCommandListResponse, CancelSessionBackgroundCommandResult, SessionListResponse, SessionTenancyCreateCapabilities, AgentTopologyPageResponse, UpdateSessionChannelRequest, UpdateSessionAttentionRequest, UpdateSessionArchiveRequest, UpdateSessionPinRequest, UpdateSessionVisibilityRequest, UpdateSessionVisibilityResponse, UninstallPackRequest, UninstallPackResult, 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, 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, UpdateKnowledgeMemoryRequest, UpdateScheduledTaskRequest, UpdateSessionGoalRequest, ApplySessionGoalRevisionRequest, UpdateSessionRequest, UpdateSessionVariableSetsRequest, UpdateSessionToolPolicyRequest, UpdateVariableSetRequest, UpdateRigRequest, UpdateWorkspaceMemberRequest, UpdateWorkspaceModelAccessPolicyRequest, UpdateWorkspaceRequest, UpdateWorkspaceSettingsRequest, SetWorkspaceDefaultRigRequest, UploadFileInput, VariableSet, VariableSetSecret, VariableSetVariableMetadata, Channel, CreateChannelRequest, ReorderChannelsRequest, UpdateChannelRequest, Rig, RigVersion, RigChange, ProposeRigChangeRequest, WorkspaceMember, WorkspaceMemorySearchRequest, WorkspaceMemorySearchResponse, WorkspaceRegisteredPack, Workspace, SlackInstallationBinding, OAuthStartRequest, OAuthStartResponse, SocialConnection, SocialOAuthStartRequest, SkillImportPreview, SkillUninstallPreview, UninstallSkillRequest, UninstallSkillResult } from "./types.js";
23
+ 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 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";
24
+ import type { AccessContext, ActivateCodexRealtimeConnectionRequest, AddWorkspaceMemberRequest, ApiKey, BillingEntitlementsResponse, CodexAccount, CodexAccountsResponse, SessionCodexAccountsResponse, CodexAppsUpdate, CodexRotationSettings, CodexOverviewResponse, CodexAllocatorUpdate, CodexConnectionStatus, CodexRealtimeWebrtcRequest, CodexRealtimeWebrtcResponse, GatewayRealtimeConnectRequest, GatewayRealtimeConnectResponse, CodexConnectPoll, CodexConnectStart, CodexUsage, CodexUsageMap, ModelConnectionAccessKind, ModelConnectionAccessPolicy, ModelConnectionAccessResponse, SuperGrokAccount, SuperGrokAccountsResponse, SuperGrokAccountScope, SuperGrokAllocatorUpdate, SuperGrokConnectionStatus, SuperGrokConnectPoll, SuperGrokConnectStart, SuperGrokRotationSettings, BillingSummary, BillingUsageResponse, InsightsRange, WorkspaceInsightsResponse, BeginSessionRealtimeRequest, CapabilityCatalogItem, CapabilityCatalogResponse, ConnectorToolPermissionsResponse, UpdateConnectorToolPermissionsRequest, SessionMcpToolPermissionsResponse, UpdateSessionMcpToolPermissionsRequest, 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, OrganizationModelDefaults, UpdateOrganizationModelDefaultsRequest, ModelAccountSettingsOverview, OrganizationModelAccountSettings, UpdateOrganizationModelAccountSettingsRequest, UpdateWorkspaceModelAccountSettingsRequest, WorkspaceModelAccountSettings, ModelAccountPreferences, SessionModelAccountChoiceResponse, SessionUsageLimit, SetSessionUsageLimitRequest, SetSessionModelAccountChoiceRequest, SetSessionModelAccountChoiceResponse, UpdateModelAccountPreferencesRequest, OrganizationAgentAdminAccess, UpdateOrganizationAgentAdminAccessRequest, OrganizationPrivacySettings, UpdateOrganizationPrivacySettingsRequest, SessionAdminAccess, GrantSessionAdminAccessRequest, WorkspaceModelCatalogResponse, WorkspaceGatewayCustomModel, WorkspaceGatewayCustomModelsResponse, CreateWorkspaceGatewayCustomModelRequest, DeleteWorkspaceGatewayCustomModelRequest, WorkspaceOpenRouterCustomModel, WorkspaceOpenRouterCustomModelsResponse, CreateWorkspaceOpenRouterCustomModelRequest, DeleteWorkspaceOpenRouterCustomModelRequest, WorkspaceOpperCustomModel, WorkspaceOpperCustomModelsResponse, CreateWorkspaceOpperCustomModelRequest, DeleteWorkspaceOpperCustomModelRequest, 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, CreatePersonalApiKeyRequest, CreatePersonalApiKeyResponse, ListPersonalApiKeysResponse, OrganizationMcpConnectionList, OrganizationServiceAccount, ListOrganizationServiceAccountsResponse, CreateOrganizationServiceAccountRequest, UpdateOrganizationServiceAccountRequest, UpdateOrganizationMcpConnectionRequest, McpConnectionRequest, McpConnectionDecision, NativeAppAuthorizeInput, NativeAppTokenInput, NativeAppToken, InboxItem, InboxSettings, MemberNotificationsSetting, SessionInboxMute, ListInboxResponse, UpdateInboxItemInput, NativePushDevice, RegisterNativePushDeviceInput, CreateCapabilityCatalogItemRequest, InstallSkillRequest, InstallLibrarySkillRequest, InstalledSkill, ListInstalledSkillsResponse, CreateBillingPortalRequest, CreateBillingPortalResponse, CreateCheckoutRequest, BillingCheckoutStatus, CreateCheckoutResponse, OpenGeniSlackBotInstallRequest, AvailableOpenGeniSlackBots, OpenGeniSlackBotOrganizationAccess, UpdateOpenGeniSlackBotOrganizationAccess, OpenGeniSlackBotInstallStart, SlackChannelRouteListResponse, SlackReactionChannelListResponse, UpdateSlackChannelRoutesRequest, FikenInstallRequest, FikenOAuthStartRequest, FikenOAuthStartResponse, CreateConnectionRequest, CreateDocumentBaseRequest, CreateFileUploadRequest, CreateFileUploadResponse, CreateGitHubAppManifestRequest, CreateGitHubAppManifestResponse, CreateScheduledTaskRequest, CreateSessionRequest, CreateSessionResponse, CreateRigRequest, CreateWorkspaceRequest, EnsureWorkspaceRequest, EnsureWorkspaceResponse, DeviceEnrollmentApproveRequest, DeviceEnrollmentApproveResponse, DeviceEnrollmentDenyResponse, DeviceEnrollmentLookupResponse, MintEnrollTokenRequest, 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, EnableMachineScreenControlResponse, ChangeMachineAudienceRequest, ChangeMachineAudienceResponse, MachineAudiencePreview, MachineAudiencePreviewRequest, OpenMachinePrivacySettingsRequest, OpenMachinePrivacySettingsResponse, SwapActiveSandboxRequest, SwapActiveSandboxResponse, PrepareSlackUserLinkAccessRequest, SlackUserLinkAccessMutationRequest, SlackUserLinkAccessRequest, ApproveSlackUserLinkAccessRequest, RetainedScreenshotDownload, RetainedScreenshotDownloadOptions, RetainedArtifactDownload, RetainedArtifactDownloadOptions, RetainedArtifactReference, RetainedArtifactContent, RetainedArtifactContentOptions, RetainedArtifactMetadata, UpdateVideoGenerationPolicyRequest, VideoArtifactPlaybackSource, VideoGenerationOperationSummary, VideoGenerationPolicy, WorkspaceVideoGenerationSettings, PreviewSkillImportRequest, PrivateScheduledTaskSummary, ScheduledTask, ScheduledTaskAccessAttention, ScheduledTaskRun, ForkSessionRequest, ForkSessionResponse, Session, SessionStatus, WorkClaimSubjectType, SessionBackgroundCommandListResponse, CancelSessionBackgroundCommandResult, SessionListResponse, SessionListEntryResponse, SessionTenancyCreateCapabilities, AgentTopologyPageResponse, UpdateSessionChannelRequest, UpdateSessionAttentionRequest, UpdateSessionArchiveRequest, UpdateSessionRetentionRequest, UpdateSessionPinRequest, UpdateSessionVisibilityRequest, UpdateSessionVisibilityResponse, SessionVisibility, SessionVisibilityChangePreview, 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, UpdateSessionToolPolicyRequest, UpdateSessionAgentRequest, UpdateSessionSkillsRequest, UpdateRigRequest, UpdateWorkspaceMemberRequest, UpdateWorkspaceModelAccessPolicyRequest, UpdateWorkspaceRequest, UpdateWorkspaceSettingsRequest, SetWorkspaceDefaultRigRequest, UploadFileInput, Channel, CreateChannelRequest, ReorderChannelsRequest, UpdateChannelRequest, Rig, RigVersion, RigChange, ProposeRigChangeRequest, WorkspaceMember, WorkspaceMemberCandidate, Workspace, SlackInstallationBinding, OAuthStartRequest, OAuthStartResponse, SocialConnection, SocialOAuthStartRequest, SkillImportPreview, SkillUninstallPreview, UninstallSkillRequest, UninstallSkillResult } from "./types.js";
7
25
  import type { ActivateWorkspaceInstructionPolicyRequest, CreateWorkspaceInstructionPolicyDraftRequest, CreateWorkspaceInstructionPolicyOnboardingProposalRequest, ImportLegacyWorkspaceInstructionPolicyDraftRequest, RollbackWorkspaceInstructionPolicyRequest, WorkspaceInstructionPolicyActivationResponse, WorkspaceInstructionPolicyDiffRequest, WorkspaceInstructionPolicyDiffResponse, WorkspaceInstructionPolicyListOptions, WorkspaceInstructionPolicyListResponse, WorkspaceInstructionPolicyOnboardingProposal, WorkspaceInstructionPolicyOnboardingProposalListOptions, WorkspaceInstructionPolicyOnboardingProposalListResponse, WorkspaceInstructionPolicyRevision } from "./workspace-instruction-policies.js";
8
- import type { ActivateWorkspaceLearningPolicyRevisionRequest, CreateWorkspaceLearningPolicyRevisionRequest, GovernedLearningActivationUndoReceipt, RollbackWorkspaceLearningPolicyRevisionRequest, WorkspaceLearningHistoryOptions, WorkspaceLearningHistoryResponse, WorkspaceLearningPolicyMutationResponse, WorkspaceLearningPolicyRevision } from "./workspace-learning.js";
9
- import type { ActivateCompanyProfileRevisionRequest, CompanyProfileDiffRequest, CompanyProfileDiffResponse, CompanyProfileListOptions, CompanyProfileListResponse, CompanyProfileMutationResponse, CompanyProfileRevision, RollbackCompanyProfileRequest, UpdateCompanyProfileRequest } from "./company-profile.js";
26
+ import type { GovernedLearningActivationUndoReceipt, WorkspaceLearningHistoryOptions, WorkspaceLearningHistoryResponse } from "./workspace-learning.js";
27
+ import type { ActivateCompanyProfileRevisionRequest, CompanyProfileAgentPolicy, CompanyProfileDiffRequest, CompanyProfileDiffResponse, CompanyProfileListOptions, CompanyProfileListResponse, CompanyProfileMutationResponse, CompanyProfileRevision, RollbackCompanyProfileRequest, UpdateCompanyProfileRequest, UpdateCompanyProfileAgentPolicyRequest } from "./company-profile.js";
10
28
  import type { WorkspaceStateExportResponse, WorkspaceStateGetOptions, WorkspaceStateResponse } from "./workspace-state.js";
11
- import type { CompanyBrainOkfDownload, CompanyBrainOkfPackage } from "./company-brain.js";
12
29
  import type { ActivatePreferenceRegistryRevisionRequest, ChangePreferenceRegistryScopeRequest, CorrectPreferenceRegistryRequest, CreatePreferenceRegistryProposalRequest, DeactivatePreferenceRegistryRequest, PreferenceRegistryDetailResponse, PreferenceRegistryFullContent, PreferenceRegistryListOptions, PreferenceRegistryListResponse, PreferenceRegistryMutationResponse, PreferenceRegistryRecord, PreferenceRegistrySnapshot, RejectPreferenceRegistryProposalRequest, SupersedePreferenceRegistryRequest } from "./preference-registry.js";
13
- export type FetchLike = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
30
+ export type SessionListPageOptions = {
31
+ /** Complete content-free totals for an authorized root page. */
32
+ includeTotals?: boolean;
33
+ /** Filter attention rows before pagination. */
34
+ needsYouOnly?: boolean;
35
+ /** Only read-only sessions moved to the idle-session archive. */
36
+ contentArchivedOnly?: boolean;
37
+ /** Created through this Site. In a Site-bound client, "current" resolves to its own Site. */
38
+ originSiteId?: string;
39
+ limit?: number;
40
+ parentSessionId?: string | null;
41
+ /** Only sessions carrying this exact opaque end-user label. */
42
+ scopeSubjectId?: SessionScopeSubjectId;
43
+ cursor?: string;
44
+ search?: string;
45
+ /** Restrict rows to one workspace project; null selects unfiled rows. */
46
+ channelId?: string | null;
47
+ /** Restrict rows to the exact frozen session creator identity. */
48
+ createdBy?: {
49
+ kind: "subject" | "service";
50
+ subjectId: string;
51
+ };
52
+ /** Inclusive ISO-8601 activity lower bound. */
53
+ updatedFrom?: string;
54
+ /** Exclusive ISO-8601 activity upper bound. */
55
+ updatedBefore?: string;
56
+ /** Inclusive ISO-8601 creation lower bound. */
57
+ createdFrom?: string;
58
+ /** Exclusive ISO-8601 creation upper bound. */
59
+ createdBefore?: string;
60
+ /** Return only the complete personal pinned projection. */
61
+ pinsOnly?: boolean;
62
+ /** Skip pinned details when the pinned section is loaded separately. Defaults to true. */
63
+ includePinned?: boolean;
64
+ /** Return archived root chats instead of the active session list. */
65
+ archivedOnly?: boolean;
66
+ sortBy?: "updatedAt" | "createdAt" | "name";
67
+ archiveStatus?: "active" | "archived" | "all";
68
+ /** Stop this caller's finite page read when its owning route is abandoned. */
69
+ signal?: AbortSignal | undefined;
70
+ };
71
+ /**
72
+ * Web-standard fetch response accepted by the SDK.
73
+ *
74
+ * The project global `Response` type includes Bun's non-standard `textStream()`
75
+ * method and the newer `bytes()` method. Fetch implementations such as Expo do
76
+ * not necessarily provide either member, and the SDK does not use them, so
77
+ * they must not be part of the adapter boundary.
78
+ */
79
+ export type FetchResponse = Omit<Response, "bytes" | "clone" | "textStream"> & {
80
+ clone(): FetchResponse;
81
+ };
82
+ export type FetchLike = (input: string | URL | Request, init?: RequestInit) => Promise<FetchResponse>;
14
83
  export type WorkspaceControlEventPage = {
15
84
  events: WorkspaceControlEvent[];
16
85
  bytes: number;
@@ -18,10 +87,18 @@ export type WorkspaceControlEventPage = {
18
87
  nextAfter: number | null;
19
88
  };
20
89
  export type OpenGeniClientOptions = {
21
- /** Base URL of the OpenGeni API, e.g. `https://api.example.com`. */
90
+ /** Explicit compatibility for an API predating targeted tool calls. No automatic downgrade. */
91
+ toolGatewayMode?: "target" | "catalog";
92
+ /** Base URL of the Opengeni API, e.g. `https://api.example.com`. */
22
93
  baseUrl: string;
23
- /** OpenGeni API key, sent as `Authorization: Bearer <apiKey>`. */
94
+ /** Opengeni API key, sent as `Authorization: Bearer <apiKey>`. */
24
95
  apiKey?: string;
96
+ /**
97
+ * Receives a notice (once per route per client) when the API advertises a
98
+ * `Deprecation`/`Sunset` header on a response. Defaults to a one-time
99
+ * `console.warn` per route; pass `false` to silence notices.
100
+ */
101
+ onDeprecation?: OpenGeniDeprecationHandler | false | undefined;
25
102
  /** Extra headers (static or computed per request) merged into every call. */
26
103
  headers?: Record<string, string> | (() => Record<string, string>);
27
104
  /** Custom fetch implementation. Defaults to the global `fetch`. */
@@ -33,11 +110,36 @@ export type OpenGeniClientOptions = {
33
110
  beginSharedRead?: (() => number) | undefined;
34
111
  /** Positive deadline for interactive session commands. Defaults to 15 seconds. */
35
112
  sessionCommandTimeoutMs?: number;
113
+ /**
114
+ * How this client treats an API that advertises a different
115
+ * `x-opengeni-api-contract` revision.
116
+ *
117
+ * - `"strict"`: fail with `OpenGeniApiContractMismatchError` so a browser
118
+ * page served alongside the API can reload onto the matching bundle.
119
+ * - `"compatible"`: keep working. Within a major release train the API is
120
+ * additive (see the compatibility policy), and the API admits bearer
121
+ * (API key / delegated token) mutations from older SDK revisions, so a
122
+ * backend pinned to an older SDK is not broken by every deployment.
123
+ *
124
+ * Defaults to `"strict"` in a browser client without an `apiKey`, and to
125
+ * `"compatible"` everywhere else.
126
+ */
127
+ apiContract?: "strict" | "compatible" | undefined;
36
128
  };
37
129
  /** Per-request cancellation for operations whose caller owns an AbortSignal. */
38
130
  export type OpenGeniRequestOptions = {
39
131
  signal?: AbortSignal | undefined;
40
132
  timeoutMs?: number | undefined;
133
+ /** Opt-in void response handling for focused helpers using the shared transport. */
134
+ responseType?: "json" | "void";
135
+ };
136
+ /** Narrowing filters for BrowserSession/ComputerSession inventories. Filters
137
+ * never grant access; omitted filters return the complete workspace history. */
138
+ export type InteractionSessionListOptions = OpenGeniRequestOptions & {
139
+ /** Only sessions associated with this agent session. */
140
+ associatedSessionId?: string | undefined;
141
+ /** false omits ended and failed sessions. */
142
+ includeTerminal?: boolean | undefined;
41
143
  };
42
144
  export type SharedSessionReadOptions = {
43
145
  /**
@@ -46,6 +148,12 @@ export type SharedSessionReadOptions = {
46
148
  * client has a `beginSharedRead` clock.
47
149
  */
48
150
  onRequestStart?: ((readGeneration?: number) => void) | undefined;
151
+ /**
152
+ * Stop this caller's interest in the shared read. The native request is
153
+ * aborted only after every caller that joined the same generation has
154
+ * stopped waiting for it.
155
+ */
156
+ signal?: AbortSignal | undefined;
49
157
  };
50
158
  export type GetSessionOptions = SharedSessionReadOptions & {
51
159
  /**
@@ -98,21 +206,23 @@ export type FinalizeTranscriptionRecordingInput = {
98
206
  totalDurationMilliseconds: number;
99
207
  signal?: AbortSignal | undefined;
100
208
  };
101
- /**
102
- * Typed client for the OpenGeni public API. Framework-agnostic: only needs
103
- * WHATWG `fetch` + streams, so it runs in Node 18+, Bun, Deno, browsers, and
104
- * edge runtimes.
105
- */
106
209
  export declare class OpenGeniClient {
210
+ get toolGatewayMode(): "target" | "catalog";
211
+ protected externalActorHeader?: string;
212
+ protected serviceInitiatorHeader?: string | undefined;
213
+ protected serviceContextHeader?: string | undefined;
107
214
  private readonly baseUrl;
108
- private readonly options;
215
+ protected readonly options: OpenGeniClientOptions;
109
216
  private readonly fetchImpl;
110
217
  private readonly sessionCommandTimeoutMs;
218
+ private readonly apiContractStrict;
111
219
  private readonly active;
112
220
  private readonly generations;
113
221
  private readonly queued;
114
222
  /** Resource-oriented Browser/Computer facade over this exact authenticated client. */
115
223
  readonly interaction: OpenGeniInteractionClient;
224
+ /** Dynamic typed tool facade backed by the canonical workspace gateway. */
225
+ readonly tools: OpenGeniToolsFacade;
116
226
  constructor(options: OpenGeniClientOptions);
117
227
  /** Make one finalization attempt for a recording; callers may retry retained audio. */
118
228
  transcribeAudio(workspaceId: string, input: TranscribeAudioInput): Promise<TranscribeAudioResponse>;
@@ -132,44 +242,119 @@ export declare class OpenGeniClient {
132
242
  signal?: AbortSignal | undefined;
133
243
  }): Promise<TranscriptionRecordingResponse>;
134
244
  createSession(workspaceId: string, request: CreateSessionRequest): Promise<CreateSessionResponse>;
245
+ /**
246
+ * The task's usage limit and recorded API-equivalent model usage. A child
247
+ * session returns its root's state with `inherited: true`. Servers that
248
+ * predate usage limits return 404.
249
+ */
250
+ getSessionUsageLimit(workspaceId: string, sessionId: string, options?: OpenGeniRequestOptions): Promise<SessionUsageLimit>;
251
+ /**
252
+ * Set (`limitMicros`), lower, raise or clear (`limitMicros: null`) a root
253
+ * task's usage limit with compare-and-set on `expectedVersion`. Person or
254
+ * trusted host only; agents are refused. Changing the limit never resumes
255
+ * paused work. Returns the committed state; 409 on a stale version.
256
+ */
257
+ setSessionUsageLimit(workspaceId: string, sessionId: string, request: SetSessionUsageLimitRequest): Promise<SessionUsageLimit>;
135
258
  getNewSessionDraft(workspaceId: string, options?: OpenGeniRequestOptions): Promise<NewSessionDraft>;
136
259
  saveNewSessionDraft(workspaceId: string, request: SaveNewSessionDraftRequest): Promise<NewSessionDraft>;
260
+ /** The workspace's HTTP credential provider, or null when none is configured. */
261
+ getWorkspaceCredentialProvider(workspaceId: string): Promise<GetWorkspaceCredentialProviderResponse>;
262
+ /**
263
+ * Create or update the workspace credential provider. The signing secret is
264
+ * returned only when the provider is first created; store it then.
265
+ */
266
+ putWorkspaceCredentialProvider(workspaceId: string, request: PutWorkspaceCredentialProviderRequest): Promise<PutWorkspaceCredentialProviderResponse>;
267
+ deleteWorkspaceCredentialProvider(workspaceId: string): Promise<void>;
268
+ listWorkspaceWebhooks(workspaceId: string): Promise<ListWorkspaceWebhooksResponse>;
269
+ /** Create a webhook. The signing secret is returned only in this response. */
270
+ createWorkspaceWebhook(workspaceId: string, request: CreateWorkspaceWebhookRequest): Promise<CreateWorkspaceWebhookResponse>;
271
+ updateWorkspaceWebhook(workspaceId: string, webhookId: string, request: UpdateWorkspaceWebhookRequest): Promise<WorkspaceWebhook>;
272
+ deleteWorkspaceWebhook(workspaceId: string, webhookId: string): Promise<void>;
273
+ listWorkspaceWebhookDeliveries(workspaceId: string, webhookId: string, options?: {
274
+ limit?: number;
275
+ }): Promise<ListWorkspaceWebhookDeliveriesResponse>;
276
+ /** Queue a delivered or failed delivery again with a fresh attempt budget. */
277
+ redeliverWorkspaceWebhookDelivery(workspaceId: string, webhookId: string, deliveryId: string): Promise<WorkspaceWebhookDelivery>;
278
+ /** Images this deployment lets a workspace choose as its default sandbox image. */
279
+ listWorkspaceSandboxImages(workspaceId: string): Promise<WorkspaceSandboxImages>;
280
+ /** Submit general feedback or a session/turn rating. Retain the key when retrying. */
281
+ createFeedback(workspaceId: string, request: CreateFeedbackRequest): Promise<FeedbackSubmissionResponse>;
282
+ /** Only this principal's submissions. No session filter means general feedback only. */
283
+ listOwnFeedback(workspaceId: string, options?: {
284
+ sessionId?: string;
285
+ limit?: number;
286
+ includeTurns?: boolean;
287
+ }): Promise<{
288
+ feedback: Feedback[];
289
+ }>;
137
290
  getSession(workspaceId: string, sessionId: string, options?: GetSessionOptions): Promise<Session>;
291
+ getToolActionReview(workspaceId: string, sessionId: string, approvalId: string): Promise<ToolActionReview>;
292
+ getToolReviewDetails(workspaceId: string, sessionId: string, approvalId: string, options: {
293
+ actionDigest: string;
294
+ path?: string;
295
+ offset?: number;
296
+ }): Promise<ToolReviewDetailsPage>;
297
+ /** Exact model-visible prefix captured from the latest provider request. */
298
+ getSessionModelContext(workspaceId: string, sessionId: string): Promise<SessionModelContextResponse>;
138
299
  updateSession(workspaceId: string, sessionId: string, request: UpdateSessionRequest): Promise<Session>;
139
- /** Replace the complete ordered Variable Set selection at a quiescent turn boundary. */
140
- updateSessionVariableSets(workspaceId: string, sessionId: string, request: UpdateSessionVariableSetsRequest): Promise<Session>;
141
300
  /** Whether this exact authenticated principal may atomically create a private session. */
142
301
  getSessionTenancyCreateCapabilities(workspaceId: string): Promise<SessionTenancyCreateCapabilities>;
143
- /** Change an owned, fully quiescent session between private and workspace visibility. */
302
+ /**
303
+ * Change an owned session between private and workspace visibility. Leftover
304
+ * records never block it; work in progress needs `stopActiveWork`.
305
+ */
144
306
  updateSessionVisibility(workspaceId: string, sessionId: string, request: UpdateSessionVisibilityRequest): Promise<UpdateSessionVisibilityResponse>;
307
+ /** Owner-only preview: what changing the audience would stop and what would still refuse it. */
308
+ previewSessionVisibilityChange(workspaceId: string, sessionId: string, visibility: SessionVisibility): Promise<SessionVisibilityChangePreview>;
145
309
  /** Create an independent same-workspace fork with explicit destination visibility. */
146
310
  forkSession(workspaceId: string, sessionId: string, request: ForkSessionRequest): Promise<ForkSessionResponse>;
147
311
  /** Replace the durable tool policy or explicitly adopt workspace defaults. */
148
312
  updateSessionToolPolicy(workspaceId: string, sessionId: string, request: UpdateSessionToolPolicyRequest): Promise<Session>;
313
+ /**
314
+ * Replace the session's agent configuration (capabilities, identity,
315
+ * instructions alias, renderer). Omitted fields keep their current values.
316
+ * Uses the tool-policy version (409 when stale) and applies from the next
317
+ * turn. A legacy session converts from its current effective state.
318
+ */
319
+ updateSessionAgent(workspaceId: string, sessionId: string, request: UpdateSessionAgentRequest): Promise<Session>;
320
+ /**
321
+ * Replace every Skill the session carries itself (an empty list removes
322
+ * them). Uses the tool-policy version (409 when stale) and applies from the
323
+ * next turn; a running turn keeps the Skills it started with.
324
+ */
325
+ updateSessionSkills(workspaceId: string, sessionId: string, request: UpdateSessionSkillsRequest): Promise<Session>;
149
326
  /**
150
327
  * Replace one attached MCP server's approval policy. The change is captured
151
328
  * by the next claimed attempt; already-claimed work keeps its immutable
152
329
  * policy snapshot.
153
330
  */
154
331
  updateSessionMcpApprovalPolicy(workspaceId: string, sessionId: string, serverId: string, request: UpdateSessionMcpApprovalPolicyRequest): Promise<UpdateSessionMcpApprovalPolicyResponse>;
332
+ /** Search durable visible user/assistant text, including unloaded history.
333
+ * Pages may be empty with hasMore=true. Never fall back to title search on
334
+ * older servers. Use listEventPage before/after the returned sequence for context.
335
+ */
336
+ searchSessionMessages(workspaceId: string, request: SessionMessageSearchRequest, options?: OpenGeniRequestOptions): Promise<SessionMessageSearchResponse>;
337
+ /** Read one selected search result's complete visible text when <=12,000
338
+ * UTF-16 units. Stale, duplicate or non-message references fail with 404.
339
+ * The response never includes audit payload fields such as modelContext.
340
+ */
341
+ getSessionMessagePreview(workspaceId: string, sessionId: string, reference: SessionMessagePreviewReference, options?: OpenGeniRequestOptions): Promise<SessionMessagePreview>;
155
342
  listSessions(workspaceId: string, options?: {
343
+ originSiteId?: string;
156
344
  limit?: number;
157
345
  parentSessionId?: string | null;
158
346
  search?: string;
347
+ /** Only sessions carrying this exact opaque end-user label. */
348
+ scopeSubjectId?: SessionScopeSubjectId;
159
349
  }): Promise<Session[]>;
160
- listSessionBackgroundCommands(workspaceId: string, sessionId: string): Promise<SessionBackgroundCommandListResponse>;
350
+ /** Running and stopping commands only; settled results remain in session history. */
351
+ listSessionBackgroundCommands(workspaceId: string, sessionId: string, options?: OpenGeniRequestOptions): Promise<SessionBackgroundCommandListResponse>;
161
352
  cancelSessionBackgroundCommand(workspaceId: string, sessionId: string, commandId: string): Promise<CancelSessionBackgroundCommandResult>;
162
353
  /** Pin-aware ordinary-session page with a stable keyset cursor. */
163
- listSessionPage(workspaceId: string, options?: {
164
- limit?: number;
165
- parentSessionId?: string | null;
166
- cursor?: string;
167
- search?: string;
168
- /** Return only the complete personal pinned projection. */
169
- pinsOnly?: boolean;
170
- /** Return archived root chats instead of the active session list. */
171
- archivedOnly?: boolean;
172
- }): Promise<SessionListResponse>;
354
+ listSessionPage(workspaceId: string, options?: SessionListPageOptions): Promise<SessionListResponse>;
355
+ /** Compact rail records; safely projects full pages from older APIs. */
356
+ listSessionSummaryPage(workspaceId: string, options?: SessionListPageOptions): Promise<SessionListEntryResponse>;
357
+ private requestSessionPage;
173
358
  /** Compact, bounded workspace agent hierarchy page. */
174
359
  listAgentTopology(workspaceId: string, options?: {
175
360
  limit?: number;
@@ -195,6 +380,11 @@ export declare class OpenGeniClient {
195
380
  updateSessionAttention(workspaceId: string, sessionId: string, request: UpdateSessionAttentionRequest): Promise<Session>;
196
381
  /** Archive or restore this authenticated member's root chat. */
197
382
  updateSessionArchive(workspaceId: string, sessionId: string, request: UpdateSessionArchiveRequest): Promise<Session>;
383
+ /**
384
+ * Keep a session out of the idle-session archive (or allow archiving again).
385
+ * Fails with 409 SESSION_ARCHIVED_READ_ONLY once the session is archived.
386
+ */
387
+ updateSessionRetention(workspaceId: string, sessionId: string, request: UpdateSessionRetentionRequest): Promise<Session>;
198
388
  /** Permanently delete one quiescent root session and its full descendant tree. */
199
389
  deleteSession(workspaceId: string, sessionId: string): Promise<{
200
390
  deletedSessionCount: number;
@@ -203,6 +393,7 @@ export declare class OpenGeniClient {
203
393
  private sharedRead;
204
394
  private queueRead;
205
395
  private launchRead;
396
+ private consumeSharedRead;
206
397
  private observeRead;
207
398
  /** Negotiate one server-mediated connected-Codex GPT-Live V3 WebRTC call. */
208
399
  negotiateCodexRealtimeWebrtc(workspaceId: string, sessionId: string, request: CodexRealtimeWebrtcRequest, options?: {
@@ -231,9 +422,10 @@ export declare class OpenGeniClient {
231
422
  listTurns(workspaceId: string, sessionId: string, options?: {
232
423
  limit?: number;
233
424
  latestStarted?: boolean;
425
+ signal?: AbortSignal | undefined;
234
426
  }): Promise<SessionTurn[]>;
235
427
  /** Newest turn that durably emitted `turn.started`, or null before any admission. */
236
- getLatestStartedTurn(workspaceId: string, sessionId: string): Promise<SessionTurn | null>;
428
+ getLatestStartedTurn(workspaceId: string, sessionId: string, options?: OpenGeniRequestOptions): Promise<SessionTurn | null>;
237
429
  /**
238
430
  * List the workspace's machines (the Machines dashboard). Each enrolled
239
431
  * selfhosted machine carries its derived state + latest metrics +
@@ -248,6 +440,19 @@ export declare class OpenGeniClient {
248
440
  * install the exact signed version promoted for its channel. Progress is read
249
441
  * from `listMachines`; completion requires the successor build identity. */
250
442
  updateMachineAgent(workspaceId: string, enrollmentId: string): Promise<UpdateMachineAgentResponse>;
443
+ /** Turn screen control on for one connected machine, in place: the consent is
444
+ * recorded and the live agent refreshes its own credentials. Safe to repeat. */
445
+ enableMachineScreenControl(workspaceId: string, enrollmentId: string): Promise<EnableMachineScreenControlResponse>;
446
+ /** Open one macOS Privacy & Security pane on a connected Mac, so the person
447
+ * only has to flip the permission for Opengeni. */
448
+ openMachinePrivacySettings(workspaceId: string, enrollmentId: string, input: OpenMachinePrivacySettingsRequest): Promise<OpenMachinePrivacySettingsResponse>;
449
+ /** List what changing who can use a Connected Machine (Workspace or Only me)
450
+ * would affect, with the given chat choices applied. Reads only. */
451
+ previewMachineAudience(workspaceId: string, enrollmentId: string, input: MachineAudiencePreviewRequest): Promise<MachineAudiencePreview>;
452
+ /** Change who can use a Connected Machine in place, at the previewed
453
+ * generation. The machine keeps its sandbox ID, credentials and connection.
454
+ * A 409 means something changed or still needs a decision: preview again. */
455
+ changeMachineAudience(workspaceId: string, enrollmentId: string, input: ChangeMachineAudienceRequest): Promise<ChangeMachineAudienceResponse>;
251
456
  /** Revision-fenced update of a Connected Machine's optional command memory
252
457
  * policy. Null byte limits preserve unrestricted machine access. */
253
458
  updateMachineOperationPolicy(workspaceId: string, enrollmentId: string, request: UpdateMachineOperationPolicyRequest): Promise<MachineOperationPolicy>;
@@ -261,9 +466,10 @@ export declare class OpenGeniClient {
261
466
  /**
262
467
  * Remove one connected self-hosted machine enrollment. The control-plane
263
468
  * operation works while the agent is offline, revokes future reconnects,
264
- * retains history, and atomically detaches idle dependent sessions (a
265
- * machine-home session becomes `backend:none`). Active turns, live leases,
266
- * and recovery work remain typed blockers. `idempotencyKey` is replay-safe.
469
+ * retains history, and atomically detaches the sessions that point at it,
470
+ * including ones with a queued, paused or recovering turn (a machine-home
471
+ * session becomes `backend:none`). Only a live machine lease or pending lease
472
+ * recovery remains a typed blocker. `idempotencyKey` is replay-safe.
267
473
  */
268
474
  removeEnrollment(workspaceId: string, enrollmentId: string, request?: RemoveEnrollmentRequest): Promise<RemoveEnrollmentResponse>;
269
475
  /**
@@ -290,11 +496,14 @@ export declare class OpenGeniClient {
290
496
  * Mint a short-TTL headless enroll token (the `oget_` token) for the fleet /
291
497
  * non-interactive enroll path. The returned `token` is SECRET — surface it once
292
498
  * with a copy-now warning; it cannot be re-read. `allowScreenControl` bakes the
293
- * screen-control consent into the token.
499
+ * screen-control consent into the token. `scope: "user"` connects the signed-in
500
+ * person's own machine; `"workspace"` (or omitted) shares it with the workspace.
501
+ * Check the response's `scope` before showing a command: an older server ignores
502
+ * the request and mints a workspace-shared token.
294
503
  */
295
504
  mintEnrollToken(workspaceId: string, request?: {
296
505
  allowScreenControl?: boolean;
297
- }): Promise<MintEnrollTokenResponse>;
506
+ } | MintEnrollTokenRequest): Promise<MintEnrollTokenResponse>;
298
507
  /**
299
508
  * Swap a session's active sandbox (the user-authenticated equivalent of the
300
509
  * M7 `sandbox_swap` MCP tool). `target` is a `MachineView.sandboxId` from
@@ -306,8 +515,15 @@ export declare class OpenGeniClient {
306
515
  swapActiveSandbox(workspaceId: string, sessionId: string, request: SwapActiveSandboxRequest): Promise<SwapActiveSandboxResponse>;
307
516
  listScheduledTasks(workspaceId: string, options?: {
308
517
  limit?: number;
518
+ offset?: number;
519
+ sessionId?: string;
309
520
  }): Promise<ScheduledTask[]>;
310
521
  getScheduledTask(workspaceId: string, taskId: string): Promise<ScheduledTask>;
522
+ /**
523
+ * Channels a person may choose as a scheduled task's fixed Slack destination:
524
+ * active, non-shared channels the selected Opengeni bot already belongs to.
525
+ */
526
+ listScheduledTaskSlackChannels(workspaceId: string, connectionId: string, cursor?: string): Promise<SlackReactionChannelListResponse>;
311
527
  /**
312
528
  * Return the events from one bounded page. With no cursor, this uses the safe
313
529
  * semantic monitoring tail; pass explicit forensic options and a cursor for
@@ -364,9 +580,15 @@ export declare class OpenGeniClient {
364
580
  editQueueItem(workspaceId: string, sessionId: string, turnId: string, request: EditSessionQueueItemRequest): Promise<SessionQueueMutationResponse>;
365
581
  steerQueueItem(workspaceId: string, sessionId: string, turnId: string, request: SteerSessionQueueItemRequest): Promise<SessionQueueMutationResponse>;
366
582
  deleteQueueItem(workspaceId: string, sessionId: string, turnId: string, request: DeleteSessionQueueItemRequest): Promise<SessionQueueMutationResponse>;
367
- getComposerDraft(workspaceId: string, sessionId: string): Promise<ComposerDraft>;
583
+ getComposerDraft(workspaceId: string, sessionId: string, options?: OpenGeniRequestOptions): Promise<ComposerDraft>;
368
584
  saveComposerDraft(workspaceId: string, sessionId: string, request: SaveComposerDraftRequest): Promise<ComposerDraft>;
369
585
  submitComposerDraft(workspaceId: string, sessionId: string, request: SubmitComposerDraftRequest): Promise<SubmitComposerDraftResponse>;
586
+ /** Inspect bounded checkpoint recovery eligibility without changing session state. */
587
+ getSandboxRecovery(workspaceId: string, sessionId: string): Promise<SandboxRecoveryProjection>;
588
+ /** Restore only the explicitly selected checkpoint; never retry a command. */
589
+ recoverSandbox(workspaceId: string, sessionId: string, request: SandboxRecoveryRequest): Promise<SandboxRecoveryResponse>;
590
+ /** Retry the exact failed turn. Keep clientEventId unchanged on transport retries. */
591
+ retrySession(workspaceId: string, sessionId: string, request: SessionRetryRequest): Promise<SessionRetryResponse>;
370
592
  controlSession(workspaceId: string, sessionId: string, request: {
371
593
  action: "pause" | "resume" | "cancel";
372
594
  reason?: string;
@@ -388,6 +610,9 @@ export declare class OpenGeniClient {
388
610
  clientEventId?: string;
389
611
  expectedControlEtag?: string;
390
612
  }): Promise<SessionControlResponse>;
613
+ setWorkspacePauseTimer(workspaceId: string, request: import("./types.js").WorkspacePauseTimerRequest): Promise<{
614
+ ok: boolean;
615
+ }>;
391
616
  setWorkspaceInferenceState(workspaceId: string, request: {
392
617
  action: "pause" | "resume";
393
618
  reason?: string;
@@ -426,7 +651,15 @@ export declare class OpenGeniClient {
426
651
  */
427
652
  steerMessage(workspaceId: string, sessionId: string, message: string | SendMessageInput): Promise<SteerMessageResult>;
428
653
  /** The session's goal. 404s when the session never had one. */
429
- getGoal(workspaceId: string, sessionId: string): Promise<SessionGoal>;
654
+ getGoal(workspaceId: string, sessionId: string, options?: SharedSessionReadOptions): Promise<SessionGoal>;
655
+ /**
656
+ * The session's goal, or `null` when the session has none. Unlike
657
+ * {@link getGoal}, a goal-less session is a successful read (`?absent=null`
658
+ * answers 200 `null`), so browsers log no failed request. Servers that
659
+ * predate the opt-in ignore it and still answer 404; a missing session is
660
+ * always a 404.
661
+ */
662
+ findGoal(workspaceId: string, sessionId: string, options?: SharedSessionReadOptions): Promise<SessionGoal | null>;
430
663
  updateGoal(workspaceId: string, sessionId: string, request: UpdateSessionGoalRequest): Promise<SessionGoal>;
431
664
  listGoalRevisions(workspaceId: string, sessionId: string): Promise<SessionGoalRevision[]>;
432
665
  listGoalRevisionPage(workspaceId: string, sessionId: string, options?: ListSessionGoalRevisionsOptions): Promise<ListSessionGoalRevisionsResponse>;
@@ -538,7 +771,6 @@ export declare class OpenGeniClient {
538
771
  getAuthRun(workspaceId: string, authRunId: string, options?: OpenGeniRequestOptions): Promise<AuthRun>;
539
772
  startBrowserAuthRun(workspaceId: string, browserSessionId: string, request: StartAuthRunRequest, options?: OpenGeniRequestOptions): Promise<AuthRunMutationResponse>;
540
773
  reportBrowserAuthRun(workspaceId: string, browserSessionId: string, authRunId: string, request: ReportAuthRunRequest, options?: OpenGeniRequestOptions): Promise<AuthRunMutationResponse>;
541
- protectedBrowserAuthFill(workspaceId: string, browserSessionId: string, authRunId: string, request: ProtectedAuthFillRequest, options?: OpenGeniRequestOptions): Promise<ProtectedAuthFillResponse>;
542
774
  advanceExternalBrowserAuthRun(workspaceId: string, browserSessionId: string, authRunId: string, request: ExternalAuthRunRequest, options?: OpenGeniRequestOptions): Promise<ExternalAuthRunResponse>;
543
775
  openExternalBrowserAuthFlow(workspaceId: string, browserSessionId: string, authRunId: string, request: ExternalAuthInteractiveRequest, options?: OpenGeniRequestOptions): Promise<ExternalAuthInteractiveResponse>;
544
776
  verifyBrowserAuthRun(workspaceId: string, browserSessionId: string, authRunId: string, request: VerifyAuthRunRequest, options?: OpenGeniRequestOptions): Promise<AuthRunMutationResponse>;
@@ -555,7 +787,7 @@ export declare class OpenGeniClient {
555
787
  listBrowserRevisions(workspaceId: string, identityId: string, options?: OpenGeniRequestOptions): Promise<BrowserRevisionListResponse>;
556
788
  /** Workspace-wide BrowserSession inventory. Associations express relevance,
557
789
  * not access: peers and child agents intentionally remain discoverable. */
558
- listBrowserSessions(workspaceId: string, options?: OpenGeniRequestOptions): Promise<BrowserSessionListResponse>;
790
+ listBrowserSessions(workspaceId: string, options?: OpenGeniRequestOptions | InteractionSessionListOptions): Promise<BrowserSessionListResponse>;
559
791
  getBrowserSession(workspaceId: string, browserSessionId: string, options?: OpenGeniRequestOptions): Promise<BrowserSession>;
560
792
  readBrowserClipboard(workspaceId: string, browserSessionId: string, options?: OpenGeniRequestOptions): Promise<BrowserClipboard>;
561
793
  listBrowserDownloads(workspaceId: string, browserSessionId: string, options?: OpenGeniRequestOptions): Promise<BrowserDownloadListResponse>;
@@ -564,9 +796,14 @@ export declare class OpenGeniClient {
564
796
  createBrowserSession(workspaceId: string, request: CreateBrowserSessionRequest, options?: OpenGeniRequestOptions): Promise<BrowserSessionMutationResponse>;
565
797
  listBrowserTargets(workspaceId: string, browserSessionId: string, options?: OpenGeniRequestOptions): Promise<BrowserTargetListResponse>;
566
798
  openBrowserTarget(workspaceId: string, browserSessionId: string, request?: BrowserOpenTargetRequest, options?: OpenGeniRequestOptions): Promise<BrowserObservation>;
799
+ /** Opens a tab and returns inventory without collecting page content. */
800
+ openBrowserTargetWithInventory(workspaceId: string, browserSessionId: string, request?: BrowserOpenTargetRequest, options?: OpenGeniRequestOptions): Promise<BrowserTargetListResponse>;
567
801
  selectBrowserTarget(workspaceId: string, browserSessionId: string, targetId: string, options?: OpenGeniRequestOptions): Promise<BrowserObservation>;
802
+ captureBrowserTarget(workspaceId: string, browserSessionId: string, targetId: string, options?: OpenGeniRequestOptions, captureOptions?: BrowserScreenshotOptions): Promise<BrowserFrame>;
568
803
  closeBrowserTarget(workspaceId: string, browserSessionId: string, targetId: string, options?: OpenGeniRequestOptions): Promise<BrowserTargetListResponse>;
569
804
  observeBrowserTarget(workspaceId: string, browserSessionId: string, targetId: string, options?: OpenGeniRequestOptions): Promise<BrowserObservation>;
805
+ getBrowserTargetState(workspaceId: string, browserSessionId: string, targetId: string, options?: OpenGeniRequestOptions): Promise<BrowserTargetState>;
806
+ readBrowserDom(workspaceId: string, browserSessionId: string, targetId: string, request: BrowserDomReadRequest, options?: OpenGeniRequestOptions): Promise<BrowserDomReadResponse>;
570
807
  actInBrowser(workspaceId: string, browserSessionId: string, request: BrowserActionRequest, options?: OpenGeniRequestOptions): Promise<BrowserActionReceipt>;
571
808
  getBrowserActionReceipt(workspaceId: string, browserSessionId: string, operationId: string, options?: OpenGeniRequestOptions): Promise<BrowserActionReceipt>;
572
809
  listBrowserDiagnostics(workspaceId: string, browserSessionId: string, targetId: string, options?: BrowserDiagnosticsOptions): Promise<BrowserDiagnosticBatch>;
@@ -578,13 +815,17 @@ export declare class OpenGeniClient {
578
815
  endBrowserSession(workspaceId: string, browserSessionId: string, request: BrowserSessionLifecycleRequest, options?: OpenGeniRequestOptions): Promise<BrowserSessionMutationResponse>;
579
816
  /** Workspace-wide ComputerSession inventory. Associations express
580
817
  * relevance, not access; peer sessions intentionally remain discoverable. */
581
- listComputerSessions(workspaceId: string, options?: OpenGeniRequestOptions): Promise<ComputerSessionListResponse>;
818
+ listComputerSessions(workspaceId: string, options?: OpenGeniRequestOptions | InteractionSessionListOptions): Promise<ComputerSessionListResponse>;
582
819
  getComputerSession(workspaceId: string, computerSessionId: string, options?: OpenGeniRequestOptions): Promise<ComputerSession>;
583
820
  readComputerClipboard(workspaceId: string, computerSessionId: string, options?: OpenGeniRequestOptions): Promise<ComputerClipboard>;
821
+ getComputerInputPosture(workspaceId: string, computerSessionId: string, options?: OpenGeniRequestOptions): Promise<ComputerSessionInputPosture>;
584
822
  createComputerSession(workspaceId: string, request: CreateComputerSessionRequest, options?: OpenGeniRequestOptions): Promise<ComputerSessionMutationResponse>;
585
823
  listComputerTargets(workspaceId: string, computerSessionId: string, options?: OpenGeniRequestOptions): Promise<ComputerTargetListResponse>;
586
824
  observeComputerTarget(workspaceId: string, computerSessionId: string, targetId: string, options?: OpenGeniRequestOptions): Promise<ComputerObservation>;
825
+ captureComputerTarget(workspaceId: string, computerSessionId: string, targetId: string, options?: OpenGeniRequestOptions): Promise<ComputerFrame>;
826
+ callNativeComputerTool(workspaceId: string, computerSessionId: string, request: ComputerNativeCallRequest, options?: OpenGeniRequestOptions): Promise<ComputerNativeReceipt>;
587
827
  actInComputer(workspaceId: string, computerSessionId: string, request: ComputerActionRequest, options?: OpenGeniRequestOptions): Promise<ComputerActionReceipt>;
828
+ getNativeComputerToolReceipt(workspaceId: string, computerSessionId: string, operationId: string, options?: OpenGeniRequestOptions): Promise<ComputerNativeReceipt>;
588
829
  getComputerActionReceipt(workspaceId: string, computerSessionId: string, operationId: string, options?: OpenGeniRequestOptions): Promise<ComputerActionReceipt>;
589
830
  attachComputerSession(workspaceId: string, computerSessionId: string, request: ComputerSessionAttachmentRequest, options?: OpenGeniRequestOptions): Promise<ComputerSessionAttachment>;
590
831
  heartbeatComputerSession(workspaceId: string, computerSessionId: string, options?: OpenGeniRequestOptions): Promise<ComputerSessionHeartbeatResponse>;
@@ -595,28 +836,173 @@ export declare class OpenGeniClient {
595
836
  * reasoning efforts, MCP servers, file-upload limits, and how the client is
596
837
  * expected to authenticate. Drives a composer's model picker without prior
597
838
  * knowledge of the host setup; safe to call before any auth is established.
839
+ * Authenticated calls resolve the caller's default workspace, or the exact
840
+ * `workspaceId` option, using the same selection rules as fresh session create.
598
841
  */
599
- getClientConfig(): Promise<ClientConfig>;
842
+ getClientConfig(options?: OpenGeniRequestOptions & {
843
+ workspaceId?: string;
844
+ }): Promise<ClientConfig>;
600
845
  /** Authenticated model definitions plus workspace-specific selectability. */
601
- getWorkspaceModelCatalog(workspaceId: string): Promise<WorkspaceModelCatalogResponse>;
846
+ getWorkspaceModelCatalog(workspaceId: string, options?: OpenGeniRequestOptions): Promise<WorkspaceModelCatalogResponse>;
847
+ /** List workspace-owned unpinned Vercel AI Gateway model slugs. */
848
+ listWorkspaceGatewayCustomModels(workspaceId: string): Promise<WorkspaceGatewayCustomModelsResponse>;
849
+ /** Add one exact upstream Vercel AI Gateway slug. */
850
+ createWorkspaceGatewayCustomModel(workspaceId: string, request: CreateWorkspaceGatewayCustomModelRequest): Promise<WorkspaceGatewayCustomModel>;
851
+ /** Remove one workspace custom Gateway model by its stable row id. */
852
+ deleteWorkspaceGatewayCustomModel(workspaceId: string, customModelId: string, request: DeleteWorkspaceGatewayCustomModelRequest): Promise<void>;
853
+ /** List workspace-owned unpinned OpenRouter model slugs. */
854
+ listWorkspaceOpenRouterCustomModels(workspaceId: string): Promise<WorkspaceOpenRouterCustomModelsResponse>;
855
+ /** Add one exact upstream OpenRouter slug. */
856
+ createWorkspaceOpenRouterCustomModel(workspaceId: string, request: CreateWorkspaceOpenRouterCustomModelRequest): Promise<WorkspaceOpenRouterCustomModel>;
857
+ /** Remove one workspace custom OpenRouter model by its stable row id. */
858
+ deleteWorkspaceOpenRouterCustomModel(workspaceId: string, customModelId: string, request: DeleteWorkspaceOpenRouterCustomModelRequest): Promise<void>;
859
+ /** List workspace-owned exact Opper model ids (pools or provider/model routes). */
860
+ listWorkspaceOpperCustomModels(workspaceId: string): Promise<WorkspaceOpperCustomModelsResponse>;
861
+ /** Add one exact upstream Opper model id. */
862
+ createWorkspaceOpperCustomModel(workspaceId: string, request: CreateWorkspaceOpperCustomModelRequest): Promise<WorkspaceOpperCustomModel>;
863
+ /** Remove one workspace custom Opper model by its stable row id. */
864
+ deleteWorkspaceOpperCustomModel(workspaceId: string, customModelId: string, request: DeleteWorkspaceOpperCustomModelRequest): Promise<void>;
865
+ /** Read metadata for one organization-owned model-provider connection. */
866
+ getWorkspaceClaudeSubscriptionUsage(workspaceId: string): Promise<ClaudeSubscriptionUsage>;
867
+ listClaudeSubscriptionAccounts(workspaceId: string): Promise<ClaudeSubscriptionAccountsResponse>;
868
+ activateClaudeSubscriptionAccount(workspaceId: string, accountId: string): Promise<{
869
+ activated: boolean;
870
+ accountId: string;
871
+ }>;
872
+ setClaudeSubscriptionRotationSettings(workspaceId: string, request: {
873
+ rotationEnabled: boolean;
874
+ }): Promise<SubscriptionPoolSettings>;
875
+ setClaudeSubscriptionAccountAllocator(workspaceId: string, accountId: string, request: {
876
+ enabled: boolean;
877
+ expectedVersion: number;
878
+ }): Promise<unknown>;
879
+ renameClaudeSubscriptionAccount(workspaceId: string, accountId: string, label: string | null): Promise<ClaudeSubscriptionAccount>;
880
+ disconnectClaudeSubscriptionAccount(workspaceId: string, accountId: string): Promise<unknown>;
881
+ getClaudeSubscriptionAccountUsage(workspaceId: string, accountId: string): Promise<ClaudeSubscriptionUsage>;
882
+ refreshClaudeSubscriptionAccountUsage(workspaceId: string, accountId: string): Promise<ClaudeSubscriptionUsage>;
883
+ listOrganizationClaudeSubscriptionAccounts(organizationId: string): Promise<ClaudeSubscriptionAccountsResponse>;
884
+ activateOrganizationClaudeSubscriptionAccount(organizationId: string, accountId: string): Promise<{
885
+ updated: boolean;
886
+ }>;
887
+ setOrganizationClaudeSubscriptionRotationSettings(organizationId: string, request: {
888
+ rotationEnabled: boolean;
889
+ }): Promise<SubscriptionPoolSettings>;
890
+ setOrganizationClaudeSubscriptionAccountAllocator(organizationId: string, accountId: string, request: {
891
+ enabled: boolean;
892
+ expectedVersion: number;
893
+ }): Promise<unknown>;
894
+ renameOrganizationClaudeSubscriptionAccount(organizationId: string, accountId: string, label: string | null): Promise<{
895
+ updated: boolean;
896
+ }>;
897
+ disconnectOrganizationClaudeSubscriptionAccount(organizationId: string, accountId: string): Promise<unknown>;
898
+ getOrganizationClaudeSubscriptionAccountUsage(organizationId: string, accountId: string): Promise<ClaudeSubscriptionUsage>;
899
+ refreshOrganizationClaudeSubscriptionAccountUsage(organizationId: string, accountId: string): Promise<ClaudeSubscriptionUsage>;
900
+ connectClaudeSubscriptionSetupToken(workspaceId: string, request: Omit<ClaudeSubscriptionSetupTokenRequest, "scope"> & {
901
+ scope?: "workspace" | "user";
902
+ }): Promise<ClaudeSubscriptionOAuthCompleteResponse>;
903
+ connectOrganizationClaudeSubscriptionSetupToken(organizationId: string, request: Omit<ClaudeSubscriptionSetupTokenRequest, "scope">): Promise<ClaudeSubscriptionOAuthCompleteResponse>;
904
+ /** Sign in with model and profile access; no inference request is made. */
905
+ startWorkspaceClaudeSubscriptionOAuth(workspaceId: string, request?: Partial<ClaudeSubscriptionOAuthStartRequest>): Promise<ClaudeSubscriptionOAuthStartResponse>;
906
+ completeWorkspaceClaudeSubscriptionOAuth(workspaceId: string, request: ClaudeSubscriptionOAuthCompleteRequest): Promise<ClaudeSubscriptionOAuthCompleteResponse>;
907
+ startOrganizationClaudeSubscriptionOAuth(organizationId: string, request?: Pick<ClaudeSubscriptionOAuthStartRequest, "reconnectAccountId">): Promise<ClaudeSubscriptionOAuthStartResponse>;
908
+ completeOrganizationClaudeSubscriptionOAuth(organizationId: string, request: ClaudeSubscriptionOAuthCompleteRequest): Promise<ClaudeSubscriptionOAuthCompleteResponse>;
909
+ refreshWorkspaceClaudeSubscriptionUsage(workspaceId: string): Promise<ClaudeSubscriptionUsage>;
910
+ getOrganizationClaudeSubscriptionUsage(organizationId: string): Promise<ClaudeSubscriptionUsage>;
911
+ refreshOrganizationClaudeSubscriptionUsage(organizationId: string): Promise<ClaudeSubscriptionUsage>;
912
+ /** Read metadata for one organization-owned model-provider connection. */
913
+ getOrganizationModelProviderConnection(organizationId: string, providerKind: OrganizationModelProviderKind): Promise<OrganizationModelProviderConnection | null>;
914
+ /** Connect or rotate one organization-owned provider credential. */
915
+ upsertOrganizationModelProviderConnection(organizationId: string, providerKind: OrganizationModelProviderKind, request: UpsertOrganizationModelProviderConnectionRequest): Promise<OrganizationModelProviderConnection>;
916
+ /** Revoke one organization-owned provider credential. */
917
+ revokeOrganizationModelProviderConnection(organizationId: string, providerKind: OrganizationModelProviderKind, request: RevokeOrganizationModelProviderConnectionRequest): Promise<OrganizationModelProviderConnection>;
918
+ /** List workspace-owned Claude model slugs. */
919
+ listWorkspaceClaudeCustomModels(workspaceId: string, providerKind: "anthropic" | "claude_subscription"): Promise<WorkspaceGatewayCustomModelsResponse>;
920
+ /** Add an immutable workspace-owned Claude model generation. */
921
+ createWorkspaceClaudeCustomModel(workspaceId: string, providerKind: "anthropic" | "claude_subscription", request: CreateWorkspaceGatewayCustomModelRequest): Promise<WorkspaceGatewayCustomModel>;
922
+ /** Retire a workspace-owned Claude model generation. */
923
+ deleteWorkspaceClaudeCustomModel(workspaceId: string, providerKind: "anthropic" | "claude_subscription", customModelId: string, request: DeleteWorkspaceGatewayCustomModelRequest): Promise<void>;
924
+ /** List organization-owned exact upstream model slugs. */
925
+ listOrganizationProviderCustomModels(organizationId: string, providerKind: OrganizationModelProviderKind): Promise<OrganizationProviderCustomModelsResponse>;
926
+ /** Add one organization-owned exact upstream model slug. */
927
+ createOrganizationProviderCustomModel(organizationId: string, providerKind: OrganizationModelProviderKind, request: CreateOrganizationProviderCustomModelRequest): Promise<OrganizationProviderCustomModel>;
928
+ /** Retire one organization-owned custom model. */
929
+ deleteOrganizationProviderCustomModel(organizationId: string, providerKind: OrganizationModelProviderKind, customModelId: string, request: DeleteOrganizationProviderCustomModelRequest): Promise<OrganizationProviderCustomModel>;
602
930
  /** Read the workspace's hard provider/model allowlist. */
603
931
  getWorkspaceModelAccessPolicy(workspaceId: string): Promise<WorkspaceModelAccessPolicy>;
932
+ /** Remove the workspace's own allowlist so it follows its organization's default. */
933
+ deleteWorkspaceModelAccessPolicy(workspaceId: string): Promise<WorkspaceModelAccessPolicy>;
934
+ /** The model defaults every workspace in the organization follows (owners and admins). */
935
+ getOrganizationModelDefaults(organizationId: string): Promise<OrganizationModelDefaults>;
936
+ /** Change organization model defaults, field by field (owners and admins). */
937
+ updateOrganizationModelDefaults(organizationId: string, request: UpdateOrganizationModelDefaultsRequest): Promise<OrganizationModelDefaults>;
938
+ /** Organization model-account settings and locks (owners and admins). */
939
+ getOrganizationModelAccountSettings(organizationId: string): Promise<OrganizationModelAccountSettings>;
940
+ /** Change organization model-account settings or locks (owners and admins). */
941
+ updateOrganizationModelAccountSettings(organizationId: string, request: UpdateOrganizationModelAccountSettingsRequest): Promise<OrganizationModelAccountSettings>;
942
+ /** Every shared workspace's effective model-account settings and their sources (owners and admins). */
943
+ getModelAccountSettingsOverview(organizationId: string, options?: {
944
+ after?: string;
945
+ limit?: number;
946
+ }): Promise<ModelAccountSettingsOverview>;
947
+ /** A workspace's effective model-account settings, sources and overrides. */
948
+ getWorkspaceModelAccountSettings(workspaceId: string): Promise<WorkspaceModelAccountSettings>;
949
+ /** Override, or follow again, the organization's unlocked settings (workspace admins). */
950
+ updateWorkspaceModelAccountSettings(workspaceId: string, request: UpdateWorkspaceModelAccountSettingsRequest): Promise<WorkspaceModelAccountSettings>;
951
+ /** The session's model account, the accounts it may switch to, and the personal settings. */
952
+ getSessionModelAccount(workspaceId: string, sessionId: string): Promise<SessionModelAccountChoiceResponse>;
953
+ /** Choose the session's model account, or `connectionId: null` for automatic selection. */
954
+ setSessionModelAccount(workspaceId: string, sessionId: string, request: SetSessionModelAccountChoiceRequest): Promise<SetSessionModelAccountChoiceResponse>;
955
+ /**
956
+ * Your own model-account preferences in an organization. For a person (a
957
+ * signed-in browser, or an agent acting as one); other callers get 404.
958
+ */
959
+ getModelAccountPreferences(organizationId: string): Promise<ModelAccountPreferences>;
960
+ /**
961
+ * Change your own personal-fallback opt-in in an organization. Only a person
962
+ * can: a same-origin browser, or an agent acting as one with full access.
963
+ */
964
+ updateModelAccountPreferences(organizationId: string, request: UpdateModelAccountPreferencesRequest): Promise<ModelAccountPreferences>;
965
+ /** Whether owners and admins may give agent sessions admin access (owners and admins). */
966
+ getOrganizationAgentAdminAccess(organizationId: string): Promise<OrganizationAgentAdminAccess>;
967
+ /**
968
+ * Allow or stop admin access for agent sessions. Turning it off ends every
969
+ * session's admin access. An owner or admin, in the app.
970
+ */
971
+ updateOrganizationAgentAdminAccess(organizationId: string, request: UpdateOrganizationAgentAdminAccessRequest): Promise<OrganizationAgentAdminAccess>;
972
+ /**
973
+ * The organization's privacy choices: who sees new chats and schedules by
974
+ * default, and whether admins see that other people's Only me schedules
975
+ * exist. `limits` reports what this deployment fixes. An owner or admin.
976
+ */
977
+ getOrganizationPrivacySettings(organizationId: string): Promise<OrganizationPrivacySettings>;
978
+ /** Change the organization's privacy choices, within the deployment's limits. */
979
+ updateOrganizationPrivacySettings(organizationId: string, request: UpdateOrganizationPrivacySettingsRequest): Promise<OrganizationPrivacySettings>;
604
980
  /** Fully replace the workspace's hard provider/model allowlist. */
605
981
  updateWorkspaceModelAccessPolicy(workspaceId: string, request: UpdateWorkspaceModelAccessPolicyRequest): Promise<WorkspaceModelAccessPolicy>;
606
982
  /** Authenticated realtime voice models and credential readiness. */
607
- getWorkspaceRealtimeModelCatalog(workspaceId: string): Promise<WorkspaceRealtimeModelCatalogResponse>;
608
- /** The caller's access context: subject, account + workspace grants, defaults. */
983
+ getWorkspaceRealtimeModelCatalog(workspaceId: string, options?: OpenGeniRequestOptions): Promise<WorkspaceRealtimeModelCatalogResponse>;
984
+ /**
985
+ * The caller's subject, grants, defaults, and optional direct API-key authority.
986
+ * `credential.effectiveWorkspacePermissions` expands workspace admin only for
987
+ * legacy keys; explicit policies retain exactly their selected grants. Full
988
+ * organization keys can provision shared workspaces, external members, and
989
+ * `asUser` sessions; user requests additionally need live membership.
990
+ * Organization-key scope excludes Personal workspaces. Neither key kind bypasses
991
+ * session visibility or the explicit `secrets:read` permission requirement. Credential
992
+ * metadata is omitted for `asUser`/external actors, humans, delegated tokens,
993
+ * other caller contexts, and older servers.
994
+ */
609
995
  getAccessContext(): Promise<AccessContext>;
610
996
  /** Active organization memberships proven by the current managed-human session. */
611
997
  listOrganizationMemberships(): Promise<ListManagedOrganizationMembershipsResponse>;
612
998
  /** Bounded owner-only personal-resource authority page for one exact resource kind. */
613
999
  listUserResourceAuthorities(workspaceId: string, options: ListUserResourceAuthoritiesOptions): Promise<ListUserResourceAuthoritiesResponse>;
614
- /** Issue an exact-session or standing personal-resource grant. */
615
- issueUserResourceGrant(workspaceId: string, authorityId: string, request: IssueUserResourceGrantRequest): Promise<UserResourceGrantMutationResponse>;
616
1000
  /** Revoke an owner grant through the exact workspace it targets. */
617
1001
  revokeUserResourceGrant(workspaceId: string, grantId: string): Promise<RevokeUserResourceGrantResponse>;
618
1002
  /** Create a new organization owned by the current managed human. */
619
1003
  createOrganization(request: CreateOrganizationRequest): Promise<CreateOrganizationResponse>;
1004
+ /** Create another organization owned by the current managed human. */
1005
+ createAdditionalOrganization(request: CreateAdditionalOrganizationRequest): Promise<CreateAdditionalOrganizationResponse>;
620
1006
  /** Pending and historical invitations addressed to the current managed human. */
621
1007
  listOrganizationInvitations(options?: {
622
1008
  cursor?: string;
@@ -635,11 +1021,17 @@ export declare class OpenGeniClient {
635
1021
  listOrganizationMembers(organizationId: string): Promise<ListOrganizationAdministrationMembersResponse>;
636
1022
  /** Canonical organization identity and every non-personal workspace access roster. */
637
1023
  getOrganizationAdministrationOverview(organizationId: string): Promise<OrganizationAdministrationOverview>;
638
- /** Create a shared workspace without implicitly granting the actor access. */
1024
+ /** Create a shared workspace and grant its creator explicit workspace-admin access. */
639
1025
  createOrganizationWorkspace(organizationId: string, request: CreateOrganizationWorkspaceRequest): Promise<OrganizationWorkspaceAccess>;
640
1026
  /** Rename one shared workspace under an exact optimistic-concurrency fence. */
641
1027
  updateOrganizationWorkspace(organizationId: string, workspaceId: string, request: UpdateOrganizationWorkspaceRequest): Promise<OrganizationWorkspaceAccess>;
642
1028
  updateOrganizationWorkspaceSettings(organizationId: string, workspaceId: string, request: UpdateWorkspaceSettingsRequest): Promise<Workspace>;
1029
+ /**
1030
+ * Delete an organization (shared) workspace. Accepts an organization owner
1031
+ * session or an organization API key with `workspace:admin` (for tenant
1032
+ * offboarding); never deletes a Personal workspace. 409 until quiescent.
1033
+ */
1034
+ deleteOrganizationWorkspace(organizationId: string, workspaceId: string): Promise<void>;
643
1035
  putOrganizationWorkspaceMember(organizationId: string, workspaceId: string, membershipId: string, request: PutOrganizationWorkspaceMemberRequest): Promise<OrganizationWorkspaceAccessMember>;
644
1036
  revokeOrganizationWorkspaceMember(organizationId: string, workspaceId: string, membershipId: string, request: RevokeOrganizationWorkspaceMemberRequest): Promise<RevokeOrganizationWorkspaceMemberResponse>;
645
1037
  /** Rename the organization under an exact optimistic-concurrency fence. */
@@ -655,30 +1047,58 @@ export declare class OpenGeniClient {
655
1047
  approveOrganizationRecoveryOperation(organizationId: string, recoveryOperationId: string, request: OrganizationRecoveryOperationCommandRequest): Promise<OrganizationRecoveryMutationResponse>;
656
1048
  cancelOrganizationRecoveryOperation(organizationId: string, recoveryOperationId: string, request: OrganizationRecoveryOperationCommandRequest): Promise<OrganizationRecoveryMutationResponse>;
657
1049
  executeOrganizationRecoveryOperation(organizationId: string, recoveryOperationId: string, request: OrganizationRecoveryOperationCommandRequest): Promise<OrganizationRecoveryMutationResponse>;
1050
+ searchPublicSkills(workspaceId: string, query: string): Promise<{
1051
+ provider: "skills_sh";
1052
+ query: string;
1053
+ items: Array<{
1054
+ id: string;
1055
+ name: string;
1056
+ source: string;
1057
+ skillId: string;
1058
+ url: string;
1059
+ installs: number;
1060
+ }>;
1061
+ nextCursor: null;
1062
+ }>;
658
1063
  listWorkspaces(): Promise<Workspace[]>;
1064
+ /** Uses this client's fixed actor and standard contract/error/abort handling.
1065
+ * Disconnect revokes Opengeni connection access, not upstream provider consent. */
1066
+ connectTransport(): import("@opengeni/connect").ConnectTransport;
1067
+ /** Browse first-party Atlassian sources without choosing or starting sync. */
1068
+ browseAtlassianSources(workspaceId: string, connectionId: string): Promise<import("@opengeni/contracts/atlassian").AtlassianBrowseResponse>;
1069
+ saveAtlassianSources(workspaceId: string, connectionId: string, request: import("@opengeni/contracts/atlassian").SaveAtlassianSourcesRequest): Promise<import("./types.js").ConnectionResponse>;
1070
+ setAtlassianLifecycle(workspaceId: string, connectionId: string, request: import("@opengeni/contracts/atlassian").AtlassianLifecycleActionRequest): Promise<import("./types.js").ConnectionResponse>;
1071
+ /** Begin durable setup. Completion requirements are provider-specific. */
1072
+ beginConnect(workspaceId: string, request: {
1073
+ providerId: string;
1074
+ ownership: "personal" | "workspace";
1075
+ returnUrl: string;
1076
+ idempotencyKey: string;
1077
+ reconnectAccountId?: string;
1078
+ installationTarget?: import("@opengeni/contracts/connect").ConnectInstallationTarget;
1079
+ }): Promise<import("@opengeni/contracts/connect").ConnectAttempt>;
1080
+ beginConnect(workspaceId: string, request: import("@opengeni/contracts/connect").BeginConnectRequest): Promise<import("@opengeni/contracts/connect").ConnectAttempt>;
659
1081
  createWorkspace(request: CreateWorkspaceRequest): Promise<Workspace>;
1082
+ /**
1083
+ * Create an organization workspace once for a stable external tenant
1084
+ * identity, or return the existing workspace without overwriting it.
1085
+ */
1086
+ ensureWorkspace(request: EnsureWorkspaceRequest): Promise<EnsureWorkspaceResponse>;
660
1087
  getWorkspace(workspaceId: string): Promise<Workspace>;
661
1088
  /** Read-time, secret-safe inventory of policy heads and visible workspace knowledge. */
662
1089
  getWorkspaceState(workspaceId: string, options?: WorkspaceStateGetOptions): Promise<WorkspaceStateResponse>;
663
1090
  /** Download the canonical, explicitly sanitized Workspace State export. */
664
1091
  exportWorkspaceState(workspaceId: string, options?: WorkspaceStateGetOptions): Promise<WorkspaceStateExportResponse>;
665
- /** Permission-filtered Company Brain package with authorized guidance bodies. */
666
- getCompanyBrain(workspaceId: string): Promise<CompanyBrainOkfPackage>;
667
- /** Download the deterministic Markdown/YAML Company Brain package. */
668
- exportCompanyBrainOkf(workspaceId: string): Promise<CompanyBrainOkfDownload>;
669
1092
  updateWorkspace(workspaceId: string, request: UpdateWorkspaceRequest): Promise<Workspace>;
670
1093
  /** Inspect immutable instruction-policy history, active heads, and activation audit evidence. */
671
1094
  listWorkspaceInstructionPolicies(workspaceId: string, options?: WorkspaceInstructionPolicyListOptions): Promise<WorkspaceInstructionPolicyListResponse>;
672
1095
  /** Inspect the bounded, permission-filtered governed-learning timeline. */
673
1096
  getWorkspaceLearningHistory(workspaceId: string, options?: WorkspaceLearningHistoryOptions): Promise<WorkspaceLearningHistoryResponse>;
674
- createWorkspaceLearningPolicyRevision(workspaceId: string, request: CreateWorkspaceLearningPolicyRevisionRequest): Promise<WorkspaceLearningPolicyRevision>;
675
- activateWorkspaceLearningPolicyRevision(workspaceId: string, revisionId: string, request: ActivateWorkspaceLearningPolicyRevisionRequest): Promise<WorkspaceLearningPolicyMutationResponse>;
676
- rollbackWorkspaceLearningPolicyRevision(workspaceId: string, request: RollbackWorkspaceLearningPolicyRevisionRequest): Promise<WorkspaceLearningPolicyMutationResponse>;
677
1097
  undoGovernedLearningActivation(workspaceId: string, activationReceiptId: string, request?: {
678
1098
  operationId?: string;
679
1099
  }): Promise<GovernedLearningActivationUndoReceipt>;
680
1100
  getWorkspaceInstructionPolicyRevision(workspaceId: string, revisionId: string): Promise<WorkspaceInstructionPolicyRevision>;
681
- createWorkspaceInstructionPolicyDraft(workspaceId: string, request: CreateWorkspaceInstructionPolicyDraftRequest): Promise<WorkspaceInstructionPolicyRevision>;
1101
+ createWorkspaceInstructionPolicyDraft(workspaceId: string, request: CreateWorkspaceInstructionPolicyDraftRequest, options?: OpenGeniRequestOptions): Promise<WorkspaceInstructionPolicyRevision>;
682
1102
  /** List the newest immutable onboarding proposals and their inactive policy drafts. */
683
1103
  listWorkspaceInstructionPolicyOnboardingProposals(workspaceId: string, options?: WorkspaceInstructionPolicyOnboardingProposalListOptions): Promise<WorkspaceInstructionPolicyOnboardingProposalListResponse>;
684
1104
  /** Create one draft-only proposal against an exact active-policy baseline. */
@@ -686,11 +1106,13 @@ export declare class OpenGeniClient {
686
1106
  /** Import the stored legacy workspace override as an inactive charter draft. */
687
1107
  importLegacyWorkspaceInstructionPolicyDraft(workspaceId: string, request?: ImportLegacyWorkspaceInstructionPolicyDraftRequest): Promise<WorkspaceInstructionPolicyRevision>;
688
1108
  diffWorkspaceInstructionPolicyRevisions(workspaceId: string, request: WorkspaceInstructionPolicyDiffRequest): Promise<WorkspaceInstructionPolicyDiffResponse>;
689
- activateWorkspaceInstructionPolicyRevision(workspaceId: string, revisionId: string, request: ActivateWorkspaceInstructionPolicyRequest): Promise<WorkspaceInstructionPolicyActivationResponse>;
1109
+ activateWorkspaceInstructionPolicyRevision(workspaceId: string, revisionId: string, request: ActivateWorkspaceInstructionPolicyRequest, options?: OpenGeniRequestOptions): Promise<WorkspaceInstructionPolicyActivationResponse>;
690
1110
  rollbackWorkspaceInstructionPolicyRevision(workspaceId: string, request: RollbackWorkspaceInstructionPolicyRequest): Promise<WorkspaceInstructionPolicyActivationResponse>;
691
1111
  /** Read the current organization profile plus immutable revision and activation history. */
692
1112
  listCompanyProfile(workspaceId: string, options?: CompanyProfileListOptions): Promise<CompanyProfileListResponse>;
693
1113
  getCompanyProfileRevision(workspaceId: string, revisionId: string): Promise<CompanyProfileRevision>;
1114
+ getCompanyProfileAgentPolicy(workspaceId: string): Promise<CompanyProfileAgentPolicy>;
1115
+ updateCompanyProfileAgentPolicy(workspaceId: string, request: UpdateCompanyProfileAgentPolicyRequest): Promise<CompanyProfileAgentPolicy>;
694
1116
  updateCompanyProfile(workspaceId: string, request: UpdateCompanyProfileRequest): Promise<CompanyProfileMutationResponse>;
695
1117
  diffCompanyProfileRevisions(workspaceId: string, request: CompanyProfileDiffRequest): Promise<CompanyProfileDiffResponse>;
696
1118
  activateCompanyProfileRevision(workspaceId: string, revisionId: string, request: ActivateCompanyProfileRevisionRequest): Promise<CompanyProfileMutationResponse>;
@@ -713,9 +1135,10 @@ export declare class OpenGeniClient {
713
1135
  deleteWorkspace(workspaceId: string): Promise<void>;
714
1136
  /** The workspace's members (user + api_key subjects). */
715
1137
  listWorkspaceMembers(workspaceId: string): Promise<WorkspaceMember[]>;
1138
+ /** Active organization members who can be added to this workspace. */
1139
+ listWorkspaceMemberCandidates(workspaceId: string): Promise<WorkspaceMemberCandidate[]>;
716
1140
  /**
717
- * Add an already-registered user by email. 404s when no user with that email
718
- * exists (email invites for unknown users are deferred).
1141
+ * Add one active member selected from the workspace candidate inventory.
719
1142
  */
720
1143
  addWorkspaceMember(workspaceId: string, request: AddWorkspaceMemberRequest): Promise<WorkspaceMember>;
721
1144
  updateWorkspaceMember(workspaceId: string, subjectId: string, request: UpdateWorkspaceMemberRequest): Promise<WorkspaceMember>;
@@ -735,6 +1158,12 @@ export declare class OpenGeniClient {
735
1158
  createScheduledTask(workspaceId: string, request: CreateScheduledTaskRequest): Promise<ScheduledTask>;
736
1159
  updateScheduledTask(workspaceId: string, taskId: string, request: UpdateScheduledTaskRequest): Promise<ScheduledTask>;
737
1160
  pauseScheduledTask(workspaceId: string, taskId: string): Promise<ScheduledTask>;
1161
+ /** Admins: other people's Only me schedules, as summaries without names or prompts. */
1162
+ listPrivateScheduledTaskSummaries(workspaceId: string): Promise<{
1163
+ schedules: PrivateScheduledTaskSummary[];
1164
+ }>;
1165
+ /** Admins: pause someone else's Only me schedule. Only its owner can resume it. */
1166
+ pausePrivateScheduledTask(workspaceId: string, taskId: string): Promise<PrivateScheduledTaskSummary>;
738
1167
  resumeScheduledTask(workspaceId: string, taskId: string): Promise<ScheduledTask>;
739
1168
  /**
740
1169
  * Fire the task immediately (manual trigger), independent of its schedule.
@@ -748,17 +1177,16 @@ export declare class OpenGeniClient {
748
1177
  listScheduledTaskRuns(workspaceId: string, taskId: string, options?: {
749
1178
  limit?: number;
750
1179
  }): Promise<ScheduledTaskRun[]>;
751
- listVariableSets(workspaceId: string): Promise<VariableSet[]>;
752
- /** Resolve only caller-supplied attachment ids without enumerating the catalog. */
753
- resolveVariableSetAttachments(workspaceId: string, request: ResolveVariableSetAttachmentsRequest): Promise<ResolveVariableSetAttachmentsResponse>;
754
- createVariableSet(workspaceId: string, request: CreateVariableSetRequest): Promise<VariableSet>;
755
- getVariableSet(workspaceId: string, variableSetId: string): Promise<VariableSet>;
756
- getVariableSetVariable(workspaceId: string, variableSetId: string, name: string): Promise<VariableSetSecret>;
757
- updateVariableSet(workspaceId: string, variableSetId: string, request: UpdateVariableSetRequest): Promise<VariableSet>;
758
- deleteVariableSet(workspaceId: string, variableSetId: string): Promise<void>;
759
- /** Create or rotate a variable. Generic reads never return its value. */
760
- setVariableSetVariable(workspaceId: string, variableSetId: string, name: string, value: string): Promise<VariableSetVariableMetadata>;
761
- deleteVariableSetVariable(workspaceId: string, variableSetId: string, name: string): Promise<void>;
1180
+ /**
1181
+ * Re-freeze a task's connectors, connector accounts and Opengeni tool policy
1182
+ * with the signed-in caller's current authority. Pass the `executionDigest`
1183
+ * of the task whose `policyDrift` was reviewed; a changed task returns 409.
1184
+ */
1185
+ refreshScheduledTaskAccess(workspaceId: string, taskId: string, request: RefreshScheduledTaskAccessRequest): Promise<ScheduledTask>;
1186
+ /** Schedules the caller can act on whose latest run could not use a connector. */
1187
+ listScheduledTaskAccessAttention(workspaceId: string): Promise<ScheduledTaskAccessAttention[]>;
1188
+ /** Vault, item, field-history, session-policy and 1Password routes for one workspace. */
1189
+ vaults(workspaceId: string): VaultsApi;
762
1190
  listChannels(workspaceId: string): Promise<Channel[]>;
763
1191
  createChannel(workspaceId: string, request: CreateChannelRequest): Promise<Channel>;
764
1192
  updateChannel(workspaceId: string, channelId: string, request: UpdateChannelRequest): Promise<Channel>;
@@ -799,20 +1227,6 @@ export declare class OpenGeniClient {
799
1227
  ok: boolean;
800
1228
  versionId: string;
801
1229
  }>;
802
- /** @deprecated use listVariableSets */
803
- listEnvironments(workspaceId: string): Promise<VariableSet[]>;
804
- /** @deprecated use createVariableSet */
805
- createEnvironment(workspaceId: string, request: CreateVariableSetRequest): Promise<VariableSet>;
806
- /** @deprecated use getVariableSet */
807
- getEnvironment(workspaceId: string, environmentId: string): Promise<VariableSet>;
808
- /** @deprecated use updateVariableSet */
809
- updateEnvironment(workspaceId: string, environmentId: string, request: UpdateVariableSetRequest): Promise<VariableSet>;
810
- /** @deprecated use deleteVariableSet */
811
- deleteEnvironment(workspaceId: string, environmentId: string): Promise<void>;
812
- /** @deprecated use setVariableSetVariable */
813
- setEnvironmentVariable(workspaceId: string, environmentId: string, name: string, value: string): Promise<VariableSetVariableMetadata>;
814
- /** @deprecated use deleteVariableSetVariable */
815
- deleteEnvironmentVariable(workspaceId: string, environmentId: string, name: string): Promise<void>;
816
1230
  /** Step 1 of the upload flow: returns the pre-signed PUT target. */
817
1231
  beginFileUpload(workspaceId: string, request: CreateFileUploadRequest, options?: OpenGeniRequestOptions): Promise<CreateFileUploadResponse>;
818
1232
  /** Step 3 of the upload flow: server verifies the object and marks it ready. */
@@ -823,7 +1237,10 @@ export declare class OpenGeniClient {
823
1237
  * -> complete. Returns the ready `FileAsset`.
824
1238
  */
825
1239
  uploadFile(workspaceId: string, input: UploadFileInput): Promise<FileAsset>;
826
- getFile(workspaceId: string, fileId: string, options?: OpenGeniRequestOptions): Promise<FileAsset>;
1240
+ listFiles(workspaceId: string, options?: import("./types.js").FileListRequest): Promise<import("./types.js").FileListResponse>;
1241
+ getFile(workspaceId: string, fileId: string, options?: OpenGeniRequestOptions & {
1242
+ sessionId?: string | undefined;
1243
+ }): Promise<FileAsset>;
827
1244
  /** Read provider-neutral retained evidence metadata; never returns a storage location. */
828
1245
  getRetainedArtifact(workspaceId: string, artifactId: string): Promise<RetainedArtifactMetadata>;
829
1246
  /**
@@ -842,7 +1259,9 @@ export declare class OpenGeniClient {
842
1259
  private downloadRetainedArtifactBytes;
843
1260
  private getRetainedArtifactContentAtPath;
844
1261
  /** Mint a short-lived signed download URL for a ready file. */
845
- createFileDownloadUrl(workspaceId: string, fileId: string, options?: OpenGeniRequestOptions): Promise<FileDownloadUrlResponse>;
1262
+ createFileDownloadUrl(workspaceId: string, fileId: string, options?: OpenGeniRequestOptions & {
1263
+ sessionId?: string | undefined;
1264
+ }): Promise<FileDownloadUrlResponse>;
846
1265
  /** Read the effective workspace policy and executable Seedance capabilities. */
847
1266
  getVideoGenerationSettings(workspaceId: string, options?: OpenGeniRequestOptions): Promise<WorkspaceVideoGenerationSettings>;
848
1267
  /** Replace the enabled video models/default under optimistic policy revision control. */
@@ -852,21 +1271,12 @@ export declare class OpenGeniClient {
852
1271
  /** Mint a short-lived zero-copy URL for native Range-based video playback. */
853
1272
  createVideoArtifactPlaybackSource(workspaceId: string, artifactId: string, options?: OpenGeniRequestOptions): Promise<VideoArtifactPlaybackSource>;
854
1273
  createDocumentBase(workspaceId: string, request: CreateDocumentBaseRequest): Promise<DocumentBase>;
855
- listDocumentBases(workspaceId: string): Promise<DocumentBase[]>;
856
1274
  getDocumentBase(workspaceId: string, baseId: string): Promise<DocumentBase>;
857
1275
  /** Index an uploaded file into the base. The file must be `ready`. */
858
1276
  addDocument(workspaceId: string, baseId: string, request: AddDocumentRequest): Promise<Document>;
859
1277
  listDocuments(workspaceId: string, baseId: string): Promise<Document[]>;
860
- /**
861
- * List every Document the current human can manage from this workspace,
862
- * including portable personal and organization-scoped Documents whose
863
- * immutable ingestion workspace is different.
864
- */
865
- listAccessibleDocuments(workspaceId: string): Promise<Document[]>;
866
1278
  /** Read the immutable source file through the Document's effective authority. */
867
1279
  getDocumentOriginalFile(workspaceId: string, documentId: string): Promise<FileAsset>;
868
- /** Mint a source-file URL through the Document's effective authority. */
869
- createDocumentOriginalFileDownloadUrl(workspaceId: string, documentId: string): Promise<FileDownloadUrlResponse>;
870
1280
  /**
871
1281
  * Drop raw text or an already-uploaded file into the workspace's Default
872
1282
  * base. When curation is enabled, it may name, summarize, categorize, and
@@ -879,51 +1289,330 @@ export declare class OpenGeniClient {
879
1289
  * targetBaseId, applies the document's stored curation suggestion.
880
1290
  */
881
1291
  moveDocument(workspaceId: string, documentId: string, request?: MoveDocumentRequest): Promise<Document>;
882
- /** Retry indexing for a failed document. */
883
- reindexDocument(workspaceId: string, baseId: string, documentId: string): Promise<Document>;
884
1292
  /**
885
1293
  * Delete a document from a base. Removes the document row and its indexed
886
1294
  * chunks while leaving the uploaded file asset available for other uses.
887
1295
  */
888
1296
  deleteDocument(workspaceId: string, baseId: string, documentId: string): Promise<void>;
889
- searchDocuments(workspaceId: string, baseId: string, request: Omit<DocumentSearchRequest, "baseIds">): Promise<DocumentSearchResponse>;
890
- searchKnowledge(workspaceId: string, request: DocumentSearchRequest): Promise<DocumentSearchResponse>;
891
- listKnowledgeMemories(workspaceId: string, request?: KnowledgeMemorySearchRequest): Promise<KnowledgeMemory[]>;
892
- getKnowledgeMemory(workspaceId: string, memoryId: string): Promise<KnowledgeMemory>;
893
- createKnowledgeMemory(workspaceId: string, request: CreateKnowledgeMemoryRequest): Promise<KnowledgeMemory>;
894
- updateKnowledgeMemory(workspaceId: string, memoryId: string, request: UpdateKnowledgeMemoryRequest): Promise<KnowledgeMemory>;
895
- /** Hybrid (semantic + keyword) search over the workspace's agent-visible memory. */
896
- searchWorkspaceMemories(workspaceId: string, request: WorkspaceMemorySearchRequest): Promise<WorkspaceMemorySearchResponse>;
1297
+ /** Unified retained sources, findings and groups. Only published entries are returned by default. */
1298
+ listKnowledgeEntries(workspaceId: string, request?: KnowledgeEntryListRequest): Promise<KnowledgeEntryListResponse>;
1299
+ getKnowledgeEntry(workspaceId: string, entryId: string, options?: {
1300
+ revisionId?: string;
1301
+ view?: "published" | "needs_review" | "archived" | "rejected";
1302
+ }): Promise<KnowledgeEntryRecord>;
1303
+ /** Open the original file associated with an accessible retained source revision. */
1304
+ createKnowledgeFileDownloadUrl(workspaceId: string, entryId: string, revisionId?: string): Promise<KnowledgeOriginalFileDownload>;
1305
+ saveKnowledgeEntry(workspaceId: string, request: KnowledgeEntrySaveRequest): Promise<KnowledgeEntryWriteReceipt>;
1306
+ reviewKnowledgeEntry(workspaceId: string, request: KnowledgeEntryReviewRequest): Promise<KnowledgeEntryWriteReceipt>;
1307
+ listKnowledgeReviewBatches(workspaceId: string, options?: KnowledgeReviewBatchListRequest): Promise<KnowledgeReviewBatchListResponse>;
1308
+ /** Atomically review up to 100 selected entries, including their pending dependencies. */
1309
+ reviewKnowledgeEntries(workspaceId: string, request: KnowledgeEntryBatchReviewRequest): Promise<{
1310
+ receipts: KnowledgeEntryWriteReceipt[];
1311
+ }>;
1312
+ listKnowledgeEntryHistory(workspaceId: string, entryId: string, beforeRevision?: number): Promise<{
1313
+ entries: KnowledgeEntryListResponse["entries"];
1314
+ beforeRevision: number | null;
1315
+ }>;
1316
+ restoreKnowledgeEntry(workspaceId: string, request: KnowledgeEntryRestoreRequest): Promise<KnowledgeEntryWriteReceipt>;
1317
+ archiveKnowledgeEntry(workspaceId: string, entryId: string, request: {
1318
+ operationId: string;
1319
+ expectedVersion: number;
1320
+ }): Promise<KnowledgeEntryWriteReceipt>;
1321
+ getAgentLearningSettings(workspaceId: string, scope: "workspace" | "personal" | "context", source?: AgentLearningContext): Promise<AgentLearningSettingsRecord>;
1322
+ saveAgentLearningSettings(workspaceId: string, request: SaveAgentLearningSettingsRequest): Promise<AgentLearningSettingsRecord>;
1323
+ listAgentLearningOverrides(workspaceId: string, scope: "workspace" | "personal"): Promise<AgentLearningOverrideRecord[]>;
1324
+ reviewAgentInstruction(workspaceId: string, request: AgentInstructionReviewRequest): Promise<AgentInstructionReceipt>;
1325
+ listAgentInstructionReviews(workspaceId: string, cursor?: string): Promise<AgentInstructionReviewListResponse>;
897
1326
  /** Deep-merge a settings patch into the workspace (preserves unknown keys). */
898
1327
  updateWorkspaceSettings(workspaceId: string, request: UpdateWorkspaceSettingsRequest): Promise<Workspace>;
899
1328
  setWorkspaceDefaultRig(workspaceId: string, request: SetWorkspaceDefaultRigRequest): Promise<Workspace>;
900
- /** Built-in + registered packs, with the workspace's installations. */
901
- listPacks(workspaceId: string): Promise<ListPacksResponse>;
902
- /** Register (or replace) a workspace-scoped pack from a manifest. */
903
- registerPack(workspaceId: string, manifest: RegisterCapabilityPackRequest): Promise<WorkspaceRegisteredPack>;
904
- getPack(workspaceId: string, packId: string): Promise<GetPackResponse>;
905
- enablePack(workspaceId: string, packId: string, request?: EnablePackRequest): Promise<PackInstallation>;
906
1329
  /** Resolve pinned components, Variable Set, and Rig requirements before installation. */
907
- previewPackInstallation(workspaceId: string, packId: string, request?: PreviewPackInstallationRequest): Promise<PackInstallationPreview>;
908
- /** Install, update, or repair a Pack from an exact previewed manifest. */
909
- installPack(workspaceId: string, packId: string, request: InstallPackRequest): Promise<PackInstallation>;
910
- /** Preview which Pack-owned components will be retained by other owners. */
911
- previewPackUninstall(workspaceId: string, packId: string): Promise<PackUninstallPreview>;
912
- /** Safely release Pack ownership and disable only now-ownerless components. */
913
- uninstallPack(workspaceId: string, packId: string, request: UninstallPackRequest): Promise<UninstallPackResult>;
914
- /** Unregister a workspace-scoped pack (built-in packs cannot be deleted). */
915
- deletePack(workspaceId: string, packId: string): Promise<void>;
916
- listPackInstallations(workspaceId: string): Promise<PackInstallation[]>;
917
1330
  listCapabilities(workspaceId: string): Promise<CapabilityCatalogResponse>;
918
1331
  /** Add a manual capability catalog item (e.g. a remote MCP server). */
919
1332
  createCapability(workspaceId: string, request: CreateCapabilityCatalogItemRequest): Promise<CapabilityCatalogItem>;
1333
+ getConnectorToolPermissions(workspaceId: string, capabilityId: string, options?: {
1334
+ signal?: AbortSignal;
1335
+ }): Promise<ConnectorToolPermissionsResponse>;
1336
+ getConnectorToolPermissions(workspaceId: string, capabilityId: string, options?: {
1337
+ signal?: AbortSignal;
1338
+ connectionId?: string;
1339
+ instanceKey?: string;
1340
+ }): Promise<ConnectorToolPermissionsResponse>;
1341
+ updateConnectorToolPermissions(workspaceId: string, capabilityId: string, request: UpdateConnectorToolPermissionsRequest, options?: {
1342
+ signal?: AbortSignal;
1343
+ }): Promise<{
1344
+ saved: boolean;
1345
+ }>;
1346
+ /**
1347
+ * Read the workspace's saved Allow/Ask/Block rules for a session MCP server
1348
+ * this host attaches (same `id` and exact `url` as in `mcpServers`).
1349
+ */
1350
+ getSessionMcpToolPermissions(workspaceId: string, server: {
1351
+ serverId: string;
1352
+ url: string;
1353
+ }, options?: {
1354
+ signal?: AbortSignal;
1355
+ }): Promise<SessionMcpToolPermissionsResponse>;
1356
+ /**
1357
+ * Set or reset Allow/Ask/Block for a session MCP server's default or named
1358
+ * tools. Requires `capabilities:manage`; agents and service principals are
1359
+ * refused. Rules apply from each session's next attempt.
1360
+ */
1361
+ updateSessionMcpToolPermissions(workspaceId: string, request: UpdateSessionMcpToolPermissionsRequest, options?: {
1362
+ signal?: AbortSignal;
1363
+ }): Promise<{
1364
+ saved: boolean;
1365
+ }>;
920
1366
  enableCapability(workspaceId: string, capabilityId: string, request?: EnableCapabilityRequest): Promise<CapabilityInstallation>;
921
1367
  disableCapability(workspaceId: string, capabilityId: string): Promise<CapabilityInstallation>;
1368
+ /** Read-only, permission-filtered workspace or session output discovery. */
1369
+ listArtifactCatalog(workspaceId: string, options?: ArtifactCatalogListOptions & {
1370
+ signal?: AbortSignal;
1371
+ }): Promise<ArtifactCatalogListResponse>;
1372
+ /** Idempotently set a workspace-shared pin; refresh the catalog after completion. */
1373
+ updateArtifactPin(workspaceId: string, kind: ArtifactCatalogKind, artifactId: string, pinned: boolean, options?: {
1374
+ signal?: AbortSignal;
1375
+ }): Promise<ArtifactPinResponse>;
1376
+ listWorkspaceArtifacts(workspaceId: string, options?: WorkspaceArtifactListOptions & {
1377
+ signal?: AbortSignal;
1378
+ }): Promise<WorkspaceArtifactListResponse>;
1379
+ getWorkspaceArtifact(workspaceId: string, artifactId: string, options?: {
1380
+ signal?: AbortSignal;
1381
+ }): Promise<WorkspaceArtifactDetailResponse>;
1382
+ /** Display-only HTML delivery: do not download the retained source bundle to render a Site. */
1383
+ getWorkspaceArtifactHtml(workspaceId: string, artifactId: string, options: {
1384
+ versionId: string;
1385
+ signal?: AbortSignal;
1386
+ }): Promise<string>;
1387
+ rollbackWorkspaceArtifact(workspaceId: string, artifactId: string, request: RollbackWorkspaceArtifactRequest, options?: {
1388
+ signal?: AbortSignal;
1389
+ }): Promise<WorkspaceArtifactMutationResponse>;
1390
+ setWorkspaceArtifactStatus(workspaceId: string, artifactId: string, request: SetWorkspaceArtifactStatusRequest, options?: {
1391
+ signal?: AbortSignal;
1392
+ }): Promise<WorkspaceArtifactMutationResponse>;
1393
+ /** Change who can see a Site: the whole workspace, or only you. Only its owner can. */
1394
+ updateWorkspaceArtifactVisibility(workspaceId: string, artifactId: string, request: UpdateWorkspaceArtifactVisibilityRequest, options?: {
1395
+ signal?: AbortSignal;
1396
+ }): Promise<UpdateWorkspaceArtifactVisibilityResponse>;
1397
+ /** A Site's data collections, usage and limits. Needs a manager of the Site. */
1398
+ getSiteData(workspaceId: string, siteId: string, options?: {
1399
+ signal?: AbortSignal;
1400
+ }): Promise<SiteDataDescribeResponse>;
1401
+ /** Create or change a Site Data collection. Needs a manager of the Site. */
1402
+ defineSiteDataCollection(workspaceId: string, siteId: string, name: string, request: SiteDataCollectionDefinitionRequest, options?: {
1403
+ signal?: AbortSignal;
1404
+ }): Promise<SiteDataCollectionResponse>;
1405
+ /** Delete a collection and all of its records. */
1406
+ deleteSiteDataCollection(workspaceId: string, siteId: string, name: string, options?: {
1407
+ signal?: AbortSignal;
1408
+ }): Promise<{
1409
+ deletedRecords: number;
1410
+ }>;
1411
+ /** Remove every record from a collection and keep its definition. */
1412
+ resetSiteDataCollection(workspaceId: string, siteId: string, name: string, options?: {
1413
+ signal?: AbortSignal;
1414
+ }): Promise<{
1415
+ deletedRecords: number;
1416
+ }>;
1417
+ /** Query records with the caller's access to the collection. */
1418
+ querySiteData(workspaceId: string, siteId: string, request: SiteDataQueryRequest, options?: {
1419
+ signal?: AbortSignal;
1420
+ }): Promise<SiteDataQueryResponse>;
1421
+ /** Apply up to 100 record operations together or not at all. */
1422
+ writeSiteData(workspaceId: string, siteId: string, request: SiteDataWriteRequest, options?: {
1423
+ signal?: AbortSignal;
1424
+ }): Promise<SiteDataWriteResponse>;
1425
+ /** Import JSON or CSV records into a collection. */
1426
+ importSiteData(workspaceId: string, siteId: string, name: string, request: SiteDataImportRequest, options?: {
1427
+ signal?: AbortSignal;
1428
+ }): Promise<SiteDataImportResponse>;
1429
+ /** Export a collection as JSON or CSV text (bounded; check `truncated`). */
1430
+ exportSiteData(workspaceId: string, siteId: string, name: string, options?: {
1431
+ format?: "json" | "csv";
1432
+ signal?: AbortSignal;
1433
+ }): Promise<{
1434
+ content: string;
1435
+ contentType: string;
1436
+ truncated: boolean;
1437
+ }>;
1438
+ /** Files stored with a Site that the caller may see. */
1439
+ listSiteDataFiles(workspaceId: string, siteId: string, options?: {
1440
+ limit?: number;
1441
+ cursor?: string;
1442
+ signal?: AbortSignal;
1443
+ }): Promise<SiteDataFileListResponse>;
1444
+ /** A short-lived download URL for one Site file. */
1445
+ getSiteDataFileUrl(workspaceId: string, siteId: string, fileId: string, options?: {
1446
+ signal?: AbortSignal;
1447
+ }): Promise<SiteDataFileUrlResponse>;
1448
+ deleteSiteDataFile(workspaceId: string, siteId: string, fileId: string, options?: {
1449
+ signal?: AbortSignal;
1450
+ }): Promise<{
1451
+ deleted: {
1452
+ id: string;
1453
+ };
1454
+ }>;
1455
+ /**
1456
+ * A Site's SQL database (optional Cloudflare storage): availability, whether
1457
+ * it is on, migrations, named queries, usage and limits. Needs a manager.
1458
+ */
1459
+ getSiteSql(workspaceId: string, siteId: string, options?: {
1460
+ signal?: AbortSignal;
1461
+ }): Promise<SiteSqlDescribeResponse>;
1462
+ /** Turn a Site's SQL database on or off; turning it off keeps its data. */
1463
+ updateSiteSqlSettings(workspaceId: string, siteId: string, request: SiteSqlSettingsRequest, options?: {
1464
+ signal?: AbortSignal;
1465
+ }): Promise<SiteSqlDescribeResponse>;
1466
+ /** Add a named schema migration to a Site's SQL database. */
1467
+ migrateSiteSql(workspaceId: string, siteId: string, request: SiteSqlMigrationRequest, options?: {
1468
+ signal?: AbortSignal;
1469
+ }): Promise<SiteSqlMigrateResponse>;
1470
+ /** Create or replace a named query Site pages run with site.sql.run. */
1471
+ defineSiteSqlQuery(workspaceId: string, siteId: string, name: string, request: SiteSqlQueryDefinitionRequest, options?: {
1472
+ signal?: AbortSignal;
1473
+ }): Promise<SiteSqlQueryResponse>;
1474
+ deleteSiteSqlQuery(workspaceId: string, siteId: string, name: string, options?: {
1475
+ signal?: AbortSignal;
1476
+ }): Promise<{
1477
+ deleted: boolean;
1478
+ }>;
1479
+ /** Run a named query with the caller's access (its audience decides who may). */
1480
+ runSiteSqlQuery(workspaceId: string, siteId: string, name: string, request?: SiteSqlRunRequest, options?: {
1481
+ signal?: AbortSignal;
1482
+ }): Promise<SiteSqlRunResponse>;
1483
+ /** Run one read-only statement on a Site's SQL database. Needs a manager. */
1484
+ querySiteSql(workspaceId: string, siteId: string, request: SiteSqlStatementRequest, options?: {
1485
+ signal?: AbortSignal;
1486
+ }): Promise<SiteSqlRunResponse>;
1487
+ /** Run one data-changing statement on a Site's SQL database. Needs a manager. */
1488
+ executeSiteSql(workspaceId: string, siteId: string, request: SiteSqlStatementRequest, options?: {
1489
+ signal?: AbortSignal;
1490
+ }): Promise<SiteSqlRunResponse>;
1491
+ /** Tables, columns, row counts and applied migrations of a Site's SQL database. */
1492
+ inspectSiteSql(workspaceId: string, siteId: string, options?: {
1493
+ signal?: AbortSignal;
1494
+ }): Promise<SiteSqlInspectResponse>;
1495
+ /**
1496
+ * Export a Site's SQL database as SQL, CSV (one table) or JSON. One call
1497
+ * returns at most `maxBytes` (16 MiB at most); when `nextCursor` is set,
1498
+ * call again with it as `cursor` and append the pieces in order.
1499
+ */
1500
+ exportSiteSql(workspaceId: string, siteId: string, options?: {
1501
+ format?: SiteSqlExportFormat;
1502
+ table?: string;
1503
+ cursor?: string;
1504
+ maxBytes?: number;
1505
+ signal?: AbortSignal;
1506
+ }): Promise<{
1507
+ content: string;
1508
+ contentType: string;
1509
+ truncated: boolean;
1510
+ nextCursor: string | null;
1511
+ }>;
1512
+ /** Import SQL statements, CSV or JSON rows into a Site's SQL database. */
1513
+ importSiteSql(workspaceId: string, siteId: string, request: SiteSqlImportRequest, options?: {
1514
+ signal?: AbortSignal;
1515
+ }): Promise<SiteSqlImportResponse>;
1516
+ /** Empty a Site's SQL database, keeping (rebuilding) or dropping its schema. */
1517
+ resetSiteSql(workspaceId: string, siteId: string, request?: {
1518
+ schema?: "keep" | "drop";
1519
+ }, options?: {
1520
+ signal?: AbortSignal;
1521
+ }): Promise<SiteSqlResetResponse>;
1522
+ /**
1523
+ * A Site's web publication: hostname, access, embedded agent, limits,
1524
+ * status and moderation. 404 when the Site was never published; 503
1525
+ * `sites_publishing_disabled` when the deployment has no Sites domain.
1526
+ */
1527
+ getSitePublication(workspaceId: string, siteId: string, options?: {
1528
+ signal?: AbortSignal;
1529
+ }): Promise<SitePublication>;
1530
+ /**
1531
+ * Publish a Site on its own hostname or change its publication. Omitted
1532
+ * fields keep their current values. 409 `site_hostname_taken` when the
1533
+ * label belongs to another Site; 403 when the Site is Only me or the
1534
+ * caller cannot manage it.
1535
+ */
1536
+ updateSitePublication(workspaceId: string, siteId: string, request: UpsertSitePublicationRequest, options?: {
1537
+ signal?: AbortSignal;
1538
+ }): Promise<SitePublication>;
1539
+ /** Stop serving a published Site. Its hostname stays held for the workspace. */
1540
+ unpublishSite(workspaceId: string, siteId: string, options?: {
1541
+ signal?: AbortSignal;
1542
+ }): Promise<SitePublication>;
1543
+ /**
1544
+ * Apply a readiness warning's one-click fix (`publication.warnings[].fix`):
1545
+ * a Site Data collection's guest access or a Site SQL query's audience.
1546
+ * Answers the publication with fresh warnings. 404
1547
+ * `site_fix_target_missing` when the collection or query no longer exists.
1548
+ */
1549
+ applySitePublicationFix(workspaceId: string, siteId: string, fix: SitePublishWarningFix, options?: {
1550
+ signal?: AbortSignal;
1551
+ }): Promise<SitePublication>;
1552
+ /**
1553
+ * This month's Site platform usage of the workspace (gateway requests,
1554
+ * Site SQL rows read and written, Site SQL and Site Data storage) against
1555
+ * its monthly allowance, with the billing mode and the Opengeni-wide
1556
+ * brake state.
1557
+ */
1558
+ getSitePlatformUsage(workspaceId: string, options?: {
1559
+ signal?: AbortSignal;
1560
+ }): Promise<SitePlatformUsage>;
1561
+ /** Whether a hostname label is valid and free for a Site in this workspace. */
1562
+ checkSiteHostname(workspaceId: string, label: string, options?: {
1563
+ signal?: AbortSignal;
1564
+ }): Promise<SiteHostnameAvailability>;
1565
+ /** Take a published Site down at once; visitors see a takedown notice. */
1566
+ takeDownSite(workspaceId: string, siteId: string, request: SiteTakedownRequest, options?: {
1567
+ signal?: AbortSignal;
1568
+ }): Promise<SitePublication>;
1569
+ /** Serve a Site that was taken down again. */
1570
+ restoreSite(workspaceId: string, siteId: string, options?: {
1571
+ signal?: AbortSignal;
1572
+ }): Promise<SitePublication>;
1573
+ /** Abuse reports visitors filed against a published Site. */
1574
+ listSiteAbuseReports(workspaceId: string, siteId: string, options?: {
1575
+ signal?: AbortSignal;
1576
+ }): Promise<{
1577
+ reports: SiteAbuseReport[];
1578
+ }>;
1579
+ /** Close an abuse report as dismissed or actioned. */
1580
+ updateSiteAbuseReport(workspaceId: string, siteId: string, reportId: string, request: {
1581
+ status: "dismissed" | "actioned";
1582
+ }, options?: {
1583
+ signal?: AbortSignal;
1584
+ }): Promise<SiteAbuseReport>;
1585
+ /** The workspace's default limit profile for published Sites. */
1586
+ getSiteLimitProfile(workspaceId: string, options?: {
1587
+ signal?: AbortSignal;
1588
+ }): Promise<SiteLimitProfile>;
1589
+ /** Change the workspace's default limit profile for published Sites. Needs a workspace admin. */
1590
+ updateSiteLimitProfile(workspaceId: string, profile: SiteLimitProfile, options?: {
1591
+ signal?: AbortSignal;
1592
+ }): Promise<SiteLimitProfile>;
1593
+ /**
1594
+ * Let the signed-in person open a published Site: returns a one-time code,
1595
+ * bound to the Site host, PKCE challenge and redirect, inside `redirectTo`.
1596
+ * 403 `site_access_denied` when they may not open the Site.
1597
+ */
1598
+ authorizeSiteViewer(request: SiteAuthAuthorizeRequest, options?: {
1599
+ signal?: AbortSignal;
1600
+ }): Promise<SiteAuthAuthorizeResponse>;
922
1601
  /** Search the official MCP registry for installable capabilities. */
923
1602
  discoverMcpCapabilities(workspaceId: string, options?: {
924
1603
  query?: string;
925
1604
  limit?: number;
926
1605
  }): Promise<DiscoverMcpCapabilitiesResponse>;
1606
+ discoverPlugins(workspaceId: string, options?: {
1607
+ id?: string;
1608
+ query?: string;
1609
+ provider?: string;
1610
+ offset?: number;
1611
+ }): Promise<import("@opengeni/contracts").PluginDiscoveryPage>;
1612
+ inspectMcpAuthentication(workspaceId: string, url: string): Promise<{
1613
+ kind: "oauth2" | "none" | "unknown";
1614
+ message?: string;
1615
+ }>;
927
1616
  /** List installed protocol-neutral OpenAPI and GraphQL Integrations. */
928
1617
  listApiIntegrations(workspaceId: string): Promise<ListApiIntegrationsResponse>;
929
1618
  /** List curated provider definitions without exposing deployment OAuth credentials. */
@@ -953,6 +1642,7 @@ export declare class OpenGeniClient {
953
1642
  removeIntegrationFacet(workspaceId: string, capabilityId: string, instanceKey: string, facetKey: string, request: MutateIntegrationFacetRequest): Promise<IntegrationFacetRemovalResult>;
954
1643
  private mutateIntegrationFacetLifecycle;
955
1644
  previewPlugin(workspaceId: string, request: PreviewPluginRequest): Promise<PluginPreview>;
1645
+ getInstalledPluginDetails(workspaceId: string, pluginKey: string): Promise<import("@opengeni/contracts").PluginDiscoveryItem>;
956
1646
  listInstalledPlugins(workspaceId: string): Promise<ListInstalledPluginsResponse>;
957
1647
  installPlugin(workspaceId: string, request: InstallPluginRequest): Promise<InstalledPlugin>;
958
1648
  previewPluginUninstall(workspaceId: string, pluginKey: string): Promise<PluginUninstallPreview>;
@@ -963,11 +1653,32 @@ export declare class OpenGeniClient {
963
1653
  installSkill(workspaceId: string, request: InstallSkillRequest): Promise<InstalledSkill>;
964
1654
  /** List Skills from the authoritative Plugin/Skill-Facet installation ledger. */
965
1655
  listInstalledSkills(workspaceId: string): Promise<ListInstalledSkillsResponse>;
1656
+ /** Shared authored/installed catalog metadata. File bodies are read on demand. */
1657
+ listWorkspaceSkills(workspaceId: string, options?: {
1658
+ cursor?: string;
1659
+ limit?: number;
1660
+ sessionId?: string;
1661
+ }): Promise<{
1662
+ skills: SkillSummary[];
1663
+ nextCursor: string | null;
1664
+ }>;
1665
+ readWorkspaceSkill(workspaceId: string, skillId: string, revisionId?: string): Promise<SkillRecord>;
1666
+ saveWorkspaceSkill(workspaceId: string, request: SaveWorkspaceSkillRequest): Promise<SkillWriteReceipt>;
1667
+ /** Permanently remove a personal/workspace Skill and all its saved revisions. */
1668
+ removeWorkspaceSkill(workspaceId: string, skillId: string, request: RemoveWorkspaceSkillRequest): Promise<SkillWriteReceipt>;
1669
+ approveWorkspaceSkill(workspaceId: string, skillId: string, request: ApplyWorkspaceSkillRevisionRequest): Promise<SkillWriteReceipt>;
1670
+ restoreWorkspaceSkill(workspaceId: string, skillId: string, request: ApplyWorkspaceSkillRevisionRequest): Promise<SkillWriteReceipt>;
1671
+ rejectWorkspaceSkill(workspaceId: string, skillId: string, request: ApplyWorkspaceSkillRevisionRequest): Promise<SkillWriteReceipt>;
966
1672
  /** Install one exact reviewed curated-library Skill through the Skill domain. */
967
1673
  installLibrarySkill(workspaceId: string, libraryId: string, request: InstallLibrarySkillRequest): Promise<InstalledSkill>;
968
1674
  previewSkillUninstall(workspaceId: string, capabilityId: string): Promise<SkillUninstallPreview>;
969
1675
  /** Remove the direct owner under an optimistic installation-version fence. */
970
1676
  uninstallSkill(workspaceId: string, capabilityId: string, request: UninstallSkillRequest): Promise<UninstallSkillResult>;
1677
+ /** This authenticated user's accounts across the organization, plus current-workspace shared accounts.
1678
+ * Inactive accounts are opt-in for settings display; execution pickers keep the active default. */
1679
+ listOwnConnectionAccounts(workspaceId: string, options?: {
1680
+ includeInactive?: boolean;
1681
+ }): Promise<ConnectionMetadata[]>;
971
1682
  listConnections(workspaceId: string): Promise<ConnectionMetadata[]>;
972
1683
  /** Secret-free status for the caller's exact personal GitHub connection. */
973
1684
  personalGitHubStatus(workspaceId: string): Promise<PersonalGitHubConnectionStatusResponse>;
@@ -983,7 +1694,7 @@ export declare class OpenGeniClient {
983
1694
  replacePersonalGitHubRepositorySelections(workspaceId: string, connectionId: string, request: ReplacePersonalGitHubRepositorySelectionsRequest): Promise<PersonalGitHubRepositorySelectionState>;
984
1695
  /** Revalidate every selected repository without accepting provider URLs from the caller. */
985
1696
  verifyPersonalGitHubRepositorySelections(workspaceId: string, connectionId: string, request: VerifyPersonalGitHubRepositorySelectionsRequest): Promise<PersonalGitHubRepositorySelectionState>;
986
- /** List the secret-free Slack team -> OpenGeni tenant routing authority. */
1697
+ /** List the secret-free Slack team -> Opengeni tenant routing authority. */
987
1698
  listSlackInstallationBindings(workspaceId: string): Promise<SlackInstallationBinding[]>;
988
1699
  createConnection(workspaceId: string, request: CreateConnectionRequest): Promise<ConnectionMetadata>;
989
1700
  /**
@@ -993,7 +1704,13 @@ export declare class OpenGeniClient {
993
1704
  installFikenConnection(workspaceId: string, request: FikenInstallRequest): Promise<ConnectionMetadata>;
994
1705
  /** Start the Fiken OAuth flow for the workspace-shared Fiken connection. */
995
1706
  startFikenOAuth(workspaceId: string, request?: FikenOAuthStartRequest): Promise<FikenOAuthStartResponse>;
996
- /** Start the public Slack installation flow for the workspace-shared OpenGeni bot. */
1707
+ /** List verified local and explicitly organization-shared bots, excluding personal accounts. */
1708
+ listAvailableOpenGeniSlackBots(workspaceId: string): Promise<AvailableOpenGeniSlackBots>;
1709
+ /** Read configured sharing independently of installation credential health. */
1710
+ getOpenGeniSlackBotOrganizationAccess(workspaceId: string, connectionId: string): Promise<OpenGeniSlackBotOrganizationAccess>;
1711
+ /** An organization administrator may share an installed bot with authorized workspaces. */
1712
+ setOpenGeniSlackBotOrganizationAccess(workspaceId: string, connectionId: string, request: UpdateOpenGeniSlackBotOrganizationAccess): Promise<OpenGeniSlackBotOrganizationAccess>;
1713
+ /** Start the public Slack installation flow for the workspace-shared Opengeni bot. */
997
1714
  startOpenGeniSlackBotInstall(workspaceId: string, request?: OpenGeniSlackBotInstallRequest): Promise<OpenGeniSlackBotInstallStart>;
998
1715
  listOpenGeniSlackReactionChannels(workspaceId: string, connectionId: string, cursor?: string): Promise<SlackReactionChannelListResponse>;
999
1716
  listOpenGeniSlackChannelRoutes(workspaceId: string, connectionId: string): Promise<SlackChannelRouteListResponse>;
@@ -1016,6 +1733,9 @@ export declare class OpenGeniClient {
1016
1733
  disconnectSocialConnection(workspaceId: string, connectionId: string): Promise<SocialConnection>;
1017
1734
  /** Public, immutably-cached URL for a catalog item's logo, or null when the item has none. */
1018
1735
  catalogAssetUrl(logoAssetPath: string | null): string | null;
1736
+ /** Read a passive catalog mark through this client's authenticated transport.
1737
+ * Useful when an embedding backend protects even public upstream assets. */
1738
+ downloadCatalogAsset(logoAssetPath: string, options?: OpenGeniRequestOptions): Promise<Blob>;
1019
1739
  /** GitHub App server configuration plus truthful workspace binding status. */
1020
1740
  getGitHubApp(workspaceId: string, options?: {
1021
1741
  returnPath?: string;
@@ -1023,6 +1743,10 @@ export declare class OpenGeniClient {
1023
1743
  /** Build the GitHub owner-consent entry URL for fresh workspace-bound state. */
1024
1744
  githubConnectUrl(workspaceId: string, state: string): string;
1025
1745
  listGitHubRepositories(workspaceId: string): Promise<GitHubRepositoriesResponse>;
1746
+ /** Effective confirmation policy for each GitHub identity available to this caller. */
1747
+ getGitHubActionPolicies(workspaceId: string): Promise<GitHubActionPoliciesResponse>;
1748
+ /** Change one GitHub action group without broadening review or merge policy. */
1749
+ updateGitHubActionPolicy(workspaceId: string, request: UpdateGitHubActionPolicyRequest): Promise<GitHubActionPolicyActorState>;
1026
1750
  /** Re-sync the installation's repository list from GitHub. */
1027
1751
  syncGitHubRepositories(workspaceId: string): Promise<GitHubRepositoriesResponse>;
1028
1752
  /** Remove one workspace binding without uninstalling the GitHub App itself. */
@@ -1034,9 +1758,130 @@ export declare class OpenGeniClient {
1034
1758
  createApiKey(workspaceId: string, request: CreateApiKeyRequest): Promise<CreateApiKeyResponse>;
1035
1759
  /** Revoke an API key. Returns the revoked key. */
1036
1760
  deleteApiKey(workspaceId: string, apiKeyId: string): Promise<ApiKey>;
1761
+ listOrganizationApiKeys(organizationId: string): Promise<ApiKey[]>;
1762
+ /** The returned `token` is shown once; only its prefix is stored. */
1763
+ createOrganizationApiKey(organizationId: string, request: CreateOrganizationApiKeyRequest): Promise<CreateApiKeyResponse>;
1764
+ /** Revoke an organization-scoped API key. Returns the revoked key. */
1765
+ deleteOrganizationApiKey(organizationId: string, apiKeyId: string): Promise<ApiKey>;
1766
+ /**
1767
+ * Agents people connected to the organization MCP server (`/v1/mcp`).
1768
+ * Everyone sees their own; owners and admins see everyone's. Browser only:
1769
+ * keys and agents are refused, so an agent can't widen its own access.
1770
+ */
1771
+ listOrganizationMcpConnections(organizationId: string): Promise<OrganizationMcpConnectionList>;
1772
+ /** Change what a connected agent can do and where; its next request uses it. Only its person. */
1773
+ updateOrganizationMcpConnection(organizationId: string, connectionId: string, request: UpdateOrganizationMcpConnectionRequest): Promise<OrganizationMcpConnection>;
1774
+ /** Disconnect an agent: every token it holds is refused from now on. */
1775
+ deleteOrganizationMcpConnection(organizationId: string, connectionId: string): Promise<void>;
1776
+ /**
1777
+ * Keys that act as the person who created them, with their live access in
1778
+ * this organization capped by each key's access setting. Everyone sees their
1779
+ * own; owners and admins see everyone's.
1780
+ */
1781
+ listPersonalApiKeys(organizationId: string): Promise<ListPersonalApiKeysResponse>;
1782
+ /** Create a key that acts as you. The token is returned once. */
1783
+ createPersonalApiKey(organizationId: string, request: CreatePersonalApiKeyRequest): Promise<CreatePersonalApiKeyResponse>;
1784
+ /** Revoke a personal key: its next request is refused. Its person, or an admin. */
1785
+ revokePersonalApiKey(organizationId: string, apiKeyId: string): Promise<void>;
1786
+ /** Service accounts: organization identities with no person behind them. */
1787
+ listOrganizationServiceAccounts(organizationId: string): Promise<ListOrganizationServiceAccountsResponse>;
1788
+ getOrganizationServiceAccount(organizationId: string, serviceAccountId: string): Promise<OrganizationServiceAccount>;
1789
+ /** Create a service account; give it keys with `createOrganizationApiKey({ serviceAccountId })`. */
1790
+ createOrganizationServiceAccount(organizationId: string, request: CreateOrganizationServiceAccountRequest): Promise<OrganizationServiceAccount>;
1791
+ /** Rename it or change its role; making it a member narrows its keys at once. */
1792
+ updateOrganizationServiceAccount(organizationId: string, serviceAccountId: string, request: UpdateOrganizationServiceAccountRequest): Promise<OrganizationServiceAccount>;
1793
+ /** Delete a service account; every key it holds is revoked at once. */
1794
+ deleteOrganizationServiceAccount(organizationId: string, serviceAccountId: string): Promise<void>;
1795
+ /** The pending sign-in an agent started; read by the web app's sign-in page. */
1796
+ getMcpConnectionRequest(requestToken: string): Promise<McpConnectionRequest>;
1797
+ /** Allow or deny an agent's sign-in. Returns where to send the browser next. */
1798
+ answerMcpConnectionRequest(requestToken: string, decision: McpConnectionDecision): Promise<{
1799
+ redirectTo: string;
1800
+ }>;
1801
+ /**
1802
+ * What waits on the signed-in person across their workspaces, newest first.
1803
+ * Pass a workspace to see only its items.
1804
+ */
1805
+ listInbox(options?: {
1806
+ workspaceId?: string;
1807
+ }): Promise<ListInboxResponse>;
1808
+ /** Mark an item seen, snooze it, or dismiss it. */
1809
+ updateInboxItem(itemId: InboxItem["id"], input: UpdateInboxItemInput): Promise<void>;
1810
+ getInboxSettings(): Promise<InboxSettings>;
1811
+ updateInboxSettings(input: InboxSettings): Promise<InboxSettings>;
1812
+ /** Whether other members' agents may notify the signed-in person in this workspace. */
1813
+ getMemberNotifications(workspaceId: string): Promise<MemberNotificationsSetting>;
1814
+ /** Let other members' agents notify the signed-in person in this workspace, or stop them. */
1815
+ updateMemberNotifications(workspaceId: string, input: MemberNotificationsSetting): Promise<MemberNotificationsSetting>;
1816
+ /** Whether the signed-in person muted this session's replies. */
1817
+ getSessionInboxMute(workspaceId: string, sessionId: string): Promise<SessionInboxMute>;
1818
+ /**
1819
+ * Mute or unmute this session's replies for the signed-in person. Its
1820
+ * notifications, questions and approvals still arrive.
1821
+ */
1822
+ setSessionInboxMute(workspaceId: string, sessionId: string, input: SessionInboxMute): Promise<SessionInboxMute>;
1823
+ /** This session's admin access, and what the viewer may change about it. */
1824
+ getSessionAdminAccess(workspaceId: string, sessionId: string): Promise<SessionAdminAccess>;
1825
+ /**
1826
+ * Give your own session admin access: its agent can then do what you can
1827
+ * manage across the organization. An owner or admin, in the app, when the
1828
+ * organization allows it. It lasts one hour unless `durationHours` says
1829
+ * otherwise (1 to 720), or null for no time limit; giving it again while it
1830
+ * is on sets a new time limit from now.
1831
+ */
1832
+ grantSessionAdminAccess(workspaceId: string, sessionId: string, input?: GrantSessionAdminAccessRequest): Promise<SessionAdminAccess>;
1833
+ /** End this session's admin access. */
1834
+ revokeSessionAdminAccess(workspaceId: string, sessionId: string): Promise<SessionAdminAccess>;
1835
+ /**
1836
+ * Approve a native app sign-in from the signed-in browser. Returns the app's
1837
+ * callback (`<scheme>://auth/callback?code=…&state=…`) to navigate to.
1838
+ */
1839
+ authorizeNativeApp(input: NativeAppAuthorizeInput): Promise<{
1840
+ redirectUrl: string;
1841
+ }>;
1842
+ /** Exchange a native app sign-in code and its PKCE verifier for the app's credential. */
1843
+ exchangeNativeAppCode(input: NativeAppTokenInput): Promise<NativeAppToken>;
1844
+ /** Revoke the native app credential this client signs in with. */
1845
+ signOutNativeApp(): Promise<void>;
1846
+ /** This app credential's push registration, or null when it gets no pushes. */
1847
+ getNativePushDevice(): Promise<NativePushDevice | null>;
1848
+ /** Register (or update) this device's push token and rules for this app credential. */
1849
+ registerNativePushDevice(input: RegisterNativePushDeviceInput): Promise<NativePushDevice>;
1850
+ /** Stop pushes to this device for this app credential. */
1851
+ unregisterNativePushDevice(): Promise<void>;
1852
+ /**
1853
+ * One page of sessions across every shared workspace of the organization the
1854
+ * caller may read within its live workspace scope (an organization API key or
1855
+ * organization owner). Each row carries its `workspaceId`; read events,
1856
+ * history, and files through the ordinary workspace methods. Personal
1857
+ * workspaces are never included and private sessions stay invisible.
1858
+ */
1859
+ listOrganizationSessions(organizationId: string, options?: ListOrganizationSessionsOptions): Promise<OrganizationSessionListResponse>;
1860
+ /**
1861
+ * Every session `listOrganizationSessions` would return, following
1862
+ * `nextCursor` page by page until the organization is exhausted. A page may
1863
+ * be shorter than `limit` while more pages remain, so callers must not treat
1864
+ * a short page as the end.
1865
+ */
1866
+ iterateOrganizationSessions(organizationId: string, options?: Omit<ListOrganizationSessionsOptions, "cursor">): AsyncGenerator<Session, void, undefined>;
1037
1867
  getBilling(options?: {
1038
1868
  accountId?: string;
1039
1869
  }): Promise<BillingSummary>;
1870
+ getOrganizationUsageSummary(options: {
1871
+ accountId: string;
1872
+ period?: import("@opengeni/contracts").OrganizationUsagePeriod;
1873
+ }, requestOptions?: OpenGeniRequestOptions): Promise<import("@opengeni/contracts").OrganizationUsageSummary>;
1874
+ getOrganizationModelUsage(options: {
1875
+ accountId: string;
1876
+ period?: import("@opengeni/contracts").OrganizationUsagePeriod;
1877
+ afterWorkspaceId?: string;
1878
+ }, requestOptions?: OpenGeniRequestOptions): Promise<import("@opengeni/contracts/organization-model-usage").OrganizationModelUsage>;
1879
+ getOrganizationUsageWorkspacePage(options: {
1880
+ accountId: string;
1881
+ period?: import("@opengeni/contracts").OrganizationUsagePeriod;
1882
+ until: string;
1883
+ afterWorkspaceId?: string;
1884
+ }, requestOptions?: OpenGeniRequestOptions): Promise<import("@opengeni/contracts").OrganizationUsageWorkspacePage>;
1040
1885
  getBillingUsage(options?: {
1041
1886
  accountId?: string;
1042
1887
  workspaceId?: string;
@@ -1045,14 +1890,50 @@ export declare class OpenGeniClient {
1045
1890
  range?: InsightsRange;
1046
1891
  provider?: string;
1047
1892
  model?: string;
1893
+ rootSessionId?: string;
1894
+ sessionId?: string;
1895
+ signal?: AbortSignal;
1048
1896
  }): Promise<WorkspaceInsightsResponse>;
1897
+ /** Shared usage under the existing workspace access gate. */
1898
+ getWorkspaceInsightsUsage(workspaceId: string, options?: WorkspaceInsightsUsageOptions, requestOptions?: OpenGeniRequestOptions): Promise<InsightsUsageResponse>;
1899
+ /** Shared usage under the existing organization access gate. */
1900
+ getOrganizationInsightsUsage(accountId: string, options?: OrganizationInsightsUsageOptions, requestOptions?: OpenGeniRequestOptions): Promise<InsightsUsageResponse>;
1901
+ /** Visible calls only; a filter never grants access to hidden call facts. */
1902
+ listInsightsCalls(scope: Extract<InsightsCallsScope, {
1903
+ kind: "workspace";
1904
+ }>, options?: WorkspaceInsightsCallsOptions, requestOptions?: OpenGeniRequestOptions): Promise<InsightsCallsResponse>;
1905
+ listInsightsCalls(scope: Extract<InsightsCallsScope, {
1906
+ kind: "organization";
1907
+ }>, options?: OrganizationInsightsCallsOptions, requestOptions?: OpenGeniRequestOptions): Promise<InsightsCallsResponse>;
1049
1908
  getBillingEntitlements(options?: {
1050
1909
  accountId?: string;
1051
1910
  }): Promise<BillingEntitlementsResponse>;
1052
1911
  /** Start a Stripe checkout for prepaid credits. */
1053
1912
  createBillingCheckout(request: CreateCheckoutRequest): Promise<CreateCheckoutResponse>;
1913
+ /**
1914
+ * Where one checkout stands, and whether its credits reached the balance.
1915
+ * Poll it after the customer returns from Stripe Checkout.
1916
+ */
1917
+ getBillingCheckout(checkoutSessionId: string, options?: {
1918
+ accountId?: string;
1919
+ }): Promise<BillingCheckoutStatus>;
1054
1920
  /** Open Stripe's hosted portal for invoices and payment information. */
1055
1921
  createBillingPortalSession(request?: CreateBillingPortalRequest): Promise<CreateBillingPortalResponse>;
1922
+ /** The URL of an API path on this client's base (relative when the base is relative). */
1923
+ apiUrl(path: string): string;
1924
+ /**
1925
+ * A client of the same class that adds `headers` to every request, keeping
1926
+ * this client's base URL, fetch, credentials, and actor attribution. Used to
1927
+ * scope a surface (for example an artifact viewer) to one host context.
1928
+ */
1929
+ withHeaders(headers: Readonly<Record<string, string>>): this;
1930
+ /**
1931
+ * Fetch an absolute URL under this client's base URL through its fetch and
1932
+ * headers. For transports the SDK builds itself (the editable-artifact live
1933
+ * transport), so host authentication stays in one place. A URL outside the
1934
+ * base is refused: credentials never leave the configured API.
1935
+ */
1936
+ fetchApi(input: string | URL, init?: RequestInit): Promise<Response>;
1056
1937
  private headers;
1057
1938
  private url;
1058
1939
  /** Connection state + the codex models the workspace may select (empty until connected). */
@@ -1065,6 +1946,8 @@ export declare class OpenGeniClient {
1065
1946
  codexUsage(workspaceId: string): Promise<CodexUsage>;
1066
1947
  /** Live per-account usage read (refreshes THIS account's bearer; writes the cache). */
1067
1948
  codexAccountUsage(workspaceId: string, accountId: string): Promise<CodexUsage>;
1949
+ /** Inspect an organization account even when it is paused or assigned nowhere. */
1950
+ organizationCodexAccountUsage(organizationId: string, accountId: string): Promise<CodexUsage>;
1068
1951
  /** Batched live refresh across every connected account, keyed by credential id. */
1069
1952
  refreshCodexUsage(workspaceId: string): Promise<{
1070
1953
  usage: CodexUsageMap;
@@ -1077,6 +1960,11 @@ export declare class OpenGeniClient {
1077
1960
  }>;
1078
1961
  /** List every connected Codex account + the workspace active pointer + settings. */
1079
1962
  listCodexAccounts(workspaceId: string): Promise<CodexAccountsResponse>;
1963
+ /**
1964
+ * Session-authorized Codex choices plus the current accepted account.
1965
+ * @deprecated Use getSessionModelAccount for provider-neutral choices.
1966
+ */
1967
+ listSessionCodexAccounts(workspaceId: string, sessionId: string): Promise<SessionCodexAccountsResponse>;
1080
1968
  /** Switch the workspace ACTIVE Codex account (the one unpinned sessions use). */
1081
1969
  activateCodexAccount(workspaceId: string, accountId: string): Promise<{
1082
1970
  activated: boolean;
@@ -1104,12 +1992,63 @@ export declare class OpenGeniClient {
1104
1992
  }>;
1105
1993
  /** Rename a Codex account (label only in P1). */
1106
1994
  renameCodexAccount(workspaceId: string, accountId: string, label: string | null): Promise<CodexAccount>;
1107
- /** Pin (or unpin via "auto") a session's Codex account. Applies on the next turn. */
1995
+ /**
1996
+ * Pin/unpin a Codex account without changing another provider's binding.
1997
+ * @deprecated Use setSessionModelAccount with provider: "codex" and
1998
+ * connectionId: null for Automatic, or the selected account id.
1999
+ */
1108
2000
  pinSessionCodexAccount(workspaceId: string, sessionId: string, target: string): Promise<{
1109
2001
  pinned: string;
2002
+ appliedTo?: "waiting_turn" | "next_turn";
2003
+ }>;
2004
+ /** Organization subscription management requires an administrator browser session. */
2005
+ getModelConnectionAccess(target: {
2006
+ scope: "organizations" | "workspaces";
2007
+ scopeId: string;
2008
+ kind: "codex" | "supergrok" | "vercel_gateway" | "openrouter" | "anthropic" | "claude_subscription";
2009
+ connectionId: string;
2010
+ }): Promise<ModelConnectionAccessResponse>;
2011
+ getModelConnectionAccess(target: {
2012
+ scope: "organizations" | "workspaces";
2013
+ scopeId: string;
2014
+ kind: ModelConnectionAccessKind;
2015
+ connectionId: string;
2016
+ }): Promise<ModelConnectionAccessResponse>;
2017
+ updateModelConnectionAccess(target: {
2018
+ scope: "organizations" | "workspaces";
2019
+ scopeId: string;
2020
+ kind: "codex" | "supergrok" | "vercel_gateway" | "openrouter" | "anthropic" | "claude_subscription";
2021
+ connectionId: string;
2022
+ }, policy: ModelConnectionAccessPolicy): Promise<ModelConnectionAccessPolicy>;
2023
+ updateModelConnectionAccess(target: {
2024
+ scope: "organizations" | "workspaces";
2025
+ scopeId: string;
2026
+ kind: ModelConnectionAccessKind;
2027
+ connectionId: string;
2028
+ }, policy: ModelConnectionAccessPolicy): Promise<ModelConnectionAccessPolicy>;
2029
+ listOrganizationSuperGrokAccounts(organizationId: string): Promise<SuperGrokAccountsResponse>;
2030
+ organizationSupergrokConnectStart(organizationId: string): Promise<SuperGrokConnectStart>;
2031
+ organizationSupergrokConnectPoll(organizationId: string, state: string): Promise<SuperGrokConnectPoll>;
2032
+ activateOrganizationSuperGrokAccount(organizationId: string, accountId: string): Promise<{
2033
+ updated: boolean;
2034
+ }>;
2035
+ setOrganizationSuperGrokRotationSettings(organizationId: string, patch: {
2036
+ rotationEnabled: boolean;
2037
+ }): Promise<SuperGrokRotationSettings>;
2038
+ setOrganizationSuperGrokAccountAllocator(organizationId: string, accountId: string, input: {
2039
+ enabled: boolean;
2040
+ expectedVersion: number;
2041
+ }): Promise<{
2042
+ updated: boolean;
2043
+ }>;
2044
+ renameOrganizationSuperGrokAccount(organizationId: string, accountId: string, label: string | null): Promise<{
2045
+ updated: boolean;
2046
+ }>;
2047
+ disconnectOrganizationSuperGrokAccount(organizationId: string, accountId: string): Promise<{
2048
+ disconnected: boolean;
1110
2049
  }>;
1111
2050
  supergrokStatus(workspaceId: string): Promise<SuperGrokConnectionStatus>;
1112
- supergrokConnectStart(workspaceId: string, scope?: SuperGrokAccountScope): Promise<SuperGrokConnectStart>;
2051
+ supergrokConnectStart(workspaceId: string, scope?: Exclude<SuperGrokAccountScope, "organization">): Promise<SuperGrokConnectStart>;
1113
2052
  supergrokConnectPoll(workspaceId: string, state: string): Promise<SuperGrokConnectPoll>;
1114
2053
  listSuperGrokAccounts(workspaceId: string): Promise<SuperGrokAccountsResponse>;
1115
2054
  activateSuperGrokAccount(workspaceId: string, accountId: string): Promise<{
@@ -1133,7 +2072,9 @@ export declare class OpenGeniClient {
1133
2072
  /** Contract-checked JSON transport shared by opt-in typed SDK clients. */
1134
2073
  requestJson<T>(method: string, path: string, body?: unknown, query?: Record<string, string>, options?: OpenGeniRequestOptions): Promise<T>;
1135
2074
  /** Authenticated, contract-checked response for bounded streaming downloads. */
1136
- protected requestResponse(method: string, path: string, query?: Record<string, string>, options?: OpenGeniRequestOptions): Promise<Response>;
2075
+ protected requestResponse(method: string, path: string, query?: Record<string, string>, options?: OpenGeniRequestOptions & {
2076
+ accept?: string;
2077
+ }): Promise<FetchResponse>;
1137
2078
  /** Contract-checked transport shared by opt-in typed SDK clients for 204 responses. */
1138
2079
  requestVoid(method: string, path: string, body?: unknown): Promise<void>;
1139
2080
  }