genaicode 2.33.0 → 2.35.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 (194) hide show
  1. package/README.md +1 -0
  2. package/dist/agents/artifacts.d.ts +1 -1
  3. package/dist/agents/artifacts.js +4 -65
  4. package/dist/agents/artifacts.js.map +1 -1
  5. package/dist/agents/cli-agent.d.ts +3 -0
  6. package/dist/agents/cli-agent.js +1 -0
  7. package/dist/agents/cli-agent.js.map +1 -1
  8. package/dist/agents/drivers/anthropic-managed.d.ts +145 -0
  9. package/dist/agents/drivers/anthropic-managed.js +799 -0
  10. package/dist/agents/drivers/anthropic-managed.js.map +1 -0
  11. package/dist/agents/drivers/antigravity.js +2 -0
  12. package/dist/agents/drivers/antigravity.js.map +1 -1
  13. package/dist/agents/drivers/claude.js +2 -0
  14. package/dist/agents/drivers/claude.js.map +1 -1
  15. package/dist/agents/drivers/codex-live.js +2 -0
  16. package/dist/agents/drivers/codex-live.js.map +1 -1
  17. package/dist/agents/drivers/codex.js +2 -0
  18. package/dist/agents/drivers/codex.js.map +1 -1
  19. package/dist/agents/drivers/copilot.js +2 -0
  20. package/dist/agents/drivers/copilot.js.map +1 -1
  21. package/dist/agents/drivers/cursor-cloud.d.ts +78 -0
  22. package/dist/agents/drivers/cursor-cloud.js +523 -0
  23. package/dist/agents/drivers/cursor-cloud.js.map +1 -0
  24. package/dist/agents/drivers/cursor.js +2 -0
  25. package/dist/agents/drivers/cursor.js.map +1 -1
  26. package/dist/agents/drivers/gemini-managed.d.ts +78 -0
  27. package/dist/agents/drivers/gemini-managed.js +528 -0
  28. package/dist/agents/drivers/gemini-managed.js.map +1 -0
  29. package/dist/agents/drivers/gemini.js +2 -0
  30. package/dist/agents/drivers/gemini.js.map +1 -1
  31. package/dist/agents/drivers/managed-http.d.ts +28 -0
  32. package/dist/agents/drivers/managed-http.js +142 -0
  33. package/dist/agents/drivers/managed-http.js.map +1 -0
  34. package/dist/agents/drivers/muse-live.js +2 -0
  35. package/dist/agents/drivers/muse-live.js.map +1 -1
  36. package/dist/agents/drivers/muse.js +2 -0
  37. package/dist/agents/drivers/muse.js.map +1 -1
  38. package/dist/agents/drivers/openai-managed.d.ts +79 -0
  39. package/dist/agents/drivers/openai-managed.js +404 -0
  40. package/dist/agents/drivers/openai-managed.js.map +1 -0
  41. package/dist/agents/drivers/opencode.js +2 -0
  42. package/dist/agents/drivers/opencode.js.map +1 -1
  43. package/dist/agents/drivers/vibe.js +2 -0
  44. package/dist/agents/drivers/vibe.js.map +1 -1
  45. package/dist/agents/failover.d.ts +19 -1
  46. package/dist/agents/failover.js +63 -2
  47. package/dist/agents/failover.js.map +1 -1
  48. package/dist/agents/hosted.d.ts +5 -1
  49. package/dist/agents/hosted.js +47 -132
  50. package/dist/agents/hosted.js.map +1 -1
  51. package/dist/agents/live-agent.d.ts +3 -0
  52. package/dist/agents/live-agent.js +1 -0
  53. package/dist/agents/live-agent.js.map +1 -1
  54. package/dist/agents/managed.d.ts +157 -0
  55. package/dist/agents/managed.js +562 -0
  56. package/dist/agents/managed.js.map +1 -0
  57. package/dist/agents/mcp-server.d.ts +19 -0
  58. package/dist/agents/mcp-server.js +74 -0
  59. package/dist/agents/mcp-server.js.map +1 -0
  60. package/dist/agents/pack-git.d.ts +23 -0
  61. package/dist/agents/pack-git.js +112 -0
  62. package/dist/agents/pack-git.js.map +1 -0
  63. package/dist/agents/pack.d.ts +68 -0
  64. package/dist/agents/pack.js +611 -0
  65. package/dist/agents/pack.js.map +1 -0
  66. package/dist/agents/runtime.d.ts +5 -1
  67. package/dist/agents/runtime.js +9 -0
  68. package/dist/agents/runtime.js.map +1 -1
  69. package/dist/agents/session.d.ts +10 -0
  70. package/dist/agents/session.js +26 -0
  71. package/dist/agents/session.js.map +1 -1
  72. package/dist/agents/sessions/claude.d.ts +14 -0
  73. package/dist/agents/sessions/claude.js +233 -0
  74. package/dist/agents/sessions/claude.js.map +1 -0
  75. package/dist/agents/sessions/codex-api.d.ts +32 -0
  76. package/dist/agents/sessions/codex-api.js +233 -0
  77. package/dist/agents/sessions/codex-api.js.map +1 -0
  78. package/dist/agents/sessions/codex.d.ts +28 -0
  79. package/dist/agents/sessions/codex.js +430 -0
  80. package/dist/agents/sessions/codex.js.map +1 -0
  81. package/dist/agents/sessions/doctor.d.ts +67 -0
  82. package/dist/agents/sessions/doctor.js +182 -0
  83. package/dist/agents/sessions/doctor.js.map +1 -0
  84. package/dist/agents/sessions/files.d.ts +44 -0
  85. package/dist/agents/sessions/files.js +150 -0
  86. package/dist/agents/sessions/files.js.map +1 -0
  87. package/dist/agents/sessions/group.d.ts +24 -0
  88. package/dist/agents/sessions/group.js +27 -0
  89. package/dist/agents/sessions/group.js.map +1 -0
  90. package/dist/agents/sessions/hooks.d.ts +32 -0
  91. package/dist/agents/sessions/hooks.js +155 -0
  92. package/dist/agents/sessions/hooks.js.map +1 -0
  93. package/dist/agents/sessions/index.d.ts +42 -0
  94. package/dist/agents/sessions/index.js +97 -0
  95. package/dist/agents/sessions/index.js.map +1 -0
  96. package/dist/agents/sessions/live.d.ts +67 -0
  97. package/dist/agents/sessions/live.js +308 -0
  98. package/dist/agents/sessions/live.js.map +1 -0
  99. package/dist/agents/sessions/sqlite.d.ts +12 -0
  100. package/dist/agents/sessions/sqlite.js +61 -0
  101. package/dist/agents/sessions/sqlite.js.map +1 -0
  102. package/dist/agents/sessions/stores.d.ts +38 -0
  103. package/dist/agents/sessions/stores.js +616 -0
  104. package/dist/agents/sessions/stores.js.map +1 -0
  105. package/dist/agents/sessions/transcript.d.ts +20 -0
  106. package/dist/agents/sessions/transcript.js +134 -0
  107. package/dist/agents/sessions/transcript.js.map +1 -0
  108. package/dist/agents/sessions/types.d.ts +95 -0
  109. package/dist/agents/sessions/types.js +2 -0
  110. package/dist/agents/sessions/types.js.map +1 -0
  111. package/dist/agents/types.d.ts +31 -0
  112. package/dist/agents.d.ts +17 -1
  113. package/dist/agents.js +9 -1
  114. package/dist/agents.js.map +1 -1
  115. package/dist/backend/backend.d.ts +131 -0
  116. package/dist/backend/backend.js +773 -0
  117. package/dist/backend/backend.js.map +1 -0
  118. package/dist/backend/limiter.d.ts +34 -0
  119. package/dist/backend/limiter.js +76 -0
  120. package/dist/backend/limiter.js.map +1 -0
  121. package/dist/backend/node.d.ts +10 -0
  122. package/dist/backend/node.js +124 -0
  123. package/dist/backend/node.js.map +1 -0
  124. package/dist/backend/protocol.d.ts +98 -0
  125. package/dist/backend/protocol.js +2 -0
  126. package/dist/backend/protocol.js.map +1 -0
  127. package/dist/backend/seal.d.ts +7 -0
  128. package/dist/backend/seal.js +60 -0
  129. package/dist/backend/seal.js.map +1 -0
  130. package/dist/backend.d.ts +27 -0
  131. package/dist/backend.js +25 -0
  132. package/dist/backend.js.map +1 -0
  133. package/dist/browser/invoke.d.ts +17 -0
  134. package/dist/browser/invoke.js +69 -0
  135. package/dist/browser/invoke.js.map +1 -0
  136. package/dist/browser/nano.d.ts +10 -0
  137. package/dist/browser/nano.js +10 -56
  138. package/dist/browser/nano.js.map +1 -1
  139. package/dist/browser/page-agent.d.ts +7 -0
  140. package/dist/browser/page-agent.js +26 -5
  141. package/dist/browser/page-agent.js.map +1 -1
  142. package/dist/browser/remote.d.ts +44 -0
  143. package/dist/browser/remote.js +372 -0
  144. package/dist/browser/remote.js.map +1 -0
  145. package/dist/browser.d.ts +9 -2
  146. package/dist/browser.js +8 -2
  147. package/dist/browser.js.map +1 -1
  148. package/dist/cli/args.d.ts +26 -0
  149. package/dist/cli/args.js +66 -0
  150. package/dist/cli/args.js.map +1 -1
  151. package/dist/cli/hook.d.ts +7 -0
  152. package/dist/cli/hook.js +21 -0
  153. package/dist/cli/hook.js.map +1 -0
  154. package/dist/cli/main.d.ts +3 -1
  155. package/dist/cli/main.js +237 -2
  156. package/dist/cli/main.js.map +1 -1
  157. package/dist/cli.js +31 -21
  158. package/dist/cli.js.map +1 -1
  159. package/dist/core/types.d.ts +5 -0
  160. package/dist/core/types.js.map +1 -1
  161. package/dist/index.d.ts +1 -1
  162. package/dist/index.js +1 -1
  163. package/dist/index.js.map +1 -1
  164. package/dist/providers/google-converter.js +21 -8
  165. package/dist/providers/google-converter.js.map +1 -1
  166. package/dist/providers/google.js +7 -10
  167. package/dist/providers/google.js.map +1 -1
  168. package/dist/providers/openai-converter.js +3 -2
  169. package/dist/providers/openai-converter.js.map +1 -1
  170. package/dist/providers/openai-responses-converter.d.ts +35 -0
  171. package/dist/providers/openai-responses-converter.js +188 -0
  172. package/dist/providers/openai-responses-converter.js.map +1 -0
  173. package/dist/providers/openai.d.ts +6 -1
  174. package/dist/providers/openai.js +16 -1
  175. package/dist/providers/openai.js.map +1 -1
  176. package/dist/providers.d.ts +1 -0
  177. package/dist/providers.js +1 -0
  178. package/dist/providers.js.map +1 -1
  179. package/dist/react/page-agent-chat.js +6 -2
  180. package/dist/react/page-agent-chat.js.map +1 -1
  181. package/dist/ui/index.js +109 -82
  182. package/dist/ui/sessions.d.ts +19 -0
  183. package/dist/ui/sessions.js +59 -0
  184. package/dist/ui/sessions.js.map +1 -0
  185. package/dist/ui/web-client.js +15 -14
  186. package/docs/CHANGELOG.md +51 -388
  187. package/docs/agents.md +417 -2
  188. package/docs/backend.md +125 -0
  189. package/docs/browser.md +6 -1
  190. package/docs/changelog-2.26-and-older.md +441 -0
  191. package/docs/cli.md +39 -0
  192. package/docs/llm.md +6 -1
  193. package/docs/pivot.md +1 -1
  194. package/package.json +5 -1
@@ -0,0 +1,372 @@
1
+ import { approximateSize, EventQueue } from '../agents/event-queue.js';
2
+ import { unsupportedPermissions } from '../agents/permissions.js';
3
+ import { addUsage } from '../agents/usage.js';
4
+ import { ask, invoke } from './invoke.js';
5
+ import { abortable } from './language-model.js';
6
+ import { TEXT_NAMES, TEXT_TYPES } from './nano.js';
7
+ // A page has no sandbox to switch on; `read-only` is honored by refusing `write` tools.
8
+ const capabilities = {
9
+ usage: true,
10
+ approvals: true,
11
+ resume: true,
12
+ permissions: { approval: ['ask', 'auto-approve', 'deny'], sandbox: ['read-only'] },
13
+ };
14
+ const KEPT_SESSIONS = 8;
15
+ const IMAGE_TYPES = new Set(['image/png', 'image/jpeg', 'image/gif', 'image/webp']);
16
+ class Failed extends Error {
17
+ failure;
18
+ status;
19
+ constructor(message, failure, status) {
20
+ super(message);
21
+ this.failure = failure;
22
+ this.status = status;
23
+ }
24
+ }
25
+ /**
26
+ * The page's assistant on a model behind your server: the server (`createAgentBackend()` from
27
+ * `genaicode/backend`) holds the model and its key, the page runs its own tools when the model
28
+ * calls them and asks the user before a `write` tool, as with `nano()`. Use it as
29
+ * `createPageAgent({ agent: remote({ url, tools }) })`, or with `withFallback([remote(...), nano(...)])`
30
+ * so the page goes on with the built-in model when the backend is out (signed out, over its
31
+ * allowance, down).
32
+ */
33
+ export function remote(options) {
34
+ const name = options.name ?? 'assistant';
35
+ const base = options.url.replace(/\/$/, '');
36
+ const maxAttachmentText = options.maxAttachmentText ?? 4_000;
37
+ const maxToolOutput = options.maxToolOutput ?? 8_000;
38
+ // The backend's token for each conversation; insertion order is age.
39
+ const sessions = new Map();
40
+ let nextSession = 1;
41
+ const doFetch = (input, init) => (options.fetch ?? globalThis.fetch)(input, init);
42
+ async function post(body, signal, emit) {
43
+ let response;
44
+ try {
45
+ response = await doFetch(`${base}/turn`, {
46
+ method: 'POST',
47
+ headers: {
48
+ 'content-type': 'application/json',
49
+ ...(await abortable(Promise.resolve(options.headers?.()), signal)),
50
+ },
51
+ body: JSON.stringify(body),
52
+ credentials: options.credentials ?? 'same-origin',
53
+ signal,
54
+ });
55
+ }
56
+ catch (error) {
57
+ signal.throwIfAborted();
58
+ throw new Failed(`The assistant's server cannot be reached: ${describe(error)}`, { kind: 'unavailable' });
59
+ }
60
+ if (!response.ok)
61
+ throw await refusal(response);
62
+ if (!response.body)
63
+ throw new Failed('The assistant sent nothing back.', { kind: 'crash' });
64
+ const reader = response.body.pipeThrough(new TextDecoderStream()).getReader();
65
+ let buffer = '';
66
+ for (;;) {
67
+ let chunk;
68
+ try {
69
+ chunk = await reader.read();
70
+ }
71
+ catch (error) {
72
+ signal.throwIfAborted();
73
+ throw new Failed(`The connection to the assistant broke: ${describe(error)}`, { kind: 'unavailable' });
74
+ }
75
+ const { done, value } = chunk;
76
+ if (value)
77
+ buffer += value;
78
+ let newline;
79
+ while ((newline = buffer.indexOf('\n')) >= 0) {
80
+ const line = buffer.slice(0, newline).trim();
81
+ buffer = buffer.slice(newline + 1);
82
+ if (!line)
83
+ continue;
84
+ let parsed;
85
+ try {
86
+ parsed = JSON.parse(line);
87
+ }
88
+ catch {
89
+ continue;
90
+ }
91
+ if (parsed.type === 'turn-end') {
92
+ void reader.cancel().catch(() => { });
93
+ return parsed;
94
+ }
95
+ if (parsed.type === 'text-delta' ||
96
+ parsed.type === 'message' ||
97
+ parsed.type === 'tool-start' ||
98
+ parsed.type === 'tool-end' ||
99
+ parsed.type === 'error') {
100
+ emit(parsed);
101
+ }
102
+ }
103
+ if (done)
104
+ break;
105
+ }
106
+ signal.throwIfAborted();
107
+ throw new Failed('The assistant stopped without finishing the turn.', { kind: 'crash' });
108
+ }
109
+ function run(task) {
110
+ const events = new EventQueue(approximateSize);
111
+ const controller = new AbortController();
112
+ const { signal } = controller;
113
+ const abort = () => controller.abort();
114
+ if (task.signal?.aborted)
115
+ abort();
116
+ else
117
+ task.signal?.addEventListener('abort', abort, { once: true });
118
+ let timedOut = false;
119
+ const timer = task.timeoutMs === undefined
120
+ ? undefined
121
+ : setTimeout(() => {
122
+ timedOut = true;
123
+ abort();
124
+ }, task.timeoutMs);
125
+ const emit = (event) => events.push(event);
126
+ let tokens = 0;
127
+ let usage = {};
128
+ // A write ran (a page tool, or a server tool the user approved) during this run.
129
+ let acted = false;
130
+ let over = false;
131
+ const finish = (status, sessionId, extra = {}) => {
132
+ const result = {
133
+ status,
134
+ ok: status === 'completed',
135
+ exitCode: null,
136
+ signal: null,
137
+ ...(sessionId ? { sessionId } : {}),
138
+ ...(extra.text !== undefined ? { text: extra.text } : {}),
139
+ ...(tokens ? { usage: { ...usage, totalTokens: tokens } } : {}),
140
+ ...(extra.error ? { error: extra.error } : {}),
141
+ ...(extra.failure ? { failure: extra.failure } : over ? { failure: { kind: 'budget' } } : {}),
142
+ };
143
+ emit({ type: 'done', result });
144
+ events.close();
145
+ if (timer)
146
+ clearTimeout(timer);
147
+ task.signal?.removeEventListener('abort', abort);
148
+ return result;
149
+ };
150
+ const work = async () => {
151
+ let sessionId;
152
+ try {
153
+ const refused = unsupportedPermissions(name, capabilities, task);
154
+ if (refused)
155
+ throw new Error(refused);
156
+ const tools = typeof options.tools === 'function'
157
+ ? await abortable(Promise.resolve(options.tools()), signal)
158
+ : (options.tools ?? []);
159
+ const specs = options.sendTools === false
160
+ ? undefined
161
+ : tools.map((tool) => ({
162
+ name: tool.name,
163
+ description: tool.description,
164
+ ...(tool.inputSchema ? { inputSchema: tool.inputSchema } : {}),
165
+ ...(tool.write ? { write: true } : {}),
166
+ }));
167
+ const attached = await abortable(attach(task.attachments ?? [], maxAttachmentText), signal);
168
+ sessionId = task.resume && sessions.has(task.resume) ? task.resume : `remote-${nextSession++}`;
169
+ emit({ type: 'session', sessionId, model: name });
170
+ const keep = (state) => {
171
+ if (!state)
172
+ return;
173
+ sessions.delete(sessionId);
174
+ sessions.set(sessionId, state);
175
+ for (const id of sessions.keys()) {
176
+ if (sessions.size <= KEPT_SESSIONS)
177
+ break;
178
+ sessions.delete(id);
179
+ }
180
+ };
181
+ const prompt = `${task.prompt.trim()}${attached.text}`;
182
+ let body = {
183
+ ...(sessions.has(sessionId) ? { state: sessions.get(sessionId) } : {}),
184
+ prompt,
185
+ ...(attached.images.length ? { images: attached.images } : {}),
186
+ ...(specs ? { tools: specs } : {}),
187
+ };
188
+ let restarted = false;
189
+ let step = 0;
190
+ for (;;) {
191
+ let end;
192
+ try {
193
+ end = await post(body, signal, emit);
194
+ }
195
+ catch (error) {
196
+ // An expired or foreign conversation: start a new one with this prompt, once.
197
+ // The token is no good for any later turn either.
198
+ if (error instanceof Failed && error.status === 409)
199
+ sessions.delete(sessionId);
200
+ if (error instanceof Failed && error.status === 409 && body.prompt !== undefined && !restarted) {
201
+ restarted = true;
202
+ sessions.delete(sessionId);
203
+ const { state: _old, ...fresh } = body;
204
+ void _old;
205
+ body = fresh;
206
+ continue;
207
+ }
208
+ throw error;
209
+ }
210
+ keep(end.state);
211
+ const spent = end.usage?.totalTokens ?? (end.usage?.inputTokens ?? 0) + (end.usage?.outputTokens ?? 0);
212
+ if (spent) {
213
+ tokens += spent;
214
+ usage = addUsage(usage, { ...end.usage, totalTokens: spent });
215
+ emit({ type: 'usage', usage: { ...usage, totalTokens: tokens } });
216
+ const limit = task.budget?.maxTokens;
217
+ if (limit !== undefined && tokens > limit) {
218
+ over = true;
219
+ throw new Error(`${name} went over its token budget (${tokens} of ${limit}).`);
220
+ }
221
+ }
222
+ if (end.status === 'failed')
223
+ throw new Failed(end.error ?? 'The assistant failed.', end.failure);
224
+ if (end.status === 'completed')
225
+ return finish('completed', sessionId, { text: end.text ?? '' });
226
+ if (task.maxTurns !== undefined && ++step > task.maxTurns) {
227
+ throw new Error(`${name} used its ${task.maxTurns} tool steps.`);
228
+ }
229
+ const results = [];
230
+ for (const call of end.calls ?? []) {
231
+ emit({ type: 'tool-start', id: call.id, name: call.name, input: call.input });
232
+ const tool = tools.find((candidate) => candidate.name === call.name);
233
+ let output;
234
+ let isError = false;
235
+ try {
236
+ if (!tool)
237
+ throw new Error(`This page has no tool called ${call.name}.`);
238
+ // Either side calling it a write is enough to ask first.
239
+ output = await invoke(tool, call.input ?? {}, call.id, task, emit, signal, {
240
+ write: call.write,
241
+ onWrite: () => (acted = true),
242
+ });
243
+ }
244
+ catch (error) {
245
+ signal.throwIfAborted();
246
+ output = describe(error);
247
+ isError = true;
248
+ }
249
+ emit({ type: 'tool-end', id: call.id, name: call.name, output, ...(isError ? { isError } : {}) });
250
+ results.push({ id: call.id, output: clip(output, maxToolOutput), ...(isError ? { isError } : {}) });
251
+ }
252
+ const approvals = [];
253
+ for (const request of end.approvals ?? []) {
254
+ const decision = await ask(request, task, emit, signal);
255
+ if (decision === 'approve')
256
+ acted = true;
257
+ approvals.push({ id: request.id, decision: decision === 'approve' ? 'approve' : 'deny' });
258
+ }
259
+ body = {
260
+ state: end.state,
261
+ ...(results.length ? { results } : {}),
262
+ ...(approvals.length ? { approvals } : {}),
263
+ ...(!results.length && !approvals.length ? { results: [] } : {}),
264
+ ...(specs ? { tools: specs } : {}),
265
+ };
266
+ }
267
+ }
268
+ catch (error) {
269
+ if (signal.aborted && !over) {
270
+ return finish(timedOut ? 'timeout' : 'aborted', sessionId, timedOut ? { error: 'Timed out.' } : {});
271
+ }
272
+ // After a write ran, another agent given the same prompt would do it again: no failover.
273
+ const message = acted
274
+ ? `${describe(error)} It had already changed something, so it is not handed to another model.`
275
+ : describe(error);
276
+ emit({ type: 'error', message });
277
+ return finish('failed', sessionId, {
278
+ error: message,
279
+ ...(error instanceof Failed && error.failure && !acted ? { failure: error.failure } : {}),
280
+ });
281
+ }
282
+ };
283
+ const result = work();
284
+ return {
285
+ result,
286
+ abort,
287
+ [Symbol.asyncIterator]: () => events.iterate(),
288
+ };
289
+ }
290
+ return {
291
+ name,
292
+ command: base,
293
+ capabilities,
294
+ run,
295
+ async info(signal) {
296
+ let response;
297
+ try {
298
+ response = await doFetch(`${base}/info`, {
299
+ headers: { ...(await abortable(Promise.resolve(options.headers?.()), signal)) },
300
+ credentials: options.credentials ?? 'same-origin',
301
+ ...(signal ? { signal } : {}),
302
+ });
303
+ }
304
+ catch (error) {
305
+ throw new Failed(`The assistant's server cannot be reached: ${describe(error)}`, { kind: 'unavailable' });
306
+ }
307
+ if (!response.ok)
308
+ throw await refusal(response);
309
+ return (await response.json());
310
+ },
311
+ forget(sessionId) {
312
+ if (sessionId === undefined)
313
+ sessions.clear();
314
+ else
315
+ sessions.delete(sessionId);
316
+ },
317
+ };
318
+ }
319
+ /** A refused request as an error that says what kind of failure it was. */
320
+ async function refusal(response) {
321
+ let body = {};
322
+ try {
323
+ body = (await response.json());
324
+ }
325
+ catch {
326
+ // Not ours: a proxy's page.
327
+ }
328
+ const failure = body.failure ??
329
+ (response.status === 401 || response.status === 403
330
+ ? { kind: 'auth' }
331
+ : response.status === 429
332
+ ? { kind: 'quota' }
333
+ : response.status === 404 || response.status >= 500
334
+ ? { kind: 'unavailable' }
335
+ : undefined);
336
+ const said = typeof body.error === 'string' ? body.error : response.statusText || `HTTP ${response.status}`;
337
+ return new Failed(`The assistant refused: ${said}.`, failure, response.status);
338
+ }
339
+ async function attach(files, maxText) {
340
+ const attached = { text: '', images: [] };
341
+ for (const [index, file] of files.entries()) {
342
+ const name = file.name;
343
+ const label = typeof name === 'string' && name ? name : `attachment ${index + 1}`;
344
+ if (IMAGE_TYPES.has(file.type)) {
345
+ attached.images.push({ mediaType: file.type, data: await base64(file), name: label });
346
+ attached.text += `\n\nAttached image: "${label}".`;
347
+ }
348
+ else if (TEXT_TYPES.test(file.type) || TEXT_NAMES.test(label)) {
349
+ const text = await file.text();
350
+ const cut = text.length > maxText;
351
+ attached.text += `\n\nAttached file "${label}"${cut ? ` (the first ${maxText} of ${text.length} characters)` : ''}:\n${cut ? text.slice(0, maxText) : text}`;
352
+ }
353
+ else {
354
+ throw new Error(`"${label}" cannot be attached: the assistant reads text files and images only.`);
355
+ }
356
+ }
357
+ return attached;
358
+ }
359
+ async function base64(file) {
360
+ const bytes = new Uint8Array(await file.arrayBuffer());
361
+ let binary = '';
362
+ for (let i = 0; i < bytes.length; i += 0x8000)
363
+ binary += String.fromCharCode(...bytes.subarray(i, i + 0x8000));
364
+ return btoa(binary);
365
+ }
366
+ function describe(error) {
367
+ return error instanceof Error ? error.message || error.name : String(error);
368
+ }
369
+ function clip(text, max) {
370
+ return text.length <= max ? text : `${text.slice(0, max)}\n[cut: ${text.length - max} more characters]`;
371
+ }
372
+ //# sourceMappingURL=remote.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"remote.js","sourceRoot":"","sources":["../../src/browser/remote.ts"],"names":[],"mappings":"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"}
package/dist/browser.d.ts CHANGED
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * `genaicode/browser`: an agent that runs in the page, on the browser's built-in model (Gemini
3
- * Nano through Chrome's Prompt API), and the page's tools offered to outside agents over WebMCP.
4
- * No server, no key, no cost per token. Nothing here imports Node.
3
+ * Nano through Chrome's Prompt API) or on a model behind your server (`remote()`), and the page's
4
+ * tools offered to outside agents over WebMCP. Nothing here imports Node.
5
5
  *
6
6
  * ```ts
7
7
  * import { createPageAgent, exposeWebMcp, type PageTool } from 'genaicode/browser';
@@ -22,9 +22,16 @@
22
22
  * ```
23
23
  *
24
24
  * Draw it with `<PageAgentChat agent={assistant} />` from `genaicode/react`.
25
+ *
26
+ * With a model behind your server (`createAgentBackend()` from `genaicode/backend`), the same page
27
+ * agent runs on `remote({ url, tools })`, and `withFallback([remote(...), nano(...)])` goes on with
28
+ * the built-in model when the server is out.
25
29
  */
26
30
  export { nano, briefing } from './browser/nano.js';
27
31
  export type { NanoAgent, NanoModelCall, NanoOptions, NanoTask } from './browser/nano.js';
32
+ export { remote } from './browser/remote.js';
33
+ export type { RemoteAgent, RemoteOptions } from './browser/remote.js';
34
+ export { withFallback } from './agents/failover.js';
28
35
  export { createPageAgent } from './browser/page-agent.js';
29
36
  export type { PageAgent, PageAgentOptions, PageAgentState, PageModelStatus } from './browser/page-agent.js';
30
37
  export { exposeWebMcp, webMcpSupported, webMcpTools } from './browser/webmcp.js';
package/dist/browser.js CHANGED
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * `genaicode/browser`: an agent that runs in the page, on the browser's built-in model (Gemini
3
- * Nano through Chrome's Prompt API), and the page's tools offered to outside agents over WebMCP.
4
- * No server, no key, no cost per token. Nothing here imports Node.
3
+ * Nano through Chrome's Prompt API) or on a model behind your server (`remote()`), and the page's
4
+ * tools offered to outside agents over WebMCP. Nothing here imports Node.
5
5
  *
6
6
  * ```ts
7
7
  * import { createPageAgent, exposeWebMcp, type PageTool } from 'genaicode/browser';
@@ -22,8 +22,14 @@
22
22
  * ```
23
23
  *
24
24
  * Draw it with `<PageAgentChat agent={assistant} />` from `genaicode/react`.
25
+ *
26
+ * With a model behind your server (`createAgentBackend()` from `genaicode/backend`), the same page
27
+ * agent runs on `remote({ url, tools })`, and `withFallback([remote(...), nano(...)])` goes on with
28
+ * the built-in model when the server is out.
25
29
  */
26
30
  export { nano, briefing } from './browser/nano.js';
31
+ export { remote } from './browser/remote.js';
32
+ export { withFallback } from './agents/failover.js';
27
33
  export { createPageAgent } from './browser/page-agent.js';
28
34
  export { exposeWebMcp, webMcpSupported, webMcpTools } from './browser/webmcp.js';
29
35
  export { argumentProblems, toolText } from './browser/tools.js';
@@ -1 +1 @@
1
- {"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEjF,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEhE,OAAO,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAS9F,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC"}
1
+ {"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEjF,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEhE,OAAO,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAS9F,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC"}
@@ -6,6 +6,28 @@ export type CliCommand = {
6
6
  } | {
7
7
  kind: 'agents';
8
8
  json: boolean;
9
+ } | {
10
+ kind: 'sessions';
11
+ json: boolean;
12
+ agent?: string;
13
+ cwd?: string;
14
+ /** `--cloud`: also the vendor clouds this environment has keys for. */
15
+ cloud: boolean;
16
+ /** `--since 7d`: only sessions active in this many milliseconds. */
17
+ sinceMs?: number;
18
+ limit: number;
19
+ }
20
+ /** `sessions doctor`: whether the session stores still read as expected. */
21
+ | {
22
+ kind: 'doctor';
23
+ json: boolean;
24
+ api: boolean;
25
+ agent?: string;
26
+ sinceMs?: number;
27
+ } | {
28
+ kind: 'hooks';
29
+ action: 'status' | 'install' | 'uninstall';
30
+ agent?: string;
9
31
  } | {
10
32
  kind: 'chat' | 'ui';
11
33
  agent?: string;
@@ -13,6 +35,8 @@ export type CliCommand = {
13
35
  model?: string;
14
36
  effort?: string;
15
37
  resume?: string;
38
+ /** `--from <id>`: take over this session of any agent. */
39
+ from?: string;
16
40
  approveAll: boolean;
17
41
  port?: number;
18
42
  open: boolean;
@@ -58,6 +82,8 @@ export type CliCommand = {
58
82
  effort?: string;
59
83
  maxTurns?: number;
60
84
  resume?: string;
85
+ /** `--from <id>`: take over this session of any agent. */
86
+ from?: string;
61
87
  timeoutMs?: number;
62
88
  verify?: string;
63
89
  maxRepairs: number;
package/dist/cli/args.js CHANGED
@@ -12,6 +12,60 @@ export function parseCli(argv) {
12
12
  const { values } = parse(() => parseArgs({ args: rest, options: { json: { type: 'boolean' } }, strict: true }));
13
13
  return { kind: 'agents', json: values.json === true };
14
14
  }
15
+ if (command === 'sessions') {
16
+ const { values, positionals } = parse(() => parseArgs({
17
+ args: rest,
18
+ strict: true,
19
+ allowPositionals: true,
20
+ options: {
21
+ json: { type: 'boolean' },
22
+ cloud: { type: 'boolean' },
23
+ api: { type: 'boolean' },
24
+ agent: { type: 'string', short: 'a' },
25
+ cwd: { type: 'string', short: 'C' },
26
+ since: { type: 'string' },
27
+ limit: { type: 'string', short: 'n' },
28
+ },
29
+ }));
30
+ const limit = optionalNumber(values.limit, '--limit');
31
+ if (positionals.length) {
32
+ const extra = values.cloud || values.cwd !== undefined || values.limit !== undefined;
33
+ if (positionals.length > 1 || positionals[0] !== 'doctor' || extra) {
34
+ throw new UsageError('Usage: genaicode sessions [doctor] [options]. "doctor" takes -a, --since and --json.');
35
+ }
36
+ return {
37
+ kind: 'doctor',
38
+ json: values.json === true,
39
+ api: values.api === true,
40
+ ...(values.agent !== undefined ? { agent: values.agent } : {}),
41
+ ...(values.since !== undefined ? { sinceMs: durationOf(values.since) } : {}),
42
+ };
43
+ }
44
+ if (values.api)
45
+ throw new UsageError('--api belongs to "genaicode sessions doctor".');
46
+ return {
47
+ kind: 'sessions',
48
+ json: values.json === true,
49
+ cloud: values.cloud === true,
50
+ ...(values.agent !== undefined ? { agent: values.agent } : {}),
51
+ ...(values.cwd !== undefined ? { cwd: values.cwd } : {}),
52
+ ...(values.since !== undefined ? { sinceMs: durationOf(values.since) } : {}),
53
+ limit: limit ?? 30,
54
+ };
55
+ }
56
+ if (command === 'hooks') {
57
+ const { values, positionals } = parse(() => parseArgs({
58
+ args: rest,
59
+ strict: true,
60
+ allowPositionals: true,
61
+ options: { agent: { type: 'string', short: 'a' } },
62
+ }));
63
+ const action = positionals[0] ?? 'status';
64
+ if (positionals.length > 1 || (action !== 'status' && action !== 'install' && action !== 'uninstall')) {
65
+ throw new UsageError('Usage: genaicode hooks [status|install|uninstall] [-a <agent>]');
66
+ }
67
+ return { kind: 'hooks', action, ...(values.agent !== undefined ? { agent: values.agent } : {}) };
68
+ }
15
69
  if (command === 'chat' || command === 'ui') {
16
70
  const { values } = parse(() => parseArgs({
17
71
  args: rest,
@@ -22,6 +76,7 @@ export function parseCli(argv) {
22
76
  model: { type: 'string', short: 'm' },
23
77
  effort: { type: 'string' },
24
78
  resume: { type: 'string', short: 'r' },
79
+ from: { type: 'string' },
25
80
  yes: { type: 'boolean', short: 'y' },
26
81
  port: { type: 'string' },
27
82
  mcp: { type: 'string', multiple: true },
@@ -45,6 +100,7 @@ export function parseCli(argv) {
45
100
  model: values.model,
46
101
  effort: values.effort,
47
102
  resume: values.resume,
103
+ ...(values.from ? { from: values.from } : {}),
48
104
  approveAll: values.yes === true,
49
105
  port,
50
106
  open: extra['no-open'] !== true,
@@ -122,6 +178,7 @@ export function parseCli(argv) {
122
178
  effort: { type: 'string' },
123
179
  'max-turns': { type: 'string' },
124
180
  resume: { type: 'string', short: 'r' },
181
+ from: { type: 'string' },
125
182
  timeout: { type: 'string' },
126
183
  verify: { type: 'string' },
127
184
  'max-repairs': { type: 'string' },
@@ -142,6 +199,7 @@ export function parseCli(argv) {
142
199
  effort: values.effort,
143
200
  maxTurns: optionalNumber(values['max-turns'], '--max-turns'),
144
201
  resume: values.resume,
202
+ ...(values.from ? { from: values.from } : {}),
145
203
  timeoutMs: timeout === undefined ? undefined : timeout * 1000,
146
204
  verify: values.verify,
147
205
  maxRepairs: optionalNumber(values['max-repairs'], '--max-repairs') ?? 2,
@@ -160,6 +218,14 @@ function parseMcp(value) {
160
218
  throw new UsageError(`--mcp expects name=http(s)://url, got "${value}".`);
161
219
  return { name: match[1], url: match[2] };
162
220
  }
221
+ const UNIT_MS = { m: 60_000, h: 3_600_000, d: 86_400_000, w: 7 * 86_400_000 };
222
+ /** `--since 90m`, `12h`, `7d`, `2w` in milliseconds. */
223
+ function durationOf(value) {
224
+ const match = /^(\d+)([mhdw])$/.exec(value);
225
+ if (!match)
226
+ throw new UsageError('--since expects a number and a unit, e.g. 90m, 12h, 7d or 2w.');
227
+ return Number(match[1]) * UNIT_MS[match[2]];
228
+ }
163
229
  function parse(call) {
164
230
  try {
165
231
  return call();