@framers/agentos 0.1.28 → 0.1.30

package/dist/discovery/CapabilityIndex.js

@@ -0,0 +1,324 @@
+/**
+ * @fileoverview Capability Index — vector index over all capabilities.
+ * @module @framers/agentos/discovery/CapabilityIndex
+ *
+ * Normalizes tools, skills, extensions, and channels into unified
+ * CapabilityDescriptor objects, embeds them, and stores them in a
+ * vector index for semantic search.
+ *
+ * Reuses existing infrastructure:
+ * - IEmbeddingManager for embedding generation (with LRU cache)
+ * - IVectorStore for vector storage (InMemory, HNSW, Qdrant, SQL)
+ *
+ * Performance targets:
+ * - Index build: ~3s for ~100 capabilities (one-time, embedding API calls)
+ * - Search: <1ms HNSW lookup + ~50ms embedding cold / <5ms warm
+ */
+import { CapabilityEmbeddingStrategy } from './CapabilityEmbeddingStrategy.js';
+// ============================================================================
+// CAPABILITY INDEX
+// ============================================================================
+export class CapabilityIndex {
+    constructor(embeddingManager, vectorStore, collectionName, embeddingModelId) {
+        this.embeddingManager = embeddingManager;
+        this.vectorStore = vectorStore;
+        this.collectionName = collectionName;
+        this.embeddingModelId = embeddingModelId;
+        this.descriptors = new Map();
+        this.built = false;
+        this.embeddingStrategy = new CapabilityEmbeddingStrategy();
+    }
+    // ============================================================================
+    // INDEX LIFECYCLE
+    // ============================================================================
+    /**
+     * Build the index from all capability sources.
+     * Normalizes sources into CapabilityDescriptors, embeds them, and stores
+     * in the vector store.
+     */
+    async buildIndex(sources) {
+        // 1. Normalize all sources into CapabilityDescriptors
+        const descriptors = this.normalizeSources(sources);
+        // 2. Store descriptors in memory
+        for (const desc of descriptors) {
+            this.descriptors.set(desc.id, desc);
+        }
+        if (descriptors.length === 0) {
+            this.built = true;
+            return;
+        }
+        // 3. Generate embedding texts
+        const embeddingTexts = descriptors.map((d) => this.embeddingStrategy.buildEmbeddingText(d));
+        // 4. Batch embed all capabilities
+        const embeddingResponse = await this.embeddingManager.generateEmbeddings({
+            texts: embeddingTexts,
+            modelId: this.embeddingModelId,
+        });
+        // 5. Create collection if the store supports it
+        if (this.vectorStore.createCollection) {
+            const dimension = embeddingResponse.embeddings[0]?.length;
+            if (dimension) {
+                const exists = this.vectorStore.collectionExists
+                    ? await this.vectorStore.collectionExists(this.collectionName)
+                    : false;
+                if (!exists) {
+                    await this.vectorStore.createCollection(this.collectionName, dimension, {
+                        similarityMetric: 'cosine',
+                    });
+                }
+            }
+        }
+        // 6. Upsert into vector store
+        const documents = descriptors.map((desc, i) => ({
+            id: desc.id,
+            embedding: embeddingResponse.embeddings[i],
+            metadata: {
+                kind: desc.kind,
+                name: desc.name,
+                category: desc.category,
+                available: desc.available,
+            },
+            textContent: embeddingTexts[i],
+        }));
+        await this.vectorStore.upsert(this.collectionName, documents);
+        this.built = true;
+    }
+    /**
+     * Incrementally add or update a single capability.
+     */
+    async upsertCapability(cap) {
+        this.descriptors.set(cap.id, cap);
+        const text = this.embeddingStrategy.buildEmbeddingText(cap);
+        const response = await this.embeddingManager.generateEmbeddings({
+            texts: text,
+            modelId: this.embeddingModelId,
+        });
+        const doc = {
+            id: cap.id,
+            embedding: response.embeddings[0],
+            metadata: {
+                kind: cap.kind,
+                name: cap.name,
+                category: cap.category,
+                available: cap.available,
+            },
+            textContent: text,
+        };
+        await this.vectorStore.upsert(this.collectionName, [doc]);
+    }
+    /**
+     * Remove a capability from the index.
+     */
+    async removeCapability(id) {
+        this.descriptors.delete(id);
+        await this.vectorStore.delete(this.collectionName, [id]);
+    }
+    // ============================================================================
+    // SEARCH
+    // ============================================================================
+    /**
+     * Semantic search for capabilities matching a query.
+     *
+     * @param query - Natural language query (e.g., "search the web for news")
+     * @param topK - Number of results to return
+     * @param filters - Optional filters by kind, category, availability
+     */
+    async search(query, topK, filters) {
+        if (!this.built || this.descriptors.size === 0) {
+            return [];
+        }
+        // Embed the query
+        const queryResponse = await this.embeddingManager.generateEmbeddings({
+            texts: query,
+            modelId: this.embeddingModelId,
+        });
+        const queryEmbedding = queryResponse.embeddings[0];
+        // Build metadata filter
+        const metadataFilter = {};
+        if (filters?.kind && filters.kind !== 'any') {
+            metadataFilter.kind = filters.kind;
+        }
+        if (filters?.category) {
+            metadataFilter.category = filters.category;
+        }
+        if (filters?.onlyAvailable) {
+            metadataFilter.available = true;
+        }
+        // Query vector store
+        const result = await this.vectorStore.query(this.collectionName, queryEmbedding, {
+            topK,
+            filter: Object.keys(metadataFilter).length > 0 ? metadataFilter : undefined,
+            includeMetadata: true,
+        });
+        // Map results back to CapabilityDescriptors
+        return result.documents
+            .map((doc) => {
+            const descriptor = this.descriptors.get(doc.id);
+            if (!descriptor)
+                return null;
+            return {
+                descriptor,
+                score: doc.similarityScore,
+            };
+        })
+            .filter((r) => r !== null);
+    }
+    // ============================================================================
+    // ACCESSORS
+    // ============================================================================
+    /**
+     * Get a capability by ID.
+     */
+    getCapability(id) {
+        return this.descriptors.get(id);
+    }
+    /**
+     * Get all registered capabilities.
+     */
+    getAllCapabilities() {
+        return Array.from(this.descriptors.values());
+    }
+    /**
+     * Get all capability IDs.
+     */
+    listIds() {
+        return Array.from(this.descriptors.keys());
+    }
+    /**
+     * Get capabilities grouped by category.
+     */
+    getByCategory() {
+        const grouped = new Map();
+        for (const desc of this.descriptors.values()) {
+            const list = grouped.get(desc.category) ?? [];
+            list.push(desc);
+            grouped.set(desc.category, list);
+        }
+        return grouped;
+    }
+    /**
+     * Whether the index has been built.
+     */
+    isBuilt() {
+        return this.built;
+    }
+    /**
+     * Number of indexed capabilities.
+     */
+    size() {
+        return this.descriptors.size;
+    }
+    /**
+     * Get the embedding strategy (for external use by assembler).
+     */
+    getEmbeddingStrategy() {
+        return this.embeddingStrategy;
+    }
+    // ============================================================================
+    // SOURCE NORMALIZATION
+    // ============================================================================
+    /**
+     * Normalize all sources into CapabilityDescriptor objects.
+     */
+    normalizeSources(sources) {
+        const descriptors = [];
+        if (sources.tools) {
+            for (const tool of sources.tools) {
+                descriptors.push(this.normalizeToolSource(tool));
+            }
+        }
+        if (sources.skills) {
+            for (const skill of sources.skills) {
+                descriptors.push(this.normalizeSkillSource(skill));
+            }
+        }
+        if (sources.extensions) {
+            for (const ext of sources.extensions) {
+                descriptors.push(this.normalizeExtensionSource(ext));
+            }
+        }
+        if (sources.channels) {
+            for (const ch of sources.channels) {
+                descriptors.push(this.normalizeChannelSource(ch));
+            }
+        }
+        if (sources.manifests) {
+            for (const manifest of sources.manifests) {
+                descriptors.push(manifest);
+            }
+        }
+        return descriptors;
+    }
+    normalizeToolSource(tool) {
+        return {
+            id: `tool:${tool.name}`,
+            kind: 'tool',
+            name: tool.name,
+            displayName: tool.displayName,
+            description: tool.description,
+            category: tool.category ?? 'general',
+            tags: [],
+            requiredSecrets: [],
+            requiredTools: [],
+            available: true,
+            hasSideEffects: tool.hasSideEffects,
+            fullSchema: tool.inputSchema,
+            sourceRef: { type: 'tool', toolName: tool.name },
+        };
+    }
+    normalizeSkillSource(skill) {
+        return {
+            id: `skill:${skill.name}`,
+            kind: 'skill',
+            name: skill.name,
+            displayName: skill.name.split('-').map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(' '),
+            description: skill.description,
+            category: skill.category ?? 'general',
+            tags: skill.tags ?? [],
+            requiredSecrets: skill.requiredSecrets ?? [],
+            requiredTools: skill.requiredTools ?? skill.metadata?.requires?.bins ?? [],
+            available: true,
+            fullContent: skill.content,
+            sourceRef: {
+                type: 'skill',
+                skillName: skill.name,
+                skillPath: skill.sourcePath,
+            },
+        };
+    }
+    normalizeExtensionSource(ext) {
+        return {
+            id: `extension:${ext.name}`,
+            kind: 'extension',
+            name: ext.name,
+            displayName: ext.displayName,
+            description: ext.description,
+            category: ext.category,
+            tags: [],
+            requiredSecrets: ext.requiredSecrets ?? [],
+            requiredTools: [],
+            available: ext.available ?? false,
+            sourceRef: {
+                type: 'extension',
+                packageName: ext.name,
+                extensionId: ext.id,
+            },
+        };
+    }
+    normalizeChannelSource(ch) {
+        return {
+            id: `channel:${ch.platform}`,
+            kind: 'channel',
+            name: ch.platform,
+            displayName: ch.displayName,
+            description: ch.description,
+            category: 'communication',
+            tags: ch.capabilities ?? [],
+            requiredSecrets: [],
+            requiredTools: [],
+            available: true,
+            sourceRef: { type: 'channel', platform: ch.platform },
+        };
+    }
+}
+//# sourceMappingURL=CapabilityIndex.js.map

package/dist/discovery/CapabilityIndex.js.map

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

package/dist/discovery/CapabilityManifestScanner.d.ts

@@ -0,0 +1,66 @@
+/**
+ * @fileoverview Capability Manifest Scanner — file-based discovery.
+ * @module @framers/agentos/discovery/CapabilityManifestScanner
+ *
+ * Scans directories for CAPABILITY.yaml manifest files and optional
+ * SKILL.md companions. Supports hot-reload via fs.watch with debouncing.
+ *
+ * Directory conventions:
+ *   ~/.wunderland/capabilities/       (user-global)
+ *   ./.wunderland/capabilities/       (workspace-local)
+ *   $WUNDERLAND_CAPABILITY_DIRS       (env var, colon-separated)
+ *
+ * CAPABILITY.yaml format:
+ *   id: custom:my-tool
+ *   kind: tool
+ *   name: my-tool
+ *   displayName: My Custom Tool
+ *   description: Does something useful
+ *   category: information
+ *   tags: [search, api]
+ *   requiredSecrets: [MY_API_KEY]
+ *   inputSchema: { type: object, properties: { query: { type: string } } }
+ *   skillContent: ./SKILL.md   # optional relative path
+ *
+ * Extends the existing workspace-discovery.ts pattern from agentos-skills-registry.
+ */
+import type { CapabilityDescriptor } from './types.js';
+export declare class CapabilityManifestScanner {
+    private watchers;
+    /**
+     * Get default scan directories.
+     *
+     * 1. ~/.wunderland/capabilities/ (user-global)
+     * 2. ./.wunderland/capabilities/ (workspace-local, relative to cwd)
+     * 3. $WUNDERLAND_CAPABILITY_DIRS (env var, colon-separated)
+     */
+    getDefaultDirs(): string[];
+    /**
+     * Scan directories for CAPABILITY.yaml files.
+     * Each subdirectory should contain a CAPABILITY.yaml and optional SKILL.md.
+     *
+     * Structure:
+     *   <dir>/
+     *     my-custom-tool/
+     *       CAPABILITY.yaml
+     *       SKILL.md          (optional)
+     *       schema.json       (optional)
+     */
+    scan(dirs?: string[]): Promise<CapabilityDescriptor[]>;
+    /**
+     * Parse a single CAPABILITY.yaml file into a CapabilityDescriptor.
+     */
+    parseManifest(yamlPath: string, capDir: string): Promise<CapabilityDescriptor | null>;
+    /**
+     * Watch directories for changes and call the callback when capabilities
+     * are added, modified, or removed.
+     *
+     * Uses debouncing to prevent rapid-fire events from fs.watch.
+     */
+    watch(dirs: string[], onChange: (descriptors: CapabilityDescriptor[]) => void, debounceMs?: number): void;
+    /**
+     * Stop watching all directories.
+     */
+    stopWatching(): void;
+}
+//# sourceMappingURL=CapabilityManifestScanner.d.ts.map

package/dist/discovery/CapabilityManifestScanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CapabilityManifestScanner.d.ts","sourceRoot":"","sources":["../../src/discovery/CapabilityManifestScanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAMH,OAAO,KAAK,EACV,oBAAoB,EAGrB,MAAM,YAAY,CAAC;AAgHpB,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAsB;IAEtC;;;;;;OAMG;IACH,cAAc,IAAI,MAAM,EAAE;IAmB1B;;;;;;;;;;OAUG;IACG,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IA6C5D;;OAEG;IACG,aAAa,CACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAoEvC;;;;;OAKG;IACH,KAAK,CACH,IAAI,EAAE,MAAM,EAAE,EACd,QAAQ,EAAE,CAAC,WAAW,EAAE,oBAAoB,EAAE,KAAK,IAAI,EACvD,UAAU,SAAM,GACf,IAAI;IA2BP;;OAEG;IACH,YAAY,IAAI,IAAI;CAMrB"}