agentfootprint 13.0.0 → 14.0.0

package/dist/esm/memory/causal/loadSnapshot.js.map

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

package/dist/esm/memory/causal/observation.d.ts

@@ -0,0 +1,72 @@
+/** Evidence is limited to one captured component execution leg. */
+import type { NativeRunOrigin } from 'footprintjs';
+import type { DecisionRecord, ToolCallRecord } from './types.js';
+export type EvidenceEntry = {
+    readonly kind: 'run';
+} | {
+    readonly kind: 'resume';
+    readonly mode: 'same' | 'fresh';
+} | {
+    readonly kind: 'mounted';
+    readonly nativeEntry: 'unavailable';
+};
+export interface EvidenceCoverage {
+    readonly scope: 'component-execution-leg';
+    readonly runId: string;
+    readonly entry: EvidenceEntry;
+    readonly priorLegs: 'not-carried';
+}
+export interface SnapshotCoverage extends EvidenceCoverage {
+    readonly source: Extract<NativeRunOrigin, {
+        readonly kind: 'stage';
+    }>;
+}
+export declare const EVIDENCE_CAUSES: readonly ["observer-failed", "bounded-observation", "incomplete-tool-pairs", "duplicate-tool-start", "missing-usage"];
+export type EvidenceCause = (typeof EVIDENCE_CAUSES)[number];
+export declare const EVIDENCE_LIMITS: Readonly<{
+    decisions: 256;
+    toolCalls: 256;
+    pendingStarts: 256;
+}>;
+export interface ObservedEvidence<C extends EvidenceCoverage = EvidenceCoverage> {
+    readonly coverage: C;
+    readonly decisions: readonly DecisionRecord[];
+    readonly toolCalls: readonly ToolCallRecord[];
+    readonly observedIterationStarts: number;
+    readonly lastObservedIteration?: number;
+    readonly toolAccounting: {
+        readonly unmatchedStarts: number;
+        readonly unmatchedEnds: number;
+        readonly duplicateStarts: number;
+    };
+    readonly usageAccounting: {
+        readonly observedCalls: number;
+        readonly missingUsage: number;
+    };
+    readonly omittedObservations: {
+        readonly decisions: number;
+        readonly toolCalls: number;
+        readonly pendingStarts: number;
+    };
+    readonly duration: {
+        readonly kind: 'measured';
+        readonly observationWindowMs: number;
+    } | {
+        readonly kind: 'unavailable';
+    };
+    /** Observed input/output only; not the whole answer's cost or provider bill. */
+    readonly tokenUsage: {
+        readonly input: number;
+        readonly output: number;
+    };
+}
+export type Observation<C extends EvidenceCoverage = EvidenceCoverage> = (ObservedEvidence<C> & {
+    readonly availability: 'observed';
+}) | (ObservedEvidence<C> & {
+    readonly availability: 'partial';
+    readonly causes: readonly EvidenceCause[];
+}) | {
+    readonly availability: 'unavailable';
+    readonly reason: 'not-configured' | 'observer-failed' | 'collector-failed';
+};
+export type RunEvidence = Observation;

package/dist/esm/memory/causal/observation.js

@@ -0,0 +1,13 @@
+export const EVIDENCE_CAUSES = [
+    'observer-failed',
+    'bounded-observation',
+    'incomplete-tool-pairs',
+    'duplicate-tool-start',
+    'missing-usage',
+];
+export const EVIDENCE_LIMITS = Object.freeze({
+    decisions: 256,
+    toolCalls: 256,
+    pendingStarts: 256,
+});
+//# sourceMappingURL=observation.js.map

package/dist/esm/memory/causal/observation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation.js","sourceRoot":"","sources":["../../../../src/memory/causal/observation.ts"],"names":[],"mappings":"AAoBA,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,iBAAiB;IACjB,qBAAqB;IACrB,uBAAuB;IACvB,sBAAsB;IACtB,eAAe;CACP,CAAC;AAGX,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC;IAC3C,SAAS,EAAE,GAAG;IACd,SAAS,EAAE,GAAG;IACd,aAAa,EAAE,GAAG;CACnB,CAAC,CAAC"}

package/dist/esm/memory/causal/snapshotProjection.d.ts

@@ -0,0 +1,5 @@
+/** Every projection states the same leg-only evidence boundary. */
+import type { LLMMessage } from '../../provider-contract/types.js';
+import { type SnapshotProjection } from '../define.types.js';
+import type { SnapshotEntry } from './types.js';
+export declare function formatSnapshot(snap: SnapshotEntry, projection: SnapshotProjection, score: number): LLMMessage;

package/dist/esm/memory/causal/snapshotProjection.js

@@ -0,0 +1,61 @@
+import { SNAPSHOT_PROJECTIONS } from '../define.types.js';
+const LIMITATION = 'The past answer may use earlier admitted history; evidence shows only this component execution leg. ' +
+    'Evidence from prior legs and missing observations is unknown. Empty lists do not prove no operations.';
+export function formatSnapshot(snap, projection, score) {
+    const query = snap.query.length > 80 ? snap.query.slice(0, 79) + '…' : snap.query;
+    const header = '[Past run · query: "' + query + '" · score: ' + score.toFixed(2) + ']';
+    const status = snap.availability === 'partial'
+        ? 'Partial evidence: ' + snap.causes.join(', ') + '.'
+        : snap.availability === 'unavailable'
+            ? 'Evidence unavailable: ' + snap.reason + '.'
+            : 'Observed evidence in this leg only.';
+    let body;
+    switch (projection) {
+        case SNAPSHOT_PROJECTIONS.DECISIONS: {
+            const decisions = snap.availability === 'unavailable' ? [] : snap.decisions;
+            const tools = snap.availability === 'unavailable' ? [] : snap.toolCalls;
+            const decisionText = decisions
+                .map((d) => '- ' +
+                d.stageId +
+                ' → "' +
+                d.chosen +
+                '"' +
+                (d.rule ? ' (rule: ' + d.rule + ')' : '') +
+                (d.evidence ? '; evidence: ' + JSON.stringify(d.evidence) : ''))
+                .join('\n');
+            const toolText = tools.length
+                ? '\nTool evidence:\n' +
+                    tools
+                        .map((t) => '- ' +
+                        t.name +
+                        '(' +
+                        JSON.stringify(t.args) +
+                        ') → ' +
+                        t.resultPreview +
+                        (t.errored ? ' [ERROR]' : ''))
+                        .join('\n')
+                : '';
+            body =
+                (decisionText || toolText ? decisionText + toolText : '(no decision evidence captured)') +
+                    '\nFinal answer: ' +
+                    snap.finalContent;
+            break;
+        }
+        case SNAPSHOT_PROJECTIONS.NARRATIVE:
+            body = snap.narrative ?? '(no narrative captured)\nFinal answer: ' + snap.finalContent;
+            break;
+        case SNAPSHOT_PROJECTIONS.COMMITS:
+            body = '(no commit log captured)\nFinal answer: ' + snap.finalContent;
+            break;
+        case SNAPSHOT_PROJECTIONS.FULL:
+            body = JSON.stringify(snap, null, 2);
+            break;
+        default:
+            body = 'Final answer: ' + snap.finalContent;
+    }
+    return {
+        role: 'system',
+        content: header + '\n' + LIMITATION + '\n' + status + '\n' + body,
+    };
+}
+//# sourceMappingURL=snapshotProjection.js.map

package/dist/esm/memory/causal/snapshotProjection.js.map

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

package/dist/esm/memory/causal/snapshotSchema.d.ts

@@ -0,0 +1,8 @@
+import type { SnapshotEntry } from './types.js';
+export type SnapshotAdmission = {
+    readonly kind: 'accepted';
+    readonly value: SnapshotEntry;
+} | {
+    readonly kind: 'unsupported' | 'invalid';
+};
+export declare function readSnapshot(value: unknown): SnapshotAdmission;

package/dist/esm/memory/causal/snapshotSchema.js

@@ -0,0 +1,168 @@
+/** Closed v2 admission for saved causal values; legacy rows are never upgraded. */
+import { EVIDENCE_CAUSES, EVIDENCE_LIMITS } from './observation.js';
+function record(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function own(value, key) {
+    const descriptor = Object.getOwnPropertyDescriptor(value, key);
+    return descriptor && 'value' in descriptor ? descriptor.value : undefined;
+}
+function fields(value, allowed) {
+    return (record(value) &&
+        Object.getOwnPropertyNames(value).every((key) => allowed.includes(key) && 'value' in Object.getOwnPropertyDescriptor(value, key)));
+}
+const text = (value) => typeof value === 'string';
+const count = (value) => Number.isSafeInteger(value) && value >= 0;
+const finite = (value) => typeof value === 'number' &&
+    Number.isFinite(value) &&
+    value >= 0 &&
+    value <= Number.MAX_SAFE_INTEGER;
+function dataArray(value, limit, admit) {
+    if (!Array.isArray(value) || value.length > limit)
+        return false;
+    for (let i = 0; i < value.length; i += 1) {
+        const field = Object.getOwnPropertyDescriptor(value, String(i));
+        if (!field || !('value' in field) || !admit(field.value))
+            return false;
+    }
+    return true;
+}
+function entry(value) {
+    if (!fields(value, ['kind', 'mode', 'nativeEntry']))
+        return false;
+    if (value.kind === 'run')
+        return fields(value, ['kind']);
+    if (value.kind === 'resume')
+        return fields(value, ['kind', 'mode']) && ['same', 'fresh'].includes(String(value.mode));
+    return (fields(value, ['kind', 'nativeEntry']) &&
+        value.kind === 'mounted' &&
+        value.nativeEntry === 'unavailable');
+}
+function coverage(value) {
+    if (!fields(value, ['scope', 'runId', 'entry', 'priorLegs', 'source']))
+        return false;
+    const source = value.source;
+    return (value.scope === 'component-execution-leg' &&
+        text(value.runId) &&
+        value.runId.length > 0 &&
+        entry(value.entry) &&
+        value.priorLegs === 'not-carried' &&
+        fields(source, [
+            'kind',
+            'runId',
+            'startedAtMs',
+            'runtimeStageId',
+            'subflowPath',
+            'parentRuntimeStageId',
+        ]) &&
+        source.kind === 'stage' &&
+        source.runId === value.runId &&
+        finite(source.startedAtMs) &&
+        text(source.runtimeStageId) &&
+        source.runtimeStageId.length > 0 &&
+        (source.subflowPath === undefined || text(source.subflowPath)) &&
+        (source.parentRuntimeStageId === undefined || text(source.parentRuntimeStageId)));
+}
+function observations(value) {
+    if (!coverage(value.coverage) ||
+        !count(value.observedIterationStarts) ||
+        (value.lastObservedIteration !== undefined && !count(value.lastObservedIteration)))
+        return false;
+    if (!dataArray(value.decisions, EVIDENCE_LIMITS.decisions, (d) => fields(d, ['stageId', 'chosen', 'rule', 'evidence']) &&
+        text(d.stageId) &&
+        text(d.chosen) &&
+        (d.rule === undefined || text(d.rule)) &&
+        (d.evidence === undefined || record(d.evidence))))
+        return false;
+    if (!dataArray(value.toolCalls, EVIDENCE_LIMITS.toolCalls, (t) => fields(t, ['name', 'args', 'resultPreview', 'errored']) &&
+        text(t.name) &&
+        record(t.args) &&
+        text(t.resultPreview) &&
+        typeof t.errored === 'boolean'))
+        return false;
+    const tool = value.toolAccounting, usage = value.usageAccounting, omitted = value.omittedObservations;
+    if (!fields(tool, ['unmatchedStarts', 'unmatchedEnds', 'duplicateStarts']) ||
+        !count(tool.unmatchedStarts) ||
+        tool.unmatchedStarts > EVIDENCE_LIMITS.pendingStarts ||
+        !count(tool.unmatchedEnds) ||
+        !count(tool.duplicateStarts) ||
+        !fields(usage, ['observedCalls', 'missingUsage']) ||
+        !count(usage.observedCalls) ||
+        !count(usage.missingUsage) ||
+        !fields(omitted, ['decisions', 'toolCalls', 'pendingStarts']) ||
+        !count(omitted.decisions) ||
+        !count(omitted.toolCalls) ||
+        !count(omitted.pendingStarts))
+        return false;
+    if (!fields(value.tokenUsage, ['input', 'output']) ||
+        !finite(value.tokenUsage.input) ||
+        !finite(value.tokenUsage.output) ||
+        (usage.observedCalls === 0 && (value.tokenUsage.input !== 0 || value.tokenUsage.output !== 0)))
+        return false;
+    const duration = value.duration;
+    if (!(fields(duration, ['kind']) && duration.kind === 'unavailable') &&
+        !(fields(duration, ['kind', 'observationWindowMs']) &&
+            duration.kind === 'measured' &&
+            finite(duration.observationWindowMs)))
+        return false;
+    const required = [];
+    if (omitted.decisions + omitted.toolCalls + omitted.pendingStarts > 0)
+        required.push('bounded-observation');
+    if (tool.unmatchedStarts > 0 || tool.unmatchedEnds > 0)
+        required.push('incomplete-tool-pairs');
+    if (tool.duplicateStarts > 0)
+        required.push('duplicate-tool-start');
+    if (usage.missingUsage > 0)
+        required.push('missing-usage');
+    if (value.availability === 'observed')
+        return value.causes === undefined && required.length === 0;
+    if (value.availability !== 'partial' ||
+        !dataArray(value.causes, EVIDENCE_CAUSES.length, (c) => EVIDENCE_CAUSES.includes(c)) ||
+        value.causes.length === 0)
+        return false;
+    const causes = value.causes;
+    return (causes.length <= EVIDENCE_CAUSES.length &&
+        EVIDENCE_CAUSES.filter((c) => causes.includes(c)).join('|') === causes.join('|') &&
+        required.every((c) => causes.includes(c)));
+}
+export function readSnapshot(value) {
+    try {
+        if (!record(value) || own(value, 'schemaVersion') !== 2)
+            return { kind: 'unsupported' };
+        const common = ['schemaVersion', 'query', 'finalContent', 'narrative', 'evalScore'];
+        if (!text(own(value, 'query')) ||
+            !text(own(value, 'finalContent')) ||
+            (own(value, 'narrative') !== undefined && !text(own(value, 'narrative'))) ||
+            (own(value, 'evalScore') !== undefined &&
+                (typeof own(value, 'evalScore') !== 'number' || !Number.isFinite(own(value, 'evalScore')))))
+            return { kind: 'invalid' };
+        const available = own(value, 'availability');
+        if (available === 'unavailable') {
+            if (!fields(value, [...common, 'availability', 'reason']) ||
+                !['not-configured', 'observer-failed', 'collector-failed'].includes(String(own(value, 'reason'))))
+                return { kind: 'invalid' };
+        }
+        else if (!fields(value, [
+            ...common,
+            'availability',
+            'coverage',
+            'decisions',
+            'toolCalls',
+            'observedIterationStarts',
+            'lastObservedIteration',
+            'toolAccounting',
+            'usageAccounting',
+            'omittedObservations',
+            'duration',
+            'tokenUsage',
+            'causes',
+        ]) ||
+            !observations(value))
+            return { kind: 'invalid' };
+        return { kind: 'accepted', value: value };
+    }
+    catch {
+        return { kind: 'invalid' };
+    }
+}
+//# sourceMappingURL=snapshotSchema.js.map

package/dist/esm/memory/causal/snapshotSchema.js.map

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

package/dist/esm/memory/causal/types.d.ts

@@ -1,90 +1,13 @@
-/**
- * Causal memory — types.
- *
- * A `SnapshotEntry` is the value stored in a Causal `MemoryStore`. It
- * captures one agent run's "what happened and why" so future turns can
- * answer follow-up questions ("why did you reject this?") with EXACT
- * past facts instead of LLM reconstruction.
- *
- * Differentiator: footprintjs's `decide()`/`select()` already capture
- * decision evidence as first-class events during traversal — we just
- * persist them. Other libraries can't do this without rebuilding their
- * core to surface decision evidence.
- *
- * Stored as `MemoryEntry<SnapshotEntry>` so the existing store layer
- * (`MemoryStore`, `InMemoryStore`, future Redis/Dynamo/Postgres
- * adapters) handles persistence + identity isolation + TTL + vector
- * search out of the box.
- */
+/** Version2 causal snapshots: answer facts plus explicit component-leg evidence. */
 import type { LLMMessage } from '../../provider-contract/types.js';
-/**
- * One stored agent run — the unit of causal memory.
- *
- * Decisions, tool calls, iterations, and token usage are harvested DURING the run
- * by `causalEvidenceRecorder` (the evidence bridge) and persisted here — the Agent
- * attaches it automatically whenever a CAUSAL memory is mounted. Still deferred: the
- * FULL `commitLog` + narrative entries with depth/path, which land only when an
- * out-of-band recorder integrates `executor.getSnapshot()` directly. Consequence: a
- * persisted snapshot answers "why?" from the recorded DOMAIN evidence (decisions /
- * tool calls), but cannot yet rehydrate the trace-toolpack tools for cross-restart
- * step-by-step navigation — use `.selfExplain()` for in-conversation deep traces.
- */
-export interface SnapshotEntry {
-    /**
-     * The user's message at the time of the run. THIS IS WHAT GETS
-     * EMBEDDED for retrieval — new queries are matched by cosine
-     * similarity against past queries.
-     */
+import type { Observation, SnapshotCoverage } from './observation.js';
+export type SnapshotEntry = {
+    readonly schemaVersion: 2;
     readonly query: string;
-    /**
-     * The agent's final answer for the run. Pairs with `query` to form
-     * the (prompt, completion) pair RL/SFT exports project on.
-     */
     readonly finalContent: string;
-    /**
-     * Iteration count — how many ReAct loop turns the agent used to
-     * produce `finalContent`. Useful for ranking "decisive" runs vs
-     * "thrashy" ones.
-     */
-    readonly iterations: number;
-    /**
-     * Decision records collected via `decide()`/`select()` (and skill-graph routing)
-     * during the run — harvested live by `causalEvidenceRecorder` (the evidence
-     * bridge) and persisted here. Empty only when the run used no decision primitives.
-     * THE killer field (by design): each entry carries the rule that matched + the
-     * evidence values that satisfied it.
-     */
-    readonly decisions: ReadonlyArray<DecisionRecord>;
-    /**
-     * Tool calls made during the run. Each entry: tool name, args,
-     * result (truncated). Surfaces the agent's tool-use trajectory for
-     * RL training of tool-use policies.
-     */
-    readonly toolCalls: ReadonlyArray<ToolCallRecord>;
-    /**
-     * Optional rendered narrative — when an out-of-band recorder
-     * captures `executor.getNarrative()` at write time, the full
-     * human-readable trace lands here.
-     */
     readonly narrative?: string;
-    /**
-     * Wall-clock duration of the run in milliseconds.
-     */
-    readonly durationMs: number;
-    /**
-     * Cumulative token usage at end of run. Used to skip expensive
-     * snapshots from training-data exports under cost caps.
-     */
-    readonly tokenUsage: {
-        readonly input: number;
-        readonly output: number;
-    };
-    /**
-     * Optional eval score attached by an `evalRecorder`. When present,
-     * exports can filter to high-quality runs for SFT or rank for DPO.
-     */
     readonly evalScore?: number;
-}
+} & Observation<SnapshotCoverage>;
 export interface DecisionRecord {
     /** Stage id where the decision happened (`'classify-risk'`). */
     readonly stageId: string;

package/dist/esm/memory/causal/types.js

@@ -1,21 +1,3 @@
-/**
- * Causal memory — types.
- *
- * A `SnapshotEntry` is the value stored in a Causal `MemoryStore`. It
- * captures one agent run's "what happened and why" so future turns can
- * answer follow-up questions ("why did you reject this?") with EXACT
- * past facts instead of LLM reconstruction.
- *
- * Differentiator: footprintjs's `decide()`/`select()` already capture
- * decision evidence as first-class events during traversal — we just
- * persist them. Other libraries can't do this without rebuilding their
- * core to surface decision evidence.
- *
- * Stored as `MemoryEntry<SnapshotEntry>` so the existing store layer
- * (`MemoryStore`, `InMemoryStore`, future Redis/Dynamo/Postgres
- * adapters) handles persistence + identity isolation + TTL + vector
- * search out of the box.
- */
 /**
  * Default truncation when serializing tool results into the snapshot.
  * Keeps snapshot entries small enough to fit many in context during

package/dist/esm/memory/causal/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/memory/causal/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAuGH;;;;GAIG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,GAAG,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/memory/causal/types.ts"],"names":[],"mappings":"AAkCA;;;;GAIG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,GAAG,CAAC"}

package/dist/esm/memory/causal/writeSnapshot.js

@@ -53,6 +53,7 @@
  * @see ./loadSnapshot.ts   for the read-side counterpart
  */
 import { maxStoredTurn, normalizeHostTurn } from '../turn/resolveTurnNumber.js';
+import { readSnapshot } from './snapshotSchema.js';
 /** Ids written by this stage: `snap-{turn}`. Used to find the highest
  *  turn already persisted for a conversation (other entry kinds sharing
  *  the store — `msg-{turn}-{idx}`, beats, facts — never match). */
@@ -88,8 +89,8 @@ export function writeSnapshot(config) {
         const assistantMsg = newMessages.find((m) => m.role === 'assistant');
         const query = userMsg?.content ?? '';
         const finalContent = assistantMsg?.content ?? '';
-        if (query.length === 0)
-            return; // No query → no useful snapshot.
+        if (query.length === 0 || !assistantMsg)
+            return; // Answer-triggered snapshots only.
         // Effective turn — anchored on the store, not the host's counter
         // (see header: "Turn derivation"). Guarantees distinct, ordered ids for
         // consecutive turns of one conversation even when the host's own counter
@@ -105,19 +106,21 @@ export function writeSnapshot(config) {
         }));
         const now = Date.now();
         const ttl = config.ttlMs ? now + config.ttlMs : undefined;
-        // Evidence bridge (#5): the wire layer delivers run evidence harvested by
-        // `causalEvidenceRecorder` via the write mount's `evidenceSource`. Absent
-        // (non-agent hosts, no recorder attached) → zeros, as before.
-        const evidence = scope.runEvidence;
-        const snapshot = {
-            query,
-            finalContent,
-            iterations: evidence?.iterations ?? 0,
-            decisions: evidence?.decisions ?? [],
-            toolCalls: evidence?.toolCalls ?? [],
-            durationMs: evidence?.durationMs ?? 0,
-            tokenUsage: evidence?.tokenUsage ?? { input: 0, output: 0 },
+        const evidence = scope.runEvidence ?? {
+            availability: 'unavailable',
+            reason: 'not-configured',
         };
+        const candidate = { schemaVersion: 2, query, finalContent, ...evidence };
+        const admitted = readSnapshot(candidate);
+        const snapshot = admitted.kind === 'accepted'
+            ? admitted.value
+            : {
+                schemaVersion: 2,
+                query,
+                finalContent,
+                availability: 'unavailable',
+                reason: 'collector-failed',
+            };
         const entry = {
             id: `snap-${turn}`,
             value: snapshot,

package/dist/esm/memory/causal/writeSnapshot.js.map

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

package/dist/esm/memory/embedding/index.d.ts

@@ -1,5 +1,5 @@
 export type { Embedder, EmbedArgs, EmbedBatchArgs } from './types.js';
-export { cosineSimilarity } from './cosine.js';
+export { cosineSimilarity } from '../../lib/cosine.js';
 export { mockEmbedder } from './mockEmbedder.js';
 export type { MockEmbedderOptions } from './mockEmbedder.js';
 export { embedMessages } from './embedMessages.js';

package/dist/esm/memory/embedding/index.js

@@ -1,4 +1,4 @@
-export { cosineSimilarity } from './cosine.js';
+export { cosineSimilarity } from '../../lib/cosine.js';
 export { mockEmbedder } from './mockEmbedder.js';
 export { embedMessages } from './embedMessages.js';
 export { loadRelevant } from './loadRelevant.js';

package/dist/esm/memory/embedding/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/memory/embedding/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/memory/embedding/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/esm/memory/stages/types.d.ts

@@ -92,7 +92,7 @@ export interface MemoryState {
      * Write-side input (CAUSAL pipelines): evidence harvested during the run by
      * `causalEvidenceRecorder` — decisions, tool calls, iterations, duration,
      * token usage. Populated by the wire layer via the mount's `evidenceSource`;
-     * undefined for non-causal pipelines (writeSnapshot falls back to zeros).
+     * undefined for non-causal pipelines (observation is unavailable, never measured zero).
      */
     runEvidence?: import('../causal/evidenceRecorder.js').RunEvidence;
     /** Escape hatch for pipeline-specific fields. Typed per-pipeline as needed. */

package/dist/esm/memory/store/InMemoryStore.js

@@ -15,7 +15,7 @@
  */
 import { storeRequestLimit } from './requestLimit.js';
 import { identityNamespace } from '../identity/index.js';
-import { cosineSimilarity } from '../embedding/cosine.js';
+import { cosineSimilarity } from '../../lib/cosine.js';
 import { NO_SERVER_EXTRACTION, refuseUnhonouredWriteOptions, } from './writeOptions.js';
 const DEFAULT_LIST_LIMIT = 100;
 const MAX_LIST_LIMIT = 1000;