@opengeni/sdk 0.29.0 → 0.32.1

package/dist/index.js

@@ -350,6 +350,7 @@ var SESSION_EVENT_TYPES = [
   "session.requiresAction",
   "session.humanInput.requested",
   "session.context.compaction.requested",
+  "session.context.compaction.started",
   "session.context.compacted",
   "session.context.compaction.skipped",
   "session.context.cleared",
@@ -544,6 +545,51 @@ var OpenGeniClient = class {
     this.fetchImpl = options.fetch ?? ((input, init) => fetch(input, init));
   }
   // --- Session lifecycle ---------------------------------------------------
+  /** Upload one ephemeral browser recording. This method never retries. */
+  async transcribeAudio(workspaceId, input) {
+    const correlationId = crypto.randomUUID();
+    const form = new FormData();
+    const filename = filenameForAudioMimeType(input.mimeType);
+    const audio = input.audio instanceof File ? input.audio : input.audio instanceof Uint8Array ? new File([Uint8Array.from(input.audio)], filename, { type: input.mimeType }) : new File([input.audio], filename, { type: input.mimeType || input.audio.type });
+    form.append("audio", audio, filename);
+    form.append("mimeType", input.mimeType);
+    if (input.durationSeconds !== void 0) {
+      form.append("durationSeconds", String(input.durationSeconds));
+    }
+    let response;
+    try {
+      response = await this.fetchImpl(this.url(`/v1/workspaces/${workspaceId}/transcriptions`), {
+        method: "POST",
+        headers: { ...this.headers(correlationId), Accept: "application/json" },
+        body: form,
+        ...input.signal ? { signal: input.signal } : {}
+      });
+    } catch (error) {
+      if (input.signal?.aborted) throw error;
+      throw mutationTransportError(correlationId);
+    }
+    assertApiContractResponse(response);
+    if (!response.ok) throw await apiErrorFromResponse(response, { method: "POST", correlationId });
+    await assertJsonResponse(response, { method: "POST", correlationId });
+    let body;
+    try {
+      body = await response.json();
+    } catch {
+      throw new OpenGeniApiError(response.status, "Invalid transcription response.", {
+        code: "invalid_response",
+        mutation: true,
+        correlationId
+      });
+    }
+    if (!isTranscribeAudioResponse(body)) {
+      throw new OpenGeniApiError(response.status, "Invalid transcription response.", {
+        code: "invalid_response",
+        mutation: true,
+        correlationId
+      });
+    }
+    return body;
+  }
   async createSession(workspaceId, request) {
     return await this.requestJson(
       "POST",
@@ -672,10 +718,16 @@ var OpenGeniClient = class {
       `/v1/workspaces/${workspaceId}/sessions/${sessionId}/turns`,
       void 0,
       {
-        ...options.limit !== void 0 ? { limit: String(options.limit) } : {}
+        ...options.limit !== void 0 ? { limit: String(options.limit) } : {},
+        ...options.latestStarted ? { latestStarted: "1" } : {}
       }
     );
   }
+  /** Newest turn that durably emitted `turn.started`, or null before any admission. */
+  async getLatestStartedTurn(workspaceId, sessionId) {
+    const turns = await this.listTurns(workspaceId, sessionId, { latestStarted: true });
+    return turns[0] ?? null;
+  }
   // --- Bring-your-own-compute: Machines dashboard + metrics (M10) ------------
   /**
    * List the workspace's machines (the Machines dashboard). Each enrolled
@@ -1437,6 +1489,13 @@ var OpenGeniClient = class {
   async getWorkspace(workspaceId) {
     return await this.requestJson("GET", `/v1/workspaces/${workspaceId}`);
   }
+  /** Read-time, secret-safe inventory of policy heads and visible workspace knowledge. */
+  async getWorkspaceState(workspaceId) {
+    return await this.requestJson(
+      "GET",
+      `/v1/workspaces/${workspaceId}/workspace-state`
+    );
+  }
   async updateWorkspace(workspaceId, request) {
     return await this.requestJson("PATCH", `/v1/workspaces/${workspaceId}`, request);
   }
@@ -1501,6 +1560,85 @@ var OpenGeniClient = class {
       request
     );
   }
+  async listPreferenceRegistry(workspaceId, options = {}) {
+    const params = new URLSearchParams();
+    if (options.scope) params.set("scope", options.scope);
+    if (options.status) params.set("status", options.status);
+    if (options.limit !== void 0) params.set("limit", String(options.limit));
+    const query = params.toString();
+    return await this.requestJson(
+      "GET",
+      `/v1/workspaces/${workspaceId}/preferences${query ? `?${query}` : ""}`
+    );
+  }
+  async getPreferenceRegistry(workspaceId, preferenceId) {
+    return await this.requestJson(
+      "GET",
+      `/v1/workspaces/${workspaceId}/preferences/${encodeURIComponent(preferenceId)}`
+    );
+  }
+  async createPreferenceRegistryProposal(workspaceId, request) {
+    return await this.requestJson(
+      "POST",
+      `/v1/workspaces/${workspaceId}/preferences/proposals`,
+      request
+    );
+  }
+  async activatePreferenceRegistryRevision(workspaceId, preferenceId, request) {
+    return await this.requestJson(
+      "POST",
+      `/v1/workspaces/${workspaceId}/preferences/${encodeURIComponent(preferenceId)}/activate`,
+      request
+    );
+  }
+  async correctPreferenceRegistry(workspaceId, preferenceId, request) {
+    return await this.requestJson(
+      "POST",
+      `/v1/workspaces/${workspaceId}/preferences/${encodeURIComponent(preferenceId)}/correct`,
+      request
+    );
+  }
+  async changePreferenceRegistryScope(workspaceId, preferenceId, request) {
+    return await this.requestJson(
+      "POST",
+      `/v1/workspaces/${workspaceId}/preferences/${encodeURIComponent(preferenceId)}/scope`,
+      request
+    );
+  }
+  async deactivatePreferenceRegistry(workspaceId, preferenceId, request) {
+    return await this.requestJson(
+      "POST",
+      `/v1/workspaces/${workspaceId}/preferences/${encodeURIComponent(preferenceId)}/deactivate`,
+      request
+    );
+  }
+  async supersedePreferenceRegistry(workspaceId, preferenceId, request) {
+    return await this.requestJson(
+      "POST",
+      `/v1/workspaces/${workspaceId}/preferences/${encodeURIComponent(preferenceId)}/supersede`,
+      request
+    );
+  }
+  async rejectPreferenceRegistryProposal(workspaceId, preferenceId, request) {
+    return await this.requestJson(
+      "POST",
+      `/v1/workspaces/${workspaceId}/preferences/${encodeURIComponent(preferenceId)}/reject`,
+      request
+    );
+  }
+  async getPreferenceRegistrySummary(workspaceId) {
+    return await this.requestJson(
+      "GET",
+      `/v1/workspaces/${workspaceId}/preferences/summary`
+    );
+  }
+  async getPreferenceRegistryFullContent(workspaceId, retrievalHandle) {
+    return await this.requestJson(
+      "POST",
+      `/v1/workspaces/${workspaceId}/preferences/full-content`,
+      { retrievalHandle }
+    );
+  }
   /**
    * Delete a workspace and everything in it. Refused (409) for the account's
    * only workspace and while it still has a running session. Irreversible.
@@ -2153,11 +2291,13 @@ var OpenGeniClient = class {
     return response.connection;
   }
   /** Start an OAuth connection flow; redirect the user to the returned `authorizationUrl`. */
-  async startConnectionOAuth(workspaceId, request) {
+  async startConnectionOAuth(workspaceId, request, options = {}) {
     return await this.requestJson(
       "POST",
       `/v1/workspaces/${workspaceId}/connections/oauth/start`,
-      request
+      request,
+      {},
+      options
     );
   }
   /** Public, immutably-cached URL for a catalog item's logo, or null when the item has none. */
@@ -2236,6 +2376,18 @@ var OpenGeniClient = class {
       ...options.workspaceId !== void 0 ? { workspaceId: options.workspaceId } : {}
     });
   }
+  async getWorkspaceInsights(workspaceId, options = {}) {
+    return await this.requestJson(
+      "GET",
+      `/v1/workspaces/${workspaceId}/insights`,
+      void 0,
+      {
+        range: options.range ?? "week",
+        ...options.provider !== void 0 ? { provider: options.provider } : {},
+        ...options.model !== void 0 ? { model: options.model } : {}
+      }
+    );
+  }
   async getBillingEntitlements(options = {}) {
     return await this.requestJson(
       "GET",
@@ -2438,6 +2590,30 @@ function assertApiContractResponse(response) {
     throw new OpenGeniApiContractMismatchError(OPENGENI_API_CONTRACT_REVISION, actual);
   }
 }
+function isTranscribeAudioResponse(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+  const record = value;
+  return typeof record.text === "string" && Array.isArray(record.languages) && record.languages.every((language) => typeof language === "string");
+}
+function filenameForAudioMimeType(mimeType) {
+  const bare = mimeType.trim().toLowerCase().split(";")[0] ?? "audio/webm";
+  switch (bare) {
+    case "audio/mp4":
+    case "audio/m4a":
+      return "audio.mp4";
+    case "audio/ogg":
+      return "audio.ogg";
+    case "audio/mpeg":
+    case "audio/mp3":
+      return "audio.mp3";
+    case "audio/wav":
+    case "audio/x-wav":
+      return "audio.wav";
+    case "audio/webm":
+    default:
+      return "audio.webm";
+  }
+}
 var API_ERROR_MAX_BYTES = 16 * 1024;
 async function apiErrorFromResponse(response, context) {
   return new OpenGeniApiError(response.status, await readBoundedJsonErrorBody(response), {
@@ -2853,6 +3029,11 @@ function normalizeWorkspaceInstructionPolicyRoleKey(value) {
   return value.normalize("NFKC").trim().toLowerCase().replace(/\s+/gu, "-").replace(/-+/g, "-");
 }
 
+// src/preference-registry.ts
+function normalizePreferenceRegistryStableKey(value) {
+  return value.normalize("NFKC").trim().toLowerCase().replace(/\s+/gu, "-").replace(/-+/g, "-");
+}
+
 // src/transcription.ts
 var DEFAULT_WORKSPACE_TRANSCRIPTION_POLICY = {
   enabled: false,
@@ -2866,6 +3047,15 @@ var DEFAULT_WORKSPACE_TRANSCRIPTION_POLICY = {
   fallback: { mode: "disabled", targets: [] },
   cost: { currency: "USD", maxPerHour: null, maxPerMonth: null }
 };
+function resolveWorkspaceVoiceInputEnabled(settings) {
+  if (!isRecord(settings)) return null;
+  const voiceInput = settings.voiceInput;
+  if (isRecord(voiceInput) && typeof voiceInput.enabled === "boolean") {
+    return voiceInput.enabled;
+  }
+  const legacy = settings.transcription;
+  return isRecord(legacy) && typeof legacy.enabled === "boolean" ? legacy.enabled : null;
+}
 function resolveWorkspaceTranscriptionPolicy(settings) {
   if (!isRecord(settings)) return cloneDefaultPolicy();
   const candidate = settings.transcription;
@@ -3091,10 +3281,12 @@ export {
   isRetryableStreamError,
   nextDesktopState,
   normalizeMcpOutput,
+  normalizePreferenceRegistryStableKey,
   normalizeWorkspaceInstructionPolicyRoleKey,
   parseSseStream,
   proxySessionEventStream,
   resolveWorkspaceTranscriptionPolicy,
+  resolveWorkspaceVoiceInputEnabled,
   resumeSequenceFromRequest,
   sessionEventsToSseResponse,
   sessionEventsToSseStream,