@punch-bot/a2a 0.85.1
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 +7 -0
- package/README.md +39 -0
- package/dist/agent-card.d.ts +10 -0
- package/dist/agent-card.d.ts.map +1 -0
- package/dist/agent-card.js +49 -0
- package/dist/agent-card.js.map +1 -0
- package/dist/client.d.ts +16 -0
- package/dist/client.d.ts.map +1 -0
- package/dist/client.js +208 -0
- package/dist/client.js.map +1 -0
- package/dist/executor.d.ts +26 -0
- package/dist/executor.d.ts.map +1 -0
- package/dist/executor.js +144 -0
- package/dist/executor.js.map +1 -0
- package/dist/index.d.ts +6 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +6 -0
- package/dist/index.js.map +1 -0
- package/dist/message.d.ts +9 -0
- package/dist/message.d.ts.map +1 -0
- package/dist/message.js +40 -0
- package/dist/message.js.map +1 -0
- package/dist/server.d.ts +17 -0
- package/dist/server.d.ts.map +1 -0
- package/dist/server.js +49 -0
- package/dist/server.js.map +1 -0
- package/package.json +51 -0
package/CHANGELOG.md
ADDED
package/README.md
ADDED
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
# @punch-bot/a2a
|
|
2
|
+
|
|
3
|
+
Agent2Agent (A2A) protocol integration for punch agents.
|
|
4
|
+
|
|
5
|
+
This package wraps the official [`@a2a-js/sdk`](https://www.npmjs.com/package/@a2a-js/sdk) and provides punch-specific helpers for:
|
|
6
|
+
|
|
7
|
+
- exposing a punch agent as an A2A server
|
|
8
|
+
- delegating tasks to external A2A agents (for example Hermes)
|
|
9
|
+
- bridging `AgentHarness` prompt execution to A2A task lifecycle events
|
|
10
|
+
|
|
11
|
+
## Server
|
|
12
|
+
|
|
13
|
+
```ts
|
|
14
|
+
import { createA2aServer } from "@punch-bot/a2a";
|
|
15
|
+
|
|
16
|
+
const server = await createA2aServer({
|
|
17
|
+
baseUrl: "http://localhost:41241",
|
|
18
|
+
runnerFactory: (contextId) => ({
|
|
19
|
+
async prompt(text) {
|
|
20
|
+
return { text: `echo: ${text}` };
|
|
21
|
+
},
|
|
22
|
+
}),
|
|
23
|
+
});
|
|
24
|
+
|
|
25
|
+
await server.listen(41241);
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
## Client
|
|
29
|
+
|
|
30
|
+
```ts
|
|
31
|
+
import { delegateToA2aAgent } from "@punch-bot/a2a";
|
|
32
|
+
|
|
33
|
+
const result = await delegateToA2aAgent({
|
|
34
|
+
url: "http://localhost:41241",
|
|
35
|
+
task: "Summarize the repository structure",
|
|
36
|
+
});
|
|
37
|
+
|
|
38
|
+
console.log(result.text);
|
|
39
|
+
```
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import { type AgentCard, type AgentSkill } from "@a2a-js/sdk";
|
|
2
|
+
export interface CreatePunchAgentCardOptions {
|
|
3
|
+
baseUrl: string;
|
|
4
|
+
name?: string;
|
|
5
|
+
description?: string;
|
|
6
|
+
version?: string;
|
|
7
|
+
skills?: readonly AgentSkill[];
|
|
8
|
+
}
|
|
9
|
+
export declare function createPunchAgentCard(options: CreatePunchAgentCardOptions): AgentCard;
|
|
10
|
+
//# sourceMappingURL=agent-card.d.ts.map
|
|
@@ -0,0 +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","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"]}
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
import { A2A_PROTOCOL_VERSION } from "@a2a-js/sdk";
|
|
2
|
+
export function createPunchAgentCard(options) {
|
|
3
|
+
const normalizedBaseUrl = options.baseUrl.endsWith("/") ? options.baseUrl : `${options.baseUrl}/`;
|
|
4
|
+
const skills = options.skills
|
|
5
|
+
? [...options.skills]
|
|
6
|
+
: [
|
|
7
|
+
{
|
|
8
|
+
id: "coding_agent",
|
|
9
|
+
name: "Coding Agent",
|
|
10
|
+
description: "General-purpose coding agent with read, bash, edit, and write tools.",
|
|
11
|
+
tags: ["coding", "agent"],
|
|
12
|
+
examples: ["Fix the failing test in src/foo.test.ts", "Summarize this repository"],
|
|
13
|
+
inputModes: ["text"],
|
|
14
|
+
outputModes: ["text"],
|
|
15
|
+
securityRequirements: [],
|
|
16
|
+
},
|
|
17
|
+
];
|
|
18
|
+
return {
|
|
19
|
+
name: options.name ?? "Punch Agent",
|
|
20
|
+
description: options.description ?? "A punch coding agent exposed over the Agent2Agent protocol.",
|
|
21
|
+
supportedInterfaces: [
|
|
22
|
+
{
|
|
23
|
+
url: normalizedBaseUrl,
|
|
24
|
+
protocolBinding: "JSONRPC",
|
|
25
|
+
tenant: "",
|
|
26
|
+
protocolVersion: A2A_PROTOCOL_VERSION,
|
|
27
|
+
},
|
|
28
|
+
],
|
|
29
|
+
provider: {
|
|
30
|
+
organization: "Punch",
|
|
31
|
+
url: "https://github.com/punch-bot/core",
|
|
32
|
+
},
|
|
33
|
+
version: options.version ?? "1.0.0",
|
|
34
|
+
capabilities: {
|
|
35
|
+
streaming: true,
|
|
36
|
+
pushNotifications: false,
|
|
37
|
+
extensions: [],
|
|
38
|
+
extendedAgentCard: false,
|
|
39
|
+
},
|
|
40
|
+
securitySchemes: {},
|
|
41
|
+
securityRequirements: [],
|
|
42
|
+
defaultInputModes: ["text"],
|
|
43
|
+
defaultOutputModes: ["text"],
|
|
44
|
+
skills,
|
|
45
|
+
documentationUrl: "https://github.com/punch-bot/core",
|
|
46
|
+
signatures: [],
|
|
47
|
+
};
|
|
48
|
+
}
|
|
49
|
+
//# sourceMappingURL=agent-card.js.map
|
|
@@ -0,0 +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,EAAa;IACrF,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;AAAA,CACF","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
ADDED
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
export interface DelegateToA2aAgentOptions {
|
|
2
|
+
url: string;
|
|
3
|
+
task: string;
|
|
4
|
+
signal?: AbortSignal;
|
|
5
|
+
}
|
|
6
|
+
export interface DelegateToA2aAgentResult {
|
|
7
|
+
text: string;
|
|
8
|
+
taskId?: string;
|
|
9
|
+
contextId?: string;
|
|
10
|
+
failed?: boolean;
|
|
11
|
+
error?: string;
|
|
12
|
+
}
|
|
13
|
+
export declare function delegateToA2aAgent(options: DelegateToA2aAgentOptions): Promise<DelegateToA2aAgentResult>;
|
|
14
|
+
export declare function delegateToA2aAgentStream(options: DelegateToA2aAgentOptions, onUpdate?: (text: string) => void): Promise<DelegateToA2aAgentResult>;
|
|
15
|
+
export declare function delegateToA2aAgentPreferStream(options: DelegateToA2aAgentOptions, onUpdate?: (text: string) => void): Promise<DelegateToA2aAgentResult>;
|
|
16
|
+
//# sourceMappingURL=client.d.ts.map
|
|
@@ -0,0 +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","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"]}
|
package/dist/client.js
ADDED
|
@@ -0,0 +1,208 @@
|
|
|
1
|
+
import { TaskState } from "@a2a-js/sdk";
|
|
2
|
+
import { ClientFactory, JsonRpcTransportFactory } from "@a2a-js/sdk/client";
|
|
3
|
+
import { createTextMessage, extractTextFromMessage } from "./message.js";
|
|
4
|
+
function buildSendMessageRequest(task) {
|
|
5
|
+
return {
|
|
6
|
+
message: createTextMessage(task, { role: "user" }),
|
|
7
|
+
configuration: {
|
|
8
|
+
acceptedOutputModes: ["text"],
|
|
9
|
+
returnImmediately: false,
|
|
10
|
+
historyLength: 0,
|
|
11
|
+
taskPushNotificationConfig: undefined,
|
|
12
|
+
},
|
|
13
|
+
metadata: {},
|
|
14
|
+
tenant: "",
|
|
15
|
+
};
|
|
16
|
+
}
|
|
17
|
+
function buildStreamingSendMessageRequest(task) {
|
|
18
|
+
return {
|
|
19
|
+
...buildSendMessageRequest(task),
|
|
20
|
+
configuration: {
|
|
21
|
+
acceptedOutputModes: ["text"],
|
|
22
|
+
returnImmediately: true,
|
|
23
|
+
historyLength: 0,
|
|
24
|
+
taskPushNotificationConfig: undefined,
|
|
25
|
+
},
|
|
26
|
+
};
|
|
27
|
+
}
|
|
28
|
+
async function createA2aClient(url) {
|
|
29
|
+
const factory = new ClientFactory({
|
|
30
|
+
transports: [new JsonRpcTransportFactory()],
|
|
31
|
+
});
|
|
32
|
+
return factory.createFromUrl(url);
|
|
33
|
+
}
|
|
34
|
+
function extractArtifactTextFromTask(task) {
|
|
35
|
+
if (!task)
|
|
36
|
+
return "";
|
|
37
|
+
const artifactText = task.artifacts
|
|
38
|
+
.flatMap((artifact) => artifact.parts.map((part) => (part.content?.$case === "text" ? part.content.value : "")))
|
|
39
|
+
.filter(Boolean)
|
|
40
|
+
.join("\n")
|
|
41
|
+
.trim();
|
|
42
|
+
return artifactText;
|
|
43
|
+
}
|
|
44
|
+
function extractErrorFromTask(task) {
|
|
45
|
+
if (!task)
|
|
46
|
+
return undefined;
|
|
47
|
+
const state = task.status?.state;
|
|
48
|
+
if (state === TaskState.TASK_STATE_FAILED) {
|
|
49
|
+
const metadataError = task.metadata?.error;
|
|
50
|
+
if (typeof metadataError === "string" && metadataError.length > 0)
|
|
51
|
+
return metadataError;
|
|
52
|
+
const statusText = extractTextFromMessage(task.status?.message);
|
|
53
|
+
if (statusText)
|
|
54
|
+
return statusText;
|
|
55
|
+
return "Remote A2A task failed";
|
|
56
|
+
}
|
|
57
|
+
if (state === TaskState.TASK_STATE_REJECTED) {
|
|
58
|
+
const statusText = extractTextFromMessage(task.status?.message);
|
|
59
|
+
return statusText || "Remote A2A task rejected";
|
|
60
|
+
}
|
|
61
|
+
if (state === TaskState.TASK_STATE_CANCELED) {
|
|
62
|
+
const statusText = extractTextFromMessage(task.status?.message);
|
|
63
|
+
return statusText || "Remote A2A task canceled";
|
|
64
|
+
}
|
|
65
|
+
return undefined;
|
|
66
|
+
}
|
|
67
|
+
function extractTextFromTask(task) {
|
|
68
|
+
if (!task)
|
|
69
|
+
return "";
|
|
70
|
+
const artifactText = extractArtifactTextFromTask(task);
|
|
71
|
+
if (artifactText)
|
|
72
|
+
return artifactText;
|
|
73
|
+
return extractTextFromMessage(task.status?.message);
|
|
74
|
+
}
|
|
75
|
+
function extractArtifactTextFromStreamEvent(event, artifactText) {
|
|
76
|
+
const payload = event.payload;
|
|
77
|
+
if (!payload)
|
|
78
|
+
return artifactText;
|
|
79
|
+
switch (payload.$case) {
|
|
80
|
+
case "task": {
|
|
81
|
+
const taskArtifact = extractArtifactTextFromTask(payload.value);
|
|
82
|
+
return taskArtifact || artifactText;
|
|
83
|
+
}
|
|
84
|
+
case "artifactUpdate": {
|
|
85
|
+
const chunk = payload.value.artifact?.parts
|
|
86
|
+
.map((part) => (part.content?.$case === "text" ? part.content.value : ""))
|
|
87
|
+
.filter(Boolean)
|
|
88
|
+
.join("\n") ?? "";
|
|
89
|
+
if (!chunk)
|
|
90
|
+
return artifactText;
|
|
91
|
+
return payload.value.append ? `${artifactText}${chunk}` : chunk;
|
|
92
|
+
}
|
|
93
|
+
default:
|
|
94
|
+
return artifactText;
|
|
95
|
+
}
|
|
96
|
+
}
|
|
97
|
+
function isTerminalTaskState(state) {
|
|
98
|
+
return (state === TaskState.TASK_STATE_COMPLETED ||
|
|
99
|
+
state === TaskState.TASK_STATE_FAILED ||
|
|
100
|
+
state === TaskState.TASK_STATE_CANCELED ||
|
|
101
|
+
state === TaskState.TASK_STATE_REJECTED);
|
|
102
|
+
}
|
|
103
|
+
function isFailedTerminalTaskState(state) {
|
|
104
|
+
return (state === TaskState.TASK_STATE_FAILED ||
|
|
105
|
+
state === TaskState.TASK_STATE_CANCELED ||
|
|
106
|
+
state === TaskState.TASK_STATE_REJECTED);
|
|
107
|
+
}
|
|
108
|
+
function buildResultFromTask(task) {
|
|
109
|
+
const state = task.status?.state;
|
|
110
|
+
const error = extractErrorFromTask(task);
|
|
111
|
+
const failed = error !== undefined || isFailedTerminalTaskState(state);
|
|
112
|
+
return {
|
|
113
|
+
text: extractTextFromTask(task),
|
|
114
|
+
taskId: task.id,
|
|
115
|
+
contextId: task.contextId,
|
|
116
|
+
...(failed ? { failed: true, error: error ?? "Remote A2A task failed" } : {}),
|
|
117
|
+
};
|
|
118
|
+
}
|
|
119
|
+
async function delegateToA2aAgentWithClient(client, options) {
|
|
120
|
+
const response = await client.sendMessage(buildSendMessageRequest(options.task), { signal: options.signal });
|
|
121
|
+
if ("parts" in response) {
|
|
122
|
+
return { text: extractTextFromMessage(response) };
|
|
123
|
+
}
|
|
124
|
+
return buildResultFromTask(response);
|
|
125
|
+
}
|
|
126
|
+
async function delegateToA2aAgentStreamWithClient(client, options, onUpdate) {
|
|
127
|
+
const stream = client.sendMessageStream(buildStreamingSendMessageRequest(options.task), { signal: options.signal });
|
|
128
|
+
let artifactText = "";
|
|
129
|
+
let latestTask;
|
|
130
|
+
let taskId;
|
|
131
|
+
let contextId;
|
|
132
|
+
let failed = false;
|
|
133
|
+
let error;
|
|
134
|
+
for await (const event of stream) {
|
|
135
|
+
artifactText = extractArtifactTextFromStreamEvent(event, artifactText);
|
|
136
|
+
if (artifactText)
|
|
137
|
+
onUpdate?.(artifactText);
|
|
138
|
+
const payload = event.payload;
|
|
139
|
+
if (payload?.$case === "task") {
|
|
140
|
+
latestTask = payload.value;
|
|
141
|
+
taskId = payload.value.id;
|
|
142
|
+
contextId = payload.value.contextId;
|
|
143
|
+
if (isFailedTerminalTaskState(payload.value.status?.state)) {
|
|
144
|
+
failed = true;
|
|
145
|
+
error = extractErrorFromTask(payload.value);
|
|
146
|
+
}
|
|
147
|
+
if (isTerminalTaskState(payload.value.status?.state)) {
|
|
148
|
+
const terminalArtifact = extractArtifactTextFromTask(payload.value);
|
|
149
|
+
if (terminalArtifact)
|
|
150
|
+
artifactText = terminalArtifact;
|
|
151
|
+
}
|
|
152
|
+
}
|
|
153
|
+
if (payload?.$case === "statusUpdate") {
|
|
154
|
+
taskId = taskId ?? payload.value.taskId;
|
|
155
|
+
contextId = contextId ?? payload.value.contextId;
|
|
156
|
+
if (payload.value.status?.state === TaskState.TASK_STATE_COMPLETED) {
|
|
157
|
+
latestTask = {
|
|
158
|
+
id: taskId ?? payload.value.taskId,
|
|
159
|
+
contextId: contextId ?? payload.value.contextId,
|
|
160
|
+
status: payload.value.status,
|
|
161
|
+
artifacts: latestTask?.artifacts ?? [],
|
|
162
|
+
history: latestTask?.history ?? [],
|
|
163
|
+
metadata: latestTask?.metadata ?? payload.value.metadata ?? {},
|
|
164
|
+
};
|
|
165
|
+
}
|
|
166
|
+
if (isFailedTerminalTaskState(payload.value.status?.state)) {
|
|
167
|
+
failed = true;
|
|
168
|
+
error = extractErrorFromTask({
|
|
169
|
+
id: taskId ?? payload.value.taskId,
|
|
170
|
+
contextId: contextId ?? payload.value.contextId,
|
|
171
|
+
status: payload.value.status,
|
|
172
|
+
artifacts: latestTask?.artifacts ?? [],
|
|
173
|
+
history: latestTask?.history ?? [],
|
|
174
|
+
metadata: payload.value.metadata ?? latestTask?.metadata ?? {},
|
|
175
|
+
});
|
|
176
|
+
}
|
|
177
|
+
}
|
|
178
|
+
}
|
|
179
|
+
const text = artifactText || extractTextFromTask(latestTask);
|
|
180
|
+
if (text && !artifactText)
|
|
181
|
+
onUpdate?.(text);
|
|
182
|
+
return {
|
|
183
|
+
text,
|
|
184
|
+
taskId,
|
|
185
|
+
contextId,
|
|
186
|
+
...(failed ? { failed: true, error: error ?? "Remote A2A task failed" } : {}),
|
|
187
|
+
};
|
|
188
|
+
}
|
|
189
|
+
export async function delegateToA2aAgent(options) {
|
|
190
|
+
const client = await createA2aClient(options.url);
|
|
191
|
+
return delegateToA2aAgentWithClient(client, options);
|
|
192
|
+
}
|
|
193
|
+
export async function delegateToA2aAgentStream(options, onUpdate) {
|
|
194
|
+
const client = await createA2aClient(options.url);
|
|
195
|
+
return delegateToA2aAgentStreamWithClient(client, options, onUpdate);
|
|
196
|
+
}
|
|
197
|
+
export async function delegateToA2aAgentPreferStream(options, onUpdate) {
|
|
198
|
+
const client = await createA2aClient(options.url);
|
|
199
|
+
const card = await client.getAgentCard({ signal: options.signal });
|
|
200
|
+
if (card.capabilities?.streaming) {
|
|
201
|
+
return delegateToA2aAgentStreamWithClient(client, options, onUpdate);
|
|
202
|
+
}
|
|
203
|
+
const result = await delegateToA2aAgentWithClient(client, options);
|
|
204
|
+
if (result.text)
|
|
205
|
+
onUpdate?.(result.text);
|
|
206
|
+
return result;
|
|
207
|
+
}
|
|
208
|
+
//# sourceMappingURL=client.js.map
|
|
@@ -0,0 +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"]}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
import { type AgentExecutor, type ExecutionEventBus, type RequestContext } from "@a2a-js/sdk/server";
|
|
2
|
+
export interface HarnessPromptResult {
|
|
3
|
+
text: string;
|
|
4
|
+
}
|
|
5
|
+
export interface HarnessPromptError {
|
|
6
|
+
message: string;
|
|
7
|
+
}
|
|
8
|
+
export type HarnessPromptOutcome = HarnessPromptResult | HarnessPromptError;
|
|
9
|
+
export declare function isHarnessPromptError(outcome: HarnessPromptOutcome): outcome is HarnessPromptError;
|
|
10
|
+
export interface HarnessPromptRunner {
|
|
11
|
+
prompt(text: string, signal?: AbortSignal): Promise<HarnessPromptOutcome>;
|
|
12
|
+
abort?(): Promise<void>;
|
|
13
|
+
}
|
|
14
|
+
export type HarnessPromptRunnerFactory = (contextId: string) => HarnessPromptRunner;
|
|
15
|
+
export declare class HarnessAgentExecutor implements AgentExecutor {
|
|
16
|
+
private readonly taskContexts;
|
|
17
|
+
private readonly cancelledTasks;
|
|
18
|
+
private readonly taskAbortControllers;
|
|
19
|
+
private readonly contextChains;
|
|
20
|
+
private readonly runnerFactory;
|
|
21
|
+
constructor(runnerFactory: HarnessPromptRunnerFactory);
|
|
22
|
+
cancelTask: (taskId: string, eventBus: ExecutionEventBus) => Promise<void>;
|
|
23
|
+
private runInContext;
|
|
24
|
+
execute(requestContext: RequestContext, eventBus: ExecutionEventBus): Promise<void>;
|
|
25
|
+
}
|
|
26
|
+
//# sourceMappingURL=executor.d.ts.map
|
|
@@ -0,0 +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,iEAgBR;IAEF,OAAO,CAAC,YAAY;IAWd,OAAO,CAAC,cAAc,EAAE,cAAc,EAAE,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoHxF;CACD","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"]}
|
package/dist/executor.js
ADDED
|
@@ -0,0 +1,144 @@
|
|
|
1
|
+
import { TaskState } from "@a2a-js/sdk";
|
|
2
|
+
import { AgentEvent } from "@a2a-js/sdk/server";
|
|
3
|
+
import { createTextMessage, extractTextFromMessage } from "./message.js";
|
|
4
|
+
export function isHarnessPromptError(outcome) {
|
|
5
|
+
return "message" in outcome;
|
|
6
|
+
}
|
|
7
|
+
export class HarnessAgentExecutor {
|
|
8
|
+
taskContexts = new Map();
|
|
9
|
+
cancelledTasks = new Set();
|
|
10
|
+
taskAbortControllers = new Map();
|
|
11
|
+
contextChains = new Map();
|
|
12
|
+
runnerFactory;
|
|
13
|
+
constructor(runnerFactory) {
|
|
14
|
+
this.runnerFactory = runnerFactory;
|
|
15
|
+
}
|
|
16
|
+
cancelTask = async (taskId, eventBus) => {
|
|
17
|
+
this.cancelledTasks.add(taskId);
|
|
18
|
+
this.taskAbortControllers.get(taskId)?.abort();
|
|
19
|
+
const contextId = this.taskContexts.get(taskId);
|
|
20
|
+
eventBus.publish(AgentEvent.statusUpdate({
|
|
21
|
+
taskId,
|
|
22
|
+
contextId: contextId ?? taskId,
|
|
23
|
+
status: {
|
|
24
|
+
state: TaskState.TASK_STATE_CANCELED,
|
|
25
|
+
timestamp: new Date().toISOString(),
|
|
26
|
+
message: undefined,
|
|
27
|
+
},
|
|
28
|
+
metadata: {},
|
|
29
|
+
}));
|
|
30
|
+
};
|
|
31
|
+
runInContext(contextId, fn) {
|
|
32
|
+
const previous = this.contextChains.get(contextId) ?? Promise.resolve();
|
|
33
|
+
const current = previous.catch(() => undefined).then(() => fn());
|
|
34
|
+
this.contextChains.set(contextId, current);
|
|
35
|
+
return current.finally(() => {
|
|
36
|
+
if (this.contextChains.get(contextId) === current) {
|
|
37
|
+
this.contextChains.delete(contextId);
|
|
38
|
+
}
|
|
39
|
+
});
|
|
40
|
+
}
|
|
41
|
+
async execute(requestContext, eventBus) {
|
|
42
|
+
const taskId = requestContext.taskId;
|
|
43
|
+
const contextId = requestContext.contextId;
|
|
44
|
+
const userMessage = requestContext.userMessage;
|
|
45
|
+
const existingTask = requestContext.task;
|
|
46
|
+
const promptText = extractTextFromMessage(userMessage);
|
|
47
|
+
await this.runInContext(contextId, async () => {
|
|
48
|
+
const abortController = new AbortController();
|
|
49
|
+
this.taskAbortControllers.set(taskId, abortController);
|
|
50
|
+
let runner;
|
|
51
|
+
try {
|
|
52
|
+
runner = this.runnerFactory(contextId);
|
|
53
|
+
this.taskContexts.set(taskId, contextId);
|
|
54
|
+
}
|
|
55
|
+
catch (error) {
|
|
56
|
+
this.taskAbortControllers.delete(taskId);
|
|
57
|
+
throw error;
|
|
58
|
+
}
|
|
59
|
+
try {
|
|
60
|
+
const taskSnapshot = existingTask ?? {
|
|
61
|
+
id: taskId,
|
|
62
|
+
contextId,
|
|
63
|
+
status: {
|
|
64
|
+
state: TaskState.TASK_STATE_SUBMITTED,
|
|
65
|
+
timestamp: new Date().toISOString(),
|
|
66
|
+
message: undefined,
|
|
67
|
+
},
|
|
68
|
+
artifacts: [],
|
|
69
|
+
history: [userMessage],
|
|
70
|
+
metadata: userMessage.metadata,
|
|
71
|
+
};
|
|
72
|
+
eventBus.publish(AgentEvent.task(taskSnapshot));
|
|
73
|
+
eventBus.publish(AgentEvent.statusUpdate({
|
|
74
|
+
taskId,
|
|
75
|
+
contextId,
|
|
76
|
+
status: {
|
|
77
|
+
state: TaskState.TASK_STATE_WORKING,
|
|
78
|
+
timestamp: new Date().toISOString(),
|
|
79
|
+
message: undefined,
|
|
80
|
+
},
|
|
81
|
+
metadata: {},
|
|
82
|
+
}));
|
|
83
|
+
if (this.cancelledTasks.has(taskId) || abortController.signal.aborted) {
|
|
84
|
+
return;
|
|
85
|
+
}
|
|
86
|
+
const outcome = await runner.prompt(promptText, abortController.signal);
|
|
87
|
+
if (this.cancelledTasks.has(taskId) || abortController.signal.aborted) {
|
|
88
|
+
return;
|
|
89
|
+
}
|
|
90
|
+
if (isHarnessPromptError(outcome)) {
|
|
91
|
+
eventBus.publish(AgentEvent.statusUpdate({
|
|
92
|
+
taskId,
|
|
93
|
+
contextId,
|
|
94
|
+
status: {
|
|
95
|
+
state: TaskState.TASK_STATE_FAILED,
|
|
96
|
+
timestamp: new Date().toISOString(),
|
|
97
|
+
message: createTextMessage(outcome.message, { role: "agent", taskId, contextId }),
|
|
98
|
+
},
|
|
99
|
+
metadata: { error: outcome.message },
|
|
100
|
+
}));
|
|
101
|
+
return;
|
|
102
|
+
}
|
|
103
|
+
eventBus.publish(AgentEvent.artifactUpdate({
|
|
104
|
+
taskId,
|
|
105
|
+
contextId,
|
|
106
|
+
artifact: {
|
|
107
|
+
artifactId: crypto.randomUUID(),
|
|
108
|
+
name: "Result",
|
|
109
|
+
description: "Agent response",
|
|
110
|
+
parts: [
|
|
111
|
+
{
|
|
112
|
+
content: { $case: "text", value: outcome.text },
|
|
113
|
+
metadata: undefined,
|
|
114
|
+
filename: "",
|
|
115
|
+
mediaType: "text/plain",
|
|
116
|
+
},
|
|
117
|
+
],
|
|
118
|
+
metadata: undefined,
|
|
119
|
+
extensions: [],
|
|
120
|
+
},
|
|
121
|
+
lastChunk: true,
|
|
122
|
+
append: false,
|
|
123
|
+
metadata: undefined,
|
|
124
|
+
}));
|
|
125
|
+
eventBus.publish(AgentEvent.statusUpdate({
|
|
126
|
+
taskId,
|
|
127
|
+
contextId,
|
|
128
|
+
status: {
|
|
129
|
+
state: TaskState.TASK_STATE_COMPLETED,
|
|
130
|
+
timestamp: new Date().toISOString(),
|
|
131
|
+
message: undefined,
|
|
132
|
+
},
|
|
133
|
+
metadata: undefined,
|
|
134
|
+
}));
|
|
135
|
+
}
|
|
136
|
+
finally {
|
|
137
|
+
this.cancelledTasks.delete(taskId);
|
|
138
|
+
this.taskAbortControllers.delete(taskId);
|
|
139
|
+
this.taskContexts.delete(taskId);
|
|
140
|
+
}
|
|
141
|
+
});
|
|
142
|
+
}
|
|
143
|
+
}
|
|
144
|
+
//# sourceMappingURL=executor.js.map
|
|
@@ -0,0 +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"]}
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
export { type CreatePunchAgentCardOptions, createPunchAgentCard } from "./agent-card.ts";
|
|
2
|
+
export { type DelegateToA2aAgentOptions, type DelegateToA2aAgentResult, delegateToA2aAgent, delegateToA2aAgentPreferStream, delegateToA2aAgentStream, } from "./client.ts";
|
|
3
|
+
export { HarnessAgentExecutor, type HarnessPromptError, type HarnessPromptOutcome, type HarnessPromptResult, type HarnessPromptRunner, type HarnessPromptRunnerFactory, isHarnessPromptError, } from "./executor.ts";
|
|
4
|
+
export { createTextMessage, extractTextFromMessage, extractTextFromPart } from "./message.ts";
|
|
5
|
+
export { type A2aServer, type CreateA2aServerOptions, createA2aServer } from "./server.ts";
|
|
6
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +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,EAAE,KAAK,SAAS,EAAE,KAAK,sBAAsB,EAAE,eAAe,EAAE,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\tHarnessAgentExecutor,\n\ttype HarnessPromptError,\n\ttype HarnessPromptOutcome,\n\ttype HarnessPromptResult,\n\ttype HarnessPromptRunner,\n\ttype HarnessPromptRunnerFactory,\n\tisHarnessPromptError,\n} from \"./executor.ts\";\nexport { createTextMessage, extractTextFromMessage, extractTextFromPart } from \"./message.ts\";\nexport { type A2aServer, type CreateA2aServerOptions, createA2aServer } from \"./server.ts\";\n"]}
|
package/dist/index.js
ADDED
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
export { createPunchAgentCard } from "./agent-card.js";
|
|
2
|
+
export { delegateToA2aAgent, delegateToA2aAgentPreferStream, delegateToA2aAgentStream, } from "./client.js";
|
|
3
|
+
export { HarnessAgentExecutor, isHarnessPromptError, } from "./executor.js";
|
|
4
|
+
export { createTextMessage, extractTextFromMessage, extractTextFromPart } from "./message.js";
|
|
5
|
+
export { createA2aServer } from "./server.js";
|
|
6
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +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,EAA+C,eAAe,EAAE,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\tHarnessAgentExecutor,\n\ttype HarnessPromptError,\n\ttype HarnessPromptOutcome,\n\ttype HarnessPromptResult,\n\ttype HarnessPromptRunner,\n\ttype HarnessPromptRunnerFactory,\n\tisHarnessPromptError,\n} from \"./executor.ts\";\nexport { createTextMessage, extractTextFromMessage, extractTextFromPart } from \"./message.ts\";\nexport { type A2aServer, type CreateA2aServerOptions, createA2aServer } from \"./server.ts\";\n"]}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import type { Message, Part } from "@a2a-js/sdk";
|
|
2
|
+
export declare function extractTextFromMessage(message: Message | undefined): string;
|
|
3
|
+
export declare function extractTextFromPart(part: Part): string;
|
|
4
|
+
export declare function createTextMessage(text: string, options?: {
|
|
5
|
+
role?: "user" | "agent";
|
|
6
|
+
taskId?: string;
|
|
7
|
+
contextId?: string;
|
|
8
|
+
}): Message;
|
|
9
|
+
//# sourceMappingURL=message.d.ts.map
|
|
@@ -0,0 +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","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/message.js
ADDED
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
export function extractTextFromMessage(message) {
|
|
2
|
+
if (!message)
|
|
3
|
+
return "";
|
|
4
|
+
return message.parts
|
|
5
|
+
.map((part) => extractTextFromPart(part))
|
|
6
|
+
.filter((text) => text.length > 0)
|
|
7
|
+
.join("\n")
|
|
8
|
+
.trim();
|
|
9
|
+
}
|
|
10
|
+
export function extractTextFromPart(part) {
|
|
11
|
+
const content = part.content;
|
|
12
|
+
if (!content)
|
|
13
|
+
return "";
|
|
14
|
+
if (content.$case === "text")
|
|
15
|
+
return content.value;
|
|
16
|
+
if (content.$case === "raw")
|
|
17
|
+
return content.value.toString("utf8");
|
|
18
|
+
return "";
|
|
19
|
+
}
|
|
20
|
+
export function createTextMessage(text, options) {
|
|
21
|
+
const role = options?.role === "agent" ? 2 : 1;
|
|
22
|
+
return {
|
|
23
|
+
role,
|
|
24
|
+
messageId: crypto.randomUUID(),
|
|
25
|
+
parts: [
|
|
26
|
+
{
|
|
27
|
+
content: { $case: "text", value: text },
|
|
28
|
+
metadata: undefined,
|
|
29
|
+
filename: "",
|
|
30
|
+
mediaType: "text/plain",
|
|
31
|
+
},
|
|
32
|
+
],
|
|
33
|
+
taskId: options?.taskId ?? "",
|
|
34
|
+
contextId: options?.contextId ?? "",
|
|
35
|
+
extensions: [],
|
|
36
|
+
metadata: {},
|
|
37
|
+
referenceTaskIds: [],
|
|
38
|
+
};
|
|
39
|
+
}
|
|
40
|
+
//# sourceMappingURL=message.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"message.js","sourceRoot":"","sources":["../src/message.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,sBAAsB,CAAC,OAA4B,EAAU;IAC5E,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;AAAA,CACT;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAU,EAAU;IACvD,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;AAAA,CACV;AAED,MAAM,UAAU,iBAAiB,CAChC,IAAY,EACZ,OAA0E,EAChE;IACV,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;AAAA,CACF","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
ADDED
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import { DefaultRequestHandler } from "@a2a-js/sdk/server";
|
|
2
|
+
import type { Express } from "express";
|
|
3
|
+
import { type HarnessPromptRunnerFactory } from "./executor.ts";
|
|
4
|
+
export interface CreateA2aServerOptions {
|
|
5
|
+
baseUrl: string;
|
|
6
|
+
runnerFactory: HarnessPromptRunnerFactory;
|
|
7
|
+
name?: string;
|
|
8
|
+
description?: string;
|
|
9
|
+
}
|
|
10
|
+
export interface A2aServer {
|
|
11
|
+
app: Express;
|
|
12
|
+
requestHandler: DefaultRequestHandler;
|
|
13
|
+
listen(port: number, host?: string): Promise<void>;
|
|
14
|
+
close(): Promise<void>;
|
|
15
|
+
}
|
|
16
|
+
export declare function createA2aServer(options: CreateA2aServerOptions): Promise<A2aServer>;
|
|
17
|
+
//# sourceMappingURL=server.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AACA,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;AAEtF,MAAM,WAAW,sBAAsB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,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,CAAC;IACtC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,SAAS,CAAC,CAsCzF","sourcesContent":["import { 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\";\n\nexport interface CreateA2aServerOptions {\n\tbaseUrl: string;\n\trunnerFactory: HarnessPromptRunnerFactory;\n\tname?: string;\n\tdescription?: string;\n}\n\nexport interface A2aServer {\n\tapp: Express;\n\trequestHandler: DefaultRequestHandler;\n\tlisten(port: number, host?: string): Promise<void>;\n\tclose(): Promise<void>;\n}\n\nexport async function createA2aServer(options: CreateA2aServerOptions): Promise<A2aServer> {\n\tconst agentCard = createPunchAgentCard({\n\t\tbaseUrl: options.baseUrl,\n\t\tname: options.name,\n\t\tdescription: options.description,\n\t});\n\tconst taskStore = new InMemoryTaskStore();\n\tconst agentExecutor = new HarnessAgentExecutor(options.runnerFactory);\n\tconst requestHandler = new DefaultRequestHandler(agentCard, taskStore, agentExecutor);\n\tconst app = express();\n\tapp.use(`/${AGENT_CARD_PATH}`, agentCardHandler({ agentCardProvider: requestHandler }));\n\tapp.use(jsonRpcHandler({ requestHandler, userBuilder: UserBuilder.noAuthentication }));\n\n\tlet server: ReturnType<Express[\"listen\"]> | undefined;\n\treturn {\n\t\tapp,\n\t\trequestHandler,\n\t\tlisten(port, 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) reject(error);\n\t\t\t\t\telse resolve();\n\t\t\t\t});\n\t\t\t});\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\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 resolve();\n\t\t\t\t});\n\t\t\t});\n\t\t},\n\t};\n}\n"]}
|
package/dist/server.js
ADDED
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
import { AGENT_CARD_PATH } from "@a2a-js/sdk";
|
|
2
|
+
import { DefaultRequestHandler, InMemoryTaskStore } from "@a2a-js/sdk/server";
|
|
3
|
+
import { agentCardHandler, jsonRpcHandler, UserBuilder } from "@a2a-js/sdk/server/express";
|
|
4
|
+
import express from "express";
|
|
5
|
+
import { createPunchAgentCard } from "./agent-card.js";
|
|
6
|
+
import { HarnessAgentExecutor } from "./executor.js";
|
|
7
|
+
export async function createA2aServer(options) {
|
|
8
|
+
const agentCard = createPunchAgentCard({
|
|
9
|
+
baseUrl: options.baseUrl,
|
|
10
|
+
name: options.name,
|
|
11
|
+
description: options.description,
|
|
12
|
+
});
|
|
13
|
+
const taskStore = new InMemoryTaskStore();
|
|
14
|
+
const agentExecutor = new HarnessAgentExecutor(options.runnerFactory);
|
|
15
|
+
const requestHandler = new DefaultRequestHandler(agentCard, taskStore, agentExecutor);
|
|
16
|
+
const app = express();
|
|
17
|
+
app.use(`/${AGENT_CARD_PATH}`, agentCardHandler({ agentCardProvider: requestHandler }));
|
|
18
|
+
app.use(jsonRpcHandler({ requestHandler, userBuilder: UserBuilder.noAuthentication }));
|
|
19
|
+
let server;
|
|
20
|
+
return {
|
|
21
|
+
app,
|
|
22
|
+
requestHandler,
|
|
23
|
+
listen(port, host = "127.0.0.1") {
|
|
24
|
+
return new Promise((resolve, reject) => {
|
|
25
|
+
server = app.listen(port, host, (error) => {
|
|
26
|
+
if (error)
|
|
27
|
+
reject(error);
|
|
28
|
+
else
|
|
29
|
+
resolve();
|
|
30
|
+
});
|
|
31
|
+
});
|
|
32
|
+
},
|
|
33
|
+
close() {
|
|
34
|
+
return new Promise((resolve, reject) => {
|
|
35
|
+
if (!server) {
|
|
36
|
+
resolve();
|
|
37
|
+
return;
|
|
38
|
+
}
|
|
39
|
+
server.close((error) => {
|
|
40
|
+
if (error)
|
|
41
|
+
reject(error);
|
|
42
|
+
else
|
|
43
|
+
resolve();
|
|
44
|
+
});
|
|
45
|
+
});
|
|
46
|
+
},
|
|
47
|
+
};
|
|
48
|
+
}
|
|
49
|
+
//# sourceMappingURL=server.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE3F,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAmC,MAAM,eAAe,CAAC;AAgBtF,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAA+B,EAAsB;IAC1F,MAAM,SAAS,GAAG,oBAAoB,CAAC;QACtC,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,WAAW,EAAE,OAAO,CAAC,WAAW;KAChC,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,IAAI,iBAAiB,EAAE,CAAC;IAC1C,MAAM,aAAa,GAAG,IAAI,oBAAoB,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IACtE,MAAM,cAAc,GAAG,IAAI,qBAAqB,CAAC,SAAS,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;IACtF,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IACtB,GAAG,CAAC,GAAG,CAAC,IAAI,eAAe,EAAE,EAAE,gBAAgB,CAAC,EAAE,iBAAiB,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC;IACxF,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC;IAEvF,IAAI,MAAiD,CAAC;IACtD,OAAO;QACN,GAAG;QACH,cAAc;QACd,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,WAAW,EAAE;YAChC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC;gBACvC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC;oBAClD,IAAI,KAAK;wBAAE,MAAM,CAAC,KAAK,CAAC,CAAC;;wBACpB,OAAO,EAAE,CAAC;gBAAA,CACf,CAAC,CAAC;YAAA,CACH,CAAC,CAAC;QAAA,CACH;QACD,KAAK,GAAG;YACP,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC;gBACvC,IAAI,CAAC,MAAM,EAAE,CAAC;oBACb,OAAO,EAAE,CAAC;oBACV,OAAO;gBACR,CAAC;gBACD,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;oBACvB,IAAI,KAAK;wBAAE,MAAM,CAAC,KAAK,CAAC,CAAC;;wBACpB,OAAO,EAAE,CAAC;gBAAA,CACf,CAAC,CAAC;YAAA,CACH,CAAC,CAAC;QAAA,CACH;KACD,CAAC;AAAA,CACF","sourcesContent":["import { 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\";\n\nexport interface CreateA2aServerOptions {\n\tbaseUrl: string;\n\trunnerFactory: HarnessPromptRunnerFactory;\n\tname?: string;\n\tdescription?: string;\n}\n\nexport interface A2aServer {\n\tapp: Express;\n\trequestHandler: DefaultRequestHandler;\n\tlisten(port: number, host?: string): Promise<void>;\n\tclose(): Promise<void>;\n}\n\nexport async function createA2aServer(options: CreateA2aServerOptions): Promise<A2aServer> {\n\tconst agentCard = createPunchAgentCard({\n\t\tbaseUrl: options.baseUrl,\n\t\tname: options.name,\n\t\tdescription: options.description,\n\t});\n\tconst taskStore = new InMemoryTaskStore();\n\tconst agentExecutor = new HarnessAgentExecutor(options.runnerFactory);\n\tconst requestHandler = new DefaultRequestHandler(agentCard, taskStore, agentExecutor);\n\tconst app = express();\n\tapp.use(`/${AGENT_CARD_PATH}`, agentCardHandler({ agentCardProvider: requestHandler }));\n\tapp.use(jsonRpcHandler({ requestHandler, userBuilder: UserBuilder.noAuthentication }));\n\n\tlet server: ReturnType<Express[\"listen\"]> | undefined;\n\treturn {\n\t\tapp,\n\t\trequestHandler,\n\t\tlisten(port, 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) reject(error);\n\t\t\t\t\telse resolve();\n\t\t\t\t});\n\t\t\t});\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\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 resolve();\n\t\t\t\t});\n\t\t\t});\n\t\t},\n\t};\n}\n"]}
|
package/package.json
ADDED
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@punch-bot/a2a",
|
|
3
|
+
"version": "0.85.1",
|
|
4
|
+
"description": "Agent2Agent (A2A) protocol integration for punch agents",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"main": "./dist/index.js",
|
|
7
|
+
"types": "./dist/index.d.ts",
|
|
8
|
+
"exports": {
|
|
9
|
+
".": {
|
|
10
|
+
"types": "./dist/index.d.ts",
|
|
11
|
+
"import": "./dist/index.js"
|
|
12
|
+
}
|
|
13
|
+
},
|
|
14
|
+
"files": [
|
|
15
|
+
"dist",
|
|
16
|
+
"README.md",
|
|
17
|
+
"CHANGELOG.md"
|
|
18
|
+
],
|
|
19
|
+
"scripts": {
|
|
20
|
+
"clean": "shx rm -rf dist",
|
|
21
|
+
"build": "tsgo -p tsconfig.build.json",
|
|
22
|
+
"test": "vitest --run",
|
|
23
|
+
"typecheck": "tsgo -p tsconfig.test.json",
|
|
24
|
+
"prepublishOnly": "npm run clean && npm run build"
|
|
25
|
+
},
|
|
26
|
+
"keywords": [
|
|
27
|
+
"pi",
|
|
28
|
+
"punch",
|
|
29
|
+
"a2a",
|
|
30
|
+
"agent2agent"
|
|
31
|
+
],
|
|
32
|
+
"author": "Earendil Works",
|
|
33
|
+
"license": "MIT",
|
|
34
|
+
"repository": {
|
|
35
|
+
"type": "git",
|
|
36
|
+
"url": "git+https://github.com/punch-bot/core.git",
|
|
37
|
+
"directory": "packages/a2a"
|
|
38
|
+
},
|
|
39
|
+
"engines": {
|
|
40
|
+
"node": ">=22.19.0"
|
|
41
|
+
},
|
|
42
|
+
"dependencies": {
|
|
43
|
+
"@a2a-js/sdk": "1.0.1",
|
|
44
|
+
"express": "5.1.0"
|
|
45
|
+
},
|
|
46
|
+
"devDependencies": {
|
|
47
|
+
"@types/express": "5.0.3",
|
|
48
|
+
"shx": "0.4.0",
|
|
49
|
+
"vitest": "5.0.0"
|
|
50
|
+
}
|
|
51
|
+
}
|