@mainwp/control 1.0.0

package/dist/chat/providers/provider-fetch.js

@@ -0,0 +1,35 @@
+/**
+ * Shared HTTP fetch utility for LLM providers
+ *
+ * Extracts the common makeRequest pattern: timeout via AbortController,
+ * combined abort signals, JSON POST, error handling.
+ */
+import { stripControlChars } from '../../utils/terminal-sanitizer.js';
+export async function makeProviderRequest(options) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), options.timeout);
+    const combinedSignal = options.signal
+        ? AbortSignal.any([options.signal, controller.signal])
+        : controller.signal;
+    try {
+        const response = await fetch(options.url, {
+            method: 'POST',
+            headers: options.headers,
+            body: JSON.stringify(options.body),
+            signal: combinedSignal,
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            // SECURITY: Strip control characters and truncate to prevent exfiltration
+            // of large payloads from untrusted API error bodies
+            const sanitized = stripControlChars(errorText);
+            const truncated = sanitized.length > 500 ? sanitized.slice(0, 500) + '...' : sanitized;
+            throw new Error(`${options.providerName} API error: ${response.status} ${truncated}`);
+        }
+        return (await response.json());
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+}
+//# sourceMappingURL=provider-fetch.js.map

package/dist/chat/providers/provider-fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-fetch.js","sourceRoot":"","sources":["../../../src/chat/providers/provider-fetch.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAEtE,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAI,OAO5C;IACC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAExE,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM;QACnC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;QACtD,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC;IAEtB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE;YACxC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC;YAClC,MAAM,EAAE,cAAc;SACvB,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACxC,0EAA0E;YAC1E,oDAAoD;YACpD,MAAM,SAAS,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;YAC/C,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;YACvF,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,CAAC,YAAY,eAAe,QAAQ,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC,CAAC;QACxF,CAAC;QAED,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAM,CAAC;IACtC,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,SAAS,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC"}

package/dist/chat/providers/provider.d.ts

@@ -0,0 +1,214 @@
+/**
+ * LLM Provider Interface for mainwpcontrol
+ *
+ * Abstract interface for different LLM providers.
+ * Supported: OpenAI, Anthropic, Gemini, OpenRouter, Local (OpenAI-compatible)
+ */
+/**
+ * Message role in conversation
+ */
+export type MessageRole = 'system' | 'user' | 'assistant' | 'tool';
+/**
+ * Chat message
+ */
+export interface Message {
+    role: MessageRole;
+    content: string;
+    /** Tool call ID (for tool responses) */
+    toolCallId?: string;
+    /** Tool name (for tool responses) */
+    toolName?: string;
+}
+/**
+ * Tool definition for function calling
+ */
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+}
+/**
+ * Tool call from LLM
+ */
+export interface ToolCall {
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+}
+/**
+ * LLM response
+ */
+export interface LLMResponse {
+    /** Raw content from LLM */
+    content: string;
+    /** Parsed tool calls (if using function calling API) */
+    toolCalls?: ToolCall[] | undefined;
+    /** Finish reason */
+    finishReason: 'stop' | 'tool_calls' | 'length' | 'content_filter' | 'error';
+    /** Usage statistics */
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    } | undefined;
+    /** Model used */
+    model: string;
+}
+/**
+ * Chat options
+ */
+export interface ChatOptions {
+    /** Model to use (provider-specific) */
+    model?: string | undefined;
+    /** Temperature (0-2) */
+    temperature?: number | undefined;
+    /** Maximum tokens in response */
+    maxTokens?: number | undefined;
+    /** Tool definitions for function calling */
+    tools?: ToolDefinition[] | undefined;
+    /** Whether to use streaming */
+    stream?: boolean | undefined;
+    /** Abort signal */
+    signal?: AbortSignal | undefined;
+    /** Stop sequences */
+    stop?: string[] | undefined;
+}
+/**
+ * Stream chunk for streaming responses
+ */
+export interface StreamChunk {
+    /** Content delta */
+    content?: string;
+    /** Tool call delta */
+    toolCall?: Partial<ToolCall>;
+    /** Whether this is the final chunk */
+    done: boolean;
+}
+/**
+ * Provider configuration
+ */
+export interface ProviderConfig {
+    /** API key */
+    apiKey: string;
+    /** Base URL (for custom endpoints) */
+    baseUrl?: string | undefined;
+    /** Default model */
+    defaultModel?: string | undefined;
+    /** Request timeout in ms */
+    timeout?: number | undefined;
+    /** Organization ID (OpenAI) */
+    organization?: string | undefined;
+}
+/**
+ * Supported provider names
+ */
+export declare const SUPPORTED_PROVIDER_NAMES: readonly ["openai", "anthropic", "gemini", "openrouter", "local"];
+export type ProviderName = typeof SUPPORTED_PROVIDER_NAMES[number];
+export type ProviderSelectionSource = 'flag' | 'env' | 'settings' | 'auto' | 'none';
+export interface ResolvedProviderSelection {
+    name?: ProviderName;
+    source: ProviderSelectionSource;
+    configured: boolean;
+    config: ProviderConfig;
+    warnings: string[];
+}
+/**
+ * Provider capabilities
+ */
+export interface ProviderCapabilities {
+    /** Supports function calling */
+    functionCalling: boolean;
+    /** Supports streaming */
+    streaming: boolean;
+    /** Supports system messages */
+    systemMessages: boolean;
+    /** Supports vision/images */
+    vision: boolean;
+    /** Maximum context length */
+    maxContextLength: number;
+}
+/**
+ * LLM Provider interface
+ */
+export interface LLMProvider {
+    /** Provider name */
+    readonly name: string;
+    /** Provider capabilities */
+    readonly capabilities: ProviderCapabilities;
+    /**
+     * Send chat completion request
+     */
+    chat(messages: Message[], options?: ChatOptions): Promise<LLMResponse>;
+    /**
+     * Send chat completion request with streaming
+     */
+    chatStream?(messages: Message[], options?: ChatOptions): AsyncGenerator<StreamChunk, void, undefined>;
+    /**
+     * Check if provider is configured
+     */
+    isConfigured(): boolean;
+    /**
+     * Get available models
+     */
+    getModels(): string[];
+    /**
+     * Get default model
+     */
+    getDefaultModel(): string;
+}
+/**
+ * Provider factory function type
+ */
+export type ProviderFactory = (config: ProviderConfig) => LLMProvider;
+/**
+ * Register a provider factory
+ */
+export declare function registerProvider(name: string, factory: ProviderFactory): void;
+/**
+ * Get a provider factory
+ */
+export declare function getProviderFactory(name: string): ProviderFactory | undefined;
+/**
+ * List registered providers
+ */
+export declare function listProviders(): string[];
+/**
+ * Check whether a provider name is supported.
+ */
+export declare function isSupportedProviderName(value: string): value is ProviderName;
+/**
+ * Create a provider from config
+ */
+export declare function createProvider(name: string, config: ProviderConfig): LLMProvider;
+/**
+ * Provider environment variable names
+ */
+export declare const PROVIDER_ENV_VARS: Record<string, {
+    key: string;
+    url?: string;
+}>;
+/**
+ * Get provider config from environment
+ */
+export declare function getProviderConfigFromEnv(providerName: string): Partial<ProviderConfig> | undefined;
+/**
+ * Resolve the effective provider selection and merged configuration.
+ */
+export declare function resolveProviderSelection(options: {
+    flagProvider?: string | undefined;
+    envProvider?: string | undefined;
+    settingsProvider?: string | undefined;
+    apiKey?: string | undefined;
+    baseUrl?: string | undefined;
+    model?: string | undefined;
+    timeout?: number | undefined;
+}): ResolvedProviderSelection;
+/**
+ * Auto-detect configured provider from environment
+ */
+export declare function detectConfiguredProvider(): string | undefined;
+/**
+ * Convert ability schema to tool definition
+ */
+export declare function abilityToTool(name: string, description: string, inputSchema: Record<string, unknown> | undefined): ToolDefinition;
+//# sourceMappingURL=provider.d.ts.map

package/dist/chat/providers/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/chat/providers/provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,SAAS,CAAC,EAAE,QAAQ,EAAE,GAAG,SAAS,CAAC;IACnC,oBAAoB;IACpB,YAAY,EAAE,MAAM,GAAG,YAAY,GAAG,QAAQ,GAAG,gBAAgB,GAAG,OAAO,CAAC;IAC5E,uBAAuB;IACvB,KAAK,CAAC,EAAE;QACN,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;KACrB,GAAG,SAAS,CAAC;IACd,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,4CAA4C;IAC5C,KAAK,CAAC,EAAE,cAAc,EAAE,GAAG,SAAS,CAAC;IACrC,+BAA+B;IAC/B,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,mBAAmB;IACnB,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACjC,qBAAqB;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,oBAAoB;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC7B,sCAAsC;IACtC,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,cAAc;IACd,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,oBAAoB;IACpB,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,4BAA4B;IAC5B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,+BAA+B;IAC/B,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB,mEAM3B,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,OAAO,wBAAwB,CAAC,MAAM,CAAC,CAAC;AAEnE,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,KAAK,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AAEpF,MAAM,WAAW,yBAAyB;IACxC,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,uBAAuB,CAAC;IAChC,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,gCAAgC;IAChC,eAAe,EAAE,OAAO,CAAC;IACzB,yBAAyB;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,+BAA+B;IAC/B,cAAc,EAAE,OAAO,CAAC;IACxB,6BAA6B;IAC7B,MAAM,EAAE,OAAO,CAAC;IAChB,6BAA6B;IAC7B,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,oBAAoB;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,4BAA4B;IAC5B,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAAC;IAE5C;;OAEG;IACH,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEvE;;OAEG;IACH,UAAU,CAAC,CACT,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,CAAC,EAAE,WAAW,GACpB,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;IAEhD;;OAEG;IACH,YAAY,IAAI,OAAO,CAAC;IAExB;;OAEG;IACH,SAAS,IAAI,MAAM,EAAE,CAAC;IAEtB;;OAEG;IACH,eAAe,IAAI,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,cAAc,KAAK,WAAW,CAAC;AAOtE;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI,CAE7E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAE5E;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,EAAE,CAExC;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,YAAY,CAE5E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,WAAW,CAMhF;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAM3E,CAAC;AAEF;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,cAAc,CAAC,GAAG,SAAS,CAiBrC;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAChD,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B,GAAG,yBAAyB,CAgE5B;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,GAAG,SAAS,CAY7D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC/C,cAAc,CAMhB"}

package/dist/chat/providers/provider.js

@@ -0,0 +1,166 @@
+/**
+ * LLM Provider Interface for mainwpcontrol
+ *
+ * Abstract interface for different LLM providers.
+ * Supported: OpenAI, Anthropic, Gemini, OpenRouter, Local (OpenAI-compatible)
+ */
+/**
+ * Supported provider names
+ */
+export const SUPPORTED_PROVIDER_NAMES = [
+    'openai',
+    'anthropic',
+    'gemini',
+    'openrouter',
+    'local',
+];
+/**
+ * Provider registry
+ */
+const providers = new Map();
+/**
+ * Register a provider factory
+ */
+export function registerProvider(name, factory) {
+    providers.set(name.toLowerCase(), factory);
+}
+/**
+ * Get a provider factory
+ */
+export function getProviderFactory(name) {
+    return providers.get(name.toLowerCase());
+}
+/**
+ * List registered providers
+ */
+export function listProviders() {
+    return Array.from(providers.keys());
+}
+/**
+ * Check whether a provider name is supported.
+ */
+export function isSupportedProviderName(value) {
+    return SUPPORTED_PROVIDER_NAMES.includes(value.toLowerCase());
+}
+/**
+ * Create a provider from config
+ */
+export function createProvider(name, config) {
+    const factory = getProviderFactory(name);
+    if (!factory) {
+        throw new Error(`Unknown provider: ${name}. Available: ${listProviders().join(', ')}`);
+    }
+    return factory(config);
+}
+/**
+ * Provider environment variable names
+ */
+export const PROVIDER_ENV_VARS = {
+    openai: { key: 'OPENAI_API_KEY' },
+    anthropic: { key: 'ANTHROPIC_API_KEY' },
+    gemini: { key: 'GOOGLE_API_KEY' },
+    openrouter: { key: 'OPENROUTER_API_KEY' },
+    local: { key: 'LOCAL_LLM_API_KEY', url: 'LOCAL_LLM_URL' },
+};
+/**
+ * Get provider config from environment
+ */
+export function getProviderConfigFromEnv(providerName) {
+    const envConfig = PROVIDER_ENV_VARS[providerName.toLowerCase()];
+    if (!envConfig)
+        return undefined;
+    const apiKey = process.env[envConfig.key];
+    if (!apiKey)
+        return undefined;
+    const config = { apiKey };
+    if (envConfig.url) {
+        const baseUrl = process.env[envConfig.url];
+        if (baseUrl) {
+            config.baseUrl = baseUrl;
+        }
+    }
+    return config;
+}
+/**
+ * Resolve the effective provider selection and merged configuration.
+ */
+export function resolveProviderSelection(options) {
+    const warnings = [];
+    const preferredCandidates = [
+        { value: options.flagProvider, source: 'flag' },
+        { value: options.envProvider, source: 'env' },
+        { value: options.settingsProvider, source: 'settings' },
+    ];
+    let selectedName;
+    let source = 'none';
+    for (const candidate of preferredCandidates) {
+        if (!candidate.value)
+            continue;
+        const normalized = candidate.value.trim().toLowerCase();
+        if (!isSupportedProviderName(normalized)) {
+            warnings.push(`Ignoring unsupported LLM provider "${candidate.value}". Available: ${SUPPORTED_PROVIDER_NAMES.join(', ')}`);
+            continue;
+        }
+        selectedName = normalized;
+        source = candidate.source;
+        break;
+    }
+    if (!selectedName) {
+        const detected = detectConfiguredProvider();
+        if (detected && isSupportedProviderName(detected)) {
+            selectedName = detected;
+            source = 'auto';
+        }
+    }
+    if (!selectedName) {
+        return {
+            source: 'none',
+            configured: false,
+            config: {
+                apiKey: '',
+                timeout: options.timeout,
+            },
+            warnings,
+        };
+    }
+    const envConfig = getProviderConfigFromEnv(selectedName) ?? {};
+    const apiKey = options.apiKey ?? envConfig.apiKey ?? '';
+    const baseUrl = options.baseUrl ?? envConfig.baseUrl;
+    return {
+        name: selectedName,
+        source,
+        configured: Boolean(apiKey),
+        config: {
+            apiKey,
+            baseUrl,
+            defaultModel: options.model,
+            timeout: options.timeout,
+        },
+        warnings,
+    };
+}
+/**
+ * Auto-detect configured provider from environment
+ */
+export function detectConfiguredProvider() {
+    // Priority order
+    const priority = ['anthropic', 'openai', 'gemini', 'openrouter', 'local'];
+    for (const provider of priority) {
+        const config = getProviderConfigFromEnv(provider);
+        if (config?.apiKey) {
+            return provider;
+        }
+    }
+    return undefined;
+}
+/**
+ * Convert ability schema to tool definition
+ */
+export function abilityToTool(name, description, inputSchema) {
+    return {
+        name,
+        description,
+        parameters: inputSchema ?? { type: 'object', properties: {} },
+    };
+}
+//# sourceMappingURL=provider.js.map

package/dist/chat/providers/provider.js.map

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

package/dist/chat/providers/sse-reader.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Shared SSE (Server-Sent Events) line reader for LLM providers
+ *
+ * Handles the common boilerplate: response validation, chunked reading,
+ * line buffering, and "data: " prefix stripping. Yields raw JSON strings
+ * for provider-specific interpretation.
+ */
+/**
+ * Make an SSE streaming request and yield raw JSON strings from "data: " lines.
+ *
+ * Skips the OpenAI "[DONE]" sentinel (yielded as-is so callers can detect it).
+ * Invalid JSON is the caller's responsibility to handle.
+ */
+export declare function readSSEStream(options: {
+    url: string;
+    headers: Record<string, string>;
+    body: Record<string, unknown>;
+    signal?: AbortSignal | undefined;
+    providerName: string;
+}): AsyncGenerator<string, void, undefined>;
+//# sourceMappingURL=sse-reader.d.ts.map

package/dist/chat/providers/sse-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-reader.d.ts","sourceRoot":"","sources":["../../../src/chat/providers/sse-reader.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;GAKG;AACH,wBAAuB,aAAa,CAAC,OAAO,EAAE;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,CAuC1C"}

package/dist/chat/providers/sse-reader.js

@@ -0,0 +1,48 @@
+/**
+ * Shared SSE (Server-Sent Events) line reader for LLM providers
+ *
+ * Handles the common boilerplate: response validation, chunked reading,
+ * line buffering, and "data: " prefix stripping. Yields raw JSON strings
+ * for provider-specific interpretation.
+ */
+/**
+ * Make an SSE streaming request and yield raw JSON strings from "data: " lines.
+ *
+ * Skips the OpenAI "[DONE]" sentinel (yielded as-is so callers can detect it).
+ * Invalid JSON is the caller's responsibility to handle.
+ */
+export async function* readSSEStream(options) {
+    const fetchOptions = {
+        method: 'POST',
+        headers: options.headers,
+        body: JSON.stringify(options.body),
+    };
+    if (options.signal) {
+        fetchOptions.signal = options.signal;
+    }
+    const response = await fetch(options.url, fetchOptions);
+    if (!response.ok) {
+        const error = await response.text();
+        throw new Error(`${options.providerName} API error: ${response.status} ${error}`);
+    }
+    if (!response.body) {
+        throw new Error('No response body');
+    }
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = '';
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        buffer += decoder.decode(value, { stream: true });
+        const lines = buffer.split('\n');
+        buffer = lines.pop() ?? '';
+        for (const line of lines) {
+            if (!line.startsWith('data: '))
+                continue;
+            yield line.slice(6);
+        }
+    }
+}
+//# sourceMappingURL=sse-reader.js.map

package/dist/chat/providers/sse-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-reader.js","sourceRoot":"","sources":["../../../src/chat/providers/sse-reader.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;GAKG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,aAAa,CAAC,OAMpC;IACC,MAAM,YAAY,GAAgB;QAChC,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC;KACnC,CAAC;IAEF,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,YAAY,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACvC,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAExD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,CAAC,YAAY,eAAe,QAAQ,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC,CAAC;IACpF,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,IAAI,MAAM,GAAG,EAAE,CAAC;IAEhB,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QAC5C,IAAI,IAAI;YAAE,MAAM;QAEhB,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;QAE3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;gBAAE,SAAS;YACzC,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/chat/system-prompt.d.ts

@@ -0,0 +1,33 @@
+/**
+ * System Prompt for MainWP Control chat
+ *
+ * Embeds the runtime AI behavior contract from CHAT_PROMPT.md.
+ * This is executable configuration, not documentation.
+ *
+ * INVARIANT: AI is the primary interaction surface, NOT the execution authority.
+ */
+import type { Ability } from '../core/abilities-executor.js';
+/**
+ * System prompt configuration
+ */
+export interface SystemPromptConfig {
+    /** Maximum number of tool calls per turn */
+    maxToolCalls: number;
+    /** Maximum JSON parse retries */
+    maxParseRetries: number;
+    /** Whether to include detailed schemas */
+    includeSchemas: boolean;
+    /** Maximum messages to keep in context (excluding system prompt). undefined = no limit */
+    maxContextMessages?: number;
+    /** Maximum estimated tokens in context. Reserved for future use. */
+    maxContextTokens?: number;
+}
+/**
+ * Default system prompt configuration
+ */
+export declare const defaultConfig: SystemPromptConfig;
+/**
+ * Build system prompt with configuration
+ */
+export declare function buildConfiguredPrompt(abilities: Ability[], config?: Partial<SystemPromptConfig>): string;
+//# sourceMappingURL=system-prompt.d.ts.map

package/dist/chat/system-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../src/chat/system-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAkJ7D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,iCAAiC;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,0CAA0C;IAC1C,cAAc,EAAE,OAAO,CAAC;IACxB,0FAA0F;IAC1F,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,kBAK3B,CAAC;AAEF;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,OAAO,EAAE,EACpB,MAAM,GAAE,OAAO,CAAC,kBAAkB,CAAM,GACvC,MAAM,CAgBR"}