@standardagents/cli 0.11.0-next.56def20 → 0.11.0-next.5d2e71b

package/dist/index.js

@@ -1,7 +1,8 @@
 #!/usr/bin/env node
 import { Command } from 'commander';
-import path3 from 'path';
-import fs3 from 'fs';
+import fs3, { readFileSync } from 'fs';
+import path3, { dirname, resolve } from 'path';
+import { fileURLToPath } from 'url';
 import crypto from 'crypto';
 import readline from 'readline';
 import { spawn } from 'child_process';
@@ -10,7 +11,6 @@ import { parse, modify, applyEdits } from 'jsonc-parser';
 import { loadFile, writeFile, generateCode } from 'magicast';
 import { addVitePlugin } from 'magicast/helpers';
 import net from 'net';
-import { fileURLToPath } from 'url';
 
 var logger = {
   success: (message) => {
@@ -116,32 +116,30 @@ agents/
 
 Files are **auto-discovered** at runtime. No manual registration needed.
 
-## ThreadState
+## FlowState
 
-\`ThreadState\` is the state object available in tools and hooks:
+\`FlowState\` is the central state object available in tools and hooks:
 
 \`\`\`typescript
-interface ThreadState {
-  // Identity (readonly)
-  threadId: string;           // Thread identifier
-  agentId: string;            // Agent identifier
-  userId: string | null;      // User identifier (if set)
-  createdAt: number;          // Creation timestamp
-
-  // Methods
-  getMessages(options?): Promise<MessagesResult>;  // Get conversation history
-  injectMessage(input): Promise<Message>;          // Add message to thread
-  loadModel(name): Promise<ModelConfig>;           // Load model definition
-  loadPrompt(name): Promise<PromptConfig>;         // Load prompt definition
-  loadAgent(name): Promise<AgentConfig>;           // Load agent definition
+interface FlowState {
+  thread: {
+    id: string;           // Thread identifier
+    instance: DurableThread;  // Durable Object instance
+  };
+  agent: AgentConfig;     // Current agent configuration
+  prompt: PromptConfig;   // Current prompt configuration
+  model: ModelConfig;     // Current model configuration
+  messages: Message[];    // Conversation history
+  env: Env;               // Cloudflare Worker environment
+  rootState: FlowState;   // Parent state (for sub-prompts)
 }
 \`\`\`
 
 Access in tools:
 \`\`\`typescript
 export default defineTool('...', schema, async (flow, args) => {
-  const threadId = flow.threadId;
-  const { messages } = await flow.getMessages();
+  const threadId = flow.thread.id;
+  const messages = flow.messages;
   // ...
 });
 \`\`\`
@@ -527,12 +525,12 @@ Tools extend agent capabilities beyond text generation. They allow LLMs to fetch
 ## Function Signature
 
 \`\`\`typescript
-defineTool({
+defineTool(
   description: string,           // What the tool does (shown to LLM)
-  args?: z.ZodObject,            // Input validation schema (optional)
-  execute: (state, args) => ToolResult,  // Implementation
-  tenvs?: z.ZodObject,           // Thread environment variables (optional)
-})
+  args: z.ZodObject,             // Input validation schema
+  handler: (flow, args) => ToolResult,  // Implementation
+  returnSchema?: z.ZodObject     // Optional output schema
+)
 \`\`\`
 
 ## Basic Example
@@ -541,20 +539,20 @@ defineTool({
 import { defineTool } from '@standardagents/builder';
 import { z } from 'zod';
 
-export default defineTool({
-  description: 'Search the knowledge base for articles matching a query',
-  args: z.object({
+export default defineTool(
+  'Search the knowledge base for articles matching a query',
+  z.object({
     query: z.string().describe('Search query'),
     limit: z.number().optional().default(10).describe('Max results'),
   }),
-  execute: async (state, args) => {
+  async (flow, args) => {
     const results = await searchKB(args.query, args.limit);
     return {
       status: 'success',
       result: JSON.stringify(results),
     };
-  },
-});
+  }
+);
 \`\`\`
 
 ## ToolResult Interface
@@ -564,45 +562,44 @@ export default defineTool({
 | \`status\` | \`'success' \\| 'error'\` | Whether the tool succeeded |
 | \`result\` | \`string\` | Tool output (required for success) |
 | \`error\` | \`string\` | Error message (for error status) |
-| \`attachments\` | \`ToolAttachment[]\` | Files to attach (images, etc.) |
 
-## ThreadState Access
+## FlowState Access
 
-The \`state\` parameter provides access to:
+The \`flow\` parameter provides access to:
 
 \`\`\`typescript
-execute: async (state, args) => {
+async (flow, args) => {
   // Thread information
-  const threadId = state.thread.id;
-  const thread = state.thread.instance;
+  const threadId = flow.thread.id;
+  const thread = flow.thread.instance;
 
   // Configuration
-  const agentName = state.agent.name;
-  const modelName = state.model.name;
+  const agentName = flow.agent.name;
+  const modelName = flow.model.name;
 
   // Message history
-  const messages = state.messages;
+  const messages = flow.messages;
 
   // Environment bindings
-  const env = state.env;
+  const env = flow.env;
 
   // Parent state (for sub-prompts)
-  const root = state.rootState;
+  const root = flow.rootState;
 }
 \`\`\`
 
 ## Tool Without Arguments
 
 \`\`\`typescript
-export default defineTool({
-  description: 'Get current server time',
-  execute: async (state) => {
+export default defineTool(
+  'Get current server time',
+  async (flow) => {
     return {
       status: 'success',
       result: new Date().toISOString(),
     };
-  },
-});
+  }
+);
 \`\`\`
 
 ## Error Handling
@@ -610,10 +607,10 @@ export default defineTool({
 Return errors gracefully instead of throwing:
 
 \`\`\`typescript
-export default defineTool({
-  description: 'Fetch user data',
-  args: z.object({ userId: z.string() }),
-  execute: async (state, args) => {
+export default defineTool(
+  'Fetch user data',
+  z.object({ userId: z.string() }),
+  async (flow, args) => {
     try {
       const user = await fetchUser(args.userId);
       return { status: 'success', result: JSON.stringify(user) };
@@ -623,8 +620,8 @@ export default defineTool({
         error: \`Failed to fetch user: \${error.message}\`,
       };
     }
-  },
-});
+  }
+);
 \`\`\`
 
 ## Queueing Additional Tools
@@ -634,21 +631,21 @@ Queue another tool to run after the current one:
 \`\`\`typescript
 import { queueTool } from '@standardagents/builder';
 
-export default defineTool({
-  description: 'Create order and send confirmation',
-  args: z.object({ items: z.array(z.string()) }),
-  execute: async (state, args) => {
+export default defineTool(
+  'Create order and send confirmation',
+  z.object({ items: z.array(z.string()) }),
+  async (flow, args) => {
     const order = await createOrder(args.items);
 
     // Queue email tool to run next
-    queueTool(state, 'send_confirmation_email', {
+    queueTool(flow, 'send_confirmation_email', {
       orderId: order.id,
-      email: state.thread.metadata.userEmail,
+      email: flow.thread.metadata.userEmail,
     });
 
     return { status: 'success', result: JSON.stringify(order) };
-  },
-});
+  }
+);
 \`\`\`
 
 ## Injecting Messages
@@ -658,61 +655,17 @@ Add messages without triggering re-execution:
 \`\`\`typescript
 import { injectMessage } from '@standardagents/builder';
 
-export default defineTool({
-  description: 'Log audit event',
-  args: z.object({ event: z.string() }),
-  execute: async (state, args) => {
-    await injectMessage(state, {
+export default defineTool(
+  'Log audit event',
+  z.object({ event: z.string() }),
+  async (flow, args) => {
+    await injectMessage(flow, {
       role: 'system',
       content: \`[AUDIT] \${args.event}\`,
     });
     return { status: 'success', result: 'Logged' };
-  },
-});
-\`\`\`
-
-## Thread Environment Variables (tenvs)
-
-Tools can declare required thread environment variables:
-
-\`\`\`typescript
-export default defineTool({
-  description: 'Search uploaded documents',
-  args: z.object({ query: z.string() }),
-  execute: async (state, args) => {
-    const vectorStoreId = state.tenvs.vectorStoreId;
-    const results = await searchVectorStore(vectorStoreId, args.query);
-    return { status: 'success', result: JSON.stringify(results) };
-  },
-  tenvs: z.object({
-    vectorStoreId: z.string().describe('OpenAI Vector Store ID'),
-  }),
-});
-\`\`\`
-
-## Returning Attachments
-
-Tools can return file attachments (e.g., generated images):
-
-\`\`\`typescript
-export default defineTool({
-  description: 'Generate a chart from data',
-  args: z.object({ data: z.array(z.number()) }),
-  execute: async (state, args) => {
-    const chartImage = await generateChart(args.data);
-    return {
-      status: 'success',
-      result: 'Chart generated successfully',
-      attachments: [{
-        name: 'chart.png',
-        mimeType: 'image/png',
-        data: chartImage.base64,
-        width: 800,
-        height: 600,
-      }],
-    };
-  },
-});
+  }
+);
 \`\`\`
 
 ## Best Practices
@@ -722,7 +675,7 @@ export default defineTool({
 - **Handle errors gracefully** - return error status, don't throw
 - **Use snake_case** for file names (\`search_knowledge_base.ts\`)
 - **Keep tools focused** - one task per tool
-- **Use \`state.rootState\`** when queueing from sub-prompts
+- **Use \`flow.rootState\`** when queueing from sub-prompts
 
 ## Supported Zod Types
 
@@ -1093,9 +1046,9 @@ function getProjectName(cwd) {
   const packageJsonPath = path3.join(cwd, "package.json");
   if (fs3.existsSync(packageJsonPath)) {
     try {
-      const pkg = JSON.parse(fs3.readFileSync(packageJsonPath, "utf-8"));
-      if (pkg.name) {
-        return pkg.name.replace(/^@[^/]+\//, "");
+      const pkg2 = JSON.parse(fs3.readFileSync(packageJsonPath, "utf-8"));
+      if (pkg2.name) {
+        return pkg2.name.replace(/^@[^/]+\//, "");
       }
     } catch {
     }
@@ -1480,15 +1433,15 @@ async function prompt(question) {
     input: process.stdin,
     output: process.stdout
   });
-  return new Promise((resolve) => {
+  return new Promise((resolve2) => {
     rl.question(question, (answer) => {
       rl.close();
-      resolve(answer.trim());
+      resolve2(answer.trim());
     });
   });
 }
 async function promptPassword(question) {
-  return new Promise((resolve) => {
+  return new Promise((resolve2) => {
     const stdin = process.stdin;
     const stdout = process.stdout;
     stdout.write(question);
@@ -1509,7 +1462,7 @@ async function promptPassword(question) {
           stdin.pause();
           stdin.removeListener("data", onData);
           stdout.write("\n");
-          resolve(password);
+          resolve2(password);
           break;
         case "":
           stdout.write("\n");
@@ -1535,7 +1488,7 @@ async function promptPassword(question) {
   });
 }
 function runCommand(command, args, cwd) {
-  return new Promise((resolve, reject) => {
+  return new Promise((resolve2, reject) => {
     const child = spawn(command, args, {
       cwd,
       stdio: "inherit",
@@ -1543,7 +1496,7 @@ function runCommand(command, args, cwd) {
     });
     child.on("close", (code) => {
       if (code === 0) {
-        resolve();
+        resolve2();
       } else {
         reject(new Error(`Command failed with exit code ${code}`));
       }
@@ -1567,16 +1520,25 @@ function detectPackageManager() {
   if (fs3.existsSync("package-lock.json")) return "npm";
   return "npm";
 }
-function getPackageVersion() {
-  if (process.env.STANDARDAGENTS_WORKSPACE === "1") {
-    return "workspace:*";
+function getBuilderPackageVersion() {
+  try {
+    const __dirname2 = path3.dirname(fileURLToPath(import.meta.url));
+    const pkgPath = path3.resolve(__dirname2, "../../package.json");
+    const pkg2 = JSON.parse(fs3.readFileSync(pkgPath, "utf-8"));
+    const version = pkg2.version;
+    const prereleaseMatch = version.match(/-([a-z]+)\./i);
+    if (prereleaseMatch) {
+      return `@${prereleaseMatch[1]}`;
+    }
+    return `@^${version}`;
+  } catch {
+    return "";
   }
-  return "0.11.0-next.56def20";
 }
 async function selectPackageManager(detected) {
   const options = ["npm", "pnpm", "yarn", "bun"];
   const detectedIndex = options.indexOf(detected);
-  return new Promise((resolve) => {
+  return new Promise((resolve2) => {
     const stdin = process.stdin;
     const stdout = process.stdout;
     let selectedIndex = detectedIndex;
@@ -1622,7 +1584,7 @@ async function selectPackageManager(detected) {
         renderOptions();
       } else if (key === "\r" || key === "\n") {
         cleanup();
-        resolve(options[selectedIndex]);
+        resolve2(options[selectedIndex]);
       } else if (key === "") {
         cleanup();
         stdout.write("\n");
@@ -1708,7 +1670,34 @@ export default defineConfig({
     }
   }
   logger.log("");
-  logger.info("Step 2: Configuring environment variables...");
+  logger.info("Step 2: Installing Standard Agents dependencies...");
+  logger.log("");
+  try {
+    const installCmd = pm === "npm" ? "install" : "add";
+    const devFlag = pm === "npm" ? "--save-dev" : "-D";
+    const builderVersion = getBuilderPackageVersion();
+    await runCommand(pm, [
+      installCmd,
+      devFlag,
+      "@cloudflare/vite-plugin",
+      "wrangler"
+    ], projectPath);
+    await runCommand(pm, [
+      installCmd,
+      `@standardagents/builder${builderVersion}`,
+      "zod"
+    ], projectPath);
+  } catch (error) {
+    logger.error("Failed to install dependencies");
+    process.exit(1);
+  }
+  logger.log("");
+  logger.info("Step 3: Configuring Standard Agents...");
+  logger.log("");
+  process.chdir(projectPath);
+  await scaffold({ force: true });
+  logger.log("");
+  logger.info("Step 4: Configuring environment variables...");
   logger.log("");
   const encryptionKey = crypto.randomBytes(32).toString("hex");
   let openrouterKey = "";
@@ -1743,44 +1732,6 @@ export default defineConfig({
   if (!adminPassword) {
     adminPassword = "admin";
   }
-  logger.log("");
-  logger.info("Step 3: Installing Standard Agents dependencies...");
-  logger.log("");
-  try {
-    const installCmd = pm === "npm" ? "install" : "add";
-    const devFlag = pm === "npm" ? "--save-dev" : "-D";
-    const packageVersion = getPackageVersion();
-    await runCommand(pm, [
-      installCmd,
-      devFlag,
-      "@cloudflare/vite-plugin",
-      "wrangler"
-    ], projectPath);
-    const deps = [
-      `@standardagents/builder@${packageVersion}`,
-      `@standardagents/spec@${packageVersion}`,
-      `@standardagents/sip@${packageVersion}`,
-      "zod"
-    ];
-    if (openaiKey) {
-      deps.push(`@standardagents/openai@${packageVersion}`);
-    }
-    if (openrouterKey) {
-      deps.push(`@standardagents/openrouter@${packageVersion}`);
-    }
-    await runCommand(pm, [installCmd, ...deps], projectPath);
-  } catch (error) {
-    logger.error("Failed to install dependencies");
-    process.exit(1);
-  }
-  logger.log("");
-  logger.info("Step 4: Configuring Standard Agents...");
-  logger.log("");
-  process.chdir(projectPath);
-  await scaffold({ force: true });
-  logger.log("");
-  logger.info("Writing environment configuration...");
-  logger.log("");
   const devVarsLines = [
     "# Standard Agents Environment Variables",
     "# This file contains secrets for local development only",
@@ -1837,10 +1788,10 @@ export default defineConfig({
 }
 function getReactPackageVersion() {
   try {
-    const __dirname = path3.dirname(fileURLToPath(import.meta.url));
-    const pkgPath = path3.resolve(__dirname, "../package.json");
-    const pkg = JSON.parse(fs3.readFileSync(pkgPath, "utf-8"));
-    const version = pkg.version;
+    const __dirname2 = path3.dirname(fileURLToPath(import.meta.url));
+    const pkgPath = path3.resolve(__dirname2, "../package.json");
+    const pkg2 = JSON.parse(fs3.readFileSync(pkgPath, "utf-8"));
+    const version = pkg2.version;
     const prereleaseMatch = version.match(/-([a-z]+)\./i);
     if (prereleaseMatch) {
       return prereleaseMatch[1];
@@ -1851,23 +1802,23 @@ function getReactPackageVersion() {
   }
 }
 function getChatSourceDir() {
-  const __dirname = path3.dirname(fileURLToPath(import.meta.url));
-  return path3.resolve(__dirname, "../chat");
+  const __dirname2 = path3.dirname(fileURLToPath(import.meta.url));
+  return path3.resolve(__dirname2, "../chat");
 }
 async function prompt2(question) {
   const rl = readline.createInterface({
     input: process.stdin,
     output: process.stdout
   });
-  return new Promise((resolve) => {
+  return new Promise((resolve2) => {
     rl.question(question, (answer) => {
       rl.close();
-      resolve(answer.trim());
+      resolve2(answer.trim());
     });
   });
 }
 function runCommand2(command, args, cwd) {
-  return new Promise((resolve, reject) => {
+  return new Promise((resolve2, reject) => {
     const child = spawn(command, args, {
       cwd,
       stdio: "inherit",
@@ -1875,7 +1826,7 @@ function runCommand2(command, args, cwd) {
     });
     child.on("close", (code) => {
       if (code === 0) {
-        resolve();
+        resolve2();
       } else {
         reject(new Error(`Command failed with exit code ${code}`));
       }
@@ -1899,7 +1850,7 @@ function detectPackageManager2() {
 async function selectPackageManager2(detected) {
   const options = ["npm", "pnpm", "yarn", "bun"];
   const detectedIndex = options.indexOf(detected);
-  return new Promise((resolve) => {
+  return new Promise((resolve2) => {
     const stdin = process.stdin;
     const stdout = process.stdout;
     let selectedIndex = detectedIndex;
@@ -1945,7 +1896,7 @@ async function selectPackageManager2(detected) {
         renderOptions();
       } else if (key === "\r" || key === "\n") {
         cleanup();
-        resolve(options[selectedIndex]);
+        resolve2(options[selectedIndex]);
       } else if (key === "") {
         cleanup();
         stdout.write("\n");
@@ -1960,7 +1911,7 @@ async function selectFramework() {
     { value: "vite", label: "Vite (React + TypeScript)" },
     { value: "nextjs", label: "Next.js (App Router)" }
   ];
-  return new Promise((resolve) => {
+  return new Promise((resolve2) => {
     const stdin = process.stdin;
     const stdout = process.stdout;
     let selectedIndex = 0;
@@ -2004,7 +1955,7 @@ async function selectFramework() {
         renderOptions();
       } else if (key === "\r" || key === "\n") {
         cleanup();
-        resolve(options[selectedIndex].value);
+        resolve2(options[selectedIndex].value);
       } else if (key === "") {
         cleanup();
         stdout.write("\n");
@@ -2024,20 +1975,20 @@ function isValidUrl(url) {
 }
 async function isPortOpen(port) {
   const tryConnect = (host) => {
-    return new Promise((resolve) => {
+    return new Promise((resolve2) => {
       const socket = new net.Socket();
       socket.setTimeout(200);
       socket.on("connect", () => {
         socket.destroy();
-        resolve(true);
+        resolve2(true);
       });
       socket.on("timeout", () => {
         socket.destroy();
-        resolve(false);
+        resolve2(false);
       });
       socket.on("error", () => {
         socket.destroy();
-        resolve(false);
+        resolve2(false);
       });
       socket.connect(port, host);
     });
@@ -2261,21 +2212,21 @@ export default defineConfig({
   fs3.writeFileSync(path3.join(projectPath, "tsconfig.json"), JSON.stringify(tsconfig, null, 2) + "\n", "utf-8");
   logger.success("Created tsconfig.json");
   fs3.copyFileSync(path3.join(chatSourceDir, "package.json"), path3.join(projectPath, "package.json"));
-  const pkg = JSON.parse(fs3.readFileSync(path3.join(projectPath, "package.json"), "utf-8"));
-  pkg.name = projectName;
-  pkg.scripts = {
+  const pkg2 = JSON.parse(fs3.readFileSync(path3.join(projectPath, "package.json"), "utf-8"));
+  pkg2.name = projectName;
+  pkg2.scripts = {
     dev: "vite",
     build: "vite build",
     preview: "vite preview"
   };
-  delete pkg.private;
-  if (pkg.dependencies?.["@standardagents/react"]) {
-    pkg.dependencies["@standardagents/react"] = reactVersion;
-  }
-  delete pkg.dependencies?.["next"];
-  delete pkg.devDependencies?.["@tailwindcss/postcss"];
-  delete pkg.devDependencies?.["postcss"];
-  fs3.writeFileSync(path3.join(projectPath, "package.json"), JSON.stringify(pkg, null, 2) + "\n", "utf-8");
+  delete pkg2.private;
+  if (pkg2.dependencies?.["@standardagents/react"]) {
+    pkg2.dependencies["@standardagents/react"] = reactVersion;
+  }
+  delete pkg2.dependencies?.["next"];
+  delete pkg2.devDependencies?.["@tailwindcss/postcss"];
+  delete pkg2.devDependencies?.["postcss"];
+  fs3.writeFileSync(path3.join(projectPath, "package.json"), JSON.stringify(pkg2, null, 2) + "\n", "utf-8");
   logger.success("Created package.json");
   const envContent = `# Agentbuilder connection
 VITE_AGENTBUILDER_URL=${serverUrl}
@@ -2330,21 +2281,21 @@ async function scaffoldNextjs(projectPath, chatSourceDir, projectName, serverUrl
   };
   fs3.writeFileSync(path3.join(projectPath, "tsconfig.json"), JSON.stringify(tsconfig, null, 2) + "\n", "utf-8");
   logger.success("Created tsconfig.json");
-  const pkg = JSON.parse(fs3.readFileSync(path3.join(chatSourceDir, "package.json"), "utf-8"));
-  pkg.name = projectName;
-  pkg.scripts = {
+  const pkg2 = JSON.parse(fs3.readFileSync(path3.join(chatSourceDir, "package.json"), "utf-8"));
+  pkg2.name = projectName;
+  pkg2.scripts = {
     dev: "next dev",
     build: "next build",
     start: "next start"
   };
-  delete pkg.private;
-  if (pkg.dependencies?.["@standardagents/react"]) {
-    pkg.dependencies["@standardagents/react"] = reactVersion;
-  }
-  delete pkg.devDependencies?.["@tailwindcss/vite"];
-  delete pkg.devDependencies?.["@vitejs/plugin-react"];
-  delete pkg.devDependencies?.["vite"];
-  fs3.writeFileSync(path3.join(projectPath, "package.json"), JSON.stringify(pkg, null, 2) + "\n", "utf-8");
+  delete pkg2.private;
+  if (pkg2.dependencies?.["@standardagents/react"]) {
+    pkg2.dependencies["@standardagents/react"] = reactVersion;
+  }
+  delete pkg2.devDependencies?.["@tailwindcss/vite"];
+  delete pkg2.devDependencies?.["@vitejs/plugin-react"];
+  delete pkg2.devDependencies?.["vite"];
+  fs3.writeFileSync(path3.join(projectPath, "package.json"), JSON.stringify(pkg2, null, 2) + "\n", "utf-8");
   logger.success("Created package.json");
   const envContent = `# Agentbuilder connection
 NEXT_PUBLIC_AGENTBUILDER_URL=${serverUrl}
@@ -2366,8 +2317,10 @@ out
 }
 
 // src/index.ts
+var __dirname$1 = dirname(fileURLToPath(import.meta.url));
+var pkg = JSON.parse(readFileSync(resolve(__dirname$1, "../package.json"), "utf-8"));
 var program = new Command();
-program.name("agents").description("CLI tool for Standard Agents / AgentBuilder").version("0.11.0-next.56def20");
+program.name("agents").description("CLI tool for Standard Agents / AgentBuilder").version(pkg.version);
 program.command("init [project-name]").description("Create a new Standard Agents project (runs create vite, then scaffold)").option("-y, --yes", "Skip prompts and use defaults").option("--template <template>", "Vite template to use", "vanilla-ts").action(init);
 program.command("scaffold").description("Add Standard Agents to an existing Vite project").option("--force", "Overwrite existing configuration").action(scaffold);
 program.command("init-chat [project-name]").description("Scaffold a frontend chat application").option("-y, --yes", "Skip prompts and use defaults").option("--framework <framework>", "Framework to use (vite or nextjs)").action(initChat);