@leiboss/dsh-voiceover 0.0.0-stage → 0.3.0

package/dist/llm.js

@@ -0,0 +1,113 @@
+/**
+ * The model boundary. The pipeline depends on this narrow `Completer` port, not
+ * on any particular provider, so it runs identically inside DSH (host adapter),
+ * against an OpenAI-compatible endpoint, and in tests (a scripted fake).
+ */
+import { repairPrompt } from "./prompts.js";
+import { ValidationError } from "./validate.js";
+/** Failure with a routable code; callers distinguish retryable from terminal. */
+export class LlmError extends Error {
+    code;
+    retryable;
+    constructor(code, message, retryable) {
+        super(message);
+        this.name = 'LlmError';
+        this.code = code;
+        this.retryable = retryable;
+    }
+}
+/**
+ * Pull one JSON value out of a model reply. Tolerates fences and leading prose,
+ * but never invents structure: a reply without a JSON object is an error.
+ */
+export function extractJson(text) {
+    const fenced = /```(?:json)?\s*([\s\S]*?)```/i.exec(text);
+    const body = (fenced?.[1] ?? text).trim();
+    const start = body.indexOf('{');
+    const end = body.lastIndexOf('}');
+    if (start < 0 || end <= start) {
+        throw new LlmError('LLM_BAD_JSON', 'The model reply contained no JSON object.', true);
+    }
+    try {
+        return JSON.parse(body.slice(start, end + 1));
+    }
+    catch (error) {
+        throw new LlmError('LLM_BAD_JSON', `The model reply was not valid JSON: ${String(error)}`, true);
+    }
+}
+/**
+ * Ask for JSON, validate it, and repair structure once before giving up. The
+ * repair pass never re-runs the task, only the shape, so a bad outline cannot
+ * silently become a different outline.
+ */
+export async function callJson(completer, prompt, validate, options = {}) {
+    const repairRounds = options.repairRounds ?? 1;
+    let previous = await completer.complete({
+        system: prompt.system,
+        user: prompt.user,
+        temperature: options.temperature,
+        signal: options.signal,
+    });
+    let lastError;
+    for (let attempt = 0; attempt <= repairRounds; attempt += 1) {
+        try {
+            return validate(extractJson(previous));
+        }
+        catch (error) {
+            lastError = error;
+            if (attempt === repairRounds)
+                break;
+            const detail = error instanceof ValidationError ? error.message : String(error);
+            const repair = repairPrompt({ error: detail, previous });
+            previous = await completer.complete({
+                system: repair.system,
+                user: repair.user,
+                temperature: 0,
+                signal: options.signal,
+            });
+        }
+    }
+    const detail = lastError instanceof ValidationError ? lastError.message : String(lastError);
+    throw new LlmError('LLM_SCHEMA_INVALID', `The model reply did not satisfy the schema: ${detail}`, true);
+}
+/**
+ * OpenAI-compatible chat completions. Injecting `fetchImpl` keeps every test
+ * offline and lets the same adapter serve a local gateway.
+ */
+export function httpCompleter(options) {
+    const doFetch = options.fetchImpl ?? fetch;
+    const endpoint = `${options.baseUrl.replace(/\/+$/, '')}/chat/completions`;
+    return {
+        model: options.label ?? options.model,
+        async complete(request) {
+            const signal = request.signal ?? AbortSignal.timeout(options.timeoutMs ?? 120_000);
+            const response = await doFetch(endpoint, {
+                method: 'POST',
+                signal,
+                headers: {
+                    'content-type': 'application/json',
+                    ...(options.apiKey === undefined ? {} : { authorization: `Bearer ${options.apiKey}` }),
+                },
+                body: JSON.stringify({
+                    model: options.model,
+                    temperature: request.temperature ?? 0.3,
+                    messages: [
+                        { role: 'system', content: request.system },
+                        { role: 'user', content: request.user },
+                    ],
+                }),
+            });
+            if (!response.ok) {
+                const body = await response.text().catch(() => '');
+                throw new LlmError('LLM_HTTP_FAILED', `The model endpoint returned ${response.status}: ${body.slice(0, 200)}`, response.status >= 500 || response.status === 429);
+            }
+            const payload = (await response.json());
+            const content = payload.choices?.[0]?.message?.content;
+            if (typeof content !== 'string' || content.length === 0) {
+                throw new LlmError('LLM_EMPTY_REPLY', 'The model endpoint returned an empty message.', true);
+            }
+            return content;
+        },
+    };
+}
+//# sourceMappingURL=llm.js.map

package/dist/llm.js.map

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

package/dist/operations.d.ts

@@ -0,0 +1,41 @@
+import { type PipelineDeps, type ProjectState, type StyleProfile } from './pipeline.ts';
+/** Everything needed to reproduce a project run from persisted state. */
+export interface RerunPlan {
+    text: string;
+    title: string;
+    voice: string;
+    rate: string;
+    style: StyleProfile;
+    network: boolean;
+}
+/** Result of one rerun. */
+export interface RerunResult {
+    projectId: string;
+    state: ProjectState;
+    /** Chapters that were already done and therefore skipped. */
+    skipped: string[];
+}
+/**
+ * Rebuild the run options for an existing project from what it persisted.
+ *
+ * The source text comes from `source/normalized.md` (not from the caller), so a
+ * rerun cannot silently use a different document.
+ */
+export declare function loadRerunPlan(outputDir: string, projectId: string): Promise<{
+    plan: RerunPlan;
+    state: ProjectState;
+} | undefined>;
+/**
+ * Resume a project: every finished chapter is skipped, failed or missing ones
+ * run again. Refuses when the project key no longer matches, because writing
+ * into a directory that other settings produced would mix two projects.
+ */
+export declare function rerunProject(deps: PipelineDeps, input: {
+    outputDir: string;
+    projectId: string;
+    auditSample?: number;
+    signal?: AbortSignal;
+    /** Restrict the rerun to these chapters; omitted means "every unfinished one". */
+    chapters?: readonly string[];
+}): Promise<RerunResult>;
+//# sourceMappingURL=operations.d.ts.map

package/dist/operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../src/operations.ts"],"names":[],"mappings":"AAUA,OAAO,EAAc,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAA;AAGnG,yEAAyE;AACzE,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,YAAY,CAAA;IACnB,OAAO,EAAE,OAAO,CAAA;CACjB;AAKD,2BAA2B;AAC3B,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,YAAY,CAAA;IACnB,6DAA6D;IAC7D,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,GAAG,SAAS,CAAC,CA2B/D;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE;IACL,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC7B,GACA,OAAO,CAAC,WAAW,CAAC,CAwBtB"}

package/dist/operations.js

@@ -0,0 +1,77 @@
+/**
+ * Operations shared by every caller.
+ *
+ * `user-actions.md` requires one implementation per operation: the agent Tool and
+ * the panel button must not each own a copy of the logic. Both reach the
+ * functions here — the Tool directly, the panel through a POST route — so a
+ * rerun behaves identically whichever way the user asks for it.
+ */
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { runProject } from "./pipeline.js";
+import { readJson } from "./util.js";
+/** Matches project ids: the first 12 hex characters of a content hash. */
+const PROJECT_ID = /^[0-9a-f]{8,24}$/;
+/**
+ * Rebuild the run options for an existing project from what it persisted.
+ *
+ * The source text comes from `source/normalized.md` (not from the caller), so a
+ * rerun cannot silently use a different document.
+ */
+export async function loadRerunPlan(outputDir, projectId) {
+    if (!PROJECT_ID.test(projectId))
+        return undefined;
+    const projectDir = join(outputDir, projectId);
+    const state = await readJson(join(projectDir, 'state', 'state.json'));
+    if (state === undefined)
+        return undefined;
+    let text;
+    try {
+        text = await readFile(join(projectDir, 'source', 'normalized.md'), 'utf8');
+    }
+    catch {
+        return undefined;
+    }
+    // Old states predate `style`; the default is the same one the pipeline uses,
+    // so a project created before this field existed can still resume.
+    const style = (state.style ?? 'news');
+    return {
+        state,
+        plan: {
+            text,
+            title: state.outline.title,
+            voice: state.engine.voice,
+            rate: state.engine.rate,
+            style,
+            network: state.capability.network,
+        },
+    };
+}
+/**
+ * Resume a project: every finished chapter is skipped, failed or missing ones
+ * run again. Refuses when the project key no longer matches, because writing
+ * into a directory that other settings produced would mix two projects.
+ */
+export async function rerunProject(deps, input) {
+    const loaded = await loadRerunPlan(input.outputDir, input.projectId);
+    if (loaded === undefined)
+        throw new Error(`Unknown project: ${input.projectId}`);
+    const { plan } = loaded;
+    const result = await runProject(deps, {
+        outputDir: input.outputDir,
+        title: plan.title,
+        text: plan.text,
+        voice: plan.voice,
+        rate: plan.rate,
+        style: plan.style,
+        network: plan.network,
+        auditSample: input.auditSample ?? 2,
+        ...(input.signal === undefined ? {} : { signal: input.signal }),
+        ...(input.chapters === undefined ? {} : { only: input.chapters }),
+    });
+    if (result.projectId !== input.projectId) {
+        throw new Error(`Project ${input.projectId} can no longer be resumed: its prompt or settings changed and the key now resolves to ${result.projectId}. Create a new project instead.`);
+    }
+    return { projectId: result.projectId, state: result.state, skipped: result.skipped };
+}
+//# sourceMappingURL=operations.js.map

package/dist/operations.js.map

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

package/dist/panel.d.ts

@@ -0,0 +1,42 @@
+import type { ConnectionFence, HttpRouteRegistrar } from './http-types.ts';
+import { type ProjectSnapshot } from './snapshot.ts';
+export type { ConnectionFence, RegisterableRoute, HttpRouteRegistrar } from './http-types.ts';
+export type { ProjectSnapshot as PanelSnapshot, SnapshotChapter as PanelChapter } from './snapshot.ts';
+/** Path prefix owned by this plugin. */
+export declare const PANEL_ROUTE_PREFIX = "/voiceover/panel";
+/** Injection points; tests pass a fake host. */
+export interface PanelRouteOptions {
+    outputDir: string;
+    connection?: ConnectionFence;
+    /** Resolves one chapter's audio file to a signed URL, when a route is mounted. */
+    audioUrlFor?: (filePath: string) => string | undefined;
+    /**
+     * Resume a project. The panel's button and the `voiceover_rerun` Tool both
+     * call the same implementation through this hook.
+     */
+    onRerun?: (projectId: string, chapter?: string) => void | Promise<void>;
+    debug?: (message: string) => void;
+}
+/**
+ * Convert SRT to WebVTT.
+ *
+ * Browsers only accept WebVTT in a `<track>`, and several players prefer it;
+ * the only structural differences are the header and the millisecond separator.
+ */
+export declare function srtToVtt(srt: string): string;
+/** Serve one project's persisted progress as JSON. */
+export declare class PanelRoute {
+    private readonly options;
+    constructor(options: PanelRouteOptions);
+    /** Build a snapshot from `state/state.json`; undefined when unknown. */
+    snapshot(projectId: string): Promise<ProjectSnapshot | undefined>;
+    /** Register on the host router; the disposer unregisters the route. */
+    register(server: HttpRouteRegistrar): () => void;
+    /** Handle one request. Never throws: every path answers or closes. */
+    private handle;
+    /** Write one text response (subtitles) with no caching. */
+    private answerText;
+    /** Write one JSON response with no caching. */
+    private answer;
+}
+//# sourceMappingURL=panel.d.ts.map

package/dist/panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panel.d.ts","sourceRoot":"","sources":["../src/panel.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,eAAe,EAAqB,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAC7F,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,eAAe,CAAA;AAErE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAC7F,YAAY,EAAE,eAAe,IAAI,aAAa,EAAE,eAAe,IAAI,YAAY,EAAE,MAAM,eAAe,CAAA;AAEtG,wCAAwC;AACxC,eAAO,MAAM,kBAAkB,qBAAqB,CAAA;AAEpD,gDAAgD;AAChD,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,eAAe,CAAA;IAC5B,kFAAkF;IAClF,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAA;IACtD;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACvE,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CAClC;AAuBD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG5C;AACD,sDAAsD;AACtD,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;gBAE/B,OAAO,EAAE,iBAAiB;IAItC,wEAAwE;IAClE,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;IAMvE,uEAAuE;IACvE,QAAQ,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,IAAI;IAQhD,sEAAsE;YACxD,MAAM;IAiHpB,2DAA2D;IAC3D,OAAO,CAAC,UAAU;IAclB,+CAA+C;IAC/C,OAAO,CAAC,MAAM;CAaf"}

package/dist/panel.js

@@ -0,0 +1,212 @@
+/**
+ * Read-only JSON endpoint behind the conversation panel.
+ *
+ * The panel cannot read structured tool return values (a tool result exposes
+ * only its rendered text), and polling a Tool would fight the conversation. So
+ * the panel parses the project id out of the rendered result and polls this
+ * route instead, which reads the same persisted `state.json` the pipeline
+ * writes.
+ *
+ * Security matches the engine's audio route: the host's connection fence runs
+ * first, the path is strictly `<prefix>/<projectId>.json`, and nothing outside
+ * the project state file is readable.
+ */
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { projectSnapshot } from "./snapshot.js";
+/** Path prefix owned by this plugin. */
+export const PANEL_ROUTE_PREFIX = '/voiceover/panel';
+/** Read a small JSON body; undefined means "sent something unusable". */
+async function readJsonBody(req) {
+    const chunks = [];
+    let size = 0;
+    for await (const chunk of req) {
+        const buffer = chunk;
+        size += buffer.length;
+        // A rerun request carries one chapter id at most.
+        if (size > 64 * 1024)
+            return undefined;
+        chunks.push(buffer);
+    }
+    if (chunks.length === 0)
+        return {};
+    try {
+        const value = JSON.parse(Buffer.concat(chunks).toString('utf8'));
+        return typeof value === 'object' && value !== null && !Array.isArray(value)
+            ? value
+            : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Convert SRT to WebVTT.
+ *
+ * Browsers only accept WebVTT in a `<track>`, and several players prefer it;
+ * the only structural differences are the header and the millisecond separator.
+ */
+export function srtToVtt(srt) {
+    const body = srt.replace(/\r\n/g, '\n').replace(/(\d{2}:\d{2}:\d{2}),(\d{3})/g, '$1.$2');
+    return `WEBVTT\n\n${body}`;
+}
+/** Serve one project's persisted progress as JSON. */
+export class PanelRoute {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    /** Build a snapshot from `state/state.json`; undefined when unknown. */
+    async snapshot(projectId) {
+        return projectSnapshot(this.options.outputDir, projectId, {
+            ...(this.options.audioUrlFor === undefined ? {} : { audioUrlFor: this.options.audioUrlFor }),
+        });
+    }
+    /** Register on the host router; the disposer unregisters the route. */
+    register(server) {
+        return server.register({
+            kind: 'prefix',
+            path: PANEL_ROUTE_PREFIX,
+            handler: (req, res) => this.handle(req, res),
+        });
+    }
+    /** Handle one request. Never throws: every path answers or closes. */
+    async handle(req, res) {
+        // The fence runs before routing: an unauthenticated request learns nothing
+        // about which projects exist.
+        const rejection = this.options.connection?.requestRejection?.({ headers: req.headers });
+        if (rejection !== undefined) {
+            this.answer(res, rejection, { error: 'unauthorized' });
+            return;
+        }
+        const path = (req.url ?? '/').split('?')[0] ?? '/';
+        if (!path.startsWith(`${PANEL_ROUTE_PREFIX}/`)) {
+            this.answer(res, 404, { error: 'not found' });
+            return;
+        }
+        const name = path.slice(PANEL_ROUTE_PREFIX.length + 1);
+        const snapshotMatch = /^([0-9a-f]{8,24})\.json$/.exec(name);
+        if (snapshotMatch !== null) {
+            if (req.method !== 'GET') {
+                this.answer(res, 405, { error: 'method not allowed' });
+                return;
+            }
+            const projectId = snapshotMatch[1] ?? '';
+            const snapshot = await this.snapshot(projectId);
+            if (snapshot === undefined) {
+                this.answer(res, 404, { error: 'unknown project' });
+                return;
+            }
+            this.options.debug?.(`panel served ${projectId}`);
+            this.answer(res, 200, snapshot);
+            return;
+        }
+        const rerunMatch = /^([0-9a-f]{8,24})\/rerun$/.exec(name);
+        if (rerunMatch !== null) {
+            if (req.method !== 'POST') {
+                this.answer(res, 405, { error: 'method not allowed' });
+                return;
+            }
+            const onRerun = this.options.onRerun;
+            if (onRerun === undefined) {
+                this.answer(res, 501, { error: 'rerun is not available in this host' });
+                return;
+            }
+            const projectId = rerunMatch[1] ?? '';
+            const snapshot = await this.snapshot(projectId);
+            if (snapshot === undefined) {
+                this.answer(res, 404, { error: 'unknown project' });
+                return;
+            }
+            const body = await readJsonBody(req);
+            if (body === undefined) {
+                this.answer(res, 400, { error: 'invalid JSON body' });
+                return;
+            }
+            const chapter = typeof body.chapter === 'string' ? body.chapter : undefined;
+            if (chapter !== undefined && !/^ch-[0-9]{2,3}$/.test(chapter)) {
+                this.answer(res, 400, { error: 'chapter must look like ch-03' });
+                return;
+            }
+            try {
+                await onRerun(projectId, chapter);
+                this.options.debug?.(`panel rerun requested ${projectId}`);
+                this.answer(res, 202, { ok: true, projectId, ...(chapter === undefined ? {} : { chapter }) });
+            }
+            catch (error) {
+                this.answer(res, 500, {
+                    error: error instanceof Error ? error.message.slice(0, 200) : 'rerun failed',
+                });
+            }
+            return;
+        }
+        // Subtitles, so the panel can show the current line while playing and a
+        // caller can pull a WebVTT track for a browser player.
+        const subtitleMatch = /^([0-9a-f]{8,24})\/subtitles\/(ch-[0-9]{2,3})(\.vtt)?$/.exec(name);
+        if (subtitleMatch !== null) {
+            if (req.method !== 'GET') {
+                this.answer(res, 405, { error: 'method not allowed' });
+                return;
+            }
+            const projectId = subtitleMatch[1] ?? '';
+            const chapterId = subtitleMatch[2] ?? '';
+            const asVtt = subtitleMatch[3] !== undefined;
+            const snapshot = await this.snapshot(projectId);
+            if (snapshot === undefined) {
+                this.answer(res, 404, { error: 'unknown project' });
+                return;
+            }
+            const chapter = snapshot.chapters.find((entry) => entry.id === chapterId);
+            if (chapter?.subtitles === undefined) {
+                this.answer(res, 404, { error: 'this chapter has no subtitles' });
+                return;
+            }
+            const projectDir = join(this.options.outputDir, projectId);
+            const filePath = join(projectDir, chapter.subtitles);
+            if (!filePath.startsWith(projectDir)) {
+                this.answer(res, 400, { error: 'bad subtitle path' });
+                return;
+            }
+            let text;
+            try {
+                text = await readFile(filePath, 'utf8');
+            }
+            catch {
+                this.answer(res, 404, { error: 'subtitle file missing' });
+                return;
+            }
+            this.answerText(res, asVtt ? 'text/vtt; charset=utf-8' : 'text/plain; charset=utf-8', asVtt ? srtToVtt(text) : text);
+            return;
+        }
+        this.answer(res, 400, { error: 'expected /<projectId>.json, /<projectId>/rerun or /<projectId>/subtitles/<chapter>' });
+    }
+    /** Write one text response (subtitles) with no caching. */
+    answerText(res, contentType, body) {
+        if (res.headersSent) {
+            res.end();
+            return;
+        }
+        const payload = Buffer.from(body, 'utf8');
+        res.writeHead(200, {
+            'content-type': contentType,
+            'cache-control': 'no-store',
+            'content-length': String(payload.length),
+        });
+        res.end(payload);
+    }
+    /** Write one JSON response with no caching. */
+    answer(res, status, body) {
+        if (res.headersSent) {
+            res.end();
+            return;
+        }
+        const payload = `${JSON.stringify(body)}\n`;
+        res.writeHead(status, {
+            'content-type': 'application/json; charset=utf-8',
+            'cache-control': 'no-store',
+            'content-length': Buffer.byteLength(payload),
+        });
+        res.end(payload);
+    }
+}
+//# sourceMappingURL=panel.js.map

package/dist/panel.js.map

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

package/dist/pipeline.d.ts

@@ -0,0 +1,141 @@
+import { type Completer } from './llm.ts';
+import { type Capability, type ChapterRecord, type EngineInfo, type Manifest, type Outline, type OutlineChapter, type SynthResult, type Synthesizer } from './types.ts';
+/** How the script should sound. */
+export type StyleProfile = 'lecture' | 'news' | 'story' | 'docs';
+/** Collaborators the pipeline needs, all injectable. */
+export interface PipelineDeps {
+    /** Absent means "no model": the original text is spoken as written. */
+    completer?: Completer;
+    synth: Synthesizer;
+    now?: () => Date;
+    log?: (event: string, fields?: Record<string, unknown>) => void;
+}
+/** One project run. */
+export interface ProjectOptions {
+    outputDir: string;
+    title: string;
+    text: string;
+    voice: string;
+    rate: string;
+    style: StyleProfile;
+    /** Whether the network reached Edge-TTS at planning time (recorded, not guessed). */
+    network: boolean;
+    /** Chapters below this index are always audited; the rest are sampled. */
+    auditSample?: number;
+    maxBlocks?: number;
+    signal?: AbortSignal;
+    /** Force a stage to run again even when the hashes match. */
+    rerun?: 'source' | 'script' | 'synth';
+    /**
+     * Process only these chapters. Every other chapter keeps its recorded state
+     * untouched, which is what a single-chapter rerun needs.
+     */
+    only?: readonly string[];
+    /** Target characters per chapter when planning without a model. */
+    chapterChars?: number;
+}
+/** Persisted per-project state (never part of the manifest contract). */
+export interface ProjectState {
+    projectId: string;
+    sourceHash: string;
+    promptVersion: string;
+    engine: EngineInfo;
+    capability: Capability;
+    /** Spoken style, persisted so a rerun reproduces the same project key. */
+    style: StyleProfile;
+    outline: Outline;
+    chapters: ChapterRecord[];
+    /** sha256 of each chapter's input text, for resume decisions. */
+    inputHashes: Record<string, string>;
+    warnings: string[];
+    createdAt: string;
+}
+/** What a completed run returns. */
+export interface ProjectResult {
+    projectId: string;
+    projectDir: string;
+    manifest: Manifest;
+    state: ProjectState;
+    /** Chapters that were skipped because their inputs were unchanged. */
+    skipped: string[];
+}
+/**
+ * Canonical text used for identity and planning.
+ *
+ * Every caller (plugin tool, daemon, rerun) must key projects by this string,
+ * not by the raw input: the persisted source file differs from the original by
+ * a trailing newline, and identity must survive that round trip.
+ */
+export declare function normalizeSource(text: string): string;
+/** Compute the resume key for one chapter. */
+export declare function chapterInputHash(text: string, style: StyleProfile): string;
+/** Compute the project identity from everything that changes its output. */
+export declare function projectKey(input: {
+    text: string;
+    voice: string;
+    rate: string;
+    style: StyleProfile;
+}): string;
+/**
+ * Deterministic outline when no model is available: pack paragraphs into
+ * chapters of roughly {@link FALLBACK_CHAPTER_CHARS} characters.
+ */
+export declare function fallbackOutline(input: {
+    title: string;
+    paragraphs: string[];
+    chapterChars?: number;
+}): Outline;
+/** Plan chapters with the model, verifying coverage and falling back on failure. */
+export declare function planOutline(deps: PipelineDeps, input: {
+    title: string;
+    paragraphs: string[];
+    maxBlocks?: number;
+    chapterChars?: number;
+}): Promise<{
+    outline: Outline;
+    warnings: string[];
+}>;
+/** Result of adapting one chapter. */
+export interface AdaptResult {
+    script: string;
+    changes: unknown[];
+    risks: unknown[];
+}
+/** Run stage P1 (and one repair round when the audit rejects the result). */
+export declare function adaptChapter(deps: PipelineDeps, input: {
+    docTitle: string;
+    chapter: OutlineChapter;
+    chapterNo: number;
+    chapterTotal: number;
+    text: string;
+    style: StyleProfile;
+    prevSummary: string;
+    nextSummary: string;
+    issues?: string[];
+}): Promise<AdaptResult>;
+/** One audit issue, kept only as far as the pipeline needs it. */
+export interface AuditIssue {
+    severity: 'high' | 'medium' | 'low';
+    kind: string;
+    fix: string;
+}
+/** Run stage P4. Returns the blocking issues (high severity only). */
+export declare function auditChapter(deps: PipelineDeps, input: {
+    source: string;
+    script: string;
+}): Promise<AuditIssue[]>;
+/**
+ * Run (or resume) one project. Chapter failures are recorded, not thrown: a
+ * partial delivery with an honest manifest beats losing the whole job.
+ */
+export declare function runProject(deps: PipelineDeps, options: ProjectOptions): Promise<ProjectResult>;
+/** Assemble the manifest from persisted chapter records. */
+export declare function buildManifest(input: {
+    state: ProjectState;
+    outline: Map<string, OutlineChapter>;
+    title: string;
+    now: () => Date;
+}): Manifest;
+/** Re-exported so a caller can type a fake synthesizer without the host. */
+export type { SynthResult, Synthesizer };
+//# sourceMappingURL=pipeline.d.ts.map