@agentmc/api 0.2.3 → 0.2.5

package/docs/operations/connectAgent.md

@@ -18,7 +18,6 @@ None.
 ### application/json
 ```json
 {
-  "name": "openclaw-main",
   "host": "ip-10-0-3-42",
   "runtime_version": "2026.02.1",
   "capabilities": [
@@ -26,6 +25,7 @@ None.
     "calendar",
     "realtime"
   ],
+  "agents_md": "# Existing AGENTS.md\n\n## Runtime\n- Keep heartbeat alive.\n",
   "models": [
     {
       "model_id": "openai/gpt-5-codex",
@@ -87,7 +87,6 @@ Agent connected and bearer token issued.
     "id": 7,
     "name": "AgentMC Demo Workspace"
   },
-  "heartbeat_interval_seconds": 300,
   "server_time": "2026-02-22T17:20:53Z",
   "first_sync_required": true
 }
@@ -165,7 +164,6 @@ const client = new AgentMCApi({
 
 const result = await client.operations.connectAgent({
   "body": {
-    "name": "openclaw-main",
     "host": "ip-10-0-3-42",
     "runtime_version": "2026.02.1",
     "capabilities": [
@@ -173,6 +171,7 @@ const result = await client.operations.connectAgent({
       "calendar",
       "realtime"
     ],
+    "agents_md": "# Existing AGENTS.md\n\n## Runtime\n- Keep heartbeat alive.\n",
     "models": [
       {
         "model_id": "openai/gpt-5-codex",
@@ -231,5 +230,5 @@ curl -X POST "https://agentmc.ai/api/v1/agents/connect" \\
   -H "Accept: application/json" \\
   -H "X-Connect-Token: $AGENTMC_CONNECT_TOKEN" \\
   -H "Content-Type: application/json" \\
-  --data-raw "{\"name\":\"openclaw-main\",\"host\":\"ip-10-0-3-42\",\"runtime_version\":\"2026.02.1\",\"capabilities\":[\"tasks\",\"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\",\"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\"}}}"
+  --data-raw "{\"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\"}}}"
 ```

package/docs/operations/index.json

@@ -932,7 +932,6 @@
       {
         "mediaType": "application/json",
         "example": {
-          "name": "openclaw-main",
           "host": "ip-10-0-3-42",
           "runtime_version": "2026.02.1",
           "capabilities": [
@@ -940,6 +939,7 @@
             "calendar",
             "realtime"
           ],
+          "agents_md": "# Existing AGENTS.md\n\n## Runtime\n- Keep heartbeat alive.\n",
           "models": [
             {
               "model_id": "openai/gpt-5-codex",
@@ -1001,7 +1001,6 @@
             "id": 7,
             "name": "AgentMC Demo Workspace"
           },
-          "heartbeat_interval_seconds": 300,
           "server_time": "2026-02-22T17:20:53Z",
           "first_sync_required": true
         }

package/examples/http/connectAgent.ts

@@ -6,7 +6,6 @@ const client = new AgentMCApi({
 
 const result = await client.operations.connectAgent({
   "body": {
-    "name": "openclaw-main",
     "host": "ip-10-0-3-42",
     "runtime_version": "2026.02.1",
     "capabilities": [
@@ -14,6 +13,7 @@ const result = await client.operations.connectAgent({
       "calendar",
       "realtime"
     ],
+    "agents_md": "# Existing AGENTS.md\n\n## Runtime\n- Keep heartbeat alive.\n",
     "models": [
       {
         "model_id": "openai/gpt-5-codex",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentmc/api",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "AgentMC API SDK, docs, and CLI for AI agents",
   "type": "module",
   "license": "MIT",

package/spec/openapi.filtered.json

@@ -38,7 +38,6 @@
                     "id": 7,
                     "name": "AgentMC Demo Workspace"
                   },
-                  "heartbeat_interval_seconds": 300,
                   "server_time": "2026-02-22T17:20:53Z",
                   "first_sync_required": true
                 }
@@ -5154,7 +5153,6 @@
           "agent_instructions_version",
           "openapi_url",
           "workspace",
-          "heartbeat_interval_seconds",
           "server_time",
           "first_sync_required"
         ],
@@ -5200,12 +5198,6 @@
               "name": "Example Name"
             }
           },
-          "heartbeat_interval_seconds": {
-            "type": "integer",
-            "minimum": 1,
-            "description": "Heartbeat interval seconds.",
-            "example": 1
-          },
           "server_time": {
             "type": "string",
             "format": "date-time",
@@ -5230,7 +5222,6 @@
             "id": 7,
             "name": "AgentMC Demo Workspace"
           },
-          "heartbeat_interval_seconds": 300,
           "server_time": "2026-02-22T17:20:53Z",
           "first_sync_required": true
         }
@@ -9829,12 +9820,6 @@
       "RegisterAgentApiRequest": {
         "type": "object",
         "properties": {
-          "name": {
-            "type": "string",
-            "maxLength": 255,
-            "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",
             "maxLength": 255,
@@ -9861,6 +9846,13 @@
               "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": [
@@ -9919,7 +9911,7 @@
           },
           "identity": {
             "nullable": true,
-            "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",
@@ -10086,7 +10078,7 @@
                 }
               },
               "identity": {
-                "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.",
                 "oneOf": [
                   {
                     "type": "object",
@@ -10143,15 +10135,14 @@
           }
         },
         "required": [
-          "name",
           "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": {
-          "name": "openclaw-main",
           "host": "ip-10-0-3-42",
           "runtime_version": "2026.02.1",
           "capabilities": [
@@ -10159,6 +10150,7 @@
             "calendar",
             "realtime"
           ],
+          "agents_md": "# Existing AGENTS.md\n\n## Runtime\n- Keep heartbeat alive.\n",
           "models": [
             {
               "model_id": "openai/gpt-5-codex",
@@ -11833,7 +11825,6 @@
               "$ref": "#/components/schemas/RegisterAgentApiRequest"
             },
             "example": {
-              "name": "openclaw-main",
               "host": "ip-10-0-3-42",
               "runtime_version": "2026.02.1",
               "capabilities": [
@@ -11841,6 +11832,7 @@
                 "calendar",
                 "realtime"
               ],
+              "agents_md": "# Existing AGENTS.md\n\n## Runtime\n- Keep heartbeat alive.\n",
               "models": [
                 {
                   "model_id": "openai/gpt-5-codex",
@@ -12275,7 +12267,6 @@
                 "id": 7,
                 "name": "AgentMC Demo Workspace"
               },
-              "heartbeat_interval_seconds": 300,
               "server_time": "2026-02-22T17:20:53Z",
               "first_sync_required": true
             }