New import option and refactor of TaskManager for Agent Execution (#19)

* Add type import for cleaner use of the sdk, allow import of agent executor and bump to 0.5.7

* Deprecate legacy types and update documentation for clarity

- Marked `TaskContext` as deprecated in favor of `A2AEngine`.
- Commented out the export of `deployment` schema to indicate it is no longer in use.
- Introduced `AgentExecutor` type and deprecated `TaskManager`, providing clearer guidance on usage.
- Updated `agentExecutor` implementation for improved readability and added deprecation notice for `taskManager`.

---------

Co-authored-by: EditUndo <patrick.buah.jr@gmail.com>

Author: JabbaDuhHutt

.npmignore

@@ -0,0 +1 @@
+.gitignore

CHANGELOG.md

@@ -22,6 +22,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Updated `zod` package version
   - **BREAKING**: Rolled back from `zod/v4` to standard `zod` for better compatibility
 - Improved service interface architecture to support multiple protocol bindings
+- Renamed `artinet.v0.taskManager` and it's associate type `TaskManager` to `artinet.v0.agentExecutor` and `AgentExecutor` to avoid confusion with A2A `TaskManager` in `service.ts`
 
 ### Fixed
 

README.md

@@ -73,7 +73,7 @@ It has [serveral template projects](https://github.com/the-artinet-project/creat
 | **Transport Layers** | Built-in support for Express/TRPC.                                          | Express middleware, tRPC router, or easily create your own.                                          |
 | **Core Types**       | Fully implement A2A schema in Zod.                                          | `AgentCard`, `Task`, `Message`, `Part`, `Artifact`, etc.                                             |
 | **Deployment**       | Bundle, test, and deploy agents onto the artinet platform (v0.5.2).         | `@artinet/sdk/deployment`, `fullDeployment`, `testDeployment`, `bundle`                              |
-| **Agent Utilities**  | Run agents in managed environments with our proxy system.                   | `artinet.v0.taskManager`, `artinet.v0.connect`, `artinet.v0.agent`                                   |
+| **Agent Utilities**  | Run agents in managed environments with our proxy system.                   | `artinet.v0.agentExecutor`, `artinet.v0.connect`, `artinet.v0.agent`                                   |
 
 ## Installation
 
@@ -781,7 +781,7 @@ Key features include:
 
 - **Sandboxed Enviroments:** Streamline agent logic for quick and easy deployments. The new `artinet.v0` namespace (accessible via `@artinet/sdk/agents`) provides `taskManager`, `connect`, and `agent`.
 
-  - `artinet.v0.taskManager`: Manages the agent's lifecycle by iterating over the agent's `TaskHandler` and communicating updates to the host environment.
+  - `artinet.v0.agentExecutor`: Manages the agent's lifecycle by iterating over the agent's `TaskHandler` and communicating updates to the host environment.
   - `artinet.v0.connect`: Replaces the deprecated `fetchResponseProxy`. Allows agents to make proxied calls to other agents or LLMs via the host environment.
   - `artinet.v0.agent`: A factory function to obtain a `ClientProxy` for type-safe communication with other agents, managed by the host environment.
 
@@ -811,10 +811,10 @@ Key features include:
   }
 
   // The host environment will invoke this taskManager with the agent's logic.
-  await artinet.v0.taskManager({ taskHandler: myAgentLogic });
+  await artinet.v0.agentExecutor({ taskHandler: myAgentLogic });
   ```
 
-  _Note: The `taskHandlerProxy` and `fetchResponseProxy` utilities are now deprecated in favor of `artinet.v0.taskManager` and `artinet.v0.connect` respectively._
+  _Note: The `taskHandlerProxy` and `fetchResponseProxy` utilities are now deprecated in favor of `artinet.v0.agentExecutor` and `artinet.v0.connect` respectively._
 
 - **Test-Agents (Experimental):** Simulate and test your agents @ agents.artinet.io/test/deploy using the `testDeployment` tool.
 

examples/code-deployment.ts

@@ -86,5 +86,5 @@ export const coderAgent: AgentEngine = async function* (context: Context) {
   yield finalUpdate;
 };
 
-await artinet.v0.taskManager({ taskHandler: coderAgent });
+await artinet.v0.agentExecutor({ taskHandler: coderAgent });
 console.log("[CoderAgent] Finished");

examples/nested-deployment.ts

@@ -165,5 +165,5 @@ export const simpleEchoAgent: AgentEngine = async function* (context: Context) {
   yield completedUpdate;
 };
 
-await artinet.v0.taskManager({ taskHandler: simpleEchoAgent });
+await artinet.v0.agentExecutor({ taskHandler: simpleEchoAgent });
 console.log("[SimpleEchoAgent] Finished");

llms.txt

@@ -67,7 +67,7 @@ The SDK is distributed as the `@artinet/sdk` npm package (current version: 0.5.6
     *   Supports dynamic agent creation and management with shared state.
 
 *   **Code Deployment & Management:**
-    *   **`artinet.v0.taskManager`**: Standard utility for agents in managed environments to interact with the host for task lifecycle management.
+    *   **`artinet.v0.agentExecutor`**: Standard utility for agents in managed environments to interact with the host for task lifecycle management.
     *   **`artinet.v0.connect`**: Standard utility for agents in managed environments to make proxied calls to other agents or LLMs.
     *   **`artinet.v0.agent`**: Factory function for agents in managed environments to obtain a `ClientProxy` for type-safe communication.
     *   `bundler`: Utility to bundle agent code using `esbuild`.

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@artinet/sdk",
-  "version": "0.5.6",
+  "version": "0.5.7",
   "description": "TypeScript SDK for the Agent2Agent (A2A) Protocol",
   "type": "module",
   "main": "./dist/index.js",
@@ -21,6 +21,12 @@
       "types": "./dist/types/utils/deployment/index.d.ts",
       "import": "./dist/utils/deployment/index.js",
       "default": "./dist/utils/deployment/index.js"
+    },
+    "./types":
+    {
+      "types": "./dist/types/types/index.d.ts",
+      "import": "./dist/types/index.js",
+      "default": "./dist/types/index.js"
     }
   },
   "rootDir": ".",

src/types/interfaces/services/a2a/legacy.ts

@@ -98,6 +98,7 @@ export interface TaskContext {
  * or artifact updates (TaskYieldUpdate). The server consumes these yields,
  * updates the task state in the store, and streams events if applicable.
  *
+ * @deprecated Use A2AEngine instead.
  * @param context The TaskContext object containing task details and state.
  * @yields Updates to the task's status or artifacts.
  * @returns Optionally returns the final complete Task object (needed for non-streaming 'message/send').

src/types/schemas/deployment/proxy.ts

@@ -32,12 +32,21 @@ export interface TaskManagerProps {
 
 /**
  * Defines the signature for a TaskManager function.
+ * An AgentExecutor is responsible for orchestrating the execution of an agent's task,
+ * typically by interfacing with a host environment.
+ * @param props - The properties for the agent executor, including the taskHandler.
+ * @returns A promise that resolves when the task handler has completed.
+ */
+export type AgentExecutor = (props: TaskManagerProps) => Promise<void>;
+
+/**
+ * @deprecated Use AgentExecutor instead.
  * 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>;
+export type TaskManager = AgentExecutor;
 
 /**
  * Properties for the Connect function.

src/utils/deployment/agents.ts

@@ -9,9 +9,10 @@ import {
   ClientProxy,
   ConnectAPICallback,
   ConnectProps,
-  TaskManager,
+  AgentExecutor,
   TaskManagerProps,
   TaskProxy,
+  TaskManager,
 } from "~/types/schemas/deployment/index.js";
 import { Context as ExecutionContext } from "~/types/index.js";
 
@@ -38,7 +39,9 @@ export namespace artinet {
      * @throws An error if the `taskManagerStub` or `context` is not set in `process.env`,
      *         indicating an invalid runtime environment.
      */
-    export const taskManager: TaskManager = async (props: TaskManagerProps) => {
+    export const agentExecutor: AgentExecutor = async (
+      props: TaskManagerProps
+    ) => {
       const { taskHandler } = props;
       if (!env.taskManagerStub && !env.context) {
         console.warn(
@@ -66,6 +69,11 @@ export namespace artinet {
       }
     };
 
+    /**
+     * @deprecated Use agentExecutor instead.
+     */
+    export const taskManager: TaskManager = agentExecutor;
+
     /**
      * Establishes a connection or sends a request to another agent or service.
      * This function proxies requests to a host-provided implementation, enabling