@vfarcic/dot-ai 0.165.0 → 0.167.0

package/README.md

@@ -105,6 +105,12 @@ Get started in 3 steps:
 - **[MCP Setup Guide](docs/setup/mcp-setup.md)** - Complete configuration instructions
 - **[Tools Overview](docs/guides/mcp-tools-overview.md)** - All available tools and features
 
+### Deployment Options
+- **[Docker Setup](docs/setup/docker-setup.md)** - Recommended for local development
+- **[Kubernetes Setup](docs/setup/kubernetes-setup.md)** - Production deployment with Ingress
+- **[ToolHive Setup](docs/setup/kubernetes-toolhive-setup.md)** - Operator-managed deployment
+- **[NPX Setup](docs/setup/npx-setup.md)** - Quick trials with Node.js
+
 ### Feature Guides
 - **[Resource Provisioning](docs/guides/mcp-recommendation-guide.md)** - AI-powered deployment recommendations
 - **[Capability Management](docs/guides/mcp-capability-management-guide.md)** - Semantic resource discovery

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

@@ -0,0 +1,136 @@
+/**
+ * Resource Vector Service
+ *
+ * Vector-based storage and retrieval for Kubernetes cluster resources.
+ * Extends BaseVectorService to provide resource-specific operations.
+ *
+ * This service receives resource data from the dot-ai-controller and stores
+ * it in Qdrant for semantic search capabilities.
+ */
+import { BaseVectorService } from './base-vector-service';
+import { VectorDBService } from './vector-db-service';
+import { EmbeddingService } from './embedding-service';
+/**
+ * Cluster resource data structure
+ * Matches the format sent by dot-ai-controller
+ * Note: ID is constructed by MCP from namespace/apiVersion/kind/name
+ */
+export interface ClusterResource {
+    namespace: string;
+    name: string;
+    kind: string;
+    apiVersion: string;
+    apiGroup?: string;
+    labels: Record<string, string>;
+    annotations?: Record<string, string>;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Resource sync request from controller
+ */
+export interface ResourceSyncRequest {
+    upserts?: ClusterResource[];
+    deletes?: string[];
+    isResync?: boolean;
+}
+/**
+ * Result of a sync operation
+ */
+export interface SyncResult {
+    upserted: number;
+    deleted: number;
+    failures: Array<{
+        id: string;
+        error: string;
+    }>;
+}
+/**
+ * Result of a diff and sync operation
+ */
+export interface DiffSyncResult {
+    inserted: number;
+    updated: number;
+    deleted: number;
+}
+/**
+ * Extract API group from apiVersion
+ * e.g., 'apps/v1' -> 'apps', 'v1' -> ''
+ */
+export declare function extractApiGroup(apiVersion: string): string;
+/**
+ * Build embedding text from resource data
+ * Creates a semantic representation for vector search
+ */
+export declare function buildEmbeddingText(resource: ClusterResource): string;
+/**
+ * Generate resource ID from components
+ * Format: namespace:apiVersion:kind:name
+ */
+export declare function generateResourceId(namespace: string, apiVersion: string, kind: string, name: string): string;
+/**
+ * Generate a deterministic UUID from resource ID for Qdrant storage
+ * Qdrant requires UUIDs or positive integers as point IDs
+ * The hash is deterministic so the same resource ID always maps to the same UUID
+ */
+export declare function generateResourceUuid(resourceId: string): string;
+/**
+ * Check if two resources have meaningful differences
+ * Used for resync diff logic
+ */
+export declare function hasResourceChanged(existing: ClusterResource, incoming: ClusterResource): boolean;
+/**
+ * Vector service for storing and searching Kubernetes cluster resources
+ */
+export declare class ResourceVectorService extends BaseVectorService<ClusterResource> {
+    constructor(collectionName?: string, vectorDB?: VectorDBService, embeddingService?: EmbeddingService);
+    /**
+     * Create searchable text from resource data for embedding generation
+     */
+    protected createSearchText(resource: ClusterResource): string;
+    /**
+     * Extract unique ID from resource data
+     * Always constructs from components and hashes to UUID for Qdrant
+     */
+    protected extractId(resource: ClusterResource): string;
+    /**
+     * Convert resource to storage payload format
+     */
+    protected createPayload(resource: ClusterResource): Record<string, any>;
+    /**
+     * Convert storage payload back to resource object
+     */
+    protected payloadToData(payload: Record<string, any>): ClusterResource;
+    /**
+     * Store a resource in the vector database
+     */
+    storeResource(resource: ClusterResource): Promise<void>;
+    /**
+     * Upsert a resource (alias for storeResource for API consistency)
+     */
+    upsertResource(resource: ClusterResource): Promise<void>;
+    /**
+     * Get a resource by ID
+     * Accepts human-readable ID (namespace:apiVersion:kind:name) and converts to UUID
+     */
+    getResource(id: string): Promise<ClusterResource | null>;
+    /**
+     * Delete a resource by ID (idempotent - ignores not found)
+     * Accepts human-readable ID (namespace:apiVersion:kind:name) and converts to UUID
+     */
+    deleteResource(id: string): Promise<void>;
+    /**
+     * Delete all resources (for testing/reset)
+     */
+    deleteAllResources(): Promise<void>;
+    /**
+     * List all resources
+     */
+    listResources(): Promise<ClusterResource[]>;
+    /**
+     * Diff incoming resources against Qdrant and sync changes
+     * Used for periodic resync operations
+     */
+    diffAndSync(incoming: ClusterResource[]): Promise<DiffSyncResult>;
+}
+//# sourceMappingURL=resource-vector-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resource-vector-service.d.ts","sourceRoot":"","sources":["../../src/core/resource-vector-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CA+CpE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,MAAM,CAER;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAK/D;AAeD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,CAiBhG;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,iBAAiB,CAAC,eAAe,CAAC;gBAGzE,cAAc,GAAE,MAAoB,EACpC,QAAQ,CAAC,EAAE,eAAe,EAC1B,gBAAgB,CAAC,EAAE,gBAAgB;IAKrC;;OAEG;IACH,SAAS,CAAC,gBAAgB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM;IAI7D;;;OAGG;IACH,SAAS,CAAC,SAAS,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM;IAWtD;;OAEG;IACH,SAAS,CAAC,aAAa,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAevE;;OAEG;IACH,SAAS,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,eAAe;IActE;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9D;;;OAGG;IACG,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAK9D;;;OAGG;IACG,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAe/C;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIzC;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAIjD;;;OAGG;IACG,WAAW,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC;CA+CxE"}

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

@@ -0,0 +1,274 @@
+"use strict";
+/**
+ * Resource Vector Service
+ *
+ * Vector-based storage and retrieval for Kubernetes cluster resources.
+ * Extends BaseVectorService to provide resource-specific operations.
+ *
+ * This service receives resource data from the dot-ai-controller and stores
+ * it in Qdrant for semantic search capabilities.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResourceVectorService = void 0;
+exports.extractApiGroup = extractApiGroup;
+exports.buildEmbeddingText = buildEmbeddingText;
+exports.generateResourceId = generateResourceId;
+exports.generateResourceUuid = generateResourceUuid;
+exports.hasResourceChanged = hasResourceChanged;
+const crypto_1 = require("crypto");
+const base_vector_service_1 = require("./base-vector-service");
+/**
+ * Extract API group from apiVersion
+ * e.g., 'apps/v1' -> 'apps', 'v1' -> ''
+ */
+function extractApiGroup(apiVersion) {
+    const parts = apiVersion.split('/');
+    return parts.length > 1 ? parts[0] : '';
+}
+/**
+ * Build embedding text from resource data
+ * Creates a semantic representation for vector search
+ */
+function buildEmbeddingText(resource) {
+    const parts = [
+        `${resource.kind} ${resource.name}`,
+        `namespace: ${resource.namespace}`,
+        `apiVersion: ${resource.apiVersion}`,
+    ];
+    // Add API group if present
+    const apiGroup = resource.apiGroup || extractApiGroup(resource.apiVersion);
+    if (apiGroup) {
+        parts.push(`group: ${apiGroup}`);
+    }
+    // Add meaningful labels (skip standard Kubernetes labels)
+    if (resource.labels && Object.keys(resource.labels).length > 0) {
+        const meaningfulLabels = Object.entries(resource.labels)
+            .filter(([k]) => {
+            // Skip standard Kubernetes labels that don't add semantic value
+            const skipPrefixes = [
+                'app.kubernetes.io/',
+                'helm.sh/',
+                'kubernetes.io/',
+                'k8s.io/',
+            ];
+            return !skipPrefixes.some(prefix => k.startsWith(prefix));
+        })
+            .map(([k, v]) => `${k}=${v}`);
+        if (meaningfulLabels.length > 0) {
+            parts.push(`labels: ${meaningfulLabels.join(', ')}`);
+        }
+        // Also include app name from standard labels if present
+        const appName = resource.labels['app.kubernetes.io/name'] ||
+            resource.labels['app'] ||
+            resource.labels['name'];
+        if (appName) {
+            parts.push(`app: ${appName}`);
+        }
+    }
+    // Add description from annotations if present
+    if (resource.annotations?.description) {
+        parts.push(`description: ${resource.annotations.description}`);
+    }
+    return parts.join(' | ');
+}
+/**
+ * Generate resource ID from components
+ * Format: namespace:apiVersion:kind:name
+ */
+function generateResourceId(namespace, apiVersion, kind, name) {
+    return `${namespace}:${apiVersion}:${kind}:${name}`;
+}
+/**
+ * Generate a deterministic UUID from resource ID for Qdrant storage
+ * Qdrant requires UUIDs or positive integers as point IDs
+ * The hash is deterministic so the same resource ID always maps to the same UUID
+ */
+function generateResourceUuid(resourceId) {
+    const hash = (0, crypto_1.createHash)('sha256').update(`resource-${resourceId}`).digest('hex');
+    // Convert to UUID format: 8-4-4-4-12
+    return `${hash.substring(0, 8)}-${hash.substring(8, 12)}-${hash.substring(12, 16)}-${hash.substring(16, 20)}-${hash.substring(20, 32)}`;
+}
+/**
+ * Stringify an object with sorted keys for reliable comparison
+ * Ensures consistent ordering regardless of object creation order
+ */
+function sortedStringify(obj) {
+    if (!obj)
+        return '{}';
+    const sorted = Object.keys(obj).sort().reduce((acc, key) => {
+        acc[key] = obj[key];
+        return acc;
+    }, {});
+    return JSON.stringify(sorted);
+}
+/**
+ * Check if two resources have meaningful differences
+ * Used for resync diff logic
+ */
+function hasResourceChanged(existing, incoming) {
+    // Compare updatedAt timestamps
+    if (existing.updatedAt !== incoming.updatedAt) {
+        return true;
+    }
+    // Compare labels (with sorted keys for reliable comparison)
+    if (sortedStringify(existing.labels) !== sortedStringify(incoming.labels)) {
+        return true;
+    }
+    // Compare annotations (with sorted keys for reliable comparison)
+    if (sortedStringify(existing.annotations) !== sortedStringify(incoming.annotations)) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Vector service for storing and searching Kubernetes cluster resources
+ */
+class ResourceVectorService extends base_vector_service_1.BaseVectorService {
+    constructor(collectionName = 'resources', vectorDB, embeddingService) {
+        super(collectionName, vectorDB, embeddingService);
+    }
+    /**
+     * Create searchable text from resource data for embedding generation
+     */
+    createSearchText(resource) {
+        return buildEmbeddingText(resource);
+    }
+    /**
+     * Extract unique ID from resource data
+     * Always constructs from components and hashes to UUID for Qdrant
+     */
+    extractId(resource) {
+        // Always construct ID from components (ignore any provided id)
+        const resourceId = generateResourceId(resource.namespace, resource.apiVersion, resource.kind, resource.name);
+        return generateResourceUuid(resourceId);
+    }
+    /**
+     * Convert resource to storage payload format
+     */
+    createPayload(resource) {
+        return {
+            id: generateResourceId(resource.namespace, resource.apiVersion, resource.kind, resource.name),
+            namespace: resource.namespace,
+            name: resource.name,
+            kind: resource.kind,
+            apiVersion: resource.apiVersion,
+            apiGroup: resource.apiGroup || extractApiGroup(resource.apiVersion),
+            labels: resource.labels || {},
+            annotations: resource.annotations || {},
+            createdAt: resource.createdAt,
+            updatedAt: resource.updatedAt
+        };
+    }
+    /**
+     * Convert storage payload back to resource object
+     */
+    payloadToData(payload) {
+        return {
+            namespace: payload.namespace || '',
+            name: payload.name || '',
+            kind: payload.kind || '',
+            apiVersion: payload.apiVersion || '',
+            apiGroup: payload.apiGroup || '',
+            labels: payload.labels || {},
+            annotations: payload.annotations || {},
+            createdAt: payload.createdAt || new Date().toISOString(),
+            updatedAt: payload.updatedAt || new Date().toISOString()
+        };
+    }
+    /**
+     * Store a resource in the vector database
+     */
+    async storeResource(resource) {
+        await this.storeData(resource);
+    }
+    /**
+     * Upsert a resource (alias for storeResource for API consistency)
+     */
+    async upsertResource(resource) {
+        await this.storeResource(resource);
+    }
+    /**
+     * Get a resource by ID
+     * Accepts human-readable ID (namespace:apiVersion:kind:name) and converts to UUID
+     */
+    async getResource(id) {
+        const uuid = generateResourceUuid(id);
+        return await this.getData(uuid);
+    }
+    /**
+     * Delete a resource by ID (idempotent - ignores not found)
+     * Accepts human-readable ID (namespace:apiVersion:kind:name) and converts to UUID
+     */
+    async deleteResource(id) {
+        try {
+            // Convert human-readable ID to UUID for Qdrant
+            const uuid = generateResourceUuid(id);
+            await this.deleteData(uuid);
+        }
+        catch (error) {
+            // Idempotent delete - ignore "not found" errors
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            if (!errorMessage.toLowerCase().includes('not found')) {
+                throw error;
+            }
+            // Resource already deleted or never existed - this is fine
+        }
+    }
+    /**
+     * Delete all resources (for testing/reset)
+     */
+    async deleteAllResources() {
+        await this.deleteAllData();
+    }
+    /**
+     * List all resources
+     */
+    async listResources() {
+        return await this.getAllData();
+    }
+    /**
+     * Diff incoming resources against Qdrant and sync changes
+     * Used for periodic resync operations
+     */
+    async diffAndSync(incoming) {
+        // Helper to get human-readable ID from resource
+        const getResourceKey = (r) => generateResourceId(r.namespace, r.apiVersion, r.kind, r.name);
+        // Get all existing resources from Qdrant
+        const existing = await this.listResources();
+        const existingMap = new Map(existing.map(r => [getResourceKey(r), r]));
+        const incomingMap = new Map(incoming.map(r => [getResourceKey(r), r]));
+        const toInsert = [];
+        const toUpdate = [];
+        const toDelete = [];
+        // Find new and changed resources
+        for (const resource of incoming) {
+            const resourceId = getResourceKey(resource);
+            const existingResource = existingMap.get(resourceId);
+            if (!existingResource) {
+                toInsert.push(resource);
+            }
+            else if (hasResourceChanged(existingResource, resource)) {
+                toUpdate.push(resource);
+            }
+        }
+        // Find deleted resources (in Qdrant but not in incoming)
+        for (const id of existingMap.keys()) {
+            if (!incomingMap.has(id)) {
+                toDelete.push(id);
+            }
+        }
+        // Apply changes
+        for (const resource of [...toInsert, ...toUpdate]) {
+            await this.storeResource(resource);
+        }
+        for (const id of toDelete) {
+            await this.deleteResource(id);
+        }
+        return {
+            inserted: toInsert.length,
+            updated: toUpdate.length,
+            deleted: toDelete.length
+        };
+    }
+}
+exports.ResourceVectorService = ResourceVectorService;

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

@@ -35,6 +35,7 @@ export declare class VectorDBService {
     initializeCollection(vectorSize?: number): Promise<void>;
     /**
      * Create collection with specified vector size
+     * Handles conflict errors gracefully (collection already exists from race condition or restart)
      */
     private createCollection;
     /**

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;;OAEG;YACW,gBAAgB;IAkB9B;;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;;;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;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;;;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"}

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

@@ -92,22 +92,38 @@ class VectorDBService {
     }
     /**
      * Create collection with specified vector size
+     * Handles conflict errors gracefully (collection already exists from race condition or restart)
      */
     async createCollection(vectorSize) {
         if (!this.client) {
             throw new Error('Vector DB client not initialized');
         }
-        await this.client.createCollection(this.collectionName, {
-            vectors: {
-                size: vectorSize,
-                distance: 'Cosine',
-                on_disk: true // Enable on-disk storage for better performance with large collections
-            },
-            // Enable payload indexing for better keyword search performance
-            optimizers_config: {
-                default_segment_number: 2
+        try {
+            await this.client.createCollection(this.collectionName, {
+                vectors: {
+                    size: vectorSize,
+                    distance: 'Cosine',
+                    on_disk: true // Enable on-disk storage for better performance with large collections
+                },
+                // Enable payload indexing for better keyword search performance
+                optimizers_config: {
+                    default_segment_number: 2
+                }
+            });
+        }
+        catch (error) {
+            // Handle race condition where collection was created between check and create
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            if (errorMessage.toLowerCase().includes('conflict') ||
+                errorMessage.toLowerCase().includes('already exists')) {
+                // Collection exists - this is fine (race condition or restart)
+                if (process.env.DEBUG_DOT_AI) {
+                    console.debug(`Collection ${this.collectionName} already exists, skipping creation`);
+                }
+                return;
             }
-        });
+            throw error;
+        }
     }
     /**
      * Store a document with optional vector

package/dist/interfaces/resource-sync-handler.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Resource Sync Handler
+ *
+ * Handles POST /api/v1/resources/sync requests from dot-ai-controller.
+ * Receives cluster resource data, generates embeddings, and stores in Qdrant.
+ */
+import { Logger } from '../core/error-handling';
+import { RestApiResponse } from './rest-api';
+/**
+ * Reset initialization state (for testing or recovery)
+ * Call this to force re-initialization on the next request
+ */
+export declare function resetResourcesCollectionState(): void;
+/**
+ * Response data for successful sync operations
+ */
+export interface ResourceSyncResponseData {
+    upserted: number;
+    deleted: number;
+}
+/**
+ * Response data for partial failures
+ */
+export interface ResourceSyncFailureDetails {
+    upserted: number;
+    deleted: number;
+    failures: Array<{
+        id: string;
+        error: string;
+    }>;
+}
+/**
+ * Handle resource sync requests from the controller
+ *
+ * @param body - The request body containing upserts, deletes, and isResync flag
+ * @param logger - Logger instance for request tracking
+ * @param requestId - Unique request identifier for correlation
+ * @returns RestApiResponse with sync results
+ */
+export declare function handleResourceSync(body: unknown, logger: Logger, requestId: string): Promise<RestApiResponse>;
+//# sourceMappingURL=resource-sync-handler.d.ts.map

package/dist/interfaces/resource-sync-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-sync-handler.d.ts","sourceRoot":"","sources":["../../src/interfaces/resource-sync-handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAEhD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAK7C;;;GAGG;AACH,wBAAgB,6BAA6B,IAAI,IAAI,CAEpD;AAoID;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,eAAe,CAAC,CA0R1B"}

package/dist/interfaces/resource-sync-handler.js

@@ -0,0 +1,408 @@
+"use strict";
+/**
+ * Resource Sync Handler
+ *
+ * Handles POST /api/v1/resources/sync requests from dot-ai-controller.
+ * Receives cluster resource data, generates embeddings, and stores in Qdrant.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resetResourcesCollectionState = resetResourcesCollectionState;
+exports.handleResourceSync = handleResourceSync;
+const resource_vector_service_1 = require("../core/resource-vector-service");
+// Global flag to track if resources collection has been initialized
+let resourcesCollectionInitialized = false;
+/**
+ * Reset initialization state (for testing or recovery)
+ * Call this to force re-initialization on the next request
+ */
+function resetResourcesCollectionState() {
+    resourcesCollectionInitialized = false;
+}
+/**
+ * Validate a single cluster resource object
+ */
+function validateClusterResource(resource, index) {
+    const errors = [];
+    if (!resource || typeof resource !== 'object') {
+        return { valid: false, errors: [`upserts[${index}]: must be an object`] };
+    }
+    const r = resource;
+    if (!r.namespace || typeof r.namespace !== 'string' || r.namespace.length === 0) {
+        errors.push(`upserts[${index}].namespace: required string field`);
+    }
+    if (!r.name || typeof r.name !== 'string' || r.name.length === 0) {
+        errors.push(`upserts[${index}].name: required string field`);
+    }
+    if (!r.kind || typeof r.kind !== 'string' || r.kind.length === 0) {
+        errors.push(`upserts[${index}].kind: required string field`);
+    }
+    if (!r.apiVersion || typeof r.apiVersion !== 'string' || r.apiVersion.length === 0) {
+        errors.push(`upserts[${index}].apiVersion: required string field`);
+    }
+    if (!r.createdAt || typeof r.createdAt !== 'string') {
+        errors.push(`upserts[${index}].createdAt: required string field`);
+    }
+    if (!r.updatedAt || typeof r.updatedAt !== 'string') {
+        errors.push(`upserts[${index}].updatedAt: required string field`);
+    }
+    return { valid: errors.length === 0, errors };
+}
+/**
+ * Validate the sync request body
+ */
+function validateSyncRequest(body) {
+    const errors = [];
+    if (!body || typeof body !== 'object') {
+        return { valid: false, errors: ['Request body must be an object'] };
+    }
+    const b = body;
+    // Default values
+    const upserts = [];
+    const deletes = [];
+    const isResync = b.isResync === true;
+    // Validate upserts array
+    if (b.upserts !== undefined) {
+        if (!Array.isArray(b.upserts)) {
+            errors.push('upserts: must be an array');
+        }
+        else {
+            for (let i = 0; i < b.upserts.length; i++) {
+                const resourceValidation = validateClusterResource(b.upserts[i], i);
+                if (!resourceValidation.valid) {
+                    errors.push(...resourceValidation.errors);
+                }
+                else {
+                    const r = b.upserts[i];
+                    upserts.push({
+                        namespace: r.namespace,
+                        name: r.name,
+                        kind: r.kind,
+                        apiVersion: r.apiVersion,
+                        apiGroup: r.apiGroup,
+                        labels: r.labels || {},
+                        annotations: r.annotations,
+                        createdAt: r.createdAt,
+                        updatedAt: r.updatedAt
+                    });
+                }
+            }
+        }
+    }
+    // Validate deletes array (objects with namespace, apiVersion, kind, name)
+    if (b.deletes !== undefined) {
+        if (!Array.isArray(b.deletes)) {
+            errors.push('deletes: must be an array');
+        }
+        else {
+            for (let i = 0; i < b.deletes.length; i++) {
+                const del = b.deletes[i];
+                if (!del || typeof del !== 'object') {
+                    errors.push(`deletes[${i}]: must be an object`);
+                    continue;
+                }
+                const d = del;
+                const delErrors = [];
+                if (!d.namespace || typeof d.namespace !== 'string') {
+                    delErrors.push(`deletes[${i}].namespace: required string field`);
+                }
+                if (!d.name || typeof d.name !== 'string') {
+                    delErrors.push(`deletes[${i}].name: required string field`);
+                }
+                if (!d.kind || typeof d.kind !== 'string') {
+                    delErrors.push(`deletes[${i}].kind: required string field`);
+                }
+                if (!d.apiVersion || typeof d.apiVersion !== 'string') {
+                    delErrors.push(`deletes[${i}].apiVersion: required string field`);
+                }
+                if (delErrors.length > 0) {
+                    errors.push(...delErrors);
+                }
+                else {
+                    // Construct ID from components
+                    const deleteId = (0, resource_vector_service_1.generateResourceId)(d.namespace, d.apiVersion, d.kind, d.name);
+                    deletes.push(deleteId);
+                }
+            }
+        }
+    }
+    if (errors.length > 0) {
+        return { valid: false, errors };
+    }
+    return {
+        valid: true,
+        errors: [],
+        data: { upserts, deletes, isResync }
+    };
+}
+/**
+ * Handle resource sync requests from the controller
+ *
+ * @param body - The request body containing upserts, deletes, and isResync flag
+ * @param logger - Logger instance for request tracking
+ * @param requestId - Unique request identifier for correlation
+ * @returns RestApiResponse with sync results
+ */
+async function handleResourceSync(body, logger, requestId) {
+    const startTime = Date.now();
+    // Validate request body using manual validation
+    const validation = validateSyncRequest(body);
+    if (!validation.valid) {
+        logger.warn('Resource sync request validation failed', {
+            requestId,
+            errors: validation.errors
+        });
+        return {
+            success: false,
+            error: {
+                code: 'VALIDATION_ERROR',
+                message: 'Invalid request body',
+                details: validation.errors.map(e => ({
+                    path: e.split(':')[0] || 'unknown',
+                    message: e.split(':').slice(1).join(':').trim() || e
+                }))
+            },
+            meta: {
+                timestamp: new Date().toISOString(),
+                requestId,
+                version: 'v1'
+            }
+        };
+    }
+    const syncRequest = validation.data;
+    const { upserts = [], deletes = [], isResync = false } = syncRequest;
+    logger.info('Processing resource sync request', {
+        requestId,
+        upsertCount: upserts.length,
+        deleteCount: deletes.length,
+        isResync
+    });
+    // Initialize the resource vector service
+    let resourceService;
+    try {
+        resourceService = new resource_vector_service_1.ResourceVectorService();
+    }
+    catch (error) {
+        logger.error('Failed to create ResourceVectorService', error, { requestId });
+        return {
+            success: false,
+            error: {
+                code: 'SERVICE_INIT_FAILED',
+                message: 'Failed to create resource vector service',
+                details: { error: error instanceof Error ? error.message : String(error) }
+            },
+            meta: {
+                timestamp: new Date().toISOString(),
+                requestId,
+                version: 'v1'
+            }
+        };
+    }
+    // Check Vector DB health
+    let isHealthy;
+    try {
+        isHealthy = await resourceService.healthCheck();
+    }
+    catch (error) {
+        logger.error('Health check threw exception', error, { requestId });
+        return {
+            success: false,
+            error: {
+                code: 'HEALTH_CHECK_FAILED',
+                message: 'Vector DB health check threw exception',
+                details: { error: error instanceof Error ? error.message : String(error) }
+            },
+            meta: {
+                timestamp: new Date().toISOString(),
+                requestId,
+                version: 'v1'
+            }
+        };
+    }
+    if (!isHealthy) {
+        logger.error('Vector DB health check failed', new Error('Qdrant unavailable'), { requestId });
+        return {
+            success: false,
+            error: {
+                code: 'VECTOR_DB_UNAVAILABLE',
+                message: 'Vector database is not available',
+                details: {
+                    recommendation: 'Ensure Qdrant is running and accessible'
+                }
+            },
+            meta: {
+                timestamp: new Date().toISOString(),
+                requestId,
+                version: 'v1'
+            }
+        };
+    }
+    // Initialize the collection (only on first request, skip thereafter for performance)
+    if (!resourcesCollectionInitialized) {
+        try {
+            await resourceService.initialize();
+            resourcesCollectionInitialized = true;
+        }
+        catch (error) {
+            logger.error('Failed to initialize resources collection', error, { requestId });
+            return {
+                success: false,
+                error: {
+                    code: 'COLLECTION_INIT_FAILED',
+                    message: 'Failed to initialize resources collection',
+                    details: {
+                        error: error instanceof Error ? error.message : String(error)
+                    }
+                },
+                meta: {
+                    timestamp: new Date().toISOString(),
+                    requestId,
+                    version: 'v1'
+                }
+            };
+        }
+    }
+    let upserted = 0;
+    let deleted = 0;
+    const failures = [];
+    // Handle resync mode - use diffAndSync for full reconciliation
+    if (isResync && upserts.length > 0) {
+        logger.info('Processing resync with diff', {
+            requestId,
+            incomingResourceCount: upserts.length
+        });
+        try {
+            const diffResult = await resourceService.diffAndSync(upserts);
+            logger.info('Resync diff completed', {
+                requestId,
+                inserted: diffResult.inserted,
+                updated: diffResult.updated,
+                deleted: diffResult.deleted
+            });
+            return {
+                success: true,
+                data: {
+                    upserted: diffResult.inserted + diffResult.updated,
+                    deleted: diffResult.deleted,
+                    resync: {
+                        inserted: diffResult.inserted,
+                        updated: diffResult.updated,
+                        deleted: diffResult.deleted
+                    }
+                },
+                meta: {
+                    timestamp: new Date().toISOString(),
+                    requestId,
+                    version: 'v1'
+                }
+            };
+        }
+        catch (error) {
+            logger.error('Resync diff failed', error, { requestId });
+            return {
+                success: false,
+                error: {
+                    code: 'RESYNC_FAILED',
+                    message: 'Failed to perform resync diff',
+                    details: {
+                        error: error instanceof Error ? error.message : String(error)
+                    }
+                },
+                meta: {
+                    timestamp: new Date().toISOString(),
+                    requestId,
+                    version: 'v1'
+                }
+            };
+        }
+    }
+    // Handle upserts - process each resource
+    for (const resource of upserts) {
+        const resourceId = (0, resource_vector_service_1.generateResourceId)(resource.namespace, resource.apiVersion, resource.kind, resource.name);
+        try {
+            await resourceService.upsertResource(resource);
+            upserted++;
+            logger.debug('Resource upserted', {
+                requestId,
+                resourceId,
+                kind: resource.kind,
+                namespace: resource.namespace
+            });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            failures.push({ id: resourceId, error: errorMessage });
+            logger.warn('Failed to upsert resource', {
+                requestId,
+                resourceId,
+                error: errorMessage
+            });
+        }
+    }
+    // Handle deletes - idempotent (ignore not found)
+    for (const id of deletes) {
+        try {
+            await resourceService.deleteResource(id);
+            deleted++;
+            logger.debug('Resource deleted', {
+                requestId,
+                resourceId: id
+            });
+        }
+        catch (error) {
+            // deleteResource is already idempotent, but handle any other errors
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            failures.push({ id, error: errorMessage });
+            logger.warn('Failed to delete resource', {
+                requestId,
+                resourceId: id,
+                error: errorMessage
+            });
+        }
+    }
+    const executionTime = Date.now() - startTime;
+    // Return appropriate response based on failures
+    if (failures.length > 0) {
+        logger.warn('Resource sync completed with failures', {
+            requestId,
+            upserted,
+            deleted,
+            failureCount: failures.length,
+            executionTime
+        });
+        return {
+            success: false,
+            error: {
+                code: 'SYNC_PARTIAL_FAILURE',
+                message: `Failed to process ${failures.length} resource(s)`,
+                details: {
+                    upserted,
+                    deleted,
+                    failures
+                }
+            },
+            meta: {
+                timestamp: new Date().toISOString(),
+                requestId,
+                version: 'v1'
+            }
+        };
+    }
+    logger.info('Resource sync completed successfully', {
+        requestId,
+        upserted,
+        deleted,
+        executionTime
+    });
+    return {
+        success: true,
+        data: {
+            upserted,
+            deleted
+        },
+        meta: {
+            timestamp: new Date().toISOString(),
+            requestId,
+            version: 'v1'
+        }
+    };
+}

package/dist/interfaces/rest-api.d.ts

@@ -16,7 +16,8 @@ export declare enum HttpStatus {
     BAD_REQUEST = 400,
     NOT_FOUND = 404,
     METHOD_NOT_ALLOWED = 405,
-    INTERNAL_SERVER_ERROR = 500
+    INTERNAL_SERVER_ERROR = 500,
+    SERVICE_UNAVAILABLE = 503
 }
 /**
  * Standard REST API response format
@@ -96,6 +97,10 @@ export declare class RestApiRouter {
      * Handle OpenAPI specification requests
      */
     private handleOpenApiSpec;
+    /**
+     * Handle resource sync requests from controller
+     */
+    private handleResourceSyncRequest;
     /**
      * Set CORS headers
      */

package/dist/interfaces/rest-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rest-api.d.ts","sourceRoot":"","sources":["../../src/interfaces/rest-api.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE5D,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE7D,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAEtC;;GAEG;AACH,oBAAY,UAAU;IACpB,EAAE,MAAM;IACR,WAAW,MAAM;IACjB,SAAS,MAAM;IACf,kBAAkB,MAAM;IACxB,qBAAqB,MAAM;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,GAAG,CAAC;KACf,CAAC;IACF,IAAI,CAAC,EAAE;QACL,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,eAAe;IAC5D,IAAI,CAAC,EAAE;QACL,MAAM,EAAE,GAAG,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,eAAe;IAC5D,IAAI,CAAC,EAAE;QACL,KAAK,EAAE,QAAQ,EAAE,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;QACtB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,cAAc,CAAa;gBAGjC,QAAQ,EAAE,gBAAgB,EAC1B,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM;IAoBrC;;OAEG;IACG,aAAa,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IA+EzF;;OAEG;IACH,OAAO,CAAC,YAAY;IAmCpB;;OAEG;YACW,mBAAmB;IA2CjC;;OAEG;YACW,mBAAmB;IA+FjC;;OAEG;YACW,iBAAiB;IA8B/B;;OAEG;IACH,OAAO,CAAC,cAAc;IAOtB;;OAEG;YACW,gBAAgB;IAK9B;;OAEG;YACW,iBAAiB;IAyB/B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIvC;;OAEG;IACH,SAAS,IAAI,aAAa;CAG3B"}
+{"version":3,"file":"rest-api.d.ts","sourceRoot":"","sources":["../../src/interfaces/rest-api.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE5D,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE7D,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAGtC;;GAEG;AACH,oBAAY,UAAU;IACpB,EAAE,MAAM;IACR,WAAW,MAAM;IACjB,SAAS,MAAM;IACf,kBAAkB,MAAM;IACxB,qBAAqB,MAAM;IAC3B,mBAAmB,MAAM;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,GAAG,CAAC;KACf,CAAC;IACF,IAAI,CAAC,EAAE;QACL,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,eAAe;IAC5D,IAAI,CAAC,EAAE;QACL,MAAM,EAAE,GAAG,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,eAAe;IAC5D,IAAI,CAAC,EAAE;QACL,KAAK,EAAE,QAAQ,EAAE,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;QACtB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,cAAc,CAAa;gBAGjC,QAAQ,EAAE,gBAAgB,EAC1B,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM;IAoBrC;;OAEG;IACG,aAAa,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAyFzF;;OAEG;IACH,OAAO,CAAC,YAAY;IAyCpB;;OAEG;YACW,mBAAmB;IA2CjC;;OAEG;YACW,mBAAmB;IA+FjC;;OAEG;YACW,iBAAiB;IA8B/B;;OAEG;YACW,yBAAyB;IAgEvC;;OAEG;IACH,OAAO,CAAC,cAAc;IAOtB;;OAEG;YACW,gBAAgB;IAK9B;;OAEG;YACW,iBAAiB;IAyB/B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIvC;;OAEG;IACH,SAAS,IAAI,aAAa;CAG3B"}

package/dist/interfaces/rest-api.js

@@ -9,6 +9,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.RestApiRouter = exports.HttpStatus = void 0;
 const node_url_1 = require("node:url");
 const openapi_generator_1 = require("./openapi-generator");
+const resource_sync_handler_1 = require("./resource-sync-handler");
 /**
  * HTTP status codes for REST responses
  */
@@ -19,6 +20,7 @@ var HttpStatus;
     HttpStatus[HttpStatus["NOT_FOUND"] = 404] = "NOT_FOUND";
     HttpStatus[HttpStatus["METHOD_NOT_ALLOWED"] = 405] = "METHOD_NOT_ALLOWED";
     HttpStatus[HttpStatus["INTERNAL_SERVER_ERROR"] = 500] = "INTERNAL_SERVER_ERROR";
+    HttpStatus[HttpStatus["SERVICE_UNAVAILABLE"] = 503] = "SERVICE_UNAVAILABLE";
 })(HttpStatus || (exports.HttpStatus = HttpStatus = {}));
 /**
  * REST API Router for MCP tools
@@ -105,6 +107,17 @@ class RestApiRouter {
                         await this.sendErrorResponse(res, requestId, HttpStatus.METHOD_NOT_ALLOWED, 'METHOD_NOT_ALLOWED', 'Only GET method allowed for OpenAPI specification');
                     }
                     break;
+                case 'resources':
+                    if (req.method === 'POST' && pathMatch.action === 'sync') {
+                        await this.handleResourceSyncRequest(req, res, requestId, body);
+                    }
+                    else if (req.method !== 'POST') {
+                        await this.sendErrorResponse(res, requestId, HttpStatus.METHOD_NOT_ALLOWED, 'METHOD_NOT_ALLOWED', 'Only POST method allowed for resource sync');
+                    }
+                    else {
+                        await this.sendErrorResponse(res, requestId, HttpStatus.NOT_FOUND, 'NOT_FOUND', 'Unknown resources endpoint');
+                    }
+                    break;
                 default:
                     await this.sendErrorResponse(res, requestId, HttpStatus.NOT_FOUND, 'NOT_FOUND', 'Unknown API endpoint');
             }
@@ -125,6 +138,7 @@ class RestApiRouter {
         // /api/v1/tools -> tools discovery
         // /api/v1/tools/{toolName} -> tool execution
         // /api/v1/openapi -> OpenAPI spec
+        // /api/v1/resources/sync -> resource sync from controller
         const basePath = `${this.config.basePath}/${this.config.version}`;
         if (!pathname.startsWith(basePath)) {
             return null;
@@ -144,6 +158,10 @@ class RestApiRouter {
                 return { endpoint: 'tool', toolName };
             }
         }
+        // Handle resources/sync endpoint
+        if (cleanPath === 'resources/sync') {
+            return { endpoint: 'resources', action: 'sync' };
+        }
         return null;
     }
     /**
@@ -284,6 +302,50 @@ class RestApiRouter {
             await this.sendErrorResponse(res, requestId, HttpStatus.INTERNAL_SERVER_ERROR, 'OPENAPI_ERROR', 'Failed to generate OpenAPI specification');
         }
     }
+    /**
+     * Handle resource sync requests from controller
+     */
+    async handleResourceSyncRequest(req, res, requestId, body) {
+        try {
+            this.logger.info('Processing resource sync request', { requestId });
+            // Validate request body exists
+            if (!body || typeof body !== 'object') {
+                await this.sendErrorResponse(res, requestId, HttpStatus.BAD_REQUEST, 'INVALID_REQUEST', 'Request body must be a JSON object');
+                return;
+            }
+            // Delegate to the resource sync handler
+            const response = await (0, resource_sync_handler_1.handleResourceSync)(body, this.logger, requestId);
+            // Determine HTTP status based on response and error type
+            let httpStatus = HttpStatus.OK;
+            if (!response.success) {
+                const errorCode = response.error?.code;
+                if (errorCode === 'VECTOR_DB_UNAVAILABLE' || errorCode === 'HEALTH_CHECK_FAILED') {
+                    httpStatus = HttpStatus.SERVICE_UNAVAILABLE;
+                }
+                else if (errorCode === 'SERVICE_INIT_FAILED' || errorCode === 'COLLECTION_INIT_FAILED' || errorCode === 'RESYNC_FAILED') {
+                    httpStatus = HttpStatus.INTERNAL_SERVER_ERROR;
+                }
+                else {
+                    httpStatus = HttpStatus.BAD_REQUEST;
+                }
+            }
+            await this.sendJsonResponse(res, httpStatus, response);
+            this.logger.info('Resource sync request completed', {
+                requestId,
+                success: response.success,
+                upserted: response.data?.upserted,
+                deleted: response.data?.deleted
+            });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.logger.error('Resource sync request failed', error instanceof Error ? error : new Error(String(error)), {
+                requestId,
+                errorMessage
+            });
+            await this.sendErrorResponse(res, requestId, HttpStatus.INTERNAL_SERVER_ERROR, 'SYNC_ERROR', 'Resource sync failed', { error: errorMessage });
+        }
+    }
     /**
      * Set CORS headers
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vfarcic/dot-ai",
-  "version": "0.165.0",
+  "version": "0.167.0",
   "description": "AI-powered development productivity platform that enhances software development workflows through intelligent automation and AI-driven assistance",
   "mcpName": "io.github.vfarcic/dot-ai",
   "main": "dist/index.js",