@aiaiai-pt/martha-cli 0.70.0 → 0.71.0

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 All notable changes to `@aiaiai-pt/martha-cli`. Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). This project adheres to semver — `0.x` releases may include breaking changes between minor versions.
 
+## [0.71.0] — 2026-11-14
+
+0.70.0 is `chat --events-file` and `sessions get`, published from `main` (#2650). These changes were first numbered 0.70.0 and 0.70.1 on `dev` and never published under those numbers.
+
+### Added
+
+- `martha events emit <type> [--data <json> | --data-file <path>] [--subject <s>]` puts a real event on the tenant's event bus through `POST /api/events/emit`: every active trigger listening to that type starts. The type must be registered for the tenant; an agent key goes through the agent rules. To check a trigger against a payload without starting anything, keep using `martha triggers test`.
+- `martha events types` lists the event types registered for the tenant, and `martha events list [--type <pattern>] [--since <age>] [--limit <n>]` shows the latest events on the bus.
+- `martha triggers get` shows whether the trigger is working: when it last ran and how often, the most recent failed firing with its reason, what its schedule or missing-event watcher is doing, and a warning when its target cannot be resolved. `martha triggers list` shows `failing` in the STATUS column. Before, this was only in `--json`, and the hint `martha events emit` prints pointed at text that was not there.
+
+### Fixed
+
+- The `martha-cli` skill has documented `martha events list`, `events types` and `events emit --type` since an early spec; none of them existed. They do now, with that interface (`--type` is accepted on `emit` as well as the positional type).
+
 ## [0.70.0] — 2026-11-14
 
 ### Added

package/dist/index.js

@@ -11244,7 +11244,7 @@ init_config();
 init_errors();
 
 // src/version.ts
-var CLI_VERSION = "0.70.0";
+var CLI_VERSION = "0.71.0";
 
 // src/commands/sessions.ts
 init_errors();
@@ -18076,6 +18076,38 @@ function triggerKind(item) {
 function scheduleSummary(sched) {
   return String(sched.cron ?? sched.interval ?? sched.spec ?? "schedule");
 }
+function isFailing(t) {
+  const failedAt = Date.parse(String(t.last_error_at ?? ""));
+  if (!Number.isFinite(failedAt))
+    return false;
+  const ranAt = Date.parse(String(t.last_fired_at ?? ""));
+  return !Number.isFinite(ranAt) || failedAt > ranAt;
+}
+var plural = (count, word) => `${count} ${word}${count === 1 ? "" : "s"}`;
+function triggerHealthLines(t) {
+  const lines = [];
+  const schedule = t.schedule;
+  if (schedule?.status) {
+    const next = schedule.next_run_at ? `, next run ${schedule.next_run_at}` : "";
+    lines.push(`State:       ${schedule.status}${next}`);
+  }
+  const watcher = t.deadman;
+  if (watcher?.status) {
+    const seen = watcher.last_seen_at ? `, last event seen ${watcher.last_seen_at}` : "";
+    lines.push(`Watcher:     ${watcher.status}${seen}`);
+  }
+  if (t.fire_count !== undefined || t.last_fired_at !== undefined) {
+    const runs = Number(t.fire_count ?? 0);
+    lines.push(t.last_fired_at ? `Last ran:    ${t.last_fired_at} (${plural(runs, "run")})` : "Last ran:    never");
+  }
+  if (isFailing(t)) {
+    lines.push(`Failing:     ${t.last_error_at}: ${t.last_error ?? "unknown error"} ` + `(${plural(Number(t.failure_count ?? 0), "failed attempt")})`);
+  }
+  if (t.target_exists === false && t.target_warning) {
+    lines.push(`Warning:     ${t.target_warning}`);
+  }
+  return lines;
+}
 var triggersConfig = {
   typeName: "trigger",
   typeNamePlural: "triggers",
@@ -18101,7 +18133,7 @@ var triggersConfig = {
     { header: "TARGET", accessor: (item) => String(item.target_name ?? "-") },
     {
       header: "STATUS",
-      accessor: (item) => item.is_active !== false ? "active" : "inactive"
+      accessor: (item) => item.is_active === false ? "inactive" : isFailing(item) ? "failing" : "active"
     }
   ],
   renderDetail: (t) => {
@@ -18124,6 +18156,10 @@ var triggersConfig = {
     if (deadman)
       console.log(`  Deadman:     ${JSON.stringify(deadman)}`);
     console.log(`  Target:      ${t.target_type ?? "workflow"} → ${t.target_name ?? "-"}`);
+    for (const line of triggerHealthLines(t)) {
+      const colour = line.startsWith("Failing") ? source_default.red : line.startsWith("Warning") ? source_default.yellow : (text) => text;
+      console.log(`  ${colour(line)}`);
+    }
     const mapping = t.input_mapping;
     if (mapping && Object.keys(mapping).length) {
       console.log(`
@@ -18221,6 +18257,142 @@ var triggersConfig = {
   }
 };
 
+// src/commands/events.ts
+import { readFileSync as readFileSync2 } from "node:fs";
+init_errors();
+function context(program) {
+  const ctx = createContext({
+    profileOverride: program.opts().profile,
+    verbose: program.opts().verbose
+  });
+  if (program.opts().apiUrl) {
+    ctx.profile.api_url = program.opts().apiUrl;
+  }
+  return ctx;
+}
+function readData(opts) {
+  if (opts.data !== undefined && opts.dataFile !== undefined) {
+    throw new CLIError("Use --data or --data-file, not both", 4 /* Validation */);
+  }
+  let raw = opts.data;
+  if (opts.dataFile !== undefined) {
+    try {
+      raw = readFileSync2(opts.dataFile, "utf-8");
+    } catch {
+      throw new CLIError(`Cannot read --data-file ${opts.dataFile}`, 4 /* Validation */);
+    }
+  }
+  if (raw === undefined)
+    return {};
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    throw new CLIError("The event data must be valid JSON", 4 /* Validation */, `Example: martha events emit document.ingested --data '{"document_id":"123"}'`);
+  }
+  if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+    throw new CLIError("The event data must be a JSON object", 4 /* Validation */);
+  }
+  return parsed;
+}
+function ageToMs(age) {
+  const match = /^(\d+)([mhd])$/.exec(age.trim());
+  if (!match) {
+    throw new CLIError("--since takes a number and a unit: 30m, 2h, 1d", 4 /* Validation */);
+  }
+  const unit = { m: 60000, h: 3600000, d: 86400000 }[match[2]];
+  return Number(match[1]) * unit;
+}
+function typePattern(pattern) {
+  const escaped = pattern.replace(/[.+?^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*");
+  return new RegExp(`^${escaped}$`);
+}
+function table(rows, cols) {
+  const widths = cols.map((col) => Math.max(col.header.length, ...rows.map((row) => col.accessor(row).length)));
+  const header = cols.map((col, i) => col.header.padEnd(widths[i])).join("  ");
+  console.log(source_default.bold(header));
+  console.log(source_default.dim("-".repeat(header.length)));
+  for (const row of rows) {
+    console.log(cols.map((col, i) => col.accessor(row).padEnd(widths[i])).join("  ").trimEnd());
+  }
+}
+function registerEventCommands(program) {
+  const events = program.command("events").description("Emit an event onto the tenant's event bus, and list event types and recent events");
+  events.command("emit [type]").description("Emit a real event: every active trigger listening to this type starts").option("--type <type>", "The event type (same as the positional argument)").option("--data <json>", "Event payload as a JSON object (default: {})").option("--data-file <path>", "Read the event payload from a JSON file").option("--subject <subject>", "Optional CloudEvent subject").option("--source <source>", "Override the event source (ignored for agent keys)").option("--idempotency-key <key>", "A retried emit with the same key does not fire twice (agent keys)").action(async (positional, opts) => {
+    if (positional && opts.type && positional !== opts.type) {
+      throw new CLIError(`Two different event types given: '${positional}' and --type '${opts.type}'`, 4 /* Validation */);
+    }
+    const type = positional ?? opts.type;
+    if (!type) {
+      throw new CLIError("An event type is required", 4 /* Validation */, 'Example: martha events emit document.ingested --data \'{"document_id":"123"}\'. `martha events types` lists the registered types.');
+    }
+    const data = readData(opts);
+    const ctx = context(program);
+    const body = { type, data };
+    if (opts.subject)
+      body.subject = opts.subject;
+    if (opts.source)
+      body.source = opts.source;
+    if (opts.idempotencyKey)
+      body.idempotency_key = opts.idempotencyKey;
+    const res = await ctx.api.post("/api/events/emit", body);
+    if (program.opts().json) {
+      console.log(JSON.stringify({ event_id: res.event_id, type }, null, 2));
+      return;
+    }
+    console.log(source_default.green(`✓ Emitted ${type}`) + source_default.dim(` (event ${res.event_id})`));
+    console.log(source_default.dim("  Active triggers listening to this type start now. " + "`martha triggers get <name>` shows a trigger's last run or failure."));
+  });
+  events.command("types").description("List the event types registered for the tenant").action(async () => {
+    const ctx = context(program);
+    const types = await ctx.api.get("/api/admin/triggers/events/types");
+    if (program.opts().json) {
+      console.log(JSON.stringify(types, null, 2));
+      return;
+    }
+    if (types.length === 0) {
+      console.log(source_default.dim("No event types are registered for this tenant."));
+      return;
+    }
+    table([...types].sort((a, b) => a.type.localeCompare(b.type)), [
+      { header: "TYPE", accessor: (t) => t.type },
+      { header: "DESCRIPTION", accessor: (t) => t.description ?? "" }
+    ]);
+  });
+  events.command("list").description("Show the most recent events on the tenant's event bus, newest first").option("--limit <n>", "How many of the latest events to read (1-200)", "50").option("--type <pattern>", "Only this type; `*` matches any run of characters (task.*)").option("--since <age>", "Only events newer than this: 30m, 2h, 1d").action(async (opts) => {
+    const limit = Number(opts.limit);
+    if (!Number.isInteger(limit) || limit < 1 || limit > 200) {
+      throw new CLIError("--limit must be a whole number from 1 to 200", 4 /* Validation */);
+    }
+    const cutoff = opts.since === undefined ? null : Date.now() - ageToMs(opts.since);
+    const matchesType = opts.type === undefined ? null : typePattern(opts.type);
+    const ctx = context(program);
+    let recent = await ctx.api.get(`/api/admin/triggers/events/recent?limit=${limit}`);
+    if (matchesType)
+      recent = recent.filter((event) => matchesType.test(event.type ?? ""));
+    if (cutoff !== null) {
+      recent = recent.filter((event) => {
+        const at = Date.parse(event.time ?? "");
+        return Number.isFinite(at) && at >= cutoff;
+      });
+    }
+    if (program.opts().json) {
+      console.log(JSON.stringify(recent, null, 2));
+      return;
+    }
+    if (recent.length === 0) {
+      console.log(source_default.dim("No matching events among the latest " + limit + "."));
+      return;
+    }
+    table(recent, [
+      { header: "TIME", accessor: (e) => (e.time ?? "").slice(0, 19) },
+      { header: "TYPE", accessor: (e) => e.type ?? "" },
+      { header: "EVENT", accessor: (e) => e.id ?? "" },
+      { header: "SOURCE", accessor: (e) => e.source ?? "" }
+    ]);
+  });
+}
+
 // src/commands/documents.ts
 import fs11 from "node:fs";
 init_errors();
@@ -19405,7 +19577,7 @@ function registerAskCommands(program) {
 }
 
 // src/commands/tasks.ts
-import { readFileSync as readFileSync2 } from "node:fs";
+import { readFileSync as readFileSync3 } from "node:fs";
 init_errors();
 var truncate2 = (s, n) => s.length > n ? s.slice(0, n - 1) + "…" : s;
 var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
@@ -19900,7 +20072,7 @@ ${items.length} task(s) available`));
     let rawOutcome;
     if (opts.outcomeFile) {
       try {
-        rawOutcome = readFileSync2(opts.outcomeFile, "utf-8");
+        rawOutcome = readFileSync3(opts.outcomeFile, "utf-8");
       } catch {
         throw new CLIError(`--outcome-file could not be read: ${opts.outcomeFile}`, 4 /* Validation */);
       }
@@ -27063,7 +27235,7 @@ function registerPolicyCommands(program) {
 }
 
 // src/commands/agent-step.ts
-import { readFileSync as readFileSync3 } from "node:fs";
+import { readFileSync as readFileSync4 } from "node:fs";
 init_errors();
 var BASE = "/api/admin/agent-step/trust-roots";
 var FLEET_BASE = "/api/admin/agent-step/fleet";
@@ -27071,7 +27243,7 @@ function resolveKeyMaterial(value) {
   if (value.startsWith("@")) {
     const path = value.slice(1);
     try {
-      return readFileSync3(path, "utf8").trim();
+      return readFileSync4(path, "utf8").trim();
     } catch (e) {
       throw new CLIError(`Could not read public key file '${path}': ${e.message}`, 4 /* Validation */);
     }
@@ -28657,6 +28829,7 @@ registerDefinitionCommands(program2, workflowsConfig);
 registerDefinitionCommands(program2, agentsConfig);
 registerDefinitionCommands(program2, promptsConfig);
 registerDefinitionCommands(program2, triggersConfig);
+registerEventCommands(program2);
 registerDefinitionsApply(program2);
 registerDefinitionsExport(program2);
 registerDocumentCommands(program2);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiaiai-pt/martha-cli",
-  "version": "0.70.0",
+  "version": "0.71.0",
   "description": "Terminal-first client for the Martha AI platform",
   "homepage": "https://docs.martha.nomadriver.co",
   "repository": {

package/skills/martha-cli/SKILL.md

@@ -594,10 +594,11 @@ martha triggers update <name> -f trigger.yaml
 martha triggers delete <name> [--yes]
 martha triggers test <name> --event '{"type": "task.completed", "data": {...}}'   # Dry-run
 
-# Events (browse what's flowing)
-martha events list [--type task.*] [--since 1h] [--limit 50]
-martha events types                      # Available event types with sample payloads
-martha events emit --type custom.event --data '{"foo": "bar"}'   # Manual emit (admin only)
+# Events (browse what's flowing, and emit one)
+martha events list [--type task.*] [--since 1h] [--limit 50]   # Latest events on the tenant's bus (the API keeps the last 200 readable)
+martha events types                                             # Event types registered for the tenant
+martha events emit <type> --data '{"foo": "bar"}'               # REAL event: every active trigger on <type> starts
+martha events emit <type> --data-file payload.json [--subject <s>]
 
 # Webhooks
 martha webhooks list