@librechat/agents 3.2.31 → 3.2.33

package/dist/cjs/tools/local/FileCheckpointer.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"FileCheckpointer.cjs","sources":["../../../../src/tools/local/FileCheckpointer.ts"],"sourcesContent":["import { dirname } from 'path';\nimport type { WorkspaceFS } from './workspaceFS';\nimport type * as t from '@/types';\nimport { nodeWorkspaceFS } from './workspaceFS';\n\ntype Snapshot = { kind: 'absent' } | { kind: 'present'; content: Buffer };\n\n/**\n * Per-Run snapshot store for write_file / edit_file. Captures the\n * pre-write byte content of every path the local engine is about to\n * mutate so a later `rewind()` can restore the working tree to its\n * original state. Notes:\n *\n *  - Idempotent per path: subsequent captures preserve the first\n *    snapshot (so rewind always restores the *original* content).\n *  - Captures missing files as `{ kind: 'absent' }`; rewind deletes\n *    those paths so created files are removed.\n *  - In-memory: snapshots live for the lifetime of this instance and\n *    are not persisted across processes. Tie the lifetime to a Run.\n *  - Bounded by `maxBytesPerFile` (default 32 MiB) to bound memory.\n *    A file larger than the cap is recorded but not snapshotted; the\n *    rewind of that path is best-effort and the caller is told via\n *    the result count not to trust it.\n */\nexport class LocalFileCheckpointerImpl implements t.LocalFileCheckpointer {\n  private snapshots = new Map<string, Snapshot>();\n  private oversizePaths = new Set<string>();\n\n  constructor(\n    private readonly maxBytesPerFile: number = 32 * 1024 * 1024,\n    private readonly fs: WorkspaceFS = nodeWorkspaceFS\n  ) {}\n\n  async captureBeforeWrite(absolutePath: string): Promise<void> {\n    if (\n      this.snapshots.has(absolutePath) ||\n      this.oversizePaths.has(absolutePath)\n    ) {\n      return;\n    }\n    let info;\n    try {\n      info = await this.fs.stat(absolutePath);\n    } catch {\n      this.snapshots.set(absolutePath, { kind: 'absent' });\n      return;\n    }\n    if (!info.isFile()) {\n      return;\n    }\n    if (info.size > this.maxBytesPerFile) {\n      this.oversizePaths.add(absolutePath);\n      return;\n    }\n    const content = (await this.fs.readFile(absolutePath)) as Buffer;\n    this.snapshots.set(absolutePath, { kind: 'present', content });\n  }\n\n  async rewind(): Promise<number> {\n    let restored = 0;\n    for (const [path, snapshot] of this.snapshots.entries()) {\n      if (snapshot.kind === 'absent') {\n        await this.fs.unlink(path).catch(() => undefined);\n        restored++;\n        continue;\n      }\n      try {\n        await this.fs.mkdir(dirname(path), { recursive: true });\n        await this.fs.writeFile(path, snapshot.content);\n        restored++;\n      } catch {\n        // Best-effort: ignore individual restore failures so the rest\n        // of the rewind continues.\n      }\n    }\n    return restored;\n  }\n\n  capturedPaths(): string[] {\n    return [...this.snapshots.keys(), ...this.oversizePaths];\n  }\n}\n\n/**\n * Convenience factory so callers don't have to reach for the impl\n * class directly. Accepts an optional `WorkspaceFS` so a host using a\n * non-default engine (remote sandbox, in-memory test FS, etc.) can\n * route the checkpointer through the same I/O.\n */\nexport function createLocalFileCheckpointer(\n  options: { maxBytesPerFile?: number; fs?: WorkspaceFS } = {}\n): t.LocalFileCheckpointer {\n  return new LocalFileCheckpointerImpl(options.maxBytesPerFile, options.fs);\n}\n"],"names":["nodeWorkspaceFS","path","dirname"],"mappings":";;;;;AAOA;;;;;;;;;;;;;;;;AAgBG;MACU,yBAAyB,CAAA;AAKjB,IAAA,eAAA;AACA,IAAA,EAAA;AALX,IAAA,SAAS,GAAG,IAAI,GAAG,EAAoB;AACvC,IAAA,aAAa,GAAG,IAAI,GAAG,EAAU;IAEzC,WAAA,CACmB,eAAA,GAA0B,EAAE,GAAG,IAAI,GAAG,IAAI,EAC1C,KAAkBA,2BAAe,EAAA;QADjC,IAAA,CAAA,eAAe,GAAf,eAAe;QACf,IAAA,CAAA,EAAE,GAAF,EAAE;IAClB;IAEH,MAAM,kBAAkB,CAAC,YAAoB,EAAA;AAC3C,QAAA,IACE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC;YAChC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,YAAY,CAAC,EACpC;YACA;QACF;AACA,QAAA,IAAI,IAAI;AACR,QAAA,IAAI;YACF,IAAI,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC;QACzC;AAAE,QAAA,MAAM;AACN,YAAA,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;YACpD;QACF;AACA,QAAA,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE;YAClB;QACF;QACA,IAAI,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,eAAe,EAAE;AACpC,YAAA,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,YAAY,CAAC;YACpC;QACF;AACA,QAAA,MAAM,OAAO,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAW;AAChE,QAAA,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;IAChE;AAEA,IAAA,MAAM,MAAM,GAAA;QACV,IAAI,QAAQ,GAAG,CAAC;AAChB,QAAA,KAAK,MAAM,CAACC,MAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE;AACvD,YAAA,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ,EAAE;AAC9B,gBAAA,MAAM,IAAI,CAAC,EAAE,CAAC,MAAM,CAACA,MAAI,CAAC,CAAC,KAAK,CAAC,MAAM,SAAS,CAAC;AACjD,gBAAA,QAAQ,EAAE;gBACV;YACF;AACA,YAAA,IAAI;AACF,gBAAA,MAAM,IAAI,CAAC,EAAE,CAAC,KAAK,CAACC,YAAO,CAACD,MAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AACvD,gBAAA,MAAM,IAAI,CAAC,EAAE,CAAC,SAAS,CAACA,MAAI,EAAE,QAAQ,CAAC,OAAO,CAAC;AAC/C,gBAAA,QAAQ,EAAE;YACZ;AAAE,YAAA,MAAM;;;YAGR;QACF;AACA,QAAA,OAAO,QAAQ;IACjB;IAEA,aAAa,GAAA;AACX,QAAA,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,aAAa,CAAC;IAC1D;AACD;AAED;;;;;AAKG;AACG,SAAU,2BAA2B,CACzC,OAAA,GAA0D,EAAE,EAAA;IAE5D,OAAO,IAAI,yBAAyB,CAAC,OAAO,CAAC,eAAe,EAAE,OAAO,CAAC,EAAE,CAAC;AAC3E;;;;;"}
+{"version":3,"file":"FileCheckpointer.cjs","names":["nodeWorkspaceFS","path"],"sources":["../../../../src/tools/local/FileCheckpointer.ts"],"sourcesContent":["import { dirname } from 'path';\nimport type { WorkspaceFS } from './workspaceFS';\nimport type * as t from '@/types';\nimport { nodeWorkspaceFS } from './workspaceFS';\n\ntype Snapshot = { kind: 'absent' } | { kind: 'present'; content: Buffer };\n\n/**\n * Per-Run snapshot store for write_file / edit_file. Captures the\n * pre-write byte content of every path the local engine is about to\n * mutate so a later `rewind()` can restore the working tree to its\n * original state. Notes:\n *\n *  - Idempotent per path: subsequent captures preserve the first\n *    snapshot (so rewind always restores the *original* content).\n *  - Captures missing files as `{ kind: 'absent' }`; rewind deletes\n *    those paths so created files are removed.\n *  - In-memory: snapshots live for the lifetime of this instance and\n *    are not persisted across processes. Tie the lifetime to a Run.\n *  - Bounded by `maxBytesPerFile` (default 32 MiB) to bound memory.\n *    A file larger than the cap is recorded but not snapshotted; the\n *    rewind of that path is best-effort and the caller is told via\n *    the result count not to trust it.\n */\nexport class LocalFileCheckpointerImpl implements t.LocalFileCheckpointer {\n  private snapshots = new Map<string, Snapshot>();\n  private oversizePaths = new Set<string>();\n\n  constructor(\n    private readonly maxBytesPerFile: number = 32 * 1024 * 1024,\n    private readonly fs: WorkspaceFS = nodeWorkspaceFS\n  ) {}\n\n  async captureBeforeWrite(absolutePath: string): Promise<void> {\n    if (\n      this.snapshots.has(absolutePath) ||\n      this.oversizePaths.has(absolutePath)\n    ) {\n      return;\n    }\n    let info;\n    try {\n      info = await this.fs.stat(absolutePath);\n    } catch {\n      this.snapshots.set(absolutePath, { kind: 'absent' });\n      return;\n    }\n    if (!info.isFile()) {\n      return;\n    }\n    if (info.size > this.maxBytesPerFile) {\n      this.oversizePaths.add(absolutePath);\n      return;\n    }\n    const content = (await this.fs.readFile(absolutePath)) as Buffer;\n    this.snapshots.set(absolutePath, { kind: 'present', content });\n  }\n\n  async rewind(): Promise<number> {\n    let restored = 0;\n    for (const [path, snapshot] of this.snapshots.entries()) {\n      if (snapshot.kind === 'absent') {\n        await this.fs.unlink(path).catch(() => undefined);\n        restored++;\n        continue;\n      }\n      try {\n        await this.fs.mkdir(dirname(path), { recursive: true });\n        await this.fs.writeFile(path, snapshot.content);\n        restored++;\n      } catch {\n        // Best-effort: ignore individual restore failures so the rest\n        // of the rewind continues.\n      }\n    }\n    return restored;\n  }\n\n  capturedPaths(): string[] {\n    return [...this.snapshots.keys(), ...this.oversizePaths];\n  }\n}\n\n/**\n * Convenience factory so callers don't have to reach for the impl\n * class directly. Accepts an optional `WorkspaceFS` so a host using a\n * non-default engine (remote sandbox, in-memory test FS, etc.) can\n * route the checkpointer through the same I/O.\n */\nexport function createLocalFileCheckpointer(\n  options: { maxBytesPerFile?: number; fs?: WorkspaceFS } = {}\n): t.LocalFileCheckpointer {\n  return new LocalFileCheckpointerImpl(options.maxBytesPerFile, options.fs);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAwBA,IAAa,4BAAb,MAA0E;CAKrD;CACA;CALnB,4BAAoB,IAAI,IAAsB;CAC9C,gCAAwB,IAAI,IAAY;CAExC,YACE,kBAA2C,KAAK,OAAO,MACvD,KAAmCA,oBAAAA,iBACnC;EAFiB,KAAA,kBAAA;EACA,KAAA,KAAA;CAChB;CAEH,MAAM,mBAAmB,cAAqC;EAC5D,IACE,KAAK,UAAU,IAAI,YAAY,KAC/B,KAAK,cAAc,IAAI,YAAY,GAEnC;EAEF,IAAI;EACJ,IAAI;GACF,OAAO,MAAM,KAAK,GAAG,KAAK,YAAY;EACxC,QAAQ;GACN,KAAK,UAAU,IAAI,cAAc,EAAE,MAAM,SAAS,CAAC;GACnD;EACF;EACA,IAAI,CAAC,KAAK,OAAO,GACf;EAEF,IAAI,KAAK,OAAO,KAAK,iBAAiB;GACpC,KAAK,cAAc,IAAI,YAAY;GACnC;EACF;EACA,MAAM,UAAW,MAAM,KAAK,GAAG,SAAS,YAAY;EACpD,KAAK,UAAU,IAAI,cAAc;GAAE,MAAM;GAAW;EAAQ,CAAC;CAC/D;CAEA,MAAM,SAA0B;EAC9B,IAAI,WAAW;EACf,KAAK,MAAM,CAACC,QAAM,aAAa,KAAK,UAAU,QAAQ,GAAG;GACvD,IAAI,SAAS,SAAS,UAAU;IAC9B,MAAM,KAAK,GAAG,OAAOA,MAAI,CAAC,CAAC,YAAY,KAAA,CAAS;IAChD;IACA;GACF;GACA,IAAI;IACF,MAAM,KAAK,GAAG,OAAA,GAAA,KAAA,QAAA,CAAcA,MAAI,GAAG,EAAE,WAAW,KAAK,CAAC;IACtD,MAAM,KAAK,GAAG,UAAUA,QAAM,SAAS,OAAO;IAC9C;GACF,QAAQ,CAGR;EACF;EACA,OAAO;CACT;CAEA,gBAA0B;EACxB,OAAO,CAAC,GAAG,KAAK,UAAU,KAAK,GAAG,GAAG,KAAK,aAAa;CACzD;AACF;;;;;;;AAQA,SAAgB,4BACd,UAA0D,CAAC,GAClC;CACzB,OAAO,IAAI,0BAA0B,QAAQ,iBAAiB,QAAQ,EAAE;AAC1E"}