@wrongstack/core 0.298.3 → 0.300.0

package/dist/core/system-prompt-builder.d.ts

@@ -6,6 +6,7 @@ import type { SkillLoader } from '../types/skill.js';
 import type { BuildContext, ModelCapabilities, SystemPromptBuilder, SystemPromptRegions } from '../types/system-prompt.js';
 import type { SystemPromptContributor } from '../types/system-prompt-contributor.js';
 import { type InstructionBundle, type InstructionBundlePaths } from './instruction-bundle.js';
+import { type InstructionTemplateContext } from './instruction-template.js';
 export { effectiveShell, shellGuidanceBlock, type EffectiveShell } from './system-prompt-shell.js';
 export declare const LAYER_1_IDENTITY: string;
 /**
@@ -20,8 +21,16 @@ export declare const LAYER_1_IDENTITY: string;
  *
  * Bundled, profile-global and explicitly-passed override files are user-owned
  * and keep full replacement semantics.
+ *
+ * `tplCtx` renders the conditional blocks in the markdown against the live tool
+ * set (see `instruction-template.ts`), so guidance for tools the current
+ * request never registered stays out of the prompt entirely. The two layers are
+ * rendered **separately** rather than after concatenation: an unclosed
+ * `ws:if` in the repo-committed file must not be able to swallow the genuine
+ * identity that precedes it. Omitting `tplCtx` keeps the full text, which is
+ * what embedders reading the bundled prompt directly expect.
  */
-export declare function buildIdentityLayer(identity: string | undefined, source: 'bundled' | 'global' | 'project' | 'file' | undefined): string;
+export declare function buildIdentityLayer(identity: string | undefined, source: 'bundled' | 'global' | 'project' | 'file' | undefined, tplCtx?: InstructionTemplateContext | undefined): string;
 export type { SystemBlockSource } from './system-prompt-blocks.js';
 export { SYSTEM_BLOCK_SOURCE } from './system-prompt-blocks.js';
 export interface DefaultSystemPromptBuilderOptions {
@@ -127,6 +136,13 @@ export declare class DefaultSystemPromptBuilder implements SystemPromptBuilder {
     /** Cached full buildToolUsage output — keyed by tools array ref + agents fingerprint + tier. */
     private _toolsUsageCache?;
     private _instructionBundle?;
+    /**
+     * Cached rendered identity layer. Keyed the same way as `_toolsUsageCache`:
+     * the ToolRegistry snapshot keeps the array reference stable until a registry
+     * mutation, so reference equality is a sound key for "the tool set did not
+     * change".
+     */
+    private _identityCache?;
     constructor(opts?: DefaultSystemPromptBuilderOptions);
     /**
      * Normalizes `tokenSavingMode` to a boolean for backward-compatible boolean checks.
@@ -152,6 +168,24 @@ export declare class DefaultSystemPromptBuilder implements SystemPromptBuilder {
     private toolDescLimit;
     build(ctx: BuildContext): Promise<TextBlock[]>;
     buildRegions(ctx: BuildContext): Promise<SystemPromptRegions>;
+    /**
+     * The view of the live request that the markdown conditionals are evaluated
+     * against: which tools can actually be called, the effective token-saving
+     * tier, and whether this prompt is for a subagent.
+     */
+    private templateContext;
+    /**
+     * Render the identity layer, memoized on the tool set / tier / role triple.
+     *
+     * The rendering itself is a couple of regex passes over ~40 KB, which is
+     * cheap but happens on every turn; the tool set is stable for the life of a
+     * session in the normal case, so the cache turns it into a one-off.
+     *
+     * This does not cost prompt-cache hits: in the wire format the `tools` array
+     * precedes `system`, so any registry mutation already invalidates the
+     * provider's prefix cache before the identity block is reached.
+     */
+    private buildIdentity;
     private instructions;
     /**
      * Cached plan content keyed by (planPath, mtimeMs). The plan is read