@punch-bot/a2a 1.3.0 → 1.5.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/CHANGELOG.md +14 -0
- package/README.md +6 -2
- package/dist/client.d.ts +2 -0
- package/dist/client.d.ts.map +1 -1
- package/dist/client.js +15 -6
- package/dist/client.js.map +1 -1
- package/dist/discovery.d.ts +2 -0
- package/dist/discovery.d.ts.map +1 -1
- package/dist/discovery.js +27 -4
- package/dist/discovery.js.map +1 -1
- package/dist/server.d.ts +4 -0
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +61 -1
- package/dist/server.js.map +1 -1
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,20 @@
|
|
|
2
2
|
|
|
3
3
|
## [Unreleased]
|
|
4
4
|
|
|
5
|
+
## [1.5.0] - 2026-11-04
|
|
6
|
+
|
|
7
|
+
### Breaking Changes
|
|
8
|
+
|
|
9
|
+
- `createA2aServer` now requires `Authorization: Bearer <token>` on every request and rejects foreign `Host` headers (DNS rebinding). The token comes from the new `authToken` option or is generated and exposed as `server.authToken`; clients pass it as `token` to `delegateToA2aAgent*`. `A2aPeerRecord` gained `token`.
|
|
10
|
+
|
|
11
|
+
### Fixed
|
|
12
|
+
|
|
13
|
+
- Fixed `LocalA2aDiscovery` trusting a pre-existing discovery directory created by another local user (for example the shared-temp fallback `/tmp/punch-a2a-<uid>`): the directory must now be a real directory owned by the current user with no group or other permissions, and advertisement files not owned by the current user are ignored.
|
|
14
|
+
|
|
15
|
+
## [1.4.1] - 2026-10-28
|
|
16
|
+
|
|
17
|
+
## [1.4.0] - 2026-10-21
|
|
18
|
+
|
|
5
19
|
## [1.3.0] - 2026-10-17
|
|
6
20
|
|
|
7
21
|
## [1.2.0] - 2026-10-12
|
package/README.md
CHANGED
|
@@ -28,9 +28,11 @@ await server.listen(41241);
|
|
|
28
28
|
|
|
29
29
|
`listen()` can take port `0` to bind an ephemeral port. The returned address includes the bound `host`, `port`, and card `url`.
|
|
30
30
|
|
|
31
|
+
Every route, including the agent card, requires `Authorization: Bearer <token>`. Pass `authToken` or read the generated `server.authToken` and give it to clients. Requests whose `Host` header is not the bound address, a loopback name on the bound port, or the `baseUrl`/`publicHost` host are rejected with `403`, which blocks DNS rebinding.
|
|
32
|
+
|
|
31
33
|
## Same-machine discovery
|
|
32
34
|
|
|
33
|
-
Punch sandboxes on one machine advertise a JSON lease into a shared directory (`PUNCH_A2A_DISCOVERY_DIR`, else `$XDG_RUNTIME_DIR/punch/a2a`, else a per-user temp dir). Peers that can see that directory can list live advertisements and connect over A2A without a preconfigured URL.
|
|
35
|
+
Punch sandboxes on one machine advertise a JSON lease into a shared directory (`PUNCH_A2A_DISCOVERY_DIR`, else `$XDG_RUNTIME_DIR/punch/a2a`, else a per-user temp dir). Peers that can see that directory can list live advertisements and connect over A2A without a preconfigured URL. On POSIX systems the directory must be owned by the current user with mode `0700` (no group or other access), or `list()` and `advertise()` throw; advertisement files owned by another user, and entries that are not regular files, are ignored.
|
|
34
36
|
|
|
35
37
|
```ts
|
|
36
38
|
import { LocalA2aDiscovery, defaultA2aDiscoveryDir } from "@punch-bot/a2a";
|
|
@@ -40,6 +42,7 @@ discovery.advertise({
|
|
|
40
42
|
id: "alice",
|
|
41
43
|
name: "alice",
|
|
42
44
|
url: "http://127.0.0.1:41241/",
|
|
45
|
+
token: server.authToken,
|
|
43
46
|
pid: process.pid,
|
|
44
47
|
startedAt: Date.now(),
|
|
45
48
|
});
|
|
@@ -47,7 +50,7 @@ discovery.advertise({
|
|
|
47
50
|
const bob = discovery.find("bob");
|
|
48
51
|
```
|
|
49
52
|
|
|
50
|
-
Stale leases (past TTL without a heartbeat) are dropped on list. Docker sandboxes that do not share loopback should set `PUNCH_A2A_DISCOVERY_DIR` to a shared volume and advertise a reachable URL.
|
|
53
|
+
Stale leases (past TTL without a heartbeat) are dropped on list. Docker sandboxes that do not share loopback should set `PUNCH_A2A_DISCOVERY_DIR` to a shared volume that meets the same owner and mode requirement (all sandboxes running as one uid) and advertise a reachable URL.
|
|
51
54
|
|
|
52
55
|
## Client
|
|
53
56
|
|
|
@@ -57,6 +60,7 @@ import { delegateToA2aAgent } from "@punch-bot/a2a";
|
|
|
57
60
|
const result = await delegateToA2aAgent({
|
|
58
61
|
url: "http://localhost:41241",
|
|
59
62
|
task: "Summarize the repository structure",
|
|
63
|
+
token: server.authToken,
|
|
60
64
|
});
|
|
61
65
|
|
|
62
66
|
console.log(result.text);
|
package/dist/client.d.ts
CHANGED
package/dist/client.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,yBAAyB;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,WAAW,CAAC;
|
|
1
|
+
{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,yBAAyB;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,wBAAwB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAuND,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAG9G;AAED,wBAAsB,wBAAwB,CAC7C,OAAO,EAAE,yBAAyB,EAClC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC/B,OAAO,CAAC,wBAAwB,CAAC,CAGnC;AAED,wBAAsB,8BAA8B,CACnD,OAAO,EAAE,yBAAyB,EAClC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC/B,OAAO,CAAC,wBAAwB,CAAC,CASnC"}
|
package/dist/client.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { TaskState } from "@a2a-js/sdk";
|
|
2
|
-
import { ClientFactory, JsonRpcTransportFactory } from "@a2a-js/sdk/client";
|
|
2
|
+
import { ClientFactory, DefaultAgentCardResolver, JsonRpcTransportFactory } from "@a2a-js/sdk/client";
|
|
3
3
|
import { createTextMessage, extractTextFromMessage } from "./message.js";
|
|
4
4
|
function buildSendMessageRequest(task) {
|
|
5
5
|
return {
|
|
@@ -25,9 +25,18 @@ function buildStreamingSendMessageRequest(task) {
|
|
|
25
25
|
},
|
|
26
26
|
};
|
|
27
27
|
}
|
|
28
|
-
|
|
28
|
+
function bearerFetch(token) {
|
|
29
|
+
return (input, init) => {
|
|
30
|
+
const headers = new Headers(init?.headers);
|
|
31
|
+
headers.set("Authorization", `Bearer ${token}`);
|
|
32
|
+
return fetch(input, { ...init, headers });
|
|
33
|
+
};
|
|
34
|
+
}
|
|
35
|
+
async function createA2aClient(url, token) {
|
|
36
|
+
const fetchImpl = token ? bearerFetch(token) : undefined;
|
|
29
37
|
const factory = new ClientFactory({
|
|
30
|
-
transports: [new JsonRpcTransportFactory()],
|
|
38
|
+
transports: [new JsonRpcTransportFactory({ fetchImpl })],
|
|
39
|
+
cardResolver: new DefaultAgentCardResolver({ fetchImpl }),
|
|
31
40
|
});
|
|
32
41
|
return factory.createFromUrl(url);
|
|
33
42
|
}
|
|
@@ -187,15 +196,15 @@ async function delegateToA2aAgentStreamWithClient(client, options, onUpdate) {
|
|
|
187
196
|
};
|
|
188
197
|
}
|
|
189
198
|
export async function delegateToA2aAgent(options) {
|
|
190
|
-
const client = await createA2aClient(options.url);
|
|
199
|
+
const client = await createA2aClient(options.url, options.token);
|
|
191
200
|
return delegateToA2aAgentWithClient(client, options);
|
|
192
201
|
}
|
|
193
202
|
export async function delegateToA2aAgentStream(options, onUpdate) {
|
|
194
|
-
const client = await createA2aClient(options.url);
|
|
203
|
+
const client = await createA2aClient(options.url, options.token);
|
|
195
204
|
return delegateToA2aAgentStreamWithClient(client, options, onUpdate);
|
|
196
205
|
}
|
|
197
206
|
export async function delegateToA2aAgentPreferStream(options, onUpdate) {
|
|
198
|
-
const client = await createA2aClient(options.url);
|
|
207
|
+
const client = await createA2aClient(options.url, options.token);
|
|
199
208
|
const card = await client.getAgentCard({ signal: options.signal });
|
|
200
209
|
if (card.capabilities?.streaming) {
|
|
201
210
|
return delegateToA2aAgentStreamWithClient(client, options, onUpdate);
|
package/dist/client.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Message, SendMessageRequest, StreamResponse, Task } from \"@a2a-js/sdk\";\nimport { TaskState } from \"@a2a-js/sdk\";\nimport { type Client, ClientFactory, JsonRpcTransportFactory } from \"@a2a-js/sdk/client\";\nimport { createTextMessage, extractTextFromMessage } from \"./message.ts\";\n\nexport interface DelegateToA2aAgentOptions {\n\turl: string;\n\ttask: string;\n\tsignal?: AbortSignal;\n}\n\nexport interface DelegateToA2aAgentResult {\n\ttext: string;\n\ttaskId?: string;\n\tcontextId?: string;\n\tfailed?: boolean;\n\terror?: string;\n}\n\nfunction buildSendMessageRequest(task: string): SendMessageRequest {\n\treturn {\n\t\tmessage: createTextMessage(task, { role: \"user\" }),\n\t\tconfiguration: {\n\t\t\tacceptedOutputModes: [\"text\"],\n\t\t\treturnImmediately: false,\n\t\t\thistoryLength: 0,\n\t\t\ttaskPushNotificationConfig: undefined,\n\t\t},\n\t\tmetadata: {},\n\t\ttenant: \"\",\n\t};\n}\n\nfunction buildStreamingSendMessageRequest(task: string): SendMessageRequest {\n\treturn {\n\t\t...buildSendMessageRequest(task),\n\t\tconfiguration: {\n\t\t\tacceptedOutputModes: [\"text\"],\n\t\t\treturnImmediately: true,\n\t\t\thistoryLength: 0,\n\t\t\ttaskPushNotificationConfig: undefined,\n\t\t},\n\t};\n}\n\nasync function createA2aClient(url: string): Promise<Client> {\n\tconst factory = new ClientFactory({\n\t\ttransports: [new JsonRpcTransportFactory()],\n\t});\n\treturn factory.createFromUrl(url);\n}\n\nfunction extractArtifactTextFromTask(task: Task | undefined): string {\n\tif (!task) return \"\";\n\tconst artifactText = task.artifacts\n\t\t.flatMap((artifact) => artifact.parts.map((part) => (part.content?.$case === \"text\" ? part.content.value : \"\")))\n\t\t.filter(Boolean)\n\t\t.join(\"\\n\")\n\t\t.trim();\n\treturn artifactText;\n}\n\nfunction extractErrorFromTask(task: Task | undefined): string | undefined {\n\tif (!task) return undefined;\n\tconst state = task.status?.state;\n\tif (state === TaskState.TASK_STATE_FAILED) {\n\t\tconst metadataError = task.metadata?.error;\n\t\tif (typeof metadataError === \"string\" && metadataError.length > 0) return metadataError;\n\t\tconst statusText = extractTextFromMessage(task.status?.message);\n\t\tif (statusText) return statusText;\n\t\treturn \"Remote A2A task failed\";\n\t}\n\tif (state === TaskState.TASK_STATE_REJECTED) {\n\t\tconst statusText = extractTextFromMessage(task.status?.message);\n\t\treturn statusText || \"Remote A2A task rejected\";\n\t}\n\tif (state === TaskState.TASK_STATE_CANCELED) {\n\t\tconst statusText = extractTextFromMessage(task.status?.message);\n\t\treturn statusText || \"Remote A2A task canceled\";\n\t}\n\treturn undefined;\n}\n\nfunction extractTextFromTask(task: Task | undefined): string {\n\tif (!task) return \"\";\n\tconst artifactText = extractArtifactTextFromTask(task);\n\tif (artifactText) return artifactText;\n\treturn extractTextFromMessage(task.status?.message);\n}\n\nfunction extractArtifactTextFromStreamEvent(event: StreamResponse, artifactText: string): string {\n\tconst payload = event.payload;\n\tif (!payload) return artifactText;\n\tswitch (payload.$case) {\n\t\tcase \"task\": {\n\t\t\tconst taskArtifact = extractArtifactTextFromTask(payload.value);\n\t\t\treturn taskArtifact || artifactText;\n\t\t}\n\t\tcase \"artifactUpdate\": {\n\t\t\tconst chunk =\n\t\t\t\tpayload.value.artifact?.parts\n\t\t\t\t\t.map((part) => (part.content?.$case === \"text\" ? part.content.value : \"\"))\n\t\t\t\t\t.filter(Boolean)\n\t\t\t\t\t.join(\"\\n\") ?? \"\";\n\t\t\tif (!chunk) return artifactText;\n\t\t\treturn payload.value.append ? `${artifactText}${chunk}` : chunk;\n\t\t}\n\t\tdefault:\n\t\t\treturn artifactText;\n\t}\n}\n\nfunction isTerminalTaskState(state: TaskState | undefined): boolean {\n\treturn (\n\t\tstate === TaskState.TASK_STATE_COMPLETED ||\n\t\tstate === TaskState.TASK_STATE_FAILED ||\n\t\tstate === TaskState.TASK_STATE_CANCELED ||\n\t\tstate === TaskState.TASK_STATE_REJECTED\n\t);\n}\n\nfunction isFailedTerminalTaskState(state: TaskState | undefined): boolean {\n\treturn (\n\t\tstate === TaskState.TASK_STATE_FAILED ||\n\t\tstate === TaskState.TASK_STATE_CANCELED ||\n\t\tstate === TaskState.TASK_STATE_REJECTED\n\t);\n}\n\nfunction buildResultFromTask(task: Task): DelegateToA2aAgentResult {\n\tconst state = task.status?.state;\n\tconst error = extractErrorFromTask(task);\n\tconst failed = error !== undefined || isFailedTerminalTaskState(state);\n\treturn {\n\t\ttext: extractTextFromTask(task),\n\t\ttaskId: task.id,\n\t\tcontextId: task.contextId,\n\t\t...(failed ? { failed: true, error: error ?? \"Remote A2A task failed\" } : {}),\n\t};\n}\n\nasync function delegateToA2aAgentWithClient(\n\tclient: Client,\n\toptions: DelegateToA2aAgentOptions,\n): Promise<DelegateToA2aAgentResult> {\n\tconst response = await client.sendMessage(buildSendMessageRequest(options.task), { signal: options.signal });\n\n\tif (\"parts\" in response) {\n\t\treturn { text: extractTextFromMessage(response as Message) };\n\t}\n\n\treturn buildResultFromTask(response as Task);\n}\n\nasync function delegateToA2aAgentStreamWithClient(\n\tclient: Client,\n\toptions: DelegateToA2aAgentOptions,\n\tonUpdate?: (text: string) => void,\n): Promise<DelegateToA2aAgentResult> {\n\tconst stream = client.sendMessageStream(buildStreamingSendMessageRequest(options.task), { signal: options.signal });\n\n\tlet artifactText = \"\";\n\tlet latestTask: Task | undefined;\n\tlet taskId: string | undefined;\n\tlet contextId: string | undefined;\n\tlet failed = false;\n\tlet error: string | undefined;\n\tfor await (const event of stream) {\n\t\tartifactText = extractArtifactTextFromStreamEvent(event, artifactText);\n\t\tif (artifactText) onUpdate?.(artifactText);\n\t\tconst payload = event.payload;\n\t\tif (payload?.$case === \"task\") {\n\t\t\tlatestTask = payload.value;\n\t\t\ttaskId = payload.value.id;\n\t\t\tcontextId = payload.value.contextId;\n\t\t\tif (isFailedTerminalTaskState(payload.value.status?.state)) {\n\t\t\t\tfailed = true;\n\t\t\t\terror = extractErrorFromTask(payload.value);\n\t\t\t}\n\t\t\tif (isTerminalTaskState(payload.value.status?.state)) {\n\t\t\t\tconst terminalArtifact = extractArtifactTextFromTask(payload.value);\n\t\t\t\tif (terminalArtifact) artifactText = terminalArtifact;\n\t\t\t}\n\t\t}\n\t\tif (payload?.$case === \"statusUpdate\") {\n\t\t\ttaskId = taskId ?? payload.value.taskId;\n\t\t\tcontextId = contextId ?? payload.value.contextId;\n\t\t\tif (payload.value.status?.state === TaskState.TASK_STATE_COMPLETED) {\n\t\t\t\tlatestTask = {\n\t\t\t\t\tid: taskId ?? payload.value.taskId,\n\t\t\t\t\tcontextId: contextId ?? payload.value.contextId,\n\t\t\t\t\tstatus: payload.value.status,\n\t\t\t\t\tartifacts: latestTask?.artifacts ?? [],\n\t\t\t\t\thistory: latestTask?.history ?? [],\n\t\t\t\t\tmetadata: latestTask?.metadata ?? payload.value.metadata ?? {},\n\t\t\t\t};\n\t\t\t}\n\t\t\tif (isFailedTerminalTaskState(payload.value.status?.state)) {\n\t\t\t\tfailed = true;\n\t\t\t\terror = extractErrorFromTask({\n\t\t\t\t\tid: taskId ?? payload.value.taskId,\n\t\t\t\t\tcontextId: contextId ?? payload.value.contextId,\n\t\t\t\t\tstatus: payload.value.status,\n\t\t\t\t\tartifacts: latestTask?.artifacts ?? [],\n\t\t\t\t\thistory: latestTask?.history ?? [],\n\t\t\t\t\tmetadata: payload.value.metadata ?? latestTask?.metadata ?? {},\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\t}\n\n\tconst text = artifactText || extractTextFromTask(latestTask);\n\tif (text && !artifactText) onUpdate?.(text);\n\n\treturn {\n\t\ttext,\n\t\ttaskId,\n\t\tcontextId,\n\t\t...(failed ? { failed: true, error: error ?? \"Remote A2A task failed\" } : {}),\n\t};\n}\n\nexport async function delegateToA2aAgent(options: DelegateToA2aAgentOptions): Promise<DelegateToA2aAgentResult> {\n\tconst client = await createA2aClient(options.url);\n\treturn delegateToA2aAgentWithClient(client, options);\n}\n\nexport async function delegateToA2aAgentStream(\n\toptions: DelegateToA2aAgentOptions,\n\tonUpdate?: (text: string) => void,\n): Promise<DelegateToA2aAgentResult> {\n\tconst client = await createA2aClient(options.url);\n\treturn delegateToA2aAgentStreamWithClient(client, options, onUpdate);\n}\n\nexport async function delegateToA2aAgentPreferStream(\n\toptions: DelegateToA2aAgentOptions,\n\tonUpdate?: (text: string) => void,\n): Promise<DelegateToA2aAgentResult> {\n\tconst client = await createA2aClient(options.url);\n\tconst card = await client.getAgentCard({ signal: options.signal });\n\tif (card.capabilities?.streaming) {\n\t\treturn delegateToA2aAgentStreamWithClient(client, options, onUpdate);\n\t}\n\tconst result = await delegateToA2aAgentWithClient(client, options);\n\tif (result.text) onUpdate?.(result.text);\n\treturn result;\n}\n"]}
|
|
1
|
+
{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Message, SendMessageRequest, StreamResponse, Task } from \"@a2a-js/sdk\";\nimport { TaskState } from \"@a2a-js/sdk\";\nimport { type Client, ClientFactory, DefaultAgentCardResolver, JsonRpcTransportFactory } from \"@a2a-js/sdk/client\";\nimport { createTextMessage, extractTextFromMessage } from \"./message.ts\";\n\nexport interface DelegateToA2aAgentOptions {\n\turl: string;\n\ttask: string;\n\tsignal?: AbortSignal;\n\t/** Bearer token sent as `Authorization` on every request to the agent. */\n\ttoken?: string;\n}\n\nexport interface DelegateToA2aAgentResult {\n\ttext: string;\n\ttaskId?: string;\n\tcontextId?: string;\n\tfailed?: boolean;\n\terror?: string;\n}\n\nfunction buildSendMessageRequest(task: string): SendMessageRequest {\n\treturn {\n\t\tmessage: createTextMessage(task, { role: \"user\" }),\n\t\tconfiguration: {\n\t\t\tacceptedOutputModes: [\"text\"],\n\t\t\treturnImmediately: false,\n\t\t\thistoryLength: 0,\n\t\t\ttaskPushNotificationConfig: undefined,\n\t\t},\n\t\tmetadata: {},\n\t\ttenant: \"\",\n\t};\n}\n\nfunction buildStreamingSendMessageRequest(task: string): SendMessageRequest {\n\treturn {\n\t\t...buildSendMessageRequest(task),\n\t\tconfiguration: {\n\t\t\tacceptedOutputModes: [\"text\"],\n\t\t\treturnImmediately: true,\n\t\t\thistoryLength: 0,\n\t\t\ttaskPushNotificationConfig: undefined,\n\t\t},\n\t};\n}\n\nfunction bearerFetch(token: string): typeof fetch {\n\treturn (input, init) => {\n\t\tconst headers = new Headers(init?.headers);\n\t\theaders.set(\"Authorization\", `Bearer ${token}`);\n\t\treturn fetch(input, { ...init, headers });\n\t};\n}\n\nasync function createA2aClient(url: string, token?: string): Promise<Client> {\n\tconst fetchImpl = token ? bearerFetch(token) : undefined;\n\tconst factory = new ClientFactory({\n\t\ttransports: [new JsonRpcTransportFactory({ fetchImpl })],\n\t\tcardResolver: new DefaultAgentCardResolver({ fetchImpl }),\n\t});\n\treturn factory.createFromUrl(url);\n}\n\nfunction extractArtifactTextFromTask(task: Task | undefined): string {\n\tif (!task) return \"\";\n\tconst artifactText = task.artifacts\n\t\t.flatMap((artifact) => artifact.parts.map((part) => (part.content?.$case === \"text\" ? part.content.value : \"\")))\n\t\t.filter(Boolean)\n\t\t.join(\"\\n\")\n\t\t.trim();\n\treturn artifactText;\n}\n\nfunction extractErrorFromTask(task: Task | undefined): string | undefined {\n\tif (!task) return undefined;\n\tconst state = task.status?.state;\n\tif (state === TaskState.TASK_STATE_FAILED) {\n\t\tconst metadataError = task.metadata?.error;\n\t\tif (typeof metadataError === \"string\" && metadataError.length > 0) return metadataError;\n\t\tconst statusText = extractTextFromMessage(task.status?.message);\n\t\tif (statusText) return statusText;\n\t\treturn \"Remote A2A task failed\";\n\t}\n\tif (state === TaskState.TASK_STATE_REJECTED) {\n\t\tconst statusText = extractTextFromMessage(task.status?.message);\n\t\treturn statusText || \"Remote A2A task rejected\";\n\t}\n\tif (state === TaskState.TASK_STATE_CANCELED) {\n\t\tconst statusText = extractTextFromMessage(task.status?.message);\n\t\treturn statusText || \"Remote A2A task canceled\";\n\t}\n\treturn undefined;\n}\n\nfunction extractTextFromTask(task: Task | undefined): string {\n\tif (!task) return \"\";\n\tconst artifactText = extractArtifactTextFromTask(task);\n\tif (artifactText) return artifactText;\n\treturn extractTextFromMessage(task.status?.message);\n}\n\nfunction extractArtifactTextFromStreamEvent(event: StreamResponse, artifactText: string): string {\n\tconst payload = event.payload;\n\tif (!payload) return artifactText;\n\tswitch (payload.$case) {\n\t\tcase \"task\": {\n\t\t\tconst taskArtifact = extractArtifactTextFromTask(payload.value);\n\t\t\treturn taskArtifact || artifactText;\n\t\t}\n\t\tcase \"artifactUpdate\": {\n\t\t\tconst chunk =\n\t\t\t\tpayload.value.artifact?.parts\n\t\t\t\t\t.map((part) => (part.content?.$case === \"text\" ? part.content.value : \"\"))\n\t\t\t\t\t.filter(Boolean)\n\t\t\t\t\t.join(\"\\n\") ?? \"\";\n\t\t\tif (!chunk) return artifactText;\n\t\t\treturn payload.value.append ? `${artifactText}${chunk}` : chunk;\n\t\t}\n\t\tdefault:\n\t\t\treturn artifactText;\n\t}\n}\n\nfunction isTerminalTaskState(state: TaskState | undefined): boolean {\n\treturn (\n\t\tstate === TaskState.TASK_STATE_COMPLETED ||\n\t\tstate === TaskState.TASK_STATE_FAILED ||\n\t\tstate === TaskState.TASK_STATE_CANCELED ||\n\t\tstate === TaskState.TASK_STATE_REJECTED\n\t);\n}\n\nfunction isFailedTerminalTaskState(state: TaskState | undefined): boolean {\n\treturn (\n\t\tstate === TaskState.TASK_STATE_FAILED ||\n\t\tstate === TaskState.TASK_STATE_CANCELED ||\n\t\tstate === TaskState.TASK_STATE_REJECTED\n\t);\n}\n\nfunction buildResultFromTask(task: Task): DelegateToA2aAgentResult {\n\tconst state = task.status?.state;\n\tconst error = extractErrorFromTask(task);\n\tconst failed = error !== undefined || isFailedTerminalTaskState(state);\n\treturn {\n\t\ttext: extractTextFromTask(task),\n\t\ttaskId: task.id,\n\t\tcontextId: task.contextId,\n\t\t...(failed ? { failed: true, error: error ?? \"Remote A2A task failed\" } : {}),\n\t};\n}\n\nasync function delegateToA2aAgentWithClient(\n\tclient: Client,\n\toptions: DelegateToA2aAgentOptions,\n): Promise<DelegateToA2aAgentResult> {\n\tconst response = await client.sendMessage(buildSendMessageRequest(options.task), { signal: options.signal });\n\n\tif (\"parts\" in response) {\n\t\treturn { text: extractTextFromMessage(response as Message) };\n\t}\n\n\treturn buildResultFromTask(response as Task);\n}\n\nasync function delegateToA2aAgentStreamWithClient(\n\tclient: Client,\n\toptions: DelegateToA2aAgentOptions,\n\tonUpdate?: (text: string) => void,\n): Promise<DelegateToA2aAgentResult> {\n\tconst stream = client.sendMessageStream(buildStreamingSendMessageRequest(options.task), { signal: options.signal });\n\n\tlet artifactText = \"\";\n\tlet latestTask: Task | undefined;\n\tlet taskId: string | undefined;\n\tlet contextId: string | undefined;\n\tlet failed = false;\n\tlet error: string | undefined;\n\tfor await (const event of stream) {\n\t\tartifactText = extractArtifactTextFromStreamEvent(event, artifactText);\n\t\tif (artifactText) onUpdate?.(artifactText);\n\t\tconst payload = event.payload;\n\t\tif (payload?.$case === \"task\") {\n\t\t\tlatestTask = payload.value;\n\t\t\ttaskId = payload.value.id;\n\t\t\tcontextId = payload.value.contextId;\n\t\t\tif (isFailedTerminalTaskState(payload.value.status?.state)) {\n\t\t\t\tfailed = true;\n\t\t\t\terror = extractErrorFromTask(payload.value);\n\t\t\t}\n\t\t\tif (isTerminalTaskState(payload.value.status?.state)) {\n\t\t\t\tconst terminalArtifact = extractArtifactTextFromTask(payload.value);\n\t\t\t\tif (terminalArtifact) artifactText = terminalArtifact;\n\t\t\t}\n\t\t}\n\t\tif (payload?.$case === \"statusUpdate\") {\n\t\t\ttaskId = taskId ?? payload.value.taskId;\n\t\t\tcontextId = contextId ?? payload.value.contextId;\n\t\t\tif (payload.value.status?.state === TaskState.TASK_STATE_COMPLETED) {\n\t\t\t\tlatestTask = {\n\t\t\t\t\tid: taskId ?? payload.value.taskId,\n\t\t\t\t\tcontextId: contextId ?? payload.value.contextId,\n\t\t\t\t\tstatus: payload.value.status,\n\t\t\t\t\tartifacts: latestTask?.artifacts ?? [],\n\t\t\t\t\thistory: latestTask?.history ?? [],\n\t\t\t\t\tmetadata: latestTask?.metadata ?? payload.value.metadata ?? {},\n\t\t\t\t};\n\t\t\t}\n\t\t\tif (isFailedTerminalTaskState(payload.value.status?.state)) {\n\t\t\t\tfailed = true;\n\t\t\t\terror = extractErrorFromTask({\n\t\t\t\t\tid: taskId ?? payload.value.taskId,\n\t\t\t\t\tcontextId: contextId ?? payload.value.contextId,\n\t\t\t\t\tstatus: payload.value.status,\n\t\t\t\t\tartifacts: latestTask?.artifacts ?? [],\n\t\t\t\t\thistory: latestTask?.history ?? [],\n\t\t\t\t\tmetadata: payload.value.metadata ?? latestTask?.metadata ?? {},\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\t}\n\n\tconst text = artifactText || extractTextFromTask(latestTask);\n\tif (text && !artifactText) onUpdate?.(text);\n\n\treturn {\n\t\ttext,\n\t\ttaskId,\n\t\tcontextId,\n\t\t...(failed ? { failed: true, error: error ?? \"Remote A2A task failed\" } : {}),\n\t};\n}\n\nexport async function delegateToA2aAgent(options: DelegateToA2aAgentOptions): Promise<DelegateToA2aAgentResult> {\n\tconst client = await createA2aClient(options.url, options.token);\n\treturn delegateToA2aAgentWithClient(client, options);\n}\n\nexport async function delegateToA2aAgentStream(\n\toptions: DelegateToA2aAgentOptions,\n\tonUpdate?: (text: string) => void,\n): Promise<DelegateToA2aAgentResult> {\n\tconst client = await createA2aClient(options.url, options.token);\n\treturn delegateToA2aAgentStreamWithClient(client, options, onUpdate);\n}\n\nexport async function delegateToA2aAgentPreferStream(\n\toptions: DelegateToA2aAgentOptions,\n\tonUpdate?: (text: string) => void,\n): Promise<DelegateToA2aAgentResult> {\n\tconst client = await createA2aClient(options.url, options.token);\n\tconst card = await client.getAgentCard({ signal: options.signal });\n\tif (card.capabilities?.streaming) {\n\t\treturn delegateToA2aAgentStreamWithClient(client, options, onUpdate);\n\t}\n\tconst result = await delegateToA2aAgentWithClient(client, options);\n\tif (result.text) onUpdate?.(result.text);\n\treturn result;\n}\n"]}
|
package/dist/discovery.d.ts
CHANGED
package/dist/discovery.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,aAAa;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qFAAqF;IACrF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,wBAAwB;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACnB;AAKD,wBAAgB,sBAAsB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAMnF;AA4ED,qBAAa,iBAAiB;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,QAAQ,CAAqB;IAErC,YAAY,OAAO,EAAE,wBAAwB,EAI5C;IAED,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,GAAG,aAAa,CAQhE;IAED,SAAS,IAAI,aAAa,GAAG,SAAS,CAKrC;IAED,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,aAAa,EAAE,CA0CtD;IAED,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,aAAa,GAAG,SAAS,CAM9E;IAED,KAAK,IAAI,IAAI,CAIZ;CACD"}
|
package/dist/discovery.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { mkdirSync, readdirSync, readFileSync, renameSync, unlinkSync, writeFileSync } from "node:fs";
|
|
1
|
+
import { lstatSync, mkdirSync, readdirSync, readFileSync, renameSync, unlinkSync, writeFileSync, } from "node:fs";
|
|
2
2
|
import { tmpdir } from "node:os";
|
|
3
3
|
import * as path from "node:path";
|
|
4
4
|
const DEFAULT_TTL_MS = 45_000;
|
|
@@ -43,20 +43,40 @@ function parseRecord(raw) {
|
|
|
43
43
|
if (typeof value.updatedAt !== "number" || !Number.isFinite(value.updatedAt))
|
|
44
44
|
return undefined;
|
|
45
45
|
const cwd = typeof value.cwd === "string" && value.cwd.length > 0 ? value.cwd : undefined;
|
|
46
|
+
const token = typeof value.token === "string" && value.token.length > 0 ? value.token : undefined;
|
|
46
47
|
return {
|
|
47
48
|
id: value.id,
|
|
48
49
|
name: value.name.trim(),
|
|
49
50
|
url: value.url,
|
|
50
51
|
pid: value.pid,
|
|
51
52
|
...(cwd ? { cwd } : {}),
|
|
53
|
+
...(token ? { token } : {}),
|
|
52
54
|
startedAt: value.startedAt,
|
|
53
55
|
updatedAt: value.updatedAt,
|
|
54
56
|
};
|
|
55
57
|
}
|
|
58
|
+
function ownedByCurrentUser(stats) {
|
|
59
|
+
return typeof process.getuid !== "function" || stats.uid === process.getuid();
|
|
60
|
+
}
|
|
61
|
+
// The default dir can be a predictable shared-temp path, and mkdirSync leaves an
|
|
62
|
+
// existing directory's owner and mode untouched, so verify both before trusting it.
|
|
63
|
+
function ensurePrivateDir(dir) {
|
|
64
|
+
mkdirSync(dir, { recursive: true, mode: 0o700 });
|
|
65
|
+
const stats = lstatSync(dir);
|
|
66
|
+
if (!stats.isDirectory())
|
|
67
|
+
throw new Error(`A2A discovery path is not a directory: ${dir}`);
|
|
68
|
+
if (typeof process.getuid !== "function")
|
|
69
|
+
return;
|
|
70
|
+
if (!ownedByCurrentUser(stats))
|
|
71
|
+
throw new Error(`A2A discovery directory is not owned by the current user: ${dir}`);
|
|
72
|
+
if ((stats.mode & 0o077) !== 0) {
|
|
73
|
+
throw new Error(`A2A discovery directory must not be accessible to group or others (chmod 700): ${dir}`);
|
|
74
|
+
}
|
|
75
|
+
}
|
|
56
76
|
function atomicWrite(file, value) {
|
|
57
|
-
|
|
77
|
+
ensurePrivateDir(path.dirname(file));
|
|
58
78
|
const tmp = `${file}.${process.pid}.${Date.now()}.tmp`;
|
|
59
|
-
writeFileSync(tmp, JSON.stringify(value, null, 2), { mode: 0o600 });
|
|
79
|
+
writeFileSync(tmp, JSON.stringify(value, null, 2), { mode: 0o600, flag: "wx" });
|
|
60
80
|
renameSync(tmp, file);
|
|
61
81
|
}
|
|
62
82
|
function unlinkQuiet(file) {
|
|
@@ -103,7 +123,7 @@ export class LocalA2aDiscovery {
|
|
|
103
123
|
return this.record;
|
|
104
124
|
}
|
|
105
125
|
list(options) {
|
|
106
|
-
|
|
126
|
+
ensurePrivateDir(this.dir);
|
|
107
127
|
let entries;
|
|
108
128
|
try {
|
|
109
129
|
entries = readdirSync(this.dir);
|
|
@@ -124,6 +144,9 @@ export class LocalA2aDiscovery {
|
|
|
124
144
|
continue;
|
|
125
145
|
let parsed;
|
|
126
146
|
try {
|
|
147
|
+
const stats = lstatSync(file);
|
|
148
|
+
if (!stats.isFile() || !ownedByCurrentUser(stats))
|
|
149
|
+
continue;
|
|
127
150
|
parsed = JSON.parse(readFileSync(file, "utf8"));
|
|
128
151
|
}
|
|
129
152
|
catch {
|
package/dist/discovery.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"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","sourcesContent":["import { mkdirSync, readdirSync, readFileSync, renameSync, unlinkSync, writeFileSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport * as path from \"node:path\";\n\nexport interface A2aPeerRecord {\n\tid: string;\n\tname: string;\n\turl: string;\n\tpid: number;\n\tcwd?: string;\n\tstartedAt: number;\n\tupdatedAt: number;\n}\n\nexport interface LocalA2aDiscoveryOptions {\n\tdir: string;\n\tttlMs?: number;\n\tnow?: () => number;\n}\n\nconst DEFAULT_TTL_MS = 45_000;\nconst ID_PATTERN = /^[A-Za-z0-9._-]+$/;\n\nexport function defaultA2aDiscoveryDir(env: NodeJS.ProcessEnv = process.env): string {\n\tconst configured = env.PUNCH_A2A_DISCOVERY_DIR;\n\tif (configured?.trim()) return path.resolve(configured);\n\tconst runtimeDir = env.XDG_RUNTIME_DIR;\n\tif (runtimeDir?.trim()) return path.join(runtimeDir, \"punch\", \"a2a\");\n\treturn path.join(tmpdir(), `punch-a2a-${currentUid()}`);\n}\n\nfunction currentUid(): string | number {\n\tif (typeof process.getuid === \"function\") return process.getuid();\n\treturn \"user\";\n}\n\nfunction isHttpUrl(value: string): boolean {\n\ttry {\n\t\tconst url = new URL(value);\n\t\treturn url.protocol === \"http:\" || url.protocol === \"https:\";\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nfunction parseRecord(raw: unknown): A2aPeerRecord | undefined {\n\tif (!raw || typeof raw !== \"object\") return undefined;\n\tconst value = raw as Record<string, unknown>;\n\tif (typeof value.id !== \"string\" || !ID_PATTERN.test(value.id)) return undefined;\n\tif (typeof value.name !== \"string\" || value.name.trim().length === 0) return undefined;\n\tif (typeof value.url !== \"string\" || !isHttpUrl(value.url)) return undefined;\n\tif (typeof value.pid !== \"number\" || !Number.isInteger(value.pid) || value.pid <= 0) return undefined;\n\tif (typeof value.startedAt !== \"number\" || !Number.isFinite(value.startedAt)) return undefined;\n\tif (typeof value.updatedAt !== \"number\" || !Number.isFinite(value.updatedAt)) return undefined;\n\tconst cwd = typeof value.cwd === \"string\" && value.cwd.length > 0 ? value.cwd : undefined;\n\treturn {\n\t\tid: value.id,\n\t\tname: value.name.trim(),\n\t\turl: value.url,\n\t\tpid: value.pid,\n\t\t...(cwd ? { cwd } : {}),\n\t\tstartedAt: value.startedAt,\n\t\tupdatedAt: value.updatedAt,\n\t};\n}\n\nfunction atomicWrite(file: string, value: unknown): void {\n\tmkdirSync(path.dirname(file), { recursive: true, mode: 0o700 });\n\tconst tmp = `${file}.${process.pid}.${Date.now()}.tmp`;\n\twriteFileSync(tmp, JSON.stringify(value, null, 2), { mode: 0o600 });\n\trenameSync(tmp, file);\n}\n\nfunction unlinkQuiet(file: string): void {\n\ttry {\n\t\tunlinkSync(file);\n\t} catch (err) {\n\t\tif ((err as NodeJS.ErrnoException).code !== \"ENOENT\") throw err;\n\t}\n}\n\nfunction leasePath(dir: string, id: string): string {\n\tif (!ID_PATTERN.test(id)) throw new Error(\"Invalid A2A peer id.\");\n\treturn path.join(dir, `${id}.json`);\n}\n\nexport class LocalA2aDiscovery {\n\treadonly dir: string;\n\tprivate readonly ttlMs: number;\n\tprivate readonly now: () => number;\n\tprivate record: A2aPeerRecord | undefined;\n\tprivate filePath: string | undefined;\n\n\tconstructor(options: LocalA2aDiscoveryOptions) {\n\t\tthis.dir = path.resolve(options.dir);\n\t\tthis.ttlMs = options.ttlMs ?? DEFAULT_TTL_MS;\n\t\tthis.now = options.now ?? Date.now;\n\t}\n\n\tadvertise(input: Omit<A2aPeerRecord, \"updatedAt\">): A2aPeerRecord {\n\t\tconst record: A2aPeerRecord = { ...input, name: input.name.trim(), updatedAt: this.now() };\n\t\tif (!record.name) throw new Error(\"A2A peer name is required.\");\n\t\tif (!isHttpUrl(record.url)) throw new Error(\"A2A peer URL must be absolute http(s).\");\n\t\tthis.record = record;\n\t\tthis.filePath = leasePath(this.dir, record.id);\n\t\tatomicWrite(this.filePath, record);\n\t\treturn record;\n\t}\n\n\theartbeat(): A2aPeerRecord | undefined {\n\t\tif (!this.record || !this.filePath) return undefined;\n\t\tthis.record = { ...this.record, updatedAt: this.now() };\n\t\tatomicWrite(this.filePath, this.record);\n\t\treturn this.record;\n\t}\n\n\tlist(options?: { excludeId?: string }): A2aPeerRecord[] {\n\t\tmkdirSync(this.dir, { recursive: true, mode: 0o700 });\n\t\tlet entries: string[];\n\t\ttry {\n\t\t\tentries = readdirSync(this.dir);\n\t\t} catch (err) {\n\t\t\tif ((err as NodeJS.ErrnoException).code === \"ENOENT\") return [];\n\t\t\tthrow err;\n\t\t}\n\t\tconst now = this.now();\n\t\tconst excludeId = options?.excludeId ?? this.record?.id;\n\t\tconst peers: A2aPeerRecord[] = [];\n\t\tfor (const entry of entries) {\n\t\t\tif (!entry.endsWith(\".json\")) continue;\n\t\t\tconst file = path.join(this.dir, entry);\n\t\t\tif (path.dirname(file) !== this.dir) continue;\n\t\t\tlet parsed: unknown;\n\t\t\ttry {\n\t\t\t\tparsed = JSON.parse(readFileSync(file, \"utf8\"));\n\t\t\t} catch {\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tconst record = parseRecord(parsed);\n\t\t\tif (!record) continue;\n\t\t\tif (excludeId && record.id === excludeId) continue;\n\t\t\tif (now - record.updatedAt <= this.ttlMs) {\n\t\t\t\tpeers.push(record);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tlet latest = record;\n\t\t\ttry {\n\t\t\t\tlatest = parseRecord(JSON.parse(readFileSync(file, \"utf8\"))) ?? record;\n\t\t\t} catch {}\n\t\t\tif (now - latest.updatedAt > this.ttlMs) {\n\t\t\t\ttry {\n\t\t\t\t\tunlinkQuiet(file);\n\t\t\t\t} catch {}\n\t\t\t}\n\t\t}\n\t\treturn peers.sort((a, b) => a.name.localeCompare(b.name) || a.id.localeCompare(b.id));\n\t}\n\n\tfind(name: string, options?: { excludeId?: string }): A2aPeerRecord | undefined {\n\t\tconst lowered = name.trim().toLowerCase();\n\t\tif (!lowered) return undefined;\n\t\tconst matches = this.list(options).filter((peer) => peer.name.toLowerCase() === lowered);\n\t\tif (matches.length === 0) return undefined;\n\t\treturn matches.sort((a, b) => b.updatedAt - a.updatedAt)[0];\n\t}\n\n\tclose(): void {\n\t\tif (this.filePath) unlinkQuiet(this.filePath);\n\t\tthis.filePath = undefined;\n\t\tthis.record = undefined;\n\t}\n}\n"]}
|
|
1
|
+
{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n\tlstatSync,\n\tmkdirSync,\n\treaddirSync,\n\treadFileSync,\n\trenameSync,\n\ttype Stats,\n\tunlinkSync,\n\twriteFileSync,\n} from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport * as path from \"node:path\";\n\nexport interface A2aPeerRecord {\n\tid: string;\n\tname: string;\n\turl: string;\n\tpid: number;\n\tcwd?: string;\n\t/** Bearer token for the peer's A2A listener. Only stored in the 0600 record file. */\n\ttoken?: string;\n\tstartedAt: number;\n\tupdatedAt: number;\n}\n\nexport interface LocalA2aDiscoveryOptions {\n\tdir: string;\n\tttlMs?: number;\n\tnow?: () => number;\n}\n\nconst DEFAULT_TTL_MS = 45_000;\nconst ID_PATTERN = /^[A-Za-z0-9._-]+$/;\n\nexport function defaultA2aDiscoveryDir(env: NodeJS.ProcessEnv = process.env): string {\n\tconst configured = env.PUNCH_A2A_DISCOVERY_DIR;\n\tif (configured?.trim()) return path.resolve(configured);\n\tconst runtimeDir = env.XDG_RUNTIME_DIR;\n\tif (runtimeDir?.trim()) return path.join(runtimeDir, \"punch\", \"a2a\");\n\treturn path.join(tmpdir(), `punch-a2a-${currentUid()}`);\n}\n\nfunction currentUid(): string | number {\n\tif (typeof process.getuid === \"function\") return process.getuid();\n\treturn \"user\";\n}\n\nfunction isHttpUrl(value: string): boolean {\n\ttry {\n\t\tconst url = new URL(value);\n\t\treturn url.protocol === \"http:\" || url.protocol === \"https:\";\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nfunction parseRecord(raw: unknown): A2aPeerRecord | undefined {\n\tif (!raw || typeof raw !== \"object\") return undefined;\n\tconst value = raw as Record<string, unknown>;\n\tif (typeof value.id !== \"string\" || !ID_PATTERN.test(value.id)) return undefined;\n\tif (typeof value.name !== \"string\" || value.name.trim().length === 0) return undefined;\n\tif (typeof value.url !== \"string\" || !isHttpUrl(value.url)) return undefined;\n\tif (typeof value.pid !== \"number\" || !Number.isInteger(value.pid) || value.pid <= 0) return undefined;\n\tif (typeof value.startedAt !== \"number\" || !Number.isFinite(value.startedAt)) return undefined;\n\tif (typeof value.updatedAt !== \"number\" || !Number.isFinite(value.updatedAt)) return undefined;\n\tconst cwd = typeof value.cwd === \"string\" && value.cwd.length > 0 ? value.cwd : undefined;\n\tconst token = typeof value.token === \"string\" && value.token.length > 0 ? value.token : undefined;\n\treturn {\n\t\tid: value.id,\n\t\tname: value.name.trim(),\n\t\turl: value.url,\n\t\tpid: value.pid,\n\t\t...(cwd ? { cwd } : {}),\n\t\t...(token ? { token } : {}),\n\t\tstartedAt: value.startedAt,\n\t\tupdatedAt: value.updatedAt,\n\t};\n}\n\nfunction ownedByCurrentUser(stats: Stats): boolean {\n\treturn typeof process.getuid !== \"function\" || stats.uid === process.getuid();\n}\n\n// The default dir can be a predictable shared-temp path, and mkdirSync leaves an\n// existing directory's owner and mode untouched, so verify both before trusting it.\nfunction ensurePrivateDir(dir: string): void {\n\tmkdirSync(dir, { recursive: true, mode: 0o700 });\n\tconst stats = lstatSync(dir);\n\tif (!stats.isDirectory()) throw new Error(`A2A discovery path is not a directory: ${dir}`);\n\tif (typeof process.getuid !== \"function\") return;\n\tif (!ownedByCurrentUser(stats)) throw new Error(`A2A discovery directory is not owned by the current user: ${dir}`);\n\tif ((stats.mode & 0o077) !== 0) {\n\t\tthrow new Error(`A2A discovery directory must not be accessible to group or others (chmod 700): ${dir}`);\n\t}\n}\n\nfunction atomicWrite(file: string, value: unknown): void {\n\tensurePrivateDir(path.dirname(file));\n\tconst tmp = `${file}.${process.pid}.${Date.now()}.tmp`;\n\twriteFileSync(tmp, JSON.stringify(value, null, 2), { mode: 0o600, flag: \"wx\" });\n\trenameSync(tmp, file);\n}\n\nfunction unlinkQuiet(file: string): void {\n\ttry {\n\t\tunlinkSync(file);\n\t} catch (err) {\n\t\tif ((err as NodeJS.ErrnoException).code !== \"ENOENT\") throw err;\n\t}\n}\n\nfunction leasePath(dir: string, id: string): string {\n\tif (!ID_PATTERN.test(id)) throw new Error(\"Invalid A2A peer id.\");\n\treturn path.join(dir, `${id}.json`);\n}\n\nexport class LocalA2aDiscovery {\n\treadonly dir: string;\n\tprivate readonly ttlMs: number;\n\tprivate readonly now: () => number;\n\tprivate record: A2aPeerRecord | undefined;\n\tprivate filePath: string | undefined;\n\n\tconstructor(options: LocalA2aDiscoveryOptions) {\n\t\tthis.dir = path.resolve(options.dir);\n\t\tthis.ttlMs = options.ttlMs ?? DEFAULT_TTL_MS;\n\t\tthis.now = options.now ?? Date.now;\n\t}\n\n\tadvertise(input: Omit<A2aPeerRecord, \"updatedAt\">): A2aPeerRecord {\n\t\tconst record: A2aPeerRecord = { ...input, name: input.name.trim(), updatedAt: this.now() };\n\t\tif (!record.name) throw new Error(\"A2A peer name is required.\");\n\t\tif (!isHttpUrl(record.url)) throw new Error(\"A2A peer URL must be absolute http(s).\");\n\t\tthis.record = record;\n\t\tthis.filePath = leasePath(this.dir, record.id);\n\t\tatomicWrite(this.filePath, record);\n\t\treturn record;\n\t}\n\n\theartbeat(): A2aPeerRecord | undefined {\n\t\tif (!this.record || !this.filePath) return undefined;\n\t\tthis.record = { ...this.record, updatedAt: this.now() };\n\t\tatomicWrite(this.filePath, this.record);\n\t\treturn this.record;\n\t}\n\n\tlist(options?: { excludeId?: string }): A2aPeerRecord[] {\n\t\tensurePrivateDir(this.dir);\n\t\tlet entries: string[];\n\t\ttry {\n\t\t\tentries = readdirSync(this.dir);\n\t\t} catch (err) {\n\t\t\tif ((err as NodeJS.ErrnoException).code === \"ENOENT\") return [];\n\t\t\tthrow err;\n\t\t}\n\t\tconst now = this.now();\n\t\tconst excludeId = options?.excludeId ?? this.record?.id;\n\t\tconst peers: A2aPeerRecord[] = [];\n\t\tfor (const entry of entries) {\n\t\t\tif (!entry.endsWith(\".json\")) continue;\n\t\t\tconst file = path.join(this.dir, entry);\n\t\t\tif (path.dirname(file) !== this.dir) continue;\n\t\t\tlet parsed: unknown;\n\t\t\ttry {\n\t\t\t\tconst stats = lstatSync(file);\n\t\t\t\tif (!stats.isFile() || !ownedByCurrentUser(stats)) continue;\n\t\t\t\tparsed = JSON.parse(readFileSync(file, \"utf8\"));\n\t\t\t} catch {\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tconst record = parseRecord(parsed);\n\t\t\tif (!record) continue;\n\t\t\tif (excludeId && record.id === excludeId) continue;\n\t\t\tif (now - record.updatedAt <= this.ttlMs) {\n\t\t\t\tpeers.push(record);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tlet latest = record;\n\t\t\ttry {\n\t\t\t\tlatest = parseRecord(JSON.parse(readFileSync(file, \"utf8\"))) ?? record;\n\t\t\t} catch {}\n\t\t\tif (now - latest.updatedAt > this.ttlMs) {\n\t\t\t\ttry {\n\t\t\t\t\tunlinkQuiet(file);\n\t\t\t\t} catch {}\n\t\t\t}\n\t\t}\n\t\treturn peers.sort((a, b) => a.name.localeCompare(b.name) || a.id.localeCompare(b.id));\n\t}\n\n\tfind(name: string, options?: { excludeId?: string }): A2aPeerRecord | undefined {\n\t\tconst lowered = name.trim().toLowerCase();\n\t\tif (!lowered) return undefined;\n\t\tconst matches = this.list(options).filter((peer) => peer.name.toLowerCase() === lowered);\n\t\tif (matches.length === 0) return undefined;\n\t\treturn matches.sort((a, b) => b.updatedAt - a.updatedAt)[0];\n\t}\n\n\tclose(): void {\n\t\tif (this.filePath) unlinkQuiet(this.filePath);\n\t\tthis.filePath = undefined;\n\t\tthis.record = undefined;\n\t}\n}\n"]}
|
package/dist/server.d.ts
CHANGED
|
@@ -12,10 +12,14 @@ export interface CreateA2aServerOptions {
|
|
|
12
12
|
runnerFactory: HarnessPromptRunnerFactory;
|
|
13
13
|
name?: string;
|
|
14
14
|
description?: string;
|
|
15
|
+
/** Bearer token callers must send. A random token is generated when omitted. */
|
|
16
|
+
authToken?: string;
|
|
15
17
|
}
|
|
16
18
|
export interface A2aServer {
|
|
17
19
|
app: Express;
|
|
18
20
|
requestHandler: DefaultRequestHandler | undefined;
|
|
21
|
+
/** Bearer token required on every request. Pass it to clients as `token`. */
|
|
22
|
+
readonly authToken: string;
|
|
19
23
|
listen(port?: number, host?: string): Promise<A2aListenAddress>;
|
|
20
24
|
close(): Promise<void>;
|
|
21
25
|
address(): A2aListenAddress | undefined;
|
package/dist/server.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,qBAAqB,EAAqB,MAAM,oBAAoB,CAAC;AAE9E,OAAO,KAAK,EAAE,OAAO,EAAmC,MAAM,SAAS,CAAC;AAGxE,OAAO,EAAwB,KAAK,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAGtF,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,sBAAsB;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,0BAA0B,CAAC;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACzB,GAAG,EAAE,OAAO,CAAC;IACb,cAAc,EAAE,qBAAqB,GAAG,SAAS,CAAC;IAClD,6EAA6E;IAC7E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAChE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,OAAO,IAAI,gBAAgB,GAAG,SAAS,CAAC;IACxC,KAAK,IAAI,IAAI,CAAC;CACd;AAwBD,wBAAsB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,SAAS,CAAC,CAkHzF"}
|
package/dist/server.js
CHANGED
|
@@ -1,3 +1,5 @@
|
|
|
1
|
+
import { createHash, randomBytes, timingSafeEqual } from "node:crypto";
|
|
2
|
+
import { isIP } from "node:net";
|
|
1
3
|
import { AGENT_CARD_PATH } from "@a2a-js/sdk";
|
|
2
4
|
import { DefaultRequestHandler, InMemoryTaskStore } from "@a2a-js/sdk/server";
|
|
3
5
|
import { agentCardHandler, jsonRpcHandler, UserBuilder } from "@a2a-js/sdk/server/express";
|
|
@@ -5,7 +7,30 @@ import express from "express";
|
|
|
5
7
|
import { createPunchAgentCard } from "./agent-card.js";
|
|
6
8
|
import { HarnessAgentExecutor } from "./executor.js";
|
|
7
9
|
import { formatA2aHttpUrl } from "./http-url.js";
|
|
10
|
+
const LOOPBACK_NAMES = ["127.0.0.1", "localhost", "[::1]"];
|
|
11
|
+
function isLoopbackHost(host) {
|
|
12
|
+
const hostname = host.startsWith("[") && host.endsWith("]") ? host.slice(1, -1) : host;
|
|
13
|
+
if (hostname === "localhost" || hostname === "::1")
|
|
14
|
+
return true;
|
|
15
|
+
return isIP(hostname) === 4 && hostname.startsWith("127.");
|
|
16
|
+
}
|
|
17
|
+
function digest(value) {
|
|
18
|
+
return createHash("sha256").update(value).digest();
|
|
19
|
+
}
|
|
20
|
+
function bearerToken(header) {
|
|
21
|
+
if (!header)
|
|
22
|
+
return undefined;
|
|
23
|
+
const match = /^Bearer\s+(\S+)\s*$/i.exec(header);
|
|
24
|
+
return match?.[1];
|
|
25
|
+
}
|
|
26
|
+
function urlHost(url) {
|
|
27
|
+
return new URL(url).host.toLowerCase();
|
|
28
|
+
}
|
|
8
29
|
export async function createA2aServer(options) {
|
|
30
|
+
const authToken = options.authToken ?? randomBytes(32).toString("base64url");
|
|
31
|
+
if (authToken.trim().length === 0)
|
|
32
|
+
throw new Error("A2A authToken must not be empty.");
|
|
33
|
+
const expectedDigest = digest(authToken);
|
|
9
34
|
const taskStore = new InMemoryTaskStore();
|
|
10
35
|
const agentExecutor = new HarnessAgentExecutor(options.runnerFactory);
|
|
11
36
|
const app = express();
|
|
@@ -13,6 +38,37 @@ export async function createA2aServer(options) {
|
|
|
13
38
|
let routesMounted = false;
|
|
14
39
|
let server;
|
|
15
40
|
let bound;
|
|
41
|
+
let allowedHosts = new Set();
|
|
42
|
+
function computeAllowedHosts(info) {
|
|
43
|
+
const hosts = new Set();
|
|
44
|
+
const port = info.port;
|
|
45
|
+
const boundHost = info.host.includes(":") ? `[${info.host}]` : info.host;
|
|
46
|
+
hosts.add(`${boundHost}:${port}`.toLowerCase());
|
|
47
|
+
if (isLoopbackHost(info.host) || info.host === "0.0.0.0" || info.host === "::") {
|
|
48
|
+
for (const name of LOOPBACK_NAMES)
|
|
49
|
+
hosts.add(`${name}:${port}`);
|
|
50
|
+
}
|
|
51
|
+
hosts.add(urlHost(info.url));
|
|
52
|
+
if (options.baseUrl)
|
|
53
|
+
hosts.add(urlHost(options.baseUrl));
|
|
54
|
+
if (options.publicHost)
|
|
55
|
+
hosts.add(urlHost(formatA2aHttpUrl(options.publicHost, port)));
|
|
56
|
+
return hosts;
|
|
57
|
+
}
|
|
58
|
+
app.use((req, res, next) => {
|
|
59
|
+
const host = req.headers.host?.toLowerCase();
|
|
60
|
+
if (!bound || !host || !allowedHosts.has(host)) {
|
|
61
|
+
res.status(403).json({ error: "Forbidden host" });
|
|
62
|
+
return;
|
|
63
|
+
}
|
|
64
|
+
const token = bearerToken(req.headers.authorization);
|
|
65
|
+
if (!token || !timingSafeEqual(digest(token), expectedDigest)) {
|
|
66
|
+
res.setHeader("WWW-Authenticate", 'Bearer realm="a2a"');
|
|
67
|
+
res.status(401).json({ error: "Unauthorized" });
|
|
68
|
+
return;
|
|
69
|
+
}
|
|
70
|
+
next();
|
|
71
|
+
});
|
|
16
72
|
function mount(baseUrl) {
|
|
17
73
|
if (routesMounted)
|
|
18
74
|
return;
|
|
@@ -23,6 +79,7 @@ export async function createA2aServer(options) {
|
|
|
23
79
|
});
|
|
24
80
|
requestHandler = new DefaultRequestHandler(agentCard, taskStore, agentExecutor);
|
|
25
81
|
app.use(`/${AGENT_CARD_PATH}`, agentCardHandler({ agentCardProvider: requestHandler }));
|
|
82
|
+
// Authentication is enforced by the bearer-token middleware above.
|
|
26
83
|
app.use(jsonRpcHandler({ requestHandler, userBuilder: UserBuilder.noAuthentication }));
|
|
27
84
|
routesMounted = true;
|
|
28
85
|
}
|
|
@@ -33,6 +90,7 @@ export async function createA2aServer(options) {
|
|
|
33
90
|
get requestHandler() {
|
|
34
91
|
return requestHandler;
|
|
35
92
|
},
|
|
93
|
+
authToken,
|
|
36
94
|
listen(port = 0, host = "127.0.0.1") {
|
|
37
95
|
return new Promise((resolve, reject) => {
|
|
38
96
|
server = app.listen(port, host, (error) => {
|
|
@@ -47,14 +105,16 @@ export async function createA2aServer(options) {
|
|
|
47
105
|
}
|
|
48
106
|
const info = addr;
|
|
49
107
|
const url = options.baseUrl ?? formatA2aHttpUrl(options.publicHost ?? info.address, info.port);
|
|
50
|
-
|
|
108
|
+
const next = { host: info.address, port: info.port, url };
|
|
51
109
|
try {
|
|
110
|
+
allowedHosts = computeAllowedHosts(next);
|
|
52
111
|
mount(url);
|
|
53
112
|
}
|
|
54
113
|
catch (err) {
|
|
55
114
|
reject(err);
|
|
56
115
|
return;
|
|
57
116
|
}
|
|
117
|
+
bound = next;
|
|
58
118
|
resolve(bound);
|
|
59
119
|
});
|
|
60
120
|
});
|
package/dist/server.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AddressInfo } from \"node:net\";\nimport { AGENT_CARD_PATH } from \"@a2a-js/sdk\";\nimport { DefaultRequestHandler, InMemoryTaskStore } from \"@a2a-js/sdk/server\";\nimport { agentCardHandler, jsonRpcHandler, UserBuilder } from \"@a2a-js/sdk/server/express\";\nimport type { Express } from \"express\";\nimport express from \"express\";\nimport { createPunchAgentCard } from \"./agent-card.ts\";\nimport { HarnessAgentExecutor, type HarnessPromptRunnerFactory } from \"./executor.ts\";\nimport { formatA2aHttpUrl } from \"./http-url.ts\";\n\nexport interface A2aListenAddress {\n\thost: string;\n\tport: number;\n\turl: string;\n}\n\nexport interface CreateA2aServerOptions {\n\tbaseUrl?: string;\n\tpublicHost?: string;\n\trunnerFactory: HarnessPromptRunnerFactory;\n\tname?: string;\n\tdescription?: string;\n}\n\nexport interface A2aServer {\n\tapp: Express;\n\trequestHandler: DefaultRequestHandler | undefined;\n\tlisten(port?: number, host?: string): Promise<A2aListenAddress>;\n\tclose(): Promise<void>;\n\taddress(): A2aListenAddress | undefined;\n\tunref(): void;\n}\n\nexport async function createA2aServer(options: CreateA2aServerOptions): Promise<A2aServer> {\n\tconst taskStore = new InMemoryTaskStore();\n\tconst agentExecutor = new HarnessAgentExecutor(options.runnerFactory);\n\tconst app = express();\n\tlet requestHandler: DefaultRequestHandler | undefined;\n\tlet routesMounted = false;\n\tlet server: ReturnType<Express[\"listen\"]> | undefined;\n\tlet bound: A2aListenAddress | undefined;\n\n\tfunction mount(baseUrl: string): void {\n\t\tif (routesMounted) return;\n\t\tconst agentCard = createPunchAgentCard({\n\t\t\tbaseUrl,\n\t\t\tname: options.name,\n\t\t\tdescription: options.description,\n\t\t});\n\t\trequestHandler = new DefaultRequestHandler(agentCard, taskStore, agentExecutor);\n\t\tapp.use(`/${AGENT_CARD_PATH}`, agentCardHandler({ agentCardProvider: requestHandler }));\n\t\tapp.use(jsonRpcHandler({ requestHandler, userBuilder: UserBuilder.noAuthentication }));\n\t\troutesMounted = true;\n\t}\n\n\tif (options.baseUrl) mount(options.baseUrl);\n\n\treturn {\n\t\tapp,\n\t\tget requestHandler() {\n\t\t\treturn requestHandler;\n\t\t},\n\t\tlisten(port = 0, host = \"127.0.0.1\") {\n\t\t\treturn new Promise((resolve, reject) => {\n\t\t\t\tserver = app.listen(port, host, (error?: Error) => {\n\t\t\t\t\tif (error) {\n\t\t\t\t\t\treject(error);\n\t\t\t\t\t\treturn;\n\t\t\t\t\t}\n\t\t\t\t\tconst addr = server?.address();\n\t\t\t\t\tif (!addr || typeof addr === \"string\") {\n\t\t\t\t\t\treject(new Error(\"A2A server bound without a TCP address\"));\n\t\t\t\t\t\treturn;\n\t\t\t\t\t}\n\t\t\t\t\tconst info = addr as AddressInfo;\n\t\t\t\t\tconst url = options.baseUrl ?? formatA2aHttpUrl(options.publicHost ?? info.address, info.port);\n\t\t\t\t\tbound = { host: info.address, port: info.port, url };\n\t\t\t\t\ttry {\n\t\t\t\t\t\tmount(url);\n\t\t\t\t\t} catch (err) {\n\t\t\t\t\t\treject(err);\n\t\t\t\t\t\treturn;\n\t\t\t\t\t}\n\t\t\t\t\tresolve(bound);\n\t\t\t\t});\n\t\t\t});\n\t\t},\n\t\taddress() {\n\t\t\treturn bound;\n\t\t},\n\t\tunref() {\n\t\t\tserver?.unref();\n\t\t},\n\t\tclose() {\n\t\t\treturn new Promise((resolve, reject) => {\n\t\t\t\tif (!server) {\n\t\t\t\t\tbound = undefined;\n\t\t\t\t\tresolve();\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tserver.close((error) => {\n\t\t\t\t\tif (error) reject(error);\n\t\t\t\t\telse {\n\t\t\t\t\t\tbound = undefined;\n\t\t\t\t\t\tresolve();\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t});\n\t\t},\n\t};\n}\n"]}
|
|
1
|
+
{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash, randomBytes, timingSafeEqual } from \"node:crypto\";\nimport type { AddressInfo } from \"node:net\";\nimport { isIP } from \"node:net\";\nimport { AGENT_CARD_PATH } from \"@a2a-js/sdk\";\nimport { DefaultRequestHandler, InMemoryTaskStore } from \"@a2a-js/sdk/server\";\nimport { agentCardHandler, jsonRpcHandler, UserBuilder } from \"@a2a-js/sdk/server/express\";\nimport type { Express, NextFunction, Request, Response } from \"express\";\nimport express from \"express\";\nimport { createPunchAgentCard } from \"./agent-card.ts\";\nimport { HarnessAgentExecutor, type HarnessPromptRunnerFactory } from \"./executor.ts\";\nimport { formatA2aHttpUrl } from \"./http-url.ts\";\n\nexport interface A2aListenAddress {\n\thost: string;\n\tport: number;\n\turl: string;\n}\n\nexport interface CreateA2aServerOptions {\n\tbaseUrl?: string;\n\tpublicHost?: string;\n\trunnerFactory: HarnessPromptRunnerFactory;\n\tname?: string;\n\tdescription?: string;\n\t/** Bearer token callers must send. A random token is generated when omitted. */\n\tauthToken?: string;\n}\n\nexport interface A2aServer {\n\tapp: Express;\n\trequestHandler: DefaultRequestHandler | undefined;\n\t/** Bearer token required on every request. Pass it to clients as `token`. */\n\treadonly authToken: string;\n\tlisten(port?: number, host?: string): Promise<A2aListenAddress>;\n\tclose(): Promise<void>;\n\taddress(): A2aListenAddress | undefined;\n\tunref(): void;\n}\n\nconst LOOPBACK_NAMES = [\"127.0.0.1\", \"localhost\", \"[::1]\"];\n\nfunction isLoopbackHost(host: string): boolean {\n\tconst hostname = host.startsWith(\"[\") && host.endsWith(\"]\") ? host.slice(1, -1) : host;\n\tif (hostname === \"localhost\" || hostname === \"::1\") return true;\n\treturn isIP(hostname) === 4 && hostname.startsWith(\"127.\");\n}\n\nfunction digest(value: string): Buffer {\n\treturn createHash(\"sha256\").update(value).digest();\n}\n\nfunction bearerToken(header: string | undefined): string | undefined {\n\tif (!header) return undefined;\n\tconst match = /^Bearer\\s+(\\S+)\\s*$/i.exec(header);\n\treturn match?.[1];\n}\n\nfunction urlHost(url: string): string {\n\treturn new URL(url).host.toLowerCase();\n}\n\nexport async function createA2aServer(options: CreateA2aServerOptions): Promise<A2aServer> {\n\tconst authToken = options.authToken ?? randomBytes(32).toString(\"base64url\");\n\tif (authToken.trim().length === 0) throw new Error(\"A2A authToken must not be empty.\");\n\tconst expectedDigest = digest(authToken);\n\tconst taskStore = new InMemoryTaskStore();\n\tconst agentExecutor = new HarnessAgentExecutor(options.runnerFactory);\n\tconst app = express();\n\tlet requestHandler: DefaultRequestHandler | undefined;\n\tlet routesMounted = false;\n\tlet server: ReturnType<Express[\"listen\"]> | undefined;\n\tlet bound: A2aListenAddress | undefined;\n\tlet allowedHosts = new Set<string>();\n\n\tfunction computeAllowedHosts(info: A2aListenAddress): Set<string> {\n\t\tconst hosts = new Set<string>();\n\t\tconst port = info.port;\n\t\tconst boundHost = info.host.includes(\":\") ? `[${info.host}]` : info.host;\n\t\thosts.add(`${boundHost}:${port}`.toLowerCase());\n\t\tif (isLoopbackHost(info.host) || info.host === \"0.0.0.0\" || info.host === \"::\") {\n\t\t\tfor (const name of LOOPBACK_NAMES) hosts.add(`${name}:${port}`);\n\t\t}\n\t\thosts.add(urlHost(info.url));\n\t\tif (options.baseUrl) hosts.add(urlHost(options.baseUrl));\n\t\tif (options.publicHost) hosts.add(urlHost(formatA2aHttpUrl(options.publicHost, port)));\n\t\treturn hosts;\n\t}\n\n\tapp.use((req: Request, res: Response, next: NextFunction) => {\n\t\tconst host = req.headers.host?.toLowerCase();\n\t\tif (!bound || !host || !allowedHosts.has(host)) {\n\t\t\tres.status(403).json({ error: \"Forbidden host\" });\n\t\t\treturn;\n\t\t}\n\t\tconst token = bearerToken(req.headers.authorization);\n\t\tif (!token || !timingSafeEqual(digest(token), expectedDigest)) {\n\t\t\tres.setHeader(\"WWW-Authenticate\", 'Bearer realm=\"a2a\"');\n\t\t\tres.status(401).json({ error: \"Unauthorized\" });\n\t\t\treturn;\n\t\t}\n\t\tnext();\n\t});\n\n\tfunction mount(baseUrl: string): void {\n\t\tif (routesMounted) return;\n\t\tconst agentCard = createPunchAgentCard({\n\t\t\tbaseUrl,\n\t\t\tname: options.name,\n\t\t\tdescription: options.description,\n\t\t});\n\t\trequestHandler = new DefaultRequestHandler(agentCard, taskStore, agentExecutor);\n\t\tapp.use(`/${AGENT_CARD_PATH}`, agentCardHandler({ agentCardProvider: requestHandler }));\n\t\t// Authentication is enforced by the bearer-token middleware above.\n\t\tapp.use(jsonRpcHandler({ requestHandler, userBuilder: UserBuilder.noAuthentication }));\n\t\troutesMounted = true;\n\t}\n\n\tif (options.baseUrl) mount(options.baseUrl);\n\n\treturn {\n\t\tapp,\n\t\tget requestHandler() {\n\t\t\treturn requestHandler;\n\t\t},\n\t\tauthToken,\n\t\tlisten(port = 0, host = \"127.0.0.1\") {\n\t\t\treturn new Promise((resolve, reject) => {\n\t\t\t\tserver = app.listen(port, host, (error?: Error) => {\n\t\t\t\t\tif (error) {\n\t\t\t\t\t\treject(error);\n\t\t\t\t\t\treturn;\n\t\t\t\t\t}\n\t\t\t\t\tconst addr = server?.address();\n\t\t\t\t\tif (!addr || typeof addr === \"string\") {\n\t\t\t\t\t\treject(new Error(\"A2A server bound without a TCP address\"));\n\t\t\t\t\t\treturn;\n\t\t\t\t\t}\n\t\t\t\t\tconst info = addr as AddressInfo;\n\t\t\t\t\tconst url = options.baseUrl ?? formatA2aHttpUrl(options.publicHost ?? info.address, info.port);\n\t\t\t\t\tconst next = { host: info.address, port: info.port, url };\n\t\t\t\t\ttry {\n\t\t\t\t\t\tallowedHosts = computeAllowedHosts(next);\n\t\t\t\t\t\tmount(url);\n\t\t\t\t\t} catch (err) {\n\t\t\t\t\t\treject(err);\n\t\t\t\t\t\treturn;\n\t\t\t\t\t}\n\t\t\t\t\tbound = next;\n\t\t\t\t\tresolve(bound);\n\t\t\t\t});\n\t\t\t});\n\t\t},\n\t\taddress() {\n\t\t\treturn bound;\n\t\t},\n\t\tunref() {\n\t\t\tserver?.unref();\n\t\t},\n\t\tclose() {\n\t\t\treturn new Promise((resolve, reject) => {\n\t\t\t\tif (!server) {\n\t\t\t\t\tbound = undefined;\n\t\t\t\t\tresolve();\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tserver.close((error) => {\n\t\t\t\t\tif (error) reject(error);\n\t\t\t\t\telse {\n\t\t\t\t\t\tbound = undefined;\n\t\t\t\t\t\tresolve();\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t});\n\t\t},\n\t};\n}\n"]}
|