@providerkit/agents 0.0.0-stage → 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 +21 -0
- package/LICENSE-APACHE-2.0 +202 -0
- package/README.md +2328 -2
- 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 +135 -0
- package/dist/delegation.d.ts.map +1 -0
- package/dist/delegation.js +401 -0
- package/dist/delegation.js.map +1 -0
- 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 +19 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +11 -0
- package/dist/index.js.map +1 -0
- 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 +20 -0
- package/dist/run.d.ts.map +1 -0
- package/dist/run.js +2407 -0
- package/dist/run.js.map +1 -0
- package/dist/runs.d.ts +110 -0
- package/dist/runs.d.ts.map +1 -0
- package/dist/runs.js +438 -0
- package/dist/runs.js.map +1 -0
- 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 +75 -0
- package/dist/snapshot.d.ts.map +1 -0
- package/dist/snapshot.js +1607 -0
- package/dist/snapshot.js.map +1 -0
- 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 +98 -0
- package/dist/tree.d.ts.map +1 -0
- package/dist/tree.js +320 -0
- package/dist/tree.js.map +1 -0
- package/dist/types.d.ts +1007 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +2 -0
- package/dist/types.js.map +1 -0
- 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 +59 -0
- package/examples/basic.ts +44 -0
- 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/specialists.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 +114 -4
- 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 +694 -0
- 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 +62 -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 +3199 -0
- package/src/runs.ts +696 -0
- package/src/schema-to-ts.ts +194 -0
- package/src/session.ts +178 -0
- package/src/snapshot.ts +2099 -0
- package/src/steering.ts +329 -0
- package/src/subagents.ts +1084 -0
- package/src/tool-retry.ts +86 -0
- package/src/tree.ts +366 -0
- package/src/types.ts +944 -0
- package/src/workflow-snapshot.ts +366 -0
- package/src/workflow-types.ts +213 -0
- package/src/workflow.ts +1316 -0
package/src/a2a/push.ts
ADDED
|
@@ -0,0 +1,251 @@
|
|
|
1
|
+
// Target/token policy adapted from Mastra (Apache-2.0, Kepler Software, Inc.).
|
|
2
|
+
// Timestamped HMAC design adapted from CrewAI (MIT, Copyright (c) 2025 crewAI, Inc.).
|
|
3
|
+
import type { FetchLike } from "@providerkit/core";
|
|
4
|
+
import { untilAbort } from "../tree.ts";
|
|
5
|
+
import { checkA2AEndpoint } from "./policy.ts";
|
|
6
|
+
import { equalData } from "../snapshot.ts";
|
|
7
|
+
import { hashA2AJson } from "./signing.ts";
|
|
8
|
+
import {
|
|
9
|
+
A2ATaskConflict,
|
|
10
|
+
type A2ATaskScope,
|
|
11
|
+
type A2ATaskStore,
|
|
12
|
+
type A2APushAttempt,
|
|
13
|
+
} from "./tasks.ts";
|
|
14
|
+
import {
|
|
15
|
+
A2AError,
|
|
16
|
+
encodeA2AEvent,
|
|
17
|
+
parseA2AJson,
|
|
18
|
+
type A2APushConfig,
|
|
19
|
+
type A2AEvent,
|
|
20
|
+
} from "./wire.ts";
|
|
21
|
+
|
|
22
|
+
export interface A2APushPolicy {
|
|
23
|
+
/** Rechecked before every delivery. Must enforce current task access, not just the URL. */
|
|
24
|
+
authorize(scope: A2ATaskScope, taskId: string): boolean | Promise<boolean>;
|
|
25
|
+
/** Rechecked before every delivery. DNS/address pinning belongs to this hook's egress proxy
|
|
26
|
+
* or fetch implementation; portable literal checks alone cannot prove DNS safety. */
|
|
27
|
+
allow(url: URL, scope: A2ATaskScope): boolean | Promise<boolean>;
|
|
28
|
+
fetch?: FetchLike;
|
|
29
|
+
timeoutMs?: number;
|
|
30
|
+
/** Optional providerkit extension, not an A2A standard signature header. */
|
|
31
|
+
signingSecret?: string;
|
|
32
|
+
}
|
|
33
|
+
const encoder = new TextEncoder();
|
|
34
|
+
async function hmacKey(secret: string) {
|
|
35
|
+
if (!secret) throw new A2AError("invalid");
|
|
36
|
+
return crypto.subtle.importKey(
|
|
37
|
+
"raw",
|
|
38
|
+
encoder.encode(secret),
|
|
39
|
+
{ name: "HMAC", hash: "SHA-256" },
|
|
40
|
+
false,
|
|
41
|
+
["sign", "verify"],
|
|
42
|
+
);
|
|
43
|
+
}
|
|
44
|
+
export async function signA2APush(
|
|
45
|
+
body: string,
|
|
46
|
+
secret: string,
|
|
47
|
+
timestamp = Math.floor(Date.now() / 1000),
|
|
48
|
+
): Promise<{ signature: string; timestamp: string }> {
|
|
49
|
+
const bytes = new Uint8Array(
|
|
50
|
+
await crypto.subtle.sign("HMAC", await hmacKey(secret), encoder.encode(`${timestamp}.${body}`)),
|
|
51
|
+
);
|
|
52
|
+
return {
|
|
53
|
+
signature: `sha256=${[...bytes].map((n) => n.toString(16).padStart(2, "0")).join("")}`,
|
|
54
|
+
timestamp: String(timestamp),
|
|
55
|
+
};
|
|
56
|
+
}
|
|
57
|
+
/** Host must also dedupe notification identities. Timestamp tolerance alone is not replay storage. */
|
|
58
|
+
export async function verifyA2APush(
|
|
59
|
+
body: string,
|
|
60
|
+
headers: Headers,
|
|
61
|
+
secret: string,
|
|
62
|
+
options: { now?: number; toleranceSeconds?: number } = {},
|
|
63
|
+
): Promise<boolean> {
|
|
64
|
+
const timestamp = headers.get("X-A2A-Timestamp");
|
|
65
|
+
const signature = headers.get("X-A2A-Signature");
|
|
66
|
+
const tolerance = options.toleranceSeconds ?? 300;
|
|
67
|
+
if (
|
|
68
|
+
!Number.isFinite(tolerance) ||
|
|
69
|
+
tolerance < 0 ||
|
|
70
|
+
!timestamp ||
|
|
71
|
+
!/^\d{1,12}$/.test(timestamp) ||
|
|
72
|
+
!signature ||
|
|
73
|
+
!/^sha256=[a-f0-9]{64}$/.test(signature) ||
|
|
74
|
+
Math.abs((options.now ?? Date.now()) / 1000 - Number(timestamp)) > tolerance
|
|
75
|
+
)
|
|
76
|
+
return false;
|
|
77
|
+
const bytes = Uint8Array.from(signature.slice(7).match(/../g)!, (pair) =>
|
|
78
|
+
Number.parseInt(pair, 16),
|
|
79
|
+
);
|
|
80
|
+
return crypto.subtle.verify(
|
|
81
|
+
"HMAC",
|
|
82
|
+
await hmacKey(secret),
|
|
83
|
+
bytes,
|
|
84
|
+
encoder.encode(`${timestamp}.${body}`),
|
|
85
|
+
);
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
export async function checkA2APushConfig(
|
|
89
|
+
config: A2APushConfig,
|
|
90
|
+
scope: A2ATaskScope,
|
|
91
|
+
policy: A2APushPolicy,
|
|
92
|
+
): Promise<void> {
|
|
93
|
+
if (config.tenant !== undefined && config.tenant !== scope.tenant) throw new A2AError("invalid");
|
|
94
|
+
if (
|
|
95
|
+
config.authentication &&
|
|
96
|
+
(config.authentication.schemes.length !== 1 ||
|
|
97
|
+
config.authentication.schemes[0]?.toLowerCase() !== "bearer" ||
|
|
98
|
+
!config.authentication.credentials ||
|
|
99
|
+
!/^[A-Za-z0-9\-._~+/]+=*$/.test(config.authentication.credentials))
|
|
100
|
+
)
|
|
101
|
+
throw new A2AError("protocol", { code: -32004 });
|
|
102
|
+
if (config.token && /[^\x20-\x7e]/.test(config.token)) throw new A2AError("invalid");
|
|
103
|
+
await checkA2AEndpoint(config.url, "push", {
|
|
104
|
+
allow: (url) => policy.allow(url, structuredClone(scope)),
|
|
105
|
+
});
|
|
106
|
+
}
|
|
107
|
+
|
|
108
|
+
/** One attempt per immutable public update/config pair. A timeout, 5xx or lost reply stays
|
|
109
|
+
* unknown. There is no timer retry or token-renewal resend. Reconcile in the host, never replay. */
|
|
110
|
+
export async function deliverA2APush(options: {
|
|
111
|
+
tasks: A2ATaskStore;
|
|
112
|
+
scope: A2ATaskScope;
|
|
113
|
+
taskId: string;
|
|
114
|
+
event: A2AEvent;
|
|
115
|
+
policy: A2APushPolicy;
|
|
116
|
+
}): Promise<A2APushAttempt[]> {
|
|
117
|
+
const { tasks, scope, taskId, policy } = options;
|
|
118
|
+
const timeout = policy.timeoutMs ?? 10_000;
|
|
119
|
+
if (!Number.isSafeInteger(timeout) || timeout < 1) throw new A2AError("invalid");
|
|
120
|
+
let task = await tasks.get(scope, taskId);
|
|
121
|
+
if (!task) throw new A2AError("protocol", { code: -32001 });
|
|
122
|
+
const event = structuredClone(options.event);
|
|
123
|
+
if (
|
|
124
|
+
(event.kind === "task" ? event.id : event.taskId) !== task.id ||
|
|
125
|
+
event.contextId !== task.contextId
|
|
126
|
+
)
|
|
127
|
+
throw new A2AError("invalid");
|
|
128
|
+
const outcomes: A2APushAttempt[] = [];
|
|
129
|
+
for (const configured of task.push) {
|
|
130
|
+
const config = configured.config;
|
|
131
|
+
if (!config.id) throw new A2AError("invalid");
|
|
132
|
+
const body = JSON.stringify(encodeA2AEvent(event, configured.dialect));
|
|
133
|
+
const id = await hashA2AJson({
|
|
134
|
+
body,
|
|
135
|
+
config: parseA2AJson(JSON.stringify(config)),
|
|
136
|
+
dialect: { ...configured.dialect },
|
|
137
|
+
});
|
|
138
|
+
let reservation: A2APushAttempt | undefined;
|
|
139
|
+
for (let attempt = 0; attempt < 4; attempt++) {
|
|
140
|
+
task = await tasks.get(scope, taskId);
|
|
141
|
+
if (!task) throw new A2AError("protocol", { code: -32001 });
|
|
142
|
+
const previous = task.deliveries.find((delivery) => delivery.id === id);
|
|
143
|
+
if (previous) {
|
|
144
|
+
outcomes.push(previous);
|
|
145
|
+
break;
|
|
146
|
+
}
|
|
147
|
+
// A deleted/replaced callback loses permission immediately. Never use a stale credential.
|
|
148
|
+
if (!task.push.some((entry) => equalData(entry, configured))) break;
|
|
149
|
+
reservation = {
|
|
150
|
+
id,
|
|
151
|
+
configId: config.id,
|
|
152
|
+
revision: task.revision,
|
|
153
|
+
at: Date.now(),
|
|
154
|
+
outcome: "pending",
|
|
155
|
+
};
|
|
156
|
+
try {
|
|
157
|
+
await tasks.update(
|
|
158
|
+
scope,
|
|
159
|
+
taskId,
|
|
160
|
+
{ deliveries: [...task.deliveries, reservation] },
|
|
161
|
+
task.revision,
|
|
162
|
+
);
|
|
163
|
+
break;
|
|
164
|
+
} catch (error) {
|
|
165
|
+
reservation = undefined;
|
|
166
|
+
if (!(error instanceof A2ATaskConflict) || attempt === 3) throw error;
|
|
167
|
+
}
|
|
168
|
+
}
|
|
169
|
+
if (!reservation) continue;
|
|
170
|
+
let outcome: A2APushAttempt["outcome"] = "refused";
|
|
171
|
+
let sent = false;
|
|
172
|
+
const controller = new AbortController();
|
|
173
|
+
const timer = setTimeout(() => controller.abort(), timeout);
|
|
174
|
+
try {
|
|
175
|
+
if (
|
|
176
|
+
!(await untilAbort(
|
|
177
|
+
Promise.resolve(policy.authorize(structuredClone(scope), taskId)),
|
|
178
|
+
controller.signal,
|
|
179
|
+
))
|
|
180
|
+
)
|
|
181
|
+
throw new A2AError("endpoint");
|
|
182
|
+
await untilAbort(checkA2APushConfig(config, scope, policy), controller.signal);
|
|
183
|
+
const headers = new Headers({
|
|
184
|
+
"content-type": "application/a2a+json",
|
|
185
|
+
"A2A-Version": configured.dialect.version,
|
|
186
|
+
});
|
|
187
|
+
if (config.authentication?.credentials)
|
|
188
|
+
headers.set("authorization", `Bearer ${config.authentication.credentials}`);
|
|
189
|
+
if (config.token) headers.set("X-A2A-Notification-Token", config.token);
|
|
190
|
+
if (policy.signingSecret) {
|
|
191
|
+
const signed = await signA2APush(body, policy.signingSecret);
|
|
192
|
+
headers.set("X-A2A-Timestamp", signed.timestamp);
|
|
193
|
+
headers.set("X-A2A-Signature", signed.signature);
|
|
194
|
+
}
|
|
195
|
+
if (
|
|
196
|
+
!(await untilAbort(
|
|
197
|
+
Promise.resolve(policy.authorize(structuredClone(scope), taskId)),
|
|
198
|
+
controller.signal,
|
|
199
|
+
))
|
|
200
|
+
)
|
|
201
|
+
throw new A2AError("endpoint");
|
|
202
|
+
// Finish every async policy before the final callback check. A revoked callback must
|
|
203
|
+
// not receive either the task or its old credential while authorization is waiting.
|
|
204
|
+
const current = await tasks.get(scope, taskId);
|
|
205
|
+
if (!current?.push.some((p) => equalData(p, configured))) throw new A2AError("endpoint");
|
|
206
|
+
controller.signal.throwIfAborted();
|
|
207
|
+
sent = true;
|
|
208
|
+
const pending = (policy.fetch ?? globalThis.fetch)(config.url, {
|
|
209
|
+
method: "POST",
|
|
210
|
+
body,
|
|
211
|
+
headers,
|
|
212
|
+
redirect: "error",
|
|
213
|
+
credentials: "omit",
|
|
214
|
+
signal: controller.signal,
|
|
215
|
+
});
|
|
216
|
+
// A non-cooperative host fetch may finish late. Always release its body, but never send again.
|
|
217
|
+
void pending.then(
|
|
218
|
+
(response) => {
|
|
219
|
+
if (controller.signal.aborted) void response.body?.cancel().catch(() => {});
|
|
220
|
+
},
|
|
221
|
+
() => {},
|
|
222
|
+
);
|
|
223
|
+
const response = await untilAbort(pending, controller.signal);
|
|
224
|
+
void response.body?.cancel().catch(() => {});
|
|
225
|
+
outcome = response.ok && !response.redirected ? "delivered" : "unknown";
|
|
226
|
+
} catch {
|
|
227
|
+
outcome = sent ? "unknown" : "refused";
|
|
228
|
+
} finally {
|
|
229
|
+
clearTimeout(timer);
|
|
230
|
+
}
|
|
231
|
+
const settled = { ...reservation, outcome };
|
|
232
|
+
// Failure to record completion leaves pending, which also forbids replay.
|
|
233
|
+
for (let attempt = 0; attempt < 4; attempt++) {
|
|
234
|
+
const current = await tasks.get(scope, taskId);
|
|
235
|
+
if (!current) break;
|
|
236
|
+
try {
|
|
237
|
+
await tasks.update(
|
|
238
|
+
scope,
|
|
239
|
+
taskId,
|
|
240
|
+
{ deliveries: current.deliveries.map((d) => (d.id === id ? settled : d)) },
|
|
241
|
+
current.revision,
|
|
242
|
+
);
|
|
243
|
+
break;
|
|
244
|
+
} catch (error) {
|
|
245
|
+
if (!(error instanceof A2ATaskConflict) || attempt === 3) throw error;
|
|
246
|
+
}
|
|
247
|
+
}
|
|
248
|
+
outcomes.push(settled);
|
|
249
|
+
}
|
|
250
|
+
return outcomes;
|
|
251
|
+
}
|