@vercel/dream 0.2.0 → 0.2.1

package/README.md

@@ -0,0 +1,133 @@
+# @vercel/dream
+
+Write a spec. Get a deployed app.
+
+Dream is a CLI that turns markdown specifications into fully built applications on Vercel. It runs an AI agent in a loop, reading your specs, writing code, and producing a deployable build — no scaffolding, no boilerplate, no manual steps.
+
+```
+pnpm add @vercel/dream
+```
+
+## How it works
+
+1. You write a specification in `specs/`
+2. `dream` reads it, plans the work, and starts building
+3. The agent loops — reading, coding, verifying — until every requirement is met
+4. Output lands in `.vercel/output/` ready to deploy
+
+```
+▲ dream · my-app
+
+  dir         /Users/you/code/my-app
+  model       vercel/anthropic/claude-opus-4.5
+  timeout     60.0m
+  max         100 iterations
+
+  ● OpenCode ready
+  ● Provider vercel connected
+
+  [1] Running session...
+       ▸ read specs/app.md
+       ▸ write PROGRESS.md
+
+       Starting with the HTML structure and core game logic.
+
+       ▸ write .vercel/output/config.json
+       ▸ write .vercel/output/static/index.html
+       ✎ .vercel/output/static/index.html
+       ▸ write .vercel/output/static/styles.css
+       ✎ .vercel/output/static/styles.css
+       ▸ write .vercel/output/static/app.js
+       ✎ .vercel/output/static/app.js
+
+       All tasks complete. Verifying output structure.
+
+       ▸ glob .vercel/output/**/*
+       12 tools · 48.2k→3.1k · $0.12
+  [1] ✓ Done (34.2s)
+
+  ✓ Completed in 1 iteration(s) (34.2s)
+```
+
+## Quick start
+
+```bash
+# Scaffold a new project
+dream init my-app
+cd my-app
+
+# Write your spec
+cat > specs/app.md << 'EOF'
+# Landing Page
+
+A minimal dark-themed landing page with:
+- Hero section with animated gradient title
+- Feature grid (3 columns)
+- Email signup form
+EOF
+
+# Build it
+pnpm install
+dream
+```
+
+## Specs
+
+Specs are markdown files in the `specs/` directory. Write what you want — the more detail, the better the output. The agent reads every `.md` file in the directory.
+
+```
+specs/
+├── app.md           # Main application spec
+├── design.md        # Visual design requirements
+└── accessibility.md # A11y requirements
+```
+
+## Output
+
+Dream produces [Vercel Build Output API v3](https://vercel.com/docs/build-output-api/v3) — static files in `.vercel/output/static/` with a `config.json`. Deploy to Vercel or serve anywhere.
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `dream` | Build the project from specs |
+| `dream init` | Scaffold a new dream project |
+| `dream models` | List available models and auth status |
+| `dream config` | Show project configuration |
+
+## Options
+
+| Flag | Description | Default |
+|------|-------------|---------|
+| `-m, --model` | Model in `provider/model` format | `vercel/anthropic/claude-opus-4.5` |
+| `-t, --timeout` | Timeout in milliseconds | `3600000` (60m) |
+| `-i, --max-iterations` | Maximum agent loops | `100` |
+| `-v, --verbose` | Show all events | `false` |
+| `-d, --dir` | Working directory | `.` |
+
+## Authentication
+
+Dream uses the [Vercel AI Gateway](https://vercel.com/ai-gateway). Authenticate with either:
+
+**OIDC token** (Vercel deployments & local dev):
+```bash
+vercel env pull  # writes .env.local with VERCEL_OIDC_TOKEN
+source .env.local
+dream
+```
+
+**API key**:
+```bash
+export VERCEL_API_KEY=your_key
+dream
+```
+
+## Requirements
+
+- [OpenCode](https://opencode.ai) installed and available on PATH
+- Node.js 18+
+- A Vercel account with AI Gateway access
+
+## License
+
+MIT

package/dist/dream.js

@@ -0,0 +1,509 @@
+#!/usr/bin/env node
+
+// bin/dream.ts
+import * as fs from "fs";
+import * as path from "path";
+import { createOpencode } from "@opencode-ai/sdk";
+import { program } from "commander";
+var STOP_WORD = "<DREAM DONE>";
+var SYSTEM_PROMPT = `# Dream Agent
+
+You are an autonomous agent building a project from specifications. You run in a loop until completion.
+
+## Critical: State Lives on Disk
+
+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
+
+This ensures you can resume from any point if interrupted.
+
+## Workflow
+
+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
+3. **Execute**: Work on the next incomplete task
+4. **Update**: Mark the task complete in \`PROGRESS.md\`
+5. **Verify**: Check your work meets the spec requirements
+6. **Repeat or complete**: If tasks remain, continue. If all done, output completion signal.
+
+## Build Output API
+
+Your output must use [Vercel's Build Output API](https://vercel.com/docs/build-output-api/v3).
+
+### Directory Structure
+
+\`\`\`
+.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 ...
+\`\`\`
+
+### Minimal config.json
+
+\`\`\`json
+{
+  "version": 3
+}
+\`\`\`
+
+Static files in \`.vercel/output/static/\` are served at the deployment root. Subdirectories are preserved in URLs.
+
+## PROGRESS.md Format
+
+\`\`\`markdown
+# Progress
+
+## Tasks
+- [x] Completed task
+- [ ] Pending task
+- [ ] Another pending task
+
+## Notes
+Any learnings or context for future iterations.
+\`\`\`
+
+## Completion
+
+**Only output the completion signal when ALL of the following are true:**
+- 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 complete, output exactly:
+
+${STOP_WORD}
+
+Do NOT output this signal if any work remains. Continue iterating until the specs are fully met.`;
+var DEFAULT_TIMEOUT = 36e5;
+var DEFAULT_MAX_ITERATIONS = 100;
+var DEFAULT_MODEL = "vercel/anthropic/claude-opus-4.5";
+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;
+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);
+  const specsDir = path.join(workDir, "specs");
+  const packageJsonPath = path.join(workDir, "package.json");
+  log(`
+  ${bold("\u25B2 dream")} ${dim("\xB7 init")}
+`);
+  if (!fs.existsSync(workDir)) {
+    fs.mkdirSync(workDir, { recursive: true });
+  }
+  if (!fs.existsSync(specsDir)) {
+    fs.mkdirSync(specsDir);
+    fs.writeFileSync(
+      path.join(specsDir, "sample.md"),
+      "# Sample Spec\n\n## Context\n\nDescribe what you want to build here.\n\n## Tasks\n\n- [ ] First task\n- [ ] Second task\n"
+    );
+    log(`  ${green("+")} specs/sample.md`);
+  } else {
+    log(`  ${dim("\xB7")} specs/ ${dim("already exists")}`);
+  }
+  if (!fs.existsSync(packageJsonPath)) {
+    const pkg = {
+      name: path.basename(workDir),
+      version: "0.1.0",
+      private: true,
+      scripts: { build: "dream" },
+      dependencies: { "@vercel/dream": "^0.1.0" }
+    };
+    fs.writeFileSync(packageJsonPath, `${JSON.stringify(pkg, null, "	")}
+`);
+    log(`  ${green("+")} package.json`);
+  } else {
+    log(`  ${dim("\xB7")} package.json ${dim("already exists")}`);
+  }
+  log(`
+  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`);
+  if (!fs.existsSync(specsDir)) {
+    log(`
+  ${red("\u2717")} specs/ not found
+`);
+    return;
+  }
+  const specFiles = fs.readdirSync(specsDir).filter((f) => f.endsWith(".md"));
+  log(`
+  ${dim("specs")} ${dim(`(${specFiles.length})`)}`);
+  for (const file of specFiles) {
+    log(`    ${dim("\xB7")} ${file}`);
+  }
+  log("");
+});
+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...`);
+  const { client, server } = await createOpencode({
+    port: 0,
+    config: { enabled_providers: ["vercel"] }
+  });
+  try {
+    const res = await client.provider.list();
+    if (res.error) {
+      log(`  ${red("\u2717")} Failed to list providers
+`);
+      return;
+    }
+    const { all, connected } = res.data;
+    for (const provider of all) {
+      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}`
+      );
+      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)}`);
+      }
+      if (models.length === 0) {
+        log(`    ${dim("no models")}`);
+      }
+      log("");
+    }
+    log(
+      `  ${dim("connected")}   ${connected.length ? connected.join(", ") : "none"}
+`
+    );
+  } 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) => {
+  const workDir = path.resolve(opts.dir);
+  const specsDir = path.join(workDir, "specs");
+  if (!fs.existsSync(specsDir)) {
+    log(`
+  ${red("\u2717")} specs/ not found in ${workDir}
+`);
+    process.exit(1);
+  }
+  const timeout = opts.timeout ? Number.parseInt(opts.timeout, 10) : DEFAULT_TIMEOUT;
+  const maxIterations = opts.maxIterations ? Number.parseInt(opts.maxIterations, 10) : DEFAULT_MAX_ITERATIONS;
+  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 oidcToken = process.env.VERCEL_OIDC_TOKEN;
+  const { client, server } = await createOpencode({
+    port: 0,
+    config: {
+      model,
+      permission: {
+        edit: "allow",
+        bash: "allow",
+        webfetch: "allow",
+        doom_loop: "allow",
+        external_directory: "allow"
+      },
+      provider: {
+        vercel: {
+          env: ["VERCEL_API_KEY", "VERCEL_OIDC_TOKEN"],
+          ...oidcToken && {
+            options: {
+              apiKey: oidcToken,
+              headers: {
+                "ai-gateway-auth-method": "oidc"
+              }
+            }
+          }
+        }
+      },
+      enabled_providers: ["vercel"]
+    }
+  });
+  log(`  ${green("\u25CF")} 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
+`);
+      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(
+        `
+  Run ${cyan("opencode")} and authenticate the ${bold(providerId)} provider
+`
+      );
+      server.close();
+      process.exit(1);
+    }
+    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)}`
+      );
+      const available = Object.keys(provider.models);
+      if (available.length) {
+        log(
+          `  ${dim("available")}   ${available.slice(0, 5).join(", ")}${available.length > 5 ? ` (+${available.length - 5} more)` : ""}`
+        );
+      }
+      log("");
+      server.close();
+      process.exit(1);
+    }
+    log(`  ${green("\u25CF")} Provider ${bold(providerId)} connected
+`);
+  }
+  const cleanup = () => {
+    server.close();
+    process.exit(1);
+  };
+  process.on("SIGINT", cleanup);
+  process.on("SIGTERM", cleanup);
+  const startTime = Date.now();
+  let iteration = 0;
+  try {
+    while (iteration < maxIterations) {
+      const elapsed = Date.now() - startTime;
+      if (elapsed >= timeout) {
+        log(`
+  ${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);
+      const iterElapsed = Date.now() - iterStart;
+      if (result === "done") {
+        log(
+          `  ${cyan(`[${iteration}]`)} ${green("\u2713")} Done ${dim(`(${formatTime(iterElapsed)})`)}`
+        );
+        log(
+          `
+  ${green("\u2713")} Completed in ${bold(String(iteration))} iteration(s) ${dim(`(${formatTime(Date.now() - startTime)})`)}
+`
+        );
+        process.exit(0);
+      }
+      if (result === "error") {
+        log(
+          `
+  ${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...`)}
+`
+      );
+    }
+    log(`
+  ${red("\u2717")} Max iterations reached
+`);
+    process.exit(1);
+  } finally {
+    server.close();
+  }
+});
+async function runSession(client, title, systemPrompt, verbose) {
+  log(`       ${dim("creating session...")}`);
+  const sessionResponse = await client.session.create({
+    body: { title: `Dream: ${title}` }
+  });
+  if (sessionResponse.error) {
+    throw new Error(
+      `Failed to create session: ${JSON.stringify(sessionResponse.error.errors)}`
+    );
+  }
+  const sessionId = sessionResponse.data.id;
+  log(`       ${dim(`session ${sessionId.slice(0, 8)}`)}`);
+  log(`       ${dim("subscribing to events...")}`);
+  const events = await client.event.subscribe();
+  log(`       ${dim("sending prompt...")}`);
+  const promptResponse = await client.session.promptAsync({
+    path: { id: sessionId },
+    body: {
+      parts: [{ type: "text", text: systemPrompt }]
+    }
+  });
+  if (promptResponse.error) {
+    log(
+      `       ${red("\u2717")} prompt error: ${JSON.stringify(promptResponse.error)}`
+    );
+    return "error";
+  }
+  let responseText = "";
+  let toolCalls = 0;
+  let totalCost = 0;
+  let totalTokensIn = 0;
+  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}]`));
+      if (event.type !== "server.connected") {
+        log(
+          dim(
+            `              ${JSON.stringify(event.properties).slice(0, 200)}`
+          )
+        );
+      }
+    }
+    if (props.sessionID && props.sessionID !== sessionId) {
+      continue;
+    }
+    if (event.type === "message.part.updated") {
+      const { part } = event.properties;
+      const delta = event.properties.delta;
+      if (part.type === "text" && delta) {
+        responseText += delta;
+        if (lastOutput === "tool") process.stdout.write("\n");
+        const indented = delta.replace(/\n/g, `
+${pad}`);
+        process.stdout.write(
+          lastOutput !== "text" ? `${pad}${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}`);
+        process.stdout.write(
+          lastOutput !== "text" ? `${pad}${dim(indented)}` : dim(indented)
+        );
+        lastOutput = "text";
+      }
+      if (part.type === "tool") {
+        const callID = part.callID;
+        const toolName = part.tool;
+        const state = part.state;
+        if (state.status === "running" && !seenTools.has(callID)) {
+          seenTools.add(callID);
+          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}`) : ""}`
+          );
+          lastOutput = "tool";
+        }
+        if (state.status === "error") {
+          if (lastOutput === "text") process.stdout.write("\n");
+          log(`${pad}${red("\u2717")} ${toolName}: ${state.error}`);
+          lastOutput = "tool";
+        }
+      }
+      if (part.type === "step-finish") {
+        const step = part;
+        totalCost += step.cost ?? 0;
+        totalTokensIn += step.tokens?.input ?? 0;
+        totalTokensOut += step.tokens?.output ?? 0;
+      }
+    }
+    if (event.type === "file.edited") {
+      const file = event.properties.file;
+      if (file) {
+        if (lastOutput === "text") process.stdout.write("\n");
+        const relative = file.replace(`${process.cwd()}/`, "");
+        log(`${pad}${green("\u270E")} ${relative}`);
+        lastOutput = "tool";
+      }
+    }
+    if (event.type === "session.error") {
+      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}`);
+      return "error";
+    }
+    if (event.type === "session.idle") {
+      break;
+    }
+  }
+  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}`)}`);
+  if (responseText.length === 0) {
+    log(`${pad}${red("\u2717")} No response from model`);
+    return "error";
+  }
+  return responseText.includes(STOP_WORD) ? "done" : "continue";
+}
+function formatTime(ms) {
+  if (ms < 1e3) return `${ms}ms`;
+  if (ms < 6e4) return `${(ms / 1e3).toFixed(1)}s`;
+  return `${(ms / 6e4).toFixed(1)}m`;
+}
+function formatTokens(n) {
+  if (n < 1e3) return `${n}`;
+  if (n < 1e6) return `${(n / 1e3).toFixed(1)}k`;
+  return `${(n / 1e6).toFixed(1)}M`;
+}
+function toolContext(tool, input) {
+  if (!input) return void 0;
+  const filePath = input.filePath;
+  const rel = filePath?.replace(`${process.cwd()}/`, "");
+  switch (tool) {
+    case "read":
+    case "write":
+    case "edit":
+      return rel;
+    case "bash": {
+      const cmd = input.command;
+      if (!cmd) return void 0;
+      return cmd.length > 60 ? `${cmd.slice(0, 60)}\u2026` : cmd;
+    }
+    case "glob":
+    case "grep":
+      return input.pattern;
+    case "fetch":
+      return input.url;
+    default:
+      return void 0;
+  }
+}
+await program.parseAsync();

package/package.json

@@ -1,23 +1,24 @@
 {
 	"name": "@vercel/dream",
-	"version": "0.2.0",
+	"version": "0.2.1",
 	"description": "A CLI that runs OpenCode in a loop until specs are complete",
 	"type": "module",
 	"bin": {
-		"dream": "./bin/dream.ts"
+		"dream": "./dist/dream.js"
 	},
-	"files": ["bin"],
+	"files": ["dist"],
 	"scripts": {
+		"build": "tsup",
+		"dev": "tsx bin/dream.ts",
 		"check": "biome check .",
 		"check:fix": "biome check --write .",
 		"version": "changeset version",
-		"release": "changeset publish"
+		"release": "pnpm build && changeset publish"
 	},
 	"dependencies": {
 		"@ai-sdk/gateway": "^3.0.39",
 		"@opencode-ai/sdk": "^1.1.0",
-		"commander": "^12.0.0",
-		"tsx": "^4.0.0"
+		"commander": "^12.0.0"
 	},
 	"peerDependencies": {
 		"opencode-ai": ">=1.0.0"
@@ -27,6 +28,8 @@
 		"@changesets/cli": "^2.29.8",
 		"@types/node": "^22.0.0",
 		"lefthook": "^2.1.0",
+		"tsup": "^8.5.1",
+		"tsx": "^4.0.0",
 		"typescript": "^5.4.0"
 	},
 	"keywords": ["cli", "opencode", "ai", "automation"],

package/bin/dream.ts

@@ -1,573 +0,0 @@
-#!/usr/bin/env npx tsx
-import * as fs from "node:fs";
-import * as path from "node:path";
-import { type OpencodeClient, createOpencode } from "@opencode-ai/sdk";
-import { program } from "commander";
-
-const STOP_WORD = "<DREAM DONE>";
-
-const SYSTEM_PROMPT = `# Dream Agent
-
-You are an autonomous agent building a project from specifications. You run in a loop until completion.
-
-## Critical: State Lives on Disk
-
-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
-
-This ensures you can resume from any point if interrupted.
-
-## Workflow
-
-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
-3. **Execute**: Work on the next incomplete task
-4. **Update**: Mark the task complete in \`PROGRESS.md\`
-5. **Verify**: Check your work meets the spec requirements
-6. **Repeat or complete**: If tasks remain, continue. If all done, output completion signal.
-
-## Build Output API
-
-Your output must use [Vercel's Build Output API](https://vercel.com/docs/build-output-api/v3).
-
-### Directory Structure
-
-\`\`\`
-.vercel/output/
-├── config.json      # Required: { "version": 3 }
-└── static/          # Static files served from root (/)
-    ├── index.html
-    ├── styles.css
-    └── ...
-\`\`\`
-
-### Minimal config.json
-
-\`\`\`json
-{
-  "version": 3
-}
-\`\`\`
-
-Static files in \`.vercel/output/static/\` are served at the deployment root. Subdirectories are preserved in URLs.
-
-## PROGRESS.md Format
-
-\`\`\`markdown
-# Progress
-
-## Tasks
-- [x] Completed task
-- [ ] Pending task
-- [ ] Another pending task
-
-## Notes
-Any learnings or context for future iterations.
-\`\`\`
-
-## Completion
-
-**Only output the completion signal when ALL of the following are true:**
-- 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 complete, output exactly:
-
-${STOP_WORD}
-
-Do NOT output this signal if any work remains. Continue iterating until the specs are fully met.`;
-const DEFAULT_TIMEOUT = 3600000;
-const DEFAULT_MAX_ITERATIONS = 100;
-const DEFAULT_MODEL = "vercel/anthropic/claude-opus-4.5";
-
-const dim = (s: string) => `\x1b[2m${s}\x1b[22m`;
-const bold = (s: string) => `\x1b[1m${s}\x1b[22m`;
-const green = (s: string) => `\x1b[32m${s}\x1b[39m`;
-const red = (s: string) => `\x1b[31m${s}\x1b[39m`;
-const cyan = (s: string) => `\x1b[36m${s}\x1b[39m`;
-const log = console.log;
-
-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);
-		const specsDir = path.join(workDir, "specs");
-		const packageJsonPath = path.join(workDir, "package.json");
-
-		log(`\n  ${bold("▲ dream")} ${dim("· init")}\n`);
-
-		if (!fs.existsSync(workDir)) {
-			fs.mkdirSync(workDir, { recursive: true });
-		}
-
-		if (!fs.existsSync(specsDir)) {
-			fs.mkdirSync(specsDir);
-			fs.writeFileSync(
-				path.join(specsDir, "sample.md"),
-				"# Sample Spec\n\n## Context\n\nDescribe what you want to build here.\n\n## Tasks\n\n- [ ] First task\n- [ ] Second task\n",
-			);
-			log(`  ${green("+")} specs/sample.md`);
-		} else {
-			log(`  ${dim("·")} specs/ ${dim("already exists")}`);
-		}
-
-		if (!fs.existsSync(packageJsonPath)) {
-			const pkg = {
-				name: path.basename(workDir),
-				version: "0.1.0",
-				private: true,
-				scripts: { build: "dream" },
-				dependencies: { "@vercel/dream": "^0.1.0" },
-			};
-			fs.writeFileSync(packageJsonPath, `${JSON.stringify(pkg, null, "\t")}\n`);
-			log(`  ${green("+")} package.json`);
-		} else {
-			log(`  ${dim("·")} package.json ${dim("already exists")}`);
-		}
-
-		log(`\n  Run ${cyan("pnpm install")} then ${cyan("dream")} to start\n`);
-	});
-
-program
-	.command("config")
-	.description("Show project configuration and specs")
-	.action(() => {
-		const workDir = path.resolve(program.opts().dir);
-		const specsDir = path.join(workDir, "specs");
-
-		log(`\n  ${bold("▲ dream")} ${dim("· config")}\n`);
-		log(`  ${dim("dir")}         ${workDir}`);
-		log(`  ${dim("timeout")}     ${formatTime(DEFAULT_TIMEOUT)}`);
-		log(`  ${dim("max")}         ${DEFAULT_MAX_ITERATIONS} iterations`);
-
-		if (!fs.existsSync(specsDir)) {
-			log(`\n  ${red("✗")} specs/ not found\n`);
-			return;
-		}
-
-		const specFiles = fs.readdirSync(specsDir).filter((f) => f.endsWith(".md"));
-		log(`\n  ${dim("specs")} ${dim(`(${specFiles.length})`)}`);
-		for (const file of specFiles) {
-			log(`    ${dim("·")} ${file}`);
-		}
-		log("");
-	});
-
-program
-	.command("models")
-	.description("List available models and check provider auth")
-	.action(async () => {
-		log(`\n  ${bold("▲ dream")} ${dim("· models")}\n`);
-		log(`  ${dim("◌")} Starting OpenCode...`);
-		const { client, server } = await createOpencode({
-			port: 0,
-			config: { enabled_providers: ["vercel"] },
-		});
-
-		try {
-			const res = await client.provider.list();
-			if (res.error) {
-				log(`  ${red("✗")} Failed to list providers\n`);
-				return;
-			}
-
-			const { all, connected } = res.data;
-			for (const provider of all) {
-				const isConnected = connected.includes(provider.id);
-				const icon = isConnected ? green("●") : red("○");
-				const npm = provider.npm ? dim(` npm:${provider.npm}`) : "";
-				log(
-					`  ${icon} ${bold(provider.name)} ${dim(`(${provider.id})`)}${npm}`,
-				);
-
-				const models = Object.entries(provider.models);
-				for (const [id, model] of models) {
-					const name = (model as { name?: string }).name ?? id;
-					log(`    ${dim("·")} ${provider.id}/${id} ${dim(name)}`);
-				}
-				if (models.length === 0) {
-					log(`    ${dim("no models")}`);
-				}
-				log("");
-			}
-
-			log(
-				`  ${dim("connected")}   ${connected.length ? connected.join(", ") : "none"}\n`,
-			);
-		} 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) => {
-		const workDir = path.resolve(opts.dir);
-		const specsDir = path.join(workDir, "specs");
-
-		if (!fs.existsSync(specsDir)) {
-			log(`\n  ${red("✗")} specs/ not found in ${workDir}\n`);
-			process.exit(1);
-		}
-
-		const timeout = opts.timeout
-			? Number.parseInt(opts.timeout, 10)
-			: DEFAULT_TIMEOUT;
-		const maxIterations = opts.maxIterations
-			? Number.parseInt(opts.maxIterations, 10)
-			: DEFAULT_MAX_ITERATIONS;
-		const verbose = opts.verbose ?? false;
-		const model = opts.model ?? process.env.DREAM_MODEL ?? DEFAULT_MODEL;
-		const title = path.basename(workDir);
-
-		log(`\n  ${bold("▲ dream")} ${dim("·")} ${title}\n`);
-		log(`  ${dim("dir")}         ${workDir}`);
-		log(`  ${dim("model")}       ${model || dim("default")}`);
-		log(`  ${dim("timeout")}     ${formatTime(timeout)}`);
-		log(`  ${dim("max")}         ${maxIterations} iterations\n`);
-
-		log(`  ${dim("◌")} Starting OpenCode...`);
-		const oidcToken = process.env.VERCEL_OIDC_TOKEN;
-		const { client, server } = await createOpencode({
-			port: 0,
-			config: {
-				model,
-				permission: {
-					edit: "allow",
-					bash: "allow",
-					webfetch: "allow",
-					doom_loop: "allow",
-					external_directory: "allow",
-				},
-				provider: {
-					vercel: {
-						env: ["VERCEL_API_KEY", "VERCEL_OIDC_TOKEN"],
-						...(oidcToken && {
-							options: {
-								apiKey: oidcToken,
-								headers: {
-									"ai-gateway-auth-method": "oidc",
-								},
-							},
-						}),
-					},
-				},
-				enabled_providers: ["vercel"],
-			},
-		});
-		log(`  ${green("●")} OpenCode ready`);
-
-		const providerId = model?.split("/")[0];
-		if (providerId) {
-			const providers = await client.provider.list();
-			if (providers.error) {
-				log(`  ${red("✗")} Failed to list providers\n`);
-				server.close();
-				process.exit(1);
-			}
-			const connected = providers.data.connected ?? [];
-			if (!connected.includes(providerId)) {
-				log(`  ${red("✗")} Provider ${bold(providerId)} is not connected`);
-				log(
-					`  ${dim("connected")}   ${connected.length ? connected.join(", ") : "none"}`,
-				);
-				log(
-					`\n  Run ${cyan("opencode")} and authenticate the ${bold(providerId)} provider\n`,
-				);
-				server.close();
-				process.exit(1);
-			}
-			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("✗")} 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)` : ""}`,
-					);
-				}
-				log("");
-				server.close();
-				process.exit(1);
-			}
-			log(`  ${green("●")} Provider ${bold(providerId)} connected\n`);
-		}
-
-		const cleanup = () => {
-			server.close();
-			process.exit(1);
-		};
-		process.on("SIGINT", cleanup);
-		process.on("SIGTERM", cleanup);
-
-		const startTime = Date.now();
-		let iteration = 0;
-
-		try {
-			while (iteration < maxIterations) {
-				const elapsed = Date.now() - startTime;
-				if (elapsed >= timeout) {
-					log(`\n  ${red("✗")} Timeout after ${formatTime(elapsed)}\n`);
-					process.exit(1);
-				}
-
-				iteration++;
-				const iterStart = Date.now();
-				log(`  ${cyan(`[${iteration}]`)} Running session...`);
-
-				const result = await runSession(client, title, SYSTEM_PROMPT, verbose);
-				const iterElapsed = Date.now() - iterStart;
-
-				if (result === "done") {
-					log(
-						`  ${cyan(`[${iteration}]`)} ${green("✓")} Done ${dim(`(${formatTime(iterElapsed)})`)}`,
-					);
-					log(
-						`\n  ${green("✓")} Completed in ${bold(String(iteration))} iteration(s) ${dim(`(${formatTime(Date.now() - startTime)})`)}\n`,
-					);
-					process.exit(0);
-				}
-
-				if (result === "error") {
-					log(
-						`\n  ${red("✗")} Session failed after ${bold(String(iteration))} iteration(s) ${dim(`(${formatTime(Date.now() - startTime)})`)}\n`,
-					);
-					process.exit(1);
-				}
-
-				log(
-					`  ${cyan(`[${iteration}]`)} ${dim(`${formatTime(iterElapsed)} · continuing...`)}\n`,
-				);
-			}
-
-			log(`\n  ${red("✗")} Max iterations reached\n`);
-			process.exit(1);
-		} finally {
-			server.close();
-		}
-	});
-
-async function runSession(
-	client: OpencodeClient,
-	title: string,
-	systemPrompt: string,
-	verbose: boolean,
-): Promise<"done" | "continue" | "error"> {
-	log(`       ${dim("creating session...")}`);
-	const sessionResponse = await client.session.create({
-		body: { title: `Dream: ${title}` },
-	});
-
-	if (sessionResponse.error) {
-		throw new Error(
-			`Failed to create session: ${JSON.stringify(sessionResponse.error.errors)}`,
-		);
-	}
-
-	const sessionId = sessionResponse.data.id;
-	log(`       ${dim(`session ${sessionId.slice(0, 8)}`)}`);
-
-	log(`       ${dim("subscribing to events...")}`);
-	const events = await client.event.subscribe();
-
-	log(`       ${dim("sending prompt...")}`);
-	const promptResponse = await client.session.promptAsync({
-		path: { id: sessionId },
-		body: {
-			parts: [{ type: "text", text: systemPrompt }],
-		},
-	});
-
-	if (promptResponse.error) {
-		log(
-			`       ${red("✗")} prompt error: ${JSON.stringify(promptResponse.error)}`,
-		);
-		return "error";
-	}
-
-	let responseText = "";
-	let toolCalls = 0;
-	let totalCost = 0;
-	let totalTokensIn = 0;
-	let totalTokensOut = 0;
-	const seenTools = new Set<string>();
-	let lastOutput: "text" | "tool" | "none" = "none";
-
-	const pad = "       ";
-
-	for await (const event of events.stream) {
-		const props = event.properties as { sessionID?: string };
-
-		if (verbose) {
-			const sid = props.sessionID ? props.sessionID.slice(0, 8) : "global";
-			log(dim(`       event: ${event.type} [${sid}]`));
-			if (event.type !== "server.connected") {
-				log(
-					dim(
-						`              ${JSON.stringify(event.properties).slice(0, 200)}`,
-					),
-				);
-			}
-		}
-
-		if (props.sessionID && props.sessionID !== sessionId) {
-			continue;
-		}
-
-		if (event.type === "message.part.updated") {
-			const { part } = event.properties;
-			const delta = event.properties.delta as string | undefined;
-			if (part.type === "text" && delta) {
-				responseText += delta;
-				if (lastOutput === "tool") process.stdout.write("\n");
-				const indented = delta.replace(/\n/g, `\n${pad}`);
-				process.stdout.write(
-					lastOutput !== "text" ? `${pad}${dim(indented)}` : dim(indented),
-				);
-				lastOutput = "text";
-			}
-			if (part.type === "reasoning" && delta) {
-				if (lastOutput === "tool") process.stdout.write("\n");
-				const indented = delta.replace(/\n/g, `\n${pad}`);
-				process.stdout.write(
-					lastOutput !== "text" ? `${pad}${dim(indented)}` : dim(indented),
-				);
-				lastOutput = "text";
-			}
-			if (part.type === "tool") {
-				const callID = part.callID as string;
-				const toolName = part.tool as string;
-				const state = part.state as {
-					status: string;
-					title?: string;
-					input?: Record<string, unknown>;
-					output?: string;
-					error?: string;
-				};
-				if (state.status === "running" && !seenTools.has(callID)) {
-					seenTools.add(callID);
-					toolCalls++;
-					if (lastOutput === "text") process.stdout.write("\n\n");
-					const context = toolContext(toolName, state.input) ?? state.title;
-					log(
-						`${pad}${dim("▸")} ${toolName}${context ? dim(` ${context}`) : ""}`,
-					);
-					lastOutput = "tool";
-				}
-				if (state.status === "error") {
-					if (lastOutput === "text") process.stdout.write("\n");
-					log(`${pad}${red("✗")} ${toolName}: ${state.error}`);
-					lastOutput = "tool";
-				}
-			}
-			if (part.type === "step-finish") {
-				const step = part as {
-					cost?: number;
-					tokens?: { input: number; output: number };
-				};
-				totalCost += step.cost ?? 0;
-				totalTokensIn += step.tokens?.input ?? 0;
-				totalTokensOut += step.tokens?.output ?? 0;
-			}
-		}
-
-		if (event.type === "file.edited") {
-			const file = (event.properties as { file?: string }).file;
-			if (file) {
-				if (lastOutput === "text") process.stdout.write("\n");
-				const relative = file.replace(`${process.cwd()}/`, "");
-				log(`${pad}${green("✎")} ${relative}`);
-				lastOutput = "tool";
-			}
-		}
-
-		if (event.type === "session.error") {
-			const errProps = event.properties as {
-				error?: { name?: string; data?: { message?: string } };
-			};
-			const msg =
-				errProps.error?.data?.message ??
-				errProps.error?.name ??
-				"session error";
-			if (lastOutput === "text") process.stdout.write("\n");
-			log(`${pad}${red("✗")} ${msg}`);
-			return "error";
-		}
-
-		if (event.type === "session.idle") {
-			break;
-		}
-	}
-
-	if (lastOutput === "text") process.stdout.write("\n");
-	const tokens = `${formatTokens(totalTokensIn)}→${formatTokens(totalTokensOut)}`;
-	const cost = totalCost > 0 ? ` · $${totalCost.toFixed(2)}` : "";
-	log(`${pad}${dim(`${toolCalls} tools · ${tokens}${cost}`)}`);
-
-	if (responseText.length === 0) {
-		log(`${pad}${red("✗")} No response from model`);
-		return "error";
-	}
-
-	return responseText.includes(STOP_WORD) ? "done" : "continue";
-}
-
-function formatTime(ms: number): string {
-	if (ms < 1000) return `${ms}ms`;
-	if (ms < 60000) return `${(ms / 1000).toFixed(1)}s`;
-	return `${(ms / 60000).toFixed(1)}m`;
-}
-
-function formatTokens(n: number): string {
-	if (n < 1000) return `${n}`;
-	if (n < 1000000) return `${(n / 1000).toFixed(1)}k`;
-	return `${(n / 1000000).toFixed(1)}M`;
-}
-
-function toolContext(
-	tool: string,
-	input?: Record<string, unknown>,
-): string | undefined {
-	if (!input) return undefined;
-	const filePath = input.filePath as string | undefined;
-	const rel = filePath?.replace(`${process.cwd()}/`, "");
-	switch (tool) {
-		case "read":
-		case "write":
-		case "edit":
-			return rel;
-		case "bash": {
-			const cmd = input.command as string | undefined;
-			if (!cmd) return undefined;
-			return cmd.length > 60 ? `${cmd.slice(0, 60)}…` : cmd;
-		}
-		case "glob":
-		case "grep":
-			return input.pattern as string | undefined;
-		case "fetch":
-			return input.url as string | undefined;
-		default:
-			return undefined;
-	}
-}
-
-await program.parseAsync();