@ariaflowagents/core 0.1.0

package/dist/index.js

@@ -0,0 +1,23 @@
+export { Agent } from './agents/Agent.js';
+export { LLMAgent } from './agents/LLMAgent.js';
+export { FlowAgent } from './agents/FlowAgent.js';
+export { TriageAgent } from './agents/TriageAgent.js';
+export { CompositeAgent } from './agents/CompositeAgent.js';
+export { FlowManager } from './flows/FlowManager.js';
+export { FlowGraph, FlowGraphBuilder } from './flows/FlowGraph.js';
+export { FlowNode } from './flows/FlowNode.js';
+export { createFlowTransition, isFlowTransition } from './flows/transitions.js';
+export { AgentFlowManager, ContextStrategy, createCollectorTool, } from './flows/AgentFlowManager.js';
+export { SessionManager } from './session/SessionManager.js';
+export { MemoryStore } from './session/stores/MemoryStore.js';
+export { Runtime, createRuntime } from './runtime/Runtime.js';
+export { InjectionQueue, createInjectionQueue, commonInjections } from './runtime/InjectionQueue.js';
+export { SessionWorkingMemory } from './runtime/WorkingMemory.js';
+export { createHandoffTool, isHandoffResult } from './tools/handoff.js';
+export { HookRunner, createHookRunner } from './hooks/HookRunner.js';
+export { loggingHooks, createLoggingHooks } from './hooks/builtin/logging.js';
+export { createMetricsHooks, InMemoryMetrics } from './hooks/builtin/metrics.js';
+export { ToolEnforcer, createToolEnforcer } from './guards/ToolEnforcer.js';
+export * as StopConditions from './guards/StopConditions.js';
+export * as EnforcementRules from './guards/rules.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAG5D,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,mBAAmB,GACpB,MAAM,6BAA6B,CAAC;AAWrC,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAE9D,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACrG,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAGlE,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGxE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAGjF,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,KAAK,cAAc,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,gBAAgB,MAAM,mBAAmB,CAAC"}

package/dist/runtime/InjectionQueue.d.ts

@@ -0,0 +1,46 @@
+import type { Injection, InjectionLevel } from '../types/index.js';
+export declare class InjectionQueue {
+    private injections;
+    private useCounts;
+    add(injection: Omit<Injection, 'id'>): string;
+    addBatch(injections: Omit<Injection, 'id'>[]): string[];
+    remove(id: string): boolean;
+    get(id: string): Injection | undefined;
+    getFor(level: InjectionLevel, toolName?: string): string;
+    peekFor(level: InjectionLevel, toolName?: string): Injection[];
+    clear(): void;
+    size(): number;
+    getAll(): Injection[];
+    export(): {
+        injections: Injection[];
+        useCounts: [string, number][];
+    };
+    import(data: {
+        injections: Injection[];
+        useCounts: [string, number][];
+    }): void;
+}
+export declare function createInjectionQueue(): InjectionQueue;
+export declare const commonInjections: {
+    professional: {
+        content: string;
+        priority: "high";
+        level: "system";
+    };
+    concise: {
+        content: string;
+        priority: "medium";
+        level: "system";
+    };
+    noGuessing: {
+        content: string;
+        priority: "critical";
+        level: "system";
+    };
+    confirmDestructive: {
+        content: string;
+        priority: "critical";
+        level: "system";
+    };
+};
+//# sourceMappingURL=InjectionQueue.d.ts.map

package/dist/runtime/InjectionQueue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InjectionQueue.d.ts","sourceRoot":"","sources":["../../src/runtime/InjectionQueue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAqB,MAAM,mBAAmB,CAAC;AAStF,qBAAa,cAAc;IACzB,OAAO,CAAC,UAAU,CAAgC;IAClD,OAAO,CAAC,SAAS,CAA6B;IAE9C,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,MAAM;IAO7C,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE;IAIvD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAK3B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAItC,MAAM,CAAC,KAAK,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM;IA2CxD,OAAO,CAAC,KAAK,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE;IAkB9D,KAAK,IAAI,IAAI;IAKb,IAAI,IAAI,MAAM;IAId,MAAM,IAAI,SAAS,EAAE;IAIrB,MAAM,IAAI;QAAE,UAAU,EAAE,SAAS,EAAE,CAAC;QAAC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAA;KAAE;IAOpE,MAAM,CAAC,IAAI,EAAE;QAAE,UAAU,EAAE,SAAS,EAAE,CAAC;QAAC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAA;KAAE,GAAG,IAAI;CAS/E;AAED,wBAAgB,oBAAoB,IAAI,cAAc,CAErD;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;CAwB5B,CAAC"}

package/dist/runtime/InjectionQueue.js

@@ -0,0 +1,128 @@
+const PRIORITY_ORDER = {
+    critical: 4,
+    high: 3,
+    medium: 2,
+    low: 1,
+};
+export class InjectionQueue {
+    injections = new Map();
+    useCounts = new Map();
+    add(injection) {
+        const id = crypto.randomUUID();
+        this.injections.set(id, { ...injection, id });
+        this.useCounts.set(id, 0);
+        return id;
+    }
+    addBatch(injections) {
+        return injections.map(injection => this.add(injection));
+    }
+    remove(id) {
+        this.useCounts.delete(id);
+        return this.injections.delete(id);
+    }
+    get(id) {
+        return this.injections.get(id);
+    }
+    getFor(level, toolName) {
+        const now = Date.now();
+        const applicable = [];
+        for (const [id, injection] of this.injections) {
+            if (injection.level !== level)
+                continue;
+            if (level === 'tool' && injection.toolName !== toolName)
+                continue;
+            if (injection.expiresAt && injection.expiresAt < now) {
+                this.injections.delete(id);
+                this.useCounts.delete(id);
+                continue;
+            }
+            const uses = this.useCounts.get(id) ?? 0;
+            if (injection.maxUses !== undefined && uses >= injection.maxUses) {
+                continue;
+            }
+            applicable.push(injection);
+        }
+        applicable.sort((a, b) => PRIORITY_ORDER[b.priority] - PRIORITY_ORDER[a.priority]);
+        for (const injection of applicable) {
+            const uses = (this.useCounts.get(injection.id) ?? 0) + 1;
+            this.useCounts.set(injection.id, uses);
+            if (injection.once) {
+                this.injections.delete(injection.id);
+                this.useCounts.delete(injection.id);
+            }
+        }
+        if (applicable.length === 0)
+            return '';
+        return applicable
+            .map(inj => `<system-reminder priority="${inj.priority}">\n${inj.content}\n</system-reminder>`)
+            .join('\n\n');
+    }
+    peekFor(level, toolName) {
+        const now = Date.now();
+        const applicable = [];
+        for (const injection of this.injections.values()) {
+            if (injection.level !== level)
+                continue;
+            if (level === 'tool' && injection.toolName !== toolName)
+                continue;
+            if (injection.expiresAt && injection.expiresAt < now)
+                continue;
+            const uses = this.useCounts.get(injection.id) ?? 0;
+            if (injection.maxUses !== undefined && uses >= injection.maxUses)
+                continue;
+            applicable.push(injection);
+        }
+        return applicable.sort((a, b) => PRIORITY_ORDER[b.priority] - PRIORITY_ORDER[a.priority]);
+    }
+    clear() {
+        this.injections.clear();
+        this.useCounts.clear();
+    }
+    size() {
+        return this.injections.size;
+    }
+    getAll() {
+        return Array.from(this.injections.values());
+    }
+    export() {
+        return {
+            injections: Array.from(this.injections.values()),
+            useCounts: Array.from(this.useCounts.entries()),
+        };
+    }
+    import(data) {
+        this.clear();
+        for (const injection of data.injections) {
+            this.injections.set(injection.id, injection);
+        }
+        for (const [id, count] of data.useCounts) {
+            this.useCounts.set(id, count);
+        }
+    }
+}
+export function createInjectionQueue() {
+    return new InjectionQueue();
+}
+export const commonInjections = {
+    professional: {
+        content: 'Always maintain a professional, helpful, and empathetic tone.',
+        priority: 'high',
+        level: 'system',
+    },
+    concise: {
+        content: 'Keep responses concise and focused. Avoid unnecessary verbosity.',
+        priority: 'medium',
+        level: 'system',
+    },
+    noGuessing: {
+        content: 'Never guess or make up information. If unsure, ask for clarification or use tools to verify.',
+        priority: 'critical',
+        level: 'system',
+    },
+    confirmDestructive: {
+        content: 'Always confirm with the user before performing any destructive or irreversible actions.',
+        priority: 'critical',
+        level: 'system',
+    },
+};
+//# sourceMappingURL=InjectionQueue.js.map

package/dist/runtime/InjectionQueue.js.map

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

package/dist/runtime/Runtime.d.ts

@@ -0,0 +1,24 @@
+import type { AgentConfig, HarnessConfig, HarnessStreamPart, StreamOptions, Session } from '../types/index.js';
+export declare class Runtime {
+    private config;
+    private agents;
+    private defaultAgentId;
+    private defaultModel?;
+    private maxSteps;
+    private maxHandoffs;
+    private stopConditions;
+    private sessionStore;
+    private hookRunner;
+    private enforcer;
+    constructor(config: HarnessConfig);
+    stream(options: StreamOptions): AsyncGenerator<HarnessStreamPart>;
+    chat(sessionId: string, input: string, userId?: string): AsyncGenerator<HarnessStreamPart>;
+    private runLoop;
+    private createSession;
+    getSession(id: string): Promise<Session | null>;
+    deleteSession(id: string): Promise<void>;
+    getAgent(id: string): AgentConfig | undefined;
+    getAllAgents(): AgentConfig[];
+}
+export declare function createRuntime(config: HarnessConfig): Runtime;
+//# sourceMappingURL=Runtime.d.ts.map

package/dist/runtime/Runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Runtime.d.ts","sourceRoot":"","sources":["../../src/runtime/Runtime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EACb,iBAAiB,EAGjB,aAAa,EAEb,OAAO,EACR,MAAM,mBAAmB,CAAC;AAS3B,qBAAa,OAAO;IAWN,OAAO,CAAC,MAAM;IAV1B,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,YAAY,CAAC,CAAgC;IACrD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,YAAY,CAA6C;IACjE,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,QAAQ,CAAe;gBAEX,MAAM,EAAE,aAAa;IAelC,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,cAAc,CAAC,iBAAiB,CAAC;IA8CjE,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,cAAc,CAAC,iBAAiB,CAAC;YAIlF,OAAO;IA0MtB,OAAO,CAAC,aAAa;IAwBf,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAI/C,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9C,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI7C,YAAY,IAAI,WAAW,EAAE;CAG9B;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAE5D"}

package/dist/runtime/Runtime.js

@@ -0,0 +1,277 @@
+import { streamText } from 'ai';
+import { createHandoffTool, isHandoffResult } from '../tools/handoff.js';
+import { InjectionQueue, commonInjections } from './InjectionQueue.js';
+import { checkStopConditions, defaultStopConditions } from '../guards/StopConditions.js';
+import { HookRunner } from '../hooks/HookRunner.js';
+import { ToolEnforcer } from '../guards/ToolEnforcer.js';
+import { defaultEnforcementRules } from '../guards/rules.js';
+import { MemoryStore } from '../session/stores/MemoryStore.js';
+export class Runtime {
+    config;
+    agents = new Map();
+    defaultAgentId;
+    defaultModel;
+    maxSteps;
+    maxHandoffs;
+    stopConditions;
+    sessionStore;
+    hookRunner;
+    enforcer;
+    constructor(config) {
+        this.config = config;
+        for (const agent of config.agents) {
+            this.agents.set(agent.id, agent);
+        }
+        this.defaultAgentId = config.defaultAgentId;
+        this.defaultModel = config.defaultModel;
+        this.maxSteps = config.maxSteps ?? 20;
+        this.maxHandoffs = config.maxHandoffs ?? 10;
+        this.stopConditions = config.stopConditions ?? defaultStopConditions;
+        this.sessionStore = config.sessionStore ?? new MemoryStore();
+        this.hookRunner = new HookRunner(config.hooks ?? {});
+        this.enforcer = new ToolEnforcer(config.enforcementRules ?? defaultEnforcementRules);
+    }
+    async *stream(options) {
+        let session;
+        if (options.sessionId) {
+            const existing = await this.sessionStore.get(options.sessionId);
+            session = existing ?? this.createSession(options.sessionId, options.userId);
+        }
+        else {
+            session = this.createSession(undefined, options.userId);
+        }
+        session.messages.push({ role: 'user', content: options.input });
+        const activeAgentId = session.activeAgentId ?? session.currentAgent ?? this.defaultAgentId;
+        session.activeAgentId = activeAgentId;
+        session.currentAgent = activeAgentId;
+        const context = {
+            session,
+            agentId: activeAgentId,
+            stepCount: 0,
+            totalTokens: 0,
+            handoffStack: [],
+            startTime: Date.now(),
+            consecutiveErrors: 0,
+            toolCallHistory: [],
+        };
+        const injectionQueue = new InjectionQueue();
+        injectionQueue.add(commonInjections.professional);
+        injectionQueue.add(commonInjections.noGuessing);
+        injectionQueue.add(commonInjections.confirmDestructive);
+        await this.hookRunner.onStart(context);
+        try {
+            yield* this.runLoop(context, injectionQueue);
+            await this.hookRunner.onEnd(context, { success: true });
+        }
+        catch (error) {
+            await this.hookRunner.onError(context, error);
+            await this.hookRunner.onEnd(context, { success: false, error: error });
+            yield { type: 'error', error: error.message };
+        }
+        finally {
+            await this.sessionStore.save(session);
+            yield { type: 'done', sessionId: session.id };
+        }
+    }
+    async *chat(sessionId, input, userId) {
+        yield* this.stream({ input, sessionId, userId });
+    }
+    async *runLoop(context, injectionQueue) {
+        while (context.handoffStack.length < this.maxHandoffs) {
+            if (context.handoffStack.includes(context.agentId)) {
+                yield {
+                    type: 'error',
+                    error: `Circular handoff detected: ${context.handoffStack.join(' -> ')} -> ${context.agentId}`,
+                };
+                return;
+            }
+            context.handoffStack.push(context.agentId);
+            const agent = this.agents.get(context.agentId);
+            if (!agent) {
+                yield { type: 'error', error: `Agent "${context.agentId}" not found` };
+                return;
+            }
+            yield { type: 'agent-start', agentId: agent.id };
+            await this.hookRunner.onAgentStart(context, agent.id);
+            const handoffTool = createHandoffTool(Array.from(this.agents.values()), context.agentId);
+            const tools = { ...agent.tools, handoff: handoffTool };
+            const systemInjections = injectionQueue.getFor('system');
+            const system = systemInjections
+                ? `${agent.systemPrompt}\n\n${systemInjections}`
+                : agent.systemPrompt;
+            let handoffTo = null;
+            let agentSteps = 0;
+            const agentMaxSteps = agent.maxSteps ?? agent.maxTurns ?? this.maxSteps;
+            while (agentSteps < agentMaxSteps) {
+                const stopResult = checkStopConditions(context, this.stopConditions);
+                if (stopResult.shouldStop) {
+                    yield { type: 'error', error: `Stopped: ${stopResult.reason}` };
+                    return;
+                }
+                agentSteps += 1;
+                context.stepCount += 1;
+                yield { type: 'step-start', step: context.stepCount, agentId: agent.id };
+                await this.hookRunner.onStepStart(context, context.stepCount);
+                try {
+                    const model = agent.model ?? this.defaultModel;
+                    if (!model) {
+                        throw new Error(`Agent "${agent.id}" is missing a model`);
+                    }
+                    const result = streamText({
+                        model: model,
+                        system,
+                        messages: context.session.messages,
+                        tools,
+                    });
+                    const toolCalls = [];
+                    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;
+                            const callRecord = {
+                                toolCallId: chunk.toolCallId,
+                                toolName: chunk.toolName,
+                                args,
+                                success: true,
+                                timestamp: Date.now(),
+                            };
+                            toolCalls.push(callRecord);
+                            await this.hookRunner.onToolCall(context, callRecord);
+                            yield {
+                                type: 'tool-call',
+                                toolCallId: chunk.toolCallId,
+                                toolName: chunk.toolName,
+                                args,
+                            };
+                        }
+                        if (chunk.type === 'tool-result') {
+                            const toolResult = 'result' in chunk ? chunk.result : chunk.output;
+                            const callRecord = toolCalls.find(call => call.toolCallId === chunk.toolCallId);
+                            if (callRecord) {
+                                callRecord.result = toolResult;
+                                callRecord.durationMs = Date.now() - callRecord.timestamp;
+                                context.toolCallHistory.push(callRecord);
+                                await this.hookRunner.onToolResult(context, callRecord);
+                            }
+                            yield {
+                                type: 'tool-result',
+                                toolCallId: chunk.toolCallId,
+                                toolName: chunk.toolName,
+                                result: toolResult,
+                            };
+                            if (isHandoffResult(toolResult)) {
+                                const targetAgent = toolResult.targetAgent ?? toolResult.targetAgentId;
+                                handoffTo = targetAgent;
+                            }
+                        }
+                    }
+                    const response = await result.response;
+                    context.session.messages.push(...response.messages);
+                    const usage = await result.usage;
+                    const totalTokens = usage.totalTokens ?? 0;
+                    context.totalTokens += totalTokens;
+                    if (context.session.metadata) {
+                        context.session.metadata.totalTokens += totalTokens;
+                        context.session.metadata.totalSteps += 1;
+                    }
+                    context.consecutiveErrors = 0;
+                    yield { type: 'step-end', step: context.stepCount, agentId: agent.id };
+                    await this.hookRunner.onStepEnd(context, context.stepCount, {
+                        toolCalls,
+                        finishReason: await result.finishReason,
+                        tokensUsed: totalTokens,
+                        handoffTo: handoffTo ?? undefined,
+                    });
+                    const finishReason = await result.finishReason;
+                    if (finishReason !== 'tool-calls' || handoffTo) {
+                        break;
+                    }
+                }
+                catch (error) {
+                    context.consecutiveErrors += 1;
+                    await this.hookRunner.onError(context, error);
+                    yield { type: 'error', error: error.message };
+                    if (context.consecutiveErrors >= 3) {
+                        return;
+                    }
+                }
+            }
+            yield { type: 'agent-end', agentId: agent.id };
+            await this.hookRunner.onAgentEnd(context, agent.id);
+            if (!handoffTo) {
+                break;
+            }
+            const reason = context.toolCallHistory
+                .filter(call => call.toolName === 'handoff' && isHandoffResult(call.result))
+                .pop()?.result;
+            await this.hookRunner.onHandoff(context, context.agentId, handoffTo, reason?.reason ?? 'No reason provided');
+            yield {
+                type: 'handoff',
+                from: context.agentId,
+                to: handoffTo,
+                reason: reason?.reason ?? 'No reason provided',
+            };
+            context.session.handoffHistory.push({
+                from: context.agentId,
+                to: handoffTo,
+                reason: reason?.reason ?? 'No reason provided',
+                timestamp: new Date(),
+            });
+            if (context.session.metadata) {
+                context.session.metadata.handoffHistory.push({
+                    from: context.agentId,
+                    to: handoffTo,
+                    reason: reason?.reason ?? 'No reason provided',
+                    timestamp: new Date(),
+                });
+            }
+            context.session.activeAgentId = handoffTo;
+            context.session.currentAgent = handoffTo;
+            context.agentId = handoffTo;
+        }
+        if (context.handoffStack.length >= this.maxHandoffs) {
+            yield { type: 'error', error: `Maximum handoffs (${this.maxHandoffs}) exceeded` };
+        }
+    }
+    createSession(id, userId) {
+        const now = new Date();
+        return {
+            id: id ?? crypto.randomUUID(),
+            userId,
+            messages: [],
+            createdAt: now,
+            updatedAt: now,
+            workingMemory: {},
+            currentAgent: this.defaultAgentId,
+            activeAgentId: this.defaultAgentId,
+            state: {},
+            metadata: {
+                createdAt: now,
+                lastActiveAt: now,
+                totalTokens: 0,
+                totalSteps: 0,
+                handoffHistory: [],
+            },
+            agentStates: {},
+            handoffHistory: [],
+        };
+    }
+    async getSession(id) {
+        return this.sessionStore.get(id);
+    }
+    async deleteSession(id) {
+        await this.sessionStore.delete(id);
+    }
+    getAgent(id) {
+        return this.agents.get(id);
+    }
+    getAllAgents() {
+        return Array.from(this.agents.values());
+    }
+}
+export function createRuntime(config) {
+    return new Runtime(config);
+}
+//# sourceMappingURL=Runtime.js.map

package/dist/runtime/Runtime.js.map

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

package/dist/runtime/WorkingMemory.d.ts

@@ -0,0 +1,12 @@
+import type { Session, WorkingMemory } from '../types/index.js';
+export declare class SessionWorkingMemory implements WorkingMemory {
+    private session;
+    constructor(session: Session);
+    get<T>(key: string): T | undefined;
+    set<T>(key: string, value: T): void;
+    has(key: string): boolean;
+    delete(key: string): boolean;
+    clear(): void;
+    toJSON(): Record<string, unknown>;
+}
+//# sourceMappingURL=WorkingMemory.d.ts.map

package/dist/runtime/WorkingMemory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkingMemory.d.ts","sourceRoot":"","sources":["../../src/runtime/WorkingMemory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEhE,qBAAa,oBAAqB,YAAW,aAAa;IAC5C,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,OAAO;IAEpC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAIlC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAInC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAQ5B,KAAK,IAAI,IAAI;IAIb,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAGlC"}

package/dist/runtime/WorkingMemory.js

@@ -0,0 +1,29 @@
+export class SessionWorkingMemory {
+    session;
+    constructor(session) {
+        this.session = session;
+    }
+    get(key) {
+        return this.session.workingMemory[key];
+    }
+    set(key, value) {
+        this.session.workingMemory[key] = value;
+    }
+    has(key) {
+        return Object.prototype.hasOwnProperty.call(this.session.workingMemory, key);
+    }
+    delete(key) {
+        if (this.has(key)) {
+            delete this.session.workingMemory[key];
+            return true;
+        }
+        return false;
+    }
+    clear() {
+        this.session.workingMemory = {};
+    }
+    toJSON() {
+        return { ...this.session.workingMemory };
+    }
+}
+//# sourceMappingURL=WorkingMemory.js.map

package/dist/runtime/WorkingMemory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkingMemory.js","sourceRoot":"","sources":["../../src/runtime/WorkingMemory.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,oBAAoB;IACX;IAApB,YAAoB,OAAgB;QAAhB,YAAO,GAAP,OAAO,CAAS;IAAG,CAAC;IAExC,GAAG,CAAI,GAAW;QAChB,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,GAAG,CAAkB,CAAC;IAC1D,CAAC;IAED,GAAG,CAAI,GAAW,EAAE,KAAQ;QAC1B,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,KAAgB,CAAC;IACrD,CAAC;IAED,GAAG,CAAC,GAAW;QACb,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;IAC/E,CAAC;IAED,MAAM,CAAC,GAAW;QAChB,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;YACvC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,aAAa,GAAG,EAAE,CAAC;IAClC,CAAC;IAED,MAAM;QACJ,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;IAC3C,CAAC;CACF"}

package/dist/runtime/index.d.ts

@@ -0,0 +1,4 @@
+export { Runtime, createRuntime } from './Runtime.js';
+export { InjectionQueue, createInjectionQueue, commonInjections } from './InjectionQueue.js';
+export { SessionWorkingMemory } from './WorkingMemory.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC7F,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/runtime/index.js

@@ -0,0 +1,4 @@
+export { Runtime, createRuntime } from './Runtime.js';
+export { InjectionQueue, createInjectionQueue, commonInjections } from './InjectionQueue.js';
+export { SessionWorkingMemory } from './WorkingMemory.js';
+//# sourceMappingURL=index.js.map

package/dist/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC7F,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/session/SessionManager.d.ts

@@ -0,0 +1,20 @@
+import type { Session } from '../types/index.js';
+import type { SessionStore } from './SessionStore.js';
+export declare class SessionManager {
+    private store;
+    private defaultAgentId;
+    constructor(store: SessionStore, defaultAgentId: string);
+    create(userId?: string, sessionId?: string): Promise<Session>;
+    getOrCreate(sessionId?: string, userId?: string): Promise<Session>;
+    get(sessionId: string): Promise<Session | null>;
+    save(session: Session): Promise<void>;
+    delete(sessionId: string): Promise<void>;
+    listForUser(userId: string): Promise<Session[]>;
+    recordHandoff(sessionId: string, fromAgentId: string, toAgentId: string, reason: string): Promise<void>;
+    updateStats(sessionId: string, tokensUsed: number, stepsCompleted: number): Promise<void>;
+    setState(sessionId: string, key: string, value: unknown): Promise<void>;
+    getState<T>(sessionId: string, key: string): Promise<T | undefined>;
+    cleanup(maxAgeMs: number): Promise<number>;
+    updateAgentState(sessionId: string, agentId: string, state: Record<string, unknown>): Promise<void>;
+}
+//# sourceMappingURL=SessionManager.d.ts.map

package/dist/session/SessionManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionManager.d.ts","sourceRoot":"","sources":["../../src/session/SessionManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,qBAAa,cAAc;IAEvB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,cAAc;gBADd,KAAK,EAAE,YAAY,EACnB,cAAc,EAAE,MAAM;IAG1B,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA2B7D,WAAW,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAYlE,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAI/C,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAQrC,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAI/C,aAAa,CACjB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;IA0BV,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBzF,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAcvE,QAAQ,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAKnE,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAO1C,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAc1G"}