@vinhnt-sdk/core 0.1.0

package/dist/session/title.js

@@ -0,0 +1,22 @@
+export const TITLE_INPUT_TRUNCATION = 200;
+export const TITLE_MAX_TOKENS = 30;
+export const TITLE_OUTPUT_TRUNCATION = 80;
+export const TITLE_SYSTEM_PROMPT = "Generate a concise session title (max 8 words) from this user message. Respond with ONLY the title, no quotes, no punctuation.";
+export function createDefaultSessionTitleGenerator(model) {
+    return async (prompt) => {
+        const truncated = prompt.slice(0, TITLE_INPUT_TRUNCATION);
+        const res = await model.generate({
+            messages: [
+                {
+                    role: "system",
+                    content: TITLE_SYSTEM_PROMPT,
+                },
+                { role: "user", content: truncated },
+            ],
+            tools: [],
+            maxTokens: TITLE_MAX_TOKENS,
+        });
+        return res.content.trim().replace(/^["']|["']$/g, "").slice(0, TITLE_OUTPUT_TRUNCATION);
+    };
+}
+//# sourceMappingURL=title.js.map

package/dist/session/title.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"title.js","sourceRoot":"","sources":["../../src/session/title.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAC1C,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AACnC,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAC1C,MAAM,CAAC,MAAM,mBAAmB,GAAG,gIAAgI,CAAC;AAEpK,MAAM,UAAU,kCAAkC,CAAC,KAAoB;IACrE,OAAO,KAAK,EAAE,MAAc,EAAmB,EAAE;QAC/C,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,sBAAsB,CAAC,CAAC;QAC1D,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC;YAC/B,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,mBAAmB;iBAC7B;gBACD,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE;aACrC;YACD,KAAK,EAAE,EAAE;YACT,SAAS,EAAE,gBAAgB;SAC5B,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,uBAAuB,CAAC,CAAC;IAC1F,CAAC,CAAC;AACJ,CAAC"}

package/dist/skill/create-skill-tool.d.ts

@@ -0,0 +1,13 @@
+export interface CreateSkillInput {
+    name: string;
+    description: string;
+    instructions: string;
+    /** Optional: tools this skill needs */
+    tools?: string[];
+    /** Optional: directory to write to (default: .vnt/skills/<name>/SKILL.md) */
+    directory?: string;
+    /** Optional: color for UI display */
+    color?: string;
+}
+export declare function createCreateSkillTool(): import("../index.js").ToolDefinition<CreateSkillInput, string>;
+//# sourceMappingURL=create-skill-tool.d.ts.map

package/dist/skill/create-skill-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-skill-tool.d.ts","sourceRoot":"","sources":["../../src/skill/create-skill-tool.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAWD,wBAAgB,qBAAqB,mEAmEpC"}

package/dist/skill/create-skill-tool.js

@@ -0,0 +1,77 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { z } from "zod";
+import { defineTool } from "../tool/define-tool.js";
+const CreateSkillSchema = z.object({
+    name: z.string().min(1),
+    description: z.string().min(1),
+    instructions: z.string().min(1),
+    directory: z.string().optional(),
+    tools: z.array(z.string()).optional(),
+    color: z.string().optional(),
+});
+export function createCreateSkillTool() {
+    return defineTool({
+        name: "create_skill",
+        description: "Create a reusable skill definition. Skills are collections of instructions, workflows, and best practices that can be loaded via the skill tool. Use this to capture expertise for reuse across projects.",
+        risk: "write",
+        input: CreateSkillSchema,
+        jsonSchema: {
+            type: "object",
+            properties: {
+                name: {
+                    type: "string",
+                    description: "Skill name (lowercase alphanumeric with hyphens, e.g. 'code-review', 'deploy-guide')",
+                },
+                description: {
+                    type: "string",
+                    description: "Brief description of what this skill does (shown in skill search)",
+                },
+                instructions: {
+                    type: "string",
+                    description: "Detailed instructions, workflows, and best practices for this skill",
+                },
+                tools: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Tools this skill typically uses",
+                },
+                directory: {
+                    type: "string",
+                    description: "Directory to write the skill file to (default: .vnt/skills/<name>/SKILL.md)",
+                },
+                color: {
+                    type: "string",
+                    description: "Optional color for UI display (e.g. '#ff6b6b')",
+                },
+            },
+            required: ["name", "description", "instructions"],
+        },
+        async execute(v) {
+            const dir = v.directory ?? join(".vnt", "skills", v.name);
+            const filePath = join(dir, "SKILL.md");
+            const frontmatter = {
+                name: v.name,
+                description: v.description,
+            };
+            if (v.tools && v.tools.length > 0) {
+                frontmatter.tools = v.tools;
+            }
+            if (v.color) {
+                frontmatter.color = v.color;
+            }
+            const frontmatterYaml = Object.entries(frontmatter)
+                .map(([k, v]) => {
+                if (Array.isArray(v))
+                    return `${k}:\n${v.map((i) => `  - ${i}`).join("\n")}`;
+                return `${k}: ${v}`;
+            })
+                .join("\n");
+            const content = `---\n${frontmatterYaml}\n---\n\n${v.instructions}\n`;
+            await mkdir(dir, { recursive: true });
+            await writeFile(filePath, content, "utf-8");
+            return `Skill "${v.name}" created at ${filePath}\n\nUse \`skill\` tool with name "${v.name}" to load this skill.`;
+        },
+    }).toDefinition();
+}
+//# sourceMappingURL=create-skill-tool.js.map

package/dist/skill/create-skill-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-skill-tool.js","sourceRoot":"","sources":["../../src/skill/create-skill-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAcpD,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACrC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC;AAEH,MAAM,UAAU,qBAAqB;IACnC,OAAO,UAAU,CAA2B;QAC1C,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,2MAA2M;QACxN,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,iBAAiB;QACxB,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,sFAAsF;iBACpG;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,mEAAmE;iBACjF;gBACD,YAAY,EAAE;oBACZ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,qEAAqE;iBACnF;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EAAE,iCAAiC;iBAC/C;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,6EAA6E;iBAC3F;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,gDAAgD;iBAC9D;aACF;YACD,QAAQ,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,cAAc,CAAC;SAClD;QACD,KAAK,CAAC,OAAO,CAAC,CAAC;YACb,MAAM,GAAG,GAAG,CAAC,CAAC,SAAS,IAAI,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;YAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;YAEvC,MAAM,WAAW,GAA4B;gBAC3C,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,WAAW,EAAE,CAAC,CAAC,WAAW;aAC3B,CAAC;YACF,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAClC,WAAW,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;YAC9B,CAAC;YACD,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;gBACZ,WAAW,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;YAC9B,CAAC;YAED,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC;iBAChD,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE;gBACd,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;oBAAE,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7E,OAAO,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACtB,CAAC,CAAC;iBACD,IAAI,CAAC,IAAI,CAAC,CAAC;YAEd,MAAM,OAAO,GAAG,QAAQ,eAAe,YAAY,CAAC,CAAC,YAAY,IAAI,CAAC;YAEtE,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACtC,MAAM,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAE5C,OAAO,UAAU,CAAC,CAAC,IAAI,gBAAgB,QAAQ,qCAAqC,CAAC,CAAC,IAAI,uBAAuB,CAAC;QACpH,CAAC;KACF,CAAC,CAAC,YAAY,EAAE,CAAC;AACpB,CAAC"}

package/dist/skill/skill-def-registry.d.ts

@@ -0,0 +1,27 @@
+import type { SkillDefinition, SkillSource } from "@vinhnt-sdk/schema";
+export interface SkillDefParser {
+    parse(raw: string, source: SkillSource): SkillDefinition;
+    parseFile(filePath: string, source: SkillSource): Promise<SkillDefinition>;
+}
+export interface SkillDefRegistry {
+    load(skills: SkillDefinition[]): Promise<void>;
+    get(name: string): SkillDefinition | undefined;
+    list(): readonly SkillDefinition[];
+    search(query: string): SkillDefinition[];
+    reload(): Promise<void>;
+}
+import type { SourceDir } from "../agent/agent-registry.js";
+export declare class InMemorySkillDefRegistry implements SkillDefRegistry {
+    private readonly skills;
+    private readonly parser;
+    private readonly sourceDirs;
+    constructor(parser: SkillDefParser, sourceDirs?: SourceDir[]);
+    load(skills: SkillDefinition[]): Promise<void>;
+    loadFromSources(): Promise<void>;
+    get(name: string): SkillDefinition | undefined;
+    list(): readonly SkillDefinition[];
+    search(query: string): SkillDefinition[];
+    reload(): Promise<void>;
+    private scanDir;
+}
+//# sourceMappingURL=skill-def-registry.d.ts.map

package/dist/skill/skill-def-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-def-registry.d.ts","sourceRoot":"","sources":["../../src/skill/skill-def-registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEvE,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,eAAe,CAAC;IACzD,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAC5E;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAAC;IAC/C,IAAI,IAAI,SAAS,eAAe,EAAE,CAAC;IACnC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,EAAE,CAAC;IACzC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AACD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAE5D,qBAAa,wBAAyB,YAAW,gBAAgB;IAC/D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsC;IAC7D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAc;gBAE7B,MAAM,EAAE,cAAc,EAAE,UAAU,CAAC,EAAE,SAAS,EAAE;IAKtD,IAAI,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAM9C,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBtC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAI9C,IAAI,IAAI,SAAS,eAAe,EAAE;IAIlC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,EAAE;IASlC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;YAKf,OAAO;CA6BtB"}

package/dist/skill/skill-def-registry.js

@@ -0,0 +1,74 @@
+import { readdir, readFile } from "node:fs/promises";
+import { join } from "node:path";
+export class InMemorySkillDefRegistry {
+    skills = new Map();
+    parser;
+    sourceDirs;
+    constructor(parser, sourceDirs) {
+        this.parser = parser;
+        this.sourceDirs = sourceDirs ?? [];
+    }
+    async load(skills) {
+        for (const skill of skills) {
+            this.skills.set(skill.manifest.name, skill);
+        }
+    }
+    async loadFromSources() {
+        const allSkills = [];
+        for (const source of this.sourceDirs) {
+            const found = await this.scanDir(source);
+            allSkills.push(...found);
+        }
+        const seenNames = new Set();
+        for (const skill of allSkills) {
+            if (seenNames.has(skill.manifest.name))
+                continue;
+            this.skills.set(skill.manifest.name, skill);
+            seenNames.add(skill.manifest.name);
+        }
+    }
+    get(name) {
+        return this.skills.get(name);
+    }
+    list() {
+        return [...this.skills.values()];
+    }
+    search(query) {
+        const lower = query.toLowerCase();
+        return [...this.skills.values()].filter((s) => s.manifest.name.toLowerCase().includes(lower) ||
+            s.manifest.description.toLowerCase().includes(lower));
+    }
+    async reload() {
+        this.skills.clear();
+        await this.loadFromSources();
+    }
+    async scanDir(source) {
+        try {
+            const entries = await readdir(source.dir, { withFileTypes: true });
+            // SKILL.md directly in source dir
+            const results = [];
+            // Also scan subdirectories for SKILL.md
+            const subDirs = entries.filter((e) => e.isDirectory());
+            for (const dir of subDirs) {
+                try {
+                    const skillPath = join(source.dir, dir.name, "SKILL.md");
+                    const raw = await readFile(skillPath, "utf-8");
+                    const def = this.parser.parse(raw, {
+                        type: source.type,
+                        dir: join(source.dir, dir.name),
+                        priority: source.priority,
+                    });
+                    results.push(def);
+                }
+                catch {
+                    // No SKILL.md in this subdirectory
+                }
+            }
+            return results;
+        }
+        catch {
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=skill-def-registry.js.map

package/dist/skill/skill-def-registry.js.map

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

package/dist/skill/skill-file-loader.d.ts

@@ -0,0 +1,50 @@
+import type { SkillDefinition, SkillSource } from "@vinhnt-sdk/schema";
+import type { SkillDefParser, SkillDefRegistry } from "../skill/skill-def-registry.js";
+/**
+ * SkillFileLoader — Discovers and loads skills from .vnt/skills/ directories.
+ *
+ * Supports multiple discovery locations:
+ * 1. Workspace-local: .vnt/skills/<name>/SKILL.md
+ * 2. Global: ~/.vnt/skills/<name>/SKILL.md
+ * 3. Claude-compatible: .claude/skills/<name>/SKILL.md
+ * 4. Agents-compatible: .agents/skills/<name>/SKILL.md
+ */
+export declare class SkillFileLoader {
+    private readonly parser;
+    constructor(parser?: SkillDefParser);
+    /**
+     * Load skills from a single directory.
+     */
+    loadFromDirectory(dir: string, source: SkillSource): Promise<SkillDefinition[]>;
+    /**
+     * Discover skills from all conventional locations.
+     *
+     * Discovery order (workspace overrides global):
+     * 1. Global: ~/.vnt/skills/
+     * 2. Global Claude: ~/.claude/skills/
+     * 3. Global Agents: ~/.agents/skills/
+     * 4. Workspace: .vnt/skills/
+     * 5. Workspace Claude: .claude/skills/
+     * 6. Workspace Agents: .agents/skills/
+     */
+    discover(workspaceRoot: string): Promise<SkillDefinition[]>;
+}
+/**
+ * SkillFileProvider — Integrates discovered skills into the kernel.
+ */
+export declare class SkillFileProvider {
+    private skills;
+    /**
+     * Load skills from all conventional locations.
+     */
+    load(workspaceRoot: string): Promise<void>;
+    /**
+     * Get all discovered skills.
+     */
+    getSkills(): readonly SkillDefinition[];
+    /**
+     * Register skills into a SkillDefRegistry.
+     */
+    registerInto(registry: SkillDefRegistry): Promise<void>;
+}
+//# sourceMappingURL=skill-file-loader.d.ts.map

package/dist/skill/skill-file-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-file-loader.d.ts","sourceRoot":"","sources":["../../src/skill/skill-file-loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAGvF;;;;;;;;GAQG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;gBAE5B,MAAM,CAAC,EAAE,cAAc;IAInC;;OAEG;IACG,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAyBrF;;;;;;;;;;OAUG;IACG,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;CAuClE;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAyB;IAEvC;;OAEG;IACG,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKhD;;OAEG;IACH,SAAS,IAAI,SAAS,eAAe,EAAE;IAIvC;;OAEG;IACG,YAAY,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;CAG9D"}

package/dist/skill/skill-file-loader.js

@@ -0,0 +1,115 @@
+import { readdir, readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { SkillParser } from "../skill/skill-parser.js";
+/**
+ * SkillFileLoader — Discovers and loads skills from .vnt/skills/ directories.
+ *
+ * Supports multiple discovery locations:
+ * 1. Workspace-local: .vnt/skills/<name>/SKILL.md
+ * 2. Global: ~/.vnt/skills/<name>/SKILL.md
+ * 3. Claude-compatible: .claude/skills/<name>/SKILL.md
+ * 4. Agents-compatible: .agents/skills/<name>/SKILL.md
+ */
+export class SkillFileLoader {
+    parser;
+    constructor(parser) {
+        this.parser = parser ?? new SkillParser();
+    }
+    /**
+     * Load skills from a single directory.
+     */
+    async loadFromDirectory(dir, source) {
+        const skills = [];
+        try {
+            const entries = await readdir(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (!entry.isDirectory())
+                    continue;
+                const skillPath = join(dir, entry.name, "SKILL.md");
+                try {
+                    const raw = await readFile(skillPath, "utf-8");
+                    const skill = this.parser.parse(raw, source);
+                    skills.push(skill);
+                }
+                catch {
+                    // No SKILL.md in this subdirectory
+                }
+            }
+        }
+        catch {
+            // Directory doesn't exist, ignore
+        }
+        return skills;
+    }
+    /**
+     * Discover skills from all conventional locations.
+     *
+     * Discovery order (workspace overrides global):
+     * 1. Global: ~/.vnt/skills/
+     * 2. Global Claude: ~/.claude/skills/
+     * 3. Global Agents: ~/.agents/skills/
+     * 4. Workspace: .vnt/skills/
+     * 5. Workspace Claude: .claude/skills/
+     * 6. Workspace Agents: .agents/skills/
+     */
+    async discover(workspaceRoot) {
+        const home = process.env.HOME || process.env.USERPROFILE || "";
+        const allSkills = [];
+        // Global locations
+        const globalLocations = [
+            { dir: join(home, ".vnt", "skills"), type: "global", priority: 0 },
+            { dir: join(home, ".claude", "skills"), type: "global", priority: 0 },
+            { dir: join(home, ".agents", "skills"), type: "global", priority: 0 },
+        ];
+        // Workspace locations
+        const workspaceLocations = [
+            { dir: join(workspaceRoot, ".vnt", "skills"), type: "project", priority: 10 },
+            { dir: join(workspaceRoot, ".claude", "skills"), type: "project", priority: 10 },
+            { dir: join(workspaceRoot, ".agents", "skills"), type: "project", priority: 10 },
+        ];
+        // Load from all locations
+        for (const loc of [...globalLocations, ...workspaceLocations]) {
+            const skills = await this.loadFromDirectory(loc.dir, {
+                type: loc.type,
+                dir: loc.dir,
+                priority: loc.priority,
+            });
+            allSkills.push(...skills);
+        }
+        // Deduplicate by name (workspace > global)
+        const skillMap = new Map();
+        for (const skill of allSkills) {
+            const existing = skillMap.get(skill.manifest.name);
+            if (!existing || (skill.source?.priority ?? 0) > (existing.source?.priority ?? 0)) {
+                skillMap.set(skill.manifest.name, skill);
+            }
+        }
+        return [...skillMap.values()];
+    }
+}
+/**
+ * SkillFileProvider — Integrates discovered skills into the kernel.
+ */
+export class SkillFileProvider {
+    skills = [];
+    /**
+     * Load skills from all conventional locations.
+     */
+    async load(workspaceRoot) {
+        const loader = new SkillFileLoader();
+        this.skills = await loader.discover(workspaceRoot);
+    }
+    /**
+     * Get all discovered skills.
+     */
+    getSkills() {
+        return this.skills;
+    }
+    /**
+     * Register skills into a SkillDefRegistry.
+     */
+    async registerInto(registry) {
+        await registry.load(this.skills);
+    }
+}
+//# sourceMappingURL=skill-file-loader.js.map

package/dist/skill/skill-file-loader.js.map

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

package/dist/skill/skill-parser.d.ts

@@ -0,0 +1,7 @@
+import type { SkillDefinition, SkillSource } from "@vinhnt-sdk/schema";
+import type { SkillDefParser } from "./skill-def-registry.js";
+export declare class SkillParser implements SkillDefParser {
+    parse(raw: string, source: SkillSource): SkillDefinition;
+    parseFile(filePath: string, source: SkillSource): Promise<SkillDefinition>;
+}
+//# sourceMappingURL=skill-parser.d.ts.map

package/dist/skill/skill-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-parser.d.ts","sourceRoot":"","sources":["../../src/skill/skill-parser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAmB,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAG9D,qBAAa,WAAY,YAAW,cAAc;IAChD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,eAAe;IAoClD,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;CAIjF"}

package/dist/skill/skill-parser.js

@@ -0,0 +1,42 @@
+import { readFile } from "node:fs/promises";
+import { parseFrontmatter } from "../yaml-frontmatter.js";
+export class SkillParser {
+    parse(raw, source) {
+        const { frontmatter, body } = parseFrontmatter(raw);
+        if (!frontmatter.name)
+            throw new Error("Skill must have a 'name' in frontmatter");
+        if (!frontmatter.description)
+            throw new Error("Skill must have a 'description' in frontmatter");
+        const name = String(frontmatter.name);
+        if (!/^[a-z0-9]+(-[a-z0-9]+)*$/.test(name)) {
+            throw new Error(`Skill name "${name}" must be lowercase alphanumeric with hyphens`);
+        }
+        if (name.length < 1 || name.length > 64) {
+            throw new Error(`Skill name "${name}" must be 1-64 characters`);
+        }
+        const perm = frontmatter.permission;
+        const tools = Array.isArray(frontmatter.tools) ? frontmatter.tools : undefined;
+        const hidden = typeof frontmatter.hidden === "boolean" ? frontmatter.hidden : undefined;
+        const color = typeof frontmatter.color === "string" ? frontmatter.color : undefined;
+        const mode = frontmatter.mode ?? "all";
+        return {
+            manifest: {
+                name,
+                description: String(frontmatter.description),
+                mode,
+                ...(hidden !== undefined ? { hidden } : {}),
+                ...(tools !== undefined ? { tools } : {}),
+                ...(perm !== undefined ? { permission: perm } : {}),
+                ...(color !== undefined ? { color } : {}),
+            },
+            source,
+            body,
+            raw,
+        };
+    }
+    async parseFile(filePath, source) {
+        const content = await readFile(filePath, "utf-8");
+        return this.parse(content, source);
+    }
+}
+//# sourceMappingURL=skill-parser.js.map

package/dist/skill/skill-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-parser.js","sourceRoot":"","sources":["../../src/skill/skill-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,MAAM,OAAO,WAAW;IACtB,KAAK,CAAC,GAAW,EAAE,MAAmB;QACpC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;QAEpD,IAAI,CAAC,WAAW,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAClF,IAAI,CAAC,WAAW,CAAC,WAAW;YAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QAEhG,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,+CAA+C,CAAC,CAAC;QACtF,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,2BAA2B,CAAC,CAAC;QAClE,CAAC;QAED,MAAM,IAAI,GAAG,WAAW,CAAC,UAAyC,CAAC;QACnE,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,WAAW,CAAC,KAAkB,CAAC,CAAC,CAAC,SAAS,CAAC;QAC7F,MAAM,MAAM,GAAG,OAAO,WAAW,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;QACxF,MAAM,KAAK,GAAG,OAAO,WAAW,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;QACpF,MAAM,IAAI,GAAI,WAAW,CAAC,IAAuC,IAAI,KAAK,CAAC;QAE3E,OAAO;YACL,QAAQ,EAAE;gBACR,IAAI;gBACJ,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC,WAAW,CAAC;gBAC5C,IAAI;gBACJ,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3C,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzC,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACnD,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC1C;YACD,MAAM;YACN,IAAI;YACJ,GAAG;SACJ,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,QAAgB,EAAE,MAAmB;QACnD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACrC,CAAC;CACF"}

package/dist/skill/skill-tool.d.ts

@@ -0,0 +1,10 @@
+import type { SkillDefRegistry } from "./skill-def-registry.js";
+export interface SkillToolInput {
+    name: string;
+    task: string;
+}
+export declare function createSkillTool(registry: SkillDefRegistry): import("../index.js").ToolDefinition<SkillToolInput, string>;
+export declare function createSkillSearchTool(registry: SkillDefRegistry): import("../index.js").ToolDefinition<{
+    query: string;
+}, string>;
+//# sourceMappingURL=skill-tool.d.ts.map

package/dist/skill/skill-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-tool.d.ts","sourceRoot":"","sources":["../../src/skill/skill-tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAIhE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAUD,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,gBAAgB,gEAmC3B;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,gBAAgB;WAEC,MAAM;WA0BlC"}

package/dist/skill/skill-tool.js

@@ -0,0 +1,100 @@
+import { z } from "zod";
+import { defineTool } from "../tool/define-tool.js";
+const SkillSchema = z.object({
+    name: z.string().min(1),
+    task: z.string().min(1),
+});
+const SkillSearchSchema = z.object({
+    query: z.string().min(1),
+});
+export function createSkillTool(registry) {
+    return defineTool({
+        name: "skill",
+        description: "Load a skill by name and apply it to the current task. Skills provide specialized instructions, workflows, and best practices for specific domains (testing, deployment, code review, etc.). Use this tool when the task matches a skill's description.",
+        risk: "read",
+        input: SkillSchema,
+        jsonSchema: {
+            type: "object",
+            properties: {
+                name: {
+                    type: "string",
+                    description: "Name of the skill to load (use search first if unsure)",
+                },
+                task: {
+                    type: "string",
+                    description: "Description of the task to apply the skill to",
+                },
+            },
+            required: ["name", "task"],
+        },
+        async execute(v) {
+            const skill = registry.get(v.name);
+            if (!skill) {
+                const similar = registry.search(v.name);
+                if (similar.length > 0) {
+                    const names = similar.map((s) => `  - ${s.manifest.name}: ${s.manifest.description}`).join("\n");
+                    return `Skill "${v.name}" not found. Available similar skills:\n${names}\n\nUse 'skill' with the correct name.`;
+                }
+                return `Skill "${v.name}" not found. No similar skills found.`;
+            }
+            return formatSkillOutput(skill, v.task);
+        },
+    }).toDefinition();
+}
+export function createSkillSearchTool(registry) {
+    return defineTool({
+        name: "skill_search",
+        description: "Search for available skills by name or description. Use this to discover skills that match your current task.",
+        risk: "read",
+        input: SkillSearchSchema,
+        jsonSchema: {
+            type: "object",
+            properties: {
+                query: { type: "string", description: "Search query (matches against name and description)" },
+            },
+            required: ["query"],
+        },
+        async execute(v) {
+            const results = registry.search(v.query);
+            if (results.length === 0) {
+                return `No skills found matching "${v.query}".`;
+            }
+            const lines = results.map((s, i) => {
+                const tags = s.manifest.tools?.length ? ` [tools: ${s.manifest.tools.join(", ")}]` : "";
+                return `${i + 1}. **${s.manifest.name}**${s.manifest.color ? ` (color: ${s.manifest.color})` : ""}${tags}\n   ${s.manifest.description}`;
+            });
+            return `Found ${results.length} skill(s) matching "${v.query}":\n\n${lines.join("\n")}\n\nUse \`skill\` tool with the desired name to load.`;
+        },
+    }).toDefinition();
+}
+function formatSkillOutput(skill, task) {
+    const lines = [];
+    lines.push(`# Skill: ${skill.manifest.name}`);
+    lines.push("");
+    lines.push(skill.manifest.description);
+    lines.push("");
+    if (skill.manifest.mode) {
+        lines.push(`**Mode**: ${skill.manifest.mode}`);
+    }
+    if (skill.manifest.model) {
+        lines.push(`**Model**: ${skill.manifest.model}`);
+    }
+    if (skill.manifest.temperature !== undefined) {
+        lines.push(`**Temperature**: ${skill.manifest.temperature}`);
+    }
+    if (skill.manifest.tools && skill.manifest.tools.length > 0) {
+        lines.push(`**Tools**: ${skill.manifest.tools.join(", ")}`);
+    }
+    lines.push("");
+    if (skill.body) {
+        lines.push("## Instructions");
+        lines.push("");
+        lines.push(skill.body);
+        lines.push("");
+    }
+    lines.push("---");
+    lines.push(`**Task to apply this skill to**: ${task}`);
+    lines.push("");
+    return lines.join("\n");
+}
+//# sourceMappingURL=skill-tool.js.map

package/dist/skill/skill-tool.js.map

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

package/dist/system-context/index.d.ts

@@ -0,0 +1,10 @@
+export { createContextRegistry } from "./registry.js";
+export { createDateSource } from "./sources/date-source.js";
+export { createWorkspaceSource } from "./sources/workspace-source.js";
+export { createInstructionsSource } from "./sources/instructions-source.js";
+export { createAgentSource } from "./sources/agent-source.js";
+export { createSystemPromptSource } from "./prompts/system-prompt-source.js";
+export type { WorkspaceInfo } from "./sources/workspace-source.js";
+export type { InstructionsInfo } from "./sources/instructions-source.js";
+export type { AgentContextInfo } from "./sources/agent-source.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/system-context/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/system-context/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,YAAY,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,YAAY,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,YAAY,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/system-context/index.js

@@ -0,0 +1,7 @@
+export { createContextRegistry } from "./registry.js";
+export { createDateSource } from "./sources/date-source.js";
+export { createWorkspaceSource } from "./sources/workspace-source.js";
+export { createInstructionsSource } from "./sources/instructions-source.js";
+export { createAgentSource } from "./sources/agent-source.js";
+export { createSystemPromptSource } from "./prompts/system-prompt-source.js";
+//# sourceMappingURL=index.js.map

package/dist/system-context/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/system-context/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC"}