@punch-bot/a2a 0.85.1 → 1.3.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 +5 -0
- package/README.md +24 -0
- package/dist/agent-card.d.ts.map +1 -1
- package/dist/agent-card.js.map +1 -1
- package/dist/client.d.ts.map +1 -1
- package/dist/client.js.map +1 -1
- package/dist/discovery.d.ts +33 -0
- package/dist/discovery.d.ts.map +1 -0
- package/dist/discovery.js +171 -0
- package/dist/discovery.js.map +1 -0
- package/dist/executor.d.ts.map +1 -1
- package/dist/executor.js.map +1 -1
- package/dist/http-url.d.ts +2 -0
- package/dist/http-url.d.ts.map +1 -0
- package/dist/http-url.js +12 -0
- package/dist/http-url.js.map +1 -0
- package/dist/index.d.ts +3 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +3 -1
- package/dist/index.js.map +1 -1
- package/dist/message.d.ts.map +1 -1
- package/dist/message.js.map +1 -1
- package/dist/server.d.ts +11 -3
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +52 -14
- package/dist/server.js.map +1 -1
- package/package.json +4 -4
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,11 @@
|
|
|
2
2
|
|
|
3
3
|
## [Unreleased]
|
|
4
4
|
|
|
5
|
+
## [1.3.0] - 2026-10-17
|
|
6
|
+
|
|
7
|
+
## [1.2.0] - 2026-10-12
|
|
8
|
+
|
|
5
9
|
### Added
|
|
6
10
|
|
|
7
11
|
- Initial `@punch-bot/a2a` package with A2A server, client, and harness executor bridge.
|
|
12
|
+
- Added `LocalA2aDiscovery` for same-machine A2A peer advertisements, including TTL-based stale lease cleanup.
|
package/README.md
CHANGED
|
@@ -7,6 +7,7 @@ This package wraps the official [`@a2a-js/sdk`](https://www.npmjs.com/package/@a
|
|
|
7
7
|
- exposing a punch agent as an A2A server
|
|
8
8
|
- delegating tasks to external A2A agents (for example Hermes)
|
|
9
9
|
- bridging `AgentHarness` prompt execution to A2A task lifecycle events
|
|
10
|
+
- discovering other punch A2A servers on the same machine
|
|
10
11
|
|
|
11
12
|
## Server
|
|
12
13
|
|
|
@@ -25,6 +26,29 @@ const server = await createA2aServer({
|
|
|
25
26
|
await server.listen(41241);
|
|
26
27
|
```
|
|
27
28
|
|
|
29
|
+
`listen()` can take port `0` to bind an ephemeral port. The returned address includes the bound `host`, `port`, and card `url`.
|
|
30
|
+
|
|
31
|
+
## Same-machine discovery
|
|
32
|
+
|
|
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.
|
|
34
|
+
|
|
35
|
+
```ts
|
|
36
|
+
import { LocalA2aDiscovery, defaultA2aDiscoveryDir } from "@punch-bot/a2a";
|
|
37
|
+
|
|
38
|
+
const discovery = new LocalA2aDiscovery({ dir: defaultA2aDiscoveryDir() });
|
|
39
|
+
discovery.advertise({
|
|
40
|
+
id: "alice",
|
|
41
|
+
name: "alice",
|
|
42
|
+
url: "http://127.0.0.1:41241/",
|
|
43
|
+
pid: process.pid,
|
|
44
|
+
startedAt: Date.now(),
|
|
45
|
+
});
|
|
46
|
+
|
|
47
|
+
const bob = discovery.find("bob");
|
|
48
|
+
```
|
|
49
|
+
|
|
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.
|
|
51
|
+
|
|
28
52
|
## Client
|
|
29
53
|
|
|
30
54
|
```ts
|
package/dist/agent-card.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"agent-card.d.ts","sourceRoot":"","sources":["../src/agent-card.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAEpF,MAAM,WAAW,2BAA2B;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;CAC/B;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,GAAG,SAAS,CA+CpF"
|
|
1
|
+
{"version":3,"file":"agent-card.d.ts","sourceRoot":"","sources":["../src/agent-card.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAEpF,MAAM,WAAW,2BAA2B;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;CAC/B;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,GAAG,SAAS,CA+CpF"}
|
package/dist/agent-card.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"agent-card.js","sourceRoot":"","sources":["../src/agent-card.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAmC,MAAM,aAAa,CAAC;AAUpF,MAAM,UAAU,oBAAoB,CAAC,OAAoC
|
|
1
|
+
{"version":3,"file":"agent-card.js","sourceRoot":"","sources":["../src/agent-card.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAmC,MAAM,aAAa,CAAC;AAUpF,MAAM,UAAU,oBAAoB,CAAC,OAAoC;IACxE,MAAM,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,GAAG,CAAC;IAClG,MAAM,MAAM,GAAiB,OAAO,CAAC,MAAM;QAC1C,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;QACrB,CAAC,CAAC;YACA;gBACC,EAAE,EAAE,cAAc;gBAClB,IAAI,EAAE,cAAc;gBACpB,WAAW,EAAE,sEAAsE;gBACnF,IAAI,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC;gBACzB,QAAQ,EAAE,CAAC,yCAAyC,EAAE,2BAA2B,CAAC;gBAClF,UAAU,EAAE,CAAC,MAAM,CAAC;gBACpB,WAAW,EAAE,CAAC,MAAM,CAAC;gBACrB,oBAAoB,EAAE,EAAE;aACxB;SACD,CAAC;IAEJ,OAAO;QACN,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,aAAa;QACnC,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,6DAA6D;QACjG,mBAAmB,EAAE;YACpB;gBACC,GAAG,EAAE,iBAAiB;gBACtB,eAAe,EAAE,SAAS;gBAC1B,MAAM,EAAE,EAAE;gBACV,eAAe,EAAE,oBAAoB;aACrC;SACD;QACD,QAAQ,EAAE;YACT,YAAY,EAAE,OAAO;YACrB,GAAG,EAAE,mCAAmC;SACxC;QACD,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,OAAO;QACnC,YAAY,EAAE;YACb,SAAS,EAAE,IAAI;YACf,iBAAiB,EAAE,KAAK;YACxB,UAAU,EAAE,EAAE;YACd,iBAAiB,EAAE,KAAK;SACxB;QACD,eAAe,EAAE,EAAE;QACnB,oBAAoB,EAAE,EAAE;QACxB,iBAAiB,EAAE,CAAC,MAAM,CAAC;QAC3B,kBAAkB,EAAE,CAAC,MAAM,CAAC;QAC5B,MAAM;QACN,gBAAgB,EAAE,mCAAmC;QACrD,UAAU,EAAE,EAAE;KACd,CAAC;AACH,CAAC","sourcesContent":["import { A2A_PROTOCOL_VERSION, type AgentCard, type AgentSkill } from \"@a2a-js/sdk\";\n\nexport interface CreatePunchAgentCardOptions {\n\tbaseUrl: string;\n\tname?: string;\n\tdescription?: string;\n\tversion?: string;\n\tskills?: readonly AgentSkill[];\n}\n\nexport function createPunchAgentCard(options: CreatePunchAgentCardOptions): AgentCard {\n\tconst normalizedBaseUrl = options.baseUrl.endsWith(\"/\") ? options.baseUrl : `${options.baseUrl}/`;\n\tconst skills: AgentSkill[] = options.skills\n\t\t? [...options.skills]\n\t\t: [\n\t\t\t\t{\n\t\t\t\t\tid: \"coding_agent\",\n\t\t\t\t\tname: \"Coding Agent\",\n\t\t\t\t\tdescription: \"General-purpose coding agent with read, bash, edit, and write tools.\",\n\t\t\t\t\ttags: [\"coding\", \"agent\"],\n\t\t\t\t\texamples: [\"Fix the failing test in src/foo.test.ts\", \"Summarize this repository\"],\n\t\t\t\t\tinputModes: [\"text\"],\n\t\t\t\t\toutputModes: [\"text\"],\n\t\t\t\t\tsecurityRequirements: [],\n\t\t\t\t},\n\t\t\t];\n\n\treturn {\n\t\tname: options.name ?? \"Punch Agent\",\n\t\tdescription: options.description ?? \"A punch coding agent exposed over the Agent2Agent protocol.\",\n\t\tsupportedInterfaces: [\n\t\t\t{\n\t\t\t\turl: normalizedBaseUrl,\n\t\t\t\tprotocolBinding: \"JSONRPC\",\n\t\t\t\ttenant: \"\",\n\t\t\t\tprotocolVersion: A2A_PROTOCOL_VERSION,\n\t\t\t},\n\t\t],\n\t\tprovider: {\n\t\t\torganization: \"Punch\",\n\t\t\turl: \"https://github.com/punch-bot/core\",\n\t\t},\n\t\tversion: options.version ?? \"1.0.0\",\n\t\tcapabilities: {\n\t\t\tstreaming: true,\n\t\t\tpushNotifications: false,\n\t\t\textensions: [],\n\t\t\textendedAgentCard: false,\n\t\t},\n\t\tsecuritySchemes: {},\n\t\tsecurityRequirements: [],\n\t\tdefaultInputModes: [\"text\"],\n\t\tdefaultOutputModes: [\"text\"],\n\t\tskills,\n\t\tdocumentationUrl: \"https://github.com/punch-bot/core\",\n\t\tsignatures: [],\n\t};\n}\n"]}
|
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;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;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"}
|
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, 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"]}
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
export interface A2aPeerRecord {
|
|
2
|
+
id: string;
|
|
3
|
+
name: string;
|
|
4
|
+
url: string;
|
|
5
|
+
pid: number;
|
|
6
|
+
cwd?: string;
|
|
7
|
+
startedAt: number;
|
|
8
|
+
updatedAt: number;
|
|
9
|
+
}
|
|
10
|
+
export interface LocalA2aDiscoveryOptions {
|
|
11
|
+
dir: string;
|
|
12
|
+
ttlMs?: number;
|
|
13
|
+
now?: () => number;
|
|
14
|
+
}
|
|
15
|
+
export declare function defaultA2aDiscoveryDir(env?: NodeJS.ProcessEnv): string;
|
|
16
|
+
export declare class LocalA2aDiscovery {
|
|
17
|
+
readonly dir: string;
|
|
18
|
+
private readonly ttlMs;
|
|
19
|
+
private readonly now;
|
|
20
|
+
private record;
|
|
21
|
+
private filePath;
|
|
22
|
+
constructor(options: LocalA2aDiscoveryOptions);
|
|
23
|
+
advertise(input: Omit<A2aPeerRecord, "updatedAt">): A2aPeerRecord;
|
|
24
|
+
heartbeat(): A2aPeerRecord | undefined;
|
|
25
|
+
list(options?: {
|
|
26
|
+
excludeId?: string;
|
|
27
|
+
}): A2aPeerRecord[];
|
|
28
|
+
find(name: string, options?: {
|
|
29
|
+
excludeId?: string;
|
|
30
|
+
}): A2aPeerRecord | undefined;
|
|
31
|
+
close(): void;
|
|
32
|
+
}
|
|
33
|
+
//# sourceMappingURL=discovery.d.ts.map
|
|
@@ -0,0 +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"}
|
|
@@ -0,0 +1,171 @@
|
|
|
1
|
+
import { mkdirSync, readdirSync, readFileSync, renameSync, unlinkSync, writeFileSync } from "node:fs";
|
|
2
|
+
import { tmpdir } from "node:os";
|
|
3
|
+
import * as path from "node:path";
|
|
4
|
+
const DEFAULT_TTL_MS = 45_000;
|
|
5
|
+
const ID_PATTERN = /^[A-Za-z0-9._-]+$/;
|
|
6
|
+
export function defaultA2aDiscoveryDir(env = process.env) {
|
|
7
|
+
const configured = env.PUNCH_A2A_DISCOVERY_DIR;
|
|
8
|
+
if (configured?.trim())
|
|
9
|
+
return path.resolve(configured);
|
|
10
|
+
const runtimeDir = env.XDG_RUNTIME_DIR;
|
|
11
|
+
if (runtimeDir?.trim())
|
|
12
|
+
return path.join(runtimeDir, "punch", "a2a");
|
|
13
|
+
return path.join(tmpdir(), `punch-a2a-${currentUid()}`);
|
|
14
|
+
}
|
|
15
|
+
function currentUid() {
|
|
16
|
+
if (typeof process.getuid === "function")
|
|
17
|
+
return process.getuid();
|
|
18
|
+
return "user";
|
|
19
|
+
}
|
|
20
|
+
function isHttpUrl(value) {
|
|
21
|
+
try {
|
|
22
|
+
const url = new URL(value);
|
|
23
|
+
return url.protocol === "http:" || url.protocol === "https:";
|
|
24
|
+
}
|
|
25
|
+
catch {
|
|
26
|
+
return false;
|
|
27
|
+
}
|
|
28
|
+
}
|
|
29
|
+
function parseRecord(raw) {
|
|
30
|
+
if (!raw || typeof raw !== "object")
|
|
31
|
+
return undefined;
|
|
32
|
+
const value = raw;
|
|
33
|
+
if (typeof value.id !== "string" || !ID_PATTERN.test(value.id))
|
|
34
|
+
return undefined;
|
|
35
|
+
if (typeof value.name !== "string" || value.name.trim().length === 0)
|
|
36
|
+
return undefined;
|
|
37
|
+
if (typeof value.url !== "string" || !isHttpUrl(value.url))
|
|
38
|
+
return undefined;
|
|
39
|
+
if (typeof value.pid !== "number" || !Number.isInteger(value.pid) || value.pid <= 0)
|
|
40
|
+
return undefined;
|
|
41
|
+
if (typeof value.startedAt !== "number" || !Number.isFinite(value.startedAt))
|
|
42
|
+
return undefined;
|
|
43
|
+
if (typeof value.updatedAt !== "number" || !Number.isFinite(value.updatedAt))
|
|
44
|
+
return undefined;
|
|
45
|
+
const cwd = typeof value.cwd === "string" && value.cwd.length > 0 ? value.cwd : undefined;
|
|
46
|
+
return {
|
|
47
|
+
id: value.id,
|
|
48
|
+
name: value.name.trim(),
|
|
49
|
+
url: value.url,
|
|
50
|
+
pid: value.pid,
|
|
51
|
+
...(cwd ? { cwd } : {}),
|
|
52
|
+
startedAt: value.startedAt,
|
|
53
|
+
updatedAt: value.updatedAt,
|
|
54
|
+
};
|
|
55
|
+
}
|
|
56
|
+
function atomicWrite(file, value) {
|
|
57
|
+
mkdirSync(path.dirname(file), { recursive: true, mode: 0o700 });
|
|
58
|
+
const tmp = `${file}.${process.pid}.${Date.now()}.tmp`;
|
|
59
|
+
writeFileSync(tmp, JSON.stringify(value, null, 2), { mode: 0o600 });
|
|
60
|
+
renameSync(tmp, file);
|
|
61
|
+
}
|
|
62
|
+
function unlinkQuiet(file) {
|
|
63
|
+
try {
|
|
64
|
+
unlinkSync(file);
|
|
65
|
+
}
|
|
66
|
+
catch (err) {
|
|
67
|
+
if (err.code !== "ENOENT")
|
|
68
|
+
throw err;
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
function leasePath(dir, id) {
|
|
72
|
+
if (!ID_PATTERN.test(id))
|
|
73
|
+
throw new Error("Invalid A2A peer id.");
|
|
74
|
+
return path.join(dir, `${id}.json`);
|
|
75
|
+
}
|
|
76
|
+
export class LocalA2aDiscovery {
|
|
77
|
+
dir;
|
|
78
|
+
ttlMs;
|
|
79
|
+
now;
|
|
80
|
+
record;
|
|
81
|
+
filePath;
|
|
82
|
+
constructor(options) {
|
|
83
|
+
this.dir = path.resolve(options.dir);
|
|
84
|
+
this.ttlMs = options.ttlMs ?? DEFAULT_TTL_MS;
|
|
85
|
+
this.now = options.now ?? Date.now;
|
|
86
|
+
}
|
|
87
|
+
advertise(input) {
|
|
88
|
+
const record = { ...input, name: input.name.trim(), updatedAt: this.now() };
|
|
89
|
+
if (!record.name)
|
|
90
|
+
throw new Error("A2A peer name is required.");
|
|
91
|
+
if (!isHttpUrl(record.url))
|
|
92
|
+
throw new Error("A2A peer URL must be absolute http(s).");
|
|
93
|
+
this.record = record;
|
|
94
|
+
this.filePath = leasePath(this.dir, record.id);
|
|
95
|
+
atomicWrite(this.filePath, record);
|
|
96
|
+
return record;
|
|
97
|
+
}
|
|
98
|
+
heartbeat() {
|
|
99
|
+
if (!this.record || !this.filePath)
|
|
100
|
+
return undefined;
|
|
101
|
+
this.record = { ...this.record, updatedAt: this.now() };
|
|
102
|
+
atomicWrite(this.filePath, this.record);
|
|
103
|
+
return this.record;
|
|
104
|
+
}
|
|
105
|
+
list(options) {
|
|
106
|
+
mkdirSync(this.dir, { recursive: true, mode: 0o700 });
|
|
107
|
+
let entries;
|
|
108
|
+
try {
|
|
109
|
+
entries = readdirSync(this.dir);
|
|
110
|
+
}
|
|
111
|
+
catch (err) {
|
|
112
|
+
if (err.code === "ENOENT")
|
|
113
|
+
return [];
|
|
114
|
+
throw err;
|
|
115
|
+
}
|
|
116
|
+
const now = this.now();
|
|
117
|
+
const excludeId = options?.excludeId ?? this.record?.id;
|
|
118
|
+
const peers = [];
|
|
119
|
+
for (const entry of entries) {
|
|
120
|
+
if (!entry.endsWith(".json"))
|
|
121
|
+
continue;
|
|
122
|
+
const file = path.join(this.dir, entry);
|
|
123
|
+
if (path.dirname(file) !== this.dir)
|
|
124
|
+
continue;
|
|
125
|
+
let parsed;
|
|
126
|
+
try {
|
|
127
|
+
parsed = JSON.parse(readFileSync(file, "utf8"));
|
|
128
|
+
}
|
|
129
|
+
catch {
|
|
130
|
+
continue;
|
|
131
|
+
}
|
|
132
|
+
const record = parseRecord(parsed);
|
|
133
|
+
if (!record)
|
|
134
|
+
continue;
|
|
135
|
+
if (excludeId && record.id === excludeId)
|
|
136
|
+
continue;
|
|
137
|
+
if (now - record.updatedAt <= this.ttlMs) {
|
|
138
|
+
peers.push(record);
|
|
139
|
+
continue;
|
|
140
|
+
}
|
|
141
|
+
let latest = record;
|
|
142
|
+
try {
|
|
143
|
+
latest = parseRecord(JSON.parse(readFileSync(file, "utf8"))) ?? record;
|
|
144
|
+
}
|
|
145
|
+
catch { }
|
|
146
|
+
if (now - latest.updatedAt > this.ttlMs) {
|
|
147
|
+
try {
|
|
148
|
+
unlinkQuiet(file);
|
|
149
|
+
}
|
|
150
|
+
catch { }
|
|
151
|
+
}
|
|
152
|
+
}
|
|
153
|
+
return peers.sort((a, b) => a.name.localeCompare(b.name) || a.id.localeCompare(b.id));
|
|
154
|
+
}
|
|
155
|
+
find(name, options) {
|
|
156
|
+
const lowered = name.trim().toLowerCase();
|
|
157
|
+
if (!lowered)
|
|
158
|
+
return undefined;
|
|
159
|
+
const matches = this.list(options).filter((peer) => peer.name.toLowerCase() === lowered);
|
|
160
|
+
if (matches.length === 0)
|
|
161
|
+
return undefined;
|
|
162
|
+
return matches.sort((a, b) => b.updatedAt - a.updatedAt)[0];
|
|
163
|
+
}
|
|
164
|
+
close() {
|
|
165
|
+
if (this.filePath)
|
|
166
|
+
unlinkQuiet(this.filePath);
|
|
167
|
+
this.filePath = undefined;
|
|
168
|
+
this.record = undefined;
|
|
169
|
+
}
|
|
170
|
+
}
|
|
171
|
+
//# sourceMappingURL=discovery.js.map
|
|
@@ -0,0 +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"]}
|
package/dist/executor.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,KAAK,aAAa,EAAE,KAAK,iBAAiB,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGjH,MAAM,WAAW,mBAAmB;IACnC,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,kBAAkB;IAClC,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,oBAAoB,GAAG,mBAAmB,GAAG,kBAAkB,CAAC;AAE5E,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,IAAI,kBAAkB,CAEjG;AAED,MAAM,WAAW,mBAAmB;IACnC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC1E,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,MAAM,0BAA0B,GAAG,CAAC,SAAS,EAAE,MAAM,KAAK,mBAAmB,CAAC;AAEpF,qBAAa,oBAAqB,YAAW,aAAa;IACzD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;IAC1D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;IACpD,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAsC;IAC3E,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAuC;IACrE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA6B;IAE3D,YAAY,aAAa,EAAE,0BAA0B,EAEpD;IAED,UAAU,
|
|
1
|
+
{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,KAAK,aAAa,EAAE,KAAK,iBAAiB,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGjH,MAAM,WAAW,mBAAmB;IACnC,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,kBAAkB;IAClC,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,oBAAoB,GAAG,mBAAmB,GAAG,kBAAkB,CAAC;AAE5E,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,IAAI,kBAAkB,CAEjG;AAED,MAAM,WAAW,mBAAmB;IACnC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC1E,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,MAAM,0BAA0B,GAAG,CAAC,SAAS,EAAE,MAAM,KAAK,mBAAmB,CAAC;AAEpF,qBAAa,oBAAqB,YAAW,aAAa;IACzD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;IAC1D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;IACpD,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAsC;IAC3E,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAuC;IACrE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA6B;IAE3D,YAAY,aAAa,EAAE,0BAA0B,EAEpD;IAED,UAAU,WAAkB,MAAM,YAAY,iBAAiB,KAAG,OAAO,CAAC,IAAI,CAAC,CAgB7E;IAEF,OAAO,CAAC,YAAY;IAWd,OAAO,CAAC,cAAc,EAAE,cAAc,EAAE,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoHxF;CACD"}
|
package/dist/executor.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"executor.js","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"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","sourcesContent":["import { TaskState } from \"@a2a-js/sdk\";\nimport { AgentEvent, type AgentExecutor, type ExecutionEventBus, type RequestContext } from \"@a2a-js/sdk/server\";\nimport { createTextMessage, extractTextFromMessage } from \"./message.ts\";\n\nexport interface HarnessPromptResult {\n\ttext: string;\n}\n\nexport interface HarnessPromptError {\n\tmessage: string;\n}\n\nexport type HarnessPromptOutcome = HarnessPromptResult | HarnessPromptError;\n\nexport function isHarnessPromptError(outcome: HarnessPromptOutcome): outcome is HarnessPromptError {\n\treturn \"message\" in outcome;\n}\n\nexport interface HarnessPromptRunner {\n\tprompt(text: string, signal?: AbortSignal): Promise<HarnessPromptOutcome>;\n\tabort?(): Promise<void>;\n}\n\nexport type HarnessPromptRunnerFactory = (contextId: string) => HarnessPromptRunner;\n\nexport class HarnessAgentExecutor implements AgentExecutor {\n\tprivate readonly taskContexts = new Map<string, string>();\n\tprivate readonly cancelledTasks = new Set<string>();\n\tprivate readonly taskAbortControllers = new Map<string, AbortController>();\n\tprivate readonly contextChains = new Map<string, Promise<unknown>>();\n\tprivate readonly runnerFactory: HarnessPromptRunnerFactory;\n\n\tconstructor(runnerFactory: HarnessPromptRunnerFactory) {\n\t\tthis.runnerFactory = runnerFactory;\n\t}\n\n\tcancelTask = async (taskId: string, eventBus: ExecutionEventBus): Promise<void> => {\n\t\tthis.cancelledTasks.add(taskId);\n\t\tthis.taskAbortControllers.get(taskId)?.abort();\n\t\tconst contextId = this.taskContexts.get(taskId);\n\t\teventBus.publish(\n\t\t\tAgentEvent.statusUpdate({\n\t\t\t\ttaskId,\n\t\t\t\tcontextId: contextId ?? taskId,\n\t\t\t\tstatus: {\n\t\t\t\t\tstate: TaskState.TASK_STATE_CANCELED,\n\t\t\t\t\ttimestamp: new Date().toISOString(),\n\t\t\t\t\tmessage: undefined,\n\t\t\t\t},\n\t\t\t\tmetadata: {},\n\t\t\t}),\n\t\t);\n\t};\n\n\tprivate runInContext<T>(contextId: string, fn: () => Promise<T>): Promise<T> {\n\t\tconst previous = this.contextChains.get(contextId) ?? Promise.resolve();\n\t\tconst current = previous.catch(() => undefined).then(() => fn());\n\t\tthis.contextChains.set(contextId, current);\n\t\treturn current.finally(() => {\n\t\t\tif (this.contextChains.get(contextId) === current) {\n\t\t\t\tthis.contextChains.delete(contextId);\n\t\t\t}\n\t\t});\n\t}\n\n\tasync execute(requestContext: RequestContext, eventBus: ExecutionEventBus): Promise<void> {\n\t\tconst taskId = requestContext.taskId;\n\t\tconst contextId = requestContext.contextId;\n\t\tconst userMessage = requestContext.userMessage;\n\t\tconst existingTask = requestContext.task;\n\t\tconst promptText = extractTextFromMessage(userMessage);\n\n\t\tawait this.runInContext(contextId, async () => {\n\t\t\tconst abortController = new AbortController();\n\t\t\tthis.taskAbortControllers.set(taskId, abortController);\n\n\t\t\tlet runner: HarnessPromptRunner;\n\t\t\ttry {\n\t\t\t\trunner = this.runnerFactory(contextId);\n\t\t\t\tthis.taskContexts.set(taskId, contextId);\n\t\t\t} catch (error) {\n\t\t\t\tthis.taskAbortControllers.delete(taskId);\n\t\t\t\tthrow error;\n\t\t\t}\n\n\t\t\ttry {\n\t\t\t\tconst taskSnapshot = existingTask ?? {\n\t\t\t\t\tid: taskId,\n\t\t\t\t\tcontextId,\n\t\t\t\t\tstatus: {\n\t\t\t\t\t\tstate: TaskState.TASK_STATE_SUBMITTED,\n\t\t\t\t\t\ttimestamp: new Date().toISOString(),\n\t\t\t\t\t\tmessage: undefined,\n\t\t\t\t\t},\n\t\t\t\t\tartifacts: [],\n\t\t\t\t\thistory: [userMessage],\n\t\t\t\t\tmetadata: userMessage.metadata,\n\t\t\t\t};\n\t\t\t\teventBus.publish(AgentEvent.task(taskSnapshot));\n\n\t\t\t\teventBus.publish(\n\t\t\t\t\tAgentEvent.statusUpdate({\n\t\t\t\t\t\ttaskId,\n\t\t\t\t\t\tcontextId,\n\t\t\t\t\t\tstatus: {\n\t\t\t\t\t\t\tstate: TaskState.TASK_STATE_WORKING,\n\t\t\t\t\t\t\ttimestamp: new Date().toISOString(),\n\t\t\t\t\t\t\tmessage: undefined,\n\t\t\t\t\t\t},\n\t\t\t\t\t\tmetadata: {},\n\t\t\t\t\t}),\n\t\t\t\t);\n\n\t\t\t\tif (this.cancelledTasks.has(taskId) || abortController.signal.aborted) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tconst outcome = await runner.prompt(promptText, abortController.signal);\n\t\t\t\tif (this.cancelledTasks.has(taskId) || abortController.signal.aborted) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tif (isHarnessPromptError(outcome)) {\n\t\t\t\t\teventBus.publish(\n\t\t\t\t\t\tAgentEvent.statusUpdate({\n\t\t\t\t\t\t\ttaskId,\n\t\t\t\t\t\t\tcontextId,\n\t\t\t\t\t\t\tstatus: {\n\t\t\t\t\t\t\t\tstate: TaskState.TASK_STATE_FAILED,\n\t\t\t\t\t\t\t\ttimestamp: new Date().toISOString(),\n\t\t\t\t\t\t\t\tmessage: createTextMessage(outcome.message, { role: \"agent\", taskId, contextId }),\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\tmetadata: { error: outcome.message },\n\t\t\t\t\t\t}),\n\t\t\t\t\t);\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\teventBus.publish(\n\t\t\t\t\tAgentEvent.artifactUpdate({\n\t\t\t\t\t\ttaskId,\n\t\t\t\t\t\tcontextId,\n\t\t\t\t\t\tartifact: {\n\t\t\t\t\t\t\tartifactId: crypto.randomUUID(),\n\t\t\t\t\t\t\tname: \"Result\",\n\t\t\t\t\t\t\tdescription: \"Agent response\",\n\t\t\t\t\t\t\tparts: [\n\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\tcontent: { $case: \"text\", value: outcome.text },\n\t\t\t\t\t\t\t\t\tmetadata: undefined,\n\t\t\t\t\t\t\t\t\tfilename: \"\",\n\t\t\t\t\t\t\t\t\tmediaType: \"text/plain\",\n\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t],\n\t\t\t\t\t\t\tmetadata: undefined,\n\t\t\t\t\t\t\textensions: [],\n\t\t\t\t\t\t},\n\t\t\t\t\t\tlastChunk: true,\n\t\t\t\t\t\tappend: false,\n\t\t\t\t\t\tmetadata: undefined,\n\t\t\t\t\t}),\n\t\t\t\t);\n\n\t\t\t\teventBus.publish(\n\t\t\t\t\tAgentEvent.statusUpdate({\n\t\t\t\t\t\ttaskId,\n\t\t\t\t\t\tcontextId,\n\t\t\t\t\t\tstatus: {\n\t\t\t\t\t\t\tstate: TaskState.TASK_STATE_COMPLETED,\n\t\t\t\t\t\t\ttimestamp: new Date().toISOString(),\n\t\t\t\t\t\t\tmessage: undefined,\n\t\t\t\t\t\t},\n\t\t\t\t\t\tmetadata: undefined,\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t} finally {\n\t\t\t\tthis.cancelledTasks.delete(taskId);\n\t\t\t\tthis.taskAbortControllers.delete(taskId);\n\t\t\t\tthis.taskContexts.delete(taskId);\n\t\t\t}\n\t\t});\n\t}\n}\n"]}
|
|
1
|
+
{"version":3,"file":"executor.js","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"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","sourcesContent":["import { TaskState } from \"@a2a-js/sdk\";\nimport { AgentEvent, type AgentExecutor, type ExecutionEventBus, type RequestContext } from \"@a2a-js/sdk/server\";\nimport { createTextMessage, extractTextFromMessage } from \"./message.ts\";\n\nexport interface HarnessPromptResult {\n\ttext: string;\n}\n\nexport interface HarnessPromptError {\n\tmessage: string;\n}\n\nexport type HarnessPromptOutcome = HarnessPromptResult | HarnessPromptError;\n\nexport function isHarnessPromptError(outcome: HarnessPromptOutcome): outcome is HarnessPromptError {\n\treturn \"message\" in outcome;\n}\n\nexport interface HarnessPromptRunner {\n\tprompt(text: string, signal?: AbortSignal): Promise<HarnessPromptOutcome>;\n\tabort?(): Promise<void>;\n}\n\nexport type HarnessPromptRunnerFactory = (contextId: string) => HarnessPromptRunner;\n\nexport class HarnessAgentExecutor implements AgentExecutor {\n\tprivate readonly taskContexts = new Map<string, string>();\n\tprivate readonly cancelledTasks = new Set<string>();\n\tprivate readonly taskAbortControllers = new Map<string, AbortController>();\n\tprivate readonly contextChains = new Map<string, Promise<unknown>>();\n\tprivate readonly runnerFactory: HarnessPromptRunnerFactory;\n\n\tconstructor(runnerFactory: HarnessPromptRunnerFactory) {\n\t\tthis.runnerFactory = runnerFactory;\n\t}\n\n\tcancelTask = async (taskId: string, eventBus: ExecutionEventBus): Promise<void> => {\n\t\tthis.cancelledTasks.add(taskId);\n\t\tthis.taskAbortControllers.get(taskId)?.abort();\n\t\tconst contextId = this.taskContexts.get(taskId);\n\t\teventBus.publish(\n\t\t\tAgentEvent.statusUpdate({\n\t\t\t\ttaskId,\n\t\t\t\tcontextId: contextId ?? taskId,\n\t\t\t\tstatus: {\n\t\t\t\t\tstate: TaskState.TASK_STATE_CANCELED,\n\t\t\t\t\ttimestamp: new Date().toISOString(),\n\t\t\t\t\tmessage: undefined,\n\t\t\t\t},\n\t\t\t\tmetadata: {},\n\t\t\t}),\n\t\t);\n\t};\n\n\tprivate runInContext<T>(contextId: string, fn: () => Promise<T>): Promise<T> {\n\t\tconst previous = this.contextChains.get(contextId) ?? Promise.resolve();\n\t\tconst current = previous.catch(() => undefined).then(() => fn());\n\t\tthis.contextChains.set(contextId, current);\n\t\treturn current.finally(() => {\n\t\t\tif (this.contextChains.get(contextId) === current) {\n\t\t\t\tthis.contextChains.delete(contextId);\n\t\t\t}\n\t\t});\n\t}\n\n\tasync execute(requestContext: RequestContext, eventBus: ExecutionEventBus): Promise<void> {\n\t\tconst taskId = requestContext.taskId;\n\t\tconst contextId = requestContext.contextId;\n\t\tconst userMessage = requestContext.userMessage;\n\t\tconst existingTask = requestContext.task;\n\t\tconst promptText = extractTextFromMessage(userMessage);\n\n\t\tawait this.runInContext(contextId, async () => {\n\t\t\tconst abortController = new AbortController();\n\t\t\tthis.taskAbortControllers.set(taskId, abortController);\n\n\t\t\tlet runner: HarnessPromptRunner;\n\t\t\ttry {\n\t\t\t\trunner = this.runnerFactory(contextId);\n\t\t\t\tthis.taskContexts.set(taskId, contextId);\n\t\t\t} catch (error) {\n\t\t\t\tthis.taskAbortControllers.delete(taskId);\n\t\t\t\tthrow error;\n\t\t\t}\n\n\t\t\ttry {\n\t\t\t\tconst taskSnapshot = existingTask ?? {\n\t\t\t\t\tid: taskId,\n\t\t\t\t\tcontextId,\n\t\t\t\t\tstatus: {\n\t\t\t\t\t\tstate: TaskState.TASK_STATE_SUBMITTED,\n\t\t\t\t\t\ttimestamp: new Date().toISOString(),\n\t\t\t\t\t\tmessage: undefined,\n\t\t\t\t\t},\n\t\t\t\t\tartifacts: [],\n\t\t\t\t\thistory: [userMessage],\n\t\t\t\t\tmetadata: userMessage.metadata,\n\t\t\t\t};\n\t\t\t\teventBus.publish(AgentEvent.task(taskSnapshot));\n\n\t\t\t\teventBus.publish(\n\t\t\t\t\tAgentEvent.statusUpdate({\n\t\t\t\t\t\ttaskId,\n\t\t\t\t\t\tcontextId,\n\t\t\t\t\t\tstatus: {\n\t\t\t\t\t\t\tstate: TaskState.TASK_STATE_WORKING,\n\t\t\t\t\t\t\ttimestamp: new Date().toISOString(),\n\t\t\t\t\t\t\tmessage: undefined,\n\t\t\t\t\t\t},\n\t\t\t\t\t\tmetadata: {},\n\t\t\t\t\t}),\n\t\t\t\t);\n\n\t\t\t\tif (this.cancelledTasks.has(taskId) || abortController.signal.aborted) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tconst outcome = await runner.prompt(promptText, abortController.signal);\n\t\t\t\tif (this.cancelledTasks.has(taskId) || abortController.signal.aborted) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tif (isHarnessPromptError(outcome)) {\n\t\t\t\t\teventBus.publish(\n\t\t\t\t\t\tAgentEvent.statusUpdate({\n\t\t\t\t\t\t\ttaskId,\n\t\t\t\t\t\t\tcontextId,\n\t\t\t\t\t\t\tstatus: {\n\t\t\t\t\t\t\t\tstate: TaskState.TASK_STATE_FAILED,\n\t\t\t\t\t\t\t\ttimestamp: new Date().toISOString(),\n\t\t\t\t\t\t\t\tmessage: createTextMessage(outcome.message, { role: \"agent\", taskId, contextId }),\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\tmetadata: { error: outcome.message },\n\t\t\t\t\t\t}),\n\t\t\t\t\t);\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\teventBus.publish(\n\t\t\t\t\tAgentEvent.artifactUpdate({\n\t\t\t\t\t\ttaskId,\n\t\t\t\t\t\tcontextId,\n\t\t\t\t\t\tartifact: {\n\t\t\t\t\t\t\tartifactId: crypto.randomUUID(),\n\t\t\t\t\t\t\tname: \"Result\",\n\t\t\t\t\t\t\tdescription: \"Agent response\",\n\t\t\t\t\t\t\tparts: [\n\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\tcontent: { $case: \"text\", value: outcome.text },\n\t\t\t\t\t\t\t\t\tmetadata: undefined,\n\t\t\t\t\t\t\t\t\tfilename: \"\",\n\t\t\t\t\t\t\t\t\tmediaType: \"text/plain\",\n\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t],\n\t\t\t\t\t\t\tmetadata: undefined,\n\t\t\t\t\t\t\textensions: [],\n\t\t\t\t\t\t},\n\t\t\t\t\t\tlastChunk: true,\n\t\t\t\t\t\tappend: false,\n\t\t\t\t\t\tmetadata: undefined,\n\t\t\t\t\t}),\n\t\t\t\t);\n\n\t\t\t\teventBus.publish(\n\t\t\t\t\tAgentEvent.statusUpdate({\n\t\t\t\t\t\ttaskId,\n\t\t\t\t\t\tcontextId,\n\t\t\t\t\t\tstatus: {\n\t\t\t\t\t\t\tstate: TaskState.TASK_STATE_COMPLETED,\n\t\t\t\t\t\t\ttimestamp: new Date().toISOString(),\n\t\t\t\t\t\t\tmessage: undefined,\n\t\t\t\t\t\t},\n\t\t\t\t\t\tmetadata: undefined,\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t} finally {\n\t\t\t\tthis.cancelledTasks.delete(taskId);\n\t\t\t\tthis.taskAbortControllers.delete(taskId);\n\t\t\t\tthis.taskContexts.delete(taskId);\n\t\t\t}\n\t\t});\n\t}\n}\n"]}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"http-url.d.ts","sourceRoot":"","sources":["../src/http-url.ts"],"names":[],"mappings":"AAAA,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAUnE"}
|
package/dist/http-url.js
ADDED
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
export function formatA2aHttpUrl(host, port) {
|
|
2
|
+
let hostname = host;
|
|
3
|
+
if (hostname.startsWith("[") && hostname.endsWith("]")) {
|
|
4
|
+
hostname = hostname.slice(1, -1);
|
|
5
|
+
}
|
|
6
|
+
if (hostname === "0.0.0.0" || hostname === "::" || hostname === "") {
|
|
7
|
+
hostname = "127.0.0.1";
|
|
8
|
+
}
|
|
9
|
+
const wrapped = hostname.includes(":") ? `[${hostname}]` : hostname;
|
|
10
|
+
return `http://${wrapped}:${port}/`;
|
|
11
|
+
}
|
|
12
|
+
//# sourceMappingURL=http-url.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"http-url.js","sourceRoot":"","sources":["../src/http-url.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,IAAY;IAC1D,IAAI,QAAQ,GAAG,IAAI,CAAC;IACpB,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACxD,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;IACD,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,EAAE,EAAE,CAAC;QACpE,QAAQ,GAAG,WAAW,CAAC;IACxB,CAAC;IACD,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,QAAQ,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC;IACpE,OAAO,UAAU,OAAO,IAAI,IAAI,GAAG,CAAC;AACrC,CAAC","sourcesContent":["export function formatA2aHttpUrl(host: string, port: number): string {\n\tlet hostname = host;\n\tif (hostname.startsWith(\"[\") && hostname.endsWith(\"]\")) {\n\t\thostname = hostname.slice(1, -1);\n\t}\n\tif (hostname === \"0.0.0.0\" || hostname === \"::\" || hostname === \"\") {\n\t\thostname = \"127.0.0.1\";\n\t}\n\tconst wrapped = hostname.includes(\":\") ? `[${hostname}]` : hostname;\n\treturn `http://${wrapped}:${port}/`;\n}\n"]}
|
package/dist/index.d.ts
CHANGED
|
@@ -1,6 +1,8 @@
|
|
|
1
1
|
export { type CreatePunchAgentCardOptions, createPunchAgentCard } from "./agent-card.ts";
|
|
2
2
|
export { type DelegateToA2aAgentOptions, type DelegateToA2aAgentResult, delegateToA2aAgent, delegateToA2aAgentPreferStream, delegateToA2aAgentStream, } from "./client.ts";
|
|
3
|
+
export { type A2aPeerRecord, defaultA2aDiscoveryDir, LocalA2aDiscovery, type LocalA2aDiscoveryOptions, } from "./discovery.ts";
|
|
3
4
|
export { HarnessAgentExecutor, type HarnessPromptError, type HarnessPromptOutcome, type HarnessPromptResult, type HarnessPromptRunner, type HarnessPromptRunnerFactory, isHarnessPromptError, } from "./executor.ts";
|
|
5
|
+
export { formatA2aHttpUrl } from "./http-url.ts";
|
|
4
6
|
export { createTextMessage, extractTextFromMessage, extractTextFromPart } from "./message.ts";
|
|
5
|
-
export { type A2aServer, type CreateA2aServerOptions, createA2aServer } from "./server.ts";
|
|
7
|
+
export { type A2aListenAddress, type A2aServer, type CreateA2aServerOptions, createA2aServer, } from "./server.ts";
|
|
6
8
|
//# sourceMappingURL=index.d.ts.map
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,2BAA2B,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACzF,OAAO,EACN,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,kBAAkB,EAClB,8BAA8B,EAC9B,wBAAwB,GACxB,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,oBAAoB,EACpB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,EAC/B,oBAAoB,GACpB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAC9F,OAAO,
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,2BAA2B,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACzF,OAAO,EACN,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,kBAAkB,EAClB,8BAA8B,EAC9B,wBAAwB,GACxB,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,KAAK,aAAa,EAClB,sBAAsB,EACtB,iBAAiB,EACjB,KAAK,wBAAwB,GAC7B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACN,oBAAoB,EACpB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,EAC/B,oBAAoB,GACpB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAC9F,OAAO,EACN,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,sBAAsB,EAC3B,eAAe,GACf,MAAM,aAAa,CAAC"}
|
package/dist/index.js
CHANGED
|
@@ -1,6 +1,8 @@
|
|
|
1
1
|
export { createPunchAgentCard } from "./agent-card.js";
|
|
2
2
|
export { delegateToA2aAgent, delegateToA2aAgentPreferStream, delegateToA2aAgentStream, } from "./client.js";
|
|
3
|
+
export { defaultA2aDiscoveryDir, LocalA2aDiscovery, } from "./discovery.js";
|
|
3
4
|
export { HarnessAgentExecutor, isHarnessPromptError, } from "./executor.js";
|
|
5
|
+
export { formatA2aHttpUrl } from "./http-url.js";
|
|
4
6
|
export { createTextMessage, extractTextFromMessage, extractTextFromPart } from "./message.js";
|
|
5
|
-
export { createA2aServer } from "./server.js";
|
|
7
|
+
export { createA2aServer, } from "./server.js";
|
|
6
8
|
//# sourceMappingURL=index.js.map
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACzF,OAAO,EAGN,kBAAkB,EAClB,8BAA8B,EAC9B,wBAAwB,GACxB,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,oBAAoB,EAMpB,oBAAoB,GACpB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAC9F,OAAO,
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACzF,OAAO,EAGN,kBAAkB,EAClB,8BAA8B,EAC9B,wBAAwB,GACxB,MAAM,aAAa,CAAC;AACrB,OAAO,EAEN,sBAAsB,EACtB,iBAAiB,GAEjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACN,oBAAoB,EAMpB,oBAAoB,GACpB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAC9F,OAAO,EAIN,eAAe,GACf,MAAM,aAAa,CAAC","sourcesContent":["export { type CreatePunchAgentCardOptions, createPunchAgentCard } from \"./agent-card.ts\";\nexport {\n\ttype DelegateToA2aAgentOptions,\n\ttype DelegateToA2aAgentResult,\n\tdelegateToA2aAgent,\n\tdelegateToA2aAgentPreferStream,\n\tdelegateToA2aAgentStream,\n} from \"./client.ts\";\nexport {\n\ttype A2aPeerRecord,\n\tdefaultA2aDiscoveryDir,\n\tLocalA2aDiscovery,\n\ttype LocalA2aDiscoveryOptions,\n} from \"./discovery.ts\";\nexport {\n\tHarnessAgentExecutor,\n\ttype HarnessPromptError,\n\ttype HarnessPromptOutcome,\n\ttype HarnessPromptResult,\n\ttype HarnessPromptRunner,\n\ttype HarnessPromptRunnerFactory,\n\tisHarnessPromptError,\n} from \"./executor.ts\";\nexport { formatA2aHttpUrl } from \"./http-url.ts\";\nexport { createTextMessage, extractTextFromMessage, extractTextFromPart } from \"./message.ts\";\nexport {\n\ttype A2aListenAddress,\n\ttype A2aServer,\n\ttype CreateA2aServerOptions,\n\tcreateA2aServer,\n} from \"./server.ts\";\n"]}
|
package/dist/message.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../src/message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAEjD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAO3E;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAMtD;AAED,wBAAgB,iBAAiB,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACxE,OAAO,CAmBT"
|
|
1
|
+
{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../src/message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAEjD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAO3E;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAMtD;AAED,wBAAgB,iBAAiB,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACxE,OAAO,CAmBT"}
|
package/dist/message.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"message.js","sourceRoot":"","sources":["../src/message.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,sBAAsB,CAAC,OAA4B
|
|
1
|
+
{"version":3,"file":"message.js","sourceRoot":"","sources":["../src/message.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,sBAAsB,CAAC,OAA4B;IAClE,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,OAAO,OAAO,CAAC,KAAK;SAClB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;SACxC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;SACjC,IAAI,CAAC,IAAI,CAAC;SACV,IAAI,EAAE,CAAC;AACV,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAU;IAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC7B,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,IAAI,OAAO,CAAC,KAAK,KAAK,MAAM;QAAE,OAAO,OAAO,CAAC,KAAK,CAAC;IACnD,IAAI,OAAO,CAAC,KAAK,KAAK,KAAK;QAAE,OAAO,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACnE,OAAO,EAAE,CAAC;AACX,CAAC;AAED,MAAM,UAAU,iBAAiB,CAChC,IAAY,EACZ,OAA0E;IAE1E,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/C,OAAO;QACN,IAAI;QACJ,SAAS,EAAE,MAAM,CAAC,UAAU,EAAE;QAC9B,KAAK,EAAE;YACN;gBACC,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE;gBACvC,QAAQ,EAAE,SAAS;gBACnB,QAAQ,EAAE,EAAE;gBACZ,SAAS,EAAE,YAAY;aACvB;SACD;QACD,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,EAAE;QAC7B,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,EAAE;QACnC,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,EAAE;QACZ,gBAAgB,EAAE,EAAE;KACpB,CAAC;AACH,CAAC","sourcesContent":["import type { Message, Part } from \"@a2a-js/sdk\";\n\nexport function extractTextFromMessage(message: Message | undefined): string {\n\tif (!message) return \"\";\n\treturn message.parts\n\t\t.map((part) => extractTextFromPart(part))\n\t\t.filter((text) => text.length > 0)\n\t\t.join(\"\\n\")\n\t\t.trim();\n}\n\nexport function extractTextFromPart(part: Part): string {\n\tconst content = part.content;\n\tif (!content) return \"\";\n\tif (content.$case === \"text\") return content.value;\n\tif (content.$case === \"raw\") return content.value.toString(\"utf8\");\n\treturn \"\";\n}\n\nexport function createTextMessage(\n\ttext: string,\n\toptions?: { role?: \"user\" | \"agent\"; taskId?: string; contextId?: string },\n): Message {\n\tconst role = options?.role === \"agent\" ? 2 : 1;\n\treturn {\n\t\trole,\n\t\tmessageId: crypto.randomUUID(),\n\t\tparts: [\n\t\t\t{\n\t\t\t\tcontent: { $case: \"text\", value: text },\n\t\t\t\tmetadata: undefined,\n\t\t\t\tfilename: \"\",\n\t\t\t\tmediaType: \"text/plain\",\n\t\t\t},\n\t\t],\n\t\ttaskId: options?.taskId ?? \"\",\n\t\tcontextId: options?.contextId ?? \"\",\n\t\textensions: [],\n\t\tmetadata: {},\n\t\treferenceTaskIds: [],\n\t};\n}\n"]}
|
package/dist/server.d.ts
CHANGED
|
@@ -1,17 +1,25 @@
|
|
|
1
1
|
import { DefaultRequestHandler } from "@a2a-js/sdk/server";
|
|
2
2
|
import type { Express } from "express";
|
|
3
3
|
import { type HarnessPromptRunnerFactory } from "./executor.ts";
|
|
4
|
+
export interface A2aListenAddress {
|
|
5
|
+
host: string;
|
|
6
|
+
port: number;
|
|
7
|
+
url: string;
|
|
8
|
+
}
|
|
4
9
|
export interface CreateA2aServerOptions {
|
|
5
|
-
baseUrl
|
|
10
|
+
baseUrl?: string;
|
|
11
|
+
publicHost?: string;
|
|
6
12
|
runnerFactory: HarnessPromptRunnerFactory;
|
|
7
13
|
name?: string;
|
|
8
14
|
description?: string;
|
|
9
15
|
}
|
|
10
16
|
export interface A2aServer {
|
|
11
17
|
app: Express;
|
|
12
|
-
requestHandler: DefaultRequestHandler;
|
|
13
|
-
listen(port
|
|
18
|
+
requestHandler: DefaultRequestHandler | undefined;
|
|
19
|
+
listen(port?: number, host?: string): Promise<A2aListenAddress>;
|
|
14
20
|
close(): Promise<void>;
|
|
21
|
+
address(): A2aListenAddress | undefined;
|
|
22
|
+
unref(): void;
|
|
15
23
|
}
|
|
16
24
|
export declare function createA2aServer(options: CreateA2aServerOptions): Promise<A2aServer>;
|
|
17
25
|
//# sourceMappingURL=server.d.ts.map
|
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":"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"}
|
package/dist/server.js
CHANGED
|
@@ -4,43 +4,81 @@ import { agentCardHandler, jsonRpcHandler, UserBuilder } from "@a2a-js/sdk/serve
|
|
|
4
4
|
import express from "express";
|
|
5
5
|
import { createPunchAgentCard } from "./agent-card.js";
|
|
6
6
|
import { HarnessAgentExecutor } from "./executor.js";
|
|
7
|
+
import { formatA2aHttpUrl } from "./http-url.js";
|
|
7
8
|
export async function createA2aServer(options) {
|
|
8
|
-
const agentCard = createPunchAgentCard({
|
|
9
|
-
baseUrl: options.baseUrl,
|
|
10
|
-
name: options.name,
|
|
11
|
-
description: options.description,
|
|
12
|
-
});
|
|
13
9
|
const taskStore = new InMemoryTaskStore();
|
|
14
10
|
const agentExecutor = new HarnessAgentExecutor(options.runnerFactory);
|
|
15
|
-
const requestHandler = new DefaultRequestHandler(agentCard, taskStore, agentExecutor);
|
|
16
11
|
const app = express();
|
|
17
|
-
|
|
18
|
-
|
|
12
|
+
let requestHandler;
|
|
13
|
+
let routesMounted = false;
|
|
19
14
|
let server;
|
|
15
|
+
let bound;
|
|
16
|
+
function mount(baseUrl) {
|
|
17
|
+
if (routesMounted)
|
|
18
|
+
return;
|
|
19
|
+
const agentCard = createPunchAgentCard({
|
|
20
|
+
baseUrl,
|
|
21
|
+
name: options.name,
|
|
22
|
+
description: options.description,
|
|
23
|
+
});
|
|
24
|
+
requestHandler = new DefaultRequestHandler(agentCard, taskStore, agentExecutor);
|
|
25
|
+
app.use(`/${AGENT_CARD_PATH}`, agentCardHandler({ agentCardProvider: requestHandler }));
|
|
26
|
+
app.use(jsonRpcHandler({ requestHandler, userBuilder: UserBuilder.noAuthentication }));
|
|
27
|
+
routesMounted = true;
|
|
28
|
+
}
|
|
29
|
+
if (options.baseUrl)
|
|
30
|
+
mount(options.baseUrl);
|
|
20
31
|
return {
|
|
21
32
|
app,
|
|
22
|
-
requestHandler
|
|
23
|
-
|
|
33
|
+
get requestHandler() {
|
|
34
|
+
return requestHandler;
|
|
35
|
+
},
|
|
36
|
+
listen(port = 0, host = "127.0.0.1") {
|
|
24
37
|
return new Promise((resolve, reject) => {
|
|
25
38
|
server = app.listen(port, host, (error) => {
|
|
26
|
-
if (error)
|
|
39
|
+
if (error) {
|
|
27
40
|
reject(error);
|
|
28
|
-
|
|
29
|
-
|
|
41
|
+
return;
|
|
42
|
+
}
|
|
43
|
+
const addr = server?.address();
|
|
44
|
+
if (!addr || typeof addr === "string") {
|
|
45
|
+
reject(new Error("A2A server bound without a TCP address"));
|
|
46
|
+
return;
|
|
47
|
+
}
|
|
48
|
+
const info = addr;
|
|
49
|
+
const url = options.baseUrl ?? formatA2aHttpUrl(options.publicHost ?? info.address, info.port);
|
|
50
|
+
bound = { host: info.address, port: info.port, url };
|
|
51
|
+
try {
|
|
52
|
+
mount(url);
|
|
53
|
+
}
|
|
54
|
+
catch (err) {
|
|
55
|
+
reject(err);
|
|
56
|
+
return;
|
|
57
|
+
}
|
|
58
|
+
resolve(bound);
|
|
30
59
|
});
|
|
31
60
|
});
|
|
32
61
|
},
|
|
62
|
+
address() {
|
|
63
|
+
return bound;
|
|
64
|
+
},
|
|
65
|
+
unref() {
|
|
66
|
+
server?.unref();
|
|
67
|
+
},
|
|
33
68
|
close() {
|
|
34
69
|
return new Promise((resolve, reject) => {
|
|
35
70
|
if (!server) {
|
|
71
|
+
bound = undefined;
|
|
36
72
|
resolve();
|
|
37
73
|
return;
|
|
38
74
|
}
|
|
39
75
|
server.close((error) => {
|
|
40
76
|
if (error)
|
|
41
77
|
reject(error);
|
|
42
|
-
else
|
|
78
|
+
else {
|
|
79
|
+
bound = undefined;
|
|
43
80
|
resolve();
|
|
81
|
+
}
|
|
44
82
|
});
|
|
45
83
|
});
|
|
46
84
|
},
|
package/dist/server.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"
|
|
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"]}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@punch-bot/a2a",
|
|
3
|
-
"version": "
|
|
3
|
+
"version": "1.3.0",
|
|
4
4
|
"description": "Agent2Agent (A2A) protocol integration for punch agents",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./dist/index.js",
|
|
@@ -18,9 +18,9 @@
|
|
|
18
18
|
],
|
|
19
19
|
"scripts": {
|
|
20
20
|
"clean": "shx rm -rf dist",
|
|
21
|
-
"build": "
|
|
21
|
+
"build": "tsc -p tsconfig.build.json",
|
|
22
22
|
"test": "vitest --run",
|
|
23
|
-
"typecheck": "
|
|
23
|
+
"typecheck": "tsc -p tsconfig.test.json",
|
|
24
24
|
"prepublishOnly": "npm run clean && npm run build"
|
|
25
25
|
},
|
|
26
26
|
"keywords": [
|
|
@@ -45,7 +45,7 @@
|
|
|
45
45
|
},
|
|
46
46
|
"devDependencies": {
|
|
47
47
|
"@types/express": "5.0.3",
|
|
48
|
-
"shx": "0.4
|
|
48
|
+
"shx": "0.3.4",
|
|
49
49
|
"vitest": "5.0.0"
|
|
50
50
|
}
|
|
51
51
|
}
|