@bowenqt/qiniu-ai-sdk 0.10.0 → 0.14.0

package/dist/lib/otel-tracer.mjs

@@ -0,0 +1,75 @@
+/**
+ * OpenTelemetry Tracer adapter.
+ * Wraps @opentelemetry/api for seamless integration.
+ *
+ * @optional - This file only works if @opentelemetry/api is installed.
+ */
+import { DEFAULT_TRACER_CONFIG, redactAttributes } from './tracer.mjs';
+/**
+ * Span wrapper around OTel span.
+ */
+class OTelSpanWrapper {
+    constructor(otelSpan, config) {
+        this.otelSpan = otelSpan;
+        this.config = config;
+    }
+    setAttribute(key, value) {
+        this.otelSpan.setAttribute(key, value);
+    }
+    setAttributes(attributes) {
+        this.otelSpan.setAttributes(redactAttributes(attributes, this.config));
+    }
+    recordException(error) {
+        this.otelSpan.recordException(error);
+    }
+    addEvent(name, attributes) {
+        this.otelSpan.addEvent(name, attributes ? redactAttributes(attributes, this.config) : undefined);
+    }
+    end() {
+        this.otelSpan.end();
+    }
+}
+/**
+ * OpenTelemetry Tracer implementation.
+ * Requires @opentelemetry/api as a peer dependency.
+ *
+ * @example
+ * ```typescript
+ * import { trace } from '@opentelemetry/api';
+ * import { OTelTracer, setGlobalTracer } from '@bowenqt/qiniu-ai-sdk';
+ *
+ * const provider = trace.getTracerProvider();
+ * const tracer = new OTelTracer(provider, { recordPrompts: false });
+ * setGlobalTracer(tracer);
+ * ```
+ */
+export class OTelTracer {
+    constructor(provider, config = {}) {
+        this.otelTracer = provider.getTracer('qiniu-ai-sdk', '0.13.0');
+        this.config = { ...DEFAULT_TRACER_CONFIG, ...config };
+    }
+    startSpan(name, attributes) {
+        const otelSpan = this.otelTracer.startSpan(name, {
+            attributes: attributes ? redactAttributes(attributes, this.config) : undefined,
+        });
+        return new OTelSpanWrapper(otelSpan, this.config);
+    }
+    async withSpan(name, fn) {
+        const span = this.startSpan(name);
+        try {
+            const result = await fn(span);
+            return result;
+        }
+        catch (error) {
+            span.recordException(error);
+            throw error;
+        }
+        finally {
+            span.end();
+        }
+    }
+    getConfig() {
+        return this.config;
+    }
+}
+//# sourceMappingURL=otel-tracer.js.map

package/dist/lib/token-estimator.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Token Estimator for LLM context management.
+ * Supports CJK character-level weighting and ContentPart[].
+ *
+ * IMPORTANT: All compaction paths MUST use estimateMessageTokens,
+ * NOT estimator(message.content) directly.
+ */
+import type { ContentPart } from './types';
+/**
+ * Token estimator configuration.
+ */
+export interface TokenEstimatorConfig {
+    /** Characters per token for Latin text (default: 4) */
+    charsPerToken?: number;
+    /** Multiplier for CJK characters (default: 1.5) */
+    cjkMultiplier?: number;
+    /** Fixed overhead per message for role/metadata (default: 10) */
+    messageOverhead?: number;
+    /** Token cost per image (default: 85) */
+    imageTokenCost?: number;
+    /** Token cost per tool_call (default: 50) */
+    toolCallCost?: number;
+}
+/**
+ * Token estimator function type.
+ */
+export type ContentEstimator = (content: string | ContentPart[]) => number;
+/**
+ * Create a token estimator with the given configuration.
+ */
+export declare function createTokenEstimator(config?: TokenEstimatorConfig): ContentEstimator;
+/**
+ * Default content estimator.
+ */
+export declare const defaultContentEstimator: ContentEstimator;
+/**
+ * Message interface for estimation.
+ */
+export interface EstimableMessage {
+    content: string | ContentPart[];
+    tool_calls?: unknown[];
+    role?: string;
+}
+/**
+ * Estimate tokens for a complete message.
+ * This is the PRIMARY function for compaction - use this, not content-only estimation.
+ *
+ * @param message - The message to estimate
+ * @param config - Optional configuration
+ * @returns Estimated token count
+ */
+export declare function estimateMessageTokens(message: EstimableMessage, config?: TokenEstimatorConfig): number;
+/**
+ * Estimate tokens for an array of messages.
+ * This is the function to use in compaction config.
+ */
+export declare function estimateMessagesTokens(messages: EstimableMessage[], config?: TokenEstimatorConfig): number;
+/**
+ * Default configuration values (exported for documentation).
+ */
+export declare const DEFAULT_ESTIMATOR_CONFIG: Required<TokenEstimatorConfig>;
+//# sourceMappingURL=token-estimator.d.ts.map

package/dist/lib/token-estimator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-estimator.d.ts","sourceRoot":"","sources":["../../src/lib/token-estimator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAmB3C;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,uDAAuD;IACvD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iEAAiE;IACjE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yCAAyC;IACzC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6CAA6C;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,KAAK,MAAM,CAAC;AAE3E;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,GAAE,oBAAyB,GAAG,gBAAgB,CAsBxF;AAaD;;GAEG;AACH,eAAO,MAAM,uBAAuB,kBAAyB,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CAAC;IAChC,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACjC,OAAO,EAAE,gBAAgB,EACzB,MAAM,GAAE,oBAAyB,GAClC,MAAM,CAgBR;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAClC,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,MAAM,GAAE,oBAAyB,GAClC,MAAM,CAER;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,QAAQ,CAAC,oBAAoB,CAMnE,CAAC"}

package/dist/lib/token-estimator.js

@@ -0,0 +1,106 @@
+"use strict";
+/**
+ * Token Estimator for LLM context management.
+ * Supports CJK character-level weighting and ContentPart[].
+ *
+ * IMPORTANT: All compaction paths MUST use estimateMessageTokens,
+ * NOT estimator(message.content) directly.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_ESTIMATOR_CONFIG = exports.defaultContentEstimator = void 0;
+exports.createTokenEstimator = createTokenEstimator;
+exports.estimateMessageTokens = estimateMessageTokens;
+exports.estimateMessagesTokens = estimateMessagesTokens;
+/** CJK Unicode ranges */
+const CJK_RANGES = [
+    [0x4e00, 0x9fff], // CJK Unified Ideographs
+    [0x3400, 0x4dbf], // CJK Extension A
+    [0xac00, 0xd7af], // Hangul Syllables
+    [0x3040, 0x30ff], // Hiragana + Katakana
+    [0xff00, 0xffef], // Fullwidth Forms
+];
+/**
+ * Check if a character is CJK.
+ */
+function isCJK(char) {
+    const code = char.charCodeAt(0);
+    return CJK_RANGES.some(([start, end]) => code >= start && code <= end);
+}
+/**
+ * Create a token estimator with the given configuration.
+ */
+function createTokenEstimator(config = {}) {
+    const charsPerToken = config.charsPerToken ?? 4;
+    const cjkMultiplier = config.cjkMultiplier ?? 1.5;
+    const imageTokenCost = config.imageTokenCost ?? 85;
+    return (content) => {
+        // Handle ContentPart[]
+        if (Array.isArray(content)) {
+            let total = 0;
+            for (const part of content) {
+                if (part.type === 'text' && part.text) {
+                    total += estimateText(part.text, charsPerToken, cjkMultiplier);
+                }
+                else if (part.type === 'image_url') {
+                    total += imageTokenCost;
+                }
+            }
+            return total;
+        }
+        // Handle plain string
+        return estimateText(content, charsPerToken, cjkMultiplier);
+    };
+}
+/**
+ * Estimate tokens for text content.
+ */
+function estimateText(text, charsPerToken, cjkMultiplier) {
+    let weightedChars = 0;
+    for (const char of text) {
+        weightedChars += isCJK(char) ? cjkMultiplier : 1;
+    }
+    return Math.ceil(weightedChars / charsPerToken);
+}
+/**
+ * Default content estimator.
+ */
+exports.defaultContentEstimator = createTokenEstimator();
+/**
+ * Estimate tokens for a complete message.
+ * This is the PRIMARY function for compaction - use this, not content-only estimation.
+ *
+ * @param message - The message to estimate
+ * @param config - Optional configuration
+ * @returns Estimated token count
+ */
+function estimateMessageTokens(message, config = {}) {
+    const messageOverhead = config.messageOverhead ?? 10;
+    const toolCallCost = config.toolCallCost ?? 50;
+    const estimator = createTokenEstimator(config);
+    let tokens = messageOverhead;
+    // Content tokens
+    tokens += estimator(message.content);
+    // Tool call tokens
+    if (message.tool_calls?.length) {
+        tokens += message.tool_calls.length * toolCallCost;
+    }
+    return tokens;
+}
+/**
+ * Estimate tokens for an array of messages.
+ * This is the function to use in compaction config.
+ */
+function estimateMessagesTokens(messages, config = {}) {
+    return messages.reduce((sum, msg) => sum + estimateMessageTokens(msg, config), 0);
+}
+/**
+ * Default configuration values (exported for documentation).
+ */
+exports.DEFAULT_ESTIMATOR_CONFIG = {
+    charsPerToken: 4,
+    cjkMultiplier: 1.5,
+    messageOverhead: 10,
+    imageTokenCost: 85,
+    toolCallCost: 50,
+};
+//# sourceMappingURL=token-estimator.js.map

package/dist/lib/token-estimator.js.map

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

package/dist/lib/token-estimator.mjs

@@ -0,0 +1,100 @@
+/**
+ * Token Estimator for LLM context management.
+ * Supports CJK character-level weighting and ContentPart[].
+ *
+ * IMPORTANT: All compaction paths MUST use estimateMessageTokens,
+ * NOT estimator(message.content) directly.
+ */
+/** CJK Unicode ranges */
+const CJK_RANGES = [
+    [0x4e00, 0x9fff], // CJK Unified Ideographs
+    [0x3400, 0x4dbf], // CJK Extension A
+    [0xac00, 0xd7af], // Hangul Syllables
+    [0x3040, 0x30ff], // Hiragana + Katakana
+    [0xff00, 0xffef], // Fullwidth Forms
+];
+/**
+ * Check if a character is CJK.
+ */
+function isCJK(char) {
+    const code = char.charCodeAt(0);
+    return CJK_RANGES.some(([start, end]) => code >= start && code <= end);
+}
+/**
+ * Create a token estimator with the given configuration.
+ */
+export function createTokenEstimator(config = {}) {
+    const charsPerToken = config.charsPerToken ?? 4;
+    const cjkMultiplier = config.cjkMultiplier ?? 1.5;
+    const imageTokenCost = config.imageTokenCost ?? 85;
+    return (content) => {
+        // Handle ContentPart[]
+        if (Array.isArray(content)) {
+            let total = 0;
+            for (const part of content) {
+                if (part.type === 'text' && part.text) {
+                    total += estimateText(part.text, charsPerToken, cjkMultiplier);
+                }
+                else if (part.type === 'image_url') {
+                    total += imageTokenCost;
+                }
+            }
+            return total;
+        }
+        // Handle plain string
+        return estimateText(content, charsPerToken, cjkMultiplier);
+    };
+}
+/**
+ * Estimate tokens for text content.
+ */
+function estimateText(text, charsPerToken, cjkMultiplier) {
+    let weightedChars = 0;
+    for (const char of text) {
+        weightedChars += isCJK(char) ? cjkMultiplier : 1;
+    }
+    return Math.ceil(weightedChars / charsPerToken);
+}
+/**
+ * Default content estimator.
+ */
+export const defaultContentEstimator = createTokenEstimator();
+/**
+ * Estimate tokens for a complete message.
+ * This is the PRIMARY function for compaction - use this, not content-only estimation.
+ *
+ * @param message - The message to estimate
+ * @param config - Optional configuration
+ * @returns Estimated token count
+ */
+export function estimateMessageTokens(message, config = {}) {
+    const messageOverhead = config.messageOverhead ?? 10;
+    const toolCallCost = config.toolCallCost ?? 50;
+    const estimator = createTokenEstimator(config);
+    let tokens = messageOverhead;
+    // Content tokens
+    tokens += estimator(message.content);
+    // Tool call tokens
+    if (message.tool_calls?.length) {
+        tokens += message.tool_calls.length * toolCallCost;
+    }
+    return tokens;
+}
+/**
+ * Estimate tokens for an array of messages.
+ * This is the function to use in compaction config.
+ */
+export function estimateMessagesTokens(messages, config = {}) {
+    return messages.reduce((sum, msg) => sum + estimateMessageTokens(msg, config), 0);
+}
+/**
+ * Default configuration values (exported for documentation).
+ */
+export const DEFAULT_ESTIMATOR_CONFIG = {
+    charsPerToken: 4,
+    cjkMultiplier: 1.5,
+    messageOverhead: 10,
+    imageTokenCost: 85,
+    toolCallCost: 50,
+};
+//# sourceMappingURL=token-estimator.js.map

package/dist/lib/tool-registry.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Tool Registry for managing tool registration with conflict resolution.
+ * Implements priority-based registration: user > skill > mcp > builtin
+ */
+import type { Logger } from './logger';
+/** Tool source types in priority order */
+export type ToolSourceType = 'user' | 'skill' | 'mcp' | 'builtin';
+/** Tool source metadata */
+export interface ToolSource {
+    type: ToolSourceType;
+    namespace: string;
+}
+/** JSON Schema for tool parameters */
+export interface ToolParameters {
+    type: 'object';
+    properties: Record<string, unknown>;
+    required?: string[];
+}
+/** Tool execution context for registered tools */
+export interface RegisteredToolContext {
+    toolCallId: string;
+    messages: Array<{
+        role: string;
+        content: unknown;
+    }>;
+    abortSignal?: AbortSignal;
+}
+/** Registered tool definition */
+export interface RegisteredTool {
+    name: string;
+    description: string;
+    parameters: ToolParameters;
+    source: ToolSource;
+    execute?: (args: Record<string, unknown>, context?: RegisteredToolContext) => Promise<unknown>;
+}
+/** Conflict resolution strategy */
+export type ConflictStrategy = 'first-wins' | 'error';
+/** Tool registry configuration */
+export interface ToolRegistryConfig {
+    /** Sources to exclude from registration */
+    excludeSources?: string[];
+    /** Conflict resolution strategy (default: first-wins) */
+    conflictStrategy?: ConflictStrategy;
+    /** Logger instance */
+    logger?: Logger;
+}
+/** Tool conflict error */
+export declare class ToolConflictError extends Error {
+    readonly toolName: string;
+    readonly existingSource: string;
+    readonly newSource: string;
+    constructor(toolName: string, existingSource: string, newSource: string);
+}
+/**
+ * Tool Registry manages tool registration with deterministic conflict resolution.
+ */
+export declare class ToolRegistry {
+    private tools;
+    private readonly config;
+    private readonly logger;
+    constructor(config?: ToolRegistryConfig);
+    /**
+     * Register a tool with conflict detection.
+     * Tools are registered in priority order: user > skill > mcp > builtin
+     */
+    register(tool: RegisteredTool): boolean;
+    /**
+     * Register multiple tools from a source.
+     * Tools are sorted by name for deterministic order.
+     */
+    registerAll(tools: RegisteredTool[]): {
+        registered: number;
+        skipped: number;
+    };
+    /**
+     * Get a tool by name.
+     */
+    get(name: string): RegisteredTool | undefined;
+    /**
+     * Get all registered tools.
+     */
+    getAll(): RegisteredTool[];
+    /**
+     * Get tools as OpenAI-compatible format.
+     */
+    toOpenAITools(): Array<{
+        type: 'function';
+        function: {
+            name: string;
+            description: string;
+            parameters: ToolParameters;
+        };
+    }>;
+    /**
+     * Clear all registered tools.
+     */
+    clear(): void;
+    /**
+     * Check if a source should be excluded.
+     */
+    private isSourceExcluded;
+}
+//# sourceMappingURL=tool-registry.d.ts.map

package/dist/lib/tool-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../src/lib/tool-registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGvC,0CAA0C;AAC1C,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,SAAS,CAAC;AAKlE,2BAA2B;AAC3B,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,sCAAsC;AACtC,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,kDAAkD;AAClD,MAAM,WAAW,qBAAqB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACpD,WAAW,CAAC,EAAE,WAAW,CAAC;CAC7B;AAED,iCAAiC;AACjC,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,cAAc,CAAC;IAC3B,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,qBAAqB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAClG;AAED,mCAAmC;AACnC,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,OAAO,CAAC;AAEtD,kCAAkC;AAClC,MAAM,WAAW,kBAAkB;IAC/B,2CAA2C;IAC3C,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,yDAAyD;IACzD,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,0BAA0B;AAC1B,qBAAa,iBAAkB,SAAQ,KAAK;aAEpB,QAAQ,EAAE,MAAM;aAChB,cAAc,EAAE,MAAM;aACtB,SAAS,EAAE,MAAM;gBAFjB,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM;CAQxC;AAED;;GAEG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+B;IACtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,GAAE,kBAAuB;IAS3C;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO;IA0DvC;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAkB7E;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI7C;;OAEG;IACH,MAAM,IAAI,cAAc,EAAE;IAI1B;;OAEG;IACH,aAAa,IAAI,KAAK,CAAC;QACnB,IAAI,EAAE,UAAU,CAAC;QACjB,QAAQ,EAAE;YACN,IAAI,EAAE,MAAM,CAAC;YACb,WAAW,EAAE,MAAM,CAAC;YACpB,UAAU,EAAE,cAAc,CAAC;SAC9B,CAAC;KACL,CAAC;IAWF;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAW3B"}

package/dist/lib/tool-registry.js

@@ -0,0 +1,159 @@
+"use strict";
+/**
+ * Tool Registry for managing tool registration with conflict resolution.
+ * Implements priority-based registration: user > skill > mcp > builtin
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolRegistry = exports.ToolConflictError = void 0;
+const logger_1 = require("./logger");
+/** Priority order (lower index = higher priority) */
+const SOURCE_PRIORITY = ['user', 'skill', 'mcp', 'builtin'];
+/** Tool conflict error */
+class ToolConflictError extends Error {
+    constructor(toolName, existingSource, newSource) {
+        super(`Tool "${toolName}" conflict: ${existingSource} vs ${newSource}. ` +
+            `Exclude one source in your config.`);
+        this.toolName = toolName;
+        this.existingSource = existingSource;
+        this.newSource = newSource;
+        this.name = 'ToolConflictError';
+    }
+}
+exports.ToolConflictError = ToolConflictError;
+/**
+ * Tool Registry manages tool registration with deterministic conflict resolution.
+ */
+class ToolRegistry {
+    constructor(config = {}) {
+        this.tools = new Map();
+        this.config = {
+            excludeSources: config.excludeSources ?? [],
+            conflictStrategy: config.conflictStrategy ?? 'first-wins',
+            logger: config.logger ?? logger_1.noopLogger,
+        };
+        this.logger = this.config.logger;
+    }
+    /**
+     * Register a tool with conflict detection.
+     * Tools are registered in priority order: user > skill > mcp > builtin
+     */
+    register(tool) {
+        const fullSource = `${tool.source.type}:${tool.source.namespace}`;
+        // Check if source is excluded
+        if (this.isSourceExcluded(fullSource, tool.source)) {
+            this.logger.debug('Tool source excluded', {
+                tool: tool.name,
+                source: fullSource,
+            });
+            return false;
+        }
+        // Check for existing tool with same name
+        const existing = this.tools.get(tool.name);
+        if (existing) {
+            const existingSource = `${existing.source.type}:${existing.source.namespace}`;
+            // Same source = update
+            if (existingSource === fullSource) {
+                this.tools.set(tool.name, tool);
+                return true;
+            }
+            // Different source = conflict
+            if (this.config.conflictStrategy === 'error') {
+                throw new ToolConflictError(tool.name, existingSource, fullSource);
+            }
+            // first-wins: compare priority
+            const existingPriority = SOURCE_PRIORITY.indexOf(existing.source.type);
+            const newPriority = SOURCE_PRIORITY.indexOf(tool.source.type);
+            if (newPriority < existingPriority) {
+                // New tool has higher priority, replace
+                this.logger.warn('Tool replaced due to higher priority', {
+                    tool: tool.name,
+                    replaced: existingSource,
+                    by: fullSource,
+                });
+                this.tools.set(tool.name, tool);
+                return true;
+            }
+            else {
+                // Existing tool has higher or equal priority, keep
+                this.logger.warn('Tool registration skipped due to conflict', {
+                    tool: tool.name,
+                    kept: existingSource,
+                    skipped: fullSource,
+                });
+                return false;
+            }
+        }
+        // No conflict, register
+        this.tools.set(tool.name, tool);
+        return true;
+    }
+    /**
+     * Register multiple tools from a source.
+     * Tools are sorted by name for deterministic order.
+     */
+    registerAll(tools) {
+        // Sort by name for deterministic registration order
+        const sorted = [...tools].sort((a, b) => a.name.localeCompare(b.name));
+        let registered = 0;
+        let skipped = 0;
+        for (const tool of sorted) {
+            if (this.register(tool)) {
+                registered++;
+            }
+            else {
+                skipped++;
+            }
+        }
+        return { registered, skipped };
+    }
+    /**
+     * Get a tool by name.
+     */
+    get(name) {
+        return this.tools.get(name);
+    }
+    /**
+     * Get all registered tools.
+     */
+    getAll() {
+        return Array.from(this.tools.values());
+    }
+    /**
+     * Get tools as OpenAI-compatible format.
+     */
+    toOpenAITools() {
+        return this.getAll().map(tool => ({
+            type: 'function',
+            function: {
+                name: tool.name,
+                description: tool.description,
+                parameters: tool.parameters,
+            },
+        }));
+    }
+    /**
+     * Clear all registered tools.
+     */
+    clear() {
+        this.tools.clear();
+    }
+    /**
+     * Check if a source should be excluded.
+     */
+    isSourceExcluded(fullSource, source) {
+        return this.config.excludeSources.some(pattern => {
+            // Match full source (e.g., 'mcp:github')
+            if (pattern === fullSource)
+                return true;
+            // Match type only (e.g., 'mcp')
+            if (pattern === source.type)
+                return true;
+            // Match namespace pattern (e.g., 'mcp:*')
+            if (pattern.endsWith(':*') && pattern.slice(0, -2) === source.type)
+                return true;
+            return false;
+        });
+    }
+}
+exports.ToolRegistry = ToolRegistry;
+//# sourceMappingURL=tool-registry.js.map

package/dist/lib/tool-registry.js.map

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