@agentmc/api 0.2.7 → 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.
Files changed (24) hide show
  1. package/dist/cli.js +122 -10
  2. package/dist/cli.js.map +1 -1
  3. package/dist/generated/operations.d.ts +100 -10
  4. package/dist/generated/operations.js +122 -10
  5. package/dist/generated/operations.js.map +1 -1
  6. package/dist/index.d.ts +264 -38
  7. package/dist/index.js +122 -10
  8. package/dist/index.js.map +1 -1
  9. package/docs/operations/README.md +1 -0
  10. package/docs/operations/getAgentInstructions.md +142 -0
  11. package/docs/operations/index.json +122 -10
  12. package/docs/operations/listAgentBriefs.md +1 -1
  13. package/docs/operations/listAgents.md +1 -1
  14. package/docs/operations/listBoards.md +1 -1
  15. package/docs/operations/listCalendar.md +1 -1
  16. package/docs/operations/listHosts.md +1 -1
  17. package/docs/operations/listLogs.md +1 -1
  18. package/docs/operations/listNotifications.md +1 -1
  19. package/docs/operations/listTaskComments.md +1 -1
  20. package/docs/operations/listTasks.md +1 -1
  21. package/docs/operations/listTeamMembers.md +1 -1
  22. package/examples/http/getAgentInstructions.ts +19 -0
  23. package/package.json +1 -1
  24. package/spec/openapi.filtered.json +291 -38
package/dist/index.d.ts CHANGED
@@ -6,6 +6,26 @@ export { operationsById } from './generated/operations.js';
6
6
  * Do not make direct changes to the file.
7
7
  */
8
8
  interface paths {
9
+ "/agents/instructions": {
10
+ parameters: {
11
+ query?: never;
12
+ header?: never;
13
+ path?: never;
14
+ cookie?: never;
15
+ };
16
+ /**
17
+ * Fetch the AgentMC instruction bundle for the authenticated agent.
18
+ * @description Returns managed runtime files and bundle metadata. Send current_bundle_version to fetch files only when the bundle has changed.
19
+ */
20
+ get: operations["getAgentInstructions"];
21
+ put?: never;
22
+ post?: never;
23
+ delete?: never;
24
+ options?: never;
25
+ head?: never;
26
+ patch?: never;
27
+ trace?: never;
28
+ };
9
29
  "/agents/{agent}/heartbeat": {
10
30
  parameters: {
11
31
  query?: never;
@@ -665,7 +685,7 @@ interface components {
665
685
  * "active": true
666
686
  * }
667
687
  * ],
668
- * "path": "example",
688
+ * "path": ".agentmc/skills/skill.md",
669
689
  * "per_page": 25,
670
690
  * "total": 0
671
691
  * }
@@ -698,8 +718,8 @@ interface components {
698
718
  */
699
719
  links?: components["schemas"]["PaginationMetaLink"][];
700
720
  /**
701
- * @description Path.
702
- * @example example
721
+ * @description Local filesystem path where this file should be written.
722
+ * @example .agentmc/skills/skill.md
703
723
  */
704
724
  path: string;
705
725
  /**
@@ -843,7 +863,7 @@ interface components {
843
863
  * "active": true
844
864
  * }
845
865
  * ],
846
- * "path": "example",
866
+ * "path": ".agentmc/skills/skill.md",
847
867
  * "per_page": 25,
848
868
  * "total": 0
849
869
  * }
@@ -887,7 +907,7 @@ interface components {
887
907
  * "active": true
888
908
  * }
889
909
  * ],
890
- * "path": "example",
910
+ * "path": ".agentmc/skills/skill.md",
891
911
  * "per_page": 25,
892
912
  * "total": 0
893
913
  * }
@@ -1093,7 +1113,7 @@ interface components {
1093
1113
  * "active": true
1094
1114
  * }
1095
1115
  * ],
1096
- * "path": "example",
1116
+ * "path": ".agentmc/skills/skill.md",
1097
1117
  * "per_page": 25,
1098
1118
  * "total": 0
1099
1119
  * }
@@ -1161,7 +1181,7 @@ interface components {
1161
1181
  * "active": true
1162
1182
  * }
1163
1183
  * ],
1164
- * "path": "example",
1184
+ * "path": ".agentmc/skills/skill.md",
1165
1185
  * "per_page": 25,
1166
1186
  * "total": 0
1167
1187
  * }
@@ -1945,7 +1965,7 @@ interface components {
1945
1965
  * "active": true
1946
1966
  * }
1947
1967
  * ],
1948
- * "path": "example",
1968
+ * "path": ".agentmc/skills/skill.md",
1949
1969
  * "per_page": 25,
1950
1970
  * "total": 0
1951
1971
  * }
@@ -2036,7 +2056,7 @@ interface components {
2036
2056
  * "active": true
2037
2057
  * }
2038
2058
  * ],
2039
- * "path": "example",
2059
+ * "path": ".agentmc/skills/skill.md",
2040
2060
  * "per_page": 25,
2041
2061
  * "total": 0
2042
2062
  * }
@@ -2217,7 +2237,7 @@ interface components {
2217
2237
  * "host": "ip-10-0-3-42",
2218
2238
  * "port": 1,
2219
2239
  * "scheme": "example",
2220
- * "path": "example"
2240
+ * "path": ".agentmc/skills/skill.md"
2221
2241
  * },
2222
2242
  * "channel": "example",
2223
2243
  * "event": "example",
@@ -2234,7 +2254,7 @@ interface components {
2234
2254
  * "host": "ip-10-0-3-42",
2235
2255
  * "port": 1,
2236
2256
  * "scheme": "example",
2237
- * "path": "example"
2257
+ * "path": ".agentmc/skills/skill.md"
2238
2258
  * }
2239
2259
  */
2240
2260
  connection: {
@@ -2269,8 +2289,8 @@ interface components {
2269
2289
  */
2270
2290
  scheme: string;
2271
2291
  /**
2272
- * @description Path.
2273
- * @example example
2292
+ * @description Local filesystem path where this file should be written.
2293
+ * @example .agentmc/skills/skill.md
2274
2294
  */
2275
2295
  path: string;
2276
2296
  };
@@ -3523,6 +3543,128 @@ interface components {
3523
3543
  */
3524
3544
  agents_meta: components["schemas"]["HostAgentsMeta"];
3525
3545
  };
3546
+ /**
3547
+ * @description Agent Instruction File schema.
3548
+ * @example {
3549
+ * "id": "example",
3550
+ * "path": ".agentmc/skills/skill.md",
3551
+ * "content": "Example content.",
3552
+ * "sha256": "f96c95bd27dc9f3415cc0f4d817b5ec6f14185b6fcb5db9f6b6f14f648f8e9e4"
3553
+ * }
3554
+ */
3555
+ AgentInstructionFile: {
3556
+ /**
3557
+ * @description Unique identifier for this record.
3558
+ * @example example
3559
+ */
3560
+ id: string;
3561
+ /**
3562
+ * @description Local filesystem path where this file should be written.
3563
+ * @example .agentmc/skills/skill.md
3564
+ */
3565
+ path: string;
3566
+ /**
3567
+ * @description Content.
3568
+ * @example Example content.
3569
+ */
3570
+ content: string;
3571
+ /**
3572
+ * @description SHA-256 checksum for file content.
3573
+ * @example f96c95bd27dc9f3415cc0f4d817b5ec6f14185b6fcb5db9f6b6f14f648f8e9e4
3574
+ */
3575
+ sha256: string;
3576
+ };
3577
+ /**
3578
+ * @description Agent Instructions Response response schema.
3579
+ * @example {
3580
+ * "ok": true,
3581
+ * "changed": true,
3582
+ * "bundle_version": "bundle_2fa07fcadd6575cc",
3583
+ * "generated_at": "2026-02-25T14:10:00Z",
3584
+ * "defaults": {
3585
+ * "heartbeat_interval_seconds": 300
3586
+ * },
3587
+ * "agent": {
3588
+ * "id": 42,
3589
+ * "name": "Agent"
3590
+ * },
3591
+ * "files": [
3592
+ * {
3593
+ * "id": "skill.md",
3594
+ * "path": ".agentmc/skills/skill.md",
3595
+ * "content": "# AgentMC\n",
3596
+ * "sha256": "f96c95bd27dc9f3415cc0f4d817b5ec6f14185b6fcb5db9f6b6f14f648f8e9e4"
3597
+ * }
3598
+ * ]
3599
+ * }
3600
+ */
3601
+ AgentInstructionsResponse: {
3602
+ /**
3603
+ * @description Boolean flag for ok.
3604
+ * @example true
3605
+ */
3606
+ ok: boolean;
3607
+ /**
3608
+ * @description True when the runtime should rewrite local managed files from this response.
3609
+ * @example true
3610
+ */
3611
+ changed: boolean;
3612
+ /**
3613
+ * @description Current instruction bundle version.
3614
+ * @example bundle_2fa07fcadd6575cc
3615
+ */
3616
+ bundle_version: string;
3617
+ /**
3618
+ * Format: date-time
3619
+ * @description ISO-8601 generation timestamp.
3620
+ * @example 2026-02-22T17:21:00Z
3621
+ */
3622
+ generated_at: string;
3623
+ /**
3624
+ * @description Defaults.
3625
+ * @example {
3626
+ * "heartbeat_interval_seconds": 5
3627
+ * }
3628
+ */
3629
+ defaults: {
3630
+ /**
3631
+ * @description Heartbeat interval seconds.
3632
+ * @example 5
3633
+ */
3634
+ heartbeat_interval_seconds: number;
3635
+ };
3636
+ /**
3637
+ * @description Agent.
3638
+ * @example {
3639
+ * "id": 42,
3640
+ * "name": "Example Name"
3641
+ * }
3642
+ */
3643
+ agent: {
3644
+ /**
3645
+ * @description Unique identifier for this record.
3646
+ * @example 42
3647
+ */
3648
+ id: number;
3649
+ /**
3650
+ * @description Human-readable name.
3651
+ * @example Example Name
3652
+ */
3653
+ name: string;
3654
+ };
3655
+ /**
3656
+ * @description Managed instruction bundle files to write locally.
3657
+ * @example [
3658
+ * {
3659
+ * "id": "example",
3660
+ * "path": ".agentmc/skills/skill.md",
3661
+ * "content": "Example content.",
3662
+ * "sha256": "f96c95bd27dc9f3415cc0f4d817b5ec6f14185b6fcb5db9f6b6f14f648f8e9e4"
3663
+ * }
3664
+ * ]
3665
+ */
3666
+ files: components["schemas"]["AgentInstructionFile"][];
3667
+ };
3526
3668
  /**
3527
3669
  * @description Agent Realtime Requested Sessions Response response schema.
3528
3670
  * @example {
@@ -4284,7 +4426,7 @@ interface components {
4284
4426
  * "active": true
4285
4427
  * }
4286
4428
  * ],
4287
- * "path": "example",
4429
+ * "path": ".agentmc/skills/skill.md",
4288
4430
  * "per_page": 25,
4289
4431
  * "total": 0
4290
4432
  * }
@@ -4331,7 +4473,7 @@ interface components {
4331
4473
  * "active": true
4332
4474
  * }
4333
4475
  * ],
4334
- * "path": "example",
4476
+ * "path": ".agentmc/skills/skill.md",
4335
4477
  * "per_page": 25,
4336
4478
  * "total": 0
4337
4479
  * }
@@ -4377,7 +4519,7 @@ interface components {
4377
4519
  * "active": true
4378
4520
  * }
4379
4521
  * ],
4380
- * "path": "example",
4522
+ * "path": ".agentmc/skills/skill.md",
4381
4523
  * "per_page": 25,
4382
4524
  * "total": 0
4383
4525
  * }
@@ -4430,7 +4572,7 @@ interface components {
4430
4572
  * "active": true
4431
4573
  * }
4432
4574
  * ],
4433
- * "path": "example",
4575
+ * "path": ".agentmc/skills/skill.md",
4434
4576
  * "per_page": 25,
4435
4577
  * "total": 0
4436
4578
  * }
@@ -4479,7 +4621,7 @@ interface components {
4479
4621
  * "active": true
4480
4622
  * }
4481
4623
  * ],
4482
- * "path": "example",
4624
+ * "path": ".agentmc/skills/skill.md",
4483
4625
  * "per_page": 25,
4484
4626
  * "total": 0
4485
4627
  * }
@@ -4535,7 +4677,7 @@ interface components {
4535
4677
  * "active": true
4536
4678
  * }
4537
4679
  * ],
4538
- * "path": "example",
4680
+ * "path": ".agentmc/skills/skill.md",
4539
4681
  * "per_page": 25,
4540
4682
  * "total": 0
4541
4683
  * }
@@ -4577,7 +4719,7 @@ interface components {
4577
4719
  * "active": true
4578
4720
  * }
4579
4721
  * ],
4580
- * "path": "example",
4722
+ * "path": ".agentmc/skills/skill.md",
4581
4723
  * "per_page": 25,
4582
4724
  * "total": 0
4583
4725
  * }
@@ -4626,7 +4768,7 @@ interface components {
4626
4768
  * "active": true
4627
4769
  * }
4628
4770
  * ],
4629
- * "path": "example",
4771
+ * "path": ".agentmc/skills/skill.md",
4630
4772
  * "per_page": 25,
4631
4773
  * "total": 0
4632
4774
  * }
@@ -4687,7 +4829,7 @@ interface components {
4687
4829
  * "active": true
4688
4830
  * }
4689
4831
  * ],
4690
- * "path": "example",
4832
+ * "path": ".agentmc/skills/skill.md",
4691
4833
  * "per_page": 25,
4692
4834
  * "total": 0
4693
4835
  * }
@@ -4755,7 +4897,7 @@ interface components {
4755
4897
  * "active": true
4756
4898
  * }
4757
4899
  * ],
4758
- * "path": "example",
4900
+ * "path": ".agentmc/skills/skill.md",
4759
4901
  * "per_page": 25,
4760
4902
  * "total": 0
4761
4903
  * }
@@ -4809,7 +4951,7 @@ interface components {
4809
4951
  * "active": true
4810
4952
  * }
4811
4953
  * ],
4812
- * "path": "example",
4954
+ * "path": ".agentmc/skills/skill.md",
4813
4955
  * "per_page": 25,
4814
4956
  * "total": 0
4815
4957
  * }
@@ -4870,7 +5012,7 @@ interface components {
4870
5012
  * "active": true
4871
5013
  * }
4872
5014
  * ],
4873
- * "path": "example",
5015
+ * "path": ".agentmc/skills/skill.md",
4874
5016
  * "per_page": 25,
4875
5017
  * "total": 0
4876
5018
  * }
@@ -4930,7 +5072,7 @@ interface components {
4930
5072
  * "active": true
4931
5073
  * }
4932
5074
  * ],
4933
- * "path": "example",
5075
+ * "path": ".agentmc/skills/skill.md",
4934
5076
  * "per_page": 25,
4935
5077
  * "total": 0
4936
5078
  * }
@@ -4997,7 +5139,7 @@ interface components {
4997
5139
  * "active": true
4998
5140
  * }
4999
5141
  * ],
5000
- * "path": "example",
5142
+ * "path": ".agentmc/skills/skill.md",
5001
5143
  * "per_page": 25,
5002
5144
  * "total": 0
5003
5145
  * }
@@ -6416,7 +6558,7 @@ interface components {
6416
6558
  * "active": true
6417
6559
  * }
6418
6560
  * ],
6419
- * "path": "example",
6561
+ * "path": ".agentmc/skills/skill.md",
6420
6562
  * "per_page": 25,
6421
6563
  * "total": 0
6422
6564
  * }
@@ -6593,6 +6735,38 @@ interface components {
6593
6735
  "application/json": components["schemas"]["AgentRealtimeSocketAuthResponse"];
6594
6736
  };
6595
6737
  };
6738
+ /** @description Instruction bundle returned. */
6739
+ AgentInstructionsResponse: {
6740
+ headers: {
6741
+ [name: string]: unknown;
6742
+ };
6743
+ content: {
6744
+ /**
6745
+ * @example {
6746
+ * "ok": true,
6747
+ * "changed": true,
6748
+ * "bundle_version": "bundle_2fa07fcadd6575cc",
6749
+ * "generated_at": "2026-02-25T14:10:00Z",
6750
+ * "defaults": {
6751
+ * "heartbeat_interval_seconds": 300
6752
+ * },
6753
+ * "agent": {
6754
+ * "id": 42,
6755
+ * "name": "Agent"
6756
+ * },
6757
+ * "files": [
6758
+ * {
6759
+ * "id": "skill.md",
6760
+ * "path": ".agentmc/skills/skill.md",
6761
+ * "content": "# AgentMC\n",
6762
+ * "sha256": "f96c95bd27dc9f3415cc0f4d817b5ec6f14185b6fcb5db9f6b6f14f648f8e9e4"
6763
+ * }
6764
+ * ]
6765
+ * }
6766
+ */
6767
+ "application/json": components["schemas"]["AgentInstructionsResponse"];
6768
+ };
6769
+ };
6596
6770
  /** @description Host returned. */
6597
6771
  HostDetailResponse: {
6598
6772
  headers: {
@@ -7145,6 +7319,58 @@ interface components {
7145
7319
  pathItems: never;
7146
7320
  }
7147
7321
  interface operations {
7322
+ getAgentInstructions: {
7323
+ parameters: {
7324
+ query?: {
7325
+ /**
7326
+ * @description Last applied instruction bundle version from local runtime state.
7327
+ * @example bundle_2fa07fcadd6575cc
7328
+ */
7329
+ current_bundle_version?: string;
7330
+ };
7331
+ header?: never;
7332
+ path?: never;
7333
+ cookie?: never;
7334
+ };
7335
+ requestBody?: never;
7336
+ responses: {
7337
+ /** @description Instruction bundle returned. */
7338
+ 200: {
7339
+ headers: {
7340
+ [name: string]: unknown;
7341
+ };
7342
+ content: {
7343
+ /**
7344
+ * @example {
7345
+ * "ok": true,
7346
+ * "changed": true,
7347
+ * "bundle_version": "bundle_2fa07fcadd6575cc",
7348
+ * "generated_at": "2026-02-25T14:10:00Z",
7349
+ * "defaults": {
7350
+ * "heartbeat_interval_seconds": 300
7351
+ * },
7352
+ * "agent": {
7353
+ * "id": 42,
7354
+ * "name": "Agent"
7355
+ * },
7356
+ * "files": [
7357
+ * {
7358
+ * "id": "skill.md",
7359
+ * "path": ".agentmc/skills/skill.md",
7360
+ * "content": "# AgentMC\n",
7361
+ * "sha256": "f96c95bd27dc9f3415cc0f4d817b5ec6f14185b6fcb5db9f6b6f14f648f8e9e4"
7362
+ * }
7363
+ * ]
7364
+ * }
7365
+ */
7366
+ "application/json": components["schemas"]["AgentInstructionsResponse"];
7367
+ };
7368
+ };
7369
+ 401: components["responses"]["ApiError401"];
7370
+ 403: components["responses"]["ApiError403"];
7371
+ 422: components["responses"]["ApiError422"];
7372
+ };
7373
+ };
7148
7374
  agentHeartbeat: {
7149
7375
  parameters: {
7150
7376
  query?: never;
@@ -7346,7 +7572,7 @@ interface operations {
7346
7572
  * "active": true
7347
7573
  * }
7348
7574
  * ],
7349
- * "path": "example",
7575
+ * "path": ".agentmc/skills/skill.md",
7350
7576
  * "per_page": 25,
7351
7577
  * "total": 0
7352
7578
  * }
@@ -7555,7 +7781,7 @@ interface operations {
7555
7781
  * "active": true
7556
7782
  * }
7557
7783
  * ],
7558
- * "path": "example",
7784
+ * "path": ".agentmc/skills/skill.md",
7559
7785
  * "per_page": 25,
7560
7786
  * "total": 0
7561
7787
  * }
@@ -8234,7 +8460,7 @@ interface operations {
8234
8460
  * "active": true
8235
8461
  * }
8236
8462
  * ],
8237
- * "path": "example",
8463
+ * "path": ".agentmc/skills/skill.md",
8238
8464
  * "per_page": 25,
8239
8465
  * "total": 0
8240
8466
  * }
@@ -8651,7 +8877,7 @@ interface operations {
8651
8877
  * "active": true
8652
8878
  * }
8653
8879
  * ],
8654
- * "path": "example",
8880
+ * "path": ".agentmc/skills/skill.md",
8655
8881
  * "per_page": 25,
8656
8882
  * "total": 0
8657
8883
  * }
@@ -8927,7 +9153,7 @@ interface operations {
8927
9153
  * "active": true
8928
9154
  * }
8929
9155
  * ],
8930
- * "path": "example",
9156
+ * "path": ".agentmc/skills/skill.md",
8931
9157
  * "per_page": 25,
8932
9158
  * "total": 0
8933
9159
  * }
@@ -9174,7 +9400,7 @@ interface operations {
9174
9400
  * "active": true
9175
9401
  * }
9176
9402
  * ],
9177
- * "path": "example",
9403
+ * "path": ".agentmc/skills/skill.md",
9178
9404
  * "per_page": 25,
9179
9405
  * "total": 0
9180
9406
  * }
@@ -9242,7 +9468,7 @@ interface operations {
9242
9468
  * "active": true
9243
9469
  * }
9244
9470
  * ],
9245
- * "path": "example",
9471
+ * "path": ".agentmc/skills/skill.md",
9246
9472
  * "per_page": 25,
9247
9473
  * "total": 0
9248
9474
  * }
@@ -9310,7 +9536,7 @@ interface operations {
9310
9536
  * "active": true
9311
9537
  * }
9312
9538
  * ],
9313
- * "path": "example",
9539
+ * "path": ".agentmc/skills/skill.md",
9314
9540
  * "per_page": 25,
9315
9541
  * "total": 0
9316
9542
  * }
@@ -9401,7 +9627,7 @@ interface operations {
9401
9627
  * "active": true
9402
9628
  * }
9403
9629
  * ],
9404
- * "path": "example",
9630
+ * "path": ".agentmc/skills/skill.md",
9405
9631
  * "per_page": 25,
9406
9632
  * "total": 0
9407
9633
  * }
@@ -9633,7 +9859,7 @@ interface operations {
9633
9859
  * "active": true
9634
9860
  * }
9635
9861
  * ],
9636
- * "path": "example",
9862
+ * "path": ".agentmc/skills/skill.md",
9637
9863
  * "per_page": 25,
9638
9864
  * "total": 0
9639
9865
  * }