@inneranimalmedia/agentsam-sdk 1.1.0 → 1.2.0

package/src/AgentSam.js

@@ -0,0 +1,67 @@
+import { json, notFound, readJson } from './lib/responses.js';
+import { createSession, getSession } from './lib/sessions.js';
+import { routeIntent } from './lib/router.js';
+import { getToolCatalog } from './lib/tools.js';
+
+export class AgentSam {
+  constructor(options = {}) {
+    this.env = options.env ?? {};
+    this.agent = options.agent ?? 'orchestrator';
+    this.lane = options.lane ?? 'fullstack';
+    this.project = options.project ?? 'agentsam-project';
+  }
+
+  async handle(request) {
+    const url = new URL(request.url);
+    const path = url.pathname.replace(/\/$/, '') || '/';
+
+    if (request.method === 'GET' && path === '/api/health') {
+      return json({ ok: true, service: 'AgentSam', agent: this.agent, lane: this.lane, status: 'online' });
+    }
+
+    if (request.method === 'GET' && path === '/api/agentsam/info') {
+      return json({
+        ok: true,
+        name: 'AgentSam SDK',
+        project: this.project,
+        agent: this.agent,
+        lane: this.lane,
+        capabilities: getToolCatalog(this.lane).map((tool) => tool.name),
+      });
+    }
+
+    if (request.method === 'POST' && path === '/api/agentsam/session') {
+      const body = await readJson(request);
+      const session = await createSession({ env: this.env, agent: this.agent, lane: this.lane, goal: body.goal });
+      return json({ ok: true, session });
+    }
+
+    if (request.method === 'GET' && path.startsWith('/api/agentsam/session/')) {
+      const sessionId = path.split('/').pop();
+      const session = await getSession({ env: this.env, sessionId });
+      if (!session) return json({ ok: false, error: 'session_not_found' }, 404);
+      return json({ ok: true, session });
+    }
+
+    if (request.method === 'POST' && path === '/api/agentsam/message') {
+      const body = await readJson(request);
+      const result = routeIntent({
+        message: body.message ?? body.goal ?? '',
+        agent: body.agent ?? this.agent,
+        lane: body.lane ?? this.lane,
+      });
+
+      return json({
+        ok: true,
+        session_id: body.session_id ?? null,
+        agent: result.agent,
+        lane: result.lane,
+        intent: result.intent,
+        next_steps: result.next_steps,
+        requires_approval: result.requires_approval,
+      });
+    }
+
+    return notFound();
+  }
+}

package/src/cli.js

@@ -1,16 +1,34 @@
 #!/usr/bin/env node
 
 import readline from 'readline';
+import pkg from '../package.json' with { type: 'json' };
 import { scaffoldProject } from './lib/scaffold.js';
+import { SLASH_COMMANDS, SHELL_PHASES } from './lib/slash-commands.js';
 
-const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-const ask = (q) => new Promise(resolve => rl.question(q, resolve));
+const VERSION = pkg.version;
+
+function createPrompt() {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  return {
+    ask: (q) => new Promise((resolve) => rl.question(q, resolve)),
+    close: () => rl.close(),
+  };
+}
 
 const LANES = {
   '1': 'Full Stack',
-  '2': 'Data Solutions',
-  '3': 'Customer Management',
-  '4': 'Creative & Design',
+  '2': 'CMS',
+  '3': 'Data Solutions',
+  '4': 'Customer Management',
+  '5': 'Creative & Design',
+};
+
+const LANE_BY_SLUG = {
+  fullstack: 'Full Stack',
+  cms: 'CMS',
+  data: 'Data Solutions',
+  crm: 'Customer Management',
+  creative: 'Creative & Design',
 };
 
 const PROVIDERS = {
@@ -19,61 +37,89 @@ const PROVIDERS = {
   '3': 'Local / Self-hosted',
 };
 
+const PROVIDER_BY_SLUG = {
+  cloudflare: 'Cloudflare Workers',
+  github: 'GitHub + Cloudflare',
+  local: 'Local / Self-hosted',
+};
+
 const AGENTS = {
   '1': 'orchestrator',
-  '2': 'data',
-  '3': 'crm',
-  '4': 'creative',
+  '2': 'cms',
+  '3': 'data',
+  '4': 'crm',
+  '5': 'creative',
 };
 
-async function init() {
+function laneKeyFromLabel(label) {
+  const entry = Object.entries(LANES).find(([, v]) => v === label);
+  return entry?.[0] ?? '1';
+}
+
+function printHelp() {
   console.log(`
-  ╔═══════════════════════════════════╗
-  ║       Agent Sam SDK — Init        ║
-  ╚═══════════════════════════════════╝
-  `);
+  Agent Sam SDK — CLI v${VERSION}
 
-  const projectName = await ask('  Project name: ');
+  Usage:
+    agentsam init [options]     Scaffold a new Agent Sam project
+    agentsam shell              CLI shell UX info + slash commands (Gorilla Shell)
+    agentsam --version          Print version
+    agentsam --help             Show this help
 
-  console.log(`
-  Select a lane:
-    1) Full Stack
-    2) Data Solutions
-    3) Customer Management
-    4) Creative & Design
+  Init options (non-interactive):
+    --name <name>               Project directory name
+    --lane <fullstack|cms|data|crm|creative>
+    --provider <cloudflare|github|local>
+    --agent <orchestrator|cms|data|crm|creative>
+    --cf-account <id>           Cloudflare account ID
+    --yes                       Skip confirmation prompt
   `);
-  const laneKey = await ask('  Lane [1-4]: ');
-  const lane = LANES[laneKey] ?? 'Full Stack';
+}
 
-  let provider = 'Cloudflare Workers';
-  if (laneKey === '1') {
-    console.log(`
-  Select a provider:
-    1) Cloudflare Workers
-    2) GitHub + Cloudflare
-    3) Local / Self-hosted
-    `);
-    const providerKey = await ask('  Provider [1-3]: ');
-    provider = PROVIDERS[providerKey] ?? 'Cloudflare Workers';
+function parseInitArgs(argv) {
+  const opts = {
+    projectName: '',
+    lane: '',
+    provider: '',
+    agent: '',
+    cfAccountId: '',
+    yes: false,
+  };
+
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i];
+    if (arg === '--yes' || arg === '-y') opts.yes = true;
+    else if (arg === '--name') opts.projectName = argv[++i] || '';
+    else if (arg === '--lane') {
+      const slug = argv[++i] || '';
+      opts.lane = LANE_BY_SLUG[slug] || slug;
+    } else if (arg === '--provider') {
+      const slug = argv[++i] || '';
+      opts.provider = PROVIDER_BY_SLUG[slug] || slug;
+    } else if (arg === '--agent') opts.agent = argv[++i] || '';
+    else if (arg === '--cf-account') opts.cfAccountId = argv[++i] || '';
   }
 
-  console.log(`
-  Select your default Agent Sam:
-    1) Orchestrator    — general purpose, routes to all lanes
-    2) Data Agent      — database ops, migrations, queries
-    3) CRM Agent       — customer management, contacts, billing
-    4) Creative Agent  — design, 3D, media, content
-  `);
-  const agentKey = await ask('  Agent [1-4]: ');
-  const agent = AGENTS[agentKey] ?? 'orchestrator';
+  return opts;
+}
 
-  const cfAccountId = await ask('  Cloudflare Account ID (enter to skip): ');
+async function runInit(config) {
+  const {
+    projectName,
+    lane,
+    provider,
+    agent,
+    cfAccountId = '',
+    yes = false,
+    prompt = null,
+  } = config;
 
+  const safeDir = projectName.trim();
   console.log(`
   ┌─────────────────────────────────────┐
   │  Agent Sam Project Config           │
   ├─────────────────────────────────────┤
-  │  Project:   ${projectName.padEnd(25)}│
+  │  Project:   ${safeDir.padEnd(25)}│
   │  Lane:      ${lane.padEnd(25)}│
   │  Provider:  ${provider.padEnd(25)}│
   │  Agent:     ${agent.padEnd(25)}│
@@ -81,37 +127,167 @@ async function init() {
   └─────────────────────────────────────┘
   `);
 
-  const confirm = await ask('  Scaffold project? (y/n): ');
+  let confirm = 'y';
+  if (!yes && prompt) {
+    confirm = await prompt.ask('  Scaffold project? (y/n): ');
+  }
 
   if (confirm.toLowerCase() === 'y') {
-    const dir = scaffoldProject({ projectName, lane, provider, agent, cfAccountId });
-    console.log(`
+    try {
+      const dir = scaffoldProject({
+        projectName: safeDir,
+        lane,
+        provider,
+        agent,
+        cfAccountId,
+        sdkVersion: VERSION,
+      });
+      console.log(`
   ✓ Project created at ${dir}
 
   Next steps:
-    cd ${projectName}
+    cd ${dir.split('/').pop()}
     cp .env.example .env
     npm install
+    npm run smoke
     npm run dev
     `);
+    } catch (error) {
+      console.error(`\n  ✗ ${error.message}\n`);
+      process.exitCode = 1;
+    }
   } else {
     console.log('\n  Cancelled.\n');
   }
+}
+
+async function initInteractive(partial = {}) {
+  const prompt = createPrompt();
+
+  console.log(`
+  ╔═══════════════════════════════════╗
+  ║       Agent Sam SDK — Init        ║
+  ╚═══════════════════════════════════╝
+  `);
+
+  const projectName = partial.projectName || (await prompt.ask('  Project name: '));
+
+  if (!partial.lane) {
+    console.log(`
+  Select a lane:
+    1) Full Stack
+    2) CMS
+    3) Data Solutions
+    4) Customer Management
+    5) Creative & Design
+  `);
+  }
+  const laneKey = partial.lane ? laneKeyFromLabel(partial.lane) : await prompt.ask('  Lane [1-5]: ');
+  const lane = partial.lane || LANES[laneKey] || 'Full Stack';
+
+  console.log(`
+  Select a provider:
+    1) Cloudflare Workers
+    2) GitHub + Cloudflare
+    3) Local / Self-hosted
+  `);
+  const providerKey = partial.provider
+    ? Object.entries(PROVIDERS).find(([, v]) => v === partial.provider)?.[0] || '1'
+    : await prompt.ask('  Provider [1-3]: ');
+  const provider = partial.provider || PROVIDERS[providerKey] || 'Cloudflare Workers';
+
+  if (!partial.agent) {
+    console.log(`
+  Select your default Agent Sam:
+    1) Orchestrator    — general purpose, routes to all lanes
+    2) CMS Agent       — pages, sections, assets, publishing workflows
+    3) Data Agent      — database ops, migrations, queries
+    4) CRM Agent       — customer management, contacts, billing
+    5) Creative Agent  — design, 3D, media, content
+  `);
+  }
+  const agentKey = partial.agent
+    ? Object.entries(AGENTS).find(([, v]) => v === partial.agent)?.[0] || '1'
+    : await prompt.ask('  Agent [1-5]: ');
+  const agent = partial.agent || AGENTS[agentKey] || 'orchestrator';
 
-  rl.close();
+  const cfAccountId =
+    partial.cfAccountId !== undefined && partial.cfAccountId !== ''
+      ? partial.cfAccountId
+      : await prompt.ask('  Cloudflare Account ID (enter to skip): ');
+
+  await runInit({
+    projectName,
+    lane,
+    provider,
+    agent,
+    cfAccountId,
+    yes: partial.yes,
+    prompt,
+  });
+
+  prompt.close();
 }
 
-const command = process.argv[2];
+async function initFromArgs(argv) {
+  const opts = parseInitArgs(argv);
+  if (!opts.projectName) {
+    console.error('\n  ✗ --name is required for non-interactive init.\n');
+    process.exit(1);
+  }
+  await runInit({
+    projectName: opts.projectName,
+    lane: opts.lane || 'Full Stack',
+    provider: opts.provider || 'Cloudflare Workers',
+    agent: opts.agent || 'orchestrator',
+    cfAccountId: opts.cfAccountId,
+    yes: true,
+    prompt: null,
+  });
+}
 
-if (command === 'init') {
-  init();
-} else {
+async function runShellInfo() {
+  const next = SHELL_PHASES.find((p) => p.status === 'next');
   console.log(`
-  Agent Sam SDK — CLI
+  ╔═══════════════════════════════════╗
+  ║     Agent Sam Shell (Gorilla)     ║
+  ╚═══════════════════════════════════╝
 
-  Usage:
-    agentsam init        Initialize a new Agent Sam project
+  Game-feel terminal UX for SDK installs — HUD, themes, slash commands, PTY bridge.
+
+  Phase 0 prototype: examples/gorilla-shell/
+  Docs:              docs/CLI_SHELL.md
+  Next milestone:    ${next?.label ?? 'PTY connection'}
 
-  Version: 1.0.0
+  Slash commands (${SLASH_COMMANDS.length} registered):
+`);
+  for (const row of SLASH_COMMANDS) {
+    console.log(`    ${row.cmd.padEnd(14)} ${row.description}`);
+  }
+  console.log(`
+  Run the visual prototype:
+    cd examples/gorilla-shell && npm install && npm run dev
   `);
 }
+
+const command = process.argv[2];
+const rest = process.argv.slice(3);
+
+if (command === '--version' || command === '-v') {
+  console.log(VERSION);
+} else if (command === '--help' || command === '-h' || !command) {
+  printHelp();
+} else if (command === 'shell') {
+  await runShellInfo();
+} else if (command === 'init') {
+  const hasFlags = rest.some((a) => a.startsWith('--'));
+  if (hasFlags) {
+    await initFromArgs(rest);
+  } else {
+    await initInteractive({});
+  }
+} else {
+  console.error(`\n  Unknown command: ${command}\n`);
+  printHelp();
+  process.exit(1);
+}

package/src/index.js

@@ -1,5 +1,17 @@
-// @inneranimalmedia/agentsam-sdk
-// Agent Sam SDK — entry point
+// @inneranimalmedia/agentsam-sdk — public API
 
-export const version = '1.0.0';
-export const name = 'agentsam-sdk';
+import pkg from '../package.json' with { type: 'json' };
+
+export { AgentSam } from './AgentSam.js';
+export { routeIntent } from './lib/router.js';
+export { getToolCatalog } from './lib/tools.js';
+export { scaffoldProject } from './lib/scaffold.js';
+export {
+  SLASH_COMMANDS,
+  SHELL_THEMES,
+  SHELL_PHASES,
+  listSlashCommands,
+} from './lib/slash-commands.js';
+
+export const version = pkg.version;
+export const name = pkg.name;

package/src/lib/responses.js

@@ -0,0 +1,21 @@
+export function json(data, status = 200, headers = {}) {
+  return new Response(JSON.stringify(data, null, 2), {
+    status,
+    headers: {
+      'content-type': 'application/json; charset=utf-8',
+      ...headers,
+    },
+  });
+}
+
+export function notFound() {
+  return json({ ok: false, error: 'not_found' }, 404);
+}
+
+export async function readJson(request) {
+  try {
+    return await request.json();
+  } catch {
+    return {};
+  }
+}

package/src/lib/router.js

@@ -0,0 +1,51 @@
+export function routeIntent({ message = '', agent = 'orchestrator', lane = 'fullstack' }) {
+  const text = String(message).toLowerCase();
+
+  if (/delete|drop table|destroy|wipe|purge|production/.test(text)) {
+    return {
+      agent,
+      lane,
+      intent: 'high_risk_action',
+      requires_approval: true,
+      next_steps: ['Summarize intended change', 'Request explicit approval', 'Run only after approval'],
+    };
+  }
+
+  if (/page|cms|publish|section|hero|content/.test(text)) {
+    return {
+      agent: 'cms',
+      lane: 'cms',
+      intent: 'cms_build',
+      requires_approval: false,
+      next_steps: ['Create page outline', 'Attach visual assets', 'Prepare draft for preview'],
+    };
+  }
+
+  if (/database|sql|query|migration|schema|supabase|d1/.test(text)) {
+    return {
+      agent: 'data',
+      lane: 'data',
+      intent: 'data_task',
+      requires_approval: false,
+      next_steps: ['Inspect schema', 'Draft safe query or migration', 'Return reviewable plan'],
+    };
+  }
+
+  if (/design|3d|cad|media|video|image|creative/.test(text)) {
+    return {
+      agent: 'creative',
+      lane: 'creative',
+      intent: 'creative_task',
+      requires_approval: false,
+      next_steps: ['Create production brief', 'Identify assets needed', 'Prepare generation or build steps'],
+    };
+  }
+
+  return {
+    agent,
+    lane,
+    intent: 'general_build',
+    requires_approval: false,
+    next_steps: ['Understand goal', 'Plan the work', 'Route to the right specialist'],
+  };
+}