@artinet/sdk 0.5.9 → 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 CHANGED
@@ -1,8 +1,10 @@
1
- [![npm version](https://img.shields.io/npm/v/@artinet/sdk.svg)](https://www.npmjs.com/package/@artinet/sdk)
1
+ [![Website](https://img.shields.io/badge/website-artinet.io-black)](https://artinet.io/)
2
+ [![npm version](https://img.shields.io/npm/v/@artinet/sdk.svg?logoColor=black)](https://www.npmjs.com/package/@artinet/sdk)
2
3
  [![npm downloads](https://img.shields.io/npm/dt/@artinet/sdk.svg)](https://www.npmjs.com/package/@artinet/sdk)
3
4
  [![Apache License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)
4
5
  [![Known Vulnerabilities](https://snyk.io/test/npm/@artinet/sdk/badge.svg)](https://snyk.io/test/npm/@artinet/sdk)
5
-
6
+ [![GitHub stars](https://img.shields.io/github/stars/the-artinet-project/artinet-sdk?style=social)](https://github.com/the-artinet-project/artinet-sdk/stargazers)
7
+ [![Discord](https://dcbadge.limes.pink/api/server/DaxzSchmmX?style=flat)](https://dcbadge.limes.pink/api/server/DaxzSchmmX?style=flat)
6
8
  <!-- [![Coverage Status](https://coveralls.io/repos/github/the-artinet-project/artinet-sdk/badge.svg?branch=main)](https://coveralls.io/github/the-artinet-project/artinet-sdk?branch=main) -->
7
9
 
8
10
  # artinet SDK
@@ -13,7 +15,7 @@ This SDK leverages a service-oriented architecture for building AI agents allowi
13
15
 
14
16
  ## Quick Start
15
17
 
16
- Use the [`create-agent`](https://github.com/the-artinet-project/create-agent) command:
18
+ Use the [`create-agent`](https://www.npmjs.com/package/@artinet/create-agent) command:
17
19
 
18
20
  ```bash
19
21
  npx @artinet/create-agent@latest
@@ -49,18 +51,21 @@ It has [serveral template projects](https://github.com/the-artinet-project/creat
49
51
  - [Acknowledgements](#acknowledgements)
50
52
 
51
53
  **Breaking Changes in v0.5.8**
52
- - Pino has been removed and replaced with console for better portability and is set to silent by default.
54
+
55
+ - Pino has been removed and replaced with console for better portability and is set to silent by default.
53
56
  - The default handler for streamMessage no longer automatically emits an initial `submitted` and `working` event.
54
57
  - Agent Registration, Bundling and Deployment utils have been removed (email us: humans@artinet.io for support).
55
58
  - `@artinet/metadata-validator` has been removed due to build issues.
56
59
  - getTask now correctly takes TaskQueryParams as an argument vs TaskIdParams in accordance with the A2A spec.
57
60
  - AgentBuilder now returns a unique messageId for each status update instead of the original user provided messageId.
58
- - 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`
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`
59
63
 
60
64
  ## Features
61
65
 
62
- - **Modular Design:** Everything you need to get started building collaborative agents + its flexible enough for advanced configuration.
63
- - **Express:** Scaffold an 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.
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.
64
69
  - **Protocol Compliance:** Implements the complete A2A specification (v0.3.0) with support for any kind of transport layer (tRPC, WebSockets, etc).
65
70
 
66
71
  ## Installation
@@ -72,7 +77,8 @@ npm install @artinet/sdk
72
77
  ## Requirements
73
78
 
74
79
  - Node.js (v22.0.0 or higher recommended)
75
- <!--
80
+ <!--
81
+
76
82
  ## Documentation
77
83
 
78
84
  For more detailed documentation visit our documentation site [here](https://the-artinet-project.github.io/artinet-documentation/). -->
@@ -86,39 +92,24 @@ A basic A2A server and client interaction (For simple agents see the [AgentBuild
86
92
  ```typescript
87
93
  import {
88
94
  createAgentServer,
89
- ExecutionContext,
90
- AgentEngine,
91
- TaskManager,
92
- MessageSendParams,
93
- getParts,
95
+ AgentBuilder,
96
+ getContent,
94
97
  } from "@artinet/sdk";
95
98
 
96
99
  //Define your Agents Behaviour
97
- const quickAgentLogic: AgentEngine = async function* (context: Context) {
98
- const params: MessageSendParams = context.command; //MessageSendParams
99
- const { text: userInput} = getParts(params.message.parts); //helper function to consume parts
100
- const task = context.State(); //TaskAndHistory
101
- yield {
102
- ...
103
- state: "working"
104
- ...
105
- };
106
-
107
- yield {
108
- ...
109
- state: "completed",
110
- message: {
111
- role: "agent",
112
- parts: [{ kind: "text", text: `You said: ${userInput}` }],
113
- },
100
+ const quickAgentEngine: AgentEngine = AgentBuilder()
101
+ .text(async ({ command, context }) => {
102
+ const task = context.State();
114
103
  ...
115
- };
116
- };
104
+ const userInput = getContent(command.message);
105
+ return `You said: ${userInput}`;
106
+ })
107
+ .createAgentEngine();
117
108
 
118
109
  // Create an agent server
119
110
  const { app, agent } = createAgentServer({
120
111
  agent: {
121
- engine: quickAgentLogic,
112
+ engine: quickAgentEngine,
122
113
  agentCard: {
123
114
  name: "QuickStart Agent",
124
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":"AAAA;;;GAGG;AAEH;;;;;;;;;;;GAWG;AAEH,OAAO,EAWL,SAAS,GASV,gCAAyB;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,EAAE,IAAI,MAAM,EAAE,MAAM,MAAM,CAAC;AAkIpC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,OAAO,aAAa;IAKxB,oCAAoC;IAC5B,KAAK,GAA2D,EAAE,CAAC;IAE3E;;;;OAIG;IACH;IACE,oCAAoC;IACpC,QAAgE,EAAE;QAElE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED;;;;;;;;;;;OAWG;IACI,MAAM,CAAC,MAAM;QAIlB,OAAO,IAAI,aAAa,EAA0B,CAAC;IACrD,CAAC;IAED,OAAO,CAaL,IAOC;QAED,OAAO,IAAI,aAAa,CAA+B;YACrD,GAAG,IAAI,CAAC,KAAK;YACb,IAAI;SACL,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACI,IAAI,CAQT,IAAoE;QACpE,OAAO,IAAI,CAAC,OAAO,CAAuC;YACxD,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,MAAM;SACb,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACI,IAAI,CAQT,IAAoE;QACpE,OAAO,IAAI,CAAC,OAAO,CAAuC;YACxD,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,MAAM;SACb,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACI,IAAI,CAQT,IAAoE;QACpE,OAAO,IAAI,CAAC,OAAO,CAAuC;YACxD,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,MAAM;SACb,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACI,WAAW,CAAC,MAAqC;QACtD,OAAO,WAAW,CAAC;YACjB,GAAG,MAAM;YACT,MAAM,EAAE,IAAI,CAAC,iBAAiB,EAAE;SACjC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;OAUG;IACI,iBAAiB;QACtB,OAAO,mBAAmB,CAAC,IAAI,CAAC,KAAK,EAA6B,CAAC,CAAC;IACtE,CAAC;IAED;;;;;;;;;;OAUG;IACI,KAAK;QACV,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,EAAE,CAAC,aAAa,CAAC,MAAM,EAAqB,CAAC;AAE5E,MAAM,iBAAiB,GAAG,CACxB,IAA8B,EAC9B,IAA4D,EAC5B,EAAE;IAClC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAwB,EAAE,CAAC;QAC1D,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,QAAQ,GAAqB,IAAwB,CAAC;YAC5D,OAAO,QAAQ,CAAC,GAAG;gBACjB,CAAC,CAAC;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;wBACJ,GAAG,EAAE,QAAQ,CAAC,GAAG;wBACjB,IAAI,EAAE,QAAQ,CAAC,IAAI;wBACnB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;qBAC5B;iBACF;gBACH,CAAC,CAAC;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;wBACJ,KAAK,EAAE,QAAQ,CAAC,KAAK,IAAI,EAAE;wBAC3B,IAAI,EAAE,QAAQ,CAAC,IAAI;wBACnB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;qBAC5B;iBACF,CAAC;QACR,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAwB,EAAE,CAAC;QAC1D,CAAC;QACD;YACE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACzC,CAAC;AACH,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAAyB;IAC3D,OAAO,KAAK,SAAS,CAAC,EAAE,OAAgB;QACtC,MAAM,QAAQ,GAAe;YAC3B,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,OAAO,EAAE,OAAO;YAChB,IAAI,EAAE,EAAE;SACT,CAAC;QAEF,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC;QACzE,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;QAEzE,IAAI,CAAC,SAAS,IAAI,CAAC,MAAM,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACzD,CAAC;QACD,MAAM,WAAW,GAA0B;YACzC,MAAM,EAAE,MAAM;YACd,SAAS,EAAE,SAAS;YACpB,IAAI,EAAE,eAAe;YACrB,MAAM,EAAE;gBACN,KAAK,EAAE,SAAS,CAAC,SAAS;gBAC1B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;YACD,KAAK,EAAE,KAAK;SACb,CAAC;QACF,MAAM,WAAW,CAAC;QAClB,MAAM,YAAY,GAAY;YAC5B,MAAM,EAAE,MAAM;YACd,SAAS,EAAE,SAAS;YACpB,SAAS,EAAE,MAAM,EAAE;YACnB,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,EAAE;SACV,CAAC;QACF,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC7B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC;YAC7C,IAAI,KAAK,GAAW,EAAE,CAAC;YACvB,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBACvB,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;gBAC9D,MAAM,gBAAgB,GAA0B;oBAC9C,MAAM,EAAE,MAAM;oBACd,SAAS,EAAE,SAAS;oBACpB,IAAI,EAAE,eAAe;oBACrB,MAAM,EAAE;wBACN,KAAK,EAAE,SAAS,CAAC,OAAO;wBACxB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;wBACnC,OAAO,EAAE;4BACP,SAAS,EAAE,MAAM,EAAE;4BACnB,IAAI,EAAE,SAAS;4BACf,IAAI,EAAE,OAAO;4BACb,KAAK,EAAE,KAAK;yBACb;qBACF;oBACD,KAAK,EAAE,KAAK;iBACb,CAAC;gBACF,MAAM,gBAAgB,CAAC;YACzB,CAAC;iBAAM,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;gBACnC,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;oBAC9B,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;oBAC7D,CAAC,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC9C,MAAM,gBAAgB,GAA0B;oBAC9C,MAAM,EAAE,MAAM;oBACd,SAAS,EAAE,SAAS;oBACpB,IAAI,EAAE,eAAe;oBACrB,MAAM,EAAE;wBACN,KAAK,EAAE,SAAS,CAAC,OAAO;wBACxB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;wBACnC,OAAO,EAAE;4BACP,SAAS,EAAE,MAAM,EAAE;4BACnB,IAAI,EAAE,SAAS;4BACf,IAAI,EAAE,OAAO;4BACb,KAAK,EAAE,KAAK;yBACb;qBACF;oBACD,KAAK,EAAE,KAAK;iBACb,CAAC;gBACF,MAAM,gBAAgB,CAAC;gBACvB,QAAQ,CAAC,IAAI,GAAI,GAA2C,CAAC,IAAI,CAAC;YACpE,CAAC;iBAAM,CAAC;gBACN,KAAK,GAAG,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;gBAC5C,MAAM,gBAAgB,GAA0B;oBAC9C,MAAM,EAAE,MAAM;oBACd,SAAS,EAAE,SAAS;oBACpB,IAAI,EAAE,eAAe;oBACrB,MAAM,EAAE;wBACN,KAAK,EAAE,SAAS,CAAC,OAAO;wBACxB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;wBACnC,OAAO,EAAE;4BACP,SAAS,EAAE,MAAM,EAAE;4BACnB,IAAI,EAAE,SAAS;4BACf,IAAI,EAAE,OAAO;4BACb,KAAK,EAAE,KAAK;yBACb;qBACF;oBACD,KAAK,EAAE,KAAK;iBACb,CAAC;gBACF,MAAM,gBAAgB,CAAC;YACzB,CAAC;YACD,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;QACpC,CAAC;QACD,MAAM,IAAI,GAAS;YACjB,IAAI,EAAE,MAAM;YACZ,EAAE,EAAE,MAAM;YACV,SAAS,EAAE,SAAS;YACpB,MAAM,EAAE;gBACN,KAAK,EAAE,SAAS,CAAC,SAAS;gBAC1B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,OAAO,EAAE,YAAY;aACtB;SACF,CAAC;QACF,MAAM,IAAI,CAAC;IACb,CAAC,CAAC;AACJ,CAAC"}
@@ -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":"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"}
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.9",
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",