@providerkit/core 0.29.1 → 0.31.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 (163) hide show
  1. package/README.md +58 -9
  2. package/THIRD_PARTY_NOTICES +144 -0
  3. package/dist/auth/chatgpt-models.js.map +1 -1
  4. package/dist/auth/oauth.d.ts.map +1 -1
  5. package/dist/auth/oauth.js.map +1 -1
  6. package/dist/capability.js.map +1 -1
  7. package/dist/context.d.ts +4 -3
  8. package/dist/context.d.ts.map +1 -1
  9. package/dist/context.js +19 -5
  10. package/dist/context.js.map +1 -1
  11. package/dist/decisions.js.map +1 -1
  12. package/dist/errors.d.ts.map +1 -1
  13. package/dist/errors.js +29 -2
  14. package/dist/errors.js.map +1 -1
  15. package/dist/fallback.d.ts +3 -0
  16. package/dist/fallback.d.ts.map +1 -1
  17. package/dist/fallback.js +9 -5
  18. package/dist/fallback.js.map +1 -1
  19. package/dist/gate.js.map +1 -1
  20. package/dist/hosted/anthropic.d.ts +30 -0
  21. package/dist/hosted/anthropic.d.ts.map +1 -0
  22. package/dist/hosted/anthropic.js +465 -0
  23. package/dist/hosted/anthropic.js.map +1 -0
  24. package/dist/hosted/gemini.d.ts +22 -0
  25. package/dist/hosted/gemini.d.ts.map +1 -0
  26. package/dist/hosted/gemini.js +440 -0
  27. package/dist/hosted/gemini.js.map +1 -0
  28. package/dist/hosted/openai.d.ts +33 -0
  29. package/dist/hosted/openai.d.ts.map +1 -0
  30. package/dist/hosted/openai.js +107 -0
  31. package/dist/hosted/openai.js.map +1 -0
  32. package/dist/hosted/responses.d.ts +28 -0
  33. package/dist/hosted/responses.d.ts.map +1 -0
  34. package/dist/hosted/responses.js +358 -0
  35. package/dist/hosted/responses.js.map +1 -0
  36. package/dist/hosted/shared.d.ts +107 -0
  37. package/dist/hosted/shared.d.ts.map +1 -0
  38. package/dist/hosted/shared.js +264 -0
  39. package/dist/hosted/shared.js.map +1 -0
  40. package/dist/hosted/types.d.ts +191 -0
  41. package/dist/hosted/types.d.ts.map +1 -0
  42. package/dist/hosted/types.js +10 -0
  43. package/dist/hosted/types.js.map +1 -0
  44. package/dist/hosted.d.ts +33 -0
  45. package/dist/hosted.d.ts.map +1 -0
  46. package/dist/hosted.js +61 -0
  47. package/dist/hosted.js.map +1 -0
  48. package/dist/index.d.ts +8 -7
  49. package/dist/index.d.ts.map +1 -1
  50. package/dist/index.js +8 -7
  51. package/dist/index.js.map +1 -1
  52. package/dist/key-pool.d.ts.map +1 -1
  53. package/dist/key-pool.js.map +1 -1
  54. package/dist/presets.d.ts +36 -5
  55. package/dist/presets.d.ts.map +1 -1
  56. package/dist/presets.js +32 -8
  57. package/dist/presets.js.map +1 -1
  58. package/dist/providers/anthropic.d.ts +75 -1
  59. package/dist/providers/anthropic.d.ts.map +1 -1
  60. package/dist/providers/anthropic.js +207 -135
  61. package/dist/providers/anthropic.js.map +1 -1
  62. package/dist/providers/deepgram-transcription.d.ts +24 -0
  63. package/dist/providers/deepgram-transcription.d.ts.map +1 -0
  64. package/dist/providers/deepgram-transcription.js +84 -0
  65. package/dist/providers/deepgram-transcription.js.map +1 -0
  66. package/dist/providers/factory.d.ts +10 -0
  67. package/dist/providers/factory.d.ts.map +1 -1
  68. package/dist/providers/factory.js +31 -23
  69. package/dist/providers/factory.js.map +1 -1
  70. package/dist/providers/gemini.d.ts +123 -1
  71. package/dist/providers/gemini.d.ts.map +1 -1
  72. package/dist/providers/gemini.js +114 -54
  73. package/dist/providers/gemini.js.map +1 -1
  74. package/dist/providers/hosted-codecs.d.ts +10 -0
  75. package/dist/providers/hosted-codecs.d.ts.map +1 -0
  76. package/dist/providers/hosted-codecs.js +8 -0
  77. package/dist/providers/hosted-codecs.js.map +1 -0
  78. package/dist/providers/openai-transcription.d.ts +21 -0
  79. package/dist/providers/openai-transcription.d.ts.map +1 -0
  80. package/dist/providers/openai-transcription.js +144 -0
  81. package/dist/providers/openai-transcription.js.map +1 -0
  82. package/dist/providers/openai.d.ts +69 -0
  83. package/dist/providers/openai.d.ts.map +1 -1
  84. package/dist/providers/openai.js +38 -14
  85. package/dist/providers/openai.js.map +1 -1
  86. package/dist/providers/responses.d.ts +123 -0
  87. package/dist/providers/responses.d.ts.map +1 -1
  88. package/dist/providers/responses.js +57 -22
  89. package/dist/providers/responses.js.map +1 -1
  90. package/dist/providers/speech-factory.js.map +1 -1
  91. package/dist/providers/transcription-factory.d.ts +30 -0
  92. package/dist/providers/transcription-factory.d.ts.map +1 -0
  93. package/dist/providers/transcription-factory.js +38 -0
  94. package/dist/providers/transcription-factory.js.map +1 -0
  95. package/dist/registry.d.ts +3 -0
  96. package/dist/registry.d.ts.map +1 -1
  97. package/dist/registry.js +8 -4
  98. package/dist/registry.js.map +1 -1
  99. package/dist/retry.js.map +1 -1
  100. package/dist/speech-core.d.ts +2 -17
  101. package/dist/speech-core.d.ts.map +1 -1
  102. package/dist/speech-core.js +10 -50
  103. package/dist/speech-core.js.map +1 -1
  104. package/dist/tools.d.ts.map +1 -1
  105. package/dist/tools.js.map +1 -1
  106. package/dist/transcription-core.d.ts +146 -0
  107. package/dist/transcription-core.d.ts.map +1 -0
  108. package/dist/transcription-core.js +193 -0
  109. package/dist/transcription-core.js.map +1 -0
  110. package/dist/transcription.d.ts +7 -0
  111. package/dist/transcription.d.ts.map +1 -0
  112. package/dist/transcription.js +12 -0
  113. package/dist/transcription.js.map +1 -0
  114. package/dist/transport.d.ts +26 -0
  115. package/dist/transport.d.ts.map +1 -1
  116. package/dist/transport.js +57 -2
  117. package/dist/transport.js.map +1 -1
  118. package/dist/turn.d.ts +10 -1
  119. package/dist/turn.d.ts.map +1 -1
  120. package/dist/turn.js +53 -1
  121. package/dist/turn.js.map +1 -1
  122. package/dist/types.d.ts +51 -0
  123. package/dist/types.d.ts.map +1 -1
  124. package/dist/types.js.map +1 -1
  125. package/dist/usage.d.ts +10 -1
  126. package/dist/usage.d.ts.map +1 -1
  127. package/dist/usage.js +40 -2
  128. package/dist/usage.js.map +1 -1
  129. package/dist/watchdog.d.ts +6 -0
  130. package/dist/watchdog.d.ts.map +1 -1
  131. package/dist/watchdog.js +10 -2
  132. package/dist/watchdog.js.map +1 -1
  133. package/package.json +14 -5
  134. package/src/context.ts +21 -5
  135. package/src/errors.ts +35 -2
  136. package/src/fallback.ts +21 -6
  137. package/src/hosted/anthropic.ts +512 -0
  138. package/src/hosted/gemini.ts +510 -0
  139. package/src/hosted/openai.ts +137 -0
  140. package/src/hosted/responses.ts +420 -0
  141. package/src/hosted/shared.ts +341 -0
  142. package/src/hosted/types.ts +214 -0
  143. package/src/hosted.ts +101 -0
  144. package/src/index.ts +64 -7
  145. package/src/presets.ts +54 -8
  146. package/src/providers/anthropic.ts +252 -143
  147. package/src/providers/deepgram-transcription.ts +109 -0
  148. package/src/providers/factory.ts +127 -82
  149. package/src/providers/gemini.ts +184 -60
  150. package/src/providers/hosted-codecs.ts +29 -0
  151. package/src/providers/openai-transcription.ts +177 -0
  152. package/src/providers/openai.ts +52 -15
  153. package/src/providers/responses.ts +93 -24
  154. package/src/providers/transcription-factory.ts +68 -0
  155. package/src/registry.ts +14 -4
  156. package/src/speech-core.ts +9 -47
  157. package/src/transcription-core.ts +345 -0
  158. package/src/transcription.ts +24 -0
  159. package/src/transport.ts +77 -3
  160. package/src/turn.ts +55 -1
  161. package/src/types.ts +62 -1
  162. package/src/usage.ts +32 -2
  163. package/src/watchdog.ts +12 -2
@@ -0,0 +1 @@
1
+ {"version":3,"file":"responses.d.ts","sourceRoot":"","sources":["../../src/hosted/responses.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAKV,UAAU,EAEX,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAiB,MAAM,2BAA2B,CAAC;AAChG,OAAO,KAAK,EAAa,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAmL3E,gEAAgE;AAChE,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA+DD,eAAO,MAAM,eAAe;iBACb,eAAe,WAAW,MAAM,MAAM,MAAM,QAAQ,aAAa;;;;;mBAwB/D,UAAU,EAAE;QAgCtB,KAAK,QAAQ,cAAc,GAAG,SAAS,CAAC,aAAa,CAAC;QAqFvD,KAAK,QA5FkB,SAAS,CAAC,aAAa,CAAC;QA6F/C,MAAM;;CAGX,CAAC"}
@@ -0,0 +1,358 @@
1
+ // Hosted shapes and annotations follow Vercel AI SDK (Apache-2.0) and
2
+ // PydanticAI (MIT). See THIRD_PARTY_NOTICES.
3
+ import { ProviderError } from "../errors.js";
4
+ import { codePointIndex, hostedCounts, HostedRecorder, planHostedTools, queryInput, servedAt, } from "./shared.js";
5
+ /** The hosted types this wire has a shape for, and the fields it applies. No
6
+ * use cap on web search, and no fetch tool, on this wire. */
7
+ const RESPONSES_FIELDS = {
8
+ web_search: ["allowedDomains", "blockedDomains", "userLocation"],
9
+ code_execution: ["fileIds"],
10
+ file_search: ["storeIds", "maxResults"],
11
+ image_generation: ["size", "quality", "format", "background"],
12
+ };
13
+ const RESPONSES_SENDS = Object.keys(RESPONSES_FIELDS);
14
+ /** The output each hosted tool needs asked for by name, or it comes back
15
+ * without its sources, logs or results. */
16
+ const RESPONSES_INCLUDES = {
17
+ web_search: "web_search_call.action.sources",
18
+ code_execution: "code_interpreter_call.outputs",
19
+ file_search: "file_search_call.results",
20
+ };
21
+ /** One hosted tool on the wire. Shapes from Vercel's AI SDK (Apache-2.0),
22
+ * openai-responses-prepare-tools.ts:238-381. */
23
+ function responsesHostedTool(provider, tool) {
24
+ switch (tool.type) {
25
+ case "web_search":
26
+ return {
27
+ type: "web_search",
28
+ ...(tool.allowedDomains || tool.blockedDomains
29
+ ? {
30
+ filters: {
31
+ allowed_domains: tool.allowedDomains,
32
+ blocked_domains: tool.blockedDomains,
33
+ },
34
+ }
35
+ : {}),
36
+ ...(tool.userLocation
37
+ ? { user_location: { type: "approximate", ...tool.userLocation } }
38
+ : {}),
39
+ };
40
+ case "code_execution":
41
+ return { type: "code_interpreter", container: { type: "auto", file_ids: tool.fileIds } };
42
+ case "file_search":
43
+ return {
44
+ type: "file_search",
45
+ vector_store_ids: tool.storeIds,
46
+ max_num_results: tool.maxResults,
47
+ };
48
+ case "image_generation":
49
+ return {
50
+ type: "image_generation",
51
+ size: tool.size,
52
+ quality: tool.quality,
53
+ output_format: tool.format,
54
+ background: tool.background,
55
+ };
56
+ default:
57
+ // planHostedTools only passes the types in RESPONSES_FIELDS.
58
+ throw new ProviderError(provider, "invalid", `${provider}: no Responses shape for ${tool.type}`);
59
+ }
60
+ }
61
+ /** The seam's type for a hosted output item, or undefined for any other item. */
62
+ const HOSTED_ITEMS = {
63
+ web_search_call: "web_search",
64
+ code_interpreter_call: "code_execution",
65
+ file_search_call: "file_search",
66
+ image_generation_call: "image_generation",
67
+ };
68
+ /** A generated image's media type, read off its first bytes: the format the
69
+ * request asked for is a wish, the bytes are the image. */
70
+ function imageType(base64, asked) {
71
+ if (base64.startsWith("iVBORw0KGgo"))
72
+ return "image/png";
73
+ if (base64.startsWith("/9j/"))
74
+ return "image/jpeg";
75
+ if (base64.startsWith("UklGR"))
76
+ return "image/webp";
77
+ if (base64.startsWith("R0lGOD"))
78
+ return "image/gif";
79
+ // ponytail: unrecognized bytes fall back to the format asked for, PNG by
80
+ // default, which is the API's own default. Upgrade: refuse them.
81
+ switch (asked?.type === "image_generation" ? asked.format : undefined) {
82
+ case "jpeg":
83
+ return "image/jpeg";
84
+ case "webp":
85
+ return "image/webp";
86
+ default:
87
+ return "image/png";
88
+ }
89
+ }
90
+ /** What a web search did, from its `action`: the queries it ran, or the page
91
+ * it opened or searched within. */
92
+ function webSearchInput(action) {
93
+ if (action?.type === "search")
94
+ return queryInput(action.queries ?? [action.query]);
95
+ return action?.url ? { url: action.url } : undefined;
96
+ }
97
+ /** What a hosted item says it did. `.added` states only its id and type;
98
+ * `.done` states the whole call. A status other than `completed` on `.done`
99
+ * is a failed call, kept as data (invariant 7). */
100
+ function hostedItemDelta(item, done, asked) {
101
+ const failed = done && item.status !== undefined && item.status !== "completed";
102
+ let status = "running";
103
+ if (failed)
104
+ status = "failed";
105
+ else if (done)
106
+ status = "completed";
107
+ const error = failed ? (item.error?.code ?? item.error?.message ?? item.status) : undefined;
108
+ const base = { status, ...(error ? { error } : {}) };
109
+ switch (item.type) {
110
+ case "web_search_call": {
111
+ const action = item.action;
112
+ const input = webSearchInput(action);
113
+ const sources = (action?.sources ?? []).flatMap((source) => source.type === "url" && source.url ? [{ type: "url", url: source.url }] : []);
114
+ return {
115
+ ...base,
116
+ ...(input && Object.keys(input).length > 0 ? { input } : {}),
117
+ ...(done && sources.length > 0 ? { output: { sources } } : {}),
118
+ };
119
+ }
120
+ case "code_interpreter_call": {
121
+ const logs = (item.outputs ?? []).flatMap((out) => out.type === "logs" && out.logs ? [out.logs] : []);
122
+ const files = (item.outputs ?? []).flatMap((out) => out.type === "image" && out.url
123
+ ? [{ url: out.url, ...(item.container_id ? { containerId: item.container_id } : {}) }]
124
+ : []);
125
+ return {
126
+ ...base,
127
+ input: { ...(item.code ? { code: item.code } : {}), language: "python" },
128
+ ...(done && (logs.length > 0 || files.length > 0)
129
+ ? {
130
+ output: {
131
+ ...(logs.length > 0 ? { stdout: logs.join("\n") } : {}),
132
+ ...(files.length > 0 ? { files } : {}),
133
+ },
134
+ }
135
+ : {}),
136
+ };
137
+ }
138
+ case "file_search_call": {
139
+ const input = queryInput(item.queries ?? []);
140
+ const sources = (item.results ?? []).map((result) => ({
141
+ type: "file",
142
+ ...(result.file_id ? { fileId: result.file_id } : {}),
143
+ ...(result.filename ? { title: result.filename } : {}),
144
+ ...(result.text ? { excerpt: result.text } : {}),
145
+ }));
146
+ return {
147
+ ...base,
148
+ ...(Object.keys(input).length > 0 ? { input } : {}),
149
+ ...(done && sources.length > 0 ? { output: { sources } } : {}),
150
+ };
151
+ }
152
+ default: {
153
+ const image = done && item.result ? item.result : undefined;
154
+ return {
155
+ ...base,
156
+ ...(item.revised_prompt ? { input: { prompt: item.revised_prompt } } : {}),
157
+ ...(image
158
+ ? {
159
+ output: {
160
+ images: [{ type: "image", mimeType: imageType(image, asked), data: image }],
161
+ },
162
+ }
163
+ : {}),
164
+ };
165
+ }
166
+ }
167
+ }
168
+ /**
169
+ * One annotation as a citation, its offsets moved from the part's code points
170
+ * to the turn's JS indices. A URL citation selects the link the model wrote,
171
+ * so its span is kept only while it still contains the URL (PydanticAI, MIT,
172
+ * openai/_citations.py:112-118); a span that doesn't check out is dropped and
173
+ * the source kept. Mapping from Vercel's AI SDK (Apache-2.0),
174
+ * map-openai-responses-annotation.ts:11-74.
175
+ */
176
+ function annotationCitation(annotation, text, part) {
177
+ const partText = part ? text.slice(part.start, part.end) : "";
178
+ const at = (points) => part && points !== undefined ? codePointIndex(partText, points) : undefined;
179
+ const span = (start, end, contains) => part &&
180
+ start !== undefined &&
181
+ end !== undefined &&
182
+ start < end &&
183
+ (contains === undefined || partText.slice(start, end).includes(contains))
184
+ ? { start: part.start + start, end: part.start + end, anchor: "marker" }
185
+ : {};
186
+ switch (annotation.type) {
187
+ case "url_citation": {
188
+ if (!annotation.url)
189
+ return undefined;
190
+ const source = {
191
+ type: "url",
192
+ url: annotation.url,
193
+ ...(annotation.title ? { title: annotation.title } : {}),
194
+ };
195
+ return {
196
+ source,
197
+ ...span(at(annotation.start_index), at(annotation.end_index), annotation.url),
198
+ };
199
+ }
200
+ case "file_citation":
201
+ case "container_file_citation": {
202
+ if (!annotation.file_id && !annotation.filename)
203
+ return undefined;
204
+ const source = {
205
+ type: "file",
206
+ ...(annotation.file_id ? { fileId: annotation.file_id } : {}),
207
+ ...(annotation.filename ? { title: annotation.filename } : {}),
208
+ ...(annotation.container_id ? { containerId: annotation.container_id } : {}),
209
+ };
210
+ // A file citation marks one point, where the model referred to the file.
211
+ const point = at(annotation.index);
212
+ if (annotation.type === "file_citation") {
213
+ return point === undefined || !part
214
+ ? { source }
215
+ : { source, start: part.start + point, end: part.start + point, anchor: "marker" };
216
+ }
217
+ return { source, ...span(at(annotation.start_index), at(annotation.end_index)) };
218
+ }
219
+ default:
220
+ // `file_path` names a file code wrote, not a source of the answer.
221
+ return undefined;
222
+ }
223
+ }
224
+ export const responsesHosted = {
225
+ plan(config, baseUrl, id, opts) {
226
+ const hosted = planHostedTools(id, {
227
+ name: "Responses",
228
+ serves: (config.servesHostedTools ??
229
+ servedAt(baseUrl, "api.openai.com", [
230
+ "web_search",
231
+ "code_execution",
232
+ "file_search",
233
+ "image_generation",
234
+ ])).filter((type) => RESPONSES_SENDS.includes(type)),
235
+ fields: RESPONSES_FIELDS,
236
+ }, opts);
237
+ return {
238
+ hosted,
239
+ tools: hosted.map((tool) => responsesHostedTool(id, tool)),
240
+ include: hosted.flatMap((tool) => RESPONSES_INCLUDES[tool.type] ?? []),
241
+ };
242
+ },
243
+ stream(hosted) {
244
+ // Hosted calls, by item id. The answer so far, and where each part of it
245
+ // starts, so an annotation's offsets can be placed and checked.
246
+ const recorder = new HostedRecorder();
247
+ let text = "";
248
+ const parts = new Map();
249
+ // Waiting annotations, by the message item they belong to.
250
+ const annotations = new Map();
251
+ const partKey = (event) => `${event.item_id ?? ""}:${event.content_index ?? 0}`;
252
+ const asked = (type) => hosted.find((tool) => tool.type === type);
253
+ // An annotation is placed once its part is whole: when its message item
254
+ // ends, or, for every item still waiting, when the turn does.
255
+ function* cite(item) {
256
+ const due = item === undefined ? [...annotations.values()].flat() : (annotations.get(item) ?? []);
257
+ if (item === undefined)
258
+ annotations.clear();
259
+ else
260
+ annotations.delete(item);
261
+ const citations = due.flatMap(({ part, annotation }) => {
262
+ const citation = annotationCitation(annotation, text, parts.get(part));
263
+ return citation ? [citation] : [];
264
+ });
265
+ if (citations.length > 0)
266
+ yield { type: "delta", citations };
267
+ }
268
+ // The end of the turn: a hosted call the backend never finished fails,
269
+ // and every annotation still waiting is placed.
270
+ function* closeHosted() {
271
+ const failed = recorder.settle();
272
+ if (failed.length > 0)
273
+ yield { type: "delta", hosted: failed };
274
+ yield* cite();
275
+ }
276
+ return {
277
+ *event(event) {
278
+ // Every step a hosted call reports (in progress, searching,
279
+ // interpreting, generating) goes out as a status delta: progress the
280
+ // watchdog's progress clock can see while the vendor's tool works.
281
+ if (/^response\.(web_search|file_search|code_interpreter|image_generation)_call\.\w+$/.test(event.type ?? "")) {
282
+ const index = recorder.indexOf(event.item_id);
283
+ if (index !== undefined)
284
+ yield { type: "delta", hosted: [{ index, status: "running" }] };
285
+ return;
286
+ }
287
+ switch (event.type) {
288
+ case "response.output_text.delta":
289
+ if (event.delta) {
290
+ const key = partKey(event);
291
+ const part = parts.get(key) ?? { start: text.length, end: text.length };
292
+ text += event.delta;
293
+ part.end = text.length;
294
+ parts.set(key, part);
295
+ }
296
+ break;
297
+ case "response.output_text.annotation.added":
298
+ if (event.annotation) {
299
+ const item = event.item_id ?? "";
300
+ const waiting = annotations.get(item) ?? [];
301
+ waiting.push({ part: partKey(event), annotation: event.annotation });
302
+ annotations.set(item, waiting);
303
+ }
304
+ break;
305
+ case "response.code_interpreter_call_code.delta": {
306
+ const index = recorder.indexOf(event.item_id);
307
+ if (index !== undefined && event.delta) {
308
+ yield { type: "delta", hosted: [{ index, codeDelta: event.delta }] };
309
+ }
310
+ break;
311
+ }
312
+ // The whole program, which wins over the deltas it repeats.
313
+ case "response.code_interpreter_call_code.done": {
314
+ const index = recorder.indexOf(event.item_id);
315
+ if (index !== undefined && event.code !== undefined) {
316
+ yield { type: "delta", hosted: [{ index, input: { code: event.code } }] };
317
+ }
318
+ break;
319
+ }
320
+ case "response.output_item.added": {
321
+ const item = event.item;
322
+ const type = item?.type ? HOSTED_ITEMS[item.type] : undefined;
323
+ if (item && type) {
324
+ // A hosted call, never a function call: no tool for the loop to
325
+ // run, and no part in the finish reason.
326
+ const started = recorder.start(item.id, type, text.length);
327
+ yield {
328
+ type: "delta",
329
+ hosted: [{ ...started, ...hostedItemDelta(item, false, asked(type)) }],
330
+ };
331
+ break;
332
+ }
333
+ break;
334
+ }
335
+ case "response.output_item.done": {
336
+ const item = event.item;
337
+ const type = item?.type ? HOSTED_ITEMS[item.type] : undefined;
338
+ if (item && type) {
339
+ const delta = hostedItemDelta(item, true, asked(type));
340
+ // A backend that sends only the finished item still ran it.
341
+ const done = recorder.end(item.id, delta) ?? recorder.whole(item.id, type, text.length, delta);
342
+ yield { type: "delta", hosted: [done] };
343
+ break;
344
+ }
345
+ if (item?.type === "message") {
346
+ yield* cite(item.id);
347
+ break;
348
+ }
349
+ break;
350
+ }
351
+ }
352
+ },
353
+ close: closeHosted,
354
+ counts: () => hostedCounts(recorder.shown()),
355
+ };
356
+ },
357
+ };
358
+ //# sourceMappingURL=responses.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"responses.js","sourceRoot":"","sources":["../../src/hosted/responses.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,107 @@
1
+ import type { HostedToolType, HostedTool, HostedWire, HostedInput, HostedCallDelta } from "./types.ts";
2
+ export * from "./types.ts";
3
+ import { ProviderError } from "../errors.ts";
4
+ import type { ChatMessage, StreamOptions, ToolCall } from "../types.ts";
5
+ /**
6
+ * A hosted tool the wire can't send. Refused, never dropped: see the module
7
+ * comment. `wire` names the adapter, because `provider` is often a gateway's id.
8
+ */
9
+ export declare function hostedRefused(provider: string, wire: string, tool: HostedToolType, why: string): ProviderError;
10
+ /**
11
+ * The hosted tools one request sends: each tool the caller asked for that this
12
+ * wire can send with every field it set. One it can't is refused with an
13
+ * `invalid` error before any request, unless it is `optional`, which drops it.
14
+ *
15
+ * `toolChoice: "none"` sends none, on every wire. A forced choice (`required`
16
+ * or a named tool) with hosted tools is refused: Anthropic's `any` and
17
+ * Responses' `required` can be met by a vendor tool, Gemini's `ANY` cannot, so
18
+ * the pair has no one meaning. A type listed twice is refused everywhere.
19
+ *
20
+ * Ported from PydanticAI (MIT, Pydantic Services Inc.): the refusal rule and
21
+ * `optional`, models/__init__.py:4080-4130 and native_tools/__init__.py:155-207.
22
+ */
23
+ export declare function planHostedTools(provider: string, wire: HostedWire, opts: Pick<StreamOptions, "hostedTools" | "toolChoice">): HostedTool[];
24
+ /** The types an endpoint runs when its config doesn't say: the vendor's own API
25
+ * host runs its documented set, and every other host none. A gateway that
26
+ * ignores an unknown tool answers unsearched and says nothing, so a host runs
27
+ * hosted tools only once someone has measured it (`servesHostedTools`). */
28
+ export declare function servedAt(baseUrl: string, host: string, types: readonly HostedToolType[]): readonly HostedToolType[];
29
+ /** A search's input: one query as `query`, several as `queries`, so a reader
30
+ * that shows one string finds it in the same place on every wire. */
31
+ export declare function queryInput(queries: readonly (string | undefined | null)[]): HostedInput;
32
+ /**
33
+ * The hosted calls one stream opened, keyed by the vendor's id, so a result
34
+ * finds its call and the end of the turn can settle the ones that never got
35
+ * one. It also counts what the stream showed, per type, for
36
+ * `TokenUsage.hostedCalls` on a wire that does not state its own counts.
37
+ */
38
+ export declare class HostedRecorder {
39
+ private next;
40
+ private readonly open;
41
+ private readonly counts;
42
+ /** A call the vendor started. One with no id of its own gets `hosted_{index}`,
43
+ * which depends on nothing but its position (invariant 14). */
44
+ start(id: string | undefined, type: HostedToolType, at: number, input?: HostedInput): HostedCallDelta & {
45
+ id: string;
46
+ };
47
+ /** A call the vendor reports only once it is over (Gemini's grounding, a
48
+ * backend that sends only the finished item), in one delta. */
49
+ whole(id: string | undefined, type: HostedToolType, at: number, delta: Omit<HostedCallDelta, "index" | "id" | "type" | "at">): HostedCallDelta;
50
+ /** The seam index of a call still open, by the vendor's id. */
51
+ indexOf(id: string | undefined): number | undefined;
52
+ /** A call the vendor finished, or undefined for an id it never opened. */
53
+ end(id: string | undefined, delta: Omit<HostedCallDelta, "index">): HostedCallDelta | undefined;
54
+ /** The ids still open. */
55
+ unsettled(): ReadonlySet<string>;
56
+ /** Every call still open at the end of the turn, failed: the vendor never
57
+ * said how it went, so nothing it returned can be shown or replayed. */
58
+ settle(): HostedCallDelta[];
59
+ /** The calls the stream showed, by type, or undefined when it showed none. */
60
+ shown(): Partial<Record<HostedToolType, number>> | undefined;
61
+ }
62
+ /** The counts a usage record carries, with the types at zero left out, or
63
+ * undefined when every type is. A turn that ran nothing keeps its usage
64
+ * exactly as it was before hosted tools existed. */
65
+ export declare function hostedCounts(...counts: (Partial<Record<HostedToolType, number>> | undefined)[]): Partial<Record<HostedToolType, number>> | undefined;
66
+ type AssistantMessage = Extract<ChatMessage, {
67
+ role: "assistant";
68
+ }>;
69
+ /** One recorded item with its placeholder filled back in. */
70
+ export type ReplayedItem = {
71
+ text: string;
72
+ slot: Record<string, unknown>;
73
+ } | {
74
+ call: ToolCall;
75
+ } | {
76
+ item: unknown;
77
+ };
78
+ /** A JSON object off the wire, as opposed to an array, a scalar or null. */
79
+ export declare function isRecord(value: unknown): value is Record<string, unknown>;
80
+ /**
81
+ * The hosted items a message replays to `provider`, placeholders filled back
82
+ * in, or undefined when it replays none: another provider made them, or the
83
+ * message no longer matches them. Matching means the recorded text lengths sum
84
+ * to `content.length` and every call placeholder names a distinct call the
85
+ * message still has. An edited answer fails that and goes back as plain text,
86
+ * because a citation replayed over edited text vouches for words its source
87
+ * never backed.
88
+ *
89
+ * ponytail: an edit that keeps the length passes. PydanticAI and TanStack use
90
+ * the same length test (anthropic/_citations.py:202-211, responses-text.ts:172-212);
91
+ * the upgrade is a hash of the text in each placeholder.
92
+ */
93
+ export declare function hostedReplay(message: AssistantMessage, provider: string): ReplayedItem[] | undefined;
94
+ /**
95
+ * A UTF-8 byte offset into `text` as a JS string index, or undefined when it
96
+ * falls inside a character or past the end. Gemini counts its grounding
97
+ * segments in bytes; a JS string counts UTF-16 units, so the two part at the
98
+ * first character outside ASCII.
99
+ *
100
+ * Ported from PydanticAI (MIT, Pydantic Services Inc.), models/google.py:2347-2405.
101
+ */
102
+ export declare function utf8Index(text: string, bytes: number): number | undefined;
103
+ /** A code point offset into `text` as a JS string index, or undefined past the
104
+ * end. OpenAI's annotation offsets count code points, which differ from JS
105
+ * indices at the first emoji or other character outside the BMP. */
106
+ export declare function codePointIndex(text: string, points: number): number | undefined;
107
+ //# sourceMappingURL=shared.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/hosted/shared.ts"],"names":[],"mappings":"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"}