@vercel/dream 0.2.6 → 0.2.8

package/dist/dream.js

@@ -3,73 +3,73 @@
 // bin/dream.ts
 import * as fs from "fs";
 import * as path from "path";
+import { fileURLToPath } from "url";
 import { createOpencode } from "@opencode-ai/sdk/v2";
 import { init } from "@vercel/dream-init";
 import { program } from "commander";
+import { $ } from "zx";
 var STOP_WORD = "<DREAM DONE>";
+var PROJECT_PROMPT_FILES = [
+  "loop-prompt.md",
+  "agent-prompt.md",
+  "system-prompt.md",
+  "prompt.md"
+];
 var SYSTEM_PROMPT = `# Dream Agent
 
 You are an autonomous agent building a project from specifications. You run across multiple iterations, each with a fresh context window. Each iteration you pick up the next chunk of work, complete it, and stop.
 
-## Environment
-
-You are running in an isolated VM. You have full control of the machine. You can:
-- Install any packages (\`npm install\`, \`apt-get\`, etc.)
-- Start servers and dev processes (\`npm run dev\`, \`python -m http.server\`, etc.)
-- Run build tools (\`npx next build\`, \`npx vite build\`, \`tsc\`, \`esbuild\`, etc.)
-- Use any framework or toolchain \u2014 Next.js, Vite, Astro, plain HTML, whatever fits the spec
-- Listen on any port, spawn background processes, modify system config
-- Read and write anywhere on the filesystem
+## Non-Negotiable Rule: Specs Are the Source of Truth
 
-There are no restrictions. Use the full power of the environment to build the best possible output. If a spec calls for a React app, scaffold it with a real bundler. If it needs server-side rendering, build it. Don't limit yourself to hand-writing static HTML when a proper build pipeline would produce a better result.
+Read and follow the specs exactly. Do not infer a different architecture than what specs require.
 
-The final output must land in \`.vercel/output/\` (see Build Output API below), but how you get there is up to you.
+If specs require a framework/runtime (for example Next.js App Router, server routes, Supabase), implement that framework/runtime in source code. Do not replace required behavior with static mock pages.
 
-## Critical: State Lives on Disk
+If a project prompt overlay file exists in \`specs/\`, treat it as additional project-specific constraints. Precedence order is:
+1. This system prompt (highest)
+2. Project prompt overlay
+3. Your own defaults (lowest)
 
-Each iteration starts with fresh context. You must:
-- Read specifications from the \`specs/\` directory in the current working directory
-- Track your progress in a \`PROGRESS.md\` file (create it on first run)
-- On each iteration, read \`PROGRESS.md\` to understand what's done and what remains
-- Update \`PROGRESS.md\` after completing each task
+When instructions conflict, obey higher precedence and explicitly note the conflict in \`PROGRESS.md\`.
 
-This ensures you can resume from any point if interrupted.
+## Environment
 
-## Workflow
+You are running in an isolated VM with full machine control. You can:
+- Install packages (\`npm install\`, \`apt-get\`, etc.)
+- Start servers/processes (\`npm run dev\`, \`docker\`, etc.)
+- Run build tools (\`npx next build\`, \`npx vite build\`, \`tsc\`, etc.)
+- Read/write filesystem and execute shell commands
 
-Each iteration follows this cycle:
+Environment variables required by the project are already injected into the runtime environment. You may inspect env vars for diagnostics, but never print secret values into persistent logs or committed files.
 
-1. **Read state**: Read all files in \`specs/\` and \`PROGRESS.md\` (if exists)
-2. **Plan**: If no \`PROGRESS.md\`, create it with a task breakdown from the specs. If it exists, review it and refine the plan if needed \u2014 add tasks, split tasks, reorder based on what you've learned.
-3. **Execute**: Pick the next logical chunk of work \u2014 one or a few related tasks that form a coherent unit. Complete them fully.
-4. **Update**: Mark completed tasks in \`PROGRESS.md\`. Add any notes that will help the next iteration.
-5. **Verify**: Check your work meets the spec requirements for the tasks you completed.
-6. **Stop or complete**: If ALL tasks are now done, output the completion signal. Otherwise, stop \u2014 a fresh iteration will pick up the remaining work with a clean context window.
+## Implementation Artifact Policy
 
-## Build Output API
+1. The deliverable is project source code that satisfies specs.
+2. For Vercel deployment, final build artifacts must conform to Build Output API in \`.vercel/output/\`.
+3. Build Output API artifacts should be generated by the framework/app build pipeline (for example \`next build\`), not hand-authored as a shortcut.
+4. If required prerequisites are missing (for example env vars, credentials, unavailable services), do not produce a static fallback. Record a blocker in \`PROGRESS.md\` and stop the iteration.
 
-Your output must use [Vercel's Build Output API](https://vercel.com/docs/build-output-api/v3).
+## Critical: State Lives on Disk
 
-### Directory Structure
+Each iteration starts with fresh context. You must:
+- Read all specifications from \`specs/\`
+- Read \`PROGRESS.md\` if present
+- If \`PROGRESS.md\` is missing, create it immediately
+- Update \`PROGRESS.md\` after completing work
 
-\`\`\`
-.vercel/output/
-\u251C\u2500\u2500 config.json      # Required: { "version": 3 }
-\u2514\u2500\u2500 static/          # Static files served from root (/)
-    \u251C\u2500\u2500 index.html
-    \u251C\u2500\u2500 styles.css
-    \u2514\u2500\u2500 ...
-\`\`\`
+This ensures resumeability across fresh context windows.
 
-### Minimal config.json
+## Workflow
 
-\`\`\`json
-{
-  "version": 3
-}
-\`\`\`
+Each iteration follows this cycle:
 
-Static files in \`.vercel/output/static/\` are served at the deployment root. Subdirectories are preserved in URLs.
+1. **Read state**: Read specs + \`PROGRESS.md\` (if present)
+2. **Plan**: If no \`PROGRESS.md\`, create task breakdown from specs. If present, refine tasks based on current state.
+3. **Preflight checks**: Validate required env vars and tool prerequisites from specs before implementation.
+4. **Execute**: Complete one coherent, meaningful chunk of work.
+5. **Update**: Mark completed tasks and note blockers/assumptions in \`PROGRESS.md\`.
+6. **Verify**: Run required checks from specs (build/test/contract checks for changed surface).
+7. **Stop or complete**: If all tasks are done, output completion signal. Otherwise stop for the next iteration.
 
 ## PROGRESS.md Format
 
@@ -79,141 +79,151 @@ Static files in \`.vercel/output/static/\` are served at the deployment root. Su
 ## Tasks
 - [x] Completed task
 - [ ] Pending task
-- [ ] Another pending task
+
+## Blockers
+- <none> or explicit blocker with reason
 
 ## Notes
-Any learnings or context for future iterations.
+Context for next iteration.
 \`\`\`
 
 ## Browser Automation
 
-You have \`agent-browser\` available for testing and verifying your work. Use it via bash commands.
-
-### Core Workflow: Snapshot + Refs
-
-\`\`\`bash
-# Navigate to a page
-agent-browser open file://$(pwd)/.vercel/output/static/index.html --allow-file-access
-
-# Get interactive elements with refs
-agent-browser snapshot -i
-# Output: - button "Submit" [ref=e1] - textbox "Email" [ref=e2] ...
-
-# Interact using refs
-agent-browser fill @e2 "test@example.com"
-agent-browser click @e1
-
-# Re-snapshot after any navigation or DOM change (refs invalidate)
-agent-browser snapshot -i
-\`\`\`
-
-### Key Commands
+Dream bootstraps \`agent-browser\` before the loop starts. Use it for UI verification.
 
-- **Navigate**: \`open <url>\`, \`back\`, \`forward\`, \`reload\`, \`close\`
-- **Interact**: \`click <ref>\`, \`fill <ref> <text>\`, \`type <ref> <text>\`, \`press <key>\`, \`select <ref> <value>\`, \`check <ref>\`, \`hover <ref>\`, \`scroll <dir> [px]\`
-- **Read**: \`snapshot -i\` (interactive elements), \`get text <ref>\`, \`get title\`, \`get url\`
-- **Wait**: \`wait <selector>\`, \`wait <ms>\`, \`wait --text "..."\`, \`wait --load networkidle\`
-- **Screenshot**: \`screenshot [path]\`, \`screenshot --full\`
-- **Debug**: \`console\`, \`errors\`, \`eval <js>\`
+Use it to test running app routes (typically localhost dev server or preview URL), not only static files.
 
-### When to Use
-
-- After building interactive features (games, forms, animations) to verify they work
-- To test that the page renders correctly and elements are present
-- To validate user interactions match spec requirements
-- To catch broken layouts, missing elements, or JavaScript errors
-
-### Tips
-
-- Always use \`--allow-file-access\` when opening \`file://\` URLs
-- Use \`snapshot -i -c\` for compact output (interactive elements, no empty containers)
-- Refs like \`@e1\` are only valid until the next navigation or DOM mutation \u2014 re-snapshot after changes
-- Use \`agent-browser errors\` and \`agent-browser console\` to check for JavaScript issues
-- Use \`screenshot\` for visual verification when the snapshot alone isn't sufficient
+Core commands:
+- Navigate: \`open <url>\`, \`back\`, \`forward\`, \`reload\`
+- Interact: \`snapshot -i\`, \`click <ref>\`, \`fill <ref> <text>\`, \`press <key>\`
+- Debug: \`errors\`, \`console\`, \`screenshot\`
 
 ## Iteration Sizing
 
-Each iteration should complete a **meaningful chunk** of work \u2014 not a single trivial file write, but a coherent unit like:
-- Scaffold the project structure and install dependencies
-- Implement a full feature or page
-- Build out a component system or styling layer
-- Wire up interactivity and test it
-
-Use your judgment. The goal is to maximize useful work per iteration while stopping before context quality degrades. When in doubt, finish the current logical unit and stop.
+Each iteration should complete a coherent unit (not trivial single-file churn), such as:
+- Scaffold required framework/runtime
+- Implement one full route/feature slice
+- Wire persistence + auth + tests for a bounded surface
 
 ## Completion
 
-**When you finish your chunk and tasks remain:** update \`PROGRESS.md\` and end your response. Do NOT output the completion signal. The next iteration will continue with fresh context.
+**If tasks remain:** update \`PROGRESS.md\` and stop. Do NOT output completion signal.
 
-**When ALL work is done**, you MUST output the completion signal. Check all of these before signaling:
-- Every task in \`PROGRESS.md\` is marked complete \`[x]\`
-- All specifications in \`specs/\` are fully implemented
-- \`.vercel/output/config.json\` exists with \`"version": 3\`
-- All required static files exist in \`.vercel/output/static/\`
+**When all work is done**, output completion signal only after all are true:
+- Every task in \`PROGRESS.md\` is complete
+- All specs in \`specs/\` are implemented
+- Required verification commands pass
+- No active blockers remain
+- Implementation artifacts are source-code-compliant with specs (not forbidden static fallback)
+- Generated deployment output conforms to Build Output API for the target deploy platform
 
 When complete, output exactly this on its own line:
 
 ${STOP_WORD}
 
-This signal is how the system knows you are finished. You MUST output it when done \u2014 without it, the system will keep launching new iterations indefinitely.`;
+Without this signal, the system keeps launching new iterations.`;
 var DEFAULT_TIMEOUT = 36e5;
 var DEFAULT_MAX_ITERATIONS = 100;
-var DEFAULT_MODEL = "vercel/anthropic/claude-opus-4.5";
+var DEFAULT_MODEL = "vercel/anthropic/claude-opus-4.6";
+var DEFAULT_BOOTSTRAP_SKILL_REPOS = [
+  { repo: "vercel-labs/agent-browser", skills: ["agent-browser"] },
+  { repo: "vercel-labs/agent-skills", skills: ["react-best-practices"] }
+];
 var dim = (s) => `\x1B[2m${s}\x1B[22m`;
 var bold = (s) => `\x1B[1m${s}\x1B[22m`;
 var green = (s) => `\x1B[32m${s}\x1B[39m`;
 var red = (s) => `\x1B[31m${s}\x1B[39m`;
 var cyan = (s) => `\x1B[36m${s}\x1B[39m`;
 var log = console.log;
+var INDENT_MAIN = "  ";
+var INDENT_LIST = "    ";
+var INDENT_SESSION = "       ";
+var INDENT_SESSION_DETAIL = "              ";
+var KEY_WIDTH = 13;
+function printLine(line = "") {
+  log(line);
+}
+function printTitle(topic) {
+  printLine(`
+${INDENT_MAIN}${bold("\u25B2 dream")} ${dim("\xB7")} ${topic}
+`);
+}
+function printKV(key, value) {
+  printLine(`${INDENT_MAIN}${dim(key.padEnd(KEY_WIDTH))}${value}`);
+}
+function printStep(message) {
+  printLine(`${INDENT_MAIN}${dim("\u25CC")} ${message}`);
+}
+function printNote(message) {
+  printLine(`${INDENT_MAIN}${dim("\xB7")} ${message}`);
+}
+function printListItem(message) {
+  printLine(`${INDENT_LIST}${dim("\xB7")} ${message}`);
+}
+function printSuccess(message) {
+  printLine(`${INDENT_MAIN}${green("\u25CF")} ${message}`);
+}
+function printError(message) {
+  printLine(`${INDENT_MAIN}${red("\u2717")} ${message}`);
+}
+function printAdded(message) {
+  printLine(`${INDENT_MAIN}${green("+")} ${message}`);
+}
+function printSession(message) {
+  printLine(`${INDENT_SESSION}${message}`);
+}
+function printSessionDim(message) {
+  printSession(dim(message));
+}
+function printSessionError(message) {
+  printSession(`${red("\u2717")} ${message}`);
+}
 program.name("dream").description("Run OpenCode in a loop until specs are complete").version("0.1.0").option("-d, --dir <directory>", "Working directory", ".");
 program.command("init").description("Initialize a new dream project").action(() => {
   const workDir = path.resolve(program.opts().dir);
-  log(`
-  ${bold("\u25B2 dream")} ${dim("\xB7 init")}
-`);
+  printTitle("init");
   const result = init({ dir: workDir, version: "^0.2.1" });
   if (result.specsCreated) {
-    log(`  ${green("+")} specs/2048.md`);
+    printAdded("specs/2048.md");
   } else {
-    log(`  ${dim("\xB7")} specs/ ${dim("already exists")}`);
+    printNote(`specs/ ${dim("already exists")}`);
   }
   if (result.packageJsonCreated) {
-    log(`  ${green("+")} package.json`);
+    printAdded("package.json");
   } else {
-    log(`  ${dim("\xB7")} package.json ${dim("already exists")}`);
+    printNote(`package.json ${dim("already exists")}`);
   }
-  log(`
-  Run ${cyan("pnpm install")} then ${cyan("dream")} to start
-`);
+  printLine(
+    `
+${INDENT_MAIN}Run ${cyan("pnpm install")} then ${cyan("dream")} to start
+`
+  );
 });
 program.command("config").description("Show project configuration and specs").action(() => {
   const workDir = path.resolve(program.opts().dir);
   const specsDir = path.join(workDir, "specs");
-  log(`
-  ${bold("\u25B2 dream")} ${dim("\xB7 config")}
-`);
-  log(`  ${dim("dir")}         ${workDir}`);
-  log(`  ${dim("timeout")}     ${formatTime(DEFAULT_TIMEOUT)}`);
-  log(`  ${dim("max")}         ${DEFAULT_MAX_ITERATIONS} iterations`);
+  printTitle("config");
+  printKV("dir", workDir);
+  printKV("timeout", formatTime(DEFAULT_TIMEOUT));
+  printKV("max", `${DEFAULT_MAX_ITERATIONS} iterations`);
   if (!fs.existsSync(specsDir)) {
-    log(`
-  ${red("\u2717")} specs/ not found
-`);
+    printError("specs/ not found");
+    printLine();
     return;
   }
   const specFiles = fs.readdirSync(specsDir).filter((f) => f.endsWith(".md"));
-  log(`
-  ${dim("specs")} ${dim(`(${specFiles.length})`)}`);
+  printLine(
+    `
+${INDENT_MAIN}${dim("specs")} ${dim(`(${specFiles.length})`)}`
+  );
   for (const file of specFiles) {
-    log(`    ${dim("\xB7")} ${file}`);
+    printListItem(file);
   }
-  log("");
+  printLine();
 });
 program.command("models").description("List available models and check provider auth").action(async () => {
-  log(`
-  ${bold("\u25B2 dream")} ${dim("\xB7 models")}
-`);
-  log(`  ${dim("\u25CC")} Starting OpenCode...`);
+  printTitle("models");
+  printStep("Starting OpenCode...");
   const { client, server } = await createOpencode({
     port: 0,
     config: { enabled_providers: ["vercel"] }
@@ -221,8 +231,8 @@ program.command("models").description("List available models and check provider
   try {
     const res = await client.provider.list();
     if (res.error) {
-      log(`  ${red("\u2717")} Failed to list providers
-`);
+      printError("Failed to list providers");
+      printLine();
       return;
     }
     const { all, connected } = res.data;
@@ -230,34 +240,32 @@ program.command("models").description("List available models and check provider
       const isConnected = connected.includes(provider.id);
       const icon = isConnected ? green("\u25CF") : red("\u25CB");
       const npm = provider.npm ? dim(` npm:${provider.npm}`) : "";
-      log(
-        `  ${icon} ${bold(provider.name)} ${dim(`(${provider.id})`)}${npm}`
+      printLine(
+        `${INDENT_MAIN}${icon} ${bold(provider.name)} ${dim(`(${provider.id})`)}${npm}`
       );
       const models = Object.entries(provider.models);
       for (const [id, model] of models) {
         const name = model.name ?? id;
-        log(`    ${dim("\xB7")} ${provider.id}/${id} ${dim(name)}`);
+        printListItem(`${provider.id}/${id} ${dim(name)}`);
       }
       if (models.length === 0) {
-        log(`    ${dim("no models")}`);
+        printLine(`${INDENT_LIST}${dim("no models")}`);
       }
-      log("");
+      printLine();
     }
-    log(
-      `  ${dim("connected")}   ${connected.length ? connected.join(", ") : "none"}
-`
-    );
+    printKV("connected", connected.length ? connected.join(", ") : "none");
+    printLine();
   } finally {
     server.close();
     process.exit(0);
   }
 });
-program.option("-m, --model <model>", "Model to use (provider/model format)").option("-t, --timeout <ms>", "Timeout in milliseconds").option("-i, --max-iterations <n>", "Maximum iterations").option("-v, --verbose", "Verbose output").action(async (opts) => {
+program.option("-m, --model <model>", "Model to use (provider/model format)").option("-t, --timeout <ms>", "Timeout in milliseconds").option("-i, --max-iterations <n>", "Maximum iterations").option("-v, --verbose", "Verbose output").option("--skip-bootstrap", "Skip runtime bootstrap").action(async (opts) => {
   const workDir = path.resolve(opts.dir);
   const specsDir = path.join(workDir, "specs");
   if (!fs.existsSync(specsDir)) {
-    log(`
-  ${red("\u2717")} specs/ not found in ${workDir}
+    printLine(`
+${INDENT_MAIN}${red("\u2717")} specs/ not found in ${workDir}
 `);
     process.exit(1);
   }
@@ -266,15 +274,38 @@ program.option("-m, --model <model>", "Model to use (provider/model format)").op
   const verbose = opts.verbose ?? false;
   const model = opts.model ?? process.env.DREAM_MODEL ?? DEFAULT_MODEL;
   const title = path.basename(workDir);
-  log(`
-  ${bold("\u25B2 dream")} ${dim("\xB7")} ${title}
-`);
-  log(`  ${dim("dir")}         ${workDir}`);
-  log(`  ${dim("model")}       ${model || dim("default")}`);
-  log(`  ${dim("timeout")}     ${formatTime(timeout)}`);
-  log(`  ${dim("max")}         ${maxIterations} iterations
-`);
-  log(`  ${dim("\u25CC")} Starting OpenCode...`);
+  const projectPrompt = loadProjectPrompt(specsDir);
+  const effectivePrompt = projectPrompt ? `${SYSTEM_PROMPT}
+
+## Project Prompt Overlay (${projectPrompt.file})
+
+${projectPrompt.content}` : SYSTEM_PROMPT;
+  printTitle(title);
+  printKV("dir", workDir);
+  printKV("model", model || dim("default"));
+  printKV("timeout", formatTime(timeout));
+  printKV("max", `${maxIterations} iterations`);
+  printLine();
+  if (projectPrompt) {
+    printKV("overlay", projectPrompt.file);
+  }
+  if (opts.skipBootstrap) {
+    printKV("bootstrap", dim("skipped"));
+  }
+  if (!opts.skipBootstrap) {
+    try {
+      await bootstrapRuntime(workDir);
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "bootstrap failed";
+      printLine(
+        `
+${INDENT_MAIN}${red("\u2717")} Runtime bootstrap failed: ${message}
+`
+      );
+      process.exit(1);
+    }
+  }
+  printStep("Starting OpenCode...");
   const oidcToken = process.env.VERCEL_OIDC_TOKEN;
   const { client, server } = await createOpencode({
     port: 0,
@@ -307,25 +338,23 @@ program.option("-m, --model <model>", "Model to use (provider/model format)").op
       enabled_providers: ["vercel"]
     }
   });
-  log(`  ${green("\u25CF")} OpenCode ready`);
+  printSuccess("OpenCode ready");
   const providerId = model?.split("/")[0];
   if (providerId) {
     const providers = await client.provider.list();
     if (providers.error) {
-      log(`  ${red("\u2717")} Failed to list providers
-`);
+      printError("Failed to list providers");
+      printLine();
       server.close();
       process.exit(1);
     }
     const connected = providers.data.connected ?? [];
     if (!connected.includes(providerId)) {
-      log(`  ${red("\u2717")} Provider ${bold(providerId)} is not connected`);
-      log(
-        `  ${dim("connected")}   ${connected.length ? connected.join(", ") : "none"}`
-      );
-      log(
+      printError(`Provider ${bold(providerId)} is not connected`);
+      printKV("connected", connected.length ? connected.join(", ") : "none");
+      printLine(
         `
-  Run ${cyan("opencode")} and authenticate the ${bold(providerId)} provider
+${INDENT_MAIN}Run ${cyan("opencode")} and authenticate the ${bold(providerId)} provider
 `
       );
       server.close();
@@ -334,21 +363,20 @@ program.option("-m, --model <model>", "Model to use (provider/model format)").op
     const provider = providers.data.all.find((p) => p.id === providerId);
     const modelId = model.split("/").slice(1).join("/");
     if (provider && modelId && !provider.models[modelId]) {
-      log(
-        `  ${red("\u2717")} Model ${bold(modelId)} not found in ${bold(providerId)}`
-      );
+      printError(`Model ${bold(modelId)} not found in ${bold(providerId)}`);
       const available = Object.keys(provider.models);
       if (available.length) {
-        log(
-          `  ${dim("available")}   ${available.slice(0, 5).join(", ")}${available.length > 5 ? ` (+${available.length - 5} more)` : ""}`
+        printKV(
+          "available",
+          `${available.slice(0, 5).join(", ")}${available.length > 5 ? ` (+${available.length - 5} more)` : ""}`
         );
       }
-      log("");
+      printLine();
       server.close();
       process.exit(1);
     }
-    log(`  ${green("\u25CF")} Provider ${bold(providerId)} connected
-`);
+    printSuccess(`Provider ${bold(providerId)} connected`);
+    printLine();
   }
   const cleanup = () => {
     server.close();
@@ -362,42 +390,49 @@ program.option("-m, --model <model>", "Model to use (provider/model format)").op
     while (iteration < maxIterations) {
       const elapsed = Date.now() - startTime;
       if (elapsed >= timeout) {
-        log(`
-  ${red("\u2717")} Timeout after ${formatTime(elapsed)}
-`);
+        printLine(
+          `
+${INDENT_MAIN}${red("\u2717")} Timeout after ${formatTime(elapsed)}
+`
+        );
         process.exit(1);
       }
       iteration++;
       const iterStart = Date.now();
-      log(`  ${cyan(`[${iteration}]`)} Running session...`);
-      const result = await runSession(client, title, SYSTEM_PROMPT, verbose);
+      printLine(`${INDENT_MAIN}${cyan(`[${iteration}]`)} Running session...`);
+      const result = await runSession(
+        client,
+        title,
+        effectivePrompt,
+        verbose
+      );
       const iterElapsed = Date.now() - iterStart;
       if (result === "done") {
-        log(
-          `  ${cyan(`[${iteration}]`)} ${green("\u2713")} Done ${dim(`(${formatTime(iterElapsed)})`)}`
+        printLine(
+          `${INDENT_MAIN}${cyan(`[${iteration}]`)} ${green("\u2713")} Done ${dim(`(${formatTime(iterElapsed)})`)}`
         );
-        log(
+        printLine(
           `
-  ${green("\u2713")} Completed in ${bold(String(iteration))} iteration(s) ${dim(`(${formatTime(Date.now() - startTime)})`)}
+${INDENT_MAIN}${green("\u2713")} Completed in ${bold(String(iteration))} iteration(s) ${dim(`(${formatTime(Date.now() - startTime)})`)}
 `
         );
         process.exit(0);
       }
       if (result === "error") {
-        log(
+        printLine(
           `
-  ${red("\u2717")} Session failed after ${bold(String(iteration))} iteration(s) ${dim(`(${formatTime(Date.now() - startTime)})`)}
+${INDENT_MAIN}${red("\u2717")} Session failed after ${bold(String(iteration))} iteration(s) ${dim(`(${formatTime(Date.now() - startTime)})`)}
 `
         );
         process.exit(1);
       }
-      log(
-        `  ${cyan(`[${iteration}]`)} ${dim(`${formatTime(iterElapsed)} \xB7 continuing...`)}
+      printLine(
+        `${INDENT_MAIN}${cyan(`[${iteration}]`)} ${dim(`${formatTime(iterElapsed)} \xB7 continuing...`)}
 `
       );
     }
-    log(`
-  ${red("\u2717")} Max iterations reached
+    printLine(`
+${INDENT_MAIN}${red("\u2717")} Max iterations reached
 `);
     process.exit(1);
   } finally {
@@ -405,7 +440,7 @@ program.option("-m, --model <model>", "Model to use (provider/model format)").op
   }
 });
 async function runSession(client, title, systemPrompt, verbose) {
-  log(`       ${dim("creating session...")}`);
+  printSessionDim("creating session...");
   const sessionResponse = await client.session.create({
     title: `Dream: ${title}`
   });
@@ -415,18 +450,16 @@ async function runSession(client, title, systemPrompt, verbose) {
     );
   }
   const sessionId = sessionResponse.data.id;
-  log(`       ${dim(`session ${sessionId.slice(0, 8)}`)}`);
-  log(`       ${dim("subscribing to events...")}`);
+  printSessionDim(`session ${sessionId.slice(0, 8)}`);
+  printSessionDim("subscribing to events...");
   const events = await client.event.subscribe();
-  log(`       ${dim("sending prompt...")}`);
+  printSessionDim("sending prompt...");
   const promptResponse = await client.session.promptAsync({
     sessionID: sessionId,
     parts: [{ type: "text", text: systemPrompt }]
   });
   if (promptResponse.error) {
-    log(
-      `       ${red("\u2717")} prompt error: ${JSON.stringify(promptResponse.error)}`
-    );
+    printSessionError(`prompt error: ${JSON.stringify(promptResponse.error)}`);
     return "error";
   }
   let responseText = "";
@@ -436,16 +469,15 @@ async function runSession(client, title, systemPrompt, verbose) {
   let totalTokensOut = 0;
   const seenTools = /* @__PURE__ */ new Set();
   let lastOutput = "none";
-  const pad = "       ";
   for await (const event of events.stream) {
     const props = event.properties;
     if (verbose) {
       const sid = props.sessionID ? props.sessionID.slice(0, 8) : "global";
-      log(dim(`       event: ${event.type} [${sid}]`));
+      printSessionDim(`event: ${event.type} [${sid}]`);
       if (event.type !== "server.connected") {
-        log(
+        printLine(
           dim(
-            `              ${JSON.stringify(event.properties).slice(0, 200)}`
+            `${INDENT_SESSION_DETAIL}${JSON.stringify(event.properties).slice(0, 200)}`
           )
         );
       }
@@ -460,18 +492,18 @@ async function runSession(client, title, systemPrompt, verbose) {
         responseText += delta;
         if (lastOutput === "tool") process.stdout.write("\n");
         const indented = delta.replace(/\n/g, `
-${pad}`);
+${INDENT_SESSION}`);
         process.stdout.write(
-          lastOutput !== "text" ? `${pad}${dim(indented)}` : dim(indented)
+          lastOutput !== "text" ? `${INDENT_SESSION}${dim(indented)}` : dim(indented)
         );
         lastOutput = "text";
       }
       if (part.type === "reasoning" && delta) {
         if (lastOutput === "tool") process.stdout.write("\n");
         const indented = delta.replace(/\n/g, `
-${pad}`);
+${INDENT_SESSION}`);
         process.stdout.write(
-          lastOutput !== "text" ? `${pad}${dim(indented)}` : dim(indented)
+          lastOutput !== "text" ? `${INDENT_SESSION}${dim(indented)}` : dim(indented)
         );
         lastOutput = "text";
       }
@@ -484,14 +516,14 @@ ${pad}`);
           toolCalls++;
           if (lastOutput === "text") process.stdout.write("\n\n");
           const context = toolContext(toolName, state.input) ?? state.title;
-          log(
-            `${pad}${dim("\u25B8")} ${toolName}${context ? dim(` ${context}`) : ""}`
+          printSession(
+            `${dim("\u25B8")} ${toolName}${context ? dim(` ${context}`) : ""}`
           );
           lastOutput = "tool";
         }
         if (state.status === "error") {
           if (lastOutput === "text") process.stdout.write("\n");
-          log(`${pad}${red("\u2717")} ${toolName}: ${state.error}`);
+          printSession(`${red("\u2717")} ${toolName}: ${state.error}`);
           lastOutput = "tool";
         }
       }
@@ -507,7 +539,7 @@ ${pad}`);
       if (file) {
         if (lastOutput === "text") process.stdout.write("\n");
         const relative = file.replace(`${process.cwd()}/`, "");
-        log(`${pad}${green("\u270E")} ${relative}`);
+        printSession(`${green("\u270E")} ${relative}`);
         lastOutput = "tool";
       }
     }
@@ -515,7 +547,7 @@ ${pad}`);
       const errProps = event.properties;
       const msg = errProps.error?.data?.message ?? errProps.error?.name ?? "session error";
       if (lastOutput === "text") process.stdout.write("\n");
-      log(`${pad}${red("\u2717")} ${msg}`);
+      printSession(`${red("\u2717")} ${msg}`);
       return "error";
     }
     if (event.type === "session.idle") {
@@ -525,9 +557,9 @@ ${pad}`);
   if (lastOutput === "text") process.stdout.write("\n");
   const tokens = `${formatTokens(totalTokensIn)}\u2192${formatTokens(totalTokensOut)}`;
   const cost = totalCost > 0 ? ` \xB7 $${totalCost.toFixed(2)}` : "";
-  log(`${pad}${dim(`${toolCalls} tools \xB7 ${tokens}${cost}`)}`);
+  printSessionDim(`${toolCalls} tools \xB7 ${tokens}${cost}`);
   if (responseText.length === 0) {
-    log(`${pad}${red("\u2717")} No response from model`);
+    printSessionError("No response from model");
     return "error";
   }
   return responseText.includes(STOP_WORD) ? "done" : "continue";
@@ -565,4 +597,75 @@ function toolContext(tool, input) {
       return void 0;
   }
 }
+function loadProjectPrompt(specsDir) {
+  for (const file of PROJECT_PROMPT_FILES) {
+    const fullPath = path.join(specsDir, file);
+    if (!fs.existsSync(fullPath)) continue;
+    const content = fs.readFileSync(fullPath, "utf8").trim();
+    if (!content) continue;
+    return { file, content };
+  }
+  return null;
+}
+function packageRootFromScript() {
+  const scriptPath = fileURLToPath(import.meta.url);
+  return path.resolve(path.dirname(scriptPath), "..");
+}
+function prependLocalBinsToPath(workDir) {
+  const packageRoot = packageRootFromScript();
+  const binPaths = [
+    path.join(workDir, "node_modules", ".bin"),
+    path.join(packageRoot, "node_modules", ".bin")
+  ];
+  const currentPath = process.env.PATH ?? "";
+  process.env.PATH = [...binPaths, currentPath].filter((entry) => Boolean(entry)).join(path.delimiter);
+}
+async function commandExists(command) {
+  try {
+    await $`command -v ${command}`;
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function installSkills(skillRepos) {
+  for (const entry of skillRepos) {
+    const skills = entry.skills?.filter((skill) => skill.trim().length > 0) ?? [];
+    if (skills.length === 0) {
+      printNote(`Installing skills from ${entry.repo}...`);
+      await $`npx skills@latest add ${entry.repo} --yes --global`;
+      continue;
+    }
+    for (const skill of skills) {
+      printNote(`Installing skill ${skill} from ${entry.repo}...`);
+      await $`npx skills@latest add ${entry.repo} --skill ${skill} --yes --global`;
+    }
+  }
+}
+async function bootstrapRuntime(workDir) {
+  prependLocalBinsToPath(workDir);
+  printStep("Bootstrapping runtime tools...");
+  let hasAgentBrowser = await commandExists("agent-browser");
+  if (!hasAgentBrowser) {
+    printNote("Installing agent-browser globally...");
+    await $`npm install --global agent-browser`;
+    hasAgentBrowser = await commandExists("agent-browser");
+  }
+  printNote("Installing browser runtime...");
+  if (hasAgentBrowser) {
+    await $`agent-browser install`;
+  } else {
+    printNote("Falling back to npx for agent-browser install...");
+    await $`npx --yes agent-browser install`;
+  }
+  if (process.env.DREAM_SKIP_SKILL_SETUP === "1") {
+    printNote("Skipping skill setup (DREAM_SKIP_SKILL_SETUP=1)");
+    return;
+  }
+  if (DEFAULT_BOOTSTRAP_SKILL_REPOS.length === 0) {
+    printNote("No bootstrap skills configured");
+    return;
+  }
+  await installSkills(DEFAULT_BOOTSTRAP_SKILL_REPOS);
+}
 await program.parseAsync();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vercel/dream",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "description": "A CLI that runs OpenCode in a loop until specs are complete",
   "type": "module",
   "bin": {
@@ -12,9 +12,9 @@
   "dependencies": {
     "@ai-sdk/gateway": "^3.0.39",
     "@opencode-ai/sdk": "^1.1.0",
-    "agent-browser": ">=0.9.0",
     "commander": "^12.0.0",
     "opencode-ai": ">=1.0.0",
+    "zx": "^8.8.4",
     "@vercel/dream-init": "0.2.2"
   },
   "devDependencies": {