@deepagents/context 3.1.0 → 4.1.0

package/dist/lib/sandbox/file-changes.d.ts

@@ -1,83 +0,0 @@
-import type { DisposableSandbox } from './types.ts';
-/**
- * A single filesystem mutation observed for one tool call. Ops are
- * deliberately coarse: strace cannot distinguish a brand-new file from an
- * overwrite within a single command (both are `O_CREAT|O_TRUNC`), so
- * content-touching syscalls collapse to `write`. `delete` and `rename` are
- * unambiguous. Reads are not tracked — strace's syscall filter excludes them.
- */
-export type FileChangeOp = 'write' | 'delete' | 'rename';
-export interface FileChange {
-    op: FileChangeOp;
-    path: string;
-    /** Source path for a `rename`. */
-    from?: string;
-    timestamp: number;
-}
-export type StraceUnavailableReason = 'ptrace-blocked' | 'strace-missing' | 'trace-unparseable';
-/**
- * Thrown by {@link selfTestStrace} when per-command strace tracking cannot be
- * used. `reason` lets callers branch (fix-image vs fix-caps vs fix-arch). This
- * is a hard failure by design — there is no silent degrade to the snapshot
- * observer.
- */
-export declare class StraceUnavailableError extends Error {
-    readonly reason: StraceUnavailableReason;
-    readonly diagnostics: string;
-    constructor(reason: StraceUnavailableReason, diagnostics: string);
-}
-export interface ParseStraceOptions {
-    destination: string;
-    traceFile?: string;
-    traceDir?: string;
-}
-/**
- * Parse one command's strace output into a coarse `FileChange[]`. Failed
- * syscalls are skipped; paths are filtered to `destination`; the trace file and
- * `/proc`,`/sys`,`/dev` are excluded. Per-path final state collapses repeated
- * writes to one `write`; a path written then deleted within the command is
- * treated as transient and dropped.
- */
-export declare function parseStraceTrace(raw: string, options: ParseStraceOptions): FileChange[];
-export interface TraceFileChangesOptions {
-    destination: string;
-    onFileChanges?: (changes: FileChange[]) => void | Promise<void>;
-    /**
-     * Called when `onFileChanges` throws on the `spawn` path — its only failure
-     * signal, since spawn has no tool result and no exception catcher upstream. A
-     * throw on the tool-call path fails the command instead, so it never reaches
-     * here. Defaults to `console.warn`.
-     */
-    onError?: (error: unknown) => void;
-    traceDir?: string;
-}
-/**
- * Decorates a sandbox so each `executeCommand` is traced and its filesystem
- * mutations parsed into a per-call `FileChange[]`. Per-call attribution is
- * structural — one trace file per `callId` — so it is safe under concurrent
- * tool calls. Each call's manifest is surfaced two stateless ways: attached to
- * the tool result via the bash-meta channel (`meta.fileChanges`, hidden from the
- * model) and passed to `onFileChanges`. No buffer is retained.
- *
- * `readFile` passes through unchanged; `writeFiles` is observed directly (it
- * mutates outside strace's view) — each written file under the observation root
- * becomes a `write` change fed to onFileChanges. `dispose` also sweeps the trace
- * dir. `spawn` is traced the same way — its trace is read when the process exits
- * (strace is the top process, so the trace is fully flushed by then). `spawn`
- * carries no bash-meta scope, so its changes go to `onFileChanges` only.
- *
- * The trace file is always swept once parsed. A throwing `onFileChanges` on the
- * tool-call path propagates to `withBashExceptionCatch` one level up: a caller's
- * `BashException` becomes the tool result (via its `format()`), any other error
- * fails the tool call. The `spawn` path has no exception catcher, so its throw is
- * isolated and surfaced only via `onError` (exit result preserved).
- */
-export declare function traceFileChanges(sandbox: DisposableSandbox, options: TraceFileChangesOptions): DisposableSandbox;
-/**
- * One-time probe at sandbox setup. Runs a known create/write/rename sequence
- * under strace and asserts the trace is clean and parseable. Throws
- * {@link StraceUnavailableError} (hard-fail) when ptrace is blocked, strace is
- * absent, or the trace is garbled (e.g. amd64 under Rosetta).
- */
-export declare function selfTestStrace(sandbox: DisposableSandbox): Promise<void>;
-//# sourceMappingURL=file-changes.d.ts.map

package/dist/lib/sandbox/file-changes.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"file-changes.d.ts","sourceRoot":"","sources":["../../../src/lib/sandbox/file-changes.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEzD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,YAAY,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,uBAAuB,GAC/B,gBAAgB,GAChB,gBAAgB,GAChB,mBAAmB,CAAC;AAWxB;;;;;GAKG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;gBAEjB,MAAM,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM;CAQjE;AAgKD,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,kBAAkB,GAC1B,UAAU,EAAE,CA+Fd;AAED,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE;;;;;OAKG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AASD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,uBAAuB,GAC/B,iBAAiB,CAmInB;AASD;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAoDf"}