@inneranimalmedia/agentsam-sdk 1.6.0 → 1.7.0

package/bin/scaffold.mjs

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+/**
+ * agentsam scaffold
+ * Usage:
+ *   npx @inneranimalmedia/agentsam-sdk scaffold
+ *   npx @inneranimalmedia/agentsam-sdk scaffold cms
+ *   npx @inneranimalmedia/agentsam-sdk scaffold worker-api
+ */
+
+import { runScaffold } from '../src/lib/scaffold/index.js';
+
+const type = process.argv[2] ?? null;
+
+runScaffold(type).catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inneranimalmedia/agentsam-sdk",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "description": "Agent Sam is a full-stack AI agent SDK for autonomous task execution — covering data management, creative workflows, design commands, and multi-step agentic pipelines.",
   "type": "module",
   "main": "./src/index.js",
@@ -9,7 +9,8 @@
     "./package.json": "./package.json"
   },
   "bin": {
-    "agentsam": "src/cli.js"
+    "agentsam": "src/cli.js",
+    "agentsam-scaffold": "bin/scaffold.mjs"
   },
   "files": [
     "src",
@@ -19,7 +20,8 @@
     "test",
     "README.md",
     "LICENSE",
-    "DEVELOPMENT.md"
+    "DEVELOPMENT.md",
+    "bin"
   ],
   "scripts": {
     "test": "node test/smoke.mjs",
@@ -30,7 +32,9 @@
     "node": ">=20"
   },
   "dependencies": {
+    "@clack/prompts": "^1.7.0",
     "node-pty": "^1.0.0",
+    "picocolors": "^1.1.1",
     "ws": "^8.18.0"
   },
   "publishConfig": {
@@ -54,5 +58,8 @@
   "bugs": {
     "url": "https://github.com/SamPrimeaux/agentsam-sdk/issues"
   },
-  "homepage": "https://github.com/SamPrimeaux/agentsam-sdk#readme"
+  "homepage": "https://github.com/SamPrimeaux/agentsam-sdk#readme",
+  "allowScripts": {
+    "node-pty@1.1.0": true
+  }
 }

package/src/lib/scaffold/index.js

@@ -0,0 +1,61 @@
+/**
+ * @inneranimalmedia/agentsam-sdk — scaffold system
+ * Entry point for all guided scaffold wizards.
+ *
+ * Usage:
+ *   npx @inneranimalmedia/agentsam-sdk scaffold
+ *   npx @inneranimalmedia/agentsam-sdk scaffold cms
+ *   npx @inneranimalmedia/agentsam-sdk scaffold worker-api
+ */
+
+import { intro, outro, select, cancel, isCancel, note } from '@clack/prompts';
+import { runCmsWizard } from './wizards/cms.js';
+import { runWorkerApiWizard } from './wizards/worker-api.js';
+import pc from 'picocolors';
+
+const SCAFFOLDS = {
+  cms: {
+    label: 'CMS Site',
+    description: 'Cloudflare Worker + D1 + R2 with nav, pages, and reusable templates',
+    run: runCmsWizard,
+  },
+  'worker-api': {
+    label: 'Worker API',
+    description: 'Bare Cloudflare Worker with typed route handlers and D1 binding',
+    run: runWorkerApiWizard,
+  },
+};
+
+export async function runScaffold(type) {
+  intro(pc.bgCyan(pc.black(' Agent Sam Scaffold ')));
+
+  // If a type was passed directly (e.g. `scaffold cms`), run it
+  if (type && SCAFFOLDS[type]) {
+    await SCAFFOLDS[type].run();
+    outro(pc.green('Done. Files written — check the output above.'));
+    return;
+  }
+
+  if (type && !SCAFFOLDS[type]) {
+    note(`Unknown scaffold type: "${type}"\nAvailable: ${Object.keys(SCAFFOLDS).join(', ')}`, 'Error');
+    process.exit(1);
+  }
+
+  // No type passed — show picker
+  const choice = await select({
+    message: 'What do you want to scaffold?',
+    options: Object.entries(SCAFFOLDS).map(([value, { label, description }]) => ({
+      value,
+      label,
+      hint: description,
+    })),
+  });
+
+  if (isCancel(choice)) {
+    cancel('Cancelled.');
+    process.exit(0);
+  }
+
+  await SCAFFOLDS[choice].run();
+  outro(pc.green('Done. Files written — check the output above.'));
+}

package/src/lib/scaffold/templates/cms/index.js

@@ -0,0 +1,472 @@
+/**
+ * CMS template generator.
+ * Returns a flat file-tree object keyed by relative path → file content string.
+ */
+
+export function cmsTemplates(config) {
+  const { projectName, siteTitle, navStyle, pages, templateStyle, contactEmail, cfAccountId } = config;
+
+  const files = {};
+
+  // ── package.json ──────────────────────────────────────────────────────────
+  files['package.json'] = JSON.stringify({
+    name: projectName,
+    version: '0.1.0',
+    private: true,
+    scripts: {
+      deploy: 'wrangler deploy',
+      dev: 'wrangler dev',
+      'db:migrate': `wrangler d1 execute ${projectName} --file=migrations/001_init.sql --remote`,
+    },
+    devDependencies: {
+      wrangler: '^3.0.0',
+    },
+  }, null, 2);
+
+  // ── wrangler.toml ─────────────────────────────────────────────────────────
+  files['wrangler.toml'] = `name = "${projectName}"
+main = "src/index.js"
+compatibility_date = "2024-01-01"
+account_id = "${cfAccountId}"
+
+[[d1_databases]]
+binding = "DB"
+database_name = "${projectName}"
+database_id = "REPLACE_WITH_YOUR_D1_ID"
+
+[[r2_buckets]]
+binding = "ASSETS"
+bucket_name = "${projectName}"
+`;
+
+  // ── D1 migration ──────────────────────────────────────────────────────────
+  let migrationSql = `-- ${projectName} initial schema\n\n`;
+
+  migrationSql += `CREATE TABLE IF NOT EXISTS cms_pages (
+  id TEXT PRIMARY KEY,
+  slug TEXT NOT NULL UNIQUE,
+  title TEXT NOT NULL,
+  template TEXT NOT NULL DEFAULT 'default',
+  content_json TEXT,
+  status TEXT NOT NULL DEFAULT 'draft',
+  created_at INTEGER NOT NULL DEFAULT (unixepoch()),
+  updated_at INTEGER NOT NULL DEFAULT (unixepoch())
+);\n\n`;
+
+  migrationSql += `CREATE TABLE IF NOT EXISTS cms_nav_items (
+  id TEXT PRIMARY KEY,
+  label TEXT NOT NULL,
+  href TEXT NOT NULL,
+  position INTEGER NOT NULL DEFAULT 0,
+  parent_id TEXT,
+  created_at INTEGER NOT NULL DEFAULT (unixepoch())
+);\n\n`;
+
+  if (pages.includes('blog')) {
+    migrationSql += `CREATE TABLE IF NOT EXISTS cms_posts (
+  id TEXT PRIMARY KEY,
+  slug TEXT NOT NULL UNIQUE,
+  title TEXT NOT NULL,
+  body TEXT,
+  published_at INTEGER,
+  status TEXT NOT NULL DEFAULT 'draft',
+  created_at INTEGER NOT NULL DEFAULT (unixepoch())
+);\n\n`;
+  }
+
+  if (contactEmail) {
+    migrationSql += `CREATE TABLE IF NOT EXISTS cms_contact_submissions (
+  id TEXT PRIMARY KEY,
+  name TEXT,
+  email TEXT,
+  message TEXT,
+  created_at INTEGER NOT NULL DEFAULT (unixepoch())
+);\n\n`;
+  }
+
+  // Seed nav items from selected pages
+  const navOrder = ['home', 'about', 'services', 'blog', 'contact'];
+  const navPages = navOrder.filter(p => pages.includes(p));
+  navPages.forEach((page, i) => {
+    const label = page.charAt(0).toUpperCase() + page.slice(1);
+    const href = page === 'home' ? '/' : `/${page}`;
+    migrationSql += `INSERT OR IGNORE INTO cms_nav_items (id, label, href, position) VALUES ('nav_${page}', '${label}', '${href}', ${i});\n`;
+  });
+
+  files['migrations/001_init.sql'] = migrationSql;
+
+  // ── Worker entry point ────────────────────────────────────────────────────
+  files['src/index.js'] = workerEntry(config);
+
+  // ── Route handlers ────────────────────────────────────────────────────────
+  files['src/routes/pages.js'] = pagesRoute(config);
+  files['src/routes/nav.js'] = navRoute();
+
+  if (pages.includes('blog')) {
+    files['src/routes/blog.js'] = blogRoute();
+  }
+
+  if (contactEmail) {
+    files['src/routes/contact.js'] = contactRoute(contactEmail);
+  }
+
+  // ── HTML shell template ───────────────────────────────────────────────────
+  files['src/templates/shell.js'] = htmlShell(config);
+
+  // ── Nav component ─────────────────────────────────────────────────────────
+  files['src/templates/nav.js'] = navComponent(navStyle, siteTitle);
+
+  // ── Page templates ────────────────────────────────────────────────────────
+  pages.forEach(page => {
+    files[`src/templates/pages/${page}.js`] = pageTemplate(page, siteTitle, templateStyle);
+  });
+
+  // ── README ────────────────────────────────────────────────────────────────
+  files['README.md'] = readme(config);
+
+  return files;
+}
+
+// ── Worker entry ─────────────────────────────────────────────────────────────
+function workerEntry({ projectName, pages, contactEmail }) {
+  const imports = [`import { handlePages } from './routes/pages.js';`,
+    `import { handleNav } from './routes/nav.js';`];
+
+  if (pages.includes('blog')) imports.push(`import { handleBlog } from './routes/blog.js';`);
+  if (contactEmail) imports.push(`import { handleContact } from './routes/contact.js';`);
+
+  return `${imports.join('\n')}
+
+export default {
+  async fetch(request, env, ctx) {
+    const url = new URL(request.url);
+    const { pathname } = url;
+
+    // CORS preflight
+    if (request.method === 'OPTIONS') {
+      return new Response(null, {
+        headers: {
+          'Access-Control-Allow-Origin': '*',
+          'Access-Control-Allow-Methods': 'GET, POST, OPTIONS',
+          'Access-Control-Allow-Headers': 'Content-Type',
+        },
+      });
+    }
+
+    // API routes
+    if (pathname.startsWith('/api/nav')) return handleNav(request, env);
+${pages.includes('blog') ? `    if (pathname.startsWith('/api/blog')) return handleBlog(request, env);\n` : ''}${contactEmail ? `    if (pathname === '/api/contact' && request.method === 'POST') return handleContact(request, env);\n` : ''}
+    // Page routes — catch-all
+    return handlePages(request, env);
+  },
+};
+`;
+}
+
+// ── Route: pages ─────────────────────────────────────────────────────────────
+function pagesRoute({ pages, templateStyle, siteTitle }) {
+  return `import { renderShell } from '../templates/shell.js';
+import { renderNav } from '../templates/nav.js';
+${pages.map(p => `import { render${cap(p)}Page } from '../templates/pages/${p}.js';`).join('\n')}
+
+const PAGE_MAP = {
+${pages.map(p => `  '${p === 'home' ? '/' : `/${p}`}': render${cap(p)}Page,`).join('\n')}
+};
+
+export async function handlePages(request, env) {
+  const url = new URL(request.url);
+  const slug = url.pathname.replace(/\\/$/, '') || '/';
+
+  const renderPage = PAGE_MAP[slug];
+  if (!renderPage) {
+    return new Response(renderShell('404', renderNav([]), '<h1>Page not found</h1>'), {
+      status: 404,
+      headers: { 'Content-Type': 'text/html;charset=UTF-8' },
+    });
+  }
+
+  // Load nav from D1
+  const navRows = await env.DB.prepare(
+    'SELECT label, href FROM cms_nav_items ORDER BY position ASC'
+  ).all();
+  const nav = renderNav(navRows.results ?? []);
+
+${templateStyle === 'fragment'
+  ? `  // Load page fragment from R2
+  const fragmentKey = \`pages/\${slug === '/' ? 'home' : slug.slice(1)}/content.html\`;
+  const fragment = await env.ASSETS.get(fragmentKey);
+  const content = fragment ? await fragment.text() : renderPage();`
+  : templateStyle === 'json'
+  ? `  // Load page content from D1
+  const pageRow = await env.DB.prepare(
+    'SELECT content_json FROM cms_pages WHERE slug = ? AND status = \\'published\\''
+  ).bind(slug === '/' ? 'home' : slug.slice(1)).first();
+  const content = renderPage(pageRow?.content_json ? JSON.parse(pageRow.content_json) : {});`
+  : `  const content = renderPage();`}
+
+  const html = renderShell('${siteTitle}', nav, content);
+  return new Response(html, {
+    headers: { 'Content-Type': 'text/html;charset=UTF-8' },
+  });
+}
+`;
+}
+
+// ── Route: nav ───────────────────────────────────────────────────────────────
+function navRoute() {
+  return `export async function handleNav(request, env) {
+  const rows = await env.DB.prepare(
+    'SELECT id, label, href, position FROM cms_nav_items ORDER BY position ASC'
+  ).all();
+  return Response.json(rows.results ?? []);
+}
+`;
+}
+
+// ── Route: blog ──────────────────────────────────────────────────────────────
+function blogRoute() {
+  return `import { renderShell } from '../templates/shell.js';
+import { renderNav } from '../templates/nav.js';
+
+export async function handleBlog(request, env) {
+  const url = new URL(request.url);
+  const slug = url.pathname.replace('/blog/', '').replace('/blog', '');
+
+  if (slug && slug !== '/') {
+    // Single post
+    const post = await env.DB.prepare(
+      'SELECT * FROM cms_posts WHERE slug = ? AND status = \\'published\\''
+    ).bind(slug).first();
+
+    if (!post) return new Response('Post not found', { status: 404 });
+
+    const navRows = await env.DB.prepare('SELECT label, href FROM cms_nav_items ORDER BY position ASC').all();
+    const html = renderShell(post.title, renderNav(navRows.results ?? []), \`
+      <article>
+        <h1>\${post.title}</h1>
+        <div class="post-body">\${post.body ?? ''}</div>
+      </article>
+    \`);
+    return new Response(html, { headers: { 'Content-Type': 'text/html;charset=UTF-8' } });
+  }
+
+  // Post list
+  const posts = await env.DB.prepare(
+    'SELECT slug, title, published_at FROM cms_posts WHERE status = \\'published\\' ORDER BY published_at DESC LIMIT 20'
+  ).all();
+
+  const navRows = await env.DB.prepare('SELECT label, href FROM cms_nav_items ORDER BY position ASC').all();
+  const listHtml = (posts.results ?? []).map(p =>
+    \`<li><a href="/blog/\${p.slug}">\${p.title}</a></li>\`
+  ).join('');
+
+  const html = renderShell('Blog', renderNav(navRows.results ?? []), \`
+    <h1>Blog</h1>
+    <ul class="post-list">\${listHtml}</ul>
+  \`);
+  return new Response(html, { headers: { 'Content-Type': 'text/html;charset=UTF-8' } });
+}
+`;
+}
+
+// ── Route: contact ────────────────────────────────────────────────────────────
+function contactRoute(email) {
+  return `export async function handleContact(request, env) {
+  let body;
+  try {
+    body = await request.json();
+  } catch {
+    return Response.json({ error: 'Invalid JSON' }, { status: 400 });
+  }
+
+  const { name, email: fromEmail, message } = body;
+  if (!name || !fromEmail || !message) {
+    return Response.json({ error: 'name, email, and message are required' }, { status: 400 });
+  }
+
+  // Save to D1
+  const id = crypto.randomUUID();
+  await env.DB.prepare(
+    'INSERT INTO cms_contact_submissions (id, name, email, message) VALUES (?, ?, ?, ?)'
+  ).bind(id, name, fromEmail, message).run();
+
+  // Send via Resend (requires RESEND_API_KEY secret)
+  if (env.RESEND_API_KEY) {
+    await fetch('https://api.resend.com/emails', {
+      method: 'POST',
+      headers: {
+        Authorization: \`Bearer \${env.RESEND_API_KEY}\`,
+        'Content-Type': 'application/json',
+      },
+      body: JSON.stringify({
+        from: 'noreply@yourdomain.com',
+        to: '${email}',
+        subject: \`New contact form submission from \${name}\`,
+        text: \`Name: \${name}\\nEmail: \${fromEmail}\\n\\n\${message}\`,
+      }),
+    });
+  }
+
+  return Response.json({ ok: true, id });
+}
+`;
+}
+
+// ── Template: HTML shell ──────────────────────────────────────────────────────
+function htmlShell({ siteTitle }) {
+  return `export function renderShell(pageTitle, navHtml, bodyHtml) {
+  return \`<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>\${pageTitle} — ${siteTitle}</title>
+  <style>
+    *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
+    body { font-family: system-ui, sans-serif; color: #1a1a1a; background: #fff; }
+    a { color: inherit; }
+    main { max-width: 1100px; margin: 0 auto; padding: 2rem 1rem; }
+    h1 { font-size: 2rem; margin-bottom: 1rem; }
+    h2 { font-size: 1.4rem; margin-bottom: 0.75rem; }
+    p  { line-height: 1.65; margin-bottom: 1rem; }
+  </style>
+</head>
+<body>
+  \${navHtml}
+  <main>\${bodyHtml}</main>
+</body>
+</html>\`;
+}
+`;
+}
+
+// ── Template: nav component ───────────────────────────────────────────────────
+function navComponent(navStyle, siteTitle) {
+  const styles = {
+    topbar: `
+    nav { display: flex; align-items: center; gap: 2rem; background: #111; padding: 0 1.5rem; height: 56px; }
+    nav .site-title { color: #fff; font-weight: 700; font-size: 1.1rem; text-decoration: none; margin-right: auto; }
+    nav a { color: #ccc; text-decoration: none; font-size: 0.9rem; }
+    nav a:hover { color: #fff; }`,
+    sidebar: `
+    .nav-sidebar { position: fixed; top: 0; left: 0; width: 220px; height: 100vh; background: #111; padding: 1.5rem 1rem; display: flex; flex-direction: column; gap: 0.5rem; }
+    .nav-sidebar .site-title { color: #fff; font-weight: 700; font-size: 1.1rem; text-decoration: none; margin-bottom: 1rem; }
+    .nav-sidebar a { color: #ccc; text-decoration: none; font-size: 0.9rem; padding: 0.4rem 0.6rem; border-radius: 4px; }
+    .nav-sidebar a:hover { background: #222; color: #fff; }
+    body { padding-left: 220px; }`,
+    minimal: `
+    nav { display: flex; align-items: center; justify-content: space-between; padding: 1rem 1.5rem; border-bottom: 1px solid #eee; }
+    nav .site-title { font-weight: 700; font-size: 1.1rem; text-decoration: none; }
+    .nav-toggle { background: none; border: none; cursor: pointer; font-size: 1.2rem; }`,
+  }[navStyle];
+
+  const navClass = navStyle === 'sidebar' ? 'class="nav-sidebar"' : '';
+
+  return `export function renderNav(items) {
+  const links = items.map(i => \`<a href="\${i.href}">\${i.label}</a>\`).join('');
+  return \`<style>${styles}</style>
+<nav ${navClass}>
+  <a class="site-title" href="/">${siteTitle}</a>
+  \${links}
+</nav>\`;
+}
+`;
+}
+
+// ── Template: individual page templates ──────────────────────────────────────
+function pageTemplate(page, siteTitle, templateStyle) {
+  const pageContent = {
+    home: `<section class="hero">
+    <h1>Welcome to ${siteTitle}</h1>
+    <p>Your tagline goes here.</p>
+  </section>`,
+    about: `<h1>About Us</h1>
+  <p>Tell your story here.</p>`,
+    services: `<h1>Services</h1>
+  <ul>
+    <li>Service one</li>
+    <li>Service two</li>
+    <li>Service three</li>
+  </ul>`,
+    contact: `<h1>Contact</h1>
+  <form id="contact-form">
+    <div><label>Name<br><input type="text" name="name" required /></label></div>
+    <div><label>Email<br><input type="email" name="email" required /></label></div>
+    <div><label>Message<br><textarea name="message" required></textarea></label></div>
+    <button type="submit">Send</button>
+  </form>
+  <script>
+    document.getElementById('contact-form').addEventListener('submit', async (e) => {
+      e.preventDefault();
+      const data = Object.fromEntries(new FormData(e.target));
+      const res = await fetch('/api/contact', { method: 'POST', headers: {'Content-Type':'application/json'}, body: JSON.stringify(data) });
+      if (res.ok) { e.target.reset(); alert('Message sent!'); }
+    });
+  </script>`,
+    blog: `<h1>Blog</h1><p>Loading posts...</p>`,
+    privacy: `<h1>Privacy Policy</h1>
+  <p>Last updated: ${new Date().toLocaleDateString()}</p>
+  <p>We do not sell your data. Replace this with your actual privacy policy.</p>`,
+  };
+
+  const body = pageContent[page] ?? `<h1>${cap(page)}</h1><p>Content coming soon.</p>`;
+
+  if (templateStyle === 'json') {
+    return `export function render${cap(page)}Page(data = {}) {
+  return \`${body}\`;
+}
+`;
+  }
+
+  return `export function render${cap(page)}Page() {
+  return \`${body}\`;
+}
+`;
+}
+
+// ── README ────────────────────────────────────────────────────────────────────
+function readme({ projectName, siteTitle, pages, navStyle, templateStyle }) {
+  return `# ${siteTitle}
+
+Scaffolded by [@inneranimalmedia/agentsam-sdk](https://github.com/SamPrimeaux/agentsam-sdk).
+
+## Stack
+
+- Cloudflare Worker (entry: \`src/index.js\`)
+- D1 database (binding: \`DB\`)
+- R2 bucket (binding: \`ASSETS\`)
+- Template style: \`${templateStyle}\`
+- Nav style: \`${navStyle}\`
+
+## Pages
+
+${pages.map(p => `- \`${p === 'home' ? '/' : `/${p}`}\` — ${cap(p)}`).join('\n')}
+
+## Deploy
+
+\`\`\`bash
+npm install
+
+# Create D1 (copy the returned database_id into wrangler.toml)
+npx wrangler d1 create ${projectName}
+
+# Run migration
+npx wrangler d1 execute ${projectName} --file=migrations/001_init.sql --remote
+
+# Deploy
+npx wrangler deploy
+\`\`\`
+
+## Environment secrets
+
+| Secret | Purpose |
+|--------|---------|
+| \`RESEND_API_KEY\` | Contact form email delivery (optional) |
+
+Set with: \`npx wrangler secret put RESEND_API_KEY\`
+`;
+}
+
+function cap(str) {
+  return str.charAt(0).toUpperCase() + str.slice(1);
+}

package/src/lib/scaffold/templates/worker-api/index.js

@@ -0,0 +1,204 @@
+/**
+ * Worker API template generator.
+ */
+
+export function workerApiTemplates({ projectName, routes, cfAccountId }) {
+  const files = {};
+
+  files['package.json'] = JSON.stringify({
+    name: projectName,
+    version: '0.1.0',
+    private: true,
+    scripts: {
+      deploy: 'wrangler deploy',
+      dev: 'wrangler dev',
+      'db:migrate': `wrangler d1 execute ${projectName} --file=migrations/001_init.sql --remote`,
+    },
+    devDependencies: { wrangler: '^3.0.0' },
+  }, null, 2);
+
+  files['wrangler.toml'] = `name = "${projectName}"
+main = "src/index.js"
+compatibility_date = "2024-01-01"
+account_id = "${cfAccountId}"
+
+[[d1_databases]]
+binding = "DB"
+database_name = "${projectName}"
+database_id = "REPLACE_WITH_YOUR_D1_ID"
+`;
+
+  // Entry
+  const routeImports = routes.map(r => `import { handle${cap(r)} } from './routes/${r}.js';`).join('\n');
+  const routeMatches = routes.map(r => {
+    const path = r === 'health' ? `pathname === '/health'`
+      : r === 'auth' ? `pathname.startsWith('/auth')`
+      : r === 'webhook' ? `pathname.startsWith('/webhooks')`
+      : `pathname.startsWith('/${r}')`;
+    return `    if (${path}) return handle${cap(r)}(request, env);`;
+  }).join('\n');
+
+  files['src/index.js'] = `${routeImports}
+
+export default {
+  async fetch(request, env) {
+    const url = new URL(request.url);
+    const { pathname } = url;
+
+    if (request.method === 'OPTIONS') {
+      return new Response(null, {
+        headers: {
+          'Access-Control-Allow-Origin': '*',
+          'Access-Control-Allow-Methods': 'GET, POST, PUT, DELETE, OPTIONS',
+          'Access-Control-Allow-Headers': 'Content-Type, Authorization',
+        },
+      });
+    }
+
+${routeMatches}
+
+    return Response.json({ error: 'Not found' }, { status: 404 });
+  },
+};
+`;
+
+  // Route stubs
+  if (routes.includes('health')) {
+    files['src/routes/health.js'] = `export async function handleHealth(request, env) {
+  return Response.json({ ok: true, ts: Date.now() });
+}
+`;
+  }
+
+  if (routes.includes('auth')) {
+    files['src/routes/auth.js'] = `export async function handleAuth(request, env) {
+  const url = new URL(request.url);
+  if (url.pathname === '/auth/token' && request.method === 'POST') {
+    // TODO: issue token
+    return Response.json({ token: 'replace-me' });
+  }
+  return Response.json({ error: 'Unknown auth route' }, { status: 404 });
+}
+`;
+  }
+
+  if (routes.includes('users')) {
+    files['src/routes/users.js'] = `export async function handleUsers(request, env) {
+  const url = new URL(request.url);
+  const id = url.pathname.replace('/users/', '').replace('/users', '') || null;
+
+  if (request.method === 'GET' && !id) {
+    const rows = await env.DB.prepare('SELECT * FROM users LIMIT 50').all();
+    return Response.json(rows.results ?? []);
+  }
+  if (request.method === 'GET' && id) {
+    const row = await env.DB.prepare('SELECT * FROM users WHERE id = ?').bind(id).first();
+    if (!row) return Response.json({ error: 'Not found' }, { status: 404 });
+    return Response.json(row);
+  }
+  if (request.method === 'POST') {
+    const body = await request.json();
+    const newId = crypto.randomUUID();
+    await env.DB.prepare('INSERT INTO users (id, email) VALUES (?, ?)').bind(newId, body.email).run();
+    return Response.json({ id: newId }, { status: 201 });
+  }
+  if (request.method === 'DELETE' && id) {
+    await env.DB.prepare('DELETE FROM users WHERE id = ?').bind(id).run();
+    return Response.json({ ok: true });
+  }
+  return Response.json({ error: 'Method not allowed' }, { status: 405 });
+}
+`;
+  }
+
+  if (routes.includes('content')) {
+    files['src/routes/content.js'] = `export async function handleContent(request, env) {
+  const url = new URL(request.url);
+  const slug = url.pathname.replace('/content/', '').replace('/content', '') || null;
+
+  if (request.method === 'GET' && !slug) {
+    const rows = await env.DB.prepare("SELECT id, slug, title, status FROM cms_pages LIMIT 50").all();
+    return Response.json(rows.results ?? []);
+  }
+  if (request.method === 'GET' && slug) {
+    const row = await env.DB.prepare('SELECT * FROM cms_pages WHERE slug = ?').bind(slug).first();
+    if (!row) return Response.json({ error: 'Not found' }, { status: 404 });
+    return Response.json(row);
+  }
+  if (request.method === 'POST') {
+    const body = await request.json();
+    const id = crypto.randomUUID();
+    await env.DB.prepare(
+      'INSERT INTO cms_pages (id, slug, title, template, content_json) VALUES (?, ?, ?, ?, ?)'
+    ).bind(id, body.slug, body.title, body.template ?? 'default', JSON.stringify(body.content ?? {})).run();
+    return Response.json({ id }, { status: 201 });
+  }
+  return Response.json({ error: 'Method not allowed' }, { status: 405 });
+}
+`;
+  }
+
+  if (routes.includes('webhook')) {
+    files['src/routes/webhook.js'] = `export async function handleWebhook(request, env) {
+  const url = new URL(request.url);
+  const type = url.pathname.replace('/webhooks/', '').replace('/webhooks', '') || 'unknown';
+
+  let body;
+  try { body = await request.json(); } catch { body = {}; }
+
+  console.log(\`[webhook] type=\${type}\`, JSON.stringify(body));
+
+  // TODO: dispatch based on type
+  return Response.json({ received: true, type });
+}
+`;
+  }
+
+  // Migration
+  let sql = `-- ${projectName} initial schema\n\n`;
+  if (routes.includes('users')) {
+    sql += `CREATE TABLE IF NOT EXISTS users (
+  id TEXT PRIMARY KEY,
+  email TEXT NOT NULL UNIQUE,
+  created_at INTEGER NOT NULL DEFAULT (unixepoch())
+);\n\n`;
+  }
+  if (routes.includes('content')) {
+    sql += `CREATE TABLE IF NOT EXISTS cms_pages (
+  id TEXT PRIMARY KEY,
+  slug TEXT NOT NULL UNIQUE,
+  title TEXT NOT NULL,
+  template TEXT NOT NULL DEFAULT 'default',
+  content_json TEXT,
+  status TEXT NOT NULL DEFAULT 'draft',
+  created_at INTEGER NOT NULL DEFAULT (unixepoch())
+);\n\n`;
+  }
+
+  files['migrations/001_init.sql'] = sql;
+
+  files['README.md'] = `# ${projectName}
+
+Scaffolded by [@inneranimalmedia/agentsam-sdk](https://github.com/SamPrimeaux/agentsam-sdk).
+
+## Routes
+
+${routes.map(r => `- \`/${r}\``).join('\n')}
+
+## Deploy
+
+\`\`\`bash
+npm install
+npx wrangler d1 create ${projectName}
+# paste database_id into wrangler.toml
+npx wrangler d1 execute ${projectName} --file=migrations/001_init.sql --remote
+npx wrangler deploy
+\`\`\`
+`;
+
+  return files;
+}
+
+function cap(str) {
+  return str.charAt(0).toUpperCase() + str.slice(1);
+}

package/src/lib/scaffold/wizards/cms.js

@@ -0,0 +1,175 @@
+/**
+ * CMS Site Scaffold Wizard
+ *
+ * Guides the user step-by-step through scaffolding a
+ * Cloudflare Worker + D1 + R2 CMS site with:
+ *   - global nav
+ *   - reusable page templates
+ *   - optional blog, contact, about pages
+ *   - wrangler.toml ready to deploy
+ */
+
+import {
+  text,
+  select,
+  multiselect,
+  confirm,
+  spinner,
+  note,
+  isCancel,
+  cancel,
+} from '@clack/prompts';
+import pc from 'picocolors';
+import { writeFileTree } from '../writer.js';
+import { cmsTemplates } from '../templates/cms/index.js';
+
+export async function runCmsWizard() {
+  note('A Cloudflare Worker + D1 + R2 CMS site with reusable page templates.', 'CMS Site');
+
+  // ── Step 1: Project name ──────────────────────────────────────────────────
+  const projectName = await text({
+    message: 'Project name?',
+    placeholder: 'my-client-site',
+    validate(val) {
+      if (!val || val.trim().length === 0) return 'Required.';
+      if (!/^[a-z0-9-]+$/.test(val.trim())) return 'Lowercase letters, numbers, and hyphens only.';
+    },
+  });
+  if (isCancel(projectName)) { cancel('Cancelled.'); process.exit(0); }
+
+  // ── Step 2: Site title ────────────────────────────────────────────────────
+  const siteTitle = await text({
+    message: 'Site title?',
+    placeholder: 'Acme Corp',
+    validate(val) {
+      if (!val || val.trim().length === 0) return 'Required.';
+    },
+  });
+  if (isCancel(siteTitle)) { cancel('Cancelled.'); process.exit(0); }
+
+  // ── Step 3: Nav style ─────────────────────────────────────────────────────
+  const navStyle = await select({
+    message: 'Global nav style?',
+    options: [
+      { value: 'topbar', label: 'Top bar', hint: 'Horizontal links, fixed to top' },
+      { value: 'sidebar', label: 'Sidebar', hint: 'Left rail, collapsible on mobile' },
+      { value: 'minimal', label: 'Minimal', hint: 'Logo + hamburger only' },
+    ],
+  });
+  if (isCancel(navStyle)) { cancel('Cancelled.'); process.exit(0); }
+
+  // ── Step 4: Pages to include ──────────────────────────────────────────────
+  const pages = await multiselect({
+    message: 'Which pages do you want? (space to toggle, enter to confirm)',
+    options: [
+      { value: 'home',    label: 'Home',    hint: 'Landing / hero section' },
+      { value: 'about',   label: 'About',   hint: 'About us / team' },
+      { value: 'services', label: 'Services', hint: 'Services or products list' },
+      { value: 'blog',    label: 'Blog',    hint: 'D1-backed post list + detail' },
+      { value: 'contact', label: 'Contact', hint: 'Contact form → Resend email' },
+      { value: 'privacy', label: 'Privacy', hint: 'Privacy policy (static)' },
+    ],
+    required: true,
+  });
+  if (isCancel(pages)) { cancel('Cancelled.'); process.exit(0); }
+
+  // ── Step 5: Page template style ───────────────────────────────────────────
+  const templateStyle = await select({
+    message: 'Page template style?',
+    options: [
+      {
+        value: 'fragment',
+        label: 'R2 HTML fragments',
+        hint: 'Each section is a .html fragment stored in R2, assembled by the Worker',
+      },
+      {
+        value: 'json',
+        label: 'D1-driven JSON blocks',
+        hint: 'Page content stored in D1 as JSON blocks, rendered server-side',
+      },
+      {
+        value: 'static',
+        label: 'Static HTML',
+        hint: 'Pre-rendered HTML files, no D1 dependency',
+      },
+    ],
+  });
+  if (isCancel(templateStyle)) { cancel('Cancelled.'); process.exit(0); }
+
+  // ── Step 6: Contact form destination (only if contact page selected) ──────
+  let contactEmail = null;
+  if (pages.includes('contact')) {
+    contactEmail = await text({
+      message: 'Where should contact form submissions go? (email)',
+      placeholder: 'hello@example.com',
+      validate(val) {
+        if (!val || val.trim().length === 0) return 'Required for contact page.';
+        if (!val.includes('@')) return 'Enter a valid email.';
+      },
+    });
+    if (isCancel(contactEmail)) { cancel('Cancelled.'); process.exit(0); }
+  }
+
+  // ── Step 7: Cloudflare account details ────────────────────────────────────
+  const cfAccountId = await text({
+    message: 'Cloudflare account ID? (from dash.cloudflare.com → right sidebar)',
+    placeholder: 'abc123...',
+    validate(val) {
+      if (!val || val.trim().length === 0) return 'Required for wrangler.toml.';
+    },
+  });
+  if (isCancel(cfAccountId)) { cancel('Cancelled.'); process.exit(0); }
+
+  // ── Step 8: Confirm before writing ───────────────────────────────────────
+  const summary = [
+    `  Project:   ${pc.cyan(projectName)}`,
+    `  Title:     ${pc.cyan(siteTitle)}`,
+    `  Nav:       ${pc.cyan(navStyle)}`,
+    `  Pages:     ${pc.cyan(pages.join(', '))}`,
+    `  Template:  ${pc.cyan(templateStyle)}`,
+    contactEmail ? `  Contact:   ${pc.cyan(contactEmail)}` : null,
+  ].filter(Boolean).join('\n');
+
+  note(summary, 'Your scaffold');
+
+  const confirmed = await confirm({ message: 'Write files now?' });
+  if (isCancel(confirmed) || !confirmed) { cancel('Cancelled.'); process.exit(0); }
+
+  // ── Write files ───────────────────────────────────────────────────────────
+  const s = spinner();
+  s.start('Generating files...');
+
+  const config = {
+    projectName: projectName.trim(),
+    siteTitle: siteTitle.trim(),
+    navStyle,
+    pages,
+    templateStyle,
+    contactEmail: contactEmail?.trim() ?? null,
+    cfAccountId: cfAccountId.trim(),
+  };
+
+  const fileTree = cmsTemplates(config);
+
+  await writeFileTree(`./${config.projectName}`, fileTree);
+
+  s.stop(pc.green(`Files written to ./${config.projectName}/`));
+
+  note(
+    [
+      `cd ${config.projectName}`,
+      `npm install`,
+      ``,
+      `# Create your D1 database:`,
+      `npx wrangler d1 create ${config.projectName}`,
+      `# Copy the database_id into wrangler.toml [[d1_databases]] binding`,
+      ``,
+      `# Run the D1 migration:`,
+      `npx wrangler d1 execute ${config.projectName} --file=migrations/001_init.sql --remote`,
+      ``,
+      `# Deploy:`,
+      `npx wrangler deploy`,
+    ].join('\n'),
+    'Next steps'
+  );
+}

package/src/lib/scaffold/wizards/worker-api.js

@@ -0,0 +1,76 @@
+/**
+ * Worker API Scaffold Wizard
+ * Bare Cloudflare Worker with typed route handlers and D1 binding.
+ */
+
+import {
+  text,
+  multiselect,
+  confirm,
+  spinner,
+  note,
+  isCancel,
+  cancel,
+} from '@clack/prompts';
+import pc from 'picocolors';
+import { writeFileTree } from '../writer.js';
+import { workerApiTemplates } from '../templates/worker-api/index.js';
+
+export async function runWorkerApiWizard() {
+  note('A typed Cloudflare Worker with route handlers, D1 binding, and CORS ready.', 'Worker API');
+
+  const projectName = await text({
+    message: 'Project name?',
+    placeholder: 'my-api-worker',
+    validate(val) {
+      if (!val || val.trim().length === 0) return 'Required.';
+      if (!/^[a-z0-9-]+$/.test(val.trim())) return 'Lowercase letters, numbers, and hyphens only.';
+    },
+  });
+  if (isCancel(projectName)) { cancel('Cancelled.'); process.exit(0); }
+
+  const routes = await multiselect({
+    message: 'Which route groups do you want?',
+    options: [
+      { value: 'health',  label: 'GET /health',         hint: 'Liveness check' },
+      { value: 'auth',    label: 'POST /auth/*',         hint: 'Token issue + verify' },
+      { value: 'users',   label: 'CRUD /users',          hint: 'D1-backed user records' },
+      { value: 'content', label: 'CRUD /content',        hint: 'Generic content/pages' },
+      { value: 'webhook', label: 'POST /webhooks/:type', hint: 'Inbound webhook receiver' },
+    ],
+    required: true,
+  });
+  if (isCancel(routes)) { cancel('Cancelled.'); process.exit(0); }
+
+  const cfAccountId = await text({
+    message: 'Cloudflare account ID?',
+    placeholder: 'abc123...',
+    validate(val) {
+      if (!val || val.trim().length === 0) return 'Required.';
+    },
+  });
+  if (isCancel(cfAccountId)) { cancel('Cancelled.'); process.exit(0); }
+
+  const confirmed = await confirm({ message: `Write files to ./${projectName.trim()}/?` });
+  if (isCancel(confirmed) || !confirmed) { cancel('Cancelled.'); process.exit(0); }
+
+  const s = spinner();
+  s.start('Generating files...');
+
+  const config = { projectName: projectName.trim(), routes, cfAccountId: cfAccountId.trim() };
+  const fileTree = workerApiTemplates(config);
+  await writeFileTree(`./${config.projectName}`, fileTree);
+
+  s.stop(pc.green(`Files written to ./${config.projectName}/`));
+
+  note(
+    [
+      `cd ${config.projectName}`,
+      `npm install`,
+      `npx wrangler d1 create ${config.projectName}`,
+      `npx wrangler d1 execute ${config.projectName} --file=migrations/001_init.sql --remote`,
+      `npx wrangler deploy`,
+    ].join('\n'),
+    'Next steps'
+  );
+}

package/src/lib/scaffold/writer.js

@@ -0,0 +1,22 @@
+/**
+ * Writes a nested file-tree object to disk.
+ *
+ * fileTree shape:
+ * {
+ *   'src/index.js': '// content',
+ *   'wrangler.toml': '...',
+ *   'migrations/001_init.sql': '...',
+ * }
+ */
+
+import fs from 'fs/promises';
+import path from 'path';
+
+export async function writeFileTree(baseDir, fileTree) {
+  for (const [relativePath, content] of Object.entries(fileTree)) {
+    const fullPath = path.join(baseDir, relativePath);
+    const dir = path.dirname(fullPath);
+    await fs.mkdir(dir, { recursive: true });
+    await fs.writeFile(fullPath, content, 'utf8');
+  }
+}

package/test/smoke.mjs

@@ -48,8 +48,8 @@ printContextSummary({
   iam: { ready: true, source: 'sdk-token', detail: 'AGENTSAM_SDK_TOKEN' },
   gcp: { source: 'vm-metadata', email: 'execos@project.iam.gserviceaccount.com' },
   gcp_vm: true,
-  github: { source: 'gh-cli', account: 'connor@example.com' },
-  cloudflare: { source: 'wrangler', account: 'connor@cloudflare.test' },
+  github: { source: 'gh-cli', account: 'user@example.com' },
+  cloudflare: { source: 'wrangler', account: 'user@cloudflare.test' },
 });
 assert.deepEqual(missingForInit({ iam: { ready: false } }, '', { runTarget: 'local' }), []);
 assert.deepEqual(missingForInit({ iam: { ready: false } }, '', { runTarget: 'cloudflare' }), ['iam']);