@soleri/core 2.10.0 → 2.12.0

package/dist/chat/voice.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Voice — transcription and text-to-speech via pure HTTP (no SDK deps).
+ *
+ * Supports OpenAI Whisper for transcription and OpenAI TTS for speech synthesis.
+ * Graceful degradation when API keys are missing.
+ */
+export interface VoiceConfig {
+    /** OpenAI API key for Whisper transcription and TTS. */
+    openaiApiKey?: string;
+    /** TTS voice ID. Default: 'onyx'. */
+    ttsVoice?: string;
+    /** TTS model. Default: 'tts-1'. */
+    ttsModel?: string;
+    /** Whisper model. Default: 'whisper-1'. */
+    whisperModel?: string;
+}
+export interface TranscriptionResult {
+    /** Transcribed text. */
+    text: string;
+    /** Whether transcription was successful. */
+    success: boolean;
+}
+export interface SpeechResult {
+    /** Audio data as Buffer (MP3). */
+    audio: Buffer;
+    /** Whether synthesis was successful. */
+    success: boolean;
+}
+/**
+ * Transcribe audio using OpenAI Whisper API.
+ * Returns a fallback message if no API key is configured.
+ */
+export declare function transcribeAudio(audioBuffer: Buffer, config: VoiceConfig, filename?: string): Promise<TranscriptionResult>;
+/**
+ * Synthesize speech from text using OpenAI TTS API.
+ * Returns null if no API key is configured.
+ */
+export declare function synthesizeSpeech(text: string, config: VoiceConfig): Promise<SpeechResult | null>;
+//# sourceMappingURL=voice.d.ts.map

package/dist/chat/voice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice.d.ts","sourceRoot":"","sources":["../../src/chat/voice.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,WAAW;IAC1B,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAC;CAClB;AAID;;;GAGG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,EACnB,QAAQ,GAAE,MAAoB,GAC7B,OAAO,CAAC,mBAAmB,CAAC,CAoD9B;AAID;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CA0B9B"}

package/dist/chat/voice.js

@@ -0,0 +1,80 @@
+/**
+ * Voice — transcription and text-to-speech via pure HTTP (no SDK deps).
+ *
+ * Supports OpenAI Whisper for transcription and OpenAI TTS for speech synthesis.
+ * Graceful degradation when API keys are missing.
+ */
+// ─── Transcriber ──────────────────────────────────────────────────────
+/**
+ * Transcribe audio using OpenAI Whisper API.
+ * Returns a fallback message if no API key is configured.
+ */
+export async function transcribeAudio(audioBuffer, config, filename = 'audio.ogg') {
+    if (!config.openaiApiKey) {
+        return { text: '[Voice message — transcription unavailable]', success: false };
+    }
+    const model = config.whisperModel ?? 'whisper-1';
+    // Build multipart form data manually (no SDK)
+    const boundary = `----SoleriFormBoundary${Date.now()}`;
+    const parts = [];
+    // File part
+    parts.push(Buffer.from(`--${boundary}\r\nContent-Disposition: form-data; name="file"; filename="${filename}"\r\nContent-Type: audio/ogg\r\n\r\n`));
+    parts.push(audioBuffer);
+    parts.push(Buffer.from('\r\n'));
+    // Model part
+    parts.push(Buffer.from(`--${boundary}\r\nContent-Disposition: form-data; name="model"\r\n\r\n${model}\r\n`));
+    parts.push(Buffer.from(`--${boundary}--\r\n`));
+    const body = Buffer.concat(parts);
+    try {
+        const response = await fetch('https://api.openai.com/v1/audio/transcriptions', {
+            method: 'POST',
+            headers: {
+                Authorization: `Bearer ${config.openaiApiKey}`,
+                'Content-Type': `multipart/form-data; boundary=${boundary}`,
+            },
+            body,
+            signal: AbortSignal.timeout(30_000),
+        });
+        if (!response.ok) {
+            await response.text().catch(() => { });
+            return { text: `[Transcription failed: ${response.status}]`, success: false };
+        }
+        const data = (await response.json());
+        return { text: data.text ?? '', success: true };
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        return { text: `[Transcription error: ${msg}]`, success: false };
+    }
+}
+// ─── TTS ──────────────────────────────────────────────────────────────
+/**
+ * Synthesize speech from text using OpenAI TTS API.
+ * Returns null if no API key is configured.
+ */
+export async function synthesizeSpeech(text, config) {
+    if (!config.openaiApiKey)
+        return null;
+    const model = config.ttsModel ?? 'tts-1';
+    const voice = config.ttsVoice ?? 'onyx';
+    try {
+        const response = await fetch('https://api.openai.com/v1/audio/speech', {
+            method: 'POST',
+            headers: {
+                Authorization: `Bearer ${config.openaiApiKey}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({ model, voice, input: text }),
+            signal: AbortSignal.timeout(30_000),
+        });
+        if (!response.ok) {
+            return { audio: Buffer.alloc(0), success: false };
+        }
+        const audio = Buffer.from(await response.arrayBuffer());
+        return { audio, success: true };
+    }
+    catch {
+        return { audio: Buffer.alloc(0), success: false };
+    }
+}
+//# sourceMappingURL=voice.js.map

package/dist/chat/voice.js.map

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

package/dist/claudemd/compose.d.ts

@@ -0,0 +1,31 @@
+/**
+ * CLAUDE.md composition — generates LLM instructions from agent config and facades.
+ *
+ * Produces markdown with:
+ * 1. Global instructions (priority-sorted)
+ * 2. Activation / deactivation
+ * 3. Session start protocol
+ * 4. Facade reference table (auto-generated from registered facades)
+ * 5. Facade behavioral rules (from FacadeInstructions)
+ *
+ * Wrapped in versioned markers: `<!-- agent:mode v1 -->` / `<!-- /agent:mode -->`
+ */
+import type { FacadeConfig } from '../facades/types.js';
+import type { AgentMeta, FacadeInstructions } from './types.js';
+export declare const FORMAT_VERSION = 1;
+export declare const OPEN_MARKER = "<!-- agent:mode v1 -->";
+export declare const CLOSE_MARKER = "<!-- /agent:mode -->";
+export declare const USER_ZONE_OPEN = "<!-- user:custom -->";
+export declare const USER_ZONE_CLOSE = "<!-- /user:custom -->";
+export interface ComposeOptions {
+    /** Per-facade behavioral instructions */
+    facadeInstructions?: Map<string, FacadeInstructions>;
+    /** Include an empty user-safe zone */
+    includeUserZone?: boolean;
+}
+/**
+ * Compose the full CLAUDE.md agent block from metadata and facades.
+ * Returns the content wrapped in versioned markers.
+ */
+export declare function composeCLAUDEmd(agent: AgentMeta, facades: FacadeConfig[], options?: ComposeOptions): string;
+//# sourceMappingURL=compose.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../../src/claudemd/compose.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAqB,MAAM,YAAY,CAAC;AAEnF,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,eAAO,MAAM,WAAW,2BAA2C,CAAC;AACpE,eAAO,MAAM,YAAY,yBAAyB,CAAC;AACnD,eAAO,MAAM,cAAc,yBAAyB,CAAC;AACrD,eAAO,MAAM,eAAe,0BAA0B,CAAC;AAuEvD,MAAM,WAAW,cAAc;IAC7B,yCAAyC;IACzC,kBAAkB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACrD,sCAAsC;IACtC,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,YAAY,EAAE,EACvB,OAAO,CAAC,EAAE,cAAc,GACvB,MAAM,CAmCR"}

package/dist/claudemd/compose.js

@@ -0,0 +1,105 @@
+/**
+ * CLAUDE.md composition — generates LLM instructions from agent config and facades.
+ *
+ * Produces markdown with:
+ * 1. Global instructions (priority-sorted)
+ * 2. Activation / deactivation
+ * 3. Session start protocol
+ * 4. Facade reference table (auto-generated from registered facades)
+ * 5. Facade behavioral rules (from FacadeInstructions)
+ *
+ * Wrapped in versioned markers: `<!-- agent:mode v1 -->` / `<!-- /agent:mode -->`
+ */
+export const FORMAT_VERSION = 1;
+export const OPEN_MARKER = `<!-- agent:mode v${FORMAT_VERSION} -->`;
+export const CLOSE_MARKER = '<!-- /agent:mode -->';
+export const USER_ZONE_OPEN = '<!-- user:custom -->';
+export const USER_ZONE_CLOSE = '<!-- /user:custom -->';
+function sortByPriority(items) {
+    return [...items].sort((a, b) => (a.priority ?? 50) - (b.priority ?? 50));
+}
+function renderActivation(agent) {
+    return [
+        `## ${agent.name} Mode`,
+        '',
+        '### Activation',
+        '',
+        `- "${agent.activationPhrase}" → \`${agent.activateCommand}\``,
+        `- "${agent.deactivationPhrase}" → \`${agent.deactivateCommand}\``,
+        '',
+        '> Persona details are returned dynamically by the activate response.',
+    ].join('\n');
+}
+function renderSessionStart(agent) {
+    return [
+        '### Session Start Protocol',
+        '',
+        'On EVERY new session:',
+        `1. Register project: \`${agent.id}_core op:register params:{ projectPath: "." }\``,
+        '2. Check activation response for `persistence.status`, `vault.connected`',
+        `3. Check for plans in \`executing\` state — remind user to reconcile`,
+    ].join('\n');
+}
+function renderFacadeTable(facades, instructions) {
+    const lines = ['### Essential Tools', '', '| Facade | Key Ops |', '|--------|---------|'];
+    for (const facade of facades) {
+        const instr = instructions?.get(facade.name);
+        const allOps = facade.ops.map((o) => o.name);
+        const keyOps = instr?.keyOps ?? allOps.slice(0, 5);
+        const display = keyOps.map((o) => `\`${o}\``).join(', ');
+        const suffix = allOps.length > keyOps.length ? ', ...' : '';
+        lines.push(`| \`${facade.name}\` | ${display}${suffix} |`);
+    }
+    return lines.join('\n');
+}
+function renderGlobalInstruction(gi) {
+    return `## ${gi.heading}\n\n${gi.content.trim()}`;
+}
+function renderFacadeRules(name, instr) {
+    const lines = [`## ${instr.heading}`, ''];
+    if (instr.rules?.length) {
+        for (const rule of instr.rules) {
+            lines.push(`- ${rule}`);
+        }
+        lines.push('');
+    }
+    if (instr.templates) {
+        for (const [label, template] of Object.entries(instr.templates)) {
+            lines.push(`### ${label}`, '', template.trim(), '');
+        }
+    }
+    return lines.join('\n').trimEnd();
+}
+/**
+ * Compose the full CLAUDE.md agent block from metadata and facades.
+ * Returns the content wrapped in versioned markers.
+ */
+export function composeCLAUDEmd(agent, facades, options) {
+    const sections = [];
+    // 1. Global instructions (sorted by priority)
+    if (agent.globalInstructions?.length) {
+        const sorted = sortByPriority(agent.globalInstructions);
+        for (const gi of sorted) {
+            sections.push(renderGlobalInstruction(gi));
+        }
+    }
+    // 2. Activation + session start
+    sections.push(renderActivation(agent));
+    sections.push(renderSessionStart(agent));
+    // 3. Facade reference table
+    sections.push(renderFacadeTable(facades, options?.facadeInstructions));
+    // 4. Facade behavioral rules
+    if (options?.facadeInstructions) {
+        const entries = [...options.facadeInstructions.entries()].sort(([, a], [, b]) => (a.priority ?? 50) - (b.priority ?? 50));
+        for (const [name, instr] of entries) {
+            sections.push(renderFacadeRules(name, instr));
+        }
+    }
+    // 5. User-safe zone
+    if (options?.includeUserZone) {
+        sections.push(`${USER_ZONE_OPEN}\n\n${USER_ZONE_CLOSE}`);
+    }
+    const body = sections.join('\n\n');
+    return `${OPEN_MARKER}\n\n${body}\n\n${CLOSE_MARKER}`;
+}
+//# sourceMappingURL=compose.js.map

package/dist/claudemd/compose.js.map

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

package/dist/claudemd/index.d.ts

@@ -0,0 +1,5 @@
+export { composeCLAUDEmd, FORMAT_VERSION, OPEN_MARKER, CLOSE_MARKER, USER_ZONE_OPEN, USER_ZONE_CLOSE, } from './compose.js';
+export type { ComposeOptions } from './compose.js';
+export { injectCLAUDEmd, removeCLAUDEmd, hasCLAUDEmdBlock, extractUserZone } from './inject.js';
+export type { AgentMeta, GlobalInstruction, FacadeInstructions, InjectionResult, RemovalResult, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/claudemd/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,cAAc,EACd,WAAW,EACX,YAAY,EACZ,cAAc,EACd,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAChG,YAAY,EACV,SAAS,EACT,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/claudemd/index.js

@@ -0,0 +1,3 @@
+export { composeCLAUDEmd, FORMAT_VERSION, OPEN_MARKER, CLOSE_MARKER, USER_ZONE_OPEN, USER_ZONE_CLOSE, } from './compose.js';
+export { injectCLAUDEmd, removeCLAUDEmd, hasCLAUDEmdBlock, extractUserZone } from './inject.js';
+//# sourceMappingURL=index.js.map

package/dist/claudemd/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/claudemd/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,cAAc,EACd,WAAW,EACX,YAAY,EACZ,cAAc,EACd,eAAe,GAChB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/claudemd/inject.d.ts

@@ -0,0 +1,31 @@
+/**
+ * CLAUDE.md injection — marker-based write with diff detection and user-safe zones.
+ *
+ * Improvements over Salvador:
+ * - Diff-before-write: skips I/O if content unchanged
+ * - User-safe zones: `<!-- user:custom -->` blocks inside markers survive regeneration
+ * - Versioned markers: `<!-- agent:mode v1 -->` for future migration
+ */
+import type { InjectionResult, RemovalResult } from './types.js';
+/**
+ * Extract user-safe zone content from an existing agent block.
+ * Returns the content between `<!-- user:custom -->` markers, or null.
+ */
+export declare function extractUserZone(content: string): string | null;
+/**
+ * Inject an agent block into a CLAUDE.md file.
+ *
+ * - If markers exist: replace (preserving user-safe zones), skip if unchanged
+ * - If legacy markers: migrate
+ * - If no markers: append
+ */
+export declare function injectCLAUDEmd(filePath: string, block: string): InjectionResult;
+/**
+ * Remove the agent block from a CLAUDE.md file.
+ */
+export declare function removeCLAUDEmd(filePath: string): RemovalResult;
+/**
+ * Check if an agent block is present in a CLAUDE.md file.
+ */
+export declare function hasCLAUDEmdBlock(filePath: string): boolean;
+//# sourceMappingURL=inject.d.ts.map

package/dist/claudemd/inject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject.d.ts","sourceRoot":"","sources":["../../src/claudemd/inject.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAQjE;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM9D;AA2CD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,CAgD/E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAwB9D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAQ1D"}

package/dist/claudemd/inject.js

@@ -0,0 +1,157 @@
+/**
+ * CLAUDE.md injection — marker-based write with diff detection and user-safe zones.
+ *
+ * Improvements over Salvador:
+ * - Diff-before-write: skips I/O if content unchanged
+ * - User-safe zones: `<!-- user:custom -->` blocks inside markers survive regeneration
+ * - Versioned markers: `<!-- agent:mode v1 -->` for future migration
+ */
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { OPEN_MARKER, CLOSE_MARKER, USER_ZONE_OPEN, USER_ZONE_CLOSE } from './compose.js';
+/** Legacy marker patterns to detect and migrate */
+const LEGACY_MARKERS = [
+    '<!-- agent:mode -->', // v0 (no version)
+    '<!-- salvador:mode -->', // pre-Soleri
+];
+/**
+ * Extract user-safe zone content from an existing agent block.
+ * Returns the content between `<!-- user:custom -->` markers, or null.
+ */
+export function extractUserZone(content) {
+    const openIdx = content.indexOf(USER_ZONE_OPEN);
+    const closeIdx = content.indexOf(USER_ZONE_CLOSE);
+    if (openIdx === -1 || closeIdx === -1 || closeIdx <= openIdx)
+        return null;
+    const inner = content.slice(openIdx + USER_ZONE_OPEN.length, closeIdx).trim();
+    return inner || null;
+}
+/**
+ * Preserve user-safe zone content when regenerating.
+ * Replaces the empty user zone in `newBlock` with the saved content.
+ */
+function preserveUserZone(newBlock, savedZone) {
+    if (!savedZone)
+        return newBlock;
+    const emptyZone = `${USER_ZONE_OPEN}\n\n${USER_ZONE_CLOSE}`;
+    const filledZone = `${USER_ZONE_OPEN}\n${savedZone}\n${USER_ZONE_CLOSE}`;
+    return newBlock.replace(emptyZone, filledZone);
+}
+/**
+ * Find the agent block boundaries in content.
+ * Handles current and legacy markers.
+ */
+function findBlock(content) {
+    // Current markers
+    const openIdx = content.indexOf(OPEN_MARKER);
+    if (openIdx !== -1) {
+        const closeIdx = content.indexOf(CLOSE_MARKER, openIdx);
+        if (closeIdx > openIdx) {
+            return { openIdx, closeIdx, closeLen: CLOSE_MARKER.length };
+        }
+    }
+    // Legacy markers
+    for (const legacy of LEGACY_MARKERS) {
+        const legacyOpen = content.indexOf(legacy);
+        if (legacyOpen === -1)
+            continue;
+        const legacyCloseTag = legacy.replace('<!-- ', '<!-- /');
+        const legacyClose = content.indexOf(legacyCloseTag, legacyOpen);
+        if (legacyClose > legacyOpen) {
+            return { openIdx: legacyOpen, closeIdx: legacyClose, closeLen: legacyCloseTag.length };
+        }
+    }
+    return null;
+}
+/**
+ * Inject an agent block into a CLAUDE.md file.
+ *
+ * - If markers exist: replace (preserving user-safe zones), skip if unchanged
+ * - If legacy markers: migrate
+ * - If no markers: append
+ */
+export function injectCLAUDEmd(filePath, block) {
+    try {
+        // New file
+        if (!existsSync(filePath)) {
+            writeFileSync(filePath, block + '\n', 'utf-8');
+            return { success: true, action: 'injected', message: 'Created file with agent block' };
+        }
+        const content = readFileSync(filePath, 'utf-8');
+        const bounds = findBlock(content);
+        if (bounds) {
+            // Extract user zone from existing block before replacing
+            const existingBlock = content.slice(bounds.openIdx, bounds.closeIdx + bounds.closeLen);
+            const userZone = extractUserZone(existingBlock);
+            const finalBlock = preserveUserZone(block, userZone);
+            // Diff check — skip write if identical
+            if (existingBlock === finalBlock) {
+                return {
+                    success: true,
+                    action: 'skipped',
+                    message: 'Content unchanged — no write needed',
+                    diffDetected: false,
+                };
+            }
+            const before = content.slice(0, bounds.openIdx);
+            const after = content.slice(bounds.closeIdx + bounds.closeLen);
+            writeFileSync(filePath, before + finalBlock + after, 'utf-8');
+            return {
+                success: true,
+                action: 'replaced',
+                message: 'Replaced agent block (diff detected)',
+                diffDetected: true,
+            };
+        }
+        // No markers — append
+        writeFileSync(filePath, content.trimEnd() + '\n\n' + block + '\n', 'utf-8');
+        return { success: true, action: 'injected', message: 'Appended agent block' };
+    }
+    catch (err) {
+        return {
+            success: false,
+            action: 'error',
+            message: `Injection failed: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+}
+/**
+ * Remove the agent block from a CLAUDE.md file.
+ */
+export function removeCLAUDEmd(filePath) {
+    try {
+        if (!existsSync(filePath)) {
+            return { success: true, action: 'not_present', message: 'File does not exist' };
+        }
+        const content = readFileSync(filePath, 'utf-8');
+        const bounds = findBlock(content);
+        if (!bounds) {
+            return { success: true, action: 'not_present', message: 'No agent block found' };
+        }
+        const before = content.slice(0, bounds.openIdx).trimEnd();
+        const after = content.slice(bounds.closeIdx + bounds.closeLen).trimStart();
+        writeFileSync(filePath, after ? before + '\n\n' + after : before + '\n', 'utf-8');
+        return { success: true, action: 'removed', message: 'Removed agent block' };
+    }
+    catch (err) {
+        return {
+            success: false,
+            action: 'error',
+            message: `Removal failed: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+}
+/**
+ * Check if an agent block is present in a CLAUDE.md file.
+ */
+export function hasCLAUDEmdBlock(filePath) {
+    if (!existsSync(filePath))
+        return false;
+    try {
+        const content = readFileSync(filePath, 'utf-8');
+        return findBlock(content) !== null;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=inject.js.map

package/dist/claudemd/inject.js.map

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

package/dist/claudemd/types.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Types for CLAUDE.md auto-composition and injection.
+ */
+/** Agent metadata for CLAUDE.md generation */
+export interface AgentMeta {
+    id: string;
+    name: string;
+    activationPhrase: string;
+    deactivationPhrase: string;
+    activateCommand: string;
+    deactivateCommand: string;
+    /** Global instruction sections (priority-sorted, lower = higher) */
+    globalInstructions?: GlobalInstruction[];
+}
+/** A standalone section in CLAUDE.md not tied to a facade */
+export interface GlobalInstruction {
+    heading: string;
+    content: string;
+    priority?: number;
+}
+/** Facade instructions for CLAUDE.md behavioral rules */
+export interface FacadeInstructions {
+    heading: string;
+    rules?: string[];
+    templates?: Record<string, string>;
+    priority?: number;
+    keyOps?: string[];
+}
+/** Result of an injection or removal operation */
+export interface InjectionResult {
+    success: boolean;
+    action: 'injected' | 'replaced' | 'skipped' | 'error';
+    message: string;
+    diffDetected?: boolean;
+}
+export interface RemovalResult {
+    success: boolean;
+    action: 'removed' | 'not_present' | 'error';
+    message: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/claudemd/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,8CAA8C;AAC9C,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oEAAoE;IACpE,kBAAkB,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAC1C;AAED,6DAA6D;AAC7D,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,yDAAyD;AACzD,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,kDAAkD;AAClD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,OAAO,CAAC;IAC5C,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/claudemd/types.js

@@ -0,0 +1,5 @@
+/**
+ * Types for CLAUDE.md auto-composition and injection.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/claudemd/types.js.map

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

package/dist/context/context-engine.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Context Engine — entity extraction, knowledge retrieval, and confidence scoring.
+ *
+ * Orchestrates three signals to enrich intent classification:
+ * 1. Entity extraction (regex-based, domain-agnostic)
+ * 2. Knowledge retrieval (vault FTS + Cognee vector + brain recommendations)
+ * 3. Confidence scoring (combines entity + knowledge signals)
+ *
+ * Graceful degradation: if Cognee is unavailable, vault-only.
+ * If vault is empty, keyword confidence from IntentRouter is unchanged.
+ */
+import type { Vault } from '../vault/vault.js';
+import type { Brain } from '../brain/brain.js';
+import type { BrainIntelligence } from '../brain/intelligence.js';
+import type { CogneeClient } from '../cognee/client.js';
+import type { EntityExtractionResult, KnowledgeRetrievalResult, ContextAnalysis, ContextEngineConfig } from './types.js';
+export declare class ContextEngine {
+    private vault;
+    private brain;
+    private brainIntelligence;
+    private cognee;
+    private config;
+    constructor(vault: Vault, brain: Brain, brainIntelligence: BrainIntelligence, cognee: CogneeClient | null, config?: ContextEngineConfig);
+    extractEntities(prompt: string): EntityExtractionResult;
+    retrieveKnowledge(prompt: string, domain?: string): Promise<KnowledgeRetrievalResult>;
+    analyze(prompt: string, domain?: string): Promise<ContextAnalysis>;
+    private computeConfidence;
+    private toConfidenceLevel;
+    private detectDomains;
+}
+//# sourceMappingURL=context-engine.d.ts.map

package/dist/context/context-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-engine.d.ts","sourceRoot":"","sources":["../../src/context/context-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAGV,sBAAsB,EAEtB,wBAAwB,EACxB,eAAe,EAEf,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAuDpB,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,MAAM,CAAgC;gBAG5C,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,KAAK,EACZ,iBAAiB,EAAE,iBAAiB,EACpC,MAAM,EAAE,YAAY,GAAG,IAAI,EAC3B,MAAM,CAAC,EAAE,mBAAmB;IAgB9B,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,sBAAsB;IA6BjD,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAgFrF,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IA+BxE,OAAO,CAAC,iBAAiB;IA6BzB,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,aAAa;CAkBtB"}