@toolpack-sdk/agents 2.7.0 → 3.1.0

package/README.md

@@ -22,7 +22,7 @@ Build production-ready AI agents with channels, workflows, and event-driven arch
 ## Installation
 
 ```bash
-npm install @toolpack-sdk/agents
+npm install toolpack-sdk @toolpack-sdk/agents
 ```
 
 ## Stable API (Phase 4)
@@ -561,9 +561,12 @@ const toolpack = await Toolpack.init({
 
 ## Peer Dependencies
 
-The following are optional peer dependencies. Install only what you need:
+Requires `toolpack-sdk` (`^3.1.0`). Optional peers — install only what you need:
 
 ```bash
+# Knowledge / RAG (optional)
+npm install @toolpack-sdk/knowledge
+
 # For DiscordChannel
 npm install discord.js
 
@@ -1065,6 +1068,71 @@ console.log(formatEvalReport(report));
 expect(report.regressions).toHaveLength(0); // CI gate
 ```
 
+## Stopping Agents
+
+Every `AgentInput` and `AgentRunOptions` accepts an optional `signal?: AbortSignal`. Passing a signal lets you cancel an in-flight agent run from outside.
+
+### Basic pattern
+
+```typescript
+import { BaseAgent } from '@toolpack-sdk/agents';
+
+const controller = new AbortController();
+
+// Pass the signal when invoking the agent
+const resultPromise = agent.invokeAgent({
+  message: 'Do something long-running',
+  signal: controller.signal,
+});
+
+// Abort from wherever you need — HTTP stop endpoint, UI button, timeout, etc.
+controller.abort();
+
+const result = await resultPromise;
+// result.output will indicate the run was stopped
+```
+
+### In a web server (stop endpoint)
+
+```typescript
+const activeRuns = new Map<string, AbortController>();
+
+app.post('/api/chat', async (req, res) => {
+  const { sessionId, message } = req.body;
+  const controller = new AbortController();
+  activeRuns.set(sessionId, controller);
+
+  const result = await agent.invokeAgent({ message, signal: controller.signal });
+  activeRuns.delete(sessionId);
+
+  res.json(result);
+});
+
+app.post('/api/chat/stop', (req, res) => {
+  const controller = activeRuns.get(req.body.sessionId);
+  if (controller) {
+    controller.abort();
+    activeRuns.delete(req.body.sessionId);
+  }
+  res.json({ ok: true });
+});
+```
+
+### Signal propagation through delegation
+
+When you pass `signal` to `invokeAgent()`, it is automatically propagated into any sub-agents spawned via `delegate_to_agent` or `delegate_and_forget`. You do not need to pass the signal manually to delegated agents — the parent agent's abort signal flows through the entire delegation chain.
+
+```typescript
+// Aborting the root agent also stops all delegated sub-agents
+const controller = new AbortController();
+await executiveAgent.invokeAgent({ message: '...', signal: controller.signal });
+controller.abort(); // stops executive + all delegates it spawned
+```
+
+### Limitation
+
+The signal fires at **tool-round boundaries**, not mid-tool-execution. A running tool call (including a delegation) finishes its current step before the abort is observed. Sub-agents stop at their own next round boundary once the signal is propagated. This is the standard behavior for cooperative cancellation with `AbortSignal`.
+
 ## Testing
 
 ```bash

package/dist/{base-agent-BMZWBdkt.d.ts → base-agent-CJE2QCjY.d.ts}

@@ -1,6 +1,6 @@
 import { EventEmitter } from 'events';
 import { ModeConfig, ConversationStore, AssemblerOptions, Toolpack } from 'toolpack-sdk';
-import { A as AgentInput, W as WorkflowStep, a as AgentResult, b as AgentDelegationConfig, c as AgentSpawnConfig, C as ChannelInterface, I as Interceptor, d as IAgentRegistry, B as BaseAgentOptions, e as AgentRunOptions, P as PendingAsk } from './types-C3EZvpe0.js';
+import { A as AgentInput, W as WorkflowStep, a as AgentResult, b as AgentDelegationConfig, c as AgentSpawnConfig, C as ChannelInterface, I as Interceptor, d as IAgentRegistry, B as BaseAgentOptions, e as AgentRunOptions, P as PendingAsk } from './types-CJinv165.js';
 import { Embedder, KnowledgeProvider } from '@toolpack-sdk/knowledge';
 
 type GoalStatus = 'active' | 'completed';
@@ -145,17 +145,11 @@ declare abstract class BaseAgent<TIntent extends string = string> extends EventE
     /** Reference to the registry for sendTo() and delegation support */
     _registry?: IAgentRegistry;
     /**
-     * Invocation-scoped context fields — set by `_bindChannel` immediately before
-     * calling `invokeAgent` and read inside `run()`, `ask()`, and `delegate()`.
-     *
-     * KNOWN LIMITATION: these are instance-level fields, not async-local storage.
-     * Two different conversations processed concurrently by the same agent can
-     * clobber each other's values. The conversation lock serialises within a single
-     * conversationId, but distinct conversationIds run concurrently.
-     *
-     * Fix: replace with `AsyncLocalStorage` in a future release. For now, agents
-     * that call `this.run()` while processing multiple concurrent conversations
-     * should pass `conversationId` explicitly to avoid relying on these fields.
+     * Legacy fallback fields for code that calls `invokeAgent()` directly (no channel).
+     * Channel-driven flows no longer write to these — `_bindChannel` establishes an
+     * async-local context (`_channelCtx`) so concurrent conversations on the same
+     * agent instance never clobber each other. These remain for backward compatibility
+     * with direct callers that set `_conversationId` manually before invoking.
      */
     _triggeringChannel?: string;
     _conversationId?: string;

package/dist/{base-agent-DVwGO20L.d.cts → base-agent-iaQiO7jW.d.cts}

@@ -1,6 +1,6 @@
 import { EventEmitter } from 'events';
 import { ModeConfig, ConversationStore, AssemblerOptions, Toolpack } from 'toolpack-sdk';
-import { A as AgentInput, W as WorkflowStep, a as AgentResult, b as AgentDelegationConfig, c as AgentSpawnConfig, C as ChannelInterface, I as Interceptor, d as IAgentRegistry, B as BaseAgentOptions, e as AgentRunOptions, P as PendingAsk } from './types-C3EZvpe0.cjs';
+import { A as AgentInput, W as WorkflowStep, a as AgentResult, b as AgentDelegationConfig, c as AgentSpawnConfig, C as ChannelInterface, I as Interceptor, d as IAgentRegistry, B as BaseAgentOptions, e as AgentRunOptions, P as PendingAsk } from './types-CJinv165.cjs';
 import { Embedder, KnowledgeProvider } from '@toolpack-sdk/knowledge';
 
 type GoalStatus = 'active' | 'completed';
@@ -145,17 +145,11 @@ declare abstract class BaseAgent<TIntent extends string = string> extends EventE
     /** Reference to the registry for sendTo() and delegation support */
     _registry?: IAgentRegistry;
     /**
-     * Invocation-scoped context fields — set by `_bindChannel` immediately before
-     * calling `invokeAgent` and read inside `run()`, `ask()`, and `delegate()`.
-     *
-     * KNOWN LIMITATION: these are instance-level fields, not async-local storage.
-     * Two different conversations processed concurrently by the same agent can
-     * clobber each other's values. The conversation lock serialises within a single
-     * conversationId, but distinct conversationIds run concurrently.
-     *
-     * Fix: replace with `AsyncLocalStorage` in a future release. For now, agents
-     * that call `this.run()` while processing multiple concurrent conversations
-     * should pass `conversationId` explicitly to avoid relying on these fields.
+     * Legacy fallback fields for code that calls `invokeAgent()` directly (no channel).
+     * Channel-driven flows no longer write to these — `_bindChannel` establishes an
+     * async-local context (`_channelCtx`) so concurrent conversations on the same
+     * agent instance never clobber each other. These remain for backward compatibility
+     * with direct callers that set `_conversationId` manually before invoking.
      */
     _triggeringChannel?: string;
     _conversationId?: string;

package/dist/capabilities/index.cjs

@@ -3,10 +3,10 @@
 `);this.delegation.mode==="forget"?c.push({name:"delegate_and_forget",displayName:"Delegate and Forget",description:`Hand off the current task to a peer agent. The agent will handle its own delivery (e.g. posting to Slack or GitHub) \u2014 you do not need to relay its response. Call this ONCE, then output an empty string.
 
 Available agents:
-${R}`,category:"agent",parameters:{type:"object",properties:{agent:{type:"string",enum:v,description:"Name of the agent to delegate to."},message:{type:"string",description:"The task or message to pass to the agent."}},required:["agent","message"]},execute:async I=>{let D=String(I.agent),b=String(I.message??"");return this._registry.invoke(D,{message:b,conversationId:n,context:{delegatedBy:this.name}}).catch(C=>{console.error(`[${this.name}] delegate_and_forget to ${D} failed:`,C)}),{status:"delegated",agent:D}}}):c.push({name:"delegate_to_agent",displayName:"Delegate to Agent",description:`Hand off the current task to a peer agent and return its result. Use when the task falls outside your own specialisation.
+${R}`,category:"agent",parameters:{type:"object",properties:{agent:{type:"string",enum:v,description:"Name of the agent to delegate to."},message:{type:"string",description:"The task or message to pass to the agent."}},required:["agent","message"]},execute:async I=>{let D=String(I.agent),b=String(I.message??"");return this._registry.invoke(D,{message:b,conversationId:n,context:{delegatedBy:this.name},signal:t?.signal}).catch(C=>{console.error(`[${this.name}] delegate_and_forget to ${D} failed:`,C)}),{status:"delegated",agent:D}}}):c.push({name:"delegate_to_agent",displayName:"Delegate to Agent",description:`Hand off the current task to a peer agent and return its result. Use when the task falls outside your own specialisation.
 
 Available agents:
-${R}`,category:"agent",parameters:{type:"object",properties:{agent:{type:"string",enum:v,description:"Name of the agent to delegate to."},message:{type:"string",description:"The task or message to pass to the agent."}},required:["agent","message"]},execute:async I=>{let D=String(I.agent),b=String(I.message??""),C=await this._registry.invoke(D,{message:b,conversationId:n,context:{delegatedBy:this.name}});return{...C,output:`[Response from ${D} \u2014 task complete]
+${R}`,category:"agent",parameters:{type:"object",properties:{agent:{type:"string",enum:v,description:"Name of the agent to delegate to."},message:{type:"string",description:"The task or message to pass to the agent."}},required:["agent","message"]},execute:async I=>{let D=String(I.agent),b=String(I.message??""),C=await this._registry.invoke(D,{message:b,conversationId:n,context:{delegatedBy:this.name},signal:t?.signal});return{...C,output:`[Response from ${D} \u2014 task complete]
 
 ${C.output}`}}})}}if(this.spawn?.enabled&&this.spawn.templates.length>0){let y=i?.spawnDepth??0,w=this.spawn,v=w.maxDepth??3;if(y<v){let R=w.templates,I=R.some(k=>k.name==="self"),D=R.some(k=>k.allowPromptAddition),b=R.filter(k=>k.name!=="self").map(k=>`- ${k.name}: ${k.description}`).join(`
 `),C=I?`Use template name "self" to spawn a replica of the current agent.
@@ -26,7 +26,7 @@ ${b}
 
 ${String(P.systemPromptAddition)}`:"",H,q,j,B;if(G==="self"){let W=typeof this.mode=="string"?{...N.AGENT_MODE,name:this.mode}:this.mode,Ae=x.systemPrompt(O);H={...W,name:`${W.name}-replica-${Date.now()}`,systemPrompt:(W.systemPrompt??"")+(Ae?`
 
-${Ae}`:"")+z},q=`${this.name}-replica`,j=this.description,B=this.model}else H={...N.AGENT_MODE,name:`ephemeral-${x.name}-${Date.now()}`,systemPrompt:x.systemPrompt(O)+z},q=x.name,j=x.description,B=x.model;let F=new $(q,j,H,{toolpack:this.toolpack});B&&(F.model=B),F.spawn={...w};let we=await F.invokeAgent({message:O,conversationId:`spawn-${Date.now()}`,context:{spawnedBy:this.name,spawnDepth:y+1}});return{output:we.output,spawnedTemplate:G,depth:y+1,metadata:we.metadata}}))}}})}}let d={messages:u,model:this.model||"",requestTools:c.length>0?c:void 0,maxToolRounds:t?.maxToolRounds,mode:this.mode},l=null,m,g;if(typeof this.mode!="string"&&this.mode?.streaming){let y="";for await(let w of this.toolpack.stream(d,this.provider))y+=w.delta||"",w.usage&&(m=w.usage);l=y||null,g={content:l,usage:m}}else{let y=await this.toolpack.generate(d,this.provider);l=y.content??null,m=y.usage,g=y}let f={output:l||"",steps:this.extractSteps(g),metadata:m?{usage:m}:void 0};return await this.onComplete(f),s&&await s(!1),this.emit("agent:complete",f),f}catch(u){throw s&&s(!0).catch(c=>{console.error(`[${this.name??"agent"}][AgentMind] Draft buffer flush on error failed:`,c)}),await this.onError(u),this.emit("agent:error",u),u}}getAgentAliases(){let e=[];for(let t of this.channels){let i=t.botUserId;i&&e.push(i)}return e}async sendTo(e,t){if(!this._registry)throw new Error("Agent not registered - _registry not set");await this._registry.sendTo(e,{output:t})}async ask(e,t){if(!this._registry)throw new E("Agent not registered - cannot use ask()");let i=this._ctx()?.conversationId??this._conversationId,n=this._ctx()?.isTriggerChannel??this._isTriggerChannel,s=this._ctx()?.triggeringChannel??this._triggeringChannel;if(!i)throw new E("No conversationId available - ask() requires a conversation channel");if(n)throw new E("this.ask() called from a trigger channel (ScheduledChannel). Trigger channels have no human recipient \u2014 use a conversation channel (Slack, Telegram, Webhook) instead.");if(!s||s.trim()==="")throw new E("Cannot use ask() - no triggering channel available. The channel must have a name registered with AgentRegistry.");let o=this._registry.addPendingAsk({conversationId:i,agentName:this.name,question:e,context:t?.context??{},maxRetries:t?.maxRetries??2,expiresAt:t?.expiresIn?new Date(Date.now()+t.expiresIn):void 0,channelName:s});return await this.sendTo(s,e),{output:e,metadata:{waitingForHuman:!0,askId:o.id}}}getPendingAsk(e){if(!this._registry)return null;let t=e??this._ctx()?.conversationId??this._conversationId;return t?this._registry.getPendingAsk(t)??null:null}async resolvePendingAsk(e,t){if(!this._registry)throw new E("Agent not registered - cannot resolve ask");await this._registry.resolvePendingAsk(e,t)}async evaluateAnswer(e,t,i){if(i?.simpleValidation)return i.simpleValidation(t);let n=this._ctx()?.conversationId??this._conversationId;return(await this.run(`Evaluate if this answer sufficiently addresses the question.
+${Ae}`:"")+z},q=`${this.name}-replica`,j=this.description,B=this.model}else H={...N.AGENT_MODE,name:`ephemeral-${x.name}-${Date.now()}`,systemPrompt:x.systemPrompt(O)+z},q=x.name,j=x.description,B=x.model;let F=new $(q,j,H,{toolpack:this.toolpack});B&&(F.model=B),F.spawn={...w};let we=await F.invokeAgent({message:O,conversationId:`spawn-${Date.now()}`,context:{spawnedBy:this.name,spawnDepth:y+1}});return{output:we.output,spawnedTemplate:G,depth:y+1,metadata:we.metadata}}))}}})}}let d={messages:u,model:this.model||"",requestTools:c.length>0?c:void 0,maxToolRounds:t?.maxToolRounds,mode:this.mode,signal:t?.signal},l=null,m,g;if(typeof this.mode!="string"&&this.mode?.streaming){let y="";for await(let w of this.toolpack.stream(d,this.provider))y+=w.delta||"",w.usage&&(m=w.usage);l=y||null,g={content:l,usage:m}}else{let y=await this.toolpack.generate(d,this.provider);l=y.content??null,m=y.usage,g=y}let f={output:l||"",steps:this.extractSteps(g),metadata:m?{usage:m}:void 0};return await this.onComplete(f),s&&await s(!1),this.emit("agent:complete",f),f}catch(u){throw s&&s(!0).catch(c=>{console.error(`[${this.name??"agent"}][AgentMind] Draft buffer flush on error failed:`,c)}),await this.onError(u),this.emit("agent:error",u),u}}getAgentAliases(){let e=[];for(let t of this.channels){let i=t.botUserId;i&&e.push(i)}return e}async sendTo(e,t){if(!this._registry)throw new Error("Agent not registered - _registry not set");await this._registry.sendTo(e,{output:t})}async ask(e,t){if(!this._registry)throw new E("Agent not registered - cannot use ask()");let i=this._ctx()?.conversationId??this._conversationId,n=this._ctx()?.isTriggerChannel??this._isTriggerChannel,s=this._ctx()?.triggeringChannel??this._triggeringChannel;if(!i)throw new E("No conversationId available - ask() requires a conversation channel");if(n)throw new E("this.ask() called from a trigger channel (ScheduledChannel). Trigger channels have no human recipient \u2014 use a conversation channel (Slack, Telegram, Webhook) instead.");if(!s||s.trim()==="")throw new E("Cannot use ask() - no triggering channel available. The channel must have a name registered with AgentRegistry.");let o=this._registry.addPendingAsk({conversationId:i,agentName:this.name,question:e,context:t?.context??{},maxRetries:t?.maxRetries??2,expiresAt:t?.expiresIn?new Date(Date.now()+t.expiresIn):void 0,channelName:s});return await this.sendTo(s,e),{output:e,metadata:{waitingForHuman:!0,askId:o.id}}}getPendingAsk(e){if(!this._registry)return null;let t=e??this._ctx()?.conversationId??this._conversationId;return t?this._registry.getPendingAsk(t)??null:null}async resolvePendingAsk(e,t){if(!this._registry)throw new E("Agent not registered - cannot resolve ask");await this._registry.resolvePendingAsk(e,t)}async evaluateAnswer(e,t,i){if(i?.simpleValidation)return i.simpleValidation(t);let n=this._ctx()?.conversationId??this._conversationId;return(await this.run(`Evaluate if this answer sufficiently addresses the question.
 
 Question: "${e}"
 Answer: "${t}"

package/dist/capabilities/index.d.cts

@@ -1,6 +1,6 @@
-export { I as IntentClassification, a as IntentClassifierAgent, b as IntentClassifierInput } from '../intent-classifier-agent-DVCbBtdY.cjs';
-import { B as BaseAgentOptions, A as AgentInput, a as AgentResult } from '../types-C3EZvpe0.cjs';
-import { B as BaseAgent } from '../base-agent-DVwGO20L.cjs';
+export { I as IntentClassification, a as IntentClassifierAgent, b as IntentClassifierInput } from '../intent-classifier-agent-CEmRGpUr.cjs';
+import { B as BaseAgentOptions, A as AgentInput, a as AgentResult } from '../types-CJinv165.cjs';
+import { B as BaseAgent } from '../base-agent-iaQiO7jW.cjs';
 import { Participant, ModeConfig } from 'toolpack-sdk';
 export { Participant } from 'toolpack-sdk';
 import 'events';

package/dist/capabilities/index.d.ts

@@ -1,6 +1,6 @@
-export { I as IntentClassification, a as IntentClassifierAgent, b as IntentClassifierInput } from '../intent-classifier-agent-BnpchAoZ.js';
-import { B as BaseAgentOptions, A as AgentInput, a as AgentResult } from '../types-C3EZvpe0.js';
-import { B as BaseAgent } from '../base-agent-BMZWBdkt.js';
+export { I as IntentClassification, a as IntentClassifierAgent, b as IntentClassifierInput } from '../intent-classifier-agent-QuB4WIWf.js';
+import { B as BaseAgentOptions, A as AgentInput, a as AgentResult } from '../types-CJinv165.js';
+import { B as BaseAgent } from '../base-agent-CJE2QCjY.js';
 import { Participant, ModeConfig } from 'toolpack-sdk';
 export { Participant } from 'toolpack-sdk';
 import 'events';

package/dist/capabilities/index.js

@@ -3,10 +3,10 @@ var qe=Object.defineProperty;var D=(r,e)=>()=>(r&&(e=r(r=0)),e);var we=(r,e)=>{f
 `);this.delegation.mode==="forget"?c.push({name:"delegate_and_forget",displayName:"Delegate and Forget",description:`Hand off the current task to a peer agent. The agent will handle its own delivery (e.g. posting to Slack or GitHub) \u2014 you do not need to relay its response. Call this ONCE, then output an empty string.
 
 Available agents:
-${R}`,category:"agent",parameters:{type:"object",properties:{agent:{type:"string",enum:v,description:"Name of the agent to delegate to."},message:{type:"string",description:"The task or message to pass to the agent."}},required:["agent","message"]},execute:async I=>{let P=String(I.agent),b=String(I.message??"");return this._registry.invoke(P,{message:b,conversationId:i,context:{delegatedBy:this.name}}).catch(x=>{console.error(`[${this.name}] delegate_and_forget to ${P} failed:`,x)}),{status:"delegated",agent:P}}}):c.push({name:"delegate_to_agent",displayName:"Delegate to Agent",description:`Hand off the current task to a peer agent and return its result. Use when the task falls outside your own specialisation.
+${R}`,category:"agent",parameters:{type:"object",properties:{agent:{type:"string",enum:v,description:"Name of the agent to delegate to."},message:{type:"string",description:"The task or message to pass to the agent."}},required:["agent","message"]},execute:async I=>{let P=String(I.agent),b=String(I.message??"");return this._registry.invoke(P,{message:b,conversationId:i,context:{delegatedBy:this.name},signal:t?.signal}).catch(x=>{console.error(`[${this.name}] delegate_and_forget to ${P} failed:`,x)}),{status:"delegated",agent:P}}}):c.push({name:"delegate_to_agent",displayName:"Delegate to Agent",description:`Hand off the current task to a peer agent and return its result. Use when the task falls outside your own specialisation.
 
 Available agents:
-${R}`,category:"agent",parameters:{type:"object",properties:{agent:{type:"string",enum:v,description:"Name of the agent to delegate to."},message:{type:"string",description:"The task or message to pass to the agent."}},required:["agent","message"]},execute:async I=>{let P=String(I.agent),b=String(I.message??""),x=await this._registry.invoke(P,{message:b,conversationId:i,context:{delegatedBy:this.name}});return{...x,output:`[Response from ${P} \u2014 task complete]
+${R}`,category:"agent",parameters:{type:"object",properties:{agent:{type:"string",enum:v,description:"Name of the agent to delegate to."},message:{type:"string",description:"The task or message to pass to the agent."}},required:["agent","message"]},execute:async I=>{let P=String(I.agent),b=String(I.message??""),x=await this._registry.invoke(P,{message:b,conversationId:i,context:{delegatedBy:this.name},signal:t?.signal});return{...x,output:`[Response from ${P} \u2014 task complete]
 
 ${x.output}`}}})}}if(this.spawn?.enabled&&this.spawn.templates.length>0){let y=n?.spawnDepth??0,w=this.spawn,v=w.maxDepth??3;if(y<v){let R=w.templates,I=R.some(k=>k.name==="self"),P=R.some(k=>k.allowPromptAddition),b=R.filter(k=>k.name!=="self").map(k=>`- ${k.name}: ${k.description}`).join(`
 `),x=I?`Use template name "self" to spawn a replica of the current agent.
@@ -26,7 +26,7 @@ ${b}
 
 ${String(B.systemPromptAddition)}`:"",H,q,j,E;if(G==="self"){let W=typeof this.mode=="string"?{...X,name:this.mode}:this.mode,ye=C.systemPrompt(O);H={...W,name:`${W.name}-replica-${Date.now()}`,systemPrompt:(W.systemPrompt??"")+(ye?`
 
-${ye}`:"")+z},q=`${this.name}-replica`,j=this.description,E=this.model}else H={...X,name:`ephemeral-${C.name}-${Date.now()}`,systemPrompt:C.systemPrompt(O)+z},q=C.name,j=C.description,E=C.model;let F=new $(q,j,H,{toolpack:this.toolpack});E&&(F.model=E),F.spawn={...w};let he=await F.invokeAgent({message:O,conversationId:`spawn-${Date.now()}`,context:{spawnedBy:this.name,spawnDepth:y+1}});return{output:he.output,spawnedTemplate:G,depth:y+1,metadata:he.metadata}}))}}})}}let d={messages:u,model:this.model||"",requestTools:c.length>0?c:void 0,maxToolRounds:t?.maxToolRounds,mode:this.mode},l=null,m,g;if(typeof this.mode!="string"&&this.mode?.streaming){let y="";for await(let w of this.toolpack.stream(d,this.provider))y+=w.delta||"",w.usage&&(m=w.usage);l=y||null,g={content:l,usage:m}}else{let y=await this.toolpack.generate(d,this.provider);l=y.content??null,m=y.usage,g=y}let f={output:l||"",steps:this.extractSteps(g),metadata:m?{usage:m}:void 0};return await this.onComplete(f),s&&await s(!1),this.emit("agent:complete",f),f}catch(u){throw s&&s(!0).catch(c=>{console.error(`[${this.name??"agent"}][AgentMind] Draft buffer flush on error failed:`,c)}),await this.onError(u),this.emit("agent:error",u),u}}getAgentAliases(){let e=[];for(let t of this.channels){let n=t.botUserId;n&&e.push(n)}return e}async sendTo(e,t){if(!this._registry)throw new Error("Agent not registered - _registry not set");await this._registry.sendTo(e,{output:t})}async ask(e,t){if(!this._registry)throw new N("Agent not registered - cannot use ask()");let n=this._ctx()?.conversationId??this._conversationId,i=this._ctx()?.isTriggerChannel??this._isTriggerChannel,s=this._ctx()?.triggeringChannel??this._triggeringChannel;if(!n)throw new N("No conversationId available - ask() requires a conversation channel");if(i)throw new N("this.ask() called from a trigger channel (ScheduledChannel). Trigger channels have no human recipient \u2014 use a conversation channel (Slack, Telegram, Webhook) instead.");if(!s||s.trim()==="")throw new N("Cannot use ask() - no triggering channel available. The channel must have a name registered with AgentRegistry.");let o=this._registry.addPendingAsk({conversationId:n,agentName:this.name,question:e,context:t?.context??{},maxRetries:t?.maxRetries??2,expiresAt:t?.expiresIn?new Date(Date.now()+t.expiresIn):void 0,channelName:s});return await this.sendTo(s,e),{output:e,metadata:{waitingForHuman:!0,askId:o.id}}}getPendingAsk(e){if(!this._registry)return null;let t=e??this._ctx()?.conversationId??this._conversationId;return t?this._registry.getPendingAsk(t)??null:null}async resolvePendingAsk(e,t){if(!this._registry)throw new N("Agent not registered - cannot resolve ask");await this._registry.resolvePendingAsk(e,t)}async evaluateAnswer(e,t,n){if(n?.simpleValidation)return n.simpleValidation(t);let i=this._ctx()?.conversationId??this._conversationId;return(await this.run(`Evaluate if this answer sufficiently addresses the question.
+${ye}`:"")+z},q=`${this.name}-replica`,j=this.description,E=this.model}else H={...X,name:`ephemeral-${C.name}-${Date.now()}`,systemPrompt:C.systemPrompt(O)+z},q=C.name,j=C.description,E=C.model;let F=new $(q,j,H,{toolpack:this.toolpack});E&&(F.model=E),F.spawn={...w};let he=await F.invokeAgent({message:O,conversationId:`spawn-${Date.now()}`,context:{spawnedBy:this.name,spawnDepth:y+1}});return{output:he.output,spawnedTemplate:G,depth:y+1,metadata:he.metadata}}))}}})}}let d={messages:u,model:this.model||"",requestTools:c.length>0?c:void 0,maxToolRounds:t?.maxToolRounds,mode:this.mode,signal:t?.signal},l=null,m,g;if(typeof this.mode!="string"&&this.mode?.streaming){let y="";for await(let w of this.toolpack.stream(d,this.provider))y+=w.delta||"",w.usage&&(m=w.usage);l=y||null,g={content:l,usage:m}}else{let y=await this.toolpack.generate(d,this.provider);l=y.content??null,m=y.usage,g=y}let f={output:l||"",steps:this.extractSteps(g),metadata:m?{usage:m}:void 0};return await this.onComplete(f),s&&await s(!1),this.emit("agent:complete",f),f}catch(u){throw s&&s(!0).catch(c=>{console.error(`[${this.name??"agent"}][AgentMind] Draft buffer flush on error failed:`,c)}),await this.onError(u),this.emit("agent:error",u),u}}getAgentAliases(){let e=[];for(let t of this.channels){let n=t.botUserId;n&&e.push(n)}return e}async sendTo(e,t){if(!this._registry)throw new Error("Agent not registered - _registry not set");await this._registry.sendTo(e,{output:t})}async ask(e,t){if(!this._registry)throw new N("Agent not registered - cannot use ask()");let n=this._ctx()?.conversationId??this._conversationId,i=this._ctx()?.isTriggerChannel??this._isTriggerChannel,s=this._ctx()?.triggeringChannel??this._triggeringChannel;if(!n)throw new N("No conversationId available - ask() requires a conversation channel");if(i)throw new N("this.ask() called from a trigger channel (ScheduledChannel). Trigger channels have no human recipient \u2014 use a conversation channel (Slack, Telegram, Webhook) instead.");if(!s||s.trim()==="")throw new N("Cannot use ask() - no triggering channel available. The channel must have a name registered with AgentRegistry.");let o=this._registry.addPendingAsk({conversationId:n,agentName:this.name,question:e,context:t?.context??{},maxRetries:t?.maxRetries??2,expiresAt:t?.expiresIn?new Date(Date.now()+t.expiresIn):void 0,channelName:s});return await this.sendTo(s,e),{output:e,metadata:{waitingForHuman:!0,askId:o.id}}}getPendingAsk(e){if(!this._registry)return null;let t=e??this._ctx()?.conversationId??this._conversationId;return t?this._registry.getPendingAsk(t)??null:null}async resolvePendingAsk(e,t){if(!this._registry)throw new N("Agent not registered - cannot resolve ask");await this._registry.resolvePendingAsk(e,t)}async evaluateAnswer(e,t,n){if(n?.simpleValidation)return n.simpleValidation(t);let i=this._ctx()?.conversationId??this._conversationId;return(await this.run(`Evaluate if this answer sufficiently addresses the question.
 
 Question: "${e}"
 Answer: "${t}"

package/dist/channels/index.d.cts

@@ -1,4 +1,4 @@
-export { B as BaseChannel, D as DiscordChannel, b as DiscordChannelConfig, E as EmailChannel, c as EmailChannelConfig, M as McpChannel, d as McpChannelConfig, e as SMSChannel, f as SMSChannelConfig, g as ScheduledChannel, h as ScheduledChannelConfig, j as SlackChannel, k as SlackChannelConfig, T as TelegramChannel, l as TelegramChannelConfig, W as WebhookChannel, m as WebhookChannelConfig } from '../index-BWrYFJtb.cjs';
-import '../types-C3EZvpe0.cjs';
+export { B as BaseChannel, D as DiscordChannel, b as DiscordChannelConfig, E as EmailChannel, c as EmailChannelConfig, M as McpChannel, d as McpChannelConfig, e as SMSChannel, f as SMSChannelConfig, g as ScheduledChannel, h as ScheduledChannelConfig, j as SlackChannel, k as SlackChannelConfig, T as TelegramChannel, l as TelegramChannelConfig, W as WebhookChannel, m as WebhookChannelConfig } from '../index-a2wZU6Eu.cjs';
+import '../types-CJinv165.cjs';
 import 'toolpack-sdk';
 import 'events';

package/dist/channels/index.d.ts

@@ -1,4 +1,4 @@
-export { B as BaseChannel, D as DiscordChannel, b as DiscordChannelConfig, E as EmailChannel, c as EmailChannelConfig, M as McpChannel, d as McpChannelConfig, e as SMSChannel, f as SMSChannelConfig, g as ScheduledChannel, h as ScheduledChannelConfig, j as SlackChannel, k as SlackChannelConfig, T as TelegramChannel, l as TelegramChannelConfig, W as WebhookChannel, m as WebhookChannelConfig } from '../index-BU2BchV0.js';
-import '../types-C3EZvpe0.js';
+export { B as BaseChannel, D as DiscordChannel, b as DiscordChannelConfig, E as EmailChannel, c as EmailChannelConfig, M as McpChannel, d as McpChannelConfig, e as SMSChannel, f as SMSChannelConfig, g as ScheduledChannel, h as ScheduledChannelConfig, j as SlackChannel, k as SlackChannelConfig, T as TelegramChannel, l as TelegramChannelConfig, W as WebhookChannel, m as WebhookChannelConfig } from '../index-DQuf4mxT.js';
+import '../types-CJinv165.js';
 import 'toolpack-sdk';
 import 'events';

package/dist/{eval-report-BJEzzuSk.d.ts → eval-report-0O9AlW7u.d.ts}

@@ -1,4 +1,4 @@
-import { B as BaseAgent } from './base-agent-BMZWBdkt.js';
+import { B as BaseAgent } from './base-agent-CJE2QCjY.js';
 
 /**
  * Eval primitives — shared types across EvalDataset, EvalRunner, EvalScorer, and EvalReport.

package/dist/{eval-report-DH2tt6Ad.d.cts → eval-report-DUlkrBuJ.d.cts}

@@ -1,4 +1,4 @@
-import { B as BaseAgent } from './base-agent-DVwGO20L.cjs';
+import { B as BaseAgent } from './base-agent-iaQiO7jW.cjs';
 
 /**
  * Eval primitives — shared types across EvalDataset, EvalRunner, EvalScorer, and EvalReport.

package/dist/{index-BU2BchV0.d.ts → index-DQuf4mxT.d.ts}

@@ -1,4 +1,4 @@
-import { A as AgentInput, f as AgentOutput } from './types-C3EZvpe0.js';
+import { A as AgentInput, f as AgentOutput } from './types-CJinv165.js';
 import { Participant } from 'toolpack-sdk';
 
 /**

package/dist/{index-BWrYFJtb.d.cts → index-a2wZU6Eu.d.cts}

@@ -1,4 +1,4 @@
-import { A as AgentInput, f as AgentOutput } from './types-C3EZvpe0.cjs';
+import { A as AgentInput, f as AgentOutput } from './types-CJinv165.cjs';
 import { Participant } from 'toolpack-sdk';
 
 /**

package/dist/index.cjs

@@ -3,10 +3,10 @@
 `);this.delegation.mode==="forget"?d.push({name:"delegate_and_forget",displayName:"Delegate and Forget",description:`Hand off the current task to a peer agent. The agent will handle its own delivery (e.g. posting to Slack or GitHub) \u2014 you do not need to relay its response. Call this ONCE, then output an empty string.
 
 Available agents:
-${S}`,category:"agent",parameters:{type:"object",properties:{agent:{type:"string",enum:b,description:"Name of the agent to delegate to."},message:{type:"string",description:"The task or message to pass to the agent."}},required:["agent","message"]},execute:async I=>{let P=String(I.agent),k=String(I.message??"");return this._registry.invoke(P,{message:k,conversationId:r,context:{delegatedBy:this.name}}).catch(_=>{console.error(`[${this.name}] delegate_and_forget to ${P} failed:`,_)}),{status:"delegated",agent:P}}}):d.push({name:"delegate_to_agent",displayName:"Delegate to Agent",description:`Hand off the current task to a peer agent and return its result. Use when the task falls outside your own specialisation.
+${S}`,category:"agent",parameters:{type:"object",properties:{agent:{type:"string",enum:b,description:"Name of the agent to delegate to."},message:{type:"string",description:"The task or message to pass to the agent."}},required:["agent","message"]},execute:async I=>{let P=String(I.agent),k=String(I.message??"");return this._registry.invoke(P,{message:k,conversationId:r,context:{delegatedBy:this.name},signal:t?.signal}).catch(_=>{console.error(`[${this.name}] delegate_and_forget to ${P} failed:`,_)}),{status:"delegated",agent:P}}}):d.push({name:"delegate_to_agent",displayName:"Delegate to Agent",description:`Hand off the current task to a peer agent and return its result. Use when the task falls outside your own specialisation.
 
 Available agents:
-${S}`,category:"agent",parameters:{type:"object",properties:{agent:{type:"string",enum:b,description:"Name of the agent to delegate to."},message:{type:"string",description:"The task or message to pass to the agent."}},required:["agent","message"]},execute:async I=>{let P=String(I.agent),k=String(I.message??""),_=await this._registry.invoke(P,{message:k,conversationId:r,context:{delegatedBy:this.name}});return{..._,output:`[Response from ${P} \u2014 task complete]
+${S}`,category:"agent",parameters:{type:"object",properties:{agent:{type:"string",enum:b,description:"Name of the agent to delegate to."},message:{type:"string",description:"The task or message to pass to the agent."}},required:["agent","message"]},execute:async I=>{let P=String(I.agent),k=String(I.message??""),_=await this._registry.invoke(P,{message:k,conversationId:r,context:{delegatedBy:this.name},signal:t?.signal});return{..._,output:`[Response from ${P} \u2014 task complete]
 
 ${_.output}`}}})}}if(this.spawn?.enabled&&this.spawn.templates.length>0){let v=n?.spawnDepth??0,A=this.spawn,b=A.maxDepth??3;if(v<b){let S=A.templates,I=S.some(C=>C.name==="self"),P=S.some(C=>C.allowPromptAddition),k=S.filter(C=>C.name!=="self").map(C=>`- ${C.name}: ${C.description}`).join(`
 `),_=I?`Use template name "self" to spawn a replica of the current agent.
@@ -26,7 +26,7 @@ ${k}
 
 ${String(O.systemPromptAddition)}`:"",re,W,Y,$;if(J==="self"){let se=typeof this.mode=="string"?{...U.AGENT_MODE,name:this.mode}:this.mode,Pt=E.systemPrompt(q);re={...se,name:`${se.name}-replica-${Date.now()}`,systemPrompt:(se.systemPrompt??"")+(Pt?`
 
-${Pt}`:"")+ne},W=`${this.name}-replica`,Y=this.description,$=this.model}else re={...U.AGENT_MODE,name:`ephemeral-${E.name}-${Date.now()}`,systemPrompt:E.systemPrompt(q)+ne},W=E.name,Y=E.description,$=E.model;let X=new G(W,Y,re,{toolpack:this.toolpack});$&&(X.model=$),X.spawn={...A};let Et=await X.invokeAgent({message:q,conversationId:`spawn-${Date.now()}`,context:{spawnedBy:this.name,spawnDepth:v+1}});return{output:Et.output,spawnedTemplate:J,depth:v+1,metadata:Et.metadata}}))}}})}}let p={messages:l,model:this.model||"",requestTools:d.length>0?d:void 0,maxToolRounds:t?.maxToolRounds,mode:this.mode},g=null,u,m;if(typeof this.mode!="string"&&this.mode?.streaming){let v="";for await(let A of this.toolpack.stream(p,this.provider))v+=A.delta||"",A.usage&&(u=A.usage);g=v||null,m={content:g,usage:u}}else{let v=await this.toolpack.generate(p,this.provider);g=v.content??null,u=v.usage,m=v}let y={output:g||"",steps:this.extractSteps(m),metadata:u?{usage:u}:void 0};return await this.onComplete(y),s&&await s(!1),this.emit("agent:complete",y),y}catch(l){throw s&&s(!0).catch(d=>{console.error(`[${this.name??"agent"}][AgentMind] Draft buffer flush on error failed:`,d)}),await this.onError(l),this.emit("agent:error",l),l}}getAgentAliases(){let e=[];for(let t of this.channels){let n=t.botUserId;n&&e.push(n)}return e}async sendTo(e,t){if(!this._registry)throw new Error("Agent not registered - _registry not set");await this._registry.sendTo(e,{output:t})}async ask(e,t){if(!this._registry)throw new R("Agent not registered - cannot use ask()");let n=this._ctx()?.conversationId??this._conversationId,r=this._ctx()?.isTriggerChannel??this._isTriggerChannel,s=this._ctx()?.triggeringChannel??this._triggeringChannel;if(!n)throw new R("No conversationId available - ask() requires a conversation channel");if(r)throw new R("this.ask() called from a trigger channel (ScheduledChannel). Trigger channels have no human recipient \u2014 use a conversation channel (Slack, Telegram, Webhook) instead.");if(!s||s.trim()==="")throw new R("Cannot use ask() - no triggering channel available. The channel must have a name registered with AgentRegistry.");let i=this._registry.addPendingAsk({conversationId:n,agentName:this.name,question:e,context:t?.context??{},maxRetries:t?.maxRetries??2,expiresAt:t?.expiresIn?new Date(Date.now()+t.expiresIn):void 0,channelName:s});return await this.sendTo(s,e),{output:e,metadata:{waitingForHuman:!0,askId:i.id}}}getPendingAsk(e){if(!this._registry)return null;let t=e??this._ctx()?.conversationId??this._conversationId;return t?this._registry.getPendingAsk(t)??null:null}async resolvePendingAsk(e,t){if(!this._registry)throw new R("Agent not registered - cannot resolve ask");await this._registry.resolvePendingAsk(e,t)}async evaluateAnswer(e,t,n){if(n?.simpleValidation)return n.simpleValidation(t);let r=this._ctx()?.conversationId??this._conversationId;return(await this.run(`Evaluate if this answer sufficiently addresses the question.
+${Pt}`:"")+ne},W=`${this.name}-replica`,Y=this.description,$=this.model}else re={...U.AGENT_MODE,name:`ephemeral-${E.name}-${Date.now()}`,systemPrompt:E.systemPrompt(q)+ne},W=E.name,Y=E.description,$=E.model;let X=new G(W,Y,re,{toolpack:this.toolpack});$&&(X.model=$),X.spawn={...A};let Et=await X.invokeAgent({message:q,conversationId:`spawn-${Date.now()}`,context:{spawnedBy:this.name,spawnDepth:v+1}});return{output:Et.output,spawnedTemplate:J,depth:v+1,metadata:Et.metadata}}))}}})}}let p={messages:l,model:this.model||"",requestTools:d.length>0?d:void 0,maxToolRounds:t?.maxToolRounds,mode:this.mode,signal:t?.signal},g=null,u,m;if(typeof this.mode!="string"&&this.mode?.streaming){let v="";for await(let A of this.toolpack.stream(p,this.provider))v+=A.delta||"",A.usage&&(u=A.usage);g=v||null,m={content:g,usage:u}}else{let v=await this.toolpack.generate(p,this.provider);g=v.content??null,u=v.usage,m=v}let y={output:g||"",steps:this.extractSteps(m),metadata:u?{usage:u}:void 0};return await this.onComplete(y),s&&await s(!1),this.emit("agent:complete",y),y}catch(l){throw s&&s(!0).catch(d=>{console.error(`[${this.name??"agent"}][AgentMind] Draft buffer flush on error failed:`,d)}),await this.onError(l),this.emit("agent:error",l),l}}getAgentAliases(){let e=[];for(let t of this.channels){let n=t.botUserId;n&&e.push(n)}return e}async sendTo(e,t){if(!this._registry)throw new Error("Agent not registered - _registry not set");await this._registry.sendTo(e,{output:t})}async ask(e,t){if(!this._registry)throw new R("Agent not registered - cannot use ask()");let n=this._ctx()?.conversationId??this._conversationId,r=this._ctx()?.isTriggerChannel??this._isTriggerChannel,s=this._ctx()?.triggeringChannel??this._triggeringChannel;if(!n)throw new R("No conversationId available - ask() requires a conversation channel");if(r)throw new R("this.ask() called from a trigger channel (ScheduledChannel). Trigger channels have no human recipient \u2014 use a conversation channel (Slack, Telegram, Webhook) instead.");if(!s||s.trim()==="")throw new R("Cannot use ask() - no triggering channel available. The channel must have a name registered with AgentRegistry.");let i=this._registry.addPendingAsk({conversationId:n,agentName:this.name,question:e,context:t?.context??{},maxRetries:t?.maxRetries??2,expiresAt:t?.expiresIn?new Date(Date.now()+t.expiresIn):void 0,channelName:s});return await this.sendTo(s,e),{output:e,metadata:{waitingForHuman:!0,askId:i.id}}}getPendingAsk(e){if(!this._registry)return null;let t=e??this._ctx()?.conversationId??this._conversationId;return t?this._registry.getPendingAsk(t)??null:null}async resolvePendingAsk(e,t){if(!this._registry)throw new R("Agent not registered - cannot resolve ask");await this._registry.resolvePendingAsk(e,t)}async evaluateAnswer(e,t,n){if(n?.simpleValidation)return n.simpleValidation(t);let r=this._ctx()?.conversationId??this._conversationId;return(await this.run(`Evaluate if this answer sufficiently addresses the question.
 
 Question: "${e}"
 Answer: "${t}"

package/dist/index.d.cts

@@ -1,16 +1,16 @@
-import { B as BaseAgentOptions, A as AgentInput, a as AgentResult, d as IAgentRegistry, f as AgentOutput, g as AgentInstance, C as ChannelInterface, P as PendingAsk } from './types-C3EZvpe0.cjs';
-export { b as AgentDelegationConfig, e as AgentRunOptions, c as AgentSpawnConfig, h as AgentSpawnTemplate, I as Interceptor, i as InterceptorChainConfig, j as InterceptorContext, k as InterceptorResult, N as NextFunction, S as SKIP_SENTINEL, W as WorkflowStep, l as isSkipSentinel, s as skip } from './types-C3EZvpe0.cjs';
-import { B as BaseAgent, A as AgentMindConfig } from './base-agent-DVwGO20L.cjs';
-export { a as AgentEvents, C as ConfidenceLevel, G as GoalPriority, b as GoalStatus, M as MindBelief, c as MindEntry, d as MindEntryType, e as MindGoal, f as MindRecallResult, g as MindReflection, h as MindTtlDefaults } from './base-agent-DVwGO20L.cjs';
+import { B as BaseAgentOptions, A as AgentInput, a as AgentResult, d as IAgentRegistry, f as AgentOutput, g as AgentInstance, C as ChannelInterface, P as PendingAsk } from './types-CJinv165.cjs';
+export { b as AgentDelegationConfig, e as AgentRunOptions, c as AgentSpawnConfig, h as AgentSpawnTemplate, I as Interceptor, i as InterceptorChainConfig, j as InterceptorContext, k as InterceptorResult, N as NextFunction, S as SKIP_SENTINEL, W as WorkflowStep, l as isSkipSentinel, s as skip } from './types-CJinv165.cjs';
+import { B as BaseAgent, A as AgentMindConfig } from './base-agent-iaQiO7jW.cjs';
+export { a as AgentEvents, C as ConfidenceLevel, G as GoalPriority, b as GoalStatus, M as MindBelief, c as MindEntry, d as MindEntryType, e as MindGoal, f as MindRecallResult, g as MindReflection, h as MindTtlDefaults } from './base-agent-iaQiO7jW.cjs';
 import { ModeConfig, ConversationStore, AssemblerOptions, AssembledPrompt, RequestToolDefinition, ToolProject } from 'toolpack-sdk';
 export { AssembledPrompt, AssemblerOptions, ConversationScope, ConversationStore, GetOptions, InMemoryConversationStore, InMemoryConversationStoreConfig, Participant, PromptMessage, ConversationSearchOptions as SearchOptions, StoredMessage } from 'toolpack-sdk';
-import { S as SchedulerStore } from './index-BWrYFJtb.cjs';
-export { B as BaseChannel, C as CreateJobOptions, a as CreateJobResult, D as DiscordChannel, b as DiscordChannelConfig, E as EmailChannel, c as EmailChannelConfig, J as JobStatus, M as McpChannel, d as McpChannelConfig, e as SMSChannel, f as SMSChannelConfig, g as ScheduledChannel, h as ScheduledChannelConfig, i as ScheduledJob, j as SlackChannel, k as SlackChannelConfig, T as TelegramChannel, l as TelegramChannelConfig, W as WebhookChannel, m as WebhookChannelConfig } from './index-BWrYFJtb.cjs';
-export { I as IntentClassification, a as IntentClassifierAgent, b as IntentClassifierInput } from './intent-classifier-agent-DVCbBtdY.cjs';
+import { S as SchedulerStore } from './index-a2wZU6Eu.cjs';
+export { B as BaseChannel, C as CreateJobOptions, a as CreateJobResult, D as DiscordChannel, b as DiscordChannelConfig, E as EmailChannel, c as EmailChannelConfig, J as JobStatus, M as McpChannel, d as McpChannelConfig, e as SMSChannel, f as SMSChannelConfig, g as ScheduledChannel, h as ScheduledChannelConfig, i as ScheduledJob, j as SlackChannel, k as SlackChannelConfig, T as TelegramChannel, l as TelegramChannelConfig, W as WebhookChannel, m as WebhookChannelConfig } from './index-a2wZU6Eu.cjs';
+export { I as IntentClassification, a as IntentClassifierAgent, b as IntentClassifierInput } from './intent-classifier-agent-CEmRGpUr.cjs';
 import { SummarizerAgent } from './capabilities/index.cjs';
 export { HistoryTurn, SummarizerInput, SummarizerOutput } from './capabilities/index.cjs';
 export { AddressCheckConfig, AddressCheckResult, CaptureHistoryConfig, ComposedChain, DepthExceededError, DepthGuardConfig, EventDedupConfig, IntentClassifierInterceptorConfig, InvocationDepthExceededError, NoiseFilterConfig, OTelSpan, OTelSpanOptions, OTelSpanStatus, OTelSpanStatusCode, OTelTracer, OTelTracerConfig, OTelTracerProvider, ParticipantResolverConfig, RateLimitConfig, SelfFilterConfig, TracerConfig, composeChain, createAddressCheckInterceptor, createCaptureInterceptor, createDepthGuardInterceptor, createEventDedupInterceptor, createIntentClassifierInterceptor, createNoiseFilterInterceptor, createOTelTracerInterceptor, createParticipantResolverInterceptor, createRateLimitInterceptor, createSelfFilterInterceptor, createTracerInterceptor, executeChain } from './interceptors/index.cjs';
-export { C as ContainsScorer, a as CustomScorer, E as EvalCase, b as EvalCaseResult, c as EvalDataset, d as EvalImprovement, e as EvalRegression, f as EvalReport, g as EvalRun, h as EvalRunner, i as EvalRunnerOptions, j as EvalScoredResult, k as EvalScoredRun, l as EvalScorer, m as EvalVerdict, n as ExactMatchScorer, L as LLMJudgeScorer, o as LLMJudgeScorerOptions, p as compareEvalRuns, q as formatEvalReport } from './eval-report-DH2tt6Ad.cjs';
+export { C as ContainsScorer, a as CustomScorer, E as EvalCase, b as EvalCaseResult, c as EvalDataset, d as EvalImprovement, e as EvalRegression, f as EvalReport, g as EvalRun, h as EvalRunner, i as EvalRunnerOptions, j as EvalScoredResult, k as EvalScoredRun, l as EvalScorer, m as EvalVerdict, n as ExactMatchScorer, L as LLMJudgeScorer, o as LLMJudgeScorerOptions, p as compareEvalRuns, q as formatEvalReport } from './eval-report-DUlkrBuJ.cjs';
 import 'events';
 import '@toolpack-sdk/knowledge';
 

package/dist/index.d.ts

@@ -1,16 +1,16 @@
-import { B as BaseAgentOptions, A as AgentInput, a as AgentResult, d as IAgentRegistry, f as AgentOutput, g as AgentInstance, C as ChannelInterface, P as PendingAsk } from './types-C3EZvpe0.js';
-export { b as AgentDelegationConfig, e as AgentRunOptions, c as AgentSpawnConfig, h as AgentSpawnTemplate, I as Interceptor, i as InterceptorChainConfig, j as InterceptorContext, k as InterceptorResult, N as NextFunction, S as SKIP_SENTINEL, W as WorkflowStep, l as isSkipSentinel, s as skip } from './types-C3EZvpe0.js';
-import { B as BaseAgent, A as AgentMindConfig } from './base-agent-BMZWBdkt.js';
-export { a as AgentEvents, C as ConfidenceLevel, G as GoalPriority, b as GoalStatus, M as MindBelief, c as MindEntry, d as MindEntryType, e as MindGoal, f as MindRecallResult, g as MindReflection, h as MindTtlDefaults } from './base-agent-BMZWBdkt.js';
+import { B as BaseAgentOptions, A as AgentInput, a as AgentResult, d as IAgentRegistry, f as AgentOutput, g as AgentInstance, C as ChannelInterface, P as PendingAsk } from './types-CJinv165.js';
+export { b as AgentDelegationConfig, e as AgentRunOptions, c as AgentSpawnConfig, h as AgentSpawnTemplate, I as Interceptor, i as InterceptorChainConfig, j as InterceptorContext, k as InterceptorResult, N as NextFunction, S as SKIP_SENTINEL, W as WorkflowStep, l as isSkipSentinel, s as skip } from './types-CJinv165.js';
+import { B as BaseAgent, A as AgentMindConfig } from './base-agent-CJE2QCjY.js';
+export { a as AgentEvents, C as ConfidenceLevel, G as GoalPriority, b as GoalStatus, M as MindBelief, c as MindEntry, d as MindEntryType, e as MindGoal, f as MindRecallResult, g as MindReflection, h as MindTtlDefaults } from './base-agent-CJE2QCjY.js';
 import { ModeConfig, ConversationStore, AssemblerOptions, AssembledPrompt, RequestToolDefinition, ToolProject } from 'toolpack-sdk';
 export { AssembledPrompt, AssemblerOptions, ConversationScope, ConversationStore, GetOptions, InMemoryConversationStore, InMemoryConversationStoreConfig, Participant, PromptMessage, ConversationSearchOptions as SearchOptions, StoredMessage } from 'toolpack-sdk';
-import { S as SchedulerStore } from './index-BU2BchV0.js';
-export { B as BaseChannel, C as CreateJobOptions, a as CreateJobResult, D as DiscordChannel, b as DiscordChannelConfig, E as EmailChannel, c as EmailChannelConfig, J as JobStatus, M as McpChannel, d as McpChannelConfig, e as SMSChannel, f as SMSChannelConfig, g as ScheduledChannel, h as ScheduledChannelConfig, i as ScheduledJob, j as SlackChannel, k as SlackChannelConfig, T as TelegramChannel, l as TelegramChannelConfig, W as WebhookChannel, m as WebhookChannelConfig } from './index-BU2BchV0.js';
-export { I as IntentClassification, a as IntentClassifierAgent, b as IntentClassifierInput } from './intent-classifier-agent-BnpchAoZ.js';
+import { S as SchedulerStore } from './index-DQuf4mxT.js';
+export { B as BaseChannel, C as CreateJobOptions, a as CreateJobResult, D as DiscordChannel, b as DiscordChannelConfig, E as EmailChannel, c as EmailChannelConfig, J as JobStatus, M as McpChannel, d as McpChannelConfig, e as SMSChannel, f as SMSChannelConfig, g as ScheduledChannel, h as ScheduledChannelConfig, i as ScheduledJob, j as SlackChannel, k as SlackChannelConfig, T as TelegramChannel, l as TelegramChannelConfig, W as WebhookChannel, m as WebhookChannelConfig } from './index-DQuf4mxT.js';
+export { I as IntentClassification, a as IntentClassifierAgent, b as IntentClassifierInput } from './intent-classifier-agent-QuB4WIWf.js';
 import { SummarizerAgent } from './capabilities/index.js';
 export { HistoryTurn, SummarizerInput, SummarizerOutput } from './capabilities/index.js';
 export { AddressCheckConfig, AddressCheckResult, CaptureHistoryConfig, ComposedChain, DepthExceededError, DepthGuardConfig, EventDedupConfig, IntentClassifierInterceptorConfig, InvocationDepthExceededError, NoiseFilterConfig, OTelSpan, OTelSpanOptions, OTelSpanStatus, OTelSpanStatusCode, OTelTracer, OTelTracerConfig, OTelTracerProvider, ParticipantResolverConfig, RateLimitConfig, SelfFilterConfig, TracerConfig, composeChain, createAddressCheckInterceptor, createCaptureInterceptor, createDepthGuardInterceptor, createEventDedupInterceptor, createIntentClassifierInterceptor, createNoiseFilterInterceptor, createOTelTracerInterceptor, createParticipantResolverInterceptor, createRateLimitInterceptor, createSelfFilterInterceptor, createTracerInterceptor, executeChain } from './interceptors/index.js';
-export { C as ContainsScorer, a as CustomScorer, E as EvalCase, b as EvalCaseResult, c as EvalDataset, d as EvalImprovement, e as EvalRegression, f as EvalReport, g as EvalRun, h as EvalRunner, i as EvalRunnerOptions, j as EvalScoredResult, k as EvalScoredRun, l as EvalScorer, m as EvalVerdict, n as ExactMatchScorer, L as LLMJudgeScorer, o as LLMJudgeScorerOptions, p as compareEvalRuns, q as formatEvalReport } from './eval-report-BJEzzuSk.js';
+export { C as ContainsScorer, a as CustomScorer, E as EvalCase, b as EvalCaseResult, c as EvalDataset, d as EvalImprovement, e as EvalRegression, f as EvalReport, g as EvalRun, h as EvalRunner, i as EvalRunnerOptions, j as EvalScoredResult, k as EvalScoredRun, l as EvalScorer, m as EvalVerdict, n as ExactMatchScorer, L as LLMJudgeScorer, o as LLMJudgeScorerOptions, p as compareEvalRuns, q as formatEvalReport } from './eval-report-0O9AlW7u.js';
 import 'events';
 import '@toolpack-sdk/knowledge';
 

package/dist/index.js

@@ -3,10 +3,10 @@ var Ft=Object.defineProperty;var O=(o,e)=>()=>(o&&(e=o(o=0)),e);var At=(o,e)=>{f
 `);this.delegation.mode==="forget"?d.push({name:"delegate_and_forget",displayName:"Delegate and Forget",description:`Hand off the current task to a peer agent. The agent will handle its own delivery (e.g. posting to Slack or GitHub) \u2014 you do not need to relay its response. Call this ONCE, then output an empty string.
 
 Available agents:
-${T}`,category:"agent",parameters:{type:"object",properties:{agent:{type:"string",enum:I,description:"Name of the agent to delegate to."},message:{type:"string",description:"The task or message to pass to the agent."}},required:["agent","message"]},execute:async C=>{let M=String(C.agent),R=String(C.message??"");return this._registry.invoke(M,{message:R,conversationId:r,context:{delegatedBy:this.name}}).catch(_=>{console.error(`[${this.name}] delegate_and_forget to ${M} failed:`,_)}),{status:"delegated",agent:M}}}):d.push({name:"delegate_to_agent",displayName:"Delegate to Agent",description:`Hand off the current task to a peer agent and return its result. Use when the task falls outside your own specialisation.
+${T}`,category:"agent",parameters:{type:"object",properties:{agent:{type:"string",enum:I,description:"Name of the agent to delegate to."},message:{type:"string",description:"The task or message to pass to the agent."}},required:["agent","message"]},execute:async C=>{let M=String(C.agent),R=String(C.message??"");return this._registry.invoke(M,{message:R,conversationId:r,context:{delegatedBy:this.name},signal:t?.signal}).catch(_=>{console.error(`[${this.name}] delegate_and_forget to ${M} failed:`,_)}),{status:"delegated",agent:M}}}):d.push({name:"delegate_to_agent",displayName:"Delegate to Agent",description:`Hand off the current task to a peer agent and return its result. Use when the task falls outside your own specialisation.
 
 Available agents:
-${T}`,category:"agent",parameters:{type:"object",properties:{agent:{type:"string",enum:I,description:"Name of the agent to delegate to."},message:{type:"string",description:"The task or message to pass to the agent."}},required:["agent","message"]},execute:async C=>{let M=String(C.agent),R=String(C.message??""),_=await this._registry.invoke(M,{message:R,conversationId:r,context:{delegatedBy:this.name}});return{..._,output:`[Response from ${M} \u2014 task complete]
+${T}`,category:"agent",parameters:{type:"object",properties:{agent:{type:"string",enum:I,description:"Name of the agent to delegate to."},message:{type:"string",description:"The task or message to pass to the agent."}},required:["agent","message"]},execute:async C=>{let M=String(C.agent),R=String(C.message??""),_=await this._registry.invoke(M,{message:R,conversationId:r,context:{delegatedBy:this.name},signal:t?.signal});return{..._,output:`[Response from ${M} \u2014 task complete]
 
 ${_.output}`}}})}}if(this.spawn?.enabled&&this.spawn.templates.length>0){let w=n?.spawnDepth??0,b=this.spawn,I=b.maxDepth??3;if(w<I){let T=b.templates,C=T.some(k=>k.name==="self"),M=T.some(k=>k.allowPromptAddition),R=T.filter(k=>k.name!=="self").map(k=>`- ${k.name}: ${k.description}`).join(`
 `),_=C?`Use template name "self" to spawn a replica of the current agent.
@@ -26,7 +26,7 @@ ${R}
 
 ${String($.systemPromptAddition)}`:"",Z,z,W,j;if(U==="self"){let ee=typeof this.mode=="string"?{...fe,name:this.mode}:this.mode,wt=E.systemPrompt(G);Z={...ee,name:`${ee.name}-replica-${Date.now()}`,systemPrompt:(ee.systemPrompt??"")+(wt?`
 
-${wt}`:"")+Q},z=`${this.name}-replica`,W=this.description,j=this.model}else Z={...fe,name:`ephemeral-${E.name}-${Date.now()}`,systemPrompt:E.systemPrompt(G)+Q},z=E.name,W=E.description,j=E.model;let H=new F(z,W,Z,{toolpack:this.toolpack});j&&(H.model=j),H.spawn={...b};let vt=await H.invokeAgent({message:G,conversationId:`spawn-${Date.now()}`,context:{spawnedBy:this.name,spawnDepth:w+1}});return{output:vt.output,spawnedTemplate:U,depth:w+1,metadata:vt.metadata}}))}}})}}let p={messages:l,model:this.model||"",requestTools:d.length>0?d:void 0,maxToolRounds:t?.maxToolRounds,mode:this.mode},g=null,u,m;if(typeof this.mode!="string"&&this.mode?.streaming){let w="";for await(let b of this.toolpack.stream(p,this.provider))w+=b.delta||"",b.usage&&(u=b.usage);g=w||null,m={content:g,usage:u}}else{let w=await this.toolpack.generate(p,this.provider);g=w.content??null,u=w.usage,m=w}let v={output:g||"",steps:this.extractSteps(m),metadata:u?{usage:u}:void 0};return await this.onComplete(v),s&&await s(!1),this.emit("agent:complete",v),v}catch(l){throw s&&s(!0).catch(d=>{console.error(`[${this.name??"agent"}][AgentMind] Draft buffer flush on error failed:`,d)}),await this.onError(l),this.emit("agent:error",l),l}}getAgentAliases(){let e=[];for(let t of this.channels){let n=t.botUserId;n&&e.push(n)}return e}async sendTo(e,t){if(!this._registry)throw new Error("Agent not registered - _registry not set");await this._registry.sendTo(e,{output:t})}async ask(e,t){if(!this._registry)throw new x("Agent not registered - cannot use ask()");let n=this._ctx()?.conversationId??this._conversationId,r=this._ctx()?.isTriggerChannel??this._isTriggerChannel,s=this._ctx()?.triggeringChannel??this._triggeringChannel;if(!n)throw new x("No conversationId available - ask() requires a conversation channel");if(r)throw new x("this.ask() called from a trigger channel (ScheduledChannel). Trigger channels have no human recipient \u2014 use a conversation channel (Slack, Telegram, Webhook) instead.");if(!s||s.trim()==="")throw new x("Cannot use ask() - no triggering channel available. The channel must have a name registered with AgentRegistry.");let i=this._registry.addPendingAsk({conversationId:n,agentName:this.name,question:e,context:t?.context??{},maxRetries:t?.maxRetries??2,expiresAt:t?.expiresIn?new Date(Date.now()+t.expiresIn):void 0,channelName:s});return await this.sendTo(s,e),{output:e,metadata:{waitingForHuman:!0,askId:i.id}}}getPendingAsk(e){if(!this._registry)return null;let t=e??this._ctx()?.conversationId??this._conversationId;return t?this._registry.getPendingAsk(t)??null:null}async resolvePendingAsk(e,t){if(!this._registry)throw new x("Agent not registered - cannot resolve ask");await this._registry.resolvePendingAsk(e,t)}async evaluateAnswer(e,t,n){if(n?.simpleValidation)return n.simpleValidation(t);let r=this._ctx()?.conversationId??this._conversationId;return(await this.run(`Evaluate if this answer sufficiently addresses the question.
+${wt}`:"")+Q},z=`${this.name}-replica`,W=this.description,j=this.model}else Z={...fe,name:`ephemeral-${E.name}-${Date.now()}`,systemPrompt:E.systemPrompt(G)+Q},z=E.name,W=E.description,j=E.model;let H=new F(z,W,Z,{toolpack:this.toolpack});j&&(H.model=j),H.spawn={...b};let vt=await H.invokeAgent({message:G,conversationId:`spawn-${Date.now()}`,context:{spawnedBy:this.name,spawnDepth:w+1}});return{output:vt.output,spawnedTemplate:U,depth:w+1,metadata:vt.metadata}}))}}})}}let p={messages:l,model:this.model||"",requestTools:d.length>0?d:void 0,maxToolRounds:t?.maxToolRounds,mode:this.mode,signal:t?.signal},g=null,u,m;if(typeof this.mode!="string"&&this.mode?.streaming){let w="";for await(let b of this.toolpack.stream(p,this.provider))w+=b.delta||"",b.usage&&(u=b.usage);g=w||null,m={content:g,usage:u}}else{let w=await this.toolpack.generate(p,this.provider);g=w.content??null,u=w.usage,m=w}let v={output:g||"",steps:this.extractSteps(m),metadata:u?{usage:u}:void 0};return await this.onComplete(v),s&&await s(!1),this.emit("agent:complete",v),v}catch(l){throw s&&s(!0).catch(d=>{console.error(`[${this.name??"agent"}][AgentMind] Draft buffer flush on error failed:`,d)}),await this.onError(l),this.emit("agent:error",l),l}}getAgentAliases(){let e=[];for(let t of this.channels){let n=t.botUserId;n&&e.push(n)}return e}async sendTo(e,t){if(!this._registry)throw new Error("Agent not registered - _registry not set");await this._registry.sendTo(e,{output:t})}async ask(e,t){if(!this._registry)throw new x("Agent not registered - cannot use ask()");let n=this._ctx()?.conversationId??this._conversationId,r=this._ctx()?.isTriggerChannel??this._isTriggerChannel,s=this._ctx()?.triggeringChannel??this._triggeringChannel;if(!n)throw new x("No conversationId available - ask() requires a conversation channel");if(r)throw new x("this.ask() called from a trigger channel (ScheduledChannel). Trigger channels have no human recipient \u2014 use a conversation channel (Slack, Telegram, Webhook) instead.");if(!s||s.trim()==="")throw new x("Cannot use ask() - no triggering channel available. The channel must have a name registered with AgentRegistry.");let i=this._registry.addPendingAsk({conversationId:n,agentName:this.name,question:e,context:t?.context??{},maxRetries:t?.maxRetries??2,expiresAt:t?.expiresIn?new Date(Date.now()+t.expiresIn):void 0,channelName:s});return await this.sendTo(s,e),{output:e,metadata:{waitingForHuman:!0,askId:i.id}}}getPendingAsk(e){if(!this._registry)return null;let t=e??this._ctx()?.conversationId??this._conversationId;return t?this._registry.getPendingAsk(t)??null:null}async resolvePendingAsk(e,t){if(!this._registry)throw new x("Agent not registered - cannot resolve ask");await this._registry.resolvePendingAsk(e,t)}async evaluateAnswer(e,t,n){if(n?.simpleValidation)return n.simpleValidation(t);let r=this._ctx()?.conversationId??this._conversationId;return(await this.run(`Evaluate if this answer sufficiently addresses the question.
 
 Question: "${e}"
 Answer: "${t}"

package/dist/{intent-classifier-agent-DVCbBtdY.d.cts → intent-classifier-agent-CEmRGpUr.d.cts}

@@ -1,5 +1,5 @@
-import { B as BaseAgentOptions, A as AgentInput, a as AgentResult } from './types-C3EZvpe0.cjs';
-import { B as BaseAgent } from './base-agent-DVwGO20L.cjs';
+import { B as BaseAgentOptions, A as AgentInput, a as AgentResult } from './types-CJinv165.cjs';
+import { B as BaseAgent } from './base-agent-iaQiO7jW.cjs';
 import { ModeConfig } from 'toolpack-sdk';
 
 /**

package/dist/{intent-classifier-agent-BnpchAoZ.d.ts → intent-classifier-agent-QuB4WIWf.d.ts}

@@ -1,5 +1,5 @@
-import { B as BaseAgentOptions, A as AgentInput, a as AgentResult } from './types-C3EZvpe0.js';
-import { B as BaseAgent } from './base-agent-BMZWBdkt.js';
+import { B as BaseAgentOptions, A as AgentInput, a as AgentResult } from './types-CJinv165.js';
+import { B as BaseAgent } from './base-agent-CJE2QCjY.js';
 import { ModeConfig } from 'toolpack-sdk';
 
 /**

package/dist/interceptors/index.d.cts

@@ -1,9 +1,9 @@
-import { A as AgentInput, k as InterceptorResult, I as Interceptor, g as AgentInstance, C as ChannelInterface, d as IAgentRegistry, i as InterceptorChainConfig, a as AgentResult } from '../types-C3EZvpe0.cjs';
-export { j as InterceptorContext, N as NextFunction, S as SKIP_SENTINEL, l as isSkipSentinel, s as skip } from '../types-C3EZvpe0.cjs';
+import { A as AgentInput, k as InterceptorResult, I as Interceptor, g as AgentInstance, C as ChannelInterface, d as IAgentRegistry, i as InterceptorChainConfig, a as AgentResult } from '../types-CJinv165.cjs';
+export { j as InterceptorContext, N as NextFunction, S as SKIP_SENTINEL, l as isSkipSentinel, s as skip } from '../types-CJinv165.cjs';
 import { Participant, ConversationStore, ConversationScope, StoredMessage } from 'toolpack-sdk';
-import { I as IntentClassification } from '../intent-classifier-agent-DVCbBtdY.cjs';
+import { I as IntentClassification } from '../intent-classifier-agent-CEmRGpUr.cjs';
 import 'events';
-import '../base-agent-DVwGO20L.cjs';
+import '../base-agent-iaQiO7jW.cjs';
 import '@toolpack-sdk/knowledge';
 
 /**

package/dist/interceptors/index.d.ts

@@ -1,9 +1,9 @@
-import { A as AgentInput, k as InterceptorResult, I as Interceptor, g as AgentInstance, C as ChannelInterface, d as IAgentRegistry, i as InterceptorChainConfig, a as AgentResult } from '../types-C3EZvpe0.js';
-export { j as InterceptorContext, N as NextFunction, S as SKIP_SENTINEL, l as isSkipSentinel, s as skip } from '../types-C3EZvpe0.js';
+import { A as AgentInput, k as InterceptorResult, I as Interceptor, g as AgentInstance, C as ChannelInterface, d as IAgentRegistry, i as InterceptorChainConfig, a as AgentResult } from '../types-CJinv165.js';
+export { j as InterceptorContext, N as NextFunction, S as SKIP_SENTINEL, l as isSkipSentinel, s as skip } from '../types-CJinv165.js';
 import { Participant, ConversationStore, ConversationScope, StoredMessage } from 'toolpack-sdk';
-import { I as IntentClassification } from '../intent-classifier-agent-BnpchAoZ.js';
+import { I as IntentClassification } from '../intent-classifier-agent-QuB4WIWf.js';
 import 'events';
-import '../base-agent-BMZWBdkt.js';
+import '../base-agent-CJE2QCjY.js';
 import '@toolpack-sdk/knowledge';
 
 /**

package/dist/testing/index.d.cts

@@ -1,8 +1,8 @@
-import { C as ChannelInterface, f as AgentOutput, A as AgentInput, B as BaseAgentOptions } from '../types-C3EZvpe0.cjs';
+import { C as ChannelInterface, f as AgentOutput, A as AgentInput, B as BaseAgentOptions } from '../types-CJinv165.cjs';
 import { Chunk, QueryOptions, QueryResult, Knowledge } from '@toolpack-sdk/knowledge';
 import { Toolpack } from 'toolpack-sdk';
-import { B as BaseAgent } from '../base-agent-DVwGO20L.cjs';
-export { C as ContainsScorer, a as CustomScorer, E as EvalCase, b as EvalCaseResult, c as EvalDataset, d as EvalImprovement, e as EvalRegression, f as EvalReport, g as EvalRun, h as EvalRunner, i as EvalRunnerOptions, j as EvalScoredResult, k as EvalScoredRun, l as EvalScorer, m as EvalVerdict, n as ExactMatchScorer, L as LLMJudgeScorer, o as LLMJudgeScorerOptions, p as compareEvalRuns, q as formatEvalReport } from '../eval-report-DH2tt6Ad.cjs';
+import { B as BaseAgent } from '../base-agent-iaQiO7jW.cjs';
+export { C as ContainsScorer, a as CustomScorer, E as EvalCase, b as EvalCaseResult, c as EvalDataset, d as EvalImprovement, e as EvalRegression, f as EvalReport, g as EvalRun, h as EvalRunner, i as EvalRunnerOptions, j as EvalScoredResult, k as EvalScoredRun, l as EvalScorer, m as EvalVerdict, n as ExactMatchScorer, L as LLMJudgeScorer, o as LLMJudgeScorerOptions, p as compareEvalRuns, q as formatEvalReport } from '../eval-report-DUlkrBuJ.cjs';
 import 'events';
 
 /**

package/dist/testing/index.d.ts

@@ -1,8 +1,8 @@
-import { C as ChannelInterface, f as AgentOutput, A as AgentInput, B as BaseAgentOptions } from '../types-C3EZvpe0.js';
+import { C as ChannelInterface, f as AgentOutput, A as AgentInput, B as BaseAgentOptions } from '../types-CJinv165.js';
 import { Chunk, QueryOptions, QueryResult, Knowledge } from '@toolpack-sdk/knowledge';
 import { Toolpack } from 'toolpack-sdk';
-import { B as BaseAgent } from '../base-agent-BMZWBdkt.js';
-export { C as ContainsScorer, a as CustomScorer, E as EvalCase, b as EvalCaseResult, c as EvalDataset, d as EvalImprovement, e as EvalRegression, f as EvalReport, g as EvalRun, h as EvalRunner, i as EvalRunnerOptions, j as EvalScoredResult, k as EvalScoredRun, l as EvalScorer, m as EvalVerdict, n as ExactMatchScorer, L as LLMJudgeScorer, o as LLMJudgeScorerOptions, p as compareEvalRuns, q as formatEvalReport } from '../eval-report-BJEzzuSk.js';
+import { B as BaseAgent } from '../base-agent-CJE2QCjY.js';
+export { C as ContainsScorer, a as CustomScorer, E as EvalCase, b as EvalCaseResult, c as EvalDataset, d as EvalImprovement, e as EvalRegression, f as EvalReport, g as EvalRun, h as EvalRunner, i as EvalRunnerOptions, j as EvalScoredResult, k as EvalScoredRun, l as EvalScorer, m as EvalVerdict, n as ExactMatchScorer, L as LLMJudgeScorer, o as LLMJudgeScorerOptions, p as compareEvalRuns, q as formatEvalReport } from '../eval-report-0O9AlW7u.js';
 import 'events';
 
 /**

package/dist/{types-C3EZvpe0.d.cts → types-CJinv165.d.cts}

@@ -218,6 +218,8 @@ interface AgentInput<TIntent extends string = string> {
      * Interceptors such as `participant-resolver` read and/or enrich this.
      */
     participant?: Participant;
+    /** Optional abort signal — when aborted, the running LLM stream stops at the next round boundary. */
+    signal?: AbortSignal;
 }
 /**
  * Represents a step in a workflow execution.
@@ -270,6 +272,8 @@ interface AgentRunOptions {
      * per invocation (e.g. single-shot routers using delegate_to_agent).
      */
     maxToolRounds?: number;
+    /** Optional abort signal — propagated to the underlying AIClient stream/generate call. */
+    signal?: AbortSignal;
 }
 /**
  * Agent instance interface - shape of a BaseAgent instance.

package/dist/{types-C3EZvpe0.d.ts → types-CJinv165.d.ts}

@@ -218,6 +218,8 @@ interface AgentInput<TIntent extends string = string> {
      * Interceptors such as `participant-resolver` read and/or enrich this.
      */
     participant?: Participant;
+    /** Optional abort signal — when aborted, the running LLM stream stops at the next round boundary. */
+    signal?: AbortSignal;
 }
 /**
  * Represents a step in a workflow execution.
@@ -270,6 +272,8 @@ interface AgentRunOptions {
      * per invocation (e.g. single-shot routers using delegate_to_agent).
      */
     maxToolRounds?: number;
+    /** Optional abort signal — propagated to the underlying AIClient stream/generate call. */
+    signal?: AbortSignal;
 }
 /**
  * Agent instance interface - shape of a BaseAgent instance.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toolpack-sdk/agents",
-  "version": "2.7.0",
+  "version": "3.1.0",
   "description": "Production AI agents for Toolpack SDK — 8 channel integrations (Slack, Discord, Telegram, SMS, Email, Webhook, Scheduled, MCP), AgentMind persistent cognitive layer (goals, beliefs, reflections), interceptors, evals, and multi-agent coordination",
   "engines": {
     "node": ">=20"
@@ -89,11 +89,11 @@
   },
   "peerDependencies": {
     "@opentelemetry/api": "^1.x",
-    "@toolpack-sdk/knowledge": "^2.7.0",
+    "@toolpack-sdk/knowledge": "^3.1.0",
     "better-sqlite3": "^12.6.2",
     "discord.js": "^14.x",
     "nodemailer": "^6.x",
-    "toolpack-sdk": "^2.7.0",
+    "toolpack-sdk": "^3.1.0",
     "twilio": "^5.x"
   },
   "peerDependenciesMeta": {