@agentmc/api 0.2.4 → 0.2.7

package/spec/openapi.filtered.json

@@ -12,114 +12,6 @@
     }
   ],
   "paths": {
-    "/agents/connect": {
-      "post": {
-        "tags": [
-          "Agents"
-        ],
-        "summary": "Connect and register one agent using a short-lived connect token.",
-        "operationId": "connectAgent",
-        "responses": {
-          "201": {
-            "description": "Agent connected and bearer token issued.",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/AgentRegisterResponse"
-                },
-                "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"
-                  },
-                  "heartbeat_interval_seconds": 300,
-                  "server_time": "2026-02-22T17:20:53Z",
-                  "first_sync_required": true
-                }
-              }
-            }
-          },
-          "401": {
-            "$ref": "#/components/responses/ApiError401"
-          },
-          "403": {
-            "$ref": "#/components/responses/ApiError403"
-          },
-          "422": {
-            "$ref": "#/components/responses/ApiError422"
-          }
-        },
-        "security": [
-          {
-            "ConnectTokenAuth": []
-          }
-        ],
-        "requestBody": {
-          "$ref": "#/components/requestBodies/RegisterAgentApiRequest"
-        }
-      }
-    },
-    "/agents/{agent}/agent-instructions": {
-      "get": {
-        "tags": [
-          "Agents"
-        ],
-        "summary": "Return agent instructions for a connected agent using bearer auth.",
-        "operationId": "agentInstructions",
-        "parameters": [
-          {
-            "name": "agent",
-            "in": "path",
-            "description": "Agent identifier.",
-            "required": true,
-            "schema": {
-              "type": "integer",
-              "minimum": 1
-            },
-            "example": 1
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Agent instructions returned.",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/AgentInstructionsResponse"
-                },
-                "example": {
-                  "agent_instructions": "# Agent Instructions",
-                  "agent_instructions_version": "32fe7fd14fca2d57c545f5f78f4a1c094f9ac1b3a1e8f6f9f8323b67a0ef9cc3",
-                  "docs": [],
-                  "schedules": [],
-                  "config": {}
-                }
-              }
-            }
-          },
-          "401": {
-            "$ref": "#/components/responses/ApiError401"
-          },
-          "403": {
-            "$ref": "#/components/responses/ApiError403"
-          },
-          "404": {
-            "$ref": "#/components/responses/ApiError404"
-          }
-        },
-        "security": [
-          {
-            "AgentBearerAuth": []
-          }
-        ]
-      }
-    },
     "/agents/{agent}/heartbeat": {
       "post": {
         "tags": [
@@ -3046,7 +2938,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"
@@ -4226,16 +4117,10 @@
         "name": "X-Api-Key",
         "in": "header"
       },
-      "ConnectTokenAuth": {
-        "type": "apiKey",
-        "description": "Short-lived single-use connect token for agent registration only.",
-        "name": "X-Connect-Token",
-        "in": "header"
-      },
       "AgentBearerAuth": {
         "type": "http",
-        "description": "Agent-scoped bearer token returned by /agents/connect and accepted on agent-compatible API operations.",
-        "bearerFormat": "agent_token",
+        "description": "Agent-scoped API key issued from Agent setup and accepted on agent-compatible API operations.",
+        "bearerFormat": "agent_api_key",
         "scheme": "bearer"
       },
       "BearerAuth": {
@@ -4773,7 +4658,6 @@
           "capabilities",
           "meta",
           "last_seen_at",
-          "first_sync_at",
           "tasks_count",
           "created_at",
           "updated_at"
@@ -4806,7 +4690,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"
@@ -4910,13 +4793,6 @@
             "description": "ISO-8601 timestamp for most recent heartbeat.",
             "example": "2026-02-22T17:21:00Z"
           },
-          "first_sync_at": {
-            "type": "string",
-            "format": "date-time",
-            "nullable": true,
-            "description": "ISO-8601 timestamp when this agent first completed initial sync.",
-            "example": "2026-02-22T17:21:00Z"
-          },
           "tasks_count": {
             "type": "integer",
             "minimum": 0,
@@ -4983,7 +4859,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"
@@ -5051,7 +4926,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"
@@ -5144,161 +5018,6 @@
           }
         }
       },
-      "AgentRegisterResponse": {
-        "type": "object",
-        "required": [
-          "agent_id",
-          "agent_token",
-          "agent_instructions_endpoint",
-          "agent_authenticated_instructions_endpoint",
-          "agent_instructions_version",
-          "openapi_url",
-          "workspace",
-          "heartbeat_interval_seconds",
-          "server_time",
-          "first_sync_required"
-        ],
-        "properties": {
-          "agent_id": {
-            "type": "integer",
-            "minimum": 1,
-            "description": "Identifier for agent.",
-            "example": 42
-          },
-          "agent_token": {
-            "type": "string",
-            "description": "Bearer token to use in `Authorization: Bearer <token>` headers.",
-            "example": "mca_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
-          },
-          "agent_instructions_endpoint": {
-            "type": "string",
-            "format": "uri",
-            "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 instructions updates.",
-            "example": "https://agentmc.example.com/resource"
-          },
-          "agent_instructions_version": {
-            "type": "string",
-            "description": "Agent instructions version.",
-            "example": "example"
-          },
-          "openapi_url": {
-            "type": "string",
-            "description": "Canonical OpenAPI specification URL.",
-            "example": "https://agentmc.example.com/api/openapi.json"
-          },
-          "workspace": {
-            "$ref": "#/components/schemas/TeamSummary",
-            "description": "Workspace.",
-            "example": {
-              "id": 42,
-              "name": "Example Name"
-            }
-          },
-          "heartbeat_interval_seconds": {
-            "type": "integer",
-            "minimum": 1,
-            "description": "Heartbeat interval seconds.",
-            "example": 1
-          },
-          "server_time": {
-            "type": "string",
-            "format": "date-time",
-            "description": "Current server timestamp.",
-            "example": "2026-02-22T17:21:00Z"
-          },
-          "first_sync_required": {
-            "type": "boolean",
-            "description": "Boolean flag for first sync required.",
-            "example": true
-          }
-        },
-        "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/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"
-          },
-          "heartbeat_interval_seconds": 300,
-          "server_time": "2026-02-22T17:20:53Z",
-          "first_sync_required": true
-        }
-      },
-      "AgentInstructionsResponse": {
-        "type": "object",
-        "required": [
-          "agent_instructions",
-          "agent_instructions_version",
-          "docs",
-          "schedules",
-          "config"
-        ],
-        "properties": {
-          "agent_instructions": {
-            "type": "string",
-            "description": "Agent instructions.",
-            "example": "example"
-          },
-          "agent_instructions_version": {
-            "type": "string",
-            "description": "Agent instructions version.",
-            "example": "example"
-          },
-          "docs": {
-            "type": "array",
-            "items": {
-              "type": "object",
-              "additionalProperties": true
-            },
-            "description": "Docs.",
-            "example": [
-              {
-                "key": "value"
-              }
-            ]
-          },
-          "schedules": {
-            "type": "array",
-            "items": {
-              "type": "object",
-              "additionalProperties": true
-            },
-            "description": "Schedules.",
-            "example": [
-              {
-                "key": "value"
-              }
-            ]
-          },
-          "config": {
-            "type": "object",
-            "additionalProperties": true,
-            "description": "Config.",
-            "example": {
-              "key": "value"
-            }
-          }
-        },
-        "description": "Connected agent instructions payload returned after successful bearer authentication.",
-        "example": {
-          "agent_instructions": "# Agent Instructions",
-          "agent_instructions_version": "32fe7fd14fca2d57c545f5f78f4a1c094f9ac1b3a1e8f6f9f8323b67a0ef9cc3",
-          "docs": [],
-          "schedules": [],
-          "config": {}
-        }
-      },
       "AgentHeartbeatResponse": {
         "type": "object",
         "required": [
@@ -9826,386 +9545,6 @@
           }
         }
       },
-      "RegisterAgentApiRequest": {
-        "type": "object",
-        "properties": {
-          "host": {
-            "type": "string",
-            "maxLength": 255,
-            "description": "Runtime host identifier (hostname or machine name).",
-            "example": "ip-10-0-3-42"
-          },
-          "runtime_version": {
-            "type": "string",
-            "maxLength": 255,
-            "description": "Required runtime/client version string for diagnostics.",
-            "example": "2026.02.1"
-          },
-          "capabilities": {
-            "nullable": true,
-            "type": "array",
-            "items": {
-              "type": "string",
-              "maxLength": 120
-            },
-            "description": "Required (nullable) capability tags supported by this runtime.",
-            "example": [
-              "tasks",
-              "calendar",
-              "realtime"
-            ]
-          },
-          "agents_md": {
-            "type": "string",
-            "minLength": 1,
-            "maxLength": 262144,
-            "description": "Required current local AGENTS.md content captured by the runtime before first sync.",
-            "example": "# Existing AGENTS.md\n\n## Runtime\n- Keep heartbeat alive.\n"
-          },
-          "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 persisted in agent metadata.",
-            "example": {
-              "name": "Jarvis",
-              "creature": "robot",
-              "vibe": "calm",
-              "emoji": "🤖"
-            }
-          },
-          "metadata": {
-            "type": "object",
-            "additionalProperties": true,
-            "required": [
-              "hostname",
-              "ip",
-              "network",
-              "os",
-              "os_version",
-              "arch",
-              "cpu",
-              "cpu_cores",
-              "ram_gb",
-              "disk",
-              "uptime_seconds",
-              "runtime"
-            ],
-            "properties": {
-              "hostname": {
-                "type": "string",
-                "maxLength": 255,
-                "description": "Hostname.",
-                "example": "Example Name"
-              },
-              "ip": {
-                "type": "string",
-                "format": "ipv4",
-                "description": "Ip.",
-                "example": "example"
-              },
-              "network": {
-                "type": "object",
-                "required": [
-                  "private_ip",
-                  "public_ip"
-                ],
-                "properties": {
-                  "private_ip": {
-                    "type": "string",
-                    "format": "ipv4",
-                    "description": "Private ip.",
-                    "example": "example"
-                  },
-                  "public_ip": {
-                    "type": "string",
-                    "format": "ipv4",
-                    "description": "Public ip.",
-                    "example": "example"
-                  }
-                },
-                "description": "Network.",
-                "example": {
-                  "private_ip": "example",
-                  "public_ip": "example"
-                }
-              },
-              "os": {
-                "type": "string",
-                "maxLength": 120,
-                "description": "Os.",
-                "example": "example"
-              },
-              "os_version": {
-                "type": "string",
-                "maxLength": 120,
-                "description": "Os version.",
-                "example": "example"
-              },
-              "arch": {
-                "type": "string",
-                "maxLength": 120,
-                "description": "Arch.",
-                "example": "example"
-              },
-              "cpu": {
-                "oneOf": [
-                  {
-                    "type": "string"
-                  },
-                  {
-                    "type": "object",
-                    "additionalProperties": true
-                  }
-                ],
-                "description": "Cpu.",
-                "example": "example"
-              },
-              "cpu_cores": {
-                "type": "integer",
-                "minimum": 1,
-                "maximum": 4096,
-                "description": "Cpu cores.",
-                "example": 8
-              },
-              "ram_gb": {
-                "type": "number",
-                "minimum": 0,
-                "description": "Ram gb.",
-                "example": 32
-              },
-              "disk": {
-                "type": "object",
-                "required": [
-                  "total_bytes",
-                  "free_bytes"
-                ],
-                "properties": {
-                  "total_bytes": {
-                    "type": "integer",
-                    "minimum": 0,
-                    "description": "Total bytes.",
-                    "example": 0
-                  },
-                  "free_bytes": {
-                    "type": "integer",
-                    "minimum": 0,
-                    "description": "Free bytes.",
-                    "example": 0
-                  }
-                },
-                "description": "Disk.",
-                "example": {
-                  "total_bytes": 0,
-                  "free_bytes": 0
-                }
-              },
-              "uptime_seconds": {
-                "type": "integer",
-                "minimum": 0,
-                "description": "Uptime seconds.",
-                "example": 86400
-              },
-              "runtime": {
-                "type": "object",
-                "required": [
-                  "name",
-                  "version"
-                ],
-                "properties": {
-                  "name": {
-                    "type": "string",
-                    "maxLength": 120,
-                    "description": "Human-readable name.",
-                    "example": "Example Name"
-                  },
-                  "version": {
-                    "type": "string",
-                    "maxLength": 120,
-                    "description": "Version.",
-                    "example": "example"
-                  }
-                },
-                "description": "Runtime.",
-                "example": {
-                  "name": "Example Name",
-                  "version": "example"
-                }
-              },
-              "identity": {
-                "description": "Optional identity payload persisted as host metadata.",
-                "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.",
-            "example": {
-              "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",
-                "creature": "robot",
-                "vibe": "calm"
-              }
-            }
-          }
-        },
-        "required": [
-          "host",
-          "runtime_version",
-          "capabilities",
-          "agents_md",
-          "metadata"
-        ],
-        "description": "One-time agent registration payload. Resolve this schema from OpenAPI at runtime instead of hardcoding fields.",
-        "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",
-            "emoji": "🤖"
-          },
-          "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",
-              "creature": "robot",
-              "vibe": "calm"
-            }
-          }
-        }
-      },
       "StoreAgentHeartbeatApiRequest": {
         "type": "object",
         "properties": {
@@ -11826,67 +11165,6 @@
           }
         }
       },
-      "RegisterAgentApiRequest": {
-        "required": true,
-        "content": {
-          "application/json": {
-            "schema": {
-              "$ref": "#/components/schemas/RegisterAgentApiRequest"
-            },
-            "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"
-                }
-              }
-            }
-          }
-        }
-      },
       "StoreAgentHeartbeatApiRequest": {
         "required": true,
         "content": {
@@ -12258,48 +11536,6 @@
       }
     },
     "responses": {
-      "AgentRegisterResponse": {
-        "description": "Agent registered and bearer token issued.",
-        "content": {
-          "application/json": {
-            "schema": {
-              "$ref": "#/components/schemas/AgentRegisterResponse"
-            },
-            "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"
-              },
-              "heartbeat_interval_seconds": 300,
-              "server_time": "2026-02-22T17:20:53Z",
-              "first_sync_required": true
-            }
-          }
-        }
-      },
-      "AgentInstructionsResponse": {
-        "description": "Agent instructions returned.",
-        "content": {
-          "application/json": {
-            "schema": {
-              "$ref": "#/components/schemas/AgentInstructionsResponse"
-            },
-            "example": {
-              "agent_instructions": "# Agent Instructions",
-              "agent_instructions_version": "32fe7fd14fca2d57c545f5f78f4a1c094f9ac1b3a1e8f6f9f8323b67a0ef9cc3",
-              "docs": [],
-              "schedules": [],
-              "config": {}
-            }
-          }
-        }
-      },
       "AgentHeartbeatResponse": {
         "description": "Heartbeat accepted.",
         "content": {