@rudderhq/cli 0.3.4-canary.12 → 0.3.4-canary.14

package/dist/index.js

@@ -11023,12 +11023,327 @@ var AGENT_CLI_CAPABILITIES = [
     requiresAgentId: false,
     requiresRunId: false,
     attachesRunIdWhenAvailable: true
+  },
+  {
+    id: "automation.list",
+    command: "rudder automation list --org-id <id>",
+    category: "automation",
+    description: "List automations for an organization with compact local filters.",
+    mutating: false,
+    contract: "agent-v1",
+    requiresOrgId: true,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: false
+  },
+  {
+    id: "automation.get",
+    command: "rudder automation get <automation-id>",
+    category: "automation",
+    description: "Read one automation detail including triggers and recent runs.",
+    mutating: false,
+    contract: "agent-v1",
+    requiresOrgId: false,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: false
+  },
+  {
+    id: "automation.runs",
+    command: "rudder automation runs <automation-id>",
+    category: "automation",
+    description: "List recent runs for one automation.",
+    mutating: false,
+    contract: "agent-v1",
+    requiresOrgId: false,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: false
+  },
+  {
+    id: "automation.triggers.list",
+    command: "rudder automation triggers list <automation-id>",
+    category: "automation",
+    description: "List triggers configured for one automation.",
+    mutating: false,
+    contract: "agent-v1",
+    requiresOrgId: false,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: false
+  },
+  {
+    id: "automation.create",
+    command: "rudder automation create --org-id <id> --title <title> --assignee-agent-id <id>",
+    category: "automation",
+    description: "Create an automation through the governed automation API.",
+    mutating: true,
+    contract: "agent-v1",
+    requiresOrgId: true,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: true
+  },
+  {
+    id: "automation.update",
+    command: "rudder automation update <automation-id>",
+    category: "automation",
+    description: "Update automation fields through the governed automation API.",
+    mutating: true,
+    contract: "agent-v1",
+    requiresOrgId: false,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: true
+  },
+  {
+    id: "automation.enable",
+    command: "rudder automation enable <automation-id>",
+    category: "automation",
+    description: "Enable an automation by setting status to active.",
+    mutating: true,
+    contract: "agent-v1",
+    requiresOrgId: false,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: true
+  },
+  {
+    id: "automation.disable",
+    command: "rudder automation disable <automation-id>",
+    category: "automation",
+    description: "Disable an automation by setting status to paused.",
+    mutating: true,
+    contract: "agent-v1",
+    requiresOrgId: false,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: true
+  },
+  {
+    id: "automation.run",
+    command: "rudder automation run <automation-id>",
+    category: "automation",
+    description: "Trigger a manual automation run.",
+    mutating: true,
+    contract: "agent-v1",
+    requiresOrgId: false,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: true
+  },
+  {
+    id: "chat.list",
+    command: "rudder chat list --org-id <id>",
+    category: "chat",
+    description: "List chat conversations without dumping full message history.",
+    mutating: false,
+    contract: "agent-v1",
+    requiresOrgId: true,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: false
+  },
+  {
+    id: "chat.search",
+    command: "rudder chat search <query> --org-id <id>",
+    category: "chat",
+    description: "Search chats with bounded snippets and optional scope filtering.",
+    mutating: false,
+    contract: "agent-v1",
+    requiresOrgId: true,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: false
+  },
+  {
+    id: "chat.get",
+    command: "rudder chat get <chat-id>",
+    category: "chat",
+    description: "Read one chat conversation record.",
+    mutating: false,
+    contract: "agent-v1",
+    requiresOrgId: false,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: false
+  },
+  {
+    id: "chat.messages",
+    command: "rudder chat messages <chat-id> [--limit <n>] [--cursor <cursor>] [--include-transcript]",
+    category: "chat",
+    description: "Read bounded chat messages with page cursors; transcript output is omitted unless requested.",
+    mutating: false,
+    contract: "agent-v1",
+    requiresOrgId: false,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: false
+  },
+  {
+    id: "chat.transcript",
+    command: "rudder chat transcript <chat-id> [--limit <n>] [--cursor <cursor>] [--max-output-chars <n>]",
+    category: "chat",
+    description: "Read paginated chat messages with assistant transcript entries clipped in human output.",
+    mutating: false,
+    contract: "agent-v1",
+    requiresOrgId: false,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: false
+  },
+  {
+    id: "chat.read",
+    command: "rudder chat read <chat-id> [--turn-limit <n>] [--cursor <cursor>] [--include-output]",
+    category: "chat",
+    description: "Read a bounded recent-message snapshot for one chat with page cursors.",
+    mutating: false,
+    contract: "agent-v1",
+    requiresOrgId: false,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: false
+  },
+  {
+    id: "chat.create",
+    command: "rudder chat create --org-id <id>",
+    category: "chat",
+    description: "Create a chat conversation.",
+    mutating: true,
+    contract: "agent-v1",
+    requiresOrgId: true,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: true
+  },
+  {
+    id: "chat.send",
+    command: "rudder chat send <chat-id> --body <text>",
+    category: "chat",
+    description: "Send a chat message and persist the assistant reply through the server.",
+    mutating: true,
+    contract: "agent-v1",
+    requiresOrgId: false,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: true
+  },
+  {
+    id: "chat.archive",
+    command: "rudder chat archive <chat-id>",
+    category: "chat",
+    description: "Archive a chat conversation without deleting it.",
+    mutating: true,
+    contract: "agent-v1",
+    requiresOrgId: false,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: true
+  },
+  {
+    id: "runs.list",
+    command: "rudder runs list --org-id <id>",
+    category: "runs",
+    description: "List observed agent runs with filters for status, agent, issue, runtime, and time.",
+    mutating: false,
+    contract: "agent-v1",
+    requiresOrgId: true,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: false
+  },
+  {
+    id: "runs.get",
+    command: "rudder runs get <run-id>",
+    category: "runs",
+    description: "Read one observed run detail.",
+    mutating: false,
+    contract: "agent-v1",
+    requiresOrgId: false,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: false
+  },
+  {
+    id: "runs.events",
+    command: "rudder runs events <run-id>",
+    category: "runs",
+    description: "List persisted run events.",
+    mutating: false,
+    contract: "agent-v1",
+    requiresOrgId: false,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: false
+  },
+  {
+    id: "runs.log",
+    command: "rudder runs log <run-id>",
+    category: "runs",
+    description: "Read stored run log content with clipped human output.",
+    mutating: false,
+    contract: "agent-v1",
+    requiresOrgId: false,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: false
+  },
+  {
+    id: "runs.transcript",
+    command: "rudder runs transcript <run-id> [--turn-limit <n>] [--cursor <cursor>] [--include-output]",
+    category: "runs",
+    description: "Read the server-normalized run transcript; human output is compact and JSON includes full entries.",
+    mutating: false,
+    contract: "agent-v1",
+    requiresOrgId: false,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: false
+  },
+  {
+    id: "runs.errors",
+    command: "rudder runs errors <run-id>",
+    category: "runs",
+    description: "List failed tool calls, stderr, runtime failures, and jump-to-context commands.",
+    mutating: false,
+    contract: "agent-v1",
+    requiresOrgId: false,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: false
+  },
+  {
+    id: "runs.cancel",
+    command: "rudder runs cancel <run-id>",
+    category: "runs",
+    description: "Cancel a heartbeat run through the governed server route.",
+    mutating: true,
+    contract: "agent-v1",
+    requiresOrgId: false,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: true
+  },
+  {
+    id: "runs.retry",
+    command: "rudder runs retry <run-id>",
+    category: "runs",
+    description: "Retry a failed, timed out, or cancelled run through the governed server route.",
+    mutating: true,
+    contract: "agent-v1",
+    requiresOrgId: false,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: true
   }
 ];
 var CATEGORY_TITLES = {
   agent: "Agent",
   issue: "Issue",
   project: "Project",
+  automation: "Automation",
+  chat: "Chat",
+  runs: "Runs",
   approval: "Approval",
   skill: "Skill",
   library: "Library"
@@ -12917,6 +13232,664 @@ async function readStdinText3() {
   return Buffer.concat(chunks).toString("utf8");
 }
 
+// src/commands/client/automation.ts
+init_dist();
+function registerAutomationCommands(program) {
+  const automation = program.command("automation").description("Automation operations");
+  addCommonClientOptions(
+    automation.command("list").description(getAgentCliCapabilityById("automation.list").description).option("-O, --org-id <id>", "Organization ID").option("--status <status>", "Filter by automation status").option("--assignee-agent-id <id>", "Filter by assignee agent ID").option("--project-id <id>", "Filter by project ID").option("--output-mode <mode>", "Filter by output mode").action(async (opts) => {
+      try {
+        const ctx = resolveCommandContext(opts, { requireCompany: true });
+        const rows = await ctx.api.get(`/api/orgs/${ctx.orgId}/automations`) ?? [];
+        const filtered = rows.filter(
+          (row) => (!opts.status || row.status === opts.status) && (!opts.assigneeAgentId || row.assigneeAgentId === opts.assigneeAgentId) && (!opts.projectId || row.projectId === opts.projectId) && (!opts.outputMode || row.outputMode === opts.outputMode)
+        );
+        printOutput(ctx.json ? filtered : filtered.map(formatAutomationListItem), { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    }),
+    { includeCompany: false }
+  );
+  addCommonClientOptions(
+    automation.command("get").description(getAgentCliCapabilityById("automation.get").description).argument("<automationId>", "Automation ID").action(async (automationId, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts);
+        const row = await ctx.api.get(`/api/automations/${encodeURIComponent(automationId)}`);
+        printOutput(row, { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    })
+  );
+  addCommonClientOptions(
+    automation.command("runs").description(getAgentCliCapabilityById("automation.runs").description).argument("<automationId>", "Automation ID").option("--limit <n>", "Maximum runs to return", "50").action(async (automationId, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts);
+        const params = new URLSearchParams();
+        if (opts.limit) params.set("limit", opts.limit);
+        const rows = await ctx.api.get(
+          `/api/automations/${encodeURIComponent(automationId)}/runs?${params.toString()}`
+        ) ?? [];
+        printOutput(ctx.json ? rows : rows.map(formatAutomationRun), { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    })
+  );
+  addCommonClientOptions(
+    automation.command("triggers").description("Automation trigger operations").command("list").description(getAgentCliCapabilityById("automation.triggers.list").description).argument("<automationId>", "Automation ID").action(async (automationId, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts);
+        const row = await ctx.api.get(`/api/automations/${encodeURIComponent(automationId)}`);
+        const triggers = row?.triggers ?? [];
+        printOutput(triggers, { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    })
+  );
+  addCommonClientOptions(
+    automation.command("create").description(getAgentCliCapabilityById("automation.create").description).option("-O, --org-id <id>", "Organization ID").option("--payload <json>", "Raw automation create payload JSON").option("--title <title>", "Automation title").option("--description <text>", "Automation description").option("--assignee-agent-id <id>", "Assignee agent ID").option("--project-id <id>", "Project ID").option("--goal-id <id>", "Goal ID").option("--parent-issue-id <id>", "Parent issue ID").option("--priority <priority>", "Issue priority for tracked output").option("--status <status>", "Automation status").option("--output-mode <mode>", "Automation output mode").option("--concurrency-policy <policy>", "Automation concurrency policy").option("--catch-up-policy <policy>", "Automation catch-up policy").option("--notify-on-issue-created", "Notify when tracked issue output is created").action(async (opts) => {
+      try {
+        const ctx = resolveCommandContext(opts, { requireCompany: true });
+        const payload = createAutomationSchema.parse(buildAutomationPayload(opts));
+        const created = await ctx.api.post(`/api/orgs/${ctx.orgId}/automations`, payload);
+        printOutput(created, { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    }),
+    { includeCompany: false }
+  );
+  addCommonClientOptions(
+    automation.command("update").description(getAgentCliCapabilityById("automation.update").description).argument("<automationId>", "Automation ID").option("--payload <json>", "Raw automation update payload JSON").option("--title <title>", "Automation title").option("--description <text>", "Automation description").option("--assignee-agent-id <id>", "Assignee agent ID").option("--project-id <id>", "Project ID").option("--goal-id <id>", "Goal ID").option("--parent-issue-id <id>", "Parent issue ID").option("--priority <priority>", "Issue priority for tracked output").option("--status <status>", "Automation status").option("--output-mode <mode>", "Automation output mode").option("--concurrency-policy <policy>", "Automation concurrency policy").option("--catch-up-policy <policy>", "Automation catch-up policy").option("--notify-on-issue-created", "Notify when tracked issue output is created").action(async (automationId, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts);
+        const payload = updateAutomationSchema.parse(buildAutomationPayload(opts));
+        const updated = await ctx.api.patch(`/api/automations/${encodeURIComponent(automationId)}`, payload);
+        printOutput(updated, { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    })
+  );
+  addCommonClientOptions(
+    automation.command("enable").description(getAgentCliCapabilityById("automation.enable").description).argument("<automationId>", "Automation ID").action(async (automationId, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts);
+        const updated = await ctx.api.patch(`/api/automations/${encodeURIComponent(automationId)}`, {
+          status: "active"
+        });
+        printOutput(updated, { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    })
+  );
+  addCommonClientOptions(
+    automation.command("disable").description(getAgentCliCapabilityById("automation.disable").description).argument("<automationId>", "Automation ID").action(async (automationId, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts);
+        const updated = await ctx.api.patch(`/api/automations/${encodeURIComponent(automationId)}`, {
+          status: "paused"
+        });
+        printOutput(updated, { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    })
+  );
+  addCommonClientOptions(
+    automation.command("run").description(getAgentCliCapabilityById("automation.run").description).argument("<automationId>", "Automation ID").option("--trigger-id <id>", "Trigger ID").option("--payload <json>", "Manual run payload JSON").option("--idempotency-key <key>", "Idempotency key").option("--source <source>", "Run source", "manual").action(async (automationId, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts);
+        const payload = runAutomationSchema.parse({
+          triggerId: opts.triggerId,
+          payload: opts.payload ? parseJsonOption(opts.payload, "--payload") : void 0,
+          idempotencyKey: opts.idempotencyKey,
+          source: opts.source
+        });
+        const run = await ctx.api.post(`/api/automations/${encodeURIComponent(automationId)}/run`, payload);
+        printOutput(run, { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    })
+  );
+}
+function buildAutomationPayload(opts) {
+  return {
+    ...parseJsonObjectOption(opts.payload, "--payload"),
+    ...definedRecord({
+      title: opts.title,
+      description: opts.description,
+      assigneeAgentId: opts.assigneeAgentId,
+      projectId: opts.projectId,
+      goalId: opts.goalId,
+      parentIssueId: opts.parentIssueId,
+      priority: opts.priority,
+      status: opts.status,
+      outputMode: opts.outputMode,
+      concurrencyPolicy: opts.concurrencyPolicy,
+      catchUpPolicy: opts.catchUpPolicy,
+      notifyOnIssueCreated: opts.notifyOnIssueCreated
+    })
+  };
+}
+function definedRecord(record) {
+  return Object.fromEntries(Object.entries(record).filter(([, value]) => value !== void 0));
+}
+function parseJsonOption(value, label) {
+  try {
+    return JSON.parse(value);
+  } catch (error) {
+    throw new Error(`${label} must be valid JSON`);
+  }
+}
+function parseJsonObjectOption(value, label) {
+  if (!value) return {};
+  const parsed = parseJsonOption(value, label);
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+    throw new Error(`${label} must be a JSON object`);
+  }
+  return parsed;
+}
+function formatAutomationListItem(row) {
+  const nextRunAt = row.triggers.map((trigger) => trigger.nextRunAt).filter(Boolean).sort()[0] ?? null;
+  return {
+    id: row.id,
+    title: row.title,
+    status: row.status,
+    assigneeAgentId: row.assigneeAgentId,
+    outputMode: row.outputMode,
+    lastRun: row.lastRun?.status ?? "-",
+    nextRunAt
+  };
+}
+function formatAutomationRun(row) {
+  return {
+    id: row.id,
+    status: row.status,
+    source: row.source,
+    triggeredAt: row.triggeredAt,
+    linkedIssue: row.linkedIssue?.identifier ?? row.linkedIssueId ?? "-",
+    linkedChatConversationId: row.linkedChatConversationId ?? "-",
+    failureReason: row.failureReason ?? "-"
+  };
+}
+
+// src/commands/client/chat.ts
+init_dist();
+function registerChatCommands(program) {
+  const chat = program.command("chat").description("Chat operations");
+  addCommonClientOptions(
+    chat.command("list").description(getAgentCliCapabilityById("chat.list").description).option("-O, --org-id <id>", "Organization ID").option("--status <status>", "active, resolved, archived, or all", "active").option("--query <text>", "Server-side chat search query").option("--limit <n>", "Maximum rows to print").action(async (opts) => {
+      try {
+        const ctx = resolveCommandContext(opts, { requireCompany: true });
+        const rows = await listChats(ctx, opts);
+        printOutput(ctx.json ? rows : rows.map(formatChatConversation), { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    }),
+    { includeCompany: false }
+  );
+  addCommonClientOptions(
+    chat.command("search").description(getAgentCliCapabilityById("chat.search").description).argument("<query>", "Search query").option("-O, --org-id <id>", "Organization ID").option("--status <status>", "active, resolved, archived, or all", "all").option("--scope <scope>", "Search scope: all, title, summary, messages", "all").option("--limit <n>", "Maximum rows to print", "20").option("--snippet-chars <n>", "Maximum snippet characters", "220").action(async (query, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts, { requireCompany: true });
+        const rows = await listChats(ctx, { ...opts, query });
+        const filtered = filterChatSearchRows(rows, query, opts.scope ?? "all").slice(0, parseLimit(opts.limit, rows.length));
+        const snippetChars = parseLimit(opts.snippetChars, 220);
+        printOutput(
+          ctx.json ? filtered : filtered.map((row) => formatChatSearchResult(row, snippetChars)),
+          { json: ctx.json }
+        );
+      } catch (err) {
+        handleCommandError(err);
+      }
+    }),
+    { includeCompany: false }
+  );
+  addCommonClientOptions(
+    chat.command("get").description(getAgentCliCapabilityById("chat.get").description).argument("<chatId>", "Chat conversation ID").action(async (chatId, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts);
+        const row = await ctx.api.get(`/api/chats/${encodeURIComponent(chatId)}`);
+        printOutput(row, { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    })
+  );
+  addCommonClientOptions(
+    chat.command("messages").description(getAgentCliCapabilityById("chat.messages").description).argument("<chatId>", "Chat conversation ID").option("--include-transcript", "Include assistant transcript entries").option("--include-output", "Alias for --include-transcript").option("--include-outputs", "Alias for --include-transcript").option("--limit <n>", "Maximum messages to print").option("--cursor <cursor>", "Stable message cursor returned in page.nextCursor").option("--max-output-chars <n>", "Maximum transcript output chars for human output", "1200").action(async (chatId, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts);
+        const page = await getChatMessagesPage(ctx, chatId, {
+          includeTranscript: includesChatTranscript(opts),
+          limit: opts.limit,
+          cursor: opts.cursor
+        });
+        printOutput(
+          ctx.json ? page : page.messages.map((message) => formatChatMessage(message, parseLimit(opts.maxOutputChars, 1200))),
+          { json: ctx.json }
+        );
+      } catch (err) {
+        handleCommandError(err);
+      }
+    })
+  );
+  addCommonClientOptions(
+    chat.command("transcript").description(getAgentCliCapabilityById("chat.transcript").description).argument("<chatId>", "Chat conversation ID").option("--limit <n>", "Maximum messages to print").option("--cursor <cursor>", "Stable message cursor returned in page.nextCursor").option("--max-chars <n>", "Maximum transcript chars per message", "1200").option("--max-output-chars <n>", "Alias for --max-chars").action(async (chatId, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts);
+        const page = await getChatMessagesPage(ctx, chatId, {
+          includeTranscript: true,
+          limit: opts.limit,
+          cursor: opts.cursor
+        });
+        const maxChars = parseLimit(opts.maxOutputChars ?? opts.maxChars, 1200);
+        printOutput(
+          ctx.json ? page : page.messages.flatMap((message) => formatChatTranscriptMessage(message, maxChars)),
+          { json: ctx.json }
+        );
+      } catch (err) {
+        handleCommandError(err);
+      }
+    })
+  );
+  addCommonClientOptions(
+    chat.command("read").description(getAgentCliCapabilityById("chat.read").description).argument("<chatId>", "Chat conversation ID").option("--include-transcript", "Include assistant transcript entries").option("--include-output", "Alias for --include-transcript").option("--include-outputs", "Alias for --include-transcript").option("--limit <n>", "Maximum recent messages", "20").option("--turn-limit <n>", "Alias for --limit for chat turn snapshots").option("--cursor <cursor>", "Stable message cursor returned in page.nextCursor").option("--max-output-chars <n>", "Maximum transcript output chars for human output", "1200").action(async (chatId, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts);
+        const [conversation, page] = await Promise.all([
+          ctx.api.get(`/api/chats/${encodeURIComponent(chatId)}`),
+          getChatMessagesPage(ctx, chatId, {
+            includeTranscript: includesChatTranscript(opts),
+            limit: opts.turnLimit ?? opts.limit,
+            cursor: opts.cursor
+          })
+        ]);
+        const payload = {
+          conversation,
+          messages: page.messages,
+          page: page.page
+        };
+        printOutput(
+          ctx.json ? payload : page.messages.map((message) => formatChatMessage(message, parseLimit(opts.maxOutputChars, 1200))),
+          { json: ctx.json }
+        );
+      } catch (err) {
+        handleCommandError(err);
+      }
+    })
+  );
+  addCommonClientOptions(
+    chat.command("create").description(getAgentCliCapabilityById("chat.create").description).option("-O, --org-id <id>", "Organization ID").option("--payload <json>", "Raw chat create payload JSON").option("--title <title>", "Chat title").option("--summary <text>", "Chat summary").option("--preferred-agent-id <id>", "Preferred agent ID").option("--issue-creation-mode <mode>", "Issue creation mode").option("--plan-mode", "Create a plan-mode chat").action(async (opts) => {
+      try {
+        const ctx = resolveCommandContext(opts, { requireCompany: true });
+        const payload = createChatConversationSchema.parse({
+          ...parseJsonObjectOption2(opts.payload, "--payload"),
+          ...definedRecord2({
+            title: opts.title,
+            summary: opts.summary,
+            preferredAgentId: opts.preferredAgentId,
+            issueCreationMode: opts.issueCreationMode,
+            planMode: opts.planMode
+          })
+        });
+        const created = await ctx.api.post(`/api/orgs/${ctx.orgId}/chats`, payload);
+        printOutput(created, { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    }),
+    { includeCompany: false }
+  );
+  addCommonClientOptions(
+    chat.command("send").description(getAgentCliCapabilityById("chat.send").description).argument("<chatId>", "Chat conversation ID").option("--body <text>", "Message body").option("--edit-user-message-id <id>", "Regenerate/edit from a prior user message").action(async (chatId, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts);
+        const body = opts.body ?? await readStdin();
+        const payload = addChatMessageSchema.parse({
+          body,
+          editUserMessageId: opts.editUserMessageId
+        });
+        const result = await ctx.api.post(`/api/chats/${encodeURIComponent(chatId)}/messages`, payload);
+        printOutput(result, { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    })
+  );
+  addCommonClientOptions(
+    chat.command("archive").description(getAgentCliCapabilityById("chat.archive").description).argument("<chatId>", "Chat conversation ID").action(async (chatId, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts);
+        const payload = updateChatConversationSchema.parse({ status: "archived" });
+        const updated = await ctx.api.patch(`/api/chats/${encodeURIComponent(chatId)}`, payload);
+        printOutput(updated, { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    })
+  );
+}
+async function listChats(ctx, opts) {
+  const params = new URLSearchParams();
+  if (opts.status) params.set("status", opts.status);
+  if (opts.query) params.set("q", opts.query);
+  const rows = await ctx.api.get(`/api/orgs/${ctx.orgId}/chats?${params.toString()}`) ?? [];
+  return rows.slice(0, parseLimit(opts.limit, rows.length));
+}
+async function getChatMessagesPage(ctx, chatId, opts) {
+  const params = new URLSearchParams();
+  params.set("envelope", "true");
+  params.set("order", "newest");
+  params.set("limit", String(parseLimit(opts.limit, 50)));
+  if (opts.cursor) params.set("cursor", opts.cursor);
+  if (opts.includeTranscript) params.set("includeTranscript", "true");
+  const page = await ctx.api.get(`/api/chats/${encodeURIComponent(chatId)}/messages?${params.toString()}`);
+  if (!page) {
+    throw new Error("Chat messages response was empty");
+  }
+  return page;
+}
+function filterChatSearchRows(rows, query, scope) {
+  const normalized = query.toLowerCase();
+  if (scope === "all") return rows;
+  return rows.filter((row) => {
+    if (scope === "title") return row.title.toLowerCase().includes(normalized);
+    if (scope === "summary") return Boolean(row.summary?.toLowerCase().includes(normalized));
+    if (scope === "messages") return Boolean(row.searchPreview?.toLowerCase().includes(normalized));
+    return true;
+  });
+}
+function formatChatConversation(row) {
+  return {
+    id: row.id,
+    title: row.title,
+    status: row.status,
+    preferredAgentId: row.preferredAgentId ?? "-",
+    unread: row.unreadCount,
+    lastMessageAt: row.lastMessageAt ?? "-",
+    preview: row.latestReplyPreview ?? row.latestUserMessagePreview ?? "-"
+  };
+}
+function formatChatSearchResult(row, maxChars) {
+  return {
+    id: row.id,
+    title: row.title,
+    status: row.status,
+    lastMessageAt: row.lastMessageAt ?? "-",
+    snippet: clip(row.searchPreview ?? row.latestReplyPreview ?? row.latestUserMessagePreview ?? row.summary ?? "", maxChars)
+  };
+}
+function formatChatMessage(row, maxOutputChars = 1200) {
+  return {
+    id: row.id,
+    role: row.role,
+    kind: row.kind,
+    status: row.status,
+    createdAt: row.createdAt,
+    body: clip(row.body, 220),
+    transcriptEntries: row.transcriptSummary?.entryCount ?? row.transcript?.length ?? 0,
+    ...row.transcript?.length ? { transcriptPreview: clip(row.transcript.map((entry) => formatTranscriptEntry(entry, maxOutputChars)).join(" "), maxOutputChars) } : {}
+  };
+}
+function formatChatTranscriptMessage(row, maxChars) {
+  const header = {
+    id: row.id,
+    role: row.role,
+    kind: row.kind,
+    status: row.status,
+    createdAt: row.createdAt,
+    body: clip(row.body, 220)
+  };
+  const transcriptRows = (row.transcript ?? []).map((entry, index) => ({
+    id: `${row.id}:entry-${index + 1}`,
+    messageId: row.id,
+    role: row.role,
+    entry: formatTranscriptEntry(entry, maxChars)
+  }));
+  return transcriptRows.length > 0 ? [header, ...transcriptRows] : [header];
+}
+function formatTranscriptEntry(entry, maxChars) {
+  if (entry.kind === "tool_call") return `${entry.ts} tool_call ${entry.name} ${clip(JSON.stringify(entry.input), maxChars)}`;
+  if (entry.kind === "tool_result") return `${entry.ts} tool_result ${entry.toolName ?? entry.toolUseId} ${entry.isError ? "ERROR " : ""}${clip(entry.content, maxChars)}`;
+  if (entry.kind === "result") return `${entry.ts} result ${entry.isError ? "ERROR " : ""}${clip(entry.text || entry.errors.join("; "), maxChars)}`;
+  if ("text" in entry) return `${entry.ts} ${entry.kind} ${clip(entry.text, maxChars)}`;
+  return `${entry.ts} ${entry.kind}`;
+}
+function parseLimit(value, fallback) {
+  const parsed = Number(value ?? fallback);
+  if (!Number.isFinite(parsed) || parsed <= 0) return fallback;
+  return Math.floor(parsed);
+}
+function includesChatTranscript(opts) {
+  return Boolean(opts.includeTranscript || opts.includeOutput || opts.includeOutputs);
+}
+function clip(value, maxChars) {
+  const text6 = value.replace(/\s+/g, " ").trim();
+  if (text6.length <= maxChars) return text6;
+  return `${text6.slice(0, Math.max(0, maxChars - 1))}\u2026`;
+}
+function parseJsonObjectOption2(value, label) {
+  if (!value) return {};
+  try {
+    const parsed = JSON.parse(value);
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+      throw new Error(`${label} must be a JSON object`);
+    }
+    return parsed;
+  } catch (error) {
+    if (error instanceof Error && error.message.includes("JSON object")) throw error;
+    throw new Error(`${label} must be valid JSON`);
+  }
+}
+function definedRecord2(record) {
+  return Object.fromEntries(Object.entries(record).filter(([, value]) => value !== void 0));
+}
+async function readStdin() {
+  const chunks = [];
+  for await (const chunk of process.stdin) {
+    chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+  }
+  return Buffer.concat(chunks).toString("utf8");
+}
+
+// src/commands/client/runs.ts
+function registerRunsCommands(program) {
+  const runs = program.command("runs").description("Run debugging operations");
+  addCommonClientOptions(
+    runs.command("list").description(getAgentCliCapabilityById("runs.list").description).option("-O, --org-id <id>", "Organization ID").option("--updated-after <iso>", "Only runs updated after this timestamp").option("--run-id-prefix <prefix>", "Filter by run ID prefix").option("--agent-id <id>", "Filter by agent ID").option("--status <status>", "Filter by run status").option("--runtime <type>", "Filter by runtime type").option("--issue-id <id>", "Filter by linked issue ID").option("--created-before <iso>", "Only runs created before this timestamp").option("--limit <n>", "Maximum rows", "200").action(async (opts) => {
+      try {
+        const ctx = resolveCommandContext(opts, { requireCompany: true });
+        const rows = await ctx.api.get(`/api/run-intelligence/orgs/${ctx.orgId}/runs?${buildRunsListQuery(opts)}`) ?? [];
+        printOutput(ctx.json ? rows : rows.map(formatRunListRow), { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    }),
+    { includeCompany: false }
+  );
+  addCommonClientOptions(
+    runs.command("get").description(getAgentCliCapabilityById("runs.get").description).argument("<runId>", "Run ID").action(async (runId, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts);
+        const row = await ctx.api.get(`/api/run-intelligence/runs/${encodeURIComponent(runId)}`);
+        printOutput(row, { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    })
+  );
+  addCommonClientOptions(
+    runs.command("events").description(getAgentCliCapabilityById("runs.events").description).argument("<runId>", "Run ID").action(async (runId, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts);
+        const rows = await ctx.api.get(`/api/run-intelligence/runs/${encodeURIComponent(runId)}/events`) ?? [];
+        printOutput(ctx.json ? rows : rows.map(formatRunEvent), { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    })
+  );
+  addCommonClientOptions(
+    runs.command("log").description(getAgentCliCapabilityById("runs.log").description).argument("<runId>", "Run ID").option("--max-chars <n>", "Maximum log characters for human output", "12000").action(async (runId, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts);
+        const row = await ctx.api.get(`/api/run-intelligence/runs/${encodeURIComponent(runId)}/log`);
+        if (ctx.json) {
+          printOutput(row, { json: true });
+        } else {
+          process.stdout.write(clip2(row?.content ?? "", parseLimit2(opts.maxChars, 12e3)) + "\n");
+        }
+      } catch (err) {
+        handleCommandError(err);
+      }
+    })
+  );
+  addCommonClientOptions(
+    runs.command("transcript").description(getAgentCliCapabilityById("runs.transcript").description).argument("<runId>", "Run ID").option("--errors-only", "Show only error transcript rows").option("--around-error <id>", "Show context around a run error id such as step-12").option("--context-turns <n>", "Turns around --around-error", "1").option("--cursor <cursor>", "Stable transcript cursor returned in page.nextCursor").option("--turn-limit <n>", "Maximum turns to return", "20").option("--chronological", "Show oldest-first instead of default newest-first").option("--narrative", "Use a narrative human layout").option("--max-chars <n>", "Maximum output characters per row", "1200").option("--max-output-chars <n>", "Alias for --max-chars").option("--include-output", "Include row output in compact human transcript rows").option("--include-outputs", "Alias for --include-output").action(async (runId, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts);
+        const payload = await ctx.api.get(
+          `/api/run-intelligence/runs/${encodeURIComponent(runId)}/transcript?${buildTranscriptQuery(opts, { json: ctx.json })}`
+        );
+        if (ctx.json) {
+          printOutput(payload, { json: true });
+        } else if (opts.narrative) {
+          printOutput((payload?.rows ?? []).map(formatRunTranscriptNarrative), { json: false });
+        } else {
+          printOutput((payload?.rows ?? []).map(formatRunTranscriptRow), { json: false });
+        }
+      } catch (err) {
+        handleCommandError(err);
+      }
+    })
+  );
+  addCommonClientOptions(
+    runs.command("errors").description(getAgentCliCapabilityById("runs.errors").description).argument("<runId>", "Run ID").option("--max-chars <n>", "Maximum output characters per error", "1200").action(async (runId, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts);
+        const params = new URLSearchParams();
+        params.set("maxChars", String(parseLimit2(opts.maxChars, 1200)));
+        const payload = await ctx.api.get(
+          `/api/run-intelligence/runs/${encodeURIComponent(runId)}/errors?${params.toString()}`
+        );
+        printOutput(ctx.json ? payload : (payload?.errors ?? []).map(formatRunError), { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    })
+  );
+  addCommonClientOptions(
+    runs.command("cancel").description(getAgentCliCapabilityById("runs.cancel").description).argument("<runId>", "Run ID").action(async (runId, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts);
+        const row = await ctx.api.post(`/api/heartbeat-runs/${encodeURIComponent(runId)}/cancel`, {});
+        printOutput(row, { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    })
+  );
+  addCommonClientOptions(
+    runs.command("retry").description(getAgentCliCapabilityById("runs.retry").description).argument("<runId>", "Run ID").action(async (runId, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts);
+        const row = await ctx.api.post(`/api/heartbeat-runs/${encodeURIComponent(runId)}/retry`, {});
+        printOutput(row, { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    })
+  );
+}
+function buildRunsListQuery(opts) {
+  const params = new URLSearchParams();
+  if (opts.updatedAfter) params.set("updatedAfter", opts.updatedAfter);
+  if (opts.runIdPrefix) params.set("runIdPrefix", opts.runIdPrefix);
+  if (opts.agentId) params.set("agentId", opts.agentId);
+  if (opts.status) params.set("status", opts.status);
+  if (opts.runtime) params.set("runtime", opts.runtime);
+  if (opts.issueId) params.set("issueId", opts.issueId);
+  if (opts.createdBefore) params.set("createdBefore", opts.createdBefore);
+  if (opts.limit) params.set("limit", opts.limit);
+  return params.toString();
+}
+function buildTranscriptQuery(opts, output) {
+  const params = new URLSearchParams();
+  if (opts.errorsOnly) params.set("errorsOnly", "true");
+  if (opts.aroundError) params.set("aroundError", opts.aroundError);
+  if (opts.cursor) params.set("cursor", opts.cursor);
+  if (opts.turnLimit) params.set("turnLimit", String(parseLimit2(opts.turnLimit, 20)));
+  params.set("contextTurns", String(parseLimit2(opts.contextTurns, 1)));
+  params.set("order", opts.chronological || opts.narrative ? "oldest" : "newest");
+  params.set("output", output.json ? "full" : "compact");
+  const includeOutputs = output.json || Boolean(opts.includeOutput || opts.includeOutputs || opts.narrative);
+  params.set("includeOutputs", includeOutputs ? "true" : "false");
+  params.set("maxChars", String(parseLimit2(opts.maxOutputChars ?? opts.maxChars, 1200)));
+  return params.toString();
+}
+function formatRunListRow(row) {
+  return {
+    id: row.run.id,
+    status: row.run.status,
+    agent: row.agentName ?? row.run.agentId,
+    runtime: row.bundle.agentRuntimeType,
+    issue: row.issue?.identifier ?? row.issue?.id ?? "-",
+    updatedAt: row.run.updatedAt
+  };
+}
+function formatRunEvent(row) {
+  return {
+    seq: row.seq,
+    level: row.level,
+    stream: row.stream,
+    message: row.message,
+    createdAt: row.createdAt
+  };
+}
+function formatRunTranscriptRow(row) {
+  return {
+    id: row.id,
+    turn: row.turnIndex ?? "-",
+    kind: row.kind,
+    ts: row.ts,
+    error: row.isError ? "yes" : "no",
+    preview: row.preview || row.detailPreview,
+    ...row.output ? { output: row.output.text } : {}
+  };
+}
+function formatRunTranscriptNarrative(row) {
+  const marker = row.isError ? "ERROR " : "";
+  return `${row.id} ${row.ts} ${marker}${row.kind}: ${row.preview || row.detailPreview}${row.output ? `
+${row.output.text}` : ""}`;
+}
+function formatRunError(row) {
+  return {
+    id: row.id,
+    type: row.type,
+    turn: row.turnIndex ?? "-",
+    summary: row.summary,
+    output: row.output.text,
+    context: row.transcriptContext?.command ?? "-"
+  };
+}
+function parseLimit2(value, fallback) {
+  const parsed = Number(value ?? fallback);
+  if (!Number.isFinite(parsed) || parsed <= 0) return fallback;
+  return Math.floor(parsed);
+}
+function clip2(value, maxChars) {
+  if (value.length <= maxChars) return value;
+  return `${value.slice(0, Math.max(0, maxChars - 1))}\u2026`;
+}
+
 // src/config/data-dir.ts
 init_home();
 import path21 from "node:path";
@@ -13297,6 +14270,9 @@ function createProgram() {
   registerDashboardCommands(program);
   registerSkillCommands(program);
   registerLibraryCommands(program);
+  registerAutomationCommands(program);
+  registerChatCommands(program);
+  registerRunsCommands(program);
   registerLazyWorktreeCommands(program);
   registerPluginCommands(program);
   registerLazyBenchmarkCommands(program);