@lingjingai/scriptctl 0.25.2 → 0.25.4

package/dist/domain/loom/checkpointer.d.ts

@@ -0,0 +1,3 @@
+import type { Checkpointer } from "./types.js";
+export declare function fileCheckpointer(dir: string): Checkpointer;
+export declare function noopCheckpointer(): Checkpointer;

package/dist/domain/loom/checkpointer.js

@@ -0,0 +1,30 @@
+import * as path from "node:path";
+import { exists, readJson, sha256Text, writeJson, } from "../../common.js";
+function keyPath(dir, key) {
+    const digest = sha256Text(key);
+    return path.join(dir, `${digest}.json`);
+}
+export function fileCheckpointer(dir) {
+    return {
+        read(key) {
+            const p = keyPath(dir, key);
+            if (!exists(p))
+                return null;
+            return readJson(p);
+        },
+        write(record) {
+            writeJson(keyPath(dir, record.key), record);
+        },
+    };
+}
+export function noopCheckpointer() {
+    return {
+        read() {
+            return null;
+        },
+        write() {
+            // intentionally empty
+        },
+    };
+}
+//# sourceMappingURL=checkpointer.js.map

package/dist/domain/loom/checkpointer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpointer.js","sourceRoot":"","sources":["../../../src/domain/loom/checkpointer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EACL,MAAM,EACN,QAAQ,EACR,UAAU,EACV,SAAS,GACV,MAAM,iBAAiB,CAAC;AAMzB,SAAS,OAAO,CAAC,GAAW,EAAE,GAAW;IACvC,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAC/B,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,OAAO;QACL,IAAI,CAAc,GAAW;YAC3B,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YAC5B,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC5B,OAAO,QAAQ,CAAsB,CAAC,CAAC,CAAC;QAC1C,CAAC;QACD,KAAK,CAAc,MAA2B;YAC5C,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;QAC9C,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,IAAI;YACF,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK;YACH,sBAAsB;QACxB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/domain/loom/index.d.ts

@@ -0,0 +1,44 @@
+import type { ExtractTask, FnTask, LlmTask, LoomResult, LoomStep, ParcelNode, ReduceTask, RootNode, RunOptions, ScopeName, ScopeNode, SplitSpec } from "./types.js";
+export { fileCheckpointer, noopCheckpointer, } from "./checkpointer.js";
+export type { Checkpointer, CheckpointRecord, ExtractTask, FnTask, LlmTask, LoomReport, LoomResult, LoomTree, ModelRequest, ModelResponse, ParcelNode, ReduceTask, RootNode, RunOptions, ScopeName, ScopeNode, SplitSpec, TextModel, } from "./types.js";
+export declare function root<TParcel>(children: Array<ScopeNode<unknown, TParcel> | ParcelNode<TParcel>>): RootNode<TParcel>;
+export declare function group<TScope, TParcel>(scope: ScopeName, children: Array<ScopeNode<unknown, TParcel> | ParcelNode<TParcel>>, data: TScope): ScopeNode<TScope, TParcel>;
+export declare function parcel<TParcel>(data: TParcel): ParcelNode<TParcel>;
+export declare function llm<TInput, TOutput>(opts: {
+    version?: string;
+    instruction: string;
+    format: string;
+    input?: (ctx: {
+        parcel: TInput;
+    }) => string;
+    parse: (ctx: {
+        text: string;
+        parcel: TInput;
+        raw?: unknown;
+    }) => TOutput;
+    validate?: (output: TOutput) => void;
+}): LlmTask<TInput, TOutput>;
+export declare function fn<TInput, TOutput>(opts: {
+    version?: string;
+    run: (ctx: {
+        parcel: TInput;
+    }) => Promise<TOutput> | TOutput;
+    validate?: (output: TOutput) => void;
+}): FnTask<TInput, TOutput>;
+export declare class LoomJob<TInput, TCurrent> {
+    private readonly input;
+    private readonly steps;
+    constructor(input: TInput, steps?: LoomStep[]);
+    split<TScope, TParcel>(spec: SplitSpec<TInput, TScope, TParcel>): LoomJob<TInput, TParcel>;
+    extract<TOutput>(task: ExtractTask<TCurrent, TOutput>): LoomJob<TInput, TOutput>;
+    reduce<TOutput, TScope = unknown>(scope: ScopeName, task: ReduceTask<TCurrent, TOutput, TScope> | ((items: TCurrent[], ctx: {
+        scope: TScope | null;
+        scopeName: ScopeName;
+    }) => Promise<TOutput> | TOutput)): LoomJob<TInput, TOutput>;
+    plan(): {
+        input: TInput;
+        steps: LoomStep[];
+    };
+    run(opts?: RunOptions): Promise<LoomResult<TCurrent>>;
+}
+export declare function loom<TInput>(input: TInput): LoomJob<TInput, TInput>;

package/dist/domain/loom/index.js

@@ -0,0 +1,275 @@
+import { sha256Text } from "../../common.js";
+import { noopCheckpointer, } from "./checkpointer.js";
+export { fileCheckpointer, noopCheckpointer, } from "./checkpointer.js";
+function stableStringify(value) {
+    if (Array.isArray(value))
+        return `[${value.map((v) => stableStringify(v)).join(",")}]`;
+    if (value && typeof value === "object") {
+        const obj = value;
+        return `{${Object.keys(obj).sort().map((k) => `${JSON.stringify(k)}:${stableStringify(obj[k])}`).join(",")}}`;
+    }
+    return JSON.stringify(value);
+}
+function signature(value) {
+    return sha256Text(stableStringify(value));
+}
+function checkpointRecord(key, sig, value) {
+    return {
+        key,
+        signature: sig,
+        value,
+        createdAt: new Date().toISOString(),
+    };
+}
+function joinPrompt(instruction, format) {
+    return [instruction.trim(), format.trim()].filter(Boolean).join("\n\n");
+}
+function renderLlmRequest(task, parcelValue) {
+    return {
+        system: joinPrompt(task.instruction, task.format),
+        user: task.input ? task.input({ parcel: parcelValue }) : String(parcelValue),
+    };
+}
+function extractCheckpointPayload(task, parcelValue, runtime) {
+    if (task.kind === "llm") {
+        const request = renderLlmRequest(task, parcelValue);
+        return {
+            request,
+            payload: {
+                step: "extract",
+                kind: "llm",
+                version: task.version ?? "",
+                system: request.system,
+                user: request.user,
+                salt: runtime.checkpointSalt,
+            },
+        };
+    }
+    return {
+        payload: {
+            step: "extract",
+            kind: "fn",
+            version: task.version ?? "",
+            parcel: parcelValue,
+            salt: runtime.checkpointSalt,
+        },
+    };
+}
+export function root(children) {
+    return { kind: "root", children };
+}
+export function group(scope, children, data) {
+    return { kind: "scope", scope, data, children };
+}
+export function parcel(data) {
+    return { kind: "parcel", data };
+}
+export function llm(opts) {
+    return { kind: "llm", ...opts };
+}
+export function fn(opts) {
+    return { kind: "fn", ...opts };
+}
+export class LoomJob {
+    input;
+    steps;
+    constructor(input, steps = []) {
+        this.input = input;
+        this.steps = steps;
+    }
+    split(spec) {
+        return new LoomJob(this.input, [...this.steps, { kind: "split", spec: spec }]);
+    }
+    extract(task) {
+        return new LoomJob(this.input, [...this.steps, { kind: "extract", task: task }]);
+    }
+    reduce(scope, task) {
+        const normalized = typeof task === "function" ? { run: task } : task;
+        return new LoomJob(this.input, [
+            ...this.steps,
+            { kind: "reduce", scope, task: normalized },
+        ]);
+    }
+    plan() {
+        return { input: this.input, steps: [...this.steps] };
+    }
+    async run(opts = {}) {
+        const result = await executePlan(this.input, this.steps, opts);
+        return result;
+    }
+}
+export function loom(input) {
+    return new LoomJob(input);
+}
+async function mapWithConcurrency(items, concurrency, worker) {
+    if (items.length === 0)
+        return [];
+    const out = new Array(items.length);
+    let cursor = 0;
+    const limit = Math.max(1, Math.min(concurrency, items.length));
+    await Promise.all(Array.from({ length: limit }, async () => {
+        while (true) {
+            const idx = cursor++;
+            if (idx >= items.length)
+                break;
+            out[idx] = await worker(items[idx], idx);
+        }
+    }));
+    return out;
+}
+function splitTree(input, spec) {
+    const scopes = spec.partition(input);
+    return root(scopes.map((scopeData) => {
+        const chunks = spec.chunk(scopeData).map((chunk) => parcel(chunk));
+        return group(spec.scope, chunks, scopeData);
+    }));
+}
+function flattenParcels(node, path = []) {
+    if (node.kind === "parcel")
+        return [{ parcel: node.data, path }];
+    const children = node.kind === "root" ? node.children : node.children;
+    const out = [];
+    for (let i = 0; i < children.length; i++) {
+        const child = children[i];
+        const childPath = child.kind === "scope"
+            ? [...path, `${child.scope}:${i}`]
+            : [...path, `parcel:${i}`];
+        out.push(...flattenParcels(child, childPath));
+    }
+    return out;
+}
+function validateOutput(validate, output) {
+    validate?.(output);
+    return output;
+}
+async function runFnExtractTask(task, parcelValue) {
+    return validateOutput(task.validate, await task.run({ parcel: parcelValue }));
+}
+async function runLlmModel(request, runtime) {
+    if (!runtime.model)
+        throw new Error("loom llm task requires run({ model })");
+    return runtime.model({
+        system: request.system,
+        user: request.user,
+        signal: runtime.signal,
+    });
+}
+function parseLlmResponse(task, parcelValue, response) {
+    return validateOutput(task.validate, task.parse({ text: response.text, parcel: parcelValue, raw: response.raw }));
+}
+function replaceParcels(node, values, cursor) {
+    if (node.kind === "parcel") {
+        const value = values[cursor.index];
+        cursor.index += 1;
+        return parcel(value);
+    }
+    const children = node.children.map((child) => replaceParcels(child, values, cursor));
+    if (node.kind === "root")
+        return root(children);
+    return group(node.scope, children, node.data);
+}
+function allChildrenParcels(node) {
+    return node.children.every((child) => child.kind === "parcel");
+}
+async function reduceScopeNode(node, scope, task, runtime, path) {
+    if (node.kind === "parcel")
+        return node;
+    const reducedChildren = [];
+    for (let i = 0; i < node.children.length; i++) {
+        const child = node.children[i];
+        reducedChildren.push(await reduceScopeNode(child, scope, task, runtime, [...path, `${child.kind}:${i}`]));
+    }
+    const rebuilt = node.kind === "root" ? root(reducedChildren) : group(node.scope, reducedChildren, node.data);
+    const isTargetRoot = scope === "root" && rebuilt.kind === "root";
+    const isTargetScope = rebuilt.kind === "scope" && rebuilt.scope === scope;
+    if (!isTargetRoot && !isTargetScope)
+        return rebuilt;
+    if (!allChildrenParcels(rebuilt))
+        return rebuilt;
+    const items = rebuilt.children.map((child) => child.data);
+    const scopeData = rebuilt.kind === "scope" ? rebuilt.data : null;
+    const scopeName = rebuilt.kind === "scope" ? rebuilt.scope : "root";
+    const version = task.version ?? "";
+    const key = `reduce:${scope}:${path.join("/")}:${signature({ items, scopeData, version, salt: runtime.checkpointSalt })}`;
+    const sig = signature({ step: "reduce", scope, version, items, scopeData, salt: runtime.checkpointSalt });
+    const cached = await readCheckpoint(runtime.checkpoint, key, sig);
+    if (cached.hit) {
+        runtime.report.reused += 1;
+        return parcel(validateOutput(task.validate, cached.value));
+    }
+    const out = validateOutput(task.validate, await task.run(items, { scope: scopeData, scopeName }));
+    runtime.report.ran += 1;
+    await runtime.checkpoint.write(checkpointRecord(key, sig, out));
+    return parcel(out);
+}
+async function readCheckpoint(checkpoint, key, sig) {
+    const record = await checkpoint.read(key);
+    if (record && record.signature === sig)
+        return { hit: true, value: record.value };
+    return { hit: false };
+}
+async function executePlan(input, steps, opts) {
+    const runtime = {
+        model: opts.model,
+        signal: opts.signal,
+        checkpointSalt: opts.checkpointSalt,
+        checkpoint: opts.checkpoint ?? noopCheckpointer(),
+        concurrency: opts.concurrency ?? 4,
+        report: { reused: 0, ran: 0 },
+    };
+    let tree = null;
+    let currentInput = input;
+    for (const step of steps) {
+        if (step.kind === "split") {
+            tree = splitTree(currentInput, step.spec);
+            currentInput = tree;
+            continue;
+        }
+        if (!tree) {
+            tree = root([parcel(currentInput)]);
+        }
+        if (step.kind === "extract") {
+            const leaves = flattenParcels(tree);
+            const values = await mapWithConcurrency(leaves, runtime.concurrency, async (leaf) => {
+                const checkpoint = extractCheckpointPayload(step.task, leaf.parcel, runtime);
+                const sig = signature(checkpoint.payload);
+                const key = `extract:${leaf.path.join("/")}:${sig}`;
+                if (step.task.kind === "llm") {
+                    const cached = await readCheckpoint(runtime.checkpoint, key, sig);
+                    if (cached.hit) {
+                        runtime.report.reused += 1;
+                        return parseLlmResponse(step.task, leaf.parcel, cached.value);
+                    }
+                    const request = checkpoint.request ?? renderLlmRequest(step.task, leaf.parcel);
+                    const response = await runLlmModel(request, runtime);
+                    const value = parseLlmResponse(step.task, leaf.parcel, response);
+                    runtime.report.ran += 1;
+                    await runtime.checkpoint.write(checkpointRecord(key, sig, response));
+                    return value;
+                }
+                const cached = await readCheckpoint(runtime.checkpoint, key, sig);
+                if (cached.hit) {
+                    runtime.report.reused += 1;
+                    return validateOutput(step.task.validate, cached.value);
+                }
+                const value = await runFnExtractTask(step.task, leaf.parcel);
+                runtime.report.ran += 1;
+                await runtime.checkpoint.write(checkpointRecord(key, sig, value));
+                return value;
+            });
+            tree = replaceParcels(tree, values, { index: 0 });
+            currentInput = tree;
+            continue;
+        }
+        tree = await reduceScopeNode(tree, step.scope, step.task, runtime, []);
+        currentInput = tree;
+    }
+    if (!tree)
+        return { value: currentInput, report: runtime.report };
+    const leaves = flattenParcels(tree);
+    if (leaves.length !== 1) {
+        throw new Error(`loom plan ended with ${leaves.length} result(s); reduce to root before run completes`);
+    }
+    return { value: leaves[0].parcel, report: runtime.report };
+}
+//# sourceMappingURL=index.js.map

package/dist/domain/loom/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/domain/loom/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EACL,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAsB3B,OAAO,EACL,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAyB3B,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACvF,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,GAAG,GAAG,KAAgC,CAAC;QAC7C,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IAChH,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,UAAU,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,gBAAgB,CAAI,GAAW,EAAE,GAAW,EAAE,KAAQ;IAC7D,OAAO;QACL,GAAG;QACH,SAAS,EAAE,GAAG;QACd,KAAK;QACL,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,WAAmB,EAAE,MAAc;IACrD,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC1E,CAAC;AAED,SAAS,gBAAgB,CAAC,IAA+B,EAAE,WAAoB;IAC7E,OAAO;QACL,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC;QACjD,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC;KAC7E,CAAC;AACJ,CAAC;AAED,SAAS,wBAAwB,CAC/B,IAAmC,EACnC,WAAoB,EACpB,OAAwB;IAExB,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QACpD,OAAO;YACL,OAAO;YACP,OAAO,EAAE;gBACP,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,KAAK;gBACX,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE;gBAC3B,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,IAAI,EAAE,OAAO,CAAC,cAAc;aAC7B;SACF,CAAC;IACJ,CAAC;IACD,OAAO;QACL,OAAO,EAAE;YACP,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,IAAI;YACV,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE;YAC3B,MAAM,EAAE,WAAW;YACnB,IAAI,EAAE,OAAO,CAAC,cAAc;SAC7B;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,IAAI,CAClB,QAAkE;IAElE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,KAAK,CACnB,KAAgB,EAChB,QAAkE,EAClE,IAAY;IAEZ,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,MAAM,CAAU,IAAa;IAC3C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,GAAG,CAAkB,IAOpC;IACC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,EAAE,CAAkB,IAInC;IACC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC;AACjC,CAAC;AAED,MAAM,OAAO,OAAO;IAEC;IACA;IAFnB,YACmB,KAAa,EACb,QAAoB,EAAE;QADtB,UAAK,GAAL,KAAK,CAAQ;QACb,UAAK,GAAL,KAAK,CAAiB;IACtC,CAAC;IAEJ,KAAK,CAAkB,IAAwC;QAC7D,OAAO,IAAI,OAAO,CAAkB,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAA4C,EAAE,CAAC,CAAC,CAAC;IAC1I,CAAC;IAED,OAAO,CAAU,IAAoC;QACnD,OAAO,IAAI,OAAO,CAAkB,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,IAAqC,EAAE,CAAC,CAAC,CAAC;IACrI,CAAC;IAED,MAAM,CACJ,KAAgB,EAChB,IAAsJ;QAEtJ,MAAM,UAAU,GAA0C,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC5G,OAAO,IAAI,OAAO,CAAkB,IAAI,CAAC,KAAK,EAAE;YAC9C,GAAG,IAAI,CAAC,KAAK;YACb,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,UAAmD,EAAE;SACrF,CAAC,CAAC;IACL,CAAC;IAED,IAAI;QACF,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,OAAmB,EAAE;QAC7B,MAAM,MAAM,GAAG,MAAM,WAAW,CAAW,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACzE,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED,MAAM,UAAU,IAAI,CAAS,KAAa;IACxC,OAAO,IAAI,OAAO,CAAiB,KAAK,CAAC,CAAC;AAC5C,CAAC;AAED,KAAK,UAAU,kBAAkB,CAC/B,KAAU,EACV,WAAmB,EACnB,MAA8C;IAE9C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAClC,MAAM,GAAG,GAAG,IAAI,KAAK,CAAI,KAAK,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/D,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,KAAK,IAAI,EAAE;QACzD,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;YACrB,IAAI,GAAG,IAAI,KAAK,CAAC,MAAM;gBAAE,MAAM;YAC/B,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,CAAE,EAAE,GAAG,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC,CAAC,CAAC,CAAC;IACJ,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,SAAS,CAAS,KAAa,EAAE,IAA0C;IAClF,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACrC,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE;QACnC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACnE,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC,CAAC;AACN,CAAC;AAED,SAAS,cAAc,CAAC,IAAkC,EAAE,OAAiB,EAAE;IAC7E,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACjE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;IACtE,MAAM,GAAG,GAA+C,EAAE,CAAC;IAC3D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,KAAK,OAAO;YACtC,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;YAClC,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC;QAC7B,GAAG,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,cAAc,CAAI,QAA2C,EAAE,MAAS;IAC/E,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC;IACnB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,gBAAgB,CAC7B,IAA8B,EAC9B,WAAoB;IAEpB,OAAO,cAAc,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;AAChF,CAAC;AAED,KAAK,UAAU,WAAW,CACxB,OAAyC,EACzC,OAAwB;IAExB,IAAI,CAAC,OAAO,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC7E,OAAO,OAAO,CAAC,KAAK,CAAC;QACnB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,gBAAgB,CACvB,IAA+B,EAC/B,WAAoB,EACpB,QAAuB;IAEvB,OAAO,cAAc,CACnB,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE,CAAC,CAC5E,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CACrB,IAAkC,EAClC,MAAiB,EACjB,MAAyB;IAEzB,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC;QAClB,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAa,CAAC,CAAC;IACjG,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChD,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAqD;IAC/E,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;AACjE,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,IAAkC,EAClC,KAAgB,EAChB,IAA2C,EAC3C,OAAwB,EACxB,IAAc;IAEd,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACxC,MAAM,eAAe,GAAe,EAAE,CAAC;IACvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC;QAChC,eAAe,CAAC,IAAI,CAAC,MAAM,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,CAAa,CAAC,CAAC;IACxH,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7G,MAAM,YAAY,GAAG,KAAK,KAAK,MAAM,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC;IACjE,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,KAAK,OAAO,IAAI,OAAO,CAAC,KAAK,KAAK,KAAK,CAAC;IAC1E,IAAI,CAAC,YAAY,IAAI,CAAC,aAAa;QAAE,OAAO,OAAO,CAAC;IACpD,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IAEjD,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAE,KAA6B,CAAC,IAAI,CAAC,CAAC;IACnF,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACjE,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;IACpE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;IACnC,MAAM,GAAG,GAAG,UAAU,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC,EAAE,CAAC;IAC1H,MAAM,GAAG,GAAG,SAAS,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAC1G,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAClE,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;QACf,OAAO,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;QAC3B,OAAO,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7D,CAAC;IACD,MAAM,GAAG,GAAG,cAAc,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;IAClG,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;IACxB,MAAM,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IAChE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;AACrB,CAAC;AAYD,KAAK,UAAU,cAAc,CAC3B,UAAwB,EACxB,GAAW,EACX,GAAW;IAEX,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAI,GAAG,CAAC,CAAC;IAC7C,IAAI,MAAM,IAAI,MAAM,CAAC,SAAS,KAAK,GAAG;QAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;IAClF,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;AACxB,CAAC;AAWD,KAAK,UAAU,WAAW,CAAI,KAAc,EAAE,KAAiB,EAAE,IAAgB;IAC/E,MAAM,OAAO,GAAoB;QAC/B,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,gBAAgB,EAAE;QACjD,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,CAAC;QAClC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE;KAC9B,CAAC;IACF,IAAI,IAAI,GAA6B,IAAI,CAAC;IAC1C,IAAI,YAAY,GAAY,KAAK,CAAC;IAClC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC1B,IAAI,GAAG,SAAS,CAAC,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1C,YAAY,GAAG,IAAI,CAAC;YACpB,SAAS;QACX,CAAC;QACD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,GAAG,IAAI,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACtC,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;YACpC,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBAClF,MAAM,UAAU,GAAG,wBAAwB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAC7E,MAAM,GAAG,GAAG,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;gBAC1C,MAAM,GAAG,GAAG,WAAW,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC;gBAEpD,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;oBAC7B,MAAM,MAAM,GAAG,MAAM,cAAc,CAAgB,OAAO,CAAC,UAAU,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;oBACjF,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;wBACf,OAAO,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;wBAC3B,OAAO,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;oBAChE,CAAC;oBACD,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,IAAI,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;oBAC/E,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;oBACrD,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;oBACjE,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;oBACxB,MAAM,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;oBACrE,OAAO,KAAK,CAAC;gBACf,CAAC;gBAED,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;gBAClE,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;oBACf,OAAO,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;oBAC3B,OAAO,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC1D,CAAC;gBACD,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;gBAC7D,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;gBACxB,MAAM,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;gBAClE,OAAO,KAAK,CAAC;YACf,CAAC,CAAC,CAAC;YACH,IAAI,GAAG,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAsB,CAAC;YACvE,YAAY,GAAG,IAAI,CAAC;YACpB,SAAS;QACX,CAAC;QACD,IAAI,GAAG,MAAM,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAsB,CAAC;QAC5F,YAAY,GAAG,IAAI,CAAC;IACtB,CAAC;IACD,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,KAAK,EAAE,YAAiB,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;IACvE,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,wBAAwB,MAAM,CAAC,MAAM,iDAAiD,CAAC,CAAC;IAC1G,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAE,CAAC,MAAW,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;AACnE,CAAC"}

package/dist/domain/loom/types.d.ts

@@ -0,0 +1,100 @@
+export type ScopeName = string;
+export interface ModelRequest {
+    system: string;
+    user: string;
+    signal?: AbortSignal;
+    metadata?: Record<string, unknown>;
+}
+export interface ModelResponse {
+    text: string;
+    raw?: unknown;
+}
+export type TextModel = (request: ModelRequest) => Promise<ModelResponse> | ModelResponse;
+export interface ScopeNode<TScope, TParcel> {
+    kind: "scope";
+    scope: ScopeName;
+    data: TScope;
+    children: Array<ScopeNode<unknown, TParcel> | ParcelNode<TParcel>>;
+}
+export interface ParcelNode<TParcel> {
+    kind: "parcel";
+    data: TParcel;
+}
+export interface RootNode<TParcel> {
+    kind: "root";
+    children: Array<ScopeNode<unknown, TParcel> | ParcelNode<TParcel>>;
+}
+export type LoomTree<TParcel> = RootNode<TParcel>;
+export interface LlmTask<TInput, TOutput> {
+    kind: "llm";
+    version?: string;
+    instruction: string;
+    format: string;
+    input?: (ctx: {
+        parcel: TInput;
+    }) => string;
+    parse: (ctx: {
+        text: string;
+        parcel: TInput;
+        raw?: unknown;
+    }) => TOutput;
+    validate?: (output: TOutput) => void;
+}
+export interface FnTask<TInput, TOutput> {
+    kind: "fn";
+    version?: string;
+    run: (ctx: {
+        parcel: TInput;
+    }) => Promise<TOutput> | TOutput;
+    validate?: (output: TOutput) => void;
+}
+export type ExtractTask<TInput, TOutput> = LlmTask<TInput, TOutput> | FnTask<TInput, TOutput>;
+export interface ReduceTask<TInput, TOutput, TScope = unknown> {
+    version?: string;
+    run: (items: TInput[], ctx: {
+        scope: TScope | null;
+        scopeName: ScopeName;
+    }) => Promise<TOutput> | TOutput;
+    validate?: (output: TOutput) => void;
+}
+export interface SplitSpec<TInput, TScope, TParcel> {
+    scope: ScopeName;
+    partition: (input: TInput) => TScope[];
+    chunk: (scope: TScope) => TParcel[];
+}
+export type LoomStep = {
+    kind: "split";
+    spec: SplitSpec<unknown, unknown, unknown>;
+} | {
+    kind: "extract";
+    task: ExtractTask<unknown, unknown>;
+} | {
+    kind: "reduce";
+    scope: ScopeName;
+    task: ReduceTask<unknown, unknown, unknown>;
+};
+export interface CheckpointRecord<T = unknown> {
+    key: string;
+    signature: string;
+    value: T;
+    createdAt: string;
+}
+export interface Checkpointer {
+    read<T = unknown>(key: string): Promise<CheckpointRecord<T> | null> | CheckpointRecord<T> | null;
+    write<T = unknown>(record: CheckpointRecord<T>): Promise<void> | void;
+}
+export interface RunOptions {
+    model?: TextModel;
+    concurrency?: number;
+    checkpoint?: Checkpointer;
+    checkpointSalt?: unknown;
+    signal?: AbortSignal;
+}
+export interface LoomReport {
+    reused: number;
+    ran: number;
+}
+export interface LoomResult<T> {
+    value: T;
+    report: LoomReport;
+}

package/dist/domain/loom/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/domain/loom/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/domain/loom/types.ts"],"names":[],"mappings":""}

package/dist/help-text.js

@@ -933,6 +933,7 @@ Example
 Usage
 - scriptctl synopsis <text>                 # set script.synopsis
 - scriptctl synopsis <ep_NNN> <text>        # set episode.synopsis
+- scriptctl synopsis generate --apply       # generate missing synopsis fields
 
 Patch ops
 - meta.synopsis.set
@@ -941,6 +942,32 @@ Patch ops
 Examples
 - scriptctl synopsis "陈墨归国复仇，与苏晴重逢，围绕林氏集团的阴谋逐步展开。"
 - scriptctl synopsis ep_001 "陈墨第一时间来到总裁办公室，与苏晴重逢。"
+`,
+    ],
+    [
+        ["synopsis", "generate"],
+        `Generate missing episode and whole-script synopsis fields from script.json.
+
+Usage
+- scriptctl synopsis generate --script-path output/script.json
+- scriptctl synopsis generate --script-path output/script.json --apply
+- scriptctl synopsis generate --script-path output/script.json --overwrite --apply
+
+Behavior
+- Default is dry-run: runs extraction and validation but does not write.
+- Without --overwrite, existing episode synopsis fields are reused and only missing
+  fields are filled.
+- Whole-script fields are generated when any of synopsis/theme/logline/style/main_characters
+  is missing; --overwrite regenerates them.
+- Uses a text-output contract and parser, not tool_use.
+
+Options
+- --provider <name>       openai | anthropic | mock. Default: openai
+- --model <model>         model name for the provider. Default: deepseek-v4-pro-packy
+- --concurrency <n>       parallel chunk extraction, default 30
+- --checkpoint <dir>      checkpoint directory, default workspace direct loom dir
+- --overwrite             regenerate existing synopsis fields
+- --apply                 write script.json
 `,
     ],
     [

package/dist/help-text.js.map

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

package/dist/infra/providers.d.ts

@@ -1,7 +1,24 @@
 import { type ProviderLike } from "../domain/direct-core.js";
 type Dict = Record<string, unknown>;
+export interface ProviderCapabilities {
+    completeText: boolean;
+    extractBatch: boolean;
+    extractEpisode: boolean;
+    extractMetadata: boolean;
+    extractEpisodeTitles: boolean;
+    extractEpisodeSynopsis: boolean;
+    extractScriptSynopsis: boolean;
+}
+export declare function providerCapabilities(name: string): ProviderCapabilities | null;
 export declare class MockProvider implements ProviderLike {
     readonly name = "mock";
+    completeText(request: {
+        system: string;
+        user: string;
+    }): {
+        text: string;
+        raw: Dict;
+    };
     extractEpisode(sourceText: string, episodePlan: Dict): Dict;
     extractBatch(sourceText: string, batchPlan: Dict): Dict;
     extractMetadata(_sourceText: string, script: Dict): Dict;
@@ -15,6 +32,7 @@ export declare class AnthropicProvider implements ProviderLike {
     private readonly model;
     constructor(model: string);
     private messageRequest;
+    private textMessageRequest;
     private collectResponseText;
     /**
      * Run a request that forces a specific tool call via `tool_choice`, then return that
@@ -33,6 +51,13 @@ export declare class AnthropicProvider implements ProviderLike {
      */
     private runToolUse;
     extractEpisode(sourceText: string, episodePlan: Dict): Promise<Dict>;
+    completeText(request: {
+        system: string;
+        user: string;
+    }): Promise<{
+        text: string;
+        raw: Dict;
+    }>;
     extractBatch(sourceText: string, batchPlan: Dict): Promise<Dict>;
     extractEpisodeTitles(sourceText: string, episodePlan: Dict): Promise<Dict>;
     extractMetadata(_sourceText: string, script: Dict): Promise<Dict>;
@@ -41,5 +66,20 @@ export declare class AnthropicProvider implements ProviderLike {
     extractEpisodeSynopsis(synopses: string[], ctx: Dict): Promise<Dict>;
     extractScriptSynopsis(synopses: string[], ctx: Dict): Promise<Dict>;
 }
+export declare class OpenAICompatibleProvider implements ProviderLike {
+    readonly name = "openai";
+    private readonly apiKey;
+    private readonly endpoint;
+    private readonly model;
+    constructor(model: string);
+    completeText(request: {
+        system: string;
+        user: string;
+        signal?: AbortSignal;
+    }): Promise<{
+        text: string;
+        raw: Dict;
+    }>;
+}
 export declare function makeProvider(name: string, model: string): ProviderLike;
 export {};