clodds 1.1.0

package/dist/process/index.js

@@ -0,0 +1,402 @@
+"use strict";
+/**
+ * Process Module - Clawdbot-style process management
+ *
+ * Features:
+ * - Spawn and manage child processes
+ * - Process pools
+ * - Signal handling
+ * - Output streaming
+ * - Timeout management
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.execute = execute;
+exports.executeSync = executeSync;
+exports.spawnProcess = spawnProcess;
+exports.spawnCommand = spawnCommand;
+exports.createProcessPool = createProcessPool;
+exports.onSignal = onSignal;
+exports.onShutdown = onShutdown;
+exports.commandExists = commandExists;
+exports.getProcessInfo = getProcessInfo;
+exports.killTree = killTree;
+const child_process_1 = require("child_process");
+const events_1 = require("events");
+const logger_1 = require("../utils/logger");
+// =============================================================================
+// CONSTANTS
+// =============================================================================
+const DEFAULT_TIMEOUT = 30000;
+const DEFAULT_MAX_BUFFER = 10 * 1024 * 1024; // 10MB
+const DEFAULT_KILL_SIGNAL = 'SIGTERM';
+// =============================================================================
+// HELPERS
+// =============================================================================
+function parseCommand(command) {
+    // Simple shell-style parsing
+    const parts = [];
+    let current = '';
+    let inQuote = false;
+    let quoteChar = '';
+    for (const char of command) {
+        if (inQuote) {
+            if (char === quoteChar) {
+                inQuote = false;
+            }
+            else {
+                current += char;
+            }
+        }
+        else if (char === '"' || char === "'") {
+            inQuote = true;
+            quoteChar = char;
+        }
+        else if (char === ' ' || char === '\t') {
+            if (current) {
+                parts.push(current);
+                current = '';
+            }
+        }
+        else {
+            current += char;
+        }
+    }
+    if (current) {
+        parts.push(current);
+    }
+    return {
+        cmd: parts[0] || '',
+        args: parts.slice(1),
+    };
+}
+// =============================================================================
+// PROCESS EXECUTION
+// =============================================================================
+/** Execute a command and wait for result */
+async function execute(command, options = {}) {
+    const startTime = Date.now();
+    const timeout = options.timeout ?? DEFAULT_TIMEOUT;
+    const maxBuffer = options.maxBuffer ?? DEFAULT_MAX_BUFFER;
+    const killSignal = options.killSignal ?? DEFAULT_KILL_SIGNAL;
+    return new Promise((resolve) => {
+        let timedOut = false;
+        let killed = false;
+        const execOptions = {
+            cwd: options.cwd,
+            env: { ...process.env, ...options.env },
+            timeout,
+            maxBuffer,
+            shell: typeof options.shell === 'string' ? options.shell : undefined,
+            uid: options.uid,
+            gid: options.gid,
+            killSignal,
+        };
+        const child = (0, child_process_1.exec)(command, execOptions, (error, stdout, stderr) => {
+            const duration = Date.now() - startTime;
+            if (error && 'killed' in error) {
+                killed = error.killed ?? false;
+                timedOut = (error.killed ?? false) && error.signal === killSignal;
+            }
+            resolve({
+                exitCode: error ? error.code ? null : 1 : 0,
+                signal: error?.signal || null,
+                stdout: stdout.toString(),
+                stderr: stderr.toString(),
+                duration,
+                killed,
+                timedOut,
+            });
+        });
+        logger_1.logger.debug({ command: command.slice(0, 100), pid: child.pid }, 'Process started');
+    });
+}
+/** Execute a command synchronously */
+function executeSync(command, options = {}) {
+    const startTime = Date.now();
+    try {
+        const shellOption = typeof options.shell === 'string'
+            ? options.shell
+            : (options.shell !== false ? '/bin/sh' : undefined);
+        const stdout = (0, child_process_1.execSync)(command, {
+            cwd: options.cwd,
+            env: { ...process.env, ...options.env },
+            timeout: options.timeout ?? DEFAULT_TIMEOUT,
+            maxBuffer: options.maxBuffer ?? DEFAULT_MAX_BUFFER,
+            shell: shellOption,
+            uid: options.uid,
+            gid: options.gid,
+            encoding: 'utf-8',
+        });
+        return {
+            exitCode: 0,
+            signal: null,
+            stdout: stdout.toString(),
+            stderr: '',
+            duration: Date.now() - startTime,
+            killed: false,
+            timedOut: false,
+        };
+    }
+    catch (error) {
+        const err = error;
+        return {
+            exitCode: err.status ?? 1,
+            signal: err.signal || null,
+            stdout: err.stdout?.toString() || '',
+            stderr: err.stderr?.toString() || '',
+            duration: Date.now() - startTime,
+            killed: err.killed || false,
+            timedOut: false,
+        };
+    }
+}
+/** Spawn a process with streaming output */
+function spawnProcess(command, args = [], options = {}) {
+    const emitter = new events_1.EventEmitter();
+    const startTime = Date.now();
+    const spawnOptions = {
+        cwd: options.cwd,
+        env: { ...process.env, ...options.env },
+        shell: options.shell,
+        uid: options.uid,
+        gid: options.gid,
+        detached: options.detached,
+        stdio: ['pipe', 'pipe', 'pipe'],
+    };
+    const child = (0, child_process_1.spawn)(command, args, spawnOptions);
+    let stdout = '';
+    let stderr = '';
+    let killed = false;
+    let timedOut = false;
+    // Timeout handling
+    let timeoutId;
+    if (options.timeout) {
+        timeoutId = setTimeout(() => {
+            timedOut = true;
+            child.kill(options.killSignal ?? DEFAULT_KILL_SIGNAL);
+        }, options.timeout);
+    }
+    // Stream stdout
+    child.stdout?.on('data', (data) => {
+        const str = data.toString();
+        stdout += str;
+        emitter.emit('stdout', str);
+    });
+    // Stream stderr
+    child.stderr?.on('data', (data) => {
+        const str = data.toString();
+        stderr += str;
+        emitter.emit('stderr', str);
+    });
+    // Handle exit
+    child.on('exit', (code, signal) => {
+        if (timeoutId)
+            clearTimeout(timeoutId);
+        emitter.emit('exit', code, signal);
+    });
+    child.on('error', (error) => {
+        if (timeoutId)
+            clearTimeout(timeoutId);
+        emitter.emit('error', error);
+    });
+    // Expose child process properties
+    emitter.pid = child.pid;
+    emitter.stdin = child.stdin;
+    emitter.stdout = child.stdout;
+    emitter.stderr = child.stderr;
+    emitter.kill = (signal = DEFAULT_KILL_SIGNAL) => {
+        killed = true;
+        return child.kill(signal);
+    };
+    emitter.wait = () => new Promise((resolve) => {
+        child.on('exit', (code, signal) => {
+            resolve({
+                exitCode: code,
+                signal,
+                stdout,
+                stderr,
+                duration: Date.now() - startTime,
+                killed,
+                timedOut,
+            });
+        });
+        child.on('error', (error) => {
+            resolve({
+                exitCode: 1,
+                signal: null,
+                stdout,
+                stderr: stderr + '\n' + error.message,
+                duration: Date.now() - startTime,
+                killed,
+                timedOut,
+            });
+        });
+    });
+    logger_1.logger.debug({ command, args, pid: child.pid }, 'Process spawned');
+    return emitter;
+}
+/** Spawn from a command string */
+function spawnCommand(command, options = {}) {
+    if (options.shell !== false) {
+        // Use shell to parse the command
+        return spawnProcess(process.platform === 'win32' ? 'cmd' : '/bin/sh', process.platform === 'win32' ? ['/c', command] : ['-c', command], { ...options, shell: false });
+    }
+    const { cmd, args } = parseCommand(command);
+    return spawnProcess(cmd, args, options);
+}
+function createProcessPool(poolOptions = {}) {
+    const maxConcurrent = poolOptions.maxConcurrent ?? 10;
+    const idleTimeout = poolOptions.idleTimeout ?? 60000;
+    let activeCount = 0;
+    const queue = [];
+    function processQueue() {
+        while (queue.length > 0 && activeCount < maxConcurrent) {
+            const item = queue.shift();
+            activeCount++;
+            const proc = spawnProcess(item.command, item.args, item.options);
+            proc.on('exit', () => {
+                activeCount--;
+                processQueue();
+            });
+            item.resolve(proc);
+        }
+    }
+    return {
+        async execute(command, options = {}) {
+            const proc = await new Promise((resolve) => {
+                const { cmd, args } = parseCommand(command);
+                if (activeCount < maxConcurrent) {
+                    activeCount++;
+                    const p = spawnProcess(cmd, args, options);
+                    p.on('exit', () => {
+                        activeCount--;
+                        processQueue();
+                    });
+                    resolve(p);
+                }
+                else {
+                    queue.push({ resolve, command: cmd, args, options });
+                }
+            });
+            return proc.wait();
+        },
+        spawn(command, args = [], options = {}) {
+            if (activeCount >= maxConcurrent) {
+                throw new Error('Process pool at capacity');
+            }
+            activeCount++;
+            const proc = spawnProcess(command, args, options);
+            proc.on('exit', () => {
+                activeCount--;
+                processQueue();
+            });
+            return proc;
+        },
+        getStats() {
+            return {
+                active: activeCount,
+                idle: maxConcurrent - activeCount,
+                total: maxConcurrent,
+            };
+        },
+        async shutdown() {
+            // Clear queue
+            queue.length = 0;
+            // Wait for active processes (they'll be orphaned)
+            logger_1.logger.info({ active: activeCount }, 'Process pool shutdown');
+        },
+    };
+}
+const signalHandlers = new Map();
+let signalHandlersInstalled = false;
+function installSignalHandlers() {
+    if (signalHandlersInstalled)
+        return;
+    signalHandlersInstalled = true;
+    const signals = ['SIGINT', 'SIGTERM', 'SIGHUP'];
+    for (const signal of signals) {
+        process.on(signal, async () => {
+            const handlers = signalHandlers.get(signal) || [];
+            logger_1.logger.info({ signal, handlers: handlers.length }, 'Signal received');
+            for (const handler of handlers) {
+                try {
+                    await handler();
+                }
+                catch (error) {
+                    logger_1.logger.error({ signal, error }, 'Signal handler error');
+                }
+            }
+            // Re-raise signal for default handling
+            process.kill(process.pid, signal);
+        });
+    }
+}
+/** Register a signal handler */
+function onSignal(signal, handler) {
+    installSignalHandlers();
+    const handlers = signalHandlers.get(signal) || [];
+    handlers.push(handler);
+    signalHandlers.set(signal, handlers);
+    // Return unsubscribe function
+    return () => {
+        const handlers = signalHandlers.get(signal) || [];
+        const idx = handlers.indexOf(handler);
+        if (idx >= 0)
+            handlers.splice(idx, 1);
+    };
+}
+/** Register cleanup handler for graceful shutdown */
+function onShutdown(handler) {
+    const unsub1 = onSignal('SIGINT', handler);
+    const unsub2 = onSignal('SIGTERM', handler);
+    return () => {
+        unsub1();
+        unsub2();
+    };
+}
+// =============================================================================
+// UTILITIES
+// =============================================================================
+/** Check if a command exists */
+function commandExists(command) {
+    try {
+        // Use execFileSync with array args to prevent command injection
+        (0, child_process_1.execFileSync)('which', [command], { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Get current process info */
+function getProcessInfo() {
+    return {
+        pid: process.pid,
+        ppid: process.ppid,
+        uid: process.getuid?.() ?? 0,
+        gid: process.getgid?.() ?? 0,
+        cwd: process.cwd(),
+        memory: process.memoryUsage(),
+        uptime: process.uptime(),
+    };
+}
+/** Kill a process tree */
+function killTree(pid, signal = 'SIGTERM') {
+    try {
+        if (process.platform === 'win32') {
+            (0, child_process_1.execSync)(`taskkill /PID ${pid} /T /F`, { stdio: 'ignore' });
+        }
+        else {
+            // Kill process group
+            process.kill(-pid, signal);
+        }
+    }
+    catch {
+        // Process might already be dead
+        try {
+            process.kill(pid, signal);
+        }
+        catch { }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/process/index.js.map

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

package/dist/providers/discovery.d.ts

@@ -0,0 +1,209 @@
+/**
+ * Provider Discovery & Enhanced Management
+ *
+ * Features:
+ * - Model discovery (auto-detect available models)
+ * - Auth profile management
+ * - Usage tracking & analytics
+ * - Additional providers (Bedrock, Groq, Together, etc.)
+ * - Cache tracing & diagnostics
+ */
+import { Provider, Message, CompletionOptions, CompletionResult, StreamChunk } from './index';
+export interface DiscoveredModel {
+    id: string;
+    name: string;
+    provider: string;
+    contextWindow?: number;
+    maxOutput?: number;
+    inputCostPer1k?: number;
+    outputCostPer1k?: number;
+    capabilities?: string[];
+}
+export interface ModelRegistry {
+    /** Discover models from a provider */
+    discover(provider: Provider): Promise<DiscoveredModel[]>;
+    /** Get all discovered models */
+    getAll(): DiscoveredModel[];
+    /** Get models by provider */
+    getByProvider(providerName: string): DiscoveredModel[];
+    /** Find model by ID */
+    find(modelId: string): DiscoveredModel | undefined;
+    /** Refresh all models */
+    refresh(): Promise<void>;
+}
+/**
+ * Create a model registry
+ */
+export declare function createModelRegistry(providers: Map<string, Provider>): ModelRegistry;
+export interface AuthProfile {
+    name: string;
+    provider: string;
+    apiKey: string;
+    baseUrl?: string;
+    organization?: string;
+    region?: string;
+    accessKeyId?: string;
+    secretAccessKey?: string;
+    metadata?: Record<string, string>;
+}
+export interface AuthProfileManager {
+    /** Add or update a profile */
+    set(profile: AuthProfile): void;
+    /** Get a profile by name */
+    get(name: string): AuthProfile | undefined;
+    /** Get all profiles */
+    list(): AuthProfile[];
+    /** Get profiles by provider */
+    listByProvider(provider: string): AuthProfile[];
+    /** Delete a profile */
+    delete(name: string): boolean;
+    /** Save profiles to disk */
+    save(): void;
+    /** Load profiles from disk */
+    load(): void;
+}
+/**
+ * Create an auth profile manager
+ */
+export declare function createAuthProfileManager(): AuthProfileManager;
+export interface UsageRecord {
+    timestamp: Date;
+    provider: string;
+    model: string;
+    inputTokens: number;
+    outputTokens: number;
+    cost: number;
+    latency: number;
+    sessionId?: string;
+    userId?: string;
+}
+export interface UsageStats {
+    totalRequests: number;
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    totalCost: number;
+    avgLatency: number;
+    byProvider: Record<string, {
+        requests: number;
+        tokens: number;
+        cost: number;
+    }>;
+    byModel: Record<string, {
+        requests: number;
+        tokens: number;
+        cost: number;
+    }>;
+}
+export interface UsageTracker {
+    /** Record a completion */
+    record(result: CompletionResult, provider: string, sessionId?: string, userId?: string): void;
+    /** Get usage stats for time period */
+    getStats(since?: Date): UsageStats;
+    /** Get usage by session */
+    getBySession(sessionId: string): UsageRecord[];
+    /** Get usage by user */
+    getByUser(userId: string): UsageRecord[];
+    /** Get recent records */
+    getRecent(limit?: number): UsageRecord[];
+    /** Export usage data */
+    export(): UsageRecord[];
+    /** Clear old records */
+    cleanup(olderThan: Date): number;
+}
+/**
+ * Create a usage tracker
+ */
+export declare function createUsageTracker(): UsageTracker;
+/**
+ * Groq Provider (fast inference)
+ */
+export declare class GroqProvider implements Provider {
+    name: string;
+    private apiKey;
+    private baseUrl;
+    private defaultModel;
+    constructor(apiKey: string);
+    complete(messages: Message[], options?: CompletionOptions): Promise<CompletionResult>;
+    stream(messages: Message[], options?: CompletionOptions): AsyncIterable<StreamChunk>;
+    listModels(): Promise<string[]>;
+    isAvailable(): Promise<boolean>;
+}
+/**
+ * Together AI Provider
+ */
+export declare class TogetherProvider implements Provider {
+    name: string;
+    private apiKey;
+    private baseUrl;
+    private defaultModel;
+    constructor(apiKey: string);
+    complete(messages: Message[], options?: CompletionOptions): Promise<CompletionResult>;
+    stream(messages: Message[], options?: CompletionOptions): AsyncIterable<StreamChunk>;
+    listModels(): Promise<string[]>;
+    isAvailable(): Promise<boolean>;
+}
+/**
+ * Fireworks AI Provider
+ */
+export declare class FireworksProvider implements Provider {
+    name: string;
+    private apiKey;
+    private baseUrl;
+    private defaultModel;
+    constructor(apiKey: string);
+    complete(messages: Message[], options?: CompletionOptions): Promise<CompletionResult>;
+    stream(messages: Message[], options?: CompletionOptions): AsyncIterable<StreamChunk>;
+    listModels(): Promise<string[]>;
+    isAvailable(): Promise<boolean>;
+}
+export interface CacheEntry {
+    key: string;
+    result: CompletionResult;
+    timestamp: Date;
+    hits: number;
+}
+export interface CacheStats {
+    totalEntries: number;
+    totalHits: number;
+    totalMisses: number;
+    hitRate: number;
+    savedTokens: number;
+    savedCost: number;
+}
+export interface ResponseCache {
+    /** Get cached result */
+    get(key: string): CompletionResult | undefined;
+    /** Set cached result */
+    set(key: string, result: CompletionResult): void;
+    /** Generate cache key */
+    generateKey(messages: Message[], options: CompletionOptions): string;
+    /** Get cache stats */
+    getStats(): CacheStats;
+    /** Clear cache */
+    clear(): void;
+}
+/**
+ * Create a response cache
+ */
+export declare function createResponseCache(maxSize?: number, ttlMs?: number): ResponseCache;
+export interface DiagnosticInfo {
+    provider: string;
+    available: boolean;
+    latency?: number;
+    lastError?: string;
+    models?: string[];
+}
+/**
+ * Run diagnostics on providers
+ */
+export declare function runDiagnostics(providers: Map<string, Provider>): Promise<DiagnosticInfo[]>;
+export declare const discovery: {
+    createModelRegistry: typeof createModelRegistry;
+    createAuthProfileManager: typeof createAuthProfileManager;
+    createUsageTracker: typeof createUsageTracker;
+    createResponseCache: typeof createResponseCache;
+    runDiagnostics: typeof runDiagnostics;
+    GroqProvider: typeof GroqProvider;
+    TogetherProvider: typeof TogetherProvider;
+    FireworksProvider: typeof FireworksProvider;
+};