@artinet/sdk 0.5.0 → 0.5.2

package/dist/types/types/proxy.d.ts

@@ -0,0 +1,93 @@
+import { TaskYieldUpdate } from "./extended-schema.js";
+import { TaskHandler } from "./context.js";
+import { Client } from "./client.js";
+/**
+ * Represents a proxy function for sending task yield updates.
+ * This function is typically provided by the host environment to allow
+ * an agent to communicate updates about its task execution.
+ * @param taskYieldUpdate - The update object yielded by the task.
+ * @returns A promise that resolves when the update has been processed.
+ */
+export type TaskProxy = (taskYieldUpdate: TaskYieldUpdate) => Promise<void>;
+/**
+ * Properties for the TaskManager function.
+ */
+export interface TaskManagerProps {
+    /**
+     * The core task-handling generator function of an agent.
+     * This function takes a `TaskContext` and yields `TaskYieldUpdate` objects,
+     * eventually returning a `Task` or void.
+     */
+    taskHandler: TaskHandler;
+}
+/**
+ * Defines the signature for a TaskManager function.
+ * A TaskManager is responsible for orchestrating the execution of an agent's task,
+ * typically by interfacing with a host environment.
+ * @param props - The properties for the task manager, including the taskHandler.
+ * @returns A promise that resolves when the task handler has completed.
+ */
+export type TaskManager = (props: TaskManagerProps) => Promise<void>;
+/**
+ * Properties for the Connect function.
+ * These properties are used when an agent needs to establish a connection
+ * or send a request to another agent or an external service (e.g., an LLM).
+ */
+export interface ConnectProps {
+    /**
+     * The identifier of the target agent or LLM to which the request is directed.
+     */
+    agentId: string;
+    /**
+     * An array of messages forming the conversation history or prompt.
+     * Each message should have a `role` (e.g., "user", "assistant") and `content`.
+     */
+    messages: {
+        role: string;
+        content: string;
+    }[];
+}
+/**
+ * Defines the signature for a Connect function.
+ * This function is used by agents to make external calls, such as to LLMs or other agents,
+ * often proxied by a host environment.
+ * @param props - The properties for the connect call, including agentID and messages.
+ * @returns A promise that resolves to a string, which could be a response from the
+ *          target or a connection identifier.
+ */
+export type ConnectAPICallback = (props: ConnectProps) => Promise<string>;
+/**
+ * Represents a proxy for a client, providing a subset of `Client` functionalities.
+ * This interface omits methods related to direct task management and header manipulation,
+ * focusing on core interaction capabilities suitable for a proxied environment.
+ */
+export interface ClientProxy extends Omit<Client, "sendTaskSubscribe" | "getTask" | "cancelTask" | "getTaskPushNotification" | "setTaskPushNotification" | "resubscribeTask" | "refreshAgentCard" | "setHeaders" | "addHeader" | "removeHeader" | "clearHeaders"> {
+}
+/**
+ * Properties for the ClientFactory function.
+ * These properties are used to configure and create a `ClientProxy` instance.
+ */
+export interface ClientProps {
+    /**
+     * The base URL for the client to connect to.
+     * Can be a URL object or a string.
+     */
+    baseUrl: URL | string;
+    /**
+     * Optional record of headers to be included in client requests.
+     */
+    headers?: Record<string, string>;
+    /**
+     * Optional fallback path for client requests.
+     */
+    fallbackPath?: string;
+}
+/**
+ * Defines the signature for a ClientFactory function.
+ * A ClientFactory is responsible for creating `ClientProxy` instances,
+ * allowing agents to interact with services or other agents.
+ * @param props - The properties required to configure the client.
+ * @returns A `ClientProxy` instance.
+ */
+export type ClientFactory = (props: ClientProps) => ClientProxy;
+//# sourceMappingURL=proxy.d.ts.map

package/dist/types/types/proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../../../src/types/proxy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,eAAe,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE5E;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAErE;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC/C;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAE1E;;;;GAIG;AAEH,MAAM,WAAW,WACf,SAAQ,IAAI,CACV,MAAM,EACJ,mBAAmB,GACnB,SAAS,GACT,YAAY,GACZ,yBAAyB,GACzB,yBAAyB,GACzB,iBAAiB,GACjB,kBAAkB,GAClB,YAAY,GACZ,WAAW,GACX,cAAc,GACd,cAAc,CACjB;CAAG;AAEN;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,OAAO,EAAE,GAAG,GAAG,MAAM,CAAC;IACtB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,WAAW,CAAC"}

package/dist/types/utils/api/register.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../../src/utils/api/register.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAqB,MAAM,6BAA6B,CAAC;AAC/E,OAAO,EAAE,SAAS,EAAc,MAAM,sBAAsB,CAAC;AAG7D;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAgBxE;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,aAAa,CAkCtD;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAkC/D"}
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../../src/utils/api/register.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAqB,MAAM,6BAA6B,CAAC;AAC/E,OAAO,EAAE,SAAS,EAAc,MAAM,sBAAsB,CAAC;AAG7D;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAgBxE;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,aAAa,CAmCtD;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CA6C/D"}

package/dist/types/utils/deployment/agents.d.ts

@@ -0,0 +1,53 @@
+import { ClientFactory, ConnectAPICallback, TaskManager } from "../../types/proxy.js";
+export declare namespace artinet {
+    namespace v0 {
+        /**
+         * Manages the execution of an agent's task.
+         * This function is intended to be used within an agent's code when deployed to a
+         * managed environment. It takes the agent's core task-handling generator function
+         * and iterates over its yielded updates, passing them to a proxy function
+         * made available by the host environment.
+         *
+         * The `TaskContext` and the `TaskProxy` (for yielding updates) are expected
+         * to be provided by the host environment via `process.env`.
+         *
+         * @param {TaskManagerProps} props - The properties for the task manager, including the taskHandler.
+         * @param {function(TaskContext): AsyncGenerator<any, any, unknown>} props.taskHandler - An asynchronous generator function that takes a `TaskContext`
+         * and yields updates, eventually returning a `Task` or void.
+         * @returns {Promise<void>} A promise that resolves when the task handler has completed.
+         * @throws An error if the `taskManagerStub` or `context` is not set in `process.env`,
+         *         indicating an invalid runtime environment.
+         */
+        const taskManager: TaskManager;
+        /**
+         * Establishes a connection or sends a request to another agent or service.
+         * This function proxies requests to a host-provided implementation, enabling
+         * agents in a managed environment to make external calls (e.g., to an LLM or another agent)
+         * without needing direct network access or credentials. The actual implementation
+         * is delegated to `env.connectStub`, provided by the host environment.
+         *
+         * @param {ConnectProps} props - The properties for the connect call, including the target agentID and messages.
+         * @param {string} props.agentID - The identifier of the target agent or LLM to which the request is directed.
+         * @param {object[]} props.messages - An array of messages forming the conversation history or prompt.
+         * @returns {Promise<string>} A promise that resolves to the string response from the target agent/LLM or a connection identifier.
+         * @throws An error if `env.connectStub` is not found,
+         *         indicating an invalid runtime environment.
+         */
+        const connect: ConnectAPICallback;
+        /**
+         * Creates a client proxy for interacting with other agents or services.
+         * This function acts as a factory to obtain a `ClientProxy` instance.
+         * The actual implementation of the client factory is delegated to `env.clientStub`,
+         * provided by the host environment. This allows agents to communicate with
+         * other entities in a managed environment without direct awareness of the
+         * underlying communication mechanisms.
+         *
+         * @param {ClientProps} props - The properties for creating the client.
+         * @returns {ClientProxy} A proxy object for interacting with a client service or agent.
+         * @throws An error if `env.clientStub` is not found,
+         *         indicating an invalid runtime environment.
+         */
+        const agent: ClientFactory;
+    }
+}
+//# sourceMappingURL=agents.d.ts.map

package/dist/types/utils/deployment/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../../../src/utils/deployment/agents.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EAGb,kBAAkB,EAElB,WAAW,EAGZ,MAAM,sBAAsB,CAAC;AAM9B,yBAAiB,OAAO,CAAC;IAEvB,UAAiB,EAAE,CAAC;QAClB;;;;;;;;;;;;;;;;WAgBG;QACI,MAAM,WAAW,EAAE,WA0BzB,CAAC;QAEF;;;;;;;;;;;;;WAaG;QACI,MAAM,OAAO,EAAE,kBAWrB,CAAC;QAEF;;;;;;;;;;;;WAYG;QACI,MAAM,KAAK,EAAE,aASnB,CAAC;KACH;CACF"}

package/dist/types/utils/deployment/full-deployment.d.ts

@@ -0,0 +1,8 @@
+import { ServerDeploymentRequestParams, ServerDeploymentResponse } from "../../types/index.js";
+/**
+ * Sends a full deployment request to the server.
+ * @param params The parameters to pass to the method.
+ * @returns The response from the server.
+ */
+export declare function fullDeployment(params: ServerDeploymentRequestParams): Promise<ServerDeploymentResponse>;
+//# sourceMappingURL=full-deployment.d.ts.map

package/dist/types/utils/deployment/full-deployment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"full-deployment.d.ts","sourceRoot":"","sources":["../../../../src/utils/deployment/full-deployment.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,6BAA6B,EAC7B,wBAAwB,EAGzB,MAAM,sBAAsB,CAAC;AAqC9B;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,6BAA6B,qCAYzE"}

package/dist/types/utils/deployment/task-wrapper.d.ts

@@ -1,4 +1,5 @@
-import { Task, TaskContext, TaskYieldUpdate } from "../../index.js";
+import { Task, TaskYieldUpdate } from "../../types/index.js";
+import { TaskContext } from "../../types/context.js";
 /**
  * @fileoverview This module provides proxy functions for agent task handling and
  * fetching responses within a managed deployment environment. These proxies
@@ -13,7 +14,7 @@ import { Task, TaskContext, TaskYieldUpdate } from "../../index.js";
  * made available in the `env` by the host environment.
  *
  * The `Context` (TaskContext) is also expected to be provided by the host environment via `env`.
- *
+ * @deprecated This function is deprecated and will be removed in a future version. Use the `Artinet.v0.taskManager` function instead.
  * @param taskHandler - An asynchronous generator function that takes a `TaskContext`
  *                      and yields `TaskYieldUpdate` objects, eventually returning a `Task` or void.
  * @throws An error if the required `env.hostOnYield` or `env.Context` are not found,
@@ -25,7 +26,7 @@ export declare const taskHandlerProxy: (taskHandler: (context: TaskContext) => A
  * This allows agents in a managed environment to make external calls (e.g., to an LLM)
  * without needing direct network access or credentials. The actual implementation of fetching
  * the response is delegated to `env.hostFetchResponse`, provided by the host environment.
- *
+ * @deprecated This function is deprecated and will be removed in a future version. Use the `Artinet.v0.connect` function instead.
  * @param agentID - The identifier of the target agent or LLM to which the request is directed.
  * @param messages - An array of messages forming the conversation history or prompt.
  * @returns A promise that resolves to the string response from the target agent/LLM.

package/dist/types/utils/deployment/task-wrapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-wrapper.d.ts","sourceRoot":"","sources":["../../../../src/utils/deployment/task-wrapper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGpE;;;;;GAKG;AAEH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,gBAAgB,GAC3B,aAAa,CACX,OAAO,EAAE,WAAW,KACjB,cAAc,CAAC,eAAe,EAAE,IAAI,GAAG,IAAI,EAAE,OAAO,CAAC,kBAmB3D,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB,GAC7B,SAAS,MAAM,EACf,UAAU;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,KAC5C,OAAO,CAAC,MAAM,CAUhB,CAAC"}
+{"version":3,"file":"task-wrapper.d.ts","sourceRoot":"","sources":["../../../../src/utils/deployment/task-wrapper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGrD;;;;;GAKG;AAEH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,gBAAgB,GAC3B,aAAa,CACX,OAAO,EAAE,WAAW,KACjB,cAAc,CAAC,eAAe,EAAE,IAAI,GAAG,IAAI,EAAE,OAAO,CAAC,kBAG3D,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB,GAC7B,SAAS,MAAM,EACf,UAAU;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,KAC5C,OAAO,CAAC,MAAM,CAEhB,CAAC"}

package/dist/types/utils/deployment/test-deployment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"test-deployment.d.ts","sourceRoot":"","sources":["../../../../src/utils/deployment/test-deployment.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,6BAA6B,EAC7B,wBAAwB,EAIxB,IAAI,EACJ,eAAe,EAChB,MAAM,sBAAsB,CAAC;AAqB9B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAuB,cAAc,CACnC,MAAM,EAAE,6BAA6B,EACrC,QAAQ,EAAE,eAAe,EAAE,GAC1B,aAAa,CAAC,IAAI,GAAG,wBAAwB,GAAG,IAAI,CAAC,CAwCvD"}
+{"version":3,"file":"test-deployment.d.ts","sourceRoot":"","sources":["../../../../src/utils/deployment/test-deployment.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,6BAA6B,EAC7B,wBAAwB,EAIxB,IAAI,EACJ,eAAe,EAChB,MAAM,sBAAsB,CAAC;AAqB9B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAuB,cAAc,CACnC,MAAM,EAAE,6BAA6B,EACrC,QAAQ,EAAE,eAAe,EAAE,GAC1B,aAAa,CAAC,IAAI,GAAG,wBAAwB,GAAG,IAAI,CAAC,CAyCvD"}

package/dist/types/utils/index.d.ts

@@ -7,4 +7,5 @@ export * from "./api/register.js";
 export * from "./deployment/test-deployment.js";
 export * from "./deployment/task-wrapper.js";
 export * from "./deployment/bundler.js";
+export * from "./deployment/full-deployment.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/types/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iCAAiC,CAAC;AAChD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iCAAiC,CAAC;AAChD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC"}

package/dist/utils/api/register.js

@@ -41,6 +41,7 @@ export function convert(card) {
         description: card.description ?? "sdk-generated registration for " + card.name,
         version: card.version,
         capabilities: capabilities,
+        tags: ["a2a"],
         communication: {
             endpoints: [
                 {
@@ -68,6 +69,14 @@ export async function register(card) {
         logWarn("A2AServer", "No card provided");
         return "";
     }
+    if (card.url === undefined ||
+        card.url === null ||
+        card.url === "" ||
+        card.url.includes("localhost") ||
+        card.url.includes("127.0.0.1")) {
+        logDebug("A2AServer", "Invalid URL provided", card.url);
+        return "";
+    }
     try {
         const registration = convert(card);
         logInfo("A2AServer", "Registration", registration);

package/dist/utils/api/register.js.map

@@ -1 +1 @@
-{"version":3,"file":"register.js","sourceRoot":"","sources":["../../../src/utils/api/register.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAE/E,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE/D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,QAAgB;IAEhB,MAAM,YAAY,GAAQ,MAAM,KAAK,CAAC,iCAAiC,EAAE;QACvE,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,cAAc,EAAE,kBAAkB;YAClC,6BAA6B,EAAE,GAAG;YAClC,8BAA8B,EAAE,GAAG;YACnC,8BAA8B,EAAE,GAAG;YACnC,kCAAkC,EAAE,MAAM;SAC3C;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,mBAAmB,EAAE,QAAQ;SAC9B,CAAC;KACH,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,CAAC;IAC3C,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,oBAAoB,CAAC;AACxD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,IAAe;IACrC,4EAA4E;IAC5E,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAiB,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACtE,MAAM,YAAY,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAkC,CAAC,CAAC,sCAAsC;IAEpH,wGAAwG;IACxG,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc;QACtC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QACxC,CAAC,CAAC,SAAS,CAAC;IAEd,MAAM,YAAY,GAAkB;QAClC,aAAa,EAAE,OAAO;QACtB,WAAW,EAAE,IAAI,CAAC,IAAI;QACtB,WAAW,EACT,IAAI,CAAC,WAAW,IAAI,iCAAiC,GAAG,IAAI,CAAC,IAAI;QACnE,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,YAAY,EAAE,YAAY;QAC1B,aAAa,EAAE;YACb,SAAS,EAAE;gBACT;oBACE,GAAG,EAAE,IAAI,CAAC,GAAG;oBACb,IAAI,EAAE,SAAS;oBACf,cAAc,EAAE,YAAY;oBAC5B,WAAW,EAAE,oCAAoC;oBACjD,SAAS,EAAE,CAAC,aAAa,EAAE,KAAK,CAAC;iBAClC;aACF;SACF;QACD,QAAQ,EAAE;YACR,SAAS,EAAE,IAAI;SAChB;KACF,CAAC;IAEF,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAe;IAC5C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC;QACzC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QACnC,OAAO,CAAC,WAAW,EAAE,cAAc,EAAE,YAAY,CAAC,CAAC;QAEnD,MAAM,SAAS,GAAG,IAAI,iBAAiB,EAAE,CAAC;QAC1C,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,GACvC,MAAM,SAAS,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC;QACjD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,QAAQ,CAAC,WAAW,EAAE,mBAAmB,EAAE,eAAe,CAAC,CAAC;YAC5D,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;QACnC,CAAC;QACD,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,MAAM,WAAW,CAC1D,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAC7B,CAAC;QACF,IAAI,CAAC,OAAO,IAAI,CAAC,cAAc,EAAE,CAAC;YAChC,QAAQ,CAAC,WAAW,EAAE,yBAAyB,EAAE,KAAK,CAAC,CAAC;YACxD,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;QAED,OAAO,CAAC,WAAW,EAAE,yBAAyB,EAAE,cAAc,CAAC,CAAC;QAChE,OAAO,cAAc,CAAC;IACxB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,8GAA8G;QAC9G,kDAAkD;QAClD,kFAAkF;QAClF,OAAO,CAAC,WAAW,EAAE,qBAAqB,EAAE,KAAK,CAAC,CAAC;QACnD,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../../../src/utils/api/register.ts"],"names":[],"mappings":"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"}

package/dist/utils/deployment/agents.js

@@ -0,0 +1,92 @@
+const env = process.env;
+// eslint-disable-next-line @typescript-eslint/no-namespace
+export var artinet;
+(function (artinet) {
+    // eslint-disable-next-line @typescript-eslint/no-namespace
+    let v0;
+    (function (v0) {
+        /**
+         * Manages the execution of an agent's task.
+         * This function is intended to be used within an agent's code when deployed to a
+         * managed environment. It takes the agent's core task-handling generator function
+         * and iterates over its yielded updates, passing them to a proxy function
+         * made available by the host environment.
+         *
+         * The `TaskContext` and the `TaskProxy` (for yielding updates) are expected
+         * to be provided by the host environment via `process.env`.
+         *
+         * @param {TaskManagerProps} props - The properties for the task manager, including the taskHandler.
+         * @param {function(TaskContext): AsyncGenerator<any, any, unknown>} props.taskHandler - An asynchronous generator function that takes a `TaskContext`
+         * and yields updates, eventually returning a `Task` or void.
+         * @returns {Promise<void>} A promise that resolves when the task handler has completed.
+         * @throws An error if the `taskManagerStub` or `context` is not set in `process.env`,
+         *         indicating an invalid runtime environment.
+         */
+        v0.taskManager = async (props) => {
+            const { taskHandler } = props;
+            if (!env.taskManagerStub && !env.context) {
+                console.warn("taskManager: taskManagerStub or context is not set", "task-manager");
+                return;
+            }
+            const context = env.context;
+            const taskManagerProxy = env.taskManagerStub;
+            if (!taskManagerProxy || !context) {
+                console.warn("taskManager: taskManagerStub or context is not set", "task-manager");
+                return;
+            }
+            const generator = taskHandler(context);
+            for await (const yieldValue of generator) {
+                console.info("taskManager: yieldValue", "task-manager", yieldValue);
+                taskManagerProxy(yieldValue);
+            }
+        };
+        /**
+         * Establishes a connection or sends a request to another agent or service.
+         * This function proxies requests to a host-provided implementation, enabling
+         * agents in a managed environment to make external calls (e.g., to an LLM or another agent)
+         * without needing direct network access or credentials. The actual implementation
+         * is delegated to `env.connectStub`, provided by the host environment.
+         *
+         * @param {ConnectProps} props - The properties for the connect call, including the target agentID and messages.
+         * @param {string} props.agentID - The identifier of the target agent or LLM to which the request is directed.
+         * @param {object[]} props.messages - An array of messages forming the conversation history or prompt.
+         * @returns {Promise<string>} A promise that resolves to the string response from the target agent/LLM or a connection identifier.
+         * @throws An error if `env.connectStub` is not found,
+         *         indicating an invalid runtime environment.
+         */
+        v0.connect = async (props) => {
+            if (!env.connectStub) {
+                throw new Error("connectStub is not set");
+            }
+            const connectProxy = env.connectStub;
+            if (!connectProxy) {
+                throw new Error("connectStub is not set");
+            }
+            return connectProxy(props);
+        };
+        /**
+         * Creates a client proxy for interacting with other agents or services.
+         * This function acts as a factory to obtain a `ClientProxy` instance.
+         * The actual implementation of the client factory is delegated to `env.clientStub`,
+         * provided by the host environment. This allows agents to communicate with
+         * other entities in a managed environment without direct awareness of the
+         * underlying communication mechanisms.
+         *
+         * @param {ClientProps} props - The properties for creating the client.
+         * @returns {ClientProxy} A proxy object for interacting with a client service or agent.
+         * @throws An error if `env.clientStub` is not found,
+         *         indicating an invalid runtime environment.
+         */
+        v0.agent = (props) => {
+            if (!env.clientStub) {
+                throw new Error("clientStub is not set");
+            }
+            const clientProxy = env.clientStub;
+            if (!clientProxy) {
+                throw new Error("clientStub is not set");
+            }
+            return clientProxy(props);
+        };
+    })(v0 = artinet.v0 || (artinet.v0 = {}));
+})(artinet || (artinet = {}));
+//# sourceMappingURL=agents.js.map

package/dist/utils/deployment/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../../src/utils/deployment/agents.ts"],"names":[],"mappings":"AAYA,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;AAExB,2DAA2D;AAC3D,MAAM,KAAW,OAAO,CAmGvB;AAnGD,WAAiB,OAAO;IACtB,2DAA2D;IAC3D,IAAiB,EAAE,CAgGlB;IAhGD,WAAiB,EAAE;QACjB;;;;;;;;;;;;;;;;WAgBG;QACU,cAAW,GAAgB,KAAK,EAAE,KAAuB,EAAE,EAAE;YACxE,MAAM,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC;YAC9B,IAAI,CAAC,GAAG,CAAC,eAAe,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;gBACzC,OAAO,CAAC,IAAI,CACV,oDAAoD,EACpD,cAAc,CACf,CAAC;gBACF,OAAO;YACT,CAAC;YAED,MAAM,OAAO,GAAG,GAAG,CAAC,OAAiC,CAAC;YACtD,MAAM,gBAAgB,GAAG,GAAG,CAAC,eAAuC,CAAC;YAErE,IAAI,CAAC,gBAAgB,IAAI,CAAC,OAAO,EAAE,CAAC;gBAClC,OAAO,CAAC,IAAI,CACV,oDAAoD,EACpD,cAAc,CACf,CAAC;gBACF,OAAO;YACT,CAAC;YAED,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;YACvC,IAAI,KAAK,EAAE,MAAM,UAAU,IAAI,SAAS,EAAE,CAAC;gBACzC,OAAO,CAAC,IAAI,CAAC,yBAAyB,EAAE,cAAc,EAAE,UAAU,CAAC,CAAC;gBACpE,gBAAgB,CAAC,UAAU,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC,CAAC;QAEF;;;;;;;;;;;;;WAaG;QACU,UAAO,GAAuB,KAAK,EAC9C,KAAmB,EACF,EAAE;YACnB,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;gBACrB,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;YAC5C,CAAC;YACD,MAAM,YAAY,GAAG,GAAG,CAAC,WAA4C,CAAC;YACtE,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;YAC5C,CAAC;YACD,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC,CAAC;QAEF;;;;;;;;;;;;WAYG;QACU,QAAK,GAAkB,CAAC,KAAkB,EAAe,EAAE;YACtE,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;YAC3C,CAAC;YACD,MAAM,WAAW,GAAG,GAAG,CAAC,UAAsC,CAAC;YAC/D,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;YAC3C,CAAC;YACD,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC,CAAC;IACJ,CAAC,EAhGgB,EAAE,GAAF,UAAE,KAAF,UAAE,QAgGlB;AACH,CAAC,EAnGgB,OAAO,KAAP,OAAO,QAmGvB"}

package/dist/utils/deployment/bundler.js

@@ -31,7 +31,7 @@ export async function bundle(filePath) {
             entryPoints: [entryPath],
             bundle: true,
             minify: true,
-            sourcemap: true,
+            sourcemap: false,
             platform: "node",
             format: "esm",
             write: false,

package/dist/utils/deployment/bundler.js.map

@@ -1 +1 @@
-{"version":3,"file":"bundler.js","sourceRoot":"","sources":["../../../src/utils/deployment/bundler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,QAAa;IACxC,MAAM,SAAS,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC1C,QAAQ,CACN,WAAW,EACX,uDAAuD,EACvD,SAAS,CACV,CAAC;IACF,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;QACnC,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACpB,QAAQ,CAAC,WAAW,EAAE,yBAAyB,EAAE,SAAS,CAAC,CAAC;YAC5D,MAAM,IAAI,KAAK,CACb,+CAA+C,SAAS,EAAE,CAC3D,CAAC;QACJ,CAAC;QACD,QAAQ,CAAC,WAAW,EAAE,kBAAkB,EAAE,SAAS,CAAC,CAAC;IACvD,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,QAAQ,CAAC,WAAW,EAAE,0BAA0B,EAAE,SAAS,CAAC,CAAC;QAC7D,MAAM,IAAI,KAAK,CACb,gDAAgD,SAAS,EAAE,CAC5D,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC;YACjC,WAAW,EAAE,CAAC,SAAS,CAAC;YACxB,MAAM,EAAE,IAAI;YACZ,MAAM,EAAE,IAAI;YACZ,SAAS,EAAE,IAAI;YACf,QAAQ,EAAE,MAAM;YAChB,MAAM,EAAE,KAAK;YACb,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;QACpD,QAAQ,CACN,8CAA8C,EAC9C,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,CACzB,CAAC;QACF,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,QAAQ,CAAC,WAAW,EAAE,8BAA8B,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QACnE,MAAM,IAAI,KAAK,CAAC,uBAAuB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IACxD,CAAC;AACH,CAAC"}
+{"version":3,"file":"bundler.js","sourceRoot":"","sources":["../../../src/utils/deployment/bundler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,QAAa;IACxC,MAAM,SAAS,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC1C,QAAQ,CACN,WAAW,EACX,uDAAuD,EACvD,SAAS,CACV,CAAC;IACF,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;QACnC,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACpB,QAAQ,CAAC,WAAW,EAAE,yBAAyB,EAAE,SAAS,CAAC,CAAC;YAC5D,MAAM,IAAI,KAAK,CACb,+CAA+C,SAAS,EAAE,CAC3D,CAAC;QACJ,CAAC;QACD,QAAQ,CAAC,WAAW,EAAE,kBAAkB,EAAE,SAAS,CAAC,CAAC;IACvD,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,QAAQ,CAAC,WAAW,EAAE,0BAA0B,EAAE,SAAS,CAAC,CAAC;QAC7D,MAAM,IAAI,KAAK,CACb,gDAAgD,SAAS,EAAE,CAC5D,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC;YACjC,WAAW,EAAE,CAAC,SAAS,CAAC;YACxB,MAAM,EAAE,IAAI;YACZ,MAAM,EAAE,IAAI;YACZ,SAAS,EAAE,KAAK;YAChB,QAAQ,EAAE,MAAM;YAChB,MAAM,EAAE,KAAK;YACb,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;QACpD,QAAQ,CACN,8CAA8C,EAC9C,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,CACzB,CAAC;QACF,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,QAAQ,CAAC,WAAW,EAAE,8BAA8B,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QACnE,MAAM,IAAI,KAAK,CAAC,uBAAuB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IACxD,CAAC;AACH,CAAC"}

package/dist/utils/deployment/full-deployment.js

@@ -0,0 +1,31 @@
+import { executeJsonRpcRequest } from "../../transport/index.js";
+/**
+ * @description The base URL of the deployment server.
+ */
+const FULL_DEPLOYMENT_URL = new URL("https://agents.artinet.io/deploy");
+/**
+ * @description The API key to use for the deployment.
+ */
+const API_KEY = process.env.ARTINET_API_KEY;
+/**
+ * Sends a full deployment request to the server.
+ * @param baseUrl The base URL of the server.
+ * @param method The method to call.
+ * @param params The parameters to pass to the method.
+ * @param headers The headers to send with the request.
+ * @param acceptHeader The accept header to send with the request.
+ * @returns The response from the server.
+ */
+const executeFullDeploymentRequest = executeJsonRpcRequest;
+/**
+ * Sends a full deployment request to the server.
+ * @param params The parameters to pass to the method.
+ * @returns The response from the server.
+ */
+export async function fullDeployment(params) {
+    if (!API_KEY) {
+        throw new Error("ARTINET_API_KEY is not set");
+    }
+    return await executeFullDeploymentRequest(FULL_DEPLOYMENT_URL, "/deploy", params, { Authorization: `Bearer ${API_KEY}` }, "application/json");
+}
+//# sourceMappingURL=full-deployment.js.map

package/dist/utils/deployment/full-deployment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"full-deployment.js","sourceRoot":"","sources":["../../../src/utils/deployment/full-deployment.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEjE;;GAEG;AACH,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC,kCAAkC,CAAC,CAAC;AAExE;;GAEG;AACH,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;AAO5C;;;;;;;;GAQG;AACH,MAAM,4BAA4B,GAAG,qBAQC,CAAC;AAEvC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAAqC;IACxE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAChD,CAAC;IAED,OAAO,MAAM,4BAA4B,CACvC,mBAAmB,EACnB,SAAS,EACT,MAAM,EACN,EAAE,aAAa,EAAE,UAAU,OAAO,EAAE,EAAE,EACtC,kBAAkB,CACnB,CAAC;AACJ,CAAC"}

package/dist/utils/deployment/task-wrapper.js

@@ -1,4 +1,4 @@
-import { env } from "process";
+import { artinet } from "./agents.js";
 /**
  * @fileoverview This module provides proxy functions for agent task handling and
  * fetching responses within a managed deployment environment. These proxies
@@ -13,34 +13,21 @@ import { env } from "process";
  * made available in the `env` by the host environment.
  *
  * The `Context` (TaskContext) is also expected to be provided by the host environment via `env`.
- *
+ * @deprecated This function is deprecated and will be removed in a future version. Use the `Artinet.v0.taskManager` function instead.
  * @param taskHandler - An asynchronous generator function that takes a `TaskContext`
  *                      and yields `TaskYieldUpdate` objects, eventually returning a `Task` or void.
  * @throws An error if the required `env.hostOnYield` or `env.Context` are not found,
  *         indicating an invalid runtime environment.
  */
 export const taskHandlerProxy = async (taskHandler) => {
-    if (!env.hostOnYield && !env.Context) {
-        const err = new Error("invalid runtime environment");
-        throw err;
-    }
-    const context = env.Context;
-    const onYieldProxy = env.hostOnYield;
-    if (!onYieldProxy || !context) {
-        const err = new Error("invalid runtime environment");
-        throw err;
-    }
-    const generator = taskHandler(context);
-    for await (const yieldValue of generator) {
-        onYieldProxy(yieldValue);
-    }
+    return await artinet.v0.taskManager({ taskHandler });
 };
 /**
  * Proxies requests to fetch responses from other agents or LLMs to a host-provided implementation.
  * This allows agents in a managed environment to make external calls (e.g., to an LLM)
  * without needing direct network access or credentials. The actual implementation of fetching
  * the response is delegated to `env.hostFetchResponse`, provided by the host environment.
- *
+ * @deprecated This function is deprecated and will be removed in a future version. Use the `Artinet.v0.connect` function instead.
  * @param agentID - The identifier of the target agent or LLM to which the request is directed.
  * @param messages - An array of messages forming the conversation history or prompt.
  * @returns A promise that resolves to the string response from the target agent/LLM.
@@ -48,11 +35,6 @@ export const taskHandlerProxy = async (taskHandler) => {
  *         indicating an invalid runtime environment.
  */
 export const fetchResponseProxy = async (agentID, messages) => {
-    if (!env.hostFetchResponse) {
-        const err = new Error("invalid runtime environment");
-        throw err;
-    }
-    const fetchResponseImpl = env.hostFetchResponse;
-    return fetchResponseImpl(agentID, messages);
+    return artinet.v0.connect({ agentId: agentID, messages });
 };
 //# sourceMappingURL=task-wrapper.js.map

package/dist/utils/deployment/task-wrapper.js.map

@@ -1 +1 @@
-{"version":3,"file":"task-wrapper.js","sourceRoot":"","sources":["../../../src/utils/deployment/task-wrapper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,MAAM,SAAS,CAAC;AAE9B;;;;;GAKG;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EACnC,WAE0D,EAC1D,EAAE;IACF,IAAI,CAAC,GAAG,CAAC,WAAW,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACrD,MAAM,GAAG,CAAC;IACZ,CAAC;IACD,MAAM,OAAO,GAAG,GAAG,CAAC,OAAiC,CAAC;IACtD,MAAM,YAAY,GAAG,GAAG,CAAC,WAEP,CAAC;IAEnB,IAAI,CAAC,YAAY,IAAI,CAAC,OAAO,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACrD,MAAM,GAAG,CAAC;IACZ,CAAC;IACD,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACvC,IAAI,KAAK,EAAE,MAAM,UAAU,IAAI,SAAS,EAAE,CAAC;QACzC,YAAY,CAAC,UAAU,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,EACrC,OAAe,EACf,QAA6C,EAC5B,EAAE;IACnB,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACrD,MAAM,GAAG,CAAC;IACZ,CAAC;IACD,MAAM,iBAAiB,GAAG,GAAG,CAAC,iBAGV,CAAC;IACrB,OAAO,iBAAiB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AAC9C,CAAC,CAAC"}
+{"version":3,"file":"task-wrapper.js","sourceRoot":"","sources":["../../../src/utils/deployment/task-wrapper.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC;;;;;GAKG;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EACnC,WAE0D,EAC1D,EAAE;IACF,OAAO,MAAM,OAAO,CAAC,EAAE,CAAC,WAAW,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;AACvD,CAAC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,EACrC,OAAe,EACf,QAA6C,EAC5B,EAAE;IACnB,OAAO,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;AAC5D,CAAC,CAAC"}

package/dist/utils/deployment/test-deployment.js

@@ -42,7 +42,8 @@ export async function* testDeployment(params, requests) {
     };
     for await (const event of generator) {
         const deploymentEvent = event;
-        if (deploymentEvent.result &&
+        if (deploymentEvent &&
+            deploymentEvent.result &&
             deploymentEvent.result.deploymentId &&
             deploymentEvent.result.url) {
             logDebug("testDeployment", "deployment-event: ", deploymentEvent);

package/dist/utils/deployment/test-deployment.js.map

@@ -1 +1 @@
-{"version":3,"file":"test-deployment.js","sourceRoot":"","sources":["../../../src/utils/deployment/test-deployment.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C;;;;GAIG;AAEH,MAAM,uBAAuB,GAAG,mBAQoB,CAAC;AAErD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,cAAc,CACnC,MAAqC,EACrC,QAA2B;IAE3B,MAAM,SAAS,GAAG,MAAM,uBAAuB,CAC7C,IAAI,GAAG,CAAC,uCAAuC,CAAC,EAChD,cAAqB,EACrB,MAAa,EACb,EAAE,CACH,CAAC;IAEF,MAAM,eAAe,GAAG,KAAK,EAAE,GAAW,EAAE,EAAE,CAC5C,KAAK,SAAS,CAAC;QACb,MAAM,UAAU,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC;QACtC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC;gBACrC,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE;gBACrB,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO;aAChC,CAAC,CAAC;YACH,QAAQ,CAAC,gBAAgB,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;YAC3C,MAAM,IAAI,CAAC;QACb,CAAC;IACH,CAAC,CAAC;IAEJ,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;QACpC,MAAM,eAAe,GACnB,KAAiC,CAAC;QACpC,IACE,eAAe,CAAC,MAAM;YACtB,eAAe,CAAC,MAAM,CAAC,YAAY;YACnC,eAAe,CAAC,MAAM,CAAC,GAAG,EAC1B,CAAC;YACD,QAAQ,CAAC,gBAAgB,EAAE,oBAAoB,EAAE,eAAe,CAAC,CAAC;YAClE,MAAM,KAAK,CAAC;YACZ,MAAM,cAAc,GAAG,MAAM,eAAe,CAAC,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACzE,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,cAAc,EAAE,EAAE,CAAC;gBAC1C,MAAM,IAAI,CAAC;YACb,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,KAAK,CAAC;YACZ,QAAQ,CAAC,gBAAgB,EAAE,kBAAkB,EAAE,KAAK,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"test-deployment.js","sourceRoot":"","sources":["../../../src/utils/deployment/test-deployment.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C;;;;GAIG;AAEH,MAAM,uBAAuB,GAAG,mBAQoB,CAAC;AAErD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,cAAc,CACnC,MAAqC,EACrC,QAA2B;IAE3B,MAAM,SAAS,GAAG,MAAM,uBAAuB,CAC7C,IAAI,GAAG,CAAC,uCAAuC,CAAC,EAChD,cAAqB,EACrB,MAAa,EACb,EAAE,CACH,CAAC;IAEF,MAAM,eAAe,GAAG,KAAK,EAAE,GAAW,EAAE,EAAE,CAC5C,KAAK,SAAS,CAAC;QACb,MAAM,UAAU,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC;QACtC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC;gBACrC,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE;gBACrB,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO;aAChC,CAAC,CAAC;YACH,QAAQ,CAAC,gBAAgB,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;YAC3C,MAAM,IAAI,CAAC;QACb,CAAC;IACH,CAAC,CAAC;IAEJ,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;QACpC,MAAM,eAAe,GACnB,KAAiC,CAAC;QACpC,IACE,eAAe;YACf,eAAe,CAAC,MAAM;YACtB,eAAe,CAAC,MAAM,CAAC,YAAY;YACnC,eAAe,CAAC,MAAM,CAAC,GAAG,EAC1B,CAAC;YACD,QAAQ,CAAC,gBAAgB,EAAE,oBAAoB,EAAE,eAAe,CAAC,CAAC;YAClE,MAAM,KAAK,CAAC;YACZ,MAAM,cAAc,GAAG,MAAM,eAAe,CAAC,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACzE,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,cAAc,EAAE,EAAE,CAAC;gBAC1C,MAAM,IAAI,CAAC;YACb,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,KAAK,CAAC;YACZ,QAAQ,CAAC,gBAAgB,EAAE,kBAAkB,EAAE,KAAK,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/utils/index.js

@@ -7,4 +7,5 @@ export * from "./api/register.js";
 export * from "./deployment/test-deployment.js";
 export * from "./deployment/task-wrapper.js";
 export * from "./deployment/bundler.js";
+export * from "./deployment/full-deployment.js";
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iCAAiC,CAAC;AAChD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iCAAiC,CAAC;AAChD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@artinet/sdk",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "TypeScript SDK for the Agent2Agent (A2A) Protocol",
   "type": "module",
   "main": "./dist/index.js",
@@ -11,6 +11,11 @@
       "types": "./dist/types/index.d.ts",
       "import": "./dist/index.js",
       "default": "./dist/index.js"
+    },
+    "./agents": {
+      "types": "./dist/utils/deployment/agents.d.ts",
+      "import": "./dist/utils/deployment/agents.js",
+      "default": "./dist/utils/deployment/agents.js"
     }
   },
   "rootDir": ".",
@@ -27,7 +32,8 @@
     "prepublishOnly": "npm run clean && npm run build && npm run lint && npm test",
     "test": "NODE_OPTIONS=--experimental-vm-modules jest",
     "test:watch": "NODE_OPTIONS=--experimental-vm-modules jest --watch",
-    "test:coverage": "NODE_OPTIONS=--experimental-vm-modules jest --coverage"
+    "test:coverage": "NODE_OPTIONS=--experimental-vm-modules jest --coverage",
+    "dev-pack": "rimraf dist node_modules/ && npm i && npm run build && npm pack"
   },
   "keywords": [
     "agent2agent",
@@ -54,10 +60,10 @@
     "@types/express": "^5.0.1",
     "@types/pino": "^7.0.4",
     "cors": "^2.8.5",
-    "esbuild": "^0.25.4",
     "eventsource-parser": "^3.0.1",
     "express": "^5.1.0",
     "jayson": "^4.2.0",
+    "esbuild": "^0.25.4",
     "pino": "^9.6.0",
     "pino-pretty": "^10.2.0",
     "uuid": "^11.1.0"
@@ -65,13 +71,12 @@
   "devDependencies": {
     "@eslint/js": "^9.25.1",
     "@types/jest": "^29.5.14",
-    "@types/node": "^20.8.10",
+    "@types/node": "^20.17.50",
     "@types/supertest": "^6.0.2",
     "@types/uuid": "^9.0.6",
     "eslint": "^9.25.1",
     "globals": "^16.0.0",
     "jest": "^29.7.0",
-    "json-schema-to-typescript": "^15.0.4",
     "msw": "^2.7.5",
     "rimraf": "^5.0.5",
     "supertest": "^7.1.0",

package/dist/server/interfaces/context.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/server/interfaces/context.ts"],"names":[],"mappings":""}

package/dist/types/client/interfaces/client.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/client/interfaces/client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,YAAY,EACZ,IAAI,EACL,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EACV,SAAS,EACT,eAAe,EACf,cAAc,EACd,qBAAqB,EACtB,MAAM,gCAAgC,CAAC;AAExC;;;;;;;GAOG;AACH,MAAM,WAAW,MAAM;IACrB;;;;;;;OAOG;IACH,SAAS,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC;;;;;OAKG;IACH,gBAAgB,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;IAEvC;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IAEvD;;;;;;OAMG;IACH,iBAAiB,CACf,MAAM,EAAE,cAAc,GACrB,aAAa,CAAC,qBAAqB,GAAG,uBAAuB,CAAC,CAAC;IAElE;;;;;OAKG;IACH,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IAEvD;;;;;OAKG;IACH,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IAEvD;;;;;;;OAOG;IACH,uBAAuB,CACrB,MAAM,EAAE,0BAA0B,GACjC,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC,CAAC;IAE9C;;;;;OAKG;IACH,uBAAuB,CACrB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC,CAAC;IAE9C;;;;;;OAMG;IACH,eAAe,CACb,MAAM,EAAE,eAAe,GACtB,aAAa,CAAC,qBAAqB,GAAG,uBAAuB,CAAC,CAAC;IAElE;;;;;OAKG;IACH,QAAQ,CACN,UAAU,EAAE,WAAW,GAAG,mBAAmB,GAAG,wBAAwB,GACvE,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB;;;;;OAKG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAElD;;;;;OAKG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7C;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjC;;;OAGG;IACH,YAAY,IAAI,IAAI,CAAC;CACtB"}

package/dist/types/server/interfaces/context.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../../src/server/interfaces/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,IAAI,EACJ,OAAO,EACP,eAAe,EAChB,MAAM,gCAAgC,CAAC;AAExC;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,IAAI,EAAE,IAAI,CAAC;IAEX;;OAEG;IACH,WAAW,EAAE,OAAO,CAAC;IAErB;;;;OAIG;IACH,WAAW,IAAI,OAAO,CAAC;IAEvB;;OAEG;IACH,OAAO,EAAE,OAAO,EAAE,CAAC;CACpB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,WAAW,GAAG,CACxB,OAAO,EAAE,WAAW,KACjB,cAAc,CAAC,eAAe,EAAE,IAAI,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC"}