@elie-laloum/outpost 1.1.0

package/dist/infrastructure/conversations.d.ts

@@ -0,0 +1,30 @@
+import type { SandboxLease, ConversationStore } from "../domain/ports.ts";
+export type ConversationFormat = "claude" | "codex";
+export interface ConversationLocation {
+    readonly id: string;
+    readonly file: string;
+    readonly format: ConversationFormat;
+}
+export declare function nativeConversations(format: ConversationFormat): ConversationStore;
+export declare const conversations: {
+    native: typeof nativeConversations;
+    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 declare function projectKey(path: string): string;
+export declare function locateConversation(format: ConversationFormat, id: string, repository: string, home?: string): Promise<ConversationLocation>;
+export declare function relocateTranscript(text: string, destination: string, source?: string): string;
+declare function remotePath(format: ConversationFormat, id: string, lease: SandboxLease, original: string): string;
+export declare function restoreConversation(location: ConversationLocation, lease: SandboxLease, staging: string): Promise<void>;
+export declare function captureConversation(format: ConversationFormat, id: string, repository: string, lease: SandboxLease, staging: string, options?: {
+    home?: string;
+    warn?: (message: string) => void;
+    local?: boolean;
+}): Promise<ConversationLocation>;
+export {};

package/dist/infrastructure/conversations.js

@@ -0,0 +1,222 @@
+import { mkdir, readFile, readdir, rm, stat, writeFile, } from "node:fs/promises";
+import { homedir } from "node:os";
+import { basename, dirname, join, posix, resolve, relative } from "node:path";
+import { randomUUID } from "node:crypto";
+import { OutpostError, invariant } from "../domain/errors.js";
+import { safeDestination } from "./files.js";
+export function nativeConversations(format) {
+    return {
+        name: format,
+        locate(id, repository, home) {
+            return locateConversation(format, id, repository, home);
+        },
+        capture(id, context) {
+            return captureConversation(format, id, context.repository, context.sandbox, context.staging, context);
+        },
+        restore(record, context) {
+            invariant(record.format === format, "Conversation format does not match its storage");
+            return restoreConversation({ ...record, format }, context.sandbox, context.staging);
+        },
+    };
+}
+export const conversations = {
+    native: nativeConversations,
+    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 = homedir()) {
+        return format === "claude"
+            ? join(home, ".claude", "projects", projectKey(resolve(repository)))
+            : join(home, ".codex", "sessions");
+    },
+    destination: remotePath,
+};
+export function projectKey(path) {
+    return path.replace(/[^a-zA-Z0-9]/g, "-");
+}
+function validId(id) {
+    invariant(/^[A-Za-z0-9_-]+$/.test(id), "Invalid conversation identifier");
+}
+async function files(root) {
+    const result = [];
+    const entries = await readdir(root, { withFileTypes: true }).catch((error) => {
+        if (error.code === "ENOENT")
+            return [];
+        throw error;
+    });
+    for (const entry of entries) {
+        const path = join(root, entry.name);
+        if (entry.isDirectory())
+            result.push(...(await files(path)));
+        else if (entry.isFile() && entry.name.endsWith(".jsonl"))
+            result.push(path);
+    }
+    return result;
+}
+export async function locateConversation(format, id, repository, home = homedir()) {
+    validId(id);
+    if (format === "claude") {
+        const expected = join(home, ".claude", "projects", projectKey(resolve(repository)), `${id}.jsonl`);
+        if ((await stat(expected).catch(() => undefined))?.isFile())
+            return { id, file: expected, format };
+        const found = (await files(join(home, ".claude", "projects"))).find((path) => basename(path) === `${id}.jsonl`);
+        if (found)
+            return { id, file: found, format };
+    }
+    else {
+        const found = (await files(join(home, ".codex", "sessions"))).find((path) => path.endsWith(`-${id}.jsonl`));
+        if (found)
+            return { id, file: found, format };
+    }
+    throw new OutpostError("session", `Conversation ${id} was not found in native ${format} storage`, { id, repository });
+}
+export function relocateTranscript(text, destination, source) {
+    const records = text.split("\n");
+    const origin = source ??
+        records.reduce((found, line) => {
+            if (found)
+                return found;
+            try {
+                const item = JSON.parse(line);
+                return item.cwd ?? item.payload?.cwd;
+            }
+            catch {
+                return undefined;
+            }
+        }, undefined);
+    function visit(value) {
+        if (Array.isArray(value))
+            return value.map(visit);
+        if (value && typeof value === "object")
+            return Object.fromEntries(Object.entries(value).map(([key, item]) => [
+                key,
+                key === "cwd" && typeof item === "string" && item === origin
+                    ? destination
+                    : visit(item),
+            ]));
+        return value;
+    }
+    return records
+        .map((line) => {
+        if (!line.trim())
+            return line;
+        try {
+            const value = JSON.parse(line);
+            const rewritten = visit(value);
+            return JSON.stringify(value) === JSON.stringify(rewritten)
+                ? line
+                : JSON.stringify(rewritten);
+        }
+        catch {
+            return line;
+        }
+    })
+        .join("\n");
+}
+function remotePath(format, id, lease, original) {
+    validId(id);
+    return format === "claude"
+        ? posix.join(lease.home, ".claude", "projects", projectKey(lease.root), `${id}.jsonl`)
+        : posix.join(lease.home, ".codex", "sessions", ...new Date().toISOString().slice(0, 10).split("-"), basename(original));
+}
+export async function restoreConversation(location, lease, staging) {
+    const target = remotePath(location.format, location.id, lease, location.file);
+    const contents = relocateTranscript(await readFile(location.file, "utf8"), lease.root);
+    const temporary = join(staging, `${randomUUID()}.jsonl`);
+    await mkdir(staging, { recursive: true });
+    await writeFile(temporary, contents, { mode: 0o600 });
+    try {
+        await lease.upload(temporary, target);
+    }
+    finally {
+        await rm(temporary, { force: true });
+    }
+    if (location.format === "claude") {
+        const sidecars = join(dirname(location.file), location.id, "subagents");
+        for (const file of await files(sidecars)) {
+            const name = relative(sidecars, file).replaceAll("\\", "/");
+            const local = join(staging, `${randomUUID()}.jsonl`);
+            await writeFile(local, relocateTranscript(await readFile(file, "utf8"), lease.root), { mode: 0o600 });
+            try {
+                await lease.upload(local, posix.join(posix.dirname(target), location.id, "subagents", name));
+            }
+            finally {
+                await rm(local, { force: true });
+            }
+        }
+    }
+}
+export async function captureConversation(format, id, repository, lease, staging, options = {}) {
+    validId(id);
+    const home = options.home ?? homedir();
+    const search = format === "claude"
+        ? posix.join(lease.home, ".claude", "projects")
+        : posix.join(lease.home, ".codex", "sessions");
+    const pattern = format === "claude" ? `${id}.jsonl` : `*-${id}.jsonl`;
+    const result = options.local
+        ? {
+            status: 0,
+            stdout: (await locateConversation(format, id, lease.root, lease.home))
+                .file,
+        }
+        : await lease.invoke({
+            executable: "find",
+            arguments: [search, "-type", "f", "-name", pattern],
+            retain: 1_048_576,
+        });
+    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 = format === "claude"
+        ? join(home, ".claude", "projects", projectKey(resolve(repository)), `${id}.jsonl`)
+        : join(home, ".codex", "sessions", ...new Date().toISOString().slice(0, 10).split("-"), posix.basename(remote.replaceAll("\\", "/")));
+    await mkdir(staging, { recursive: true });
+    const temporary = join(staging, `${randomUUID()}.jsonl`);
+    await lease.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 (format === "claude") {
+        const remoteSidecars = posix.join(posix.dirname(remote), id, "subagents");
+        const listed = options.local
+            ? {
+                status: 0,
+                stdout: (await files(join(dirname(remote), id, "subagents"))).join("\n"),
+            }
+            : await lease.invoke({
+                executable: "find",
+                arguments: [remoteSidecars, "-type", "f", "-name", "*.jsonl"],
+                retain: 1_048_576,
+            });
+        if (listed.status === 0)
+            for (const child of listed.stdout.split("\n").filter(Boolean)) {
+                try {
+                    const scratch = join(staging, `${randomUUID()}.jsonl`);
+                    await lease.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) {
+                    options.warn?.(`Could not capture child transcript: ${String(cause)}`);
+                }
+            }
+    }
+    return { id, file, format };
+}
+//# sourceMappingURL=conversations.js.map

package/dist/infrastructure/conversations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversations.js","sourceRoot":"","sources":["../../src/infrastructure/conversations.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  mkdir,\n  readFile,\n  readdir,\n  rm,\n  stat,\n  writeFile,\n} from \"node:fs/promises\";\nimport { homedir } from \"node:os\";\nimport { basename, dirname, join, posix, resolve, relative } from \"node:path\";\nimport { randomUUID } from \"node:crypto\";\nimport { OutpostError, invariant } from \"../domain/errors.ts\";\nimport type { SandboxLease, ConversationStore } from \"../domain/ports.ts\";\nimport { safeDestination } from \"./files.ts\";\n\nexport type ConversationFormat = \"claude\" | \"codex\";\nexport interface ConversationLocation {\n  readonly id: string;\n  readonly file: string;\n  readonly format: ConversationFormat;\n}\n\nexport function nativeConversations(\n  format: ConversationFormat,\n): ConversationStore {\n  return {\n    name: format,\n    locate(id, repository, home) {\n      return locateConversation(format, id, repository, home);\n    },\n    capture(id, context) {\n      return captureConversation(\n        format,\n        id,\n        context.repository,\n        context.sandbox,\n        context.staging,\n        context,\n      );\n    },\n    restore(record, context) {\n      invariant(\n        record.format === format,\n        \"Conversation format does not match its storage\",\n      );\n      return restoreConversation(\n        { ...record, format },\n        context.sandbox,\n        context.staging,\n      );\n    },\n  };\n}\n\nexport const conversations = {\n  native: nativeConversations,\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 = homedir(),\n  ): string {\n    return format === \"claude\"\n      ? join(home, \".claude\", \"projects\", projectKey(resolve(repository)))\n      : join(home, \".codex\", \"sessions\");\n  },\n  destination: remotePath,\n};\n\nexport function projectKey(path: string): string {\n  return path.replace(/[^a-zA-Z0-9]/g, \"-\");\n}\nfunction validId(id: string): void {\n  invariant(/^[A-Za-z0-9_-]+$/.test(id), \"Invalid conversation identifier\");\n}\n\nasync function files(root: string): Promise<string[]> {\n  const result: string[] = [];\n  const entries = await readdir(root, { withFileTypes: true }).catch(\n    (error) => {\n      if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return [];\n      throw error;\n    },\n  );\n  for (const entry of entries) {\n    const path = join(root, entry.name);\n    if (entry.isDirectory()) result.push(...(await files(path)));\n    else if (entry.isFile() && entry.name.endsWith(\".jsonl\")) result.push(path);\n  }\n  return result;\n}\n\nexport async function locateConversation(\n  format: ConversationFormat,\n  id: string,\n  repository: string,\n  home = homedir(),\n): Promise<ConversationLocation> {\n  validId(id);\n  if (format === \"claude\") {\n    const expected = join(\n      home,\n      \".claude\",\n      \"projects\",\n      projectKey(resolve(repository)),\n      `${id}.jsonl`,\n    );\n    if ((await stat(expected).catch(() => undefined))?.isFile())\n      return { id, file: expected, format };\n    const found = (await files(join(home, \".claude\", \"projects\"))).find(\n      (path) => basename(path) === `${id}.jsonl`,\n    );\n    if (found) return { id, file: found, format };\n  } else {\n    const found = (await files(join(home, \".codex\", \"sessions\"))).find((path) =>\n      path.endsWith(`-${id}.jsonl`),\n    );\n    if (found) return { id, file: found, format };\n  }\n  throw new OutpostError(\n    \"session\",\n    `Conversation ${id} was not found in native ${format} storage`,\n    { id, repository },\n  );\n}\n\nexport function relocateTranscript(\n  text: string,\n  destination: string,\n  source?: string,\n): string {\n  const records = text.split(\"\\n\");\n  const origin =\n    source ??\n    records.reduce<string | undefined>((found, line) => {\n      if (found) return found;\n      try {\n        const item = JSON.parse(line);\n        return item.cwd ?? item.payload?.cwd;\n      } catch {\n        return undefined;\n      }\n    }, undefined);\n  function visit(value: unknown): unknown {\n    if (Array.isArray(value)) return value.map(visit);\n    if (value && typeof value === \"object\")\n      return Object.fromEntries(\n        Object.entries(value).map(([key, item]) => [\n          key,\n          key === \"cwd\" && typeof item === \"string\" && item === origin\n            ? destination\n            : visit(item),\n        ]),\n      );\n    return value;\n  }\n  return records\n    .map((line) => {\n      if (!line.trim()) return line;\n      try {\n        const value = JSON.parse(line);\n        const rewritten = visit(value);\n        return JSON.stringify(value) === JSON.stringify(rewritten)\n          ? line\n          : JSON.stringify(rewritten);\n      } catch {\n        return line;\n      }\n    })\n    .join(\"\\n\");\n}\n\nfunction remotePath(\n  format: ConversationFormat,\n  id: string,\n  lease: SandboxLease,\n  original: string,\n): string {\n  validId(id);\n  return format === \"claude\"\n    ? posix.join(\n        lease.home,\n        \".claude\",\n        \"projects\",\n        projectKey(lease.root),\n        `${id}.jsonl`,\n      )\n    : posix.join(\n        lease.home,\n        \".codex\",\n        \"sessions\",\n        ...new Date().toISOString().slice(0, 10).split(\"-\"),\n        basename(original),\n      );\n}\n\nexport async function restoreConversation(\n  location: ConversationLocation,\n  lease: SandboxLease,\n  staging: string,\n): Promise<void> {\n  const target = remotePath(location.format, location.id, lease, location.file);\n  const contents = relocateTranscript(\n    await readFile(location.file, \"utf8\"),\n    lease.root,\n  );\n  const temporary = join(staging, `${randomUUID()}.jsonl`);\n  await mkdir(staging, { recursive: true });\n  await writeFile(temporary, contents, { mode: 0o600 });\n  try {\n    await lease.upload(temporary, target);\n  } finally {\n    await rm(temporary, { force: true });\n  }\n  if (location.format === \"claude\") {\n    const sidecars = join(dirname(location.file), location.id, \"subagents\");\n    for (const file of await files(sidecars)) {\n      const name = relative(sidecars, file).replaceAll(\"\\\\\", \"/\");\n      const local = join(staging, `${randomUUID()}.jsonl`);\n      await writeFile(\n        local,\n        relocateTranscript(await readFile(file, \"utf8\"), lease.root),\n        { mode: 0o600 },\n      );\n      try {\n        await lease.upload(\n          local,\n          posix.join(posix.dirname(target), location.id, \"subagents\", name),\n        );\n      } finally {\n        await rm(local, { force: true });\n      }\n    }\n  }\n}\n\nexport async function captureConversation(\n  format: ConversationFormat,\n  id: string,\n  repository: string,\n  lease: SandboxLease,\n  staging: string,\n  options: {\n    home?: string;\n    warn?: (message: string) => void;\n    local?: boolean;\n  } = {},\n): Promise<ConversationLocation> {\n  validId(id);\n  const home = options.home ?? homedir();\n  const search =\n    format === \"claude\"\n      ? posix.join(lease.home, \".claude\", \"projects\")\n      : posix.join(lease.home, \".codex\", \"sessions\");\n  const pattern = format === \"claude\" ? `${id}.jsonl` : `*-${id}.jsonl`;\n  const result = options.local\n    ? {\n        status: 0,\n        stdout: (await locateConversation(format, id, lease.root, lease.home))\n          .file,\n      }\n    : await lease.invoke({\n        executable: \"find\",\n        arguments: [search, \"-type\", \"f\", \"-name\", pattern],\n        retain: 1_048_576,\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 =\n    format === \"claude\"\n      ? join(\n          home,\n          \".claude\",\n          \"projects\",\n          projectKey(resolve(repository)),\n          `${id}.jsonl`,\n        )\n      : join(\n          home,\n          \".codex\",\n          \"sessions\",\n          ...new Date().toISOString().slice(0, 10).split(\"-\"),\n          posix.basename(remote.replaceAll(\"\\\\\", \"/\")),\n        );\n  await mkdir(staging, { recursive: true });\n  const temporary = join(staging, `${randomUUID()}.jsonl`);\n  await lease.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 (format === \"claude\") {\n    const remoteSidecars = posix.join(posix.dirname(remote), id, \"subagents\");\n    const listed = options.local\n      ? {\n          status: 0,\n          stdout: (await files(join(dirname(remote), id, \"subagents\"))).join(\n            \"\\n\",\n          ),\n        }\n      : await lease.invoke({\n          executable: \"find\",\n          arguments: [remoteSidecars, \"-type\", \"f\", \"-name\", \"*.jsonl\"],\n          retain: 1_048_576,\n        });\n    if (listed.status === 0)\n      for (const child of listed.stdout.split(\"\\n\").filter(Boolean)) {\n        try {\n          const scratch = join(staging, `${randomUUID()}.jsonl`);\n          await lease.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          options.warn?.(\n            `Could not capture child transcript: ${String(cause)}`,\n          );\n        }\n      }\n  }\n  return { id, file, format };\n}\n"]}

package/dist/infrastructure/files.d.ts

@@ -0,0 +1,5 @@
+export declare function expandPath(value: string, base?: string): string;
+export declare function directory(value?: string): Promise<string>;
+export declare function inside(root: string, path: string): boolean;
+export declare function safeDestination(root: string, entry: string): Promise<string>;
+export declare function copySelected(source: string, target: string, entries: readonly string[], deadlineMs?: number): Promise<void>;

package/dist/infrastructure/files.js

@@ -0,0 +1,85 @@
+import { cp, lstat, mkdir, realpath, stat } from "node:fs/promises";
+import { dirname, isAbsolute, relative, resolve, sep } from "node:path";
+import { homedir } from "node:os";
+import { OutpostError } from "../domain/errors.js";
+export function expandPath(value, base = process.cwd()) {
+    const expanded = value === "~"
+        ? homedir()
+        : /^~[\\/]/.test(value)
+            ? resolve(homedir(), value.slice(2))
+            : value;
+    return resolve(base, expanded);
+}
+export async function directory(value = process.cwd()) {
+    const path = expandPath(value);
+    try {
+        if (!(await stat(path)).isDirectory())
+            throw new Error("Not a directory");
+        return await realpath(path);
+    }
+    catch (cause) {
+        throw new OutpostError("workspace", `Directory is unavailable: ${path}`, { path }, cause);
+    }
+}
+export function inside(root, path) {
+    const rel = relative(resolve(root), resolve(path));
+    return (rel === "" ||
+        (!isAbsolute(rel) && rel !== ".." && !rel.startsWith(`..${sep}`)));
+}
+export async function safeDestination(root, entry) {
+    if (!entry ||
+        isAbsolute(entry) ||
+        entry
+            .split(/[\\/]/)
+            .some((part) => part === ".." || part.toLowerCase() === ".git") ||
+        entry.includes("\0"))
+        throw new OutpostError("workspace", `Unsafe workspace path: ${entry}`);
+    const target = resolve(root, entry);
+    if (!inside(root, target))
+        throw new OutpostError("workspace", "Path escapes workspace");
+    let parent = dirname(target);
+    while (inside(root, parent)) {
+        const info = await lstat(parent).catch((error) => {
+            if (error.code === "ENOENT")
+                return undefined;
+            throw error;
+        });
+        if (info?.isSymbolicLink())
+            throw new OutpostError("workspace", `Workspace path traverses a symlink: ${entry}`);
+        if (resolve(parent) === resolve(root))
+            break;
+        parent = dirname(parent);
+    }
+    return target;
+}
+export async function copySelected(source, target, entries, deadlineMs = 60_000) {
+    const started = Date.now();
+    for (const entry of entries) {
+        if (!entry ||
+            isAbsolute(entry) ||
+            entry.split(/[\\/]/).some((part) => part === ".." || part === ".git"))
+            throw new OutpostError("configuration", `Unsafe copied path: ${entry}`);
+        const from = await safeDestination(source, entry), to = await safeDestination(target, entry);
+        if (!inside(source, from) || !inside(target, to))
+            throw new OutpostError("configuration", "Copy must stay within workspace boundaries");
+        const info = await lstat(from).catch((error) => {
+            if (error.code === "ENOENT")
+                return undefined;
+            throw error;
+        });
+        if (!info || resolve(from) === resolve(to))
+            continue;
+        await mkdir(dirname(to), { recursive: true });
+        await cp(from, to, {
+            recursive: true,
+            force: true,
+            dereference: false,
+            filter: () => {
+                if (Date.now() - started > deadlineMs)
+                    throw new OutpostError("timeout", "Workspace copy deadline exceeded", { deadlineMs });
+                return true;
+            },
+        });
+    }
+}
+//# sourceMappingURL=files.js.map

package/dist/infrastructure/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/infrastructure/files.ts"],"names":[],"mappings":"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","sourcesContent":["import { cp, lstat, mkdir, realpath, stat } from \"node:fs/promises\";\nimport { dirname, isAbsolute, relative, resolve, sep } from \"node:path\";\nimport { homedir } from \"node:os\";\nimport { OutpostError } from \"../domain/errors.ts\";\n\nexport function expandPath(value: string, base = process.cwd()): string {\n  const expanded =\n    value === \"~\"\n      ? homedir()\n      : /^~[\\\\/]/.test(value)\n        ? resolve(homedir(), value.slice(2))\n        : value;\n  return resolve(base, expanded);\n}\n\nexport async function directory(value = process.cwd()): Promise<string> {\n  const path = expandPath(value);\n  try {\n    if (!(await stat(path)).isDirectory()) throw new Error(\"Not a directory\");\n    return await realpath(path);\n  } catch (cause) {\n    throw new OutpostError(\n      \"workspace\",\n      `Directory is unavailable: ${path}`,\n      { path },\n      cause,\n    );\n  }\n}\n\nexport function inside(root: string, path: string): boolean {\n  const rel = relative(resolve(root), resolve(path));\n  return (\n    rel === \"\" ||\n    (!isAbsolute(rel) && rel !== \"..\" && !rel.startsWith(`..${sep}`))\n  );\n}\n\nexport async function safeDestination(\n  root: string,\n  entry: string,\n): Promise<string> {\n  if (\n    !entry ||\n    isAbsolute(entry) ||\n    entry\n      .split(/[\\\\/]/)\n      .some((part) => part === \"..\" || part.toLowerCase() === \".git\") ||\n    entry.includes(\"\\0\")\n  )\n    throw new OutpostError(\"workspace\", `Unsafe workspace path: ${entry}`);\n  const target = resolve(root, entry);\n  if (!inside(root, target))\n    throw new OutpostError(\"workspace\", \"Path escapes workspace\");\n  let parent = dirname(target);\n  while (inside(root, parent)) {\n    const info = await lstat(parent).catch((error) => {\n      if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return undefined;\n      throw error;\n    });\n    if (info?.isSymbolicLink())\n      throw new OutpostError(\n        \"workspace\",\n        `Workspace path traverses a symlink: ${entry}`,\n      );\n    if (resolve(parent) === resolve(root)) break;\n    parent = dirname(parent);\n  }\n  return target;\n}\n\nexport async function copySelected(\n  source: string,\n  target: string,\n  entries: readonly string[],\n  deadlineMs = 60_000,\n): Promise<void> {\n  const started = Date.now();\n  for (const entry of entries) {\n    if (\n      !entry ||\n      isAbsolute(entry) ||\n      entry.split(/[\\\\/]/).some((part) => part === \"..\" || part === \".git\")\n    )\n      throw new OutpostError(\"configuration\", `Unsafe copied path: ${entry}`);\n    const from = await safeDestination(source, entry),\n      to = await safeDestination(target, entry);\n    if (!inside(source, from) || !inside(target, to))\n      throw new OutpostError(\n        \"configuration\",\n        \"Copy must stay within workspace boundaries\",\n      );\n    const info = await lstat(from).catch((error) => {\n      if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return undefined;\n      throw error;\n    });\n    if (!info || resolve(from) === resolve(to)) continue;\n    await mkdir(dirname(to), { recursive: true });\n    await cp(from, to, {\n      recursive: true,\n      force: true,\n      dereference: false,\n      filter: () => {\n        if (Date.now() - started > deadlineMs)\n          throw new OutpostError(\n            \"timeout\",\n            \"Workspace copy deadline exceeded\",\n            { deadlineMs },\n          );\n        return true;\n      },\n    });\n  }\n}\n"]}

package/dist/infrastructure/git.d.ts

@@ -0,0 +1,14 @@
+import type { BranchPolicy, Commit, Disposal, StageLimits, WorkspaceRecord } from "../domain/ports.ts";
+export declare function git(cwd: string, args: readonly string[], deadlineMs?: number, stdin?: string): Promise<string>;
+export declare function commits(cwd: string, baseline: string, deadlineMs?: number): Promise<Commit[]>;
+export interface WorkspaceLease extends WorkspaceRecord {
+    integrate(): Promise<void>;
+    dispose(preserve?: boolean): Promise<Disposal>;
+}
+export declare function acquireWorkspace(options: {
+    repository?: string;
+    branch?: BranchPolicy;
+    copies?: readonly string[];
+    limits?: StageLimits;
+    label?: string;
+}): Promise<WorkspaceLease>;