@ai-hero/sandcastle 0.0.1

package/dist/Display.js

@@ -0,0 +1,132 @@
+import * as clack from "@clack/prompts";
+import { FileSystem } from "@effect/platform";
+import { dirname } from "node:path";
+import { Context, Effect, Layer, Ref } from "effect";
+import { styleText } from "node:util";
+export class Display extends Context.Tag("Display")() {
+}
+export const SilentDisplay = {
+    layer: (ref) => Layer.succeed(Display, {
+        intro: (title) => Ref.update(ref, (entries) => [
+            ...entries,
+            { _tag: "intro", title },
+        ]),
+        status: (message, severity) => Ref.update(ref, (entries) => [
+            ...entries,
+            { _tag: "status", message, severity },
+        ]),
+        spinner: (message, effect) => Effect.flatMap(Ref.update(ref, (entries) => [
+            ...entries,
+            { _tag: "spinner", message },
+        ]), () => effect),
+        summary: (title, rows) => Ref.update(ref, (entries) => [
+            ...entries,
+            { _tag: "summary", title, rows },
+        ]),
+        taskLog: (title, effect) => {
+            const messages = [];
+            return Effect.flatMap(effect((msg) => messages.push(msg)), (result) => Effect.map(Ref.update(ref, (entries) => [
+                ...entries,
+                {
+                    _tag: "taskLog",
+                    title,
+                    messages: [...messages],
+                },
+            ]), () => result));
+        },
+        text: (message) => Ref.update(ref, (entries) => [
+            ...entries,
+            { _tag: "text", message },
+        ]),
+    }),
+};
+export const FileDisplay = {
+    layer: (filePath) => Layer.effect(Display, Effect.gen(function* () {
+        const fs = yield* FileSystem.FileSystem;
+        yield* fs
+            .makeDirectory(dirname(filePath), { recursive: true })
+            .pipe(Effect.orDie);
+        yield* fs.writeFileString(filePath, "").pipe(Effect.orDie);
+        const appendToLog = (line) => fs
+            .writeFileString(filePath, line + "\n", { flag: "a" })
+            .pipe(Effect.orDie);
+        return {
+            intro: () => Effect.void,
+            status: (message, _severity) => appendToLog(message.replace(/^\[[^\]]+\] /, "")),
+            spinner: (message, effect) => Effect.gen(function* () {
+                yield* appendToLog(`${message}...`);
+                const start = Date.now();
+                const result = yield* effect;
+                const elapsed = ((Date.now() - start) / 1000).toFixed(1);
+                yield* appendToLog(`${message} done (${elapsed}s)`);
+                return result;
+            }),
+            summary: (title, rows) => {
+                const lines = Object.entries(rows)
+                    .map(([key, value]) => `  ${key}: ${value}`)
+                    .join("\n");
+                return appendToLog(`${title}\n${lines}`);
+            },
+            taskLog: (title, effect) => Effect.gen(function* () {
+                yield* appendToLog(title);
+                const start = Date.now();
+                const messages = [];
+                const result = yield* effect((msg) => {
+                    messages.push(msg);
+                });
+                const elapsed = ((Date.now() - start) / 1000).toFixed(1);
+                for (const msg of messages) {
+                    yield* appendToLog(`  ${msg}`);
+                }
+                yield* appendToLog(`${title} done (${elapsed}s)`);
+                return result;
+            }),
+            text: (message) => appendToLog(message),
+        };
+    })),
+};
+const severityToClack = {
+    info: clack.log.info,
+    success: clack.log.success,
+    warn: clack.log.warning,
+    error: clack.log.error,
+};
+export const terminalStyle = {
+    status: (message) => styleText("bold", message),
+    summaryTitle: (title) => styleText("bold", title),
+    summaryRow: (key, value) => `${styleText("bold", key)}: ${styleText("dim", value)}`,
+};
+export const ClackDisplay = {
+    layer: Layer.succeed(Display, {
+        intro: (title) => Effect.sync(() => clack.intro(styleText("inverse", ` ${title} `))),
+        status: (message, severity) => Effect.sync(() => severityToClack[severity](terminalStyle.status(message))),
+        spinner: (message, effect) => Effect.acquireUseRelease(Effect.sync(() => {
+            const s = clack.spinner();
+            s.start(message);
+            return s;
+        }), () => effect, (s, exit) => Effect.sync(() => {
+            if (exit._tag === "Success") {
+                s.stop(message);
+            }
+            else {
+                s.stop(`${message} (failed)`);
+            }
+        })),
+        summary: (title, rows) => Effect.sync(() => {
+            const lines = Object.entries(rows)
+                .map(([key, value]) => terminalStyle.summaryRow(key, value))
+                .join("\n");
+            clack.note(lines, terminalStyle.summaryTitle(title));
+        }),
+        taskLog: (title, effect) => Effect.acquireUseRelease(Effect.sync(() => clack.taskLog({ title })), (log) => effect((msg) => log.message(msg)), (log, exit) => Effect.sync(() => {
+            if (exit._tag === "Success") {
+                log.success(title, { showLog: true });
+            }
+            else {
+                log.error(title, { showLog: true });
+            }
+        })),
+        text: (message) => Effect.sync(() => clack.log.message(message)),
+    }),
+};
+//# sourceMappingURL=Display.js.map

package/dist/Display.js.map

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

package/dist/DockerLifecycle.d.ts

@@ -0,0 +1,37 @@
+import { Effect } from "effect";
+import { DockerError } from "./errors.js";
+/**
+ * Build the sandcastle Docker image.
+ *
+ * When `dockerfile` is provided, uses `docker build -f <dockerfile> <cwd>`
+ * so COPY instructions resolve relative to the current working directory.
+ * Otherwise, uses `docker build <dockerfileDir>` (the default .sandcastle/ directory).
+ */
+export declare const buildImage: (imageName: string, dockerfileDir: string, options?: {
+    readonly dockerfile?: string | undefined;
+} | undefined) => Effect.Effect<void, DockerError, never>;
+export interface StartContainerOptions {
+    readonly volumeMounts?: readonly string[];
+    readonly workdir?: string;
+    /** Run the container as this uid:gid instead of the Dockerfile's USER. */
+    readonly user?: string;
+}
+/**
+ * Start a new container with environment variables injected.
+ */
+export declare const startContainer: (containerName: string, imageName: string, env: Record<string, string>, options?: StartContainerOptions | undefined) => Effect.Effect<void, DockerError, never>;
+/**
+ * Fix ownership of a directory inside the container.
+ * Runs as root so the target owner can write to the path.
+ * @param owner - chown-compatible owner spec, e.g. "1000:1000" or "agent"
+ */
+export declare const chownInContainer: (containerName: string, owner: string, path: string) => Effect.Effect<void, DockerError, never>;
+/**
+ * Stop and remove a container without removing the image.
+ */
+export declare const removeContainer: (containerName: string) => Effect.Effect<void, DockerError, never>;
+/**
+ * Remove a Docker image.
+ */
+export declare const removeImage: (imageName: string) => Effect.Effect<void, DockerError, never>;
+//# sourceMappingURL=DockerLifecycle.d.ts.map

package/dist/DockerLifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DockerLifecycle.d.ts","sourceRoot":"","sources":["../src/DockerLifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAwB1C;;;;;;GAMG;AACH,eAAO,MAAM,UAAU;;yDAkBnB,CAAC;AAEL,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,iKAiDvB,CAAC;AAEL;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,iGAgB1B,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,eAAe,oEAQxB,CAAC;AAEL;;GAEG;AACH,eAAO,MAAM,WAAW,gEAKpB,CAAC"}

package/dist/DockerLifecycle.js

@@ -0,0 +1,109 @@
+import { Effect } from "effect";
+import { execFile } from "node:child_process";
+import { resolve } from "node:path";
+import { DockerError } from "./errors.js";
+const dockerExec = (args) => Effect.async((resume) => {
+    execFile("docker", args, { maxBuffer: 10 * 1024 * 1024 }, (error, stdout, stderr) => {
+        if (error) {
+            resume(Effect.fail(new DockerError({
+                message: `docker ${args[0]} failed: ${stderr?.toString() || error.message}`,
+            })));
+        }
+        else {
+            resume(Effect.succeed(stdout.toString()));
+        }
+    });
+});
+/**
+ * Build the sandcastle Docker image.
+ *
+ * When `dockerfile` is provided, uses `docker build -f <dockerfile> <cwd>`
+ * so COPY instructions resolve relative to the current working directory.
+ * Otherwise, uses `docker build <dockerfileDir>` (the default .sandcastle/ directory).
+ */
+export const buildImage = (imageName, dockerfileDir, options) => Effect.gen(function* () {
+    if (options?.dockerfile) {
+        yield* dockerExec([
+            "build",
+            "-t",
+            imageName,
+            "-f",
+            resolve(options.dockerfile),
+            process.cwd(),
+        ]);
+    }
+    else {
+        yield* dockerExec(["build", "-t", imageName, resolve(dockerfileDir)]);
+    }
+});
+/**
+ * Start a new container with environment variables injected.
+ */
+export const startContainer = (containerName, imageName, env, options) => Effect.gen(function* () {
+    // Check if container already exists
+    const existing = yield* dockerExec([
+        "ps",
+        "-a",
+        "--filter",
+        `name=^${containerName}$`,
+        "--format",
+        "{{.Names}}",
+    ]);
+    if (existing.trim() === containerName) {
+        yield* Effect.fail(new DockerError({
+            message: `Container '${containerName}' already exists. Run cleanup first.`,
+        }));
+    }
+    const envFlags = Object.entries(env).flatMap(([k, v]) => [
+        "-e",
+        `${k}=${v}`,
+    ]);
+    const volumeFlags = (options?.volumeMounts ?? []).flatMap((mount) => [
+        "-v",
+        mount,
+    ]);
+    const workdirFlags = options?.workdir ? ["-w", options.workdir] : [];
+    const userFlags = options?.user ? ["--user", options.user] : [];
+    yield* dockerExec([
+        "run",
+        "-d",
+        "--name",
+        containerName,
+        ...envFlags,
+        ...volumeFlags,
+        ...workdirFlags,
+        ...userFlags,
+        imageName,
+    ]);
+});
+/**
+ * Fix ownership of a directory inside the container.
+ * Runs as root so the target owner can write to the path.
+ * @param owner - chown-compatible owner spec, e.g. "1000:1000" or "agent"
+ */
+export const chownInContainer = (containerName, owner, path) => Effect.asVoid(dockerExec([
+    "exec",
+    "-u",
+    "root",
+    containerName,
+    "chown",
+    "-R",
+    owner,
+    path,
+]));
+/**
+ * Stop and remove a container without removing the image.
+ */
+export const removeContainer = (containerName) => Effect.gen(function* () {
+    // Stop container (ignore errors if already stopped)
+    yield* Effect.ignore(dockerExec(["stop", containerName]));
+    // Remove container (ignore errors if not found)
+    yield* Effect.ignore(dockerExec(["rm", containerName]));
+});
+/**
+ * Remove a Docker image.
+ */
+export const removeImage = (imageName) => Effect.gen(function* () {
+    yield* dockerExec(["rmi", imageName]);
+});
+//# sourceMappingURL=DockerLifecycle.js.map

package/dist/DockerLifecycle.js.map

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

package/dist/DockerSandbox.d.ts

@@ -0,0 +1,6 @@
+import { Layer } from "effect";
+import { Sandbox } from "./Sandbox.js";
+export declare const DockerSandbox: {
+    layer: (containerName: string) => Layer.Layer<Sandbox, never, never>;
+};
+//# sourceMappingURL=DockerSandbox.d.ts.map

package/dist/DockerSandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DockerSandbox.d.ts","sourceRoot":"","sources":["../src/DockerSandbox.ts"],"names":[],"mappings":"AAEA,OAAO,EAAU,KAAK,EAAE,MAAM,QAAQ,CAAC;AAKvC,OAAO,EAAE,OAAO,EAAuB,MAAM,cAAc,CAAC;AA+K5D,eAAO,MAAM,aAAa;;CAKzB,CAAC"}

package/dist/DockerSandbox.js

@@ -0,0 +1,122 @@
+import { FileSystem } from "@effect/platform";
+import { NodeFileSystem } from "@effect/platform-node";
+import { Effect, Layer } from "effect";
+import { execFile, spawn } from "node:child_process";
+import { dirname } from "node:path";
+import { createInterface } from "node:readline";
+import { CopyError, ExecError } from "./errors.js";
+import { Sandbox } from "./Sandbox.js";
+const makeDockerSandbox = (containerName) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    return {
+        exec: (command, options) => Effect.async((resume) => {
+            const args = ["exec"];
+            if (options?.cwd) {
+                args.push("-w", options.cwd);
+            }
+            args.push(containerName, "sh", "-c", command);
+            execFile("docker", args, { maxBuffer: 10 * 1024 * 1024 }, (error, stdout, stderr) => {
+                if (error && error.code === undefined) {
+                    resume(Effect.fail(new ExecError({
+                        command,
+                        message: `docker exec failed: ${error.message}`,
+                    })));
+                }
+                else {
+                    resume(Effect.succeed({
+                        stdout: stdout.toString(),
+                        stderr: stderr.toString(),
+                        exitCode: typeof error?.code === "number"
+                            ? error.code
+                            : 0,
+                    }));
+                }
+            });
+        }),
+        execStreaming: (command, onStdoutLine, options) => Effect.async((resume) => {
+            const args = ["exec"];
+            if (options?.cwd) {
+                args.push("-w", options.cwd);
+            }
+            args.push(containerName, "sh", "-c", command);
+            const proc = spawn("docker", args, {
+                stdio: ["ignore", "pipe", "pipe"],
+            });
+            const stdoutChunks = [];
+            const stderrChunks = [];
+            const rl = createInterface({ input: proc.stdout });
+            rl.on("line", (line) => {
+                stdoutChunks.push(line);
+                onStdoutLine(line);
+            });
+            proc.stderr.on("data", (chunk) => {
+                stderrChunks.push(chunk.toString());
+            });
+            proc.on("error", (error) => {
+                resume(Effect.fail(new ExecError({
+                    command,
+                    message: `docker exec streaming failed: ${error.message}`,
+                })));
+            });
+            proc.on("close", (code) => {
+                resume(Effect.succeed({
+                    stdout: stdoutChunks.join("\n"),
+                    stderr: stderrChunks.join(""),
+                    exitCode: code ?? 0,
+                }));
+            });
+        }),
+        copyIn: (hostPath, sandboxPath) => Effect.gen(function* () {
+            // Ensure parent directory exists in container
+            const parentDir = dirname(sandboxPath);
+            yield* Effect.async((resume) => {
+                execFile("docker", ["exec", containerName, "mkdir", "-p", parentDir], (error) => {
+                    if (error) {
+                        resume(Effect.fail(new CopyError({
+                            message: `Failed to create dir ${parentDir}: ${error.message}`,
+                        })));
+                    }
+                    else {
+                        resume(Effect.succeed(undefined));
+                    }
+                });
+            });
+            // docker cp hostPath containerName:sandboxPath
+            yield* Effect.async((resume) => {
+                execFile("docker", ["cp", hostPath, `${containerName}:${sandboxPath}`], (error) => {
+                    if (error) {
+                        resume(Effect.fail(new CopyError({
+                            message: `Failed to copy ${hostPath} -> ${containerName}:${sandboxPath}: ${error.message}`,
+                        })));
+                    }
+                    else {
+                        resume(Effect.succeed(undefined));
+                    }
+                });
+            });
+        }),
+        copyOut: (sandboxPath, hostPath) => Effect.gen(function* () {
+            // Ensure parent directory exists on host
+            yield* fs.makeDirectory(dirname(hostPath), { recursive: true }).pipe(Effect.mapError((error) => new CopyError({
+                message: `Failed to create host dir ${dirname(hostPath)}: ${error}`,
+            })));
+            // docker cp containerName:sandboxPath hostPath
+            yield* Effect.async((resume) => {
+                execFile("docker", ["cp", `${containerName}:${sandboxPath}`, hostPath], (error) => {
+                    if (error) {
+                        resume(Effect.fail(new CopyError({
+                            message: `Failed to copy ${containerName}:${sandboxPath} -> ${hostPath}: ${error.message}`,
+                        })));
+                    }
+                    else {
+                        resume(Effect.succeed(undefined));
+                    }
+                });
+            });
+        }),
+    };
+});
+export const DockerSandbox = {
+    layer: (containerName) => Layer.effect(Sandbox, makeDockerSandbox(containerName)).pipe(Layer.provide(NodeFileSystem.layer)),
+};
+//# sourceMappingURL=DockerSandbox.js.map

package/dist/DockerSandbox.js.map

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

package/dist/EnvResolver.d.ts

@@ -0,0 +1,11 @@
+import { FileSystem } from "@effect/platform";
+import { Effect } from "effect";
+/**
+ * Resolve all env vars from .env files with process.env fallback.
+ *
+ * Precedence: .sandcastle/.env > process.env
+ * Only keys declared in .sandcastle/.env are resolved from process.env.
+ * Repo root .env is not part of the resolution chain.
+ */
+export declare const resolveEnv: (repoDir: string) => Effect.Effect<Record<string, string>, never, FileSystem.FileSystem>;
+//# sourceMappingURL=EnvResolver.d.ts.map

package/dist/EnvResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnvResolver.d.ts","sourceRoot":"","sources":["../src/EnvResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAyBhC;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,0FAiBnB,CAAC"}

package/dist/EnvResolver.js

@@ -0,0 +1,43 @@
+import { FileSystem } from "@effect/platform";
+import { Effect } from "effect";
+import { join } from "node:path";
+const parseEnvFile = (filePath) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const content = yield* fs
+        .readFileString(filePath)
+        .pipe(Effect.catchAll(() => Effect.succeed(null)));
+    if (content === null)
+        return {};
+    const vars = {};
+    for (const line of content.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#"))
+            continue;
+        const eqIndex = trimmed.indexOf("=");
+        if (eqIndex === -1)
+            continue;
+        const key = trimmed.slice(0, eqIndex).trim();
+        const value = trimmed.slice(eqIndex + 1).trim();
+        vars[key] = value;
+    }
+    return vars;
+});
+/**
+ * Resolve all env vars from .env files with process.env fallback.
+ *
+ * Precedence: .sandcastle/.env > process.env
+ * Only keys declared in .sandcastle/.env are resolved from process.env.
+ * Repo root .env is not part of the resolution chain.
+ */
+export const resolveEnv = (repoDir) => Effect.gen(function* () {
+    const sandcastleEnv = yield* parseEnvFile(join(repoDir, ".sandcastle", ".env"));
+    const result = {};
+    for (const key of Object.keys(sandcastleEnv)) {
+        const value = sandcastleEnv[key] || process.env[key];
+        if (value) {
+            result[key] = value;
+        }
+    }
+    return result;
+});
+//# sourceMappingURL=EnvResolver.js.map

package/dist/EnvResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnvResolver.js","sourceRoot":"","sources":["../src/EnvResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,YAAY,GAAG,CACnB,QAAgB,EACqD,EAAE,CACvE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;IACxC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,EAAE;SACtB,cAAc,CAAC,QAAQ,CAAC;SACxB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACrD,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IAChC,MAAM,IAAI,GAA2B,EAAE,CAAC;IACxC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAClD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,OAAO,KAAK,CAAC,CAAC;YAAE,SAAS;QAC7B,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAChD,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACpB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC,CAAC;AAEL;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,OAAe,EACsD,EAAE,CACvE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,aAAa,GAAG,KAAK,CAAC,CAAC,YAAY,CACvC,IAAI,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,CAAC,CACrC,CAAC;IAEF,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;QAC7C,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrD,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACtB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC,CAAC"}

package/dist/ErrorHandler.d.ts

@@ -0,0 +1,15 @@
+import { Effect } from "effect";
+import { Display } from "./Display.js";
+import type { SandboxError } from "./errors.js";
+/**
+ * Formats a tagged SandboxError into a user-friendly message with
+ * context-specific hints about what went wrong and how to recover.
+ */
+export declare const formatErrorMessage: (error: SandboxError) => string;
+/**
+ * Wraps an effect so that any SandboxError is caught, displayed via the
+ * Display service as an error-severity status message, then exits the process
+ * with code 1. Non-SandboxError errors pass through unchanged.
+ */
+export declare const withFriendlyErrors: <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A, Exclude<E, SandboxError>, R | Display>;
+//# sourceMappingURL=ErrorHandler.d.ts.map

package/dist/ErrorHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorHandler.d.ts","sourceRoot":"","sources":["../src/ErrorHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,iCAyB9B,CAAC;AASF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,4FAgBqB,CAAC"}

package/dist/ErrorHandler.js

@@ -0,0 +1,58 @@
+import { Effect } from "effect";
+import { Display } from "./Display.js";
+/**
+ * Formats a tagged SandboxError into a user-friendly message with
+ * context-specific hints about what went wrong and how to recover.
+ */
+export const formatErrorMessage = (error) => {
+    switch (error._tag) {
+        case "ExecError":
+            return `Command failed in sandbox (${error.command}): ${error.message}`;
+        case "ExecHostError":
+            return `Command failed on host (${error.command}): ${error.message}`;
+        case "CopyError":
+            return `File copy failed: ${error.message}`;
+        case "DockerError":
+            return `Docker operation failed: ${error.message}. Is Docker running?`;
+        case "SyncError":
+            return `Git sync failed: ${error.message}`;
+        case "WorktreeError":
+            return `Git worktree operation failed: ${error.message}`;
+        case "PromptError":
+            return `Failed to resolve prompt: ${error.message}`;
+        case "AgentError":
+            return `Agent invocation failed: ${error.message}`;
+        case "ConfigDirError":
+            return `${error.message}`;
+        case "InitError":
+            return `${error.message}`;
+        case "TimeoutError":
+            return `Run timed out after ${error.timeoutSeconds}s. Consider increasing the timeout with --timeout.`;
+    }
+};
+const showErrorAndExit = (error) => Effect.gen(function* () {
+    const d = yield* Display;
+    yield* d.status(formatErrorMessage(error), "error");
+    return yield* Effect.sync(() => process.exit(1));
+});
+/**
+ * Wraps an effect so that any SandboxError is caught, displayed via the
+ * Display service as an error-severity status message, then exits the process
+ * with code 1. Non-SandboxError errors pass through unchanged.
+ */
+export const withFriendlyErrors = (effect) => 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+Effect.catchTags(effect, {
+    ExecError: showErrorAndExit,
+    ExecHostError: showErrorAndExit,
+    CopyError: showErrorAndExit,
+    DockerError: showErrorAndExit,
+    SyncError: showErrorAndExit,
+    WorktreeError: showErrorAndExit,
+    PromptError: showErrorAndExit,
+    AgentError: showErrorAndExit,
+    ConfigDirError: showErrorAndExit,
+    InitError: showErrorAndExit,
+    TimeoutError: showErrorAndExit,
+});
+//# sourceMappingURL=ErrorHandler.js.map

package/dist/ErrorHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorHandler.js","sourceRoot":"","sources":["../src/ErrorHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAmB,EAAU,EAAE;IAChE,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,WAAW;YACd,OAAO,8BAA8B,KAAK,CAAC,OAAO,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;QAC1E,KAAK,eAAe;YAClB,OAAO,2BAA2B,KAAK,CAAC,OAAO,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;QACvE,KAAK,WAAW;YACd,OAAO,qBAAqB,KAAK,CAAC,OAAO,EAAE,CAAC;QAC9C,KAAK,aAAa;YAChB,OAAO,4BAA4B,KAAK,CAAC,OAAO,sBAAsB,CAAC;QACzE,KAAK,WAAW;YACd,OAAO,oBAAoB,KAAK,CAAC,OAAO,EAAE,CAAC;QAC7C,KAAK,eAAe;YAClB,OAAO,kCAAkC,KAAK,CAAC,OAAO,EAAE,CAAC;QAC3D,KAAK,aAAa;YAChB,OAAO,6BAA6B,KAAK,CAAC,OAAO,EAAE,CAAC;QACtD,KAAK,YAAY;YACf,OAAO,4BAA4B,KAAK,CAAC,OAAO,EAAE,CAAC;QACrD,KAAK,gBAAgB;YACnB,OAAO,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;QAC5B,KAAK,WAAW;YACd,OAAO,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;QAC5B,KAAK,cAAc;YACjB,OAAO,uBAAuB,KAAK,CAAC,cAAc,oDAAoD,CAAC;IAC3G,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CAAC,KAAmB,EAAE,EAAE,CAC/C,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC;IACzB,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;IACpD,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAU,CAAC,CAAC;AAC5D,CAAC,CAAC,CAAC;AAEL;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,MAA8B,EAC2B,EAAE;AAC3D,8DAA8D;AAC9D,MAAM,CAAC,SAAS,CAAC,MAA2C,EAAE;IAC5D,SAAS,EAAE,gBAAgB;IAC3B,aAAa,EAAE,gBAAgB;IAC/B,SAAS,EAAE,gBAAgB;IAC3B,WAAW,EAAE,gBAAgB;IAC7B,SAAS,EAAE,gBAAgB;IAC3B,aAAa,EAAE,gBAAgB;IAC/B,WAAW,EAAE,gBAAgB;IAC7B,UAAU,EAAE,gBAAgB;IAC5B,cAAc,EAAE,gBAAgB;IAChC,SAAS,EAAE,gBAAgB;IAC3B,YAAY,EAAE,gBAAgB;CAC/B,CAA4D,CAAC"}

package/dist/FilesystemSandbox.d.ts

@@ -0,0 +1,6 @@
+import { Layer } from "effect";
+import { Sandbox } from "./Sandbox.js";
+export declare const FilesystemSandbox: {
+    layer: (sandboxDir: string) => Layer.Layer<Sandbox, never, never>;
+};
+//# sourceMappingURL=FilesystemSandbox.d.ts.map

package/dist/FilesystemSandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FilesystemSandbox.d.ts","sourceRoot":"","sources":["../src/FilesystemSandbox.ts"],"names":[],"mappings":"AAEA,OAAO,EAAU,KAAK,EAAE,MAAM,QAAQ,CAAC;AAKvC,OAAO,EAAE,OAAO,EAAuB,MAAM,cAAc,CAAC;AA8H5D,eAAO,MAAM,iBAAiB;;CAK7B,CAAC"}