@burtson-labs/agent-core 1.6.13

package/dist/tools/skill-loader.js

@@ -0,0 +1,422 @@
+"use strict";
+/**
+ * Skill loader — discovers and loads custom skills from the workspace.
+ *
+ * Scans `.bandit/skills/` and registers any skills it finds with the
+ * SkillRegistry. Two formats are supported:
+ *
+ *   1. Markdown (`.md`) — preferred. Matches Claude Code's shape. A skill is
+ *      a context package: YAML frontmatter for metadata, markdown body for
+ *      the prose instructions the agent reads when the skill activates.
+ *      No `tools[]` — skills guide the agent on how to use tools it already
+ *      has (run_command, git_*, write_file, …). This eliminates the nested
+ *      JSON-in-JSON escaping trap that plagued the JSON format.
+ *
+ *   2. JSON (`.json`) — legacy. Still loads so existing `.bandit/skills/*.json`
+ *      keep working, but new authoring should use markdown. Logs a one-time
+ *      deprecation note in dev.
+ *
+ * Markdown layout (both `.bandit/skills/<name>.md` and
+ * `.bandit/skills/<name>/SKILL.md` are supported — the folder variant lets
+ * users bundle helper scripts next to the skill):
+ *
+ *     ---
+ *     id: github
+ *     name: GitHub CLI
+ *     description: Use when the user mentions GitHub — PRs, issues, commits
+ *     triggers: [gh, github, pr, "pull request"]
+ *     ---
+ *
+ *     When the user asks about GitHub work, use `run_command` with `gh`:
+ *
+ *     - `gh pr create --title "<t>" --body "<b>"` — open a PR
+ *     - `gh pr list` — list open PRs
+ *     - `gh issue list` — list issues
+ *
+ *     Suggest `gh auth status` if commands fail.
+ *
+ * Frontmatter keys recognized: `id`, `name`, `description`, `version`,
+ * `activation` (always|auto|on-demand — defaults to auto), `triggers`
+ * (simple substring list — matched case-insensitive against the user
+ * message), and `triggerPatterns` (explicit regex list — advanced).
+ *
+ * Legacy JSON schema (still supported, deprecated for new skills):
+ *
+ *     {
+ *       "id": "custom/my-skill",
+ *       "name": "My Custom Skill",
+ *       "description": "…",
+ *       "activation": "auto",
+ *       "triggerPatterns": ["\\bmy-keyword\\b"],
+ *       "tools": [
+ *         { "name": "my_tool", "description": "…", "command": "node x.js {{arg}}" }
+ *       ]
+ *     }
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildToolFromManifest = buildToolFromManifest;
+exports.loadWorkspaceSkills = loadWorkspaceSkills;
+exports.registerWorkspaceSkills = registerWorkspaceSkills;
+exports.scaffoldMarkdownSkill = scaffoldMarkdownSkill;
+const SKILLS_DIR = '.bandit/skills';
+function buildToolFromManifest(raw) {
+    const parameters = (raw.parameters ?? []).map((p) => ({
+        name: p.name,
+        description: p.description,
+        required: p.required ?? false
+    }));
+    if (raw.command) {
+        // Command-based tool — executes a shell command with parameter substitution.
+        //
+        // Split the template into base + args FIRST, then substitute params into
+        // each token individually. The earlier "substitute then split on /\s+/"
+        // shape let a param value containing whitespace explode into multiple
+        // argv entries — e.g. command="git {{op}}" with op="log; touch /tmp/x"
+        // resolved to ['git', 'log;', 'touch', '/tmp/x']. ctx.runCommand passes
+        // args straight to spawn() so no shell interpretation occurred, but the
+        // injected tokens still reached the binary as extra arguments — and for
+        // commands that accept --exec-style flags (find, git, ssh), that's a
+        // privilege escalation vector. Per-token substitution keeps each param
+        // value as exactly one argv element regardless of its contents.
+        const templateParts = raw.command.trim().split(/\s+/);
+        return {
+            name: raw.name,
+            description: raw.description,
+            parameters,
+            async execute(params, ctx) {
+                const substitute = (token) => {
+                    let out = token;
+                    for (const [key, value] of Object.entries(params)) {
+                        out = out.replace(new RegExp(`\\{\\{${key}\\}\\}`, 'g'), value ?? '');
+                    }
+                    return out;
+                };
+                const base = substitute(templateParts[0]);
+                const args = templateParts.slice(1).map(substitute);
+                try {
+                    const result = await ctx.runCommand(base, args, ctx.workspaceRoot);
+                    const output = [
+                        result.stdout.trim(),
+                        result.stderr.trim() ? `stderr: ${result.stderr.trim()}` : ''
+                    ].filter(Boolean).join('\n');
+                    return { output: output || '(no output)', isError: result.exitCode !== 0 };
+                }
+                catch (err) {
+                    return { output: `Error: ${err instanceof Error ? err.message : String(err)}`, isError: true };
+                }
+            }
+        };
+    }
+    // Placeholder tool — no command, just returns a message
+    return {
+        name: raw.name,
+        description: raw.description,
+        parameters,
+        async execute() {
+            return { output: `Tool "${raw.name}" has no command configured.`, isError: true };
+        }
+    };
+}
+/**
+ * Compile activation hints into RegExp[]. Accepts both the simple `triggers`
+ * list (substrings, matched case-insensitive with word-boundary sensitivity
+ * where possible) and the advanced `triggerPatterns` list (explicit regex).
+ * Invalid patterns are dropped with a warning rather than failing the whole
+ * load — skills written by the model sometimes produce junk patterns and
+ * the whole skill shouldn't vanish because of one.
+ */
+function compileTriggers(simple, patterns, filePath) {
+    const compiled = [];
+    for (const term of simple ?? []) {
+        const trimmed = term.trim();
+        if (!trimmed)
+            continue;
+        // Escape regex metachars in user-supplied substrings, then anchor at
+        // word boundaries for single-word terms. Multi-word terms ("pull
+        // request") keep internal whitespace flexible via `\s+`.
+        const escaped = trimmed.replace(/[.*+?^${}()|[\]\\]/g, '\\$&').replace(/\s+/g, '\\s+');
+        const boundary = /\s/.test(trimmed) ? escaped : `\\b${escaped}\\b`;
+        try {
+            compiled.push(new RegExp(boundary, 'i'));
+        }
+        catch {
+            console.warn(`[skill-loader] Could not compile trigger "${trimmed}" in ${filePath}`);
+        }
+    }
+    for (const pattern of patterns ?? []) {
+        try {
+            compiled.push(new RegExp(pattern, 'i'));
+        }
+        catch {
+            console.warn(`[skill-loader] Invalid regex "${pattern}" in ${filePath}`);
+        }
+    }
+    return compiled;
+}
+function parseSkillManifest(json, filePath) {
+    try {
+        const raw = JSON.parse(json);
+        if (!raw.id || !raw.name || !Array.isArray(raw.tools) || raw.tools.length === 0) {
+            console.warn(`[skill-loader] Invalid manifest at ${filePath}: missing id, name, or tools`);
+            return null;
+        }
+        const tools = raw.tools
+            .filter((t) => t.name && t.description)
+            .map(buildToolFromManifest);
+        if (tools.length === 0) {
+            console.warn(`[skill-loader] No valid tools in ${filePath}`);
+            return null;
+        }
+        const triggerPatterns = compileTriggers(undefined, raw.triggerPatterns, filePath);
+        return {
+            id: raw.id,
+            name: raw.name,
+            version: raw.version ?? '0.0.0',
+            description: raw.description,
+            instructions: raw.instructions,
+            activation: raw.activation ?? 'auto',
+            triggerPatterns: triggerPatterns.length > 0 ? triggerPatterns : undefined,
+            tools
+        };
+    }
+    catch (err) {
+        console.warn(`[skill-loader] Failed to parse ${filePath}: ${err instanceof Error ? err.message : String(err)}`);
+        return null;
+    }
+}
+/**
+ * Split a markdown skill file into (frontmatter object, body string).
+ * The frontmatter block is `---\n…\n---` at the top of the file. If it's
+ * missing, treat the entire file as the body and return an empty front-
+ * matter object — the caller decides whether that's fatal (it is: a skill
+ * needs at minimum an `id`).
+ *
+ * We parse just enough YAML to cover the supported keys (string scalars,
+ * quoted strings, inline `[a, b, "c d"]` arrays, and block-style dash
+ * lists). Full YAML is deliberately avoided — it's a heavy dep for a
+ * format we control, and richer YAML features would invite new ways for
+ * model-authored skills to silently corrupt.
+ */
+function splitFrontmatter(source) {
+    const match = source.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);
+    if (!match) {
+        return { frontmatter: {}, body: source.trim() };
+    }
+    return { frontmatter: parseYamlFrontmatter(match[1]), body: match[2].trim() };
+}
+function parseYamlFrontmatter(block) {
+    const out = {};
+    const lines = block.split(/\r?\n/);
+    let currentKey = null;
+    let currentList = null;
+    for (const raw of lines) {
+        const line = raw.replace(/\t/g, '  ');
+        if (!line.trim() || line.trim().startsWith('#'))
+            continue;
+        // Block-style list item (continuation of the current key).
+        const listMatch = line.match(/^\s*-\s+(.*)$/);
+        if (listMatch && currentList) {
+            currentList.push(stripYamlScalar(listMatch[1]));
+            continue;
+        }
+        // A new top-level `key:` line ends any block list we were building.
+        const kvMatch = line.match(/^([A-Za-z_][A-Za-z0-9_-]*)\s*:\s*(.*)$/);
+        if (!kvMatch)
+            continue;
+        currentList = null;
+        currentKey = kvMatch[1];
+        const value = kvMatch[2].trim();
+        if (value === '') {
+            // Block list follows on subsequent lines.
+            const list = [];
+            out[currentKey] = list;
+            currentList = list;
+            continue;
+        }
+        if (value.startsWith('[') && value.endsWith(']')) {
+            out[currentKey] = parseYamlInlineArray(value);
+            continue;
+        }
+        out[currentKey] = stripYamlScalar(value);
+    }
+    return out;
+}
+function stripYamlScalar(value) {
+    const trimmed = value.trim();
+    if (trimmed.startsWith('"') && trimmed.endsWith('"')) {
+        // Minimal escape decoding — \" and \\ only. Good enough for the keys
+        // we support; anything fancier is a red flag the author should know about.
+        return trimmed.slice(1, -1).replace(/\\"/g, '"').replace(/\\\\/g, '\\');
+    }
+    if (trimmed.startsWith("'") && trimmed.endsWith("'")) {
+        return trimmed.slice(1, -1).replace(/''/g, "'");
+    }
+    return trimmed;
+}
+function parseYamlInlineArray(source) {
+    const inner = source.slice(1, -1).trim();
+    if (!inner)
+        return [];
+    const out = [];
+    let buf = '';
+    let quote = null;
+    for (let i = 0; i < inner.length; i++) {
+        const ch = inner[i];
+        if (quote) {
+            if (ch === quote) {
+                quote = null;
+                continue;
+            }
+            if (ch === '\\' && i + 1 < inner.length) {
+                buf += inner[++i];
+                continue;
+            }
+            buf += ch;
+            continue;
+        }
+        if (ch === '"' || ch === "'") {
+            quote = ch;
+            continue;
+        }
+        if (ch === ',') {
+            const trimmed = buf.trim();
+            if (trimmed)
+                out.push(trimmed);
+            buf = '';
+            continue;
+        }
+        buf += ch;
+    }
+    const tail = buf.trim();
+    if (tail)
+        out.push(tail);
+    return out;
+}
+function parseMarkdownSkill(source, filePath) {
+    const { frontmatter, body } = splitFrontmatter(source);
+    if (!frontmatter.id || !frontmatter.name) {
+        console.warn(`[skill-loader] Markdown skill ${filePath} missing id or name in frontmatter — skipping`);
+        return null;
+    }
+    const triggerPatterns = compileTriggers(frontmatter.triggers, frontmatter.triggerPatterns, filePath);
+    const activation = frontmatter.activation ?? 'auto';
+    // 'auto' activation with no triggers would silently never fire. Catch
+    // that at load time rather than leaving the author confused later.
+    if (activation === 'auto' && triggerPatterns.length === 0) {
+        console.warn(`[skill-loader] ${filePath}: activation=auto but no triggers — skill will never auto-activate`);
+    }
+    return {
+        id: frontmatter.id,
+        name: frontmatter.name,
+        version: frontmatter.version ?? '0.0.0',
+        description: frontmatter.description ?? body.split('\n', 1)[0] ?? frontmatter.name,
+        instructions: body || undefined,
+        activation,
+        triggerPatterns: triggerPatterns.length > 0 ? triggerPatterns : undefined,
+        tools: []
+    };
+}
+/**
+ * Load custom skills from `.bandit/skills/` in the workspace.
+ *
+ * Discovers markdown skills first (preferred), then JSON skills (legacy).
+ * When a JSON skill has the same id as a markdown one already loaded, the
+ * markdown version wins and the JSON one is skipped — that's the migration
+ * path: drop a `.md` next to the old `.json` and the new format takes over.
+ *
+ * @param listFiles     lists files matching a glob pattern relative to cwd
+ * @param readFile      reads a file's text content at an absolute path
+ * @param workspaceRoot absolute workspace root
+ */
+async function loadWorkspaceSkills(listFiles, readFile, workspaceRoot) {
+    const skills = [];
+    const loadedIds = new Set();
+    const tryLoad = async (file, parse) => {
+        try {
+            // Cross-platform absolute-path detection: POSIX `/`, tilde,
+            // Windows drive (`C:\`), or UNC (`\\srv\share`). Without the
+            // Windows checks, an absolute path like `C:\Users\…\skill.json`
+            // gets concatenated onto workspaceRoot.
+            const absPath = file.startsWith('/') ||
+                file.startsWith('~') ||
+                /^[A-Za-z]:[\\/]/.test(file) ||
+                file.startsWith('\\\\')
+                ? file
+                : `${workspaceRoot}/${file}`;
+            const content = await readFile(absPath);
+            const skill = parse(content, file);
+            if (!skill)
+                return;
+            if (loadedIds.has(skill.id)) {
+                console.warn(`[skill-loader] Duplicate skill id "${skill.id}" in ${file} — ignoring (already loaded)`);
+                return;
+            }
+            loadedIds.add(skill.id);
+            skills.push(skill);
+        }
+        catch {
+            // Unreadable file — silent skip, same as the JSON-era behavior.
+        }
+    };
+    // Markdown first — new format wins when ids collide.
+    try {
+        const mdFiles = await listFiles(`${SKILLS_DIR}/*.md`, workspaceRoot);
+        const nestedMd = await listFiles(`${SKILLS_DIR}/*/SKILL.md`, workspaceRoot);
+        for (const file of [...mdFiles, ...nestedMd]) {
+            await tryLoad(file, parseMarkdownSkill);
+        }
+    }
+    catch {
+        // No markdown skills — fine.
+    }
+    try {
+        const jsonFiles = await listFiles(`${SKILLS_DIR}/*.json`, workspaceRoot);
+        for (const file of jsonFiles) {
+            await tryLoad(file, parseSkillManifest);
+        }
+    }
+    catch {
+        // No json skills either — also fine.
+    }
+    return skills;
+}
+/**
+ * Load workspace skills and register them with the given registry.
+ */
+async function registerWorkspaceSkills(registry, listFiles, readFile, workspaceRoot) {
+    const skills = await loadWorkspaceSkills(listFiles, readFile, workspaceRoot);
+    for (const skill of skills) {
+        registry.register(skill);
+    }
+    return skills.length;
+}
+/**
+ * A ready-to-save markdown skill scaffold. Used by the CLI's `/skill new`
+ * slash command so users (and the agent) never have to hand-write the YAML
+ * frontmatter from scratch. Kept here so there's one canonical template
+ * and it can't drift from what the parser expects.
+ */
+function scaffoldMarkdownSkill(id, displayName) {
+    const safeId = id.trim() || 'my-skill';
+    const name = (displayName ?? safeId).trim();
+    return [
+        '---',
+        `id: ${safeId}`,
+        `name: ${name}`,
+        `description: One line explaining WHEN the agent should reach for this skill.`,
+        `activation: auto`,
+        `triggers: [${safeId}]`,
+        '---',
+        '',
+        `# ${name}`,
+        '',
+        'Describe the playbook the agent should follow when this skill activates.',
+        'Prefer prose + fenced examples over rigid schemas — the body is fed straight',
+        'into the system prompt when a trigger matches.',
+        '',
+        '- When the user asks …, run `…`',
+        '- If … fails, suggest `…`',
+        ''
+    ].join('\n');
+}
+//# sourceMappingURL=skill-loader.js.map

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

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

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

@@ -0,0 +1,44 @@
+/**
+ * SkillRegistry — manages skill discovery, activation, and tool assembly.
+ *
+ * Builds on top of ToolRegistry. Skills are the unit of extensibility;
+ * ToolRegistry remains the unit of execution (what ToolUseLoop consumes).
+ */
+import type { SkillManifest } from './skill-types';
+import { ToolRegistry } from './tool-registry';
+export declare class SkillRegistry {
+    private readonly skills;
+    register(skill: SkillManifest): this;
+    registerAll(skills: SkillManifest[]): this;
+    get(id: string): SkillManifest | undefined;
+    getAll(): SkillManifest[];
+    has(id: string): boolean;
+    get size(): number;
+    /**
+     * Resolve which skills should be active for a given user prompt.
+     *
+     * Returns all 'always' skills plus any 'auto' skills whose triggerPatterns
+     * match the prompt. 'on-demand' skills are excluded unless explicitly listed
+     * in the `include` array.
+     */
+    resolveActiveSkills(prompt: string, include?: string[]): SkillManifest[];
+    /**
+     * Build a ToolRegistry containing all tools from the given active skills.
+     * Logs a warning on tool name collisions (last skill wins).
+     */
+    buildToolRegistry(activeSkills: SkillManifest[]): ToolRegistry;
+    /**
+     * Build a ToolRegistry plus a map of tool name → owning skill id so callers
+     * can surface skill-level context (e.g. "using skill: Linter") when a tool runs.
+     */
+    buildToolRegistryWithMap(activeSkills: SkillManifest[]): {
+        registry: ToolRegistry;
+        toolToSkill: Map<string, string>;
+    };
+    /**
+     * Build system prompt section describing active skills and their tools.
+     * Includes skill instructions and delegates tool definitions to ToolRegistry.
+     */
+    buildSkillPromptBlock(activeSkills: SkillManifest[]): string;
+}
+//# sourceMappingURL=skill-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill-registry.d.ts","sourceRoot":"","sources":["../../src/tools/skill-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;IAE3D,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAQpC,WAAW,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,IAAI;IAO1C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI1C,MAAM,IAAI,aAAa,EAAE;IAIzB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;;;OAMG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,aAAa,EAAE;IAwBxE;;;OAGG;IACH,iBAAiB,CAAC,YAAY,EAAE,aAAa,EAAE,GAAG,YAAY;IAI9D;;;OAGG;IACH,wBAAwB,CAAC,YAAY,EAAE,aAAa,EAAE,GAAG;QACvD,QAAQ,EAAE,YAAY,CAAC;QACvB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAClC;IAqBD;;;OAGG;IACH,qBAAqB,CAAC,YAAY,EAAE,aAAa,EAAE,GAAG,MAAM;CAmB7D"}

package/dist/tools/skill-registry.js

@@ -0,0 +1,118 @@
+"use strict";
+/**
+ * SkillRegistry — manages skill discovery, activation, and tool assembly.
+ *
+ * Builds on top of ToolRegistry. Skills are the unit of extensibility;
+ * ToolRegistry remains the unit of execution (what ToolUseLoop consumes).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SkillRegistry = void 0;
+const tool_registry_1 = require("./tool-registry");
+class SkillRegistry {
+    constructor() {
+        this.skills = new Map();
+    }
+    register(skill) {
+        if (this.skills.has(skill.id)) {
+            console.warn(`[SkillRegistry] Overwriting existing skill "${skill.id}"`);
+        }
+        this.skills.set(skill.id, skill);
+        return this;
+    }
+    registerAll(skills) {
+        for (const skill of skills) {
+            this.register(skill);
+        }
+        return this;
+    }
+    get(id) {
+        return this.skills.get(id);
+    }
+    getAll() {
+        return [...this.skills.values()];
+    }
+    has(id) {
+        return this.skills.has(id);
+    }
+    get size() {
+        return this.skills.size;
+    }
+    /**
+     * Resolve which skills should be active for a given user prompt.
+     *
+     * Returns all 'always' skills plus any 'auto' skills whose triggerPatterns
+     * match the prompt. 'on-demand' skills are excluded unless explicitly listed
+     * in the `include` array.
+     */
+    resolveActiveSkills(prompt, include) {
+        const includeSet = new Set(include ?? []);
+        const active = [];
+        for (const skill of this.skills.values()) {
+            if (skill.activation === 'always') {
+                active.push(skill);
+                continue;
+            }
+            if (includeSet.has(skill.id)) {
+                active.push(skill);
+                continue;
+            }
+            if (skill.activation === 'auto' && skill.triggerPatterns?.length) {
+                const matches = skill.triggerPatterns.some((pattern) => pattern.test(prompt));
+                if (matches) {
+                    active.push(skill);
+                }
+            }
+        }
+        return active;
+    }
+    /**
+     * Build a ToolRegistry containing all tools from the given active skills.
+     * Logs a warning on tool name collisions (last skill wins).
+     */
+    buildToolRegistry(activeSkills) {
+        return this.buildToolRegistryWithMap(activeSkills).registry;
+    }
+    /**
+     * Build a ToolRegistry plus a map of tool name → owning skill id so callers
+     * can surface skill-level context (e.g. "using skill: Linter") when a tool runs.
+     */
+    buildToolRegistryWithMap(activeSkills) {
+        const registry = new tool_registry_1.ToolRegistry();
+        const toolToSkill = new Map();
+        for (const skill of activeSkills) {
+            for (const tool of skill.tools) {
+                const existing = toolToSkill.get(tool.name);
+                if (existing) {
+                    console.warn(`[SkillRegistry] Tool "${tool.name}" from skill "${skill.id}" ` +
+                        `overwrites same-named tool from "${existing}"`);
+                }
+                registry.register(tool);
+                toolToSkill.set(tool.name, skill.id);
+            }
+        }
+        return { registry, toolToSkill };
+    }
+    /**
+     * Build system prompt section describing active skills and their tools.
+     * Includes skill instructions and delegates tool definitions to ToolRegistry.
+     */
+    buildSkillPromptBlock(activeSkills) {
+        if (activeSkills.length === 0)
+            return '';
+        const skillDescriptions = activeSkills.map((skill) => {
+            const header = `- **${skill.name}** (v${skill.version}): ${skill.description}`;
+            return skill.instructions ? `${header}\n  ${skill.instructions}` : header;
+        }).join('\n');
+        const registry = this.buildToolRegistry(activeSkills);
+        const toolBlock = registry.buildSystemPromptBlock();
+        return [
+            '## Active Skills',
+            '',
+            skillDescriptions,
+            '',
+            toolBlock
+        ].join('\n');
+    }
+}
+exports.SkillRegistry = SkillRegistry;
+//# sourceMappingURL=skill-registry.js.map

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

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

package/dist/tools/skill-types.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Skill types for the Bandit agent framework.
+ *
+ * A skill is a named, versioned group of tools with activation logic.
+ * Skills compose naturally with the existing ToolRegistry and ToolUseLoop —
+ * they're the unit of extensibility for the agent.
+ */
+import type { AgentTool } from './tool-types';
+export interface SkillManifest {
+    /** Unique skill identifier (e.g. "core/filesystem", "git/basics"). */
+    id: string;
+    /** Human-readable name for UI display. */
+    name: string;
+    /** Semver version string. */
+    version: string;
+    /** One-line description shown in the system prompt when the skill is active. */
+    description: string;
+    /**
+     * Extended instructions injected into the system prompt when the skill is active.
+     * Use this to give the model guidance on when and how to use this skill's tools.
+     */
+    instructions?: string;
+    /** Tools this skill provides. */
+    tools: AgentTool[];
+    /**
+     * When to activate this skill:
+     * - 'always': Active in every conversation (core tools, git).
+     * - 'auto': Activated when triggerPatterns match the user prompt.
+     * - 'on-demand': Only activated when explicitly requested.
+     */
+    activation: 'always' | 'auto' | 'on-demand';
+    /**
+     * Regex patterns matched against the user prompt for auto-activation.
+     * Only used when activation is 'auto'. Any match activates the skill.
+     */
+    triggerPatterns?: RegExp[];
+}
+//# sourceMappingURL=skill-types.d.ts.map

package/dist/tools/skill-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-types.d.ts","sourceRoot":"","sources":["../../src/tools/skill-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,WAAW,aAAa;IAC5B,sEAAsE;IACtE,EAAE,EAAE,MAAM,CAAC;IACX,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iCAAiC;IACjC,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB;;;;;OAKG;IACH,UAAU,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IAC5C;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B"}

package/dist/tools/skill-types.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Skill types for the Bandit agent framework.
+ *
+ * A skill is a named, versioned group of tools with activation logic.
+ * Skills compose naturally with the existing ToolRegistry and ToolUseLoop —
+ * they're the unit of extensibility for the agent.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=skill-types.js.map