@scalar/cli 2.0.1 → 2.5.1

package/chunks/chunk-HPL3ZZ2P.js

@@ -0,0 +1,1726 @@
+import { createRequire as $$cR } from "node:module"; const require = $$cR(import.meta.url);
+import {
+  billingPlanSchema
+} from "./chunk-VNYE4R7N.js";
+import {
+  sharedProjectSchema
+} from "./chunk-OQKDBLOZ.js";
+import {
+  SCALAR_AGENT_KEY_HEADER,
+  agentDocsProjectSchema,
+  agentKeySchema,
+  docsProjectTypes,
+  embedStatuses,
+  mcpAuthConfigSchema,
+  mcpDocsProjectTrackModes,
+  mcpDocumentTrackModes,
+  mcpInstallationSchema,
+  mcpServerDocsPageToolSchema,
+  mcpServerOperationToolSchema,
+  mcpServerSchema,
+  mcpServerToolModes,
+  mcpServerVersionSchema,
+  monthlyUsageSchema
+} from "./chunk-GSGZHE26.js";
+import {
+  external_exports,
+  nanoidSchema,
+  slugSchema
+} from "./chunk-IKT5F47M.js";
+
+// ../../packages/entities/dist/api/agent/shared.js
+var agentApiErrorSchema = external_exports.object({
+  code: external_exports.string(),
+  message: external_exports.string(),
+  detail: external_exports.unknown().optional()
+});
+var pubsubPushMessageSchema = external_exports.object({
+  deliveryAttempt: external_exports.number().optional(),
+  message: external_exports.object({
+    data: external_exports.string(),
+    messageId: external_exports.string(),
+    publishTime: external_exports.coerce.date(),
+    attributes: external_exports.record(external_exports.string(), external_exports.string()).optional(),
+    orderingKey: external_exports.string().optional()
+  }),
+  subscription: external_exports.string()
+});
+var bumpKindSchema = external_exports.enum(["patch", "minor", "major"]);
+var bumpStrategySchema = external_exports.enum(["new-version", "in-place"]);
+var semverParamSchema = external_exports.string().regex(/^\d+\.\d+\.\d+$/, "semver MAJOR.MINOR.PATCH");
+var installationParamSchema = external_exports.string().regex(/^[^@/]+(@[^@/]+)?$/, "installationId or installationId@version");
+
+// ../../packages/entities/dist/api/agent/analytics.js
+var analyticsRangeSchema = external_exports.enum(["24h", "7d", "30d", "90d"]);
+var analyticsGranularitySchema = external_exports.enum(["hour", "day"]);
+var mcpConsumerKindSchema = external_exports.enum([
+  "oauth",
+  "personal_token",
+  "docs_agent_token",
+  "anonymous"
+]);
+var mcpToolKindSchema = external_exports.enum(["generic", "curated"]);
+var mcpToolCategorySchema = external_exports.enum(["openapi", "docs"]);
+var mcpExportDatasetSchema = external_exports.enum([
+  "tools",
+  "consumers",
+  "timeseries"
+]);
+var mcpAnalyticsParamsSchema = external_exports.object({
+  range: analyticsRangeSchema.default("7d"),
+  granularity: analyticsGranularitySchema.optional(),
+  installationId: external_exports.string().optional(),
+  clientName: external_exports.string().optional(),
+  /** Registered-client identity, not a person — see `CLIENT_ID_SQL`. */
+  clientId: external_exports.string().optional()
+});
+var mcpTimeseriesPointSchema = external_exports.object({
+  bucket: external_exports.string(),
+  calls: external_exports.number().int().nonnegative(),
+  errors: external_exports.number().int().nonnegative(),
+  p50_ms: external_exports.number().nonnegative(),
+  p95_ms: external_exports.number().nonnegative(),
+  p99_ms: external_exports.number().nonnegative(),
+  /**
+   * Exact per bucket: the rotating pseudonym is stable within a UTC day, and
+   * both the hour and day granularities sit inside one.
+   */
+  unique_consumers: external_exports.number().int().nonnegative()
+});
+var mcpCategoryTotalsSchema = external_exports.object({
+  openapi: external_exports.number().int().nonnegative(),
+  docs: external_exports.number().int().nonnegative()
+});
+var mcpOverviewTotalsSchema = external_exports.object({
+  calls: external_exports.number().int().nonnegative(),
+  errors: external_exports.number().int().nonnegative(),
+  /**
+   * The busiest single UTC day in the range, not a range-wide unique count.
+   * `distinct_id` rotates daily, so summing across days would overcount a
+   * returning caller once per day.
+   */
+  peak_daily_consumers: external_exports.number().int().nonnegative(),
+  p50_ms: external_exports.number().nonnegative(),
+  p95_ms: external_exports.number().nonnegative(),
+  p99_ms: external_exports.number().nonnegative(),
+  error_rate: external_exports.number().min(0).max(1)
+});
+var mcpOverviewResultSchema = external_exports.object({
+  totals: mcpOverviewTotalsSchema,
+  timeseries: external_exports.array(mcpTimeseriesPointSchema),
+  byCategory: mcpCategoryTotalsSchema
+});
+var mcpToolStatSchema = external_exports.object({
+  tool_name: external_exports.string(),
+  tool_kind: mcpToolKindSchema,
+  tool_category: mcpToolCategorySchema.nullable(),
+  operation_id: external_exports.string().nullable(),
+  calls: external_exports.number().int().nonnegative(),
+  errors: external_exports.number().int().nonnegative(),
+  p50_ms: external_exports.number().nonnegative(),
+  p95_ms: external_exports.number().nonnegative(),
+  p99_ms: external_exports.number().nonnegative(),
+  error_rate: external_exports.number().min(0).max(1),
+  /** Busiest single UTC day, for the same reason as the overview total. */
+  peak_daily_consumers: external_exports.number().int().nonnegative()
+});
+var mcpToolsResultSchema = external_exports.object({
+  tools: external_exports.array(mcpToolStatSchema)
+});
+var mcpConsumerStatSchema = external_exports.object({
+  client_id: external_exports.string(),
+  client_label: external_exports.string(),
+  client_name: external_exports.string(),
+  consumer_kind: mcpConsumerKindSchema,
+  calls: external_exports.number().int().nonnegative(),
+  errors: external_exports.number().int().nonnegative(),
+  first_seen: external_exports.string(),
+  last_seen: external_exports.string(),
+  top_tool: external_exports.string().nullable()
+});
+var mcpConsumersResultSchema = external_exports.object({
+  consumers: external_exports.array(mcpConsumerStatSchema)
+});
+var mcpLatencyByToolEntrySchema = external_exports.object({
+  tool_name: external_exports.string(),
+  calls: external_exports.number().int().nonnegative(),
+  p50_ms: external_exports.number().nonnegative(),
+  p95_ms: external_exports.number().nonnegative(),
+  p99_ms: external_exports.number().nonnegative()
+});
+var mcpLatencyResultSchema = external_exports.object({
+  tools: external_exports.array(mcpLatencyByToolEntrySchema)
+});
+var mcpErrorEntrySchema = external_exports.object({
+  error_code: external_exports.string(),
+  count: external_exports.number().int().nonnegative()
+});
+var mcpErrorsResultSchema = external_exports.object({
+  totals: external_exports.object({
+    calls: external_exports.number().int().nonnegative(),
+    errors: external_exports.number().int().nonnegative(),
+    error_rate: external_exports.number().min(0).max(1)
+  }),
+  byCode: external_exports.array(mcpErrorEntrySchema)
+});
+var analyticsServerParams = external_exports.object({ mcpServerId: external_exports.uuid() });
+var analyticsListQuerySchema = external_exports.object({
+  range: analyticsRangeSchema.default("7d"),
+  limit: external_exports.coerce.number().int().min(1).max(100).default(20),
+  installationId: external_exports.string().optional(),
+  clientName: external_exports.string().optional(),
+  clientId: external_exports.string().optional()
+});
+var analyticsRoutes = {
+  overview: {
+    method: "GET",
+    path: (p) => `/analytics/mcp-servers/${p.mcpServerId}/overview`,
+    params: analyticsServerParams,
+    query: mcpAnalyticsParamsSchema,
+    response: mcpOverviewResultSchema,
+    responses: { 403: agentApiErrorSchema, 404: agentApiErrorSchema },
+    summary: "Get MCP server analytics overview"
+  },
+  tools: {
+    method: "GET",
+    path: (p) => `/analytics/mcp-servers/${p.mcpServerId}/tools`,
+    params: analyticsServerParams,
+    query: analyticsListQuerySchema,
+    response: mcpToolsResultSchema,
+    responses: { 403: agentApiErrorSchema, 404: agentApiErrorSchema },
+    summary: "Get MCP server tool analytics"
+  },
+  consumers: {
+    method: "GET",
+    path: (p) => `/analytics/mcp-servers/${p.mcpServerId}/consumers`,
+    params: analyticsServerParams,
+    query: analyticsListQuerySchema,
+    response: mcpConsumersResultSchema,
+    responses: { 403: agentApiErrorSchema, 404: agentApiErrorSchema },
+    summary: "Get MCP server consumer analytics"
+  },
+  latency: {
+    method: "GET",
+    path: (p) => `/analytics/mcp-servers/${p.mcpServerId}/latency`,
+    params: analyticsServerParams,
+    query: analyticsListQuerySchema,
+    response: mcpLatencyResultSchema,
+    responses: { 403: agentApiErrorSchema, 404: agentApiErrorSchema },
+    summary: "Get MCP server latency analytics"
+  },
+  errors: {
+    method: "GET",
+    path: (p) => `/analytics/mcp-servers/${p.mcpServerId}/errors`,
+    params: analyticsServerParams,
+    query: external_exports.object({
+      range: analyticsRangeSchema.default("7d"),
+      limit: external_exports.coerce.number().int().min(1).max(100).default(10),
+      installationId: external_exports.string().optional(),
+      clientName: external_exports.string().optional(),
+      clientId: external_exports.string().optional()
+    }),
+    response: mcpErrorsResultSchema,
+    responses: { 403: agentApiErrorSchema, 404: agentApiErrorSchema },
+    summary: "Get MCP server error analytics"
+  },
+  export: {
+    method: "GET",
+    path: (p) => `/analytics/mcp-servers/${p.mcpServerId}/export`,
+    params: analyticsServerParams,
+    query: external_exports.object({
+      range: analyticsRangeSchema.default("7d"),
+      dataset: mcpExportDatasetSchema,
+      installationId: external_exports.string().optional(),
+      clientName: external_exports.string().optional(),
+      clientId: external_exports.string().optional()
+    }),
+    responses: { 403: agentApiErrorSchema, 404: agentApiErrorSchema },
+    responseMediaType: "text/csv",
+    summary: "Export MCP server analytics as CSV"
+  }
+};
+
+// ../../packages/entities/dist/api/agent/dashboard.js
+var DASHBOARD_EDITOR_TOOL_NAMES = /* @__PURE__ */ new Set([
+  "read_file",
+  "list_files",
+  "glob",
+  "grep",
+  "write_file",
+  "edit_file",
+  "get_current_file",
+  "validate_openapi",
+  "summarize_openapi",
+  "validate_config"
+]);
+var DASHBOARD_SDK_TOOL_NAMES = /* @__PURE__ */ new Set([
+  "get_sdk_config",
+  "set_sdk_config"
+]);
+var DASHBOARD_SDK_CONTEXT_KEY = "sdk-studio";
+var DASHBOARD_EDITOR_CONTEXT_KEY = "docs-editor";
+var DASHBOARD_CHAT_CONTEXT_MAX_CHARS = 12e4;
+var DASHBOARD_CHAT_MAX_MESSAGES = 400;
+var dashboardChatSettingsSchema = external_exports.object({
+  mode: external_exports.enum(["fast", "medium", "max"]).default("medium")
+});
+var dashboardChatBodySchema = external_exports.object({
+  id: external_exports.string(),
+  /**
+   * Only what the browser composed or the model answered. A `system`
+   * message is the server's alone, so one a client stamps is refused at
+   * the door rather than joined to the real system prompt.
+   */
+  messages: external_exports.array(external_exports.object({ role: external_exports.enum(["user", "assistant"]) }).loose()).max(DASHBOARD_CHAT_MAX_MESSAGES),
+  /**
+   * `{ [pluginId]: slice }` — opaque here. Each server tool pack validates
+   * its own key and ignores the rest, so a client ahead of the server can
+   * send a slice nothing reads yet.
+   */
+  context: external_exports.record(external_exports.string(), external_exports.unknown()).default({}),
+  settings: dashboardChatSettingsSchema.default({ mode: "medium" }),
+  /**
+   * Wire names the browser can execute this turn. The server offers a
+   * client-executed tool only when it is named here, so a call the browser
+   * cannot answer never reaches the model.
+   */
+  clientTools: external_exports.array(external_exports.string().max(64)).max(64).default([])
+}).superRefine((body, ctx) => {
+  if (JSON.stringify(body.context).length > DASHBOARD_CHAT_CONTEXT_MAX_CHARS) {
+    ctx.addIssue({ code: "custom", message: "context too large" });
+  }
+  if (body.clientTools.some((name) => DASHBOARD_SDK_TOOL_NAMES.has(name)) && !body.context[DASHBOARD_SDK_CONTEXT_KEY]) {
+    ctx.addIssue({
+      code: "custom",
+      message: "sdk tools require the sdk-studio context slice"
+    });
+  }
+  if (body.clientTools.some((name) => DASHBOARD_EDITOR_TOOL_NAMES.has(name)) && !body.context[DASHBOARD_EDITOR_CONTEXT_KEY]) {
+    ctx.addIssue({
+      code: "custom",
+      message: "editor tools require docs-editor context"
+    });
+  }
+});
+var dashboardRoutes = {
+  chat: {
+    method: "POST",
+    path: () => "/dashboard/chat",
+    body: dashboardChatBodySchema,
+    responses: {
+      400: agentApiErrorSchema,
+      402: agentApiErrorSchema,
+      403: agentApiErrorSchema
+    },
+    responseMediaType: "text/event-stream",
+    summary: "Chat with the dashboard assistant"
+  }
+};
+
+// ../../packages/entities/dist/api/agent/docs.js
+var docsProjectAgentInfoSchema = external_exports.object({
+  id: external_exports.string(),
+  mcpServerId: external_exports.string().nullable(),
+  mcpInstallationId: external_exports.string().nullable(),
+  mcpServerName: external_exports.string().nullable(),
+  mcpServerSlug: external_exports.string().nullable(),
+  mcpInstallationSlug: external_exports.string().nullable()
+});
+var docsChatContextSchema = external_exports.object({
+  /** The Vue-router path of the current page, without the hash. */
+  path: external_exports.string().max(2048),
+  /** The `route.meta.page` type (e.g. `page`, `openapi-single`), for phrasing. */
+  kind: external_exports.string().max(64).optional(),
+  /** The OpenAPI/AsyncAPI document the page belongs to, when it is a reference. */
+  documentUid: external_exports.string().max(256).optional(),
+  /**
+   * Full navigation id of the entity in view. Lets the server rebuild the
+   * anchored `to` for a single-page reference operation and match it.
+   */
+  navId: external_exports.string().max(2048).optional()
+});
+var docsRoutes = {
+  getProject: {
+    method: "GET",
+    path: (p) => `/docs/projects/${p.projectUid}`,
+    params: external_exports.object({ projectUid: external_exports.string() }),
+    response: docsProjectAgentInfoSchema,
+    responses: { 404: agentApiErrorSchema },
+    summary: "Get the agent info for a docs project"
+  },
+  updateProject: {
+    method: "PATCH",
+    path: (p) => `/docs/projects/${p.projectUid}`,
+    params: external_exports.object({ projectUid: external_exports.string() }),
+    body: external_exports.object({
+      mcpServerId: external_exports.string().nullable(),
+      mcpInstallationId: external_exports.string().nullable()
+    }).partial(),
+    response: agentDocsProjectSchema,
+    responses: { 400: agentApiErrorSchema, 404: agentApiErrorSchema },
+    summary: "Update the MCP links of a docs project"
+  },
+  initAgentInProject: {
+    method: "POST",
+    path: (p) => `/docs/projects/${p.projectUid}/init`,
+    params: external_exports.object({ projectUid: external_exports.string() }),
+    response: external_exports.null(),
+    responses: { 400: agentApiErrorSchema },
+    summary: "Initialize the agent for a docs project"
+  },
+  embedPublish: {
+    method: "POST",
+    path: (p) => `/docs/publishes/${p.publishUid}/embed`,
+    params: external_exports.object({ publishUid: nanoidSchema }),
+    response: external_exports.null(),
+    responses: { 404: agentApiErrorSchema, 500: agentApiErrorSchema },
+    summary: "Embed a docs publish (internal)"
+  },
+  chat: {
+    method: "POST",
+    path: () => "/docs/chat",
+    body: external_exports.object({
+      id: external_exports.string(),
+      messages: external_exports.any().array(),
+      // What the visitor is currently viewing, so the agent can answer about it.
+      // Optional so a docs bundle that sends no context keeps working unchanged.
+      context: docsChatContextSchema.optional()
+    }),
+    responses: { 400: agentApiErrorSchema, 403: agentApiErrorSchema },
+    responseMediaType: "text/event-stream",
+    summary: "Chat with the docs agent"
+  }
+};
+
+// ../../packages/entities/dist/api/agent/editor.js
+var editorChatBodySchema = external_exports.object({
+  id: external_exports.string(),
+  projectUid: external_exports.string(),
+  mode: external_exports.enum(["fast", "medium", "max"]).default("medium"),
+  messages: external_exports.any().array(),
+  context: external_exports.object({
+    openFile: external_exports.object({
+      path: external_exports.string(),
+      content: external_exports.string(),
+      isDirty: external_exports.boolean()
+    }).nullable().optional(),
+    pinnedFiles: external_exports.array(external_exports.object({
+      path: external_exports.string(),
+      content: external_exports.string()
+    })).default([]),
+    repoMetadata: external_exports.object({
+      topLevelDirs: external_exports.array(external_exports.string()).default([]),
+      totalFileCount: external_exports.number().int().nonnegative().default(0),
+      depthOneListing: external_exports.array(external_exports.object({
+        path: external_exports.string(),
+        type: external_exports.enum(["file", "directory"])
+      })).optional()
+    }).default({ topLevelDirs: [], totalFileCount: 0 }),
+    scalarConfig: external_exports.object({
+      path: external_exports.string(),
+      content: external_exports.string()
+    }).nullable().optional()
+  }).default({
+    pinnedFiles: [],
+    repoMetadata: { topLevelDirs: [], totalFileCount: 0 }
+  })
+});
+var MAX_TOTAL_DIFF_CHARS = 8e4;
+var pullRequestDescriptionBodySchema = external_exports.object({
+  projectUid: external_exports.string(),
+  title: external_exports.string().max(300).default(""),
+  baseBranch: external_exports.string().max(250),
+  files: external_exports.array(external_exports.object({
+    path: external_exports.string().max(500),
+    status: external_exports.enum(["added", "modified", "deleted"]),
+    additions: external_exports.number().int().nonnegative(),
+    deletions: external_exports.number().int().nonnegative(),
+    diff: external_exports.string().max(16e3).nullable()
+  })).min(1).max(60),
+  truncated: external_exports.boolean().default(false)
+}).refine((body) => body.files.reduce((total, file) => total + (file.diff?.length ?? 0), 0) <= MAX_TOTAL_DIFF_CHARS, { message: "Combined diff content is too large." });
+var editorRoutes = {
+  chat: {
+    method: "POST",
+    path: () => "/editor/chat",
+    body: editorChatBodySchema,
+    responses: {
+      400: agentApiErrorSchema,
+      402: agentApiErrorSchema,
+      403: agentApiErrorSchema,
+      404: agentApiErrorSchema
+    },
+    responseMediaType: "text/event-stream",
+    summary: "Chat with the docs editor agent"
+  },
+  pullRequestDescription: {
+    method: "POST",
+    path: () => "/editor/pull-request-description",
+    body: pullRequestDescriptionBodySchema,
+    response: external_exports.object({ title: external_exports.string(), description: external_exports.string() }),
+    responses: {
+      400: agentApiErrorSchema,
+      402: agentApiErrorSchema,
+      403: agentApiErrorSchema,
+      404: agentApiErrorSchema
+    },
+    summary: "Generate a pull request title and description"
+  }
+};
+
+// ../../packages/entities/dist/api/agent/internal.js
+var internalRoutes = {
+  getMcpInstallationBySlugs: {
+    method: "GET",
+    path: () => "/internal/mcp/by-slug",
+    query: external_exports.object({
+      teamUid: external_exports.string(),
+      serverSlug: slugSchema,
+      installationSlug: slugSchema
+    }),
+    response: external_exports.object({
+      mcpServerId: external_exports.string(),
+      mcpInstallationId: external_exports.string()
+    }),
+    responses: { 400: agentApiErrorSchema, 404: agentApiErrorSchema },
+    summary: "Resolve an MCP installation by team and slugs"
+  },
+  createDocsProject: {
+    method: "POST",
+    path: () => "/internal/docs/projects",
+    body: external_exports.object({
+      project: sharedProjectSchema,
+      teamUid: external_exports.string(),
+      type: external_exports.enum(docsProjectTypes)
+    }),
+    response: external_exports.null(),
+    responses: { 400: agentApiErrorSchema },
+    summary: "Create a docs project synchronously"
+  },
+  migrateDocsProjectToUnifiedDocs: {
+    method: "POST",
+    path: (p) => `/internal/docs/projects/${p.projectUid}/migrate-to-unified-docs`,
+    params: external_exports.object({ projectUid: external_exports.string() }),
+    response: external_exports.null(),
+    summary: "Reclassify a docs project as unified docs"
+  }
+};
+
+// ../../packages/entities/dist/api/agent/mcp-installations.js
+var installationToolSchema = external_exports.object({
+  name: external_exports.string(),
+  description: external_exports.string().optional(),
+  inputSchema: external_exports.unknown()
+});
+var installationSummarySchema = external_exports.object({
+  id: external_exports.string(),
+  name: external_exports.string(),
+  slug: external_exports.string(),
+  isPrivate: external_exports.boolean(),
+  /** Defaulted so a not-yet-redeployed agent service still parses. */
+  mcpVersion: external_exports.string().nullable().default(null)
+});
+var serverParams = external_exports.object({ id: external_exports.uuid() });
+var installationParams = external_exports.object({
+  id: external_exports.uuid(),
+  installationId: external_exports.uuid()
+});
+var mcpInstallationRoutes = {
+  listInstallations: {
+    method: "GET",
+    path: (p) => `/mcp/servers/${p.id}/installations`,
+    params: serverParams,
+    response: installationSummarySchema.array(),
+    responses: { 400: agentApiErrorSchema },
+    summary: "List the installations of an MCP server"
+  },
+  getInstallation: {
+    method: "GET",
+    path: (p) => `/mcp/servers/${p.id}/installations/${p.installationId}`,
+    params: installationParams,
+    response: mcpInstallationSchema,
+    responses: { 400: agentApiErrorSchema, 404: agentApiErrorSchema },
+    summary: "Get an MCP installation"
+  },
+  createInstallation: {
+    method: "POST",
+    path: (p) => `/mcp/servers/${p.id}/installations`,
+    params: external_exports.object({ id: external_exports.string() }),
+    body: external_exports.object({
+      name: external_exports.string().min(1).max(100),
+      slug: slugSchema.optional(),
+      documentAuth: external_exports.record(external_exports.string(), external_exports.unknown())
+    }),
+    response: mcpInstallationSchema,
+    responses: { 400: agentApiErrorSchema },
+    summary: "Create an MCP installation"
+  },
+  updateInstallation: {
+    method: "PATCH",
+    path: (p) => `/mcp/servers/${p.id}/installations/${p.installationId}`,
+    params: installationParams,
+    body: external_exports.object({
+      name: external_exports.string().min(1).max(100),
+      slug: slugSchema,
+      documentAuth: external_exports.record(external_exports.string(), external_exports.unknown()),
+      isPrivate: external_exports.boolean(),
+      loginPortalUid: external_exports.string().nullable(),
+      authConfig: mcpAuthConfigSchema,
+      mcpVersion: semverParamSchema.nullable()
+    }).partial(),
+    response: mcpInstallationSchema,
+    responses: { 400: agentApiErrorSchema },
+    summary: "Update an MCP installation"
+  },
+  deleteInstallation: {
+    method: "DELETE",
+    path: (p) => `/mcp/servers/${p.id}/installations/${p.installationId}`,
+    params: installationParams,
+    response: external_exports.null(),
+    responses: { 400: agentApiErrorSchema },
+    summary: "Delete an MCP installation"
+  },
+  addInstallationAccessGroup: {
+    method: "POST",
+    path: (p) => `/mcp/servers/${p.id}/installations/${p.installationId}/access-group`,
+    params: installationParams,
+    body: external_exports.object({ groupUid: external_exports.string() }),
+    response: mcpInstallationSchema,
+    responses: { 400: agentApiErrorSchema },
+    summary: "Add an access group to an installation"
+  },
+  removeInstallationAccessGroup: {
+    method: "DELETE",
+    path: (p) => `/mcp/servers/${p.id}/installations/${p.installationId}/access-group`,
+    params: installationParams,
+    body: external_exports.object({ groupUid: external_exports.string() }),
+    response: mcpInstallationSchema,
+    responses: { 400: agentApiErrorSchema },
+    summary: "Remove an access group from an installation"
+  },
+  getDefinition: {
+    method: "GET",
+    path: (p) => `/mcp/${p.installationId}`,
+    params: external_exports.object({ installationId: installationParamSchema }),
+    auth: false,
+    summary: "Get the public MCP server definition",
+    description: "Public MCP discovery endpoint. The `installationId` accepts `id` or `id@version`. The response shape is owned by the MCP protocol layer, so the contract declares no schema."
+  },
+  rpc: {
+    method: "POST",
+    path: (p) => `/mcp/${p.installationId}`,
+    params: external_exports.object({ installationId: installationParamSchema }),
+    headers: external_exports.object({
+      "X-Scalar-SDK-Provider": external_exports.enum(["VERCEL", "OPENAI", "ANTHROPIC"]).optional()
+    }),
+    auth: false,
+    responseMediaType: "text/event-stream",
+    requestBodyMediaType: "application/json",
+    requestBodyDescription: "JSON-RPC request handled by the MCP Streamable HTTP transport.",
+    summary: "Public MCP endpoint (JSON-RPC over Streamable HTTP)"
+  },
+  installationChat: {
+    method: "POST",
+    path: (p) => `/mcp/installations/${p.installationId}/chat`,
+    params: external_exports.object({ installationId: external_exports.uuid() }),
+    body: external_exports.object({
+      id: external_exports.string(),
+      messages: external_exports.any().array(),
+      system: external_exports.string().max(1e4).optional()
+    }),
+    responses: { 400: agentApiErrorSchema, 404: agentApiErrorSchema },
+    responseMediaType: "text/event-stream",
+    summary: "Chat with an MCP installation"
+  },
+  installationTools: {
+    method: "GET",
+    path: (p) => `/mcp/installations/${p.installationId}/tools`,
+    params: external_exports.object({ installationId: external_exports.uuid() }),
+    response: external_exports.object({ tools: installationToolSchema.array() }),
+    responses: { 404: agentApiErrorSchema },
+    summary: "List the tools of an MCP installation"
+  }
+};
+
+// ../../packages/entities/dist/api/agent/mcp-servers.js
+var mcpServerWithInstallationsSchema = mcpServerSchema.extend({
+  installations: external_exports.object({
+    id: external_exports.string(),
+    name: external_exports.string(),
+    slug: external_exports.string(),
+    mcpServerId: external_exports.string(),
+    isPrivate: external_exports.boolean()
+  }).array()
+});
+var mcpOperationToolDetailSchema = external_exports.object({
+  id: external_exports.string(),
+  mcpServerId: external_exports.string(),
+  operationId: external_exports.string(),
+  path: external_exports.string(),
+  method: external_exports.string(),
+  versionId: external_exports.string(),
+  searchToolEnabled: external_exports.boolean(),
+  executeRequestToolEnabled: external_exports.boolean(),
+  curatedToolEnabled: external_exports.boolean(),
+  name: external_exports.string().nullable(),
+  description: external_exports.string().nullable(),
+  deprecated: external_exports.boolean(),
+  deprecationMessage: external_exports.string().nullable(),
+  openApiOperationId: external_exports.string().nullable(),
+  operationSummary: external_exports.string().nullable()
+});
+var mcpDocsPageToolDetailSchema = external_exports.object({
+  id: external_exports.string(),
+  mcpServerId: external_exports.string(),
+  docsPageId: external_exports.string(),
+  title: external_exports.string(),
+  to: external_exports.string(),
+  filepath: external_exports.string(),
+  publishId: external_exports.string(),
+  searchToolEnabled: external_exports.boolean(),
+  executeRequestToolEnabled: external_exports.boolean()
+});
+var serverParams2 = external_exports.object({ id: external_exports.uuid() });
+var mcpServerRoutes = {
+  listServers: {
+    method: "GET",
+    path: () => "/mcp/servers",
+    response: mcpServerWithInstallationsSchema.array(),
+    responses: { 400: agentApiErrorSchema },
+    summary: "List MCP servers for the team"
+  },
+  getServer: {
+    method: "GET",
+    path: (p) => `/mcp/servers/${p.id}`,
+    params: serverParams2,
+    response: mcpServerSchema,
+    responses: { 400: agentApiErrorSchema, 404: agentApiErrorSchema },
+    summary: "Get an MCP server"
+  },
+  createServer: {
+    method: "POST",
+    path: () => "/mcp/servers",
+    body: external_exports.object({
+      name: external_exports.string().min(1).max(100),
+      slug: slugSchema.optional(),
+      versionUids: external_exports.array(external_exports.string()).optional(),
+      projectUids: external_exports.array(external_exports.string()).optional(),
+      documentTracking: external_exports.array(external_exports.object({
+        versionUid: external_exports.string(),
+        trackMode: external_exports.enum(mcpDocumentTrackModes)
+      })).optional(),
+      docsProjectTracking: external_exports.array(external_exports.object({
+        projectUid: external_exports.string(),
+        trackMode: external_exports.enum(mcpDocsProjectTrackModes)
+      })).optional(),
+      toolMode: external_exports.enum(mcpServerToolModes).optional()
+    }),
+    response: external_exports.object({
+      server: mcpServerSchema,
+      installation: mcpInstallationSchema
+    }),
+    responses: { 400: agentApiErrorSchema },
+    summary: "Create an MCP server"
+  },
+  createInstantServer: {
+    method: "POST",
+    path: () => "/mcp/servers/instant",
+    body: external_exports.object({
+      name: external_exports.string().min(1).max(100),
+      slug: slugSchema.optional(),
+      versionUid: external_exports.string(),
+      installationName: external_exports.string().min(1).max(100),
+      installationSlug: slugSchema.optional(),
+      documentAuth: external_exports.record(external_exports.string(), external_exports.unknown()),
+      toolMode: external_exports.enum(mcpServerToolModes).optional()
+    }),
+    response: external_exports.object({
+      server: mcpServerSchema,
+      installation: mcpInstallationSchema
+    }),
+    responses: { 400: agentApiErrorSchema },
+    summary: "Create an MCP server with an installation in one call"
+  },
+  updateServer: {
+    method: "PATCH",
+    path: (p) => `/mcp/servers/${p.id}`,
+    params: serverParams2,
+    body: external_exports.object({
+      name: external_exports.string().min(1).max(100),
+      slug: slugSchema,
+      autoAddOperations: external_exports.boolean(),
+      operations: external_exports.array(external_exports.uuid()),
+      docsPages: external_exports.array(external_exports.uuid()),
+      bumpStrategy: bumpStrategySchema,
+      bumpKind: bumpKindSchema
+    }).partial(),
+    response: mcpServerSchema,
+    responses: {
+      400: agentApiErrorSchema,
+      403: agentApiErrorSchema,
+      409: agentApiErrorSchema
+    },
+    summary: "Update an MCP server"
+  },
+  deleteServer: {
+    method: "DELETE",
+    path: (p) => `/mcp/servers/${p.id}`,
+    params: serverParams2,
+    response: external_exports.null(),
+    responses: { 400: agentApiErrorSchema },
+    summary: "Delete an MCP server"
+  },
+  getOperationToolsByVersion: {
+    method: "GET",
+    path: (p) => `/mcp/servers/${p.id}/operation-tools/${p.versionId}`,
+    params: external_exports.object({ id: external_exports.uuid(), versionId: external_exports.uuid() }),
+    response: mcpOperationToolDetailSchema.array(),
+    responses: { 400: agentApiErrorSchema },
+    summary: "List operation tools for a linked document version"
+  },
+  updateOperationTools: {
+    method: "PATCH",
+    path: (p) => `/mcp/servers/${p.id}/operation-tools`,
+    params: serverParams2,
+    body: external_exports.object({
+      operationTools: external_exports.array(external_exports.object({
+        operationId: external_exports.uuid(),
+        searchToolEnabled: external_exports.boolean(),
+        executeRequestToolEnabled: external_exports.boolean(),
+        curatedToolEnabled: external_exports.boolean()
+      }).partial({
+        searchToolEnabled: true,
+        executeRequestToolEnabled: true,
+        curatedToolEnabled: true
+      }).refine((tool) => tool.searchToolEnabled !== void 0 || tool.executeRequestToolEnabled !== void 0 || tool.curatedToolEnabled !== void 0, { message: "At least one flag must be provided." })).min(1),
+      bumpStrategy: bumpStrategySchema.optional(),
+      bumpKind: bumpKindSchema.optional()
+    }),
+    response: external_exports.array(mcpServerOperationToolSchema),
+    responses: {
+      400: agentApiErrorSchema,
+      403: agentApiErrorSchema,
+      409: agentApiErrorSchema
+    },
+    summary: "Update operation tool flags"
+  },
+  deleteOperationTool: {
+    method: "DELETE",
+    path: (p) => `/mcp/servers/${p.id}/operation-tools/${p.toolId}`,
+    params: external_exports.object({ id: external_exports.uuid(), toolId: external_exports.uuid() }),
+    response: external_exports.null(),
+    responses: { 400: agentApiErrorSchema },
+    summary: "Delete an operation tool"
+  },
+  deleteOperationToolsByVersion: {
+    method: "DELETE",
+    path: (p) => `/mcp/servers/${p.id}/operation-tools/versions/${p.versionId}`,
+    params: external_exports.object({ id: external_exports.uuid(), versionId: external_exports.uuid() }),
+    response: external_exports.null(),
+    responses: { 400: agentApiErrorSchema },
+    summary: "Delete all operation tools of a linked version"
+  },
+  setOperationToolMetadata: {
+    method: "PATCH",
+    path: (p) => `/mcp/servers/${p.id}/operation-tools/${p.operationToolId}/metadata`,
+    params: external_exports.object({ id: external_exports.uuid(), operationToolId: external_exports.uuid() }),
+    body: external_exports.object({
+      name: external_exports.string().nullable().optional(),
+      description: external_exports.string().nullable().optional(),
+      deprecated: external_exports.boolean().optional(),
+      deprecationMessage: external_exports.string().nullable().optional()
+    }),
+    response: external_exports.object({
+      operationToolId: external_exports.string(),
+      name: external_exports.string().nullable().optional(),
+      description: external_exports.string().nullable().optional(),
+      deprecated: external_exports.boolean().optional(),
+      deprecationMessage: external_exports.string().nullable().optional()
+    }),
+    responses: { 400: agentApiErrorSchema, 403: agentApiErrorSchema },
+    summary: "Set custom name and description on an operation tool"
+  },
+  getDocsPageToolsByPublish: {
+    method: "GET",
+    path: (p) => `/mcp/servers/${p.id}/docs-page-tools/${p.publishId}`,
+    params: external_exports.object({ id: external_exports.uuid(), publishId: external_exports.uuid() }),
+    response: mcpDocsPageToolDetailSchema.array(),
+    responses: { 400: agentApiErrorSchema },
+    summary: "List docs page tools for a linked publish"
+  },
+  updateDocsPageTools: {
+    method: "PATCH",
+    path: (p) => `/mcp/servers/${p.id}/docs-page-tools`,
+    params: serverParams2,
+    body: external_exports.object({
+      docsPageTools: external_exports.array(external_exports.object({
+        docsPageId: external_exports.uuid(),
+        searchToolEnabled: external_exports.boolean(),
+        executeRequestToolEnabled: external_exports.boolean()
+      }).partial({
+        searchToolEnabled: true,
+        executeRequestToolEnabled: true
+      }).refine((tool) => tool.searchToolEnabled !== void 0 || tool.executeRequestToolEnabled !== void 0, { message: "At least one flag must be provided." })).min(1),
+      bumpStrategy: bumpStrategySchema.optional(),
+      bumpKind: bumpKindSchema.optional()
+    }),
+    response: external_exports.array(mcpServerDocsPageToolSchema),
+    responses: {
+      400: agentApiErrorSchema,
+      403: agentApiErrorSchema,
+      409: agentApiErrorSchema
+    },
+    summary: "Update docs page tool flags"
+  },
+  deleteDocsPageTool: {
+    method: "DELETE",
+    path: (p) => `/mcp/servers/${p.id}/docs-page-tools/${p.toolId}`,
+    params: external_exports.object({ id: external_exports.uuid(), toolId: external_exports.uuid() }),
+    response: external_exports.null(),
+    responses: { 400: agentApiErrorSchema },
+    summary: "Delete a docs page tool"
+  },
+  deleteDocsPageToolsByPublish: {
+    method: "DELETE",
+    path: (p) => `/mcp/servers/${p.id}/docs-page-tools/publishes/${p.publishId}`,
+    params: external_exports.object({ id: external_exports.uuid(), publishId: external_exports.uuid() }),
+    response: external_exports.null(),
+    responses: { 400: agentApiErrorSchema },
+    summary: "Delete all docs page tools of a publish"
+  },
+  listServerPublishes: {
+    method: "GET",
+    path: (p) => `/mcp/servers/${p.id}/docs-publishes`,
+    params: serverParams2,
+    response: external_exports.object({
+      id: external_exports.string(),
+      uid: external_exports.string(),
+      name: external_exports.string(),
+      projectId: external_exports.string(),
+      projectUid: external_exports.string(),
+      projectType: external_exports.enum(docsProjectTypes),
+      domain: external_exports.string(),
+      embedStatus: external_exports.enum(embedStatuses),
+      createdAt: external_exports.date(),
+      updatedAt: external_exports.date()
+    }).array(),
+    responses: { 400: agentApiErrorSchema },
+    summary: "List docs publishes linked to an MCP server"
+  },
+  listDocumentVersions: {
+    method: "GET",
+    path: (p) => `/mcp/servers/${p.id}/document-versions`,
+    params: serverParams2,
+    response: external_exports.object({
+      id: external_exports.string(),
+      uid: external_exports.string(),
+      semver: external_exports.string(),
+      documentId: external_exports.string(),
+      documentUid: external_exports.string(),
+      embedStatus: external_exports.string(),
+      slug: external_exports.string(),
+      namespace: external_exports.string(),
+      createdAt: external_exports.date(),
+      updatedAt: external_exports.date(),
+      toolMode: external_exports.enum(mcpServerToolModes)
+    }).array(),
+    responses: { 400: agentApiErrorSchema },
+    summary: "List document versions linked to an MCP server"
+  },
+  getDocumentVersionSpec: {
+    method: "GET",
+    path: (p) => `/mcp/servers/${p.id}/document-versions/${p.versionId}/spec`,
+    params: external_exports.object({ id: external_exports.uuid(), versionId: external_exports.uuid() }),
+    response: external_exports.string(),
+    responses: { 400: agentApiErrorSchema, 404: agentApiErrorSchema },
+    responseMediaType: "text/plain",
+    summary: "Get the raw spec of a linked document version"
+  },
+  getAvailableOperationsForVersion: {
+    method: "GET",
+    path: (p) => `/mcp/servers/${p.id}/document-versions/${p.versionUid}/available-operations`,
+    params: external_exports.object({ id: external_exports.uuid(), versionUid: external_exports.string() }),
+    response: external_exports.object({
+      id: external_exports.string(),
+      path: external_exports.string(),
+      method: external_exports.string(),
+      versionId: external_exports.string(),
+      searchToolEnabled: external_exports.boolean(),
+      executeRequestToolEnabled: external_exports.boolean()
+    }).array(),
+    responses: { 400: agentApiErrorSchema },
+    summary: "List operations available to link for a version"
+  },
+  getAvailablePagesForProject: {
+    method: "GET",
+    path: (p) => `/mcp/servers/${p.id}/projects/${p.projectUid}/available-pages`,
+    params: external_exports.object({ id: external_exports.uuid(), projectUid: external_exports.string() }),
+    response: external_exports.object({
+      id: external_exports.string(),
+      publishId: external_exports.string(),
+      searchToolEnabled: external_exports.boolean(),
+      executeRequestToolEnabled: external_exports.boolean(),
+      title: external_exports.string(),
+      to: external_exports.string(),
+      filepath: external_exports.string(),
+      createdAt: external_exports.string()
+    }).array(),
+    responses: { 400: agentApiErrorSchema },
+    summary: "List docs pages available to link for a project"
+  },
+  setDocumentToolMode: {
+    method: "PATCH",
+    path: (p) => `/mcp/servers/${p.id}/document-versions/${p.versionId}/tool-mode`,
+    params: external_exports.object({ id: external_exports.uuid(), versionId: external_exports.uuid() }),
+    body: external_exports.object({
+      toolMode: external_exports.enum(mcpServerToolModes),
+      bumpStrategy: bumpStrategySchema.optional(),
+      bumpKind: bumpKindSchema.optional()
+    }),
+    response: external_exports.object({
+      documentVersionId: external_exports.string(),
+      toolMode: external_exports.enum(mcpServerToolModes)
+    }),
+    responses: {
+      400: agentApiErrorSchema,
+      403: agentApiErrorSchema,
+      409: agentApiErrorSchema
+    },
+    summary: "Set the tool mode of a linked document version"
+  },
+  linkDocumentVersion: {
+    method: "POST",
+    path: (p) => `/mcp/servers/${p.id}/document-versions/${p.versionUid}`,
+    params: external_exports.object({ id: external_exports.uuid(), versionUid: external_exports.string() }),
+    body: external_exports.object({
+      operationIds: external_exports.array(external_exports.uuid()).optional(),
+      bumpKind: bumpKindSchema.optional()
+    }),
+    response: external_exports.null(),
+    responses: { 400: agentApiErrorSchema, 403: agentApiErrorSchema },
+    summary: "Link a document version to an MCP server"
+  },
+  unlinkDocumentVersion: {
+    method: "DELETE",
+    path: (p) => `/mcp/servers/${p.id}/document-versions/${p.versionId}`,
+    params: external_exports.object({ id: external_exports.uuid(), versionId: external_exports.uuid() }),
+    response: external_exports.null(),
+    responses: { 400: agentApiErrorSchema, 403: agentApiErrorSchema },
+    summary: "Unlink a document version from an MCP server"
+  },
+  linkDocsPublish: {
+    method: "POST",
+    path: (p) => `/mcp/servers/${p.id}/docs-publishes/${p.publishUid}`,
+    params: external_exports.object({ id: external_exports.uuid(), publishUid: external_exports.string() }),
+    body: external_exports.object({
+      docsPageIds: external_exports.array(external_exports.uuid()).optional(),
+      bumpKind: bumpKindSchema.optional()
+    }),
+    response: external_exports.null(),
+    responses: { 400: agentApiErrorSchema, 403: agentApiErrorSchema },
+    summary: "Link a docs publish to an MCP server"
+  },
+  linkDocsPublishByProject: {
+    method: "POST",
+    path: (p) => `/mcp/servers/${p.id}/docs-publishes/by-project/${p.projectUid}`,
+    params: external_exports.object({ id: external_exports.uuid(), projectUid: external_exports.string() }),
+    body: external_exports.object({
+      docsPageIds: external_exports.array(external_exports.uuid()).optional(),
+      bumpKind: bumpKindSchema.optional()
+    }),
+    response: external_exports.null(),
+    responses: { 400: agentApiErrorSchema, 403: agentApiErrorSchema },
+    summary: "Link the active publish of a project to an MCP server"
+  },
+  unlinkDocsPublish: {
+    method: "DELETE",
+    path: (p) => `/mcp/servers/${p.id}/docs-publishes/${p.publishId}`,
+    params: external_exports.object({ id: external_exports.uuid(), publishId: external_exports.uuid() }),
+    response: external_exports.null(),
+    responses: { 400: agentApiErrorSchema, 403: agentApiErrorSchema },
+    summary: "Unlink a docs publish from an MCP server"
+  }
+};
+
+// ../../packages/entities/dist/api/agent/mcp-versions.js
+var mcpVersionToolsSchema = external_exports.object({
+  version: mcpServerVersionSchema,
+  operationTools: external_exports.array(external_exports.object({
+    id: external_exports.string(),
+    operationId: external_exports.string(),
+    searchToolEnabled: external_exports.boolean(),
+    executeRequestToolEnabled: external_exports.boolean(),
+    curatedToolEnabled: external_exports.boolean(),
+    name: external_exports.string().nullable(),
+    description: external_exports.string().nullable(),
+    deprecated: external_exports.boolean(),
+    deprecationMessage: external_exports.string().nullable(),
+    path: external_exports.string(),
+    method: external_exports.string(),
+    versionId: external_exports.string(),
+    openApiOperationId: external_exports.string().nullable(),
+    operationSummary: external_exports.string().nullable(),
+    semver: external_exports.string(),
+    documentId: external_exports.string(),
+    namespace: external_exports.string(),
+    slug: external_exports.string(),
+    title: external_exports.string()
+  })),
+  docsPageTools: external_exports.array(external_exports.object({
+    id: external_exports.string(),
+    docsPageId: external_exports.string(),
+    searchToolEnabled: external_exports.boolean(),
+    executeRequestToolEnabled: external_exports.boolean(),
+    title: external_exports.string(),
+    to: external_exports.string(),
+    publishId: external_exports.string(),
+    projectId: external_exports.string(),
+    projectName: external_exports.string(),
+    projectUid: external_exports.string()
+  })),
+  linkedDocumentVersions: external_exports.array(external_exports.object({
+    id: external_exports.string(),
+    uid: external_exports.string(),
+    semver: external_exports.string(),
+    namespace: external_exports.string(),
+    slug: external_exports.string(),
+    title: external_exports.string(),
+    documentUid: external_exports.string(),
+    trackMode: external_exports.enum(mcpDocumentTrackModes),
+    toolMode: external_exports.enum(mcpServerToolModes)
+  })),
+  linkedDocsPublishes: external_exports.array(external_exports.object({
+    id: external_exports.string(),
+    uid: external_exports.string(),
+    createdAt: external_exports.string(),
+    projectName: external_exports.string(),
+    projectUid: external_exports.string(),
+    projectType: external_exports.string(),
+    trackMode: external_exports.enum(mcpDocsProjectTrackModes)
+  }))
+});
+var serverParams3 = external_exports.object({ id: external_exports.uuid() });
+var versionParams = external_exports.object({ id: external_exports.uuid(), semver: semverParamSchema });
+var mcpVersionRoutes = {
+  listVersions: {
+    method: "GET",
+    path: (p) => `/mcp/servers/${p.id}/versions`,
+    params: serverParams3,
+    response: external_exports.object({
+      versions: external_exports.array(mcpServerVersionSchema),
+      latestVersionId: external_exports.string().nullable()
+    }),
+    responses: { 400: agentApiErrorSchema },
+    summary: "List the versions of an MCP server"
+  },
+  getVersion: {
+    method: "GET",
+    path: (p) => `/mcp/servers/${p.id}/versions/${p.semver}`,
+    params: versionParams,
+    response: mcpServerVersionSchema,
+    responses: { 400: agentApiErrorSchema },
+    summary: "Get one MCP server version"
+  },
+  getVersionTools: {
+    method: "GET",
+    path: (p) => `/mcp/servers/${p.id}/versions/${p.semver}/tools`,
+    params: versionParams,
+    response: mcpVersionToolsSchema,
+    responses: { 400: agentApiErrorSchema },
+    summary: "Get the tools and links of a version"
+  },
+  updateVersionTools: {
+    method: "PATCH",
+    path: (p) => `/mcp/servers/${p.id}/versions/${p.semver}/tools`,
+    params: versionParams,
+    body: external_exports.object({
+      operationTools: external_exports.array(external_exports.object({
+        operationId: external_exports.uuid(),
+        searchToolEnabled: external_exports.boolean().optional(),
+        executeRequestToolEnabled: external_exports.boolean().optional(),
+        curatedToolEnabled: external_exports.boolean().optional(),
+        name: external_exports.string().nullable().optional(),
+        description: external_exports.string().nullable().optional(),
+        deprecated: external_exports.boolean().optional(),
+        deprecationMessage: external_exports.string().nullable().optional()
+      })).optional(),
+      docsPageTools: external_exports.array(external_exports.object({
+        docsPageId: external_exports.uuid(),
+        searchToolEnabled: external_exports.boolean().optional(),
+        executeRequestToolEnabled: external_exports.boolean().optional()
+      })).optional()
+    }),
+    response: mcpServerVersionSchema,
+    responses: {
+      400: agentApiErrorSchema,
+      403: agentApiErrorSchema,
+      409: agentApiErrorSchema
+    },
+    summary: "Update tool flags and metadata on a version"
+  },
+  updateVersion: {
+    method: "PATCH",
+    path: (p) => `/mcp/servers/${p.id}/versions/${p.semver}`,
+    params: versionParams,
+    body: external_exports.object({ changeNote: external_exports.string().nullable().optional() }),
+    response: mcpServerVersionSchema,
+    responses: { 400: agentApiErrorSchema, 403: agentApiErrorSchema },
+    summary: "Update a draft version"
+  },
+  deleteVersion: {
+    method: "DELETE",
+    path: (p) => `/mcp/servers/${p.id}/versions/${p.semver}`,
+    params: versionParams,
+    response: external_exports.null(),
+    responses: { 400: agentApiErrorSchema, 403: agentApiErrorSchema },
+    summary: "Delete an MCP server version"
+  },
+  approveVersion: {
+    method: "POST",
+    path: (p) => `/mcp/servers/${p.id}/versions/${p.semver}/approve`,
+    params: versionParams,
+    response: mcpServerVersionSchema,
+    responses: { 400: agentApiErrorSchema, 403: agentApiErrorSchema },
+    summary: "Approve a draft version"
+  },
+  requestVersionApproval: {
+    method: "POST",
+    path: (p) => `/mcp/servers/${p.id}/versions/${p.semver}/request-approval`,
+    params: versionParams,
+    response: mcpServerVersionSchema,
+    responses: { 400: agentApiErrorSchema, 403: agentApiErrorSchema },
+    summary: "Send a draft version for approval"
+  },
+  getOpenDraft: {
+    method: "GET",
+    path: (p) => `/mcp/servers/${p.id}/draft`,
+    params: serverParams3,
+    response: mcpServerVersionSchema.nullable(),
+    responses: { 400: agentApiErrorSchema },
+    summary: "Get the open draft version, if any"
+  },
+  publishDraft: {
+    method: "POST",
+    path: (p) => `/mcp/servers/${p.id}/draft/publish`,
+    params: serverParams3,
+    body: external_exports.object({
+      bumpKind: bumpKindSchema.optional(),
+      customSemver: external_exports.string().optional()
+    }),
+    response: mcpServerVersionSchema,
+    responses: { 400: agentApiErrorSchema, 403: agentApiErrorSchema },
+    summary: "Publish the open draft version"
+  },
+  getVersionSuggestedTools: {
+    method: "GET",
+    path: (p) => `/mcp/servers/${p.id}/versions/${p.semver}/suggested-tools`,
+    params: versionParams,
+    response: external_exports.object({
+      suggestions: external_exports.array(external_exports.object({
+        id: external_exports.string(),
+        path: external_exports.string(),
+        method: external_exports.string(),
+        versionId: external_exports.string(),
+        semver: external_exports.string(),
+        documentId: external_exports.string()
+      })),
+      dismissed: external_exports.boolean()
+    }),
+    responses: { 400: agentApiErrorSchema },
+    summary: "List suggested tools for a version"
+  },
+  dismissVersionSuggestions: {
+    method: "POST",
+    path: (p) => `/mcp/servers/${p.id}/versions/${p.semver}/dismiss-suggestions`,
+    params: versionParams,
+    response: external_exports.null(),
+    responses: { 400: agentApiErrorSchema },
+    summary: "Dismiss tool suggestions for a version"
+  },
+  setVersionDocumentToolMode: {
+    method: "PATCH",
+    path: (p) => `/mcp/servers/${p.id}/versions/${p.semver}/document-versions/${p.documentVersionId}/tool-mode`,
+    params: external_exports.object({
+      id: external_exports.uuid(),
+      semver: semverParamSchema,
+      documentVersionId: external_exports.uuid()
+    }),
+    body: external_exports.object({ toolMode: external_exports.enum(mcpServerToolModes) }),
+    response: external_exports.object({
+      documentVersionId: external_exports.string(),
+      toolMode: external_exports.enum(mcpServerToolModes),
+      semver: external_exports.string()
+    }),
+    responses: {
+      400: agentApiErrorSchema,
+      403: agentApiErrorSchema,
+      409: agentApiErrorSchema
+    },
+    summary: "Set the tool mode of a document version within a version"
+  },
+  listDocumentTracking: {
+    method: "GET",
+    path: (p) => `/mcp/servers/${p.id}/document-tracking`,
+    params: serverParams3,
+    response: external_exports.array(external_exports.object({
+      id: external_exports.string(),
+      mcpServerId: external_exports.string(),
+      versionId: external_exports.string(),
+      documentId: external_exports.string(),
+      trackMode: external_exports.enum(mcpDocumentTrackModes),
+      documentUid: external_exports.string(),
+      namespace: external_exports.string(),
+      slug: external_exports.string(),
+      title: external_exports.string(),
+      currentVersion: external_exports.string(),
+      latestVersion: external_exports.string()
+    })),
+    responses: { 400: agentApiErrorSchema },
+    summary: "List document tracking entries"
+  },
+  setDocumentTracking: {
+    method: "POST",
+    path: (p) => `/mcp/servers/${p.id}/document-tracking`,
+    params: serverParams3,
+    body: external_exports.object({
+      documentId: external_exports.uuid(),
+      trackMode: external_exports.enum(mcpDocumentTrackModes),
+      pinnedVersionId: external_exports.uuid().optional(),
+      bumpKind: bumpKindSchema.optional()
+    }),
+    response: external_exports.object({
+      mcpServerId: external_exports.string(),
+      documentId: external_exports.string(),
+      versionId: external_exports.string(),
+      trackMode: external_exports.enum(mcpDocumentTrackModes)
+    }),
+    responses: { 400: agentApiErrorSchema, 403: agentApiErrorSchema },
+    summary: "Set how a document is tracked"
+  },
+  listDocsProjectTracking: {
+    method: "GET",
+    path: (p) => `/mcp/servers/${p.id}/docs-project-tracking`,
+    params: serverParams3,
+    response: external_exports.array(external_exports.object({
+      id: external_exports.string(),
+      mcpServerId: external_exports.string(),
+      docsProjectId: external_exports.string(),
+      docsPublishId: external_exports.string(),
+      trackMode: external_exports.enum(mcpDocsProjectTrackModes),
+      projectUid: external_exports.string(),
+      name: external_exports.string(),
+      activePublishId: external_exports.string().nullable()
+    })),
+    responses: { 400: agentApiErrorSchema },
+    summary: "List docs project tracking entries"
+  },
+  setDocsProjectTracking: {
+    method: "POST",
+    path: (p) => `/mcp/servers/${p.id}/docs-project-tracking`,
+    params: serverParams3,
+    body: external_exports.object({
+      docsProjectId: external_exports.uuid(),
+      trackMode: external_exports.enum(mcpDocsProjectTrackModes),
+      bumpKind: bumpKindSchema.optional()
+    }),
+    response: external_exports.object({
+      mcpServerId: external_exports.string(),
+      docsProjectId: external_exports.string(),
+      docsPublishId: external_exports.string(),
+      trackMode: external_exports.enum(mcpDocsProjectTrackModes)
+    }),
+    responses: { 400: agentApiErrorSchema, 403: agentApiErrorSchema },
+    summary: "Set how a docs project is tracked"
+  }
+};
+
+// ../../packages/entities/dist/api/agent/openapi.js
+var openapiRoutes = {
+  chat: {
+    method: "POST",
+    path: () => "/openapi/chat",
+    body: external_exports.object({
+      id: external_exports.string(),
+      messages: external_exports.any().array(),
+      registryDocuments: external_exports.object({ namespace: external_exports.string(), slug: external_exports.string() }).array()
+    }),
+    responses: {
+      400: agentApiErrorSchema,
+      402: agentApiErrorSchema,
+      403: agentApiErrorSchema
+    },
+    responseMediaType: "text/event-stream",
+    summary: "Chat about OpenAPI documents"
+  }
+};
+
+// ../../packages/entities/dist/api/agent/pubsub.js
+var pubsubRoutes = {
+  apiVersionCreated: {
+    method: "POST",
+    path: () => "/pubsub/api-version-created",
+    body: pubsubPushMessageSchema,
+    responses: { 400: agentApiErrorSchema },
+    auth: false,
+    summary: "Handle core api-version-created events"
+  },
+  apiShared: {
+    method: "POST",
+    path: () => "/pubsub/api-shared",
+    body: pubsubPushMessageSchema,
+    responses: { 400: agentApiErrorSchema },
+    auth: false,
+    summary: "Handle core api-shared events"
+  },
+  apiUpdated: {
+    method: "POST",
+    path: () => "/pubsub/api-updated",
+    body: pubsubPushMessageSchema,
+    responses: { 400: agentApiErrorSchema },
+    auth: false,
+    summary: "Handle core api-updated events"
+  },
+  apiVersionUpserted: {
+    method: "POST",
+    path: () => "/pubsub/api-version-upserted",
+    body: pubsubPushMessageSchema,
+    responses: { 400: agentApiErrorSchema },
+    auth: false,
+    summary: "Handle core api-version-upserted events"
+  },
+  apiDeleted: {
+    method: "POST",
+    path: () => "/pubsub/api-deleted",
+    body: pubsubPushMessageSchema,
+    responses: { 400: agentApiErrorSchema },
+    auth: false,
+    summary: "Handle core api-deleted events"
+  },
+  apiVersionDeleted: {
+    method: "POST",
+    path: () => "/pubsub/api-version-deleted",
+    body: pubsubPushMessageSchema,
+    responses: { 400: agentApiErrorSchema },
+    auth: false,
+    summary: "Handle core api-version-deleted events"
+  },
+  projectCreated: {
+    method: "POST",
+    path: () => "/pubsub/project-created",
+    body: pubsubPushMessageSchema,
+    response: external_exports.null(),
+    responses: { 400: agentApiErrorSchema, 404: agentApiErrorSchema },
+    auth: false,
+    summary: "Handle project-created events"
+  },
+  projectUpdated: {
+    method: "POST",
+    path: () => "/pubsub/project-updated",
+    body: pubsubPushMessageSchema,
+    response: external_exports.null(),
+    responses: { 400: agentApiErrorSchema, 404: agentApiErrorSchema },
+    auth: false,
+    summary: "Handle project-updated events"
+  },
+  projectDeleted: {
+    method: "POST",
+    path: () => "/pubsub/project-deleted",
+    body: pubsubPushMessageSchema,
+    response: external_exports.null(),
+    auth: false,
+    summary: "Handle project-deleted events"
+  },
+  publishCreated: {
+    method: "POST",
+    path: () => "/pubsub/publish-created",
+    body: pubsubPushMessageSchema,
+    response: external_exports.null(),
+    responses: { 400: agentApiErrorSchema, 404: agentApiErrorSchema },
+    auth: false,
+    summary: "Handle publish-created events"
+  },
+  publishDeleted: {
+    method: "POST",
+    path: () => "/pubsub/publish-deleted",
+    body: pubsubPushMessageSchema,
+    response: external_exports.null(),
+    auth: false,
+    summary: "Handle publish-deleted events"
+  }
+};
+
+// ../../packages/entities/dist/api/agent/registry.js
+var registryDocumentSchema = external_exports.object({
+  id: external_exports.string(),
+  title: external_exports.string(),
+  namespace: external_exports.string(),
+  currentVersion: external_exports.string(),
+  slug: external_exports.string(),
+  logoUrl: external_exports.string().nullable()
+});
+var registryVersionOperationSchema = external_exports.object({
+  id: external_exports.string(),
+  path: external_exports.string(),
+  method: external_exports.string(),
+  searchToolEnabled: external_exports.boolean(),
+  executeRequestToolEnabled: external_exports.boolean()
+});
+var registrySearchResultSchema = external_exports.object({
+  id: external_exports.string(),
+  title: external_exports.string(),
+  slug: external_exports.string(),
+  namespace: external_exports.string(),
+  currentVersion: external_exports.string(),
+  logoUrl: external_exports.string().nullable(),
+  searchEnabled: external_exports.boolean(),
+  rank: external_exports.number()
+});
+var registryRoutes = {
+  getDocument: {
+    method: "GET",
+    path: (p) => `/registry/document/${p.namespace}/${p.slug}`,
+    params: external_exports.object({ namespace: external_exports.string(), slug: external_exports.string() }),
+    response: registryDocumentSchema,
+    responses: { 400: agentApiErrorSchema },
+    summary: "Get a registry document"
+  },
+  listKeyDocuments: {
+    method: "GET",
+    path: () => "/registry/documents",
+    headers: external_exports.object({ [SCALAR_AGENT_KEY_HEADER]: external_exports.string().optional() }),
+    response: external_exports.object({ documents: registryDocumentSchema.array() }),
+    responses: { 400: agentApiErrorSchema },
+    summary: "List the documents accessible with an agent key"
+  },
+  waitForEmbed: {
+    method: "GET",
+    path: (p) => `/registry/embeddings/${p.namespace}/${p.slug}`,
+    params: external_exports.object({ namespace: external_exports.string(), slug: external_exports.string() }),
+    query: external_exports.object({ version: external_exports.string().optional() }),
+    response: external_exports.null(),
+    responses: {
+      400: agentApiErrorSchema,
+      403: agentApiErrorSchema,
+      408: agentApiErrorSchema
+    },
+    summary: "Wait for a document embedding to complete (long poll)"
+  },
+  listCuratedDocs: {
+    method: "GET",
+    path: () => "/registry/curated",
+    query: external_exports.object({ limit: external_exports.coerce.number().max(100).default(10) }),
+    response: external_exports.object({ results: registryDocumentSchema.array() }),
+    summary: "List curated registry documents"
+  },
+  search: {
+    method: "GET",
+    path: () => "/registry/search",
+    query: external_exports.object({ query: external_exports.string().max(30) }),
+    response: external_exports.object({ results: registrySearchResultSchema.array() }),
+    responses: { 400: agentApiErrorSchema },
+    summary: "Search registry documents"
+  },
+  getVersionOperations: {
+    method: "GET",
+    path: (p) => `/registry/versions/${p.versionUid}/operations`,
+    params: external_exports.object({ versionUid: external_exports.string() }),
+    response: external_exports.object({
+      operations: registryVersionOperationSchema.array(),
+      embedStatus: external_exports.enum(embedStatuses)
+    }),
+    responses: { 400: agentApiErrorSchema, 404: agentApiErrorSchema },
+    summary: "List the operations of a document version"
+  },
+  updateVersionOperations: {
+    method: "PATCH",
+    path: (p) => `/registry/versions/${p.versionUid}/operations`,
+    params: external_exports.object({ versionUid: external_exports.string() }),
+    body: external_exports.object({
+      operations: external_exports.object({
+        id: external_exports.uuid(),
+        searchToolEnabled: external_exports.boolean(),
+        executeRequestToolEnabled: external_exports.boolean()
+      }).array().min(1)
+    }),
+    response: external_exports.object({
+      operations: registryVersionOperationSchema.array()
+    }),
+    responses: { 400: agentApiErrorSchema },
+    summary: "Update tool flags on version operations"
+  },
+  embedVersion: {
+    method: "POST",
+    path: (p) => `/registry/versions/${p.versionUid}/embed`,
+    params: external_exports.object({ versionUid: external_exports.string() }),
+    body: external_exports.object({
+      title: external_exports.string(),
+      description: external_exports.string(),
+      version: external_exports.string(),
+      versionUid: external_exports.string(),
+      apiUid: external_exports.string(),
+      namespace: external_exports.string(),
+      slug: external_exports.string(),
+      isLatest: external_exports.boolean(),
+      isPrivate: external_exports.boolean()
+    }),
+    response: external_exports.null(),
+    responses: { 400: agentApiErrorSchema },
+    summary: "Embed a document version"
+  },
+  setDocumentCurrentVersion: {
+    method: "PATCH",
+    path: (p) => `/registry/documents/${p.uid}/current-version`,
+    params: external_exports.object({ uid: external_exports.string() }),
+    body: external_exports.object({ version: external_exports.string() }),
+    response: external_exports.object({ id: external_exports.string() }),
+    responses: { 400: agentApiErrorSchema },
+    summary: "Set the current version of a document"
+  },
+  createKey: {
+    method: "POST",
+    path: () => "/registry/keys",
+    body: external_exports.object({
+      name: external_exports.string().max(50).optional(),
+      description: external_exports.string().max(200).optional(),
+      documentUids: external_exports.string().array().min(1)
+    }),
+    response: agentKeySchema.extend({ signedKey: external_exports.string() }),
+    responses: { 400: agentApiErrorSchema, 403: agentApiErrorSchema },
+    summary: "Create an agent key"
+  },
+  listKeys: {
+    method: "GET",
+    path: (p) => `/registry/keys/${p.documentUid}`,
+    params: external_exports.object({ documentUid: external_exports.string() }),
+    response: agentKeySchema.array(),
+    responses: { 400: agentApiErrorSchema },
+    summary: "List the agent keys for a document"
+  },
+  updateKey: {
+    method: "PATCH",
+    path: (p) => `/registry/keys/${p.id}`,
+    params: external_exports.object({ id: external_exports.string() }),
+    body: external_exports.object({
+      name: external_exports.string().min(1).max(50),
+      description: external_exports.string().max(200)
+    }).partial(),
+    response: agentKeySchema,
+    responses: { 400: agentApiErrorSchema, 403: agentApiErrorSchema },
+    summary: "Update an agent key"
+  },
+  deleteKey: {
+    method: "DELETE",
+    path: (p) => `/registry/keys/${p.id}`,
+    params: external_exports.object({ id: external_exports.string() }),
+    response: external_exports.null(),
+    responses: { 400: agentApiErrorSchema, 403: agentApiErrorSchema },
+    summary: "Delete an agent key"
+  }
+};
+
+// ../../packages/entities/dist/api/agent/usage.js
+var usageRecordSchema = monthlyUsageSchema.extend({
+  name: external_exports.string().nullable(),
+  projectType: external_exports.string().nullable(),
+  documentUid: external_exports.string().nullable(),
+  /** microCredits converted to credits, for display. */
+  credits: external_exports.number()
+});
+var teamUsageResponseSchema = external_exports.object({
+  usage: usageRecordSchema.array(),
+  plan: billingPlanSchema,
+  includedCredits: external_exports.number(),
+  usedCredits: external_exports.number(),
+  overageCredits: external_exports.number()
+});
+var usageRoutes = {
+  getTeamUsage: {
+    method: "GET",
+    path: () => "/usage",
+    query: external_exports.object({ month: external_exports.string().date().optional() }),
+    response: teamUsageResponseSchema,
+    summary: "Get usage for the current team"
+  }
+};
+
+// ../../packages/entities/dist/api/agent/index.js
+var agentApi = {
+  mcp: {
+    ...mcpServerRoutes,
+    ...mcpVersionRoutes,
+    ...mcpInstallationRoutes
+  },
+  registry: registryRoutes,
+  docs: docsRoutes,
+  dashboard: dashboardRoutes,
+  editor: editorRoutes,
+  openapi: openapiRoutes,
+  analytics: analyticsRoutes,
+  usage: usageRoutes,
+  internal: internalRoutes,
+  pubsub: pubsubRoutes
+};
+
+export {
+  agentApiErrorSchema,
+  pubsubPushMessageSchema,
+  bumpKindSchema,
+  bumpStrategySchema,
+  semverParamSchema,
+  installationParamSchema,
+  analyticsRangeSchema,
+  analyticsGranularitySchema,
+  mcpConsumerKindSchema,
+  mcpToolKindSchema,
+  mcpToolCategorySchema,
+  mcpExportDatasetSchema,
+  mcpAnalyticsParamsSchema,
+  mcpTimeseriesPointSchema,
+  mcpCategoryTotalsSchema,
+  mcpOverviewTotalsSchema,
+  mcpOverviewResultSchema,
+  mcpToolStatSchema,
+  mcpToolsResultSchema,
+  mcpConsumerStatSchema,
+  mcpConsumersResultSchema,
+  mcpLatencyByToolEntrySchema,
+  mcpLatencyResultSchema,
+  mcpErrorEntrySchema,
+  mcpErrorsResultSchema,
+  analyticsRoutes,
+  DASHBOARD_EDITOR_TOOL_NAMES,
+  DASHBOARD_SDK_TOOL_NAMES,
+  DASHBOARD_SDK_CONTEXT_KEY,
+  DASHBOARD_EDITOR_CONTEXT_KEY,
+  DASHBOARD_CHAT_CONTEXT_MAX_CHARS,
+  DASHBOARD_CHAT_MAX_MESSAGES,
+  dashboardChatSettingsSchema,
+  dashboardChatBodySchema,
+  dashboardRoutes,
+  docsProjectAgentInfoSchema,
+  docsChatContextSchema,
+  docsRoutes,
+  editorChatBodySchema,
+  pullRequestDescriptionBodySchema,
+  editorRoutes,
+  internalRoutes,
+  installationToolSchema,
+  installationSummarySchema,
+  mcpInstallationRoutes,
+  mcpServerWithInstallationsSchema,
+  mcpOperationToolDetailSchema,
+  mcpDocsPageToolDetailSchema,
+  mcpServerRoutes,
+  mcpVersionToolsSchema,
+  mcpVersionRoutes,
+  openapiRoutes,
+  pubsubRoutes,
+  registryDocumentSchema,
+  registryVersionOperationSchema,
+  registrySearchResultSchema,
+  registryRoutes,
+  usageRecordSchema,
+  teamUsageResponseSchema,
+  usageRoutes,
+  agentApi
+};