omnifocus-mcp-enhanced 1.6.8 → 1.6.10

package/README.md

@@ -17,6 +17,8 @@ Enhanced Model Context Protocol (MCP) server for OmniFocus featuring **native cu
 
 ## 🆕 Latest Release
 
+- **v1.6.10** - Fixed Inbox task completion via `edit_item`, fixed AppleScript special-character handling for apostrophes/backslashes, fixed JSON result escaping for special characters, and clarified `batch_add_items` / `mcporter` usage with working examples.
+- **v1.6.9** - Added task attachment support: `get_task_by_id` now lists attachment metadata, `dump_database` exports attachment/link metadata, and new `read_task_attachment` returns image attachments as MCP image content when possible.
 - **v1.6.8** - Added stable task move support via `move_task` and `edit_item` (`newProjectId/newProjectName/newParentTaskId/newParentTaskName/moveToInbox`) with duplicate-name protection and cycle-prevention checks.
 - **v1.6.6** - Added full Planned Date support (create/edit/read/filter/sort/export), including `plannedDate`/`newPlannedDate` and updated task displays.
 
@@ -38,6 +40,7 @@ Enhanced Model Context Protocol (MCP) server for OmniFocus featuring **native cu
 - **📅 Time Management** - Due, defer, planned dates, estimates, and scheduling
 - **🏷️ Advanced Tagging** - Tag-based filtering with exact/partial matching
 - **🤖 AI Integration** - Seamless Claude AI integration for intelligent workflows
+- **🖼️ Attachment-Aware Reads** - Surface note attachments and linked files before deciding whether AI should inspect them
 
 ## 📦 Installation
 
@@ -215,6 +218,120 @@ Efficiently manage multiple tasks:
 }
 ```
 
+CLI tip for `mcporter`:
+
+```bash
+# Prefer explicit JSON args for complex arrays / nested objects
+mcporter call omnifocus.batch_add_items --args '{
+  "items": [
+    {
+      "type": "task",
+      "name": "Website Technical SEO",
+      "projectName": "SEO Project"
+    }
+  ]
+}'
+```
+
+If you pass a subtask with `parentTaskId` or `parentTaskName`, do not also pass `projectName`. Subtasks inherit the project from their parent task.
+
+Working `mcporter` examples:
+
+```bash
+# 1) Batch-create top-level tasks in a project
+mcporter call omnifocus.batch_add_items --args '{
+  "items": [
+    {
+      "type": "task",
+      "name": "Parent: Category A",
+      "projectName": "OmniFocus MCP Batch Test"
+    },
+    {
+      "type": "task",
+      "name": "Parent: Category B",
+      "projectName": "OmniFocus MCP Batch Test"
+    }
+  ]
+}'
+```
+
+```bash
+# 2) Create parent + child in one batch
+mcporter call omnifocus.batch_add_items --args '{
+  "items": [
+    {
+      "type": "task",
+      "name": "Parent: Category A",
+      "projectName": "OmniFocus MCP Batch Test"
+    },
+    {
+      "type": "task",
+      "name": "Child: A1",
+      "parentTaskName": "Parent: Category A"
+    }
+  ]
+}'
+```
+
+```bash
+# 3) Safer two-step flow when adding many subtasks to existing parents
+mcporter call omnifocus.batch_add_items --args '{
+  "items": [
+    {
+      "type": "task",
+      "name": "Child: A1",
+      "parentTaskName": "Parent: Category A"
+    },
+    {
+      "type": "task",
+      "name": "Child: A2",
+      "parentTaskName": "Parent: Category A"
+    },
+    {
+      "type": "task",
+      "name": "Child: B1",
+      "parentTaskName": "Parent: Category B"
+    }
+  ]
+}'
+```
+
+This will fail, by design:
+
+```bash
+mcporter call omnifocus.batch_add_items --args '{
+  "items": [
+    {
+      "type": "task",
+      "name": "Child: A1",
+      "projectName": "OmniFocus MCP Batch Test",
+      "parentTaskName": "Parent: Category A"
+    }
+  ]
+}'
+```
+
+Because a subtask must inherit its project from the parent task.
+
+### 6. 🖼️ Attachment Inspection
+
+Discover images and linked files on a task first, then read only the attachment you need:
+
+```bash
+# List task details plus attachment metadata
+get_task_by_id {
+  "taskId": "abc123"
+}
+
+# Open an attachment returned by get_task_by_id
+read_task_attachment {
+  "taskId": "abc123",
+  "attachmentId": "embedded-1"
+}
+```
+
+`get_task_by_id` now reports attachment IDs, names, MIME guesses, source (`embedded` vs `linked`), and sizes when available. `read_task_attachment` returns images as MCP image content when possible, so AI clients can inspect the image directly instead of parsing base64 from plain text.
+
 ## 🛠️ Complete Tool Reference
 
 ### 📊 Database & Task Management
@@ -226,21 +343,22 @@ Efficiently manage multiple tasks:
 6. **move_task** - Move an existing task to project/parent task/inbox
 7. **batch_add_items** - Bulk add (enhanced with subtask support)
 8. **batch_remove_items** - Bulk remove
-9. **get_task_by_id** - Query task information
+9. **get_task_by_id** - Query task information, including attachment metadata
+10. **read_task_attachment** - Read an attachment reported by `get_task_by_id`
 
 ### 🔍 Built-in Perspective Tools
-10. **get_inbox_tasks** - Inbox perspective
-11. **get_flagged_tasks** - Flagged perspective
-12. **get_forecast_tasks** - Forecast perspective (due/deferred/planned task data included)
-13. **get_tasks_by_tag** - Tag-based filtering
-14. **filter_tasks** - Ultimate filtering with unlimited combinations
+11. **get_inbox_tasks** - Inbox perspective
+12. **get_flagged_tasks** - Flagged perspective
+13. **get_forecast_tasks** - Forecast perspective (due/deferred/planned task data included)
+14. **get_tasks_by_tag** - Tag-based filtering
+15. **filter_tasks** - Ultimate filtering with unlimited combinations
 
 ### 🌟 Custom Perspective Tools (NEW)
-15. **list_custom_perspectives** - 🌟 **NEW**: List all custom perspectives with details
-16. **get_custom_perspective_tasks** - 🌟 **NEW**: Access custom perspective with hierarchical display
+16. **list_custom_perspectives** - 🌟 **NEW**: List all custom perspectives with details
+17. **get_custom_perspective_tasks** - 🌟 **NEW**: Access custom perspective with hierarchical display
 
 ### 📊 Analytics & Tracking
-17. **get_today_completed_tasks** - View today's completed tasks
+18. **get_today_completed_tasks** - View today's completed tasks
 
 Batch move feature roadmap (future): [docs/roadmap/2026-02-25-batch-move-tasks-plan.md](docs/roadmap/2026-02-25-batch-move-tasks-plan.md)
 

package/README.zh.md

@@ -13,6 +13,8 @@
 
 ## 🆕 最新版本
 
+- **v1.6.10** - 修复 `edit_item` 无法完成 Inbox 任务的问题，修复 AppleScript 对单引号/反斜杠等特殊字符的处理，修复特殊字符导致的 JSON 返回解析失败，并补充 `batch_add_items` / `mcporter` 的可直接运行示例与说明。
+- **v1.6.9** - 新增任务附件支持：`get_task_by_id` 会返回附件元信息，`dump_database` 导出附件/链接元信息，并新增 `read_task_attachment`，可在支持时直接把图片附件作为 MCP 图片内容返回。
 - **v1.6.6** - 新增 Planned Date（计划日期）全链路支持：创建/编辑/读取/过滤/排序/导出，包含 `plannedDate` / `newPlannedDate`。
 
 ## ✨ 核心特性
@@ -33,6 +35,7 @@
 - **📅 时间管理** - 截止日期、推迟日期、计划日期、估时和计划
 - **🏷️ 高级标签** - 基于标签的精确/模糊匹配过滤
 - **🤖 AI 集成** - 与 Claude AI 无缝集成，实现智能工作流
+- **🖼️ 附件感知读取** - 先暴露备注附件和链接文件的元信息，再决定是否让 AI 继续查看附件内容
 
 ## 📦 安装
 
@@ -210,6 +213,120 @@ get_custom_perspective_tasks {
 }
 ```
 
+`mcporter` 调用提示：
+
+```bash
+# 复杂数组 / 嵌套对象，建议明确使用 --args JSON
+mcporter call omnifocus.batch_add_items --args '{
+  "items": [
+    {
+      "type": "task",
+      "name": "网站技术 SEO",
+      "projectName": "SEO 项目"
+    }
+  ]
+}'
+```
+
+如果某条子任务传了 `parentTaskId` 或 `parentTaskName`，就不要再传 `projectName`。子任务会自动继承父任务所在项目。
+
+可直接运行的 `mcporter` 示例：
+
+```bash
+# 1）批量创建项目下的顶层任务
+mcporter call omnifocus.batch_add_items --args '{
+  "items": [
+    {
+      "type": "task",
+      "name": "父任务：分类A",
+      "projectName": "OmniFocus MCP 批量测试"
+    },
+    {
+      "type": "task",
+      "name": "父任务：分类B",
+      "projectName": "OmniFocus MCP 批量测试"
+    }
+  ]
+}'
+```
+
+```bash
+# 2）单次批量里同时创建父任务和子任务
+mcporter call omnifocus.batch_add_items --args '{
+  "items": [
+    {
+      "type": "task",
+      "name": "父任务：分类A",
+      "projectName": "OmniFocus MCP 批量测试"
+    },
+    {
+      "type": "task",
+      "name": "子任务：A1",
+      "parentTaskName": "父任务：分类A"
+    }
+  ]
+}'
+```
+
+```bash
+# 3）更稳妥的两步法：父任务已存在时，再批量创建多个子任务
+mcporter call omnifocus.batch_add_items --args '{
+  "items": [
+    {
+      "type": "task",
+      "name": "子任务：A1",
+      "parentTaskName": "父任务：分类A"
+    },
+    {
+      "type": "task",
+      "name": "子任务：A2",
+      "parentTaskName": "父任务：分类A"
+    },
+    {
+      "type": "task",
+      "name": "子任务：B1",
+      "parentTaskName": "父任务：分类B"
+    }
+  ]
+}'
+```
+
+下面这种写法会失败，这属于预期行为：
+
+```bash
+mcporter call omnifocus.batch_add_items --args '{
+  "items": [
+    {
+      "type": "task",
+      "name": "子任务：A1",
+      "projectName": "OmniFocus MCP 批量测试",
+      "parentTaskName": "父任务：分类A"
+    }
+  ]
+}'
+```
+
+因为子任务必须继承父任务所在项目，不能再单独传 `projectName`。
+
+### 6. 🖼️ 附件查看
+
+先读取任务和附件元信息，再按需打开具体附件：
+
+```bash
+# 读取任务详情和附件元信息
+get_task_by_id {
+  "taskId": "abc123"
+}
+
+# 打开 get_task_by_id 返回的某个附件
+read_task_attachment {
+  "taskId": "abc123",
+  "attachmentId": "embedded-1"
+}
+```
+
+`get_task_by_id` 现在会返回附件 ID、名称、推断出的 MIME 类型、来源（`embedded` 或 `linked`）以及可用时的大小。`read_task_attachment` 会尽量把图片作为 MCP 图片内容直接返回，这样 AI 客户端可以直接查看图片，而不是只能读一段 base64 文本。
+
 ## 🛠️ 完整工具参考
 
 ### 📊 数据库与任务管理
@@ -221,21 +338,22 @@ get_custom_perspective_tasks {
 6. **move_task** - 将已有任务转移到项目/父任务/Inbox
 7. **batch_add_items** - 批量添加（增强子任务支持）
 8. **batch_remove_items** - 批量删除
-9. **get_task_by_id** - 查询任务信息
+9. **get_task_by_id** - 查询任务信息，并返回附件元信息
+10. **read_task_attachment** - 读取 `get_task_by_id` 返回的任务附件
 
 ### 🔍 内置透视工具
-10. **get_inbox_tasks** - 收件箱透视
-11. **get_flagged_tasks** - 已标记透视
-12. **get_forecast_tasks** - 预测透视（包含截止/推迟/计划日期任务数据）
-13. **get_tasks_by_tag** - 基于标签的过滤
-14. **filter_tasks** - 无限组合的终极过滤
+11. **get_inbox_tasks** - 收件箱透视
+12. **get_flagged_tasks** - 已标记透视
+13. **get_forecast_tasks** - 预测透视（包含截止/推迟/计划日期任务数据）
+14. **get_tasks_by_tag** - 基于标签的过滤
+15. **filter_tasks** - 无限组合的终极过滤
 
 ### 🌟 自定义透视工具（新功能）
-15. **list_custom_perspectives** - 🌟 **新功能**：列出所有自定义透视及详情
-16. **get_custom_perspective_tasks** - 🌟 **新功能**：访问自定义透视，支持层级显示
+16. **list_custom_perspectives** - 🌟 **新功能**：列出所有自定义透视及详情
+17. **get_custom_perspective_tasks** - 🌟 **新功能**：访问自定义透视，支持层级显示
 
 ### 📊 分析与跟踪
-17. **get_today_completed_tasks** - 查看今日完成的任务
+18. **get_today_completed_tasks** - 查看今日完成的任务
 
 批量转移功能后续计划（Roadmap）：[docs/roadmap/2026-02-25-batch-move-tasks-plan.zh.md](docs/roadmap/2026-02-25-batch-move-tasks-plan.zh.md)
 

package/dist/server.js

@@ -11,6 +11,7 @@ import * as moveTaskTool from './tools/definitions/moveTask.js';
 import * as batchAddItemsTool from './tools/definitions/batchAddItems.js';
 import * as batchRemoveItemsTool from './tools/definitions/batchRemoveItems.js';
 import * as getTaskByIdTool from './tools/definitions/getTaskById.js';
+import * as readTaskAttachmentTool from './tools/definitions/readTaskAttachment.js';
 import * as getTodayCompletedTasksTool from './tools/definitions/getTodayCompletedTasks.js';
 // Import perspective tools
 import * as getInboxTasksTool from './tools/definitions/getInboxTasks.js';
@@ -25,7 +26,7 @@ import * as getCustomPerspectiveTasksTool from './tools/definitions/getCustomPer
 // Create an MCP server
 const server = new McpServer({
     name: "OmniFocus MCP",
-    version: "1.6.6"
+    version: "1.6.9"
 });
 // Register tools
 server.tool("dump_database", "Gets the current state of your OmniFocus database", dumpDatabaseTool.schema.shape, dumpDatabaseTool.handler);
@@ -37,6 +38,7 @@ server.tool("move_task", "Move an existing task to a project, parent task, or in
 server.tool("batch_add_items", "Add multiple tasks or projects to OmniFocus in a single operation", batchAddItemsTool.schema.shape, batchAddItemsTool.handler);
 server.tool("batch_remove_items", "Remove multiple tasks or projects from OmniFocus in a single operation", batchRemoveItemsTool.schema.shape, batchRemoveItemsTool.handler);
 server.tool("get_task_by_id", "Get information about a specific task by ID or name", getTaskByIdTool.schema.shape, getTaskByIdTool.handler);
+server.tool("read_task_attachment", "Read a task attachment reported by get_task_by_id. Images are returned as MCP image content when possible.", readTaskAttachmentTool.schema.shape, readTaskAttachmentTool.handler);
 server.tool("get_today_completed_tasks", "Get tasks completed today - view today's accomplishments", getTodayCompletedTasksTool.schema.shape, getTodayCompletedTasksTool.handler);
 // Register perspective tools
 server.tool("get_inbox_tasks", "Get tasks from OmniFocus inbox perspective", getInboxTasksTool.schema.shape, getInboxTasksTool.handler);

package/dist/tools/definitions/batchAddItems.js

@@ -12,9 +12,9 @@ export const schema = z.object({
         estimatedMinutes: z.number().optional().describe("Estimated time to complete the item, in minutes"),
         tags: z.array(z.string()).optional().describe("Tags to assign to the item"),
         // Task-specific properties
-        projectName: z.string().optional().describe("For tasks: The name of the project to add the task to"),
-        parentTaskId: z.string().optional().describe("For tasks: The ID of the parent task to create this task as a subtask"),
-        parentTaskName: z.string().optional().describe("For tasks: The name of the parent task to create this task as a subtask"),
+        projectName: z.string().optional().describe("For tasks: The project name for top-level tasks. Omit this when parentTaskId or parentTaskName is set."),
+        parentTaskId: z.string().optional().describe("For tasks: The parent task ID for subtasks. When this is set, do not also provide projectName."),
+        parentTaskName: z.string().optional().describe("For tasks: The parent task name for subtasks. Subtasks inherit project from their parent, so do not also provide projectName."),
         // Project-specific properties
         folderName: z.string().optional().describe("For projects: The name of the folder to add the project to"),
         sequential: z.boolean().optional().describe("For projects: Whether tasks in the project should be sequential")

package/dist/tools/definitions/getTaskById.js

@@ -1,9 +1,42 @@
 import { z } from 'zod';
 import { getTaskById } from '../primitives/getTaskById.js';
+import { formatAttachmentSize } from '../primitives/taskAttachments.js';
 export const schema = z.object({
     taskId: z.string().optional().describe("The ID of the task to retrieve"),
     taskName: z.string().optional().describe("The name of the task to retrieve (alternative to taskId)")
 });
+export function formatTaskInfo(task) {
+    let infoText = `📋 **Task Information**\n`;
+    infoText += `• **Name**: ${task.name}\n`;
+    infoText += `• **ID**: ${task.id}\n`;
+    if (task.note) {
+        infoText += `• **Note**: ${task.note}\n`;
+    }
+    if (task.parentId && task.parentName) {
+        infoText += `• **Parent Task**: ${task.parentName} (${task.parentId})\n`;
+    }
+    if (task.projectId && task.projectName) {
+        infoText += `• **Project**: ${task.projectName} (${task.projectId})\n`;
+    }
+    if (task.dueDate) {
+        infoText += `• **Due**: ${new Date(task.dueDate).toLocaleString()}\n`;
+    }
+    if (task.deferDate) {
+        infoText += `• **Defer**: ${new Date(task.deferDate).toLocaleString()}\n`;
+    }
+    if (task.plannedDate) {
+        infoText += `• **Planned**: ${new Date(task.plannedDate).toLocaleString()}\n`;
+    }
+    infoText += `• **Has Children**: ${task.hasChildren ? `Yes (${task.childrenCount} subtasks)` : 'No'}\n`;
+    infoText += `• **Attachments**: ${task.attachments.length}\n`;
+    if (task.attachments.length > 0) {
+        task.attachments.forEach(attachment => {
+            infoText += `  - ${attachment.id}: ${attachment.name} [${attachment.kind}, ${attachment.mimeType || 'unknown'}, ${attachment.source}, ${formatAttachmentSize(attachment.sizeBytes)}]\n`;
+        });
+        infoText += `• Use read_task_attachment with an attachment ID or name when you need to inspect the file.\n`;
+    }
+    return infoText;
+}
 export async function handler(args, extra) {
     try {
         // Validate that either taskId or taskName is provided
@@ -19,34 +52,10 @@ export async function handler(args, extra) {
         // Call the getTaskById function
         const result = await getTaskById(args);
         if (result.success && result.task) {
-            const task = result.task;
-            // Format task information for display
-            let infoText = `📋 **Task Information**\n`;
-            infoText += `• **Name**: ${task.name}\n`;
-            infoText += `• **ID**: ${task.id}\n`;
-            if (task.note) {
-                infoText += `• **Note**: ${task.note}\n`;
-            }
-            if (task.parentId && task.parentName) {
-                infoText += `• **Parent Task**: ${task.parentName} (${task.parentId})\n`;
-            }
-            if (task.projectId && task.projectName) {
-                infoText += `• **Project**: ${task.projectName} (${task.projectId})\n`;
-            }
-            if (task.dueDate) {
-                infoText += `• **Due**: ${new Date(task.dueDate).toLocaleString()}\n`;
-            }
-            if (task.deferDate) {
-                infoText += `• **Defer**: ${new Date(task.deferDate).toLocaleString()}\n`;
-            }
-            if (task.plannedDate) {
-                infoText += `• **Planned**: ${new Date(task.plannedDate).toLocaleString()}\n`;
-            }
-            infoText += `• **Has Children**: ${task.hasChildren ? `Yes (${task.childrenCount} subtasks)` : 'No'}\n`;
             return {
                 content: [{
                         type: "text",
-                        text: infoText
+                        text: formatTaskInfo(result.task)
                     }]
             };
         }

package/dist/tools/definitions/getTaskById.test.js

@@ -0,0 +1,32 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { formatTaskInfo } from './getTaskById.js';
+test('formatTaskInfo includes attachment metadata for follow-up reads', () => {
+    const output = formatTaskInfo({
+        id: 'task-1',
+        name: 'Review screenshots',
+        note: 'Latest UI mocks are attached',
+        hasChildren: false,
+        childrenCount: 0,
+        tags: ['design'],
+        flagged: false,
+        completed: false,
+        linkedFileURLs: [],
+        attachments: [
+            {
+                id: 'embedded-1',
+                name: 'ui-mock.png',
+                kind: 'image',
+                mimeType: 'image/png',
+                sizeBytes: 4096,
+                source: 'embedded',
+                isImage: true
+            }
+        ]
+    });
+    assert.match(output, /Attachments\*\*: 1/);
+    assert.match(output, /embedded-1/);
+    assert.match(output, /ui-mock\.png/);
+    assert.match(output, /image\/png/);
+    assert.match(output, /Use read_task_attachment/);
+});

package/dist/tools/definitions/plannedDateSchemas.test.js

@@ -37,6 +37,13 @@ test('batch_add_items schema preserves plannedDate for task and project', () =>
     assert.equal(parsed.items[0].plannedDate, '2026-02-14');
     assert.equal(parsed.items[1].plannedDate, '2026-02-15');
 });
+test('batch_add_items schema documents subtask project inheritance', () => {
+    const itemSchema = batchAddItemsSchema.shape.items._def.type;
+    const projectNameDescription = itemSchema.shape.projectName.description;
+    const parentTaskNameDescription = itemSchema.shape.parentTaskName.description;
+    assert.match(projectNameDescription, /omit this when parentTaskId or parentTaskName is set/i);
+    assert.match(parentTaskNameDescription, /subtasks inherit project from their parent/i);
+});
 test('edit_item schema preserves newPlannedDate', () => {
     const parsed = editItemSchema.parse({
         itemType: 'task',

package/dist/tools/definitions/readTaskAttachment.js

@@ -0,0 +1,73 @@
+import { z } from 'zod';
+import { readTaskAttachment, validateReadTaskAttachmentParams } from '../primitives/readTaskAttachment.js';
+import { formatAttachmentSize } from '../primitives/taskAttachments.js';
+export const schema = z.object({
+    taskId: z.string().optional().describe('The ID of the task that owns the attachment'),
+    taskName: z.string().optional().describe('The name of the task that owns the attachment'),
+    attachmentId: z.string().optional().describe('The attachment ID reported by get_task_by_id'),
+    attachmentName: z.string().optional().describe('The attachment name reported by get_task_by_id')
+});
+export function buildAttachmentContentResponse(result) {
+    const attachment = result.attachment;
+    const summary = `📎 **Attachment**\n` +
+        `• **Name**: ${attachment.name}\n` +
+        `• **ID**: ${attachment.id}\n` +
+        `• **Source**: ${attachment.source}\n` +
+        `• **Type**: ${attachment.kind}\n` +
+        `• **MIME**: ${attachment.mimeType || 'unknown'}\n` +
+        `• **Size**: ${formatAttachmentSize(attachment.sizeBytes)}\n`;
+    const content = [
+        {
+            type: 'text',
+            text: summary
+        }
+    ];
+    if (attachment.isImage && attachment.mimeType && result.content.base64) {
+        content.push({
+            type: 'image',
+            data: result.content.base64,
+            mimeType: attachment.mimeType
+        });
+        return { content };
+    }
+    if (result.content.text) {
+        content.push({
+            type: 'text',
+            text: result.content.text
+        });
+        return { content };
+    }
+    if (result.content.base64) {
+        content.push({
+            type: 'text',
+            text: `Base64 content:\n${result.content.base64}`
+        });
+    }
+    return { content };
+}
+export async function handler(args, extra) {
+    const validation = validateReadTaskAttachmentParams(args);
+    if (!validation.valid) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Error: ${validation.error}`
+                }],
+            isError: true
+        };
+    }
+    const result = await readTaskAttachment(args);
+    if (!result.success || !result.attachment || !result.content) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Failed to read attachment: ${result.error}`
+                }],
+            isError: true
+        };
+    }
+    return buildAttachmentContentResponse({
+        attachment: result.attachment,
+        content: result.content
+    });
+}

package/dist/tools/definitions/readTaskAttachment.test.js

@@ -0,0 +1,32 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { buildAttachmentContentResponse, schema } from './readTaskAttachment.js';
+test('read_task_attachment schema preserves task and attachment selectors', () => {
+    const parsed = schema.parse({
+        taskId: 'task-1',
+        attachmentId: 'embedded-1'
+    });
+    assert.equal(parsed.taskId, 'task-1');
+    assert.equal(parsed.attachmentId, 'embedded-1');
+});
+test('buildAttachmentContentResponse returns image content blocks for image attachments', () => {
+    const response = buildAttachmentContentResponse({
+        attachment: {
+            id: 'embedded-1',
+            name: 'annotated.png',
+            kind: 'image',
+            mimeType: 'image/png',
+            sizeBytes: 12,
+            source: 'embedded',
+            isImage: true
+        },
+        content: {
+            base64: 'QUJDRA=='
+        }
+    });
+    assert.equal(response.content[0].type, 'text');
+    assert.match(response.content[0].text, /annotated\.png/);
+    assert.equal(response.content[1].type, 'image');
+    assert.equal(response.content[1].mimeType, 'image/png');
+    assert.equal(response.content[1].data, 'QUJDRA==');
+});

package/dist/tools/dumpDatabase.js

@@ -1,4 +1,5 @@
 import { executeOmniFocusScript } from '../utils/scriptExecution.js';
+import { normalizeTaskAttachments } from './primitives/taskAttachments.js';
 // Main function to dump the database
 export async function dumpDatabase() {
     try {
@@ -58,8 +59,8 @@ export async function dumpDatabase() {
                     isRepeating: false, // Not available in the new format
                     repetitionMethod: null, // Not available in the new format 
                     repetitionRule: null, // Not available in the new format
-                    attachments: [], // Default empty array
-                    linkedFileURLs: [], // Default empty array
+                    attachments: normalizeTaskAttachments(task.attachments, task.linkedFileURLs),
+                    linkedFileURLs: task.linkedFileURLs || [],
                     notifications: [], // Default empty array
                     shouldUseFloatingTimeZone: false // Default value
                 };