@agentmc/api 0.1.1 → 0.2.1

package/docs/operations/index.json

@@ -766,7 +766,7 @@
     ]
   },
   {
-    "operationId": "commentWorkspaceCalendarItem",
+    "operationId": "commentCalendarItem",
     "method": "post",
     "path": "/calendar/items/{item}/comments",
     "summary": "Add a comment on a calendar item.",
@@ -1662,13 +1662,13 @@
     ]
   },
   {
-    "operationId": "createTask",
+    "operationId": "createCalendarItem",
     "method": "post",
-    "path": "/tasks",
-    "summary": "Create a task.",
+    "path": "/calendar/items",
+    "summary": "Create a calendar item.",
     "description": "",
     "tags": [
-      "Tasks"
+      "Calendar"
     ],
     "security": [
       [
@@ -1687,14 +1687,21 @@
       {
         "mediaType": "application/json",
         "example": {
-          "board_id": 5,
-          "column_id": 13,
-          "title": "Draft post-incident summary",
-          "description": "Capture timeline, impact, and remediation status.",
-          "status": "doing",
-          "position": 2,
-          "due_at": "2026-02-24T17:00:00Z",
-          "assigned_to_user_id": 8
+          "type": "task",
+          "title": "Review outage timeline",
+          "description": "Confirm sequence of events with on-call notes.",
+          "due_at": "2026-02-24T09:00:00Z",
+          "timezone": "America/Los_Angeles",
+          "status": "todo",
+          "priority": "high",
+          "visibility": "workspace",
+          "assignees": [
+            {
+              "assignee_type": "user",
+              "assignee_id": 8,
+              "role": "owner"
+            }
+          ]
         }
       }
     ],
@@ -1702,25 +1709,50 @@
       {
         "status": "201",
         "mediaType": "application/json",
-        "description": "Task created.",
+        "description": "Calendar item created.",
         "hasContent": true,
         "example": {
           "data": {
             "id": 42,
-            "team_id": 42,
-            "board_id": 42,
-            "column_id": 42,
+            "workspace_id": 42,
+            "type": "event",
             "title": "Example Title",
             "description": "Example description text.",
-            "status": "backlog",
-            "position": 1,
+            "start_at": "2026-02-22T17:21:00Z",
+            "end_at": "2026-02-22T17:21:00Z",
             "due_at": "2026-02-22T17:21:00Z",
-            "created_by_user_id": 42,
-            "assigned_to_user_id": 42,
-            "assigned_to_agent_id": 42,
-            "assignee_type": "human",
+            "all_day": false,
+            "location": "example",
+            "timezone": "America/Los_Angeles",
+            "status": "todo",
+            "priority": "low",
+            "visibility": "workspace",
+            "created_by": 1,
+            "updated_by": 1,
+            "assignees": [
+              {
+                "id": 42,
+                "assignee_type": "user",
+                "assignee_id": 42,
+                "role": "owner",
+                "name": "Example Name",
+                "created_at": "2026-02-22T17:21:00Z"
+              }
+            ],
+            "links": [
+              {
+                "id": 42,
+                "link_type": "example",
+                "link_id": 42,
+                "url": "https://agentmc.example.com/docs/incident-123",
+                "title": "Example Title",
+                "created_at": "2026-02-22T17:21:00Z"
+              }
+            ],
+            "comments_count": 1,
             "created_at": "2026-02-22T17:21:00Z",
-            "updated_at": "2026-02-22T17:21:00Z"
+            "updated_at": "2026-02-22T17:21:00Z",
+            "deleted_at": "2026-02-22T17:21:00Z"
           }
         }
       },
@@ -1822,10 +1854,10 @@
     ]
   },
   {
-    "operationId": "createTaskComment",
+    "operationId": "createTask",
     "method": "post",
-    "path": "/tasks/{task}/comments",
-    "summary": "Create a comment on one task.",
+    "path": "/tasks",
+    "summary": "Create a task.",
     "description": "",
     "tags": [
       "Tasks"
@@ -1841,23 +1873,20 @@
         "BearerAuth"
       ]
     ],
-    "parameters": [
-      {
-        "name": "task",
-        "in": "path",
-        "required": true,
-        "description": "Task identifier.",
-        "example": 1
-      }
-    ],
+    "parameters": [],
     "requestBodyRequired": true,
     "requestExamples": [
       {
         "mediaType": "application/json",
         "example": {
-          "body": "Posting a handoff note for [@Alex Morgan](/mentions/user/8) to review before standup.",
-          "actor_type": "agent",
-          "actor_id": 42
+          "board_id": 5,
+          "column_id": 13,
+          "title": "Draft post-incident summary",
+          "description": "Capture timeline, impact, and remediation status.",
+          "status": "doing",
+          "position": 2,
+          "due_at": "2026-02-24T17:00:00Z",
+          "assigned_to_user_id": 8
         }
       }
     ],
@@ -1865,28 +1894,25 @@
       {
         "status": "201",
         "mediaType": "application/json",
-        "description": "Task comment created.",
+        "description": "Task created.",
         "hasContent": true,
         "example": {
           "data": {
             "id": 42,
-            "task_id": 42,
-            "actor_type": "user",
-            "actor_id": 42,
-            "actor_name": "Example Name",
-            "body": "Example content.",
-            "mentions": [
-              {
-                "key": "example",
-                "type": "user",
-                "id": 42,
-                "label": "example",
-                "handle": "example",
-                "token": "example"
-              }
-            ],
-            "edited_at": "2026-02-22T17:21:00Z",
-            "created_at": "2026-02-22T17:21:00Z"
+            "team_id": 42,
+            "board_id": 42,
+            "column_id": 42,
+            "title": "Example Title",
+            "description": "Example description text.",
+            "status": "backlog",
+            "position": 1,
+            "due_at": "2026-02-22T17:21:00Z",
+            "created_by_user_id": 42,
+            "assigned_to_user_id": 42,
+            "assigned_to_agent_id": 42,
+            "assignee_type": "human",
+            "created_at": "2026-02-22T17:21:00Z",
+            "updated_at": "2026-02-22T17:21:00Z"
           }
         }
       },
@@ -1909,6 +1935,25 @@
           }
         }
       },
+      {
+        "status": "402",
+        "mediaType": "application/json",
+        "description": "Plan limit reached.",
+        "hasContent": true,
+        "example": {
+          "error": {
+            "code": "validation.failed",
+            "message": "Validation failed.",
+            "details": {
+              "fields": {
+                "title": [
+                  "The title field is required."
+                ]
+              }
+            }
+          }
+        }
+      },
       {
         "status": "403",
         "mediaType": "application/json",
@@ -1969,13 +2014,13 @@
     ]
   },
   {
-    "operationId": "createWorkspaceCalendarItem",
+    "operationId": "createTaskComment",
     "method": "post",
-    "path": "/calendar/items",
-    "summary": "Create a calendar item.",
+    "path": "/tasks/{task}/comments",
+    "summary": "Create a comment on one task.",
     "description": "",
     "tags": [
-      "Calendar"
+      "Tasks"
     ],
     "security": [
       [
@@ -1988,27 +2033,23 @@
         "BearerAuth"
       ]
     ],
-    "parameters": [],
+    "parameters": [
+      {
+        "name": "task",
+        "in": "path",
+        "required": true,
+        "description": "Task identifier.",
+        "example": 1
+      }
+    ],
     "requestBodyRequired": true,
     "requestExamples": [
       {
         "mediaType": "application/json",
         "example": {
-          "type": "task",
-          "title": "Review outage timeline",
-          "description": "Confirm sequence of events with on-call notes.",
-          "due_at": "2026-02-24T09:00:00Z",
-          "timezone": "America/Los_Angeles",
-          "status": "todo",
-          "priority": "high",
-          "visibility": "workspace",
-          "assignees": [
-            {
-              "assignee_type": "user",
-              "assignee_id": 8,
-              "role": "owner"
-            }
-          ]
+          "body": "Posting a handoff note for [@Alex Morgan](/mentions/user/8) to review before standup.",
+          "actor_type": "agent",
+          "actor_id": 42
         }
       }
     ],
@@ -2016,50 +2057,28 @@
       {
         "status": "201",
         "mediaType": "application/json",
-        "description": "Calendar item created.",
+        "description": "Task comment created.",
         "hasContent": true,
         "example": {
           "data": {
             "id": 42,
-            "workspace_id": 42,
-            "type": "event",
-            "title": "Example Title",
-            "description": "Example description text.",
-            "start_at": "2026-02-22T17:21:00Z",
-            "end_at": "2026-02-22T17:21:00Z",
-            "due_at": "2026-02-22T17:21:00Z",
-            "all_day": false,
-            "location": "example",
-            "timezone": "America/Los_Angeles",
-            "status": "todo",
-            "priority": "low",
-            "visibility": "workspace",
-            "created_by": 1,
-            "updated_by": 1,
-            "assignees": [
-              {
-                "id": 42,
-                "assignee_type": "user",
-                "assignee_id": 42,
-                "role": "owner",
-                "name": "Example Name",
-                "created_at": "2026-02-22T17:21:00Z"
-              }
-            ],
-            "links": [
+            "task_id": 42,
+            "actor_type": "user",
+            "actor_id": 42,
+            "actor_name": "Example Name",
+            "body": "Example content.",
+            "mentions": [
               {
+                "key": "example",
+                "type": "user",
                 "id": 42,
-                "link_type": "example",
-                "link_id": 42,
-                "url": "https://agentmc.example.com/docs/incident-123",
-                "title": "Example Title",
-                "created_at": "2026-02-22T17:21:00Z"
+                "label": "example",
+                "handle": "example",
+                "token": "example"
               }
             ],
-            "comments_count": 1,
-            "created_at": "2026-02-22T17:21:00Z",
-            "updated_at": "2026-02-22T17:21:00Z",
-            "deleted_at": "2026-02-22T17:21:00Z"
+            "edited_at": "2026-02-22T17:21:00Z",
+            "created_at": "2026-02-22T17:21:00Z"
           }
         }
       },
@@ -2083,9 +2102,9 @@
         }
       },
       {
-        "status": "402",
+        "status": "403",
         "mediaType": "application/json",
-        "description": "Plan limit reached.",
+        "description": "Forbidden.",
         "hasContent": true,
         "example": {
           "error": {
@@ -2102,9 +2121,9 @@
         }
       },
       {
-        "status": "403",
+        "status": "404",
         "mediaType": "application/json",
-        "description": "Forbidden.",
+        "description": "Resource not found.",
         "hasContent": true,
         "example": {
           "error": {
@@ -2121,28 +2140,9 @@
         }
       },
       {
-        "status": "404",
+        "status": "422",
         "mediaType": "application/json",
-        "description": "Resource not found.",
-        "hasContent": true,
-        "example": {
-          "error": {
-            "code": "validation.failed",
-            "message": "Validation failed.",
-            "details": {
-              "fields": {
-                "title": [
-                  "The title field is required."
-                ]
-              }
-            }
-          }
-        }
-      },
-      {
-        "status": "422",
-        "mediaType": "application/json",
-        "description": "Validation failed.",
+        "description": "Validation failed.",
         "hasContent": true,
         "example": {
           "error": {
@@ -2512,13 +2512,13 @@
     ]
   },
   {
-    "operationId": "deleteTask",
+    "operationId": "deleteCalendarItem",
     "method": "delete",
-    "path": "/tasks/{task}",
-    "summary": "Delete a task.",
+    "path": "/calendar/items/{item}",
+    "summary": "Delete a calendar item.",
     "description": "",
     "tags": [
-      "Tasks"
+      "Calendar"
     ],
     "security": [
       [
@@ -2533,10 +2533,10 @@
     ],
     "parameters": [
       {
-        "name": "task",
+        "name": "item",
         "in": "path",
         "required": true,
-        "description": "Task identifier.",
+        "description": "Calendar item identifier.",
         "example": 1
       }
     ],
@@ -2614,10 +2614,10 @@
     ]
   },
   {
-    "operationId": "deleteTaskComment",
+    "operationId": "deleteTask",
     "method": "delete",
-    "path": "/tasks/{task}/comments/{comment}",
-    "summary": "Delete one existing task comment.",
+    "path": "/tasks/{task}",
+    "summary": "Delete a task.",
     "description": "",
     "tags": [
       "Tasks"
@@ -2640,13 +2640,6 @@
         "required": true,
         "description": "Task identifier.",
         "example": 1
-      },
-      {
-        "name": "comment",
-        "in": "path",
-        "required": true,
-        "description": "Task comment identifier.",
-        "example": 1
       }
     ],
     "requestBodyRequired": false,
@@ -2723,13 +2716,13 @@
     ]
   },
   {
-    "operationId": "deleteWorkspaceCalendarItem",
+    "operationId": "deleteTaskComment",
     "method": "delete",
-    "path": "/calendar/items/{item}",
-    "summary": "Delete a calendar item.",
+    "path": "/tasks/{task}/comments/{comment}",
+    "summary": "Delete one existing task comment.",
     "description": "",
     "tags": [
-      "Calendar"
+      "Tasks"
     ],
     "security": [
       [
@@ -2744,10 +2737,17 @@
     ],
     "parameters": [
       {
-        "name": "item",
+        "name": "task",
         "in": "path",
         "required": true,
-        "description": "Calendar item identifier.",
+        "description": "Task identifier.",
+        "example": 1
+      },
+      {
+        "name": "comment",
+        "in": "path",
+        "required": true,
+        "description": "Task comment identifier.",
         "example": 1
       }
     ],
@@ -3618,13 +3618,13 @@
     ]
   },
   {
-    "operationId": "listHosts",
+    "operationId": "listCalendar",
     "method": "get",
-    "path": "/hosts",
-    "summary": "List hosts for the current workspace.",
-    "description": "Returns host records with connectivity state and machine metadata fields (meta) used for host diagnostics.",
+    "path": "/calendar",
+    "summary": "List calendar items.",
+    "description": "",
     "tags": [
-      "Hosts"
+      "Calendar"
     ],
     "security": [
       [
@@ -3639,25 +3639,67 @@
     ],
     "parameters": [
       {
-        "name": "per_page",
+        "name": "view",
         "in": "query",
         "required": false,
-        "description": "Page size for paginated responses.",
-        "example": 25
+        "description": "Allowed values: month, week, list.",
+        "example": "month"
+      },
+      {
+        "name": "start",
+        "in": "query",
+        "required": false,
+        "description": "Start.",
+        "example": "2026-02-22T17:21:00Z"
+      },
+      {
+        "name": "end",
+        "in": "query",
+        "required": false,
+        "description": "End.",
+        "example": "2026-02-22T17:21:00Z"
+      },
+      {
+        "name": "type",
+        "in": "query",
+        "required": false,
+        "description": "Type discriminator for this record. Allowed values: event, task.",
+        "example": "event"
       },
       {
         "name": "status",
         "in": "query",
         "required": false,
-        "description": "Current lifecycle status for this record. Allowed values: online, offline.",
-        "example": "online"
+        "description": "Current lifecycle status for this record. Allowed values: todo, in_progress, blocked, done, canceled.",
+        "example": "todo"
       },
       {
-        "name": "search",
+        "name": "priority",
+        "in": "query",
+        "required": false,
+        "description": "Priority level for this record. Allowed values: low, medium, high, urgent.",
+        "example": "low"
+      },
+      {
+        "name": "assignee",
+        "in": "query",
+        "required": false,
+        "description": "Assignee.",
+        "example": "example"
+      },
+      {
+        "name": "q",
         "in": "query",
         "required": false,
         "description": "Case-insensitive text search query.",
-        "example": "operations"
+        "example": "retro"
+      },
+      {
+        "name": "per_page",
+        "in": "query",
+        "required": false,
+        "description": "Page size for paginated responses.",
+        "example": 25
       }
     ],
     "requestBodyRequired": false,
@@ -3666,34 +3708,51 @@
       {
         "status": "200",
         "mediaType": "application/json",
-        "description": "Host list returned.",
+        "description": "Calendar items returned.",
         "hasContent": true,
         "example": {
           "data": [
             {
               "id": 42,
-              "team_id": 42,
-              "name": "Example Name",
-              "fingerprint": "a3f56f330f311a2159f8c101eaf1439a29f1d57f007375d56aa79f304bc4f112",
-              "status": "online",
-              "last_seen_at": "2026-02-22T17:21:00Z",
-              "meta": {
-                "hostname": "worker-01",
-                "ip": "10.0.2.15",
-                "os": "Ubuntu",
-                "arch": "x86_64",
-                "cpu": "Intel Xeon",
-                "ram_gb": 32,
-                "runtime": {
-                  "name": "openclaw",
-                  "version": "1.14.2"
+              "workspace_id": 42,
+              "type": "event",
+              "title": "Example Title",
+              "description": "Example description text.",
+              "start_at": "2026-02-22T17:21:00Z",
+              "end_at": "2026-02-22T17:21:00Z",
+              "due_at": "2026-02-22T17:21:00Z",
+              "all_day": false,
+              "location": "example",
+              "timezone": "America/Los_Angeles",
+              "status": "todo",
+              "priority": "low",
+              "visibility": "workspace",
+              "created_by": 1,
+              "updated_by": 1,
+              "assignees": [
+                {
+                  "id": 42,
+                  "assignee_type": "user",
+                  "assignee_id": 42,
+                  "role": "owner",
+                  "name": "Example Name",
+                  "created_at": "2026-02-22T17:21:00Z"
                 }
-              },
-              "created_by_user_id": 42,
-              "agents_total": 1,
-              "agents_online": 1,
+              ],
+              "links": [
+                {
+                  "id": 42,
+                  "link_type": "example",
+                  "link_id": 42,
+                  "url": "https://agentmc.example.com/docs/incident-123",
+                  "title": "Example Title",
+                  "created_at": "2026-02-22T17:21:00Z"
+                }
+              ],
+              "comments_count": 1,
               "created_at": "2026-02-22T17:21:00Z",
-              "updated_at": "2026-02-22T17:21:00Z"
+              "updated_at": "2026-02-22T17:21:00Z",
+              "deleted_at": "2026-02-22T17:21:00Z"
             }
           ],
           "links": {
@@ -3760,13 +3819,13 @@
     ]
   },
   {
-    "operationId": "listLogs",
+    "operationId": "listHosts",
     "method": "get",
-    "path": "/logs",
-    "summary": "List recent logs.",
-    "description": "",
+    "path": "/hosts",
+    "summary": "List hosts for the current workspace.",
+    "description": "Returns host records with connectivity state and machine metadata fields (meta) used for host diagnostics.",
     "tags": [
-      "Logs"
+      "Hosts"
     ],
     "security": [
       [
@@ -3786,6 +3845,20 @@
         "required": false,
         "description": "Page size for paginated responses.",
         "example": 25
+      },
+      {
+        "name": "status",
+        "in": "query",
+        "required": false,
+        "description": "Current lifecycle status for this record. Allowed values: online, offline.",
+        "example": "online"
+      },
+      {
+        "name": "search",
+        "in": "query",
+        "required": false,
+        "description": "Case-insensitive text search query.",
+        "example": "operations"
       }
     ],
     "requestBodyRequired": false,
@@ -3794,22 +3867,34 @@
       {
         "status": "200",
         "mediaType": "application/json",
-        "description": "Logs returned.",
+        "description": "Host list returned.",
         "hasContent": true,
         "example": {
           "data": [
             {
               "id": 42,
               "team_id": 42,
-              "actor_type": "example",
-              "actor_id": 42,
-              "action": "example",
-              "subject_type": "example",
-              "subject_id": 42,
+              "name": "Example Name",
+              "fingerprint": "a3f56f330f311a2159f8c101eaf1439a29f1d57f007375d56aa79f304bc4f112",
+              "status": "online",
+              "last_seen_at": "2026-02-22T17:21:00Z",
               "meta": {
-                "key": "value"
+                "hostname": "worker-01",
+                "ip": "10.0.2.15",
+                "os": "Ubuntu",
+                "arch": "x86_64",
+                "cpu": "Intel Xeon",
+                "ram_gb": 32,
+                "runtime": {
+                  "name": "openclaw",
+                  "version": "1.14.2"
+                }
               },
-              "created_at": "2026-02-22T17:21:00Z"
+              "created_by_user_id": 42,
+              "agents_total": 1,
+              "agents_online": 1,
+              "created_at": "2026-02-22T17:21:00Z",
+              "updated_at": "2026-02-22T17:21:00Z"
             }
           ],
           "links": {
@@ -3876,13 +3961,13 @@
     ]
   },
   {
-    "operationId": "listNotifications",
+    "operationId": "listLogs",
     "method": "get",
-    "path": "/notifications",
-    "summary": "List workspace notifications (mentions and assignments) for the authenticated principal.",
+    "path": "/logs",
+    "summary": "List recent logs.",
     "description": "",
     "tags": [
-      "Notifications"
+      "Logs"
     ],
     "security": [
       [
@@ -3896,13 +3981,6 @@
       ]
     ],
     "parameters": [
-      {
-        "name": "unread",
-        "in": "query",
-        "required": false,
-        "description": "Filter unread notifications only. Accepts true/false (and 1/0).",
-        "example": true
-      },
       {
         "name": "per_page",
         "in": "query",
@@ -3917,16 +3995,139 @@
       {
         "status": "200",
         "mediaType": "application/json",
-        "description": "Notifications returned.",
+        "description": "Logs returned.",
         "hasContent": true,
         "example": {
           "data": [
             {
-              "id": "c084fc57-b2c6-466c-adcb-cf6f4efca42a",
-              "notification_type": "mention",
-              "source_type": "App\\Notifications\\MentionedInCommentNotification",
-              "workspace_id": 7,
-              "subject_type": "task",
+              "id": 42,
+              "team_id": 42,
+              "actor_type": "example",
+              "actor_id": 42,
+              "action": "example",
+              "subject_type": "example",
+              "subject_id": 42,
+              "meta": {
+                "key": "value"
+              },
+              "created_at": "2026-02-22T17:21:00Z"
+            }
+          ],
+          "links": {
+            "first": "example",
+            "last": "example",
+            "prev": "example",
+            "next": "example"
+          },
+          "meta": {
+            "current_page": 1,
+            "from": 1,
+            "last_page": 1,
+            "links": [
+              {
+                "url": "https://agentmc.example.com/docs/incident-123",
+                "label": "example",
+                "active": true
+              }
+            ],
+            "path": "example",
+            "per_page": 25,
+            "total": 0
+          }
+        }
+      },
+      {
+        "status": "401",
+        "mediaType": "application/json",
+        "description": "Missing or invalid credentials.",
+        "hasContent": true,
+        "example": {
+          "error": {
+            "code": "validation.failed",
+            "message": "Validation failed.",
+            "details": {
+              "fields": {
+                "title": [
+                  "The title field is required."
+                ]
+              }
+            }
+          }
+        }
+      },
+      {
+        "status": "403",
+        "mediaType": "application/json",
+        "description": "Forbidden.",
+        "hasContent": true,
+        "example": {
+          "error": {
+            "code": "validation.failed",
+            "message": "Validation failed.",
+            "details": {
+              "fields": {
+                "title": [
+                  "The title field is required."
+                ]
+              }
+            }
+          }
+        }
+      }
+    ]
+  },
+  {
+    "operationId": "listNotifications",
+    "method": "get",
+    "path": "/notifications",
+    "summary": "List workspace notifications (mentions and assignments) for the authenticated principal.",
+    "description": "",
+    "tags": [
+      "Notifications"
+    ],
+    "security": [
+      [
+        "ApiKeyAuth"
+      ],
+      [
+        "AgentBearerAuth"
+      ],
+      [
+        "BearerAuth"
+      ]
+    ],
+    "parameters": [
+      {
+        "name": "unread",
+        "in": "query",
+        "required": false,
+        "description": "Filter unread notifications only. Accepts true/false (and 1/0).",
+        "example": true
+      },
+      {
+        "name": "per_page",
+        "in": "query",
+        "required": false,
+        "description": "Page size for paginated responses.",
+        "example": 25
+      }
+    ],
+    "requestBodyRequired": false,
+    "requestExamples": [],
+    "responses": [
+      {
+        "status": "200",
+        "mediaType": "application/json",
+        "description": "Notifications returned.",
+        "hasContent": true,
+        "example": {
+          "data": [
+            {
+              "id": "c084fc57-b2c6-466c-adcb-cf6f4efca42a",
+              "notification_type": "mention",
+              "source_type": "App\\Notifications\\MentionedInCommentNotification",
+              "workspace_id": 7,
+              "subject_type": "task",
               "subject_id": 121,
               "subject_label": "Prepare incident postmortem",
               "actor_type": "user",
@@ -4798,13 +4999,13 @@
     ]
   },
   {
-    "operationId": "showHost",
+    "operationId": "showCalendarItem",
     "method": "get",
-    "path": "/hosts/{id}",
-    "summary": "Show one host.",
-    "description": "Returns one host record including id/team/name/fingerprint, status + last_seen_at, metadata snapshot, and assigned-agent totals.",
+    "path": "/calendar/items/{item}",
+    "summary": "Show one calendar item.",
+    "description": "",
     "tags": [
-      "Hosts"
+      "Calendar"
     ],
     "security": [
       [
@@ -4819,18 +5020,11 @@
     ],
     "parameters": [
       {
-        "name": "id",
+        "name": "item",
         "in": "path",
         "required": true,
-        "description": "Host identifier.",
-        "example": 42
-      },
-      {
-        "name": "agents_per_page",
-        "in": "query",
-        "required": false,
-        "description": "Agents per page.",
-        "example": 25
+        "description": "Calendar item identifier.",
+        "example": 1
       }
     ],
     "requestBodyRequired": false,
@@ -4839,53 +5033,50 @@
       {
         "status": "200",
         "mediaType": "application/json",
-        "description": "Host returned.",
+        "description": "Calendar item returned.",
         "hasContent": true,
         "example": {
           "data": {
             "id": 42,
-            "team_id": 42,
-            "name": "Example Name",
-            "fingerprint": "a3f56f330f311a2159f8c101eaf1439a29f1d57f007375d56aa79f304bc4f112",
-            "status": "online",
-            "last_seen_at": "2026-02-22T17:21:00Z",
-            "meta": {
-              "hostname": "worker-01",
-              "ip": "10.0.2.15",
-              "os": "Ubuntu",
-              "arch": "x86_64",
-              "cpu": "Intel Xeon",
-              "ram_gb": 32,
-              "runtime": {
-                "name": "openclaw",
-                "version": "1.14.2"
+            "workspace_id": 42,
+            "type": "event",
+            "title": "Example Title",
+            "description": "Example description text.",
+            "start_at": "2026-02-22T17:21:00Z",
+            "end_at": "2026-02-22T17:21:00Z",
+            "due_at": "2026-02-22T17:21:00Z",
+            "all_day": false,
+            "location": "example",
+            "timezone": "America/Los_Angeles",
+            "status": "todo",
+            "priority": "low",
+            "visibility": "workspace",
+            "created_by": 1,
+            "updated_by": 1,
+            "assignees": [
+              {
+                "id": 42,
+                "assignee_type": "user",
+                "assignee_id": 42,
+                "role": "owner",
+                "name": "Example Name",
+                "created_at": "2026-02-22T17:21:00Z"
               }
-            },
-            "created_by_user_id": 42,
-            "agents_total": 1,
-            "agents_online": 1,
+            ],
+            "links": [
+              {
+                "id": 42,
+                "link_type": "example",
+                "link_id": 42,
+                "url": "https://agentmc.example.com/docs/incident-123",
+                "title": "Example Title",
+                "created_at": "2026-02-22T17:21:00Z"
+              }
+            ],
+            "comments_count": 1,
             "created_at": "2026-02-22T17:21:00Z",
-            "updated_at": "2026-02-22T17:21:00Z"
-          },
-          "agents": [
-            {
-              "id": 42,
-              "workspace_id": 42,
-              "host_id": 42,
-              "name": "Example Name",
-              "type": "example",
-              "status": "pending",
-              "tasks_count": 0,
-              "last_seen_at": "2026-02-22T17:21:00Z",
-              "created_at": "2026-02-22T17:21:00Z",
-              "updated_at": "2026-02-22T17:21:00Z"
-            }
-          ],
-          "agents_meta": {
-            "current_page": 1,
-            "last_page": 1,
-            "per_page": 25,
-            "total": 0
+            "updated_at": "2026-02-22T17:21:00Z",
+            "deleted_at": "2026-02-22T17:21:00Z"
           }
         }
       },
@@ -4949,13 +5140,13 @@
     ]
   },
   {
-    "operationId": "showTask",
+    "operationId": "showHost",
     "method": "get",
-    "path": "/tasks/{task}",
-    "summary": "Show one task.",
-    "description": "",
+    "path": "/hosts/{id}",
+    "summary": "Show one host.",
+    "description": "Returns one host record including id/team/name/fingerprint, status + last_seen_at, metadata snapshot, and assigned-agent totals.",
     "tags": [
-      "Tasks"
+      "Hosts"
     ],
     "security": [
       [
@@ -4970,11 +5161,18 @@
     ],
     "parameters": [
       {
-        "name": "task",
+        "name": "id",
         "in": "path",
         "required": true,
-        "description": "Task identifier.",
-        "example": 1
+        "description": "Host identifier.",
+        "example": 42
+      },
+      {
+        "name": "agents_per_page",
+        "in": "query",
+        "required": false,
+        "description": "Agents per page.",
+        "example": 25
       }
     ],
     "requestBodyRequired": false,
@@ -4983,25 +5181,53 @@
       {
         "status": "200",
         "mediaType": "application/json",
-        "description": "Task returned.",
+        "description": "Host returned.",
         "hasContent": true,
         "example": {
           "data": {
             "id": 42,
             "team_id": 42,
-            "board_id": 42,
-            "column_id": 42,
-            "title": "Example Title",
-            "description": "Example description text.",
-            "status": "backlog",
-            "position": 1,
-            "due_at": "2026-02-22T17:21:00Z",
+            "name": "Example Name",
+            "fingerprint": "a3f56f330f311a2159f8c101eaf1439a29f1d57f007375d56aa79f304bc4f112",
+            "status": "online",
+            "last_seen_at": "2026-02-22T17:21:00Z",
+            "meta": {
+              "hostname": "worker-01",
+              "ip": "10.0.2.15",
+              "os": "Ubuntu",
+              "arch": "x86_64",
+              "cpu": "Intel Xeon",
+              "ram_gb": 32,
+              "runtime": {
+                "name": "openclaw",
+                "version": "1.14.2"
+              }
+            },
             "created_by_user_id": 42,
-            "assigned_to_user_id": 42,
-            "assigned_to_agent_id": 42,
-            "assignee_type": "human",
+            "agents_total": 1,
+            "agents_online": 1,
             "created_at": "2026-02-22T17:21:00Z",
             "updated_at": "2026-02-22T17:21:00Z"
+          },
+          "agents": [
+            {
+              "id": 42,
+              "workspace_id": 42,
+              "host_id": 42,
+              "name": "Example Name",
+              "type": "example",
+              "status": "pending",
+              "tasks_count": 0,
+              "last_seen_at": "2026-02-22T17:21:00Z",
+              "created_at": "2026-02-22T17:21:00Z",
+              "updated_at": "2026-02-22T17:21:00Z"
+            }
+          ],
+          "agents_meta": {
+            "current_page": 1,
+            "last_page": 1,
+            "per_page": 25,
+            "total": 0
           }
         }
       },
@@ -5065,13 +5291,13 @@
     ]
   },
   {
-    "operationId": "showWorkspaceCalendarItem",
+    "operationId": "showTask",
     "method": "get",
-    "path": "/calendar/items/{item}",
-    "summary": "Show one calendar item.",
+    "path": "/tasks/{task}",
+    "summary": "Show one task.",
     "description": "",
     "tags": [
-      "Calendar"
+      "Tasks"
     ],
     "security": [
       [
@@ -5086,10 +5312,10 @@
     ],
     "parameters": [
       {
-        "name": "item",
+        "name": "task",
         "in": "path",
         "required": true,
-        "description": "Calendar item identifier.",
+        "description": "Task identifier.",
         "example": 1
       }
     ],
@@ -5099,50 +5325,25 @@
       {
         "status": "200",
         "mediaType": "application/json",
-        "description": "Calendar item returned.",
+        "description": "Task returned.",
         "hasContent": true,
         "example": {
           "data": {
             "id": 42,
-            "workspace_id": 42,
-            "type": "event",
+            "team_id": 42,
+            "board_id": 42,
+            "column_id": 42,
             "title": "Example Title",
             "description": "Example description text.",
-            "start_at": "2026-02-22T17:21:00Z",
-            "end_at": "2026-02-22T17:21:00Z",
+            "status": "backlog",
+            "position": 1,
             "due_at": "2026-02-22T17:21:00Z",
-            "all_day": false,
-            "location": "example",
-            "timezone": "America/Los_Angeles",
-            "status": "todo",
-            "priority": "low",
-            "visibility": "workspace",
-            "created_by": 1,
-            "updated_by": 1,
-            "assignees": [
-              {
-                "id": 42,
-                "assignee_type": "user",
-                "assignee_id": 42,
-                "role": "owner",
-                "name": "Example Name",
-                "created_at": "2026-02-22T17:21:00Z"
-              }
-            ],
-            "links": [
-              {
-                "id": 42,
-                "link_type": "example",
-                "link_id": 42,
-                "url": "https://agentmc.example.com/docs/incident-123",
-                "title": "Example Title",
-                "created_at": "2026-02-22T17:21:00Z"
-              }
-            ],
-            "comments_count": 1,
+            "created_by_user_id": 42,
+            "assigned_to_user_id": 42,
+            "assigned_to_agent_id": 42,
+            "assignee_type": "human",
             "created_at": "2026-02-22T17:21:00Z",
-            "updated_at": "2026-02-22T17:21:00Z",
-            "deleted_at": "2026-02-22T17:21:00Z"
+            "updated_at": "2026-02-22T17:21:00Z"
           }
         }
       },
@@ -5686,13 +5887,13 @@
     ]
   },
   {
-    "operationId": "updateTask",
-    "method": "patch",
-    "path": "/tasks/{task}",
-    "summary": "Update a task.",
+    "operationId": "updateCalendarItem",
+    "method": "put",
+    "path": "/calendar/items/{item}",
+    "summary": "Update a calendar item.",
     "description": "",
     "tags": [
-      "Tasks"
+      "Calendar"
     ],
     "security": [
       [
@@ -5707,10 +5908,10 @@
     ],
     "parameters": [
       {
-        "name": "task",
+        "name": "item",
         "in": "path",
         "required": true,
-        "description": "Task identifier.",
+        "description": "Calendar item identifier.",
         "example": 1
       }
     ],
@@ -5719,10 +5920,12 @@
       {
         "mediaType": "application/json",
         "example": {
-          "title": "Draft post-incident summary",
-          "status": "review",
-          "due_at": "2026-02-24T19:00:00Z",
-          "assigned_to_agent_id": 42
+          "title": "Review outage timeline",
+          "description": "Add links to root-cause analysis notes.",
+          "due_at": "2026-02-24T11:00:00Z",
+          "status": "in_progress",
+          "priority": "urgent",
+          "visibility": "workspace"
         }
       }
     ],
@@ -5730,25 +5933,50 @@
       {
         "status": "200",
         "mediaType": "application/json",
-        "description": "Task updated.",
+        "description": "Calendar item updated.",
         "hasContent": true,
         "example": {
           "data": {
             "id": 42,
-            "team_id": 42,
-            "board_id": 42,
-            "column_id": 42,
+            "workspace_id": 42,
+            "type": "event",
             "title": "Example Title",
             "description": "Example description text.",
-            "status": "backlog",
-            "position": 1,
+            "start_at": "2026-02-22T17:21:00Z",
+            "end_at": "2026-02-22T17:21:00Z",
             "due_at": "2026-02-22T17:21:00Z",
-            "created_by_user_id": 42,
-            "assigned_to_user_id": 42,
-            "assigned_to_agent_id": 42,
-            "assignee_type": "human",
+            "all_day": false,
+            "location": "example",
+            "timezone": "America/Los_Angeles",
+            "status": "todo",
+            "priority": "low",
+            "visibility": "workspace",
+            "created_by": 1,
+            "updated_by": 1,
+            "assignees": [
+              {
+                "id": 42,
+                "assignee_type": "user",
+                "assignee_id": 42,
+                "role": "owner",
+                "name": "Example Name",
+                "created_at": "2026-02-22T17:21:00Z"
+              }
+            ],
+            "links": [
+              {
+                "id": 42,
+                "link_type": "example",
+                "link_id": 42,
+                "url": "https://agentmc.example.com/docs/incident-123",
+                "title": "Example Title",
+                "created_at": "2026-02-22T17:21:00Z"
+              }
+            ],
+            "comments_count": 1,
             "created_at": "2026-02-22T17:21:00Z",
-            "updated_at": "2026-02-22T17:21:00Z"
+            "updated_at": "2026-02-22T17:21:00Z",
+            "deleted_at": "2026-02-22T17:21:00Z"
           }
         }
       },
@@ -5831,10 +6059,10 @@
     ]
   },
   {
-    "operationId": "updateTaskComment",
+    "operationId": "updateTask",
     "method": "patch",
-    "path": "/tasks/{task}/comments/{comment}",
-    "summary": "Update one existing task comment.",
+    "path": "/tasks/{task}",
+    "summary": "Update a task.",
     "description": "",
     "tags": [
       "Tasks"
@@ -5857,21 +6085,17 @@
         "required": true,
         "description": "Task identifier.",
         "example": 1
-      },
-      {
-        "name": "comment",
-        "in": "path",
-        "required": true,
-        "description": "Task comment identifier.",
-        "example": 1
       }
     ],
-    "requestBodyRequired": true,
+    "requestBodyRequired": false,
     "requestExamples": [
       {
         "mediaType": "application/json",
         "example": {
-          "body": "Updated handoff note with the latest timeline and log links."
+          "title": "Draft post-incident summary",
+          "status": "review",
+          "due_at": "2026-02-24T19:00:00Z",
+          "assigned_to_agent_id": 42
         }
       }
     ],
@@ -5879,28 +6103,25 @@
       {
         "status": "200",
         "mediaType": "application/json",
-        "description": "Task comment updated.",
+        "description": "Task updated.",
         "hasContent": true,
         "example": {
           "data": {
             "id": 42,
-            "task_id": 42,
-            "actor_type": "user",
-            "actor_id": 42,
-            "actor_name": "Example Name",
-            "body": "Example content.",
-            "mentions": [
-              {
-                "key": "example",
-                "type": "user",
-                "id": 42,
-                "label": "example",
-                "handle": "example",
-                "token": "example"
-              }
-            ],
-            "edited_at": "2026-02-22T17:21:00Z",
-            "created_at": "2026-02-22T17:21:00Z"
+            "team_id": 42,
+            "board_id": 42,
+            "column_id": 42,
+            "title": "Example Title",
+            "description": "Example description text.",
+            "status": "backlog",
+            "position": 1,
+            "due_at": "2026-02-22T17:21:00Z",
+            "created_by_user_id": 42,
+            "assigned_to_user_id": 42,
+            "assigned_to_agent_id": 42,
+            "assignee_type": "human",
+            "created_at": "2026-02-22T17:21:00Z",
+            "updated_at": "2026-02-22T17:21:00Z"
           }
         }
       },
@@ -5983,13 +6204,13 @@
     ]
   },
   {
-    "operationId": "updateWorkspaceCalendarItem",
-    "method": "put",
-    "path": "/calendar/items/{item}",
-    "summary": "Update a calendar item.",
+    "operationId": "updateTaskComment",
+    "method": "patch",
+    "path": "/tasks/{task}/comments/{comment}",
+    "summary": "Update one existing task comment.",
     "description": "",
     "tags": [
-      "Calendar"
+      "Tasks"
     ],
     "security": [
       [
@@ -6004,24 +6225,26 @@
     ],
     "parameters": [
       {
-        "name": "item",
+        "name": "task",
         "in": "path",
         "required": true,
-        "description": "Calendar item identifier.",
+        "description": "Task identifier.",
+        "example": 1
+      },
+      {
+        "name": "comment",
+        "in": "path",
+        "required": true,
+        "description": "Task comment identifier.",
         "example": 1
       }
     ],
-    "requestBodyRequired": false,
+    "requestBodyRequired": true,
     "requestExamples": [
       {
         "mediaType": "application/json",
         "example": {
-          "title": "Review outage timeline",
-          "description": "Add links to root-cause analysis notes.",
-          "due_at": "2026-02-24T11:00:00Z",
-          "status": "in_progress",
-          "priority": "urgent",
-          "visibility": "workspace"
+          "body": "Updated handoff note with the latest timeline and log links."
         }
       }
     ],
@@ -6029,50 +6252,28 @@
       {
         "status": "200",
         "mediaType": "application/json",
-        "description": "Calendar item updated.",
+        "description": "Task comment updated.",
         "hasContent": true,
         "example": {
           "data": {
             "id": 42,
-            "workspace_id": 42,
-            "type": "event",
-            "title": "Example Title",
-            "description": "Example description text.",
-            "start_at": "2026-02-22T17:21:00Z",
-            "end_at": "2026-02-22T17:21:00Z",
-            "due_at": "2026-02-22T17:21:00Z",
-            "all_day": false,
-            "location": "example",
-            "timezone": "America/Los_Angeles",
-            "status": "todo",
-            "priority": "low",
-            "visibility": "workspace",
-            "created_by": 1,
-            "updated_by": 1,
-            "assignees": [
-              {
-                "id": 42,
-                "assignee_type": "user",
-                "assignee_id": 42,
-                "role": "owner",
-                "name": "Example Name",
-                "created_at": "2026-02-22T17:21:00Z"
-              }
-            ],
-            "links": [
+            "task_id": 42,
+            "actor_type": "user",
+            "actor_id": 42,
+            "actor_name": "Example Name",
+            "body": "Example content.",
+            "mentions": [
               {
+                "key": "example",
+                "type": "user",
                 "id": 42,
-                "link_type": "example",
-                "link_id": 42,
-                "url": "https://agentmc.example.com/docs/incident-123",
-                "title": "Example Title",
-                "created_at": "2026-02-22T17:21:00Z"
+                "label": "example",
+                "handle": "example",
+                "token": "example"
               }
             ],
-            "comments_count": 1,
-            "created_at": "2026-02-22T17:21:00Z",
-            "updated_at": "2026-02-22T17:21:00Z",
-            "deleted_at": "2026-02-22T17:21:00Z"
+            "edited_at": "2026-02-22T17:21:00Z",
+            "created_at": "2026-02-22T17:21:00Z"
           }
         }
       },
@@ -6153,206 +6354,5 @@
         }
       }
     ]
-  },
-  {
-    "operationId": "workspaceCalendar",
-    "method": "get",
-    "path": "/calendar",
-    "summary": "List calendar items.",
-    "description": "",
-    "tags": [
-      "Calendar"
-    ],
-    "security": [
-      [
-        "ApiKeyAuth"
-      ],
-      [
-        "AgentBearerAuth"
-      ],
-      [
-        "BearerAuth"
-      ]
-    ],
-    "parameters": [
-      {
-        "name": "view",
-        "in": "query",
-        "required": false,
-        "description": "Allowed values: month, week, list.",
-        "example": "month"
-      },
-      {
-        "name": "start",
-        "in": "query",
-        "required": false,
-        "description": "Start.",
-        "example": "2026-02-22T17:21:00Z"
-      },
-      {
-        "name": "end",
-        "in": "query",
-        "required": false,
-        "description": "End.",
-        "example": "2026-02-22T17:21:00Z"
-      },
-      {
-        "name": "type",
-        "in": "query",
-        "required": false,
-        "description": "Type discriminator for this record. Allowed values: event, task.",
-        "example": "event"
-      },
-      {
-        "name": "status",
-        "in": "query",
-        "required": false,
-        "description": "Current lifecycle status for this record. Allowed values: todo, in_progress, blocked, done, canceled.",
-        "example": "todo"
-      },
-      {
-        "name": "priority",
-        "in": "query",
-        "required": false,
-        "description": "Priority level for this record. Allowed values: low, medium, high, urgent.",
-        "example": "low"
-      },
-      {
-        "name": "assignee",
-        "in": "query",
-        "required": false,
-        "description": "Assignee.",
-        "example": "example"
-      },
-      {
-        "name": "q",
-        "in": "query",
-        "required": false,
-        "description": "Case-insensitive text search query.",
-        "example": "retro"
-      },
-      {
-        "name": "per_page",
-        "in": "query",
-        "required": false,
-        "description": "Page size for paginated responses.",
-        "example": 25
-      }
-    ],
-    "requestBodyRequired": false,
-    "requestExamples": [],
-    "responses": [
-      {
-        "status": "200",
-        "mediaType": "application/json",
-        "description": "Calendar items returned.",
-        "hasContent": true,
-        "example": {
-          "data": [
-            {
-              "id": 42,
-              "workspace_id": 42,
-              "type": "event",
-              "title": "Example Title",
-              "description": "Example description text.",
-              "start_at": "2026-02-22T17:21:00Z",
-              "end_at": "2026-02-22T17:21:00Z",
-              "due_at": "2026-02-22T17:21:00Z",
-              "all_day": false,
-              "location": "example",
-              "timezone": "America/Los_Angeles",
-              "status": "todo",
-              "priority": "low",
-              "visibility": "workspace",
-              "created_by": 1,
-              "updated_by": 1,
-              "assignees": [
-                {
-                  "id": 42,
-                  "assignee_type": "user",
-                  "assignee_id": 42,
-                  "role": "owner",
-                  "name": "Example Name",
-                  "created_at": "2026-02-22T17:21:00Z"
-                }
-              ],
-              "links": [
-                {
-                  "id": 42,
-                  "link_type": "example",
-                  "link_id": 42,
-                  "url": "https://agentmc.example.com/docs/incident-123",
-                  "title": "Example Title",
-                  "created_at": "2026-02-22T17:21:00Z"
-                }
-              ],
-              "comments_count": 1,
-              "created_at": "2026-02-22T17:21:00Z",
-              "updated_at": "2026-02-22T17:21:00Z",
-              "deleted_at": "2026-02-22T17:21:00Z"
-            }
-          ],
-          "links": {
-            "first": "example",
-            "last": "example",
-            "prev": "example",
-            "next": "example"
-          },
-          "meta": {
-            "current_page": 1,
-            "from": 1,
-            "last_page": 1,
-            "links": [
-              {
-                "url": "https://agentmc.example.com/docs/incident-123",
-                "label": "example",
-                "active": true
-              }
-            ],
-            "path": "example",
-            "per_page": 25,
-            "total": 0
-          }
-        }
-      },
-      {
-        "status": "401",
-        "mediaType": "application/json",
-        "description": "Missing or invalid credentials.",
-        "hasContent": true,
-        "example": {
-          "error": {
-            "code": "validation.failed",
-            "message": "Validation failed.",
-            "details": {
-              "fields": {
-                "title": [
-                  "The title field is required."
-                ]
-              }
-            }
-          }
-        }
-      },
-      {
-        "status": "403",
-        "mediaType": "application/json",
-        "description": "Forbidden.",
-        "hasContent": true,
-        "example": {
-          "error": {
-            "code": "validation.failed",
-            "message": "Validation failed.",
-            "details": {
-              "fields": {
-                "title": [
-                  "The title field is required."
-                ]
-              }
-            }
-          }
-        }
-      }
-    ]
   }
 ]