@zelari/core 2.10.0 → 2.11.1

package/dist/runtime/controls/SteeringObserver.js

@@ -0,0 +1,46 @@
+/**
+ * SteeringObserver — drains pending steers at each safe turn boundary and
+ * injects them as one user message (Frontier PHASE 2, §26–27).
+ *
+ * Boundary semantics (§21): this hook runs after tool results are flushed and
+ * the assistant turn is sealed, before the next provider call. The in-flight
+ * provider request is never mutated. Follow-ups are NOT drained here: they
+ * become the next user task after the current run ends (§23.2), which is the
+ * caller's decision, not the observer's.
+ */
+import { CONTINUE } from '../observers/types.js';
+/**
+ * Render steers verbatim and numbered — never compacted automatically, later
+ * instructions may supersede earlier ones (§27).
+ */
+export function renderSteers(steers) {
+    const lines = ['Runtime user steering received during execution:', ''];
+    steers.forEach((steer, index) => {
+        lines.push(`[${index + 1}]`);
+        lines.push(steer.text);
+        lines.push('');
+    });
+    lines.push('Later instructions may supersede earlier ones.');
+    return lines.join('\n');
+}
+export class SteeringObserver {
+    queue;
+    constructor(queue) {
+        this.queue = queue;
+    }
+    async onTurnEnd(_event) {
+        const steers = this.queue.drainSteers();
+        if (steers.length === 0) {
+            return CONTINUE;
+        }
+        return {
+            action: 'inject',
+            message: {
+                role: 'user',
+                kind: 'runtime-steer',
+                content: renderSteers(steers),
+            },
+        };
+    }
+}
+//# sourceMappingURL=SteeringObserver.js.map

package/dist/runtime/controls/SteeringObserver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SteeringObserver.js","sourceRoot":"","sources":["../../../src/runtime/controls/SteeringObserver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,QAAQ,EAA8D,MAAM,uBAAuB,CAAC;AAI7G;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,MAA2B;IACtD,MAAM,KAAK,GAAG,CAAC,kDAAkD,EAAE,EAAE,CAAC,CAAC;IACvE,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAC9B,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;IACH,KAAK,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;IAC7D,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,OAAO,gBAAgB;IACE;IAA7B,YAA6B,KAA0B;QAA1B,UAAK,GAAL,KAAK,CAAqB;IAAG,CAAC;IAE3D,KAAK,CAAC,SAAS,CAAC,MAAoB;QAClC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QACxC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,OAAO;YACL,MAAM,EAAE,QAAQ;YAChB,OAAO,EAAE;gBACP,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE,YAAY,CAAC,MAAM,CAAC;aAC9B;SACF,CAAC;IACJ,CAAC;CACF"}

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

@@ -0,0 +1,4 @@
+export * from './types.js';
+export * from './RuntimeControlQueue.js';
+export * from './SteeringObserver.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/controls/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC"}

package/dist/runtime/controls/index.js

@@ -0,0 +1,4 @@
+export * from './types.js';
+export * from './RuntimeControlQueue.js';
+export * from './SteeringObserver.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/controls/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC"}

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

@@ -0,0 +1,43 @@
+/**
+ * Runtime control plane — ControlEvent contracts (Frontier upgrade, PHASE 2).
+ *
+ * Typed events an external controller (headless stdin bridge, Desktop, tests)
+ * can enqueue while a run is in flight. Steers/follow-ups are consumed by the
+ * SteeringObserver at safe turn boundaries; cancel/pause/resume are carried
+ * as data so higher layers can map them onto cooperative cancellation.
+ */
+export interface SteerControlEvent {
+    type: 'steer';
+    id: string;
+    text: string;
+    ts: number;
+    /** Reserved for future per-agent targeting; v1 always lands on the lead. */
+    target?: 'lead';
+}
+export interface FollowUpControlEvent {
+    type: 'follow_up';
+    id: string;
+    text: string;
+    ts: number;
+}
+export interface CancelControlEvent {
+    type: 'cancel';
+    id: string;
+    reason?: string;
+    ts: number;
+}
+export interface PauseControlEvent {
+    type: 'pause';
+    id: string;
+    ts: number;
+}
+export interface ResumeControlEvent {
+    type: 'resume';
+    id: string;
+    ts: number;
+}
+export type ControlEvent = SteerControlEvent | FollowUpControlEvent | CancelControlEvent | PauseControlEvent | ResumeControlEvent;
+export declare function isSteerControlEvent(event: ControlEvent): event is SteerControlEvent;
+export declare function isFollowUpControlEvent(event: ControlEvent): event is FollowUpControlEvent;
+export declare function isCancelControlEvent(event: ControlEvent): event is CancelControlEvent;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/runtime/controls/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,WAAW,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,MAAM,YAAY,GACpB,iBAAiB,GACjB,oBAAoB,GACpB,kBAAkB,GAClB,iBAAiB,GACjB,kBAAkB,CAAC;AAEvB,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,YAAY,GAClB,KAAK,IAAI,iBAAiB,CAE5B;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,YAAY,GAClB,KAAK,IAAI,oBAAoB,CAE/B;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,YAAY,GAClB,KAAK,IAAI,kBAAkB,CAE7B"}

package/dist/runtime/controls/types.js

@@ -0,0 +1,18 @@
+/**
+ * Runtime control plane — ControlEvent contracts (Frontier upgrade, PHASE 2).
+ *
+ * Typed events an external controller (headless stdin bridge, Desktop, tests)
+ * can enqueue while a run is in flight. Steers/follow-ups are consumed by the
+ * SteeringObserver at safe turn boundaries; cancel/pause/resume are carried
+ * as data so higher layers can map them onto cooperative cancellation.
+ */
+export function isSteerControlEvent(event) {
+    return event.type === 'steer';
+}
+export function isFollowUpControlEvent(event) {
+    return event.type === 'follow_up';
+}
+export function isCancelControlEvent(event) {
+    return event.type === 'cancel';
+}
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/runtime/controls/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA4CH,MAAM,UAAU,mBAAmB,CACjC,KAAmB;IAEnB,OAAO,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,KAAmB;IAEnB,OAAO,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,KAAmB;IAEnB,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC;AACjC,CAAC"}

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

@@ -0,0 +1,41 @@
+import type { AgentObserver, ObserverResult, ToolCallEvent } from '../observers/types.js';
+/** Tools whose primary argument is a search query / target path. */
+export declare const SEARCH_TOOLS: ReadonlySet<string>;
+export declare function isSearchTool(tool: string): boolean;
+/** Lowercase, strip punctuation noise, collapse whitespace, cap length. */
+export declare function normalizeQuery(text: string): string;
+/** Jaccard similarity of the token sets of two normalized queries. */
+export declare function queryJaccard(a: string, b: string): number;
+export interface SearchQueryRef {
+    /** Same-scope bucket: duplicates are only counted within a scope. */
+    scope: string;
+    /** Normalized query text compared for near-duplicates. */
+    query: string;
+}
+/** Extract the comparable (scope, query) pair for a search-family call. */
+export declare function extractSearchQuery(toolName: string, args: unknown): SearchQueryRef | undefined;
+export interface DuplicateSearchGuardConfig {
+    /** Inject a refine message at this many near-duplicate calls (default 2). */
+    warnAfter?: number;
+    /** Stop the run at this many near-duplicate calls (default 5). */
+    stopAfter?: number;
+    /** Token-set similarity above which two queries are duplicates (0–1, default 0.8). */
+    similarityThreshold?: number;
+    /** Recent queries kept per scope bucket for comparison (default 8). */
+    window?: number;
+    /** Maximum scope buckets retained (FIFO eviction, default 256). */
+    maxBuckets?: number;
+}
+export declare class DuplicateSearchGuard implements AgentObserver {
+    private readonly buckets;
+    private readonly warnAfter;
+    private readonly stopAfter;
+    private readonly similarityThreshold;
+    private readonly window;
+    private readonly maxBuckets;
+    constructor(config?: DuplicateSearchGuardConfig);
+    onToolCall(event: ToolCallEvent): Promise<ObserverResult>;
+    reset(): void;
+    private evictIfNeeded;
+}
+//# sourceMappingURL=DuplicateSearchGuard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DuplicateSearchGuard.d.ts","sourceRoot":"","sources":["../../../src/runtime/guards/DuplicateSearchGuard.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,aAAa,EACd,MAAM,uBAAuB,CAAC;AAE/B,oEAAoE;AACpE,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,MAAM,CAK3C,CAAC;AAEH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElD;AAED,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOnD;AAED,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CASzD;AAED,MAAM,WAAW,cAAc;IAC7B,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;CACf;AAED,2EAA2E;AAC3E,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,GACZ,cAAc,GAAG,SAAS,CAgC5B;AAED,MAAM,WAAW,0BAA0B;IACzC,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sFAAsF;IACtF,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAYD,qBAAa,oBAAqB,YAAW,aAAa;IACxD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAC1D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,MAAM,GAAE,0BAA+B;IAQ7C,UAAU,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAwC/D,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,aAAa;CAOtB"}

package/dist/runtime/guards/DuplicateSearchGuard.js

@@ -0,0 +1,150 @@
+/**
+ * DuplicateSearchGuard — detect repeated or near-identical search queries
+ * (Frontier upgrade, PHASE 1B §16).
+ *
+ * RepetitionGuard catches *identical* calls of any tool; this guard adds
+ * query-level awareness for the search family: the same query — or a
+ * cosmetically different one — in the same scope counts as a duplicate even
+ * when irrelevant args (limits, depth, key order) differ.
+ */
+import { CONTINUE } from '../observers/types.js';
+/** Tools whose primary argument is a search query / target path. */
+export const SEARCH_TOOLS = new Set([
+    'grep_content',
+    'semantic_search',
+    'web_search',
+    'list_files',
+]);
+export function isSearchTool(tool) {
+    return SEARCH_TOOLS.has(tool);
+}
+/** Lowercase, strip punctuation noise, collapse whitespace, cap length. */
+export function normalizeQuery(text) {
+    return text
+        .toLowerCase()
+        .replace(/[.,;:!?()"'`—–…]+/g, ' ')
+        .replace(/\s+/g, ' ')
+        .trim()
+        .slice(0, 512);
+}
+/** Jaccard similarity of the token sets of two normalized queries. */
+export function queryJaccard(a, b) {
+    const ta = new Set(a.split(' ').filter(Boolean));
+    const tb = new Set(b.split(' ').filter(Boolean));
+    if (ta.size === 0 && tb.size === 0)
+        return 1;
+    if (ta.size === 0 || tb.size === 0)
+        return 0;
+    let intersection = 0;
+    for (const token of ta)
+        if (tb.has(token))
+            intersection++;
+    const union = ta.size + tb.size - intersection;
+    return union === 0 ? 0 : intersection / union;
+}
+/** Extract the comparable (scope, query) pair for a search-family call. */
+export function extractSearchQuery(toolName, args) {
+    if (!isSearchTool(toolName))
+        return undefined;
+    const a = (args ?? {});
+    switch (toolName) {
+        case 'grep_content': {
+            if (typeof a.pattern !== 'string' || a.pattern.trim() === '')
+                return undefined;
+            const include = Array.isArray(a.include)
+                ? a.include.join(',')
+                : typeof a.include === 'string'
+                    ? a.include
+                    : '';
+            return {
+                scope: [
+                    typeof a.path === 'string' ? a.path : '',
+                    include,
+                ].join('\u0000'),
+                query: normalizeQuery(a.pattern),
+            };
+        }
+        case 'semantic_search':
+        case 'web_search': {
+            if (typeof a.query !== 'string' || a.query.trim() === '')
+                return undefined;
+            return { scope: '', query: normalizeQuery(a.query) };
+        }
+        case 'list_files': {
+            if (typeof a.path !== 'string' || a.path.trim() === '')
+                return undefined;
+            // Depth changes the returned tree, so it belongs to the scope.
+            return { scope: String(a.maxDepth ?? ''), query: normalizeQuery(a.path) };
+        }
+        default:
+            return undefined;
+    }
+}
+const REFINE_MESSAGE = [
+    'Search queries are being repeated with only cosmetic differences in the same scope.',
+    'Reuse the results already in context, or change the query/scope meaningfully.',
+].join('\n');
+export class DuplicateSearchGuard {
+    buckets = new Map();
+    warnAfter;
+    stopAfter;
+    similarityThreshold;
+    window;
+    maxBuckets;
+    constructor(config = {}) {
+        this.warnAfter = config.warnAfter ?? 2;
+        this.stopAfter = config.stopAfter ?? 5;
+        this.similarityThreshold = config.similarityThreshold ?? 0.8;
+        this.window = config.window ?? 8;
+        this.maxBuckets = config.maxBuckets ?? 256;
+    }
+    async onToolCall(event) {
+        const ref = extractSearchQuery(event.toolName, event.args);
+        if (!ref)
+            return CONTINUE;
+        const key = `${event.toolName}\u0000${ref.scope}`;
+        let bucket = this.buckets.get(key);
+        if (!bucket) {
+            bucket = { recent: [], duplicateCount: 0 };
+            this.buckets.set(key, bucket);
+            this.evictIfNeeded();
+        }
+        let best = 0;
+        for (const previous of bucket.recent) {
+            best = Math.max(best, queryJaccard(previous, ref.query));
+        }
+        bucket.duplicateCount = best >= this.similarityThreshold
+            ? bucket.duplicateCount + 1
+            : 1;
+        bucket.recent.push(ref.query);
+        if (bucket.recent.length > this.window)
+            bucket.recent.shift();
+        if (bucket.duplicateCount >= this.stopAfter) {
+            return {
+                action: 'stop',
+                reason: `near-duplicate search queries for "${event.toolName}" ` +
+                    `${bucket.duplicateCount} times in the same scope`,
+                code: 'duplicate_search',
+            };
+        }
+        if (bucket.duplicateCount >= this.warnAfter) {
+            return {
+                action: 'inject',
+                message: { role: 'user', kind: 'runtime-warning', content: REFINE_MESSAGE },
+            };
+        }
+        return CONTINUE;
+    }
+    reset() {
+        this.buckets.clear();
+    }
+    evictIfNeeded() {
+        while (this.buckets.size > this.maxBuckets) {
+            const oldest = this.buckets.keys().next().value;
+            if (oldest === undefined)
+                break;
+            this.buckets.delete(oldest);
+        }
+    }
+}
+//# sourceMappingURL=DuplicateSearchGuard.js.map

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

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

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

@@ -0,0 +1,34 @@
+import type { AgentObserver, ObserverResult, ToolCallEvent, ToolResultEvent } from '../observers/types.js';
+export interface FailureSignature {
+    commandHash: string;
+    exitCode?: number;
+    normalizedTailHash: string;
+}
+export interface FailureSignatureGuardConfig {
+    /** Inject a reassessment message at this many identical failures (default 2). */
+    warnAfter?: number;
+    /** Stop the run at this many identical failures (default 5). */
+    stopAfter?: number;
+    /** How many chars of normalized output tail feed the hash (default 2000). */
+    tailChars?: number;
+}
+export declare function stripAnsi(text: string): string;
+/**
+ * Normalize a failure-output tail: replace volatile tokens with stable
+ * placeholders and drop pure progress lines, so identical root failures map
+ * to identical text.
+ */
+export declare function normalizeFailureTail(text: string, tailChars?: number): string;
+export declare class FailureSignatureGuard implements AgentObserver {
+    private readonly counts;
+    private readonly pendingArgs;
+    private readonly warnAfter;
+    private readonly stopAfter;
+    private readonly tailChars;
+    constructor(config?: FailureSignatureGuardConfig);
+    /** Track per-call command hashes so onToolResult can bind args → result. */
+    onToolCall(event: ToolCallEvent): Promise<ObserverResult>;
+    onToolResult(event: ToolResultEvent): Promise<ObserverResult>;
+    reset(): void;
+}
+//# sourceMappingURL=FailureSignatureGuard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FailureSignatureGuard.d.ts","sourceRoot":"","sources":["../../../src/runtime/guards/FailureSignatureGuard.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,aAAa,EACb,eAAe,EAChB,MAAM,uBAAuB,CAAC;AAG/B,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,2BAA2B;IAC1C,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAYD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAO,GAAG,MAAM,CA4B3E;AA0BD,qBAAa,qBAAsB,YAAW,aAAa;IACzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;IACzD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,MAAM,GAAE,2BAAgC;IAMpD,4EAA4E;IACtE,UAAU,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAUzD,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAuCnE,KAAK,IAAI,IAAI;CAId"}

package/dist/runtime/guards/FailureSignatureGuard.js

@@ -0,0 +1,143 @@
+/**
+ * FailureSignatureGuard — detect the same test/build failure recurring after
+ * multiple attempts (Frontier upgrade, PHASE 1B).
+ *
+ * The agent may edit different files yet `npm test` keeps failing with the
+ * same error. Fingerprinting the *command* alone is not enough; this guard
+ * hashes the command together with a normalized tail of the failure output so
+ * that volatile noise (timestamps, durations, PIDs, UUIDs, temp paths,
+ * progress lines) does not mask an identical failure.
+ *
+ * Reaction: inject a root-cause reassessment message at `warnAfter` identical
+ * failure signatures, stop the run at `stopAfter`. A later *successful* run of
+ * the same command clears its counters.
+ */
+import { createHash } from 'node:crypto';
+import { stableStringify } from '../../core/requestSnapshot.js';
+import { CONTINUE } from '../observers/types.js';
+import { toolCallFingerprint } from './RepetitionGuard.js';
+export function stripAnsi(text) {
+    return text.replace(/\u001b\[[0-9;]*[A-Za-z]/g, '');
+}
+/**
+ * Normalize a failure-output tail: replace volatile tokens with stable
+ * placeholders and drop pure progress lines, so identical root failures map
+ * to identical text.
+ */
+export function normalizeFailureTail(text, tailChars = 2000) {
+    const tail = stripAnsi(text).slice(-tailChars);
+    const lines = tail.split(/\r?\n/).map((line) => line
+        // ISO timestamps and wall-clock times
+        .replace(/\d{4}-\d{2}-\d{2}[T ]\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:?\d{2})?/g, '<ts>')
+        .replace(/\b\d{1,2}:\d{2}:\d{2}(\.\d+)?\b/g, '<time>')
+        // durations
+        .replace(/\b\d+(\.\d+)?\s*(ms|s|sec|secs|seconds|min|mins|minutes)\b/gi, '<dur>')
+        // UUIDs
+        .replace(/\b[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\b/gi, '<uuid>')
+        // PIDs
+        .replace(/\b(?:pid|process)\s*[:=]?\s*\d+\b/gi, '<pid>')
+        // temp paths (posix + windows)
+        .replace(/(?:\/tmp\/|\/var\/tmp\/|\b[A-Za-z]:\\Users\\[^\\]*\\AppData\\Local\\Temp\\)[^\s"']*/gi, '<tmp>'));
+    const meaningful = lines.filter((line) => {
+        const trimmed = line.trim();
+        if (!trimmed)
+            return false;
+        // success/progress glyphs (✓ ✔ ● ○ ◐ ◑ ◌) mark progress lines — drop;
+        // failure glyphs (✗ ✘ ×) are kept: they carry failure information.
+        if (/^\s*[✓✔●○◐◑◌]/.test(line))
+            return false;
+        // pure spinner / counter lines
+        if (/^\s*[|/\\-–—]\s*$/.test(line))
+            return false;
+        if (/^\s*\d+\s*\/\s*\d+\s*$/.test(line))
+            return false;
+        return true;
+    });
+    return meaningful.join('\n');
+}
+/** Extract { exitCode, text } from an unknown tool result, if shape known. */
+function extractFailure(result) {
+    if (typeof result === 'string')
+        return { text: result };
+    if (result && typeof result === 'object') {
+        const r = result;
+        const parts = [r.stdout, r.stderr, r.output, r.content, r.message]
+            .filter((p) => typeof p === 'string');
+        if (typeof r.exitCode === 'number' || parts.length > 0) {
+            return { exitCode: r.exitCode, text: parts.join('\n') };
+        }
+        return { text: stableStringify(result).slice(0, 4000) };
+    }
+    return undefined;
+}
+const REASSESS_MESSAGE = [
+    'The same failure signature has persisted across multiple attempts.',
+    'Do not repeat the previous edit strategy. Re-evaluate the root cause,',
+    'inspect upstream state, or delegate a fresh verification/exploration task.',
+].join('\n');
+/** Cap on remembered pending tool-call args (FIFO beyond this). */
+const MAX_PENDING = 256;
+export class FailureSignatureGuard {
+    counts = new Map();
+    pendingArgs = new Map();
+    warnAfter;
+    stopAfter;
+    tailChars;
+    constructor(config = {}) {
+        this.warnAfter = config.warnAfter ?? 2;
+        this.stopAfter = config.stopAfter ?? 5;
+        this.tailChars = config.tailChars ?? 2000;
+    }
+    /** Track per-call command hashes so onToolResult can bind args → result. */
+    async onToolCall(event) {
+        const { argsHash } = toolCallFingerprint(event.toolName, event.args);
+        if (this.pendingArgs.size >= MAX_PENDING) {
+            const oldest = this.pendingArgs.keys().next().value;
+            if (oldest !== undefined)
+                this.pendingArgs.delete(oldest);
+        }
+        this.pendingArgs.set(event.toolCallId, `${event.toolName}\u0000${argsHash}`);
+        return CONTINUE;
+    }
+    async onToolResult(event) {
+        const commandHash = this.pendingArgs.get(event.toolCallId) ?? event.toolName;
+        this.pendingArgs.delete(event.toolCallId);
+        const failure = extractFailure(event.result);
+        if (!failure || !failure.text.trim())
+            return CONTINUE;
+        const failed = failure.exitCode !== undefined ? failure.exitCode !== 0 : event.ok === false;
+        if (!failed) {
+            // The command succeeded — clear any accumulated failure counts for it.
+            for (const key of this.counts.keys()) {
+                if (key.startsWith(`${commandHash}\u0000`))
+                    this.counts.delete(key);
+            }
+            return CONTINUE;
+        }
+        const tailHash = createHash('sha256')
+            .update(normalizeFailureTail(failure.text, this.tailChars))
+            .digest('hex');
+        const key = `${commandHash}\u0000${failure.exitCode ?? 'x'}\u0000${tailHash}`;
+        const count = (this.counts.get(key) ?? 0) + 1;
+        this.counts.set(key, count);
+        if (count >= this.stopAfter) {
+            return {
+                action: 'stop',
+                reason: `same failure signature (exit ${failure.exitCode ?? 'n/a'}) recurred ${count} times after edits`,
+                code: 'repeated_failure',
+            };
+        }
+        if (count >= this.warnAfter) {
+            return {
+                action: 'inject',
+                message: { role: 'user', kind: 'runtime-warning', content: REASSESS_MESSAGE },
+            };
+        }
+        return CONTINUE;
+    }
+    reset() {
+        this.counts.clear();
+        this.pendingArgs.clear();
+    }
+}
+//# sourceMappingURL=FailureSignatureGuard.js.map

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

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

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

@@ -0,0 +1,23 @@
+import type { AgentObserver, ObserverResult, ToolCallEvent, TurnEndEvent } from '../observers/types.js';
+/** Tools whose execution changes repository state. */
+export declare const FILE_WRITING_TOOLS: ReadonlySet<string>;
+export interface NoProgressGuardConfig {
+    /** Consecutive unproductive turns before the inject warning (default 2). */
+    softStallTurns?: number;
+    /** Consecutive unproductive turns before the stop (default 5). */
+    hardStallTurns?: number;
+}
+export declare class NoProgressGuard implements AgentObserver {
+    private readonly seenFingerprints;
+    private readonly soft;
+    private readonly hard;
+    private stallTurns;
+    private turnToolCalls;
+    private turnWrites;
+    private turnNewFingerprints;
+    constructor(config?: NoProgressGuardConfig);
+    onToolCall(event: ToolCallEvent): Promise<ObserverResult>;
+    onTurnEnd(_event: TurnEndEvent): Promise<ObserverResult>;
+    reset(): void;
+}
+//# sourceMappingURL=NoProgressGuard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NoProgressGuard.d.ts","sourceRoot":"","sources":["../../../src/runtime/guards/NoProgressGuard.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,aAAa,EACb,YAAY,EACb,MAAM,uBAAuB,CAAC;AAG/B,sDAAsD;AACtD,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAIjD,CAAC;AAEH,MAAM,WAAW,qBAAqB;IACpC,4EAA4E;IAC5E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kEAAkE;IAClE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAOD,qBAAa,eAAgB,YAAW,aAAa;IACnD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAqB;IACtD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,mBAAmB,CAAK;gBAEpB,MAAM,GAAE,qBAA0B;IAKxC,UAAU,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAazD,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC;IA2B9D,KAAK,IAAI,IAAI;CAOd"}