@agentmc/api 0.2.2 → 0.2.4

package/dist/index.d.ts

@@ -23,15 +23,15 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/agents/{agent}/instructions": {
+    "/agents/{agent}/agent-instructions": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        /** Return runtime instructions for a connected agent using bearer auth. */
-        get: operations["agentConnectedInstructions"];
+        /** Return agent instructions for a connected agent using bearer auth. */
+        get: operations["agentInstructions"];
         put?: never;
         post?: never;
         delete?: never;
@@ -1267,12 +1267,12 @@ interface components {
             };
         };
         /**
-         * @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": {
@@ -1297,13 +1297,13 @@ interface components {
             agent_token: string;
             /**
              * Format: uri
-             * @description Endpoint for agent runtime instructions.
+             * @description Endpoint for agent instructions updates.
              * @example https://agentmc.example.com/resource
              */
             agent_instructions_endpoint: string;
             /**
              * Format: uri
-             * @description Authenticated endpoint for agent runtime instructions.
+             * @description Authenticated endpoint for agent instructions updates.
              * @example https://agentmc.example.com/resource
              */
             agent_authenticated_instructions_endpoint: string;
@@ -1343,20 +1343,26 @@ interface components {
             first_sync_required: boolean;
         };
         /**
-         * @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": {}
          *     }
          */
-        ConnectedAgentInstructionsResponse: {
+        AgentInstructionsResponse: {
             /**
-             * @description Instructions.
+             * @description Agent instructions.
              * @example example
              */
-            instructions: string;
+            agent_instructions: string;
+            /**
+             * @description Agent instructions version.
+             * @example example
+             */
+            agent_instructions_version: string;
             /**
              * @description Docs.
              * @example [
@@ -5226,7 +5232,6 @@ interface components {
         /**
          * @description One-time agent registration payload. Resolve this schema from OpenAPI at runtime instead of hardcoding fields.
          * @example {
-         *       "name": "openclaw-main",
          *       "host": "ip-10-0-3-42",
          *       "runtime_version": "2026.02.1",
          *       "capabilities": [
@@ -5234,6 +5239,7 @@ interface components {
          *         "calendar",
          *         "realtime"
          *       ],
+         *       "agents_md": "# Existing AGENTS.md\n\n## Runtime\n- Keep heartbeat alive.\n",
          *       "models": [
          *         {
          *           "model_id": "openai/gpt-5-codex",
@@ -5281,11 +5287,6 @@ interface components {
          *     }
          */
         RegisterAgentApiRequest: {
-            /**
-             * @description Runtime/client label fallback. AgentMC prefers identity name values from `identity.name` or `metadata.identity.name` when provided.
-             * @example openclaw-main
-             */
-            name: string;
             /**
              * @description Runtime host identifier (hostname or machine name).
              * @example ip-10-0-3-42
@@ -5305,6 +5306,14 @@ interface components {
              *     ]
              */
             capabilities: string[] | null;
+            /**
+             * @description Required current local AGENTS.md content captured by the runtime before first sync.
+             * @example # Existing AGENTS.md
+             *
+             *     ## Runtime
+             *     - Keep heartbeat alive.
+             */
+            agents_md: string;
             /**
              * @description Optional runtime LLM inventory. Send an array of model refs/objects or a structured runtime snapshot object.
              * @example [
@@ -5338,7 +5347,7 @@ interface components {
                 [key: string]: unknown;
             }) | null;
             /**
-             * @description Optional full agent identity payload. AgentMC uses `identity.name` as the registered agent name when provided.
+             * @description Optional full agent identity payload persisted in agent metadata.
              * @example {
              *       "name": "Jarvis",
              *       "creature": "robot",
@@ -5487,7 +5496,7 @@ interface components {
                     version: string;
                 };
                 /**
-                 * @description Optional identity payload. When `identity.name` is present, AgentMC uses it as the registered agent name.
+                 * @description Optional identity payload persisted as host metadata.
                  * @example {
                  *       "name": "Jarvis"
                  *     }
@@ -6619,8 +6628,8 @@ interface components {
                  * @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": {
@@ -6636,20 +6645,21 @@ interface components {
             };
         };
         /** @description Agent instructions returned. */
-        ConnectedAgentInstructionsResponse: {
+        AgentInstructionsResponse: {
             headers: {
                 [name: string]: unknown;
             };
             content: {
                 /**
                  * @example {
-                 *       "instructions": "# AgentMC Agent Sync Skill",
+                 *       "agent_instructions": "# Agent Instructions",
+                 *       "agent_instructions_version": "32fe7fd14fca2d57c545f5f78f4a1c094f9ac1b3a1e8f6f9f8323b67a0ef9cc3",
                  *       "docs": [],
                  *       "schedules": [],
                  *       "config": {}
                  *     }
                  */
-                "application/json": components["schemas"]["ConnectedAgentInstructionsResponse"];
+                "application/json": components["schemas"]["AgentInstructionsResponse"];
             };
         };
         /** @description Heartbeat accepted. */
@@ -7319,7 +7329,6 @@ interface components {
             content: {
                 /**
                  * @example {
-                 *       "name": "openclaw-main",
                  *       "host": "ip-10-0-3-42",
                  *       "runtime_version": "2026.02.1",
                  *       "capabilities": [
@@ -7327,6 +7336,7 @@ interface components {
                  *         "calendar",
                  *         "realtime"
                  *       ],
+                 *       "agents_md": "# Existing AGENTS.md\n\n## Runtime\n- Keep heartbeat alive.\n",
                  *       "models": [
                  *         {
                  *           "model_id": "openai/gpt-5-codex",
@@ -7713,8 +7723,8 @@ interface operations {
                      * @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": {
@@ -7734,7 +7744,7 @@ interface operations {
             422: components["responses"]["ApiError422"];
         };
     };
-    agentConnectedInstructions: {
+    agentInstructions: {
         parameters: {
             query?: never;
             header?: never;
@@ -7749,7 +7759,7 @@ interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Instructions returned. */
+            /** @description Agent instructions returned. */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -7757,13 +7767,14 @@ interface operations {
                 content: {
                     /**
                      * @example {
-                     *       "instructions": "# AgentMC Agent Sync Skill",
+                     *       "agent_instructions": "# Agent Instructions",
+                     *       "agent_instructions_version": "32fe7fd14fca2d57c545f5f78f4a1c094f9ac1b3a1e8f6f9f8323b67a0ef9cc3",
                      *       "docs": [],
                      *       "schedules": [],
                      *       "config": {}
                      *     }
                      */
-                    "application/json": components["schemas"]["ConnectedAgentInstructionsResponse"];
+                    "application/json": components["schemas"]["AgentInstructionsResponse"];
                 };
             };
             401: components["responses"]["ApiError401"];

package/dist/index.js

@@ -4,103 +4,6 @@ import createClient from 'openapi-fetch';
 
 // src/generated/operations.ts
 var operations = [
-  {
-    "operationId": "agentConnectedInstructions",
-    "method": "get",
-    "path": "/agents/{agent}/instructions",
-    "summary": "Return runtime instructions for a connected agent using bearer auth.",
-    "description": "",
-    "tags": [
-      "Agents"
-    ],
-    "security": [
-      [
-        "AgentBearerAuth"
-      ]
-    ],
-    "parameters": [
-      {
-        "name": "agent",
-        "in": "path",
-        "required": true,
-        "description": "Agent identifier.",
-        "example": 1
-      }
-    ],
-    "requestBodyRequired": false,
-    "requestExamples": [],
-    "responses": [
-      {
-        "status": "200",
-        "mediaType": "application/json",
-        "description": "Instructions returned.",
-        "hasContent": true,
-        "example": {
-          "instructions": "# AgentMC Agent Sync Skill",
-          "docs": [],
-          "schedules": [],
-          "config": {}
-        }
-      },
-      {
-        "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."
-                ]
-              }
-            }
-          }
-        }
-      },
-      {
-        "status": "404",
-        "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."
-                ]
-              }
-            }
-          }
-        }
-      }
-    ]
-  },
   {
     "operationId": "agentHeartbeat",
     "method": "post",
@@ -307,6 +210,104 @@ var operations = [
       }
     ]
   },
+  {
+    "operationId": "agentInstructions",
+    "method": "get",
+    "path": "/agents/{agent}/agent-instructions",
+    "summary": "Return agent instructions for a connected agent using bearer auth.",
+    "description": "",
+    "tags": [
+      "Agents"
+    ],
+    "security": [
+      [
+        "AgentBearerAuth"
+      ]
+    ],
+    "parameters": [
+      {
+        "name": "agent",
+        "in": "path",
+        "required": true,
+        "description": "Agent identifier.",
+        "example": 1
+      }
+    ],
+    "requestBodyRequired": false,
+    "requestExamples": [],
+    "responses": [
+      {
+        "status": "200",
+        "mediaType": "application/json",
+        "description": "Agent instructions returned.",
+        "hasContent": true,
+        "example": {
+          "agent_instructions": "# Agent Instructions",
+          "agent_instructions_version": "32fe7fd14fca2d57c545f5f78f4a1c094f9ac1b3a1e8f6f9f8323b67a0ef9cc3",
+          "docs": [],
+          "schedules": [],
+          "config": {}
+        }
+      },
+      {
+        "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."
+                ]
+              }
+            }
+          }
+        }
+      },
+      {
+        "status": "404",
+        "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."
+                ]
+              }
+            }
+          }
+        }
+      }
+    ]
+  },
   {
     "operationId": "authenticateAgentRealtimeSocket",
     "method": "post",
@@ -936,7 +937,6 @@ var operations = [
       {
         "mediaType": "application/json",
         "example": {
-          "name": "openclaw-main",
           "host": "ip-10-0-3-42",
           "runtime_version": "2026.02.1",
           "capabilities": [
@@ -944,6 +944,7 @@ var operations = [
             "calendar",
             "realtime"
           ],
+          "agents_md": "# Existing AGENTS.md\n\n## Runtime\n- Keep heartbeat alive.\n",
           "models": [
             {
               "model_id": "openai/gpt-5-codex",
@@ -997,8 +998,8 @@ var operations = [
         "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": {