@elie-laloum/outpost 7.0.0 → 9.0.0

package/dist/infrastructure/conversations/session-bundle.js

@@ -6,12 +6,60 @@ import { invariant, OutpostError } from "../../domain/errors.js";
 import { executeProcess, requireSuccess } from "../process.js";
 import { validId } from "./identity.js";
 import { sessionBundleLimits, sessionBundleScript, } from "./session-bundle.constants.js";
+function hookSource(name, hook) {
+    if (hook === undefined)
+        return undefined;
+    invariant(typeof hook === "function", `Session bundle ${name} must be a function`);
+    const source = Function.prototype.toString.call(hook);
+    try {
+        // Compiles without running: hooks execute later in the sandbox from their source.
+        new Function(`return (${source})`);
+    }
+    catch {
+        invariant(false, `Session bundle ${name} must be a self-contained function expression, not a method`);
+    }
+    return source;
+}
+function pattern(name, value) {
+    invariant(value instanceof RegExp, `Session bundle ${name} must be a RegExp`);
+    invariant(!/[gy]/.test(value.flags), `Session bundle ${name} cannot use the g or y flags`);
+    return { source: value.source, flags: value.flags };
+}
+/** Serializes a profile into the argument read by the in-sandbox bundle script. */
+export function sessionBundleProfile(profile) {
+    const { format, root, sessions, required, relocated = [] } = profile;
+    for (const [name, value] of Object.entries({
+        format,
+        sessions,
+        "root.directory": root?.directory,
+    }))
+        invariant(typeof value === "string" && value.length > 0, `Session bundle ${name} must be a non-empty string`);
+    invariant(root.variable === undefined ||
+        /^[A-Za-z_][A-Za-z0-9_]*$/.test(root.variable), "Session bundle root.variable must be an environment variable name");
+    invariant(Array.isArray(required) && required.length > 0, "Session bundles require at least one required file");
+    invariant(!profile.buckets || profile.bucket !== undefined, "Bucketed session bundles require a bucket function");
+    return JSON.stringify({
+        format,
+        root,
+        sessions,
+        buckets: profile.buckets === true,
+        include: pattern("include", profile.include),
+        ...(profile.exclude === undefined
+            ? {}
+            : { exclude: pattern("exclude", profile.exclude) }),
+        required,
+        relocated,
+        validate: hookSource("validate", profile.validate),
+        bucket: hookSource("bucket", profile.bucket),
+        relocate: hookSource("relocate", profile.relocate),
+    });
+}
 async function sessionOperation(command, invoke) {
     const result = await invoke(command);
     if (result.status !== 0)
         throw new OutpostError("session", `Native session operation failed: ${result.stderr.trim() || "unknown failure"}`);
 }
-export function sessionBundleCommand(mode, format, id, home, cwd, file) {
+export function sessionBundleCommand(mode, profile, id, home, cwd, file) {
     validId(id);
     return {
         executable: "node",
@@ -19,7 +67,7 @@ export function sessionBundleCommand(mode, format, id, home, cwd, file) {
             "-e",
             sessionBundleScript,
             mode,
-            format,
+            profile,
             id,
             home,
             cwd,
@@ -33,18 +81,27 @@ export function sessionBundlePath(format, id, repository, home) {
     validId(id);
     return join(home ?? repository, ".outpost", "conversations", format, `${id}.json`);
 }
-export function sessionConversations(format) {
+/** Creates a native store for CLIs that keep each session as a directory. */
+export function createSessionBundleConversations(sessionProfile) {
+    const profile = sessionBundleProfile(sessionProfile);
+    const { format } = sessionProfile;
     return {
         name: format,
+        format,
+        directory: (repository, home) => join(home ?? repository, ".outpost", "conversations", format),
+        destination(id, sandbox) {
+            validId(id);
+            return posix.join(sandbox.home, ".outpost", "conversations", format, `${id}.json`);
+        },
         async locate(id, repository, home) {
             const file = sessionBundlePath(format, id, repository, home);
             if (await access(file).then(() => true, () => false)) {
-                await sessionOperation(sessionBundleCommand("validate", format, id, home ?? homedir(), repository, file), executeProcess);
+                await sessionOperation(sessionBundleCommand("validate", profile, id, home ?? homedir(), repository, file), executeProcess);
                 return { id, file, format };
             }
             const scratch = `${file}.${randomUUID()}`;
             try {
-                await sessionOperation(sessionBundleCommand("capture", format, id, home ?? homedir(), repository, scratch), executeProcess);
+                await sessionOperation(sessionBundleCommand("capture", profile, id, home ?? homedir(), repository, scratch), executeProcess);
                 await rename(scratch, file);
             }
             finally {
@@ -58,7 +115,7 @@ export function sessionConversations(format) {
             const scratch = `${file}.${randomUUID()}`;
             await mkdir(dirname(file), { recursive: true, mode: 0o700 });
             try {
-                await sessionOperation(sessionBundleCommand("capture", format, id, context.sandbox.home, context.sandbox.root, remote), context.sandbox.invoke);
+                await sessionOperation(sessionBundleCommand("capture", profile, id, context.sandbox.home, context.sandbox.root, remote), context.sandbox.invoke);
                 await context.sandbox.download(remote, scratch);
                 await rename(scratch, file);
             }
@@ -80,7 +137,7 @@ export function sessionConversations(format) {
             const remote = posix.join(context.sandbox.home.replaceAll("\\", "/"), ".outpost", `restore-${randomUUID()}.json`);
             try {
                 await context.sandbox.upload(record.file, remote);
-                await sessionOperation(sessionBundleCommand("restore", format, record.id, context.sandbox.home, context.sandbox.root, remote), context.sandbox.invoke);
+                await sessionOperation(sessionBundleCommand("restore", profile, record.id, context.sandbox.home, context.sandbox.root, remote), context.sandbox.invoke);
             }
             finally {
                 await requireSuccess({

package/dist/infrastructure/conversations/session-bundle.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-bundle.js","sourceRoot":"","sources":["../../../src/infrastructure/conversations/session-bundle.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { access, mkdir, rename, rm } from \"node:fs/promises\";\nimport { homedir } from \"node:os\";\nimport { dirname, join, posix } from \"node:path\";\nimport type { ConversationStore } from \"../../domain/conversation.types.ts\";\nimport type { Command, CommandResult } from \"../../domain/command.types.ts\";\nimport { invariant, OutpostError } from \"../../domain/errors.ts\";\nimport { executeProcess, requireSuccess } from \"../process.ts\";\nimport { validId } from \"./identity.ts\";\nimport {\n  sessionBundleLimits,\n  sessionBundleScript,\n} from \"./session-bundle.constants.ts\";\nimport type { SessionBundleFormat } from \"./session-bundle.types.ts\";\n\nasync function sessionOperation(\n  command: Command,\n  invoke: (command: Command) => Promise<CommandResult>,\n): Promise<void> {\n  const result = await invoke(command);\n  if (result.status !== 0)\n    throw new OutpostError(\n      \"session\",\n      `Native session operation failed: ${result.stderr.trim() || \"unknown failure\"}`,\n    );\n}\n\nexport function sessionBundleCommand(\n  mode: \"capture\" | \"restore\" | \"validate\",\n  format: SessionBundleFormat,\n  id: string,\n  home: string,\n  cwd: string,\n  file: string,\n): Command {\n  validId(id);\n  return {\n    executable: \"node\",\n    arguments: [\n      \"-e\",\n      sessionBundleScript,\n      mode,\n      format,\n      id,\n      home,\n      cwd,\n      file,\n      String(sessionBundleLimits.bytes),\n      String(sessionBundleLimits.files),\n    ],\n  };\n}\n\nexport function sessionBundlePath(\n  format: SessionBundleFormat,\n  id: string,\n  repository: string,\n  home?: string,\n): string {\n  validId(id);\n  return join(\n    home ?? repository,\n    \".outpost\",\n    \"conversations\",\n    format,\n    `${id}.json`,\n  );\n}\n\nexport function sessionConversations(\n  format: SessionBundleFormat,\n): ConversationStore {\n  return {\n    name: format,\n    async locate(id, repository, home) {\n      const file = sessionBundlePath(format, id, repository, home);\n      if (\n        await access(file).then(\n          () => true,\n          () => false,\n        )\n      ) {\n        await sessionOperation(\n          sessionBundleCommand(\n            \"validate\",\n            format,\n            id,\n            home ?? homedir(),\n            repository,\n            file,\n          ),\n          executeProcess,\n        );\n        return { id, file, format };\n      }\n      const scratch = `${file}.${randomUUID()}`;\n      try {\n        await sessionOperation(\n          sessionBundleCommand(\n            \"capture\",\n            format,\n            id,\n            home ?? homedir(),\n            repository,\n            scratch,\n          ),\n          executeProcess,\n        );\n        await rename(scratch, file);\n      } finally {\n        await rm(scratch, { force: true });\n      }\n      return { id, file, format };\n    },\n    async capture(id, context) {\n      const file = sessionBundlePath(\n        format,\n        id,\n        context.repository,\n        context.home,\n      );\n      const remote = posix.join(\n        context.sandbox.home.replaceAll(\"\\\\\", \"/\"),\n        \".outpost\",\n        `session-${randomUUID()}.json`,\n      );\n      const scratch = `${file}.${randomUUID()}`;\n      await mkdir(dirname(file), { recursive: true, mode: 0o700 });\n      try {\n        await sessionOperation(\n          sessionBundleCommand(\n            \"capture\",\n            format,\n            id,\n            context.sandbox.home,\n            context.sandbox.root,\n            remote,\n          ),\n          context.sandbox.invoke,\n        );\n        await context.sandbox.download(remote, scratch);\n        await rename(scratch, file);\n      } finally {\n        await rm(scratch, { force: true });\n        await requireSuccess(\n          {\n            executable: \"node\",\n            arguments: [\n              \"-e\",\n              \"require('node:fs').rmSync(process.argv[1], {force:true})\",\n              remote,\n            ],\n          },\n          context.sandbox.invoke,\n        );\n      }\n      return { id, file, format };\n    },\n    async restore(record, context) {\n      invariant(\n        record.format === format,\n        \"Conversation format does not match its storage\",\n      );\n      const remote = posix.join(\n        context.sandbox.home.replaceAll(\"\\\\\", \"/\"),\n        \".outpost\",\n        `restore-${randomUUID()}.json`,\n      );\n      try {\n        await context.sandbox.upload(record.file, remote);\n        await sessionOperation(\n          sessionBundleCommand(\n            \"restore\",\n            format,\n            record.id,\n            context.sandbox.home,\n            context.sandbox.root,\n            remote,\n          ),\n          context.sandbox.invoke,\n        );\n      } finally {\n        await requireSuccess(\n          {\n            executable: \"node\",\n            arguments: [\n              \"-e\",\n              \"require('node:fs').rmSync(process.argv[1], {force:true})\",\n              remote,\n            ],\n          },\n          context.sandbox.invoke,\n        );\n      }\n    },\n  };\n}\n"]}
+{"version":3,"file":"session-bundle.js","sourceRoot":"","sources":["../../../src/infrastructure/conversations/session-bundle.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { access, mkdir, rename, rm } from \"node:fs/promises\";\nimport { homedir } from \"node:os\";\nimport { dirname, join, posix } from \"node:path\";\nimport type { NativeConversationStore } from \"../../domain/conversation.types.ts\";\nimport type { Command, CommandResult } from \"../../domain/command.types.ts\";\nimport { invariant, OutpostError } from \"../../domain/errors.ts\";\nimport { executeProcess, requireSuccess } from \"../process.ts\";\nimport { validId } from \"./identity.ts\";\nimport {\n  sessionBundleLimits,\n  sessionBundleScript,\n} from \"./session-bundle.constants.ts\";\nimport type { SessionBundleProfile } from \"./session-bundle.types.ts\";\n\nfunction hookSource(\n  name: \"validate\" | \"bucket\" | \"relocate\",\n  hook: unknown,\n): string | undefined {\n  if (hook === undefined) return undefined;\n  invariant(\n    typeof hook === \"function\",\n    `Session bundle ${name} must be a function`,\n  );\n  const source = Function.prototype.toString.call(hook);\n  try {\n    // Compiles without running: hooks execute later in the sandbox from their source.\n    new Function(`return (${source})`);\n  } catch {\n    invariant(\n      false,\n      `Session bundle ${name} must be a self-contained function expression, not a method`,\n    );\n  }\n  return source;\n}\n\nfunction pattern(name: string, value: unknown) {\n  invariant(value instanceof RegExp, `Session bundle ${name} must be a RegExp`);\n  invariant(\n    !/[gy]/.test(value.flags),\n    `Session bundle ${name} cannot use the g or y flags`,\n  );\n  return { source: value.source, flags: value.flags };\n}\n\n/** Serializes a profile into the argument read by the in-sandbox bundle script. */\nexport function sessionBundleProfile(profile: SessionBundleProfile): string {\n  const { format, root, sessions, required, relocated = [] } = profile;\n  for (const [name, value] of Object.entries({\n    format,\n    sessions,\n    \"root.directory\": root?.directory,\n  }))\n    invariant(\n      typeof value === \"string\" && value.length > 0,\n      `Session bundle ${name} must be a non-empty string`,\n    );\n  invariant(\n    root.variable === undefined ||\n      /^[A-Za-z_][A-Za-z0-9_]*$/.test(root.variable),\n    \"Session bundle root.variable must be an environment variable name\",\n  );\n  invariant(\n    Array.isArray(required) && required.length > 0,\n    \"Session bundles require at least one required file\",\n  );\n  invariant(\n    !profile.buckets || profile.bucket !== undefined,\n    \"Bucketed session bundles require a bucket function\",\n  );\n  return JSON.stringify({\n    format,\n    root,\n    sessions,\n    buckets: profile.buckets === true,\n    include: pattern(\"include\", profile.include),\n    ...(profile.exclude === undefined\n      ? {}\n      : { exclude: pattern(\"exclude\", profile.exclude) }),\n    required,\n    relocated,\n    validate: hookSource(\"validate\", profile.validate),\n    bucket: hookSource(\"bucket\", profile.bucket),\n    relocate: hookSource(\"relocate\", profile.relocate),\n  });\n}\n\nasync function sessionOperation(\n  command: Command,\n  invoke: (command: Command) => Promise<CommandResult>,\n): Promise<void> {\n  const result = await invoke(command);\n  if (result.status !== 0)\n    throw new OutpostError(\n      \"session\",\n      `Native session operation failed: ${result.stderr.trim() || \"unknown failure\"}`,\n    );\n}\n\nexport function sessionBundleCommand(\n  mode: \"capture\" | \"restore\" | \"validate\",\n  profile: string,\n  id: string,\n  home: string,\n  cwd: string,\n  file: string,\n): Command {\n  validId(id);\n  return {\n    executable: \"node\",\n    arguments: [\n      \"-e\",\n      sessionBundleScript,\n      mode,\n      profile,\n      id,\n      home,\n      cwd,\n      file,\n      String(sessionBundleLimits.bytes),\n      String(sessionBundleLimits.files),\n    ],\n  };\n}\n\nexport function sessionBundlePath(\n  format: string,\n  id: string,\n  repository: string,\n  home?: string,\n): string {\n  validId(id);\n  return join(\n    home ?? repository,\n    \".outpost\",\n    \"conversations\",\n    format,\n    `${id}.json`,\n  );\n}\n\n/** Creates a native store for CLIs that keep each session as a directory. */\nexport function createSessionBundleConversations(\n  sessionProfile: SessionBundleProfile,\n): NativeConversationStore {\n  const profile = sessionBundleProfile(sessionProfile);\n  const { format } = sessionProfile;\n  return {\n    name: format,\n    format,\n    directory: (repository, home) =>\n      join(home ?? repository, \".outpost\", \"conversations\", format),\n    destination(id, sandbox) {\n      validId(id);\n      return posix.join(\n        sandbox.home,\n        \".outpost\",\n        \"conversations\",\n        format,\n        `${id}.json`,\n      );\n    },\n    async locate(id, repository, home) {\n      const file = sessionBundlePath(format, id, repository, home);\n      if (\n        await access(file).then(\n          () => true,\n          () => false,\n        )\n      ) {\n        await sessionOperation(\n          sessionBundleCommand(\n            \"validate\",\n            profile,\n            id,\n            home ?? homedir(),\n            repository,\n            file,\n          ),\n          executeProcess,\n        );\n        return { id, file, format };\n      }\n      const scratch = `${file}.${randomUUID()}`;\n      try {\n        await sessionOperation(\n          sessionBundleCommand(\n            \"capture\",\n            profile,\n            id,\n            home ?? homedir(),\n            repository,\n            scratch,\n          ),\n          executeProcess,\n        );\n        await rename(scratch, file);\n      } finally {\n        await rm(scratch, { force: true });\n      }\n      return { id, file, format };\n    },\n    async capture(id, context) {\n      const file = sessionBundlePath(\n        format,\n        id,\n        context.repository,\n        context.home,\n      );\n      const remote = posix.join(\n        context.sandbox.home.replaceAll(\"\\\\\", \"/\"),\n        \".outpost\",\n        `session-${randomUUID()}.json`,\n      );\n      const scratch = `${file}.${randomUUID()}`;\n      await mkdir(dirname(file), { recursive: true, mode: 0o700 });\n      try {\n        await sessionOperation(\n          sessionBundleCommand(\n            \"capture\",\n            profile,\n            id,\n            context.sandbox.home,\n            context.sandbox.root,\n            remote,\n          ),\n          context.sandbox.invoke,\n        );\n        await context.sandbox.download(remote, scratch);\n        await rename(scratch, file);\n      } finally {\n        await rm(scratch, { force: true });\n        await requireSuccess(\n          {\n            executable: \"node\",\n            arguments: [\n              \"-e\",\n              \"require('node:fs').rmSync(process.argv[1], {force:true})\",\n              remote,\n            ],\n          },\n          context.sandbox.invoke,\n        );\n      }\n      return { id, file, format };\n    },\n    async restore(record, context) {\n      invariant(\n        record.format === format,\n        \"Conversation format does not match its storage\",\n      );\n      const remote = posix.join(\n        context.sandbox.home.replaceAll(\"\\\\\", \"/\"),\n        \".outpost\",\n        `restore-${randomUUID()}.json`,\n      );\n      try {\n        await context.sandbox.upload(record.file, remote);\n        await sessionOperation(\n          sessionBundleCommand(\n            \"restore\",\n            profile,\n            record.id,\n            context.sandbox.home,\n            context.sandbox.root,\n            remote,\n          ),\n          context.sandbox.invoke,\n        );\n      } finally {\n        await requireSuccess(\n          {\n            executable: \"node\",\n            arguments: [\n              \"-e\",\n              \"require('node:fs').rmSync(process.argv[1], {force:true})\",\n              remote,\n            ],\n          },\n          context.sandbox.invoke,\n        );\n      }\n    },\n  };\n}\n"]}

package/dist/infrastructure/conversations/session-bundle.types.d.ts

@@ -1 +1,48 @@
-export type SessionBundleFormat = "copilot" | "kimi";
+/** Text of the bundled files a profile hook may read, by bundle-relative path. */
+export interface SessionBundleFiles {
+    text(path: string): string | undefined;
+}
+export interface SessionBundleHelpers {
+    /** Joins sandbox path segments with the sandbox platform separator. */
+    join(...segments: string[]): string;
+    /** Hex SHA-256 digest of a UTF-8 string. */
+    sha256(text: string): string;
+}
+export interface SessionBundleRelocation {
+    readonly id: string;
+    /** Sandbox workspace the restored session must point to. */
+    readonly cwd: string;
+    /** Sandbox directory the session is restored into. */
+    readonly target: string;
+    readonly helpers: SessionBundleHelpers;
+}
+/**
+ * How a CLI stores one session as a directory. Hooks run inside the sandbox
+ * from their source text, so they must be self-contained function expressions.
+ */
+export interface SessionBundleProfile {
+    /** Persisted format name, used in bundles, transport keys and host paths. */
+    readonly format: string;
+    /** CLI home: `$variable` when set, otherwise `directory` under the agent home. */
+    readonly root: {
+        readonly variable?: string;
+        readonly directory: string;
+    };
+    /** Directory under the CLI home that holds sessions. */
+    readonly sessions: string;
+    /** Sessions are grouped in `<sessions>/<bucket>/<id>` instead of `<sessions>/<id>`. */
+    readonly buckets?: boolean;
+    /** Bundle-relative paths to capture; a directory is tested by its own path. */
+    readonly include: RegExp;
+    readonly exclude?: RegExp;
+    /** Files whose absence makes the session unusable. */
+    readonly required: readonly string[];
+    /** Files passed to `relocate` as text during restoration. */
+    readonly relocated?: readonly string[];
+    /** Returns an error message when the bundled session is unsupported. */
+    readonly validate?: (files: SessionBundleFiles, id: string) => string | undefined;
+    /** Bucket that restoration uses for a workspace; required with `buckets`. */
+    readonly bucket?: (cwd: string, helpers: SessionBundleHelpers) => string;
+    /** Rewrites one relocated file for the restored workspace. */
+    readonly relocate?: (path: string, text: string, relocation: SessionBundleRelocation) => string;
+}

package/dist/infrastructure/conversations/session-bundle.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-bundle.types.js","sourceRoot":"","sources":["../../../src/infrastructure/conversations/session-bundle.types.ts"],"names":[],"mappings":"","sourcesContent":["export type SessionBundleFormat = \"copilot\" | \"kimi\";\n"]}
+{"version":3,"file":"session-bundle.types.js","sourceRoot":"","sources":["../../../src/infrastructure/conversations/session-bundle.types.ts"],"names":[],"mappings":"","sourcesContent":["/** Text of the bundled files a profile hook may read, by bundle-relative path. */\nexport interface SessionBundleFiles {\n  text(path: string): string | undefined;\n}\n\nexport interface SessionBundleHelpers {\n  /** Joins sandbox path segments with the sandbox platform separator. */\n  join(...segments: string[]): string;\n  /** Hex SHA-256 digest of a UTF-8 string. */\n  sha256(text: string): string;\n}\n\nexport interface SessionBundleRelocation {\n  readonly id: string;\n  /** Sandbox workspace the restored session must point to. */\n  readonly cwd: string;\n  /** Sandbox directory the session is restored into. */\n  readonly target: string;\n  readonly helpers: SessionBundleHelpers;\n}\n\n/**\n * How a CLI stores one session as a directory. Hooks run inside the sandbox\n * from their source text, so they must be self-contained function expressions.\n */\nexport interface SessionBundleProfile {\n  /** Persisted format name, used in bundles, transport keys and host paths. */\n  readonly format: string;\n  /** CLI home: `$variable` when set, otherwise `directory` under the agent home. */\n  readonly root: { readonly variable?: string; readonly directory: string };\n  /** Directory under the CLI home that holds sessions. */\n  readonly sessions: string;\n  /** Sessions are grouped in `<sessions>/<bucket>/<id>` instead of `<sessions>/<id>`. */\n  readonly buckets?: boolean;\n  /** Bundle-relative paths to capture; a directory is tested by its own path. */\n  readonly include: RegExp;\n  readonly exclude?: RegExp;\n  /** Files whose absence makes the session unusable. */\n  readonly required: readonly string[];\n  /** Files passed to `relocate` as text during restoration. */\n  readonly relocated?: readonly string[];\n  /** Returns an error message when the bundled session is unsupported. */\n  readonly validate?: (\n    files: SessionBundleFiles,\n    id: string,\n  ) => string | undefined;\n  /** Bucket that restoration uses for a workspace; required with `buckets`. */\n  readonly bucket?: (cwd: string, helpers: SessionBundleHelpers) => string;\n  /** Rewrites one relocated file for the restored workspace. */\n  readonly relocate?: (\n    path: string,\n    text: string,\n    relocation: SessionBundleRelocation,\n  ) => string;\n}\n"]}

package/dist/infrastructure/conversations/transcript-store.d.ts

@@ -0,0 +1,4 @@
+import type { NativeConversationStore } from "../../domain/conversation.types.ts";
+import type { TranscriptConversationLayout } from "./layout.types.ts";
+/** Creates a native store for CLIs that keep one JSONL transcript per conversation. */
+export declare function createTranscriptConversations(layout: TranscriptConversationLayout): NativeConversationStore;

package/dist/infrastructure/conversations/transcript-store.js

@@ -0,0 +1,134 @@
+import { randomUUID } from "node:crypto";
+import { mkdir, readFile, rm, stat, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, join, posix, relative, resolve } from "node:path";
+import { invariant, OutpostError } from "../../domain/errors.js";
+import { safeDestination } from "../files.js";
+import { transcriptSearchBytes } from "./conversation.constants.js";
+import { files } from "./files.js";
+import { validId } from "./identity.js";
+import { relocateTranscript } from "./relocate.js";
+async function locateTranscript(layout, id, repository, home = homedir()) {
+    validId(id);
+    const { format } = layout;
+    const expected = layout.preferredPath?.(id, repository, home);
+    if (expected && (await stat(expected).catch(() => undefined))?.isFile())
+        return { id, file: expected, format };
+    const found = (await files(layout.searchRoot(home))).find((file) => layout.matches(file, id));
+    if (found)
+        return { id, file: found, format };
+    throw new OutpostError("session", `Conversation ${id} was not found in native ${format} storage`, { id, repository });
+}
+async function captureSidecars(id, remote, file, context) {
+    const { sandbox, staging, repository } = context;
+    const remoteSidecars = posix.join(posix.dirname(remote.replaceAll("\\", "/")), id, "subagents");
+    const listed = context.local
+        ? {
+            status: 0,
+            stdout: (await files(join(dirname(remote), id, "subagents"))).join("\n"),
+        }
+        : await sandbox.invoke({
+            executable: "find",
+            arguments: [remoteSidecars, "-type", "f", "-name", "*.jsonl"],
+            retain: transcriptSearchBytes,
+        });
+    if (listed.status !== 0)
+        return;
+    for (const child of listed.stdout.split("\n").filter(Boolean)) {
+        try {
+            const scratch = join(staging, `${randomUUID()}.jsonl`);
+            await sandbox.download(child, scratch);
+            const destination = await safeDestination(join(dirname(file), id, "subagents"), posix.relative(remoteSidecars.replaceAll("\\", "/"), child.replaceAll("\\", "/")));
+            await mkdir(dirname(destination), { recursive: true });
+            try {
+                await writeFile(destination, relocateTranscript(await readFile(scratch, "utf8"), resolve(repository)), { mode: 0o600 });
+            }
+            finally {
+                await rm(scratch, { force: true });
+            }
+        }
+        catch (cause) {
+            context.warn?.(`Could not capture child transcript: ${String(cause)}`);
+        }
+    }
+}
+async function captureTranscript(layout, id, context) {
+    validId(id);
+    const { sandbox, staging, repository } = context;
+    const home = context.home ?? homedir();
+    const search = layout.remoteSearchRoot(sandbox.home);
+    const result = context.local
+        ? {
+            status: 0,
+            stdout: (await locateTranscript(layout, id, sandbox.root, sandbox.home))
+                .file,
+        }
+        : await sandbox.invoke({
+            executable: "find",
+            arguments: [search, "-type", "f", "-name", layout.pattern(id)],
+            retain: transcriptSearchBytes,
+        });
+    const remote = result.stdout.trim().split("\n").filter(Boolean)[0];
+    if (result.status !== 0 || !remote)
+        throw new OutpostError("session", `Agent emitted conversation ${id} but its transcript is unavailable`, { id, search });
+    const file = layout.capturePath(id, repository, home, remote);
+    await mkdir(staging, { recursive: true });
+    const temporary = join(staging, `${randomUUID()}.jsonl`);
+    await sandbox.download(remote, temporary);
+    await mkdir(dirname(file), { recursive: true });
+    try {
+        await writeFile(file, relocateTranscript(await readFile(temporary, "utf8"), resolve(repository)), { mode: 0o600 });
+    }
+    finally {
+        await rm(temporary, { force: true });
+    }
+    if (layout.sidecars)
+        await captureSidecars(id, remote, file, context);
+    return { id, file, format: layout.format };
+}
+async function uploadRelocated(file, target, sandbox, staging) {
+    const temporary = join(staging, `${randomUUID()}.jsonl`);
+    await mkdir(staging, { recursive: true });
+    await writeFile(temporary, relocateTranscript(await readFile(file, "utf8"), sandbox.root), { mode: 0o600 });
+    try {
+        await sandbox.upload(temporary, target);
+    }
+    finally {
+        await rm(temporary, { force: true });
+    }
+}
+async function restoreTranscript(layout, record, { sandbox, staging }) {
+    validId(record.id);
+    const target = layout.remotePath(record.id, sandbox, record.file);
+    await uploadRelocated(record.file, target, sandbox, staging);
+    if (!layout.sidecars)
+        return;
+    const sidecars = join(dirname(record.file), record.id, "subagents");
+    for (const file of await files(sidecars))
+        await uploadRelocated(file, posix.join(posix.dirname(target), record.id, "subagents", relative(sidecars, file).replaceAll("\\", "/")), sandbox, staging);
+}
+/** Creates a native store for CLIs that keep one JSONL transcript per conversation. */
+export function createTranscriptConversations(layout) {
+    const { format } = layout;
+    invariant(typeof format === "string" && format.length > 0, "Transcript layouts require a format name");
+    return {
+        name: format,
+        format,
+        locate: (id, repository, home) => locateTranscript(layout, id, repository, home),
+        capture: (id, context) => captureTranscript(layout, id, context),
+        async restore(record, context) {
+            invariant(record.format === format, "Conversation format does not match its storage");
+            if (context.local &&
+                context.sandbox.root === context.repository &&
+                record.reference === undefined)
+                return;
+            return restoreTranscript(layout, record, context);
+        },
+        directory: (repository, home) => layout.directory(repository, home ?? homedir()),
+        destination(id, sandbox, original) {
+            validId(id);
+            return layout.remotePath(id, sandbox, original);
+        },
+    };
+}
+//# sourceMappingURL=transcript-store.js.map

package/dist/infrastructure/conversations/transcript-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript-store.js","sourceRoot":"","sources":["../../../src/infrastructure/conversations/transcript-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEnD,KAAK,UAAU,gBAAgB,CAC7B,MAAoC,EACpC,EAAU,EACV,UAAkB,EAClB,IAAI,GAAG,OAAO,EAAE;IAEhB,OAAO,CAAC,EAAE,CAAC,CAAC;IACZ,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAC1B,MAAM,QAAQ,GAAG,MAAM,CAAC,aAAa,EAAE,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;IAC9D,IAAI,QAAQ,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE;QACrE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACxC,MAAM,KAAK,GAAG,CAAC,MAAM,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CACjE,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CACzB,CAAC;IACF,IAAI,KAAK;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAC9C,MAAM,IAAI,YAAY,CACpB,SAAS,EACT,gBAAgB,EAAE,4BAA4B,MAAM,UAAU,EAC9D,EAAE,EAAE,EAAE,UAAU,EAAE,CACnB,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,EAAU,EACV,MAAc,EACd,IAAY,EACZ,OAA4B;IAE5B,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IACjD,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAC/B,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,EAC3C,EAAE,EACF,WAAW,CACZ,CAAC;IACF,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK;QAC1B,CAAC,CAAC;YACE,MAAM,EAAE,CAAC;YACT,MAAM,EAAE,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAChE,IAAI,CACL;SACF;QACH,CAAC,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC;YACnB,UAAU,EAAE,MAAM;YAClB,SAAS,EAAE,CAAC,cAAc,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,CAAC;YAC7D,MAAM,EAAE,qBAAqB;SAC9B,CAAC,CAAC;IACP,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAChC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9D,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,UAAU,EAAE,QAAQ,CAAC,CAAC;YACvD,MAAM,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YACvC,MAAM,WAAW,GAAG,MAAM,eAAe,CACvC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,WAAW,CAAC,EACpC,KAAK,CAAC,QAAQ,CACZ,cAAc,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,EACpC,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAC5B,CACF,CAAC;YACF,MAAM,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACvD,IAAI,CAAC;gBACH,MAAM,SAAS,CACb,WAAW,EACX,kBAAkB,CAChB,MAAM,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,EAC/B,OAAO,CAAC,UAAU,CAAC,CACpB,EACD,EAAE,IAAI,EAAE,KAAK,EAAE,CAChB,CAAC;YACJ,CAAC;oBAAS,CAAC;gBACT,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,EAAE,CAAC,uCAAuC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;AACH,CAAC;AAED,KAAK,UAAU,iBAAiB,CAC9B,MAAoC,EACpC,EAAU,EACV,OAA4B;IAE5B,OAAO,CAAC,EAAE,CAAC,CAAC;IACZ,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IACjD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,EAAE,CAAC;IACvC,MAAM,MAAM,GAAG,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK;QAC1B,CAAC,CAAC;YACE,MAAM,EAAE,CAAC;YACT,MAAM,EAAE,CAAC,MAAM,gBAAgB,CAAC,MAAM,EAAE,EAAE,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;iBACrE,IAAI;SACR;QACH,CAAC,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC;YACnB,UAAU,EAAE,MAAM;YAClB,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAC9D,MAAM,EAAE,qBAAqB;SAC9B,CAAC,CAAC;IACP,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACnE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM;QAChC,MAAM,IAAI,YAAY,CACpB,SAAS,EACT,8BAA8B,EAAE,oCAAoC,EACpE,EAAE,EAAE,EAAE,MAAM,EAAE,CACf,CAAC;IACJ,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC9D,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,UAAU,EAAE,QAAQ,CAAC,CAAC;IACzD,MAAM,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC1C,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,IAAI,CAAC;QACH,MAAM,SAAS,CACb,IAAI,EACJ,kBAAkB,CAChB,MAAM,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,EACjC,OAAO,CAAC,UAAU,CAAC,CACpB,EACD,EAAE,IAAI,EAAE,KAAK,EAAE,CAChB,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,MAAM,EAAE,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ;QAAE,MAAM,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACtE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;AAC7C,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,IAAY,EACZ,MAAc,EACd,OAAqB,EACrB,OAAe;IAEf,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,UAAU,EAAE,QAAQ,CAAC,CAAC;IACzD,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,MAAM,SAAS,CACb,SAAS,EACT,kBAAkB,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,EAC9D,EAAE,IAAI,EAAE,KAAK,EAAE,CAChB,CAAC;IACF,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;YAAS,CAAC;QACT,MAAM,EAAE,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;AACH,CAAC;AAED,KAAK,UAAU,iBAAiB,CAC9B,MAAoC,EACpC,MAA0B,EAC1B,EAAE,OAAO,EAAE,OAAO,EAAuB;IAEzC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACnB,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAClE,MAAM,eAAe,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC7D,IAAI,CAAC,MAAM,CAAC,QAAQ;QAAE,OAAO;IAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;IACpE,KAAK,MAAM,IAAI,IAAI,MAAM,KAAK,CAAC,QAAQ,CAAC;QACtC,MAAM,eAAe,CACnB,IAAI,EACJ,KAAK,CAAC,IAAI,CACR,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EACrB,MAAM,CAAC,EAAE,EACT,WAAW,EACX,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAC/C,EACD,OAAO,EACP,OAAO,CACR,CAAC;AACN,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,6BAA6B,CAC3C,MAAoC;IAEpC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAC1B,SAAS,CACP,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAC/C,0CAA0C,CAC3C,CAAC;IACF,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,MAAM;QACN,MAAM,EAAE,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,CAC/B,gBAAgB,CAAC,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC;QAChD,OAAO,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC,iBAAiB,CAAC,MAAM,EAAE,EAAE,EAAE,OAAO,CAAC;QAChE,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO;YAC3B,SAAS,CACP,MAAM,CAAC,MAAM,KAAK,MAAM,EACxB,gDAAgD,CACjD,CAAC;YACF,IACE,OAAO,CAAC,KAAK;gBACb,OAAO,CAAC,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,UAAU;gBAC3C,MAAM,CAAC,SAAS,KAAK,SAAS;gBAE9B,OAAO;YACT,OAAO,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QACpD,CAAC;QACD,SAAS,EAAE,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,CAC9B,MAAM,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,IAAI,OAAO,EAAE,CAAC;QACjD,WAAW,CAAC,EAAE,EAAE,OAAO,EAAE,QAAQ;YAC/B,OAAO,CAAC,EAAE,CAAC,CAAC;YACZ,OAAO,MAAM,CAAC,UAAU,CAAC,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QAClD,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { mkdir, readFile, rm, stat, writeFile } from \"node:fs/promises\";\nimport { homedir } from \"node:os\";\nimport { dirname, join, posix, relative, resolve } from \"node:path\";\nimport type {\n  ConversationContext,\n  ConversationRecord,\n  NativeConversationStore,\n} from \"../../domain/conversation.types.ts\";\nimport { invariant, OutpostError } from \"../../domain/errors.ts\";\nimport type { SandboxLease } from \"../../domain/sandbox.types.ts\";\nimport { safeDestination } from \"../files.ts\";\nimport { transcriptSearchBytes } from \"./conversation.constants.ts\";\nimport { files } from \"./files.ts\";\nimport { validId } from \"./identity.ts\";\nimport type { TranscriptConversationLayout } from \"./layout.types.ts\";\nimport { relocateTranscript } from \"./relocate.ts\";\n\nasync function locateTranscript(\n  layout: TranscriptConversationLayout,\n  id: string,\n  repository: string,\n  home = homedir(),\n): Promise<ConversationRecord> {\n  validId(id);\n  const { format } = layout;\n  const expected = layout.preferredPath?.(id, repository, home);\n  if (expected && (await stat(expected).catch(() => undefined))?.isFile())\n    return { id, file: expected, format };\n  const found = (await files(layout.searchRoot(home))).find((file) =>\n    layout.matches(file, id),\n  );\n  if (found) return { id, file: found, format };\n  throw new OutpostError(\n    \"session\",\n    `Conversation ${id} was not found in native ${format} storage`,\n    { id, repository },\n  );\n}\n\nasync function captureSidecars(\n  id: string,\n  remote: string,\n  file: string,\n  context: ConversationContext,\n): Promise<void> {\n  const { sandbox, staging, repository } = context;\n  const remoteSidecars = posix.join(\n    posix.dirname(remote.replaceAll(\"\\\\\", \"/\")),\n    id,\n    \"subagents\",\n  );\n  const listed = context.local\n    ? {\n        status: 0,\n        stdout: (await files(join(dirname(remote), id, \"subagents\"))).join(\n          \"\\n\",\n        ),\n      }\n    : await sandbox.invoke({\n        executable: \"find\",\n        arguments: [remoteSidecars, \"-type\", \"f\", \"-name\", \"*.jsonl\"],\n        retain: transcriptSearchBytes,\n      });\n  if (listed.status !== 0) return;\n  for (const child of listed.stdout.split(\"\\n\").filter(Boolean)) {\n    try {\n      const scratch = join(staging, `${randomUUID()}.jsonl`);\n      await sandbox.download(child, scratch);\n      const destination = await safeDestination(\n        join(dirname(file), id, \"subagents\"),\n        posix.relative(\n          remoteSidecars.replaceAll(\"\\\\\", \"/\"),\n          child.replaceAll(\"\\\\\", \"/\"),\n        ),\n      );\n      await mkdir(dirname(destination), { recursive: true });\n      try {\n        await writeFile(\n          destination,\n          relocateTranscript(\n            await readFile(scratch, \"utf8\"),\n            resolve(repository),\n          ),\n          { mode: 0o600 },\n        );\n      } finally {\n        await rm(scratch, { force: true });\n      }\n    } catch (cause) {\n      context.warn?.(`Could not capture child transcript: ${String(cause)}`);\n    }\n  }\n}\n\nasync function captureTranscript(\n  layout: TranscriptConversationLayout,\n  id: string,\n  context: ConversationContext,\n): Promise<ConversationRecord> {\n  validId(id);\n  const { sandbox, staging, repository } = context;\n  const home = context.home ?? homedir();\n  const search = layout.remoteSearchRoot(sandbox.home);\n  const result = context.local\n    ? {\n        status: 0,\n        stdout: (await locateTranscript(layout, id, sandbox.root, sandbox.home))\n          .file,\n      }\n    : await sandbox.invoke({\n        executable: \"find\",\n        arguments: [search, \"-type\", \"f\", \"-name\", layout.pattern(id)],\n        retain: transcriptSearchBytes,\n      });\n  const remote = result.stdout.trim().split(\"\\n\").filter(Boolean)[0];\n  if (result.status !== 0 || !remote)\n    throw new OutpostError(\n      \"session\",\n      `Agent emitted conversation ${id} but its transcript is unavailable`,\n      { id, search },\n    );\n  const file = layout.capturePath(id, repository, home, remote);\n  await mkdir(staging, { recursive: true });\n  const temporary = join(staging, `${randomUUID()}.jsonl`);\n  await sandbox.download(remote, temporary);\n  await mkdir(dirname(file), { recursive: true });\n  try {\n    await writeFile(\n      file,\n      relocateTranscript(\n        await readFile(temporary, \"utf8\"),\n        resolve(repository),\n      ),\n      { mode: 0o600 },\n    );\n  } finally {\n    await rm(temporary, { force: true });\n  }\n  if (layout.sidecars) await captureSidecars(id, remote, file, context);\n  return { id, file, format: layout.format };\n}\n\nasync function uploadRelocated(\n  file: string,\n  target: string,\n  sandbox: SandboxLease,\n  staging: string,\n): Promise<void> {\n  const temporary = join(staging, `${randomUUID()}.jsonl`);\n  await mkdir(staging, { recursive: true });\n  await writeFile(\n    temporary,\n    relocateTranscript(await readFile(file, \"utf8\"), sandbox.root),\n    { mode: 0o600 },\n  );\n  try {\n    await sandbox.upload(temporary, target);\n  } finally {\n    await rm(temporary, { force: true });\n  }\n}\n\nasync function restoreTranscript(\n  layout: TranscriptConversationLayout,\n  record: ConversationRecord,\n  { sandbox, staging }: ConversationContext,\n): Promise<void> {\n  validId(record.id);\n  const target = layout.remotePath(record.id, sandbox, record.file);\n  await uploadRelocated(record.file, target, sandbox, staging);\n  if (!layout.sidecars) return;\n  const sidecars = join(dirname(record.file), record.id, \"subagents\");\n  for (const file of await files(sidecars))\n    await uploadRelocated(\n      file,\n      posix.join(\n        posix.dirname(target),\n        record.id,\n        \"subagents\",\n        relative(sidecars, file).replaceAll(\"\\\\\", \"/\"),\n      ),\n      sandbox,\n      staging,\n    );\n}\n\n/** Creates a native store for CLIs that keep one JSONL transcript per conversation. */\nexport function createTranscriptConversations(\n  layout: TranscriptConversationLayout,\n): NativeConversationStore {\n  const { format } = layout;\n  invariant(\n    typeof format === \"string\" && format.length > 0,\n    \"Transcript layouts require a format name\",\n  );\n  return {\n    name: format,\n    format,\n    locate: (id, repository, home) =>\n      locateTranscript(layout, id, repository, home),\n    capture: (id, context) => captureTranscript(layout, id, context),\n    async restore(record, context) {\n      invariant(\n        record.format === format,\n        \"Conversation format does not match its storage\",\n      );\n      if (\n        context.local &&\n        context.sandbox.root === context.repository &&\n        record.reference === undefined\n      )\n        return;\n      return restoreTranscript(layout, record, context);\n    },\n    directory: (repository, home) =>\n      layout.directory(repository, home ?? homedir()),\n    destination(id, sandbox, original) {\n      validId(id);\n      return layout.remotePath(id, sandbox, original);\n    },\n  };\n}\n"]}

package/dist/infrastructure/conversations.d.ts

@@ -1,30 +1,7 @@
-import { transportConversations } from "./transport-conversations.ts";
-import type { ConversationFormat } from "./conversations.types.ts";
-import { captureConversation } from "./conversations/capture.ts";
-import { locateConversation } from "./conversations/locate.ts";
-import { harnessConversations } from "./conversations/harness-store.ts";
-import { nativeConversations } from "./conversations/native-store.ts";
-import { projectKey, remotePath } from "./conversations/paths.ts";
-import { relocateTranscript } from "./conversations/relocate.ts";
-import { restoreConversation } from "./conversations/restore.ts";
-export type { ConversationFormat, ConversationLocation, StoredConversationFormat, } from "./conversations.types.ts";
-export { harnessConversations, harnessTranscriptPath, } from "./conversations/harness-store.ts";
-export { captureConversation } from "./conversations/capture.ts";
-export { locateConversation } from "./conversations/locate.ts";
-export { nativeConversations } from "./conversations/native-store.ts";
-export { projectKey } from "./conversations/paths.ts";
+export type { ConversationFormat, ConversationLocation, } from "./conversations.types.ts";
+export { createHarnessConversations, harnessTranscriptPath, } from "./conversations/harness-store.ts";
+export { projectKey } from "./conversations/identity.ts";
 export { relocateTranscript } from "./conversations/relocate.ts";
-export { restoreConversation } from "./conversations/restore.ts";
-export declare const conversations: {
-    transported: typeof transportConversations;
-    native: typeof nativeConversations;
-    harness: typeof harnessConversations;
-    locate: typeof locateConversation;
-    capture: typeof captureConversation;
-    restore: typeof restoreConversation;
-    rewrite: typeof relocateTranscript;
-    projectKey: typeof projectKey;
-    claudePath(id: string, repository: string, home?: string): string;
-    directory(format: ConversationFormat, repository: string, home?: string): string;
-    destination: typeof remotePath;
-};
+export { createSessionBundleConversations } from "./conversations/session-bundle.ts";
+export { createTranscriptConversations } from "./conversations/transcript-store.ts";
+export { createTransportStore } from "./transport-conversations.ts";

package/dist/infrastructure/conversations.js

@@ -1,39 +1,7 @@
-import { transportConversations } from "./transport-conversations.js";
-import { homedir } from "node:os";
-import { join, resolve } from "node:path";
-import { captureConversation } from "./conversations/capture.js";
-import { conversationLayout } from "./conversations/layout.js";
-import { locateConversation } from "./conversations/locate.js";
-import { harnessConversations } from "./conversations/harness-store.js";
-import { nativeConversations } from "./conversations/native-store.js";
-import { projectKey, remotePath, validId } from "./conversations/paths.js";
-import { relocateTranscript } from "./conversations/relocate.js";
-import { restoreConversation } from "./conversations/restore.js";
-export { harnessConversations, harnessTranscriptPath, } from "./conversations/harness-store.js";
-export { captureConversation } from "./conversations/capture.js";
-export { locateConversation } from "./conversations/locate.js";
-export { nativeConversations } from "./conversations/native-store.js";
-export { projectKey } from "./conversations/paths.js";
+export { createHarnessConversations, harnessTranscriptPath, } from "./conversations/harness-store.js";
+export { projectKey } from "./conversations/identity.js";
 export { relocateTranscript } from "./conversations/relocate.js";
-export { restoreConversation } from "./conversations/restore.js";
-export const conversations = {
-    transported: transportConversations,
-    native: nativeConversations,
-    harness: harnessConversations,
-    locate: locateConversation,
-    capture: captureConversation,
-    restore: restoreConversation,
-    rewrite: relocateTranscript,
-    projectKey,
-    claudePath(id, repository, home = homedir()) {
-        validId(id);
-        return join(home, ".claude", "projects", projectKey(resolve(repository)), `${id}.jsonl`);
-    },
-    directory(format, repository, home) {
-        if (format === "copilot" || format === "kimi")
-            return join(home ?? repository, ".outpost", "conversations", format);
-        return conversationLayout(format).directory(repository, home ?? homedir());
-    },
-    destination: remotePath,
-};
+export { createSessionBundleConversations } from "./conversations/session-bundle.js";
+export { createTranscriptConversations } from "./conversations/transcript-store.js";
+export { createTransportStore } from "./transport-conversations.js";
 //# sourceMappingURL=conversations.js.map

package/dist/infrastructure/conversations.js.map

@@ -1 +1 @@
-{"version":3,"file":"conversations.js","sourceRoot":"","sources":["../../src/infrastructure/conversations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAOjE,OAAO,EACL,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,WAAW,EAAE,sBAAsB;IACnC,MAAM,EAAE,mBAAmB;IAC3B,OAAO,EAAE,oBAAoB;IAC7B,MAAM,EAAE,kBAAkB;IAC1B,OAAO,EAAE,mBAAmB;IAC5B,OAAO,EAAE,mBAAmB;IAC5B,OAAO,EAAE,kBAAkB;IAC3B,UAAU;IACV,UAAU,CAAC,EAAU,EAAE,UAAkB,EAAE,IAAI,GAAG,OAAO,EAAE;QACzD,OAAO,CAAC,EAAE,CAAC,CAAC;QACZ,OAAO,IAAI,CACT,IAAI,EACJ,SAAS,EACT,UAAU,EACV,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,EAC/B,GAAG,EAAE,QAAQ,CACd,CAAC;IACJ,CAAC;IACD,SAAS,CACP,MAA0B,EAC1B,UAAkB,EAClB,IAAa;QAEb,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,MAAM;YAC3C,OAAO,IAAI,CAAC,IAAI,IAAI,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,CAAC,CAAC;QACvE,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,IAAI,OAAO,EAAE,CAAC,CAAC;IAC7E,CAAC;IACD,WAAW,EAAE,UAAU;CACxB,CAAC","sourcesContent":["import { transportConversations } from \"./transport-conversations.ts\";\nimport { homedir } from \"node:os\";\nimport { join, resolve } from \"node:path\";\nimport type { ConversationFormat } from \"./conversations.types.ts\";\nimport { captureConversation } from \"./conversations/capture.ts\";\nimport { conversationLayout } from \"./conversations/layout.ts\";\nimport { locateConversation } from \"./conversations/locate.ts\";\nimport { harnessConversations } from \"./conversations/harness-store.ts\";\nimport { nativeConversations } from \"./conversations/native-store.ts\";\nimport { projectKey, remotePath, validId } from \"./conversations/paths.ts\";\nimport { relocateTranscript } from \"./conversations/relocate.ts\";\nimport { restoreConversation } from \"./conversations/restore.ts\";\n\nexport type {\n  ConversationFormat,\n  ConversationLocation,\n  StoredConversationFormat,\n} from \"./conversations.types.ts\";\nexport {\n  harnessConversations,\n  harnessTranscriptPath,\n} from \"./conversations/harness-store.ts\";\nexport { captureConversation } from \"./conversations/capture.ts\";\nexport { locateConversation } from \"./conversations/locate.ts\";\nexport { nativeConversations } from \"./conversations/native-store.ts\";\nexport { projectKey } from \"./conversations/paths.ts\";\nexport { relocateTranscript } from \"./conversations/relocate.ts\";\nexport { restoreConversation } from \"./conversations/restore.ts\";\n\nexport const conversations = {\n  transported: transportConversations,\n  native: nativeConversations,\n  harness: harnessConversations,\n  locate: locateConversation,\n  capture: captureConversation,\n  restore: restoreConversation,\n  rewrite: relocateTranscript,\n  projectKey,\n  claudePath(id: string, repository: string, home = homedir()): string {\n    validId(id);\n    return join(\n      home,\n      \".claude\",\n      \"projects\",\n      projectKey(resolve(repository)),\n      `${id}.jsonl`,\n    );\n  },\n  directory(\n    format: ConversationFormat,\n    repository: string,\n    home?: string,\n  ): string {\n    if (format === \"copilot\" || format === \"kimi\")\n      return join(home ?? repository, \".outpost\", \"conversations\", format);\n    return conversationLayout(format).directory(repository, home ?? homedir());\n  },\n  destination: remotePath,\n};\n"]}
+{"version":3,"file":"conversations.js","sourceRoot":"","sources":["../../src/infrastructure/conversations.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,gCAAgC,EAAE,MAAM,mCAAmC,CAAC;AACrF,OAAO,EAAE,6BAA6B,EAAE,MAAM,qCAAqC,CAAC;AACpF,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC","sourcesContent":["export type {\n  ConversationFormat,\n  ConversationLocation,\n} from \"./conversations.types.ts\";\nexport {\n  createHarnessConversations,\n  harnessTranscriptPath,\n} from \"./conversations/harness-store.ts\";\nexport { projectKey } from \"./conversations/identity.ts\";\nexport { relocateTranscript } from \"./conversations/relocate.ts\";\nexport { createSessionBundleConversations } from \"./conversations/session-bundle.ts\";\nexport { createTranscriptConversations } from \"./conversations/transcript-store.ts\";\nexport { createTransportStore } from \"./transport-conversations.ts\";\n"]}

package/dist/infrastructure/conversations.types.d.ts

@@ -1,5 +1,5 @@
-export type ConversationFormat = "claude" | "codex" | "copilot" | "kimi";
-export type StoredConversationFormat = ConversationFormat | "harness";
+/** Persisted name of a conversation format, such as "claude" or "harness". */
+export type ConversationFormat = string;
 export interface ConversationLocation {
     readonly id: string;
     readonly file: string;

package/dist/infrastructure/conversations.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"conversations.types.js","sourceRoot":"","sources":["../../src/infrastructure/conversations.types.ts"],"names":[],"mappings":"","sourcesContent":["export type ConversationFormat = \"claude\" | \"codex\" | \"copilot\" | \"kimi\";\n\nexport type StoredConversationFormat = ConversationFormat | \"harness\";\n\nexport interface ConversationLocation {\n  readonly id: string;\n  readonly file: string;\n  readonly format: ConversationFormat;\n}\n"]}
+{"version":3,"file":"conversations.types.js","sourceRoot":"","sources":["../../src/infrastructure/conversations.types.ts"],"names":[],"mappings":"","sourcesContent":["/** Persisted name of a conversation format, such as \"claude\" or \"harness\". */\nexport type ConversationFormat = string;\n\nexport interface ConversationLocation {\n  readonly id: string;\n  readonly file: string;\n  readonly format: ConversationFormat;\n}\n"]}

package/dist/infrastructure/custom-reporter.d.ts

@@ -1,2 +1,2 @@
 import type { CustomReporter, CustomReporterOptions, ReporterHandlers } from "./custom-reporter.types.ts";
-export declare function createReporter(handlers: ReporterHandlers, options?: CustomReporterOptions): CustomReporter;
+export declare function createCustomReporter(handlers: ReporterHandlers, options?: CustomReporterOptions): CustomReporter;

package/dist/infrastructure/custom-reporter.js

@@ -1,6 +1,6 @@
 import { agentObservation } from "../domain/agent-observation.js";
 import { createObservationHub } from "../domain/observation.js";
-export function createReporter(handlers, options = {}) {
+export function createCustomReporter(handlers, options = {}) {
     const hub = createObservationHub({
         ...(options.capacity === undefined ? {} : { capacity: options.capacity }),
         ...(options.deliveryTimeoutMs === undefined

package/dist/infrastructure/custom-reporter.js.map

@@ -1 +1 @@
-{"version":3,"file":"custom-reporter.js","sourceRoot":"","sources":["../../src/infrastructure/custom-reporter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAQhE,MAAM,UAAU,cAAc,CAC5B,QAA0B,EAC1B,UAAiC,EAAE;IAEnC,MAAM,GAAG,GAAG,oBAAoB,CAAC;QAC/B,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;QACzE,GAAG,CAAC,OAAO,CAAC,iBAAiB,KAAK,SAAS;YACzC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,EAAE,CAAC;QACrD,KAAK,EAAE;YACL;gBACE,KAAK,CAAC,OAAO,CAAC,KAAK;oBACjB,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;oBACtC,IAAI,CAAC,KAAK;wBAAE,OAAO;oBACnB,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAC8B,CAAC;oBAClE,IAAI,CAAC;wBACH,MAAM,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;oBACzB,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,IAAI,CAAC;4BACH,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;wBACxC,CAAC;wBAAC,MAAM,CAAC,CAAA,CAAC;wBACV,MAAM,KAAK,CAAC;oBACd,CAAC;gBACH,CAAC;aACF;SACF;KACF,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,CAAC,KAAuB,EAAQ,EAAE;QAC/C,GAAG,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACvD,CAAC,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE;QAC3B,KAAK,CAAC,KAAK;YACT,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;YAClB,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM;gBAAE,MAAM,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC7C,CAAC;KACF,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { agentObservation } from \"../domain/agent-observation.ts\";\nimport { createObservationHub } from \"../domain/observation.ts\";\nimport type { AgentObservation } from \"../domain/agent.types.ts\";\nimport type {\n  CustomReporter,\n  CustomReporterOptions,\n  ReporterHandlers,\n} from \"./custom-reporter.types.ts\";\n\nexport function createReporter(\n  handlers: ReporterHandlers,\n  options: CustomReporterOptions = {},\n): CustomReporter {\n  const hub = createObservationHub({\n    ...(options.capacity === undefined ? {} : { capacity: options.capacity }),\n    ...(options.deliveryTimeoutMs === undefined\n      ? {}\n      : { deliveryTimeoutMs: options.deliveryTimeoutMs }),\n    sinks: [\n      {\n        async observe(value) {\n          const event = agentObservation(value);\n          if (!event) return;\n          const handler = handlers[event.kind] as\n            ((event: AgentObservation) => void | Promise<void>) | undefined;\n          try {\n            await handler?.(event);\n          } catch (error) {\n            try {\n              await options.onError?.(error, event);\n            } catch {}\n            throw error;\n          }\n        },\n      },\n    ],\n  });\n  const report = (event: AgentObservation): void => {\n    hub.child({ pass: event.pass }).emit(\"agent\", event);\n  };\n  return Object.assign(report, {\n    async flush() {\n      await hub.flush();\n      if (hub.errors.length) throw hub.errors[0];\n    },\n  });\n}\n"]}
+{"version":3,"file":"custom-reporter.js","sourceRoot":"","sources":["../../src/infrastructure/custom-reporter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAQhE,MAAM,UAAU,oBAAoB,CAClC,QAA0B,EAC1B,UAAiC,EAAE;IAEnC,MAAM,GAAG,GAAG,oBAAoB,CAAC;QAC/B,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;QACzE,GAAG,CAAC,OAAO,CAAC,iBAAiB,KAAK,SAAS;YACzC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,EAAE,CAAC;QACrD,KAAK,EAAE;YACL;gBACE,KAAK,CAAC,OAAO,CAAC,KAAK;oBACjB,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;oBACtC,IAAI,CAAC,KAAK;wBAAE,OAAO;oBACnB,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAC8B,CAAC;oBAClE,IAAI,CAAC;wBACH,MAAM,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;oBACzB,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,IAAI,CAAC;4BACH,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;wBACxC,CAAC;wBAAC,MAAM,CAAC,CAAA,CAAC;wBACV,MAAM,KAAK,CAAC;oBACd,CAAC;gBACH,CAAC;aACF;SACF;KACF,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,CAAC,KAAuB,EAAQ,EAAE;QAC/C,GAAG,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACvD,CAAC,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE;QAC3B,KAAK,CAAC,KAAK;YACT,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;YAClB,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM;gBAAE,MAAM,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC7C,CAAC;KACF,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { agentObservation } from \"../domain/agent-observation.ts\";\nimport { createObservationHub } from \"../domain/observation.ts\";\nimport type { AgentObservation } from \"../domain/agent.types.ts\";\nimport type {\n  CustomReporter,\n  CustomReporterOptions,\n  ReporterHandlers,\n} from \"./custom-reporter.types.ts\";\n\nexport function createCustomReporter(\n  handlers: ReporterHandlers,\n  options: CustomReporterOptions = {},\n): CustomReporter {\n  const hub = createObservationHub({\n    ...(options.capacity === undefined ? {} : { capacity: options.capacity }),\n    ...(options.deliveryTimeoutMs === undefined\n      ? {}\n      : { deliveryTimeoutMs: options.deliveryTimeoutMs }),\n    sinks: [\n      {\n        async observe(value) {\n          const event = agentObservation(value);\n          if (!event) return;\n          const handler = handlers[event.kind] as\n            ((event: AgentObservation) => void | Promise<void>) | undefined;\n          try {\n            await handler?.(event);\n          } catch (error) {\n            try {\n              await options.onError?.(error, event);\n            } catch {}\n            throw error;\n          }\n        },\n      },\n    ],\n  });\n  const report = (event: AgentObservation): void => {\n    hub.child({ pass: event.pass }).emit(\"agent\", event);\n  };\n  return Object.assign(report, {\n    async flush() {\n      await hub.flush();\n      if (hub.errors.length) throw hub.errors[0];\n    },\n  });\n}\n"]}

package/dist/infrastructure/git/command.d.ts

@@ -1 +1,2 @@
-export declare function git(cwd: string, args: readonly string[], deadlineMs?: number, stdin?: string): Promise<string>;
+import type { Variables } from "../../domain/command.types.ts";
+export declare function git(cwd: string, args: readonly string[], deadlineMs?: number, stdin?: string, variables?: Variables): Promise<string>;

package/dist/infrastructure/git/command.js

@@ -1,6 +1,6 @@
 import { requireSuccess } from "../process.js";
 import { gitDefaults } from "./git.constants.js";
-export async function git(cwd, args, deadlineMs = gitDefaults.deadlineMs, stdin) {
+export async function git(cwd, args, deadlineMs = gitDefaults.deadlineMs, stdin, variables = {}) {
     const result = await requireSuccess({
         executable: "git",
         arguments: [
@@ -9,7 +9,7 @@ export async function git(cwd, args, deadlineMs = gitDefaults.deadlineMs, stdin)
             ...args,
         ],
         directory: cwd,
-        variables: { LC_ALL: "C", GIT_TERMINAL_PROMPT: "0" },
+        variables: { ...variables, LC_ALL: "C", GIT_TERMINAL_PROMPT: "0" },
         deadlineMs,
         retain: gitDefaults.retainBytes,
         ...(stdin === undefined ? {} : { stdin }),

package/dist/infrastructure/git/command.js.map

@@ -1 +1 @@
-{"version":3,"file":"command.js","sourceRoot":"","sources":["../../../src/infrastructure/git/command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,CAAC,KAAK,UAAU,GAAG,CACvB,GAAW,EACX,IAAuB,EACvB,aAAqB,WAAW,CAAC,UAAU,EAC3C,KAAc;IAEd,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC;QAClC,UAAU,EAAE,KAAK;QACjB,SAAS,EAAE;YACT,IAAI;YACJ,iBAAiB,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC;YACxE,GAAG,IAAI;SACR;QACD,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,mBAAmB,EAAE,GAAG,EAAE;QACpD,UAAU;QACV,MAAM,EAAE,WAAW,CAAC,WAAW;QAC/B,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;KAC1C,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,CAAC","sourcesContent":["import { requireSuccess } from \"../process.ts\";\nimport { gitDefaults } from \"./git.constants.ts\";\n\nexport async function git(\n  cwd: string,\n  args: readonly string[],\n  deadlineMs: number = gitDefaults.deadlineMs,\n  stdin?: string,\n): Promise<string> {\n  const result = await requireSuccess({\n    executable: \"git\",\n    arguments: [\n      \"-c\",\n      \"core.hooksPath=\" + (process.platform === \"win32\" ? \"NUL\" : \"/dev/null\"),\n      ...args,\n    ],\n    directory: cwd,\n    variables: { LC_ALL: \"C\", GIT_TERMINAL_PROMPT: \"0\" },\n    deadlineMs,\n    retain: gitDefaults.retainBytes,\n    ...(stdin === undefined ? {} : { stdin }),\n  });\n  return result.stdout;\n}\n"]}
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../../src/infrastructure/git/command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,CAAC,KAAK,UAAU,GAAG,CACvB,GAAW,EACX,IAAuB,EACvB,aAAqB,WAAW,CAAC,UAAU,EAC3C,KAAc,EACd,YAAuB,EAAE;IAEzB,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC;QAClC,UAAU,EAAE,KAAK;QACjB,SAAS,EAAE;YACT,IAAI;YACJ,iBAAiB,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC;YACxE,GAAG,IAAI;SACR;QACD,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,EAAE,GAAG,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,mBAAmB,EAAE,GAAG,EAAE;QAClE,UAAU;QACV,MAAM,EAAE,WAAW,CAAC,WAAW;QAC/B,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;KAC1C,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,CAAC","sourcesContent":["import type { Variables } from \"../../domain/command.types.ts\";\nimport { requireSuccess } from \"../process.ts\";\nimport { gitDefaults } from \"./git.constants.ts\";\n\nexport async function git(\n  cwd: string,\n  args: readonly string[],\n  deadlineMs: number = gitDefaults.deadlineMs,\n  stdin?: string,\n  variables: Variables = {},\n): Promise<string> {\n  const result = await requireSuccess({\n    executable: \"git\",\n    arguments: [\n      \"-c\",\n      \"core.hooksPath=\" + (process.platform === \"win32\" ? \"NUL\" : \"/dev/null\"),\n      ...args,\n    ],\n    directory: cwd,\n    variables: { ...variables, LC_ALL: \"C\", GIT_TERMINAL_PROMPT: \"0\" },\n    deadlineMs,\n    retain: gitDefaults.retainBytes,\n    ...(stdin === undefined ? {} : { stdin }),\n  });\n  return result.stdout;\n}\n"]}

package/dist/infrastructure/git/lock.constants.d.ts

@@ -0,0 +1,4 @@
+export declare const lockDefaults: Readonly<{
+    pendingDeleteAttempts: 50;
+    pendingDeleteRetryMs: 10;
+}>;

package/dist/infrastructure/git/lock.constants.js

@@ -0,0 +1,5 @@
+export const lockDefaults = Object.freeze({
+    pendingDeleteAttempts: 50,
+    pendingDeleteRetryMs: 10,
+});
+//# sourceMappingURL=lock.constants.js.map

package/dist/infrastructure/git/lock.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.constants.js","sourceRoot":"","sources":["../../../src/infrastructure/git/lock.constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC;IACxC,qBAAqB,EAAE,EAAE;IACzB,oBAAoB,EAAE,EAAE;CACzB,CAAC,CAAC","sourcesContent":["export const lockDefaults = Object.freeze({\n  pendingDeleteAttempts: 50,\n  pendingDeleteRetryMs: 10,\n});\n"]}