@agentmc/api 0.2.5 → 0.2.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -6,40 +6,6 @@ export { operationsById } from './generated/operations.js';
6
6
  * Do not make direct changes to the file.
7
7
  */
8
8
  interface paths {
9
- "/agents/connect": {
10
- parameters: {
11
- query?: never;
12
- header?: never;
13
- path?: never;
14
- cookie?: never;
15
- };
16
- get?: never;
17
- put?: never;
18
- /** Connect and register one agent using a short-lived connect token. */
19
- post: operations["connectAgent"];
20
- delete?: never;
21
- options?: never;
22
- head?: never;
23
- patch?: never;
24
- trace?: never;
25
- };
26
- "/agents/{agent}/agent-instructions": {
27
- parameters: {
28
- query?: never;
29
- header?: never;
30
- path?: never;
31
- cookie?: never;
32
- };
33
- /** Return agent instructions for a connected agent using bearer auth. */
34
- get: operations["agentInstructions"];
35
- put?: never;
36
- post?: never;
37
- delete?: never;
38
- options?: never;
39
- head?: never;
40
- patch?: never;
41
- trace?: never;
42
- };
43
9
  "/agents/{agent}/heartbeat": {
44
10
  parameters: {
45
11
  query?: never;
@@ -977,7 +943,6 @@ interface components {
977
943
  * ]
978
944
  * },
979
945
  * "last_seen_at": "2026-02-24T02:11:00Z",
980
- * "first_sync_at": "2026-02-24T02:01:00Z",
981
946
  * "tasks_count": 3,
982
947
  * "created_at": "2026-02-24T01:56:00Z",
983
948
  * "updated_at": "2026-02-24T02:11:00Z"
@@ -1056,12 +1021,6 @@ interface components {
1056
1021
  * @example 2026-02-22T17:21:00Z
1057
1022
  */
1058
1023
  last_seen_at: string | null;
1059
- /**
1060
- * Format: date-time
1061
- * @description ISO-8601 timestamp when this agent first completed initial sync.
1062
- * @example 2026-02-22T17:21:00Z
1063
- */
1064
- first_sync_at: string | null;
1065
1024
  /**
1066
1025
  * @description Count of tasks currently assigned to this agent.
1067
1026
  * @example 0
@@ -1112,7 +1071,6 @@ interface components {
1112
1071
  * ]
1113
1072
  * },
1114
1073
  * "last_seen_at": "2026-02-24T02:11:00Z",
1115
- * "first_sync_at": "2026-02-24T02:01:00Z",
1116
1074
  * "tasks_count": 3,
1117
1075
  * "created_at": "2026-02-24T01:56:00Z",
1118
1076
  * "updated_at": "2026-02-24T02:11:00Z"
@@ -1173,7 +1131,6 @@ interface components {
1173
1131
  * ]
1174
1132
  * },
1175
1133
  * "last_seen_at": "2026-02-24T02:11:00Z",
1176
- * "first_sync_at": "2026-02-24T02:01:00Z",
1177
1134
  * "tasks_count": 3,
1178
1135
  * "created_at": "2026-02-24T01:56:00Z",
1179
1136
  * "updated_at": "2026-02-24T02:11:00Z"
@@ -1266,129 +1223,6 @@ interface components {
1266
1223
  [key: string]: unknown;
1267
1224
  };
1268
1225
  };
1269
- /**
1270
- * @description Connect/registration response with agent credentials, authenticated agent instructions endpoint, and OpenAPI URL.
1271
- * @example {
1272
- * "agent_id": 42,
1273
- * "agent_token": "mca_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
1274
- * "agent_instructions_endpoint": "https://agentmc.example.com/api/v1/agents/42/agent-instructions",
1275
- * "agent_authenticated_instructions_endpoint": "https://agentmc.example.com/api/v1/agents/42/agent-instructions",
1276
- * "agent_instructions_version": "32fe7fd14fca2d57c545f5f78f4a1c094f9ac1b3a1e8f6f9f8323b67a0ef9cc3",
1277
- * "openapi_url": "https://agentmc.example.com/api/openapi.json",
1278
- * "workspace": {
1279
- * "id": 7,
1280
- * "name": "AgentMC Demo Workspace"
1281
- * },
1282
- * "server_time": "2026-02-22T17:20:53Z",
1283
- * "first_sync_required": true
1284
- * }
1285
- */
1286
- AgentRegisterResponse: {
1287
- /**
1288
- * @description Identifier for agent.
1289
- * @example 42
1290
- */
1291
- agent_id: number;
1292
- /**
1293
- * @description Bearer token to use in `Authorization: Bearer <token>` headers.
1294
- * @example mca_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
1295
- */
1296
- agent_token: string;
1297
- /**
1298
- * Format: uri
1299
- * @description Endpoint for agent instructions updates.
1300
- * @example https://agentmc.example.com/resource
1301
- */
1302
- agent_instructions_endpoint: string;
1303
- /**
1304
- * Format: uri
1305
- * @description Authenticated endpoint for agent instructions updates.
1306
- * @example https://agentmc.example.com/resource
1307
- */
1308
- agent_authenticated_instructions_endpoint: string;
1309
- /**
1310
- * @description Agent instructions version.
1311
- * @example example
1312
- */
1313
- agent_instructions_version: string;
1314
- /**
1315
- * @description Canonical OpenAPI specification URL.
1316
- * @example https://agentmc.example.com/api/openapi.json
1317
- */
1318
- openapi_url: string;
1319
- /**
1320
- * @description Workspace.
1321
- * @example {
1322
- * "id": 42,
1323
- * "name": "Example Name"
1324
- * }
1325
- */
1326
- workspace: components["schemas"]["TeamSummary"];
1327
- /**
1328
- * Format: date-time
1329
- * @description Current server timestamp.
1330
- * @example 2026-02-22T17:21:00Z
1331
- */
1332
- server_time: string;
1333
- /**
1334
- * @description Boolean flag for first sync required.
1335
- * @example true
1336
- */
1337
- first_sync_required: boolean;
1338
- };
1339
- /**
1340
- * @description Connected agent instructions payload returned after successful bearer authentication.
1341
- * @example {
1342
- * "agent_instructions": "# Agent Instructions",
1343
- * "agent_instructions_version": "32fe7fd14fca2d57c545f5f78f4a1c094f9ac1b3a1e8f6f9f8323b67a0ef9cc3",
1344
- * "docs": [],
1345
- * "schedules": [],
1346
- * "config": {}
1347
- * }
1348
- */
1349
- AgentInstructionsResponse: {
1350
- /**
1351
- * @description Agent instructions.
1352
- * @example example
1353
- */
1354
- agent_instructions: string;
1355
- /**
1356
- * @description Agent instructions version.
1357
- * @example example
1358
- */
1359
- agent_instructions_version: string;
1360
- /**
1361
- * @description Docs.
1362
- * @example [
1363
- * {
1364
- * "key": "value"
1365
- * }
1366
- * ]
1367
- */
1368
- docs: {
1369
- [key: string]: unknown;
1370
- }[];
1371
- /**
1372
- * @description Schedules.
1373
- * @example [
1374
- * {
1375
- * "key": "value"
1376
- * }
1377
- * ]
1378
- */
1379
- schedules: {
1380
- [key: string]: unknown;
1381
- }[];
1382
- /**
1383
- * @description Config.
1384
- * @example {
1385
- * "key": "value"
1386
- * }
1387
- */
1388
- config: {
1389
- [key: string]: unknown;
1390
- };
1391
- };
1392
1226
  /**
1393
1227
  * @description Heartbeat acknowledgement with optional resolved host record when runtime payload is provided.
1394
1228
  * @example {
@@ -5223,291 +5057,6 @@ interface components {
5223
5057
  [key: string]: unknown;
5224
5058
  }[]) | null;
5225
5059
  };
5226
- /**
5227
- * @description One-time agent registration payload. Resolve this schema from OpenAPI at runtime instead of hardcoding fields.
5228
- * @example {
5229
- * "host": "ip-10-0-3-42",
5230
- * "runtime_version": "2026.02.1",
5231
- * "capabilities": [
5232
- * "tasks",
5233
- * "calendar",
5234
- * "realtime"
5235
- * ],
5236
- * "agents_md": "# Existing AGENTS.md\n\n## Runtime\n- Keep heartbeat alive.\n",
5237
- * "models": [
5238
- * {
5239
- * "model_id": "openai/gpt-5-codex",
5240
- * "provider": "openai"
5241
- * },
5242
- * {
5243
- * "model_id": "anthropic/claude-sonnet-4-20250514",
5244
- * "provider": "anthropic"
5245
- * }
5246
- * ],
5247
- * "identity": {
5248
- * "name": "Jarvis",
5249
- * "creature": "robot",
5250
- * "vibe": "calm",
5251
- * "emoji": "🤖"
5252
- * },
5253
- * "metadata": {
5254
- * "hostname": "worker-01",
5255
- * "ip": "10.0.2.15",
5256
- * "network": {
5257
- * "private_ip": "10.0.2.15",
5258
- * "public_ip": "34.201.22.9"
5259
- * },
5260
- * "os": "Ubuntu",
5261
- * "os_version": "22.04",
5262
- * "arch": "x86_64",
5263
- * "cpu": "Intel Xeon",
5264
- * "cpu_cores": 8,
5265
- * "ram_gb": 32,
5266
- * "disk": {
5267
- * "total_bytes": 512110190592,
5268
- * "free_bytes": 321102110720
5269
- * },
5270
- * "uptime_seconds": 86400,
5271
- * "runtime": {
5272
- * "name": "codex",
5273
- * "version": "2026.02.1"
5274
- * },
5275
- * "identity": {
5276
- * "name": "Jarvis",
5277
- * "creature": "robot",
5278
- * "vibe": "calm"
5279
- * }
5280
- * }
5281
- * }
5282
- */
5283
- RegisterAgentApiRequest: {
5284
- /**
5285
- * @description Runtime host identifier (hostname or machine name).
5286
- * @example ip-10-0-3-42
5287
- */
5288
- host: string;
5289
- /**
5290
- * @description Required runtime/client version string for diagnostics.
5291
- * @example 2026.02.1
5292
- */
5293
- runtime_version: string;
5294
- /**
5295
- * @description Required (nullable) capability tags supported by this runtime.
5296
- * @example [
5297
- * "tasks",
5298
- * "calendar",
5299
- * "realtime"
5300
- * ]
5301
- */
5302
- capabilities: string[] | null;
5303
- /**
5304
- * @description Required current local AGENTS.md content captured by the runtime before first sync.
5305
- * @example # Existing AGENTS.md
5306
- *
5307
- * ## Runtime
5308
- * - Keep heartbeat alive.
5309
- */
5310
- agents_md: string;
5311
- /**
5312
- * @description Optional runtime LLM inventory. Send an array of model refs/objects or a structured runtime snapshot object.
5313
- * @example [
5314
- * {
5315
- * "model_id": "openai/gpt-5-codex",
5316
- * "provider": "openai"
5317
- * },
5318
- * {
5319
- * "model_id": "anthropic/claude-sonnet-4-20250514",
5320
- * "provider": "anthropic"
5321
- * }
5322
- * ]
5323
- */
5324
- models?: ((string | {
5325
- /**
5326
- * @description Full model ID in provider/model format.
5327
- * @example openai/gpt-5-codex
5328
- */
5329
- model_id: string;
5330
- /**
5331
- * @description Model provider slug.
5332
- * @example openai
5333
- */
5334
- provider?: string;
5335
- /**
5336
- * @description Optional display name.
5337
- * @example GPT-5 Codex
5338
- */
5339
- name?: string;
5340
- })[] | {
5341
- [key: string]: unknown;
5342
- }) | null;
5343
- /**
5344
- * @description Optional full agent identity payload persisted in agent metadata.
5345
- * @example {
5346
- * "name": "Jarvis",
5347
- * "creature": "robot",
5348
- * "vibe": "calm",
5349
- * "emoji": "🤖"
5350
- * }
5351
- */
5352
- identity?: unknown;
5353
- /**
5354
- * @description Required host telemetry snapshot for registration. Mirrors heartbeat host metadata and is saved as host metadata.
5355
- * @example {
5356
- * "hostname": "worker-01",
5357
- * "ip": "10.0.2.15",
5358
- * "network": {
5359
- * "private_ip": "10.0.2.15",
5360
- * "public_ip": "34.201.22.9"
5361
- * },
5362
- * "os": "Ubuntu",
5363
- * "os_version": "22.04",
5364
- * "arch": "x86_64",
5365
- * "cpu": "Intel Xeon",
5366
- * "cpu_cores": 8,
5367
- * "ram_gb": 32,
5368
- * "disk": {
5369
- * "total_bytes": 512110190592,
5370
- * "free_bytes": 321102110720
5371
- * },
5372
- * "uptime_seconds": 86400,
5373
- * "runtime": {
5374
- * "name": "codex",
5375
- * "version": "2026.02.1"
5376
- * },
5377
- * "identity": {
5378
- * "name": "Jarvis",
5379
- * "creature": "robot",
5380
- * "vibe": "calm"
5381
- * }
5382
- * }
5383
- */
5384
- metadata: {
5385
- /**
5386
- * @description Hostname.
5387
- * @example Example Name
5388
- */
5389
- hostname: string;
5390
- /**
5391
- * Format: ipv4
5392
- * @description Ip.
5393
- * @example example
5394
- */
5395
- ip: string;
5396
- /**
5397
- * @description Network.
5398
- * @example {
5399
- * "private_ip": "example",
5400
- * "public_ip": "example"
5401
- * }
5402
- */
5403
- network: {
5404
- /**
5405
- * Format: ipv4
5406
- * @description Private ip.
5407
- * @example example
5408
- */
5409
- private_ip: string;
5410
- /**
5411
- * Format: ipv4
5412
- * @description Public ip.
5413
- * @example example
5414
- */
5415
- public_ip: string;
5416
- };
5417
- /**
5418
- * @description Os.
5419
- * @example example
5420
- */
5421
- os: string;
5422
- /**
5423
- * @description Os version.
5424
- * @example example
5425
- */
5426
- os_version: string;
5427
- /**
5428
- * @description Arch.
5429
- * @example example
5430
- */
5431
- arch: string;
5432
- /**
5433
- * @description Cpu.
5434
- * @example example
5435
- */
5436
- cpu: string | {
5437
- [key: string]: unknown;
5438
- };
5439
- /**
5440
- * @description Cpu cores.
5441
- * @example 8
5442
- */
5443
- cpu_cores: number;
5444
- /**
5445
- * @description Ram gb.
5446
- * @example 32
5447
- */
5448
- ram_gb: number;
5449
- /**
5450
- * @description Disk.
5451
- * @example {
5452
- * "total_bytes": 0,
5453
- * "free_bytes": 0
5454
- * }
5455
- */
5456
- disk: {
5457
- /**
5458
- * @description Total bytes.
5459
- * @example 0
5460
- */
5461
- total_bytes: number;
5462
- /**
5463
- * @description Free bytes.
5464
- * @example 0
5465
- */
5466
- free_bytes: number;
5467
- };
5468
- /**
5469
- * @description Uptime seconds.
5470
- * @example 86400
5471
- */
5472
- uptime_seconds: number;
5473
- /**
5474
- * @description Runtime.
5475
- * @example {
5476
- * "name": "Example Name",
5477
- * "version": "example"
5478
- * }
5479
- */
5480
- runtime: {
5481
- /**
5482
- * @description Human-readable name.
5483
- * @example Example Name
5484
- */
5485
- name: string;
5486
- /**
5487
- * @description Version.
5488
- * @example example
5489
- */
5490
- version: string;
5491
- };
5492
- /**
5493
- * @description Optional identity payload persisted as host metadata.
5494
- * @example {
5495
- * "name": "Jarvis"
5496
- * }
5497
- */
5498
- identity?: ({
5499
- /**
5500
- * @description Human-readable name.
5501
- * @example Jarvis
5502
- */
5503
- name?: string;
5504
- } & {
5505
- [key: string]: unknown;
5506
- }) | string;
5507
- } & {
5508
- [key: string]: unknown;
5509
- };
5510
- };
5511
5060
  /**
5512
5061
  * @description Heartbeat payload that accepts liveness pings and optional host + runtime state.
5513
5062
  * @example {
@@ -6612,49 +6161,6 @@ interface components {
6612
6161
  };
6613
6162
  };
6614
6163
  responses: {
6615
- /** @description Agent registered and bearer token issued. */
6616
- AgentRegisterResponse: {
6617
- headers: {
6618
- [name: string]: unknown;
6619
- };
6620
- content: {
6621
- /**
6622
- * @example {
6623
- * "agent_id": 42,
6624
- * "agent_token": "mca_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
6625
- * "agent_instructions_endpoint": "https://agentmc.example.com/api/v1/agents/42/agent-instructions",
6626
- * "agent_authenticated_instructions_endpoint": "https://agentmc.example.com/api/v1/agents/42/agent-instructions",
6627
- * "agent_instructions_version": "32fe7fd14fca2d57c545f5f78f4a1c094f9ac1b3a1e8f6f9f8323b67a0ef9cc3",
6628
- * "openapi_url": "https://agentmc.example.com/api/openapi.json",
6629
- * "workspace": {
6630
- * "id": 7,
6631
- * "name": "AgentMC Demo Workspace"
6632
- * },
6633
- * "server_time": "2026-02-22T17:20:53Z",
6634
- * "first_sync_required": true
6635
- * }
6636
- */
6637
- "application/json": components["schemas"]["AgentRegisterResponse"];
6638
- };
6639
- };
6640
- /** @description Agent instructions returned. */
6641
- AgentInstructionsResponse: {
6642
- headers: {
6643
- [name: string]: unknown;
6644
- };
6645
- content: {
6646
- /**
6647
- * @example {
6648
- * "agent_instructions": "# Agent Instructions",
6649
- * "agent_instructions_version": "32fe7fd14fca2d57c545f5f78f4a1c094f9ac1b3a1e8f6f9f8323b67a0ef9cc3",
6650
- * "docs": [],
6651
- * "schedules": [],
6652
- * "config": {}
6653
- * }
6654
- */
6655
- "application/json": components["schemas"]["AgentInstructionsResponse"];
6656
- };
6657
- };
6658
6164
  /** @description Heartbeat accepted. */
6659
6165
  AgentHeartbeatResponse: {
6660
6166
  headers: {
@@ -7318,64 +6824,6 @@ interface components {
7318
6824
  "application/json": components["schemas"]["CloseAgentRealtimeSessionApiRequest"];
7319
6825
  };
7320
6826
  };
7321
- RegisterAgentApiRequest: {
7322
- content: {
7323
- /**
7324
- * @example {
7325
- * "host": "ip-10-0-3-42",
7326
- * "runtime_version": "2026.02.1",
7327
- * "capabilities": [
7328
- * "tasks",
7329
- * "calendar",
7330
- * "realtime"
7331
- * ],
7332
- * "agents_md": "# Existing AGENTS.md\n\n## Runtime\n- Keep heartbeat alive.\n",
7333
- * "models": [
7334
- * {
7335
- * "model_id": "openai/gpt-5-codex",
7336
- * "provider": "openai"
7337
- * },
7338
- * {
7339
- * "model_id": "anthropic/claude-sonnet-4-20250514",
7340
- * "provider": "anthropic"
7341
- * }
7342
- * ],
7343
- * "identity": {
7344
- * "name": "Jarvis",
7345
- * "creature": "robot",
7346
- * "vibe": "calm"
7347
- * },
7348
- * "metadata": {
7349
- * "hostname": "worker-01",
7350
- * "ip": "10.0.2.15",
7351
- * "network": {
7352
- * "private_ip": "10.0.2.15",
7353
- * "public_ip": "34.201.22.9"
7354
- * },
7355
- * "os": "Ubuntu",
7356
- * "os_version": "22.04",
7357
- * "arch": "x86_64",
7358
- * "cpu": "Intel Xeon",
7359
- * "cpu_cores": 8,
7360
- * "ram_gb": 32,
7361
- * "disk": {
7362
- * "total_bytes": 512110190592,
7363
- * "free_bytes": 321102110720
7364
- * },
7365
- * "uptime_seconds": 86400,
7366
- * "runtime": {
7367
- * "name": "codex",
7368
- * "version": "2026.02.1"
7369
- * },
7370
- * "identity": {
7371
- * "name": "Jarvis"
7372
- * }
7373
- * }
7374
- * }
7375
- */
7376
- "application/json": components["schemas"]["RegisterAgentApiRequest"];
7377
- };
7378
- };
7379
6827
  StoreAgentHeartbeatApiRequest: {
7380
6828
  content: {
7381
6829
  /**
@@ -7697,83 +7145,6 @@ interface components {
7697
7145
  pathItems: never;
7698
7146
  }
7699
7147
  interface operations {
7700
- connectAgent: {
7701
- parameters: {
7702
- query?: never;
7703
- header?: never;
7704
- path?: never;
7705
- cookie?: never;
7706
- };
7707
- requestBody: components["requestBodies"]["RegisterAgentApiRequest"];
7708
- responses: {
7709
- /** @description Agent connected and bearer token issued. */
7710
- 201: {
7711
- headers: {
7712
- [name: string]: unknown;
7713
- };
7714
- content: {
7715
- /**
7716
- * @example {
7717
- * "agent_id": 42,
7718
- * "agent_token": "mca_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
7719
- * "agent_instructions_endpoint": "https://agentmc.example.com/api/v1/agents/42/agent-instructions",
7720
- * "agent_authenticated_instructions_endpoint": "https://agentmc.example.com/api/v1/agents/42/agent-instructions",
7721
- * "agent_instructions_version": "32fe7fd14fca2d57c545f5f78f4a1c094f9ac1b3a1e8f6f9f8323b67a0ef9cc3",
7722
- * "openapi_url": "https://agentmc.example.com/api/openapi.json",
7723
- * "workspace": {
7724
- * "id": 7,
7725
- * "name": "AgentMC Demo Workspace"
7726
- * },
7727
- * "server_time": "2026-02-22T17:20:53Z",
7728
- * "first_sync_required": true
7729
- * }
7730
- */
7731
- "application/json": components["schemas"]["AgentRegisterResponse"];
7732
- };
7733
- };
7734
- 401: components["responses"]["ApiError401"];
7735
- 403: components["responses"]["ApiError403"];
7736
- 422: components["responses"]["ApiError422"];
7737
- };
7738
- };
7739
- agentInstructions: {
7740
- parameters: {
7741
- query?: never;
7742
- header?: never;
7743
- path: {
7744
- /**
7745
- * @description Agent identifier.
7746
- * @example 1
7747
- */
7748
- agent: number;
7749
- };
7750
- cookie?: never;
7751
- };
7752
- requestBody?: never;
7753
- responses: {
7754
- /** @description Agent instructions returned. */
7755
- 200: {
7756
- headers: {
7757
- [name: string]: unknown;
7758
- };
7759
- content: {
7760
- /**
7761
- * @example {
7762
- * "agent_instructions": "# Agent Instructions",
7763
- * "agent_instructions_version": "32fe7fd14fca2d57c545f5f78f4a1c094f9ac1b3a1e8f6f9f8323b67a0ef9cc3",
7764
- * "docs": [],
7765
- * "schedules": [],
7766
- * "config": {}
7767
- * }
7768
- */
7769
- "application/json": components["schemas"]["AgentInstructionsResponse"];
7770
- };
7771
- };
7772
- 401: components["responses"]["ApiError401"];
7773
- 403: components["responses"]["ApiError403"];
7774
- 404: components["responses"]["ApiError404"];
7775
- };
7776
- };
7777
7148
  agentHeartbeat: {
7778
7149
  parameters: {
7779
7150
  query?: never;
@@ -9781,7 +9152,6 @@ interface operations {
9781
9152
  * ]
9782
9153
  * },
9783
9154
  * "last_seen_at": "2026-02-24T02:11:00Z",
9784
- * "first_sync_at": "2026-02-24T02:01:00Z",
9785
9155
  * "tasks_count": 3,
9786
9156
  * "created_at": "2026-02-24T01:56:00Z",
9787
9157
  * "updated_at": "2026-02-24T02:11:00Z"