@wrongstack/core 0.284.1 → 0.286.0

package/dist/utils/token-estimate.d.ts

@@ -0,0 +1,112 @@
+import type { Message } from '../types/messages.js';
+/**
+ * Estimate tokens for a tool_use block input.
+ * Caches the stringified result keyed by the stable string representation
+ * to avoid repeated JSON.stringify calls during context window checks.
+ */
+export declare function estimateToolInputTokens(input: unknown): number;
+/**
+ * Estimate tokens for a tool_result content.
+ */
+export declare function estimateToolResultTokens(content: string | unknown): number;
+/**
+ * Estimate tokens for a text block.
+ */
+export declare function estimateTextTokens(text: string): number;
+/**
+ * Compute and cache the token estimate for a single message. This is the
+ * canonical per-message estimator — called once by ConversationState on
+ * append/replace so the O(n·m) content-block walk happens at mutation time,
+ * not on every context-pressure check.
+ */
+export declare function computeMessageTokens(msg: Message): number;
+/**
+ * Estimate tokens for an array of messages (text + tool I/O), using the shared
+ * 3.5 chars/token basis. This is the single canonical message-array estimator —
+ * compactors, the context_manager tool, and the `/context` display all route
+ * through it so the number a user sees matches the number compaction decides on.
+ *
+ * When a message carries a pre-computed `_estTokens` field (set by
+ * ConversationState on append/replace), it is used directly instead of
+ * re-walking the content blocks — turning the O(n·m) scan into an O(n)
+ * sum for fully-cached arrays.
+ */
+export declare function estimateMessageTokens(messages: readonly Message[]): number;
+/**
+ * Rough estimate of tokens in a tool definition (name + description + schema).
+ * Accounts for the JSON-serialized inputSchema which is sent to the API
+ * but NOT included in roughEstimate(content).
+ */
+export declare function estimateToolDefTokens(tool: {
+    name: string;
+    description?: string | undefined;
+    inputSchema: unknown;
+}): number;
+/**
+ * Estimate the total API request token count: system prompt + tool definitions
+ * + conversation messages. Use this for context-window bar calculations
+ * instead of roughEstimate (which only counts messages).
+ *
+ * The overhead ratio (overhead / messages) varies by conversation length:
+ *   - Short conversations (< 10 messages): ~30-50% overhead (large system+tools)
+ *   - Medium (10-50 messages): ~15-30%
+ *   - Long (> 50 messages): ~5-15%
+ *
+ * Returns { messages, systemPrompt, tools, total } for debugging display.
+ */
+export interface RequestTokenBreakdown {
+    messages: number;
+    systemPrompt: number;
+    tools: number;
+    total: number;
+}
+export declare function estimateRequestTokens(messages: unknown, systemPrompt: unknown, tools: {
+    name: string;
+    description?: string | undefined;
+    inputSchema: unknown;
+}[], calibrationKey?: string): RequestTokenBreakdown;
+/**
+ * Record the actual API input token count after a provider call so
+ * `estimateRequestTokensCalibrated` can self-correct on subsequent calls.
+ *
+ * Prefer passing `estimatedInputTokens` explicitly (the calibrated pre-flight
+ * estimate from the middleware) — this avoids race conditions when other code
+ * also calls `estimateRequestTokens` between the pre-flight and this call
+ * (e.g. audit logging in agent.ts).
+ *
+ * When `estimatedInputTokens` is omitted, falls back to the keyed bucket's
+ * `prevEst` for backward compatibility with callers that don't have the
+ * pre-flight value. `calibrationKey` selects the per-(provider,model) bucket
+ * (defaults to the shared global bucket).
+ */
+export declare function recordActualUsage(actualInputTokens: number, estimatedInputTokens?: number, calibrationKey?: string): void;
+/**
+ * Returns the current calibration state for a bucket. Exposed for debugging
+ * and tests — not needed by normal callers.
+ */
+export declare function getCalibrationState(calibrationKey?: string): {
+    ratio: number;
+    count: number;
+    calibrated: boolean;
+};
+/**
+ * Like `estimateRequestTokens` but applies the rolling calibration factor
+ * so context pressure readings converge on reality within a few iterations.
+ *
+ * Before any `recordActualUsage` samples are collected, returns the same
+ * result as `estimateRequestTokens` (ratio = 1.0, no distortion).
+ * After `MIN_SAMPLES_FOR_CALIBRATION` samples, applies the calibrated
+ * multiplier capped to the range [0.5, 1.5] as a sanity bound.
+ */
+export declare function estimateRequestTokensCalibrated(messages: unknown, systemPrompt: unknown, tools: {
+    name: string;
+    description?: string | undefined;
+    inputSchema: unknown;
+}[], calibrationKey?: string): RequestTokenBreakdown;
+/**
+ * Resets calibration state. Primarily for tests that run in the same
+ * process and need a clean slate between suites. With no argument it clears
+ * every bucket (including the global one); pass a key to reset just that bucket.
+ */
+export declare function resetCalibration(calibrationKey?: string): void;
+//# sourceMappingURL=token-estimate.d.ts.map

package/dist/utils/token-estimate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-estimate.d.ts","sourceRoot":"","sources":["../../src/utils/token-estimate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAyGpD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQ9D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAG1E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAUzD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,CAU1E;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,WAAW,EAAE,OAAO,CAAC;CACtB,GAAG,MAAM,CAWT;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,OAAO,EACjB,YAAY,EAAE,OAAO,EACrB,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,EAAE,EACjF,cAAc,GAAE,MAA+B,GAC9C,qBAAqB,CAqEvB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,iBAAiB,EAAE,MAAM,EACzB,oBAAoB,CAAC,EAAE,MAAM,EAC7B,cAAc,GAAE,MAA+B,GAC9C,IAAI,CAiBN;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,cAAc,GAAE,MAA+B,GAAG;IACpF,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,OAAO,CAAC;CACrB,CAOA;AAED;;;;;;;;GAQG;AACH,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,OAAO,EACjB,YAAY,EAAE,OAAO,EACrB,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,EAAE,EACjF,cAAc,GAAE,MAA+B,GAC9C,qBAAqB,CA2BvB;AAWD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAM9D"}

package/dist/utils/tool-description-mode.d.ts

@@ -0,0 +1,28 @@
+import type { ToolDescriptionMode, ToolDescriptionModeConfig } from '../types/config.js';
+import type { Tool } from '../types/tool.js';
+export declare const DEFAULT_TOOL_DESCRIPTION_MODE: ToolDescriptionMode;
+export interface ToolDescriptionRegistryLike {
+    get(name: string): Tool | undefined;
+    list(): Tool[];
+    wrap?(name: string, wrapper: (tool: Tool) => Tool, owner?: string): void;
+    setDescriptionMode?(name: string, mode: ToolDescriptionMode): boolean;
+    applyDescriptionModes?(modes?: ToolDescriptionModeConfig): {
+        applied: number;
+        missing: string[];
+    };
+    getDescriptionMode?(name: string): ToolDescriptionMode;
+}
+export declare function normalizeToolDescriptionMode(value: unknown): ToolDescriptionMode | undefined;
+export declare function resolveToolDescriptionMode(modes: ToolDescriptionModeConfig | undefined, toolName: string): ToolDescriptionMode;
+export declare function simplifyToolDescription(text: string, opts?: {
+    maxSentences?: number | undefined;
+    maxChars?: number | undefined;
+}): string;
+export declare function applyToolDescriptionModeToTool(tool: Tool, mode: ToolDescriptionMode): Tool;
+export declare function setToolDescriptionMode(registry: ToolDescriptionRegistryLike, name: string, mode: ToolDescriptionMode): boolean;
+export declare function getToolDescriptionMode(registry: ToolDescriptionRegistryLike, name: string): ToolDescriptionMode;
+export declare function applyToolDescriptionModes(registry: ToolDescriptionRegistryLike, modes?: ToolDescriptionModeConfig): {
+    applied: number;
+    missing: string[];
+};
+//# sourceMappingURL=tool-description-mode.d.ts.map

package/dist/utils/tool-description-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-description-mode.d.ts","sourceRoot":"","sources":["../../src/utils/tool-description-mode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AACzF,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE7C,eAAO,MAAM,6BAA6B,EAAE,mBAA8B,CAAC;AAa3E,MAAM,WAAW,2BAA2B;IAC1C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACpC,IAAI,IAAI,IAAI,EAAE,CAAC;IACf,IAAI,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzE,kBAAkB,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC;IACtE,qBAAqB,CAAC,CACpB,KAAK,CAAC,EAAE,yBAAyB,GAChC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC1C,kBAAkB,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAAC;CACxD;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,GAAG,SAAS,CAM5F;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,yBAAyB,GAAG,SAAS,EAC5C,QAAQ,EAAE,MAAM,GACf,mBAAmB,CAErB;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE;IAAE,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAO,GAC9E,MAAM,CA8BR;AAED,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,mBAAmB,GACxB,IAAI,CAqBN;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,2BAA2B,EACrC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAWT;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,2BAA2B,EACrC,IAAI,EAAE,MAAM,GACX,mBAAmB,CAErB;AAED,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,2BAA2B,EACrC,KAAK,CAAC,EAAE,yBAAyB,GAChC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAexC"}

package/dist/utils/tool-output-serializer.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Tool output serialization utilities.
+ * Extracted from Agent.executeTools to allow reuse and consistent output handling.
+ */
+export interface ToolOutputSerializerOptions {
+    perIterationOutputCapBytes?: number | undefined;
+    estimator?: ((text: string) => number) | undefined;
+}
+export interface ToolOutputSerializeContext {
+    toolName?: string | undefined;
+    input?: unknown;
+    /**
+     * Optional reference to the Tool object. When present and the tool defines
+     * a `serialize()` method, the serializer delegates to it instead of the
+     * central `renderToolObject()` switch (P3 #21).
+     */
+    tool?: {
+        serialize?: (output: unknown, input: unknown) => string;
+    } | undefined;
+}
+export declare function createToolOutputSerializer(opts?: ToolOutputSerializerOptions): {
+    serialize: (value: unknown, context?: ToolOutputSerializeContext) => string;
+    enforceCap: (text: string, remainingBudget: number) => {
+        text: string;
+        newBudget: number;
+    };
+    capBytes: number;
+};
+/**
+ * Render a tool result body for inclusion in the `tool.executed` event.
+ * Tool outputs can be large (file dumps, command output); UIs only want a
+ * preview line, so cap at ~400 chars with an ellipsis marker.
+ */
+export declare function truncateForEvent(content: string, max?: number): string;
+export declare function sizeSignals(toolName: string | undefined, content: string): {
+    outputBytes: number;
+    outputTokens: number;
+    outputLines: number | undefined;
+};
+//# sourceMappingURL=tool-output-serializer.d.ts.map

package/dist/utils/tool-output-serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-output-serializer.d.ts","sourceRoot":"","sources":["../../src/utils/tool-output-serializer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,2BAA2B;IAC1C,0BAA0B,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChD,SAAS,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,GAAG,SAAS,CAAC;CACpD;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;OAIG;IACH,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,KAAK,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;CAChF;AAiBD,wBAAgB,0BAA0B,CAAC,IAAI,GAAE,2BAAgC;uBAGrD,OAAO,YAAW,0BAA0B,KAAQ,MAAM;uBAkC1D,MAAM,mBAAmB,MAAM,KAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;;EAqBhG;AAmrBD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,SAAM,GAAG,MAAM,CAGnE;AAcD,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,OAAO,EAAE,MAAM,GACd;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAuBhF"}

package/dist/utils/tool-result-render-mode.d.ts

@@ -0,0 +1,55 @@
+import type { ToolResultRenderMode, ToolResultRenderModeConfig } from '../types/config.js';
+import type { Tool } from '../types/tool.js';
+export declare const DEFAULT_TOOL_RESULT_RENDER_MODE: ToolResultRenderMode;
+/**
+ * Normalize a raw value to a {@link ToolResultRenderMode}. Accepts the
+ * canonical strings (`'extend' | 'simple'`) plus a few synonyms so the
+ * slash command feels forgiving (`extended`/`full` → `extend`,
+ * `short`/`brief` → `simple`). Returns `undefined` for anything else so
+ * the caller can reject unknown input without throwing.
+ */
+export declare function normalizeToolResultRenderMode(value: unknown): ToolResultRenderMode | undefined;
+/**
+ * Look up the result-render mode for `toolName` from a config map. Falls
+ * back to the default `'extend'` when the map is missing the entry.
+ */
+export declare function resolveToolResultRenderMode(modes: ToolResultRenderModeConfig | undefined, toolName: string): ToolResultRenderMode;
+/**
+ * Subset of {@link import('../registry/tool-registry.js').ToolRegistry}
+ * the result-render-mode setters need. Decouples this module from the
+ * concrete registry class so it can be reused by tests and by tools
+ * that wrap their own registry.
+ */
+export interface ToolResultRenderModeRegistryLike {
+    get(name: string): Tool | undefined;
+    setResultRenderMode?(name: string, mode: ToolResultRenderMode): boolean;
+    applyResultRenderModes?(modes?: ToolResultRenderModeConfig): {
+        applied: number;
+        missing: string[];
+    };
+    getResultRenderMode?(name: string): ToolResultRenderMode;
+}
+/**
+ * Set a single tool's result-render mode on a registry. Prefers the
+ * registry's native accessor (so it can update any internal state, e.g.
+ * usage caches); falls back to a no-op so callers stay decoupled from
+ * the registry implementation.
+ */
+export declare function setToolResultRenderMode(registry: ToolResultRenderModeRegistryLike, name: string, mode: ToolResultRenderMode): boolean;
+/**
+ * Look up the current result-render mode for a single tool. Returns the
+ * registry's view if it has one, otherwise the default. This is what the
+ * tool-executor calls on each tool invocation to decide whether the next
+ * `writeToolResult` should be `simple` or `extend`.
+ */
+export declare function getToolResultRenderMode(registry: ToolResultRenderModeRegistryLike, name: string): ToolResultRenderMode;
+/**
+ * Bulk-apply a config map (`tools.resultRenderMode`) to a registry.
+ * Mirrors {@link import('./tool-description-mode.js').applyToolDescriptionModes}
+ * for symmetry with the LLM-side description mode.
+ */
+export declare function applyToolResultRenderModes(registry: ToolResultRenderModeRegistryLike, modes?: ToolResultRenderModeConfig): {
+    applied: number;
+    missing: string[];
+};
+//# sourceMappingURL=tool-result-render-mode.d.ts.map

package/dist/utils/tool-result-render-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result-render-mode.d.ts","sourceRoot":"","sources":["../../src/utils/tool-result-render-mode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,0BAA0B,EAC3B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE7C,eAAO,MAAM,+BAA+B,EAAE,oBAA+B,CAAC;AAE9E;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB,GAAG,SAAS,CAM9F;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,0BAA0B,GAAG,SAAS,EAC7C,QAAQ,EAAE,MAAM,GACf,oBAAoB,CAEtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,gCAAgC;IAC/C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACpC,mBAAmB,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC;IACxE,sBAAsB,CAAC,CACrB,KAAK,CAAC,EAAE,0BAA0B,GACjC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC1C,mBAAmB,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,CAAC;CAC1D;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,gCAAgC,EAC1C,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAKT;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,gCAAgC,EAC1C,IAAI,EAAE,MAAM,GACX,oBAAoB,CAEtB;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,gCAAgC,EAC1C,KAAK,CAAC,EAAE,0BAA0B,GACjC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAexC"}

package/dist/utils/tool-subject.d.ts

@@ -0,0 +1,5 @@
+export declare function escapeGlobSubject(value: string): string;
+export declare function normalizePathSubject(value: string): string;
+export declare function isPathSubjectKey(subjectKey: string): boolean;
+export declare function subjectForToolInput(toolName: string, input: unknown, subjectKey?: string): string | undefined;
+//# sourceMappingURL=tool-subject.d.ts.map

package/dist/utils/tool-subject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-subject.d.ts","sourceRoot":"","sources":["../../src/utils/tool-subject.ts"],"names":[],"mappings":"AAEA,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,EACd,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,GAAG,SAAS,CAwBpB"}

package/dist/utils/tool-wire-compact.d.ts

@@ -0,0 +1,28 @@
+export interface ToolWireDefinitionLike {
+    name: string;
+    description?: string | undefined;
+    inputSchema: unknown;
+}
+export interface CompactToolDefinitionForWireOptions {
+    /** Top-level tool description budget. */
+    descriptionMaxChars?: number | undefined;
+    /** Per-JSON-Schema `description` annotation budget. */
+    schemaDescriptionMaxChars?: number | undefined;
+}
+export interface CompactWireToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+}
+/**
+ * Return the provider-wire version of a tool definition.
+ *
+ * Tool schemas remain structurally intact: validation keywords, property
+ * names, required fields, enum values, and nested shapes are preserved. The
+ * only reduction is on human prose annotations (`description`), which are the
+ * largest repeated cost in provider tool declarations.
+ */
+export declare function compactToolDefinitionForWire(tool: ToolWireDefinitionLike, opts?: CompactToolDefinitionForWireOptions): CompactWireToolDefinition;
+export declare function compactSchemaDescriptions(schema: unknown, maxDescriptionChars?: number): Record<string, unknown>;
+export declare function compactDescription(text: string, maxChars: number): string;
+//# sourceMappingURL=tool-wire-compact.d.ts.map

package/dist/utils/tool-wire-compact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-wire-compact.d.ts","sourceRoot":"","sources":["../../src/utils/tool-wire-compact.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,mCAAmC;IAClD,yCAAyC;IACzC,mBAAmB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,uDAAuD;IACvD,yBAAyB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChD;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAOD;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,sBAAsB,EAC5B,IAAI,GAAE,mCAAwC,GAC7C,yBAAyB,CAwB3B;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,OAAO,EACf,mBAAmB,SAA+B,GACjD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGzB;AAmBD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CASzE"}

package/dist/utils/ulid.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Generate a ULID — a 26-char Crockford-base32 identifier whose first 10 chars
+ * encode the millisecond timestamp (so IDs sort lexicographically by creation
+ * time) followed by 16 chars of randomness. Zero runtime dependencies.
+ *
+ * The codebase convention is "IDs are ULIDs"; use this for any new store key.
+ */
+export declare function ulid(seedTime?: number): string;
+/** True for a well-formed 26-char Crockford-base32 ULID. */
+export declare function isUlid(value: string): boolean;
+//# sourceMappingURL=ulid.d.ts.map

package/dist/utils/ulid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ulid.d.ts","sourceRoot":"","sources":["../../src/utils/ulid.ts"],"names":[],"mappings":"AA8BA;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,QAAQ,GAAE,MAAmB,GAAG,MAAM,CAE1D;AAED,4DAA4D;AAC5D,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAM7C"}

package/dist/{wstack-paths-C3K40Qst.d.ts → utils/wstack-paths.d.ts}

@@ -6,7 +6,7 @@
  * The ONLY thing inside the project tree is the optional
  * .wrongstack/AGENTS.md (committed) and .wrongstack/skills/ (committed).
  */
-interface WstackPaths {
+export interface WstackPaths {
     /** ~/.wrongstack — global root. */
     globalRoot: string;
     /** Absolute project root. */
@@ -108,13 +108,13 @@ interface WstackPaths {
     /** Function to get the status.json path for a project given its hash. */
     projectStatus: (projectHash: string) => string;
 }
-declare function projectHash(absRoot: string): string;
+export declare function projectHash(absRoot: string): string;
 /**
  * Human-readable project directory name: slugified folder name + short hash
  * suffix for uniqueness.  e.g. `wrongstack-a1b2c3` instead of `3024e5e6fa58`.
  */
-declare function projectSlug(absRoot: string): string;
-interface WstackPathOptions {
+export declare function projectSlug(absRoot: string): string;
+export interface WstackPathOptions {
     userHome?: string | undefined;
     projectRoot: string;
     /** Override the global root (e.g. for tests). Default: `${userHome}/.wrongstack`. */
@@ -132,7 +132,6 @@ interface WstackPathOptions {
  * Every code path that wants the global dir must come through here (or
  * through `resolveWstackPaths`) instead of `path.join(os.homedir(), '.wrongstack')`.
  */
-declare function wstackGlobalRoot(): string;
-declare function resolveWstackPaths(opts: WstackPathOptions): WstackPaths;
-
-export { type WstackPaths as W, type WstackPathOptions as a, projectSlug as b, projectHash as p, resolveWstackPaths as r, wstackGlobalRoot as w };
+export declare function wstackGlobalRoot(): string;
+export declare function resolveWstackPaths(opts: WstackPathOptions): WstackPaths;
+//# sourceMappingURL=wstack-paths.d.ts.map

package/dist/utils/wstack-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wstack-paths.d.ts","sourceRoot":"","sources":["../../src/utils/wstack-paths.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AAEH,MAAM,WAAW,WAAW;IAC1B,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,yFAAyF;IACzF,UAAU,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,YAAY,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,YAAY,EAAE,MAAM,CAAC;IACrB,2GAA2G;IAC3G,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kEAAkE;IAClE,gBAAgB,EAAE,MAAM,CAAC;IACzB,0DAA0D;IAC1D,aAAa,EAAE,MAAM,CAAC;IACtB,6EAA6E;IAC7E,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iFAAiF;IACjF,WAAW,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,kBAAkB,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,oBAAoB,EAAE,MAAM,CAAC;IAC7B,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,aAAa,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,eAAe,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,kBAAkB,EAAE,MAAM,CAAC;IAC3B;gFAC4E;IAC5E,eAAe,EAAE,MAAM,CAAC;IACxB,kEAAkE;IAClE,mBAAmB,EAAE,MAAM,CAAC;IAC5B,+DAA+D;IAC/D,eAAe,EAAE,MAAM,CAAC;IACxB,gHAAgH;IAChH,qBAAqB,EAAE,MAAM,CAAC;IAC9B,wEAAwE;IACxE,gBAAgB,EAAE,MAAM,CAAC;IACzB,oFAAoF;IACpF,qBAAqB,EAAE,MAAM,CAAC;IAC9B,gFAAgF;IAChF,mBAAmB,EAAE,MAAM,CAAC;IAC5B,4FAA4F;IAC5F,kBAAkB,EAAE,MAAM,CAAC;IAC3B,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,kFAAkF;IAClF,WAAW,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,WAAW,EAAE,MAAM,CAAC;IACpB,kFAAkF;IAClF,mBAAmB,EAAE,MAAM,CAAC;IAC5B,2DAA2D;IAC3D,YAAY,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,yEAAyE;IACzE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iEAAiE;IACjE,WAAW,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,gBAAgB,EAAE,MAAM,CAAC;IACzB,6FAA6F;IAC7F,gBAAgB,EAAE,MAAM,CAAC;IACzB,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,aAAa,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,MAAM,CAAC;CAChD;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAInD;AAcD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAIzC;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,GAAG,WAAW,CA4DvE"}

package/dist/worktree/index.d.ts

@@ -0,0 +1,2 @@
+export { WorktreeManager, assertSafePath, type WorktreeHandle, type WorktreeStatus, type WorktreeManagerOptions, type AllocateOpts, type MergeOpts, type MergeResult, type RunResult as WorktreeRunResult, } from './worktree-manager.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/worktree/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,cAAc,EACd,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC3B,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,SAAS,IAAI,iBAAiB,GACpC,MAAM,uBAAuB,CAAC"}

package/dist/{worktree-manager-DzwxKE35.d.ts → worktree/worktree-manager.d.ts}

@@ -1,5 +1,4 @@
-import { E as EventBus } from './events-Bgnh43r9.js';
-
+import type { EventBus } from '../kernel/events.js';
 /**
  * Lifecycle of a single worktree handle.
  *
@@ -7,8 +6,8 @@ import { E as EventBus } from './events-Bgnh43r9.js';
  *                                            └─→ needs-review (conflict, kept)
  *   (any)      → failed
  */
-type WorktreeStatus = 'allocating' | 'active' | 'committing' | 'merging' | 'merged' | 'needs-review' | 'failed';
-interface WorktreeHandle {
+export type WorktreeStatus = 'allocating' | 'active' | 'committing' | 'merging' | 'merged' | 'needs-review' | 'failed';
+export interface WorktreeHandle {
     /** Stable id (== slug). Used as the event `handleId`. */
     id: string;
     /** Caller-supplied owner (a phase id in AutoPhase). */
@@ -33,14 +32,14 @@ interface WorktreeHandle {
     lastError?: string | undefined;
     conflictFiles?: string[] | undefined;
 }
-interface AllocateOpts {
+export interface AllocateOpts {
     /** Friendly basis for the slug/branch (e.g. the phase name). */
     slugHint?: string | undefined;
     ownerLabel?: string | undefined;
     /** Override the detected base branch. */
     baseBranch?: string | undefined;
 }
-interface MergeOpts {
+export interface MergeOpts {
     squash?: boolean | undefined;
     message?: string | undefined;
     /**
@@ -57,7 +56,7 @@ interface MergeOpts {
         cwd: string;
     }) => Promise<boolean>;
 }
-interface MergeResult {
+export interface MergeResult {
     ok: boolean;
     conflict?: boolean | undefined;
     conflictFiles?: string[] | undefined;
@@ -65,12 +64,12 @@ interface MergeResult {
     /** True when an initial conflict was successfully resolved by `opts.resolve`. */
     resolved?: boolean | undefined;
 }
-interface RunResult {
+export interface RunResult {
     code: number;
     stdout: string;
     stderr: string;
 }
-interface WorktreeManagerOptions {
+export interface WorktreeManagerOptions {
     projectRoot: string;
     events?: EventBus | undefined;
     sessionId?: string | (() => string | undefined) | undefined;
@@ -87,7 +86,7 @@ interface WorktreeManagerOptions {
  * worktree directories without the tool's permission gate or `findGitDir`
  * resolution, and so `@wrongstack/core` keeps no dependency on `@wrongstack/tools`.
  */
-declare class WorktreeManager {
+export declare class WorktreeManager {
     private readonly projectRoot;
     private readonly events?;
     private readonly sessionIdSource;
@@ -231,10 +230,19 @@ declare class WorktreeManager {
      */
     private tryResolveConflict;
     /**
-     * True when staged content still carries conflict markers. `git diff --cached
-     * --check` exits nonzero and prints a "leftover conflict marker" line for each
-     * survivor; whitespace-only errors (also flagged by --check) are ignored so a
-     * clean resolution with unrelated whitespace is not rejected.
+     * True when staged content still carries conflict markers.
+     *
+     * Primary probe: `git grep --cached` scans the STAGED blobs directly for a
+     * full marker line (`<<<<<<< `, `=======`, `>>>>>>> `, `||||||| `) — exit 0
+     * means found. This is byte-level and independent of git version, locale,
+     * and human-output phrasing. When the caller knows which files conflicted,
+     * the scan is restricted to them so an unrelated `=======` underline in
+     * some document can't false-positive.
+     *
+     * Fallback probe: `git diff --cached --check` prints a "leftover conflict
+     * marker" line per survivor. Kept as belt-and-braces — it was the original
+     * sole probe, but CI runners were observed to miss markers through it
+     * (output parsing), which let a half-resolved merge commit.
      */
     private hasConflictMarkers;
     /**
@@ -267,7 +275,14 @@ declare class WorktreeManager {
     private currentSessionId;
     private defaultRun;
 }
+/**
+ * Extract conflicted paths from git merge output. Git prints one
+ * `CONFLICT (<kind>): Merge conflict in <path>` line per conflicted file to
+ * stdout — a portable signal that doesn't depend on the post-merge index
+ * state (which `git diff --diff-filter=U` can report as empty on some runners
+ * after a `--squash` conflict).
+ */
+export declare function parseConflictPaths(output: string): string[];
 /** Throw if `dir` resolves outside `projectRoot`. */
-declare function assertSafePath(dir: string, projectRoot: string): void;
-
-export { type AllocateOpts as A, type MergeOpts as M, type RunResult as R, WorktreeManager as W, type MergeResult as a, type WorktreeHandle as b, type WorktreeManagerOptions as c, type WorktreeStatus as d, assertSafePath as e };
+export declare function assertSafePath(dir: string, projectRoot: string): void;
+//# sourceMappingURL=worktree-manager.d.ts.map

package/dist/worktree/worktree-manager.d.ts.map

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

package/instructions/agents/browser.md

@@ -10,18 +10,26 @@ Scope:
 - Evaluate JavaScript in the page context to extract structured data
 - Verify visual state (element visibility, text content, attribute values)
 
-Playwright tools available (require the "playwright" MCP server to be enabled):
-  playwright_navigate(url)          — open a page at the given URL
-  playwright_screenshot()           — capture a full-page or viewport screenshot
-  playwright_click(selector)        — click on an element matching a CSS selector
-  playwright_type(selector, text)   — type text into a focused input element
-  playwright_evaluate(script)       — run arbitrary JavaScript in the page context
-  playwright_select_option(selector, value) — pick a <select> dropdown option
-  playwright_hover(selector)        — hover the mouse over an element
-  playwright_fill_form(fields)      — fill multiple form fields in one call
-  playwright_wait_for(selector)     — block until an element appears on the page
-  playwright_press_key(key)         — press a keyboard key (Enter, Tab, Escape, …)
-  playwright_drag(from, to)         — drag an element from one selector to another
+First-party browser tools (no MCP server configuration required):
+  browser_status()                         — check Playwright Chromium installation
+  browser_open(url?)                       — open an isolated session; returns sessionId
+  browser_list()                           — list only this agent's sessions
+  browser_navigate(sessionId, url)         — navigate to an approved URL
+  browser_snapshot(sessionId)              — bounded accessibility + console/network evidence
+  browser_screenshot(sessionId, ...)       — capture a durable PNG artifact
+  browser_click(sessionId, selector)       — click an element
+  browser_type(sessionId, selector, text)  — fill an input
+  browser_select(sessionId, selector, value) — pick a select option
+  browser_hover(sessionId, selector)       — hover an element
+  browser_wait(sessionId, selector?)       — wait for an element or bounded duration
+  browser_press(sessionId, key)            — press a keyboard key
+  browser_drag(sessionId, from, to)        — drag between elements
+  browser_evaluate(sessionId, expression)  — confirmed arbitrary page evaluation
+  browser_upload(sessionId, selector, files) — confirmed project-local upload
+  browser_close(sessionId)                 — close and return the trace artifact
+
+The optional Playwright MCP preset may coexist; its `playwright_*` names do not
+collide with the first-party `browser_*` namespace.
 
 Input format you accept:
 { "task": "navigate | screenshot | extract | interact | verify", "url": "<url>", "steps": ["step1", "step2"] }
@@ -34,10 +42,11 @@ Output: Structured markdown report:
 - ## Errors (any failures with stack traces)
 
 Working rules:
-- Always playwright_navigate first before any interaction
-- Always playwright_wait_for after navigation to ensure the page is ready
-- playwright_screenshot is your primary evidence — use it before and after interactions
-- Use playwright_evaluate for structured data extraction (JSON, text content)
+- Always browser_open first, then pass its sessionId to every operation
+- Always browser_wait after navigation to ensure the page is ready
+- browser_screenshot is your primary evidence — use it before and after interactions
+- Use browser_snapshot before browser_evaluate; evaluation is confirmed and reserved for data the snapshot cannot expose
+- Always browser_close when finished; run disposal also closes owned sessions as a safety net
 - If a selector fails, try alternative selectors before giving up
 - Report exact CSS selectors used — they're part of the evidence
 - If playwright tools are unavailable, report the error immediately — do not guess

package/instructions/autonomy/active-mission.md

@@ -21,10 +21,8 @@ whitespace-tolerant, but they must occupy the entire line:
   decide.
 
 ### Operating principles
-- YOLO is active for normal project work. Proceed with routine
-  in-project tool use without pre-confirming; pick the best path and execute it.
-  If the permission system raises a destructive-gated confirmation, wait
-  for that flow instead of trying to bypass it.
+- YOLO is active. Proceed with tool use without pre-confirming unless an
+  explicit deny rule blocks the call; pick the best path and execute it.
 - Use tools freely; multiple calls per turn are normal and expected.
 - When working on a todo, mark it `in_progress` via the todos tool
   before tool work and `completed` (or `cancelled` with a reason)

package/instructions/coordination/subagent-baseline.md

@@ -6,6 +6,13 @@ Capabilities & operating rules:
     dependency install) and run non-interactively: routine work is
     pre-authorized, so finish the task end-to-end without stopping to ask
     permission to read, edit, or build.
+  - Memory tools (`remember`, `search_memory`, `find_related_memories`) are
+    available and share the project's knowledge base. Before every tool call
+    on an unfamiliar file, `search_memory` for relevant context. After
+    discovering a convention, file path, bug root cause, or making a
+    decision, `remember` it with type, scope, priority, and tags so the
+    Director and future agents see it. Use `project-memory` scope for
+    codebase facts, `user-memory` for preferences.
   - Stay inside the project root. Do not touch machine config, credentials,
     or global state — those require an explicit grant you do not have.
   - Respect your current working directory. When the Director gives you an
@@ -42,8 +49,15 @@ Bridge contract:
 CRITICAL CONSTRAINT — NO FURTHER DELEGATION:
   - You MUST NOT call `delegate`, `spawn_subagent`, `assign_task`, or any
     equivalent. Execute the assigned task yourself; do not orchestrate.
-  - If a subtask is too complex, report what you found and let the Director
-    decide how to decompose.
+  - If the assigned task is genuinely too large for one worker, finish a clean,
+    useful checkpoint instead of running until forced termination. Call
+    `submit_result` with `completion: "partial"` and a concrete `remaining_work`
+    description; the `delegate` tool can hand that remainder to a fresh worker.
+  - You still MUST NOT spawn that worker yourself. If an independent parallel
+    helper would materially improve the result, use `mail_send` (or mailbox
+    send) with type `ask` to request one from the leader. Name the exact helper
+    task, why it is independent, and what result you need; then continue your
+    own assigned slice unless blocked.
 
 Inter-agent mailbox (if you have the `mail_send`/`mail_inbox`/`mailbox` tools):
   - Your identity is `<your-name>@<session-tag>` (unique per session). Mail

package/instructions/leader-after-task.md

@@ -18,5 +18,7 @@ Rules:
 - **Omit the tag entirely while the live `ctx.todos` list has any `pending` or `in_progress` item.** Finishing the in-flight todo list takes priority, and the runtime discards `<nextsteps>` in that state anyway. Emit it again on the turn the last todo flips to `completed`.
 - If you have no genuinely useful suggestions, omit the tag.
 
-**After a significant task, also post a status update** to the inter-agent mailbox so other agents can discover what you finished and route follow-on work:
+**After a significant task, remember key findings** — file paths you touched, conventions you noticed, decisions you made. Use `remember` with appropriate type, scope, priority, and tags so future sessions benefit.
+
+**Also post a status update** to the inter-agent mailbox so other agents can discover what you finished and route follow-on work:
 `mailbox action=send to=* type=status subject="<one-line task summary>" body="<brief outcome>"`

package/instructions/sections/tool/common-patterns.md

@@ -5,5 +5,11 @@
 - **Verify after mutate:** `write`/`edit`/`patch` -> `read` back to confirm -> report outcome
 - **Explore project:** `glob` for structure -> `read` key files -> `grep` for patterns
 - **Batch ops:** Use `replace` with glob patterns for multi-file surgical changes
+- **Memory before tool calls:** Before `read`/`edit`/`grep`/`glob` on unfamiliar files, `search_memory` for relevant context and include a hint in your reasoning
+- **Remember every file path:** Every time you discover a useful file, `remember` its path with `type: "reference"`, tags: #path
+- **Remember every convention:** Every time you notice a pattern, `remember` it with `type: "convention"`, appropriate scope, and tags
+- **Remember decisions:** Before resolving ambiguity, `remember` the decision with `type: "decision"` so future turns don't re-litigate
+- **Resume informed:** When starting work on a new area, `search_memory`/`find_related_memories` to surface past decisions
+- **Memory-driven context:** Include memory hints in your reasoning during tool calls — the LLM reasons better with concrete context
 
-When unsure about a file's current state, read it first rather than assuming.
+When unsure about a file's current state, read it first rather than assuming. When unsure about a project's conventions, search memory first.