wispy-cli 2.7.10 → 2.7.12

package/lib/jsonl-emitter.mjs

@@ -0,0 +1,101 @@
+/**
+ * lib/jsonl-emitter.mjs — Structured JSONL event emitter for CI/pipeline integration
+ *
+ * When --json flag is used, all events are emitted as newline-delimited JSON
+ * to stdout. Event types: start, user_message, assistant_message,
+ * tool_call, tool_result, error, done.
+ */
+
+export class JsonlEmitter {
+  /**
+   * Emit a raw event object as a JSON line to stdout.
+   * @param {object} event
+   */
+  emit(event) {
+    process.stdout.write(JSON.stringify(event) + "\n");
+  }
+
+  /**
+   * Emit a "start" event with session metadata.
+   * @param {{ model?: string, session_id?: string, [key: string]: any }} meta
+   */
+  start(meta) {
+    this.emit({ type: "start", ...meta, timestamp: new Date().toISOString() });
+  }
+
+  /**
+   * Emit a "tool_call" event.
+   * @param {string} name - Tool name
+   * @param {object} args - Tool arguments
+   */
+  toolCall(name, args) {
+    this.emit({ type: "tool_call", name, args, timestamp: new Date().toISOString() });
+  }
+
+  /**
+   * Emit a "tool_result" event.
+   * @param {string} name - Tool name
+   * @param {string|object} result - Tool result
+   * @param {number} durationMs - Duration in milliseconds
+   */
+  toolResult(name, result, durationMs) {
+    this.emit({
+      type: "tool_result",
+      name,
+      result: typeof result === "string" ? result.slice(0, 1000) : result,
+      duration_ms: durationMs,
+    });
+  }
+
+  /**
+   * Emit a user_message or assistant_message event.
+   * @param {"user"|"assistant"} role
+   * @param {string} content
+   */
+  message(role, content) {
+    this.emit({ type: `${role}_message`, content, timestamp: new Date().toISOString() });
+  }
+
+  /**
+   * Emit an "error" event.
+   * @param {Error|string} err
+   */
+  error(err) {
+    this.emit({
+      type: "error",
+      message: err?.message ?? String(err),
+      timestamp: new Date().toISOString(),
+    });
+  }
+
+  /**
+   * Emit a "done" event with final stats.
+   * @param {{ tokens?: { input: number, output: number }, duration_ms?: number, [key: string]: any }} stats
+   */
+  done(stats) {
+    this.emit({ type: "done", ...stats, timestamp: new Date().toISOString() });
+  }
+}
+
+/**
+ * A no-op emitter used when --json flag is not set.
+ * All methods are silent.
+ */
+export class NullEmitter {
+  emit() {}
+  start() {}
+  toolCall() {}
+  toolResult() {}
+  message() {}
+  error() {}
+  done() {}
+}
+
+/**
+ * Create the appropriate emitter based on whether JSON mode is active.
+ * @param {boolean} jsonMode
+ * @returns {JsonlEmitter|NullEmitter}
+ */
+export function createEmitter(jsonMode) {
+  return jsonMode ? new JsonlEmitter() : new NullEmitter();
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wispy-cli",
-  "version": "2.7.10",
+  "version": "2.7.12",
   "description": "🌿 Wispy — AI workspace assistant with trustworthy execution (harness, receipts, approvals, diffs)",
   "license": "MIT",
   "author": "Minseo & Poropo",