@zelari/core 2.10.0 → 2.11.0

package/dist/runtime/observers/ObserverBus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObserverBus.d.ts","sourceRoot":"","sources":["../../../src/runtime/observers/ObserverBus.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAClB,cAAc,EACf,MAAM,YAAY,CAAC;AAYpB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAE9E,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAID,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuB;IACnD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;gBAGjD,WAAW,GAAE,kBAAkB,EAAO,EACtC,OAAO,GAAE,kBAAuB;IAMlC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAEK,IAAI,CAAC,CAAC,SAAS,MAAM,aAAa,EACtC,IAAI,EAAE,CAAC,EACP,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAClD,OAAO,CAAC,cAAc,EAAE,CAAC;IA2BtB,YAAY,CAAC,CAAC,SAAS,MAAM,aAAa,EAC9C,IAAI,EAAE,CAAC,EACP,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAClD,OAAO,CAAC,cAAc,CAAC;CAG3B;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,OAAO,CAGjD;AAED;;;;;GAKG;AACH,MAAM,WAAW,yBAAyB;IACxC,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,aAAa,CAAC,EAAE,mBAAmB,CAAC;CACrC;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,GAAE,yBAA8B,GACtC,WAAW,GAAG,SAAS,CA6EzB"}

package/dist/runtime/observers/ObserverBus.js

@@ -0,0 +1,160 @@
+/**
+ * ObserverBus — ordered, failure-mode-aware fan-out to a set of observers.
+ *
+ * Observers run in ascending priority; each throw is isolated per the
+ * descriptor's `failureMode`. `emit` returns the raw result list;
+ * `emitResolved` collapses it to a single intervention via
+ * {@link resolveInterventions}.
+ */
+import { CONTINUE } from './types.js';
+import { join } from 'node:path';
+import { resolveInterventions } from './resolve.js';
+import { RepetitionGuard } from '../guards/RepetitionGuard.js';
+import { FailureSignatureGuard } from '../guards/FailureSignatureGuard.js';
+import { DuplicateSearchGuard } from '../guards/DuplicateSearchGuard.js';
+import { NoProgressGuard } from '../guards/NoProgressGuard.js';
+import { ReasoningWatchdog } from '../guards/ReasoningWatchdog.js';
+import { TraceObserver } from './TraceObserver.js';
+import { MetricsObserver } from './MetricsObserver.js';
+import { RunRecorder, newRunId, runRecordEnabled } from '../recorder/RunRecorder.js';
+import { createRecorderObserver } from '../recorder/recorderObserver.js';
+import { SteeringObserver } from '../controls/SteeringObserver.js';
+export class ObserverBus {
+    descriptors;
+    logger;
+    constructor(descriptors = [], options = {}) {
+        this.descriptors = [...descriptors].sort((a, b) => a.priority - b.priority);
+        this.logger = options.logger ?? (() => { });
+    }
+    get size() {
+        return this.descriptors.length;
+    }
+    async emit(hook, event) {
+        const results = [];
+        for (const descriptor of this.descriptors) {
+            const callback = descriptor.observer[hook];
+            if (typeof callback !== 'function')
+                continue;
+            try {
+                const result = await callback.call(descriptor.observer, event);
+                results.push(result ?? CONTINUE);
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                if (descriptor.failureMode === 'fail-closed') {
+                    results.push({
+                        action: 'stop',
+                        reason: `observer "${descriptor.id}" failed: ${message}`,
+                        code: 'OBSERVER_FAIL_CLOSED',
+                    });
+                }
+                else {
+                    if (descriptor.failureMode === 'warn') {
+                        this.logger(`[observers] ${descriptor.id} (${String(hook)}) failed: ${message}`);
+                    }
+                    results.push(CONTINUE);
+                }
+            }
+        }
+        return results;
+    }
+    async emitResolved(hook, event) {
+        return resolveInterventions(await this.emit(hook, event));
+    }
+}
+/**
+ * Env flag for the default runtime-observer set (Frontier PHASE 1 rollout).
+ * Explicit `AgentHarnessConfig.observers` always run; this flag only gates
+ * the implicit default bus (RepetitionGuard, failureMode 'warn').
+ */
+export function runtimeObserversEnabled() {
+    const raw = process.env.ZELARI_RUNTIME_OBSERVERS?.trim().toLowerCase();
+    return raw === '1' || raw === 'true' || raw === 'on';
+}
+/**
+ * Build the default observer bus: the four runtime guards (priority 30,
+ * warn) plus the telemetry-only observers — ReasoningWatchdog (priority 30,
+ * warn), TraceObserver (80, warn) and MetricsObserver (90, ignore). Returns
+ * `undefined` (→ observers OFF) unless ZELARI_RUNTIME_OBSERVERS is enabled,
+ * so the default hot path pays zero observer overhead.
+ *
+ * With ZELARI_RUN_RECORD=1 a Run Flight Recorder observer (priority 85) is
+ * appended: manifest/trace/agents/metrics under `<runsDir>/<runId>/`.
+ */
+export function buildRuntimeObserverBus(options = {}) {
+    const steering = options.steeringQueue
+        ? [
+            {
+                id: 'steering-observer',
+                priority: 20,
+                failureMode: 'warn',
+                observer: new SteeringObserver(options.steeringQueue),
+            },
+        ]
+        : [];
+    // Without a steering queue the env flag still gates everything (the default
+    // hot path pays zero observer overhead). With one, a bus containing only
+    // the SteeringObserver is returned even when the flag is off.
+    if (!runtimeObserversEnabled()) {
+        return steering.length > 0 ? new ObserverBus(steering) : undefined;
+    }
+    const descriptors = [
+        ...steering,
+        {
+            id: 'repetition-guard',
+            priority: 30,
+            failureMode: 'warn',
+            observer: new RepetitionGuard(),
+        },
+        {
+            id: 'failure-signature-guard',
+            priority: 30,
+            failureMode: 'warn',
+            observer: new FailureSignatureGuard(),
+        },
+        {
+            id: 'duplicate-search-guard',
+            priority: 30,
+            failureMode: 'warn',
+            observer: new DuplicateSearchGuard(),
+        },
+        {
+            id: 'no-progress-guard',
+            priority: 30,
+            failureMode: 'warn',
+            observer: new NoProgressGuard(),
+        },
+        {
+            id: 'reasoning-watchdog',
+            priority: 30,
+            failureMode: 'warn',
+            observer: new ReasoningWatchdog(),
+        },
+        {
+            id: 'trace-observer',
+            priority: 80,
+            failureMode: 'warn',
+            observer: new TraceObserver(),
+        },
+        {
+            id: 'metrics-observer',
+            priority: 90,
+            failureMode: 'ignore',
+            observer: new MetricsObserver(),
+        },
+    ];
+    if (runRecordEnabled()) {
+        const recorder = new RunRecorder({
+            runsDir: options.runsDir ?? join(process.cwd(), '.zelari', 'runs'),
+            runId: options.runId ?? newRunId(),
+        });
+        descriptors.push({
+            id: 'run-recorder',
+            priority: 85,
+            failureMode: 'warn',
+            observer: createRecorderObserver(recorder),
+        });
+    }
+    return new ObserverBus(descriptors);
+}
+//# sourceMappingURL=ObserverBus.js.map

package/dist/runtime/observers/ObserverBus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObserverBus.js","sourceRoot":"","sources":["../../../src/runtime/observers/ObserverBus.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAMjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACrF,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AASnE,MAAM,OAAO,WAAW;IACL,WAAW,CAAuB;IAClC,MAAM,CAA4B;IAEnD,YACE,cAAoC,EAAE,EACtC,UAA8B,EAAE;QAEhC,IAAI,CAAC,WAAW,GAAG,CAAC,GAAG,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;QAC5E,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,IAAI,CACR,IAAO,EACP,KAAmD;QAEnD,MAAM,OAAO,GAAqB,EAAE,CAAC;QACrC,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAC1C,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,CAA6B,CAAC;YACvE,IAAI,OAAO,QAAQ,KAAK,UAAU;gBAAE,SAAS;YAC7C,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;gBAC/D,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,QAAQ,CAAC,CAAC;YACnC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACjE,IAAI,UAAU,CAAC,WAAW,KAAK,aAAa,EAAE,CAAC;oBAC7C,OAAO,CAAC,IAAI,CAAC;wBACX,MAAM,EAAE,MAAM;wBACd,MAAM,EAAE,aAAa,UAAU,CAAC,EAAE,aAAa,OAAO,EAAE;wBACxD,IAAI,EAAE,sBAAsB;qBAC7B,CAAC,CAAC;gBACL,CAAC;qBAAM,CAAC;oBACN,IAAI,UAAU,CAAC,WAAW,KAAK,MAAM,EAAE,CAAC;wBACtC,IAAI,CAAC,MAAM,CAAC,eAAe,UAAU,CAAC,EAAE,KAAK,MAAM,CAAC,IAAI,CAAC,aAAa,OAAO,EAAE,CAAC,CAAC;oBACnF,CAAC;oBACD,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACzB,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,IAAO,EACP,KAAmD;QAEnD,OAAO,oBAAoB,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAC5D,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB;IACrC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACvE,OAAO,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,IAAI,CAAC;AACvD,CAAC;AAqBD;;;;;;;;;GASG;AACH,MAAM,UAAU,uBAAuB,CACrC,UAAqC,EAAE;IAEvC,MAAM,QAAQ,GAAyB,OAAO,CAAC,aAAa;QAC1D,CAAC,CAAC;YACE;gBACE,EAAE,EAAE,mBAAmB;gBACvB,QAAQ,EAAE,EAAE;gBACZ,WAAW,EAAE,MAAM;gBACnB,QAAQ,EAAE,IAAI,gBAAgB,CAAC,OAAO,CAAC,aAAa,CAAC;aACtD;SACF;QACH,CAAC,CAAC,EAAE,CAAC;IACP,4EAA4E;IAC5E,yEAAyE;IACzE,8DAA8D;IAC9D,IAAI,CAAC,uBAAuB,EAAE,EAAE,CAAC;QAC/B,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACrE,CAAC;IACD,MAAM,WAAW,GAAyB;QACxC,GAAG,QAAQ;QACX;YACE,EAAE,EAAE,kBAAkB;YACtB,QAAQ,EAAE,EAAE;YACZ,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,IAAI,eAAe,EAAE;SAChC;QACD;YACE,EAAE,EAAE,yBAAyB;YAC7B,QAAQ,EAAE,EAAE;YACZ,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,IAAI,qBAAqB,EAAE;SACtC;QACD;YACE,EAAE,EAAE,wBAAwB;YAC5B,QAAQ,EAAE,EAAE;YACZ,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,IAAI,oBAAoB,EAAE;SACrC;QACD;YACE,EAAE,EAAE,mBAAmB;YACvB,QAAQ,EAAE,EAAE;YACZ,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,IAAI,eAAe,EAAE;SAChC;QACD;YACE,EAAE,EAAE,oBAAoB;YACxB,QAAQ,EAAE,EAAE;YACZ,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,IAAI,iBAAiB,EAAE;SAClC;QACD;YACE,EAAE,EAAE,gBAAgB;YACpB,QAAQ,EAAE,EAAE;YACZ,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,IAAI,aAAa,EAAE;SAC9B;QACD;YACE,EAAE,EAAE,kBAAkB;YACtB,QAAQ,EAAE,EAAE;YACZ,WAAW,EAAE,QAAQ;YACrB,QAAQ,EAAE,IAAI,eAAe,EAAE;SAChC;KACF,CAAC;IAEF,IAAI,gBAAgB,EAAE,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,IAAI,WAAW,CAAC;YAC/B,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC;YAClE,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,QAAQ,EAAE;SACnC,CAAC,CAAC;QACH,WAAW,CAAC,IAAI,CAAC;YACf,EAAE,EAAE,cAAc;YAClB,QAAQ,EAAE,EAAE;YACZ,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,sBAAsB,CAAC,QAAQ,CAAC;SAC3C,CAAC,CAAC;IACL,CAAC;IAED,OAAO,IAAI,WAAW,CAAC,WAAW,CAAC,CAAC;AACtC,CAAC"}

package/dist/runtime/observers/TraceObserver.d.ts

@@ -0,0 +1,36 @@
+import type { AgentObserver, ModelAttemptEvent, ModelDeltaEvent, ModelResponseEvent, ObserverResult, RunCancelledEvent, RunEndEvent, RunStartEvent, RuntimeAgentRole, ToolCallEvent, ToolResultEvent, TurnEndEvent } from './types.js';
+export interface TraceEntry {
+    hook: string;
+    eventId: string;
+    ts: number;
+    agentId: string;
+    role: RuntimeAgentRole;
+    turn: number;
+}
+export interface TraceObserverOptions {
+    /** Best-effort forward of every recorded entry. */
+    sink?: (entry: TraceEntry) => void;
+    /** Ring buffer capacity (default 500). */
+    capacity?: number;
+}
+export declare class TraceObserver implements AgentObserver {
+    private readonly entries;
+    private readonly sink?;
+    private readonly capacity;
+    constructor(options?: TraceObserverOptions);
+    onRunStart(event: RunStartEvent): Promise<ObserverResult>;
+    onModelAttempt(event: ModelAttemptEvent): Promise<ObserverResult>;
+    onModelDelta(event: ModelDeltaEvent): Promise<ObserverResult>;
+    onModelResponse(event: ModelResponseEvent): Promise<ObserverResult>;
+    onToolCall(event: ToolCallEvent): Promise<ObserverResult>;
+    onToolResult(event: ToolResultEvent): Promise<ObserverResult>;
+    onTurnEnd(event: TurnEndEvent): Promise<ObserverResult>;
+    onRunEnd(event: RunEndEvent): Promise<ObserverResult>;
+    onCancelled(event: RunCancelledEvent): Promise<ObserverResult>;
+    /** Recorded entries, oldest first. */
+    getEntries(): TraceEntry[];
+    get size(): number;
+    clear(): void;
+    private record;
+}
+//# sourceMappingURL=TraceObserver.d.ts.map

package/dist/runtime/observers/TraceObserver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TraceObserver.d.ts","sourceRoot":"","sources":["../../../src/runtime/observers/TraceObserver.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,gBAAgB,EAEhB,aAAa,EACb,eAAe,EACf,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,mDAAmD;IACnD,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IACnC,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAID,qBAAa,aAAc,YAAW,aAAa;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAA8B;IACpD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,OAAO,GAAE,oBAAyB;IAKxC,UAAU,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAIzD,cAAc,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC;IAIjE,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAI7D,eAAe,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,cAAc,CAAC;IAInE,UAAU,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAIzD,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAI7D,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC;IAIvD,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;IAIrD,WAAW,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC;IAIpE,sCAAsC;IACtC,UAAU,IAAI,UAAU,EAAE;IAI1B,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,MAAM;CAkBf"}

package/dist/runtime/observers/TraceObserver.js

@@ -0,0 +1,78 @@
+/**
+ * TraceObserver — bounded in-memory trace of every runtime event it sees
+ * (Frontier upgrade, PHASE 1 observer set).
+ *
+ * Best-effort: keeps a ring buffer (default 500 entries) and forwards each
+ * entry to an optional sink (e.g. the future Run Flight Recorder writer).
+ * Sink errors are swallowed — a tracing failure must never break a run
+ * (§102: recorder failure does not block; authorization does).
+ */
+import { CONTINUE } from './types.js';
+const DEFAULT_CAPACITY = 500;
+export class TraceObserver {
+    entries = [];
+    sink;
+    capacity;
+    constructor(options = {}) {
+        this.sink = options.sink;
+        this.capacity = Math.max(1, options.capacity ?? DEFAULT_CAPACITY);
+    }
+    async onRunStart(event) {
+        return this.record('onRunStart', event);
+    }
+    async onModelAttempt(event) {
+        return this.record('onModelAttempt', event);
+    }
+    async onModelDelta(event) {
+        return this.record('onModelDelta', event);
+    }
+    async onModelResponse(event) {
+        return this.record('onModelResponse', event);
+    }
+    async onToolCall(event) {
+        return this.record('onToolCall', event);
+    }
+    async onToolResult(event) {
+        return this.record('onToolResult', event);
+    }
+    async onTurnEnd(event) {
+        return this.record('onTurnEnd', event);
+    }
+    async onRunEnd(event) {
+        return this.record('onRunEnd', event);
+    }
+    async onCancelled(event) {
+        return this.record('onCancelled', event);
+    }
+    /** Recorded entries, oldest first. */
+    getEntries() {
+        return [...this.entries];
+    }
+    get size() {
+        return this.entries.length;
+    }
+    clear() {
+        this.entries.length = 0;
+    }
+    record(hook, event) {
+        const entry = {
+            hook,
+            eventId: event.id,
+            ts: event.ts,
+            agentId: event.identity.agentId,
+            role: event.identity.role,
+            turn: event.turn,
+        };
+        this.entries.push(entry);
+        if (this.entries.length > this.capacity)
+            this.entries.shift();
+        try {
+            this.sink?.(entry);
+        }
+        catch {
+            // Best-effort sink: swallow.
+        }
+        return CONTINUE;
+    }
+}
+//# sourceMappingURL=TraceObserver.js.map

package/dist/runtime/observers/TraceObserver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TraceObserver.js","sourceRoot":"","sources":["../../../src/runtime/observers/TraceObserver.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAiCtC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAE7B,MAAM,OAAO,aAAa;IACP,OAAO,GAAiB,EAAE,CAAC;IAC3B,IAAI,CAA+B;IACnC,QAAQ,CAAS;IAElC,YAAY,UAAgC,EAAE;QAC5C,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,IAAI,gBAAgB,CAAC,CAAC;IACpE,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAoB;QACnC,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,KAAwB;QAC3C,OAAO,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,KAAsB;QACvC,OAAO,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,KAAyB;QAC7C,OAAO,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAoB;QACnC,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,KAAsB;QACvC,OAAO,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,KAAmB;QACjC,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,KAAkB;QAC/B,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,KAAwB;QACxC,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED,sCAAsC;IACtC,UAAU;QACR,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IAC7B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IAC1B,CAAC;IAEO,MAAM,CAAC,IAAY,EAAE,KAAuB;QAClD,MAAM,KAAK,GAAe;YACxB,IAAI;YACJ,OAAO,EAAE,KAAK,CAAC,EAAE;YACjB,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,OAAO;YAC/B,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI;YACzB,IAAI,EAAE,KAAK,CAAC,IAAI;SACjB,CAAC;QACF,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ;YAAE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAC9D,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;QAAC,MAAM,CAAC;YACP,6BAA6B;QAC/B,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}

package/dist/runtime/observers/composeObservers.d.ts

@@ -0,0 +1,10 @@
+/**
+ * composeObservers — collapse several observers into a single AgentObserver.
+ *
+ * Each hook fans out to every observer in order and returns the resolved
+ * intervention. This is a raw fan-out (no failure modes); use {@link ObserverBus}
+ * when throw isolation / fail-closed semantics are required.
+ */
+import type { AgentObserver } from './types.js';
+export declare function composeObservers(observers: AgentObserver[]): AgentObserver;
+//# sourceMappingURL=composeObservers.d.ts.map

package/dist/runtime/observers/composeObservers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composeObservers.d.ts","sourceRoot":"","sources":["../../../src/runtime/observers/composeObservers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,aAAa,EAAkB,MAAM,YAAY,CAAC;AAkBhE,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,aAAa,CAe1E"}

package/dist/runtime/observers/composeObservers.js

@@ -0,0 +1,30 @@
+import { CONTINUE } from './types.js';
+import { resolveInterventions } from './resolve.js';
+const HOOKS = [
+    'onRunStart',
+    'onModelAttempt',
+    'onModelDelta',
+    'onModelResponse',
+    'onToolCall',
+    'onToolResult',
+    'onTurnEnd',
+    'onRunEnd',
+    'onCancelled',
+];
+export function composeObservers(observers) {
+    const composed = {};
+    for (const hook of HOOKS) {
+        composed[hook] = async (event) => {
+            const results = [];
+            for (const observer of observers) {
+                const callback = observer[hook];
+                if (typeof callback === 'function') {
+                    results.push((await callback(event)) ?? CONTINUE);
+                }
+            }
+            return resolveInterventions(results);
+        };
+    }
+    return composed;
+}
+//# sourceMappingURL=composeObservers.js.map

package/dist/runtime/observers/composeObservers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composeObservers.js","sourceRoot":"","sources":["../../../src/runtime/observers/composeObservers.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,KAAK,GAA4B;IACrC,YAAY;IACZ,gBAAgB;IAChB,cAAc;IACd,iBAAiB;IACjB,YAAY;IACZ,cAAc;IACd,WAAW;IACX,UAAU;IACV,aAAa;CACd,CAAC;AAIF,MAAM,UAAU,gBAAgB,CAAC,SAA0B;IACzD,MAAM,QAAQ,GAAkB,EAAE,CAAC;IACnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACxB,QAAoC,CAAC,IAAI,CAAC,GAAG,KAAK,EAAE,KAAc,EAA2B,EAAE;YAC9F,MAAM,OAAO,GAAqB,EAAE,CAAC;YACrC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;gBACjC,MAAM,QAAQ,GAAI,QAAoC,CAAC,IAAI,CAAC,CAAC;gBAC7D,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;oBACnC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAO,QAAyB,CAAC,KAAK,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC;gBACtE,CAAC;YACH,CAAC;YACD,OAAO,oBAAoB,CAAC,OAAO,CAAC,CAAC;QACvC,CAAC,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/runtime/observers/index.d.ts

@@ -0,0 +1,7 @@
+export * from './types.js';
+export * from './resolve.js';
+export * from './ObserverBus.js';
+export * from './composeObservers.js';
+export * from './TraceObserver.js';
+export * from './MetricsObserver.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/observers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/observers/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC"}

package/dist/runtime/observers/index.js

@@ -0,0 +1,7 @@
+export * from './types.js';
+export * from './resolve.js';
+export * from './ObserverBus.js';
+export * from './composeObservers.js';
+export * from './TraceObserver.js';
+export * from './MetricsObserver.js';
+//# sourceMappingURL=index.js.map

package/dist/runtime/observers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/observers/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC"}

package/dist/runtime/observers/resolve.d.ts

@@ -0,0 +1,3 @@
+import type { ObserverResult } from './types.js';
+export declare function resolveInterventions(results: ObserverResult[]): ObserverResult;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/runtime/observers/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../src/runtime/observers/resolve.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAWjD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,cAAc,CAY9E"}

package/dist/runtime/observers/resolve.js

@@ -0,0 +1,30 @@
+/**
+ * Intervention resolution — semantic precedence when several observers answer
+ * the same event. `deny_tool` (hardest) wins over everything; `continue` is the
+ * weakest. Ties at the same action are resolved by the bus in descriptor order
+ * (lowest priority first); this function only ranks by action kind.
+ */
+import { CONTINUE } from './types.js';
+const ACTION_RANK = {
+    deny_tool: 6,
+    stop: 5,
+    retry: 4,
+    replace: 3,
+    inject: 2,
+    continue: 1,
+};
+export function resolveInterventions(results) {
+    if (results.length === 0)
+        return CONTINUE;
+    let best = results[0];
+    let bestRank = ACTION_RANK[best.action];
+    for (let i = 1; i < results.length; i += 1) {
+        const rank = ACTION_RANK[results[i].action];
+        if (rank > bestRank) {
+            best = results[i];
+            bestRank = rank;
+        }
+    }
+    return best;
+}
+//# sourceMappingURL=resolve.js.map

package/dist/runtime/observers/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../../src/runtime/observers/resolve.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,MAAM,WAAW,GAA6C;IAC5D,SAAS,EAAE,CAAC;IACZ,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;IACR,OAAO,EAAE,CAAC;IACV,MAAM,EAAE,CAAC;IACT,QAAQ,EAAE,CAAC;CACZ,CAAC;AAEF,MAAM,UAAU,oBAAoB,CAAC,OAAyB;IAC5D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC1C,IAAI,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACtB,IAAI,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,IAAI,GAAG,QAAQ,EAAE,CAAC;YACpB,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YAClB,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/runtime/observers/types.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Observer / Intervention runtime — shared contracts (Frontier upgrade, PHASE 1).
+ *
+ * A provider-neutral, in-process complement to the external lifecycle hooks
+ * (`core/hooks`). Observers run inside the agent loop and return typed
+ * interventions without mutating global state. The runtime core stays neutral:
+ * observers are opt-in and must not throw for ordinary policy decisions.
+ *
+ * Naming note: the role type here is `RuntimeAgentRole` because `AgentRole` is
+ * already an exported council-role interface (`types/legacy.ts`).
+ */
+/** Which agent a runtime event belongs to. */
+export type RuntimeAgentRole = 'lead' | 'explore' | 'general' | 'verify' | 'planner' | 'council' | 'mission';
+export interface RuntimeIdentity {
+    runId: string;
+    agentId: string;
+    parentAgentId?: string;
+    role: RuntimeAgentRole;
+    mode: 'kraken' | 'council' | 'zelari';
+    model?: string;
+    provider?: string;
+    graphNodeId?: string;
+}
+/** Fields shared by every observer event. */
+export interface RuntimeEventBase {
+    id: string;
+    ts: number;
+    identity: RuntimeIdentity;
+    turn: number;
+}
+export interface RunStartEvent extends RuntimeEventBase {
+}
+export interface ModelAttemptEvent extends RuntimeEventBase {
+}
+export interface ModelDeltaEvent extends RuntimeEventBase {
+    delta: string;
+}
+export interface ModelResponseEvent extends RuntimeEventBase {
+}
+export interface ToolCallEvent extends RuntimeEventBase {
+    toolCallId: string;
+    toolName: string;
+    args: unknown;
+}
+export interface ToolResultEvent extends RuntimeEventBase {
+    toolCallId: string;
+    toolName: string;
+    result: unknown;
+    ok: boolean;
+}
+export interface TurnEndEvent extends RuntimeEventBase {
+}
+export interface RunEndEvent extends RuntimeEventBase {
+    reason: 'completed' | 'cancelled' | 'error';
+}
+export interface RunCancelledEvent extends RuntimeEventBase {
+    reason?: string;
+}
+/** A message an observer injects back into the agent conversation. */
+export interface RuntimeInjectedMessage {
+    role: 'system' | 'user';
+    kind: string;
+    content: string;
+}
+/** Explicit decision an observer returns. Never mutate global state inline. */
+export type ObserverResult = {
+    action: 'continue';
+} | {
+    action: 'retry';
+    reason?: string;
+    consumeTurn?: boolean;
+} | {
+    action: 'stop';
+    reason: string;
+    code?: string;
+} | {
+    action: 'replace';
+    content: unknown;
+} | {
+    action: 'inject';
+    message: RuntimeInjectedMessage;
+} | {
+    action: 'deny_tool';
+    reason: string;
+};
+export declare const CONTINUE: ObserverResult;
+/** Observer callbacks on the agent loop. */
+export interface AgentObserver {
+    onRunStart?(event: RunStartEvent): ObserverResult | Promise<ObserverResult>;
+    onModelAttempt?(event: ModelAttemptEvent): ObserverResult | Promise<ObserverResult>;
+    onModelDelta?(event: ModelDeltaEvent): ObserverResult | Promise<ObserverResult>;
+    onModelResponse?(event: ModelResponseEvent): ObserverResult | Promise<ObserverResult>;
+    onToolCall?(event: ToolCallEvent): ObserverResult | Promise<ObserverResult>;
+    onToolResult?(event: ToolResultEvent): ObserverResult | Promise<ObserverResult>;
+    onTurnEnd?(event: TurnEndEvent): ObserverResult | Promise<ObserverResult>;
+    onRunEnd?(event: RunEndEvent): ObserverResult | Promise<ObserverResult>;
+    onCancelled?(event: RunCancelledEvent): ObserverResult | Promise<ObserverResult>;
+}
+/**
+ * How the bus treats an observer that throws.
+ *  - `ignore`      → swallow, continue
+ *  - `warn`        → log + continue
+ *  - `fail-closed` → emit a stop intervention (safety-critical observers)
+ */
+export type ObserverFailureMode = 'ignore' | 'warn' | 'fail-closed';
+export interface ObserverDescriptor {
+    id: string;
+    /** Lower runs first. 10 = authorization/safety, 90 = metrics. */
+    priority: number;
+    failureMode: ObserverFailureMode;
+    observer: AgentObserver;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/runtime/observers/types.d.ts.map

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

package/dist/runtime/observers/types.js

@@ -0,0 +1,13 @@
+/**
+ * Observer / Intervention runtime — shared contracts (Frontier upgrade, PHASE 1).
+ *
+ * A provider-neutral, in-process complement to the external lifecycle hooks
+ * (`core/hooks`). Observers run inside the agent loop and return typed
+ * interventions without mutating global state. The runtime core stays neutral:
+ * observers are opt-in and must not throw for ordinary policy decisions.
+ *
+ * Naming note: the role type here is `RuntimeAgentRole` because `AgentRole` is
+ * already an exported council-role interface (`types/legacy.ts`).
+ */
+export const CONTINUE = { action: 'continue' };
+//# sourceMappingURL=types.js.map

package/dist/runtime/observers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/runtime/observers/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAgFH,MAAM,CAAC,MAAM,QAAQ,GAAmB,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC"}

package/dist/runtime/recorder/Redactor.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Centralized redaction for run-recorder payloads (Frontier PHASE 5, §99).
+ *
+ * Every writer funnels through `redactRuntimePayload()`; no individual
+ * recorder path is allowed to serialize secrets on its own. Best-effort by
+ * nature (regex-based), but the single choke point keeps patterns auditable.
+ */
+export declare const REDACTED = "[REDACTED]";
+/** Redact secret-looking substrings from free text. */
+export declare function redactString(input: string): string;
+/**
+ * Recursively redact a payload before it is persisted by the recorder.
+ * - secret-ish object keys → whole value replaced
+ * - strings → pattern scrub
+ * - arrays/objects → walked
+ * - primitives → passed through
+ */
+export declare function redactRuntimePayload(value: unknown): unknown;
+//# sourceMappingURL=Redactor.d.ts.map

package/dist/runtime/recorder/Redactor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Redactor.d.ts","sourceRoot":"","sources":["../../../src/runtime/recorder/Redactor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,QAAQ,eAAe,CAAC;AAwCrC,uDAAuD;AACvD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAc5D"}