@opengeni/sdk 0.37.0 → 0.41.0

package/README.md

@@ -37,6 +37,56 @@ for await (const event of client.streamEvents(workspaceId, session.id)) {
 }
 ```
 
+## Realtime browser controller (`@opengeni/sdk/realtime`)
+
+The public realtime subpath owns the provider-neutral browser controller and
+the existing Codex Live, WebRTC/V3, and AI Gateway transports. It selects the
+transport from the catalog model without changing the backend API, durable
+ledger, delegation, context, or recovery semantics:
+
+```ts
+import { OpenGeniClient } from "@opengeni/sdk";
+import type { SessionRealtimeClientLike } from "@opengeni/sdk/realtime";
+
+const client = new OpenGeniClient({ baseUrl: "/opengeni-api" });
+const realtimeClient: SessionRealtimeClientLike = client;
+const catalog = await realtimeClient.getWorkspaceRealtimeModelCatalog(workspaceId);
+const model = catalog.models.find((candidate) => candidate.available)?.id;
+if (!model) throw new Error("No realtime model is available");
+
+// Lazy import keeps the base SDK entry safe for server and non-realtime hosts.
+const { createSessionRealtimeController } = await import("@opengeni/sdk/realtime");
+const controller = createSessionRealtimeController({
+  client: realtimeClient,
+  workspaceId,
+  sessionId,
+  model,
+  remoteAudio,
+});
+
+const unsubscribe = controller.subscribe((snapshot) => {
+  console.log(snapshot.status, snapshot.microphone, snapshot.diagnostic);
+});
+await controller.start();
+
+// Later:
+await controller.stop();
+unsubscribe();
+controller.close();
+```
+
+`SessionRealtimeClientLike` is the exact proxy-friendly backend surface:
+catalog, begin, Codex/Gateway negotiation, activation, heartbeat, ledger sync,
+and end. Existing `OpenGeniClient` methods remain the implementation. Current
+Codex-named controller and transport exports remain available as compatibility
+aliases, but new integrations should use the provider-neutral names.
+
+Do not put API credentials in browser bundles. Browser hosts should either use
+the deployment's normal browser authentication or expose these same methods
+through a tenant-scoped, same-origin proxy. The SDK does not move persistence,
+prompt construction, context processing, delegation, or provider credentials
+out of `apps/api`, `apps/worker`, or `packages/db`.
+
 ## Workspace artifacts
 
 Workspace artifacts are generic, immutable HTML publications. The SDK does not
@@ -360,7 +410,7 @@ Every public endpoint group has typed methods:
 | Scheduled tasks | `createScheduledTask`, `listScheduledTasks`, `getScheduledTask`, `updateScheduledTask`, `pauseScheduledTask`, `resumeScheduledTask`, `triggerScheduledTask`, `deleteScheduledTask`, `listScheduledTaskRuns` |
 | Variable sets | `listVariable sets`, `createVariable set`, `getVariable set`, `updateVariable set`, `deleteVariable set`, `setVariable setVariable`, `deleteVariable setVariable` (values are write-only) |
 | Files | `uploadFile`, `beginFileUpload`, `completeFileUpload`, `getFile`, `createFileDownloadUrl` |
-| Documents | `createDocumentBase`, `listDocumentBases`, `getDocumentBase`, `addDocument`, `listDocuments`, `reindexDocument`, `searchDocuments` |
+| Documents | `createDocumentBase`, `listDocumentBases`, `getDocumentBase`, `addDocument`, `listDocuments`, `reindexDocument`, `searchDocuments`, `searchKnowledge` (effective organization + workspace + immutable initiating-user personal scope) |
 | Packs | `listPacks`, `registerPack`, `getPack`, `enablePack`, `deletePack`, `listPackInstallations` |
 | Capabilities | `listCapabilities`, `createCapability`, `enableCapability`, `disableCapability`, `discoverMcpCapabilities` |
 | GitHub | `getGitHubApp`, `githubConnectUrl`, `listGitHubRepositories`, `syncGitHubRepositories`, `createGitHubAppManifest` |

package/dist/{chunk-VOQ235WN.js → chunk-DKNW4WMJ.js}

@@ -263,6 +263,7 @@ async function sleep2(delayMs, signal) {
 }
 
 // src/types.ts
+var DEFAULT_FILE_RESOURCE_MOUNT_ROOT = ".opengeni/files";
 var SESSION_EVENT_TYPES = [
   "session.created",
   // Defensive bounded projection for malformed/legacy oversized envelopes.
@@ -1517,10 +1518,13 @@ var OpenGeniClient = class {
     return await this.requestJson("GET", `/v1/workspaces/${workspaceId}`);
   }
   /** Read-time, secret-safe inventory of policy heads and visible workspace knowledge. */
-  async getWorkspaceState(workspaceId) {
+  async getWorkspaceState(workspaceId, options = {}) {
+    const params = new URLSearchParams();
+    if (options.attemptId) params.set("attemptId", options.attemptId);
+    const query = params.size > 0 ? `?${params.toString()}` : "";
     return await this.requestJson(
       "GET",
-      `/v1/workspaces/${workspaceId}/workspace-state`
+      `/v1/workspaces/${workspaceId}/workspace-state${query}`
     );
   }
   async updateWorkspace(workspaceId, request) {
@@ -1555,6 +1559,24 @@ var OpenGeniClient = class {
       request
     );
   }
+  /** List the newest immutable onboarding proposals and their inactive policy drafts. */
+  async listWorkspaceInstructionPolicyOnboardingProposals(workspaceId, options = {}) {
+    const params = new URLSearchParams();
+    if (options.limit !== void 0) params.set("limit", String(options.limit));
+    const query = params.toString();
+    return await this.requestJson(
+      "GET",
+      `/v1/workspaces/${workspaceId}/instruction-policies/onboarding-proposals${query ? `?${query}` : ""}`
+    );
+  }
+  /** Create one draft-only proposal against an exact active-policy baseline. */
+  async createWorkspaceInstructionPolicyOnboardingProposal(workspaceId, request) {
+    return await this.requestJson(
+      "POST",
+      `/v1/workspaces/${workspaceId}/instruction-policies/onboarding-proposals`,
+      request
+    );
+  }
   /** Import the stored legacy workspace override as an inactive charter draft. */
   async importLegacyWorkspaceInstructionPolicyDraft(workspaceId, request = {}) {
     return await this.requestJson(
@@ -2335,6 +2357,22 @@ var OpenGeniClient = class {
     );
     return response.connection;
   }
+  async disconnectGoogleDriveConnection(workspaceId, connectionId, request) {
+    const response = await this.requestJson(
+      "DELETE",
+      `/v1/workspaces/${workspaceId}/connections/${connectionId}`,
+      request
+    );
+    return response.connection;
+  }
+  async transitionGoogleDriveLifecycle(workspaceId, connectionId, request) {
+    const response = await this.requestJson(
+      "PATCH",
+      `/v1/workspaces/${workspaceId}/connections/google-drive/${connectionId}/lifecycle`,
+      request
+    );
+    return response.connection;
+  }
   /** Start an OAuth connection flow; redirect the user to the returned `authorizationUrl`. */
   async startConnectionOAuth(workspaceId, request, options = {}) {
     return await this.requestJson(
@@ -3014,6 +3052,7 @@ export {
   parseSseStream,
   streamSessionEvents,
   streamWorkspaceControlEvents,
+  DEFAULT_FILE_RESOURCE_MOUNT_ROOT,
   SESSION_EVENT_TYPES,
   KNOWN_PERMISSIONS,
   OPENGENI_API_CONTRACT_REVISION,
@@ -3029,4 +3068,4 @@ export {
   authorizeTranscriptionAdapter,
   createTranscriptionSessionRequest
 };
-//# sourceMappingURL=chunk-VOQ235WN.js.map
+//# sourceMappingURL=chunk-DKNW4WMJ.js.map