@zelari/core 0.7.9

package/dist/council/runMode.js

@@ -0,0 +1,41 @@
+/**
+ * Council run-mode detection — implementation vs design-phase.
+ *
+ * Drives gated tool-emission enforcement, mode banners in member prompts,
+ * and the complete-design post-processor skip in implementation runs.
+ */
+const DESIGN_KEYWORDS = /\b(design|architect|architecture|spec|blueprint|mockup|wireframe|greenfield|from scratch)\b/i;
+const IMPLEMENTATION_KEYWORDS = /\b(fix|refactor|bug|implement|patch|migrate|add tests|debug|repair|hotfix)\b/i;
+const PLAN_CONTINUE = /\b(continue|extend|update|refine)\b[\s\S]{0,40}\b(plan|phase|milestone)\b/i;
+/**
+ * Resolve how this council run should behave.
+ *
+ * Override order: `forceMode` → `ZELARI_COUNCIL_MODE` env → heuristics →
+ * default `implementation`.
+ */
+export function resolveCouncilRunMode(input) {
+    if (input.forceMode) {
+        return input.forceMode;
+    }
+    const envMode = input.env?.ZELARI_COUNCIL_MODE?.toLowerCase();
+    if (envMode === 'design' || envMode === 'design-phase') {
+        return 'design-phase';
+    }
+    if (envMode === 'implementation' || envMode === 'impl') {
+        return 'implementation';
+    }
+    const msg = input.userMessage;
+    const hasDesign = DESIGN_KEYWORDS.test(msg);
+    const hasImpl = IMPLEMENTATION_KEYWORDS.test(msg);
+    if (hasDesign && !hasImpl) {
+        return 'design-phase';
+    }
+    if (PLAN_CONTINUE.test(msg) && input.hasExistingPlan) {
+        return 'design-phase';
+    }
+    return 'implementation';
+}
+export function councilTierFromSize(councilSize) {
+    return councilSize >= 6 ? 'full' : 'lite';
+}
+//# sourceMappingURL=runMode.js.map

package/dist/council/runMode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runMode.js","sourceRoot":"","sources":["../../src/council/runMode.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,MAAM,eAAe,GACnB,8FAA8F,CAAC;AAEjG,MAAM,uBAAuB,GAC3B,+EAA+E,CAAC;AAElF,MAAM,aAAa,GACjB,4EAA4E,CAAC;AAE/E;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAA0B;IAC9D,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QACpB,OAAO,KAAK,CAAC,SAAS,CAAC;IACzB,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,EAAE,mBAAmB,EAAE,WAAW,EAAE,CAAC;IAC9D,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,cAAc,EAAE,CAAC;QACvD,OAAO,cAAc,CAAC;IACxB,CAAC;IACD,IAAI,OAAO,KAAK,gBAAgB,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACvD,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED,MAAM,GAAG,GAAG,KAAK,CAAC,WAAW,CAAC;IAC9B,MAAM,SAAS,GAAG,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,uBAAuB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAElD,IAAI,SAAS,IAAI,CAAC,OAAO,EAAE,CAAC;QAC1B,OAAO,cAAc,CAAC;IACxB,CAAC;IACD,IAAI,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;QACrD,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,WAAmB;IACrD,OAAO,WAAW,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;AAC5C,CAAC"}

package/dist/events/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Events — public event types (BrainEvent + variants) + EventBus utility.
+ */
+export * from '../shared/events.js';
+export { EventBus } from '../shared/eventBus.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/events/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/events/index.js

@@ -0,0 +1,6 @@
+/**
+ * Events — public event types (BrainEvent + variants) + EventBus utility.
+ */
+export * from '../shared/events.js';
+export { EventBus } from '../shared/eventBus.js';
+//# sourceMappingURL=index.js.map

package/dist/events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/harness/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Agent harness — the provider-neutral agent loop.
+ * `AgentHarness` is the single entrypoint for running an LLM-driven turn
+ * (system prompt + tools + streaming events).
+ */
+export * from '../core/AgentHarness.js';
+export * from '../core/providerStream.js';
+export * from '../core/sessionJsonl.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/harness/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/harness/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC"}

package/dist/harness/index.js

@@ -0,0 +1,9 @@
+/**
+ * Agent harness — the provider-neutral agent loop.
+ * `AgentHarness` is the single entrypoint for running an LLM-driven turn
+ * (system prompt + tools + streaming events).
+ */
+export * from '../core/AgentHarness.js';
+export * from '../core/providerStream.js';
+export * from '../core/sessionJsonl.js';
+//# sourceMappingURL=index.js.map

package/dist/harness/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/harness/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC"}

package/dist/harness/tools/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @zelari/core/harness/tools — built-in tools registry.
+ * Includes ToolRegistry class + the 5 default tools (filesystem, shell, search,
+ * listFiles, diff) + their shared types.
+ *
+ * `ToolContext` is intentionally NOT re-exported here: the authoritative
+ * version lives in `@zelari/core/types` (re-exported via `systemTypes.ts`
+ * from `agents/tools.ts`). Re-exporting the local `core/tools/toolTypes.ts`
+ * copy too would create an ambiguous re-export at the root `index.ts`
+ * barrel (v0.6.2 audit CRITICAL-1 follow-up).
+ */
+export * from '../../core/tools/registry.js';
+export type { TypedResult, ToolPermission, ToolDefinition, AuditEntry, } from '../../core/tools/toolTypes.js';
+export { typedOk, typedErr } from '../../core/tools/toolTypes.js';
+export * from '../../core/tools/builtin/filesystem.js';
+export * from '../../core/tools/builtin/shell.js';
+export * from '../../core/tools/builtin/search.js';
+export * from '../../core/tools/builtin/listFiles.js';
+export * from '../../core/tools/builtin/diff.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/harness/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/harness/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,cAAc,8BAA8B,CAAC;AAI7C,YAAY,EACV,WAAW,EACX,cAAc,EACd,cAAc,EACd,UAAU,GACX,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAClE,cAAc,wCAAwC,CAAC;AACvD,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,uCAAuC,CAAC;AACtD,cAAc,kCAAkC,CAAC"}

package/dist/harness/tools/index.js

@@ -0,0 +1,19 @@
+/**
+ * @zelari/core/harness/tools — built-in tools registry.
+ * Includes ToolRegistry class + the 5 default tools (filesystem, shell, search,
+ * listFiles, diff) + their shared types.
+ *
+ * `ToolContext` is intentionally NOT re-exported here: the authoritative
+ * version lives in `@zelari/core/types` (re-exported via `systemTypes.ts`
+ * from `agents/tools.ts`). Re-exporting the local `core/tools/toolTypes.ts`
+ * copy too would create an ambiguous re-export at the root `index.ts`
+ * barrel (v0.6.2 audit CRITICAL-1 follow-up).
+ */
+export * from '../../core/tools/registry.js';
+export { typedOk, typedErr } from '../../core/tools/toolTypes.js';
+export * from '../../core/tools/builtin/filesystem.js';
+export * from '../../core/tools/builtin/shell.js';
+export * from '../../core/tools/builtin/search.js';
+export * from '../../core/tools/builtin/listFiles.js';
+export * from '../../core/tools/builtin/diff.js';
+//# sourceMappingURL=index.js.map

package/dist/harness/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/harness/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,cAAc,8BAA8B,CAAC;AAU7C,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAClE,cAAc,wCAAwC,CAAC;AACvD,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,uCAAuC,CAAC;AACtD,cAAc,kCAAkC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @zelari/core — public API surface.
+ *
+ * Stable entrypoint. Anything not re-exported here is internal and may
+ * change without notice. Subpath imports (@zelari/core/harness, etc.) are
+ * supported for fine-grained access.
+ */
+export * from './events/index.js';
+export * from './types/index.js';
+export * from './harness/index.js';
+export * from './council/index.js';
+export * from './skills/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,cAAc,mBAAmB,CAAC;AAGlC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+/**
+ * @zelari/core — public API surface.
+ *
+ * Stable entrypoint. Anything not re-exported here is internal and may
+ * change without notice. Subpath imports (@zelari/core/harness, etc.) are
+ * supported for fine-grained access.
+ */
+// Events (provider-neutral contract)
+export * from './events/index.js';
+// Public types
+export * from './types/index.js';
+// Agent loop
+export * from './harness/index.js';
+// Council (multi-agent orchestration)
+export * from './council/index.js';
+// Skills (built-in)
+export * from './skills/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,qCAAqC;AACrC,cAAc,mBAAmB,CAAC;AAElC,eAAe;AACf,cAAc,kBAAkB,CAAC;AAEjC,aAAa;AACb,cAAc,oBAAoB,CAAC;AAEnC,sCAAsC;AACtC,cAAc,oBAAoB,CAAC;AAEnC,oBAAoB;AACpB,cAAc,mBAAmB,CAAC"}

package/dist/shared/eventBus.d.ts

@@ -0,0 +1,58 @@
+/**
+ * EventBus — typed, in-memory pub/sub over the {@link BrainEvent} union.
+ *
+ * This is the transport-agnostic core for fanning agent events out to any
+ * frontend (Electron renderer today, Ink CLI tomorrow). It deals only in
+ * provider-neutral {@link BrainEvent}s and pulls in no Node- or Electron-
+ * specific APIs, so it is safe to import from the renderer/browser too.
+ *
+ * Dispatch rules:
+ *  - Typed subscribers (registered via {@link EventBus.subscribe}) fire first.
+ *  - Wildcard subscribers (registered via {@link EventBus.subscribeAll}) fire
+ *    afterwards, so type-specific handlers always see an event before the
+ *    catch-all observers do.
+ *  - A subscriber that throws — or returns a rejected Promise — is logged and
+ *    isolated; it never blocks the remaining subscribers.
+ *  - Async subscribers are fire-and-forget: the bus invokes the handler
+ *    synchronously and does NOT await its returned Promise.
+ *
+ * @see docs/plans/2026-06-28-zelari-code.md (Task 11.2)
+ */
+import type { BrainEvent, BrainEventType } from './events.js';
+/** Async-capable subscriber. Receives an event, may return a Promise. */
+export type Subscriber<T extends BrainEvent = BrainEvent> = (event: T) => void | Promise<void>;
+/** Wildcard subscriber — receives every event regardless of type. */
+export type AllEventsSubscriber = (event: BrainEvent) => void | Promise<void>;
+/** Returned by subscribe/subscribeAll; call to remove that handler. */
+export interface Unsubscribe {
+    (): void;
+}
+export declare class EventBus {
+    /** Per-type subscriber registry. */
+    private subscribers;
+    /** Wildcard subscribers (receive every event). */
+    private wildcardSubscribers;
+    constructor();
+    /** Subscribe to a specific event type. Returns an unsubscribe function. */
+    subscribe<T extends BrainEventType>(type: T, handler: Subscriber<Extract<BrainEvent, {
+        type: T;
+    }>>): Unsubscribe;
+    /** Subscribe to all events. Returns an unsubscribe function. */
+    subscribeAll(handler: AllEventsSubscriber): Unsubscribe;
+    /**
+     * Emit an event to all matching subscribers (typed first, then wildcard).
+     * Errors in individual subscribers are logged but do not prevent other
+     * subscribers from receiving the event.
+     */
+    emit(event: BrainEvent): void;
+    /** Remove all subscribers (typed + wildcard). */
+    clear(): void;
+    /**
+     * Number of subscribers. With a `type`, returns typed subscribers for that
+     * type; without, returns the total across all types plus wildcard handlers.
+     */
+    listenerCount(type?: BrainEventType): number;
+    /** Invoke a single subscriber, isolating sync throws and async rejections. */
+    private dispatch;
+}
+//# sourceMappingURL=eventBus.d.ts.map

package/dist/shared/eventBus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventBus.d.ts","sourceRoot":"","sources":["../../src/shared/eventBus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE9D,yEAAyE;AACzE,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,UAAU,GAAG,UAAU,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE/F,qEAAqE;AACrE,MAAM,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE9E,uEAAuE;AACvE,MAAM,WAAW,WAAW;IAC1B,IAAI,IAAI,CAAC;CACV;AAED,qBAAa,QAAQ;IACnB,oCAAoC;IACpC,OAAO,CAAC,WAAW,CAAuC;IAC1D,kDAAkD;IAClD,OAAO,CAAC,mBAAmB,CAA2B;;IAOtD,2EAA2E;IAC3E,SAAS,CAAC,CAAC,SAAS,cAAc,EAChC,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,UAAU,EAAE;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC,CAAC,GACpD,WAAW;IAkBd,gEAAgE;IAChE,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,WAAW;IAOvD;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAQ7B,iDAAiD;IACjD,KAAK,IAAI,IAAI;IAKb;;;OAGG;IACH,aAAa,CAAC,IAAI,CAAC,EAAE,cAAc,GAAG,MAAM;IAS5C,8EAA8E;IAC9E,OAAO,CAAC,QAAQ;CAYjB"}

package/dist/shared/eventBus.js

@@ -0,0 +1,104 @@
+/**
+ * EventBus — typed, in-memory pub/sub over the {@link BrainEvent} union.
+ *
+ * This is the transport-agnostic core for fanning agent events out to any
+ * frontend (Electron renderer today, Ink CLI tomorrow). It deals only in
+ * provider-neutral {@link BrainEvent}s and pulls in no Node- or Electron-
+ * specific APIs, so it is safe to import from the renderer/browser too.
+ *
+ * Dispatch rules:
+ *  - Typed subscribers (registered via {@link EventBus.subscribe}) fire first.
+ *  - Wildcard subscribers (registered via {@link EventBus.subscribeAll}) fire
+ *    afterwards, so type-specific handlers always see an event before the
+ *    catch-all observers do.
+ *  - A subscriber that throws — or returns a rejected Promise — is logged and
+ *    isolated; it never blocks the remaining subscribers.
+ *  - Async subscribers are fire-and-forget: the bus invokes the handler
+ *    synchronously and does NOT await its returned Promise.
+ *
+ * @see docs/plans/2026-06-28-zelari-code.md (Task 11.2)
+ */
+export class EventBus {
+    /** Per-type subscriber registry. */
+    subscribers;
+    /** Wildcard subscribers (receive every event). */
+    wildcardSubscribers;
+    constructor() {
+        this.subscribers = new Map();
+        this.wildcardSubscribers = new Set();
+    }
+    /** Subscribe to a specific event type. Returns an unsubscribe function. */
+    subscribe(type, handler) {
+        let set = this.subscribers.get(type);
+        if (!set) {
+            set = new Set();
+            this.subscribers.set(type, set);
+        }
+        // The handler is narrowed to a single variant; emit() only ever dispatches
+        // matching events to it, so widening the stored type is sound here.
+        const stored = handler;
+        set.add(stored);
+        return () => {
+            const current = this.subscribers.get(type);
+            if (!current)
+                return;
+            current.delete(stored);
+            if (current.size === 0)
+                this.subscribers.delete(type);
+        };
+    }
+    /** Subscribe to all events. Returns an unsubscribe function. */
+    subscribeAll(handler) {
+        this.wildcardSubscribers.add(handler);
+        return () => {
+            this.wildcardSubscribers.delete(handler);
+        };
+    }
+    /**
+     * Emit an event to all matching subscribers (typed first, then wildcard).
+     * Errors in individual subscribers are logged but do not prevent other
+     * subscribers from receiving the event.
+     */
+    emit(event) {
+        const set = this.subscribers.get(event.type);
+        if (set) {
+            for (const handler of set)
+                this.dispatch(handler, event);
+        }
+        for (const handler of this.wildcardSubscribers)
+            this.dispatch(handler, event);
+    }
+    /** Remove all subscribers (typed + wildcard). */
+    clear() {
+        this.subscribers.clear();
+        this.wildcardSubscribers.clear();
+    }
+    /**
+     * Number of subscribers. With a `type`, returns typed subscribers for that
+     * type; without, returns the total across all types plus wildcard handlers.
+     */
+    listenerCount(type) {
+        if (type !== undefined) {
+            return this.subscribers.get(type)?.size ?? 0;
+        }
+        let total = this.wildcardSubscribers.size;
+        for (const set of this.subscribers.values())
+            total += set.size;
+        return total;
+    }
+    /** Invoke a single subscriber, isolating sync throws and async rejections. */
+    dispatch(handler, event) {
+        try {
+            const result = handler(event);
+            if (result instanceof Promise) {
+                result.catch((err) => {
+                    console.error('[eventBus] subscriber error:', err);
+                });
+            }
+        }
+        catch (err) {
+            console.error('[eventBus] subscriber error:', err);
+        }
+    }
+}
+//# sourceMappingURL=eventBus.js.map

package/dist/shared/eventBus.js.map

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

package/dist/shared/events.d.ts

@@ -0,0 +1,230 @@
+/**
+ * BrainEvent — provider-neutral event contract for AnathemaBrain's agent system.
+ *
+ * These types are the ONLY contract between the agent loop (main process) and any
+ * frontend (Electron renderer today, Ink CLI tomorrow). They are intentionally
+ * standalone: no Electron imports, no project imports. Every payload is plain,
+ * JSON-serializable data so events can cross the IPC boundary or a socket
+ * untouched.
+ *
+ * @see docs/plans/2026-06-28-zelari-code.md (Task 11.1)
+ */
+/** Discriminator for every {@link BrainEvent} variant. */
+export type BrainEventType = 'agent_start' | 'agent_end' | 'message_start' | 'message_end' | 'message_delta' | 'thinking_delta' | 'tool_execution_start' | 'tool_execution_update' | 'tool_execution_end' | 'queue_update' | 'session_compacted' | 'error' | 'member_cost' | 'council_mode';
+/** Fields shared by every event. */
+export interface BrainEventBase {
+    /** Type discriminator. */
+    type: BrainEventType;
+    /** Unique event id (UUID v4 string). */
+    id: string;
+    /** Event timestamp (epoch ms). */
+    ts: number;
+    /** Session this event belongs to. */
+    sessionId: string;
+}
+/**
+ * The agent loop has started; carries the resolved model + provider.
+ *
+ * @since 0.5.0 `memberId` is included when the agent run belongs to a
+ *          council member (i.e. the run was launched by the council
+ *          pipeline, not by a direct user prompt). `memberName` is
+ *          the human-readable label (e.g. "Caronte") for UI display
+ *          without a second lookup into the roles table.
+ */
+export interface BrainAgentStartEvent extends BrainEventBase {
+    type: 'agent_start';
+    model: string;
+    provider: string;
+    memberId?: string;
+    memberName?: string;
+}
+/**
+ * The agent loop has finished, was cancelled, or errored out.
+ *
+ * @since 0.5.0 `memberId` + `memberName` mirror the corresponding
+ *          `agent_start` (see above).
+ */
+export interface BrainAgentEndEvent extends BrainEventBase {
+    type: 'agent_end';
+    reason: 'completed' | 'cancelled' | 'error';
+    durationMs: number;
+    memberId?: string;
+    memberName?: string;
+}
+/**
+ * An assistant message has begun streaming.
+ *
+ * @since 0.5.0 `memberId` + `memberName` identify the council member
+ *          producing this message (omitted for direct user prompts).
+ */
+export interface BrainMessageStartEvent extends BrainEventBase {
+    type: 'message_start';
+    messageId: string;
+    role: 'assistant';
+    memberId?: string;
+    memberName?: string;
+}
+/**
+ * An incremental chunk of assistant message text.
+ *
+ * @since 0.5.0 `memberId` + `memberName` mirror `message_start` so
+ *          consumers can stream-attribute text to a council member
+ *          without buffering until `message_end`.
+ */
+export interface BrainMessageDeltaEvent extends BrainEventBase {
+    type: 'message_delta';
+    messageId: string;
+    delta: string;
+    memberId?: string;
+    memberName?: string;
+}
+/**
+ * An assistant message has finished streaming.
+ *
+ * @since 0.5.0 `memberId` + `memberName` mirror `message_start`.
+ */
+export interface BrainMessageEndEvent extends BrainEventBase {
+    type: 'message_end';
+    messageId: string;
+    totalLength: number;
+    finishReason: string;
+    memberId?: string;
+    memberName?: string;
+    /**
+     * Real token usage reported by the provider (Task G.4). When the
+     * provider sends an OpenAI-shaped `usage` chunk (gated by
+     * `stream_options.include_usage`), this carries the actual numbers.
+     * When missing, downstream consumers fall back to the
+     * ~4-characters-per-token approximation that v3-B used.
+     *
+     * @see docs/plans/2026-06-29-anathema-coder-v3-G.md (Task G.4.4)
+     */
+    usage?: UsageBreakdown;
+}
+/**
+ * Provider-reported token usage for one assistant turn (Task G.4).
+ * The numbers come from the OpenAI-compatible `usage` field in the
+ * final SSE chunk before `[DONE]`. Providers that don't honor
+ * `stream_options.include_usage` will not emit this — consumers must
+ * degrade gracefully to the approximation.
+ */
+export interface UsageBreakdown {
+    /** Tokens in the prompt (system + user messages, including tool messages). */
+    promptTokens: number;
+    /** Tokens generated by the assistant. */
+    completionTokens: number;
+    /** Convenience: promptTokens + completionTokens. */
+    totalTokens: number;
+}
+/** An incremental chunk of the model's reasoning / thinking trace. */
+export interface BrainThinkingDeltaEvent extends BrainEventBase {
+    type: 'thinking_delta';
+    messageId: string;
+    delta: string;
+}
+/** A tool call has started executing. */
+export interface BrainToolExecutionStartEvent extends BrainEventBase {
+    type: 'tool_execution_start';
+    toolCallId: string;
+    toolName: string;
+    args: Record<string, unknown>;
+}
+/** Progress update emitted while a tool is still running. */
+export interface BrainToolExecutionUpdateEvent extends BrainEventBase {
+    type: 'tool_execution_update';
+    toolCallId: string;
+    delta?: string;
+}
+/** A tool call has finished, successfully or with an error. */
+export interface BrainToolExecutionEndEvent extends BrainEventBase {
+    type: 'tool_execution_end';
+    toolCallId: string;
+    result: string;
+    isError: boolean;
+    durationMs: number;
+}
+/** The count of queued user prompts has changed. */
+export interface BrainQueueUpdateEvent extends BrainEventBase {
+    type: 'queue_update';
+    queuedCount: number;
+}
+/** The session history was compacted into a summary. */
+export interface BrainSessionCompactedEvent extends BrainEventBase {
+    type: 'session_compacted';
+    summary: string;
+    messagesRemoved: number;
+}
+/** A recoverable, fatal, or cancellation error occurred. */
+export interface BrainErrorEvent extends BrainEventBase {
+    type: 'error';
+    severity: 'recoverable' | 'fatal' | 'cancelled';
+    message: string;
+    code?: string;
+}
+/**
+ * Per-member cost report emitted at the end of a council member's run.
+ * Carries the actual `MemberCost` payload produced by
+ * `MemberCostTracker.record()` (see `electron/cli/councilCost.ts`).
+ *
+ * Note: we inline a structural type here instead of importing the
+ * `MemberCost` type, to keep this events module free of CLI-side deps
+ * (architecture rule: events.ts must be renderer/Node-loadable without
+ * pulling in `electron/cli/*`).
+ */
+export interface BrainMemberCostEvent extends BrainEventBase {
+    type: 'member_cost';
+    cost: {
+        memberId: string;
+        name: string;
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+        durationMs: number;
+        toolCalls: number;
+        errored: boolean;
+    };
+}
+/** Emitted once at the start of a council run (tier + mode metadata). */
+export interface BrainCouncilModeEvent extends BrainEventBase {
+    type: 'council_mode';
+    tier: 'lite' | 'full';
+    councilSize: number;
+    runMode: 'implementation' | 'design-phase';
+}
+/** Discriminated union of every event the brain can emit. */
+export type BrainEvent = BrainAgentStartEvent | BrainAgentEndEvent | BrainMessageStartEvent | BrainMessageDeltaEvent | BrainMessageEndEvent | BrainThinkingDeltaEvent | BrainToolExecutionStartEvent | BrainToolExecutionUpdateEvent | BrainToolExecutionEndEvent | BrainQueueUpdateEvent | BrainSessionCompactedEvent | BrainErrorEvent | BrainMemberCostEvent | BrainCouncilModeEvent;
+/**
+ * Map from a {@link BrainEventType} discriminator to its concrete event type.
+ * Lets callers say `BrainEventOf<'agent_start'>` instead of repeating the
+ * `Extract<BrainEvent, { type: ... }>` dance.
+ */
+export type BrainEventOf<T extends BrainEventType> = Extract<BrainEvent, {
+    type: T;
+}>;
+export declare function isBrainAgentStartEvent(e: BrainEvent): e is BrainAgentStartEvent;
+export declare function isBrainAgentEndEvent(e: BrainEvent): e is BrainAgentEndEvent;
+export declare function isBrainMessageStartEvent(e: BrainEvent): e is BrainMessageStartEvent;
+export declare function isBrainMessageDeltaEvent(e: BrainEvent): e is BrainMessageDeltaEvent;
+export declare function isBrainMessageEndEvent(e: BrainEvent): e is BrainMessageEndEvent;
+export declare function isBrainThinkingDeltaEvent(e: BrainEvent): e is BrainThinkingDeltaEvent;
+export declare function isBrainToolExecutionStartEvent(e: BrainEvent): e is BrainToolExecutionStartEvent;
+export declare function isBrainToolExecutionUpdateEvent(e: BrainEvent): e is BrainToolExecutionUpdateEvent;
+export declare function isBrainToolExecutionEndEvent(e: BrainEvent): e is BrainToolExecutionEndEvent;
+export declare function isBrainQueueUpdateEvent(e: BrainEvent): e is BrainQueueUpdateEvent;
+export declare function isBrainSessionCompactedEvent(e: BrainEvent): e is BrainSessionCompactedEvent;
+export declare function isBrainErrorEvent(e: BrainEvent): e is BrainErrorEvent;
+export declare function isBrainMemberCostEvent(e: BrainEvent): e is BrainMemberCostEvent;
+export declare function isBrainCouncilModeEvent(e: BrainEvent): e is BrainCouncilModeEvent;
+/**
+ * Build a fully-formed {@link BrainEvent}, stamping the common `id` (UUID v4)
+ * and `ts` (epoch ms) fields automatically. The caller supplies only the
+ * variant-specific payload.
+ *
+ * Uses the global `crypto.randomUUID()` (Web Crypto), available in both Node 20+
+ * and the browser/renderer — keeping this module free of Node-only imports.
+ *
+ * @example
+ * const ev = createBrainEvent('message_delta', sessionId, { messageId, delta });
+ */
+export declare function createBrainEvent<T extends BrainEventType>(type: T, sessionId: string, data: Omit<BrainEventOf<T>, 'type' | 'id' | 'ts' | 'sessionId'>): BrainEventOf<T>;
+//# sourceMappingURL=events.d.ts.map

package/dist/shared/events.d.ts.map

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