ainecto 0.6.0 → 0.7.0

package/dist/bin/ainecto.js

@@ -615,7 +615,7 @@ async function readAllStdin(stdin) {
 }
 
 // src/core/version.ts
-var CLI_VERSION = true ? "0.6.0" : "dev";
+var CLI_VERSION = true ? "0.7.0" : "dev";
 var PACKAGE_NAME = "@ainecto/mcp";
 var CLI_USER_AGENT = `${PACKAGE_NAME} ${CLI_VERSION}`;
 
@@ -816,7 +816,7 @@ function redactSecretString(value) {
 
 // src/core/catalog/generated.prod.ts
 var generatedTools = [
-  { "mcpName": "create_comments", "commandPath": ["comments", "create"], "group": "generic", "description": "Add comments, questions, or replies to a document. Anyone who can read the document may comment and reply. Set parentCommentId to reply to a top-level comment. To mention people, get their userId and displayName from list_mention_candidates, write @<displayName> in the body, and list their userIds in mentionUserIds (clientMutationId is then required). Items are applied in order and each one commits on its own; results report each item (ok, or status and error).", "inputSchema": { "additionalProperties": false, "properties": { "documentUuid": { "description": "Document UUID the comments belong to", "type": "string" }, "items": { "description": "Comments to add, applied in order", "items": { "additionalProperties": false, "properties": { "body": { "description": "Comment text (plain text, 1..10000 characters). To mention someone, include @<displayName> exactly as returned by mcp__ainecto__list_mention_candidates.", "maxLength": 1e4, "minLength": 1, "type": "string" }, "clientMutationId": { "description": "Idempotency key (visible ASCII, at most 128 characters). Required when mentionUserIds is not empty; reuse the same value when retrying the same item so the mention email is not sent twice.", "maxLength": 128, "type": "string" }, "kind": { "description": "Top-level comments only: COMMENT (default) or QUESTION. A QUESTION can later be resolved with mcp__ainecto__resolve_comments.", "enum": ["COMMENT", "QUESTION"], "type": "string" }, "mentionUserIds": { "description": "userIds to mention (from mcp__ainecto__list_mention_candidates). Each one's @<displayName> must appear in body; newly mentioned people get a notification email.", "items": { "type": "string" }, "maxItems": 20, "type": "array", "uniqueItems": true }, "parentCommentId": { "description": "Reply to this top-level comment id (from mcp__ainecto__list_comments). Replies are one level deep: replying to a reply is rejected.", "minimum": 1, "type": "integer" } }, "required": ["body"], "type": "object" }, "minItems": 1, "type": "array" }, "mailLanguage": { "description": "Language of the mention notification email. Defaults to en.", "enum": ["en", "ko"], "type": "string" } }, "required": ["documentUuid", "items"], "type": "object" }, "required": ["documentUuid", "items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "a673b909d16835ef" },
+  { "mcpName": "create_comments", "commandPath": ["comments", "create"], "group": "generic", "description": "Add comments, questions, or replies to a document. Anyone who can read the document may comment and reply. Set parentCommentId to reply to a top-level comment. To mention people, get their userId and displayName from list_mention_candidates, write @<displayName> in the body, and list their userIds in mentionUserIds (clientMutationId is then required). Items are applied in order and each one commits on its own; results report each item (ok, or status and error).", "inputSchema": { "additionalProperties": false, "properties": { "documentUuid": { "description": "Document UUID the comments belong to", "type": "string" }, "items": { "description": "Comments to add, applied in order", "items": { "additionalProperties": false, "properties": { "body": { "description": "Comment text (plain text, 1..10000 characters). To mention someone, include @<displayName> exactly as returned by mcp__ainecto__list_mention_candidates.", "maxLength": 1e4, "minLength": 1, "type": "string" }, "clientMutationId": { "description": "Idempotency key (visible ASCII, at most 128 characters). Required when mentionUserIds is not empty; reuse the same value when retrying the same item so the mention email is not sent twice.", "maxLength": 128, "type": "string" }, "kind": { "description": "Top-level comments only: COMMENT (default) or QUESTION. A QUESTION can later be resolved with mcp__ainecto__resolve_comments.", "enum": ["COMMENT", "QUESTION"], "type": "string" }, "mentionUserIds": { "description": "userIds to mention (from mcp__ainecto__list_mention_candidates). Each one's @<displayName> must appear in body; newly mentioned people get a notification email.", "items": { "type": "string" }, "maxItems": 20, "type": "array", "uniqueItems": true }, "parentCommentId": { "description": "Reply to this top-level comment id (from mcp__ainecto__list_comments). Replies are one level deep: replying to a reply is rejected. The thread's original author and earlier repliers get a notification email (except people mentioned in this reply, who get the mention email instead).", "minimum": 1, "type": "integer" } }, "required": ["body"], "type": "object" }, "minItems": 1, "type": "array" }, "mailLanguage": { "description": "Language of the comment notification email (mention or reply). Defaults to en.", "enum": ["en", "ko"], "type": "string" } }, "required": ["documentUuid", "items"], "type": "object" }, "required": ["documentUuid", "items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "b3ad621ef51c3003" },
   { "mcpName": "create_documents", "commandPath": ["documents", "create"], "group": "document", "description": "Create documents. If a document body is tens of KB or more, prefer request_upload_token (purpose=document.create) and upload the body with curl.", "inputSchema": { "properties": { "items": { "description": "Documents", "items": { "properties": { "body": { "description": "Deprecated compatibility alias for typePayload.body when document type is markdown. \uBCF8\uBB38\uC774 \uC218\uC2ED KB \uC774\uC0C1\uC73C\uB85C \uD06C\uBA74 LLM \uD1A0\uD070 \uC808\uC57D\uC744 \uC704\uD574 `request_upload_token (purpose=document.create)` \uB97C \uD638\uCD9C\uD574 uploadUrl \uC744 \uBC1B\uACE0 curl \uB85C \uC9C1\uC811 PUT \uC73C\uB85C \uBCF4\uB0BC \uAC83.", "type": "string" }, "folderUuid": { "description": "Optional folder UUID", "type": "string" }, "projectUuid": { "description": "Project UUID", "type": "string" }, "title": { "description": "Document title", "type": "string" }, "type": { "description": "Document type. Creatable values: erd, markdown, diagram, openapi, html, file.", "enum": ["erd", "markdown", "diagram", "openapi", "html", "file"], "type": "string" }, "typePayload": { "description": 'Type-specific payload for enabled document types. markdown: {body}; diagram: {diagramSource,sourceLanguage,edgeStyle,isModule,metadata}; openapi: {content}; html: {content} (a full HTML page); file: no JSON payload \u2014 bytes go through request_upload_token(purpose=document.create, scopeJson={projectUuid,folderUuid?,type:"file",title,filename}) then one curl PUT (images\xB7PDF\xB7mp4/webm\xB7audio\xB7text/code\xB7CSV only).', "type": "object" } }, "required": ["projectUuid", "type", "title"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "aa868b0e2821006a" },
   { "mcpName": "create_folders", "commandPath": ["folders", "create"], "group": "generic", "description": "", "inputSchema": { "properties": { "items": { "description": "Folders", "items": { "properties": { "name": { "description": "Folder name", "type": "string" }, "parentFolderUuid": { "description": "Parent folder UUID", "type": "string" }, "projectUuid": { "description": "Project UUID", "type": "string" } }, "required": ["projectUuid", "name"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "30f45b887259609f" },
   { "mcpName": "create_projects", "commandPath": ["projects", "create"], "group": "generic", "description": "", "inputSchema": { "properties": { "items": { "description": "Projects", "items": { "properties": { "description": { "description": "Description", "type": "string" }, "name": { "description": "Project name", "type": "string" }, "projectKey": { "description": "Unique project key", "type": "string" }, "workspaceUuid": { "description": "Workspace UUID \u2014 null uses user's default workspace", "type": "string" } }, "required": ["name"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "edf5cf688d7c039a" },
@@ -851,15 +851,19 @@ var generatedTools = [
   { "mcpName": "erd_list_tables", "commandPath": ["erd", "list-tables"], "group": "erd", "description": "", "inputSchema": { "properties": { "documentUuid": { "description": "ERD document UUID", "type": "string" } }, "required": ["documentUuid"], "type": "object" }, "required": ["documentUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "34324dfc7ef461c8" },
   { "mcpName": "get_attachment", "commandPath": ["attachment", "get"], "group": "attachment", "description": "", "inputSchema": { "properties": { "uuid": { "description": "Attachment UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "required": ["uuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "1e0e7f1bf33b669c" },
   { "mcpName": "get_document", "commandPath": ["document", "get"], "group": "document", "description": "Read a document. The body comes back for the types whose create/update take one: markdown \u2192 content; openapi \u2192 content (the spec text) + format/specVersion/pathCount/operationCount; html \u2192 content (the HTML text); file \u2192 file {filename, contentType, sizeBytes, viewerKind} + content for text/CSV (first 64 KB); diagram \u2192 diagramSource/sourceLanguage/edgeStyle/isModule/metadata; erd \u2192 metadata only (read tables/refs via erd_list_*).", "inputSchema": { "properties": { "uuid": { "description": "Document UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "required": ["uuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "2efef592c2d6dd7a" },
+  { "mcpName": "get_my_work_summary", "commandPath": ["my-work-summary", "get"], "group": "generic", "description": `One-call summary of what is waiting for the signed-in user in AiNecto \u2014 call it when the user asks things like "do I have anything to do?", "anything new?", "anything to review?" or "did anyone ask me something?". Returns notifications {unread (not yet read by the person, newest 100 counted; unreadCapped when there are more), unreadByKind, newForThisConnection (not yet acknowledged by this connection \u2014 the same number as the line at the end of tool results)}, mentionsToRead {items the person has not read that mention them, each with target title and url}, and todos {open, leaseExpired, inProgress, items: questions and requests waiting for the user's agent}. For details use list_notifications and list_agent_todos; to read the document and its comments use get_document with the target uuid. Read-only: nothing is marked read or acknowledged.`, "inputSchema": { "additionalProperties": false, "properties": { "projectUuid": { "description": "Older single-value form of projectUuids.", "type": "string" }, "projectUuids": { "description": "Only items in any of these projects. Use it when the user names a project or the project you are working in is clear. With workspaceUuids too, both must match. A workspace or project you cannot see matches nothing.", "items": { "type": "string" }, "type": "array", "uniqueItems": true }, "workspaceUuids": { "description": "Only items in any of these workspaces.", "items": { "type": "string" }, "type": "array", "uniqueItems": true } }, "type": "object" }, "required": [], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "bc63904d51058f42" },
   { "mcpName": "get_project", "commandPath": ["project", "get"], "group": "generic", "description": "", "inputSchema": { "properties": { "uuid": { "description": "Project UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "required": ["uuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "192403c3484ac774" },
   { "mcpName": "get_version", "commandPath": ["version", "get"], "group": "generic", "description": "", "inputSchema": { "properties": { "documentUuid": { "description": "Document UUID", "type": "string" }, "versionNumber": { "description": "Version number", "type": "integer" } }, "required": ["documentUuid", "versionNumber"], "type": "object" }, "required": ["documentUuid", "versionNumber"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "4e308c1a8c7203d1" },
   { "mcpName": "get_workspace", "commandPath": ["workspace", "get"], "group": "workspace", "description": "", "inputSchema": { "properties": { "uuid": { "description": "Workspace UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "required": ["uuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "db6d1b4879d57c56" },
   { "mcpName": "identity_get_self", "commandPath": ["tools", "run", "identity-get-self"], "group": "generic", "description": "Return the authenticated MCP caller identity summary; never returns email or token claims.", "inputSchema": { "additionalProperties": false, "properties": {}, "type": "object" }, "required": [], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "f29c86804eb91700" },
+  { "mcpName": "list_agent_todos", "commandPath": ["agent-todos", "list"], "group": "generic", "description": "List the to-dos that ask the signed-in user's agent to act now (for example a question that mentions the user). This is the current state, not a feed: a to-do you have not finished comes back on every call until it is completed, dismissed, or closed because the person did it themselves. Each item has todoId, kind, obligation, openedAt, summary, target (title and url), action and state. To work on one, claim it with update_agent_todos and complete it with a one-line note. Actions that affect other people (assigning, approving, inviting) need the user's confirmation first.", "inputSchema": { "additionalProperties": false, "properties": { "after": { "description": "todoId of the last item of the previous page.", "type": "string" }, "kinds": { "description": "Only these kinds.", "items": { "enum": ["COMMENT_MENTIONED", "COMMENT_REPLIED", "QUESTION_ANSWERED", "QUESTION_RESOLVED", "QUESTION_MENTIONED"], "type": "string" }, "type": "array", "uniqueItems": true }, "limit": { "description": "Items per call, default 20.", "maximum": 50, "minimum": 1, "type": "integer" }, "projectUuid": { "description": "Older single-value form of projectUuids.", "type": "string" }, "projectUuids": { "description": "Only to-dos in any of these projects. Use it when the user names a project or the project you are working in is clear. With workspaceUuids too, both must match. A workspace or project you cannot see matches nothing.", "items": { "type": "string" }, "type": "array", "uniqueItems": true }, "state": { "description": "OPEN (default): to-dos you can take, including ones whose lease expired. MINE: to-dos currently leased (claimed) and not expired.", "items": { "enum": ["OPEN", "MINE"], "type": "string" }, "type": "array", "uniqueItems": true }, "workspaceUuids": { "description": "Only to-dos in any of these workspaces.", "items": { "type": "string" }, "type": "array", "uniqueItems": true } }, "type": "object" }, "required": [], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "9c228a3044a546cf" },
   { "mcpName": "list_attachments", "commandPath": ["attachments", "list"], "group": "attachment", "description": "", "inputSchema": { "properties": { "projectUuid": { "description": "Project UUID", "type": "string" } }, "required": ["projectUuid"], "type": "object" }, "required": ["projectUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "fae7152d1e4a930b" },
   { "mcpName": "list_comments", "commandPath": ["comments", "list"], "group": "generic", "description": "List the active comments on a document, oldest first, including replies (a reply has parentCommentId set; replies are one level deep). Each comment has id, kind (COMMENT or QUESTION), body, author, mentions (userId, label and position in the body), and for questions questionState (UNANSWERED, ANSWERED, RESOLVED) and resolvedAt. Anyone who can read the document can list its comments.", "inputSchema": { "additionalProperties": false, "properties": { "documentUuid": { "description": "Document UUID the comments belong to", "type": "string" } }, "required": ["documentUuid"], "type": "object" }, "required": ["documentUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "4c60115a00f61404" },
   { "mcpName": "list_documents", "commandPath": ["documents", "list"], "group": "document", "description": "", "inputSchema": { "properties": { "folderUuid": { "description": "Optional folder UUID", "type": "string" }, "limit": { "description": "Result cap when q is set (default 50)", "type": "integer" }, "projectUuid": { "description": "Project UUID", "type": "string" }, "q": { "description": "Optional full-text query. When provided, results come from the search index instead of folder listing.", "type": "string" }, "type": { "description": "Optional document type filter. Readable values: erd, markdown, diagram, openapi, html, file.", "enum": ["erd", "markdown", "diagram", "openapi", "html", "file"], "type": "string" } }, "type": "object" }, "required": [], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "2171496b44dc2abf" },
   { "mcpName": "list_folders", "commandPath": ["folders", "list"], "group": "generic", "description": "", "inputSchema": { "properties": { "projectUuid": { "description": "Project UUID", "type": "string" } }, "required": ["projectUuid"], "type": "object" }, "required": ["projectUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "461dc6735ac92c3b" },
+  { "mcpName": "list_history", "commandPath": ["history", "list"], "group": "generic", "description": "List recent activity (who did what, people and agents) in a workspace, a project, or on one resource, newest first. Give at least one of workspaceUuid, projectUuid, or resourceType with resourceUuid; you need editor access or higher in that scope. This is a list to refresh, not a gap-free feed: to see what is new, read the first page again and skip ids you have already seen; to get each new notification exactly once use list_notifications. Each item has id, kind, at, lastAt, coalesceCount, actor, target (title and url only when you can read it now), changes and summary.", "inputSchema": { "additionalProperties": false, "properties": { "actorType": { "description": "Only people (USER) or only agents (AGENT).", "enum": ["USER", "AGENT"], "type": "string" }, "before": { "description": "nextCursor of the previous page (older items).", "type": "string" }, "kinds": { "description": "Only these kinds.", "items": { "enum": ["COMMENT_MENTIONED", "COMMENT_REPLIED", "QUESTION_ANSWERED", "QUESTION_RESOLVED", "QUESTION_MENTIONED"], "type": "string" }, "type": "array", "uniqueItems": true }, "limit": { "description": "Items per call, default 20.", "maximum": 50, "minimum": 1, "type": "integer" }, "projectUuid": { "description": "Activity in this project.", "type": "string" }, "resourceType": { "description": "With resourceUuid: activity on one resource.", "enum": ["DOCUMENT", "PROJECT"], "type": "string" }, "resourceUuid": { "description": "UUID of the resource named by resourceType.", "type": "string" }, "workspaceUuid": { "description": "Activity in this workspace.", "type": "string" } }, "type": "object" }, "required": [], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "235832683071654b" },
   { "mcpName": "list_mention_candidates", "commandPath": ["mention-candidates", "list"], "group": "generic", "description": "List the people you can mention in comments on a document: userId and displayName. Only people who can read the document are listed. To mention someone, write @<displayName> exactly in the comment body and pass their userId in mentionUserIds of create_comments or update_comments. Page with nextCursor while hasMore is true.", "inputSchema": { "additionalProperties": false, "properties": { "cursor": { "description": "nextCursor from the previous page (same documentUuid and query).", "type": "string" }, "documentUuid": { "description": "Document UUID the comments belong to", "type": "string" }, "limit": { "description": "Page size, 1..50. Defaults to 20.", "maximum": 50, "minimum": 1, "type": "integer" }, "query": { "description": "Name filter, 0..100 characters. Omit or leave empty for the first page of everyone.", "maxLength": 100, "type": "string" } }, "required": ["documentUuid"], "type": "object" }, "required": ["documentUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "896a5a6ff357268b" },
+  { "mcpName": "list_notifications", "commandPath": ["notifications", "list"], "group": "generic", "description": "Read new notifications for the signed-in user, oldest first and without gaps \u2014 for an agent that checks the inbox periodically. The server remembers, per connection and per filter (kinds, workspaceUuids, projectUuids, directOnly), how far you have acknowledged; a new filter starts from now. Each response carries ackToken: pass it as ack in your next call (with the same filter) after you have handled the batch \u2014 if you do not, the next call returns the same batch again (identify duplicates by id and seq; an item that comes back with a higher seq and a larger groupCount is an update of the same entry). Each item has id, seq, kind, at, summary (one line), actor, target (title and url only when you can read it now), action (what the user is asked to do) and humanRead. An item you can no longer read comes back as {id, seq, at, redacted: true}. This tool never marks anything read for the person; open to-dos are in list_agent_todos. Calls closer than 30 seconds apart (except a call that carries ack) return retryAfterSeconds instead of items.", "inputSchema": { "additionalProperties": false, "properties": { "ack": { "description": "The ackToken of the previous response. Send it with the same filter once you have handled (or safely stored) that batch; only then does the saved position move past it. Without it, the same batch is returned again.", "type": "string" }, "cursor": { "description": 'Where to read from. "saved" (default): after what this connection last acknowledged for this same filter. "latest": from now on (moves the saved position to now). "earliest": everything still kept (90 days). Or a nextCursor from a previous response: read after it without using or changing the saved position.', "type": "string" }, "directOnly": { "description": "Only notifications that point at you directly (mentions, questions to you).", "type": "boolean" }, "kinds": { "description": "Only these notification kinds.", "items": { "enum": ["COMMENT_MENTIONED", "COMMENT_REPLIED", "QUESTION_ANSWERED", "QUESTION_RESOLVED", "QUESTION_MENTIONED"], "type": "string" }, "type": "array", "uniqueItems": true }, "limit": { "description": "Items per call, default 20.", "maximum": 50, "minimum": 1, "type": "integer" }, "projectUuid": { "description": "Older single-value form of projectUuids.", "type": "string" }, "projectUuids": { "description": "Only notifications in any of these projects. Use it when the user names a project or the project you are working in is clear. With workspaceUuids too, both must match. A workspace or project you cannot see matches nothing.", "items": { "type": "string" }, "type": "array", "uniqueItems": true }, "workspaceUuids": { "description": "Only notifications in any of these workspaces.", "items": { "type": "string" }, "type": "array", "uniqueItems": true } }, "type": "object" }, "required": [], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "0c2bb3fdc8291b03" },
   { "mcpName": "list_projects", "commandPath": ["projects", "list"], "group": "generic", "description": "", "inputSchema": { "properties": { "limit": { "description": "Result cap when q is set (default 50)", "type": "integer" }, "q": { "description": "Optional full-text query", "type": "string" }, "workspaceUuid": { "description": "Optional Workspace UUID", "type": "string" } }, "type": "object" }, "required": [], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "939bfcc088425771" },
   { "mcpName": "list_trash", "commandPath": ["trash", "list"], "group": "generic", "description": "", "inputSchema": { "properties": {}, "type": "object" }, "required": [], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "329250aecc06a298" },
   { "mcpName": "list_versions", "commandPath": ["versions", "list"], "group": "generic", "description": "", "inputSchema": { "properties": { "documentUuid": { "description": "Document UUID", "type": "string" } }, "required": ["documentUuid"], "type": "object" }, "required": ["documentUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "f08f9faee3ba9107" },
@@ -877,7 +881,8 @@ var generatedTools = [
   { "mcpName": "unarchive_folders", "commandPath": ["folders", "unarchive"], "group": "generic", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Folder UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "2a24cc44696b7906" },
   { "mcpName": "unarchive_projects", "commandPath": ["projects", "unarchive"], "group": "generic", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Project UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "6925e444671afe19" },
   { "mcpName": "unarchive_workspaces", "commandPath": ["workspaces", "unarchive"], "group": "workspace", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Workspace UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "8dafe9bc6378c3f2" },
-  { "mcpName": "update_comments", "commandPath": ["comments", "update"], "group": "generic", "description": "Edit your own comments on a document. Only the author can edit, and only while they can still read the document. A resolved question and a top-level comment that already has replies are locked. Items are applied in order and each one commits on its own; results report each item.", "inputSchema": { "additionalProperties": false, "properties": { "documentUuid": { "description": "Document UUID the comments belong to", "type": "string" }, "items": { "description": "Edits, applied in order", "items": { "additionalProperties": false, "properties": { "body": { "description": "New comment text (replaces the old text).", "maxLength": 1e4, "minLength": 1, "type": "string" }, "clientMutationId": { "description": "Idempotency key (visible ASCII, at most 128 characters). Required when mentionUserIds is not empty; reuse the same value when retrying the same item so the mention email is not sent twice.", "maxLength": 128, "type": "string" }, "id": { "description": "Comment id (from mcp__ainecto__list_comments)", "minimum": 1, "type": "integer" }, "mentionUserIds": { "description": "The complete set of userIds mentioned after the edit; omit to remove all mentions. Each one's @<displayName> must appear in body. Only people who were not mentioned before get a notification email.", "items": { "type": "string" }, "maxItems": 20, "type": "array", "uniqueItems": true } }, "required": ["id", "body"], "type": "object" }, "minItems": 1, "type": "array" }, "mailLanguage": { "description": "Language of the mention notification email. Defaults to en.", "enum": ["en", "ko"], "type": "string" } }, "required": ["documentUuid", "items"], "type": "object" }, "required": ["documentUuid", "items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "fa37fedfdebd8d54" },
+  { "mcpName": "update_agent_todos", "commandPath": ["agent-todos", "update"], "group": "generic", "description": "Claim, renew, complete, release, or dismiss the signed-in user's agent to-dos. Only the session holding the current leaseToken may renew, release, or complete a claimed to-do \u2014 even another session of the same connection gets CLAIMED_BY_OTHER. Results are per item: {todoId, ok: true, state, leaseToken?, claimExpiresAt?} or {todoId, ok: false, error} with error one of CLAIMED_BY_OTHER, LEASE_LOST, ALREADY_DONE, CLOSED_BY_HUMAN, SUPERSEDED, ACCESS_LOST, NOT_FOUND, INVALID \u2014 on CLOSED_BY_HUMAN or SUPERSEDED stop working on it. Retrying the same complete or dismiss returns ok again. There is no tool to mark the person's notifications read.", "inputSchema": { "additionalProperties": false, "properties": { "items": { "description": "To-dos to update; each item is applied and reported on its own.", "items": { "additionalProperties": false, "properties": { "action": { "description": "claim: take it (returns leaseToken, valid 30 minutes). renew: extend your lease. complete: done (with leaseToken if you claimed it; without one only while it is still OPEN). release: give it back. dismiss: not a to-do.", "enum": ["claim", "renew", "complete", "release", "dismiss"], "type": "string" }, "leaseToken": { "description": "Required for renew and release, and for complete or dismiss of a to-do you claimed.", "type": "string" }, "note": { "description": "For complete or dismiss: one line on what you did (at most 500 characters, no document bodies). The person sees it in the inbox.", "maxLength": 500, "type": "string" }, "todoId": { "description": "todoId from list_agent_todos.", "type": "string" } }, "required": ["todoId", "action"], "type": "object" }, "maxItems": 50, "minItems": 1, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "da38f4f54f68dbce" },
+  { "mcpName": "update_comments", "commandPath": ["comments", "update"], "group": "generic", "description": "Edit your own comments on a document. Only the author can edit, and only while they can still read the document. A resolved question and a top-level comment that already has replies are locked. Items are applied in order and each one commits on its own; results report each item.", "inputSchema": { "additionalProperties": false, "properties": { "documentUuid": { "description": "Document UUID the comments belong to", "type": "string" }, "items": { "description": "Edits, applied in order", "items": { "additionalProperties": false, "properties": { "body": { "description": "New comment text (replaces the old text).", "maxLength": 1e4, "minLength": 1, "type": "string" }, "clientMutationId": { "description": "Idempotency key (visible ASCII, at most 128 characters). Required when mentionUserIds is not empty; reuse the same value when retrying the same item so the mention email is not sent twice.", "maxLength": 128, "type": "string" }, "id": { "description": "Comment id (from mcp__ainecto__list_comments)", "minimum": 1, "type": "integer" }, "mentionUserIds": { "description": "The complete set of userIds mentioned after the edit; omit to remove all mentions. Each one's @<displayName> must appear in body. Only people who were not mentioned before get a notification email.", "items": { "type": "string" }, "maxItems": 20, "type": "array", "uniqueItems": true } }, "required": ["id", "body"], "type": "object" }, "minItems": 1, "type": "array" }, "mailLanguage": { "description": "Language of the comment notification email (mention or reply). Defaults to en.", "enum": ["en", "ko"], "type": "string" } }, "required": ["documentUuid", "items"], "type": "object" }, "required": ["documentUuid", "items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "3c13611a49c95979" },
   { "mcpName": "update_documents", "commandPath": ["documents", "update"], "group": "document", "description": "Update documents. If a replacement body is tens of KB or more, prefer request_upload_token (purpose=document.update) and upload the body with curl.", "inputSchema": { "properties": { "items": { "description": "Updates", "items": { "properties": { "body": { "description": "Deprecated compatibility alias for typePayload.body when document type is markdown. \uBCF8\uBB38\uC774 \uC218\uC2ED KB \uC774\uC0C1\uC73C\uB85C \uD06C\uBA74 LLM \uD1A0\uD070 \uC808\uC57D\uC744 \uC704\uD574 `request_upload_token (purpose=document.update)` \uB97C \uD638\uCD9C\uD574 uploadUrl \uC744 \uBC1B\uACE0 curl \uB85C \uC9C1\uC811 PUT \uC73C\uB85C \uBCF4\uB0BC \uAC83.", "type": "string" }, "title": { "description": "New title", "type": "string" }, "typePayload": { "description": "Type-specific payload for enabled document types. markdown: {body}; diagram: {diagramSource,sourceLanguage,edgeStyle,isModule,metadata}; openapi: {content}; html: {content} (a full HTML page); file: {file:{filename,contentType,sizeBytes,viewerKind}} (+content for text/CSV, first 64 KB).", "type": "object" }, "uuid": { "description": "Document UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "c2088f9ef5b49c6c" },
   { "mcpName": "update_folders", "commandPath": ["folders", "update"], "group": "generic", "description": "", "inputSchema": { "properties": { "items": { "description": "Updates", "items": { "properties": { "name": { "description": "New name", "type": "string" }, "uuid": { "description": "Folder UUID", "type": "string" } }, "required": ["uuid", "name"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "43c58a96ee632b5f" },
   { "mcpName": "update_projects", "commandPath": ["projects", "update"], "group": "generic", "description": "", "inputSchema": { "properties": { "items": { "description": "Updates", "items": { "properties": { "description": { "description": "New description", "type": "string" }, "name": { "description": "New name", "type": "string" }, "uuid": { "description": "Project UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "7d849ef0a830aa8c" },
@@ -1527,6 +1532,9 @@ async function promptConfirmation(io, message) {
 
 // src/adapters/cli/bespokeCommands.ts
 var ATTACHMENTS_UPLOAD_COMMAND_PATH = ["attachments", "upload"];
+var NOTIFICATIONS_POLL_COMMAND_PATH = ["notifications", "poll"];
+var NOTIFICATIONS_ACK_COMMAND_PATH = ["notifications", "ack"];
+var AGENT_TODOS_POLL_COMMAND_PATH = ["agent-todos", "poll"];
 
 // src/adapters/cli/generatedCommandRouter.ts
 function matchGeneratedCommand(tools, argv) {
@@ -1612,6 +1620,34 @@ function findRestStart(argv, commandPath) {
 // src/core/upload/attachmentUpload.ts
 import { readFile as readFile3, stat as stat2 } from "fs/promises";
 import { basename, extname } from "path";
+
+// src/core/mcp/toolPayload.ts
+function unwrapMcpToolPayload(value) {
+  if (!isRecord7(value) || !Array.isArray(value.content)) {
+    return value;
+  }
+  const text = value.content.map((item) => isRecord7(item) && typeof item.text === "string" ? item.text : "").find((itemText) => itemText.trim().startsWith("{"));
+  if (!text) {
+    return value;
+  }
+  try {
+    return JSON.parse(text);
+  } catch {
+    return value;
+  }
+}
+function toolErrorText(value) {
+  if (!isRecord7(value) || !Array.isArray(value.content)) {
+    return "The tool returned an error.";
+  }
+  const text = value.content.map((item) => isRecord7(item) && typeof item.text === "string" ? item.text : "").filter(Boolean).join("\n");
+  return text || "The tool returned an error.";
+}
+function isRecord7(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+// src/core/upload/attachmentUpload.ts
 var AttachmentUploadError = class extends Error {
   constructor(code, message, details) {
     super(message);
@@ -1709,7 +1745,7 @@ async function requestUploadToken(client, metadata, context) {
     requestArgs.ttlSeconds = context.ttlSeconds;
   }
   const response = unwrapMcpToolPayload(await client.toolsCall(context.requestToolName, requestArgs));
-  if (!isRecord7(response)) {
+  if (!isRecord8(response)) {
     throw new AttachmentUploadError("UPLOAD_TOKEN_PROTOCOL_ERROR", "request_upload_token response was not an object.");
   }
   const token = response.token;
@@ -1779,7 +1815,7 @@ function parsePutResponse(text) {
   } catch {
     throw new AttachmentUploadError("ATTACHMENT_UPLOAD_PROTOCOL_ERROR", "Attachment PUT response was not valid JSON.");
   }
-  if (!isRecord7(parsed)) {
+  if (!isRecord8(parsed)) {
     throw new AttachmentUploadError("ATTACHMENT_UPLOAD_PROTOCOL_ERROR", "Attachment PUT response was not an object.");
   }
   if (typeof parsed.storageKey !== "string") {
@@ -1811,20 +1847,6 @@ function validatePutResult(token, metadata, putResult) {
     });
   }
 }
-function unwrapMcpToolPayload(value) {
-  if (!isRecord7(value) || !Array.isArray(value.content)) {
-    return value;
-  }
-  const text = value.content.map((item) => isRecord7(item) && typeof item.text === "string" ? item.text : "").find((itemText) => itemText.trim().startsWith("{"));
-  if (!text) {
-    return value;
-  }
-  try {
-    return JSON.parse(text);
-  } catch {
-    return value;
-  }
-}
 function emitProgress(context, stage, path, filename) {
   context.onProgress?.({
     stage,
@@ -1857,7 +1879,7 @@ var MIME_BY_EXTENSION = {
   ".xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
   ".zip": "application/zip"
 };
-function isRecord7(value) {
+function isRecord8(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
@@ -1981,9 +2003,256 @@ function renderAttachmentUploadResult(result, json) {
   return renderSuccess(lines.join("\n"), { json: false });
 }
 
+// src/adapters/cli/inboxPollCommands.ts
+import { mkdir as mkdir2, open, readFile as readFile4, rename as rename2 } from "fs/promises";
+import { dirname as dirname2 } from "path";
+var EXIT_NOTHING_NEW = 3;
+var LIST_NOTIFICATIONS = "mcp__ainecto__list_notifications";
+var LIST_AGENT_TODOS = "mcp__ainecto__list_agent_todos";
+function isInboxPollCommand(domain, action) {
+  return [NOTIFICATIONS_POLL_COMMAND_PATH, NOTIFICATIONS_ACK_COMMAND_PATH, AGENT_TODOS_POLL_COMMAND_PATH].some(([d, a]) => d === domain && a === action);
+}
+var EXIT_USAGE = 2;
+var USAGE_ERRORS = /* @__PURE__ */ new Set(["UNKNOWN_FLAG", "FLAG_REQUIRES_VALUE", "MISSING_REQUIRED_FLAG", "INVALID_FLAG_VALUE"]);
+async function executeInboxPollCommand(options) {
+  try {
+    if (options.domain === "agent-todos") return await agentTodosPoll(options);
+    if (options.action === "ack") return await notificationsAck(options);
+    return await notificationsPoll(options);
+  } catch (error) {
+    if (error instanceof CliCommandError && USAGE_ERRORS.has(error.code)) {
+      options.io.stderr.write(renderError(error, { json: options.json }));
+      return EXIT_USAGE;
+    }
+    throw error;
+  }
+}
+async function notificationsPoll(options) {
+  const flags = parseFlags(options.argv, ["--cursor-file", "--kinds", "--workspace", "--project", "--limit"], ["--direct-only"]);
+  const cursorPath = requireFlag(flags, "--cursor-file", "notifications poll");
+  const filter = {
+    kinds: flags.values["--kinds"]?.split(",").map((kind) => kind.trim()).filter(Boolean).sort(),
+    ...scopeFilter(flags),
+    directOnly: flags.switches.has("--direct-only")
+  };
+  if (filter.kinds?.length === 0) filter.kinds = void 0;
+  const limit = flags.values["--limit"] === void 0 ? void 0 : positiveInt("--limit", flags.values["--limit"]);
+  const saved = await readCursorFile(cursorPath);
+  if (saved?.ackToken && saved.pendingItems?.length) {
+    if (!sameFilter(saved.filter, filter)) {
+      throw new CliCommandError(
+        "PENDING_BATCH_OTHER_FILTER",
+        `${cursorPath} holds an unacknowledged batch for a different filter. Run \`ainecto notifications ack --cursor-file ${cursorPath}\` after handling it, or use another cursor file for this filter.`,
+        { cursorFile: cursorPath }
+      );
+    }
+    options.io.stdout.write(renderSuccess({ items: saved.pendingItems, pending: true, stream: saved.stream }, { json: options.json }));
+    return 0;
+  }
+  const result = await callTool(options.client, LIST_NOTIFICATIONS, {
+    cursor: "saved",
+    ...filter.kinds ? { kinds: filter.kinds } : {},
+    ...scopeArgs(filter),
+    ...filter.directOnly ? { directOnly: true } : {},
+    ...limit !== void 0 ? { limit } : {}
+  });
+  const items = Array.isArray(result.items) ? result.items : [];
+  const stream = typeof result.stream === "string" ? result.stream : void 0;
+  if (typeof result.retryAfterSeconds === "number") {
+    options.io.stderr.write(`Polled too soon; try again in ${result.retryAfterSeconds}s.
+`);
+    return EXIT_NOTHING_NEW;
+  }
+  if (items.length === 0) {
+    await writeCursorFile(cursorPath, { v: 1, filter, stream });
+    if (options.json) options.io.stdout.write(renderSuccess({ items: [], stream }, { json: true }));
+    return EXIT_NOTHING_NEW;
+  }
+  await writeCursorFile(cursorPath, {
+    v: 1,
+    filter,
+    stream,
+    ackToken: typeof result.ackToken === "string" ? result.ackToken : void 0,
+    pendingItems: items
+  });
+  options.io.stdout.write(renderSuccess({ items, hasMore: result.hasMore === true, stream }, { json: options.json }));
+  return 0;
+}
+async function notificationsAck(options) {
+  const flags = parseFlags(options.argv, ["--cursor-file"], []);
+  const cursorPath = requireFlag(flags, "--cursor-file", "notifications ack");
+  const saved = await readCursorFile(cursorPath);
+  if (!saved?.ackToken) {
+    if (options.json) options.io.stdout.write(renderSuccess({ acked: false }, { json: true }));
+    return EXIT_NOTHING_NEW;
+  }
+  await callTool(options.client, LIST_NOTIFICATIONS, {
+    cursor: "saved",
+    ack: saved.ackToken,
+    ...saved.filter.kinds ? { kinds: saved.filter.kinds } : {},
+    ...scopeArgs(saved.filter),
+    ...saved.filter.directOnly ? { directOnly: true } : {},
+    limit: 1
+  });
+  const acked = saved.pendingItems?.length ?? 0;
+  await writeCursorFile(cursorPath, { v: 1, filter: saved.filter, stream: saved.stream });
+  options.io.stdout.write(renderSuccess({ acked: true, items: acked }, { json: options.json }));
+  return 0;
+}
+async function agentTodosPoll(options) {
+  const flags = parseFlags(options.argv, ["--workspace", "--project", "--seen-file"], ["--only-new"]);
+  const scope = scopeArgs(scopeFilter(flags));
+  const onlyNew = flags.switches.has("--only-new");
+  const seenPath = flags.values["--seen-file"];
+  if (onlyNew && !seenPath) {
+    throw new CliCommandError("MISSING_REQUIRED_FLAG", "--only-new needs --seen-file <path>.", { flag: "--seen-file" });
+  }
+  const items = [];
+  let after;
+  for (let page = 0; page < 20; page += 1) {
+    const result = await callTool(options.client, LIST_AGENT_TODOS, { state: ["OPEN"], ...scope, limit: 50, ...after ? { after } : {} });
+    const pageItems = Array.isArray(result.items) ? result.items.filter(isRecord9) : [];
+    items.push(...pageItems);
+    const last = pageItems[pageItems.length - 1];
+    if (result.hasMore !== true || !last || typeof last.todoId !== "string") break;
+    after = last.todoId;
+  }
+  let shown = items;
+  if (onlyNew && seenPath) {
+    const seen = new Set(await readSeenFile(seenPath));
+    shown = items.filter((item) => typeof item.todoId === "string" && !seen.has(item.todoId));
+    await writeJsonAtomic(seenPath, items.map((item) => item.todoId).filter((id) => typeof id === "string"));
+  }
+  if (shown.length === 0) {
+    if (options.json) options.io.stdout.write(renderSuccess({ items: [] }, { json: true }));
+    return EXIT_NOTHING_NEW;
+  }
+  options.io.stdout.write(renderSuccess({ items: shown }, { json: options.json }));
+  return 0;
+}
+async function callTool(client, name, args) {
+  const raw = await client.toolsCall(name, args);
+  if (isToolError(raw)) {
+    throw new CliCommandError("TOOL_ERROR", toolErrorText(raw), { tool: name });
+  }
+  const payload = unwrapMcpToolPayload(raw);
+  if (!isRecord9(payload)) {
+    throw new CliCommandError("MCP_PROTOCOL_ERROR", `${name} did not return an object.`, { tool: name });
+  }
+  return payload;
+}
+function scopeFilter(flags) {
+  const workspaces = uuidSet(flags.lists["--workspace"]);
+  const projects = uuidSet(flags.lists["--project"]);
+  return {
+    ...workspaces.length ? { workspaceUuids: workspaces } : {},
+    ...projects.length ? { projectUuids: projects } : {}
+  };
+}
+function uuidSet(values) {
+  return [...new Set(values ?? [])].sort();
+}
+function scopeArgs(filter) {
+  const workspaces = filter.workspaceUuids ?? [];
+  const projects = filter.projectUuids ?? [];
+  if (workspaces.length === 0 && projects.length === 1) return { projectUuid: projects[0] };
+  return {
+    ...workspaces.length ? { workspaceUuids: workspaces } : {},
+    ...projects.length ? { projectUuids: projects } : {}
+  };
+}
+function parseFlags(argv, valueFlags, switchFlags) {
+  const values = {};
+  const lists = {};
+  const switches = /* @__PURE__ */ new Set();
+  for (let index = 0; index < argv.length; index += 1) {
+    const arg = argv[index];
+    if (!arg) continue;
+    if (valueFlags.includes(arg)) {
+      const value = argv[index + 1];
+      if (!value || value.startsWith("--")) {
+        throw new CliCommandError("FLAG_REQUIRES_VALUE", `${arg} requires a value.`, { flag: arg });
+      }
+      values[arg] = value;
+      (lists[arg] ??= []).push(value);
+      index += 1;
+    } else if (switchFlags.includes(arg)) {
+      switches.add(arg);
+    } else {
+      throw new CliCommandError("UNKNOWN_FLAG", `Unknown argument ${arg}.`, { flag: arg });
+    }
+  }
+  return { values, lists, switches };
+}
+function requireFlag(flags, flag, command) {
+  const value = flags.values[flag];
+  if (!value) throw new CliCommandError("MISSING_REQUIRED_FLAG", `${command} needs ${flag} <path>.`, { flag });
+  return value;
+}
+function positiveInt(flag, value) {
+  if (!value || !/^[1-9]\d*$/.test(value)) {
+    throw new CliCommandError("INVALID_FLAG_VALUE", `${flag} must be a positive integer.`, { flag, value });
+  }
+  return Number.parseInt(value, 10);
+}
+function sameFilter(a, b) {
+  return JSON.stringify(a.kinds ?? []) === JSON.stringify(b.kinds ?? []) && JSON.stringify(a.workspaceUuids ?? []) === JSON.stringify(b.workspaceUuids ?? []) && JSON.stringify(a.projectUuids ?? []) === JSON.stringify(b.projectUuids ?? []) && a.directOnly === b.directOnly;
+}
+function normalizeSavedFilter(saved) {
+  const { projectUuid, ...rest } = saved;
+  if (rest.projectUuids?.length || !projectUuid) return rest;
+  return { ...rest, projectUuids: [projectUuid] };
+}
+async function readCursorFile(path) {
+  const text = await readFile4(path, "utf8").catch((error) => {
+    if (error.code === "ENOENT") return void 0;
+    throw error;
+  });
+  if (text === void 0 || !text.trim()) return void 0;
+  try {
+    const parsed = JSON.parse(text);
+    if (parsed?.v !== 1 || !isRecord9(parsed.filter)) throw new Error("shape");
+    return { ...parsed, filter: normalizeSavedFilter(parsed.filter) };
+  } catch {
+    throw new CliCommandError("INVALID_CURSOR_FILE", `${path} is not a cursor file written by ainecto notifications poll.`, { cursorFile: path });
+  }
+}
+async function writeCursorFile(path, value) {
+  await writeJsonAtomic(path, value);
+}
+async function readSeenFile(path) {
+  const text = await readFile4(path, "utf8").catch((error) => {
+    if (error.code === "ENOENT") return void 0;
+    throw error;
+  });
+  if (!text?.trim()) return [];
+  try {
+    const parsed = JSON.parse(text);
+    return Array.isArray(parsed) ? parsed.filter((id) => typeof id === "string") : [];
+  } catch {
+    throw new CliCommandError("INVALID_SEEN_FILE", `${path} is not a seen file written by ainecto agent-todos poll.`, { seenFile: path });
+  }
+}
+async function writeJsonAtomic(path, value) {
+  await mkdir2(dirname2(path), { recursive: true });
+  const temp = `${path}.${process.pid}.tmp`;
+  const handle = await open(temp, "w", 384);
+  try {
+    await handle.writeFile(`${JSON.stringify(value, null, 2)}
+`, "utf8");
+    await handle.sync();
+  } finally {
+    await handle.close();
+  }
+  await rename2(temp, path);
+}
+function isRecord9(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
 // src/adapters/cli/initCommand.ts
-import { chmod as chmod2, mkdir as mkdir2, rename as rename2, rm as rm2, rmdir, stat as stat3, writeFile as writeFile2 } from "fs/promises";
-import { dirname as dirname3, join as join3, relative, resolve as resolve2, sep as sep2 } from "path";
+import { chmod as chmod2, mkdir as mkdir3, rename as rename3, rm as rm2, rmdir, stat as stat3, writeFile as writeFile2 } from "fs/promises";
+import { dirname as dirname4, join as join3, relative, resolve as resolve2, sep as sep2 } from "path";
 
 // src/core/harness/agentTargets.ts
 import { basename as basename2 } from "path";
@@ -2003,7 +2272,7 @@ function buildServerEntry(input) {
   return { command: "npx", args };
 }
 function readRoleFromEntry(entry) {
-  if (!isRecord8(entry) || !Array.isArray(entry.args)) {
+  if (!isRecord10(entry) || !Array.isArray(entry.args)) {
     return void 0;
   }
   const index = entry.args.indexOf("--role");
@@ -2017,13 +2286,13 @@ function readServerEntry(existing) {
   try {
     const parsed = JSON.parse(existing);
     const servers = parsed?.mcpServers;
-    return isRecord8(servers) ? servers[SERVER_NAME] : void 0;
+    return isRecord10(servers) ? servers[SERVER_NAME] : void 0;
   } catch {
     return void 0;
   }
 }
 function isOurBridge(entry) {
-  if (!isRecord8(entry)) {
+  if (!isRecord10(entry)) {
     return false;
   }
   const { command, args } = entry;
@@ -2087,7 +2356,7 @@ function readServers(root) {
   if (servers === void 0) {
     return {};
   }
-  if (!isRecord8(servers)) {
+  if (!isRecord10(servers)) {
     throw new Error(
       'Existing MCP config has an "mcpServers" value that is not an object, so it was left untouched. Fix it by hand and run init again.'
     );
@@ -2106,7 +2375,7 @@ function parseConfigObject(existing) {
       `Existing MCP config is not valid JSON, so it was left untouched. Fix it by hand and run init again. (${error instanceof Error ? error.message : String(error)})`
     );
   }
-  if (!isRecord8(parsed)) {
+  if (!isRecord10(parsed)) {
     throw new Error("Existing MCP config must be a JSON object; it was left untouched.");
   }
   return parsed;
@@ -2115,7 +2384,7 @@ function stringify(value) {
   return `${JSON.stringify(value, null, 2)}
 `;
 }
-function isRecord8(value) {
+function isRecord10(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
@@ -2254,14 +2523,14 @@ function managedBlockProblem(key, body) {
   return void 0;
 }
 function hasUnclosedFence(content) {
-  let open;
+  let open2;
   for (const line of content.split("\n")) {
     const fence = fenceOf(line);
     if (!fence) continue;
-    if (!open) open = { char: fence.char, length: fence.length };
-    else if (fence.char === open.char && fence.length >= open.length && fence.info === "") open = void 0;
+    if (!open2) open2 = { char: fence.char, length: fence.length };
+    else if (fence.char === open2.char && fence.length >= open2.length && fence.info === "") open2 = void 0;
   }
-  return open !== void 0;
+  return open2 !== void 0;
 }
 function canonicalManagedBlock(block) {
   return block.trim();
@@ -2321,24 +2590,24 @@ function hit(at, marker) {
   return at >= 0 ? { at, length: marker.length } : void 0;
 }
 function isInsideFencedBlock(content, index) {
-  let open;
+  let open2;
   let offset = 0;
   for (const line of content.split("\n")) {
     const nextOffset = offset + line.length + 1;
     if (index < nextOffset) {
-      return open !== void 0;
+      return open2 !== void 0;
     }
     const fence = fenceOf(line);
     if (fence) {
-      if (!open) {
-        open = { char: fence.char, length: fence.length };
-      } else if (fence.char === open.char && fence.length >= open.length && fence.info === "") {
-        open = void 0;
+      if (!open2) {
+        open2 = { char: fence.char, length: fence.length };
+      } else if (fence.char === open2.char && fence.length >= open2.length && fence.info === "") {
+        open2 = void 0;
       }
     }
     offset = nextOffset;
   }
-  return open !== void 0;
+  return open2 !== void 0;
 }
 function fenceOf(line) {
   const match = /^ {0,3}(`{3,}|~{3,})(.*)$/.exec(line);
@@ -2667,9 +2936,9 @@ function isStringArray(value) {
 import { createHash as createHash4 } from "crypto";
 
 // src/core/harness/repositoryRole.ts
-import { lstat, readFile as readFile4, realpath } from "fs/promises";
+import { lstat, readFile as readFile5, realpath } from "fs/promises";
 import { homedir as homedir2 } from "os";
-import { dirname as dirname2, join as join2, resolve, sep } from "path";
+import { dirname as dirname3, join as join2, resolve, sep } from "path";
 function readConfigRole(path, content) {
   if (content === void 0 || !content.trim()) {
     return { kind: "absent" };
@@ -2707,7 +2976,7 @@ function rolesInFiles(files) {
 }
 async function findRepositoryRole(cwd, home = homedir2()) {
   const stopAt = await realOrResolved(home);
-  for (let dir = await realOrResolved(cwd); ; dir = dirname2(dir)) {
+  for (let dir = await realOrResolved(cwd); ; dir = dirname3(dir)) {
     if (samePath(dir, stopAt)) {
       return { kind: "none" };
     }
@@ -2737,7 +3006,7 @@ async function findRepositoryRole(cwd, home = homedir2()) {
       }
       return { kind: "role", role: result.roles[0], dir };
     }
-    if (dirname2(dir) === dir) {
+    if (dirname3(dir) === dir) {
       return { kind: "none" };
     }
   }
@@ -2774,16 +3043,16 @@ async function readConfigInside(dir, path) {
   if (!samePath(real, realDir) && !real.startsWith(realDir + sep) && !(process.platform === "win32" && real.toLowerCase().startsWith((realDir + sep).toLowerCase()))) {
     throw new Error(`${path} points outside ${dir} (${real})`);
   }
-  return readFile4(real, "utf8");
+  return readFile5(real, "utf8");
 }
 async function findGitRoot(cwd) {
-  for (let at = resolve(cwd); ; at = dirname2(at)) {
+  for (let at = resolve(cwd); ; at = dirname3(at)) {
     try {
       await lstat(join2(at, ".git"));
       return at;
     } catch {
     }
-    if (dirname2(at) === at) {
+    if (dirname3(at) === at) {
       return void 0;
     }
   }
@@ -2794,7 +3063,7 @@ async function readManagedFile(root, path) {
 }
 async function readIfExists(absolutePath) {
   try {
-    return await readFile4(absolutePath, "utf8");
+    return await readFile5(absolutePath, "utf8");
   } catch (error) {
     if (isNodeError2(error, "ENOENT")) {
       return void 0;
@@ -2807,7 +3076,7 @@ async function assertInsideRepository(root, relativePath) {
   const realRoot = await realpath(root);
   let realParent;
   try {
-    realParent = await realpath(dirname2(absolutePath));
+    realParent = await realpath(dirname3(absolutePath));
   } catch (error) {
     if (isNodeError2(error, "ENOENT")) {
       return;
@@ -3818,11 +4087,11 @@ async function createProject(options, name) {
   return first;
 }
 function unwrapToolJson(result) {
-  if (!isRecord9(result) || !Array.isArray(result.content)) {
+  if (!isRecord11(result) || !Array.isArray(result.content)) {
     return result;
   }
-  const first = result.content.find((item) => isRecord9(item) && item.type === "text");
-  if (!isRecord9(first) || typeof first.text !== "string") {
+  const first = result.content.find((item) => isRecord11(item) && item.type === "text");
+  if (!isRecord11(first) || typeof first.text !== "string") {
     return result;
   }
   try {
@@ -3832,13 +4101,13 @@ function unwrapToolJson(result) {
   }
 }
 function extractProjects(value) {
-  const candidates = Array.isArray(value) ? value : isRecord9(value) ? ["projects", "items", "created", "data", "hits"].flatMap((key) => {
+  const candidates = Array.isArray(value) ? value : isRecord11(value) ? ["projects", "items", "created", "data", "hits"].flatMap((key) => {
     const nested = value[key];
     return Array.isArray(nested) ? nested : [];
   }) : [];
   const projects = [];
   for (const candidate of candidates) {
-    if (isRecord9(candidate) && typeof candidate.uuid === "string") {
+    if (isRecord11(candidate) && typeof candidate.uuid === "string") {
       projects.push({
         uuid: candidate.uuid,
         name: typeof candidate.name === "string" ? candidate.name : candidate.uuid
@@ -3879,9 +4148,9 @@ async function applyPlan(root, plan, dryRun, snapshot, recordFirst = true) {
   }
   const applied = [];
   try {
-    const isRecord10 = (path) => !recordFirst && path === HARNESS_RECORD_PATH;
-    const recordWrites = plan.writes.filter((write) => isRecord10(write.path));
-    const recordDeletes = plan.deletes.filter((path) => isRecord10(path));
+    const isRecord12 = (path) => !recordFirst && path === HARNESS_RECORD_PATH;
+    const recordWrites = plan.writes.filter((write) => isRecord12(write.path));
+    const recordDeletes = plan.deletes.filter((path) => isRecord12(path));
     const createdDirectories = [...plan.record?.createdDirectories ?? []];
     const rememberDirectories = (directories) => {
       for (const directory of directories) {
@@ -3923,8 +4192,8 @@ async function applyPlan(root, plan, dryRun, snapshot, recordFirst = true) {
     };
     try {
       await apply(
-        orderedWrites(plan.writes.filter((write) => !isRecord10(write.path)), recordFirst),
-        plan.deletes.filter((path) => !isRecord10(path))
+        orderedWrites(plan.writes.filter((write) => !isRecord12(write.path)), recordFirst),
+        plan.deletes.filter((path) => !isRecord12(path))
       );
       await recordDirectoriesOrExplain(false);
       await apply(recordWrites, recordDeletes);
@@ -3961,8 +4230,8 @@ async function assertUnchangedSinceSnapshot(root, relativePath, snapshot) {
 }
 async function writeManagedFile(root, write, onDirectoriesCreated) {
   const absolutePath = join3(root, write.path);
-  const targetDirectory = dirname3(absolutePath);
-  const firstCreated = await mkdir2(targetDirectory, { recursive: true });
+  const targetDirectory = dirname4(absolutePath);
+  const firstCreated = await mkdir3(targetDirectory, { recursive: true });
   const created = createdChain(root, firstCreated, targetDirectory);
   onDirectoriesCreated?.(created);
   const previousMode = await fileMode(absolutePath);
@@ -3971,7 +4240,7 @@ async function writeManagedFile(root, write, onDirectoriesCreated) {
   if (previousMode !== void 0) {
     await chmod2(tmpPath, previousMode);
   }
-  await rename2(tmpPath, absolutePath);
+  await rename3(tmpPath, absolutePath);
   return created;
 }
 function createdChain(root, firstCreated, targetDirectory) {
@@ -3980,12 +4249,12 @@ function createdChain(root, firstCreated, targetDirectory) {
   }
   const stop = resolve2(firstCreated);
   const made = [];
-  for (let at = resolve2(targetDirectory); ; at = dirname3(at)) {
+  for (let at = resolve2(targetDirectory); ; at = dirname4(at)) {
     const asRelative = relative(root, at);
     if (asRelative && !asRelative.startsWith("..")) {
       made.push(asRelative.split(sep2).join("/"));
     }
-    if (at === stop || dirname3(at) === at) {
+    if (at === stop || dirname4(at) === at) {
       break;
     }
   }
@@ -3995,7 +4264,7 @@ async function fileMode(absolutePath) {
   try {
     return (await stat3(absolutePath)).mode & 4095;
   } catch (error) {
-    if (isRecord9(error) && error.code === "ENOENT") {
+    if (isRecord11(error) && error.code === "ENOENT") {
       return void 0;
     }
     throw error;
@@ -4035,7 +4304,7 @@ function basenameOf(path) {
   const parts = path.split(/[\\/]/).filter(Boolean);
   return parts[parts.length - 1] ?? "ainecto-project";
 }
-function isRecord9(value) {
+function isRecord11(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
@@ -4139,7 +4408,7 @@ async function runAinectoCli(argv, io) {
       });
     }
     let routeTools = getGeneratedTools(env);
-    let remote = isAttachmentsUploadCommand(domain, action) || domain === "tools" && (action === "list" || action === "call") || matchGeneratedCommand(routeTools, parsed.positionals) !== void 0;
+    let remote = isAttachmentsUploadCommand(domain, action) || isInboxPollCommand(domain, action) || domain === "tools" && (action === "list" || action === "call") || matchGeneratedCommand(routeTools, parsed.positionals) !== void 0;
     if (!remote) {
       const live = await loadLiveTools(env, connect(null).client).catch(() => void 0);
       if (live && matchGeneratedCommand(live, parsed.positionals)) {
@@ -4160,6 +4429,9 @@ async function runAinectoCli(argv, io) {
         io
       });
     }
+    if (isInboxPollCommand(domain, action)) {
+      return await executeInboxPollCommand({ domain, action, argv: rest, client, json: parsed.json, io });
+    }
     const generatedResult = await executeGeneratedCommand({
       tools: routeTools,
       argv: parsed.positionals,
@@ -4324,6 +4596,11 @@ function helpText() {
     "  ainecto tools list [--env prod|dev] [--endpoint URL] [--json]",
     "  ainecto tools call <mcpName> [-f payload.json|@-] [inline-json] [--json]",
     "  ainecto attachments upload --document-uuid <uuid> <file...> [--json]",
+    "  ainecto notifications poll --cursor-file <path> [--kinds A,B] [--workspace <uuid>]... [--project <uuid>]... [--direct-only] [--limit N] [--json]",
+    "  ainecto notifications ack --cursor-file <path>     (after the agent handled the polled batch)",
+    "  ainecto agent-todos poll [--workspace <uuid>]... [--project <uuid>]... [--only-new --seen-file <path>] [--json]",
+    "      --workspace and --project may repeat: any of the given workspaces AND any of the given projects",
+    "      poll exit codes: 0 new items \xB7 3 nothing new \xB7 1 error \xB7 2 usage error",
     "  ainecto <generated-command> [flags] [-f payload.json] [--yes] [--json]",
     "  ainecto mcp [--env prod|dev] [--endpoint URL] [--role design|development|test|validation]",
     "",