agentfootprint 9.2.0 → 9.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (183) hide show
  1. package/CLAUDE.md +3 -1
  2. package/dist/adapters/identity/agentcore.js +94 -26
  3. package/dist/adapters/identity/agentcore.js.map +1 -1
  4. package/dist/adapters/llm/BedrockProvider.js +34 -9
  5. package/dist/adapters/llm/BedrockProvider.js.map +1 -1
  6. package/dist/adapters/memory/pgVector.js +731 -0
  7. package/dist/adapters/memory/pgVector.js.map +1 -0
  8. package/dist/adapters/memory/s3Vectors.js +780 -0
  9. package/dist/adapters/memory/s3Vectors.js.map +1 -0
  10. package/dist/adapters/memory/sqliteVector.js +16 -79
  11. package/dist/adapters/memory/sqliteVector.js.map +1 -1
  12. package/dist/adapters/observability/cloudwatch.js +13 -8
  13. package/dist/adapters/observability/cloudwatch.js.map +1 -1
  14. package/dist/adapters/observability/xray.js +13 -8
  15. package/dist/adapters/observability/xray.js.map +1 -1
  16. package/dist/adapters/security/agentcore.js +0 -0
  17. package/dist/adapters/security/agentcore.js.map +1 -1
  18. package/dist/bridge/eventMeta.js +3 -0
  19. package/dist/bridge/eventMeta.js.map +1 -1
  20. package/dist/core/Agent.js +11 -0
  21. package/dist/core/Agent.js.map +1 -1
  22. package/dist/core/agent/stages/toolCalls.js +80 -7
  23. package/dist/core/agent/stages/toolCalls.js.map +1 -1
  24. package/dist/doors/security.js +3 -2
  25. package/dist/doors/security.js.map +1 -1
  26. package/dist/embedders/index.js +240 -76
  27. package/dist/embedders/index.js.map +1 -1
  28. package/dist/esm/adapters/identity/agentcore.d.ts +39 -9
  29. package/dist/esm/adapters/identity/agentcore.js +94 -26
  30. package/dist/esm/adapters/identity/agentcore.js.map +1 -1
  31. package/dist/esm/adapters/llm/BedrockProvider.d.ts +24 -0
  32. package/dist/esm/adapters/llm/BedrockProvider.js +34 -9
  33. package/dist/esm/adapters/llm/BedrockProvider.js.map +1 -1
  34. package/dist/esm/adapters/memory/pgVector.d.ts +243 -0
  35. package/dist/esm/adapters/memory/pgVector.js +726 -0
  36. package/dist/esm/adapters/memory/pgVector.js.map +1 -0
  37. package/dist/esm/adapters/memory/s3Vectors.d.ts +240 -0
  38. package/dist/esm/adapters/memory/s3Vectors.js +776 -0
  39. package/dist/esm/adapters/memory/s3Vectors.js.map +1 -0
  40. package/dist/esm/adapters/memory/sqliteVector.d.ts +5 -27
  41. package/dist/esm/adapters/memory/sqliteVector.js +10 -73
  42. package/dist/esm/adapters/memory/sqliteVector.js.map +1 -1
  43. package/dist/esm/adapters/observability/cloudwatch.d.ts +20 -0
  44. package/dist/esm/adapters/observability/cloudwatch.js +13 -8
  45. package/dist/esm/adapters/observability/cloudwatch.js.map +1 -1
  46. package/dist/esm/adapters/observability/xray.d.ts +18 -0
  47. package/dist/esm/adapters/observability/xray.js +13 -8
  48. package/dist/esm/adapters/observability/xray.js.map +1 -1
  49. package/dist/esm/adapters/security/agentcore.d.ts +81 -107
  50. package/dist/esm/adapters/security/agentcore.js +0 -0
  51. package/dist/esm/adapters/security/agentcore.js.map +1 -1
  52. package/dist/esm/bridge/eventMeta.d.ts +3 -0
  53. package/dist/esm/bridge/eventMeta.js +3 -0
  54. package/dist/esm/bridge/eventMeta.js.map +1 -1
  55. package/dist/esm/core/Agent.d.ts +16 -0
  56. package/dist/esm/core/Agent.js +11 -0
  57. package/dist/esm/core/Agent.js.map +1 -1
  58. package/dist/esm/core/agent/stages/toolCalls.js +80 -7
  59. package/dist/esm/core/agent/stages/toolCalls.js.map +1 -1
  60. package/dist/esm/doors/security.d.ts +3 -2
  61. package/dist/esm/doors/security.js +3 -2
  62. package/dist/esm/doors/security.js.map +1 -1
  63. package/dist/esm/embedders/index.d.ts +99 -19
  64. package/dist/esm/embedders/index.js +240 -76
  65. package/dist/esm/embedders/index.js.map +1 -1
  66. package/dist/esm/events/dispatcher.d.ts +1 -1
  67. package/dist/esm/events/dispatcher.js.map +1 -1
  68. package/dist/esm/events/payloads.d.ts +23 -1
  69. package/dist/esm/events/types.d.ts +17 -0
  70. package/dist/esm/hosting/standingAgent.js +14 -1
  71. package/dist/esm/hosting/standingAgent.js.map +1 -1
  72. package/dist/esm/lib/embedderMismatch.d.ts +67 -0
  73. package/dist/esm/lib/embedderMismatch.js +96 -0
  74. package/dist/esm/lib/embedderMismatch.js.map +1 -0
  75. package/dist/esm/lib/rag/defineRAG.d.ts +28 -6
  76. package/dist/esm/lib/rag/defineRAG.js +39 -5
  77. package/dist/esm/lib/rag/defineRAG.js.map +1 -1
  78. package/dist/esm/memory/define.js +31 -1
  79. package/dist/esm/memory/define.js.map +1 -1
  80. package/dist/esm/memory/define.types.d.ts +13 -2
  81. package/dist/esm/memory/define.types.js.map +1 -1
  82. package/dist/esm/memory/embedding/loadRelevant.d.ts +10 -2
  83. package/dist/esm/memory/embedding/loadRelevant.js +36 -18
  84. package/dist/esm/memory/embedding/loadRelevant.js.map +1 -1
  85. package/dist/esm/memory/pipeline/semantic.d.ts +13 -2
  86. package/dist/esm/memory/pipeline/semantic.js +11 -5
  87. package/dist/esm/memory/pipeline/semantic.js.map +1 -1
  88. package/dist/esm/memory/store/capability.d.ts +25 -6
  89. package/dist/esm/memory/store/capability.js +68 -3
  90. package/dist/esm/memory/store/capability.js.map +1 -1
  91. package/dist/esm/memory/store/index.d.ts +1 -0
  92. package/dist/esm/memory/store/index.js +4 -0
  93. package/dist/esm/memory/store/index.js.map +1 -1
  94. package/dist/esm/memory/store/types.d.ts +40 -0
  95. package/dist/esm/memory-providers.d.ts +7 -4
  96. package/dist/esm/memory-providers.js +18 -4
  97. package/dist/esm/memory-providers.js.map +1 -1
  98. package/dist/esm/recorders/core/CredentialRecorder.d.ts +30 -0
  99. package/dist/esm/recorders/core/CredentialRecorder.js +35 -0
  100. package/dist/esm/recorders/core/CredentialRecorder.js.map +1 -0
  101. package/dist/esm/security/index.d.ts +7 -3
  102. package/dist/esm/security/index.js +12 -7
  103. package/dist/esm/security/index.js.map +1 -1
  104. package/dist/events/dispatcher.js.map +1 -1
  105. package/dist/hosting/standingAgent.js +14 -1
  106. package/dist/hosting/standingAgent.js.map +1 -1
  107. package/dist/lib/embedderMismatch.js +103 -0
  108. package/dist/lib/embedderMismatch.js.map +1 -0
  109. package/dist/lib/rag/defineRAG.js +39 -5
  110. package/dist/lib/rag/defineRAG.js.map +1 -1
  111. package/dist/memory/define.js +31 -1
  112. package/dist/memory/define.js.map +1 -1
  113. package/dist/memory/define.types.js.map +1 -1
  114. package/dist/memory/embedding/loadRelevant.js +36 -18
  115. package/dist/memory/embedding/loadRelevant.js.map +1 -1
  116. package/dist/memory/pipeline/semantic.js +11 -5
  117. package/dist/memory/pipeline/semantic.js.map +1 -1
  118. package/dist/memory/store/capability.js +70 -4
  119. package/dist/memory/store/capability.js.map +1 -1
  120. package/dist/memory/store/index.js +7 -1
  121. package/dist/memory/store/index.js.map +1 -1
  122. package/dist/memory-providers.js +22 -5
  123. package/dist/memory-providers.js.map +1 -1
  124. package/dist/recorders/core/CredentialRecorder.js +39 -0
  125. package/dist/recorders/core/CredentialRecorder.js.map +1 -0
  126. package/dist/security/index.js +13 -7
  127. package/dist/security/index.js.map +1 -1
  128. package/dist/types/adapters/identity/agentcore.d.ts +39 -9
  129. package/dist/types/adapters/identity/agentcore.d.ts.map +1 -1
  130. package/dist/types/adapters/llm/BedrockProvider.d.ts +24 -0
  131. package/dist/types/adapters/llm/BedrockProvider.d.ts.map +1 -1
  132. package/dist/types/adapters/memory/pgVector.d.ts +244 -0
  133. package/dist/types/adapters/memory/pgVector.d.ts.map +1 -0
  134. package/dist/types/adapters/memory/s3Vectors.d.ts +241 -0
  135. package/dist/types/adapters/memory/s3Vectors.d.ts.map +1 -0
  136. package/dist/types/adapters/memory/sqliteVector.d.ts +5 -27
  137. package/dist/types/adapters/memory/sqliteVector.d.ts.map +1 -1
  138. package/dist/types/adapters/observability/cloudwatch.d.ts +20 -0
  139. package/dist/types/adapters/observability/cloudwatch.d.ts.map +1 -1
  140. package/dist/types/adapters/observability/xray.d.ts +18 -0
  141. package/dist/types/adapters/observability/xray.d.ts.map +1 -1
  142. package/dist/types/adapters/security/agentcore.d.ts +81 -107
  143. package/dist/types/adapters/security/agentcore.d.ts.map +1 -1
  144. package/dist/types/bridge/eventMeta.d.ts +3 -0
  145. package/dist/types/bridge/eventMeta.d.ts.map +1 -1
  146. package/dist/types/core/Agent.d.ts +16 -0
  147. package/dist/types/core/Agent.d.ts.map +1 -1
  148. package/dist/types/core/agent/stages/toolCalls.d.ts.map +1 -1
  149. package/dist/types/doors/security.d.ts +3 -2
  150. package/dist/types/doors/security.d.ts.map +1 -1
  151. package/dist/types/embedders/index.d.ts +99 -19
  152. package/dist/types/embedders/index.d.ts.map +1 -1
  153. package/dist/types/events/dispatcher.d.ts +1 -1
  154. package/dist/types/events/dispatcher.d.ts.map +1 -1
  155. package/dist/types/events/payloads.d.ts +23 -1
  156. package/dist/types/events/payloads.d.ts.map +1 -1
  157. package/dist/types/events/types.d.ts +17 -0
  158. package/dist/types/events/types.d.ts.map +1 -1
  159. package/dist/types/hosting/standingAgent.d.ts.map +1 -1
  160. package/dist/types/lib/embedderMismatch.d.ts +68 -0
  161. package/dist/types/lib/embedderMismatch.d.ts.map +1 -0
  162. package/dist/types/lib/rag/defineRAG.d.ts +28 -6
  163. package/dist/types/lib/rag/defineRAG.d.ts.map +1 -1
  164. package/dist/types/memory/define.d.ts.map +1 -1
  165. package/dist/types/memory/define.types.d.ts +13 -2
  166. package/dist/types/memory/define.types.d.ts.map +1 -1
  167. package/dist/types/memory/embedding/loadRelevant.d.ts +10 -2
  168. package/dist/types/memory/embedding/loadRelevant.d.ts.map +1 -1
  169. package/dist/types/memory/pipeline/semantic.d.ts +13 -2
  170. package/dist/types/memory/pipeline/semantic.d.ts.map +1 -1
  171. package/dist/types/memory/store/capability.d.ts +25 -6
  172. package/dist/types/memory/store/capability.d.ts.map +1 -1
  173. package/dist/types/memory/store/index.d.ts +1 -0
  174. package/dist/types/memory/store/index.d.ts.map +1 -1
  175. package/dist/types/memory/store/types.d.ts +40 -0
  176. package/dist/types/memory/store/types.d.ts.map +1 -1
  177. package/dist/types/memory-providers.d.ts +7 -4
  178. package/dist/types/memory-providers.d.ts.map +1 -1
  179. package/dist/types/recorders/core/CredentialRecorder.d.ts +31 -0
  180. package/dist/types/recorders/core/CredentialRecorder.d.ts.map +1 -0
  181. package/dist/types/security/index.d.ts +7 -3
  182. package/dist/types/security/index.d.ts.map +1 -1
  183. package/package.json +9 -1
@@ -0,0 +1,31 @@
1
+ /**
2
+ * CredentialRecorder — forwards `agentfootprint.credential.*` emits to the
3
+ * dispatcher.
4
+ *
5
+ * Pattern: Factory over EmitBridge.
6
+ * Role: Bridges the declare-and-push credential lifecycle — requested,
7
+ * acquired, authorization_required, failed — so consumers observe it
8
+ * via `agent.on('agentfootprint.credential.failed', …)` and
9
+ * `agent.on('agentfootprint.credential.*', …)`.
10
+ * Emits: agentfootprint.credential.{requested,acquired,authorization_required,failed}
11
+ *
12
+ * ── Why this did not exist until 9.4.0, and what it cost ────────────────────
13
+ * The credential domain has had payload types, registry entries and real
14
+ * `typedEmit` call sites since 6.11.0 — and NO BRIDGE. Every one of those
15
+ * events was raised onto footprintjs's emit channel and stopped there: a raw
16
+ * `agent.attach()` recorder saw them, and `agent.on(...)` never did. So the
17
+ * documented way to watch for credential failures observed nothing, and an AWS
18
+ * identity adapter that failed 100% of its calls for two minor versions did so
19
+ * in a silence that read exactly like health.
20
+ *
21
+ * This is the law CLAUDE.md states for a new event DOMAIN — payload + registry
22
+ * entry + `DomainWildcard` arm + a bridge attach — with the fourth part
23
+ * missing. Zero-cost when nothing fires: `EmitBridge` drops an event with no
24
+ * listener before building any meta.
25
+ */
26
+ import { EmitBridge, type EmitBridgeOptions } from './EmitBridge.js';
27
+ export type CredentialRecorderOptions = Omit<EmitBridgeOptions, 'id' | 'prefix'> & {
28
+ readonly id?: string;
29
+ };
30
+ export declare function credentialRecorder(options: CredentialRecorderOptions): EmitBridge;
31
+ //# sourceMappingURL=CredentialRecorder.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"CredentialRecorder.d.ts","sourceRoot":"","sources":["../../../../src/recorders/core/CredentialRecorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAErE,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAAC,iBAAiB,EAAE,IAAI,GAAG,QAAQ,CAAC,GAAG;IACjF,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,UAAU,CAOjF"}
@@ -10,8 +10,12 @@
10
10
  * Today's surface is small and data-driven on purpose: one role
11
11
  * allowlist primitive that satisfies BOTH the v2.4 `PermissionChecker`
12
12
  * interface AND a sync `isAllowed(toolId)` predicate for use with
13
- * `gatedTools` from `agentfootprint/providers` — plus
14
- * `agentCorePolicy()`, the same port answered by a remote policy store.
13
+ * `gatedTools` from `agentfootprint/providers`.
14
+ *
15
+ * There is no shipped REMOTE policy engine. `agentCorePolicy()` was one
16
+ * through 9.3.0 and is retired in 9.4.0 — see the note beside its export
17
+ * below. The port stays open: a remote checker is an object with a
18
+ * `check()` method, and anybody can write one.
15
19
  *
16
20
  * A local allowlist and a remote policy engine differ in one way that
17
21
  * matters here: the local one can answer synchronously, so it doubles
@@ -49,6 +53,6 @@ export type { PolicyHaltContext } from './PolicyHaltError.js';
49
53
  export { extractSequence, SYNTHETIC_DENY_PREFIX } from './extractSequence.js';
50
54
  export type { ExtractSequenceOptions } from './extractSequence.js';
51
55
  export { redactThinkingBlocks, REDACTED_PLACEHOLDER } from './thinkingRedaction.js';
52
- export { agentCorePolicy, type AgentCorePolicyOptions, type AgentCorePolicyClientLike, type AgentCorePolicyEvaluation, type AgentCorePolicyUnavailable, type BedrockAgentCorePolicySdkModule, } from '../adapters/security/agentcore.js';
56
+ export { agentCorePolicy, AgentCorePolicyRetiredError, type AgentCorePolicyOptions, type AgentCorePolicyClientLike, type AgentCorePolicyEvaluation, type AgentCorePolicyUnavailable, type BedrockAgentCorePolicySdkModule, } from '../adapters/security/agentcore.js';
53
57
  export type { PermissionChecker, PermissionRequest, PermissionDecision, ToolCallEntry, ToolResultContent, } from '../adapters/types.js';
54
58
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/security/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAEpF,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC9E,YAAY,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAEnE,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAMpF,OAAO,EACL,eAAe,EACf,KAAK,sBAAsB,EAC3B,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,+BAA+B,GACrC,MAAM,mCAAmC,CAAC;AAM3C,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,iBAAiB,GAClB,MAAM,sBAAsB,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/security/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAEpF,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC9E,YAAY,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAEnE,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAOpF,OAAO,EACL,eAAe,EACf,2BAA2B,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,+BAA+B,GACrC,MAAM,mCAAmC,CAAC;AAM3C,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,iBAAiB,GAClB,MAAM,sBAAsB,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "agentfootprint",
3
- "version": "9.2.0",
3
+ "version": "9.4.0",
4
4
  "description": "The explainable agent framework — backtrack a wrong answer to the exact context that caused it (evidence, not guesses). Built on footprintjs.",
5
5
  "license": "MIT",
6
6
  "type": "commonjs",
@@ -269,6 +269,7 @@
269
269
  "@aws-sdk/client-bedrock-agentcore": "*",
270
270
  "@aws-sdk/client-bedrock-runtime": "*",
271
271
  "@aws-sdk/client-cloudwatch-logs": "*",
272
+ "@aws-sdk/client-s3vectors": "*",
272
273
  "@aws-sdk/client-xray": "*",
273
274
  "@huggingface/transformers": "*",
274
275
  "@modelcontextprotocol/sdk": "*",
@@ -277,6 +278,7 @@
277
278
  "footprintjs": "^9.15.0",
278
279
  "ioredis": "*",
279
280
  "openai": "*",
281
+ "pg": "*",
280
282
  "unpdf": "*",
281
283
  "zod": "*"
282
284
  },
@@ -299,9 +301,15 @@
299
301
  "@aws-sdk/client-cloudwatch-logs": {
300
302
  "optional": true
301
303
  },
304
+ "@aws-sdk/client-s3vectors": {
305
+ "optional": true
306
+ },
302
307
  "@aws-sdk/client-xray": {
303
308
  "optional": true
304
309
  },
310
+ "pg": {
311
+ "optional": true
312
+ },
305
313
  "@modelcontextprotocol/sdk": {
306
314
  "optional": true
307
315
  },