@rubytech/taskmaster 1.1.0 → 1.1.1

package/dist/agents/taskmaster-tools.js

@@ -5,6 +5,7 @@ import { createBrowserTool } from "./tools/browser-tool.js";
 import { createCanvasTool } from "./tools/canvas-tool.js";
 import { createCronTool } from "./tools/cron-tool.js";
 import { createDocumentTool } from "./tools/document-tool.js";
+import { createDocumentToPdfTool } from "./tools/document-to-pdf-tool.js";
 import { createGatewayTool } from "./tools/gateway-tool.js";
 import { createImageTool } from "./tools/image-tool.js";
 import { createMemoryGetTool, createMemorySaveMediaTool, createMemorySearchTool, createMemoryWriteTool, } from "./tools/memory-tool.js";
@@ -133,6 +134,11 @@ export function createTaskmasterTools(options) {
             workspaceDir: options?.workspaceDir,
         }),
         ...(documentTool ? [documentTool] : []),
+        createDocumentToPdfTool({
+            config: options?.config,
+            agentSessionKey: options?.agentSessionKey,
+            sandboxRoot: options?.sandboxRoot,
+        }),
         createCurrentTimeTool({ config: options?.config }),
         createAuthorizeAdminTool(),
         createRevokeAdminTool(),

package/dist/agents/tool-policy.js

@@ -13,6 +13,7 @@ export const TOOL_GROUPS = {
         "message_history",
         "document_read",
     ],
+    "group:documents": ["document_read", "document_to_pdf"],
     "group:web": ["web_search", "web_fetch"],
     // Time/date utilities
     "group:time": ["current_time"],
@@ -57,6 +58,7 @@ export const TOOL_GROUPS = {
         "memory_write",
         "message_history",
         "document_read",
+        "document_to_pdf",
         "web_search",
         "web_fetch",
         "image",

package/dist/agents/tools/document-to-pdf-tool.js

@@ -0,0 +1,128 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+import { Type } from "@sinclair/typebox";
+import { resolveBrowserConfig } from "../../browser/config.js";
+import { resolveBrowserExecutableForPlatform } from "../../browser/chrome.executables.js";
+import { resolveAgentWorkspaceDir, resolveSessionAgentId } from "../agent-scope.js";
+import { assertSandboxPath } from "../sandbox-paths.js";
+import { jsonResult, readStringParam } from "./common.js";
+const DocumentToPdfSchema = Type.Object({
+    path: Type.String({
+        description: "Path to an HTML file. Use a memory path (e.g. memory/users/+447.../documents/invoices/INV-001.html) " +
+            "or an absolute path.",
+    }),
+});
+export function createDocumentToPdfTool(options) {
+    const cfg = options?.config;
+    const agentId = resolveSessionAgentId({
+        sessionKey: options?.agentSessionKey,
+        config: cfg,
+    });
+    // Get workspace dir for memory path resolution
+    const workspaceDir = cfg ? resolveAgentWorkspaceDir(cfg, agentId) : null;
+    const memoryDir = workspaceDir ? path.join(workspaceDir, "memory") : null;
+    return {
+        label: "Document to PDF",
+        name: "document_to_pdf",
+        description: "Convert an HTML file to PDF using a headless browser. " +
+            "The PDF is written to the same directory as the source file with a .pdf extension. " +
+            "Returns the absolute path to the generated PDF.",
+        parameters: DocumentToPdfSchema,
+        execute: async (_toolCallId, params) => {
+            const inputPath = readStringParam(params, "path", { required: true });
+            // ── Resolve the path ──────────────────────────────────────────────
+            let htmlPath;
+            try {
+                if (memoryDir && inputPath.startsWith("memory/")) {
+                    const relativePath = inputPath.slice("memory/".length);
+                    htmlPath = path.join(memoryDir, relativePath);
+                }
+                else if (memoryDir && !path.isAbsolute(inputPath) && !inputPath.startsWith(".")) {
+                    // Check if it exists in memory root
+                    const candidatePath = path.join(memoryDir, inputPath);
+                    try {
+                        await fs.stat(candidatePath);
+                        htmlPath = candidatePath;
+                    }
+                    catch {
+                        htmlPath = inputPath;
+                    }
+                }
+                else {
+                    htmlPath = inputPath;
+                }
+                if (!path.isAbsolute(htmlPath)) {
+                    htmlPath = path.resolve(htmlPath);
+                }
+                // Apply sandbox constraints if configured
+                const sandboxRoot = options?.sandboxRoot?.trim();
+                if (sandboxRoot) {
+                    const sandboxed = await assertSandboxPath({
+                        filePath: htmlPath,
+                        cwd: sandboxRoot,
+                        root: sandboxRoot,
+                    });
+                    htmlPath = sandboxed.resolved;
+                }
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                return jsonResult({ ok: false, error: `Path not accessible: ${message}` });
+            }
+            // ── Verify the HTML file exists ───────────────────────────────────
+            try {
+                await fs.stat(htmlPath);
+            }
+            catch (err) {
+                const anyErr = err;
+                if (anyErr.code === "ENOENT") {
+                    return jsonResult({ ok: false, error: `File not found: ${inputPath}` });
+                }
+                const message = err instanceof Error ? err.message : String(err);
+                return jsonResult({ ok: false, error: `Cannot access file: ${message}` });
+            }
+            // ── Determine output path ─────────────────────────────────────────
+            const parsed = path.parse(htmlPath);
+            const pdfPath = path.join(parsed.dir, `${parsed.name}.pdf`);
+            // ── Find Chrome executable ────────────────────────────────────────
+            const browserConfig = resolveBrowserConfig(cfg?.browser);
+            const exe = resolveBrowserExecutableForPlatform(browserConfig, process.platform);
+            if (!exe) {
+                return jsonResult({
+                    ok: false,
+                    error: "No Chrome/Chromium browser found. Install Chrome or configure browser.executablePath.",
+                });
+            }
+            // ── Generate PDF with Playwright ──────────────────────────────────
+            let browser = null;
+            try {
+                const { chromium } = await import("playwright-core");
+                browser = await chromium.launch({
+                    executablePath: exe.path,
+                    headless: true,
+                    args: ["--no-sandbox", "--disable-gpu"],
+                });
+                const page = await browser.newPage();
+                await page.goto(pathToFileURL(htmlPath).href, { waitUntil: "networkidle" });
+                const pdfBuffer = await page.pdf({ printBackground: true, format: "A4" });
+                await fs.writeFile(pdfPath, pdfBuffer);
+                return jsonResult({ ok: true, path: pdfPath });
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                return jsonResult({ ok: false, error: `PDF generation failed: ${message}` });
+            }
+            finally {
+                if (browser) {
+                    try {
+                        await browser.close();
+                    }
+                    catch {
+                        // Ignore close errors
+                    }
+                }
+            }
+        },
+    };
+}

package/dist/build-info.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.1.0",
-  "commit": "3f8e0229db78dc2244ee3af29903c5e2e9874d62",
-  "builtAt": "2026-02-24T11:25:47.903Z"
+  "version": "1.1.1",
+  "commit": "0c8513071e0c9ecf30e573e15ed8cd2bef18e515",
+  "builtAt": "2026-02-24T13:26:12.563Z"
 }

package/dist/cli/provision-seed.js

@@ -127,6 +127,7 @@ export function buildDefaultAgentList(workspaceRoot) {
                 "memory_write",
                 "memory_save_media",
                 "document_read",
+                "document_to_pdf",
                 "image",
                 "web_search",
                 "web_fetch",

package/dist/config/legacy.migrations.part-3.js

@@ -188,4 +188,32 @@ export const LEGACY_CONFIG_MIGRATIONS_PART_3 = [
             }
         },
     },
+    {
+        id: "admin-agent-tools-add-document_to_pdf",
+        describe: "Add document_to_pdf to admin agent tools.allow",
+        apply: (raw, changes) => {
+            const agents = getRecord(raw.agents);
+            const list = getAgentsList(agents);
+            for (const entry of list) {
+                if (!isRecord(entry))
+                    continue;
+                const id = typeof entry.id === "string" ? entry.id.trim() : "";
+                if (!id)
+                    continue;
+                const isAdmin = id === "admin" || id.endsWith("-admin");
+                if (!isAdmin)
+                    continue;
+                const tools = getRecord(entry.tools);
+                if (!tools)
+                    continue;
+                if (!Array.isArray(tools.allow))
+                    continue;
+                const allow = tools.allow;
+                if (!allow.includes("document_to_pdf")) {
+                    allow.push("document_to_pdf");
+                    changes.push(`Added document_to_pdf to agent "${id}" tools.allow.`);
+                }
+            }
+        },
+    },
 ];