genaicode 2.31.0 → 2.33.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 (58) hide show
  1. package/README.md +1 -0
  2. package/dist/agents/artifacts.d.ts +16 -6
  3. package/dist/agents/artifacts.js +74 -23
  4. package/dist/agents/artifacts.js.map +1 -1
  5. package/dist/agents/handoff.d.ts +14 -3
  6. package/dist/agents/handoff.js +55 -5
  7. package/dist/agents/handoff.js.map +1 -1
  8. package/dist/agents/session.d.ts +11 -0
  9. package/dist/agents/session.js +22 -5
  10. package/dist/agents/session.js.map +1 -1
  11. package/dist/agents/types.d.ts +2 -2
  12. package/dist/agents.d.ts +1 -1
  13. package/dist/app-agent/http.js +2 -2
  14. package/dist/app-agent/http.js.map +1 -1
  15. package/dist/browser/fake-model.d.ts +43 -0
  16. package/dist/browser/fake-model.js +133 -0
  17. package/dist/browser/fake-model.js.map +1 -0
  18. package/dist/browser/language-model.d.ts +74 -0
  19. package/dist/browser/language-model.js +83 -0
  20. package/dist/browser/language-model.js.map +1 -0
  21. package/dist/browser/nano.d.ts +83 -0
  22. package/dist/browser/nano.js +610 -0
  23. package/dist/browser/nano.js.map +1 -0
  24. package/dist/browser/page-agent.d.ts +74 -0
  25. package/dist/browser/page-agent.js +339 -0
  26. package/dist/browser/page-agent.js.map +1 -0
  27. package/dist/browser/tools.d.ts +36 -0
  28. package/dist/browser/tools.js +190 -0
  29. package/dist/browser/tools.js.map +1 -0
  30. package/dist/browser/webmcp.d.ts +32 -0
  31. package/dist/browser/webmcp.js +150 -0
  32. package/dist/browser/webmcp.js.map +1 -0
  33. package/dist/browser.d.ts +39 -0
  34. package/dist/browser.js +32 -0
  35. package/dist/browser.js.map +1 -0
  36. package/dist/react/agent-chat.css +174 -0
  37. package/dist/react/agent-chat.d.ts +23 -2
  38. package/dist/react/agent-chat.js +114 -13
  39. package/dist/react/agent-chat.js.map +1 -1
  40. package/dist/react/app-agent-chat.d.ts +2 -0
  41. package/dist/react/app-agent-chat.js +1 -1
  42. package/dist/react/app-agent-chat.js.map +1 -1
  43. package/dist/react/attachments.d.ts +41 -0
  44. package/dist/react/attachments.js +162 -0
  45. package/dist/react/attachments.js.map +1 -0
  46. package/dist/react/page-agent-chat.d.ts +38 -0
  47. package/dist/react/page-agent-chat.js +40 -0
  48. package/dist/react/page-agent-chat.js.map +1 -0
  49. package/dist/react.d.ts +7 -2
  50. package/dist/react.js +3 -1
  51. package/dist/react.js.map +1 -1
  52. package/dist/ui/index.js +82 -78
  53. package/dist/ui/web-client.js +187 -12
  54. package/docs/agents.md +26 -4
  55. package/docs/browser.md +200 -0
  56. package/docs/react.md +14 -13
  57. package/docs/semver.md +2 -0
  58. package/package.json +5 -1
@@ -0,0 +1,74 @@
1
+ import type { SessionState } from '../agents/session.js';
2
+ import type { ApprovalDecision, ApprovalRequest, CodingAgent } from '../agents/types.js';
3
+ import type { LanguageModelAvailability, LanguageModelMedia } from './language-model.js';
4
+ import { type NanoOptions } from './nano.js';
5
+ import type { PageTool } from './tools.js';
6
+ export interface PageAgentOptions {
7
+ /** What the assistant is called in the chat. Default `nano`. */
8
+ name?: string;
9
+ /** Who the assistant is and what the page is about. */
10
+ instructions?: string;
11
+ /** What the assistant may do on the page. */
12
+ tools?: readonly PageTool[];
13
+ /** Options for the built-in model driver, when `agent` is not given. */
14
+ nano?: Omit<NanoOptions, 'tools' | 'instructions' | 'name' | 'onDownload'>;
15
+ /**
16
+ * The agent to run instead of `nano()`: anything that implements `CodingAgent` in the browser.
17
+ * It gets no tools from here; give it its own.
18
+ */
19
+ agent?: CodingAgent;
20
+ /**
21
+ * Decide a `write` tool's approval without asking. Return undefined to leave it to the user
22
+ * (`approve()`), which is also what happens without this.
23
+ */
24
+ autoApprove?(request: ApprovalRequest): ApprovalDecision | undefined;
25
+ }
26
+ /** `checking`: not known yet. `loading`: the model is being read into memory. */
27
+ export type PageModelStatus = LanguageModelAvailability | 'checking' | 'loading';
28
+ export interface PageAgentState {
29
+ /** The conversation, in the shape `<AgentChat>` draws. */
30
+ session: SessionState;
31
+ model: {
32
+ status: PageModelStatus;
33
+ /** Download progress, 0 to 1, while `status` is `downloading`. */
34
+ progress?: number;
35
+ /** What the model takes besides text and text files (`nano.inputs`), once known. */
36
+ inputs?: LanguageModelMedia[];
37
+ };
38
+ /** Tokens in use and the size of the model's context window, once the model reported them. */
39
+ context?: {
40
+ used: number;
41
+ window: number;
42
+ };
43
+ }
44
+ /** An assistant that lives in the page: the conversation, its state and the calls that drive it. */
45
+ export interface PageAgent {
46
+ get(): PageAgentState;
47
+ /** Called with every new state. Returns the function that stops it. */
48
+ subscribe(listener: (state: PageAgentState) => void): () => void;
49
+ /**
50
+ * Send a prompt, with files when the user attached some (text files, and the images and audio
51
+ * that `state.model.inputs` lists). While a turn runs it waits in `session.queued`.
52
+ */
53
+ send(text: string, files?: readonly Blob[]): void;
54
+ /** Stop the running turn and drop queued prompts. */
55
+ stop(): void;
56
+ /** Start a new conversation. */
57
+ reset(): void;
58
+ /** Answer a pending approval (`session.approvals`). False when there is no such request. */
59
+ approve(id: string, decision: ApprovalDecision): boolean;
60
+ /**
61
+ * Load the model now, downloading it first when the browser needs to (several GB, once).
62
+ * Call it from a click: browsers start the download only on a user gesture.
63
+ */
64
+ prepare(): Promise<void>;
65
+ /** Check again whether the browser has the model. */
66
+ refresh(): Promise<PageModelStatus>;
67
+ }
68
+ /**
69
+ * An assistant for a web page that needs no server: the conversation runs in the page on the
70
+ * browser's built-in model (`nano()`), acts through the `tools` the page gives it and asks the
71
+ * user before a `write` tool runs. Draw it with `<PageAgentChat>` from `genaicode/react`, or
72
+ * read `get()`/`subscribe()` from any UI.
73
+ */
74
+ export declare function createPageAgent(options?: PageAgentOptions): PageAgent;
@@ -0,0 +1,339 @@
1
+ import { addUsage } from '../agents/usage.js';
2
+ import { nano } from './nano.js';
3
+ /**
4
+ * An assistant for a web page that needs no server: the conversation runs in the page on the
5
+ * browser's built-in model (`nano()`), acts through the `tools` the page gives it and asks the
6
+ * user before a `write` tool runs. Draw it with `<PageAgentChat>` from `genaicode/react`, or
7
+ * read `get()`/`subscribe()` from any UI.
8
+ */
9
+ export function createPageAgent(options = {}) {
10
+ const listeners = new Set();
11
+ const waiting = new Map();
12
+ let nextTurn = 1;
13
+ let run;
14
+ // The driver's conversation; not in `session`, where the chat would show it as a chip.
15
+ let conversation;
16
+ // Usage of the finished turns; a running turn reports its own total so far.
17
+ let pastUsage = {};
18
+ // A reset or stop makes the events of the run before it stale.
19
+ let generation = 0;
20
+ // What the queued prompts really send, by position in `session.queued`.
21
+ let queuedSends = [];
22
+ // Object URLs made for thumbnails; released on reset.
23
+ const urls = [];
24
+ const shown = (files) => files.map((file, index) => {
25
+ const name = file.name;
26
+ const attachment = {
27
+ name: typeof name === 'string' && name ? name : `attachment ${index + 1}`,
28
+ mediaType: file.type,
29
+ size: file.size,
30
+ };
31
+ if (/^(image|audio)\//.test(file.type) &&
32
+ typeof URL !== 'undefined' &&
33
+ typeof URL.createObjectURL === 'function') {
34
+ attachment.url = URL.createObjectURL(file);
35
+ urls.push(attachment.url);
36
+ }
37
+ return attachment;
38
+ });
39
+ const builtIn = options.agent
40
+ ? undefined
41
+ : nano({
42
+ ...options.nano,
43
+ name: options.name ?? 'nano',
44
+ instructions: options.instructions,
45
+ tools: options.tools,
46
+ onDownload: (progress) => setModel({ status: progress >= 1 ? 'loading' : 'downloading', progress }),
47
+ });
48
+ const agent = options.agent ?? builtIn;
49
+ let state = {
50
+ session: {
51
+ agent: agent.name,
52
+ cwd: '',
53
+ status: 'idle',
54
+ turns: [],
55
+ queued: [],
56
+ approvals: [],
57
+ usage: {},
58
+ canSteer: false,
59
+ },
60
+ model: { status: builtIn ? 'checking' : 'available' },
61
+ };
62
+ const publish = (next) => {
63
+ state = next;
64
+ for (const listener of [...listeners])
65
+ listener(state);
66
+ };
67
+ const setSession = (change) => publish({ ...state, session: { ...state.session, ...change } });
68
+ const setModel = (model) => {
69
+ if (model.status === state.model.status && model.progress === state.model.progress)
70
+ return;
71
+ publish({ ...state, model: { ...model, inputs: state.model.inputs } });
72
+ };
73
+ const updateTurn = (id, change) => setSession({ turns: state.session.turns.map((turn) => (turn.id === id ? change(turn) : turn)) });
74
+ const addEntry = (id, entry) => updateTurn(id, (turn) => ({ ...turn, entries: [...turn.entries, entry] }));
75
+ const refresh = async (settled = false) => {
76
+ if (!builtIn)
77
+ return 'available';
78
+ const status = await builtIn.availability();
79
+ // A download or a load in progress knows better than a fresh `downloadable`.
80
+ const busy = !settled && (state.model.status === 'downloading' || state.model.status === 'loading');
81
+ if (!busy || status === 'available' || status === 'unavailable')
82
+ setModel({ status });
83
+ if (!state.model.inputs && status !== 'unavailable') {
84
+ const inputs = await builtIn.inputs().catch(() => []);
85
+ publish({ ...state, model: { ...state.model, inputs } });
86
+ }
87
+ return state.model.status;
88
+ };
89
+ void refresh();
90
+ function apply(turnId, event) {
91
+ switch (event.type) {
92
+ case 'session':
93
+ conversation = event.sessionId;
94
+ setSession({ model: event.model });
95
+ if (builtIn)
96
+ setModel({ status: 'available' });
97
+ return;
98
+ case 'text-delta':
99
+ updateTurn(turnId, (turn) => {
100
+ const last = turn.entries.at(-1);
101
+ if (last?.kind === 'text' && last.streaming) {
102
+ return { ...turn, entries: [...turn.entries.slice(0, -1), { ...last, text: last.text + event.text }] };
103
+ }
104
+ return { ...turn, entries: [...turn.entries, { kind: 'text', text: event.text, streaming: true }] };
105
+ });
106
+ return;
107
+ case 'message':
108
+ updateTurn(turnId, (turn) => {
109
+ const last = turn.entries.at(-1);
110
+ const entry = { kind: 'text', text: event.text, streaming: false };
111
+ if (last?.kind === 'text' && last.streaming) {
112
+ return { ...turn, entries: [...turn.entries.slice(0, -1), entry] };
113
+ }
114
+ return { ...turn, entries: [...turn.entries, entry] };
115
+ });
116
+ return;
117
+ case 'tool-start':
118
+ addEntry(turnId, { kind: 'tool', id: event.id, name: event.name, input: event.input, done: false });
119
+ return;
120
+ case 'tool-end':
121
+ updateTurn(turnId, (turn) => ({
122
+ ...turn,
123
+ entries: turn.entries.map((entry) => entry.kind === 'tool' && !entry.done && (event.id === undefined || entry.id === event.id)
124
+ ? { ...entry, output: event.output, isError: event.isError, done: true }
125
+ : entry),
126
+ }));
127
+ return;
128
+ case 'approval-request':
129
+ addEntry(turnId, { kind: 'approval', request: event.request });
130
+ return;
131
+ case 'approval-resolved':
132
+ updateTurn(turnId, (turn) => ({
133
+ ...turn,
134
+ entries: turn.entries.map((entry) => entry.kind === 'approval' && entry.request.id === event.id
135
+ ? { ...entry, decision: event.decision, automatic: event.automatic }
136
+ : entry),
137
+ }));
138
+ return;
139
+ case 'usage':
140
+ updateTurn(turnId, (turn) => ({ ...turn, usage: event.usage }));
141
+ setSession({ usage: addUsage(pastUsage, event.usage) });
142
+ return;
143
+ case 'error':
144
+ addEntry(turnId, { kind: 'error', message: event.message });
145
+ return;
146
+ case 'done':
147
+ updateTurn(turnId, (turn) => ({
148
+ ...turn,
149
+ entries: settled(turn.entries),
150
+ endedAt: Date.now(),
151
+ result: event.result,
152
+ }));
153
+ return;
154
+ default:
155
+ return;
156
+ }
157
+ }
158
+ async function start(prompt, files = []) {
159
+ const mine = ++generation;
160
+ const turnId = nextTurn++;
161
+ const turn = {
162
+ id: turnId,
163
+ agent: agent.name,
164
+ prompt,
165
+ ...(files.length ? { attachments: shown(files) } : {}),
166
+ entries: [],
167
+ startedAt: Date.now(),
168
+ };
169
+ setSession({ status: 'running', turns: [...state.session.turns, turn] });
170
+ if (builtIn && state.model.status !== 'available') {
171
+ // The first turn opens the model; a download reports itself through `onDownload`.
172
+ setModel({ status: state.model.status === 'downloadable' ? 'downloading' : 'loading' });
173
+ }
174
+ try {
175
+ // A driver may throw before it returns a run; that ends the turn like any failure.
176
+ const task = {
177
+ prompt,
178
+ cwd: '',
179
+ resume: conversation,
180
+ onApproval: (request, signal) => ask(request, signal),
181
+ ...(files.length ? { attachments: files } : {}),
182
+ };
183
+ const current = agent.run(task);
184
+ run = current;
185
+ for await (const event of current) {
186
+ if (mine !== generation)
187
+ continue;
188
+ apply(turnId, event);
189
+ const context = builtIn && conversation ? builtIn.context(conversation) : undefined;
190
+ if (context && (context.used !== state.context?.used || context.window !== state.context?.window)) {
191
+ publish({ ...state, context });
192
+ }
193
+ }
194
+ }
195
+ catch (error) {
196
+ if (mine === generation) {
197
+ addEntry(turnId, { kind: 'error', message: error instanceof Error ? error.message : String(error) });
198
+ }
199
+ }
200
+ if (mine !== generation)
201
+ return;
202
+ run = undefined;
203
+ const ended = state.session.turns.find((candidate) => candidate.id === turnId);
204
+ if (ended && !ended.result) {
205
+ // The run ended without a `done` event: close the turn so the chat is not left working.
206
+ const message = 'The agent stopped without a result.';
207
+ updateTurn(turnId, (unfinished) => ({
208
+ ...unfinished,
209
+ entries: settled(unfinished.entries),
210
+ endedAt: Date.now(),
211
+ result: { status: 'failed', ok: false, exitCode: null, signal: null, error: message },
212
+ }));
213
+ }
214
+ pastUsage = state.session.usage;
215
+ if (builtIn && state.model.status !== 'available')
216
+ void refresh(true);
217
+ const [next, ...queued] = state.session.queued;
218
+ if (next === undefined) {
219
+ setSession({ status: 'idle' });
220
+ return;
221
+ }
222
+ const [waiting, ...later] = queuedSends;
223
+ queuedSends = later;
224
+ setSession({ queued });
225
+ void start(waiting?.prompt ?? next, waiting?.files);
226
+ }
227
+ function ask(request, signal) {
228
+ const automatic = options.autoApprove?.(request);
229
+ if (automatic)
230
+ return Promise.resolve(automatic);
231
+ return new Promise((resolve) => {
232
+ const settle = (decision) => {
233
+ if (!waiting.delete(request.id))
234
+ return;
235
+ signal?.removeEventListener('abort', withdraw);
236
+ setSession({ approvals: state.session.approvals.filter((pending) => pending.id !== request.id) });
237
+ resolve(decision);
238
+ };
239
+ const withdraw = () => settle('deny');
240
+ waiting.set(request.id, settle);
241
+ setSession({ approvals: [...state.session.approvals, request] });
242
+ if (signal?.aborted)
243
+ withdraw();
244
+ else
245
+ signal?.addEventListener('abort', withdraw, { once: true });
246
+ });
247
+ }
248
+ const halt = () => {
249
+ const stopped = run;
250
+ run = undefined;
251
+ for (const settle of [...waiting.values()])
252
+ settle('deny');
253
+ stopped?.abort();
254
+ return stopped;
255
+ };
256
+ return {
257
+ get: () => state,
258
+ subscribe(listener) {
259
+ listeners.add(listener);
260
+ return () => {
261
+ listeners.delete(listener);
262
+ };
263
+ },
264
+ send(text, files = []) {
265
+ const prompt = text.trim();
266
+ if (!prompt && !files.length)
267
+ return;
268
+ if (state.session.status === 'running') {
269
+ queuedSends = [...queuedSends, { prompt, files }];
270
+ // A prompt of files alone still shows in the queue.
271
+ setSession({ queued: [...state.session.queued, prompt || `${files.length} attached`] });
272
+ return;
273
+ }
274
+ void start(prompt, files);
275
+ },
276
+ stop() {
277
+ if (state.session.status !== 'running')
278
+ return;
279
+ // The run's own `done` event closes the turn; nothing queued follows a stop.
280
+ queuedSends = [];
281
+ setSession({ queued: [] });
282
+ run?.abort();
283
+ },
284
+ reset() {
285
+ generation++;
286
+ halt();
287
+ if (conversation)
288
+ builtIn?.forget(conversation);
289
+ conversation = undefined;
290
+ pastUsage = {};
291
+ queuedSends = [];
292
+ for (const url of urls.splice(0))
293
+ URL.revokeObjectURL(url);
294
+ publish({
295
+ ...state,
296
+ context: undefined,
297
+ session: {
298
+ ...state.session,
299
+ status: 'idle',
300
+ turns: [],
301
+ queued: [],
302
+ approvals: [],
303
+ usage: {},
304
+ },
305
+ });
306
+ },
307
+ approve(id, decision) {
308
+ const settle = waiting.get(id);
309
+ if (!settle)
310
+ return false;
311
+ settle(decision);
312
+ return true;
313
+ },
314
+ async prepare() {
315
+ if (!builtIn)
316
+ return;
317
+ if (state.model.status === 'downloadable')
318
+ setModel({ status: 'downloading', progress: 0 });
319
+ try {
320
+ await builtIn.prepare();
321
+ setModel({ status: 'available' });
322
+ }
323
+ catch (error) {
324
+ await refresh(true);
325
+ throw error;
326
+ }
327
+ },
328
+ refresh: () => refresh(),
329
+ };
330
+ }
331
+ /** The entries of a turn that ended: an open tool or a streaming text would spin forever. */
332
+ function settled(entries) {
333
+ return entries.map((entry) => entry.kind === 'tool' && !entry.done
334
+ ? { ...entry, done: true, isError: true }
335
+ : entry.kind === 'text' && entry.streaming
336
+ ? { ...entry, streaming: false }
337
+ : entry);
338
+ }
339
+ //# sourceMappingURL=page-agent.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"page-agent.js","sourceRoot":"","sources":["../../src/browser/page-agent.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,36 @@
1
+ /** What a page tool returns: text, or a value that is sent as JSON. */
2
+ export type PageToolOutput = string | {
3
+ text: string;
4
+ } | Record<string, unknown> | unknown[] | number | boolean | null;
5
+ /**
6
+ * Something the page lets an agent do: a function with a name, a description and a JSON Schema
7
+ * for its arguments. The same list serves the in-page agent (`nano`, `createPageAgent`) and
8
+ * outside agents over WebMCP (`exposeWebMcp`). It has the shape of `AppTool` from
9
+ * `genaicode/app-agent`, so one definition can serve both a server agent and the page.
10
+ */
11
+ export interface PageTool {
12
+ name: string;
13
+ description: string;
14
+ /** JSON Schema of the arguments (an object schema). Default: no arguments. */
15
+ inputSchema?: Record<string, unknown>;
16
+ /** Changes something for the user: it runs only after the user approved the call. */
17
+ write?: boolean;
18
+ /** The one line the user reads before approving a `write` call. Default: the tool and its arguments. */
19
+ summary?(args: Record<string, unknown>): string;
20
+ /** Throw to refuse a call, before anyone is asked to approve it. */
21
+ validate?(args: Record<string, unknown>): void;
22
+ run(args: Record<string, unknown>, signal?: AbortSignal): Promise<PageToolOutput> | PageToolOutput;
23
+ }
24
+ /** A tool's output as the text an agent reads. */
25
+ export declare function toolText(output: PageToolOutput | undefined): string;
26
+ /** The properties of a tool's argument schema; empty when it takes none. */
27
+ export declare function schemaProperties(tool: Pick<PageTool, 'inputSchema'>): Record<string, Record<string, unknown>>;
28
+ /**
29
+ * The problems with `args` for `tool`, by its `inputSchema`: missing required arguments, wrong
30
+ * types, values outside an `enum`, a `const`, numeric bounds, string and array lengths, a
31
+ * `pattern`, and the same inside nested objects and arrays. It covers what tools declare in
32
+ * practice, not all of JSON Schema (no `$ref`, `oneOf` or `format`); `tool.validate` does the rest.
33
+ * An argument the schema does not name is a problem only where the schema says
34
+ * `additionalProperties: false`.
35
+ */
36
+ export declare function argumentProblems(tool: Pick<PageTool, 'inputSchema'>, args: Record<string, unknown>): string[];
@@ -0,0 +1,190 @@
1
+ /** A tool's output as the text an agent reads. */
2
+ export function toolText(output) {
3
+ if (output === undefined || output === null)
4
+ return 'done';
5
+ if (typeof output === 'string')
6
+ return output;
7
+ if (typeof output === 'object' && !Array.isArray(output)) {
8
+ const keys = Object.keys(output);
9
+ if (keys.length === 1 && typeof output.text === 'string') {
10
+ return output.text;
11
+ }
12
+ }
13
+ try {
14
+ return JSON.stringify(output) ?? String(output);
15
+ }
16
+ catch {
17
+ return String(output);
18
+ }
19
+ }
20
+ /** The properties of a tool's argument schema; empty when it takes none. */
21
+ export function schemaProperties(tool) {
22
+ const properties = tool.inputSchema?.properties;
23
+ return properties && typeof properties === 'object' ? properties : {};
24
+ }
25
+ /**
26
+ * The problems with `args` for `tool`, by its `inputSchema`: missing required arguments, wrong
27
+ * types, values outside an `enum`, a `const`, numeric bounds, string and array lengths, a
28
+ * `pattern`, and the same inside nested objects and arrays. It covers what tools declare in
29
+ * practice, not all of JSON Schema (no `$ref`, `oneOf` or `format`); `tool.validate` does the rest.
30
+ * An argument the schema does not name is a problem only where the schema says
31
+ * `additionalProperties: false`.
32
+ */
33
+ export function argumentProblems(tool, args) {
34
+ const problems = [];
35
+ if (tool.inputSchema)
36
+ check({ type: 'object', ...tool.inputSchema }, args, '', problems);
37
+ return problems;
38
+ }
39
+ const isSchema = (value) => !!value && typeof value === 'object' && !Array.isArray(value);
40
+ const article = (noun) => (/^[aeio]/.test(noun) ? 'an' : 'a');
41
+ function typeOf(value) {
42
+ return value === null ? 'null' : Array.isArray(value) ? 'array' : typeof value;
43
+ }
44
+ function isType(value, type) {
45
+ if (type === 'integer')
46
+ return Number.isInteger(value);
47
+ if (type === 'number')
48
+ return typeof value === 'number' && Number.isFinite(value);
49
+ return typeOf(value) === type;
50
+ }
51
+ /** JSON equality: the order of an object's keys does not matter. */
52
+ function same(a, b) {
53
+ if (a === b)
54
+ return true;
55
+ if (Array.isArray(a) || Array.isArray(b)) {
56
+ return (Array.isArray(a) && Array.isArray(b) && a.length === b.length && a.every((item, index) => same(item, b[index])));
57
+ }
58
+ if (!isSchema(a) || !isSchema(b))
59
+ return false;
60
+ const keys = Object.keys(a);
61
+ return keys.length === Object.keys(b).length && keys.every((key) => key in b && same(a[key], b[key]));
62
+ }
63
+ /** `value / step` is whole, give or take what floating point loses (0.3 / 0.1 is 2.9999999999999996). */
64
+ function isMultiple(value, step) {
65
+ const quotient = value / step;
66
+ // A few units of rounding error at this size: never a real fraction of a step.
67
+ return Math.abs(quotient - Math.round(quotient)) <= 4 * Number.EPSILON * Math.max(1, Math.abs(quotient));
68
+ }
69
+ /** `patternProperties` as regular expressions; a pattern that does not compile matches nothing. */
70
+ function patternSchemas(map) {
71
+ if (!isSchema(map))
72
+ return [];
73
+ const out = [];
74
+ for (const [source, sub] of Object.entries(map)) {
75
+ if (!isSchema(sub))
76
+ continue;
77
+ try {
78
+ out.push([new RegExp(source, 'u'), sub]);
79
+ }
80
+ catch {
81
+ // Not a pattern this engine reads.
82
+ }
83
+ }
84
+ return out;
85
+ }
86
+ function allowsNull(schema) {
87
+ if (!isSchema(schema))
88
+ return false;
89
+ if ('const' in schema)
90
+ return schema.const === null;
91
+ if (Array.isArray(schema.enum))
92
+ return schema.enum.includes(null);
93
+ return schema.type === 'null' || (Array.isArray(schema.type) && schema.type.includes('null'));
94
+ }
95
+ function check(schema, value, path, problems) {
96
+ const name = `"${path}"`;
97
+ if ('const' in schema && !same(schema.const, value)) {
98
+ problems.push(`${name} must be ${JSON.stringify(schema.const)}`);
99
+ return;
100
+ }
101
+ if (Array.isArray(schema.enum) && !schema.enum.some((item) => same(item, value))) {
102
+ problems.push(`${name} must be one of ${schema.enum.map((item) => JSON.stringify(item)).join(', ')}`);
103
+ return;
104
+ }
105
+ const types = typeof schema.type === 'string' ? [schema.type] : Array.isArray(schema.type) ? schema.type : [];
106
+ const named = types.filter((type) => typeof type === 'string');
107
+ if (named.length && !named.some((type) => isType(value, type))) {
108
+ problems.push(`${name} must be ${named.map((type) => `${article(type)} ${type}`).join(' or ')}`);
109
+ return;
110
+ }
111
+ if (typeof value === 'string') {
112
+ // JSON Schema counts characters (code points), not UTF-16 units: an emoji is one.
113
+ const length = [...value].length;
114
+ if (typeof schema.minLength === 'number' && length < schema.minLength) {
115
+ problems.push(value ? `${name} is too short (at least ${schema.minLength} characters)` : `${name} must not be empty`);
116
+ }
117
+ if (typeof schema.maxLength === 'number' && length > schema.maxLength) {
118
+ problems.push(`${name} is too long (at most ${schema.maxLength} characters)`);
119
+ }
120
+ if (typeof schema.pattern === 'string') {
121
+ let matches = true;
122
+ try {
123
+ matches = new RegExp(schema.pattern, 'u').test(value);
124
+ }
125
+ catch {
126
+ // A pattern this engine cannot read decides nothing.
127
+ }
128
+ if (!matches)
129
+ problems.push(`${name} must match ${schema.pattern}`);
130
+ }
131
+ }
132
+ else if (typeof value === 'number') {
133
+ if (typeof schema.minimum === 'number' && value < schema.minimum)
134
+ problems.push(`${name} must be at least ${schema.minimum}`);
135
+ if (typeof schema.maximum === 'number' && value > schema.maximum)
136
+ problems.push(`${name} must be at most ${schema.maximum}`);
137
+ if (typeof schema.exclusiveMinimum === 'number' && value <= schema.exclusiveMinimum) {
138
+ problems.push(`${name} must be more than ${schema.exclusiveMinimum}`);
139
+ }
140
+ if (typeof schema.exclusiveMaximum === 'number' && value >= schema.exclusiveMaximum) {
141
+ problems.push(`${name} must be less than ${schema.exclusiveMaximum}`);
142
+ }
143
+ if (typeof schema.multipleOf === 'number' && schema.multipleOf > 0 && !isMultiple(value, schema.multipleOf)) {
144
+ problems.push(`${name} must be a multiple of ${schema.multipleOf}`);
145
+ }
146
+ }
147
+ else if (Array.isArray(value)) {
148
+ if (typeof schema.minItems === 'number' && value.length < schema.minItems) {
149
+ problems.push(`${name} needs at least ${schema.minItems} items`);
150
+ }
151
+ if (typeof schema.maxItems === 'number' && value.length > schema.maxItems) {
152
+ problems.push(`${name} takes at most ${schema.maxItems} items`);
153
+ }
154
+ if (isSchema(schema.items)) {
155
+ for (const [index, item] of value.entries())
156
+ check(schema.items, item, `${path}[${index}]`, problems);
157
+ }
158
+ }
159
+ else if (isSchema(value)) {
160
+ const properties = isSchema(schema.properties) ? schema.properties : {};
161
+ const at = (key) => (path ? `${path}.${key}` : key);
162
+ const patterns = patternSchemas(schema.patternProperties);
163
+ for (const key of Array.isArray(schema.required) ? schema.required : []) {
164
+ if (typeof key !== 'string')
165
+ continue;
166
+ // A small model writes null for what it leaves out, so null counts as missing unless the schema asks for it.
167
+ if (value[key] === undefined || (value[key] === null && !allowsNull(properties[key]))) {
168
+ problems.push(`"${at(key)}" is required`);
169
+ }
170
+ }
171
+ for (const [key, item] of Object.entries(value)) {
172
+ // A model writes null for an argument it leaves out.
173
+ if (item === undefined || item === null)
174
+ continue;
175
+ const property = properties[key];
176
+ const matched = patterns.filter(([pattern]) => pattern.test(key));
177
+ for (const [, sub] of matched)
178
+ check(sub, item, at(key), problems);
179
+ if (isSchema(property))
180
+ check(property, item, at(key), problems);
181
+ else if (matched.length)
182
+ continue;
183
+ else if (schema.additionalProperties === false)
184
+ problems.push(`"${at(key)}" is not an argument`);
185
+ else if (isSchema(schema.additionalProperties))
186
+ check(schema.additionalProperties, item, at(key), problems);
187
+ }
188
+ }
189
+ }
190
+ //# sourceMappingURL=tools.js.map