@caupulican/pi-agent-core 0.93.2 → 0.93.4

package/dist/tool-failure-memory.d.ts

@@ -19,6 +19,8 @@ export interface ToolFailureMemoryRecord {
     phase: ToolFailurePhase;
     failureCode: string;
     diagnostic?: string;
+    /** Bounded tool-owned source evidence needed to construct a changed operation. */
+    evidence?: string;
     correction: string;
     attemptMemory?: "discard";
 }
@@ -37,8 +39,12 @@ export interface ToolFailureDirectiveDetails {
 }
 export type ToolFailureResultDetails = ToolFailureMemoryDetails | ToolFailureDirectiveDetails;
 export type ToolFailureMemoryTracker = Map<string, ToolFailureMemoryRecord>;
+/** Normalize and bound tool-owned evidence at every live and persisted ingress. */
+export declare function sanitizeToolFailureEvidence(value: unknown): string | undefined;
 export declare function normalizeToolSignature(pairs: Array<[string, unknown]>): string;
 export declare function getToolExecutionKey(tool: string, args: unknown): string;
+/** Read the four hash words already encoded by this module's exact execution-key owner. */
+export declare function getToolExecutionKeyHashParts(executionKey: string): readonly [number, number, number, number];
 export declare function getToolFailureRecordExecutionKey(record: ToolFailureMemoryRecord): string | undefined;
 export declare function getUnresolvedToolFailure(tracker: ToolFailureMemoryTracker, tool: string, args: unknown): ToolFailureMemoryRecord | undefined;
 export declare function readVisibleToolFailureCode(result: ToolResultMessage): string | undefined;
@@ -74,7 +80,7 @@ export interface ToolFailureTelemetry {
 /** Read only bounded failure identity and guidance; operation arguments never cross this telemetry boundary. */
 export declare function readToolFailureTelemetry(details: unknown): ToolFailureTelemetry | undefined;
 export declare function createToolFailureMemoryTracker(messages: AgentMessage[]): ToolFailureMemoryTracker;
-export declare function rememberToolFailure(tracker: ToolFailureMemoryTracker, tool: string, args: unknown, state: ToolFailureState, failureCode: string, correction: string, diagnostic?: string, phase?: ToolFailurePhase): ToolFailureMemoryRecord;
+export declare function rememberToolFailure(tracker: ToolFailureMemoryTracker, tool: string, args: unknown, state: ToolFailureState, failureCode: string, correction: string, diagnostic?: string, phase?: ToolFailurePhase, evidence?: string): ToolFailureMemoryRecord;
 export declare function clearToolFailure(tracker: ToolFailureMemoryTracker, tool: string, args: unknown): void;
 export declare function createToolFailureResult(record: ToolFailureMemoryRecord, terminate?: boolean): AgentToolResult<ToolFailureResultDetails>;
 export declare function createRepeatedToolFailureResult(record: ToolFailureMemoryRecord): AgentToolResult<ToolFailureMemoryDetails>;

package/dist/tool-failure-memory.d.ts.map

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

package/dist/tool-failure-memory.js

@@ -8,6 +8,8 @@ const MAX_OPERATION_CHARS = 240;
 const MAX_FAILURE_CODE_CHARS = 48;
 const MAX_DIAGNOSTIC_CHARS = 240;
 const MAX_CORRECTION_CHARS = 320;
+const MAX_TOOL_FAILURE_EVIDENCE_CHARS = 1_600;
+const MAX_ACTIVE_FAILURE_EVIDENCE_CHARS = 2_400;
 const MAX_TOOL_NAME_CHARS = 64;
 const TOOL_SIGNATURE_HEX_CHARS = 32;
 const MAX_ACTIVE_FAILURES = 8;
@@ -25,6 +27,13 @@ function truncate(value, maxChars) {
         end--;
     return `${value.slice(0, end)}…`;
 }
+/** Normalize and bound tool-owned evidence at every live and persisted ingress. */
+export function sanitizeToolFailureEvidence(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const sanitized = sanitizeBinaryOutput(value).trim();
+    return sanitized ? truncate(sanitized, MAX_TOOL_FAILURE_EVIDENCE_CHARS) : undefined;
+}
 function truncateMiddle(value, maxChars) {
     if (value.length <= maxChars)
         return value;
@@ -312,6 +321,20 @@ function getToolFailureKey(tool, args) {
 export function getToolExecutionKey(tool, args) {
     return toolOperationKey(tool, args, false);
 }
+/** Read the four hash words already encoded by this module's exact execution-key owner. */
+export function getToolExecutionKeyHashParts(executionKey) {
+    const separator = executionKey.lastIndexOf(":");
+    const signature = executionKey.slice(separator + 1);
+    if (separator < 0 || signature.length !== TOOL_SIGNATURE_HEX_CHARS || !/^[0-9a-f]+$/.test(signature)) {
+        throw new TypeError("Tool execution key has an invalid hash signature.");
+    }
+    return [
+        Number.parseInt(signature.slice(0, 8), 16),
+        Number.parseInt(signature.slice(8, 16), 16),
+        Number.parseInt(signature.slice(16, 24), 16),
+        Number.parseInt(signature.slice(24, 32), 16),
+    ];
+}
 export function getToolFailureRecordExecutionKey(record) {
     return record[TOOL_FAILURE_EXECUTION_KEY];
 }
@@ -569,6 +592,7 @@ function readFailureRecord(details) {
         return undefined;
     }
     const diagnostic = typeof candidate.diagnostic === "string" ? truncate(candidate.diagnostic, MAX_DIAGNOSTIC_CHARS) : undefined;
+    const evidence = sanitizeToolFailureEvidence(candidate.evidence);
     const retainedCorrection = typeof candidate.correction === "string" ? truncate(candidate.correction, MAX_CORRECTION_CHARS) : undefined;
     const correction = candidate.state === "failed" && retainedCorrection === LEGACY_GENERIC_EXECUTION_CORRECTION
         ? fallbackFailureGuidance("failed", diagnostic !== undefined, "execution")
@@ -592,6 +616,7 @@ function readFailureRecord(details) {
         phase,
         failureCode: boundedFailureCode(candidate.failureCode),
         diagnostic,
+        evidence,
         correction,
     };
 }
@@ -736,6 +761,7 @@ function analyzeToolFailureContext(messages) {
                 phase: retained?.phase ?? assessment?.phase ?? inferToolFailurePhase(state, "tool_error"),
                 failureCode: retained?.failureCode ?? assessment?.failureCode ?? "tool_error",
                 diagnostic: retained?.diagnostic ?? assessment?.diagnostic,
+                evidence: retained?.evidence,
                 correction: retained?.correction ??
                     assessment?.guidance ??
                     fallbackFailureGuidance(state, false, inferToolFailurePhase(state, "tool_error")),
@@ -826,59 +852,50 @@ function analyzeToolFailureContext(messages) {
 export function createToolFailureMemoryTracker(messages) {
     return new Map(analyzeToolFailureContext(messages).activeRecords.map((record) => [record.failureKey, record]));
 }
-export function rememberToolFailure(tracker, tool, args, state, failureCode, correction, diagnostic, phase = inferToolFailurePhase(state, failureCode)) {
+export function rememberToolFailure(tracker, tool, args, state, failureCode, correction, diagnostic, phase = inferToolFailurePhase(state, failureCode), evidence) {
     let kindCount = 1;
     for (const previous of tracker.values()) {
         if (previous.tool === tool) {
             kindCount = Math.max(kindCount, (previous.kindMistakes ?? previous.occurrence) + 1);
         }
     }
-    if (getToolExecutionAttemptMemory(failureCode) === "discard") {
+    const isDiscard = getToolExecutionAttemptMemory(failureCode) === "discard";
+    if (isDiscard) {
         for (const [failureKey, previous] of tracker) {
             if (previous.tool === tool && previous.failureCode === failureCode)
                 tracker.delete(failureKey);
         }
-        return {
-            version: TOOL_FAILURE_MEMORY_VERSION,
-            failureKey: `directive:${boundedFailureCode(failureCode)}`,
-            [TOOL_FAILURE_EXECUTION_KEY]: getToolExecutionKey(tool, args),
-            tool: truncate(tool, MAX_TOOL_NAME_CHARS),
-            operation: "[discarded]",
-            occurrence: 1,
-            kindMistakes: kindCount,
-            mistakeKind: tool,
-            state,
-            phase,
-            failureCode: boundedFailureCode(failureCode),
-            diagnostic: diagnostic ? truncate(diagnostic, MAX_DIAGNOSTIC_CHARS) : undefined,
-            correction: truncate(correction, MAX_CORRECTION_CHARS),
-            attemptMemory: "discard",
-        };
     }
-    const identity = operationIdentity(tool, args);
-    const previous = tracker.get(identity.failureKey);
+    const identity = isDiscard ? undefined : operationIdentity(tool, args);
+    const previous = identity ? tracker.get(identity.failureKey) : undefined;
     const record = {
         version: TOOL_FAILURE_MEMORY_VERSION,
-        failureKey: identity.failureKey,
-        [TOOL_FAILURE_EXECUTION_KEY]: identity.executionKey,
-        tool: identity.tool,
-        operation: identity.operation,
-        occurrence: (previous?.occurrence ?? 0) + 1,
+        failureKey: identity ? identity.failureKey : `directive:${boundedFailureCode(failureCode)}`,
+        [TOOL_FAILURE_EXECUTION_KEY]: identity ? identity.executionKey : getToolExecutionKey(tool, args),
+        tool: identity ? identity.tool : truncate(tool, MAX_TOOL_NAME_CHARS),
+        operation: identity ? identity.operation : "[discarded]",
+        occurrence: isDiscard ? 1 : (previous?.occurrence ?? 0) + 1,
         kindMistakes: kindCount,
         mistakeKind: tool,
         state,
         phase,
         failureCode: boundedFailureCode(failureCode),
         diagnostic: diagnostic ? truncate(diagnostic, MAX_DIAGNOSTIC_CHARS) : undefined,
+        evidence: sanitizeToolFailureEvidence(evidence),
         correction: truncate(correction, MAX_CORRECTION_CHARS),
+        ...(isDiscard ? { attemptMemory: "discard" } : {}),
     };
-    tracker.delete(identity.failureKey);
-    tracker.set(identity.failureKey, record);
-    while (tracker.size > MAX_TRACKED_FAILURES) {
-        const oldest = tracker.keys().next().value;
-        if (oldest === undefined)
-            break;
-        tracker.delete(oldest);
+    if (isDiscard)
+        return record;
+    if (identity) {
+        tracker.delete(identity.failureKey);
+        tracker.set(identity.failureKey, record);
+        while (tracker.size > MAX_TRACKED_FAILURES) {
+            const oldest = tracker.keys().next().value;
+            if (oldest === undefined)
+                break;
+            tracker.delete(oldest);
+        }
     }
     return record;
 }
@@ -894,7 +911,7 @@ function failureGuidance(record) {
         ? { repair: record.correction }
         : { next_action: record.correction };
 }
-function formatRecordJson(record, includeOperation = false) {
+function formatRecordJson(record, includeOperation = false, evidence = record.evidence) {
     const guidance = failureGuidance(record);
     return JSON.stringify({
         ...mandatoryToolFailureRecoveryMetadata(),
@@ -908,6 +925,7 @@ function formatRecordJson(record, includeOperation = false) {
         ...(includeOperation ? { operation: record.operation } : {}),
         failure_code: record.failureCode,
         ...(record.diagnostic ? { diagnostic: record.diagnostic } : {}),
+        ...(evidence ? { evidence } : {}),
         ...guidance,
         ...(record.attemptMemory === "discard" ? { attempt_memory: "discarded" } : {}),
     });
@@ -1006,7 +1024,17 @@ export function sanitizeToolFailureContext(messages, systemPrompt) {
     const kindSummary = Object.entries(analysis.kindMistakesSummary)
         .map(([kind, count]) => `${kind}:${count}`)
         .join(", ");
-    const lines = records.map((record) => escapePromptData(formatRecordJson(record, true)));
+    let remainingEvidenceChars = MAX_ACTIVE_FAILURE_EVIDENCE_CHARS;
+    const evidenceByFailureKey = new Map();
+    for (let index = records.length - 1; index >= 0 && remainingEvidenceChars > 1; index--) {
+        const record = records[index];
+        if (!record.evidence)
+            continue;
+        const retained = truncate(record.evidence, remainingEvidenceChars);
+        evidenceByFailureKey.set(record.failureKey, retained);
+        remainingEvidenceChars -= retained.length;
+    }
+    const lines = records.map((record) => escapePromptData(formatRecordJson(record, true, evidenceByFailureKey.get(record.failureKey) ?? null)));
     for (const directive of analysis.activeDirectives) {
         lines.push(escapePromptData(JSON.stringify({
             ...mandatoryToolFailureRecoveryMetadata(),