@ariaflowagents/core 0.1.0

package/README.md

@@ -0,0 +1,39 @@
+# @ariaflowagents/core
+
+AriaFlow core runtime and agent primitives for building structured, multi-agent conversations.
+
+## Install
+
+```bash
+npm install @ariaflowagents/core
+```
+
+## Quick start
+
+```ts
+import { Runtime, type AgentConfig } from '@ariaflowagents/core';
+import { openai } from '@ai-sdk/openai';
+
+const supportAgent: AgentConfig = {
+  id: 'support',
+  name: 'Support Agent',
+  systemPrompt: 'You are a helpful support agent.',
+  model: openai('gpt-4o-mini') as any,
+};
+
+const runtime = new Runtime({
+  agents: [supportAgent],
+  defaultAgentId: 'support',
+  defaultModel: openai('gpt-4o-mini') as any,
+});
+
+const run = async () => {
+  for await (const part of runtime.stream({ input: 'Hello there' })) {
+    if (part.type === 'text-delta') {
+      process.stdout.write(part.text);
+    }
+  }
+};
+
+run();
+```

package/dist/agents/Agent.d.ts

@@ -0,0 +1,15 @@
+import type { AgentConfig, AgentContext, AgentStreamPart } from '../types/index.js';
+export declare abstract class Agent<TConfig extends AgentConfig = AgentConfig> {
+    readonly id: string;
+    readonly name: string;
+    readonly description?: string;
+    protected config: TConfig;
+    constructor(config: TConfig);
+    abstract process(input: string, context: AgentContext): AsyncGenerator<AgentStreamPart>;
+    canHandle(_input: string, _context: AgentContext): Promise<boolean>;
+    initialize(_context: AgentContext): Promise<void>;
+    cleanup(_context: AgentContext): Promise<void>;
+    get canHandoffTo(): string[];
+    protected buildSystemPrompt(context: AgentContext): string;
+}
+//# sourceMappingURL=Agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Agent.d.ts","sourceRoot":"","sources":["../../src/agents/Agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpF,8BAAsB,KAAK,CAAC,OAAO,SAAS,WAAW,GAAG,WAAW;IACnE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC;gBAEd,MAAM,EAAE,OAAO;IAO3B,QAAQ,CAAC,OAAO,CACd,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,YAAY,GACpB,cAAc,CAAC,eAAe,CAAC;IAE5B,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAInE,UAAU,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD,OAAO,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpD,IAAI,YAAY,IAAI,MAAM,EAAE,CAE3B;IAED,SAAS,CAAC,iBAAiB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM;CAU3D"}

package/dist/agents/Agent.js

@@ -0,0 +1,33 @@
+export class Agent {
+    id;
+    name;
+    description;
+    config;
+    constructor(config) {
+        this.id = config.id;
+        this.name = config.name;
+        this.description = config.description;
+        this.config = config;
+    }
+    async canHandle(_input, _context) {
+        return true;
+    }
+    async initialize(_context) {
+        // Optional in subclasses
+    }
+    async cleanup(_context) {
+        // Optional in subclasses
+    }
+    get canHandoffTo() {
+        return this.config.canHandoffTo ?? [];
+    }
+    buildSystemPrompt(context) {
+        let prompt = this.config.systemPrompt;
+        const memory = context.workingMemory.toJSON();
+        if (Object.keys(memory).length > 0) {
+            prompt += `\n\n## Known Information\n${JSON.stringify(memory, null, 2)}`;
+        }
+        return prompt;
+    }
+}
+//# sourceMappingURL=Agent.js.map

package/dist/agents/Agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Agent.js","sourceRoot":"","sources":["../../src/agents/Agent.ts"],"names":[],"mappings":"AAEA,MAAM,OAAgB,KAAK;IAChB,EAAE,CAAS;IACX,IAAI,CAAS;IACb,WAAW,CAAU;IACpB,MAAM,CAAU;IAE1B,YAAY,MAAe;QACzB,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAOD,KAAK,CAAC,SAAS,CAAC,MAAc,EAAE,QAAsB;QACpD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,QAAsB;QACrC,yBAAyB;IAC3B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,QAAsB;QAClC,yBAAyB;IAC3B,CAAC;IAED,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC;IACxC,CAAC;IAES,iBAAiB,CAAC,OAAqB;QAC/C,IAAI,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC;QAEtC,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC;QAC9C,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,6BAA6B,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QAC3E,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/agents/CompositeAgent.d.ts

@@ -0,0 +1,24 @@
+import type { AgentContext, AgentStreamPart } from '../types/index.js';
+import type { Agent } from './Agent.js';
+export interface CompositeAgentConfig {
+    id: string;
+    name: string;
+    description?: string;
+    agents: Agent[];
+    entryAgent: string;
+    maxHandoffs?: number;
+}
+export declare class CompositeAgent {
+    readonly id: string;
+    readonly name: string;
+    readonly description?: string;
+    private agents;
+    private entryAgentId;
+    private maxHandoffs;
+    constructor(config: CompositeAgentConfig);
+    process(input: string, context: AgentContext): AsyncGenerator<AgentStreamPart>;
+    getAgent(id: string): Agent | undefined;
+    get agentIds(): string[];
+    get entryAgent(): string;
+}
+//# sourceMappingURL=CompositeAgent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CompositeAgent.d.ts","sourceRoot":"","sources":["../../src/agents/CompositeAgent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,cAAc;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,EAAE,oBAAoB;IAYjC,OAAO,CACZ,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,YAAY,GACpB,cAAc,CAAC,eAAe,CAAC;IAwClC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAIvC,IAAI,QAAQ,IAAI,MAAM,EAAE,CAEvB;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;CACF"}

package/dist/agents/CompositeAgent.js

@@ -0,0 +1,59 @@
+export class CompositeAgent {
+    id;
+    name;
+    description;
+    agents = new Map();
+    entryAgentId;
+    maxHandoffs;
+    constructor(config) {
+        this.id = config.id;
+        this.name = config.name;
+        this.description = config.description;
+        this.entryAgentId = config.entryAgent;
+        this.maxHandoffs = config.maxHandoffs ?? 10;
+        for (const agent of config.agents) {
+            this.agents.set(agent.id, agent);
+        }
+    }
+    async *process(input, context) {
+        let currentAgentId = context.currentAgent || this.entryAgentId;
+        let currentInput = input;
+        let handoffCount = 0;
+        while (handoffCount < this.maxHandoffs) {
+            const agent = this.agents.get(currentAgentId);
+            if (!agent) {
+                yield { type: 'error', error: `Agent "${currentAgentId}" not found` };
+                return;
+            }
+            let handoffTriggered = false;
+            let nextAgentId;
+            for await (const part of agent.process(currentInput, context)) {
+                yield part;
+                if (part.type === 'handoff') {
+                    handoffTriggered = true;
+                    nextAgentId = part.targetAgent;
+                    handoffCount += 1;
+                }
+            }
+            if (!handoffTriggered || !nextAgentId) {
+                break;
+            }
+            currentAgentId = nextAgentId;
+            context.currentAgent = nextAgentId;
+            currentInput = '';
+        }
+        if (handoffCount >= this.maxHandoffs) {
+            yield { type: 'error', error: 'Maximum handoffs exceeded' };
+        }
+    }
+    getAgent(id) {
+        return this.agents.get(id);
+    }
+    get agentIds() {
+        return Array.from(this.agents.keys());
+    }
+    get entryAgent() {
+        return this.entryAgentId;
+    }
+}
+//# sourceMappingURL=CompositeAgent.js.map

package/dist/agents/CompositeAgent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompositeAgent.js","sourceRoot":"","sources":["../../src/agents/CompositeAgent.ts"],"names":[],"mappings":"AAYA,MAAM,OAAO,cAAc;IAChB,EAAE,CAAS;IACX,IAAI,CAAS;IACb,WAAW,CAAU;IACtB,MAAM,GAAG,IAAI,GAAG,EAAiB,CAAC;IAClC,YAAY,CAAS;IACrB,WAAW,CAAS;IAE5B,YAAY,MAA4B;QACtC,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,UAAU,CAAC;QACtC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC;QAE5C,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,CAAC,OAAO,CACZ,KAAa,EACb,OAAqB;QAErB,IAAI,cAAc,GAAG,OAAO,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,CAAC;QAC/D,IAAI,YAAY,GAAG,KAAK,CAAC;QACzB,IAAI,YAAY,GAAG,CAAC,CAAC;QAErB,OAAO,YAAY,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YACvC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YAE9C,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,cAAc,aAAa,EAAE,CAAC;gBACtE,OAAO;YACT,CAAC;YAED,IAAI,gBAAgB,GAAG,KAAK,CAAC;YAC7B,IAAI,WAA+B,CAAC;YAEpC,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,EAAE,CAAC;gBAC9D,MAAM,IAAI,CAAC;gBAEX,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;oBAC5B,gBAAgB,GAAG,IAAI,CAAC;oBACxB,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;oBAC/B,YAAY,IAAI,CAAC,CAAC;gBACpB,CAAC;YACH,CAAC;YAED,IAAI,CAAC,gBAAgB,IAAI,CAAC,WAAW,EAAE,CAAC;gBACtC,MAAM;YACR,CAAC;YAED,cAAc,GAAG,WAAW,CAAC;YAC7B,OAAO,CAAC,YAAY,GAAG,WAAW,CAAC;YACnC,YAAY,GAAG,EAAE,CAAC;QACpB,CAAC;QAED,IAAI,YAAY,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,2BAA2B,EAAE,CAAC;QAC9D,CAAC;IACH,CAAC;IAED,QAAQ,CAAC,EAAU;QACjB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;CACF"}

package/dist/agents/FlowAgent.d.ts

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

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

@@ -0,0 +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"}

package/dist/agents/FlowAgent.js

@@ -0,0 +1,44 @@
+import { Agent } from './Agent.js';
+import { FlowManager } from '../flows/FlowManager.js';
+export class FlowAgent extends Agent {
+    flowManager;
+    constructor(config) {
+        super(config);
+        if (!config.model) {
+            throw new Error(`FlowAgent "${config.id}" requires a model`);
+        }
+    }
+    async *process(input, context) {
+        if (!this.flowManager) {
+            this.flowManager = new FlowManager({
+                flow: this.config.flow,
+                initialNode: this.config.initialNode,
+                model: this.config.model,
+                defaultRolePrompt: this.config.systemPrompt,
+                contextMessages: context.messages,
+                sessionMessages: context.session.messages,
+            });
+            for await (const part of this.flowManager.initialize()) {
+                yield part;
+            }
+        }
+        for await (const part of this.flowManager.process(input)) {
+            yield part;
+            if (part.type === 'flow-end') {
+                this.flowManager = undefined;
+            }
+        }
+    }
+    get collectedData() {
+        return this.flowManager?.collectedData ?? {};
+    }
+    get currentNode() {
+        return this.flowManager?.currentNode;
+    }
+    async transitionTo(node) {
+        if (this.flowManager) {
+            await this.flowManager.transitionTo(node);
+        }
+    }
+}
+//# sourceMappingURL=FlowAgent.js.map

package/dist/agents/FlowAgent.js.map

@@ -0,0 +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,MAAM,CAAC,YAAY;gBAC3C,eAAe,EAAE,OAAO,CAAC,QAAQ;gBACjC,eAAe,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ;aAC1C,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/LLMAgent.d.ts

@@ -0,0 +1,11 @@
+import { type ToolSet } from 'ai';
+import { Agent } from './Agent.js';
+import type { AgentContext, AgentStreamPart, LLMAgentConfig } from '../types/index.js';
+export declare class LLMAgent extends Agent<LLMAgentConfig> {
+    private model;
+    private tools;
+    constructor(config: LLMAgentConfig);
+    process(_input: string, context: AgentContext): AsyncGenerator<AgentStreamPart>;
+    protected getToolsForContext(_context: AgentContext): ToolSet;
+}
+//# sourceMappingURL=LLMAgent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LLMAgent.d.ts","sourceRoot":"","sources":["../../src/agents/LLMAgent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkC,KAAK,OAAO,EAAE,MAAM,IAAI,CAAC;AAClE,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGvF,qBAAa,QAAS,SAAQ,KAAK,CAAC,cAAc,CAAC;IACjD,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,KAAK,CAAU;gBAEX,MAAM,EAAE,cAAc;IAS3B,OAAO,CACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,YAAY,GACpB,cAAc,CAAC,eAAe,CAAC;IAyClC,SAAS,CAAC,kBAAkB,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO;CAG9D"}

package/dist/agents/LLMAgent.js

@@ -0,0 +1,52 @@
+import { streamText } from 'ai';
+import { Agent } from './Agent.js';
+import { isHandoffResult } from '../tools/handoff.js';
+export class LLMAgent extends Agent {
+    model;
+    tools;
+    constructor(config) {
+        super(config);
+        if (!config.model) {
+            throw new Error(`LLMAgent "${config.id}" requires a model`);
+        }
+        this.model = config.model;
+        this.tools = config.tools ?? {};
+    }
+    async *process(_input, context) {
+        const systemPrompt = this.buildSystemPrompt(context);
+        const result = streamText({
+            model: this.model,
+            system: systemPrompt,
+            messages: context.messages,
+            tools: this.getToolsForContext(context),
+        });
+        for await (const chunk of result.fullStream) {
+            if (chunk.type === 'text-delta') {
+                yield { type: 'text-delta', text: chunk.text };
+            }
+            if (chunk.type === 'tool-call') {
+                const args = 'args' in chunk ? chunk.args : chunk.input;
+                yield { type: 'tool-call', toolName: chunk.toolName, args };
+            }
+            if (chunk.type === 'tool-result') {
+                const toolResult = 'result' in chunk ? chunk.result : chunk.output;
+                yield { type: 'tool-result', toolName: chunk.toolName, result: toolResult };
+                if (isHandoffResult(toolResult)) {
+                    const targetAgent = toolResult.targetAgent ?? toolResult.targetAgentId;
+                    yield {
+                        type: 'handoff',
+                        targetAgent,
+                        reason: toolResult.reason,
+                    };
+                }
+            }
+        }
+        const response = await result.response;
+        context.session.messages.push(...response.messages);
+        yield { type: 'turn-end' };
+    }
+    getToolsForContext(_context) {
+        return this.tools;
+    }
+}
+//# sourceMappingURL=LLMAgent.js.map

package/dist/agents/LLMAgent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LLMAgent.js","sourceRoot":"","sources":["../../src/agents/LLMAgent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAoC,MAAM,IAAI,CAAC;AAClE,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,MAAM,OAAO,QAAS,SAAQ,KAAqB;IACzC,KAAK,CAAgB;IACrB,KAAK,CAAU;IAEvB,YAAY,MAAsB;QAChC,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,aAAa,MAAM,CAAC,EAAE,oBAAoB,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,CAAC,OAAO,CACZ,MAAc,EACd,OAAqB;QAErB,MAAM,YAAY,GAAG,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAErD,MAAM,MAAM,GAAG,UAAU,CAAC;YACxB,KAAK,EAAE,IAAI,CAAC,KAAY;YACxB,MAAM,EAAE,YAAY;YACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,KAAK,EAAE,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC;SACxC,CAAC,CAAC;QAEH,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YAC5C,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBAChC,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;YACjD,CAAC;YAED,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBAC/B,MAAM,IAAI,GAAG,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAE,KAAa,CAAC,KAAK,CAAC;gBACjE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;YAC9D,CAAC;YAED,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;gBACjC,MAAM,UAAU,GAAG,QAAQ,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAE,KAAa,CAAC,MAAM,CAAC;gBAC5E,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;gBAE5E,IAAI,eAAe,CAAC,UAAU,CAAC,EAAE,CAAC;oBAChC,MAAM,WAAW,GAAG,UAAU,CAAC,WAAW,IAAI,UAAU,CAAC,aAAa,CAAC;oBACvE,MAAM;wBACJ,IAAI,EAAE,SAAS;wBACf,WAAW;wBACX,MAAM,EAAE,UAAU,CAAC,MAAM;qBAC1B,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC;QACvC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAEpD,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAC7B,CAAC;IAES,kBAAkB,CAAC,QAAsB;QACjD,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF"}

package/dist/agents/TriageAgent.d.ts

@@ -0,0 +1,11 @@
+import { Agent } from './Agent.js';
+import type { AgentContext, AgentStreamPart, TriageAgentConfig } from '../types/index.js';
+export declare class TriageAgent extends Agent<TriageAgentConfig> {
+    private routes;
+    private defaultAgent?;
+    constructor(config: TriageAgentConfig);
+    process(_input: string, context: AgentContext): AsyncGenerator<AgentStreamPart>;
+    private buildRoutingPrompt;
+    private createHandoffTool;
+}
+//# sourceMappingURL=TriageAgent.d.ts.map

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

@@ -0,0 +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;AAGtG,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;IA6ClC,OAAO,CAAC,kBAAkB;IAoB1B,OAAO,CAAC,iBAAiB;CAmB1B"}

package/dist/agents/TriageAgent.js

@@ -0,0 +1,89 @@
+import { streamText, tool } from 'ai';
+import { z } from 'zod';
+import { Agent } from './Agent.js';
+import { isHandoffResult } from '../tools/handoff.js';
+export class TriageAgent extends Agent {
+    routes;
+    defaultAgent;
+    constructor(config) {
+        super(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) {
+        const systemPrompt = this.buildRoutingPrompt();
+        const handoffTool = this.createHandoffTool();
+        const result = streamText({
+            model: this.config.model,
+            system: systemPrompt,
+            messages: context.messages,
+            tools: {
+                handoff_to_agent: handoffTool,
+                ...this.config.tools,
+            },
+        });
+        for await (const chunk of result.fullStream) {
+            if (chunk.type === 'text-delta') {
+                yield { type: 'text-delta', text: chunk.text };
+            }
+            if (chunk.type === 'tool-call') {
+                const args = 'args' in chunk ? chunk.args : chunk.input;
+                yield { type: 'tool-call', toolName: chunk.toolName, args };
+            }
+            if (chunk.type === 'tool-result') {
+                const toolResult = 'result' in chunk ? chunk.result : chunk.output;
+                yield { type: 'tool-result', toolName: chunk.toolName, result: toolResult };
+                if (isHandoffResult(toolResult)) {
+                    const targetAgent = toolResult.targetAgent ?? toolResult.targetAgentId;
+                    yield {
+                        type: 'handoff',
+                        targetAgent,
+                        reason: toolResult.reason,
+                    };
+                }
+            }
+        }
+        const response = await result.response;
+        context.session.messages.push(...response.messages);
+        yield { type: 'turn-end' };
+    }
+    buildRoutingPrompt() {
+        const routeDescriptions = this.routes
+            .map(route => `- **${route.agentId}**: ${route.description}`)
+            .join('\n');
+        const defaultNote = this.defaultAgent
+            ? `\n- Use "${this.defaultAgent}" when no specialist applies.`
+            : '';
+        return `${this.config.systemPrompt}
+
+## Available Specialists
+${routeDescriptions}
+
+## Instructions
+- For general questions, answer directly
+- When the customer needs specialized help, use the handoff_to_agent tool
+- Always provide a brief reason for the handoff${defaultNote}`;
+    }
+    createHandoffTool() {
+        const agentIds = this.routes.map(route => route.agentId);
+        return tool({
+            description: `Transfer the conversation to a specialized agent.\nAvailable agents: ${agentIds.join(', ')}`,
+            inputSchema: z.object({
+                targetAgentId: z.enum(agentIds),
+                reason: z.string().describe('Why transferring to this agent'),
+            }),
+            execute: async ({ targetAgentId, reason }) => {
+                return {
+                    __handoff: true,
+                    targetAgentId,
+                    targetAgent: targetAgentId,
+                    reason,
+                };
+            },
+        });
+    }
+}
+//# sourceMappingURL=TriageAgent.js.map

package/dist/agents/TriageAgent.js.map

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

package/dist/agents/index.d.ts

@@ -0,0 +1,7 @@
+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';
+export type { CompositeAgentConfig } from './CompositeAgent.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

package/dist/agents/index.js

@@ -0,0 +1,6 @@
+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';
+//# sourceMappingURL=index.js.map

package/dist/agents/index.js.map

@@ -0,0 +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"}

package/dist/flows/AgentFlowManager.d.ts

@@ -0,0 +1,154 @@
+import { type ToolSet, type ModelMessage } from 'ai';
+import type { LanguageModel } from 'ai';
+import { z } from 'zod';
+import { type FlowTransitionSignal } from './transitions.js';
+export declare enum ContextStrategy {
+    APPEND = "append",
+    RESET = "reset",
+    RESET_WITH_SUMMARY = "reset_with_summary"
+}
+export interface ContextStrategyConfig {
+    strategy: ContextStrategy;
+    summaryPrompt?: string;
+    summaryMaxTokens?: number;
+}
+export type FlowAction = {
+    type: 'say';
+    text: string;
+} | {
+    type: 'end';
+    message?: string;
+} | {
+    type: 'function';
+    handler: FlowActionHandler;
+} | {
+    type: 'delay';
+    ms: number;
+} | {
+    type: 'emit';
+    event: string;
+    data?: unknown;
+};
+export type FlowActionHandler = (context: FlowContext) => Promise<void>;
+export interface FlowNodeConfig {
+    name: string;
+    description?: string;
+    rolePrompt?: string;
+    taskPrompt: string;
+    tools?: ToolSet;
+    preActions?: FlowAction[];
+    postActions?: FlowAction[];
+    contextStrategy?: ContextStrategyConfig;
+    autoRespond?: boolean;
+    maxTurns?: number;
+}
+export interface FlowContext {
+    state: Record<string, unknown>;
+    currentNode: string;
+    messages: ModelMessage[];
+    collectedData: Record<string, unknown>;
+    nodeHistory: string[];
+    nodeTurnCounts: Record<string, number>;
+    sessionId: string;
+    userId?: string;
+    ended: boolean;
+    endReason?: string;
+}
+export interface FlowManagerConfig {
+    nodes: FlowNodeConfig[];
+    initialNode: string;
+    globalTools?: ToolSet;
+    defaultRolePrompt?: string;
+    defaultContextStrategy?: ContextStrategyConfig;
+    model: LanguageModel;
+    hooks?: FlowHooks;
+}
+export interface FlowHooks {
+    onFlowStart?: (context: FlowContext) => Promise<void>;
+    onFlowEnd?: (context: FlowContext, reason: string) => Promise<void>;
+    onNodeEnter?: (context: FlowContext, node: FlowNodeConfig) => Promise<void>;
+    onNodeExit?: (context: FlowContext, node: FlowNodeConfig) => Promise<void>;
+    onBeforeInference?: (context: FlowContext, node: FlowNodeConfig) => Promise<void>;
+    onAfterInference?: (context: FlowContext, node: FlowNodeConfig, response: string) => Promise<void>;
+    onTransition?: (context: FlowContext, from: string, to: string, data?: Record<string, unknown>) => Promise<void>;
+    onError?: (context: FlowContext, error: Error) => Promise<void>;
+}
+export type FlowStreamPart = {
+    type: 'text-delta';
+    text: string;
+} | {
+    type: 'tool-call';
+    toolName: string;
+    args: unknown;
+} | {
+    type: 'tool-result';
+    toolName: string;
+    result: unknown;
+} | {
+    type: 'transition';
+    from: string;
+    to: string;
+    data?: Record<string, unknown>;
+} | {
+    type: 'node-enter';
+    nodeName: string;
+} | {
+    type: 'node-exit';
+    nodeName: string;
+} | {
+    type: 'action';
+    actionType: string;
+    data?: unknown;
+} | {
+    type: 'flow-end';
+    reason: string;
+} | {
+    type: 'error';
+    error: string;
+} | {
+    type: 'done';
+};
+export declare function createCollectorTool<T extends z.ZodRawShape>(description: string, schema: z.ZodObject<T>, nextNode: string): {
+    description: string;
+    parameters: z.ZodObject<T, z.UnknownKeysParam, z.ZodTypeAny, z.objectUtil.addQuestionMarks<z.baseObjectOutputType<T>, any> extends infer T_1 ? { [k in keyof T_1]: T_1[k]; } : never, z.baseObjectInputType<T> extends infer T_2 ? { [k_1 in keyof T_2]: T_2[k_1]; } : never>;
+    execute: (data: z.infer<z.ZodObject<T>>) => Promise<FlowTransitionSignal>;
+};
+export declare class AgentFlowManager {
+    private nodes;
+    private currentNode;
+    private context;
+    private config;
+    private initialized;
+    constructor(config: FlowManagerConfig, sessionId: string, userId?: string);
+    initialize(): Promise<FlowStreamPart[]>;
+    process(userInput: string): AsyncGenerator<FlowStreamPart>;
+    forceTransition(nodeName: string, data?: Record<string, unknown>): Promise<FlowStreamPart[]>;
+    endFlow(reason?: string): Promise<void>;
+    get state(): Record<string, unknown>;
+    get collectedData(): Record<string, unknown>;
+    get currentNodeName(): string;
+    get nodeHistory(): string[];
+    get hasEnded(): boolean;
+    get fullContext(): {
+        state: Record<string, unknown>;
+        currentNode: string;
+        messages: ModelMessage[];
+        collectedData: Record<string, unknown>;
+        nodeHistory: string[];
+        nodeTurnCounts: Record<string, number>;
+        sessionId: string;
+        userId?: string;
+        ended: boolean;
+        endReason?: string;
+    };
+    private transitionTo;
+    private generateNodeResponse;
+    private runInference;
+    private buildSystemPrompt;
+    private applyContextStrategy;
+    private generateSummary;
+    private runActions;
+    static create(config: FlowManagerConfig, sessionId: string, userId?: string): AgentFlowManager;
+    static restore(config: FlowManagerConfig, savedContext: FlowContext): AgentFlowManager;
+}
+//# sourceMappingURL=AgentFlowManager.d.ts.map

package/dist/flows/AgentFlowManager.d.ts.map

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