@tashiscool/agents 0.1.0

package/dist/executor.js

@@ -0,0 +1,362 @@
+/**
+ * Batch Executor
+ * Execute multiple tool calls with routing, concurrency control, and error handling
+ */
+/**
+ * Simple tool router implementation
+ */
+export class SimpleToolRouter {
+    tools = new Map();
+    aliases = new Map();
+    /**
+     * Register a tool
+     */
+    register(tool) {
+        this.tools.set(tool.name, tool);
+    }
+    /**
+     * Register multiple tools
+     */
+    registerAll(tools) {
+        for (const tool of tools) {
+            this.register(tool);
+        }
+    }
+    /**
+     * Add an alias for a tool
+     */
+    addAlias(alias, toolName) {
+        this.aliases.set(alias, toolName);
+    }
+    route(call) {
+        // Check direct match
+        if (this.tools.has(call.name)) {
+            return this.tools.get(call.name);
+        }
+        // Check aliases
+        const aliasedName = this.aliases.get(call.name);
+        if (aliasedName && this.tools.has(aliasedName)) {
+            return this.tools.get(aliasedName);
+        }
+        return undefined;
+    }
+    hasRoute(toolName) {
+        return this.tools.has(toolName) || this.aliases.has(toolName);
+    }
+    listRoutes() {
+        return [...this.tools.keys(), ...this.aliases.keys()];
+    }
+}
+/**
+ * Result cache
+ */
+class ResultCache {
+    cache = new Map();
+    ttlMs;
+    constructor(ttlMs = 60000) {
+        this.ttlMs = ttlMs;
+    }
+    getKey(call) {
+        return `${call.name}:${JSON.stringify(call.arguments)}`;
+    }
+    get(call) {
+        const key = this.getKey(call);
+        const entry = this.cache.get(key);
+        if (!entry)
+            return undefined;
+        if (Date.now() > entry.expiresAt) {
+            this.cache.delete(key);
+            return undefined;
+        }
+        return { ...entry.result, cached: true };
+    }
+    set(call, result) {
+        const key = this.getKey(call);
+        this.cache.set(key, {
+            result,
+            expiresAt: Date.now() + this.ttlMs,
+        });
+    }
+    clear() {
+        this.cache.clear();
+    }
+    cleanup() {
+        const now = Date.now();
+        let cleaned = 0;
+        for (const [key, entry] of this.cache.entries()) {
+            if (now > entry.expiresAt) {
+                this.cache.delete(key);
+                cleaned++;
+            }
+        }
+        return cleaned;
+    }
+}
+/**
+ * Execute a single tool call with timeout
+ */
+async function executeWithTimeout(fn, timeoutMs) {
+    return Promise.race([
+        fn(),
+        new Promise((_, reject) => setTimeout(() => reject(new Error('Tool execution timeout')), timeoutMs)),
+    ]);
+}
+/**
+ * Batch executor for tool calls
+ */
+export class BatchExecutor {
+    router;
+    options;
+    cache;
+    constructor(router, options = {}) {
+        this.router = router;
+        this.options = {
+            maxConcurrency: options.maxConcurrency ?? 5,
+            defaultTimeoutMs: options.defaultTimeoutMs ?? 30000,
+            defaultRetries: options.defaultRetries ?? 0,
+            strategy: options.strategy ?? 'parallel',
+            stopOnError: options.stopOnError ?? false,
+            enableCache: options.enableCache ?? false,
+            cacheTtlMs: options.cacheTtlMs ?? 60000,
+        };
+        if (this.options.enableCache) {
+            this.cache = new ResultCache(this.options.cacheTtlMs);
+        }
+    }
+    /**
+     * Execute a single tool call
+     */
+    async executeOne(call) {
+        const startTime = Date.now();
+        const timeoutMs = call.timeoutMs ?? this.options.defaultTimeoutMs;
+        const maxRetries = call.retries ?? this.options.defaultRetries;
+        // Check cache
+        if (this.cache) {
+            const cached = this.cache.get(call);
+            if (cached)
+                return cached;
+        }
+        // Find tool
+        const tool = this.router.route(call);
+        if (!tool) {
+            return {
+                toolCallId: call.id,
+                name: call.name,
+                result: null,
+                error: `No route found for tool: ${call.name}`,
+                durationMs: Date.now() - startTime,
+                retriesAttempted: 0,
+                cached: false,
+            };
+        }
+        // Execute with retries
+        let lastError;
+        for (let attempt = 0; attempt <= maxRetries; attempt++) {
+            try {
+                // Validate parameters
+                const params = tool.parameters.parse(call.arguments);
+                // Execute with timeout
+                const result = await executeWithTimeout(() => tool.execute(params), timeoutMs);
+                const enhancedResult = {
+                    toolCallId: call.id,
+                    name: call.name,
+                    result,
+                    durationMs: Date.now() - startTime,
+                    retriesAttempted: attempt,
+                    cached: false,
+                };
+                // Cache result
+                if (this.cache) {
+                    this.cache.set(call, enhancedResult);
+                }
+                return enhancedResult;
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error.message : String(error);
+                // Continue to retry unless it's the last attempt
+            }
+        }
+        return {
+            toolCallId: call.id,
+            name: call.name,
+            result: null,
+            error: lastError,
+            durationMs: Date.now() - startTime,
+            retriesAttempted: maxRetries,
+            cached: false,
+        };
+    }
+    /**
+     * Execute multiple tool calls
+     */
+    async execute(calls, onProgress) {
+        if (calls.length === 0)
+            return [];
+        // Sort by priority
+        const sorted = [...calls].sort((a, b) => {
+            const priorityOrder = { high: 0, normal: 1, low: 2 };
+            const aPriority = priorityOrder[a.priority ?? 'normal'];
+            const bPriority = priorityOrder[b.priority ?? 'normal'];
+            return aPriority - bPriority;
+        });
+        switch (this.options.strategy) {
+            case 'sequential':
+                return this.executeSequential(sorted, onProgress);
+            case 'parallel':
+                return this.executeParallel(sorted, onProgress);
+            case 'adaptive':
+                return this.executeAdaptive(sorted, onProgress);
+        }
+    }
+    /**
+     * Execute sequentially
+     */
+    async executeSequential(calls, onProgress) {
+        const results = [];
+        for (let i = 0; i < calls.length; i++) {
+            const call = calls[i];
+            onProgress?.({ completed: i, total: calls.length, current: call });
+            const result = await this.executeOne(call);
+            results.push(result);
+            onProgress?.({
+                completed: i + 1,
+                total: calls.length,
+                current: call,
+                result,
+            });
+            if (this.options.stopOnError && result.error) {
+                break;
+            }
+        }
+        return results;
+    }
+    /**
+     * Execute in parallel with concurrency limit
+     */
+    async executeParallel(calls, onProgress) {
+        const results = new Array(calls.length);
+        let completed = 0;
+        let stopped = false;
+        // Process in batches
+        const batches = [];
+        for (let i = 0; i < calls.length; i += this.options.maxConcurrency) {
+            batches.push(calls.slice(i, i + this.options.maxConcurrency));
+        }
+        for (const batch of batches) {
+            if (stopped)
+                break;
+            const batchPromises = batch.map(async (call, batchIndex) => {
+                const globalIndex = calls.indexOf(call);
+                const result = await this.executeOne(call);
+                results[globalIndex] = result;
+                completed++;
+                onProgress?.({
+                    completed,
+                    total: calls.length,
+                    current: call,
+                    result,
+                });
+                if (this.options.stopOnError && result.error) {
+                    stopped = true;
+                }
+                return result;
+            });
+            await Promise.all(batchPromises);
+        }
+        return results.filter(Boolean);
+    }
+    /**
+     * Adaptive execution based on dependencies
+     */
+    async executeAdaptive(calls, onProgress) {
+        const results = new Map();
+        const pending = new Map(calls.map((c) => [c.id, c]));
+        let completed = 0;
+        while (pending.size > 0) {
+            // Find calls with satisfied dependencies
+            const ready = [];
+            for (const call of pending.values()) {
+                const deps = call.dependsOn ?? [];
+                if (deps.every((depId) => results.has(depId))) {
+                    ready.push(call);
+                }
+            }
+            if (ready.length === 0 && pending.size > 0) {
+                // Circular dependency or missing dependency
+                for (const call of pending.values()) {
+                    results.set(call.id, {
+                        toolCallId: call.id,
+                        name: call.name,
+                        result: null,
+                        error: 'Unresolvable dependencies',
+                        durationMs: 0,
+                        retriesAttempted: 0,
+                        cached: false,
+                    });
+                }
+                break;
+            }
+            // Execute ready calls in parallel (up to concurrency limit)
+            const batch = ready.slice(0, this.options.maxConcurrency);
+            const batchResults = await Promise.all(batch.map((call) => this.executeOne(call)));
+            for (let i = 0; i < batch.length; i++) {
+                const call = batch[i];
+                const result = batchResults[i];
+                results.set(call.id, result);
+                pending.delete(call.id);
+                completed++;
+                onProgress?.({
+                    completed,
+                    total: calls.length,
+                    current: call,
+                    result,
+                });
+                if (this.options.stopOnError && result.error) {
+                    // Mark remaining as skipped
+                    for (const remaining of pending.values()) {
+                        results.set(remaining.id, {
+                            toolCallId: remaining.id,
+                            name: remaining.name,
+                            result: null,
+                            error: 'Skipped due to previous error',
+                            durationMs: 0,
+                            retriesAttempted: 0,
+                            cached: false,
+                        });
+                    }
+                    pending.clear();
+                    break;
+                }
+            }
+        }
+        // Return in original order
+        return calls.map((c) => results.get(c.id));
+    }
+    /**
+     * Clear cache
+     */
+    clearCache() {
+        this.cache?.clear();
+    }
+    /**
+     * Cleanup expired cache entries
+     */
+    cleanupCache() {
+        return this.cache?.cleanup() ?? 0;
+    }
+}
+/**
+ * Create a batch executor
+ */
+export function createBatchExecutor(tools, options) {
+    const router = new SimpleToolRouter();
+    router.registerAll(tools);
+    return new BatchExecutor(router, options);
+}
+/**
+ * Create a batch executor with custom router
+ */
+export function createBatchExecutorWithRouter(router, options) {
+    return new BatchExecutor(router, options);
+}
+//# sourceMappingURL=executor.js.map

package/dist/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkFH;;GAEG;AACH,MAAM,OAAO,gBAAgB;IACnB,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAC;IAC1C,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE5C;;OAEG;IACH,QAAQ,CAAC,IAAoB;QAC3B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,KAAuB;QACjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,KAAa,EAAE,QAAgB;QACtC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,IAAc;QAClB,qBAAqB;QACrB,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;QAED,gBAAgB;QAChB,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,WAAW,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACrC,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,QAAQ,CAAC,QAAgB;QACvB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAChE,CAAC;IAED,UAAU;QACR,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACxD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,WAAW;IACP,KAAK,GAAG,IAAI,GAAG,EAGpB,CAAC;IACI,KAAK,CAAS;IAEtB,YAAY,QAAgB,KAAK;QAC/B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAEO,MAAM,CAAC,IAAc;QAC3B,OAAO,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;IAC1D,CAAC;IAED,GAAG,CAAC,IAAc;QAChB,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAElC,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAC7B,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC3C,CAAC;IAED,GAAG,CAAC,IAAc,EAAE,MAA0B;QAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE;YAClB,MAAM;YACN,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK;SACnC,CAAC,CAAC;IACL,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,OAAO;QACL,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YAChD,IAAI,GAAG,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;gBAC1B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACvB,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAED;;GAEG;AACH,KAAK,UAAU,kBAAkB,CAC/B,EAAoB,EACpB,SAAiB;IAEjB,OAAO,OAAO,CAAC,IAAI,CAAC;QAClB,EAAE,EAAE;QACJ,IAAI,OAAO,CAAI,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAC3B,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC,EAAE,SAAS,CAAC,CACzE;KACF,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,aAAa;IAChB,MAAM,CAAa;IACnB,OAAO,CAAkC;IACzC,KAAK,CAAe;IAE5B,YAAY,MAAkB,EAAE,UAAiC,EAAE;QACjE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG;YACb,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,CAAC;YAC3C,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,IAAI,KAAK;YACnD,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,CAAC;YAC3C,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,UAAU;YACxC,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,KAAK;YACzC,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,KAAK;YACzC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,KAAK;SACxC,CAAC;QAEF,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YAC7B,IAAI,CAAC,KAAK,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,IAAsB;QACrC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC;QAClE,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC;QAE/D,cAAc;QACd,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACpC,IAAI,MAAM;gBAAE,OAAO,MAAM,CAAC;QAC5B,CAAC;QAED,YAAY;QACZ,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;gBACL,UAAU,EAAE,IAAI,CAAC,EAAE;gBACnB,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,4BAA4B,IAAI,CAAC,IAAI,EAAE;gBAC9C,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;gBAClC,gBAAgB,EAAE,CAAC;gBACnB,MAAM,EAAE,KAAK;aACd,CAAC;QACJ,CAAC;QAED,uBAAuB;QACvB,IAAI,SAA6B,CAAC;QAClC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;YACvD,IAAI,CAAC;gBACH,sBAAsB;gBACtB,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBAErD,uBAAuB;gBACvB,MAAM,MAAM,GAAG,MAAM,kBAAkB,CACrC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAC1B,SAAS,CACV,CAAC;gBAEF,MAAM,cAAc,GAAuB;oBACzC,UAAU,EAAE,IAAI,CAAC,EAAE;oBACnB,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,MAAM;oBACN,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;oBAClC,gBAAgB,EAAE,OAAO;oBACzB,MAAM,EAAE,KAAK;iBACd,CAAC;gBAEF,eAAe;gBACf,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;oBACf,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;gBACvC,CAAC;gBAED,OAAO,cAAc,CAAC;YACxB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,SAAS,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACnE,iDAAiD;YACnD,CAAC;QACH,CAAC;QAED,OAAO;YACL,UAAU,EAAE,IAAI,CAAC,EAAE;YACnB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,IAAI;YACZ,KAAK,EAAE,SAAS;YAChB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;YAClC,gBAAgB,EAAE,UAAU;YAC5B,MAAM,EAAE,KAAK;SACd,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CACX,KAAyB,EACzB,UAA6B;QAE7B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAElC,mBAAmB;QACnB,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACtC,MAAM,aAAa,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;YACrD,MAAM,SAAS,GAAG,aAAa,CAAC,CAAC,CAAC,QAAQ,IAAI,QAAQ,CAAC,CAAC;YACxD,MAAM,SAAS,GAAG,aAAa,CAAC,CAAC,CAAC,QAAQ,IAAI,QAAQ,CAAC,CAAC;YACxD,OAAO,SAAS,GAAG,SAAS,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEH,QAAQ,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YAC9B,KAAK,YAAY;gBACf,OAAO,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;YACpD,KAAK,UAAU;gBACb,OAAO,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;YAClD,KAAK,UAAU;gBACb,OAAO,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,iBAAiB,CAC7B,KAAyB,EACzB,UAA6B;QAE7B,MAAM,OAAO,GAAyB,EAAE,CAAC;QAEzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;YACvB,UAAU,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;YAEnE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YAC3C,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAErB,UAAU,EAAE,CAAC;gBACX,SAAS,EAAE,CAAC,GAAG,CAAC;gBAChB,KAAK,EAAE,KAAK,CAAC,MAAM;gBACnB,OAAO,EAAE,IAAI;gBACb,MAAM;aACP,CAAC,CAAC;YAEH,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;gBAC7C,MAAM;YACR,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,eAAe,CAC3B,KAAyB,EACzB,UAA6B;QAE7B,MAAM,OAAO,GAAyB,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC9D,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,IAAI,OAAO,GAAG,KAAK,CAAC;QAEpB,qBAAqB;QACrB,MAAM,OAAO,GAAyB,EAAE,CAAC;QACzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;YACnE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC;QAChE,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,OAAO;gBAAE,MAAM;YAEnB,MAAM,aAAa,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE;gBACzD,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBACxC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;gBAC3C,OAAO,CAAC,WAAW,CAAC,GAAG,MAAM,CAAC;gBAE9B,SAAS,EAAE,CAAC;gBACZ,UAAU,EAAE,CAAC;oBACX,SAAS;oBACT,KAAK,EAAE,KAAK,CAAC,MAAM;oBACnB,OAAO,EAAE,IAAI;oBACb,MAAM;iBACP,CAAC,CAAC;gBAEH,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;oBAC7C,OAAO,GAAG,IAAI,CAAC;gBACjB,CAAC;gBAED,OAAO,MAAM,CAAC;YAChB,CAAC,CAAC,CAAC;YAEH,MAAM,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACnC,CAAC;QAED,OAAO,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,eAAe,CAC3B,KAAyB,EACzB,UAA6B;QAE7B,MAAM,OAAO,GAAG,IAAI,GAAG,EAA8B,CAAC;QACtD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACrD,IAAI,SAAS,GAAG,CAAC,CAAC;QAElB,OAAO,OAAO,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YACxB,yCAAyC;YACzC,MAAM,KAAK,GAAuB,EAAE,CAAC;YACrC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;gBACpC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC;gBAClC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;oBAC9C,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACnB,CAAC;YACH,CAAC;YAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;gBAC3C,4CAA4C;gBAC5C,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;oBACpC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE;wBACnB,UAAU,EAAE,IAAI,CAAC,EAAE;wBACnB,IAAI,EAAE,IAAI,CAAC,IAAI;wBACf,MAAM,EAAE,IAAI;wBACZ,KAAK,EAAE,2BAA2B;wBAClC,UAAU,EAAE,CAAC;wBACb,gBAAgB,EAAE,CAAC;wBACnB,MAAM,EAAE,KAAK;qBACd,CAAC,CAAC;gBACL,CAAC;gBACD,MAAM;YACR,CAAC;YAED,4DAA4D;YAC5D,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;YAC1D,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,GAAG,CACpC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAC3C,CAAC;YAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;gBACvB,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,CAAE,CAAC;gBAChC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;gBAC7B,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBAExB,SAAS,EAAE,CAAC;gBACZ,UAAU,EAAE,CAAC;oBACX,SAAS;oBACT,KAAK,EAAE,KAAK,CAAC,MAAM;oBACnB,OAAO,EAAE,IAAI;oBACb,MAAM;iBACP,CAAC,CAAC;gBAEH,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;oBAC7C,4BAA4B;oBAC5B,KAAK,MAAM,SAAS,IAAI,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;wBACzC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,EAAE;4BACxB,UAAU,EAAE,SAAS,CAAC,EAAE;4BACxB,IAAI,EAAE,SAAS,CAAC,IAAI;4BACpB,MAAM,EAAE,IAAI;4BACZ,KAAK,EAAE,+BAA+B;4BACtC,UAAU,EAAE,CAAC;4BACb,gBAAgB,EAAE,CAAC;4BACnB,MAAM,EAAE,KAAK;yBACd,CAAC,CAAC;oBACL,CAAC;oBACD,OAAO,CAAC,KAAK,EAAE,CAAC;oBAChB,MAAM;gBACR,CAAC;YACH,CAAC;QACH,CAAC;QAED,2BAA2B;QAC3B,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAE,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,UAAU;QACR,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAuB,EACvB,OAA+B;IAE/B,MAAM,MAAM,GAAG,IAAI,gBAAgB,EAAE,CAAC;IACtC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IAC1B,OAAO,IAAI,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,6BAA6B,CAC3C,MAAkB,EAClB,OAA+B;IAE/B,OAAO,IAAI,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC5C,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @llm-utils/agents
+ * Agent building blocks: tools, memory, conversation, and more
+ */
+export { defineTool, toOpenAITool, toAnthropicTool, zodToJsonSchema, ToolExecutor, createToolExecutor, } from './tools.js';
+export type { JsonSchema, ToolDefinition, OpenAITool, AnthropicTool, ToolCall, ToolResult, } from './tools.js';
+export { estimateTokens, createMemory, createSlidingWindowMemory, createSummaryMemory, } from './memory.js';
+export type { MessageRole, Message, TokenizedMessage, TokenCounter, MemoryConfig, MemoryStats, ConversationMemory, SummaryMemoryConfig, } from './memory.js';
+export { extractJson, parseJson, parseWithSchema, createParser, createSchemaParser, CommonSchemas, Parsers, } from './output.js';
+export type { ParseResult, JsonExtractionOptions, ParserWithRetry, } from './output.js';
+export { InMemoryThreadStorage, ConversationManager, createConversationManager, } from './conversation.js';
+export type { ThreadedMessage, ConversationThread, ThreadStorageAdapter, ConversationManagerOptions, } from './conversation.js';
+export { InMemorySessionStorage, ChatSession, SessionManager, createSessionManager, createChatSession, } from './session.js';
+export type { SessionStatus, SessionConfig, SessionState, SessionEventType, SessionEvent, SessionEventHandler, SessionStorage, } from './session.js';
+export { EventStreamProcessor, AgentEventEmitter, createEventProcessor, createEventEmitter, EventFilters, EventTransformers, } from './events.js';
+export type { AgentEventType, AgentEvent, AgentStartData, AgentEndData, LlmStreamData, ToolCallData, EventHandler, EventFilter, EventTransformer, } from './events.js';
+export { SimpleToolRouter, BatchExecutor, createBatchExecutor, createBatchExecutorWithRouter, } from './executor.js';
+export type { ExecutionPriority, ExecutionStrategy, EnhancedToolCall, EnhancedToolResult, BatchExecutionOptions, ProgressCallback, ToolRouter, } from './executor.js';
+export { MockMcpClient, McpToolAdapter, McpServerManager, createMcpManager, createMockMcpClient, createMcpToolAdapter, } from './mcp.js';
+export type { McpServerConfig, McpTool, McpResource, McpPrompt, McpCallResult, McpConnectionState, McpClient, } from './mcp.js';
+export { InMemoryTokenStorage, OAuthTokenManager, createOAuthManager, OAuthProviders, } from './oauth.js';
+export type { OAuthToken, OAuthProviderConfig, TokenStorage, TokenRefreshFn, TokenManagerOptions, } from './oauth.js';
+export { toLangChainMessage, toLangChainMessages, fromLangChainMessage, fromLangChainMessages, humanMessage, aiMessage, systemMessage, toolMessage, toLangChainToolCall, fromLangChainToolCall, buildToolResultMessage, buildToolMessages, MessageBuilder, createMessageBuilder, toOpenAIMessage, toOpenAIMessages, toAnthropicMessages, } from './langchain.js';
+export type { LangChainMessageType, LangChainMessage, HumanMessage, AIMessage, SystemMessage, ToolMessage, LangChainToolCall, ConversionOptions, OpenAIMessage, AnthropicMessage, } from './langchain.js';
+export { z } from 'zod';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,27 @@
+/**
+ * @llm-utils/agents
+ * Agent building blocks: tools, memory, conversation, and more
+ */
+// Tools
+export { defineTool, toOpenAITool, toAnthropicTool, zodToJsonSchema, ToolExecutor, createToolExecutor, } from './tools.js';
+// Memory
+export { estimateTokens, createMemory, createSlidingWindowMemory, createSummaryMemory, } from './memory.js';
+// Output Parsing
+export { extractJson, parseJson, parseWithSchema, createParser, createSchemaParser, CommonSchemas, Parsers, } from './output.js';
+// Conversation Threading
+export { InMemoryThreadStorage, ConversationManager, createConversationManager, } from './conversation.js';
+// Session Management
+export { InMemorySessionStorage, ChatSession, SessionManager, createSessionManager, createChatSession, } from './session.js';
+// Agent Events
+export { EventStreamProcessor, AgentEventEmitter, createEventProcessor, createEventEmitter, EventFilters, EventTransformers, } from './events.js';
+// Batch Executor
+export { SimpleToolRouter, BatchExecutor, createBatchExecutor, createBatchExecutorWithRouter, } from './executor.js';
+// MCP Client
+export { MockMcpClient, McpToolAdapter, McpServerManager, createMcpManager, createMockMcpClient, createMcpToolAdapter, } from './mcp.js';
+// OAuth Token Manager
+export { InMemoryTokenStorage, OAuthTokenManager, createOAuthManager, OAuthProviders, } from './oauth.js';
+// LangChain Message Builder
+export { toLangChainMessage, toLangChainMessages, fromLangChainMessage, fromLangChainMessages, humanMessage, aiMessage, systemMessage, toolMessage, toLangChainToolCall, fromLangChainToolCall, buildToolResultMessage, buildToolMessages, MessageBuilder, createMessageBuilder, toOpenAIMessage, toOpenAIMessages, toAnthropicMessages, } from './langchain.js';
+// Re-export zod for convenience
+export { z } from 'zod';
+//# 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;;;GAGG;AAEH,QAAQ;AACR,OAAO,EACL,UAAU,EACV,YAAY,EACZ,eAAe,EACf,eAAe,EACf,YAAY,EACZ,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAUpB,SAAS;AACT,OAAO,EACL,cAAc,EACd,YAAY,EACZ,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAYrB,iBAAiB;AACjB,OAAO,EACL,WAAW,EACX,SAAS,EACT,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,OAAO,GACR,MAAM,aAAa,CAAC;AAOrB,yBAAyB;AACzB,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,mBAAmB,CAAC;AAQ3B,qBAAqB;AACrB,OAAO,EACL,sBAAsB,EACtB,WAAW,EACX,cAAc,EACd,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAWtB,eAAe;AACf,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAarB,iBAAiB;AACjB,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,mBAAmB,EACnB,6BAA6B,GAC9B,MAAM,eAAe,CAAC;AAWvB,aAAa;AACb,OAAO,EACL,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,UAAU,CAAC;AAWlB,sBAAsB;AACtB,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,GACf,MAAM,YAAY,CAAC;AASpB,4BAA4B;AAC5B,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,YAAY,EACZ,SAAS,EACT,aAAa,EACb,WAAW,EACX,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AAcxB,gCAAgC;AAChC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC"}

package/dist/langchain.d.ts

@@ -0,0 +1,210 @@
+/**
+ * LangChain Message Builder
+ * Build LangChain-compatible messages from various sources
+ */
+import type { Message, MessageRole } from './memory.js';
+import type { ToolCall, ToolResult } from './tools.js';
+/**
+ * LangChain message types
+ */
+export type LangChainMessageType = 'human' | 'ai' | 'system' | 'tool' | 'function';
+/**
+ * LangChain base message
+ */
+export interface LangChainMessage {
+    type: LangChainMessageType;
+    content: string;
+    name?: string;
+    additional_kwargs?: Record<string, unknown>;
+}
+/**
+ * LangChain human message
+ */
+export interface HumanMessage extends LangChainMessage {
+    type: 'human';
+}
+/**
+ * LangChain AI message with tool calls
+ */
+export interface AIMessage extends LangChainMessage {
+    type: 'ai';
+    tool_calls?: LangChainToolCall[];
+}
+/**
+ * LangChain system message
+ */
+export interface SystemMessage extends LangChainMessage {
+    type: 'system';
+}
+/**
+ * LangChain tool message
+ */
+export interface ToolMessage extends LangChainMessage {
+    type: 'tool';
+    tool_call_id: string;
+}
+/**
+ * LangChain tool call format
+ */
+export interface LangChainToolCall {
+    id: string;
+    name: string;
+    args: Record<string, unknown>;
+}
+/**
+ * Message conversion options
+ */
+export interface ConversionOptions {
+    /** Include tool calls in AI messages */
+    includeToolCalls?: boolean;
+    /** Flatten tool results into content */
+    flattenToolResults?: boolean;
+    /** Custom role mapping */
+    roleMapping?: Partial<Record<MessageRole, LangChainMessageType>>;
+}
+/**
+ * Convert standard message to LangChain format
+ */
+export declare function toLangChainMessage(message: Message, options?: ConversionOptions): LangChainMessage;
+/**
+ * Convert array of messages to LangChain format
+ */
+export declare function toLangChainMessages(messages: Message[], options?: ConversionOptions): LangChainMessage[];
+/**
+ * Convert LangChain message to standard format
+ */
+export declare function fromLangChainMessage(lcMessage: LangChainMessage): Message;
+/**
+ * Convert array of LangChain messages to standard format
+ */
+export declare function fromLangChainMessages(lcMessages: LangChainMessage[]): Message[];
+/**
+ * Create a human message
+ */
+export declare function humanMessage(content: string, name?: string): HumanMessage;
+/**
+ * Create an AI message
+ */
+export declare function aiMessage(content: string, toolCalls?: LangChainToolCall[]): AIMessage;
+/**
+ * Create a system message
+ */
+export declare function systemMessage(content: string): SystemMessage;
+/**
+ * Create a tool message
+ */
+export declare function toolMessage(content: string, toolCallId: string, name?: string): ToolMessage;
+/**
+ * Convert tool call to LangChain format
+ */
+export declare function toLangChainToolCall(call: ToolCall): LangChainToolCall;
+/**
+ * Convert LangChain tool call to standard format
+ */
+export declare function fromLangChainToolCall(lcCall: LangChainToolCall): ToolCall;
+/**
+ * Build tool result message
+ */
+export declare function buildToolResultMessage(result: ToolResult): ToolMessage;
+/**
+ * Build messages from tool call + result pairs
+ */
+export declare function buildToolMessages(calls: ToolCall[], results: ToolResult[]): LangChainMessage[];
+/**
+ * Message builder for complex conversations
+ */
+export declare class MessageBuilder {
+    private messages;
+    /**
+     * Add system message
+     */
+    system(content: string): this;
+    /**
+     * Add human message
+     */
+    human(content: string, name?: string): this;
+    /**
+     * Add AI message
+     */
+    ai(content: string, toolCalls?: LangChainToolCall[]): this;
+    /**
+     * Add tool result message
+     */
+    tool(content: string, toolCallId: string, name?: string): this;
+    /**
+     * Add tool call and result
+     */
+    toolCallAndResult(call: ToolCall, result: ToolResult): this;
+    /**
+     * Add multiple messages
+     */
+    addMany(messages: Message[]): this;
+    /**
+     * Build the message array
+     */
+    build(): LangChainMessage[];
+    /**
+     * Build as standard messages
+     */
+    buildStandard(): Message[];
+    /**
+     * Clear builder
+     */
+    clear(): this;
+    /**
+     * Get message count
+     */
+    get length(): number;
+}
+/**
+ * Create a message builder
+ */
+export declare function createMessageBuilder(): MessageBuilder;
+/**
+ * OpenAI message format conversion
+ */
+export interface OpenAIMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string | null;
+    name?: string;
+    tool_calls?: Array<{
+        id: string;
+        type: 'function';
+        function: {
+            name: string;
+            arguments: string;
+        };
+    }>;
+    tool_call_id?: string;
+}
+/**
+ * Convert to OpenAI message format
+ */
+export declare function toOpenAIMessage(message: LangChainMessage): OpenAIMessage;
+/**
+ * Convert array to OpenAI format
+ */
+export declare function toOpenAIMessages(messages: LangChainMessage[]): OpenAIMessage[];
+/**
+ * Anthropic message format conversion
+ */
+export interface AnthropicMessage {
+    role: 'user' | 'assistant';
+    content: string | Array<{
+        type: 'text' | 'tool_use' | 'tool_result';
+        text?: string;
+        id?: string;
+        name?: string;
+        input?: Record<string, unknown>;
+        tool_use_id?: string;
+        content?: string;
+    }>;
+}
+/**
+ * Convert to Anthropic message format
+ */
+export declare function toAnthropicMessages(messages: LangChainMessage[]): {
+    system?: string;
+    messages: AnthropicMessage[];
+};
+//# sourceMappingURL=langchain.d.ts.map

package/dist/langchain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"langchain.d.ts","sourceRoot":"","sources":["../src/langchain.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEvD;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC5B,OAAO,GACP,IAAI,GACJ,QAAQ,GACR,MAAM,GACN,UAAU,CAAC;AAEf;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,oBAAoB,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACpD,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,SAAU,SAAQ,gBAAgB;IACjD,IAAI,EAAE,IAAI,CAAC;IACX,UAAU,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,gBAAgB;IACrD,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,gBAAgB;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,wCAAwC;IACxC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,wCAAwC;IACxC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,0BAA0B;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,oBAAoB,CAAC,CAAC,CAAC;CAClE;AAYD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,iBAAsB,GAC9B,gBAAgB,CAsBlB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,GAAE,iBAAsB,GAC9B,gBAAgB,EAAE,CAEpB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAuBzE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,gBAAgB,EAAE,GAC7B,OAAO,EAAE,CAEX;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,YAAY,CAEzE;AAED;;GAEG;AACH,wBAAgB,SAAS,CACvB,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,iBAAiB,EAAE,GAC9B,SAAS,CAMX;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAE5D;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,MAAM,GACZ,WAAW,CAEb;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,iBAAiB,CAMrE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,iBAAiB,GAAG,QAAQ,CAMzE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,UAAU,GAAG,WAAW,CAYtE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,QAAQ,EAAE,EACjB,OAAO,EAAE,UAAU,EAAE,GACpB,gBAAgB,EAAE,CAapB;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAA0B;IAE1C;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK7B;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAK3C;;OAEG;IACH,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,iBAAiB,EAAE,GAAG,IAAI;IAK1D;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAK9D;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI;IAM3D;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI;IAOlC;;OAEG;IACH,KAAK,IAAI,gBAAgB,EAAE;IAI3B;;OAEG;IACH,aAAa,IAAI,OAAO,EAAE;IAI1B;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;CACF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CAErD;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,UAAU,CAAC;QACjB,QAAQ,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC;KAC/C,CAAC,CAAC;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,aAAa,CAmCxE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,gBAAgB,EAAE,GAC3B,aAAa,EAAE,CAEjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EACH,MAAM,GACN,KAAK,CAAC;QACJ,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,aAAa,CAAC;QAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;CACR;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,gBAAgB,EAAE,GAC3B;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,gBAAgB,EAAE,CAAA;CAAE,CAyDnD"}