@toolpack-sdk/agents 2.0.0-alpha.1 → 2.0.0

package/dist/{types-BWoRx1ZE.d.cts → types-TB6yypig.d.cts}

@@ -122,6 +122,36 @@ type BaseAgentOptions = {
 } | {
     toolpack: Toolpack;
 };
+/**
+ * Configuration for AI-driven agent delegation.
+ * When enabled, a delegation tool is injected into every `run()` call
+ * so the LLM can decide which peer agent to hand the task to.
+ */
+interface AgentDelegationConfig {
+    /** Must be true for the delegation tool to be injected. */
+    enabled: boolean;
+    /**
+     * Restrict which peer agents can be delegated to.
+     * When set, only the named agents appear in the tool's enum.
+     * When omitted, all peers in the registry are available.
+     */
+    allowedAgents?: string[];
+    /**
+     * Delegation mode.
+     *
+     * - `'await'` (default) — injects `delegate_to_agent`: calls the sub-agent,
+     *   waits for its result, and returns it to the LLM. Use when the orchestrator
+     *   needs to relay or act on the sub-agent's response.
+     *
+     * - `'forget'` — injects `delegate_and_forget`: fires the sub-agent without
+     *   waiting for its result and returns `{ status: 'delegated' }` immediately.
+     *   Use when sub-agents handle their own delivery via tools (e.g. posting to
+     *   Slack or GitHub directly) and the orchestrator has nothing to relay.
+     *   The LLM naturally outputs an empty string, eliminating any need for
+     *   post-run result extraction.
+     */
+    mode?: 'await' | 'forget';
+}
 /**
  * Input structure for agent invocation.
  * Channels normalize external events into this format.
@@ -188,6 +218,13 @@ interface AgentOutput {
 interface AgentRunOptions {
     /** One-off workflow override for this specific run */
     workflow?: Record<string, unknown>;
+    /**
+     * Hard cap on tool-call rounds for this specific run.
+     * Overrides ToolsConfig.maxToolRounds and bypasses the query-classifier
+     * adjustment. Use this for agents that should only make one tool call
+     * per invocation (e.g. single-shot routers using delegate_to_agent).
+     */
+    maxToolRounds?: number;
 }
 /**
  * Agent instance interface - shape of a BaseAgent instance.
@@ -392,4 +429,4 @@ interface IAgentRegistry {
     cleanupExpiredAsks(): number;
 }
 
-export { type AgentInput as A, type BaseAgentOptions as B, type ChannelInterface as C, type Interceptor as I, type NextFunction as N, type PendingAsk as P, SKIP_SENTINEL as S, type WorkflowStep as W, type AgentResult as a, type IAgentRegistry as b, type AgentRunOptions as c, type AgentOutput as d, type AgentInstance as e, type InterceptorChainConfig as f, type InterceptorContext as g, type InterceptorResult as h, isSkipSentinel as i, skip as s };
+export { type AgentInput as A, type BaseAgentOptions as B, type ChannelInterface as C, type Interceptor as I, type NextFunction as N, type PendingAsk as P, SKIP_SENTINEL as S, type WorkflowStep as W, type AgentResult as a, type AgentDelegationConfig as b, type IAgentRegistry as c, type AgentRunOptions as d, type AgentOutput as e, type AgentInstance as f, type InterceptorChainConfig as g, type InterceptorContext as h, type InterceptorResult as i, isSkipSentinel as j, skip as s };

package/dist/{types-BWoRx1ZE.d.ts → types-TB6yypig.d.ts}

@@ -122,6 +122,36 @@ type BaseAgentOptions = {
 } | {
     toolpack: Toolpack;
 };
+/**
+ * Configuration for AI-driven agent delegation.
+ * When enabled, a delegation tool is injected into every `run()` call
+ * so the LLM can decide which peer agent to hand the task to.
+ */
+interface AgentDelegationConfig {
+    /** Must be true for the delegation tool to be injected. */
+    enabled: boolean;
+    /**
+     * Restrict which peer agents can be delegated to.
+     * When set, only the named agents appear in the tool's enum.
+     * When omitted, all peers in the registry are available.
+     */
+    allowedAgents?: string[];
+    /**
+     * Delegation mode.
+     *
+     * - `'await'` (default) — injects `delegate_to_agent`: calls the sub-agent,
+     *   waits for its result, and returns it to the LLM. Use when the orchestrator
+     *   needs to relay or act on the sub-agent's response.
+     *
+     * - `'forget'` — injects `delegate_and_forget`: fires the sub-agent without
+     *   waiting for its result and returns `{ status: 'delegated' }` immediately.
+     *   Use when sub-agents handle their own delivery via tools (e.g. posting to
+     *   Slack or GitHub directly) and the orchestrator has nothing to relay.
+     *   The LLM naturally outputs an empty string, eliminating any need for
+     *   post-run result extraction.
+     */
+    mode?: 'await' | 'forget';
+}
 /**
  * Input structure for agent invocation.
  * Channels normalize external events into this format.
@@ -188,6 +218,13 @@ interface AgentOutput {
 interface AgentRunOptions {
     /** One-off workflow override for this specific run */
     workflow?: Record<string, unknown>;
+    /**
+     * Hard cap on tool-call rounds for this specific run.
+     * Overrides ToolsConfig.maxToolRounds and bypasses the query-classifier
+     * adjustment. Use this for agents that should only make one tool call
+     * per invocation (e.g. single-shot routers using delegate_to_agent).
+     */
+    maxToolRounds?: number;
 }
 /**
  * Agent instance interface - shape of a BaseAgent instance.
@@ -392,4 +429,4 @@ interface IAgentRegistry {
     cleanupExpiredAsks(): number;
 }
 
-export { type AgentInput as A, type BaseAgentOptions as B, type ChannelInterface as C, type Interceptor as I, type NextFunction as N, type PendingAsk as P, SKIP_SENTINEL as S, type WorkflowStep as W, type AgentResult as a, type IAgentRegistry as b, type AgentRunOptions as c, type AgentOutput as d, type AgentInstance as e, type InterceptorChainConfig as f, type InterceptorContext as g, type InterceptorResult as h, isSkipSentinel as i, skip as s };
+export { type AgentInput as A, type BaseAgentOptions as B, type ChannelInterface as C, type Interceptor as I, type NextFunction as N, type PendingAsk as P, SKIP_SENTINEL as S, type WorkflowStep as W, type AgentResult as a, type AgentDelegationConfig as b, type IAgentRegistry as c, type AgentRunOptions as d, type AgentOutput as e, type AgentInstance as f, type InterceptorChainConfig as g, type InterceptorContext as h, type InterceptorResult as i, isSkipSentinel as j, skip as s };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toolpack-sdk/agents",
-  "version": "2.0.0-alpha.1",
+  "version": "2.0.0",
   "description": "Agent layer for the Toolpack SDK - build, compose, and deploy AI agents with a consistent, extensible pattern",
   "engines": {
     "node": ">=20"
@@ -46,7 +46,7 @@
     "README.md"
   ],
   "publishConfig": {
-    "tag": "alpha",
+    "tag": "latest",
     "access": "public"
   },
   "scripts": {
@@ -83,11 +83,11 @@
     "url": "https://github.com/toolpack-ai/toolpack-sdk/issues"
   },
   "peerDependencies": {
-    "@toolpack-sdk/knowledge": "^2.0.0-alpha.1",
-    "better-sqlite3": "^11.x",
+    "@toolpack-sdk/knowledge": "^2.0.0",
+    "better-sqlite3": "^12.6.2",
     "discord.js": "^14.x",
     "nodemailer": "^6.x",
-    "toolpack-sdk": "^2.0.0-alpha.1",
+    "toolpack-sdk": "^2.0.0",
     "twilio": "^5.x"
   },
   "peerDependenciesMeta": {