@esankhan3/anvil-agent-core 0.1.0

package/dist/skills/loader.js

@@ -0,0 +1,49 @@
+/**
+ * Skill loader — scans a directory for `<name>/SKILL.md` files and parses each.
+ *
+ * Malformed SKILL.md files are logged to stderr and skipped (non-fatal),
+ * matching ADR acceptance.
+ */
+import { readdirSync, readFileSync, statSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { parseSkillMarkdown } from './parser.js';
+export function loadSkills(opts) {
+    const { dir } = opts;
+    if (!existsSync(dir))
+        return [];
+    let entries;
+    try {
+        entries = readdirSync(dir);
+    }
+    catch (err) {
+        process.stderr.write(`[anvil-skills] WARN: cannot read ${dir}: ${err.message}\n`);
+        return [];
+    }
+    const out = [];
+    for (const entry of entries) {
+        const skillDir = join(dir, entry);
+        let isDir = false;
+        try {
+            isDir = statSync(skillDir).isDirectory();
+        }
+        catch {
+            continue;
+        }
+        if (!isDir)
+            continue;
+        const skillFile = join(skillDir, 'SKILL.md');
+        if (!existsSync(skillFile))
+            continue;
+        try {
+            const raw = readFileSync(skillFile, 'utf-8');
+            const { frontmatter, body } = parseSkillMarkdown(raw);
+            const resources = readdirSync(skillDir).filter((f) => f !== 'SKILL.md');
+            out.push({ path: skillFile, frontmatter, body, resources });
+        }
+        catch (err) {
+            process.stderr.write(`[anvil-skills] WARN: skipping ${skillFile}: ${err.message}\n`);
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=loader.js.map

package/dist/skills/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/skills/loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGjD,MAAM,UAAU,UAAU,CAAC,IAAsB;IAC/C,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IACrB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAChC,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oCAAoC,GAAG,KAAM,GAAa,CAAC,OAAO,IAAI,CAAC,CAAC;QAC7F,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,GAAG,GAAY,EAAE,CAAC;IACxB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAClC,IAAI,KAAK,GAAG,KAAK,CAAC;QAClB,IAAI,CAAC;YACH,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,CAAC,KAAK;YAAE,SAAS;QAErB,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAC7C,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,SAAS;QAErC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YAC7C,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;YACtD,MAAM,SAAS,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC;YACxE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QAC9D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,iCAAiC,SAAS,KAAM,GAAa,CAAC,OAAO,IAAI,CAC1E,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/skills/parser.d.ts

@@ -0,0 +1,13 @@
+/**
+ * SKILL.md parser — frontmatter + body splitter.
+ *
+ * Per ADR §3.3, accepts both kebab-case (spec) and camelCase frontmatter
+ * keys and normalizes to camelCase internally.
+ */
+import type { SkillFrontmatter } from './types.js';
+export interface ParsedSkill {
+    frontmatter: SkillFrontmatter;
+    body: string;
+}
+export declare function parseSkillMarkdown(raw: string): ParsedSkill;
+//# sourceMappingURL=parser.d.ts.map

package/dist/skills/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/skills/parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAInD,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,gBAAgB,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CA0B3D"}

package/dist/skills/parser.js

@@ -0,0 +1,60 @@
+/**
+ * SKILL.md parser — frontmatter + body splitter.
+ *
+ * Per ADR §3.3, accepts both kebab-case (spec) and camelCase frontmatter
+ * keys and normalizes to camelCase internally.
+ */
+import { parse as parseYaml } from 'yaml';
+const FRONTMATTER_RE = /^---\r?\n([\s\S]+?)\r?\n---\r?\n?([\s\S]*)$/;
+export function parseSkillMarkdown(raw) {
+    const m = FRONTMATTER_RE.exec(raw);
+    if (!m) {
+        throw new Error('SKILL.md missing frontmatter (--- ... ---)');
+    }
+    const fmRaw = parseYaml(m[1]);
+    if (!fmRaw || typeof fmRaw !== 'object') {
+        throw new Error('SKILL.md frontmatter is not a YAML mapping');
+    }
+    const fm = fmRaw;
+    const name = pickString(fm, 'name');
+    const description = pickString(fm, 'description');
+    if (!name)
+        throw new Error('SKILL.md frontmatter missing required `name`');
+    if (!description)
+        throw new Error('SKILL.md frontmatter missing required `description`');
+    return {
+        frontmatter: {
+            name,
+            description,
+            allowedTools: pickStringArray(fm, 'allowedTools', 'allowed-tools'),
+            disableModelInvocation: pickBool(fm, 'disableModelInvocation', 'disable-model-invocation'),
+            version: pickString(fm, 'version'),
+        },
+        body: m[2].trim(),
+    };
+}
+function pickString(fm, ...keys) {
+    for (const k of keys) {
+        const v = fm[k];
+        if (typeof v === 'string' && v.length > 0)
+            return v;
+    }
+    return undefined;
+}
+function pickStringArray(fm, ...keys) {
+    for (const k of keys) {
+        const v = fm[k];
+        if (Array.isArray(v) && v.every((x) => typeof x === 'string'))
+            return v;
+    }
+    return undefined;
+}
+function pickBool(fm, ...keys) {
+    for (const k of keys) {
+        const v = fm[k];
+        if (typeof v === 'boolean')
+            return v;
+    }
+    return undefined;
+}
+//# sourceMappingURL=parser.js.map

package/dist/skills/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../src/skills/parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAG1C,MAAM,cAAc,GAAG,6CAA6C,CAAC;AAOrE,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,MAAM,CAAC,GAAG,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IACD,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IACD,MAAM,EAAE,GAAG,KAAgC,CAAC;IAE5C,MAAM,IAAI,GAAG,UAAU,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IACpC,MAAM,WAAW,GAAG,UAAU,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC;IAClD,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAC3E,IAAI,CAAC,WAAW;QAAE,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IAEzF,OAAO;QACL,WAAW,EAAE;YACX,IAAI;YACJ,WAAW;YACX,YAAY,EAAE,eAAe,CAAC,EAAE,EAAE,cAAc,EAAE,eAAe,CAAC;YAClE,sBAAsB,EAAE,QAAQ,CAAC,EAAE,EAAE,wBAAwB,EAAE,0BAA0B,CAAC;YAC1F,OAAO,EAAE,UAAU,CAAC,EAAE,EAAE,SAAS,CAAC;SACnC;QACD,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;KAClB,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,EAA2B,EAAE,GAAG,IAAc;IAChE,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QAChB,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,eAAe,CAAC,EAA2B,EAAE,GAAG,IAAc;IACrE,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QAChB,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;YAAE,OAAO,CAAa,CAAC;IACtF,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,QAAQ,CAAC,EAA2B,EAAE,GAAG,IAAc;IAC9D,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QAChB,IAAI,OAAO,CAAC,KAAK,SAAS;YAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/skills/render.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Skills → system prompt renderer.
+ *
+ * Output format follows ADR §H1 (Anthropic-OpenAI SKILL.md spec). The
+ * "## Available Skills" anchor + the per-skill "### <name>" + description
+ * pattern is what both Claude Code and Codex CLI emit.
+ */
+import type { ActivatedSkills } from './activator.js';
+export declare function renderSkillsForPrompt(activated: ActivatedSkills): string;
+export declare const SKILLS_PROMPT_HEADER = "## Available Skills";
+//# sourceMappingURL=render.d.ts.map

package/dist/skills/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/skills/render.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAStD,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,eAAe,GAAG,MAAM,CAMxE;AAED,eAAO,MAAM,oBAAoB,wBAAgB,CAAC"}

package/dist/skills/render.js

@@ -0,0 +1,21 @@
+/**
+ * Skills → system prompt renderer.
+ *
+ * Output format follows ADR §H1 (Anthropic-OpenAI SKILL.md spec). The
+ * "## Available Skills" anchor + the per-skill "### <name>" + description
+ * pattern is what both Claude Code and Codex CLI emit.
+ */
+const SKILLS_HEADER = '## Available Skills';
+const SKILLS_PREAMBLE = [
+    'You have access to the following skills. Each skill provides procedural',
+    "knowledge for a specific task. Read the skill's instructions when its",
+    "description matches the user's request.",
+].join('\n');
+export function renderSkillsForPrompt(activated) {
+    if (activated.skills.length === 0)
+        return '';
+    const sections = activated.skills.map((s) => `### ${s.frontmatter.name}\n${s.frontmatter.description}\n\n${s.body}`);
+    return [SKILLS_HEADER, '', SKILLS_PREAMBLE, '', ...sections].join('\n');
+}
+export const SKILLS_PROMPT_HEADER = SKILLS_HEADER;
+//# sourceMappingURL=render.js.map

package/dist/skills/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/skills/render.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,aAAa,GAAG,qBAAqB,CAAC;AAC5C,MAAM,eAAe,GAAG;IACtB,yEAAyE;IACzE,uEAAuE;IACvE,yCAAyC;CAC1C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,UAAU,qBAAqB,CAAC,SAA0B;IAC9D,IAAI,SAAS,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC7C,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,GAAG,CACnC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,CAAC,WAAW,CAAC,WAAW,OAAO,CAAC,CAAC,IAAI,EAAE,CAC9E,CAAC;IACF,OAAO,CAAC,aAAa,EAAE,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAG,aAAa,CAAC"}

package/dist/skills/resolve-dir.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Skills directory resolution — locked search order per ADR §8.
+ *
+ *   1. process.env.ANVIL_SKILLS_DIR (full-path override)
+ *   2. <workspaceRoot>/.claude/skills/
+ *   3. $HOME/.claude/skills/
+ *
+ * Returns the first existing path, or undefined when none of the candidates
+ * exist (in which case `loadSkills` returns []).
+ */
+export interface ResolveSkillsDirOptions {
+    /** Absolute workspace root; .claude/skills under this is checked second. */
+    workspaceRoot?: string;
+    /** Override for env-var lookup (test seam). */
+    env?: NodeJS.ProcessEnv;
+    /** Override for $HOME lookup (test seam). */
+    homeDir?: string;
+}
+export declare function resolveSkillsDir(opts?: ResolveSkillsDirOptions): string | undefined;
+//# sourceMappingURL=resolve-dir.d.ts.map

package/dist/skills/resolve-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-dir.d.ts","sourceRoot":"","sources":["../../src/skills/resolve-dir.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,MAAM,WAAW,uBAAuB;IACtC,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,uBAA4B,GAAG,MAAM,GAAG,SAAS,CAgBvF"}

package/dist/skills/resolve-dir.js

@@ -0,0 +1,30 @@
+/**
+ * Skills directory resolution — locked search order per ADR §8.
+ *
+ *   1. process.env.ANVIL_SKILLS_DIR (full-path override)
+ *   2. <workspaceRoot>/.claude/skills/
+ *   3. $HOME/.claude/skills/
+ *
+ * Returns the first existing path, or undefined when none of the candidates
+ * exist (in which case `loadSkills` returns []).
+ */
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+export function resolveSkillsDir(opts = {}) {
+    const env = opts.env ?? process.env;
+    const home = opts.homeDir ?? homedir();
+    const override = env.ANVIL_SKILLS_DIR;
+    if (override && existsSync(override))
+        return override;
+    if (opts.workspaceRoot) {
+        const ws = join(opts.workspaceRoot, '.claude', 'skills');
+        if (existsSync(ws))
+            return ws;
+    }
+    const userGlobal = join(home, '.claude', 'skills');
+    if (existsSync(userGlobal))
+        return userGlobal;
+    return undefined;
+}
+//# sourceMappingURL=resolve-dir.js.map

package/dist/skills/resolve-dir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-dir.js","sourceRoot":"","sources":["../../src/skills/resolve-dir.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAWlC,MAAM,UAAU,gBAAgB,CAAC,OAAgC,EAAE;IACjE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACpC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,IAAI,OAAO,EAAE,CAAC;IAEvC,MAAM,QAAQ,GAAG,GAAG,CAAC,gBAAgB,CAAC;IACtC,IAAI,QAAQ,IAAI,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IAEtD,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;QACvB,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QACzD,IAAI,UAAU,CAAC,EAAE,CAAC;YAAE,OAAO,EAAE,CAAC;IAChC,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IACnD,IAAI,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,UAAU,CAAC;IAE9C,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/skills/tool-policy.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Tool-policy reconciliation between caller-allowed tools and skill-declared
+ * `allowed-tools` constraints.
+ *
+ * Per ADR §H1 + plan §2.4:
+ *   - Skills can constrain (subtract from caller's wide list) but never expand.
+ *   - If no activated skill declares `allowed-tools`, caller's policy passes
+ *     through unchanged.
+ *   - Otherwise the result is `(union of all skill allowed-tools) ∩ caller`.
+ *   - If caller is undefined ("any tool"), the result is the union itself.
+ */
+import type { Skill } from './types.js';
+export interface ToolPolicyResult {
+    /**
+     * Resolved tool list. `undefined` means "no constraint" (caller's
+     * pre-existing semantics for unrestricted tool access).
+     */
+    allowedTools: string[] | undefined;
+    /**
+     * True iff at least one activated skill declared an allowed-tools list,
+     * i.e. the caller's policy was actually narrowed.
+     */
+    constrained: boolean;
+}
+export declare function applyToolPolicy(callerAllowed: string[] | undefined, activatedSkills: Skill[]): ToolPolicyResult;
+//# sourceMappingURL=tool-policy.d.ts.map

package/dist/skills/tool-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-policy.d.ts","sourceRoot":"","sources":["../../src/skills/tool-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,YAAY,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACnC;;;OAGG;IACH,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,wBAAgB,eAAe,CAC7B,aAAa,EAAE,MAAM,EAAE,GAAG,SAAS,EACnC,eAAe,EAAE,KAAK,EAAE,GACvB,gBAAgB,CAsBlB"}

package/dist/skills/tool-policy.js

@@ -0,0 +1,33 @@
+/**
+ * Tool-policy reconciliation between caller-allowed tools and skill-declared
+ * `allowed-tools` constraints.
+ *
+ * Per ADR §H1 + plan §2.4:
+ *   - Skills can constrain (subtract from caller's wide list) but never expand.
+ *   - If no activated skill declares `allowed-tools`, caller's policy passes
+ *     through unchanged.
+ *   - Otherwise the result is `(union of all skill allowed-tools) ∩ caller`.
+ *   - If caller is undefined ("any tool"), the result is the union itself.
+ */
+export function applyToolPolicy(callerAllowed, activatedSkills) {
+    const skillUnion = new Set();
+    let anySkillConstraint = false;
+    for (const s of activatedSkills) {
+        const at = s.frontmatter.allowedTools;
+        if (at && at.length > 0) {
+            anySkillConstraint = true;
+            for (const tool of at)
+                skillUnion.add(tool);
+        }
+    }
+    if (!anySkillConstraint) {
+        return { allowedTools: callerAllowed, constrained: false };
+    }
+    if (callerAllowed === undefined) {
+        return { allowedTools: [...skillUnion].sort(), constrained: true };
+    }
+    const callerSet = new Set(callerAllowed);
+    const intersection = [...skillUnion].filter((t) => callerSet.has(t)).sort();
+    return { allowedTools: intersection, constrained: true };
+}
+//# sourceMappingURL=tool-policy.js.map

package/dist/skills/tool-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-policy.js","sourceRoot":"","sources":["../../src/skills/tool-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAiBH,MAAM,UAAU,eAAe,CAC7B,aAAmC,EACnC,eAAwB;IAExB,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,IAAI,kBAAkB,GAAG,KAAK,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,eAAe,EAAE,CAAC;QAChC,MAAM,EAAE,GAAG,CAAC,CAAC,WAAW,CAAC,YAAY,CAAC;QACtC,IAAI,EAAE,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,kBAAkB,GAAG,IAAI,CAAC;YAC1B,KAAK,MAAM,IAAI,IAAI,EAAE;gBAAE,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACxB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IAC7D,CAAC;IAED,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,EAAE,YAAY,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IACrE,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC;IACzC,MAAM,YAAY,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5E,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;AAC3D,CAAC"}

package/dist/skills/types.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Skill types — Anthropic-OpenAI SKILL.md open standard.
+ *
+ * See AGENT-HARNESS-ADR.md §3 for the locked schema (required vs optional
+ * fields, key normalization rules).
+ */
+export interface SkillFrontmatter {
+    /** Slug-safe identifier; used in registry + namespacing. */
+    name: string;
+    /** One-sentence hook the model uses to decide whether to load the skill. */
+    description: string;
+    /**
+     * Constrains the caller's tool list while the skill is active.
+     * Semantics: intersection with caller's allowed tools — skills can subtract,
+     * never expand.
+     */
+    allowedTools?: string[];
+    /**
+     * If true, skill is loaded only on explicit selection, not auto-routed
+     * via description matching. Default: false.
+     */
+    disableModelInvocation?: boolean;
+    /** Free-form (semver suggested) for cache busting. */
+    version?: string;
+}
+export interface Skill {
+    /** Filesystem path of the SKILL.md file. */
+    path: string;
+    /** Parsed + normalized frontmatter. */
+    frontmatter: SkillFrontmatter;
+    /** Markdown body (after the frontmatter block, trimmed). */
+    body: string;
+    /** Sibling files under the skill's directory (e.g. scripts, templates). */
+    resources: string[];
+}
+export interface SkillLoadOptions {
+    /** Absolute path to the skills directory. */
+    dir: string;
+    /** Maximum total body bytes to inject; defaults to 32 KB. */
+    maxBytes?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/skills/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/skills/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;;OAGG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,KAAK;IACpB,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,WAAW,EAAE,gBAAgB,CAAC;IAC9B,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/skills/types.js

@@ -0,0 +1,8 @@
+/**
+ * Skill types — Anthropic-OpenAI SKILL.md open standard.
+ *
+ * See AGENT-HARNESS-ADR.md §3 for the locked schema (required vs optional
+ * fields, key normalization rules).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/skills/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/skills/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/stream-format.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Anvil Stream Format helpers.
+ *
+ * Every non-Claude adapter uses these functions to produce NDJSON output that
+ * matches `claude --output-format stream-json`, so all existing parsers
+ * (run-feature.ts, agent-process.ts, spawn.ts) work without modification.
+ *
+ * Line format reference:
+ *   Content:  {"type":"assistant","message":{"content":[{"type":"text","text":"..."}]}}
+ *   Tool use: {"type":"assistant","message":{"content":[{"type":"tool_use","name":"...","input":{...}}]}}
+ *   Thinking: {"type":"assistant","message":{"content":[{"type":"thinking","text":"..."}]}}
+ *   Result:   {"type":"result","result":"...","total_cost_usd":0.123,"usage":{...},"duration_ms":5000,"session_id":"..."}
+ */
+export interface TextContentBlock {
+    type: 'text';
+    text: string;
+}
+export interface ToolUseContentBlock {
+    type: 'tool_use';
+    /** Pairing id consumed by `LanguageModelBridge` to match tool_result. */
+    id?: string;
+    name: string;
+    input: Record<string, unknown>;
+}
+export interface ToolResultContentBlock {
+    type: 'tool_result';
+    tool_use_id: string;
+    content: string;
+    is_error?: boolean;
+}
+export interface UserMessage {
+    type: 'user';
+    message: {
+        content: ToolResultContentBlock[];
+    };
+}
+export interface ThinkingContentBlock {
+    type: 'thinking';
+    text: string;
+}
+export type ContentBlock = TextContentBlock | ToolUseContentBlock | ThinkingContentBlock;
+export interface AssistantMessage {
+    type: 'assistant';
+    message: {
+        content: ContentBlock[];
+    };
+}
+export interface ResultUsage {
+    input_tokens: number;
+    output_tokens: number;
+    cache_read_input_tokens: number;
+    cache_creation_input_tokens: number;
+}
+export interface ResultMessage {
+    type: 'result';
+    result: string;
+    total_cost_usd: number;
+    usage: ResultUsage;
+    duration_ms: number;
+    session_id?: string;
+}
+export type StreamLine = AssistantMessage | UserMessage | ResultMessage;
+/** Emit a text content block. */
+export declare function emitContent(out: NodeJS.WritableStream, text: string): void;
+/**
+ * Emit a tool_use content block.
+ *
+ * `id` is the pairing identifier the bridge uses to match this call to
+ * its eventual `tool_result`. Adapters that drive their own agentic
+ * loop (Ollama, future OpenAI/Gemini agentic paths) MUST pass an id;
+ * legacy single-shot callers may omit it.
+ */
+export declare function emitToolUse(out: NodeJS.WritableStream, name: string, input: Record<string, unknown>, id?: string): void;
+/**
+ * Emit a tool_result content block (user-role message).
+ *
+ * Used by adapters that own their agentic loop and need to feed tool
+ * outputs back to the model. `LanguageModelBridge` pairs `tool_use_id`
+ * to the open span and closes it on receipt — same pairing logic as
+ * Claude CLI's native stream.
+ */
+export declare function emitToolResult(out: NodeJS.WritableStream, opts: {
+    toolUseId: string;
+    content: string;
+    isError?: boolean;
+}): void;
+/** Emit a thinking content block. */
+export declare function emitThinking(out: NodeJS.WritableStream, text: string): void;
+/** Emit the final result line. */
+export declare function emitResult(out: NodeJS.WritableStream, opts: {
+    text: string;
+    costUsd: number;
+    inputTokens: number;
+    outputTokens: number;
+    durationMs: number;
+    sessionId?: string;
+    cacheReadTokens?: number;
+    cacheWriteTokens?: number;
+}): void;
+//# sourceMappingURL=stream-format.d.ts.map

package/dist/stream-format.d.ts.map

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

package/dist/stream-format.js

@@ -0,0 +1,90 @@
+/**
+ * Anvil Stream Format helpers.
+ *
+ * Every non-Claude adapter uses these functions to produce NDJSON output that
+ * matches `claude --output-format stream-json`, so all existing parsers
+ * (run-feature.ts, agent-process.ts, spawn.ts) work without modification.
+ *
+ * Line format reference:
+ *   Content:  {"type":"assistant","message":{"content":[{"type":"text","text":"..."}]}}
+ *   Tool use: {"type":"assistant","message":{"content":[{"type":"tool_use","name":"...","input":{...}}]}}
+ *   Thinking: {"type":"assistant","message":{"content":[{"type":"thinking","text":"..."}]}}
+ *   Result:   {"type":"result","result":"...","total_cost_usd":0.123,"usage":{...},"duration_ms":5000,"session_id":"..."}
+ */
+// ---------------------------------------------------------------------------
+// Emit helpers — each writes exactly one NDJSON line (JSON + '\n')
+// ---------------------------------------------------------------------------
+/** Emit a text content block. */
+export function emitContent(out, text) {
+    const line = {
+        type: 'assistant',
+        message: {
+            content: [{ type: 'text', text }],
+        },
+    };
+    out.write(JSON.stringify(line) + '\n');
+}
+/**
+ * Emit a tool_use content block.
+ *
+ * `id` is the pairing identifier the bridge uses to match this call to
+ * its eventual `tool_result`. Adapters that drive their own agentic
+ * loop (Ollama, future OpenAI/Gemini agentic paths) MUST pass an id;
+ * legacy single-shot callers may omit it.
+ */
+export function emitToolUse(out, name, input, id) {
+    const block = id !== undefined
+        ? { type: 'tool_use', id, name, input }
+        : { type: 'tool_use', name, input };
+    const line = {
+        type: 'assistant',
+        message: { content: [block] },
+    };
+    out.write(JSON.stringify(line) + '\n');
+}
+/**
+ * Emit a tool_result content block (user-role message).
+ *
+ * Used by adapters that own their agentic loop and need to feed tool
+ * outputs back to the model. `LanguageModelBridge` pairs `tool_use_id`
+ * to the open span and closes it on receipt — same pairing logic as
+ * Claude CLI's native stream.
+ */
+export function emitToolResult(out, opts) {
+    const block = {
+        type: 'tool_result',
+        tool_use_id: opts.toolUseId,
+        content: opts.content,
+        ...(opts.isError !== undefined ? { is_error: opts.isError } : {}),
+    };
+    const line = { type: 'user', message: { content: [block] } };
+    out.write(JSON.stringify(line) + '\n');
+}
+/** Emit a thinking content block. */
+export function emitThinking(out, text) {
+    const line = {
+        type: 'assistant',
+        message: {
+            content: [{ type: 'thinking', text }],
+        },
+    };
+    out.write(JSON.stringify(line) + '\n');
+}
+/** Emit the final result line. */
+export function emitResult(out, opts) {
+    const line = {
+        type: 'result',
+        result: opts.text,
+        total_cost_usd: opts.costUsd,
+        usage: {
+            input_tokens: opts.inputTokens,
+            output_tokens: opts.outputTokens,
+            cache_read_input_tokens: opts.cacheReadTokens ?? 0,
+            cache_creation_input_tokens: opts.cacheWriteTokens ?? 0,
+        },
+        duration_ms: opts.durationMs,
+        ...(opts.sessionId != null ? { session_id: opts.sessionId } : {}),
+    };
+    out.write(JSON.stringify(line) + '\n');
+}
+//# sourceMappingURL=stream-format.js.map

package/dist/stream-format.js.map

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

package/dist/telemetry/attributes.d.ts

@@ -0,0 +1,38 @@
+/**
+ * GenAI semantic-convention attribute keys.
+ *
+ * Mirrors the OpenTelemetry GenAI SIG spec
+ * (https://opentelemetry.io/docs/specs/semconv/gen-ai/llm-spans/) plus
+ * Anvil-specific extensions for cost USD, cache tokens, and tool argument
+ * size. Anvil-extension attributes follow the same `gen_ai.*` namespace so
+ * backends without LLM-specific UIs still render them as plain attributes.
+ */
+export declare const GenAi: {
+    readonly SYSTEM: "gen_ai.system";
+    readonly REQUEST_MODEL: "gen_ai.request.model";
+    readonly REQUEST_MAX_TOKENS: "gen_ai.request.max_tokens";
+    readonly REQUEST_TEMPERATURE: "gen_ai.request.temperature";
+    readonly RESPONSE_FINISH_REASONS: "gen_ai.response.finish_reasons";
+    readonly RESPONSE_MODEL: "gen_ai.response.model";
+    readonly RESPONSE_ID: "gen_ai.response.id";
+    readonly USAGE_INPUT_TOKENS: "gen_ai.usage.input_tokens";
+    readonly USAGE_OUTPUT_TOKENS: "gen_ai.usage.output_tokens";
+    readonly TOOL_NAME: "gen_ai.tool.name";
+    readonly USAGE_CACHE_READ_TOKENS: "gen_ai.usage.cache_read_tokens";
+    readonly USAGE_CACHE_WRITE_TOKENS: "gen_ai.usage.cache_write_tokens";
+    readonly USAGE_CACHE_HIT_RATIO: "gen_ai.usage.cache_hit_ratio";
+    readonly USAGE_COST_USD: "gen_ai.usage.cost_usd";
+    readonly USAGE_COST_INPUT_USD: "gen_ai.usage.cost_input_usd";
+    readonly USAGE_COST_OUTPUT_USD: "gen_ai.usage.cost_output_usd";
+    readonly USAGE_COST_CACHE_READ_USD: "gen_ai.usage.cost_cache_read_usd";
+    readonly USAGE_COST_CACHE_WRITE_USD: "gen_ai.usage.cost_cache_write_usd";
+    readonly TOOL_ARGUMENTS_SIZE: "gen_ai.tool.arguments_size_bytes";
+    readonly REASONING_TOKENS: "gen_ai.reasoning.tokens";
+    readonly REASONING_TEXT: "gen_ai.reasoning.text";
+    readonly MESSAGES_COUNT: "gen_ai.messages.count";
+    readonly TOOLS_COUNT: "gen_ai.tools.count";
+    readonly PROMPT: "gen_ai.prompt";
+    readonly COMPLETION: "gen_ai.completion";
+};
+export type GenAiAttribute = (typeof GenAi)[keyof typeof GenAi];
+//# sourceMappingURL=attributes.d.ts.map

package/dist/telemetry/attributes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attributes.d.ts","sourceRoot":"","sources":["../../src/telemetry/attributes.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BR,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,OAAO,KAAK,CAAC,CAAC"}