@artinet/sdk 0.5.8 → 0.5.10
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/README.md +34 -32
- package/dist/services/a2a/factory/builder.js +2 -2
- package/dist/services/a2a/factory/builder.js.map +1 -1
- package/dist/services/a2a/helpers/content.d.ts +12 -0
- package/dist/services/a2a/helpers/content.d.ts.map +1 -0
- package/dist/services/a2a/helpers/content.js +18 -0
- package/dist/services/a2a/helpers/content.js.map +1 -0
- package/dist/types/interfaces/services/a2a/builder.d.ts +1 -1
- package/dist/types/interfaces/services/a2a/builder.d.ts.map +1 -1
- package/package.json +6 -7
package/README.md
CHANGED
|
@@ -1,8 +1,10 @@
|
|
|
1
|
-
[](https://artinet.io/)
|
|
2
|
+
[](https://www.npmjs.com/package/@artinet/sdk)
|
|
2
3
|
[](https://www.npmjs.com/package/@artinet/sdk)
|
|
3
4
|
[](LICENSE)
|
|
4
5
|
[](https://snyk.io/test/npm/@artinet/sdk)
|
|
5
|
-
|
|
6
|
+
[](https://github.com/the-artinet-project/artinet-sdk/stargazers)
|
|
7
|
+
[](https://dcbadge.limes.pink/api/server/DaxzSchmmX?style=flat)
|
|
6
8
|
<!-- [](https://coveralls.io/github/the-artinet-project/artinet-sdk?branch=main) -->
|
|
7
9
|
|
|
8
10
|
# artinet SDK
|
|
@@ -11,9 +13,20 @@ The artinet SDK is a TypeScript library designed for Agentic Communication. It's
|
|
|
11
13
|
|
|
12
14
|
This SDK leverages a service-oriented architecture for building AI agents allowing developers to easily create agents as simple processes or seamlessly embed them within a dedicated server.
|
|
13
15
|
|
|
16
|
+
## Quick Start
|
|
17
|
+
|
|
18
|
+
Use the [`create-agent`](https://www.npmjs.com/package/@artinet/create-agent) command:
|
|
19
|
+
|
|
20
|
+
```bash
|
|
21
|
+
npx @artinet/create-agent@latest
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
It has [serveral template projects](https://github.com/the-artinet-project/create-agent/tree/main/templates) that you can use to jump right into agent building.
|
|
25
|
+
|
|
14
26
|
## Table of Contents
|
|
15
27
|
|
|
16
28
|
- [artinet SDK](#artinet-sdk)
|
|
29
|
+
- [Quick Start](#quick-start)
|
|
17
30
|
- [Table of Contents](#table-of-contents)
|
|
18
31
|
- [Features](#features)
|
|
19
32
|
- [Installation](#installation)
|
|
@@ -38,18 +51,21 @@ This SDK leverages a service-oriented architecture for building AI agents allowi
|
|
|
38
51
|
- [Acknowledgements](#acknowledgements)
|
|
39
52
|
|
|
40
53
|
**Breaking Changes in v0.5.8**
|
|
41
|
-
|
|
54
|
+
|
|
55
|
+
- Pino has been removed and replaced with console for better portability and is set to silent by default.
|
|
42
56
|
- The default handler for streamMessage no longer automatically emits an initial `submitted` and `working` event.
|
|
43
57
|
- Agent Registration, Bundling and Deployment utils have been removed (email us: humans@artinet.io for support).
|
|
44
58
|
- `@artinet/metadata-validator` has been removed due to build issues.
|
|
45
59
|
- getTask now correctly takes TaskQueryParams as an argument vs TaskIdParams in accordance with the A2A spec.
|
|
46
60
|
- AgentBuilder now returns a unique messageId for each status update instead of the original user provided messageId.
|
|
47
|
-
-
|
|
61
|
+
- AgentBuilder now prefers the contextId & taskId from the calling context.
|
|
62
|
+
- In a future release the following packages will be set as peer dependancies to reduce the size of the build: `@modelcontextprotocol/sdk`, `@trpc/server`, `cors`, `express`
|
|
48
63
|
|
|
49
64
|
## Features
|
|
50
65
|
|
|
51
|
-
- **Modular Design:** Everything you need to get started building collaborative agents
|
|
52
|
-
- **Express
|
|
66
|
+
- **Modular Design:** Everything you need to get started building collaborative agents while remaining flexible enough for advanced configuration.
|
|
67
|
+
- **Express Style Agent API:** Similar to scaffolding an Express Server, you can use the AgentBuilder to create an Agent2Agent API.
|
|
68
|
+
- Then wrap it in an actual Express Server with the `createAgentServer()` function. It handles all of the transport-layer complexity, adds A2A <-> JSON-RPC middleware, and manages Server-Sent Events (SSE) automatically.
|
|
53
69
|
- **Protocol Compliance:** Implements the complete A2A specification (v0.3.0) with support for any kind of transport layer (tRPC, WebSockets, etc).
|
|
54
70
|
|
|
55
71
|
## Installation
|
|
@@ -61,7 +77,8 @@ npm install @artinet/sdk
|
|
|
61
77
|
## Requirements
|
|
62
78
|
|
|
63
79
|
- Node.js (v22.0.0 or higher recommended)
|
|
64
|
-
<!--
|
|
80
|
+
<!--
|
|
81
|
+
|
|
65
82
|
## Documentation
|
|
66
83
|
|
|
67
84
|
For more detailed documentation visit our documentation site [here](https://the-artinet-project.github.io/artinet-documentation/). -->
|
|
@@ -75,39 +92,24 @@ A basic A2A server and client interaction (For simple agents see the [AgentBuild
|
|
|
75
92
|
```typescript
|
|
76
93
|
import {
|
|
77
94
|
createAgentServer,
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
TaskManager,
|
|
81
|
-
MessageSendParams,
|
|
82
|
-
getParts,
|
|
95
|
+
AgentBuilder,
|
|
96
|
+
getContent,
|
|
83
97
|
} from "@artinet/sdk";
|
|
84
98
|
|
|
85
99
|
//Define your Agents Behaviour
|
|
86
|
-
const
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
const task = context.State(); //TaskAndHistory
|
|
90
|
-
yield {
|
|
91
|
-
...
|
|
92
|
-
state: "working"
|
|
93
|
-
...
|
|
94
|
-
};
|
|
95
|
-
|
|
96
|
-
yield {
|
|
100
|
+
const quickAgentEngine: AgentEngine = AgentBuilder()
|
|
101
|
+
.text(async ({ command, context }) => {
|
|
102
|
+
const task = context.State();
|
|
97
103
|
...
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
},
|
|
103
|
-
...
|
|
104
|
-
};
|
|
105
|
-
};
|
|
104
|
+
const userInput = getContent(command.message);
|
|
105
|
+
return `You said: ${userInput}`;
|
|
106
|
+
})
|
|
107
|
+
.createAgentEngine();
|
|
106
108
|
|
|
107
109
|
// Create an agent server
|
|
108
110
|
const { app, agent } = createAgentServer({
|
|
109
111
|
agent: {
|
|
110
|
-
engine:
|
|
112
|
+
engine: quickAgentEngine,
|
|
111
113
|
agentCard: {
|
|
112
114
|
name: "QuickStart Agent",
|
|
113
115
|
url: "http://localhost:4000/a2a",
|
|
@@ -284,8 +284,8 @@ export function createAgentExecutor(stepsList) {
|
|
|
284
284
|
context: context,
|
|
285
285
|
args: [],
|
|
286
286
|
};
|
|
287
|
-
const contextId = context.command.message.contextId;
|
|
288
|
-
const taskId = context.command.message.taskId;
|
|
287
|
+
const contextId = context.contextId ?? context.command.message.contextId;
|
|
288
|
+
const taskId = context.State().task.id ?? context.command.message.taskId;
|
|
289
289
|
if (!contextId || !taskId) {
|
|
290
290
|
throw new Error("Context ID and task ID are required");
|
|
291
291
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../../../src/services/a2a/factory/builder.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../../../src/services/a2a/factory/builder.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Copyright 2025 The Artinet Project
|
|
3
|
+
* SPDX-License-Identifier: Apache-2.0
|
|
4
|
+
*/
|
|
5
|
+
import { UpdateEvent } from "../../../types/index.js";
|
|
6
|
+
/**
|
|
7
|
+
* Extracts the content of an agent response.
|
|
8
|
+
* @param input - The input event.
|
|
9
|
+
* @returns The content of the input event.
|
|
10
|
+
*/
|
|
11
|
+
export declare function getContent(input: UpdateEvent): string | undefined;
|
|
12
|
+
//# sourceMappingURL=content.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../../../src/services/a2a/helpers/content.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAKL,WAAW,EACZ,gCAAyB;AAG1B;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAcjE"}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import { getParts } from "./part.js";
|
|
2
|
+
/**
|
|
3
|
+
* Extracts the content of an agent response.
|
|
4
|
+
* @param input - The input event.
|
|
5
|
+
* @returns The content of the input event.
|
|
6
|
+
*/
|
|
7
|
+
export function getContent(input) {
|
|
8
|
+
const parts = getParts(input?.parts ??
|
|
9
|
+
input?.status?.message?.parts ??
|
|
10
|
+
input?.status?.message?.parts ??
|
|
11
|
+
input?.artifact?.parts ??
|
|
12
|
+
[]);
|
|
13
|
+
return (parts.text ??
|
|
14
|
+
parts.file.map((file) => file.bytes).join("\n") ??
|
|
15
|
+
parts.data.map((data) => JSON.stringify(data)).join("\n") ??
|
|
16
|
+
undefined);
|
|
17
|
+
}
|
|
18
|
+
//# sourceMappingURL=content.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"content.js","sourceRoot":"","sources":["../../../../src/services/a2a/helpers/content.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,KAAkB;IAC3C,MAAM,KAAK,GAAG,QAAQ,CACnB,KAAiB,EAAE,KAAK;QACtB,KAAc,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK;QACtC,KAA+B,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK;QACvD,KAAiC,EAAE,QAAQ,EAAE,KAAK;QACnD,EAAE,CACL,CAAC;IACF,OAAO,CACL,KAAK,CAAC,IAAI;QACV,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAC/C,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACzD,SAAS,CACV,CAAC;AACJ,CAAC"}
|
|
@@ -9,9 +9,9 @@ import { Context, Command, TextPart, DataPart, FilePart } from "../../../index.j
|
|
|
9
9
|
*/
|
|
10
10
|
export interface StepArgs<TCommand extends Command = Command> {
|
|
11
11
|
command: TCommand;
|
|
12
|
+
context: Context;
|
|
12
13
|
}
|
|
13
14
|
export type StepParams<TCommand extends Command = Command, TInboundArgs extends readonly unknown[] = []> = StepArgs<TCommand> & Partial<{
|
|
14
|
-
context: Context;
|
|
15
15
|
args: TInboundArgs;
|
|
16
16
|
}>;
|
|
17
17
|
export type StepOutput<TPart extends DataPart["data"] | FilePart["file"] | TextPart["text"]> = {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../../../../src/types/interfaces/services/a2a/builder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,OAAO,EACP,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,QAAQ,EACT,0BAAyB;AAE1B;;;GAGG;AACH,MAAM,WAAW,QAAQ,CAAC,QAAQ,SAAS,OAAO,GAAG,OAAO;IAC1D,OAAO,EAAE,QAAQ,CAAC;
|
|
1
|
+
{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../../../../src/types/interfaces/services/a2a/builder.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@artinet/sdk",
|
|
3
|
-
"version": "0.5.
|
|
3
|
+
"version": "0.5.10",
|
|
4
4
|
"description": "A TypeScript SDK for building collaborative AI agents.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./dist/index.js",
|
|
@@ -69,17 +69,16 @@
|
|
|
69
69
|
"eventsource-parser": "^3.0.1",
|
|
70
70
|
"express": "^5.1.0",
|
|
71
71
|
"uuid": "^11.1.0",
|
|
72
|
-
"zod": "^3.23.8"
|
|
72
|
+
"zod": "^3.23.8",
|
|
73
|
+
"@types/cors": "^2.8.17",
|
|
74
|
+
"@types/escape-html": "^1.0.4",
|
|
75
|
+
"@types/express": "^5.0.1"
|
|
73
76
|
},
|
|
74
77
|
"devDependencies": {
|
|
78
|
+
"@types/node": "^20.17.50",
|
|
75
79
|
"@eslint/js": "^9.25.1",
|
|
76
|
-
"@types/cors": "^2.8.17",
|
|
77
|
-
"@types/escape-html": "^1.0.4",
|
|
78
|
-
"@types/express": "^5.0.1",
|
|
79
80
|
"@types/jest": "^29.5.14",
|
|
80
|
-
"@types/node": "^20.17.50",
|
|
81
81
|
"@types/supertest": "latest",
|
|
82
|
-
"@types/uuid": "^9.0.6",
|
|
83
82
|
"eslint": "^9.25.1",
|
|
84
83
|
"globals": "^16.0.0",
|
|
85
84
|
"jest": "^29.7.0",
|