@xrkseek/harness 0.3.11 → 0.4.0-rc.2

package/node_modules/@xrkseek/exec-video-gen/README.md

@@ -0,0 +1,19 @@
+# @xrkseek/exec-video-gen
+
+Text-to-video Provider seam for the model tool surface.
+
+- **Definition**: `VideoGenService` — `create` · `get` · `content` (async job lifecycle)
+- **Provider**: `createMemoryVideoGenProvider` · `createOpenAiVideoGenProvider` · Host-injected
+- **Consumer**: `createVideoGenTools` → `video_generate`
+
+Renders are asynchronous, so the seam exposes job semantics instead of one-shot bytes:
+`create` returns a `jobId`, `get` polls status, and `content` downloads the MP4 once
+`status=completed` (an early `content` call raises `VIDEO_GEN_NOT_READY`).
+
+Env: `XRK_VIDEO_GEN=memory` | `XRK_VIDEO_GEN=1` + `OPENAI_API_KEY` / `XRK_VIDEO_GEN_OPENAI_KEY`
+(optional `XRK_VIDEO_GEN_BASE_URL` · `XRK_VIDEO_GEN_MODEL`).
+
+Video bytes are never inlined into tool text; with an `AttachmentStore` the finished MP4 is
+persisted via `saveFile` and returned as an attachment id.
+
+See [docs/video-gen.md](../../../docs/video-gen.md) · [docs/seams.md](../../../docs/seams.md).

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

@@ -0,0 +1,2 @@
+export declare const VIDEO_GEN_PROMPT_TEXT: string;
+//# sourceMappingURL=format.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,QAMtB,CAAC"}

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

@@ -0,0 +1,8 @@
+export const VIDEO_GEN_PROMPT_TEXT = [
+    "Video generation:",
+    "- Use `video_generate` for text-to-video. Renders are **asynchronous**: `action=start` (default) returns a `jobId`; poll with `action=status` (or `action=wait` to block) until `status=completed`; then `action=content` downloads the MP4.",
+    "- Put a complete visual prompt in `prompt` (subject, motion, camera, lighting). Optional `seconds` (4 · 8 · 12) and `size` (e.g. 1280x720).",
+    "- Video renders take minutes — call `start`, then poll `status` instead of blocking the turn.",
+    "- Without `XRK_VIDEO_GEN=1` (OpenAI key) or `XRK_VIDEO_GEN=memory`, the tool stays visible and fails honestly.",
+].join("\n");
+//# sourceMappingURL=format.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,mBAAmB;IACnB,8OAA8O;IAC9O,6IAA6I;IAC7I,+FAA+F;IAC/F,gHAAgH;CACjH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC"}

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

@@ -0,0 +1,24 @@
+import type { VideoGenService } from "./types.js";
+export { VideoGenError, isTerminalStatus, isVideoGenError, type VideoGenContent, type VideoGenDelivery, type VideoGenErrorCode, type VideoGenJob, type VideoGenRequest, type VideoGenSeconds, type VideoGenService, type VideoGenSize, type VideoGenStatus, } from "./types.js";
+export { VIDEO_GEN_PROMPT_TEXT } from "./format.js";
+export { createMemoryVideoGenProvider, minimalMp4Bytes, type MemoryVideoGenOptions, } from "./memory.js";
+export { createOpenAiVideoGenProvider, type OpenAiVideoGenOptions, } from "./openai-http.js";
+export { createVideoGenTools, videoGenUnavailableMessage, type CreateVideoGenToolsOptions, } from "./tools.js";
+export interface DefaultVideoGenAccessOptions {
+    readonly env?: NodeJS.ProcessEnv;
+    readonly service?: VideoGenService;
+    readonly fetchImpl?: typeof fetch;
+}
+export interface DefaultVideoGenAccess {
+    readonly service?: VideoGenService;
+    readonly unavailableMessage: string;
+}
+/**
+ * Resolve a text-to-video Provider.
+ * - Injected `service` wins.
+ * - `XRK_VIDEO_GEN=memory` → in-memory Provider.
+ * - `XRK_VIDEO_GEN=1` + API key → OpenAI Videos API (Sora).
+ * - Else no service; tools stay registered and fail honestly.
+ */
+export declare function createDefaultVideoGenAccess(options?: DefaultVideoGenAccessOptions): DefaultVideoGenAccess;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGlD,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,cAAc,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EACL,4BAA4B,EAC5B,eAAe,EACf,KAAK,qBAAqB,GAC3B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,4BAA4B,EAC5B,KAAK,qBAAqB,GAC3B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,KAAK,0BAA0B,GAChC,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CACnC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;CACrC;AASD;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,GAAE,4BAAiC,GACzC,qBAAqB,CAiCvB"}

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

@@ -0,0 +1,57 @@
+import { createMemoryVideoGenProvider } from "./memory.js";
+import { createOpenAiVideoGenProvider } from "./openai-http.js";
+import { videoGenUnavailableMessage } from "./tools.js";
+export { VideoGenError, isTerminalStatus, isVideoGenError, } from "./types.js";
+export { VIDEO_GEN_PROMPT_TEXT } from "./format.js";
+export { createMemoryVideoGenProvider, minimalMp4Bytes, } from "./memory.js";
+export { createOpenAiVideoGenProvider, } from "./openai-http.js";
+export { createVideoGenTools, videoGenUnavailableMessage, } from "./tools.js";
+function resolveApiKey(env) {
+    const a = String(env.XRK_VIDEO_GEN_OPENAI_KEY ?? "").trim();
+    if (a)
+        return a;
+    const b = String(env.OPENAI_API_KEY ?? "").trim();
+    return b || undefined;
+}
+/**
+ * Resolve a text-to-video Provider.
+ * - Injected `service` wins.
+ * - `XRK_VIDEO_GEN=memory` → in-memory Provider.
+ * - `XRK_VIDEO_GEN=1` + API key → OpenAI Videos API (Sora).
+ * - Else no service; tools stay registered and fail honestly.
+ */
+export function createDefaultVideoGenAccess(options = {}) {
+    const env = options.env ?? process.env;
+    const unavailableMessage = videoGenUnavailableMessage(env);
+    if (options.service) {
+        return { service: options.service, unavailableMessage };
+    }
+    const flag = String(env.XRK_VIDEO_GEN ?? "")
+        .trim()
+        .toLowerCase();
+    if (flag === "memory") {
+        return {
+            service: createMemoryVideoGenProvider(),
+            unavailableMessage,
+        };
+    }
+    if (flag === "1") {
+        const apiKey = resolveApiKey(env);
+        if (!apiKey) {
+            return { unavailableMessage };
+        }
+        const baseUrl = String(env.XRK_VIDEO_GEN_BASE_URL ?? "").trim();
+        const model = String(env.XRK_VIDEO_GEN_MODEL ?? "").trim();
+        return {
+            service: createOpenAiVideoGenProvider({
+                apiKey,
+                ...(baseUrl ? { baseUrl } : {}),
+                ...(model ? { model } : {}),
+                ...(options.fetchImpl ? { fetchImpl: options.fetchImpl } : {}),
+            }),
+            unavailableMessage,
+        };
+    }
+    return { unavailableMessage };
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AAEhE,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAExD,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,eAAe,GAUhB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EACL,4BAA4B,EAC5B,eAAe,GAEhB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,4BAA4B,GAE7B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,mBAAmB,EACnB,0BAA0B,GAE3B,MAAM,YAAY,CAAC;AAapB,SAAS,aAAa,CAAC,GAAsB;IAC3C,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,wBAAwB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5D,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IAChB,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAClD,OAAO,CAAC,IAAI,SAAS,CAAC;AACxB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B,CACzC,UAAwC,EAAE;IAE1C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,MAAM,kBAAkB,GAAG,0BAA0B,CAAC,GAAG,CAAC,CAAC;IAC3D,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC1D,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE,CAAC;SACzC,IAAI,EAAE;SACN,WAAW,EAAE,CAAC;IACjB,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,OAAO;YACL,OAAO,EAAE,4BAA4B,EAAE;YACvC,kBAAkB;SACnB,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;QACjB,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,EAAE,kBAAkB,EAAE,CAAC;QAChC,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,sBAAsB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAChE,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3D,OAAO;YACL,OAAO,EAAE,4BAA4B,CAAC;gBACpC,MAAM;gBACN,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/B,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3B,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC/D,CAAC;YACF,kBAAkB;SACnB,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAChC,CAAC"}

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

@@ -0,0 +1,20 @@
+import type { VideoGenService } from "./types.js";
+/**
+ * Minimal MP4: a lone `ftyp` box (24 bytes). Enough for a stable format
+ * signature without shipping a real encode in CI.
+ */
+export declare function minimalMp4Bytes(): Uint8Array;
+export interface MemoryVideoGenOptions {
+    readonly note?: string;
+    /**
+     * Fail the job once `get` has been polled this many times. Omit to always
+     * succeed — a test hook for the terminal-failure path.
+     */
+    readonly failAfter?: number;
+}
+/**
+ * Deterministic in-memory Provider for CI / demos (`XRK_VIDEO_GEN=memory`).
+ * Models the async lifecycle without any network or encoder.
+ */
+export declare function createMemoryVideoGenProvider(options?: MemoryVideoGenOptions): VideoGenService;
+//# sourceMappingURL=memory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,eAAe,EAEhB,MAAM,YAAY,CAAC;AAGpB;;;GAGG;AACH,wBAAgB,eAAe,IAAI,UAAU,CAU5C;AAmBD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,GAAE,qBAA0B,GAClC,eAAe,CAqFjB"}

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

@@ -0,0 +1,105 @@
+import { VideoGenError } from "./types.js";
+/**
+ * Minimal MP4: a lone `ftyp` box (24 bytes). Enough for a stable format
+ * signature without shipping a real encode in CI.
+ */
+export function minimalMp4Bytes() {
+    const bytes = new Uint8Array(24);
+    const view = new DataView(bytes.buffer);
+    view.setUint32(0, 24); // box size
+    bytes.set([0x66, 0x74, 0x79, 0x70], 4); // 'ftyp'
+    bytes.set([0x69, 0x73, 0x6f, 0x6d], 8); // major brand 'isom'
+    view.setUint32(12, 0x200); // minor version
+    bytes.set([0x69, 0x73, 0x6f, 0x6d], 16); // compatible brand 'isom'
+    bytes.set([0x69, 0x73, 0x6f, 0x32], 20); // compatible brand 'iso2'
+    return bytes;
+}
+/** Each `get` advances one step, so polling reaches `completed` deterministically. */
+const PROGRESS_STEPS = [
+    { status: "in_progress", progress: 33 },
+    { status: "in_progress", progress: 66 },
+    { status: "completed", progress: 100 },
+];
+/**
+ * Deterministic in-memory Provider for CI / demos (`XRK_VIDEO_GEN=memory`).
+ * Models the async lifecycle without any network or encoder.
+ */
+export function createMemoryVideoGenProvider(options = {}) {
+    const jobs = new Map();
+    let seq = 0;
+    const record = (jobId) => {
+        const id = String(jobId ?? "").trim();
+        const rec = jobs.get(id);
+        if (!rec) {
+            throw new VideoGenError(`unknown video job: ${id}`, "VIDEO_GEN_BAD_ARGS");
+        }
+        return rec;
+    };
+    const view = (rec) => {
+        const step = PROGRESS_STEPS[Math.min(rec.step, PROGRESS_STEPS.length - 1)];
+        const failed = options.failAfter !== undefined && rec.polls >= options.failAfter;
+        const status = failed ? "failed" : step.status;
+        return {
+            jobId: rec.id,
+            status,
+            ...(failed
+                ? { error: "memory provider: simulated render failure" }
+                : { progress: step.progress }),
+            model: rec.model,
+            seconds: rec.seconds,
+            size: rec.size,
+            provider: "memory",
+            delivery: "memory",
+            note: options.note ?? `memory-video-gen:${rec.prompt.slice(0, 80)}`,
+        };
+    };
+    return {
+        async create(req) {
+            const prompt = String(req.prompt ?? "").trim();
+            if (!prompt) {
+                throw new VideoGenError("prompt is empty", "VIDEO_GEN_BAD_ARGS");
+            }
+            const rec = {
+                id: `video_mem_${(++seq).toString(16)}`,
+                prompt,
+                model: req.model ?? "sora-2",
+                seconds: req.seconds ?? 4,
+                size: req.size ?? "1280x720",
+                step: 0,
+                polls: 0,
+            };
+            jobs.set(rec.id, rec);
+            return {
+                jobId: rec.id,
+                status: "queued",
+                progress: 0,
+                model: rec.model,
+                seconds: rec.seconds,
+                size: rec.size,
+                provider: "memory",
+                delivery: "memory",
+                note: `memory-video-gen queued:${prompt.slice(0, 80)}`,
+            };
+        },
+        async get(jobId) {
+            const rec = record(jobId);
+            rec.polls += 1;
+            rec.step += 1;
+            return view(rec);
+        },
+        async content(jobId) {
+            const rec = record(jobId);
+            const job = view(rec);
+            if (job.status !== "completed") {
+                throw new VideoGenError(`video job ${rec.id} is ${job.status}, not completed`, "VIDEO_GEN_NOT_READY");
+            }
+            return {
+                bytes: minimalMp4Bytes(),
+                mimeType: "video/mp4",
+                provider: "memory",
+                note: `memory-video:${rec.id}`,
+            };
+        },
+    };
+}
+//# sourceMappingURL=memory.js.map

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

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

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

@@ -0,0 +1,16 @@
+/**
+ * OpenAI Videos API Provider (Sora): `POST /videos` → `GET /videos/{id}` →
+ * `GET /videos/{id}/content`, the documented async render lifecycle.
+ * @see https://developers.openai.com/api/docs/guides/video-generation
+ */
+import type { VideoGenSeconds, VideoGenService, VideoGenSize } from "./types.js";
+export interface OpenAiVideoGenOptions {
+    readonly apiKey: string;
+    readonly baseUrl?: string;
+    readonly fetchImpl?: typeof fetch;
+    readonly model?: string;
+    readonly defaultSeconds?: VideoGenSeconds;
+    readonly defaultSize?: VideoGenSize;
+}
+export declare function createOpenAiVideoGenProvider(options: OpenAiVideoGenOptions): VideoGenService;
+//# sourceMappingURL=openai-http.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openai-http.d.ts","sourceRoot":"","sources":["../src/openai-http.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAIV,eAAe,EACf,eAAe,EACf,YAAY,EAEb,MAAM,YAAY,CAAC;AAGpB,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,CAAC,EAAE,eAAe,CAAC;IAC1C,QAAQ,CAAC,WAAW,CAAC,EAAE,YAAY,CAAC;CACrC;AA2DD,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,qBAAqB,GAC7B,eAAe,CA2FjB"}

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

@@ -0,0 +1,113 @@
+import { VideoGenError } from "./types.js";
+const STATUSES = [
+    "queued",
+    "in_progress",
+    "completed",
+    "failed",
+];
+function joinUrl(base, path) {
+    return `${base.replace(/\/+$/, "")}/${path.replace(/^\/+/, "")}`;
+}
+function parseJob(json) {
+    const row = (json ?? {});
+    const jobId = String(row.id ?? "").trim();
+    if (!jobId) {
+        throw new VideoGenError("OpenAI video response missing id", "VIDEO_GEN_BACKEND");
+    }
+    const status = String(row.status ?? "").trim();
+    if (!STATUSES.includes(status)) {
+        throw new VideoGenError(`OpenAI video status unknown: ${String(row.status ?? "")}`, "VIDEO_GEN_BACKEND");
+    }
+    const progress = typeof row.progress === "number" && Number.isFinite(row.progress)
+        ? Math.trunc(row.progress)
+        : undefined;
+    const seconds = row.seconds !== undefined ? Number(row.seconds) : undefined;
+    const message = row.error && typeof row.error === "object"
+        ? String(row.error.message ?? "").trim()
+        : "";
+    return {
+        jobId,
+        status,
+        ...(progress !== undefined ? { progress } : {}),
+        ...(row.model ? { model: String(row.model) } : {}),
+        ...(seconds !== undefined && Number.isFinite(seconds) ? { seconds } : {}),
+        ...(row.size ? { size: String(row.size) } : {}),
+        ...(message ? { error: message } : {}),
+        provider: "openai",
+        delivery: "openai",
+        note: `openai-videos status=${status}`,
+    };
+}
+export function createOpenAiVideoGenProvider(options) {
+    const baseUrl = (options.baseUrl ?? "https://api.openai.com/v1").replace(/\/+$/, "");
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const model = options.model ?? "sora-2";
+    const defaultSeconds = options.defaultSeconds ?? 4;
+    const defaultSize = options.defaultSize ?? "1280x720";
+    const auth = { Authorization: `Bearer ${options.apiKey}` };
+    const requireId = (jobId) => {
+        const id = String(jobId ?? "").trim();
+        if (!id) {
+            throw new VideoGenError("job id is empty", "VIDEO_GEN_BAD_ARGS");
+        }
+        return id;
+    };
+    const getJob = async (id) => {
+        const res = await fetchImpl(joinUrl(baseUrl, `videos/${encodeURIComponent(id)}`), {
+            method: "GET",
+            headers: auth,
+        });
+        if (!res.ok) {
+            const body = await res.text().catch(() => "");
+            throw new VideoGenError(`OpenAI video status HTTP ${res.status}: ${body.slice(0, 200)}`, "VIDEO_GEN_BACKEND");
+        }
+        return parseJob(await res.json());
+    };
+    return {
+        async create(req) {
+            const prompt = String(req.prompt ?? "").trim();
+            if (!prompt) {
+                throw new VideoGenError("prompt is empty", "VIDEO_GEN_BAD_ARGS");
+            }
+            const form = new FormData();
+            form.append("model", req.model ?? model);
+            form.append("prompt", prompt);
+            form.append("seconds", String(req.seconds ?? defaultSeconds));
+            form.append("size", req.size ?? defaultSize);
+            const res = await fetchImpl(joinUrl(baseUrl, "videos"), {
+                method: "POST",
+                headers: auth,
+                body: form,
+            });
+            if (!res.ok) {
+                const body = await res.text().catch(() => "");
+                throw new VideoGenError(`OpenAI videos HTTP ${res.status}: ${body.slice(0, 200)}`, "VIDEO_GEN_BACKEND");
+            }
+            return parseJob(await res.json());
+        },
+        async get(jobId) {
+            return getJob(requireId(jobId));
+        },
+        async content(jobId) {
+            const id = requireId(jobId);
+            // Confirm the render finished before pulling the (large) media body.
+            const job = await getJob(id);
+            if (job.status !== "completed") {
+                throw new VideoGenError(`video job ${id} is ${job.status}, not completed`, "VIDEO_GEN_NOT_READY");
+            }
+            const res = await fetchImpl(joinUrl(baseUrl, `videos/${encodeURIComponent(id)}/content`), { method: "GET", headers: auth });
+            if (!res.ok) {
+                const body = await res.text().catch(() => "");
+                throw new VideoGenError(`OpenAI video content HTTP ${res.status}: ${body.slice(0, 200)}`, "VIDEO_GEN_BACKEND");
+            }
+            const ab = await res.arrayBuffer();
+            return {
+                bytes: new Uint8Array(ab),
+                mimeType: "video/mp4",
+                provider: "openai",
+                note: `openai-videos bytes=${ab.byteLength}`,
+            };
+        },
+    };
+}
+//# sourceMappingURL=openai-http.js.map

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

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

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

@@ -0,0 +1,23 @@
+import type { AttachmentStore } from "@xrkseek/attachment";
+import type { ToolDefinition } from "@xrkseek/core-tools";
+import { VIDEO_GEN_PROMPT_TEXT } from "./format.js";
+import { type VideoGenService } from "./types.js";
+export { VIDEO_GEN_PROMPT_TEXT };
+export declare function videoGenUnavailableMessage(env?: NodeJS.ProcessEnv): string;
+export interface CreateVideoGenToolsOptions {
+    readonly service?: VideoGenService;
+    readonly env?: NodeJS.ProcessEnv;
+    /** When set, persist the finished MP4 and return an attachment id. */
+    readonly attachments?: AttachmentStore;
+    /** Injected sleep for `action=wait`; tests avoid real polling delays. */
+    readonly sleep?: (ms: number) => Promise<void>;
+    readonly now?: () => number;
+}
+/**
+ * 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 declare function createVideoGenTools(options?: CreateVideoGenToolsOptions): ToolDefinition[];
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAqB,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAML,KAAK,eAAe,EAErB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,qBAAqB,EAAE,CAAC;AAcjC,wBAAgB,0BAA0B,CACxC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,CAiBR;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,sEAAsE;IACtE,QAAQ,CAAC,WAAW,CAAC,EAAE,eAAe,CAAC;IACvC,yEAAyE;IACzE,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CAC7B;AA2ED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,0BAA+B,GACvC,cAAc,EAAE,CA6KlB"}