@ai-hero/sandcastle 0.6.5 → 0.7.0

package/dist/resumePrecheck.js

@@ -1,40 +0,0 @@
-/**
- * Fail-fast validation that a resumable agent session exists on the host before
- * launching the agent. Throws a descriptive error when the session is missing.
- *
- * The lookup strategy depends on the sandbox:
- *
- * - **No-sandbox**: the agent runs directly on the host and writes its session
- *   in place under a cwd-derived directory; Sandcastle never moves it. The
- *   agent's own path encoding (realpath canonicalisation plus
- *   non-alphanumeric → hyphen) is fragile and platform-specific to reconstruct,
- *   so we locate the file by its globally-unique session id instead.
- * - **Sandboxed (bind-mount)**: Sandcastle's capture transfers the session into
- *   the host store keyed on the host repo dir, so for a resumable run the file
- *   lives at that exact encoded location — check it directly rather than
- *   scanning. (Isolated sandboxes fall here too, but neither capture nor resume
- *   transfer is wired for them today, so this is the host-repo-dir check by
- *   default.)
- */
-export const assertResumeSessionExists = async (params) => {
-    const { provider, sandboxTag, hostRepoDir, resumeSession } = params;
-    if (!provider.sessionStorage) {
-        throw new Error(`${provider.name} does not support resumeSession`);
-    }
-    if (sandboxTag === "none") {
-        const found = await provider.sessionStorage.findByIdOnHost(resumeSession);
-        if (!found.path) {
-            throw new Error(`resumeSession "${resumeSession}" not found under ${found.searchedRoot}`);
-        }
-        return;
-    }
-    const hostStore = provider.sessionStorage.hostStore(hostRepoDir);
-    const exists = await hostStore.exists(resumeSession);
-    if (!exists) {
-        const sessionPath = hostStore.sessionFilePath(resumeSession);
-        throw new Error(sessionPath
-            ? `resumeSession "${resumeSession}" not found: expected session file at ${sessionPath}`
-            : `resumeSession "${resumeSession}" not found`);
-    }
-};
-//# sourceMappingURL=resumePrecheck.js.map

package/dist/resumePrecheck.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"resumePrecheck.js","sourceRoot":"","sources":["../src/resumePrecheck.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,KAAK,EAAE,MAK/C,EAAiB,EAAE;IAClB,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,GAAG,MAAM,CAAC;IAEpE,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,GAAG,QAAQ,CAAC,IAAI,iCAAiC,CAAC,CAAC;IACrE,CAAC;IAED,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,cAAc,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC;QAC1E,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACb,kBAAkB,aAAa,qBAAqB,KAAK,CAAC,YAAY,EAAE,CACzE,CAAC;QACJ,CAAC;QACD,OAAO;IACT,CAAC;IAED,MAAM,SAAS,GAAG,QAAQ,CAAC,cAAc,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IACjE,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IACrD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,WAAW,GAAG,SAAS,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC;QAC7D,MAAM,IAAI,KAAK,CACb,WAAW;YACT,CAAC,CAAC,kBAAkB,aAAa,yCAAyC,WAAW,EAAE;YACvF,CAAC,CAAC,kBAAkB,aAAa,aAAa,CACjD,CAAC;IACJ,CAAC;AACH,CAAC,CAAC"}

package/dist/run.d.ts

@@ -1,216 +0,0 @@
-import type { AgentProvider } from "./AgentProvider.js";
-import { type Severity } from "./Display.js";
-import { type IterationResult, type IterationUsage } from "./Orchestrator.js";
-import type { SandboxProvider, BranchStrategy } from "./SandboxProvider.js";
-import { type AgentStreamEvent } from "./AgentStreamEmitter.js";
-import type { SandboxHooks } from "./SandboxLifecycle.js";
-import { type PromptArgs } from "./PromptArgumentSubstitution.js";
-import type { OutputDefinition, OutputObjectDefinition, OutputStringDefinition } from "./Output.js";
-/** Default maximum number of iterations for a run. */
-export declare const DEFAULT_MAX_ITERATIONS = 1;
-/** Replace characters that are invalid or problematic in file paths with dashes. */
-export declare const sanitizeBranchForFilename: (branch: string) => string;
-export interface FileDisplayStartupOptions {
-    readonly logPath: string;
-    readonly agentName?: string;
-    readonly branch?: string;
-    /** Resolved host repo directory. When it differs from `process.cwd()`, the
-     *  log-file hint is printed as an absolute path so it can be pasted into any
-     *  terminal. When it equals `process.cwd()` (or is omitted), a relative path
-     *  is printed instead. */
-    readonly hostRepoDir?: string;
-}
-/**
- * Print the startup message to the terminal when using file-based logging.
- * Uses styleText for lightweight bold/dim styling — does not use Clack.
- */
-export declare const printFileDisplayStartup: (options: FileDisplayStartupOptions) => void;
-/**
- * Build the log filename for a run.
- * When a targetBranch is provided (temp branch mode), prefixes the filename
- * with the sanitized target branch name so developers can identify which
- * branch the run was targeting: `<targetBranch>-<resolvedBranch>.log`
- * When no targetBranch, uses just the resolved branch: `<resolvedBranch>.log`
- * When a name is provided, appends it to avoid collisions in multi-agent workflows.
- */
-export declare const buildLogFilename: (resolvedBranch: string, targetBranch?: string | undefined, name?: string | undefined) => string;
-export interface RunSummaryRowsOptions {
-    readonly name?: string;
-    readonly agentName: string;
-    readonly sandboxName: string;
-    readonly maxIterations: number;
-    readonly branch: string;
-}
-/**
- * Build the summary rows for a run, used in both terminal mode and
- * log-to-file mode. When a custom name is provided it appears as the
- * Agent value instead of the internal provider name.
- */
-export declare const buildRunSummaryRows: (options: RunSummaryRowsOptions) => Record<string, string>;
-/**
- * Build the completion status message for a run, used in both terminal mode
- * and log-to-file mode to record the final outcome.
- */
-export declare const buildCompletionMessage: (completionSignal: string | undefined, iterationsRun: number) => {
-    readonly message: string;
-    readonly severity: Severity;
-};
-/**
- * Format the context window size from an iteration's usage data.
- * Returns a string like "103k" representing the total input-side tokens
- * (inputTokens + cacheCreationInputTokens + cacheReadInputTokens)
- * rounded up to the nearest 1000.
- */
-export declare const formatContextWindowSize: (usage: IterationUsage) => string;
-/**
- * Build "Context window: NNNk" lines for iterations that have usage data.
- * Returns an empty array when no iterations carry usage.
- */
-export declare const buildContextWindowLines: (iterations: readonly Pick<IterationResult, "usage">[]) => string[];
-/**
- * Controls where Sandcastle writes iteration progress and agent output.
- * Use `"file"` (log-to-file mode) to write to a log file on disk, or
- * `"stdout"` (terminal mode) to render an interactive UI in the terminal.
- */
-export type LoggingOption = 
-/** Write progress and agent output to a log file at the given path (log-to-file mode). */
-{
-    readonly type: "file";
-    readonly path: string;
-    /**
-     * Optional callback invoked for each agent stream event (text chunk or
-     * tool call) in addition to being written to the log file. Intended for
-     * forwarding the agent's output stream to external observability
-     * systems. Errors thrown by the callback are swallowed.
-     */
-    readonly onAgentStreamEvent?: (event: AgentStreamEvent) => void;
-}
-/** Render progress and agent output as an interactive UI in the terminal (terminal mode). */
- | {
-    readonly type: "stdout";
-};
-/** Override default timeouts for built-in lifecycle steps. Unset keys keep their defaults. */
-export interface Timeouts {
-    /** Timeout (ms) for the host-side copy of `copyToWorktree` paths into the worktree. Default: 60_000. */
-    readonly copyToWorktreeMs?: number;
-    /** Timeout (ms) for each in-sandbox git setup command (safe.directory, user.name/email, branch discovery). Default: 10_000. */
-    readonly gitSetupMs?: number;
-    /** Timeout (ms) for collecting the commits produced during the run. Default: 30_000. */
-    readonly commitCollectionMs?: number;
-    /** Timeout (ms) for merging the temp branch back to the host branch (merge-to-head strategy). Default: 30_000. */
-    readonly mergeToHostMs?: number;
-}
-export interface RunOptions<A extends AgentProvider = AgentProvider> {
-    /** Agent provider to use (e.g. claudeCode("claude-opus-4-7")) */
-    readonly agent: A;
-    /** Sandbox provider (e.g. docker({ imageName: "sandcastle:myrepo" })). */
-    readonly sandbox: SandboxProvider;
-    /**
-     * Host repo directory. Replaces `process.cwd()` as the anchor for
-     * `.sandcastle/worktrees/`, `.sandcastle/.env`, `.sandcastle/logs/`,
-     * `.sandcastle/patches/`, and git operations.
-     *
-     * - Relative paths are resolved against `process.cwd()`.
-     * - Absolute paths are used as-is.
-     * - Defaults to `process.cwd()` when omitted.
-     */
-    readonly cwd?: string;
-    /** Inline prompt string (mutually exclusive with promptFile) */
-    readonly prompt?: string;
-    /**
-     * Path to a prompt file (mutually exclusive with prompt).
-     *
-     * **Note:** `promptFile` is always resolved against `process.cwd()`, not
-     * against the `cwd` option. If you set a custom `cwd`, pass an absolute
-     * `promptFile` to avoid ambiguity.
-     */
-    readonly promptFile?: string;
-    /** Maximum iterations to run (default: 1) */
-    readonly maxIterations?: number;
-    /** Lifecycle hooks grouped by execution location (host or sandbox). */
-    readonly hooks?: SandboxHooks;
-    /** Key-value map for {{KEY}} placeholder substitution in prompts */
-    readonly promptArgs?: PromptArgs;
-    /** Logging mode (default: { type: 'file' } with auto-generated path under .sandcastle/logs/) */
-    readonly logging?: LoggingOption;
-    /** Substring(s) the agent emits to stop the iteration loop early. Matched via `includes` against agent output. (default: `"<promise>COMPLETE</promise>"`) */
-    readonly completionSignal?: string | string[];
-    /** Idle timeout in seconds. If the agent produces no output for this long, it fails. Default: 600 (10 minutes) */
-    readonly idleTimeoutSeconds?: number;
-    /** Optional name for the run, shown as a prefix in log output */
-    readonly name?: string;
-    /** Paths relative to the host repo root to copy into the worktree before sandbox start. */
-    readonly copyToWorktree?: string[];
-    /** Branch strategy — controls how the agent's changes relate to branches.
-     * Defaults to { type: "head" } for bind-mount providers and { type: "merge-to-head" } for isolated providers. */
-    readonly branchStrategy?: BranchStrategy;
-    /** Resume a prior Claude Code session by ID. The session JSONL must exist on the host. Incompatible with maxIterations > 1. */
-    readonly resumeSession?: string;
-    /**
-     * An `AbortSignal` that cancels the run when aborted.
-     *
-     * - If `signal.aborted` is already `true` at entry, `run()` rejects
-     *   immediately without doing any setup work.
-     * - Aborting mid-iteration kills the in-flight agent subprocess.
-     * - Phase boundaries (between iterations) also check the signal.
-     * - The rejected promise surfaces `signal.reason` via
-     *   `signal.throwIfAborted()` — no Sandcastle-specific wrapping.
-     * - The worktree is preserved on disk after abort (error-path behavior).
-     */
-    readonly signal?: AbortSignal;
-    /** Override default timeouts for built-in lifecycle steps. Unset keys keep their defaults. */
-    readonly timeouts?: Timeouts;
-    /**
-     * Structured output definition. When provided, the agent's stdout is
-     * scanned for the configured XML tag after the iteration completes, and the
-     * result is parsed/validated and returned on `RunResult.output`.
-     *
-     * Use `Output.object({ tag, schema })` for JSON+schema or
-     * `Output.string({ tag })` for raw string extraction.
-     *
-     * Constraints:
-     * - `maxIterations` must be `1` (the default).
-     * - The resolved prompt must contain the configured opening tag literal.
-     *
-     * See ADR 0010 for design rationale.
-     */
-    readonly output?: OutputDefinition;
-}
-export type { IterationResult, IterationUsage } from "./Orchestrator.js";
-export type ResumeRunResultOptions = Omit<RunOptions, "agent" | "sandbox" | "prompt" | "promptFile" | "resumeSession" | "maxIterations">;
-export interface RunResult {
-    /** Per-iteration results (use `iterations.length` for the count). */
-    readonly iterations: IterationResult[];
-    /** The matched completion signal string, or undefined if no signal fired before the iteration limit. */
-    readonly completionSignal?: string;
-    /** Combined stdout output from all agent iterations. */
-    readonly stdout: string;
-    /** List of commits made by the agent during the run, each identified by its SHA. */
-    readonly commits: {
-        sha: string;
-    }[];
-    /** The branch name the agent worked on inside the sandbox. */
-    readonly branch: string;
-    /** Path to the log file, if logging was drained to a file. */
-    readonly logFilePath?: string;
-    /** Host path to the preserved worktree, set when the run succeeded but the worktree had uncommitted changes. */
-    readonly preservedWorktreePath?: string;
-    /** Continue the last captured agent session for exactly one iteration.
-     *  Present only when the provider supports resume (`sessionStorage` populated). */
-    readonly resume?: (prompt: string, options?: ResumeRunResultOptions) => Promise<RunResult>;
-}
-/** Overload: with `Output.object`, returns `RunResult` with typed `output: T`. */
-export declare function run<T, A extends AgentProvider>(options: RunOptions<A> & {
-    output: OutputObjectDefinition<T>;
-}): Promise<RunResult & {
-    output: T;
-}>;
-/** Overload: with `Output.string`, returns `RunResult` with `output: string`. */
-export declare function run<A extends AgentProvider>(options: RunOptions<A> & {
-    output: OutputStringDefinition;
-}): Promise<RunResult & {
-    output: string;
-}>;
-/** Overload: without `output`, returns the standard `RunResult`. */
-export declare function run<A extends AgentProvider>(options: RunOptions<A>): Promise<RunResult>;
-//# sourceMappingURL=run.d.ts.map

package/dist/run.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAIL,KAAK,QAAQ,EACd,MAAM,cAAc,CAAC;AACtB,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,cAAc,EAEpB,MAAM,mBAAmB,CAAC;AAM3B,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAI5E,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1D,OAAO,EACL,KAAK,UAAU,EAKhB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EACV,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB,EACvB,MAAM,aAAa,CAAC;AAGrB,sDAAsD;AACtD,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC,oFAAoF;AACpF,eAAO,MAAM,yBAAyB,4BACA,CAAC;AAEvC,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB;;;8BAG0B;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;GAGG;AACH,eAAO,MAAM,uBAAuB,8CAanC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,kGAa5B,CAAC;AAEF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,4DAO9B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;CAclC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,mCAMnC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,qEAKoC,CAAC;AAEzE;;;;GAIG;AACH,MAAM,MAAM,aAAa;AACvB,0FAA0F;AACxF;IACE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;CACjE;AACH,6FAA6F;GAC3F;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEhC,8FAA8F;AAC9F,MAAM,WAAW,QAAQ;IACvB,wGAAwG;IACxG,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,+HAA+H;IAC/H,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,wFAAwF;IACxF,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,kHAAkH;IAClH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,UAAU,CAAC,CAAC,SAAS,aAAa,GAAG,aAAa;IACjE,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAClB,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC;;;;;;;;OAQG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,6CAA6C;IAC7C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,uEAAuE;IACvE,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;IAC9B,oEAAoE;IACpE,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC,gGAAgG;IAChG,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;IACjC,6JAA6J;IAC7J,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC9C,kHAAkH;IAClH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,iEAAiE;IACjE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,2FAA2F;IAC3F,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IACnC;qHACiH;IACjH,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;IACzC,+HAA+H;IAC/H,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,8FAA8F;IAC9F,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC7B;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC;CACpC;AAED,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEzE,MAAM,MAAM,sBAAsB,GAAG,IAAI,CACvC,UAAU,EACR,OAAO,GACP,SAAS,GACT,QAAQ,GACR,YAAY,GACZ,eAAe,GACf,eAAe,CAClB,CAAC;AAEF,MAAM,WAAW,SAAS;IACxB,qEAAqE;IACrE,QAAQ,CAAC,UAAU,EAAE,eAAe,EAAE,CAAC;IACvC,wGAAwG;IACxG,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,wDAAwD;IACxD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,oFAAoF;IACpF,QAAQ,CAAC,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACpC,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,8DAA8D;IAC9D,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,gHAAgH;IAChH,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IACxC;uFACmF;IACnF,QAAQ,CAAC,MAAM,CAAC,EAAE,CAChB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,sBAAsB,KAC7B,OAAO,CAAC,SAAS,CAAC,CAAC;CACzB;AAED,kFAAkF;AAClF,wBAAgB,GAAG,CAAC,CAAC,EAAE,CAAC,SAAS,aAAa,EAC5C,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG;IAAE,MAAM,EAAE,sBAAsB,CAAC,CAAC,CAAC,CAAA;CAAE,GAC7D,OAAO,CAAC,SAAS,GAAG;IAAE,MAAM,EAAE,CAAC,CAAA;CAAE,CAAC,CAAC;AACtC,iFAAiF;AACjF,wBAAgB,GAAG,CAAC,CAAC,SAAS,aAAa,EACzC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG;IAAE,MAAM,EAAE,sBAAsB,CAAA;CAAE,GAC1D,OAAO,CAAC,SAAS,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAC3C,oEAAoE;AACpE,wBAAgB,GAAG,CAAC,CAAC,SAAS,aAAa,EACzC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,GACrB,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/run.js

@@ -1,313 +0,0 @@
-import { NodeContext, NodeFileSystem } from "@effect/platform-node";
-import path, { join } from "node:path";
-import { styleText } from "node:util";
-import { Effect, Layer } from "effect";
-import { resolveCwd } from "./resolveCwd.js";
-import { assertResumeSessionExists } from "./resumePrecheck.js";
-import { ClackDisplay, Display, FileDisplay, } from "./Display.js";
-import { orchestrate, } from "./Orchestrator.js";
-import { resolvePrompt } from "./PromptResolver.js";
-import { WorktreeDockerSandboxFactory, SandboxConfig, } from "./SandboxFactory.js";
-import { resolveEnv } from "./EnvResolver.js";
-import { formatErrorMessage } from "./ErrorHandler.js";
-import { callbackAgentStreamEmitterLayer, noopAgentStreamEmitterLayer, } from "./AgentStreamEmitter.js";
-import { mergeProviderEnv } from "./mergeProviderEnv.js";
-import { generateTempBranchName, getCurrentBranch } from "./WorktreeManager.js";
-import { substitutePromptArgs, validateNoArgsWithInlinePrompt, validateNoBuiltInArgOverride, BUILT_IN_PROMPT_ARG_KEYS, } from "./PromptArgumentSubstitution.js";
-import { extractStructuredOutput } from "./extractStructuredOutput.js";
-/** Default maximum number of iterations for a run. */
-export const DEFAULT_MAX_ITERATIONS = 1;
-/** Replace characters that are invalid or problematic in file paths with dashes. */
-export const sanitizeBranchForFilename = (branch) => branch.replace(/[/\\:*?"<>|]/g, "-");
-/**
- * Print the startup message to the terminal when using file-based logging.
- * Uses styleText for lightweight bold/dim styling — does not use Clack.
- */
-export const printFileDisplayStartup = (options) => {
-    const name = options.agentName ?? "Agent";
-    const label = styleText("bold", `[${name}]`);
-    const branchPart = options.branch ? ` on branch ${options.branch}` : "";
-    const hostRepoDir = options.hostRepoDir ?? process.cwd();
-    const displayLogPath = hostRepoDir === process.cwd()
-        ? path.relative(process.cwd(), options.logPath)
-        : options.logPath;
-    console.log(`${label} Started${branchPart}`);
-    console.log(styleText("dim", `  tail -f ${displayLogPath}`));
-};
-/**
- * Build the log filename for a run.
- * When a targetBranch is provided (temp branch mode), prefixes the filename
- * with the sanitized target branch name so developers can identify which
- * branch the run was targeting: `<targetBranch>-<resolvedBranch>.log`
- * When no targetBranch, uses just the resolved branch: `<resolvedBranch>.log`
- * When a name is provided, appends it to avoid collisions in multi-agent workflows.
- */
-export const buildLogFilename = (resolvedBranch, targetBranch, name) => {
-    const sanitized = sanitizeBranchForFilename(resolvedBranch);
-    const nameSuffix = name
-        ? `-${name.toLowerCase().replace(/[^a-z0-9_.-]/g, "-")}`
-        : "";
-    if (targetBranch) {
-        return `${sanitizeBranchForFilename(targetBranch)}-${sanitized}${nameSuffix}.log`;
-    }
-    return `${sanitized}${nameSuffix}.log`;
-};
-/**
- * Build the summary rows for a run, used in both terminal mode and
- * log-to-file mode. When a custom name is provided it appears as the
- * Agent value instead of the internal provider name.
- */
-export const buildRunSummaryRows = (options) => ({
-    Agent: options.name ?? options.agentName,
-    Sandbox: options.sandboxName,
-    "Max iterations": String(options.maxIterations),
-    Branch: options.branch,
-});
-/**
- * Build the completion status message for a run, used in both terminal mode
- * and log-to-file mode to record the final outcome.
- */
-export const buildCompletionMessage = (completionSignal, iterationsRun) => {
-    if (completionSignal !== undefined) {
-        return {
-            message: `Run complete: agent finished after ${iterationsRun} iteration(s).`,
-            severity: "success",
-        };
-    }
-    return {
-        message: `Run complete: reached ${iterationsRun} iteration(s) without completion signal.`,
-        severity: "warn",
-    };
-};
-/**
- * Format the context window size from an iteration's usage data.
- * Returns a string like "103k" representing the total input-side tokens
- * (inputTokens + cacheCreationInputTokens + cacheReadInputTokens)
- * rounded up to the nearest 1000.
- */
-export const formatContextWindowSize = (usage) => {
-    const total = usage.inputTokens +
-        usage.cacheCreationInputTokens +
-        usage.cacheReadInputTokens;
-    return `${Math.ceil(total / 1000)}k`;
-};
-/**
- * Build "Context window: NNNk" lines for iterations that have usage data.
- * Returns an empty array when no iterations carry usage.
- */
-export const buildContextWindowLines = (iterations) => iterations
-    .filter((it) => it.usage !== undefined)
-    .map((it) => `Context window: ${formatContextWindowSize(it.usage)}`);
-export async function run(options) {
-    // If signal is already aborted, reject immediately without any setup
-    options.signal?.throwIfAborted();
-    const { prompt, promptFile, maxIterations = DEFAULT_MAX_ITERATIONS, hooks, agent: provider, } = options;
-    // Derive branch strategy: explicit option > default based on provider tag
-    const branchStrategy = options.branchStrategy ??
-        (options.sandbox.tag === "isolated"
-            ? { type: "merge-to-head" }
-            : { type: "head" });
-    const effectiveBranchType = branchStrategy.type;
-    // Validate: head strategy is not supported with isolated providers
-    if (effectiveBranchType === "head" && options.sandbox.tag === "isolated") {
-        throw new Error("head branch strategy is not supported with isolated providers");
-    }
-    // Validate: copyToWorktree is incompatible with head strategy
-    if (effectiveBranchType === "head" &&
-        options.copyToWorktree &&
-        options.copyToWorktree.length > 0) {
-        throw new Error("copyToWorktree is not supported with head branch strategy. " +
-            "In head mode the host working directory is bind-mounted directly.");
-    }
-    // Validate: resumeSession + maxIterations > 1 is not allowed
-    if (options.resumeSession && maxIterations > 1) {
-        throw new Error("resumeSession cannot be combined with maxIterations > 1. " +
-            "Resume applies to iteration 1 only; multi-iteration resume semantics are not supported.");
-    }
-    // Validate: output requires maxIterations === 1
-    if (options.output && maxIterations !== 1) {
-        throw new Error("output requires maxIterations to be 1. " +
-            "Structured output is only supported for single-iteration runs.");
-    }
-    // Extract explicit branch when in branch mode
-    const branch = branchStrategy.type === "branch" ? branchStrategy.branch : undefined;
-    const hostRepoDir = await Effect.runPromise(resolveCwd(options.cwd).pipe(Effect.provide(NodeContext.layer)));
-    // Validate: resumeSession file must exist on the host
-    if (options.resumeSession) {
-        await assertResumeSessionExists({
-            provider,
-            sandboxTag: options.sandbox.tag,
-            hostRepoDir,
-            resumeSession: options.resumeSession,
-        });
-    }
-    // Resolve prompt
-    const resolved = await Effect.runPromise(resolvePrompt({ prompt, promptFile }).pipe(Effect.provide(NodeContext.layer)));
-    const rawPrompt = resolved.text;
-    const isInlinePrompt = resolved.source === "inline";
-    // Validate: output tag must appear in the resolved prompt
-    if (options.output) {
-        const openTag = `<${options.output.tag}>`;
-        if (!rawPrompt.includes(openTag)) {
-            throw new Error(`output tag <${options.output.tag}> not found in the resolved prompt. ` +
-                "The caller must instruct the agent to emit the configured tag.");
-        }
-    }
-    const agentName = provider.name;
-    // Resolve env vars and merge with provider env
-    const resolvedEnv = await Effect.runPromise(resolveEnv(hostRepoDir).pipe(Effect.provide(NodeContext.layer)));
-    const env = mergeProviderEnv({
-        resolvedEnv,
-        agentProviderEnv: provider.env,
-        sandboxProviderEnv: options.sandbox.env,
-    });
-    // Always capture the host's current branch for the TARGET_BRANCH built-in
-    // prompt argument. When using a temp branch, it also prefixes the log filename.
-    const currentHostBranch = await Effect.runPromise(getCurrentBranch(hostRepoDir));
-    // When in merge-to-head mode, generate a temporary branch name.
-    // In head mode, use the host's current branch directly (no worktree).
-    const resolvedBranch = effectiveBranchType === "head"
-        ? currentHostBranch
-        : (branch ?? generateTempBranchName(options.name));
-    // When using a temp branch, prefix the log filename with the target branch
-    // (the host's current branch) so developers can tell which branch was targeted.
-    const targetBranch = effectiveBranchType === "merge-to-head" ? currentHostBranch : undefined;
-    // Resolve logging option
-    const resolvedLogging = options.logging ?? {
-        type: "file",
-        path: join(hostRepoDir, ".sandcastle", "logs", buildLogFilename(resolvedBranch, targetBranch, options.name)),
-    };
-    const displayLayer = resolvedLogging.type === "file"
-        ? (() => {
-            printFileDisplayStartup({
-                logPath: resolvedLogging.path,
-                agentName: options.name,
-                branch: resolvedBranch,
-                hostRepoDir,
-            });
-            return Layer.provide(FileDisplay.layer(resolvedLogging.path), NodeFileSystem.layer);
-        })()
-        : ClackDisplay.layer;
-    const factoryLayer = Layer.provide(WorktreeDockerSandboxFactory.layer, Layer.mergeAll(Layer.succeed(SandboxConfig, {
-        env,
-        hostRepoDir,
-        copyToWorktree: options.copyToWorktree,
-        name: options.name,
-        sandboxProvider: options.sandbox,
-        branchStrategy,
-        hooks,
-        signal: options.signal,
-        timeouts: options.timeouts,
-    }), NodeFileSystem.layer, displayLayer));
-    const agentStreamEmitterLayer = resolvedLogging.type === "file" && resolvedLogging.onAgentStreamEvent
-        ? callbackAgentStreamEmitterLayer(resolvedLogging.onAgentStreamEvent)
-        : noopAgentStreamEmitterLayer;
-    const runLayer = Layer.mergeAll(factoryLayer, displayLayer, agentStreamEmitterLayer);
-    const baseEffect = Effect.gen(function* () {
-        const d = yield* Display;
-        yield* d.intro(options.name ?? "sandcastle");
-        const rows = buildRunSummaryRows({
-            name: options.name,
-            agentName,
-            sandboxName: options.sandbox.name,
-            maxIterations,
-            branch: resolvedBranch,
-        });
-        yield* d.summary("Sandcastle Run", rows);
-        const userArgs = options.promptArgs ?? {};
-        // Inline prompts pass through to the agent literally — no substitution,
-        // no built-in arg injection. Guard against silently ignoring promptArgs.
-        let resolvedPrompt;
-        if (isInlinePrompt) {
-            yield* validateNoArgsWithInlinePrompt(userArgs);
-            resolvedPrompt = rawPrompt;
-        }
-        else {
-            yield* validateNoBuiltInArgOverride(userArgs);
-            const effectiveArgs = {
-                SOURCE_BRANCH: resolvedBranch,
-                TARGET_BRANCH: currentHostBranch,
-                ...userArgs,
-            };
-            const builtInArgKeysSet = new Set(BUILT_IN_PROMPT_ARG_KEYS);
-            resolvedPrompt = yield* substitutePromptArgs(rawPrompt, effectiveArgs, builtInArgKeysSet);
-        }
-        // In head mode, pass the host branch so SandboxLifecycle skips the merge step.
-        // In merge-to-head mode, branch is undefined (triggers merge). In branch mode, it's the explicit branch.
-        const orchestrateBranch = effectiveBranchType === "head" ? currentHostBranch : branch;
-        const orchestrateResult = yield* orchestrate({
-            hostRepoDir,
-            iterations: maxIterations,
-            hooks,
-            prompt: resolvedPrompt,
-            branch: orchestrateBranch,
-            provider,
-            completionSignal: options.completionSignal,
-            idleTimeoutSeconds: options.idleTimeoutSeconds,
-            name: options.name,
-            resumeSession: options.resumeSession,
-            signal: options.signal,
-            skipPromptExpansion: isInlinePrompt,
-            timeouts: options.timeouts,
-        });
-        const completion = buildCompletionMessage(orchestrateResult.completionSignal, orchestrateResult.iterations.length);
-        yield* d.status(completion.message, completion.severity);
-        for (const line of buildContextWindowLines(orchestrateResult.iterations)) {
-            yield* d.text(line);
-        }
-        return orchestrateResult;
-    });
-    // In file-logging mode, write errors to the log before they propagate.
-    // In stdout mode (ClackDisplay), errors are already shown by withFriendlyErrors
-    // in main.ts, so we skip to avoid duplicate terminal output.
-    const withErrorLog = resolvedLogging.type === "file"
-        ? baseEffect.pipe(Effect.tapError((error) => Effect.gen(function* () {
-            const d = yield* Display;
-            yield* d.status(formatErrorMessage(error), "error");
-        })))
-        : baseEffect;
-    let result;
-    try {
-        result = await Effect.runPromise(withErrorLog.pipe(Effect.provide(runLayer)));
-    }
-    catch (error) {
-        // If the signal was aborted, surface its reason verbatim (no wrapping)
-        options.signal?.throwIfAborted();
-        throw error;
-    }
-    const baseResult = {
-        ...result,
-        logFilePath: resolvedLogging.type === "file" ? resolvedLogging.path : undefined,
-        resume: async (prompt, resumeOptions) => {
-            const lastIteration = result.iterations.at(-1);
-            if (!lastIteration?.sessionId) {
-                throw new Error("Cannot resume: no sessionId was captured");
-            }
-            return run({
-                ...options,
-                ...resumeOptions,
-                prompt,
-                promptFile: undefined,
-                maxIterations: 1,
-                resumeSession: lastIteration.sessionId,
-            });
-        },
-    };
-    // Extract structured output after the iteration completes (separate pass from completion signal)
-    if (options.output) {
-        // Structured output runs are single-iteration, so the last iteration is the
-        // one that produced this stdout. Carry its session id onto the error so a
-        // caller can resume the same session to re-emit corrected output.
-        const lastIteration = baseResult.iterations.at(-1);
-        const output = await extractStructuredOutput(baseResult.stdout, options.output, {
-            commits: baseResult.commits,
-            branch: baseResult.branch,
-            preservedWorktreePath: baseResult.preservedWorktreePath,
-            sessionId: lastIteration?.sessionId,
-            sessionFilePath: lastIteration?.sessionFilePath,
-        });
-        return { ...baseResult, output };
-    }
-    return baseResult;
-}
-//# sourceMappingURL=run.js.map

package/dist/run.js.map

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

package/dist/sandboxExec.d.ts

@@ -1,12 +0,0 @@
-import type { IsolatedSandboxHandle } from "./SandboxProvider.js";
-/** Execute a command on the host side, returning stdout. Throws on non-zero exit. */
-export declare const execHost: (command: string, cwd: string) => Promise<string>;
-/** Execute a command in the sandbox, throwing if it fails. */
-export declare const execOk: (handle: IsolatedSandboxHandle, command: string, options?: {
-    cwd?: string | undefined;
-} | undefined) => Promise<{
-    stdout: string;
-    stderr: string;
-    exitCode: number;
-}>;
-//# sourceMappingURL=sandboxExec.d.ts.map

package/dist/sandboxExec.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sandboxExec.d.ts","sourceRoot":"","sources":["../src/sandboxExec.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAIlE,qFAAqF;AACrF,eAAO,MAAM,QAAQ,mDAcpB,CAAC;AAEF,8DAA8D;AAC9D,eAAO,MAAM,MAAM;;;;;;EAYlB,CAAC"}

package/dist/sandboxExec.js

@@ -1,26 +0,0 @@
-import { exec } from "node:child_process";
-import { promisify } from "node:util";
-const execAsync = promisify(exec);
-/** Execute a command on the host side, returning stdout. Throws on non-zero exit. */
-export const execHost = async (command, cwd) => {
-    try {
-        const { stdout } = await execAsync(command, {
-            cwd,
-            maxBuffer: 10 * 1024 * 1024,
-        });
-        return stdout;
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        throw new Error(`Host command failed: ${command}\n${message}`);
-    }
-};
-/** Execute a command in the sandbox, throwing if it fails. */
-export const execOk = async (handle, command, options) => {
-    const result = await handle.exec(command, options);
-    if (result.exitCode !== 0) {
-        throw new Error(`Sandbox command failed (exit ${result.exitCode}): ${command}\n${result.stderr}`);
-    }
-    return result;
-};
-//# sourceMappingURL=sandboxExec.js.map

package/dist/sandboxExec.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sandboxExec.js","sourceRoot":"","sources":["../src/sandboxExec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGtC,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAElC,qFAAqF;AACrF,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,EAC3B,OAAe,EACf,GAAW,EACM,EAAE;IACnB,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,OAAO,EAAE;YAC1C,GAAG;YACH,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;SAC5B,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,IAAI,KAAK,CAAC,wBAAwB,OAAO,KAAK,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;AACH,CAAC,CAAC;AAEF,8DAA8D;AAC9D,MAAM,CAAC,MAAM,MAAM,GAAG,KAAK,EACzB,MAA6B,EAC7B,OAAe,EACf,OAA0B,EACqC,EAAE;IACjE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACnD,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,gCAAgC,MAAM,CAAC,QAAQ,MAAM,OAAO,KAAK,MAAM,CAAC,MAAM,EAAE,CACjF,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}