@moxxy/sdk 0.14.2 → 0.14.4

package/dist/mode/project-messages.js

@@ -0,0 +1,392 @@
+import { computeElisionState, conversationalStub, conversationalStubbed, toolResultBytes, toolResultStub, toolResultStubbed, } from '../elision-state.js';
+import { isToolDisplayResult } from '../tool-display.js';
+/** Appended to the system prompt while elision is active (see projection). */
+export const ELISION_SYSTEM_NOTE = 'Context note: to stay within budget, older turns may appear as stubs like ' +
+    '`[output elided — recall("id") to view]` or `[elided user turn · recall({ seq: N })]`. ' +
+    'These are NOT the real content — call the `recall` tool with the given id/seq to fetch ' +
+    'the full text before relying on any detail from an elided turn. Recent turns are always ' +
+    'shown verbatim.';
+/**
+ * Compose a model-facing system prompt that includes any base prompt
+ * plus a COMPACT skill index (name + description + triggers only).
+ *
+ * Lazy-loading design: the body is intentionally NOT inlined. The model
+ * matches user intent against the description/triggers, then calls the
+ * `load_skill` tool to fetch the body of the skill it picked. This keeps
+ * the system prompt small even with many skills installed and avoids
+ * paying for skill bodies the model never actually follows.
+ */
+export function buildSystemPromptWithSkills(baseSystemPrompt, skills) {
+    if (skills.length === 0)
+        return baseSystemPrompt;
+    const header = `## Available skills\n\n` +
+        `Each line below is a pre-authored playbook for a specific intent. ` +
+        `When the user's request matches one of these (by name, description, ` +
+        `or triggers), call \`load_skill({ name: "<skill-name>" })\` FIRST to ` +
+        `fetch the full instructions, then follow them verbatim. Prefer using ` +
+        `a skill over re-deriving the workflow with ad-hoc tools.\n`;
+    const entries = skills
+        .map((s) => {
+        const fm = s.frontmatter;
+        const triggerHint = fm.triggers?.length
+            ? ` (triggers: ${fm.triggers.map((t) => `"${t}"`).join(', ')})`
+            : '';
+        return `- **${fm.name}** — ${fm.description}${triggerHint}`;
+    })
+        .join('\n');
+    const skillBlock = `${header}\n${entries}`;
+    return baseSystemPrompt ? `${baseSystemPrompt}\n\n${skillBlock}` : skillBlock;
+}
+function activeCompactionRanges(events) {
+    return events
+        .filter((event) => event.type === 'compaction' &&
+        event.tokensSaved > 0 &&
+        event.summary.trim().length > 0 &&
+        event.replacedRange[0] <= event.replacedRange[1])
+        .map((event) => ({
+        from: event.replacedRange[0],
+        to: event.replacedRange[1],
+        summary: event.summary,
+    }));
+}
+function eventInCompactionRange(seq, ranges) {
+    for (const range of ranges) {
+        if (seq >= range.from && seq <= range.to)
+            return range;
+    }
+    return null;
+}
+/**
+ * A compaction lookup that answers "which range (if any) contains `seq`" in
+ * O(log ranges) instead of {@link eventInCompactionRange}'s O(ranges) linear
+ * scan per event. Compaction ranges are non-overlapping ascending seq prefixes,
+ * so a seq belongs to at most one range and binary search over the
+ * sorted-by-`from` array returns the SAME range the linear first-match did —
+ * byte-identical projection.
+ *
+ * Defensive fallback: if the ranges are NOT strictly non-overlapping (which the
+ * compaction invariant forbids, but a hand-crafted/corrupt log could violate),
+ * we keep the exact linear first-match semantics so the projection can never
+ * diverge from the old code.
+ */
+function makeCompactionLookup(ranges) {
+    if (ranges.length === 0)
+        return () => null;
+    if (ranges.length === 1) {
+        const only = ranges[0];
+        return (seq) => (seq >= only.from && seq <= only.to ? only : null);
+    }
+    // Sort a copy by `from` (stable enough — ranges are non-overlapping). Verify
+    // the non-overlap invariant on the sorted copy; only then is binary search
+    // provably equivalent to the linear first-match.
+    const sorted = [...ranges].sort((a, b) => a.from - b.from);
+    let nonOverlapping = true;
+    for (let i = 1; i < sorted.length; i++) {
+        if (sorted[i].from <= sorted[i - 1].to) {
+            nonOverlapping = false;
+            break;
+        }
+    }
+    if (!nonOverlapping)
+        return (seq) => eventInCompactionRange(seq, ranges);
+    return (seq) => {
+        // Largest `from <= seq`, then a single containment check.
+        let lo = 0;
+        let hi = sorted.length - 1;
+        let cand = -1;
+        while (lo <= hi) {
+            const mid = (lo + hi) >> 1;
+            if (sorted[mid].from <= seq) {
+                cand = mid;
+                lo = mid + 1;
+            }
+            else {
+                hi = mid - 1;
+            }
+        }
+        if (cand < 0)
+            return null;
+        const range = sorted[cand];
+        return seq <= range.to ? range : null;
+    };
+}
+/**
+ * Pure projection of a single `user_prompt` event to its content blocks.
+ *
+ * Extracted from {@link projectMessages} as an independently testable sub-step
+ * (u123-5). Returns either the collapsed stub (when the event is an elided
+ * conversational turn) or the full text + attachment-expanded blocks — exactly
+ * what the inline switch arm produced. Caller decides how to wrap it as a
+ * message / record the stable prefix.
+ */
+export function projectUserPrompt(event, el) {
+    // Elided + conversational: collapse to a stub (anchor/tiny kept full).
+    if (conversationalStubbed(event, el)) {
+        return [{ type: 'text', text: conversationalStub('user', event.seq) }];
+    }
+    const blocks = [{ type: 'text', text: event.text }];
+    if (event.attachments) {
+        for (const att of event.attachments) {
+            if (att.kind === 'image') {
+                blocks.push({
+                    type: 'image',
+                    mediaType: att.mediaType ?? 'image/png',
+                    data: att.content,
+                });
+            }
+            else if (att.kind === 'document') {
+                blocks.push({
+                    type: 'document',
+                    mediaType: att.mediaType ?? 'application/pdf',
+                    data: att.content,
+                    ...(att.name ? { name: att.name } : {}),
+                });
+            }
+            else {
+                blocks.push({
+                    type: 'text',
+                    text: `[${att.kind}${att.name ? ` ${att.name}` : ''}]\n${att.content}`,
+                });
+            }
+        }
+    }
+    return blocks;
+}
+/**
+ * Precompute the set of callIds that have a matching tool_result (or
+ * tool_call_denied) somewhere in the log. Used to synthesize a fallback
+ * `[interrupted]` tool_result for orphan tool_use blocks when the assistant
+ * message gets flushed.
+ *
+ * Without this fallback the provider rejects the whole conversation with
+ * "assistant message with 'tool_calls' must be followed by tool messages
+ * responding to each 'tool_call_id'". Orphans typically appear after a
+ * cancelled turn, an aborted process, or a tool exception that bypassed the
+ * loop's tool_result emit path.
+ *
+ * Extracted as a pure precompute (u123-5); returns a fresh mutable Set the
+ * projection augments as it synthesizes orphan results (so a repeated orphan
+ * across groups is only emitted once).
+ */
+export function resolvedCallIdSet(events) {
+    const resolvedCallIds = new Set();
+    for (const e of events) {
+        if (e.type === 'tool_result' || e.type === 'tool_call_denied') {
+            resolvedCallIds.add(e.callId);
+        }
+    }
+    return resolvedCallIds;
+}
+export function projectMessagesFromLog(ctx, opts = {}) {
+    return projectMessages(ctx, opts).messages;
+}
+/**
+ * Same projection as {@link projectMessagesFromLog} but also reports the
+ * stable-prefix boundary so the active cache strategy can place a cross-turn
+ * breakpoint. Modes that build messages this way should thread the returned
+ * `stablePrefixIndex` into {@link collectProviderStream}.
+ */
+export function projectMessages(ctx, opts = {}) {
+    const allEvents = ctx.log.slice();
+    const compactions = activeCompactionRanges(allEvents);
+    const compactionFor = makeCompactionLookup(compactions);
+    const emittedCompactions = new Set();
+    const el = computeElisionState(allEvents);
+    const messages = [];
+    // The stable prefix is every message produced from events at/below the
+    // elision HWM. Record the latest such message index as we push.
+    let stablePrefixIndex = -1;
+    const recordStable = (maxSeq) => {
+        if (el.hwm >= 0 && maxSeq >= 0 && maxSeq <= el.hwm) {
+            stablePrefixIndex = messages.length - 1;
+        }
+    };
+    if (opts.systemPrompt) {
+        // When elision is active, tell the model that older turns may be shown as
+        // stubs and how to expand them — so it recalls instead of hallucinating.
+        // Constant text → busts the system cache once (when elision starts), stable
+        // thereafter.
+        const sysText = el.hwm >= 0 ? `${opts.systemPrompt}\n\n${ELISION_SYSTEM_NOTE}` : opts.systemPrompt;
+        messages.push({ role: 'system', content: [{ type: 'text', text: sysText }] });
+    }
+    // Pre-scan: build the set of callIds that have a matching tool_result
+    // (or tool_call_denied) somewhere in the log. Used to synthesize a
+    // fallback `[interrupted]` tool_result for orphan tool_use blocks
+    // when the assistant message gets flushed.
+    const resolvedCallIds = resolvedCallIdSet(allEvents);
+    let pendingAssistant = null;
+    let pendingAssistantMaxSeq = -1;
+    // Reasoning block awaiting attachment to the current assistant turn. Only set
+    // for REPLAYABLE reasoning (Anthropic signature / redacted-or-Codex encrypted
+    // blob) — render-only reasoning is never sent back. Attached as content[0] of
+    // the turn's assistant message (Anthropic requires the signed thinking block
+    // first on an interleaved-thinking tool-use continuation; a missing/unsigned
+    // one is a hard 400). Dropped at any turn/compaction boundary it doesn't reach.
+    let pendingReasoning = null;
+    let pendingReasoningSeq = -1;
+    const flush = () => {
+        if (!pendingAssistant)
+            return;
+        const flushed = pendingAssistant;
+        const groupMaxSeq = pendingAssistantMaxSeq;
+        pendingAssistant = null;
+        pendingAssistantMaxSeq = -1;
+        messages.push(flushed);
+        recordStable(groupMaxSeq);
+        // Synthesize fallback tool_result messages for any tool_use blocks
+        // whose callId never resolved in the event log. Has to land
+        // immediately after the assistant message (and before any
+        // subsequent user_prompt / assistant_message) so the provider sees
+        // a clean assistant→tool-result chain.
+        for (const block of flushed.content) {
+            if (block.type === 'tool_use' && !resolvedCallIds.has(block.id)) {
+                messages.push({
+                    role: 'tool_result',
+                    content: [
+                        {
+                            type: 'tool_result',
+                            toolUseId: block.id,
+                            content: '[tool call did not return a result — possibly interrupted or cancelled]',
+                            isError: true,
+                        },
+                    ],
+                });
+                recordStable(groupMaxSeq);
+                // Mark synthesized so we don't double-emit if the same orphan
+                // appears in multiple groups (defensive — shouldn't normally
+                // happen since each tool_call_requested has a unique callId).
+                resolvedCallIds.add(block.id);
+            }
+        }
+    };
+    for (const e of allEvents) {
+        const compaction = compactionFor(e.seq);
+        if (compaction) {
+            if (!emittedCompactions.has(compaction)) {
+                emittedCompactions.add(compaction);
+                flush();
+                pendingReasoning = null;
+                messages.push({
+                    role: 'user',
+                    content: [{ type: 'text', text: `[summary of earlier turns]\n${compaction.summary}` }],
+                });
+                recordStable(compaction.to);
+            }
+            continue;
+        }
+        switch (e.type) {
+            case 'user_prompt': {
+                flush();
+                pendingReasoning = null;
+                messages.push({ role: 'user', content: projectUserPrompt(e, el) });
+                recordStable(e.seq);
+                break;
+            }
+            case 'reasoning_message': {
+                // Render-only reasoning (no signature/encrypted) is never replayed —
+                // it exists only for the live/scrollback "Thinking" view. Replayable
+                // reasoning is stashed for content[0] of this turn's assistant message.
+                if (e.signature || e.encrypted) {
+                    pendingReasoning = {
+                        type: 'reasoning',
+                        text: e.content,
+                        ...(e.signature ? { signature: e.signature } : {}),
+                        ...(e.redacted ? { redacted: true } : {}),
+                        ...(e.encrypted ? { encrypted: e.encrypted } : {}),
+                    };
+                    pendingReasoningSeq = e.seq;
+                }
+                break;
+            }
+            case 'assistant_message':
+                flush();
+                if (conversationalStubbed(e, el)) {
+                    pendingReasoning = null;
+                    messages.push({
+                        role: 'assistant',
+                        content: [{ type: 'text', text: conversationalStub('assistant', e.seq) }],
+                    });
+                    recordStable(e.seq);
+                    break;
+                }
+                // A tool-only turn can log an assistant_message with empty content
+                // (end_turn + tool calls, no prose). Projecting it as an empty text
+                // block makes some providers (Anthropic) reject the NEXT request and
+                // permanently wedges the session. Skip the block — the turn's
+                // tool_use blocks are projected from tool_call_requested events —
+                // which also un-wedges historical logs that already contain one.
+                if (e.content.trim().length === 0) {
+                    pendingReasoning = null;
+                    recordStable(e.seq);
+                    break;
+                }
+                {
+                    const content = [];
+                    if (pendingReasoning) {
+                        content.push(pendingReasoning);
+                        pendingReasoning = null;
+                    }
+                    content.push({ type: 'text', text: e.content });
+                    messages.push({ role: 'assistant', content });
+                }
+                recordStable(e.seq);
+                break;
+            case 'tool_call_requested': {
+                if (!pendingAssistant) {
+                    // Seed the assistant turn so the signed reasoning block is content[0],
+                    // ahead of every tool_use (Anthropic's interleaved-thinking ordering).
+                    pendingAssistant = { role: 'assistant', content: pendingReasoning ? [pendingReasoning] : [] };
+                    if (pendingReasoning) {
+                        pendingAssistantMaxSeq = Math.max(pendingAssistantMaxSeq, pendingReasoningSeq);
+                        pendingReasoning = null;
+                    }
+                }
+                pendingAssistantMaxSeq = Math.max(pendingAssistantMaxSeq, e.seq);
+                pendingAssistant.content.push({
+                    type: 'tool_use',
+                    id: e.callId,
+                    name: e.name,
+                    input: e.input,
+                });
+                break;
+            }
+            case 'tool_result': {
+                flush();
+                // Stub bulky old tool output to a recall-able marker (decision shared
+                // with estimateContextTokens via toolResultStubbed).
+                let text;
+                if (toolResultStubbed(e, el)) {
+                    const recalled = el.recalledCallIds.has(e.callId) || el.recalledSeqs.has(e.seq);
+                    text = toolResultStub(e.callId, toolResultBytes(e.output), recalled);
+                }
+                else if (e.error) {
+                    text = `[error:${e.error.kind}] ${e.error.message}`;
+                }
+                else if (isToolDisplayResult(e.output)) {
+                    // Rich result (e.g. a file diff): the model only needs the short
+                    // `forModel` summary — the structured `display` is for channels.
+                    text = e.output.forModel;
+                }
+                else {
+                    text = typeof e.output === 'string' ? e.output : JSON.stringify(e.output ?? '');
+                }
+                messages.push({
+                    role: 'tool_result',
+                    content: [{ type: 'tool_result', toolUseId: e.callId, content: text, isError: !e.ok }],
+                });
+                recordStable(e.seq);
+                break;
+            }
+            default:
+                break;
+        }
+    }
+    flush();
+    if (opts.trailingUserText) {
+        // The trailing step nudge is volatile (changes per step), never part of
+        // the stable prefix — don't record it.
+        messages.push({ role: 'user', content: [{ type: 'text', text: opts.trailingUserText }] });
+    }
+    return { messages, stablePrefixIndex };
+}
+//# sourceMappingURL=project-messages.js.map

package/dist/mode/project-messages.js.map

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

package/dist/mode/single-shot.d.ts

@@ -0,0 +1,17 @@
+import type { ProviderMessage } from '../provider.js';
+import type { ModeContext } from '../mode.js';
+/**
+ * Run a single-shot (no-tools) provider turn — the shape every planner /
+ * synthesis phase shares. Runs context management (compaction + elision),
+ * emits the `provider_request` bookend, streams the response with tools
+ * disabled, then emits either an `error` event (returning `null`) or the
+ * `provider_response` bookend (returning the collected text).
+ *
+ * Replaces the ~40-line block each mode phase used to inline; centralizing it
+ * keeps event emission uniform and means a fix here (e.g. always running
+ * elision) lands for every loop strategy at once.
+ */
+export declare function runSingleShotTurn(ctx: ModeContext, messages: ReadonlyArray<ProviderMessage>, opts?: {
+    maxTokens?: number;
+}): Promise<string | null>;
+//# sourceMappingURL=single-shot.d.ts.map

package/dist/mode/single-shot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"single-shot.d.ts","sourceRoot":"","sources":["../../src/mode/single-shot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAM9C;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,WAAW,EAChB,QAAQ,EAAE,aAAa,CAAC,eAAe,CAAC,EACxC,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAChC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAwCxB"}

package/dist/mode/single-shot.js

@@ -0,0 +1,53 @@
+import { runCompactionIfNeeded } from '../compactor-helpers.js';
+import { runElisionIfNeeded } from '../elision-helpers.js';
+import { usageEventFields } from '../token-accounting.js';
+import { collectProviderStream } from './collect-stream.js';
+/**
+ * Run a single-shot (no-tools) provider turn — the shape every planner /
+ * synthesis phase shares. Runs context management (compaction + elision),
+ * emits the `provider_request` bookend, streams the response with tools
+ * disabled, then emits either an `error` event (returning `null`) or the
+ * `provider_response` bookend (returning the collected text).
+ *
+ * Replaces the ~40-line block each mode phase used to inline; centralizing it
+ * keeps event emission uniform and means a fix here (e.g. always running
+ * elision) lands for every loop strategy at once.
+ */
+export async function runSingleShotTurn(ctx, messages, opts = {}) {
+    await runCompactionIfNeeded(ctx);
+    await runElisionIfNeeded(ctx);
+    await ctx.emit({
+        type: 'provider_request',
+        sessionId: ctx.sessionId,
+        turnId: ctx.turnId,
+        source: 'system',
+        provider: ctx.provider.name,
+        model: ctx.model,
+    });
+    const { text, usage, error } = await collectProviderStream(ctx, messages, {
+        includeTools: false,
+        ...(opts.maxTokens !== undefined ? { maxTokens: opts.maxTokens } : {}),
+    });
+    if (error) {
+        await ctx.emit({
+            type: 'error',
+            sessionId: ctx.sessionId,
+            turnId: ctx.turnId,
+            source: 'system',
+            kind: error.retryable ? 'retryable' : 'fatal',
+            message: error.message,
+        });
+        return null;
+    }
+    await ctx.emit({
+        type: 'provider_response',
+        sessionId: ctx.sessionId,
+        turnId: ctx.turnId,
+        source: 'system',
+        provider: ctx.provider.name,
+        model: ctx.model,
+        ...usageEventFields(usage),
+    });
+    return text;
+}
+//# sourceMappingURL=single-shot.js.map

package/dist/mode/single-shot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"single-shot.js","sourceRoot":"","sources":["../../src/mode/single-shot.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,GAAgB,EAChB,QAAwC,EACxC,OAA+B,EAAE;IAEjC,MAAM,qBAAqB,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAE9B,MAAM,GAAG,CAAC,IAAI,CAAC;QACb,IAAI,EAAE,kBAAkB;QACxB,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,IAAI;QAC3B,KAAK,EAAE,GAAG,CAAC,KAAK;KACjB,CAAC,CAAC;IAEH,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,MAAM,qBAAqB,CAAC,GAAG,EAAE,QAAQ,EAAE;QACxE,YAAY,EAAE,KAAK;QACnB,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvE,CAAC,CAAC;IACH,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,GAAG,CAAC,IAAI,CAAC;YACb,IAAI,EAAE,OAAO;YACb,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO;YAC7C,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,GAAG,CAAC,IAAI,CAAC;QACb,IAAI,EAAE,mBAAmB;QACzB,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,IAAI;QAC3B,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,GAAG,gBAAgB,CAAC,KAAK,CAAC;KAC3B,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/mode/stable-hash.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Stable, key-order-canonical hash of a tool call's input, so `{a:1,b:2}` and
+ * `{b:2,a:1}` produce the same key. Use for any "have I seen this call before"
+ * comparison — a raw `JSON.stringify` is NOT order-stable.
+ */
+export declare function stableHash(input: unknown): string;
+//# sourceMappingURL=stable-hash.d.ts.map

package/dist/mode/stable-hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stable-hash.d.ts","sourceRoot":"","sources":["../../src/mode/stable-hash.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEjD"}

package/dist/mode/stable-hash.js

@@ -0,0 +1,20 @@
+/**
+ * Stable, key-order-canonical hash of a tool call's input, so `{a:1,b:2}` and
+ * `{b:2,a:1}` produce the same key. Use for any "have I seen this call before"
+ * comparison — a raw `JSON.stringify` is NOT order-stable.
+ */
+export function stableHash(input) {
+    return canonicalize(input);
+}
+function canonicalize(value) {
+    if (value === null || value === undefined)
+        return 'null';
+    if (typeof value !== 'object')
+        return JSON.stringify(value);
+    if (Array.isArray(value)) {
+        return '[' + value.map(canonicalize).join(',') + ']';
+    }
+    const entries = Object.entries(value).sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));
+    return '{' + entries.map(([k, v]) => JSON.stringify(k) + ':' + canonicalize(v)).join(',') + '}';
+}
+//# sourceMappingURL=stable-hash.js.map

package/dist/mode/stable-hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stable-hash.js","sourceRoot":"","sources":["../../src/mode/stable-hash.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IACzD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC5D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IACvD,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,CAAC,IAAI,CACnE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAC3C,CAAC;IACF,OAAO,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;AAClG,CAAC"}

package/dist/mode/stuck-loop.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Sliding-window detector for "model keeps making the same tool call".
+ *
+ * When the same `(toolName, input)` pair appears `repeatThreshold` times in
+ * the last `windowSize` calls, the model is almost certainly stuck — polling a
+ * tool that returns the same thing, mis-handling an error, etc. Bail early
+ * instead of burning through the iteration cap.
+ *
+ * Shared across every loop strategy so detection is uniform — previously each
+ * mode re-rolled this, and one copy used a non-canonical `JSON.stringify`
+ * signature that silently missed key-reordered repeats.
+ */
+export interface StuckSignal {
+    /** True when the loop guard should trip. */
+    readonly stuck: boolean;
+    /** Repeat count behind the trip — for the error message. */
+    readonly count: number;
+    /**
+     * `exact` = the same (tool, full-input) repeated `repeatThreshold` times.
+     * `near`  = the same (tool, identity arg — url / file_path / command / …)
+     *           repeated `nearThreshold` times while only volatile args (maxBytes,
+     *           timeoutMs) varied. Catches the "refetch the same URL with a bigger
+     *           maxBytes over and over" loop the exact check sails past.
+     */
+    readonly kind: 'exact' | 'near';
+}
+export interface StuckLoopDetector {
+    readonly windowSize: number;
+    readonly repeatThreshold: number;
+    /** Record the call and report whether the loop guard should trip. */
+    record(toolName: string, input: unknown): StuckSignal;
+}
+export declare function createStuckLoopDetector(opts?: {
+    windowSize?: number;
+    repeatThreshold?: number;
+    nearWindowSize?: number;
+    nearThreshold?: number;
+}): StuckLoopDetector;
+//# sourceMappingURL=stuck-loop.d.ts.map

package/dist/mode/stuck-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stuck-loop.d.ts","sourceRoot":"","sources":["../../src/mode/stuck-loop.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,WAAW;IAC1B,4CAA4C;IAC5C,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,qEAAqE;IACrE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,WAAW,CAAC;CACvD;AAgBD,wBAAgB,uBAAuB,CACrC,IAAI,GAAE;IACJ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACnB,GACL,iBAAiB,CA+BnB"}

package/dist/mode/stuck-loop.js

@@ -0,0 +1,51 @@
+import { stableHash } from './stable-hash.js';
+/** Identity arguments that pin "the same target" across volatile-arg variation,
+ *  best-first. The first present string field wins. */
+const IDENTITY_ARG_KEYS = ['url', 'file_path', 'path', 'command', 'cmd', 'query', 'pattern'];
+function identityArg(input) {
+    if (!input || typeof input !== 'object' || Array.isArray(input))
+        return null;
+    const o = input;
+    for (const k of IDENTITY_ARG_KEYS) {
+        const v = o[k];
+        if (typeof v === 'string' && v.trim().length > 0)
+            return `${k}=${v}`;
+    }
+    return null;
+}
+export function createStuckLoopDetector(opts = {}) {
+    const windowSize = opts.windowSize ?? 8;
+    const repeatThreshold = opts.repeatThreshold ?? 3;
+    // Near-dups need a higher count + a wider window (they're spread out across a
+    // burst of other calls), and tolerate a couple of legit "bigger refetch" tries.
+    const nearWindowSize = opts.nearWindowSize ?? Math.max(windowSize * 2, 16);
+    const nearThreshold = opts.nearThreshold ?? Math.max(repeatThreshold + 2, 5);
+    const recent = [];
+    const recentNear = [];
+    return {
+        windowSize,
+        repeatThreshold,
+        record(toolName, input) {
+            const key = `${toolName}|${stableHash(input)}`;
+            recent.push(key);
+            if (recent.length > windowSize)
+                recent.shift();
+            const exactCount = recent.filter((k) => k === key).length;
+            if (exactCount >= repeatThreshold)
+                return { stuck: true, count: exactCount, kind: 'exact' };
+            let nearCount = 0;
+            const id = identityArg(input);
+            if (id !== null) {
+                const nearKey = `${toolName}|${id}`;
+                recentNear.push(nearKey);
+                if (recentNear.length > nearWindowSize)
+                    recentNear.shift();
+                nearCount = recentNear.filter((k) => k === nearKey).length;
+                if (nearCount >= nearThreshold)
+                    return { stuck: true, count: nearCount, kind: 'near' };
+            }
+            return { stuck: false, count: Math.max(exactCount, nearCount), kind: 'exact' };
+        },
+    };
+}
+//# sourceMappingURL=stuck-loop.js.map

package/dist/mode/stuck-loop.js.map

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