@agentmc/api 0.1.1 → 0.2.2

package/dist/index.d.ts

@@ -415,7 +415,7 @@ interface paths {
             path?: never;
             cookie?: never;
         };
-        /** List workspace notifications (mentions and assignments) for the authenticated principal. */
+        /** List workspace notifications (mentions, assignments, and comment activity) for the authenticated principal. */
         get: operations["listNotifications"];
         put?: never;
         post?: never;
@@ -467,7 +467,7 @@ interface paths {
             cookie?: never;
         };
         /** List calendar items. */
-        get: operations["workspaceCalendar"];
+        get: operations["listCalendar"];
         put?: never;
         post?: never;
         delete?: never;
@@ -486,7 +486,7 @@ interface paths {
         get?: never;
         put?: never;
         /** Create a calendar item. */
-        post: operations["createWorkspaceCalendarItem"];
+        post: operations["createCalendarItem"];
         delete?: never;
         options?: never;
         head?: never;
@@ -501,12 +501,12 @@ interface paths {
             cookie?: never;
         };
         /** Show one calendar item. */
-        get: operations["showWorkspaceCalendarItem"];
+        get: operations["showCalendarItem"];
         /** Update a calendar item. */
-        put: operations["updateWorkspaceCalendarItem"];
+        put: operations["updateCalendarItem"];
         post?: never;
         /** Delete a calendar item. */
-        delete: operations["deleteWorkspaceCalendarItem"];
+        delete: operations["deleteCalendarItem"];
         options?: never;
         head?: never;
         patch?: never;
@@ -522,7 +522,7 @@ interface paths {
         get?: never;
         put?: never;
         /** Add a comment on a calendar item. */
-        post: operations["commentWorkspaceCalendarItem"];
+        post: operations["commentCalendarItem"];
         delete?: never;
         options?: never;
         head?: never;
@@ -3145,7 +3145,7 @@ interface components {
             created_at: string | null;
         };
         /**
-         * @description Workspace notification record (mention or assignment) for the authenticated principal.
+         * @description Workspace notification record (mention, assignment, or comment activity) for the authenticated principal.
          * @example {
          *       "id": "c084fc57-b2c6-466c-adcb-cf6f4efca42a",
          *       "notification_type": "mention",
@@ -3186,11 +3186,11 @@ interface components {
              */
             id: string;
             /**
-             * @description Normalized notification type for API consumers. Allowed values: mention, assignment.
+             * @description Normalized notification type for API consumers. Allowed values: mention, assignment, comment.
              * @example mention
              * @enum {string}
              */
-            notification_type: "mention" | "assignment";
+            notification_type: "mention" | "assignment" | "comment";
             /**
              * @description Underlying Laravel notification class name.
              * @example example
@@ -3380,50 +3380,6 @@ interface components {
              */
             created_at: string | null;
         };
-        /**
-         * @description Calendar Item Link schema.
-         * @example {
-         *       "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"
-         *     }
-         */
-        CalendarItemLink: {
-            /**
-             * @description Unique identifier for this record.
-             * @example 42
-             */
-            id: number;
-            /**
-             * @description Link type.
-             * @example example
-             */
-            link_type: string;
-            /**
-             * @description Identifier for link.
-             * @example 42
-             */
-            link_id: number;
-            /**
-             * @description URL value for url.
-             * @example https://agentmc.example.com/docs/incident-123
-             */
-            url: string | null;
-            /**
-             * @description Human-readable title.
-             * @example Example Title
-             */
-            title: string | null;
-            /**
-             * Format: date-time
-             * @description ISO-8601 timestamp when this record was created.
-             * @example 2026-02-22T17:21:00Z
-             */
-            created_at: string | null;
-        };
         /**
          * @description Calendar Item Comment schema.
          * @example {
@@ -3492,16 +3448,6 @@ interface components {
          *           "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",
@@ -3610,20 +3556,6 @@ interface components {
              *     ]
              */
             assignees: components["schemas"]["CalendarItemAssignee"][];
-            /**
-             * @description Links.
-             * @example [
-             *       {
-             *         "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"
-             *       }
-             *     ]
-             */
-            links: components["schemas"]["CalendarItemLink"][];
             /**
              * @description Comments count.
              * @example 1
@@ -4281,16 +4213,6 @@ interface components {
          *             "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",
@@ -4328,16 +4250,6 @@ interface components {
              *           "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",
@@ -4918,16 +4830,6 @@ interface components {
          *               "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",
@@ -4988,16 +4890,6 @@ interface components {
              *             "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",
@@ -5334,7 +5226,7 @@ interface components {
         /**
          * @description One-time agent registration payload. Resolve this schema from OpenAPI at runtime instead of hardcoding fields.
          * @example {
-         *       "name": "codex-runtime-prod",
+         *       "name": "openclaw-main",
          *       "host": "ip-10-0-3-42",
          *       "runtime_version": "2026.02.1",
          *       "capabilities": [
@@ -5342,6 +5234,22 @@ interface components {
          *         "calendar",
          *         "realtime"
          *       ],
+         *       "models": [
+         *         {
+         *           "model_id": "openai/gpt-5-codex",
+         *           "provider": "openai"
+         *         },
+         *         {
+         *           "model_id": "anthropic/claude-sonnet-4-20250514",
+         *           "provider": "anthropic"
+         *         }
+         *       ],
+         *       "identity": {
+         *         "name": "Jarvis",
+         *         "creature": "robot",
+         *         "vibe": "calm",
+         *         "emoji": "🤖"
+         *       },
          *       "metadata": {
          *         "hostname": "worker-01",
          *         "ip": "10.0.2.15",
@@ -5363,14 +5271,19 @@ interface components {
          *         "runtime": {
          *           "name": "codex",
          *           "version": "2026.02.1"
+         *         },
+         *         "identity": {
+         *           "name": "Jarvis",
+         *           "creature": "robot",
+         *           "vibe": "calm"
          *         }
          *       }
          *     }
          */
         RegisterAgentApiRequest: {
             /**
-             * @description Stable human-readable runtime name for this registration.
-             * @example codex-runtime-prod
+             * @description Runtime/client label fallback. AgentMC prefers identity name values from `identity.name` or `metadata.identity.name` when provided.
+             * @example openclaw-main
              */
             name: string;
             /**
@@ -5392,6 +5305,48 @@ interface components {
              *     ]
              */
             capabilities: string[] | null;
+            /**
+             * @description Optional runtime LLM inventory. Send an array of model refs/objects or a structured runtime snapshot object.
+             * @example [
+             *       {
+             *         "model_id": "openai/gpt-5-codex",
+             *         "provider": "openai"
+             *       },
+             *       {
+             *         "model_id": "anthropic/claude-sonnet-4-20250514",
+             *         "provider": "anthropic"
+             *       }
+             *     ]
+             */
+            models?: ((string | {
+                /**
+                 * @description Full model ID in provider/model format.
+                 * @example openai/gpt-5-codex
+                 */
+                model_id: string;
+                /**
+                 * @description Model provider slug.
+                 * @example openai
+                 */
+                provider?: string;
+                /**
+                 * @description Optional display name.
+                 * @example GPT-5 Codex
+                 */
+                name?: string;
+            })[] | {
+                [key: string]: unknown;
+            }) | null;
+            /**
+             * @description Optional full agent identity payload. AgentMC uses `identity.name` as the registered agent name when provided.
+             * @example {
+             *       "name": "Jarvis",
+             *       "creature": "robot",
+             *       "vibe": "calm",
+             *       "emoji": "🤖"
+             *     }
+             */
+            identity?: unknown;
             /**
              * @description Required host telemetry snapshot for registration. Mirrors heartbeat host metadata and is saved as host metadata.
              * @example {
@@ -5415,6 +5370,11 @@ interface components {
              *       "runtime": {
              *         "name": "codex",
              *         "version": "2026.02.1"
+             *       },
+             *       "identity": {
+             *         "name": "Jarvis",
+             *         "creature": "robot",
+             *         "vibe": "calm"
              *       }
              *     }
              */
@@ -5526,6 +5486,21 @@ interface components {
                      */
                     version: string;
                 };
+                /**
+                 * @description Optional identity payload. When `identity.name` is present, AgentMC uses it as the registered agent name.
+                 * @example {
+                 *       "name": "Jarvis"
+                 *     }
+                 */
+                identity?: ({
+                    /**
+                     * @description Human-readable name.
+                     * @example Jarvis
+                     */
+                    name?: string;
+                } & {
+                    [key: string]: unknown;
+                }) | string;
             } & {
                 [key: string]: unknown;
             };
@@ -5566,12 +5541,28 @@ interface components {
          *         "id": 42,
          *         "name": "codex-runtime-prod",
          *         "type": "generic",
-         *         "models": [
-         *           {
-         *             "model_id": "openai/gpt-5-codex",
-         *             "provider": "openai"
+         *         "identity": {
+         *           "name": "Jarvis",
+         *           "creature": "robot",
+         *           "vibe": "calm"
+         *         },
+         *         "models": {
+         *           "resolved": {
+         *             "default": "openai/gpt-5-codex",
+         *             "fallbacks": [
+         *               "anthropic/claude-sonnet-4-20250514"
+         *             ]
+         *           },
+         *           "providers": {
+         *             "openai": [
+         *               "gpt-5-codex",
+         *               "gpt-4.1"
+         *             ],
+         *             "anthropic": [
+         *               "claude-sonnet-4-20250514"
+         *             ]
          *           }
-         *         ]
+         *         }
          *       }
          *     }
          */
@@ -5782,23 +5773,54 @@ interface components {
                  */
                 endpoint_url?: string | null;
                 /**
-                 * @description Runtime LLM model inventory. Report full model IDs (provider/model), for example `openai/gpt-5-codex`. Do not send runtime names like `openclaw` or provider-only labels.
-                 * @example [
-                 *       {
-                 *         "model_id": "openai/gpt-5-codex",
-                 *         "provider": "openai"
+                 * @description Runtime LLM inventory. Send an array of model refs/objects or a structured runtime snapshot object. Prefer full provider/model IDs and avoid provider-only labels.
+                 * @example {
+                 *       "resolved": {
+                 *         "default": "openai/gpt-5-codex",
+                 *         "fallbacks": [
+                 *           "anthropic/claude-sonnet-4-20250514"
+                 *         ]
                  *       },
-                 *       {
-                 *         "model_id": "anthropic/claude-sonnet-4-20250514",
-                 *         "provider": "anthropic"
+                 *       "providers": {
+                 *         "openai": [
+                 *           "gpt-5-codex",
+                 *           "gpt-4.1"
+                 *         ],
+                 *         "anthropic": [
+                 *           "claude-sonnet-4-20250514"
+                 *         ]
                  *       }
-                 *     ]
+                 *     }
                  */
-                models?: ({
-                    [key: string]: unknown;
-                } | {
+                models?: ((string | {
+                    /**
+                     * @description Full model ID in provider/model format.
+                     * @example openai/gpt-5-codex
+                     */
+                    model_id: string;
+                    /**
+                     * @description Model provider slug.
+                     * @example openai
+                     */
+                    provider?: string;
+                    /**
+                     * @description Optional display name for UI; do not use this as canonical model identifier.
+                     * @example GPT-5 Codex
+                     */
+                    name?: string;
+                })[] | {
                     [key: string]: unknown;
-                }[]) | null;
+                }) | null;
+                /**
+                 * @description Optional full agent identity payload. AgentMC stores this under `agent.meta.identity`.
+                 * @example {
+                 *       "name": "Jarvis",
+                 *       "creature": "robot",
+                 *       "vibe": "calm",
+                 *       "emoji": "🤖"
+                 *     }
+                 */
+                identity?: unknown;
             } & ({
                 [key: string]: unknown;
             } | {
@@ -7297,7 +7319,7 @@ interface components {
             content: {
                 /**
                  * @example {
-                 *       "name": "codex-runtime-prod",
+                 *       "name": "openclaw-main",
                  *       "host": "ip-10-0-3-42",
                  *       "runtime_version": "2026.02.1",
                  *       "capabilities": [
@@ -7305,6 +7327,21 @@ interface components {
                  *         "calendar",
                  *         "realtime"
                  *       ],
+                 *       "models": [
+                 *         {
+                 *           "model_id": "openai/gpt-5-codex",
+                 *           "provider": "openai"
+                 *         },
+                 *         {
+                 *           "model_id": "anthropic/claude-sonnet-4-20250514",
+                 *           "provider": "anthropic"
+                 *         }
+                 *       ],
+                 *       "identity": {
+                 *         "name": "Jarvis",
+                 *         "creature": "robot",
+                 *         "vibe": "calm"
+                 *       },
                  *       "metadata": {
                  *         "hostname": "worker-01",
                  *         "ip": "10.0.2.15",
@@ -7326,6 +7363,9 @@ interface components {
                  *         "runtime": {
                  *           "name": "codex",
                  *           "version": "2026.02.1"
+                 *         },
+                 *         "identity": {
+                 *           "name": "Jarvis"
                  *         }
                  *       }
                  *     }
@@ -7372,16 +7412,28 @@ interface components {
                  *       "agent": {
                  *         "id": 42,
                  *         "name": "codex-runtime-prod",
-                 *         "models": [
-                 *           {
-                 *             "model_id": "openai/gpt-5-codex",
-                 *             "provider": "openai"
+                 *         "identity": {
+                 *           "name": "Jarvis",
+                 *           "creature": "robot",
+                 *           "vibe": "calm"
+                 *         },
+                 *         "models": {
+                 *           "resolved": {
+                 *             "default": "openai/gpt-5-codex",
+                 *             "fallbacks": [
+                 *               "anthropic/claude-sonnet-4-20250514"
+                 *             ]
                  *           },
-                 *           {
-                 *             "model_id": "anthropic/claude-sonnet-4-20250514",
-                 *             "provider": "anthropic"
+                 *           "providers": {
+                 *             "openai": [
+                 *               "gpt-5-codex",
+                 *               "gpt-4.1"
+                 *             ],
+                 *             "anthropic": [
+                 *               "claude-sonnet-4-20250514"
+                 *             ]
                  *           }
-                 *         ]
+                 *         }
                  *       }
                  *     }
                  */
@@ -7771,16 +7823,28 @@ interface operations {
                  *       "agent": {
                  *         "id": 42,
                  *         "name": "codex-runtime-prod",
-                 *         "models": [
-                 *           {
-                 *             "model_id": "openai/gpt-5-codex",
-                 *             "provider": "openai"
+                 *         "identity": {
+                 *           "name": "Jarvis",
+                 *           "creature": "robot",
+                 *           "vibe": "calm"
+                 *         },
+                 *         "models": {
+                 *           "resolved": {
+                 *             "default": "openai/gpt-5-codex",
+                 *             "fallbacks": [
+                 *               "anthropic/claude-sonnet-4-20250514"
+                 *             ]
                  *           },
-                 *           {
-                 *             "model_id": "anthropic/claude-sonnet-4-20250514",
-                 *             "provider": "anthropic"
+                 *           "providers": {
+                 *             "openai": [
+                 *               "gpt-5-codex",
+                 *               "gpt-4.1"
+                 *             ],
+                 *             "anthropic": [
+                 *               "claude-sonnet-4-20250514"
+                 *             ]
                  *           }
-                 *         ]
+                 *         }
                  *       }
                  *     }
                  */
@@ -10082,7 +10146,7 @@ interface operations {
             403: components["responses"]["ApiError403"];
         };
     };
-    workspaceCalendar: {
+    listCalendar: {
         parameters: {
             query?: {
                 /**
@@ -10173,16 +10237,6 @@ interface operations {
                      *               "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",
@@ -10219,7 +10273,7 @@ interface operations {
             403: components["responses"]["ApiError403"];
         };
     };
-    createWorkspaceCalendarItem: {
+    createCalendarItem: {
         parameters: {
             query?: never;
             header?: never;
@@ -10263,16 +10317,6 @@ interface operations {
                      *             "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",
@@ -10290,7 +10334,7 @@ interface operations {
             422: components["responses"]["ApiError422"];
         };
     };
-    showWorkspaceCalendarItem: {
+    showCalendarItem: {
         parameters: {
             query?: never;
             header?: never;
@@ -10340,16 +10384,6 @@ interface operations {
                      *             "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",
@@ -10365,7 +10399,7 @@ interface operations {
             404: components["responses"]["ApiError404"];
         };
     };
-    updateWorkspaceCalendarItem: {
+    updateCalendarItem: {
         parameters: {
             query?: never;
             header?: never;
@@ -10429,16 +10463,6 @@ interface operations {
                      *             "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",
@@ -10455,7 +10479,7 @@ interface operations {
             422: components["responses"]["ApiError422"];
         };
     };
-    deleteWorkspaceCalendarItem: {
+    deleteCalendarItem: {
         parameters: {
             query?: never;
             header?: never;
@@ -10491,7 +10515,7 @@ interface operations {
             404: components["responses"]["ApiError404"];
         };
     };
-    commentWorkspaceCalendarItem: {
+    commentCalendarItem: {
         parameters: {
             query?: never;
             header?: never;