@providerkit/agents 0.1.0 → 0.2.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 (291) hide show
  1. package/LICENSE-APACHE-2.0 +202 -0
  2. package/README.md +2108 -52
  3. package/THIRD_PARTY_NOTICES.md +521 -0
  4. package/dist/a2a/auth.d.ts +10 -0
  5. package/dist/a2a/auth.d.ts.map +1 -0
  6. package/dist/a2a/auth.js +52 -0
  7. package/dist/a2a/auth.js.map +1 -0
  8. package/dist/a2a/client.d.ts +74 -0
  9. package/dist/a2a/client.d.ts.map +1 -0
  10. package/dist/a2a/client.js +601 -0
  11. package/dist/a2a/client.js.map +1 -0
  12. package/dist/a2a/index.d.ts +22 -0
  13. package/dist/a2a/index.d.ts.map +1 -0
  14. package/dist/a2a/index.js +11 -0
  15. package/dist/a2a/index.js.map +1 -0
  16. package/dist/a2a/memory-runs.d.ts +62 -0
  17. package/dist/a2a/memory-runs.d.ts.map +1 -0
  18. package/dist/a2a/memory-runs.js +349 -0
  19. package/dist/a2a/memory-runs.js.map +1 -0
  20. package/dist/a2a/policy.d.ts +15 -0
  21. package/dist/a2a/policy.d.ts.map +1 -0
  22. package/dist/a2a/policy.js +114 -0
  23. package/dist/a2a/policy.js.map +1 -0
  24. package/dist/a2a/push.d.ts +34 -0
  25. package/dist/a2a/push.d.ts.map +1 -0
  26. package/dist/a2a/push.js +180 -0
  27. package/dist/a2a/push.js.map +1 -0
  28. package/dist/a2a/remote.d.ts +155 -0
  29. package/dist/a2a/remote.d.ts.map +1 -0
  30. package/dist/a2a/remote.js +1196 -0
  31. package/dist/a2a/remote.js.map +1 -0
  32. package/dist/a2a/server.d.ts +110 -0
  33. package/dist/a2a/server.d.ts.map +1 -0
  34. package/dist/a2a/server.js +1139 -0
  35. package/dist/a2a/server.js.map +1 -0
  36. package/dist/a2a/signing.d.ts +21 -0
  37. package/dist/a2a/signing.d.ts.map +1 -0
  38. package/dist/a2a/signing.js +305 -0
  39. package/dist/a2a/signing.js.map +1 -0
  40. package/dist/a2a/tasks.d.ts +88 -0
  41. package/dist/a2a/tasks.d.ts.map +1 -0
  42. package/dist/a2a/tasks.js +170 -0
  43. package/dist/a2a/tasks.js.map +1 -0
  44. package/dist/a2a/wire.d.ts +267 -0
  45. package/dist/a2a/wire.d.ts.map +1 -0
  46. package/dist/a2a/wire.js +1202 -0
  47. package/dist/a2a/wire.js.map +1 -0
  48. package/dist/background-types.d.ts +76 -0
  49. package/dist/background-types.d.ts.map +1 -0
  50. package/dist/background-types.js +2 -0
  51. package/dist/background-types.js.map +1 -0
  52. package/dist/child.d.ts +25 -0
  53. package/dist/child.d.ts.map +1 -0
  54. package/dist/child.js +129 -0
  55. package/dist/child.js.map +1 -0
  56. package/dist/code-driver.d.ts +40 -0
  57. package/dist/code-driver.d.ts.map +1 -0
  58. package/dist/code-driver.js +2 -0
  59. package/dist/code-driver.js.map +1 -0
  60. package/dist/code-mode.d.ts +3 -0
  61. package/dist/code-mode.d.ts.map +1 -0
  62. package/dist/code-mode.js +2 -0
  63. package/dist/code-mode.js.map +1 -0
  64. package/dist/code-script.d.ts +3 -0
  65. package/dist/code-script.d.ts.map +1 -0
  66. package/dist/code-script.js +149 -0
  67. package/dist/code-script.js.map +1 -0
  68. package/dist/code.d.ts +75 -0
  69. package/dist/code.d.ts.map +1 -0
  70. package/dist/code.js +326 -0
  71. package/dist/code.js.map +1 -0
  72. package/dist/compaction.d.ts +15 -0
  73. package/dist/compaction.d.ts.map +1 -0
  74. package/dist/compaction.js +168 -0
  75. package/dist/compaction.js.map +1 -0
  76. package/dist/delegation.d.ts +85 -16
  77. package/dist/delegation.d.ts.map +1 -1
  78. package/dist/delegation.js +240 -106
  79. package/dist/delegation.js.map +1 -1
  80. package/dist/evals/driver.d.ts +10 -0
  81. package/dist/evals/driver.d.ts.map +1 -0
  82. package/dist/evals/driver.js +192 -0
  83. package/dist/evals/driver.js.map +1 -0
  84. package/dist/evals/journal.d.ts +26 -0
  85. package/dist/evals/journal.d.ts.map +1 -0
  86. package/dist/evals/journal.js +483 -0
  87. package/dist/evals/journal.js.map +1 -0
  88. package/dist/evals/judge.d.ts +31 -0
  89. package/dist/evals/judge.d.ts.map +1 -0
  90. package/dist/evals/judge.js +142 -0
  91. package/dist/evals/judge.js.map +1 -0
  92. package/dist/evals/report.d.ts +38 -0
  93. package/dist/evals/report.d.ts.map +1 -0
  94. package/dist/evals/report.js +241 -0
  95. package/dist/evals/report.js.map +1 -0
  96. package/dist/evals/runner.d.ts +24 -0
  97. package/dist/evals/runner.d.ts.map +1 -0
  98. package/dist/evals/runner.js +655 -0
  99. package/dist/evals/runner.js.map +1 -0
  100. package/dist/evals/scorers.d.ts +36 -0
  101. package/dist/evals/scorers.d.ts.map +1 -0
  102. package/dist/evals/scorers.js +259 -0
  103. package/dist/evals/scorers.js.map +1 -0
  104. package/dist/evals/simulation.d.ts +7 -0
  105. package/dist/evals/simulation.d.ts.map +1 -0
  106. package/dist/evals/simulation.js +38 -0
  107. package/dist/evals/simulation.js.map +1 -0
  108. package/dist/evals/testing.d.ts +36 -0
  109. package/dist/evals/testing.d.ts.map +1 -0
  110. package/dist/evals/testing.js +87 -0
  111. package/dist/evals/testing.js.map +1 -0
  112. package/dist/evals/trajectory.d.ts +11 -0
  113. package/dist/evals/trajectory.d.ts.map +1 -0
  114. package/dist/evals/trajectory.js +180 -0
  115. package/dist/evals/trajectory.js.map +1 -0
  116. package/dist/evals/types.d.ts +431 -0
  117. package/dist/evals/types.d.ts.map +1 -0
  118. package/dist/evals/types.js +4 -0
  119. package/dist/evals/types.js.map +1 -0
  120. package/dist/evals.d.ts +14 -0
  121. package/dist/evals.d.ts.map +1 -0
  122. package/dist/evals.js +9 -0
  123. package/dist/evals.js.map +1 -0
  124. package/dist/extensions.d.ts +33 -0
  125. package/dist/extensions.d.ts.map +1 -0
  126. package/dist/extensions.js +188 -0
  127. package/dist/extensions.js.map +1 -0
  128. package/dist/handoff.d.ts +58 -0
  129. package/dist/handoff.d.ts.map +1 -0
  130. package/dist/handoff.js +160 -0
  131. package/dist/handoff.js.map +1 -0
  132. package/dist/index.d.ts +14 -0
  133. package/dist/index.d.ts.map +1 -1
  134. package/dist/index.js +8 -0
  135. package/dist/index.js.map +1 -1
  136. package/dist/input.d.ts +42 -0
  137. package/dist/input.d.ts.map +1 -0
  138. package/dist/input.js +266 -0
  139. package/dist/input.js.map +1 -0
  140. package/dist/mcp.d.ts +77 -0
  141. package/dist/mcp.d.ts.map +1 -0
  142. package/dist/mcp.js +505 -0
  143. package/dist/mcp.js.map +1 -0
  144. package/dist/memory-store.d.ts +11 -0
  145. package/dist/memory-store.d.ts.map +1 -0
  146. package/dist/memory-store.js +272 -0
  147. package/dist/memory-store.js.map +1 -0
  148. package/dist/memory.d.ts +212 -0
  149. package/dist/memory.d.ts.map +1 -0
  150. package/dist/memory.js +613 -0
  151. package/dist/memory.js.map +1 -0
  152. package/dist/otel.d.ts +74 -0
  153. package/dist/otel.d.ts.map +1 -0
  154. package/dist/otel.js +427 -0
  155. package/dist/otel.js.map +1 -0
  156. package/dist/progress.d.ts +17 -0
  157. package/dist/progress.d.ts.map +1 -0
  158. package/dist/progress.js +193 -0
  159. package/dist/progress.js.map +1 -0
  160. package/dist/quickjs.d.ts +19 -0
  161. package/dist/quickjs.d.ts.map +1 -0
  162. package/dist/quickjs.js +519 -0
  163. package/dist/quickjs.js.map +1 -0
  164. package/dist/recovery.d.ts +10 -0
  165. package/dist/recovery.d.ts.map +1 -0
  166. package/dist/recovery.js +62 -0
  167. package/dist/recovery.js.map +1 -0
  168. package/dist/request.d.ts +88 -0
  169. package/dist/request.d.ts.map +1 -0
  170. package/dist/request.js +422 -0
  171. package/dist/request.js.map +1 -0
  172. package/dist/run.d.ts +16 -4
  173. package/dist/run.d.ts.map +1 -1
  174. package/dist/run.js +2016 -245
  175. package/dist/run.js.map +1 -1
  176. package/dist/runs.d.ts +77 -34
  177. package/dist/runs.d.ts.map +1 -1
  178. package/dist/runs.js +267 -85
  179. package/dist/runs.js.map +1 -1
  180. package/dist/schema-to-ts.d.ts +4 -0
  181. package/dist/schema-to-ts.d.ts.map +1 -0
  182. package/dist/schema-to-ts.js +191 -0
  183. package/dist/schema-to-ts.js.map +1 -0
  184. package/dist/session.d.ts +23 -0
  185. package/dist/session.d.ts.map +1 -0
  186. package/dist/session.js +137 -0
  187. package/dist/session.js.map +1 -0
  188. package/dist/snapshot.d.ts +57 -8
  189. package/dist/snapshot.d.ts.map +1 -1
  190. package/dist/snapshot.js +1206 -109
  191. package/dist/snapshot.js.map +1 -1
  192. package/dist/steering.d.ts +75 -0
  193. package/dist/steering.d.ts.map +1 -0
  194. package/dist/steering.js +214 -0
  195. package/dist/steering.js.map +1 -0
  196. package/dist/subagents.d.ts +141 -0
  197. package/dist/subagents.d.ts.map +1 -0
  198. package/dist/subagents.js +746 -0
  199. package/dist/subagents.js.map +1 -0
  200. package/dist/tool-retry.d.ts +12 -0
  201. package/dist/tool-retry.d.ts.map +1 -0
  202. package/dist/tool-retry.js +53 -0
  203. package/dist/tool-retry.js.map +1 -0
  204. package/dist/tree.d.ts +62 -6
  205. package/dist/tree.d.ts.map +1 -1
  206. package/dist/tree.js +192 -23
  207. package/dist/tree.js.map +1 -1
  208. package/dist/types.d.ts +767 -52
  209. package/dist/types.d.ts.map +1 -1
  210. package/dist/workflow-snapshot.d.ts +8 -0
  211. package/dist/workflow-snapshot.d.ts.map +1 -0
  212. package/dist/workflow-snapshot.js +276 -0
  213. package/dist/workflow-snapshot.js.map +1 -0
  214. package/dist/workflow-types.d.ts +171 -0
  215. package/dist/workflow-types.d.ts.map +1 -0
  216. package/dist/workflow-types.js +2 -0
  217. package/dist/workflow-types.js.map +1 -0
  218. package/dist/workflow.d.ts +19 -0
  219. package/dist/workflow.d.ts.map +1 -0
  220. package/dist/workflow.js +1053 -0
  221. package/dist/workflow.js.map +1 -0
  222. package/examples/a2a-remote.ts +85 -0
  223. package/examples/a2a-server.ts +100 -0
  224. package/examples/background.ts +18 -4
  225. package/examples/code-mode.ts +76 -0
  226. package/examples/conversation.ts +57 -0
  227. package/examples/evals.ts +79 -0
  228. package/examples/guardrails.ts +56 -0
  229. package/examples/handoff.ts +79 -0
  230. package/examples/memory.ts +44 -0
  231. package/examples/otel.ts +99 -0
  232. package/examples/steering.ts +69 -0
  233. package/examples/structured-handoff.ts +92 -0
  234. package/examples/subagents.ts +127 -0
  235. package/examples/workflow.ts +74 -0
  236. package/package.json +58 -6
  237. package/src/a2a/auth.ts +62 -0
  238. package/src/a2a/client.ts +733 -0
  239. package/src/a2a/index.ts +74 -0
  240. package/src/a2a/memory-runs.ts +448 -0
  241. package/src/a2a/policy.ts +148 -0
  242. package/src/a2a/push.ts +251 -0
  243. package/src/a2a/remote.ts +1652 -0
  244. package/src/a2a/server.ts +1390 -0
  245. package/src/a2a/signing.ts +348 -0
  246. package/src/a2a/tasks.ts +260 -0
  247. package/src/a2a/wire.ts +1443 -0
  248. package/src/background-types.ts +86 -0
  249. package/src/child.ts +181 -0
  250. package/src/code-driver.ts +48 -0
  251. package/src/code-mode.ts +12 -0
  252. package/src/code-script.ts +149 -0
  253. package/src/code.ts +424 -0
  254. package/src/compaction.ts +212 -0
  255. package/src/delegation.ts +444 -155
  256. package/src/evals/driver.ts +222 -0
  257. package/src/evals/journal.ts +605 -0
  258. package/src/evals/judge.ts +188 -0
  259. package/src/evals/report.ts +295 -0
  260. package/src/evals/runner.ts +826 -0
  261. package/src/evals/scorers.ts +339 -0
  262. package/src/evals/simulation.ts +46 -0
  263. package/src/evals/testing.ts +126 -0
  264. package/src/evals/trajectory.ts +223 -0
  265. package/src/evals/types.ts +463 -0
  266. package/src/evals.ts +72 -0
  267. package/src/extensions.ts +247 -0
  268. package/src/handoff.ts +214 -0
  269. package/src/index.ts +51 -0
  270. package/src/input.ts +319 -0
  271. package/src/mcp.ts +690 -0
  272. package/src/memory-store.ts +366 -0
  273. package/src/memory.ts +893 -0
  274. package/src/otel.ts +568 -0
  275. package/src/progress.ts +214 -0
  276. package/src/quickjs.ts +524 -0
  277. package/src/recovery.ts +90 -0
  278. package/src/request.ts +513 -0
  279. package/src/run.ts +2678 -313
  280. package/src/runs.ts +464 -133
  281. package/src/schema-to-ts.ts +194 -0
  282. package/src/session.ts +178 -0
  283. package/src/snapshot.ts +1595 -124
  284. package/src/steering.ts +329 -0
  285. package/src/subagents.ts +1084 -0
  286. package/src/tool-retry.ts +86 -0
  287. package/src/tree.ts +223 -27
  288. package/src/types.ts +711 -52
  289. package/src/workflow-snapshot.ts +366 -0
  290. package/src/workflow-types.ts +213 -0
  291. package/src/workflow.ts +1316 -0
@@ -0,0 +1,272 @@
1
+ // Adapted from TanStack AI (MIT), ai-memory/internal/store.ts and testkit/contract.ts.
2
+ // Copyright (c) 2025 Tanner Linsley. Changed: Unicode words, every scope dimension,
3
+ // atomic version checks, erasure generations and ingestion receipts; no vector calls.
4
+ import { MEMORY_LIMITS, MemoryConflictError, MemoryErasedError, isMemoryAccess, isMemoryScope, memoryKey, memoryScopeKey, readMemoryDeletions, readMemoryIngest, readMemoryNotes, sameMemoryScope, } from "./memory.js";
5
+ import { requestHash } from "./request.js";
6
+ import { copyData, equalData, isId } from "./snapshot.js";
7
+ /** Process-lifetime reference only: no persistence, database, embedding calls or scheduler. */
8
+ export function createMemoryStore(options = {}) {
9
+ const now = options.now ?? Date.now;
10
+ const records = new Map();
11
+ const revisions = new Map();
12
+ const receipts = new Map();
13
+ const personKey = (scope) => JSON.stringify([scope.tenantId, scope.userId ?? null]);
14
+ const recordKey = (scope, key) => JSON.stringify([memoryScopeKey(scope), key]);
15
+ const receiptKey = (access, runId) => JSON.stringify([memoryScopeKey(access.scope), access.revision, runId]);
16
+ function revision(scope) {
17
+ const key = personKey(scope);
18
+ let value = revisions.get(key);
19
+ if (!value) {
20
+ value = crypto.randomUUID();
21
+ revisions.set(key, value);
22
+ }
23
+ return value;
24
+ }
25
+ function check(access, call) {
26
+ call.signal.throwIfAborted();
27
+ if (!isMemoryAccess(access))
28
+ throw new TypeError("Memory needs an exact scope and erasure revision.");
29
+ if (revision(access.scope) !== access.revision)
30
+ throw new MemoryErasedError();
31
+ }
32
+ function live(record) {
33
+ return !!record && (record.expiresAt === undefined || record.expiresAt > now());
34
+ }
35
+ function current(access, key) {
36
+ const record = records.get(recordKey(access.scope, key));
37
+ return live(record) ? record : undefined;
38
+ }
39
+ function prepare(access, raw, call) {
40
+ const notes = readMemoryNotes(raw);
41
+ check(access, call);
42
+ const at = now();
43
+ return notes.map((note) => {
44
+ const before = current(access, note.key);
45
+ if ((before?.version ?? null) !== note.version)
46
+ throw new MemoryConflictError();
47
+ return {
48
+ ...copyData(note),
49
+ scope: copyData(access.scope),
50
+ version: crypto.randomUUID(),
51
+ createdAt: before?.createdAt ?? at,
52
+ updatedAt: at,
53
+ };
54
+ });
55
+ }
56
+ function commit(notes) {
57
+ for (const note of notes)
58
+ records.set(recordKey(note.scope, note.key), note);
59
+ }
60
+ function keys(raw) {
61
+ if (!Array.isArray(raw) ||
62
+ raw.length < 1 ||
63
+ raw.length > MEMORY_LIMITS.batch ||
64
+ !raw.every(memoryKey) ||
65
+ new Set(raw).size !== raw.length)
66
+ throw new TypeError("Read 1 to 20 unique note keys.");
67
+ }
68
+ const words = (text) => new Set(text
69
+ .normalize("NFD")
70
+ .replace(/\p{M}/gu, "")
71
+ .toLowerCase()
72
+ .match(/[\p{L}\p{N}]+/gu) ?? []);
73
+ return {
74
+ async access(scope, call) {
75
+ call.signal.throwIfAborted();
76
+ if (!isMemoryScope(scope))
77
+ throw new TypeError("Supply an explicit tenant and valid memory scope.");
78
+ return { scope: copyData(scope), revision: revision(scope) };
79
+ },
80
+ async get({ access, keys: names }, call) {
81
+ check(access, call);
82
+ keys(names);
83
+ return copyData(names.flatMap((key) => {
84
+ const note = current(access, key);
85
+ return note ? [note] : [];
86
+ }));
87
+ },
88
+ async search({ scopes, query, limit }, call) {
89
+ if (!Array.isArray(scopes) ||
90
+ !scopes.length ||
91
+ scopes.length > MEMORY_LIMITS.scopes ||
92
+ typeof query !== "string" ||
93
+ query.length > MEMORY_LIMITS.queryChars ||
94
+ !Number.isSafeInteger(limit) ||
95
+ limit < 1 ||
96
+ limit > MEMORY_LIMITS.matches)
97
+ throw new TypeError("Search needs bounded scopes, query and limit.");
98
+ for (const access of scopes)
99
+ check(access, call);
100
+ if (new Set(scopes.map((access) => memoryScopeKey(access.scope))).size !== scopes.length)
101
+ throw new TypeError("Search each scope once.");
102
+ const tokens = words(query);
103
+ // ponytail: linear scan for offline examples. Use a host database index for production.
104
+ return copyData([...records.values()]
105
+ .filter((note) => live(note) && scopes.some((access) => sameMemoryScope(access.scope, note.scope)))
106
+ .map((note) => {
107
+ const text = words(note.text);
108
+ const score = [...tokens].filter((token) => text.has(token)).length / (tokens.size || 1);
109
+ return { note, score };
110
+ })
111
+ .filter(({ score }) => score > 0)
112
+ .sort((a, b) => b.score - a.score ||
113
+ b.note.updatedAt - a.note.updatedAt ||
114
+ a.note.key.localeCompare(b.note.key))
115
+ .slice(0, limit)
116
+ .map(({ note }) => note));
117
+ },
118
+ async save({ access, notes }, call) {
119
+ const prepared = prepare(access, notes, call);
120
+ commit(prepared);
121
+ return copyData(prepared);
122
+ },
123
+ async delete({ access, notes: raw }, call) {
124
+ const notes = readMemoryDeletions(raw);
125
+ check(access, call);
126
+ if (notes.some((note) => current(access, note.key)?.version !== note.version))
127
+ throw new MemoryConflictError();
128
+ for (const note of notes)
129
+ records.delete(recordKey(access.scope, note.key));
130
+ return { deleted: notes.length };
131
+ },
132
+ async erase(person, call) {
133
+ call.signal.throwIfAborted();
134
+ if (!isMemoryScope(person) ||
135
+ !person.userId ||
136
+ Object.keys(person).some((key) => key !== "tenantId" && key !== "userId"))
137
+ throw new TypeError("Erasure needs exactly one tenant and one person.");
138
+ const key = personKey(person);
139
+ // Fence every namespace, including one with no records yet. No wall-clock race or skew.
140
+ revisions.set(key, crypto.randomUUID());
141
+ for (const [id, note] of records)
142
+ if (personKey(note.scope) === key)
143
+ records.delete(id);
144
+ for (const [id, entry] of receipts)
145
+ if (personKey(entry.access.scope) === key)
146
+ receipts.delete(id);
147
+ },
148
+ async ingest(raw, call) {
149
+ const request = readMemoryIngest(raw);
150
+ check(request.access, call);
151
+ const fingerprint = await requestHash(request);
152
+ // Hashing yields. Recheck after it, in the same synchronous section as CAS and commit.
153
+ check(request.access, call);
154
+ const key = receiptKey(request.access, request.runId);
155
+ const prior = receipts.get(key);
156
+ if (prior) {
157
+ if (prior.receipt.fingerprint !== fingerprint)
158
+ throw new MemoryConflictError();
159
+ return copyData(prior.receipt);
160
+ }
161
+ const notes = prepare(request.access, request.notes, call);
162
+ const receipt = {
163
+ runId: request.runId,
164
+ fingerprint,
165
+ saved: notes.map(({ key, version }) => ({ key, version })),
166
+ };
167
+ commit(notes);
168
+ receipts.set(key, { access: copyData(request.access), receipt });
169
+ return copyData(receipt);
170
+ },
171
+ async receipt({ access, runId }, call) {
172
+ check(access, call);
173
+ if (!isId(runId))
174
+ throw new TypeError("A receipt needs its run id.");
175
+ return copyData(receipts.get(receiptKey(access, runId))?.receipt ?? null);
176
+ },
177
+ };
178
+ }
179
+ /** DESTRUCTIVE check. The caller explicitly supplies a disposable store, never a live one.
180
+ * Adapted from TanStack's contract suite without depending on a test runner. */
181
+ export async function checkMemoryStore(options) {
182
+ const store = options.disposable;
183
+ const call = { signal: new AbortController().signal };
184
+ const tenantId = `memory-check-${crypto.randomUUID()}`;
185
+ const scope = { tenantId, userId: "4", sessionId: "__proto__", namespace: "notes" };
186
+ function assert(ok, rule) {
187
+ if (!ok)
188
+ throw new Error(`MemoryStore failed: ${rule}.`);
189
+ }
190
+ async function conflict(work, name) {
191
+ try {
192
+ await work;
193
+ }
194
+ catch (error) {
195
+ assert(error instanceof Error && error.name === name, name);
196
+ return;
197
+ }
198
+ throw new Error(`MemoryStore failed: expected ${name}.`);
199
+ }
200
+ const access = await store.access(scope, call);
201
+ assert(equalData(access.scope, scope), "access keeps the exact scope");
202
+ assert((await store.search({ scopes: [access], query: "coffee", limit: 1 }, call)).length === 0, "empty store");
203
+ const saved = await store.save({ access, notes: [{ key: "preference", text: "coffee", version: null }] }, call);
204
+ const note = saved[0];
205
+ assert(!!note && note.text === "coffee" && isId(note.version), "save receipt");
206
+ const version = note.version;
207
+ note.text = "changed copy";
208
+ const found = await store.search({ scopes: [access], query: "coffee", limit: 1 }, call);
209
+ assert(found.length === 1 && found[0]?.text === "coffee", "round trip and write cloning");
210
+ if (found[0])
211
+ found[0].text = "changed read";
212
+ assert((await store.get({ access, keys: ["preference"] }, call))[0]?.text === "coffee", "read cloning");
213
+ const others = [
214
+ { ...scope, tenantId: `${tenantId}-other` },
215
+ { ...scope, userId: "42" },
216
+ { ...scope, sessionId: "other" },
217
+ { ...scope, namespace: "other" },
218
+ { tenantId, userId: "4" },
219
+ { tenantId },
220
+ ];
221
+ for (const other of others) {
222
+ const otherAccess = await store.access(other, call);
223
+ assert((await store.get({ access: otherAccess, keys: ["preference"] }, call)).length === 0, "exact get isolation");
224
+ assert((await store.search({ scopes: [otherAccess], query: "coffee", limit: 1 }, call)).length === 0, "exact search isolation");
225
+ }
226
+ const results = await Promise.allSettled(["a", "b"].map((text) => store.save({ access, notes: [{ key: "preference", text, version }] }, call)));
227
+ assert(results.filter((result) => result.status === "fulfilled").length === 1, "one winner for a version race");
228
+ await conflict(store.delete({ access, notes: [{ key: "preference", version }] }, call), "MemoryConflictError");
229
+ const current = (await store.get({ access, keys: ["preference"] }, call))[0];
230
+ assert(!!current && current.version !== version, "versions change");
231
+ await store.delete({ access, notes: [{ key: "preference", version: current.version }] }, call);
232
+ assert((await store.get({ access, keys: ["preference"] }, call)).length === 0, "delete by version");
233
+ await store.save({
234
+ access,
235
+ notes: [
236
+ { key: "extra1", text: "coffee", version: null },
237
+ { key: "extra2", text: "coffee", version: null },
238
+ ],
239
+ }, call);
240
+ assert((await store.search({ scopes: [access], query: "coffee", limit: 1 }, call)).length === 1, "search limit");
241
+ await store.save({ access, notes: [{ key: "expired", text: "coffee", version: null, expiresAt: 0 }] }, call);
242
+ assert((await store.get({ access, keys: ["expired"] }, call)).length === 0, "expiry");
243
+ const sibling = await store.access({ ...scope, userId: "42" }, call);
244
+ const tenant = await store.access({ ...scope, tenantId: `${tenantId}-other` }, call);
245
+ for (const other of [sibling, tenant])
246
+ await store.save({ access: other, notes: [{ key: "kept", text: "coffee", version: null }] }, call);
247
+ if (store.ingest && store.receipt) {
248
+ const request = {
249
+ access,
250
+ runId: "run",
251
+ agent: { id: "agent", version: "1" },
252
+ messages: [],
253
+ notes: [{ key: "fact", text: "coffee", version: null }],
254
+ };
255
+ const first = await store.ingest(request, call);
256
+ assert(equalData(first, await store.ingest(request, call)), "atomic duplicate ingestion receipt");
257
+ assert(equalData(first, await store.receipt({ access, runId: "run" }, call)), "read-only ingestion reconciliation");
258
+ await conflict(store.ingest({ ...request, notes: [{ key: "fact", text: "other", version: null }] }, call), "MemoryConflictError");
259
+ }
260
+ await store.erase({ tenantId, userId: "4" }, call);
261
+ await conflict(store.save({ access, notes: [{ key: "late", text: "coffee", version: null }] }, call), "MemoryErasedError");
262
+ for (const other of [sibling, tenant])
263
+ assert((await store.get({ access: other, keys: ["kept"] }, call)).length === 1, "erasure isolates tenant and person");
264
+ const fresh = await store.access(scope, call);
265
+ assert(fresh.revision !== access.revision &&
266
+ (await store.get({ access: fresh, keys: ["fact"] }, call)).length === 0, "erase removes data and rotates revision");
267
+ if (store.receipt)
268
+ assert((await store.receipt({ access: fresh, runId: "run" }, call)) === null, "erase removes ingestion receipts");
269
+ await store.erase({ tenantId, userId: "42" }, call);
270
+ await store.erase({ tenantId: `${tenantId}-other`, userId: "4" }, call);
271
+ }
272
+ //# sourceMappingURL=memory-store.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"memory-store.js","sourceRoot":"","sources":["../src/memory-store.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,212 @@
1
+ import { type Tool } from "@providerkit/core";
2
+ import type { AgentMessage, RunOutcome, RunSnapshot, ToolRequest, UserContent } from "./types.ts";
3
+ export declare const MEMORY_TOOL_NAMES: readonly string[];
4
+ export declare const MEMORY_LIMITS: Readonly<{
5
+ scopes: 8;
6
+ matches: 20;
7
+ queryChars: 2000;
8
+ noteChars: 16000;
9
+ recallChars: 16000;
10
+ batch: 20;
11
+ ingestBytes: 1000000;
12
+ }>;
13
+ /** Build from authenticated host data. Even a single-tenant app supplies its own tenant id. */
14
+ export interface MemoryScope {
15
+ tenantId: string;
16
+ userId?: string;
17
+ sessionId?: string;
18
+ namespace?: string;
19
+ }
20
+ /** An erasure generation, not permission. The store must reject old generations atomically. */
21
+ export interface MemoryAccess {
22
+ scope: MemoryScope;
23
+ revision: string;
24
+ }
25
+ export interface MemoryCall {
26
+ signal: AbortSignal;
27
+ }
28
+ export interface MemoryInput {
29
+ key: string;
30
+ text: string;
31
+ /** null creates only when absent; a version replaces only that exact record. */
32
+ version: string | null;
33
+ expiresAt?: number;
34
+ }
35
+ export interface MemoryRecord extends Omit<MemoryInput, "version"> {
36
+ scope: MemoryScope;
37
+ version: string;
38
+ createdAt: number;
39
+ updatedAt: number;
40
+ }
41
+ export interface MemoryScopes {
42
+ /** The only scope tools may write. Must name a person. */
43
+ scope?: MemoryAccess;
44
+ /** Exact, read-only scopes. Unset dimensions are never wildcards. */
45
+ shared: MemoryAccess[];
46
+ keepForMs?: number;
47
+ }
48
+ export interface MemoryBinding {
49
+ store: MemoryStore;
50
+ scope?: MemoryAccess;
51
+ shared?: readonly MemoryAccess[];
52
+ keepForMs?: number;
53
+ }
54
+ export interface MemoryIngest {
55
+ access: MemoryAccess;
56
+ runId: string;
57
+ agent: {
58
+ id: string;
59
+ version: string;
60
+ };
61
+ messages: AgentMessage[];
62
+ /** Host-selected facts. No extraction call is made by this SDK. */
63
+ notes: MemoryInput[];
64
+ }
65
+ export interface MemoryIngestReceipt {
66
+ runId: string;
67
+ /** SHA-256 of the complete normalized request, computed and checked by the store. */
68
+ fingerprint: string;
69
+ saved: {
70
+ key: string;
71
+ version: string;
72
+ }[];
73
+ }
74
+ /** Host-owned storage. Authenticate outside this interface; ids alone grant nothing.
75
+ * All mutations are atomic, including version checks and erasure-generation checks.
76
+ * Never reuse a record version, including after delete/recreate. Delete derived data too. */
77
+ export interface MemoryStore {
78
+ access(scope: MemoryScope, call: MemoryCall): Promise<MemoryAccess>;
79
+ get(request: {
80
+ access: MemoryAccess;
81
+ keys: readonly string[];
82
+ }, call: MemoryCall): Promise<MemoryRecord[]>;
83
+ search(request: {
84
+ scopes: readonly MemoryAccess[];
85
+ query: string;
86
+ limit: number;
87
+ }, call: MemoryCall): Promise<MemoryRecord[]>;
88
+ save(request: {
89
+ access: MemoryAccess;
90
+ notes: readonly MemoryInput[];
91
+ }, call: MemoryCall): Promise<MemoryRecord[]>;
92
+ delete(request: {
93
+ access: MemoryAccess;
94
+ notes: readonly {
95
+ key: string;
96
+ version: string;
97
+ }[];
98
+ }, call: MemoryCall): Promise<{
99
+ deleted: number;
100
+ }>;
101
+ /** All sessions and namespaces for exactly this tenant and person. Invalidates old accesses,
102
+ * including in-flight writes/ingestion, and removes their receipts and derived data. */
103
+ erase(person: {
104
+ tenantId: string;
105
+ userId: string;
106
+ }, call: MemoryCall): Promise<void>;
107
+ /** Optional pair. Atomically commit notes AND a receipt keyed by (access, runId). The same
108
+ * request returns the original receipt; different content under that key must conflict.
109
+ * Do not perform paid extraction here: an interrupted call has an unknown outcome. */
110
+ ingest?(request: MemoryIngest, call: MemoryCall): Promise<MemoryIngestReceipt>;
111
+ /** Read-only reconciliation after an unknown ingestion result. */
112
+ receipt?(request: {
113
+ access: MemoryAccess;
114
+ runId: string;
115
+ }, call: MemoryCall): Promise<MemoryIngestReceipt | null>;
116
+ }
117
+ export declare class MemoryConflictError extends Error {
118
+ constructor();
119
+ }
120
+ export declare class MemoryErasedError extends Error {
121
+ constructor();
122
+ }
123
+ /** Invalid store data must not enter a model or checkpoint. */
124
+ export declare class MemoryScopeError extends Error {
125
+ constructor();
126
+ }
127
+ export interface AgentMemory {
128
+ /** At most 20 matches. Default 5. */
129
+ limit?: number;
130
+ /** Complete rendered block, including framing. Default 4,000; at most 16,000. */
131
+ maxChars?: number;
132
+ /** Default continue. Scope violations and erased access always fail closed. */
133
+ onError?: "continue" | "fail";
134
+ }
135
+ export interface MemoryPolicy {
136
+ limit: number;
137
+ maxChars: number;
138
+ onError: "continue" | "fail";
139
+ }
140
+ export type MemoryRecall = {
141
+ at: number;
142
+ } & ({
143
+ status: "recalled";
144
+ query: string;
145
+ text: string;
146
+ used: {
147
+ scope: number;
148
+ key: string;
149
+ version: string;
150
+ }[];
151
+ omitted: number;
152
+ } | {
153
+ status: "failed";
154
+ code: "memory_unavailable";
155
+ });
156
+ export declare const memoryKey: (value: unknown) => value is string;
157
+ export declare function isMemoryScope(value: unknown): value is MemoryScope;
158
+ export declare function isMemoryAccess(value: unknown): value is MemoryAccess;
159
+ export declare function memoryScopeKey(scope: MemoryScope): string;
160
+ export declare function sameMemoryScope(left: MemoryScope, right: MemoryScope): boolean;
161
+ export declare function isMemoryScopes(value: unknown): value is MemoryScopes;
162
+ export declare function readMemoryBinding(value: unknown): MemoryBinding | undefined;
163
+ export declare function memoryScopes(binding?: MemoryBinding): MemoryScopes | undefined;
164
+ export declare function checkMemoryBinding(snapshot: Pick<RunSnapshot, "tree">, binding?: MemoryBinding): void;
165
+ export declare function isMemoryPolicy(value: unknown): value is MemoryPolicy;
166
+ export declare function memoryPolicy(value?: AgentMemory | true): MemoryPolicy | undefined;
167
+ export declare function isMemoryRecall(value: unknown): value is MemoryRecall;
168
+ export declare function checkMemorySnapshot(snapshot: RunSnapshot): void;
169
+ export declare function readMemoryNotes(value: unknown, max?: number): MemoryInput[];
170
+ export declare function readMemoryRecords(raw: unknown, scopes: readonly MemoryAccess[], limit: number, keys?: readonly string[]): MemoryRecord[];
171
+ export declare function recallMemory(snapshot: RunSnapshot, binding: MemoryBinding, signal: AbortSignal, input?: UserContent): Promise<MemoryRecall>;
172
+ /** Model view only. No added transcript messages or changed compaction/inbox positions. */
173
+ export declare function withMemoryRecall(snapshot: RunSnapshot, messages: AgentMessage[]): AgentMessage[];
174
+ export declare function isMemoryTool(tool: {
175
+ name: string;
176
+ }): tool is Tool;
177
+ export declare function bindMemoryTool(tool: Tool, binding: MemoryBinding | undefined, snapshot: RunSnapshot, request: ToolRequest): Tool;
178
+ /** Register these objects in tools. Share the SAME objects with helper templates to grant them.
179
+ * Nothing is injected into a helper's allowlist, and no schema accepts a scope. */
180
+ export declare function memoryTools(options?: {
181
+ maxNoteChars?: number;
182
+ needsApproval?: boolean;
183
+ }): Readonly<{
184
+ search: Tool;
185
+ save: Tool;
186
+ forget: Tool;
187
+ }>;
188
+ export declare function readMemoryDeletions(raw: unknown, max?: number): {
189
+ key: string;
190
+ version: string;
191
+ }[];
192
+ /** Validate an explicit ingestion before the store dispatches anything. */
193
+ export declare function readMemoryIngest(request: MemoryIngest): MemoryIngest;
194
+ export declare function isMemoryReceipt(value: unknown): value is MemoryIngestReceipt;
195
+ export type MemoryIngestResult = {
196
+ status: "saved";
197
+ receipt: MemoryIngestReceipt;
198
+ } | {
199
+ status: "refused";
200
+ code: "memory_conflict" | "memory_erased";
201
+ } | {
202
+ status: "unknown";
203
+ code: "memory_ingest_unconfirmed";
204
+ };
205
+ /** Explicit host action, never an observer hook. Pass an authoritative settled outcome and
206
+ * host-selected notes. The store, not this helper's key, enforces the receipt transaction. */
207
+ export declare function ingestMemory(outcome: RunOutcome<unknown>, options: {
208
+ memory: MemoryBinding;
209
+ notes: readonly MemoryInput[];
210
+ signal?: AbortSignal;
211
+ }): Promise<MemoryIngestResult>;
212
+ //# sourceMappingURL=memory.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"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"}