@emabuild/ai 0.1.0 → 0.8.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 (40) hide show
  1. package/README.md +122 -11
  2. package/dist/cli.js +24 -6
  3. package/dist/cli.js.map +1 -1
  4. package/dist/index.d.ts +9 -2
  5. package/dist/index.d.ts.map +1 -1
  6. package/dist/index.js +9 -2
  7. package/dist/index.js.map +1 -1
  8. package/dist/loop.d.ts +26 -0
  9. package/dist/loop.d.ts.map +1 -0
  10. package/dist/loop.js +215 -0
  11. package/dist/loop.js.map +1 -0
  12. package/dist/providers/anthropic.d.ts +58 -0
  13. package/dist/providers/anthropic.d.ts.map +1 -0
  14. package/dist/providers/anthropic.js +217 -0
  15. package/dist/providers/anthropic.js.map +1 -0
  16. package/dist/providers/errors.d.ts +12 -0
  17. package/dist/providers/errors.d.ts.map +1 -0
  18. package/dist/providers/errors.js +39 -0
  19. package/dist/providers/errors.js.map +1 -0
  20. package/dist/providers/model-call.d.ts +17 -0
  21. package/dist/providers/model-call.d.ts.map +1 -0
  22. package/dist/providers/model-call.js +65 -0
  23. package/dist/providers/model-call.js.map +1 -0
  24. package/dist/providers/openai-format.d.ts +89 -0
  25. package/dist/providers/openai-format.d.ts.map +1 -0
  26. package/dist/providers/openai-format.js +107 -0
  27. package/dist/providers/openai-format.js.map +1 -0
  28. package/dist/providers/types.d.ts +168 -0
  29. package/dist/providers/types.d.ts.map +1 -0
  30. package/dist/providers/types.js +22 -0
  31. package/dist/providers/types.js.map +1 -0
  32. package/dist/run.d.ts +38 -37
  33. package/dist/run.d.ts.map +1 -1
  34. package/dist/run.js +44 -323
  35. package/dist/run.js.map +1 -1
  36. package/dist/usage.d.ts +7 -1
  37. package/dist/usage.d.ts.map +1 -1
  38. package/dist/usage.js +35 -6
  39. package/dist/usage.js.map +1 -1
  40. package/package.json +17 -7
@@ -0,0 +1,58 @@
1
+ /**
2
+ * @module providers/anthropic
3
+ *
4
+ * The built-in Claude adapter (the default provider). Prompt caching on the
5
+ * stable system prefix and the conversation, server-side refusal fallbacks,
6
+ * progress-update thinking blocks and `output_config.effort`, streamed through
7
+ * the Messages API. `@anthropic-ai/sdk` is an optional peer dependency, loaded
8
+ * on first use; pass `client` for Bedrock / Vertex / Foundry.
9
+ */
10
+ import type Anthropic from '@anthropic-ai/sdk';
11
+ import type { AIRequest } from '@emabuild/types';
12
+ import { type ModelAdapter, type SystemPart, type ToolSpec } from './types.js';
13
+ import type { AIEffort } from '../run.js';
14
+ type BetaMessageParam = Anthropic.Beta.Messages.BetaMessageParam;
15
+ type BetaMessage = Anthropic.Beta.Messages.BetaMessage;
16
+ type StreamParams = Anthropic.Beta.Messages.MessageCreateParamsStreaming;
17
+ /** Request parameters shared by every turn of a run (everything except `messages`) */
18
+ export type RequestParams = Omit<StreamParams, 'messages' | 'stream'>;
19
+ /** Default model: Claude Opus 5.5 (the current Opus) */
20
+ export declare const DEFAULT_MODEL = "claude-opus-5-5";
21
+ /** Default per-response output cap (streamed, so large values are safe) */
22
+ export declare const DEFAULT_MAX_TOKENS = 64000;
23
+ /** Options of the Anthropic adapter (also accepted by `runAI` / `createAIHandler`) */
24
+ export interface AnthropicOptions {
25
+ /** Pre-configured Anthropic client (takes precedence over `apiKey`) */
26
+ client?: Anthropic;
27
+ /** API key; defaults to the SDK's credential resolution (ANTHROPIC_API_KEY, profiles…) */
28
+ apiKey?: string;
29
+ /** Model id (default {@link DEFAULT_MODEL}) */
30
+ model?: string;
31
+ /** Server-side refusal fallbacks (`fallbacks: "default"`); on by default for supported models */
32
+ fallbacks?: boolean;
33
+ /** Progress-update thinking blocks forwarded as `status` events; on by default for supported models */
34
+ progressUpdates?: boolean;
35
+ }
36
+ /** The system prompt as parts: base and schema are stable (cacheable), extra instructions last */
37
+ export declare function systemParts(request: AIRequest, systemPrompt?: string): SystemPart[];
38
+ /** The editor tools in the neutral shape; `search_images` only when image search is on */
39
+ export declare function toolSpecs(imageSearch: boolean): ToolSpec[];
40
+ /**
41
+ * Builds the static request parameters for a run. Exported for testing and for
42
+ * callers that want to inspect what is sent.
43
+ */
44
+ export declare function buildRequestParams(request: AIRequest, options?: AnthropicOptions & {
45
+ maxTokens?: number;
46
+ effort?: AIEffort | null;
47
+ systemPrompt?: string;
48
+ imageSearch?: unknown;
49
+ }): RequestParams;
50
+ interface Conversation {
51
+ messages: BetaMessageParam[];
52
+ /** The message streamed by the last turn, until committed */
53
+ last?: BetaMessage;
54
+ }
55
+ /** The built-in Claude adapter */
56
+ export declare function createAnthropicAdapter(options?: AnthropicOptions): ModelAdapter<Conversation>;
57
+ export {};
58
+ //# sourceMappingURL=anthropic.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/providers/anthropic.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAIjD,OAAO,EAEc,KAAK,YAAY,EAAmB,KAAK,UAAU,EAAmB,KAAK,QAAQ,EACvG,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C,KAAK,gBAAgB,GAAG,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC;AACjE,KAAK,WAAW,GAAG,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;AACvD,KAAK,YAAY,GAAG,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,4BAA4B,CAAC;AACzE,sFAAsF;AACtF,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,YAAY,EAAE,UAAU,GAAG,QAAQ,CAAC,CAAC;AAEtE,wDAAwD;AACxD,eAAO,MAAM,aAAa,oBAAoB,CAAC;AAC/C,2EAA2E;AAC3E,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AAMxC,sFAAsF;AACtF,MAAM,WAAW,gBAAgB;IAC/B,uEAAuE;IACvE,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,0FAA0F;IAC1F,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iGAAiG;IACjG,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uGAAuG;IACvG,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,kGAAkG;AAClG,wBAAgB,WAAW,CAAC,OAAO,EAAE,SAAS,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,UAAU,EAAE,CAOnF;AAED,0FAA0F;AAC1F,wBAAgB,SAAS,CAAC,WAAW,EAAE,OAAO,GAAG,QAAQ,EAAE,CAI1D;AA+BD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,SAAS,EAClB,OAAO,GAAE,gBAAgB,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,GAC9H,aAAa,CAOf;AAgBD,UAAU,YAAY;IACpB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,6DAA6D;IAC7D,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB;AAED,kCAAkC;AAClC,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,gBAAqB,GAAG,YAAY,CAAC,YAAY,CAAC,CAqHjG"}
@@ -0,0 +1,217 @@
1
+ /**
2
+ * @module providers/anthropic
3
+ *
4
+ * The built-in Claude adapter (the default provider). Prompt caching on the
5
+ * stable system prefix and the conversation, server-side refusal fallbacks,
6
+ * progress-update thinking blocks and `output_config.effort`, streamed through
7
+ * the Messages API. `@anthropic-ai/sdk` is an optional peer dependency, loaded
8
+ * on first use; pass `client` for Bedrock / Vertex / Foundry.
9
+ */
10
+ import { AI_TOOLS, SEARCH_IMAGES_TOOL } from '../tools.js';
11
+ import { BASE_SYSTEM_PROMPT, buildSchemaPrompt } from '../prompt.js';
12
+ import { providerErrorMessage } from './errors.js';
13
+ import { ProviderSetupError, } from './types.js';
14
+ /** Default model: Claude Opus 5.5 (the current Opus) */
15
+ export const DEFAULT_MODEL = 'claude-opus-5-5';
16
+ /** Default per-response output cap (streamed, so large values are safe) */
17
+ export const DEFAULT_MAX_TOKENS = 64000;
18
+ const FALLBACK_MODELS = /^claude-(opus-5-5|opus-5|fable-5-1|sonnet-5-5)$/;
19
+ const UPDATES_MODELS = /^claude-(opus-5-5|fable-5-1|fable-5|mythos-5-1|sonnet-5-5)$/;
20
+ const INTERRUPTED_SENTINEL = 'This part of the response was interrupted before it finished.';
21
+ /** The system prompt as parts: base and schema are stable (cacheable), extra instructions last */
22
+ export function systemParts(request, systemPrompt) {
23
+ const parts = [
24
+ { text: BASE_SYSTEM_PROMPT, cache: true },
25
+ { text: buildSchemaPrompt(request), cache: true },
26
+ ];
27
+ if (systemPrompt)
28
+ parts.push({ text: `# Additional instructions\n${systemPrompt}` });
29
+ return parts;
30
+ }
31
+ /** The editor tools in the neutral shape; `search_images` only when image search is on */
32
+ export function toolSpecs(imageSearch) {
33
+ return AI_TOOLS
34
+ .filter((t) => imageSearch || t.name !== SEARCH_IMAGES_TOOL)
35
+ .map((t) => ({ name: t.name, description: t.description ?? '', inputSchema: t.input_schema }));
36
+ }
37
+ /** Messages API parameters for a model and the loop's turn settings */
38
+ function paramsFor(model, settings, options) {
39
+ const fallbacks = options.fallbacks ?? FALLBACK_MODELS.test(model);
40
+ const updates = options.progressUpdates ?? UPDATES_MODELS.test(model);
41
+ const betas = [];
42
+ if (fallbacks)
43
+ betas.push('server-side-fallback-2026-07-01');
44
+ if (updates)
45
+ betas.push('thinking-display-updates-2026-08-18');
46
+ // Cache layout (render order tools → system → messages): the stable system
47
+ // parts are marked, plus top-level automatic caching for the conversation.
48
+ const system = settings.system.map((p) => p.cache ? { type: 'text', text: p.text, cache_control: { type: 'ephemeral' } } : { type: 'text', text: p.text });
49
+ const params = {
50
+ model,
51
+ max_tokens: settings.maxTokens ?? DEFAULT_MAX_TOKENS,
52
+ system,
53
+ tools: settings.tools.map((t) => ({ name: t.name, description: t.description, input_schema: t.inputSchema })),
54
+ tool_choice: { type: 'auto' },
55
+ cache_control: { type: 'ephemeral' },
56
+ };
57
+ if (betas.length > 0)
58
+ params.betas = betas;
59
+ if (fallbacks)
60
+ params.fallbacks = 'default';
61
+ if (updates)
62
+ params.thinking = { type: 'adaptive', display: 'updates' };
63
+ if (settings.effort)
64
+ params.output_config = { effort: settings.effort };
65
+ return params;
66
+ }
67
+ /**
68
+ * Builds the static request parameters for a run. Exported for testing and for
69
+ * callers that want to inspect what is sent.
70
+ */
71
+ export function buildRequestParams(request, options = {}) {
72
+ return paramsFor(options.model ?? DEFAULT_MODEL, {
73
+ system: systemParts(request, options.systemPrompt),
74
+ tools: toolSpecs(options.imageSearch !== false),
75
+ maxTokens: options.maxTokens,
76
+ effort: options.effort === undefined ? 'medium' : options.effort,
77
+ }, options);
78
+ }
79
+ let sdkPromise = null;
80
+ /** Load the optional SDK once; a clear error when it is not installed */
81
+ async function loadSdk() {
82
+ sdkPromise ??= import('@anthropic-ai/sdk').catch(() => {
83
+ sdkPromise = null;
84
+ throw new ProviderSetupError('Install `@anthropic-ai/sdk` to use the Anthropic provider (npm install @anthropic-ai/sdk), or pass `callModel` to use another model.');
85
+ });
86
+ return sdkPromise;
87
+ }
88
+ const STOP = { end_turn: 'end', stop_sequence: 'end', tool_use: 'tool_calls', max_tokens: 'max_tokens', refusal: 'refusal', pause_turn: 'pause' };
89
+ /** The built-in Claude adapter */
90
+ export function createAnthropicAdapter(options = {}) {
91
+ const model = options.model ?? DEFAULT_MODEL;
92
+ let sdk = null;
93
+ let client = options.client ?? null;
94
+ async function ready() {
95
+ sdk ??= await loadSdk();
96
+ if (!client) {
97
+ const Ctor = sdk.default;
98
+ client = new Ctor(options.apiKey ? { apiKey: options.apiKey } : {});
99
+ }
100
+ return client;
101
+ }
102
+ return {
103
+ model,
104
+ async createConversation(userPrompt) {
105
+ await ready();
106
+ return { messages: [{ role: 'user', content: userPrompt }] };
107
+ },
108
+ async *streamTurn(conv, settings) {
109
+ const api = await ready();
110
+ const pending = new Map();
111
+ const thinking = new Map();
112
+ const texts = new Map();
113
+ const stream = api.beta.messages.stream({ ...paramsFor(model, settings, options), messages: conv.messages }, { signal: settings.signal });
114
+ for await (const event of stream) {
115
+ if (event.type === 'content_block_start') {
116
+ const block = event.content_block;
117
+ if (block.type === 'tool_use') {
118
+ pending.set(event.index, { id: block.id, name: block.name, json: '' });
119
+ yield { type: 'toolStart', id: block.id, name: block.name };
120
+ }
121
+ else if (block.type === 'text') {
122
+ texts.set(event.index, block.text ?? '');
123
+ }
124
+ else if (block.type === 'thinking') {
125
+ thinking.set(event.index, '');
126
+ }
127
+ }
128
+ else if (event.type === 'content_block_delta') {
129
+ const d = event.delta;
130
+ if (d.type === 'text_delta')
131
+ texts.set(event.index, (texts.get(event.index) ?? '') + d.text);
132
+ else if (d.type === 'thinking_delta')
133
+ thinking.set(event.index, (thinking.get(event.index) ?? '') + d.thinking);
134
+ else if (d.type === 'input_json_delta') {
135
+ const p = pending.get(event.index);
136
+ if (p)
137
+ p.json += d.partial_json;
138
+ }
139
+ }
140
+ else if (event.type === 'content_block_stop') {
141
+ const text = texts.get(event.index);
142
+ if (text !== undefined) {
143
+ texts.delete(event.index);
144
+ yield { type: 'text', text };
145
+ continue;
146
+ }
147
+ const note = thinking.get(event.index);
148
+ if (note !== undefined) {
149
+ thinking.delete(event.index);
150
+ // Under display "updates" any non-empty thinking block is a progress update
151
+ const trimmed = note.trim();
152
+ if (trimmed && trimmed !== INTERRUPTED_SENTINEL)
153
+ yield { type: 'status', text: trimmed };
154
+ continue;
155
+ }
156
+ const tool = pending.get(event.index);
157
+ if (!tool)
158
+ continue;
159
+ pending.delete(event.index);
160
+ yield { type: 'toolCall', call: { id: tool.id, name: tool.name, arguments: tool.json } };
161
+ }
162
+ }
163
+ const message = await stream.finalMessage();
164
+ conv.last = message;
165
+ const u = message.usage;
166
+ yield {
167
+ type: 'usage',
168
+ model: message.model,
169
+ usage: {
170
+ input: u?.input_tokens ?? 0,
171
+ output: u?.output_tokens ?? 0,
172
+ cacheRead: u?.cache_read_input_tokens ?? 0,
173
+ cacheWrite: u?.cache_creation_input_tokens ?? 0,
174
+ cacheWrite1h: u?.cache_creation?.ephemeral_1h_input_tokens ?? 0,
175
+ },
176
+ };
177
+ const toolCallIds = message.content.filter((b) => b.type === 'tool_use').map((b) => b.id);
178
+ yield { type: 'stop', reason: STOP[message.stop_reason ?? 'end_turn'] ?? 'end', toolCallIds };
179
+ },
180
+ commitAssistantTurn(conv) {
181
+ if (conv.last)
182
+ conv.messages.push({ role: 'assistant', content: conv.last.content });
183
+ conv.last = undefined;
184
+ },
185
+ addToolResults(conv, results) {
186
+ conv.messages.push({
187
+ role: 'user',
188
+ content: results.map((r) => (r.isError
189
+ ? { type: 'tool_result', tool_use_id: r.id, is_error: true, content: r.content }
190
+ : { type: 'tool_result', tool_use_id: r.id, content: r.content })),
191
+ });
192
+ },
193
+ describeError(err) {
194
+ if (!sdk)
195
+ return undefined;
196
+ const A = sdk.default;
197
+ if (err instanceof A.AuthenticationError)
198
+ return providerErrorMessage('auth');
199
+ if (err instanceof A.PermissionDeniedError)
200
+ return providerErrorMessage('permission');
201
+ if (err instanceof A.NotFoundError)
202
+ return providerErrorMessage('not_found', err.message);
203
+ if (err instanceof A.RateLimitError)
204
+ return providerErrorMessage('rate_limit');
205
+ if (err instanceof A.BadRequestError)
206
+ return providerErrorMessage('bad_request', err.message);
207
+ if (err instanceof A.APIConnectionError)
208
+ return providerErrorMessage('connection');
209
+ if (err instanceof A.APIError)
210
+ return providerErrorMessage('generic', err.message, err.status);
211
+ return undefined;
212
+ },
213
+ isProviderError: (err) => !!sdk && err instanceof sdk.default.APIError,
214
+ isAbortError: (err) => !!sdk && err instanceof sdk.default.APIUserAbortError,
215
+ };
216
+ }
217
+ //# sourceMappingURL=anthropic.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../src/providers/anthropic.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,12 @@
1
+ /**
2
+ * @module providers/errors
3
+ * The user-facing messages for provider errors, the same for every provider.
4
+ */
5
+ export type ProviderErrorKind = 'auth' | 'permission' | 'not_found' | 'rate_limit' | 'bad_request' | 'connection' | 'generic';
6
+ export declare function providerErrorMessage(kind: ProviderErrorKind, detail?: string, status?: number): string;
7
+ /**
8
+ * Best-effort message for an error thrown by `callModel` (any SDK): maps an
9
+ * HTTP `status` when the error carries one, else the error's own message.
10
+ */
11
+ export declare function describeAnyError(err: unknown): string;
12
+ //# sourceMappingURL=errors.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/providers/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,YAAY,GAAG,WAAW,GAAG,YAAY,GAAG,aAAa,GAAG,YAAY,GAAG,SAAS,CAAC;AAE9H,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,EAAE,MAAM,SAAK,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAUlG;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAWrD"}
@@ -0,0 +1,39 @@
1
+ /**
2
+ * @module providers/errors
3
+ * The user-facing messages for provider errors, the same for every provider.
4
+ */
5
+ export function providerErrorMessage(kind, detail = '', status) {
6
+ switch (kind) {
7
+ case 'auth': return 'Authentication with the AI provider failed (check the API key).';
8
+ case 'permission': return 'The API key is not allowed to use this model.';
9
+ case 'not_found': return `Model or endpoint not found: ${detail}`;
10
+ case 'rate_limit': return 'The AI provider is rate limiting requests; please retry shortly.';
11
+ case 'bad_request': return `Invalid request to the AI provider: ${detail}`;
12
+ case 'connection': return 'Could not reach the AI provider.';
13
+ default: return `AI provider error${status ? ` ${status}` : ''}: ${detail}`;
14
+ }
15
+ }
16
+ /**
17
+ * Best-effort message for an error thrown by `callModel` (any SDK): maps an
18
+ * HTTP `status` when the error carries one, else the error's own message.
19
+ */
20
+ export function describeAnyError(err) {
21
+ const status = typeof err?.status === 'number' ? err.status : undefined;
22
+ const message = err instanceof Error ? err.message : String(err);
23
+ if (status === 401)
24
+ return providerErrorMessage('auth');
25
+ if (status === 403)
26
+ return providerErrorMessage('permission');
27
+ if (status === 404)
28
+ return providerErrorMessage('not_found', message);
29
+ if (status === 429)
30
+ return providerErrorMessage('rate_limit');
31
+ if (status === 400)
32
+ return providerErrorMessage('bad_request', message);
33
+ if (status !== undefined)
34
+ return providerErrorMessage('generic', message, status);
35
+ if (err instanceof TypeError && /fetch failed|network|ECONNREFUSED|ENOTFOUND/i.test(message))
36
+ return providerErrorMessage('connection');
37
+ return message;
38
+ }
39
+ //# sourceMappingURL=errors.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/providers/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,UAAU,oBAAoB,CAAC,IAAuB,EAAE,MAAM,GAAG,EAAE,EAAE,MAAe;IACxF,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,MAAM,CAAC,CAAC,OAAO,iEAAiE,CAAC;QACtF,KAAK,YAAY,CAAC,CAAC,OAAO,+CAA+C,CAAC;QAC1E,KAAK,WAAW,CAAC,CAAC,OAAO,gCAAgC,MAAM,EAAE,CAAC;QAClE,KAAK,YAAY,CAAC,CAAC,OAAO,kEAAkE,CAAC;QAC7F,KAAK,aAAa,CAAC,CAAC,OAAO,uCAAuC,MAAM,EAAE,CAAC;QAC3E,KAAK,YAAY,CAAC,CAAC,OAAO,kCAAkC,CAAC;QAC7D,OAAO,CAAC,CAAC,OAAO,oBAAoB,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;IAC9E,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAY;IAC3C,MAAM,MAAM,GAAG,OAAQ,GAA4B,EAAE,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAE,GAA0B,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1H,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC;IACxD,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,oBAAoB,CAAC,YAAY,CAAC,CAAC;IAC9D,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,oBAAoB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACtE,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,oBAAoB,CAAC,YAAY,CAAC,CAAC;IAC9D,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,oBAAoB,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACxE,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,oBAAoB,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAClF,IAAI,GAAG,YAAY,SAAS,IAAI,8CAA8C,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,oBAAoB,CAAC,YAAY,CAAC,CAAC;IACxI,OAAO,OAAO,CAAC;AACjB,CAAC"}
@@ -0,0 +1,17 @@
1
+ /**
2
+ * @module providers/model-call
3
+ *
4
+ * Wraps a plain `callModel(request) => response` function as a model adapter:
5
+ * the loop keeps the conversation in the neutral format, hands it out each
6
+ * turn, and turns the answer into the same events as a streaming provider.
7
+ */
8
+ import type { ConversationMessage, ModelAdapter, ModelCall, ModelResponse } from './types.js';
9
+ interface Conversation {
10
+ messages: ConversationMessage[];
11
+ /** Answer of the last turn, until committed */
12
+ last?: ModelResponse;
13
+ }
14
+ /** An adapter that asks `callModel` for every turn */
15
+ export declare function adapterFromModelCall(callModel: ModelCall, model?: string): ModelAdapter<Conversation>;
16
+ export {};
17
+ //# sourceMappingURL=model-call.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"model-call.d.ts","sourceRoot":"","sources":["../../src/providers/model-call.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,EAA0B,MAAM,YAAY,CAAC;AAEtH,UAAU,YAAY;IACpB,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,+CAA+C;IAC/C,IAAI,CAAC,EAAE,aAAa,CAAC;CACtB;AAeD,sDAAsD;AACtD,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,SAAW,GAAG,YAAY,CAAC,YAAY,CAAC,CA+CvG"}
@@ -0,0 +1,65 @@
1
+ /**
2
+ * @module providers/model-call
3
+ *
4
+ * Wraps a plain `callModel(request) => response` function as a model adapter:
5
+ * the loop keeps the conversation in the neutral format, hands it out each
6
+ * turn, and turns the answer into the same events as a streaming provider.
7
+ */
8
+ import { describeAnyError } from './errors.js';
9
+ const isAbort = (err) => (err instanceof Error && (err.name === 'AbortError' || err.name === 'APIUserAbortError'))
10
+ || (typeof DOMException !== 'undefined' && err instanceof DOMException && err.name === 'AbortError');
11
+ /** Ids are needed to pair tool results with calls; models / gateways sometimes omit them */
12
+ function withIds(calls, turn) {
13
+ return (calls ?? []).map((c, i) => ({
14
+ id: c.id || `call_${turn}_${i}`,
15
+ name: c.name,
16
+ arguments: typeof c.arguments === 'string' ? c.arguments : JSON.stringify(c.arguments ?? {}),
17
+ }));
18
+ }
19
+ /** An adapter that asks `callModel` for every turn */
20
+ export function adapterFromModelCall(callModel, model = 'custom') {
21
+ let turn = 0;
22
+ return {
23
+ model,
24
+ createConversation(userPrompt) {
25
+ return { messages: [{ role: 'user', content: userPrompt }] };
26
+ },
27
+ async *streamTurn(conv, settings) {
28
+ const response = await callModel({
29
+ system: settings.system.map((p) => p.text).join('\n\n'),
30
+ messages: conv.messages.map((m) => ({ ...m })),
31
+ tools: settings.tools,
32
+ ...(settings.maxTokens !== undefined ? { maxTokens: settings.maxTokens } : {}),
33
+ effort: settings.effort,
34
+ signal: settings.signal,
35
+ });
36
+ const calls = withIds(response?.toolCalls, turn++);
37
+ conv.last = { ...response, toolCalls: calls };
38
+ const text = response?.text?.trim();
39
+ if (text)
40
+ yield { type: 'text', text };
41
+ for (const call of calls) {
42
+ yield { type: 'toolStart', id: call.id, name: call.name };
43
+ yield { type: 'toolCall', call };
44
+ }
45
+ yield { type: 'usage', model: response?.model || model, usage: response?.usage };
46
+ yield { type: 'stop', reason: response?.stop ?? (calls.length ? 'tool_calls' : 'end'), toolCallIds: calls.map((c) => c.id) };
47
+ },
48
+ commitAssistantTurn(conv) {
49
+ const last = conv.last;
50
+ if (!last)
51
+ return;
52
+ conv.messages.push({ role: 'assistant', content: last.text ?? '', ...(last.toolCalls?.length ? { toolCalls: last.toolCalls } : {}) });
53
+ conv.last = undefined;
54
+ },
55
+ addToolResults(conv, results) {
56
+ for (const r of results)
57
+ conv.messages.push({ role: 'tool', toolCallId: r.id, content: r.content, ...(r.isError ? { isError: true } : {}) });
58
+ },
59
+ describeError: (err) => (isAbort(err) ? undefined : describeAnyError(err)),
60
+ // Errors from your callModel are reported to the editor, not retried
61
+ isProviderError: () => true,
62
+ isAbortError: isAbort,
63
+ };
64
+ }
65
+ //# sourceMappingURL=model-call.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"model-call.js","sourceRoot":"","sources":["../../src/providers/model-call.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,89 @@
1
+ /**
2
+ * @module providers/openai-format
3
+ *
4
+ * Plain data conversions between the library's `callModel` contract and the
5
+ * OpenAI Chat Completions format, used by most providers (OpenAI, Azure
6
+ * OpenAI, Cerebras, Groq, local servers). No SDK involved:
7
+ *
8
+ * ```ts
9
+ * callModel: async (req) => {
10
+ * const completion = await openai.chat.completions.create({ model: 'gpt-4o', ...toOpenAIChat(req) }, { signal: req.signal });
11
+ * return fromOpenAIChat(completion);
12
+ * }
13
+ * ```
14
+ *
15
+ * {@link openAICompatibleModel} does the same with `fetch`, for servers you
16
+ * reach by URL and API key.
17
+ */
18
+ import type { ModelCall, ModelRequest, ModelResponse } from './types.js';
19
+ /** Chat Completions request body parts: `messages` and `tools` (add `model` and anything else you need) */
20
+ export interface OpenAIChatParams {
21
+ messages: Array<Record<string, unknown>>;
22
+ tools: Array<{
23
+ type: 'function';
24
+ function: {
25
+ name: string;
26
+ description: string;
27
+ parameters: Record<string, unknown>;
28
+ };
29
+ }>;
30
+ tool_choice: 'auto';
31
+ }
32
+ /** Turn a model request into Chat Completions `messages` + `tools` */
33
+ export declare function toOpenAIChat(request: ModelRequest): OpenAIChatParams;
34
+ /** The subset of a Chat Completions response we read */
35
+ export interface OpenAIChatCompletion {
36
+ model?: string;
37
+ choices?: Array<{
38
+ finish_reason?: string | null;
39
+ message?: {
40
+ content?: string | null;
41
+ refusal?: string | null;
42
+ tool_calls?: Array<{
43
+ id?: string;
44
+ type?: string;
45
+ function?: {
46
+ name?: string;
47
+ arguments?: string;
48
+ };
49
+ }> | null;
50
+ };
51
+ }>;
52
+ usage?: {
53
+ prompt_tokens?: number;
54
+ completion_tokens?: number;
55
+ prompt_tokens_details?: {
56
+ cached_tokens?: number;
57
+ } | null;
58
+ } | null;
59
+ }
60
+ /** Turn a Chat Completions response into the model answer `callModel` returns */
61
+ export declare function fromOpenAIChat(completion: OpenAIChatCompletion): ModelResponse;
62
+ /** Settings of {@link openAICompatibleModel} */
63
+ export interface OpenAICompatibleOptions {
64
+ /** Model id, e.g. "gpt-4o", "gpt-oss-120b" */
65
+ model: string;
66
+ /** API key, sent as `Authorization: Bearer …` (read it from your config, never hard-code it) */
67
+ apiKey?: string;
68
+ /** API base URL (default "https://api.openai.com/v1"; Cerebras "https://api.cerebras.ai/v1", Groq "https://api.groq.com/openai/v1") */
69
+ baseURL?: string;
70
+ /** Extra headers (e.g. Azure `api-key`) */
71
+ headers?: Record<string, string>;
72
+ /** Extra body fields (e.g. `temperature`, `reasoning_effort`) */
73
+ body?: Record<string, unknown>;
74
+ /** Name of the output-cap field when `maxTokens` is set (default "max_completion_tokens") */
75
+ maxTokensParam?: 'max_tokens' | 'max_completion_tokens';
76
+ /** Custom fetch (tests, proxies) */
77
+ fetch?: typeof fetch;
78
+ }
79
+ /** HTTP error from an OpenAI-compatible server (its `status` maps to the usual messages) */
80
+ export declare class OpenAICompatibleError extends Error {
81
+ readonly status: number;
82
+ constructor(status: number, message: string);
83
+ }
84
+ /**
85
+ * A `callModel` for any OpenAI-compatible Chat Completions endpoint, using
86
+ * `fetch` (no SDK). One request per turn, not streamed.
87
+ */
88
+ export declare function openAICompatibleModel(options: OpenAICompatibleOptions): ModelCall;
89
+ //# sourceMappingURL=openai-format.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"openai-format.d.ts","sourceRoot":"","sources":["../../src/providers/openai-format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAwB,MAAM,YAAY,CAAC;AAG/F,2GAA2G;AAC3G,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACzC,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,QAAQ,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC;IACzH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,gBAAgB,CAqBpE;AAID,wDAAwD;AACxD,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,KAAK,CAAC;QACd,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,OAAO,CAAC,EAAE;YACR,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;YACxB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;YACxB,UAAU,CAAC,EAAE,KAAK,CAAC;gBAAE,EAAE,CAAC,EAAE,MAAM,CAAC;gBAAC,IAAI,CAAC,EAAE,MAAM,CAAC;gBAAC,QAAQ,CAAC,EAAE;oBAAE,IAAI,CAAC,EAAE,MAAM,CAAC;oBAAC,SAAS,CAAC,EAAE,MAAM,CAAA;iBAAE,CAAA;aAAE,CAAC,GAAG,IAAI,CAAC;SAC7G,CAAC;KACH,CAAC,CAAC;IACH,KAAK,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAAC,qBAAqB,CAAC,EAAE;YAAE,aAAa,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;CAClI;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,UAAU,EAAE,oBAAoB,GAAG,aAAa,CAgB9E;AAED,gDAAgD;AAChD,MAAM,WAAW,uBAAuB;IACtC,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,gGAAgG;IAChG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uIAAuI;IACvI,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,iEAAiE;IACjE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,6FAA6F;IAC7F,cAAc,CAAC,EAAE,YAAY,GAAG,uBAAuB,CAAC;IACxD,oCAAoC;IACpC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED,4FAA4F;AAC5F,qBAAa,qBAAsB,SAAQ,KAAK;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAIrD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,uBAAuB,GAAG,SAAS,CA4BjF"}