@burtson-labs/agent-core 1.6.13

package/dist/tools/ocr.js

@@ -0,0 +1,238 @@
+"use strict";
+/**
+ * Local OCR — extract printed text from an image file without an LLM.
+ *
+ * Dispatcher picks the best available engine for the platform:
+ *   macOS   → Apple Vision via `swift` running a VNRecognizeTextRequest
+ *             script. ~100-300ms per image, excellent on rendered text
+ *             (code, logs, stack traces, dialogs).
+ *   Linux   → tesseract CLI (`apt install tesseract-ocr`). ~500ms-2s.
+ *   Windows → tesseract CLI (PowerShell.Windows.Media.Ocr could be
+ *             added later; tesseract covers the common case today).
+ *
+ * Used by the extension/CLI on bandit-logic turns where a user paste
+ * an image. When OCR yields usable text, we inline it into the prompt
+ * as an `[Image text (OCR): …]` block and skip the model swap. When
+ * OCR returns nothing (diagrams, photos, blurry), we fall back to a
+ * vision-capable model for that turn.
+ *
+ * Binary OCR engines themselves are not bundled — we shell out to what
+ * the user's OS already ships. Linux/Windows users see a one-time
+ * install hint when tesseract is missing.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectOcrAvailability = detectOcrAvailability;
+exports.extractImageText = extractImageText;
+exports.ocrYieldedUsefulText = ocrYieldedUsefulText;
+const cp = __importStar(require("child_process"));
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+/**
+ * Detect available OCR engines without actually running one. Used by the
+ * UI to decide whether to offer the "OCR-first" toggle. Results are
+ * cached for the process lifetime because `which` is a filesystem
+ * lookup we don't need to repeat on every image.
+ */
+let cachedAvailability = null;
+function detectOcrAvailability() {
+    if (cachedAvailability)
+        return cachedAvailability;
+    const apple = process.platform === 'darwin' && hasBinary('swift');
+    const tesseract = hasBinary('tesseract');
+    cachedAvailability = { apple, tesseract };
+    return cachedAvailability;
+}
+function hasBinary(name) {
+    try {
+        const result = cp.spawnSync(process.platform === 'win32' ? 'where' : 'which', [name], { stdio: 'pipe' });
+        return result.status === 0;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Extract text from an image at `imagePath`. Returns an OcrResult with
+ * empty `.text` on failure rather than throwing — callers treat "empty
+ * text" as the signal to fall back to an LLM-vision path.
+ */
+async function extractImageText(imagePath, options) {
+    const startedAt = Date.now();
+    const timeout = options?.timeoutMs ?? 8000;
+    if (!fs.existsSync(imagePath)) {
+        return { text: '', engine: 'none', durationMs: 0 };
+    }
+    const availability = detectOcrAvailability();
+    if (process.platform === 'darwin' && availability.apple) {
+        const text = await runAppleVision(imagePath, timeout);
+        if (text.length > 0) {
+            return { text, engine: 'apple-vision', durationMs: Date.now() - startedAt };
+        }
+    }
+    if (availability.tesseract) {
+        const text = await runTesseract(imagePath, timeout);
+        if (text.length > 0) {
+            return { text, engine: 'tesseract', durationMs: Date.now() - startedAt };
+        }
+    }
+    return { text: '', engine: 'none', durationMs: Date.now() - startedAt };
+}
+/**
+ * Inline Swift script that drives Apple's Vision framework. Using
+ * `swift -e` avoids shipping a compiled binary — Xcode CLT's `swift`
+ * is present on any Mac with dev tools. The script accepts the image
+ * path as argv[1] and prints extracted strings (one per line) to
+ * stdout. Any error goes to stderr with a non-zero exit so the caller
+ * can distinguish "empty image" from "tool failure".
+ */
+const APPLE_VISION_SCRIPT = `
+import Foundation
+import Vision
+import AppKit
+
+guard CommandLine.arguments.count >= 2 else {
+  FileHandle.standardError.write("usage: ocr <image-path>\\n".data(using: .utf8)!)
+  exit(2)
+}
+let path = CommandLine.arguments[1]
+guard let nsimage = NSImage(contentsOfFile: path), let tiff = nsimage.tiffRepresentation,
+      let rep = NSBitmapImageRep(data: tiff), let cg = rep.cgImage else {
+  FileHandle.standardError.write("failed to load image\\n".data(using: .utf8)!)
+  exit(3)
+}
+let request = VNRecognizeTextRequest()
+request.recognitionLevel = .accurate
+request.usesLanguageCorrection = false
+let handler = VNImageRequestHandler(cgImage: cg, options: [:])
+do {
+  try handler.perform([request])
+  let observations = request.results ?? []
+  var lines: [String] = []
+  for obs in observations {
+    if let top = obs.topCandidates(1).first {
+      lines.append(top.string)
+    }
+  }
+  print(lines.joined(separator: "\\n"))
+} catch {
+  FileHandle.standardError.write("vision error: \\(error.localizedDescription)\\n".data(using: .utf8)!)
+  exit(4)
+}
+`;
+function runAppleVision(imagePath, timeoutMs) {
+    return new Promise((resolve) => {
+        // Cache the script on disk so repeat invocations don't re-write it
+        // every call. `swift` interprets it with its line-by-line mode
+        // each time — the script itself is free, the Swift runtime cold
+        // start costs ~80-120ms.
+        const cachedScriptPath = path.join(os.tmpdir(), 'bandit-ocr-apple-vision.swift');
+        try {
+            if (!fs.existsSync(cachedScriptPath)) {
+                fs.writeFileSync(cachedScriptPath, APPLE_VISION_SCRIPT, 'utf-8');
+            }
+        }
+        catch {
+            resolve('');
+            return;
+        }
+        const child = cp.spawn('swift', [cachedScriptPath, imagePath], { stdio: ['ignore', 'pipe', 'pipe'] });
+        let stdout = '';
+        let stderr = '';
+        const timer = setTimeout(() => { try {
+            child.kill('SIGTERM');
+        }
+        catch { /* already gone */ } }, timeoutMs);
+        child.stdout.on('data', (d) => { stdout += d.toString(); });
+        child.stderr.on('data', (d) => { stderr += d.toString(); });
+        child.on('close', (code) => {
+            clearTimeout(timer);
+            if (code !== 0) {
+                resolve('');
+                return;
+            }
+            resolve(stdout.trim());
+        });
+        child.on('error', () => { clearTimeout(timer); resolve(''); });
+    });
+}
+/**
+ * Tesseract CLI invocation. `--psm 6` (uniform block of text) gives the
+ * best results on screenshots of code/logs; `--psm 3` (default) splits
+ * columns which hurts accuracy when the model then reads the result.
+ * `-l eng` is the safe default; users can override via a setting later.
+ */
+function runTesseract(imagePath, timeoutMs) {
+    return new Promise((resolve) => {
+        const child = cp.spawn('tesseract', [imagePath, '-', '-l', 'eng', '--psm', '6'], {
+            stdio: ['ignore', 'pipe', 'pipe']
+        });
+        let stdout = '';
+        const timer = setTimeout(() => { try {
+            child.kill('SIGTERM');
+        }
+        catch { /* already gone */ } }, timeoutMs);
+        child.stdout.on('data', (d) => { stdout += d.toString(); });
+        child.on('close', (code) => {
+            clearTimeout(timer);
+            if (code !== 0) {
+                resolve('');
+                return;
+            }
+            resolve(stdout.trim());
+        });
+        child.on('error', () => { clearTimeout(timer); resolve(''); });
+    });
+}
+/**
+ * Heuristic for "the OCR captured enough to be useful". Used by the
+ * image-handling path to decide between "inline OCR text + stay on
+ * current model" vs "fall back to a vision-capable model". Very cheap;
+ * runs once per image.
+ */
+function ocrYieldedUsefulText(text) {
+    if (!text)
+        return false;
+    const trimmed = text.trim();
+    if (trimmed.length < 30)
+        return false;
+    // Printable-ratio sanity check — if the "text" is mostly gibberish
+    // tokens (photo, diagram, blurry UI) the ratio of word chars to
+    // length drops below ~50%. Cheap and effective.
+    const alphaNum = (trimmed.match(/[A-Za-z0-9]/g) ?? []).length;
+    return alphaNum / trimmed.length > 0.45;
+}
+//# sourceMappingURL=ocr.js.map

package/dist/tools/ocr.js.map

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

package/dist/tools/post-edit-checks.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Post-edit deep checks — close the agent's feedback loop.
+ *
+ * Bandit's self-evaluations have repeatedly flagged "no automatic
+ * verification after changes" as a top gap. The existing language-
+ * adapter system runs a per-file PARSE check (ts.transpileModule for
+ * TS, JSON.parse for JSON, etc.) before write — fast, but doesn't
+ * catch type errors, broken imports, or any cross-file regression
+ * the model just introduced.
+ *
+ * This module runs the project-level tooling AFTER the write has
+ * landed and surfaces ONLY the errors that weren't there before.
+ * Pre-existing rot is ignored (same invariant as introducedNewErrors
+ * — we only block when THIS edit introduced something new).
+ *
+ * Strategy:
+ *   - lazy: only fires when the touched file lives in a project that
+ *     has the relevant tooling installed (tsconfig.json + typescript
+ *     in node_modules for the TS check). Quietly returns no-op when
+ *     the workspace doesn't support it — never blocks an edit on
+ *     missing tooling.
+ *   - per-project caching: the first edit to a project pays for
+ *     baselining the existing error set, subsequent edits diff
+ *     against that cached baseline (and update it after each run).
+ *   - bounded: 30s hard timeout so a broken tsconfig or huge project
+ *     can't lock up the loop.
+ *   - opt-in via NO env var (defaults on). Can be disabled per-call
+ *     by callers passing a flag, or globally by setting
+ *     BANDIT_DISABLE_POST_EDIT_CHECKS=1.
+ */
+import type { ToolExecutionContext } from './tool-types';
+export interface PostEditCheckResult {
+    /** Human-readable warning to append to the tool result. Undefined when
+     *  the check found no new errors or could not run. */
+    warning?: string;
+    /** Number of NEW errors detected (post − pre). Always 0 if warning is
+     *  undefined. Useful for telemetry. */
+    newErrorCount: number;
+}
+/**
+ * Run a post-edit project-level type check on the touched file's
+ * project. Returns any NEW errors introduced by this edit, ignoring
+ * pre-existing ones.
+ */
+export declare function runPostEditTypeCheck(absPath: string, ctx: ToolExecutionContext): Promise<PostEditCheckResult>;
+//# sourceMappingURL=post-edit-checks.d.ts.map

package/dist/tools/post-edit-checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-edit-checks.d.ts","sourceRoot":"","sources":["../../src/tools/post-edit-checks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAIH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAmFzD,MAAM,WAAW,mBAAmB;IAClC;0DACsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;2CACuC;IACvC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,oBAAoB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CAkF9B"}

package/dist/tools/post-edit-checks.js

@@ -0,0 +1,236 @@
+"use strict";
+/**
+ * Post-edit deep checks — close the agent's feedback loop.
+ *
+ * Bandit's self-evaluations have repeatedly flagged "no automatic
+ * verification after changes" as a top gap. The existing language-
+ * adapter system runs a per-file PARSE check (ts.transpileModule for
+ * TS, JSON.parse for JSON, etc.) before write — fast, but doesn't
+ * catch type errors, broken imports, or any cross-file regression
+ * the model just introduced.
+ *
+ * This module runs the project-level tooling AFTER the write has
+ * landed and surfaces ONLY the errors that weren't there before.
+ * Pre-existing rot is ignored (same invariant as introducedNewErrors
+ * — we only block when THIS edit introduced something new).
+ *
+ * Strategy:
+ *   - lazy: only fires when the touched file lives in a project that
+ *     has the relevant tooling installed (tsconfig.json + typescript
+ *     in node_modules for the TS check). Quietly returns no-op when
+ *     the workspace doesn't support it — never blocks an edit on
+ *     missing tooling.
+ *   - per-project caching: the first edit to a project pays for
+ *     baselining the existing error set, subsequent edits diff
+ *     against that cached baseline (and update it after each run).
+ *   - bounded: 30s hard timeout so a broken tsconfig or huge project
+ *     can't lock up the loop.
+ *   - opt-in via NO env var (defaults on). Can be disabled per-call
+ *     by callers passing a flag, or globally by setting
+ *     BANDIT_DISABLE_POST_EDIT_CHECKS=1.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPostEditTypeCheck = runPostEditTypeCheck;
+const path = __importStar(require("node:path"));
+const fs = __importStar(require("node:fs"));
+/**
+ * Per-project baseline cache — error set keyed by absolute tsconfig
+ * path. Module-scoped so it persists across edits in a single
+ * session. Fresh process / fresh CLI launch starts empty.
+ */
+const TS_BASELINE_CACHE = new Map();
+const POST_EDIT_TIMEOUT_MS = 30000;
+const MAX_NEW_ERRORS_REPORTED = 8;
+const TSC_FILE_EXTS = new Set(['ts', 'tsx', 'cts', 'mts']);
+/**
+ * Walk up from `start` looking for the nearest `tsconfig.json` (or
+ * `jsconfig.json` as a fallback for JS-only projects). Returns
+ * undefined if none found before hitting the filesystem root.
+ */
+function findNearestTsconfig(start) {
+    let dir = path.dirname(start);
+    const root = path.parse(dir).root;
+    while (dir && dir !== root) {
+        for (const candidate of ['tsconfig.json', 'jsconfig.json']) {
+            const probe = path.join(dir, candidate);
+            try {
+                if (fs.statSync(probe).isFile())
+                    return probe;
+            }
+            catch { /* not present, keep walking */ }
+        }
+        const next = path.dirname(dir);
+        if (next === dir)
+            break;
+        dir = next;
+    }
+    return undefined;
+}
+/**
+ * Detect whether the project has typescript installed locally —
+ * either a direct dep or hoisted to a parent `node_modules`. We
+ * check by looking for the ts binary in node_modules/.bin OR the
+ * package's package.json. Cheap stat, no resolve overhead.
+ */
+function hasTypeScriptInstalled(tsconfigPath) {
+    let dir = path.dirname(tsconfigPath);
+    const root = path.parse(dir).root;
+    while (dir && dir !== root) {
+        const probes = [
+            path.join(dir, 'node_modules', 'typescript', 'package.json'),
+            path.join(dir, 'node_modules', '.bin', 'tsc')
+        ];
+        for (const p of probes) {
+            try {
+                if (fs.statSync(p))
+                    return true;
+            }
+            catch { /* keep walking */ }
+        }
+        const next = path.dirname(dir);
+        if (next === dir)
+            break;
+        dir = next;
+    }
+    return false;
+}
+/**
+ * Parse `tsc --noEmit` output into a set of unique error lines.
+ * tsc lines look like:
+ *   src/foo.ts(12,3): error TS2304: Cannot find name 'bar'.
+ * We normalize position info out so the same logical error round-trips
+ * across edits that shift line numbers — same trick as
+ * introducedNewErrors in core-tools.ts.
+ */
+function parseTscErrors(stdout) {
+    const errors = new Set();
+    for (const rawLine of stdout.split('\n')) {
+        const line = rawLine.trim();
+        if (!line)
+            continue;
+        // Look for the "error TSxxxx" marker — tsc emits both errors and
+        // warnings; we only care about errors here.
+        if (!/error TS\d+:/.test(line))
+            continue;
+        // Strip line/col so a position shift doesn't register as a new
+        // error. "src/foo.ts(12,3)" → "src/foo.ts(N,N)".
+        const normalized = line.replace(/\(\d+,\d+\)/g, '(N,N)');
+        errors.add(normalized);
+    }
+    return errors;
+}
+/**
+ * Run a post-edit project-level type check on the touched file's
+ * project. Returns any NEW errors introduced by this edit, ignoring
+ * pre-existing ones.
+ */
+async function runPostEditTypeCheck(absPath, ctx) {
+    if (process.env.BANDIT_DISABLE_POST_EDIT_CHECKS === '1') {
+        return { newErrorCount: 0 };
+    }
+    // Only TS/TSX/CTS/MTS files trigger the tsc check. JS/JSX edits
+    // don't catch much from tsc unless allowJs is on, which is
+    // project-specific; skip for now to avoid false positives.
+    const ext = absPath.split('.').pop()?.toLowerCase() ?? '';
+    if (!TSC_FILE_EXTS.has(ext))
+        return { newErrorCount: 0 };
+    const tsconfig = findNearestTsconfig(absPath);
+    if (!tsconfig)
+        return { newErrorCount: 0 };
+    if (!hasTypeScriptInstalled(tsconfig))
+        return { newErrorCount: 0 };
+    // Run tsc --noEmit on the project. Use --incremental so subsequent
+    // runs in the same session use cached build info (much faster than
+    // a cold compile). The buildinfo path is per-tsconfig hash so two
+    // workspaces don't collide.
+    const tsconfigDir = path.dirname(tsconfig);
+    let result;
+    try {
+        // Use a Promise.race against a timeout — ctx.runCommand does its
+        // own timeout but we want a hard cap regardless of host config.
+        result = await Promise.race([
+            ctx.runCommand('npx', ['--no-install', 'tsc', '--noEmit', '-p', tsconfig, '--incremental'], tsconfigDir),
+            new Promise((resolve) => {
+                setTimeout(() => resolve({
+                    stdout: '',
+                    stderr: 'post-edit-check: tsc timed out after 30s',
+                    exitCode: 124
+                }), POST_EDIT_TIMEOUT_MS);
+            })
+        ]);
+    }
+    catch (err) {
+        // Don't let post-edit-check failure break the tool result.
+        return { newErrorCount: 0, warning: undefined };
+    }
+    if (result.exitCode === 124) {
+        // Timeout — skip silently rather than report a stale baseline.
+        return { newErrorCount: 0 };
+    }
+    const currentErrors = parseTscErrors(result.stdout + '\n' + result.stderr);
+    const cached = TS_BASELINE_CACHE.get(tsconfig);
+    // Update cache regardless so the next edit diffs against THIS state.
+    TS_BASELINE_CACHE.set(tsconfig, currentErrors);
+    // First run for this project — no baseline to diff against. Record
+    // the current error set as the baseline; do not report anything.
+    // The first edit per project per session is "free" — we only catch
+    // NEW errors from EDIT N+1 onwards. Trade-off: the very first edit
+    // could introduce errors that go unreported until the next edit.
+    // Acceptable for now; alternative is to baseline pre-edit on EVERY
+    // first edit which doubles the latency budget.
+    if (!cached)
+        return { newErrorCount: 0 };
+    const newErrors = [];
+    for (const err of currentErrors) {
+        if (!cached.has(err))
+            newErrors.push(err);
+    }
+    if (newErrors.length === 0)
+        return { newErrorCount: 0 };
+    const shown = newErrors.slice(0, MAX_NEW_ERRORS_REPORTED);
+    const more = newErrors.length > MAX_NEW_ERRORS_REPORTED
+        ? `\n  …and ${newErrors.length - MAX_NEW_ERRORS_REPORTED} more`
+        : '';
+    const projectLabel = path.relative(process.cwd(), tsconfig) || tsconfig;
+    return {
+        newErrorCount: newErrors.length,
+        warning: `\n\n[Post-edit type check on ${projectLabel}] ${newErrors.length} NEW TypeScript error${newErrors.length === 1 ? '' : 's'} this edit introduced:\n  ` +
+            shown.join('\n  ') +
+            more +
+            '\n\nFix these in the next iteration. Pre-existing errors in the project are ignored.'
+    };
+}
+//# sourceMappingURL=post-edit-checks.js.map

package/dist/tools/post-edit-checks.js.map

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

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

@@ -0,0 +1,94 @@
+/**
+ * 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}}" }
+ *       ]
+ *     }
+ */
+import type { SkillManifest } from './skill-types';
+import type { AgentTool } from './tool-types';
+import { SkillRegistry } from './skill-registry';
+interface RawToolManifest {
+    name: string;
+    description: string;
+    parameters?: Array<{
+        name: string;
+        description: string;
+        required?: boolean;
+    }>;
+    command?: string;
+}
+export declare function buildToolFromManifest(raw: RawToolManifest): AgentTool;
+/**
+ * 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
+ */
+export declare function loadWorkspaceSkills(listFiles: (pattern: string, cwd?: string) => Promise<string[]>, readFile: (path: string) => Promise<string>, workspaceRoot: string): Promise<SkillManifest[]>;
+/**
+ * Load workspace skills and register them with the given registry.
+ */
+export declare function registerWorkspaceSkills(registry: SkillRegistry, listFiles: (pattern: string, cwd?: string) => Promise<string[]>, readFile: (path: string) => Promise<string>, workspaceRoot: string): Promise<number>;
+/**
+ * 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.
+ */
+export declare function scaffoldMarkdownSkill(id: string, displayName?: string): string;
+export {};
+//# sourceMappingURL=skill-loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill-loader.d.ts","sourceRoot":"","sources":["../../src/tools/skill-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAoC,MAAM,cAAc,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAIjD,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAuBD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,eAAe,GAAG,SAAS,CA2DrE;AA+ND;;;;;;;;;;;GAWG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,EAC/D,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,EAC3C,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,aAAa,EAAE,CAAC,CAoD1B;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,aAAa,EACvB,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,EAC/D,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,EAC3C,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC,CAMjB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAsB9E"}