@providerkit/agents 0.1.0 → 0.2.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/LICENSE-APACHE-2.0 +202 -0
- package/README.md +2108 -52
- package/THIRD_PARTY_NOTICES.md +521 -0
- package/dist/a2a/auth.d.ts +10 -0
- package/dist/a2a/auth.d.ts.map +1 -0
- package/dist/a2a/auth.js +52 -0
- package/dist/a2a/auth.js.map +1 -0
- package/dist/a2a/client.d.ts +74 -0
- package/dist/a2a/client.d.ts.map +1 -0
- package/dist/a2a/client.js +601 -0
- package/dist/a2a/client.js.map +1 -0
- package/dist/a2a/index.d.ts +22 -0
- package/dist/a2a/index.d.ts.map +1 -0
- package/dist/a2a/index.js +11 -0
- package/dist/a2a/index.js.map +1 -0
- package/dist/a2a/memory-runs.d.ts +62 -0
- package/dist/a2a/memory-runs.d.ts.map +1 -0
- package/dist/a2a/memory-runs.js +349 -0
- package/dist/a2a/memory-runs.js.map +1 -0
- package/dist/a2a/policy.d.ts +15 -0
- package/dist/a2a/policy.d.ts.map +1 -0
- package/dist/a2a/policy.js +114 -0
- package/dist/a2a/policy.js.map +1 -0
- package/dist/a2a/push.d.ts +34 -0
- package/dist/a2a/push.d.ts.map +1 -0
- package/dist/a2a/push.js +180 -0
- package/dist/a2a/push.js.map +1 -0
- package/dist/a2a/remote.d.ts +155 -0
- package/dist/a2a/remote.d.ts.map +1 -0
- package/dist/a2a/remote.js +1196 -0
- package/dist/a2a/remote.js.map +1 -0
- package/dist/a2a/server.d.ts +110 -0
- package/dist/a2a/server.d.ts.map +1 -0
- package/dist/a2a/server.js +1139 -0
- package/dist/a2a/server.js.map +1 -0
- package/dist/a2a/signing.d.ts +21 -0
- package/dist/a2a/signing.d.ts.map +1 -0
- package/dist/a2a/signing.js +305 -0
- package/dist/a2a/signing.js.map +1 -0
- package/dist/a2a/tasks.d.ts +88 -0
- package/dist/a2a/tasks.d.ts.map +1 -0
- package/dist/a2a/tasks.js +170 -0
- package/dist/a2a/tasks.js.map +1 -0
- package/dist/a2a/wire.d.ts +267 -0
- package/dist/a2a/wire.d.ts.map +1 -0
- package/dist/a2a/wire.js +1202 -0
- package/dist/a2a/wire.js.map +1 -0
- package/dist/background-types.d.ts +76 -0
- package/dist/background-types.d.ts.map +1 -0
- package/dist/background-types.js +2 -0
- package/dist/background-types.js.map +1 -0
- package/dist/child.d.ts +25 -0
- package/dist/child.d.ts.map +1 -0
- package/dist/child.js +129 -0
- package/dist/child.js.map +1 -0
- package/dist/code-driver.d.ts +40 -0
- package/dist/code-driver.d.ts.map +1 -0
- package/dist/code-driver.js +2 -0
- package/dist/code-driver.js.map +1 -0
- package/dist/code-mode.d.ts +3 -0
- package/dist/code-mode.d.ts.map +1 -0
- package/dist/code-mode.js +2 -0
- package/dist/code-mode.js.map +1 -0
- package/dist/code-script.d.ts +3 -0
- package/dist/code-script.d.ts.map +1 -0
- package/dist/code-script.js +149 -0
- package/dist/code-script.js.map +1 -0
- package/dist/code.d.ts +75 -0
- package/dist/code.d.ts.map +1 -0
- package/dist/code.js +326 -0
- package/dist/code.js.map +1 -0
- package/dist/compaction.d.ts +15 -0
- package/dist/compaction.d.ts.map +1 -0
- package/dist/compaction.js +168 -0
- package/dist/compaction.js.map +1 -0
- package/dist/delegation.d.ts +85 -16
- package/dist/delegation.d.ts.map +1 -1
- package/dist/delegation.js +240 -106
- package/dist/delegation.js.map +1 -1
- package/dist/evals/driver.d.ts +10 -0
- package/dist/evals/driver.d.ts.map +1 -0
- package/dist/evals/driver.js +192 -0
- package/dist/evals/driver.js.map +1 -0
- package/dist/evals/journal.d.ts +26 -0
- package/dist/evals/journal.d.ts.map +1 -0
- package/dist/evals/journal.js +483 -0
- package/dist/evals/journal.js.map +1 -0
- package/dist/evals/judge.d.ts +31 -0
- package/dist/evals/judge.d.ts.map +1 -0
- package/dist/evals/judge.js +142 -0
- package/dist/evals/judge.js.map +1 -0
- package/dist/evals/report.d.ts +38 -0
- package/dist/evals/report.d.ts.map +1 -0
- package/dist/evals/report.js +241 -0
- package/dist/evals/report.js.map +1 -0
- package/dist/evals/runner.d.ts +24 -0
- package/dist/evals/runner.d.ts.map +1 -0
- package/dist/evals/runner.js +655 -0
- package/dist/evals/runner.js.map +1 -0
- package/dist/evals/scorers.d.ts +36 -0
- package/dist/evals/scorers.d.ts.map +1 -0
- package/dist/evals/scorers.js +259 -0
- package/dist/evals/scorers.js.map +1 -0
- package/dist/evals/simulation.d.ts +7 -0
- package/dist/evals/simulation.d.ts.map +1 -0
- package/dist/evals/simulation.js +38 -0
- package/dist/evals/simulation.js.map +1 -0
- package/dist/evals/testing.d.ts +36 -0
- package/dist/evals/testing.d.ts.map +1 -0
- package/dist/evals/testing.js +87 -0
- package/dist/evals/testing.js.map +1 -0
- package/dist/evals/trajectory.d.ts +11 -0
- package/dist/evals/trajectory.d.ts.map +1 -0
- package/dist/evals/trajectory.js +180 -0
- package/dist/evals/trajectory.js.map +1 -0
- package/dist/evals/types.d.ts +431 -0
- package/dist/evals/types.d.ts.map +1 -0
- package/dist/evals/types.js +4 -0
- package/dist/evals/types.js.map +1 -0
- package/dist/evals.d.ts +14 -0
- package/dist/evals.d.ts.map +1 -0
- package/dist/evals.js +9 -0
- package/dist/evals.js.map +1 -0
- package/dist/extensions.d.ts +33 -0
- package/dist/extensions.d.ts.map +1 -0
- package/dist/extensions.js +188 -0
- package/dist/extensions.js.map +1 -0
- package/dist/handoff.d.ts +58 -0
- package/dist/handoff.d.ts.map +1 -0
- package/dist/handoff.js +160 -0
- package/dist/handoff.js.map +1 -0
- package/dist/index.d.ts +14 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +8 -0
- package/dist/index.js.map +1 -1
- package/dist/input.d.ts +42 -0
- package/dist/input.d.ts.map +1 -0
- package/dist/input.js +266 -0
- package/dist/input.js.map +1 -0
- package/dist/mcp.d.ts +77 -0
- package/dist/mcp.d.ts.map +1 -0
- package/dist/mcp.js +505 -0
- package/dist/mcp.js.map +1 -0
- package/dist/memory-store.d.ts +11 -0
- package/dist/memory-store.d.ts.map +1 -0
- package/dist/memory-store.js +272 -0
- package/dist/memory-store.js.map +1 -0
- package/dist/memory.d.ts +212 -0
- package/dist/memory.d.ts.map +1 -0
- package/dist/memory.js +613 -0
- package/dist/memory.js.map +1 -0
- package/dist/otel.d.ts +74 -0
- package/dist/otel.d.ts.map +1 -0
- package/dist/otel.js +427 -0
- package/dist/otel.js.map +1 -0
- package/dist/progress.d.ts +17 -0
- package/dist/progress.d.ts.map +1 -0
- package/dist/progress.js +193 -0
- package/dist/progress.js.map +1 -0
- package/dist/quickjs.d.ts +19 -0
- package/dist/quickjs.d.ts.map +1 -0
- package/dist/quickjs.js +519 -0
- package/dist/quickjs.js.map +1 -0
- package/dist/recovery.d.ts +10 -0
- package/dist/recovery.d.ts.map +1 -0
- package/dist/recovery.js +62 -0
- package/dist/recovery.js.map +1 -0
- package/dist/request.d.ts +88 -0
- package/dist/request.d.ts.map +1 -0
- package/dist/request.js +422 -0
- package/dist/request.js.map +1 -0
- package/dist/run.d.ts +16 -4
- package/dist/run.d.ts.map +1 -1
- package/dist/run.js +2016 -245
- package/dist/run.js.map +1 -1
- package/dist/runs.d.ts +77 -34
- package/dist/runs.d.ts.map +1 -1
- package/dist/runs.js +267 -85
- package/dist/runs.js.map +1 -1
- package/dist/schema-to-ts.d.ts +4 -0
- package/dist/schema-to-ts.d.ts.map +1 -0
- package/dist/schema-to-ts.js +191 -0
- package/dist/schema-to-ts.js.map +1 -0
- package/dist/session.d.ts +23 -0
- package/dist/session.d.ts.map +1 -0
- package/dist/session.js +137 -0
- package/dist/session.js.map +1 -0
- package/dist/snapshot.d.ts +57 -8
- package/dist/snapshot.d.ts.map +1 -1
- package/dist/snapshot.js +1206 -109
- package/dist/snapshot.js.map +1 -1
- package/dist/steering.d.ts +75 -0
- package/dist/steering.d.ts.map +1 -0
- package/dist/steering.js +214 -0
- package/dist/steering.js.map +1 -0
- package/dist/subagents.d.ts +141 -0
- package/dist/subagents.d.ts.map +1 -0
- package/dist/subagents.js +746 -0
- package/dist/subagents.js.map +1 -0
- package/dist/tool-retry.d.ts +12 -0
- package/dist/tool-retry.d.ts.map +1 -0
- package/dist/tool-retry.js +53 -0
- package/dist/tool-retry.js.map +1 -0
- package/dist/tree.d.ts +62 -6
- package/dist/tree.d.ts.map +1 -1
- package/dist/tree.js +192 -23
- package/dist/tree.js.map +1 -1
- package/dist/types.d.ts +767 -52
- package/dist/types.d.ts.map +1 -1
- package/dist/workflow-snapshot.d.ts +8 -0
- package/dist/workflow-snapshot.d.ts.map +1 -0
- package/dist/workflow-snapshot.js +276 -0
- package/dist/workflow-snapshot.js.map +1 -0
- package/dist/workflow-types.d.ts +171 -0
- package/dist/workflow-types.d.ts.map +1 -0
- package/dist/workflow-types.js +2 -0
- package/dist/workflow-types.js.map +1 -0
- package/dist/workflow.d.ts +19 -0
- package/dist/workflow.d.ts.map +1 -0
- package/dist/workflow.js +1053 -0
- package/dist/workflow.js.map +1 -0
- package/examples/a2a-remote.ts +85 -0
- package/examples/a2a-server.ts +100 -0
- package/examples/background.ts +18 -4
- package/examples/code-mode.ts +76 -0
- package/examples/conversation.ts +57 -0
- package/examples/evals.ts +79 -0
- package/examples/guardrails.ts +56 -0
- package/examples/handoff.ts +79 -0
- package/examples/memory.ts +44 -0
- package/examples/otel.ts +99 -0
- package/examples/steering.ts +69 -0
- package/examples/structured-handoff.ts +92 -0
- package/examples/subagents.ts +127 -0
- package/examples/workflow.ts +74 -0
- package/package.json +58 -6
- package/src/a2a/auth.ts +62 -0
- package/src/a2a/client.ts +733 -0
- package/src/a2a/index.ts +74 -0
- package/src/a2a/memory-runs.ts +448 -0
- package/src/a2a/policy.ts +148 -0
- package/src/a2a/push.ts +251 -0
- package/src/a2a/remote.ts +1652 -0
- package/src/a2a/server.ts +1390 -0
- package/src/a2a/signing.ts +348 -0
- package/src/a2a/tasks.ts +260 -0
- package/src/a2a/wire.ts +1443 -0
- package/src/background-types.ts +86 -0
- package/src/child.ts +181 -0
- package/src/code-driver.ts +48 -0
- package/src/code-mode.ts +12 -0
- package/src/code-script.ts +149 -0
- package/src/code.ts +424 -0
- package/src/compaction.ts +212 -0
- package/src/delegation.ts +444 -155
- package/src/evals/driver.ts +222 -0
- package/src/evals/journal.ts +605 -0
- package/src/evals/judge.ts +188 -0
- package/src/evals/report.ts +295 -0
- package/src/evals/runner.ts +826 -0
- package/src/evals/scorers.ts +339 -0
- package/src/evals/simulation.ts +46 -0
- package/src/evals/testing.ts +126 -0
- package/src/evals/trajectory.ts +223 -0
- package/src/evals/types.ts +463 -0
- package/src/evals.ts +72 -0
- package/src/extensions.ts +247 -0
- package/src/handoff.ts +214 -0
- package/src/index.ts +51 -0
- package/src/input.ts +319 -0
- package/src/mcp.ts +690 -0
- package/src/memory-store.ts +366 -0
- package/src/memory.ts +893 -0
- package/src/otel.ts +568 -0
- package/src/progress.ts +214 -0
- package/src/quickjs.ts +524 -0
- package/src/recovery.ts +90 -0
- package/src/request.ts +513 -0
- package/src/run.ts +2678 -313
- package/src/runs.ts +464 -133
- package/src/schema-to-ts.ts +194 -0
- package/src/session.ts +178 -0
- package/src/snapshot.ts +1595 -124
- package/src/steering.ts +329 -0
- package/src/subagents.ts +1084 -0
- package/src/tool-retry.ts +86 -0
- package/src/tree.ts +223 -27
- package/src/types.ts +711 -52
- package/src/workflow-snapshot.ts +366 -0
- package/src/workflow-types.ts +213 -0
- package/src/workflow.ts +1316 -0
|
@@ -0,0 +1,114 @@
|
|
|
1
|
+
// Endpoint checks adapted from google-adk-js core/src/a2a/agent_card.ts.
|
|
2
|
+
// Copyright 2026 Google LLC. SPDX-License-Identifier: Apache-2.0
|
|
3
|
+
// No DNS lookup or address pinning: those remain the host's responsibility.
|
|
4
|
+
import { A2AError, } from "./wire.js";
|
|
5
|
+
function ipv6(host) {
|
|
6
|
+
if (!host.startsWith("["))
|
|
7
|
+
return undefined;
|
|
8
|
+
const halves = host.slice(1, -1).split("::");
|
|
9
|
+
const left = halves[0] ? halves[0].split(":").map((n) => Number.parseInt(n, 16)) : [];
|
|
10
|
+
const right = halves[1] ? halves[1].split(":").map((n) => Number.parseInt(n, 16)) : [];
|
|
11
|
+
return halves.length === 1
|
|
12
|
+
? left
|
|
13
|
+
: [...left, ...Array(8 - left.length - right.length).fill(0), ...right];
|
|
14
|
+
}
|
|
15
|
+
function address(host) {
|
|
16
|
+
host = host.toLowerCase().replace(/\.$/, "");
|
|
17
|
+
const v6 = ipv6(host);
|
|
18
|
+
let v4 = /^\d+\.\d+\.\d+\.\d+$/.test(host) ? host.split(".").map(Number) : undefined;
|
|
19
|
+
if (v6?.slice(0, 5).every((n) => n === 0) && v6[5] === 0xffff)
|
|
20
|
+
v4 = [v6[6] >>> 8, v6[6] & 255, v6[7] >>> 8, v6[7] & 255];
|
|
21
|
+
if (v4) {
|
|
22
|
+
const [a, b] = v4;
|
|
23
|
+
return {
|
|
24
|
+
loopback: a === 127,
|
|
25
|
+
private: a === 10 ||
|
|
26
|
+
(a === 172 && b >= 16 && b <= 31) ||
|
|
27
|
+
(a === 192 && b === 168) ||
|
|
28
|
+
(a === 100 && b >= 64 && b <= 127),
|
|
29
|
+
forbidden: a === 0 || (a === 169 && b === 254) || a >= 224 || v4.join(".") === "100.100.100.200",
|
|
30
|
+
};
|
|
31
|
+
}
|
|
32
|
+
if (v6) {
|
|
33
|
+
const local = v6.slice(0, 7).every((n) => n === 0);
|
|
34
|
+
return {
|
|
35
|
+
loopback: local && v6[7] === 1,
|
|
36
|
+
private: (v6[0] & 0xfe00) === 0xfc00,
|
|
37
|
+
forbidden: (v6[0] & 0xffc0) === 0xfe80 || (v6[0] & 0xff00) === 0xff00 || (local && v6[7] === 0),
|
|
38
|
+
};
|
|
39
|
+
}
|
|
40
|
+
return {
|
|
41
|
+
loopback: host === "localhost" || host.endsWith(".localhost"),
|
|
42
|
+
private: false,
|
|
43
|
+
forbidden: host === "metadata.google.internal" || host === "metadata.goog",
|
|
44
|
+
};
|
|
45
|
+
}
|
|
46
|
+
function endpoint(value) {
|
|
47
|
+
try {
|
|
48
|
+
if (value.length > 2048)
|
|
49
|
+
throw new Error();
|
|
50
|
+
const url = new URL(value);
|
|
51
|
+
if (!["https:", "http:"].includes(url.protocol) ||
|
|
52
|
+
url.username ||
|
|
53
|
+
url.password ||
|
|
54
|
+
url.hash ||
|
|
55
|
+
address(url.hostname).forbidden)
|
|
56
|
+
throw new Error();
|
|
57
|
+
return url;
|
|
58
|
+
}
|
|
59
|
+
catch {
|
|
60
|
+
throw new A2AError("endpoint");
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
function sameOrigin(a, b) {
|
|
64
|
+
return (a.origin === b.origin ||
|
|
65
|
+
(address(a.hostname).loopback &&
|
|
66
|
+
address(b.hostname).loopback &&
|
|
67
|
+
a.protocol === b.protocol &&
|
|
68
|
+
a.port === b.port));
|
|
69
|
+
}
|
|
70
|
+
/** Literal checks are not a claim about DNS safety. Every destination also needs the host's allow hook. */
|
|
71
|
+
export async function checkA2AEndpoint(value, use, policy, cardUrl) {
|
|
72
|
+
const url = endpoint(value);
|
|
73
|
+
const host = address(url.hostname);
|
|
74
|
+
if (url.protocol !== "https:" && !host.loopback && !policy?.allowInsecure)
|
|
75
|
+
throw new A2AError("endpoint");
|
|
76
|
+
if (use === "push" && (host.private || host.loopback))
|
|
77
|
+
throw new A2AError("endpoint");
|
|
78
|
+
if (use === "rpc" && cardUrl && !policy.allowCrossOrigin && !sameOrigin(endpoint(cardUrl), url))
|
|
79
|
+
throw new A2AError("endpoint");
|
|
80
|
+
let allowed = false;
|
|
81
|
+
try {
|
|
82
|
+
allowed = (await policy?.allow(new URL(url.href), use)) === true;
|
|
83
|
+
}
|
|
84
|
+
catch {
|
|
85
|
+
/* A policy exception may contain secrets. */
|
|
86
|
+
}
|
|
87
|
+
if (!allowed)
|
|
88
|
+
throw new A2AError("endpoint");
|
|
89
|
+
return url;
|
|
90
|
+
}
|
|
91
|
+
export function a2aCardUrl(source) {
|
|
92
|
+
const url = endpoint(source);
|
|
93
|
+
if (!url.pathname.endsWith("/agent-card.json"))
|
|
94
|
+
url.pathname = `${url.pathname.replace(/\/+$/, "")}/.well-known/agent-card.json`;
|
|
95
|
+
return url.href;
|
|
96
|
+
}
|
|
97
|
+
export async function checkA2ACardEndpoints(card, source, policy) {
|
|
98
|
+
for (const entry of card.interfaces)
|
|
99
|
+
await checkA2AEndpoint(entry.url, "rpc", policy, source);
|
|
100
|
+
}
|
|
101
|
+
/** No auto negotiation or fallback: a rejected mutation must not move to another interface. */
|
|
102
|
+
export function selectA2AInterface(card, version, binding, extensions = []) {
|
|
103
|
+
for (const extension of card.capabilities.extensions ?? []) {
|
|
104
|
+
if (extension.required && !extensions.includes(extension.uri))
|
|
105
|
+
throw new A2AError("protocol", { code: -32008 });
|
|
106
|
+
}
|
|
107
|
+
const found = card.interfaces.find((entry) => entry.binding === binding &&
|
|
108
|
+
(entry.version === version ||
|
|
109
|
+
new RegExp(`^${version.replace(".", "\\.")}\\.\\d+$`).test(entry.version)));
|
|
110
|
+
if (!found)
|
|
111
|
+
throw new A2AError("protocol", { code: -32009 });
|
|
112
|
+
return { ...found };
|
|
113
|
+
}
|
|
114
|
+
//# sourceMappingURL=policy.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../src/a2a/policy.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,iEAAiE;AACjE,4EAA4E;AAC5E,OAAO,EACL,QAAQ,GAKT,MAAM,WAAW,CAAC;AAUnB,SAAS,IAAI,CAAC,IAAY;IACxB,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACtF,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACvF,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC;QACxB,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,CAAS,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC;AACpF,CAAC;AACD,SAAS,OAAO,CAAC,IAAY;IAC3B,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC7C,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IACtB,IAAI,EAAE,GAAG,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACrF,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,MAAM;QAC3D,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,CAAE,GAAG,GAAG,EAAE,EAAE,CAAC,CAAC,CAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,CAAE,GAAG,GAAG,CAAC,CAAC;IAChE,IAAI,EAAE,EAAE,CAAC;QACP,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;QAClB,OAAO;YACL,QAAQ,EAAE,CAAC,KAAK,GAAG;YACnB,OAAO,EACL,CAAC,KAAK,EAAE;gBACR,CAAC,CAAC,KAAK,GAAG,IAAI,CAAE,IAAI,EAAE,IAAI,CAAE,IAAI,EAAE,CAAC;gBACnC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC;gBACxB,CAAC,CAAC,KAAK,GAAG,IAAI,CAAE,IAAI,EAAE,IAAI,CAAE,IAAI,GAAG,CAAC;YACtC,SAAS,EACP,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,CAAE,IAAI,GAAG,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,iBAAiB;SACzF,CAAC;IACJ,CAAC;IACD,IAAI,EAAE,EAAE,CAAC;QACP,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QACnD,OAAO;YACL,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;YAC9B,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAE,GAAG,MAAM,CAAC,KAAK,MAAM;YACrC,SAAS,EACP,CAAC,EAAE,CAAC,CAAC,CAAE,GAAG,MAAM,CAAC,KAAK,MAAM,IAAI,CAAC,EAAE,CAAC,CAAC,CAAE,GAAG,MAAM,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;SACzF,CAAC;IACJ,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,IAAI,KAAK,WAAW,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC;QAC7D,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,IAAI,KAAK,0BAA0B,IAAI,IAAI,KAAK,eAAe;KAC3E,CAAC;AACJ,CAAC;AACD,SAAS,QAAQ,CAAC,KAAa;IAC7B,IAAI,CAAC;QACH,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI;YAAE,MAAM,IAAI,KAAK,EAAE,CAAC;QAC3C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3B,IACE,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC;YAC3C,GAAG,CAAC,QAAQ;YACZ,GAAG,CAAC,QAAQ;YACZ,GAAG,CAAC,IAAI;YACR,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,SAAS;YAE/B,MAAM,IAAI,KAAK,EAAE,CAAC;QACpB,OAAO,GAAG,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,QAAQ,CAAC,UAAU,CAAC,CAAC;IACjC,CAAC;AACH,CAAC;AACD,SAAS,UAAU,CAAC,CAAM,EAAE,CAAM;IAChC,OAAO,CACL,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;QACrB,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,QAAQ;YAC3B,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,QAAQ;YAC5B,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ;YACzB,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC,CACrB,CAAC;AACJ,CAAC;AAED,2GAA2G;AAC3G,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAAa,EACb,GAAmB,EACnB,MAAyB,EACzB,OAAgB;IAEhB,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,MAAM,EAAE,aAAa;QACvE,MAAM,IAAI,QAAQ,CAAC,UAAU,CAAC,CAAC;IACjC,IAAI,GAAG,KAAK,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC;QAAE,MAAM,IAAI,QAAQ,CAAC,UAAU,CAAC,CAAC;IACtF,IAAI,GAAG,KAAK,KAAK,IAAI,OAAO,IAAI,CAAC,MAAM,CAAC,gBAAgB,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC;QAC7F,MAAM,IAAI,QAAQ,CAAC,UAAU,CAAC,CAAC;IACjC,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,CAAC,MAAM,MAAM,EAAE,KAAK,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,6CAA6C;IAC/C,CAAC;IACD,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC7C,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC7B,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QAC5C,GAAG,CAAC,QAAQ,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,8BAA8B,CAAC;IACnF,OAAO,GAAG,CAAC,IAAI,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,IAAkB,EAClB,MAAc,EACd,MAAyB;IAEzB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,UAAU;QAAE,MAAM,gBAAgB,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAChG,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,kBAAkB,CAChC,IAAkB,EAClB,OAAmB,EACnB,OAAmB,EACnB,UAAU,GAAsB,EAAE;IAElC,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,YAAY,CAAC,UAAU,IAAI,EAAE,EAAE,CAAC;QAC3D,IAAI,SAAS,CAAC,QAAQ,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC;YAC3D,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;IACrD,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAChC,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,CAAC,OAAO,KAAK,OAAO;QACzB,CAAC,KAAK,CAAC,OAAO,KAAK,OAAO;YACxB,IAAI,MAAM,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAC/E,CAAC;IACF,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;IAC7D,OAAO,EAAE,GAAG,KAAK,EAAE,CAAC;AACtB,CAAC"}
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
import type { FetchLike } from "@providerkit/core";
|
|
2
|
+
import { type A2ATaskScope, type A2ATaskStore, type A2APushAttempt } from "./tasks.ts";
|
|
3
|
+
import { type A2APushConfig, type A2AEvent } from "./wire.ts";
|
|
4
|
+
export interface A2APushPolicy {
|
|
5
|
+
/** Rechecked before every delivery. Must enforce current task access, not just the URL. */
|
|
6
|
+
authorize(scope: A2ATaskScope, taskId: string): boolean | Promise<boolean>;
|
|
7
|
+
/** Rechecked before every delivery. DNS/address pinning belongs to this hook's egress proxy
|
|
8
|
+
* or fetch implementation; portable literal checks alone cannot prove DNS safety. */
|
|
9
|
+
allow(url: URL, scope: A2ATaskScope): boolean | Promise<boolean>;
|
|
10
|
+
fetch?: FetchLike;
|
|
11
|
+
timeoutMs?: number;
|
|
12
|
+
/** Optional providerkit extension, not an A2A standard signature header. */
|
|
13
|
+
signingSecret?: string;
|
|
14
|
+
}
|
|
15
|
+
export declare function signA2APush(body: string, secret: string, timestamp?: number): Promise<{
|
|
16
|
+
signature: string;
|
|
17
|
+
timestamp: string;
|
|
18
|
+
}>;
|
|
19
|
+
/** Host must also dedupe notification identities. Timestamp tolerance alone is not replay storage. */
|
|
20
|
+
export declare function verifyA2APush(body: string, headers: Headers, secret: string, options?: {
|
|
21
|
+
now?: number;
|
|
22
|
+
toleranceSeconds?: number;
|
|
23
|
+
}): Promise<boolean>;
|
|
24
|
+
export declare function checkA2APushConfig(config: A2APushConfig, scope: A2ATaskScope, policy: A2APushPolicy): Promise<void>;
|
|
25
|
+
/** One attempt per immutable public update/config pair. A timeout, 5xx or lost reply stays
|
|
26
|
+
* unknown. There is no timer retry or token-renewal resend. Reconcile in the host, never replay. */
|
|
27
|
+
export declare function deliverA2APush(options: {
|
|
28
|
+
tasks: A2ATaskStore;
|
|
29
|
+
scope: A2ATaskScope;
|
|
30
|
+
taskId: string;
|
|
31
|
+
event: A2AEvent;
|
|
32
|
+
policy: A2APushPolicy;
|
|
33
|
+
}): Promise<A2APushAttempt[]>;
|
|
34
|
+
//# sourceMappingURL=push.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"push.d.ts","sourceRoot":"","sources":["../../src/a2a/push.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAKnD,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,cAAc,EACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,QAAQ,EACd,MAAM,WAAW,CAAC;AAEnB,MAAM,WAAW,aAAa;IAC5B,2FAA2F;IAC3F,SAAS,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3E;yFACqF;IACrF,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACjE,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAYD,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,SAAS,SAAgC,GACxC,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAQnD;AACD,sGAAsG;AACtG,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAO,GACxD,OAAO,CAAC,OAAO,CAAC,CAuBlB;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,IAAI,CAAC,CAcf;AAED;oGACoG;AACpG,wBAAsB,cAAc,CAAC,OAAO,EAAE;IAC5C,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,QAAQ,CAAC;IAChB,MAAM,EAAE,aAAa,CAAC;CACvB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAuI5B"}
|
package/dist/a2a/push.js
ADDED
|
@@ -0,0 +1,180 @@
|
|
|
1
|
+
import { untilAbort } from "../tree.js";
|
|
2
|
+
import { checkA2AEndpoint } from "./policy.js";
|
|
3
|
+
import { equalData } from "../snapshot.js";
|
|
4
|
+
import { hashA2AJson } from "./signing.js";
|
|
5
|
+
import { A2ATaskConflict, } from "./tasks.js";
|
|
6
|
+
import { A2AError, encodeA2AEvent, parseA2AJson, } from "./wire.js";
|
|
7
|
+
const encoder = new TextEncoder();
|
|
8
|
+
async function hmacKey(secret) {
|
|
9
|
+
if (!secret)
|
|
10
|
+
throw new A2AError("invalid");
|
|
11
|
+
return crypto.subtle.importKey("raw", encoder.encode(secret), { name: "HMAC", hash: "SHA-256" }, false, ["sign", "verify"]);
|
|
12
|
+
}
|
|
13
|
+
export async function signA2APush(body, secret, timestamp = Math.floor(Date.now() / 1000)) {
|
|
14
|
+
const bytes = new Uint8Array(await crypto.subtle.sign("HMAC", await hmacKey(secret), encoder.encode(`${timestamp}.${body}`)));
|
|
15
|
+
return {
|
|
16
|
+
signature: `sha256=${[...bytes].map((n) => n.toString(16).padStart(2, "0")).join("")}`,
|
|
17
|
+
timestamp: String(timestamp),
|
|
18
|
+
};
|
|
19
|
+
}
|
|
20
|
+
/** Host must also dedupe notification identities. Timestamp tolerance alone is not replay storage. */
|
|
21
|
+
export async function verifyA2APush(body, headers, secret, options = {}) {
|
|
22
|
+
const timestamp = headers.get("X-A2A-Timestamp");
|
|
23
|
+
const signature = headers.get("X-A2A-Signature");
|
|
24
|
+
const tolerance = options.toleranceSeconds ?? 300;
|
|
25
|
+
if (!Number.isFinite(tolerance) ||
|
|
26
|
+
tolerance < 0 ||
|
|
27
|
+
!timestamp ||
|
|
28
|
+
!/^\d{1,12}$/.test(timestamp) ||
|
|
29
|
+
!signature ||
|
|
30
|
+
!/^sha256=[a-f0-9]{64}$/.test(signature) ||
|
|
31
|
+
Math.abs((options.now ?? Date.now()) / 1000 - Number(timestamp)) > tolerance)
|
|
32
|
+
return false;
|
|
33
|
+
const bytes = Uint8Array.from(signature.slice(7).match(/../g), (pair) => Number.parseInt(pair, 16));
|
|
34
|
+
return crypto.subtle.verify("HMAC", await hmacKey(secret), bytes, encoder.encode(`${timestamp}.${body}`));
|
|
35
|
+
}
|
|
36
|
+
export async function checkA2APushConfig(config, scope, policy) {
|
|
37
|
+
if (config.tenant !== undefined && config.tenant !== scope.tenant)
|
|
38
|
+
throw new A2AError("invalid");
|
|
39
|
+
if (config.authentication &&
|
|
40
|
+
(config.authentication.schemes.length !== 1 ||
|
|
41
|
+
config.authentication.schemes[0]?.toLowerCase() !== "bearer" ||
|
|
42
|
+
!config.authentication.credentials ||
|
|
43
|
+
!/^[A-Za-z0-9\-._~+/]+=*$/.test(config.authentication.credentials)))
|
|
44
|
+
throw new A2AError("protocol", { code: -32004 });
|
|
45
|
+
if (config.token && /[^\x20-\x7e]/.test(config.token))
|
|
46
|
+
throw new A2AError("invalid");
|
|
47
|
+
await checkA2AEndpoint(config.url, "push", {
|
|
48
|
+
allow: (url) => policy.allow(url, structuredClone(scope)),
|
|
49
|
+
});
|
|
50
|
+
}
|
|
51
|
+
/** One attempt per immutable public update/config pair. A timeout, 5xx or lost reply stays
|
|
52
|
+
* unknown. There is no timer retry or token-renewal resend. Reconcile in the host, never replay. */
|
|
53
|
+
export async function deliverA2APush(options) {
|
|
54
|
+
const { tasks, scope, taskId, policy } = options;
|
|
55
|
+
const timeout = policy.timeoutMs ?? 10_000;
|
|
56
|
+
if (!Number.isSafeInteger(timeout) || timeout < 1)
|
|
57
|
+
throw new A2AError("invalid");
|
|
58
|
+
let task = await tasks.get(scope, taskId);
|
|
59
|
+
if (!task)
|
|
60
|
+
throw new A2AError("protocol", { code: -32001 });
|
|
61
|
+
const event = structuredClone(options.event);
|
|
62
|
+
if ((event.kind === "task" ? event.id : event.taskId) !== task.id ||
|
|
63
|
+
event.contextId !== task.contextId)
|
|
64
|
+
throw new A2AError("invalid");
|
|
65
|
+
const outcomes = [];
|
|
66
|
+
for (const configured of task.push) {
|
|
67
|
+
const config = configured.config;
|
|
68
|
+
if (!config.id)
|
|
69
|
+
throw new A2AError("invalid");
|
|
70
|
+
const body = JSON.stringify(encodeA2AEvent(event, configured.dialect));
|
|
71
|
+
const id = await hashA2AJson({
|
|
72
|
+
body,
|
|
73
|
+
config: parseA2AJson(JSON.stringify(config)),
|
|
74
|
+
dialect: { ...configured.dialect },
|
|
75
|
+
});
|
|
76
|
+
let reservation;
|
|
77
|
+
for (let attempt = 0; attempt < 4; attempt++) {
|
|
78
|
+
task = await tasks.get(scope, taskId);
|
|
79
|
+
if (!task)
|
|
80
|
+
throw new A2AError("protocol", { code: -32001 });
|
|
81
|
+
const previous = task.deliveries.find((delivery) => delivery.id === id);
|
|
82
|
+
if (previous) {
|
|
83
|
+
outcomes.push(previous);
|
|
84
|
+
break;
|
|
85
|
+
}
|
|
86
|
+
// A deleted/replaced callback loses permission immediately. Never use a stale credential.
|
|
87
|
+
if (!task.push.some((entry) => equalData(entry, configured)))
|
|
88
|
+
break;
|
|
89
|
+
reservation = {
|
|
90
|
+
id,
|
|
91
|
+
configId: config.id,
|
|
92
|
+
revision: task.revision,
|
|
93
|
+
at: Date.now(),
|
|
94
|
+
outcome: "pending",
|
|
95
|
+
};
|
|
96
|
+
try {
|
|
97
|
+
await tasks.update(scope, taskId, { deliveries: [...task.deliveries, reservation] }, task.revision);
|
|
98
|
+
break;
|
|
99
|
+
}
|
|
100
|
+
catch (error) {
|
|
101
|
+
reservation = undefined;
|
|
102
|
+
if (!(error instanceof A2ATaskConflict) || attempt === 3)
|
|
103
|
+
throw error;
|
|
104
|
+
}
|
|
105
|
+
}
|
|
106
|
+
if (!reservation)
|
|
107
|
+
continue;
|
|
108
|
+
let outcome = "refused";
|
|
109
|
+
let sent = false;
|
|
110
|
+
const controller = new AbortController();
|
|
111
|
+
const timer = setTimeout(() => controller.abort(), timeout);
|
|
112
|
+
try {
|
|
113
|
+
if (!(await untilAbort(Promise.resolve(policy.authorize(structuredClone(scope), taskId)), controller.signal)))
|
|
114
|
+
throw new A2AError("endpoint");
|
|
115
|
+
await untilAbort(checkA2APushConfig(config, scope, policy), controller.signal);
|
|
116
|
+
const headers = new Headers({
|
|
117
|
+
"content-type": "application/a2a+json",
|
|
118
|
+
"A2A-Version": configured.dialect.version,
|
|
119
|
+
});
|
|
120
|
+
if (config.authentication?.credentials)
|
|
121
|
+
headers.set("authorization", `Bearer ${config.authentication.credentials}`);
|
|
122
|
+
if (config.token)
|
|
123
|
+
headers.set("X-A2A-Notification-Token", config.token);
|
|
124
|
+
if (policy.signingSecret) {
|
|
125
|
+
const signed = await signA2APush(body, policy.signingSecret);
|
|
126
|
+
headers.set("X-A2A-Timestamp", signed.timestamp);
|
|
127
|
+
headers.set("X-A2A-Signature", signed.signature);
|
|
128
|
+
}
|
|
129
|
+
if (!(await untilAbort(Promise.resolve(policy.authorize(structuredClone(scope), taskId)), controller.signal)))
|
|
130
|
+
throw new A2AError("endpoint");
|
|
131
|
+
// Finish every async policy before the final callback check. A revoked callback must
|
|
132
|
+
// not receive either the task or its old credential while authorization is waiting.
|
|
133
|
+
const current = await tasks.get(scope, taskId);
|
|
134
|
+
if (!current?.push.some((p) => equalData(p, configured)))
|
|
135
|
+
throw new A2AError("endpoint");
|
|
136
|
+
controller.signal.throwIfAborted();
|
|
137
|
+
sent = true;
|
|
138
|
+
const pending = (policy.fetch ?? globalThis.fetch)(config.url, {
|
|
139
|
+
method: "POST",
|
|
140
|
+
body,
|
|
141
|
+
headers,
|
|
142
|
+
redirect: "error",
|
|
143
|
+
credentials: "omit",
|
|
144
|
+
signal: controller.signal,
|
|
145
|
+
});
|
|
146
|
+
// A non-cooperative host fetch may finish late. Always release its body, but never send again.
|
|
147
|
+
void pending.then((response) => {
|
|
148
|
+
if (controller.signal.aborted)
|
|
149
|
+
void response.body?.cancel().catch(() => { });
|
|
150
|
+
}, () => { });
|
|
151
|
+
const response = await untilAbort(pending, controller.signal);
|
|
152
|
+
void response.body?.cancel().catch(() => { });
|
|
153
|
+
outcome = response.ok && !response.redirected ? "delivered" : "unknown";
|
|
154
|
+
}
|
|
155
|
+
catch {
|
|
156
|
+
outcome = sent ? "unknown" : "refused";
|
|
157
|
+
}
|
|
158
|
+
finally {
|
|
159
|
+
clearTimeout(timer);
|
|
160
|
+
}
|
|
161
|
+
const settled = { ...reservation, outcome };
|
|
162
|
+
// Failure to record completion leaves pending, which also forbids replay.
|
|
163
|
+
for (let attempt = 0; attempt < 4; attempt++) {
|
|
164
|
+
const current = await tasks.get(scope, taskId);
|
|
165
|
+
if (!current)
|
|
166
|
+
break;
|
|
167
|
+
try {
|
|
168
|
+
await tasks.update(scope, taskId, { deliveries: current.deliveries.map((d) => (d.id === id ? settled : d)) }, current.revision);
|
|
169
|
+
break;
|
|
170
|
+
}
|
|
171
|
+
catch (error) {
|
|
172
|
+
if (!(error instanceof A2ATaskConflict) || attempt === 3)
|
|
173
|
+
throw error;
|
|
174
|
+
}
|
|
175
|
+
}
|
|
176
|
+
outcomes.push(settled);
|
|
177
|
+
}
|
|
178
|
+
return outcomes;
|
|
179
|
+
}
|
|
180
|
+
//# sourceMappingURL=push.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"push.js","sourceRoot":"","sources":["../../src/a2a/push.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,155 @@
|
|
|
1
|
+
import { AGENT_RUNTIME, type Delegation, type NodeRuntime, type SpecialistToolOptions } from "../delegation.ts";
|
|
2
|
+
import { treeUsage } from "../tree.ts";
|
|
3
|
+
import type { AgentInput, AskRecord, PendingRequest, QuestionAsk, RequestProblem, ResultSchema, ResumeOptions, RunOptions, RunSnapshot, RunState, TreeLimits, TreeNode, UserContent } from "../types.ts";
|
|
4
|
+
import { fetchA2AAgentCard, type A2AClientOptions } from "./client.ts";
|
|
5
|
+
import { type A2AAgentCard, type A2AMessage, type A2APart, type A2AState } from "./wire.ts";
|
|
6
|
+
export interface RemoteLimits {
|
|
7
|
+
/** Outbound messages, not model calls. */
|
|
8
|
+
turns: number;
|
|
9
|
+
elapsedMs: number;
|
|
10
|
+
inlineBytes: number;
|
|
11
|
+
resultBytes: number;
|
|
12
|
+
}
|
|
13
|
+
export interface RemoteAgentOptions<T = string> extends Pick<A2AClientOptions, "version" | "binding" | "policy" | "headers" | "token" | "fetch" | "extensions" | "timeoutMs" | "idleMs"> {
|
|
14
|
+
id: string;
|
|
15
|
+
/** Change when hidden endpoint/auth policy or output validation changes. */
|
|
16
|
+
agentVersion: string;
|
|
17
|
+
card: string | A2AAgentCard;
|
|
18
|
+
verifyCard?: Parameters<typeof fetchA2AAgentCard>[1]["verifyCard"];
|
|
19
|
+
updates?: "stream" | "poll";
|
|
20
|
+
inputRequired?: "ask" | "parent" | "fail";
|
|
21
|
+
/** Opt in to inline image output. Requires output to validate { content: UserContent }.
|
|
22
|
+
* Return text/image parts from the validator to forward images through asTool.
|
|
23
|
+
* URLs and other files stay labels; no peer URL is fetched. */
|
|
24
|
+
includeImages?: boolean;
|
|
25
|
+
output?: ResultSchema<T>;
|
|
26
|
+
limits?: Partial<RemoteLimits>;
|
|
27
|
+
treeLimits?: Partial<TreeLimits>;
|
|
28
|
+
}
|
|
29
|
+
export interface RemoteInput {
|
|
30
|
+
input: UserContent;
|
|
31
|
+
/** Root-scoped handle from a prior parent-routed question, not a peer task id. */
|
|
32
|
+
continue?: string;
|
|
33
|
+
}
|
|
34
|
+
export interface RemotePending {
|
|
35
|
+
kind: "input_required";
|
|
36
|
+
handle: string;
|
|
37
|
+
/** Untrusted peer question. Never an approval or capability grant. */
|
|
38
|
+
question: string;
|
|
39
|
+
}
|
|
40
|
+
export interface RemoteSend {
|
|
41
|
+
id: string;
|
|
42
|
+
attemptId: string;
|
|
43
|
+
status: "running" | "accepted";
|
|
44
|
+
/** Exact intent, recorded before dispatch. Never replayed, even if delivery is unknown. */
|
|
45
|
+
message: A2AMessage;
|
|
46
|
+
answers: string[];
|
|
47
|
+
asks?: AskRecord[];
|
|
48
|
+
}
|
|
49
|
+
export interface RemoteJournal {
|
|
50
|
+
endpoint: {
|
|
51
|
+
url: string;
|
|
52
|
+
version: A2AClientOptions["version"];
|
|
53
|
+
binding: A2AClientOptions["binding"];
|
|
54
|
+
streaming: boolean;
|
|
55
|
+
tenant?: string;
|
|
56
|
+
};
|
|
57
|
+
taskId?: string;
|
|
58
|
+
contextId?: string;
|
|
59
|
+
sends: RemoteSend[];
|
|
60
|
+
/** Earlier messages in this parent-continuation chain, counted against turns. */
|
|
61
|
+
priorTurns: number;
|
|
62
|
+
/** A bounded read retry, scheduled by the existing host wake/continuation path. */
|
|
63
|
+
wakeAt?: number;
|
|
64
|
+
state?: A2AState;
|
|
65
|
+
/** Allowlisted response parts only. No peer history, metadata or error body. */
|
|
66
|
+
artifacts: {
|
|
67
|
+
artifactId: string;
|
|
68
|
+
parts: A2APart[];
|
|
69
|
+
}[];
|
|
70
|
+
question?: {
|
|
71
|
+
messageId: string;
|
|
72
|
+
structured: boolean;
|
|
73
|
+
asks: QuestionAsk[];
|
|
74
|
+
};
|
|
75
|
+
fallback: A2APart[];
|
|
76
|
+
cancel?: {
|
|
77
|
+
id: string;
|
|
78
|
+
attemptId: string;
|
|
79
|
+
status: "running" | "accepted";
|
|
80
|
+
state?: A2AState;
|
|
81
|
+
};
|
|
82
|
+
}
|
|
83
|
+
export interface RemoteSnapshot {
|
|
84
|
+
kind: "remote";
|
|
85
|
+
format: 3;
|
|
86
|
+
agentId: string;
|
|
87
|
+
version: string;
|
|
88
|
+
runId: string;
|
|
89
|
+
attemptId: string;
|
|
90
|
+
startedAt: number;
|
|
91
|
+
definition: Record<string, unknown>;
|
|
92
|
+
input: RemoteInput;
|
|
93
|
+
limits: RemoteLimits;
|
|
94
|
+
tree: RunSnapshot["tree"];
|
|
95
|
+
remote: RemoteJournal;
|
|
96
|
+
state: RunState;
|
|
97
|
+
}
|
|
98
|
+
export interface RemoteReceipt {
|
|
99
|
+
kind: "remote";
|
|
100
|
+
action: "send" | "cancel";
|
|
101
|
+
id: string;
|
|
102
|
+
attemptId: string;
|
|
103
|
+
status: "running" | "accepted";
|
|
104
|
+
billing: "unknown";
|
|
105
|
+
taskId?: string;
|
|
106
|
+
contextId?: string;
|
|
107
|
+
}
|
|
108
|
+
export type RemoteOutcome<T = string> = {
|
|
109
|
+
runId: string;
|
|
110
|
+
attemptId: string;
|
|
111
|
+
treeUsage: ReturnType<typeof treeUsage>;
|
|
112
|
+
receipts: RemoteReceipt[];
|
|
113
|
+
snapshot: RemoteSnapshot;
|
|
114
|
+
} & (Exclude<RunState, {
|
|
115
|
+
status: "running" | "completed" | "suspended";
|
|
116
|
+
}> | {
|
|
117
|
+
status: "completed";
|
|
118
|
+
output: T | RemotePending;
|
|
119
|
+
} | {
|
|
120
|
+
status: "suspended";
|
|
121
|
+
requests: (PendingRequest & {
|
|
122
|
+
problem?: RequestProblem;
|
|
123
|
+
})[];
|
|
124
|
+
wakeAt?: number;
|
|
125
|
+
});
|
|
126
|
+
export interface RemoteRuntime<T> extends NodeRuntime<RemoteOutcome<T>> {
|
|
127
|
+
configuration(): Record<string, unknown>;
|
|
128
|
+
prepare(input: unknown): RemoteInput;
|
|
129
|
+
open(input: AgentInput, options: RunOptions, runId: string): Promise<RemoteSnapshot>;
|
|
130
|
+
create(input: RemoteInput, runId: string, tree?: RunSnapshot["tree"], options?: RunOptions, root?: TreeNode): Promise<RemoteSnapshot>;
|
|
131
|
+
restore(raw: unknown, tree?: RunSnapshot["tree"]): RemoteSnapshot;
|
|
132
|
+
}
|
|
133
|
+
export interface RemoteAgent<T = string> {
|
|
134
|
+
readonly kind: "remote";
|
|
135
|
+
readonly id: string;
|
|
136
|
+
readonly version: string;
|
|
137
|
+
run(input: AgentInput, options?: RunOptions): Promise<RemoteOutcome<T>>;
|
|
138
|
+
resume(snapshot: unknown, options: ResumeOptions): Promise<RemoteOutcome<T>>;
|
|
139
|
+
/** Explicit host command. AbortSignal only detaches local work, never sends CancelTask.
|
|
140
|
+
* Inspect snapshot.remote.cancel.state: acceptance alone does not prove cancellation. */
|
|
141
|
+
cancel(snapshot: unknown, options: ResumeOptions): Promise<RemoteSnapshot>;
|
|
142
|
+
asTool(options: SpecialistToolOptions<T | RemotePending>): Delegation;
|
|
143
|
+
readonly [AGENT_RUNTIME]: RemoteRuntime<T>;
|
|
144
|
+
}
|
|
145
|
+
/** Structural checks are not authorization. A host must compare authoritative snapshots. */
|
|
146
|
+
export declare function isRemoteSnapshot(raw: unknown): raw is RemoteSnapshot;
|
|
147
|
+
export declare function checkRemoteSnapshot(snapshot: RemoteSnapshot): void;
|
|
148
|
+
export declare function checkRemoteProgress(previous: RemoteSnapshot, next: RemoteSnapshot): void;
|
|
149
|
+
export declare function defineRemoteAgent<T>(options: RemoteAgentOptions<T> & {
|
|
150
|
+
output: ResultSchema<T>;
|
|
151
|
+
}): RemoteAgent<T>;
|
|
152
|
+
export declare function defineRemoteAgent(options: RemoteAgentOptions<string> & {
|
|
153
|
+
output?: undefined;
|
|
154
|
+
}): RemoteAgent<string>;
|
|
155
|
+
//# sourceMappingURL=remote.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../../src/a2a/remote.ts"],"names":[],"mappings":"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"}
|