@agentmc/api 0.2.1 → 0.2.3

package/spec/openapi.filtered.json

@@ -30,8 +30,8 @@
                 "example": {
                   "agent_id": 42,
                   "agent_token": "mca_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
-                  "agent_instructions_endpoint": "https://agentmc.example.com/api/v1/agents/42/instructions",
-                  "agent_authenticated_instructions_endpoint": "https://agentmc.example.com/api/v1/agents/42/instructions",
+                  "agent_instructions_endpoint": "https://agentmc.example.com/api/v1/agents/42/agent-instructions",
+                  "agent_authenticated_instructions_endpoint": "https://agentmc.example.com/api/v1/agents/42/agent-instructions",
                   "agent_instructions_version": "32fe7fd14fca2d57c545f5f78f4a1c094f9ac1b3a1e8f6f9f8323b67a0ef9cc3",
                   "openapi_url": "https://agentmc.example.com/api/openapi.json",
                   "workspace": {
@@ -65,13 +65,13 @@
         }
       }
     },
-    "/agents/{agent}/instructions": {
+    "/agents/{agent}/agent-instructions": {
       "get": {
         "tags": [
           "Agents"
         ],
-        "summary": "Return runtime instructions for a connected agent using bearer auth.",
-        "operationId": "agentConnectedInstructions",
+        "summary": "Return agent instructions for a connected agent using bearer auth.",
+        "operationId": "agentInstructions",
         "parameters": [
           {
             "name": "agent",
@@ -87,14 +87,15 @@
         ],
         "responses": {
           "200": {
-            "description": "Instructions returned.",
+            "description": "Agent instructions returned.",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/ConnectedAgentInstructionsResponse"
+                  "$ref": "#/components/schemas/AgentInstructionsResponse"
                 },
                 "example": {
-                  "instructions": "# AgentMC Agent Sync Skill",
+                  "agent_instructions": "# Agent Instructions",
+                  "agent_instructions_version": "32fe7fd14fca2d57c545f5f78f4a1c094f9ac1b3a1e8f6f9f8323b67a0ef9cc3",
                   "docs": [],
                   "schedules": [],
                   "config": {}
@@ -244,16 +245,28 @@
                 "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"
+                      ]
                     }
-                  ]
+                  }
                 }
               }
             }
@@ -3304,7 +3317,7 @@
         "tags": [
           "Notifications"
         ],
-        "summary": "List workspace notifications (mentions and assignments) for the authenticated principal.",
+        "summary": "List workspace notifications (mentions, assignments, and comment activity) for the authenticated principal.",
         "operationId": "listNotifications",
         "responses": {
           "200": {
@@ -3619,16 +3632,6 @@
                           "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",
@@ -3852,16 +3855,6 @@
                         "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",
@@ -3959,16 +3952,6 @@
                         "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",
@@ -4055,16 +4038,6 @@
                         "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",
@@ -5200,13 +5173,13 @@
           "agent_instructions_endpoint": {
             "type": "string",
             "format": "uri",
-            "description": "Endpoint for agent runtime instructions.",
+            "description": "Endpoint for agent instructions updates.",
             "example": "https://agentmc.example.com/resource"
           },
           "agent_authenticated_instructions_endpoint": {
             "type": "string",
             "format": "uri",
-            "description": "Authenticated endpoint for agent runtime instructions.",
+            "description": "Authenticated endpoint for agent instructions updates.",
             "example": "https://agentmc.example.com/resource"
           },
           "agent_instructions_version": {
@@ -5245,12 +5218,12 @@
             "example": true
           }
         },
-        "description": "Connect/registration response with agent credentials, authenticated instructions endpoint, and OpenAPI URL.",
+        "description": "Connect/registration response with agent credentials, authenticated agent instructions endpoint, and OpenAPI URL.",
         "example": {
           "agent_id": 42,
           "agent_token": "mca_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
-          "agent_instructions_endpoint": "https://agentmc.example.com/api/v1/agents/42/instructions",
-          "agent_authenticated_instructions_endpoint": "https://agentmc.example.com/api/v1/agents/42/instructions",
+          "agent_instructions_endpoint": "https://agentmc.example.com/api/v1/agents/42/agent-instructions",
+          "agent_authenticated_instructions_endpoint": "https://agentmc.example.com/api/v1/agents/42/agent-instructions",
           "agent_instructions_version": "32fe7fd14fca2d57c545f5f78f4a1c094f9ac1b3a1e8f6f9f8323b67a0ef9cc3",
           "openapi_url": "https://agentmc.example.com/api/openapi.json",
           "workspace": {
@@ -5262,18 +5235,24 @@
           "first_sync_required": true
         }
       },
-      "ConnectedAgentInstructionsResponse": {
+      "AgentInstructionsResponse": {
         "type": "object",
         "required": [
-          "instructions",
+          "agent_instructions",
+          "agent_instructions_version",
           "docs",
           "schedules",
           "config"
         ],
         "properties": {
-          "instructions": {
+          "agent_instructions": {
             "type": "string",
-            "description": "Instructions.",
+            "description": "Agent instructions.",
+            "example": "example"
+          },
+          "agent_instructions_version": {
+            "type": "string",
+            "description": "Agent instructions version.",
             "example": "example"
           },
           "docs": {
@@ -5311,9 +5290,10 @@
             }
           }
         },
-        "description": "Connected agent instruction payload returned after successful bearer authentication.",
+        "description": "Connected agent instructions payload returned after successful bearer authentication.",
         "example": {
-          "instructions": "# AgentMC Agent Sync Skill",
+          "agent_instructions": "# Agent Instructions",
+          "agent_instructions_version": "32fe7fd14fca2d57c545f5f78f4a1c094f9ac1b3a1e8f6f9f8323b67a0ef9cc3",
           "docs": [],
           "schedules": [],
           "config": {}
@@ -7508,9 +7488,10 @@
             "type": "string",
             "enum": [
               "mention",
-              "assignment"
+              "assignment",
+              "comment"
             ],
-            "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"
           },
           "source_type": {
@@ -7692,7 +7673,7 @@
             "example": "2026-02-22T17:21:00Z"
           }
         },
-        "description": "Workspace notification record (mention or assignment) for the authenticated principal."
+        "description": "Workspace notification record (mention, assignment, or comment activity) for the authenticated principal."
       },
       "CalendarItemAssignee": {
         "type": "object",
@@ -7759,62 +7740,6 @@
           "created_at": "2026-02-22T17:21:00Z"
         }
       },
-      "CalendarItemLink": {
-        "type": "object",
-        "required": [
-          "id",
-          "link_type",
-          "link_id",
-          "url",
-          "title",
-          "created_at"
-        ],
-        "properties": {
-          "id": {
-            "type": "integer",
-            "description": "Unique identifier for this record.",
-            "example": 42
-          },
-          "link_type": {
-            "type": "string",
-            "description": "Link type.",
-            "example": "example"
-          },
-          "link_id": {
-            "type": "integer",
-            "description": "Identifier for link.",
-            "example": 42
-          },
-          "url": {
-            "type": "string",
-            "nullable": true,
-            "description": "URL value for url.",
-            "example": "https://agentmc.example.com/docs/incident-123"
-          },
-          "title": {
-            "type": "string",
-            "nullable": true,
-            "description": "Human-readable title.",
-            "example": "Example Title"
-          },
-          "created_at": {
-            "type": "string",
-            "format": "date-time",
-            "nullable": true,
-            "description": "ISO-8601 timestamp when this record was created.",
-            "example": "2026-02-22T17:21:00Z"
-          }
-        },
-        "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"
-        }
-      },
       "CalendarItemComment": {
         "type": "object",
         "required": [
@@ -7888,7 +7813,6 @@
           "created_by",
           "updated_by",
           "assignees",
-          "links",
           "comments_count",
           "created_at",
           "updated_at",
@@ -8026,23 +7950,6 @@
               }
             ]
           },
-          "links": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/CalendarItemLink"
-            },
-            "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"
-              }
-            ]
-          },
           "comments_count": {
             "type": "integer",
             "nullable": true,
@@ -8099,16 +8006,6 @@
               "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",
@@ -8822,16 +8719,6 @@
                   "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",
@@ -8868,16 +8755,6 @@
                 "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",
@@ -9516,16 +9393,6 @@
                     "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",
@@ -9593,16 +9460,6 @@
                   "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",
@@ -9975,8 +9832,8 @@
           "name": {
             "type": "string",
             "maxLength": 255,
-            "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"
           },
           "host": {
             "type": "string",
@@ -10004,6 +9861,72 @@
               "realtime"
             ]
           },
+          "models": {
+            "nullable": true,
+            "oneOf": [
+              {
+                "type": "array",
+                "items": {
+                  "oneOf": [
+                    {
+                      "type": "string",
+                      "description": "Full model ID in provider/model format.",
+                      "example": "openai/gpt-5-codex"
+                    },
+                    {
+                      "type": "object",
+                      "required": [
+                        "model_id"
+                      ],
+                      "properties": {
+                        "model_id": {
+                          "type": "string",
+                          "description": "Full model ID in provider/model format.",
+                          "example": "openai/gpt-5-codex"
+                        },
+                        "provider": {
+                          "type": "string",
+                          "description": "Model provider slug.",
+                          "example": "openai"
+                        },
+                        "name": {
+                          "type": "string",
+                          "description": "Optional display name.",
+                          "example": "GPT-5 Codex"
+                        }
+                      }
+                    }
+                  ]
+                }
+              },
+              {
+                "type": "object",
+                "additionalProperties": true,
+                "description": "Structured model snapshot (for example status/list output). AgentMC extracts model IDs recursively."
+              }
+            ],
+            "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"
+              }
+            ]
+          },
+          "identity": {
+            "nullable": true,
+            "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": "🤖"
+            }
+          },
           "metadata": {
             "type": "object",
             "additionalProperties": true,
@@ -10161,6 +10084,31 @@
                   "name": "Example Name",
                   "version": "example"
                 }
+              },
+              "identity": {
+                "description": "Optional identity payload. When `identity.name` is present, AgentMC uses it as the registered agent name.",
+                "oneOf": [
+                  {
+                    "type": "object",
+                    "additionalProperties": true,
+                    "properties": {
+                      "name": {
+                        "type": "string",
+                        "maxLength": 255,
+                        "example": "Jarvis",
+                        "description": "Human-readable name."
+                      }
+                    }
+                  },
+                  {
+                    "type": "string",
+                    "description": "Raw IDENTITY.md content. AgentMC will parse a `Name:` line when present.",
+                    "example": "Name: Jarvis"
+                  }
+                ],
+                "example": {
+                  "name": "Jarvis"
+                }
               }
             },
             "description": "Required host telemetry snapshot for registration. Mirrors heartbeat host metadata and is saved as host metadata.",
@@ -10185,6 +10133,11 @@
               "runtime": {
                 "name": "codex",
                 "version": "2026.02.1"
+              },
+              "identity": {
+                "name": "Jarvis",
+                "creature": "robot",
+                "vibe": "calm"
               }
             }
           }
@@ -10198,7 +10151,7 @@
         ],
         "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": [
@@ -10206,6 +10159,22 @@
             "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",
@@ -10227,6 +10196,11 @@
             "runtime": {
               "name": "codex",
               "version": "2026.02.1"
+            },
+            "identity": {
+              "name": "Jarvis",
+              "creature": "robot",
+              "vibe": "calm"
             }
           }
         }
@@ -10546,61 +10520,75 @@
               "models": {
                 "nullable": true,
                 "oneOf": [
-                  {
-                    "type": "object",
-                    "additionalProperties": true
-                  },
                   {
                     "type": "array",
                     "items": {
-                      "type": "object",
-                      "additionalProperties": true
-                    }
-                  }
-                ],
-                "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.",
-                "items": {
-                  "oneOf": [
-                    {
-                      "type": "string",
-                      "description": "Full model ID in provider/model format.",
-                      "example": "openai/gpt-5-codex"
-                    },
-                    {
-                      "type": "object",
-                      "required": [
-                        "model_id"
-                      ],
-                      "properties": {
-                        "model_id": {
+                      "oneOf": [
+                        {
                           "type": "string",
                           "description": "Full model ID in provider/model format.",
                           "example": "openai/gpt-5-codex"
                         },
-                        "provider": {
-                          "type": "string",
-                          "description": "Model provider slug.",
-                          "example": "openai"
-                        },
-                        "name": {
-                          "type": "string",
-                          "description": "Optional display name for UI; do not use this as canonical model identifier.",
-                          "example": "GPT-5 Codex"
+                        {
+                          "type": "object",
+                          "required": [
+                            "model_id"
+                          ],
+                          "properties": {
+                            "model_id": {
+                              "type": "string",
+                              "description": "Full model ID in provider/model format.",
+                              "example": "openai/gpt-5-codex"
+                            },
+                            "provider": {
+                              "type": "string",
+                              "description": "Model provider slug.",
+                              "example": "openai"
+                            },
+                            "name": {
+                              "type": "string",
+                              "description": "Optional display name for UI; do not use this as canonical model identifier.",
+                              "example": "GPT-5 Codex"
+                            }
+                          }
                         }
-                      }
+                      ]
                     }
-                  ]
-                },
-                "example": [
-                  {
-                    "model_id": "openai/gpt-5-codex",
-                    "provider": "openai"
                   },
                   {
-                    "model_id": "anthropic/claude-sonnet-4-20250514",
-                    "provider": "anthropic"
+                    "type": "object",
+                    "additionalProperties": true,
+                    "description": "Structured model snapshot (for example status/list output). AgentMC extracts model IDs recursively."
                   }
-                ]
+                ],
+                "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"
+                    ]
+                  },
+                  "providers": {
+                    "openai": [
+                      "gpt-5-codex",
+                      "gpt-4.1"
+                    ],
+                    "anthropic": [
+                      "claude-sonnet-4-20250514"
+                    ]
+                  }
+                }
+              },
+              "identity": {
+                "nullable": true,
+                "description": "Optional full agent identity payload. AgentMC stores this under `agent.meta.identity`.",
+                "example": {
+                  "name": "Jarvis",
+                  "creature": "robot",
+                  "vibe": "calm",
+                  "emoji": "🤖"
+                }
               }
             },
             "description": "Optional runtime agent profile metadata.",
@@ -10644,12 +10632,28 @@
             "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"
+                ]
               }
-            ]
+            }
           }
         }
       },
@@ -11829,7 +11833,7 @@
               "$ref": "#/components/schemas/RegisterAgentApiRequest"
             },
             "example": {
-              "name": "codex-runtime-prod",
+              "name": "openclaw-main",
               "host": "ip-10-0-3-42",
               "runtime_version": "2026.02.1",
               "capabilities": [
@@ -11837,6 +11841,21 @@
                 "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",
@@ -11858,6 +11877,9 @@
                 "runtime": {
                   "name": "codex",
                   "version": "2026.02.1"
+                },
+                "identity": {
+                  "name": "Jarvis"
                 }
               }
             }
@@ -11907,16 +11929,28 @@
               "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"
+                    ]
                   }
-                ]
+                }
               }
             }
           }
@@ -12233,8 +12267,8 @@
             "example": {
               "agent_id": 42,
               "agent_token": "mca_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
-              "agent_instructions_endpoint": "https://agentmc.example.com/api/v1/agents/42/instructions",
-              "agent_authenticated_instructions_endpoint": "https://agentmc.example.com/api/v1/agents/42/instructions",
+              "agent_instructions_endpoint": "https://agentmc.example.com/api/v1/agents/42/agent-instructions",
+              "agent_authenticated_instructions_endpoint": "https://agentmc.example.com/api/v1/agents/42/agent-instructions",
               "agent_instructions_version": "32fe7fd14fca2d57c545f5f78f4a1c094f9ac1b3a1e8f6f9f8323b67a0ef9cc3",
               "openapi_url": "https://agentmc.example.com/api/openapi.json",
               "workspace": {
@@ -12248,15 +12282,16 @@
           }
         }
       },
-      "ConnectedAgentInstructionsResponse": {
+      "AgentInstructionsResponse": {
         "description": "Agent instructions returned.",
         "content": {
           "application/json": {
             "schema": {
-              "$ref": "#/components/schemas/ConnectedAgentInstructionsResponse"
+              "$ref": "#/components/schemas/AgentInstructionsResponse"
             },
             "example": {
-              "instructions": "# AgentMC Agent Sync Skill",
+              "agent_instructions": "# Agent Instructions",
+              "agent_instructions_version": "32fe7fd14fca2d57c545f5f78f4a1c094f9ac1b3a1e8f6f9f8323b67a0ef9cc3",
               "docs": [],
               "schedules": [],
               "config": {}