@lingjingai/scriptctl 0.35.0 → 0.36.0

package/dist/infra/ingest/workspace-store.d.ts

@@ -0,0 +1,18 @@
+export declare function atomicWrite(filePath: string, data: string | Buffer): void;
+export declare function writeJson(filePath: string, value: unknown): void;
+export declare function readJson<T = unknown>(filePath: string): T;
+export declare function exists(filePath: string): boolean;
+export declare class WorkspaceStore {
+    readonly root: string;
+    constructor(root: string);
+    private abs;
+    ensure(): void;
+    passDir(name: string): string;
+    readText(rel: string): string;
+    writeText(rel: string, data: string): void;
+    writeJson(rel: string, value: unknown): void;
+    readJson<T = unknown>(rel: string): T;
+    has(rel: string): boolean;
+    path(rel: string): string;
+    clearError(rel: string): void;
+}

package/dist/infra/ingest/workspace-store.js

@@ -0,0 +1,70 @@
+// Ingest workspace store (§5/§12.4). Owns the on-disk workspace: atomic writes
+// (same-dir temp + fsync + rename), pass directories, manifest and run_state.
+// All JSON is written atomically so a crash never leaves a half-written product.
+import * as fs from "node:fs";
+import * as path from "node:path";
+export function atomicWrite(filePath, data) {
+    const dir = path.dirname(filePath);
+    fs.mkdirSync(dir, { recursive: true });
+    const tmp = path.join(dir, `.${path.basename(filePath)}.${process.pid}.tmp`);
+    const fd = fs.openSync(tmp, "w");
+    try {
+        fs.writeFileSync(fd, data);
+        fs.fsyncSync(fd);
+    }
+    finally {
+        fs.closeSync(fd);
+    }
+    fs.renameSync(tmp, filePath);
+}
+export function writeJson(filePath, value) {
+    atomicWrite(filePath, JSON.stringify(value, null, 2) + "\n");
+}
+export function readJson(filePath) {
+    return JSON.parse(fs.readFileSync(filePath, "utf-8"));
+}
+export function exists(filePath) {
+    return fs.existsSync(filePath);
+}
+export class WorkspaceStore {
+    root;
+    constructor(root) {
+        this.root = root;
+    }
+    abs(rel) {
+        return path.join(this.root, rel);
+    }
+    ensure() {
+        fs.mkdirSync(this.root, { recursive: true });
+    }
+    passDir(name) {
+        const dir = this.abs(name);
+        fs.mkdirSync(dir, { recursive: true });
+        return dir;
+    }
+    readText(rel) {
+        return fs.readFileSync(this.abs(rel), "utf-8");
+    }
+    writeText(rel, data) {
+        atomicWrite(this.abs(rel), data);
+    }
+    writeJson(rel, value) {
+        writeJson(this.abs(rel), value);
+    }
+    readJson(rel) {
+        return readJson(this.abs(rel));
+    }
+    has(rel) {
+        return fs.existsSync(this.abs(rel));
+    }
+    path(rel) {
+        return this.abs(rel);
+    }
+    // Remove a unit's stale error sidecar after it succeeds (§5.3).
+    clearError(rel) {
+        const p = this.abs(rel);
+        if (fs.existsSync(p))
+            fs.rmSync(p);
+    }
+}
+//# sourceMappingURL=workspace-store.js.map

package/dist/infra/ingest/workspace-store.js.map

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

package/dist/infra/llm/anthropic-model.d.ts

@@ -0,0 +1,11 @@
+import type { LlmProviderConfig, LlmModelConfig } from "../../llm/config.js";
+import { type LlmAdapter, type TextGenerationRequest, type TextGenerationResponse, type ToolGenerationRequest, type ToolGenerationResponse } from "../../llm/types.js";
+export declare class AnthropicModel implements LlmAdapter {
+    private readonly provider;
+    private readonly model;
+    private readonly client;
+    constructor(provider: LlmProviderConfig, model: LlmModelConfig, apiKey: string);
+    private params;
+    generateText(request: TextGenerationRequest): Promise<TextGenerationResponse>;
+    generateTool(request: ToolGenerationRequest): Promise<ToolGenerationResponse>;
+}

package/dist/infra/llm/anthropic-model.js

@@ -0,0 +1,109 @@
+import Anthropic, { APIConnectionError, APIConnectionTimeoutError, APIError, APIUserAbortError } from "@anthropic-ai/sdk";
+import { LlmTransportError, } from "../../llm/types.js";
+import { withTransientRetry } from "./retry.js";
+function requestError(error) {
+    if (error instanceof LlmTransportError)
+        return error;
+    if (error instanceof APIUserAbortError)
+        return new LlmTransportError("request_failed", "Anthropic request was aborted.");
+    if (error instanceof APIConnectionTimeoutError)
+        return new LlmTransportError("timeout", "Anthropic request timed out.", { retryable: true });
+    if (error instanceof APIConnectionError)
+        return new LlmTransportError("request_failed", "Anthropic connection failed.", { retryable: true, details: [error.message.slice(0, 500)] });
+    if (error instanceof APIError) {
+        const status = error.status ?? 0;
+        const retryable = status === 408 || status === 429 || status >= 500;
+        const code = status === 401 || status === 403 ? "auth" : status === 429 ? "rate_limited" : "request_failed";
+        return new LlmTransportError(code, "Anthropic request failed.", { retryable, details: [`status: ${status}`, error.message.slice(0, 500)] });
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    return new LlmTransportError("request_failed", "Anthropic request failed.", { details: [message.slice(0, 500)] });
+}
+export class AnthropicModel {
+    provider;
+    model;
+    client;
+    constructor(provider, model, apiKey) {
+        this.provider = provider;
+        this.model = model;
+        const options = { apiKey };
+        if (provider.baseUrl)
+            options.baseURL = provider.baseUrl;
+        this.client = new Anthropic({ ...options, maxRetries: 0 });
+    }
+    params(request) {
+        const params = {
+            model: this.model.model,
+            max_tokens: request.maxOutputTokens,
+            stream: false,
+            messages: [{ role: "user", content: request.user }],
+        };
+        if (request.system.trim())
+            params.system = request.system;
+        if (this.model.thinkingBudgetTokens !== undefined) {
+            params.thinking = { type: "enabled", budget_tokens: this.model.thinkingBudgetTokens };
+        }
+        return params;
+    }
+    async generateText(request) {
+        const result = await withTransientRetry(this.provider.maxAttempts, async () => {
+            try {
+                const response = await this.client.messages.create(this.params(request), {
+                    timeout: this.provider.timeoutMs,
+                    signal: request.signal,
+                });
+                if (response.stop_reason === "max_tokens") {
+                    throw new LlmTransportError("truncated", "Provider output was truncated.");
+                }
+                if (response.stop_reason === "refusal")
+                    throw new LlmTransportError("content_filtered", "Provider filtered the response.");
+                const text = response.content
+                    .filter((block) => block.type === "text")
+                    .map((block) => block.text)
+                    .join("\n")
+                    .trim();
+                if (!text)
+                    throw new LlmTransportError("empty_response", "Provider returned an empty text response.");
+                return { text, finishReason: response.stop_reason ?? "", raw: response };
+            }
+            catch (error) {
+                throw requestError(error);
+            }
+        });
+        return { ...result.value, attempts: result.attempts };
+    }
+    async generateTool(request) {
+        const result = await withTransientRetry(this.provider.maxAttempts, async () => {
+            try {
+                const tool = {
+                    name: request.tool.name,
+                    description: request.tool.description,
+                    input_schema: { type: "object", ...request.tool.inputSchema },
+                };
+                const response = await this.client.messages.create({
+                    ...this.params(request),
+                    tools: [tool],
+                    tool_choice: { type: "tool", name: request.tool.name, disable_parallel_tool_use: true },
+                }, {
+                    timeout: this.provider.timeoutMs,
+                    signal: request.signal,
+                });
+                if (response.stop_reason === "max_tokens") {
+                    throw new LlmTransportError("truncated", "Provider tool output was truncated.");
+                }
+                if (response.stop_reason === "refusal")
+                    throw new LlmTransportError("content_filtered", "Provider filtered the response.");
+                const block = response.content.find((item) => item.type === "tool_use" && item.name === request.tool.name);
+                if (!block || block.type !== "tool_use") {
+                    throw new LlmTransportError("invalid_response", "Provider did not return the required tool call.");
+                }
+                return { input: block.input, finishReason: response.stop_reason ?? "", raw: response };
+            }
+            catch (error) {
+                throw requestError(error);
+            }
+        });
+        return { ...result.value, attempts: result.attempts };
+    }
+}
+//# sourceMappingURL=anthropic-model.js.map

package/dist/infra/llm/anthropic-model.js.map

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

package/dist/infra/llm/gemini-upload.d.ts

@@ -0,0 +1,9 @@
+import type { GeminiFile } from "./gemini-video-model.js";
+export declare function resumableUpload(params: {
+    apiKey: string;
+    filePath: string;
+    mimeType: string;
+    timeoutMs: number;
+    proxyUrl?: string;
+    signal?: AbortSignal;
+}): Promise<GeminiFile>;

package/dist/infra/llm/gemini-upload.js

@@ -0,0 +1,94 @@
+// Gemini Files API resumable upload over Node's built-in https (not undici).
+// undici's strict content-length parser rejects the resumable-upload response
+// when it traverses a local HTTP proxy (Clash) with "invalid content-length
+// header"; Node's https parser is lenient and works. Only the upload step needs
+// this — files.get/delete and generateContent are plain requests the SDK's fetch
+// handles fine. The file body is streamed (never fully buffered).
+import * as fs from "node:fs";
+import * as https from "node:https";
+import { HttpsProxyAgent } from "https-proxy-agent";
+import { LlmTransportError } from "../../llm/types.js";
+const HOST = "generativelanguage.googleapis.com";
+function proxyAgent(proxyUrl) {
+    return proxyUrl ? new HttpsProxyAgent(proxyUrl) : undefined;
+}
+function request(opts, body, signal) {
+    return new Promise((resolve, reject) => {
+        const req = https.request(opts, (res) => {
+            let data = "";
+            res.on("data", (c) => (data += c));
+            res.on("end", () => resolve({ status: res.statusCode ?? 0, headers: res.headers, body: data }));
+        });
+        req.on("error", reject);
+        if (signal) {
+            if (signal.aborted) {
+                req.destroy(new Error("aborted"));
+                return;
+            }
+            signal.addEventListener("abort", () => req.destroy(new Error("aborted")), { once: true });
+        }
+        if (body && typeof body.pipe === "function")
+            body.pipe(req);
+        else {
+            if (body)
+                req.write(body);
+            req.end();
+        }
+    });
+}
+function header(h, name) {
+    const v = h[name];
+    return Array.isArray(v) ? (v[0] ?? "") : (v ?? "");
+}
+export async function resumableUpload(params) {
+    const size = fs.statSync(params.filePath).size;
+    const agent = proxyAgent(params.proxyUrl ?? "");
+    const common = { agent, timeout: params.timeoutMs };
+    let start;
+    try {
+        start = await request({
+            ...common, method: "POST", host: HOST, path: `/upload/v1beta/files?key=${params.apiKey}`,
+            headers: {
+                "X-Goog-Upload-Protocol": "resumable", "X-Goog-Upload-Command": "start",
+                "X-Goog-Upload-Header-Content-Length": String(size), "X-Goog-Upload-Header-Content-Type": params.mimeType,
+                "Content-Type": "application/json",
+            },
+        }, JSON.stringify({ file: {} }), params.signal);
+    }
+    catch (e) {
+        throw new LlmTransportError("request_failed", "Gemini upload start failed.", { retryable: !params.signal?.aborted, details: [e instanceof Error ? e.message : String(e)] });
+    }
+    if (start.status === 401 || start.status === 403)
+        throw new LlmTransportError("auth", "Gemini upload unauthorized.", { details: [start.body.slice(0, 300)] });
+    const uploadUrl = header(start.headers, "x-goog-upload-url");
+    if (start.status < 200 || start.status >= 300 || !uploadUrl) {
+        const retryable = start.status === 429 || start.status >= 500;
+        throw new LlmTransportError("request_failed", "Gemini upload start returned no upload URL.", { retryable, details: [`status: ${start.status}`, start.body.slice(0, 300)] });
+    }
+    const u = new URL(uploadUrl);
+    let up;
+    try {
+        up = await request({
+            ...common, method: "POST", host: u.hostname, path: u.pathname + u.search,
+            headers: { "Content-Length": String(size), "X-Goog-Upload-Offset": "0", "X-Goog-Upload-Command": "upload, finalize" },
+        }, fs.createReadStream(params.filePath), params.signal);
+    }
+    catch (e) {
+        throw new LlmTransportError("request_failed", "Gemini upload transfer failed.", { retryable: !params.signal?.aborted, details: [e instanceof Error ? e.message : String(e)] });
+    }
+    if (up.status < 200 || up.status >= 300) {
+        const retryable = up.status === 429 || up.status >= 500;
+        throw new LlmTransportError("request_failed", "Gemini upload transfer failed.", { retryable, details: [`status: ${up.status}`, up.body.slice(0, 300)] });
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(up.body);
+    }
+    catch {
+        throw new LlmTransportError("invalid_response", "Gemini upload returned invalid JSON.", { details: [up.body.slice(0, 300)] });
+    }
+    if (!parsed.file)
+        throw new LlmTransportError("invalid_response", "Gemini upload returned no file.", { details: [up.body.slice(0, 300)] });
+    return parsed.file;
+}
+//# sourceMappingURL=gemini-upload.js.map

package/dist/infra/llm/gemini-upload.js.map

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

package/dist/infra/llm/gemini-video-model.d.ts

@@ -0,0 +1,47 @@
+import type { LlmModelConfig, LlmProviderConfig } from "../../llm/config.js";
+import { type VideoFileHandle, type VideoGenerationRequest, type VideoGenerationResponse, type VideoUnderstandingPort } from "../../llm/types.js";
+export interface GeminiFile {
+    name?: string;
+    uri?: string;
+    mimeType?: string;
+    state?: string;
+    error?: {
+        message?: string;
+    } | undefined;
+}
+export interface GeminiGenerateResponse {
+    text?: string;
+    candidates?: Array<{
+        finishReason?: string;
+    }>;
+    usageMetadata?: unknown;
+}
+export interface GeminiClient {
+    files: {
+        upload(params: {
+            file: string;
+            config?: {
+                mimeType?: string;
+            };
+        }): Promise<GeminiFile>;
+        get(params: {
+            name: string;
+        }): Promise<GeminiFile>;
+        delete(params: {
+            name: string;
+        }): Promise<unknown>;
+    };
+    models: {
+        generateContent(params: Record<string, unknown>): Promise<GeminiGenerateResponse>;
+    };
+}
+export declare class GeminiVideoModel implements VideoUnderstandingPort {
+    private readonly provider;
+    private readonly model;
+    private readonly client;
+    constructor(provider: LlmProviderConfig, model: LlmModelConfig, apiKey: string, client?: GeminiClient);
+    upload(localPath: string, mimeType: string, signal?: AbortSignal): Promise<VideoFileHandle>;
+    private pollActive;
+    generate(request: VideoGenerationRequest): Promise<VideoGenerationResponse>;
+    delete(handle: VideoFileHandle, signal?: AbortSignal): Promise<void>;
+}

package/dist/infra/llm/gemini-video-model.js

@@ -0,0 +1,167 @@
+// Gemini video-understanding adapter (§10.5). Implements VideoUnderstandingPort
+// over the Files API: upload a media file once, poll to ACTIVE, generate against
+// the file reference (fps at the media-part level), and delete when done. The
+// adapter owns transport only — it never builds business prompts or imports the
+// ingest domain. The Google SDK is reached through a narrow structural client so
+// tests inject a fake and never hit the network.
+import { createRequire } from "node:module";
+import { LlmTransportError, } from "../../llm/types.js";
+import { resumableUpload } from "./gemini-upload.js";
+import { installProxyFromEnv } from "./proxy.js";
+import { withTransientRetry } from "./retry.js";
+// Poll cadence while an uploaded file is still PROCESSING. Overall budget is the
+// provider timeout; tests inject clients that return ACTIVE immediately.
+const POLL_INTERVAL_MS = 2000;
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function statusOf(error) {
+    if (error && typeof error === "object" && typeof error.status === "number") {
+        return error.status;
+    }
+    return null;
+}
+// Map an SDK/network error to a transport error with the same retry policy as
+// the other adapters: retry only transient network/timeout/408/429/5xx.
+function toTransportError(error, signal, what) {
+    if (error instanceof LlmTransportError)
+        return error;
+    const message = error instanceof Error ? error.message : String(error);
+    const status = statusOf(error);
+    if (status !== null) {
+        const retryable = status === 408 || status === 429 || status >= 500;
+        const code = status === 401 || status === 403 ? "auth" : status === 429 ? "rate_limited" : "request_failed";
+        return new LlmTransportError(code, `Gemini ${what} failed.`, { retryable, details: [`status: ${status}`, message.slice(0, 500)] });
+    }
+    const aborted = signal?.aborted ?? false;
+    return new LlmTransportError(aborted ? "request_failed" : "timeout", `Gemini ${what} failed.`, {
+        retryable: !aborted,
+        details: [message.slice(0, 500)],
+    });
+}
+export class GeminiVideoModel {
+    provider;
+    model;
+    client;
+    constructor(provider, model, apiKey, client) {
+        this.provider = provider;
+        this.model = model;
+        this.client = client ?? createGoogleClient(apiKey, provider.timeoutMs);
+    }
+    async upload(localPath, mimeType, signal) {
+        const { value: file } = await withTransientRetry(this.provider.maxAttempts, async () => {
+            try {
+                return await this.client.files.upload({ file: localPath, config: { mimeType } });
+            }
+            catch (error) {
+                throw toTransportError(error, signal, "upload");
+            }
+        });
+        const active = await this.pollActive(file, signal);
+        if (!active.name || !active.uri) {
+            throw new LlmTransportError("invalid_response", "Gemini upload returned no file reference.");
+        }
+        return { name: active.name, uri: active.uri, mimeType: active.mimeType ?? mimeType };
+    }
+    async pollActive(initial, signal) {
+        let file = initial;
+        const deadline = Date.now() + this.provider.timeoutMs;
+        // Media-processing failure is terminal — never retried (§12.3).
+        while ((file.state ?? "").toUpperCase() === "PROCESSING") {
+            if (signal?.aborted)
+                throw new LlmTransportError("request_failed", "Gemini upload aborted.");
+            if (Date.now() >= deadline)
+                throw new LlmTransportError("timeout", "Gemini file processing timed out.");
+            await delay(POLL_INTERVAL_MS);
+            if (!file.name)
+                throw new LlmTransportError("invalid_response", "Gemini upload returned no file name to poll.");
+            try {
+                file = await this.client.files.get({ name: file.name });
+            }
+            catch (error) {
+                throw toTransportError(error, signal, "file poll");
+            }
+        }
+        if ((file.state ?? "").toUpperCase() === "FAILED") {
+            throw new LlmTransportError("invalid_response", "Gemini file processing failed.", { details: [file.error?.message ?? "unknown media error"] });
+        }
+        return file;
+    }
+    async generate(request) {
+        const config = {
+            // High media resolution reads small on-screen text (subtitles, name cards)
+            // and fine visual anchors (§10.3).
+            mediaResolution: "MEDIA_RESOLUTION_HIGH",
+            maxOutputTokens: request.maxOutputTokens,
+        };
+        if (request.system?.trim())
+            config["systemInstruction"] = request.system;
+        if (request.responseJsonSchema) {
+            config["responseMimeType"] = "application/json";
+            config["responseJsonSchema"] = request.responseJsonSchema;
+        }
+        const params = {
+            model: this.model.model,
+            contents: [{
+                    role: "user",
+                    parts: [
+                        { text: request.user },
+                        // fps is part-level; >1 fps unlocks sub-second MM:SS.sss timecodes (§10.3).
+                        { fileData: { fileUri: request.file.uri, mimeType: request.file.mimeType }, videoMetadata: { fps: request.fps } },
+                    ],
+                }],
+            config,
+        };
+        const { value, attempts } = await withTransientRetry(this.provider.maxAttempts, async () => {
+            let response;
+            try {
+                response = await this.client.models.generateContent(params);
+            }
+            catch (error) {
+                throw toTransportError(error, request.signal, "generateContent");
+            }
+            const finishReason = response.candidates?.[0]?.finishReason ?? "";
+            if (finishReason === "MAX_TOKENS")
+                throw new LlmTransportError("truncated", "Gemini output was truncated.");
+            if (finishReason === "SAFETY" || finishReason === "PROHIBITED_CONTENT")
+                throw new LlmTransportError("content_filtered", "Gemini filtered the response.");
+            const text = (response.text ?? "").trim();
+            if (!text)
+                throw new LlmTransportError("empty_response", "Gemini returned an empty response.");
+            return { text, finishReason, raw: response };
+        });
+        return { text: value.text, finishReason: value.finishReason, attempts, raw: value.raw };
+    }
+    async delete(handle, signal) {
+        try {
+            await this.client.files.delete({ name: handle.name });
+        }
+        catch (error) {
+            // Cleanup is best-effort (§10.5); a failed delete must not fail the run.
+            void error;
+            void signal;
+        }
+    }
+}
+// Lazily import the SDK so the dependency is only loaded when a video route is
+// actually exercised (keeps text-only runs free of @google/genai).
+const require = createRequire(import.meta.url);
+function createGoogleClient(apiKey, timeoutMs) {
+    // Route Google egress through the proxy env (Node fetch ignores it otherwise);
+    // gateway/loopback stay direct. No-op without a proxy env.
+    installProxyFromEnv();
+    const { GoogleGenAI } = require("@google/genai");
+    const sdk = new GoogleGenAI({ apiKey });
+    const proxyUrl = (process.env.https_proxy ?? process.env.HTTPS_PROXY ?? process.env.http_proxy ?? process.env.HTTP_PROXY ?? "").trim();
+    // upload goes through Node https (undici rejects the resumable response's
+    // content-length behind a proxy); get/delete/generateContent use the SDK.
+    return {
+        files: {
+            upload: (p) => resumableUpload({ apiKey, filePath: p.file, mimeType: p.config?.mimeType ?? "video/mp4", timeoutMs, proxyUrl }),
+            get: (p) => sdk.files.get(p),
+            delete: (p) => sdk.files.delete(p),
+        },
+        models: { generateContent: (p) => sdk.models.generateContent(p) },
+    };
+}
+//# sourceMappingURL=gemini-video-model.js.map

package/dist/infra/llm/gemini-video-model.js.map

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

package/dist/infra/llm/openai-compatible-model.d.ts

@@ -0,0 +1,13 @@
+import type { LlmModelConfig, LlmProviderConfig } from "../../llm/config.js";
+import { type LlmAdapter, type TextGenerationRequest, type TextGenerationResponse, type ToolGenerationRequest, type ToolGenerationResponse } from "../../llm/types.js";
+export declare class OpenAiCompatibleModel implements LlmAdapter {
+    private readonly provider;
+    private readonly model;
+    private readonly apiKey;
+    private readonly url;
+    constructor(provider: LlmProviderConfig, model: LlmModelConfig, apiKey: string);
+    private post;
+    private baseBody;
+    generateText(request: TextGenerationRequest): Promise<TextGenerationResponse>;
+    generateTool(request: ToolGenerationRequest): Promise<ToolGenerationResponse>;
+}