@punch-bot/a2a 1.4.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 CHANGED
@@ -2,6 +2,18 @@
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
+
5
17
  ## [1.4.0] - 2026-10-21
6
18
 
7
19
  ## [1.3.0] - 2026-10-17
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
@@ -2,6 +2,8 @@ export interface DelegateToA2aAgentOptions {
2
2
  url: string;
3
3
  task: string;
4
4
  signal?: AbortSignal;
5
+ /** Bearer token sent as `Authorization` on every request to the agent. */
6
+ token?: string;
5
7
  }
6
8
  export interface DelegateToA2aAgentResult {
7
9
  text: string;
@@ -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;CACrB;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;AA6MD,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"}
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
- async function createA2aClient(url) {
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);
@@ -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"]}
@@ -4,6 +4,8 @@ export interface A2aPeerRecord {
4
4
  url: string;
5
5
  pid: number;
6
6
  cwd?: string;
7
+ /** Bearer token for the peer's A2A listener. Only stored in the 0600 record file. */
8
+ token?: string;
7
9
  startedAt: number;
8
10
  updatedAt: number;
9
11
  }
@@ -1 +1 @@
1
- {"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAIA,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,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;AAyDD,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,CAwCtD;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"}
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
- mkdirSync(path.dirname(file), { recursive: true, mode: 0o700 });
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
- mkdirSync(this.dir, { recursive: true, mode: 0o700 });
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 {
@@ -1 +1 @@
1
- {"version":3,"file":"discovery.js","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACtG,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAkBlC,MAAM,cAAc,GAAG,MAAM,CAAC;AAC9B,MAAM,UAAU,GAAG,mBAAmB,CAAC;AAEvC,MAAM,UAAU,sBAAsB,CAAC,GAAG,GAAsB,OAAO,CAAC,GAAG;IAC1E,MAAM,UAAU,GAAG,GAAG,CAAC,uBAAuB,CAAC;IAC/C,IAAI,UAAU,EAAE,IAAI,EAAE;QAAE,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACxD,MAAM,UAAU,GAAG,GAAG,CAAC,eAAe,CAAC;IACvC,IAAI,UAAU,EAAE,IAAI,EAAE;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IACrE,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,aAAa,UAAU,EAAE,EAAE,CAAC,CAAC;AACzD,CAAC;AAED,SAAS,UAAU;IAClB,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK,UAAU;QAAE,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC;IAClE,OAAO,MAAM,CAAC;AACf,CAAC;AAED,SAAS,SAAS,CAAC,KAAa;IAC/B,IAAI,CAAC;QACJ,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3B,OAAO,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,KAAK,CAAC;IACd,CAAC;AACF,CAAC;AAED,SAAS,WAAW,CAAC,GAAY;IAChC,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACtD,MAAM,KAAK,GAAG,GAA8B,CAAC;IAC7C,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAAE,OAAO,SAAS,CAAC;IACjF,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACvF,IAAI,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAC7E,IAAI,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACtG,IAAI,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/F,IAAI,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/F,MAAM,GAAG,GAAG,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1F,OAAO;QACN,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE;QACvB,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;KAC1B,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,KAAc;IAChD,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAChE,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC;IACvD,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACpE,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AACvB,CAAC;AAED,SAAS,WAAW,CAAC,IAAY;IAChC,IAAI,CAAC;QACJ,UAAU,CAAC,IAAI,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,GAAG,CAAC;IACjE,CAAC;AACF,CAAC;AAED,SAAS,SAAS,CAAC,GAAW,EAAE,EAAU;IACzC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAClE,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,OAAO,iBAAiB;IACpB,GAAG,CAAS;IACJ,KAAK,CAAS;IACd,GAAG,CAAe;IAC3B,MAAM,CAA4B;IAClC,QAAQ,CAAqB;IAErC,YAAY,OAAiC;QAC5C,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,cAAc,CAAC;QAC7C,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IACpC,CAAC;IAED,SAAS,CAAC,KAAuC;QAChD,MAAM,MAAM,GAAkB,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QAC3F,IAAI,CAAC,MAAM,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAChE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QACtF,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QAC/C,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACnC,OAAO,MAAM,CAAC;IACf,CAAC;IAED,SAAS;QACR,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAS,CAAC;QACrD,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QACxD,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC,MAAM,CAAC;IACpB,CAAC;IAED,IAAI,CAAC,OAAgC;QACpC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACtD,IAAI,OAAiB,CAAC;QACtB,IAAI,CAAC;YACJ,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,EAAE,CAAC;YAChE,MAAM,GAAG,CAAC;QACX,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;QACxD,MAAM,KAAK,GAAoB,EAAE,CAAC;QAClC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAAE,SAAS;YACvC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACxC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,GAAG;gBAAE,SAAS;YAC9C,IAAI,MAAe,CAAC;YACpB,IAAI,CAAC;gBACJ,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;YACjD,CAAC;YAAC,MAAM,CAAC;gBACR,SAAS;YACV,CAAC;YACD,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;YACnC,IAAI,CAAC,MAAM;gBAAE,SAAS;YACtB,IAAI,SAAS,IAAI,MAAM,CAAC,EAAE,KAAK,SAAS;gBAAE,SAAS;YACnD,IAAI,GAAG,GAAG,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC1C,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACnB,SAAS;YACV,CAAC;YACD,IAAI,MAAM,GAAG,MAAM,CAAC;YACpB,IAAI,CAAC;gBACJ,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC;YACxE,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;YACV,IAAI,GAAG,GAAG,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;gBACzC,IAAI,CAAC;oBACJ,WAAW,CAAC,IAAI,CAAC,CAAC;gBACnB,CAAC;gBAAC,MAAM,CAAC,CAAA,CAAC;YACX,CAAC;QACF,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACvF,CAAC;IAED,IAAI,CAAC,IAAY,EAAE,OAAgC;QAClD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC1C,IAAI,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,OAAO,CAAC,CAAC;QACzF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAC3C,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK;QACJ,IAAI,IAAI,CAAC,QAAQ;YAAE,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;IACzB,CAAC;CACD","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;
@@ -1 +1 @@
1
- {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAqB,MAAM,oBAAoB,CAAC;AAE9E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAGvC,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;CACrB;AAED,MAAM,WAAW,SAAS;IACzB,GAAG,EAAE,OAAO,CAAC;IACb,cAAc,EAAE,qBAAqB,GAAG,SAAS,CAAC;IAClD,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;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,SAAS,CAAC,CA6EzF"}
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
- bound = { host: info.address, port: info.port, url };
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
  });
@@ -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"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@punch-bot/a2a",
3
- "version": "1.4.0",
3
+ "version": "1.5.0",
4
4
  "description": "Agent2Agent (A2A) protocol integration for punch agents",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",