@loom-node/core 0.1.0

package/dist/agent/strategies/tool-use.d.ts

@@ -0,0 +1,7 @@
+import type { AgentEvent } from '../../types/events.js';
+import type { LoopStrategy, LoopContext } from '../../types/strategy.js';
+export declare class ToolUseStrategy implements LoopStrategy {
+    readonly name = "tool-use";
+    execute(ctx: LoopContext): AsyncGenerator<AgentEvent>;
+}
+//# sourceMappingURL=tool-use.d.ts.map

package/dist/agent/strategies/tool-use.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-use.d.ts","sourceRoot":"","sources":["../../../src/agent/strategies/tool-use.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAc,MAAM,uBAAuB,CAAC;AAEpE,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAIzE,qBAAa,eAAgB,YAAW,YAAY;IAClD,QAAQ,CAAC,IAAI,cAAc;IAEpB,OAAO,CAAC,GAAG,EAAE,WAAW,GAAG,cAAc,CAAC,UAAU,CAAC;CAwF7D"}

package/dist/agent/strategies/tool-use.js

@@ -0,0 +1,100 @@
+import { AgentAbortError, AgentMaxStepsError } from '../../errors/agent.js';
+import { streamToCompletion } from './stream-helper.js';
+export class ToolUseStrategy {
+    name = 'tool-use';
+    async *execute(ctx) {
+        const { provider, tools, maxSteps, signal, messages } = ctx;
+        const totalUsage = { promptTokens: 0, completionTokens: 0, totalTokens: 0 };
+        const startTime = Date.now();
+        let accumulatedContent = '';
+        const jsonTools = tools.map(t => ({
+            name: t.name, description: t.description, parameters: t.parameters.toJsonSchema(),
+        }));
+        for (let step = 0; step < maxSteps; step++) {
+            if (signal?.aborted) {
+                yield { type: 'error', error: new AgentAbortError(), recoverable: false };
+                return;
+            }
+            yield { type: 'step-start', step, totalSteps: maxSteps };
+            if (ctx.interceptors) {
+                await ctx.interceptors.run({ messages, metadata: { step, strategy: 'tool-use' } });
+            }
+            let result;
+            try {
+                if (ctx.streaming) {
+                    const sr = await streamToCompletion(provider, { messages, tools: jsonTools }, signal);
+                    result = sr.result;
+                    for (const ev of sr.events)
+                        yield ev;
+                }
+                else {
+                    result = await provider.complete({ messages, tools: jsonTools });
+                }
+            }
+            catch (err) {
+                yield { type: 'error', error: err instanceof Error ? err : new Error(String(err)), recoverable: false };
+                return;
+            }
+            accumulateUsage(totalUsage, result.usage);
+            if (result.content) {
+                accumulatedContent += result.content;
+                if (!ctx.streaming)
+                    yield { type: 'text-delta', content: result.content };
+            }
+            if (result.finishReason === 'stop' || !result.toolCalls?.length) {
+                yield { type: 'step-end', step, reason: 'complete' };
+                yield { type: 'done', content: accumulatedContent, usage: totalUsage, steps: step + 1, durationMs: Date.now() - startTime };
+                return;
+            }
+            messages.push({ role: 'assistant', content: result.content, toolCalls: result.toolCalls });
+            const toolMap = new Map(tools.map(t => [t.name, t]));
+            for (const call of result.toolCalls) {
+                const tool = toolMap.get(call.name);
+                const start = Date.now();
+                let parsed;
+                try {
+                    parsed = JSON.parse(call.arguments);
+                }
+                catch {
+                    parsed = {};
+                }
+                yield { type: 'tool-call-start', toolCallId: call.id, toolName: call.name, input: parsed };
+                if (!tool) {
+                    messages.push({ role: 'tool', toolCallId: call.id, content: `Error: Unknown tool: ${call.name}` });
+                    yield { type: 'tool-call-end', toolCallId: call.id, toolName: call.name, result: null, durationMs: 0, tokenCost: 0 };
+                    continue;
+                }
+                try {
+                    const validInput = tool.parameters.parse(parsed);
+                    const timeoutMs = ctx.toolConfig?.timeoutMs ?? 30_000;
+                    const output = await withTimeout(tool.execute(validInput, { signal, sessionId: ctx.sessionId, tenantId: ctx.tenantId }), timeoutMs);
+                    const dur = Date.now() - start;
+                    const text = typeof output === 'string' ? output : JSON.stringify(output);
+                    messages.push({ role: 'tool', toolCallId: call.id, content: text });
+                    yield { type: 'tool-call-end', toolCallId: call.id, toolName: call.name, result: output, durationMs: dur, tokenCost: 0 };
+                }
+                catch (err) {
+                    const dur = Date.now() - start;
+                    const msg = err instanceof Error ? err.message : String(err);
+                    messages.push({ role: 'tool', toolCallId: call.id, content: `Error: ${msg}` });
+                    yield { type: 'tool-call-end', toolCallId: call.id, toolName: call.name, result: null, durationMs: dur, tokenCost: 0 };
+                }
+            }
+            yield { type: 'step-end', step, reason: 'tool-use' };
+        }
+        yield { type: 'error', error: new AgentMaxStepsError(maxSteps, accumulatedContent), recoverable: false };
+        yield { type: 'done', content: accumulatedContent, usage: totalUsage, steps: maxSteps, durationMs: Date.now() - startTime };
+    }
+}
+function withTimeout(promise, ms) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => reject(new Error(`Tool timed out after ${ms}ms`)), ms);
+        promise.then(resolve, reject).finally(() => clearTimeout(timer));
+    });
+}
+function accumulateUsage(total, delta) {
+    total.promptTokens += delta.promptTokens;
+    total.completionTokens += delta.completionTokens;
+    total.totalTokens += delta.totalTokens;
+}
+//# sourceMappingURL=tool-use.js.map

package/dist/agent/strategies/tool-use.js.map

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

package/dist/context/context-orchestrator.d.ts

@@ -0,0 +1,25 @@
+import type { ContextProvider, ContextFragment, ContextOrchestrator as IContextOrchestrator, BudgetRatios, TokenBudget } from '../types/context.js';
+import type { Tokenizer } from '../types/memory.js';
+export interface BudgetConfig {
+    contextWindow: number;
+    outputReserveRatio?: number;
+    /** Optional initial ratios — if omitted, adapts from equal start */
+    ratios?: BudgetRatios;
+    tokenizer?: Tokenizer;
+    /** EMA smoothing factor for adaptive ratios (0-1, default 0.3) */
+    adaptiveAlpha?: number;
+}
+export declare class ContextOrchestratorImpl implements IContextOrchestrator {
+    private providers;
+    private budgetConfig?;
+    /** Adaptive scores per source — updated after each gather() */
+    private sourceScores;
+    constructor(budgetConfig?: BudgetConfig);
+    register(provider: ContextProvider): void;
+    /** Current adaptive ratios (read-only snapshot) */
+    get ratios(): Record<string, number>;
+    computeBudget(systemPrompt?: string): TokenBudget;
+    gather(query: string, totalBudget: number): Promise<ContextFragment[]>;
+    private updateScores;
+}
+//# sourceMappingURL=context-orchestrator.d.ts.map

package/dist/context/context-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-orchestrator.d.ts","sourceRoot":"","sources":["../../src/context/context-orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EAAE,eAAe,EAChC,mBAAmB,IAAI,oBAAoB,EAC5B,YAAY,EAAE,WAAW,EACzC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oEAAoE;IACpE,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,kEAAkE;IAClE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,uBAAwB,YAAW,oBAAoB;IAClE,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,YAAY,CAAC,CAAe;IACpC,+DAA+D;IAC/D,OAAO,CAAC,YAAY,CAAoC;gBAE5C,YAAY,CAAC,EAAE,YAAY;IAIvC,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAQzC,mDAAmD;IACnD,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAKnC;IAED,aAAa,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,WAAW;IAgB3C,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IA+B5E,OAAO,CAAC,YAAY;CAiBrB"}

package/dist/context/context-orchestrator.js

@@ -0,0 +1,82 @@
+export class ContextOrchestratorImpl {
+    providers = [];
+    budgetConfig;
+    /** Adaptive scores per source — updated after each gather() */
+    sourceScores = new Map();
+    constructor(budgetConfig) {
+        this.budgetConfig = budgetConfig;
+    }
+    register(provider) {
+        this.providers.push(provider);
+        if (!this.sourceScores.has(provider.source)) {
+            const initial = this.budgetConfig?.ratios?.[provider.source] ?? 1;
+            this.sourceScores.set(provider.source, initial);
+        }
+    }
+    /** Current adaptive ratios (read-only snapshot) */
+    get ratios() {
+        const total = [...this.sourceScores.values()].reduce((s, v) => s + v, 0) || 1;
+        const out = {};
+        for (const [k, v] of this.sourceScores)
+            out[k] = v / total;
+        return out;
+    }
+    computeBudget(systemPrompt) {
+        const cfg = this.budgetConfig;
+        if (!cfg) {
+            return { total: 0, reservedOutput: 0, systemPromptTokens: 0, available: Infinity };
+        }
+        const reservedOutput = Math.floor(cfg.contextWindow * (cfg.outputReserveRatio ?? 0.25));
+        const sysTokens = systemPrompt && cfg.tokenizer
+            ? cfg.tokenizer.count(systemPrompt) : 0;
+        return {
+            total: cfg.contextWindow,
+            reservedOutput,
+            systemPromptTokens: sysTokens,
+            available: Math.max(0, cfg.contextWindow - reservedOutput - sysTokens),
+        };
+    }
+    async gather(query, totalBudget) {
+        if (this.providers.length === 0)
+            return [];
+        // Compute current ratios from adaptive scores
+        const scoreTotal = [...this.sourceScores.values()].reduce((s, v) => s + v, 0) || 1;
+        // Allocate budget proportionally
+        const results = await Promise.all(this.providers.map(p => {
+            const score = this.sourceScores.get(p.source) ?? 1;
+            const budget = Math.floor(totalBudget * (score / scoreTotal));
+            return p.provide(query, budget).catch(() => []);
+        }));
+        // Merge, sort by relevance, fit within budget
+        const all = results.flat().sort((a, b) => b.relevance - a.relevance);
+        const selected = [];
+        let used = 0;
+        for (const f of all) {
+            if (used + f.tokens > totalBudget)
+                continue;
+            selected.push(f);
+            used += f.tokens;
+        }
+        // Update adaptive scores based on what was actually selected
+        this.updateScores(selected);
+        return selected;
+    }
+    updateScores(selected) {
+        const alpha = this.budgetConfig?.adaptiveAlpha ?? 0.3;
+        // Compute average relevance per source from selected fragments
+        const bySource = new Map();
+        for (const f of selected) {
+            const acc = bySource.get(f.source) ?? { sum: 0, count: 0 };
+            acc.sum += f.relevance;
+            acc.count++;
+            bySource.set(f.source, acc);
+        }
+        // EMA update: score = (1-α)*old + α*avgRelevance
+        for (const [source, old] of this.sourceScores) {
+            const acc = bySource.get(source);
+            const avgRel = acc ? acc.sum / acc.count : 0;
+            this.sourceScores.set(source, (1 - alpha) * old + alpha * avgRel);
+        }
+    }
+}
+//# sourceMappingURL=context-orchestrator.js.map

package/dist/context/context-orchestrator.js.map

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

package/dist/errors/agent.d.ts

@@ -0,0 +1,10 @@
+import { LoomError } from './llm.js';
+export declare class AgentAbortError extends LoomError {
+    constructor();
+}
+export declare class AgentMaxStepsError extends LoomError {
+    readonly steps: number;
+    readonly partialContent: string;
+    constructor(steps: number, partialContent: string);
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/errors/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/errors/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC,qBAAa,eAAgB,SAAQ,SAAS;;CAK7C;AAED,qBAAa,kBAAmB,SAAQ,SAAS;IAC/C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;gBACpB,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM;CAMlD"}

package/dist/errors/agent.js

@@ -0,0 +1,18 @@
+import { LoomError } from './llm.js';
+export class AgentAbortError extends LoomError {
+    constructor() {
+        super('AGENT_ABORT', 'Agent execution was aborted');
+        this.name = 'AgentAbortError';
+    }
+}
+export class AgentMaxStepsError extends LoomError {
+    steps;
+    partialContent;
+    constructor(steps, partialContent) {
+        super('AGENT_MAX_STEPS', `Agent reached max steps (${steps})`);
+        this.name = 'AgentMaxStepsError';
+        this.steps = steps;
+        this.partialContent = partialContent;
+    }
+}
+//# sourceMappingURL=agent.js.map

package/dist/errors/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/errors/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC,MAAM,OAAO,eAAgB,SAAQ,SAAS;IAC5C;QACE,KAAK,CAAC,aAAa,EAAE,6BAA6B,CAAC,CAAC;QACpD,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,SAAS;IACtC,KAAK,CAAS;IACd,cAAc,CAAS;IAChC,YAAY,KAAa,EAAE,cAAsB;QAC/C,KAAK,CAAC,iBAAiB,EAAE,4BAA4B,KAAK,GAAG,CAAC,CAAC;QAC/D,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;IACvC,CAAC;CACF"}

package/dist/errors/index.d.ts

@@ -0,0 +1,4 @@
+export { LoomError, LLMError, LLMRateLimitError, LLMAuthError, LLMStreamInterruptedError } from './llm.js';
+export { ToolError, ToolTimeoutError, ToolResultTooLargeError } from './tool.js';
+export { AgentAbortError, AgentMaxStepsError } from './agent.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,iBAAiB,EAAE,YAAY,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAC3G,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}

package/dist/errors/index.js

@@ -0,0 +1,4 @@
+export { LoomError, LLMError, LLMRateLimitError, LLMAuthError, LLMStreamInterruptedError } from './llm.js';
+export { ToolError, ToolTimeoutError, ToolResultTooLargeError } from './tool.js';
+export { AgentAbortError, AgentMaxStepsError } from './agent.js';
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,iBAAiB,EAAE,YAAY,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAC3G,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}

package/dist/errors/llm.d.ts

@@ -0,0 +1,23 @@
+export declare class LoomError extends Error {
+    readonly code: string;
+    readonly cause?: Error;
+    constructor(code: string, message: string, cause?: Error);
+    static from(err: unknown): LoomError;
+}
+export declare class LLMError extends LoomError {
+    readonly provider: string;
+    readonly statusCode?: number;
+    constructor(code: string, provider: string, message: string, statusCode?: number, cause?: Error);
+}
+export declare class LLMRateLimitError extends LLMError {
+    readonly retryAfterMs?: number;
+    constructor(provider: string, retryAfterMs?: number);
+}
+export declare class LLMAuthError extends LLMError {
+    constructor(provider: string);
+}
+export declare class LLMStreamInterruptedError extends LLMError {
+    readonly partialContent: string;
+    constructor(provider: string, partialContent: string, cause?: Error);
+}
+//# sourceMappingURL=llm.d.ts.map

package/dist/errors/llm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../../src/errors/llm.ts"],"names":[],"mappings":"AACA,qBAAa,SAAU,SAAQ,KAAK;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,SAAkB,KAAK,CAAC,EAAE,KAAK,CAAC;gBAEpB,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;IAOxD,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS;CAKrC;AAGD,qBAAa,QAAS,SAAQ,SAAS;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;gBACjB,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAMhG;AAED,qBAAa,iBAAkB,SAAQ,QAAQ;IAC7C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;gBACnB,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;CAIpD;AAED,qBAAa,YAAa,SAAQ,QAAQ;gBAC5B,QAAQ,EAAE,MAAM;CAG7B;AAED,qBAAa,yBAA0B,SAAQ,QAAQ;IACrD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;gBACpB,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAIpE"}

package/dist/errors/llm.js

@@ -0,0 +1,48 @@
+// ===== Error Base =====
+export class LoomError extends Error {
+    code;
+    cause;
+    constructor(code, message, cause) {
+        super(message);
+        this.name = 'LoomError';
+        this.code = code;
+        this.cause = cause;
+    }
+    static from(err) {
+        if (err instanceof LoomError)
+            return err;
+        const e = err instanceof Error ? err : new Error(String(err));
+        return new LoomError('UNKNOWN', e.message, e);
+    }
+}
+// ===== LLM Errors =====
+export class LLMError extends LoomError {
+    provider;
+    statusCode;
+    constructor(code, provider, message, statusCode, cause) {
+        super(code, message, cause);
+        this.name = 'LLMError';
+        this.provider = provider;
+        this.statusCode = statusCode;
+    }
+}
+export class LLMRateLimitError extends LLMError {
+    retryAfterMs;
+    constructor(provider, retryAfterMs) {
+        super('LLM_RATE_LIMIT', provider, `Rate limited by ${provider}`, 429);
+        this.retryAfterMs = retryAfterMs;
+    }
+}
+export class LLMAuthError extends LLMError {
+    constructor(provider) {
+        super('LLM_AUTH_ERROR', provider, `Authentication failed for ${provider}`, 401);
+    }
+}
+export class LLMStreamInterruptedError extends LLMError {
+    partialContent;
+    constructor(provider, partialContent, cause) {
+        super('LLM_STREAM_INTERRUPTED', provider, `Stream interrupted from ${provider}`, undefined, cause);
+        this.partialContent = partialContent;
+    }
+}
+//# sourceMappingURL=llm.js.map

package/dist/errors/llm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.js","sourceRoot":"","sources":["../../src/errors/llm.ts"],"names":[],"mappings":"AAAA,yBAAyB;AACzB,MAAM,OAAO,SAAU,SAAQ,KAAK;IACzB,IAAI,CAAS;IACJ,KAAK,CAAS;IAEhC,YAAY,IAAY,EAAE,OAAe,EAAE,KAAa;QACtD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,GAAY;QACtB,IAAI,GAAG,YAAY,SAAS;YAAE,OAAO,GAAG,CAAC;QACzC,MAAM,CAAC,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9D,OAAO,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAChD,CAAC;CACF;AAED,yBAAyB;AACzB,MAAM,OAAO,QAAS,SAAQ,SAAS;IAC5B,QAAQ,CAAS;IACjB,UAAU,CAAU;IAC7B,YAAY,IAAY,EAAE,QAAgB,EAAE,OAAe,EAAE,UAAmB,EAAE,KAAa;QAC7F,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,QAAQ;IACpC,YAAY,CAAU;IAC/B,YAAY,QAAgB,EAAE,YAAqB;QACjD,KAAK,CAAC,gBAAgB,EAAE,QAAQ,EAAE,mBAAmB,QAAQ,EAAE,EAAE,GAAG,CAAC,CAAC;QACtE,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,YAAa,SAAQ,QAAQ;IACxC,YAAY,QAAgB;QAC1B,KAAK,CAAC,gBAAgB,EAAE,QAAQ,EAAE,6BAA6B,QAAQ,EAAE,EAAE,GAAG,CAAC,CAAC;IAClF,CAAC;CACF;AAED,MAAM,OAAO,yBAA0B,SAAQ,QAAQ;IAC5C,cAAc,CAAS;IAChC,YAAY,QAAgB,EAAE,cAAsB,EAAE,KAAa;QACjE,KAAK,CAAC,wBAAwB,EAAE,QAAQ,EAAE,2BAA2B,QAAQ,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QACnG,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;IACvC,CAAC;CACF"}

package/dist/errors/tool.d.ts

@@ -0,0 +1,15 @@
+import { LoomError } from './llm.js';
+export declare class ToolError extends LoomError {
+    readonly toolName: string;
+    constructor(code: string, toolName: string, message: string, cause?: Error);
+}
+export declare class ToolTimeoutError extends ToolError {
+    readonly timeoutMs: number;
+    constructor(toolName: string, timeoutMs: number);
+}
+export declare class ToolResultTooLargeError extends ToolError {
+    readonly sizeBytes: number;
+    readonly limitBytes: number;
+    constructor(toolName: string, sizeBytes: number, limitBytes: number);
+}
+//# sourceMappingURL=tool.d.ts.map

package/dist/errors/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/errors/tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAGrC,qBAAa,SAAU,SAAQ,SAAS;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBACd,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAK3E;AAED,qBAAa,gBAAiB,SAAQ,SAAS;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBACf,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAIhD;AAED,qBAAa,uBAAwB,SAAQ,SAAS;IACpD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAChB,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAKpE"}

package/dist/errors/tool.js

@@ -0,0 +1,27 @@
+import { LoomError } from './llm.js';
+// ===== Tool Errors =====
+export class ToolError extends LoomError {
+    toolName;
+    constructor(code, toolName, message, cause) {
+        super(code, message, cause);
+        this.name = 'ToolError';
+        this.toolName = toolName;
+    }
+}
+export class ToolTimeoutError extends ToolError {
+    timeoutMs;
+    constructor(toolName, timeoutMs) {
+        super('TOOL_TIMEOUT', toolName, `Tool "${toolName}" timed out after ${timeoutMs}ms`);
+        this.timeoutMs = timeoutMs;
+    }
+}
+export class ToolResultTooLargeError extends ToolError {
+    sizeBytes;
+    limitBytes;
+    constructor(toolName, sizeBytes, limitBytes) {
+        super('TOOL_RESULT_TOO_LARGE', toolName, `Tool "${toolName}" result ${sizeBytes}B exceeds limit ${limitBytes}B`);
+        this.sizeBytes = sizeBytes;
+        this.limitBytes = limitBytes;
+    }
+}
+//# sourceMappingURL=tool.js.map

package/dist/errors/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/errors/tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC,0BAA0B;AAC1B,MAAM,OAAO,SAAU,SAAQ,SAAS;IAC7B,QAAQ,CAAS;IAC1B,YAAY,IAAY,EAAE,QAAgB,EAAE,OAAe,EAAE,KAAa;QACxE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,SAAS;IACpC,SAAS,CAAS;IAC3B,YAAY,QAAgB,EAAE,SAAiB;QAC7C,KAAK,CAAC,cAAc,EAAE,QAAQ,EAAE,SAAS,QAAQ,qBAAqB,SAAS,IAAI,CAAC,CAAC;QACrF,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,SAAS;IAC3C,SAAS,CAAS;IAClB,UAAU,CAAS;IAC5B,YAAY,QAAgB,EAAE,SAAiB,EAAE,UAAkB;QACjE,KAAK,CAAC,uBAAuB,EAAE,QAAQ,EAAE,SAAS,QAAQ,YAAY,SAAS,mBAAmB,UAAU,GAAG,CAAC,CAAC;QACjH,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF"}

package/dist/events/event-bus.d.ts

@@ -0,0 +1,89 @@
+type Handler<T = unknown> = (data: T) => void;
+export interface AgentEventMap {
+    'agent:start': {
+        taskId: string;
+        input: string;
+    };
+    'agent:done': {
+        taskId: string;
+        output: string;
+    };
+    'tool:call': {
+        name: string;
+        input: unknown;
+    };
+    'tool:result': {
+        name: string;
+        output: unknown;
+        durationMs: number;
+    };
+    'tool:executed': {
+        step: number;
+        results: unknown[];
+    };
+    'memory:store': {
+        layer: string;
+        tokens: number;
+    };
+    'llm:request': {
+        model: string;
+        tokens: number;
+    };
+    'llm:response': {
+        model: string;
+        tokens: number;
+        durationMs: number;
+    };
+    'error': {
+        source: string;
+        error: Error;
+    };
+    'node:mitosis': {
+        parentId: string;
+        childId: string;
+        domain: string;
+    };
+    'node:apoptosis': {
+        nodeId: string;
+        mergedInto?: string;
+    };
+    'node:reward': {
+        nodeId: string;
+        domain: string;
+        score: number;
+    };
+    'loop:sense': {
+        taskId: string;
+        complexity: number;
+        domains: string[];
+        method: string;
+    };
+    'loop:match': {
+        taskId: string;
+        winnerId: string;
+        tier: 1 | 2 | 3;
+    };
+    'loop:adapt': {
+        taskId: string;
+        reward: number;
+        evolved: boolean;
+        recycled: boolean;
+    };
+}
+export declare class TypedEventBus {
+    private handlers;
+    readonly nodeId: string | undefined;
+    private parent;
+    constructor(opts?: {
+        nodeId?: string;
+        parent?: TypedEventBus;
+    });
+    createChildBus(nodeId: string): TypedEventBus;
+    on<K extends keyof AgentEventMap>(event: K, handler: Handler<AgentEventMap[K]>): () => void;
+    /** Subscribe to all events matching a prefix pattern, e.g. 'tool:*' */
+    onPattern(pattern: string, handler: Handler<unknown>): () => void;
+    off<K extends keyof AgentEventMap>(event: K, handler: Handler<AgentEventMap[K]>): void;
+    emit<K extends keyof AgentEventMap>(event: K, data: AgentEventMap[K]): void;
+}
+export {};
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/events/event-bus.d.ts.map

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

package/dist/events/event-bus.js

@@ -0,0 +1,63 @@
+export class TypedEventBus {
+    handlers = new Map();
+    nodeId;
+    parent;
+    constructor(opts) {
+        this.nodeId = opts?.nodeId;
+        this.parent = opts?.parent;
+    }
+    createChildBus(nodeId) {
+        return new TypedEventBus({ nodeId, parent: this });
+    }
+    on(event, handler) {
+        if (!this.handlers.has(event)) {
+            this.handlers.set(event, new Set());
+        }
+        this.handlers.get(event).add(handler);
+        return () => this.off(event, handler);
+    }
+    /** Subscribe to all events matching a prefix pattern, e.g. 'tool:*' */
+    onPattern(pattern, handler) {
+        if (!this.handlers.has(pattern)) {
+            this.handlers.set(pattern, new Set());
+        }
+        this.handlers.get(pattern).add(handler);
+        return () => { this.handlers.get(pattern)?.delete(handler); };
+    }
+    off(event, handler) {
+        this.handlers.get(event)?.delete(handler);
+    }
+    emit(event, data) {
+        // Exact match handlers
+        this.handlers.get(event)?.forEach(h => {
+            try {
+                h(data);
+            }
+            catch { /* swallow */ }
+        });
+        // Pattern match: 'tool:*' matches 'tool:call', 'tool:result', etc.
+        for (const [pat, hs] of this.handlers) {
+            if (!pat.endsWith(':*'))
+                continue;
+            const prefix = pat.slice(0, -1); // 'tool:*' → 'tool:'
+            if (event.startsWith(prefix)) {
+                hs.forEach(h => { try {
+                    h(data);
+                }
+                catch { /* swallow */ } });
+            }
+        }
+        // Wildcard '*' handlers
+        this.handlers.get('*')?.forEach(h => {
+            try {
+                h(data);
+            }
+            catch { /* swallow */ }
+        });
+        // Propagate to parent
+        if (this.parent) {
+            this.parent.emit(event, data);
+        }
+    }
+}
+//# sourceMappingURL=event-bus.js.map

package/dist/events/event-bus.js.map

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

package/dist/events/index.d.ts

@@ -0,0 +1,3 @@
+export { TypedEventBus } from './event-bus.js';
+export type { AgentEventMap } from './event-bus.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/events/index.js

@@ -0,0 +1,2 @@
+export { TypedEventBus } from './event-bus.js';
+//# sourceMappingURL=index.js.map

package/dist/events/index.js.map

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