@snappedly-tools/shipyard 0.4.4 → 0.5.0

package/dist/chunk-VDHZO5PP.js

@@ -1,113 +0,0 @@
-import { Display } from './chunk-2GT3OPO5.js';
-import { Effect } from 'effect';
-
-var 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 "AgentIdleTimeoutError":
-    case "WorktreeTimeoutError":
-    case "ContainerStartTimeoutError":
-    case "CopyToWorktreeTimeoutError":
-    case "CopyToWorktreeError":
-    case "SyncInTimeoutError":
-    case "HookTimeoutError":
-    case "GitSetupTimeoutError":
-    case "PromptExpansionTimeoutError":
-    case "CommitCollectionTimeoutError":
-    case "MergeToHostTimeoutError":
-    case "SessionCaptureError":
-    case "CwdError":
-      return error.message;
-  }
-};
-var showErrorAndExit = (error) => Effect.gen(function* () {
-  const d = yield* Display;
-  yield* d.status(formatErrorMessage(error), "error");
-  return yield* Effect.sync(() => process.exit(1));
-});
-var 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,
-    AgentIdleTimeoutError: showErrorAndExit,
-    WorktreeTimeoutError: showErrorAndExit,
-    ContainerStartTimeoutError: showErrorAndExit,
-    CopyToWorktreeTimeoutError: showErrorAndExit,
-    CopyToWorktreeError: showErrorAndExit,
-    SyncInTimeoutError: showErrorAndExit,
-    HookTimeoutError: showErrorAndExit,
-    GitSetupTimeoutError: showErrorAndExit,
-    PromptExpansionTimeoutError: showErrorAndExit,
-    CommitCollectionTimeoutError: showErrorAndExit,
-    MergeToHostTimeoutError: showErrorAndExit,
-    SessionCaptureError: showErrorAndExit,
-    CwdError: showErrorAndExit
-  })
-);
-
-// src/modelConfig.ts
-var CODEX_REASONING_EFFORTS = [
-  "low",
-  "medium",
-  "high",
-  "xhigh",
-  "max"
-];
-var DEFAULT_CODEX_MODELS = {
-  routine: { model: "gpt-5.6-luna", effort: "max" },
-  strong: { model: "gpt-5.6-sol", effort: "max" }
-};
-var readModel = (role) => process.env[`SHIPYARD_CODEX_${role.toUpperCase()}_MODEL`]?.trim() || DEFAULT_CODEX_MODELS[role].model;
-var readEffort = (role) => {
-  const envName = `SHIPYARD_CODEX_${role.toUpperCase()}_REASONING_EFFORT`;
-  const value = process.env[envName]?.trim();
-  if (!value) return DEFAULT_CODEX_MODELS[role].effort;
-  if (CODEX_REASONING_EFFORTS.includes(value)) {
-    return value;
-  }
-  throw new Error(
-    `${envName} must be one of ${CODEX_REASONING_EFFORTS.join(", ")}; received "${value}"`
-  );
-};
-var CODEX_MODELS = {
-  routine: {
-    model: readModel("routine"),
-    effort: readEffort("routine")
-  },
-  strong: {
-    model: readModel("strong"),
-    effort: readEffort("strong")
-  }
-};
-
-export { CODEX_MODELS, CODEX_REASONING_EFFORTS, formatErrorMessage, withFriendlyErrors };
-//# sourceMappingURL=chunk-VDHZO5PP.js.map
-//# sourceMappingURL=chunk-VDHZO5PP.js.map

package/dist/chunk-VDHZO5PP.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/ErrorHandler.ts","../src/modelConfig.ts"],"names":[],"mappings":"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","file":"chunk-VDHZO5PP.js","sourcesContent":["import { Effect } from \"effect\";\nimport { Display } from \"./Display.js\";\nimport type { SandboxError } from \"./errors.js\";\n\n/**\n * Formats a tagged SandboxError into a user-friendly message with\n * context-specific hints about what went wrong and how to recover.\n */\nexport const formatErrorMessage = (error: SandboxError): string => {\n  switch (error._tag) {\n    case \"ExecError\":\n      return `Command failed in sandbox (${error.command}): ${error.message}`;\n    case \"ExecHostError\":\n      return `Command failed on host (${error.command}): ${error.message}`;\n    case \"CopyError\":\n      return `File copy failed: ${error.message}`;\n    case \"DockerError\":\n      return `Docker operation failed: ${error.message}. Is Docker running?`;\n    case \"SyncError\":\n      return `Git sync failed: ${error.message}`;\n    case \"WorktreeError\":\n      return `Git worktree operation failed: ${error.message}`;\n    case \"PromptError\":\n      return `Failed to resolve prompt: ${error.message}`;\n    case \"AgentError\":\n      return `Agent invocation failed: ${error.message}`;\n    case \"ConfigDirError\":\n      return `${error.message}`;\n    case \"InitError\":\n      return `${error.message}`;\n    case \"AgentIdleTimeoutError\":\n    case \"WorktreeTimeoutError\":\n    case \"ContainerStartTimeoutError\":\n    case \"CopyToWorktreeTimeoutError\":\n    case \"CopyToWorktreeError\":\n    case \"SyncInTimeoutError\":\n    case \"HookTimeoutError\":\n    case \"GitSetupTimeoutError\":\n    case \"PromptExpansionTimeoutError\":\n    case \"CommitCollectionTimeoutError\":\n    case \"MergeToHostTimeoutError\":\n    case \"SessionCaptureError\":\n    case \"CwdError\":\n      return error.message;\n  }\n};\n\nconst showErrorAndExit = (error: SandboxError) =>\n  Effect.gen(function* () {\n    const d = yield* Display;\n    yield* d.status(formatErrorMessage(error), \"error\");\n    return yield* Effect.sync(() => process.exit(1) as never);\n  });\n\n/**\n * Wraps an effect so that any SandboxError is caught, displayed via the\n * Display service as an error-severity status message, then exits the process\n * with code 1. Non-SandboxError errors pass through unchanged.\n */\nexport const withFriendlyErrors = <A, E, R>(\n  effect: Effect.Effect<A, E, R>,\n): Effect.Effect<A, Exclude<E, SandboxError>, R | Display> =>\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  Effect.catchTags(effect as Effect.Effect<A, SandboxError, R>, {\n    ExecError: showErrorAndExit,\n    ExecHostError: showErrorAndExit,\n    CopyError: showErrorAndExit,\n    DockerError: showErrorAndExit,\n    SyncError: showErrorAndExit,\n    WorktreeError: showErrorAndExit,\n    PromptError: showErrorAndExit,\n    AgentError: showErrorAndExit,\n    ConfigDirError: showErrorAndExit,\n    InitError: showErrorAndExit,\n    AgentIdleTimeoutError: showErrorAndExit,\n    WorktreeTimeoutError: showErrorAndExit,\n    ContainerStartTimeoutError: showErrorAndExit,\n    CopyToWorktreeTimeoutError: showErrorAndExit,\n    CopyToWorktreeError: showErrorAndExit,\n    SyncInTimeoutError: showErrorAndExit,\n    HookTimeoutError: showErrorAndExit,\n    GitSetupTimeoutError: showErrorAndExit,\n    PromptExpansionTimeoutError: showErrorAndExit,\n    CommitCollectionTimeoutError: showErrorAndExit,\n    MergeToHostTimeoutError: showErrorAndExit,\n    SessionCaptureError: showErrorAndExit,\n    CwdError: showErrorAndExit,\n  }) as Effect.Effect<A, Exclude<E, SandboxError>, R | Display>;\n","/** Reasoning efforts accepted by the Codex CLI. */\nexport const CODEX_REASONING_EFFORTS = [\n  \"low\",\n  \"medium\",\n  \"high\",\n  \"xhigh\",\n  \"max\",\n] as const;\n\nexport type CodexReasoningEffort = (typeof CODEX_REASONING_EFFORTS)[number];\n\n/** A model identifier plus the reasoning policy used for that model role. */\nexport interface CodexModelConfig {\n  readonly model: string;\n  readonly effort: CodexReasoningEffort;\n}\n\n/**\n * Default values for Shipyard's built-in Codex roles.\n *\n * Runtime environment variables override these defaults:\n *   SHIPYARD_CODEX_ROUTINE_MODEL\n *   SHIPYARD_CODEX_ROUTINE_REASONING_EFFORT\n *   SHIPYARD_CODEX_STRONG_MODEL\n *   SHIPYARD_CODEX_STRONG_REASONING_EFFORT\n *\n * Keep the defaults here so runtime providers, generated templates, and the\n * repository workflows all use the same role definitions.\n */\nconst DEFAULT_CODEX_MODELS = {\n  routine: { model: \"gpt-5.6-luna\", effort: \"max\" },\n  strong: { model: \"gpt-5.6-sol\", effort: \"max\" },\n} as const satisfies Record<string, CodexModelConfig>;\n\nconst readModel = (role: keyof typeof DEFAULT_CODEX_MODELS): string =>\n  process.env[`SHIPYARD_CODEX_${role.toUpperCase()}_MODEL`]?.trim() ||\n  DEFAULT_CODEX_MODELS[role].model;\n\nconst readEffort = (\n  role: keyof typeof DEFAULT_CODEX_MODELS,\n): CodexReasoningEffort => {\n  const envName = `SHIPYARD_CODEX_${role.toUpperCase()}_REASONING_EFFORT`;\n  const value = process.env[envName]?.trim();\n  if (!value) return DEFAULT_CODEX_MODELS[role].effort;\n  if ((CODEX_REASONING_EFFORTS as readonly string[]).includes(value)) {\n    return value as CodexReasoningEffort;\n  }\n  throw new Error(\n    `${envName} must be one of ${CODEX_REASONING_EFFORTS.join(\", \")}; received \"${value}\"`,\n  );\n};\n\nexport const CODEX_MODELS = {\n  routine: {\n    model: readModel(\"routine\"),\n    effort: readEffort(\"routine\"),\n  },\n  strong: {\n    model: readModel(\"strong\"),\n    effort: readEffort(\"strong\"),\n  },\n} as const satisfies Record<string, CodexModelConfig>;\n"]}

package/dist/chunk-VW4MI5GJ.js

@@ -1,126 +0,0 @@
-import { MAX_TAIL_CHARS, OutputByteCounter, BoundedTail } from './chunk-WA7QPAXO.js';
-import { spawn } from 'child_process';
-import { createInterface } from 'readline';
-
-var noSandbox = (options) => ({
-  tag: "none",
-  name: "no-sandbox",
-  env: options?.env ?? {},
-  create: async (createOptions) => {
-    const worktreePath = createOptions.worktreePath;
-    const processEnv = { ...process.env, ...createOptions.env };
-    const maxOutputTailChars = options?.maxOutputTailChars ?? MAX_TAIL_CHARS;
-    const handle = {
-      worktreePath,
-      exec: (command, opts) => {
-        const cwd = opts?.cwd ?? worktreePath;
-        const isWindows = process.platform === "win32";
-        const shellCmd = isWindows ? "cmd.exe" : "sh";
-        const shellArgs = isWindows ? ["/d", "/s", "/c", command] : ["-c", command];
-        return new Promise((resolve, reject) => {
-          const proc = spawn(shellCmd, shellArgs, {
-            cwd,
-            env: processEnv,
-            signal: opts?.signal,
-            stdio: [
-              opts?.stdin !== void 0 ? "pipe" : "ignore",
-              "pipe",
-              "pipe"
-            ],
-            windowsVerbatimArguments: isWindows
-          });
-          if (opts?.stdin !== void 0) {
-            proc.stdin.write(opts.stdin);
-            proc.stdin.end();
-          }
-          proc.on("error", (error) => {
-            reject(new Error(`exec failed: ${error.message}`));
-          });
-          if (opts?.onLine || opts?.maxOutputBytes !== void 0) {
-            const onLine = opts?.onLine ?? (() => {
-            });
-            const outputLimit = opts?.maxOutputBytes === void 0 ? void 0 : new OutputByteCounter(opts.maxOutputBytes);
-            const tailChars = opts?.maxOutputBytes ?? maxOutputTailChars;
-            const stdoutTail = new BoundedTail(tailChars, "\n");
-            const stderrTail = new BoundedTail(tailChars, "");
-            let limitError;
-            const checkOutputLimit = (chunk) => {
-              if (outputLimit === void 0 || limitError !== void 0) {
-                return;
-              }
-              outputLimit.add(chunk);
-              if (outputLimit.exceeded) {
-                limitError = new Error(
-                  `Sandbox command output exceeded ${opts.maxOutputBytes} bytes`
-                );
-                proc.kill("SIGKILL");
-              }
-            };
-            proc.stdout.on("data", checkOutputLimit);
-            proc.stderr.on("data", checkOutputLimit);
-            const rl = createInterface({ input: proc.stdout });
-            rl.on("line", (line) => {
-              stdoutTail.push(line);
-              onLine(line);
-            });
-            proc.stderr.on("data", (chunk) => {
-              stderrTail.push(chunk.toString());
-            });
-            proc.on("close", (code) => {
-              if (limitError !== void 0) {
-                reject(limitError);
-                return;
-              }
-              resolve({
-                stdout: stdoutTail.toString(),
-                stderr: stderrTail.toString(),
-                exitCode: code ?? 0
-              });
-            });
-          } else {
-            const stdoutChunks = [];
-            const stderrChunks = [];
-            proc.stdout.on("data", (chunk) => {
-              stdoutChunks.push(chunk.toString());
-            });
-            proc.stderr.on("data", (chunk) => {
-              stderrChunks.push(chunk.toString());
-            });
-            proc.on("close", (code) => {
-              resolve({
-                stdout: stdoutChunks.join(""),
-                stderr: stderrChunks.join(""),
-                exitCode: code ?? 0
-              });
-            });
-          }
-        });
-      },
-      interactiveExec: (args, opts) => {
-        return new Promise((resolve, reject) => {
-          const [cmd, ...rest] = args;
-          const proc = spawn(cmd, rest, {
-            cwd: opts.cwd ?? worktreePath,
-            env: processEnv,
-            stdio: [opts.stdin, opts.stdout, opts.stderr],
-            shell: process.platform === "win32",
-            signal: opts.signal
-          });
-          proc.on("error", (error) => {
-            reject(new Error(`exec failed: ${error.message}`));
-          });
-          proc.on("close", (code) => {
-            resolve({ exitCode: code ?? 0 });
-          });
-        });
-      },
-      close: async () => {
-      }
-    };
-    return handle;
-  }
-});
-
-export { noSandbox };
-//# sourceMappingURL=chunk-VW4MI5GJ.js.map
-//# sourceMappingURL=chunk-VW4MI5GJ.js.map

package/dist/chunk-VW4MI5GJ.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/sandboxes/no-sandbox.ts"],"names":[],"mappings":"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","file":"chunk-VW4MI5GJ.js","sourcesContent":["/**\n * No-sandbox provider — runs the agent directly on the host with no container isolation.\n *\n * Usage:\n *   import { noSandbox } from \"@snappedly-tools/shipyard/sandboxes/no-sandbox\";\n *   await run({ agent: codex(CODEX_MODELS.routine), sandbox: noSandbox(), prompt: \"...\" });\n *\n * Accepted by `run()`, `interactive()`, and `createSandbox()`. It skips\n * container isolation entirely and does not pass\n * `--dangerously-skip-permissions` to the agent.\n */\n\nimport { spawn, type StdioOptions } from \"node:child_process\";\nimport { createInterface } from \"node:readline\";\nimport type {\n  NoSandboxProvider,\n  NoSandboxHandle,\n  ExecResult,\n  InteractiveExecOptions,\n} from \"../SandboxProvider.js\";\nimport {\n  BoundedTail,\n  MAX_TAIL_CHARS,\n  OutputByteCounter,\n} from \"../boundedTail.js\";\n\nexport interface NoSandboxOptions {\n  /** Environment variables injected by this provider. Merged at launch time. */\n  readonly env?: Record<string, string>;\n  /**\n   * Maximum number of characters of streamed `exec` output retained per stream\n   * (stdout and stderr) when an `onLine` callback is supplied (default: 64KiB).\n   *\n   * Output is delivered live to `onLine` regardless; this only bounds the tail\n   * returned in `ExecResult`, preventing a long-running agent's output from\n   * overflowing V8's max string length and crashing the run.\n   */\n  readonly maxOutputTailChars?: number;\n}\n\n/**\n * Create a no-sandbox provider.\n *\n * The returned provider runs the agent directly on the host. All three\n * branch strategies are supported (head, merge-to-head, branch),\n * defaulting to head.\n */\nexport const noSandbox = (options?: NoSandboxOptions): NoSandboxProvider => ({\n  tag: \"none\",\n  name: \"no-sandbox\",\n  env: options?.env ?? {},\n  create: async (createOptions): Promise<NoSandboxHandle> => {\n    const worktreePath = createOptions.worktreePath;\n    const processEnv = { ...process.env, ...createOptions.env };\n    const maxOutputTailChars = options?.maxOutputTailChars ?? MAX_TAIL_CHARS;\n\n    const handle: NoSandboxHandle = {\n      worktreePath,\n\n      exec: (\n        command: string,\n        opts?: {\n          onLine?: (line: string) => void;\n          cwd?: string;\n          sudo?: boolean;\n          stdin?: string;\n          signal?: AbortSignal;\n          maxOutputBytes?: number;\n        },\n      ): Promise<ExecResult> => {\n        // sudo is a no-op for no-sandbox — the user is already on the host\n        const cwd = opts?.cwd ?? worktreePath;\n        const isWindows = process.platform === \"win32\";\n        // PowerShell and cmd.exe don't ship `sh`, so on Windows route the\n        // command string through cmd.exe instead. `/d` skips AutoRun, `/s`\n        // preserves the quoted command verbatim, `/c` runs it and exits.\n        // `windowsVerbatimArguments` keeps Node from re-quoting our args.\n        const shellCmd = isWindows ? \"cmd.exe\" : \"sh\";\n        const shellArgs = isWindows\n          ? [\"/d\", \"/s\", \"/c\", command]\n          : [\"-c\", command];\n\n        return new Promise((resolve, reject) => {\n          const proc = spawn(shellCmd, shellArgs, {\n            cwd,\n            env: processEnv,\n            signal: opts?.signal,\n            stdio: [\n              opts?.stdin !== undefined ? \"pipe\" : \"ignore\",\n              \"pipe\",\n              \"pipe\",\n            ],\n            windowsVerbatimArguments: isWindows,\n          });\n\n          if (opts?.stdin !== undefined) {\n            proc.stdin!.write(opts.stdin);\n            proc.stdin!.end();\n          }\n\n          proc.on(\"error\", (error) => {\n            reject(new Error(`exec failed: ${error.message}`));\n          });\n\n          if (opts?.onLine || opts?.maxOutputBytes !== undefined) {\n            const onLine = opts?.onLine ?? (() => {});\n            const outputLimit =\n              opts?.maxOutputBytes === undefined\n                ? undefined\n                : new OutputByteCounter(opts.maxOutputBytes);\n            const tailChars = opts?.maxOutputBytes ?? maxOutputTailChars;\n            const stdoutTail = new BoundedTail(tailChars, \"\\n\");\n            const stderrTail = new BoundedTail(tailChars, \"\");\n            let limitError: Error | undefined;\n            const checkOutputLimit = (chunk: Buffer): void => {\n              if (outputLimit === undefined || limitError !== undefined) {\n                return;\n              }\n              outputLimit.add(chunk);\n              if (outputLimit.exceeded) {\n                limitError = new Error(\n                  `Sandbox command output exceeded ${opts.maxOutputBytes} bytes`,\n                );\n                proc.kill(\"SIGKILL\");\n              }\n            };\n            proc.stdout!.on(\"data\", checkOutputLimit);\n            proc.stderr!.on(\"data\", checkOutputLimit);\n            const rl = createInterface({ input: proc.stdout! });\n            rl.on(\"line\", (line) => {\n              stdoutTail.push(line);\n              onLine(line);\n            });\n            proc.stderr!.on(\"data\", (chunk: Buffer) => {\n              stderrTail.push(chunk.toString());\n            });\n            proc.on(\"close\", (code) => {\n              if (limitError !== undefined) {\n                reject(limitError);\n                return;\n              }\n              resolve({\n                stdout: stdoutTail.toString(),\n                stderr: stderrTail.toString(),\n                exitCode: code ?? 0,\n              });\n            });\n          } else {\n            const stdoutChunks: string[] = [];\n            const stderrChunks: string[] = [];\n            proc.stdout!.on(\"data\", (chunk: Buffer) => {\n              stdoutChunks.push(chunk.toString());\n            });\n            proc.stderr!.on(\"data\", (chunk: Buffer) => {\n              stderrChunks.push(chunk.toString());\n            });\n            proc.on(\"close\", (code) => {\n              resolve({\n                stdout: stdoutChunks.join(\"\"),\n                stderr: stderrChunks.join(\"\"),\n                exitCode: code ?? 0,\n              });\n            });\n          }\n        });\n      },\n\n      interactiveExec: (\n        args: string[],\n        opts: InteractiveExecOptions,\n      ): Promise<{ exitCode: number }> => {\n        return new Promise((resolve, reject) => {\n          const [cmd, ...rest] = args;\n          // Agent CLIs on Windows are typically installed as `.cmd`/`.ps1`\n          // npm wrappers; bare `spawn(\"claude\", …)` only resolves `.exe`\n          // without `shell: true`, so let cmd.exe handle PATHEXT lookup.\n          const proc = spawn(cmd!, rest, {\n            cwd: opts.cwd ?? worktreePath,\n            env: processEnv,\n            stdio: [opts.stdin, opts.stdout, opts.stderr] as StdioOptions,\n            shell: process.platform === \"win32\",\n            signal: opts.signal,\n          });\n\n          proc.on(\"error\", (error: Error) => {\n            reject(new Error(`exec failed: ${error.message}`));\n          });\n\n          proc.on(\"close\", (code: number | null) => {\n            resolve({ exitCode: code ?? 0 });\n          });\n        });\n      },\n\n      close: async (): Promise<void> => {\n        // No-op — no container to tear down\n      },\n    };\n\n    return handle;\n  },\n});\n"]}

package/dist/chunk-WA7QPAXO.js

@@ -1,50 +0,0 @@
-// src/boundedTail.ts
-var MAX_TAIL_CHARS = 64 * 1024;
-var OutputByteCounter = class {
-  constructor(maxBytes) {
-    this.maxBytes = maxBytes;
-  }
-  totalBytes = 0;
-  limitExceeded = false;
-  add(chunk) {
-    this.totalBytes += typeof chunk === "string" ? Buffer.byteLength(chunk) : chunk.byteLength;
-    if (this.totalBytes > this.maxBytes) this.limitExceeded = true;
-  }
-  get exceeded() {
-    return this.limitExceeded;
-  }
-};
-var BoundedTail = class {
-  items = [];
-  totalChars = 0;
-  maxChars;
-  separator;
-  /**
-   * @param maxChars Maximum length of the joined tail. Defaults to {@link MAX_TAIL_CHARS}.
-   * @param separator String placed between items by {@link toString}. Must match
-   *   how the caller would otherwise have joined the accumulated chunks (e.g.
-   *   `"\n"` for line streams, `""` for raw chunk streams).
-   */
-  constructor(maxChars = MAX_TAIL_CHARS, separator = "") {
-    this.maxChars = maxChars;
-    this.separator = separator;
-  }
-  /** Append one item to the tail, evicting oldest items to stay within budget. */
-  push(item) {
-    const bounded = item.length > this.maxChars ? item.slice(item.length - this.maxChars) : item;
-    this.totalChars += bounded.length + (this.items.length > 0 ? this.separator.length : 0);
-    this.items.push(bounded);
-    while (this.totalChars > this.maxChars && this.items.length > 1) {
-      const dropped = this.items.shift();
-      this.totalChars -= dropped.length + this.separator.length;
-    }
-  }
-  /** Join the retained tail into a single string (length ≤ `maxChars`). */
-  toString() {
-    return this.items.join(this.separator);
-  }
-};
-
-export { BoundedTail, MAX_TAIL_CHARS, OutputByteCounter };
-//# sourceMappingURL=chunk-WA7QPAXO.js.map
-//# sourceMappingURL=chunk-WA7QPAXO.js.map

package/dist/chunk-WA7QPAXO.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/boundedTail.ts"],"names":[],"mappings":";AAmBO,IAAM,iBAAiB,EAAA,GAAK;AAQ5B,IAAM,oBAAN,MAAwB;AAAA,EAI7B,YAA6B,QAAA,EAAkB;AAAlB,IAAA,IAAA,CAAA,QAAA,GAAA,QAAA;AAAA,EAAmB;AAAA,EAHxC,UAAA,GAAa,CAAA;AAAA,EACb,aAAA,GAAgB,KAAA;AAAA,EAIxB,IAAI,KAAA,EAAkC;AACpC,IAAA,IAAA,CAAK,UAAA,IACH,OAAO,KAAA,KAAU,QAAA,GAAW,OAAO,UAAA,CAAW,KAAK,IAAI,KAAA,CAAM,UAAA;AAC/D,IAAA,IAAI,IAAA,CAAK,UAAA,GAAa,IAAA,CAAK,QAAA,OAAe,aAAA,GAAgB,IAAA;AAAA,EAC5D;AAAA,EAEA,IAAI,QAAA,GAAoB;AACtB,IAAA,OAAO,IAAA,CAAK,aAAA;AAAA,EACd;AACF;AAaO,IAAM,cAAN,MAAkB;AAAA,EACN,QAAkB,EAAC;AAAA,EAC5B,UAAA,GAAa,CAAA;AAAA,EACJ,QAAA;AAAA,EACA,SAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQjB,WAAA,CAAY,QAAA,GAAmB,cAAA,EAAgB,SAAA,GAAY,EAAA,EAAI;AAC7D,IAAA,IAAA,CAAK,QAAA,GAAW,QAAA;AAChB,IAAA,IAAA,CAAK,SAAA,GAAY,SAAA;AAAA,EACnB;AAAA;AAAA,EAGA,KAAK,IAAA,EAAoB;AACvB,IAAA,MAAM,OAAA,GACJ,IAAA,CAAK,MAAA,GAAS,IAAA,CAAK,QAAA,GACf,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,MAAA,GAAS,IAAA,CAAK,QAAQ,CAAA,GACtC,IAAA;AACN,IAAA,IAAA,CAAK,UAAA,IACH,QAAQ,MAAA,IAAU,IAAA,CAAK,MAAM,MAAA,GAAS,CAAA,GAAI,IAAA,CAAK,SAAA,CAAU,MAAA,GAAS,CAAA,CAAA;AACpE,IAAA,IAAA,CAAK,KAAA,CAAM,KAAK,OAAO,CAAA;AACvB,IAAA,OAAO,KAAK,UAAA,GAAa,IAAA,CAAK,YAAY,IAAA,CAAK,KAAA,CAAM,SAAS,CAAA,EAAG;AAC/D,MAAA,MAAM,OAAA,GAAU,IAAA,CAAK,KAAA,CAAM,KAAA,EAAM;AACjC,MAAA,IAAA,CAAK,UAAA,IAAc,OAAA,CAAQ,MAAA,GAAS,IAAA,CAAK,SAAA,CAAU,MAAA;AAAA,IACrD;AAAA,EACF;AAAA;AAAA,EAGA,QAAA,GAAmB;AACjB,IAAA,OAAO,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,IAAA,CAAK,SAAS,CAAA;AAAA,EACvC;AACF","file":"chunk-WA7QPAXO.js","sourcesContent":["/**\n * A bounded, rolling tail of streamed output — a pure, provider-agnostic\n * utility shared by every sandbox provider that streams `exec` output.\n *\n * When a provider streams output line-by-line, it accumulates the stream only\n * to build the returned `ExecResult.stdout`/`stderr`. Consumers read just the\n * tail of that value (e.g. the last lines of an error, or a fallback for the\n * agent's final result), so retaining the whole stream is unnecessary — and,\n * once the accumulated string passes V8's ~512MB max string length, fatal: a\n * naive `chunks.join()` throws `RangeError: Invalid string length`, which on a\n * long agent run crashes the whole orchestration.\n */\n\n/**\n * Default maximum number of characters retained in a bounded output tail.\n *\n * 64KiB sits comfortably above any agent completion signal or structured-output\n * payload while staying far below V8's max string length.\n */\nexport const MAX_TAIL_CHARS = 64 * 1024;\n\n/**\n * Counts streamed output without retaining it. Providers use this when a\n * caller needs a hard byte ceiling for a one-shot command (for example prompt\n * expansion), so an untrusted command cannot exhaust memory before its output\n * is inspected.\n */\nexport class OutputByteCounter {\n  private totalBytes = 0;\n  private limitExceeded = false;\n\n  constructor(private readonly maxBytes: number) {}\n\n  add(chunk: string | Uint8Array): void {\n    this.totalBytes +=\n      typeof chunk === \"string\" ? Buffer.byteLength(chunk) : chunk.byteLength;\n    if (this.totalBytes > this.maxBytes) this.limitExceeded = true;\n  }\n\n  get exceeded(): boolean {\n    return this.limitExceeded;\n  }\n}\n\n/**\n * A fixed-size rolling tail of strings, bounded by total character length.\n *\n * `push` appends to the tail; once the joined length would exceed `maxChars`,\n * the oldest items are dropped from the front. A single item longer than\n * `maxChars` is truncated to its own tail, so a newline-free blob can't\n * overflow on one push. `toString` joins the retained items, and its length is\n * always at most `maxChars`.\n *\n * The running length counter is encapsulated so callers can't desync it.\n */\nexport class BoundedTail {\n  private readonly items: string[] = [];\n  private totalChars = 0;\n  private readonly maxChars: number;\n  private readonly separator: string;\n\n  /**\n   * @param maxChars Maximum length of the joined tail. Defaults to {@link MAX_TAIL_CHARS}.\n   * @param separator String placed between items by {@link toString}. Must match\n   *   how the caller would otherwise have joined the accumulated chunks (e.g.\n   *   `\"\\n\"` for line streams, `\"\"` for raw chunk streams).\n   */\n  constructor(maxChars: number = MAX_TAIL_CHARS, separator = \"\") {\n    this.maxChars = maxChars;\n    this.separator = separator;\n  }\n\n  /** Append one item to the tail, evicting oldest items to stay within budget. */\n  push(item: string): void {\n    const bounded =\n      item.length > this.maxChars\n        ? item.slice(item.length - this.maxChars)\n        : item;\n    this.totalChars +=\n      bounded.length + (this.items.length > 0 ? this.separator.length : 0);\n    this.items.push(bounded);\n    while (this.totalChars > this.maxChars && this.items.length > 1) {\n      const dropped = this.items.shift()!;\n      this.totalChars -= dropped.length + this.separator.length;\n    }\n  }\n\n  /** Join the retained tail into a single string (length ≤ `maxChars`). */\n  toString(): string {\n    return this.items.join(this.separator);\n  }\n}\n"]}