@agentmc/api 0.2.3 → 0.2.4

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",
@@ -165,7 +165,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 +172,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 +231,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",

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.4",
   "description": "AgentMC API SDK, docs, and CLI for AI agents",
   "type": "module",
   "license": "MIT",

package/spec/openapi.filtered.json

@@ -9829,12 +9829,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 +9855,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 +9920,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 +10087,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 +10144,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 +10159,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 +11834,6 @@
               "$ref": "#/components/schemas/RegisterAgentApiRequest"
             },
             "example": {
-              "name": "openclaw-main",
               "host": "ip-10-0-3-42",
               "runtime_version": "2026.02.1",
               "capabilities": [
@@ -11841,6 +11841,7 @@
                 "calendar",
                 "realtime"
               ],
+              "agents_md": "# Existing AGENTS.md\n\n## Runtime\n- Keep heartbeat alive.\n",
               "models": [
                 {
                   "model_id": "openai/gpt-5-codex",