omnifocus-mcp-enhanced 1.6.7 → 1.6.9

package/README.md

@@ -17,6 +17,8 @@ Enhanced Model Context Protocol (MCP) server for OmniFocus featuring **native cu
 
 ## 🆕 Latest Release
 
+- **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.
 
 ## ✨ Key Features
@@ -37,6 +39,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
 
@@ -214,6 +217,25 @@ Efficiently manage multiple tasks:
 }
 ```
 
+### 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
@@ -221,24 +243,28 @@ Efficiently manage multiple tasks:
 2. **add_omnifocus_task** - Create tasks (enhanced with subtask support)
 3. **add_project** - Create projects
 4. **remove_item** - Delete tasks or projects
-5. **edit_item** - Edit tasks or projects
-6. **batch_add_items** - Bulk add (enhanced with subtask support)
-7. **batch_remove_items** - Bulk remove
-8. **get_task_by_id** - Query task information
+5. **edit_item** - Edit tasks or projects (now supports task moves: project/parent/inbox)
+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, including attachment metadata
+10. **read_task_attachment** - Read an attachment reported by `get_task_by_id`
 
 ### 🔍 Built-in Perspective Tools
-9. **get_inbox_tasks** - Inbox perspective
-10. **get_flagged_tasks** - Flagged perspective
-11. **get_forecast_tasks** - Forecast perspective (due/deferred/planned task data included)
-12. **get_tasks_by_tag** - Tag-based filtering
-13. **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)
-14. **list_custom_perspectives** - 🌟 **NEW**: List all custom perspectives with details
-15. **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
-16. **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)
 
 ## 🚀 Quick Start Examples
 
@@ -272,6 +298,43 @@ add_omnifocus_task {
 }
 ```
 
+### Task Move Operations
+```bash
+# Move task to a project
+move_task {
+  "id": "task-id-123",
+  "targetProjectName": "Planning"
+}
+
+# Move task under another task
+move_task {
+  "id": "task-id-123",
+  "targetParentTaskId": "parent-task-id-456"
+}
+
+# Move task back to inbox
+move_task {
+  "id": "task-id-123",
+  "targetInbox": true
+}
+```
+
+Task move safety rules:
+- Name lookups fail fast on duplicates and ask you to use IDs.
+- Destination must be exactly one type: project OR parent task OR inbox.
+- Moving a task into itself/its descendants is blocked to prevent cycles.
+
+You can also move with `edit_item` and combine move + field updates:
+```bash
+edit_item {
+  "itemType": "task",
+  "id": "task-id-123",
+  "newProjectName": "Planning",
+  "newName": "Review tmux workflow",
+  "newFlagged": true
+}
+```
+
 ### Smart Task Discovery
 ```bash
 # Find high-priority work

package/README.zh.md

@@ -13,6 +13,7 @@
 
 ## 🆕 最新版本
 
+- **v1.6.9** - 新增任务附件支持：`get_task_by_id` 会返回附件元信息，`dump_database` 导出附件/链接元信息，并新增 `read_task_attachment`，可在支持时直接把图片附件作为 MCP 图片内容返回。
 - **v1.6.6** - 新增 Planned Date（计划日期）全链路支持：创建/编辑/读取/过滤/排序/导出，包含 `plannedDate` / `newPlannedDate`。
 
 ## ✨ 核心特性
@@ -33,6 +34,7 @@
 - **📅 时间管理** - 截止日期、推迟日期、计划日期、估时和计划
 - **🏷️ 高级标签** - 基于标签的精确/模糊匹配过滤
 - **🤖 AI 集成** - 与 Claude AI 无缝集成，实现智能工作流
+- **🖼️ 附件感知读取** - 先暴露备注附件和链接文件的元信息，再决定是否让 AI 继续查看附件内容
 
 ## 📦 安装
 
@@ -210,6 +212,25 @@ get_custom_perspective_tasks {
 }
 ```
 
+### 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 文本。
+
 ## 🛠️ 完整工具参考
 
 ### 📊 数据库与任务管理
@@ -217,24 +238,28 @@ get_custom_perspective_tasks {
 2. **add_omnifocus_task** - 创建任务（增强子任务支持）
 3. **add_project** - 创建项目
 4. **remove_item** - 删除任务或项目
-5. **edit_item** - 编辑任务或项目
-6. **batch_add_items** - 批量添加（增强子任务支持）
-7. **batch_remove_items** - 批量删除
-8. **get_task_by_id** - 查询任务信息
+5. **edit_item** - 编辑任务或项目（现已支持任务转移：项目/父任务/Inbox）
+6. **move_task** - 将已有任务转移到项目/父任务/Inbox
+7. **batch_add_items** - 批量添加（增强子任务支持）
+8. **batch_remove_items** - 批量删除
+9. **get_task_by_id** - 查询任务信息，并返回附件元信息
+10. **read_task_attachment** - 读取 `get_task_by_id` 返回的任务附件
 
 ### 🔍 内置透视工具
-9. **get_inbox_tasks** - 收件箱透视
-10. **get_flagged_tasks** - 已标记透视
-11. **get_forecast_tasks** - 预测透视（包含截止/推迟/计划日期任务数据）
-12. **get_tasks_by_tag** - 基于标签的过滤
-13. **filter_tasks** - 无限组合的终极过滤
+11. **get_inbox_tasks** - 收件箱透视
+12. **get_flagged_tasks** - 已标记透视
+13. **get_forecast_tasks** - 预测透视（包含截止/推迟/计划日期任务数据）
+14. **get_tasks_by_tag** - 基于标签的过滤
+15. **filter_tasks** - 无限组合的终极过滤
 
 ### 🌟 自定义透视工具（新功能）
-14. **list_custom_perspectives** - 🌟 **新功能**：列出所有自定义透视及详情
-15. **get_custom_perspective_tasks** - 🌟 **新功能**：访问自定义透视，支持层级显示
+16. **list_custom_perspectives** - 🌟 **新功能**：列出所有自定义透视及详情
+17. **get_custom_perspective_tasks** - 🌟 **新功能**：访问自定义透视，支持层级显示
 
 ### 📊 分析与跟踪
-16. **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)
 
 ## 🚀 快速开始示例
 
@@ -268,6 +293,27 @@ add_omnifocus_task {
 }
 ```
 
+### 任务转移操作
+```bash
+# 转移到项目
+move_task {
+  "id": "task-id-123",
+  "targetProjectName": "规划"
+}
+
+# 转移到父任务下
+move_task {
+  "id": "task-id-123",
+  "targetParentTaskId": "parent-task-id-456"
+}
+
+# 转移回 Inbox
+move_task {
+  "id": "task-id-123",
+  "targetInbox": true
+}
+```
+
 ### 智能任务发现
 ```bash
 # 找到高优先级工作

package/dist/server.js

@@ -7,9 +7,11 @@ import * as addOmniFocusTaskTool from './tools/definitions/addOmniFocusTask.js';
 import * as addProjectTool from './tools/definitions/addProject.js';
 import * as removeItemTool from './tools/definitions/removeItem.js';
 import * as editItemTool from './tools/definitions/editItem.js';
+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';
@@ -24,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);
@@ -32,9 +34,11 @@ server.tool("add_omnifocus_task", "Add a new task to OmniFocus", addOmniFocusTas
 server.tool("add_project", "Add a new project to OmniFocus", addProjectTool.schema.shape, addProjectTool.handler);
 server.tool("remove_item", "Remove a task or project from OmniFocus", removeItemTool.schema.shape, removeItemTool.handler);
 server.tool("edit_item", "Edit a task or project in OmniFocus", editItemTool.schema.shape, editItemTool.handler);
+server.tool("move_task", "Move an existing task to a project, parent task, or inbox", moveTaskTool.schema.shape, moveTaskTool.handler);
 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/editItem.js

@@ -17,6 +17,11 @@ export const schema = z.object({
     addTags: z.array(z.string()).optional().describe("Tags to add to the task"),
     removeTags: z.array(z.string()).optional().describe("Tags to remove from the task"),
     replaceTags: z.array(z.string()).optional().describe("Tags to replace all existing tags with"),
+    newProjectId: z.string().optional().describe("For tasks: move task to this project ID"),
+    newProjectName: z.string().optional().describe("For tasks: move task to this project name (errors on duplicate names)"),
+    newParentTaskId: z.string().optional().describe("For tasks: move task under this parent task ID"),
+    newParentTaskName: z.string().optional().describe("For tasks: move task under this parent task name (errors on duplicate names)"),
+    moveToInbox: z.boolean().optional().describe("For tasks: move task to inbox"),
     // Project-specific fields
     newSequential: z.boolean().optional().describe("Whether the project should be sequential"),
     newFolderName: z.string().optional().describe("New folder to move the project to"),

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/moveTask.js

@@ -0,0 +1,54 @@
+import { z } from 'zod';
+import { moveTask } from '../primitives/moveTask.js';
+export const schema = z.object({
+    id: z.string().optional().describe('The ID of the task to move'),
+    name: z.string().optional().describe('The name of the task to move (fallback if ID not provided)'),
+    targetProjectId: z.string().optional().describe('Destination project ID'),
+    targetProjectName: z.string().optional().describe('Destination project name (errors on duplicate names)'),
+    targetParentTaskId: z.string().optional().describe('Destination parent task ID'),
+    targetParentTaskName: z.string().optional().describe('Destination parent task name (errors on duplicate names)'),
+    targetInbox: z.boolean().optional().describe('Move task to inbox')
+});
+function formatDestination(args) {
+    if (args.targetInbox) {
+        return 'inbox';
+    }
+    if (args.targetProjectId || args.targetProjectName) {
+        return `project "${args.targetProjectId || args.targetProjectName}"`;
+    }
+    if (args.targetParentTaskId || args.targetParentTaskName) {
+        return `parent task "${args.targetParentTaskId || args.targetParentTaskName}"`;
+    }
+    return 'destination';
+}
+export async function handler(args, extra) {
+    try {
+        const result = await moveTask(args);
+        if (result.success) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `✅ Task "${result.name || args.id || args.name}" moved successfully to ${formatDestination(args)}.`
+                    }]
+            };
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Failed to move task: ${result.error}`
+                }],
+            isError: true
+        };
+    }
+    catch (err) {
+        const error = err;
+        console.error(`Tool execution error: ${error.message}`);
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Error moving task: ${error.message}`
+                }],
+            isError: true
+        };
+    }
+}

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

@@ -0,0 +1,27 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { handler, schema } from './moveTask.js';
+test('move_task schema accepts source and destination fields', () => {
+    const parsed = schema.parse({
+        id: 'task-1',
+        targetProjectId: 'project-1'
+    });
+    assert.equal(parsed.id, 'task-1');
+    assert.equal(parsed.targetProjectId, 'project-1');
+});
+test('move_task schema preserves targetInbox boolean', () => {
+    const parsed = schema.parse({
+        name: 'My Task',
+        targetInbox: true
+    });
+    assert.equal(parsed.targetInbox, true);
+});
+test('move_task handler returns validation errors for conflicting destinations', async () => {
+    const result = await handler({
+        id: 'task-1',
+        targetProjectId: 'project-1',
+        targetInbox: true
+    }, {});
+    assert.equal(result.isError, true);
+    assert.match(result.content[0].text, /Exactly one destination/);
+});

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

@@ -45,6 +45,16 @@ test('edit_item schema preserves newPlannedDate', () => {
     });
     assert.equal(parsed.newPlannedDate, '2026-02-14');
 });
+test('edit_item schema supports task move destination fields', () => {
+    const parsed = editItemSchema.parse({
+        itemType: 'task',
+        id: 'abc',
+        newProjectId: 'project-1',
+        moveToInbox: false
+    });
+    assert.equal(parsed.newProjectId, 'project-1');
+    assert.equal(parsed.moveToInbox, false);
+});
 test('filter_tasks schema supports planned date filters and sorting', () => {
     const parsed = filterTasksSchema.parse({
         plannedToday: true,

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
                 };