@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
package/dist/input.js ADDED
@@ -0,0 +1,266 @@
1
+ // A run's input: checked and normalized once, before anything is saved, loaded or sent.
2
+ //
3
+ // Every entry point (run, a background start, a specialist child) turns what it was given into
4
+ // the same frozen pair, the history and the new user turn, and the snapshot keeps that pair
5
+ // for the run's whole life. Nothing here re-reads a session or rebuilds a history later: one
6
+ // earlier byte that changes between requests re-bills the provider's whole prompt cache.
7
+ import { repairHistory, } from "@providerkit/core";
8
+ import { copyData, isAgentMessage, isFileMime, isId, isImageMime, isPart, isRecord, } from "./snapshot.js";
9
+ function partProblem(part) {
10
+ if (!isRecord(part))
11
+ return "A content part must be an object with a type.";
12
+ switch (part.type) {
13
+ case "text":
14
+ return "A text part needs its text as a string.";
15
+ case "image":
16
+ return isImageMime(part.mimeType)
17
+ ? "An image needs its bytes as base64 text, padded with = to a multiple of 4."
18
+ : "An image must be image/jpeg, image/png, image/webp or image/gif. Send other files as a file part.";
19
+ case "file":
20
+ return isFileMime(part.mimeType)
21
+ ? "A file needs its bytes as base64 text, padded with = to a multiple of 4."
22
+ : "A file needs an application/, audio/, video/ or text/ media type, with no parameters.";
23
+ case "media":
24
+ return isId(part.id)
25
+ ? "A media reference needs an image type (JPEG, PNG, WebP or GIF) or an application/, audio/, video/ or text/ type."
26
+ : "A media reference needs the id your host stores its bytes under.";
27
+ default:
28
+ return "Use text, image, file or media content parts.";
29
+ }
30
+ }
31
+ // Use the same field allow-list on input and on browser output. Trusted stores may attach
32
+ // server-only upload metadata to otherwise valid parts.
33
+ function clientPart(part) {
34
+ switch (part.type) {
35
+ case "text":
36
+ return { type: "text", text: part.text };
37
+ case "media":
38
+ return { type: "media", id: part.id, mimeType: part.mimeType };
39
+ case "image":
40
+ return { type: "image", mimeType: part.mimeType, data: part.data };
41
+ case "file":
42
+ return { type: "file", mimeType: part.mimeType, data: part.data };
43
+ }
44
+ }
45
+ /** A user turn with each part rebuilt from the fields core reads. A blank text part is
46
+ * dropped: providers refuse an empty text block, and a composer often sends one beside an
47
+ * attachment. Nothing left is an error. */
48
+ export function readContent(value, what) {
49
+ const empty = `${what} needs some text, an image or a file.`;
50
+ if (typeof value === "string") {
51
+ if (!value.trim())
52
+ throw new TypeError(empty);
53
+ return value;
54
+ }
55
+ if (!Array.isArray(value))
56
+ throw new TypeError(`${what} must be text or an array of content parts.`);
57
+ const parts = [];
58
+ for (const part of value) {
59
+ if (!isPart(part))
60
+ throw new TypeError(partProblem(part));
61
+ if (part.type !== "text" || part.text.trim())
62
+ parts.push(clientPart(part));
63
+ }
64
+ if (parts.length === 0)
65
+ throw new TypeError(empty);
66
+ return parts;
67
+ }
68
+ function readMessage(value, trust) {
69
+ if (!isRecord(value))
70
+ throw new TypeError("Each message must be an object with a role.");
71
+ if (value.role === "system")
72
+ throw new TypeError("A conversation cannot carry a system message. The agent's instructions are its system prompt.");
73
+ if (value.role === "user")
74
+ return { role: "user", content: readContent(value.content, "A user message") };
75
+ if (!isAgentMessage(value))
76
+ throw new TypeError(value.role === "assistant"
77
+ ? "An assistant message needs text content, and tool calls with an id, a name and arguments."
78
+ : value.role === "tool"
79
+ ? "A tool message needs the toolCallId and name of the call it answers, and text content."
80
+ : "A message role must be user, assistant or tool.");
81
+ return trust === "trusted" ? copyData(value) : clientCopy(value);
82
+ }
83
+ /** A tool result in a caller's history must answer an open call of the assistant message before
84
+ * it, the pairing core's repairHistory keeps. Client tool results and approvals never enter
85
+ * through the history, so a result with no call is refused rather than turned into a note. */
86
+ function checkRounds(history) {
87
+ let open = [];
88
+ for (const message of history) {
89
+ if (message.role === "assistant") {
90
+ // repairHistory drops a blank message with no calls, so it does not close a round.
91
+ if (!message.toolCalls?.length && !message.content.trim())
92
+ continue;
93
+ open = (message.toolCalls ?? []).map((call) => call.id);
94
+ }
95
+ else if (message.role === "tool") {
96
+ const index = open.indexOf(message.toolCallId);
97
+ if (index === -1)
98
+ throw new TypeError("A tool result in the history must answer a call from the assistant message before it.");
99
+ open.splice(index, 1);
100
+ }
101
+ }
102
+ }
103
+ /** Turn an AgentInput into the history and the new turn. Throws a TypeError for anything a run
104
+ * cannot use, before any snapshot, checkpoint or session call. */
105
+ export function readInput(input, trust) {
106
+ if (typeof input === "string" || Array.isArray(input))
107
+ return { history: [], input: readContent(input, "The new turn") };
108
+ if (!isRecord(input) ||
109
+ !Array.isArray(input.messages) ||
110
+ Object.keys(input).some((key) => key !== "messages"))
111
+ throw new TypeError("Give the agent text, content parts or { messages }.");
112
+ const messages = input.messages.map((message) => readMessage(message, trust));
113
+ const last = messages.pop();
114
+ if (!last)
115
+ throw new TypeError("Pass at least one message: the new user turn.");
116
+ if (last.role !== "user")
117
+ throw new TypeError("The last message must be the new user turn. Tool results and approvals never enter through the history.");
118
+ checkRounds(messages);
119
+ return { history: messages, input: last.content };
120
+ }
121
+ /** Trusted history from a session or prepareHistory, kept as it is: shape checked, system
122
+ * refused. A window may start inside a tool round; repair at creation handles that. */
123
+ export function readStored(value, source) {
124
+ if (!Array.isArray(value))
125
+ throw new TypeError(`${source} must give an array of messages.`);
126
+ if (value.some((message) => isRecord(message) && message.role === "system"))
127
+ throw new TypeError(`${source} gave a system message. A conversation never carries one: the agent's instructions are its system prompt.`);
128
+ if (!value.every(isAgentMessage))
129
+ throw new TypeError(`${source} gave a message that is not a user, assistant or tool message.`);
130
+ return copyData(value);
131
+ }
132
+ /** A message rebuilt from the fields a model reads, so provider-owned fields and anything
133
+ * unknown stay behind. */
134
+ function clientCopy(message) {
135
+ if (message.role === "user")
136
+ return {
137
+ role: "user",
138
+ content: typeof message.content === "string" ? message.content : message.content.map(clientPart),
139
+ };
140
+ if (message.role === "tool")
141
+ return {
142
+ role: "tool",
143
+ toolCallId: message.toolCallId,
144
+ name: message.name,
145
+ content: message.content,
146
+ ...(message.images
147
+ ? { images: message.images.map(({ type, mimeType, data }) => ({ type, mimeType, data })) }
148
+ : {}),
149
+ };
150
+ const calls = message.toolCalls?.map((call) => ({
151
+ id: call.id,
152
+ name: call.name,
153
+ arguments: call.arguments,
154
+ }));
155
+ return {
156
+ role: "assistant",
157
+ content: message.content,
158
+ ...(message.reasoning !== undefined ? { reasoning: message.reasoning } : {}),
159
+ ...(calls ? { toolCalls: calls } : {}),
160
+ };
161
+ }
162
+ /**
163
+ * Copies of the messages without the fields a provider owns: `reasoningDetails`,
164
+ * `reasoningItems` and each call's `thoughtSignature`. Use it before history reaches a
165
+ * browser. Reasoning text and tool rounds stay: DeepSeek needs the reasoning of a tool-call
166
+ * turn sent back. The run applies the same rule to history a caller passes in, because a
167
+ * browser could forge those fields.
168
+ */
169
+ export function toClientMessages(messages) {
170
+ return messages.map(clientCopy);
171
+ }
172
+ /**
173
+ * Core's repairHistory, run once when a run is created. Core types a user message without
174
+ * media references, so each user message crosses as a stand-in and comes back as itself:
175
+ * repair moves user messages, it never reads or rewrites them. Its orphan-result notes are
176
+ * new user messages with core content, which an AgentMessage can hold as they are.
177
+ */
178
+ export function repairConversation(history, isReadOnly) {
179
+ const users = new Map();
180
+ const wire = history.map((message) => {
181
+ if (message.role !== "user")
182
+ return message;
183
+ const stand = { role: "user", content: "" };
184
+ users.set(stand, message);
185
+ return stand;
186
+ });
187
+ return repairHistory(wire, { isReadOnly }).messages.map((message) => {
188
+ const user = users.get(message);
189
+ if (user)
190
+ return user;
191
+ if (message.role === "system")
192
+ throw new TypeError("History repair returned a system message.");
193
+ return message;
194
+ });
195
+ }
196
+ /** The history, the new turn and whole settled rounds. Never half a tool round: the journal
197
+ * keeps unfinished work, and a provider refuses a call without its result. */
198
+ export function conversationOf(snapshot, beforeModel = snapshot.models.length) {
199
+ const messages = [...snapshot.history, { role: "user", content: snapshot.input }];
200
+ for (let position = 0; position <= beforeModel; position++) {
201
+ // Steering joins only between whole rounds. Its saved position survives attempts and
202
+ // preserves the exact prefix even when the host later offers more input.
203
+ for (const input of snapshot.inputs)
204
+ if (input.beforeModel === position)
205
+ messages.push({ role: "user", content: input.content });
206
+ const model = position < beforeModel ? snapshot.models[position] : undefined;
207
+ if (!model ||
208
+ model.status !== "completed" ||
209
+ model.tools.some((tool) => tool.status !== "completed"))
210
+ break;
211
+ messages.push(model.turn.message);
212
+ for (const [index, tool] of model.tools.entries()) {
213
+ const call = model.turn.message.toolCalls?.[index];
214
+ if (call && tool.status === "completed") {
215
+ messages.push({
216
+ role: "tool",
217
+ toolCallId: call.id,
218
+ name: call.name,
219
+ content: tool.result.content,
220
+ ...(tool.result.ok && tool.result.images ? { images: tool.result.images } : {}),
221
+ });
222
+ }
223
+ }
224
+ }
225
+ return copyData(messages);
226
+ }
227
+ /** A saved run's frozen input in the form child() takes, to admit it again unchanged. */
228
+ export function inputOf(snapshot) {
229
+ return snapshot.history.length === 0
230
+ ? snapshot.input
231
+ : { messages: [...snapshot.history, { role: "user", content: snapshot.input }] };
232
+ }
233
+ // Ported from TanStack AI (MIT), packages/ai-harness/src/media.ts: the transcript keeps the
234
+ // reference and only the provider request gets the bytes. Ours fails on a missing file
235
+ // instead of sending a note in its place, so the model never answers about a file it did not
236
+ // see.
237
+ /** The provider request: the system prompt, then the conversation with each media reference
238
+ * swapped for its bytes. Only this copy ever holds them. */
239
+ export async function requestOf(instructions, conversation, load) {
240
+ const request = [{ role: "system", content: instructions }];
241
+ for (const message of conversation) {
242
+ if (message.role !== "user") {
243
+ request.push(message);
244
+ continue;
245
+ }
246
+ if (typeof message.content === "string") {
247
+ request.push({ role: "user", content: message.content });
248
+ continue;
249
+ }
250
+ const content = [];
251
+ for (const part of message.content) {
252
+ if (part.type !== "media") {
253
+ content.push(part);
254
+ continue;
255
+ }
256
+ const data = await load(part);
257
+ const mimeType = part.mimeType;
258
+ content.push(isImageMime(mimeType)
259
+ ? { type: "image", mimeType, data }
260
+ : { type: "file", mimeType, data });
261
+ }
262
+ request.push({ role: "user", content });
263
+ }
264
+ return request;
265
+ }
266
+ //# sourceMappingURL=input.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"input.js","sourceRoot":"","sources":["../src/input.ts"],"names":[],"mappings":"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"}
package/dist/mcp.d.ts ADDED
@@ -0,0 +1,77 @@
1
+ import { type JsonObjectSchema, type Tool } from "@providerkit/core";
2
+ /** One tool as its server described it. `listMcpTools` returns these: save them in the app. */
3
+ export interface McpToolRecord {
4
+ /** The tool's name on the server. */
5
+ name: string;
6
+ description?: string;
7
+ inputSchema: JsonObjectSchema;
8
+ /** Only `readOnlyHint` is read. A tool without it is treated as one that can change data. */
9
+ annotations?: {
10
+ readOnlyHint?: boolean;
11
+ };
12
+ }
13
+ /** Where the server is. Streamable HTTP only. */
14
+ export interface McpServerOptions {
15
+ /** The server's Streamable HTTP endpoint, such as `https://docs.example.com/mcp`. */
16
+ url: string;
17
+ /**
18
+ * Sent as `Authorization: Bearer <key>`, with surrounding spaces removed before sending and
19
+ * redacting. Tool metadata containing the key is refused.
20
+ */
21
+ key?: string;
22
+ /** Replaces the global fetch: a proxy, a service binding, a test. */
23
+ fetch?: (url: string | URL, init?: RequestInit) => Promise<Response>;
24
+ /** How long one call may take, connecting included, in ms. Default 60000. */
25
+ timeoutMs?: number;
26
+ }
27
+ /** What the app decides about one allowed tool. */
28
+ export interface McpToolPolicy {
29
+ /** What the model reads instead of the recorded description. */
30
+ description?: string;
31
+ /**
32
+ * Arguments the app fixes. They leave the schema the model sees and are always sent; a model
33
+ * that sends one anyway gets the call refused as invalid input.
34
+ */
35
+ pin?: Record<string, unknown>;
36
+ /**
37
+ * Ask a person before each call. A tool the server does not mark read-only must set this:
38
+ * true to ask, or false to let it run without asking.
39
+ */
40
+ needsApproval?: boolean;
41
+ /**
42
+ * Treat a tool its server marks read-only as one that can change data. There is no `true`:
43
+ * only the server's `readOnlyHint` makes a tool read-only.
44
+ */
45
+ readOnly?: false;
46
+ /** Replaces the server-wide `timeoutMs` for this tool. */
47
+ timeoutMs?: number;
48
+ }
49
+ export interface McpToolsOptions extends McpServerOptions {
50
+ /** The server's tools as `listMcpTools` returned them. */
51
+ recorded: readonly McpToolRecord[];
52
+ /** The tools the model may call, by their name on the server. No other tool reaches it. */
53
+ allow: Readonly<Record<string, McpToolPolicy>>;
54
+ /** Goes before every name with `_`: prefix "docs" turns "search" into "docs_search". */
55
+ prefix?: string;
56
+ /** Rewrites server text before the model reads it, for example to fence it as untrusted data. */
57
+ wrap?: (text: string, tool: string) => string;
58
+ }
59
+ export interface McpTools {
60
+ /** Core tools for `defineAgent`, in the order of `allow`. */
61
+ readonly tools: readonly Tool[];
62
+ /** Ends every open session. A later call connects again. */
63
+ close(): Promise<void>;
64
+ }
65
+ /**
66
+ * Lists a server's tools once, so a developer can save them in the app and pass them to
67
+ * `mcpTools` as `recorded`. Run it when you add a server or want to take its changes.
68
+ */
69
+ export declare function listMcpTools(options: McpServerOptions & {
70
+ signal?: AbortSignal;
71
+ }): Promise<McpToolRecord[]>;
72
+ /**
73
+ * Core tools for the tools an app allows on one MCP server. Building them does no I/O; the first
74
+ * call connects, and a call after a failure or `close()` connects again.
75
+ */
76
+ export declare function mcpTools(options: McpToolsOptions): McpTools;
77
+ //# sourceMappingURL=mcp.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAsBA,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,IAAI,EAEV,MAAM,mBAAmB,CAAC;AAE3B,+FAA+F;AAC/F,MAAM,WAAW,aAAa;IAC5B,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,gBAAgB,CAAC;IAC9B,6FAA6F;IAC7F,WAAW,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC1C;AAED,iDAAiD;AACjD,MAAM,WAAW,gBAAgB;IAC/B,qFAAqF;IACrF,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrE,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,mDAAmD;AACnD,MAAM,WAAW,aAAa;IAC5B,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC;IACjB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;IACvD,0DAA0D;IAC1D,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;IACnC,2FAA2F;IAC3F,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;IAC/C,wFAAwF;IACxF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iGAAiG;IACjG,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CAC/C;AAED,MAAM,WAAW,QAAQ;IACvB,6DAA6D;IAC7D,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;IAChC,4DAA4D;IAC5D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AA0XD;;;GAGG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,gBAAgB,GAAG;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,GACnD,OAAO,CAAC,aAAa,EAAE,CAAC,CA6B1B;AAOD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,QAAQ,CA2K3D"}