@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/spec/openapi.filtered.json CHANGED
@@ -12,6 +12,75 @@
12
12
  }
13
13
  ],
14
14
  "paths": {
15
+ "/agents/instructions": {
16
+ "get": {
17
+ "tags": [
18
+ "Agents"
19
+ ],
20
+ "summary": "Fetch the AgentMC instruction bundle for the authenticated agent.",
21
+ "description": "Returns managed runtime files and bundle metadata. Send current_bundle_version to fetch files only when the bundle has changed.",
22
+ "operationId": "getAgentInstructions",
23
+ "parameters": [
24
+ {
25
+ "name": "current_bundle_version",
26
+ "in": "query",
27
+ "required": false,
28
+ "description": "Last applied instruction bundle version from local runtime state.",
29
+ "schema": {
30
+ "type": "string"
31
+ },
32
+ "example": "bundle_2fa07fcadd6575cc"
33
+ }
34
+ ],
35
+ "responses": {
36
+ "200": {
37
+ "description": "Instruction bundle returned.",
38
+ "content": {
39
+ "application/json": {
40
+ "schema": {
41
+ "$ref": "#/components/schemas/AgentInstructionsResponse"
42
+ },
43
+ "example": {
44
+ "ok": true,
45
+ "changed": true,
46
+ "bundle_version": "bundle_2fa07fcadd6575cc",
47
+ "generated_at": "2026-02-25T14:10:00Z",
48
+ "defaults": {
49
+ "heartbeat_interval_seconds": 300
50
+ },
51
+ "agent": {
52
+ "id": 42,
53
+ "name": "Agent"
54
+ },
55
+ "files": [
56
+ {
57
+ "id": "skill.md",
58
+ "path": ".agentmc/skills/skill.md",
59
+ "content": "# AgentMC\n",
60
+ "sha256": "f96c95bd27dc9f3415cc0f4d817b5ec6f14185b6fcb5db9f6b6f14f648f8e9e4"
61
+ }
62
+ ]
63
+ }
64
+ }
65
+ }
66
+ },
67
+ "401": {
68
+ "$ref": "#/components/responses/ApiError401"
69
+ },
70
+ "403": {
71
+ "$ref": "#/components/responses/ApiError403"
72
+ },
73
+ "422": {
74
+ "$ref": "#/components/responses/ApiError422"
75
+ }
76
+ },
77
+ "security": [
78
+ {
79
+ "AgentBearerAuth": []
80
+ }
81
+ ]
82
+ }
83
+ },
15
84
  "/agents/{agent}/heartbeat": {
16
85
  "post": {
17
86
  "tags": [
@@ -227,7 +296,7 @@
227
296
  "active": true
228
297
  }
229
298
  ],
230
- "path": "example",
299
+ "path": ".agentmc/skills/skill.md",
231
300
  "per_page": 25,
232
301
  "total": 0
233
302
  }
@@ -501,7 +570,7 @@
501
570
  "active": true
502
571
  }
503
572
  ],
504
- "path": "example",
573
+ "path": ".agentmc/skills/skill.md",
505
574
  "per_page": 25,
506
575
  "total": 0
507
576
  }
@@ -1534,7 +1603,7 @@
1534
1603
  "active": true
1535
1604
  }
1536
1605
  ],
1537
- "path": "example",
1606
+ "path": ".agentmc/skills/skill.md",
1538
1607
  "per_page": 25,
1539
1608
  "total": 0
1540
1609
  }
@@ -2136,7 +2205,7 @@
2136
2205
  "active": true
2137
2206
  }
2138
2207
  ],
2139
- "path": "example",
2208
+ "path": ".agentmc/skills/skill.md",
2140
2209
  "per_page": 25,
2141
2210
  "total": 0
2142
2211
  }
@@ -2621,7 +2690,7 @@
2621
2690
  "active": true
2622
2691
  }
2623
2692
  ],
2624
- "path": "example",
2693
+ "path": ".agentmc/skills/skill.md",
2625
2694
  "per_page": 25,
2626
2695
  "total": 0
2627
2696
  }
@@ -2960,7 +3029,7 @@
2960
3029
  "active": true
2961
3030
  }
2962
3031
  ],
2963
- "path": "example",
3032
+ "path": ".agentmc/skills/skill.md",
2964
3033
  "per_page": 25,
2965
3034
  "total": 0
2966
3035
  }
@@ -3058,7 +3127,7 @@
3058
3127
  "active": true
3059
3128
  }
3060
3129
  ],
3061
- "path": "example",
3130
+ "path": ".agentmc/skills/skill.md",
3062
3131
  "per_page": 25,
3063
3132
  "total": 0
3064
3133
  }
@@ -3161,7 +3230,7 @@
3161
3230
  "active": true
3162
3231
  }
3163
3232
  ],
3164
- "path": "example",
3233
+ "path": ".agentmc/skills/skill.md",
3165
3234
  "per_page": 25,
3166
3235
  "total": 0
3167
3236
  }
@@ -3269,7 +3338,7 @@
3269
3338
  "active": true
3270
3339
  }
3271
3340
  ],
3272
- "path": "example",
3341
+ "path": ".agentmc/skills/skill.md",
3273
3342
  "per_page": 25,
3274
3343
  "total": 0
3275
3344
  }
@@ -3546,7 +3615,7 @@
3546
3615
  "active": true
3547
3616
  }
3548
3617
  ],
3549
- "path": "example",
3618
+ "path": ".agentmc/skills/skill.md",
3550
3619
  "per_page": 25,
3551
3620
  "total": 0
3552
3621
  }
@@ -4364,8 +4433,8 @@
4364
4433
  },
4365
4434
  "path": {
4366
4435
  "type": "string",
4367
- "description": "Path.",
4368
- "example": "example"
4436
+ "description": "Local filesystem path where this file should be written.",
4437
+ "example": ".agentmc/skills/skill.md"
4369
4438
  },
4370
4439
  "per_page": {
4371
4440
  "type": "integer",
@@ -4398,7 +4467,7 @@
4398
4467
  "active": true
4399
4468
  }
4400
4469
  ],
4401
- "path": "example",
4470
+ "path": ".agentmc/skills/skill.md",
4402
4471
  "per_page": 25,
4403
4472
  "total": 0
4404
4473
  }
@@ -4576,7 +4645,7 @@
4576
4645
  "active": true
4577
4646
  }
4578
4647
  ],
4579
- "path": "example",
4648
+ "path": ".agentmc/skills/skill.md",
4580
4649
  "per_page": 25,
4581
4650
  "total": 0
4582
4651
  }
@@ -4611,7 +4680,7 @@
4611
4680
  "active": true
4612
4681
  }
4613
4682
  ],
4614
- "path": "example",
4683
+ "path": ".agentmc/skills/skill.md",
4615
4684
  "per_page": 25,
4616
4685
  "total": 0
4617
4686
  }
@@ -4889,7 +4958,7 @@
4889
4958
  "active": true
4890
4959
  }
4891
4960
  ],
4892
- "path": "example",
4961
+ "path": ".agentmc/skills/skill.md",
4893
4962
  "per_page": 25,
4894
4963
  "total": 0
4895
4964
  }
@@ -4948,7 +5017,7 @@
4948
5017
  "active": true
4949
5018
  }
4950
5019
  ],
4951
- "path": "example",
5020
+ "path": ".agentmc/skills/skill.md",
4952
5021
  "per_page": 25,
4953
5022
  "total": 0
4954
5023
  }
@@ -5852,7 +5921,7 @@
5852
5921
  "active": true
5853
5922
  }
5854
5923
  ],
5855
- "path": "example",
5924
+ "path": ".agentmc/skills/skill.md",
5856
5925
  "per_page": 25,
5857
5926
  "total": 0
5858
5927
  }
@@ -5934,7 +6003,7 @@
5934
6003
  "active": true
5935
6004
  }
5936
6005
  ],
5937
- "path": "example",
6006
+ "path": ".agentmc/skills/skill.md",
5938
6007
  "per_page": 25,
5939
6008
  "total": 0
5940
6009
  }
@@ -6196,8 +6265,8 @@
6196
6265
  },
6197
6266
  "path": {
6198
6267
  "type": "string",
6199
- "description": "Path.",
6200
- "example": "example"
6268
+ "description": "Local filesystem path where this file should be written.",
6269
+ "example": ".agentmc/skills/skill.md"
6201
6270
  }
6202
6271
  },
6203
6272
  "description": "Connection.",
@@ -6208,7 +6277,7 @@
6208
6277
  "host": "ip-10-0-3-42",
6209
6278
  "port": 1,
6210
6279
  "scheme": "example",
6211
- "path": "example"
6280
+ "path": ".agentmc/skills/skill.md"
6212
6281
  }
6213
6282
  },
6214
6283
  "channel": {
@@ -6236,7 +6305,7 @@
6236
6305
  "host": "ip-10-0-3-42",
6237
6306
  "port": 1,
6238
6307
  "scheme": "example",
6239
- "path": "example"
6308
+ "path": ".agentmc/skills/skill.md"
6240
6309
  },
6241
6310
  "channel": "example",
6242
6311
  "event": "example",
@@ -7849,6 +7918,159 @@
7849
7918
  }
7850
7919
  }
7851
7920
  },
7921
+ "AgentInstructionFile": {
7922
+ "type": "object",
7923
+ "required": [
7924
+ "id",
7925
+ "path",
7926
+ "content",
7927
+ "sha256"
7928
+ ],
7929
+ "properties": {
7930
+ "id": {
7931
+ "type": "string",
7932
+ "description": "Unique identifier for this record.",
7933
+ "example": "example"
7934
+ },
7935
+ "path": {
7936
+ "type": "string",
7937
+ "description": "Local filesystem path where this file should be written.",
7938
+ "example": ".agentmc/skills/skill.md"
7939
+ },
7940
+ "content": {
7941
+ "type": "string",
7942
+ "description": "Content.",
7943
+ "example": "Example content."
7944
+ },
7945
+ "sha256": {
7946
+ "type": "string",
7947
+ "description": "SHA-256 checksum for file content.",
7948
+ "example": "f96c95bd27dc9f3415cc0f4d817b5ec6f14185b6fcb5db9f6b6f14f648f8e9e4"
7949
+ }
7950
+ },
7951
+ "description": "Agent Instruction File schema.",
7952
+ "example": {
7953
+ "id": "example",
7954
+ "path": ".agentmc/skills/skill.md",
7955
+ "content": "Example content.",
7956
+ "sha256": "f96c95bd27dc9f3415cc0f4d817b5ec6f14185b6fcb5db9f6b6f14f648f8e9e4"
7957
+ }
7958
+ },
7959
+ "AgentInstructionsResponse": {
7960
+ "type": "object",
7961
+ "required": [
7962
+ "ok",
7963
+ "changed",
7964
+ "bundle_version",
7965
+ "generated_at",
7966
+ "defaults",
7967
+ "agent",
7968
+ "files"
7969
+ ],
7970
+ "properties": {
7971
+ "ok": {
7972
+ "type": "boolean",
7973
+ "description": "Boolean flag for ok.",
7974
+ "example": true
7975
+ },
7976
+ "changed": {
7977
+ "type": "boolean",
7978
+ "description": "True when the runtime should rewrite local managed files from this response.",
7979
+ "example": true
7980
+ },
7981
+ "bundle_version": {
7982
+ "type": "string",
7983
+ "description": "Current instruction bundle version.",
7984
+ "example": "bundle_2fa07fcadd6575cc"
7985
+ },
7986
+ "generated_at": {
7987
+ "type": "string",
7988
+ "format": "date-time",
7989
+ "description": "ISO-8601 generation timestamp.",
7990
+ "example": "2026-02-22T17:21:00Z"
7991
+ },
7992
+ "defaults": {
7993
+ "type": "object",
7994
+ "required": [
7995
+ "heartbeat_interval_seconds"
7996
+ ],
7997
+ "properties": {
7998
+ "heartbeat_interval_seconds": {
7999
+ "type": "integer",
8000
+ "minimum": 5,
8001
+ "description": "Heartbeat interval seconds.",
8002
+ "example": 5
8003
+ }
8004
+ },
8005
+ "description": "Defaults.",
8006
+ "example": {
8007
+ "heartbeat_interval_seconds": 5
8008
+ }
8009
+ },
8010
+ "agent": {
8011
+ "type": "object",
8012
+ "required": [
8013
+ "id",
8014
+ "name"
8015
+ ],
8016
+ "properties": {
8017
+ "id": {
8018
+ "type": "integer",
8019
+ "minimum": 1,
8020
+ "description": "Unique identifier for this record.",
8021
+ "example": 42
8022
+ },
8023
+ "name": {
8024
+ "type": "string",
8025
+ "description": "Human-readable name.",
8026
+ "example": "Example Name"
8027
+ }
8028
+ },
8029
+ "description": "Agent.",
8030
+ "example": {
8031
+ "id": 42,
8032
+ "name": "Example Name"
8033
+ }
8034
+ },
8035
+ "files": {
8036
+ "type": "array",
8037
+ "items": {
8038
+ "$ref": "#/components/schemas/AgentInstructionFile"
8039
+ },
8040
+ "description": "Managed instruction bundle files to write locally.",
8041
+ "example": [
8042
+ {
8043
+ "id": "example",
8044
+ "path": ".agentmc/skills/skill.md",
8045
+ "content": "Example content.",
8046
+ "sha256": "f96c95bd27dc9f3415cc0f4d817b5ec6f14185b6fcb5db9f6b6f14f648f8e9e4"
8047
+ }
8048
+ ]
8049
+ }
8050
+ },
8051
+ "example": {
8052
+ "ok": true,
8053
+ "changed": true,
8054
+ "bundle_version": "bundle_2fa07fcadd6575cc",
8055
+ "generated_at": "2026-02-25T14:10:00Z",
8056
+ "defaults": {
8057
+ "heartbeat_interval_seconds": 300
8058
+ },
8059
+ "agent": {
8060
+ "id": 42,
8061
+ "name": "Agent"
8062
+ },
8063
+ "files": [
8064
+ {
8065
+ "id": "skill.md",
8066
+ "path": ".agentmc/skills/skill.md",
8067
+ "content": "# AgentMC\n",
8068
+ "sha256": "f96c95bd27dc9f3415cc0f4d817b5ec6f14185b6fcb5db9f6b6f14f648f8e9e4"
8069
+ }
8070
+ ]
8071
+ },
8072
+ "description": "Agent Instructions Response response schema."
8073
+ },
7852
8074
  "AgentRealtimeRequestedSessionsResponse": {
7853
8075
  "type": "object",
7854
8076
  "required": [
@@ -8704,7 +8926,7 @@
8704
8926
  "active": true
8705
8927
  }
8706
8928
  ],
8707
- "path": "example",
8929
+ "path": ".agentmc/skills/skill.md",
8708
8930
  "per_page": 25,
8709
8931
  "total": 0
8710
8932
  }
@@ -8742,7 +8964,7 @@
8742
8964
  "active": true
8743
8965
  }
8744
8966
  ],
8745
- "path": "example",
8967
+ "path": ".agentmc/skills/skill.md",
8746
8968
  "per_page": 25,
8747
8969
  "total": 0
8748
8970
  }
@@ -8806,7 +9028,7 @@
8806
9028
  "active": true
8807
9029
  }
8808
9030
  ],
8809
- "path": "example",
9031
+ "path": ".agentmc/skills/skill.md",
8810
9032
  "per_page": 25,
8811
9033
  "total": 0
8812
9034
  }
@@ -8850,7 +9072,7 @@
8850
9072
  "active": true
8851
9073
  }
8852
9074
  ],
8853
- "path": "example",
9075
+ "path": ".agentmc/skills/skill.md",
8854
9076
  "per_page": 25,
8855
9077
  "total": 0
8856
9078
  }
@@ -8917,7 +9139,7 @@
8917
9139
  "active": true
8918
9140
  }
8919
9141
  ],
8920
- "path": "example",
9142
+ "path": ".agentmc/skills/skill.md",
8921
9143
  "per_page": 25,
8922
9144
  "total": 0
8923
9145
  }
@@ -8964,7 +9186,7 @@
8964
9186
  "active": true
8965
9187
  }
8966
9188
  ],
8967
- "path": "example",
9189
+ "path": ".agentmc/skills/skill.md",
8968
9190
  "per_page": 25,
8969
9191
  "total": 0
8970
9192
  }
@@ -9024,7 +9246,7 @@
9024
9246
  "active": true
9025
9247
  }
9026
9248
  ],
9027
- "path": "example",
9249
+ "path": ".agentmc/skills/skill.md",
9028
9250
  "per_page": 25,
9029
9251
  "total": 0
9030
9252
  }
@@ -9064,7 +9286,7 @@
9064
9286
  "active": true
9065
9287
  }
9066
9288
  ],
9067
- "path": "example",
9289
+ "path": ".agentmc/skills/skill.md",
9068
9290
  "per_page": 25,
9069
9291
  "total": 0
9070
9292
  }
@@ -9143,7 +9365,7 @@
9143
9365
  "active": true
9144
9366
  }
9145
9367
  ],
9146
- "path": "example",
9368
+ "path": ".agentmc/skills/skill.md",
9147
9369
  "per_page": 25,
9148
9370
  "total": 0
9149
9371
  }
@@ -9202,7 +9424,7 @@
9202
9424
  "active": true
9203
9425
  }
9204
9426
  ],
9205
- "path": "example",
9427
+ "path": ".agentmc/skills/skill.md",
9206
9428
  "per_page": 25,
9207
9429
  "total": 0
9208
9430
  }
@@ -9274,7 +9496,7 @@
9274
9496
  "active": true
9275
9497
  }
9276
9498
  ],
9277
- "path": "example",
9499
+ "path": ".agentmc/skills/skill.md",
9278
9500
  "per_page": 25,
9279
9501
  "total": 0
9280
9502
  }
@@ -9326,7 +9548,7 @@
9326
9548
  "active": true
9327
9549
  }
9328
9550
  ],
9329
- "path": "example",
9551
+ "path": ".agentmc/skills/skill.md",
9330
9552
  "per_page": 25,
9331
9553
  "total": 0
9332
9554
  }
@@ -9404,7 +9626,7 @@
9404
9626
  "active": true
9405
9627
  }
9406
9628
  ],
9407
- "path": "example",
9629
+ "path": ".agentmc/skills/skill.md",
9408
9630
  "per_page": 25,
9409
9631
  "total": 0
9410
9632
  }
@@ -9462,7 +9684,7 @@
9462
9684
  "active": true
9463
9685
  }
9464
9686
  ],
9465
- "path": "example",
9687
+ "path": ".agentmc/skills/skill.md",
9466
9688
  "per_page": 25,
9467
9689
  "total": 0
9468
9690
  }
@@ -11788,7 +12010,7 @@
11788
12010
  "active": true
11789
12011
  }
11790
12012
  ],
11791
- "path": "example",
12013
+ "path": ".agentmc/skills/skill.md",
11792
12014
  "per_page": 25,
11793
12015
  "total": 0
11794
12016
  }
@@ -11959,6 +12181,37 @@
11959
12181
  }
11960
12182
  }
11961
12183
  },
12184
+ "AgentInstructionsResponse": {
12185
+ "description": "Instruction bundle returned.",
12186
+ "content": {
12187
+ "application/json": {
12188
+ "schema": {
12189
+ "$ref": "#/components/schemas/AgentInstructionsResponse"
12190
+ },
12191
+ "example": {
12192
+ "ok": true,
12193
+ "changed": true,
12194
+ "bundle_version": "bundle_2fa07fcadd6575cc",
12195
+ "generated_at": "2026-02-25T14:10:00Z",
12196
+ "defaults": {
12197
+ "heartbeat_interval_seconds": 300
12198
+ },
12199
+ "agent": {
12200
+ "id": 42,
12201
+ "name": "Agent"
12202
+ },
12203
+ "files": [
12204
+ {
12205
+ "id": "skill.md",
12206
+ "path": ".agentmc/skills/skill.md",
12207
+ "content": "# AgentMC\n",
12208
+ "sha256": "f96c95bd27dc9f3415cc0f4d817b5ec6f14185b6fcb5db9f6b6f14f648f8e9e4"
12209
+ }
12210
+ ]
12211
+ }
12212
+ }
12213
+ }
12214
+ },
11962
12215
  "HostDetailResponse": {
11963
12216
  "description": "Host returned.",
11964
12217
  "content": {