@emabuild/ai 0.0.0-stage → 0.1.1

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.
@@ -0,0 +1 @@
1
+ {"version":3,"file":"prompt.js","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"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"}
package/dist/run.d.ts ADDED
@@ -0,0 +1,76 @@
1
+ import Anthropic from '@anthropic-ai/sdk';
2
+ import type { AIRequest, AIStreamEvent, FreeImage, FreeImageSearchOptions } from '@emabuild/types';
3
+ import { type ModelPricing } from './usage.js';
4
+ type StreamParams = Anthropic.Beta.Messages.MessageCreateParamsStreaming;
5
+ /** Request parameters shared by every turn of a run (everything except `messages`) */
6
+ export type RequestParams = Omit<StreamParams, 'messages' | 'stream'>;
7
+ /** Default model: Claude Opus 5.5 (the current Opus) */
8
+ export declare const DEFAULT_MODEL = "claude-opus-5-5";
9
+ /** Default per-response output cap (streamed, so large values are safe) */
10
+ export declare const DEFAULT_MAX_TOKENS = 64000;
11
+ /** Default cap on model round-trips per run */
12
+ export declare const DEFAULT_MAX_TURNS = 30;
13
+ /** Effort levels accepted by `output_config.effort` */
14
+ export type AIEffort = 'low' | 'medium' | 'high' | 'xhigh' | 'max';
15
+ /** Options for {@link runAI} */
16
+ export interface RunAIOptions {
17
+ /** Pre-configured Anthropic client (takes precedence over `apiKey`) */
18
+ client?: Anthropic;
19
+ /** API key; defaults to the SDK's credential resolution (ANTHROPIC_API_KEY, profiles…) */
20
+ apiKey?: string;
21
+ /** Model id (default {@link DEFAULT_MODEL}) */
22
+ model?: string;
23
+ /** Max output tokens per model response (default {@link DEFAULT_MAX_TOKENS}) */
24
+ maxTokens?: number;
25
+ /** Aborts the run and the in-flight model request */
26
+ signal?: AbortSignal;
27
+ /** Extra instructions appended to the built-in system prompt */
28
+ systemPrompt?: string;
29
+ /** Max model round-trips (default {@link DEFAULT_MAX_TURNS}) */
30
+ maxTurns?: number;
31
+ /**
32
+ * `output_config.effort` (default "medium"). Pass `null` to omit it, e.g. for
33
+ * models that do not support effort.
34
+ */
35
+ effort?: AIEffort | null;
36
+ /**
37
+ * Server-side refusal fallbacks (`fallbacks: "default"`). Defaults to true on
38
+ * models that support it on the Claude API; set false on Bedrock/Vertex/Foundry
39
+ * or behind proxies that reject beta parameters.
40
+ */
41
+ fallbacks?: boolean;
42
+ /**
43
+ * Request progress-update thinking blocks (`thinking.display: "updates"`) and
44
+ * forward them as `status` events. Defaults to true on models that support it.
45
+ */
46
+ progressUpdates?: boolean;
47
+ /**
48
+ * Free-image search behind the `search_images` tool. Defaults to Openverse
49
+ * (CC0 / public domain); pass a custom search, or `false` to disable the tool.
50
+ */
51
+ imageSearch?: ((query: string, options: FreeImageSearchOptions) => Promise<FreeImage[]>) | false;
52
+ /**
53
+ * Send a `usage` event (tokens + estimated cost) before `done` / `error`.
54
+ * Default true; set false to keep usage server side.
55
+ */
56
+ reportUsage?: boolean;
57
+ /** Prices (USD / 1M tokens) merged over the built-in Claude API list prices, keyed by model id */
58
+ pricing?: Record<string, ModelPricing>;
59
+ }
60
+ /**
61
+ * Builds the static request parameters for a run. Exported for testing and for
62
+ * callers that want to inspect what is sent.
63
+ */
64
+ export declare function buildRequestParams(request: AIRequest, options?: RunAIOptions): RequestParams;
65
+ /**
66
+ * Runs an AI request against Claude and streams editor events.
67
+ *
68
+ * The model edits the design through an `apply_operations` tool; each
69
+ * completed tool call is validated and yielded immediately as an
70
+ * `operations` event, so the editor can apply it live. Invalid batches are
71
+ * returned to the model as error tool results so it can fix them. The
72
+ * generator never throws for API errors — it yields an `error` event instead.
73
+ */
74
+ export declare function runAI(request: AIRequest, options?: RunAIOptions): AsyncGenerator<AIStreamEvent>;
75
+ export {};
76
+ //# sourceMappingURL=run.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAmB,SAAS,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAKpH,OAAO,EAA6B,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAI1E,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;AACxC,+CAA+C;AAC/C,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,uDAAuD;AACvD,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;AAEnE,gCAAgC;AAChC,MAAM,WAAW,YAAY;IAC3B,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,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,MAAM,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IACzB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,KAAK,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC;IACjG;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,kGAAkG;IAClG,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACxC;AAOD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,SAAS,EAClB,OAAO,GAAE,YAAiB,GACzB,aAAa,CAiCf;AAoBD;;;;;;;;GAQG;AACH,wBAAuB,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,GAAE,YAAiB,GAAG,cAAc,CAAC,aAAa,CAAC,CAS1G"}
package/dist/run.js ADDED
@@ -0,0 +1,349 @@
1
+ import Anthropic from '@anthropic-ai/sdk';
2
+ import { BASE_SYSTEM_PROMPT, buildSchemaPrompt, buildUserPrompt } from './prompt.js';
3
+ import { AI_TOOLS, APPLY_OPERATIONS_TOOL, FINISH_TOOL, SEARCH_IMAGES_TOOL } from './tools.js';
4
+ import { searchOpenverse } from '@emabuild/shared';
5
+ import { DesignState, validateOperations } from './validate.js';
6
+ import { MODEL_PRICING, UsageMeter } from './usage.js';
7
+ /** Default model: Claude Opus 5.5 (the current Opus) */
8
+ export const DEFAULT_MODEL = 'claude-opus-5-5';
9
+ /** Default per-response output cap (streamed, so large values are safe) */
10
+ export const DEFAULT_MAX_TOKENS = 64000;
11
+ /** Default cap on model round-trips per run */
12
+ export const DEFAULT_MAX_TURNS = 30;
13
+ const FALLBACK_MODELS = /^claude-(opus-5-5|opus-5|fable-5-1|sonnet-5-5)$/;
14
+ const UPDATES_MODELS = /^claude-(opus-5-5|fable-5-1|fable-5|mythos-5-1|sonnet-5-5)$/;
15
+ const INTERRUPTED_SENTINEL = 'This part of the response was interrupted before it finished.';
16
+ const MAX_STREAM_RETRIES = 2;
17
+ /**
18
+ * Builds the static request parameters for a run. Exported for testing and for
19
+ * callers that want to inspect what is sent.
20
+ */
21
+ export function buildRequestParams(request, options = {}) {
22
+ const model = options.model ?? DEFAULT_MODEL;
23
+ const fallbacks = options.fallbacks ?? FALLBACK_MODELS.test(model);
24
+ const updates = options.progressUpdates ?? UPDATES_MODELS.test(model);
25
+ const effort = options.effort === undefined ? 'medium' : options.effort;
26
+ const betas = [];
27
+ if (fallbacks)
28
+ betas.push('server-side-fallback-2026-07-01');
29
+ if (updates)
30
+ betas.push('thinking-display-updates-2026-08-18');
31
+ // Cache layout (render order tools → system → messages):
32
+ // 1. static base prompt (identical for every request)
33
+ // 2. schema description (stable per editor configuration)
34
+ // + top-level automatic caching for the growing conversation.
35
+ const system = [
36
+ { type: 'text', text: BASE_SYSTEM_PROMPT, cache_control: { type: 'ephemeral' } },
37
+ { type: 'text', text: buildSchemaPrompt(request), cache_control: { type: 'ephemeral' } },
38
+ ];
39
+ if (options.systemPrompt)
40
+ system.push({ type: 'text', text: `# Additional instructions\n${options.systemPrompt}` });
41
+ const params = {
42
+ model,
43
+ max_tokens: options.maxTokens ?? DEFAULT_MAX_TOKENS,
44
+ system,
45
+ tools: options.imageSearch === false ? AI_TOOLS.filter((t) => t.name !== SEARCH_IMAGES_TOOL) : AI_TOOLS,
46
+ tool_choice: { type: 'auto' },
47
+ cache_control: { type: 'ephemeral' },
48
+ };
49
+ if (betas.length > 0)
50
+ params.betas = betas;
51
+ if (fallbacks)
52
+ params.fallbacks = 'default';
53
+ if (updates)
54
+ params.thinking = { type: 'adaptive', display: 'updates' };
55
+ if (effort)
56
+ params.output_config = { effort };
57
+ return params;
58
+ }
59
+ function describeError(err) {
60
+ if (err instanceof Anthropic.AuthenticationError)
61
+ return 'Authentication with the AI provider failed (check the API key).';
62
+ if (err instanceof Anthropic.PermissionDeniedError)
63
+ return 'The API key is not allowed to use this model.';
64
+ if (err instanceof Anthropic.NotFoundError)
65
+ return `Model or endpoint not found: ${err.message}`;
66
+ if (err instanceof Anthropic.RateLimitError)
67
+ return 'The AI provider is rate limiting requests; please retry shortly.';
68
+ if (err instanceof Anthropic.BadRequestError)
69
+ return `Invalid request to the AI provider: ${err.message}`;
70
+ if (err instanceof Anthropic.APIConnectionError)
71
+ return 'Could not reach the AI provider.';
72
+ if (err instanceof Anthropic.APIError)
73
+ return `AI provider error${err.status ? ` ${err.status}` : ''}: ${err.message}`;
74
+ if (err instanceof Error)
75
+ return err.message;
76
+ return String(err);
77
+ }
78
+ /**
79
+ * Runs an AI request against Claude and streams editor events.
80
+ *
81
+ * The model edits the design through an `apply_operations` tool; each
82
+ * completed tool call is validated and yielded immediately as an
83
+ * `operations` event, so the editor can apply it live. Invalid batches are
84
+ * returned to the model as error tool results so it can fix them. The
85
+ * generator never throws for API errors — it yields an `error` event instead.
86
+ */
87
+ export async function* runAI(request, options = {}) {
88
+ const meter = new UsageMeter(options.pricing ? { ...MODEL_PRICING, ...options.pricing } : MODEL_PRICING);
89
+ for await (const event of runTurns(request, options, meter)) {
90
+ // Usage goes right before the terminal event, so clients have it when the run ends
91
+ if ((event.type === 'done' || event.type === 'error') && options.reportUsage !== false && meter.requests > 0) {
92
+ yield { type: 'usage', usage: meter.summary(options.model ?? DEFAULT_MODEL) };
93
+ }
94
+ yield event;
95
+ }
96
+ }
97
+ /** The model loop behind {@link runAI}; records every response in `meter` */
98
+ async function* runTurns(request, options, meter) {
99
+ const { signal } = options;
100
+ let client;
101
+ try {
102
+ client = options.client ?? new Anthropic(options.apiKey ? { apiKey: options.apiKey } : {});
103
+ }
104
+ catch (err) {
105
+ yield { type: 'error', error: describeError(err) };
106
+ return;
107
+ }
108
+ let params;
109
+ let messages;
110
+ try {
111
+ params = buildRequestParams(request, options);
112
+ messages = [{ role: 'user', content: buildUserPrompt(request) }];
113
+ }
114
+ catch (err) {
115
+ yield { type: 'error', error: `Invalid AI request: ${describeError(err)}` };
116
+ return;
117
+ }
118
+ let state = new DesignState(request.design, request.schema);
119
+ const maxTurns = options.maxTurns ?? DEFAULT_MAX_TURNS;
120
+ let lastStatus = '';
121
+ let lastMessage;
122
+ let summary;
123
+ let finished = false;
124
+ let retries = 0;
125
+ let ended = false;
126
+ const status = (message) => {
127
+ if (!message || message === lastStatus)
128
+ return null;
129
+ lastStatus = message;
130
+ return { type: 'status', message };
131
+ };
132
+ const first = status(request.action === 'generate' ? 'Designing your email…' : 'Working on your request…');
133
+ if (first)
134
+ yield first;
135
+ for (let turn = 0; turn < maxTurns && !finished; turn++) {
136
+ if (signal?.aborted) {
137
+ yield { type: 'error', error: 'Request aborted' };
138
+ return;
139
+ }
140
+ const results = new Map();
141
+ const pending = new Map();
142
+ const thinking = new Map();
143
+ const texts = new Map();
144
+ let emittedThisTurn = false;
145
+ let message;
146
+ try {
147
+ const stream = client.beta.messages.stream({ ...params, messages }, { signal });
148
+ for await (const event of stream) {
149
+ if (event.type === 'content_block_start') {
150
+ const block = event.content_block;
151
+ if (block.type === 'tool_use') {
152
+ pending.set(event.index, { id: block.id, name: block.name, json: '' });
153
+ if (block.name === APPLY_OPERATIONS_TOOL) {
154
+ const s = status('Updating the design…');
155
+ if (s)
156
+ yield s;
157
+ }
158
+ }
159
+ else if (block.type === 'text') {
160
+ texts.set(event.index, block.text ?? '');
161
+ }
162
+ else if (block.type === 'thinking') {
163
+ thinking.set(event.index, '');
164
+ }
165
+ }
166
+ else if (event.type === 'content_block_delta') {
167
+ const d = event.delta;
168
+ if (d.type === 'text_delta')
169
+ texts.set(event.index, (texts.get(event.index) ?? '') + d.text);
170
+ else if (d.type === 'thinking_delta')
171
+ thinking.set(event.index, (thinking.get(event.index) ?? '') + d.thinking);
172
+ else if (d.type === 'input_json_delta') {
173
+ const p = pending.get(event.index);
174
+ if (p)
175
+ p.json += d.partial_json;
176
+ }
177
+ }
178
+ else if (event.type === 'content_block_stop') {
179
+ const text = texts.get(event.index);
180
+ if (text !== undefined) {
181
+ texts.delete(event.index);
182
+ if (text.trim()) {
183
+ lastMessage = text.trim();
184
+ yield { type: 'message', text: lastMessage };
185
+ }
186
+ continue;
187
+ }
188
+ const note = thinking.get(event.index);
189
+ if (note !== undefined) {
190
+ thinking.delete(event.index);
191
+ // Under display "updates" any non-empty thinking block is a progress update.
192
+ const trimmed = note.trim();
193
+ if (trimmed && trimmed !== INTERRUPTED_SENTINEL) {
194
+ const s = status(trimmed);
195
+ if (s)
196
+ yield s;
197
+ }
198
+ continue;
199
+ }
200
+ const tool = pending.get(event.index);
201
+ if (!tool)
202
+ continue;
203
+ pending.delete(event.index);
204
+ if (tool.name === SEARCH_IMAGES_TOOL) {
205
+ const s = status('Looking for free images…');
206
+ if (s)
207
+ yield s;
208
+ results.set(tool.id, await searchImagesResult(tool, options));
209
+ continue;
210
+ }
211
+ const outcome = handleToolCall(tool, state);
212
+ results.set(tool.id, outcome.result);
213
+ if (outcome.state)
214
+ state = outcome.state;
215
+ if (outcome.operations) {
216
+ emittedThisTurn = true;
217
+ yield { type: 'operations', operations: outcome.operations };
218
+ }
219
+ if (outcome.summary !== undefined) {
220
+ summary = outcome.summary;
221
+ finished = true;
222
+ }
223
+ }
224
+ }
225
+ message = await stream.finalMessage();
226
+ meter.add(message.model, message.usage);
227
+ retries = 0;
228
+ }
229
+ catch (err) {
230
+ if (signal?.aborted || err instanceof Anthropic.APIUserAbortError) {
231
+ yield { type: 'error', error: 'Request aborted' };
232
+ return;
233
+ }
234
+ // Typed API errors are reported as-is; anything else (e.g. a tool input
235
+ // the SDK could not parse) is retried once or twice if this turn has not
236
+ // already changed the canvas.
237
+ if (err instanceof Anthropic.APIError || emittedThisTurn || retries >= MAX_STREAM_RETRIES) {
238
+ yield { type: 'error', error: describeError(err) };
239
+ return;
240
+ }
241
+ retries++;
242
+ finished = false;
243
+ turn--;
244
+ continue;
245
+ }
246
+ if (message.stop_reason === 'refusal') {
247
+ yield { type: 'error', error: 'The AI model declined this request.' };
248
+ return;
249
+ }
250
+ messages.push({ role: 'assistant', content: message.content });
251
+ const toolUses = message.content.filter((b) => b.type === 'tool_use');
252
+ if (message.stop_reason === 'pause_turn')
253
+ continue;
254
+ if (finished)
255
+ break;
256
+ if (toolUses.length === 0) {
257
+ ended = true; // end_turn / max_tokens without tool calls
258
+ break;
259
+ }
260
+ const truncated = message.stop_reason === 'max_tokens';
261
+ const toolResults = toolUses.map((use) => {
262
+ const existing = results.get(use.id);
263
+ if (existing)
264
+ return existing;
265
+ return {
266
+ type: 'tool_result',
267
+ tool_use_id: use.id,
268
+ is_error: true,
269
+ content: truncated
270
+ ? 'Your response hit the output token limit and this tool call was cut off; nothing from it was applied. Send smaller batches.'
271
+ : 'Tool call could not be processed; nothing was applied. Please retry.',
272
+ };
273
+ });
274
+ messages.push({ role: 'user', content: toolResults });
275
+ }
276
+ if (!finished && !ended) {
277
+ const s = status('Stopped after reaching the maximum number of steps.');
278
+ if (s)
279
+ yield s;
280
+ }
281
+ yield summary !== undefined || lastMessage !== undefined
282
+ ? { type: 'done', summary: summary ?? lastMessage }
283
+ : { type: 'done' };
284
+ }
285
+ function errorResult(id, content) {
286
+ return { type: 'tool_result', tool_use_id: id, is_error: true, content };
287
+ }
288
+ const defaultImageSearch = async (query, options) => (await searchOpenverse(query, options)).images;
289
+ /** Runs a `search_images` call; failures go back to the model so it can fall back to placeholders */
290
+ async function searchImagesResult(tool, options) {
291
+ let args = {};
292
+ try {
293
+ args = tool.json.trim() ? JSON.parse(tool.json) : {};
294
+ }
295
+ catch {
296
+ return errorResult(tool.id, JSON.stringify({ INVALID_JSON: tool.json }));
297
+ }
298
+ const query = typeof args.query === 'string' ? args.query.trim() : '';
299
+ if (!query)
300
+ return errorResult(tool.id, '`query` is required.');
301
+ const orientation = ['landscape', 'portrait', 'square'].includes(args.orientation)
302
+ ? args.orientation : undefined;
303
+ const count = Math.min(Math.max(Number(args.count) || 5, 1), 10);
304
+ const search = options.imageSearch || defaultImageSearch;
305
+ try {
306
+ const images = (await search(query, { orientation, count, signal: options.signal })).slice(0, count);
307
+ if (!images.length)
308
+ return { type: 'tool_result', tool_use_id: tool.id, content: 'No results. Try a broader query, or use a placeholder.' };
309
+ const compact = images.map(({ url, width, height, title }) => ({ url, width, height, title }));
310
+ return { type: 'tool_result', tool_use_id: tool.id, content: JSON.stringify(compact) };
311
+ }
312
+ catch (err) {
313
+ return errorResult(tool.id, `Image search failed (${describeError(err)}). Use placeholders instead.`);
314
+ }
315
+ }
316
+ function handleToolCall(tool, state) {
317
+ let input;
318
+ try {
319
+ input = tool.json.trim() ? JSON.parse(tool.json) : {};
320
+ }
321
+ catch {
322
+ return { result: errorResult(tool.id, JSON.stringify({ INVALID_JSON: tool.json })) };
323
+ }
324
+ const args = (input && typeof input === 'object' ? input : {});
325
+ if (tool.name === APPLY_OPERATIONS_TOOL) {
326
+ const v = validateOperations(args.operations, state);
327
+ if (!v.ok) {
328
+ return {
329
+ result: errorResult(tool.id, `Batch rejected, nothing was applied. Fix these problems and send the whole batch again:\n- ${v.errors.join('\n- ')}`),
330
+ };
331
+ }
332
+ const refs = v.state.describeRefs();
333
+ return {
334
+ operations: v.operations,
335
+ state: v.state,
336
+ result: {
337
+ type: 'tool_result',
338
+ tool_use_id: tool.id,
339
+ content: `Applied ${v.operations.length} operation${v.operations.length === 1 ? '' : 's'}.${refs.length ? ` Available refs: ${refs.join('; ')}.` : ''}`,
340
+ },
341
+ };
342
+ }
343
+ if (tool.name === FINISH_TOOL) {
344
+ const summary = typeof args.summary === 'string' ? args.summary.trim() : '';
345
+ return { summary, result: { type: 'tool_result', tool_use_id: tool.id, content: 'Done.' } };
346
+ }
347
+ return { result: errorResult(tool.id, `Unknown tool "${tool.name}".`) };
348
+ }
349
+ //# sourceMappingURL=run.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"run.js","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,27 @@
1
+ import type Anthropic from '@anthropic-ai/sdk';
2
+ /** Name of the tool the model uses to edit the design */
3
+ export declare const APPLY_OPERATIONS_TOOL = "apply_operations";
4
+ /** Name of the tool the model uses to find free stock photos */
5
+ export declare const SEARCH_IMAGES_TOOL = "search_images";
6
+ /** Name of the tool the model calls when it is done */
7
+ export declare const FINISH_TOOL = "finish";
8
+ /** JSON schema mirroring the DesignOperation union */
9
+ export declare const OPERATION_SCHEMA: {
10
+ anyOf: {
11
+ type: string;
12
+ description: string;
13
+ properties: {
14
+ op: {
15
+ type: string;
16
+ const: string;
17
+ };
18
+ };
19
+ required: string[];
20
+ }[];
21
+ };
22
+ /**
23
+ * Tool definitions sent to Claude. Kept deterministic (stable order and
24
+ * content) so the tools prefix stays prompt-cacheable across requests.
25
+ */
26
+ export declare const AI_TOOLS: Anthropic.Beta.Messages.BetaTool[];
27
+ //# sourceMappingURL=tools.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAC;AAE/C,yDAAyD;AACzD,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AACxD,gEAAgE;AAChE,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAClD,uDAAuD;AACvD,eAAO,MAAM,WAAW,WAAW,CAAC;AA6BpC,sDAAsD;AACtD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;CAiF5B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAyCtD,CAAC"}
package/dist/tools.js ADDED
@@ -0,0 +1,127 @@
1
+ /** Name of the tool the model uses to edit the design */
2
+ export const APPLY_OPERATIONS_TOOL = 'apply_operations';
3
+ /** Name of the tool the model uses to find free stock photos */
4
+ export const SEARCH_IMAGES_TOOL = 'search_images';
5
+ /** Name of the tool the model calls when it is done */
6
+ export const FINISH_TOOL = 'finish';
7
+ const values = (description) => ({
8
+ type: 'object',
9
+ description,
10
+ additionalProperties: true,
11
+ });
12
+ const str = (description) => ({ type: 'string', description });
13
+ const int = (description) => ({ type: 'integer', minimum: 0, description });
14
+ function op(name, description, properties, required = []) {
15
+ return {
16
+ type: 'object',
17
+ description,
18
+ properties: { op: { type: 'string', const: name }, ...properties },
19
+ required: ['op', ...required],
20
+ };
21
+ }
22
+ const contentSpec = {
23
+ type: 'object',
24
+ properties: {
25
+ type: str('Tool name from the schema, e.g. "heading", "text", "button", "image"'),
26
+ values: values('Only the property keys to change; defaults fill the rest'),
27
+ },
28
+ required: ['type'],
29
+ };
30
+ /** JSON schema mirroring the DesignOperation union */
31
+ export const OPERATION_SCHEMA = {
32
+ anyOf: [
33
+ op('addRow', 'Append (or insert at `index`) a row with `cells` column proportions. Optionally pre-fill columns and their contents. Set `ref` to target the row later; its columns are then "<ref>:<columnIndex>".', {
34
+ cells: { type: 'array', items: { type: 'number', exclusiveMinimum: 0 }, minItems: 1, maxItems: 6 },
35
+ index: int('Insert position within the section (default: end)'),
36
+ section: { type: 'string', enum: ['rows', 'headers', 'footers'] },
37
+ values: values('Row property values to set'),
38
+ columns: {
39
+ type: 'array',
40
+ description: 'One entry per cell, in order',
41
+ items: {
42
+ type: 'object',
43
+ properties: {
44
+ values: values('Column property values to set'),
45
+ contents: { type: 'array', items: contentSpec },
46
+ },
47
+ },
48
+ },
49
+ ref: str('Unique reference name for this row, e.g. "hero"'),
50
+ }, ['cells']),
51
+ op('removeRow', 'Delete a row', { rowId: str('Row id or row ref') }, ['rowId']),
52
+ op('moveRow', 'Move a row to a new index', { rowId: str('Row id or row ref'), toIndex: int('Target index') }, [
53
+ 'rowId',
54
+ 'toIndex',
55
+ ]),
56
+ op('duplicateRow', 'Duplicate a row', { rowId: str('Row id or row ref') }, ['rowId']),
57
+ op('updateRow', 'Change row properties', { rowId: str('Row id or row ref'), values: values('Row values') }, [
58
+ 'rowId',
59
+ 'values',
60
+ ]),
61
+ op('updateColumn', 'Change column properties', { columnId: str('Column id or "<rowRef>:<columnIndex>"'), values: values('Column values') }, ['columnId', 'values']),
62
+ op('addContent', 'Add a content block to a column. Set `ref` to target the block later.', {
63
+ columnId: str('Column id or "<rowRef>:<columnIndex>"'),
64
+ index: int('Position within the column (default: end)'),
65
+ type: str('Tool name from the schema'),
66
+ values: values('Only the property keys to change; defaults fill the rest'),
67
+ ref: str('Unique reference name for this block'),
68
+ }, ['columnId', 'type']),
69
+ op('updateContent', 'Change properties of a content block (merged into its values)', { contentId: str('Content id or content ref'), values: values('Values to change') }, ['contentId', 'values']),
70
+ op('removeContent', 'Delete a content block', { contentId: str('Content id or content ref') }, ['contentId']),
71
+ op('moveContent', 'Move a content block to a column/index', {
72
+ contentId: str('Content id or content ref'),
73
+ columnId: str('Column id or "<rowRef>:<columnIndex>"'),
74
+ index: int('Position within the target column'),
75
+ }, ['contentId', 'columnId', 'index']),
76
+ op('duplicateContent', 'Duplicate a content block', { contentId: str('Content id or content ref') }, ['contentId']),
77
+ op('updateBody', 'Change global body properties (background, width, font…)', { values: values('Body values') }, [
78
+ 'values',
79
+ ]),
80
+ op('replaceDesign', 'Replace the whole design JSON. Last resort only: prefer incremental operations.', { design: { type: 'object', additionalProperties: true } }, ['design']),
81
+ ],
82
+ };
83
+ /**
84
+ * Tool definitions sent to Claude. Kept deterministic (stable order and
85
+ * content) so the tools prefix stays prompt-cacheable across requests.
86
+ */
87
+ export const AI_TOOLS = [
88
+ {
89
+ name: APPLY_OPERATIONS_TOOL,
90
+ description: 'Apply a batch of design operations to the email on the user\'s canvas. The batch is applied atomically as one undo step and shown live. ' +
91
+ 'Prefer several small batches (e.g. one row per call) over one huge batch. Invalid batches are rejected entirely with an error explaining what to fix; nothing from a rejected batch is applied.',
92
+ input_schema: {
93
+ type: 'object',
94
+ properties: {
95
+ operations: { type: 'array', minItems: 1, items: OPERATION_SCHEMA },
96
+ note: { type: 'string', description: 'Optional short note about what this batch does' },
97
+ },
98
+ required: ['operations'],
99
+ },
100
+ },
101
+ {
102
+ name: SEARCH_IMAGES_TOOL,
103
+ description: 'Search free stock photos (public domain / CC0, no attribution needed) to use in image blocks or backgrounds. ' +
104
+ 'Returns up to `count` results as JSON with url, width, height and title. Use short English queries.',
105
+ input_schema: {
106
+ type: 'object',
107
+ properties: {
108
+ query: { type: 'string', description: 'What the photo should show, in English, e.g. "autumn forest path"' },
109
+ orientation: { type: 'string', enum: ['landscape', 'portrait', 'square'] },
110
+ count: { type: 'integer', minimum: 1, maximum: 10, description: 'Results to return (default 5)' },
111
+ },
112
+ required: ['query'],
113
+ },
114
+ },
115
+ {
116
+ name: FINISH_TOOL,
117
+ description: 'Call once when the work is complete. The summary is shown to the user.',
118
+ input_schema: {
119
+ type: 'object',
120
+ properties: {
121
+ summary: { type: 'string', description: '1-2 sentences, in the language of the copy, describing what was done' },
122
+ },
123
+ required: ['summary'],
124
+ },
125
+ },
126
+ ];
127
+ //# sourceMappingURL=tools.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}