@polpo-ai/tools 0.2.4

package/dist/docx-tools.js

@@ -0,0 +1,236 @@
+/**
+ * Word/DOCX tools for document operations.
+ *
+ * Provides tools for agents to:
+ * - Read .docx files (extract text, HTML, or Markdown)
+ * - Create .docx files with rich content (headings, paragraphs, tables, lists)
+ *
+ * Uses `mammoth` for reading and `docx` for creation.
+ * All file operations enforce path sandboxing.
+ */
+import { writeFileSync, mkdirSync } from "node:fs";
+import { resolve, dirname } from "node:path";
+import { Type } from "@sinclair/typebox";
+import { resolveAllowedPaths, assertPathAllowed } from "./path-sandbox.js";
+const MAX_TEXT_OUTPUT = 50_000;
+/** Convert basic HTML to Markdown (headings, paragraphs, lists, bold, italic) */
+function htmlToBasicMarkdown(html) {
+    return html
+        // Headings
+        .replace(/<h1[^>]*>(.*?)<\/h1>/gi, "# $1\n\n")
+        .replace(/<h2[^>]*>(.*?)<\/h2>/gi, "## $1\n\n")
+        .replace(/<h3[^>]*>(.*?)<\/h3>/gi, "### $1\n\n")
+        .replace(/<h4[^>]*>(.*?)<\/h4>/gi, "#### $1\n\n")
+        .replace(/<h5[^>]*>(.*?)<\/h5>/gi, "##### $1\n\n")
+        .replace(/<h6[^>]*>(.*?)<\/h6>/gi, "###### $1\n\n")
+        // Bold/italic
+        .replace(/<strong>(.*?)<\/strong>/gi, "**$1**")
+        .replace(/<em>(.*?)<\/em>/gi, "*$1*")
+        .replace(/<b>(.*?)<\/b>/gi, "**$1**")
+        .replace(/<i>(.*?)<\/i>/gi, "*$1*")
+        // Lists
+        .replace(/<li>(.*?)<\/li>/gi, "- $1\n")
+        .replace(/<\/?[ou]l[^>]*>/gi, "\n")
+        // Paragraphs and breaks
+        .replace(/<p[^>]*>(.*?)<\/p>/gi, "$1\n\n")
+        .replace(/<br\s*\/?>/gi, "\n")
+        // Links
+        .replace(/<a[^>]*href="([^"]*)"[^>]*>(.*?)<\/a>/gi, "[$2]($1)")
+        // Strip remaining tags
+        .replace(/<[^>]+>/g, "")
+        // Clean up whitespace
+        .replace(/\n{3,}/g, "\n\n")
+        .trim();
+}
+// ─── Tool: docx_read ───
+const DocxReadSchema = Type.Object({
+    path: Type.String({ description: "Path to .docx file" }),
+    format: Type.Optional(Type.Union([
+        Type.Literal("text"),
+        Type.Literal("markdown"),
+        Type.Literal("html"),
+    ], { description: "Output format: 'text' (plain), 'markdown', or 'html'. Default: 'text'" })),
+});
+function createDocxReadTool(cwd, sandbox) {
+    return {
+        name: "docx_read",
+        label: "Read DOCX",
+        description: "Read a Word document (.docx) and extract its content as plain text, Markdown, or HTML. " +
+            "Preserves document structure (headings, lists, tables).",
+        parameters: DocxReadSchema,
+        async execute(_id, params) {
+            const filePath = resolve(cwd, params.path);
+            assertPathAllowed(filePath, sandbox, "docx_read");
+            try {
+                const mammoth = await import("mammoth");
+                const format = params.format ?? "text";
+                let result;
+                if (format === "html") {
+                    result = await mammoth.convertToHtml({ path: filePath });
+                }
+                else if (format === "markdown") {
+                    // mammoth doesn't export convertToMarkdown in all versions — use HTML + basic conversion
+                    const htmlResult = await mammoth.convertToHtml({ path: filePath });
+                    const md = htmlToBasicMarkdown(htmlResult.value);
+                    result = { value: md, messages: htmlResult.messages };
+                }
+                else {
+                    result = await mammoth.extractRawText({ path: filePath });
+                }
+                const text = result.value;
+                const warnings = result.messages
+                    .filter((m) => m.type === "warning")
+                    .map((m) => m.message);
+                const truncated = text.length > MAX_TEXT_OUTPUT
+                    ? text.slice(0, MAX_TEXT_OUTPUT) + `\n[truncated — ${text.length} total chars]`
+                    : text;
+                const warningText = warnings.length > 0
+                    ? `\nWarnings: ${warnings.join("; ")}`
+                    : "";
+                return {
+                    content: [{ type: "text", text: `DOCX (${format}): ${text.length} chars${warningText}\n\n${truncated}` }],
+                    details: { path: filePath, format, chars: text.length, warnings },
+                };
+            }
+            catch (err) {
+                return {
+                    content: [{ type: "text", text: `DOCX read error: ${err.message}` }],
+                    details: { error: err.message },
+                };
+            }
+        },
+    };
+}
+// ─── Tool: docx_create ───
+const DocxCreateSchema = Type.Object({
+    path: Type.String({ description: "Output .docx file path" }),
+    title: Type.Optional(Type.String({ description: "Document title (appears as the first heading)" })),
+    content: Type.Array(Type.Object({
+        type: Type.Union([
+            Type.Literal("heading"),
+            Type.Literal("paragraph"),
+            Type.Literal("bullet"),
+            Type.Literal("numbered"),
+        ], { description: "Block type" }),
+        text: Type.String({ description: "Text content" }),
+        level: Type.Optional(Type.Number({ description: "Heading level 1-6 (for type 'heading')" })),
+        bold: Type.Optional(Type.Boolean({ description: "Bold text" })),
+        italic: Type.Optional(Type.Boolean({ description: "Italic text" })),
+    }), { description: "Document content blocks", minItems: 1 }),
+});
+function createDocxCreateTool(cwd, sandbox) {
+    return {
+        name: "docx_create",
+        label: "Create DOCX",
+        description: "Create a Word document (.docx) with headings, paragraphs, bullet lists, and numbered lists. " +
+            "Supports bold and italic text formatting.",
+        parameters: DocxCreateSchema,
+        async execute(_id, params) {
+            const filePath = resolve(cwd, params.path);
+            assertPathAllowed(filePath, sandbox, "docx_create");
+            mkdirSync(dirname(filePath), { recursive: true });
+            try {
+                const docxModule = await import("docx");
+                const { Document, Paragraph, TextRun, HeadingLevel, Packer, AlignmentType, NumberFormat, } = docxModule;
+                const headingMap = {
+                    1: HeadingLevel.HEADING_1,
+                    2: HeadingLevel.HEADING_2,
+                    3: HeadingLevel.HEADING_3,
+                    4: HeadingLevel.HEADING_4,
+                    5: HeadingLevel.HEADING_5,
+                    6: HeadingLevel.HEADING_6,
+                };
+                const children = [];
+                // Title
+                if (params.title) {
+                    children.push(new Paragraph({
+                        text: params.title,
+                        heading: HeadingLevel.TITLE,
+                    }));
+                }
+                // Content blocks
+                for (const block of params.content) {
+                    const textRun = new TextRun({
+                        text: block.text,
+                        bold: block.bold,
+                        italics: block.italic,
+                    });
+                    switch (block.type) {
+                        case "heading":
+                            children.push(new Paragraph({
+                                children: [textRun],
+                                heading: headingMap[block.level ?? 1] ?? HeadingLevel.HEADING_1,
+                            }));
+                            break;
+                        case "paragraph":
+                            children.push(new Paragraph({
+                                children: [textRun],
+                            }));
+                            break;
+                        case "bullet":
+                            children.push(new Paragraph({
+                                children: [textRun],
+                                bullet: { level: 0 },
+                            }));
+                            break;
+                        case "numbered":
+                            children.push(new Paragraph({
+                                children: [textRun],
+                                numbering: { reference: "default-numbering", level: 0 },
+                            }));
+                            break;
+                    }
+                }
+                // Check if we need numbered lists
+                const hasNumbered = params.content.some(b => b.type === "numbered");
+                const numbering = hasNumbered ? {
+                    config: [{
+                            reference: "default-numbering",
+                            levels: [{
+                                    level: 0,
+                                    format: NumberFormat.DECIMAL,
+                                    text: "%1.",
+                                    alignment: AlignmentType.START,
+                                }],
+                        }],
+                } : undefined;
+                const doc = new Document({
+                    numbering,
+                    sections: [{ children }],
+                });
+                const buffer = await Packer.toBuffer(doc);
+                writeFileSync(filePath, buffer);
+                return {
+                    content: [{ type: "text", text: `DOCX created: ${filePath} (${params.content.length} blocks, ${buffer.byteLength} bytes)` }],
+                    details: { path: filePath, blocks: params.content.length, bytes: buffer.byteLength },
+                };
+            }
+            catch (err) {
+                return {
+                    content: [{ type: "text", text: `DOCX create error: ${err.message}` }],
+                    details: { error: err.message },
+                };
+            }
+        },
+    };
+}
+export const ALL_DOCX_TOOL_NAMES = ["docx_read", "docx_create"];
+/**
+ * Create Word/DOCX tools.
+ *
+ * @param cwd - Working directory
+ * @param allowedPaths - Sandbox paths
+ * @param allowedTools - Optional filter
+ */
+export function createDocxTools(cwd, allowedPaths, allowedTools) {
+    const sandbox = resolveAllowedPaths(cwd, allowedPaths);
+    const factories = {
+        docx_read: () => createDocxReadTool(cwd, sandbox),
+        docx_create: () => createDocxCreateTool(cwd, sandbox),
+    };
+    const names = allowedTools
+        ? ALL_DOCX_TOOL_NAMES.filter(n => allowedTools.some(a => a.toLowerCase() === n))
+        : ALL_DOCX_TOOL_NAMES;
+    return names.map(n => factories[n]());
+}
+//# sourceMappingURL=docx-tools.js.map

package/dist/docx-tools.js.map

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

package/dist/email-tools.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Email tools for sending and reading messages via SMTP/IMAP.
+ *
+ * Provides tools for agents to:
+ * - Send emails with HTML or plain text (SMTP)
+ * - Save draft emails to IMAP Drafts folder
+ * - Add attachments from local files
+ * - Send to multiple recipients (to, cc, bcc)
+ * - List, read, and search emails (IMAP)
+ *
+ * Credential resolution order:
+ *   1. Tool parameters (explicit overrides)
+ *   2. Agent vault (per-agent credentials from polpo.json)
+ *   3. Environment variables (global fallback)
+ *
+ * SMTP env vars: SMTP_HOST, SMTP_PORT, SMTP_USER, SMTP_PASS, SMTP_FROM
+ * IMAP env vars: IMAP_HOST, IMAP_PORT, IMAP_USER, IMAP_PASS
+ */
+import type { AgentTool } from "@mariozechner/pi-agent-core";
+import type { ResolvedVault } from "./types.js";
+export type EmailToolName = "email_send" | "email_draft" | "email_verify" | "email_list" | "email_read" | "email_search" | "email_count" | "email_download_attachment";
+export declare const ALL_EMAIL_TOOL_NAMES: EmailToolName[];
+/**
+ * Create email tools.
+ *
+ * @param cwd - Working directory (for resolving attachment paths)
+ * @param allowedPaths - Sandbox paths
+ * @param allowedTools - Optional filter
+ * @param vault - Resolved vault credentials (per-agent SMTP/IMAP)
+ * @param emailAllowedDomains - Allowed recipient email domains (omit for unrestricted)
+ * @param outputDir - Per-task output directory for downloaded attachments
+ */
+export declare function createEmailTools(cwd: string, allowedPaths?: string[], allowedTools?: string[], vault?: ResolvedVault, emailAllowedDomains?: string[], outputDir?: string): AgentTool<any>[];
+//# sourceMappingURL=email-tools.d.ts.map

package/dist/email-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-tools.d.ts","sourceRoot":"","sources":["../src/email-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAE7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAoyBhD,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,aAAa,GAAG,cAAc,GAAG,YAAY,GAAG,YAAY,GAAG,cAAc,GAAG,aAAa,GAAG,2BAA2B,CAAC;AAEvK,eAAO,MAAM,oBAAoB,EAAE,aAAa,EAA0I,CAAC;AAE3L;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,EAAE,KAAK,CAAC,EAAE,aAAa,EAAE,mBAAmB,CAAC,EAAE,MAAM,EAAE,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,EAAE,CAmB3L"}