@agentmc/api 0.2.5 → 0.2.8

package/docs/operations/README.md

@@ -5,12 +5,10 @@ Generated from `spec/openapi.filtered.json`.
 | Operation ID | Method | Path | Tags |
 | --- | --- | --- | --- |
 | [agentHeartbeat](./agentHeartbeat.md) | POST | `/agents/{agent}/heartbeat` | Agents |
-| [agentInstructions](./agentInstructions.md) | GET | `/agents/{agent}/agent-instructions` | Agents |
 | [authenticateAgentRealtimeSocket](./authenticateAgentRealtimeSocket.md) | POST | `/agents/{agent}/realtime/sessions/{session}/socket-auth` | Agents |
 | [claimAgentRealtimeSession](./claimAgentRealtimeSession.md) | POST | `/agents/{agent}/realtime/sessions/{session}/claim` | Agents |
 | [closeAgentRealtimeSession](./closeAgentRealtimeSession.md) | POST | `/agents/{agent}/realtime/sessions/{session}/close` | Agents |
 | [commentCalendarItem](./commentCalendarItem.md) | POST | `/calendar/items/{item}/comments` | Calendar |
-| [connectAgent](./connectAgent.md) | POST | `/agents/connect` | Agents |
 | [createAgentBrief](./createAgentBrief.md) | POST | `/briefs` | Briefs |
 | [createAgentRealtimeSignal](./createAgentRealtimeSignal.md) | POST | `/agents/{agent}/realtime/sessions/{session}/signals` | Agents |
 | [createBoard](./createBoard.md) | POST | `/boards` | Boards |
@@ -24,6 +22,7 @@ Generated from `spec/openapi.filtered.json`.
 | [deleteCalendarItem](./deleteCalendarItem.md) | DELETE | `/calendar/items/{item}` | Calendar |
 | [deleteTask](./deleteTask.md) | DELETE | `/tasks/{task}` | Tasks |
 | [deleteTaskComment](./deleteTaskComment.md) | DELETE | `/tasks/{task}/comments/{comment}` | Tasks |
+| [getAgentInstructions](./getAgentInstructions.md) | GET | `/agents/instructions` | Agents |
 | [listAgentBriefs](./listAgentBriefs.md) | GET | `/briefs` | Briefs |
 | [listAgentRealtimeRequestedSessions](./listAgentRealtimeRequestedSessions.md) | GET | `/agents/{agent}/realtime/sessions/requested` | Agents |
 | [listAgentRealtimeSignals](./listAgentRealtimeSignals.md) | GET | `/agents/{agent}/realtime/sessions/{session}/signals` | Agents |

package/docs/operations/{agentInstructions.md → getAgentInstructions.md}

@@ -1,19 +1,19 @@
-# agentInstructions
+# getAgentInstructions
 
 - Method: `GET`
-- Path: `/agents/{agent}/agent-instructions`
-- Summary: Return agent instructions for a connected agent using bearer auth.
+- Path: `/agents/instructions`
+- Summary: Fetch the AgentMC instruction bundle for the authenticated agent.
 - Auth: AgentBearerAuth
 
 ## Description
 
-No additional description.
+Returns managed runtime files and bundle metadata. Send current_bundle_version to fetch files only when the bundle has changed.
 
 ## Parameters
 
 | Name | In | Required | Description | Example |
 | --- | --- | --- | --- | --- |
-| agent | path | yes | Agent identifier. | 1 |
+| current_bundle_version | query | no | Last applied instruction bundle version from local runtime state. | "bundle_2fa07fcadd6575cc" |
 
 ## Request Example
 
@@ -22,15 +22,29 @@ None.
 ## Success Responses
 
 ### 200 (application/json)
-Agent instructions returned.
+Instruction bundle returned.
 
 ```json
 {
-  "agent_instructions": "# Agent Instructions",
-  "agent_instructions_version": "32fe7fd14fca2d57c545f5f78f4a1c094f9ac1b3a1e8f6f9f8323b67a0ef9cc3",
-  "docs": [],
-  "schedules": [],
-  "config": {}
+  "ok": true,
+  "changed": true,
+  "bundle_version": "bundle_2fa07fcadd6575cc",
+  "generated_at": "2026-02-25T14:10:00Z",
+  "defaults": {
+    "heartbeat_interval_seconds": 300
+  },
+  "agent": {
+    "id": 42,
+    "name": "Agent"
+  },
+  "files": [
+    {
+      "id": "skill.md",
+      "path": ".agentmc/skills/skill.md",
+      "content": "# AgentMC\n",
+      "sha256": "f96c95bd27dc9f3415cc0f4d817b5ec6f14185b6fcb5db9f6b6f14f648f8e9e4"
+    }
+  ]
 }
 ```
 
@@ -75,8 +89,8 @@ Forbidden.
 }
 ```
 
-### 404 (application/json)
-Resource not found.
+### 422 (application/json)
+Validation failed.
 
 ```json
 {
@@ -104,10 +118,10 @@ const client = new AgentMCApi({
   agentToken: process.env.AGENTMC_AGENT_TOKEN
 });
 
-const result = await client.operations.agentInstructions({
+const result = await client.operations.getAgentInstructions({
   "params": {
-    "path": {
-      "agent": 1
+    "query": {
+      "current_bundle_version": "bundle_2fa07fcadd6575cc"
     }
   }
 });
@@ -122,7 +136,7 @@ if (result.error) {
 ## cURL Example
 
 ```bash
-curl -X GET "https://agentmc.ai/api/v1/agents/1/agent-instructions" \\
+curl -X GET "https://agentmc.ai/api/v1/agents/instructions?current_bundle_version=bundle_2fa07fcadd6575cc" \\
   -H "Accept: application/json" \\
   -H "Authorization: Bearer $AGENTMC_AGENT_TOKEN"
 ```

package/docs/operations/index.json

@@ -205,104 +205,6 @@
       }
     ]
   },
-  {
-    "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",
@@ -912,158 +814,6 @@
       }
     ]
   },
-  {
-    "operationId": "connectAgent",
-    "method": "post",
-    "path": "/agents/connect",
-    "summary": "Connect and register one agent using a short-lived connect token.",
-    "description": "",
-    "tags": [
-      "Agents"
-    ],
-    "security": [
-      [
-        "ConnectTokenAuth"
-      ]
-    ],
-    "parameters": [],
-    "requestBodyRequired": true,
-    "requestExamples": [
-      {
-        "mediaType": "application/json",
-        "example": {
-          "host": "ip-10-0-3-42",
-          "runtime_version": "2026.02.1",
-          "capabilities": [
-            "tasks",
-            "calendar",
-            "realtime"
-          ],
-          "agents_md": "# Existing AGENTS.md\n\n## Runtime\n- Keep heartbeat alive.\n",
-          "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",
-            "network": {
-              "private_ip": "10.0.2.15",
-              "public_ip": "34.201.22.9"
-            },
-            "os": "Ubuntu",
-            "os_version": "22.04",
-            "arch": "x86_64",
-            "cpu": "Intel Xeon",
-            "cpu_cores": 8,
-            "ram_gb": 32,
-            "disk": {
-              "total_bytes": 512110190592,
-              "free_bytes": 321102110720
-            },
-            "uptime_seconds": 86400,
-            "runtime": {
-              "name": "codex",
-              "version": "2026.02.1"
-            },
-            "identity": {
-              "name": "Jarvis"
-            }
-          }
-        }
-      }
-    ],
-    "responses": [
-      {
-        "status": "201",
-        "mediaType": "application/json",
-        "description": "Agent connected and bearer token issued.",
-        "hasContent": true,
-        "example": {
-          "agent_id": 42,
-          "agent_token": "mca_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
-          "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": {
-            "id": 7,
-            "name": "AgentMC Demo Workspace"
-          },
-          "server_time": "2026-02-22T17:20:53Z",
-          "first_sync_required": true
-        }
-      },
-      {
-        "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": "422",
-        "mediaType": "application/json",
-        "description": "Validation failed.",
-        "hasContent": true,
-        "example": {
-          "error": {
-            "code": "validation.failed",
-            "message": "Validation failed.",
-            "details": {
-              "fields": {
-                "title": [
-                  "The title field is required."
-                ]
-              }
-            }
-          }
-        }
-      }
-    ]
-  },
   {
     "operationId": "createAgentBrief",
     "method": "post",
@@ -2844,6 +2594,118 @@
       }
     ]
   },
+  {
+    "operationId": "getAgentInstructions",
+    "method": "get",
+    "path": "/agents/instructions",
+    "summary": "Fetch the AgentMC instruction bundle for the authenticated agent.",
+    "description": "Returns managed runtime files and bundle metadata. Send current_bundle_version to fetch files only when the bundle has changed.",
+    "tags": [
+      "Agents"
+    ],
+    "security": [
+      [
+        "AgentBearerAuth"
+      ]
+    ],
+    "parameters": [
+      {
+        "name": "current_bundle_version",
+        "in": "query",
+        "required": false,
+        "description": "Last applied instruction bundle version from local runtime state.",
+        "example": "bundle_2fa07fcadd6575cc"
+      }
+    ],
+    "requestBodyRequired": false,
+    "requestExamples": [],
+    "responses": [
+      {
+        "status": "200",
+        "mediaType": "application/json",
+        "description": "Instruction bundle returned.",
+        "hasContent": true,
+        "example": {
+          "ok": true,
+          "changed": true,
+          "bundle_version": "bundle_2fa07fcadd6575cc",
+          "generated_at": "2026-02-25T14:10:00Z",
+          "defaults": {
+            "heartbeat_interval_seconds": 300
+          },
+          "agent": {
+            "id": 42,
+            "name": "Agent"
+          },
+          "files": [
+            {
+              "id": "skill.md",
+              "path": ".agentmc/skills/skill.md",
+              "content": "# AgentMC\n",
+              "sha256": "f96c95bd27dc9f3415cc0f4d817b5ec6f14185b6fcb5db9f6b6f14f648f8e9e4"
+            }
+          ]
+        }
+      },
+      {
+        "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": "422",
+        "mediaType": "application/json",
+        "description": "Validation failed.",
+        "hasContent": true,
+        "example": {
+          "error": {
+            "code": "validation.failed",
+            "message": "Validation failed.",
+            "details": {
+              "fields": {
+                "title": [
+                  "The title field is required."
+                ]
+              }
+            }
+          }
+        }
+      }
+    ]
+  },
   {
     "operationId": "listAgentBriefs",
     "method": "get",
@@ -2977,7 +2839,7 @@
                 "active": true
               }
             ],
-            "path": "example",
+            "path": ".agentmc/skills/skill.md",
             "per_page": 25,
             "total": 0
           }
@@ -3440,7 +3302,6 @@
                 ]
               },
               "last_seen_at": "2026-02-24T02:11:00Z",
-              "first_sync_at": "2026-02-24T02:01:00Z",
               "tasks_count": 3,
               "created_at": "2026-02-24T01:56:00Z",
               "updated_at": "2026-02-24T02:11:00Z"
@@ -3463,7 +3324,7 @@
                 "active": true
               }
             ],
-            "path": "example",
+            "path": ".agentmc/skills/skill.md",
             "per_page": 25,
             "total": 0
           }
@@ -3591,7 +3452,7 @@
                 "active": true
               }
             ],
-            "path": "example",
+            "path": ".agentmc/skills/skill.md",
             "per_page": 25,
             "total": 0
           }
@@ -3782,7 +3643,7 @@
                 "active": true
               }
             ],
-            "path": "example",
+            "path": ".agentmc/skills/skill.md",
             "per_page": 25,
             "total": 0
           }
@@ -3924,7 +3785,7 @@
                 "active": true
               }
             ],
-            "path": "example",
+            "path": ".agentmc/skills/skill.md",
             "per_page": 25,
             "total": 0
           }
@@ -4040,7 +3901,7 @@
                 "active": true
               }
             ],
-            "path": "example",
+            "path": ".agentmc/skills/skill.md",
             "per_page": 25,
             "total": 0
           }
@@ -4181,7 +4042,7 @@
                 "active": true
               }
             ],
-            "path": "example",
+            "path": ".agentmc/skills/skill.md",
             "per_page": 25,
             "total": 0
           }
@@ -4330,7 +4191,7 @@
                 "active": true
               }
             ],
-            "path": "example",
+            "path": ".agentmc/skills/skill.md",
             "per_page": 25,
             "total": 0
           }
@@ -4518,7 +4379,7 @@
                 "active": true
               }
             ],
-            "path": "example",
+            "path": ".agentmc/skills/skill.md",
             "per_page": 25,
             "total": 0
           }
@@ -4636,7 +4497,7 @@
                 "active": true
               }
             ],
-            "path": "example",
+            "path": ".agentmc/skills/skill.md",
             "per_page": 25,
             "total": 0
           }

package/docs/operations/listAgentBriefs.md

@@ -103,7 +103,7 @@ Brief list returned.
         "active": true
       }
     ],
-    "path": "example",
+    "path": ".agentmc/skills/skill.md",
     "per_page": 25,
     "total": 0
   }

package/docs/operations/listAgents.md

@@ -56,7 +56,6 @@ Agents returned.
         ]
       },
       "last_seen_at": "2026-02-24T02:11:00Z",
-      "first_sync_at": "2026-02-24T02:01:00Z",
       "tasks_count": 3,
       "created_at": "2026-02-24T01:56:00Z",
       "updated_at": "2026-02-24T02:11:00Z"
@@ -79,7 +78,7 @@ Agents returned.
         "active": true
       }
     ],
-    "path": "example",
+    "path": ".agentmc/skills/skill.md",
     "per_page": 25,
     "total": 0
   }

package/docs/operations/listBoards.md

@@ -58,7 +58,7 @@ Board list returned.
         "active": true
       }
     ],
-    "path": "example",
+    "path": ".agentmc/skills/skill.md",
     "per_page": 25,
     "total": 0
   }

package/docs/operations/listCalendar.md

@@ -85,7 +85,7 @@ Calendar items returned.
         "active": true
       }
     ],
-    "path": "example",
+    "path": ".agentmc/skills/skill.md",
     "per_page": 25,
     "total": 0
   }

package/docs/operations/listHosts.md

@@ -72,7 +72,7 @@ Host list returned.
         "active": true
       }
     ],
-    "path": "example",
+    "path": ".agentmc/skills/skill.md",
     "per_page": 25,
     "total": 0
   }

package/docs/operations/listLogs.md

@@ -58,7 +58,7 @@ Logs returned.
         "active": true
       }
     ],
-    "path": "example",
+    "path": ".agentmc/skills/skill.md",
     "per_page": 25,
     "total": 0
   }

package/docs/operations/listNotifications.md

@@ -77,7 +77,7 @@ Notifications returned.
         "active": true
       }
     ],
-    "path": "example",
+    "path": ".agentmc/skills/skill.md",
     "per_page": 25,
     "total": 0
   }

package/docs/operations/listTaskComments.md

@@ -66,7 +66,7 @@ Task comments returned.
         "active": true
       }
     ],
-    "path": "example",
+    "path": ".agentmc/skills/skill.md",
     "per_page": 25,
     "total": 0
   }

package/docs/operations/listTasks.md

@@ -69,7 +69,7 @@ Task list returned.
         "active": true
       }
     ],
-    "path": "example",
+    "path": ".agentmc/skills/skill.md",
     "per_page": 25,
     "total": 0
   }