agent-nuvira 3.3.3 → 3.3.4

package/dist/observability/debug-log.js

@@ -0,0 +1,500 @@
+/**
+ * WS2 (#24) — the session debug log you attach to a bug report.
+ *
+ * WHY THIS EXISTS, and what it is NOT. This repository's bug reports keep
+ * arriving as prose: "the dashboard did not answer", "the gateway sent the
+ * wrong thing", "it worked yesterday". Every one of them is then re-litigated
+ * by reading code, because the failing run left nothing behind that records
+ * WHICH BACKEND SERVED IT. The trace store (`learning/reasoning-trace.ts`) is
+ * the audit of what the MODEL was asked; the DAG bridge and the gateway log are
+ * per-surface records. None of them is the thing a user can attach to a bug
+ * report, and none of them is reachable the same way from all five surfaces.
+ *
+ * So a session debug log is deliberately boring: a plain-text file, ordered,
+ * with a header that names the surface and THE BACKEND — provider, model,
+ * transport, engine — before a single line of detail. If a bug report can only
+ * carry one thing, that header is the thing that makes it actionable.
+ *
+ * FOUR RULES, each closing a way a debug log becomes worse than none:
+ *
+ *  1. OPT-IN, AND CHEAP WHEN OFF. `NUVIRA_DEBUG_LOG=1` turns it on; with it off
+ *     `sessionDebugLog()` returns `null` and every call site's `?.` makes the
+ *     cost one boolean check. A logging path that is on by default is a disk
+ *     leak and a privacy hazard wearing a helpful face.
+ *
+ *  2. REDACTED BY CONSTRUCTION. A log we ask a user to attach to a bug report
+ *     is a log that will be pasted into an issue tracker. Every event line is
+ *     scrubbed with the SAME `scrubSecrets` the gateway log uses (reused, not
+ *     re-implemented: two regex lists drift, and the one that drifts is the one
+ *     that leaks). The header carries the backend and versions — never a key.
+ *
+ *  3. BOUNDED. Events are capped, each line is truncated to a preview, and the
+ *     file is capped by bytes. An instrument must never be the reason a run
+ *     dies, and a nightly-failing turn must not fill a disk.
+ *
+ *  4. WRITTEN ONCE, AT CLOSE. The header has to name the backend that served
+ *     the turn, and the backend is only known at the end (the loop may fail
+ *     over between providers). So events buffer in memory and `write()`
+ *     produces the whole file — header first — at the end of the turn. That
+ *     also means a crashed process leaves NO half-written log, which is the
+ *     honest outcome: a log whose header lies about the backend is worse than
+ *     no log.
+ *
+ * The five surfaces each open one at their own turn seam (`cli/chat.ts`,
+ * `cli/loop-executor.ts`, `tools/child-agent-runtime.ts`, with the dashboard
+ * console and the gateway passing their identity down to the shared chat
+ * engine), and the parity harness reads the file back and asserts every
+ * surface's header names the SAME backend — the capability
+ * `debug-log@<surface>` is proved against.
+ *
+ * A log that a surface wrote into a directory the user has to find is only half
+ * the artifact. So a surface that HAS a conversation identity records it
+ * (`session`), which turns the file from readable into FINDABLE: the dashboard
+ * server can answer "the bundle for this chat" by looking up the logs whose
+ * header names that conversation, instead of guessing from timestamps and
+ * handing over someone else's. A surface with no such identity (the CLI's
+ * one-shot path) records nothing rather than inventing an id.
+ */
+import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { resolveNuviraDataPath } from '../config/paths.js';
+import { scrubSecrets } from '../gateway/gateway-log.js';
+/** The env var that turns session debug logging on (`NUVIRA_DEBUG_LOG=1`). */
+export const DEBUG_LOG_ENV = 'DEBUG_LOG';
+/** Optional directory override for the log files (`NUVIRA_DEBUG_LOG_DIR`). */
+export const DEBUG_LOG_DIR_ENV = 'DEBUG_LOG_DIR';
+/** Hard cap on the written file. Bounded on purpose — see rule 3 above. */
+export const DEBUG_LOG_MAX_BYTES = 512 * 1024;
+/** Per-line detail preview cap. Never the whole payload. */
+export const DEBUG_LOG_PREVIEW_CHARS = 300;
+/** Event cap. Beyond it the OLDEST events are dropped, and the count is stated. */
+export const DEBUG_LOG_MAX_EVENTS = 2_000;
+/** Cap on a session id as a FILENAME component, so a long id cannot fail a write. */
+export const DEBUG_LOG_SESSION_CHARS = 48;
+/** Omit a value from the header rather than writing `undefined`/`null` as a lie. */
+function orNull(value) {
+    return typeof value === 'string' && value.trim() ? value.trim() : null;
+}
+/**
+ * Read the running version from the repo's `package.json`.
+ *
+ * Best-effort and cached: a debug log must never break a turn over a missing
+ * file (the published `dist/` layout resolves `../../package.json` the same way
+ * `cli-program.ts` already does), and a wrong-but-absent version is honest
+ * where a thrown error is not.
+ */
+let cachedVersion;
+function agentVersion() {
+    if (cachedVersion !== undefined)
+        return cachedVersion;
+    try {
+        const pkg = JSON.parse(readFileSync(new URL('../../package.json', import.meta.url), 'utf-8'));
+        cachedVersion = orNull(pkg.version);
+    }
+    catch {
+        cachedVersion = null;
+    }
+    return cachedVersion;
+}
+/**
+ * Is session debug logging on?
+ *
+ * `NUVIRA_DEBUG_LOG` (or legacy `BUFF_DEBUG_LOG`) set to anything other than
+ * `0` / `false` / `off` enables it. Deliberately not "truthy string" only: a
+ * user who writes `NUVIRA_DEBUG_LOG=false` in an `.env` means off.
+ */
+export function debugLoggingEnabled(env = process.env) {
+    const raw = env.NUVIRA_DEBUG_LOG ?? env.BUFF_DEBUG_LOG;
+    if (raw === undefined)
+        return false;
+    const value = raw.trim().toLowerCase();
+    return value !== '' && value !== '0' && value !== 'false' && value !== 'off' && value !== 'no';
+}
+/**
+ * Where the log files live.
+ *
+ * `NUVIRA_DEBUG_LOG_DIR` wins when set; otherwise `<config dir>/debug-logs`
+ * through `resolveNuviraDataPath`, so an isolated profile (tests, CI, the
+ * parity harness) can never write into the developer's real `~/.nuvira`.
+ */
+export function debugLogDir(env = process.env) {
+    // Dual-read (NUVIRA_ then legacy BUFF_), matching every other path resolver.
+    // Dual-read (NUVIRA_ then legacy BUFF_), matching every other path resolver. A
+    // BLANK value counts as unset rather than as `''` — `||` not `??` — so an
+    // empty `NUVIRA_DEBUG_LOG_DIR` still lets a legacy override through.
+    const override = env[`NUVIRA_${DEBUG_LOG_DIR_ENV}`]?.trim() || env[`BUFF_${DEBUG_LOG_DIR_ENV}`]?.trim();
+    if (override)
+        return override;
+    // `<config dir>/debug-logs` — so an isolated profile never writes into the
+    // developer's real `~/.nuvira`.
+    return resolveNuviraDataPath('debug-logs');
+}
+/** A filename-safe surface label (`cli-chat` → `cli-chat`; odd input → dashes). */
+function safeLabel(value) {
+    return value.trim().toLowerCase().replace(/[^a-z0-9._-]+/g, '-').replace(/^-+|-+$/g, '') || 'unknown';
+}
+/**
+ * One session's debug log, buffered and written once.
+ *
+ * Deliberately a class rather than a bag of functions: the buffered state IS
+ * the object, and a surface that opens one and forgets to write it produces no
+ * file at all — which the parity harness reads as `written: false` rather than
+ * as agreement.
+ */
+export class SessionDebugLog {
+    id;
+    startedAt;
+    surface;
+    goal;
+    backend;
+    extra = [];
+    entries = [];
+    dropped = 0;
+    truncatedLines = 0;
+    dir;
+    now;
+    /** The conversation this turn belongs to, or null (see `DebugLogHeader.session`). */
+    session;
+    writtenPath = null;
+    constructor(opts) {
+        this.surface = safeLabel(opts.surface);
+        this.goal = orNull(opts.goal) ? scrubSecrets(cap(String(opts.goal), DEBUG_LOG_PREVIEW_CHARS)) : null;
+        // A session id is a FILENAME component, so it is sanitised and length-capped
+        // here rather than trusted: an id long enough to exceed the filesystem's
+        // name limit would otherwise turn every turn into a failed write.
+        this.session = orNull(opts.session) ? cap(safeLabel(String(opts.session)), DEBUG_LOG_SESSION_CHARS) : null;
+        this.backend = { ...(opts.backend ?? {}) };
+        this.now = opts.now ?? (() => Date.now());
+        this.startedAt = this.now();
+        this.dir = opts.dir === undefined ? debugLogDir() : opts.dir;
+        this.id = `${this.surface}-${this.session ? `${this.session}-` : ''}${this.startedAt}`;
+    }
+    /** The backend that served the turn. Set as it is learned; last call wins. */
+    backendOf(backend) {
+        this.backend = { ...this.backend, ...backend };
+        return this;
+    }
+    /**
+     * Preview one detail value: flattened, cut to the cap, then redacted.
+     *
+     * The cut is counted BEFORE the scrub (the scrub only shortens), so the
+     * "truncated" line in the file reports how much was actually lost.
+     */
+    detailText(value) {
+        const flat = previewOf(value);
+        const capped = cap(flat, DEBUG_LOG_PREVIEW_CHARS);
+        if (capped.length < flat.length)
+            this.truncatedLines += 1;
+        return scrubSecrets(capped);
+    }
+    /** One ordered event. `detail` is previewed and redacted. */
+    event(name, detail) {
+        const rendered = detail === undefined ? undefined : this.detailText(detail);
+        this.entries.push({
+            at: this.now(),
+            name: scrubSecrets(name),
+            ...(rendered ? { detail: rendered } : {}),
+        });
+        if (this.entries.length > DEBUG_LOG_MAX_EVENTS) {
+            // Drop the OLDEST: the most recent events are the ones a failure report
+            // reads, exactly like the trace store's tail-keeping caps.
+            this.entries.shift();
+            this.dropped += 1;
+        }
+        return this;
+    }
+    /** A non-secret header field (a version, a channel, a bound). */
+    detail(key, value) {
+        if (value === undefined || value === null || value === '')
+            return this;
+        this.extra.push([scrubSecrets(key), this.detailText(value)]);
+        return this;
+    }
+    /** The attachable text: header first, then the events in order. */
+    render() {
+        const b = this.backend;
+        const lines = [
+            '# nuvira session debug log — safe to attach to a bug report',
+            '# credentials are redacted; memory and prompts are previews, not payloads',
+            `# surface: ${this.surface}`,
+            // Written only when the surface HAS a conversation identity: an absent key
+            // reads as "not reported", where `unknown` would read as the id "unknown".
+            ...(this.session ? [`# session: ${this.session}`] : []),
+            `# engine: ${orNull(b.engine) ?? 'unknown'}`,
+            `# backend.provider: ${orNull(b.provider) ?? 'unknown'}`,
+            `# backend.model: ${orNull(b.model) ?? 'unknown'}`,
+            `# backend.transport: ${orNull(b.transport) ?? 'unknown'}`,
+            `# version: ${agentVersion() ?? 'unknown'}`,
+            `# started: ${new Date(this.startedAt).toISOString()}`,
+            `# pid: ${process.pid}`,
+            `# platform: ${process.platform} ${process.arch} · node ${process.version}`,
+            `# events: ${this.entries.length}${this.dropped > 0 ? ` (+${this.dropped} older dropped)` : ''}`,
+            ...(this.truncatedLines > 0 ? [`# truncated: ${this.truncatedLines} event(s) were longer than ${DEBUG_LOG_PREVIEW_CHARS} chars`] : []),
+            ...(this.goal ? [`# goal: ${JSON.stringify(this.goal)}`] : []),
+            ...this.extra.map(([key, value]) => `# ${key}: ${value}`),
+            '# ' + '-'.repeat(58),
+        ];
+        for (const entry of this.entries) {
+            lines.push(`${new Date(entry.at).toISOString()} ${entry.name}${entry.detail ? ` ${entry.detail}` : ''}`);
+        }
+        return `${lines.join('\n')}\n`;
+    }
+    /**
+     * Write the file. Returns the path, or null when logging is disabled, no
+     * directory was resolved, or the write failed — every one of which is a
+     * normal outcome a caller must not have to handle.
+     */
+    write() {
+        if (!this.dir)
+            return null;
+        try {
+            if (!existsSync(this.dir))
+                mkdirSync(this.dir, { recursive: true });
+            const path = join(this.dir, `${this.id}.log`);
+            writeFileSync(path, cap(this.render(), DEBUG_LOG_MAX_BYTES), 'utf-8');
+            this.writtenPath = path;
+            return path;
+        }
+        catch {
+            // Best-effort: a debug log must never break the run it observes.
+            return null;
+        }
+    }
+    /** The path after a successful `write()` (null before it / on failure). */
+    path() {
+        return this.writtenPath;
+    }
+}
+/**
+ * Open a session debug log, or `null` when logging is off (or in a unit test
+ * that passed no directory). Callers use `?.` throughout, so the off path costs
+ * one boolean.
+ */
+export function sessionDebugLog(opts) {
+    const env = opts.env ?? process.env;
+    if (!debugLoggingEnabled(env))
+        return null;
+    return new SessionDebugLog({
+        surface: opts.surface,
+        ...(opts.goal !== undefined ? { goal: opts.goal } : {}),
+        ...(opts.session !== undefined ? { session: opts.session } : {}),
+        ...(opts.backend !== undefined ? { backend: opts.backend } : {}),
+        dir: opts.dir === undefined ? debugLogDir(env) : opts.dir,
+        ...(opts.now ? { now: opts.now } : {}),
+    });
+}
+/** Cut a string to `max` chars, marking the cut so a reader knows it happened. */
+function cap(value, max) {
+    return value.length <= max ? value : `${value.slice(0, Math.max(0, max - 1))}…`;
+}
+/** Render any detail value to one flat, bounded line. */
+function previewOf(value) {
+    if (typeof value === 'string')
+        return value.replace(/\s+/g, ' ').trim();
+    if (typeof value === 'number' || typeof value === 'boolean' || value === null)
+        return String(value);
+    if (Array.isArray(value))
+        return value.map((v) => previewOf(v)).join(', ');
+    try {
+        return JSON.stringify(value, replacerForPreview) ?? String(value);
+    }
+    catch {
+        return String(value);
+    }
+}
+/** Bounded JSON: long strings are cut before serialising, so one huge arg cannot blow the line. */
+function replacerForPreview(_key, value) {
+    if (typeof value === 'string')
+        return value.length > 120 ? `${value.slice(0, 119)}…` : value;
+    return value;
+}
+/**
+ * Parse a rendered log's header.
+ *
+ * Reads the leading `# key: value` comment block only, and returns null when
+ * `surface` is absent — the one field every header must have. Unknown keys are
+ * ignored rather than rejected, so an older reader can still open a newer log.
+ */
+export function parseDebugLogHeader(text) {
+    const header = {
+        surface: null,
+        session: null,
+        engine: null,
+        provider: null,
+        model: null,
+        transport: null,
+        version: null,
+        startedAt: null,
+        pid: null,
+        platform: null,
+    };
+    for (const line of text.split('\n')) {
+        if (!line.startsWith('#'))
+            break;
+        const match = /^#\s+(?:backend\.)?([a-z_]+):\s*(.*)$/i.exec(line);
+        if (!match)
+            continue;
+        const [, key, value] = match;
+        const trimmed = value.trim();
+        switch (key.toLowerCase()) {
+            case 'surface':
+                header.surface = trimmed || null;
+                break;
+            case 'session':
+                header.session = namedOrNull(trimmed);
+                break;
+            case 'engine':
+                header.engine = namedOrNull(trimmed);
+                break;
+            case 'provider':
+                header.provider = namedOrNull(trimmed);
+                break;
+            case 'model':
+                header.model = namedOrNull(trimmed);
+                break;
+            case 'transport':
+                header.transport = namedOrNull(trimmed);
+                break;
+            case 'version':
+                header.version = namedOrNull(trimmed);
+                break;
+            case 'pid':
+                header.pid = Number.isFinite(Number(trimmed)) ? Number(trimmed) : null;
+                break;
+            case 'platform':
+                header.platform = orNull(trimmed);
+                break;
+            case 'started': {
+                const at = Date.parse(trimmed);
+                header.startedAt = Number.isFinite(at) ? at : null;
+                break;
+            }
+            default: break;
+        }
+    }
+    return header.surface ? header : null;
+}
+/**
+ * A named header value, or null.
+ *
+ * `render()` writes the literal `unknown` when a surface never learned a field.
+ * That is the right thing to READ in the file and the wrong thing to COMPARE:
+ * "two surfaces both said unknown" must not read as agreement about a backend,
+ * so the parser maps the sentinel back to null and the comparison sees "not
+ * named" for what it is.
+ */
+function namedOrNull(value) {
+    const trimmed = value.trim();
+    if (!trimmed || trimmed.toLowerCase() === 'unknown')
+        return null;
+    return trimmed;
+}
+/** Every log file in `dir`, newest first. Missing directory = empty list. */
+export function listDebugLogs(dir = debugLogDir()) {
+    try {
+        if (!existsSync(dir))
+            return [];
+        return readdirSync(dir)
+            .filter((name) => name.endsWith('.log'))
+            .map((name) => {
+            const path = join(dir, name);
+            return { path, header: parseDebugLogHeader(readFileSafe(path) ?? ''), at: statSafe(path) };
+        })
+            .sort((a, b) => b.at - a.at)
+            .map(({ path, header }) => ({ path, header }));
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * The newest log a given surface wrote, or null.
+ *
+ * This is how the parity harness reads a surface's OWN durable artifact — the
+ * same reasoning the gateway driver uses to read `inbound.chat` from the
+ * gateway log rather than trusting a return value.
+ */
+export function readLatestDebugLog(surface, dir = debugLogDir()) {
+    const want = safeLabel(surface);
+    for (const file of listDebugLogs(dir)) {
+        if (file.header?.surface !== want)
+            continue;
+        const text = readFileSafe(file.path);
+        if (text)
+            return { path: file.path, header: file.header, text };
+    }
+    return null;
+}
+/**
+ * Every log a given conversation wrote, OLDEST FIRST — the findable half.
+ *
+ * This is what lets the dashboard answer "the debug log for the chat I am
+ * looking at" without guessing. Two rules make it safe to expose:
+ *
+ *  1. SELECTED BY THE LOG'S OWN HEADER, never by recency. "The newest few logs"
+ *     would hand a user somebody else's conversation — with a concurrent turn in
+ *     another tab, that is the common case, not the edge case.
+ *
+ *  2. OLDEST FIRST, because a bundle is read top to bottom as the story of what
+ *     happened, and a single turn's log already reads that way internally. The
+ *     newest-first order `listDebugLogs` uses is right for "what just happened"
+ *     and wrong for this.
+ *
+ * A file that cannot be read or parsed is skipped rather than failing the whole
+ * bundle: one unreadable turn must not cost the user the other four.
+ */
+export function debugLogsForSession(sessionId, dir = debugLogDir()) {
+    const want = cap(safeLabel(String(sessionId)), DEBUG_LOG_SESSION_CHARS);
+    if (!want)
+        return [];
+    const out = [];
+    try {
+        if (!existsSync(dir))
+            return [];
+        for (const name of readdirSync(dir)) {
+            if (!name.endsWith('.log'))
+                continue;
+            const path = join(dir, name);
+            const text = readFileSafe(path);
+            if (!text)
+                continue;
+            const header = parseDebugLogHeader(text);
+            if (!header || header.session !== want)
+                continue;
+            out.push({ path, header, text });
+        }
+    }
+    catch {
+        return out;
+    }
+    // The header's own `started`, not the file's mtime: a copy, a backup restore
+    // or a `touch` rewrites mtime and would silently reorder the story.
+    return out.sort((a, b) => (a.header.startedAt ?? Number.MAX_SAFE_INTEGER) -
+        (b.header.startedAt ?? Number.MAX_SAFE_INTEGER));
+}
+function readFileSafe(path) {
+    try {
+        return readFileSync(path, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+function statSafe(path) {
+    try {
+        return statSync(path).mtimeMs;
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * A one-line notice a surface can print so the user knows a log exists to
+ * attach. Kept here so all five surfaces word it identically.
+ */
+export function debugLogNotice(surface, path) {
+    if (!path)
+        return null;
+    return `🐞 ${surface}: session debug log written to ${path} — attach it to a bug report.`;
+}
+//# sourceMappingURL=debug-log.js.map

package/dist/observability/debug-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-log.js","sourceRoot":"","sources":["../../src/observability/debug-log.ts"],"names":[],"mappings":"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"}

package/dist/observability/event-bus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../src/observability/event-bus.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,4CAA4C;AAC5C,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAsDrB;;;;OAIG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAIH;;;;;;;OAOG;;;;;;;;;;;;;;;;;;;;;;;CAsCK,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAErE,sDAAsD;AACtD,MAAM,WAAW,WAAW;IAC1B,iDAAiD;IACjD,KAAK,EAAE,SAAS,CAAC;IACjB,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,IAAI,EAAE,OAAO,CAAC;IACd,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wCAAwC;AACxC,MAAM,WAAW,WAAW;IAC1B,+CAA+C;IAC/C,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;IACzB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,0DAA0D;AAC1D,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;AAIzD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,QAAQ;IACnB,0EAA0E;IAC1E,OAAO,CAAC,QAAQ,CAAwC;IACxD,4BAA4B;IAC5B,OAAO,CAAC,OAAO,CAAqB;IACpC,6DAA6D;IAC7D,OAAO,CAAC,UAAU,CAAS;IAC3B,8CAA8C;IAC9C,OAAO,CAAC,MAAM,CAAQ;gBAEV,UAAU,SAAS;IAM/B;;;;;;OAMG;IACH,EAAE,CAAC,KAAK,EAAE,SAAS,GAAG,GAAG,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,IAAI;IAY7D;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,GAAG,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,IAAI;IAS/D;;OAEG;IACH,GAAG,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,GAAG,GAAG,IAAI;IAUlC;;;;;;OAMG;IACH,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IA2C5D;;OAEG;IACH,UAAU,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,WAAW,EAAE;IAwB/C;;OAEG;IACH,YAAY,IAAI,IAAI;IAIpB;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,CAEvB;IAID;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,MAAM,IAAI,IAAI;IAId;;OAEG;IACH,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;OAEG;IACH,KAAK,IAAI,IAAI;CAKd;AAID;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,MAAM,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC5B,0CAA0C;IAC1C,MAAM,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,CAAC;CAC7B;AAID;;;;GAIG;AACH,qBAAa,cAAe,YAAW,gBAAgB;IACrD,QAAQ,CAAC,IAAI,oBAAoB;IACjC,OAAO,CAAC,aAAa,CAAyB;IAE9C,MAAM,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI;IA8S3B,MAAM,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI;CAM5B;AAID;;;;;;;;GAQG;AACH,qBAAa,WAAY,YAAW,gBAAgB;IAClD,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,OAAO,CAAC,aAAa,CAAyB;IAE9C,MAAM,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI;IAsC3B,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;CAM7B;AAID,oCAAoC;AACpC,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,qBAAa,iBAAkB,YAAW,gBAAgB;IACxD,QAAQ,CAAC,IAAI,uBAAuB;IACpC,OAAO,CAAC,aAAa,CAAyB;IAC9C,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,aAAa,CAAK;IAE1B,MAAM,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI;IAiC3B;;OAEG;IACH,QAAQ,IAAI,iBAAiB;IAsB7B,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;CAM7B;AAID;;;;;GAKG;AACH,qBAAa,aAAc,YAAW,gBAAgB;IACpD,QAAQ,CAAC,IAAI,mBAAmB;IAChC,OAAO,CAAC,aAAa,CAAyB;IAC9C,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,cAAc,CAAS;IAE/B,MAAM,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI;IA+B3B,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;CAM7B;AAOD;;;GAGG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CActC;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,IAAI,CASpC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,aAAa,CAAC,gBAAgB,CAAC,CAEtE"}
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../src/observability/event-bus.ts"],"names":[],"mappings":"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"}

package/dist/observability/event-bus.js

@@ -85,7 +85,10 @@ export const EventNames = {
     // Shell execution events (E1 — every subprocess is a visible lane)
     EXEC_SHELL_START: 'exec:shell-start',
     EXEC_SHELL_END: 'exec:shell-end',
-    // I2 — tool-loop execution (drives the hooks registry's post_tool_call hook)
+    // I2 — tool-loop execution. WS4 (#26) — consumed by the dashboard's step cards
+    // and the gateway's durable turn record; the operator's tool hooks are NOT
+    // driven from here (the execution seam calls them directly, so a veto can stop
+    // a call and no surface can double-fire one).
     TOOL_CALLED: 'tool:called',
     // Delegation events (H2 — sub-agent spawning, `spawn_agents` /
     // `delegate_tool.py` parity). Emitted by src/agents/tools/delegation.ts