struere 0.10.2 → 0.10.5

package/dist/bin/struere.js

@@ -540,7 +540,8 @@ async function runTool(options) {
         agentId: agentResult.value._id,
         environment: options.environment,
         toolName: options.toolName,
-        toolArgs: options.toolArgs
+        toolArgs: options.toolArgs,
+        organizationId: options.organizationId
       }
     }),
     signal: AbortSignal.timeout(30000)
@@ -567,6 +568,99 @@ async function runTool(options) {
   }
   return { error: `Unexpected response: ${text}` };
 }
+async function chatWithAgent(options) {
+  const credentials = loadCredentials();
+  const apiKey = getApiKey();
+  if (apiKey && !credentials?.token) {
+    const siteUrl = getSiteUrl();
+    try {
+      const response = await fetch(`${siteUrl}/v1/agents/${options.slug}/chat`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: `Bearer ${apiKey}`
+        },
+        body: JSON.stringify({
+          message: options.message,
+          threadId: options.threadId,
+          environment: options.environment,
+          channel: options.channel || "api"
+        }),
+        signal: options.signal || AbortSignal.timeout(120000)
+      });
+      const text = await response.text();
+      let json;
+      try {
+        json = JSON.parse(text);
+      } catch {
+        return { error: text || `HTTP ${response.status}` };
+      }
+      if (!response.ok) {
+        return { error: json.error || text };
+      }
+      return { result: json };
+    } catch (err) {
+      if (err instanceof DOMException && err.name === "TimeoutError") {
+        return { error: "Request timed out after 120s" };
+      }
+      return { error: `Network error: ${err instanceof Error ? err.message : String(err)}` };
+    }
+  }
+  if (credentials?.sessionId) {
+    await refreshToken();
+  }
+  const freshCredentials = loadCredentials();
+  const token = apiKey || freshCredentials?.token;
+  if (!token) {
+    return { error: "Not authenticated" };
+  }
+  try {
+    const response = await fetch(`${CONVEX_URL}/api/action`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${token}`
+      },
+      body: JSON.stringify({
+        path: "chat:sendBySlug",
+        args: {
+          slug: options.slug,
+          message: options.message,
+          threadId: options.threadId,
+          environment: options.environment,
+          channel: options.channel || "api"
+        }
+      }),
+      signal: options.signal || AbortSignal.timeout(120000)
+    });
+    const text = await response.text();
+    let json;
+    try {
+      json = JSON.parse(text);
+    } catch {
+      return { error: text || `HTTP ${response.status}` };
+    }
+    if (!response.ok) {
+      const msg = json.errorData?.message || json.errorMessage || text;
+      return { error: msg };
+    }
+    if (json.status === "success" && json.value) {
+      return { result: json.value };
+    }
+    if (json.status === "success" && json.value === null) {
+      return { error: `Agent not found or no config for environment: ${options.environment}` };
+    }
+    if (json.status === "error") {
+      return { error: json.errorData?.message || json.errorMessage || "Unknown error from Convex" };
+    }
+    return { error: `Unexpected response: ${text}` };
+  } catch (err) {
+    if (err instanceof DOMException && err.name === "TimeoutError") {
+      return { error: "Request timed out after 120s" };
+    }
+    return { error: `Network error: ${err instanceof Error ? err.message : String(err)}` };
+  }
+}
 async function getPullState(organizationId, environment = "development") {
   const credentials = loadCredentials();
   const apiKey = getApiKey();
@@ -1831,7 +1925,12 @@ function getResourceDirectories(cwd) {
 }
 
 // src/cli/commands/docs.ts
-var DOCS_BASE = "https://docs.struere.dev";
+var TEMPLATE_URL = "https://docs.struere.dev/llms-workspace.txt";
+var FALLBACK_TEMPLATE = `# Struere Workspace
+
+> Run \`struere docs\` with internet access to generate full documentation.
+
+{{PROJECT_CONTEXT}}`;
 var ALL_TARGETS = ["claude", "cursor", "copilot"];
 var TARGET_FILES = {
   claude: "CLAUDE.md",
@@ -1885,222 +1984,18 @@ function buildProjectContext(orgName, resources) {
   return lines.join(`
 `);
 }
-function buildDocument(projectContext) {
-  const lines = [];
-  lines.push(`# Struere Workspace`);
-  lines.push("");
-  lines.push(`> This is a Struere workspace project. You define agents, data types, roles, triggers, and custom tools here. The CLI syncs them to the Convex backend.`);
-  lines.push("");
-  lines.push(`## Agent Usage`);
-  lines.push("");
-  lines.push("If you are an AI coding agent (Claude Code, Cursor, Copilot, etc.), use these patterns:");
-  lines.push("");
-  lines.push("**Auth**: Set `STRUERE_API_KEY` environment variable (no browser login needed)");
-  lines.push("");
-  lines.push("**Sync**: Use `struere sync` instead of `struere dev` \u2014 it syncs once and exits (no watch loop)");
-  lines.push("```bash");
-  lines.push("struere sync              # sync to development + eval, then exit");
-  lines.push("struere sync --json       # machine-readable JSON output");
-  lines.push("struere sync --env production  # sync to production");
-  lines.push("struere sync --force      # skip deletion confirmations");
-  lines.push("```");
-  lines.push("");
-  lines.push("**Deploy**: `struere deploy --force` skips confirmation prompts");
-  lines.push("");
-  lines.push("**JSON output**: Most commands support `--json` for structured output:");
-  lines.push("```bash");
-  lines.push("struere data list <type> --json");
-  lines.push("struere status --json");
-  lines.push("struere deploy --json --force");
-  lines.push("```");
-  lines.push("");
-  lines.push("**Non-interactive mode** is auto-detected when `STRUERE_API_KEY` is set or stdout is not a TTY. In this mode, all confirmation prompts are auto-accepted and spinners are replaced with plain text.");
-  lines.push("");
-  lines.push("**Exit codes**: All commands exit `0` on success, `1` on error. Check `$?` after execution.");
-  lines.push("");
-  if (projectContext) {
-    lines.push(projectContext);
-    lines.push("");
+async function fetchTemplate() {
+  try {
+    const controller = new AbortController;
+    const timeout = setTimeout(() => controller.abort(), 5000);
+    const response = await fetch(TEMPLATE_URL, { signal: controller.signal });
+    clearTimeout(timeout);
+    if (!response.ok)
+      throw new Error(`HTTP ${response.status}`);
+    return await response.text();
+  } catch {
+    return FALLBACK_TEMPLATE;
   }
-  lines.push(`## Project Structure`);
-  lines.push("");
-  lines.push("```");
-  lines.push("agents/              # Agent definitions (one file per agent)");
-  lines.push("entity-types/        # Data type schemas (like DB tables)");
-  lines.push("roles/               # RBAC roles with policies, scope rules, field masks");
-  lines.push("triggers/            # Automation rules (react to entity changes)");
-  lines.push("tools/index.ts       # Custom tools shared by all agents");
-  lines.push("evals/*.eval.yaml    # Test suites for agent evaluation");
-  lines.push("fixtures/*.fixture.yaml # Test data for eval environment");
-  lines.push("struere.json         # Organization config (auto-generated)");
-  lines.push("```");
-  lines.push("");
-  lines.push(`## CLI Commands`);
-  lines.push("");
-  lines.push("| Command | Description |");
-  lines.push("|---------|-------------|");
-  lines.push("| `struere sync` | One-shot sync to Convex and exit (agent-friendly) |");
-  lines.push("| `struere dev` | Watch files and sync to Convex on save |");
-  lines.push("| `struere deploy` | Push development config to production |");
-  lines.push("| `struere add agent\\|data-type\\|role\\|trigger\\|eval\\|fixture <name>` | Scaffold a new resource |");
-  lines.push("| `struere status` | Compare local vs remote state |");
-  lines.push("| `struere pull` | Download remote resources to local files |");
-  lines.push("| `struere data types` | List data types in an environment |");
-  lines.push("| `struere data list <type>` | List records (supports `--status`, `--limit`, `--json`) |");
-  lines.push("| `struere data get <id>` | Get record details |");
-  lines.push("| `struere data create <type>` | Create record (interactive or `--data <json>`) |");
-  lines.push("| `struere data update <id>` | Update record (`--data <json>`, `--status`) |");
-  lines.push("| `struere data delete <id>` | Delete record (with confirmation) |");
-  lines.push("| `struere data search <type> <query>` | Search records by text |");
-  lines.push("| `struere eval run <suite>` | Run an eval suite and write Markdown results |");
-  lines.push("| `struere eval run <suite> --case <name>` | Run specific case(s) by name |");
-  lines.push("| `struere eval run <suite> --tag <tag>` | Run cases matching a tag |");
-  lines.push("| `struere templates list` | List WhatsApp message templates |");
-  lines.push("| `struere templates create <name>` | Create a template (`--components <json>` or `--file <path>`) |");
-  lines.push("| `struere templates delete <name>` | Delete a template (with confirmation) |");
-  lines.push("| `struere templates status <name>` | Check template approval status |");
-  lines.push("| `struere docs` | Regenerate this file |");
-  lines.push("");
-  lines.push(`## Key Patterns`);
-  lines.push("");
-  lines.push("- **Imports**: `import { defineAgent, defineData, defineRole, defineTrigger, defineTools } from 'struere'`");
-  lines.push("- **Default model**: `grok-4-1-fast` (provider: `xai`). Also supports `anthropic`, `openai` and `google`");
-  lines.push("- **Scope rule values**: `actor.userId`, `actor.entityId`, `actor.organizationId`, `actor.relatedIds:TYPE`, `literal:VALUE`");
-  lines.push("- **Policy actions**: `create`, `read`, `update`, `delete`, `list` (deny overrides allow)");
-  lines.push("- **Entity link/unlink params**: `fromId`, `toId`, `relationType`");
-  lines.push("- **Trigger template vars**: `{{trigger.entityId}}`, `{{trigger.data.X}}`, `{{steps.NAME.X}}`");
-  lines.push("");
-  lines.push(`## Dynamic System Prompts`);
-  lines.push("");
-  lines.push("System prompts are **not static strings** \u2014 they are templates evaluated at runtime before every LLM call. This is one of the most powerful features in Struere because it enables completely different agent behavior depending on conditions, live data, and even other agents' responses.");
-  lines.push("");
-  lines.push("### Template Variables");
-  lines.push("Simple variable substitution: `{{agentName}}`, `{{organizationName}}`, `{{currentTime}}`, `{{entityTypes}}`, `{{roles}}`, `{{message}}`, `{{thread.metadata.X}}`");
-  lines.push("");
-  lines.push("### Embedded Queries (Function Calls)");
-  lines.push("Pull live data from the database directly into the system prompt:");
-  lines.push("```");
-  lines.push('{{entity.query({"type": "customer", "limit": 5})}}');
-  lines.push('{{entity.get({"id": "ent_123"})}}');
-  lines.push("```");
-  lines.push("This means the agent always sees the latest data \u2014 no stale context.");
-  lines.push("");
-  lines.push("### Custom Tools in Prompts");
-  lines.push("Since custom tools can run arbitrary logic, you can create tools specifically to generate dynamic prompt sections. A custom tool can fetch external APIs, compute conditions, aggregate data, or format context \u2014 and its output gets embedded into the system prompt at runtime.");
-  lines.push("");
-  lines.push("### Agent-to-Agent in Prompts");
-  lines.push('You can even use `agent.chat` in the template to have another agent\'s response injected into the system prompt. This enables patterns like a "context agent" that summarizes relevant info before the main agent starts reasoning.');
-  lines.push("");
-  lines.push(`For full template syntax: [System Prompt Templates](${DOCS_BASE}/tools/system-prompt-templates.md)`);
-  lines.push("");
-  lines.push(`## WhatsApp Template Management`);
-  lines.push("");
-  lines.push("WhatsApp message templates are required for outbound messages outside the 24-hour messaging window. Struere supports full template lifecycle management.");
-  lines.push("");
-  lines.push("### Template Actions");
-  lines.push("");
-  lines.push("| Action | Description |");
-  lines.push("|--------|-------------|");
-  lines.push("| `whatsappActions.listTemplates` | List all templates for a connection |");
-  lines.push("| `whatsappActions.createTemplate` | Create a new template on Meta |");
-  lines.push("| `whatsappActions.deleteTemplate` | Delete a template from Meta |");
-  lines.push("| `whatsappActions.getTemplateStatus` | Check approval status of a template |");
-  lines.push("");
-  lines.push("### Template Categories");
-  lines.push("");
-  lines.push("- **UTILITY**: transactional updates (order confirmations, reminders)");
-  lines.push("- **MARKETING**: promotional content");
-  lines.push("- **AUTHENTICATION**: OTP/verification codes");
-  lines.push("");
-  lines.push("### Template Components");
-  lines.push("");
-  lines.push("- **HEADER** (optional): TEXT, IMAGE, VIDEO, or DOCUMENT");
-  lines.push("- **BODY** (required): main message text with `{{named_params}}` or `{{1}}` positional");
-  lines.push("- **FOOTER** (optional): short text, no variables");
-  lines.push("- **BUTTONS** (optional): QUICK_REPLY, URL, PHONE_NUMBER (do not interleave QUICK_REPLY with URL/PHONE_NUMBER)");
-  lines.push("");
-  lines.push('Use `parameter_format: "NAMED"` with `{{param_name}}` variables (recommended over positional). Include examples when variables appear in HEADER or BODY.');
-  lines.push("");
-  lines.push("### Status Flow");
-  lines.push("");
-  lines.push("`PENDING` \u2192 `APPROVED` | `REJECTED` | `PAUSED`");
-  lines.push("");
-  lines.push(`For details: [WhatsApp Integration](${DOCS_BASE}/integrations/whatsapp.md)`);
-  lines.push("");
-  lines.push(`## Multi-Agent Communication (agent.chat)`);
-  lines.push("");
-  lines.push("The `agent.chat` tool lets agents delegate work to other agents. This is a core building block for complex systems:");
-  lines.push("");
-  lines.push("- **Orchestrator pattern**: A coordinator agent routes tasks to specialist agents based on the request");
-  lines.push("- **Trigger actions**: Use `agent.chat` inside trigger action pipelines to have an agent reason about entity changes");
-  lines.push("- **Chained delegation**: Agents can call other agents up to 3 levels deep (A\u2192B\u2192C), with cycle detection");
-  lines.push("- **Isolated execution**: Each agent runs its own LLM loop with its own system prompt, tools, and permissions");
-  lines.push("");
-  lines.push("```typescript");
-  lines.push("// Orchestrator that delegates to specialists");
-  lines.push('tools: ["agent.chat", "entity.query"]');
-  lines.push("// In trigger actions:");
-  lines.push('{ tool: "agent.chat", args: { agent: "billing-agent", message: "Process refund for {{trigger.data.orderId}}" } }');
-  lines.push("```");
-  lines.push("");
-  lines.push(`For details: [Agents](${DOCS_BASE}/platform/agents.md)`);
-  lines.push("");
-  lines.push(`## Best Practices`);
-  lines.push("");
-  lines.push("- **Keep tools under 10 per agent.** Agents perform significantly worse when they have too many tools to choose from. If an agent needs more, split it into specialist agents and use `agent.chat` to orchestrate");
-  lines.push("- **Always ask the user before making assumptions.** The user may not be technical \u2014 help them accomplish what they want by asking the right questions and offering clear options");
-  lines.push("- **Always check the documentation before making changes.** Fetch the relevant doc link below to verify the correct API, field names, and patterns. Do not guess \u2014 wrong field names or patterns will cause silent failures");
-  lines.push("- **Use `struere sync` to validate changes.** Run after editing files to sync to Convex. Use `struere dev` for continuous watch mode during manual development");
-  lines.push("- **Test with evals.** Write eval suites to catch regressions in agent behavior (`struere add eval <name>`)");
-  lines.push("");
-  lines.push(`## Documentation`);
-  lines.push("");
-  lines.push(`Fetch these URLs for detailed documentation on each topic:`);
-  lines.push("");
-  lines.push("### SDK");
-  lines.push(`- [SDK Overview](${DOCS_BASE}/sdk/overview.md)`);
-  lines.push(`- [defineAgent](${DOCS_BASE}/sdk/define-agent.md)`);
-  lines.push(`- [defineData](${DOCS_BASE}/sdk/define-data.md)`);
-  lines.push(`- [defineRole](${DOCS_BASE}/sdk/define-role.md)`);
-  lines.push(`- [defineTrigger](${DOCS_BASE}/sdk/define-trigger.md)`);
-  lines.push(`- [defineTools](${DOCS_BASE}/sdk/define-tools.md)`);
-  lines.push("");
-  lines.push("### Tools");
-  lines.push(`- [Built-in Tools](${DOCS_BASE}/tools/built-in-tools.md)`);
-  lines.push(`- [Custom Tools](${DOCS_BASE}/tools/custom-tools.md)`);
-  lines.push(`- [System Prompt Templates](${DOCS_BASE}/tools/system-prompt-templates.md)`);
-  lines.push("");
-  lines.push("### Platform");
-  lines.push(`- [Data](${DOCS_BASE}/platform/data.md)`);
-  lines.push(`- [Permissions](${DOCS_BASE}/platform/permissions.md)`);
-  lines.push(`- [Agents](${DOCS_BASE}/platform/agents.md)`);
-  lines.push(`- [Events](${DOCS_BASE}/platform/events.md)`);
-  lines.push(`- [Triggers](${DOCS_BASE}/platform/triggers.md)`);
-  lines.push(`- [Environment Isolation](${DOCS_BASE}/platform/environment-isolation.md)`);
-  lines.push(`- [Evaluations](${DOCS_BASE}/platform/evals.md)`);
-  lines.push("");
-  lines.push("### CLI");
-  lines.push(`- [CLI Overview](${DOCS_BASE}/cli/overview.md)`);
-  lines.push(`- [struere init](${DOCS_BASE}/cli/init.md)`);
-  lines.push(`- [struere sync](${DOCS_BASE}/cli/sync.md)`);
-  lines.push(`- [struere dev](${DOCS_BASE}/cli/dev.md)`);
-  lines.push(`- [struere add](${DOCS_BASE}/cli/add.md)`);
-  lines.push(`- [struere deploy](${DOCS_BASE}/cli/deploy.md)`);
-  lines.push(`- [struere eval run](${DOCS_BASE}/cli/eval.md)`);
-  lines.push(`- [struere templates](${DOCS_BASE}/cli/templates.md)`);
-  lines.push("");
-  lines.push("### API & Integrations");
-  lines.push(`- [Chat API](${DOCS_BASE}/api/chat.md)`);
-  lines.push(`- [Webhooks](${DOCS_BASE}/api/webhooks.md)`);
-  lines.push(`- [WhatsApp Integration](${DOCS_BASE}/integrations/whatsapp.md)`);
-  lines.push("");
-  lines.push("### Reference");
-  lines.push(`- [Project Structure](${DOCS_BASE}/reference/project-structure.md)`);
-  lines.push(`- [Model Configuration](${DOCS_BASE}/reference/model-configuration.md)`);
-  lines.push("");
-  lines.push(`Full docs: ${DOCS_BASE}/llms-full.txt`);
-  return lines.join(`
-`);
 }
 function writeTarget(cwd, target, content) {
   const filePath = join6(cwd, TARGET_FILES[target]);
@@ -2131,7 +2026,8 @@ async function generateDocs(cwd, targets) {
       });
     }
   }
-  const content = buildDocument(projectContext);
+  const template = await fetchTemplate();
+  const content = template.replace("{{PROJECT_CONTEXT}}", projectContext ?? "");
   for (const target of targets) {
     writeTarget(cwd, target, content);
     generated.push(TARGET_FILES[target]);
@@ -2825,7 +2721,8 @@ function getBuiltinToolParameters(name) {
         endTime: { type: "string", description: "Event end time (ISO 8601 datetime)" },
         description: { type: "string", description: "Event description" },
         attendees: { type: "array", items: { type: "string" }, description: "List of attendee email addresses" },
-        timeZone: { type: "string", description: 'Time zone (e.g., "America/Santiago")' }
+        timeZone: { type: "string", description: 'Time zone (e.g., "America/Santiago")' },
+        addGoogleMeet: { type: "boolean", description: "Set to true to automatically create a Google Meet video conference link for this event" }
       },
       required: ["userId", "summary", "startTime", "endTime"]
     },
@@ -6956,10 +6853,263 @@ var runToolCommand = new Command18("run-tool").description("Run a tool as it wou
     console.log(chalk20.dim(`Identity: ${result.identity.actorType} (${result.identity.identityMode} mode)`));
   }
 });
+
+// src/cli/commands/chat.ts
+import { Command as Command19 } from "commander";
+import chalk21 from "chalk";
+import ora15 from "ora";
+import readline from "readline";
+var chatCommand = new Command19("chat").description("Chat with an agent").argument("<agent-slug>", "Agent slug").option("--env <environment>", "Environment: development | production | eval", "development").option("--thread <id>", "Continue an existing thread").option("--message <msg>", "Single message mode (send and exit)").option("--json", "Output JSON").option("--channel <channel>", "Channel identifier", "api").option("-v, --verbose", "Show detailed response info").option("--confirm", "Skip production warning prompt").action(async (agentSlug, options) => {
+  const spinner = ora15();
+  const cwd = process.cwd();
+  const nonInteractive = !isInteractive();
+  const jsonMode = !!options.json;
+  if (!hasProject(cwd)) {
+    if (nonInteractive) {
+      if (jsonMode) {
+        console.log(JSON.stringify({ success: false, error: "No struere.json found" }));
+      } else {
+        console.log(chalk21.red("No struere.json found. Run struere init first."));
+      }
+      process.exit(1);
+    }
+    console.log(chalk21.yellow("No struere.json found - initializing project..."));
+    console.log();
+    const success = await runInit(cwd);
+    if (!success) {
+      process.exit(1);
+    }
+    console.log();
+  }
+  const project = loadProject(cwd);
+  if (!project) {
+    if (jsonMode) {
+      console.log(JSON.stringify({ success: false, error: "Failed to load struere.json" }));
+    } else {
+      console.log(chalk21.red("Failed to load struere.json"));
+    }
+    process.exit(1);
+  }
+  let credentials = loadCredentials();
+  const apiKey = getApiKey();
+  if (!credentials && !apiKey) {
+    if (nonInteractive) {
+      if (jsonMode) {
+        console.log(JSON.stringify({ success: false, error: "Not authenticated. Set STRUERE_API_KEY or run struere login." }));
+      } else {
+        console.log(chalk21.red("Not authenticated. Set STRUERE_API_KEY or run struere login."));
+      }
+      process.exit(1);
+    }
+    console.log(chalk21.yellow("Not logged in - authenticating..."));
+    console.log();
+    credentials = await performLogin();
+    if (!credentials) {
+      console.log(chalk21.red("Authentication failed"));
+      process.exit(1);
+    }
+    console.log();
+  }
+  const environment = options.env;
+  if (environment === "production" && !nonInteractive && !options.confirm) {
+    const confirmRl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    await new Promise((resolve) => {
+      confirmRl.question(chalk21.yellow(`WARNING: Chatting with agent in PRODUCTION environment.
+  Press Enter to continue or Ctrl+C to cancel: `), resolve);
+    });
+    confirmRl.close();
+  }
+  const doChat = async (message, threadId2, signal) => {
+    return chatWithAgent({
+      slug: agentSlug,
+      message,
+      threadId: threadId2,
+      environment,
+      organizationId: project?.organization.id,
+      channel: options.channel,
+      signal
+    });
+  };
+  if (options.message) {
+    if (!jsonMode) {
+      spinner.start("Sending message...");
+    }
+    let { result, error } = await doChat(options.message, options.thread);
+    if (error && isAuthError(error) && !nonInteractive) {
+      if (!jsonMode)
+        spinner.fail("Session expired - re-authenticating...");
+      clearCredentials();
+      credentials = await performLogin();
+      if (!credentials) {
+        if (jsonMode) {
+          console.log(JSON.stringify({ success: false, error: "Authentication failed" }));
+        } else {
+          console.log(chalk21.red("Authentication failed"));
+        }
+        process.exit(1);
+      }
+      const retry = await doChat(options.message, options.thread);
+      result = retry.result;
+      error = retry.error;
+      if (!jsonMode && !error)
+        spinner.succeed("Message sent");
+    }
+    if (error) {
+      if (jsonMode) {
+        console.log(JSON.stringify({ success: false, error }));
+      } else {
+        spinner.fail("Failed to send message");
+        console.log(chalk21.red("Error:"), error);
+      }
+      process.exit(1);
+    }
+    if (!result) {
+      if (jsonMode) {
+        console.log(JSON.stringify({ success: false, error: "No result returned" }));
+      } else {
+        spinner.fail("No result returned");
+      }
+      process.exit(1);
+    }
+    if (!jsonMode)
+      spinner.succeed("Message sent");
+    if (jsonMode) {
+      console.log(JSON.stringify({ message: result.message, threadId: result.threadId, usage: result.usage }, null, 2));
+    } else {
+      console.log();
+      console.log("\u2500".repeat(60));
+      console.log();
+      console.log(chalk21.green("Agent:"));
+      console.log(result.message);
+      console.log();
+      if (options.verbose) {
+        console.log(chalk21.dim(`Thread: ${result.threadId}`));
+        console.log(chalk21.dim(`Tokens: ${result.usage.inputTokens} in / ${result.usage.outputTokens} out (${result.usage.totalTokens} total)`));
+        console.log(chalk21.dim("Tool call details available in dashboard"));
+      } else {
+        console.log(chalk21.dim(`Thread: ${result.threadId} | Tokens: ${result.usage.totalTokens}`));
+      }
+      console.log();
+      console.log("\u2500".repeat(60));
+    }
+    return;
+  }
+  console.log(chalk21.bold(`Chat with ${chalk21.cyan(agentSlug)} (${environment})`));
+  console.log(chalk21.dim("Type 'exit' to quit"));
+  console.log();
+  let threadId = options.thread;
+  let processing = false;
+  let generation = 0;
+  let currentAbort = null;
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  rl.setPrompt(chalk21.cyan("You: "));
+  rl.prompt();
+  rl.on("SIGINT", () => {
+    if (processing) {
+      generation++;
+      if (currentAbort) {
+        currentAbort.abort();
+        currentAbort = null;
+      }
+      spinner.stop();
+      processing = false;
+      console.log();
+      console.log(chalk21.yellow("Cancelled"));
+      console.log();
+      rl.resume();
+      rl.prompt();
+    } else {
+      rl.close();
+    }
+  });
+  rl.on("line", async (input3) => {
+    const trimmed = input3.trim();
+    if (!trimmed) {
+      rl.prompt();
+      return;
+    }
+    if (trimmed === "exit" || trimmed === "quit") {
+      rl.close();
+      return;
+    }
+    if (processing) {
+      return;
+    }
+    generation++;
+    const thisGeneration = generation;
+    processing = true;
+    currentAbort = new AbortController;
+    const signal = AbortSignal.any([currentAbort.signal, AbortSignal.timeout(120000)]);
+    rl.pause();
+    spinner.start("Thinking...");
+    let { result, error } = await doChat(trimmed, threadId, signal);
+    if (thisGeneration !== generation)
+      return;
+    if (error && isAuthError(error) && !nonInteractive) {
+      spinner.fail("Session expired - re-authenticating...");
+      clearCredentials();
+      credentials = await performLogin();
+      if (thisGeneration !== generation)
+        return;
+      if (!credentials) {
+        console.log(chalk21.red("Authentication failed"));
+        rl.close();
+        return;
+      }
+      currentAbort = new AbortController;
+      const retrySignal = AbortSignal.any([currentAbort.signal, AbortSignal.timeout(120000)]);
+      const retry = await doChat(trimmed, threadId, retrySignal);
+      if (thisGeneration !== generation)
+        return;
+      result = retry.result;
+      error = retry.error;
+    }
+    if (error) {
+      spinner.fail("");
+      console.log(chalk21.red("Error:"), error);
+      processing = false;
+      currentAbort = null;
+      rl.resume();
+      rl.prompt();
+      return;
+    }
+    if (!result) {
+      spinner.fail("No result returned");
+      processing = false;
+      currentAbort = null;
+      rl.resume();
+      rl.prompt();
+      return;
+    }
+    spinner.stop();
+    threadId = result.threadId;
+    console.log();
+    console.log(chalk21.green("Agent:"));
+    console.log(result.message);
+    console.log();
+    if (options.verbose) {
+      console.log(chalk21.dim(`Thread: ${result.threadId}`));
+      console.log(chalk21.dim(`Tokens: ${result.usage.inputTokens} in / ${result.usage.outputTokens} out (${result.usage.totalTokens} total)`));
+      console.log(chalk21.dim("Tool call details available in dashboard"));
+    } else {
+      console.log(chalk21.dim(`Tokens: ${result.usage.totalTokens}`));
+    }
+    console.log();
+    processing = false;
+    currentAbort = null;
+    rl.resume();
+    rl.prompt();
+  });
+  rl.on("close", () => {
+    console.log();
+    console.log(chalk21.dim("Goodbye!"));
+    process.exit(0);
+  });
+});
 // package.json
 var package_default = {
   name: "struere",
-  version: "0.10.2",
+  version: "0.10.5",
   description: "Build, test, and deploy AI agents",
   keywords: [
     "ai",
@@ -7077,4 +7227,5 @@ program.addCommand(templatesCommand);
 program.addCommand(integrationCommand);
 program.addCommand(compilePromptCommand);
 program.addCommand(runToolCommand);
+program.addCommand(chatCommand);
 program.parse();

package/dist/cli/commands/chat.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const chatCommand: Command;
+//# sourceMappingURL=chat.d.ts.map

package/dist/cli/commands/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/chat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAWnC,eAAO,MAAM,WAAW,SAyRpB,CAAA"}

package/dist/cli/commands/docs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/docs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAUnC,KAAK,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAA;AA6S7C,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAwBnH;AAED,eAAO,MAAM,WAAW,SAsCpB,CAAA"}
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/docs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAenC,KAAK,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAA;AAqF7C,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAyBnH;AAED,eAAO,MAAM,WAAW,SAsCpB,CAAA"}