@vinaes/succ 1.3.19

package/dist/lib/llm.js

@@ -0,0 +1,439 @@
+/**
+ * Unified LLM Backend Module
+ *
+ * Two modes:
+ * - claude: Claude Code CLI (process or WebSocket transport)
+ * - api: Any OpenAI-compatible HTTP endpoint (Ollama, OpenRouter, nano-gpt, etc.)
+ *
+ * OpenRouter headers (HTTP-Referer, X-Title) are auto-sent when api_url contains 'openrouter.ai'.
+ */
+import spawn from 'cross-spawn';
+import { logError, logWarn } from './fault-logger.js';
+// cross-spawn exposes .sync at runtime but not in types
+// cross-spawn's sync method is available at runtime but not in types
+// Keep as any since cross-spawn types are incomplete
+const crossSpawnSync = spawn.sync;
+import { getConfig, getLLMTaskConfig, getApiKey, getApiUrl } from './config.js';
+import { ClaudeWSTransport } from './claude-ws-transport.js';
+import { NetworkError, ConfigError } from './errors.js';
+import { processRegistry } from './process-registry.js';
+// ============================================================================
+// Claude Mode (process vs ws)
+// ============================================================================
+/**
+ * Get Claude transport mode from config.
+ * Reads: llm.transport → llm.claude.transport → 'process'
+ */
+export function getClaudeMode() {
+    const config = getConfig();
+    const llm = config.llm;
+    if (!llm)
+        return 'process';
+    if (llm.transport === 'ws' || llm.transport === 'process')
+        return llm.transport;
+    if (llm.claude?.transport)
+        return llm.claude.transport;
+    return 'process';
+}
+// ============================================================================
+// Config Loading
+// ============================================================================
+/**
+ * Build headers for an API call.
+ * Auto-adds OpenRouter-specific headers when endpoint contains 'openrouter.ai'.
+ */
+function buildApiHeaders(endpoint, apiKey) {
+    const headers = {
+        'Content-Type': 'application/json',
+    };
+    if (apiKey) {
+        headers['Authorization'] = `Bearer ${apiKey}`;
+    }
+    // OpenRouter-specific headers
+    if (endpoint.includes('openrouter.ai')) {
+        headers['HTTP-Referer'] = 'https://succ.ai';
+        headers['X-Title'] = 'succ';
+    }
+    return headers;
+}
+/**
+ * Get LLM runtime config from succ config, with defaults.
+ * Reads from llm.type/model/api_url/api_key.
+ */
+export function getLLMConfig() {
+    const config = getConfig();
+    const llm = config.llm || {};
+    const backend = llm.type || 'api';
+    const model = llm.model || (backend === 'claude' ? 'haiku' : 'qwen2.5:7b');
+    return {
+        backend,
+        model,
+        endpoint: getApiUrl() + '/chat/completions',
+        apiKey: getApiKey(),
+        maxTokens: llm.max_tokens ?? 2000,
+        temperature: llm.temperature ?? 0.3,
+    };
+}
+/**
+ * Get Sleep Agent config if enabled.
+ * Reads from llm.sleep.*.
+ */
+export function getSleepAgentConfig() {
+    const config = getConfig();
+    const sleepEnabled = config.llm?.sleep?.enabled;
+    if (!sleepEnabled)
+        return null;
+    const taskCfg = getLLMTaskConfig('sleep');
+    return {
+        backend: 'api', // Sleep agent is always 'api' (claude = ToS issues)
+        model: taskCfg.model,
+        endpoint: taskCfg.api_url + '/chat/completions',
+        apiKey: taskCfg.api_key,
+        maxTokens: taskCfg.max_tokens,
+        temperature: taskCfg.temperature,
+    };
+}
+/**
+ * Check if sleep agent is enabled
+ */
+export function isSleepAgentEnabled() {
+    const config = getConfig();
+    return config.llm?.sleep?.enabled === true;
+}
+/**
+ * Get Chat LLM config for interactive chats (succ chat, onboarding).
+ * Reads from llm.chat.*.
+ */
+export function getChatLLMConfig() {
+    const taskCfg = getLLMTaskConfig('chat');
+    return {
+        backend: taskCfg.mode === 'claude' ? 'claude' : 'api',
+        model: taskCfg.model,
+        endpoint: taskCfg.api_url + '/chat/completions',
+        apiKey: taskCfg.api_key,
+        maxTokens: taskCfg.max_tokens,
+        temperature: taskCfg.temperature,
+    };
+}
+// ============================================================================
+// Main Entry Point
+// ============================================================================
+/**
+ * Call LLM with the configured backend
+ */
+export async function callLLM(prompt, options = {}, configOverride) {
+    let baseConfig;
+    if (options.useSleepAgent) {
+        const sleepAgentConfig = getSleepAgentConfig();
+        baseConfig = sleepAgentConfig || getLLMConfig();
+    }
+    else {
+        baseConfig = getLLMConfig();
+    }
+    const config = { ...baseConfig, ...configOverride };
+    const timeout = options.timeout || 30000;
+    const maxTokens = options.maxTokens || config.maxTokens || 2000;
+    const temperature = options.temperature ?? config.temperature ?? 0.3;
+    switch (config.backend) {
+        case 'claude': {
+            if (getClaudeMode() === 'ws') {
+                const transport = await ClaudeWSTransport.getInstance();
+                return transport.send(prompt, { model: config.model, timeout });
+            }
+            return runClaudeCLI(prompt, config.model, timeout);
+        }
+        case 'api':
+            return callApiLLM(prompt, config.endpoint, config.model, timeout, maxTokens, temperature, config.apiKey);
+        default:
+            throw new ConfigError(`Unknown LLM backend: ${config.backend}`);
+    }
+}
+/**
+ * Call LLM with fallback chain.
+ * Tries configured backend first, then fallback.
+ */
+export async function callLLMWithFallback(prompt, options = {}, preferredBackend) {
+    const config = getLLMConfig();
+    const backends = ['api', 'claude'];
+    const preferred = preferredBackend || config.backend;
+    const orderedBackends = [preferred, ...backends.filter((b) => b !== preferred)];
+    let lastError = null;
+    for (const backend of orderedBackends) {
+        try {
+            return await callLLM(prompt, options, { backend });
+        }
+        catch (err) {
+            lastError = err;
+            logWarn('llm', `Backend '${backend}' failed: ${lastError.message}`);
+        }
+    }
+    throw lastError || new Error('All LLM backends failed');
+}
+/**
+ * Call LLM with multi-turn chat messages
+ */
+export async function callLLMChat(messages, options = {}, configOverride) {
+    let baseConfig;
+    if (options.useChatLLM !== false) {
+        baseConfig = getChatLLMConfig();
+    }
+    else if (options.useSleepAgent) {
+        const sleepAgentConfig = getSleepAgentConfig();
+        baseConfig = sleepAgentConfig || getLLMConfig();
+    }
+    else {
+        baseConfig = getLLMConfig();
+    }
+    const config = { ...baseConfig, ...configOverride };
+    const timeout = options.timeout || 60000;
+    const maxTokens = options.maxTokens || config.maxTokens || 4000;
+    const temperature = options.temperature ?? config.temperature ?? 0.7;
+    switch (config.backend) {
+        case 'claude': {
+            if (getClaudeMode() === 'ws') {
+                const transport = await ClaudeWSTransport.getInstance();
+                return transport.sendChat(messages, { model: config.model, timeout });
+            }
+            // Process mode — CLI doesn't support multi-turn, concatenate messages
+            const prompt = messages
+                .map((m) => m.role === 'system'
+                ? `System: ${m.content}`
+                : m.role === 'user'
+                    ? `User: ${m.content}`
+                    : `Assistant: ${m.content}`)
+                .join('\n\n');
+            return runClaudeCLI(prompt, config.model, timeout);
+        }
+        case 'api':
+            return callApiLLMChat(messages, config.endpoint, config.model, timeout, maxTokens, temperature, config.apiKey);
+        default:
+            throw new ConfigError(`Unknown LLM backend: ${config.backend}`);
+    }
+}
+function buildClaudeArgs(options) {
+    const model = options?.model ?? 'haiku';
+    const args = ['-p', '--no-session-persistence', '--model', model];
+    if (options?.tools !== undefined) {
+        args.push('--tools', options.tools);
+    }
+    return args;
+}
+// Remove CLAUDECODE to allow spawning inside a Claude Code session
+const CLAUDE_SPAWN_ENV = (() => {
+    const env = { ...process.env, SUCC_SERVICE_SESSION: '1' };
+    delete env.CLAUDECODE;
+    return env;
+})();
+const CLAUDE_SPAWN_OPTIONS = {
+    env: CLAUDE_SPAWN_ENV,
+    windowsHide: true,
+};
+/**
+ * Spawn Claude CLI asynchronously and return stdout.
+ * When transport is 'ws', routes through persistent WebSocket transport.
+ */
+export async function spawnClaudeCLI(prompt, options) {
+    if (getClaudeMode() === 'ws') {
+        const transport = await ClaudeWSTransport.getInstance();
+        return transport.send(prompt, {
+            model: options?.model,
+            timeout: options?.timeout,
+        });
+    }
+    const timeout = options?.timeout ?? 60000;
+    const args = buildClaudeArgs(options);
+    return new Promise((resolve, reject) => {
+        const proc = spawn('claude', args, {
+            stdio: ['pipe', 'pipe', 'pipe'],
+            ...CLAUDE_SPAWN_OPTIONS,
+        });
+        if (proc.pid)
+            processRegistry.register(proc.pid, 'claude-cli');
+        proc.stdin?.write(prompt);
+        proc.stdin?.end();
+        let stdout = '';
+        let stderr = '';
+        proc.stdout?.on('data', (data) => {
+            stdout += data.toString();
+        });
+        proc.stderr?.on('data', (data) => {
+            stderr += data.toString();
+        });
+        const timer = setTimeout(() => {
+            proc.kill();
+            reject(new NetworkError('Claude CLI timeout'));
+        }, timeout);
+        proc.on('close', (code) => {
+            clearTimeout(timer);
+            if (proc.pid)
+                processRegistry.unregister(proc.pid);
+            if (code === 0) {
+                resolve(stdout.trim());
+            }
+            else {
+                reject(new NetworkError(`Claude CLI failed: ${stderr || 'unknown error'}`));
+            }
+        });
+        proc.on('error', (err) => {
+            clearTimeout(timer);
+            if (proc.pid)
+                processRegistry.unregister(proc.pid);
+            reject(err);
+        });
+    });
+}
+/**
+ * Spawn Claude CLI synchronously and return stdout.
+ */
+export function spawnClaudeCLISync(prompt, options) {
+    const timeout = options?.timeout ?? 60000;
+    const args = buildClaudeArgs(options);
+    const result = crossSpawnSync('claude', args, {
+        input: prompt,
+        encoding: 'utf-8',
+        timeout,
+        ...CLAUDE_SPAWN_OPTIONS,
+    });
+    if (result.error) {
+        throw new NetworkError(`Claude CLI error: ${result.error.message}`);
+    }
+    if (result.status !== 0) {
+        throw new NetworkError(`Claude CLI failed: ${result.stderr || 'unknown error'}`);
+    }
+    return (result.stdout ?? '').trim();
+}
+/** Internal wrapper used by callLLM() */
+function runClaudeCLI(prompt, model, timeout) {
+    return spawnClaudeCLI(prompt, { model, timeout });
+}
+/**
+ * Call any OpenAI-compatible API (single prompt)
+ */
+async function callApiLLM(prompt, endpoint, model, timeout, maxTokens, temperature, apiKey) {
+    const response = await fetch(endpoint, {
+        method: 'POST',
+        headers: buildApiHeaders(endpoint, apiKey),
+        body: JSON.stringify({
+            model,
+            messages: [{ role: 'user', content: prompt }],
+            temperature,
+            max_tokens: maxTokens,
+        }),
+        signal: AbortSignal.timeout(timeout),
+    });
+    if (!response.ok) {
+        const errorBody = await response.text().catch(() => '');
+        logError('llm', `API error ${response.status}: ${errorBody}`);
+        throw new NetworkError(`LLM API error: ${response.status} ${response.statusText}`, response.status);
+    }
+    const data = (await response.json());
+    if (!data.choices || data.choices.length === 0) {
+        throw new NetworkError('LLM API returned no choices');
+    }
+    return data.choices[0].message.content;
+}
+/**
+ * Call any OpenAI-compatible API with multi-turn messages
+ */
+async function callApiLLMChat(messages, endpoint, model, timeout, maxTokens, temperature, apiKey) {
+    const response = await fetch(endpoint, {
+        method: 'POST',
+        headers: buildApiHeaders(endpoint, apiKey),
+        body: JSON.stringify({
+            model,
+            messages,
+            temperature,
+            max_tokens: maxTokens,
+        }),
+        signal: AbortSignal.timeout(timeout),
+    });
+    if (!response.ok) {
+        const errorBody = await response.text().catch(() => '');
+        logError('llm', `API chat error ${response.status}: ${errorBody}`);
+        throw new NetworkError(`LLM API error: ${response.status} ${response.statusText}`, response.status);
+    }
+    const data = (await response.json());
+    if (!data.choices || data.choices.length === 0) {
+        throw new NetworkError('LLM API returned no choices');
+    }
+    return data.choices[0].message.content;
+}
+/**
+ * Call search API (Perplexity Sonar via OpenRouter) and return full response with citations.
+ * Uses llm.api_key for authentication.
+ */
+export async function callOpenRouterSearch(messages, model, timeout, maxTokens, temperature) {
+    const apiKey = getApiKey();
+    if (!apiKey) {
+        throw new ConfigError('API key not set. Configure via llm.api_key or OPENROUTER_API_KEY env var.');
+    }
+    const endpoint = 'https://openrouter.ai/api/v1/chat/completions';
+    const response = await fetch(endpoint, {
+        method: 'POST',
+        headers: buildApiHeaders(endpoint, apiKey),
+        body: JSON.stringify({
+            model,
+            messages,
+            temperature,
+            max_tokens: maxTokens,
+        }),
+        signal: AbortSignal.timeout(timeout),
+    });
+    if (!response.ok) {
+        const errorBody = await response.text();
+        logError('llm', `Search API error ${response.status}: ${errorBody}`);
+        throw new NetworkError(`Search API error: ${response.status} ${response.statusText}`, response.status);
+    }
+    const data = (await response.json());
+    if (!data.choices || data.choices.length === 0) {
+        throw new NetworkError('Search API returned no choices');
+    }
+    return {
+        content: data.choices[0].message.content,
+        citations: data.citations,
+        search_results: data.search_results,
+        usage: data.usage,
+        reasoning: data.choices[0].message.reasoning,
+    };
+}
+// ============================================================================
+// Utility Functions
+// ============================================================================
+/**
+ * Check if API endpoint is available
+ */
+export async function isLocalLLMAvailable() {
+    const apiUrl = getApiUrl();
+    try {
+        const response = await fetch(apiUrl + '/models', {
+            signal: AbortSignal.timeout(2000),
+        });
+        return response.ok;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if an API key is configured (for web search, etc.)
+ */
+export function isApiConfigured() {
+    return !!getApiKey();
+}
+/**
+ * Get available backends
+ */
+export async function getAvailableBackends() {
+    const available = ['claude']; // Always available if Claude Code is installed
+    if (await isLocalLLMAvailable()) {
+        available.unshift('api'); // Prefer api (local endpoint)
+    }
+    if (getApiKey()) {
+        // If we have an API key but no local endpoint, still add 'api'
+        if (!available.includes('api')) {
+            available.push('api');
+        }
+    }
+    return available;
+}
+//# sourceMappingURL=llm.js.map

package/dist/lib/llm.js.map

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

package/dist/lib/lock.d.ts

@@ -0,0 +1,27 @@
+interface LockInfo {
+    pid: number;
+    timestamp: number;
+    operation: string;
+}
+/**
+ * Acquire a lock for database/file operations
+ * Returns a release function to call when done
+ */
+export declare function acquireLock(operation: string): Promise<() => void>;
+/**
+ * Execute a function with lock protection
+ */
+export declare function withLock<T>(operation: string, fn: () => Promise<T>): Promise<T>;
+/**
+ * Check if lock is currently held (for status display)
+ */
+export declare function getLockStatus(): {
+    locked: boolean;
+    info?: LockInfo;
+};
+/**
+ * Force release lock (for admin/recovery)
+ */
+export declare function forceReleaseLock(): boolean;
+export {};
+//# sourceMappingURL=lock.d.ts.map

package/dist/lib/lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/lib/lock.ts"],"names":[],"mappings":"AAUA,UAAU,QAAQ;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAsCD;;;GAGG;AACH,wBAAsB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CA4DxE;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAOrF;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,QAAQ,CAAA;CAAE,CAkBpE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAS1C"}

package/dist/lib/lock.js

@@ -0,0 +1,143 @@
+import fs from 'fs';
+import path from 'path';
+import { getClaudeDir } from './config.js';
+import { StorageError } from './errors.js';
+const LOCK_FILE = 'succ.lock';
+const LOCK_TIMEOUT_MS = 30000; // 30 seconds max lock hold time
+const LOCK_RETRY_MS = 100; // Retry every 100ms
+const LOCK_MAX_RETRIES = 300; // 30 seconds total wait time
+/**
+ * Get the lock file path
+ */
+function getLockPath() {
+    return path.join(getClaudeDir(), LOCK_FILE);
+}
+/**
+ * Check if a process is still running
+ */
+function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if lock is stale (process dead or timeout exceeded)
+ */
+function isLockStale(lockInfo) {
+    // Process is dead
+    if (!isProcessAlive(lockInfo.pid)) {
+        return true;
+    }
+    // Lock held too long (timeout)
+    if (Date.now() - lockInfo.timestamp > LOCK_TIMEOUT_MS) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Acquire a lock for database/file operations
+ * Returns a release function to call when done
+ */
+export async function acquireLock(operation) {
+    const lockPath = getLockPath();
+    const lockInfo = {
+        pid: process.pid,
+        timestamp: Date.now(),
+        operation,
+    };
+    let retries = 0;
+    while (retries < LOCK_MAX_RETRIES) {
+        try {
+            // Check if lock exists
+            if (fs.existsSync(lockPath)) {
+                const existingLock = JSON.parse(fs.readFileSync(lockPath, 'utf-8'));
+                // If lock is stale, remove it
+                if (isLockStale(existingLock)) {
+                    fs.unlinkSync(lockPath);
+                }
+                else {
+                    // Lock is held by another process, wait and retry
+                    retries++;
+                    await new Promise((resolve) => setTimeout(resolve, LOCK_RETRY_MS));
+                    continue;
+                }
+            }
+            // Try to create lock file atomically
+            // Using 'wx' flag - exclusive create, fails if file exists
+            fs.writeFileSync(lockPath, JSON.stringify(lockInfo), { flag: 'wx' });
+            // Lock acquired! Return release function
+            return () => {
+                try {
+                    // Only remove if it's our lock
+                    if (fs.existsSync(lockPath)) {
+                        const currentLock = JSON.parse(fs.readFileSync(lockPath, 'utf-8'));
+                        if (currentLock.pid === process.pid) {
+                            fs.unlinkSync(lockPath);
+                        }
+                    }
+                }
+                catch {
+                    // Ignore errors during release
+                }
+            };
+        }
+        catch (err) {
+            const error = err;
+            // EEXIST means another process created the lock between our check and write
+            if (error.code === 'EEXIST') {
+                retries++;
+                await new Promise((resolve) => setTimeout(resolve, LOCK_RETRY_MS));
+                continue;
+            }
+            throw err;
+        }
+    }
+    throw new StorageError(`Could not acquire lock for ${operation} after ${(LOCK_MAX_RETRIES * LOCK_RETRY_MS) / 1000}s`);
+}
+/**
+ * Execute a function with lock protection
+ */
+export async function withLock(operation, fn) {
+    const release = await acquireLock(operation);
+    try {
+        return await fn();
+    }
+    finally {
+        release();
+    }
+}
+/**
+ * Check if lock is currently held (for status display)
+ */
+export function getLockStatus() {
+    const lockPath = getLockPath();
+    if (!fs.existsSync(lockPath)) {
+        return { locked: false };
+    }
+    try {
+        const lockInfo = JSON.parse(fs.readFileSync(lockPath, 'utf-8'));
+        if (isLockStale(lockInfo)) {
+            return { locked: false, info: lockInfo };
+        }
+        return { locked: true, info: lockInfo };
+    }
+    catch {
+        return { locked: false };
+    }
+}
+/**
+ * Force release lock (for admin/recovery)
+ */
+export function forceReleaseLock() {
+    const lockPath = getLockPath();
+    if (fs.existsSync(lockPath)) {
+        fs.unlinkSync(lockPath);
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=lock.js.map

package/dist/lib/lock.js.map

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