@detergent-software/atk 9.6.0-dev.1 → 9.6.0-dev.11

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 (225) hide show
  1. package/CHANGELOG.md +82 -0
  2. package/README.md +10 -7
  3. package/build/command-manifest.json +120 -12
  4. package/build/commands/browse.d.ts +1 -0
  5. package/build/commands/browse.d.ts.map +1 -1
  6. package/build/commands/browse.js +12 -7
  7. package/build/commands/browse.js.map +1 -1
  8. package/build/commands/deprecate.d.ts +5 -5
  9. package/build/commands/deprecate.d.ts.map +1 -1
  10. package/build/commands/deprecate.js +31 -43
  11. package/build/commands/deprecate.js.map +1 -1
  12. package/build/commands/info.d.ts.map +1 -1
  13. package/build/commands/info.js +20 -39
  14. package/build/commands/info.js.map +1 -1
  15. package/build/commands/init.js +1 -1
  16. package/build/commands/init.js.map +1 -1
  17. package/build/commands/install.d.ts.map +1 -1
  18. package/build/commands/install.js +65 -12
  19. package/build/commands/install.js.map +1 -1
  20. package/build/commands/list.js +7 -7
  21. package/build/commands/list.js.map +1 -1
  22. package/build/commands/move.d.ts +5 -4
  23. package/build/commands/move.d.ts.map +1 -1
  24. package/build/commands/move.js +219 -89
  25. package/build/commands/move.js.map +1 -1
  26. package/build/commands/outdated.d.ts.map +1 -1
  27. package/build/commands/outdated.js +6 -4
  28. package/build/commands/outdated.js.map +1 -1
  29. package/build/commands/promote.d.ts +3 -3
  30. package/build/commands/promote.d.ts.map +1 -1
  31. package/build/commands/promote.js +19 -16
  32. package/build/commands/promote.js.map +1 -1
  33. package/build/commands/search.d.ts +1 -0
  34. package/build/commands/search.d.ts.map +1 -1
  35. package/build/commands/search.js +9 -5
  36. package/build/commands/search.js.map +1 -1
  37. package/build/commands/star.d.ts +23 -0
  38. package/build/commands/star.d.ts.map +1 -0
  39. package/build/commands/star.js +36 -0
  40. package/build/commands/star.js.map +1 -0
  41. package/build/commands/stars.d.ts +11 -0
  42. package/build/commands/stars.d.ts.map +1 -0
  43. package/build/commands/stars.js +57 -0
  44. package/build/commands/stars.js.map +1 -0
  45. package/build/commands/unpublish.d.ts +3 -3
  46. package/build/commands/unpublish.d.ts.map +1 -1
  47. package/build/commands/unpublish.js +20 -37
  48. package/build/commands/unpublish.js.map +1 -1
  49. package/build/commands/unstar.d.ts +23 -0
  50. package/build/commands/unstar.d.ts.map +1 -0
  51. package/build/commands/unstar.js +36 -0
  52. package/build/commands/unstar.js.map +1 -0
  53. package/build/commands/update.d.ts +1 -0
  54. package/build/commands/update.d.ts.map +1 -1
  55. package/build/commands/update.js +82 -4
  56. package/build/commands/update.js.map +1 -1
  57. package/build/components/AssetTable.d.ts +3 -1
  58. package/build/components/AssetTable.d.ts.map +1 -1
  59. package/build/components/AssetTable.js +11 -4
  60. package/build/components/AssetTable.js.map +1 -1
  61. package/build/components/BrowseExpandedRow.d.ts.map +1 -1
  62. package/build/components/BrowseExpandedRow.js +1 -1
  63. package/build/components/BrowseExpandedRow.js.map +1 -1
  64. package/build/components/BrowseList.d.ts +1 -1
  65. package/build/components/BrowseList.d.ts.map +1 -1
  66. package/build/components/BrowseList.js +10 -7
  67. package/build/components/BrowseList.js.map +1 -1
  68. package/build/components/DeprecationSummary.d.ts.map +1 -1
  69. package/build/components/DeprecationSummary.js +22 -5
  70. package/build/components/DeprecationSummary.js.map +1 -1
  71. package/build/components/InstallSummary.d.ts +4 -2
  72. package/build/components/InstallSummary.d.ts.map +1 -1
  73. package/build/components/InstallSummary.js +13 -4
  74. package/build/components/InstallSummary.js.map +1 -1
  75. package/build/components/ListBrowseList.d.ts +7 -6
  76. package/build/components/ListBrowseList.d.ts.map +1 -1
  77. package/build/components/ListBrowseList.js +15 -11
  78. package/build/components/ListBrowseList.js.map +1 -1
  79. package/build/components/PluginReviewQuestion.d.ts +22 -0
  80. package/build/components/PluginReviewQuestion.d.ts.map +1 -0
  81. package/build/components/PluginReviewQuestion.js +30 -0
  82. package/build/components/PluginReviewQuestion.js.map +1 -0
  83. package/build/components/RegistryChangeSummary.d.ts +6 -0
  84. package/build/components/RegistryChangeSummary.d.ts.map +1 -1
  85. package/build/components/RegistryChangeSummary.js +19 -1
  86. package/build/components/RegistryChangeSummary.js.map +1 -1
  87. package/build/components/StarCommand.d.ts +17 -0
  88. package/build/components/StarCommand.d.ts.map +1 -0
  89. package/build/components/StarCommand.js +53 -0
  90. package/build/components/StarCommand.js.map +1 -0
  91. package/build/components/StarResult.d.ts +7 -0
  92. package/build/components/StarResult.d.ts.map +1 -0
  93. package/build/components/StarResult.js +24 -0
  94. package/build/components/StarResult.js.map +1 -0
  95. package/build/components/UsageFields.d.ts +1 -1
  96. package/build/components/UsageFields.d.ts.map +1 -1
  97. package/build/components/UsageFields.js +2 -2
  98. package/build/components/UsageFields.js.map +1 -1
  99. package/build/hooks/useBrowseState.d.ts +4 -2
  100. package/build/hooks/useBrowseState.d.ts.map +1 -1
  101. package/build/hooks/useBrowseState.js +17 -11
  102. package/build/hooks/useBrowseState.js.map +1 -1
  103. package/build/lib/adapter.d.ts.map +1 -1
  104. package/build/lib/adapter.js +1 -0
  105. package/build/lib/adapter.js.map +1 -1
  106. package/build/lib/atk-api/client.d.ts +65 -13
  107. package/build/lib/atk-api/client.d.ts.map +1 -1
  108. package/build/lib/atk-api/client.js +82 -32
  109. package/build/lib/atk-api/client.js.map +1 -1
  110. package/build/lib/atk-api/domain.d.ts +23 -2
  111. package/build/lib/atk-api/domain.d.ts.map +1 -1
  112. package/build/lib/atk-api/domain.js.map +1 -1
  113. package/build/lib/atk-api/errors.d.ts +10 -2
  114. package/build/lib/atk-api/errors.d.ts.map +1 -1
  115. package/build/lib/atk-api/errors.js +9 -1
  116. package/build/lib/atk-api/errors.js.map +1 -1
  117. package/build/lib/atk-api/generated/index.d.ts +2 -2
  118. package/build/lib/atk-api/generated/index.d.ts.map +1 -1
  119. package/build/lib/atk-api/generated/index.js +1 -1
  120. package/build/lib/atk-api/generated/index.js.map +1 -1
  121. package/build/lib/atk-api/generated/sdk.gen.d.ts +20 -8
  122. package/build/lib/atk-api/generated/sdk.gen.d.ts.map +1 -1
  123. package/build/lib/atk-api/generated/sdk.gen.js +31 -7
  124. package/build/lib/atk-api/generated/sdk.gen.js.map +1 -1
  125. package/build/lib/atk-api/generated/types.gen.d.ts +378 -22
  126. package/build/lib/atk-api/generated/types.gen.d.ts.map +1 -1
  127. package/build/lib/atk-api/index.d.ts +4 -4
  128. package/build/lib/atk-api/index.d.ts.map +1 -1
  129. package/build/lib/atk-api/index.js +1 -1
  130. package/build/lib/atk-api/index.js.map +1 -1
  131. package/build/lib/atk-api/testing.d.ts +6 -1
  132. package/build/lib/atk-api/testing.d.ts.map +1 -1
  133. package/build/lib/atk-api/testing.js +31 -1
  134. package/build/lib/atk-api/testing.js.map +1 -1
  135. package/build/lib/atk-api/web-routes.d.ts +11 -3
  136. package/build/lib/atk-api/web-routes.d.ts.map +1 -1
  137. package/build/lib/atk-api/web-routes.js +8 -1
  138. package/build/lib/atk-api/web-routes.js.map +1 -1
  139. package/build/lib/atk-schemas/index.d.ts +5 -0
  140. package/build/lib/atk-schemas/index.d.ts.map +1 -1
  141. package/build/lib/atk-schemas/index.js +5 -0
  142. package/build/lib/atk-schemas/index.js.map +1 -1
  143. package/build/lib/atk-schemas/manifest.d.ts +7 -0
  144. package/build/lib/atk-schemas/manifest.d.ts.map +1 -1
  145. package/build/lib/atk-schemas/manifest.js +7 -0
  146. package/build/lib/atk-schemas/manifest.js.map +1 -1
  147. package/build/lib/atk-schemas/registry.d.ts +20 -0
  148. package/build/lib/atk-schemas/registry.d.ts.map +1 -1
  149. package/build/lib/atk-schemas/registry.js +10 -0
  150. package/build/lib/atk-schemas/registry.js.map +1 -1
  151. package/build/lib/atk-schemas/unknown-types.d.ts +39 -0
  152. package/build/lib/atk-schemas/unknown-types.d.ts.map +1 -0
  153. package/build/lib/atk-schemas/unknown-types.js +138 -0
  154. package/build/lib/atk-schemas/unknown-types.js.map +1 -0
  155. package/build/lib/checksum.d.ts +4 -3
  156. package/build/lib/checksum.d.ts.map +1 -1
  157. package/build/lib/checksum.js +5 -4
  158. package/build/lib/checksum.js.map +1 -1
  159. package/build/lib/claude-code-version.d.ts +37 -0
  160. package/build/lib/claude-code-version.d.ts.map +1 -0
  161. package/build/lib/claude-code-version.js +75 -0
  162. package/build/lib/claude-code-version.js.map +1 -0
  163. package/build/lib/cross-scope.d.ts +2 -0
  164. package/build/lib/cross-scope.d.ts.map +1 -1
  165. package/build/lib/cross-scope.js +4 -3
  166. package/build/lib/cross-scope.js.map +1 -1
  167. package/build/lib/diagnostics.d.ts.map +1 -1
  168. package/build/lib/diagnostics.js +19 -9
  169. package/build/lib/diagnostics.js.map +1 -1
  170. package/build/lib/init.d.ts +2 -2
  171. package/build/lib/init.d.ts.map +1 -1
  172. package/build/lib/init.js +2 -1
  173. package/build/lib/init.js.map +1 -1
  174. package/build/lib/mover.d.ts +50 -0
  175. package/build/lib/mover.d.ts.map +1 -1
  176. package/build/lib/mover.js +207 -54
  177. package/build/lib/mover.js.map +1 -1
  178. package/build/lib/multi-tool-install.d.ts +5 -2
  179. package/build/lib/multi-tool-install.d.ts.map +1 -1
  180. package/build/lib/multi-tool-install.js +8 -5
  181. package/build/lib/multi-tool-install.js.map +1 -1
  182. package/build/lib/owned-paths.d.ts +5 -0
  183. package/build/lib/owned-paths.d.ts.map +1 -1
  184. package/build/lib/owned-paths.js +8 -0
  185. package/build/lib/owned-paths.js.map +1 -1
  186. package/build/lib/plugin-review.d.ts +77 -0
  187. package/build/lib/plugin-review.d.ts.map +1 -0
  188. package/build/lib/plugin-review.js +124 -0
  189. package/build/lib/plugin-review.js.map +1 -0
  190. package/build/lib/publisher.d.ts.map +1 -1
  191. package/build/lib/publisher.js +23 -16
  192. package/build/lib/publisher.js.map +1 -1
  193. package/build/lib/registry-change-json.d.ts +94 -3
  194. package/build/lib/registry-change-json.d.ts.map +1 -1
  195. package/build/lib/registry-change-json.js +76 -7
  196. package/build/lib/registry-change-json.js.map +1 -1
  197. package/build/lib/registry-mutate.d.ts +41 -1
  198. package/build/lib/registry-mutate.d.ts.map +1 -1
  199. package/build/lib/registry-mutate.js +178 -6
  200. package/build/lib/registry-mutate.js.map +1 -1
  201. package/build/lib/registry.d.ts.map +1 -1
  202. package/build/lib/registry.js +10 -3
  203. package/build/lib/registry.js.map +1 -1
  204. package/build/lib/schemas/index.d.ts +1 -1
  205. package/build/lib/schemas/index.d.ts.map +1 -1
  206. package/build/lib/schemas/index.js +1 -1
  207. package/build/lib/schemas/index.js.map +1 -1
  208. package/build/lib/search.d.ts +4 -4
  209. package/build/lib/search.d.ts.map +1 -1
  210. package/build/lib/search.js +7 -7
  211. package/build/lib/search.js.map +1 -1
  212. package/build/lib/stars.d.ts +46 -0
  213. package/build/lib/stars.d.ts.map +1 -0
  214. package/build/lib/stars.js +100 -0
  215. package/build/lib/stars.js.map +1 -0
  216. package/build/lib/subject.d.ts +52 -0
  217. package/build/lib/subject.d.ts.map +1 -0
  218. package/build/lib/subject.js +51 -0
  219. package/build/lib/subject.js.map +1 -0
  220. package/build/lib/usage.d.ts +11 -2
  221. package/build/lib/usage.d.ts.map +1 -1
  222. package/build/lib/usage.js +24 -8
  223. package/build/lib/usage.js.map +1 -1
  224. package/package.json +1 -1
  225. package/tool-adapters/claude-code.json +10 -1
@@ -31,7 +31,7 @@ export type ApiErrorDetail = {
31
31
  */
32
32
  path?: string | null;
33
33
  /**
34
- * Publish only: index into the request's `dependencies` when the problem is in that entry; `path` is then relative to the entry, as it is to the request for the root asset. Absent for the root asset
34
+ * Publish and unpublish only: index into the request's `dependencies` (publish) or `targets` (unpublish) when the problem is in that entry; for publish, `path` is then relative to the entry, as it is to the request for the root asset. Absent for the request's own asset or target
35
35
  */
36
36
  entry?: number | null;
37
37
  };
@@ -59,6 +59,10 @@ export type AssetUsage = {
59
59
  * Distinct users who fetched any version through `/download`
60
60
  */
61
61
  downloads: number;
62
+ /**
63
+ * Distinct users who star it now (`PUT /stars/...`)
64
+ */
65
+ stars: number;
62
66
  };
63
67
  /**
64
68
  * A bundle's counts
@@ -80,6 +84,10 @@ export type BundleUsage = {
80
84
  * Distinct users who fetched any version through `/download`
81
85
  */
82
86
  downloads: number;
87
+ /**
88
+ * Distinct users who star it now (`PUT /stars/...`)
89
+ */
90
+ stars: number;
83
91
  };
84
92
  /**
85
93
  * Published versions of a bundle
@@ -210,6 +218,31 @@ export type DeprecateRequest = {
210
218
  * Which client is asking; only affects the PR footer
211
219
  */
212
220
  client?: 'cli' | 'web' | 'api';
221
+ /**
222
+ * More items to deprecate (or undo) in the same pull request, at most 20, with the request's `reason`, `replacement` and `undo`. With them, the request's own target is the first of a batch: each target gets the checks of a single deprecate, and every new deprecation.json carries the same `deprecatedAt`. All or nothing, in one pull request with a batch title and branch. No item may be named twice. Problems with a target name its index in `details[].entry`.
223
+ */
224
+ targets?: Array<DeprecateTarget> | null;
225
+ };
226
+ /**
227
+ * An item deprecated (or undone) in the same pull request as the request's own target
228
+ */
229
+ export type DeprecateTarget = {
230
+ /**
231
+ * Asset or bundle name (bare, no @org prefix)
232
+ */
233
+ name: string;
234
+ /**
235
+ * Org scope (bare name; a leading `@` is ignored). Omit for global entries.
236
+ */
237
+ org?: string | null;
238
+ /**
239
+ * Asset type; needed only when the name exists as more than one type in the scope
240
+ */
241
+ type?: 'skill' | 'agent' | 'rule' | 'hook' | 'memory-template' | 'mcp-config' | 'plugin';
242
+ /**
243
+ * asset or bundle; needed only when the name exists as both in the scope
244
+ */
245
+ kind?: 'asset' | 'bundle';
213
246
  };
214
247
  /**
215
248
  * The one file a deprecate or undo changes
@@ -228,6 +261,39 @@ export type DeprecationChange = {
228
261
  */
229
262
  content?: DeprecationFile | null;
230
263
  };
264
+ /**
265
+ * What a deprecate batch does with one of the request's `targets`
266
+ */
267
+ export type DeprecationEntryPlan = {
268
+ /**
269
+ * asset or bundle
270
+ */
271
+ kind: 'asset' | 'bundle';
272
+ /**
273
+ * Name
274
+ */
275
+ name: string;
276
+ /**
277
+ * Org scope (null for global)
278
+ */
279
+ org?: string | null;
280
+ /**
281
+ * Asset type (assets only)
282
+ */
283
+ assetType?: 'skill' | 'agent' | 'rule' | 'hook' | 'memory-template' | 'mcp-config' | 'plugin';
284
+ /**
285
+ * The deprecation in effect today, or null
286
+ */
287
+ current?: DeprecationState | null;
288
+ /**
289
+ * The file change
290
+ */
291
+ change: DeprecationChange;
292
+ /**
293
+ * Non-blocking advice
294
+ */
295
+ warnings: Array<string>;
296
+ };
231
297
  /**
232
298
  * Contents of a deprecation.json sidecar
233
299
  */
@@ -293,6 +359,10 @@ export type DeprecationPlan = {
293
359
  * Non-blocking advice
294
360
  */
295
361
  warnings: Array<string>;
362
+ /**
363
+ * A deprecate batch's `targets`, planned in request order; absent otherwise. The fields above describe the request's own target, except the branch, title and body, which are the batch's
364
+ */
365
+ entries?: Array<DeprecationEntryPlan>;
296
366
  };
297
367
  /**
298
368
  * How an item is deprecated today
@@ -494,6 +564,31 @@ export type PromoteRequest = {
494
564
  * Which client is asking; only affects the PR footer
495
565
  */
496
566
  client?: 'cli' | 'web' | 'api';
567
+ /**
568
+ * More org-scoped items to promote in the same pull request, at most 20. With them, the request's own target is the first of a batch: each target gets the checks of a single promote, with every other target already global, so a bundle and its members can promote together. A bundle's refs to an asset promoted in the batch lose their `org` in every version's bundle.json. All or nothing, in one pull request with a batch title and branch. No item may be named twice. Problems with a target name its index in `details[].entry`.
569
+ */
570
+ targets?: Array<PromoteTarget> | null;
571
+ };
572
+ /**
573
+ * An item promoted in the same pull request as the request's own target
574
+ */
575
+ export type PromoteTarget = {
576
+ /**
577
+ * Asset or bundle name (bare, no @org prefix)
578
+ */
579
+ name: string;
580
+ /**
581
+ * The org it lives in today (bare name; a leading `@` is ignored)
582
+ */
583
+ org: string;
584
+ /**
585
+ * Asset type; needed only when the name exists as more than one type in the org
586
+ */
587
+ type?: 'skill' | 'agent' | 'rule' | 'hook' | 'memory-template' | 'mcp-config' | 'plugin';
588
+ /**
589
+ * asset or bundle; needed only when the name exists as both in the org
590
+ */
591
+ kind?: 'asset' | 'bundle';
497
592
  };
498
593
  /**
499
594
  * A dependency of the asset being published, resolved against the registry
@@ -746,6 +841,39 @@ export type PublishResponse = {
746
841
  */
747
842
  warnings: Array<string>;
748
843
  };
844
+ /**
845
+ * What an unpublish or promote batch does with one of the request's `targets`
846
+ */
847
+ export type RegistryChangeEntryPlan = {
848
+ /**
849
+ * asset or bundle
850
+ */
851
+ kind: 'asset' | 'bundle';
852
+ /**
853
+ * Name
854
+ */
855
+ name: string;
856
+ /**
857
+ * Org scope (null for global)
858
+ */
859
+ org?: string | null;
860
+ /**
861
+ * Asset type (assets only)
862
+ */
863
+ assetType?: 'skill' | 'agent' | 'rule' | 'hook' | 'memory-template' | 'mcp-config' | 'plugin';
864
+ /**
865
+ * Versions affected
866
+ */
867
+ versions: Array<string>;
868
+ /**
869
+ * Directories removed or moved
870
+ */
871
+ changes: Array<RegistryPathChange>;
872
+ /**
873
+ * Non-blocking advice
874
+ */
875
+ warnings: Array<string>;
876
+ };
749
877
  /**
750
878
  * What an unpublish or promote would do
751
879
  */
@@ -794,6 +922,10 @@ export type RegistryChangePlan = {
794
922
  * Non-blocking advice
795
923
  */
796
924
  warnings: Array<string>;
925
+ /**
926
+ * An unpublish or promote batch's `targets`, planned in request order; absent otherwise. The fields above describe the request's own target, except the branch, title and body, which are the batch's
927
+ */
928
+ entries?: Array<RegistryChangeEntryPlan>;
797
929
  };
798
930
  /**
799
931
  * Result of an unpublish, promote or deprecate
@@ -833,6 +965,57 @@ export type RegistryPathChange = {
833
965
  */
834
966
  to?: string | null;
835
967
  };
968
+ /**
969
+ * An asset the caller starred
970
+ */
971
+ export type StarredAsset = {
972
+ /**
973
+ * Asset type
974
+ */
975
+ type: 'skill' | 'agent' | 'rule' | 'hook' | 'memory-template' | 'mcp-config' | 'plugin';
976
+ /**
977
+ * Asset name
978
+ */
979
+ name: string;
980
+ /**
981
+ * Org scope
982
+ */
983
+ org?: string | null;
984
+ /**
985
+ * When the caller starred it (ISO 8601, UTC)
986
+ */
987
+ starredAt: string;
988
+ };
989
+ /**
990
+ * A bundle the caller starred
991
+ */
992
+ export type StarredBundle = {
993
+ /**
994
+ * Bundle name
995
+ */
996
+ name: string;
997
+ /**
998
+ * Org scope
999
+ */
1000
+ org?: string | null;
1001
+ /**
1002
+ * When the caller starred it (ISO 8601, UTC)
1003
+ */
1004
+ starredAt: string;
1005
+ };
1006
+ /**
1007
+ * The caller's stars
1008
+ */
1009
+ export type StarsResponse = {
1010
+ /**
1011
+ * The assets the caller starred that the registry has, newest first
1012
+ */
1013
+ assets: Array<StarredAsset>;
1014
+ /**
1015
+ * The bundles the caller starred that the registry has, newest first
1016
+ */
1017
+ bundles: Array<StarredBundle>;
1018
+ };
836
1019
  /**
837
1020
  * Unpublish payload
838
1021
  */
@@ -865,9 +1048,38 @@ export type UnpublishRequest = {
865
1048
  * Which client is asking; only affects the PR footer
866
1049
  */
867
1050
  client?: 'cli' | 'web' | 'api';
1051
+ /**
1052
+ * More items to unpublish in the same pull request, at most 20. With them, the request's own target is the first of a batch: each target gets the checks of a single unpublish, with every other target's removal counted as gone, so a bundle and its members can go together. All or nothing, in one pull request with a batch title and branch. No item may be named twice. Problems with a target name its index in `details[].entry`.
1053
+ */
1054
+ targets?: Array<UnpublishTarget> | null;
1055
+ };
1056
+ /**
1057
+ * An item unpublished in the same pull request as the request's own target
1058
+ */
1059
+ export type UnpublishTarget = {
1060
+ /**
1061
+ * Asset or bundle name (bare, no @org prefix)
1062
+ */
1063
+ name: string;
1064
+ /**
1065
+ * Org scope (bare name; a leading `@` is ignored). Omit for global entries.
1066
+ */
1067
+ org?: string | null;
1068
+ /**
1069
+ * Asset type; needed only when the name exists as more than one type in the scope
1070
+ */
1071
+ type?: 'skill' | 'agent' | 'rule' | 'hook' | 'memory-template' | 'mcp-config' | 'plugin';
1072
+ /**
1073
+ * asset or bundle; needed only when the name exists as both in the scope
1074
+ */
1075
+ kind?: 'asset' | 'bundle';
1076
+ /**
1077
+ * Remove only this version. Omit to remove every version.
1078
+ */
1079
+ version?: string | null;
868
1080
  };
869
1081
  /**
870
- * Install and download counts for every asset and bundle in the registry
1082
+ * Install, download and star counts for every asset and bundle in the registry
871
1083
  */
872
1084
  export type UsageResponse = {
873
1085
  /**
@@ -1473,6 +1685,10 @@ export type DownloadBundleErrors = {
1473
1685
  * Unknown asset, version, or file
1474
1686
  */
1475
1687
  404: ApiError;
1688
+ /**
1689
+ * `registry_newer`: the version's `bundle.json` names an asset type this API doesn't know (the registry is newer than this API); retry once a newer API is deployed
1690
+ */
1691
+ 409: ApiError;
1476
1692
  /**
1477
1693
  * The calling ATK CLI is older than the API's minimum (`cli_outdated`); the message names the minimum and `npm i -g @detergent-software/atk`
1478
1694
  */
@@ -1568,7 +1784,7 @@ export type PublishPlanErrors = {
1568
1784
  */
1569
1785
  403: ApiError;
1570
1786
  /**
1571
- * `version_not_bumped`, `version_exists`, `branch_exists`, or `pr_open` (a pull request is open on the branch; the message has its URL); with `dependencies`, a detail per asset, with `entry` for entries
1787
+ * `version_not_bumped`, `version_exists`, `registry_newer` (an asset or bundle the request writes is in the registry, but rests on an asset type this API doesn't know, so its registry entry is left out; retry once a newer API is deployed), `branch_exists`, or `pr_open` (a pull request is open on the branch; the message has its URL); with `dependencies`, a detail per asset, with `entry` for entries
1572
1788
  */
1573
1789
  409: ApiError;
1574
1790
  /**
@@ -1616,7 +1832,7 @@ export type PublishErrors = {
1616
1832
  */
1617
1833
  403: ApiError;
1618
1834
  /**
1619
- * `version_not_bumped`, `version_exists`, `branch_exists`, or `pr_open` (a pull request is open on the branch; the message has its URL); with `dependencies`, a detail per asset, with `entry` for entries
1835
+ * `version_not_bumped`, `version_exists`, `registry_newer` (an asset or bundle the request writes is in the registry, but rests on an asset type this API doesn't know, so its registry entry is left out; retry once a newer API is deployed), `branch_exists`, or `pr_open` (a pull request is open on the branch; the message has its URL); with `dependencies`, a detail per asset, with `entry` for entries
1620
1836
  */
1621
1837
  409: ApiError;
1622
1838
  /**
@@ -1652,7 +1868,7 @@ export type UnpublishPlanData = {
1652
1868
  };
1653
1869
  export type UnpublishPlanErrors = {
1654
1870
  /**
1655
- * Invalid name, org or version (`validation_failed`), or the name exists as more than one type or kind in the scope (`ambiguous_name`; pass `type` or `kind`)
1871
+ * Invalid name, org or version (`validation_failed`), or the name exists as more than one type or kind in the scope (`ambiguous_name`; pass `type` or `kind`). An unpublish or promote batch: also more than 20 `targets`, or an item named twice. A detail about one of `targets` carries its index in `entry`
1656
1872
  */
1657
1873
  400: ApiError;
1658
1874
  /**
@@ -1664,11 +1880,11 @@ export type UnpublishPlanErrors = {
1664
1880
  */
1665
1881
  403: ApiError;
1666
1882
  /**
1667
- * The target, or the requested version of it, is not in the registry (`not_found`)
1883
+ * The target, or the requested version of it, is not in the registry (`not_found`). In an unpublish or promote batch, a detail per missing target, with `entry` for `targets`
1668
1884
  */
1669
1885
  404: ApiError;
1670
1886
  /**
1671
- * `referenced_by_bundles` (details list the bundles, then the dependent asset versions), `global_exists` (promote), `bundle_scope_invalid` (promote; details list the refs), `registry_changed` (the registry moved on; retry), `branch_exists`, or `pr_open` (a pull request is open on the branch; the message has its URL)
1887
+ * `referenced_by_bundles` (details list the bundles, then the dependent asset versions), `global_exists` (promote), `bundle_scope_invalid` (promote; details list the refs), `registry_changed` (the registry moved on; retry), `registry_newer` (the target is in the registry, but rests on an asset type this API doesn't know, so its registry entry is left out; retry once a newer API is deployed), `branch_exists`, or `pr_open` (a pull request is open on the branch; the message has its URL). In an unpublish or promote batch, every failing target is reported, each detail with `entry` for `targets`, under the first failure's code
1672
1888
  */
1673
1889
  409: ApiError;
1674
1890
  /**
@@ -1700,7 +1916,7 @@ export type UnpublishData = {
1700
1916
  };
1701
1917
  export type UnpublishErrors = {
1702
1918
  /**
1703
- * Invalid name, org or version (`validation_failed`), or the name exists as more than one type or kind in the scope (`ambiguous_name`; pass `type` or `kind`)
1919
+ * Invalid name, org or version (`validation_failed`), or the name exists as more than one type or kind in the scope (`ambiguous_name`; pass `type` or `kind`). An unpublish or promote batch: also more than 20 `targets`, or an item named twice. A detail about one of `targets` carries its index in `entry`
1704
1920
  */
1705
1921
  400: ApiError;
1706
1922
  /**
@@ -1712,11 +1928,11 @@ export type UnpublishErrors = {
1712
1928
  */
1713
1929
  403: ApiError;
1714
1930
  /**
1715
- * The target, or the requested version of it, is not in the registry (`not_found`)
1931
+ * The target, or the requested version of it, is not in the registry (`not_found`). In an unpublish or promote batch, a detail per missing target, with `entry` for `targets`
1716
1932
  */
1717
1933
  404: ApiError;
1718
1934
  /**
1719
- * `referenced_by_bundles` (details list the bundles, then the dependent asset versions), `global_exists` (promote), `bundle_scope_invalid` (promote; details list the refs), `registry_changed` (the registry moved on; retry), `branch_exists`, or `pr_open` (a pull request is open on the branch; the message has its URL)
1935
+ * `referenced_by_bundles` (details list the bundles, then the dependent asset versions), `global_exists` (promote), `bundle_scope_invalid` (promote; details list the refs), `registry_changed` (the registry moved on; retry), `registry_newer` (the target is in the registry, but rests on an asset type this API doesn't know, so its registry entry is left out; retry once a newer API is deployed), `branch_exists`, or `pr_open` (a pull request is open on the branch; the message has its URL). In an unpublish or promote batch, every failing target is reported, each detail with `entry` for `targets`, under the first failure's code
1720
1936
  */
1721
1937
  409: ApiError;
1722
1938
  /**
@@ -1748,7 +1964,7 @@ export type PromotePlanData = {
1748
1964
  };
1749
1965
  export type PromotePlanErrors = {
1750
1966
  /**
1751
- * Invalid name, org or version (`validation_failed`), or the name exists as more than one type or kind in the scope (`ambiguous_name`; pass `type` or `kind`)
1967
+ * Invalid name, org or version (`validation_failed`), or the name exists as more than one type or kind in the scope (`ambiguous_name`; pass `type` or `kind`). An unpublish or promote batch: also more than 20 `targets`, or an item named twice. A detail about one of `targets` carries its index in `entry`
1752
1968
  */
1753
1969
  400: ApiError;
1754
1970
  /**
@@ -1760,11 +1976,11 @@ export type PromotePlanErrors = {
1760
1976
  */
1761
1977
  403: ApiError;
1762
1978
  /**
1763
- * The target, or the requested version of it, is not in the registry (`not_found`)
1979
+ * The target, or the requested version of it, is not in the registry (`not_found`). In an unpublish or promote batch, a detail per missing target, with `entry` for `targets`
1764
1980
  */
1765
1981
  404: ApiError;
1766
1982
  /**
1767
- * `referenced_by_bundles` (details list the bundles, then the dependent asset versions), `global_exists` (promote), `bundle_scope_invalid` (promote; details list the refs), `registry_changed` (the registry moved on; retry), `branch_exists`, or `pr_open` (a pull request is open on the branch; the message has its URL)
1983
+ * `referenced_by_bundles` (details list the bundles, then the dependent asset versions), `global_exists` (promote), `bundle_scope_invalid` (promote; details list the refs), `registry_changed` (the registry moved on; retry), `registry_newer` (the target is in the registry, but rests on an asset type this API doesn't know, so its registry entry is left out; retry once a newer API is deployed), `branch_exists`, or `pr_open` (a pull request is open on the branch; the message has its URL). In an unpublish or promote batch, every failing target is reported, each detail with `entry` for `targets`, under the first failure's code
1768
1984
  */
1769
1985
  409: ApiError;
1770
1986
  /**
@@ -1796,7 +2012,7 @@ export type PromoteData = {
1796
2012
  };
1797
2013
  export type PromoteErrors = {
1798
2014
  /**
1799
- * Invalid name, org or version (`validation_failed`), or the name exists as more than one type or kind in the scope (`ambiguous_name`; pass `type` or `kind`)
2015
+ * Invalid name, org or version (`validation_failed`), or the name exists as more than one type or kind in the scope (`ambiguous_name`; pass `type` or `kind`). An unpublish or promote batch: also more than 20 `targets`, or an item named twice. A detail about one of `targets` carries its index in `entry`
1800
2016
  */
1801
2017
  400: ApiError;
1802
2018
  /**
@@ -1808,11 +2024,11 @@ export type PromoteErrors = {
1808
2024
  */
1809
2025
  403: ApiError;
1810
2026
  /**
1811
- * The target, or the requested version of it, is not in the registry (`not_found`)
2027
+ * The target, or the requested version of it, is not in the registry (`not_found`). In an unpublish or promote batch, a detail per missing target, with `entry` for `targets`
1812
2028
  */
1813
2029
  404: ApiError;
1814
2030
  /**
1815
- * `referenced_by_bundles` (details list the bundles, then the dependent asset versions), `global_exists` (promote), `bundle_scope_invalid` (promote; details list the refs), `registry_changed` (the registry moved on; retry), `branch_exists`, or `pr_open` (a pull request is open on the branch; the message has its URL)
2031
+ * `referenced_by_bundles` (details list the bundles, then the dependent asset versions), `global_exists` (promote), `bundle_scope_invalid` (promote; details list the refs), `registry_changed` (the registry moved on; retry), `registry_newer` (the target is in the registry, but rests on an asset type this API doesn't know, so its registry entry is left out; retry once a newer API is deployed), `branch_exists`, or `pr_open` (a pull request is open on the branch; the message has its URL). In an unpublish or promote batch, every failing target is reported, each detail with `entry` for `targets`, under the first failure's code
1816
2032
  */
1817
2033
  409: ApiError;
1818
2034
  /**
@@ -1844,7 +2060,7 @@ export type DeprecatePlanData = {
1844
2060
  };
1845
2061
  export type DeprecatePlanErrors = {
1846
2062
  /**
1847
- * Invalid name or org, missing reason, undo with a reason or replacement, or an item named as its own replacement (`validation_failed`); the name exists as more than one type or kind in the scope (`ambiguous_name`); or the replacement is not in the registry (`replacement_not_found`)
2063
+ * Invalid name or org, missing reason, undo with a reason or replacement, or an item named as its own replacement (`validation_failed`); the name exists as more than one type or kind in the scope (`ambiguous_name`); or the replacement is not in the registry (`replacement_not_found`). A deprecate batch: also more than 20 `targets`, or an item named twice. A detail about one of `targets` carries its index in `entry`
1848
2064
  */
1849
2065
  400: ApiError;
1850
2066
  /**
@@ -1856,11 +2072,11 @@ export type DeprecatePlanErrors = {
1856
2072
  */
1857
2073
  403: ApiError;
1858
2074
  /**
1859
- * The target is not in the registry (`not_found`)
2075
+ * The target is not in the registry (`not_found`). In a deprecate batch, a detail per missing target, with `entry` for `targets`
1860
2076
  */
1861
2077
  404: ApiError;
1862
2078
  /**
1863
- * `deprecation_unchanged` (already deprecated with this reason and replacement), `not_deprecated` (undo with no deprecation.json), `deprecation_in_manifest` (undo of a deprecation set by legacy `metadata.deprecated`; publish a version without it), `registry_changed` (the registry moved on; retry), `branch_exists`, or `pr_open` (a pull request is open on the branch; the message has its URL)
2079
+ * `deprecation_unchanged` (already deprecated with this reason and replacement), `not_deprecated` (undo with no deprecation.json), `deprecation_in_manifest` (undo of a deprecation set by legacy `metadata.deprecated`; publish a version without it), `registry_changed` (the registry moved on; retry), `registry_newer` (the target is in the registry, but rests on an asset type this API doesn't know, so its registry entry is left out; retry once a newer API is deployed), `branch_exists`, or `pr_open` (a pull request is open on the branch; the message has its URL). In a deprecate batch, every failing target is reported, each detail with `entry` for `targets`, under the first failure's code
1864
2080
  */
1865
2081
  409: ApiError;
1866
2082
  /**
@@ -1892,7 +2108,7 @@ export type DeprecateData = {
1892
2108
  };
1893
2109
  export type DeprecateErrors = {
1894
2110
  /**
1895
- * Invalid name or org, missing reason, undo with a reason or replacement, or an item named as its own replacement (`validation_failed`); the name exists as more than one type or kind in the scope (`ambiguous_name`); or the replacement is not in the registry (`replacement_not_found`)
2111
+ * Invalid name or org, missing reason, undo with a reason or replacement, or an item named as its own replacement (`validation_failed`); the name exists as more than one type or kind in the scope (`ambiguous_name`); or the replacement is not in the registry (`replacement_not_found`). A deprecate batch: also more than 20 `targets`, or an item named twice. A detail about one of `targets` carries its index in `entry`
1896
2112
  */
1897
2113
  400: ApiError;
1898
2114
  /**
@@ -1904,11 +2120,11 @@ export type DeprecateErrors = {
1904
2120
  */
1905
2121
  403: ApiError;
1906
2122
  /**
1907
- * The target is not in the registry (`not_found`)
2123
+ * The target is not in the registry (`not_found`). In a deprecate batch, a detail per missing target, with `entry` for `targets`
1908
2124
  */
1909
2125
  404: ApiError;
1910
2126
  /**
1911
- * `deprecation_unchanged` (already deprecated with this reason and replacement), `not_deprecated` (undo with no deprecation.json), `deprecation_in_manifest` (undo of a deprecation set by legacy `metadata.deprecated`; publish a version without it), `registry_changed` (the registry moved on; retry), `branch_exists`, or `pr_open` (a pull request is open on the branch; the message has its URL)
2127
+ * `deprecation_unchanged` (already deprecated with this reason and replacement), `not_deprecated` (undo with no deprecation.json), `deprecation_in_manifest` (undo of a deprecation set by legacy `metadata.deprecated`; publish a version without it), `registry_changed` (the registry moved on; retry), `registry_newer` (the target is in the registry, but rests on an asset type this API doesn't know, so its registry entry is left out; retry once a newer API is deployed), `branch_exists`, or `pr_open` (a pull request is open on the branch; the message has its URL). In a deprecate batch, every failing target is reported, each detail with `entry` for `targets`, under the first failure's code
1912
2128
  */
1913
2129
  409: ApiError;
1914
2130
  /**
@@ -2032,4 +2248,144 @@ export type GetUsageResponses = {
2032
2248
  200: UsageResponse;
2033
2249
  };
2034
2250
  export type GetUsageResponse = GetUsageResponses[keyof GetUsageResponses];
2251
+ export type UnstarSubjectData = {
2252
+ body?: never;
2253
+ path: {
2254
+ /**
2255
+ * `bundle`, or the asset type
2256
+ */
2257
+ type: 'bundle' | 'skill' | 'agent' | 'rule' | 'hook' | 'memory-template' | 'mcp-config' | 'plugin';
2258
+ /**
2259
+ * Asset or bundle name (bare, no @org prefix)
2260
+ */
2261
+ name: string;
2262
+ };
2263
+ query?: {
2264
+ /**
2265
+ * Org scope (bare name, no `@`); omit for global
2266
+ */
2267
+ org?: string;
2268
+ };
2269
+ url: '/stars/{type}/{name}';
2270
+ };
2271
+ export type UnstarSubjectErrors = {
2272
+ /**
2273
+ * Missing or invalid token (`unauthenticated`, `unsupported_token`, `invalid_token`), or GitHub sign-in has ended (`github_auth_retired`)
2274
+ */
2275
+ 401: ApiError;
2276
+ /**
2277
+ * A guest account of the Emergent Software tenant (`guest_not_allowed`)
2278
+ */
2279
+ 403: ApiError;
2280
+ /**
2281
+ * The calling ATK CLI is older than the API's minimum (`cli_outdated`); the message names the minimum and `npm i -g @detergent-software/atk`
2282
+ */
2283
+ 426: ApiError;
2284
+ /**
2285
+ * Entra could not be reached to validate the token (`entra_unavailable`)
2286
+ */
2287
+ 502: ApiError;
2288
+ /**
2289
+ * The usage database could not be reached (`usage_unavailable`)
2290
+ */
2291
+ 503: ApiError;
2292
+ };
2293
+ export type UnstarSubjectError = UnstarSubjectErrors[keyof UnstarSubjectErrors];
2294
+ export type UnstarSubjectResponses = {
2295
+ /**
2296
+ * Not starred
2297
+ */
2298
+ 204: void;
2299
+ };
2300
+ export type UnstarSubjectResponse = UnstarSubjectResponses[keyof UnstarSubjectResponses];
2301
+ export type StarSubjectData = {
2302
+ body?: never;
2303
+ path: {
2304
+ /**
2305
+ * `bundle`, or the asset type
2306
+ */
2307
+ type: 'bundle' | 'skill' | 'agent' | 'rule' | 'hook' | 'memory-template' | 'mcp-config' | 'plugin';
2308
+ /**
2309
+ * Asset or bundle name (bare, no @org prefix)
2310
+ */
2311
+ name: string;
2312
+ };
2313
+ query?: {
2314
+ /**
2315
+ * Org scope (bare name, no `@`); omit for global
2316
+ */
2317
+ org?: string;
2318
+ };
2319
+ url: '/stars/{type}/{name}';
2320
+ };
2321
+ export type StarSubjectErrors = {
2322
+ /**
2323
+ * Missing or invalid token (`unauthenticated`, `unsupported_token`, `invalid_token`), or GitHub sign-in has ended (`github_auth_retired`)
2324
+ */
2325
+ 401: ApiError;
2326
+ /**
2327
+ * A guest account of the Emergent Software tenant (`guest_not_allowed`)
2328
+ */
2329
+ 403: ApiError;
2330
+ /**
2331
+ * The registry has no such asset or bundle (`not_found`); nothing is written
2332
+ */
2333
+ 404: ApiError;
2334
+ /**
2335
+ * The calling ATK CLI is older than the API's minimum (`cli_outdated`); the message names the minimum and `npm i -g @detergent-software/atk`
2336
+ */
2337
+ 426: ApiError;
2338
+ /**
2339
+ * Entra could not be reached to validate the token (`entra_unavailable`)
2340
+ */
2341
+ 502: ApiError;
2342
+ /**
2343
+ * The usage database could not be reached (`usage_unavailable`)
2344
+ */
2345
+ 503: ApiError;
2346
+ };
2347
+ export type StarSubjectError = StarSubjectErrors[keyof StarSubjectErrors];
2348
+ export type StarSubjectResponses = {
2349
+ /**
2350
+ * Starred
2351
+ */
2352
+ 204: void;
2353
+ };
2354
+ export type StarSubjectResponse = StarSubjectResponses[keyof StarSubjectResponses];
2355
+ export type ListStarsData = {
2356
+ body?: never;
2357
+ path?: never;
2358
+ query?: never;
2359
+ url: '/stars';
2360
+ };
2361
+ export type ListStarsErrors = {
2362
+ /**
2363
+ * Missing or invalid token (`unauthenticated`, `unsupported_token`, `invalid_token`), or GitHub sign-in has ended (`github_auth_retired`)
2364
+ */
2365
+ 401: ApiError;
2366
+ /**
2367
+ * A guest account of the Emergent Software tenant (`guest_not_allowed`)
2368
+ */
2369
+ 403: ApiError;
2370
+ /**
2371
+ * The calling ATK CLI is older than the API's minimum (`cli_outdated`); the message names the minimum and `npm i -g @detergent-software/atk`
2372
+ */
2373
+ 426: ApiError;
2374
+ /**
2375
+ * Entra could not be reached to validate the token (`entra_unavailable`)
2376
+ */
2377
+ 502: ApiError;
2378
+ /**
2379
+ * The usage database could not be reached (`usage_unavailable`)
2380
+ */
2381
+ 503: ApiError;
2382
+ };
2383
+ export type ListStarsError = ListStarsErrors[keyof ListStarsErrors];
2384
+ export type ListStarsResponses = {
2385
+ /**
2386
+ * Stars
2387
+ */
2388
+ 200: StarsResponse;
2389
+ };
2390
+ export type ListStarsResponse = ListStarsResponses[keyof ListStarsResponses];
2035
2391
  //# sourceMappingURL=types.gen.d.ts.map