genaicode 2.33.0 → 2.34.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 (82) hide show
  1. package/README.md +1 -0
  2. package/dist/agents/drivers/anthropic-managed.d.ts +141 -0
  3. package/dist/agents/drivers/anthropic-managed.js +753 -0
  4. package/dist/agents/drivers/anthropic-managed.js.map +1 -0
  5. package/dist/agents/drivers/cursor-cloud.d.ts +78 -0
  6. package/dist/agents/drivers/cursor-cloud.js +478 -0
  7. package/dist/agents/drivers/cursor-cloud.js.map +1 -0
  8. package/dist/agents/drivers/gemini-managed.d.ts +78 -0
  9. package/dist/agents/drivers/gemini-managed.js +526 -0
  10. package/dist/agents/drivers/gemini-managed.js.map +1 -0
  11. package/dist/agents/drivers/managed-http.d.ts +28 -0
  12. package/dist/agents/drivers/managed-http.js +142 -0
  13. package/dist/agents/drivers/managed-http.js.map +1 -0
  14. package/dist/agents/drivers/openai-managed.d.ts +79 -0
  15. package/dist/agents/drivers/openai-managed.js +402 -0
  16. package/dist/agents/drivers/openai-managed.js.map +1 -0
  17. package/dist/agents/failover.d.ts +19 -1
  18. package/dist/agents/failover.js +63 -2
  19. package/dist/agents/failover.js.map +1 -1
  20. package/dist/agents/hosted.d.ts +5 -1
  21. package/dist/agents/hosted.js +45 -132
  22. package/dist/agents/hosted.js.map +1 -1
  23. package/dist/agents/managed.d.ts +154 -0
  24. package/dist/agents/managed.js +561 -0
  25. package/dist/agents/managed.js.map +1 -0
  26. package/dist/agents/runtime.d.ts +5 -1
  27. package/dist/agents/runtime.js +9 -0
  28. package/dist/agents/runtime.js.map +1 -1
  29. package/dist/agents.d.ts +11 -1
  30. package/dist/agents.js +6 -1
  31. package/dist/agents.js.map +1 -1
  32. package/dist/backend/backend.d.ts +131 -0
  33. package/dist/backend/backend.js +773 -0
  34. package/dist/backend/backend.js.map +1 -0
  35. package/dist/backend/limiter.d.ts +34 -0
  36. package/dist/backend/limiter.js +76 -0
  37. package/dist/backend/limiter.js.map +1 -0
  38. package/dist/backend/node.d.ts +10 -0
  39. package/dist/backend/node.js +124 -0
  40. package/dist/backend/node.js.map +1 -0
  41. package/dist/backend/protocol.d.ts +98 -0
  42. package/dist/backend/protocol.js +2 -0
  43. package/dist/backend/protocol.js.map +1 -0
  44. package/dist/backend/seal.d.ts +7 -0
  45. package/dist/backend/seal.js +60 -0
  46. package/dist/backend/seal.js.map +1 -0
  47. package/dist/backend.d.ts +27 -0
  48. package/dist/backend.js +25 -0
  49. package/dist/backend.js.map +1 -0
  50. package/dist/browser/invoke.d.ts +17 -0
  51. package/dist/browser/invoke.js +69 -0
  52. package/dist/browser/invoke.js.map +1 -0
  53. package/dist/browser/nano.d.ts +10 -0
  54. package/dist/browser/nano.js +10 -56
  55. package/dist/browser/nano.js.map +1 -1
  56. package/dist/browser/page-agent.d.ts +7 -0
  57. package/dist/browser/page-agent.js +26 -5
  58. package/dist/browser/page-agent.js.map +1 -1
  59. package/dist/browser/remote.d.ts +44 -0
  60. package/dist/browser/remote.js +372 -0
  61. package/dist/browser/remote.js.map +1 -0
  62. package/dist/browser.d.ts +9 -2
  63. package/dist/browser.js +8 -2
  64. package/dist/browser.js.map +1 -1
  65. package/dist/core/types.d.ts +5 -0
  66. package/dist/core/types.js.map +1 -1
  67. package/dist/index.d.ts +1 -1
  68. package/dist/index.js +1 -1
  69. package/dist/index.js.map +1 -1
  70. package/dist/providers/google-converter.js +3 -0
  71. package/dist/providers/google-converter.js.map +1 -1
  72. package/dist/providers/google.js +7 -10
  73. package/dist/providers/google.js.map +1 -1
  74. package/dist/react/page-agent-chat.js +6 -2
  75. package/dist/react/page-agent-chat.js.map +1 -1
  76. package/docs/CHANGELOG.md +38 -395
  77. package/docs/agents.md +207 -1
  78. package/docs/backend.md +125 -0
  79. package/docs/browser.md +6 -1
  80. package/docs/changelog-2.26-and-older.md +441 -0
  81. package/docs/pivot.md +1 -1
  82. package/package.json +5 -1
@@ -1,139 +1,52 @@
1
- import { resolvePermissions, unsupportedPermissions } from './permissions.js';
2
- import { RunRecorder } from './runtime.js';
3
- const TERMINAL = new Set(['completed', 'failed', 'cancelled']);
1
+ import { managedAgent, UNCHECKED_FIELDS, } from './managed.js';
4
2
  /** Adapt a `HostedAgentProvider` to `CodingAgent`, so hosted and local agents share one API. */
5
3
  export function hostedAgent(provider, options = {}) {
6
- return {
7
- name: provider.name,
8
- command: provider.name,
9
- capabilities: { ...provider.capabilities, steer: !!provider.send },
10
- run: (task) => runHosted(provider, task, options.pollIntervalMs ?? 5_000),
11
- };
4
+ return managedAgent(fromHosted(provider), { pollIntervalMs: options.pollIntervalMs ?? 5_000 });
12
5
  }
13
- function runHosted(provider, task, pollIntervalMs) {
14
- const recorder = new RunRecorder(provider.name, provider.name);
15
- const controller = new AbortController();
16
- let stopReason;
17
- let taskId;
18
- const stop = (reason) => {
19
- if (stopReason || controller.signal.aborted)
20
- return;
21
- stopReason = reason;
22
- controller.abort();
23
- };
24
- const onAbort = () => stop('aborted');
25
- task.signal?.addEventListener('abort', onAbort, { once: true });
26
- if (task.signal?.aborted)
27
- onAbort();
28
- recorder.watchBudget(task.budget, onAbort);
29
- const timer = task.timeoutMs !== undefined ? setTimeout(() => stop('timeout'), task.timeoutMs) : undefined;
30
- const exit = (reason, error) => ({
31
- exitCode: null,
32
- signal: null,
33
- reason,
34
- ...(error ? { error } : {}),
35
- });
36
- const work = async () => {
37
- // Local-only fields (process env, callbacks, timers) never reach the provider.
38
- const request = { ...task };
39
- delete request.env;
40
- delete request.signal;
41
- delete request.onApproval;
42
- delete request.timeoutMs;
43
- const refused = unsupportedPermissions(provider.name, provider.capabilities ?? {}, task);
44
- if (refused)
45
- return { exit: exit('spawn-error', new Error(refused)) };
46
- if (task.permissions !== undefined)
47
- request.permissions = resolvePermissions(task.permissions);
48
- // The provider contract has no channel to bring a question back to onApproval.
49
- if (resolvePermissions(task.permissions).approval === 'ask')
50
- return { exit: exit('spawn-error', new Error(`${provider.name} cannot run with permissions.approval 'ask'.`)) };
51
- try {
52
- taskId = (await provider.start(request, controller.signal)).id;
53
- }
54
- catch (error) {
55
- if (stopReason)
56
- return { exit: exit(stopReason) };
57
- return { exit: exit('spawn-error', error instanceof Error ? error : new Error(String(error))) };
58
- }
59
- recorder.emit({ type: 'session', sessionId: taskId });
60
- let cursor;
61
- while (!stopReason) {
62
- let poll;
63
- try {
64
- poll = await provider.poll(taskId, cursor, controller.signal);
65
- }
66
- catch (error) {
67
- if (stopReason)
68
- break;
69
- // Do not leave a task running (and billing) that nobody watches any more.
70
- await provider.cancel(taskId).catch(() => undefined);
71
- const message = error instanceof Error ? error.message : String(error);
72
- return { exit: exit('closed'), outcome: { ok: false, error: `Polling ${provider.name} failed: ${message}` } };
73
- }
74
- // Aborted while the poll was in flight: cancel, whatever state it reported.
75
- if (stopReason)
76
- break;
77
- for (const event of poll.events ?? [])
78
- recorder.emit(event);
79
- cursor = poll.cursor ?? cursor;
80
- if (TERMINAL.has(poll.state)) {
81
- if (poll.state === 'cancelled')
82
- return { exit: exit('aborted') };
83
- return {
84
- exit: exit('closed'),
85
- outcome: poll.state === 'completed'
86
- ? { ok: true }
87
- : { ok: false, error: poll.error ?? `${provider.name} task failed.` },
88
- };
89
- }
90
- // A consumer that falls behind holds the next poll instead of buffering without bound.
91
- await untilAborted(recorder.events.room(), controller.signal);
92
- await delay(pollIntervalMs, controller.signal);
93
- }
94
- await provider.cancel(taskId).catch(() => undefined);
95
- return { exit: exit(stopReason ?? 'aborted') };
96
- };
97
- const result = work().then(({ exit: ended, outcome }) => {
98
- clearTimeout(timer);
99
- task.signal?.removeEventListener('abort', onAbort);
100
- return recorder.finish(ended, outcome);
6
+ /** A `HostedAgentProvider` as a `ManagedProvider`: polled, no approvals, usage or native budget. */
7
+ export function fromHosted(provider) {
8
+ const snapshot = (id, poll) => ({
9
+ id,
10
+ state: poll.state,
11
+ ...(poll.error !== undefined ? { error: poll.error } : {}),
101
12
  });
102
- return {
103
- result,
104
- abort: () => stop('aborted'),
105
- ...(provider.send
106
- ? {
107
- steer: (text) => taskId && !stopReason
108
- ? provider.send(taskId, text)
109
- : Promise.reject(new Error(`${provider.name} is not accepting input.`)),
110
- }
111
- : {}),
112
- [Symbol.asyncIterator]: () => recorder.events.iterate(),
13
+ const managed = {
14
+ name: provider.name,
15
+ capabilities: provider.capabilities ?? {},
16
+ async start(request, signal) {
17
+ const task = {
18
+ prompt: request.prompt,
19
+ cwd: request.workspace ?? '.',
20
+ ...(request.model !== undefined ? { model: request.model } : {}),
21
+ ...(request.effort !== undefined ? { effort: request.effort } : {}),
22
+ ...(request.maxTurns !== undefined ? { maxTurns: request.maxTurns } : {}),
23
+ ...(request.resume !== undefined ? { resume: request.resume } : {}),
24
+ ...(request.extraArgs !== undefined ? { extraArgs: request.extraArgs } : {}),
25
+ ...(request.mcpServers !== undefined ? { mcpServers: request.mcpServers } : {}),
26
+ ...(request.permissions !== undefined ? { permissions: request.permissions } : {}),
27
+ ...(request.budget !== undefined ? { budget: request.budget } : {}),
28
+ };
29
+ const { id } = await provider.start(task, signal ?? new AbortController().signal);
30
+ return { id, state: 'queued' };
31
+ },
32
+ async get(id, signal) {
33
+ return snapshot(id, await provider.poll(id, undefined, signal ?? new AbortController().signal));
34
+ },
35
+ async events(id, cursor, signal) {
36
+ const poll = await provider.poll(id, cursor, signal ?? new AbortController().signal);
37
+ return {
38
+ events: poll.events ?? [],
39
+ ...(poll.cursor !== undefined ? { cursor: poll.cursor } : {}),
40
+ snapshot: snapshot(id, poll),
41
+ };
42
+ },
43
+ ...(provider.send ? { send: (id, text) => provider.send(id, text) } : {}),
44
+ async interrupt(id) {
45
+ await provider.cancel(id);
46
+ return { enforced: true };
47
+ },
113
48
  };
114
- }
115
- function delay(ms, signal) {
116
- return new Promise((resolve) => {
117
- const timer = setTimeout(done, ms);
118
- signal.addEventListener('abort', done, { once: true });
119
- function done() {
120
- clearTimeout(timer);
121
- signal.removeEventListener('abort', done);
122
- resolve();
123
- }
124
- });
125
- }
126
- /** Resolve when `wait` does or `signal` aborts, whichever comes first. */
127
- function untilAborted(wait, signal) {
128
- if (signal.aborted)
129
- return Promise.resolve();
130
- return new Promise((resolve) => {
131
- const done = () => {
132
- signal.removeEventListener('abort', done);
133
- resolve();
134
- };
135
- signal.addEventListener('abort', done, { once: true });
136
- void wait.then(done);
137
- });
49
+ // Hosted providers never declared resume or MCP support: keep forwarding those fields as before.
50
+ return Object.assign(managed, { [UNCHECKED_FIELDS]: true });
138
51
  }
139
52
  //# sourceMappingURL=hosted.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"hosted.js","sourceRoot":"","sources":["../../src/agents/hosted.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"hosted.js","sourceRoot":"","sources":["../../src/agents/hosted.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,154 @@
1
+ import type { TokenUsage } from '../core/types.js';
2
+ import type { AgentBudget, AgentCapabilities, AgentEvent, AgentFailure, AgentPermissions, ApprovalDecision, CodingAgent, McpServer } from './types.js';
3
+ /**
4
+ * Where a managed session stands.
5
+ * - `idle`: the agent finished its turn and waits for input (`stopReason` says why).
6
+ * - `completed` / `failed` / `cancelled` / `timeout`: the session is over.
7
+ */
8
+ export type ManagedState = 'queued' | 'running' | 'idle' | 'completed' | 'failed' | 'cancelled' | 'timeout';
9
+ /**
10
+ * Why an `idle` or ended session stopped, normalized across vendors:
11
+ * `end-turn` (done, waiting for input), `requires-action` (an approval is open), `budget` (a cap
12
+ * was reached), `error`. Other values are the vendor's own word.
13
+ */
14
+ export type ManagedStopReason = 'end-turn' | 'requires-action' | 'budget' | 'error' | (string & {});
15
+ /** What a managed platform can do, beyond the `CodingAgent` capabilities it shares. */
16
+ export interface ManagedCapabilities extends AgentCapabilities {
17
+ /** Budget units the platform enforces itself, stopping the session at the cap. */
18
+ budget?: readonly ('usd' | 'tokens')[];
19
+ /** Accepts `ManagedStart.files`. */
20
+ files?: boolean;
21
+ }
22
+ /** A file placed in the session's workspace before the agent starts. */
23
+ export interface ManagedFile {
24
+ /** Relative to the workspace root. */
25
+ path: string;
26
+ content: string | Uint8Array;
27
+ }
28
+ /** Everything a managed session starts from. Fields a provider cannot honor make `start` reject. */
29
+ export interface ManagedStart {
30
+ prompt: string;
31
+ /** Extra system instructions for this session. */
32
+ system?: string;
33
+ model?: string;
34
+ effort?: string;
35
+ maxTurns?: number;
36
+ /** The provider's workspace reference: a repository, a branch, an environment id. */
37
+ workspace?: string;
38
+ /** Remote MCP servers only. `headers` carry per-session credentials and never appear in events. */
39
+ mcpServers?: readonly McpServer[];
40
+ files?: readonly ManagedFile[];
41
+ /**
42
+ * Passed on to the platform's own cap where `capabilities.budget` has the unit. Platforms cap the
43
+ * whole session, so on `resume` `managedAgent()` adds what the session spent before this run.
44
+ */
45
+ budget?: AgentBudget;
46
+ /** Wall-clock cap the platform enforces, where it has one. */
47
+ maxDurationSeconds?: number;
48
+ /** Continue an earlier session: a previous snapshot's `id`. */
49
+ resume?: string;
50
+ permissions?: AgentPermissions;
51
+ /** Extra arguments for providers that take them (most managed platforms do not). */
52
+ extraArgs?: readonly string[];
53
+ /** The caller's id for this work, for the platform's names, metadata and logs. */
54
+ correlationId?: string;
55
+ /** Vendor-specific options, documented by each driver. */
56
+ vendor?: Readonly<Record<string, unknown>>;
57
+ }
58
+ /** Token usage, plus the vendor's own breakdown (thought, tool use, reasoning, cache writes...). */
59
+ export interface ManagedUsage extends TokenUsage {
60
+ details?: Readonly<Record<string, number>>;
61
+ }
62
+ /** A managed session as the platform reports it now. Safe to store: it carries no secrets. */
63
+ export interface ManagedSnapshot {
64
+ id: string;
65
+ state: ManagedState;
66
+ stopReason?: ManagedStopReason;
67
+ /** The agent's last message, when the platform reports it with the session. */
68
+ text?: string;
69
+ /** Why the session failed. */
70
+ error?: string;
71
+ failure?: AgentFailure;
72
+ /** Cumulative for the session; `managedAgent()` reports a resumed run's share as the change since it began. */
73
+ usage?: ManagedUsage;
74
+ costUsd?: number;
75
+ model?: string;
76
+ /** The vendor's own word for the state. */
77
+ vendorState?: string;
78
+ /** Per-session resources `release()` frees: credential vaults, uploaded files, sandboxes. */
79
+ release?: readonly string[];
80
+ /**
81
+ * Event position this snapshot stands at, for `events()` and `watch()`. `start()` should set it
82
+ * just before the new turn's first event, so a resumed session's history is not read again.
83
+ */
84
+ cursor?: string;
85
+ /** Epoch milliseconds. */
86
+ startedAt?: number;
87
+ endedAt?: number;
88
+ }
89
+ /** Events since `cursor`, and the session's state when the platform reports it with them. */
90
+ export interface ManagedEventPage {
91
+ events: AgentEvent[];
92
+ cursor?: string;
93
+ /** More events wait past `cursor`: read them before the next interval. */
94
+ hasMore?: boolean;
95
+ snapshot?: ManagedSnapshot;
96
+ }
97
+ /** One step of a live event stream: events, a new snapshot, or both. */
98
+ export interface ManagedUpdate {
99
+ events?: AgentEvent[];
100
+ snapshot?: ManagedSnapshot;
101
+ /** Position after these events, handed back to `watch` when it reconnects. */
102
+ cursor?: string;
103
+ }
104
+ /**
105
+ * A hosted agent platform (Anthropic Managed Agents, Gemini Managed Agents, OpenAI, Cursor...).
106
+ *
107
+ * Every method addresses a session by id, so a session can outlive the process that started it:
108
+ * store `snapshot.id` and call `get` later. `managedAgent()` turns a provider into a `CodingAgent`.
109
+ */
110
+ export interface ManagedProvider {
111
+ readonly name: string;
112
+ readonly capabilities: ManagedCapabilities;
113
+ start(request: ManagedStart, signal?: AbortSignal): Promise<ManagedSnapshot>;
114
+ /** `null`: the session does not exist (any more). */
115
+ get(id: string, signal?: AbortSignal): Promise<ManagedSnapshot | null>;
116
+ /** Events since `cursor`, for platforms that are polled. */
117
+ events?(id: string, cursor: string | undefined, signal?: AbortSignal): Promise<ManagedEventPage>;
118
+ /**
119
+ * A live stream of the session; it ends when the session settles or `signal` aborts. On a
120
+ * reconnect `cursor` is the last update's, so the stream resumes after it rather than replaying.
121
+ */
122
+ watch?(id: string, signal: AbortSignal, cursor?: string): AsyncIterable<ManagedUpdate>;
123
+ /** Add input: steers a running turn, or starts the next one on an idle session. */
124
+ send?(id: string, text: string): Promise<void>;
125
+ /** Answer an `approval-request` the session emitted. */
126
+ answer?(id: string, approvalId: string, decision: ApprovalDecision, note?: string): Promise<void>;
127
+ /** Stop the current work. `enforced: false` when the platform could not confirm it. */
128
+ interrupt(id: string): Promise<{
129
+ enforced: boolean;
130
+ }>;
131
+ /** Free the snapshot's per-session resources (`snapshot.release`). Safe to call twice. */
132
+ release?(snapshot: ManagedSnapshot): Promise<void>;
133
+ /** Delete the session and its history. */
134
+ delete?(id: string): Promise<void>;
135
+ }
136
+ export interface ManagedAgentOptions {
137
+ /** Delay between polls when the provider has no `watch`. Default 5 s. */
138
+ pollIntervalMs?: number;
139
+ /** Delete the session after the run. Default false: it stays for `task.resume`. */
140
+ deleteSession?: boolean;
141
+ /** Extra `ManagedStart` fields for every run (`system`, `files`, `vendor`...). */
142
+ start?: Omit<Partial<ManagedStart>, 'prompt'>;
143
+ }
144
+ /** True once the session will do no more work by itself. */
145
+ export declare function isManagedSettled(snapshot: Pick<ManagedSnapshot, 'state' | 'stopReason'>): boolean;
146
+ /** Adapt a `ManagedProvider` to `CodingAgent`, so hosted and local agents share one API. */
147
+ export declare function managedAgent(provider: ManagedProvider, options?: ManagedAgentOptions): CodingAgent;
148
+ /** Marks a provider adapted from `HostedAgentProvider`, which forwards task fields unchecked as it always did. */
149
+ export declare const UNCHECKED_FIELDS: unique symbol;
150
+ /**
151
+ * What a provider exception says about the platform: an explicit `failure`, an HTTP status
152
+ * (`status`, `statusCode`, `response.status`) or a network error code (also on `cause`).
153
+ */
154
+ export declare function failureOfError(error: unknown): AgentFailure | undefined;