@ai-matrx/api 0.1.23 → 0.1.25

package/dist/recording.cjs

@@ -0,0 +1,278 @@
+'use strict';
+
+var chunkUOIMSC67_cjs = require('./chunk-UOIMSC67.cjs');
+var chunkSZMLSYJK_cjs = require('./chunk-SZMLSYJK.cjs');
+var chunkHPR4EWCK_cjs = require('./chunk-HPR4EWCK.cjs');
+var chunkHM5A33QV_cjs = require('./chunk-HM5A33QV.cjs');
+require('./chunk-2SXAAKGV.cjs');
+
+// src/recording.ts
+var MatrxAudioClient = class {
+  #api;
+  #getAccessToken;
+  #getOrganizationId;
+  #requestTimeoutMs;
+  #journalFolder;
+  #fullAudioUploads = /* @__PURE__ */ new Map();
+  #organizationToken = null;
+  #organizationPromise = null;
+  constructor(options) {
+    const baseUrl = options.baseUrl.replace(/\/$/, "");
+    this.#getAccessToken = options.getAccessToken ?? (() => null);
+    this.#getOrganizationId = options.getOrganizationId;
+    this.#requestTimeoutMs = options.requestTimeoutMs ?? 3e4;
+    this.#journalFolder = options.journalFolder ?? "Transcripts/Browser Audio";
+    this.#api = chunkHM5A33QV_cjs.createApi({
+      credentials: async () => {
+        const accessToken = await this.#getAccessToken();
+        return accessToken ? { kind: "user", accessToken } : null;
+      },
+      // One host-supplied origin answers every deployment.
+      resolveBaseUrl: () => baseUrl,
+      connectTimeoutMs: this.#requestTimeoutMs,
+      totalTimeoutMs: this.#requestTimeoutMs
+    });
+  }
+  async #resolveOrganizationId(token) {
+    const supplied = await this.#getOrganizationId?.();
+    if (supplied) return supplied;
+    if (this.#getOrganizationId) {
+      throw new Error(
+        "Audio recovery requires an authenticated organization scope."
+      );
+    }
+    if (this.#organizationToken !== token || !this.#organizationPromise) {
+      this.#organizationToken = token;
+      const organizationPromise = (async () => {
+        const identity = await chunkUOIMSC67_cjs.whoami(this.#api);
+        if (!identity.authenticated || !identity.organization_id) {
+          throw new Error(
+            "Audio recovery requires an authenticated organization scope."
+          );
+        }
+        return identity.organization_id;
+      })();
+      const cachedPromise = organizationPromise.catch((error) => {
+        if (this.#organizationPromise === cachedPromise) {
+          this.#organizationPromise = null;
+        }
+        throw error;
+      });
+      this.#organizationPromise = cachedPromise;
+    }
+    return this.#organizationPromise;
+  }
+  /** Per-call options: the organization this signed-in person acts in. */
+  async #call(signal) {
+    const token = await this.#getAccessToken();
+    const options = signal ? { signal } : {};
+    if (token) options.organizationId = await this.#resolveOrganizationId(token);
+    return options;
+  }
+  async transcribe(file, signal) {
+    const form = new FormData();
+    form.append("file", file);
+    const result = await chunkHPR4EWCK_cjs.transcribeUpload(
+      this.#api,
+      { body: form },
+      await this.#call(signal)
+    );
+    return { ...result, text: result.text.trim() };
+  }
+  async transcribeFull(file, options) {
+    const recordingId = options?.recordingId ?? file.name.replace(/\.[^.]+$/, "");
+    const uploaded = await this.#upload(
+      file,
+      `${this.#journalFolder}/${recordingId}--recording.${file.name.split(".").pop() ?? "webm"}`,
+      {
+        audio_input_stage: "fallback",
+        recording_id: recordingId,
+        recording_origin: options?.origin,
+        ephemeral: false
+      }
+    );
+    this.#fullAudioUploads.set(recordingId, uploaded);
+    const result = await chunkHPR4EWCK_cjs.transcribeFile(
+      this.#api,
+      { body: { file_id: uploaded.file_id } },
+      await this.#call(options?.signal)
+    );
+    return { ...result, text: result.text.trim() };
+  }
+  async #upload(file, filePath, metadata) {
+    const form = new FormData();
+    form.append("file", file);
+    form.append("file_path", filePath);
+    form.append("published_to_web", "false");
+    form.append("shown_to", "only_me");
+    form.append("visibility", "personal");
+    form.append("metadata_json", JSON.stringify({ origin: "transcripts", ...metadata }));
+    return chunkSZMLSYJK_cjs.uploadFile(this.#api, { body: form }, await this.#call());
+  }
+  async journalChunk(input) {
+    const index = String(input.chunkIndex).padStart(4, "0");
+    const uploaded = await this.#upload(
+      input.file,
+      `${this.#journalFolder}/${input.recordingId}--chunk-${index}.${input.file.name.split(".").pop() ?? "webm"}`,
+      {
+        audio_input_stage: "chunk",
+        recording_id: input.recordingId,
+        chunk_index: input.chunkIndex,
+        recording_origin: input.origin,
+        ephemeral: true
+      }
+    );
+    try {
+      const journal = await chunkHPR4EWCK_cjs.createRecordingJournalChunk(
+        this.#api,
+        {
+          body: {
+            recording_id: input.recordingId,
+            chunk_index: input.chunkIndex,
+            file_id: uploaded.file_id,
+            mime_type: input.file.type,
+            size_bytes: input.file.size,
+            ...input.origin ? { origin: { ...input.origin } } : {}
+          }
+        },
+        await this.#call()
+      );
+      if (journal.replaced_file_id) {
+        await this.#deleteFile(journal.replaced_file_id);
+      }
+    } catch (error) {
+      await this.#deleteFile(uploaded.file_id);
+      throw error;
+    }
+  }
+  async finalize(input) {
+    const audioResult = this.#fullAudioUploads.get(input.recordingId) ?? await this.#upload(
+      input.audio,
+      `${this.#journalFolder}/${input.recordingId}--recording.${input.audio.name.split(".").pop() ?? "webm"}`,
+      {
+        audio_input_stage: "complete",
+        recording_id: input.recordingId,
+        recording_origin: input.origin,
+        ephemeral: false
+      }
+    );
+    const completion = await chunkHPR4EWCK_cjs.completeRecordingJournal(
+      this.#api,
+      {
+        path: { recording_id: input.recordingId },
+        body: {
+          transcript: input.transcript,
+          audio_file_id: audioResult.file_id,
+          duration_ms: input.durationMs,
+          ...input.origin ? { origin: { ...input.origin } } : {}
+        }
+      },
+      await this.#call()
+    );
+    const manifest = new File(
+      [
+        JSON.stringify({
+          recording_id: input.recordingId,
+          transcript: input.transcript,
+          audio_file_id: audioResult.file_id,
+          transcript_id: completion.transcript_id,
+          origin: input.origin,
+          completed_at: (/* @__PURE__ */ new Date()).toISOString()
+        })
+      ],
+      `${input.recordingId}--complete.json`,
+      { type: "application/json" }
+    );
+    await this.#upload(
+      manifest,
+      `${this.#journalFolder}/${manifest.name}`,
+      {
+        audio_input_stage: "manifest",
+        recording_id: input.recordingId,
+        ephemeral: false
+      }
+    );
+    this.#fullAudioUploads.delete(input.recordingId);
+  }
+  async listRecoverable() {
+    if (!await this.#getAccessToken()) return [];
+    const recordings = await chunkHPR4EWCK_cjs.getRecordingJournals(
+      this.#api,
+      void 0,
+      await this.#call()
+    );
+    return recordings.map((recording) => ({
+      recordingId: recording.recording_id,
+      updatedAt: Date.parse(recording.updated_at)
+    }));
+  }
+  async loadRecoverable(recordingId) {
+    const journal = await chunkHPR4EWCK_cjs.getRecordingJournal(
+      this.#api,
+      { path: { recording_id: recordingId } },
+      await this.#call()
+    );
+    const chunks = [...journal];
+    if (chunks.length === 0) return null;
+    chunks.sort((a, b) => a.chunk_index - b.chunk_index);
+    const parts = [];
+    const missingChunkIndices = [];
+    const highestIndex = chunks.at(-1)?.chunk_index ?? -1;
+    const journaledIndices = new Set(chunks.map((chunk) => chunk.chunk_index));
+    for (let index = 0; index <= highestIndex; index += 1) {
+      if (!journaledIndices.has(index)) missingChunkIndices.push(index);
+    }
+    for (const chunk of chunks) {
+      let blob;
+      try {
+        const response = await chunkSZMLSYJK_cjs.downloadFile(
+          this.#api,
+          { path: { file_id: chunk.file_id }, query: { inline: true } },
+          await this.#call()
+        );
+        blob = await response.blob();
+      } catch (error) {
+        if (!(error instanceof chunkHM5A33QV_cjs.MatrxApiError)) throw error;
+        missingChunkIndices.push(chunk.chunk_index);
+        continue;
+      }
+      if (blob.size === 0) {
+        missingChunkIndices.push(chunk.chunk_index);
+        continue;
+      }
+      parts.push(blob);
+    }
+    if (parts.length === 0) return null;
+    return {
+      blob: new Blob(parts, { type: chunks[0]?.mime_type || "audio/webm" }),
+      missingChunkIndices: [...new Set(missingChunkIndices)].sort((a, b) => a - b)
+    };
+  }
+  async discard(recordingId) {
+    const result = await chunkHPR4EWCK_cjs.deleteRecordingJournal(
+      this.#api,
+      { path: { recording_id: recordingId } },
+      await this.#call()
+    );
+    for (const fileId of result.file_ids) {
+      await this.#deleteFile(fileId);
+    }
+  }
+  /** Best-effort cleanup of an orphaned file; a failed delete never masks the real outcome. */
+  async #deleteFile(fileId) {
+    try {
+      await chunkSZMLSYJK_cjs.filesDeleteFile(
+        this.#api,
+        { path: { file_id: fileId } },
+        await this.#call()
+      );
+    } catch {
+    }
+  }
+};
+function createMatrxAudioClient(options) {
+  return new MatrxAudioClient(options);
+}
+
+exports.MatrxAudioClient = MatrxAudioClient;
+exports.createMatrxAudioClient = createMatrxAudioClient;

package/dist/recording.d.cts

@@ -0,0 +1,44 @@
+import { TranscriptionTransport, DurableAudioPersistence, TranscriptionResult, RecordingOrigin } from '@ai-matrx/browser-audio/core';
+
+interface MatrxAudioClientOptions {
+    baseUrl: string;
+    getAccessToken?: () => string | null | Promise<string | null>;
+    getOrganizationId?: () => string | null | Promise<string | null>;
+    requestTimeoutMs?: number;
+    journalFolder?: string;
+}
+declare class MatrxAudioClient implements TranscriptionTransport, DurableAudioPersistence {
+    #private;
+    constructor(options: MatrxAudioClientOptions);
+    transcribe(file: File, signal?: AbortSignal): Promise<TranscriptionResult>;
+    transcribeFull(file: File, options?: {
+        recordingId?: string;
+        origin?: RecordingOrigin;
+        signal?: AbortSignal;
+    }): Promise<TranscriptionResult>;
+    journalChunk(input: {
+        recordingId: string;
+        chunkIndex: number;
+        file: File;
+        origin?: RecordingOrigin;
+    }): Promise<void>;
+    finalize(input: {
+        recordingId: string;
+        audio: File;
+        transcript: string;
+        durationMs: number;
+        origin?: RecordingOrigin;
+    }): Promise<void>;
+    listRecoverable(): Promise<Array<{
+        recordingId: string;
+        updatedAt: number;
+    }>>;
+    loadRecoverable(recordingId: string): Promise<{
+        blob: Blob;
+        missingChunkIndices: number[];
+    } | null>;
+    discard(recordingId: string): Promise<void>;
+}
+declare function createMatrxAudioClient(options: MatrxAudioClientOptions): MatrxAudioClient;
+
+export { MatrxAudioClient, type MatrxAudioClientOptions, createMatrxAudioClient };

package/dist/recording.d.ts

@@ -0,0 +1,44 @@
+import { TranscriptionTransport, DurableAudioPersistence, TranscriptionResult, RecordingOrigin } from '@ai-matrx/browser-audio/core';
+
+interface MatrxAudioClientOptions {
+    baseUrl: string;
+    getAccessToken?: () => string | null | Promise<string | null>;
+    getOrganizationId?: () => string | null | Promise<string | null>;
+    requestTimeoutMs?: number;
+    journalFolder?: string;
+}
+declare class MatrxAudioClient implements TranscriptionTransport, DurableAudioPersistence {
+    #private;
+    constructor(options: MatrxAudioClientOptions);
+    transcribe(file: File, signal?: AbortSignal): Promise<TranscriptionResult>;
+    transcribeFull(file: File, options?: {
+        recordingId?: string;
+        origin?: RecordingOrigin;
+        signal?: AbortSignal;
+    }): Promise<TranscriptionResult>;
+    journalChunk(input: {
+        recordingId: string;
+        chunkIndex: number;
+        file: File;
+        origin?: RecordingOrigin;
+    }): Promise<void>;
+    finalize(input: {
+        recordingId: string;
+        audio: File;
+        transcript: string;
+        durationMs: number;
+        origin?: RecordingOrigin;
+    }): Promise<void>;
+    listRecoverable(): Promise<Array<{
+        recordingId: string;
+        updatedAt: number;
+    }>>;
+    loadRecoverable(recordingId: string): Promise<{
+        blob: Blob;
+        missingChunkIndices: number[];
+    } | null>;
+    discard(recordingId: string): Promise<void>;
+}
+declare function createMatrxAudioClient(options: MatrxAudioClientOptions): MatrxAudioClient;
+
+export { MatrxAudioClient, type MatrxAudioClientOptions, createMatrxAudioClient };

package/dist/recording.js

@@ -0,0 +1,275 @@
+import { whoami } from './chunk-PFEPI7C3.js';
+import { uploadFile, downloadFile, filesDeleteFile } from './chunk-OAPV5ZK5.js';
+import { transcribeUpload, transcribeFile, createRecordingJournalChunk, completeRecordingJournal, getRecordingJournals, getRecordingJournal, deleteRecordingJournal } from './chunk-3HS6725N.js';
+import { createApi, MatrxApiError } from './chunk-OYD4PTWW.js';
+import './chunk-KIEAFMKB.js';
+
+// src/recording.ts
+var MatrxAudioClient = class {
+  #api;
+  #getAccessToken;
+  #getOrganizationId;
+  #requestTimeoutMs;
+  #journalFolder;
+  #fullAudioUploads = /* @__PURE__ */ new Map();
+  #organizationToken = null;
+  #organizationPromise = null;
+  constructor(options) {
+    const baseUrl = options.baseUrl.replace(/\/$/, "");
+    this.#getAccessToken = options.getAccessToken ?? (() => null);
+    this.#getOrganizationId = options.getOrganizationId;
+    this.#requestTimeoutMs = options.requestTimeoutMs ?? 3e4;
+    this.#journalFolder = options.journalFolder ?? "Transcripts/Browser Audio";
+    this.#api = createApi({
+      credentials: async () => {
+        const accessToken = await this.#getAccessToken();
+        return accessToken ? { kind: "user", accessToken } : null;
+      },
+      // One host-supplied origin answers every deployment.
+      resolveBaseUrl: () => baseUrl,
+      connectTimeoutMs: this.#requestTimeoutMs,
+      totalTimeoutMs: this.#requestTimeoutMs
+    });
+  }
+  async #resolveOrganizationId(token) {
+    const supplied = await this.#getOrganizationId?.();
+    if (supplied) return supplied;
+    if (this.#getOrganizationId) {
+      throw new Error(
+        "Audio recovery requires an authenticated organization scope."
+      );
+    }
+    if (this.#organizationToken !== token || !this.#organizationPromise) {
+      this.#organizationToken = token;
+      const organizationPromise = (async () => {
+        const identity = await whoami(this.#api);
+        if (!identity.authenticated || !identity.organization_id) {
+          throw new Error(
+            "Audio recovery requires an authenticated organization scope."
+          );
+        }
+        return identity.organization_id;
+      })();
+      const cachedPromise = organizationPromise.catch((error) => {
+        if (this.#organizationPromise === cachedPromise) {
+          this.#organizationPromise = null;
+        }
+        throw error;
+      });
+      this.#organizationPromise = cachedPromise;
+    }
+    return this.#organizationPromise;
+  }
+  /** Per-call options: the organization this signed-in person acts in. */
+  async #call(signal) {
+    const token = await this.#getAccessToken();
+    const options = signal ? { signal } : {};
+    if (token) options.organizationId = await this.#resolveOrganizationId(token);
+    return options;
+  }
+  async transcribe(file, signal) {
+    const form = new FormData();
+    form.append("file", file);
+    const result = await transcribeUpload(
+      this.#api,
+      { body: form },
+      await this.#call(signal)
+    );
+    return { ...result, text: result.text.trim() };
+  }
+  async transcribeFull(file, options) {
+    const recordingId = options?.recordingId ?? file.name.replace(/\.[^.]+$/, "");
+    const uploaded = await this.#upload(
+      file,
+      `${this.#journalFolder}/${recordingId}--recording.${file.name.split(".").pop() ?? "webm"}`,
+      {
+        audio_input_stage: "fallback",
+        recording_id: recordingId,
+        recording_origin: options?.origin,
+        ephemeral: false
+      }
+    );
+    this.#fullAudioUploads.set(recordingId, uploaded);
+    const result = await transcribeFile(
+      this.#api,
+      { body: { file_id: uploaded.file_id } },
+      await this.#call(options?.signal)
+    );
+    return { ...result, text: result.text.trim() };
+  }
+  async #upload(file, filePath, metadata) {
+    const form = new FormData();
+    form.append("file", file);
+    form.append("file_path", filePath);
+    form.append("published_to_web", "false");
+    form.append("shown_to", "only_me");
+    form.append("visibility", "personal");
+    form.append("metadata_json", JSON.stringify({ origin: "transcripts", ...metadata }));
+    return uploadFile(this.#api, { body: form }, await this.#call());
+  }
+  async journalChunk(input) {
+    const index = String(input.chunkIndex).padStart(4, "0");
+    const uploaded = await this.#upload(
+      input.file,
+      `${this.#journalFolder}/${input.recordingId}--chunk-${index}.${input.file.name.split(".").pop() ?? "webm"}`,
+      {
+        audio_input_stage: "chunk",
+        recording_id: input.recordingId,
+        chunk_index: input.chunkIndex,
+        recording_origin: input.origin,
+        ephemeral: true
+      }
+    );
+    try {
+      const journal = await createRecordingJournalChunk(
+        this.#api,
+        {
+          body: {
+            recording_id: input.recordingId,
+            chunk_index: input.chunkIndex,
+            file_id: uploaded.file_id,
+            mime_type: input.file.type,
+            size_bytes: input.file.size,
+            ...input.origin ? { origin: { ...input.origin } } : {}
+          }
+        },
+        await this.#call()
+      );
+      if (journal.replaced_file_id) {
+        await this.#deleteFile(journal.replaced_file_id);
+      }
+    } catch (error) {
+      await this.#deleteFile(uploaded.file_id);
+      throw error;
+    }
+  }
+  async finalize(input) {
+    const audioResult = this.#fullAudioUploads.get(input.recordingId) ?? await this.#upload(
+      input.audio,
+      `${this.#journalFolder}/${input.recordingId}--recording.${input.audio.name.split(".").pop() ?? "webm"}`,
+      {
+        audio_input_stage: "complete",
+        recording_id: input.recordingId,
+        recording_origin: input.origin,
+        ephemeral: false
+      }
+    );
+    const completion = await completeRecordingJournal(
+      this.#api,
+      {
+        path: { recording_id: input.recordingId },
+        body: {
+          transcript: input.transcript,
+          audio_file_id: audioResult.file_id,
+          duration_ms: input.durationMs,
+          ...input.origin ? { origin: { ...input.origin } } : {}
+        }
+      },
+      await this.#call()
+    );
+    const manifest = new File(
+      [
+        JSON.stringify({
+          recording_id: input.recordingId,
+          transcript: input.transcript,
+          audio_file_id: audioResult.file_id,
+          transcript_id: completion.transcript_id,
+          origin: input.origin,
+          completed_at: (/* @__PURE__ */ new Date()).toISOString()
+        })
+      ],
+      `${input.recordingId}--complete.json`,
+      { type: "application/json" }
+    );
+    await this.#upload(
+      manifest,
+      `${this.#journalFolder}/${manifest.name}`,
+      {
+        audio_input_stage: "manifest",
+        recording_id: input.recordingId,
+        ephemeral: false
+      }
+    );
+    this.#fullAudioUploads.delete(input.recordingId);
+  }
+  async listRecoverable() {
+    if (!await this.#getAccessToken()) return [];
+    const recordings = await getRecordingJournals(
+      this.#api,
+      void 0,
+      await this.#call()
+    );
+    return recordings.map((recording) => ({
+      recordingId: recording.recording_id,
+      updatedAt: Date.parse(recording.updated_at)
+    }));
+  }
+  async loadRecoverable(recordingId) {
+    const journal = await getRecordingJournal(
+      this.#api,
+      { path: { recording_id: recordingId } },
+      await this.#call()
+    );
+    const chunks = [...journal];
+    if (chunks.length === 0) return null;
+    chunks.sort((a, b) => a.chunk_index - b.chunk_index);
+    const parts = [];
+    const missingChunkIndices = [];
+    const highestIndex = chunks.at(-1)?.chunk_index ?? -1;
+    const journaledIndices = new Set(chunks.map((chunk) => chunk.chunk_index));
+    for (let index = 0; index <= highestIndex; index += 1) {
+      if (!journaledIndices.has(index)) missingChunkIndices.push(index);
+    }
+    for (const chunk of chunks) {
+      let blob;
+      try {
+        const response = await downloadFile(
+          this.#api,
+          { path: { file_id: chunk.file_id }, query: { inline: true } },
+          await this.#call()
+        );
+        blob = await response.blob();
+      } catch (error) {
+        if (!(error instanceof MatrxApiError)) throw error;
+        missingChunkIndices.push(chunk.chunk_index);
+        continue;
+      }
+      if (blob.size === 0) {
+        missingChunkIndices.push(chunk.chunk_index);
+        continue;
+      }
+      parts.push(blob);
+    }
+    if (parts.length === 0) return null;
+    return {
+      blob: new Blob(parts, { type: chunks[0]?.mime_type || "audio/webm" }),
+      missingChunkIndices: [...new Set(missingChunkIndices)].sort((a, b) => a - b)
+    };
+  }
+  async discard(recordingId) {
+    const result = await deleteRecordingJournal(
+      this.#api,
+      { path: { recording_id: recordingId } },
+      await this.#call()
+    );
+    for (const fileId of result.file_ids) {
+      await this.#deleteFile(fileId);
+    }
+  }
+  /** Best-effort cleanup of an orphaned file; a failed delete never masks the real outcome. */
+  async #deleteFile(fileId) {
+    try {
+      await filesDeleteFile(
+        this.#api,
+        { path: { file_id: fileId } },
+        await this.#call()
+      );
+    } catch {
+    }
+  }
+};
+function createMatrxAudioClient(options) {
+  return new MatrxAudioClient(options);
+}
+
+export { MatrxAudioClient, createMatrxAudioClient };

package/dist/schemas.d.cts

@@ -1,6 +1,6 @@
 /**
  * GENERATED by @ai-matrx/api scripts/generate.mjs from aidream/api-contract — never edit by hand.
- * CONTRACT_SHA256 a7cc7154fd90de65bc0e3e819210f0337696cb50814b5a366e64ecb1b00412e4
+ * CONTRACT_SHA256 118778e288a723f4114c0f189d3f0d25d8f399fdb49d9bbac475b5fcb9d808f6
  */
 /** Every schema reached from more than one domain (119). Types only — importing this costs nothing at runtime. */
 /** ActionNeeded */
@@ -896,6 +896,8 @@ type SandboxBindingRequest = {
     access_token: string;
     /** Workspace root inside the sandbox */
     root_path?: string;
+    /** local_machine: the computer's app_instances id (who the binding reaches), carried, never parsed from base_url. */
+    device_id?: string | null;
     /** Semantic filesystem namespace. This is explicit so routing never guesses the target OS or machine kind from path syntax. */
     target_kind?: "sandbox" | "local_machine";
 };
@@ -1219,6 +1221,7 @@ type UserOverrides = {
     remove?: string[];
     apply_policy?: ("auto" | "ask" | "off") | null;
     auto_tools?: boolean | null;
+    search_types?: string[];
 };
 /** UserVideoMediaPart */
 type UserVideoMediaPart = {

package/dist/schemas.d.ts

@@ -1,6 +1,6 @@
 /**
  * GENERATED by @ai-matrx/api scripts/generate.mjs from aidream/api-contract — never edit by hand.
- * CONTRACT_SHA256 a7cc7154fd90de65bc0e3e819210f0337696cb50814b5a366e64ecb1b00412e4
+ * CONTRACT_SHA256 118778e288a723f4114c0f189d3f0d25d8f399fdb49d9bbac475b5fcb9d808f6
  */
 /** Every schema reached from more than one domain (119). Types only — importing this costs nothing at runtime. */
 /** ActionNeeded */
@@ -896,6 +896,8 @@ type SandboxBindingRequest = {
     access_token: string;
     /** Workspace root inside the sandbox */
     root_path?: string;
+    /** local_machine: the computer's app_instances id (who the binding reaches), carried, never parsed from base_url. */
+    device_id?: string | null;
     /** Semantic filesystem namespace. This is explicit so routing never guesses the target OS or machine kind from path syntax. */
     target_kind?: "sandbox" | "local_machine";
 };
@@ -1219,6 +1221,7 @@ type UserOverrides = {
     remove?: string[];
     apply_policy?: ("auto" | "ask" | "off") | null;
     auto_tools?: boolean | null;
+    search_types?: string[];
 };
 /** UserVideoMediaPart */
 type UserVideoMediaPart = {