clodds 1.1.0

package/dist/extensions/llm-task/index.js

@@ -0,0 +1,248 @@
+"use strict";
+/**
+ * LLM Task Runner Extension
+ * Provides background task execution with LLM agents
+ *
+ * Supports: Task queuing, parallel execution, progress tracking
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLLMTaskExtension = createLLMTaskExtension;
+const logger_1 = require("../../utils/logger");
+const id_1 = require("../../utils/id");
+async function createLLMTaskExtension(config) {
+    const maxConcurrent = config.maxConcurrent || 3;
+    const taskTimeoutMs = config.taskTimeoutMs || 300000; // 5 minutes
+    const maxRetries = config.maxRetries || 3;
+    const tasks = new Map();
+    const pendingQueue = [];
+    const runningTasks = new Set();
+    const taskWaiters = new Map();
+    let executor = null;
+    let processingInterval = null;
+    let isRunning = false;
+    function generateId() {
+        return (0, id_1.generateId)('task');
+    }
+    async function processTask(taskId) {
+        const task = tasks.get(taskId);
+        if (!task || !executor)
+            return;
+        task.status = 'running';
+        task.startedAt = Date.now();
+        task.attempts++;
+        runningTasks.add(taskId);
+        logger_1.logger.info({ taskId, name: task.name, attempt: task.attempts }, 'Starting task');
+        try {
+            // Set up timeout
+            const timeoutPromise = new Promise((resolve) => {
+                setTimeout(() => resolve({ error: 'Task timed out' }), taskTimeoutMs);
+            });
+            const executionPromise = executor(task);
+            const result = await Promise.race([executionPromise, timeoutPromise]);
+            if (result.error) {
+                throw new Error(result.error);
+            }
+            task.status = 'completed';
+            task.result = 'result' in result ? result.result : undefined;
+            task.completedAt = Date.now();
+            task.progress = 100;
+            logger_1.logger.info({ taskId, name: task.name, duration: task.completedAt - (task.startedAt || 0) }, 'Task completed');
+            // Notify waiters
+            notifyWaiters(taskId, {
+                taskId,
+                success: true,
+                result: 'result' in result ? result.result : undefined,
+                duration: task.completedAt - (task.startedAt || 0),
+            });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            if (config.retryOnFailure && task.attempts < maxRetries) {
+                logger_1.logger.warn({ taskId, attempt: task.attempts, maxRetries }, 'Task failed, will retry');
+                task.status = 'pending';
+                pendingQueue.push(taskId);
+            }
+            else {
+                task.status = 'failed';
+                task.error = errorMessage;
+                task.completedAt = Date.now();
+                logger_1.logger.error({ taskId, name: task.name, error: errorMessage }, 'Task failed');
+                notifyWaiters(taskId, {
+                    taskId,
+                    success: false,
+                    error: errorMessage,
+                    duration: task.completedAt - (task.startedAt || 0),
+                });
+            }
+        }
+        finally {
+            runningTasks.delete(taskId);
+        }
+    }
+    function notifyWaiters(taskId, result) {
+        const waiters = taskWaiters.get(taskId);
+        if (waiters) {
+            for (const resolve of waiters) {
+                resolve(result);
+            }
+            taskWaiters.delete(taskId);
+        }
+    }
+    function processQueue() {
+        if (!isRunning || !executor)
+            return;
+        while (runningTasks.size < maxConcurrent && pendingQueue.length > 0) {
+            const taskId = pendingQueue.shift();
+            if (taskId && tasks.has(taskId)) {
+                processTask(taskId).catch((error) => {
+                    logger_1.logger.error({ error, taskId }, 'Unexpected error processing task');
+                });
+            }
+        }
+    }
+    const extension = {
+        async createTask(name, prompt, metadata) {
+            const id = generateId();
+            const task = {
+                id,
+                name,
+                prompt,
+                status: 'pending',
+                progress: 0,
+                metadata: metadata || {},
+                createdAt: Date.now(),
+                attempts: 0,
+            };
+            tasks.set(id, task);
+            pendingQueue.push(id);
+            logger_1.logger.info({ taskId: id, name }, 'Task created');
+            if (isRunning) {
+                processQueue();
+            }
+            return id;
+        },
+        async createSubtask(parentId, name, prompt) {
+            const parent = tasks.get(parentId);
+            if (!parent) {
+                throw new Error(`Parent task ${parentId} not found`);
+            }
+            const id = await extension.createTask(name, prompt, { parentId });
+            const task = tasks.get(id);
+            task.parentId = parentId;
+            if (!parent.subtasks) {
+                parent.subtasks = [];
+            }
+            parent.subtasks.push(id);
+            return id;
+        },
+        async getTask(taskId) {
+            return tasks.get(taskId) || null;
+        },
+        async getTasks(filter) {
+            let result = Array.from(tasks.values());
+            if (filter?.status) {
+                result = result.filter((t) => t.status === filter.status);
+            }
+            if (filter?.parentId !== undefined) {
+                result = result.filter((t) => t.parentId === filter.parentId);
+            }
+            return result.sort((a, b) => b.createdAt - a.createdAt);
+        },
+        async cancelTask(taskId) {
+            const task = tasks.get(taskId);
+            if (!task)
+                return false;
+            if (task.status === 'pending') {
+                const idx = pendingQueue.indexOf(taskId);
+                if (idx >= 0) {
+                    pendingQueue.splice(idx, 1);
+                }
+                task.status = 'cancelled';
+                task.completedAt = Date.now();
+                notifyWaiters(taskId, {
+                    taskId,
+                    success: false,
+                    error: 'Task cancelled',
+                    duration: 0,
+                });
+                return true;
+            }
+            if (task.status === 'running') {
+                // Can't truly cancel a running task, but mark it
+                task.status = 'cancelled';
+                return true;
+            }
+            return false;
+        },
+        async waitForTask(taskId, timeoutMs) {
+            const task = tasks.get(taskId);
+            if (!task) {
+                throw new Error(`Task ${taskId} not found`);
+            }
+            // If already completed
+            if (task.status === 'completed' || task.status === 'failed' || task.status === 'cancelled') {
+                return {
+                    taskId,
+                    success: task.status === 'completed',
+                    result: task.result,
+                    error: task.error || (task.status === 'cancelled' ? 'Task cancelled' : undefined),
+                    duration: (task.completedAt || 0) - (task.startedAt || task.createdAt),
+                };
+            }
+            // Wait for completion
+            return new Promise((resolve, reject) => {
+                const timeout = timeoutMs || taskTimeoutMs;
+                const timer = setTimeout(() => {
+                    const waiters = taskWaiters.get(taskId);
+                    if (waiters) {
+                        const idx = waiters.indexOf(resolve);
+                        if (idx >= 0)
+                            waiters.splice(idx, 1);
+                    }
+                    reject(new Error('Wait timeout'));
+                }, timeout);
+                const wrappedResolve = (result) => {
+                    clearTimeout(timer);
+                    resolve(result);
+                };
+                if (!taskWaiters.has(taskId)) {
+                    taskWaiters.set(taskId, []);
+                }
+                taskWaiters.get(taskId).push(wrappedResolve);
+            });
+        },
+        setExecutor(exec) {
+            executor = exec;
+        },
+        start() {
+            if (isRunning)
+                return;
+            isRunning = true;
+            processingInterval = setInterval(processQueue, 100);
+            processQueue();
+            logger_1.logger.info({ maxConcurrent }, 'LLM Task runner started');
+        },
+        stop() {
+            isRunning = false;
+            if (processingInterval) {
+                clearInterval(processingInterval);
+                processingInterval = null;
+            }
+            logger_1.logger.info('LLM Task runner stopped');
+        },
+        getStats() {
+            const allTasks = Array.from(tasks.values());
+            const completed = allTasks.filter((t) => t.status === 'completed');
+            const totalDuration = completed.reduce((sum, t) => sum + ((t.completedAt || 0) - (t.startedAt || t.createdAt)), 0);
+            return {
+                pending: pendingQueue.length,
+                running: runningTasks.size,
+                completed: completed.length,
+                failed: allTasks.filter((t) => t.status === 'failed').length,
+                avgDuration: completed.length > 0 ? totalDuration / completed.length : 0,
+            };
+        },
+    };
+    return extension;
+}
+//# sourceMappingURL=index.js.map

package/dist/extensions/llm-task/index.js.map

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

package/dist/extensions/lobster/index.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Lobster Extension
+ * Provides Lobste.rs (lobsters.rs) integration for tech news and discussions
+ *
+ * Lobste.rs is a computing-focused link aggregation site
+ */
+export interface LobsterConfig {
+    enabled: boolean;
+    /** API base URL */
+    baseUrl?: string;
+    /** User token for authenticated requests */
+    userToken?: string;
+    /** Cache duration in milliseconds */
+    cacheDurationMs?: number;
+    /** Tags to filter by */
+    defaultTags?: string[];
+}
+export interface LobsterStory {
+    id: string;
+    shortId: string;
+    title: string;
+    url?: string;
+    description?: string;
+    score: number;
+    commentCount: number;
+    tags: string[];
+    submitter: string;
+    submittedAt: Date;
+    commentsUrl: string;
+}
+export interface LobsterComment {
+    id: string;
+    shortId: string;
+    storyId: string;
+    author: string;
+    content: string;
+    score: number;
+    depth: number;
+    parentId?: string;
+    createdAt: Date;
+}
+export interface LobsterUser {
+    username: string;
+    about?: string;
+    karma: number;
+    createdAt: Date;
+    avatar?: string;
+}
+export interface LobsterExtension {
+    /** Get hottest stories */
+    getHottest(page?: number): Promise<LobsterStory[]>;
+    /** Get newest stories */
+    getNewest(page?: number): Promise<LobsterStory[]>;
+    /** Get stories by tag */
+    getByTag(tag: string, page?: number): Promise<LobsterStory[]>;
+    /** Search stories */
+    searchStories(query: string, page?: number): Promise<LobsterStory[]>;
+    /** Get story details */
+    getStory(shortId: string): Promise<LobsterStory | null>;
+    /** Get story comments */
+    getComments(storyShortId: string): Promise<LobsterComment[]>;
+    /** Get user profile */
+    getUser(username: string): Promise<LobsterUser | null>;
+    /** Get all available tags */
+    getTags(): Promise<string[]>;
+    /** Find stories relevant to prediction markets */
+    findMarketRelevant(keywords?: string[]): Promise<LobsterStory[]>;
+}
+export declare function createLobsterExtension(config: LobsterConfig): Promise<LobsterExtension>;

package/dist/extensions/lobster/index.js

@@ -0,0 +1,178 @@
+"use strict";
+/**
+ * Lobster Extension
+ * Provides Lobste.rs (lobsters.rs) integration for tech news and discussions
+ *
+ * Lobste.rs is a computing-focused link aggregation site
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLobsterExtension = createLobsterExtension;
+const logger_1 = require("../../utils/logger");
+async function createLobsterExtension(config) {
+    const baseUrl = config.baseUrl || 'https://lobste.rs';
+    const cacheDuration = config.cacheDurationMs || 300000; // 5 minutes
+    const cache = new Map();
+    async function fetchJSON(path) {
+        const url = `${baseUrl}${path}.json`;
+        const cacheKey = url;
+        // Check cache
+        const cached = cache.get(cacheKey);
+        if (cached && cached.expiresAt > Date.now()) {
+            return cached.data;
+        }
+        const headers = {
+            Accept: 'application/json',
+            'User-Agent': 'Clodds/1.0 (prediction market assistant)',
+        };
+        if (config.userToken) {
+            headers['Authorization'] = `Bearer ${config.userToken}`;
+        }
+        const response = await fetch(url, { headers });
+        if (!response.ok) {
+            throw new Error(`Lobster API error: ${response.status}`);
+        }
+        const data = (await response.json());
+        // Cache the result
+        cache.set(cacheKey, {
+            data,
+            expiresAt: Date.now() + cacheDuration,
+        });
+        return data;
+    }
+    function parseStory(raw) {
+        return {
+            id: raw.short_id || raw.id,
+            shortId: raw.short_id,
+            title: raw.title,
+            url: raw.url,
+            description: raw.description || raw.description_plain,
+            score: raw.score || 0,
+            commentCount: raw.comment_count || 0,
+            tags: raw.tags || [],
+            submitter: raw.submitter_user?.username || raw.submitter,
+            submittedAt: new Date(raw.created_at),
+            commentsUrl: raw.comments_url || `${baseUrl}/s/${raw.short_id}`,
+        };
+    }
+    function parseComment(raw) {
+        return {
+            id: raw.short_id || raw.id,
+            shortId: raw.short_id,
+            storyId: raw.story_id,
+            author: raw.commenting_user?.username || raw.user,
+            content: raw.comment_plain || raw.comment,
+            score: raw.score || 0,
+            depth: raw.indent_level || raw.depth || 0,
+            parentId: raw.parent_comment,
+            createdAt: new Date(raw.created_at),
+        };
+    }
+    const extension = {
+        async getHottest(page) {
+            const path = page && page > 1 ? `/page/${page}` : '';
+            const data = await fetchJSON(path || '/hottest');
+            return (Array.isArray(data) ? data : []).map(parseStory);
+        },
+        async getNewest(page) {
+            const path = `/newest${page && page > 1 ? `/page/${page}` : ''}`;
+            const data = await fetchJSON(path);
+            return (Array.isArray(data) ? data : []).map(parseStory);
+        },
+        async getByTag(tag, page) {
+            const path = `/t/${tag}${page && page > 1 ? `/page/${page}` : ''}`;
+            const data = await fetchJSON(path);
+            return (Array.isArray(data) ? data : []).map(parseStory);
+        },
+        async searchStories(query, page) {
+            const path = `/search?q=${encodeURIComponent(query)}${page ? `&page=${page}` : ''}`;
+            const data = await fetchJSON(path);
+            return (data.stories || []).map(parseStory);
+        },
+        async getStory(shortId) {
+            try {
+                const data = await fetchJSON(`/s/${shortId}`);
+                return parseStory(data);
+            }
+            catch (error) {
+                logger_1.logger.warn({ error, shortId }, 'Failed to get Lobster story');
+                return null;
+            }
+        },
+        async getComments(storyShortId) {
+            const data = await fetchJSON(`/s/${storyShortId}`);
+            return (data.comments || []).map(parseComment);
+        },
+        async getUser(username) {
+            try {
+                const data = await fetchJSON(`/u/${username}`);
+                return {
+                    username: data.username,
+                    about: data.about,
+                    karma: data.karma || 0,
+                    createdAt: new Date(data.created_at),
+                    avatar: data.avatar_url,
+                };
+            }
+            catch (error) {
+                logger_1.logger.warn({ error, username }, 'Failed to get Lobster user');
+                return null;
+            }
+        },
+        async getTags() {
+            const data = await fetchJSON('/tags');
+            return (data || []).map((t) => t.tag || t);
+        },
+        async findMarketRelevant(keywords) {
+            const defaultKeywords = [
+                'prediction',
+                'forecast',
+                'probability',
+                'betting',
+                'market',
+                'election',
+                'poll',
+                'crypto',
+                'bitcoin',
+                'ethereum',
+                'ai',
+                'regulation',
+                'policy',
+                'economic',
+                'finance',
+            ];
+            const searchTerms = keywords || defaultKeywords;
+            const relevantStories = [];
+            const seenIds = new Set();
+            // Get hottest stories and filter
+            const hottest = await extension.getHottest();
+            for (const story of hottest) {
+                const titleLower = story.title.toLowerCase();
+                const descLower = (story.description || '').toLowerCase();
+                const isRelevant = searchTerms.some((kw) => titleLower.includes(kw) || descLower.includes(kw) || story.tags.includes(kw));
+                if (isRelevant && !seenIds.has(story.shortId)) {
+                    seenIds.add(story.shortId);
+                    relevantStories.push(story);
+                }
+            }
+            // Also check specific tags
+            const relevantTags = ['crypto', 'finance', 'law', 'politics'];
+            for (const tag of relevantTags) {
+                try {
+                    const tagStories = await extension.getByTag(tag);
+                    for (const story of tagStories.slice(0, 5)) {
+                        if (!seenIds.has(story.shortId)) {
+                            seenIds.add(story.shortId);
+                            relevantStories.push(story);
+                        }
+                    }
+                }
+                catch {
+                    // Tag might not exist
+                }
+            }
+            return relevantStories.sort((a, b) => b.score - a.score).slice(0, 20);
+        },
+    };
+    return extension;
+}
+//# sourceMappingURL=index.js.map

package/dist/extensions/lobster/index.js.map

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

package/dist/extensions/memory-lancedb/index.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Memory LanceDB Backend Extension
+ * Provides vector storage using LanceDB for long-term memory
+ *
+ * LanceDB is a serverless vector database with native embedding support
+ */
+export interface LanceDBConfig {
+    enabled: boolean;
+    /** Database directory path */
+    dbPath?: string;
+    /** Table name for memories */
+    tableName?: string;
+    /** Embedding model to use */
+    embeddingModel?: 'openai' | 'cohere' | 'local';
+    /** OpenAI API key for embeddings */
+    openaiApiKey?: string;
+    /** Cohere API key for embeddings */
+    cohereApiKey?: string;
+    /** Local embedding model path */
+    localModelPath?: string;
+    /** Embedding dimensions */
+    dimensions?: number;
+}
+export interface MemoryEntry {
+    id: string;
+    content: string;
+    embedding?: number[];
+    metadata: Record<string, unknown>;
+    timestamp: number;
+    source: string;
+    importance: number;
+}
+export interface SearchResult {
+    entry: MemoryEntry;
+    score: number;
+    distance: number;
+}
+export interface LanceDBExtension {
+    /** Initialize the database */
+    initialize(): Promise<void>;
+    /** Add a memory entry */
+    addMemory(content: string, metadata?: Record<string, unknown>, source?: string): Promise<string>;
+    /** Search memories by vector similarity */
+    searchMemories(query: string, limit?: number, filter?: Record<string, unknown>): Promise<SearchResult[]>;
+    /** Get memory by ID */
+    getMemory(id: string): Promise<MemoryEntry | null>;
+    /** Update memory importance */
+    updateImportance(id: string, importance: number): Promise<void>;
+    /** Delete memory */
+    deleteMemory(id: string): Promise<void>;
+    /** Get all memories for a source */
+    getMemoriesBySource(source: string, limit?: number): Promise<MemoryEntry[]>;
+    /** Compact database (remove old/low-importance entries) */
+    compact(maxEntries?: number, minImportance?: number): Promise<number>;
+    /** Export memories to JSON */
+    exportMemories(): Promise<MemoryEntry[]>;
+    /** Import memories from JSON */
+    importMemories(entries: MemoryEntry[]): Promise<number>;
+    /** Close the database */
+    close(): Promise<void>;
+}
+export declare function createLanceDBExtension(config: LanceDBConfig): Promise<LanceDBExtension>;