hoomanjs 1.46.0 → 1.55.0

package/dist/core/theme.js

@@ -0,0 +1,14 @@
+/**
+ * Shared brand palette for CLI Ink surfaces (and any other non-webview UI).
+ * VS Code webviews mirror these values in `src/vscode/webview/index.css`.
+ */
+export const theme = {
+    primary: "#0091cd",
+    secondary: "#56a0d3",
+    warning: "#ecb731",
+    error: "#ee4c58",
+    success: "#8ec06c",
+    info: "#c4dff6",
+    muted: "#9ba5a8",
+};
+//# sourceMappingURL=theme.js.map

package/dist/core/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../src/core/theme.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,SAAS;IACpB,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;CACR,CAAC"}

package/dist/core/tools/ask-user.d.ts

@@ -13,7 +13,7 @@ export declare const ASK_USER_TOOL_NAME = "ask_user";
 export type AskUserRequest = {
     /** The question to present to the user. */
     question: string;
-    /** 2–5 answer choices, in display order. */
+    /** 2–6 answer choices, in display order. */
     options: string[];
     /** Tool-use id of the `ask_user` call, for frontends that key UI on it. */
     toolUseId?: string;

package/dist/core/tools/ask-user.js

@@ -2,7 +2,7 @@ import { tool } from "@strands-agents/sdk";
 import { z } from "zod";
 export const ASK_USER_TOOL_NAME = "ask_user";
 const MIN_OPTIONS = 2;
-const MAX_OPTIONS = 5;
+const MAX_OPTIONS = 6;
 /** Keyed by the Strands agent instance so backends are never serialized. */
 const backends = new WeakMap();
 export function setAskUserBackend(agent, backend) {

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

@@ -0,0 +1,8 @@
+import type { JSONValue } from "@strands-agents/sdk";
+export declare const EXPORT_DESIGN_TOOL_NAME = "export_design";
+export declare function createExportTools(): import("@strands-agents/sdk").InvokableTool<{
+    path: string;
+    format: "pdf" | "pptx" | "sketch" | "images-to-pdf" | "images" | "figma" | "figma-deck";
+    out?: string | undefined;
+    title?: string | undefined;
+}, JSONValue>[];

package/dist/core/tools/export.js

@@ -0,0 +1,202 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname, isAbsolute, join } from "node:path";
+import { tool } from "@strands-agents/sdk";
+import { z } from "zod";
+import { getCwd } from "../utils/cwd-context.js";
+import { buildScreenshotDeck, buildScreenshotFig, buildScreenshotPdf, buildScreenshotPptx, buildScreenshotSketch, defaultExportPath, renderHtmlToImages, renderHtmlToPdfBuffer, } from "../utils/export-design.js";
+import { isResolvedPathInsideDir, normalizeUserPath, } from "../utils/normalize-user-path.js";
+export const EXPORT_DESIGN_TOOL_NAME = "export_design";
+const EXPORT_FORMATS = [
+    "pdf",
+    "images-to-pdf",
+    "images",
+    "pptx",
+    "figma",
+    "figma-deck",
+    "sketch",
+];
+const DELIVERY_FORMATS = "pdf / images-to-pdf / pptx / figma / figma-deck / sketch";
+function toJsonValue(value) {
+    return JSON.parse(JSON.stringify(value));
+}
+function resolveHtml(raw) {
+    const cwd = getCwd();
+    const resolved = isAbsolute(raw.trim())
+        ? raw.trim()
+        : normalizeUserPath(raw.trim());
+    if (!isResolvedPathInsideDir(resolved, cwd)) {
+        throw new Error(`HTML path must stay under the session working directory (${cwd}).`);
+    }
+    return resolved;
+}
+function resolveOutPath(htmlPath, out, format) {
+    const cwd = getCwd();
+    if (out?.trim()) {
+        const target = isAbsolute(out.trim())
+            ? out.trim()
+            : normalizeUserPath(out.trim());
+        if (!isResolvedPathInsideDir(target, cwd)) {
+            throw new Error(`Output path must stay under the session working directory (${cwd}).`);
+        }
+        return target;
+    }
+    if (format === "images") {
+        // Visual QA default: reviews/ next to the HTML entry.
+        return join(dirname(htmlPath), "reviews");
+    }
+    const ext = format === "pptx"
+        ? "pptx"
+        : format === "figma"
+            ? "fig"
+            : format === "figma-deck"
+                ? "deck"
+                : format === "sketch"
+                    ? "sketch"
+                    : "pdf";
+    const target = defaultExportPath(htmlPath, ext);
+    if (!isResolvedPathInsideDir(target, cwd)) {
+        throw new Error(`Output path must stay under the session working directory (${cwd}).`);
+    }
+    return target;
+}
+function playwrightHint(message) {
+    if (/Executable doesn't exist|browserType\.launch/i.test(message)) {
+        return `${message} Install Chromium with: npx playwright install chromium`;
+    }
+    return message;
+}
+function imageFileName(index, total, jpeg) {
+    const ext = jpeg ? "jpg" : "png";
+    if (total <= 1) {
+        return `shot-01.${ext}`;
+    }
+    return `slide-${String(index + 1).padStart(2, "0")}.${ext}`;
+}
+async function writeImagePages(outDir, images) {
+    await mkdir(outDir, { recursive: true });
+    const written = [];
+    for (let i = 0; i < images.length; i++) {
+        const img = images[i];
+        if (!img) {
+            continue;
+        }
+        const filePath = join(outDir, imageFileName(i, images.length, img.jpeg));
+        await writeFile(filePath, img.buffer);
+        written.push(filePath);
+    }
+    return written;
+}
+export function createExportTools() {
+    return [
+        tool({
+            name: EXPORT_DESIGN_TOOL_NAME,
+            description: `Export or capture an HTML design artifact. Formats: images (screenshots under reviews/ by default — use for visual QA, then call launch_subagent with kind design-review, every returned path, and binary:true reads), pdf (Chromium print), images-to-pdf (pages → PDF), pptx (PowerPoint-ready .pptx), figma / figma-deck / sketch (Figma-ready .fig / .deck or Sketch-ready .sketch). Delivery formats (${DELIVERY_FORMATS}) only after visual QA (images + launch_subagent kind design-review, Must-fix empty or round cap reached).`,
+            inputSchema: z.object({
+                path: z
+                    .string()
+                    .min(1)
+                    .describe("Path to the HTML entry file (usually index.html)."),
+                format: z
+                    .enum(EXPORT_FORMATS)
+                    .describe("images = page screenshots (visual QA); pdf = Chromium print; images-to-pdf = pages → PDF; pptx = PowerPoint-ready .pptx; figma / figma-deck = Figma-ready .fig / .deck; sketch = Sketch-ready .sketch."),
+                out: z
+                    .string()
+                    .optional()
+                    .describe("Optional output path under the session cwd (.pdf / .pptx / .fig / .deck / .sketch file, or directory for images; images default to <html-dir>/reviews)."),
+                title: z
+                    .string()
+                    .optional()
+                    .describe("Optional presentation title (pptx / figma / figma-deck / sketch)."),
+            }),
+            callback: async (input) => {
+                try {
+                    const htmlPath = resolveHtml(input.path);
+                    const outPath = resolveOutPath(htmlPath, input.out, input.format);
+                    if (input.format === "pdf") {
+                        await mkdir(dirname(outPath), { recursive: true });
+                        const buffer = await renderHtmlToPdfBuffer(htmlPath);
+                        await writeFile(outPath, buffer);
+                        return toJsonValue({
+                            status: "ok",
+                            format: input.format,
+                            path: outPath,
+                            bytes: buffer.byteLength,
+                        });
+                    }
+                    if (input.format === "images-to-pdf") {
+                        await mkdir(dirname(outPath), { recursive: true });
+                        const images = await renderHtmlToImages({
+                            path: htmlPath,
+                            format: "png",
+                        });
+                        const buffer = await buildScreenshotPdf(images);
+                        await writeFile(outPath, buffer);
+                        return toJsonValue({
+                            status: "ok",
+                            format: input.format,
+                            path: outPath,
+                            bytes: buffer.byteLength,
+                            pages: images.length,
+                        });
+                    }
+                    if (input.format === "images") {
+                        const images = await renderHtmlToImages({
+                            path: htmlPath,
+                            format: "png",
+                        });
+                        const pages = await writeImagePages(outPath, images);
+                        return toJsonValue({
+                            status: "ok",
+                            format: input.format,
+                            path: outPath,
+                            pages,
+                            nextTool: "launch_subagent",
+                            nextKind: "design-review",
+                            nextQueryTemplate: `Visually review this design artifact. Entry: ${htmlPath}. Read EVERY screenshot below with read_file binary:true before judging layout. Flag overflow, overlap, clipping, cramped cards, and footer/chrome collisions as Must-fix.\n\nScreenshots:\n${pages.map((p) => `- ${p}`).join("\n")}`,
+                            hint: `Capture is not review. Your next tool call must be launch_subagent with kind design-review using nextQueryTemplate (or equivalent). Do not export_design with ${DELIVERY_FORMATS} or mark work complete until that review returns and Must-fix are addressed.`,
+                        });
+                    }
+                    if (input.format === "figma" ||
+                        input.format === "figma-deck" ||
+                        input.format === "sketch" ||
+                        input.format === "pptx") {
+                        await mkdir(dirname(outPath), { recursive: true });
+                        const images = await renderHtmlToImages({
+                            path: htmlPath,
+                            format: "png",
+                        });
+                        const buffer = input.format === "figma"
+                            ? await buildScreenshotFig(images, { title: input.title })
+                            : input.format === "figma-deck"
+                                ? await buildScreenshotDeck(images, { title: input.title })
+                                : input.format === "sketch"
+                                    ? buildScreenshotSketch(images, { title: input.title })
+                                    : await buildScreenshotPptx(images, {
+                                        title: input.title,
+                                    });
+                        await writeFile(outPath, buffer);
+                        return toJsonValue({
+                            status: "ok",
+                            format: input.format,
+                            path: outPath,
+                            bytes: buffer.byteLength,
+                            slides: images.length,
+                        });
+                    }
+                    return toJsonValue({
+                        status: "error",
+                        message: `Unsupported format: ${String(input.format)}`,
+                    });
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : String(error);
+                    return toJsonValue({
+                        status: "error",
+                        message: playwrightHint(message),
+                    });
+                }
+            },
+        }),
+    ];
+}
+//# sourceMappingURL=export.js.map

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

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

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

@@ -1,9 +1,11 @@
 import type { JSONValue } from "@strands-agents/sdk";
 export declare function createFetchTools(): import("@strands-agents/sdk").InvokableTool<{
     url: string;
+    save_as?: string | undefined;
     max_length?: number | undefined;
     start_index?: number | undefined;
     raw?: boolean | undefined;
     timeout?: number | undefined;
+    max_bytes?: number | undefined;
     headers?: Record<string, string> | undefined;
 }, JSONValue>[];

package/dist/core/tools/fetch.js

@@ -1,19 +1,26 @@
-import dns from "node:dns/promises";
-import net from "node:net";
-import { readFile } from "node:fs/promises";
+import { createWriteStream } from "node:fs";
+import { mkdir, readFile, unlink } from "node:fs/promises";
+import path from "node:path";
+import { Readable } from "node:stream";
+import { pipeline } from "node:stream/promises";
 import { Readability } from "@mozilla/readability";
 import { JSDOM } from "jsdom";
 import { tool } from "@strands-agents/sdk";
 import TurndownService from "turndown";
 import { z } from "zod";
+import { normalizeUserPath } from "../utils/normalize-user-path.js";
+import { assertRemoteUrl, isHttpUrl } from "../utils/url-safety.js";
 async function createUserAgent() {
     const packageUrl = new URL("../../../package.json", import.meta.url);
     const pkg = JSON.parse(await readFile(packageUrl, "utf8"));
     return `${pkg.name ?? "hoomanjs"}/${pkg.version ?? "0.0.0"}`;
 }
 const DEFAULT_TIMEOUT_SECONDS = 30;
+const DEFAULT_DOWNLOAD_TIMEOUT_SECONDS = 60;
 const DEFAULT_MAX_LENGTH = 5000;
 const MAX_FETCH_LENGTH = 1_000_000;
+const DEFAULT_MAX_BYTES = 100 * 1024 * 1024;
+const MAX_DOWNLOAD_BYTES = 1024 * 1024 * 1024;
 const turndown = new TurndownService({
     headingStyle: "atx",
     bulletListMarker: "-",
@@ -22,50 +29,6 @@ const turndown = new TurndownService({
 function toJsonValue(value) {
     return JSON.parse(JSON.stringify(value));
 }
-function isHttpUrl(value) {
-    const url = new URL(value);
-    if (url.protocol !== "http:" && url.protocol !== "https:") {
-        throw new Error("Only http:// and https:// URLs are supported.");
-    }
-    return url;
-}
-function isPrivateHostname(hostname) {
-    const normalized = hostname.toLowerCase();
-    return (normalized === "localhost" ||
-        normalized === "127.0.0.1" ||
-        normalized === "::1" ||
-        normalized.endsWith(".localhost"));
-}
-function isPrivateIp(address) {
-    const version = net.isIP(address);
-    if (version === 4) {
-        const parts = address.split(".").map((part) => Number(part));
-        const a = parts[0] ?? -1;
-        const b = parts[1] ?? -1;
-        return (a === 10 ||
-            a === 127 ||
-            (a === 172 && b >= 16 && b <= 31) ||
-            (a === 192 && b === 168) ||
-            (a === 169 && b === 254));
-    }
-    if (version === 6) {
-        const normalized = address.toLowerCase();
-        return (normalized === "::1" ||
-            normalized.startsWith("fc") ||
-            normalized.startsWith("fd") ||
-            normalized.startsWith("fe80:"));
-    }
-    return false;
-}
-async function assertRemoteUrl(url) {
-    if (isPrivateHostname(url.hostname)) {
-        throw new Error("Fetching localhost or loopback URLs is not allowed.");
-    }
-    const resolved = await dns.lookup(url.hostname, { all: true });
-    if (resolved.some((entry) => isPrivateIp(entry.address))) {
-        throw new Error("Fetching private-network URLs is not allowed.");
-    }
-}
 function responseHeaders(headers) {
     const out = {};
     headers.forEach((value, key) => {
@@ -120,43 +83,95 @@ function sliceContent(content, startIndex, maxLength) {
 function createFetchInputSchema() {
     return z.object({
         url: z.string().url().describe("Remote HTTP(S) URL to fetch."),
+        save_as: z
+            .string()
+            .min(1)
+            .optional()
+            .describe("When set, stream the response body to this local filesystem path instead of returning content text."),
         max_length: z.coerce
             .number()
             .int()
             .min(1)
             .max(MAX_FETCH_LENGTH)
             .optional()
-            .describe("Maximum number of characters to return."),
+            .describe("Maximum number of characters to return (ignored when save_as is set)."),
         start_index: z.coerce
             .number()
             .int()
             .min(0)
             .optional()
-            .describe("Start returning content from this character index."),
+            .describe("Start returning content from this character index (ignored when save_as is set)."),
         raw: z
             .boolean()
             .optional()
-            .describe("Return raw response text instead of simplifying HTML to markdown."),
+            .describe("Return raw response text instead of simplifying HTML to markdown (ignored when save_as is set)."),
         timeout: z.coerce
             .number()
             .positive()
             .optional()
             .describe("Request timeout in seconds."),
+        max_bytes: z.coerce
+            .number()
+            .int()
+            .min(1)
+            .max(MAX_DOWNLOAD_BYTES)
+            .optional()
+            .describe("Maximum number of bytes to write when save_as is set (default 100 MiB)."),
         headers: z
             .record(z.string(), z.string())
             .optional()
             .describe("Optional extra HTTP headers."),
     });
 }
+async function saveResponseToPath(options) {
+    const { url, response, filePath, maxBytes } = options;
+    if (!response.body) {
+        throw new Error(`Empty response body: GET ${url.toString()}`);
+    }
+    const contentLength = response.headers.get("content-length");
+    if (contentLength) {
+        const declared = Number(contentLength);
+        if (Number.isFinite(declared) && declared > maxBytes) {
+            throw new Error(`Remote content-length (${declared} bytes) exceeds max_bytes (${maxBytes}).`);
+        }
+    }
+    await mkdir(path.dirname(filePath), { recursive: true });
+    let bytesWritten = 0;
+    let wroteFile = false;
+    try {
+        const nodeStream = Readable.fromWeb(response.body);
+        nodeStream.on("data", (chunk) => {
+            bytesWritten +=
+                typeof chunk === "string" ? Buffer.byteLength(chunk) : chunk.byteLength;
+            if (bytesWritten > maxBytes) {
+                nodeStream.destroy(new Error(`Download exceeded max_bytes (${maxBytes}) after ${bytesWritten} bytes.`));
+            }
+        });
+        await pipeline(nodeStream, createWriteStream(filePath));
+        wroteFile = true;
+        return {
+            bytesWritten,
+            contentType: response.headers.get("content-type") ?? "",
+        };
+    }
+    catch (error) {
+        if (wroteFile || bytesWritten > 0) {
+            await unlink(filePath).catch(() => undefined);
+        }
+        throw error;
+    }
+}
 export function createFetchTools() {
     const inputSchema = createFetchInputSchema();
     return [
         tool({
             name: "fetch",
-            description: "Fetch a remote URL and return response content. HTML pages are simplified to markdown by default to save context window and tokens.",
+            description: "Fetch a remote URL and return response content, or save the response body to a local path with save_as. HTML pages are simplified to markdown by default to save context window and tokens.",
             inputSchema,
             callback: async (input, context) => {
-                const timeoutSeconds = input.timeout ?? DEFAULT_TIMEOUT_SECONDS;
+                const saveAs = input.save_as?.trim();
+                const timeoutSeconds = input.timeout ??
+                    (saveAs ? DEFAULT_DOWNLOAD_TIMEOUT_SECONDS : DEFAULT_TIMEOUT_SECONDS);
                 const timeoutSignal = AbortSignal.timeout(timeoutSeconds * 1000);
                 const signal = context
                     ? AbortSignal.any([timeoutSignal, context.agent.cancelSignal])
@@ -168,7 +183,9 @@ export function createFetchTools() {
                     headers.set("user-agent", await createUserAgent());
                 }
                 if (!headers.has("accept")) {
-                    headers.set("accept", "text/html,application/xhtml+xml,application/json,text/plain;q=0.9,*/*;q=0.5");
+                    headers.set("accept", saveAs
+                        ? "*/*"
+                        : "text/html,application/xhtml+xml,application/json,text/plain;q=0.9,*/*;q=0.5");
                 }
                 try {
                     const response = await fetch(url, {
@@ -177,11 +194,31 @@ export function createFetchTools() {
                         redirect: "follow",
                         signal,
                     });
-                    const text = await response.text();
-                    const contentType = response.headers.get("content-type") ?? "";
                     if (!response.ok) {
                         throw new Error(`HTTP ${response.status} ${response.statusText}: GET ${url.toString()}`);
                     }
+                    if (saveAs) {
+                        const filePath = normalizeUserPath(saveAs);
+                        const maxBytes = input.max_bytes ?? DEFAULT_MAX_BYTES;
+                        const saved = await saveResponseToPath({
+                            url,
+                            response,
+                            filePath,
+                            maxBytes,
+                        });
+                        return toJsonValue({
+                            url: url.toString(),
+                            saved_as: filePath,
+                            status: response.status,
+                            statusText: response.statusText,
+                            headers: responseHeaders(response.headers),
+                            content_type: saved.contentType || null,
+                            bytes_written: saved.bytesWritten,
+                            max_bytes: maxBytes,
+                        });
+                    }
+                    const text = await response.text();
+                    const contentType = response.headers.get("content-type") ?? "";
                     let transformed = text;
                     let transformedFormat = "raw";
                     let title;

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

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

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

@@ -34,7 +34,8 @@ export declare function createFilesystemTools(): (import("@strands-agents/sdk").
     paths: string[];
     offset?: number | undefined;
     limit?: number | undefined;
-}, string> | import("@strands-agents/sdk").InvokableTool<{
+    binary?: boolean | undefined;
+}, JSONValue> | import("@strands-agents/sdk").InvokableTool<{
     path: string;
     content: string;
     append?: boolean | undefined;

package/dist/core/tools/filesystem.js

@@ -1,12 +1,13 @@
 import { createHash } from "node:crypto";
 import fs from "node:fs/promises";
 import path from "node:path";
-import { tool } from "@strands-agents/sdk";
+import { tool, TextBlock, } from "@strands-agents/sdk";
 import { normalizeUserPath } from "../utils/normalize-user-path.js";
-import { resolveAgentInstructionsForFile } from "../prompts/runtime.js";
+import { resolveAgentInstructionsForFile } from "../prompts/runtime/agents.js";
 import { setFileToolDisplay, } from "../state/file-tool-display.js";
 import { readAttachmentAsBlocksOrBase64, } from "../utils/attachments.js";
 import { findReplacementSpan, unescapeModelText, } from "../utils/edit-replace.js";
+import { getLlmModality } from "../state/llm-modality.js";
 import { z } from "zod";
 import { createGitignorePredicate } from "../utils/gitignore.js";
 /** Keyed by the Strands agent instance so backends are never serialized. */
@@ -295,6 +296,7 @@ async function readBinaryFile(filePath, options) {
         includeMetadata: true,
         unsupportedFormat: "base64",
         onError: "throw",
+        metadata: options?.modality ?? null,
     });
 }
 function snippetAroundChange(content, index, replacementLength) {
@@ -498,6 +500,10 @@ function createFilesystemSchema() {
             paths: z.array(z.string()).min(1).describe("List of file paths to read."),
             offset: z.number().int().min(1).optional(),
             limit: z.number().int().min(1).optional(),
+            binary: z
+                .boolean()
+                .optional()
+                .describe("Read each path as binary. Images, videos, and documents become multimodal content blocks (when the model supports them); other binaries come back as base64. Offset/limit are ignored when binary is true."),
         }),
         writeFile: z.object({
             path: z.string().describe("File path to write."),
@@ -571,7 +577,12 @@ export function createFilesystemTools() {
                     // Binary reads can return SDK media blocks (ImageBlock / DocumentBlock)
                     // or a plain base64 JSON object. Both are accepted by FunctionTool's
                     // result wrapping, but the callback signature is JSONValue, so cast.
-                    const result = await readBinaryFile(filePath);
+                    // Pass the active LLM modality so images become ImageBlocks when the
+                    // model supports them (otherwise we emit a text fallback diagnostic).
+                    const modality = getLlmModality(context?.agent);
+                    const result = await readBinaryFile(filePath, {
+                        modality: modality ? { modality } : null,
+                    });
                     return result;
                 }
                 const result = await readTextFile(filePath, {
@@ -587,9 +598,32 @@ export function createFilesystemTools() {
         }),
         tool({
             name: "read_multiple_files",
-            description: "Read multiple text files in one call. Each file is returned independently with success or error details.",
+            description: "Read multiple files in one call. Defaults to UTF-8 text with optional shared offset/limit. Pass `binary: true` to read each path as binary/multimodal (images, videos, documents) the same way as read_file.",
             inputSchema: schema.readMultipleFiles,
             callback: async (input, context) => {
+                if (input.binary) {
+                    const modality = getLlmModality(context?.agent);
+                    const blocks = [];
+                    for (const itemPath of input.paths) {
+                        const filePath = normalizeUserPath(itemPath);
+                        blocks.push(new TextBlock(`==> ${filePath} <==`));
+                        try {
+                            const result = await readBinaryFile(filePath, {
+                                modality: modality ? { modality } : null,
+                            });
+                            if (Array.isArray(result)) {
+                                blocks.push(...result);
+                            }
+                            else {
+                                blocks.push(new TextBlock(JSON.stringify(result)));
+                            }
+                        }
+                        catch (error) {
+                            blocks.push(new TextBlock(`[Error: ${error instanceof Error ? error.message : String(error)}]`));
+                        }
+                    }
+                    return blocks;
+                }
                 const backend = getTextFsBackend(context?.agent);
                 const sections = await Promise.all(input.paths.map(async (itemPath) => {
                     const filePath = normalizeUserPath(itemPath);