@namzu/sdk 27.0.0 → 28.0.0

package/dist/runtime/query/{context-cache.d.ts → prompt-cache.d.ts}

@@ -1,3 +1,4 @@
+import type { PromptContributionRegistry } from '../../prompt/contributions.js';
 import type { AgentRuntimeContext } from '../../types/agent/base.js';
 import type { AgentContextLevel } from '../../types/agent/factory.js';
 import type { AgentPersona } from '../../types/persona/index.js';
@@ -5,7 +6,7 @@ import type { ProjectId } from '../../types/session/ids.js';
 import type { Skill } from '../../types/skills/index.js';
 import type { ToolRegistryContract } from '../../types/tool/index.js';
 import { type PromptSegments } from './prompt.js';
-export interface ContextCacheConfig {
+export interface PromptCacheConfig {
     agentId: string;
     projectId: ProjectId;
 }
@@ -17,15 +18,16 @@ export interface PromptCacheInput {
     tools: ToolRegistryContract;
     allowedTools?: string[];
     runtimeContext?: AgentRuntimeContext;
+    contributions?: PromptContributionRegistry;
 }
-export declare class ContextCache {
+export declare class PromptCache {
     readonly projectId: ProjectId;
     readonly agentId: string;
     private cachedPrompt;
     private cachedConfigHash;
     private cachedStaticSegment;
     private cachedStaticHash;
-    constructor(config: ContextCacheConfig);
+    constructor(config: PromptCacheConfig);
     getSystemPrompt(input: PromptCacheInput): string;
     get configHash(): string | undefined;
     needsRebuild(input: PromptCacheInput): boolean;
@@ -34,4 +36,4 @@ export declare class ContextCache {
     private computeStaticHash;
     private computeConfigHash;
 }
-//# sourceMappingURL=context-cache.d.ts.map
+//# sourceMappingURL=prompt-cache.d.ts.map

package/dist/runtime/query/prompt-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-cache.d.ts","sourceRoot":"","sources":["../../../src/runtime/query/prompt-cache.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAA;AAC/E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAA;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AACrE,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAA;AAEhE,MAAM,WAAW,iBAAiB;IACjC,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,SAAS,CAAA;CACpB;AAED,MAAM,WAAW,gBAAgB;IAChC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,MAAM,CAAC,EAAE,KAAK,EAAE,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,oBAAoB,CAAA;IAC3B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,cAAc,CAAC,EAAE,mBAAmB,CAAA;IACpC,aAAa,CAAC,EAAE,0BAA0B,CAAA;CAC1C;AAED,qBAAa,WAAW;IACvB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IAExB,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,gBAAgB,CAAoB;IAC5C,OAAO,CAAC,mBAAmB,CAAoB;IAC/C,OAAO,CAAC,gBAAgB,CAAoB;gBAEhC,MAAM,EAAE,iBAAiB;IAKrC,eAAe,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM;IAuBhD,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAEnC;IAED,YAAY,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO;IAK9C,wBAAwB,CACvB,KAAK,EAAE,gBAAgB,EACvB,YAAY,GAAE,iBAA0B,EACxC,gBAAgB,CAAC,EAAE,MAAM,GACvB,cAAc;IA6BjB,UAAU,IAAI,IAAI;IAOlB,OAAO,CAAC,iBAAiB;IAqBzB,OAAO,CAAC,iBAAiB;CAsBzB"}

package/dist/runtime/query/{context-cache.js → prompt-cache.js}

@@ -1,6 +1,6 @@
 import { createHash } from 'node:crypto';
 import { PromptBuilder } from './prompt.js';
-export class ContextCache {
+export class PromptCache {
     projectId;
     agentId;
     cachedPrompt;
@@ -24,6 +24,7 @@ export class ContextCache {
             tools: input.tools,
             allowedTools: input.allowedTools,
             runtimeContext: input.runtimeContext,
+            ...(input.contributions ? { contributions: input.contributions } : {}),
         });
         this.cachedPrompt = builder.build();
         this.cachedConfigHash = hash;
@@ -47,6 +48,7 @@ export class ContextCache {
             tools: input.tools,
             allowedTools: input.allowedTools,
             runtimeContext: input.runtimeContext,
+            ...(input.contributions ? { contributions: input.contributions } : {}),
         });
         const segments = builder.buildSegmented(contextLevel, workingDirectory);
         if (this.cachedStaticHash === staticHash && this.cachedStaticSegment !== undefined) {
@@ -73,6 +75,14 @@ export class ContextCache {
             input.persona?.identity?.description ?? '',
             input.basePrompt ?? '',
             ...(input.skills?.map((s) => s.metadata.name) ?? []),
+            // The STATIC ones only, because this hash guards the static
+            // segment. A `dynamic` or `turn` contributor coming or going does
+            // not change the cached prefix, and folding it in here would
+            // invalidate that prefix for a change it does not describe.
+            ...(input.contributions
+                ?.list()
+                .filter((c) => c.placement === 'static')
+                .map((c) => c.id) ?? []),
         ];
         return createHash('sha256').update(parts.join('\0')).digest('hex').slice(0, 16);
     }
@@ -86,8 +96,16 @@ export class ContextCache {
             ...(input.skills?.map((s) => s.metadata.name) ?? []),
             ...(input.allowedTools ?? []),
             JSON.stringify(input.runtimeContext ?? {}),
+            // Ids and placements, not rendered text. Rendering every
+            // contribution to hash it would run them twice per request for a
+            // value the cache exists to avoid computing — and a contributor
+            // whose OUTPUT changes while its id does not is exactly the one
+            // that must declare `dynamic` or `turn` rather than `static`.
+            // Hashing the identity is what catches the change this cache can
+            // actually be wrong about: a different SET of contributors.
+            ...(input.contributions?.list().map((c) => `${c.id}:${c.placement}`) ?? []),
         ];
         return createHash('sha256').update(parts.join('\0')).digest('hex').slice(0, 16);
     }
 }
-//# sourceMappingURL=context-cache.js.map
+//# sourceMappingURL=prompt-cache.js.map

package/dist/runtime/query/prompt-cache.js.map

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

package/dist/runtime/query/prompt.d.ts

@@ -1,3 +1,4 @@
+import { type PromptContributionRegistry } from '../../prompt/contributions.js';
 import type { AgentRuntimeContext } from '../../types/agent/base.js';
 import type { AgentContextLevel } from '../../types/agent/factory.js';
 import type { AgentPersona } from '../../types/persona/index.js';
@@ -17,10 +18,59 @@ export interface PromptBuilderConfig {
     tools: ToolRegistryContract;
     allowedTools?: string[];
     runtimeContext?: AgentRuntimeContext;
+    /**
+     * What else goes in the prompt, beyond what this builder knows about.
+     *
+     * Absent means exactly what it meant before this existed: the fixed
+     * list. A capability that needs the model to know something registers
+     * here instead of arguing for a branch or splicing into `systemPrompt`
+     * and losing whatever was there.
+     */
+    contributions?: PromptContributionRegistry;
 }
 export declare class PromptBuilder {
     private config;
     constructor(config: PromptBuilderConfig);
+    /**
+     * The context every contribution is rendered against.
+     *
+     * `workingDirectory` is a call argument rather than config, so it is
+     * threaded rather than read off `this`.
+     */
+    private contributionContext;
+    /**
+     * Skills, once, in the slot they were always in.
+     *
+     * The registry renders at the END of the prompt, and skills belong where
+     * they have always been: immediately after the persona or system prompt.
+     * So the built-in contribution is rendered IN PLACE here rather than
+     * being left to the tail — a host that registers it gets the seam, not a
+     * reordered prompt.
+     *
+     * This is also what makes it a real contributor rather than a decorative
+     * one. Written first as "the builder renders skills, and the registry
+     * skips its own copy", which a mutation caught immediately: the
+     * contribution could be deleted with no observable effect, because the
+     * builder's own branch rendered skills either way. A seam whose first
+     * consumer is inert proves nothing about the seam.
+     *
+     * The persona branch is the exception and stays one:
+     * `assembleSystemPrompt(persona, skills)` places skills inside the
+     * persona's own section ordering, relative to constraints and output
+     * discipline. Routing it through here would silently reorder every
+     * persona-driven prompt in the estate.
+     */
+    private renderSkillsInPlace;
+    /**
+     * `static` and `dynamic` only, and the signature says so.
+     *
+     * A `turn` contribution rendered here would land in the system prompt —
+     * cached for the run under `static`, or read as a standing instruction
+     * under `dynamic`. Either way the state it exists to report goes stale
+     * silently, which is the exact failure `turn` was added to avoid. The
+     * iteration loop renders those, into the ephemeral message.
+     */
+    private renderContributions;
     build(contextLevel?: AgentContextLevel, workingDirectory?: string): string;
     buildSegmented(contextLevel?: AgentContextLevel, workingDirectory?: string): PromptSegments;
 }

package/dist/runtime/query/prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/runtime/query/prompt.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAChE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAA;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAErE,MAAM,WAAW,cAAc;IAC9B,gHAAgH;IAChH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,0FAA0F;IAC1F,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,mBAAmB;IACnC,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB,OAAO,CAAC,EAAE,YAAY,CAAA;IAEtB,MAAM,CAAC,EAAE,KAAK,EAAE,CAAA;IAEhB,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB,KAAK,EAAE,oBAAoB,CAAA;IAC3B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,cAAc,CAAC,EAAE,mBAAmB,CAAA;CACpC;AAiED,qBAAa,aAAa;IACzB,OAAO,CAAC,MAAM,CAAqB;gBAEvB,MAAM,EAAE,mBAAmB;IAIvC,KAAK,CAAC,YAAY,GAAE,iBAA0B,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM;IA6ClF,cAAc,CACb,YAAY,GAAE,iBAA0B,EACxC,gBAAgB,CAAC,EAAE,MAAM,GACvB,cAAc;CAyDjB"}
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/runtime/query/prompt.ts"],"names":[],"mappings":"AAEA,OAAO,EAEN,KAAK,0BAA0B,EAE/B,MAAM,+BAA+B,CAAA;AACtC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAChE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAA;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAErE,MAAM,WAAW,cAAc;IAC9B,gHAAgH;IAChH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,0FAA0F;IAC1F,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,mBAAmB;IACnC,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB,OAAO,CAAC,EAAE,YAAY,CAAA;IAEtB,MAAM,CAAC,EAAE,KAAK,EAAE,CAAA;IAEhB,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB,KAAK,EAAE,oBAAoB,CAAA;IAC3B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,cAAc,CAAC,EAAE,mBAAmB,CAAA;IACpC;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,0BAA0B,CAAA;CAC1C;AAiED,qBAAa,aAAa;IACzB,OAAO,CAAC,MAAM,CAAqB;gBAEvB,MAAM,EAAE,mBAAmB;IAIvC;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAS3B;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,OAAO,CAAC,mBAAmB;IAQ3B;;;;;;;;OAQG;IACH,OAAO,CAAC,mBAAmB;IAqB3B,KAAK,CAAC,YAAY,GAAE,iBAA0B,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM;IAqDlF,cAAc,CACb,YAAY,GAAE,iBAA0B,EACxC,gBAAgB,CAAC,EAAE,MAAM,GACvB,cAAc;CA4DjB"}

package/dist/runtime/query/prompt.js

@@ -1,5 +1,6 @@
 import { FILESYSTEM_TOOLS } from '../../constants/tools/index.js';
 import { assembleSystemPrompt, renderSkillsSection } from '../../persona/assembler.js';
+import { SKILLS_CONTRIBUTION_ID, } from '../../prompt/contributions.js';
 function buildEnvContext(workingDirectory, runtimeContext) {
     const lines = [
         `<env>
@@ -59,6 +60,75 @@ export class PromptBuilder {
     constructor(config) {
         this.config = config;
     }
+    /**
+     * The context every contribution is rendered against.
+     *
+     * `workingDirectory` is a call argument rather than config, so it is
+     * threaded rather than read off `this`.
+     */
+    contributionContext(workingDirectory) {
+        return {
+            ...(workingDirectory === undefined ? {} : { workingDirectory }),
+            ...(this.config.runtimeContext ? { runtimeContext: this.config.runtimeContext } : {}),
+            ...(this.config.skills ? { skills: this.config.skills } : {}),
+            ...(this.config.allowedTools ? { allowedTools: this.config.allowedTools } : {}),
+        };
+    }
+    /**
+     * Skills, once, in the slot they were always in.
+     *
+     * The registry renders at the END of the prompt, and skills belong where
+     * they have always been: immediately after the persona or system prompt.
+     * So the built-in contribution is rendered IN PLACE here rather than
+     * being left to the tail — a host that registers it gets the seam, not a
+     * reordered prompt.
+     *
+     * This is also what makes it a real contributor rather than a decorative
+     * one. Written first as "the builder renders skills, and the registry
+     * skips its own copy", which a mutation caught immediately: the
+     * contribution could be deleted with no observable effect, because the
+     * builder's own branch rendered skills either way. A seam whose first
+     * consumer is inert proves nothing about the seam.
+     *
+     * The persona branch is the exception and stays one:
+     * `assembleSystemPrompt(persona, skills)` places skills inside the
+     * persona's own section ordering, relative to constraints and output
+     * discipline. Routing it through here would silently reorder every
+     * persona-driven prompt in the estate.
+     */
+    renderSkillsInPlace() {
+        const contribution = this.config.contributions
+            ?.list()
+            .find((c) => c.id === SKILLS_CONTRIBUTION_ID);
+        if (contribution)
+            return contribution.render(this.contributionContext());
+        return renderSkillsSection(this.config.skills);
+    }
+    /**
+     * `static` and `dynamic` only, and the signature says so.
+     *
+     * A `turn` contribution rendered here would land in the system prompt —
+     * cached for the run under `static`, or read as a standing instruction
+     * under `dynamic`. Either way the state it exists to report goes stale
+     * silently, which is the exact failure `turn` was added to avoid. The
+     * iteration loop renders those, into the ephemeral message.
+     */
+    renderContributions(placement, workingDirectory) {
+        const registry = this.config.contributions;
+        if (!registry)
+            return [];
+        const context = this.contributionContext(workingDirectory);
+        return (registry
+            .list()
+            .filter((contribution) => contribution.placement === placement)
+            // Skills is rendered IN PLACE by `renderSkillsInPlace`, so the tail
+            // must not render it again. Unconditional, not branch-dependent:
+            // under a persona it is already inside the persona section, and
+            // otherwise it is already in its own slot above.
+            .filter((contribution) => contribution.id !== SKILLS_CONTRIBUTION_ID)
+            .map((contribution) => contribution.render(context))
+            .filter((text) => typeof text === 'string' && text.trim().length > 0));
+    }
     build(contextLevel = 'full', workingDirectory) {
         const parts = [];
         if (contextLevel === 'full' && this.config.basePrompt) {
@@ -71,12 +141,12 @@ export class PromptBuilder {
             parts.push(assembleSystemPrompt(this.config.persona, this.config.skills));
         }
         else {
-            const skillSection = renderSkillsSection(this.config.skills);
+            const skillSection = this.renderSkillsInPlace();
             if (skillSection)
                 parts.push(skillSection);
         }
         if (this.config.systemPrompt) {
-            const skillSection = renderSkillsSection(this.config.skills);
+            const skillSection = this.renderSkillsInPlace();
             if (skillSection)
                 parts.push(skillSection);
         }
@@ -97,6 +167,13 @@ export class PromptBuilder {
                 parts.push(buildEnvContext(workingDirectory, this.config.runtimeContext));
             }
         }
+        // Static then dynamic, in that order and nothing between them,
+        // because that is exactly how `buildSegmented` is rejoined upstream:
+        // `${static}\n\n---\n\n${dynamic}`. The two methods produce the same
+        // prompt for the same input, and a run that hits the prompt cache
+        // must not be asking a different question from one that misses it.
+        parts.push(...this.renderContributions('static', workingDirectory));
+        parts.push(...this.renderContributions('dynamic', workingDirectory));
         return parts.join('\n\n---\n\n');
     }
     buildSegmented(contextLevel = 'full', workingDirectory) {
@@ -120,12 +197,12 @@ export class PromptBuilder {
             }
         }
         else {
-            const skillSection = renderSkillsSection(this.config.skills);
+            const skillSection = this.renderSkillsInPlace();
             if (skillSection)
                 staticParts.push(skillSection);
         }
         if (this.config.systemPrompt) {
-            const skillSection = renderSkillsSection(this.config.skills);
+            const skillSection = this.renderSkillsInPlace();
             if (skillSection)
                 staticParts.push(skillSection);
         }
@@ -146,6 +223,8 @@ export class PromptBuilder {
                 dynamicParts.push(buildEnvContext(workingDirectory, this.config.runtimeContext));
             }
         }
+        staticParts.push(...this.renderContributions('static', workingDirectory));
+        dynamicParts.push(...this.renderContributions('dynamic', workingDirectory));
         return {
             static: staticParts.join(separator),
             dynamic: dynamicParts.join(separator),

package/dist/runtime/query/prompt.js.map

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

package/dist/runtime/query/repeat-call.d.ts

@@ -0,0 +1,42 @@
+import type { Message } from '../../types/message/index.js';
+export interface RepeatCallThresholds {
+    /** Repeats at which a first, mild notice is attached. */
+    readonly notifyAfter: number;
+    /** Repeats at which the wording escalates. */
+    readonly escalateAfter: number;
+}
+export declare const DEFAULT_REPEAT_THRESHOLDS: RepeatCallThresholds;
+export interface RepeatCallNotice {
+    readonly toolName: string;
+    readonly count: number;
+    readonly level: 'notice' | 'escalated';
+    readonly text: string;
+}
+/**
+ * Run-scoped, like `ToolGrantSet` and for the same reason: a count carried
+ * into a later run is a statement about work nobody repeated.
+ */
+export declare class RepeatCallTracker {
+    private readonly thresholds;
+    private readonly counts;
+    /** Which keys have already been reported at which level, so one repeat
+     *  does not produce the same sentence on every subsequent turn. */
+    private readonly announced;
+    constructor(thresholds?: RepeatCallThresholds);
+    /**
+     * Records one call and returns a notice when this is the repeat that
+     * crosses a threshold, `undefined` otherwise.
+     */
+    record(toolName: string, input: unknown): RepeatCallNotice | undefined;
+    /** Repeats seen for one call, for a host that wants to render it. */
+    countOf(toolName: string, input: unknown): number;
+}
+/**
+ * Rides the notice out on the last `tool_result` of the batch.
+ *
+ * The same and only legal slot steering uses: a `tool_use` block must be
+ * answered by a `tool_result` with the same id, so a user message wedged
+ * between them is rejected by the provider outright.
+ */
+export declare function attachRepeatNotice(messages: readonly Message[], notices: readonly RepeatCallNotice[]): readonly Message[];
+//# sourceMappingURL=repeat-call.d.ts.map

package/dist/runtime/query/repeat-call.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repeat-call.d.ts","sourceRoot":"","sources":["../../../src/runtime/query/repeat-call.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AA0B3D,MAAM,WAAW,oBAAoB;IACpC,yDAAyD;IACzD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,8CAA8C;IAC9C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;CAC9B;AAED,eAAO,MAAM,yBAAyB,EAAE,oBAGvC,CAAA;AAED,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,WAAW,CAAA;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACrB;AAED;;;GAGG;AACH,qBAAa,iBAAiB;IAMjB,OAAO,CAAC,QAAQ,CAAC,UAAU;IALvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IACnD;uEACmE;IACnE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4C;gBAEzC,UAAU,GAAE,oBAAgD;IAEzF;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,gBAAgB,GAAG,SAAS;IA2BtE,qEAAqE;IACrE,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM;CAGjD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CACjC,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,OAAO,EAAE,SAAS,gBAAgB,EAAE,GAClC,SAAS,OAAO,EAAE,CAyBpB"}

package/dist/runtime/query/repeat-call.js

@@ -0,0 +1,107 @@
+import { stableStringify } from './tool-grants.js';
+/**
+ * Notices a model issuing the same tool call over and over, and says so.
+ *
+ * Nothing in the kernel observed cross-call repetition. The guardrails
+ * screen calls in isolation — input at run start, output at run end, one
+ * result at a time — so a model re-running a failing command or
+ * re-applying a diff that does not apply got no correction from anything.
+ * The only lever was an iteration checkpoint, which fires on a COUNT
+ * regardless of whether anything is repeating and needs a human at the
+ * other end.
+ *
+ * It advises; it never denies. A repeat is not necessarily wrong — polling
+ * for a build to finish is the same call by design — and a tracker that
+ * refused would break that case to fix a different one. What the model
+ * lacks is not permission but the observation, which it cannot make about
+ * itself: each turn it sees a history, not a count.
+ */
+/** Same key `ToolGrantSet` uses, so "the same call" means one thing here. */
+function keyFor(name, input) {
+    return `${name}:${stableStringify(input)}`;
+}
+export const DEFAULT_REPEAT_THRESHOLDS = {
+    notifyAfter: 3,
+    escalateAfter: 5,
+};
+/**
+ * Run-scoped, like `ToolGrantSet` and for the same reason: a count carried
+ * into a later run is a statement about work nobody repeated.
+ */
+export class RepeatCallTracker {
+    thresholds;
+    counts = new Map();
+    /** Which keys have already been reported at which level, so one repeat
+     *  does not produce the same sentence on every subsequent turn. */
+    announced = new Map();
+    constructor(thresholds = DEFAULT_REPEAT_THRESHOLDS) {
+        this.thresholds = thresholds;
+    }
+    /**
+     * Records one call and returns a notice when this is the repeat that
+     * crosses a threshold, `undefined` otherwise.
+     */
+    record(toolName, input) {
+        const key = keyFor(toolName, input);
+        const count = (this.counts.get(key) ?? 0) + 1;
+        this.counts.set(key, count);
+        const already = this.announced.get(key);
+        if (count >= this.thresholds.escalateAfter && already !== 'escalated') {
+            this.announced.set(key, 'escalated');
+            return {
+                toolName,
+                count,
+                level: 'escalated',
+                text: `You have now called \`${toolName}\` with identical arguments ${count} times in this run. Repeating it again will produce the same result. Change the arguments, use a different tool, or tell the user what is blocking you and stop.`,
+            };
+        }
+        if (count >= this.thresholds.notifyAfter && already === undefined) {
+            this.announced.set(key, 'notice');
+            return {
+                toolName,
+                count,
+                level: 'notice',
+                text: `Note: this is call ${count} of \`${toolName}\` with identical arguments in this run. If the previous results were not what you needed, changing the arguments is more likely to help than repeating them.`,
+            };
+        }
+        return undefined;
+    }
+    /** Repeats seen for one call, for a host that wants to render it. */
+    countOf(toolName, input) {
+        return this.counts.get(keyFor(toolName, input)) ?? 0;
+    }
+}
+/**
+ * Rides the notice out on the last `tool_result` of the batch.
+ *
+ * The same and only legal slot steering uses: a `tool_use` block must be
+ * answered by a `tool_result` with the same id, so a user message wedged
+ * between them is rejected by the provider outright.
+ */
+export function attachRepeatNotice(messages, notices) {
+    if (notices.length === 0)
+        return messages;
+    let lastToolIndex = -1;
+    for (let index = messages.length - 1; index >= 0; index--) {
+        if (messages[index]?.role === 'tool') {
+            lastToolIndex = index;
+            break;
+        }
+    }
+    if (lastToolIndex === -1)
+        return messages;
+    const target = messages[lastToolIndex];
+    // Text only, for the reason `attachSteering` gives: a result answered
+    // with structured content has a shape the model reads positionally, and
+    // appending a string to it is either dropped or corrupts the block. The
+    // notice is advisory, so dropping it costs nothing a refusal would.
+    if (typeof target.content !== 'string')
+        return messages;
+    const next = [...messages];
+    next[lastToolIndex] = {
+        ...target,
+        content: `${target.content}\n\n${notices.map((n) => n.text).join('\n')}`,
+    };
+    return next;
+}
+//# sourceMappingURL=repeat-call.js.map

package/dist/runtime/query/repeat-call.js.map

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

package/dist/runtime/query/replay/mutate.js

@@ -53,7 +53,14 @@ function applyOne(messages, mutation) {
             const pending = findPendingToolCalls(messages);
             const match = pending.find((tc) => tc.id === mutation.toolCallId);
             if (!match) {
-                throw new MutationNotApplicableError(`No pending tool call ${mutation.toolCallId} at fork point`, pending.map((tc) => tc.id));
+                throw new MutationNotApplicableError(`No pending tool call ${mutation.toolCallId} at fork point`, 
+                // `ToolCall.id` is a bare `string` — a provider chooses its own
+                // shape, which is what `ToolUseId` exists to say. This assertion
+                // satisfies `MutationNotApplicableError`'s parameter and is only
+                // ever read back as text in that message; it never becomes a
+                // key. Left as a cast because the honest fix is that parameter
+                // type, not this line.
+                pending.map((tc) => tc.id));
             }
             return [...messages, createToolMessage(mutation.response.output, mutation.toolCallId)];
         }

package/dist/runtime/query/replay/mutate.js.map

@@ -1 +1 @@
-{"version":3,"file":"mutate.js","sourceRoot":"","sources":["../../../../src/runtime/query/replay/mutate.ts"],"names":[],"mappings":"AACA,OAAO,EAIN,iBAAiB,GACjB,MAAM,iCAAiC,CAAA;AACxC,OAAO,EAAiB,0BAA0B,EAAE,MAAM,8BAA8B,CAAA;AAExF;;;;;GAKG;AACH,SAAS,oBAAoB,CAAC,QAA4B;IACzD,IAAI,gBAAgB,GAAG,CAAC,CAAC,CAAA;IACzB,KAAK,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC/C,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;QACvB,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;YACzE,gBAAgB,GAAG,CAAC,CAAA;YACpB,MAAK;QACN,CAAC;IACF,CAAC;IACD,IAAI,gBAAgB,KAAK,CAAC,CAAC;QAAE,OAAO,EAAE,CAAA;IAEtC,MAAM,SAAS,GAAG,QAAQ,CAAC,gBAAgB,CAAqB,CAAA;IAChE,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAA;IACnC,KAAK,IAAI,CAAC,GAAG,gBAAgB,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7D,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;QACvB,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAChC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;QAC9B,CAAC;IACF,CAAC;IACD,OAAO,CAAC,SAAS,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;AACzE,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAC7B,QAA4B,EAC5B,SAA8B;IAE9B,IAAI,OAAO,GAAc,CAAC,GAAG,QAAQ,CAAC,CAAA;IACtC,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC3B,OAAO,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAA;IAC/B,CAAC;IACD,OAAO,OAAO,CAAA;AACf,CAAC;AAED,SAAS,QAAQ,CAAC,QAAmB,EAAE,QAAkB;IACxD,QAAQ,QAAQ,CAAC,IAAI,EAAE,CAAC;QACvB,KAAK,oBAAoB,CAAC,CAAC,CAAC;YAC3B,MAAM,OAAO,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAA;YAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,QAAQ,CAAC,UAAU,CAAC,CAAA;YACjE,IAAI,CAAC,KAAK,EAAE,CAAC;gBACZ,MAAM,IAAI,0BAA0B,CACnC,wBAAwB,QAAQ,CAAC,UAAU,gBAAgB,EAC3D,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAgB,CAAC,CACxC,CAAA;YACF,CAAC;YACD,OAAO,CAAC,GAAG,QAAQ,EAAE,iBAAiB,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAA;QACvF,CAAC;IACF,CAAC;AACF,CAAC"}
+{"version":3,"file":"mutate.js","sourceRoot":"","sources":["../../../../src/runtime/query/replay/mutate.ts"],"names":[],"mappings":"AACA,OAAO,EAIN,iBAAiB,GACjB,MAAM,iCAAiC,CAAA;AACxC,OAAO,EAAiB,0BAA0B,EAAE,MAAM,8BAA8B,CAAA;AAExF;;;;;GAKG;AACH,SAAS,oBAAoB,CAAC,QAA4B;IACzD,IAAI,gBAAgB,GAAG,CAAC,CAAC,CAAA;IACzB,KAAK,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC/C,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;QACvB,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;YACzE,gBAAgB,GAAG,CAAC,CAAA;YACpB,MAAK;QACN,CAAC;IACF,CAAC;IACD,IAAI,gBAAgB,KAAK,CAAC,CAAC;QAAE,OAAO,EAAE,CAAA;IAEtC,MAAM,SAAS,GAAG,QAAQ,CAAC,gBAAgB,CAAqB,CAAA;IAChE,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAA;IACnC,KAAK,IAAI,CAAC,GAAG,gBAAgB,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7D,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;QACvB,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAChC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;QAC9B,CAAC;IACF,CAAC;IACD,OAAO,CAAC,SAAS,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;AACzE,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAC7B,QAA4B,EAC5B,SAA8B;IAE9B,IAAI,OAAO,GAAc,CAAC,GAAG,QAAQ,CAAC,CAAA;IACtC,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC3B,OAAO,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAA;IAC/B,CAAC;IACD,OAAO,OAAO,CAAA;AACf,CAAC;AAED,SAAS,QAAQ,CAAC,QAAmB,EAAE,QAAkB;IACxD,QAAQ,QAAQ,CAAC,IAAI,EAAE,CAAC;QACvB,KAAK,oBAAoB,CAAC,CAAC,CAAC;YAC3B,MAAM,OAAO,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAA;YAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,QAAQ,CAAC,UAAU,CAAC,CAAA;YACjE,IAAI,CAAC,KAAK,EAAE,CAAC;gBACZ,MAAM,IAAI,0BAA0B,CACnC,wBAAwB,QAAQ,CAAC,UAAU,gBAAgB;gBAC3D,gEAAgE;gBAChE,iEAAiE;gBACjE,iEAAiE;gBACjE,6DAA6D;gBAC7D,+DAA+D;gBAC/D,uBAAuB;gBACvB,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAgB,CAAC,CACxC,CAAA;YACF,CAAC;YACD,OAAO,CAAC,GAAG,QAAQ,EAAE,iBAAiB,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAA;QACvF,CAAC;IACF,CAAC;AACF,CAAC"}

package/dist/runtime/query/result.d.ts

@@ -21,6 +21,13 @@ export interface ResultAssemblerConfig {
      * construction would pin the first one forever.
      */
     resumeCheckpointId?: () => CheckpointId | undefined;
+    /**
+     * The run's abort signal, read only to recover WHY a cancellation
+     * happened. Optional so a caller that never cancels needs no extra
+     * wiring, and absent simply means the cause is unknown — which is the
+     * same answer an unattributed cancellation gives.
+     */
+    signal?: AbortSignal;
 }
 export declare class ResultAssembler {
     private config;

package/dist/runtime/query/result.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../../src/runtime/query/result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,EAAkB,MAAM,oBAAoB,CAAA;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAA;AAEtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AAInE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAC7D,OAAO,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAE7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE5C,MAAM,WAAW,qBAAqB;IACrC,MAAM,EAAE,cAAc,CAAA;IACtB,WAAW,EAAE,WAAW,CAAA;IACxB,aAAa,EAAE,aAAa,CAAA;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,SAAS,CAAA;IACpB,YAAY,EAAE,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAA;IACvC;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,MAAM,YAAY,GAAG,SAAS,CAAA;CACnD;AAED,qBAAa,eAAe;IAC3B,OAAO,CAAC,MAAM,CAAuB;gBAEzB,MAAM,EAAE,qBAAqB;IAIlC,WAAW,CAAC,QAAQ,EAAE,IAAI,GAAG,cAAc,CAAC,QAAQ,CAAC;IAoDrD,eAAe,CAAC,QAAQ,EAAE,IAAI,GAAG,cAAc,CAAC,QAAQ,CAAC;IAIzD,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,GAAG,cAAc,CAAC,QAAQ,CAAC;IAiGpE,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC;CAI9B"}
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../../src/runtime/query/result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,EAAkB,MAAM,oBAAoB,CAAA;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAA;AAEtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AAInE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAE7D,OAAO,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAE7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE5C,MAAM,WAAW,qBAAqB;IACrC,MAAM,EAAE,cAAc,CAAA;IACtB,WAAW,EAAE,WAAW,CAAA;IACxB,aAAa,EAAE,aAAa,CAAA;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,SAAS,CAAA;IACpB,YAAY,EAAE,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAA;IACvC;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,MAAM,YAAY,GAAG,SAAS,CAAA;IACnD;;;;;OAKG;IACH,MAAM,CAAC,EAAE,WAAW,CAAA;CACpB;AAED,qBAAa,eAAe;IAC3B,OAAO,CAAC,MAAM,CAAuB;gBAEzB,MAAM,EAAE,qBAAqB;IAIlC,WAAW,CAAC,QAAQ,EAAE,IAAI,GAAG,cAAc,CAAC,QAAQ,CAAC;IAwErD,eAAe,CAAC,QAAQ,EAAE,IAAI,GAAG,cAAc,CAAC,QAAQ,CAAC;IAIzD,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,GAAG,cAAc,CAAC,QAAQ,CAAC;IA0GpE,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC;CAI9B"}