@agentmc/api 0.2.5 → 0.2.8

package/dist/index.js

@@ -210,104 +210,6 @@ 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",
@@ -917,158 +819,6 @@ var operations = [
       }
     ]
   },
-  {
-    "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",
@@ -2849,6 +2599,118 @@ var operations = [
       }
     ]
   },
+  {
+    "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",
@@ -2982,7 +2844,7 @@ var operations = [
                 "active": true
               }
             ],
-            "path": "example",
+            "path": ".agentmc/skills/skill.md",
             "per_page": 25,
             "total": 0
           }
@@ -3445,7 +3307,6 @@ var operations = [
                 ]
               },
               "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"
@@ -3468,7 +3329,7 @@ var operations = [
                 "active": true
               }
             ],
-            "path": "example",
+            "path": ".agentmc/skills/skill.md",
             "per_page": 25,
             "total": 0
           }
@@ -3596,7 +3457,7 @@ var operations = [
                 "active": true
               }
             ],
-            "path": "example",
+            "path": ".agentmc/skills/skill.md",
             "per_page": 25,
             "total": 0
           }
@@ -3787,7 +3648,7 @@ var operations = [
                 "active": true
               }
             ],
-            "path": "example",
+            "path": ".agentmc/skills/skill.md",
             "per_page": 25,
             "total": 0
           }
@@ -3929,7 +3790,7 @@ var operations = [
                 "active": true
               }
             ],
-            "path": "example",
+            "path": ".agentmc/skills/skill.md",
             "per_page": 25,
             "total": 0
           }
@@ -4045,7 +3906,7 @@ var operations = [
                 "active": true
               }
             ],
-            "path": "example",
+            "path": ".agentmc/skills/skill.md",
             "per_page": 25,
             "total": 0
           }
@@ -4186,7 +4047,7 @@ var operations = [
                 "active": true
               }
             ],
-            "path": "example",
+            "path": ".agentmc/skills/skill.md",
             "per_page": 25,
             "total": 0
           }
@@ -4335,7 +4196,7 @@ var operations = [
                 "active": true
               }
             ],
-            "path": "example",
+            "path": ".agentmc/skills/skill.md",
             "per_page": 25,
             "total": 0
           }
@@ -4523,7 +4384,7 @@ var operations = [
                 "active": true
               }
             ],
-            "path": "example",
+            "path": ".agentmc/skills/skill.md",
             "per_page": 25,
             "total": 0
           }
@@ -4641,7 +4502,7 @@ var operations = [
                 "active": true
               }
             ],
-            "path": "example",
+            "path": ".agentmc/skills/skill.md",
             "per_page": 25,
             "total": 0
           }