@inneranimalmedia/agentsam-sdk 1.2.0 → 1.5.1

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.',
+  );
 }

package/src/lib/slash-commands.js

@@ -26,7 +26,7 @@ export const SLASH_COMMANDS = [
 /** 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: 'pty-connection', label: 'Local PTY via agentsam start-local', status: 'current' },
   { 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' },

package/src/lib/write-files.js

@@ -0,0 +1,21 @@
+import fs from 'fs';
+import path from 'path';
+
+/**
+ * Write Agent Sam scaffold files to the user's machine (their repo, not IAM's).
+ * @param {string} targetDir
+ * @param {{ path: string, content: string }[]} files
+ */
+export function writeScaffoldFiles(targetDir, files) {
+  const root = path.resolve(targetDir);
+  if (fs.existsSync(root)) {
+    throw new Error(`Directory already exists: ${root}`);
+  }
+  fs.mkdirSync(root, { recursive: true });
+  for (const file of files) {
+    const dest = path.join(root, file.path);
+    fs.mkdirSync(path.dirname(dest), { recursive: true });
+    fs.writeFileSync(dest, file.content, 'utf8');
+  }
+  return root;
+}

package/src/local-pty/server.js

@@ -0,0 +1,133 @@
+/**
+ * Agent Sam local PTY — localhost WebSocket shell, no tunnel, no IAM.
+ * Compatible with iam-pty wire format (raw bytes + JSON resize/slash).
+ */
+import http from 'node:http';
+import { WebSocketServer } from 'ws';
+
+const DEFAULT_PORT = 3099;
+
+function parsePort(value, fallback) {
+  const n = Number.parseInt(String(value || ''), 10);
+  return Number.isFinite(n) && n > 0 ? n : fallback;
+}
+
+function shellForPlatform() {
+  if (process.platform === 'win32') return process.env.COMSPEC || 'powershell.exe';
+  return process.env.SHELL || '/bin/zsh';
+}
+
+async function loadPty() {
+  try {
+    const mod = await import('node-pty');
+    return mod.default || mod;
+  } catch (e) {
+    throw new Error(
+      `node-pty is required for start-local. Run: npm install node-pty\n${e?.message || e}`,
+    );
+  }
+}
+
+/**
+ * @param {{ cwd?: string, port?: number, host?: string }} [opts]
+ */
+export async function startLocalPtyServer(opts = {}) {
+  const pty = await loadPty();
+  const cwd = opts.cwd || process.cwd();
+  const port = parsePort(opts.port ?? process.env.PTY_PORT, DEFAULT_PORT);
+  const host = opts.host || '127.0.0.1';
+  const shell = shellForPlatform();
+
+  const httpServer = http.createServer((req, res) => {
+    const path = (req.url || '/').split('?')[0];
+    if (path === '/health') {
+      res.writeHead(200, { 'Content-Type': 'application/json' });
+      res.end(
+        JSON.stringify({
+          ok: true,
+          service: 'agentsam-local-pty',
+          cwd,
+          port,
+          shell,
+        }),
+      );
+      return;
+    }
+    res.writeHead(404);
+    res.end('not found');
+  });
+
+  const wss = new WebSocketServer({ server: httpServer });
+
+  wss.on('connection', (ws, req) => {
+    const url = new URL(req.url || '/', `http://${host}`);
+    const sessionCwd = url.searchParams.get('cwd')?.trim() || cwd;
+    const cols = parsePort(url.searchParams.get('cols'), 80);
+    const rows = parsePort(url.searchParams.get('rows'), 24);
+
+    const term = pty.spawn(shell, [], {
+      name: 'xterm-256color',
+      cols,
+      rows,
+      cwd: sessionCwd,
+      env: { ...process.env, TERM: 'xterm-256color', AGENTSAM_LOCAL_PTY: '1' },
+    });
+
+    const sessionId = `local_${Date.now().toString(36)}`;
+    ws.send(JSON.stringify({ type: 'session_id', session_id: sessionId }));
+
+    term.onData((data) => {
+      if (ws.readyState === ws.OPEN) ws.send(data);
+    });
+
+    ws.on('message', (raw) => {
+      const text = raw.toString();
+      try {
+        const msg = JSON.parse(text);
+        if (msg.type === 'resize' && msg.cols && msg.rows) {
+          term.resize(msg.cols, msg.rows);
+          return;
+        }
+        if (msg.type === 'slash' && msg.line) {
+          term.write(`${msg.line}\r`);
+          return;
+        }
+      } catch {
+        /* raw PTY input */
+      }
+      term.write(text);
+    });
+
+    const cleanup = () => {
+      try {
+        term.kill();
+      } catch {
+        /* ignore */
+      }
+    };
+    term.onExit(() => {
+      if (ws.readyState === ws.OPEN) ws.close();
+    });
+    ws.on('close', cleanup);
+    ws.on('error', cleanup);
+  });
+
+  await new Promise((resolve) => {
+    httpServer.listen(port, host, resolve);
+  });
+
+  return {
+    port,
+    host,
+    cwd,
+    shell,
+    url: `ws://${host}:${port}`,
+    healthUrl: `http://${host}:${port}/health`,
+    close: () =>
+      new Promise((resolve, reject) => {
+        wss.close(() => {
+          httpServer.close((err) => (err ? reject(err) : resolve()));
+        });
+      }),
+  };
+}