daemora 1.0.0-alpha.0

package/dist/tools/core/readPDF.js

@@ -0,0 +1,135 @@
+/**
+ * read_pdf — extract text from a PDF.
+ *
+ * Strategy (first hit wins):
+ *   1. `pdftotext` (poppler) — fast, local, free. Needs `brew install
+ *      poppler` or `apt install poppler-utils`. Skipped silently when
+ *      not installed.
+ *   2. Native multimodal model — pass the raw PDF bytes to whichever
+ *      model the user has configured (`DEFAULT_MODEL`) as a `file`
+ *      content part. No text extraction: the provider sees the PDF
+ *      with its layout, tables, and figures intact. No hardcoded
+ *      model name — if the configured model doesn't support PDFs the
+ *      provider surfaces a clear error.
+ *
+ * Supports `pages` only on the pdftotext path (the model path runs the
+ * whole document because providers don't expose page slicing).
+ */
+import { execFile } from "node:child_process";
+import { readFile, stat } from "node:fs/promises";
+import { promisify } from "node:util";
+import { generateText } from "ai";
+import { z } from "zod";
+import { NotFoundError, ProviderError, ValidationError } from "../../util/errors.js";
+const execFileAsync = promisify(execFile);
+const inputSchema = z.object({
+    path: z.string().min(1).describe("Absolute or workspace-relative path to the PDF."),
+    pages: z.string().regex(/^\d+(-\d+)?$/).optional().describe("Page range like '1-5' or single page '3' (pdftotext only)."),
+    method: z.enum(["auto", "pdftotext", "model"]).default("auto")
+        .describe("Extraction method: 'auto' tries pdftotext then the configured model; 'pdftotext' forces local; 'model' forces the configured multimodal model."),
+    /**
+     * Optional model override — format `provider:model`. When omitted the
+     * tool uses whatever `DEFAULT_MODEL` is set to in Settings. We do NOT
+     * ship a hardcoded default here: model names age fast and every user
+     * should drive inference through the same model they picked for chat.
+     */
+    model: z.string().optional().describe("Optional model override ('provider:model'). Defaults to the configured DEFAULT_MODEL."),
+    maxChars: z.number().int().positive().max(2_000_000).default(500_000)
+        .describe("Truncate the returned text to this many characters. 500 KB default prevents blowing context."),
+});
+export function makeReadPDFTool(guard, models) {
+    return {
+        name: "read_pdf",
+        description: "Extract text from a PDF file. Tries pdftotext (poppler) first, then falls back to the user's configured multimodal model reading the PDF natively. Supports page ranges via 'pages' (pdftotext only).",
+        category: "filesystem",
+        source: { kind: "core" },
+        tags: ["pdf", "extract"],
+        inputSchema,
+        async execute({ path, pages, method, model, maxChars }, { logger }) {
+            const canonical = guard.ensureAllowed(path, "read");
+            let s;
+            try {
+                s = await stat(canonical);
+            }
+            catch (e) {
+                const err = e;
+                if (err.code === "ENOENT")
+                    throw new NotFoundError(`PDF not found: ${canonical}`);
+                throw err;
+            }
+            if (!s.isFile())
+                throw new ValidationError(`Not a file: ${canonical}`);
+            // 1) pdftotext (if present, and method allows)
+            if (method === "auto" || method === "pdftotext") {
+                const text = await tryPdftotext(canonical, pages, logger);
+                if (text !== null && text.trim().length > 0) {
+                    return truncate(text, maxChars);
+                }
+                if (method === "pdftotext") {
+                    throw new ProviderError("pdftotext returned no text. Install poppler-utils and confirm the PDF isn't image-only.", "pdftotext");
+                }
+                logger.info("read_pdf falling back to configured model");
+            }
+            // 2) Configured multimodal model — no hardcoded name, no broken
+            //    vision-via-image_url path. The AI SDK maps `file` content
+            //    parts to each provider's native document API.
+            if (method === "auto" || method === "model") {
+                const modelId = model ?? models.resolveDefault();
+                const resolved = await models.resolve(modelId);
+                const bytes = await readFile(canonical);
+                try {
+                    const { text } = await generateText({
+                        model: resolved.model,
+                        messages: [
+                            {
+                                role: "user",
+                                content: [
+                                    { type: "text", text: "Extract all text content from this PDF. Preserve headings, lists, tables, and paragraph structure. Return only the extracted text — no preamble." },
+                                    { type: "file", data: bytes, mediaType: "application/pdf" },
+                                ],
+                            },
+                        ],
+                    });
+                    if (!text || text.trim().length === 0) {
+                        throw new ProviderError(`Model ${modelId} returned empty output for the PDF. It may not support PDF input — try a different DEFAULT_MODEL or install poppler-utils.`, "model");
+                    }
+                    return truncate(text, maxChars);
+                }
+                catch (e) {
+                    const msg = e.message ?? String(e);
+                    throw new ProviderError(`PDF extraction via ${modelId} failed: ${msg}. If the model doesn't accept PDFs, install poppler-utils (pdftotext) or pick a PDF-capable model in Settings.`, "model");
+                }
+            }
+            throw new ValidationError(`Unknown method: ${method}`);
+        },
+    };
+}
+async function tryPdftotext(canonicalPath, pageRange, logger) {
+    const args = [];
+    if (pageRange) {
+        const [first, second] = pageRange.split("-");
+        args.push("-f", first ?? "1", "-l", second ?? first ?? "1");
+    }
+    args.push(canonicalPath, "-");
+    try {
+        const { stdout } = await execFileAsync("pdftotext", args, {
+            encoding: "utf-8",
+            maxBuffer: 50 * 1024 * 1024,
+            timeout: 30_000,
+        });
+        return stdout.trim();
+    }
+    catch (e) {
+        const err = e;
+        if (err.code === "ENOENT")
+            return null; // pdftotext not installed
+        logger.warn("pdftotext failed", { error: err.message, stderr: err.stderr });
+        return null;
+    }
+}
+function truncate(text, maxChars) {
+    if (text.length <= maxChars)
+        return text;
+    return `${text.slice(0, maxChars)}\n\n…[truncated — PDF exceeded ${maxChars} chars]`;
+}
+//# sourceMappingURL=readPDF.js.map

package/dist/tools/core/readPDF.js.map

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

package/dist/tools/core/reloadTool.d.ts

@@ -0,0 +1,36 @@
+/**
+ * reload(action) — hot-reload system components without a process restart.
+ *
+ * Actions (map 1-to-1 with the JS tool):
+ *   status   — what's currently loaded
+ *   mcp      — disconnect + reconnect every MCP server
+ *   scheduler — stop + restart the cron scheduler
+ *   channels — stop + start every enabled channel
+ *   caches   — clear web search / fetch caches
+ *   all      — run every reload action in sequence
+ *
+ * Keeps the in-process state fresh after config edits — no restart
+ * dance, no reconnect prompts.
+ */
+import { z } from "zod";
+import type { ChannelManager } from "../../channels/ChannelManager.js";
+import type { CronScheduler } from "../../cron/CronScheduler.js";
+import type { MCPManager } from "../../mcp/MCPManager.js";
+import type { MCPStore } from "../../mcp/MCPStore.js";
+import type { ToolDef } from "../types.js";
+declare const inputSchema: z.ZodObject<{
+    action: z.ZodDefault<z.ZodEnum<["status", "mcp", "scheduler", "channels", "caches", "all"]>>;
+}, "strip", z.ZodTypeAny, {
+    action: "status" | "channels" | "all" | "mcp" | "scheduler" | "caches";
+}, {
+    action?: "status" | "channels" | "all" | "mcp" | "scheduler" | "caches" | undefined;
+}>;
+export interface ReloadDeps {
+    readonly mcp: MCPManager;
+    readonly mcpStore: MCPStore;
+    readonly scheduler: CronScheduler;
+    readonly channels: ChannelManager;
+}
+export declare function makeReloadTool(deps: ReloadDeps): ToolDef<typeof inputSchema, unknown>;
+export {};
+//# sourceMappingURL=reloadTool.d.ts.map

package/dist/tools/core/reloadTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reloadTool.d.ts","sourceRoot":"","sources":["../../../src/tools/core/reloadTool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,QAAA,MAAM,WAAW;;;;;;EAEf,CAAC;AAEH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;CACnC;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,WAAW,EAAE,OAAO,CAAC,CA+FrF"}

package/dist/tools/core/reloadTool.js

@@ -0,0 +1,109 @@
+/**
+ * reload(action) — hot-reload system components without a process restart.
+ *
+ * Actions (map 1-to-1 with the JS tool):
+ *   status   — what's currently loaded
+ *   mcp      — disconnect + reconnect every MCP server
+ *   scheduler — stop + restart the cron scheduler
+ *   channels — stop + start every enabled channel
+ *   caches   — clear web search / fetch caches
+ *   all      — run every reload action in sequence
+ *
+ * Keeps the in-process state fresh after config edits — no restart
+ * dance, no reconnect prompts.
+ */
+import { z } from "zod";
+import { clearWebSearchCache } from "./webSearch.js";
+const inputSchema = z.object({
+    action: z.enum(["status", "mcp", "scheduler", "channels", "caches", "all"]).default("status"),
+});
+export function makeReloadTool(deps) {
+    return {
+        name: "reload",
+        description: "Hot-reload system components (MCP servers, scheduler, channels, caches). Actions: status, mcp, scheduler, channels, caches, all.",
+        category: "agent",
+        source: { kind: "core" },
+        tags: ["admin", "reload", "hot-swap"],
+        inputSchema,
+        async execute({ action }, { logger }) {
+            switch (action) {
+                case "status": {
+                    const status = {
+                        mcpServers: deps.mcp.listStatus().length,
+                        connectedMcp: deps.mcp.listStatus().filter((s) => s.status === "connected").length,
+                        schedulerRunning: deps.scheduler.isRunning,
+                        schedulerInflight: deps.scheduler.inflightCount,
+                        channels: deps.channels.runningSet().size,
+                        reloadable: ["mcp", "scheduler", "channels", "caches", "all"],
+                    };
+                    return status;
+                }
+                case "mcp": {
+                    const names = deps.mcp.listStatus().map((s) => s.name);
+                    let reconnected = 0;
+                    for (const name of names) {
+                        try {
+                            const cfg = deps.mcpStore.get(name);
+                            if (!cfg || cfg.enabled === false)
+                                continue;
+                            await deps.mcp.disconnect(name);
+                            await deps.mcp.connect(cfg);
+                            reconnected++;
+                        }
+                        catch (e) {
+                            logger.warn("mcp reload failed for server", { name, error: e.message });
+                        }
+                    }
+                    return { mcpServers: reconnected, message: `Reloaded ${reconnected} MCP server(s)` };
+                }
+                case "scheduler": {
+                    deps.scheduler.stop();
+                    deps.scheduler.start();
+                    return { running: deps.scheduler.isRunning, message: "Scheduler restarted" };
+                }
+                case "channels": {
+                    await deps.channels.stopAll();
+                    await deps.channels.startAll();
+                    const n = deps.channels.runningSet().size;
+                    return { channels: n, message: `Restarted ${n} channel(s)` };
+                }
+                case "caches": {
+                    const clearedSearch = clearWebSearchCache();
+                    return { search: clearedSearch, message: `Cleared web search cache (${clearedSearch} entries)` };
+                }
+                case "all": {
+                    const out = {};
+                    // MCP
+                    const names = deps.mcp.listStatus().map((s) => s.name);
+                    let mcpReconnected = 0;
+                    for (const name of names) {
+                        try {
+                            const cfg = deps.mcpStore.get(name);
+                            if (!cfg || cfg.enabled === false)
+                                continue;
+                            await deps.mcp.disconnect(name);
+                            await deps.mcp.connect(cfg);
+                            mcpReconnected++;
+                        }
+                        catch (e) {
+                            logger.warn("mcp reload failed for server", { name, error: e.message });
+                        }
+                    }
+                    out["mcpServers"] = mcpReconnected;
+                    // Scheduler
+                    deps.scheduler.stop();
+                    deps.scheduler.start();
+                    out["schedulerRunning"] = deps.scheduler.isRunning;
+                    // Channels
+                    await deps.channels.stopAll();
+                    await deps.channels.startAll();
+                    out["channels"] = deps.channels.runningSet().size;
+                    // Caches
+                    out["searchCache"] = clearWebSearchCache();
+                    return { ...out, message: "Full reload complete" };
+                }
+            }
+        },
+    };
+}
+//# sourceMappingURL=reloadTool.js.map

package/dist/tools/core/reloadTool.js.map

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

package/dist/tools/core/replyToUser.d.ts

@@ -0,0 +1,14 @@
+import { z } from "zod";
+import type { ToolDef } from "../types.js";
+declare const inputSchema: z.ZodObject<{
+    message: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+}, {
+    message: string;
+}>;
+export declare const replyToUserTool: ToolDef<typeof inputSchema, {
+    delivered: boolean;
+}>;
+export {};
+//# sourceMappingURL=replyToUser.d.ts.map

package/dist/tools/core/replyToUser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replyToUser.d.ts","sourceRoot":"","sources":["../../../src/tools/core/replyToUser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,QAAA,MAAM,WAAW;;;;;;EAEf,CAAC;AAEH,eAAO,MAAM,eAAe,EAAE,OAAO,CAAC,OAAO,WAAW,EAAE;IAAE,SAAS,EAAE,OAAO,CAAA;CAAE,CAa/E,CAAC"}

package/dist/tools/core/replyToUser.js

@@ -0,0 +1,19 @@
+import { z } from "zod";
+const inputSchema = z.object({
+    message: z.string().min(1).max(10_000).describe("Text to send to the user immediately, mid-task."),
+});
+export const replyToUserTool = {
+    name: "reply_to_user",
+    description: "Send a message to the user mid-task without stopping. Use for progress updates or acknowledgements while continuing work.",
+    category: "core",
+    source: { kind: "core" },
+    alwaysOn: true,
+    inputSchema,
+    async execute({ message }, { logger }) {
+        // In the SSE stream, this surfaces as a text:delta event.
+        // The agent loop translates it. For now, log + return.
+        logger.info("reply_to_user called", { messageLength: message.length });
+        return { delivered: true };
+    },
+};
+//# sourceMappingURL=replyToUser.js.map

package/dist/tools/core/replyToUser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replyToUser.js","sourceRoot":"","sources":["../../../src/tools/core/replyToUser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,iDAAiD,CAAC;CACnG,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAwD;IAClF,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,2HAA2H;IACxI,QAAQ,EAAE,MAAM;IAChB,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;IACxB,QAAQ,EAAE,IAAI;IACd,WAAW;IACX,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE;QACnC,0DAA0D;QAC1D,uDAAuD;QACvD,MAAM,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,aAAa,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QACvE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IAC7B,CAAC;CACF,CAAC"}

package/dist/tools/core/screenCapture.d.ts

@@ -0,0 +1,17 @@
+import { z } from "zod";
+import type { ToolDef } from "../types.js";
+declare const inputSchema: z.ZodObject<{
+    outputPath: z.ZodOptional<z.ZodString>;
+    display: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    display: number;
+    outputPath?: string | undefined;
+}, {
+    outputPath?: string | undefined;
+    display?: number | undefined;
+}>;
+export declare const screenCaptureTool: ToolDef<typeof inputSchema, {
+    path: string;
+}>;
+export {};
+//# sourceMappingURL=screenCapture.d.ts.map

package/dist/tools/core/screenCapture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenCapture.d.ts","sourceRoot":"","sources":["../../../src/tools/core/screenCapture.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,QAAA,MAAM,WAAW;;;;;;;;;EAGf,CAAC;AAEH,eAAO,MAAM,iBAAiB,EAAE,OAAO,CAAC,OAAO,WAAW,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAwB3E,CAAC"}

package/dist/tools/core/screenCapture.js

@@ -0,0 +1,34 @@
+import { spawn } from "node:child_process";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { z } from "zod";
+const inputSchema = z.object({
+    outputPath: z.string().optional().describe("Where to save. Defaults to temp dir."),
+    display: z.number().int().default(1).describe("Display number (multi-monitor). Default 1."),
+});
+export const screenCaptureTool = {
+    name: "screen_capture",
+    description: "Take a screenshot of the current screen. macOS uses screencapture, Linux uses import/scrot.",
+    category: "system",
+    source: { kind: "core" },
+    alwaysOn: false,
+    tags: ["screenshot", "screen", "capture"],
+    inputSchema,
+    async execute({ outputPath, display }) {
+        const path = outputPath ?? join(tmpdir(), `daemora-screenshot-${Date.now()}.png`);
+        return new Promise((resolve, reject) => {
+            const args = process.platform === "darwin"
+                ? ["screencapture", "-x", `-D${display}`, path]
+                : ["import", "-window", "root", path]; // ImageMagick on Linux
+            const child = spawn(args[0], args.slice(1), { stdio: "ignore" });
+            child.once("close", (code) => {
+                if (code === 0)
+                    resolve({ path });
+                else
+                    reject(new Error(`Screen capture failed (exit ${code})`));
+            });
+            child.once("error", (e) => reject(e));
+        });
+    },
+};
+//# sourceMappingURL=screenCapture.js.map

package/dist/tools/core/screenCapture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenCapture.js","sourceRoot":"","sources":["../../../src/tools/core/screenCapture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;IAClF,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,4CAA4C,CAAC;CAC5F,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAkD;IAC9E,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE,6FAA6F;IAC1G,QAAQ,EAAE,QAAQ;IAClB,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;IACxB,QAAQ,EAAE,KAAK;IACf,IAAI,EAAE,CAAC,YAAY,EAAE,QAAQ,EAAE,SAAS,CAAC;IACzC,WAAW;IACX,KAAK,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE;QACnC,MAAM,IAAI,GAAG,UAAU,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,sBAAsB,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAElF,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,KAAK,QAAQ;gBACxC,CAAC,CAAC,CAAC,eAAe,EAAE,IAAI,EAAE,KAAK,OAAO,EAAE,EAAE,IAAI,CAAC;gBAC/C,CAAC,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,uBAAuB;YAEhE,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YAClE,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;gBAC3B,IAAI,IAAI,KAAK,CAAC;oBAAE,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;;oBAC7B,MAAM,CAAC,IAAI,KAAK,CAAC,+BAA+B,IAAI,GAAG,CAAC,CAAC,CAAC;YACjE,CAAC,CAAC,CAAC;YACH,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/tools/core/sendEmail.d.ts

@@ -0,0 +1,34 @@
+import { z } from "zod";
+import type { ConfigManager } from "../../config/ConfigManager.js";
+import type { ToolDef } from "../types.js";
+declare const inputSchema: z.ZodObject<{
+    to: z.ZodString;
+    subject: z.ZodString;
+    body: z.ZodString;
+    cc: z.ZodOptional<z.ZodString>;
+    bcc: z.ZodOptional<z.ZodString>;
+    replyTo: z.ZodOptional<z.ZodString>;
+    html: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    body: string;
+    subject: string;
+    to: string;
+    html: boolean;
+    cc?: string | undefined;
+    bcc?: string | undefined;
+    replyTo?: string | undefined;
+}, {
+    body: string;
+    subject: string;
+    to: string;
+    html?: boolean | undefined;
+    cc?: string | undefined;
+    bcc?: string | undefined;
+    replyTo?: string | undefined;
+}>;
+export declare function makeSendEmailTool(cfg: ConfigManager): ToolDef<typeof inputSchema, {
+    sent: boolean;
+    to: string;
+}>;
+export {};
+//# sourceMappingURL=sendEmail.d.ts.map

package/dist/tools/core/sendEmail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendEmail.d.ts","sourceRoot":"","sources":["../../../src/tools/core/sendEmail.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAEnE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;EAQf,CAAC;AAEH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,WAAW,EAAE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CAyChH"}

package/dist/tools/core/sendEmail.js

@@ -0,0 +1,56 @@
+import { z } from "zod";
+import { ProviderUnavailableError } from "../../util/errors.js";
+const inputSchema = z.object({
+    to: z.string().min(1).describe("Recipient email address(es), comma-separated."),
+    subject: z.string().min(1).max(200),
+    body: z.string().min(1).describe("Email body (plain text or HTML)."),
+    cc: z.string().optional(),
+    bcc: z.string().optional(),
+    replyTo: z.string().optional(),
+    html: z.boolean().default(false).describe("If true, body is treated as HTML."),
+});
+export function makeSendEmailTool(cfg) {
+    return {
+        name: "send_email",
+        description: "Send an email via Resend API. Requires RESEND_API_KEY in vault.",
+        category: "channel",
+        source: { kind: "core" },
+        alwaysOn: false,
+        destructive: true,
+        tags: ["email", "send", "message"],
+        inputSchema,
+        async execute({ to, subject, body, cc, bcc, replyTo, html }) {
+            const apiKey = cfg.vault.get("RESEND_API_KEY")?.reveal();
+            if (!apiKey)
+                throw new ProviderUnavailableError("Email (Resend)", "RESEND_API_KEY");
+            const fromAddress = cfg.settings.getGeneric("RESEND_FROM") ?? "Daemora <daemora@resend.dev>";
+            const payload = {
+                from: fromAddress,
+                to: to.split(",").map((e) => e.trim()),
+                subject,
+            };
+            if (html)
+                payload.html = body;
+            else
+                payload.text = body;
+            if (cc)
+                payload.cc = cc.split(",").map((e) => e.trim());
+            if (bcc)
+                payload.bcc = bcc.split(",").map((e) => e.trim());
+            if (replyTo)
+                payload.reply_to = replyTo;
+            const res = await fetch("https://api.resend.com/emails", {
+                method: "POST",
+                headers: { "Content-Type": "application/json", Authorization: `Bearer ${apiKey}` },
+                body: JSON.stringify(payload),
+                signal: AbortSignal.timeout(15_000),
+            });
+            if (!res.ok) {
+                const err = await res.text().catch(() => "");
+                throw new Error(`Resend API ${res.status}: ${err.slice(0, 200)}`);
+            }
+            return { sent: true, to };
+        },
+    };
+}
+//# sourceMappingURL=sendEmail.js.map

package/dist/tools/core/sendEmail.js.map

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

package/dist/tools/core/sendFile.d.ts

@@ -0,0 +1,37 @@
+/**
+ * send_file — deliver a local file to the originating user on their
+ * channel.
+ *
+ * Zero-config call: `send_file({ path, caption? })`. Routing is
+ * automatic — the active task's channelMeta is looked up in
+ * ChannelManager by taskId, so the agent never has to know which chat
+ * on which platform it's talking to.
+ *
+ * Each channel's `sendFile` override decides what "upload" means:
+ *   discord   → multipart attachment (files[0] + payload_json)
+ *   telegram  → sendPhoto / sendVideo / sendAudio / sendDocument
+ *   slack     → files.uploadV2 3-step flow
+ *   whatsapp  → Twilio MediaUrl (needs PUBLIC_URL set)
+ *   teams / googlechat → per-channel handlers (where implemented)
+ *
+ * Tasks without a channel (chat-UI, voice, cron fan-out) return a
+ * benign "file is visible in the chat" message — the web UI already
+ * renders local paths inline via /api/file.
+ */
+import { z } from "zod";
+import type { ChannelManager } from "../../channels/ChannelManager.js";
+import type { FilesystemGuard } from "../../safety/FilesystemGuard.js";
+import type { ToolDef } from "../types.js";
+declare const inputSchema: z.ZodObject<{
+    path: z.ZodString;
+    caption: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    caption?: string | undefined;
+}, {
+    path: string;
+    caption?: string | undefined;
+}>;
+export declare function makeSendFileTool(guard: FilesystemGuard, channels: ChannelManager): ToolDef<typeof inputSchema, string>;
+export {};
+//# sourceMappingURL=sendFile.d.ts.map

package/dist/tools/core/sendFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendFile.d.ts","sourceRoot":"","sources":["../../../src/tools/core/sendFile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAEvE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAK3C,QAAA,MAAM,WAAW;;;;;;;;;EAGf,CAAC;AAEH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,eAAe,EACtB,QAAQ,EAAE,cAAc,GACvB,OAAO,CAAC,OAAO,WAAW,EAAE,MAAM,CAAC,CAuBrC"}

package/dist/tools/core/sendFile.js

@@ -0,0 +1,53 @@
+/**
+ * send_file — deliver a local file to the originating user on their
+ * channel.
+ *
+ * Zero-config call: `send_file({ path, caption? })`. Routing is
+ * automatic — the active task's channelMeta is looked up in
+ * ChannelManager by taskId, so the agent never has to know which chat
+ * on which platform it's talking to.
+ *
+ * Each channel's `sendFile` override decides what "upload" means:
+ *   discord   → multipart attachment (files[0] + payload_json)
+ *   telegram  → sendPhoto / sendVideo / sendAudio / sendDocument
+ *   slack     → files.uploadV2 3-step flow
+ *   whatsapp  → Twilio MediaUrl (needs PUBLIC_URL set)
+ *   teams / googlechat → per-channel handlers (where implemented)
+ *
+ * Tasks without a channel (chat-UI, voice, cron fan-out) return a
+ * benign "file is visible in the chat" message — the web UI already
+ * renders local paths inline via /api/file.
+ */
+import { existsSync, statSync } from "node:fs";
+import { z } from "zod";
+import { NotFoundError, ValidationError } from "../../util/errors.js";
+/** 50 MB — most chat platforms reject larger uploads. */
+const MAX_FILE_BYTES = 50 * 1024 * 1024;
+const inputSchema = z.object({
+    path: z.string().min(1).describe("Absolute path to the local file to send."),
+    caption: z.string().max(1024).optional().describe("Optional text shown alongside the file."),
+});
+export function makeSendFileTool(guard, channels) {
+    return {
+        name: "send_file",
+        description: "Send a local file (image, video, document, audio) to the user on the originating channel. Use this after generate_image, screen_capture, create_document, or any tool that produced a file the user asked for — don't just mention the path, actually deliver it.",
+        category: "channel",
+        source: { kind: "core" },
+        tags: ["channel", "send", "file", "upload"],
+        inputSchema,
+        async execute({ path, caption }, { taskId }) {
+            const canonical = guard.ensureAllowed(path, "read");
+            if (!existsSync(canonical))
+                throw new NotFoundError(`File not found: ${canonical}`);
+            const s = statSync(canonical);
+            if (!s.isFile())
+                throw new ValidationError(`Not a file: ${canonical}`);
+            if (s.size > MAX_FILE_BYTES) {
+                throw new ValidationError(`File too large (${(s.size / 1024 / 1024).toFixed(1)} MB). Limit is ${MAX_FILE_BYTES / 1024 / 1024} MB.`);
+            }
+            const res = await channels.sendFileForTask(taskId, canonical, caption);
+            return res.message;
+        },
+    };
+}
+//# sourceMappingURL=sendFile.js.map

package/dist/tools/core/sendFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendFile.js","sourceRoot":"","sources":["../../../src/tools/core/sendFile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGtE,yDAAyD;AACzD,MAAM,cAAc,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAExC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,0CAA0C,CAAC;IAC5E,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;CAC7F,CAAC,CAAC;AAEH,MAAM,UAAU,gBAAgB,CAC9B,KAAsB,EACtB,QAAwB;IAExB,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,WAAW,EACT,mQAAmQ;QACrQ,QAAQ,EAAE,SAAS;QACnB,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;QACxB,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC;QAC3C,WAAW;QACX,KAAK,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE;YACzC,MAAM,SAAS,GAAG,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACpD,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;gBAAE,MAAM,IAAI,aAAa,CAAC,mBAAmB,SAAS,EAAE,CAAC,CAAC;YACpF,MAAM,CAAC,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;YAC9B,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE;gBAAE,MAAM,IAAI,eAAe,CAAC,eAAe,SAAS,EAAE,CAAC,CAAC;YACvE,IAAI,CAAC,CAAC,IAAI,GAAG,cAAc,EAAE,CAAC;gBAC5B,MAAM,IAAI,eAAe,CACvB,mBAAmB,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,kBAAkB,cAAc,GAAG,IAAI,GAAG,IAAI,MAAM,CACzG,CAAC;YACJ,CAAC;YACD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;YACvE,OAAO,GAAG,CAAC,OAAO,CAAC;QACrB,CAAC;KACF,CAAC;AACJ,CAAC"}