@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,191 @@
1
+ /** Prompt-only typings. The tool's validator, not these declarations, checks each call. */
2
+ export function toolTypings(tools) {
3
+ const declarations = [];
4
+ const methods = [];
5
+ const names = new Set();
6
+ for (const [index, tool] of tools.entries()) {
7
+ if (names.has(tool.name))
8
+ throw new TypeError(`Duplicate tool name: ${tool.name}`);
9
+ names.add(tool.name);
10
+ // Position avoids collisions between names like a-b/a_b, and between input/output $defs.
11
+ const input = `Tool${index + 1}Input`;
12
+ const output = `Tool${index + 1}Output`;
13
+ declarations.push(...schemaDeclarations(tool.inputSchema, input));
14
+ if (tool.outputSchema !== undefined) {
15
+ declarations.push(...schemaDeclarations(tool.outputSchema, output));
16
+ }
17
+ methods.push(` ${comment(tool.description)}\n ${JSON.stringify(tool.name)}(input: ${input}): Promise<${tool.outputSchema === undefined ? "unknown" : output}>;`);
18
+ }
19
+ return [...declarations, `declare const tools: {\n${methods.join("\n")}\n};`].join("\n\n");
20
+ }
21
+ function record(value) {
22
+ return typeof value === "object" && value !== null && !Array.isArray(value);
23
+ }
24
+ function comment(value) {
25
+ return `/** ${value.replaceAll("*/", "* /").replace(/\s+/g, " ")} */`;
26
+ }
27
+ function union(parts) {
28
+ const choices = [...new Set(parts)].filter((part) => part !== "never");
29
+ if (choices.includes("unknown"))
30
+ return "unknown";
31
+ return choices.join(" | ") || "never";
32
+ }
33
+ function intersection(parts) {
34
+ const constraints = new Map(parts.map((part) => [union(part), part]));
35
+ constraints.delete("unknown");
36
+ if (constraints.has("never"))
37
+ return ["never"];
38
+ if (constraints.size < 2)
39
+ return constraints.values().next().value ?? ["unknown"];
40
+ return [[...constraints.keys()].map((part) => `(${part})`).join(" & ")];
41
+ }
42
+ function literal(value, depth = 0) {
43
+ if (depth > 32)
44
+ return "unknown";
45
+ if (value === null)
46
+ return "null";
47
+ if (typeof value === "string" || typeof value === "boolean")
48
+ return JSON.stringify(value);
49
+ if (typeof value === "number" && Number.isFinite(value))
50
+ return String(value);
51
+ if (Array.isArray(value))
52
+ return `[${value.map((item) => literal(item, depth + 1)).join(", ")}]`;
53
+ if (record(value)) {
54
+ return `{ ${Object.entries(value)
55
+ .map(([key, item]) => `${JSON.stringify(key)}: ${literal(item, depth + 1)};`)
56
+ .join(" ")} }`;
57
+ }
58
+ return "unknown";
59
+ }
60
+ function schemaDeclarations(root, name) {
61
+ const aliases = new Map();
62
+ aliases.set("#", { name, type: "unknown" });
63
+ function reference(ref, ancestors, depth) {
64
+ if (ancestors.has(ref))
65
+ return "unknown";
66
+ let target = root;
67
+ if (ref !== "#") {
68
+ if (!ref.startsWith("#/"))
69
+ return "unknown";
70
+ try {
71
+ for (const part of decodeURIComponent(ref.slice(2)).split("/")) {
72
+ const key = part.replaceAll("~1", "/").replaceAll("~0", "~");
73
+ if (!record(target) || !Object.hasOwn(target, key))
74
+ return "unknown";
75
+ target = target[key];
76
+ }
77
+ }
78
+ catch {
79
+ return "unknown";
80
+ }
81
+ }
82
+ const existing = aliases.get(ref);
83
+ if (existing)
84
+ return existing.name;
85
+ const alias = { name: `${name}Ref${aliases.size}`, type: "unknown" };
86
+ aliases.set(ref, alias);
87
+ alias.type = union(render(target, new Set([...ancestors, ref]), depth + 1));
88
+ return alias.name;
89
+ }
90
+ function object(schema, depth) {
91
+ const properties = record(schema.properties) ? schema.properties : {};
92
+ const required = new Set(Array.isArray(schema.required) ? schema.required : []);
93
+ const fields = [];
94
+ const fieldTypes = [];
95
+ for (const [key, value] of Object.entries(properties)) {
96
+ const type = render(value, new Set(), depth + 1);
97
+ fieldTypes.push(...type);
98
+ const description = record(value) && typeof value.description === "string"
99
+ ? `${comment(value.description)} `
100
+ : "";
101
+ fields.push(`${description}${JSON.stringify(key)}${required.has(key) ? "" : "?"}: ${union(type)};`);
102
+ }
103
+ // A required name can exist without a corresponding properties schema.
104
+ for (const key of required) {
105
+ if (typeof key === "string" && !Object.hasOwn(properties, key)) {
106
+ fieldTypes.push("unknown");
107
+ fields.push(`${JSON.stringify(key)}: unknown;`);
108
+ }
109
+ }
110
+ const additional = schema.additionalProperties;
111
+ if (additional === false) {
112
+ return fields.length ? `{ ${fields.join(" ")} }` : "Record<string, never>";
113
+ }
114
+ const value = render(additional, new Set(), depth + 1);
115
+ if (!fields.length)
116
+ return `Record<string, ${union(value)}>`;
117
+ // TS cannot exclude named fields from a string index. Widen only that index,
118
+ // preserving each declared field instead of producing an impossible intersection.
119
+ return `{ ${fields.join(" ")} } & Record<string, ${union([...value, ...fieldTypes])}>`;
120
+ }
121
+ function array(schema, depth) {
122
+ const prefix = Array.isArray(schema.prefixItems) ? schema.prefixItems : schema.items;
123
+ if (!Array.isArray(prefix))
124
+ return `Array<${union(render(schema.items, new Set(), depth + 1))}>`;
125
+ const minimum = typeof schema.minItems === "number" ? schema.minItems : 0;
126
+ const tail = Array.isArray(schema.items) ? schema.additionalItems : schema.items;
127
+ const fields = prefix.map((item, index) => {
128
+ const type = union(render(item, new Set(), depth + 1));
129
+ return index < minimum ? type : `(${type})?`;
130
+ });
131
+ if (tail !== false)
132
+ fields.push(`...Array<${union(render(tail, new Set(), depth + 1))}>`);
133
+ return `[${fields.join(", ")}]`;
134
+ }
135
+ function typed(type, schema, depth) {
136
+ switch (type) {
137
+ case "string":
138
+ return "string";
139
+ case "number":
140
+ case "integer":
141
+ return "number";
142
+ case "boolean":
143
+ return "boolean";
144
+ case "null":
145
+ return "null";
146
+ case "object":
147
+ return object(schema, depth);
148
+ case "array":
149
+ return array(schema, depth);
150
+ default:
151
+ return "unknown";
152
+ }
153
+ }
154
+ function render(schema, ancestors, depth) {
155
+ if (schema === false)
156
+ return ["never"];
157
+ // ponytail: unsupported constraints and deeply nested schemas become unknown.
158
+ // This is model guidance, not a second JSON Schema validator.
159
+ if (!record(schema) || depth > 64)
160
+ return ["unknown"];
161
+ const parts = [];
162
+ if (typeof schema.$ref === "string")
163
+ parts.push([reference(schema.$ref, ancestors, depth)]);
164
+ if (Object.hasOwn(schema, "const"))
165
+ parts.push([literal(schema.const)]);
166
+ else if (Array.isArray(schema.enum))
167
+ parts.push(schema.enum.map((item) => literal(item)));
168
+ else if (Array.isArray(schema.type)) {
169
+ parts.push(schema.type.map((type) => typed(type, schema, depth)));
170
+ }
171
+ else if (schema.type !== undefined)
172
+ parts.push([typed(schema.type, schema, depth)]);
173
+ else if (schema.properties !== undefined || schema.additionalProperties !== undefined) {
174
+ parts.push([object(schema, depth)]);
175
+ }
176
+ else if (schema.items !== undefined || schema.prefixItems !== undefined)
177
+ parts.push([array(schema, depth)]);
178
+ for (const key of ["anyOf", "oneOf"]) {
179
+ const choices = schema[key];
180
+ if (Array.isArray(choices))
181
+ parts.push(choices.flatMap((item) => render(item, ancestors, depth + 1)));
182
+ }
183
+ if (Array.isArray(schema.allOf)) {
184
+ parts.push(...schema.allOf.map((item) => render(item, ancestors, depth + 1)));
185
+ }
186
+ return intersection(parts);
187
+ }
188
+ aliases.get("#").type = union(render(root, new Set(["#"]), 0));
189
+ return [...aliases.values()].map((alias) => `type ${alias.name} = ${alias.type};`);
190
+ }
191
+ //# sourceMappingURL=schema-to-ts.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema-to-ts.js","sourceRoot":"","sources":["../src/schema-to-ts.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,23 @@
1
+ import type { AgentMessage, Session } from "./types.ts";
2
+ /** The session changed after the run loaded it, or this run id already appended another turn.
3
+ * Load the conversation again before continuing it. */
4
+ export declare class SessionConflictError extends Error {
5
+ readonly sessionId: string;
6
+ constructor(sessionId: string);
7
+ }
8
+ /**
9
+ * A session kept in this process, for tests, examples and single-process tools. It copies on
10
+ * every read and write, so changing what it returned or what you appended never changes what
11
+ * it holds. Everything is lost when the process ends.
12
+ */
13
+ export declare function createMemorySession(options?: {
14
+ id?: string;
15
+ messages?: readonly AgentMessage[];
16
+ }): Session;
17
+ /**
18
+ * Check a session store against the contract the run relies on, by writing to fresh sessions
19
+ * from `create`. Each call to `create` must return a new, empty session. Throws an Error that
20
+ * names the first rule the store breaks. Run it against a test database, never a real one.
21
+ */
22
+ export declare function checkSession(create: () => Session | Promise<Session>): Promise<void>;
23
+ //# sourceMappingURL=session.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAe,MAAM,YAAY,CAAC;AAErE;uDACuD;AACvD,qBAAa,oBAAqB,SAAQ,KAAK;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM;IAAtC,YAAqB,SAAS,EAAE,MAAM,EAKrC;CACF;AAaD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,GAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,SAAS,YAAY,EAAE,CAAA;CAAO,GAChE,OAAO,CAiCT;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAiG1F"}
@@ -0,0 +1,137 @@
1
+ // A conversation store the run reads once and appends to once.
2
+ //
3
+ // Load happens before the run is saved, so the history is frozen in the snapshot. The append
4
+ // happens after the run settles, keyed by its run id, so a resumed or retried run writes its
5
+ // turn once. A revision check keeps a run from appending over turns that landed after it
6
+ // loaded: a full replace would let the last writer erase them.
7
+ import { messageOf } from "@providerkit/core";
8
+ import { copyData, equalData, isId, isRecord, isRevision } from "./snapshot.js";
9
+ import { readStored } from "./input.js";
10
+ /** The session changed after the run loaded it, or this run id already appended another turn.
11
+ * Load the conversation again before continuing it. */
12
+ export class SessionConflictError extends Error {
13
+ sessionId;
14
+ constructor(sessionId) {
15
+ super(`Conversation ${sessionId} changed after this run loaded it. Load it again before you add to it.`);
16
+ this.sessionId = sessionId;
17
+ this.name = "SessionConflictError";
18
+ }
19
+ }
20
+ function readTurn(value) {
21
+ if (!isRecord(value) || !isId(value.runId) || !isRevision(value.after))
22
+ throw new TypeError("A session turn needs a runId, the revision it follows and its messages.");
23
+ return { runId: value.runId, after: value.after, messages: readStored(value.messages, "A turn") };
24
+ }
25
+ // The duplicate and conflict rule is ported from OpenAI Agents JS (MIT),
26
+ // packages/agents-core/src/memory/memorySession.ts: an id that already applied the same change
27
+ // succeeds without applying it again, and the same id with another change fails. The revision
28
+ // check and the copies on every read and write follow PydanticAI's (MIT) InMemoryConversationStore,
29
+ // pydantic_ai_slim/pydantic_ai/conversation_store.py.
30
+ /**
31
+ * A session kept in this process, for tests, examples and single-process tools. It copies on
32
+ * every read and write, so changing what it returned or what you appended never changes what
33
+ * it holds. Everything is lost when the process ends.
34
+ */
35
+ export function createMemorySession(options = {}) {
36
+ const id = options.id ?? crypto.randomUUID();
37
+ if (!isId(id))
38
+ throw new TypeError("A session id must be non-empty text.");
39
+ let messages = readStored(options.messages ?? [], "The starting messages");
40
+ let count = messages.length > 0 ? 1 : 0;
41
+ let revision = count > 0 ? String(count) : null;
42
+ const turns = new Map();
43
+ return Object.freeze({
44
+ id,
45
+ async load({ limit, signal }) {
46
+ signal.throwIfAborted();
47
+ if (limit !== undefined && (!Number.isSafeInteger(limit) || limit < 0))
48
+ throw new TypeError("limit must be a whole number, 0 or more.");
49
+ let window = messages;
50
+ if (limit !== undefined)
51
+ window = limit === 0 ? [] : messages.slice(-limit);
52
+ return { messages: copyData(window), revision };
53
+ },
54
+ async append(raw, { signal }) {
55
+ signal.throwIfAborted();
56
+ const turn = readTurn(raw);
57
+ const applied = turns.get(turn.runId);
58
+ if (applied) {
59
+ if (!equalData(applied.turn, turn))
60
+ throw new SessionConflictError(id);
61
+ return { revision: applied.revision };
62
+ }
63
+ if (turn.after !== revision)
64
+ throw new SessionConflictError(id);
65
+ messages = [...messages, ...turn.messages];
66
+ count++;
67
+ revision = String(count);
68
+ turns.set(turn.runId, { turn, revision });
69
+ return { revision };
70
+ },
71
+ });
72
+ }
73
+ /**
74
+ * Check a session store against the contract the run relies on, by writing to fresh sessions
75
+ * from `create`. Each call to `create` must return a new, empty session. Throws an Error that
76
+ * names the first rule the store breaks. Run it against a test database, never a real one.
77
+ */
78
+ export async function checkSession(create) {
79
+ const signal = new AbortController().signal;
80
+ function expect(ok, rule) {
81
+ if (!ok)
82
+ throw new Error(`The session store breaks a rule: ${rule}`);
83
+ }
84
+ /** A step that must succeed. If it throws, name the rule, with the store's error as cause. */
85
+ async function must(work, rule) {
86
+ try {
87
+ return await work();
88
+ }
89
+ catch (error) {
90
+ throw new Error(`The session store breaks a rule: ${rule} It threw: ${messageOf(error)}`, {
91
+ cause: error,
92
+ });
93
+ }
94
+ }
95
+ async function conflicts(work) {
96
+ try {
97
+ await work;
98
+ return false;
99
+ }
100
+ catch (error) {
101
+ return error instanceof Error && error.name === "SessionConflictError";
102
+ }
103
+ }
104
+ const first = [
105
+ { role: "user", content: "First question" },
106
+ { role: "assistant", content: "First answer" },
107
+ ];
108
+ const second = [
109
+ { role: "user", content: "Second question" },
110
+ { role: "assistant", content: "Second answer" },
111
+ ];
112
+ const session = await create();
113
+ expect(isId(session.id), "a session has a non-empty id.");
114
+ const empty = await must(() => session.load({ signal }), "a new session loads.");
115
+ expect(empty.messages.length === 0 && empty.revision === null, "a new session loads no messages and a null revision.");
116
+ const turn = { runId: "run-1", after: null, messages: copyData(first) };
117
+ const saved = await must(() => session.append(turn, { signal }), "the first append to a new session, after null, succeeds.");
118
+ expect(isId(saved.revision), "append returns the new revision as non-empty text.");
119
+ turn.messages[0] = { role: "user", content: "Changed after append" };
120
+ const loaded = await session.load({ signal });
121
+ expect(equalData(loaded.messages, first) && loaded.revision === saved.revision, "load returns what was appended, oldest first, with the revision append returned, and changing the appended array afterwards changes nothing stored.");
122
+ loaded.messages.pop();
123
+ expect(equalData((await session.load({ signal })).messages, first), "changing a loaded array changes nothing stored.");
124
+ const repeated = await must(() => session.append({ runId: "run-1", after: null, messages: copyData(first) }, { signal }), "repeating the same turn succeeds and writes nothing.");
125
+ expect(isId(repeated.revision) && equalData((await session.load({ signal })).messages, first), "repeating the same turn succeeds and writes nothing.");
126
+ expect(await conflicts(session.append({ runId: "run-1", after: null, messages: copyData(second) }, { signal })), "the same runId with other messages throws SessionConflictError.");
127
+ expect(await conflicts(session.append({ runId: "run-2", after: null, messages: copyData(second) }, { signal })), "a stale revision throws SessionConflictError.");
128
+ expect(equalData((await session.load({ signal })).messages, first), "a refused append writes nothing.");
129
+ await must(() => session.append({ runId: "run-2", after: saved.revision, messages: copyData(second) }, {
130
+ signal,
131
+ }), "an append after the current revision succeeds.");
132
+ const window = await must(() => session.load({ limit: 3, signal }), "load takes a limit.");
133
+ expect(equalData(window.messages, [...first.slice(1), ...second]), "load({ limit }) returns the newest messages, oldest first.");
134
+ const other = await create();
135
+ expect(other.id !== session.id, "create returns a new session each time.");
136
+ }
137
+ //# sourceMappingURL=session.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"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"}
@@ -1,5 +1,7 @@
1
- import { type TokenUsage, type Turn } from "@providerkit/core";
2
- import type { ApprovalScope, RunLimits, RunOptions, RunSnapshot, TreeLimits } from "./types.ts";
1
+ import { type CodeTool } from "./code.ts";
2
+ import type { TreeNode, WorkflowSnapshot } from "./types.ts";
3
+ import { type FileMimeType, type ImageMimeType, type TokenUsage, type Turn } from "@providerkit/core";
4
+ import type { AgentMessage, RequestScope, AskRecord, InputPart, ModelExecution, ModelSettings, RecordedModelSettings, RecordedCodeTool, RunLimits, RunOptions, RunSnapshot, RunState, Session, SessionStatus, TreeLimits, UserContent } from "./types.ts";
3
5
  export declare function isRecord(value: unknown): value is Record<string, unknown>;
4
6
  export declare function isId(value: unknown): value is string;
5
7
  export declare function copyData<T>(value: T): T;
@@ -8,19 +10,66 @@ export declare function immutableCopy<T>(value: T): T;
8
10
  /** Object key order can change when a host stores JSON; array order cannot. */
9
11
  export declare function equalData(left: unknown, right: unknown): boolean;
10
12
  export declare function readLimits(value?: unknown): RunLimits;
13
+ export declare function isImageMime(value: unknown): value is ImageMimeType;
14
+ /** Core's file types, with an RFC 6838 subtype and no parameters, so the value a provider
15
+ * receives is the plain media type it documents. */
16
+ export declare function isFileMime(value: unknown): value is FileMimeType;
17
+ export declare function isBase64(value: unknown): value is string;
18
+ /** Decoded bytes of every inline image and file: user parts and tool images alike. */
19
+ export declare function inlineBytes(history: readonly AgentMessage[], input: UserContent): number;
20
+ /** All retained inline media, including results of a partially settled tool batch. */
21
+ export declare function snapshotInlineBytes(snapshot: RunSnapshot): number;
22
+ export declare function isPart(value: unknown): value is InputPart;
23
+ /** A frozen new turn: non-empty text, or at least one part. */
24
+ export declare function isTurnContent(value: unknown): value is UserContent;
25
+ /** Shape only. Who may send which message is the input normalizer's rule, not this one. */
26
+ export declare function isAgentMessage(value: unknown): value is AgentMessage;
27
+ export declare function isRevision(value: unknown): value is string | null;
28
+ export declare function isSessionStatus(value: unknown): value is SessionStatus;
29
+ export declare function isSession(value: unknown): value is Session;
11
30
  export declare function readTreeLimits(value?: unknown): TreeLimits;
12
- export declare function checkOptions(value: unknown): asserts value is RunOptions;
13
- export declare function isScope(value: unknown): value is ApprovalScope;
31
+ export declare function isNames(value: unknown): value is string[];
32
+ export declare function isEnabledTools(value: unknown): boolean;
33
+ export declare function isRecordedModelSettings(value: unknown): value is RecordedModelSettings;
34
+ export declare function readModelSettings(value?: unknown): ModelSettings;
35
+ /** Record only validation data. Reading an archive must not construct executable tools. */
36
+ export declare function recordCodeTools(tools: ReadonlyMap<string, CodeTool>): Record<string, RecordedCodeTool>;
37
+ export declare function checkOptions(value: unknown, use?: "run" | "resume"): asserts value is RunOptions;
38
+ export declare function isScope(value: unknown): value is RequestScope;
39
+ /** Code and guest inputs are exact JSON, not prose whose escapes may be repaired. */
40
+ export declare function jsonArguments(raw: string): Record<string, unknown> | undefined;
14
41
  export declare function completeArguments(raw: string): boolean;
42
+ export declare function isAskRecord(value: unknown): value is AskRecord;
15
43
  export declare function isUsage(value: unknown): value is TokenUsage;
16
44
  export declare function readTurn(value: unknown): Turn;
45
+ export declare function isState(value: unknown): value is RunState;
46
+ export declare function isTreeInfo(value: unknown): value is RunSnapshot["tree"];
47
+ export declare function isTreeNode(value: unknown): value is TreeNode;
48
+ export declare function agentSnapshot(node: TreeNode): RunSnapshot;
49
+ export declare function readWorkflowSnapshot(raw: unknown): WorkflowSnapshot;
17
50
  export declare function modelId(runId: string, index: number): string;
18
51
  export declare function toolId(model: string, index: number): string;
19
52
  export declare function childRunId(operationId: string, key: string): string;
20
53
  /** Check global reservations from saved local journals, including work not yet sent. */
21
- export declare function checkTree(root: RunSnapshot): void;
54
+ export declare function checkTree(root: TreeNode): void;
22
55
  /** A host cache may fill a missing receipt, never erase or replace a known effect. */
23
- export declare function checkChildProgress(previous: RunSnapshot, next: RunSnapshot): void;
24
- /** Validate the journal as well as its fields, so a cursor cannot skip unrecorded work. */
25
- export declare function readSnapshot(raw: unknown, agentId: string, version: string, limits: RunLimits, resultTool?: string): RunSnapshot;
56
+ export declare function checkChildProgress(previous: TreeNode, next: TreeNode): void;
57
+ /** The selected result is journal data, not a second invocation of the tool. Model order
58
+ * wins even when a later tool in a parallel batch finishes first. */
59
+ export declare function finalToolResult(model: Extract<ModelExecution, {
60
+ status: "completed";
61
+ }>, stopAtTools: readonly string[], resultTool?: string): {
62
+ candidate: unknown;
63
+ } | undefined;
64
+ /** A successful handoff keeps the target's raw candidate, not its transformed output. The
65
+ * target runtime owns validation, even when the source has a different output contract. */
66
+ export declare function finalHandoffResult(snapshot: RunSnapshot, model: Extract<ModelExecution, {
67
+ status: "completed";
68
+ }>): {
69
+ candidate: unknown;
70
+ child: RunSnapshot;
71
+ } | undefined;
72
+ /** Validate data-only journals without live tools. Execution callers supply their actual code
73
+ * registry, which must match the saved policy. Recorded data never replaces host authorization. */
74
+ export declare function readSnapshot(raw: unknown, agentId: string, version: string, limits: RunLimits, resultTool?: string, codeTools?: ReadonlyMap<string, CodeTool>): RunSnapshot;
26
75
  //# sourceMappingURL=snapshot.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../src/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,UAAU,EAAiB,KAAK,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC7F,OAAO,KAAK,EACV,aAAa,EAKb,SAAS,EACT,UAAU,EACV,WAAW,EAKX,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,wBAAgB,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEpD;AA4BD,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAKvC;AAED,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAS5C;AAED,+EAA+E;AAC/E,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAUhE;AAED,wBAAgB,UAAU,CAAC,KAAK,GAAE,OAAY,GAAG,SAAS,CAczD;AAaD,wBAAgB,cAAc,CAAC,KAAK,GAAE,OAAY,GAAG,UAAU,CAY9D;AAuBD,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,UAAU,CA2BxE;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAS9D;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAMtD;AAyBD,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAU3D;AAyBD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAO7C;AAyGD,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,wFAAwF;AACxF,wBAAgB,SAAS,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAqDjD;AAED,sFAAsF;AACtF,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAiDjF;AAED,2FAA2F;AAC3F,wBAAgB,YAAY,CAC1B,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,SAAS,EACjB,UAAU,CAAC,EAAE,MAAM,GAClB,WAAW,CAyIb"}
1
+ {"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../src/snapshot.ts"],"names":[],"mappings":"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"}