@snappedly-tools/shipyard 0.7.0-staging.36081473933 → 0.7.0

package/dist/templates/parallel-planner-with-review/main.mts

@@ -5,59 +5,9 @@ import { existsSync } from "node:fs";
 import * as shipyard from "@snappedly-tools/shipyard";
 import { docker } from "@snappedly-tools/shipyard/sandboxes/docker";
 import { z } from "zod";
-import { resolvePlannerBranch } from "./planner-branch.mjs";
 
 if (process.loadEnvFile && existsSync(".shipyard/.env"))
   process.loadEnvFile(".shipyard/.env");
-type ModelRole = "routine" | "strong";
-const CODEX_PROVIDER = true;
-const agentFactory = shipyard.codex;
-type AgentModel = Parameters<typeof agentFactory>[0];
-const readRoleModel = (role: ModelRole): string | undefined => {
-  const envName = `SHIPYARD_${role.toUpperCase()}_MODEL`;
-  const model = process.env[envName];
-  if (model !== undefined && model.trim().length === 0)
-    throw new Error(`${envName} must not be empty`);
-  return model;
-};
-const roleModels = {
-  routine: readRoleModel("routine"),
-  strong: readRoleModel("strong"),
-};
-const CODEX_REASONING_EFFORTS = shipyard.CODEX_REASONING_EFFORTS;
-type CodexReasoningEffort = shipyard.CodexReasoningEffort;
-const readCodexReasoningEffort = (
-  role: ModelRole,
-): CodexReasoningEffort | undefined => {
-  if (!CODEX_PROVIDER) return undefined;
-  const envName = `SHIPYARD_CODEX_${role.toUpperCase()}_REASONING_EFFORT`;
-  const effort = process.env[envName]?.trim();
-  if (!effort) return undefined;
-  if (!(CODEX_REASONING_EFFORTS as readonly string[]).includes(effort))
-    throw new Error(
-      `${envName} must be one of ${CODEX_REASONING_EFFORTS.join(", ")}; received "${effort}"`,
-    );
-  return effort as CodexReasoningEffort;
-};
-const roleEfforts = {
-  routine: readCodexReasoningEffort("routine"),
-  strong: readCodexReasoningEffort("strong"),
-};
-const readCodexRoleModel = (role: ModelRole, defaultModel: AgentModel) => {
-  if (!CODEX_PROVIDER || typeof defaultModel === "string") return defaultModel;
-  const envName = `SHIPYARD_CODEX_${role.toUpperCase()}_MODEL`;
-  const model = process.env[envName]?.trim();
-  return model ? { ...defaultModel, model } : defaultModel;
-};
-const roleAgent = (role: ModelRole, defaultModel: AgentModel) => {
-  const model = roleModels[role] ?? readCodexRoleModel(role, defaultModel);
-  const effort = roleEfforts[role];
-  if (typeof model !== "string")
-    return effort === undefined
-      ? agentFactory(model)
-      : agentFactory(model, { effort });
-  return agentFactory(model, { effort: effort ?? null });
-};
 const targetBranch = execFileSync("git", ["branch", "--show-current"], {
   encoding: "utf8",
 }).trim();
@@ -174,7 +124,7 @@ const runWorker = async (scope: Scope, ticket: Ticket) => {
     await sandbox.run({
       name: `triage #${ticket.id}`,
       maxIterations: 1,
-      agent: roleAgent("routine", shipyard.CODEX_MODELS.routine),
+      agent: shipyard.codex(shipyard.CODEX_MODELS.strong),
       promptFile: "./.shipyard/triage-prompt.md",
       promptArgs: { TASK_ID: ticket.id },
     });
@@ -182,7 +132,7 @@ const runWorker = async (scope: Scope, ticket: Ticket) => {
     const implementation = await sandbox.run({
       name: "implementer",
       maxIterations: 100,
-      agent: roleAgent("routine", shipyard.CODEX_MODELS.routine),
+      agent: shipyard.codex(shipyard.CODEX_MODELS.routine),
       promptFile: "./.shipyard/implement-prompt.md",
       promptArgs: {
         TASK_ID: ticket.id,
@@ -195,7 +145,7 @@ const runWorker = async (scope: Scope, ticket: Ticket) => {
     const review = await sandbox.run({
       name: "reviewer",
       maxIterations: 1,
-      agent: roleAgent("strong", shipyard.CODEX_MODELS.strong),
+      agent: shipyard.codex(shipyard.CODEX_MODELS.strong),
       promptFile: "./.shipyard/review-prompt.md",
       promptArgs: {
         TASK_ID: ticket.id,
@@ -216,21 +166,13 @@ for (let iteration = 0; iteration < 10; iteration++) {
     execFileSync("node", [".shipyard/select-issues.mjs"], { encoding: "utf8" }),
   ) as Scope[];
   if (!scopes.length) break;
-  const localBranches = execFileSync(
-    "git",
-    ["for-each-ref", "--format=%(refname:short)", "refs/heads"],
-    { encoding: "utf8" },
-  )
-    .split(/\r?\n/)
-    .filter(Boolean);
-  const plannerBranch = await resolvePlannerBranch(localBranches);
   const plan = await shipyard.run({
     hooks,
     sandbox: docker(),
     name: "planner",
-    branchStrategy: { type: "branch", branch: plannerBranch },
+    branchStrategy: { type: "branch", branch: "shipyard/planner" },
     maxIterations: 1,
-    agent: roleAgent("strong", shipyard.CODEX_MODELS.strong),
+    agent: shipyard.codex(shipyard.CODEX_MODELS.strong),
     promptFile: "./.shipyard/plan-prompt.md",
     output: shipyard.Output.object({ tag: "plan", schema: planSchema }),
   });
@@ -358,7 +300,7 @@ for (let iteration = 0; iteration < 10; iteration++) {
                     const resolution = await wave.run({
                       name: "conflict-resolver",
                       maxIterations: 10,
-                      agent: roleAgent("strong", shipyard.CODEX_MODELS.strong),
+                      agent: shipyard.codex(shipyard.CODEX_MODELS.strong),
                       promptFile: "./.shipyard/conflict-prompt.md",
                       promptArgs: {
                         TASK_ID: ready[index]!.id,
@@ -412,7 +354,7 @@ for (let iteration = 0; iteration < 10; iteration++) {
               const integrated = await wave.run({
                 name: "spec-integrator",
                 maxIterations: 10,
-                agent: roleAgent("strong", shipyard.CODEX_MODELS.strong),
+                agent: shipyard.codex(shipyard.CODEX_MODELS.strong),
                 promptFile: "./.shipyard/spec-wave-prompt.md",
                 promptArgs: {
                   TASK_ID: id,
@@ -452,7 +394,7 @@ for (let iteration = 0; iteration < 10; iteration++) {
             await integration.run({
               name: `triage #${id}`,
               maxIterations: 1,
-              agent: roleAgent("routine", shipyard.CODEX_MODELS.routine),
+              agent: shipyard.codex(shipyard.CODEX_MODELS.strong),
               promptFile: "./.shipyard/triage-prompt.md",
               promptArgs: { TASK_ID: id },
             });
@@ -460,7 +402,7 @@ for (let iteration = 0; iteration < 10; iteration++) {
             const standalone = await integration.run({
               name: "implementer",
               maxIterations: 100,
-              agent: roleAgent("routine", shipyard.CODEX_MODELS.routine),
+              agent: shipyard.codex(shipyard.CODEX_MODELS.routine),
               promptFile: "./.shipyard/implement-prompt.md",
               promptArgs: {
                 TASK_ID: id,
@@ -474,7 +416,7 @@ for (let iteration = 0; iteration < 10; iteration++) {
           const review = await integration.run({
             name: "reviewer",
             maxIterations: 1,
-            agent: roleAgent("strong", shipyard.CODEX_MODELS.strong),
+            agent: shipyard.codex(shipyard.CODEX_MODELS.strong),
             promptFile: "./.shipyard/review-prompt.md",
             promptArgs: {
               TASK_ID: id,
@@ -487,7 +429,7 @@ for (let iteration = 0; iteration < 10; iteration++) {
           const final = await integration.run({
             name: "merger",
             maxIterations: 1,
-            agent: roleAgent("strong", shipyard.CODEX_MODELS.strong),
+            agent: shipyard.codex(shipyard.CODEX_MODELS.strong),
             promptFile: "./.shipyard/merge-prompt.md",
             promptArgs: {
               TASK_ID: id,
@@ -503,7 +445,7 @@ for (let iteration = 0; iteration < 10; iteration++) {
             const finalReview = await integration.run({
               name: "reviewer",
               maxIterations: 1,
-              agent: roleAgent("strong", shipyard.CODEX_MODELS.strong),
+              agent: shipyard.codex(shipyard.CODEX_MODELS.strong),
               promptFile: "./.shipyard/review-prompt.md",
               promptArgs: {
                 TASK_ID: id,

package/dist/templates/sequential-reviewer/main.mts

@@ -7,55 +7,6 @@ import { docker } from "@snappedly-tools/shipyard/sandboxes/docker";
 
 if (process.loadEnvFile && existsSync(".shipyard/.env"))
   process.loadEnvFile(".shipyard/.env");
-type ModelRole = "routine" | "strong";
-const CODEX_PROVIDER = true;
-const agentFactory = shipyard.codex;
-type AgentModel = Parameters<typeof agentFactory>[0];
-const readRoleModel = (role: ModelRole): string | undefined => {
-  const envName = `SHIPYARD_${role.toUpperCase()}_MODEL`;
-  const model = process.env[envName];
-  if (model !== undefined && model.trim().length === 0)
-    throw new Error(`${envName} must not be empty`);
-  return model;
-};
-const roleModels = {
-  routine: readRoleModel("routine"),
-  strong: readRoleModel("strong"),
-};
-const CODEX_REASONING_EFFORTS = shipyard.CODEX_REASONING_EFFORTS;
-type CodexReasoningEffort = shipyard.CodexReasoningEffort;
-const readCodexReasoningEffort = (
-  role: ModelRole,
-): CodexReasoningEffort | undefined => {
-  if (!CODEX_PROVIDER) return undefined;
-  const envName = `SHIPYARD_CODEX_${role.toUpperCase()}_REASONING_EFFORT`;
-  const effort = process.env[envName]?.trim();
-  if (!effort) return undefined;
-  if (!(CODEX_REASONING_EFFORTS as readonly string[]).includes(effort))
-    throw new Error(
-      `${envName} must be one of ${CODEX_REASONING_EFFORTS.join(", ")}; received "${effort}"`,
-    );
-  return effort as CodexReasoningEffort;
-};
-const roleEfforts = {
-  routine: readCodexReasoningEffort("routine"),
-  strong: readCodexReasoningEffort("strong"),
-};
-const readCodexRoleModel = (role: ModelRole, defaultModel: AgentModel) => {
-  if (!CODEX_PROVIDER || typeof defaultModel === "string") return defaultModel;
-  const envName = `SHIPYARD_CODEX_${role.toUpperCase()}_MODEL`;
-  const model = process.env[envName]?.trim();
-  return model ? { ...defaultModel, model } : defaultModel;
-};
-const roleAgent = (role: ModelRole, defaultModel: AgentModel) => {
-  const model = roleModels[role] ?? readCodexRoleModel(role, defaultModel);
-  const effort = roleEfforts[role];
-  if (typeof model !== "string")
-    return effort === undefined
-      ? agentFactory(model)
-      : agentFactory(model, { effort });
-  return agentFactory(model, { effort: effort ?? null });
-};
 const targetBranch = execFileSync("git", ["branch", "--show-current"], {
   encoding: "utf8",
 }).trim();
@@ -185,7 +136,7 @@ for (let iteration = 0; iteration < MAX_ITERATIONS; iteration++) {
         : [issue.id]) {
         await sandbox.run({
           name: `triage #${ticketId}`,
-          agent: roleAgent("routine", shipyard.CODEX_MODELS.routine),
+          agent: shipyard.codex(shipyard.CODEX_MODELS.strong),
           maxIterations: 1,
           promptFile: "./.shipyard/triage-prompt.md",
           promptArgs: { TASK_ID: ticketId },
@@ -195,7 +146,7 @@ for (let iteration = 0; iteration < MAX_ITERATIONS; iteration++) {
       const implement = await sandbox.run({
         name: "implementer",
         maxIterations: 1,
-        agent: roleAgent("routine", shipyard.CODEX_MODELS.routine),
+        agent: shipyard.codex(shipyard.CODEX_MODELS.routine),
         promptFile: "./.shipyard/implement-prompt.md",
         promptArgs: {
           TASK_ID: issue.id,
@@ -214,7 +165,7 @@ for (let iteration = 0; iteration < MAX_ITERATIONS; iteration++) {
       const review = await sandbox.run({
         name: "reviewer",
         maxIterations: 1,
-        agent: roleAgent("strong", shipyard.CODEX_MODELS.strong),
+        agent: shipyard.codex(shipyard.CODEX_MODELS.strong),
         promptFile: "./.shipyard/review-prompt.md",
         promptArgs: {
           BRANCH: issue.branch,

package/dist/templates/simple-loop/main.mts

@@ -7,55 +7,6 @@ import { docker } from "@snappedly-tools/shipyard/sandboxes/docker";
 
 if (process.loadEnvFile && existsSync(".shipyard/.env"))
   process.loadEnvFile(".shipyard/.env");
-type ModelRole = "routine" | "strong";
-const CODEX_PROVIDER = true;
-const agentFactory = shipyard.codex;
-type AgentModel = Parameters<typeof agentFactory>[0];
-const readRoleModel = (role: ModelRole): string | undefined => {
-  const envName = `SHIPYARD_${role.toUpperCase()}_MODEL`;
-  const model = process.env[envName];
-  if (model !== undefined && model.trim().length === 0)
-    throw new Error(`${envName} must not be empty`);
-  return model;
-};
-const roleModels = {
-  routine: readRoleModel("routine"),
-  strong: readRoleModel("strong"),
-};
-const CODEX_REASONING_EFFORTS = shipyard.CODEX_REASONING_EFFORTS;
-type CodexReasoningEffort = shipyard.CodexReasoningEffort;
-const readCodexReasoningEffort = (
-  role: ModelRole,
-): CodexReasoningEffort | undefined => {
-  if (!CODEX_PROVIDER) return undefined;
-  const envName = `SHIPYARD_CODEX_${role.toUpperCase()}_REASONING_EFFORT`;
-  const effort = process.env[envName]?.trim();
-  if (!effort) return undefined;
-  if (!(CODEX_REASONING_EFFORTS as readonly string[]).includes(effort))
-    throw new Error(
-      `${envName} must be one of ${CODEX_REASONING_EFFORTS.join(", ")}; received "${effort}"`,
-    );
-  return effort as CodexReasoningEffort;
-};
-const roleEfforts = {
-  routine: readCodexReasoningEffort("routine"),
-  strong: readCodexReasoningEffort("strong"),
-};
-const readCodexRoleModel = (role: ModelRole, defaultModel: AgentModel) => {
-  if (!CODEX_PROVIDER || typeof defaultModel === "string") return defaultModel;
-  const envName = `SHIPYARD_CODEX_${role.toUpperCase()}_MODEL`;
-  const model = process.env[envName]?.trim();
-  return model ? { ...defaultModel, model } : defaultModel;
-};
-const roleAgent = (role: ModelRole, defaultModel: AgentModel) => {
-  const model = roleModels[role] ?? readCodexRoleModel(role, defaultModel);
-  const effort = roleEfforts[role];
-  if (typeof model !== "string")
-    return effort === undefined
-      ? agentFactory(model)
-      : agentFactory(model, { effort });
-  return agentFactory(model, { effort: effort ?? null });
-};
 const targetBranch = execFileSync("git", ["branch", "--show-current"], {
   encoding: "utf8",
 }).trim();
@@ -182,7 +133,7 @@ for (let iteration = 0; iteration < 3; iteration++) {
         : [issue.id]) {
         await sandbox.run({
           name: `triage #${ticketId}`,
-          agent: roleAgent("routine", shipyard.CODEX_MODELS.routine),
+          agent: shipyard.codex(shipyard.CODEX_MODELS.strong),
           maxIterations: 1,
           promptFile: "./.shipyard/triage-prompt.md",
           promptArgs: { TASK_ID: ticketId },
@@ -191,7 +142,7 @@ for (let iteration = 0; iteration < 3; iteration++) {
       }
       const result = await sandbox.run({
         name: "implementer",
-        agent: roleAgent("routine", shipyard.CODEX_MODELS.routine),
+        agent: shipyard.codex(shipyard.CODEX_MODELS.routine),
         maxIterations: 1,
         promptFile: "./.shipyard/prompt.md",
         promptArgs: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@snappedly-tools/shipyard",
-  "version": "0.7.0-staging.36081473933",
+  "version": "0.7.0",
   "description": "Run AI coding agents in isolated sandboxes",
   "type": "module",
   "main": "./dist/index.js",
@@ -13,6 +13,14 @@
     "./sandboxes/docker": {
       "import": "./dist/sandboxes/docker.js",
       "types": "./dist/sandboxes/docker.d.ts"
+    },
+    "./sandboxes/vercel": {
+      "import": "./dist/sandboxes/vercel.js",
+      "types": "./dist/sandboxes/vercel.d.ts"
+    },
+    "./sandboxes/no-sandbox": {
+      "import": "./dist/sandboxes/no-sandbox.js",
+      "types": "./dist/sandboxes/no-sandbox.d.ts"
     }
   },
   "bin": {
@@ -82,6 +90,14 @@
     "tsx": "^4.23.13",
     "zod": "^4.6.5"
   },
+  "peerDependencies": {
+    "@vercel/sandbox": ">=1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@vercel/sandbox": {
+      "optional": true
+    }
+  },
   "files": [
     "dist",
     "LICENSE",

package/dist/MountConfig-BHnKnA4h.d.ts

@@ -1,145 +0,0 @@
-/** Result of executing a command inside a sandbox. */
-interface ExecResult {
-    /** Collected standard output. */
-    readonly stdout: string;
-    /** Collected standard error. */
-    readonly stderr: string;
-    /** Process exit status. */
-    readonly exitCode: number;
-}
-/** Streams supplied when launching an interactive agent process. */
-interface InteractiveExecOptions {
-    /** Input stream forwarded to the agent process. */
-    readonly stdin: NodeJS.ReadableStream;
-    /** Output stream receiving agent standard output. */
-    readonly stdout: NodeJS.WritableStream;
-    /** Output stream receiving agent standard error. */
-    readonly stderr: NodeJS.WritableStream;
-    /** Working directory inside Docker. */
-    readonly cwd?: string;
-    /** Abort signal that terminates the interactive process. */
-    readonly signal?: AbortSignal;
-}
-/** Handle to a running isolated sandbox. Docker implements this contract. */
-interface IsolatedSandboxHandle {
-    /** Absolute Git workspace path inside Docker. */
-    readonly worktreePath: string;
-    /**
-     * Execute a command in Docker. Deliver `onLine` as output arrives so idle
-     * timeouts and live feedback work; buffered delivery does not satisfy this
-     * contract. Pipe `stdin` to the child rather than passing it as an argument.
-     */
-    exec(command: string, options?: {
-        /** Live output callback. */
-        onLine?: (line: string) => void;
-        /** Working directory inside Docker. */
-        cwd?: string;
-        /** Execute as root when supported. */
-        sudo?: boolean;
-        /** Input piped to the child process. */
-        stdin?: string;
-        /** Abort signal that terminates the command. */
-        signal?: AbortSignal;
-        /** Maximum combined output bytes before termination. */
-        maxOutputBytes?: number;
-    }): Promise<ExecResult>;
-    /** Launch an interactive process and terminate it when `signal` aborts. */
-    interactiveExec?(args: string[], options: InteractiveExecOptions): Promise<{
-        exitCode: number;
-    }>;
-    /** Copy a file or directory from the host into Docker. */
-    copyIn(hostPath: string, sandboxPath: string): Promise<void>;
-    /** Copy a file from Docker to the host. */
-    copyFileOut(sandboxPath: string, hostPath: string): Promise<void>;
-    /** Tear down the container. */
-    close(): Promise<void>;
-}
-/** File transfer shape used by agent session storage. */
-interface SessionTransferHandle {
-    /** Absolute Git workspace path inside Docker. */
-    readonly worktreePath: string;
-    /** Run a command in the sandbox. */
-    exec: IsolatedSandboxHandle["exec"];
-    /** Launch an interactive command when available. */
-    interactiveExec?: IsolatedSandboxHandle["interactiveExec"];
-    /** Copy one host file into the sandbox. */
-    copyFileIn(hostPath: string, sandboxPath: string): Promise<void>;
-    /** Copy one sandbox file to the host. */
-    copyFileOut(sandboxPath: string, hostPath: string): Promise<void>;
-    /** Tear down the sandbox. */
-    close(): Promise<void>;
-}
-/** Inputs to Docker sandbox creation. */
-interface IsolatedCreateOptions {
-    /** Original repository path used to derive the image name; never mounted. */
-    readonly hostRepoPath?: string;
-    /** Environment injected into the Docker container. */
-    readonly env: Record<string, string>;
-}
-/** Configuration for the isolated Docker provider contract. */
-interface IsolatedSandboxProviderConfig {
-    /** Human-readable provider name. */
-    readonly name: string;
-    /** Provider environment merged into sandbox startup. */
-    readonly env?: Record<string, string>;
-    /** Start a sandbox and return its command and file-transfer handle. */
-    readonly create: (options: IsolatedCreateOptions) => Promise<IsolatedSandboxHandle>;
-}
-/** Docker's isolated filesystem provider contract. */
-interface IsolatedSandboxProvider {
-    /** Isolated filesystem discriminator. */
-    readonly tag: "isolated";
-    /** Human-readable provider name. */
-    readonly name: string;
-    /** Environment variables injected into Docker. */
-    readonly env: Record<string, string>;
-    /** Start a sandbox. */
-    readonly create: (options: IsolatedCreateOptions) => Promise<IsolatedSandboxHandle>;
-}
-/** Provider accepted by Shipyard's Docker execution path. */
-type SandboxProvider = IsolatedSandboxProvider;
-/** Create a temporary branch and merge its commits back to host HEAD. */
-interface MergeToHeadBranchStrategy {
-    /** Branch strategy discriminator. */
-    readonly type: "merge-to-head";
-}
-/** Run on a caller-named branch. */
-interface NamedBranchStrategy {
-    /** Branch strategy discriminator. */
-    readonly type: "branch";
-    /** Branch to create or reuse. */
-    readonly branch: string;
-    /** Starting ref for a new branch. */
-    readonly baseBranch?: string;
-}
-/** Supported Docker branch strategies. */
-type BranchStrategy = MergeToHeadBranchStrategy | NamedBranchStrategy;
-/** Construct the isolated provider contract used by Docker. */
-declare const createIsolatedSandboxProvider: (config: IsolatedSandboxProviderConfig) => IsolatedSandboxProvider;
-
-/**
- * User-facing mount configuration for Docker.
- *
- * Each entry describes a host directory to mount into the sandbox container.
- */
-/** A single bind-mount descriptor for the Docker provider. */
-interface MountConfig {
-    /**
-     * Path on the host. Supports:
-     * - Absolute paths (`/data/cache`)
-     * - Tilde-expanded paths (`~/data` → `<home>/data`)
-     * - Relative paths (`data` or `./data`) — resolved from `process.cwd()`
-     */
-    readonly hostPath: string;
-    /**
-     * Path inside the sandbox container. Supports:
-     * - Absolute paths (`/mnt/data`)
-     * - Tilde-expanded paths (`~/.npm` → `/home/agent/.npm`) — expanded using the provider's sandbox home directory
-     * - Relative paths (`data` or `./data`) — resolved from the worktree directory (`/home/agent/workspace`)
-     */
-    readonly sandboxPath: string;
-    /** Mount as read-only. Defaults to `false`. */
-    readonly readonly?: boolean;
-}
-
-export { type BranchStrategy as B, type ExecResult as E, type IsolatedSandboxProvider as I, type MountConfig as M, type NamedBranchStrategy as N, type SessionTransferHandle as S, type SandboxProvider as a, type MergeToHeadBranchStrategy as b, type InteractiveExecOptions as c, type IsolatedCreateOptions as d, type IsolatedSandboxHandle as e, type IsolatedSandboxProviderConfig as f, createIsolatedSandboxProvider as g };