@praveencs/agent 0.1.0

package/dist/src/skills/hub/registry.js

@@ -0,0 +1,24 @@
+/**
+ * Skill Hub registry client (Phase 3)
+ * Handles remote skill installation and publishing
+ */
+export class RegistryClient {
+    baseUrl;
+    constructor(baseUrl) {
+        this.baseUrl = baseUrl;
+    }
+    async search(query) {
+        // Phase 3: Implement registry search
+        console.log(`Registry search not yet available (query: ${query})`);
+        return [];
+    }
+    async install(name, version) {
+        // Phase 3: Download and install from registry
+        console.log(`Registry install not yet available (${name}@${version ?? 'latest'})`);
+    }
+    async publish(skillDir) {
+        // Phase 3: Publish skill to registry
+        console.log(`Registry publish not yet available (${skillDir})`);
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/src/skills/hub/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../../src/skills/hub/registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,cAAc;IACK;IAA5B,YAA4B,OAAe;QAAf,YAAO,GAAP,OAAO,CAAQ;IAAI,CAAC;IAEhD,KAAK,CAAC,MAAM,CAAC,KAAa;QACtB,qCAAqC;QACrC,OAAO,CAAC,GAAG,CAAC,6CAA6C,KAAK,GAAG,CAAC,CAAC;QACnE,OAAO,EAAE,CAAC;IACd,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,OAAgB;QACxC,8CAA8C;QAC9C,OAAO,CAAC,GAAG,CAAC,uCAAuC,IAAI,IAAI,OAAO,IAAI,QAAQ,GAAG,CAAC,CAAC;IACvF,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,QAAgB;QAC1B,qCAAqC;QACrC,OAAO,CAAC,GAAG,CAAC,uCAAuC,QAAQ,GAAG,CAAC,CAAC;IACpE,CAAC;CACJ"}

package/dist/src/skills/index.d.ts

@@ -0,0 +1,12 @@
+import { AgentConfig } from '../config/schema.js';
+import { LoadedSkill } from './types.js';
+export declare class SkillIndex {
+    private config;
+    private db;
+    private initialized;
+    constructor(config: AgentConfig);
+    init(skills: LoadedSkill[]): Promise<void>;
+    search(query: string, k?: number): Promise<LoadedSkill[]>;
+    private getEmbedding;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/src/skills/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/skills/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAUzC,qBAAa,UAAU;IACnB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,EAAE,CAA6B;IACvC,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,EAAE,WAAW;IAIzB,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE;IAyC1B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,SAAI,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;YAa5C,YAAY;CA2B7B"}

package/dist/src/skills/index.js

@@ -0,0 +1,82 @@
+import path from 'node:path';
+export class SkillIndex {
+    config;
+    db = null;
+    initialized = false;
+    constructor(config) {
+        this.config = config;
+    }
+    async init(skills) {
+        if (!this.config.models.embeddings.enabled)
+            return;
+        try {
+            // Check if hnswsqlite is available
+            const hnswlib = await import('hnswsqlite').catch(() => null);
+            if (!hnswlib) {
+                console.warn('Vector search disabled: "hnswsqlite" not found. Run "npm install hnswsqlite" to enable.');
+                return;
+            }
+            const dbPath = path.join(process.cwd(), '.agent/skills.db');
+            // Assuming default export or named export matches
+            const Database = hnswlib.Database || hnswlib.default?.Database;
+            if (!Database) {
+                console.warn("Could not load Database from hnswsqlite");
+                return;
+            }
+            this.db = new Database(dbPath);
+            // Initialize DB schema (pseudo-code as library API varies)
+            // ...
+            // Re-index all skills (simplified: clear and insert)
+            // this.db?.run('DELETE FROM skills');
+            for (const skill of skills) {
+                const vector = await this.getEmbedding(skill.manifest.description);
+                // Insert into DB
+                // console.log(`Indexing ${skill.manifest.name} with vector length ${vector.length}`);
+            }
+            this.initialized = true;
+            console.log('Skill index initialized');
+        }
+        catch (error) {
+            console.error('Failed to initialize skill index:', error);
+        }
+    }
+    async search(query, k = 5) {
+        if (!this.initialized || !this.db)
+            return [];
+        // embed query
+        const vector = await this.getEmbedding(query);
+        // search
+        // results = this.db.search(...)
+        // Return dummy empty for now until fully implemented
+        return [];
+    }
+    async getEmbedding(text) {
+        // Use OpenAI/Azure provider
+        const config = this.config.models.embeddings;
+        if (config.provider === 'azure') {
+            const { AzureOpenAI } = await import('openai');
+            const client = new AzureOpenAI({
+                apiKey: config.apiKey || process.env.AZURE_API_KEY,
+                endpoint: config.baseUrl || process.env.AZURE_API_BASE,
+                deployment: config.deploymentName || process.env.AZURE_DEPLOYMENT_NAME,
+                apiVersion: config.apiVersion || process.env.AZURE_API_VERSION,
+            });
+            const res = await client.embeddings.create({
+                model: config.model,
+                input: text,
+            });
+            return res.data[0].embedding;
+        }
+        else {
+            // OpenAI default
+            const { OpenAI } = await import('openai');
+            const client = new OpenAI({ apiKey: config.apiKey });
+            const res = await client.embeddings.create({
+                model: config.model,
+                input: text,
+            });
+            return res.data[0].embedding;
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/src/skills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/skills/index.ts"],"names":[],"mappings":"AAGA,OAAO,IAAI,MAAM,WAAW,CAAC;AAS7B,MAAM,OAAO,UAAU;IACX,MAAM,CAAc;IACpB,EAAE,GAAwB,IAAI,CAAC;IAC/B,WAAW,GAAG,KAAK,CAAC;IAE5B,YAAY,MAAmB;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAqB;QAC5B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO;YAAE,OAAO;QAEnD,IAAI,CAAC;YACD,mCAAmC;YACnC,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YAC7D,IAAI,CAAC,OAAO,EAAE,CAAC;gBACX,OAAO,CAAC,IAAI,CAAC,yFAAyF,CAAC,CAAC;gBACxG,OAAO;YACX,CAAC;YAED,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,kBAAkB,CAAC,CAAC;YAC5D,kDAAkD;YAClD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC;YAC/D,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACZ,OAAO,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;gBACxD,OAAO;YACX,CAAC;YAED,IAAI,CAAC,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;YAE/B,2DAA2D;YAC3D,MAAM;YAEN,qDAAqD;YACrD,sCAAsC;YAEtC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBACzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;gBACnE,iBAAiB;gBACjB,sFAAsF;YAC1F,CAAC;YAED,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;QAE3C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;QAC9D,CAAC;IACL,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,CAAC,GAAG,CAAC;QAC7B,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,OAAO,EAAE,CAAC;QAE7C,cAAc;QACd,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAE9C,SAAS;QACT,gCAAgC;QAEhC,qDAAqD;QACrD,OAAO,EAAE,CAAC;IACd,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,IAAY;QACnC,4BAA4B;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC;QAC7C,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YAC9B,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC/C,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC;gBAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa;gBAClD,QAAQ,EAAE,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc;gBACtD,UAAU,EAAE,MAAM,CAAC,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB;gBACtE,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB;aACjE,CAAC,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC;gBACvC,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,KAAK,EAAE,IAAI;aACd,CAAC,CAAC;YACH,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACjC,CAAC;aAAM,CAAC;YACJ,iBAAiB;YACjB,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC1C,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;YACrD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC;gBACvC,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,KAAK,EAAE,IAAI;aACd,CAAC,CAAC;YACH,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACjC,CAAC;IACL,CAAC;CACJ"}

package/dist/src/skills/lifecycle.d.ts

@@ -0,0 +1,19 @@
+import type { LoadedSkill, SkillState } from './types.js';
+/**
+ * Manage skill lifecycle states: draft → approved → deprecated
+ */
+export declare class SkillLifecycle {
+    /**
+     * Transition a skill to a new state
+     */
+    transition(skill: LoadedSkill, newState: SkillState): Promise<void>;
+    /**
+     * Check if a skill can run in daemon mode
+     */
+    canRunInDaemon(skill: LoadedSkill, allowDrafts?: boolean): boolean;
+    /**
+     * Check if a skill can be upgraded (not deprecated)
+     */
+    canUpgrade(skill: LoadedSkill): boolean;
+}
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/src/skills/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../src/skills/lifecycle.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE1D;;GAEG;AACH,qBAAa,cAAc;IACvB;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBzE;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,WAAW,GAAE,OAAe,GAAG,OAAO;IAOzE;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO;CAG1C"}

package/dist/src/skills/lifecycle.js

@@ -0,0 +1,48 @@
+import { readFile, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+/**
+ * Manage skill lifecycle states: draft → approved → deprecated
+ */
+export class SkillLifecycle {
+    /**
+     * Transition a skill to a new state
+     */
+    async transition(skill, newState) {
+        const currentState = skill.manifest.state ?? 'draft';
+        const validTransitions = {
+            draft: ['approved'],
+            approved: ['deprecated'],
+            deprecated: ['approved'], // Can re-approve deprecated skills
+        };
+        const allowed = validTransitions[currentState];
+        if (!allowed?.includes(newState)) {
+            throw new Error(`Cannot transition skill "${skill.manifest.name}" from "${currentState}" to "${newState}". ` +
+                `Valid transitions: ${allowed?.join(', ') ?? 'none'}`);
+        }
+        // Update manifest
+        skill.manifest.state = newState;
+        const manifestPath = path.join(skill.path, 'skill.json');
+        const content = await readFile(manifestPath, 'utf-8');
+        const manifest = JSON.parse(content);
+        manifest.state = newState;
+        await writeFile(manifestPath, JSON.stringify(manifest, null, 2) + '\n', 'utf-8');
+    }
+    /**
+     * Check if a skill can run in daemon mode
+     */
+    canRunInDaemon(skill, allowDrafts = false) {
+        const state = skill.manifest.state ?? 'draft';
+        if (state === 'approved')
+            return true;
+        if (state === 'draft' && allowDrafts)
+            return true;
+        return false;
+    }
+    /**
+     * Check if a skill can be upgraded (not deprecated)
+     */
+    canUpgrade(skill) {
+        return skill.manifest.state !== 'deprecated';
+    }
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/src/skills/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../../src/skills/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B;;GAEG;AACH,MAAM,OAAO,cAAc;IACvB;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,KAAkB,EAAE,QAAoB;QACrD,MAAM,YAAY,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,OAAO,CAAC;QACrD,MAAM,gBAAgB,GAAqC;YACvD,KAAK,EAAE,CAAC,UAAU,CAAC;YACnB,QAAQ,EAAE,CAAC,YAAY,CAAC;YACxB,UAAU,EAAE,CAAC,UAAU,CAAC,EAAE,mCAAmC;SAChE,CAAC;QAEF,MAAM,OAAO,GAAG,gBAAgB,CAAC,YAAY,CAAC,CAAC;QAC/C,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CACX,4BAA4B,KAAK,CAAC,QAAQ,CAAC,IAAI,WAAW,YAAY,SAAS,QAAQ,KAAK;gBAC5F,sBAAsB,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,EAAE,CACxD,CAAC;QACN,CAAC;QAED,kBAAkB;QAClB,KAAK,CAAC,QAAQ,CAAC,KAAK,GAAG,QAAQ,CAAC;QAChC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QACzD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACrC,QAAQ,CAAC,KAAK,GAAG,QAAQ,CAAC;QAC1B,MAAM,SAAS,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;IACrF,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,KAAkB,EAAE,cAAuB,KAAK;QAC3D,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,OAAO,CAAC;QAC9C,IAAI,KAAK,KAAK,UAAU;YAAE,OAAO,IAAI,CAAC;QACtC,IAAI,KAAK,KAAK,OAAO,IAAI,WAAW;YAAE,OAAO,IAAI,CAAC;QAClD,OAAO,KAAK,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,KAAkB;QACzB,OAAO,KAAK,CAAC,QAAQ,CAAC,KAAK,KAAK,YAAY,CAAC;IACjD,CAAC;CACJ"}

package/dist/src/skills/loader.d.ts

@@ -0,0 +1,43 @@
+import { type LoadedSkill } from './types.js';
+import type { AgentConfig } from '../config/schema.js';
+/**
+ * Skill loader — discovers, validates, and loads skills
+ */
+export declare class SkillLoader {
+    private skills;
+    private config;
+    constructor(config: AgentConfig);
+    /**
+     * Discover and load all skills from configured paths
+     */
+    loadAll(): Promise<LoadedSkill[]>;
+    /**
+     * Load skills from a directory
+     */
+    private loadFromDirectory;
+    /**
+     * Load a single skill from its directory
+     */
+    loadSkill(skillDir: string): Promise<LoadedSkill | null>;
+    /**
+     * Get a loaded skill by name
+     */
+    get(name: string): LoadedSkill | undefined;
+    /**
+     * List all loaded skills
+     */
+    list(): LoadedSkill[];
+    /**
+     * Check if a skill exists
+     */
+    has(name: string): boolean;
+    /**
+     * Install a skill from a local path
+     */
+    installFromPath(sourcePath: string, targetDir?: string): Promise<LoadedSkill | null>;
+    /**
+     * Remove a skill
+     */
+    remove(name: string): Promise<boolean>;
+}
+//# sourceMappingURL=loader.d.ts.map

package/dist/src/skills/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/skills/loader.ts"],"names":[],"mappings":"AAEA,OAAO,EAAuB,KAAK,WAAW,EAAsB,MAAM,YAAY,CAAC;AAGvF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD;;GAEG;AACH,qBAAa,WAAW;IACpB,OAAO,CAAC,MAAM,CAAuC;IACrD,OAAO,CAAC,MAAM,CAAc;gBAEhB,MAAM,EAAE,WAAW;IAI/B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAavC;;OAEG;YACW,iBAAiB;IA0B/B;;OAEG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAkC9D;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI1C;;OAEG;IACH,IAAI,IAAI,WAAW,EAAE;IAIrB;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAuB1F;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAS/C"}

package/dist/src/skills/loader.js

@@ -0,0 +1,142 @@
+import { readFile, readdir, access } from 'node:fs/promises';
+import path from 'node:path';
+import { SkillManifestSchema } from './types.js';
+import { validateSchema } from '../utils/schema.js';
+import { getSkillsDir } from '../utils/paths.js';
+/**
+ * Skill loader — discovers, validates, and loads skills
+ */
+export class SkillLoader {
+    skills = new Map();
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Discover and load all skills from configured paths
+     */
+    async loadAll() {
+        this.skills.clear();
+        const paths = this.config.skills.installPaths;
+        const cwd = process.cwd();
+        for (const skillPath of paths) {
+            const absPath = path.resolve(cwd, skillPath);
+            await this.loadFromDirectory(absPath);
+        }
+        return Array.from(this.skills.values());
+    }
+    /**
+     * Load skills from a directory
+     */
+    async loadFromDirectory(dirPath) {
+        try {
+            await access(dirPath);
+        }
+        catch {
+            return; // Directory doesn't exist
+        }
+        const entries = await readdir(dirPath, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const skillDir = path.join(dirPath, entry.name);
+            const manifestPath = path.join(skillDir, 'skill.json');
+            try {
+                await access(manifestPath);
+                const skill = await this.loadSkill(skillDir);
+                if (skill) {
+                    this.skills.set(skill.manifest.name, skill);
+                }
+            }
+            catch {
+                // Skip directories without skill.json
+            }
+        }
+    }
+    /**
+     * Load a single skill from its directory
+     */
+    async loadSkill(skillDir) {
+        const manifestPath = path.join(skillDir, 'skill.json');
+        try {
+            const content = await readFile(manifestPath, 'utf-8');
+            const raw = JSON.parse(content);
+            const result = validateSchema(SkillManifestSchema, raw, `skill.json in ${path.basename(skillDir)}`);
+            if (!result.success) {
+                console.error(`Invalid skill manifest at ${manifestPath}:\n${result.errors.join('\n')}`);
+                return null;
+            }
+            const manifest = result.data;
+            const loaded = {
+                manifest,
+                path: skillDir,
+            };
+            // Load entrypoint content
+            const entryPath = path.join(skillDir, manifest.entrypoint);
+            if (manifest.entrypoint.endsWith('.md')) {
+                loaded.promptContent = await readFile(entryPath, 'utf-8');
+            }
+            else if (manifest.entrypoint.endsWith('.ts') || manifest.entrypoint.endsWith('.js')) {
+                loaded.workflowPath = entryPath;
+            }
+            return loaded;
+        }
+        catch (err) {
+            console.error(`Failed to load skill from ${skillDir}: ${err.message}`);
+            return null;
+        }
+    }
+    /**
+     * Get a loaded skill by name
+     */
+    get(name) {
+        return this.skills.get(name);
+    }
+    /**
+     * List all loaded skills
+     */
+    list() {
+        return Array.from(this.skills.values());
+    }
+    /**
+     * Check if a skill exists
+     */
+    has(name) {
+        return this.skills.has(name);
+    }
+    /**
+     * Install a skill from a local path
+     */
+    async installFromPath(sourcePath, targetDir) {
+        const destDir = targetDir ?? getSkillsDir();
+        const absSource = path.resolve(sourcePath);
+        // Validate the skill first
+        const skill = await this.loadSkill(absSource);
+        if (!skill) {
+            throw new Error(`Invalid skill at ${absSource}`);
+        }
+        // Copy to target directory
+        const targetPath = path.join(destDir, skill.manifest.name);
+        const { cpSync } = await import('node:fs');
+        cpSync(absSource, targetPath, { recursive: true });
+        // Reload
+        const installed = await this.loadSkill(targetPath);
+        if (installed) {
+            this.skills.set(installed.manifest.name, installed);
+        }
+        return installed;
+    }
+    /**
+     * Remove a skill
+     */
+    async remove(name) {
+        const skill = this.skills.get(name);
+        if (!skill)
+            return false;
+        const { rmSync } = await import('node:fs');
+        rmSync(skill.path, { recursive: true, force: true });
+        this.skills.delete(name);
+        return true;
+    }
+}
+//# sourceMappingURL=loader.js.map

package/dist/src/skills/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../../src/skills/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,mBAAmB,EAAwC,MAAM,YAAY,CAAC;AACvF,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD;;GAEG;AACH,MAAM,OAAO,WAAW;IACZ,MAAM,GAA6B,IAAI,GAAG,EAAE,CAAC;IAC7C,MAAM,CAAc;IAE5B,YAAY,MAAmB;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO;QACT,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC;QAC9C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAE1B,KAAK,MAAM,SAAS,IAAI,KAAK,EAAE,CAAC;YAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YAC7C,MAAM,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAC1C,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,iBAAiB,CAAC,OAAe;QAC3C,IAAI,CAAC;YACD,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,CAAC,0BAA0B;QACtC,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC1B,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;gBAAE,SAAS;YAEnC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAChD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;YAEvD,IAAI,CAAC;gBACD,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;gBAC3B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;gBAC7C,IAAI,KAAK,EAAE,CAAC;oBACR,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;gBAChD,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACL,sCAAsC;YAC1C,CAAC;QACL,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CAAC,QAAgB;QAC5B,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QAEvD,IAAI,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACtD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAEhC,MAAM,MAAM,GAAG,cAAc,CAAC,mBAAmB,EAAE,GAAG,EAAE,iBAAiB,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YACpG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBAClB,OAAO,CAAC,KAAK,CAAC,6BAA6B,YAAY,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACzF,OAAO,IAAI,CAAC;YAChB,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAqB,CAAC;YAC9C,MAAM,MAAM,GAAgB;gBACxB,QAAQ;gBACR,IAAI,EAAE,QAAQ;aACjB,CAAC;YAEF,0BAA0B;YAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;YAC3D,IAAI,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACtC,MAAM,CAAC,aAAa,GAAG,MAAM,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YAC9D,CAAC;iBAAM,IAAI,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACpF,MAAM,CAAC,YAAY,GAAG,SAAS,CAAC;YACpC,CAAC;YAED,OAAO,MAAM,CAAC;QAClB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,6BAA6B,QAAQ,KAAM,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;YAClF,OAAO,IAAI,CAAC;QAChB,CAAC;IACL,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,IAAI;QACA,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,UAAkB,EAAE,SAAkB;QACxD,MAAM,OAAO,GAAG,SAAS,IAAI,YAAY,EAAE,CAAC;QAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAE3C,2BAA2B;QAC3B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAC9C,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,oBAAoB,SAAS,EAAE,CAAC,CAAC;QACrD,CAAC;QAED,2BAA2B;QAC3B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC3D,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;QAC3C,MAAM,CAAC,SAAS,EAAE,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEnD,SAAS;QACT,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACnD,IAAI,SAAS,EAAE,CAAC;YACZ,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACxD,CAAC;QACD,OAAO,SAAS,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,IAAY;QACrB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QAEzB,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;QAC3C,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACrD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACzB,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ"}

package/dist/src/skills/runner.d.ts

@@ -0,0 +1,43 @@
+import type { LoadedSkill } from './types.js';
+import type { ExecutionContext, ToolResult } from '../tools/types.js';
+import { ToolRegistry } from '../tools/registry.js';
+import { PolicyEngine } from '../policy/engine.js';
+import { LLMRouter } from '../llm/router.js';
+export interface SkillRunResult {
+    success: boolean;
+    output?: unknown;
+    error?: string;
+    toolCalls: {
+        tool: string;
+        input: unknown;
+        result: ToolResult;
+    }[];
+    validatorResults?: {
+        name: string;
+        passed: boolean;
+        output: string;
+    }[];
+    durationMs: number;
+}
+/**
+ * Skill runner — executes a loaded skill using its entrypoint
+ */
+export declare class SkillRunner {
+    private registry;
+    private policy;
+    private llmRouter;
+    constructor(registry: ToolRegistry, policy: PolicyEngine, llmRouter: LLMRouter);
+    /**
+     * Execute a skill with given inputs
+     */
+    run(skill: LoadedSkill, inputs: Record<string, unknown>, ctx: ExecutionContext): Promise<SkillRunResult>;
+    /**
+     * Run a prompt-based skill via LLM
+     */
+    private runPromptSkill;
+    /**
+     * Run a workflow-based skill (state machine)
+     */
+    private runWorkflowSkill;
+}
+//# sourceMappingURL=runner.d.ts.map

package/dist/src/skills/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../src/skills/runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAM7C,MAAM,WAAW,cAAc;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,UAAU,CAAA;KAAE,EAAE,CAAC;IAClE,gBAAgB,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACvE,UAAU,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,WAAW;IACpB,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,SAAS,CAAY;gBAEjB,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS;IAM9E;;OAEG;IACG,GAAG,CACL,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,GAAG,EAAE,gBAAgB,GACtB,OAAO,CAAC,cAAc,CAAC;IA4C1B;;OAEG;YACW,cAAc;IA+H5B;;OAEG;YACW,gBAAgB;CAmCjC"}

package/dist/src/skills/runner.js

@@ -0,0 +1,198 @@
+import { runValidators } from './validator.js';
+import { auditEmitter, AuditEventType } from '../policy/audit.js';
+import { zodToJsonSchema } from '../utils/schema.js';
+/**
+ * Skill runner — executes a loaded skill using its entrypoint
+ */
+export class SkillRunner {
+    registry;
+    policy;
+    llmRouter;
+    constructor(registry, policy, llmRouter) {
+        this.registry = registry;
+        this.policy = policy;
+        this.llmRouter = llmRouter;
+    }
+    /**
+     * Execute a skill with given inputs
+     */
+    async run(skill, inputs, ctx) {
+        const start = Date.now();
+        const toolCalls = [];
+        auditEmitter.emit(AuditEventType.SKILL_LOADED, {
+            name: skill.manifest.name,
+            version: skill.manifest.version,
+            entrypoint: skill.manifest.entrypoint,
+        });
+        try {
+            let output;
+            if (skill.promptContent) {
+                // Prompt-based skill: send to LLM with tool bindings
+                output = await this.runPromptSkill(skill, inputs, ctx, toolCalls);
+            }
+            else if (skill.workflowPath) {
+                // Workflow-based skill: run the state machine
+                output = await this.runWorkflowSkill(skill, inputs, ctx, toolCalls);
+            }
+            else {
+                throw new Error(`Skill "${skill.manifest.name}" has no valid entrypoint`);
+            }
+            // Run validators
+            const validatorResults = await runValidators(skill, ctx.cwd);
+            const allPassed = validatorResults.every((v) => v.passed);
+            return {
+                success: allPassed || validatorResults.length === 0,
+                output,
+                toolCalls,
+                validatorResults,
+                durationMs: Date.now() - start,
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: err.message,
+                toolCalls,
+                durationMs: Date.now() - start,
+            };
+        }
+    }
+    /**
+     * Run a prompt-based skill via LLM
+     */
+    async runPromptSkill(skill, inputs, ctx, toolCalls) {
+        // Build the prompt with inputs
+        let prompt = skill.promptContent;
+        for (const [key, value] of Object.entries(inputs)) {
+            prompt = prompt.replace(`{{${key}}}`, String(value));
+        }
+        // Get allowed tools for this skill
+        const allowedTools = skill.manifest.tools
+            .map((name) => this.registry.get(name))
+            .filter(Boolean);
+        // Send to LLM with tool definitions
+        const toolDefs = allowedTools.map((t) => ({
+            name: t.name,
+            description: t.description,
+            inputSchema: zodToJsonSchema(t.inputSchema),
+        }));
+        // Agentic loop: call LLM, execute tools, repeat
+        const messages = [
+            { role: 'system', content: prompt },
+            { role: 'user', content: `Execute this skill with inputs: ${JSON.stringify(inputs)}` },
+        ];
+        const maxIterations = 20;
+        let lastOutput = null;
+        for (let i = 0; i < maxIterations; i++) {
+            const response = await this.llmRouter.chat({
+                messages,
+                tools: toolDefs,
+                skillName: skill.manifest.name,
+            });
+            if (response.toolCalls && response.toolCalls.length > 0) {
+                messages.push({
+                    role: 'assistant',
+                    content: response.content,
+                    toolCalls: response.toolCalls,
+                });
+                for (const tc of response.toolCalls) {
+                    // Check policy
+                    const tool = this.registry.get(tc.name);
+                    if (!tool) {
+                        messages.push({
+                            role: 'tool',
+                            content: JSON.stringify({ error: `Tool ${tc.name} not found` }),
+                            toolCallId: tc.id,
+                        });
+                        continue;
+                    }
+                    // Check permissions
+                    const permResult = await this.policy.checkPermission({
+                        tool: tc.name,
+                        operation: tc.name,
+                        description: `Skill "${skill.manifest.name}" calling ${tc.name}`,
+                        permissions: tool.permissions,
+                        args: tc.args,
+                        riskLevel: 'medium',
+                    }, ctx);
+                    if (!permResult.allowed && permResult.requiresApproval) {
+                        const approved = await this.policy.requestApproval({
+                            tool: tc.name,
+                            operation: tc.name,
+                            description: `Skill "${skill.manifest.name}" calling ${tc.name}`,
+                            permissions: tool.permissions,
+                            args: tc.args,
+                            riskLevel: 'medium',
+                        }, ctx);
+                        if (!approved) {
+                            messages.push({
+                                role: 'tool',
+                                content: JSON.stringify({ error: 'Permission denied by user' }),
+                                toolCallId: tc.id,
+                            });
+                            continue;
+                        }
+                    }
+                    else if (!permResult.allowed) {
+                        messages.push({
+                            role: 'tool',
+                            content: JSON.stringify({ error: permResult.reason }),
+                            toolCallId: tc.id,
+                        });
+                        continue;
+                    }
+                    // Execute tool
+                    const result = await this.registry.execute(tc.name, tc.args, ctx);
+                    toolCalls.push({ tool: tc.name, input: tc.args, result });
+                    auditEmitter.emit(AuditEventType.TOOL_CALL, {
+                        tool: tc.name,
+                        input: tc.args,
+                        success: result.success,
+                    });
+                    messages.push({
+                        role: 'tool',
+                        content: JSON.stringify(result),
+                        toolCallId: tc.id,
+                    });
+                }
+            }
+            else {
+                // No tool calls — LLM finished
+                lastOutput = response.content;
+                break;
+            }
+        }
+        return lastOutput;
+    }
+    /**
+     * Run a workflow-based skill (state machine)
+     */
+    async runWorkflowSkill(skill, inputs, ctx, toolCalls) {
+        try {
+            const module = await import(skill.workflowPath);
+            const workflow = module.default ?? module.run;
+            if (typeof workflow !== 'function') {
+                throw new Error(`Workflow at ${skill.workflowPath} must export a default function or "run"`);
+            }
+            // Create a scoped tool executor
+            const toolExecutor = async (toolName, args) => {
+                // Ensure tool is in the skill's allowlist
+                if (!skill.manifest.tools.includes(toolName)) {
+                    return {
+                        success: false,
+                        error: `Tool "${toolName}" is not allowed for skill "${skill.manifest.name}"`,
+                        durationMs: 0,
+                    };
+                }
+                const result = await this.registry.execute(toolName, args, ctx);
+                toolCalls.push({ tool: toolName, input: args, result });
+                return result;
+            };
+            return await workflow({ inputs, tools: toolExecutor, context: ctx });
+        }
+        catch (err) {
+            throw new Error(`Workflow execution failed: ${err.message}`);
+        }
+    }
+}
+//# sourceMappingURL=runner.js.map