daycare-cli 0.0.0-canary.f57680e

package/dist/plugins/database/__tests__/plugin.spec.js

@@ -0,0 +1,120 @@
+import { describe, it, expect, beforeEach } from "vitest";
+import { promises as fs } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { createId } from "@paralleldrive/cuid2";
+import { AuthStore } from "../../../auth/store.js";
+import { FileStore } from "../../../files/store.js";
+import { ModuleRegistry } from "../../../engine/modules/moduleRegistry.js";
+import { PluginRegistry } from "../../../engine/plugins/registry.js";
+import { Agent } from "../../../engine/agents/agent.js";
+import { AgentInbox } from "../../../engine/agents/ops/agentInbox.js";
+import { Processes } from "../../../engine/processes/processes.js";
+import { getLogger } from "../../../log.js";
+import { plugin } from "../plugin.js";
+import { configResolve } from "../../../config/configResolve.js";
+describe("database plugin", () => {
+    let baseDir;
+    beforeEach(async () => {
+        baseDir = await fs.mkdtemp(path.join(os.tmpdir(), "daycare-db-plugin-"));
+    });
+    it("creates db files, runs SQL, and updates db.md", async () => {
+        const config = configResolve({ engine: { dataDir: baseDir } }, path.join(baseDir, "settings.json"));
+        const auth = new AuthStore(config);
+        const fileStore = new FileStore(config);
+        const modules = new ModuleRegistry({ onMessage: async () => undefined });
+        const pluginRegistry = new PluginRegistry(modules);
+        const instanceId = "database-1";
+        const registrar = pluginRegistry.createRegistrar(instanceId);
+        const now = new Date();
+        const agentId = createId();
+        const permissions = {
+            workingDir: baseDir,
+            writeDirs: [],
+            readDirs: [],
+            network: false,
+            events: false
+        };
+        const messageContext = {};
+        const descriptor = {
+            type: "subagent",
+            id: agentId,
+            parentAgentId: "system",
+            name: "system"
+        };
+        const state = {
+            context: { messages: [] },
+            permissions,
+            tokens: null,
+            stats: {},
+            createdAt: now.getTime(),
+            updatedAt: now.getTime(),
+            state: "active"
+        };
+        const agent = Agent.restore(agentId, descriptor, state, new AgentInbox(agentId), {});
+        const api = {
+            instance: { instanceId, pluginId: "database" },
+            settings: {},
+            engineSettings: {},
+            logger: getLogger("test.database"),
+            auth,
+            dataDir: baseDir,
+            registrar,
+            exposes: {
+                registerProvider: async () => undefined,
+                unregisterProvider: async () => undefined,
+                listProviders: () => []
+            },
+            fileStore,
+            inference: {
+                complete: async () => {
+                    throw new Error("Inference not available in test.");
+                }
+            },
+            processes: new Processes(baseDir, getLogger("test.processes.database")),
+            mode: "runtime",
+            events: { emit: () => undefined }
+        };
+        const instance = await plugin.create(api);
+        await instance.load?.();
+        const dbPath = path.join(baseDir, "db.pglite");
+        const docPath = path.join(baseDir, "db.md");
+        await expect(fs.stat(dbPath)).resolves.toBeTruthy();
+        await expect(fs.stat(docPath)).resolves.toBeTruthy();
+        const toolCall = {
+            type: "toolCall",
+            id: "tool-1",
+            name: "db_sql",
+            arguments: {
+                sql: "CREATE TABLE users (id INTEGER PRIMARY KEY, name TEXT NOT NULL)",
+                description: "Create users table"
+            }
+        };
+        const result = await modules.tools.execute(toolCall, {
+            connectorRegistry: modules.connectors,
+            fileStore,
+            auth,
+            logger: getLogger("test.database.tool"),
+            assistant: null,
+            permissions,
+            agent,
+            source: "test",
+            messageContext,
+            agentSystem: null,
+            heartbeats: null
+        });
+        expect(result.toolMessage.isError).toBe(false);
+        const doc = await fs.readFile(docPath, "utf8");
+        expect(doc).toContain("### users");
+        expect(doc).toContain("id: integer");
+        expect(doc).toContain("name: text");
+        expect(doc).toContain("Create users table");
+        const prompt = typeof instance.systemPrompt === "function"
+            ? await instance.systemPrompt()
+            : instance.systemPrompt ?? "";
+        expect(prompt).toContain("Database plugin is active.");
+        expect(prompt).toContain(doc.trim());
+        await instance.unload?.();
+    });
+});
+//# sourceMappingURL=plugin.spec.js.map

package/dist/plugins/database/__tests__/plugin.spec.js.map

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

package/dist/plugins/database/plugin.d.ts

@@ -0,0 +1,3 @@
+import { z } from "zod";
+export declare const plugin: import("@/types").PluginModule<z.objectInputType<{}, z.ZodTypeAny, "passthrough">>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugins/database/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../sources/plugins/database/plugin.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA8DxB,eAAO,MAAM,MAAM,oFAoJjB,CAAC"}

package/dist/plugins/database/plugin.js

@@ -0,0 +1,300 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { PGlite } from "@electric-sql/pglite";
+import { Type } from "@sinclair/typebox";
+import { z } from "zod";
+import { definePlugin } from "../../engine/plugins/types.js";
+const settingsSchema = z.object({}).passthrough();
+const paramSchema = Type.Union([
+    Type.String(),
+    Type.Number(),
+    Type.Boolean(),
+    Type.Null()
+]);
+const querySchema = Type.Object({
+    sql: Type.String({ minLength: 1 }),
+    params: Type.Optional(Type.Array(paramSchema)),
+    description: Type.Optional(Type.String({ minLength: 1 }))
+}, { additionalProperties: false });
+const queryResultSchema = Type.Object({
+    summary: Type.String(),
+    sqlType: Type.String(),
+    rows: Type.Number(),
+    affectedRows: Type.Number()
+}, { additionalProperties: false });
+const queryReturns = {
+    schema: queryResultSchema,
+    toLLMText: (result) => result.summary
+};
+const DB_TEMPLATE = `# Database Memory
+
+This file describes the Postgres (PGlite) database used by the database plugin.
+
+## Schema
+<!-- schema:start -->
+No tables yet.
+<!-- schema:end -->
+
+## Recent Changes
+<!-- changes:start -->
+- (none)
+<!-- changes:end -->
+`;
+const SCHEMA_START = "<!-- schema:start -->";
+const SCHEMA_END = "<!-- schema:end -->";
+const CHANGES_START = "<!-- changes:start -->";
+const CHANGES_END = "<!-- changes:end -->";
+export const plugin = definePlugin({
+    settingsSchema,
+    create: (api) => {
+        const dbPath = path.join(api.dataDir, "db.pglite");
+        const docPath = path.join(api.dataDir, "db.md");
+        let db = null;
+        const openDb = async () => {
+            if (!db) {
+                await fs.mkdir(dbPath, { recursive: true });
+                db = new PGlite(dbPath);
+                await db.waitReady;
+            }
+            return db;
+        };
+        const ensureDocs = async () => {
+            await fs.mkdir(api.dataDir, { recursive: true });
+            try {
+                await fs.access(dbPath);
+            }
+            catch (error) {
+                const code = error.code;
+                if (code !== "ENOENT") {
+                    throw error;
+                }
+                await openDb();
+            }
+            try {
+                await fs.access(docPath);
+            }
+            catch (error) {
+                const code = error.code;
+                if (code !== "ENOENT") {
+                    throw error;
+                }
+                await fs.writeFile(docPath, DB_TEMPLATE, "utf8");
+            }
+        };
+        const loadDoc = async () => {
+            try {
+                const content = await fs.readFile(docPath, "utf8");
+                return content.trim().length > 0 ? content : DB_TEMPLATE;
+            }
+            catch (error) {
+                const code = error.code;
+                if (code !== "ENOENT") {
+                    throw error;
+                }
+                return DB_TEMPLATE;
+            }
+        };
+        const updateDoc = async (description) => {
+            const current = await loadDoc();
+            const schema = await renderSchema(await openDb());
+            let next = replaceSection(current, SCHEMA_START, SCHEMA_END, schema);
+            if (description) {
+                const summary = formatChangeSummary(description);
+                next = appendChange(next, summary);
+            }
+            else {
+                next = replaceSection(next, CHANGES_START, CHANGES_END, ensureChangeBody(readSection(next, CHANGES_START, CHANGES_END)));
+            }
+            await fs.writeFile(docPath, next, "utf8");
+        };
+        return {
+            load: async () => {
+                await ensureDocs();
+                api.registrar.registerTool({
+                    tool: {
+                        name: "db_sql",
+                        description: "Execute SQL against the plugin Postgres (PGlite) database. Provide an optional description to document the change.",
+                        parameters: querySchema
+                    },
+                    returns: queryReturns,
+                    execute: async (args, _context, toolCall) => {
+                        const payload = args;
+                        const dbInstance = await openDb();
+                        const params = payload.params ?? [];
+                        let text = "";
+                        let details = {};
+                        let rows = 0;
+                        let affectedRows = 0;
+                        let sqlType = "write";
+                        if (isReadSql(payload.sql)) {
+                            sqlType = "read";
+                            const result = await dbInstance.query(payload.sql, params);
+                            const rowList = result.rows ?? [];
+                            rows = rowList.length;
+                            text = rowList.length === 0 ? "No rows returned." : JSON.stringify(rowList, null, 2);
+                            details = { rows: rowList.length };
+                        }
+                        else {
+                            const result = await dbInstance.query(payload.sql, params);
+                            affectedRows = result.affectedRows ?? 0;
+                            await updateDoc(payload.description ?? summarizeSql(payload.sql));
+                            text = `OK. affectedRows=${affectedRows}`;
+                            details = {
+                                affectedRows
+                            };
+                        }
+                        const summary = text;
+                        const toolMessage = {
+                            role: "toolResult",
+                            toolCallId: toolCall.id,
+                            toolName: toolCall.name,
+                            content: [{ type: "text", text: summary }],
+                            details,
+                            isError: false,
+                            timestamp: Date.now()
+                        };
+                        return {
+                            toolMessage,
+                            typedResult: {
+                                summary,
+                                sqlType,
+                                rows,
+                                affectedRows
+                            }
+                        };
+                    }
+                });
+            },
+            unload: async () => {
+                api.registrar.unregisterTool("db_sql");
+                try {
+                    await db?.close();
+                }
+                catch {
+                    // ignore close errors
+                }
+                db = null;
+            },
+            systemPrompt: async () => {
+                const doc = await loadDoc();
+                return [
+                    "Database plugin is active.",
+                    `PGlite data directory: ${dbPath}`,
+                    "The db.md file is a living description of the database.",
+                    "When you create or modify schema, update db.md with a detailed explanation of tables, fields, types, and expectations.",
+                    "",
+                    doc
+                ].join("\n");
+            }
+        };
+    }
+});
+function replaceSection(content, start, end, body) {
+    if (!content.includes(start) || !content.includes(end)) {
+        return `${content.trim()}\n\n${start}\n${body}\n${end}\n`;
+    }
+    const startIndex = content.indexOf(start) + start.length;
+    const endIndex = content.indexOf(end);
+    return `${content.slice(0, startIndex)}\n${body}\n${content.slice(endIndex)}`;
+}
+function readSection(content, start, end) {
+    if (!content.includes(start) || !content.includes(end)) {
+        return "";
+    }
+    const startIndex = content.indexOf(start) + start.length;
+    const endIndex = content.indexOf(end);
+    return content.slice(startIndex, endIndex).trim();
+}
+function appendChange(content, entry) {
+    const existing = readSection(content, CHANGES_START, CHANGES_END);
+    const lines = existing
+        .split("\n")
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0 && line !== "- (none)");
+    lines.unshift(`- ${entry}`);
+    const body = lines.length > 0 ? lines.join("\n") : "- (none)";
+    return replaceSection(content, CHANGES_START, CHANGES_END, body);
+}
+function ensureChangeBody(content) {
+    const trimmed = content.trim();
+    if (trimmed.length === 0 || trimmed === "- (none)") {
+        return "- (none)";
+    }
+    return trimmed;
+}
+function formatChangeSummary(description) {
+    const date = new Date().toISOString().split("T")[0];
+    return `[${date}] ${description}`;
+}
+function summarizeSql(sql) {
+    const compact = sql.replace(/\s+/g, " ").trim();
+    if (compact.length <= 120) {
+        return compact;
+    }
+    return `${compact.slice(0, 117)}...`;
+}
+function isReadSql(sql) {
+    const normalized = sql.trim().toLowerCase();
+    return (normalized.startsWith("select") ||
+        normalized.startsWith("pragma") ||
+        normalized.startsWith("with") ||
+        normalized.startsWith("explain"));
+}
+async function renderSchema(db) {
+    const tablesResult = await db.query(`
+    SELECT table_name
+    FROM information_schema.tables
+    WHERE table_schema = 'public' AND table_type = 'BASE TABLE'
+    ORDER BY table_name
+    `);
+    const tables = tablesResult.rows ?? [];
+    if (tables.length === 0) {
+        return "No tables yet.";
+    }
+    const parts = [];
+    for (const table of tables) {
+        const tableName = table.table_name;
+        const columnsResult = await db.query(`
+      SELECT column_name, data_type, is_nullable, column_default
+      FROM information_schema.columns
+      WHERE table_schema = 'public' AND table_name = $1
+      ORDER BY ordinal_position
+      `, [tableName]);
+        const columns = columnsResult.rows ?? [];
+        const pkResult = await db.query(`
+      SELECT kcu.column_name
+      FROM information_schema.table_constraints tc
+      JOIN information_schema.key_column_usage kcu
+        ON tc.constraint_name = kcu.constraint_name
+       AND tc.table_schema = kcu.table_schema
+      WHERE tc.constraint_type = 'PRIMARY KEY'
+        AND tc.table_schema = 'public'
+        AND tc.table_name = $1
+      ORDER BY kcu.ordinal_position
+      `, [tableName]);
+        const pkColumns = new Set(pkResult.rows?.map((row) => row.column_name) ?? []);
+        parts.push(`### ${tableName}`);
+        if (columns.length === 0) {
+            parts.push("- (no columns found)");
+            parts.push("");
+            continue;
+        }
+        for (const column of columns) {
+            const flags = [];
+            if (column.is_nullable === "NO") {
+                flags.push("not null");
+            }
+            if (pkColumns.has(column.column_name)) {
+                flags.push("primary key");
+            }
+            if (column.column_default !== null && column.column_default !== undefined) {
+                flags.push(`default ${String(column.column_default)}`);
+            }
+            const detail = flags.length > 0 ? ` (${flags.join(", ")})` : "";
+            parts.push(`- ${column.column_name}: ${column.data_type || "unknown"}${detail}`);
+        }
+        parts.push("");
+    }
+    return parts.join("\n").trim();
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugins/database/plugin.js.map

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

package/dist/plugins/database/plugin.json

@@ -0,0 +1,6 @@
+{
+  "id": "database",
+  "name": "Database",
+  "description": "PGlite-backed database with markdown context.",
+  "entry": "./plugin.js"
+}

package/dist/plugins/exa-ai/plugin.d.ts

@@ -0,0 +1,5 @@
+import { z } from "zod";
+export declare const plugin: import("@/types").PluginModule<z.objectInputType<{
+    toolName: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugins/exa-ai/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../sources/plugins/exa-ai/plugin.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAuFxB,eAAO,MAAM,MAAM;;gCA2HjB,CAAC"}

package/dist/plugins/exa-ai/plugin.js

@@ -0,0 +1,162 @@
+import { Type } from "@sinclair/typebox";
+import { z } from "zod";
+import { definePlugin } from "../../engine/plugins/types.js";
+const settingsSchema = z
+    .object({
+    toolName: z.string().min(1).optional()
+})
+    .passthrough();
+const searchSchema = Type.Object({
+    query: Type.String({ minLength: 1, description: "The search query" }),
+    numResults: Type.Optional(Type.Number({ minimum: 1, maximum: 10, description: "Number of results to return" })),
+    type: Type.Optional(Type.Union([
+        Type.Literal("auto"),
+        Type.Literal("fast"),
+        Type.Literal("deep"),
+        Type.Literal("neural")
+    ], { description: "Search type: auto, fast, deep, or neural" })),
+    useAutoprompt: Type.Optional(Type.Boolean({ description: "Whether to use Exa autoprompt to improve the query" }))
+}, { additionalProperties: false });
+const searchResultSchema = Type.Object({
+    summary: Type.String(),
+    query: Type.String(),
+    resultCount: Type.Number(),
+    searchType: Type.String()
+}, { additionalProperties: false });
+const searchReturns = {
+    schema: searchResultSchema,
+    toLLMText: (result) => result.summary
+};
+async function validateApiKey(apiKey) {
+    const response = await fetch("https://api.exa.ai/search", {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            "x-api-key": apiKey
+        },
+        body: JSON.stringify({
+            query: "example",
+            numResults: 1,
+            type: "auto"
+        })
+    });
+    if (!response.ok) {
+        const errorText = await response.text();
+        throw new Error(`Exa validation failed: ${response.status} - ${errorText}`);
+    }
+}
+export const plugin = definePlugin({
+    settingsSchema,
+    onboarding: async (api) => {
+        const existingKey = await api.auth.getApiKey(api.instanceId);
+        if (existingKey) {
+            try {
+                await validateApiKey(existingKey);
+                api.note("Using existing Exa AI credentials.", "Setup");
+                return { settings: {} };
+            }
+            catch (error) {
+                api.note("Existing Exa AI key failed validation, prompting for a new key.", "Setup");
+            }
+        }
+        const apiKey = await api.prompt.input({
+            message: "Exa AI API key"
+        });
+        if (!apiKey) {
+            return null;
+        }
+        await validateApiKey(apiKey);
+        await api.auth.setApiKey(api.instanceId, apiKey);
+        return { settings: {} };
+    },
+    create: (api) => {
+        const toolName = api.settings.toolName ?? "exa_search";
+        const instanceId = api.instance.instanceId;
+        return {
+            load: async () => {
+                api.registrar.registerTool({
+                    tool: {
+                        name: toolName,
+                        description: "Search the web using Exa AI. Supports auto, fast, deep, and neural search types.",
+                        parameters: searchSchema
+                    },
+                    returns: searchReturns,
+                    execute: async (args, toolContext, toolCall) => {
+                        if (!toolContext.permissions.network) {
+                            throw new Error("Network access not granted. Request @network permission.");
+                        }
+                        const payload = args;
+                        const apiKey = await api.auth.getApiKey(instanceId);
+                        if (!apiKey) {
+                            throw new Error("Missing exa-ai apiKey in auth store");
+                        }
+                        const requestBody = {
+                            query: payload.query,
+                            numResults: payload.numResults ?? 5,
+                            type: payload.type ?? "auto",
+                            useAutoprompt: payload.useAutoprompt ?? true,
+                            contents: {
+                                text: true,
+                                highlights: true
+                            }
+                        };
+                        const response = await fetch("https://api.exa.ai/search", {
+                            method: "POST",
+                            headers: {
+                                "Content-Type": "application/json",
+                                "x-api-key": apiKey
+                            },
+                            body: JSON.stringify(requestBody)
+                        });
+                        if (!response.ok) {
+                            const errorText = await response.text();
+                            throw new Error(`Exa search failed: ${response.status} - ${errorText}`);
+                        }
+                        const data = (await response.json());
+                        const results = data.results ?? [];
+                        let text;
+                        if (results.length === 0) {
+                            text = "No results found.";
+                        }
+                        else {
+                            const formatted = results.map((item, index) => {
+                                const title = item.title ?? "Untitled";
+                                const url = item.url ?? "";
+                                const snippet = item.highlights?.[0] ?? item.text?.slice(0, 200) ?? "No description available.";
+                                const date = item.publishedDate ? ` (${item.publishedDate})` : "";
+                                return `${index + 1}. ${title}${date}\n${url}\n${snippet}`;
+                            });
+                            text = formatted.join("\n\n");
+                            if (data.autopromptString) {
+                                text = `Autoprompt: "${data.autopromptString}"\n\n${text}`;
+                            }
+                        }
+                        const summary = text;
+                        const toolMessage = {
+                            role: "toolResult",
+                            toolCallId: toolCall.id,
+                            toolName: toolCall.name,
+                            content: [{ type: "text", text: summary }],
+                            details: { count: results.length },
+                            isError: false,
+                            timestamp: Date.now()
+                        };
+                        return {
+                            toolMessage,
+                            typedResult: {
+                                summary,
+                                query: payload.query,
+                                resultCount: results.length,
+                                searchType: payload.type ?? "auto"
+                            }
+                        };
+                    }
+                });
+            },
+            unload: async () => {
+                api.registrar.unregisterTool(toolName);
+            }
+        };
+    }
+});
+//# sourceMappingURL=plugin.js.map

package/dist/plugins/exa-ai/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../../sources/plugins/exa-ai/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAe,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAG7D,MAAM,cAAc,GAAG,CAAC;KACrB,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACvC,CAAC;KACD,WAAW,EAAE,CAAC;AAEjB,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAC9B;IACE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,WAAW,EAAE,kBAAkB,EAAE,CAAC;IACrE,UAAU,EAAE,IAAI,CAAC,QAAQ,CACvB,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,6BAA6B,EAAE,CAAC,CACrF;IACD,IAAI,EAAE,IAAI,CAAC,QAAQ,CACjB,IAAI,CAAC,KAAK,CACR;QACE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QACpB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QACpB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QACpB,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;KACvB,EACD,EAAE,WAAW,EAAE,0CAA0C,EAAE,CAC5D,CACF;IACD,aAAa,EAAE,IAAI,CAAC,QAAQ,CAC1B,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,oDAAoD,EAAE,CAAC,CACpF;CACF,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC;AAIF,MAAM,kBAAkB,GAAG,IAAI,CAAC,MAAM,CACpC;IACE,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE;IACtB,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE;IACpB,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE;IAC1B,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE;CAC1B,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC;AAIF,MAAM,aAAa,GAAqC;IACtD,MAAM,EAAE,kBAAkB;IAC1B,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO;CACtC,CAAC;AAeF,KAAK,UAAU,cAAc,CAAC,MAAc;IAC1C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,2BAA2B,EAAE;QACxD,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,cAAc,EAAE,kBAAkB;YAClC,WAAW,EAAE,MAAM;SACpB;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,KAAK,EAAE,SAAS;YAChB,UAAU,EAAE,CAAC;YACb,IAAI,EAAE,MAAM;SACb,CAAC;KACH,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,CAAC,MAAM,MAAM,SAAS,EAAE,CAAC,CAAC;IAC9E,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,YAAY,CAAC;IACjC,cAAc;IACd,UAAU,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QACxB,MAAM,WAAW,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC7D,IAAI,WAAW,EAAE,CAAC;YAChB,IAAI,CAAC;gBACH,MAAM,cAAc,CAAC,WAAW,CAAC,CAAC;gBAClC,GAAG,CAAC,IAAI,CAAC,oCAAoC,EAAE,OAAO,CAAC,CAAC;gBACxD,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;YAC1B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,GAAG,CAAC,IAAI,CAAC,iEAAiE,EAAE,OAAO,CAAC,CAAC;YACvF,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC;YACpC,OAAO,EAAE,gBAAgB;SAC1B,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;QAC7B,MAAM,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACjD,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAC1B,CAAC;IACD,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE;QACd,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,QAAQ,IAAI,YAAY,CAAC;QACvD,MAAM,UAAU,GAAG,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC;QAE3C,OAAO;YACL,IAAI,EAAE,KAAK,IAAI,EAAE;gBACf,GAAG,CAAC,SAAS,CAAC,YAAY,CAAC;oBACzB,IAAI,EAAE;wBACJ,IAAI,EAAE,QAAQ;wBACd,WAAW,EACT,kFAAkF;wBACpF,UAAU,EAAE,YAAY;qBACzB;oBACD,OAAO,EAAE,aAAa;oBACtB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,EAAE;wBAC7C,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;4BACrC,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;wBAC9E,CAAC;wBACD,MAAM,OAAO,GAAG,IAAkB,CAAC;wBACnC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;wBACpD,IAAI,CAAC,MAAM,EAAE,CAAC;4BACZ,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;wBACzD,CAAC;wBAED,MAAM,WAAW,GAA4B;4BAC3C,KAAK,EAAE,OAAO,CAAC,KAAK;4BACpB,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,CAAC;4BACnC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,MAAM;4BAC5B,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,IAAI;4BAC5C,QAAQ,EAAE;gCACR,IAAI,EAAE,IAAI;gCACV,UAAU,EAAE,IAAI;6BACjB;yBACF,CAAC;wBAEF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,2BAA2B,EAAE;4BACxD,MAAM,EAAE,MAAM;4BACd,OAAO,EAAE;gCACP,cAAc,EAAE,kBAAkB;gCAClC,WAAW,EAAE,MAAM;6BACpB;4BACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC;yBAClC,CAAC,CAAC;wBAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;4BACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;4BACxC,MAAM,IAAI,KAAK,CAAC,sBAAsB,QAAQ,CAAC,MAAM,MAAM,SAAS,EAAE,CAAC,CAAC;wBAC1E,CAAC;wBAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAsB,CAAC;wBAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;wBAEnC,IAAI,IAAY,CAAC;wBACjB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;4BACzB,IAAI,GAAG,mBAAmB,CAAC;wBAC7B,CAAC;6BAAM,CAAC;4BACN,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;gCAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,UAAU,CAAC;gCACvC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC;gCAC3B,MAAM,OAAO,GACX,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,2BAA2B,CAAC;gCAClF,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gCAClE,OAAO,GAAG,KAAK,GAAG,CAAC,KAAK,KAAK,GAAG,IAAI,KAAK,GAAG,KAAK,OAAO,EAAE,CAAC;4BAC7D,CAAC,CAAC,CAAC;4BACH,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;4BAE9B,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;gCAC1B,IAAI,GAAG,gBAAgB,IAAI,CAAC,gBAAgB,QAAQ,IAAI,EAAE,CAAC;4BAC7D,CAAC;wBACH,CAAC;wBAED,MAAM,OAAO,GAAG,IAAI,CAAC;wBACrB,MAAM,WAAW,GAAsB;4BACrC,IAAI,EAAE,YAAY;4BAClB,UAAU,EAAE,QAAQ,CAAC,EAAE;4BACvB,QAAQ,EAAE,QAAQ,CAAC,IAAI;4BACvB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;4BAC1C,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE;4BAClC,OAAO,EAAE,KAAK;4BACd,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;yBACtB,CAAC;wBAEF,OAAO;4BACL,WAAW;4BACX,WAAW,EAAE;gCACX,OAAO;gCACP,KAAK,EAAE,OAAO,CAAC,KAAK;gCACpB,WAAW,EAAE,OAAO,CAAC,MAAM;gCAC3B,UAAU,EAAE,OAAO,CAAC,IAAI,IAAI,MAAM;6BACnC;yBACF,CAAC;oBACJ,CAAC;iBACF,CAAC,CAAC;YACL,CAAC;YACD,MAAM,EAAE,KAAK,IAAI,EAAE;gBACjB,GAAG,CAAC,SAAS,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;YACzC,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/plugins/exa-ai/plugin.json

@@ -0,0 +1,6 @@
+{
+  "id": "exa-ai",
+  "name": "Exa AI",
+  "description": "Web search tool powered by Exa AI.",
+  "entry": "./plugin.js"
+}