@vm0/cli 9.95.1 → 9.96.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vm0/cli",
-  "version": "9.95.1",
+  "version": "9.96.0",
   "description": "CLI application",
   "repository": {
     "type": "git",

package/zero.js

@@ -2,6 +2,7 @@
 import {
   ApiRequestError,
   CONNECTOR_TYPES,
+  ClaudeEventParser,
   EventRenderer,
   MODEL_PROVIDER_TYPES,
   allowsCustomModel,
@@ -70,6 +71,7 @@ import {
   listSkills,
   listZeroAgents,
   listZeroConnectors,
+  listZeroLogs,
   listZeroOrgModelProviders,
   listZeroOrgSecrets,
   listZeroOrgVariables,
@@ -77,7 +79,9 @@ import {
   listZeroSchedules,
   listZeroSecrets,
   listZeroVariables,
+  paginate,
   parseEvent,
+  parseTime,
   postAskUserQuestion,
   promptConfirm,
   promptPassword,
@@ -88,6 +92,7 @@ import {
   resolveCompose,
   resolveZeroScheduleByAgent,
   saveConfig,
+  searchZeroLogs,
   sendSlackMessage,
   setZeroOrgModelProviderDefault,
   setZeroOrgSecret,
@@ -103,10 +108,10 @@ import {
   updateZeroUserPreferences,
   upsertZeroOrgModelProvider,
   withErrorHandler
-} from "./chunk-WN2AD3KW.js";
+} from "./chunk-T53WM66Z.js";
 
 // src/zero.ts
-import { Command as Command70 } from "commander";
+import { Command as Command73 } from "commander";
 
 // src/commands/zero/org/index.ts
 import { Command as Command23 } from "commander";
@@ -4112,6 +4117,323 @@ Skill Binding:
   Replace all skills:      zero agent edit <id> --skills a,b,c`
 );
 
+// src/commands/zero/logs/index.ts
+import { Command as Command72 } from "commander";
+import chalk56 from "chalk";
+
+// src/commands/zero/logs/list.ts
+import { Command as Command70 } from "commander";
+import chalk54 from "chalk";
+function formatStatus(status) {
+  switch (status) {
+    case "completed":
+      return chalk54.green(status);
+    case "failed":
+    case "timeout":
+      return chalk54.red(status);
+    case "running":
+    case "pending":
+    case "queued":
+      return chalk54.yellow(status);
+    case "cancelled":
+      return chalk54.dim(status);
+    default:
+      return status;
+  }
+}
+function formatTime(iso) {
+  return new Date(iso).toISOString().replace(/\.\d{3}Z$/, "Z");
+}
+var listCommand11 = new Command70().name("list").alias("ls").description("List agent run logs").option("--agent <name>", "Filter by agent name").option(
+  "--status <status>",
+  "Filter by status (queued|pending|running|completed|failed|timeout|cancelled)"
+).option("--limit <n>", "Maximum number of results (default: 20)").addHelpText(
+  "after",
+  `
+Examples:
+  zero logs list
+  zero logs list --agent my-agent
+  zero logs list --status completed --limit 10`
+).action(
+  withErrorHandler(
+    async (options) => {
+      const limit = options.limit ? parseInt(options.limit, 10) : void 0;
+      const result = await listZeroLogs({
+        agent: options.agent,
+        status: options.status,
+        limit
+      });
+      if (result.data.length === 0) {
+        console.log(chalk54.dim("No logs found"));
+        return;
+      }
+      const nameCol = Math.max(
+        5,
+        ...result.data.map((r) => {
+          return (r.displayName || r.agentId || "-").length;
+        })
+      );
+      const statusCol = Math.max(
+        6,
+        ...result.data.map((r) => {
+          return r.status.length;
+        })
+      );
+      const header = [
+        "RUN ID".padEnd(10),
+        "AGENT".padEnd(nameCol),
+        "STATUS".padEnd(statusCol),
+        "CREATED"
+      ].join("  ");
+      console.log(chalk54.dim(header));
+      for (const entry of result.data) {
+        const shortId = entry.id.slice(0, 8);
+        const name = entry.displayName || entry.agentId || "-";
+        const row = [
+          shortId.padEnd(10),
+          name.padEnd(nameCol),
+          formatStatus(entry.status).padEnd(statusCol),
+          formatTime(entry.createdAt)
+        ].join("  ");
+        console.log(row);
+      }
+      if (result.pagination.hasMore) {
+        console.log();
+        console.log(
+          chalk54.dim(
+            `  Showing ${result.data.length} of more results. Use --limit to adjust.`
+          )
+        );
+      }
+    }
+  )
+);
+
+// src/commands/zero/logs/search.ts
+import { Command as Command71 } from "commander";
+import chalk55 from "chalk";
+var SEVEN_DAYS_MS = 7 * 24 * 60 * 60 * 1e3;
+function renderEvent(event, renderer) {
+  const eventData = event.eventData;
+  const parsed = ClaudeEventParser.parse(eventData);
+  if (parsed) {
+    parsed.timestamp = new Date(event.createdAt);
+    renderer.render(parsed);
+  }
+}
+function formatRunHeader(runId, agentName, timestamp) {
+  const shortId = runId.slice(0, 8);
+  const time = new Date(timestamp).toISOString().replace(/\.\d{3}Z$/, "Z");
+  return `\u2500\u2500 Run ${shortId} (${agentName}, ${time}) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500`;
+}
+function parseContextOptions(options) {
+  const contextN = options.context ? parseInt(options.context, 10) : 0;
+  const before = options.beforeContext ? parseInt(options.beforeContext, 10) : contextN;
+  const after = options.afterContext ? parseInt(options.afterContext, 10) : contextN;
+  if (isNaN(before) || before < 0 || before > 10) {
+    throw new Error("--before-context must be between 0 and 10");
+  }
+  if (isNaN(after) || after < 0 || after > 10) {
+    throw new Error("--after-context must be between 0 and 10");
+  }
+  return { before, after };
+}
+function parseLimit(value) {
+  if (!value) return void 0;
+  const limit = parseInt(value, 10);
+  if (isNaN(limit) || limit < 1 || limit > 50) {
+    throw new Error("--limit must be between 1 and 50");
+  }
+  return limit;
+}
+function renderResults(response) {
+  const grouped = /* @__PURE__ */ new Map();
+  for (const result of response.results) {
+    const existing = grouped.get(result.runId);
+    if (existing) {
+      existing.results.push(result);
+    } else {
+      grouped.set(result.runId, {
+        agentName: result.agentName,
+        results: [result]
+      });
+    }
+  }
+  let isFirstGroup = true;
+  for (const [runId, group] of grouped) {
+    if (!isFirstGroup) {
+      console.log();
+    }
+    isFirstGroup = false;
+    const firstTimestamp = group.results[0].matchedEvent.createdAt;
+    console.log(
+      chalk55.bold(formatRunHeader(runId, group.agentName, firstTimestamp))
+    );
+    for (const result of group.results) {
+      const renderer = new EventRenderer({
+        showTimestamp: true,
+        verbose: false,
+        buffered: false
+      });
+      for (const event of result.contextBefore) {
+        renderEvent(event, renderer);
+      }
+      renderEvent(result.matchedEvent, renderer);
+      for (const event of result.contextAfter) {
+        renderEvent(event, renderer);
+      }
+    }
+  }
+  if (response.hasMore) {
+    console.log();
+    console.log(
+      chalk55.dim(
+        `  Showing first ${response.results.length} matches. Use --limit to see more.`
+      )
+    );
+  }
+}
+var searchCommand = new Command71().name("search").description("Search agent events across runs").argument("<keyword>", "Search keyword").option("-A, --after-context <n>", "Show n events after each match").option("-B, --before-context <n>", "Show n events before each match").option("-C, --context <n>", "Show n events before and after each match").option("--agent <name>", "Filter by agent name").option("--run <id>", "Filter by specific run ID").option("--since <time>", "Search logs since (default: 7d)").option("--limit <n>", "Maximum number of matches (default: 20)").addHelpText(
+  "after",
+  `
+Examples:
+  zero logs search "error"
+  zero logs search "timeout" --agent my-agent -C 2
+  zero logs search "failed" --since 30d --limit 50`
+).action(
+  withErrorHandler(async (keyword, options) => {
+    const { before, after } = parseContextOptions(options);
+    const since = options.since ? parseTime(options.since) : Date.now() - SEVEN_DAYS_MS;
+    const limit = parseLimit(options.limit);
+    const response = await searchZeroLogs({
+      keyword,
+      agent: options.agent,
+      runId: options.run,
+      since,
+      limit,
+      before,
+      after
+    });
+    if (response.results.length === 0) {
+      console.log(chalk55.dim("No matches found"));
+      console.log(
+        chalk55.dim(
+          "  Try a broader search with --since 30d or a different keyword"
+        )
+      );
+      return;
+    }
+    renderResults(response);
+  })
+);
+
+// src/commands/zero/logs/index.ts
+var PAGE_LIMIT = 100;
+function renderAgentEvent(event, renderer) {
+  const eventData = event.eventData;
+  const parsed = ClaudeEventParser.parse(eventData);
+  if (parsed) {
+    parsed.timestamp = new Date(event.createdAt);
+    renderer.render(parsed);
+  }
+}
+async function showAgentEvents(runId, options) {
+  const firstResponse = await getZeroRunAgentEvents(runId, {
+    since: options.since,
+    limit: PAGE_LIMIT,
+    order: options.order
+  });
+  if (firstResponse.events.length === 0) {
+    console.log(chalk56.yellow("No agent events found for this run"));
+    return;
+  }
+  let allEvents;
+  if (!firstResponse.hasMore || options.targetCount !== "all" && firstResponse.events.length >= options.targetCount) {
+    allEvents = options.targetCount === "all" ? firstResponse.events : firstResponse.events.slice(0, options.targetCount);
+  } else {
+    const lastEvent = firstResponse.events[firstResponse.events.length - 1];
+    const firstPageTimestamp = lastEvent ? new Date(lastEvent.createdAt).getTime() : void 0;
+    const remainingEvents = await paginate({
+      fetchPage: async (since) => {
+        const response = await getZeroRunAgentEvents(runId, {
+          since,
+          limit: PAGE_LIMIT,
+          order: options.order
+        });
+        return { items: response.events, hasMore: response.hasMore };
+      },
+      getTimestamp: (event) => {
+        return new Date(event.createdAt).getTime();
+      },
+      targetCount: options.targetCount === "all" ? "all" : options.targetCount - firstResponse.events.length,
+      initialSince: firstPageTimestamp
+    });
+    allEvents = [...firstResponse.events, ...remainingEvents];
+    if (options.targetCount !== "all" && allEvents.length > options.targetCount) {
+      allEvents = allEvents.slice(0, options.targetCount);
+    }
+  }
+  const events = options.order === "desc" ? [...allEvents].reverse() : allEvents;
+  const renderer = new EventRenderer({
+    showTimestamp: true,
+    verbose: true
+  });
+  for (const event of events) {
+    renderAgentEvent(event, renderer);
+  }
+}
+var zeroLogsCommand = new Command72().name("logs").description("View and search agent run logs").argument("[runId]", "Run ID to view agent events for").addCommand(listCommand11).addCommand(searchCommand).option(
+  "--since <time>",
+  "Show logs since timestamp (e.g., 5m, 2h, 1d, 2024-01-15T10:30:00Z)"
+).option("--tail <n>", "Show last N entries (default: 5)").option("--head <n>", "Show first N entries").option("--all", "Fetch all log entries").addHelpText(
+  "after",
+  `
+Examples:
+  zero logs list
+  zero logs <runId>
+  zero logs <runId> --tail 10
+  zero logs <runId> --all
+  zero logs search "error"`
+).action(
+  withErrorHandler(
+    async (runId, options) => {
+      if (!runId) {
+        zeroLogsCommand.help();
+        return;
+      }
+      const countModes = [
+        options.tail !== void 0,
+        options.head !== void 0,
+        options.all === true
+      ].filter(Boolean).length;
+      if (countModes > 1) {
+        throw new Error(
+          "Options --tail, --head, and --all are mutually exclusive"
+        );
+      }
+      let since;
+      if (options.since) {
+        since = parseTime(options.since);
+      }
+      const isAll = options.all === true;
+      const isHead = options.head !== void 0;
+      const isTail = options.tail !== void 0;
+      let targetCount;
+      if (isAll) {
+        targetCount = "all";
+      } else if (isHead) {
+        targetCount = Math.max(1, parseInt(options.head, 10));
+      } else if (isTail) {
+        targetCount = Math.max(1, parseInt(options.tail, 10));
+      } else {
+        targetCount = 5;
+      }
+      const order = isHead ? "asc" : "desc";
+      await showAgentEvents(runId, { since, targetCount, order });
+    }
+  )
+);
+
 // src/zero.ts
 var COMMAND_CAPABILITY_MAP = {
   agent: "agent:read",
@@ -4119,6 +4441,7 @@ var COMMAND_CAPABILITY_MAP = {
   run: "agent-run:write",
   schedule: "schedule:read",
   doctor: null,
+  logs: "agent-run:read",
   slack: "slack:write",
   whoami: null,
   "ask-user": null
@@ -4134,6 +4457,7 @@ var DEFAULT_COMMANDS = [
   zeroSecretCommand,
   zeroSlackCommand,
   zeroVariableCommand,
+  zeroLogsCommand,
   zeroWhoamiCommand,
   zeroAskUserCommand,
   zeroSkillCommand
@@ -4152,10 +4476,10 @@ function registerZeroCommands(prog, commands) {
     prog.addCommand(cmd, hidden ? { hidden: true } : {});
   }
 }
-var program = new Command70();
+var program = new Command73();
 program.name("zero").description(
   "Zero CLI \u2014 interact with the zero platform from inside the sandbox"
-).version("9.95.1").addHelpText(
+).version("9.96.0").addHelpText(
   "after",
   `
 Examples: