@zelari/core 2.10.0 → 2.11.1

package/dist/runtime/guards/NoProgressGuard.js

@@ -0,0 +1,84 @@
+/**
+ * NoProgressGuard — detect runs that stop making meaningful progress
+ * (Frontier upgrade, PHASE 1B §15).
+ *
+ * Core-level progress signals available from observer events: file-writing
+ * tool calls (write_file / edit_file / apply_diff) and first-time tool-call
+ * fingerprints. A turn with zero tool calls is treated as neutral (pure
+ * synthesis / answer turns do not advance the stall counter, to avoid false
+ * positives on legitimately finishing runs).
+ *
+ * `softStallTurns` consecutive unproductive turns inject a change-strategy
+ * warning; `hardStallTurns` consecutive unproductive turns stop the run.
+ * This generalizes the mission-level stall concept to the plain Kraken loop.
+ */
+import { CONTINUE } from '../observers/types.js';
+import { toolCallFingerprint } from './RepetitionGuard.js';
+/** Tools whose execution changes repository state. */
+export const FILE_WRITING_TOOLS = new Set([
+    'write_file',
+    'edit_file',
+    'apply_diff',
+]);
+const REASSESS_MESSAGE = [
+    'The run has made no measurable progress for several turns.',
+    'Change strategy: inspect different files, delegate exploration, or revise the hypothesis.',
+].join('\n');
+export class NoProgressGuard {
+    seenFingerprints = new Set();
+    soft;
+    hard;
+    stallTurns = 0;
+    turnToolCalls = 0;
+    turnWrites = 0;
+    turnNewFingerprints = 0;
+    constructor(config = {}) {
+        this.soft = config.softStallTurns ?? 2;
+        this.hard = config.hardStallTurns ?? 5;
+    }
+    async onToolCall(event) {
+        this.turnToolCalls += 1;
+        if (FILE_WRITING_TOOLS.has(event.toolName))
+            this.turnWrites += 1;
+        const fingerprint = toolCallFingerprint(event.toolName, event.args);
+        const key = `${fingerprint.tool}\u0000${fingerprint.argsHash}`;
+        if (!this.seenFingerprints.has(key)) {
+            this.seenFingerprints.add(key);
+            this.turnNewFingerprints += 1;
+        }
+        return CONTINUE;
+    }
+    async onTurnEnd(_event) {
+        if (this.turnToolCalls === 0) {
+            // Neutral: a turn without tool calls is synthesis, not stall evidence.
+            return CONTINUE;
+        }
+        const productive = this.turnWrites > 0 || this.turnNewFingerprints > 0;
+        this.stallTurns = productive ? 0 : this.stallTurns + 1;
+        this.turnToolCalls = 0;
+        this.turnWrites = 0;
+        this.turnNewFingerprints = 0;
+        if (this.stallTurns >= this.hard) {
+            return {
+                action: 'stop',
+                reason: `no measurable progress for ${this.stallTurns} consecutive turns`,
+                code: 'no_progress',
+            };
+        }
+        if (this.stallTurns >= this.soft) {
+            return {
+                action: 'inject',
+                message: { role: 'user', kind: 'runtime-warning', content: REASSESS_MESSAGE },
+            };
+        }
+        return CONTINUE;
+    }
+    reset() {
+        this.seenFingerprints.clear();
+        this.stallTurns = 0;
+        this.turnToolCalls = 0;
+        this.turnWrites = 0;
+        this.turnNewFingerprints = 0;
+    }
+}
+//# sourceMappingURL=NoProgressGuard.js.map

package/dist/runtime/guards/NoProgressGuard.js.map

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

package/dist/runtime/guards/ReasoningWatchdog.d.ts

@@ -0,0 +1,48 @@
+import type { AgentObserver, ModelAttemptEvent, ModelDeltaEvent, ModelResponseEvent, ObserverResult, RunCancelledEvent, RunEndEvent } from '../observers/types.js';
+export interface ReasoningWatchdogConfig {
+    /** Warn when the first token takes longer than this (ms). */
+    firstTokenWarnMs?: number;
+    /** Warn when the gap between two stream deltas exceeds this (ms). */
+    streamIdleWarnMs?: number;
+}
+export interface ProviderAttemptMetrics {
+    attemptId: string;
+    startedAt: number;
+    firstTokenAt?: number;
+    endedAt?: number;
+    timeToFirstTokenMs?: number;
+    generationDurationMs?: number;
+    maxStreamIdleMs?: number;
+    deltas: number;
+}
+export interface ProviderIdleWarning {
+    code: 'provider_idle';
+    metric: 'time_to_first_token' | 'stream_idle';
+    attemptId: string;
+    valueMs: number;
+    thresholdMs: number;
+    message: string;
+    ts: number;
+}
+export declare class ReasoningWatchdog implements AgentObserver {
+    private readonly firstTokenWarnMs;
+    private readonly streamIdleWarnMs;
+    private readonly now;
+    private current;
+    private lastDeltaAt;
+    private readonly completed;
+    private readonly warnings;
+    constructor(config?: ReasoningWatchdogConfig, now?: () => number);
+    onModelAttempt(event: ModelAttemptEvent): Promise<ObserverResult>;
+    onModelDelta(event: ModelDeltaEvent): Promise<ObserverResult>;
+    onModelResponse(_event: ModelResponseEvent): Promise<ObserverResult>;
+    onRunEnd(_event: RunEndEvent): Promise<ObserverResult>;
+    onCancelled(_event: RunCancelledEvent): Promise<ObserverResult>;
+    /** Completed attempt metrics, oldest first (bounded). */
+    getAttemptMetrics(): ProviderAttemptMetrics[];
+    getWarnings(): ProviderIdleWarning[];
+    reset(): void;
+    private finalizeCurrent;
+    private warn;
+}
+//# sourceMappingURL=ReasoningWatchdog.d.ts.map

package/dist/runtime/guards/ReasoningWatchdog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReasoningWatchdog.d.ts","sourceRoot":"","sources":["../../../src/runtime/guards/ReasoningWatchdog.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,WAAW,EACZ,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,uBAAuB;IACtC,6DAA6D;IAC7D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,eAAe,CAAC;IACtB,MAAM,EAAE,qBAAqB,GAAG,aAAa,CAAC;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;CACZ;AAkBD,qBAAa,iBAAkB,YAAW,aAAa;IACrD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IAEnC,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgC;IAC1D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;gBAE1C,MAAM,GAAE,uBAA4B,EAAE,GAAG,GAAE,MAAM,MAAiB;IAUxE,cAAc,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC;IAajE,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IA4B7D,eAAe,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,cAAc,CAAC;IAKpE,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;IAKtD,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC;IAKrE,yDAAyD;IACzD,iBAAiB,IAAI,sBAAsB,EAAE;IAI7C,WAAW,IAAI,mBAAmB,EAAE;IAIpC,KAAK,IAAI,IAAI;IAOb,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,IAAI;CAmBb"}

package/dist/runtime/guards/ReasoningWatchdog.js

@@ -0,0 +1,135 @@
+/**
+ * ReasoningWatchdog — provider latency telemetry (Frontier upgrade, PHASE 1B §17).
+ *
+ * Tracks time-to-first-token, generation duration and stream idle gaps per
+ * model attempt, and records `provider_idle` warnings when thresholds are
+ * exceeded. It NEVER interrupts the provider on its own: observers here are
+ * telemetry-only (§17 — do not auto-abort providers that support long
+ * reasoning). Warnings and metrics are exposed via accessors for the CLI /
+ * future Run Flight Recorder.
+ *
+ * Env thresholds (config overrides win):
+ *   ZELARI_MODEL_FIRST_TOKEN_WARN_MS  (default 60000)
+ *   ZELARI_MODEL_STREAM_IDLE_WARN_MS  (default 30000)
+ */
+import { CONTINUE } from '../observers/types.js';
+const DEFAULT_FIRST_TOKEN_WARN_MS = 60_000;
+const DEFAULT_STREAM_IDLE_WARN_MS = 30_000;
+const MAX_COMPLETED = 100;
+function envPositiveInt(name, fallback) {
+    const raw = process.env[name]?.trim();
+    if (!raw)
+        return fallback;
+    const parsed = Number.parseInt(raw, 10);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
+}
+export class ReasoningWatchdog {
+    firstTokenWarnMs;
+    streamIdleWarnMs;
+    now;
+    current = null;
+    lastDeltaAt;
+    completed = [];
+    warnings = [];
+    constructor(config = {}, now = Date.now) {
+        this.firstTokenWarnMs =
+            config.firstTokenWarnMs ??
+                envPositiveInt('ZELARI_MODEL_FIRST_TOKEN_WARN_MS', DEFAULT_FIRST_TOKEN_WARN_MS);
+        this.streamIdleWarnMs =
+            config.streamIdleWarnMs ??
+                envPositiveInt('ZELARI_MODEL_STREAM_IDLE_WARN_MS', DEFAULT_STREAM_IDLE_WARN_MS);
+        this.now = now;
+    }
+    async onModelAttempt(event) {
+        this.finalizeCurrent();
+        this.current = {
+            attemptId: event.id,
+            startedAt: this.now(),
+            deltas: 0,
+            warnedFirstToken: false,
+            warnedIdle: false,
+        };
+        this.lastDeltaAt = undefined;
+        return CONTINUE;
+    }
+    async onModelDelta(event) {
+        const attempt = this.current;
+        if (!attempt)
+            return CONTINUE;
+        const at = this.now();
+        attempt.deltas += 1;
+        if (attempt.firstTokenAt === undefined) {
+            attempt.firstTokenAt = at;
+            const ttft = at - attempt.startedAt;
+            attempt.timeToFirstTokenMs = ttft;
+            if (!attempt.warnedFirstToken && ttft > this.firstTokenWarnMs) {
+                attempt.warnedFirstToken = true;
+                this.warn('time_to_first_token', attempt, ttft, this.firstTokenWarnMs);
+            }
+        }
+        else {
+            const gap = at - (this.lastDeltaAt ?? attempt.firstTokenAt);
+            if (gap > (attempt.maxStreamIdleMs ?? 0))
+                attempt.maxStreamIdleMs = gap;
+            if (!attempt.warnedIdle && gap > this.streamIdleWarnMs) {
+                attempt.warnedIdle = true;
+                this.warn('stream_idle', attempt, gap, this.streamIdleWarnMs);
+            }
+        }
+        this.lastDeltaAt = at;
+        return CONTINUE;
+    }
+    async onModelResponse(_event) {
+        this.finalizeCurrent();
+        return CONTINUE;
+    }
+    async onRunEnd(_event) {
+        this.finalizeCurrent();
+        return CONTINUE;
+    }
+    async onCancelled(_event) {
+        this.finalizeCurrent();
+        return CONTINUE;
+    }
+    /** Completed attempt metrics, oldest first (bounded). */
+    getAttemptMetrics() {
+        return this.completed.map((attempt) => ({ ...attempt }));
+    }
+    getWarnings() {
+        return this.warnings.map((warning) => ({ ...warning }));
+    }
+    reset() {
+        this.current = null;
+        this.lastDeltaAt = undefined;
+        this.completed.length = 0;
+        this.warnings.length = 0;
+    }
+    finalizeCurrent() {
+        const attempt = this.current;
+        if (!attempt)
+            return;
+        attempt.endedAt = this.now();
+        if (attempt.firstTokenAt !== undefined) {
+            attempt.generationDurationMs = attempt.endedAt - attempt.startedAt;
+        }
+        this.completed.push({ ...attempt });
+        if (this.completed.length > MAX_COMPLETED)
+            this.completed.shift();
+        this.current = null;
+        this.lastDeltaAt = undefined;
+    }
+    warn(metric, attempt, valueMs, thresholdMs) {
+        this.warnings.push({
+            code: 'provider_idle',
+            metric,
+            attemptId: attempt.attemptId,
+            valueMs,
+            thresholdMs,
+            message: metric === 'time_to_first_token'
+                ? `Provider first token took ${valueMs}ms (threshold ${thresholdMs}ms).`
+                : `Provider stream idle for ${valueMs}ms between deltas (threshold ${thresholdMs}ms).`,
+            ts: this.now(),
+        });
+    }
+}
+//# sourceMappingURL=ReasoningWatchdog.js.map

package/dist/runtime/guards/ReasoningWatchdog.js.map

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

package/dist/runtime/guards/RepetitionGuard.d.ts

@@ -0,0 +1,22 @@
+import type { AgentObserver, ObserverResult, ToolCallEvent } from '../observers/types.js';
+export interface ToolCallFingerprint {
+    tool: string;
+    argsHash: string;
+}
+/** Canonical sha256 over { tool, args }; arg-key-order independent. */
+export declare function toolCallFingerprint(tool: string, args: unknown): ToolCallFingerprint;
+export interface RepetitionGuardConfig {
+    /** Inject a reassess message at this many identical calls (default 2). */
+    warnAfter?: number;
+    /** Stop the run at this many identical calls (default 5). */
+    stopAfter?: number;
+}
+export declare class RepetitionGuard implements AgentObserver {
+    private readonly counts;
+    private readonly warnAfter;
+    private readonly stopAfter;
+    constructor(config?: RepetitionGuardConfig);
+    onToolCall(event: ToolCallEvent): Promise<ObserverResult>;
+    reset(): void;
+}
+//# sourceMappingURL=RepetitionGuard.d.ts.map

package/dist/runtime/guards/RepetitionGuard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RepetitionGuard.d.ts","sourceRoot":"","sources":["../../../src/runtime/guards/RepetitionGuard.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,aAAa,EACd,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,uEAAuE;AACvE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,mBAAmB,CAKpF;AAED,MAAM,WAAW,qBAAqB;IACpC,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAOD,qBAAa,eAAgB,YAAW,aAAa;IACnD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,MAAM,GAAE,qBAA0B;IAKxC,UAAU,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAsB/D,KAAK,IAAI,IAAI;CAGd"}

package/dist/runtime/guards/RepetitionGuard.js

@@ -0,0 +1,56 @@
+/**
+ * RepetitionGuard — detect semantically identical tool calls repeated without
+ * new progress (Frontier upgrade, PHASE 1B).
+ *
+ * Fingerprint is a canonical sha256 over { tool, args } (order-free), so two
+ * calls with the same tool and equal arguments — regardless of key order — map
+ * to the same bucket. Reaction: inject a reassess message at `warnAfter`, stop
+ * the run at `stopAfter`.
+ */
+import { createHash } from 'node:crypto';
+import { stableStringify } from '../../core/requestSnapshot.js';
+import { CONTINUE } from '../observers/types.js';
+/** Canonical sha256 over { tool, args }; arg-key-order independent. */
+export function toolCallFingerprint(tool, args) {
+    const argsHash = createHash('sha256')
+        .update(stableStringify(args ?? null))
+        .digest('hex');
+    return { tool, argsHash };
+}
+const REASSESS_MESSAGE = [
+    'The same tool call has produced no new progress multiple times.',
+    'Reassess the current hypothesis before repeating it again.',
+].join('\n');
+export class RepetitionGuard {
+    counts = new Map();
+    warnAfter;
+    stopAfter;
+    constructor(config = {}) {
+        this.warnAfter = config.warnAfter ?? 2;
+        this.stopAfter = config.stopAfter ?? 5;
+    }
+    async onToolCall(event) {
+        const fingerprint = toolCallFingerprint(event.toolName, event.args);
+        const key = `${fingerprint.tool}\u0000${fingerprint.argsHash}`;
+        const count = (this.counts.get(key) ?? 0) + 1;
+        this.counts.set(key, count);
+        if (count >= this.stopAfter) {
+            return {
+                action: 'stop',
+                reason: `repeated tool call "${fingerprint.tool}" ${count} times without new progress`,
+                code: 'repeated_tool',
+            };
+        }
+        if (count >= this.warnAfter) {
+            return {
+                action: 'inject',
+                message: { role: 'user', kind: 'runtime-warning', content: REASSESS_MESSAGE },
+            };
+        }
+        return CONTINUE;
+    }
+    reset() {
+        this.counts.clear();
+    }
+}
+//# sourceMappingURL=RepetitionGuard.js.map

package/dist/runtime/guards/RepetitionGuard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RepetitionGuard.js","sourceRoot":"","sources":["../../../src/runtime/guards/RepetitionGuard.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAYjD,uEAAuE;AACvE,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,IAAa;IAC7D,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC;SAClC,MAAM,CAAC,eAAe,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC;SACrC,MAAM,CAAC,KAAK,CAAC,CAAC;IACjB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAC5B,CAAC;AASD,MAAM,gBAAgB,GAAG;IACvB,iEAAiE;IACjE,4DAA4D;CAC7D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,OAAO,eAAe;IACT,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACnC,SAAS,CAAS;IAClB,SAAS,CAAS;IAEnC,YAAY,SAAgC,EAAE;QAC5C,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAoB;QACnC,MAAM,WAAW,GAAG,mBAAmB,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACpE,MAAM,GAAG,GAAG,GAAG,WAAW,CAAC,IAAI,SAAS,WAAW,CAAC,QAAQ,EAAE,CAAC;QAC/D,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QAC9C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAE5B,IAAI,KAAK,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAC5B,OAAO;gBACL,MAAM,EAAE,MAAM;gBACd,MAAM,EAAE,uBAAuB,WAAW,CAAC,IAAI,KAAK,KAAK,6BAA6B;gBACtF,IAAI,EAAE,eAAe;aACtB,CAAC;QACJ,CAAC;QACD,IAAI,KAAK,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAC5B,OAAO;gBACL,MAAM,EAAE,QAAQ;gBAChB,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,gBAAgB,EAAE;aAC9E,CAAC;QACJ,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;CACF"}

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

@@ -0,0 +1,6 @@
+export * from './RepetitionGuard.js';
+export * from './FailureSignatureGuard.js';
+export * from './DuplicateSearchGuard.js';
+export * from './NoProgressGuard.js';
+export * from './ReasoningWatchdog.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/guards/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC"}

package/dist/runtime/guards/index.js

@@ -0,0 +1,6 @@
+export * from './RepetitionGuard.js';
+export * from './FailureSignatureGuard.js';
+export * from './DuplicateSearchGuard.js';
+export * from './NoProgressGuard.js';
+export * from './ReasoningWatchdog.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/guards/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC"}

package/dist/runtime/index.d.ts

@@ -10,4 +10,8 @@ export * from './harnessManifest.js';
 export * from './executionContext.js';
 export * from './resourcePolicy.js';
 export * from './resourceBudget.js';
+export * from './observers/index.js';
+export * from './guards/index.js';
+export * from './recorder/index.js';
+export * from './controls/index.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC"}

package/dist/runtime/index.js

@@ -10,4 +10,8 @@ export * from './harnessManifest.js';
 export * from './executionContext.js';
 export * from './resourcePolicy.js';
 export * from './resourceBudget.js';
+export * from './observers/index.js';
+export * from './guards/index.js';
+export * from './recorder/index.js';
+export * from './controls/index.js';
 //# sourceMappingURL=index.js.map

package/dist/runtime/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC"}

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

@@ -0,0 +1,42 @@
+import type { AgentObserver, ModelAttemptEvent, ModelDeltaEvent, ModelResponseEvent, ObserverResult, RunCancelledEvent, RunEndEvent, RunStartEvent, ToolCallEvent, ToolResultEvent, TurnEndEvent } from './types.js';
+export interface RuntimeMetricsSnapshot {
+    runsStarted: number;
+    modelAttempts: number;
+    modelDeltas: number;
+    modelResponses: number;
+    toolCalls: number;
+    toolResults: number;
+    toolFailures: number;
+    turnsEnded: number;
+    runsEnded: number;
+    cancelled: number;
+    firstEventTs?: number;
+    lastEventTs?: number;
+}
+export declare class MetricsObserver implements AgentObserver {
+    private runsStarted;
+    private modelAttempts;
+    private modelDeltas;
+    private modelResponses;
+    private toolCalls;
+    private toolResults;
+    private toolFailures;
+    private turnsEnded;
+    private runsEnded;
+    private cancelled;
+    private firstEventTs;
+    private lastEventTs;
+    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>;
+    snapshot(): RuntimeMetricsSnapshot;
+    reset(): void;
+    private tick;
+}
+//# sourceMappingURL=MetricsObserver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MetricsObserver.d.ts","sourceRoot":"","sources":["../../../src/runtime/observers/MetricsObserver.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,aAAa,EACb,eAAe,EACf,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,eAAgB,YAAW,aAAa;IACnD,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,WAAW,CAAqB;IAElC,UAAU,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAMzD,cAAc,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC;IAMjE,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAM7D,eAAe,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,cAAc,CAAC;IAMnE,UAAU,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAMzD,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAO7D,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC;IAMvD,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;IAMrD,WAAW,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC;IAMpE,QAAQ,IAAI,sBAAsB;IAiBlC,KAAK,IAAI,IAAI;IAeb,OAAO,CAAC,IAAI;CAQb"}

package/dist/runtime/observers/MetricsObserver.js

@@ -0,0 +1,110 @@
+/**
+ * MetricsObserver — aggregate runtime counters (Frontier upgrade, PHASE 1
+ * observer set).
+ *
+ * Purely observational: counts loop activity (model attempts/deltas/responses,
+ * tool calls/results/failures, turns, run endings, cancellations) and tracks
+ * first/last event timestamps. Never returns an intervention. Failure mode
+ * should be `ignore` (§7.1: MetricsObserver → ignore).
+ */
+import { CONTINUE } from './types.js';
+export class MetricsObserver {
+    runsStarted = 0;
+    modelAttempts = 0;
+    modelDeltas = 0;
+    modelResponses = 0;
+    toolCalls = 0;
+    toolResults = 0;
+    toolFailures = 0;
+    turnsEnded = 0;
+    runsEnded = 0;
+    cancelled = 0;
+    firstEventTs;
+    lastEventTs;
+    async onRunStart(event) {
+        this.tick(event.ts);
+        this.runsStarted += 1;
+        return CONTINUE;
+    }
+    async onModelAttempt(event) {
+        this.tick(event.ts);
+        this.modelAttempts += 1;
+        return CONTINUE;
+    }
+    async onModelDelta(event) {
+        this.tick(event.ts);
+        this.modelDeltas += 1;
+        return CONTINUE;
+    }
+    async onModelResponse(event) {
+        this.tick(event.ts);
+        this.modelResponses += 1;
+        return CONTINUE;
+    }
+    async onToolCall(event) {
+        this.tick(event.ts);
+        this.toolCalls += 1;
+        return CONTINUE;
+    }
+    async onToolResult(event) {
+        this.tick(event.ts);
+        this.toolResults += 1;
+        if (!event.ok)
+            this.toolFailures += 1;
+        return CONTINUE;
+    }
+    async onTurnEnd(event) {
+        this.tick(event.ts);
+        this.turnsEnded += 1;
+        return CONTINUE;
+    }
+    async onRunEnd(event) {
+        this.tick(event.ts);
+        this.runsEnded += 1;
+        return CONTINUE;
+    }
+    async onCancelled(event) {
+        this.tick(event.ts);
+        this.cancelled += 1;
+        return CONTINUE;
+    }
+    snapshot() {
+        return {
+            runsStarted: this.runsStarted,
+            modelAttempts: this.modelAttempts,
+            modelDeltas: this.modelDeltas,
+            modelResponses: this.modelResponses,
+            toolCalls: this.toolCalls,
+            toolResults: this.toolResults,
+            toolFailures: this.toolFailures,
+            turnsEnded: this.turnsEnded,
+            runsEnded: this.runsEnded,
+            cancelled: this.cancelled,
+            firstEventTs: this.firstEventTs,
+            lastEventTs: this.lastEventTs,
+        };
+    }
+    reset() {
+        this.runsStarted = 0;
+        this.modelAttempts = 0;
+        this.modelDeltas = 0;
+        this.modelResponses = 0;
+        this.toolCalls = 0;
+        this.toolResults = 0;
+        this.toolFailures = 0;
+        this.turnsEnded = 0;
+        this.runsEnded = 0;
+        this.cancelled = 0;
+        this.firstEventTs = undefined;
+        this.lastEventTs = undefined;
+    }
+    tick(ts) {
+        if (this.firstEventTs === undefined || ts < this.firstEventTs) {
+            this.firstEventTs = ts;
+        }
+        if (this.lastEventTs === undefined || ts > this.lastEventTs) {
+            this.lastEventTs = ts;
+        }
+    }
+}
+//# sourceMappingURL=MetricsObserver.js.map

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

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

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

@@ -0,0 +1,49 @@
+import type { AgentObserver, ObserverDescriptor, ObserverResult } from './types.js';
+import type { RuntimeControlQueue } from '../controls/RuntimeControlQueue.js';
+export interface ObserverBusOptions {
+    logger?: (message: string) => void;
+}
+export declare class ObserverBus {
+    private readonly descriptors;
+    private readonly logger;
+    constructor(descriptors?: ObserverDescriptor[], options?: ObserverBusOptions);
+    get size(): number;
+    emit<K extends keyof AgentObserver>(hook: K, event: Parameters<NonNullable<AgentObserver[K]>>[0]): Promise<ObserverResult[]>;
+    emitResolved<K extends keyof AgentObserver>(hook: K, event: Parameters<NonNullable<AgentObserver[K]>>[0]): Promise<ObserverResult>;
+}
+/**
+ * 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 declare function runtimeObserversEnabled(): boolean;
+/**
+ * Options for {@link buildRuntimeObserverBus}. The recorder branch only
+ * activates when ZELARI_RUN_RECORD is enabled; `runsDir`/`runId` exist so
+ * callers (and tests) can redirect the flight recorder away from the real
+ * workspace.
+ */
+export interface DefaultObserverBusOptions {
+    /** Root for `.zelari/runs`-style output. Default: `<cwd>/.zelari/runs`. */
+    runsDir?: string;
+    runId?: string;
+    /**
+     * Frontier PHASE 2: live steering queue. An explicit queue is itself an
+     * opt-in, so the SteeringObserver joins the bus even when the default-guard
+     * env flag is off (explicit config always wins, mirroring
+     * `AgentHarnessConfig.observers`).
+     */
+    steeringQueue?: RuntimeControlQueue;
+}
+/**
+ * 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 declare function buildRuntimeObserverBus(options?: DefaultObserverBusOptions): ObserverBus | undefined;
+//# sourceMappingURL=ObserverBus.d.ts.map