cf-claw 3.0.0

package/dist/sessions.js

@@ -0,0 +1,176 @@
+import Database from "better-sqlite3";
+import path from "node:path";
+import fs from "node:fs";
+import { chatCompletion } from "./llm.js";
+import { tools, getTool } from "./tools/index.js";
+import { getActiveModel } from "./llm/index.js";
+import { logUsage, estimateCost } from "./usage.js";
+import { getDataDir } from "./paths.js";
+const DATA_DIR = getDataDir();
+fs.mkdirSync(DATA_DIR, { recursive: true });
+const DB_PATH = path.join(DATA_DIR, "cf-claw.db");
+const db = new Database(DB_PATH);
+db.exec(`
+  CREATE TABLE IF NOT EXISTS agent_sessions (
+    id TEXT PRIMARY KEY,
+    name TEXT NOT NULL,
+    system_prompt TEXT,
+    created_at TEXT NOT NULL DEFAULT (datetime('now')),
+    last_active TEXT NOT NULL DEFAULT (datetime('now'))
+  );
+
+  CREATE TABLE IF NOT EXISTS agent_session_messages (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    session_id TEXT NOT NULL,
+    role TEXT NOT NULL CHECK(role IN ('user', 'assistant', 'tool')),
+    content TEXT NOT NULL,
+    tool_calls TEXT,
+    tool_call_id TEXT,
+    created_at TEXT NOT NULL DEFAULT (datetime('now')),
+    FOREIGN KEY (session_id) REFERENCES agent_sessions(id)
+  );
+`);
+const insertSession = db.prepare("INSERT INTO agent_sessions (id, name, system_prompt) VALUES (?, ?, ?)");
+const getAllSessions = db.prepare("SELECT id, name, system_prompt, created_at, last_active FROM agent_sessions ORDER BY last_active DESC");
+const getSession = db.prepare("SELECT id, name, system_prompt, created_at, last_active FROM agent_sessions WHERE id = ?");
+const deleteSessionStmt = db.prepare("DELETE FROM agent_sessions WHERE id = ?");
+const deleteSessionMsgs = db.prepare("DELETE FROM agent_session_messages WHERE session_id = ?");
+const insertMsg = db.prepare("INSERT INTO agent_session_messages (session_id, role, content, tool_calls, tool_call_id) VALUES (?, ?, ?, ?, ?)");
+const getSessionMsgs = db.prepare("SELECT role, content, tool_calls, tool_call_id FROM agent_session_messages WHERE session_id = ? ORDER BY id ASC LIMIT ?");
+const updateLastActive = db.prepare("UPDATE agent_sessions SET last_active = datetime('now') WHERE id = ?");
+export function sessionsCreate(name, systemPrompt) {
+    const id = `sess_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+    insertSession.run(id, name, systemPrompt || null);
+    return {
+        id,
+        name,
+        systemPrompt: systemPrompt || undefined,
+        createdAt: new Date().toISOString(),
+        lastActive: new Date().toISOString(),
+    };
+}
+export function sessionsList() {
+    const rows = getAllSessions.all();
+    return rows.map((r) => ({
+        id: r.id,
+        name: r.name,
+        systemPrompt: r.system_prompt || undefined,
+        createdAt: r.created_at,
+        lastActive: r.last_active,
+    }));
+}
+export function sessionsHistory(sessionId, limit = 20) {
+    const rows = getSessionMsgs.all(sessionId, limit);
+    return rows.map((r) => ({
+        role: r.role,
+        content: r.content,
+        toolCalls: r.tool_calls || undefined,
+        toolCallId: r.tool_call_id || undefined,
+    }));
+}
+export function sessionsDelete(sessionId) {
+    deleteSessionMsgs.run(sessionId);
+    const result = deleteSessionStmt.run(sessionId);
+    return result.changes > 0;
+}
+export async function sessionsSend(sessionId, message) {
+    const session = getSession.get(sessionId);
+    if (!session) {
+        return `Error: Session "${sessionId}" not found. Use sessions_list to see available sessions.`;
+    }
+    insertMsg.run(sessionId, "user", message, null, null);
+    updateLastActive.run(sessionId);
+    const historyRows = getSessionMsgs.all(sessionId, 50);
+    const messages = [];
+    if (session.system_prompt) {
+        messages.push({ role: "system", content: session.system_prompt });
+    }
+    for (const row of historyRows) {
+        const msg = { role: row.role, content: row.content };
+        if (row.tool_calls) {
+            msg.tool_calls = JSON.parse(row.tool_calls);
+        }
+        if (row.tool_call_id) {
+            msg.tool_call_id = row.tool_call_id;
+        }
+        messages.push(msg);
+    }
+    const startTime = Date.now();
+    const response = await chatCompletion(messages, tools);
+    const latency = Date.now() - startTime;
+    const usage = response.usage;
+    if (usage) {
+        logUsage({
+            model: getActiveModel(),
+            promptTokens: usage.promptTokens ?? 0,
+            completionTokens: usage.completionTokens ?? 0,
+            totalTokens: (usage.promptTokens ?? 0) + (usage.completionTokens ?? 0),
+            costUsd: estimateCost(getActiveModel(), usage.promptTokens ?? 0, usage.completionTokens ?? 0),
+            latencyMs: latency,
+            toolCalls: 0,
+            source: "session",
+        });
+    }
+    const toolCalls = response.toolCalls;
+    if (!toolCalls || toolCalls.length === 0) {
+        const reply = response.content || "(no response)";
+        insertMsg.run(sessionId, "assistant", reply, null, null);
+        return reply;
+    }
+    const assistantToolCalls = toolCalls.map((tc) => ({
+        id: tc.id,
+        function: { name: tc.name, arguments: tc.arguments },
+    }));
+    insertMsg.run(sessionId, "assistant", response.content || "", JSON.stringify(assistantToolCalls), null);
+    for (const tc of toolCalls) {
+        const tool = getTool(tc.name);
+        if (!tool) {
+            insertMsg.run(sessionId, "tool", `Unknown tool: ${tc.name}`, null, tc.id);
+            continue;
+        }
+        try {
+            const args = JSON.parse(tc.arguments);
+            const result = await tool.execute(args);
+            insertMsg.run(sessionId, "tool", result, null, tc.id);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            insertMsg.run(sessionId, "tool", `Error: ${msg}`, null, tc.id);
+        }
+    }
+    const newHistory = getSessionMsgs.all(sessionId, 60);
+    const newMessages = [];
+    if (session.system_prompt) {
+        newMessages.push({ role: "system", content: session.system_prompt });
+    }
+    for (const row of newHistory) {
+        const m = { role: row.role, content: row.content };
+        if (row.tool_calls)
+            m.tool_calls = JSON.parse(row.tool_calls);
+        if (row.tool_call_id)
+            m.tool_call_id = row.tool_call_id;
+        newMessages.push(m);
+    }
+    const followUpStart = Date.now();
+    const followUp = await chatCompletion(newMessages, tools);
+    const followUpLatency = Date.now() - followUpStart;
+    const fUsage = followUp.usage;
+    if (fUsage) {
+        logUsage({
+            model: getActiveModel(),
+            promptTokens: fUsage.promptTokens ?? 0,
+            completionTokens: fUsage.completionTokens ?? 0,
+            totalTokens: (fUsage.promptTokens ?? 0) + (fUsage.completionTokens ?? 0),
+            costUsd: estimateCost(getActiveModel(), fUsage.promptTokens ?? 0, fUsage.completionTokens ?? 0),
+            latencyMs: followUpLatency,
+            toolCalls: toolCalls.length,
+            source: "session",
+        });
+    }
+    const reply = followUp.content || "(no response)";
+    insertMsg.run(sessionId, "assistant", reply, null, null);
+    updateLastActive.run(sessionId);
+    return reply;
+}
+process.on("exit", () => db.close());
+//# sourceMappingURL=sessions.js.map

package/dist/sessions.js.map

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

package/dist/skills/index.d.ts

@@ -0,0 +1,14 @@
+export interface Skill {
+    name: string;
+    description: string;
+    instructions: string;
+    filename: string;
+    source: "manual" | "agent";
+}
+export declare function loadSkills(): void;
+export declare function reloadSkills(): void;
+export declare function listLoadedSkills(): Skill[];
+export declare function getSkillsIndex(): string;
+export declare function getSkillsContext(): string;
+export declare function getSkillByName(name: string): Skill | undefined;
+//# sourceMappingURL=index.d.ts.map

package/dist/skills/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC;CAC5B;AA6ED,wBAAgB,UAAU,IAAI,IAAI,CA8BjC;AAED,wBAAgB,YAAY,IAAI,IAAI,CAEnC;AAED,wBAAgB,gBAAgB,IAAI,KAAK,EAAE,CAE1C;AAED,wBAAgB,cAAc,IAAI,MAAM,CAQvC;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAQzC;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAK9D"}

package/dist/skills/index.js

@@ -0,0 +1,126 @@
+import fs from "node:fs";
+import path from "node:path";
+import { getSkillsDir, getAgentSkillsDir } from "../paths.js";
+const MANUAL_SKILLS_DIR = getSkillsDir();
+const AGENT_SKILLS_DIR = getAgentSkillsDir();
+const loadedSkills = [];
+let cacheValid = false;
+function parseManualSkill(filePath, filename) {
+    try {
+        const content = fs.readFileSync(filePath, "utf-8");
+        const lines = content.split("\n");
+        let name = filename.replace(/\.md$/i, "");
+        let description = "";
+        let instructionsStart = 0;
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i].trim();
+            if (line.startsWith("# ")) {
+                name = line.replace(/^#\s+/, "").trim();
+                continue;
+            }
+            if (line.toLowerCase().startsWith("description:") || line.toLowerCase().startsWith("desc:")) {
+                description = line.replace(/^(description|desc):\s*/i, "").trim();
+                continue;
+            }
+            if (line.startsWith("---")) {
+                instructionsStart = i + 1;
+                break;
+            }
+            if (line.length > 0 && !line.startsWith("#") && !description) {
+                description = line;
+                instructionsStart = i + 1;
+                break;
+            }
+        }
+        const instructions = lines.slice(instructionsStart).join("\n").trim();
+        if (!instructions)
+            return null;
+        return { name, description: description || name, instructions, filename, source: "manual" };
+    }
+    catch {
+        return null;
+    }
+}
+function parseAgentSkill(dirPath, dirName) {
+    try {
+        const skillFile = path.join(dirPath, "SKILL.md");
+        if (!fs.existsSync(skillFile))
+            return null;
+        const content = fs.readFileSync(skillFile, "utf-8");
+        const fmMatch = content.match(/^---\n([\s\S]*?)\n---\n?/);
+        let description = dirName;
+        let name = dirName;
+        if (fmMatch) {
+            const descMatch = fmMatch[1].match(/description:\s*(.+)/);
+            if (descMatch)
+                description = descMatch[1].trim();
+            const nameMatch = fmMatch[1].match(/name:\s*(.+)/);
+            if (nameMatch)
+                name = nameMatch[1].trim();
+        }
+        const instructions = fmMatch
+            ? content.slice(fmMatch[0].length).trim()
+            : content.trim();
+        if (!instructions)
+            return null;
+        return { name, description, instructions, filename: `${dirName}/SKILL.md`, source: "agent" };
+    }
+    catch {
+        return null;
+    }
+}
+export function loadSkills() {
+    loadedSkills.length = 0;
+    cacheValid = false;
+    if (!fs.existsSync(MANUAL_SKILLS_DIR)) {
+        fs.mkdirSync(MANUAL_SKILLS_DIR, { recursive: true });
+    }
+    else {
+        const files = fs.readdirSync(MANUAL_SKILLS_DIR).filter((f) => f.endsWith(".md"));
+        for (const file of files) {
+            const skill = parseManualSkill(path.join(MANUAL_SKILLS_DIR, file), file);
+            if (skill)
+                loadedSkills.push(skill);
+        }
+    }
+    if (fs.existsSync(AGENT_SKILLS_DIR)) {
+        try {
+            const entries = fs.readdirSync(AGENT_SKILLS_DIR, { withFileTypes: true });
+            for (const entry of entries) {
+                if (!entry.isDirectory())
+                    continue;
+                const skill = parseAgentSkill(path.join(AGENT_SKILLS_DIR, entry.name), entry.name);
+                if (skill)
+                    loadedSkills.push(skill);
+            }
+        }
+        catch { }
+    }
+    cacheValid = true;
+    if (loadedSkills.length > 0) {
+        console.log(`📖 ${loadedSkills.length} skill(s) loaded (${loadedSkills.filter((s) => s.source === "manual").length} manual, ${loadedSkills.filter((s) => s.source === "agent").length} agent)`);
+    }
+}
+export function reloadSkills() {
+    loadSkills();
+}
+export function listLoadedSkills() {
+    return loadedSkills;
+}
+export function getSkillsIndex() {
+    if (loadedSkills.length === 0)
+        return "";
+    const parts = loadedSkills.map((s) => `- **${s.name}**: ${s.description} [${s.source}]`);
+    return `## Available Skills\nUse skill_view to load a skill's full instructions.\n\n${parts.join("\n")}`;
+}
+export function getSkillsContext() {
+    if (loadedSkills.length === 0)
+        return "";
+    const parts = loadedSkills.map((s) => `### Skill: ${s.name}\n${s.instructions}`);
+    return `\n\n## Active Skills\n${parts.join("\n\n")}`;
+}
+export function getSkillByName(name) {
+    const lower = name.toLowerCase();
+    return loadedSkills.find((s) => s.name.toLowerCase() === lower || s.filename.toLowerCase().includes(lower));
+}
+//# sourceMappingURL=index.js.map

package/dist/skills/index.js.map

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

package/dist/swarm.d.ts

@@ -0,0 +1,18 @@
+export interface SwarmResult {
+    text: string;
+    agents: {
+        name: string;
+        output: string;
+        toolCalls: number;
+    }[];
+}
+export declare function runSwarm(task: string, options?: {
+    agents?: string[];
+    team?: string;
+}): Promise<SwarmResult>;
+export declare function parseSwarmCommand(text: string): {
+    task: string;
+    agents?: string[];
+    team?: string;
+} | null;
+//# sourceMappingURL=swarm.d.ts.map

package/dist/swarm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swarm.d.ts","sourceRoot":"","sources":["../src/swarm.ts"],"names":[],"mappings":"AAgHA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC/D;AAED,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7C,OAAO,CAAC,WAAW,CAAC,CA8CtB;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAgBzG"}

package/dist/swarm.js

@@ -0,0 +1,146 @@
+import { chatCompletion as registryChatCompletion } from "./llm/index.js";
+import { getTool, tools } from "./tools/index.js";
+import { logUsage, estimateCost } from "./usage.js";
+import { getActiveModel } from "./llm/index.js";
+import { listAgents, getAgent } from "./agents.js";
+function toolsToDefinitions(toolNames) {
+    return toolNames
+        .map((name) => {
+        const t = tools.find((tool) => tool.name === name);
+        if (!t)
+            return null;
+        return { name: t.name, description: t.description, parameters: t.input_schema };
+    })
+        .filter((t) => t !== null);
+}
+async function runSwarmAgentInternal(agentDef, task, contextFromPrevious, maxIterations = 5) {
+    const systemPrompt = agentDef.systemPrompt +
+        (agentDef.rules.length > 0
+            ? `\n\n## Special Rules\n${agentDef.rules.map((r) => `- ${r}`).join("\n")}`
+            : "");
+    const toolDefs = toolsToDefinitions(agentDef.tools);
+    const messages = [
+        {
+            role: "system",
+            content: `${systemPrompt}\n\n## Context from previous agents\n${contextFromPrevious || "No previous context."}`,
+        },
+        { role: "user", content: task },
+    ];
+    let totalToolCalls = 0;
+    const startTime = Date.now();
+    for (let i = 0; i < maxIterations; i++) {
+        const iterStart = Date.now();
+        const response = await registryChatCompletion({
+            messages,
+            tools: toolDefs.length > 0 ? toolDefs : undefined,
+        });
+        const iterLatency = Date.now() - iterStart;
+        const usage = response.usage;
+        if (usage) {
+            logUsage({
+                model: getActiveModel(),
+                promptTokens: usage.promptTokens,
+                completionTokens: usage.completionTokens,
+                totalTokens: usage.promptTokens + usage.completionTokens,
+                costUsd: estimateCost(getActiveModel(), usage.promptTokens, usage.completionTokens),
+                latencyMs: iterLatency,
+                toolCalls: 0,
+                source: `swarm:${agentDef.name}`,
+            });
+        }
+        if (!response.toolCalls || response.toolCalls.length === 0) {
+            return {
+                agent: agentDef.name,
+                output: response.content || "(no response)",
+                toolCalls: totalToolCalls,
+            };
+        }
+        totalToolCalls += response.toolCalls.length;
+        messages.push({
+            role: "assistant",
+            content: response.content || null,
+            tool_calls: response.toolCalls.map((tc) => ({
+                id: tc.id,
+                function: { name: tc.name, arguments: tc.arguments },
+            })),
+        });
+        for (const tc of response.toolCalls) {
+            const tool = getTool(tc.name);
+            if (!tool) {
+                messages.push({ role: "tool", tool_call_id: tc.id, content: `Unknown tool: ${tc.name}` });
+                continue;
+            }
+            try {
+                const args = JSON.parse(tc.arguments);
+                const result = await tool.execute(args);
+                messages.push({ role: "tool", tool_call_id: tc.id, content: result });
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                messages.push({ role: "tool", tool_call_id: tc.id, content: `Error: ${msg}` });
+            }
+        }
+    }
+    return {
+        agent: agentDef.name,
+        output: "Max iterations reached.",
+        toolCalls: totalToolCalls,
+    };
+}
+export async function runSwarm(task, options) {
+    let agentDefs;
+    if (options?.agents && options.agents.length > 0) {
+        agentDefs = options.agents
+            .map((name) => getAgent(name.toLowerCase()))
+            .filter((a) => a !== null);
+    }
+    else if (options?.team && options.team.length > 0) {
+        agentDefs = listAgents(options.team);
+    }
+    else {
+        agentDefs = listAgents();
+    }
+    if (agentDefs.length === 0) {
+        return { text: "No agents selected for the swarm.", agents: [] };
+    }
+    const results = [];
+    let context = "";
+    for (const agentDef of agentDefs) {
+        console.log(`🐝 Swarm agent "${agentDef.name}" starting`);
+        const result = await runSwarmAgentInternal(agentDef, task, context);
+        results.push(result);
+        context += `\n### ${agentDef.name} output:\n${result.output}\n`;
+        console.log(`🐝 Swarm agent "${agentDef.name}" done (${result.toolCalls} tool calls)`);
+    }
+    const synthesizerPrompt = `You are CF Claw. Synthesize the following agent outputs into a single, cohesive, helpful response for the user. Do not mention agents or internal process - just give the user a great answer.
+
+## Task: ${task}
+
+${results.map((r) => `### ${r.agent}:\n${r.output}`).join("\n\n")}
+
+Provide a clear, comprehensive final answer:`;
+    const synthResponse = await registryChatCompletion({
+        messages: [{ role: "user", content: synthesizerPrompt }],
+    });
+    const finalText = synthResponse.content || results[results.length - 1]?.output || "No result.";
+    return {
+        text: finalText,
+        agents: results.map((r) => ({ name: r.agent, output: r.output, toolCalls: r.toolCalls })),
+    };
+}
+export function parseSwarmCommand(text) {
+    let agents;
+    let team;
+    const agentMatch = text.match(/--agents?\s+(\S+(?:,\S+)*)/);
+    const teamMatch = text.match(/--team\s+(\S+)/);
+    if (agentMatch)
+        agents = agentMatch[1].split(",");
+    if (teamMatch)
+        team = teamMatch[1];
+    const rest = text.replace(/^\/swarm\s*/, "").trim();
+    const cleaned = rest.replace(/--agents?\s+\S+/, "").replace(/--team\s+\S+/, "").trim();
+    if (!cleaned)
+        return null;
+    return { task: cleaned, agents: agents?.length ? agents : undefined, team };
+}
+//# sourceMappingURL=swarm.js.map

package/dist/swarm.js.map

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

package/dist/taskListWidget.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Task List Widget (US-3)
+ *
+ * Features:
+ * - Checkbox/toggle for each task item
+ * - Click handler updates task.completed in state
+ * - Visual indicator class (strikethrough + opacity) on completed tasks
+ * - Full keyboard accessibility
+ * - Proper label/checkbox association with id/for attributes
+ *
+ * NOTE: This widget is designed as a singleton. Calling mount() multiple times
+ * will unmount the previous instance. Only one instance is supported per page.
+ */
+interface Task {
+    id: string;
+    text: string;
+    completed: boolean;
+}
+type TaskInput = Partial<Task> & {
+    text: string;
+};
+/**
+ * Toggle the completed state of a task.
+ *
+ * Flow:
+ * 1. Find task in state array
+ * 2. Flip task.completed boolean
+ * 3. Update DOM: toggle visual indicator class
+ * 4. Update DOM: sync checkbox.checked property
+ * 5. Update DOM: sync aria-label for screen readers
+ * 6. Update count display
+ */
+declare function toggleCompleted(taskId: string): void;
+/**
+ * Add a new task to the list.
+ */
+declare function addTask(text: string): Task;
+/**
+ * Remove a task from the list.
+ */
+declare function removeTask(taskId: string): boolean;
+/**
+ * Replace all tasks (e.g., for hydration from external source).
+ */
+declare function setTasks(newTasks: TaskInput[]): void;
+/**
+ * Get a copy of the current tasks array.
+ */
+declare function getTasks(): Task[];
+/**
+ * Mount the widget into a container element.
+ *
+ * NOTE: This widget is a singleton. Calling mount() multiple times will
+ * unmount any previous instance. Only one instance is supported per page.
+ */
+declare function mount(container: HTMLElement): void;
+/**
+ * Unmount the widget and clean up.
+ */
+declare function unmount(): void;
+interface TaskListWidgetAPI {
+    mount: typeof mount;
+    unmount: typeof unmount;
+    addTask: typeof addTask;
+    removeTask: typeof removeTask;
+    setTasks: typeof setTasks;
+    getTasks: typeof getTasks;
+    toggleCompleted: typeof toggleCompleted;
+}
+declare global {
+    interface Window {
+        __taskListWidget: TaskListWidgetAPI;
+    }
+}
+export { mount, unmount, addTask, removeTask, setTasks, getTasks, toggleCompleted };
+//# sourceMappingURL=taskListWidget.d.ts.map

package/dist/taskListWidget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taskListWidget.d.ts","sourceRoot":"","sources":["../src/taskListWidget.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,UAAU,IAAI;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,KAAK,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAkHlD;;;;;;;;;;GAUG;AACH,iBAAS,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CA+B7C;AAED;;GAEG;AACH,iBAAS,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAUnC;AAED;;GAEG;AACH,iBAAS,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAkB3C;AAED;;GAEG;AACH,iBAAS,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,IAAI,CAU7C;AAED;;GAEG;AACH,iBAAS,QAAQ,IAAI,IAAI,EAAE,CAE1B;AAED;;;;;GAKG;AACH,iBAAS,KAAK,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI,CAiC3C;AAED;;GAEG;AACH,iBAAS,OAAO,IAAI,IAAI,CAQvB;AAID,UAAU,iBAAiB;IACzB,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,OAAO,EAAE,OAAO,OAAO,CAAC;IACxB,OAAO,EAAE,OAAO,OAAO,CAAC;IACxB,UAAU,EAAE,OAAO,UAAU,CAAC;IAC9B,QAAQ,EAAE,OAAO,QAAQ,CAAC;IAC1B,QAAQ,EAAE,OAAO,QAAQ,CAAC;IAC1B,eAAe,EAAE,OAAO,eAAe,CAAC;CACzC;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,gBAAgB,EAAE,iBAAiB,CAAC;KACrC;CACF;AAmFD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC"}