struere 0.12.1 → 0.12.3

package/dist/bin/struere.js

@@ -35,6 +35,7 @@ __export(exports_convex, {
   getPullState: () => getPullState,
   createOrganization: () => createOrganization,
   compilePrompt: () => compilePrompt,
+  chatWithRouter: () => chatWithRouter,
   chatWithAgent: () => chatWithAgent
 });
 async function refreshToken() {
@@ -184,6 +185,7 @@ async function syncViaHttp(apiKey, payload) {
         roles: payload.roles,
         evalSuites: payload.evalSuites,
         triggers: payload.triggers,
+        routers: payload.routers,
         fixtures: payload.fixtures
       }),
       signal: AbortSignal.timeout(30000)
@@ -635,6 +637,65 @@ async function chatWithAgent(options) {
     return { error: `Network error: ${err instanceof Error ? err.message : String(err)}` };
   }
 }
+async function chatWithRouter(options) {
+  const credentials = loadCredentials();
+  const apiKey = getApiKey();
+  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:sendByRouterSlug",
+        args: {
+          routerSlug: options.routerSlug,
+          message: options.message,
+          threadId: options.threadId,
+          phoneNumber: options.phoneNumber,
+          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: `Router 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();
@@ -1343,6 +1404,26 @@ export default defineTrigger({
 })
 `;
 }
+function getRouterTs(name, slug) {
+  return `import { defineRouter } from 'struere'
+
+export default defineRouter({
+  name: "${name}",
+  slug: "${slug}",
+  mode: "rules",
+  agents: [
+    { slug: "agent-one", description: "Handles ..." },
+  ],
+  rules: [
+    {
+      conditions: [{ field: "channel", operator: "eq", value: "whatsapp" }],
+      route: "agent-one",
+    },
+  ],
+  fallback: "agent-one",
+})
+`;
+}
 
 // src/cli/utils/scaffold.ts
 function ensureDir(filePath) {
@@ -1368,6 +1449,7 @@ function scaffoldProject(cwd, options) {
     "tools",
     "evals",
     "triggers",
+    "routers",
     "fixtures",
     ".struere"
   ];
@@ -1487,6 +1569,24 @@ function scaffoldTrigger(cwd, name, slug) {
   result.createdFiles.push(`triggers/${fileName}`);
   return result;
 }
+function scaffoldRouter(cwd, name, slug) {
+  const result = {
+    createdFiles: [],
+    updatedFiles: []
+  };
+  const routersDir = join3(cwd, "routers");
+  if (!existsSync3(routersDir)) {
+    mkdirSync2(routersDir, { recursive: true });
+  }
+  const fileName = `${slug}.ts`;
+  const filePath = join3(routersDir, fileName);
+  if (existsSync3(filePath)) {
+    return result;
+  }
+  writeFileSync2(filePath, getRouterTs(name, slug));
+  result.createdFiles.push(`routers/${fileName}`);
+  return result;
+}
 function scaffoldFixture(cwd, name, slug) {
   const result = {
     createdFiles: [],
@@ -1916,9 +2016,10 @@ async function loadAllResources(cwd) {
   const { suites: evalSuites, errors: evalErrors } = loadEvalSuites(join5(cwd, "evals"));
   errors.push(...evalErrors);
   const triggers = await loadTsDirectory(join5(cwd, "triggers"));
+  const routers = await loadTsDirectory(join5(cwd, "routers"));
   const { fixtures, errors: fixtureErrors } = loadFixtures(join5(cwd, "fixtures"));
   errors.push(...fixtureErrors);
-  return { agents, entityTypes, roles, customTools, evalSuites, triggers, fixtures, errors };
+  return { agents, entityTypes, roles, customTools, evalSuites, triggers, routers, fixtures, errors };
 }
 async function loadTsDirectory(dir) {
   if (!existsSync5(dir)) {
@@ -2005,6 +2106,7 @@ function getResourceDirectories(cwd) {
     tools: join5(cwd, "tools"),
     evals: join5(cwd, "evals"),
     triggers: join5(cwd, "triggers"),
+    routers: join5(cwd, "routers"),
     fixtures: join5(cwd, "fixtures")
   };
 }
@@ -2143,6 +2245,7 @@ async function generateDocs(cwd, targets) {
         customTools: [],
         evalSuites: [],
         triggers: [],
+        routers: [],
         fixtures: [],
         errors: []
       });
@@ -2687,6 +2790,29 @@ function extractSyncPayload(resources) {
     schedule: t.schedule,
     retry: t.retry
   })) : undefined;
+  const routers = resources.routers.length > 0 ? resources.routers.map((r) => ({
+    name: r.name,
+    slug: r.slug,
+    description: r.description,
+    mode: r.mode,
+    agents: r.agents.map((a) => ({
+      slug: a.slug,
+      description: a.description
+    })),
+    rules: r.rules?.map((rule) => ({
+      conditions: rule.conditions.map((c) => ({
+        field: c.field,
+        operator: c.operator,
+        value: c.value
+      })),
+      route: rule.route
+    })),
+    fallback: r.fallback,
+    classifyModel: r.classifyModel,
+    contextMessages: r.contextMessages,
+    maxTransfers: r.maxTransfers,
+    inactivityResetMs: r.inactivityResetMs
+  })) : undefined;
   const fixtures = resources.fixtures.length > 0 ? resources.fixtures.map((f) => ({
     name: f.name,
     slug: f.slug,
@@ -2703,7 +2829,7 @@ function extractSyncPayload(resources) {
       metadata: r.metadata
     }))
   })) : undefined;
-  return { agents, entityTypes, roles, evalSuites, triggers, fixtures };
+  return { agents, entityTypes, roles, evalSuites, triggers, routers, fixtures };
 }
 function extractAgentPayload(agent, customToolsMap) {
   let systemPrompt;
@@ -3132,6 +3258,7 @@ ${resources.errors.join(`
     entityTypes: payload.entityTypes,
     roles: payload.roles,
     triggers: payload.triggers,
+    routers: payload.routers,
     organizationId,
     environment: "development"
   });
@@ -3165,7 +3292,8 @@ async function checkForDeletions(resources, organizationId, environment) {
     entityTypes: new Set(payload.entityTypes.map((et) => et.slug)),
     roles: new Set(payload.roles.map((r) => r.name)),
     evalSuites: new Set((payload.evalSuites || []).map((es) => es.slug)),
-    triggers: new Set((payload.triggers || []).map((t) => t.slug))
+    triggers: new Set((payload.triggers || []).map((t) => t.slug)),
+    routers: new Set((payload.routers || []).map((r) => r.slug))
   };
   const deletions = [];
   const deletedAgents = remoteState.agents.filter((a) => !localSlugs.agents.has(a.slug)).map((a) => a.name);
@@ -3185,6 +3313,10 @@ async function checkForDeletions(resources, organizationId, environment) {
   const deletedTriggers = remoteTriggers.filter((t) => !localSlugs.triggers.has(t.slug)).map((t) => t.name);
   if (deletedTriggers.length > 0)
     deletions.push({ type: "Triggers", remote: remoteTriggers.length, local: (payload.triggers || []).length, deleted: deletedTriggers });
+  const remoteRouters = remoteState.routers || [];
+  const deletedRouters = remoteRouters.filter((r) => !localSlugs.routers.has(r.slug)).map((r) => r.name);
+  if (deletedRouters.length > 0)
+    deletions.push({ type: "Routers", remote: remoteRouters.length, local: (payload.routers || []).length, deleted: deletedRouters });
   return deletions;
 }
 async function syncToEnvironment(cwd, organizationId, environment) {
@@ -3304,6 +3436,7 @@ var syncCommand = new Command5("sync").description("Sync resources to Convex and
         entityTypes: payload.entityTypes.map((et) => et.slug),
         roles: payload.roles.map((r) => r.name),
         triggers: (payload.triggers || []).map((t) => t.slug),
+        routers: (payload.routers || []).map((r) => r.slug),
         deletions: deletions.map((d) => ({ type: d.type, names: d.deleted }))
       }));
     } else {
@@ -3313,6 +3446,7 @@ var syncCommand = new Command5("sync").description("Sync resources to Convex and
       console.log(chalk6.gray("  Data types:"), payload.entityTypes.map((et) => et.slug).join(", ") || "none");
       console.log(chalk6.gray("  Roles:"), payload.roles.map((r) => r.name).join(", ") || "none");
       console.log(chalk6.gray("  Triggers:"), (payload.triggers || []).map((t) => t.slug).join(", ") || "none");
+      console.log(chalk6.gray("  Routers:"), (payload.routers || []).map((r) => r.slug).join(", ") || "none");
       if (deletions.length > 0) {
         console.log();
         console.log(chalk6.yellow.bold("  Would delete:"));
@@ -3477,7 +3611,7 @@ var devCommand = new Command6("dev").description("Watch files and sync to develo
   spinner.start("Loading resources");
   try {
     loadedResources = await loadAllResources(cwd);
-    spinner.succeed(`Loaded ${loadedResources.agents.length} agents, ${loadedResources.entityTypes.length} data types, ${loadedResources.roles.length} roles, ${loadedResources.customTools.length} custom tools, ${loadedResources.evalSuites.length} eval suites, ${loadedResources.triggers.length} triggers, ${loadedResources.fixtures.length} fixtures`);
+    spinner.succeed(`Loaded ${loadedResources.agents.length} agents, ${loadedResources.entityTypes.length} data types, ${loadedResources.roles.length} roles, ${loadedResources.customTools.length} custom tools, ${loadedResources.evalSuites.length} eval suites, ${loadedResources.triggers.length} triggers, ${loadedResources.routers.length} routers, ${loadedResources.fixtures.length} fixtures`);
     for (const err of loadedResources.errors) {
       console.log(chalk7.red("  \u2716"), err);
     }
@@ -3572,6 +3706,7 @@ var devCommand = new Command6("dev").description("Watch files and sync to develo
     dirs.tools,
     dirs.evals,
     dirs.triggers,
+    dirs.routers,
     dirs.fixtures
   ].filter((p) => existsSync8(p));
   const watcher = chokidar.watch(watchPaths, {
@@ -4069,7 +4204,7 @@ var whoamiCommand = new Command9("whoami").description("Show current logged in u
 // src/cli/commands/add.ts
 import { Command as Command10 } from "commander";
 import chalk11 from "chalk";
-var addCommand = new Command10("add").description("Scaffold a new resource").argument("<type>", "Resource type: agent, data-type, role, eval, trigger, or fixture").argument("<name>", "Resource name").action(async (type, name) => {
+var addCommand = new Command10("add").description("Scaffold a new resource").argument("<type>", "Resource type: agent, data-type, role, eval, trigger, router, or fixture").argument("<name>", "Resource name").action(async (type, name) => {
   const cwd = process.cwd();
   console.log();
   if (!hasProject(cwd)) {
@@ -4147,6 +4282,17 @@ var addCommand = new Command10("add").description("Scaffold a new resource").arg
         console.log(chalk11.yellow("Trigger already exists:"), `triggers/${slug}.ts`);
       }
       break;
+    case "router":
+      result = scaffoldRouter(cwd, displayName, slug);
+      if (result.createdFiles.length > 0) {
+        console.log(chalk11.green("\u2713"), `Created router "${displayName}"`);
+        for (const file of result.createdFiles) {
+          console.log(chalk11.gray("  \u2192"), file);
+        }
+      } else {
+        console.log(chalk11.yellow("Router already exists:"), `routers/${slug}.ts`);
+      }
+      break;
     case "fixture":
       result = scaffoldFixture(cwd, displayName, slug);
       if (result.createdFiles.length > 0) {
@@ -4169,6 +4315,7 @@ var addCommand = new Command10("add").description("Scaffold a new resource").arg
       console.log(chalk11.gray("  -"), chalk11.cyan("role"), "- Create a role with permissions");
       console.log(chalk11.gray("  -"), chalk11.cyan("eval"), "- Create an eval suite (YAML)");
       console.log(chalk11.gray("  -"), chalk11.cyan("trigger"), "- Create a data trigger");
+      console.log(chalk11.gray("  -"), chalk11.cyan("router"), "- Create a message router");
       console.log(chalk11.gray("  -"), chalk11.cyan("fixture"), "- Create a test data fixture (YAML)");
       console.log();
       process.exit(1);
@@ -4298,6 +4445,8 @@ var statusCommand = new Command11("status").description("Compare local vs remote
   const devEntityTypeSlugs = new Set(devState.entityTypes.map((et) => et.slug));
   const localRoleNames = new Set(localResources.roles.map((r) => r.name));
   const devRoleNames = new Set(devState.roles.map((r) => r.name));
+  const localRouterSlugs = new Set(localResources.routers.map((r) => r.slug));
+  const devRouterSlugs = new Set((devState.routers || []).map((r) => r.slug));
   if (opts.json) {
     const classify = (localItems, remoteItems, useSlug) => {
       const localKeys = new Set(localItems.map((i) => useSlug ? i.slug : i.name));
@@ -4311,7 +4460,8 @@ var statusCommand = new Command11("status").description("Compare local vs remote
     console.log(JSON.stringify({
       agents: classify(localResources.agents, devState.agents, true),
       entityTypes: classify(localResources.entityTypes, devState.entityTypes, true),
-      roles: classify(localResources.roles, devState.roles, false)
+      roles: classify(localResources.roles, devState.roles, false),
+      routers: classify(localResources.routers, devState.routers || [], true)
     }));
     return;
   }
@@ -4381,6 +4531,26 @@ var statusCommand = new Command11("status").description("Compare local vs remote
     }
   }
   console.log();
+  console.log(chalk12.bold("Routers"));
+  console.log(chalk12.gray("\u2500".repeat(60)));
+  if (localResources.routers.length === 0 && (devState.routers || []).length === 0) {
+    console.log(chalk12.gray("  No routers"));
+  } else {
+    for (const router of localResources.routers) {
+      const remote = (devState.routers || []).find((r) => r.slug === router.slug);
+      if (remote) {
+        console.log(`  ${chalk12.green("\u25CF")} ${chalk12.cyan(router.name)} (${router.slug}) - ${router.mode}`);
+      } else {
+        console.log(`  ${chalk12.blue("+")} ${chalk12.cyan(router.name)} (${router.slug}) - ${chalk12.blue("new")}`);
+      }
+    }
+    for (const remote of devState.routers || []) {
+      if (!localRouterSlugs.has(remote.slug)) {
+        console.log(`  ${chalk12.red("-")} ${remote.name} (${remote.slug}) - ${chalk12.red("will be deleted")}`);
+      }
+    }
+  }
+  console.log();
   console.log(chalk12.gray("Legend:"));
   console.log(chalk12.gray("  "), chalk12.green("\u25CF"), "Synced", chalk12.yellow("\u25CB"), "Not in production", chalk12.blue("+"), "New", chalk12.red("-"), "Will be deleted");
   console.log();
@@ -4655,6 +4825,53 @@ ${parts.join(`,
 })
 `;
 }
+function generateRouterFile(router) {
+  const agentLines = router.agents.map((a) => {
+    const aParts = [
+      `      slug: "${a.slug}"`,
+      `      description: "${a.description}"`
+    ];
+    return `    {
+${aParts.join(`,
+`)},
+    }`;
+  });
+  const parts = [
+    `  name: "${router.name}"`,
+    `  slug: "${router.slug}"`
+  ];
+  if (router.description) {
+    parts.push(`  description: "${router.description}"`);
+  }
+  parts.push(`  mode: "${router.mode}"`);
+  parts.push(`  agents: [
+${agentLines.join(`,
+`)},
+  ]`);
+  if (router.rules && router.rules.length > 0) {
+    parts.push(`  rules: ${stringifyValue(router.rules, 2)}`);
+  }
+  parts.push(`  fallback: "${router.fallback}"`);
+  if (router.classifyModel) {
+    parts.push(`  classifyModel: ${stringifyValue(router.classifyModel, 2)}`);
+  }
+  if (router.contextMessages !== undefined) {
+    parts.push(`  contextMessages: ${router.contextMessages}`);
+  }
+  if (router.maxTransfers !== undefined) {
+    parts.push(`  maxTransfers: ${router.maxTransfers}`);
+  }
+  if (router.inactivityResetMs !== undefined) {
+    parts.push(`  inactivityResetMs: ${router.inactivityResetMs}`);
+  }
+  return `import { defineRouter } from 'struere'
+
+export default defineRouter({
+${parts.join(`,
+`)},
+})
+`;
+}
 function generateIndexFile(type, slugs) {
   if (slugs.length === 0) {
     return "";
@@ -4789,6 +5006,7 @@ var pullCommand = new Command12("pull").description("Pull remote resources to lo
   ensureDir2(join9(cwd, "entity-types"));
   ensureDir2(join9(cwd, "roles"));
   ensureDir2(join9(cwd, "triggers"));
+  ensureDir2(join9(cwd, "routers"));
   ensureDir2(join9(cwd, "tools"));
   const agentSlugs = [];
   for (const agent of state.agents) {
@@ -4816,6 +5034,12 @@ var pullCommand = new Command12("pull").description("Pull remote resources to lo
     const content = generateTriggerFile(trigger);
     writeOrSkip(`triggers/${trigger.slug}.ts`, content);
   }
+  const routerSlugs = [];
+  for (const router of state.routers || []) {
+    routerSlugs.push(router.slug);
+    const content = generateRouterFile(router);
+    writeOrSkip(`routers/${router.slug}.ts`, content);
+  }
   const customTools = collectCustomTools(state.agents);
   if (customTools.length > 0) {
     const content = generateToolsFile(customTools);
@@ -4841,6 +5065,11 @@ var pullCommand = new Command12("pull").description("Pull remote resources to lo
     if (content)
       writeOrSkip("triggers/index.ts", content);
   }
+  if (routerSlugs.length > 0) {
+    const content = generateIndexFile("routers", routerSlugs);
+    if (content)
+      writeOrSkip("routers/index.ts", content);
+  }
   await installSkill(cwd);
   if (options.json) {
     console.log(JSON.stringify({
@@ -6418,6 +6647,53 @@ async function getTemplateStatus(connectionId, name) {
     name
   });
 }
+async function convexMutation3(path, args) {
+  const token = getToken2();
+  if (!token)
+    return { error: "Not authenticated" };
+  const response = await fetch(`${CONVEX_URL}/api/mutation`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${token}`
+    },
+    body: JSON.stringify({ path, args })
+  });
+  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.message || json.errorMessage || text;
+    return { error: String(msg) };
+  }
+  if (json.status === "success")
+    return { data: json.value };
+  if (json.status === "error")
+    return { error: String(json.errorMessage || "Unknown error") };
+  return { error: `Unexpected response: ${text}` };
+}
+async function listRouters(env) {
+  return convexQuery4("routers:list", { environment: env });
+}
+async function setConnectionRouter(connectionId, routerId) {
+  return convexMutation3("whatsapp:setPhoneAgent", {
+    connectionId,
+    routerId
+  });
+}
+async function setConnectionAgent(connectionId, agentId) {
+  return convexMutation3("whatsapp:setPhoneAgent", {
+    connectionId,
+    agentId
+  });
+}
+async function resolveAgentBySlug(slug) {
+  return convexQuery4("agents:getBySlug", { slug });
+}
 async function updateTemplate(connectionId, templateId, updates) {
   if (getApiKey()) {
     return httpPost("/v1/templates/update", { connectionId, templateId, ...updates });
@@ -6791,7 +7067,7 @@ async function convexQuery5(path, args) {
     return { error: String(json.errorMessage || "Unknown error") };
   return { error: `Unexpected response: ${text}` };
 }
-async function convexMutation3(path, args) {
+async function convexMutation4(path, args) {
   const result = await getValidToken();
   if ("error" in result)
     return { error: result.error };
@@ -6855,19 +7131,19 @@ async function getIntegrationConfig(provider, env) {
   return convexQuery5("integrations:getConfig", { provider, environment: env });
 }
 async function updateIntegrationConfig(provider, env, config) {
-  return convexMutation3("integrations:updateConfig", { provider, environment: env, config });
+  return convexMutation4("integrations:updateConfig", { provider, environment: env, config });
 }
 async function testIntegrationConnection(provider, env) {
   return convexAction2("integrations:testConnection", { provider, environment: env });
 }
 async function deleteIntegrationConfig(provider, env) {
-  return convexMutation3("integrations:deleteConfig", { provider, environment: env });
+  return convexMutation4("integrations:deleteConfig", { provider, environment: env });
 }
 async function listIntegrationConfigs(env) {
   return convexQuery5("integrations:listConfigs", { environment: env });
 }
 async function setIntegrationStatus(provider, env, status) {
-  return convexMutation3("integrations:setConfigStatus", { provider, environment: env, status });
+  return convexMutation4("integrations:setConfigStatus", { provider, environment: env, status });
 }
 
 // src/cli/commands/integration.ts
@@ -7187,7 +7463,7 @@ async function convexQuery6(path, args) {
   }
   return json.value;
 }
-async function convexMutation4(path, args) {
+async function convexMutation5(path, args) {
   const token = getToken3();
   const response = await fetch(`${CONVEX_URL}/api/mutation`, {
     method: "POST",
@@ -7239,14 +7515,14 @@ async function getLastRunStatuses(environment) {
   return convexQuery6("triggers:getLastRunStatuses", { environment });
 }
 async function cancelTriggerRun(runId, environment) {
-  return convexMutation4("triggers:cancelRun", { runId, environment });
+  return convexMutation5("triggers:cancelRun", { runId, environment });
 }
 async function retryTriggerRun(runId, environment) {
-  return convexMutation4("triggers:retryRun", { runId, environment });
+  return convexMutation5("triggers:retryRun", { runId, environment });
 }
 async function toggleTrigger(slug, enabled, environment) {
   const path = enabled ? "triggers:enable" : "triggers:disable";
-  return convexMutation4(path, { slug, environment });
+  return convexMutation5(path, { slug, environment });
 }
 async function listTriggerExecutions(options) {
   return convexQuery6("triggers:listExecutions", {
@@ -8281,7 +8557,7 @@ import chalk23 from "chalk";
 import ora17 from "ora";
 import readline from "readline";
 init_convex();
-var chatCommand = new Command21("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) => {
+var chatCommand = new Command21("chat").description("Chat with an agent or via a router").argument("<slug>", "Agent slug (or router slug when --router is used)").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").option("--router", "Chat via a router instead of directly with an agent").option("--phone <number>", "Sender phone number for routing rules").action(async (slug, options) => {
   const spinner = ora17();
   const cwd = process.cwd();
   const nonInteractive = !isInteractive();
@@ -8333,6 +8609,15 @@ var chatCommand = new Command21("chat").description("Chat with an agent").argume
     console.log();
   }
   const environment = options.env;
+  const isRouterMode = !!options.router;
+  if (isRouterMode && !options.phone) {
+    if (jsonMode) {
+      console.log(JSON.stringify({ success: false, error: "--phone is required when using --router" }));
+    } else {
+      console.log(chalk23.red("--phone is required when using --router"));
+    }
+    process.exit(1);
+  }
   if (environment === "production" && !nonInteractive && !options.confirm) {
     const confirmRl = readline.createInterface({ input: process.stdin, output: process.stdout });
     await new Promise((resolve) => {
@@ -8342,8 +8627,20 @@ var chatCommand = new Command21("chat").description("Chat with an agent").argume
     confirmRl.close();
   }
   const doChat = async (message, threadId2, signal) => {
+    if (isRouterMode) {
+      return chatWithRouter({
+        routerSlug: slug,
+        message,
+        threadId: threadId2,
+        phoneNumber: options.phone,
+        environment,
+        organizationId: project?.organization.id,
+        channel: options.channel,
+        signal
+      });
+    }
     return chatWithAgent({
-      slug: agentSlug,
+      slug,
       message,
       threadId: threadId2,
       environment,
@@ -8395,12 +8692,22 @@ var chatCommand = new Command21("chat").description("Chat with an agent").argume
     }
     if (!jsonMode)
       spinner.succeed("Message sent");
+    const routerResult = result;
     if (jsonMode) {
-      console.log(JSON.stringify({ message: result.message, threadId: result.threadId, usage: result.usage }, null, 2));
+      const output = { message: result.message, threadId: result.threadId, usage: result.usage };
+      if (routerResult.routedToAgent) {
+        output.routedToAgent = routerResult.routedToAgent;
+        output.routedToAgentSlug = routerResult.routedToAgentSlug;
+      }
+      console.log(JSON.stringify(output, null, 2));
     } else {
       console.log();
       console.log("\u2500".repeat(60));
       console.log();
+      if (routerResult.routedToAgent) {
+        console.log(chalk23.magenta(`Routed to: ${routerResult.routedToAgent} (${routerResult.routedToAgentSlug})`));
+        console.log();
+      }
       console.log(chalk23.green("Agent:"));
       console.log(result.message);
       console.log();
@@ -8416,7 +8723,8 @@ var chatCommand = new Command21("chat").description("Chat with an agent").argume
     }
     return;
   }
-  console.log(chalk23.bold(`Chat with ${chalk23.cyan(agentSlug)} (${environment})`));
+  const headerLabel = isRouterMode ? `router ${chalk23.cyan(slug)}` : chalk23.cyan(slug);
+  console.log(chalk23.bold(`Chat with ${headerLabel} (${environment})`));
   console.log(chalk23.dim("Type 'exit' to quit"));
   console.log();
   let threadId = options.thread;
@@ -8505,7 +8813,12 @@ var chatCommand = new Command21("chat").description("Chat with an agent").argume
     }
     spinner.stop();
     threadId = result.threadId;
+    const interactiveRouterResult = result;
     console.log();
+    if (interactiveRouterResult.routedToAgent) {
+      console.log(chalk23.magenta(`Routed to: ${interactiveRouterResult.routedToAgent} (${interactiveRouterResult.routedToAgentSlug})`));
+      console.log();
+    }
     console.log(chalk23.green("Agent:"));
     console.log(result.message);
     console.log();
@@ -8528,10 +8841,207 @@ var chatCommand = new Command21("chat").description("Chat with an agent").argume
     process.exit(0);
   });
 });
+
+// src/cli/commands/whatsapp.ts
+init_credentials();
+import { Command as Command22 } from "commander";
+import chalk24 from "chalk";
+async function ensureAuth6() {
+  const cwd = process.cwd();
+  const nonInteractive = !isInteractive();
+  if (!hasProject(cwd)) {
+    if (nonInteractive) {
+      console.error(chalk24.red("No struere.json found. Run struere init first."));
+      process.exit(1);
+    }
+    console.log(chalk24.yellow("No struere.json found - initializing project..."));
+    console.log();
+    const success = await runInit(cwd);
+    if (!success) {
+      process.exit(1);
+    }
+    console.log();
+  }
+  let credentials = loadCredentials();
+  const apiKey = getApiKey();
+  if (!credentials && !apiKey) {
+    if (nonInteractive) {
+      console.error(chalk24.red("Not authenticated. Set STRUERE_API_KEY or run struere login."));
+      process.exit(1);
+    }
+    console.log(chalk24.yellow("Not logged in - authenticating..."));
+    console.log();
+    credentials = await performLogin();
+    if (!credentials) {
+      console.log(chalk24.red("Authentication failed"));
+      process.exit(1);
+    }
+    console.log();
+  }
+  return true;
+}
+async function resolveConnection(env, identifier, out) {
+  out.start("Fetching WhatsApp connections");
+  const { data, error } = await listWhatsAppConnections(env);
+  if (error || !data) {
+    out.fail("Failed to fetch connections");
+    out.error(error ?? "Unknown error");
+    return null;
+  }
+  const connections = data;
+  const match = connections.find((c) => {
+    if (c._id === identifier)
+      return true;
+    if (c._id.endsWith(identifier))
+      return true;
+    if (c.label && c.label.toLowerCase() === identifier.toLowerCase())
+      return true;
+    if (c.phoneNumber && c.phoneNumber === identifier.replace(/^\+/, ""))
+      return true;
+    if (c.phoneNumber && `+${c.phoneNumber}` === identifier)
+      return true;
+    return false;
+  });
+  if (!match) {
+    out.fail(`Connection not found: ${identifier}`);
+    out.info('Run "struere whatsapp list" to see available connections');
+    return null;
+  }
+  out.succeed(`Found connection: ${match.label || (match.phoneNumber ? `+${match.phoneNumber}` : match._id)}`);
+  return match;
+}
+function connectionLabel(conn) {
+  return conn.label || (conn.phoneNumber ? `+${conn.phoneNumber}` : conn._id.slice(-12));
+}
+function statusColor5(status) {
+  switch (status) {
+    case "connected":
+      return chalk24.green(status);
+    case "pending_setup":
+      return chalk24.yellow("pending");
+    case "disconnected":
+      return chalk24.red(status);
+    default:
+      return chalk24.gray(status);
+  }
+}
+function assignmentLabel(conn) {
+  if (conn.routerName)
+    return `Router: ${conn.routerName}`;
+  if (conn.agentName)
+    return `Agent: ${conn.agentName}`;
+  if (conn.routerId)
+    return `Router: ${conn.routerId.slice(-8)}`;
+  if (conn.agentId)
+    return `Agent: ${conn.agentId.slice(-8)}`;
+  return chalk24.gray("none");
+}
+var whatsappCommand = new Command22("whatsapp").description("Manage WhatsApp connections and routing");
+whatsappCommand.command("list").description("List WhatsApp connections with routing assignments").option("--env <environment>", "Environment (development|production)", "production").option("--json", "Output raw JSON").action(async (opts) => {
+  await ensureAuth6();
+  const env = opts.env;
+  const out = createOutput();
+  out.start("Fetching WhatsApp connections");
+  const { data, error } = await listWhatsAppConnections(env);
+  if (error || !data) {
+    out.fail("Failed to fetch connections");
+    out.error(error ?? "Unknown error");
+    process.exit(1);
+  }
+  const connections = data;
+  out.succeed(`Found ${connections.length} connections`);
+  if (opts.json) {
+    console.log(JSON.stringify(connections, null, 2));
+    return;
+  }
+  console.log();
+  if (connections.length === 0) {
+    console.log(chalk24.gray("  No WhatsApp connections found"));
+    console.log();
+    return;
+  }
+  renderTable([
+    { key: "label", label: "Label", width: 20 },
+    { key: "phone", label: "Phone", width: 18 },
+    { key: "status", label: "Status", width: 14 },
+    { key: "assignment", label: "Assignment", width: 30 },
+    { key: "id", label: "ID", width: 16 }
+  ], connections.map((c) => ({
+    label: c.label || chalk24.gray("-"),
+    phone: c.phoneNumber ? `+${c.phoneNumber}` : chalk24.gray("-"),
+    status: statusColor5(c.status),
+    assignment: assignmentLabel(c),
+    id: c._id.slice(-12)
+  })));
+  console.log();
+});
+whatsappCommand.command("set-router <connection> <router-slug>").description("Assign a router to a WhatsApp connection").option("--env <environment>", "Environment (development|production)", "production").action(async (connection, routerSlug, opts) => {
+  await ensureAuth6();
+  const env = opts.env;
+  const out = createOutput();
+  const conn = await resolveConnection(env, connection, out);
+  if (!conn)
+    process.exit(1);
+  out.start(`Looking up router "${routerSlug}"`);
+  const { data: routersData, error: routersError } = await listRouters(env);
+  if (routersError || !routersData) {
+    out.fail("Failed to fetch routers");
+    out.error(routersError ?? "Unknown error");
+    process.exit(1);
+  }
+  const routers = routersData;
+  const router = routers.find((r) => r.slug === routerSlug);
+  if (!router) {
+    out.fail(`Router not found: ${routerSlug}`);
+    if (routers.length > 0) {
+      out.info(`Available routers: ${routers.map((r) => r.slug).join(", ")}`);
+    } else {
+      out.info("No routers found in this environment");
+    }
+    process.exit(1);
+  }
+  out.succeed(`Found router: ${router.name}`);
+  out.start("Assigning router to connection");
+  const { error: setError } = await setConnectionRouter(conn._id, router._id);
+  if (setError) {
+    out.fail("Failed to assign router");
+    out.error(setError);
+    process.exit(1);
+  }
+  out.succeed(`Connection ${connectionLabel(conn)} now routes via ${router.name} (${routerSlug})`);
+  console.log();
+});
+whatsappCommand.command("set-agent <connection> <agent-slug>").description("Assign an agent directly to a WhatsApp connection").option("--env <environment>", "Environment (development|production)", "production").action(async (connection, agentSlug, opts) => {
+  await ensureAuth6();
+  const env = opts.env;
+  const out = createOutput();
+  const conn = await resolveConnection(env, connection, out);
+  if (!conn)
+    process.exit(1);
+  out.start(`Looking up agent "${agentSlug}"`);
+  const { data: agentData, error: agentError } = await resolveAgentBySlug(agentSlug);
+  if (agentError || !agentData) {
+    out.fail(`Agent not found: ${agentSlug}`);
+    if (agentError)
+      out.error(agentError);
+    process.exit(1);
+  }
+  const agent = agentData;
+  out.succeed(`Found agent: ${agent.name}`);
+  out.start("Assigning agent to connection");
+  const { error: setError } = await setConnectionAgent(conn._id, agent._id);
+  if (setError) {
+    out.fail("Failed to assign agent");
+    out.error(setError);
+    process.exit(1);
+  }
+  out.succeed(`Connection ${connectionLabel(conn)} now assigned to agent ${agent.name} (${agentSlug})`);
+  console.log();
+});
 // package.json
 var package_default = {
   name: "struere",
-  version: "0.12.1",
+  version: "0.12.3",
   description: "Build, test, and deploy AI agents",
   keywords: [
     "ai",
@@ -8652,4 +9162,5 @@ program.addCommand(triggersCommand);
 program.addCommand(compilePromptCommand);
 program.addCommand(runToolCommand);
 program.addCommand(chatCommand);
+program.addCommand(whatsappCommand);
 program.parse();