@agi-fans/dsh-tui 0.20.0 → 0.22.0

package/lib/runtime/composer-shell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composer-shell.js","sourceRoot":"","sources":["../../src/runtime/composer-shell.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAM9E,OAAO,EAAE,iCAAiC,EAAE,MAAM,yBAAyB,CAAA;AAC3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAA;AAEzE,gFAAgF;AAChF,MAAM,UAAU,oBAAoB,CAAC,UAAyB;IAC5D,IAAI,UAAU,CAAC,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,UAAU,CAAC,KAAK,EAAE,MAAM;QAAE,OAAO,SAAS,CAAA;IACpG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAA;IACtD,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;AACvD,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,kBAAkB,CAAC,UAAyB;IAC1D,IAAI,UAAU,CAAC,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,UAAU,CAAC,KAAK,EAAE,MAAM;QAAE,OAAO,KAAK,CAAA;IAChG,OAAO,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;AACzC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,GAAY,EACZ,KAAY,EACZ,OAAe,EACf,QAAqB,EACrB,UAA+B,EAAE;IAEjC,IAAI,GAAG,CAAC,GAAG,CAAC,WAAW,KAAK,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAA;IACrG,IAAI,OAAO,KAAK,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAA;IAC9F,MAAM,SAAS,GAAG,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;IACtC,IAAI,SAAS,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,0FAA0F,CAAC,CAAA;IACxI,IAAI,GAAG,CAAC,GAAG,CAAC,YAAY,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAA;IACpH,MAAM,YAAY,GAAG,IAAI,eAAe,EAAE,CAAA;IAC1C,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,CAAA;IAC/D,MAAM,CAAC,cAAc,EAAE,CAAA;IACvB,2EAA2E;IAC3E,sEAAsE;IACtE,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,gBAAgB,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,CAAA;IAC5G,IAAI,EAAE,GAAG,QAAQ,EAAE,SAAS,CAAA;IAC5B,IAAI,EAAE,KAAK,SAAS,IAAI,QAAQ,EAAE,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC5D,MAAM,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,EAAE,uBAAuB,CAAC,CAAA;QACxD,EAAE,GAAG,SAAS,CAAA;IAChB,CAAC;IACD,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;QACrB,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,GAAG,EAAE,uBAAuB,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC,CAAA;QACjJ,EAAE,GAAG,OAAO,CAAC,SAAS,CAAA;IACxB,CAAC;IACD,MAAM,CAAC,cAAc,EAAE,CAAA;IACvB,MAAM,SAAS,GAAG,EAAE,CAAA;IACpB,IAAI,QAAQ,GAAG,EAAE,CAAA;IACjB,MAAM,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC;QACzB,OAAO;QACP,MAAM;QACN,KAAK,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC,CAAA,CAAC,CAAC;QAC3E,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClD,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE;YACjC,4EAA4E;YAC5E,0EAA0E;YAC1E,0EAA0E;YAC1E,2EAA2E;YAC3E,oEAAoE;YACpE,8DAA8D;YAC9D,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,UAAU,CAAA;YAC5D,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAA;YAC3G,MAAM,KAAK,GAAG,GAAW,EAAE;gBACzB,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,UAAU,GAAG,QAAQ,CAAA;gBACpE,IAAI,KAAK,IAAI,CAAC;oBAAE,OAAO,EAAE,CAAA;gBACzB,OAAO,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,CAAA;YAC3E,CAAC,CAAA;YACD,IAAI,IAAI,GAAG,KAAK,CAAA;YAChB,MAAM,IAAI,GAAG,GAAS,EAAE;gBACtB,IAAI,IAAI;oBAAE,OAAM;gBAChB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;YACnB,CAAC,CAAA;YACD,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAA;YACpD,IAAI,CAAC,KAAK,EAAE,EAAE,CAAA;YACd,uEAAuE;YACvE,qEAAqE;YACrE,qDAAqD;YACrD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAY,CAAC,OAAO,EAAE,EAAE;gBACjD,IAAI,SAAS,CAAC,OAAO;oBAAE,OAAO,CAAC,SAAS,CAAC,CAAA;;oBACpC,SAAS,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAAA,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;YACxF,CAAC,CAAC,CAAA;YACF,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,MAAe,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,QAAiB,CAAC,EAAE,OAAO,CAAC,CAAC,CAAA;gBACxH,oEAAoE;gBACpE,sEAAsE;gBACtE,gCAAgC;gBAChC,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;oBACvB,qEAAqE;oBACrE,sEAAsE;oBACtE,0BAA0B;oBAC1B,QAAQ,GAAG,KAAK,EAAE,CAAA;oBAClB,IAAI,QAAQ,KAAK,EAAE;wBAAE,QAAQ,CAAC,QAAQ,CAAC,CAAA;oBACvC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAA;gBAC7B,CAAC;gBACD,mEAAmE;gBACnE,sEAAsE;gBACtE,0BAA0B;gBAC1B,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,EAAE,CAAC;oBAC9H,MAAM,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAA;gBACpD,CAAC;gBACD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAA;YAC/C,CAAC;oBAAS,CAAC;gBACT,IAAI,GAAG,IAAI,CAAA;gBACX,aAAa,CAAC,IAAI,CAAC,CAAA;YACrB,CAAC;QACH,CAAC;KACF,CAAC,CAAA;IACF,IAAI,OAAO,CAAC,KAAK,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAC9C,0EAA0E;QAC1E,iCAAiC,CAAC,KAAK,EAAE,aAAa,OAAO,IAAI,EAAE,QAAQ,CAAC,CAAA;IAC9E,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,GAAY,EAAE,KAAY;IACrE,MAAM,SAAS,GAAG,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;IACtC,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,KAAK,CAAA;IACzC,8EAA8E;IAC9E,yEAAyE;IACzE,6EAA6E;IAC7E,4EAA4E;IAC5E,iCAAiC;IACjC,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,gBAAgB,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,CAAA;IAC5G,KAAK,MAAM,IAAI,IAAI,MAAM;QAAE,MAAM,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,4CAA4C,CAAC,CAAA;IACpH,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAA;AAC1B,CAAC;AAED,4EAA4E;AAC5E,MAAM,oBAAoB,GAAG,GAAG,CAAA"}

package/lib/runtime/file-recovery-local.d.ts

@@ -0,0 +1,73 @@
+/** Local host recovery provider over public filesystem, process and sandbox seams. */
+import { Context, Service, type Volatile } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
+import type { Agent } from '@deepseek-ai/dsh-agent';
+import { type ContextFormed } from '@deepseek-ai/dsh-llm';
+import { FileRecoveryStore, type RecoverySnapshot } from './file-recovery-store.ts';
+import type { RecoveryWorkerResult } from './file-recovery-worker.ts';
+import { type TurnRecoveryRecord } from './file-recovery-recording.ts';
+export interface Config {
+    stateDir?: string;
+    enabled: Volatile<boolean>;
+}
+export interface RecoveryReceiptEntry {
+    path: string;
+    operationId: string;
+    backup: string;
+    status: RecoveryWorkerResult['status'] | 'planned' | 'uncertain' | 'cancelled';
+    reason?: string;
+}
+export interface RecoveryReceipt {
+    version: 1;
+    id: string;
+    sessionId: string;
+    root: string;
+    before: string;
+    after: string;
+    startedAt: number;
+    completedAt?: number;
+    entries: RecoveryReceiptEntry[];
+}
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        omdshFileRecovery: LocalFileRecovery;
+    }
+}
+declare module '@deepseek-ai/dsh-llm' {
+    interface MessageSourceMap {
+        'omdsh-file-recovery': {
+            kind: 'omdsh-file-recovery';
+        } & ContextFormed;
+    }
+}
+export declare class LocalFileRecovery extends Service {
+    static inject: string[];
+    static Config: z<Schemastery.ObjectS<NoInfer<{
+        stateDir: z<string, string, "plain">;
+        enabled: z<boolean, boolean, "volatile-defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        stateDir: z<string, string, "plain">;
+        enabled: z<boolean, boolean, "volatile-defined">;
+    }>>, "plain">;
+    readonly store: FileRecoveryStore;
+    get enabled(): boolean;
+    private readonly recoveryConfig;
+    private readonly recording;
+    private readonly ownerContext;
+    private readonly closing;
+    private readonly tasks;
+    private readonly ownerLifetimes;
+    constructor(ctx: Context, config: Config);
+    checkpoint(sessionId: string, turn: number): Promise<TurnRecoveryRecord | undefined>;
+    private track;
+    private ownerSignal;
+    private rootOf;
+    private git;
+    private inventory;
+    capture(agent: Agent, retainedPaths: readonly string[], upstream: AbortSignal): Promise<RecoverySnapshot>;
+    restore(agent: Agent, before: string, after: string, paths: readonly string[], upstream: AbortSignal): Promise<RecoveryReceipt>;
+    private saveReceipt;
+    readReceipt(id: string): Promise<RecoveryReceipt>;
+    savedReports(before: string, after: string, signal: AbortSignal): Promise<RecoveryReceipt[]>;
+}
+export default LocalFileRecovery;

package/lib/runtime/file-recovery-local.js

@@ -0,0 +1,351 @@
+/** Local host recovery provider over public filesystem, process and sandbox seams. */
+import { Service } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
+import { randomUUID } from 'node:crypto';
+import { lstat, mkdir, open, readFile, readdir, realpath, rename, rm } from 'node:fs/promises';
+import { dirname, isAbsolute, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { homedir } from 'node:os';
+import { createUserMessage } from '@deepseek-ai/dsh-llm';
+import { SubprocessExecutableNotFoundError } from '@deepseek-ai/dsh-subprocess';
+import { FileRecoveryStore, recoveryRelativePath } from "./file-recovery-store.js";
+import { currentWorkingDirectory } from "../session/working-directory.js";
+import { TurnRecoveryRecording } from "./file-recovery-recording.js";
+const isReserved = (path) => path.split('/').some(part => part.toLowerCase() === '.git' || part.startsWith('.omdsh-recovery-'));
+export class LocalFileRecovery extends Service {
+    static inject = ['agents', 'fs', 'subprocess', 'sandbox', 'sandboxPolicy'];
+    static Config = z.object({ stateDir: z.string().hidden(), enabled: z.boolean().default(false).description('Keep private file snapshots for new Turns; uses disk space and adds capture work.').volatile() });
+    store;
+    get enabled() { return this.recoveryConfig.enabled.get(); }
+    recoveryConfig;
+    recording;
+    ownerContext;
+    closing = new AbortController();
+    tasks = new Set();
+    ownerLifetimes = new WeakMap();
+    constructor(ctx, config) {
+        super(ctx, 'omdshFileRecovery');
+        if (config.stateDir !== undefined && (typeof config.stateDir !== 'string' || config.stateDir.trim() === ''))
+            throw new Error('File recovery requires a private state directory.');
+        this.ownerContext = ctx;
+        this.store = new FileRecoveryStore(config.stateDir ?? join(process.env.OMDSH_HOME || process.env.DSH_HOME || join(homedir(), '.dsh'), 'omdsh/file-recovery'));
+        this.recoveryConfig = config;
+        ctx.on('agent/disposed', ({ agent }) => { this.ownerLifetimes.get(agent)?.abort(new Error('The file recovery owner was closed.')); });
+        ctx.effect(() => async () => { this.closing.abort(new Error('File recovery unloaded.')); await Promise.allSettled(this.tasks); });
+        this.recording = new TurnRecoveryRecording(ctx, this);
+    }
+    checkpoint(sessionId, turn) { return this.recording.get(sessionId, turn); }
+    track(signal, operation) {
+        const fused = AbortSignal.any([signal, this.closing.signal]);
+        const task = Promise.resolve().then(() => { fused.throwIfAborted(); return operation(fused); }).finally(() => { this.tasks.delete(task); });
+        this.tasks.add(task);
+        return task;
+    }
+    ownerSignal(agent, upstream) {
+        let lifetime = this.ownerLifetimes.get(agent);
+        if (lifetime === undefined) {
+            lifetime = new AbortController();
+            this.ownerLifetimes.set(agent, lifetime);
+        }
+        return AbortSignal.any([upstream, lifetime.signal]);
+    }
+    async rootOf(agent, signal, capturedRoot) {
+        const ctx = this.ownerContext;
+        if (ctx.get('agents').get(agent.id) !== agent)
+            throw new Error('File recovery requires the exact live session owner.');
+        const cwd = capturedRoot ?? currentWorkingDirectory(ctx, agent.session);
+        const target = await ctx.get('fs').resolve(cwd, { signal });
+        const path = ctx.get('fs').processPath(target), host = ctx.get('fs').processPathFromHostPath(cwd);
+        const platform = (await ctx.get('subprocess').terminalEnvironment(signal)).platform;
+        if (host === undefined || platform !== (process.platform === 'win32' ? 'windows' : 'posix'))
+            throw new Error('This file recovery provider requires a local execution world.');
+        const root = await realpath(cwd);
+        if (await realpath(path) !== root || await realpath(host) !== root)
+            throw new Error('The filesystem and recovery workspace do not share one local execution world.');
+        return root;
+    }
+    async git(root, args, signal) {
+        const provider = this.ownerContext.get('subprocess'), executable = await provider.resolveExecutable('git', undefined, signal);
+        const handle = provider.spawn({ argv: [executable, '-C', root, ...args], cwd: root, graceMs: 500, signal,
+            stdio: { stdin: 'ignore', stdout: { maxBytes: 2 * 1024 * 1024 }, stderr: { maxBytes: 16 * 1024 } } });
+        const outcome = await handle.done;
+        const output = handle.collected.stdout.readFrom(0);
+        if (output.lossy)
+            throw new Error('The Git recovery inventory exceeds its output limit.');
+        signal.throwIfAborted();
+        return { code: outcome.exitCode, text: output.text };
+    }
+    async inventory(root, signal) {
+        let git = false;
+        try {
+            git = (await this.git(root, ['rev-parse', '--is-inside-work-tree'], signal)).code === 0;
+        }
+        catch (error) {
+            if (!(error instanceof SubprocessExecutableNotFoundError))
+                throw error;
+        }
+        if (git) {
+            const index = await this.git(root, ['ls-files', '--stage', '-z'], signal);
+            const others = await this.git(root, ['ls-files', '--others', '--exclude-standard', '-z'], signal);
+            const ignored = await this.git(root, ['ls-files', '--others', '--ignored', '--exclude-standard', '--directory', '-z'], signal);
+            if (index.code !== 0 || others.code !== 0 || ignored.code !== 0)
+                throw new Error('Git could not provide a complete recovery inventory.');
+            const paths = [], protectedPaths = [], excluded = ignored.text.split('\0').filter(Boolean).filter(path => !isReserved(path));
+            for (const record of index.text.split('\0').filter(Boolean)) {
+                const at = record.indexOf('\t');
+                if (at < 0)
+                    throw new Error('Invalid Git recovery inventory.');
+                const path = record.slice(at + 1);
+                if (isReserved(path))
+                    continue;
+                if (record.startsWith('160000 ')) {
+                    excluded.push(path + '/');
+                    protectedPaths.push(path + '/');
+                }
+                else
+                    paths.push(path);
+            }
+            for (const path of others.text.split('\0').filter(Boolean).filter(path => !isReserved(path))) {
+                if (path.endsWith('/')) {
+                    excluded.push(path);
+                    protectedPaths.push(path);
+                }
+                else
+                    paths.push(path);
+            }
+            return { paths, excluded, protected: protectedPaths };
+        }
+        const paths = [];
+        const walk = async (directory, prefix) => {
+            for (const entry of await readdir(directory, { withFileTypes: true })) {
+                signal.throwIfAborted();
+                const path = prefix + entry.name;
+                if (isReserved(path))
+                    continue;
+                recoveryRelativePath(path);
+                if (entry.isDirectory())
+                    await walk(join(directory, entry.name), path + '/');
+                else
+                    paths.push(path);
+                if (paths.length > this.store.limits.maxFiles)
+                    throw new Error('The workspace exceeds the recovery file limit.');
+            }
+        };
+        await walk(root, '');
+        return { paths, excluded: [] };
+    }
+    capture(agent, retainedPaths, upstream) {
+        return this.track(this.ownerSignal(agent, upstream), async (signal) => {
+            const root = await this.rootOf(agent, signal);
+            return this.store.capture(root, async () => {
+                const current = await this.inventory(root, signal);
+                return { ...current, paths: [...current.paths, ...retainedPaths.filter(path => !(current.protected ?? []).some(prefix => path.startsWith(prefix)))] };
+            }, signal);
+        });
+    }
+    restore(agent, before, after, paths, upstream) {
+        return this.track(this.ownerSignal(agent, upstream), signal => agent.runMaintenance(async (maintenance) => {
+            const fused = AbortSignal.any([signal, maintenance]), plan = await this.store.plan(before, after, fused);
+            const root = await this.rootOf(agent, fused, plan.root);
+            const liveProtected = (await this.inventory(root, fused)).protected ?? [];
+            if (plan.root !== root)
+                throw new Error('The checkpoint belongs to another workspace.');
+            const unique = new Set(paths.map(recoveryRelativePath));
+            if (unique.size === 0 || [...unique].some(path => !plan.operations.some(operation => operation.path === path)))
+                throw new Error('Select captured file changes to restore.');
+            const receipt = { version: 1, id: 'restore-' + randomUUID(), sessionId: agent.id, root, before, after, startedAt: Date.now(),
+                entries: plan.operations.filter(operation => unique.has(operation.path)).map(operation => {
+                    const operationId = randomUUID(), parent = operation.path.includes('/') ? operation.path.slice(0, operation.path.lastIndexOf('/') + 1) : '';
+                    return { path: operation.path, operationId, backup: parent + '.omdsh-recovery-' + operationId + '.backup', status: 'planned' };
+                }) };
+            // Each intent is durable before the worker can mutate a file. A process
+            // crash leaves a planned entry whose completion is explicitly unconfirmed.
+            await this.saveReceipt(receipt);
+            for (const entry of receipt.entries) {
+                if (fused.aborted) {
+                    entry.status = 'cancelled';
+                    entry.backup = '';
+                    continue;
+                }
+                const operation = plan.operations.find(operation => operation.path === entry.path);
+                if (liveProtected.some(prefix => entry.path.startsWith(prefix))) {
+                    entry.status = 'conflict';
+                    entry.backup = '';
+                    entry.reason = 'This path is now inside a protected Git submodule.';
+                    await this.saveReceipt(receipt);
+                    continue;
+                }
+                if (operation.status !== 'ready') {
+                    entry.status = operation.status;
+                    entry.backup = '';
+                    if (operation.reason !== undefined)
+                        entry.reason = operation.reason;
+                    await this.saveReceipt(receipt);
+                    continue;
+                }
+                const policy = this.ownerContext.get('sandboxPolicy').resolve({ session: agent.session });
+                if (policy.mode === 'read-only') {
+                    entry.status = 'failed';
+                    entry.backup = '';
+                    entry.reason = 'Access is Read only. Change Access before restoring files.';
+                    await this.saveReceipt(receipt);
+                    continue;
+                }
+                if (policy.mode !== 'danger-full-access') {
+                    const fs = this.ownerContext.get('fs'), boundary = await fs.resolve(policy.workspaceRoot, { signal: fused }), target = await fs.resolve(root, { signal: fused });
+                    if (!fs.contains(boundary, target)) {
+                        entry.status = 'failed';
+                        entry.backup = '';
+                        entry.reason = 'The captured directory is outside the current Access boundary.';
+                        await this.saveReceipt(receipt);
+                        continue;
+                    }
+                }
+                const argv = [process.execPath, fileURLToPath(new URL(import.meta.url.endsWith('.ts') ? './file-recovery-worker.ts' : './file-recovery-worker.js', import.meta.url)), '--omdsh-recovery-worker'];
+                let confined;
+                try {
+                    confined = await this.ownerContext.get('sandbox').confine(argv, { mode: 'workspace-write', workspaceRoot: root, sessionId: agent.id }, fused);
+                }
+                catch (error) {
+                    entry.status = fused.aborted ? 'cancelled' : 'failed';
+                    entry.backup = '';
+                    entry.reason = error instanceof Error ? error.message : String(error);
+                    await this.saveReceipt(receipt);
+                    continue;
+                }
+                const request = { root, rootIdentity: plan.rootIdentity, directory: this.store.directory, operation,
+                    operationId: entry.operationId, maxFileBytes: this.store.limits.maxFileBytes };
+                let handle;
+                try {
+                    handle = this.ownerContext.get('subprocess').spawn({ argv: confined.argv, cwd: root, graceMs: 500, signal: fused,
+                        stdio: { stdin: 'pipe', stdout: { maxBytes: 64 * 1024 }, stderr: { maxBytes: 16 * 1024 } } });
+                }
+                catch (error) {
+                    entry.status = fused.aborted ? 'cancelled' : 'failed';
+                    entry.backup = '';
+                    entry.reason = error instanceof Error ? error.message : String(error);
+                    await this.saveReceipt(receipt);
+                    continue;
+                }
+                handle.stdin.on('error', () => { });
+                handle.stdin.end(JSON.stringify(request));
+                try {
+                    const outcome = await handle.done;
+                    const output = handle.collected.stdout.readFrom(0);
+                    if (outcome.exitCode !== 0 || output.lossy)
+                        throw new Error('Recovery worker did not confirm completion. Inspect the receipt and retained backup.');
+                    const result = JSON.parse(output.text);
+                    if (!validWorkerResult(result, entry.path))
+                        throw new Error('Invalid recovery worker result; completion is unconfirmed.');
+                    entry.status = result.status;
+                    if (result.reason !== undefined)
+                        entry.reason = result.reason;
+                    if (result.backup === undefined)
+                        entry.backup = '';
+                    else if (result.backup !== entry.backup)
+                        throw new Error('Recovery worker returned an unexpected backup path.');
+                }
+                catch (error) {
+                    entry.status = 'uncertain';
+                    entry.reason = error instanceof Error ? error.message : String(error);
+                }
+                finally {
+                    await handle.waitForExit();
+                    await this.saveReceipt(receipt);
+                }
+            }
+            receipt.completedAt = Date.now();
+            await this.saveReceipt(receipt);
+            if (receipt.entries.some(entry => entry.status === 'restored' || entry.status === 'uncertain')) {
+                try {
+                    agent.inject(createUserMessage({ source: { kind: 'omdsh-file-recovery', form: 'notice', summary: 'File recovery changed or may have changed workspace files.' },
+                        content: [{ type: 'text', text: `The user attempted file recovery in ${JSON.stringify(root)}. Results: ${JSON.stringify(receipt.entries.map(entry => ({ path: entry.path, status: entry.status })))}. Re-read affected files before relying on earlier observations. Uncertain results do not establish completion.` }] }));
+                }
+                catch {
+                    this.ownerContext.logger.warn('File recovery completed, but its model notice could not be queued. The saved receipt retains the actual results.');
+                }
+            }
+            return receipt;
+        }));
+    }
+    async saveReceipt(receipt) {
+        const path = join(this.store.directory, 'receipts', receipt.id + '.json'), temp = path + '.' + randomUUID() + '.tmp';
+        await mkdir(dirname(path), { recursive: true, mode: 0o700 });
+        const handle = await open(temp, 'wx', 0o600);
+        try {
+            await handle.writeFile(JSON.stringify(receipt) + '\n');
+            await handle.sync();
+            await handle.close();
+            await rename(temp, path);
+        }
+        finally {
+            try {
+                await handle.close();
+            }
+            finally {
+                await rm(temp, { force: true });
+            }
+        }
+    }
+    async readReceipt(id) {
+        if (!/^restore-[a-f0-9-]{36}$/u.test(id))
+            throw new Error('Invalid recovery receipt identity.');
+        const path = join(this.store.directory, 'receipts', id + '.json'), stat = await lstat(path);
+        if (!stat.isFile() || stat.size > 8 * 1024 * 1024)
+            throw new Error('Recovery receipt must be a bounded regular file.');
+        const value = JSON.parse(await readFile(path, 'utf8'));
+        if (!validReceipt(value) || value.id !== id)
+            throw new Error('Invalid recovery receipt.');
+        return value;
+    }
+    async savedReports(before, after, signal) {
+        signal.throwIfAborted();
+        const names = await readdir(join(this.store.directory, 'receipts')).catch(error => {
+            if (error.code === 'ENOENT')
+                return [];
+            throw error;
+        });
+        if (names.length > 10_000)
+            throw new Error('The recovery report directory exceeds its inspection limit.');
+        const reports = [];
+        for (const name of names.filter(name => /^restore-[a-f0-9-]{36}\.json$/u.test(name))) {
+            signal.throwIfAborted();
+            const report = await this.readReceipt(name.slice(0, -5));
+            if (report.before === before && report.after === after)
+                reports.push(report);
+        }
+        return reports.sort((a, b) => b.startedAt - a.startedAt);
+    }
+}
+function validWorkerResult(value, path) {
+    if (value === null || typeof value !== 'object')
+        return false;
+    const result = value;
+    return result.path === path && ['restored', 'conflict', 'already-restored', 'failed'].includes(String(result.status))
+        && (result.reason === undefined || typeof result.reason === 'string') && (result.backup === undefined || typeof result.backup === 'string');
+}
+function validReceipt(value) {
+    if (value === null || typeof value !== 'object')
+        return false;
+    const receipt = value;
+    const validEntry = (entry) => {
+        try {
+            if (typeof entry?.path !== 'string' || recoveryRelativePath(entry.path) !== entry.path || typeof entry.operationId !== 'string'
+                || !/^[a-f0-9-]{36}$/u.test(entry.operationId) || typeof entry.backup !== 'string')
+                return false;
+            const parent = entry.path.includes('/') ? entry.path.slice(0, entry.path.lastIndexOf('/') + 1) : '';
+            return (entry.backup === '' || entry.backup === parent + '.omdsh-recovery-' + entry.operationId + '.backup')
+                && ['planned', 'restored', 'conflict', 'already-restored', 'failed', 'uncertain', 'cancelled'].includes(entry.status)
+                && (entry.reason === undefined || typeof entry.reason === 'string');
+        }
+        catch {
+            return false;
+        }
+    };
+    return receipt.version === 1 && typeof receipt.id === 'string' && typeof receipt.sessionId === 'string' && typeof receipt.root === 'string' && isAbsolute(receipt.root)
+        && typeof receipt.before === 'string' && typeof receipt.after === 'string' && Number.isSafeInteger(receipt.startedAt)
+        && (receipt.completedAt === undefined || Number.isSafeInteger(receipt.completedAt)) && Array.isArray(receipt.entries) && receipt.entries.length <= 10_000
+        && receipt.entries.every(validEntry);
+}
+export default LocalFileRecovery;
+//# sourceMappingURL=file-recovery-local.js.map

package/lib/runtime/file-recovery-local.js.map

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

package/lib/runtime/file-recovery-recording.d.ts

@@ -0,0 +1,23 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { LocalFileRecovery } from './file-recovery-local.ts';
+export interface TurnRecoveryRecord {
+    version: 1;
+    sessionId: string;
+    turn: number;
+    status: 'capturing' | 'ready' | 'unavailable';
+    before?: string;
+    after?: string;
+    error?: string;
+}
+export declare class TurnRecoveryRecording {
+    private readonly provider;
+    private readonly active;
+    private readonly tasks;
+    private readonly closing;
+    constructor(ctx: Context, provider: LocalFileRecovery);
+    private path;
+    private save;
+    private begin;
+    private finish;
+    get(sessionId: string, turn: number): Promise<TurnRecoveryRecord | undefined>;
+}

package/lib/runtime/file-recovery-recording.js

@@ -0,0 +1,131 @@
+/** Optional Turn snapshots over the public Agent lifecycle. */
+import { createHash, randomUUID } from 'node:crypto';
+import { lstat, mkdir, open, readFile, rename, rm } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { BTW_PRESET } from "./btw-policy.js";
+export class TurnRecoveryRecording {
+    provider;
+    active = new Map();
+    tasks = new Set();
+    closing = new AbortController();
+    constructor(ctx, provider) {
+        this.provider = provider;
+        ctx.on('agent/pre-step', async (payload, next) => {
+            const decision = await next();
+            if (decision.kind === 'reject' || !ctx.get('agents').roots().includes(payload.agent) || payload.agent.session.header.agentPreset === BTW_PRESET)
+                return decision;
+            const current = this.active.get(payload.agent);
+            if (payload.step === 1 && current?.record.turn !== payload.turn) {
+                if (current !== undefined)
+                    await this.finish(current);
+                if (provider.enabled)
+                    await this.begin(payload.agent, payload.turn, payload.signal);
+            }
+            else if (current?.record.turn === payload.turn && !current.dirty) {
+                current.dirty = true;
+                current.record.status = 'capturing';
+                delete current.record.after;
+                await this.save(current.record).catch(() => { });
+            }
+            return decision;
+        }, true);
+        ctx.on('agent/turn-stopping', async ({ agent }) => { const state = this.active.get(agent); if (state !== undefined)
+            await this.finish(state); });
+        ctx.on('agent/status', ({ agent, status }) => { const state = this.active.get(agent); if (status === 'idle' && state !== undefined)
+            void this.finish(state); });
+        ctx.on('agent/disposed', ({ agent }) => { this.active.delete(agent); });
+        ctx.effect(() => async () => { this.closing.abort(); await Promise.allSettled(this.tasks); this.active.clear(); });
+    }
+    path(sessionId, turn) {
+        if (!Number.isSafeInteger(turn) || turn <= 0)
+            throw new Error('Invalid recovery Turn.');
+        return join(this.provider.store.directory, 'turns', createHash('sha256').update(JSON.stringify([sessionId, turn])).digest('hex') + '.json');
+    }
+    async save(record) {
+        const path = this.path(record.sessionId, record.turn), temp = path + '.' + randomUUID() + '.tmp';
+        await mkdir(dirname(path), { recursive: true, mode: 0o700 });
+        const handle = await open(temp, 'wx', 0o600);
+        try {
+            await handle.writeFile(JSON.stringify(record) + '\n');
+            await handle.sync();
+            await handle.close();
+            await rename(temp, path);
+        }
+        finally {
+            try {
+                await handle.close();
+            }
+            finally {
+                await rm(temp, { force: true });
+            }
+        }
+    }
+    async begin(agent, turn, signal) {
+        const state = { agent, dirty: true, record: { version: 1, sessionId: agent.id, turn, status: 'capturing' } };
+        this.active.set(agent, state);
+        try {
+            await this.save(state.record);
+            state.before = await this.provider.capture(agent, [], AbortSignal.any([signal, this.closing.signal]));
+            state.record.before = state.before.id;
+            await this.save(state.record);
+        }
+        catch (error) {
+            state.record.status = 'unavailable';
+            state.record.error = error instanceof Error ? error.message : String(error);
+            await this.save(state.record).catch(() => { });
+        }
+    }
+    finish(state) {
+        if (state.finishing !== undefined)
+            return state.finishing;
+        if (!state.dirty || state.before === undefined)
+            return Promise.resolve();
+        const task = (async () => {
+            try {
+                const after = await this.provider.capture(state.agent, state.before.entries.map(entry => entry.path), this.closing.signal);
+                if (after.root !== state.before.root || after.rootIdentity !== state.before.rootIdentity)
+                    throw new Error('The working directory changed during this Turn; no complete file checkpoint is available.');
+                state.record.after = after.id;
+                state.record.status = 'ready';
+                delete state.record.error;
+            }
+            catch (error) {
+                state.record.status = 'unavailable';
+                state.record.error = error instanceof Error ? error.message : String(error);
+            }
+            state.dirty = false;
+            await this.save(state.record).catch(() => { state.record.status = 'unavailable'; state.record.error = 'The file checkpoint could not be saved.'; });
+        })().finally(() => { delete state.finishing; this.tasks.delete(task); });
+        state.finishing = task;
+        this.tasks.add(task);
+        return task;
+    }
+    async get(sessionId, turn) {
+        const state = [...this.active.values()].find(value => value.record.sessionId === sessionId && value.record.turn === turn);
+        if (state !== undefined) {
+            await state.finishing;
+            return { ...state.record };
+        }
+        const path = this.path(sessionId, turn);
+        const stat = await lstat(path).catch(error => { if (error.code === 'ENOENT')
+            return undefined; throw error; });
+        if (stat === undefined)
+            return undefined;
+        if (!stat.isFile() || stat.size > 32 * 1024)
+            throw new Error('Invalid Turn recovery record.');
+        const value = JSON.parse(await readFile(path, 'utf8'));
+        if (!validRecord(value) || value.sessionId !== sessionId || value.turn !== turn)
+            throw new Error('Invalid Turn recovery record.');
+        return value;
+    }
+}
+function validRecord(value) {
+    if (value === null || typeof value !== 'object')
+        return false;
+    const record = value;
+    const snapshot = (id) => id === undefined || typeof id === 'string' && /^snapshot-[a-f0-9-]{36}$/u.test(id);
+    return record.version === 1 && typeof record.sessionId === 'string' && Number.isSafeInteger(record.turn)
+        && ['capturing', 'ready', 'unavailable'].includes(String(record.status)) && snapshot(record.before) && snapshot(record.after)
+        && (record.error === undefined || typeof record.error === 'string') && (record.status !== 'ready' || record.before !== undefined && record.after !== undefined);
+}
+//# sourceMappingURL=file-recovery-recording.js.map