@agentmc/api 0.2.5 → 0.2.8

package/dist/index.d.ts

@@ -6,32 +6,18 @@ export { operationsById } from './generated/operations.js';
  * Do not make direct changes to the file.
  */
 interface paths {
-    "/agents/connect": {
+    "/agents/instructions": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get?: never;
-        put?: never;
-        /** Connect and register one agent using a short-lived connect token. */
-        post: operations["connectAgent"];
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/agents/{agent}/agent-instructions": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /** Return agent instructions for a connected agent using bearer auth. */
-        get: operations["agentInstructions"];
+        /**
+         * 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.
+         */
+        get: operations["getAgentInstructions"];
         put?: never;
         post?: never;
         delete?: never;
@@ -699,7 +685,7 @@ interface components {
          *           "active": true
          *         }
          *       ],
-         *       "path": "example",
+         *       "path": ".agentmc/skills/skill.md",
          *       "per_page": 25,
          *       "total": 0
          *     }
@@ -732,8 +718,8 @@ interface components {
              */
             links?: components["schemas"]["PaginationMetaLink"][];
             /**
-             * @description Path.
-             * @example example
+             * @description Local filesystem path where this file should be written.
+             * @example .agentmc/skills/skill.md
              */
             path: string;
             /**
@@ -877,7 +863,7 @@ interface components {
          *             "active": true
          *           }
          *         ],
-         *         "path": "example",
+         *         "path": ".agentmc/skills/skill.md",
          *         "per_page": 25,
          *         "total": 0
          *       }
@@ -921,7 +907,7 @@ interface components {
              *           "active": true
              *         }
              *       ],
-             *       "path": "example",
+             *       "path": ".agentmc/skills/skill.md",
              *       "per_page": 25,
              *       "total": 0
              *     }
@@ -977,7 +963,6 @@ interface components {
          *         ]
          *       },
          *       "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"
@@ -1056,12 +1041,6 @@ interface components {
              * @example 2026-02-22T17:21:00Z
              */
             last_seen_at: string | null;
-            /**
-             * Format: date-time
-             * @description ISO-8601 timestamp when this agent first completed initial sync.
-             * @example 2026-02-22T17:21:00Z
-             */
-            first_sync_at: string | null;
             /**
              * @description Count of tasks currently assigned to this agent.
              * @example 0
@@ -1112,7 +1091,6 @@ interface components {
          *             ]
          *           },
          *           "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"
@@ -1135,7 +1113,7 @@ interface components {
          *             "active": true
          *           }
          *         ],
-         *         "path": "example",
+         *         "path": ".agentmc/skills/skill.md",
          *         "per_page": 25,
          *         "total": 0
          *       }
@@ -1173,7 +1151,6 @@ interface components {
              *           ]
              *         },
              *         "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"
@@ -1204,7 +1181,7 @@ interface components {
              *           "active": true
              *         }
              *       ],
-             *       "path": "example",
+             *       "path": ".agentmc/skills/skill.md",
              *       "per_page": 25,
              *       "total": 0
              *     }
@@ -1266,129 +1243,6 @@ interface components {
                 [key: string]: unknown;
             };
         };
-        /**
-         * @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"
-         *       },
-         *       "server_time": "2026-02-22T17:20:53Z",
-         *       "first_sync_required": true
-         *     }
-         */
-        AgentRegisterResponse: {
-            /**
-             * @description Identifier for agent.
-             * @example 42
-             */
-            agent_id: number;
-            /**
-             * @description Bearer token to use in `Authorization: Bearer <token>` headers.
-             * @example mca_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-             */
-            agent_token: string;
-            /**
-             * Format: uri
-             * @description Endpoint for agent instructions updates.
-             * @example https://agentmc.example.com/resource
-             */
-            agent_instructions_endpoint: string;
-            /**
-             * Format: uri
-             * @description Authenticated endpoint for agent instructions updates.
-             * @example https://agentmc.example.com/resource
-             */
-            agent_authenticated_instructions_endpoint: string;
-            /**
-             * @description Agent instructions version.
-             * @example example
-             */
-            agent_instructions_version: string;
-            /**
-             * @description Canonical OpenAPI specification URL.
-             * @example https://agentmc.example.com/api/openapi.json
-             */
-            openapi_url: string;
-            /**
-             * @description Workspace.
-             * @example {
-             *       "id": 42,
-             *       "name": "Example Name"
-             *     }
-             */
-            workspace: components["schemas"]["TeamSummary"];
-            /**
-             * Format: date-time
-             * @description Current server timestamp.
-             * @example 2026-02-22T17:21:00Z
-             */
-            server_time: string;
-            /**
-             * @description Boolean flag for first sync required.
-             * @example true
-             */
-            first_sync_required: boolean;
-        };
-        /**
-         * @description Connected agent instructions payload returned after successful bearer authentication.
-         * @example {
-         *       "agent_instructions": "# Agent Instructions",
-         *       "agent_instructions_version": "32fe7fd14fca2d57c545f5f78f4a1c094f9ac1b3a1e8f6f9f8323b67a0ef9cc3",
-         *       "docs": [],
-         *       "schedules": [],
-         *       "config": {}
-         *     }
-         */
-        AgentInstructionsResponse: {
-            /**
-             * @description Agent instructions.
-             * @example example
-             */
-            agent_instructions: string;
-            /**
-             * @description Agent instructions version.
-             * @example example
-             */
-            agent_instructions_version: string;
-            /**
-             * @description Docs.
-             * @example [
-             *       {
-             *         "key": "value"
-             *       }
-             *     ]
-             */
-            docs: {
-                [key: string]: unknown;
-            }[];
-            /**
-             * @description Schedules.
-             * @example [
-             *       {
-             *         "key": "value"
-             *       }
-             *     ]
-             */
-            schedules: {
-                [key: string]: unknown;
-            }[];
-            /**
-             * @description Config.
-             * @example {
-             *       "key": "value"
-             *     }
-             */
-            config: {
-                [key: string]: unknown;
-            };
-        };
         /**
          * @description Heartbeat acknowledgement with optional resolved host record when runtime payload is provided.
          * @example {
@@ -2111,7 +1965,7 @@ interface components {
          *             "active": true
          *           }
          *         ],
-         *         "path": "example",
+         *         "path": ".agentmc/skills/skill.md",
          *         "per_page": 25,
          *         "total": 0
          *       }
@@ -2202,7 +2056,7 @@ interface components {
              *           "active": true
              *         }
              *       ],
-             *       "path": "example",
+             *       "path": ".agentmc/skills/skill.md",
              *       "per_page": 25,
              *       "total": 0
              *     }
@@ -2383,7 +2237,7 @@ interface components {
              *         "host": "ip-10-0-3-42",
              *         "port": 1,
              *         "scheme": "example",
-             *         "path": "example"
+             *         "path": ".agentmc/skills/skill.md"
              *       },
              *       "channel": "example",
              *       "event": "example",
@@ -2400,7 +2254,7 @@ interface components {
                  *       "host": "ip-10-0-3-42",
                  *       "port": 1,
                  *       "scheme": "example",
-                 *       "path": "example"
+                 *       "path": ".agentmc/skills/skill.md"
                  *     }
                  */
                 connection: {
@@ -2435,8 +2289,8 @@ interface components {
                      */
                     scheme: string;
                     /**
-                     * @description Path.
-                     * @example example
+                     * @description Local filesystem path where this file should be written.
+                     * @example .agentmc/skills/skill.md
                      */
                     path: string;
                 };
@@ -3689,6 +3543,128 @@ interface components {
              */
             agents_meta: components["schemas"]["HostAgentsMeta"];
         };
+        /**
+         * @description Agent Instruction File schema.
+         * @example {
+         *       "id": "example",
+         *       "path": ".agentmc/skills/skill.md",
+         *       "content": "Example content.",
+         *       "sha256": "f96c95bd27dc9f3415cc0f4d817b5ec6f14185b6fcb5db9f6b6f14f648f8e9e4"
+         *     }
+         */
+        AgentInstructionFile: {
+            /**
+             * @description Unique identifier for this record.
+             * @example example
+             */
+            id: string;
+            /**
+             * @description Local filesystem path where this file should be written.
+             * @example .agentmc/skills/skill.md
+             */
+            path: string;
+            /**
+             * @description Content.
+             * @example Example content.
+             */
+            content: string;
+            /**
+             * @description SHA-256 checksum for file content.
+             * @example f96c95bd27dc9f3415cc0f4d817b5ec6f14185b6fcb5db9f6b6f14f648f8e9e4
+             */
+            sha256: string;
+        };
+        /**
+         * @description Agent Instructions Response response schema.
+         * @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"
+         *         }
+         *       ]
+         *     }
+         */
+        AgentInstructionsResponse: {
+            /**
+             * @description Boolean flag for ok.
+             * @example true
+             */
+            ok: boolean;
+            /**
+             * @description True when the runtime should rewrite local managed files from this response.
+             * @example true
+             */
+            changed: boolean;
+            /**
+             * @description Current instruction bundle version.
+             * @example bundle_2fa07fcadd6575cc
+             */
+            bundle_version: string;
+            /**
+             * Format: date-time
+             * @description ISO-8601 generation timestamp.
+             * @example 2026-02-22T17:21:00Z
+             */
+            generated_at: string;
+            /**
+             * @description Defaults.
+             * @example {
+             *       "heartbeat_interval_seconds": 5
+             *     }
+             */
+            defaults: {
+                /**
+                 * @description Heartbeat interval seconds.
+                 * @example 5
+                 */
+                heartbeat_interval_seconds: number;
+            };
+            /**
+             * @description Agent.
+             * @example {
+             *       "id": 42,
+             *       "name": "Example Name"
+             *     }
+             */
+            agent: {
+                /**
+                 * @description Unique identifier for this record.
+                 * @example 42
+                 */
+                id: number;
+                /**
+                 * @description Human-readable name.
+                 * @example Example Name
+                 */
+                name: string;
+            };
+            /**
+             * @description Managed instruction bundle files to write locally.
+             * @example [
+             *       {
+             *         "id": "example",
+             *         "path": ".agentmc/skills/skill.md",
+             *         "content": "Example content.",
+             *         "sha256": "f96c95bd27dc9f3415cc0f4d817b5ec6f14185b6fcb5db9f6b6f14f648f8e9e4"
+             *       }
+             *     ]
+             */
+            files: components["schemas"]["AgentInstructionFile"][];
+        };
         /**
          * @description Agent Realtime Requested Sessions Response response schema.
          * @example {
@@ -4450,7 +4426,7 @@ interface components {
          *             "active": true
          *           }
          *         ],
-         *         "path": "example",
+         *         "path": ".agentmc/skills/skill.md",
          *         "per_page": 25,
          *         "total": 0
          *       }
@@ -4497,7 +4473,7 @@ interface components {
              *           "active": true
              *         }
              *       ],
-             *       "path": "example",
+             *       "path": ".agentmc/skills/skill.md",
              *       "per_page": 25,
              *       "total": 0
              *     }
@@ -4543,7 +4519,7 @@ interface components {
          *             "active": true
          *           }
          *         ],
-         *         "path": "example",
+         *         "path": ".agentmc/skills/skill.md",
          *         "per_page": 25,
          *         "total": 0
          *       }
@@ -4596,7 +4572,7 @@ interface components {
              *           "active": true
              *         }
              *       ],
-             *       "path": "example",
+             *       "path": ".agentmc/skills/skill.md",
              *       "per_page": 25,
              *       "total": 0
              *     }
@@ -4645,7 +4621,7 @@ interface components {
          *             "active": true
          *           }
          *         ],
-         *         "path": "example",
+         *         "path": ".agentmc/skills/skill.md",
          *         "per_page": 25,
          *         "total": 0
          *       }
@@ -4701,7 +4677,7 @@ interface components {
              *           "active": true
              *         }
              *       ],
-             *       "path": "example",
+             *       "path": ".agentmc/skills/skill.md",
              *       "per_page": 25,
              *       "total": 0
              *     }
@@ -4743,7 +4719,7 @@ interface components {
          *             "active": true
          *           }
          *         ],
-         *         "path": "example",
+         *         "path": ".agentmc/skills/skill.md",
          *         "per_page": 25,
          *         "total": 0
          *       }
@@ -4792,7 +4768,7 @@ interface components {
              *           "active": true
              *         }
              *       ],
-             *       "path": "example",
+             *       "path": ".agentmc/skills/skill.md",
              *       "per_page": 25,
              *       "total": 0
              *     }
@@ -4853,7 +4829,7 @@ interface components {
          *             "active": true
          *           }
          *         ],
-         *         "path": "example",
+         *         "path": ".agentmc/skills/skill.md",
          *         "per_page": 25,
          *         "total": 0
          *       }
@@ -4921,7 +4897,7 @@ interface components {
              *           "active": true
              *         }
              *       ],
-             *       "path": "example",
+             *       "path": ".agentmc/skills/skill.md",
              *       "per_page": 25,
              *       "total": 0
              *     }
@@ -4975,7 +4951,7 @@ interface components {
          *             "active": true
          *           }
          *         ],
-         *         "path": "example",
+         *         "path": ".agentmc/skills/skill.md",
          *         "per_page": 25,
          *         "total": 0
          *       }
@@ -5036,7 +5012,7 @@ interface components {
              *           "active": true
              *         }
              *       ],
-             *       "path": "example",
+             *       "path": ".agentmc/skills/skill.md",
              *       "per_page": 25,
              *       "total": 0
              *     }
@@ -5096,7 +5072,7 @@ interface components {
          *             "active": true
          *           }
          *         ],
-         *         "path": "example",
+         *         "path": ".agentmc/skills/skill.md",
          *         "per_page": 25,
          *         "total": 0
          *       }
@@ -5163,7 +5139,7 @@ interface components {
              *           "active": true
              *         }
              *       ],
-             *       "path": "example",
+             *       "path": ".agentmc/skills/skill.md",
              *       "per_page": 25,
              *       "total": 0
              *     }
@@ -5223,291 +5199,6 @@ interface components {
                 [key: string]: unknown;
             }[]) | null;
         };
-        /**
-         * @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"
-         *         }
-         *       }
-         *     }
-         */
-        RegisterAgentApiRequest: {
-            /**
-             * @description Runtime host identifier (hostname or machine name).
-             * @example ip-10-0-3-42
-             */
-            host: string;
-            /**
-             * @description Required runtime/client version string for diagnostics.
-             * @example 2026.02.1
-             */
-            runtime_version: string;
-            /**
-             * @description Required (nullable) capability tags supported by this runtime.
-             * @example [
-             *       "tasks",
-             *       "calendar",
-             *       "realtime"
-             *     ]
-             */
-            capabilities: string[] | null;
-            /**
-             * @description Required current local AGENTS.md content captured by the runtime before first sync.
-             * @example # Existing AGENTS.md
-             *
-             *     ## Runtime
-             *     - Keep heartbeat alive.
-             */
-            agents_md: string;
-            /**
-             * @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"
-             *       }
-             *     ]
-             */
-            models?: ((string | {
-                /**
-                 * @description Full model ID in provider/model format.
-                 * @example openai/gpt-5-codex
-                 */
-                model_id: string;
-                /**
-                 * @description Model provider slug.
-                 * @example openai
-                 */
-                provider?: string;
-                /**
-                 * @description Optional display name.
-                 * @example GPT-5 Codex
-                 */
-                name?: string;
-            })[] | {
-                [key: string]: unknown;
-            }) | null;
-            /**
-             * @description Optional full agent identity payload persisted in agent metadata.
-             * @example {
-             *       "name": "Jarvis",
-             *       "creature": "robot",
-             *       "vibe": "calm",
-             *       "emoji": "🤖"
-             *     }
-             */
-            identity?: unknown;
-            /**
-             * @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"
-             *       }
-             *     }
-             */
-            metadata: {
-                /**
-                 * @description Hostname.
-                 * @example Example Name
-                 */
-                hostname: string;
-                /**
-                 * Format: ipv4
-                 * @description Ip.
-                 * @example example
-                 */
-                ip: string;
-                /**
-                 * @description Network.
-                 * @example {
-                 *       "private_ip": "example",
-                 *       "public_ip": "example"
-                 *     }
-                 */
-                network: {
-                    /**
-                     * Format: ipv4
-                     * @description Private ip.
-                     * @example example
-                     */
-                    private_ip: string;
-                    /**
-                     * Format: ipv4
-                     * @description Public ip.
-                     * @example example
-                     */
-                    public_ip: string;
-                };
-                /**
-                 * @description Os.
-                 * @example example
-                 */
-                os: string;
-                /**
-                 * @description Os version.
-                 * @example example
-                 */
-                os_version: string;
-                /**
-                 * @description Arch.
-                 * @example example
-                 */
-                arch: string;
-                /**
-                 * @description Cpu.
-                 * @example example
-                 */
-                cpu: string | {
-                    [key: string]: unknown;
-                };
-                /**
-                 * @description Cpu cores.
-                 * @example 8
-                 */
-                cpu_cores: number;
-                /**
-                 * @description Ram gb.
-                 * @example 32
-                 */
-                ram_gb: number;
-                /**
-                 * @description Disk.
-                 * @example {
-                 *       "total_bytes": 0,
-                 *       "free_bytes": 0
-                 *     }
-                 */
-                disk: {
-                    /**
-                     * @description Total bytes.
-                     * @example 0
-                     */
-                    total_bytes: number;
-                    /**
-                     * @description Free bytes.
-                     * @example 0
-                     */
-                    free_bytes: number;
-                };
-                /**
-                 * @description Uptime seconds.
-                 * @example 86400
-                 */
-                uptime_seconds: number;
-                /**
-                 * @description Runtime.
-                 * @example {
-                 *       "name": "Example Name",
-                 *       "version": "example"
-                 *     }
-                 */
-                runtime: {
-                    /**
-                     * @description Human-readable name.
-                     * @example Example Name
-                     */
-                    name: string;
-                    /**
-                     * @description Version.
-                     * @example example
-                     */
-                    version: string;
-                };
-                /**
-                 * @description Optional identity payload persisted as host metadata.
-                 * @example {
-                 *       "name": "Jarvis"
-                 *     }
-                 */
-                identity?: ({
-                    /**
-                     * @description Human-readable name.
-                     * @example Jarvis
-                     */
-                    name?: string;
-                } & {
-                    [key: string]: unknown;
-                }) | string;
-            } & {
-                [key: string]: unknown;
-            };
-        };
         /**
          * @description Heartbeat payload that accepts liveness pings and optional host + runtime state.
          * @example {
@@ -6612,49 +6303,6 @@ interface components {
         };
     };
     responses: {
-        /** @description Agent registered and bearer token issued. */
-        AgentRegisterResponse: {
-            headers: {
-                [name: string]: unknown;
-            };
-            content: {
-                /**
-                 * @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
-                 *     }
-                 */
-                "application/json": components["schemas"]["AgentRegisterResponse"];
-            };
-        };
-        /** @description Agent instructions returned. */
-        AgentInstructionsResponse: {
-            headers: {
-                [name: string]: unknown;
-            };
-            content: {
-                /**
-                 * @example {
-                 *       "agent_instructions": "# Agent Instructions",
-                 *       "agent_instructions_version": "32fe7fd14fca2d57c545f5f78f4a1c094f9ac1b3a1e8f6f9f8323b67a0ef9cc3",
-                 *       "docs": [],
-                 *       "schedules": [],
-                 *       "config": {}
-                 *     }
-                 */
-                "application/json": components["schemas"]["AgentInstructionsResponse"];
-            };
-        };
         /** @description Heartbeat accepted. */
         AgentHeartbeatResponse: {
             headers: {
@@ -6910,7 +6558,7 @@ interface components {
                  *             "active": true
                  *           }
                  *         ],
-                 *         "path": "example",
+                 *         "path": ".agentmc/skills/skill.md",
                  *         "per_page": 25,
                  *         "total": 0
                  *       }
@@ -7087,6 +6735,38 @@ interface components {
                 "application/json": components["schemas"]["AgentRealtimeSocketAuthResponse"];
             };
         };
+        /** @description Instruction bundle returned. */
+        AgentInstructionsResponse: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                /**
+                 * @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"
+                 *         }
+                 *       ]
+                 *     }
+                 */
+                "application/json": components["schemas"]["AgentInstructionsResponse"];
+            };
+        };
         /** @description Host returned. */
         HostDetailResponse: {
             headers: {
@@ -7318,64 +6998,6 @@ interface components {
                 "application/json": components["schemas"]["CloseAgentRealtimeSessionApiRequest"];
             };
         };
-        RegisterAgentApiRequest: {
-            content: {
-                /**
-                 * @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"
-                 *         }
-                 *       }
-                 *     }
-                 */
-                "application/json": components["schemas"]["RegisterAgentApiRequest"];
-            };
-        };
         StoreAgentHeartbeatApiRequest: {
             content: {
                 /**
@@ -7697,61 +7319,22 @@ interface components {
     pathItems: never;
 }
 interface operations {
-    connectAgent: {
+    getAgentInstructions: {
         parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody: components["requestBodies"]["RegisterAgentApiRequest"];
-        responses: {
-            /** @description Agent connected and bearer token issued. */
-            201: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    /**
-                     * @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
-                     *     }
-                     */
-                    "application/json": components["schemas"]["AgentRegisterResponse"];
-                };
-            };
-            401: components["responses"]["ApiError401"];
-            403: components["responses"]["ApiError403"];
-            422: components["responses"]["ApiError422"];
-        };
-    };
-    agentInstructions: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path: {
+            query?: {
                 /**
-                 * @description Agent identifier.
-                 * @example 1
+                 * @description Last applied instruction bundle version from local runtime state.
+                 * @example bundle_2fa07fcadd6575cc
                  */
-                agent: number;
+                current_bundle_version?: string;
             };
+            header?: never;
+            path?: never;
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description Agent instructions returned. */
+            /** @description Instruction bundle returned. */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -7759,11 +7342,25 @@ interface operations {
                 content: {
                     /**
                      * @example {
-                     *       "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"
+                     *         }
+                     *       ]
                      *     }
                      */
                     "application/json": components["schemas"]["AgentInstructionsResponse"];
@@ -7771,7 +7368,7 @@ interface operations {
             };
             401: components["responses"]["ApiError401"];
             403: components["responses"]["ApiError403"];
-            404: components["responses"]["ApiError404"];
+            422: components["responses"]["ApiError422"];
         };
     };
     agentHeartbeat: {
@@ -7975,7 +7572,7 @@ interface operations {
                      *             "active": true
                      *           }
                      *         ],
-                     *         "path": "example",
+                     *         "path": ".agentmc/skills/skill.md",
                      *         "per_page": 25,
                      *         "total": 0
                      *       }
@@ -8184,7 +7781,7 @@ interface operations {
                      *             "active": true
                      *           }
                      *         ],
-                     *         "path": "example",
+                     *         "path": ".agentmc/skills/skill.md",
                      *         "per_page": 25,
                      *         "total": 0
                      *       }
@@ -8863,7 +8460,7 @@ interface operations {
                      *             "active": true
                      *           }
                      *         ],
-                     *         "path": "example",
+                     *         "path": ".agentmc/skills/skill.md",
                      *         "per_page": 25,
                      *         "total": 0
                      *       }
@@ -9280,7 +8877,7 @@ interface operations {
                      *             "active": true
                      *           }
                      *         ],
-                     *         "path": "example",
+                     *         "path": ".agentmc/skills/skill.md",
                      *         "per_page": 25,
                      *         "total": 0
                      *       }
@@ -9556,7 +9153,7 @@ interface operations {
                      *             "active": true
                      *           }
                      *         ],
-                     *         "path": "example",
+                     *         "path": ".agentmc/skills/skill.md",
                      *         "per_page": 25,
                      *         "total": 0
                      *       }
@@ -9781,7 +9378,6 @@ interface 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"
@@ -9804,7 +9400,7 @@ interface operations {
                      *             "active": true
                      *           }
                      *         ],
-                     *         "path": "example",
+                     *         "path": ".agentmc/skills/skill.md",
                      *         "per_page": 25,
                      *         "total": 0
                      *       }
@@ -9872,7 +9468,7 @@ interface operations {
                      *             "active": true
                      *           }
                      *         ],
-                     *         "path": "example",
+                     *         "path": ".agentmc/skills/skill.md",
                      *         "per_page": 25,
                      *         "total": 0
                      *       }
@@ -9940,7 +9536,7 @@ interface operations {
                      *             "active": true
                      *           }
                      *         ],
-                     *         "path": "example",
+                     *         "path": ".agentmc/skills/skill.md",
                      *         "per_page": 25,
                      *         "total": 0
                      *       }
@@ -10031,7 +9627,7 @@ interface operations {
                      *             "active": true
                      *           }
                      *         ],
-                     *         "path": "example",
+                     *         "path": ".agentmc/skills/skill.md",
                      *         "per_page": 25,
                      *         "total": 0
                      *       }
@@ -10263,7 +9859,7 @@ interface operations {
                      *             "active": true
                      *           }
                      *         ],
-                     *         "path": "example",
+                     *         "path": ".agentmc/skills/skill.md",
                      *         "per_page": 25,
                      *         "total": 0
                      *       }