@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/package.json
CHANGED
|
@@ -1,6 +1,116 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@providerkit/agents",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"
|
|
5
|
-
"
|
|
6
|
-
|
|
3
|
+
"version": "0.2.0",
|
|
4
|
+
"description": "An experimental, provider-independent agent loop with tools and resumable checkpoints.",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"license": "MIT",
|
|
7
|
+
"author": "Gustavo Salomé",
|
|
8
|
+
"exports": {
|
|
9
|
+
".": {
|
|
10
|
+
"types": "./dist/index.d.ts",
|
|
11
|
+
"default": "./dist/index.js"
|
|
12
|
+
},
|
|
13
|
+
"./runs": {
|
|
14
|
+
"types": "./dist/runs.d.ts",
|
|
15
|
+
"default": "./dist/runs.js"
|
|
16
|
+
},
|
|
17
|
+
"./mcp": {
|
|
18
|
+
"types": "./dist/mcp.d.ts",
|
|
19
|
+
"default": "./dist/mcp.js"
|
|
20
|
+
},
|
|
21
|
+
"./evals": {
|
|
22
|
+
"types": "./dist/evals.d.ts",
|
|
23
|
+
"default": "./dist/evals.js"
|
|
24
|
+
},
|
|
25
|
+
"./otel": {
|
|
26
|
+
"types": "./dist/otel.d.ts",
|
|
27
|
+
"default": "./dist/otel.js"
|
|
28
|
+
},
|
|
29
|
+
"./workflow": {
|
|
30
|
+
"types": "./dist/workflow.d.ts",
|
|
31
|
+
"default": "./dist/workflow.js"
|
|
32
|
+
},
|
|
33
|
+
"./a2a": {
|
|
34
|
+
"types": "./dist/a2a/index.d.ts",
|
|
35
|
+
"default": "./dist/a2a/index.js"
|
|
36
|
+
},
|
|
37
|
+
"./code-mode": {
|
|
38
|
+
"types": "./dist/code-mode.d.ts",
|
|
39
|
+
"default": "./dist/code-mode.js"
|
|
40
|
+
},
|
|
41
|
+
"./code-mode/quickjs": {
|
|
42
|
+
"types": "./dist/quickjs.d.ts",
|
|
43
|
+
"default": "./dist/quickjs.js"
|
|
44
|
+
}
|
|
45
|
+
},
|
|
46
|
+
"types": "./dist/index.d.ts",
|
|
47
|
+
"files": [
|
|
48
|
+
"dist",
|
|
49
|
+
"src",
|
|
50
|
+
"examples",
|
|
51
|
+
"README.md",
|
|
52
|
+
"LICENSE",
|
|
53
|
+
"LICENSE-APACHE-2.0",
|
|
54
|
+
"THIRD_PARTY_NOTICES.md"
|
|
55
|
+
],
|
|
56
|
+
"sideEffects": false,
|
|
57
|
+
"engines": {
|
|
58
|
+
"node": ">=22"
|
|
59
|
+
},
|
|
60
|
+
"publishConfig": {
|
|
61
|
+
"access": "public"
|
|
62
|
+
},
|
|
63
|
+
"scripts": {
|
|
64
|
+
"build": "tsc",
|
|
65
|
+
"typecheck": "tsc --noEmit && tsc -p test",
|
|
66
|
+
"lint": "oxlint -c ../.oxlintrc.json src test examples",
|
|
67
|
+
"test": "vitest run",
|
|
68
|
+
"sync:docs": "cp ../LICENSE .",
|
|
69
|
+
"prepublishOnly": "bun run lint && bun run build && bun run typecheck && bun run sync:docs",
|
|
70
|
+
"release": "bun publish --access public"
|
|
71
|
+
},
|
|
72
|
+
"peerDependencies": {
|
|
73
|
+
"@providerkit/core": "^0.33.1",
|
|
74
|
+
"@gusnips/server": "^0.19.0 || ^0.20.0 || ^0.21.0",
|
|
75
|
+
"@modelcontextprotocol/sdk": "^1.32.2",
|
|
76
|
+
"@opentelemetry/api": "^1.10.0",
|
|
77
|
+
"quickjs-emscripten-core": "^0.32.0",
|
|
78
|
+
"@jitl/quickjs-wasmfile-release-sync": "^0.32.0"
|
|
79
|
+
},
|
|
80
|
+
"peerDependenciesMeta": {
|
|
81
|
+
"@gusnips/server": {
|
|
82
|
+
"optional": true
|
|
83
|
+
},
|
|
84
|
+
"@modelcontextprotocol/sdk": {
|
|
85
|
+
"optional": true
|
|
86
|
+
},
|
|
87
|
+
"@opentelemetry/api": {
|
|
88
|
+
"optional": true
|
|
89
|
+
},
|
|
90
|
+
"quickjs-emscripten-core": {
|
|
91
|
+
"optional": true
|
|
92
|
+
},
|
|
93
|
+
"@jitl/quickjs-wasmfile-release-sync": {
|
|
94
|
+
"optional": true
|
|
95
|
+
}
|
|
96
|
+
},
|
|
97
|
+
"devDependencies": {
|
|
98
|
+
"@a2a-js/sdk": "1.3.0",
|
|
99
|
+
"@gusnips/server": "^0.21.0",
|
|
100
|
+
"@modelcontextprotocol/sdk": "^1.32.2",
|
|
101
|
+
"@opentelemetry/api": "^1.10.0",
|
|
102
|
+
"quickjs-emscripten-core": "^0.32.0",
|
|
103
|
+
"@jitl/quickjs-wasmfile-release-sync": "^0.32.0",
|
|
104
|
+
"@jitl/quickjs-wasmfile-debug-sync": "^0.32.0",
|
|
105
|
+
"@providerkit/core": "0.33.1",
|
|
106
|
+
"@types/pg": "^8.15.0",
|
|
107
|
+
"pg": "^8.16.0",
|
|
108
|
+
"typescript": "^7.0.2",
|
|
109
|
+
"vitest": "^4.1.2"
|
|
110
|
+
},
|
|
111
|
+
"repository": {
|
|
112
|
+
"type": "git",
|
|
113
|
+
"url": "git+https://github.com/providerkit/providerkit.git",
|
|
114
|
+
"directory": "agents"
|
|
115
|
+
}
|
|
116
|
+
}
|
package/src/a2a/auth.ts
ADDED
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
// Bearer authentication policy adapted from google-adk-js core/src/a2a/auth.ts.
|
|
2
|
+
// Copyright 2026 Google LLC. SPDX-License-Identifier: Apache-2.0
|
|
3
|
+
import { A2AError } from "./wire.ts";
|
|
4
|
+
|
|
5
|
+
export interface A2APrincipal {
|
|
6
|
+
owner: string;
|
|
7
|
+
actorId: string;
|
|
8
|
+
}
|
|
9
|
+
export type A2AAuthenticate = (
|
|
10
|
+
request: Request,
|
|
11
|
+
) => A2APrincipal | null | Promise<A2APrincipal | null>;
|
|
12
|
+
|
|
13
|
+
/** A host-owned secret maps to a host-owned principal, never to a card or message claim. */
|
|
14
|
+
export function bearerToken(secret: string, principal: A2APrincipal): A2AAuthenticate {
|
|
15
|
+
if (
|
|
16
|
+
!/^[A-Za-z0-9\-._~+/]+=*$/.test(secret) ||
|
|
17
|
+
secret.length > 8192 ||
|
|
18
|
+
!principal.owner ||
|
|
19
|
+
!principal.actorId
|
|
20
|
+
)
|
|
21
|
+
throw new A2AError("invalid");
|
|
22
|
+
const identity = { owner: principal.owner, actorId: principal.actorId };
|
|
23
|
+
const encoder = new TextEncoder();
|
|
24
|
+
// WebCrypto verifies a fixed-length MAC; no JavaScript string comparison of the secret.
|
|
25
|
+
const key = crypto.subtle.generateKey({ name: "HMAC", hash: "SHA-256" }, false, [
|
|
26
|
+
"sign",
|
|
27
|
+
"verify",
|
|
28
|
+
]);
|
|
29
|
+
const expected = key.then((k) => crypto.subtle.sign("HMAC", k, encoder.encode(secret)));
|
|
30
|
+
return async (request) => {
|
|
31
|
+
const header = request.headers.get("authorization");
|
|
32
|
+
const token = header && /^Bearer ([A-Za-z0-9\-._~+/]+=*)$/i.exec(header)?.[1];
|
|
33
|
+
if (!token || token.length > 8192) return null;
|
|
34
|
+
try {
|
|
35
|
+
return (await crypto.subtle.verify("HMAC", await key, await expected, encoder.encode(token)))
|
|
36
|
+
? { ...identity }
|
|
37
|
+
: null;
|
|
38
|
+
} catch {
|
|
39
|
+
return null;
|
|
40
|
+
}
|
|
41
|
+
};
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
/** Server integrations use this before any task lookup. Missing authentication refuses access. */
|
|
45
|
+
export async function authenticateA2A(
|
|
46
|
+
request: Request,
|
|
47
|
+
authenticate?: A2AAuthenticate,
|
|
48
|
+
): Promise<A2APrincipal | null> {
|
|
49
|
+
if (!authenticate) return null;
|
|
50
|
+
try {
|
|
51
|
+
const principal = await authenticate(request);
|
|
52
|
+
return principal &&
|
|
53
|
+
typeof principal.owner === "string" &&
|
|
54
|
+
principal.owner.length > 0 &&
|
|
55
|
+
typeof principal.actorId === "string" &&
|
|
56
|
+
principal.actorId.length > 0
|
|
57
|
+
? { owner: principal.owner, actorId: principal.actorId }
|
|
58
|
+
: null;
|
|
59
|
+
} catch {
|
|
60
|
+
return null;
|
|
61
|
+
}
|
|
62
|
+
}
|