cf-claw 3.0.0

package/dist/llm/registry.js

@@ -0,0 +1,90 @@
+import { config } from "../config.js";
+import { FailoverError } from "./failover.js";
+const providers = new Map();
+let activeProviderName = null;
+let activeModelName = null;
+export function registerProvider(provider) {
+    for (const model of provider.models) {
+        providers.set(model, provider);
+    }
+    console.log(`📦 Registered provider "${provider.name}" with models: ${provider.models.join(", ")}`);
+}
+export function setActiveModel(model) {
+    const provider = providers.get(model);
+    if (!provider) {
+        const available = [...providers.keys()];
+        throw new Error(`Unknown model "${model}". Available: ${available.join(", ")}`);
+    }
+    activeProviderName = provider.name;
+    activeModelName = model;
+    console.log(`🔄 Active model set to: ${model} (via ${provider.name})`);
+}
+export function getActiveModel() {
+    return activeModelName || "unknown";
+}
+export function getActiveProviderName() {
+    return activeProviderName || "unknown";
+}
+export function getAvailableModels() {
+    return [...providers.keys()];
+}
+export async function chatCompletion(options) {
+    if (!activeModelName)
+        throw new Error("No active model set");
+    const provider = providers.get(activeModelName);
+    if (!provider)
+        throw new Error(`No provider for model ${activeModelName}`);
+    return provider.chatCompletion({ ...options, model: activeModelName });
+}
+export function getProviderForModel(model) {
+    return providers.get(model);
+}
+export async function chatCompletionWithFallback(primaryModel, fallbackModel, options) {
+    const attempts = [];
+    const modelsToTry = [];
+    if (primaryModel) {
+        modelsToTry.push(primaryModel);
+    }
+    else if (activeModelName) {
+        modelsToTry.push(activeModelName);
+    }
+    if (fallbackModel && !modelsToTry.includes(fallbackModel)) {
+        modelsToTry.push(fallbackModel);
+    }
+    if (config.failoverChain.length > 0) {
+        for (const m of config.failoverChain) {
+            if (!modelsToTry.includes(m)) {
+                modelsToTry.push(m);
+            }
+        }
+    }
+    for (const model of modelsToTry) {
+        try {
+            const provider = providers.get(model);
+            if (!provider) {
+                attempts.push({ model, error: new Error(`No provider for model "${model}"`) });
+                continue;
+            }
+            const result = await provider.chatCompletion({ ...options, model });
+            return result;
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            attempts.push({ model, error });
+            console.warn(`⚠️ Model "${model}" failed: ${error.message}`);
+            const isRetryable = error.message.includes("429") ||
+                error.message.includes("rate") ||
+                error.message.includes("timeout") ||
+                error.message.includes("ECONNREFUSED") ||
+                error.message.includes("500") ||
+                error.message.includes("502") ||
+                error.message.includes("503") ||
+                error.message.includes("504");
+            if (!isRetryable && attempts.length === 1) {
+                throw error;
+            }
+        }
+    }
+    throw new FailoverError(attempts);
+}
+//# sourceMappingURL=registry.js.map

package/dist/llm/registry.js.map

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

package/dist/llm/thinking.d.ts

@@ -0,0 +1,7 @@
+export type ThinkingLevel = "off" | "low" | "medium" | "high";
+export declare function setThinkingLevel(level: ThinkingLevel): void;
+export declare function getThinkingLevel(): ThinkingLevel;
+export declare function getThinkingPrompt(): string;
+export declare function getExtendedThinkingBudget(): number | null;
+export declare function cycleThinkingLevel(): ThinkingLevel;
+//# sourceMappingURL=thinking.d.ts.map

package/dist/llm/thinking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thinking.d.ts","sourceRoot":"","sources":["../../src/llm/thinking.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAI9D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAE3D;AAED,wBAAgB,gBAAgB,IAAI,aAAa,CAEhD;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAW1C;AAED,wBAAgB,yBAAyB,IAAI,MAAM,GAAG,IAAI,CAOzD;AAED,wBAAgB,kBAAkB,IAAI,aAAa,CAKlD"}

package/dist/llm/thinking.js

@@ -0,0 +1,34 @@
+let currentLevel = "medium";
+export function setThinkingLevel(level) {
+    currentLevel = level;
+}
+export function getThinkingLevel() {
+    return currentLevel;
+}
+export function getThinkingPrompt() {
+    switch (currentLevel) {
+        case "off":
+            return "";
+        case "low":
+            return "\n\n## Thinking Mode: Brief\nThink briefly before responding. Keep internal reasoning short — 1-2 sentences max.";
+        case "medium":
+            return "\n\n## Thinking Mode: Moderate\nThink step-by-step before responding. Show your reasoning process clearly but concisely.";
+        case "high":
+            return "\n\n## Thinking Mode: Deep\nThink deeply and thoroughly before responding. Analyze the problem from multiple angles. Consider edge cases. Show complete reasoning chain. Take your time to arrive at the best answer.";
+    }
+}
+export function getExtendedThinkingBudget() {
+    switch (currentLevel) {
+        case "off": return null;
+        case "low": return 1024;
+        case "medium": return 4096;
+        case "high": return 16384;
+    }
+}
+export function cycleThinkingLevel() {
+    const levels = ["off", "low", "medium", "high"];
+    const idx = levels.indexOf(currentLevel);
+    currentLevel = levels[(idx + 1) % levels.length];
+    return currentLevel;
+}
+//# sourceMappingURL=thinking.js.map

package/dist/llm/thinking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thinking.js","sourceRoot":"","sources":["../../src/llm/thinking.ts"],"names":[],"mappings":"AAEA,IAAI,YAAY,GAAkB,QAAQ,CAAC;AAE3C,MAAM,UAAU,gBAAgB,CAAC,KAAoB;IACnD,YAAY,GAAG,KAAK,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,QAAQ,YAAY,EAAE,CAAC;QACrB,KAAK,KAAK;YACR,OAAO,EAAE,CAAC;QACZ,KAAK,KAAK;YACR,OAAO,kHAAkH,CAAC;QAC5H,KAAK,QAAQ;YACX,OAAO,0HAA0H,CAAC;QACpI,KAAK,MAAM;YACT,OAAO,uNAAuN,CAAC;IACnO,CAAC;AACH,CAAC;AAED,MAAM,UAAU,yBAAyB;IACvC,QAAQ,YAAY,EAAE,CAAC;QACrB,KAAK,KAAK,CAAC,CAAC,OAAO,IAAI,CAAC;QACxB,KAAK,KAAK,CAAC,CAAC,OAAO,IAAI,CAAC;QACxB,KAAK,QAAQ,CAAC,CAAC,OAAO,IAAI,CAAC;QAC3B,KAAK,MAAM,CAAC,CAAC,OAAO,KAAK,CAAC;IAC5B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,MAAM,MAAM,GAAoB,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IACjE,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACzC,YAAY,GAAG,MAAM,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IACjD,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/llm.d.ts

@@ -0,0 +1,17 @@
+import type { ConversationMessage } from "./llm/provider.js";
+import type { Tool } from "./tools/index.js";
+export type { ConversationMessage };
+export declare function chatCompletion(messages: ConversationMessage[], tools: Tool[]): Promise<{
+    content: string | null;
+    toolCalls?: {
+        id: string;
+        name: string;
+        arguments: string;
+    }[];
+}>;
+export declare function factExtraction(userMessage: string, assistantReply: string): Promise<{
+    content: string;
+    category: string;
+}[]>;
+export declare function summarizeConversation(transcript: string): Promise<string | null>;
+//# sourceMappingURL=llm.d.ts.map

package/dist/llm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../src/llm.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAkB,MAAM,mBAAmB,CAAC;AAE7E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AA2G7C,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAUpC,wBAAsB,cAAc,CAClC,QAAQ,EAAE,mBAAmB,EAAE,EAC/B,KAAK,EAAE,IAAI,EAAE,GACZ,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,SAAS,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,CAAC,CAyBpG;AAeD,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAkBlD;AAWD,wBAAsB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAYtF"}

package/dist/llm.js

@@ -0,0 +1,184 @@
+import { chatCompletion as registryChatCompletion } from "./llm/index.js";
+import { chatCompletionWithFailover } from "./llm/failover.js";
+import { getThinkingPrompt } from "./llm/thinking.js";
+import { config } from "./config.js";
+const SYSTEM_PROMPT = `You are CF Claw, a personal AI assistant running on Telegram.
+You are helpful, concise, and direct. Keep responses conversational and to the point.
+
+## Self-Improvement
+You are a self-improving agent. Every conversation makes you slightly better. You proactively learn from experience and save knowledge for future sessions.
+
+### Memory Guidance
+You have persistent memory across sessions. Save durable facts proactively — don't wait to be asked:
+- When the user corrects you or says "remember this" / "don't do that again"
+- When the user shares a preference, habit, or personal detail
+- When you discover tool quirks, environment details, or stable conventions
+- When you learn something about the user's workflow or projects
+Use the **remember** tool to save facts. Most facts are auto-extracted, but use remember for anything the auto-extraction might miss.
+
+### Skills Guidance
+You can create and improve skills — reusable procedures saved for future use:
+- After completing a **complex task** (5+ tool calls), fixing a **tricky error**, or discovering a **non-trivial workflow**, save the approach as a skill with **skill_create**
+- When using a skill and finding it **outdated, incomplete, or wrong**, patch it immediately with **skill_patch** — don't wait to be asked
+- Skills that aren't maintained become liabilities. Keep them accurate.
+- Use **skill_view** to load a skill's full instructions when you need to follow a procedure
+- Use **skill_list** to see what skills are available
+
+### Self-Improve Principles
+- Every complex task is a learning opportunity
+- Patterns you discover should be saved as skills
+- User corrections are the most valuable training signal — always save them
+- When you solve a problem creatively, capture the approach
+- Review and update your skills when you find better approaches
+
+## Memory System
+You have a sophisticated 3-tier memory system:
+
+1. **Core Facts** — Your persistent knowledge about the user is automatically loaded into context. You don't need to search for these.
+2. **Summaries** — Past conversation summaries are loaded for broad context.
+3. **Semantic Search** — Relevant past conversations and facts are automatically retrieved based on what the user says.
+
+### Memory Tools
+- **remember**: Manually save a specific fact if the auto-extraction might miss it. Use sparingly — most facts are auto-extracted.
+- **recall**: Search past conversations and facts when you need specific details. Uses hybrid keyword + semantic search.
+- **forget**: Delete an outdated or incorrect fact. Use recall first to find the ID.
+- **search_conversations**: Deep search through full conversation history.
+
+Your memory auto-extracts important facts after each conversation turn. You should feel like you never forget anything.
+
+## Knowledge Graph
+You have access to a knowledge graph for tracking entities and their relationships.
+- **knowledge_add**: Add entities and relationships to the knowledge graph.
+- **knowledge_query**: Search and traverse the knowledge graph.
+
+## Agent Sessions (A2A)
+You can spawn isolated sub-agent sessions for parallel tasks:
+- **sessions_create**: Create a new session with optional system prompt.
+- **sessions_list**: List all active sessions.
+- **sessions_history**: Get conversation history of a session.
+- **sessions_send**: Send a message to a session and get its response.
+- **sessions_delete**: Delete a session.
+
+## Live Canvas
+You can push interactive widgets to the WebChat UI:
+- **canvas_render**: Push HTML/JS widgets, tables, charts, or forms.
+
+## Document Store
+You can save, read, search, and manage documents:
+- **doc_save**: Save a document (markdown or HTML) with title, category, and tags.
+- **doc_list**: List documents, optionally filtered by category.
+- **doc_read**: Read a document's content by ID.
+- **doc_delete**: Delete a document by ID.
+- **doc_search**: Search documents by semantic similarity and keywords.
+
+## Agent Registry
+There are specialized agents available for different tasks. You can list, inspect, and create agents:
+- **agent_list**: List all agents or filter by team.
+- **agent_show**: Show details of a specific agent.
+- **agent_create**: Create a new custom agent with role, system prompt, tools, and rules.
+- **agent_delete**: Delete a custom agent (built-in agents cannot be deleted).
+
+Teams: content, strategy, design, development, quality, operations, support.
+
+## Autonomy Principles
+You are empowered to make decisions and take action autonomously. Follow these guidelines:
+
+### Proactive Action
+- **Take action without asking for confirmation** for routine tasks (file operations, git commands, running scripts, npm commands, etc.)
+- When the user's intent is clear, execute it directly without unnecessary back-and-forth
+- Only ask for confirmation when the user explicitly asks "should I..." or the operation is truly destructive
+
+### Decision Making
+- **Make decisions autonomously** for standard operations within your allowed tools
+- If something is safe and obviously needed to complete the task, just do it
+- When you encounter fixable errors, fix them and continue rather than stopping to ask
+
+### Escalation
+Only escalate to the user for:
+- Truly consequential decisions (major system changes, deleting important data)
+- Operations that are irreversible and significant
+- When you genuinely don't understand what the user wants
+
+### Shell Commands
+The shell has a pre-approved allowlist. Commands in the allowlist execute automatically without asking:
+- ls, cat, head, tail, pwd, date, echo, whoami, git, npm, mkdir, cd, and more
+- Unknown commands require explicit confirmation (unless YOLO mode is enabled)
+- When confirmation is needed and the user approves, the command runs automatically
+
+Be decisive. When you know what to do, do it.`;
+function toolsToDefinitions(tools) {
+    return tools.map((t) => ({
+        name: t.name,
+        description: t.description,
+        parameters: t.input_schema,
+    }));
+}
+export async function chatCompletion(messages, tools) {
+    const thinkingPrompt = getThinkingPrompt();
+    const systemContent = SYSTEM_PROMPT + thinkingPrompt;
+    const fullMessages = [
+        { role: "system", content: systemContent },
+        ...messages,
+    ];
+    const toolDefs = toolsToDefinitions(tools);
+    if (config.failoverChain.length > 0) {
+        const result = await chatCompletionWithFailover({ messages: fullMessages, tools: toolDefs }, config.failoverChain);
+        return result;
+    }
+    const result = await registryChatCompletion({
+        messages: fullMessages,
+        tools: toolDefs,
+    });
+    return result;
+}
+const FACT_EXTRACTION_PROMPT = `Analyze this conversation turn and extract any important facts worth remembering long-term.
+Return a JSON array of facts. Each fact should have:
+- "content": a clear, self-contained statement
+- "category": one of "preference", "personal", "decision", "project", "technical", "relationship", "general"
+
+Only extract genuinely useful, non-obvious facts. If nothing worth remembering, return an empty array [].
+Do NOT extract greetings, small talk, or transient information.
+
+User said: {user_message}
+Assistant replied: {assistant_reply}
+
+Return ONLY the JSON array, nothing else.`;
+export async function factExtraction(userMessage, assistantReply) {
+    try {
+        const prompt = FACT_EXTRACTION_PROMPT
+            .replace("{user_message}", userMessage)
+            .replace("{assistant_reply}", assistantReply);
+        const result = await registryChatCompletion({
+            messages: [{ role: "user", content: prompt }],
+        });
+        const text = result.content?.trim() || "[]";
+        const jsonMatch = text.match(/\[[\s\S]*\]/);
+        if (!jsonMatch)
+            return [];
+        return JSON.parse(jsonMatch[0]);
+    }
+    catch {
+        return [];
+    }
+}
+const SUMMARIZE_PROMPT = `Summarize this conversation segment into a concise paragraph (2-4 sentences). 
+Capture the key topics discussed, decisions made, and any important context.
+Do NOT include greetings or filler. Focus on substance.
+
+Conversation:
+{transcript}
+
+Return ONLY the summary paragraph, nothing else.`;
+export async function summarizeConversation(transcript) {
+    try {
+        const prompt = SUMMARIZE_PROMPT.replace("{transcript}", transcript);
+        const result = await registryChatCompletion({
+            messages: [{ role: "user", content: prompt }],
+        });
+        return result.content?.trim() || null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=llm.js.map

package/dist/llm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.js","sourceRoot":"","sources":["../src/llm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,IAAI,sBAAsB,EAAkB,MAAM,gBAAgB,CAAC;AAC1F,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8CAuGwB,CAAC;AAI/C,SAAS,kBAAkB,CAAC,KAAa;IACvC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACvB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,UAAU,EAAE,CAAC,CAAC,YAAY;KAC3B,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,QAA+B,EAC/B,KAAa;IAEb,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAC;IAC3C,MAAM,aAAa,GAAG,aAAa,GAAG,cAAc,CAAC;IAErD,MAAM,YAAY,GAA0B;QAC1C,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE;QAC1C,GAAG,QAAQ;KACZ,CAAC;IAEF,MAAM,QAAQ,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAE3C,IAAI,MAAM,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,MAAM,0BAA0B,CAC7C,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,EAC3C,MAAM,CAAC,aAAa,CACrB,CAAC;QACF,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC;QAC1C,QAAQ,EAAE,YAAY;QACtB,KAAK,EAAE,QAAQ;KAChB,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,sBAAsB,GAAG;;;;;;;;;;;0CAWW,CAAC;AAE3C,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,WAAmB,EACnB,cAAsB;IAEtB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,sBAAsB;aAClC,OAAO,CAAC,gBAAgB,EAAE,WAAW,CAAC;aACtC,OAAO,CAAC,mBAAmB,EAAE,cAAc,CAAC,CAAC;QAEhD,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC;YAC1C,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;SAC9C,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC;QAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAC5C,IAAI,CAAC,SAAS;YAAE,OAAO,EAAE,CAAC;QAE1B,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,gBAAgB,GAAG;;;;;;;iDAOwB,CAAC;AAElD,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,UAAkB;IAC5D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;QAEpE,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC;YAC1C,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;SAC9C,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/logs.d.ts

@@ -0,0 +1,11 @@
+type LogEntry = {
+    id: number;
+    time: string;
+    source: string;
+    msg: string;
+};
+export declare function addLog(msg: string): void;
+export declare function getLogs(limit?: number, offset?: number): LogEntry[];
+export declare function onLog(listener: (entry: LogEntry) => void): () => void;
+export {};
+//# sourceMappingURL=logs.d.ts.map

package/dist/logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../src/logs.ts"],"names":[],"mappings":"AAAA,KAAK,QAAQ,GAAG;IACd,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAsBF,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAYxC;AAED,wBAAgB,OAAO,CAAC,KAAK,GAAE,MAAY,EAAE,MAAM,GAAE,MAAU,GAAG,QAAQ,EAAE,CAE3E;AAED,wBAAgB,KAAK,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,GAAG,MAAM,IAAI,CAGrE"}

package/dist/logs.js

@@ -0,0 +1,54 @@
+const MAX_LOGS = 500;
+const logs = [];
+let logIdCounter = 0;
+const listeners = new Set();
+function parseSource(msg) {
+    if (msg.includes("⏰"))
+        return "Scheduler";
+    if (msg.includes("🕸️") || msg.includes("Mesh"))
+        return "Mesh";
+    if (msg.includes("🐝") || msg.includes("Swarm"))
+        return "Swarm";
+    if (msg.includes("🌐"))
+        return "WebChat";
+    if (msg.includes("🔔"))
+        return "Webhooks";
+    if (msg.includes("📋"))
+        return "Agents";
+    if (msg.includes("🔄") || msg.includes("Model"))
+        return "LLM";
+    if (msg.includes("⌨️"))
+        return "Command";
+    if (msg.includes("🤖") || msg.includes("Claw"))
+        return "Agent";
+    if (msg.includes("📂"))
+        return "Files";
+    if (msg.includes("❌") || msg.includes("error"))
+        return "Error";
+    return "Core";
+}
+export function addLog(msg) {
+    const entry = {
+        id: ++logIdCounter,
+        time: new Date().toLocaleTimeString("sv-SE"),
+        source: parseSource(msg),
+        msg: msg.replace(/[\u001b\u009b][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]/g, "").trim(),
+    };
+    logs.push(entry);
+    if (logs.length > MAX_LOGS)
+        logs.shift();
+    for (const listener of listeners) {
+        try {
+            listener(entry);
+        }
+        catch { }
+    }
+}
+export function getLogs(limit = 100, offset = 0) {
+    return logs.slice(-(limit + offset)).slice(offset);
+}
+export function onLog(listener) {
+    listeners.add(listener);
+    return () => listeners.delete(listener);
+}
+//# sourceMappingURL=logs.js.map

package/dist/logs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.js","sourceRoot":"","sources":["../src/logs.ts"],"names":[],"mappings":"AAOA,MAAM,QAAQ,GAAG,GAAG,CAAC;AACrB,MAAM,IAAI,GAAe,EAAE,CAAC;AAC5B,IAAI,YAAY,GAAG,CAAC,CAAC;AACrB,MAAM,SAAS,GAAmC,IAAI,GAAG,EAAE,CAAC;AAE5D,SAAS,WAAW,CAAC,GAAW;IAC9B,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,WAAW,CAAC;IAC1C,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IAC/D,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IAChE,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACzC,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,UAAU,CAAC;IAC1C,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,QAAQ,CAAC;IACxC,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9D,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACzC,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,OAAO,CAAC;IAC/D,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,OAAO,CAAC;IACvC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IAC/D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,GAAW;IAChC,MAAM,KAAK,GAAa;QACtB,EAAE,EAAE,EAAE,YAAY;QAClB,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,kBAAkB,CAAC,OAAO,CAAC;QAC5C,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC;QACxB,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,6EAA6E,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE;KAC3G,CAAC;IACF,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjB,IAAI,IAAI,CAAC,MAAM,GAAG,QAAQ;QAAE,IAAI,CAAC,KAAK,EAAE,CAAC;IACzC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,CAAC;YAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACnC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,QAAgB,GAAG,EAAE,SAAiB,CAAC;IAC7D,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,QAAmC;IACvD,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACxB,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAC1C,CAAC"}

package/dist/memory/knowledge-graph.d.ts

@@ -0,0 +1,34 @@
+export interface KGEntity {
+    id: number;
+    name: string;
+    type: string;
+    properties: Record<string, unknown>;
+}
+export interface KGRelation {
+    id: number;
+    relation_type: string;
+    properties: Record<string, unknown>;
+    target_name?: string;
+    target_type?: string;
+    source_name?: string;
+    source_type?: string;
+}
+export declare function addEntity(name: string, type?: string, properties?: Record<string, unknown>): Promise<KGEntity>;
+export declare function addRelation(fromName: string, toName: string, relationType: string, properties?: Record<string, unknown>): Promise<{
+    id: number;
+} | null>;
+export declare function getEntity(name: string): KGEntity | null;
+export declare function searchEntities(query: string, limit?: number): KGEntity[];
+export declare function getEntityRelations(name: string): {
+    outgoing: KGRelation[];
+    incoming: KGRelation[];
+};
+export declare function traverseGraph(startName: string, maxDepth?: number): {
+    entities: KGEntity[];
+    relations: {
+        from: string;
+        to: string;
+        type: string;
+    }[];
+};
+//# sourceMappingURL=knowledge-graph.d.ts.map

package/dist/memory/knowledge-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-graph.d.ts","sourceRoot":"","sources":["../../src/memory/knowledge-graph.ts"],"names":[],"mappings":"AAwEA,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,SAAS,CAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,MAAgB,EACtB,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACvC,OAAO,CAAC,QAAQ,CAAC,CAoBnB;AAED,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACvC,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAUhC;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAIvD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,QAAQ,EAAE,CAG5E;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;IAAC,QAAQ,EAAE,UAAU,EAAE,CAAA;CAAE,CAuBnG;AAED,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,MAAU,GACnB;IAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;IAAC,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,CA0BnF"}

package/dist/memory/knowledge-graph.js

@@ -0,0 +1,137 @@
+import Database from "better-sqlite3";
+import * as sqliteVec from "sqlite-vec";
+import path from "node:path";
+import fs from "node:fs";
+import { embed, vecToBuffer, EMBEDDING_DIM } from "../embeddings.js";
+import { getDataDir } from "../paths.js";
+const DATA_DIR = getDataDir();
+fs.mkdirSync(DATA_DIR, { recursive: true });
+const dbPath = path.join(DATA_DIR, "cf-claw.db");
+const db = new Database(dbPath);
+db.pragma("journal_mode = WAL");
+sqliteVec.load(db);
+db.exec(`
+  CREATE TABLE IF NOT EXISTS kg_entities (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    name TEXT NOT NULL UNIQUE,
+    type TEXT DEFAULT 'thing',
+    properties TEXT DEFAULT '{}',
+    embedding BLOB,
+    created_at TEXT NOT NULL DEFAULT (datetime('now')),
+    updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+  );
+
+  CREATE VIRTUAL TABLE IF NOT EXISTS kg_entities_vec USING vec0(
+    embedding float[${EMBEDDING_DIM}]
+  );
+
+  CREATE TABLE IF NOT EXISTS kg_relations (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    from_entity_id INTEGER NOT NULL,
+    to_entity_id INTEGER NOT NULL,
+    relation_type TEXT NOT NULL,
+    properties TEXT DEFAULT '{}',
+    created_at TEXT NOT NULL DEFAULT (datetime('now')),
+    FOREIGN KEY (from_entity_id) REFERENCES kg_entities(id),
+    FOREIGN KEY (to_entity_id) REFERENCES kg_entities(id)
+  );
+
+  CREATE INDEX IF NOT EXISTS idx_kg_relations_from ON kg_relations(from_entity_id);
+  CREATE INDEX IF NOT EXISTS idx_kg_relations_to ON kg_relations(to_entity_id);
+  CREATE INDEX IF NOT EXISTS idx_kg_relations_type ON kg_relations(relation_type);
+`);
+const insertEntity = db.prepare("INSERT OR REPLACE INTO kg_entities (name, type, properties, embedding, updated_at) VALUES (?, ?, ?, ?, datetime('now'))");
+const insertEntityVec = db.prepare("INSERT OR REPLACE INTO kg_entities_vec (rowid, embedding) VALUES (?, ?)");
+const getEntityByName = db.prepare("SELECT id, name, type, properties FROM kg_entities WHERE name = ?");
+const getEntityById = db.prepare("SELECT id, name, type, properties FROM kg_entities WHERE id = ?");
+const insertRelation = db.prepare("INSERT INTO kg_relations (from_entity_id, to_entity_id, relation_type, properties) VALUES (?, ?, ?, ?)");
+const getRelationsFrom = db.prepare("SELECT r.id, r.relation_type, r.properties, e.name as to_name, e.type as to_type FROM kg_relations r JOIN kg_entities e ON r.to_entity_id = e.id WHERE r.from_entity_id = ?");
+const getRelationsTo = db.prepare("SELECT r.id, r.relation_type, r.properties, e.name as from_name, e.type as from_type FROM kg_relations r JOIN kg_entities e ON r.from_entity_id = e.id WHERE r.to_entity_id = ?");
+const searchEntitiesStmt = db.prepare("SELECT id, name, type, properties FROM kg_entities WHERE name LIKE ? LIMIT ?");
+export async function addEntity(name, type = "thing", properties = {}) {
+    const vec = await embed(name);
+    const buf = vecToBuffer(vec);
+    const propsJson = JSON.stringify(properties);
+    const existing = getEntityByName.get(name);
+    if (existing) {
+        const merged = { ...JSON.parse(existing.properties || "{}"), ...properties };
+        insertEntity.run(name, type, JSON.stringify(merged), buf);
+        const updated = getEntityByName.get(name);
+        insertEntityVec.run(BigInt(updated.id), buf);
+        updated.properties = merged;
+        return updated;
+    }
+    insertEntity.run(name, type, propsJson, buf);
+    const entity = getEntityByName.get(name);
+    insertEntityVec.run(BigInt(entity.id), buf);
+    entity.properties = properties;
+    return entity;
+}
+export async function addRelation(fromName, toName, relationType, properties = {}) {
+    const from = getEntityByName.get(fromName);
+    const to = getEntityByName.get(toName);
+    if (!from || !to) {
+        return null;
+    }
+    const result = insertRelation.run(from.id, to.id, relationType, JSON.stringify(properties));
+    return { id: Number(result.lastInsertRowid) };
+}
+export function getEntity(name) {
+    const row = getEntityByName.get(name);
+    if (!row)
+        return null;
+    return { ...row, properties: JSON.parse(row.properties || "{}") };
+}
+export function searchEntities(query, limit = 10) {
+    const rows = searchEntitiesStmt.all(`%${query}%`, limit);
+    return rows.map((r) => ({ ...r, properties: JSON.parse(r.properties || "{}") }));
+}
+export function getEntityRelations(name) {
+    const entity = getEntityByName.get(name);
+    if (!entity)
+        return { outgoing: [], incoming: [] };
+    const outgoing = getRelationsFrom.all(entity.id);
+    const incoming = getRelationsTo.all(entity.id);
+    return {
+        outgoing: outgoing.map((r) => ({
+            id: r.id,
+            relation_type: r.relation_type,
+            properties: JSON.parse(r.properties || "{}"),
+            target_name: r.to_name,
+            target_type: r.to_type,
+        })),
+        incoming: incoming.map((r) => ({
+            id: r.id,
+            relation_type: r.relation_type,
+            properties: JSON.parse(r.properties || "{}"),
+            source_name: r.from_name,
+            source_type: r.from_type,
+        })),
+    };
+}
+export function traverseGraph(startName, maxDepth = 3) {
+    const visited = new Set();
+    const entities = [];
+    const relations = [];
+    function dfs(entityId, depth) {
+        if (depth > maxDepth || visited.has(entityId))
+            return;
+        visited.add(entityId);
+        const entity = getEntityById.get(entityId);
+        if (!entity)
+            return;
+        entities.push({ ...entity, properties: JSON.parse(entity.properties || "{}") });
+        const outgoing = getRelationsFrom.all(entityId);
+        for (const rel of outgoing) {
+            relations.push({ from: entity.name, to: rel.to_name, type: rel.relation_type });
+            dfs(rel.to_entity_id, depth + 1);
+        }
+    }
+    const start = getEntityByName.get(startName);
+    if (start) {
+        dfs(start.id, 0);
+    }
+    return { entities, relations };
+}
+process.on("exit", () => { });
+//# sourceMappingURL=knowledge-graph.js.map

package/dist/memory/knowledge-graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-graph.js","sourceRoot":"","sources":["../../src/memory/knowledge-graph.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,SAAS,MAAM,YAAY,CAAC;AACxC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,QAAQ,GAAG,UAAU,EAAE,CAAC;AAC9B,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAE5C,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;AACjD,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;AAEhC,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;AAChC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAEnB,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;sBAYc,aAAa;;;;;;;;;;;;;;;;;CAiBlC,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,EAAE,CAAC,OAAO,CAC7B,yHAAyH,CAC1H,CAAC;AACF,MAAM,eAAe,GAAG,EAAE,CAAC,OAAO,CAChC,yEAAyE,CAC1E,CAAC;AACF,MAAM,eAAe,GAAG,EAAE,CAAC,OAAO,CAChC,mEAAmE,CACpE,CAAC;AACF,MAAM,aAAa,GAAG,EAAE,CAAC,OAAO,CAC9B,iEAAiE,CAClE,CAAC;AACF,MAAM,cAAc,GAAG,EAAE,CAAC,OAAO,CAC/B,wGAAwG,CACzG,CAAC;AACF,MAAM,gBAAgB,GAAG,EAAE,CAAC,OAAO,CACjC,6KAA6K,CAC9K,CAAC;AACF,MAAM,cAAc,GAAG,EAAE,CAAC,OAAO,CAC/B,iLAAiL,CAClL,CAAC;AACF,MAAM,kBAAkB,GAAG,EAAE,CAAC,OAAO,CACnC,8EAA8E,CAC/E,CAAC;AAmBF,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,IAAY,EACZ,OAAe,OAAO,EACtB,aAAsC,EAAE;IAExC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IAE7C,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,IAAI,CAAyB,CAAC;IACnE,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,UAA+B,IAAI,IAAI,CAAC,EAAE,GAAG,UAAU,EAAE,CAAC;QAClG,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC;QAC1D,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,CAAC,IAAI,CAAa,CAAC;QACtD,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;QAC7C,OAAO,CAAC,UAAU,GAAG,MAAM,CAAC;QAC5B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,IAAI,CAAa,CAAC;IACrD,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;IAC5C,MAAM,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,QAAgB,EAChB,MAAc,EACd,YAAoB,EACpB,aAAsC,EAAE;IAExC,MAAM,IAAI,GAAG,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAyB,CAAC;IACnE,MAAM,EAAE,GAAG,eAAe,CAAC,GAAG,CAAC,MAAM,CAAyB,CAAC;IAE/D,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;IAC5F,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,IAAI,CAAoD,CAAC;IACzF,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,OAAO,EAAE,GAAG,GAAG,EAAE,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,EAAE,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,QAAgB,EAAE;IAC9D,MAAM,IAAI,GAAG,kBAAkB,CAAC,GAAG,CAAC,IAAI,KAAK,GAAG,EAAE,KAAK,CAA0C,CAAC;IAClG,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;AACnF,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,IAAI,CAAyB,CAAC;IACjE,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAEnD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAA8E,CAAC;IAC9H,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAkF,CAAC;IAEhI,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7B,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,aAAa,EAAE,CAAC,CAAC,aAAa;YAC9B,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,IAAI,IAAI,CAAC;YAC5C,WAAW,EAAE,CAAC,CAAC,OAAO;YACtB,WAAW,EAAE,CAAC,CAAC,OAAO;SACvB,CAAC,CAAC;QACH,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7B,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,aAAa,EAAE,CAAC,CAAC,aAAa;YAC9B,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,IAAI,IAAI,CAAC;YAC5C,WAAW,EAAE,CAAC,CAAC,SAAS;YACxB,WAAW,EAAE,CAAC,CAAC,SAAS;SACzB,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,SAAiB,EACjB,WAAmB,CAAC;IAEpB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,QAAQ,GAAe,EAAE,CAAC;IAChC,MAAM,SAAS,GAAiD,EAAE,CAAC;IAEnE,SAAS,GAAG,CAAC,QAAgB,EAAE,KAAa;QAC1C,IAAI,KAAK,GAAG,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,OAAO;QACtD,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAEtB,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAoD,CAAC;QAC9F,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC;QAEhF,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAuE,CAAC;QACtH,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC;YAChF,GAAG,CAAC,GAAG,CAAC,YAAY,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG,eAAe,CAAC,GAAG,CAAC,SAAS,CAAyB,CAAC;IACrE,IAAI,KAAK,EAAE,CAAC;QACV,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IACnB,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;AACjC,CAAC;AAED,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC"}