agentx-sdk 0.1.0

package/dist/tools/tool-executor.js

@@ -0,0 +1,232 @@
+import { ZodError } from 'zod';
+import { zodToJsonSchema } from 'zod-to-json-schema';
+import { retry } from '../utils/retry.js';
+const DEFAULT_MAX_RESULT_CHARS = 10_000;
+const TRUNCATE_HEAD_RATIO = 0.7;
+const TRUNCATE_TAIL_RATIO = 0.2;
+/**
+ * Registers tools, validates args via Zod, converts to JSON Schema,
+ * and executes tools with full pipeline:
+ *
+ *   1. Tool lookup
+ *   2. Zod schema validation
+ *   3. Semantic validation (tool.validate)
+ *   4. Before hook
+ *   5. Per-tool timeout wrapping
+ *   6. Retry for transient failures
+ *   7. Execute with progress callback
+ *   8. Result truncation (tool.maxResultChars)
+ *   9. Result mapping (tool.mapResult)
+ *  10. After hook
+ */
+export class ToolExecutor {
+    tools = new Map();
+    hooks;
+    constructor(hooks = {}) {
+        this.hooks = hooks;
+    }
+    register(tool) {
+        this.tools.set(tool.name, tool);
+    }
+    unregister(name) {
+        return this.tools.delete(name);
+    }
+    listTools() {
+        return [...this.tools.values()];
+    }
+    getToolDefinitions() {
+        return this.listTools().map(tool => ({
+            type: 'function',
+            function: {
+                name: tool.name,
+                description: tool.description,
+                parameters: zodToJsonSchema(tool.parameters, { target: 'openApi3' }),
+            },
+        }));
+    }
+    async execute(name, args, signalOrOptions) {
+        // Normalize options (backward compatible — accepts bare AbortSignal)
+        const opts = signalOrOptions instanceof AbortSignal
+            ? { signal: signalOrOptions }
+            : signalOrOptions ?? {};
+        const tool = this.tools.get(name);
+        if (!tool) {
+            return { content: `Tool "${name}" not found`, isError: true };
+        }
+        // 1. Zod schema validation
+        let validatedArgs;
+        try {
+            validatedArgs = tool.parameters.parse(args);
+        }
+        catch (error) {
+            if (error instanceof ZodError) {
+                return { content: `Validation error: ${error.errors.map(e => e.message).join(', ')}`, isError: true };
+            }
+            return { content: `Validation error: ${String(error)}`, isError: true };
+        }
+        // 2. Semantic validation (tool.validate)
+        if (tool.validate) {
+            try {
+                const validationError = await tool.validate(validatedArgs, {
+                    threadId: opts.threadId ?? 'default',
+                    recentMessages: 0,
+                });
+                if (validationError) {
+                    return { content: `Validation error: ${validationError}`, isError: true };
+                }
+            }
+            catch (error) {
+                return { content: `Validation error: ${error instanceof Error ? error.message : String(error)}`, isError: true };
+            }
+        }
+        // 3. Before hook
+        if (this.hooks.beforeToolCall) {
+            await this.hooks.beforeToolCall(name, validatedArgs);
+        }
+        // 4. Build execution signal (per-tool timeout + parent signal)
+        const execSignal = this.buildSignal(tool, opts.signal);
+        // 5. Build progress callback
+        const onProgress = opts.onProgress
+            ?? (opts.toolCallId && this.hooks.onToolProgress
+                ? (data) => this.hooks.onToolProgress(name, opts.toolCallId, data)
+                : undefined);
+        // 6. Execute (with retry if retryable)
+        let result;
+        try {
+            result = await this.executeWithRetry(tool, validatedArgs, execSignal, onProgress);
+        }
+        catch (error) {
+            result = { content: `Tool error: ${error instanceof Error ? error.message : String(error)}`, isError: true };
+        }
+        // 7. Result truncation
+        const maxChars = tool.maxResultChars ?? DEFAULT_MAX_RESULT_CHARS;
+        if (!result.isError && result.content.length > maxChars) {
+            result = {
+                ...result,
+                content: truncateResult(result.content, maxChars),
+                metadata: { ...result.metadata, truncated: true, originalLength: result.content.length },
+            };
+        }
+        // 8. Result mapping
+        if (tool.mapResult) {
+            result = tool.mapResult(result);
+        }
+        // 9. After hook
+        if (this.hooks.afterToolCall) {
+            await this.hooks.afterToolCall(name, validatedArgs, result);
+        }
+        return result;
+    }
+    async executeParallel(calls, signal) {
+        return Promise.all(calls.map(call => this.execute(call.name, call.args, signal)));
+    }
+    /**
+     * Executes tool calls respecting concurrency safety:
+     * - Consecutive concurrency-safe tools run in parallel
+     * - Non-safe tools run serially (one at a time)
+     * - Results are returned in the original call order
+     */
+    async executePartitioned(calls, signal) {
+        const results = [];
+        // Partition into batches of consecutive safe/unsafe tools
+        const batches = [];
+        let currentBatch = [];
+        let currentConcurrent = false;
+        for (const call of calls) {
+            const tool = this.tools.get(call.name);
+            const isSafe = tool
+                ? typeof tool.isConcurrencySafe === 'function'
+                    ? tool.isConcurrencySafe(call.args)
+                    : tool.isConcurrencySafe === true
+                : false;
+            if (currentBatch.length === 0) {
+                currentConcurrent = isSafe;
+                currentBatch.push(call);
+            }
+            else if (isSafe === currentConcurrent && isSafe) {
+                currentBatch.push(call);
+            }
+            else {
+                batches.push({ calls: currentBatch, concurrent: currentConcurrent });
+                currentBatch = [call];
+                currentConcurrent = isSafe;
+            }
+        }
+        if (currentBatch.length > 0) {
+            batches.push({ calls: currentBatch, concurrent: currentConcurrent });
+        }
+        for (const batch of batches) {
+            if (batch.concurrent) {
+                const batchResults = await Promise.all(batch.calls.map(async (call) => ({
+                    id: call.id,
+                    result: await this.execute(call.name, call.args, signal),
+                })));
+                results.push(...batchResults);
+            }
+            else {
+                for (const call of batch.calls) {
+                    const result = await this.execute(call.name, call.args, signal);
+                    results.push({ id: call.id, result });
+                }
+            }
+        }
+        return results;
+    }
+    // --- Private helpers ---
+    /**
+     * Build an AbortSignal combining parent signal + per-tool timeout.
+     */
+    buildSignal(tool, parentSignal) {
+        if (!tool.timeoutMs && !parentSignal) {
+            return new AbortController().signal;
+        }
+        if (!tool.timeoutMs)
+            return parentSignal;
+        const timeoutSignal = AbortSignal.timeout(tool.timeoutMs);
+        if (!parentSignal)
+            return timeoutSignal;
+        // Combine both signals
+        return AbortSignal.any([parentSignal, timeoutSignal]);
+    }
+    /**
+     * Execute with retry support using the existing retry utility.
+     */
+    async executeWithRetry(tool, args, signal, onProgress) {
+        const execFn = async () => {
+            const raw = await tool.execute(args, signal, onProgress);
+            return typeof raw === 'string' ? { content: raw } : raw;
+        };
+        if (!tool.retryable) {
+            return execFn();
+        }
+        const isRetryable = typeof tool.retryable === 'function'
+            ? tool.retryable
+            : (error) => {
+                // Don't retry abort errors
+                if (error instanceof DOMException && error.name === 'AbortError')
+                    return false;
+                return true;
+            };
+        return retry(execFn, {
+            maxRetries: tool.maxRetries ?? 2,
+            initialDelay: 500,
+            backoffMultiplier: 2,
+            maxDelay: 5_000,
+            signal,
+            isRetryable,
+        });
+    }
+}
+/**
+ * Truncate tool result content preserving head and tail.
+ * Same strategy as microcompact (70% head, 20% tail).
+ */
+function truncateResult(content, maxChars) {
+    const headSize = Math.floor(maxChars * TRUNCATE_HEAD_RATIO);
+    const tailSize = Math.floor(maxChars * TRUNCATE_TAIL_RATIO);
+    const head = content.slice(0, headSize);
+    const tail = content.slice(-tailSize);
+    const omitted = content.length - headSize - tailSize;
+    return `${head}\n\n[truncated ${omitted} characters]\n\n${tail}`;
+}
+//# sourceMappingURL=tool-executor.js.map

package/dist/tools/tool-executor.js.map

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

package/dist/utils/cache.d.ts

@@ -0,0 +1,22 @@
+export interface CacheOptions {
+    maxSize: number;
+    ttl?: number;
+}
+/**
+ * LRU Cache with optional TTL expiration.
+ * Uses Map insertion order for LRU tracking.
+ */
+export declare class LRUCache<K, V> {
+    private readonly map;
+    private readonly maxSize;
+    private readonly ttl;
+    constructor(options: CacheOptions);
+    get size(): number;
+    get(key: K): V | undefined;
+    set(key: K, value: V): void;
+    has(key: K): boolean;
+    delete(key: K): boolean;
+    clear(): void;
+    private isExpired;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/utils/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/utils/cache.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAOD;;;GAGG;AACH,qBAAa,QAAQ,CAAC,CAAC,EAAE,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA+B;IACnD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAqB;gBAE7B,OAAO,EAAE,YAAY;IAKjC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAe1B,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAa3B,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAYpB,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAIvB,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,SAAS;CAIlB"}

package/dist/utils/cache.js

@@ -0,0 +1,61 @@
+/**
+ * LRU Cache with optional TTL expiration.
+ * Uses Map insertion order for LRU tracking.
+ */
+export class LRUCache {
+    map = new Map();
+    maxSize;
+    ttl;
+    constructor(options) {
+        this.maxSize = options.maxSize;
+        this.ttl = options.ttl;
+    }
+    get size() {
+        return this.map.size;
+    }
+    get(key) {
+        const entry = this.map.get(key);
+        if (!entry)
+            return undefined;
+        if (this.isExpired(entry)) {
+            this.map.delete(key);
+            return undefined;
+        }
+        // Move to end (most recently used)
+        this.map.delete(key);
+        this.map.set(key, entry);
+        return entry.value;
+    }
+    set(key, value) {
+        // Remove existing to update position
+        this.map.delete(key);
+        // Evict LRU if at capacity
+        if (this.map.size >= this.maxSize) {
+            const firstKey = this.map.keys().next().value;
+            this.map.delete(firstKey);
+        }
+        this.map.set(key, { value, createdAt: Date.now() });
+    }
+    has(key) {
+        const entry = this.map.get(key);
+        if (!entry)
+            return false;
+        if (this.isExpired(entry)) {
+            this.map.delete(key);
+            return false;
+        }
+        return true;
+    }
+    delete(key) {
+        return this.map.delete(key);
+    }
+    clear() {
+        this.map.clear();
+    }
+    isExpired(entry) {
+        if (!this.ttl)
+            return false;
+        return Date.now() - entry.createdAt > this.ttl;
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/utils/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/utils/cache.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,MAAM,OAAO,QAAQ;IACF,GAAG,GAAG,IAAI,GAAG,EAAoB,CAAC;IAClC,OAAO,CAAS;IAChB,GAAG,CAAqB;IAEzC,YAAY,OAAqB;QAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IACzB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;IACvB,CAAC;IAED,GAAG,CAAC,GAAM;QACR,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAE7B,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACrB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,mCAAmC;QACnC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACrB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACzB,OAAO,KAAK,CAAC,KAAK,CAAC;IACrB,CAAC;IAED,GAAG,CAAC,GAAM,EAAE,KAAQ;QAClB,qCAAqC;QACrC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAErB,2BAA2B;QAC3B,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAU,CAAC;YACnD,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC5B,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,GAAG,CAAC,GAAM;QACR,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QAEzB,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACrB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,CAAC,GAAM;QACX,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;IACnB,CAAC;IAEO,SAAS,CAAC,KAAoB;QACpC,IAAI,CAAC,IAAI,CAAC,GAAG;YAAE,OAAO,KAAK,CAAC;QAC5B,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC;IACjD,CAAC;CACF"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,15 @@
+import type { LogLevel } from '../contracts/enums/index.js';
+export interface Logger {
+    level: LogLevel;
+    debug(message: string, context?: Record<string, unknown>): void;
+    info(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    error(message: string, context?: Record<string, unknown>): void;
+    child(prefix: string): Logger;
+}
+export interface LoggerOptions {
+    level?: LogLevel;
+    prefix?: string;
+}
+export declare function createLogger(options?: LoggerOptions): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAU5D,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,QAAQ,CAAC;IAChB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAChE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAChE,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AASD,wBAAgB,YAAY,CAAC,OAAO,GAAE,aAAkB,GAAG,MAAM,CA8BhE"}

package/dist/utils/logger.js

@@ -0,0 +1,46 @@
+const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+    silent: 4,
+};
+function formatMessage(level, prefix, message, context) {
+    const timestamp = new Date().toISOString();
+    const prefixStr = prefix ? `[${prefix}] ` : '';
+    const contextStr = context ? ' ' + JSON.stringify(context) : '';
+    return `${timestamp} ${level.toUpperCase()} ${prefixStr}${message}${contextStr}`;
+}
+export function createLogger(options = {}) {
+    const level = options.level ?? 'info';
+    const prefix = options.prefix;
+    const threshold = LOG_LEVELS[level];
+    function shouldLog(msgLevel) {
+        return LOG_LEVELS[msgLevel] >= threshold;
+    }
+    const logger = {
+        level,
+        debug(message, context) {
+            if (shouldLog('debug'))
+                console.debug(formatMessage('debug', prefix, message, context));
+        },
+        info(message, context) {
+            if (shouldLog('info'))
+                console.info(formatMessage('info', prefix, message, context));
+        },
+        warn(message, context) {
+            if (shouldLog('warn'))
+                console.warn(formatMessage('warn', prefix, message, context));
+        },
+        error(message, context) {
+            if (shouldLog('error'))
+                console.error(formatMessage('error', prefix, message, context));
+        },
+        child(childPrefix) {
+            const newPrefix = prefix ? `${prefix}:${childPrefix}` : childPrefix;
+            return createLogger({ level, prefix: newPrefix });
+        },
+    };
+    return logger;
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAA6B;IAC3C,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;IACR,MAAM,EAAE,CAAC;CACV,CAAC;AAgBF,SAAS,aAAa,CAAC,KAAa,EAAE,MAA0B,EAAE,OAAe,EAAE,OAAiC;IAClH,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/C,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,OAAO,GAAG,SAAS,IAAI,KAAK,CAAC,WAAW,EAAE,IAAI,SAAS,GAAG,OAAO,GAAG,UAAU,EAAE,CAAC;AACnF,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,UAAyB,EAAE;IACtD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC;IACtC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC9B,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAEpC,SAAS,SAAS,CAAC,QAAkB;QACnC,OAAO,UAAU,CAAC,QAAQ,CAAC,IAAI,SAAS,CAAC;IAC3C,CAAC;IAED,MAAM,MAAM,GAAW;QACrB,KAAK;QACL,KAAK,CAAC,OAAO,EAAE,OAAQ;YACrB,IAAI,SAAS,CAAC,OAAO,CAAC;gBAAE,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QAC1F,CAAC;QACD,IAAI,CAAC,OAAO,EAAE,OAAQ;YACpB,IAAI,SAAS,CAAC,MAAM,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QACvF,CAAC;QACD,IAAI,CAAC,OAAO,EAAE,OAAQ;YACpB,IAAI,SAAS,CAAC,MAAM,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QACvF,CAAC;QACD,KAAK,CAAC,OAAO,EAAE,OAAQ;YACrB,IAAI,SAAS,CAAC,OAAO,CAAC;gBAAE,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QAC1F,CAAC;QACD,KAAK,CAAC,WAAmB;YACvB,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,WAAW,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC;YACpE,OAAO,YAAY,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QACpD,CAAC;KACF,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/utils/model-context.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Model context window detection.
+ *
+ * Maps known model IDs to their context window sizes.
+ * Falls back to a conservative default for unknown models.
+ */
+/**
+ * Get the context window size for a model.
+ *
+ * @param modelId — full model ID (e.g. "anthropic/claude-sonnet-4-20250514")
+ * @param override — optional explicit override (takes precedence)
+ */
+export declare function getModelContextWindow(modelId: string, override?: number): number;
+//# sourceMappingURL=model-context.d.ts.map

package/dist/utils/model-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-context.d.ts","sourceRoot":"","sources":["../../src/utils/model-context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAuCH;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAQhF"}

package/dist/utils/model-context.js

@@ -0,0 +1,52 @@
+/**
+ * Model context window detection.
+ *
+ * Maps known model IDs to their context window sizes.
+ * Falls back to a conservative default for unknown models.
+ */
+const DEFAULT_CONTEXT_WINDOW = 128_000;
+/** Known model patterns → context window tokens */
+const MODEL_CONTEXT_WINDOWS = [
+    // Anthropic Claude
+    { pattern: 'claude-opus-4', tokens: 200_000 },
+    { pattern: 'claude-sonnet-4', tokens: 200_000 },
+    { pattern: 'claude-haiku-4', tokens: 200_000 },
+    { pattern: 'claude-3.5-sonnet', tokens: 200_000 },
+    { pattern: 'claude-3-opus', tokens: 200_000 },
+    { pattern: 'claude-3-sonnet', tokens: 200_000 },
+    { pattern: 'claude-3-haiku', tokens: 200_000 },
+    // OpenAI GPT-4
+    { pattern: 'gpt-4o', tokens: 128_000 },
+    { pattern: 'gpt-4-turbo', tokens: 128_000 },
+    { pattern: 'gpt-4-0125', tokens: 128_000 },
+    { pattern: 'gpt-4-1106', tokens: 128_000 },
+    // OpenAI o1/o3
+    { pattern: 'o1', tokens: 200_000 },
+    { pattern: 'o3', tokens: 200_000 },
+    // Google Gemini
+    { pattern: 'gemini-2', tokens: 1_000_000 },
+    { pattern: 'gemini-1.5-pro', tokens: 1_000_000 },
+    { pattern: 'gemini-1.5-flash', tokens: 1_000_000 },
+    // DeepSeek
+    { pattern: 'deepseek-chat', tokens: 128_000 },
+    { pattern: 'deepseek-r1', tokens: 128_000 },
+    // Mistral
+    { pattern: 'mistral-large', tokens: 128_000 },
+    { pattern: 'mistral-medium', tokens: 32_000 },
+];
+/**
+ * Get the context window size for a model.
+ *
+ * @param modelId — full model ID (e.g. "anthropic/claude-sonnet-4-20250514")
+ * @param override — optional explicit override (takes precedence)
+ */
+export function getModelContextWindow(modelId, override) {
+    if (override !== undefined)
+        return override;
+    for (const entry of MODEL_CONTEXT_WINDOWS) {
+        if (modelId.includes(entry.pattern))
+            return entry.tokens;
+    }
+    return DEFAULT_CONTEXT_WINDOW;
+}
+//# sourceMappingURL=model-context.js.map

package/dist/utils/model-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-context.js","sourceRoot":"","sources":["../../src/utils/model-context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,sBAAsB,GAAG,OAAO,CAAC;AAEvC,mDAAmD;AACnD,MAAM,qBAAqB,GAA+C;IACxE,mBAAmB;IACnB,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,EAAE;IAC7C,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,OAAO,EAAE;IAC/C,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,EAAE;IAC9C,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,OAAO,EAAE;IACjD,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,EAAE;IAC7C,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,OAAO,EAAE;IAC/C,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,EAAE;IAE9C,eAAe;IACf,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE;IACtC,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE;IAC3C,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE;IAC1C,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE;IAE1C,eAAe;IACf,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE;IAClC,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE;IAElC,gBAAgB;IAChB,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE;IAC1C,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,SAAS,EAAE;IAChD,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAE,SAAS,EAAE;IAElD,WAAW;IACX,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,EAAE;IAC7C,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE;IAE3C,UAAU;IACV,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,EAAE;IAC7C,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE;CAC9C,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAe,EAAE,QAAiB;IACtE,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IAE5C,KAAK,MAAM,KAAK,IAAI,qBAAqB,EAAE,CAAC;QAC1C,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC;YAAE,OAAO,KAAK,CAAC,MAAM,CAAC;IAC3D,CAAC;IAED,OAAO,sBAAsB,CAAC;AAChC,CAAC"}

package/dist/utils/retry.d.ts

@@ -0,0 +1,13 @@
+export interface RetryOptions {
+    maxRetries: number;
+    initialDelay?: number;
+    backoffMultiplier?: number;
+    maxDelay?: number;
+    signal?: AbortSignal;
+    isRetryable?: (error: unknown) => boolean;
+}
+/**
+ * Retries an async function with exponential backoff.
+ */
+export declare function retry<T>(fn: () => Promise<T>, options: RetryOptions): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/utils/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;CAC3C;AAkBD;;GAEG;AACH,wBAAsB,KAAK,CAAC,CAAC,EAC3B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,CAAC,CAAC,CAkCZ"}

package/dist/utils/retry.js

@@ -0,0 +1,41 @@
+function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(signal.reason ?? new Error('Aborted'));
+            return;
+        }
+        const timer = setTimeout(resolve, ms);
+        signal?.addEventListener('abort', () => {
+            clearTimeout(timer);
+            reject(signal.reason ?? new Error('Aborted'));
+        }, { once: true });
+    });
+}
+/**
+ * Retries an async function with exponential backoff.
+ */
+export async function retry(fn, options) {
+    const { maxRetries, initialDelay = 1000, backoffMultiplier = 2, maxDelay = 30_000, signal, isRetryable = () => true, } = options;
+    let lastError;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            if (signal?.aborted) {
+                throw signal.reason ?? new Error('Aborted');
+            }
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            if (attempt >= maxRetries || !isRetryable(error)) {
+                throw error;
+            }
+            // Respect retryAfterMs from rate-limited errors (e.g. 429 with Retry-After header)
+            const retryAfterMs = error?.retryAfterMs;
+            const backoffDelay = Math.min(initialDelay * backoffMultiplier ** attempt, maxDelay);
+            const delay = retryAfterMs ? Math.max(retryAfterMs, backoffDelay) : backoffDelay;
+            await sleep(delay, signal);
+        }
+    }
+    throw lastError;
+}
+//# sourceMappingURL=retry.js.map

package/dist/utils/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"AASA,SAAS,KAAK,CAAC,EAAU,EAAE,MAAoB;IAC7C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;YAC9C,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAEtC,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;YACrC,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;QAChD,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACrB,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,EAAoB,EACpB,OAAqB;IAErB,MAAM,EACJ,UAAU,EACV,YAAY,GAAG,IAAI,EACnB,iBAAiB,GAAG,CAAC,EACrB,QAAQ,GAAG,MAAM,EACjB,MAAM,EACN,WAAW,GAAG,GAAG,EAAE,CAAC,IAAI,GACzB,GAAG,OAAO,CAAC;IAEZ,IAAI,SAAkB,CAAC;IAEvB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;QACvD,IAAI,CAAC;YACH,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;gBACpB,MAAM,MAAM,CAAC,MAAM,IAAI,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC;YAC9C,CAAC;YACD,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAK,CAAC;YAElB,IAAI,OAAO,IAAI,UAAU,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;gBACjD,MAAM,KAAK,CAAC;YACd,CAAC;YAED,mFAAmF;YACnF,MAAM,YAAY,GAAI,KAAmC,EAAE,YAAY,CAAC;YACxE,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,GAAG,iBAAiB,IAAI,OAAO,EAAE,QAAQ,CAAC,CAAC;YACrF,MAAM,KAAK,GAAG,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;YACjF,MAAM,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,MAAM,SAAS,CAAC;AAClB,CAAC"}

package/dist/utils/token-counter.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Estimates token count for a text string.
+ * Uses heuristic: ~4 chars per token for latin, ~1.5 chars per token for CJK.
+ */
+export declare function estimateTokens(text: string): number;
+//# sourceMappingURL=token-counter.d.ts.map

package/dist/utils/token-counter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-counter.d.ts","sourceRoot":"","sources":["../../src/utils/token-counter.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAWnD"}

package/dist/utils/token-counter.js

@@ -0,0 +1,19 @@
+// CJK Unified Ideographs and common CJK ranges
+const CJK_REGEX = /[\u4e00-\u9fff\u3400-\u4dbf\u3000-\u303f\u3040-\u309f\u30a0-\u30ff\uff00-\uffef\uac00-\ud7af]/g;
+const CHARS_PER_TOKEN_LATIN = 4;
+const CHARS_PER_TOKEN_CJK = 1.5;
+/**
+ * Estimates token count for a text string.
+ * Uses heuristic: ~4 chars per token for latin, ~1.5 chars per token for CJK.
+ */
+export function estimateTokens(text) {
+    if (!text)
+        return 0;
+    const cjkChars = (text.match(CJK_REGEX) ?? []).length;
+    const nonCjkText = text.replace(CJK_REGEX, '');
+    const latinChars = nonCjkText.replace(/\s+/g, ' ').length;
+    const cjkTokens = cjkChars / CHARS_PER_TOKEN_CJK;
+    const latinTokens = latinChars / CHARS_PER_TOKEN_LATIN;
+    return Math.ceil(cjkTokens + latinTokens);
+}
+//# sourceMappingURL=token-counter.js.map

package/dist/utils/token-counter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-counter.js","sourceRoot":"","sources":["../../src/utils/token-counter.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,MAAM,SAAS,GAAG,gGAAgG,CAAC;AACnH,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAChC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEhC;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,CAAC;IAEpB,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IACtD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAC/C,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC;IAE1D,MAAM,SAAS,GAAG,QAAQ,GAAG,mBAAmB,CAAC;IACjD,MAAM,WAAW,GAAG,UAAU,GAAG,qBAAqB,CAAC;IAEvD,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC,CAAC;AAC5C,CAAC"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "agentx-sdk",
+  "version": "0.1.0",
+  "description": "AgentX SDK - Standalone TypeScript agent library with streaming, tools, memory, knowledge (RAG), and skills",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "tsc --noEmit"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "dependencies": {
+    "better-sqlite3": "^11.0.0",
+    "zod": "^3.23.0",
+    "zod-to-json-schema": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.0",
+    "@types/node": "^22.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "optionalDependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "license": "MIT"
+}