linguclaw 0.4.3 → 0.5.0

package/dist/session-memory.js

@@ -0,0 +1,351 @@
+"use strict";
+/**
+ * Session Memory - Short-term contextual memory for active sessions
+ *
+ * Core capabilities:
+ * - Short-term Memory: Tracks current session history, prevents repeating mistakes
+ * - Action History: Remembers what has been tried and what worked/failed
+ * - Context Window: Maintains relevant context within token limits
+ * - Learning: Extracts patterns from sessions to improve long-term memory
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionMemory = void 0;
+exports.getSessionMemory = getSessionMemory;
+const logger_1 = require("./logger");
+const logger = (0, logger_1.getLogger)();
+const DEFAULT_CONFIG = {
+    maxEntries: 200,
+    maxTokens: 16000,
+    maxActionHistory: 100,
+    maxFailedAttempts: 3,
+    enableLearning: true,
+    summaryThreshold: 50,
+};
+// ==================== Session Memory ====================
+class SessionMemory {
+    config;
+    sessions = new Map();
+    activeSessionId = null;
+    longTermMemory = null;
+    idCounter = 0;
+    constructor(config, longTermMemory) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.longTermMemory = longTermMemory || null;
+    }
+    /**
+     * Start a new session
+     */
+    startSession(task, sessionId) {
+        const id = sessionId || `sess-${Date.now()}-${Math.random().toString(36).substr(2, 6)}`;
+        this.sessions.set(id, {
+            task,
+            entries: [],
+            actionHistory: [],
+            failedAttempts: new Map(),
+            discoveredFacts: [],
+            currentFocus: task,
+            tokensUsed: 0,
+        });
+        this.activeSessionId = id;
+        this.addEntry(id, 'context', `Session started for task: ${task}`);
+        // Load relevant context from long-term memory
+        if (this.longTermMemory) {
+            const pastKnowledge = this.longTermMemory.search(task, 'learned_patterns', 5);
+            if (pastKnowledge.length > 0) {
+                for (const item of pastKnowledge) {
+                    this.addEntry(id, 'context', `Past knowledge: ${JSON.stringify(item.value).substring(0, 300)}`, {
+                        source: 'long_term_memory',
+                    });
+                }
+                logger.info(`[SessionMemory] Loaded ${pastKnowledge.length} relevant memories for session`);
+            }
+        }
+        logger.info(`[SessionMemory] Session started: ${id}`);
+        return id;
+    }
+    /**
+     * End a session and optionally learn from it
+     */
+    endSession(sessionId) {
+        const sid = sessionId || this.activeSessionId;
+        if (!sid)
+            return;
+        const session = this.sessions.get(sid);
+        if (!session)
+            return;
+        // Extract learnings and save to long-term memory
+        if (this.config.enableLearning && this.longTermMemory && session.actionHistory.length > 0) {
+            this.extractLearnings(sid, session);
+        }
+        if (this.activeSessionId === sid) {
+            this.activeSessionId = null;
+        }
+        logger.info(`[SessionMemory] Session ended: ${sid} (${session.entries.length} entries, ${session.actionHistory.length} actions)`);
+    }
+    /**
+     * Add an entry to the session
+     */
+    addEntry(sessionId, type, content, metadata) {
+        const sid = sessionId || this.activeSessionId;
+        const session = sid ? this.sessions.get(sid) : null;
+        const entry = {
+            id: `entry-${++this.idCounter}`,
+            timestamp: new Date(),
+            type,
+            content,
+            metadata,
+            tokenEstimate: Math.ceil(content.length / 4), // rough estimate
+        };
+        if (session) {
+            session.entries.push(entry);
+            session.tokensUsed += entry.tokenEstimate || 0;
+            // Compact if over limits
+            if (session.entries.length > this.config.maxEntries) {
+                this.compactSession(sid);
+            }
+            if (session.tokensUsed > this.config.maxTokens) {
+                this.compactSession(sid);
+            }
+        }
+        return entry;
+    }
+    /**
+     * Record an action attempt
+     */
+    recordAction(sessionId, action, input, success, output, error, duration) {
+        const sid = sessionId || this.activeSessionId;
+        const session = sid ? this.sessions.get(sid) : null;
+        if (!session)
+            return;
+        const attempt = {
+            action,
+            input: input.substring(0, 1000),
+            output: output?.substring(0, 2000),
+            success,
+            timestamp: new Date(),
+            duration,
+            error,
+        };
+        session.actionHistory.push(attempt);
+        // Track failed attempts
+        if (!success) {
+            const signature = `${action}:${input.substring(0, 200)}`;
+            const count = (session.failedAttempts.get(signature) || 0) + 1;
+            session.failedAttempts.set(signature, count);
+            this.addEntry(sid, 'error', `Action failed (attempt ${count}): ${action} — ${error || 'unknown error'}`, {
+                action,
+                attemptCount: count,
+            });
+        }
+        else {
+            this.addEntry(sid, 'action_result', `Action succeeded: ${action} — ${(output || '').substring(0, 200)}`, {
+                action,
+                duration,
+            });
+        }
+        // Trim action history
+        if (session.actionHistory.length > this.config.maxActionHistory) {
+            session.actionHistory = session.actionHistory.slice(-this.config.maxActionHistory);
+        }
+    }
+    /**
+     * Check if an action has been tried too many times
+     */
+    shouldAvoid(sessionId, action, input) {
+        const sid = sessionId || this.activeSessionId;
+        const session = sid ? this.sessions.get(sid) : null;
+        if (!session)
+            return { avoid: false, attempts: 0 };
+        const signature = `${action}:${input.substring(0, 200)}`;
+        const count = session.failedAttempts.get(signature) || 0;
+        if (count >= this.config.maxFailedAttempts) {
+            return {
+                avoid: true,
+                reason: `This action has failed ${count} times already. Try a different approach.`,
+                attempts: count,
+            };
+        }
+        return { avoid: false, attempts: count };
+    }
+    /**
+     * Add a discovered fact
+     */
+    addFact(sessionId, fact) {
+        const sid = sessionId || this.activeSessionId;
+        const session = sid ? this.sessions.get(sid) : null;
+        if (!session)
+            return;
+        if (!session.discoveredFacts.includes(fact)) {
+            session.discoveredFacts.push(fact);
+            this.addEntry(sid, 'context', `Discovered: ${fact}`);
+        }
+    }
+    /**
+     * Update the current focus
+     */
+    setFocus(sessionId, focus) {
+        const sid = sessionId || this.activeSessionId;
+        const session = sid ? this.sessions.get(sid) : null;
+        if (!session)
+            return;
+        session.currentFocus = focus;
+        this.addEntry(sid, 'context', `Focus shifted to: ${focus}`);
+    }
+    /**
+     * Get context string for LLM prompt
+     */
+    getContextForLLM(sessionId, maxTokens) {
+        const sid = sessionId || this.activeSessionId;
+        const session = sid ? this.sessions.get(sid) : null;
+        if (!session)
+            return '';
+        const limit = maxTokens || this.config.maxTokens;
+        const parts = [];
+        let tokens = 0;
+        // Task and focus
+        parts.push(`Current task: ${session.task}`);
+        parts.push(`Current focus: ${session.currentFocus}`);
+        tokens += Math.ceil((session.task.length + session.currentFocus.length) / 4);
+        // Discovered facts
+        if (session.discoveredFacts.length > 0) {
+            parts.push(`\nDiscovered facts:`);
+            for (const fact of session.discoveredFacts.slice(-10)) {
+                parts.push(`  - ${fact}`);
+                tokens += Math.ceil(fact.length / 4);
+            }
+        }
+        // Failed attempts warning
+        if (session.failedAttempts.size > 0) {
+            parts.push(`\nFailed approaches (avoid these):`);
+            for (const [sig, count] of session.failedAttempts) {
+                if (count >= 2) {
+                    parts.push(`  - ${sig.substring(0, 100)} (failed ${count}x)`);
+                    tokens += 30;
+                }
+            }
+        }
+        // Recent entries (most recent first, within token budget)
+        parts.push(`\nRecent activity:`);
+        const recentEntries = session.entries.slice(-30).reverse();
+        for (const entry of recentEntries) {
+            const line = `  [${entry.type}] ${entry.content.substring(0, 300)}`;
+            const lineTokens = Math.ceil(line.length / 4);
+            if (tokens + lineTokens > limit)
+                break;
+            parts.push(line);
+            tokens += lineTokens;
+        }
+        return parts.join('\n');
+    }
+    /**
+     * Get action history for a session
+     */
+    getActionHistory(sessionId) {
+        const sid = sessionId || this.activeSessionId;
+        const session = sid ? this.sessions.get(sid) : null;
+        return session?.actionHistory || [];
+    }
+    /**
+     * Get session stats
+     */
+    getStats(sessionId) {
+        const sid = sessionId || this.activeSessionId;
+        const session = sid ? this.sessions.get(sid) : null;
+        if (!session)
+            return { entries: 0, actions: 0, failedActions: 0, facts: 0, tokensUsed: 0 };
+        return {
+            entries: session.entries.length,
+            actions: session.actionHistory.length,
+            failedActions: session.actionHistory.filter(a => !a.success).length,
+            facts: session.discoveredFacts.length,
+            tokensUsed: session.tokensUsed,
+        };
+    }
+    /**
+     * Compact session by summarizing old entries
+     */
+    compactSession(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (!session)
+            return;
+        // Keep last 30% of entries, summarize the rest
+        const keepCount = Math.max(20, Math.floor(session.entries.length * 0.3));
+        const toSummarize = session.entries.slice(0, session.entries.length - keepCount);
+        const toKeep = session.entries.slice(-keepCount);
+        // Create a summary entry
+        const actionCount = toSummarize.filter(e => e.type === 'action' || e.type === 'action_result').length;
+        const errorCount = toSummarize.filter(e => e.type === 'error').length;
+        const summary = `[Session compacted] ${toSummarize.length} older entries summarized: ${actionCount} actions, ${errorCount} errors`;
+        session.entries = [
+            {
+                id: `entry-summary-${Date.now()}`,
+                timestamp: new Date(),
+                type: 'context',
+                content: summary,
+                tokenEstimate: Math.ceil(summary.length / 4),
+            },
+            ...toKeep,
+        ];
+        session.tokensUsed = session.entries.reduce((sum, e) => sum + (e.tokenEstimate || 0), 0);
+        logger.info(`[SessionMemory] Compacted session ${sessionId}: ${toSummarize.length} entries summarized`);
+    }
+    /**
+     * Extract learnings from a session and save to long-term memory
+     */
+    extractLearnings(sessionId, session) {
+        if (!this.longTermMemory)
+            return;
+        // Learn from successful action patterns
+        const successfulActions = session.actionHistory.filter(a => a.success);
+        const failedActions = session.actionHistory.filter(a => !a.success);
+        if (successfulActions.length > 0) {
+            const patterns = successfulActions.map(a => `${a.action}: ${a.input.substring(0, 100)}`).join('; ');
+            this.longTermMemory.store(`learned:${sessionId}:success`, {
+                task: session.task,
+                successfulApproaches: patterns,
+                totalActions: session.actionHistory.length,
+                successRate: successfulActions.length / session.actionHistory.length,
+                timestamp: new Date().toISOString(),
+            }, 'learned_patterns', ['session_learning', 'success_pattern'], 30 // 30 day TTL
+            );
+        }
+        // Learn from repeated failures
+        for (const [signature, count] of session.failedAttempts) {
+            if (count >= 2) {
+                this.longTermMemory.store(`learned:${sessionId}:avoid:${signature.substring(0, 50)}`, {
+                    task: session.task,
+                    failedApproach: signature,
+                    failureCount: count,
+                    timestamp: new Date().toISOString(),
+                }, 'learned_patterns', ['session_learning', 'failure_pattern'], 14 // 14 day TTL
+                );
+            }
+        }
+        // Store discovered facts
+        if (session.discoveredFacts.length > 0) {
+            this.longTermMemory.store(`facts:${sessionId}`, {
+                task: session.task,
+                facts: session.discoveredFacts,
+                timestamp: new Date().toISOString(),
+            }, 'discovered_facts', ['session_learning', 'facts'], 60 // 60 day TTL
+            );
+        }
+        logger.info(`[SessionMemory] Extracted learnings from session ${sessionId}`);
+    }
+    /**
+     * Get active session ID
+     */
+    getActiveSessionId() {
+        return this.activeSessionId;
+    }
+}
+exports.SessionMemory = SessionMemory;
+// ==================== Singleton ====================
+let instance = null;
+function getSessionMemory(config, longTermMemory) {
+    if (!instance) {
+        instance = new SessionMemory(config, longTermMemory);
+    }
+    return instance;
+}
+//# sourceMappingURL=session-memory.js.map

package/dist/session-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-memory.js","sourceRoot":"","sources":["../src/session-memory.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAybH,4CAKC;AA5bD,qCAAqC;AAGrC,MAAM,MAAM,GAAG,IAAA,kBAAS,GAAE,CAAC;AA0C3B,MAAM,cAAc,GAAwB;IAC1C,UAAU,EAAE,GAAG;IACf,SAAS,EAAE,KAAK;IAChB,gBAAgB,EAAE,GAAG;IACrB,iBAAiB,EAAE,CAAC;IACpB,cAAc,EAAE,IAAI;IACpB,gBAAgB,EAAE,EAAE;CACrB,CAAC;AAEF,2DAA2D;AAE3D,MAAa,aAAa;IAChB,MAAM,CAAsB;IAC5B,QAAQ,GAAgC,IAAI,GAAG,EAAE,CAAC;IAClD,eAAe,GAAkB,IAAI,CAAC;IACtC,cAAc,GAA0B,IAAI,CAAC;IAC7C,SAAS,GAAW,CAAC,CAAC;IAE9B,YAAY,MAAqC,EAAE,cAA+B;QAChF,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAC;QAC/C,IAAI,CAAC,cAAc,GAAG,cAAc,IAAI,IAAI,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,IAAY,EAAE,SAAkB;QAC3C,MAAM,EAAE,GAAG,SAAS,IAAI,QAAQ,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QAExF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE;YACpB,IAAI;YACJ,OAAO,EAAE,EAAE;YACX,aAAa,EAAE,EAAE;YACjB,cAAc,EAAE,IAAI,GAAG,EAAE;YACzB,eAAe,EAAE,EAAE;YACnB,YAAY,EAAE,IAAI;YAClB,UAAU,EAAE,CAAC;SACd,CAAC,CAAC;QAEH,IAAI,CAAC,eAAe,GAAG,EAAE,CAAC;QAC1B,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,6BAA6B,IAAI,EAAE,CAAC,CAAC;QAElE,8CAA8C;QAC9C,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,MAAM,aAAa,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC;YAC9E,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC7B,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;oBACjC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,mBAAmB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE;wBAC9F,MAAM,EAAE,kBAAkB;qBAC3B,CAAC,CAAC;gBACL,CAAC;gBACD,MAAM,CAAC,IAAI,CAAC,0BAA0B,aAAa,CAAC,MAAM,gCAAgC,CAAC,CAAC;YAC9F,CAAC;QACH,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,oCAAoC,EAAE,EAAE,CAAC,CAAC;QACtD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,SAAkB;QAC3B,MAAM,GAAG,GAAG,SAAS,IAAI,IAAI,CAAC,eAAe,CAAC;QAC9C,IAAI,CAAC,GAAG;YAAE,OAAO;QAEjB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,CAAC,OAAO;YAAE,OAAO;QAErB,iDAAiD;QACjD,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,IAAI,IAAI,CAAC,cAAc,IAAI,OAAO,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1F,IAAI,CAAC,gBAAgB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACtC,CAAC;QAED,IAAI,IAAI,CAAC,eAAe,KAAK,GAAG,EAAE,CAAC;YACjC,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAC9B,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,kCAAkC,GAAG,KAAK,OAAO,CAAC,OAAO,CAAC,MAAM,aAAa,OAAO,CAAC,aAAa,CAAC,MAAM,WAAW,CAAC,CAAC;IACpI,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,SAAwB,EAAE,IAA0B,EAAE,OAAe,EAAE,QAA8B;QAC5G,MAAM,GAAG,GAAG,SAAS,IAAI,IAAI,CAAC,eAAe,CAAC;QAC9C,MAAM,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAEpD,MAAM,KAAK,GAAiB;YAC1B,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE;YAC/B,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,IAAI;YACJ,OAAO;YACP,QAAQ;YACR,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,iBAAiB;SAChE,CAAC;QAEF,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC5B,OAAO,CAAC,UAAU,IAAI,KAAK,CAAC,aAAa,IAAI,CAAC,CAAC;YAE/C,yBAAyB;YACzB,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;gBACpD,IAAI,CAAC,cAAc,CAAC,GAAI,CAAC,CAAC;YAC5B,CAAC;YACD,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;gBAC/C,IAAI,CAAC,cAAc,CAAC,GAAI,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,SAAwB,EAAE,MAAc,EAAE,KAAa,EAAE,OAAgB,EAAE,MAAe,EAAE,KAAc,EAAE,QAAiB;QACxI,MAAM,GAAG,GAAG,SAAS,IAAI,IAAI,CAAC,eAAe,CAAC;QAC9C,MAAM,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACpD,IAAI,CAAC,OAAO;YAAE,OAAO;QAErB,MAAM,OAAO,GAAkB;YAC7B,MAAM;YACN,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC;YAC/B,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC;YAClC,OAAO;YACP,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,QAAQ;YACR,KAAK;SACN,CAAC;QAEF,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEpC,wBAAwB;QACxB,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,SAAS,GAAG,GAAG,MAAM,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;YACzD,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YAC/D,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YAE7C,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,0BAA0B,KAAK,MAAM,MAAM,MAAM,KAAK,IAAI,eAAe,EAAE,EAAE;gBACvG,MAAM;gBACN,YAAY,EAAE,KAAK;aACpB,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,eAAe,EAAE,qBAAqB,MAAM,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE;gBACvG,MAAM;gBACN,QAAQ;aACT,CAAC,CAAC;QACL,CAAC;QAED,sBAAsB;QACtB,IAAI,OAAO,CAAC,aAAa,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC;YAChE,OAAO,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,SAAwB,EAAE,MAAc,EAAE,KAAa;QACjE,MAAM,GAAG,GAAG,SAAS,IAAI,IAAI,CAAC,eAAe,CAAC;QAC9C,MAAM,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACpD,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QAEnD,MAAM,SAAS,GAAG,GAAG,MAAM,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;QACzD,MAAM,KAAK,GAAG,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAEzD,IAAI,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC;YAC3C,OAAO;gBACL,KAAK,EAAE,IAAI;gBACX,MAAM,EAAE,0BAA0B,KAAK,2CAA2C;gBAClF,QAAQ,EAAE,KAAK;aAChB,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,SAAwB,EAAE,IAAY;QAC5C,MAAM,GAAG,GAAG,SAAS,IAAI,IAAI,CAAC,eAAe,CAAC;QAC9C,MAAM,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACpD,IAAI,CAAC,OAAO;YAAE,OAAO;QAErB,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5C,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnC,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,SAAS,EAAE,eAAe,IAAI,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,SAAwB,EAAE,KAAa;QAC9C,MAAM,GAAG,GAAG,SAAS,IAAI,IAAI,CAAC,eAAe,CAAC;QAC9C,MAAM,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACpD,IAAI,CAAC,OAAO;YAAE,OAAO;QAErB,OAAO,CAAC,YAAY,GAAG,KAAK,CAAC;QAC7B,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,SAAS,EAAE,qBAAqB,KAAK,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,SAAkB,EAAE,SAAkB;QACrD,MAAM,GAAG,GAAG,SAAS,IAAI,IAAI,CAAC,eAAe,CAAC;QAC9C,MAAM,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACpD,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,CAAC;QAExB,MAAM,KAAK,GAAG,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;QACjD,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,IAAI,MAAM,GAAG,CAAC,CAAC;QAEf,iBAAiB;QACjB,KAAK,CAAC,IAAI,CAAC,iBAAiB,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5C,KAAK,CAAC,IAAI,CAAC,kBAAkB,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;QACrD,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAE7E,mBAAmB;QACnB,IAAI,OAAO,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvC,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;YAClC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;gBACtD,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;gBAC1B,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;QAED,0BAA0B;QAC1B,IAAI,OAAO,CAAC,cAAc,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YACpC,KAAK,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;YACjD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;gBAClD,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;oBACf,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC;oBAC9D,MAAM,IAAI,EAAE,CAAC;gBACf,CAAC;YACH,CAAC;QACH,CAAC;QAED,0DAA0D;QAC1D,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACjC,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;QAC3D,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;YAClC,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;YACpE,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAC9C,IAAI,MAAM,GAAG,UAAU,GAAG,KAAK;gBAAE,MAAM;YACvC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjB,MAAM,IAAI,UAAU,CAAC;QACvB,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,SAAkB;QACjC,MAAM,GAAG,GAAG,SAAS,IAAI,IAAI,CAAC,eAAe,CAAC;QAC9C,MAAM,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACpD,OAAO,OAAO,EAAE,aAAa,IAAI,EAAE,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,SAAkB;QAOzB,MAAM,GAAG,GAAG,SAAS,IAAI,IAAI,CAAC,eAAe,CAAC;QAC9C,MAAM,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACpD,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;QAE3F,OAAO;YACL,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM;YAC/B,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,MAAM;YACrC,aAAa,EAAE,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM;YACnE,KAAK,EAAE,OAAO,CAAC,eAAe,CAAC,MAAM;YACrC,UAAU,EAAE,OAAO,CAAC,UAAU;SAC/B,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,SAAiB;QACtC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO;YAAE,OAAO;QAErB,+CAA+C;QAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC;QACzE,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;QACjF,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC;QAEjD,yBAAyB;QACzB,MAAM,WAAW,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC,MAAM,CAAC;QACtG,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,MAAM,CAAC;QACtE,MAAM,OAAO,GAAG,uBAAuB,WAAW,CAAC,MAAM,8BAA8B,WAAW,aAAa,UAAU,SAAS,CAAC;QAEnI,OAAO,CAAC,OAAO,GAAG;YAChB;gBACE,EAAE,EAAE,iBAAiB,IAAI,CAAC,GAAG,EAAE,EAAE;gBACjC,SAAS,EAAE,IAAI,IAAI,EAAE;gBACrB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,OAAO;gBAChB,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;aAC7C;YACD,GAAG,MAAM;SACV,CAAC;QAEF,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACzF,MAAM,CAAC,IAAI,CAAC,qCAAqC,SAAS,KAAK,WAAW,CAAC,MAAM,qBAAqB,CAAC,CAAC;IAC1G,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,SAAiB,EAAE,OAAuB;QACjE,IAAI,CAAC,IAAI,CAAC,cAAc;YAAE,OAAO;QAEjC,wCAAwC;QACxC,MAAM,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACvE,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAEpE,IAAI,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpG,IAAI,CAAC,cAAc,CAAC,KAAK,CACvB,WAAW,SAAS,UAAU,EAC9B;gBACE,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,oBAAoB,EAAE,QAAQ;gBAC9B,YAAY,EAAE,OAAO,CAAC,aAAa,CAAC,MAAM;gBAC1C,WAAW,EAAE,iBAAiB,CAAC,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM;gBACpE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,EACD,kBAAkB,EAClB,CAAC,kBAAkB,EAAE,iBAAiB,CAAC,EACvC,EAAE,CAAC,aAAa;aACjB,CAAC;QACJ,CAAC;QAED,+BAA+B;QAC/B,KAAK,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;YACxD,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;gBACf,IAAI,CAAC,cAAc,CAAC,KAAK,CACvB,WAAW,SAAS,UAAU,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAC1D;oBACE,IAAI,EAAE,OAAO,CAAC,IAAI;oBAClB,cAAc,EAAE,SAAS;oBACzB,YAAY,EAAE,KAAK;oBACnB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACpC,EACD,kBAAkB,EAClB,CAAC,kBAAkB,EAAE,iBAAiB,CAAC,EACvC,EAAE,CAAC,aAAa;iBACjB,CAAC;YACJ,CAAC;QACH,CAAC;QAED,yBAAyB;QACzB,IAAI,OAAO,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvC,IAAI,CAAC,cAAc,CAAC,KAAK,CACvB,SAAS,SAAS,EAAE,EACpB;gBACE,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,KAAK,EAAE,OAAO,CAAC,eAAe;gBAC9B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,EACD,kBAAkB,EAClB,CAAC,kBAAkB,EAAE,OAAO,CAAC,EAC7B,EAAE,CAAC,aAAa;aACjB,CAAC;QACJ,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,oDAAoD,SAAS,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;CACF;AAzXD,sCAyXC;AAED,sDAAsD;AAEtD,IAAI,QAAQ,GAAyB,IAAI,CAAC;AAE1C,SAAgB,gBAAgB,CAAC,MAAqC,EAAE,cAA+B;IACrG,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,QAAQ,GAAG,IAAI,aAAa,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/static/dashboard.html

@@ -223,7 +223,7 @@ select.inp{appearance:none;background-image:url("data:image/svg+xml,%3Csvg xmlns
 <body>
 <div id="toast" class="toast"></div>
 <div class="top">
-  <div class="top-left"><svg class="logo" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5"><path d="M12 3c-1.5 0-2.7.5-3.5 1.3C7.7 5.1 7 6.3 7 8c0 1.3.4 2.4 1 3.2V13c0 1.5-.5 2.5-1.2 3.2-.4.4-.4 1 0 1.4.4.4 1 .4 1.4 0 .9-.9 1.5-2.2 1.7-3.7.5.2 1 .3 1.6.3h.9c.6 0 1.1-.1 1.6-.3.2 1.5.8 2.8 1.7 3.7.4.4 1 .4 1.4 0 .4-.4.4-1 0-1.4-.7-.7-1.2-1.7-1.2-3.2v-1.8c.6-.8 1-1.9 1-3.2 0-1.7-.7-2.9-1.5-3.7C14.7 3.5 13.5 3 12 3z"/><path d="M5 9c-1.5 0-3 .5-4 1.5C.5 11.5 0 12.5 0 14c0 1.5.5 2.5 1.2 3.2.4.4 1 .4 1.4 0 .4-.4.4-1 0-1.4-.4-.4-.6-1-.6-1.8 0-.8.3-1.4.7-1.8.4-.4 1-.6 1.8-.6"/><path d="M19 9c1.5 0 3 .5 4 1.5.5.5 1 1.5 1 3 0 1.5-.5 2.5-1.2 3.2-.4.4-1 .4-1.4 0-.4-.4-.4-1 0-1.4.4-.4.6-1 .6-1.8 0-.8-.3-1.4-.7-1.8-.4-.4-1-.6-1.8-.6"/><path d="M4 20c-.8 0-1.5.5-1.8 1.2-.2.5.1 1.1.6 1.3.5.2 1.1-.1 1.3-.6.1-.2.3-.4.6-.4.3 0 .5.2.6.4.2.5.8.8 1.3.6.5-.2.8-.8.6-1.3C7 20.5 6.3 20 5.5 20H4z"/><path d="M16 20c-.8 0-1.5.5-1.8 1.2-.2.5.1 1.1.6 1.3.5.2 1.1-.1 1.3-.6.1-.2.3-.4.6-.4.3 0 .5.2.6.4.2.5.8.8 1.3.6.5-.2.8-.8.6-1.3-.3-.7-1-1.2-1.8-1.2h-1.5z"/></svg><div class="brand">Lingu<span>Claw</span></div></div>
+  <div class="top-left"><svg class="logo" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5"><path d="M12 3c-1.5 0-2.7.5-3.5 1.3C7.7 5.1 7 6.3 7 8c0 1.3.4 2.4 1 3.2V13c0 1.5-.5 2.5-1.2 3.2-.4.4-.4 1 0 1.4.4.4 1 .4 1.4 0 .9-.9 1.5-2.2 1.7-3.7.5.2 1 .3 1.6.3h.9c.6 0 1.1-.1 1.6-.3.2 1.5.8 2.8 1.7 3.7.4.4 1 .4 1.4 0 .4-.4.4-1 0-1.4-.7-.7-1.2-1.7-1.2-3.2v-1.8c.6-.8 1-1.9 1-3.2 0-1.7-.7-2.9-1.5-3.7C14.7 3.5 13.5 3 12 3z"/><path d="M5 9c-1.5 0-3 .5-4 1.5C.5 11.5 0 12.5 0 14c0 1.5.5 2.5 1.2 3.2.4.4 1 .4 1.4 0 .4-.4.4-1 0-1.4-.4-.4-.6-1-.6-1.8 0-.8.3-1.4.7-1.8.4-.4 1-.6 1.8-.6"/><path d="M19 9c1.5 0 3 .5 4 1.5.5.5 1 1.5 1 3 0 1.5-.5 2.5-1.2 3.2-.4.4-1 .4-1.4 0-.4-.4-.4-1 0-1.4.4-.4.6-1 .6-1.8 0-.8-.3-1.4-.7-1.8-.4-.4-1-.6-1.8-.6"/><path d="M4 20c-.8 0-1.5.5-1.8 1.2-.2.5.1 1.1.6 1.3.5.2 1.1-.1 1.3-.6.1-.2.3-.4.6-.4.3 0 .5.2.6.4.2.5.8.8 1.3.6.5-.2.8-.8.6-1.3C7 20.5 6.3 20 5.5 20H4z"/><path d="M16 20c-.8 0-1.5.5-1.8 1.2-.2.5.1 1.1.6 1.3.5.2 1.1-.1 1.3-.6.1-.2.3-.4.6-.4.3 0 .5.2.6.4.2.5.8.8 1.3.6.5-.2.8-.8.6-1.3-.3-.7-1-1.2-1.8-1.2h-1.5z"/></svg><div class="brand">Lingu<span>Claw</span></div><div class="badge" style="margin-left:10px;background:var(--bg2);color:var(--accent2);font-weight:700">v0.4.3</div></div>
   <div class="top-right">
     <div class="badge" id="modelBadge">loading...</div>
     <div class="badge"><div class="dot on" id="wsDot"></div><span id="wsLabel">Connected</span></div>

package/dist/static/hub.html

@@ -228,7 +228,7 @@ section{padding:120px 0;position:relative;overflow:hidden}
   </div>
   <div class="container hub-hero-content">
     <div class="hub-hero-badge">
-      <span class="tag">Open Source</span>
+      <span class="tag">v0.4.3</span>
       Community Skills Marketplace
     </div>
     <h1><span class="grad">ClawLing Hub</span></h1>

package/dist/static/index.html

@@ -231,6 +231,27 @@ section{padding:120px 0;position:relative;overflow:hidden}
 .gs-card p{font-size:12.5px;color:var(--dim);line-height:1.7}
 .gs-card code{display:inline-block;margin-top:12px;padding:8px 16px;border-radius:8px;background:var(--bg);border:1px solid var(--border);font-family:'JetBrains Mono',monospace;font-size:12px;color:var(--green)}
 
+/* ============ API KEY CONFIG ============ */
+.apikeys{background:var(--bg1);position:relative}
+.apikeys::before{content:'';position:absolute;inset:0;background:radial-gradient(ellipse at 30% 50%,rgba(108,92,231,.04),transparent 60%);pointer-events:none}
+.ak-grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(200px,1fr));gap:16px;margin-top:40px}
+.ak-card{padding:24px;border-radius:var(--r2);background:var(--bg2);border:1px solid var(--border);transition:all .3s;position:relative}
+.ak-card:hover{border-color:rgba(108,92,231,.3);transform:translateY(-3px);box-shadow:0 8px 28px rgba(0,0,0,.2)}
+.ak-card .ak-ico{font-size:28px;margin-bottom:12px;display:block}
+.ak-card .ak-name{font-size:15px;font-weight:700;margin-bottom:4px}
+.ak-card .ak-desc{font-size:12px;color:var(--dim);line-height:1.6;margin-bottom:12px}
+.ak-card .ak-env{font-family:'JetBrains Mono',monospace;font-size:10.5px;padding:6px 10px;border-radius:8px;background:var(--bg);border:1px solid var(--border);color:var(--cyan);word-break:break-all}
+.ak-card .ak-free{display:inline-block;padding:3px 10px;border-radius:100px;font-size:10px;font-weight:700;background:rgba(0,230,118,.1);color:var(--green);border:1px solid rgba(0,230,118,.15);margin-top:8px}
+.ak-methods{max-width:720px;margin:0 auto 32px}
+.ak-methods h3{font-size:17px;font-weight:700;margin-bottom:14px;display:flex;align-items:center;gap:10px}
+.ak-methods h3 .num{width:28px;height:28px;border-radius:50%;background:linear-gradient(135deg,var(--accent),var(--accent3));color:#fff;font-size:13px;display:flex;align-items:center;justify-content:center;flex-shrink:0}
+.ak-code{border-radius:var(--r2);overflow:hidden;border:1px solid var(--border);background:var(--bg);margin-bottom:8px}
+.ak-code-bar{padding:10px 14px;background:var(--bg2);border-bottom:1px solid var(--border);font-size:11px;color:var(--muted);font-family:'JetBrains Mono',monospace}
+.ak-code pre{padding:16px 20px;font-family:'JetBrains Mono',monospace;font-size:12.5px;line-height:1.8;color:var(--dim);overflow-x:auto;margin:0;white-space:pre}
+.ak-code .env-key{color:var(--cyan)}.ak-code .env-val{color:var(--green)}.ak-code .env-cm{color:var(--muted);font-style:italic}
+.ak-note{max-width:720px;margin:28px auto 0;padding:16px 20px;border-radius:var(--r);background:rgba(24,255,255,.04);border:1px solid rgba(24,255,255,.12);font-size:13px;color:var(--dim);line-height:1.7;display:flex;gap:12px;align-items:flex-start}
+.ak-note .note-ico{font-size:16px;flex-shrink:0;margin-top:2px}
+
 /* ============ CTA ============ */
 .cta{text-align:center;padding:100px 0 120px;position:relative}
 .cta::before{content:'';position:absolute;inset:0;background:radial-gradient(ellipse at center,rgba(108,92,231,.05),transparent 70%);pointer-events:none}
@@ -256,7 +277,7 @@ section{padding:120px 0;position:relative;overflow:hidden}
 /* ============ RESPONSIVE ============ */
 @media(max-width:1024px){.feat-grid{grid-template-columns:repeat(2,1fr)}.lang-grid{grid-template-columns:repeat(3,1fr)}.footer-grid{grid-template-columns:1fr 1fr}}
 @media(max-width:768px){
-  .feat-grid,.gs-grid{grid-template-columns:1fr}
+  .feat-grid,.gs-grid,.ak-grid{grid-template-columns:1fr}
   .arch-grid,.wf-grid,.hub-intro{grid-template-columns:1fr}
   .how-steps{grid-template-columns:repeat(2,1fr)}.how-line{display:none}
   .lang-grid{grid-template-columns:repeat(2,1fr)}
@@ -286,6 +307,7 @@ section{padding:120px 0;position:relative;overflow:hidden}
       <a href="#workflows" class="nav-link">Workflows</a>
       <a href="#hub" class="nav-link">Hub</a>
       <a href="#architecture" class="nav-link">Architecture</a>
+      <a href="#apikeys" class="nav-link">API Keys</a>
       <a href="hub.html" class="nav-link">ClawLing Hub</a>
       <a href="https://github.com/LinguDeep/LinguClaw" target="_blank" class="nav-cta">
         <svg viewBox="0 0 24 24" fill="currentColor" width="16" height="16" style="width:16px;height:16px"><path d="M12 0c-6.626 0-12 5.373-12 12 0 5.302 3.438 9.8 8.207 11.387.599.111.793-.261.793-.577v-2.234c-3.338.726-4.033-1.416-4.033-1.416-.546-1.387-1.333-1.756-1.333-1.756-1.089-.745.083-.729.083-.729 1.205.084 1.839 1.237 1.839 1.237 1.07 1.834 2.807 1.304 3.492.997.107-.775.418-1.305.762-1.604-2.665-.305-5.467-1.334-5.467-5.931 0-1.311.469-2.381 1.236-3.221-.124-.303-.535-1.524.117-3.176 0 0 1.008-.322 3.301 1.23A11.509 11.509 0 0112 5.803c1.02.005 2.047.138 3.006.404 2.291-1.552 3.297-1.23 3.297-1.23.653 1.653.242 2.874.118 3.176.77.84 1.235 1.911 1.235 3.221 0 4.609-2.807 5.624-5.479 5.921.43.372.823 1.102.823 2.222v3.293c0 .319.192.694.801.576C20.566 21.797 24 17.3 24 12c0-6.627-5.373-12-12-12z"/></svg>
@@ -307,7 +329,7 @@ section{padding:120px 0;position:relative;overflow:hidden}
   </div>
   <div class="container hero-content">
     <div class="hero-eyebrow">
-      <span class="tag">v0.4.0</span>
+      <span class="tag">v0.4.3</span>
       <span class="dot"></span>
       Open Source &middot; Multi-Agent &middot; TypeScript
     </div>
@@ -348,7 +370,7 @@ section{padding:120px 0;position:relative;overflow:hidden}
       <div class="sc-body">
         <div class="sc-line"><span class="t-prompt">❯</span> <span class="t-cmd">npm install -g linguclaw</span></div>
         <div class="sc-line"><span class="t-prompt">❯</span> <span class="t-cmd">linguclaw init</span> <span class="t-flag">--provider ollama</span></div>
-        <div class="sc-line"><span class="t-out">🦀 LinguClaw v0.4.0 initialized</span></div>
+        <div class="sc-line"><span class="t-out">🦀 LinguClaw v0.4.3 initialized</span></div>
         <div class="sc-line"><span class="t-out">   ✓ Multi-agent system ready (Coder, Reviewer, Architect)</span></div>
         <div class="sc-line"><span class="t-out">   ✓ Semantic memory indexed files across <strong style="color:var(--text)">6</strong> languages</span></div>
         <div class="sc-line"><span class="t-out">   ✓ Workflow engine loaded <strong style="color:var(--text)">22</strong> node types</span></div>
@@ -609,7 +631,7 @@ section{padding:120px 0;position:relative;overflow:hidden}
     <div class="sh reveal">
       <div class="sh-badge">🚀 Get Started</div>
       <h2>Start building in under a minute</h2>
-      <p>No API key required if you run Ollama locally.</p>
+      <p>Supports local and cloud LLMs. See dashboard for provider setup.</p>
     </div>
     <div class="gs-grid">
       <div class="gs-card reveal d1">
@@ -621,7 +643,7 @@ section{padding:120px 0;position:relative;overflow:hidden}
       <div class="gs-card reveal d2">
         <div class="gs-step">2</div>
         <h3>Initialize</h3>
-        <p>Set up your project with your preferred LLM provider.</p>
+        <p>Set up your project with your preferred LLM provider. <a href="#apikeys" style="color:var(--accent2);font-weight:600">Configure API keys ↓</a></p>
         <code>linguclaw init</code>
       </div>
       <div class="gs-card reveal d3">
@@ -634,6 +656,109 @@ section{padding:120px 0;position:relative;overflow:hidden}
   </div>
 </section>
 
+<!-- ======== API KEY CONFIGURATION ======== -->
+<section class="apikeys" id="apikeys">
+  <div class="container">
+    <div class="sh reveal">
+      <div class="sh-badge">🔑 Configuration</div>
+      <h2>Set up your API keys</h2>
+      <p>Configure cloud LLM providers with API keys, or use Ollama / LM Studio for completely free local inference.</p>
+    </div>
+
+    <div class="ak-methods reveal">
+      <h3><span class="num">1</span> Environment Variables (Recommended)</h3>
+      <div class="ak-code">
+        <div class="ak-code-bar">.env &nbsp;/&nbsp; ~/.bashrc &nbsp;/&nbsp; ~/.zshrc</div>
+        <pre><span class="env-cm"># Cloud Providers — pick one or more</span>
+<span class="env-key">OPENAI_API_KEY</span>=<span class="env-val">"sk-proj-..."</span>
+<span class="env-key">ANTHROPIC_API_KEY</span>=<span class="env-val">"sk-ant-api03-..."</span>
+<span class="env-key">OPENROUTER_API_KEY</span>=<span class="env-val">"sk-or-v1-..."</span>
+<span class="env-key">GOOGLE_API_KEY</span>=<span class="env-val">"AIza..."</span>
+<span class="env-key">XAI_API_KEY</span>=<span class="env-val">"xai-..."</span>
+
+<span class="env-cm"># Optional: Set default provider</span>
+<span class="env-key">LINGUCLAW_PROVIDER</span>=<span class="env-val">"openai"</span></pre>
+      </div>
+    </div>
+
+    <div class="ak-methods reveal">
+      <h3><span class="num">2</span> Interactive Setup via CLI</h3>
+      <div class="ak-code">
+        <div class="ak-code-bar">terminal</div>
+        <pre><span class="env-cm"># Initialize with a specific provider</span>
+<span class="env-key">❯</span> linguclaw init <span class="env-val">--provider openai</span>
+<span class="env-cm"># You'll be prompted for your API key interactively</span>
+
+<span class="env-cm"># Or switch providers anytime</span>
+<span class="env-key">❯</span> linguclaw config <span class="env-val">set provider anthropic</span>
+<span class="env-key">❯</span> linguclaw config <span class="env-val">set api-key sk-ant-...</span></pre>
+      </div>
+    </div>
+
+    <div class="ak-note reveal">
+      <span class="note-ico">💡</span>
+      <span>Using <strong style="color:var(--text)">Ollama</strong> or <strong style="color:var(--text)">LM Studio</strong>? No API key needed — just install and run locally. LinguClaw auto-detects local providers on <code style="color:var(--cyan)">localhost:11434</code> (Ollama) or <code style="color:var(--cyan)">localhost:1234</code> (LM Studio).</span>
+    </div>
+
+    <div class="ak-grid">
+      <div class="ak-card reveal d1">
+        <span class="ak-ico">🤖</span>
+        <div class="ak-name">OpenAI</div>
+        <div class="ak-desc">GPT-4o, o1, GPT-5</div>
+        <div class="ak-env">OPENAI_API_KEY</div>
+      </div>
+      <div class="ak-card reveal d2">
+        <span class="ak-ico">🧠</span>
+        <div class="ak-name">Anthropic</div>
+        <div class="ak-desc">Claude 3.5 / Claude 4</div>
+        <div class="ak-env">ANTHROPIC_API_KEY</div>
+      </div>
+      <div class="ak-card reveal d3">
+        <span class="ak-ico">🌐</span>
+        <div class="ak-name">OpenRouter</div>
+        <div class="ak-desc">100+ models, one key</div>
+        <div class="ak-env">OPENROUTER_API_KEY</div>
+      </div>
+      <div class="ak-card reveal d1">
+        <span class="ak-ico">🔵</span>
+        <div class="ak-name">Google</div>
+        <div class="ak-desc">Gemini 1.5 / 2.5</div>
+        <div class="ak-env">GOOGLE_API_KEY</div>
+      </div>
+      <div class="ak-card reveal d2">
+        <span class="ak-ico">✖️</span>
+        <div class="ak-name">xAI</div>
+        <div class="ak-desc">Grok models</div>
+        <div class="ak-env">XAI_API_KEY</div>
+      </div>
+      <div class="ak-card reveal d3">
+        <span class="ak-ico">🦙</span>
+        <div class="ak-name">Ollama</div>
+        <div class="ak-desc">Free local models</div>
+        <span class="ak-free">No API Key Required</span>
+      </div>
+      <div class="ak-card reveal d1">
+        <span class="ak-ico">💻</span>
+        <div class="ak-name">LM Studio</div>
+        <div class="ak-desc">Desktop local models</div>
+        <span class="ak-free">No API Key Required</span>
+      </div>
+      <div class="ak-card reveal d2">
+        <span class="ak-ico">🌬️</span>
+        <div class="ak-name">Mistral</div>
+        <div class="ak-desc">Mistral AI models</div>
+        <div class="ak-env">MISTRAL_API_KEY</div>
+      </div>
+      <div class="ak-card reveal d3">
+        <span class="ak-ico">🔍</span>
+        <div class="ak-name">DeepSeek</div>
+        <div class="ak-desc">DeepSeek V3 &amp; R1</div>
+        <div class="ak-env">DEEPSEEK_API_KEY</div>
+      </div>
+    </div>
+  </div>
+</section>
+
 <!-- ======== CTA ======== -->
 <section class="cta">
   <div class="container reveal">