@xrkseek/harness 0.3.11 → 0.4.0-rc.2

package/node_modules/@xrkseek/exec-video-gen/dist/tools.js

@@ -0,0 +1,242 @@
+import { VIDEO_GEN_PROMPT_TEXT } from "./format.js";
+import { VideoGenError, isTerminalStatus, isVideoGenError, } from "./types.js";
+export { VIDEO_GEN_PROMPT_TEXT };
+const SIZES = [
+    "720x1280",
+    "1280x720",
+    "1024x1792",
+    "1792x1024",
+];
+const SECONDS = [4, 8, 12];
+const ACTIONS = ["start", "status", "content", "wait"];
+export function videoGenUnavailableMessage(env = process.env) {
+    const flag = String(env.XRK_VIDEO_GEN ?? "")
+        .trim()
+        .toLowerCase();
+    if (!flag) {
+        return ("Error: video generation is not enabled. Set XRK_VIDEO_GEN=memory (CI/demo) or " +
+            "XRK_VIDEO_GEN=1 with OPENAI_API_KEY / XRK_VIDEO_GEN_OPENAI_KEY. See docs/video-gen.md.");
+    }
+    if (flag === "1") {
+        return ("Error: XRK_VIDEO_GEN=1 but no API key. Set OPENAI_API_KEY or XRK_VIDEO_GEN_OPENAI_KEY " +
+            "(optional XRK_VIDEO_GEN_BASE_URL / XRK_VIDEO_GEN_MODEL).");
+    }
+    return "Error: no VideoGenService Provider is configured. Inject a service or set XRK_VIDEO_GEN.";
+}
+function fail(err) {
+    const message = isVideoGenError(err)
+        ? `Error: ${err.message}`
+        : `Error: ${err instanceof Error ? err.message : String(err)}`;
+    return { content: message, isError: true };
+}
+function clamp(value, min, max) {
+    return Math.min(Math.max(value, min), max);
+}
+function parseAction(raw) {
+    if (raw === undefined || raw === null || raw === "")
+        return "start";
+    const a = String(raw).trim().toLowerCase();
+    if (!ACTIONS.includes(a)) {
+        throw new VideoGenError(`action must be one of ${ACTIONS.join(", ")}`, "VIDEO_GEN_BAD_ARGS");
+    }
+    return a;
+}
+function parseSize(raw) {
+    if (raw === undefined || raw === null || raw === "")
+        return undefined;
+    const s = String(raw).trim();
+    if (!SIZES.includes(s)) {
+        throw new VideoGenError(`size must be one of ${SIZES.join(", ")}`, "VIDEO_GEN_BAD_ARGS");
+    }
+    return s;
+}
+function parseSeconds(raw) {
+    if (raw === undefined || raw === null || raw === "")
+        return undefined;
+    const n = Number(raw);
+    if (!SECONDS.includes(n)) {
+        throw new VideoGenError(`seconds must be one of ${SECONDS.join(", ")}`, "VIDEO_GEN_BAD_ARGS");
+    }
+    return n;
+}
+function formatJob(job) {
+    return [
+        `jobId=${job.jobId}`,
+        `status=${job.status}`,
+        job.progress !== undefined ? `progress=${job.progress}` : "",
+        job.error ? `error=${job.error}` : "",
+        job.model ? `model=${job.model}` : "",
+        job.seconds !== undefined ? `seconds=${job.seconds}` : "",
+        job.size ? `size=${job.size}` : "",
+        job.note ? `note=${job.note}` : "",
+    ]
+        .filter(Boolean)
+        .join("\n");
+}
+/**
+ * Model-facing `video_generate` tool.
+ *
+ * Video renders are asynchronous, so the tool exposes the job lifecycle rather
+ * than blocking a turn for minutes: `start` → `status` / `wait` → `content`.
+ */
+export function createVideoGenTools(options = {}) {
+    const missing = videoGenUnavailableMessage(options.env ?? process.env);
+    const service = options.service;
+    const attachments = options.attachments;
+    const now = options.now ?? (() => Date.now());
+    const sleep = options.sleep ??
+        ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+    const tool = {
+        name: "video_generate",
+        description: "Generate a video from a text prompt via the Host text-to-video Provider. Renders are asynchronous: " +
+            "action=start (default) returns a jobId, poll with action=status (or action=wait to block), then " +
+            "action=content downloads the MP4. The MP4 is saved to the Host attachment store when one is wired; " +
+            "video bytes are never inlined into tool text.",
+        parameters: {
+            type: "object",
+            properties: {
+                action: {
+                    type: "string",
+                    enum: [...ACTIONS],
+                    description: "start (default) | status | content | wait. start needs `prompt`; the others need `job_id`.",
+                },
+                prompt: {
+                    type: "string",
+                    description: "Complete visual prompt for action=start (subject, motion, camera, lighting).",
+                },
+                job_id: {
+                    type: "string",
+                    description: "Job id returned by action=start.",
+                },
+                model: {
+                    type: "string",
+                    description: "Optional model override (e.g. sora-2, sora-2-pro).",
+                },
+                seconds: {
+                    type: "number",
+                    enum: [...SECONDS],
+                    description: "Clip duration in seconds (default 4).",
+                },
+                size: {
+                    type: "string",
+                    enum: [...SIZES],
+                    description: "Output size (provider-dependent; default 1280x720).",
+                },
+                timeout_ms: {
+                    type: "number",
+                    description: "action=wait: give up after this long (default 120000).",
+                },
+                poll_interval_ms: {
+                    type: "number",
+                    description: "action=wait: poll spacing (default 10000).",
+                },
+            },
+        },
+        presentCall: (args) => ({
+            card: "generic",
+            title: "Video generate",
+            kind: "execute",
+            rawInput: args,
+        }),
+        async execute(args) {
+            if (!service)
+                return { content: missing, isError: true };
+            try {
+                const action = parseAction(args.action);
+                if (action === "start") {
+                    const prompt = String(args.prompt ?? "").trim();
+                    if (!prompt) {
+                        throw new VideoGenError("prompt is required for action=start", "VIDEO_GEN_BAD_ARGS");
+                    }
+                    const seconds = parseSeconds(args.seconds);
+                    const size = parseSize(args.size);
+                    const job = await service.create({
+                        prompt,
+                        ...(seconds !== undefined ? { seconds } : {}),
+                        ...(size ? { size } : {}),
+                        ...(args.model ? { model: String(args.model) } : {}),
+                    });
+                    return {
+                        content: [
+                            `provider=${job.provider} delivery=${job.delivery}`,
+                            formatJob(job),
+                            "Next: action=status with job_id until status=completed, then action=content.",
+                        ].join("\n"),
+                    };
+                }
+                const jobId = String(args.job_id ?? "").trim();
+                if (!jobId) {
+                    throw new VideoGenError(`job_id is required for action=${action}`, "VIDEO_GEN_BAD_ARGS");
+                }
+                if (action === "status") {
+                    const job = await service.get(jobId);
+                    return { content: formatJob(job), isError: job.status === "failed" };
+                }
+                if (action === "wait") {
+                    const timeoutMs = clamp(args.timeout_ms ?? 120_000, 1_000, 600_000);
+                    const interval = clamp(args.poll_interval_ms ?? 10_000, 250, 60_000);
+                    const deadline = now() + timeoutMs;
+                    let job = await service.get(jobId);
+                    while (!isTerminalStatus(job.status) && now() < deadline) {
+                        await sleep(interval);
+                        job = await service.get(jobId);
+                    }
+                    const timedOut = !isTerminalStatus(job.status);
+                    return {
+                        content: [
+                            timedOut ? `timeout=true waited_ms=${timeoutMs}` : "",
+                            formatJob(job),
+                        ]
+                            .filter(Boolean)
+                            .join("\n"),
+                        isError: job.status === "failed",
+                    };
+                }
+                // action=content
+                try {
+                    const media = await service.content(jobId);
+                    let attachmentId;
+                    let fileName;
+                    if (attachments) {
+                        const ref = await attachments.saveFile({
+                            data: media.bytes,
+                            mediaType: media.mimeType,
+                            name: `video_generate_${jobId}.mp4`,
+                        });
+                        attachmentId = ref.attachmentId;
+                        fileName = ref.name;
+                    }
+                    return {
+                        content: [
+                            `jobId=${jobId} provider=${media.provider} mime=${media.mimeType} bytes=${media.bytes.byteLength}`,
+                            media.note ? `note=${media.note}` : "",
+                            attachmentId ? `attachmentId=${attachmentId}` : "",
+                            fileName ? `file=${fileName}` : "",
+                            attachmentId
+                                ? ""
+                                : "note=no AttachmentStore is wired; the MP4 is not persisted and cannot be returned inline.",
+                        ]
+                            .filter(Boolean)
+                            .join("\n"),
+                    };
+                }
+                catch (err) {
+                    if (isVideoGenError(err) && err.code === "VIDEO_GEN_NOT_READY") {
+                        const job = await service.get(jobId).catch(() => undefined);
+                        return {
+                            content: ["not_ready=true", job ? formatJob(job) : `jobId=${jobId}`]
+                                .filter(Boolean)
+                                .join("\n"),
+                        };
+                    }
+                    throw err;
+                }
+            }
+            catch (err) {
+                return fail(err);
+            }
+        },
+    };
+    return [tool];
+}
+//# sourceMappingURL=tools.js.map

package/node_modules/@xrkseek/exec-video-gen/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}

package/node_modules/@xrkseek/exec-video-gen/dist/types.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Text-to-video Provider seam — model tool `video_generate`.
+ *
+ * Unlike text-to-image, every real backend renders **asynchronously**: a create
+ * call returns a job, the job is polled until it reaches a terminal state, and
+ * only then can the media be downloaded. The seam models that shape directly
+ * (see OpenAI `POST /videos` → `GET /videos/{id}` → `GET /videos/{id}/content`)
+ * instead of hiding a multi-minute render behind a single blocking call.
+ */
+export type VideoGenDelivery = "memory" | "openai" | "unavailable";
+export type VideoGenErrorCode = "VIDEO_GEN_UNAVAILABLE" | "VIDEO_GEN_BAD_ARGS" | "VIDEO_GEN_BACKEND"
+/** Job exists but has not reached `completed`; media cannot be fetched yet. */
+ | "VIDEO_GEN_NOT_READY";
+export declare class VideoGenError extends Error {
+    readonly code: VideoGenErrorCode;
+    constructor(message: string, code?: VideoGenErrorCode);
+}
+export declare function isVideoGenError(err: unknown): err is VideoGenError;
+/** Clip duration in seconds (provider-enumerated, not free-form). */
+export type VideoGenSeconds = 4 | 8 | 12;
+export type VideoGenSize = "720x1280" | "1280x720" | "1024x1792" | "1792x1024";
+export type VideoGenStatus = "queued" | "in_progress" | "completed" | "failed";
+export interface VideoGenRequest {
+    readonly prompt: string;
+    readonly model?: string;
+    readonly seconds?: VideoGenSeconds;
+    readonly size?: VideoGenSize;
+}
+export interface VideoGenJob {
+    readonly jobId: string;
+    readonly status: VideoGenStatus;
+    /** Approximate completion percentage when the Provider reports one. */
+    readonly progress?: number;
+    readonly model?: string;
+    readonly seconds?: number;
+    readonly size?: string;
+    /** Provider error text when `status === "failed"`. */
+    readonly error?: string;
+    readonly provider: string;
+    readonly delivery: VideoGenDelivery;
+    readonly note?: string;
+}
+export interface VideoGenContent {
+    readonly bytes: Uint8Array;
+    readonly mimeType: "video/mp4";
+    readonly provider: string;
+    readonly note?: string;
+}
+/**
+ * Definition: text-to-video Provider (async job lifecycle).
+ * Tools always register; a missing Provider → honest execute error.
+ */
+export interface VideoGenService {
+    /** Start a render; resolves as soon as the job is accepted. */
+    create(req: VideoGenRequest): Promise<VideoGenJob>;
+    /** Poll one job's current state. */
+    get(jobId: string): Promise<VideoGenJob>;
+    /**
+     * Download the finished MP4.
+     * @throws VideoGenError `VIDEO_GEN_NOT_READY` until the job is `completed`.
+     */
+    content(jobId: string): Promise<VideoGenContent>;
+}
+/** True once the job can no longer change state. */
+export declare function isTerminalStatus(status: VideoGenStatus): boolean;
+//# sourceMappingURL=types.d.ts.map

package/node_modules/@xrkseek/exec-video-gen/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,QAAQ,GAAG,aAAa,CAAC;AAEnE,MAAM,MAAM,iBAAiB,GACzB,uBAAuB,GACvB,oBAAoB,GACpB,mBAAmB;AACrB,+EAA+E;GAC7E,qBAAqB,CAAC;AAE1B,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;gBAErB,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,iBAAuC;CAK3E;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,aAAa,CAElE;AAED,qEAAqE;AACrE,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;AAEzC,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,CAAC;AAE/E,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,aAAa,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE/E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC;CAC9B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,sDAAsD;IACtD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,+DAA+D;IAC/D,MAAM,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACnD,oCAAoC;IACpC,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACzC;;;OAGG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAClD;AAED,oDAAoD;AACpD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAEhE"}

package/node_modules/@xrkseek/exec-video-gen/dist/types.js

@@ -0,0 +1,25 @@
+/**
+ * Text-to-video Provider seam — model tool `video_generate`.
+ *
+ * Unlike text-to-image, every real backend renders **asynchronously**: a create
+ * call returns a job, the job is polled until it reaches a terminal state, and
+ * only then can the media be downloaded. The seam models that shape directly
+ * (see OpenAI `POST /videos` → `GET /videos/{id}` → `GET /videos/{id}/content`)
+ * instead of hiding a multi-minute render behind a single blocking call.
+ */
+export class VideoGenError extends Error {
+    code;
+    constructor(message, code = "VIDEO_GEN_BACKEND") {
+        super(message);
+        this.name = "VideoGenError";
+        this.code = code;
+    }
+}
+export function isVideoGenError(err) {
+    return err instanceof VideoGenError;
+}
+/** True once the job can no longer change state. */
+export function isTerminalStatus(status) {
+    return status === "completed" || status === "failed";
+}
+//# sourceMappingURL=types.js.map

package/node_modules/@xrkseek/exec-video-gen/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAWH,MAAM,OAAO,aAAc,SAAQ,KAAK;IAC7B,IAAI,CAAoB;IAEjC,YAAY,OAAe,EAAE,OAA0B,mBAAmB;QACxE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,OAAO,GAAG,YAAY,aAAa,CAAC;AACtC,CAAC;AAsDD,oDAAoD;AACpD,MAAM,UAAU,gBAAgB,CAAC,MAAsB;IACrD,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,KAAK,QAAQ,CAAC;AACvD,CAAC"}

package/node_modules/@xrkseek/exec-video-gen/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@xrkseek/exec-video-gen",
+  "version": "0.1.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@xrkseek/attachment": "workspace:*",
+    "@xrkseek/core-tools": "workspace:*"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xrkseek/XRK-harness.git",
+    "directory": "packages/exec/video-gen"
+  },
+  "private": true
+}

package/node_modules/@xrkseek/exec-voice/README.md

@@ -0,0 +1,25 @@
+# @xrkseek/exec-voice
+
+Voice Host seam: TTS · dictation (STT) · realtime voice session broker.
+
+- **Definition**: `VoiceService` (`synthesize` · `transcribe` · `createLiveSession` · `liveStatus`)
+- **Provider**: `createMemoryVoiceProvider` · `createOpenAiVoiceProvider` · Host-injected
+- **Consumer**: `createVoiceTools` → `text_to_speech` · `voice_transcribe` · `voice_session`
+
+Mic/speaker and WebRTC stay on the client. Tools stay registered when no Provider is configured; execute fails honestly.
+
+Env: `XRK_VOICE=memory` | `XRK_VOICE=1` + `OPENAI_API_KEY` / `XRK_VOICE_OPENAI_KEY`.
+
+## Browser mic transport
+
+`@xrkseek/exec-voice/browser` is the client-side capture seam: DOM-free structural types with every
+capability injected through `BrowserVoiceDeps` (`getUserMedia` · `MediaRecorder` · `PeerConnection` · `btoa`).
+
+- `createBrowserVoiceTransport(deps)` → `capabilities()` · `dictate()` / `openDictation()` · `session({ broker })`
+- `startDictation` · `dictateOnce` · `pickRecorderMime` · `encodeBase64`
+- `startVoiceSession` — local SDP offer → Host broker → answer; `stop()` releases the mic and closes the peer connection
+
+Audio never transits the Host. A denied mic → `VOICE_BACKEND`; a missing API (insecure context / SSR) →
+`VOICE_UNAVAILABLE`; a client-secret-only broker answer → `VOICE_LIVE_UNSUPPORTED`.
+
+See [docs/voice.md](../../../docs/voice.md) · [docs/seams.md](../../../docs/seams.md).

package/node_modules/@xrkseek/exec-voice/dist/browser/dictation.d.ts

@@ -0,0 +1,44 @@
+import type { BrowserVoiceDeps } from "./types.js";
+/**
+ * Preferred recorder containers, best first. Whisper-style STT accepts
+ * webm/opus, ogg/opus and mp4, so the negotiation order is opus-first.
+ */
+export declare const RECORDER_MIME_CANDIDATES: readonly string[];
+/** First candidate the recorder accepts; `undefined` lets it pick its default. */
+export declare function pickRecorderMime(isTypeSupported?: (mimeType: string) => boolean): string | undefined;
+export interface DictationResult {
+    readonly bytes: Uint8Array;
+    readonly mimeType: string;
+    readonly durationMs: number;
+}
+export interface DictationRecorder {
+    /** Container the recorder reports once recording has begun. */
+    readonly mimeType: string;
+    isRecording(): boolean;
+    /** Finalize and return the audio; the mic is released either way. */
+    stop(): Promise<DictationResult>;
+    /** Abandon the take and release the mic without producing audio. */
+    cancel(): void;
+}
+export interface StartDictationOptions {
+    readonly deps?: BrowserVoiceDeps;
+    /** Force a container instead of negotiating with the recorder. */
+    readonly mimeType?: string;
+    /** `MediaRecorder.start(timeslice)`; omit to buffer until `stop`. */
+    readonly timesliceMs?: number;
+    readonly now?: () => number;
+}
+/**
+ * Acquire the mic and begin recording. Rejects (with `VoiceError`) when the
+ * browser lacks the APIs or the user denies permission — nothing is recorded.
+ */
+export declare function startDictation(options?: StartDictationOptions): Promise<DictationRecorder>;
+export interface DictateOnceOptions extends StartDictationOptions {
+    /** Milliseconds to record before auto-stopping (default 15000). */
+    readonly maxDurationMs?: number;
+}
+/** Record a single take with a safety cap, returning bytes + Base64. */
+export declare function dictateOnce(options?: DictateOnceOptions): Promise<DictationResult & {
+    readonly base64: string;
+}>;
+//# sourceMappingURL=dictation.d.ts.map

package/node_modules/@xrkseek/exec-voice/dist/browser/dictation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dictation.d.ts","sourceRoot":"","sources":["../../src/browser/dictation.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACV,gBAAgB,EAIjB,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,SAAS,MAAM,EAKrD,CAAC;AAEF,kFAAkF;AAClF,wBAAgB,gBAAgB,CAC9B,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,GAC9C,MAAM,GAAG,SAAS,CAMpB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,+DAA+D;IAC/D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,WAAW,IAAI,OAAO,CAAC;IACvB,qEAAqE;IACrE,IAAI,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;IACjC,oEAAoE;IACpE,MAAM,IAAI,IAAI,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACjC,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,qEAAqE;IACrE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,iBAAiB,CAAC,CAgI5B;AAED,MAAM,WAAW,kBAAmB,SAAQ,qBAAqB;IAC/D,mEAAmE;IACnE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,wEAAwE;AACxE,wBAAsB,WAAW,CAC/B,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,eAAe,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAkBxD"}

package/node_modules/@xrkseek/exec-voice/dist/browser/dictation.js

@@ -0,0 +1,163 @@
+/**
+ * Push-to-talk dictation capture: mic → encoded audio bytes for `voice_transcribe`.
+ * Recording never leaves the client; only the finished bytes are handed back.
+ */
+import { VoiceError } from "../types.js";
+import { encodeBase64, micError, releaseStream, resolveGetUserMedia, resolveRecorder, } from "./env.js";
+/**
+ * Preferred recorder containers, best first. Whisper-style STT accepts
+ * webm/opus, ogg/opus and mp4, so the negotiation order is opus-first.
+ */
+export const RECORDER_MIME_CANDIDATES = [
+    "audio/webm;codecs=opus",
+    "audio/webm",
+    "audio/ogg;codecs=opus",
+    "audio/mp4",
+];
+/** First candidate the recorder accepts; `undefined` lets it pick its default. */
+export function pickRecorderMime(isTypeSupported) {
+    if (!isTypeSupported)
+        return RECORDER_MIME_CANDIDATES[0];
+    for (const candidate of RECORDER_MIME_CANDIDATES) {
+        if (isTypeSupported(candidate))
+            return candidate;
+    }
+    return undefined;
+}
+/**
+ * Acquire the mic and begin recording. Rejects (with `VoiceError`) when the
+ * browser lacks the APIs or the user denies permission — nothing is recorded.
+ */
+export async function startDictation(options = {}) {
+    const deps = options.deps ?? {};
+    const getUserMedia = resolveGetUserMedia(deps);
+    const Recorder = resolveRecorder(deps);
+    const now = options.now ?? (() => Date.now());
+    let stream;
+    try {
+        stream = await getUserMedia({ audio: true });
+    }
+    catch (err) {
+        throw micError(err);
+    }
+    const probe = Recorder.isTypeSupported;
+    const negotiated = options.mimeType ??
+        pickRecorderMime(typeof probe === "function" ? probe : undefined);
+    let recorder;
+    try {
+        recorder = negotiated
+            ? new Recorder(stream, { mimeType: negotiated })
+            : new Recorder(stream);
+    }
+    catch (err) {
+        releaseStream(stream);
+        throw new VoiceError(`MediaRecorder could not start${negotiated ? ` with ${negotiated}` : ""}: ${err instanceof Error ? err.message : String(err)}`, "VOICE_BACKEND");
+    }
+    const blobs = [];
+    let observedMime = recorder.mimeType || negotiated || "";
+    let failure;
+    let resolveStopped;
+    const stopped = new Promise((resolve) => {
+        resolveStopped = resolve;
+    });
+    recorder.ondataavailable = (event) => {
+        if (event.data && event.data.size > 0) {
+            blobs.push(event.data);
+            if (event.data.type)
+                observedMime = event.data.type;
+        }
+    };
+    recorder.onerror = (event) => {
+        const detail = event && typeof event === "object" && "name" in event
+            ? String(event.name ?? "")
+            : "";
+        failure = new VoiceError(`MediaRecorder error${detail ? ` (${detail})` : ""}`, "VOICE_BACKEND");
+        resolveStopped?.();
+    };
+    recorder.onstop = () => resolveStopped?.();
+    try {
+        recorder.start(options.timesliceMs);
+    }
+    catch (err) {
+        releaseStream(stream);
+        throw new VoiceError(`MediaRecorder.start failed: ${err instanceof Error ? err.message : String(err)}`, "VOICE_BACKEND");
+    }
+    const startedAt = now();
+    let phase = "recording";
+    let stopPromise;
+    const halt = () => {
+        try {
+            if (recorder.state !== "inactive")
+                recorder.stop();
+        }
+        catch {
+            // Stopping an already-dead recorder is not an error worth surfacing.
+        }
+    };
+    const finalize = async () => {
+        halt();
+        await stopped;
+        releaseStream(stream);
+        if (failure)
+            throw failure;
+        const durationMs = Math.max(0, now() - startedAt);
+        const parts = [];
+        for (const blob of blobs) {
+            parts.push(new Uint8Array(await blob.arrayBuffer()));
+        }
+        const total = parts.reduce((sum, part) => sum + part.length, 0);
+        if (total === 0) {
+            throw new VoiceError("no audio was captured", "VOICE_BAD_ARGS");
+        }
+        const bytes = new Uint8Array(total);
+        let offset = 0;
+        for (const part of parts) {
+            bytes.set(part, offset);
+            offset += part.length;
+        }
+        phase = "done";
+        return { bytes, mimeType: observedMime || "audio/webm", durationMs };
+    };
+    return {
+        mimeType: observedMime || "audio/webm",
+        isRecording: () => phase === "recording",
+        stop() {
+            if (phase === "cancelled") {
+                return Promise.reject(new VoiceError("dictation was cancelled", "VOICE_BAD_ARGS"));
+            }
+            // Repeated `stop()` calls (e.g. a duration cap racing the caller) share
+            // one finalize so the take is never assembled twice.
+            stopPromise ??= finalize();
+            return stopPromise;
+        },
+        cancel() {
+            if (phase === "done" || phase === "cancelled")
+                return;
+            phase = "cancelled";
+            halt();
+            releaseStream(stream);
+        },
+    };
+}
+/** Record a single take with a safety cap, returning bytes + Base64. */
+export async function dictateOnce(options = {}) {
+    const recorder = await startDictation(options);
+    const cap = options.maxDurationMs ?? 15_000;
+    const timer = cap > 0
+        ? setTimeout(() => {
+            void recorder.stop().catch(() => undefined);
+        }, cap)
+        : undefined;
+    try {
+        const result = await recorder.stop();
+        return {
+            ...result,
+            base64: encodeBase64(result.bytes, options.deps?.btoa),
+        };
+    }
+    finally {
+        if (timer !== undefined)
+            clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=dictation.js.map

package/node_modules/@xrkseek/exec-voice/dist/browser/dictation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dictation.js","sourceRoot":"","sources":["../../src/browser/dictation.ts"],"names":[],"mappings":"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"}