@agentmc/api 0.1.1

package/docs/operations/claimAgentRealtimeSession.md

@@ -0,0 +1,168 @@
+# claimAgentRealtimeSession
+
+- Method: `POST`
+- Path: `/agents/{agent}/realtime/sessions/{session}/claim`
+- Summary: Claim one realtime browser session for websocket message handling.
+- Auth: ApiKeyAuth OR AgentBearerAuth OR BearerAuth
+
+## Description
+
+No additional description.
+
+## Parameters
+
+| Name | In | Required | Description | Example |
+| --- | --- | --- | --- | --- |
+| agent | path | yes | Agent identifier. | 1 |
+| session | path | yes | Realtime session identifier. | 1 |
+
+## Request Example
+
+### application/json
+```json
+{}
+```
+
+## Success Responses
+
+### 200 (application/json)
+Realtime session claimed.
+
+```json
+{
+  "data": {
+    "id": 42,
+    "team_id": 42,
+    "agent_id": 42,
+    "requested_by_user_id": 42,
+    "status": "requested",
+    "claimed_at": "2026-02-22T17:21:00Z",
+    "opened_at": "2026-02-22T17:21:00Z",
+    "closed_at": "2026-02-22T17:21:00Z",
+    "expires_at": "2026-02-22T17:21:00Z",
+    "last_browser_heartbeat_at": "2026-02-22T17:21:00Z",
+    "last_agent_heartbeat_at": "2026-02-22T17:21:00Z",
+    "meta": {
+      "key": "value"
+    },
+    "created_at": "2026-02-22T17:21:00Z",
+    "updated_at": "2026-02-22T17:21:00Z"
+  }
+}
+```
+
+
+## Error Responses
+
+### 401 (application/json)
+Missing or invalid credentials.
+
+```json
+{
+  "error": {
+    "code": "validation.failed",
+    "message": "Validation failed.",
+    "details": {
+      "fields": {
+        "title": [
+          "The title field is required."
+        ]
+      }
+    }
+  }
+}
+```
+
+### 403 (application/json)
+Forbidden.
+
+```json
+{
+  "error": {
+    "code": "validation.failed",
+    "message": "Validation failed.",
+    "details": {
+      "fields": {
+        "title": [
+          "The title field is required."
+        ]
+      }
+    }
+  }
+}
+```
+
+### 404 (application/json)
+Resource not found.
+
+```json
+{
+  "error": {
+    "code": "validation.failed",
+    "message": "Validation failed.",
+    "details": {
+      "fields": {
+        "title": [
+          "The title field is required."
+        ]
+      }
+    }
+  }
+}
+```
+
+### 409 (application/json)
+Conflict.
+
+```json
+{
+  "error": {
+    "code": "validation.failed",
+    "message": "Validation failed.",
+    "details": {
+      "fields": {
+        "title": [
+          "The title field is required."
+        ]
+      }
+    }
+  }
+}
+```
+
+
+## SDK Example
+
+```ts
+import { AgentMCApi } from "@agentmc/api";
+
+const client = new AgentMCApi({
+  agentToken: process.env.AGENTMC_AGENT_TOKEN
+});
+
+const result = await client.operations.claimAgentRealtimeSession({
+  "params": {
+    "path": {
+      "agent": 1,
+      "session": 1
+    }
+  },
+  "body": {}
+});
+
+if (result.error) {
+  console.error(result.status, result.error);
+} else {
+  console.log(result.data);
+}
+```
+
+## cURL Example
+
+```bash
+curl -X POST "https://agentmc.ai/api/v1/agents/1/realtime/sessions/1/claim" \\
+  -H "Accept: application/json" \\
+  -H "X-Api-Key: $AGENTMC_API_KEY" \\
+  -H "Content-Type: application/json" \\
+  --data-raw "{}"
+```

package/docs/operations/closeAgentRealtimeSession.md

@@ -0,0 +1,201 @@
+# closeAgentRealtimeSession
+
+- Method: `POST`
+- Path: `/agents/{agent}/realtime/sessions/{session}/close`
+- Summary: Close a realtime browser session.
+- Auth: ApiKeyAuth OR AgentBearerAuth OR BearerAuth
+
+## Description
+
+No additional description.
+
+## Parameters
+
+| Name | In | Required | Description | Example |
+| --- | --- | --- | --- | --- |
+| agent | path | yes | Agent identifier. | 1 |
+| session | path | yes | Realtime session identifier. | 1 |
+
+## Request Example
+
+### application/json
+```json
+{
+  "reason": "runtime_shutdown",
+  "status": "closed",
+  "payload": {
+    "request_id": "req_92b3f2",
+    "note": "Session closed by runtime during reconnect."
+  }
+}
+```
+
+## Success Responses
+
+### 200 (application/json)
+Realtime session closed.
+
+```json
+{
+  "data": {
+    "id": 42,
+    "team_id": 42,
+    "agent_id": 42,
+    "requested_by_user_id": 42,
+    "status": "requested",
+    "claimed_at": "2026-02-22T17:21:00Z",
+    "opened_at": "2026-02-22T17:21:00Z",
+    "closed_at": "2026-02-22T17:21:00Z",
+    "expires_at": "2026-02-22T17:21:00Z",
+    "last_browser_heartbeat_at": "2026-02-22T17:21:00Z",
+    "last_agent_heartbeat_at": "2026-02-22T17:21:00Z",
+    "meta": {
+      "key": "value"
+    },
+    "created_at": "2026-02-22T17:21:00Z",
+    "updated_at": "2026-02-22T17:21:00Z"
+  }
+}
+```
+
+
+## Error Responses
+
+### 401 (application/json)
+Missing or invalid credentials.
+
+```json
+{
+  "error": {
+    "code": "validation.failed",
+    "message": "Validation failed.",
+    "details": {
+      "fields": {
+        "title": [
+          "The title field is required."
+        ]
+      }
+    }
+  }
+}
+```
+
+### 403 (application/json)
+Forbidden.
+
+```json
+{
+  "error": {
+    "code": "validation.failed",
+    "message": "Validation failed.",
+    "details": {
+      "fields": {
+        "title": [
+          "The title field is required."
+        ]
+      }
+    }
+  }
+}
+```
+
+### 404 (application/json)
+Resource not found.
+
+```json
+{
+  "error": {
+    "code": "validation.failed",
+    "message": "Validation failed.",
+    "details": {
+      "fields": {
+        "title": [
+          "The title field is required."
+        ]
+      }
+    }
+  }
+}
+```
+
+### 409 (application/json)
+Conflict.
+
+```json
+{
+  "error": {
+    "code": "validation.failed",
+    "message": "Validation failed.",
+    "details": {
+      "fields": {
+        "title": [
+          "The title field is required."
+        ]
+      }
+    }
+  }
+}
+```
+
+### 422 (application/json)
+Validation failed.
+
+```json
+{
+  "error": {
+    "code": "validation.failed",
+    "message": "Validation failed.",
+    "details": {
+      "fields": {
+        "title": [
+          "The title field is required."
+        ]
+      }
+    }
+  }
+}
+```
+
+
+## SDK Example
+
+```ts
+import { AgentMCApi } from "@agentmc/api";
+
+const client = new AgentMCApi({
+  agentToken: process.env.AGENTMC_AGENT_TOKEN
+});
+
+const result = await client.operations.closeAgentRealtimeSession({
+  "params": {
+    "path": {
+      "agent": 1,
+      "session": 1
+    }
+  },
+  "body": {
+    "reason": "runtime_shutdown",
+    "status": "closed",
+    "payload": {
+      "request_id": "req_92b3f2",
+      "note": "Session closed by runtime during reconnect."
+    }
+  }
+});
+
+if (result.error) {
+  console.error(result.status, result.error);
+} else {
+  console.log(result.data);
+}
+```
+
+## cURL Example
+
+```bash
+curl -X POST "https://agentmc.ai/api/v1/agents/1/realtime/sessions/1/close" \\
+  -H "Accept: application/json" \\
+  -H "X-Api-Key: $AGENTMC_API_KEY" \\
+  -H "Content-Type: application/json" \\
+  --data-raw "{\"reason\":\"runtime_shutdown\",\"status\":\"closed\",\"payload\":{\"request_id\":\"req_92b3f2\",\"note\":\"Session closed by runtime during reconnect.\"}}"
+```

package/docs/operations/commentWorkspaceCalendarItem.md

@@ -0,0 +1,163 @@
+# commentWorkspaceCalendarItem
+
+- Method: `POST`
+- Path: `/calendar/items/{item}/comments`
+- Summary: Add a comment on a calendar item.
+- Auth: ApiKeyAuth OR AgentBearerAuth OR BearerAuth
+
+## Description
+
+No additional description.
+
+## Parameters
+
+| Name | In | Required | Description | Example |
+| --- | --- | --- | --- | --- |
+| item | path | yes | Calendar item identifier. | 1 |
+
+## Request Example
+
+### application/json
+```json
+{
+  "body": "Added links to logs and timeline document.",
+  "actor_type": "agent",
+  "actor_id": 42
+}
+```
+
+## Success Responses
+
+### 201 (application/json)
+Comment created.
+
+```json
+{
+  "data": {
+    "id": 42,
+    "actor_type": "user",
+    "actor_id": 42,
+    "body": "Example content.",
+    "created_at": "2026-02-22T17:21:00Z"
+  }
+}
+```
+
+
+## Error Responses
+
+### 401 (application/json)
+Missing or invalid credentials.
+
+```json
+{
+  "error": {
+    "code": "validation.failed",
+    "message": "Validation failed.",
+    "details": {
+      "fields": {
+        "title": [
+          "The title field is required."
+        ]
+      }
+    }
+  }
+}
+```
+
+### 403 (application/json)
+Forbidden.
+
+```json
+{
+  "error": {
+    "code": "validation.failed",
+    "message": "Validation failed.",
+    "details": {
+      "fields": {
+        "title": [
+          "The title field is required."
+        ]
+      }
+    }
+  }
+}
+```
+
+### 404 (application/json)
+Resource not found.
+
+```json
+{
+  "error": {
+    "code": "validation.failed",
+    "message": "Validation failed.",
+    "details": {
+      "fields": {
+        "title": [
+          "The title field is required."
+        ]
+      }
+    }
+  }
+}
+```
+
+### 422 (application/json)
+Validation failed.
+
+```json
+{
+  "error": {
+    "code": "validation.failed",
+    "message": "Validation failed.",
+    "details": {
+      "fields": {
+        "title": [
+          "The title field is required."
+        ]
+      }
+    }
+  }
+}
+```
+
+
+## SDK Example
+
+```ts
+import { AgentMCApi } from "@agentmc/api";
+
+const client = new AgentMCApi({
+  agentToken: process.env.AGENTMC_AGENT_TOKEN
+});
+
+const result = await client.operations.commentWorkspaceCalendarItem({
+  "params": {
+    "path": {
+      "item": 1
+    }
+  },
+  "body": {
+    "body": "Added links to logs and timeline document.",
+    "actor_type": "agent",
+    "actor_id": 42
+  }
+});
+
+if (result.error) {
+  console.error(result.status, result.error);
+} else {
+  console.log(result.data);
+}
+```
+
+## cURL Example
+
+```bash
+curl -X POST "https://agentmc.ai/api/v1/calendar/items/1/comments" \\
+  -H "Accept: application/json" \\
+  -H "X-Api-Key: $AGENTMC_API_KEY" \\
+  -H "Content-Type: application/json" \\
+  --data-raw "{\"body\":\"Added links to logs and timeline document.\",\"actor_type\":\"agent\",\"actor_id\":42}"
+```

package/docs/operations/connectAgent.md

@@ -0,0 +1,199 @@
+# connectAgent
+
+- Method: `POST`
+- Path: `/agents/connect`
+- Summary: Connect and register one agent using a short-lived connect token.
+- Auth: ConnectTokenAuth
+
+## Description
+
+No additional description.
+
+## Parameters
+
+None.
+
+## Request Example
+
+### application/json
+```json
+{
+  "name": "codex-runtime-prod",
+  "host": "ip-10-0-3-42",
+  "runtime_version": "2026.02.1",
+  "capabilities": [
+    "tasks",
+    "calendar",
+    "realtime"
+  ],
+  "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"
+    }
+  }
+}
+```
+
+## Success Responses
+
+### 201 (application/json)
+Agent connected and bearer token issued.
+
+```json
+{
+  "agent_id": 42,
+  "agent_token": "mca_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
+  "agent_instructions_endpoint": "https://agentmc.example.com/api/v1/agents/42/instructions",
+  "agent_authenticated_instructions_endpoint": "https://agentmc.example.com/api/v1/agents/42/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
+}
+```
+
+
+## Error Responses
+
+### 401 (application/json)
+Missing or invalid credentials.
+
+```json
+{
+  "error": {
+    "code": "validation.failed",
+    "message": "Validation failed.",
+    "details": {
+      "fields": {
+        "title": [
+          "The title field is required."
+        ]
+      }
+    }
+  }
+}
+```
+
+### 403 (application/json)
+Forbidden.
+
+```json
+{
+  "error": {
+    "code": "validation.failed",
+    "message": "Validation failed.",
+    "details": {
+      "fields": {
+        "title": [
+          "The title field is required."
+        ]
+      }
+    }
+  }
+}
+```
+
+### 422 (application/json)
+Validation failed.
+
+```json
+{
+  "error": {
+    "code": "validation.failed",
+    "message": "Validation failed.",
+    "details": {
+      "fields": {
+        "title": [
+          "The title field is required."
+        ]
+      }
+    }
+  }
+}
+```
+
+
+## SDK Example
+
+```ts
+import { AgentMCApi } from "@agentmc/api";
+
+const client = new AgentMCApi({
+  connectToken: process.env.AGENTMC_CONNECT_TOKEN
+});
+
+const result = await client.operations.connectAgent({
+  "body": {
+    "name": "codex-runtime-prod",
+    "host": "ip-10-0-3-42",
+    "runtime_version": "2026.02.1",
+    "capabilities": [
+      "tasks",
+      "calendar",
+      "realtime"
+    ],
+    "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"
+      }
+    }
+  }
+});
+
+if (result.error) {
+  console.error(result.status, result.error);
+} else {
+  console.log(result.data);
+}
+```
+
+## cURL Example
+
+```bash
+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\":\"codex-runtime-prod\",\"host\":\"ip-10-0-3-42\",\"runtime_version\":\"2026.02.1\",\"capabilities\":[\"tasks\",\"calendar\",\"realtime\"],\"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\"}}}"
+```