flow-agent-bridge 0.32.0 → 0.34.0

package/dist/session.js

@@ -0,0 +1,480 @@
+// Persistent agent session: one CLI process per conversation (#519).
+//
+// The bridge used to spawn a `claude` process per turn and kill it the moment
+// the turn's `result` event arrived. That took the agent's background work with
+// it — a backgrounded Bash task, a subagent, a pending wakeup — so an agent
+// could not do anything asynchronous at all.
+//
+// Here the process is spawned once per conversation and kept alive:
+// `--input-format stream-json` with stdin held open, each Flow message written
+// as a user message, each `result` event a turn boundary rather than the end of
+// the process. Background tasks then survive the boundary, and when one
+// finishes the SDK re-invokes the agent inside the same process — a turn nobody
+// sent a message for, whose reply is posted like any other (`onAmbientEnd`).
+//
+// What this buys costs a lifecycle to manage, which is the rest of this file:
+// per-turn timers (silence *between* turns is normal and must expire nothing),
+// an idle reaper that a pending background task holds off up to a hard cap, and
+// an interrupt that ends the turn without ending the session.
+import { spawn } from 'node:child_process';
+import { randomUUID } from 'node:crypto';
+import { StreamJsonParser, buildClaudeArgs, describeResultError, killGroup, registerGroup, unregisterGroup, } from './runtime.js';
+/** What an interrupted turn resolves to — no CLI error, just a stopped run. */
+const INTERRUPTED = 'interrupted';
+/**
+ * How long a turn we asked to stop gets to produce its `result` before we stop
+ * asking and kill the process group. The control request is the good path (it
+ * leaves the session and its background tasks alive); this is the backstop for
+ * a CLI too wedged to answer it.
+ */
+const INTERRUPT_GRACE_MS = 10_000;
+/** SIGTERM → SIGKILL grace on a reap, long enough to flush the transcript. */
+const REAP_GRACE_MS = 5_000;
+/**
+ * One conversation's CLI process. Turns are serialised: a message arriving
+ * while a turn (of either kind) is running waits for it, exactly as messages
+ * queued behind a running turn did before.
+ */
+export class RuntimeSession {
+    cfg;
+    hooks;
+    makeSpawn;
+    sessionId;
+    interruptGraceMs;
+    child = null;
+    parser;
+    resume;
+    spawnCleanup = null;
+    turn = null;
+    stderrTail = '';
+    /** Set by the close handler when the CLI refused our `--session-id`. */
+    collided = false;
+    disposed = false;
+    /** Serialises runTurn callers against each other. */
+    gate = Promise.resolve();
+    idleWaiters = [];
+    /** When the last turn of any kind ended — what both reaper clocks measure. */
+    lastTurnEndAt = Date.now();
+    constructor(opts) {
+        this.cfg = opts.cfg;
+        this.hooks = opts.hooks;
+        this.makeSpawn = opts.makeSpawn;
+        this.sessionId = opts.sessionId;
+        this.resume = opts.resume;
+        this.interruptGraceMs = opts.interruptGraceMs ?? INTERRUPT_GRACE_MS;
+        this.parser = this.newParser();
+    }
+    /** The CLI has produced events under this session id, so a respawn resumes it. */
+    get sawSession() {
+        return this.parser.sawEvent || this.resume;
+    }
+    get turnInFlight() {
+        return this.turn !== null;
+    }
+    /** Background work the agent started and hasn't finished. */
+    get pendingTasks() {
+        return this.parser.pending.size;
+    }
+    get pid() {
+        return this.child?.pid;
+    }
+    /**
+     * Idle = nothing to wait for: no turn running and no background task open.
+     * Only an idle session is reapable on the short clock.
+     */
+    get idle() {
+        return this.turn === null && this.parser.pending.size === 0;
+    }
+    /**
+     * Reap when the session has been quiet past its clock. A pending background
+     * task buys time — up to the hard cap, so a wedged task cannot pin a session
+     * open forever — but a turn in flight is never interrupted by the reaper.
+     */
+    reapReason(now, idleMs, hardCapMs) {
+        if (this.child === null || this.turn !== null)
+            return null;
+        const quiet = now - this.lastTurnEndAt;
+        if (this.parser.pending.size === 0) {
+            return quiet >= idleMs ? `idle for ${Math.round(quiet / 1000)}s` : null;
+        }
+        return quiet >= hardCapMs
+            ? `hit the ${Math.round(hardCapMs / 1000)}s cap with ${this.parser.pending.size} background task(s) still open`
+            : null;
+    }
+    /**
+     * Run one turn. Spawns the process if this conversation hasn't got one (first
+     * message, or the first after a reap or a crash), then writes the message and
+     * resolves when that turn's `result` arrives.
+     */
+    async runTurn(prompt, signal) {
+        const run = this.gate.then(async () => {
+            if (signal?.aborted)
+                return { ok: false, text: '', error: INTERRUPTED, interrupted: true };
+            await this.waitForNoTurn();
+            let result = await this.attempt(prompt, signal);
+            // Session-id collision (a previous process died after the CLI created the
+            // session): the session exists — flip to --resume and retry this same
+            // message transparently, exactly as the per-turn runtime used to.
+            if (this.collided) {
+                this.collided = false;
+                this.resume = true;
+                this.hooks.log('session collision — retrying this message with --resume');
+                result = await this.attempt(prompt, signal);
+            }
+            return result;
+        });
+        // The gate must advance even when a turn throws, or the conversation wedges.
+        this.gate = run.catch(() => { });
+        return run;
+    }
+    /** Interrupt button / `/stop`: end the turn, keep the session. */
+    interrupt() {
+        this.endTurnEarly(INTERRUPTED, true);
+    }
+    /** Reap or shut down: the process and everything it started go away. */
+    dispose(reason, graceMs = REAP_GRACE_MS) {
+        this.disposed = true;
+        const pid = this.child?.pid;
+        if (pid) {
+            this.hooks.log(`ending the session process (pid ${pid}): ${reason}`);
+            killGroup(pid, graceMs);
+            unregisterGroup(pid);
+        }
+        this.child = null;
+        this.spawnCleanup?.();
+        this.spawnCleanup = null;
+        // A turn still waiting settles from the close handler; if the process was
+        // already gone, settle it here so no caller hangs.
+        if (this.turn)
+            this.settleTurn(this.buildResult(`session ended: ${reason}`));
+    }
+    // ---- internals -----------------------------------------------------------
+    newParser() {
+        return new StreamJsonParser((step) => this.hooks.onToolStep(step), (text) => this.hooks.onText(text), {
+            onTurnStart: () => this.onTurnStart(),
+            onResult: () => this.onResult(),
+            onPendingChange: (pending) => this.hooks.log(`background tasks open: ${pending}`),
+        });
+    }
+    /** Resolves once no turn is running — ambient turns queue new messages too. */
+    waitForNoTurn() {
+        if (this.turn === null)
+            return Promise.resolve();
+        return new Promise((resolve) => this.idleWaiters.push(resolve));
+    }
+    async attempt(prompt, signal) {
+        const spawnError = this.ensureProcess();
+        if (spawnError)
+            return { ok: false, text: '', error: spawnError };
+        return new Promise((resolve) => {
+            const turn = this.startTurn(false, resolve);
+            turn.signal = signal;
+            turn.onAbort = () => this.endTurnEarly(INTERRUPTED, true);
+            signal?.addEventListener('abort', turn.onAbort);
+            if (signal?.aborted)
+                return turn.onAbort();
+            const line = JSON.stringify({
+                type: 'user',
+                message: { role: 'user', content: [{ type: 'text', text: prompt }] },
+            });
+            try {
+                this.child.stdin.write(`${line}\n`);
+            }
+            catch (err) {
+                this.settleTurn({ ok: false, text: '', error: `could not write to the session: ${err.message}` });
+            }
+        });
+    }
+    startTurn(ambient, resolve) {
+        this.parser.resetTurn();
+        const turn = {
+            ambient,
+            resolve,
+            ending: null,
+            idleTimer: null,
+            capTimer: null,
+            killTimer: null,
+        };
+        this.turn = turn;
+        // Per-turn, not per-process: between turns a session is *meant* to be
+        // silent, and a lifetime timer would kill it for being well behaved.
+        turn.capTimer = setTimeout(() => this.endTurnEarly(`hit the ${this.cfg.timeoutSec}s run cap`), this.cfg.timeoutSec * 1000);
+        turn.capTimer.unref();
+        this.bumpIdle();
+        return turn;
+    }
+    /**
+     * `system`/`init` with nothing in flight means the SDK started a turn on its
+     * own — a background task finished and it re-invoked the agent. Announce it
+     * so the conversation gets a progress row and, at the end, a reply.
+     */
+    onTurnStart() {
+        if (this.turn !== null)
+            return;
+        this.hooks.log('agent re-invoked itself (a background task finished) — following turn');
+        this.startTurn(true, null);
+        this.hooks.onAmbientStart();
+    }
+    onResult() {
+        if (!this.turn)
+            return;
+        this.settleTurn(this.buildResult());
+    }
+    /** Shape a finished turn's result exactly as the per-turn runtime did. */
+    buildResult(hardError) {
+        const turn = this.turn;
+        if (turn?.ending) {
+            // A stopped turn never reaches its own conclusion, so the salvage is the
+            // last thing the agent said — the only record of the work it did.
+            return {
+                ok: false,
+                text: this.parser.lastText,
+                error: turn.ending.error,
+                sawSession: this.sawSession,
+                interrupted: turn.ending.interrupted,
+            };
+        }
+        if (hardError) {
+            return { ok: false, text: this.parser.finalText || this.parser.lastText, error: hardError, sawSession: this.sawSession };
+        }
+        if (this.parser.sawResult && !this.parser.isError) {
+            return { ok: true, text: this.parser.finalText, sawSession: true };
+        }
+        return {
+            ok: false,
+            text: this.parser.finalText || this.parser.lastText,
+            error: describeResultError(this.parser.errorSubtype, this.cfg.maxTurns),
+            sawSession: this.sawSession,
+        };
+    }
+    settleTurn(result) {
+        const turn = this.turn;
+        if (!turn)
+            return;
+        this.turn = null;
+        this.lastTurnEndAt = Date.now();
+        if (turn.idleTimer)
+            clearTimeout(turn.idleTimer);
+        if (turn.capTimer)
+            clearTimeout(turn.capTimer);
+        if (turn.killTimer)
+            clearTimeout(turn.killTimer);
+        if (turn.onAbort)
+            turn.signal?.removeEventListener('abort', turn.onAbort);
+        if (result.sawSession)
+            this.resume = true;
+        const waiters = this.idleWaiters;
+        this.idleWaiters = [];
+        for (const w of waiters)
+            w();
+        if (turn.ambient)
+            this.hooks.onAmbientEnd(result);
+        else
+            turn.resolve?.(result);
+    }
+    /**
+     * Ask the CLI to end the current turn. The control request is the good path —
+     * it stops the turn and leaves the session, and its background tasks, alive.
+     * If no `result` follows within the grace we fall back to the process-group
+     * kill this used to do unconditionally.
+     */
+    endTurnEarly(error, interrupted = false) {
+        const turn = this.turn;
+        if (!turn || turn.ending)
+            return;
+        turn.ending = { error, interrupted };
+        if (turn.idleTimer)
+            clearTimeout(turn.idleTimer);
+        if (turn.capTimer)
+            clearTimeout(turn.capTimer);
+        this.hooks.log(interrupted ? 'run interrupted — asking the session to stop this turn' : `turn expired: ${error} — asking the session to stop it`);
+        const request = {
+            type: 'control_request',
+            request_id: `req_${randomUUID()}`,
+            request: { subtype: 'interrupt' },
+        };
+        const stdin = this.child?.stdin;
+        try {
+            if (!stdin)
+                throw new Error('no session process');
+            stdin.write(`${JSON.stringify(request)}\n`);
+        }
+        catch {
+            return this.killForStuckTurn();
+        }
+        turn.killTimer = setTimeout(() => this.killForStuckTurn(), this.interruptGraceMs);
+        turn.killTimer.unref();
+    }
+    /** The interrupt didn't take. Kill the group; the close handler settles. */
+    killForStuckTurn() {
+        if (!this.turn)
+            return;
+        this.hooks.log('the session did not answer the interrupt — killing the process group');
+        const pid = this.child?.pid;
+        this.child = null;
+        this.spawnCleanup?.();
+        this.spawnCleanup = null;
+        if (pid) {
+            killGroup(pid, REAP_GRACE_MS);
+            unregisterGroup(pid);
+            return; // the close handler settles the turn
+        }
+        this.settleTurn(this.buildResult('the session process was gone'));
+    }
+    /**
+     * Rearmed by every byte the session emits *while a turn is running*. A turn
+     * that is still working narrates itself, so it never expires however long it
+     * runs; only genuine mid-turn silence does.
+     */
+    bumpIdle() {
+        const turn = this.turn;
+        if (!turn || turn.ending)
+            return;
+        if (turn.idleTimer)
+            clearTimeout(turn.idleTimer);
+        turn.idleTimer = setTimeout(() => this.endTurnEarly(`no output for ${this.cfg.idleTimeoutSec}s`), this.cfg.idleTimeoutSec * 1000);
+        turn.idleTimer.unref();
+    }
+    /** Spawn if needed. Returns an error string when the spawn itself failed. */
+    ensureProcess() {
+        if (this.child)
+            return null;
+        this.disposed = false;
+        this.parser = this.newParser();
+        this.stderrTail = '';
+        const spec = this.makeSpawn();
+        const args = buildClaudeArgs(this.cfg, {
+            sessionId: this.sessionId,
+            resume: this.resume,
+            prompt: '',
+            systemPrompt: spec.systemPrompt,
+            mcpConfigPath: spec.mcpConfigPath,
+            streamInput: true,
+        });
+        let child;
+        try {
+            child = spawn(this.cfg.command, args, {
+                cwd: this.cfg.cwd,
+                stdio: ['pipe', 'pipe', 'pipe'],
+                env: { ...process.env },
+                // Own process group, so a reap or a shutdown takes the agent's whole
+                // subprocess tree — background tasks included — and not just the CLI.
+                detached: true,
+            });
+        }
+        catch (err) {
+            spec.cleanup?.();
+            return `could not spawn ${this.cfg.command}: ${err.message}`;
+        }
+        this.child = child;
+        this.spawnCleanup = spec.cleanup ?? null;
+        if (child.pid)
+            registerGroup(child.pid);
+        this.hooks.log(`session process ${child.pid} started (${this.resume ? '--resume' : '--session-id'} ${this.sessionId})`);
+        child.stdin?.on('error', () => {
+            /* the close handler reports a dead CLI */
+        });
+        child.stdout?.on('data', (d) => {
+            this.bumpIdle();
+            this.parser.feed(d.toString('utf8'));
+        });
+        child.stderr?.on('data', (d) => {
+            this.bumpIdle();
+            this.stderrTail = `${this.stderrTail}${d.toString('utf8')}`.slice(-2000);
+        });
+        child.on('error', (err) => this.onExit(null, `could not spawn ${this.cfg.command}: ${err.message}`, child));
+        child.on('close', (code) => this.onExit(code, null, child));
+        return null;
+    }
+    /**
+     * The process is gone. Any turn waiting on it fails as it did before; the
+     * next message respawns and `--resume`s, so the conversation carries on.
+     */
+    onExit(code, spawnError, child) {
+        if (this.child !== null && this.child !== child)
+            return; // a later spawn owns us now
+        const pid = child.pid;
+        if (pid)
+            unregisterGroup(pid);
+        this.child = null;
+        this.spawnCleanup?.();
+        this.spawnCleanup = null;
+        this.parser.feed('\n'); // flush a trailing unterminated line
+        if (this.sawSession)
+            this.resume = true;
+        // Background tasks died with the process — nothing is pending any more, so
+        // the reaper isn't held off by ghosts.
+        this.parser.pending.clear();
+        if (!this.turn) {
+            if (!this.disposed)
+                this.hooks.log(`session process ${pid ?? '?'} exited (${spawnError ?? `code ${code}`})`);
+            return;
+        }
+        if (!this.resume && this.stderrTail.includes('already in use'))
+            this.collided = true;
+        const error = spawnError ??
+            (this.parser.sawResult
+                ? describeResultError(this.parser.errorSubtype, this.cfg.maxTurns)
+                : `runtime exited ${code} without a result${this.stderrTail ? `: ${this.stderrTail.slice(-300)}` : ''}`);
+        this.settleTurn(this.buildResult(error));
+    }
+}
+/** How often the reaper looks, unless a caller says otherwise. */
+const DEFAULT_SWEEP_MS = 30_000;
+/** The live sessions, one per conversation, plus the reaper that ends them. */
+export class SessionManager {
+    opts;
+    sessions = new Map();
+    sweepTimer = null;
+    constructor(opts) {
+        this.opts = opts;
+        const every = opts.sweepMs ?? DEFAULT_SWEEP_MS;
+        this.sweepTimer = setInterval(() => this.sweep(), every);
+        this.sweepTimer.unref();
+    }
+    /** The session for a conversation, created (not spawned) on first use. */
+    session(key, make) {
+        let s = this.sessions.get(key);
+        if (!s) {
+            s = new RuntimeSession(make());
+            this.sessions.set(key, s);
+        }
+        return s;
+    }
+    get(key) {
+        return this.sessions.get(key);
+    }
+    get size() {
+        return this.sessions.size;
+    }
+    /** `/reset`, or a conversation going away: end the process and forget it. */
+    dispose(key, reason) {
+        const s = this.sessions.get(key);
+        if (!s)
+            return;
+        this.sessions.delete(key);
+        s.dispose(reason, 0);
+    }
+    /** Bridge shutdown: every live session process dies with us (AC 6). */
+    killAll() {
+        if (this.sweepTimer)
+            clearInterval(this.sweepTimer);
+        this.sweepTimer = null;
+        for (const [key, s] of this.sessions)
+            s.dispose(`bridge shutting down (${key})`, 0);
+        this.sessions.clear();
+    }
+    /** One reaper pass — exported behaviour, so tests can drive it directly. */
+    sweep(now = Date.now()) {
+        for (const [key, s] of this.sessions) {
+            const reason = s.reapReason(now, this.opts.idleMs, this.opts.hardCapMs);
+            if (!reason)
+                continue;
+            this.opts.log(`reaping the session for ${key}: ${reason} — the next message resumes it`);
+            this.sessions.delete(key);
+            // SIGTERM first: the CLI flushes its transcript, so `--resume` works.
+            s.dispose(reason);
+        }
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

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

package/dist/shared-file-worker.d.ts

@@ -0,0 +1,7 @@
+import type { PreparedSharedFile } from './shared-files.js';
+/** Text extraction never executes macros, formulas, embedded scripts, or links. */
+export declare function extractSharedFile(input: {
+    filePath: string;
+    name: string;
+    mimeType: string;
+}): Promise<PreparedSharedFile>;

package/dist/shared-file-worker.js

@@ -0,0 +1,93 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { parentPort, workerData } from 'node:worker_threads';
+import { fileURLToPath } from 'node:url';
+const TEXT_LIMIT = 100_000;
+/** Text extraction never executes macros, formulas, embedded scripts, or links. */
+export async function extractSharedFile(input) {
+    const { filePath, name, mimeType } = input;
+    const data = await fs.readFile(filePath);
+    const extension = path.extname(name).toLowerCase();
+    const result = { name, path: filePath, text: '', images: [] };
+    if (['.png', '.jpg', '.jpeg', '.webp'].includes(extension)) {
+        const { loadImage } = await import('@napi-rs/canvas');
+        const image = await loadImage(data);
+        if (image.width * image.height > 25_000_000)
+            throw new Error('Image exceeds 25 megapixels');
+        result.images.push(filePath);
+        result.notice = 'Image supplied for visual inspection; no text extraction was performed.';
+    }
+    else if (extension === '.pdf') {
+        const { getDocument } = await import('pdfjs-dist/legacy/build/pdf.mjs');
+        const { createCanvas } = await import('@napi-rs/canvas');
+        const document = await getDocument({
+            data: new Uint8Array(data), isEvalSupported: false,
+            standardFontDataUrl: fileURLToPath(new URL('./standard_fonts/', import.meta.resolve('pdfjs-dist/package.json'))).replace(/\\/g, '/'),
+        }).promise;
+        try {
+            const pages = Math.min(document.numPages, 20);
+            for (let i = 1; i <= pages && result.text.length < TEXT_LIMIT; i++) {
+                const page = await document.getPage(i);
+                const content = await page.getTextContent();
+                result.text += `\n[Page ${i}]\n${content.items.map((item) => 'str' in item ? item.str : '').join(' ')}\n`;
+                if (i <= 4) {
+                    const natural = page.getViewport({ scale: 1 });
+                    const viewport = page.getViewport({ scale: Math.min(1.5, 1400 / Math.max(natural.width, natural.height)) });
+                    const canvas = createCanvas(Math.ceil(viewport.width), Math.ceil(viewport.height));
+                    await page.render({ canvasContext: canvas.getContext('2d'), viewport, canvas: canvas }).promise;
+                    const imagePath = `${filePath}.page-${i}.png`;
+                    await fs.writeFile(imagePath, canvas.toBuffer('image/png'), { mode: 0o600 });
+                    result.images.push(imagePath);
+                }
+                page.cleanup();
+            }
+            result.notice = `PDF has ${document.numPages} pages. Text: first ${pages} pages (up to ${TEXT_LIMIT} characters). Visual previews: first ${Math.min(pages, 4)} pages only. Scanned pages require visual inspection; do not infer unseen pages.`;
+        }
+        finally {
+            await document.destroy();
+        }
+    }
+    else if (extension === '.docx') {
+        const mammoth = await import('mammoth');
+        result.text = (await mammoth.extractRawText({ buffer: data })).value;
+        result.notice = 'Document text only; embedded images and layout are not extracted.';
+    }
+    else if (extension === '.xlsx') {
+        const { default: ExcelJS } = await import('exceljs');
+        const workbook = new ExcelJS.Workbook();
+        await workbook.xlsx.load(data);
+        for (const sheet of workbook.worksheets.slice(0, 10)) {
+            result.text += `\n[Sheet ${sheet.name}]\n`;
+            sheet.eachRow((row, index) => {
+                if (index > 500 || result.text.length >= TEXT_LIMIT)
+                    return;
+                const cells = [];
+                row.eachCell((cell, col) => { if (col <= 40)
+                    cells.push(`${cell.address}: ${cell.text}`); });
+                result.text += `${cells.join(' | ')}\n`;
+            });
+        }
+        result.notice = 'Values from up to 10 sheets, 500 rows and 40 columns per sheet. Formulas are not recalculated; charts/images are not extracted.';
+    }
+    else if (mimeType.startsWith('text/') || ['.txt', '.md', '.csv', '.json', '.yaml', '.yml', '.xml', '.html', '.js', '.ts', '.tsx', '.py', '.css', '.log', '.sql'].includes(extension)) {
+        if (data.includes(0))
+            throw new Error('This file is binary, not readable text');
+        result.text = data.toString('utf8');
+    }
+    else {
+        throw new Error('Unsupported call format. Send text, PDF, PNG/JPEG/WebP, DOCX, or XLSX. Audio/video and legacy Office files are not decoded.');
+    }
+    if (result.text.length > TEXT_LIMIT)
+        result.notice = `${result.notice ?? ''} Text truncated at ${TEXT_LIMIT} characters.`.trim();
+    result.text = result.text.slice(0, TEXT_LIMIT);
+    if (result.text) {
+        const extracted = `${filePath}.extracted.txt`;
+        await fs.writeFile(extracted, result.text, { mode: 0o600 });
+        result.notice = `${result.notice ?? ''} Extracted text saved at ${extracted}.`.trim();
+    }
+    return result;
+}
+if (parentPort) {
+    void extractSharedFile(workerData).then((result) => parentPort.postMessage({ result }), (error) => parentPort.postMessage({ error: error instanceof Error ? error.message : 'Document could not be opened' }));
+}
+//# sourceMappingURL=shared-file-worker.js.map

package/dist/shared-file-worker.js.map

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

package/dist/shared-files.d.ts

@@ -0,0 +1,11 @@
+import type { FileDTO } from '@flow/shared';
+export declare const MAX_SHARED_FILE_BYTES: number;
+export interface PreparedSharedFile {
+    name: string;
+    path: string;
+    text: string;
+    images: string[];
+    notice?: string;
+}
+/** A cancellable worker keeps malformed/expensive documents off the audio loop. */
+export declare function prepareSharedFile(file: FileDTO, directory: string, download: (id: string, signal: AbortSignal) => Promise<Buffer>, signal: AbortSignal): Promise<PreparedSharedFile>;