@mandible-ai/mandible 0.3.13 → 0.3.14

package/dist/src/providers/types.d.ts

@@ -78,6 +78,14 @@ export interface ClaudeCodeConfig<T = Record<string, unknown>> {
      * Use this to provide ANTHROPIC_API_KEY explicitly.
      */
     env?: Record<string, string>;
+    /**
+     * Custom API base URL. Routes the Claude Code SDK to a local or
+     * third-party endpoint that speaks the Anthropic Messages API
+     * (e.g. Ollama, llama.cpp, LM Studio).
+     *
+     * Sets ANTHROPIC_BASE_URL in the agent's environment.
+     */
+    apiBaseUrl?: string;
     /**
      * Route the agent through AWS Bedrock.
      * Sets the required env vars for the Claude Agent SDK automatically.
@@ -158,6 +166,61 @@ export interface StructuredOutputConfig<T = Record<string, unknown>, R = Record<
     route: string | ((result: R, signal: Signal<T>) => SignalDeposit | SignalDeposit[]);
     autoWithdraw?: boolean;
 }
+/**
+ * Config for plain text LLM provider (withLLM).
+ * Calls an LLM and returns raw text — no schema validation.
+ * Use for summarization, prose generation, or open-ended responses.
+ * Provider-agnostic: works with Anthropic, OpenAI, Bedrock, Vercel AI, or custom.
+ */
+export interface LLMConfig<T = Record<string, unknown>> {
+    /** Model identifier. Format depends on the SDK you're using. */
+    model: string;
+    /**
+     * Provider SDK to use for the LLM call.
+     * 'anthropic' = @anthropic-ai/sdk
+     * 'bedrock' = @anthropic-ai/bedrock-sdk (Claude via AWS Bedrock)
+     * 'openai' = openai SDK
+     * 'vercel-ai' = Vercel AI SDK (ai package)
+     * Or pass a custom function.
+     */
+    provider?: 'anthropic' | 'bedrock' | 'openai' | 'vercel-ai' | LLMCallFunction<string>;
+    /** Build the prompt from the signal. */
+    prompt: string | ((signal: Signal<T>) => string | Promise<string>);
+    /** System prompt. */
+    systemPrompt?: string;
+    /**
+     * Bedrock configuration. Required when provider is 'bedrock'.
+     * Provides AWS region, credentials, and optional guardrail settings.
+     */
+    bedrockConfig?: BedrockConfig;
+    /** Max tokens (default: 4096). */
+    maxTokens?: number;
+    /** Temperature 0-1. Lower = more deterministic (default: 0). */
+    temperature?: number;
+    /**
+     * Expected response format. Appends a format instruction to the prompt
+     * and includes `format` in the default payload so downstream colonies
+     * can branch on it without guessing.
+     *
+     * - 'text' (default): no format instruction appended, payload is { text }.
+     * - 'markdown': instructs the LLM to respond in markdown, payload is { text, format: 'markdown' }.
+     *
+     * Only affects the default string-route payload. When `route` is a function,
+     * format metadata is your responsibility.
+     */
+    format?: 'text' | 'markdown';
+    /**
+     * Route output to signal type(s).
+     * If a string, deposits that type with { text } (or { text, format } when format is set) as payload.
+     * If a function, returns the signal deposit(s) — full control over payload shape.
+     */
+    route: string | ((text: string, signal: Signal<T>) => SignalDeposit | SignalDeposit[]);
+    /**
+     * Whether to auto-withdraw the triggering signal after success.
+     * Defaults to true.
+     */
+    autoWithdraw?: boolean;
+}
 /**
  * Config for bash provider (withBash).
  * Runs shell commands for mechanical tasks like git merge, deploy, etc.

package/dist/src/providers/types.d.ts.map

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

package/dist/src/providers/vllm.d.ts

@@ -0,0 +1,62 @@
+import type { LLMCallFunction } from './types.js';
+export interface VLLMConfig {
+    /** vLLM server endpoint, e.g. 'http://localhost:8001'. No trailing slash. */
+    endpoint: string;
+    /**
+     * Model name to use. If not provided, auto-detects from GET /v1/models.
+     * The auto-detected model is cached after the first call.
+     */
+    model?: string;
+    /** Optional API key for vLLM (if configured with --api-key). */
+    apiKey?: string;
+    /**
+     * Enable JSON mode via response_format: { type: "json_object" }.
+     * Automatically enabled by vllmStructuredProvider().
+     * When true, vLLM uses guided decoding to guarantee valid JSON output.
+     */
+    jsonMode?: boolean;
+    /** Maximum retries on 503 (model loading) and 429 (rate limited). Default: 3. */
+    maxRetries?: number;
+    /** Base delay in ms between retries (exponential backoff). Default: 1000. */
+    retryDelayMs?: number;
+    /**
+     * Whether to verify the vLLM server is reachable on the first call.
+     * Calls GET /v1/models and fails fast if the server is down. Default: true.
+     */
+    healthCheckOnInit?: boolean;
+    /** Request timeout in ms. Default: 120_000 (2 minutes). */
+    timeoutMs?: number;
+    /** Extra headers to include in every request. */
+    headers?: Record<string, string>;
+}
+/**
+ * Creates a LLMCallFunction<string> that calls vLLM for plain text generation.
+ * Plug directly into withLLM({ provider: vllmProvider({ endpoint }) }).
+ */
+export declare function vllmProvider(config: VLLMConfig): LLMCallFunction<string>;
+/**
+ * Creates a LLMCallFunction<R> that calls vLLM with JSON mode enabled.
+ * The response is parsed as JSON and returned as type R.
+ * Plug into withStructuredOutput({ provider: vllmStructuredProvider({ endpoint }) }).
+ */
+export declare function vllmStructuredProvider<R = Record<string, unknown>>(config: VLLMConfig): LLMCallFunction<R>;
+export type VLLMErrorCode = 'CONNECTION_FAILED' | 'HEALTH_CHECK_FAILED' | 'NO_MODELS' | 'API_ERROR' | 'MAX_RETRIES_EXCEEDED' | 'PARSE_ERROR' | 'JSON_PARSE_ERROR';
+export declare class VLLMError extends Error {
+    readonly code: VLLMErrorCode;
+    readonly statusCode?: number;
+    constructor(message: string, code: VLLMErrorCode, statusCode?: number);
+}
+/**
+ * Creates a vllmProvider using VLLM_ENDPOINT environment variable.
+ * Returns null if VLLM_ENDPOINT is not set (graceful fallback).
+ *
+ * Usage:
+ *   const provider = vllmFromEnv() ?? 'anthropic';
+ */
+export declare function vllmFromEnv(): LLMCallFunction<string> | null;
+/**
+ * Creates a vllmStructuredProvider using VLLM_ENDPOINT environment variable.
+ * Returns null if VLLM_ENDPOINT is not set.
+ */
+export declare function vllmStructuredFromEnv<R = Record<string, unknown>>(): LLMCallFunction<R> | null;
+//# sourceMappingURL=vllm.d.ts.map

package/dist/src/providers/vllm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vllm.d.ts","sourceRoot":"","sources":["../../../src/providers/vllm.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAMlD,MAAM,WAAW,UAAU;IACzB,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,6EAA6E;IAC7E,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAeD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC,CAkBxE;AAMD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChE,MAAM,EAAE,UAAU,GACjB,eAAe,CAAC,CAAC,CAAC,CAoBpB;AA8LD,MAAM,MAAM,aAAa,GACrB,mBAAmB,GACnB,qBAAqB,GACrB,WAAW,GACX,WAAW,GACX,sBAAsB,GACtB,aAAa,GACb,kBAAkB,CAAC;AAEvB,qBAAa,SAAU,SAAQ,KAAK;IAClC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;gBAEjB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,UAAU,CAAC,EAAE,MAAM;CAMtE;AAcD;;;;;;GAMG;AACH,wBAAgB,WAAW,IAAI,eAAe,CAAC,MAAM,CAAC,GAAG,IAAI,CAQ5D;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,eAAe,CAAC,CAAC,CAAC,GAAG,IAAI,CAQ9F"}

package/dist/src/providers/vllm.js

@@ -0,0 +1,262 @@
+// ============================================================
+// vLLM Provider — Local inference via vLLM's OpenAI-compatible API
+// ============================================================
+// Produces LLMCallFunction instances that call a local vLLM server.
+// No external API calls. No cloud dependencies. Everything on localhost.
+//
+// Two factory functions:
+//   vllmProvider()           → LLMCallFunction<string>  (for withLLM)
+//   vllmStructuredProvider() → LLMCallFunction<R>       (for withStructuredOutput)
+//
+// Usage:
+//   import { vllmProvider, vllmStructuredProvider } from '@mandible-ai/mandible/providers';
+//
+//   // Text generation
+//   withLLM({
+//     model: 'Qwen3-Coder-Next',
+//     provider: vllmProvider({ endpoint: 'http://localhost:8001' }),
+//     prompt: (signal) => `Summarize: ${signal.payload.text}`,
+//     route: 'summary:ready',
+//   })
+//
+//   // Structured output (JSON mode)
+//   withStructuredOutput({
+//     model: 'Qwen3-Coder-Next',
+//     provider: vllmStructuredProvider({ endpoint: 'http://localhost:8001' }),
+//     schema: reviewSchema,
+//     prompt: (signal) => `Review: ${signal.payload.diff}`,
+//     route: (r) => r.approved ? { type: 'review:approved' } : { type: 'review:changes-needed' },
+//   })
+// ============================================================
+// ----------------------------------------------------------
+// Factory: text generation (for withLLM)
+// ----------------------------------------------------------
+/**
+ * Creates a LLMCallFunction<string> that calls vLLM for plain text generation.
+ * Plug directly into withLLM({ provider: vllmProvider({ endpoint }) }).
+ */
+export function vllmProvider(config) {
+    const state = { resolvedModel: config.model ?? null, healthChecked: false };
+    const endpoint = config.endpoint.replace(/\/+$/, '');
+    return async (prompt, options) => {
+        await ensureReady(endpoint, config, state);
+        const messages = buildMessages(prompt, options.systemPrompt);
+        const body = {
+            model: state.resolvedModel,
+            messages,
+            max_tokens: options.maxTokens ?? 4096,
+            temperature: options.temperature ?? 0,
+        };
+        const data = await callVLLM(endpoint, '/v1/chat/completions', body, config);
+        return extractText(data);
+    };
+}
+// ----------------------------------------------------------
+// Factory: structured output (for withStructuredOutput)
+// ----------------------------------------------------------
+/**
+ * Creates a LLMCallFunction<R> that calls vLLM with JSON mode enabled.
+ * The response is parsed as JSON and returned as type R.
+ * Plug into withStructuredOutput({ provider: vllmStructuredProvider({ endpoint }) }).
+ */
+export function vllmStructuredProvider(config) {
+    const state = { resolvedModel: config.model ?? null, healthChecked: false };
+    const endpoint = config.endpoint.replace(/\/+$/, '');
+    return async (prompt, options) => {
+        await ensureReady(endpoint, config, state);
+        const messages = buildMessages(prompt, options.systemPrompt);
+        const body = {
+            model: state.resolvedModel,
+            messages,
+            max_tokens: options.maxTokens ?? 4096,
+            temperature: options.temperature ?? 0,
+            response_format: { type: 'json_object' },
+        };
+        const data = await callVLLM(endpoint, '/v1/chat/completions', body, config);
+        const text = extractText(data);
+        return parseJsonResponse(text);
+    };
+}
+// ----------------------------------------------------------
+// Health check & model auto-detection
+// ----------------------------------------------------------
+/**
+ * Check that vLLM is reachable and resolve the model name if needed.
+ * Both checks happen at most once per provider instance.
+ */
+async function ensureReady(endpoint, config, state) {
+    const shouldHealthCheck = (config.healthCheckOnInit ?? true) && !state.healthChecked;
+    const needsModel = !state.resolvedModel;
+    if (!shouldHealthCheck && !needsModel)
+        return;
+    const models = await listModels(endpoint, config);
+    state.healthChecked = true;
+    if (needsModel) {
+        if (models.length === 0) {
+            throw new VLLMError('No models loaded on vLLM server. Ensure a model is loaded before calling the provider.', 'NO_MODELS');
+        }
+        state.resolvedModel = models[0];
+    }
+}
+/**
+ * GET /v1/models — returns the list of loaded model IDs.
+ */
+async function listModels(endpoint, config) {
+    const url = `${endpoint}/v1/models`;
+    const headers = {
+        'Accept': 'application/json',
+        ...config.headers,
+    };
+    if (config.apiKey)
+        headers['Authorization'] = `Bearer ${config.apiKey}`;
+    let response;
+    try {
+        response = await fetch(url, {
+            method: 'GET',
+            headers,
+            signal: AbortSignal.timeout(config.timeoutMs ?? 10_000),
+        });
+    }
+    catch (err) {
+        throw new VLLMError(`Cannot reach vLLM server at ${endpoint}. Is vLLM running?\n  ${err.message}`, 'CONNECTION_FAILED');
+    }
+    if (!response.ok) {
+        throw new VLLMError(`vLLM health check failed: ${response.status} ${response.statusText}`, 'HEALTH_CHECK_FAILED');
+    }
+    const data = await response.json();
+    return (data.data ?? []).map(m => m.id);
+}
+// ----------------------------------------------------------
+// Core HTTP call with retry
+// ----------------------------------------------------------
+async function callVLLM(endpoint, path, body, config) {
+    const url = `${endpoint}${path}`;
+    const maxRetries = config.maxRetries ?? 3;
+    const baseDelay = config.retryDelayMs ?? 1000;
+    const timeoutMs = config.timeoutMs ?? 120_000;
+    const headers = {
+        'Content-Type': 'application/json',
+        'Accept': 'application/json',
+        ...config.headers,
+    };
+    if (config.apiKey)
+        headers['Authorization'] = `Bearer ${config.apiKey}`;
+    let lastError = null;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            const response = await fetch(url, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify(body),
+                signal: AbortSignal.timeout(timeoutMs),
+            });
+            // Retry on 503 (model loading) and 429 (rate limited)
+            if ((response.status === 503 || response.status === 429) && attempt < maxRetries) {
+                const retryAfter = response.headers.get('retry-after');
+                const delay = retryAfter
+                    ? parseInt(retryAfter, 10) * 1000
+                    : baseDelay * Math.pow(2, attempt);
+                await sleep(delay);
+                continue;
+            }
+            if (!response.ok) {
+                const errorBody = await response.text().catch(() => '');
+                throw new VLLMError(`vLLM API error: ${response.status} ${response.statusText}\n${errorBody}`, 'API_ERROR', response.status);
+            }
+            return await response.json();
+        }
+        catch (err) {
+            if (err instanceof VLLMError)
+                throw err;
+            lastError = err;
+            if (attempt < maxRetries) {
+                await sleep(baseDelay * Math.pow(2, attempt));
+                continue;
+            }
+        }
+    }
+    throw new VLLMError(`vLLM request failed after ${maxRetries + 1} attempts: ${lastError?.message}`, 'MAX_RETRIES_EXCEEDED');
+}
+// ----------------------------------------------------------
+// Response parsing
+// ----------------------------------------------------------
+function extractText(data) {
+    const content = data?.choices?.[0]?.message?.content;
+    if (typeof content !== 'string') {
+        throw new VLLMError(`Unexpected vLLM response format: missing choices[0].message.content\n${JSON.stringify(data).slice(0, 500)}`, 'PARSE_ERROR');
+    }
+    return content;
+}
+function parseJsonResponse(text) {
+    // Handle markdown-wrapped JSON (```json ... ```)
+    const jsonMatch = text.match(/```(?:json)?\s*([\s\S]*?)```/) ?? [null, text];
+    const jsonStr = (jsonMatch[1] ?? text).trim();
+    try {
+        return JSON.parse(jsonStr);
+    }
+    catch {
+        throw new VLLMError(`Failed to parse vLLM response as JSON.\nResponse:\n${text.slice(0, 500)}`, 'JSON_PARSE_ERROR');
+    }
+}
+// ----------------------------------------------------------
+// Message building
+// ----------------------------------------------------------
+function buildMessages(prompt, systemPrompt) {
+    const messages = [];
+    if (systemPrompt) {
+        messages.push({ role: 'system', content: systemPrompt });
+    }
+    messages.push({ role: 'user', content: prompt });
+    return messages;
+}
+export class VLLMError extends Error {
+    code;
+    statusCode;
+    constructor(message, code, statusCode) {
+        super(message);
+        this.name = 'VLLMError';
+        this.code = code;
+        this.statusCode = statusCode;
+    }
+}
+// ----------------------------------------------------------
+// Utilities
+// ----------------------------------------------------------
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+// ----------------------------------------------------------
+// Convenience: auto-configured provider from environment
+// ----------------------------------------------------------
+/**
+ * Creates a vllmProvider using VLLM_ENDPOINT environment variable.
+ * Returns null if VLLM_ENDPOINT is not set (graceful fallback).
+ *
+ * Usage:
+ *   const provider = vllmFromEnv() ?? 'anthropic';
+ */
+export function vllmFromEnv() {
+    const endpoint = process.env.VLLM_ENDPOINT;
+    if (!endpoint)
+        return null;
+    return vllmProvider({
+        endpoint,
+        model: process.env.VLLM_MODEL,
+        apiKey: process.env.VLLM_API_KEY,
+    });
+}
+/**
+ * Creates a vllmStructuredProvider using VLLM_ENDPOINT environment variable.
+ * Returns null if VLLM_ENDPOINT is not set.
+ */
+export function vllmStructuredFromEnv() {
+    const endpoint = process.env.VLLM_ENDPOINT;
+    if (!endpoint)
+        return null;
+    return vllmStructuredProvider({
+        endpoint,
+        model: process.env.VLLM_MODEL,
+        apiKey: process.env.VLLM_API_KEY,
+    });
+}
+//# sourceMappingURL=vllm.js.map

package/dist/src/providers/vllm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vllm.js","sourceRoot":"","sources":["../../../src/providers/vllm.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,mEAAmE;AACnE,+DAA+D;AAC/D,oEAAoE;AACpE,yEAAyE;AACzE,EAAE;AACF,yBAAyB;AACzB,sEAAsE;AACtE,mFAAmF;AACnF,EAAE;AACF,SAAS;AACT,4FAA4F;AAC5F,EAAE;AACF,uBAAuB;AACvB,cAAc;AACd,iCAAiC;AACjC,qEAAqE;AACrE,+DAA+D;AAC/D,8BAA8B;AAC9B,OAAO;AACP,EAAE;AACF,qCAAqC;AACrC,2BAA2B;AAC3B,iCAAiC;AACjC,+EAA+E;AAC/E,4BAA4B;AAC5B,4DAA4D;AAC5D,kGAAkG;AAClG,OAAO;AACP,+DAA+D;AAwD/D,6DAA6D;AAC7D,yCAAyC;AACzC,6DAA6D;AAE7D;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,MAAkB;IAC7C,MAAM,KAAK,GAAoB,EAAE,aAAa,EAAE,MAAM,CAAC,KAAK,IAAI,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;IAC7F,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAErD,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;QAC/B,MAAM,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QAE3C,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;QAC7D,MAAM,IAAI,GAA4B;YACpC,KAAK,EAAE,KAAK,CAAC,aAAc;YAC3B,QAAQ;YACR,UAAU,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;YACrC,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,CAAC;SACtC,CAAC;QAEF,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAC5E,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC,CAAC;AACJ,CAAC;AAED,6DAA6D;AAC7D,wDAAwD;AACxD,6DAA6D;AAE7D;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAkB;IAElB,MAAM,KAAK,GAAoB,EAAE,aAAa,EAAE,MAAM,CAAC,KAAK,IAAI,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;IAC7F,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAErD,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;QAC/B,MAAM,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QAE3C,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;QAC7D,MAAM,IAAI,GAA4B;YACpC,KAAK,EAAE,KAAK,CAAC,aAAc;YAC3B,QAAQ;YACR,UAAU,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;YACrC,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,CAAC;YACrC,eAAe,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE;SACzC,CAAC;QAEF,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAC5E,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QAC/B,OAAO,iBAAiB,CAAI,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC;AACJ,CAAC;AAED,6DAA6D;AAC7D,sCAAsC;AACtC,6DAA6D;AAE7D;;;GAGG;AACH,KAAK,UAAU,WAAW,CACxB,QAAgB,EAChB,MAAkB,EAClB,KAAsB;IAEtB,MAAM,iBAAiB,GAAG,CAAC,MAAM,CAAC,iBAAiB,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC;IACrF,MAAM,UAAU,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC;IAExC,IAAI,CAAC,iBAAiB,IAAI,CAAC,UAAU;QAAE,OAAO;IAE9C,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAClD,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC;IAE3B,IAAI,UAAU,EAAE,CAAC;QACf,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,SAAS,CACjB,wFAAwF,EACxF,WAAW,CACZ,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,aAAa,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,UAAU,CAAC,QAAgB,EAAE,MAAkB;IAC5D,MAAM,GAAG,GAAG,GAAG,QAAQ,YAAY,CAAC;IACpC,MAAM,OAAO,GAA2B;QACtC,QAAQ,EAAE,kBAAkB;QAC5B,GAAG,MAAM,CAAC,OAAO;KAClB,CAAC;IACF,IAAI,MAAM,CAAC,MAAM;QAAE,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,MAAM,CAAC,MAAM,EAAE,CAAC;IAExE,IAAI,QAAkB,CAAC;IACvB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC1B,MAAM,EAAE,KAAK;YACb,OAAO;YACP,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC;SACxD,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,MAAM,IAAI,SAAS,CACjB,+BAA+B,QAAQ,yBAAyB,GAAG,CAAC,OAAO,EAAE,EAC7E,mBAAmB,CACpB,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,SAAS,CACjB,6BAA6B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,EACrE,qBAAqB,CACtB,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAsC,CAAC;IACvE,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED,6DAA6D;AAC7D,4BAA4B;AAC5B,6DAA6D;AAE7D,KAAK,UAAU,QAAQ,CACrB,QAAgB,EAChB,IAAY,EACZ,IAA6B,EAC7B,MAAkB;IAElB,MAAM,GAAG,GAAG,GAAG,QAAQ,GAAG,IAAI,EAAE,CAAC;IACjC,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,MAAM,CAAC,YAAY,IAAI,IAAI,CAAC;IAC9C,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,OAAO,CAAC;IAE9C,MAAM,OAAO,GAA2B;QACtC,cAAc,EAAE,kBAAkB;QAClC,QAAQ,EAAE,kBAAkB;QAC5B,GAAG,MAAM,CAAC,OAAO;KAClB,CAAC;IACF,IAAI,MAAM,CAAC,MAAM;QAAE,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,MAAM,CAAC,MAAM,EAAE,CAAC;IAExE,IAAI,SAAS,GAAiB,IAAI,CAAC;IAEnC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;QACvD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAChC,MAAM,EAAE,MAAM;gBACd,OAAO;gBACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;gBAC1B,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC;aACvC,CAAC,CAAC;YAEH,sDAAsD;YACtD,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,CAAC,IAAI,OAAO,GAAG,UAAU,EAAE,CAAC;gBACjF,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;gBACvD,MAAM,KAAK,GAAG,UAAU;oBACtB,CAAC,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,GAAG,IAAI;oBACjC,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;gBACrC,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;gBACnB,SAAS;YACX,CAAC;YAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;gBACxD,MAAM,IAAI,SAAS,CACjB,mBAAmB,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,KAAK,SAAS,EAAE,EACzE,WAAW,EACX,QAAQ,CAAC,MAAM,CAChB,CAAC;YACJ,CAAC;YAED,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC/B,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,IAAI,GAAG,YAAY,SAAS;gBAAE,MAAM,GAAG,CAAC;YAExC,SAAS,GAAG,GAAG,CAAC;YAChB,IAAI,OAAO,GAAG,UAAU,EAAE,CAAC;gBACzB,MAAM,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;gBAC9C,SAAS;YACX,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,IAAI,SAAS,CACjB,6BAA6B,UAAU,GAAG,CAAC,cAAc,SAAS,EAAE,OAAO,EAAE,EAC7E,sBAAsB,CACvB,CAAC;AACJ,CAAC;AAED,6DAA6D;AAC7D,mBAAmB;AACnB,6DAA6D;AAE7D,SAAS,WAAW,CAAC,IAAS;IAC5B,MAAM,OAAO,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC;IACrD,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,MAAM,IAAI,SAAS,CACjB,wEAAwE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAC5G,aAAa,CACd,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,iBAAiB,CAAI,IAAY;IACxC,iDAAiD;IACjD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,8BAA8B,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7E,MAAM,OAAO,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IAE9C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,SAAS,CACjB,sDAAsD,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAC1E,kBAAkB,CACnB,CAAC;IACJ,CAAC;AACH,CAAC;AAED,6DAA6D;AAC7D,mBAAmB;AACnB,6DAA6D;AAE7D,SAAS,aAAa,CACpB,MAAc,EACd,YAAqB;IAErB,MAAM,QAAQ,GAA6C,EAAE,CAAC;IAC9D,IAAI,YAAY,EAAE,CAAC;QACjB,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IACjD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAeD,MAAM,OAAO,SAAU,SAAQ,KAAK;IACzB,IAAI,CAAgB;IACpB,UAAU,CAAU;IAE7B,YAAY,OAAe,EAAE,IAAmB,EAAE,UAAmB;QACnE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED,6DAA6D;AAC7D,YAAY;AACZ,6DAA6D;AAE7D,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,6DAA6D;AAC7D,yDAAyD;AACzD,6DAA6D;AAE7D;;;;;;GAMG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IAC3C,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,OAAO,YAAY,CAAC;QAClB,QAAQ;QACR,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU;QAC7B,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY;KACjC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IAC3C,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,OAAO,sBAAsB,CAAI;QAC/B,QAAQ;QACR,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU;QAC7B,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY;KACjC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mandible-ai/mandible",
-  "version": "0.3.13",
+  "version": "0.3.14",
   "description": "Universal stigmergy framework for autonomous agent coordination — like ant colonies using pheromone trails",
   "type": "module",
   "main": "dist/src/index.js",
@@ -76,6 +76,7 @@
     "demo:repo-maintenance": "tsx src/cli/index.ts dev examples/repo-maintenance/mandible.config.ts"
   },
   "dependencies": {
+    "@inquirer/prompts": "^7.0.0",
     "@noble/ed25519": "^3.0.0",
     "chokidar": "^4.0.0",
     "eventemitter3": "^5.0.0",
@@ -91,7 +92,8 @@
     "@anthropic-ai/sdk": ">=0.30.0",
     "ai": ">=3.0.0",
     "openai": ">=4.0.0",
-    "zod": ">=3.0.0"
+    "zod": ">=3.0.0",
+    "mysql2": ">=3.0.0"
   },
   "peerDependenciesMeta": {
     "@anthropic-ai/bedrock-sdk": {
@@ -120,6 +122,9 @@
     },
     "zod": {
       "optional": true
+    },
+    "mysql2": {
+      "optional": true
     }
   },
   "devDependencies": {