@anhlp/alp-protocol 0.0.0-beta.1 → 0.0.0-beta.2

package/fixtures/v1/cases.json

@@ -537,6 +537,29 @@
     }
    }
   },
+  {
+   "name": "event usage",
+   "check": "envelope",
+   "valid": true,
+   "value": {
+    "sessionId": "ses_fixture",
+    "epoch": "epoch-1",
+    "seq": 3,
+    "cursor": 12,
+    "ts": "2026-10-15T00:00:00.000Z",
+    "event": {
+     "type": "usage",
+     "usage": {
+      "contextWindowUsedTokens": 42000,
+      "contextWindowMaxTokens": 200000,
+      "inputTokens": 40000,
+      "cachedInputTokens": 36000,
+      "outputTokens": 2000,
+      "totalCostUsd": 0.1234
+     }
+    }
+   }
+  },
   {
    "name": "item user_message",
    "check": "envelope",
@@ -707,6 +730,290 @@
     }
    }
   },
+  {
+   "name": "item tool_call read",
+   "check": "envelope",
+   "valid": true,
+   "value": {
+    "sessionId": "ses_fixture",
+    "epoch": "epoch-1",
+    "seq": 3,
+    "cursor": 12,
+    "ts": "2026-10-15T00:00:00.000Z",
+    "event": {
+     "type": "item",
+     "item": {
+      "kind": "tool_call",
+      "id": "tc-3",
+      "callId": "tc-3",
+      "name": "Read",
+      "status": "completed",
+      "detail": {
+       "type": "read",
+       "filePath": "/work/project/src/a.ts",
+       "content": "export const a = 1;\n",
+       "offset": 1,
+       "limit": 200
+      }
+     }
+    }
+   }
+  },
+  {
+   "name": "item tool_call edit",
+   "check": "envelope",
+   "valid": true,
+   "value": {
+    "sessionId": "ses_fixture",
+    "epoch": "epoch-1",
+    "seq": 3,
+    "cursor": 12,
+    "ts": "2026-10-15T00:00:00.000Z",
+    "event": {
+     "type": "item",
+     "item": {
+      "kind": "tool_call",
+      "id": "tc-4",
+      "callId": "tc-4",
+      "name": "Edit",
+      "status": "completed",
+      "detail": {
+       "type": "edit",
+       "filePath": "/work/project/src/a.ts",
+       "oldString": "a = 1",
+       "newString": "a = 2",
+       "unifiedDiff": "@@ -1 +1 @@\n-export const a = 1;\n+export const a = 2;\n"
+      }
+     }
+    }
+   }
+  },
+  {
+   "name": "item tool_call write",
+   "check": "envelope",
+   "valid": true,
+   "value": {
+    "sessionId": "ses_fixture",
+    "epoch": "epoch-1",
+    "seq": 3,
+    "cursor": 12,
+    "ts": "2026-10-15T00:00:00.000Z",
+    "event": {
+     "type": "item",
+     "item": {
+      "kind": "tool_call",
+      "id": "tc-5",
+      "callId": "tc-5",
+      "name": "Write",
+      "status": "running",
+      "detail": {
+       "type": "write",
+       "filePath": "docs/ghi-chú.md",
+       "content": "# Ghi chú\n"
+      }
+     }
+    }
+   }
+  },
+  {
+   "name": "item tool_call search grep",
+   "check": "envelope",
+   "valid": true,
+   "value": {
+    "sessionId": "ses_fixture",
+    "epoch": "epoch-1",
+    "seq": 3,
+    "cursor": 12,
+    "ts": "2026-10-15T00:00:00.000Z",
+    "event": {
+     "type": "item",
+     "item": {
+      "kind": "tool_call",
+      "id": "tc-6",
+      "callId": "tc-6",
+      "name": "Grep",
+      "status": "completed",
+      "detail": {
+       "type": "search",
+       "query": "TODO",
+       "toolName": "grep",
+       "content": "src/a.ts:3: // TODO",
+       "filePaths": [
+        "src/a.ts"
+       ],
+       "numFiles": 1,
+       "numMatches": 1,
+       "truncated": false
+      }
+     }
+    }
+   }
+  },
+  {
+   "name": "item tool_call search web_search",
+   "check": "envelope",
+   "valid": true,
+   "value": {
+    "sessionId": "ses_fixture",
+    "epoch": "epoch-1",
+    "seq": 3,
+    "cursor": 12,
+    "ts": "2026-10-15T00:00:00.000Z",
+    "event": {
+     "type": "item",
+     "item": {
+      "kind": "tool_call",
+      "id": "tc-7",
+      "callId": "tc-7",
+      "name": "web_search",
+      "status": "completed",
+      "detail": {
+       "type": "search",
+       "query": "json-rpc 2.0",
+       "toolName": "web_search",
+       "webResults": [
+        {
+         "title": "JSON-RPC 2.0 Specification",
+         "url": "https://www.jsonrpc.org/specification"
+        }
+       ]
+      }
+     }
+    }
+   }
+  },
+  {
+   "name": "item tool_call fetch",
+   "check": "envelope",
+   "valid": true,
+   "value": {
+    "sessionId": "ses_fixture",
+    "epoch": "epoch-1",
+    "seq": 3,
+    "cursor": 12,
+    "ts": "2026-10-15T00:00:00.000Z",
+    "event": {
+     "type": "item",
+     "item": {
+      "kind": "tool_call",
+      "id": "tc-8",
+      "callId": "tc-8",
+      "name": "WebFetch",
+      "status": "failed",
+      "error": "Request failed with status code 404",
+      "detail": {
+       "type": "fetch",
+       "url": "https://example.com/missing",
+       "prompt": "Summarize",
+       "code": 404
+      }
+     }
+    }
+   }
+  },
+  {
+   "name": "item tool_call sub_agent",
+   "check": "envelope",
+   "valid": true,
+   "value": {
+    "sessionId": "ses_fixture",
+    "epoch": "epoch-1",
+    "seq": 3,
+    "cursor": 12,
+    "ts": "2026-10-15T00:00:00.000Z",
+    "event": {
+     "type": "item",
+     "item": {
+      "kind": "tool_call",
+      "id": "tc-9",
+      "callId": "tc-9",
+      "name": "Task",
+      "status": "running",
+      "detail": {
+       "type": "sub_agent",
+       "subAgentType": "Explore",
+       "description": "Find the parser",
+       "log": ""
+      }
+     }
+    }
+   }
+  },
+  {
+   "name": "item tool_call plan",
+   "check": "envelope",
+   "valid": true,
+   "value": {
+    "sessionId": "ses_fixture",
+    "epoch": "epoch-1",
+    "seq": 3,
+    "cursor": 12,
+    "ts": "2026-10-15T00:00:00.000Z",
+    "event": {
+     "type": "item",
+     "item": {
+      "kind": "tool_call",
+      "id": "tc-10",
+      "callId": "tc-10",
+      "name": "ExitPlanMode",
+      "status": "completed",
+      "detail": {
+       "type": "plan",
+       "text": "1. Đọc\n2. Sửa"
+      }
+     }
+    }
+   }
+  },
+  {
+   "name": "item tool_call plain_text",
+   "check": "envelope",
+   "valid": true,
+   "value": {
+    "sessionId": "ses_fixture",
+    "epoch": "epoch-1",
+    "seq": 3,
+    "cursor": 12,
+    "ts": "2026-10-15T00:00:00.000Z",
+    "event": {
+     "type": "item",
+     "item": {
+      "kind": "tool_call",
+      "id": "tc-11",
+      "callId": "tc-11",
+      "name": "Skill",
+      "status": "completed",
+      "detail": {
+       "type": "plain_text",
+       "label": "smart-commits",
+       "text": "Launching skill: smart-commits"
+      }
+     }
+    }
+   }
+  },
+  {
+   "name": "item user_message with images",
+   "check": "envelope",
+   "valid": true,
+   "value": {
+    "sessionId": "ses_fixture",
+    "epoch": "epoch-1",
+    "seq": 3,
+    "cursor": 12,
+    "ts": "2026-10-15T00:00:00.000Z",
+    "event": {
+     "type": "item",
+     "item": {
+      "kind": "user_message",
+      "id": "user:m-2",
+      "text": "Xem ảnh",
+      "clientMessageId": "m-2",
+      "images": 2
+     }
+    }
+   }
+  },
   {
    "name": "announcement without a cursor",
    "check": "envelope",
@@ -771,6 +1078,33 @@
    },
    "projection": false
   },
+  {
+   "name": "a future tool-call detail type (receivers show it as unknown)",
+   "check": "envelope",
+   "valid": true,
+   "value": {
+    "sessionId": "ses_fixture",
+    "epoch": "epoch-1",
+    "seq": 3,
+    "cursor": 12,
+    "ts": "2026-10-15T00:00:00.000Z",
+    "event": {
+     "type": "item",
+     "item": {
+      "kind": "tool_call",
+      "id": "tc-12",
+      "callId": "tc-12",
+      "name": "Screenshot",
+      "status": "completed",
+      "detail": {
+       "type": "image",
+       "path": "/tmp/s.png"
+      }
+     }
+    }
+   },
+   "projection": false
+  },
   {
    "name": "unknown envelope properties",
    "check": "envelope",
@@ -855,7 +1189,7 @@
    }
   },
   {
-   "name": "known event with a wrong enum",
+   "name": "edit detail without its filePath",
    "check": "envelope",
    "valid": false,
    "value": {
@@ -865,29 +1199,233 @@
     "cursor": 12,
     "ts": "2026-10-15T00:00:00.000Z",
     "event": {
-     "type": "turn.ended",
-     "turnId": "t",
-     "state": "stopped"
+     "type": "item",
+     "item": {
+      "kind": "tool_call",
+      "id": "tc-x",
+      "callId": "tc-x",
+      "name": "Edit",
+      "status": "completed",
+      "detail": {
+       "type": "edit",
+       "newString": "x"
+      }
+     }
     }
    }
   },
   {
-   "name": "missing epoch",
+   "name": "search detail with a non-string file path",
    "check": "envelope",
    "valid": false,
    "value": {
     "sessionId": "ses_fixture",
+    "epoch": "epoch-1",
     "seq": 3,
     "cursor": 12,
     "ts": "2026-10-15T00:00:00.000Z",
     "event": {
-     "type": "session.ready"
+     "type": "item",
+     "item": {
+      "kind": "tool_call",
+      "id": "tc-x",
+      "callId": "tc-x",
+      "name": "Glob",
+      "status": "completed",
+      "detail": {
+       "type": "search",
+       "query": "*.ts",
+       "filePaths": [
+        1
+       ]
+      }
+     }
     }
    }
   },
   {
-   "name": "daemon.hello params",
-   "check": "params",
+   "name": "tool-call detail without a type",
+   "check": "envelope",
+   "valid": false,
+   "value": {
+    "sessionId": "ses_fixture",
+    "epoch": "epoch-1",
+    "seq": 3,
+    "cursor": 12,
+    "ts": "2026-10-15T00:00:00.000Z",
+    "event": {
+     "type": "item",
+     "item": {
+      "kind": "tool_call",
+      "id": "tc-x",
+      "callId": "tc-x",
+      "name": "Read",
+      "status": "completed",
+      "detail": {
+       "filePath": "a"
+      }
+     }
+    }
+   }
+  },
+  {
+   "name": "known event with a wrong enum",
+   "check": "envelope",
+   "valid": false,
+   "value": {
+    "sessionId": "ses_fixture",
+    "epoch": "epoch-1",
+    "seq": 3,
+    "cursor": 12,
+    "ts": "2026-10-15T00:00:00.000Z",
+    "event": {
+     "type": "turn.ended",
+     "turnId": "t",
+     "state": "stopped"
+    }
+   }
+  },
+  {
+   "name": "usage before the runtime said its window",
+   "check": "envelope",
+   "valid": true,
+   "value": {
+    "sessionId": "ses_fixture",
+    "epoch": "epoch-1",
+    "seq": 3,
+    "cursor": 12,
+    "ts": "2026-10-15T00:00:00.000Z",
+    "event": {
+     "type": "usage",
+     "usage": {
+      "contextWindowUsedTokens": 1200
+     }
+    }
+   }
+  },
+  {
+   "name": "session.updated with usage",
+   "check": "envelope",
+   "valid": true,
+   "value": {
+    "sessionId": "ses_fixture",
+    "epoch": "epoch-1",
+    "seq": 3,
+    "cursor": 12,
+    "ts": "2026-10-15T00:00:00.000Z",
+    "event": {
+     "type": "session.updated",
+     "session": {
+      "id": "ses_fixture",
+      "projectRoot": "/work/project",
+      "agent": "main",
+      "runtime": "codex",
+      "model": "gpt-6.1-sol",
+      "mode": "workspace-write",
+      "thinking": "low",
+      "workflow": {
+       "mode": "pho",
+       "maxPeers": 2,
+       "supervisor": false
+      },
+      "teamLabel": "Phở",
+      "threadId": "thread-1",
+      "persistent": true,
+      "busy": false,
+      "usage": {
+       "contextWindowUsedTokens": 42000,
+       "contextWindowMaxTokens": 200000
+      }
+     }
+    }
+   }
+  },
+  {
+   "name": "usage event without its usage",
+   "check": "envelope",
+   "valid": false,
+   "value": {
+    "sessionId": "ses_fixture",
+    "epoch": "epoch-1",
+    "seq": 3,
+    "cursor": 12,
+    "ts": "2026-10-15T00:00:00.000Z",
+    "event": {
+     "type": "usage"
+    }
+   }
+  },
+  {
+   "name": "usage with negative tokens",
+   "check": "envelope",
+   "valid": false,
+   "value": {
+    "sessionId": "ses_fixture",
+    "epoch": "epoch-1",
+    "seq": 3,
+    "cursor": 12,
+    "ts": "2026-10-15T00:00:00.000Z",
+    "event": {
+     "type": "usage",
+     "usage": {
+      "contextWindowUsedTokens": -1
+     }
+    }
+   }
+  },
+  {
+   "name": "usage with a zero window",
+   "check": "envelope",
+   "valid": false,
+   "value": {
+    "sessionId": "ses_fixture",
+    "epoch": "epoch-1",
+    "seq": 3,
+    "cursor": 12,
+    "ts": "2026-10-15T00:00:00.000Z",
+    "event": {
+     "type": "usage",
+     "usage": {
+      "contextWindowMaxTokens": 0
+     }
+    }
+   }
+  },
+  {
+   "name": "usage with fractional tokens",
+   "check": "envelope",
+   "valid": false,
+   "value": {
+    "sessionId": "ses_fixture",
+    "epoch": "epoch-1",
+    "seq": 3,
+    "cursor": 12,
+    "ts": "2026-10-15T00:00:00.000Z",
+    "event": {
+     "type": "usage",
+     "usage": {
+      "outputTokens": 1.5
+     }
+    }
+   }
+  },
+  {
+   "name": "missing epoch",
+   "check": "envelope",
+   "valid": false,
+   "value": {
+    "sessionId": "ses_fixture",
+    "seq": 3,
+    "cursor": 12,
+    "ts": "2026-10-15T00:00:00.000Z",
+    "event": {
+     "type": "session.ready"
+    }
+   }
+  },
+  {
+   "name": "daemon.hello params",
+   "check": "params",
    "method": "daemon.hello",
    "valid": true,
    "value": {
@@ -944,6 +1482,29 @@
     "pid": 42
    }
   },
+  {
+   "name": "daemon.hello with the host name",
+   "check": "result",
+   "method": "daemon.hello",
+   "valid": true,
+   "value": {
+    "protocolVersion": 1,
+    "daemonVersion": "0.10.0",
+    "pid": 42,
+    "hostname": "build-host",
+    "capabilities": []
+   }
+  },
+  {
+   "name": "daemon.hello with a numeric hostname",
+   "check": "result",
+   "method": "daemon.hello",
+   "valid": false,
+   "value": {
+    "protocolVersion": 1,
+    "hostname": 42
+   }
+  },
   {
    "name": "daemon.status params",
    "check": "params",
@@ -1165,95 +1726,391 @@
    }
   },
   {
-   "name": "assignment.recall without a question",
-   "check": "params",
-   "method": "assignment.recall",
+   "name": "assignment.recall without a question",
+   "check": "params",
+   "method": "assignment.recall",
+   "valid": false,
+   "value": {
+    "assignmentId": "a_1"
+   }
+  },
+  {
+   "name": "assignment.recall result",
+   "check": "result",
+   "method": "assignment.recall",
+   "valid": true,
+   "value": {
+    "assignmentId": "a_1",
+    "agent": "peer",
+    "taskId": "bd-1",
+    "finishedAt": "2026-10-15T00:00:00.000Z",
+    "answer": "Đã sửa server.ts"
+   }
+  },
+  {
+   "name": "board.list params",
+   "check": "params",
+   "method": "board.list",
+   "valid": true,
+   "value": {
+    "projectRoot": "/work/project"
+   }
+  },
+  {
+   "name": "board.list without projectRoot",
+   "check": "params",
+   "method": "board.list",
+   "valid": false,
+   "value": {}
+  },
+  {
+   "name": "board.list result",
+   "check": "result",
+   "method": "board.list",
+   "valid": true,
+   "value": {
+    "pins": [
+     {
+      "id": "pin_1",
+      "project": "/work/project",
+      "kind": "claim",
+      "body": "Đang sửa server",
+      "paths": [
+       "src/server.ts"
+      ],
+      "agent": "peer",
+      "sessionId": "ses_child",
+      "rootId": "ses_fixture",
+      "at": "2026-10-15T00:00:00.000Z"
+     }
+    ]
+   }
+  },
+  {
+   "name": "question.list params",
+   "check": "params",
+   "method": "question.list",
+   "valid": true,
+   "value": {
+    "projectRoot": "/work/project"
+   }
+  },
+  {
+   "name": "question.list result",
+   "check": "result",
+   "method": "question.list",
+   "valid": true,
+   "value": {
+    "questions": [
+     {
+      "id": "q_1",
+      "sessionId": "ses_fixture",
+      "rootId": "ses_fixture",
+      "agent": "main",
+      "body": "Tiếp tục?",
+      "options": [
+       "có",
+       "không"
+      ],
+      "askedAt": "2026-10-15T00:00:00.000Z"
+     }
+    ]
+   }
+  },
+  {
+   "name": "question.watch params",
+   "check": "params",
+   "method": "question.watch",
+   "valid": true,
+   "value": {
+    "projectRoot": "/work/project"
+   }
+  },
+  {
+   "name": "question.watch every tree",
+   "check": "params",
+   "method": "question.watch",
+   "valid": true,
+   "value": {}
+  },
+  {
+   "name": "question.watch result",
+   "check": "result",
+   "method": "question.watch",
+   "valid": true,
+   "value": {
+    "questions": [
+     {
+      "id": "q_1",
+      "sessionId": "ses_fixture",
+      "rootId": "ses_fixture",
+      "agent": "main",
+      "body": "Tiếp tục?",
+      "options": [
+       "có",
+       "không"
+      ],
+      "askedAt": "2026-10-15T00:00:00.000Z"
+     }
+    ]
+   }
+  },
+  {
+   "name": "question.watch with a numeric projectRoot",
+   "check": "params",
+   "method": "question.watch",
+   "valid": false,
+   "value": {
+    "projectRoot": 7
+   }
+  },
+  {
+   "name": "question.watch with turns",
+   "check": "params",
+   "method": "question.watch",
+   "valid": true,
+   "value": {
+    "projectRoot": "/work/project",
+    "turns": true
+   }
+  },
+  {
+   "name": "question.watch with a string turns",
+   "check": "params",
+   "method": "question.watch",
+   "valid": false,
+   "value": {
+    "turns": "yes"
+   }
+  },
+  {
+   "name": "workspace.files.search params",
+   "check": "params",
+   "method": "workspace.files.search",
+   "valid": true,
+   "value": {
+    "projectRoot": "/work/project",
+    "query": "server ts",
+    "limit": 30
+   }
+  },
+  {
+   "name": "workspace.files.search without a query",
+   "check": "params",
+   "method": "workspace.files.search",
+   "valid": true,
+   "value": {
+    "projectRoot": "/work/project"
+   }
+  },
+  {
+   "name": "workspace.files.search without projectRoot",
+   "check": "params",
+   "method": "workspace.files.search",
+   "valid": false,
+   "value": {
+    "query": "server"
+   }
+  },
+  {
+   "name": "workspace.files.search with a limit over 100",
+   "check": "params",
+   "method": "workspace.files.search",
+   "valid": false,
+   "value": {
+    "projectRoot": "/work/project",
+    "limit": 101
+   }
+  },
+  {
+   "name": "workspace.files.search with a query over 200 characters",
+   "check": "params",
+   "method": "workspace.files.search",
+   "valid": false,
+   "value": {
+    "projectRoot": "/work/project",
+    "query": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
+   }
+  },
+  {
+   "name": "workspace.files.search result",
+   "check": "result",
+   "method": "workspace.files.search",
+   "valid": true,
+   "value": {
+    "files": [
+     {
+      "path": "src/server.ts"
+     },
+     {
+      "path": "docs/sửa lỗi.md"
+     }
+    ],
+    "truncated": true
+   }
+  },
+  {
+   "name": "workspace.files.search result with an empty path",
+   "check": "result",
+   "method": "workspace.files.search",
+   "valid": false,
+   "value": {
+    "files": [
+     {
+      "path": ""
+     }
+    ]
+   }
+  },
+  {
+   "name": "workspace.files.list the root",
+   "check": "params",
+   "method": "workspace.files.list",
+   "valid": true,
+   "value": {
+    "projectRoot": "/work/project"
+   }
+  },
+  {
+   "name": "workspace.files.list params",
+   "check": "params",
+   "method": "workspace.files.list",
+   "valid": true,
+   "value": {
+    "projectRoot": "/work/project",
+    "path": "src",
+    "includeIgnored": true
+   }
+  },
+  {
+   "name": "workspace.files.list without projectRoot",
+   "check": "params",
+   "method": "workspace.files.list",
+   "valid": false,
+   "value": {
+    "path": "src"
+   }
+  },
+  {
+   "name": "workspace.files.list with an empty path",
+   "check": "params",
+   "method": "workspace.files.list",
+   "valid": false,
+   "value": {
+    "projectRoot": "/work/project",
+    "path": ""
+   }
+  },
+  {
+   "name": "workspace.files.list with a string includeIgnored",
+   "check": "params",
+   "method": "workspace.files.list",
+   "valid": false,
+   "value": {
+    "projectRoot": "/work/project",
+    "includeIgnored": "yes"
+   }
+  },
+  {
+   "name": "workspace.files.list result",
+   "check": "result",
+   "method": "workspace.files.list",
+   "valid": true,
+   "value": {
+    "entries": [
+     {
+      "name": "src",
+      "path": "src",
+      "kind": "directory",
+      "modifiedAt": "2026-10-15T00:00:00.000Z"
+     },
+     {
+      "name": "sửa lỗi.md",
+      "path": "sửa lỗi.md",
+      "kind": "file",
+      "size": 12,
+      "modifiedAt": "2026-10-15T00:00:00.000Z"
+     }
+    ],
+    "truncated": true
+   }
+  },
+  {
+   "name": "workspace.files.list result with a link entry",
+   "check": "result",
+   "method": "workspace.files.list",
    "valid": false,
    "value": {
-    "assignmentId": "a_1"
+    "entries": [
+     {
+      "name": "x",
+      "path": "x",
+      "kind": "link"
+     }
+    ]
    }
   },
   {
-   "name": "assignment.recall result",
-   "check": "result",
-   "method": "assignment.recall",
+   "name": "workspace.files.read params",
+   "check": "params",
+   "method": "workspace.files.read",
    "valid": true,
    "value": {
-    "assignmentId": "a_1",
-    "agent": "peer",
-    "taskId": "bd-1",
-    "finishedAt": "2026-10-15T00:00:00.000Z",
-    "answer": "Đã sửa server.ts"
+    "projectRoot": "/work/project",
+    "path": "src/server.ts"
    }
   },
   {
-   "name": "board.list params",
+   "name": "workspace.files.read an ignored file",
    "check": "params",
-   "method": "board.list",
+   "method": "workspace.files.read",
    "valid": true,
    "value": {
-    "projectRoot": "/work/project"
+    "projectRoot": "/work/project",
+    "path": "dist/out.js",
+    "includeIgnored": true
    }
   },
   {
-   "name": "board.list without projectRoot",
+   "name": "workspace.files.read without path",
    "check": "params",
-   "method": "board.list",
+   "method": "workspace.files.read",
    "valid": false,
-   "value": {}
+   "value": {
+    "projectRoot": "/work/project"
+   }
   },
   {
-   "name": "board.list result",
-   "check": "result",
-   "method": "board.list",
-   "valid": true,
+   "name": "workspace.files.read with a path over 4096 characters",
+   "check": "params",
+   "method": "workspace.files.read",
+   "valid": false,
    "value": {
-    "pins": [
-     {
-      "id": "pin_1",
-      "project": "/work/project",
-      "kind": "claim",
-      "body": "Đang sửa server",
-      "paths": [
-       "src/server.ts"
-      ],
-      "agent": "peer",
-      "sessionId": "ses_child",
-      "rootId": "ses_fixture",
-      "at": "2026-10-15T00:00:00.000Z"
-     }
-    ]
+    "projectRoot": "/work/project",
+    "path": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
    }
   },
   {
-   "name": "question.list params",
-   "check": "params",
-   "method": "question.list",
+   "name": "workspace.files.read result",
+   "check": "result",
+   "method": "workspace.files.read",
    "valid": true,
    "value": {
-    "projectRoot": "/work/project"
+    "path": "src/server.ts",
+    "content": "export {};\n",
+    "size": 11,
+    "modifiedAt": "2026-10-15T00:00:00.000Z"
    }
   },
   {
-   "name": "question.list result",
+   "name": "workspace.files.read result over 1 MiB",
    "check": "result",
-   "method": "question.list",
-   "valid": true,
+   "method": "workspace.files.read",
+   "valid": false,
    "value": {
-    "questions": [
-     {
-      "id": "q_1",
-      "sessionId": "ses_fixture",
-      "rootId": "ses_fixture",
-      "agent": "main",
-      "body": "Tiếp tục?",
-      "options": [
-       "có",
-       "không"
-      ],
-      "askedAt": "2026-10-15T00:00:00.000Z"
-     }
-    ]
+    "path": "big.txt",
+    "content": "",
+    "size": 1048577
    }
   },
   {
@@ -1587,6 +2444,114 @@
     "content": "text"
    }
   },
+  {
+   "name": "session.prompt with an inline image",
+   "check": "params",
+   "method": "session.prompt",
+   "valid": true,
+   "value": {
+    "sessionId": "ses_fixture",
+    "clientMessageId": "m-2",
+    "content": [
+     {
+      "type": "text",
+      "text": "Xem ảnh"
+     },
+     {
+      "type": "image",
+      "mimeType": "image/png",
+      "data": "iVBORw0KGgo=",
+      "name": "ảnh.png"
+     }
+    ]
+   }
+  },
+  {
+   "name": "session.prompt with an image path",
+   "check": "params",
+   "method": "session.prompt",
+   "valid": false,
+   "value": {
+    "sessionId": "ses_fixture",
+    "clientMessageId": "m-2",
+    "content": [
+     {
+      "type": "image",
+      "mimeType": "image/png",
+      "data": "iVBORw0KGgo=",
+      "path": "/etc/passwd"
+     }
+    ]
+   }
+  },
+  {
+   "name": "session.prompt with an image url",
+   "check": "params",
+   "method": "session.prompt",
+   "valid": false,
+   "value": {
+    "sessionId": "ses_fixture",
+    "clientMessageId": "m-2",
+    "content": [
+     {
+      "type": "image",
+      "mimeType": "image/png",
+      "data": "iVBORw0KGgo=",
+      "url": "file:///etc/passwd"
+     }
+    ]
+   }
+  },
+  {
+   "name": "session.prompt with an svg image",
+   "check": "params",
+   "method": "session.prompt",
+   "valid": false,
+   "value": {
+    "sessionId": "ses_fixture",
+    "clientMessageId": "m-2",
+    "content": [
+     {
+      "type": "image",
+      "mimeType": "image/svg+xml",
+      "data": "PHN2Zz4="
+     }
+    ]
+   }
+  },
+  {
+   "name": "session.prompt with image data that is not base64",
+   "check": "params",
+   "method": "session.prompt",
+   "valid": false,
+   "value": {
+    "sessionId": "ses_fixture",
+    "clientMessageId": "m-2",
+    "content": [
+     {
+      "type": "image",
+      "mimeType": "image/png",
+      "data": "not base64!"
+     }
+    ]
+   }
+  },
+  {
+   "name": "session.prompt with an image without data",
+   "check": "params",
+   "method": "session.prompt",
+   "valid": false,
+   "value": {
+    "sessionId": "ses_fixture",
+    "clientMessageId": "m-2",
+    "content": [
+     {
+      "type": "image",
+      "mimeType": "image/png"
+     }
+    ]
+   }
+  },
   {
    "name": "session.prompt with an unknown delivery",
    "check": "params",
@@ -1900,6 +2865,37 @@
     }
    }
   },
+  {
+   "name": "session.get result of a session that takes images",
+   "check": "result",
+   "method": "session.get",
+   "valid": true,
+   "value": {
+    "session": {
+     "id": "ses_fixture",
+     "projectRoot": "/work/project",
+     "agent": "main",
+     "runtime": "codex",
+     "model": "gpt-6.1-sol",
+     "mode": "workspace-write",
+     "thinking": "low",
+     "workflow": {
+      "mode": "pho",
+      "maxPeers": 2,
+      "supervisor": false
+     },
+     "teamLabel": "Phở",
+     "threadId": "thread-1",
+     "persistent": true,
+     "busy": false,
+     "status": "idle",
+     "title": "Sửa lỗi 😀",
+     "createdAt": "2026-10-15T00:00:00.000Z",
+     "updatedAt": "2026-10-15T00:00:00.000Z",
+     "promptImages": true
+    }
+   }
+  },
   {
    "name": "session.list params",
    "check": "params",
@@ -1953,6 +2949,102 @@
     ]
    }
   },
+  {
+   "name": "session.list a page with a query",
+   "check": "params",
+   "method": "session.list",
+   "valid": true,
+   "value": {
+    "projectRoot": "/work/project",
+    "rootsOnly": true,
+    "includeArchived": true,
+    "limit": 200,
+    "cursor": "eyJrIjpbMF19",
+    "query": "sửa lỗi"
+   }
+  },
+  {
+   "name": "session.list with a zero limit",
+   "check": "params",
+   "method": "session.list",
+   "valid": false,
+   "value": {
+    "limit": 0
+   }
+  },
+  {
+   "name": "session.list of several projects",
+   "check": "params",
+   "method": "session.list",
+   "valid": true,
+   "value": {
+    "projectRoots": [
+     "/work/project",
+     "/private/work/project"
+    ],
+    "limit": 50
+   }
+  },
+  {
+   "name": "session.list with no projects",
+   "check": "params",
+   "method": "session.list",
+   "valid": false,
+   "value": {
+    "projectRoots": []
+   }
+  },
+  {
+   "name": "session.list with a fractional limit",
+   "check": "params",
+   "method": "session.list",
+   "valid": false,
+   "value": {
+    "limit": 2.5
+   }
+  },
+  {
+   "name": "session.list with an empty cursor",
+   "check": "params",
+   "method": "session.list",
+   "valid": false,
+   "value": {
+    "cursor": ""
+   }
+  },
+  {
+   "name": "session.list a page with more after it",
+   "check": "result",
+   "method": "session.list",
+   "valid": true,
+   "value": {
+    "sessions": [
+     {
+      "id": "ses_fixture",
+      "projectRoot": "/work/project",
+      "agent": "main",
+      "runtime": "codex",
+      "model": "gpt-6.1-sol",
+      "mode": "workspace-write",
+      "thinking": "low",
+      "workflow": {
+       "mode": "pho",
+       "maxPeers": 2,
+       "supervisor": false
+      },
+      "teamLabel": "Phở",
+      "threadId": "thread-1",
+      "persistent": true,
+      "busy": false,
+      "status": "idle",
+      "title": "Sửa lỗi 😀",
+      "createdAt": "2026-10-15T00:00:00.000Z",
+      "updatedAt": "2026-10-15T00:00:00.000Z"
+     }
+    ],
+    "nextCursor": "eyJrIjpbMF19"
+   }
+  },
   {
    "name": "session.status params",
    "check": "params",