@scalar/cli 2.1.0 → 2.5.2

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 (88) hide show
  1. package/README.md +28 -24
  2. package/chunks/action-42D2C47G.js +18 -0
  3. package/chunks/{action-DFKHSDFV.js → action-6FAJNP6C.js} +7 -3
  4. package/chunks/{action-5R5FDF6S.js → action-6MZZHPVQ.js} +120 -22
  5. package/chunks/{action-BYZUBXVB.js → action-7H3XARJP.js} +8 -4
  6. package/chunks/{action-H5OHT2GV.js → action-AMNYOA4B.js} +7 -3
  7. package/chunks/{action-ANU5HGC4.js → action-DCINFQ57.js} +17 -14
  8. package/chunks/{action-GB6DM53B.js → action-DGD6Q6Y5.js} +21 -10
  9. package/chunks/{action-TPBKPHNS.js → action-EPNE5XCM.js} +22 -22
  10. package/chunks/{action-C5VB4ITT.js → action-FF2OMGAS.js} +36 -18
  11. package/chunks/{action-Q5UJ32D6.js → action-H3RTILLM.js} +1 -1
  12. package/chunks/action-HIL5ZFNB.js +84 -0
  13. package/chunks/{action-MENXFJH3.js → action-HXHBU7XC.js} +9 -9
  14. package/chunks/{action-F4Y6Q2VB.js → action-LFL3ZZKN.js} +21 -21
  15. package/chunks/action-LUVBQEIQ.js +250 -0
  16. package/chunks/{action-TZ5KGAQT.js → action-OILGZAMK.js} +17 -14
  17. package/chunks/{action-HD2T6BFJ.js → action-OK55BFGM.js} +10 -10
  18. package/chunks/{action-HNKM3Q65.js → action-P7RFXIC7.js} +17 -14
  19. package/chunks/action-PAA4NWUJ.js +374 -0
  20. package/chunks/action-PHLOE27S.js +522 -0
  21. package/chunks/{action-CYP4VDK3.js → action-RBVPKCRI.js} +12 -35
  22. package/chunks/action-SJYAMXYI.js +244 -0
  23. package/chunks/{action-45OGQB2M.js → action-TWHLZW4V.js} +17 -8
  24. package/chunks/{action-GEBRPNRT.js → action-V5KYG7XD.js} +15 -16
  25. package/chunks/{action-BNEGJBUH.js → action-W62AIEBN.js} +8 -9
  26. package/chunks/{action-PVDDRIM6.js → action-X7TZA3RE.js} +65 -26
  27. package/chunks/{action-CLSD7O2R.js → action-XUQ7TKKJ.js} +10 -10
  28. package/chunks/{action-BMFXENMX.js → action-Y6CEKYEK.js} +39 -34
  29. package/chunks/{action-STIEAXOE.js → action-YRWHX2AE.js} +16 -5
  30. package/chunks/{action-W5BATF4Q.js → action-ZLTUMRO2.js} +24 -24
  31. package/chunks/{action-UDZUUJSI.js → action-ZWQLQENM.js} +18 -7
  32. package/chunks/{agent-XGLOHXNA.js → agent-JAXLLDPE.js} +25 -5
  33. package/chunks/asyncapi-P6Y3L7RG.js +105 -0
  34. package/chunks/{build.action-LKOILPA6.js → build.action-AZ5ECU4B.js} +22 -22
  35. package/chunks/chunk-3BWGTPPT.js +27022 -0
  36. package/chunks/{chunk-ZTVWAKNJ.js → chunk-3DJ2GKEG.js} +1 -1
  37. package/chunks/chunk-3ZJYGGAA.js +30 -0
  38. package/chunks/{chunk-IX7LJ3AD.js → chunk-4ORL4MST.js} +2 -3
  39. package/chunks/{chunk-ASMHW5AY.js → chunk-6ZMT63IV.js} +1 -1
  40. package/chunks/{chunk-B6QZJWCQ.js → chunk-B2MHTD3R.js} +4 -6
  41. package/chunks/{chunk-P646T2WH.js → chunk-CIFOFSZ3.js} +131 -13
  42. package/chunks/chunk-CX7ZRMTC.js +404 -0
  43. package/chunks/{chunk-HQKBZOYU.js → chunk-FOKFF4EP.js} +3 -3
  44. package/chunks/{chunk-UPUTMFD4.js → chunk-FQVVKQPU.js} +185 -13
  45. package/chunks/{chunk-P2VH7DOC.js → chunk-HUCR333E.js} +6 -6
  46. package/chunks/{chunk-KWOL7A6J.js → chunk-HXIDUCSZ.js} +2 -2
  47. package/chunks/{chunk-H2WRMLYY.js → chunk-IKT5F47M.js} +3571 -7
  48. package/chunks/{chunk-OAXFCOJV.js → chunk-JV7TUEXQ.js} +2 -1
  49. package/chunks/{chunk-2BSG2QHO.js → chunk-KEOCJ3NJ.js} +133 -20
  50. package/chunks/{chunk-AHWWJ3MD.js → chunk-LCPFHE4Z.js} +1 -1
  51. package/chunks/{chunk-TLFMATXR.js → chunk-LQN4S62O.js} +33 -25
  52. package/chunks/chunk-M622VXRQ.js +14 -0
  53. package/chunks/chunk-M6Q3ARBV.js +210 -0
  54. package/chunks/{chunk-4QS7SJTG.js → chunk-MNLXYOVF.js} +51 -36
  55. package/chunks/{chunk-5BISXQX4.js → chunk-NIXG4KDE.js} +11 -13
  56. package/chunks/{chunk-47Y4L5IT.js → chunk-NNMSZVAB.js} +1031 -481
  57. package/chunks/chunk-OQKDBLOZ.js +741 -0
  58. package/chunks/{chunk-NUXPNUSS.js → chunk-RAO7VUGM.js} +1 -1
  59. package/chunks/{chunk-SHSHFGA7.js → chunk-RPVHJMQT.js} +4 -6
  60. package/chunks/{chunk-23I5PKZZ.js → chunk-SWWWYWHC.js} +32 -5
  61. package/chunks/{chunk-X4QLDBB5.js → chunk-T5HJUAWB.js} +24 -3
  62. package/chunks/chunk-TYLWJ2UL.js +25 -0
  63. package/chunks/{chunk-SXYALPYK.js → chunk-UB3XGOUW.js} +498 -60
  64. package/chunks/{chunk-TQ5XC2E3.js → chunk-UMPODUJO.js} +77 -11
  65. package/chunks/{chunk-4DGQIAJX.js → chunk-VNYE4R7N.js} +154 -14
  66. package/chunks/{create.action-FFQLBSJH.js → create.action-34OTO2SB.js} +22 -22
  67. package/chunks/{delete.action-QNN3LC2F.js → delete.action-6LRT4M3S.js} +22 -22
  68. package/chunks/{delete.action-STHQHP4F.js → delete.action-ZYXFMIOW.js} +22 -22
  69. package/chunks/{get.action-OTKYOP3Z.js → get.action-XP36SA2J.js} +15 -16
  70. package/chunks/{list.action-KDM5RHEH.js → list.action-6LF6KSD5.js} +19 -19
  71. package/chunks/{list.action-6I5EZAVB.js → list.action-WVRVLX5E.js} +22 -22
  72. package/chunks/{publish.action-PODTVRXS.js → publish.action-AHFUBT5C.js} +44 -36
  73. package/chunks/{update.action-KMD4ZM75.js → update.action-YQTVUDYE.js} +22 -22
  74. package/chunks/{update.action-4F6STTEQ.js → update.action-ZREAFJVG.js} +22 -22
  75. package/docs.html +107 -104
  76. package/index.js +84 -68
  77. package/package.json +19 -15
  78. package/chunks/action-CCW66QJN.js +0 -72
  79. package/chunks/action-CQ56FVES.js +0 -65
  80. package/chunks/action-JOSVV6YA.js +0 -71
  81. package/chunks/action-P7LN6FGY.js +0 -13
  82. package/chunks/action-R6ZZO26F.js +0 -299
  83. package/chunks/action-TWFJNQ2R.js +0 -95
  84. package/chunks/chunk-5BPPGTUU.js +0 -463
  85. package/chunks/chunk-DOVIWNKQ.js +0 -108
  86. package/chunks/chunk-ISGLWBXZ.js +0 -4265
  87. package/chunks/chunk-T7MDADON.js +0 -17
  88. package/chunks/chunk-VTYTPSXO.js +0 -161
@@ -2,7 +2,7 @@ import { createRequire as $$cR } from "node:module"; const require = $$cR(import
2
2
  import {
3
3
  getPublishPreviewUrl,
4
4
  getPublishUrl
5
- } from "./chunk-DOVIWNKQ.js";
5
+ } from "./chunk-M6Q3ARBV.js";
6
6
 
7
7
  // src/domains/project/publish/url.ts
8
8
  function getPublishDeploymentUrl(publish) {
@@ -0,0 +1,30 @@
1
+ import { createRequire as $$cR } from "node:module"; const require = $$cR(import.meta.url);
2
+
3
+ // src/errors.ts
4
+ function createError(code, detail) {
5
+ return {
6
+ code,
7
+ detail
8
+ };
9
+ }
10
+ function displayError(error, fallback = "Unknown error occurred. Please contact support@scalar.com") {
11
+ try {
12
+ if (error instanceof Error) {
13
+ return error.message;
14
+ }
15
+ if (typeof error === "object") {
16
+ return JSON.stringify(error);
17
+ }
18
+ if (typeof error === "string") {
19
+ return error;
20
+ }
21
+ return fallback;
22
+ } catch {
23
+ return fallback;
24
+ }
25
+ }
26
+
27
+ export {
28
+ createError,
29
+ displayError
30
+ };
@@ -1,9 +1,8 @@
1
1
  import { createRequire as $$cR } from "node:module"; const require = $$cR(import.meta.url);
2
2
 
3
3
  // src/domains/document/helpers/file-type.ts
4
- var isUrl = (text) => {
5
- return typeof text === "string" && (text.startsWith("http://") || text.startsWith("https://"));
6
- };
4
+ import { isHttpUrl } from "@scalar/json-magic/helpers/is-http-url";
5
+ var isUrl = isHttpUrl;
7
6
  var isYamlFileName = (fileName) => {
8
7
  if (isUrl(fileName)) {
9
8
  return false;
@@ -1,7 +1,7 @@
1
1
  import { createRequire as $$cR } from "node:module"; const require = $$cR(import.meta.url);
2
2
  import {
3
3
  userSchema
4
- } from "./chunk-B6QZJWCQ.js";
4
+ } from "./chunk-B2MHTD3R.js";
5
5
 
6
6
  // src/domains/team/helpers.ts
7
7
  var getUserTeams = async (client, email) => {
@@ -2,18 +2,16 @@ import { createRequire as $$cR } from "node:module"; const require = $$cR(import
2
2
  import {
3
3
  teamImageSchema,
4
4
  teamNameSchema
5
- } from "./chunk-4DGQIAJX.js";
5
+ } from "./chunk-VNYE4R7N.js";
6
6
  import {
7
7
  brandedUid,
8
8
  emailSchema,
9
9
  entitySchema,
10
- mintUid,
11
- timestampSchema
12
- } from "./chunk-ISGLWBXZ.js";
13
- import {
14
10
  external_exports,
11
+ mintUid,
12
+ timestampSchema,
15
13
  zod_default
16
- } from "./chunk-H2WRMLYY.js";
14
+ } from "./chunk-IKT5F47M.js";
17
15
 
18
16
  // ../../packages/entities/dist/user/bitbucket.js
19
17
  var userBitbucketSchema = entitySchema.extend({
@@ -1,4 +1,10 @@
1
1
  import { createRequire as $$cR } from "node:module"; const require = $$cR(import.meta.url);
2
+ import {
3
+ billingPlanSchema
4
+ } from "./chunk-VNYE4R7N.js";
5
+ import {
6
+ sharedProjectSchema
7
+ } from "./chunk-OQKDBLOZ.js";
2
8
  import {
3
9
  SCALAR_AGENT_KEY_HEADER,
4
10
  agentDocsProjectSchema,
@@ -15,18 +21,12 @@ import {
15
21
  mcpServerToolModes,
16
22
  mcpServerVersionSchema,
17
23
  monthlyUsageSchema
18
- } from "./chunk-TLFMATXR.js";
19
- import {
20
- billingPlanSchema
21
- } from "./chunk-4DGQIAJX.js";
24
+ } from "./chunk-LQN4S62O.js";
22
25
  import {
26
+ external_exports,
23
27
  nanoidSchema,
24
- sharedProjectSchema,
25
28
  slugSchema
26
- } from "./chunk-ISGLWBXZ.js";
27
- import {
28
- external_exports
29
- } from "./chunk-H2WRMLYY.js";
29
+ } from "./chunk-IKT5F47M.js";
30
30
 
31
31
  // ../../packages/entities/dist/api/agent/shared.js
32
32
  var agentApiErrorSchema = external_exports.object({
@@ -240,6 +240,83 @@ var analyticsRoutes = {
240
240
  }
241
241
  };
242
242
 
243
+ // ../../packages/entities/dist/api/agent/dashboard.js
244
+ var DASHBOARD_EDITOR_TOOL_NAMES = /* @__PURE__ */ new Set([
245
+ "read_file",
246
+ "list_files",
247
+ "glob",
248
+ "grep",
249
+ "write_file",
250
+ "edit_file",
251
+ "get_current_file",
252
+ "validate_openapi",
253
+ "summarize_openapi",
254
+ "validate_config"
255
+ ]);
256
+ var DASHBOARD_SDK_TOOL_NAMES = /* @__PURE__ */ new Set([
257
+ "get_sdk_config",
258
+ "set_sdk_config"
259
+ ]);
260
+ var DASHBOARD_SDK_CONTEXT_KEY = "sdk-studio";
261
+ var DASHBOARD_EDITOR_CONTEXT_KEY = "docs-editor";
262
+ var DASHBOARD_CHAT_CONTEXT_MAX_CHARS = 12e4;
263
+ var DASHBOARD_CHAT_MAX_MESSAGES = 400;
264
+ var dashboardChatSettingsSchema = external_exports.object({
265
+ mode: external_exports.enum(["fast", "medium", "max"]).default("medium")
266
+ });
267
+ var dashboardChatBodySchema = external_exports.object({
268
+ id: external_exports.string(),
269
+ /**
270
+ * Only what the browser composed or the model answered. A `system`
271
+ * message is the server's alone, so one a client stamps is refused at
272
+ * the door rather than joined to the real system prompt.
273
+ */
274
+ messages: external_exports.array(external_exports.object({ role: external_exports.enum(["user", "assistant"]) }).loose()).max(DASHBOARD_CHAT_MAX_MESSAGES),
275
+ /**
276
+ * `{ [pluginId]: slice }` — opaque here. Each server tool pack validates
277
+ * its own key and ignores the rest, so a client ahead of the server can
278
+ * send a slice nothing reads yet.
279
+ */
280
+ context: external_exports.record(external_exports.string(), external_exports.unknown()).default({}),
281
+ settings: dashboardChatSettingsSchema.default({ mode: "medium" }),
282
+ /**
283
+ * Wire names the browser can execute this turn. The server offers a
284
+ * client-executed tool only when it is named here, so a call the browser
285
+ * cannot answer never reaches the model.
286
+ */
287
+ clientTools: external_exports.array(external_exports.string().max(64)).max(64).default([])
288
+ }).superRefine((body, ctx) => {
289
+ if (JSON.stringify(body.context).length > DASHBOARD_CHAT_CONTEXT_MAX_CHARS) {
290
+ ctx.addIssue({ code: "custom", message: "context too large" });
291
+ }
292
+ if (body.clientTools.some((name) => DASHBOARD_SDK_TOOL_NAMES.has(name)) && !body.context[DASHBOARD_SDK_CONTEXT_KEY]) {
293
+ ctx.addIssue({
294
+ code: "custom",
295
+ message: "sdk tools require the sdk-studio context slice"
296
+ });
297
+ }
298
+ if (body.clientTools.some((name) => DASHBOARD_EDITOR_TOOL_NAMES.has(name)) && !body.context[DASHBOARD_EDITOR_CONTEXT_KEY]) {
299
+ ctx.addIssue({
300
+ code: "custom",
301
+ message: "editor tools require docs-editor context"
302
+ });
303
+ }
304
+ });
305
+ var dashboardRoutes = {
306
+ chat: {
307
+ method: "POST",
308
+ path: () => "/dashboard/chat",
309
+ body: dashboardChatBodySchema,
310
+ responses: {
311
+ 400: agentApiErrorSchema,
312
+ 402: agentApiErrorSchema,
313
+ 403: agentApiErrorSchema
314
+ },
315
+ responseMediaType: "text/event-stream",
316
+ summary: "Chat with the dashboard assistant"
317
+ }
318
+ };
319
+
243
320
  // ../../packages/entities/dist/api/agent/docs.js
244
321
  var docsProjectAgentInfoSchema = external_exports.object({
245
322
  id: external_exports.string(),
@@ -249,6 +326,19 @@ var docsProjectAgentInfoSchema = external_exports.object({
249
326
  mcpServerSlug: external_exports.string().nullable(),
250
327
  mcpInstallationSlug: external_exports.string().nullable()
251
328
  });
329
+ var docsChatContextSchema = external_exports.object({
330
+ /** The Vue-router path of the current page, without the hash. */
331
+ path: external_exports.string().max(2048),
332
+ /** The `route.meta.page` type (e.g. `page`, `openapi-single`), for phrasing. */
333
+ kind: external_exports.string().max(64).optional(),
334
+ /** The OpenAPI/AsyncAPI document the page belongs to, when it is a reference. */
335
+ documentUid: external_exports.string().max(256).optional(),
336
+ /**
337
+ * Full navigation id of the entity in view. Lets the server rebuild the
338
+ * anchored `to` for a single-page reference operation and match it.
339
+ */
340
+ navId: external_exports.string().max(2048).optional()
341
+ });
252
342
  var docsRoutes = {
253
343
  getProject: {
254
344
  method: "GET",
@@ -289,7 +379,13 @@ var docsRoutes = {
289
379
  chat: {
290
380
  method: "POST",
291
381
  path: () => "/docs/chat",
292
- body: external_exports.object({ id: external_exports.string(), messages: external_exports.any().array() }),
382
+ body: external_exports.object({
383
+ id: external_exports.string(),
384
+ messages: external_exports.any().array(),
385
+ // What the visitor is currently viewing, so the agent can answer about it.
386
+ // Optional so a docs bundle that sends no context keeps working unchanged.
387
+ context: docsChatContextSchema.optional()
388
+ }),
293
389
  responses: { 400: agentApiErrorSchema, 403: agentApiErrorSchema },
294
390
  responseMediaType: "text/event-stream",
295
391
  summary: "Chat with the docs agent"
@@ -568,6 +664,8 @@ var mcpOperationToolDetailSchema = external_exports.object({
568
664
  curatedToolEnabled: external_exports.boolean(),
569
665
  name: external_exports.string().nullable(),
570
666
  description: external_exports.string().nullable(),
667
+ deprecated: external_exports.boolean(),
668
+ deprecationMessage: external_exports.string().nullable(),
571
669
  openApiOperationId: external_exports.string().nullable(),
572
670
  operationSummary: external_exports.string().nullable()
573
671
  });
@@ -650,6 +748,7 @@ var mcpServerRoutes = {
650
748
  body: external_exports.object({
651
749
  name: external_exports.string().min(1).max(100),
652
750
  slug: slugSchema,
751
+ autoAddOperations: external_exports.boolean(),
653
752
  operations: external_exports.array(external_exports.uuid()),
654
753
  docsPages: external_exports.array(external_exports.uuid()),
655
754
  bumpStrategy: bumpStrategySchema,
@@ -727,12 +826,16 @@ var mcpServerRoutes = {
727
826
  params: external_exports.object({ id: external_exports.uuid(), operationToolId: external_exports.uuid() }),
728
827
  body: external_exports.object({
729
828
  name: external_exports.string().nullable().optional(),
730
- description: external_exports.string().nullable().optional()
829
+ description: external_exports.string().nullable().optional(),
830
+ deprecated: external_exports.boolean().optional(),
831
+ deprecationMessage: external_exports.string().nullable().optional()
731
832
  }),
732
833
  response: external_exports.object({
733
834
  operationToolId: external_exports.string(),
734
835
  name: external_exports.string().nullable().optional(),
735
- description: external_exports.string().nullable().optional()
836
+ description: external_exports.string().nullable().optional(),
837
+ deprecated: external_exports.boolean().optional(),
838
+ deprecationMessage: external_exports.string().nullable().optional()
736
839
  }),
737
840
  responses: { 400: agentApiErrorSchema, 403: agentApiErrorSchema },
738
841
  summary: "Set custom name and description on an operation tool"
@@ -950,6 +1053,8 @@ var mcpVersionToolsSchema = external_exports.object({
950
1053
  curatedToolEnabled: external_exports.boolean(),
951
1054
  name: external_exports.string().nullable(),
952
1055
  description: external_exports.string().nullable(),
1056
+ deprecated: external_exports.boolean(),
1057
+ deprecationMessage: external_exports.string().nullable(),
953
1058
  path: external_exports.string(),
954
1059
  method: external_exports.string(),
955
1060
  versionId: external_exports.string(),
@@ -1035,7 +1140,9 @@ var mcpVersionRoutes = {
1035
1140
  executeRequestToolEnabled: external_exports.boolean().optional(),
1036
1141
  curatedToolEnabled: external_exports.boolean().optional(),
1037
1142
  name: external_exports.string().nullable().optional(),
1038
- description: external_exports.string().nullable().optional()
1143
+ description: external_exports.string().nullable().optional(),
1144
+ deprecated: external_exports.boolean().optional(),
1145
+ deprecationMessage: external_exports.string().nullable().optional()
1039
1146
  })).optional(),
1040
1147
  docsPageTools: external_exports.array(external_exports.object({
1041
1148
  docsPageId: external_exports.uuid(),
@@ -1545,6 +1652,7 @@ var agentApi = {
1545
1652
  },
1546
1653
  registry: registryRoutes,
1547
1654
  docs: docsRoutes,
1655
+ dashboard: dashboardRoutes,
1548
1656
  editor: editorRoutes,
1549
1657
  openapi: openapiRoutes,
1550
1658
  analytics: analyticsRoutes,
@@ -1580,7 +1688,17 @@ export {
1580
1688
  mcpErrorEntrySchema,
1581
1689
  mcpErrorsResultSchema,
1582
1690
  analyticsRoutes,
1691
+ DASHBOARD_EDITOR_TOOL_NAMES,
1692
+ DASHBOARD_SDK_TOOL_NAMES,
1693
+ DASHBOARD_SDK_CONTEXT_KEY,
1694
+ DASHBOARD_EDITOR_CONTEXT_KEY,
1695
+ DASHBOARD_CHAT_CONTEXT_MAX_CHARS,
1696
+ DASHBOARD_CHAT_MAX_MESSAGES,
1697
+ dashboardChatSettingsSchema,
1698
+ dashboardChatBodySchema,
1699
+ dashboardRoutes,
1583
1700
  docsProjectAgentInfoSchema,
1701
+ docsChatContextSchema,
1584
1702
  docsRoutes,
1585
1703
  editorChatBodySchema,
1586
1704
  pullRequestDescriptionBodySchema,