@ai-hero/sandcastle 0.0.1

package/dist/FilesystemSandbox.js

@@ -0,0 +1,83 @@
+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 makeFilesystemSandbox = (sandboxDir) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    return {
+        exec: (command, options) => Effect.async((resume) => {
+            execFile("sh", ["-c", command], { cwd: options?.cwd ?? sandboxDir }, (error, stdout, stderr) => {
+                if (error && error.code === undefined) {
+                    resume(Effect.fail(new ExecError({
+                        command,
+                        message: `Failed to exec: ${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 proc = spawn("sh", ["-c", command], {
+                cwd: options?.cwd ?? sandboxDir,
+                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: `Failed to exec: ${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* () {
+            yield* fs
+                .makeDirectory(dirname(sandboxPath), { recursive: true })
+                .pipe(Effect.mapError((error) => new CopyError({
+                message: `Failed to copy ${hostPath} -> ${sandboxPath}: ${error}`,
+            })));
+            yield* fs.copyFile(hostPath, sandboxPath).pipe(Effect.mapError((error) => new CopyError({
+                message: `Failed to copy ${hostPath} -> ${sandboxPath}: ${error}`,
+            })));
+        }),
+        copyOut: (sandboxPath, hostPath) => Effect.gen(function* () {
+            yield* fs.makeDirectory(dirname(hostPath), { recursive: true }).pipe(Effect.mapError((error) => new CopyError({
+                message: `Failed to copy ${sandboxPath} -> ${hostPath}: ${error}`,
+            })));
+            yield* fs.copyFile(sandboxPath, hostPath).pipe(Effect.mapError((error) => new CopyError({
+                message: `Failed to copy ${sandboxPath} -> ${hostPath}: ${error}`,
+            })));
+        }),
+    };
+});
+export const FilesystemSandbox = {
+    layer: (sandboxDir) => Layer.effect(Sandbox, makeFilesystemSandbox(sandboxDir)).pipe(Layer.provide(NodeFileSystem.layer)),
+};
+//# sourceMappingURL=FilesystemSandbox.js.map

package/dist/FilesystemSandbox.js.map

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

package/dist/InitService.d.ts

@@ -0,0 +1,11 @@
+import { FileSystem } from "@effect/platform";
+import { Effect } from "effect";
+import type { AgentProvider } from "./AgentProvider.js";
+export interface TemplateMetadata {
+    name: string;
+    description: string;
+}
+export declare const listTemplates: () => TemplateMetadata[];
+export declare function getNextStepsLines(template: string, provider: AgentProvider): string[];
+export declare const scaffold: (repoDir: string, provider: AgentProvider, templateName?: string) => Effect.Effect<void, Error, FileSystem.FileSystem>;
+//# sourceMappingURL=InitService.d.ts.map

package/dist/InitService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InitService.d.ts","sourceRoot":"","sources":["../src/InitService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAQxD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAuBD,eAAO,MAAM,aAAa,0BAAsC,CAAC;AAEjE,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,aAAa,GACtB,MAAM,EAAE,CAyBV;AAyDD,eAAO,MAAM,QAAQ,wHA+CjB,CAAC"}

package/dist/InitService.js

@@ -0,0 +1,111 @@
+import { FileSystem } from "@effect/platform";
+import { Effect } from "effect";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+const GITIGNORE = `.env
+patches/
+logs/
+worktrees/
+`;
+const TEMPLATES = [
+    {
+        name: "blank",
+        description: "Bare scaffold — write your own prompt and orchestration",
+    },
+    {
+        name: "simple-loop",
+        description: "Picks GitHub issues one by one and closes them",
+    },
+    {
+        name: "sequential-reviewer",
+        description: "Implements issues one by one, with a code review step after each",
+    },
+    {
+        name: "parallel-planner",
+        description: "Plans parallelizable issues, executes on separate branches, merges",
+    },
+];
+export const listTemplates = () => TEMPLATES;
+export function getNextStepsLines(template, provider) {
+    const envLines = Object.entries(provider.envManifest).map(([key, description]) => `   - ${key} — ${description}`);
+    const envStep = ["1. Set the following in .sandcastle/.env:", ...envLines];
+    if (template === "blank") {
+        return [
+            "Next steps:",
+            ...envStep,
+            "2. Read and customize .sandcastle/prompt.md to describe what you want the agent to do",
+            `3. Customize .sandcastle/main.ts — it uses the JS API (\`run()\`) to control how the agent runs`,
+            `4. Add "sandcastle": "npx tsx .sandcastle/main.ts" to your package.json scripts`,
+            "5. Run `npm run sandcastle` to start the agent",
+        ];
+    }
+    else {
+        return [
+            "Next steps:",
+            ...envStep,
+            `2. Add "sandcastle": "npx tsx .sandcastle/main.ts" to your package.json scripts`,
+            '3. Templates use `copyToSandbox: ["node_modules"]` to copy your host node_modules into the sandbox for fast startup — the `npm install` in the onSandboxReady hook is a safety net for platform-specific binaries. Adjust both if you use a different package manager',
+            "4. Read and customize the prompt files in .sandcastle/ — they shape what the agent does",
+            "5. Run `npm run sandcastle` to start the agent",
+        ];
+    }
+}
+function buildEnvExample(envManifest) {
+    return (Object.entries(envManifest)
+        .map(([key, comment]) => `# ${comment}\n${key}=`)
+        .join("\n") + "\n");
+}
+function getTemplatesDir() {
+    const thisFile = fileURLToPath(import.meta.url);
+    return join(dirname(thisFile), "templates");
+}
+const getTemplateDir = (templateName) => Effect.gen(function* () {
+    const template = TEMPLATES.find((t) => t.name === templateName);
+    if (!template) {
+        const names = TEMPLATES.map((t) => t.name).join(", ");
+        yield* Effect.fail(new Error(`Unknown template: "${templateName}". Available: ${names}`));
+    }
+    return join(getTemplatesDir(), templateName);
+});
+const copyTemplateFiles = (templateDir, destDir) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const files = yield* fs
+        .readDirectory(templateDir)
+        .pipe(Effect.mapError((e) => new Error(e.message)));
+    yield* Effect.all(files
+        .filter((f) => f !== "template.json" &&
+        !f.endsWith(".js") &&
+        !f.endsWith(".js.map") &&
+        !f.endsWith(".d.ts") &&
+        !f.endsWith(".d.ts.map"))
+        .map((f) => fs
+        .copyFile(join(templateDir, f), join(destDir, f))
+        .pipe(Effect.mapError((e) => new Error(e.message)))), { concurrency: "unbounded" });
+});
+export const scaffold = (repoDir, provider, templateName = "blank") => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const configDir = join(repoDir, ".sandcastle");
+    const exists = yield* fs
+        .exists(configDir)
+        .pipe(Effect.mapError((e) => new Error(e.message)));
+    if (exists) {
+        yield* Effect.fail(new Error(".sandcastle/ directory already exists. Remove it first if you want to re-initialize."));
+    }
+    yield* fs
+        .makeDirectory(configDir, { recursive: false })
+        .pipe(Effect.mapError((e) => new Error(e.message)));
+    const templateDir = yield* getTemplateDir(templateName);
+    yield* Effect.all([
+        fs
+            .writeFileString(join(configDir, "Dockerfile"), provider.dockerfileTemplate)
+            .pipe(Effect.mapError((e) => new Error(e.message))),
+        fs
+            .writeFileString(join(configDir, ".env.example"), buildEnvExample(provider.envManifest))
+            .pipe(Effect.mapError((e) => new Error(e.message))),
+        fs
+            .writeFileString(join(configDir, ".gitignore"), GITIGNORE)
+            .pipe(Effect.mapError((e) => new Error(e.message))),
+        copyTemplateFiles(templateDir, configDir),
+    ], { concurrency: "unbounded" });
+});
+//# sourceMappingURL=InitService.js.map

package/dist/InitService.js.map

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

package/dist/Orchestrator.d.ts

@@ -0,0 +1,49 @@
+import { Effect } from "effect";
+import { Display } from "./Display.js";
+import type { SandboxError } from "./errors.js";
+import { SandboxFactory } from "./SandboxFactory.js";
+import { type SandboxHooks } from "./SandboxLifecycle.js";
+export interface TokenUsage {
+    readonly input_tokens: number;
+    readonly output_tokens: number;
+    readonly cache_read_input_tokens: number;
+    readonly cache_creation_input_tokens: number;
+    readonly total_cost_usd: number;
+    readonly num_turns: number;
+    readonly duration_ms: number;
+}
+export declare const DEFAULT_MODEL = "claude-opus-4-6";
+/** Extract displayable text from a stream-json line */
+export declare const parseStreamJsonLine: (line: string) => {
+    type: "text";
+    text: string;
+} | {
+    type: "result";
+    result: string;
+    usage: TokenUsage | null;
+} | null;
+export interface OrchestrateOptions {
+    readonly hostRepoDir: string;
+    readonly sandboxRepoDir: string;
+    readonly iterations: number;
+    readonly hooks?: SandboxHooks;
+    readonly prompt: string;
+    readonly branch?: string;
+    readonly model?: string;
+    readonly completionSignal?: string;
+    /** Timeout in seconds. If the run exceeds this, it fails with TimeoutError. Default: 1200 (20 minutes) */
+    readonly timeoutSeconds?: number;
+    /** Optional name for the run, prepended to status messages as [name] */
+    readonly name?: string;
+}
+export interface OrchestrateResult {
+    readonly iterationsRun: number;
+    readonly wasCompletionSignalDetected: boolean;
+    readonly stdout: string;
+    readonly commits: {
+        sha: string;
+    }[];
+    readonly branch: string;
+}
+export declare const orchestrate: (options: OrchestrateOptions) => Effect.Effect<OrchestrateResult, SandboxError, Display | SandboxFactory>;
+//# sourceMappingURL=Orchestrator.d.ts.map

package/dist/Orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Orchestrator.d.ts","sourceRoot":"","sources":["../src/Orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAwB,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAEhF,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;IACzC,QAAQ,CAAC,2BAA2B,EAAE,MAAM,CAAC;IAC7C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,eAAO,MAAM,aAAa,oBAAoB,CAAC;AA6B/C,uDAAuD;AACvD,eAAO,MAAM,mBAAmB;;;;;;;QAsB/B,CAAC;AAkDF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,0GAA0G;IAC1G,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,wEAAwE;IACxE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,2BAA2B,EAAE,OAAO,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,WAAW,2GAsHvB,CAAC"}

package/dist/Orchestrator.js

@@ -0,0 +1,155 @@
+import { Duration, Effect } from "effect";
+import { Display } from "./Display.js";
+import { preprocessPrompt } from "./PromptPreprocessor.js";
+import { AgentError, TimeoutError } from "./errors.js";
+import { SandboxFactory } from "./SandboxFactory.js";
+import { withSandboxLifecycle } from "./SandboxLifecycle.js";
+export const DEFAULT_MODEL = "claude-opus-4-6";
+const extractUsage = (obj) => {
+    const usage = obj.usage;
+    if (!usage ||
+        typeof usage.input_tokens !== "number" ||
+        typeof usage.output_tokens !== "number") {
+        return null;
+    }
+    return {
+        input_tokens: usage.input_tokens,
+        output_tokens: usage.output_tokens,
+        cache_read_input_tokens: typeof usage.cache_read_input_tokens === "number"
+            ? usage.cache_read_input_tokens
+            : 0,
+        cache_creation_input_tokens: typeof usage.cache_creation_input_tokens === "number"
+            ? usage.cache_creation_input_tokens
+            : 0,
+        total_cost_usd: typeof obj.total_cost_usd === "number" ? obj.total_cost_usd : 0,
+        num_turns: typeof obj.num_turns === "number" ? obj.num_turns : 0,
+        duration_ms: typeof obj.duration_ms === "number" ? obj.duration_ms : 0,
+    };
+};
+/** Extract displayable text from a stream-json line */
+export const parseStreamJsonLine = (line) => {
+    if (!line.startsWith("{"))
+        return null;
+    try {
+        const obj = JSON.parse(line);
+        if (obj.type === "assistant" && Array.isArray(obj.message?.content)) {
+            const texts = obj.message.content
+                .filter((c) => c.type === "text")
+                .map((c) => c.text);
+            if (texts.length > 0)
+                return { type: "text", text: texts.join("") };
+        }
+        if (obj.type === "result" && typeof obj.result === "string") {
+            return { type: "result", result: obj.result, usage: extractUsage(obj) };
+        }
+    }
+    catch {
+        // Not valid JSON — skip
+    }
+    return null;
+};
+const invokeAgent = (sandbox, sandboxRepoDir, prompt, model, onText) => Effect.gen(function* () {
+    let resultText = "";
+    let tokenUsage = null;
+    const execResult = yield* sandbox.execStreaming(`claude --print --verbose --dangerously-skip-permissions --output-format stream-json --model ${model} -p ${shellEscape(prompt)}`, (line) => {
+        const parsed = parseStreamJsonLine(line);
+        if (parsed?.type === "text") {
+            onText(parsed.text);
+        }
+        else if (parsed?.type === "result") {
+            resultText = parsed.result;
+            tokenUsage = parsed.usage;
+        }
+    }, { cwd: sandboxRepoDir });
+    if (execResult.exitCode !== 0) {
+        return yield* Effect.fail(new AgentError({
+            message: `Claude exited with code ${execResult.exitCode}:\n${execResult.stderr}`,
+        }));
+    }
+    return { result: resultText || execResult.stdout, usage: tokenUsage };
+});
+const shellEscape = (s) => "'" + s.replace(/'/g, "'\\''") + "'";
+const formatNumber = (n) => n.toLocaleString("en-US");
+const formatUsageRows = (usage) => ({
+    Tokens: `${formatNumber(usage.input_tokens)} in / ${formatNumber(usage.output_tokens)} out`,
+    Turns: `${usage.num_turns}`,
+});
+const DEFAULT_COMPLETION_SIGNAL = "<promise>COMPLETE</promise>";
+const DEFAULT_TIMEOUT_SECONDS = 20 * 60; // 1200 seconds
+export const orchestrate = (options) => {
+    const timeoutSeconds = options.timeoutSeconds ?? DEFAULT_TIMEOUT_SECONDS;
+    return Effect.gen(function* () {
+        const factory = yield* SandboxFactory;
+        const display = yield* Display;
+        const { hostRepoDir, sandboxRepoDir, iterations, hooks, prompt, branch } = options;
+        const resolvedModel = options.model ?? DEFAULT_MODEL;
+        const completionSignal = options.completionSignal ?? DEFAULT_COMPLETION_SIGNAL;
+        const label = (msg) => options.name ? `[${options.name}] ${msg}` : msg;
+        const allCommits = [];
+        let allStdout = "";
+        let resolvedBranch = "";
+        for (let i = 1; i <= iterations; i++) {
+            yield* display.status(label(`Iteration ${i}/${iterations}`), "info");
+            const lifecycleResult = yield* factory.withSandbox(({ hostWorktreePath }) => withSandboxLifecycle({
+                hostRepoDir,
+                sandboxRepoDir,
+                hooks,
+                branch,
+                hostWorktreePath,
+            }, (ctx) => Effect.gen(function* () {
+                // Preprocess prompt (run !`command` expressions inside sandbox)
+                const fullPrompt = yield* preprocessPrompt(prompt, ctx.sandbox, ctx.sandboxRepoDir);
+                yield* display.status(label("Agent started"), "success");
+                // Invoke the agent
+                const onText = (text) => {
+                    Effect.runPromise(display.text(text));
+                };
+                const { result: agentOutput, usage } = yield* invokeAgent(ctx.sandbox, ctx.sandboxRepoDir, fullPrompt, resolvedModel, onText);
+                yield* display.status(label("Agent stopped"), "info");
+                // Log usage summary
+                if (usage) {
+                    yield* display.summary("Token Usage", formatUsageRows(usage));
+                }
+                // Check completion signal
+                if (agentOutput.includes(completionSignal)) {
+                    return {
+                        wasCompletionSignalDetected: true,
+                        stdout: agentOutput,
+                    };
+                }
+                return {
+                    wasCompletionSignalDetected: false,
+                    stdout: agentOutput,
+                };
+            })));
+            allCommits.push(...lifecycleResult.commits);
+            allStdout += lifecycleResult.result.stdout;
+            resolvedBranch = lifecycleResult.branch;
+            if (lifecycleResult.result.wasCompletionSignalDetected) {
+                yield* display.status(label(`Agent signaled completion after ${i} iteration(s).`), "success");
+                return {
+                    iterationsRun: i,
+                    wasCompletionSignalDetected: true,
+                    stdout: allStdout,
+                    commits: allCommits,
+                    branch: resolvedBranch,
+                };
+            }
+        }
+        yield* display.status(label(`Reached max iterations (${iterations}).`), "info");
+        return {
+            iterationsRun: iterations,
+            wasCompletionSignalDetected: false,
+            stdout: allStdout,
+            commits: allCommits,
+            branch: resolvedBranch,
+        };
+    }).pipe(Effect.timeoutFail({
+        duration: Duration.seconds(timeoutSeconds),
+        onTimeout: () => new TimeoutError({
+            message: `Run timed out after ${timeoutSeconds / 60} minutes`,
+            timeoutSeconds,
+        }),
+    }));
+};
+//# sourceMappingURL=Orchestrator.js.map

package/dist/Orchestrator.js.map

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

package/dist/PromptArgumentSubstitution.d.ts

@@ -0,0 +1,6 @@
+import { Effect } from "effect";
+import { Display } from "./Display.js";
+import { PromptError } from "./errors.js";
+export type PromptArgs = Record<string, string | number | boolean>;
+export declare const substitutePromptArgs: (prompt: string, args: PromptArgs) => Effect.Effect<string, PromptError, Display>;
+//# sourceMappingURL=PromptArgumentSubstitution.d.ts.map

package/dist/PromptArgumentSubstitution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PromptArgumentSubstitution.d.ts","sourceRoot":"","sources":["../src/PromptArgumentSubstitution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;AAInE,eAAO,MAAM,oBAAoB,mFA4ChC,CAAC"}

package/dist/PromptArgumentSubstitution.js

@@ -0,0 +1,33 @@
+import { Effect } from "effect";
+import { Display } from "./Display.js";
+import { PromptError } from "./errors.js";
+const PLACEHOLDER_PATTERN = /\{\{([A-Za-z_][A-Za-z0-9_]*)\}\}/g;
+export const substitutePromptArgs = (prompt, args) => {
+    const matches = [...prompt.matchAll(PLACEHOLDER_PATTERN)];
+    if (matches.length === 0 && Object.keys(args).length === 0) {
+        return Effect.succeed(prompt);
+    }
+    return Effect.gen(function* () {
+        const display = yield* Display;
+        // Collect all keys referenced in the prompt
+        const referencedKeys = new Set(matches.map((m) => m[1]));
+        // Check for missing keys (placeholder in prompt but no matching arg)
+        for (const key of referencedKeys) {
+            if (!(key in args)) {
+                return yield* Effect.fail(new PromptError({
+                    message: `Prompt argument "{{${key}}}" has no matching value in promptArgs`,
+                }));
+            }
+        }
+        // Warn about unused keys (arg provided but no matching placeholder)
+        for (const key of Object.keys(args)) {
+            if (!referencedKeys.has(key)) {
+                yield* display.status(`Prompt argument "${key}" was provided but not referenced in the prompt`, "warn");
+            }
+        }
+        // Replace all placeholders with their values
+        const result = prompt.replace(PLACEHOLDER_PATTERN, (_match, key) => args[key].toString());
+        return result;
+    });
+};
+//# sourceMappingURL=PromptArgumentSubstitution.js.map

package/dist/PromptArgumentSubstitution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PromptArgumentSubstitution.js","sourceRoot":"","sources":["../src/PromptArgumentSubstitution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI1C,MAAM,mBAAmB,GAAG,mCAAmC,CAAC;AAEhE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,MAAc,EACd,IAAgB,EAC6B,EAAE;IAC/C,MAAM,OAAO,GAAG,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC,CAAC;IAE1D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3D,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAED,OAAO,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QACzB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC;QAE/B,4CAA4C;QAC5C,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC;QAE1D,qEAAqE;QACrE,KAAK,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;YACjC,IAAI,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC;gBACnB,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CACvB,IAAI,WAAW,CAAC;oBACd,OAAO,EAAE,sBAAsB,GAAG,yCAAyC;iBAC5E,CAAC,CACH,CAAC;YACJ,CAAC;QACH,CAAC;QAED,oEAAoE;QACpE,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC7B,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,CACnB,oBAAoB,GAAG,iDAAiD,EACxE,MAAM,CACP,CAAC;YACJ,CAAC;QACH,CAAC;QAED,6CAA6C;QAC7C,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,mBAAmB,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,CACjE,IAAI,CAAC,GAAa,CAAE,CAAC,QAAQ,EAAE,CAChC,CAAC;QAEF,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/PromptPreprocessor.d.ts

@@ -0,0 +1,7 @@
+import { Effect } from "effect";
+import { Display } from "./Display.js";
+import { PromptError } from "./errors.js";
+import type { ExecError } from "./errors.js";
+import type { SandboxService } from "./SandboxFactory.js";
+export declare const preprocessPrompt: (prompt: string, sandbox: SandboxService, cwd: string) => Effect.Effect<string, ExecError | PromptError, Display>;
+//# sourceMappingURL=PromptPreprocessor.d.ts.map

package/dist/PromptPreprocessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PromptPreprocessor.d.ts","sourceRoot":"","sources":["../src/PromptPreprocessor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,eAAO,MAAM,gBAAgB,mHAuC5B,CAAC"}

package/dist/PromptPreprocessor.js

@@ -0,0 +1,34 @@
+import { Effect } from "effect";
+import { Display } from "./Display.js";
+import { PromptError } from "./errors.js";
+export const preprocessPrompt = (prompt, sandbox, cwd) => {
+    const pattern = /!`([^`]+)`/g;
+    const matches = [...prompt.matchAll(pattern)];
+    if (matches.length === 0) {
+        return Effect.succeed(prompt);
+    }
+    return Effect.gen(function* () {
+        const display = yield* Display;
+        return yield* display.taskLog("Expanding shell expressions", (message) => Effect.gen(function* () {
+            let result = prompt;
+            // Process matches in reverse order to preserve indices
+            for (const match of [...matches].reverse()) {
+                const command = match[1];
+                const index = match.index;
+                message(command);
+                const execResult = yield* sandbox.exec(command, { cwd });
+                if (execResult.exitCode !== 0) {
+                    return yield* Effect.fail(new PromptError({
+                        message: `Command \`${command}\` exited with code ${execResult.exitCode}: ${execResult.stderr}`,
+                    }));
+                }
+                result =
+                    result.slice(0, index) +
+                        execResult.stdout.trimEnd() +
+                        result.slice(index + match[0].length);
+            }
+            return result;
+        }));
+    });
+};
+//# sourceMappingURL=PromptPreprocessor.js.map

package/dist/PromptPreprocessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PromptPreprocessor.js","sourceRoot":"","sources":["../src/PromptPreprocessor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI1C,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,MAAc,EACd,OAAuB,EACvB,GAAW,EAC8C,EAAE;IAC3D,MAAM,OAAO,GAAG,aAAa,CAAC;IAC9B,MAAM,OAAO,GAAG,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IAE9C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAED,OAAO,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QACzB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC;QAC/B,OAAO,KAAK,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,6BAA6B,EAAE,CAAC,OAAO,EAAE,EAAE,CACvE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YAClB,IAAI,MAAM,GAAG,MAAM,CAAC;YACpB,uDAAuD;YACvD,KAAK,MAAM,KAAK,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;gBAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;gBAC1B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAM,CAAC;gBAC3B,OAAO,CAAC,OAAO,CAAC,CAAC;gBACjB,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;gBACzD,IAAI,UAAU,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;oBAC9B,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CACvB,IAAI,WAAW,CAAC;wBACd,OAAO,EAAE,aAAa,OAAO,uBAAuB,UAAU,CAAC,QAAQ,KAAK,UAAU,CAAC,MAAM,EAAE;qBAChG,CAAC,CACH,CAAC;gBACJ,CAAC;gBACD,MAAM;oBACJ,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;wBACtB,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE;wBAC3B,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YAC1C,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC,CACH,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/PromptResolver.d.ts

@@ -0,0 +1,9 @@
+import { FileSystem } from "@effect/platform";
+import { Effect } from "effect";
+import { PromptError } from "./errors.js";
+export interface ResolvePromptOptions {
+    readonly prompt?: string;
+    readonly promptFile?: string;
+}
+export declare const resolvePrompt: (options: ResolvePromptOptions) => Effect.Effect<string, PromptError, FileSystem.FileSystem>;
+//# sourceMappingURL=PromptResolver.d.ts.map

package/dist/PromptResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PromptResolver.d.ts","sourceRoot":"","sources":["../src/PromptResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,eAAO,MAAM,aAAa,8FAsCzB,CAAC"}

package/dist/PromptResolver.js

@@ -0,0 +1,26 @@
+import { FileSystem } from "@effect/platform";
+import { Effect } from "effect";
+import { PromptError } from "./errors.js";
+export const resolvePrompt = (options) => {
+    const { prompt, promptFile } = options;
+    if (prompt !== undefined && promptFile !== undefined) {
+        return Effect.fail(new PromptError({
+            message: "Cannot provide both --prompt and --prompt-file",
+        }));
+    }
+    if (prompt !== undefined) {
+        return Effect.succeed(prompt);
+    }
+    if (promptFile === undefined) {
+        return Effect.fail(new PromptError({
+            message: "Must provide either prompt or promptFile. Pass prompt: '...' or promptFile: './.sandcastle/prompt.md' to run().",
+        }));
+    }
+    return Effect.gen(function* () {
+        const fs = yield* FileSystem.FileSystem;
+        return yield* fs.readFileString(promptFile).pipe(Effect.catchAll((e) => Effect.fail(new PromptError({
+            message: `Failed to read prompt from ${promptFile}: ${e}`,
+        }))));
+    });
+};
+//# sourceMappingURL=PromptResolver.js.map

package/dist/PromptResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PromptResolver.js","sourceRoot":"","sources":["../src/PromptResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAO1C,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,OAA6B,EAC8B,EAAE;IAC7D,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IAEvC,IAAI,MAAM,KAAK,SAAS,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QACrD,OAAO,MAAM,CAAC,IAAI,CAChB,IAAI,WAAW,CAAC;YACd,OAAO,EAAE,gDAAgD;SAC1D,CAAC,CACH,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAED,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,MAAM,CAAC,IAAI,CAChB,IAAI,WAAW,CAAC;YACd,OAAO,EACL,iHAAiH;SACpH,CAAC,CACH,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QACzB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;QACxC,OAAO,KAAK,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,IAAI,CAC9C,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CACpB,MAAM,CAAC,IAAI,CACT,IAAI,WAAW,CAAC;YACd,OAAO,EAAE,8BAA8B,UAAU,KAAK,CAAC,EAAE;SAC1D,CAAC,CACH,CACF,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/RecoveryMessage.d.ts

@@ -0,0 +1,15 @@
+export type FailedStep = "commits" | "diff" | "untracked";
+export interface RecoveryInput {
+    readonly patchDir: string;
+    readonly failedStep: FailedStep;
+    readonly hasCommits: boolean;
+    readonly hasDiff: boolean;
+    readonly hasUntracked: boolean;
+    readonly branch?: string;
+}
+/**
+ * Build copy-pastable recovery commands for a failed sync-out.
+ * Pure function: takes failure state, returns formatted terminal output.
+ */
+export declare const buildRecoveryMessage: (input: RecoveryInput) => string;
+//# sourceMappingURL=RecoveryMessage.d.ts.map

package/dist/RecoveryMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecoveryMessage.d.ts","sourceRoot":"","sources":["../src/RecoveryMessage.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,WAAW,CAAC;AAE1D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB,kCAmEhC,CAAC"}