@emabuild/ai 0.1.1 → 0.9.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 (45) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +139 -13
  3. package/dist/cli.js +45 -7
  4. package/dist/cli.js.map +1 -1
  5. package/dist/handler.d.ts +3 -2
  6. package/dist/handler.d.ts.map +1 -1
  7. package/dist/handler.js +4 -1
  8. package/dist/handler.js.map +1 -1
  9. package/dist/index.d.ts +9 -2
  10. package/dist/index.d.ts.map +1 -1
  11. package/dist/index.js +9 -2
  12. package/dist/index.js.map +1 -1
  13. package/dist/loop.d.ts +26 -0
  14. package/dist/loop.d.ts.map +1 -0
  15. package/dist/loop.js +215 -0
  16. package/dist/loop.js.map +1 -0
  17. package/dist/providers/anthropic.d.ts +58 -0
  18. package/dist/providers/anthropic.d.ts.map +1 -0
  19. package/dist/providers/anthropic.js +217 -0
  20. package/dist/providers/anthropic.js.map +1 -0
  21. package/dist/providers/errors.d.ts +12 -0
  22. package/dist/providers/errors.d.ts.map +1 -0
  23. package/dist/providers/errors.js +39 -0
  24. package/dist/providers/errors.js.map +1 -0
  25. package/dist/providers/model-call.d.ts +17 -0
  26. package/dist/providers/model-call.d.ts.map +1 -0
  27. package/dist/providers/model-call.js +117 -0
  28. package/dist/providers/model-call.js.map +1 -0
  29. package/dist/providers/openai-format.d.ts +125 -0
  30. package/dist/providers/openai-format.d.ts.map +1 -0
  31. package/dist/providers/openai-format.js +214 -0
  32. package/dist/providers/openai-format.js.map +1 -0
  33. package/dist/providers/types.d.ts +193 -0
  34. package/dist/providers/types.d.ts.map +1 -0
  35. package/dist/providers/types.js +22 -0
  36. package/dist/providers/types.js.map +1 -0
  37. package/dist/run.d.ts +40 -38
  38. package/dist/run.d.ts.map +1 -1
  39. package/dist/run.js +44 -323
  40. package/dist/run.js.map +1 -1
  41. package/dist/usage.d.ts +7 -1
  42. package/dist/usage.d.ts.map +1 -1
  43. package/dist/usage.js +35 -6
  44. package/dist/usage.js.map +1 -1
  45. package/package.json +24 -8
package/dist/loop.js ADDED
@@ -0,0 +1,215 @@
1
+ /**
2
+ * @module loop
3
+ *
4
+ * The provider-agnostic agent loop: it owns the flow (prompts, tools,
5
+ * validation, retries, turn limit, editor events) and asks a
6
+ * {@link ModelAdapter} for each model turn. The `AIStreamEvent`s it yields are
7
+ * the editor's NDJSON protocol, identical whatever model answers.
8
+ */
9
+ import { searchFreeImages } from '@emabuild/shared';
10
+ import { buildUserPrompt } from './prompt.js';
11
+ import { APPLY_OPERATIONS_TOOL, FINISH_TOOL, SEARCH_IMAGES_TOOL } from './tools.js';
12
+ import { DesignState, validateOperations } from './validate.js';
13
+ import { describeAnyError } from './providers/errors.js';
14
+ /** Retries of a turn whose stream failed for a non-API reason (only if it changed nothing yet) */
15
+ export const MAX_STREAM_RETRIES = 2;
16
+ const defaultImageSearch = async (query, options) => (await searchFreeImages(query, options)).images;
17
+ const errorResult = (id, content) => ({ id, content, isError: true });
18
+ /** Parse tool arguments; `null` when the JSON is invalid */
19
+ function parseArgs(json) {
20
+ try {
21
+ const v = json.trim() ? JSON.parse(json) : {};
22
+ return v && typeof v === 'object' ? v : {};
23
+ }
24
+ catch {
25
+ return null;
26
+ }
27
+ }
28
+ /** Runs a `search_images` call; failures go back to the model so it can fall back to placeholders */
29
+ async function searchImagesResult(call, options, describe) {
30
+ const args = parseArgs(call.arguments);
31
+ if (!args)
32
+ return errorResult(call.id, JSON.stringify({ INVALID_JSON: call.arguments }));
33
+ const query = typeof args.query === 'string' ? args.query.trim() : '';
34
+ if (!query)
35
+ return errorResult(call.id, '`query` is required.');
36
+ const orientation = ['landscape', 'portrait', 'square'].includes(args.orientation)
37
+ ? args.orientation : undefined;
38
+ const count = Math.min(Math.max(Number(args.count) || 5, 1), 10);
39
+ const search = options.imageSearch || defaultImageSearch;
40
+ try {
41
+ const images = (await search(query, { orientation, count, signal: options.settings.signal })).slice(0, count);
42
+ if (!images.length)
43
+ return { id: call.id, content: 'No results. Try a broader query, or use a placeholder.' };
44
+ const compact = images.map(({ url, width, height, title }) => ({ url, width, height, title }));
45
+ return { id: call.id, content: JSON.stringify(compact) };
46
+ }
47
+ catch (err) {
48
+ return errorResult(call.id, `Image search failed (${describe(err)}). Use placeholders instead.`);
49
+ }
50
+ }
51
+ function handleToolCall(call, state) {
52
+ const args = parseArgs(call.arguments);
53
+ if (!args)
54
+ return { result: errorResult(call.id, JSON.stringify({ INVALID_JSON: call.arguments })) };
55
+ if (call.name === APPLY_OPERATIONS_TOOL) {
56
+ const v = validateOperations(args.operations, state);
57
+ if (!v.ok) {
58
+ return {
59
+ result: errorResult(call.id, `Batch rejected, nothing was applied. Fix these problems and send the whole batch again:\n- ${v.errors.join('\n- ')}`),
60
+ };
61
+ }
62
+ const refs = v.state.describeRefs();
63
+ return {
64
+ operations: v.operations,
65
+ state: v.state,
66
+ result: {
67
+ id: call.id,
68
+ content: `Applied ${v.operations.length} operation${v.operations.length === 1 ? '' : 's'}.${refs.length ? ` Available refs: ${refs.join('; ')}.` : ''}`,
69
+ },
70
+ };
71
+ }
72
+ if (call.name === FINISH_TOOL) {
73
+ const summary = typeof args.summary === 'string' ? args.summary.trim() : '';
74
+ return { summary, result: { id: call.id, content: 'Done.' } };
75
+ }
76
+ return { result: errorResult(call.id, `Unknown tool "${call.name}".`) };
77
+ }
78
+ /**
79
+ * Run the agent loop with `adapter`. Never throws: problems end the run with
80
+ * an `error` event. Usage of every completed turn is recorded in `meter`.
81
+ */
82
+ export async function* runLoop(adapter, request, options, meter) {
83
+ const { settings } = options;
84
+ const signal = settings.signal;
85
+ const describe = (err) => adapter.describeError(err) ?? describeAnyError(err);
86
+ const isAbort = (err) => signal?.aborted || adapter.isAbortError(err);
87
+ const fatal = (err) => err?.fatal === true;
88
+ let conversation;
89
+ try {
90
+ conversation = await adapter.createConversation(buildUserPrompt(request), settings);
91
+ }
92
+ catch (err) {
93
+ yield { type: 'error', error: fatal(err) || adapter.isProviderError(err) ? describe(err) : `Invalid AI request: ${describe(err)}` };
94
+ return;
95
+ }
96
+ let state = new DesignState(request.design, request.schema);
97
+ let lastStatus = '';
98
+ let lastMessage;
99
+ let summary;
100
+ let finished = false;
101
+ let retries = 0;
102
+ let ended = false;
103
+ const status = (message) => {
104
+ if (!message || message === lastStatus)
105
+ return null;
106
+ lastStatus = message;
107
+ return { type: 'status', message };
108
+ };
109
+ const first = status(request.action === 'generate' ? 'Designing your email…' : 'Working on your request…');
110
+ if (first)
111
+ yield first;
112
+ for (let turn = 0; turn < options.maxTurns && !finished; turn++) {
113
+ if (signal?.aborted) {
114
+ yield { type: 'error', error: 'Request aborted' };
115
+ return;
116
+ }
117
+ const results = new Map();
118
+ let emittedThisTurn = false;
119
+ let stop = { reason: 'end', toolCallIds: [] };
120
+ try {
121
+ for await (const ev of adapter.streamTurn(conversation, settings)) {
122
+ if (ev.type === 'text') {
123
+ if (ev.text.trim()) {
124
+ lastMessage = ev.text.trim();
125
+ yield { type: 'message', text: lastMessage };
126
+ }
127
+ }
128
+ else if (ev.type === 'status') {
129
+ const s = status(ev.text);
130
+ if (s)
131
+ yield s;
132
+ }
133
+ else if (ev.type === 'toolStart') {
134
+ if (ev.name === APPLY_OPERATIONS_TOOL) {
135
+ const s = status('Updating the design…');
136
+ if (s)
137
+ yield s;
138
+ }
139
+ }
140
+ else if (ev.type === 'toolCall') {
141
+ const call = ev.call;
142
+ if (call.name === SEARCH_IMAGES_TOOL) {
143
+ const s = status('Looking for free images…');
144
+ if (s)
145
+ yield s;
146
+ results.set(call.id, await searchImagesResult(call, options, describe));
147
+ continue;
148
+ }
149
+ const outcome = handleToolCall(call, state);
150
+ results.set(call.id, outcome.result);
151
+ if (outcome.state)
152
+ state = outcome.state;
153
+ if (outcome.operations) {
154
+ emittedThisTurn = true;
155
+ yield { type: 'operations', operations: outcome.operations };
156
+ }
157
+ if (outcome.summary !== undefined) {
158
+ summary = outcome.summary;
159
+ finished = true;
160
+ }
161
+ }
162
+ else if (ev.type === 'usage') {
163
+ meter.record(ev.model, ev.usage);
164
+ }
165
+ else if (ev.type === 'stop') {
166
+ stop = { reason: ev.reason, toolCallIds: ev.toolCallIds };
167
+ }
168
+ }
169
+ retries = 0;
170
+ }
171
+ catch (err) {
172
+ if (isAbort(err)) {
173
+ yield { type: 'error', error: 'Request aborted' };
174
+ return;
175
+ }
176
+ // Provider API errors are reported as-is; anything else (e.g. a tool input
177
+ // the SDK could not parse) is retried once or twice if this turn has not
178
+ // already changed the canvas.
179
+ if (fatal(err) || adapter.isProviderError(err) || emittedThisTurn || retries >= MAX_STREAM_RETRIES) {
180
+ yield { type: 'error', error: describe(err) };
181
+ return;
182
+ }
183
+ retries++;
184
+ finished = false;
185
+ turn--;
186
+ continue;
187
+ }
188
+ if (stop.reason === 'refusal') {
189
+ yield { type: 'error', error: 'The AI model declined this request.' };
190
+ return;
191
+ }
192
+ adapter.commitAssistantTurn(conversation);
193
+ if (stop.reason === 'pause')
194
+ continue;
195
+ if (finished)
196
+ break;
197
+ if (stop.toolCallIds.length === 0) {
198
+ ended = true; // end of turn / max_tokens without tool calls
199
+ break;
200
+ }
201
+ const truncated = stop.reason === 'max_tokens';
202
+ adapter.addToolResults(conversation, stop.toolCallIds.map((id) => results.get(id) ?? errorResult(id, truncated
203
+ ? 'Your response hit the output token limit and this tool call was cut off; nothing from it was applied. Send smaller batches.'
204
+ : 'Tool call could not be processed; nothing was applied. Please retry.')));
205
+ }
206
+ if (!finished && !ended) {
207
+ const s = status('Stopped after reaching the maximum number of steps.');
208
+ if (s)
209
+ yield s;
210
+ }
211
+ yield summary !== undefined || lastMessage !== undefined
212
+ ? { type: 'done', summary: summary ?? lastMessage }
213
+ : { type: 'done' };
214
+ }
215
+ //# sourceMappingURL=loop.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"loop.js","sourceRoot":"","sources":["../src/loop.ts"],"names":[],"mappings":"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"}
@@ -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,EAAgB,mBAAmB,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,EAA4C,MAAM,YAAY,CAAC;AAEtJ,UAAU,YAAY;IACpB,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,+CAA+C;IAC/C,IAAI,CAAC,EAAE,aAAa,CAAC;CACtB;AAyDD,sDAAsD;AACtD,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,SAAW,GAAG,YAAY,CAAC,YAAY,CAAC,CAoDvG"}