@esankhan3/anvil-agent-core 0.1.0

package/dist/single-shot.js

@@ -0,0 +1,385 @@
+/**
+ * Single-shot LLM runner — agent-core's analytical-shape entry point.
+ *
+ * Used by knowledge-core consumers (repo-profiler, service-mesh-inferrer,
+ * rag-evaluator) that want a `prompt + system → text + cost` round trip
+ * without managing the streaming surface themselves.
+ *
+ * Two transports:
+ *   - 'cli' (default) — spawns claude / gemini binary
+ *   - 'api'           — direct HTTP calls to Anthropic or OpenAI-compat endpoint
+ *   - 'none'          — disabled; throws on every call
+ *
+ * Mode resolution (ANVIL_LLM_MODE → CODE_SEARCH_LLM_MODE → auto-detect):
+ *   1. explicit 'cli'/'api'/'none' wins
+ *   2. else if API key present → 'api'
+ *   3. else if claude binary on PATH → 'cli'
+ *   4. else 'none'
+ *
+ * Env-var aliasing (Phase 5): ANVIL_* is canonical; CODE_SEARCH_LLM_* + a few
+ * unscoped legacy names (CLAUDE_BIN, GEMINI_BIN, ANVIL_AGENT_CMD, FF_AGENT_CMD,
+ * ANTHROPIC_API_KEY, GEMINI_API_KEY, GOOGLE_API_KEY) are kept as aliases. A
+ * deprecation warning is emitted to stderr if a legacy var is set without its
+ * canonical counterpart.
+ *
+ * Note on the unification path: this runner currently spawns subprocesses + makes
+ * HTTP calls directly (lift-and-shift from the original
+ * knowledge-core/claude-runner.ts). It does NOT yet route through
+ * `ProviderRegistry` + `LanguageModel.invoke()` — that requires every adapter
+ * to grow an `invoke()` impl, which is a follow-up phase. Both paths produce
+ * the same `ClaudeResult` shape, so callers don't see the difference.
+ */
+import { spawn, execSync } from 'node:child_process';
+import { withInvokeSpan } from './telemetry/instrument.js';
+import { GenAi } from './telemetry/attributes.js';
+import { calculateCostBreakdown } from './cost.js';
+// ── Env-var aliasing ───────────────────────────────────────────────────────
+const ALIASED_VARS_LOGGED = new Set();
+/**
+ * Read an env var, preferring the canonical `ANVIL_*` name, falling back to
+ * one or more legacy names. Emits a one-time deprecation warning to stderr if
+ * a legacy var is set without its canonical counterpart.
+ */
+function readAliased(canonical, ...legacy) {
+    const canonicalValue = process.env[canonical];
+    if (canonicalValue !== undefined)
+        return canonicalValue;
+    for (const name of legacy) {
+        const value = process.env[name];
+        if (value !== undefined) {
+            const key = `${name}->${canonical}`;
+            if (!ALIASED_VARS_LOGGED.has(key)) {
+                ALIASED_VARS_LOGGED.add(key);
+                process.stderr.write(`[anvil-llm] DEPRECATED: ${name} is set without ${canonical}. ` +
+                    `Migrate to ${canonical} (legacy alias removed in 1.0).\n`);
+            }
+            return value;
+        }
+    }
+    return undefined;
+}
+let _cachedConfig = null;
+function resolveLlmMode(explicit, apiKey, claudeBin) {
+    if (explicit === 'cli' || explicit === 'api' || explicit === 'none') {
+        if (explicit === 'api' && !apiKey) {
+            process.stderr.write('[anvil-llm] WARNING: ANVIL_LLM_MODE=api but no API key found. ' +
+                'Set ANVIL_LLM_API_KEY or ANVIL_ANTHROPIC_API_KEY (or ANTHROPIC_API_KEY). ' +
+                'Falling back to ANVIL_LLM_MODE=none.\n');
+            return 'none';
+        }
+        return explicit;
+    }
+    if (apiKey)
+        return 'api';
+    try {
+        execSync(`which ${claudeBin}`, { stdio: 'pipe', timeout: 3000 });
+        return 'cli';
+    }
+    catch {
+        return 'none';
+    }
+}
+function loadLlmConfig() {
+    if (_cachedConfig)
+        return _cachedConfig;
+    const apiKey = readAliased('ANVIL_LLM_API_KEY', 'CODE_SEARCH_LLM_API_KEY') ??
+        readAliased('ANVIL_ANTHROPIC_API_KEY', 'ANTHROPIC_API_KEY');
+    const claudeBin = readAliased('ANVIL_CLAUDE_BIN', 'ANVIL_AGENT_CMD', 'FF_AGENT_CMD', 'CODE_SEARCH_CLAUDE_BIN', 'CLAUDE_BIN') ??
+        'claude';
+    const geminiBin = readAliased('ANVIL_GEMINI_BIN', 'GEMINI_BIN', 'GEMINI_CLI_BIN') ??
+        'gemini';
+    _cachedConfig = {
+        llmMode: resolveLlmMode(readAliased('ANVIL_LLM_MODE', 'CODE_SEARCH_LLM_MODE'), apiKey, claudeBin),
+        llmProvider: readAliased('ANVIL_LLM_PROVIDER', 'CODE_SEARCH_LLM_PROVIDER') ?? 'anthropic',
+        llmModel: readAliased('ANVIL_LLM_MODEL', 'CODE_SEARCH_LLM_MODEL') ?? 'sonnet',
+        llmApiKey: apiKey,
+        llmBaseUrl: readAliased('ANVIL_LLM_BASE_URL', 'CODE_SEARCH_LLM_BASE_URL'),
+        claudeBin,
+        geminiBin,
+    };
+    return _cachedConfig;
+}
+/** Test seam — reset cached config (call between tests that override env). */
+export function resetLlmConfig() {
+    _cachedConfig = null;
+    ALIASED_VARS_LOGGED.clear();
+}
+/** Report whether any LLM transport is currently usable. */
+export function isLlmAvailable() {
+    return loadLlmConfig().llmMode !== 'none';
+}
+// ── Process tracking — robust SIGINT/SIGTERM cleanup ───────────────────────
+const activeProcesses = new Set();
+function trackProcess(proc) {
+    activeProcesses.add(proc);
+    proc.on('exit', () => activeProcesses.delete(proc));
+}
+function killAllTracked() {
+    for (const proc of activeProcesses) {
+        try {
+            proc.kill('SIGTERM');
+        }
+        catch { /* already dead */ }
+    }
+    activeProcesses.clear();
+}
+process.on('SIGINT', killAllTracked);
+process.on('SIGTERM', killAllTracked);
+/** Run Claude — dispatches to CLI or API based on resolved LLM mode. */
+export async function runClaude(prompt, systemPrompt, opts) {
+    const config = loadLlmConfig();
+    if (config.llmMode === 'none') {
+        throw new Error('LLM inference disabled (ANVIL_LLM_MODE=none)');
+    }
+    const model = opts?.model ?? config.llmModel;
+    const timeoutMs = opts?.timeoutMs ?? 600_000;
+    return withInvokeSpan({ provider: 'claude', model, prompt, systemPrompt }, () => config.llmMode === 'api'
+        ? runViaApi(prompt, systemPrompt, model, timeoutMs, config)
+        : runViaCli(prompt, systemPrompt, model, timeoutMs, config.claudeBin), (r) => {
+        const bd = calculateCostBreakdown(model, {
+            inputTokens: r.inputTokens,
+            outputTokens: r.outputTokens,
+        });
+        return {
+            [GenAi.USAGE_INPUT_TOKENS]: r.inputTokens,
+            [GenAi.USAGE_OUTPUT_TOKENS]: r.outputTokens,
+            [GenAi.USAGE_COST_USD]: bd.totalUsd > 0 ? bd.totalUsd : r.costUsd,
+            [GenAi.USAGE_COST_INPUT_USD]: bd.inputUsd,
+            [GenAi.USAGE_COST_OUTPUT_USD]: bd.outputUsd,
+            'anvil.duration_ms': r.durationMs,
+            'anvil.transport': config.llmMode,
+        };
+    });
+}
+/** Run Gemini CLI — CLI mode only (no Gemini API integration today). */
+export async function runGemini(prompt, systemPrompt, opts) {
+    const config = loadLlmConfig();
+    if (config.llmMode === 'none') {
+        throw new Error('LLM inference disabled (ANVIL_LLM_MODE=none)');
+    }
+    const model = opts?.model ?? 'gemini-2.5-pro';
+    const timeoutMs = opts?.timeoutMs ?? 600_000;
+    // Combine — Gemini CLI has no separate --system-prompt flag.
+    const combinedPrompt = systemPrompt
+        ? `${systemPrompt}\n\n---\n\n${prompt}`
+        : prompt;
+    return withInvokeSpan({ provider: 'gemini-cli', model, prompt, systemPrompt }, () => runGeminiInner(config, model, combinedPrompt, timeoutMs), (r) => {
+        const bd = calculateCostBreakdown(model, {
+            inputTokens: r.inputTokens,
+            outputTokens: r.outputTokens,
+        });
+        return {
+            [GenAi.USAGE_INPUT_TOKENS]: r.inputTokens,
+            [GenAi.USAGE_OUTPUT_TOKENS]: r.outputTokens,
+            [GenAi.USAGE_COST_USD]: bd.totalUsd > 0 ? bd.totalUsd : r.costUsd,
+            [GenAi.USAGE_COST_INPUT_USD]: bd.inputUsd,
+            [GenAi.USAGE_COST_OUTPUT_USD]: bd.outputUsd,
+            'anvil.duration_ms': r.durationMs,
+            'anvil.transport': 'cli',
+        };
+    });
+}
+function runGeminiInner(config, model, combinedPrompt, timeoutMs) {
+    return new Promise((resolve, reject) => {
+        const args = ['-p', combinedPrompt, '--model', model];
+        const start = Date.now();
+        const proc = spawn(config.geminiBin, args, {
+            stdio: ['pipe', 'pipe', 'pipe'],
+            env: { ...process.env },
+        });
+        trackProcess(proc);
+        proc.stdin?.end();
+        let stdout = '';
+        let stderr = '';
+        const timer = setTimeout(() => {
+            proc.kill('SIGTERM');
+            reject(new Error(`Gemini CLI timed out after ${Math.round(timeoutMs / 1000)}s`));
+        }, timeoutMs);
+        proc.stdout?.on('data', (data) => { stdout += data.toString(); });
+        proc.stderr?.on('data', (data) => { stderr += data.toString(); });
+        proc.on('error', (err) => { clearTimeout(timer); reject(err); });
+        proc.on('close', (code) => {
+            clearTimeout(timer);
+            const durationMs = Date.now() - start;
+            if (code !== 0 && !stdout.trim()) {
+                reject(new Error(`gemini exited with code ${code}: ${stderr.slice(0, 500)}`));
+                return;
+            }
+            let result = stdout.trim();
+            let costUsd = 0;
+            let inputTokens = 0;
+            let outputTokens = 0;
+            try {
+                const parsed = JSON.parse(result);
+                if (parsed.result)
+                    result = parsed.result;
+                if (parsed.total_cost_usd)
+                    costUsd = parsed.total_cost_usd;
+                if (parsed.usage?.input_tokens)
+                    inputTokens = parsed.usage.input_tokens;
+                if (parsed.usage?.output_tokens)
+                    outputTokens = parsed.usage.output_tokens;
+            }
+            catch { /* plain text */ }
+            resolve({ result, costUsd, inputTokens, outputTokens, durationMs });
+        });
+    });
+}
+/** Provider-aware facade — defaults to Claude. */
+export async function runLLM(prompt, systemPrompt, opts) {
+    const provider = opts?.provider ?? 'claude';
+    if (provider === 'gemini')
+        return runGemini(prompt, systemPrompt, opts);
+    return runClaude(prompt, systemPrompt, opts);
+}
+// ── CLI transport ─────────────────────────────────────────────────────────
+function runViaCli(prompt, systemPrompt, model, timeoutMs, claudeBin) {
+    return new Promise((resolve, reject) => {
+        const args = [
+            '-p', prompt,
+            '--system-prompt', systemPrompt,
+            '--output-format', 'stream-json',
+            '--verbose',
+            '--model', model,
+            '--permission-mode', 'bypassPermissions',
+        ];
+        const proc = spawn(claudeBin, args, {
+            stdio: ['pipe', 'pipe', 'pipe'],
+            env: { ...process.env },
+        });
+        trackProcess(proc);
+        proc.stdin?.end();
+        let buffer = '';
+        let fullText = '';
+        let resultData = null;
+        const timer = setTimeout(() => {
+            proc.kill('SIGTERM');
+            reject(new Error(`Claude CLI timed out after ${Math.round(timeoutMs / 1000)}s`));
+        }, timeoutMs);
+        proc.stdout?.on('data', (data) => {
+            buffer += data.toString();
+            const lines = buffer.split('\n');
+            buffer = lines.pop() || '';
+            for (const line of lines) {
+                const trimmed = line.trim();
+                if (!trimmed)
+                    continue;
+                try {
+                    const msg = JSON.parse(trimmed);
+                    if (msg.type === 'assistant' && msg.message?.content) {
+                        for (const block of msg.message.content) {
+                            if (block.type === 'text' && block.text)
+                                fullText += block.text;
+                        }
+                    }
+                    if (msg.type === 'result') {
+                        resultData = {
+                            result: msg.result ?? fullText,
+                            costUsd: msg.total_cost_usd ?? 0,
+                            inputTokens: msg.usage?.input_tokens ?? 0,
+                            outputTokens: msg.usage?.output_tokens ?? 0,
+                            durationMs: msg.duration_ms ?? 0,
+                        };
+                    }
+                }
+                catch { /* skip unparseable */ }
+            }
+        });
+        let stderr = '';
+        proc.stderr?.on('data', (data) => { stderr += data.toString(); });
+        proc.on('error', (err) => { clearTimeout(timer); reject(err); });
+        proc.on('close', (code) => {
+            clearTimeout(timer);
+            if (resultData) {
+                resolve(resultData);
+            }
+            else if (code === 0 && fullText) {
+                resolve({ result: fullText, costUsd: 0, inputTokens: 0, outputTokens: 0, durationMs: 0 });
+            }
+            else {
+                reject(new Error(`claude exited with code ${code}: ${stderr.slice(0, 500)}`));
+            }
+        });
+    });
+}
+// ── API transport ─────────────────────────────────────────────────────────
+async function runViaApi(prompt, systemPrompt, model, timeoutMs, config) {
+    if (!config.llmApiKey) {
+        throw new Error('ANVIL_LLM_API_KEY not set. Required for ANVIL_LLM_MODE=api. ' +
+            `Set it to your ${config.llmProvider} API key, or use ANVIL_LLM_MODE=cli, or ANVIL_LLM_MODE=none.`);
+    }
+    const startTime = Date.now();
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const isAnthropic = config.llmProvider === 'anthropic';
+        const url = isAnthropic
+            ? 'https://api.anthropic.com/v1/messages'
+            : `${config.llmBaseUrl ?? 'https://api.openai.com'}/v1/chat/completions`;
+        let body;
+        let headers;
+        if (isAnthropic) {
+            headers = {
+                'Content-Type': 'application/json',
+                'x-api-key': config.llmApiKey,
+                'anthropic-version': '2023-06-01',
+            };
+            body = JSON.stringify({
+                model,
+                max_tokens: 8192,
+                system: [{ type: 'text', text: systemPrompt }],
+                messages: [{ role: 'user', content: prompt }],
+            });
+        }
+        else {
+            headers = {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${config.llmApiKey}`,
+            };
+            body = JSON.stringify({
+                model,
+                max_tokens: 8192,
+                messages: [
+                    { role: 'system', content: systemPrompt },
+                    { role: 'user', content: prompt },
+                ],
+            });
+        }
+        const response = await fetch(url, { method: 'POST', headers, body, signal: controller.signal });
+        if (!response.ok) {
+            const errBody = await response.text().catch(() => '');
+            throw new Error(`LLM API error ${response.status}: ${errBody.slice(0, 500)}`);
+        }
+        const json = await response.json();
+        const durationMs = Date.now() - startTime;
+        if (isAnthropic) {
+            const content = json.content ?? [];
+            const text = content
+                .filter((b) => b.type === 'text' && b.text)
+                .map((b) => b.text)
+                .join('');
+            const usage = json.usage ?? {};
+            return {
+                result: text,
+                costUsd: 0,
+                inputTokens: usage.input_tokens ?? 0,
+                outputTokens: usage.output_tokens ?? 0,
+                durationMs,
+            };
+        }
+        const choices = json.choices;
+        const text = choices?.[0]?.message?.content ?? '';
+        const usage = json.usage ?? {};
+        return {
+            result: text,
+            costUsd: 0,
+            inputTokens: usage.prompt_tokens ?? 0,
+            outputTokens: usage.completion_tokens ?? 0,
+            durationMs,
+        };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=single-shot.js.map

package/dist/single-shot.js.map

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

package/dist/skills/activator.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Skill activator — selects which skills go into the prompt under a byte budget.
+ *
+ * v1 logic per ADR §H4: alphabetical order; include all skills whose body fits
+ * the cumulative byte budget; skip the rest and report `truncated` count.
+ */
+import type { Skill } from './types.js';
+export interface ActivatedSkills {
+    /** Skills selected for inclusion in the rendered prompt. */
+    skills: Skill[];
+    /** Cumulative body bytes (UTF-8) of `skills`. */
+    totalBytes: number;
+    /** Number of skills dropped because they wouldn't fit the budget. */
+    truncated: number;
+}
+export declare function activateSkills(skills: Skill[], maxBytes?: number): ActivatedSkills;
+//# sourceMappingURL=activator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"activator.d.ts","sourceRoot":"","sources":["../../src/skills/activator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,WAAW,eAAe;IAC9B,4DAA4D;IAC5D,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,wBAAgB,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,QAAQ,SAAoB,GAAG,eAAe,CAiB7F"}

package/dist/skills/activator.js

@@ -0,0 +1,24 @@
+/**
+ * Skill activator — selects which skills go into the prompt under a byte budget.
+ *
+ * v1 logic per ADR §H4: alphabetical order; include all skills whose body fits
+ * the cumulative byte budget; skip the rest and report `truncated` count.
+ */
+const DEFAULT_MAX_BYTES = 32 * 1024;
+export function activateSkills(skills, maxBytes = DEFAULT_MAX_BYTES) {
+    const sorted = [...skills].sort((a, b) => a.frontmatter.name.localeCompare(b.frontmatter.name));
+    const out = [];
+    let total = 0;
+    let truncated = 0;
+    for (const s of sorted) {
+        const bytes = Buffer.byteLength(s.body, 'utf-8');
+        if (total + bytes > maxBytes) {
+            truncated++;
+            continue;
+        }
+        out.push(s);
+        total += bytes;
+    }
+    return { skills: out, totalBytes: total, truncated };
+}
+//# sourceMappingURL=activator.js.map

package/dist/skills/activator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activator.js","sourceRoot":"","sources":["../../src/skills/activator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAaH,MAAM,iBAAiB,GAAG,EAAE,GAAG,IAAI,CAAC;AAEpC,MAAM,UAAU,cAAc,CAAC,MAAe,EAAE,QAAQ,GAAG,iBAAiB;IAC1E,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACvC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CACrD,CAAC;IACF,MAAM,GAAG,GAAY,EAAE,CAAC;IACxB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACjD,IAAI,KAAK,GAAG,KAAK,GAAG,QAAQ,EAAE,CAAC;YAC7B,SAAS,EAAE,CAAC;YACZ,SAAS;QACX,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACZ,KAAK,IAAI,KAAK,CAAC;IACjB,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AACvD,CAAC"}

package/dist/skills/compose.d.ts

@@ -0,0 +1,43 @@
+/**
+ * `composeSkillContext` — high-level entry point used by
+ * `defaultAdapterFactory` (and future single-shot wrappers) to thread
+ * skills into the system prompt + tool policy in one call.
+ *
+ * Steps:
+ *   1. Resolve skills directory per ADR §8 search order.
+ *   2. Load + activate skills under the byte budget.
+ *   3. Render activated skills as an "## Available Skills" block.
+ *   4. Compose final system prompt by appending the block.
+ *   5. Reconcile tool policy with skill `allowed-tools` constraints.
+ *
+ * If no skills are found, the returned prompt equals the input verbatim and
+ * the tool policy is unchanged.
+ */
+import { type ActivatedSkills } from './activator.js';
+export interface ComposeSkillContextOptions {
+    /** Absolute workspace root — used to find `<root>/.claude/skills/`. */
+    workspaceRoot?: string;
+    /** Override skills dir (full path); takes precedence over env + workspace. */
+    skillsDir?: string;
+    /** Caller-allowed tools; reconciled with skill `allowed-tools`. */
+    allowedTools?: string[];
+    /** Byte budget for activated skills; defaults to 32 KB. */
+    maxBytes?: number;
+    /** Test seams. */
+    env?: NodeJS.ProcessEnv;
+    homeDir?: string;
+}
+export interface SkillContext {
+    /** Final system prompt (input + appended skills block). */
+    systemPrompt: string;
+    /** Reconciled allowed-tools list, or undefined for "no constraint". */
+    allowedTools: string[] | undefined;
+    /** Whether skill `allowed-tools` actually narrowed caller's policy. */
+    toolsConstrained: boolean;
+    /** The activator output (for telemetry / debugging). */
+    activated: ActivatedSkills;
+    /** Resolved skills directory (undefined when no dir was found). */
+    resolvedDir: string | undefined;
+}
+export declare function composeSkillContext(baseSystemPrompt: string, opts?: ComposeSkillContextOptions): SkillContext;
+//# sourceMappingURL=compose.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../../src/skills/compose.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAKtE,MAAM,WAAW,0BAA0B;IACzC,uEAAuE;IACvE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mEAAmE;IACnE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,2DAA2D;IAC3D,YAAY,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,YAAY,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACnC,uEAAuE;IACvE,gBAAgB,EAAE,OAAO,CAAC;IAC1B,wDAAwD;IACxD,SAAS,EAAE,eAAe,CAAC;IAC3B,mEAAmE;IACnE,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAED,wBAAgB,mBAAmB,CACjC,gBAAgB,EAAE,MAAM,EACxB,IAAI,GAAE,0BAA+B,GACpC,YAAY,CAoCd"}

package/dist/skills/compose.js

@@ -0,0 +1,53 @@
+/**
+ * `composeSkillContext` — high-level entry point used by
+ * `defaultAdapterFactory` (and future single-shot wrappers) to thread
+ * skills into the system prompt + tool policy in one call.
+ *
+ * Steps:
+ *   1. Resolve skills directory per ADR §8 search order.
+ *   2. Load + activate skills under the byte budget.
+ *   3. Render activated skills as an "## Available Skills" block.
+ *   4. Compose final system prompt by appending the block.
+ *   5. Reconcile tool policy with skill `allowed-tools` constraints.
+ *
+ * If no skills are found, the returned prompt equals the input verbatim and
+ * the tool policy is unchanged.
+ */
+import { loadSkills } from './loader.js';
+import { activateSkills } from './activator.js';
+import { renderSkillsForPrompt } from './render.js';
+import { resolveSkillsDir } from './resolve-dir.js';
+import { applyToolPolicy } from './tool-policy.js';
+export function composeSkillContext(baseSystemPrompt, opts = {}) {
+    const dir = opts.skillsDir ??
+        resolveSkillsDir({
+            workspaceRoot: opts.workspaceRoot,
+            env: opts.env,
+            homeDir: opts.homeDir,
+        });
+    const empty = { skills: [], totalBytes: 0, truncated: 0 };
+    if (!dir) {
+        return {
+            systemPrompt: baseSystemPrompt,
+            allowedTools: opts.allowedTools,
+            toolsConstrained: false,
+            activated: empty,
+            resolvedDir: undefined,
+        };
+    }
+    const skills = loadSkills({ dir });
+    const activated = activateSkills(skills, opts.maxBytes);
+    const block = renderSkillsForPrompt(activated);
+    const policy = applyToolPolicy(opts.allowedTools, activated.skills);
+    const systemPrompt = block
+        ? [baseSystemPrompt, block].filter(Boolean).join('\n\n')
+        : baseSystemPrompt;
+    return {
+        systemPrompt,
+        allowedTools: policy.allowedTools,
+        toolsConstrained: policy.constrained,
+        activated,
+        resolvedDir: dir,
+    };
+}
+//# sourceMappingURL=compose.js.map

package/dist/skills/compose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose.js","sourceRoot":"","sources":["../../src/skills/compose.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,cAAc,EAAwB,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AA6BnD,MAAM,UAAU,mBAAmB,CACjC,gBAAwB,EACxB,OAAmC,EAAE;IAErC,MAAM,GAAG,GACP,IAAI,CAAC,SAAS;QACd,gBAAgB,CAAC;YACf,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC,CAAC;IAEL,MAAM,KAAK,GAAoB,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IAC3E,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO;YACL,YAAY,EAAE,gBAAgB;YAC9B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,gBAAgB,EAAE,KAAK;YACvB,SAAS,EAAE,KAAK;YAChB,WAAW,EAAE,SAAS;SACvB,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,UAAU,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;IACnC,MAAM,SAAS,GAAG,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxD,MAAM,KAAK,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAEpE,MAAM,YAAY,GAAG,KAAK;QACxB,CAAC,CAAC,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;QACxD,CAAC,CAAC,gBAAgB,CAAC;IAErB,OAAO;QACL,YAAY;QACZ,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,gBAAgB,EAAE,MAAM,CAAC,WAAW;QACpC,SAAS;QACT,WAAW,EAAE,GAAG;KACjB,CAAC;AACJ,CAAC"}

package/dist/skills/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @esankhan3/anvil-agent-core/skills — public skills barrel.
+ *
+ * Phase 1: parser + loader + activator.
+ * Phase 2: render + resolve-dir + tool-policy + composeSkillContext.
+ * Consumed by `defaultAdapterFactory` per AGENT-PROCESS-CONSOLIDATION-ADR §C3,
+ * which wires skills into every `AgentProcess` spawn for non-Claude paths.
+ */
+export type { Skill, SkillFrontmatter, SkillLoadOptions } from './types.js';
+export { parseSkillMarkdown, type ParsedSkill } from './parser.js';
+export { loadSkills } from './loader.js';
+export { activateSkills, type ActivatedSkills } from './activator.js';
+export { renderSkillsForPrompt, SKILLS_PROMPT_HEADER } from './render.js';
+export { resolveSkillsDir, type ResolveSkillsDirOptions, } from './resolve-dir.js';
+export { applyToolPolicy, type ToolPolicyResult } from './tool-policy.js';
+export { composeSkillContext, type ComposeSkillContextOptions, type SkillContext, } from './compose.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,YAAY,EAAE,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,GAC7B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EACL,mBAAmB,EACnB,KAAK,0BAA0B,EAC/B,KAAK,YAAY,GAClB,MAAM,cAAc,CAAC"}

package/dist/skills/index.js

@@ -0,0 +1,16 @@
+/**
+ * @esankhan3/anvil-agent-core/skills — public skills barrel.
+ *
+ * Phase 1: parser + loader + activator.
+ * Phase 2: render + resolve-dir + tool-policy + composeSkillContext.
+ * Consumed by `defaultAdapterFactory` per AGENT-PROCESS-CONSOLIDATION-ADR §C3,
+ * which wires skills into every `AgentProcess` spawn for non-Claude paths.
+ */
+export { parseSkillMarkdown } from './parser.js';
+export { loadSkills } from './loader.js';
+export { activateSkills } from './activator.js';
+export { renderSkillsForPrompt, SKILLS_PROMPT_HEADER } from './render.js';
+export { resolveSkillsDir, } from './resolve-dir.js';
+export { applyToolPolicy } from './tool-policy.js';
+export { composeSkillContext, } from './compose.js';
+//# sourceMappingURL=index.js.map

package/dist/skills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,kBAAkB,EAAoB,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,cAAc,EAAwB,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EACL,gBAAgB,GAEjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAyB,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EACL,mBAAmB,GAGpB,MAAM,cAAc,CAAC"}

package/dist/skills/loader.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 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 type { Skill, SkillLoadOptions } from './types.js';
+export declare function loadSkills(opts: SkillLoadOptions): Skill[];
+//# sourceMappingURL=loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/skills/loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE1D,wBAAgB,UAAU,CAAC,IAAI,EAAE,gBAAgB,GAAG,KAAK,EAAE,CAqC1D"}