@inneranimalmedia/agentsam-sdk 1.2.0 → 1.5.0

package/src/lib/local-scaffold.js

@@ -0,0 +1,373 @@
+/**
+ * Local-first scaffold — no IAM, no Cloudflare, no OAuth.
+ * Connor proves the pattern on localhost; `agentsam deploy` graduates to cloud.
+ */
+
+const LANE_KEYS = {
+  '1': 'fullstack',
+  '2': 'cms',
+  '3': 'data',
+  '4': 'crm',
+  '5': 'creative',
+  fullstack: 'fullstack',
+  cms: 'cms',
+  data: 'data',
+  crm: 'crm',
+  creative: 'creative',
+};
+
+const LANE_LABELS = {
+  fullstack: 'Full Stack',
+  cms: 'CMS',
+  data: 'Data Solutions',
+  crm: 'Customer Management',
+  creative: 'Creative & Design',
+};
+
+const AGENT_FOR_LANE = {
+  fullstack: 'orchestrator',
+  cms: 'cms',
+  data: 'data',
+  crm: 'crm',
+  creative: 'creative',
+};
+
+const RUN_TARGETS = {
+  '1': 'local',
+  '2': 'cloudflare',
+  '3': 'gcp',
+  local: 'local',
+  cloudflare: 'cloudflare',
+  gcp: 'gcp',
+};
+
+export { LANE_KEYS, LANE_LABELS, RUN_TARGETS };
+
+export function normalizeLane(raw) {
+  const k = String(raw || 'fullstack').trim().toLowerCase();
+  return LANE_KEYS[k] || (LANE_LABELS[k] ? k : 'fullstack');
+}
+
+export function normalizeRunTarget(raw) {
+  const k = String(raw || 'local').trim().toLowerCase();
+  return RUN_TARGETS[k] || 'local';
+}
+
+function migrationSql(laneKey) {
+  const cmsExtra =
+    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'))
+);
+`
+      : '';
+
+  return `-- AgentSam local schema (${laneKey})
+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)
+);
+${cmsExtra}
+`.trim();
+}
+
+/**
+ * @param {{ projectName: string, laneKey: string, laneLabel: string, agent: string, runTarget: string, sdkVersion: string }}
+ */
+export function buildLocalScaffoldFiles({
+  projectName,
+  laneKey,
+  laneLabel,
+  agent,
+  runTarget,
+  sdkVersion = '1.5.0',
+}) {
+  const sdkRange = `^${sdkVersion.split('.').slice(0, 2).join('.')}.0`;
+  const migration = migrationSql(laneKey);
+
+  return [
+    {
+      path: 'agentsam.config.js',
+      content: `export default {
+  project: '${projectName}',
+  lane: '${laneKey}',
+  agent: '${agent}',
+  runTarget: '${runTarget}',
+  api: { baseUrl: '/api/agentsam' },
+};
+`,
+    },
+    {
+      path: '.agentsam/config.json',
+      content: `${JSON.stringify(
+        {
+          project: projectName,
+          lane: laneKey,
+          agent,
+          run_target: 'local',
+          deploy_target: runTarget === 'local' ? null : runTarget,
+          pty_port: 3099,
+          dev_port: 8787,
+          scaffold_version: sdkVersion,
+        },
+        null,
+        2,
+      )}\n`,
+    },
+    {
+      path: '.agentsam/start-local.md',
+      content: `# Local terminal (no Cloudflare tunnel)
+
+Agent Sam runs a PTY on **your machine** — no accounts, no cloudflared, no IAM login required.
+
+\`\`\`bash
+# Terminal 1 — local PTY (Agent Sam shell bridge)
+npx agentsam start-local
+
+# Terminal 2 — app dev server
+npm run dev
+npm run db:migrate   # first time only
+\`\`\`
+
+PTY listens on \`ws://127.0.0.1:3099\`. Health: \`curl http://127.0.0.1:3099/health\`
+
+When you're ready to ship to Cloudflare or GCP:
+
+\`\`\`bash
+npx agentsam deploy
+\`\`\`
+`,
+    },
+    {
+      path: '.gitignore',
+      content: `node_modules/
+.env
+.dev.vars
+dist/
+.wrangler/
+*.db
+`,
+    },
+    {
+      path: 'package.json',
+      content: `${JSON.stringify(
+        {
+          name: projectName,
+          version: '0.1.0',
+          type: 'module',
+          private: true,
+          scripts: {
+            dev: 'wrangler dev --local',
+            'dev:node': 'node --watch src/dev-server.js',
+            deploy: 'wrangler deploy',
+            smoke: 'node ./scripts/smoke.mjs',
+            'db:migrate': 'wrangler d1 migrations apply DB --local',
+            'start:pty': 'agentsam start-local',
+          },
+          dependencies: {
+            '@inneranimalmedia/agentsam-sdk': sdkRange,
+          },
+          devDependencies: {
+            wrangler: '^4.0.0',
+          },
+        },
+        null,
+        2,
+      )}\n`,
+    },
+    {
+      path: 'wrangler.toml',
+      content: `name = "${projectName}"
+main = "src/index.js"
+compatibility_date = "2026-06-27"
+
+[[d1_databases]]
+binding = "DB"
+database_name = "${projectName}-db"
+database_id = "local-dev"
+
+[dev]
+port = 8787
+local_protocol = "http"
+`,
+    },
+    {
+      path: 'migrations/0001_agentsam_core.sql',
+      content: `${migration}\n`,
+    },
+    {
+      path: 'src/index.js',
+      content: `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);
+  },
+};
+`,
+    },
+    {
+      path: 'src/dev-server.js',
+      content: `/**
+ * Plain Node dev server — no Cloudflare account required.
+ * Use when wrangler is unavailable: npm run dev:node
+ */
+import { createServer } from 'node:http';
+import { AgentSam } from '@inneranimalmedia/agentsam-sdk';
+
+const app = new AgentSam({
+  project: '${projectName}',
+  lane: '${laneKey}',
+  agent: '${agent}',
+});
+
+const port = Number(process.env.PORT || 8787);
+
+createServer(async (req, res) => {
+  const url = \`http://127.0.0.1\${req.url || '/'}\`;
+  const headers = new Headers();
+  for (const [k, v] of Object.entries(req.headers)) {
+    if (v != null) headers.set(k, Array.isArray(v) ? v.join(', ') : v);
+  }
+  let body;
+  if (req.method !== 'GET' && req.method !== 'HEAD') {
+    const chunks = [];
+    for await (const chunk of req) chunks.push(chunk);
+    body = Buffer.concat(chunks);
+  }
+  const response = await app.handle(new Request(url, { method: req.method, headers, body }));
+  res.writeHead(response.status, Object.fromEntries(response.headers.entries()));
+  res.end(Buffer.from(await response.arrayBuffer()));
+}).listen(port, '127.0.0.1', () => {
+  console.log(\`Agent Sam dev server http://127.0.0.1:\${port}\`);
+});
+`,
+    },
+    {
+      path: 'scripts/smoke.mjs',
+      content: `import { AgentSam } from '@inneranimalmedia/agentsam-sdk';
+
+const app = new AgentSam({ project: '${projectName}', lane: '${laneKey}', agent: '${agent}' });
+const res = await app.handle(new Request('https://example.com/api/health'));
+const data = await res.json();
+
+if (!data.ok) {
+  console.error(data);
+  process.exit(1);
+}
+
+console.log('AgentSam smoke test passed:', data);
+`,
+    },
+    {
+      path: 'README.md',
+      content: `# ${projectName}
+
+Built locally with [Agent Sam SDK](https://inneranimalmedia.com) — **${laneLabel}** lane, \`${agent}\` agent.
+
+## Local-first (default)
+
+\`\`\`bash
+npm install
+npm run smoke
+npx agentsam start-local    # Terminal 1 — local PTY
+npm run dev                 # Terminal 2 — http://127.0.0.1:8787
+npm run db:migrate          # apply local D1 schema
+\`\`\`
+
+Everything works offline. No Cloudflare account required to start.
+
+## Graduate to cloud
+
+\`\`\`bash
+npx agentsam deploy
+\`\`\`
+
+Cloudflare OAuth is prompted **only** when you deploy — not at init.
+
+Run target selected at init: **${runTarget}**
+`,
+    },
+  ];
+}
+
+export function buildLocalScaffoldMeta(body, sdkVersion = '1.5.0') {
+  const projectName = String(body.projectName || body.project_name || 'agentsam-project')
+    .trim()
+    .toLowerCase()
+    .replace(/[^a-z0-9-]+/g, '-')
+    .replace(/^-+|-+$/g, '') || 'agentsam-project';
+  const laneKey = normalizeLane(body.lane);
+  const laneLabel = LANE_LABELS[laneKey] || 'Full Stack';
+  const agent = AGENT_FOR_LANE[laneKey] || 'orchestrator';
+  const runTarget = normalizeRunTarget(body.runTarget || body.run_target || 'local');
+
+  return {
+    projectName,
+    laneKey,
+    laneLabel,
+    agent,
+    runTarget,
+    files: buildLocalScaffoldFiles({ projectName, laneKey, laneLabel, agent, runTarget, sdkVersion }),
+    next_steps: [
+      'npm install',
+      'npm run smoke',
+      'npx agentsam start-local',
+      'npm run dev',
+      'npm run db:migrate',
+      'When ready: npx agentsam deploy',
+    ],
+  };
+}

package/src/lib/prompt-byok.js

@@ -0,0 +1,57 @@
+/**
+ * Optional BYOK key paste during SDK init → CORE user_api_keys.
+ */
+import { getJson, postJson } from './core-client.js';
+
+const PROVIDERS = [
+  { id: 'openai', label: 'OpenAI' },
+  { id: 'anthropic', label: 'Anthropic' },
+];
+
+/**
+ * @param {string} token SDK bearer
+ * @param {{ ask: (q: string) => Promise<string> } | null} prompt
+ */
+export async function promptOptionalByokKeys(token, prompt) {
+  if (!token || !prompt) return;
+
+  let ctx;
+  try {
+    ctx = await getJson('/api/sdk/context', token);
+  } catch {
+    console.log('\n  ⚠ Could not load BYOK status — skip key paste or add keys in Dashboard → Settings → Keys\n');
+    return;
+  }
+
+  const byok = ctx?.byok || {};
+  console.log('\n  Provider keys (BYOK — optional, stored in YOUR IAM account):\n');
+
+  for (const p of PROVIDERS) {
+    const slot = byok[p.id];
+    if (slot?.configured) {
+      console.log(`    ${p.label.padEnd(12)} ✓ connected ${slot.masked || ''}`);
+      continue;
+    }
+
+    const ans = await prompt.ask(`    ${p.label} API key (Enter to skip): `);
+    const key = ans.trim();
+    if (!key) continue;
+
+    try {
+      await postJson(
+        '/api/sdk/keys',
+        {
+          provider: p.id,
+          api_key: key,
+          label: `${p.label} (SDK init)`,
+          validate: true,
+        },
+        token,
+      );
+      console.log(`    ${p.label.padEnd(12)} ✓ saved to IAM BYOK`);
+    } catch (e) {
+      console.log(`    ${p.label.padEnd(12)} ✗ ${e?.message || 'save failed'}`);
+    }
+  }
+  console.log('');
+}

package/src/lib/save-sdk-token.js

@@ -0,0 +1,19 @@
+/**
+ * Persist SDK session token locally for repeat inits (user's machine only).
+ */
+import fs from 'fs';
+import path from 'path';
+
+export function saveSdkTokenHint(cwd, token) {
+  const t = String(token || '').trim();
+  if (!t || !t.startsWith('sdk_')) return null;
+  const dir = path.join(path.resolve(cwd), '.agentsam');
+  fs.mkdirSync(dir, { recursive: true });
+  const hintPath = path.join(dir, 'credentials.env.example');
+  const content = `# Agent Sam SDK — add to your shell profile (optional)
+export AGENTSAM_SDK_TOKEN=${t}
+export USER_GCP_PROJECT=YOUR_GCP_PROJECT_ID
+`;
+  fs.writeFileSync(hintPath, content, 'utf8');
+  return hintPath;
+}

package/src/lib/scaffold.js

@@ -1,260 +1,8 @@
-import fs from 'fs';
-import path from 'path';
-
-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)) {
-    throw new Error(`Directory "${safeName}" already exists.`);
-  }
-
-  fs.mkdirSync(dir, { recursive: true });
-  fs.mkdirSync(`${dir}/src`, { recursive: true });
-  fs.mkdirSync(`${dir}/migrations`, { recursive: true });
-
-  write(`${dir}/agentsam.config.js`, `
-export default {
-  project: '${safeName}',
-  lane: '${laneKey}',
-  provider: '${provider}',
-  agent: '${selectedAgent}',
-  cloudflare: {
-    accountId: '${cfAccountId || ''}',
-  },
-  api: {
-    baseUrl: '/api/agentsam',
-  },
-};
-`);
-
-  write(`${dir}/.env.example`, `
-AGENTSAM_API_KEY=
-CLOUDFLARE_ACCOUNT_ID=${cfAccountId || ''}
-CLOUDFLARE_API_TOKEN=
-`);
-
-  write(`${dir}/.gitignore`, `
-node_modules/
-.env
-.dev.vars
-dist/
-.wrangler/
-`);
-
-  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': sdkRange,
-    },
-    devDependencies: {
-      wrangler: '^4.0.0',
-    },
-  }, null, 2)}\n`);
-
-  write(`${dir}/wrangler.toml`, `
-name = "${safeName}"
-main = "src/index.js"
-compatibility_date = "2026-06-27"
-
-[[d1_databases]]
-binding = "DB"
-database_name = "${safeName}-db"
-database_id = "REPLACE_WITH_D1_DATABASE_ID"
-
-[[kv_namespaces]]
-binding = "KV"
-id = "REPLACE_WITH_KV_NAMESPACE_ID"
-
-[[r2_buckets]]
-binding = "R2"
-bucket_name = "${safeName}"
-`);
-
-  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 }));
-
-  write(`${dir}/scripts/smoke.mjs`, `
-import { AgentSam } from '@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();
-
-if (!data.ok) {
-  console.error(data);
-  process.exit(1);
-}
-
-console.log('AgentSam smoke test passed:', data);
-`);
-
-  return dir;
+/**
+ * @deprecated Local scaffold replaced by CORE POST /api/sdk/scaffold — use `agentsam init`.
+ */
+export function scaffoldProject() {
+  throw new Error(
+    'Local scaffold is disabled. Run: npx @inneranimalmedia/agentsam-sdk init — Agent Sam provisions resources in YOUR Cloudflare account via CORE.',
+  );
 }