@soleri/core 2.9.0 → 2.11.0

package/dist/chat/self-update.js

@@ -0,0 +1,90 @@
+/**
+ * Self-Update Manager — restart context persistence for chat-driven updates.
+ *
+ * Manages the restart lifecycle: save context before exit, load on startup,
+ * confirm success or trigger rollback. The actual process exit and rebuild
+ * are handled by the supervisor — this module only manages the context.
+ *
+ * Exit code 75 signals the supervisor to rebuild before restarting.
+ */
+import { readFileSync, writeFileSync, unlinkSync, mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+/** Exit code that tells the supervisor to rebuild before restart. */
+export const RESTART_EXIT_CODE = 75;
+export class SelfUpdateManager {
+    contextPath;
+    constructor(contextPath) {
+        this.contextPath = contextPath;
+    }
+    /**
+     * Save restart context and exit with code 75.
+     * The supervisor handles rebuild + restart.
+     * Returns the context (useful for testing — in production, process.exit fires).
+     */
+    requestRestart(chatId, reason = 'manual', commitSha) {
+        const context = {
+            reason,
+            chatId,
+            commitSha,
+            requestedAt: Date.now(),
+        };
+        try {
+            this.saveContext(context);
+            return { initiated: true, context };
+        }
+        catch (e) {
+            return {
+                initiated: false,
+                error: e instanceof Error ? e.message : String(e),
+            };
+        }
+    }
+    /**
+     * Save restart context to disk.
+     */
+    saveContext(context) {
+        mkdirSync(dirname(this.contextPath), { recursive: true });
+        writeFileSync(this.contextPath, JSON.stringify(context, null, 2), 'utf-8');
+    }
+    /**
+     * Load restart context from disk (if any).
+     * Returns null if no pending restart context exists.
+     */
+    loadContext() {
+        try {
+            const raw = readFileSync(this.contextPath, 'utf-8');
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Clear restart context (call after successful startup confirmation).
+     */
+    clearContext() {
+        try {
+            unlinkSync(this.contextPath);
+        }
+        catch {
+            // File doesn't exist — that's fine
+        }
+    }
+    /**
+     * Check if there's a pending restart context.
+     */
+    hasPendingRestart() {
+        return this.loadContext() !== null;
+    }
+    /**
+     * Sanitize a commit message for safe shell usage.
+     * Allows alphanumeric, spaces, basic punctuation. Max 120 chars.
+     */
+    static sanitizeCommitMessage(msg) {
+        return msg
+            .replace(/[^\w\s.,!?:;()\-/'"#@]/g, '')
+            .trim()
+            .slice(0, 120);
+    }
+}
+//# sourceMappingURL=self-update.js.map

package/dist/chat/self-update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-update.js","sourceRoot":"","sources":["../../src/chat/self-update.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,qEAAqE;AACrE,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAsBpC,MAAM,OAAO,iBAAiB;IACC;IAA7B,YAA6B,WAAmB;QAAnB,gBAAW,GAAX,WAAW,CAAQ;IAAG,CAAC;IAEpD;;;;OAIG;IACH,cAAc,CACZ,MAAc,EACd,SAAmC,QAAQ,EAC3C,SAAkB;QAElB,MAAM,OAAO,GAAmB;YAC9B,MAAM;YACN,MAAM;YACN,SAAS;YACT,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;SACxB,CAAC;QAEF,IAAI,CAAC;YACH,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YAC1B,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QACtC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO;gBACL,SAAS,EAAE,KAAK;gBAChB,KAAK,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;aAClD,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,OAAuB;QACjC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,aAAa,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAC7E,CAAC;IAED;;;OAGG;IACH,WAAW;QACT,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YACpD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmB,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,YAAY;QACV,IAAI,CAAC;YACH,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,mCAAmC;QACrC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,OAAO,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC;IACrC,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,qBAAqB,CAAC,GAAW;QACtC,OAAO,GAAG;aACP,OAAO,CAAC,yBAAyB,EAAE,EAAE,CAAC;aACtC,IAAI,EAAE;aACN,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACnB,CAAC;CACF"}

package/dist/chat/types.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Chat transport types — generic primitives for conversational agent transports.
+ *
+ * Works for Telegram, Discord, Slack, or any chat-based interface.
+ * Transport-specific wiring (Grammy, discord.js, etc.) belongs in forge templates.
+ */
+export type ChatRole = 'user' | 'assistant' | 'system' | 'tool';
+export interface ChatMessage {
+    role: ChatRole;
+    content: string;
+    /** Optional structured content blocks (e.g. tool_use, tool_result, image). */
+    blocks?: unknown[];
+    /** Unix timestamp ms. */
+    timestamp: number;
+    /** Transport-specific metadata (message ID, chat ID, etc.). */
+    meta?: Record<string, unknown>;
+}
+export interface ChatSession {
+    /** Unique session ID (typically the chat/channel ID from the transport). */
+    id: string;
+    /** Conversation messages. */
+    messages: ChatMessage[];
+    /** Unix timestamp ms when the session was created. */
+    createdAt: number;
+    /** Unix timestamp ms of the last activity. */
+    lastActiveAt: number;
+    /** Custom metadata (personality state, counters, etc.). */
+    meta?: Record<string, unknown>;
+}
+export interface ChatSessionConfig {
+    /** Directory for session persistence. */
+    storageDir: string;
+    /** TTL in ms for inactivity expiry. Default: 7_200_000 (2 hours). */
+    ttlMs?: number;
+    /** Max messages before compaction triggers. Default: 100. */
+    compactionThreshold?: number;
+    /** Messages to keep after compaction. Default: 40. */
+    compactionKeep?: number;
+}
+export interface Fragment {
+    /** The message text. */
+    text: string;
+    /** Transport message ID (for ordering). */
+    messageId: number | string;
+    /** Unix timestamp ms when received. */
+    receivedAt: number;
+}
+export interface FragmentBufferConfig {
+    /** Character threshold to start buffering. Default: 4000. */
+    startThreshold?: number;
+    /** Max gap in ms between fragments before auto-flush. Default: 1500. */
+    maxGapMs?: number;
+    /** Maximum number of fragments to merge. Default: 12. */
+    maxParts?: number;
+    /** Maximum total bytes before force-flush. Default: 50_000. */
+    maxTotalBytes?: number;
+}
+export type MarkupFormat = 'html' | 'markdown' | 'plain';
+export interface ChunkConfig {
+    /** Max characters per chunk. Default: 4000. */
+    maxChunkSize?: number;
+    /** Output markup format. Default: 'html'. */
+    format?: MarkupFormat;
+}
+export interface ChatAuthConfig {
+    /** Path to auth persistence file. */
+    storagePath: string;
+    /** Passphrase required for authentication. If unset, auth is disabled. */
+    passphrase?: string;
+    /** Allowed user IDs. If empty or unset, any authenticated user is allowed. */
+    allowedUsers?: (string | number)[];
+    /** Rate limit: max failed attempts before temporary lockout. Default: 5. */
+    maxFailedAttempts?: number;
+    /** Lockout duration in ms. Default: 300_000 (5 minutes). */
+    lockoutMs?: number;
+}
+export interface AuthRecord {
+    userId: string | number;
+    authenticatedAt: number;
+}
+export interface AuthState {
+    authenticated: AuthRecord[];
+    failedAttempts: Map<string, {
+        count: number;
+        lastAttempt: number;
+    }>;
+}
+export interface ChatManagerConfig {
+    session: ChatSessionConfig;
+    fragment?: FragmentBufferConfig;
+    chunk?: ChunkConfig;
+    auth?: ChatAuthConfig;
+}
+export interface ChatManagerStatus {
+    activeSessions: number;
+    authenticatedUsers: number;
+    pendingFragments: number;
+    config: {
+        ttlMs: number;
+        compactionThreshold: number;
+        maxChunkSize: number;
+        authEnabled: boolean;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/chat/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEhE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;IACnB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAID,MAAM,WAAW,WAAW;IAC1B,4EAA4E;IAC5E,EAAE,EAAE,MAAM,CAAC;IACX,6BAA6B;IAC7B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,YAAY,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,iBAAiB;IAChC,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,sDAAsD;IACtD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAID,MAAM,WAAW,QAAQ;IACvB,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,6DAA6D;IAC7D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAID,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC;AAEzD,MAAM,WAAW,WAAW;IAC1B,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAID,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,YAAY,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IACnC,4EAA4E;IAC5E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,aAAa,EAAE,UAAU,EAAE,CAAC;IAC5B,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrE;AAID,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,mBAAmB,EAAE,MAAM,CAAC;QAC5B,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,OAAO,CAAC;KACtB,CAAC;CACH"}

package/dist/chat/types.js

@@ -0,0 +1,8 @@
+/**
+ * Chat transport types — generic primitives for conversational agent transports.
+ *
+ * Works for Telegram, Discord, Slack, or any chat-based interface.
+ * Transport-specific wiring (Grammy, discord.js, etc.) belongs in forge templates.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/chat/types.js.map

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

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"}