@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.
@@ -198,84 +198,6 @@ declare const operations: readonly [{
198
198
  };
199
199
  };
200
200
  }];
201
- }, {
202
- readonly operationId: "agentInstructions";
203
- readonly method: "get";
204
- readonly path: "/agents/{agent}/agent-instructions";
205
- readonly summary: "Return agent instructions for a connected agent using bearer auth.";
206
- readonly description: "";
207
- readonly tags: ["Agents"];
208
- readonly security: [["AgentBearerAuth"]];
209
- readonly parameters: [{
210
- readonly name: "agent";
211
- readonly in: "path";
212
- readonly required: true;
213
- readonly description: "Agent identifier.";
214
- readonly example: 1;
215
- }];
216
- readonly requestBodyRequired: false;
217
- readonly requestExamples: [];
218
- readonly responses: [{
219
- readonly status: "200";
220
- readonly mediaType: "application/json";
221
- readonly description: "Agent instructions returned.";
222
- readonly hasContent: true;
223
- readonly example: {
224
- readonly agent_instructions: "# Agent Instructions";
225
- readonly agent_instructions_version: "32fe7fd14fca2d57c545f5f78f4a1c094f9ac1b3a1e8f6f9f8323b67a0ef9cc3";
226
- readonly docs: readonly [];
227
- readonly schedules: readonly [];
228
- readonly config: {};
229
- };
230
- }, {
231
- readonly status: "401";
232
- readonly mediaType: "application/json";
233
- readonly description: "Missing or invalid credentials.";
234
- readonly hasContent: true;
235
- readonly example: {
236
- readonly error: {
237
- readonly code: "validation.failed";
238
- readonly message: "Validation failed.";
239
- readonly details: {
240
- readonly fields: {
241
- readonly title: readonly ["The title field is required."];
242
- };
243
- };
244
- };
245
- };
246
- }, {
247
- readonly status: "403";
248
- readonly mediaType: "application/json";
249
- readonly description: "Forbidden.";
250
- readonly hasContent: true;
251
- readonly example: {
252
- readonly error: {
253
- readonly code: "validation.failed";
254
- readonly message: "Validation failed.";
255
- readonly details: {
256
- readonly fields: {
257
- readonly title: readonly ["The title field is required."];
258
- };
259
- };
260
- };
261
- };
262
- }, {
263
- readonly status: "404";
264
- readonly mediaType: "application/json";
265
- readonly description: "Resource not found.";
266
- readonly hasContent: true;
267
- readonly example: {
268
- readonly error: {
269
- readonly code: "validation.failed";
270
- readonly message: "Validation failed.";
271
- readonly details: {
272
- readonly fields: {
273
- readonly title: readonly ["The title field is required."];
274
- };
275
- };
276
- };
277
- };
278
- }];
279
201
  }, {
280
202
  readonly operationId: "authenticateAgentRealtimeSocket";
281
203
  readonly method: "post";
@@ -752,131 +674,6 @@ declare const operations: readonly [{
752
674
  };
753
675
  };
754
676
  }];
755
- }, {
756
- readonly operationId: "connectAgent";
757
- readonly method: "post";
758
- readonly path: "/agents/connect";
759
- readonly summary: "Connect and register one agent using a short-lived connect token.";
760
- readonly description: "";
761
- readonly tags: ["Agents"];
762
- readonly security: [["ConnectTokenAuth"]];
763
- readonly parameters: [];
764
- readonly requestBodyRequired: true;
765
- readonly requestExamples: [{
766
- readonly mediaType: "application/json";
767
- readonly example: {
768
- readonly host: "ip-10-0-3-42";
769
- readonly runtime_version: "2026.02.1";
770
- readonly capabilities: readonly ["tasks", "calendar", "realtime"];
771
- readonly agents_md: "# Existing AGENTS.md\n\n## Runtime\n- Keep heartbeat alive.\n";
772
- readonly models: readonly [{
773
- readonly model_id: "openai/gpt-5-codex";
774
- readonly provider: "openai";
775
- }, {
776
- readonly model_id: "anthropic/claude-sonnet-4-20250514";
777
- readonly provider: "anthropic";
778
- }];
779
- readonly identity: {
780
- readonly name: "Jarvis";
781
- readonly creature: "robot";
782
- readonly vibe: "calm";
783
- };
784
- readonly metadata: {
785
- readonly hostname: "worker-01";
786
- readonly ip: "10.0.2.15";
787
- readonly network: {
788
- readonly private_ip: "10.0.2.15";
789
- readonly public_ip: "34.201.22.9";
790
- };
791
- readonly os: "Ubuntu";
792
- readonly os_version: "22.04";
793
- readonly arch: "x86_64";
794
- readonly cpu: "Intel Xeon";
795
- readonly cpu_cores: 8;
796
- readonly ram_gb: 32;
797
- readonly disk: {
798
- readonly total_bytes: 512110190592;
799
- readonly free_bytes: 321102110720;
800
- };
801
- readonly uptime_seconds: 86400;
802
- readonly runtime: {
803
- readonly name: "codex";
804
- readonly version: "2026.02.1";
805
- };
806
- readonly identity: {
807
- readonly name: "Jarvis";
808
- };
809
- };
810
- };
811
- }];
812
- readonly responses: [{
813
- readonly status: "201";
814
- readonly mediaType: "application/json";
815
- readonly description: "Agent connected and bearer token issued.";
816
- readonly hasContent: true;
817
- readonly example: {
818
- readonly agent_id: 42;
819
- readonly agent_token: "mca_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
820
- readonly agent_instructions_endpoint: "https://agentmc.example.com/api/v1/agents/42/agent-instructions";
821
- readonly agent_authenticated_instructions_endpoint: "https://agentmc.example.com/api/v1/agents/42/agent-instructions";
822
- readonly agent_instructions_version: "32fe7fd14fca2d57c545f5f78f4a1c094f9ac1b3a1e8f6f9f8323b67a0ef9cc3";
823
- readonly openapi_url: "https://agentmc.example.com/api/openapi.json";
824
- readonly workspace: {
825
- readonly id: 7;
826
- readonly name: "AgentMC Demo Workspace";
827
- };
828
- readonly server_time: "2026-02-22T17:20:53Z";
829
- readonly first_sync_required: true;
830
- };
831
- }, {
832
- readonly status: "401";
833
- readonly mediaType: "application/json";
834
- readonly description: "Missing or invalid credentials.";
835
- readonly hasContent: true;
836
- readonly example: {
837
- readonly error: {
838
- readonly code: "validation.failed";
839
- readonly message: "Validation failed.";
840
- readonly details: {
841
- readonly fields: {
842
- readonly title: readonly ["The title field is required."];
843
- };
844
- };
845
- };
846
- };
847
- }, {
848
- readonly status: "403";
849
- readonly mediaType: "application/json";
850
- readonly description: "Forbidden.";
851
- readonly hasContent: true;
852
- readonly example: {
853
- readonly error: {
854
- readonly code: "validation.failed";
855
- readonly message: "Validation failed.";
856
- readonly details: {
857
- readonly fields: {
858
- readonly title: readonly ["The title field is required."];
859
- };
860
- };
861
- };
862
- };
863
- }, {
864
- readonly status: "422";
865
- readonly mediaType: "application/json";
866
- readonly description: "Validation failed.";
867
- readonly hasContent: true;
868
- readonly example: {
869
- readonly error: {
870
- readonly code: "validation.failed";
871
- readonly message: "Validation failed.";
872
- readonly details: {
873
- readonly fields: {
874
- readonly title: readonly ["The title field is required."];
875
- };
876
- };
877
- };
878
- };
879
- }];
880
677
  }, {
881
678
  readonly operationId: "createAgentBrief";
882
679
  readonly method: "post";
@@ -2266,6 +2063,96 @@ declare const operations: readonly [{
2266
2063
  };
2267
2064
  };
2268
2065
  }];
2066
+ }, {
2067
+ readonly operationId: "getAgentInstructions";
2068
+ readonly method: "get";
2069
+ readonly path: "/agents/instructions";
2070
+ readonly summary: "Fetch the AgentMC instruction bundle for the authenticated agent.";
2071
+ readonly description: "Returns managed runtime files and bundle metadata. Send current_bundle_version to fetch files only when the bundle has changed.";
2072
+ readonly tags: ["Agents"];
2073
+ readonly security: [["AgentBearerAuth"]];
2074
+ readonly parameters: [{
2075
+ readonly name: "current_bundle_version";
2076
+ readonly in: "query";
2077
+ readonly required: false;
2078
+ readonly description: "Last applied instruction bundle version from local runtime state.";
2079
+ readonly example: "bundle_2fa07fcadd6575cc";
2080
+ }];
2081
+ readonly requestBodyRequired: false;
2082
+ readonly requestExamples: [];
2083
+ readonly responses: [{
2084
+ readonly status: "200";
2085
+ readonly mediaType: "application/json";
2086
+ readonly description: "Instruction bundle returned.";
2087
+ readonly hasContent: true;
2088
+ readonly example: {
2089
+ readonly ok: true;
2090
+ readonly changed: true;
2091
+ readonly bundle_version: "bundle_2fa07fcadd6575cc";
2092
+ readonly generated_at: "2026-02-25T14:10:00Z";
2093
+ readonly defaults: {
2094
+ readonly heartbeat_interval_seconds: 300;
2095
+ };
2096
+ readonly agent: {
2097
+ readonly id: 42;
2098
+ readonly name: "Agent";
2099
+ };
2100
+ readonly files: readonly [{
2101
+ readonly id: "skill.md";
2102
+ readonly path: ".agentmc/skills/skill.md";
2103
+ readonly content: "# AgentMC\n";
2104
+ readonly sha256: "f96c95bd27dc9f3415cc0f4d817b5ec6f14185b6fcb5db9f6b6f14f648f8e9e4";
2105
+ }];
2106
+ };
2107
+ }, {
2108
+ readonly status: "401";
2109
+ readonly mediaType: "application/json";
2110
+ readonly description: "Missing or invalid credentials.";
2111
+ readonly hasContent: true;
2112
+ readonly example: {
2113
+ readonly error: {
2114
+ readonly code: "validation.failed";
2115
+ readonly message: "Validation failed.";
2116
+ readonly details: {
2117
+ readonly fields: {
2118
+ readonly title: readonly ["The title field is required."];
2119
+ };
2120
+ };
2121
+ };
2122
+ };
2123
+ }, {
2124
+ readonly status: "403";
2125
+ readonly mediaType: "application/json";
2126
+ readonly description: "Forbidden.";
2127
+ readonly hasContent: true;
2128
+ readonly example: {
2129
+ readonly error: {
2130
+ readonly code: "validation.failed";
2131
+ readonly message: "Validation failed.";
2132
+ readonly details: {
2133
+ readonly fields: {
2134
+ readonly title: readonly ["The title field is required."];
2135
+ };
2136
+ };
2137
+ };
2138
+ };
2139
+ }, {
2140
+ readonly status: "422";
2141
+ readonly mediaType: "application/json";
2142
+ readonly description: "Validation failed.";
2143
+ readonly hasContent: true;
2144
+ readonly example: {
2145
+ readonly error: {
2146
+ readonly code: "validation.failed";
2147
+ readonly message: "Validation failed.";
2148
+ readonly details: {
2149
+ readonly fields: {
2150
+ readonly title: readonly ["The title field is required."];
2151
+ };
2152
+ };
2153
+ };
2154
+ };
2155
+ }];
2269
2156
  }, {
2270
2157
  readonly operationId: "listAgentBriefs";
2271
2158
  readonly method: "get";
@@ -2373,7 +2260,7 @@ declare const operations: readonly [{
2373
2260
  readonly label: "example";
2374
2261
  readonly active: true;
2375
2262
  }];
2376
- readonly path: "example";
2263
+ readonly path: ".agentmc/skills/skill.md";
2377
2264
  readonly per_page: 25;
2378
2265
  readonly total: 0;
2379
2266
  };
@@ -2735,7 +2622,6 @@ declare const operations: readonly [{
2735
2622
  }];
2736
2623
  };
2737
2624
  readonly last_seen_at: "2026-02-24T02:11:00Z";
2738
- readonly first_sync_at: "2026-02-24T02:01:00Z";
2739
2625
  readonly tasks_count: 3;
2740
2626
  readonly created_at: "2026-02-24T01:56:00Z";
2741
2627
  readonly updated_at: "2026-02-24T02:11:00Z";
@@ -2755,7 +2641,7 @@ declare const operations: readonly [{
2755
2641
  readonly label: "example";
2756
2642
  readonly active: true;
2757
2643
  }];
2758
- readonly path: "example";
2644
+ readonly path: ".agentmc/skills/skill.md";
2759
2645
  readonly per_page: 25;
2760
2646
  readonly total: 0;
2761
2647
  };
@@ -2854,7 +2740,7 @@ declare const operations: readonly [{
2854
2740
  readonly label: "example";
2855
2741
  readonly active: true;
2856
2742
  }];
2857
- readonly path: "example";
2743
+ readonly path: ".agentmc/skills/skill.md";
2858
2744
  readonly per_page: 25;
2859
2745
  readonly total: 0;
2860
2746
  };
@@ -3008,7 +2894,7 @@ declare const operations: readonly [{
3008
2894
  readonly label: "example";
3009
2895
  readonly active: true;
3010
2896
  }];
3011
- readonly path: "example";
2897
+ readonly path: ".agentmc/skills/skill.md";
3012
2898
  readonly per_page: 25;
3013
2899
  readonly total: 0;
3014
2900
  };
@@ -3121,7 +3007,7 @@ declare const operations: readonly [{
3121
3007
  readonly label: "example";
3122
3008
  readonly active: true;
3123
3009
  }];
3124
- readonly path: "example";
3010
+ readonly path: ".agentmc/skills/skill.md";
3125
3011
  readonly per_page: 25;
3126
3012
  readonly total: 0;
3127
3013
  };
@@ -3210,7 +3096,7 @@ declare const operations: readonly [{
3210
3096
  readonly label: "example";
3211
3097
  readonly active: true;
3212
3098
  }];
3213
- readonly path: "example";
3099
+ readonly path: ".agentmc/skills/skill.md";
3214
3100
  readonly per_page: 25;
3215
3101
  readonly total: 0;
3216
3102
  };
@@ -3323,7 +3209,7 @@ declare const operations: readonly [{
3323
3209
  readonly label: "example";
3324
3210
  readonly active: true;
3325
3211
  }];
3326
- readonly path: "example";
3212
+ readonly path: ".agentmc/skills/skill.md";
3327
3213
  readonly per_page: 25;
3328
3214
  readonly total: 0;
3329
3215
  };
@@ -3439,7 +3325,7 @@ declare const operations: readonly [{
3439
3325
  readonly label: "example";
3440
3326
  readonly active: true;
3441
3327
  }];
3442
- readonly path: "example";
3328
+ readonly path: ".agentmc/skills/skill.md";
3443
3329
  readonly per_page: 25;
3444
3330
  readonly total: 0;
3445
3331
  };
@@ -3590,7 +3476,7 @@ declare const operations: readonly [{
3590
3476
  readonly label: "example";
3591
3477
  readonly active: true;
3592
3478
  }];
3593
- readonly path: "example";
3479
+ readonly path: ".agentmc/skills/skill.md";
3594
3480
  readonly per_page: 25;
3595
3481
  readonly total: 0;
3596
3482
  };
@@ -3680,7 +3566,7 @@ declare const operations: readonly [{
3680
3566
  readonly label: "example";
3681
3567
  readonly active: true;
3682
3568
  }];
3683
- readonly path: "example";
3569
+ readonly path: ".agentmc/skills/skill.md";
3684
3570
  readonly per_page: 25;
3685
3571
  readonly total: 0;
3686
3572
  };