@vfarcic/dot-ai 0.192.0 → 0.194.0

package/dist/core/telemetry/types.d.ts

@@ -0,0 +1,125 @@
+/**
+ * PostHog Telemetry Type Definitions
+ *
+ * Defines types for anonymous usage telemetry.
+ */
+/**
+ * Telemetry configuration loaded from environment
+ */
+export interface TelemetryConfig {
+    /** Whether telemetry is enabled (default: true, can be disabled via DOT_AI_TELEMETRY=false) */
+    enabled: boolean;
+    /** PostHog API key (public, safe to expose) */
+    posthogKey: string;
+    /** PostHog host URL */
+    posthogHost: string;
+    /** dot-ai version from package.json */
+    dotAiVersion: string;
+    /** AI provider being used */
+    aiProvider: string;
+    /** Enable debug logging */
+    debug: boolean;
+}
+/**
+ * Base properties included in all telemetry events
+ */
+export interface BaseEventProperties {
+    /** dot-ai version */
+    dot_ai_version: string;
+    /** AI provider (anthropic, openai, etc.) */
+    ai_provider: string;
+    /** Whether this is an internal/test instance (for PostHog filtering) */
+    is_internal: boolean;
+}
+/**
+ * Properties for tool_executed event
+ */
+export interface ToolExecutedEventProperties extends BaseEventProperties {
+    /** Name of the tool that was executed */
+    tool: string;
+    /** Whether the execution was successful */
+    success: boolean;
+    /** Execution duration in milliseconds */
+    duration_ms: number;
+    /** MCP client name (e.g., "claude-code", "cursor") */
+    mcp_client?: string;
+    /** MCP client version */
+    mcp_client_version?: string;
+}
+/**
+ * Properties for tool_error event
+ */
+export interface ToolErrorEventProperties extends BaseEventProperties {
+    /** Name of the tool that errored */
+    tool: string;
+    /** Error type/class name (not the message, for privacy) */
+    error_type: string;
+    /** MCP client name (e.g., "claude-code", "cursor") */
+    mcp_client?: string;
+    /** MCP client version */
+    mcp_client_version?: string;
+}
+/**
+ * Properties for client_connected event
+ */
+export interface ClientConnectedEventProperties extends BaseEventProperties {
+    /** MCP client name (e.g., "claude-code", "cursor", "windsurf") */
+    mcp_client: string;
+    /** MCP client version */
+    mcp_client_version: string;
+    /** Transport type (stdio, http) */
+    transport: string;
+}
+/**
+ * Properties for server_started event
+ */
+export interface ServerStartedEventProperties extends BaseEventProperties {
+    /** Kubernetes version if available */
+    k8s_version?: string;
+    /** Deployment method (helm, docker, local) */
+    deployment_method?: string;
+}
+/**
+ * Properties for server_stopped event
+ */
+export interface ServerStoppedEventProperties extends BaseEventProperties {
+    /** Server uptime in seconds */
+    uptime_seconds: number;
+}
+/**
+ * Union of all event property types
+ */
+export type TelemetryEventProperties = ToolExecutedEventProperties | ToolErrorEventProperties | ServerStartedEventProperties | ServerStoppedEventProperties | ClientConnectedEventProperties;
+/**
+ * Telemetry event names
+ */
+export type TelemetryEventName = 'tool_executed' | 'tool_error' | 'server_started' | 'server_stopped' | 'client_connected';
+/**
+ * MCP client info for telemetry
+ */
+export interface McpClientInfo {
+    name: string;
+    version: string;
+}
+/**
+ * Telemetry service interface
+ */
+export interface TelemetryService {
+    /** Check if telemetry is enabled */
+    isEnabled(): boolean;
+    /** Track a telemetry event */
+    trackEvent(event: TelemetryEventName, properties: TelemetryEventProperties): void;
+    /** Track tool execution */
+    trackToolExecution(tool: string, success: boolean, durationMs: number, mcpClient?: McpClientInfo): void;
+    /** Track tool error */
+    trackToolError(tool: string, errorType: string, mcpClient?: McpClientInfo): void;
+    /** Track server start */
+    trackServerStart(k8sVersion?: string, deploymentMethod?: string): void;
+    /** Track server stop */
+    trackServerStop(uptimeSeconds: number): void;
+    /** Track MCP client connection */
+    trackClientConnected(mcpClient: McpClientInfo, transport: string): void;
+    /** Flush pending events and shutdown */
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/telemetry/types.d.ts.map

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

package/dist/core/telemetry/types.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * PostHog Telemetry Type Definitions
+ *
+ * Defines types for anonymous usage telemetry.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/core/tracing/index.d.ts

@@ -7,7 +7,7 @@ export * from './types';
 export * from './config';
 export { getTracer, shutdownTracer, withSpan } from './tracer';
 export { createHttpServerSpan, withHttpServerTracing } from './http-tracing';
-export { withToolTracing } from './tool-tracing';
+export { withToolTracing, ToolTracingOptions } from './tool-tracing';
 export { withAITracing } from './ai-tracing';
 export { createTracedK8sClient, withKubectlTracing } from './k8s-tracing';
 export { withQdrantTracing } from './qdrant-tracing';

package/dist/core/tracing/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/tracing/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/tracing/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/core/tracing/tool-tracing.d.ts

@@ -6,6 +6,14 @@
  *
  * Supports both STDIO (MCP) and HTTP (REST) transports transparently.
  */
+import { McpClientInfo } from '../telemetry';
+/**
+ * Options for tool tracing
+ */
+export interface ToolTracingOptions {
+    /** MCP client info for telemetry attribution */
+    mcpClient?: McpClientInfo;
+}
 /**
  * Wraps a tool handler with OpenTelemetry tracing
  *
@@ -18,14 +26,15 @@
  * @param toolName - Name of the MCP tool being executed
  * @param args - Tool input arguments (will be serialized to JSON)
  * @param handler - Async function that implements the tool logic
+ * @param options - Optional tracing options (e.g., MCP client info)
  * @returns Promise resolving to the tool handler result
  *
  * @example
  * ```typescript
  * const result = await withToolTracing('recommend', { intent: 'deploy postgres' }, async (args) => {
  *   return await handleRecommendTool(args);
- * });
+ * }, { mcpClient: { name: 'claude-code', version: '1.0.0' } });
  * ```
  */
-export declare function withToolTracing<T>(toolName: string, args: any, handler: (args: any) => Promise<T>): Promise<T>;
+export declare function withToolTracing<T>(toolName: string, args: any, handler: (args: any) => Promise<T>, options?: ToolTracingOptions): Promise<T>;
 //# sourceMappingURL=tool-tracing.d.ts.map

package/dist/core/tracing/tool-tracing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-tracing.d.ts","sourceRoot":"","sources":["../../../src/core/tracing/tool-tracing.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,eAAe,CAAC,CAAC,EACrC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,GAAG,EACT,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,GACjC,OAAO,CAAC,CAAC,CAAC,CAgDZ"}
+{"version":3,"file":"tool-tracing.d.ts","sourceRoot":"","sources":["../../../src/core/tracing/tool-tracing.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAgB,aAAa,EAAE,MAAM,cAAc,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gDAAgD;IAChD,SAAS,CAAC,EAAE,aAAa,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,eAAe,CAAC,CAAC,EACrC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,GAAG,EACT,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,EAClC,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,CAAC,CAAC,CA+DZ"}

package/dist/core/tracing/tool-tracing.js

@@ -10,6 +10,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.withToolTracing = withToolTracing;
 const api_1 = require("@opentelemetry/api");
+const telemetry_1 = require("../telemetry");
 /**
  * Wraps a tool handler with OpenTelemetry tracing
  *
@@ -22,16 +23,17 @@ const api_1 = require("@opentelemetry/api");
  * @param toolName - Name of the MCP tool being executed
  * @param args - Tool input arguments (will be serialized to JSON)
  * @param handler - Async function that implements the tool logic
+ * @param options - Optional tracing options (e.g., MCP client info)
  * @returns Promise resolving to the tool handler result
  *
  * @example
  * ```typescript
  * const result = await withToolTracing('recommend', { intent: 'deploy postgres' }, async (args) => {
  *   return await handleRecommendTool(args);
- * });
+ * }, { mcpClient: { name: 'claude-code', version: '1.0.0' } });
  * ```
  */
-async function withToolTracing(toolName, args, handler) {
+async function withToolTracing(toolName, args, handler, options) {
     const tracer = api_1.trace.getTracer('dot-ai-mcp');
     // Create INTERNAL span for tool execution
     // Using INTERNAL kind since this is business logic within the server process
@@ -41,13 +43,18 @@ async function withToolTracing(toolName, args, handler) {
             // GenAI semantic conventions for tool execution
             'gen_ai.tool.name': toolName,
             'gen_ai.tool.input': JSON.stringify(args, null, 2),
+            // MCP client info (if available)
+            ...(options?.mcpClient && {
+                'mcp.client.name': options.mcpClient.name,
+                'mcp.client.version': options.mcpClient.version,
+            }),
         },
     });
     // Execute handler within active span context
     // This ensures any child spans (AI calls, K8s operations) become children of this span
     return await api_1.context.with(api_1.trace.setSpan(api_1.context.active(), span), async () => {
+        const startTime = Date.now();
         try {
-            const startTime = Date.now();
             const result = await handler(args);
             const duration = Date.now() - startTime;
             // Record success metrics
@@ -56,15 +63,22 @@ async function withToolTracing(toolName, args, handler) {
                 'gen_ai.tool.success': true,
             });
             span.setStatus({ code: api_1.SpanStatusCode.OK });
+            // Track telemetry (fire-and-forget, async)
+            (0, telemetry_1.getTelemetry)().trackToolExecution(toolName, true, duration, options?.mcpClient);
             return result;
         }
         catch (error) {
+            const duration = Date.now() - startTime;
+            const errorType = error.constructor?.name || 'Error';
             // Record error details without disrupting original error flow
             span.recordException(error);
             span.setStatus({
                 code: api_1.SpanStatusCode.ERROR,
                 message: error.message,
             });
+            // Track telemetry for failed execution (fire-and-forget, async)
+            (0, telemetry_1.getTelemetry)().trackToolExecution(toolName, false, duration, options?.mcpClient);
+            (0, telemetry_1.getTelemetry)().trackToolError(toolName, errorType, options?.mcpClient);
             // Re-throw to preserve original error handling behavior
             throw error;
         }

package/dist/core/vector-db-service.d.ts

@@ -21,6 +21,7 @@ export interface SearchResult {
 export interface SearchOptions {
     limit?: number;
     scoreThreshold?: number;
+    filter?: Record<string, any>;
 }
 export declare class VectorDBService {
     private client;
@@ -29,6 +30,10 @@ export declare class VectorDBService {
     constructor(config?: VectorDBConfig);
     private validateConfig;
     private shouldInitializeClient;
+    /**
+     * Check if collection exists without creating it
+     */
+    collectionExists(): Promise<boolean>;
     /**
      * Initialize the collection if it doesn't exist
      */
@@ -68,11 +73,13 @@ export declare class VectorDBService {
      * Scroll documents with Qdrant filter
      * @param filter - Qdrant filter object (must/should/must_not conditions)
      * @param limit - Maximum documents to retrieve
+     * Uses semaphore to limit concurrent Qdrant operations
      */
     scrollWithFilter(filter: any, limit?: number): Promise<VectorDocument[]>;
     /**
      * Get all documents (for listing)
      * @param limit - Maximum number of documents to retrieve. Defaults to unlimited (10000).
+     * Uses semaphore to limit concurrent Qdrant operations
      */
     getAllDocuments(limit?: number): Promise<VectorDocument[]>;
     /**

package/dist/core/vector-db-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vector-db-service.d.ts","sourceRoot":"","sources":["../../src/core/vector-db-service.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,cAAc,CAAS;gBAEnB,MAAM,GAAE,cAAmB;IAsBvC,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,sBAAsB;IAM9B;;OAEG;IACG,oBAAoB,CAAC,UAAU,GAAE,MAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAiDnE;;;OAGG;YACW,gBAAgB;IAgC9B;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAqC7D;;OAEG;IACG,aAAa,CACjB,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,EAAE,CAAC;IAsC1B;;OAEG;IACG,gBAAgB,CACpB,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,EAAE,CAAC;IAuD1B;;OAEG;IACG,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAqC7D;;OAEG;IACG,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B/C;;;;OAIG;IACG,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAuCzC;;;;OAIG;IACG,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,GAAE,MAAY,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAgCnF;;;OAGG;IACG,eAAe,CAAC,KAAK,GAAE,MAAc,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAyCvE;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,GAAG,CAAC;IAqBvC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAsBrC;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,SAAS,IAAI,cAAc;CAG5B"}
+{"version":3,"file":"vector-db-service.d.ts","sourceRoot":"","sources":["../../src/core/vector-db-service.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAgDH,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9B;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,cAAc,CAAS;gBAEnB,MAAM,GAAE,cAAmB;IAsBvC,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,sBAAsB;IAM9B;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC;IAa1C;;OAEG;IACG,oBAAoB,CAAC,UAAU,GAAE,MAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAiDnE;;;OAGG;YACW,gBAAgB;IAgC9B;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAqC7D;;OAEG;IACG,aAAa,CACjB,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,EAAE,CAAC;IAuC1B;;OAEG;IACG,gBAAgB,CACpB,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,EAAE,CAAC;IA0F1B;;OAEG;IACG,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAqC7D;;OAEG;IACG,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B/C;;;;OAIG;IACG,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAuCzC;;;;;OAKG;IACG,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,GAAE,MAAY,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAuCnF;;;;OAIG;IACG,eAAe,CAAC,KAAK,GAAE,MAAc,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAgDvE;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,GAAG,CAAC;IAqBvC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAsBrC;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,SAAS,IAAI,cAAc;CAG5B"}

package/dist/core/vector-db-service.js

@@ -8,6 +8,44 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.VectorDBService = void 0;
 const js_client_rest_1 = require("@qdrant/js-client-rest");
 const qdrant_tracing_1 = require("./tracing/qdrant-tracing");
+/**
+ * Escape special regex characters to prevent ReDoS attacks
+ */
+function escapeRegExp(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * Simple semaphore to limit concurrent Qdrant operations
+ * Prevents overwhelming Qdrant with too many parallel requests
+ */
+class QdrantSemaphore {
+    maxConcurrent;
+    currentCount = 0;
+    waitQueue = [];
+    constructor(maxConcurrent = 20) {
+        this.maxConcurrent = maxConcurrent;
+    }
+    async acquire() {
+        if (this.currentCount < this.maxConcurrent) {
+            this.currentCount++;
+            return;
+        }
+        return new Promise((resolve) => {
+            this.waitQueue.push(resolve);
+        });
+    }
+    release() {
+        if (this.waitQueue.length > 0) {
+            const next = this.waitQueue.shift();
+            next();
+        }
+        else {
+            this.currentCount--;
+        }
+    }
+}
+// Limit to 20 concurrent Qdrant operations
+const qdrantSemaphore = new QdrantSemaphore(20);
 class VectorDBService {
     client = null;
     config;
@@ -44,6 +82,21 @@ class VectorDBService {
         const testUrls = ['test-url', 'mock-url'];
         return !testUrls.includes(this.config.url || '');
     }
+    /**
+     * Check if collection exists without creating it
+     */
+    async collectionExists() {
+        if (!this.client) {
+            return false;
+        }
+        try {
+            const collections = await this.client.getCollections();
+            return collections.collections.some(col => col.name === this.collectionName);
+        }
+        catch {
+            return false;
+        }
+    }
     /**
      * Initialize the collection if it doesn't exist
      */
@@ -181,7 +234,8 @@ class VectorDBService {
                     vector,
                     limit,
                     score_threshold: scoreThreshold,
-                    with_payload: true
+                    with_payload: true,
+                    ...(options.filter && { filter: options.filter })
                 });
                 return searchResult.map(result => ({
                     id: result.id.toString(),
@@ -215,22 +269,56 @@ class VectorDBService {
                 const scrollResult = await this.client.scroll(this.collectionName, {
                     limit: 1000, // Get all documents for filtering
                     with_payload: true,
-                    with_vector: false
+                    with_vector: false,
+                    ...(options.filter && { filter: options.filter })
                 });
-                // Filter documents by checking if any keyword matches any trigger
-                const matchedPoints = scrollResult.points.filter(point => {
-                    if (!point.payload || !point.payload.triggers || !Array.isArray(point.payload.triggers)) {
-                        return false;
+                // Filter documents by checking if any keyword matches searchText or triggers
+                const scoredPoints = scrollResult.points
+                    .map(point => {
+                    if (!point.payload)
+                        return null;
+                    const searchText = (point.payload.searchText || '').toLowerCase();
+                    const triggers = Array.isArray(point.payload.triggers)
+                        ? point.payload.triggers.map(t => t.toLowerCase())
+                        : [];
+                    // Count keyword matches for scoring
+                    let matchCount = 0;
+                    let exactMatch = false;
+                    for (const keyword of keywords) {
+                        const kw = keyword.toLowerCase();
+                        // Check searchText (name, kind, namespace, labels, etc.)
+                        if (searchText.includes(kw)) {
+                            matchCount++;
+                            // Bonus for exact word match (surrounded by spaces/punctuation)
+                            const wordPattern = new RegExp(`\\b${escapeRegExp(kw)}\\b`, 'i');
+                            if (wordPattern.test(searchText)) {
+                                exactMatch = true;
+                            }
+                        }
+                        // Check triggers (for patterns/policies)
+                        if (triggers.some(t => t.includes(kw) || kw.includes(t))) {
+                            matchCount++;
+                        }
                     }
-                    const triggers = point.payload.triggers.map((t) => t.toLowerCase());
-                    return keywords.some(keyword => triggers.some(trigger => trigger.includes(keyword.toLowerCase()) ||
-                        keyword.toLowerCase().includes(trigger)));
-                });
+                    if (matchCount === 0)
+                        return null;
+                    // Score based on match quality
+                    // - Base score from match ratio
+                    // - Bonus for exact word matches
+                    const baseScore = matchCount / keywords.length;
+                    const score = exactMatch ? Math.min(1.0, baseScore + 0.3) : baseScore;
+                    return {
+                        point,
+                        score
+                    };
+                })
+                    .filter((item) => item !== null)
+                    .sort((a, b) => b.score - a.score);
                 // Apply limit after filtering
-                const limitedResults = matchedPoints.slice(0, limit);
-                return limitedResults.map(point => ({
+                const limitedResults = scoredPoints.slice(0, limit);
+                return limitedResults.map(({ point, score }) => ({
                     id: point.id.toString(),
-                    score: 1.0, // Keyword matches get full score
+                    score,
                     payload: point.payload || {}
                 }));
             }
@@ -343,69 +431,85 @@ class VectorDBService {
      * Scroll documents with Qdrant filter
      * @param filter - Qdrant filter object (must/should/must_not conditions)
      * @param limit - Maximum documents to retrieve
+     * Uses semaphore to limit concurrent Qdrant operations
      */
     async scrollWithFilter(filter, limit = 100) {
         if (!this.client) {
             throw new Error('Vector DB client not initialized');
         }
-        return (0, qdrant_tracing_1.withQdrantTracing)({
-            operation: 'vector.scroll_filtered',
-            collectionName: this.collectionName,
-            limit,
-            serverUrl: this.config.url
-        }, async () => {
-            try {
-                const scrollResult = await this.client.scroll(this.collectionName, {
-                    filter,
-                    limit,
-                    with_payload: true,
-                    with_vector: false
-                });
-                return scrollResult.points.map(point => ({
-                    id: point.id.toString(),
-                    payload: point.payload || {}
-                }));
-            }
-            catch (error) {
-                throw new Error(`Failed to scroll with filter: ${error}`);
-            }
-        });
+        // Acquire semaphore slot before executing
+        await qdrantSemaphore.acquire();
+        try {
+            return await (0, qdrant_tracing_1.withQdrantTracing)({
+                operation: 'vector.scroll_filtered',
+                collectionName: this.collectionName,
+                limit,
+                serverUrl: this.config.url
+            }, async () => {
+                try {
+                    const scrollResult = await this.client.scroll(this.collectionName, {
+                        filter,
+                        limit,
+                        with_payload: true,
+                        with_vector: false
+                    });
+                    return scrollResult.points.map(point => ({
+                        id: point.id.toString(),
+                        payload: point.payload || {}
+                    }));
+                }
+                catch (error) {
+                    throw new Error(`Failed to scroll with filter: ${error}`);
+                }
+            });
+        }
+        finally {
+            qdrantSemaphore.release();
+        }
     }
     /**
      * Get all documents (for listing)
      * @param limit - Maximum number of documents to retrieve. Defaults to unlimited (10000).
+     * Uses semaphore to limit concurrent Qdrant operations
      */
     async getAllDocuments(limit = 10000) {
         if (!this.client) {
             throw new Error('Vector DB client not initialized');
         }
-        return (0, qdrant_tracing_1.withQdrantTracing)({
-            operation: 'vector.list',
-            collectionName: this.collectionName,
-            limit,
-            serverUrl: this.config.url
-        }, async () => {
-            try {
-                // Check if collection exists first
-                const collections = await this.client.getCollections();
-                const collectionExists = collections.collections.some(col => col.name === this.collectionName);
-                if (!collectionExists) {
-                    throw new Error(`Collection '${this.collectionName}' does not exist. No data has been stored yet.`);
+        // Acquire semaphore slot before executing
+        await qdrantSemaphore.acquire();
+        try {
+            return await (0, qdrant_tracing_1.withQdrantTracing)({
+                operation: 'vector.list',
+                collectionName: this.collectionName,
+                limit,
+                serverUrl: this.config.url
+            }, async () => {
+                try {
+                    // Check if collection exists first
+                    const collections = await this.client.getCollections();
+                    const collectionExists = collections.collections.some(col => col.name === this.collectionName);
+                    if (!collectionExists) {
+                        throw new Error(`Collection '${this.collectionName}' does not exist. No data has been stored yet.`);
+                    }
+                    const scrollResult = await this.client.scroll(this.collectionName, {
+                        limit,
+                        with_payload: true,
+                        with_vector: false
+                    });
+                    return scrollResult.points.map(point => ({
+                        id: point.id.toString(),
+                        payload: point.payload || {}
+                    }));
                 }
-                const scrollResult = await this.client.scroll(this.collectionName, {
-                    limit,
-                    with_payload: true,
-                    with_vector: false
-                });
-                return scrollResult.points.map(point => ({
-                    id: point.id.toString(),
-                    payload: point.payload || {}
-                }));
-            }
-            catch (error) {
-                throw new Error(`Failed to get all documents: ${error}`);
-            }
-        });
+                catch (error) {
+                    throw new Error(`Failed to get all documents: ${error}`);
+                }
+            });
+        }
+        finally {
+            qdrantSemaphore.release();
+        }
     }
     /**
      * Get collection info and statistics

package/dist/core/visualization.d.ts

@@ -4,7 +4,12 @@
  * Common utilities for visualization support across all MCP tools.
  * Provides session metadata interfaces, URL generation, and prompt selection.
  */
-import { VisualizationType } from '../interfaces/rest-api';
+import { VisualizationType, VisualizationResponse } from '../interfaces/rest-api';
+/**
+ * Visualization mode prefix - when present in intent, return visualization data directly
+ * Used by tools to detect when caller wants visualization output instead of summary
+ */
+export declare const VISUALIZATION_PREFIX = "[visualization]";
 /**
  * Cached visualization structure stored in sessions
  * PRD #320: Added toolsUsed for test validation of mermaid validation
@@ -74,4 +79,14 @@ export declare const TOOL_SESSION_PREFIXES: Record<string, string>;
  * @returns Tool name or undefined if not recognized
  */
 export declare function getToolNameFromPrefix(prefix: string): string | undefined;
+/**
+ * Parse AI response into VisualizationResponse
+ * Extracts JSON from AI response, validates structure, normalizes insights
+ *
+ * @param aiResponse - Raw AI response string
+ * @param toolsUsed - Optional array of tools used during generation
+ * @returns Parsed VisualizationResponse
+ * @throws Error if parsing or validation fails
+ */
+export declare function parseVisualizationResponse(aiResponse: string, toolsUsed?: string[]): VisualizationResponse;
 //# sourceMappingURL=visualization.d.ts.map

package/dist/core/visualization.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"visualization.d.ts","sourceRoot":"","sources":["../../src/core/visualization.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,KAAK,CAAC;QACpB,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,iBAAiB,CAAC;QACxB,OAAO,EAAE,GAAG,CAAC;KACd,CAAC,CAAC;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,iFAAiF;IACjF,QAAQ,EAAE,MAAM,CAAC;IACjB,oFAAoF;IACpF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAC7B,OAAO,GACP,WAAW,GACX,WAAW,GACX,SAAS,GACT,SAAS,GACT,cAAc,CAAC;AAEnB;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAUrF;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAIpE;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAOxD,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOxE"}
+{"version":3,"file":"visualization.d.ts","sourceRoot":"","sources":["../../src/core/visualization.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAElF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,oBAAoB,CAAC;AAEtD;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,KAAK,CAAC;QACpB,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,iBAAiB,CAAC;QACxB,OAAO,EAAE,GAAG,CAAC;KACd,CAAC,CAAC;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,iFAAiF;IACjF,QAAQ,EAAE,MAAM,CAAC;IACjB,oFAAoF;IACpF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAC7B,OAAO,GACP,WAAW,GACX,WAAW,GACX,SAAS,GACT,SAAS,GACT,cAAc,CAAC;AAEnB;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAUrF;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAIpE;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAOxD,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOxE;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,qBAAqB,CAoD1G"}