@bowenqt/qiniu-ai-sdk 0.10.0 → 0.14.0

package/dist/lib/tool-registry.mjs

@@ -0,0 +1,154 @@
+/**
+ * Tool Registry for managing tool registration with conflict resolution.
+ * Implements priority-based registration: user > skill > mcp > builtin
+ */
+import { noopLogger } from './logger.mjs';
+/** Priority order (lower index = higher priority) */
+const SOURCE_PRIORITY = ['user', 'skill', 'mcp', 'builtin'];
+/** Tool conflict error */
+export 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';
+    }
+}
+/**
+ * Tool Registry manages tool registration with deterministic conflict resolution.
+ */
+export class ToolRegistry {
+    constructor(config = {}) {
+        this.tools = new Map();
+        this.config = {
+            excludeSources: config.excludeSources ?? [],
+            conflictStrategy: config.conflictStrategy ?? 'first-wins',
+            logger: config.logger ?? 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;
+        });
+    }
+}
+//# sourceMappingURL=tool-registry.js.map

package/dist/lib/tracer.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Tracer abstraction for observability.
+ * Provides pluggable tracing with PII redaction and configurable recording levels.
+ *
+ * Default: recordPrompts=true (development friendly)
+ * Production: Use PRODUCTION_TRACER_CONFIG for safety
+ */
+/** Span interface */
+export interface Span {
+    /** Set a string attribute */
+    setAttribute(key: string, value: string | number | boolean): void;
+    /** Set multiple attributes */
+    setAttributes(attributes: Record<string, string | number | boolean>): void;
+    /** Record an error */
+    recordException(error: Error): void;
+    /** Add an event */
+    addEvent(name: string, attributes?: Record<string, string | number | boolean>): void;
+    /** End the span */
+    end(): void;
+}
+/** Tracer configuration */
+export interface TracerConfig {
+    /** Record prompt content (default: true) */
+    recordPrompts?: boolean;
+    /** Record response content (default: true) */
+    recordResponses?: boolean;
+    /** Record tool arguments (default: true) */
+    recordToolArgs?: boolean;
+    /** Maximum content length before truncation (default: 1000) */
+    maxContentLength?: number;
+    /** Sensitive keys to mask (default: ['password', 'apiKey', 'token', 'secret']) */
+    sensitiveKeys?: string[];
+}
+/** Tracer interface */
+export interface Tracer {
+    /** Start a new span */
+    startSpan(name: string, attributes?: Record<string, string | number | boolean>): Span;
+    /** Execute a function within a span */
+    withSpan<T>(name: string, fn: (span: Span) => Promise<T> | T): Promise<T>;
+    /** Get the tracer config */
+    getConfig(): TracerConfig;
+}
+/** Default configuration (development friendly) */
+export declare const DEFAULT_TRACER_CONFIG: Required<TracerConfig>;
+/** Production configuration (safety first) */
+export declare const PRODUCTION_TRACER_CONFIG: TracerConfig;
+/**
+ * Redact sensitive information from content.
+ * Strategy: truncate first, then regex mask.
+ */
+export declare function redactContent(content: string, config?: TracerConfig): string;
+/**
+ * Redact attributes based on config.
+ */
+export declare function redactAttributes(attributes: Record<string, unknown>, config?: TracerConfig): Record<string, string | number | boolean>;
+/**
+ * No-op tracer (default when no tracing configured).
+ */
+export declare class NoopTracer implements Tracer {
+    private readonly config;
+    constructor(config?: TracerConfig);
+    startSpan(_name: string, _attributes?: Record<string, string | number | boolean>): Span;
+    withSpan<T>(name: string, fn: (span: Span) => Promise<T> | T): Promise<T>;
+    getConfig(): TracerConfig;
+}
+/**
+ * Console tracer for development/debugging.
+ * Logs span events to console.
+ */
+export declare class ConsoleTracer implements Tracer {
+    private readonly config;
+    constructor(config?: TracerConfig);
+    startSpan(name: string, attributes?: Record<string, string | number | boolean>): Span;
+    withSpan<T>(name: string, fn: (span: Span) => Promise<T> | T): Promise<T>;
+    getConfig(): TracerConfig;
+}
+/**
+ * Set the global tracer.
+ */
+export declare function setGlobalTracer(tracer: Tracer): void;
+/**
+ * Get the global tracer.
+ */
+export declare function getGlobalTracer(): Tracer;
+//# sourceMappingURL=tracer.d.ts.map

package/dist/lib/tracer.d.ts.map

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

package/dist/lib/tracer.js

@@ -0,0 +1,170 @@
+"use strict";
+/**
+ * Tracer abstraction for observability.
+ * Provides pluggable tracing with PII redaction and configurable recording levels.
+ *
+ * Default: recordPrompts=true (development friendly)
+ * Production: Use PRODUCTION_TRACER_CONFIG for safety
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConsoleTracer = exports.NoopTracer = exports.PRODUCTION_TRACER_CONFIG = exports.DEFAULT_TRACER_CONFIG = void 0;
+exports.redactContent = redactContent;
+exports.redactAttributes = redactAttributes;
+exports.setGlobalTracer = setGlobalTracer;
+exports.getGlobalTracer = getGlobalTracer;
+/** Default configuration (development friendly) */
+exports.DEFAULT_TRACER_CONFIG = {
+    recordPrompts: true,
+    recordResponses: true,
+    recordToolArgs: true,
+    maxContentLength: 1000,
+    sensitiveKeys: ['password', 'apiKey', 'token', 'secret', 'authorization'],
+};
+/** Production configuration (safety first) */
+exports.PRODUCTION_TRACER_CONFIG = {
+    recordPrompts: false,
+    recordResponses: false,
+    recordToolArgs: false,
+    maxContentLength: 200,
+};
+/**
+ * Redact sensitive information from content.
+ * Strategy: truncate first, then regex mask.
+ */
+function redactContent(content, config = exports.DEFAULT_TRACER_CONFIG) {
+    const maxLen = config.maxContentLength ?? exports.DEFAULT_TRACER_CONFIG.maxContentLength;
+    const sensitiveKeys = config.sensitiveKeys ?? exports.DEFAULT_TRACER_CONFIG.sensitiveKeys;
+    // Step 1: Truncate
+    let result = content;
+    if (result.length > maxLen) {
+        result = result.substring(0, maxLen) + `... [truncated ${content.length - maxLen} chars]`;
+    }
+    // Step 2: Mask sensitive keys
+    for (const key of sensitiveKeys) {
+        const regex = new RegExp(`("${key}"\\s*:\\s*)"[^"]*"`, 'gi');
+        result = result.replace(regex, '$1"[REDACTED]"');
+    }
+    return result;
+}
+/**
+ * Redact attributes based on config.
+ */
+function redactAttributes(attributes, config = exports.DEFAULT_TRACER_CONFIG) {
+    const sensitiveKeys = config.sensitiveKeys ?? exports.DEFAULT_TRACER_CONFIG.sensitiveKeys;
+    const result = {};
+    for (const [key, value] of Object.entries(attributes)) {
+        const lowerKey = key.toLowerCase();
+        const isSensitive = sensitiveKeys.some(sk => lowerKey.includes(sk.toLowerCase()));
+        if (isSensitive) {
+            result[key] = '[REDACTED]';
+        }
+        else if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
+            result[key] = value;
+        }
+        else if (typeof value === 'object') {
+            result[key] = JSON.stringify(value).substring(0, 100);
+        }
+        else {
+            result[key] = String(value);
+        }
+    }
+    return result;
+}
+/**
+ * No-op span (for NoopTracer).
+ */
+class NoopSpan {
+    setAttribute(_key, _value) { }
+    setAttributes(_attributes) { }
+    recordException(_error) { }
+    addEvent(_name, _attributes) { }
+    end() { }
+}
+/**
+ * No-op tracer (default when no tracing configured).
+ */
+class NoopTracer {
+    constructor(config = {}) {
+        this.config = { ...exports.DEFAULT_TRACER_CONFIG, ...config };
+    }
+    startSpan(_name, _attributes) {
+        return new NoopSpan();
+    }
+    async withSpan(name, fn) {
+        const span = this.startSpan(name);
+        try {
+            return await fn(span);
+        }
+        finally {
+            span.end();
+        }
+    }
+    getConfig() {
+        return this.config;
+    }
+}
+exports.NoopTracer = NoopTracer;
+/**
+ * Console tracer for development/debugging.
+ * Logs span events to console.
+ */
+class ConsoleTracer {
+    constructor(config = {}) {
+        this.config = { ...exports.DEFAULT_TRACER_CONFIG, ...config };
+    }
+    startSpan(name, attributes) {
+        const startTime = Date.now();
+        console.log(`[TRACE] START: ${name}`, attributes ? redactAttributes(attributes, this.config) : '');
+        return {
+            setAttribute: (key, value) => {
+                console.log(`[TRACE] ATTR: ${name}.${key} =`, value);
+            },
+            setAttributes: (attrs) => {
+                console.log(`[TRACE] ATTRS: ${name}`, redactAttributes(attrs, this.config));
+            },
+            recordException: (error) => {
+                console.error(`[TRACE] ERROR: ${name}`, error.message);
+            },
+            addEvent: (eventName, eventAttrs) => {
+                console.log(`[TRACE] EVENT: ${name}.${eventName}`, eventAttrs || '');
+            },
+            end: () => {
+                const duration = Date.now() - startTime;
+                console.log(`[TRACE] END: ${name} (${duration}ms)`);
+            },
+        };
+    }
+    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;
+    }
+}
+exports.ConsoleTracer = ConsoleTracer;
+/** Global tracer instance */
+let globalTracer = new NoopTracer();
+/**
+ * Set the global tracer.
+ */
+function setGlobalTracer(tracer) {
+    globalTracer = tracer;
+}
+/**
+ * Get the global tracer.
+ */
+function getGlobalTracer() {
+    return globalTracer;
+}
+//# sourceMappingURL=tracer.js.map

package/dist/lib/tracer.js.map

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

package/dist/lib/tracer.mjs

@@ -0,0 +1,161 @@
+/**
+ * Tracer abstraction for observability.
+ * Provides pluggable tracing with PII redaction and configurable recording levels.
+ *
+ * Default: recordPrompts=true (development friendly)
+ * Production: Use PRODUCTION_TRACER_CONFIG for safety
+ */
+/** Default configuration (development friendly) */
+export const DEFAULT_TRACER_CONFIG = {
+    recordPrompts: true,
+    recordResponses: true,
+    recordToolArgs: true,
+    maxContentLength: 1000,
+    sensitiveKeys: ['password', 'apiKey', 'token', 'secret', 'authorization'],
+};
+/** Production configuration (safety first) */
+export const PRODUCTION_TRACER_CONFIG = {
+    recordPrompts: false,
+    recordResponses: false,
+    recordToolArgs: false,
+    maxContentLength: 200,
+};
+/**
+ * Redact sensitive information from content.
+ * Strategy: truncate first, then regex mask.
+ */
+export function redactContent(content, config = DEFAULT_TRACER_CONFIG) {
+    const maxLen = config.maxContentLength ?? DEFAULT_TRACER_CONFIG.maxContentLength;
+    const sensitiveKeys = config.sensitiveKeys ?? DEFAULT_TRACER_CONFIG.sensitiveKeys;
+    // Step 1: Truncate
+    let result = content;
+    if (result.length > maxLen) {
+        result = result.substring(0, maxLen) + `... [truncated ${content.length - maxLen} chars]`;
+    }
+    // Step 2: Mask sensitive keys
+    for (const key of sensitiveKeys) {
+        const regex = new RegExp(`("${key}"\\s*:\\s*)"[^"]*"`, 'gi');
+        result = result.replace(regex, '$1"[REDACTED]"');
+    }
+    return result;
+}
+/**
+ * Redact attributes based on config.
+ */
+export function redactAttributes(attributes, config = DEFAULT_TRACER_CONFIG) {
+    const sensitiveKeys = config.sensitiveKeys ?? DEFAULT_TRACER_CONFIG.sensitiveKeys;
+    const result = {};
+    for (const [key, value] of Object.entries(attributes)) {
+        const lowerKey = key.toLowerCase();
+        const isSensitive = sensitiveKeys.some(sk => lowerKey.includes(sk.toLowerCase()));
+        if (isSensitive) {
+            result[key] = '[REDACTED]';
+        }
+        else if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
+            result[key] = value;
+        }
+        else if (typeof value === 'object') {
+            result[key] = JSON.stringify(value).substring(0, 100);
+        }
+        else {
+            result[key] = String(value);
+        }
+    }
+    return result;
+}
+/**
+ * No-op span (for NoopTracer).
+ */
+class NoopSpan {
+    setAttribute(_key, _value) { }
+    setAttributes(_attributes) { }
+    recordException(_error) { }
+    addEvent(_name, _attributes) { }
+    end() { }
+}
+/**
+ * No-op tracer (default when no tracing configured).
+ */
+export class NoopTracer {
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_TRACER_CONFIG, ...config };
+    }
+    startSpan(_name, _attributes) {
+        return new NoopSpan();
+    }
+    async withSpan(name, fn) {
+        const span = this.startSpan(name);
+        try {
+            return await fn(span);
+        }
+        finally {
+            span.end();
+        }
+    }
+    getConfig() {
+        return this.config;
+    }
+}
+/**
+ * Console tracer for development/debugging.
+ * Logs span events to console.
+ */
+export class ConsoleTracer {
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_TRACER_CONFIG, ...config };
+    }
+    startSpan(name, attributes) {
+        const startTime = Date.now();
+        console.log(`[TRACE] START: ${name}`, attributes ? redactAttributes(attributes, this.config) : '');
+        return {
+            setAttribute: (key, value) => {
+                console.log(`[TRACE] ATTR: ${name}.${key} =`, value);
+            },
+            setAttributes: (attrs) => {
+                console.log(`[TRACE] ATTRS: ${name}`, redactAttributes(attrs, this.config));
+            },
+            recordException: (error) => {
+                console.error(`[TRACE] ERROR: ${name}`, error.message);
+            },
+            addEvent: (eventName, eventAttrs) => {
+                console.log(`[TRACE] EVENT: ${name}.${eventName}`, eventAttrs || '');
+            },
+            end: () => {
+                const duration = Date.now() - startTime;
+                console.log(`[TRACE] END: ${name} (${duration}ms)`);
+            },
+        };
+    }
+    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;
+    }
+}
+/** Global tracer instance */
+let globalTracer = new NoopTracer();
+/**
+ * Set the global tracer.
+ */
+export function setGlobalTracer(tracer) {
+    globalTracer = tracer;
+}
+/**
+ * Get the global tracer.
+ */
+export function getGlobalTracer() {
+    return globalTracer;
+}
+//# sourceMappingURL=tracer.js.map

package/dist/lib/types.d.ts

@@ -120,4 +120,15 @@ export interface IQiniuClient {
     getLogger(): Logger;
     getBaseUrl(): string;
 }
+/** Compaction info returned in GenerateTextResult */
+export interface CompactionInfo {
+    /** Whether compaction occurred */
+    occurred: boolean;
+    /** Skills dropped during compaction */
+    droppedSkills: string[];
+    /** Number of messages dropped */
+    droppedMessages: number;
+    /** Recommendation for reducing context */
+    recommendation?: string;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/lib/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,QAAQ,EAAE,CAAC;IACxB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE;QACR,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;KACpC,CAAC;CACL;AAED,MAAM,WAAW,QAAQ;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACrB,CAAC;CACL;AAED,MAAM,WAAW,qBAAqB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE;QACJ,IAAI,EAAE,UAAU,CAAC;QACjB,QAAQ,EAAE;YACN,IAAI,EAAE,MAAM,CAAC;YACb,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;SACnC,CAAC;KACL,EAAE,CAAC;IACJ,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,QAAQ,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IACjF,6CAA6C;IAC7C,eAAe,CAAC,EAAE,cAAc,CAAC;CACpC;AAED,0DAA0D;AAC1D,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,aAAa,CAAC;IAC7C,WAAW,CAAC,EAAE;QACV,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,CAAC;CACL;AAED,MAAM,WAAW,sBAAsB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE;QACL,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,WAAW,CAAC;QACrB,aAAa,EAAE,MAAM,GAAG,QAAQ,GAAG,YAAY,GAAG,gBAAgB,GAAG,IAAI,CAAC;KAC7E,EAAE,CAAC;IACJ,KAAK,CAAC,EAAE;QACJ,aAAa,EAAE,MAAM,CAAC;QACtB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,YAAY,EAAE,MAAM,CAAC;KACxB,CAAC;CACL;AAGD,MAAM,WAAW,aAAa;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,QAAQ,CAAC,EAAE;QACP,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACL;AAED,MAAM,WAAW,SAAS;IACtB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,mBAAmB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,uBAAuB,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE;QACL,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,SAAS,CAAC;QACjB,aAAa,EAAE,MAAM,GAAG,QAAQ,GAAG,YAAY,GAAG,gBAAgB,GAAG,IAAI,CAAC;KAC7E,EAAE,CAAC;IACJ,KAAK,CAAC,EAAE;QACJ,aAAa,EAAE,MAAM,CAAC;QACtB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,YAAY,EAAE,MAAM,CAAC;KACxB,CAAC;CACL;AAED,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD,MAAM,WAAW,YAAY;IACzB,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACnG,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACpH,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxI,SAAS,IAAI,MAAM,CAAC;IACpB,UAAU,IAAI,MAAM,CAAC;CACxB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"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"}

package/dist/modules/mcp/adapter.d.ts

@@ -0,0 +1,23 @@
+/**
+ * MCP Tool Adapter - converts MCP tools to SDK RegisteredTool format.
+ */
+import type { MCPToolDefinition } from './types';
+import type { RegisteredTool } from '../../lib/tool-registry';
+import type { MCPClient } from './client';
+/**
+ * Convert MCP tools to SDK RegisteredTool format.
+ * Sorted by name for deterministic registration order.
+ */
+export declare function adaptMCPToolsToRegistry(tools: MCPToolDefinition[], serverName: string, client: MCPClient): RegisteredTool[];
+/**
+ * Get all tools from a specific MCP server.
+ * Each server maintains its own tool list.
+ */
+export declare function getServerTools(client: MCPClient, serverName: string): RegisteredTool[];
+/**
+ * Get all tools from all connected MCP servers.
+ * Tools are collected per-server and concatenated; actual deduplication
+ * happens in ToolRegistry via priority/conflict resolution.
+ */
+export declare function getAllMCPToolsAsRegistered(client: MCPClient): RegisteredTool[];
+//# sourceMappingURL=adapter.d.ts.map

package/dist/modules/mcp/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/modules/mcp/adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,yBAAyB,CAAC;AAC1E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C;;;GAGG;AACH,wBAAgB,uBAAuB,CACnC,KAAK,EAAE,iBAAiB,EAAE,EAC1B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,SAAS,GAClB,cAAc,EAAE,CA6BlB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC1B,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,MAAM,GACnB,cAAc,EAAE,CAGlB;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACtC,MAAM,EAAE,SAAS,GAClB,cAAc,EAAE,CAalB"}