zidane 5.6.11 → 5.6.13

package/dist/index.js

@@ -1,16 +1,177 @@
-import { A as resolvePersistDir, C as TOOL_USE_SKIPPED_MESSAGE, D as buildPersistedStub, E as PERSISTENCE_PREVIEW_BYTES, F as resolveReadStateMap, M as getReadState, O as cleanupPersistedSession, P as readStateKey, S as TOOL_USE_CANCELLED_MESSAGE, T as PERSISTED_STUB_PREFIX, _ as createSkillsReadTool, a as multiEdit, b as INTERRUPT_MESSAGE_FOR_TOOL_USE, c as grep, g as createSkillsRunScriptTool, h as createSkillsUseTool, j as resolveTasksDir, k as maybePersistToolResult, l as glob, n as createSpawnTool, p as createAgent, s as createInteractionTool, u as edit, v as createShellTool, w as validateToolArgs, x as SHELL_CASCADE_CANCEL_MESSAGE } from "./tools-CxOfTt3R.js";
+import { A as resolvePersistDir, C as TOOL_USE_SKIPPED_MESSAGE, D as buildPersistedStub, E as PERSISTENCE_PREVIEW_BYTES, F as resolveReadStateMap, M as getReadState, O as cleanupPersistedSession, P as readStateKey, S as TOOL_USE_CANCELLED_MESSAGE, T as PERSISTED_STUB_PREFIX, _ as createSkillsReadTool, a as multiEdit, b as INTERRUPT_MESSAGE_FOR_TOOL_USE, c as grep, g as createSkillsRunScriptTool, h as createSkillsUseTool, j as resolveTasksDir, k as maybePersistToolResult, l as glob, n as createSpawnTool, p as createAgent, s as createInteractionTool, u as edit, v as createShellTool, w as validateToolArgs, x as SHELL_CASCADE_CANCEL_MESSAGE } from "./tools-DE9pR_NG.js";
 import { n as createProcessContext, t as createSandboxContext } from "./contexts-BOtMvzli.js";
 import { a as AgentToolNotAllowedError, c as errorMessage, i as AgentProviderError, l as matchesContextExceeded, n as AgentBudgetExceededError, o as AgentToolPairingError, r as AgentContextExceededError, s as CONTEXT_EXCEEDED_MESSAGE_PATTERNS, t as AgentAbortedError, u as toTypedError } from "./errors-DdZXnyXE.js";
 import { n as toolOutputByteLength, r as toolResultToText } from "./types-oKPBdCmL.js";
-import { _ as openaiCompat, a as detectTurnInterruption, b as sanitizeToolSchema, c as filterUnresolvedToolUses, d as toAnthropic, f as toOpenAI, g as mapOAIFinishReason, h as classifyOpenAICompatError, i as autoDetectAndConvert, l as fromAnthropic, n as SYNTHETIC_TOOL_RESULT_PLACEHOLDER, p as OpenAICompatHttpError, r as TOOL_USE_INTERRUPTED_MARKER, s as ensureToolResultPairing, t as ORPHANED_TOOL_RESULT_MARKER, u as fromOpenAI, x as sanitizeToolSpecs } from "./messages-BfmXLDT4.js";
-import { c as createMemoryMcpCredentialStore, i as resultToString, l as hasAuthorizationHeader, n as normalizeMcpBlocks, r as normalizeMcpServers, s as McpOAuthProvider, t as connectMcpServers } from "./mcp-0jRkIV0g.js";
+import { A as replaceDynamicSection, D as hasSystemPromptBoundary, E as appendStaticSection, O as joinSystemPrompt, S as sanitizeToolSpecs, T as appendDynamicSection, _ as mapOAIFinishReason, a as detectTurnInterruption, c as filterUnresolvedToolUses, d as toAnthropic, f as toOpenAI, g as classifyOpenAICompatError, i as autoDetectAndConvert, j as splitSystemPrompt, k as renderSystemForWire, l as fromAnthropic, m as OpenAICompatHttpError, n as SYNTHETIC_TOOL_RESULT_PLACEHOLDER, o as ensureEndsWithUserMessage, p as toWireMessages, r as TOOL_USE_INTERRUPTED_MARKER, s as ensureToolResultPairing, t as ORPHANED_TOOL_RESULT_MARKER, u as fromOpenAI, v as openaiCompat, w as SYSTEM_PROMPT_BOUNDARY, x as sanitizeToolSchema } from "./messages-Dym8S_YH.js";
+import { c as createMemoryMcpCredentialStore, i as resultToString, l as hasAuthorizationHeader, n as normalizeMcpBlocks, r as normalizeMcpServers, s as McpOAuthProvider, t as connectMcpServers } from "./mcp-DGeB7-3D.js";
 import { _ as validateResourcePath, a as discoverSkills, b as createSkillActivationState, f as IMPLICITLY_ALLOWED_SKILL_TOOLS, g as parseAllowedToolPattern, h as matchesAllowedTool, i as writeSkillsToDisk, l as parseSkillFile, m as isToolAllowedByUnion, n as resolveSkills, p as installAllowedToolsGate, r as writeSkillToDisk, t as interpolateShellCommands, u as buildCatalog, v as validateSkillForWrite, y as validateSkillName } from "./interpolate-DM1UcKeQ.js";
-import { C as summaryToTurn, E as CompactPromptTooLongError, S as stripImagesFromTurns, T as CompactInvalidInputError, _ as buildTailCompactPrompt, a as selectFilesFromSession, b as anchorPreviewFor, c as BYTES_PER_TOKEN, d as BASE_INSTRUCTIONS, f as NO_TOOLS_PREAMBLE, g as buildFullCompactPrompt, h as buildFromCompactPrompt, i as selectFilesFromReadState, l as estimateTokens, m as buildCompactPrompt, n as startOAuthCallback, o as selectRecentFiles, p as TRAILER, r as buildPostCompactAttachments, s as compactConversation, t as loginMcpServer, u as utf8ByteLength, v as buildUpToCompactPrompt, w as truncateHeadForPtlRetry, x as sliceForCompaction, y as ANCHOR_PREVIEW_MAX_CHARS } from "./login-BindcfKi.js";
+import { C as summaryToTurn, E as CompactPromptTooLongError, S as stripImagesFromTurns, T as CompactInvalidInputError, _ as buildTailCompactPrompt, a as selectFilesFromSession, b as anchorPreviewFor, c as BYTES_PER_TOKEN, d as BASE_INSTRUCTIONS, f as NO_TOOLS_PREAMBLE, g as buildFullCompactPrompt, h as buildFromCompactPrompt, i as selectFilesFromReadState, l as estimateTokens, m as buildCompactPrompt, n as startOAuthCallback, o as selectRecentFiles, p as TRAILER, r as buildPostCompactAttachments, s as compactConversation, t as loginMcpServer, u as utf8ByteLength, v as buildUpToCompactPrompt, w as truncateHeadForPtlRetry, x as sliceForCompaction, y as ANCHOR_PREVIEW_MAX_CHARS } from "./login-DS3sf6b5.js";
 import { r as statsByModel, t as flattenTurns } from "./stats-Lc3zL3RM.js";
-import { i as basic_default, n as definePreset, r as basicTools } from "./presets-CmzMeWg2.js";
-import { i as anthropic, n as openai, r as cerebras, t as openrouter } from "./providers-C_ahnRBS.js";
-import { a as createFileMapStore, i as createMemoryStore, n as loadSession, r as createRemoteStore, t as createSession } from "./session-PUzXZlG6.js";
+import { i as basic_default, n as definePreset, r as basicTools } from "./presets-CZXS_87d.js";
+import { a as applyAnthropicCacheBreakpoints, i as anthropic, n as openai, r as cerebras, t as openrouter } from "./providers-beXyD9W9.js";
+import { a as createFileMapStore, i as createMemoryStore, n as loadSession, r as createRemoteStore, t as createSession } from "./session-BRIsmBSY.js";
 import { defineSkill } from "./skills.js";
+//#region src/cache-telemetry.ts
+const FNV_OFFSET = 2166136261;
+const FNV_PRIME = 16777619;
+/**
+* FNV-1a 32-bit hash of a UTF-8 string. Pure, allocation-free, ~10 ns per
+* KB. Cryptographic strength is irrelevant here — we only need byte-change
+* detection, and FNV-1a has effectively zero collision risk for the small
+* number of dimensions tracked.
+*
+* Exported for tests; callers shouldn't typically import directly.
+*/
+function fnv1a32(s) {
+	let h = FNV_OFFSET;
+	for (let i = 0; i < s.length; i++) {
+		h ^= s.charCodeAt(i) & 255;
+		h = Math.imul(h, FNV_PRIME);
+	}
+	return h >>> 0;
+}
+/**
+* Build a {@link CacheDimensionSnapshot} from a `turn:before` payload.
+*
+* Pure — exported so hosts can compute snapshots outside the logger (e.g.
+* stamping them onto custom telemetry spans). The hash is deterministic on
+* byte-identical inputs.
+*/
+function snapshotCacheDimensions(options) {
+	const toolsJson = JSON.stringify(options.tools ?? []);
+	return {
+		systemHash: fnv1a32(options.system),
+		systemBytes: options.system.length,
+		toolsHash: fnv1a32(toolsJson),
+		toolsCount: Array.isArray(options.tools) ? options.tools.length : 0,
+		model: options.model,
+		thinking: options.thinking ?? "off",
+		thinkingBudget: options.thinkingBudget ?? 0
+	};
+}
+/**
+* Compare two snapshots and return the list of dimensions whose bytes
+* differ. The `details` map carries a short human-readable description per
+* changed dimension (e.g. `system: 1024 → 1031 bytes`).
+*
+* Pure / no I/O. Use this in tests to assert the diff logic; the logger
+* itself just formats and emits the result.
+*/
+function diffCacheDimensions(prev, curr) {
+	const changed = [];
+	const details = {};
+	if (prev.systemHash !== curr.systemHash) {
+		changed.push("system");
+		details.system = `${prev.systemBytes} → ${curr.systemBytes} bytes (hash ${hex(prev.systemHash)} → ${hex(curr.systemHash)})`;
+	}
+	if (prev.toolsHash !== curr.toolsHash) {
+		changed.push("tools");
+		details.tools = `${prev.toolsCount} → ${curr.toolsCount} tools (hash ${hex(prev.toolsHash)} → ${hex(curr.toolsHash)})`;
+	}
+	if (prev.model !== curr.model) {
+		changed.push("model");
+		details.model = `${prev.model} → ${curr.model}`;
+	}
+	if (prev.thinking !== curr.thinking) {
+		changed.push("thinking");
+		details.thinking = `${prev.thinking} → ${curr.thinking}`;
+	}
+	if (prev.thinkingBudget !== curr.thinkingBudget) {
+		changed.push("thinkingBudget");
+		details.thinkingBudget = `${prev.thinkingBudget} → ${curr.thinkingBudget}`;
+	}
+	return {
+		changed,
+		details
+	};
+}
+function hex(n) {
+	return `0x${n.toString(16).padStart(8, "0")}`;
+}
+/**
+* Install the cache-break logger on an agent's hook bus.
+*
+* Subscribes to `turn:before` (snapshot) + `turn:after` (compare with prior
+* snapshot, log breaks). Returns an `uninstall` fn that detaches both
+* listeners. Idempotent w.r.t. agent lifecycle — installs/uninstalls cleanly
+* across runs.
+*
+* Recommended setup:
+*
+* ```ts
+* const uninstall = installCacheBreakLogger(agent.hooks, {
+*   log: line => logger.debug(line),
+*   verbose: !!process.env.ZIDANE_DEBUG?.includes('cache'),
+* })
+* // ...
+* uninstall()
+* ```
+*
+* Performance: hashing runs on each `turn:before` and is bounded by the
+* input size (system + tools serialization). Disabled callers pay nothing
+* (don't install).
+*/
+function installCacheBreakLogger(hooks, options = {}) {
+	const log = options.log ?? ((line) => console.error(line));
+	const verbose = options.verbose === true;
+	const expectedReadAtLeast = options.expectedReadAtLeast ?? 1;
+	let prev;
+	let turnIndex = 0;
+	let pending;
+	function onTurnBefore(ctx) {
+		const curr = snapshotCacheDimensions(ctx.options);
+		turnIndex += 1;
+		if (verbose) log(formatVerboseLine({
+			turn: turnIndex,
+			turnId: ctx.turnId,
+			snapshot: curr
+		}));
+		pending = {
+			snapshot: curr,
+			turnIndex,
+			turnId: ctx.turnId
+		};
+	}
+	function onTurnAfter(ctx) {
+		if (!pending || pending.turnId !== ctx.turnId) return;
+		const { snapshot: curr, turnIndex: tIdx } = pending;
+		pending = void 0;
+		if (prev && tIdx > 1 && typeof ctx.usage.cacheRead === "number") {
+			const cacheRead = ctx.usage.cacheRead;
+			if (cacheRead < expectedReadAtLeast) {
+				const diff = diffCacheDimensions(prev, curr);
+				if (diff.changed.length > 0) log(formatBreakLine({
+					turn: tIdx,
+					turnId: ctx.turnId,
+					cacheRead,
+					cacheCreation: ctx.usage.cacheCreation ?? 0,
+					diff
+				}));
+			}
+		}
+		prev = curr;
+	}
+	const unregisterBefore = hooks.hook("turn:before", onTurnBefore);
+	const unregisterAfter = hooks.hook("turn:after", onTurnAfter);
+	return () => {
+		unregisterBefore();
+		unregisterAfter();
+	};
+}
+function formatBreakLine(input) {
+	const names = input.diff.changed.join(", ");
+	const details = input.diff.changed.map((d) => `  ${d}: ${input.diff.details[d]}`).join("\n");
+	return [
+		`[zidane:cache-break] turn=${input.turn} turnId=${input.turnId} cacheRead=${input.cacheRead} cacheCreation=${input.cacheCreation}`,
+		`  changed: ${names}`,
+		details
+	].join("\n");
+}
+function formatVerboseLine(input) {
+	const s = input.snapshot;
+	return `[zidane:cache] turn=${input.turn} turnId=${input.turnId} system=${hex(s.systemHash)}(${s.systemBytes}b) tools=${hex(s.toolsHash)}(${s.toolsCount}) model=${s.model} thinking=${s.thinking}/${s.thinkingBudget}`;
+}
+//#endregion
 //#region src/logger.ts
 /**
 * Build a Logger from a sink. Stateless and cheap; create one per agent
@@ -1616,6 +1777,6 @@ function zodToJsonSchema(jsonSchema) {
 	return rest;
 }
 //#endregion
-export { ANCHOR_PREVIEW_MAX_CHARS, AgentAbortedError, AgentBudgetExceededError, AgentContextExceededError, AgentProviderError, AgentToolNotAllowedError, AgentToolPairingError, BASE_INSTRUCTIONS, BYTES_PER_TOKEN, CONTEXT_EXCEEDED_MESSAGE_PATTERNS, CompactInvalidInputError, CompactPromptTooLongError, GEN_AI_ATTRIBUTES, IMPLICITLY_ALLOWED_SKILL_TOOLS, INTERRUPT_MESSAGE_FOR_TOOL_USE, McpOAuthProvider, NO_TOOLS_PREAMBLE, ORPHANED_TOOL_RESULT_MARKER, OpenAICompatHttpError, PERSISTED_STUB_PREFIX, PERSISTENCE_PREVIEW_BYTES, SHELL_CASCADE_CANCEL_MESSAGE, SYNTHETIC_TOOL_RESULT_PLACEHOLDER, TOOL_USE_CANCELLED_MESSAGE, TOOL_USE_INTERRUPTED_MARKER, TOOL_USE_SKIPPED_MESSAGE, TRAILER, anchorPreviewFor, anthropic, autoDetectAndConvert, basic_default as basic, basicTools, buildCatalog, buildCompactPrompt, buildFromCompactPrompt, buildFullCompactPrompt, buildPersistedStub, buildPostCompactAttachments, buildTailCompactPrompt, buildUpToCompactPrompt, cerebras, classifyOpenAICompatError, cleanupPersistedSession, compactConversation, connectMcpServers, consoleSink, createAgent, createFileMapStore, createInteractionTool, createLogger, createLoggingHooks, createMemoryMcpCredentialStore, createMemoryStore, createMetricsHooks, createProcessContext, createRemoteStore, createRunSummaryCollector, createSandboxContext, createSession, createShellTool, createSkillActivationState, createSkillsReadTool, createSkillsRunScriptTool, createSkillsUseTool, createSpawnTool, createTracingHooks, definePreset, defineSkill, detectTurnInterruption, discoverSkills, edit, ensureToolResultPairing, errorMessage, estimateTokens, filterUnresolvedToolUses, flattenTurns, fromAnthropic, fromOpenAI, getReadState, glob, grep, hasAuthorizationHeader, installAllowedToolsGate, interpolateShellCommands, isToolAllowedByUnion, jsonSink, loadSession, loginMcpServer, mapOAIFinishReason, matchesAllowedTool, matchesContextExceeded, maybePersistToolResult, multiEdit, normalizeMcpBlocks, normalizeMcpServers, openai, openaiCompat, openrouter, parseAllowedToolPattern, parseSkillFile, readStateKey, resolvePersistDir, resolveReadStateMap, resolveSkills, resolveTasksDir, resultToString, sanitizeToolSchema, sanitizeToolSpecs, selectFilesFromReadState, selectFilesFromSession, selectRecentFiles, sliceForCompaction, startOAuthCallback, statsByModel, stripImagesFromTurns, summaryToTurn, toAnthropic, toOpenAI, toTypedError, toolOutputByteLength, toolResultToText, truncateHeadForPtlRetry, utf8ByteLength, validateResourcePath, validateSkillForWrite, validateSkillName, validateToolArgs, writeSkillToDisk, writeSkillsToDisk, zodToJsonSchema };
+export { ANCHOR_PREVIEW_MAX_CHARS, AgentAbortedError, AgentBudgetExceededError, AgentContextExceededError, AgentProviderError, AgentToolNotAllowedError, AgentToolPairingError, BASE_INSTRUCTIONS, BYTES_PER_TOKEN, CONTEXT_EXCEEDED_MESSAGE_PATTERNS, CompactInvalidInputError, CompactPromptTooLongError, GEN_AI_ATTRIBUTES, IMPLICITLY_ALLOWED_SKILL_TOOLS, INTERRUPT_MESSAGE_FOR_TOOL_USE, McpOAuthProvider, NO_TOOLS_PREAMBLE, ORPHANED_TOOL_RESULT_MARKER, OpenAICompatHttpError, PERSISTED_STUB_PREFIX, PERSISTENCE_PREVIEW_BYTES, SHELL_CASCADE_CANCEL_MESSAGE, SYNTHETIC_TOOL_RESULT_PLACEHOLDER, SYSTEM_PROMPT_BOUNDARY, TOOL_USE_CANCELLED_MESSAGE, TOOL_USE_INTERRUPTED_MARKER, TOOL_USE_SKIPPED_MESSAGE, TRAILER, anchorPreviewFor, anthropic, appendDynamicSection, appendStaticSection, applyAnthropicCacheBreakpoints, autoDetectAndConvert, basic_default as basic, basicTools, buildCatalog, buildCompactPrompt, buildFromCompactPrompt, buildFullCompactPrompt, buildPersistedStub, buildPostCompactAttachments, buildTailCompactPrompt, buildUpToCompactPrompt, cerebras, classifyOpenAICompatError, cleanupPersistedSession, compactConversation, connectMcpServers, consoleSink, createAgent, createFileMapStore, createInteractionTool, createLogger, createLoggingHooks, createMemoryMcpCredentialStore, createMemoryStore, createMetricsHooks, createProcessContext, createRemoteStore, createRunSummaryCollector, createSandboxContext, createSession, createShellTool, createSkillActivationState, createSkillsReadTool, createSkillsRunScriptTool, createSkillsUseTool, createSpawnTool, createTracingHooks, definePreset, defineSkill, detectTurnInterruption, diffCacheDimensions, discoverSkills, edit, ensureEndsWithUserMessage, ensureToolResultPairing, errorMessage, estimateTokens, filterUnresolvedToolUses, flattenTurns, fnv1a32, fromAnthropic, fromOpenAI, getReadState, glob, grep, hasAuthorizationHeader, hasSystemPromptBoundary, installAllowedToolsGate, installCacheBreakLogger, interpolateShellCommands, isToolAllowedByUnion, joinSystemPrompt, jsonSink, loadSession, loginMcpServer, mapOAIFinishReason, matchesAllowedTool, matchesContextExceeded, maybePersistToolResult, multiEdit, normalizeMcpBlocks, normalizeMcpServers, openai, openaiCompat, openrouter, parseAllowedToolPattern, parseSkillFile, readStateKey, renderSystemForWire, replaceDynamicSection, resolvePersistDir, resolveReadStateMap, resolveSkills, resolveTasksDir, resultToString, sanitizeToolSchema, sanitizeToolSpecs, selectFilesFromReadState, selectFilesFromSession, selectRecentFiles, sliceForCompaction, snapshotCacheDimensions, splitSystemPrompt, startOAuthCallback, statsByModel, stripImagesFromTurns, summaryToTurn, toAnthropic, toOpenAI, toTypedError, toWireMessages, toolOutputByteLength, toolResultToText, truncateHeadForPtlRetry, utf8ByteLength, validateResourcePath, validateSkillForWrite, validateSkillName, validateToolArgs, writeSkillToDisk, writeSkillsToDisk, zodToJsonSchema };
 
 //# sourceMappingURL=index.js.map