@ai-hero/sandcastle 0.1.7 → 0.2.0

package/dist/templates/blank/main.ts

@@ -1,9 +1,10 @@
-import { run } from "@ai-hero/sandcastle";
+import { run, claudeCode } from "@ai-hero/sandcastle";
 
 // Blank template: customize this to build your own orchestration.
 // Run this with: npx tsx .sandcastle/main.ts
 // Or add to package.json scripts: "sandcastle": "npx tsx .sandcastle/main.ts"
 
 await run({
+  agent: claudeCode("claude-opus-4-6"),
   promptFile: "./.sandcastle/prompt.md",
 });

package/dist/templates/parallel-planner/.env.example

@@ -0,0 +1,4 @@
+# Anthropic API key
+ANTHROPIC_API_KEY=
+# GitHub personal access token
+GH_TOKEN=

package/dist/templates/parallel-planner/main.ts

@@ -61,7 +61,7 @@ for (let iteration = 1; iteration <= MAX_ITERATIONS; iteration++) {
     // not write code.
     maxIterations: 1,
     // Opus for planning: dependency analysis benefits from deeper reasoning.
-    model: "claude-opus-4-6",
+    agent: sandcastle.claudeCode("claude-opus-4-6"),
     promptFile: "./.sandcastle/plan-prompt.md",
   });
 
@@ -109,7 +109,7 @@ for (let iteration = 1; iteration <= MAX_ITERATIONS; iteration++) {
         // Give each agent plenty of room to implement and iterate on tests.
         maxIterations: 100,
         // Sonnet for execution: fast and capable enough for typical issue work.
-        model: "claude-sonnet-4-6",
+        agent: sandcastle.claudeCode("claude-sonnet-4-6"),
         promptFile: "./.sandcastle/implement-prompt.md",
         // Prompt arguments substitute {{ISSUE_NUMBER}}, {{ISSUE_TITLE}},
         // and {{BRANCH}} placeholders in implement-prompt.md before the
@@ -120,7 +120,7 @@ for (let iteration = 1; iteration <= MAX_ITERATIONS; iteration++) {
           BRANCH: issue.branch,
         },
         // Each agent starts on its own branch.
-        branch: issue.branch,
+        worktree: { mode: "branch", branch: issue.branch },
       }),
     ),
   );
@@ -182,7 +182,7 @@ for (let iteration = 1; iteration <= MAX_ITERATIONS; iteration++) {
     name: "merger",
     maxIterations: 10,
     // Sonnet is sufficient for merge conflict resolution.
-    model: "claude-sonnet-4-6",
+    agent: sandcastle.claudeCode("claude-sonnet-4-6"),
     promptFile: "./.sandcastle/merge-prompt.md",
     promptArgs: {
       // A markdown list of branch names, one per line.

package/dist/templates/sequential-reviewer/.env.example

@@ -0,0 +1,4 @@
+# Anthropic API key
+ANTHROPIC_API_KEY=
+# GitHub personal access token
+GH_TOKEN=

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

@@ -59,7 +59,7 @@ for (let iteration = 1; iteration <= MAX_ITERATIONS; iteration++) {
     copyToSandbox,
     name: "implementer",
     maxIterations: 100,
-    model: "claude-sonnet-4-6",
+    agent: sandcastle.claudeCode("claude-sonnet-4-6"),
     promptFile: "./.sandcastle/implement-prompt.md",
   });
 
@@ -86,14 +86,14 @@ for (let iteration = 1; iteration <= MAX_ITERATIONS; iteration++) {
     copyToSandbox,
     name: "reviewer",
     maxIterations: 10,
-    model: "claude-sonnet-4-6",
+    agent: sandcastle.claudeCode("claude-sonnet-4-6"),
     promptFile: "./.sandcastle/review-prompt.md",
     // Prompt arguments substitute {{BRANCH}} in review-prompt.md before the
     // agent sees the prompt.
     promptArgs: {
       BRANCH: branch,
     },
-    branch,
+    worktree: { mode: "branch", branch },
   });
 
   console.log("\nReview complete.");

package/dist/templates/simple-loop/.env.example

@@ -0,0 +1,4 @@
+# Anthropic API key
+ANTHROPIC_API_KEY=
+# GitHub personal access token
+GH_TOKEN=

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

@@ -1,4 +1,4 @@
-import { run } from "@ai-hero/sandcastle";
+import { run, claudeCode } from "@ai-hero/sandcastle";
 
 // Simple loop: an agent that picks open GitHub issues one by one and closes them.
 // Run this with: npx tsx .sandcastle/main.ts
@@ -8,6 +8,11 @@ await run({
   // A name for this run, shown as a prefix in log output.
   name: "worker",
 
+  // The agent provider. Pass a model string to claudeCode() — sonnet balances
+  // capability and speed for most tasks. Switch to claude-opus-4-6 for harder
+  // problems, or claude-haiku-4-5-20251001 for speed.
+  agent: claudeCode("claude-sonnet-4-6"),
+
   // Path to the prompt file. Shell expressions inside are evaluated inside the
   // sandbox at the start of each iteration, so the agent always sees fresh data.
   promptFile: "./.sandcastle/prompt.md",
@@ -17,10 +22,6 @@ await run({
   // per run, or set it to 1 for a single-shot mode.
   maxIterations: 3,
 
-  // The Claude model to use. Sonnet balances capability and speed for most tasks.
-  // Switch to claude-opus-4-6 for harder problems, or claude-haiku-4-5 for speed.
-  model: "claude-sonnet-4-6",
-
   // Copy node_modules from the host into the worktree before the sandbox
   // starts. This avoids a full npm install from scratch on every iteration.
   // The onSandboxReady hook still runs npm install as a safety net to handle

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-hero/sandcastle",
-  "version": "0.1.7",
+  "version": "0.2.0",
   "description": "CLI for orchestrating AI agents in isolated sandbox environments",
   "type": "module",
   "main": "./dist/index.js",
@@ -24,7 +24,7 @@
     "format:check": "prettier --check .",
     "prepare": "husky",
     "release": "changeset publish",
-    "run-sandcastle": "tsx .sandcastle/run.ts"
+    "sandcastle": "npm run build && tsx .sandcastle/run.ts"
   },
   "keywords": [
     "cli",