@ariaflowagents/core 0.7.1 → 0.9.0

package/dist/agents/CompositeAgent.js

@@ -1,12 +1,22 @@
 import { Agent } from './Agent.js';
 export class CompositeAgent extends Agent {
+    compositeConfig;
     agents = new Map();
     entryAgentId;
-    maxHandoffs;
+    maxHandoffsLimit;
     constructor(config) {
-        super(config);
+        super({
+            id: config.id,
+            name: config.name,
+            description: config.description,
+            model: config.model,
+            prompt: config.prompt ?? '',
+            tools: config.tools,
+            canHandoffTo: config.canHandoffTo,
+        });
+        this.compositeConfig = config;
         this.entryAgentId = config.entryAgent;
-        this.maxHandoffs = config.maxHandoffs ?? 10;
+        this.maxHandoffsLimit = config.maxHandoffs ?? 10;
         for (const agent of config.agents) {
             this.agents.set(agent.id, agent);
         }
@@ -23,11 +33,11 @@ export class CompositeAgent extends Agent {
         }
         await super.cleanup(context);
     }
-    async *process(input, context) {
+    async *run(input, context) {
         let currentAgentId = context.session.activeAgentId || this.entryAgentId;
         let currentInput = input;
         let handoffCount = 0;
-        while (handoffCount < this.maxHandoffs) {
+        while (handoffCount < this.maxHandoffsLimit) {
             const agent = this.agents.get(currentAgentId);
             if (!agent) {
                 yield { type: 'error', error: `Agent "${currentAgentId}" not found in composite agent "${this.id}"` };
@@ -36,7 +46,7 @@ export class CompositeAgent extends Agent {
             let handoffTriggered = false;
             let nextAgentId;
             // Delegate processing to the sub-agent
-            for await (const part of agent.process(currentInput, context)) {
+            for await (const part of agent.run(currentInput, context)) {
                 yield part;
                 if (part.type === 'handoff') {
                     handoffTriggered = true;
@@ -44,7 +54,7 @@ export class CompositeAgent extends Agent {
                     handoffCount += 1;
                 }
                 if (part.type === 'turn-end' && part.metadata?.response) {
-                    // In a composite agent, we might want to collect all messages 
+                    // In a composite agent, we might want to collect all messages
                     // but for now we just yield it up so the orchestrator can persist.
                 }
             }
@@ -59,8 +69,8 @@ export class CompositeAgent extends Agent {
             context.session.activeAgentId = nextAgentId;
             currentInput = ''; // Clear input for the next agent in the sequence
         }
-        if (handoffCount >= this.maxHandoffs) {
-            yield { type: 'error', error: `Maximum internal handoffs (${this.maxHandoffs}) exceeded in composite agent "${this.id}"` };
+        if (handoffCount >= this.maxHandoffsLimit) {
+            yield { type: 'error', error: `Maximum internal handoffs (${this.maxHandoffsLimit}) exceeded in composite agent "${this.id}"` };
         }
     }
     getAgent(id) {

package/dist/agents/CompositeAgent.js.map

@@ -1 +1 @@
-{"version":3,"file":"CompositeAgent.js","sourceRoot":"","sources":["../../src/agents/CompositeAgent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"CompositeAgent.js","sourceRoot":"","sources":["../../src/agents/CompositeAgent.ts"],"names":[],"mappings":"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"}

package/dist/agents/FlowAgent.d.ts

@@ -1,9 +1,10 @@
 import { Agent } from './Agent.js';
 import type { AgentContext, AgentStreamPart, FlowAgentConfig } from '../types/index.js';
-export declare class FlowAgent extends Agent<FlowAgentConfig> {
+export declare class FlowAgent extends Agent {
+    private flowConfig;
     private flowManager?;
     constructor(config: FlowAgentConfig);
-    process(input: string, context: AgentContext): AsyncGenerator<AgentStreamPart>;
+    run(input: string, context: AgentContext): AsyncGenerator<AgentStreamPart>;
     get collectedData(): Record<string, unknown>;
     get currentNode(): string | undefined;
     transitionTo(node: string): Promise<void>;

package/dist/agents/FlowAgent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FlowAgent.d.ts","sourceRoot":"","sources":["../../src/agents/FlowAgent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAExF,qBAAa,SAAU,SAAQ,KAAK,CAAC,eAAe,CAAC;IACnD,OAAO,CAAC,WAAW,CAAC,CAAc;gBAEtB,MAAM,EAAE,eAAe;IAO5B,OAAO,CACZ,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,YAAY,GACpB,cAAc,CAAC,eAAe,CAAC;IAyBlC,IAAI,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE3C;IAED,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAEpC;IAEK,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAKhD"}
+{"version":3,"file":"FlowAgent.d.ts","sourceRoot":"","sources":["../../src/agents/FlowAgent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAExF,qBAAa,SAAU,SAAQ,KAAK;IAClC,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,WAAW,CAAC,CAAc;gBAEtB,MAAM,EAAE,eAAe;IAgB5B,GAAG,CACR,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,YAAY,GACpB,cAAc,CAAC,eAAe,CAAC;IAyBlC,IAAI,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE3C;IAED,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAEpC;IAEK,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAKhD"}

package/dist/agents/FlowAgent.js

@@ -1,20 +1,30 @@
 import { Agent } from './Agent.js';
 import { FlowManager } from '../flows/FlowManager.js';
 export class FlowAgent extends Agent {
+    flowConfig;
     flowManager;
     constructor(config) {
-        super(config);
+        super({
+            id: config.id,
+            name: config.name,
+            description: config.description,
+            model: config.model,
+            prompt: config.prompt ?? '',
+            tools: config.tools,
+            canHandoffTo: config.canHandoffTo,
+        });
+        this.flowConfig = config;
         if (!config.model) {
             throw new Error(`FlowAgent "${config.id}" requires a model`);
         }
     }
-    async *process(input, context) {
+    async *run(input, context) {
         if (!this.flowManager) {
             this.flowManager = new FlowManager({
-                flow: this.config.flow,
-                initialNode: this.config.initialNode,
-                model: this.config.model,
-                defaultRolePrompt: this.getSystemPromptString(),
+                flow: this.flowConfig.flow,
+                initialNode: this.flowConfig.initialNode,
+                model: this.flowConfig.model,
+                defaultRolePrompt: await this.resolveSystemPrompt(),
                 contextMessages: context.messages,
                 abortSignal: context.abortSignal,
             });

package/dist/agents/FlowAgent.js.map

@@ -1 +1 @@
-{"version":3,"file":"FlowAgent.js","sourceRoot":"","sources":["../../src/agents/FlowAgent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAGtD,MAAM,OAAO,SAAU,SAAQ,KAAsB;IAC3C,WAAW,CAAe;IAElC,YAAY,MAAuB;QACjC,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,cAAc,MAAM,CAAC,EAAE,oBAAoB,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAED,KAAK,CAAC,CAAC,OAAO,CACZ,KAAa,EACb,OAAqB;QAErB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,IAAI,CAAC,WAAW,GAAG,IAAI,WAAW,CAAC;gBACjC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;gBACtB,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW;gBACpC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAM;gBACzB,iBAAiB,EAAE,IAAI,CAAC,qBAAqB,EAAE;gBAC/C,eAAe,EAAE,OAAO,CAAC,QAAQ;gBACjC,WAAW,EAAE,OAAO,CAAC,WAAW;aACjC,CAAC,CAAC;YAEH,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,EAAE,CAAC;gBACvD,MAAM,IAAI,CAAC;YACb,CAAC;QACH,CAAC;QAED,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzD,MAAM,IAAI,CAAC;YAEX,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBAC7B,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;YAC/B,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,WAAW,EAAE,aAAa,IAAI,EAAE,CAAC;IAC/C,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,IAAY;QAC7B,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,MAAM,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"FlowAgent.js","sourceRoot":"","sources":["../../src/agents/FlowAgent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAGtD,MAAM,OAAO,SAAU,SAAQ,KAAK;IAC1B,UAAU,CAAkB;IAC5B,WAAW,CAAe;IAElC,YAAY,MAAuB;QACjC,KAAK,CAAC;YACJ,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,KAAK,EAAE,MAAM,CAAC,KAAM;YACpB,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;YAC3B,KAAK,EAAE,MAAM,CAAC,KAAY;YAC1B,YAAY,EAAE,MAAM,CAAC,YAAY;SAClC,CAAC,CAAC;QACH,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC;QACzB,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,cAAc,MAAM,CAAC,EAAE,oBAAoB,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAED,KAAK,CAAC,CAAC,GAAG,CACR,KAAa,EACb,OAAqB;QAErB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,IAAI,CAAC,WAAW,GAAG,IAAI,WAAW,CAAC;gBACjC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI;gBAC1B,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,WAAW;gBACxC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,KAAM;gBAC7B,iBAAiB,EAAE,MAAM,IAAI,CAAC,mBAAmB,EAAE;gBACnD,eAAe,EAAE,OAAO,CAAC,QAAQ;gBACjC,WAAW,EAAE,OAAO,CAAC,WAAW;aACjC,CAAC,CAAC;YAEH,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,EAAE,CAAC;gBACvD,MAAM,IAAI,CAAC;YACb,CAAC;QACH,CAAC;QAED,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzD,MAAM,IAAI,CAAC;YAEX,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBAC7B,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;YAC/B,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,WAAW,EAAE,aAAa,IAAI,EAAE,CAAC;IAC/C,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,IAAY;QAC7B,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,MAAM,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;CACF"}

package/dist/agents/TriageAgent.d.ts

@@ -1,11 +1,17 @@
 import { Agent } from './Agent.js';
 import type { AgentContext, AgentStreamPart, TriageAgentConfig } from '../types/index.js';
-export declare class TriageAgent extends Agent<TriageAgentConfig> {
+export declare class TriageAgent extends Agent {
+    private triageConfig;
     private routes;
     private defaultAgent?;
     constructor(config: TriageAgentConfig);
-    process(_input: string, context: AgentContext): AsyncGenerator<AgentStreamPart>;
+    run(_input: string, context: AgentContext): AsyncGenerator<AgentStreamPart>;
     private buildRoutingPrompt;
+    /**
+     * Builds the system prompt with working memory appended.
+     * Mirrors the old BaseAgent.buildSystemPrompt() behavior.
+     */
+    private buildSystemPromptWithMemory;
     private createHandoffTool;
 }
 //# sourceMappingURL=TriageAgent.d.ts.map

package/dist/agents/TriageAgent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TriageAgent.d.ts","sourceRoot":"","sources":["../../src/agents/TriageAgent.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,KAAK,EAAE,YAAY,EAAc,eAAe,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAKtG,qBAAa,WAAY,SAAQ,KAAK,CAAC,iBAAiB,CAAC;IACvD,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,YAAY,CAAC,CAAS;gBAElB,MAAM,EAAE,iBAAiB;IAS9B,OAAO,CACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,YAAY,GACpB,cAAc,CAAC,eAAe,CAAC;IAoBlC,OAAO,CAAC,kBAAkB;IAsB1B,OAAO,CAAC,iBAAiB;CAmB1B"}
+{"version":3,"file":"TriageAgent.d.ts","sourceRoot":"","sources":["../../src/agents/TriageAgent.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,KAAK,EAAE,YAAY,EAAc,eAAe,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGtG,qBAAa,WAAY,SAAQ,KAAK;IACpC,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,YAAY,CAAC,CAAS;gBAElB,MAAM,EAAE,iBAAiB;IAkB9B,GAAG,CACR,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,YAAY,GACpB,cAAc,CAAC,eAAe,CAAC;IAoBlC,OAAO,CAAC,kBAAkB;IAwB1B;;;OAGG;IACH,OAAO,CAAC,2BAA2B;IAmBnC,OAAO,CAAC,iBAAiB;CAmB1B"}

package/dist/agents/TriageAgent.js

@@ -3,27 +3,37 @@ import { z } from 'zod';
 import { Agent } from './Agent.js';
 import { processAIStream } from '../utils/aiStream.js';
 export class TriageAgent extends Agent {
+    triageConfig;
     routes;
     defaultAgent;
     constructor(config) {
-        super(config);
+        super({
+            id: config.id,
+            name: config.name,
+            description: config.description,
+            model: config.model,
+            prompt: config.prompt ?? '',
+            tools: config.tools,
+            canHandoffTo: config.canHandoffTo,
+        });
+        this.triageConfig = config;
         if (!config.model) {
             throw new Error(`TriageAgent "${config.id}" requires a model`);
         }
         this.routes = config.routes;
         this.defaultAgent = config.defaultAgent;
     }
-    async *process(_input, context) {
+    async *run(_input, context) {
         const systemPrompt = this.buildRoutingPrompt(context);
         const handoffTool = this.createHandoffTool();
         const result = streamText({
-            model: this.config.model,
+            model: this.model,
             system: systemPrompt,
             messages: context.messages,
             abortSignal: context.abortSignal,
             tools: {
                 handoff_to_agent: handoffTool,
-                ...this.config.tools,
+                ...this.triageConfig.tools,
             },
         });
         yield* processAIStream(result.fullStream);
@@ -36,18 +46,41 @@ export class TriageAgent extends Agent {
         const defaultNote = this.defaultAgent
             ? `\n- Use "${this.defaultAgent}" when no specialist applies.`
             : '';
-        return `${this.buildSystemPrompt(context)}
+        const basePrompt = this.buildSystemPromptWithMemory(context);
+        return `${basePrompt}
 
 ## Available Specialists
 ${routeDescriptions}
 
 ## Instructions
 - Follow the system prompt above.
-- Use the handoff_to_agent tool when a specialist is needed. 
+- Use the handoff_to_agent tool when a specialist is needed.
 - You MAY provide a very brief, natural transition (e.g., "I'll check that for you...") or remain silent. Do not state "I am handing you off".
 - Keep the transition content separate from the specialist's likely greeting.
 - Always provide a reason for the handoff via the tool${defaultNote}`;
     }
+    /**
+     * Builds the system prompt with working memory appended.
+     * Mirrors the old BaseAgent.buildSystemPrompt() behavior.
+     */
+    buildSystemPromptWithMemory(context) {
+        let prompt = '';
+        if (typeof this.prompt === 'string') {
+            prompt = this.prompt;
+        }
+        else if (this.prompt && 'render' in this.prompt && typeof this.prompt.render === 'function') {
+            // Synchronous fallback for routing prompt building
+            prompt = String(this.prompt);
+        }
+        else {
+            prompt = String(this.prompt);
+        }
+        const memory = context.workingMemory.toJSON();
+        if (Object.keys(memory).length > 0) {
+            prompt += `\n\n## Known Information\n${JSON.stringify(memory, null, 2)}`;
+        }
+        return prompt;
+    }
     createHandoffTool() {
         const agentIds = this.routes.map(route => route.agentId);
         return tool({

package/dist/agents/TriageAgent.js.map

@@ -1 +1 @@
-{"version":3,"file":"TriageAgent.js","sourceRoot":"","sources":["../../src/agents/TriageAgent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AACtC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAInC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,OAAO,WAAY,SAAQ,KAAwB;IAC/C,MAAM,CAAe;IACrB,YAAY,CAAU;IAE9B,YAAY,MAAyB;QACnC,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,gBAAgB,MAAM,CAAC,EAAE,oBAAoB,CAAC,CAAC;QACjE,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,CAAC,OAAO,CACZ,MAAc,EACd,OAAqB;QAErB,MAAM,YAAY,GAAG,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;QACtD,MAAM,WAAW,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAE7C,MAAM,MAAM,GAAG,UAAU,CAAC;YACxB,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAM;YACzB,MAAM,EAAE,YAAY;YACpB,QAAQ,EAAE,OAAO,CAAC,QAAe;YACjC,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,KAAK,EAAE;gBACL,gBAAgB,EAAE,WAAW;gBAC7B,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK;aACd;SACT,CAAC,CAAC;QAEH,KAAK,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAE1C,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;IAC5E,CAAC;IAEO,kBAAkB,CAAC,OAAqB;QAC9C,MAAM,iBAAiB,GAAG,IAAI,CAAC,MAAM;aAClC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,KAAK,CAAC,OAAO,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;aAC5D,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY;YACnC,CAAC,CAAC,YAAY,IAAI,CAAC,YAAY,+BAA+B;YAC9D,CAAC,CAAC,EAAE,CAAC;QAEP,OAAO,GAAG,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC;;;EAG3C,iBAAiB;;;;;;;wDAOqC,WAAW,EAAE,CAAC;IACpE,CAAC;IAEO,iBAAiB;QACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAEzD,OAAO,IAAI,CAAC;YACV,WAAW,EAAE,wEAAwE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YAC1G,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;gBACpB,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,QAAiC,CAAC;gBACxD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;aAC9D,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE,EAAE;gBAC3C,OAAO;oBACL,SAAS,EAAE,IAAI;oBACf,aAAa;oBACb,WAAW,EAAE,aAAa;oBAC1B,MAAM;iBACP,CAAC;YACJ,CAAC;SACF,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"TriageAgent.js","sourceRoot":"","sources":["../../src/agents/TriageAgent.ts"],"names":[],"mappings":"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"}

package/dist/agents/index.d.ts

@@ -1,5 +1,5 @@
 export { Agent } from './Agent.js';
-export { LLMAgent } from './LLMAgent.js';
+export type { AgentConstructorConfig, GenerateOptions, GenerateResult, AgentStreamPart as StandaloneStreamPart, AsToolConfig, } from './Agent.js';
 export { FlowAgent } from './FlowAgent.js';
 export { TriageAgent } from './TriageAgent.js';
 export { CompositeAgent } from './CompositeAgent.js';

package/dist/agents/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EACV,sBAAsB,EACtB,eAAe,EACf,cAAc,EACd,eAAe,IAAI,oBAAoB,EACvC,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/agents/index.js

@@ -1,5 +1,4 @@
 export { Agent } from './Agent.js';
-export { LLMAgent } from './LLMAgent.js';
 export { FlowAgent } from './FlowAgent.js';
 export { TriageAgent } from './TriageAgent.js';
 export { CompositeAgent } from './CompositeAgent.js';

package/dist/agents/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAQnC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/capabilities/AutoRetrieveCapability.d.ts

@@ -0,0 +1,30 @@
+import type { Capability, ToolDeclaration, PromptSection, CapabilityAction } from './index.js';
+/**
+ * Simplified retrieval interface for the capability layer.
+ * Decoupled from AutoRetrieveProvider's RunContext requirement — the
+ * capability system is backend-agnostic and has no RunContext at tool time.
+ */
+export interface RetrieveProvider {
+    run: (opts: {
+        input: string;
+    }) => Promise<{
+        text: string;
+    } | null>;
+    label?: string;
+}
+export interface AutoRetrieveCapabilityConfig {
+    provider: RetrieveProvider;
+}
+/**
+ * Converts auto-retrieve from a pipeline stage to an on-demand
+ * `search_knowledge_base` tool. The LLM decides when to call it;
+ * the result flows back as a tool result for the LLM to use.
+ */
+export declare class AutoRetrieveCapability implements Capability {
+    private provider;
+    constructor(config: AutoRetrieveCapabilityConfig);
+    getTools(): ToolDeclaration[];
+    getPromptSections(): PromptSection[];
+    processToolResult(_toolName: string, _args: unknown, _result: unknown): CapabilityAction | null;
+}
+//# sourceMappingURL=AutoRetrieveCapability.d.ts.map

package/dist/capabilities/AutoRetrieveCapability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AutoRetrieveCapability.d.ts","sourceRoot":"","sources":["../../src/capabilities/AutoRetrieveCapability.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAI/F;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAID;;;;GAIG;AACH,qBAAa,sBAAuB,YAAW,UAAU;IACvD,OAAO,CAAC,QAAQ,CAAmB;gBAEvB,MAAM,EAAE,4BAA4B;IAIhD,QAAQ,IAAI,eAAe,EAAE;IAkB7B,iBAAiB,IAAI,aAAa,EAAE;IAIpC,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,gBAAgB,GAAG,IAAI;CAGhG"}

package/dist/capabilities/AutoRetrieveCapability.js

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+// ─── AutoRetrieveCapability ──────────────────────────────────────────────────
+/**
+ * Converts auto-retrieve from a pipeline stage to an on-demand
+ * `search_knowledge_base` tool. The LLM decides when to call it;
+ * the result flows back as a tool result for the LLM to use.
+ */
+export class AutoRetrieveCapability {
+    provider;
+    constructor(config) {
+        this.provider = config.provider;
+    }
+    getTools() {
+        const label = this.provider.label ?? 'knowledge base';
+        return [
+            {
+                name: 'search_knowledge_base',
+                description: `Search the ${label} for relevant information to answer the user's question.`,
+                parameters: z.object({
+                    query: z.string().describe('The search query'),
+                }),
+                execute: async (args) => {
+                    const result = await this.provider.run({ input: args.query });
+                    return result ?? { text: 'No relevant information found.' };
+                },
+            },
+        ];
+    }
+    getPromptSections() {
+        return [];
+    }
+    processToolResult(_toolName, _args, _result) {
+        return null;
+    }
+}
+//# sourceMappingURL=AutoRetrieveCapability.js.map

package/dist/capabilities/AutoRetrieveCapability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AutoRetrieveCapability.js","sourceRoot":"","sources":["../../src/capabilities/AutoRetrieveCapability.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAmBxB,gFAAgF;AAEhF;;;;GAIG;AACH,MAAM,OAAO,sBAAsB;IACzB,QAAQ,CAAmB;IAEnC,YAAY,MAAoC;QAC9C,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IAClC,CAAC;IAED,QAAQ;QACN,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,gBAAgB,CAAC;QAEtD,OAAO;YACL;gBACE,IAAI,EAAE,uBAAuB;gBAC7B,WAAW,EAAE,cAAc,KAAK,0DAA0D;gBAC1F,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;oBACnB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;iBAC/C,CAAC;gBACF,OAAO,EAAE,KAAK,EAAE,IAAuB,EAAE,EAAE;oBACzC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;oBAC9D,OAAO,MAAM,IAAI,EAAE,IAAI,EAAE,gCAAgC,EAAE,CAAC;gBAC9D,CAAC;aACF;SACF,CAAC;IACJ,CAAC;IAED,iBAAiB;QACf,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,iBAAiB,CAAC,SAAiB,EAAE,KAAc,EAAE,OAAgB;QACnE,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/capabilities/ExtractionCapability.d.ts

@@ -0,0 +1,25 @@
+import type { ZodTypeAny } from 'zod';
+import type { Capability, ToolDeclaration, PromptSection, CapabilityAction } from './index.js';
+export interface ExtractionCapabilityConfig {
+    schema: ZodTypeAny;
+    /** Fields that must be present to consider extraction complete. */
+    requiredFields?: string[];
+}
+/**
+ * Agent-level extraction: collects structured data across turns using a
+ * single `submit_extracted_data` tool. Distinct from FlowCapability's
+ * per-node extraction — this is for standalone agents, not flow nodes.
+ */
+export declare class ExtractionCapability implements Capability {
+    private schema;
+    private requiredFields;
+    private collectedData;
+    constructor(config: ExtractionCapabilityConfig);
+    getTools(): ToolDeclaration[];
+    getPromptSections(): PromptSection[];
+    processToolResult(toolName: string, args: unknown, result: unknown): CapabilityAction | null;
+    /** Read the data collected so far. */
+    get data(): Record<string, unknown>;
+    private getMissingFields;
+}
+//# sourceMappingURL=ExtractionCapability.d.ts.map

package/dist/capabilities/ExtractionCapability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExtractionCapability.d.ts","sourceRoot":"","sources":["../../src/capabilities/ExtractionCapability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAK/F,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,UAAU,CAAC;IACnB,mEAAmE;IACnE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAID;;;;GAIG;AACH,qBAAa,oBAAqB,YAAW,UAAU;IACrD,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,cAAc,CAAW;IACjC,OAAO,CAAC,aAAa,CAA+B;gBAExC,MAAM,EAAE,0BAA0B;IAK9C,QAAQ,IAAI,eAAe,EAAE;IAqB7B,iBAAiB,IAAI,aAAa,EAAE;IAYpC,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,gBAAgB,GAAG,IAAI;IAe5F,sCAAsC;IACtC,IAAI,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAElC;IAID,OAAO,CAAC,gBAAgB;CAazB"}

package/dist/capabilities/ExtractionCapability.js

@@ -0,0 +1,74 @@
+import { mergeExtractionData, computeMissingFields, toExtractionSubmissionSchema } from '../flows/extraction.js';
+// ─── ExtractionCapability ────────────────────────────────────────────────────
+/**
+ * Agent-level extraction: collects structured data across turns using a
+ * single `submit_extracted_data` tool. Distinct from FlowCapability's
+ * per-node extraction — this is for standalone agents, not flow nodes.
+ */
+export class ExtractionCapability {
+    schema;
+    requiredFields;
+    collectedData = {};
+    constructor(config) {
+        this.schema = config.schema;
+        this.requiredFields = config.requiredFields ?? [];
+    }
+    getTools() {
+        const missing = this.getMissingFields();
+        return [
+            {
+                name: 'submit_extracted_data',
+                description: [
+                    'Submit information extracted from the conversation.',
+                    missing.length > 0
+                        ? `Still needed: ${missing.join(', ')}.`
+                        : 'All required fields collected.',
+                    'Only submit values explicitly provided by the user.',
+                    'Omit fields or use null when the value is still unknown.',
+                    'Call this tool every time you learn new field values.',
+                ].join(' '),
+                parameters: toExtractionSubmissionSchema(this.schema),
+                execute: async (args) => args,
+            },
+        ];
+    }
+    getPromptSections() {
+        const missing = this.getMissingFields();
+        if (missing.length === 0)
+            return [];
+        return [
+            {
+                role: 'extraction',
+                content: `You still need to collect: ${missing.join(', ')}. Ask for these naturally.`,
+            },
+        ];
+    }
+    processToolResult(toolName, args, result) {
+        if (toolName !== 'submit_extracted_data')
+            return null;
+        this.collectedData = mergeExtractionData(this.collectedData, args);
+        const missing = this.getMissingFields();
+        if (missing.length === 0) {
+            return { type: 'extraction-complete', data: this.collectedData };
+        }
+        return { type: 'continue' };
+    }
+    /** Read the data collected so far. */
+    get data() {
+        return this.collectedData;
+    }
+    // ─── Private ───────────────────────────────────────────────────────────────
+    getMissingFields() {
+        if (this.requiredFields.length > 0) {
+            return computeMissingFields(this.collectedData, this.requiredFields);
+        }
+        // Fall back to Zod schema parse to infer missing fields
+        const parsed = this.schema.safeParse(this.collectedData);
+        if (parsed.success)
+            return [];
+        return [...new Set((parsed.error.issues ?? [])
+                .map((issue) => issue.path.join('.'))
+                .filter(Boolean))];
+    }
+}
+//# sourceMappingURL=ExtractionCapability.js.map

package/dist/capabilities/ExtractionCapability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExtractionCapability.js","sourceRoot":"","sources":["../../src/capabilities/ExtractionCapability.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AAUjH,gFAAgF;AAEhF;;;;GAIG;AACH,MAAM,OAAO,oBAAoB;IACvB,MAAM,CAAa;IACnB,cAAc,CAAW;IACzB,aAAa,GAA4B,EAAE,CAAC;IAEpD,YAAY,MAAkC;QAC5C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,EAAE,CAAC;IACpD,CAAC;IAED,QAAQ;QACN,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAExC,OAAO;YACL;gBACE,IAAI,EAAE,uBAAuB;gBAC7B,WAAW,EAAE;oBACX,qDAAqD;oBACrD,OAAO,CAAC,MAAM,GAAG,CAAC;wBAChB,CAAC,CAAC,iBAAiB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;wBACxC,CAAC,CAAC,gCAAgC;oBACpC,qDAAqD;oBACrD,0DAA0D;oBAC1D,uDAAuD;iBACxD,CAAC,IAAI,CAAC,GAAG,CAAC;gBACX,UAAU,EAAE,4BAA4B,CAAC,IAAI,CAAC,MAAM,CAAC;gBACrD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE,CAAC,IAAI;aACvC;SACF,CAAC;IACJ,CAAC;IAED,iBAAiB;QACf,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAEpC,OAAO;YACL;gBACE,IAAI,EAAE,YAAY;gBAClB,OAAO,EAAE,8BAA8B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,4BAA4B;aACtF;SACF,CAAC;IACJ,CAAC;IAED,iBAAiB,CAAC,QAAgB,EAAE,IAAa,EAAE,MAAe;QAChE,IAAI,QAAQ,KAAK,uBAAuB;YAAE,OAAO,IAAI,CAAC;QAEtD,IAAI,CAAC,aAAa,GAAG,mBAAmB,CACtC,IAAI,CAAC,aAAa,EAClB,IAA+B,CAChC,CAAC;QAEF,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,EAAE,IAAI,EAAE,qBAAqB,EAAE,IAAI,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC;QACnE,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAC9B,CAAC;IAED,sCAAsC;IACtC,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED,8EAA8E;IAEtE,gBAAgB;QACtB,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnC,OAAO,oBAAoB,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;QACvE,CAAC;QACD,wDAAwD;QACxD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACzD,IAAI,MAAM,CAAC,OAAO;YAAE,OAAO,EAAE,CAAC;QAC9B,OAAO,CAAC,GAAG,IAAI,GAAG,CAChB,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC;iBACxB,GAAG,CAAC,CAAC,KAAoC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;iBACnE,MAAM,CAAC,OAAO,CAAC,CACnB,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/capabilities/FlowCapability.d.ts

@@ -0,0 +1,81 @@
+import type { Capability, ToolDeclaration, PromptSection, CapabilityAction } from './index.js';
+import type { FlowConfig, FlowContext, ExtractionNodeConfig } from '../types/index.js';
+export interface FlowCapabilityConfig {
+    flow: FlowConfig;
+    initialNode: string;
+    state?: FlowCapabilityState;
+    defaultRolePrompt?: string;
+}
+export interface FlowCapabilityState {
+    context: FlowContext;
+    initialized: boolean;
+    flowEnded: boolean;
+}
+/**
+ * Headless flow state machine that exposes flow behavior as tools.
+ *
+ * Owns: node graph, transitions, current node, collectedData,
+ * oscillation tracking, extraction node handling, contract validation.
+ *
+ * Does NOT own: LLM calls, streaming, AI SDK imports. The host
+ * (Gemini Live, AI SDK, LiveKit) handles inference.
+ */
+export declare class FlowCapability implements Capability {
+    private nodes;
+    private transitions;
+    private context;
+    private currentNodeConfig;
+    private initialized;
+    private flowEnded;
+    private _justTransitioned;
+    private maxOscillations;
+    private defaultRolePrompt?;
+    /** Tracks transition edges within a single process() call for oscillation detection. */
+    private turnTransitionCounts;
+    /** Events emitted during transitions (node-enter, node-exit, flow-transition, etc.). */
+    private pendingEvents;
+    constructor(config: FlowCapabilityConfig);
+    getTools(): ToolDeclaration[];
+    getPromptSections(): PromptSection[];
+    processToolResult(toolName: string, args: unknown, result: unknown): CapabilityAction | null;
+    /** Initialize the flow (transition to initial node). */
+    initialize(): FlowEvent[];
+    /** Call at the start of each user turn to reset oscillation tracking. */
+    resetTurnTracking(): void;
+    /** Record a user message in the flow context. */
+    appendUserMessage(content: string): void;
+    /** Record an assistant message in the flow context. */
+    appendAssistantMessage(content: string): void;
+    get currentNode(): string | undefined;
+    currentNodeIsExtractionNode(): boolean;
+    currentExtractionNode(): ExtractionNodeConfig | null;
+    get collectedData(): Record<string, unknown>;
+    updateCollectedData(verified: Record<string, unknown>): boolean;
+    get hasEnded(): boolean;
+    get isInitialized(): boolean;
+    getState(): FlowCapabilityState;
+    /** Drain accumulated flow events (node-enter, node-exit, etc.). */
+    drainEvents(): FlowEvent[];
+    private executeTransition;
+    private mergeExtractedData;
+    private checkExtractionComplete;
+    private getMissingExtractionFields;
+    private applyContextStrategy;
+    private getRelevantCollectedData;
+    private buildExtractionContinueEnvelope;
+}
+export type FlowEvent = {
+    type: 'node-enter';
+    nodeName: string;
+} | {
+    type: 'node-exit';
+    nodeName: string;
+} | {
+    type: 'flow-transition';
+    from: string;
+    to: string;
+} | {
+    type: 'flow-end';
+    reason: string;
+};
+//# sourceMappingURL=FlowCapability.d.ts.map

package/dist/capabilities/FlowCapability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlowCapability.d.ts","sourceRoot":"","sources":["../../src/capabilities/FlowCapability.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EACV,eAAe,EACf,aAAa,EACb,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EAGX,oBAAoB,EAGrB,MAAM,mBAAmB,CAAC;AAW3B,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,WAAW,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;CACpB;AAaD;;;;;;;;GAQG;AACH,qBAAa,cAAe,YAAW,UAAU;IAC/C,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,WAAW,CAA6C;IAChE,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,iBAAiB,CAA+B;IACxD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,iBAAiB,CAA6C;IACtE,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,iBAAiB,CAAC,CAAS;IAEnC,wFAAwF;IACxF,OAAO,CAAC,oBAAoB,CAA6B;IAEzD,wFAAwF;IACxF,OAAO,CAAC,aAAa,CAAmB;gBAE5B,MAAM,EAAE,oBAAoB;IAkCxC,QAAQ,IAAI,eAAe,EAAE;IAiF7B,iBAAiB,IAAI,aAAa,EAAE;IA0EpC,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,gBAAgB,GAAG,IAAI;IAqE5F,wDAAwD;IACxD,UAAU,IAAI,SAAS,EAAE;IAQzB,yEAAyE;IACzE,iBAAiB,IAAI,IAAI;IAIzB,iDAAiD;IACjD,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAQxC,uDAAuD;IACvD,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI7C,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAEpC;IAED,2BAA2B,IAAI,OAAO;IAItC,qBAAqB,IAAI,oBAAoB,GAAG,IAAI;IAOpD,IAAI,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE3C;IAED,mBAAmB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IAM/D,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED,QAAQ,IAAI,mBAAmB;IAQ/B,mEAAmE;IACnE,WAAW,IAAI,SAAS,EAAE;IAQ1B,OAAO,CAAC,iBAAiB;IA4EzB,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,uBAAuB;IAe/B,OAAO,CAAC,0BAA0B;IAiBlC,OAAO,CAAC,oBAAoB;IAsB5B,OAAO,CAAC,wBAAwB;IAchC,OAAO,CAAC,+BAA+B;CA4BxC;AAID,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC"}