@loom-node/amoeba 0.1.1 → 0.1.2

package/dist/index.d.ts

@@ -14,6 +14,7 @@ export type { AmoebaRuntimeConfig } from './runtime.js';
 export { AuctionNoWinnerError, MitosisError, ApoptosisRejectedError } from './errors.js';
 export { skillToNode } from './skill-node.js';
 export { SkillNodeRegistry } from './skill-registry.js';
+export { SkillCatalogProvider } from './skill-catalog-provider.js';
 export { createSkillEvolver } from './skill-evolver.js';
 export type { SkillDiscoverer } from './orchestrate-strategy.js';
 export { AmoebaLoop } from './amoeba-loop.js';

package/dist/index.js

@@ -9,6 +9,7 @@ export { AmoebaRuntime } from './runtime.js';
 export { AuctionNoWinnerError, MitosisError, ApoptosisRejectedError } from './errors.js';
 export { skillToNode } from './skill-node.js';
 export { SkillNodeRegistry } from './skill-registry.js';
+export { SkillCatalogProvider } from './skill-catalog-provider.js';
 export { createSkillEvolver } from './skill-evolver.js';
 export { AmoebaLoop } from './amoeba-loop.js';
 export { MitosisScratchpad } from './mitosis-scratchpad.js';

package/dist/skill-catalog-provider.d.ts

@@ -0,0 +1,19 @@
+/**
+ * SkillCatalogProvider — LLM semantic routing for progressive skill loading.
+ *
+ * Implements Progressive Disclosure as a ContextProvider:
+ *   Level 1 — describeAll() summaries fed to LLM
+ *   Level 2 — LLM selects best skill → loaded into SkillRegistry
+ *   Level 3 — SkillProvider handles execution context
+ */
+import type { ContextProvider, ContextFragment, LLMProvider, SkillRegistry } from '@loom-node/core';
+import type { SkillNodeRegistry } from './skill-registry.js';
+export declare class SkillCatalogProvider implements ContextProvider {
+    private catalog;
+    private registry;
+    private llm;
+    readonly source: "skill";
+    constructor(catalog: SkillNodeRegistry, registry: SkillRegistry, llm: LLMProvider);
+    provide(query: string, budget: number): Promise<ContextFragment[]>;
+    private selectSkill;
+}

package/dist/skill-catalog-provider.js

@@ -0,0 +1,66 @@
+export class SkillCatalogProvider {
+    catalog;
+    registry;
+    llm;
+    source = 'skill';
+    constructor(catalog, registry, llm) {
+        this.catalog = catalog;
+        this.registry = registry;
+        this.llm = llm;
+    }
+    async provide(query, budget) {
+        const descs = this.catalog.describeAll()
+            .filter(d => !this.catalog.isLoaded(d.name));
+        if (descs.length === 0)
+            return [];
+        const name = await this.selectSkill(query, descs);
+        if (!name)
+            return [];
+        const skill = this.catalog.get(name);
+        if (!skill)
+            return [];
+        // Level 2: activate — load into SkillRegistry
+        this.registry.register(skill);
+        this.catalog.markLoaded(name);
+        if (!skill.instructions)
+            return [];
+        const tokens = Math.ceil(skill.instructions.length / 4);
+        if (tokens > budget)
+            return [];
+        return [{
+                source: 'skill',
+                content: skill.instructions,
+                tokens,
+                relevance: 0.9,
+                metadata: { skillName: name, reason: 'llm_semantic_route' },
+            }];
+    }
+    async selectSkill(query, skills) {
+        const listing = skills.map(s => `- ${s.name}: ${s.description}`).join('\n');
+        try {
+            const result = await this.llm.complete({
+                messages: [{
+                        role: 'user',
+                        content: 'You are a skill router. Given a task and available skills, ' +
+                            'pick the BEST matching skill or reply null.\n\n' +
+                            `Skills:\n${listing}\n\n` +
+                            'Reply ONLY JSON: {"skill":"<name>"}\n' +
+                            'If none match, reply: null\n\n' +
+                            `Task: ${query}`,
+                    }],
+                temperature: 0,
+                maxTokens: 64,
+            });
+            const match = result.content.match(/\{[\s\S]*?\}/);
+            if (!match)
+                return null;
+            const obj = JSON.parse(match[0]);
+            const picked = obj.skill ?? '';
+            const valid = new Set(skills.map(s => s.name));
+            return valid.has(picked) ? picked : null;
+        }
+        catch {
+            return null;
+        }
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loom-node/amoeba",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -18,7 +18,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@loom-node/core": "0.1.1"
+    "@loom-node/core": "0.1.2"
   },
   "scripts": {
     "build": "tsc -b",