@inneranimalmedia/agentsam-sdk 1.1.0 → 1.2.0

package/src/lib/scaffold.js

@@ -1,162 +1,260 @@
 import fs from 'fs';
 import path from 'path';
 
-export function scaffoldProject({ projectName, lane, provider, agent, cfAccountId }) {
-  const dir = path.resolve(process.cwd(), projectName);
+const LANE_KEYS = {
+  'Full Stack': 'fullstack',
+  CMS: 'cms',
+  'Data Solutions': 'data',
+  'Customer Management': 'crm',
+  'Creative & Design': 'creative',
+};
+
+const AGENT_FOR_LANE = {
+  fullstack: 'orchestrator',
+  cms: 'cms',
+  data: 'data',
+  crm: 'crm',
+  creative: 'creative',
+};
+
+function write(file, content) {
+  fs.mkdirSync(path.dirname(file), { recursive: true });
+  fs.writeFileSync(file, content.trimStart());
+}
+
+function slugify(value) {
+  return String(value || 'agentsam-project')
+    .trim()
+    .toLowerCase()
+    .replace(/[^a-z0-9-]+/g, '-')
+    .replace(/^-+|-+$/g, '') || 'agentsam-project';
+}
+
+function workerTemplate({ projectName, laneKey, agent }) {
+  return `
+import { AgentSam } from '@inneranimalmedia/agentsam-sdk';
+
+export default {
+  async fetch(request, env, ctx) {
+    const agent = new AgentSam({
+      env,
+      ctx,
+      project: '${projectName}',
+      lane: '${laneKey}',
+      agent: '${agent}',
+    });
+
+    return agent.handle(request);
+  },
+};
+`;
+}
+
+function migrationTemplate({ projectName, laneKey }) {
+  return `
+-- AgentSam core schema for ${projectName}
+CREATE TABLE IF NOT EXISTS agent_sessions (
+  id TEXT PRIMARY KEY,
+  agent TEXT NOT NULL,
+  lane TEXT NOT NULL,
+  goal TEXT,
+  status TEXT NOT NULL DEFAULT 'created',
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE TABLE IF NOT EXISTS agent_messages (
+  id TEXT PRIMARY KEY,
+  session_id TEXT NOT NULL,
+  role TEXT NOT NULL,
+  content TEXT NOT NULL,
+  metadata_json TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  FOREIGN KEY (session_id) REFERENCES agent_sessions(id)
+);
+
+CREATE TABLE IF NOT EXISTS agent_tool_calls (
+  id TEXT PRIMARY KEY,
+  session_id TEXT NOT NULL,
+  tool_name TEXT NOT NULL,
+  status TEXT NOT NULL DEFAULT 'queued',
+  input_json TEXT,
+  output_json TEXT,
+  requires_approval INTEGER NOT NULL DEFAULT 0,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  completed_at TEXT,
+  FOREIGN KEY (session_id) REFERENCES agent_sessions(id)
+);
+
+${laneKey === 'cms' ? `
+CREATE TABLE IF NOT EXISTS cms_pages (
+  id TEXT PRIMARY KEY,
+  slug TEXT NOT NULL UNIQUE,
+  title TEXT NOT NULL,
+  status TEXT NOT NULL DEFAULT 'draft',
+  hero_asset_key TEXT,
+  content_json TEXT NOT NULL DEFAULT '{}',
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE TABLE IF NOT EXISTS cms_assets (
+  id TEXT PRIMARY KEY,
+  r2_key TEXT NOT NULL UNIQUE,
+  title TEXT,
+  alt_text TEXT,
+  metadata_json TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+` : ''}
+`;
+}
+
+function readmeTemplate({ projectName, lane, provider, agent }) {
+  return `
+# ${projectName}
+
+Scaffolded with [@inneranimalmedia/agentsam-sdk](https://www.npmjs.com/package/@inneranimalmedia/agentsam-sdk).
+
+## Lane
+
+**${lane}** — ${agent} agent, ${provider}
+
+## Setup
+
+\`\`\`bash
+cp .env.example .env
+npm install
+\`\`\`
+
+## Dev
+
+\`\`\`bash
+npm run dev
+npm run smoke
+\`\`\`
+
+## Deploy
+
+\`\`\`bash
+npm run deploy
+\`\`\`
+
+## Endpoints
+
+- \`GET /api/health\`
+- \`GET /api/agentsam/info\`
+- \`POST /api/agentsam/session\`
+- \`POST /api/agentsam/message\`
+`;
+}
+
+export function scaffoldProject({
+  projectName,
+  lane,
+  provider,
+  agent,
+  cfAccountId,
+  sdkVersion = '1.1.1',
+}) {
+  const safeName = slugify(projectName);
+  const dir = path.resolve(process.cwd(), safeName);
+  const laneKey = LANE_KEYS[lane] ?? 'fullstack';
+  const selectedAgent = agent || AGENT_FOR_LANE[laneKey] || 'orchestrator';
+  const sdkRange = `^${sdkVersion.split('.').slice(0, 2).join('.')}.0`;
 
   if (fs.existsSync(dir)) {
-    console.error(`\n  ✗ Directory "${projectName}" already exists.\n`);
-    process.exit(1);
+    throw new Error(`Directory "${safeName}" already exists.`);
   }
 
   fs.mkdirSync(dir, { recursive: true });
   fs.mkdirSync(`${dir}/src`, { recursive: true });
+  fs.mkdirSync(`${dir}/migrations`, { recursive: true });
 
-  // agentsam.config.js
-  fs.writeFileSync(`${dir}/agentsam.config.js`, `
+  write(`${dir}/agentsam.config.js`, `
 export default {
-  project: '${projectName}',
-  lane: '${lane}',
+  project: '${safeName}',
+  lane: '${laneKey}',
   provider: '${provider}',
-  agent: '${agent}',
+  agent: '${selectedAgent}',
   cloudflare: {
     accountId: '${cfAccountId || ''}',
   },
   api: {
-    baseUrl: 'https://api.inneranimalmedia.com',
+    baseUrl: '/api/agentsam',
   },
 };
-`.trimStart());
+`);
 
-  // .env.example
-  fs.writeFileSync(`${dir}/.env.example`, `
+  write(`${dir}/.env.example`, `
 AGENTSAM_API_KEY=
 CLOUDFLARE_ACCOUNT_ID=${cfAccountId || ''}
 CLOUDFLARE_API_TOKEN=
-`.trimStart());
+`);
 
-  // .gitignore
-  fs.writeFileSync(`${dir}/.gitignore`, `
+  write(`${dir}/.gitignore`, `
 node_modules/
 .env
 .dev.vars
 dist/
-`.trimStart());
+.wrangler/
+`);
 
-  // package.json
-  fs.writeFileSync(`${dir}/package.json`, JSON.stringify({
-    name: projectName,
+  write(`${dir}/package.json`, `${JSON.stringify({
+    name: safeName,
     version: '0.1.0',
     type: 'module',
+    private: true,
     scripts: {
       dev: 'wrangler dev',
       deploy: 'wrangler deploy',
+      smoke: 'node ./scripts/smoke.mjs',
     },
     dependencies: {
-      '@inneranimalmedia/agentsam-sdk': '^1.0.0',
+      '@inneranimalmedia/agentsam-sdk': sdkRange,
     },
-  }, null, 2));
-
-  // Lane-specific files
-  if (lane === 'Full Stack' || lane === 'Data Solutions') {
-    fs.mkdirSync(`${dir}/migrations`, { recursive: true });
-    fs.writeFileSync(`${dir}/migrations/0001_init.sql`, `
--- Initial schema for ${projectName}
-CREATE TABLE IF NOT EXISTS agent_sessions (
-  id TEXT PRIMARY KEY,
-  user_id TEXT NOT NULL,
-  created_at INTEGER DEFAULT (unixepoch())
-);
-`.trimStart());
-  }
+    devDependencies: {
+      wrangler: '^4.0.0',
+    },
+  }, null, 2)}\n`);
 
-  if (lane === 'Full Stack' || provider === 'Cloudflare Workers' || provider === 'GitHub + Cloudflare') {
-    fs.writeFileSync(`${dir}/wrangler.toml`, `
-name = "${projectName}"
+  write(`${dir}/wrangler.toml`, `
+name = "${safeName}"
 main = "src/index.js"
-compatibility_date = "2025-01-01"
+compatibility_date = "2026-06-27"
 
 [[d1_databases]]
 binding = "DB"
-database_name = "${projectName}-db"
-database_id = ""
-`.trimStart());
-  }
+database_name = "${safeName}-db"
+database_id = "REPLACE_WITH_D1_DATABASE_ID"
 
-  // src/index.js — lane-specific worker
-  const workers = {
-    'Full Stack': `
-import { AgentSam } from '@inneranimalmedia/agentsam-sdk';
+[[kv_namespaces]]
+binding = "KV"
+id = "REPLACE_WITH_KV_NAMESPACE_ID"
 
-export default {
-  async fetch(request, env, ctx) {
-    const agent = new AgentSam({ env, agent: 'orchestrator' });
-    return agent.handle(request);
-  },
-};
-`,
-    'Data Solutions': `
-import { AgentSam } from '@inneranimalmedia/agentsam-sdk';
+[[r2_buckets]]
+binding = "R2"
+bucket_name = "${safeName}"
+`);
 
-export default {
-  async fetch(request, env, ctx) {
-    const agent = new AgentSam({ env, agent: 'data' });
-    return agent.handle(request);
-  },
-};
-`,
-    'Customer Management': `
-import { AgentSam } from '@inneranimalmedia/agentsam-sdk';
+  write(`${dir}/migrations/0001_agentsam_core.sql`, migrationTemplate({ projectName: safeName, laneKey }));
+  write(`${dir}/src/index.js`, workerTemplate({ projectName: safeName, laneKey, agent: selectedAgent }));
+  write(`${dir}/README.md`, readmeTemplate({ projectName: safeName, lane, provider, agent: selectedAgent }));
 
-export default {
-  async fetch(request, env, ctx) {
-    const agent = new AgentSam({ env, agent: 'crm' });
-    return agent.handle(request);
-  },
-};
-`,
-    'Creative & Design': `
+  write(`${dir}/scripts/smoke.mjs`, `
 import { AgentSam } from '@inneranimalmedia/agentsam-sdk';
 
-export default {
-  async fetch(request, env, ctx) {
-    const agent = new AgentSam({ env, agent: 'creative' });
-    return agent.handle(request);
-  },
-};
-`,
-  };
-
-  fs.writeFileSync(`${dir}/src/index.js`, workers[lane].trimStart());
-
-  // README
-  fs.writeFileSync(`${dir}/README.md`, `
-# ${projectName}
-
-Scaffolded with [Agent Sam SDK](https://www.npmjs.com/package/@inneranimalmedia/agentsam-sdk).
+const app = new AgentSam({ project: '${safeName}', lane: '${laneKey}', agent: '${selectedAgent}' });
+const res = await app.handle(new Request('https://example.com/api/health'));
+const data = await res.json();
 
-## Lane
-**${lane}** — ${agent} agent, ${provider}
-
-## Setup
-
-\`\`\`bash
-cp .env.example .env
-npm install
-\`\`\`
-
-## Dev
-
-\`\`\`bash
-npm run dev
-\`\`\`
-
-## Deploy
+if (!data.ok) {
+  console.error(data);
+  process.exit(1);
+}
 
-\`\`\`bash
-npm run deploy
-\`\`\`
-`.trimStart());
+console.log('AgentSam smoke test passed:', data);
+`);
 
   return dir;
 }

package/src/lib/sessions.js

@@ -0,0 +1,53 @@
+export async function createSession({ env, agent, lane, goal }) {
+  const now = new Date().toISOString();
+  const session = {
+    id: crypto.randomUUID(),
+    agent,
+    lane,
+    goal: goal ?? null,
+    status: 'created',
+    created_at: now,
+    updated_at: now,
+  };
+
+  if (env?.KV?.put) {
+    await env.KV.put(`agentsam:session:${session.id}`, JSON.stringify(session), { expirationTtl: 60 * 60 * 24 * 7 });
+  }
+
+  if (env?.DB?.prepare) {
+    await env.DB.prepare(
+      `CREATE TABLE IF NOT EXISTS agent_sessions (
+        id TEXT PRIMARY KEY,
+        agent TEXT NOT NULL,
+        lane TEXT NOT NULL,
+        goal TEXT,
+        status TEXT NOT NULL,
+        created_at TEXT NOT NULL,
+        updated_at TEXT NOT NULL
+      )`
+    ).run();
+
+    await env.DB.prepare(
+      `INSERT INTO agent_sessions (id, agent, lane, goal, status, created_at, updated_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?)`
+    ).bind(session.id, session.agent, session.lane, session.goal, session.status, session.created_at, session.updated_at).run();
+  }
+
+  return session;
+}
+
+export async function getSession({ env, sessionId }) {
+  if (!sessionId) return null;
+
+  if (env?.KV?.get) {
+    const raw = await env.KV.get(`agentsam:session:${sessionId}`);
+    if (raw) return JSON.parse(raw);
+  }
+
+  if (env?.DB?.prepare) {
+    const row = await env.DB.prepare('SELECT * FROM agent_sessions WHERE id = ?').bind(sessionId).first();
+    if (row) return row;
+  }
+
+  return null;
+}

package/src/lib/slash-commands.js

@@ -0,0 +1,40 @@
+/**
+ * Canonical slash-command surface for Agent Sam SDK CLI / shell UX.
+ * Consumed by the gorilla-shell example and future `agentsam shell` PTY bridge.
+ */
+
+export const SHELL_THEMES = ['NIGHT', 'DAY', 'LAVA', 'VOID'];
+
+/** @type {Array<{ cmd: string, description: string, lane?: string }>} */
+export const SLASH_COMMANDS = [
+  { cmd: '/cd', description: 'Change working directory', lane: 'terminal' },
+  { cmd: '/pwd', description: 'Print working directory', lane: 'terminal' },
+  { cmd: '/gh', description: 'GitHub operations (status, PR, issue)', lane: 'git' },
+  { cmd: '/wrangler', description: 'Wrangler deploy and bindings', lane: 'deploy' },
+  { cmd: '/workspace', description: 'Switch or show active workspace', lane: 'platform' },
+  { cmd: '/samiam', description: 'Agent Sam quick invoke', lane: 'agent' },
+  { cmd: '/claude', description: 'Route prompt to Claude arm', lane: 'agent' },
+  { cmd: '/codex', description: 'Route prompt to Codex arm', lane: 'agent' },
+  { cmd: '/tail', description: 'Tail worker logs', lane: 'observability' },
+  { cmd: '/d1', description: 'D1 query helper', lane: 'data' },
+  { cmd: '/deploy', description: 'Deploy worker (sandbox or prod gate)', lane: 'deploy' },
+  { cmd: '/buddy', description: 'Open Agent Sam buddy panel (MCP)', lane: 'agent' },
+  { cmd: '/status', description: 'Platform + project health', lane: 'platform' },
+  { cmd: '/diagnostics', description: 'Run diagnostic scenario', lane: 'platform' },
+];
+
+/** Shell UX rollout phases (gorilla-shell → SDK default CLI experience). */
+export const SHELL_PHASES = [
+  { id: '0-prototype', label: 'Visual prototype + demo scenarios', status: 'complete' },
+  { id: 'pty-connection', label: 'ExecOS / iam-pty WebSocket bridge', status: 'next' },
+  { id: 'hud-layer', label: 'Quest log, tool gate, XP HUD', status: 'planned' },
+  { id: 'buddy-system', label: 'In-shell Agent Sam via MCP', status: 'planned' },
+  { id: 'dashboard-embed', label: 'Embeddable shell for IAM dashboard', status: 'planned' },
+  { id: 'standalone-pwa', label: 'Installable PWA / SDK default shell', status: 'planned' },
+];
+
+export function listSlashCommands(opts = {}) {
+  const lane = opts.lane ? String(opts.lane).trim().toLowerCase() : '';
+  if (!lane) return [...SLASH_COMMANDS];
+  return SLASH_COMMANDS.filter((row) => !row.lane || row.lane === lane);
+}

package/src/lib/tools.js

@@ -0,0 +1,38 @@
+const CATALOG = {
+  fullstack: [
+    { name: 'plan', description: 'Break a goal into implementation steps.' },
+    { name: 'code', description: 'Generate or revise application code.' },
+    { name: 'deploy', description: 'Prepare deployment steps and checks.' },
+  ],
+  cms: [
+    { name: 'page', description: 'Create and revise pages.' },
+    { name: 'asset', description: 'Attach cover images and media.' },
+    { name: 'publish', description: 'Draft, preview, and publish content.' },
+  ],
+  data: [
+    { name: 'schema', description: 'Inspect and plan database schemas.' },
+    { name: 'query', description: 'Draft safe SQL queries.' },
+    { name: 'migration', description: 'Plan D1 or Postgres migrations.' },
+  ],
+  crm: [
+    { name: 'contact', description: 'Organize contacts and accounts.' },
+    { name: 'workflow', description: 'Coordinate customer workflows.' },
+  ],
+  creative: [
+    { name: 'brief', description: 'Turn creative intent into a production brief.' },
+    { name: 'asset', description: 'Plan media, 3D, and design assets.' },
+  ],
+};
+
+export function normalizeLane(lane = 'fullstack') {
+  return String(lane).toLowerCase().replace(/\s+/g, '').replace('&', '');
+}
+
+export function getToolCatalog(lane = 'fullstack') {
+  const key = normalizeLane(lane);
+  if (key.includes('cms')) return CATALOG.cms;
+  if (key.includes('data')) return CATALOG.data;
+  if (key.includes('customer') || key.includes('crm')) return CATALOG.crm;
+  if (key.includes('creative') || key.includes('design')) return CATALOG.creative;
+  return CATALOG.fullstack;
+}

package/src/schemas/config.js

@@ -0,0 +1,2 @@
+export const LANES = ['fullstack', 'cms', 'data', 'crm', 'creative'];
+export const AGENTS = ['orchestrator', 'cms', 'data', 'crm', 'creative'];

package/test/smoke.mjs

@@ -0,0 +1,42 @@
+import assert from 'node:assert/strict';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { AgentSam, routeIntent, getToolCatalog } from '../src/index.js';
+import { scaffoldProject } from '../src/lib/scaffold.js';
+
+const app = new AgentSam({ project: 'smoke', lane: 'cms', agent: 'cms' });
+let res = await app.handle(new Request('https://example.com/api/health'));
+assert.equal(res.status, 200);
+assert.equal((await res.json()).ok, true);
+
+res = await app.handle(new Request('https://example.com/api/agentsam/info'));
+const info = await res.json();
+assert.equal(info.agent, 'cms');
+assert.ok(info.capabilities.includes('page'));
+
+res = await app.handle(new Request('https://example.com/api/agentsam/message', {
+  method: 'POST',
+  body: JSON.stringify({ message: 'create an analytics page in the cms' }),
+}));
+const message = await res.json();
+assert.equal(message.agent, 'cms');
+assert.equal(message.intent, 'cms_build');
+
+assert.equal(routeIntent({ message: 'drop table users' }).requires_approval, true);
+assert.ok(getToolCatalog('Data Solutions').some((tool) => tool.name === 'query'));
+
+const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'agentsam-sdk-test-'));
+const cwd = process.cwd();
+process.chdir(tmp);
+const dir = scaffoldProject({ projectName: 'CMS Demo', lane: 'CMS', provider: 'Cloudflare Workers', agent: 'cms' });
+process.chdir(cwd);
+assert.ok(fs.existsSync(path.join(dir, 'src/index.js')));
+assert.ok(fs.readFileSync(path.join(dir, 'migrations/0001_agentsam_core.sql'), 'utf8').includes('cms_pages'));
+assert.ok(fs.readFileSync(path.join(dir, 'package.json'), 'utf8').includes('wrangler'));
+
+import { SLASH_COMMANDS, listSlashCommands } from '../src/lib/slash-commands.js';
+assert.ok(SLASH_COMMANDS.some((c) => c.cmd === '/deploy'));
+assert.equal(listSlashCommands({ lane: 'deploy' }).length, 2);
+
+console.log('SDK smoke tests passed');