agentfootprint 7.22.0 → 7.22.1

package/dist/types/lib/storedPreview.d.ts

@@ -0,0 +1,59 @@
+/**
+ * lib/storedPreview — how much of somebody's stored data an error may quote.
+ *
+ * A refusal about unreadable bytes has to show enough of them to be diagnosable
+ * ("ah, that is our envelope stringified by something that was not JSON") and no
+ * more, because the rest of those bytes are a conversation, a memory, or
+ * whatever else a user said. Error messages travel: they land in logs, in
+ * dashboards, in bug reports pasted into chat windows. So the quote is capped,
+ * and the cap lives HERE rather than being re-decided by each adapter that needs
+ * one — two copies of a redaction rule is one copy that will drift.
+ *
+ * Structured values are SUMMARISED rather than serialized: an array reports its
+ * length and an object its keys, because `String(anObject)` and
+ * `JSON.stringify(anArray)` are both ways of accidentally printing the payload
+ * this file exists to keep out of the message.
+ *
+ * Two functions, because a cap is only safe when the first bytes are structure.
+ * {@link previewStored} quotes a capped prefix — right for a value whose opening
+ * fields are metadata. {@link describeStoredShape} quotes nothing at all — right
+ * for a value whose content starts immediately. Choosing between them is the
+ * caller's job because only the caller knows what its bytes begin with.
+ */
+/**
+ * How much of a stored value a refusal may quote. Enough to recognise a mangled
+ * encoding at a glance; not enough to leak what was being said.
+ */
+export declare const STORED_PREVIEW_LIMIT = 64;
+/**
+ * Describe what a store handed back WITHOUT quoting the whole thing.
+ *
+ * @example
+ *   previewStored('{format=conversation-v1, data={version=1, …}}')
+ *   // → '"{format=conversation-v1, data={version=1, …" (96 chars)'
+ *   previewStored({ id: 'm-1', value: 'her address is …' })
+ *   // → 'an object with keys: id, value'
+ */
+export declare function previewStored(value: unknown): string;
+/**
+ * Describe a stored value **without quoting any of it** — its type, its size and
+ * its shape, and nothing that came from a person.
+ *
+ * Use this instead of {@link previewStored} wherever the stored bytes carry
+ * user content from their first characters, so that even a capped prefix would
+ * leak. A `CheckpointEnvelope` opens with `format`, `data`, `savedAt` and can
+ * afford to be quoted; a `MemoryEntry` opens with `id` and then `value`, so its
+ * second field IS the thing somebody asked an agent to remember. The cap is a
+ * policy about how MUCH may be shown; this is the answer when the honest amount
+ * is none.
+ *
+ * It stays diagnosable, which is the whole job of the quote it replaces: a
+ * length, whether it is JSON at all, and its opening character are enough to
+ * recognise "an object stringified by something that was not JSON".
+ *
+ * @example
+ *   describeStoredShape('{id=a, value={text=her address is …}}')
+ *   // → "a 37-character string that is not JSON, starting '{'"
+ */
+export declare function describeStoredShape(value: unknown): string;
+//# sourceMappingURL=storedPreview.d.ts.map

package/dist/types/lib/storedPreview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storedPreview.d.ts","sourceRoot":"","sources":["../../../src/lib/storedPreview.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH;;;GAGG;AACH,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAOpD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CA2B1D"}

package/dist/types/memory-providers.d.ts

@@ -33,6 +33,6 @@
  *   import { RedisStore, AgentCoreStore } from 'agentfootprint/memory-providers';
  */
 export { RedisStore, type RedisStoreOptions, type RedisLikeClient, type RedisLikePipeline, } from './adapters/memory/redis.js';
-export { AgentCoreStore, type AgentCoreStoreOptions, type AgentCoreLikeClient, type AgentCoreEvent, type AgentCoreMemoryRecord, } from './adapters/memory/agentcore.js';
+export { AgentCoreStore, UnreadableMemoryEntryError, type AgentCoreStoreOptions, type AgentCoreLikeClient, type AgentCoreEvent, type AgentCoreMemoryRecord, } from './adapters/memory/agentcore.js';
 export { BedrockAgentMemory, type BedrockAgentMemoryOptions, type BedrockAgentMemoryLikeClient, type BedrockAgentSummary, } from './adapters/memory/bedrockAgentMemory.js';
 //# sourceMappingURL=memory-providers.d.ts.map

package/dist/types/memory-providers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-providers.d.ts","sourceRoot":"","sources":["../../src/memory-providers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAKH,OAAO,EACL,UAAU,EACV,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,iBAAiB,GACvB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,cAAc,EACd,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,qBAAqB,GAC3B,MAAM,gCAAgC,CAAC;AAIxC,OAAO,EACL,kBAAkB,EAClB,KAAK,yBAAyB,EAC9B,KAAK,4BAA4B,EACjC,KAAK,mBAAmB,GACzB,MAAM,yCAAyC,CAAC"}
+{"version":3,"file":"memory-providers.d.ts","sourceRoot":"","sources":["../../src/memory-providers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAKH,OAAO,EACL,UAAU,EACV,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,iBAAiB,GACvB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,cAAc,EACd,0BAA0B,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,qBAAqB,GAC3B,MAAM,gCAAgC,CAAC;AAIxC,OAAO,EACL,kBAAkB,EAClB,KAAK,yBAAyB,EAC9B,KAAK,4BAA4B,EACjC,KAAK,mBAAmB,GACzB,MAAM,yCAAyC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentfootprint",
-  "version": "7.22.0",
+  "version": "7.22.1",
   "description": "The explainable agent framework — backtrack a wrong answer to the exact context that caused it (evidence, not guesses). Built on footprintjs.",
   "license": "MIT",
   "author": "Sanjay Krishna Anbalagan",