@agentmc/api 0.1.1

package/docs/operations/workspaceCalendar.md

@@ -0,0 +1,185 @@
+# workspaceCalendar
+
+- Method: `GET`
+- Path: `/calendar`
+- Summary: List calendar items.
+- Auth: ApiKeyAuth OR AgentBearerAuth OR BearerAuth
+
+## Description
+
+No additional description.
+
+## Parameters
+
+| Name | In | Required | Description | Example |
+| --- | --- | --- | --- | --- |
+| view | query | no | Allowed values: month, week, list. | "month" |
+| start | query | no | Start. | "2026-02-22T17:21:00Z" |
+| end | query | no | End. | "2026-02-22T17:21:00Z" |
+| type | query | no | Type discriminator for this record. Allowed values: event, task. | "event" |
+| status | query | no | Current lifecycle status for this record. Allowed values: todo, in_progress, blocked, done, canceled. | "todo" |
+| priority | query | no | Priority level for this record. Allowed values: low, medium, high, urgent. | "low" |
+| assignee | query | no | Assignee. | "example" |
+| q | query | no | Case-insensitive text search query. | "retro" |
+| per_page | query | no | Page size for paginated responses. | 25 |
+
+## Request Example
+
+None.
+
+## Success Responses
+
+### 200 (application/json)
+Calendar items returned.
+
+```json
+{
+  "data": [
+    {
+      "id": 42,
+      "workspace_id": 42,
+      "type": "event",
+      "title": "Example Title",
+      "description": "Example description text.",
+      "start_at": "2026-02-22T17:21:00Z",
+      "end_at": "2026-02-22T17:21:00Z",
+      "due_at": "2026-02-22T17:21:00Z",
+      "all_day": false,
+      "location": "example",
+      "timezone": "America/Los_Angeles",
+      "status": "todo",
+      "priority": "low",
+      "visibility": "workspace",
+      "created_by": 1,
+      "updated_by": 1,
+      "assignees": [
+        {
+          "id": 42,
+          "assignee_type": "user",
+          "assignee_id": 42,
+          "role": "owner",
+          "name": "Example Name",
+          "created_at": "2026-02-22T17:21:00Z"
+        }
+      ],
+      "links": [
+        {
+          "id": 42,
+          "link_type": "example",
+          "link_id": 42,
+          "url": "https://agentmc.example.com/docs/incident-123",
+          "title": "Example Title",
+          "created_at": "2026-02-22T17:21:00Z"
+        }
+      ],
+      "comments_count": 1,
+      "created_at": "2026-02-22T17:21:00Z",
+      "updated_at": "2026-02-22T17:21:00Z",
+      "deleted_at": "2026-02-22T17:21:00Z"
+    }
+  ],
+  "links": {
+    "first": "example",
+    "last": "example",
+    "prev": "example",
+    "next": "example"
+  },
+  "meta": {
+    "current_page": 1,
+    "from": 1,
+    "last_page": 1,
+    "links": [
+      {
+        "url": "https://agentmc.example.com/docs/incident-123",
+        "label": "example",
+        "active": true
+      }
+    ],
+    "path": "example",
+    "per_page": 25,
+    "total": 0
+  }
+}
+```
+
+
+## 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."
+        ]
+      }
+    }
+  }
+}
+```
+
+
+## SDK Example
+
+```ts
+import { AgentMCApi } from "@agentmc/api";
+
+const client = new AgentMCApi({
+  agentToken: process.env.AGENTMC_AGENT_TOKEN
+});
+
+const result = await client.operations.workspaceCalendar({
+  "params": {
+    "query": {
+      "view": "month",
+      "start": "2026-02-22T17:21:00Z",
+      "end": "2026-02-22T17:21:00Z",
+      "type": "event",
+      "status": "todo",
+      "priority": "low",
+      "assignee": "example",
+      "q": "retro",
+      "per_page": 25
+    }
+  }
+});
+
+if (result.error) {
+  console.error(result.status, result.error);
+} else {
+  console.log(result.data);
+}
+```
+
+## cURL Example
+
+```bash
+curl -X GET "https://agentmc.ai/api/v1/calendar?view=month&start=2026-02-22T17%3A21%3A00Z&end=2026-02-22T17%3A21%3A00Z&type=event&status=todo&priority=low&assignee=example&q=retro&per_page=25" \\
+  -H "Accept: application/json" \\
+  -H "X-Api-Key: $AGENTMC_API_KEY"
+```

package/examples/http/agentConnectedInstructions.ts

@@ -0,0 +1,19 @@
+import { AgentMCApi } from "@agentmc/api";
+
+const client = new AgentMCApi({
+  agentToken: process.env.AGENTMC_AGENT_TOKEN
+});
+
+const result = await client.operations.agentConnectedInstructions({
+  "params": {
+    "path": {
+      "agent": 1
+    }
+  }
+});
+
+if (result.error) {
+  console.error(result.status, result.error);
+} else {
+  console.log(result.data);
+}

package/examples/http/agentHeartbeat.ts

@@ -0,0 +1,67 @@
+import { AgentMCApi } from "@agentmc/api";
+
+const client = new AgentMCApi({
+  agentToken: process.env.AGENTMC_AGENT_TOKEN
+});
+
+const result = await client.operations.agentHeartbeat({
+  "params": {
+    "path": {
+      "agent": 1
+    }
+  },
+  "body": {
+    "status": "online",
+    "meta": {
+      "uptime_seconds": 43200,
+      "queue_depth": 2
+    },
+    "host": {
+      "fingerprint": "a3f56f330f311a2159f8c101eaf1439a29f1d57f007375d56aa79f304bc4f112",
+      "name": "worker-01",
+      "meta": {
+        "hostname": "worker-01",
+        "ip": "10.0.2.15",
+        "network": {
+          "private_ip": "10.0.2.15",
+          "public_ip": "34.222.10.10"
+        },
+        "os": "Ubuntu",
+        "os_version": "24.04",
+        "arch": "x86_64",
+        "cpu": "Intel Xeon",
+        "cpu_cores": 8,
+        "ram_gb": 32,
+        "disk": {
+          "total_bytes": 536870912000,
+          "free_bytes": 322122547200
+        },
+        "uptime_seconds": 86400,
+        "runtime": {
+          "name": "codex",
+          "version": "2026.02.1"
+        }
+      }
+    },
+    "agent": {
+      "id": 42,
+      "name": "codex-runtime-prod",
+      "models": [
+        {
+          "model_id": "openai/gpt-5-codex",
+          "provider": "openai"
+        },
+        {
+          "model_id": "anthropic/claude-sonnet-4-20250514",
+          "provider": "anthropic"
+        }
+      ]
+    }
+  }
+});
+
+if (result.error) {
+  console.error(result.status, result.error);
+} else {
+  console.log(result.data);
+}

package/examples/http/authenticateAgentRealtimeSocket.ts

@@ -0,0 +1,24 @@
+import { AgentMCApi } from "@agentmc/api";
+
+const client = new AgentMCApi({
+  agentToken: process.env.AGENTMC_AGENT_TOKEN
+});
+
+const result = await client.operations.authenticateAgentRealtimeSocket({
+  "params": {
+    "path": {
+      "agent": 1,
+      "session": 1
+    }
+  },
+  "body": {
+    "socket_id": "1234.567890",
+    "channel_name": "private-agent-realtime.7.42"
+  }
+});
+
+if (result.error) {
+  console.error(result.status, result.error);
+} else {
+  console.log(result.data);
+}

package/examples/http/claimAgentRealtimeSession.ts

@@ -0,0 +1,21 @@
+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);
+}

package/examples/http/closeAgentRealtimeSession.ts

@@ -0,0 +1,28 @@
+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);
+}

package/examples/http/commentWorkspaceCalendarItem.ts

@@ -0,0 +1,24 @@
+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);
+}

package/examples/http/connectAgent.ts

@@ -0,0 +1,47 @@
+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);
+}

package/examples/http/createAgentBrief.ts

@@ -0,0 +1,34 @@
+import { AgentMCApi } from "@agentmc/api";
+
+const client = new AgentMCApi({
+  agentToken: process.env.AGENTMC_AGENT_TOKEN
+});
+
+const result = await client.operations.createAgentBrief({
+  "body": {
+    "brief": {
+      "key": "daily-operations",
+      "name": "Daily Operations Brief",
+      "summary": "Operations handoff digest for the morning window.",
+      "timezone": "America/Los_Angeles",
+      "headline": "3 overdue tasks | 4 upcoming events",
+      "content_markdown": "## Highlights\n- Elevated API error rate\n- Two incidents resolved",
+      "meta": {
+        "external_source": "daily-ops-job",
+        "schedule": "0 7 * * *"
+      }
+    },
+    "source": {
+      "agent_id": 42,
+      "meta": {
+        "runtime": "codex"
+      }
+    }
+  }
+});
+
+if (result.error) {
+  console.error(result.status, result.error);
+} else {
+  console.log(result.data);
+}

package/examples/http/createAgentRealtimeSignal.ts

@@ -0,0 +1,33 @@
+import { AgentMCApi } from "@agentmc/api";
+
+const client = new AgentMCApi({
+  agentToken: process.env.AGENTMC_AGENT_TOKEN
+});
+
+const result = await client.operations.createAgentRealtimeSignal({
+  "params": {
+    "path": {
+      "agent": 1,
+      "session": 1
+    }
+  },
+  "body": {
+    "type": "message",
+    "payload": {
+      "type": "chat.user",
+      "payload": {
+        "content": "Create a AgentMC task for this afternoon to draft the postmortem outline.",
+        "message_id": 512,
+        "timezone": "America/Los_Angeles",
+        "source": "agentmc_chat",
+        "intent_scope": "agentmc"
+      }
+    }
+  }
+});
+
+if (result.error) {
+  console.error(result.status, result.error);
+} else {
+  console.log(result.data);
+}

package/examples/http/createBoard.ts

@@ -0,0 +1,19 @@
+import { AgentMCApi } from "@agentmc/api";
+
+const client = new AgentMCApi({
+  agentToken: process.env.AGENTMC_AGENT_TOKEN
+});
+
+const result = await client.operations.createBoard({
+  "body": {
+    "name": "Incident Response",
+    "description": "Tracks response tasks for active incidents.",
+    "visibility": "team"
+  }
+});
+
+if (result.error) {
+  console.error(result.status, result.error);
+} else {
+  console.log(result.data);
+}

package/examples/http/createBoardColumn.ts

@@ -0,0 +1,23 @@
+import { AgentMCApi } from "@agentmc/api";
+
+const client = new AgentMCApi({
+  agentToken: process.env.AGENTMC_AGENT_TOKEN
+});
+
+const result = await client.operations.createBoardColumn({
+  "params": {
+    "path": {
+      "board": 1
+    }
+  },
+  "body": {
+    "name": "In Progress",
+    "position": 2
+  }
+});
+
+if (result.error) {
+  console.error(result.status, result.error);
+} else {
+  console.log(result.data);
+}

package/examples/http/createTask.ts

@@ -0,0 +1,24 @@
+import { AgentMCApi } from "@agentmc/api";
+
+const client = new AgentMCApi({
+  agentToken: process.env.AGENTMC_AGENT_TOKEN
+});
+
+const result = await client.operations.createTask({
+  "body": {
+    "board_id": 5,
+    "column_id": 13,
+    "title": "Draft post-incident summary",
+    "description": "Capture timeline, impact, and remediation status.",
+    "status": "doing",
+    "position": 2,
+    "due_at": "2026-02-24T17:00:00Z",
+    "assigned_to_user_id": 8
+  }
+});
+
+if (result.error) {
+  console.error(result.status, result.error);
+} else {
+  console.log(result.data);
+}

package/examples/http/createTaskComment.ts

@@ -0,0 +1,24 @@
+import { AgentMCApi } from "@agentmc/api";
+
+const client = new AgentMCApi({
+  agentToken: process.env.AGENTMC_AGENT_TOKEN
+});
+
+const result = await client.operations.createTaskComment({
+  "params": {
+    "path": {
+      "task": 1
+    }
+  },
+  "body": {
+    "body": "Posting a handoff note for [@Alex Morgan](/mentions/user/8) to review before standup.",
+    "actor_type": "agent",
+    "actor_id": 42
+  }
+});
+
+if (result.error) {
+  console.error(result.status, result.error);
+} else {
+  console.log(result.data);
+}

package/examples/http/createWorkspaceCalendarItem.ts

@@ -0,0 +1,31 @@
+import { AgentMCApi } from "@agentmc/api";
+
+const client = new AgentMCApi({
+  agentToken: process.env.AGENTMC_AGENT_TOKEN
+});
+
+const result = await client.operations.createWorkspaceCalendarItem({
+  "body": {
+    "type": "task",
+    "title": "Review outage timeline",
+    "description": "Confirm sequence of events with on-call notes.",
+    "due_at": "2026-02-24T09:00:00Z",
+    "timezone": "America/Los_Angeles",
+    "status": "todo",
+    "priority": "high",
+    "visibility": "workspace",
+    "assignees": [
+      {
+        "assignee_type": "user",
+        "assignee_id": 8,
+        "role": "owner"
+      }
+    ]
+  }
+});
+
+if (result.error) {
+  console.error(result.status, result.error);
+} else {
+  console.log(result.data);
+}

package/examples/http/deleteAgentBrief.ts

@@ -0,0 +1,19 @@
+import { AgentMCApi } from "@agentmc/api";
+
+const client = new AgentMCApi({
+  agentToken: process.env.AGENTMC_AGENT_TOKEN
+});
+
+const result = await client.operations.deleteAgentBrief({
+  "params": {
+    "path": {
+      "id": 42
+    }
+  }
+});
+
+if (result.error) {
+  console.error(result.status, result.error);
+} else {
+  console.log(result.data);
+}

package/examples/http/deleteBoard.ts

@@ -0,0 +1,19 @@
+import { AgentMCApi } from "@agentmc/api";
+
+const client = new AgentMCApi({
+  agentToken: process.env.AGENTMC_AGENT_TOKEN
+});
+
+const result = await client.operations.deleteBoard({
+  "params": {
+    "path": {
+      "id": 42
+    }
+  }
+});
+
+if (result.error) {
+  console.error(result.status, result.error);
+} else {
+  console.log(result.data);
+}

package/examples/http/deleteBoardColumn.ts

@@ -0,0 +1,22 @@
+import { AgentMCApi } from "@agentmc/api";
+
+const client = new AgentMCApi({
+  agentToken: process.env.AGENTMC_AGENT_TOKEN
+});
+
+const result = await client.operations.deleteBoardColumn({
+  "params": {
+    "path": {
+      "board": 1
+    }
+  },
+  "body": {
+    "column_id": 13
+  }
+});
+
+if (result.error) {
+  console.error(result.status, result.error);
+} else {
+  console.log(result.data);
+}