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.
- package/README.md +1 -0
- package/dist/agents/artifacts.d.ts +1 -1
- package/dist/agents/artifacts.js +4 -65
- package/dist/agents/artifacts.js.map +1 -1
- package/dist/agents/cli-agent.d.ts +3 -0
- package/dist/agents/cli-agent.js +1 -0
- package/dist/agents/cli-agent.js.map +1 -1
- package/dist/agents/drivers/anthropic-managed.d.ts +145 -0
- package/dist/agents/drivers/anthropic-managed.js +799 -0
- package/dist/agents/drivers/anthropic-managed.js.map +1 -0
- package/dist/agents/drivers/antigravity.js +2 -0
- package/dist/agents/drivers/antigravity.js.map +1 -1
- package/dist/agents/drivers/claude.js +2 -0
- package/dist/agents/drivers/claude.js.map +1 -1
- package/dist/agents/drivers/codex-live.js +2 -0
- package/dist/agents/drivers/codex-live.js.map +1 -1
- package/dist/agents/drivers/codex.js +2 -0
- package/dist/agents/drivers/codex.js.map +1 -1
- package/dist/agents/drivers/copilot.js +2 -0
- package/dist/agents/drivers/copilot.js.map +1 -1
- package/dist/agents/drivers/cursor-cloud.d.ts +78 -0
- package/dist/agents/drivers/cursor-cloud.js +523 -0
- package/dist/agents/drivers/cursor-cloud.js.map +1 -0
- package/dist/agents/drivers/cursor.js +2 -0
- package/dist/agents/drivers/cursor.js.map +1 -1
- package/dist/agents/drivers/gemini-managed.d.ts +78 -0
- package/dist/agents/drivers/gemini-managed.js +528 -0
- package/dist/agents/drivers/gemini-managed.js.map +1 -0
- package/dist/agents/drivers/gemini.js +2 -0
- package/dist/agents/drivers/gemini.js.map +1 -1
- package/dist/agents/drivers/managed-http.d.ts +28 -0
- package/dist/agents/drivers/managed-http.js +142 -0
- package/dist/agents/drivers/managed-http.js.map +1 -0
- package/dist/agents/drivers/muse-live.js +2 -0
- package/dist/agents/drivers/muse-live.js.map +1 -1
- package/dist/agents/drivers/muse.js +2 -0
- package/dist/agents/drivers/muse.js.map +1 -1
- package/dist/agents/drivers/openai-managed.d.ts +79 -0
- package/dist/agents/drivers/openai-managed.js +404 -0
- package/dist/agents/drivers/openai-managed.js.map +1 -0
- package/dist/agents/drivers/opencode.js +2 -0
- package/dist/agents/drivers/opencode.js.map +1 -1
- package/dist/agents/drivers/vibe.js +2 -0
- package/dist/agents/drivers/vibe.js.map +1 -1
- package/dist/agents/failover.d.ts +19 -1
- package/dist/agents/failover.js +63 -2
- package/dist/agents/failover.js.map +1 -1
- package/dist/agents/hosted.d.ts +5 -1
- package/dist/agents/hosted.js +47 -132
- package/dist/agents/hosted.js.map +1 -1
- package/dist/agents/live-agent.d.ts +3 -0
- package/dist/agents/live-agent.js +1 -0
- package/dist/agents/live-agent.js.map +1 -1
- package/dist/agents/managed.d.ts +157 -0
- package/dist/agents/managed.js +562 -0
- package/dist/agents/managed.js.map +1 -0
- package/dist/agents/mcp-server.d.ts +19 -0
- package/dist/agents/mcp-server.js +74 -0
- package/dist/agents/mcp-server.js.map +1 -0
- package/dist/agents/pack-git.d.ts +23 -0
- package/dist/agents/pack-git.js +112 -0
- package/dist/agents/pack-git.js.map +1 -0
- package/dist/agents/pack.d.ts +68 -0
- package/dist/agents/pack.js +611 -0
- package/dist/agents/pack.js.map +1 -0
- package/dist/agents/runtime.d.ts +5 -1
- package/dist/agents/runtime.js +9 -0
- package/dist/agents/runtime.js.map +1 -1
- package/dist/agents/session.d.ts +10 -0
- package/dist/agents/session.js +26 -0
- package/dist/agents/session.js.map +1 -1
- package/dist/agents/sessions/claude.d.ts +14 -0
- package/dist/agents/sessions/claude.js +233 -0
- package/dist/agents/sessions/claude.js.map +1 -0
- package/dist/agents/sessions/codex-api.d.ts +32 -0
- package/dist/agents/sessions/codex-api.js +233 -0
- package/dist/agents/sessions/codex-api.js.map +1 -0
- package/dist/agents/sessions/codex.d.ts +28 -0
- package/dist/agents/sessions/codex.js +430 -0
- package/dist/agents/sessions/codex.js.map +1 -0
- package/dist/agents/sessions/doctor.d.ts +67 -0
- package/dist/agents/sessions/doctor.js +182 -0
- package/dist/agents/sessions/doctor.js.map +1 -0
- package/dist/agents/sessions/files.d.ts +44 -0
- package/dist/agents/sessions/files.js +150 -0
- package/dist/agents/sessions/files.js.map +1 -0
- package/dist/agents/sessions/group.d.ts +24 -0
- package/dist/agents/sessions/group.js +27 -0
- package/dist/agents/sessions/group.js.map +1 -0
- package/dist/agents/sessions/hooks.d.ts +32 -0
- package/dist/agents/sessions/hooks.js +155 -0
- package/dist/agents/sessions/hooks.js.map +1 -0
- package/dist/agents/sessions/index.d.ts +42 -0
- package/dist/agents/sessions/index.js +97 -0
- package/dist/agents/sessions/index.js.map +1 -0
- package/dist/agents/sessions/live.d.ts +67 -0
- package/dist/agents/sessions/live.js +308 -0
- package/dist/agents/sessions/live.js.map +1 -0
- package/dist/agents/sessions/sqlite.d.ts +12 -0
- package/dist/agents/sessions/sqlite.js +61 -0
- package/dist/agents/sessions/sqlite.js.map +1 -0
- package/dist/agents/sessions/stores.d.ts +38 -0
- package/dist/agents/sessions/stores.js +616 -0
- package/dist/agents/sessions/stores.js.map +1 -0
- package/dist/agents/sessions/transcript.d.ts +20 -0
- package/dist/agents/sessions/transcript.js +134 -0
- package/dist/agents/sessions/transcript.js.map +1 -0
- package/dist/agents/sessions/types.d.ts +95 -0
- package/dist/agents/sessions/types.js +2 -0
- package/dist/agents/sessions/types.js.map +1 -0
- package/dist/agents/types.d.ts +31 -0
- package/dist/agents.d.ts +17 -1
- package/dist/agents.js +9 -1
- package/dist/agents.js.map +1 -1
- package/dist/backend/backend.d.ts +131 -0
- package/dist/backend/backend.js +773 -0
- package/dist/backend/backend.js.map +1 -0
- package/dist/backend/limiter.d.ts +34 -0
- package/dist/backend/limiter.js +76 -0
- package/dist/backend/limiter.js.map +1 -0
- package/dist/backend/node.d.ts +10 -0
- package/dist/backend/node.js +124 -0
- package/dist/backend/node.js.map +1 -0
- package/dist/backend/protocol.d.ts +98 -0
- package/dist/backend/protocol.js +2 -0
- package/dist/backend/protocol.js.map +1 -0
- package/dist/backend/seal.d.ts +7 -0
- package/dist/backend/seal.js +60 -0
- package/dist/backend/seal.js.map +1 -0
- package/dist/backend.d.ts +27 -0
- package/dist/backend.js +25 -0
- package/dist/backend.js.map +1 -0
- package/dist/browser/invoke.d.ts +17 -0
- package/dist/browser/invoke.js +69 -0
- package/dist/browser/invoke.js.map +1 -0
- package/dist/browser/nano.d.ts +10 -0
- package/dist/browser/nano.js +10 -56
- package/dist/browser/nano.js.map +1 -1
- package/dist/browser/page-agent.d.ts +7 -0
- package/dist/browser/page-agent.js +26 -5
- package/dist/browser/page-agent.js.map +1 -1
- package/dist/browser/remote.d.ts +44 -0
- package/dist/browser/remote.js +372 -0
- package/dist/browser/remote.js.map +1 -0
- package/dist/browser.d.ts +9 -2
- package/dist/browser.js +8 -2
- package/dist/browser.js.map +1 -1
- package/dist/cli/args.d.ts +26 -0
- package/dist/cli/args.js +66 -0
- package/dist/cli/args.js.map +1 -1
- package/dist/cli/hook.d.ts +7 -0
- package/dist/cli/hook.js +21 -0
- package/dist/cli/hook.js.map +1 -0
- package/dist/cli/main.d.ts +3 -1
- package/dist/cli/main.js +237 -2
- package/dist/cli/main.js.map +1 -1
- package/dist/cli.js +31 -21
- package/dist/cli.js.map +1 -1
- package/dist/core/types.d.ts +5 -0
- package/dist/core/types.js.map +1 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/dist/providers/google-converter.js +21 -8
- package/dist/providers/google-converter.js.map +1 -1
- package/dist/providers/google.js +7 -10
- package/dist/providers/google.js.map +1 -1
- package/dist/providers/openai-converter.js +3 -2
- package/dist/providers/openai-converter.js.map +1 -1
- package/dist/providers/openai-responses-converter.d.ts +35 -0
- package/dist/providers/openai-responses-converter.js +188 -0
- package/dist/providers/openai-responses-converter.js.map +1 -0
- package/dist/providers/openai.d.ts +6 -1
- package/dist/providers/openai.js +16 -1
- package/dist/providers/openai.js.map +1 -1
- package/dist/providers.d.ts +1 -0
- package/dist/providers.js +1 -0
- package/dist/providers.js.map +1 -1
- package/dist/react/page-agent-chat.js +6 -2
- package/dist/react/page-agent-chat.js.map +1 -1
- package/dist/ui/index.js +109 -82
- package/dist/ui/sessions.d.ts +19 -0
- package/dist/ui/sessions.js +59 -0
- package/dist/ui/sessions.js.map +1 -0
- package/dist/ui/web-client.js +15 -14
- package/docs/CHANGELOG.md +51 -388
- package/docs/agents.md +417 -2
- package/docs/backend.md +125 -0
- package/docs/browser.md +6 -1
- package/docs/changelog-2.26-and-older.md +441 -0
- package/docs/cli.md +39 -0
- package/docs/llm.md +6 -1
- package/docs/pivot.md +1 -1
- package/package.json +5 -1
package/dist/agents/failover.js
CHANGED
|
@@ -23,12 +23,26 @@ export function describeFailover(from, to, failure) {
|
|
|
23
23
|
* Each agent gets `model` only if it is the first one and `resume` only if the session is its own
|
|
24
24
|
* (another vendor's ids mean nothing to it), `effort` only where it takes it, and `budget` minus what earlier agents used.
|
|
25
25
|
* The result adds up every agent's usage and cost. A `failover` event marks each switch. Capabilities are the first agent's.
|
|
26
|
+
*
|
|
27
|
+
* Where an agent has `info()`, so does the result: available when any agent is, with the inputs of
|
|
28
|
+
* the first available one, and an agent without `info()` counts as available. Runs after it start
|
|
29
|
+
* with that agent: one that said it is not available is tried after the others.
|
|
30
|
+
* `forget()` reaches every agent that has it.
|
|
26
31
|
*/
|
|
27
32
|
export function withFallback(agents) {
|
|
28
33
|
const [first] = agents;
|
|
29
34
|
if (!first)
|
|
30
35
|
throw new Error('withFallback needs at least one agent.');
|
|
31
36
|
const out = new Set();
|
|
37
|
+
// Agents whose last info() said they are not available: runs try them after the rest, even
|
|
38
|
+
// after one that failed earlier but says it is available now.
|
|
39
|
+
const down = new Set();
|
|
40
|
+
// Agents info() could not ask: after the ones that said they are available, before `down`.
|
|
41
|
+
const unasked = new Set();
|
|
42
|
+
const ordered = () => {
|
|
43
|
+
const rank = (agent) => (down.has(agent) ? 4 : unasked.has(agent) ? 2 : 0) + (out.has(agent) ? 1 : 0);
|
|
44
|
+
return [...agents].sort((a, b) => rank(a) - rank(b));
|
|
45
|
+
};
|
|
32
46
|
// The agent whose session the last result named: a `resume` id is only its.
|
|
33
47
|
let sessionOwner;
|
|
34
48
|
/** `task` as `agent` can take it: vendor ids only for the agent they belong to. */
|
|
@@ -44,7 +58,51 @@ export function withFallback(agents) {
|
|
|
44
58
|
...(budget ? { budget } : {}),
|
|
45
59
|
};
|
|
46
60
|
};
|
|
61
|
+
const described = agents;
|
|
62
|
+
const extra = {};
|
|
63
|
+
if (described.some((agent) => agent.info)) {
|
|
64
|
+
extra.info = async (signal) => {
|
|
65
|
+
const answers = await Promise.all(described.map(async (agent) => {
|
|
66
|
+
if (!agent.info)
|
|
67
|
+
return { available: true };
|
|
68
|
+
try {
|
|
69
|
+
return await agent.info(signal);
|
|
70
|
+
}
|
|
71
|
+
catch (error) {
|
|
72
|
+
return error instanceof Error ? error : new Error(String(error));
|
|
73
|
+
}
|
|
74
|
+
}));
|
|
75
|
+
down.clear();
|
|
76
|
+
unasked.clear();
|
|
77
|
+
answers.forEach((answer, i) => {
|
|
78
|
+
if (answer instanceof Error)
|
|
79
|
+
unasked.add(described[i]);
|
|
80
|
+
else if (!answer.available)
|
|
81
|
+
down.add(described[i]);
|
|
82
|
+
});
|
|
83
|
+
// The inputs of the agent a run starts with.
|
|
84
|
+
for (const agent of ordered()) {
|
|
85
|
+
const answer = answers[described.indexOf(agent)];
|
|
86
|
+
if (!(answer instanceof Error) && answer.available) {
|
|
87
|
+
return { available: true, ...(answer.inputs ? { inputs: answer.inputs } : {}) };
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
// None says it is available; one that could not be asked may still be.
|
|
91
|
+
const unknown = answers.find((answer) => answer instanceof Error);
|
|
92
|
+
if (unknown)
|
|
93
|
+
throw unknown;
|
|
94
|
+
const resets = answers.flatMap((answer) => answer.resetsAt !== undefined ? [answer.resetsAt] : []);
|
|
95
|
+
return { available: false, ...(resets.length ? { resetsAt: Math.min(...resets) } : {}) };
|
|
96
|
+
};
|
|
97
|
+
}
|
|
98
|
+
if (described.some((agent) => agent.forget)) {
|
|
99
|
+
extra.forget = (sessionId) => {
|
|
100
|
+
for (const agent of described)
|
|
101
|
+
agent.forget?.(sessionId);
|
|
102
|
+
};
|
|
103
|
+
}
|
|
47
104
|
return {
|
|
105
|
+
...extra,
|
|
48
106
|
name: first.name,
|
|
49
107
|
command: first.command,
|
|
50
108
|
capabilities: first.capabilities,
|
|
@@ -53,7 +111,7 @@ export function withFallback(agents) {
|
|
|
53
111
|
let current;
|
|
54
112
|
let stopped = false;
|
|
55
113
|
const result = (async () => {
|
|
56
|
-
const order =
|
|
114
|
+
const order = ordered();
|
|
57
115
|
let budget = task.budget;
|
|
58
116
|
let usage;
|
|
59
117
|
let costUsd;
|
|
@@ -100,8 +158,11 @@ export function withFallback(agents) {
|
|
|
100
158
|
const isOut = shouldFailOver(ended);
|
|
101
159
|
if (isOut)
|
|
102
160
|
out.add(agent);
|
|
103
|
-
else if (ended.ok)
|
|
161
|
+
else if (ended.ok) {
|
|
104
162
|
out.delete(agent);
|
|
163
|
+
down.delete(agent);
|
|
164
|
+
unasked.delete(agent);
|
|
165
|
+
}
|
|
105
166
|
if (stopped || !to || !isOut || left === 'spent') {
|
|
106
167
|
events.push({ type: 'done', result: ended });
|
|
107
168
|
events.close();
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"failover.js","sourceRoot":"","sources":["../../src/agents/failover.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGlD,uGAAuG;AACvG,MAAM,cAAc,GAAsC,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC;AAE7G,yEAAyE;AACzE,MAAM,UAAU,cAAc,CAAC,MAAmB;IAChD,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,IAAI,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACnG,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,EAAU,EAAE,OAAqB;IAC9E,MAAM,MAAM,GACV,OAAO,CAAC,QAAQ,KAAK,SAAS;QAC5B,CAAC,CAAC,YAAY,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,kBAAkB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,EAAE;QACzG,CAAC,CAAC,EAAE,CAAC;IACT,OAAO,GAAG,IAAI,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,GAAG,MAAM,GAAG,CAAC;AACtD,CAAC;
|
|
1
|
+
{"version":3,"file":"failover.js","sourceRoot":"","sources":["../../src/agents/failover.ts"],"names":[],"mappings":"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"}
|
package/dist/agents/hosted.d.ts
CHANGED
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { type ManagedProvider } from './managed.js';
|
|
1
2
|
import type { AgentCapabilities, AgentEvent, AgentTask, CodingAgent } from './types.js';
|
|
2
3
|
export type HostedTaskState = 'queued' | 'running' | 'completed' | 'failed' | 'cancelled';
|
|
3
4
|
/** What a hosted provider receives. `cwd` is the provider's workspace reference (a repo, a branch...). */
|
|
@@ -12,7 +13,8 @@ export interface HostedPoll {
|
|
|
12
13
|
}
|
|
13
14
|
/**
|
|
14
15
|
* A remote coding-agent service: tasks run on the vendor's machines and are polled.
|
|
15
|
-
* Implement this for a hosted product and pass it to `hostedAgent()`.
|
|
16
|
+
* Implement this for a hosted product and pass it to `hostedAgent()`. For approvals, usage,
|
|
17
|
+
* budgets, live streams or sessions that outlive the process, implement `ManagedProvider`.
|
|
16
18
|
*/
|
|
17
19
|
export interface HostedAgentProvider {
|
|
18
20
|
readonly name: string;
|
|
@@ -31,3 +33,5 @@ export interface HostedAgentOptions {
|
|
|
31
33
|
}
|
|
32
34
|
/** Adapt a `HostedAgentProvider` to `CodingAgent`, so hosted and local agents share one API. */
|
|
33
35
|
export declare function hostedAgent(provider: HostedAgentProvider, options?: HostedAgentOptions): CodingAgent;
|
|
36
|
+
/** A `HostedAgentProvider` as a `ManagedProvider`: polled, no approvals, usage or native budget. */
|
|
37
|
+
export declare function fromHosted(provider: HostedAgentProvider): ManagedProvider;
|
package/dist/agents/hosted.js
CHANGED
|
@@ -1,139 +1,54 @@
|
|
|
1
|
-
import {
|
|
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
|
-
|
|
14
|
-
|
|
15
|
-
const
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
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
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
13
|
+
const managed = {
|
|
14
|
+
name: provider.name,
|
|
15
|
+
// A hosted provider is asked about one task at a time; it lists nothing.
|
|
16
|
+
sessions: null,
|
|
17
|
+
capabilities: provider.capabilities ?? {},
|
|
18
|
+
async start(request, signal) {
|
|
19
|
+
const task = {
|
|
20
|
+
prompt: request.prompt,
|
|
21
|
+
cwd: request.workspace ?? '.',
|
|
22
|
+
...(request.model !== undefined ? { model: request.model } : {}),
|
|
23
|
+
...(request.effort !== undefined ? { effort: request.effort } : {}),
|
|
24
|
+
...(request.maxTurns !== undefined ? { maxTurns: request.maxTurns } : {}),
|
|
25
|
+
...(request.resume !== undefined ? { resume: request.resume } : {}),
|
|
26
|
+
...(request.extraArgs !== undefined ? { extraArgs: request.extraArgs } : {}),
|
|
27
|
+
...(request.mcpServers !== undefined ? { mcpServers: request.mcpServers } : {}),
|
|
28
|
+
...(request.permissions !== undefined ? { permissions: request.permissions } : {}),
|
|
29
|
+
...(request.budget !== undefined ? { budget: request.budget } : {}),
|
|
30
|
+
};
|
|
31
|
+
const { id } = await provider.start(task, signal ?? new AbortController().signal);
|
|
32
|
+
return { id, state: 'queued' };
|
|
33
|
+
},
|
|
34
|
+
async get(id, signal) {
|
|
35
|
+
return snapshot(id, await provider.poll(id, undefined, signal ?? new AbortController().signal));
|
|
36
|
+
},
|
|
37
|
+
async events(id, cursor, signal) {
|
|
38
|
+
const poll = await provider.poll(id, cursor, signal ?? new AbortController().signal);
|
|
39
|
+
return {
|
|
40
|
+
events: poll.events ?? [],
|
|
41
|
+
...(poll.cursor !== undefined ? { cursor: poll.cursor } : {}),
|
|
42
|
+
snapshot: snapshot(id, poll),
|
|
43
|
+
};
|
|
44
|
+
},
|
|
45
|
+
...(provider.send ? { send: (id, text) => provider.send(id, text) } : {}),
|
|
46
|
+
async interrupt(id) {
|
|
47
|
+
await provider.cancel(id);
|
|
48
|
+
return { enforced: true };
|
|
49
|
+
},
|
|
113
50
|
};
|
|
114
|
-
|
|
115
|
-
|
|
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
|
-
});
|
|
51
|
+
// Hosted providers never declared resume or MCP support: keep forwarding those fields as before.
|
|
52
|
+
return Object.assign(managed, { [UNCHECKED_FIELDS]: true });
|
|
138
53
|
}
|
|
139
54
|
//# sourceMappingURL=hosted.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"hosted.js","sourceRoot":"","sources":["../../src/agents/hosted.ts"],"names":[],"mappings":"AAAA,OAAO,
|
|
1
|
+
{"version":3,"file":"hosted.js","sourceRoot":"","sources":["../../src/agents/hosted.ts"],"names":[],"mappings":"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"}
|
|
@@ -2,6 +2,7 @@ import { type PreparedRun } from './prepare.js';
|
|
|
2
2
|
import { RpcPeer, type RpcRequestContext } from './rpc.js';
|
|
3
3
|
import { type AgentOutcome } from './runtime.js';
|
|
4
4
|
import type { AgentCapabilities, AgentEvent, AgentTask, ApprovalDecision, ApprovalRequest, CodingAgent } from './types.js';
|
|
5
|
+
import type { SessionSource } from './sessions/types.js';
|
|
5
6
|
/** What a live driver gets for one task. */
|
|
6
7
|
export interface LiveSession {
|
|
7
8
|
readonly task: AgentTask;
|
|
@@ -43,6 +44,8 @@ export interface LiveAgentDefinition {
|
|
|
43
44
|
name: string;
|
|
44
45
|
command: string;
|
|
45
46
|
capabilities?: AgentCapabilities;
|
|
47
|
+
/** Where the agent keeps its sessions (`CodingAgent.sessions`). */
|
|
48
|
+
sessions?: SessionSource | null;
|
|
46
49
|
/** Arguments that start the agent's JSON-RPC server on stdio. */
|
|
47
50
|
args(task: AgentTask): string[];
|
|
48
51
|
/** Replaces `args` when a task needs setup: extra env, temp files to clean up. */
|
|
@@ -13,6 +13,7 @@ export function liveAgent(definition) {
|
|
|
13
13
|
name: definition.name,
|
|
14
14
|
command: definition.command,
|
|
15
15
|
capabilities: { steer: true, ...definition.capabilities },
|
|
16
|
+
...(definition.sessions !== undefined ? { sessions: definition.sessions } : {}),
|
|
16
17
|
run: (task) => runLiveAgent(definition, task),
|
|
17
18
|
};
|
|
18
19
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"live-agent.js","sourceRoot":"","sources":["../../src/agents/live-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAoB,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,OAAO,EAA0B,MAAM,UAAU,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAqB,MAAM,cAAc,CAAC;
|
|
1
|
+
{"version":3,"file":"live-agent.js","sourceRoot":"","sources":["../../src/agents/live-agent.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,157 @@
|
|
|
1
|
+
import type { TokenUsage } from '../core/types.js';
|
|
2
|
+
import type { AgentBudget, AgentCapabilities, AgentEvent, AgentFailure, AgentPermissions, ApprovalDecision, CodingAgent, McpServer } from './types.js';
|
|
3
|
+
import type { SessionSource } from './sessions/types.js';
|
|
4
|
+
/**
|
|
5
|
+
* Where a managed session stands.
|
|
6
|
+
* - `idle`: the agent finished its turn and waits for input (`stopReason` says why).
|
|
7
|
+
* - `completed` / `failed` / `cancelled` / `timeout`: the session is over.
|
|
8
|
+
*/
|
|
9
|
+
export type ManagedState = 'queued' | 'running' | 'idle' | 'completed' | 'failed' | 'cancelled' | 'timeout';
|
|
10
|
+
/**
|
|
11
|
+
* Why an `idle` or ended session stopped, normalized across vendors:
|
|
12
|
+
* `end-turn` (done, waiting for input), `requires-action` (an approval is open), `budget` (a cap
|
|
13
|
+
* was reached), `error`. Other values are the vendor's own word.
|
|
14
|
+
*/
|
|
15
|
+
export type ManagedStopReason = 'end-turn' | 'requires-action' | 'budget' | 'error' | (string & {});
|
|
16
|
+
/** What a managed platform can do, beyond the `CodingAgent` capabilities it shares. */
|
|
17
|
+
export interface ManagedCapabilities extends AgentCapabilities {
|
|
18
|
+
/** Budget units the platform enforces itself, stopping the session at the cap. */
|
|
19
|
+
budget?: readonly ('usd' | 'tokens')[];
|
|
20
|
+
/** Accepts `ManagedStart.files`. */
|
|
21
|
+
files?: boolean;
|
|
22
|
+
}
|
|
23
|
+
/** A file placed in the session's workspace before the agent starts. */
|
|
24
|
+
export interface ManagedFile {
|
|
25
|
+
/** Relative to the workspace root. */
|
|
26
|
+
path: string;
|
|
27
|
+
content: string | Uint8Array;
|
|
28
|
+
}
|
|
29
|
+
/** Everything a managed session starts from. Fields a provider cannot honor make `start` reject. */
|
|
30
|
+
export interface ManagedStart {
|
|
31
|
+
prompt: string;
|
|
32
|
+
/** Extra system instructions for this session. */
|
|
33
|
+
system?: string;
|
|
34
|
+
model?: string;
|
|
35
|
+
effort?: string;
|
|
36
|
+
maxTurns?: number;
|
|
37
|
+
/** The provider's workspace reference: a repository, a branch, an environment id. */
|
|
38
|
+
workspace?: string;
|
|
39
|
+
/** Remote MCP servers only. `headers` carry per-session credentials and never appear in events. */
|
|
40
|
+
mcpServers?: readonly McpServer[];
|
|
41
|
+
files?: readonly ManagedFile[];
|
|
42
|
+
/**
|
|
43
|
+
* Passed on to the platform's own cap where `capabilities.budget` has the unit. Platforms cap the
|
|
44
|
+
* whole session, so on `resume` `managedAgent()` adds what the session spent before this run.
|
|
45
|
+
*/
|
|
46
|
+
budget?: AgentBudget;
|
|
47
|
+
/** Wall-clock cap the platform enforces, where it has one. */
|
|
48
|
+
maxDurationSeconds?: number;
|
|
49
|
+
/** Continue an earlier session: a previous snapshot's `id`. */
|
|
50
|
+
resume?: string;
|
|
51
|
+
permissions?: AgentPermissions;
|
|
52
|
+
/** Extra arguments for providers that take them (most managed platforms do not). */
|
|
53
|
+
extraArgs?: readonly string[];
|
|
54
|
+
/** The caller's id for this work, for the platform's names, metadata and logs. */
|
|
55
|
+
correlationId?: string;
|
|
56
|
+
/** Vendor-specific options, documented by each driver. */
|
|
57
|
+
vendor?: Readonly<Record<string, unknown>>;
|
|
58
|
+
}
|
|
59
|
+
/** Token usage, plus the vendor's own breakdown (thought, tool use, reasoning, cache writes...). */
|
|
60
|
+
export interface ManagedUsage extends TokenUsage {
|
|
61
|
+
details?: Readonly<Record<string, number>>;
|
|
62
|
+
}
|
|
63
|
+
/** A managed session as the platform reports it now. Safe to store: it carries no secrets. */
|
|
64
|
+
export interface ManagedSnapshot {
|
|
65
|
+
id: string;
|
|
66
|
+
state: ManagedState;
|
|
67
|
+
stopReason?: ManagedStopReason;
|
|
68
|
+
/** The agent's last message, when the platform reports it with the session. */
|
|
69
|
+
text?: string;
|
|
70
|
+
/** Why the session failed. */
|
|
71
|
+
error?: string;
|
|
72
|
+
failure?: AgentFailure;
|
|
73
|
+
/** Cumulative for the session; `managedAgent()` reports a resumed run's share as the change since it began. */
|
|
74
|
+
usage?: ManagedUsage;
|
|
75
|
+
costUsd?: number;
|
|
76
|
+
model?: string;
|
|
77
|
+
/** The vendor's own word for the state. */
|
|
78
|
+
vendorState?: string;
|
|
79
|
+
/** Per-session resources `release()` frees: credential vaults, uploaded files, sandboxes. */
|
|
80
|
+
release?: readonly string[];
|
|
81
|
+
/**
|
|
82
|
+
* Event position this snapshot stands at, for `events()` and `watch()`. `start()` should set it
|
|
83
|
+
* just before the new turn's first event, so a resumed session's history is not read again.
|
|
84
|
+
*/
|
|
85
|
+
cursor?: string;
|
|
86
|
+
/** Epoch milliseconds. */
|
|
87
|
+
startedAt?: number;
|
|
88
|
+
endedAt?: number;
|
|
89
|
+
}
|
|
90
|
+
/** Events since `cursor`, and the session's state when the platform reports it with them. */
|
|
91
|
+
export interface ManagedEventPage {
|
|
92
|
+
events: AgentEvent[];
|
|
93
|
+
cursor?: string;
|
|
94
|
+
/** More events wait past `cursor`: read them before the next interval. */
|
|
95
|
+
hasMore?: boolean;
|
|
96
|
+
snapshot?: ManagedSnapshot;
|
|
97
|
+
}
|
|
98
|
+
/** One step of a live event stream: events, a new snapshot, or both. */
|
|
99
|
+
export interface ManagedUpdate {
|
|
100
|
+
events?: AgentEvent[];
|
|
101
|
+
snapshot?: ManagedSnapshot;
|
|
102
|
+
/** Position after these events, handed back to `watch` when it reconnects. */
|
|
103
|
+
cursor?: string;
|
|
104
|
+
}
|
|
105
|
+
/**
|
|
106
|
+
* A hosted agent platform (Anthropic Managed Agents, Gemini Managed Agents, OpenAI, Cursor...).
|
|
107
|
+
*
|
|
108
|
+
* Every method addresses a session by id, so a session can outlive the process that started it:
|
|
109
|
+
* store `snapshot.id` and call `get` later. `managedAgent()` turns a provider into a `CodingAgent`.
|
|
110
|
+
*/
|
|
111
|
+
export interface ManagedProvider {
|
|
112
|
+
readonly name: string;
|
|
113
|
+
readonly capabilities: ManagedCapabilities;
|
|
114
|
+
/** The platform's sessions, for `listSessions()` (`CodingAgent.sessions`). */
|
|
115
|
+
readonly sessions?: SessionSource | null;
|
|
116
|
+
start(request: ManagedStart, signal?: AbortSignal): Promise<ManagedSnapshot>;
|
|
117
|
+
/** `null`: the session does not exist (any more). */
|
|
118
|
+
get(id: string, signal?: AbortSignal): Promise<ManagedSnapshot | null>;
|
|
119
|
+
/** Events since `cursor`, for platforms that are polled. */
|
|
120
|
+
events?(id: string, cursor: string | undefined, signal?: AbortSignal): Promise<ManagedEventPage>;
|
|
121
|
+
/**
|
|
122
|
+
* A live stream of the session; it ends when the session settles or `signal` aborts. On a
|
|
123
|
+
* reconnect `cursor` is the last update's, so the stream resumes after it rather than replaying.
|
|
124
|
+
*/
|
|
125
|
+
watch?(id: string, signal: AbortSignal, cursor?: string): AsyncIterable<ManagedUpdate>;
|
|
126
|
+
/** Add input: steers a running turn, or starts the next one on an idle session. */
|
|
127
|
+
send?(id: string, text: string): Promise<void>;
|
|
128
|
+
/** Answer an `approval-request` the session emitted. */
|
|
129
|
+
answer?(id: string, approvalId: string, decision: ApprovalDecision, note?: string): Promise<void>;
|
|
130
|
+
/** Stop the current work. `enforced: false` when the platform could not confirm it. */
|
|
131
|
+
interrupt(id: string): Promise<{
|
|
132
|
+
enforced: boolean;
|
|
133
|
+
}>;
|
|
134
|
+
/** Free the snapshot's per-session resources (`snapshot.release`). Safe to call twice. */
|
|
135
|
+
release?(snapshot: ManagedSnapshot): Promise<void>;
|
|
136
|
+
/** Delete the session and its history. */
|
|
137
|
+
delete?(id: string): Promise<void>;
|
|
138
|
+
}
|
|
139
|
+
export interface ManagedAgentOptions {
|
|
140
|
+
/** Delay between polls when the provider has no `watch`. Default 5 s. */
|
|
141
|
+
pollIntervalMs?: number;
|
|
142
|
+
/** Delete the session after the run. Default false: it stays for `task.resume`. */
|
|
143
|
+
deleteSession?: boolean;
|
|
144
|
+
/** Extra `ManagedStart` fields for every run (`system`, `files`, `vendor`...). */
|
|
145
|
+
start?: Omit<Partial<ManagedStart>, 'prompt'>;
|
|
146
|
+
}
|
|
147
|
+
/** True once the session will do no more work by itself. */
|
|
148
|
+
export declare function isManagedSettled(snapshot: Pick<ManagedSnapshot, 'state' | 'stopReason'>): boolean;
|
|
149
|
+
/** Adapt a `ManagedProvider` to `CodingAgent`, so hosted and local agents share one API. */
|
|
150
|
+
export declare function managedAgent(provider: ManagedProvider, options?: ManagedAgentOptions): CodingAgent;
|
|
151
|
+
/** Marks a provider adapted from `HostedAgentProvider`, which forwards task fields unchecked as it always did. */
|
|
152
|
+
export declare const UNCHECKED_FIELDS: unique symbol;
|
|
153
|
+
/**
|
|
154
|
+
* What a provider exception says about the platform: an explicit `failure`, an HTTP status
|
|
155
|
+
* (`status`, `statusCode`, `response.status`) or a network error code (also on `cause`).
|
|
156
|
+
*/
|
|
157
|
+
export declare function failureOfError(error: unknown): AgentFailure | undefined;
|