@agentmc/api 0.2.5 → 0.2.8

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.
@@ -206,104 +206,6 @@ var operations = [
206
206
  }
207
207
  ]
208
208
  },
209
- {
210
- "operationId": "agentInstructions",
211
- "method": "get",
212
- "path": "/agents/{agent}/agent-instructions",
213
- "summary": "Return agent instructions for a connected agent using bearer auth.",
214
- "description": "",
215
- "tags": [
216
- "Agents"
217
- ],
218
- "security": [
219
- [
220
- "AgentBearerAuth"
221
- ]
222
- ],
223
- "parameters": [
224
- {
225
- "name": "agent",
226
- "in": "path",
227
- "required": true,
228
- "description": "Agent identifier.",
229
- "example": 1
230
- }
231
- ],
232
- "requestBodyRequired": false,
233
- "requestExamples": [],
234
- "responses": [
235
- {
236
- "status": "200",
237
- "mediaType": "application/json",
238
- "description": "Agent instructions returned.",
239
- "hasContent": true,
240
- "example": {
241
- "agent_instructions": "# Agent Instructions",
242
- "agent_instructions_version": "32fe7fd14fca2d57c545f5f78f4a1c094f9ac1b3a1e8f6f9f8323b67a0ef9cc3",
243
- "docs": [],
244
- "schedules": [],
245
- "config": {}
246
- }
247
- },
248
- {
249
- "status": "401",
250
- "mediaType": "application/json",
251
- "description": "Missing or invalid credentials.",
252
- "hasContent": true,
253
- "example": {
254
- "error": {
255
- "code": "validation.failed",
256
- "message": "Validation failed.",
257
- "details": {
258
- "fields": {
259
- "title": [
260
- "The title field is required."
261
- ]
262
- }
263
- }
264
- }
265
- }
266
- },
267
- {
268
- "status": "403",
269
- "mediaType": "application/json",
270
- "description": "Forbidden.",
271
- "hasContent": true,
272
- "example": {
273
- "error": {
274
- "code": "validation.failed",
275
- "message": "Validation failed.",
276
- "details": {
277
- "fields": {
278
- "title": [
279
- "The title field is required."
280
- ]
281
- }
282
- }
283
- }
284
- }
285
- },
286
- {
287
- "status": "404",
288
- "mediaType": "application/json",
289
- "description": "Resource not found.",
290
- "hasContent": true,
291
- "example": {
292
- "error": {
293
- "code": "validation.failed",
294
- "message": "Validation failed.",
295
- "details": {
296
- "fields": {
297
- "title": [
298
- "The title field is required."
299
- ]
300
- }
301
- }
302
- }
303
- }
304
- }
305
- ]
306
- },
307
209
  {
308
210
  "operationId": "authenticateAgentRealtimeSocket",
309
211
  "method": "post",
@@ -913,158 +815,6 @@ var operations = [
913
815
  }
914
816
  ]
915
817
  },
916
- {
917
- "operationId": "connectAgent",
918
- "method": "post",
919
- "path": "/agents/connect",
920
- "summary": "Connect and register one agent using a short-lived connect token.",
921
- "description": "",
922
- "tags": [
923
- "Agents"
924
- ],
925
- "security": [
926
- [
927
- "ConnectTokenAuth"
928
- ]
929
- ],
930
- "parameters": [],
931
- "requestBodyRequired": true,
932
- "requestExamples": [
933
- {
934
- "mediaType": "application/json",
935
- "example": {
936
- "host": "ip-10-0-3-42",
937
- "runtime_version": "2026.02.1",
938
- "capabilities": [
939
- "tasks",
940
- "calendar",
941
- "realtime"
942
- ],
943
- "agents_md": "# Existing AGENTS.md\n\n## Runtime\n- Keep heartbeat alive.\n",
944
- "models": [
945
- {
946
- "model_id": "openai/gpt-5-codex",
947
- "provider": "openai"
948
- },
949
- {
950
- "model_id": "anthropic/claude-sonnet-4-20250514",
951
- "provider": "anthropic"
952
- }
953
- ],
954
- "identity": {
955
- "name": "Jarvis",
956
- "creature": "robot",
957
- "vibe": "calm"
958
- },
959
- "metadata": {
960
- "hostname": "worker-01",
961
- "ip": "10.0.2.15",
962
- "network": {
963
- "private_ip": "10.0.2.15",
964
- "public_ip": "34.201.22.9"
965
- },
966
- "os": "Ubuntu",
967
- "os_version": "22.04",
968
- "arch": "x86_64",
969
- "cpu": "Intel Xeon",
970
- "cpu_cores": 8,
971
- "ram_gb": 32,
972
- "disk": {
973
- "total_bytes": 512110190592,
974
- "free_bytes": 321102110720
975
- },
976
- "uptime_seconds": 86400,
977
- "runtime": {
978
- "name": "codex",
979
- "version": "2026.02.1"
980
- },
981
- "identity": {
982
- "name": "Jarvis"
983
- }
984
- }
985
- }
986
- }
987
- ],
988
- "responses": [
989
- {
990
- "status": "201",
991
- "mediaType": "application/json",
992
- "description": "Agent connected and bearer token issued.",
993
- "hasContent": true,
994
- "example": {
995
- "agent_id": 42,
996
- "agent_token": "mca_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
997
- "agent_instructions_endpoint": "https://agentmc.example.com/api/v1/agents/42/agent-instructions",
998
- "agent_authenticated_instructions_endpoint": "https://agentmc.example.com/api/v1/agents/42/agent-instructions",
999
- "agent_instructions_version": "32fe7fd14fca2d57c545f5f78f4a1c094f9ac1b3a1e8f6f9f8323b67a0ef9cc3",
1000
- "openapi_url": "https://agentmc.example.com/api/openapi.json",
1001
- "workspace": {
1002
- "id": 7,
1003
- "name": "AgentMC Demo Workspace"
1004
- },
1005
- "server_time": "2026-02-22T17:20:53Z",
1006
- "first_sync_required": true
1007
- }
1008
- },
1009
- {
1010
- "status": "401",
1011
- "mediaType": "application/json",
1012
- "description": "Missing or invalid credentials.",
1013
- "hasContent": true,
1014
- "example": {
1015
- "error": {
1016
- "code": "validation.failed",
1017
- "message": "Validation failed.",
1018
- "details": {
1019
- "fields": {
1020
- "title": [
1021
- "The title field is required."
1022
- ]
1023
- }
1024
- }
1025
- }
1026
- }
1027
- },
1028
- {
1029
- "status": "403",
1030
- "mediaType": "application/json",
1031
- "description": "Forbidden.",
1032
- "hasContent": true,
1033
- "example": {
1034
- "error": {
1035
- "code": "validation.failed",
1036
- "message": "Validation failed.",
1037
- "details": {
1038
- "fields": {
1039
- "title": [
1040
- "The title field is required."
1041
- ]
1042
- }
1043
- }
1044
- }
1045
- }
1046
- },
1047
- {
1048
- "status": "422",
1049
- "mediaType": "application/json",
1050
- "description": "Validation failed.",
1051
- "hasContent": true,
1052
- "example": {
1053
- "error": {
1054
- "code": "validation.failed",
1055
- "message": "Validation failed.",
1056
- "details": {
1057
- "fields": {
1058
- "title": [
1059
- "The title field is required."
1060
- ]
1061
- }
1062
- }
1063
- }
1064
- }
1065
- }
1066
- ]
1067
- },
1068
818
  {
1069
819
  "operationId": "createAgentBrief",
1070
820
  "method": "post",
@@ -2845,6 +2595,118 @@ var operations = [
2845
2595
  }
2846
2596
  ]
2847
2597
  },
2598
+ {
2599
+ "operationId": "getAgentInstructions",
2600
+ "method": "get",
2601
+ "path": "/agents/instructions",
2602
+ "summary": "Fetch the AgentMC instruction bundle for the authenticated agent.",
2603
+ "description": "Returns managed runtime files and bundle metadata. Send current_bundle_version to fetch files only when the bundle has changed.",
2604
+ "tags": [
2605
+ "Agents"
2606
+ ],
2607
+ "security": [
2608
+ [
2609
+ "AgentBearerAuth"
2610
+ ]
2611
+ ],
2612
+ "parameters": [
2613
+ {
2614
+ "name": "current_bundle_version",
2615
+ "in": "query",
2616
+ "required": false,
2617
+ "description": "Last applied instruction bundle version from local runtime state.",
2618
+ "example": "bundle_2fa07fcadd6575cc"
2619
+ }
2620
+ ],
2621
+ "requestBodyRequired": false,
2622
+ "requestExamples": [],
2623
+ "responses": [
2624
+ {
2625
+ "status": "200",
2626
+ "mediaType": "application/json",
2627
+ "description": "Instruction bundle returned.",
2628
+ "hasContent": true,
2629
+ "example": {
2630
+ "ok": true,
2631
+ "changed": true,
2632
+ "bundle_version": "bundle_2fa07fcadd6575cc",
2633
+ "generated_at": "2026-02-25T14:10:00Z",
2634
+ "defaults": {
2635
+ "heartbeat_interval_seconds": 300
2636
+ },
2637
+ "agent": {
2638
+ "id": 42,
2639
+ "name": "Agent"
2640
+ },
2641
+ "files": [
2642
+ {
2643
+ "id": "skill.md",
2644
+ "path": ".agentmc/skills/skill.md",
2645
+ "content": "# AgentMC\n",
2646
+ "sha256": "f96c95bd27dc9f3415cc0f4d817b5ec6f14185b6fcb5db9f6b6f14f648f8e9e4"
2647
+ }
2648
+ ]
2649
+ }
2650
+ },
2651
+ {
2652
+ "status": "401",
2653
+ "mediaType": "application/json",
2654
+ "description": "Missing or invalid credentials.",
2655
+ "hasContent": true,
2656
+ "example": {
2657
+ "error": {
2658
+ "code": "validation.failed",
2659
+ "message": "Validation failed.",
2660
+ "details": {
2661
+ "fields": {
2662
+ "title": [
2663
+ "The title field is required."
2664
+ ]
2665
+ }
2666
+ }
2667
+ }
2668
+ }
2669
+ },
2670
+ {
2671
+ "status": "403",
2672
+ "mediaType": "application/json",
2673
+ "description": "Forbidden.",
2674
+ "hasContent": true,
2675
+ "example": {
2676
+ "error": {
2677
+ "code": "validation.failed",
2678
+ "message": "Validation failed.",
2679
+ "details": {
2680
+ "fields": {
2681
+ "title": [
2682
+ "The title field is required."
2683
+ ]
2684
+ }
2685
+ }
2686
+ }
2687
+ }
2688
+ },
2689
+ {
2690
+ "status": "422",
2691
+ "mediaType": "application/json",
2692
+ "description": "Validation failed.",
2693
+ "hasContent": true,
2694
+ "example": {
2695
+ "error": {
2696
+ "code": "validation.failed",
2697
+ "message": "Validation failed.",
2698
+ "details": {
2699
+ "fields": {
2700
+ "title": [
2701
+ "The title field is required."
2702
+ ]
2703
+ }
2704
+ }
2705
+ }
2706
+ }
2707
+ }
2708
+ ]
2709
+ },
2848
2710
  {
2849
2711
  "operationId": "listAgentBriefs",
2850
2712
  "method": "get",
@@ -2978,7 +2840,7 @@ var operations = [
2978
2840
  "active": true
2979
2841
  }
2980
2842
  ],
2981
- "path": "example",
2843
+ "path": ".agentmc/skills/skill.md",
2982
2844
  "per_page": 25,
2983
2845
  "total": 0
2984
2846
  }
@@ -3441,7 +3303,6 @@ var operations = [
3441
3303
  ]
3442
3304
  },
3443
3305
  "last_seen_at": "2026-02-24T02:11:00Z",
3444
- "first_sync_at": "2026-02-24T02:01:00Z",
3445
3306
  "tasks_count": 3,
3446
3307
  "created_at": "2026-02-24T01:56:00Z",
3447
3308
  "updated_at": "2026-02-24T02:11:00Z"
@@ -3464,7 +3325,7 @@ var operations = [
3464
3325
  "active": true
3465
3326
  }
3466
3327
  ],
3467
- "path": "example",
3328
+ "path": ".agentmc/skills/skill.md",
3468
3329
  "per_page": 25,
3469
3330
  "total": 0
3470
3331
  }
@@ -3592,7 +3453,7 @@ var operations = [
3592
3453
  "active": true
3593
3454
  }
3594
3455
  ],
3595
- "path": "example",
3456
+ "path": ".agentmc/skills/skill.md",
3596
3457
  "per_page": 25,
3597
3458
  "total": 0
3598
3459
  }
@@ -3783,7 +3644,7 @@ var operations = [
3783
3644
  "active": true
3784
3645
  }
3785
3646
  ],
3786
- "path": "example",
3647
+ "path": ".agentmc/skills/skill.md",
3787
3648
  "per_page": 25,
3788
3649
  "total": 0
3789
3650
  }
@@ -3925,7 +3786,7 @@ var operations = [
3925
3786
  "active": true
3926
3787
  }
3927
3788
  ],
3928
- "path": "example",
3789
+ "path": ".agentmc/skills/skill.md",
3929
3790
  "per_page": 25,
3930
3791
  "total": 0
3931
3792
  }
@@ -4041,7 +3902,7 @@ var operations = [
4041
3902
  "active": true
4042
3903
  }
4043
3904
  ],
4044
- "path": "example",
3905
+ "path": ".agentmc/skills/skill.md",
4045
3906
  "per_page": 25,
4046
3907
  "total": 0
4047
3908
  }
@@ -4182,7 +4043,7 @@ var operations = [
4182
4043
  "active": true
4183
4044
  }
4184
4045
  ],
4185
- "path": "example",
4046
+ "path": ".agentmc/skills/skill.md",
4186
4047
  "per_page": 25,
4187
4048
  "total": 0
4188
4049
  }
@@ -4331,7 +4192,7 @@ var operations = [
4331
4192
  "active": true
4332
4193
  }
4333
4194
  ],
4334
- "path": "example",
4195
+ "path": ".agentmc/skills/skill.md",
4335
4196
  "per_page": 25,
4336
4197
  "total": 0
4337
4198
  }
@@ -4519,7 +4380,7 @@ var operations = [
4519
4380
  "active": true
4520
4381
  }
4521
4382
  ],
4522
- "path": "example",
4383
+ "path": ".agentmc/skills/skill.md",
4523
4384
  "per_page": 25,
4524
4385
  "total": 0
4525
4386
  }
@@ -4637,7 +4498,7 @@ var operations = [
4637
4498
  "active": true
4638
4499
  }
4639
4500
  ],
4640
- "path": "example",
4501
+ "path": ".agentmc/skills/skill.md",
4641
4502
  "per_page": 25,
4642
4503
  "total": 0
4643
4504
  }