@alpic-ai/api 0.0.0-staging.gd8ce559 → 0.0.0-staging.gdb7066f

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.
package/dist/index.mjs CHANGED
@@ -2,7 +2,7 @@ import { z } from "zod";
2
2
  import * as z$1 from "zod/v4";
3
3
  import { oc } from "@orpc/contract";
4
4
  import ms from "ms";
5
- //#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_supports-color@7.2.0_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/auth.js
5
+ //#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.30.0_supports-color@7.2.0_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/auth.js
6
6
  /**
7
7
  * Reusable URL validation that disallows javascript: scheme
8
8
  */
@@ -283,33 +283,18 @@ const deploymentSummarySchema = z.object({
283
283
  createdAt: z.coerce.date(),
284
284
  updatedAt: z.coerce.date()
285
285
  });
286
- /**
287
- * Public environment
288
- *
289
- * Answers anonymously and exposes no OAuth metadata.
290
- */
286
+ /** Public environment: answers anonymously and exposes no OAuth metadata. */
291
287
  const publicEnvironmentSchema = z.object({
292
288
  allowsAnonymous: z.literal(true),
293
289
  oAuthMetadata: z.strictObject({})
294
290
  });
295
- /**
296
- * Protected environment with an external resource metadata URL
297
- *
298
- * An external resource metadata URL is returned in the WWW-Authenticate header during the first 401 response.
299
- * Everything that follows is handled outside of the MCP server scope.
300
- */
291
+ /** Protected environment whose external resource metadata URL is returned in the WWW-Authenticate header on the first 401; everything after is handled outside the MCP server scope. */
301
292
  const externalResourceMetadataEnvironmentSchema = z.object({
302
293
  allowsAnonymous: z.boolean(),
303
294
  oAuthMetadata: z.object({ externalResourceMetadataUrl: z.url() }),
304
295
  scope: z.string().optional()
305
296
  });
306
- /**
307
- * Protected environment with an external authorization server URL
308
- *
309
- * The server itself exposes the /.well-known/oauth-protected-resource endpoint.
310
- * An external authorization server URL is returned when requesting the endpoint.
311
- * Everything that follows is handled outside of the MCP server scope.
312
- */
297
+ /** Protected environment whose own /.well-known/oauth-protected-resource endpoint points at an external authorization server; everything after is handled outside the MCP server scope. */
313
298
  const externalAuthorizationServerEnvironmentSchema = z.object({
314
299
  allowsAnonymous: z.boolean(),
315
300
  oAuthMetadata: z.object({
@@ -318,12 +303,7 @@ const externalAuthorizationServerEnvironmentSchema = z.object({
318
303
  }),
319
304
  scope: z.string().optional()
320
305
  });
321
- /**
322
- * Standalone protected environment
323
- *
324
- * The server itself exposes the /.well-known/oauth-protected-resource endpoint.
325
- * The server itself exposes the /.well-known/oauth-authorization-server endpoint.
326
- */
306
+ /** Standalone protected environment: the server itself exposes both the /.well-known/oauth-protected-resource and /.well-known/oauth-authorization-server endpoints. */
327
307
  const standaloneEnvironmentSchema = z.object({
328
308
  allowsAnonymous: z.boolean(),
329
309
  oAuthMetadata: z.object({
@@ -332,13 +312,7 @@ const standaloneEnvironmentSchema = z.object({
332
312
  }),
333
313
  scope: z.string().optional()
334
314
  });
335
- /**
336
- * Protected environment without OAuth discovery
337
- *
338
- * The server enforces authentication but exposes no OAuth discovery metadata.
339
- * Neither /.well-known/oauth-protected-resource nor /.well-known/oauth-authorization-server
340
- * are advertised. Clients must obtain credentials out-of-band.
341
- */
315
+ /** Protected environment that enforces authentication but advertises no OAuth discovery metadata; clients must obtain credentials out-of-band. */
342
316
  const protectedWithoutDiscoveryEnvironmentSchema = z.object({
343
317
  allowsAnonymous: z.literal(false),
344
318
  oAuthMetadata: z.strictObject({}),
@@ -433,7 +407,8 @@ z.object({
433
407
  createdAt: z.coerce.date(),
434
408
  environmentId: z.string(),
435
409
  content: z.string(),
436
- source: z.enum(["model", "user"])
410
+ source: z.enum(["model", "user"]),
411
+ clientName: z.string().nullable()
437
412
  });
438
413
  z.object({
439
414
  content: z.string(),
@@ -469,6 +444,7 @@ z.object({
469
444
  environmentId: z.string(),
470
445
  toolName: z.string(),
471
446
  message: z.string(),
447
+ clientName: z.string().nullable(),
472
448
  categories: z.array(intentCategorySchema)
473
449
  });
474
450
  const signalCategorySchema = z.object({
@@ -533,6 +509,246 @@ z.enum([
533
509
  "DEBUG",
534
510
  "ERROR"
535
511
  ]);
512
+ /** Only names a vendor actually ships belong here: lookalikes like `claude-code-test` are customers' own scripts. */
513
+ const MCP_CLIENT_GROUPS = [
514
+ {
515
+ id: "claude_code",
516
+ label: "Claude Code",
517
+ vendor: "anthropic",
518
+ rawNames: ["claude-code", "Anthropic/ClaudeCodeDesktop"]
519
+ },
520
+ {
521
+ id: "claude",
522
+ label: "Claude",
523
+ vendor: "anthropic",
524
+ rawNames: [
525
+ "Anthropic/ClaudeAI",
526
+ "claude-ai",
527
+ "claude",
528
+ "Claude",
529
+ "claude-desktop",
530
+ "claude-desktop-3p"
531
+ ]
532
+ },
533
+ {
534
+ id: "claude_mobile",
535
+ label: "Claude mobile",
536
+ vendor: "anthropic",
537
+ rawNames: ["claude-ios", "ClaudeAndroid"]
538
+ },
539
+ {
540
+ id: "claude_cowork",
541
+ label: "Claude Cowork",
542
+ vendor: "anthropic",
543
+ rawNames: ["Anthropic/Cowork"]
544
+ },
545
+ {
546
+ id: "claude_toolbox",
547
+ label: "Claude Toolbox",
548
+ vendor: "anthropic",
549
+ rawNames: ["Anthropic/Toolbox", "Anthropic/toolbox-bootstrap"]
550
+ },
551
+ {
552
+ id: "anthropic_api",
553
+ label: "Anthropic API",
554
+ vendor: "anthropic",
555
+ rawNames: ["Anthropic/API"]
556
+ },
557
+ {
558
+ id: "anthropic_connector_refresh",
559
+ label: "Anthropic (connector refresh)",
560
+ vendor: "anthropic",
561
+ rawNames: ["Anthropic"]
562
+ },
563
+ {
564
+ id: "codex",
565
+ label: "Codex",
566
+ vendor: "openai",
567
+ rawNames: [
568
+ "codex-mcp-client",
569
+ "codex",
570
+ "Codex",
571
+ "codex-cli",
572
+ "openai-mcp (Codex)"
573
+ ]
574
+ },
575
+ {
576
+ id: "chatgpt",
577
+ label: "ChatGPT",
578
+ vendor: "openai",
579
+ rawNames: ["openai-mcp (ChatGPT)"]
580
+ },
581
+ {
582
+ id: "openai_responses_api",
583
+ label: "OpenAI Responses API",
584
+ vendor: "openai",
585
+ rawNames: ["openai-mcp (Responses API)"]
586
+ },
587
+ {
588
+ id: "openai_agent_builder",
589
+ label: "OpenAI Agent Builder",
590
+ vendor: "openai",
591
+ rawNames: ["openai-mcp (Agent Builder)"]
592
+ },
593
+ {
594
+ id: "openai_other",
595
+ label: "OpenAI Other",
596
+ vendor: "openai",
597
+ rawNames: ["openai-mcp"]
598
+ },
599
+ {
600
+ id: "cursor",
601
+ label: "Cursor",
602
+ vendor: "cursor",
603
+ rawNames: [
604
+ "cursor-vscode",
605
+ "Cursor",
606
+ "cursor"
607
+ ]
608
+ },
609
+ {
610
+ id: "cline",
611
+ label: "Cline",
612
+ vendor: "cline",
613
+ rawNames: [
614
+ "Cline",
615
+ "cline",
616
+ "@cline/core"
617
+ ]
618
+ },
619
+ {
620
+ id: "github_copilot",
621
+ label: "GitHub Copilot",
622
+ vendor: "githubCopilot",
623
+ rawNames: [
624
+ "Copilot",
625
+ "github-copilot-developer",
626
+ "Copilot MCP Gateway",
627
+ "Xcode/copilot-xcode"
628
+ ]
629
+ },
630
+ {
631
+ id: "gemini_cli",
632
+ label: "Gemini CLI",
633
+ vendor: "google",
634
+ rawNames: ["gemini-cli-mcp-client", "gemini-cli"]
635
+ },
636
+ {
637
+ id: "antigravity",
638
+ label: "Antigravity",
639
+ vendor: "google",
640
+ rawNames: ["antigravity-client"]
641
+ },
642
+ {
643
+ id: "gemini",
644
+ label: "Gemini",
645
+ vendor: "google",
646
+ rawNames: ["Gemini", "google-ai-edge-gallery"]
647
+ },
648
+ {
649
+ id: "windsurf",
650
+ label: "Windsurf",
651
+ vendor: "windsurf",
652
+ rawNames: ["Windsurf", "windsurf-client"]
653
+ },
654
+ {
655
+ id: "mistral",
656
+ label: "Mistral / Le Chat",
657
+ vendor: "mistral",
658
+ rawNames: ["Mistral"],
659
+ rawNamePrefixes: ["connector:custom-mcp:"]
660
+ },
661
+ {
662
+ id: "n8n",
663
+ label: "n8n",
664
+ vendor: "n8n",
665
+ rawNames: [
666
+ "@n8n/n8n-nodes-langchain.mcpClient",
667
+ "@n8n/n8n-nodes-langchain.mcpClientTool",
668
+ "n8n"
669
+ ]
670
+ },
671
+ {
672
+ id: "alpic_playground",
673
+ label: "Alpic Playground",
674
+ vendor: "alpic",
675
+ rawNames: ["alpic-playground", "playground"]
676
+ },
677
+ {
678
+ id: "opencode",
679
+ label: "opencode",
680
+ vendor: "opencode",
681
+ rawNames: ["opencode"]
682
+ },
683
+ {
684
+ id: "zed",
685
+ label: "Zed",
686
+ vendor: "zed",
687
+ rawNames: ["Zed", "zed"]
688
+ },
689
+ {
690
+ id: "zapier",
691
+ label: "Zapier",
692
+ vendor: "zapier",
693
+ rawNames: ["Zapier", "zapier"]
694
+ },
695
+ {
696
+ id: "make",
697
+ label: "Make",
698
+ vendor: "make",
699
+ rawNames: ["Make", "make"]
700
+ },
701
+ {
702
+ id: "librechat",
703
+ label: "LibreChat",
704
+ vendor: "mcp",
705
+ rawNames: ["LibreChat", "librechat"]
706
+ },
707
+ {
708
+ id: "jan",
709
+ label: "Jan",
710
+ vendor: "mcp",
711
+ rawNames: ["Jan", "jan"]
712
+ },
713
+ {
714
+ id: "goose",
715
+ label: "goose",
716
+ vendor: "mcp",
717
+ rawNames: ["goose", "Goose"]
718
+ },
719
+ {
720
+ id: "mcphost",
721
+ label: "mcphost",
722
+ vendor: "mcp",
723
+ rawNames: ["mcphost"]
724
+ },
725
+ {
726
+ id: "mcporter",
727
+ label: "mcporter",
728
+ vendor: "mcp",
729
+ rawNames: ["mcporter"]
730
+ },
731
+ {
732
+ id: "rmcp",
733
+ label: "rmcp",
734
+ vendor: "mcp",
735
+ rawNames: ["rmcp"]
736
+ },
737
+ {
738
+ id: "unnamed_client",
739
+ label: "Unnamed client",
740
+ vendor: "mcp",
741
+ rawNames: [
742
+ "mcp",
743
+ "unknown",
744
+ ""
745
+ ]
746
+ }
747
+ ];
748
+ /** A source pattern, not a RegExp, because analytics renders the same rule into ClickHouse RE2, which shares this syntax. */
749
+ const MCP_REMOTE_WRAPPER_SUFFIX = String.raw` \(via mcp-remote [^\n]+?\)$`;
750
+ new RegExp(MCP_REMOTE_WRAPPER_SUFFIX);
751
+ new Map(MCP_CLIENT_GROUPS.map((group) => [group.id, group]));
536
752
  const runtimeSchema = z.enum([
537
753
  "python3.13",
538
754
  "python3.14",
@@ -610,15 +826,7 @@ z.object({
610
826
  serverFields: serverFieldsSchema$1,
611
827
  source: z.enum(["registry", "defaults"])
612
828
  });
613
- /**
614
- * Returns a variant of a `maxLength`-constrained string that clamps (truncates) instead of
615
- * rejecting on overflow — used for AI-generated copy where the model routinely overshoots.
616
- *
617
- * NOTE: this rebuilds the schema from scratch, carrying over only `maxLength` (as a clamp),
618
- * `minLength`, and the description. Any other validators on the source field (`.regex()`,
619
- * `.email()`, custom refinements) are intentionally dropped — this helper is meant for plain
620
- * free-text length caps only. A field with `null` `maxLength` is returned unchanged.
621
- */
829
+ /** Clamps instead of rejecting on max-length overflow (for AI-generated copy that overshoots); intentionally carries over only maxLength, minLength, and description, dropping any other validators. */
622
830
  const clampStringField = (field) => {
623
831
  const max = field.maxLength;
624
832
  if (max === null) return field;
@@ -964,11 +1172,7 @@ const chatgptToolJustificationSchema = z.object({
964
1172
  openWorldJustification: z.string().describe("One sentence on whether the tool reaches external systems beyond your own service."),
965
1173
  destructiveJustification: z.string().describe("One sentence on whether the tool changes data. For a read-only tool, state the full triad: \"No data is created, modified, or deleted.\"")
966
1174
  }).describe("Per-tool justification of each MCP annotation value (one specific sentence per hint).");
967
- /**
968
- * Base copy fields, defined once and reused by both the submission form and per-locale
969
- * translations so the constraints (tagline ≤ 30 chars) never drift. The translation generation
970
- * path wraps these in {@link clampStringField} since the LLM tends to overshoot the limit.
971
- */
1175
+ /** Defined once and reused by both the submission form and per-locale translations so the tagline ≤ 30 chars constraint never drifts. */
972
1176
  const chatgptTaglineSchema = z.string().max(30);
973
1177
  const chatgptDescriptionSchema = z.string();
974
1178
  const chatgptTranslationSchema = z.object({
@@ -977,10 +1181,7 @@ const chatgptTranslationSchema = z.object({
977
1181
  description: chatgptDescriptionSchema
978
1182
  }).describe("Locale-scoped override for tagline + description. English (US) is the default.");
979
1183
  chatgptTranslationSchema.extend({ tagline: clampStringField(chatgptTaglineSchema) });
980
- /**
981
- * Field order mirrors the ChatGPT (OpenAI) submission spreadsheet, grouped by section.
982
- * When adding/removing/reordering fields, keep this in sync with the sheet.
983
- */
1184
+ /** Field order mirrors the ChatGPT (OpenAI) submission spreadsheet, grouped by section; keep it in sync with the sheet. */
984
1185
  const chatgptSubmissionFormDataSchema = z.object({
985
1186
  logoLight: z.string().describe("Logo icon for light mode. Square PNG, no borders or rounded corners (clients apply circular cropping)."),
986
1187
  logoDark: z.string().optional().describe("Optional dark-mode logo icon. Square PNG, same specs as the light icon. Leave empty if the light icon also works on dark backgrounds."),
@@ -1077,11 +1278,7 @@ const claudePolicyAcknowledgementSchema = z.enum([
1077
1278
  "My connector does not collect conversation data beyond what is needed for its function.",
1078
1279
  "Public documentation for this connector will be live by the publish date."
1079
1280
  ]);
1080
- /**
1081
- * Field order mirrors the claude.ai directory submission wizard
1082
- * (`claude.ai/admin-settings/directory/submissions/new`), grouped by step.
1083
- * When adding/removing/reordering fields, keep this in sync with the wizard.
1084
- */
1281
+ /** Field order mirrors the claude.ai directory submission wizard (`claude.ai/admin-settings/directory/submissions/new`), grouped by step; keep it in sync with the wizard. */
1085
1282
  const claudeSubmissionFormDataSchema = z.object({
1086
1283
  serverUrl: z.url().describe(`The full https:// URL where your MCP server is hosted and reachable. In the claude.ai wizard this is read live
1087
1284
  from the custom connector you select — the connection is used to verify the URL and the tool list at submission time.
@@ -1173,12 +1370,7 @@ claudeSubmissionFormDataSchema.pick({
1173
1370
  connectionRequirements: claudeSubmissionFormDataSchema.shape.connectionRequirements.optional(),
1174
1371
  testInstructions: claudeSubmissionFormDataSchema.shape.testInstructions.optional()
1175
1372
  });
1176
- /**
1177
- * Narrative fields the LLM-backed generation step produces for Claude submissions.
1178
- * This schema accepts the slightly loose shape returned by AI generation, then normalizes it into
1179
- * the strict form shape. Keep transforms here rather than in callers so generation leniency is
1180
- * colocated with the Claude contract.
1181
- */
1373
+ /** Loose shape returned by AI generation for Claude narrative fields; transforms live here so generation leniency stays colocated with the Claude contract. */
1182
1374
  const claudeAiGeneratedFormDataRawSchema = z.object({
1183
1375
  oneLiner: claudeSubmissionFormDataSchema.shape.oneLiner,
1184
1376
  description: claudeSubmissionFormDataSchema.shape.description,
@@ -1358,17 +1550,15 @@ const isValidLogTimeInput = (value) => {
1358
1550
  if (ms(value) !== void 0) return true;
1359
1551
  return !Number.isNaN(new Date(value).getTime());
1360
1552
  };
1361
- const createEnvironmentContractV1 = oc.route({
1553
+ const base = oc.errors({ BAD_REQUEST: {} });
1554
+ const createEnvironmentContractV1 = base.route({
1362
1555
  path: "/v1/environments",
1363
1556
  method: "POST",
1364
1557
  summary: "Create an environment",
1365
1558
  description: "Create an environment for a project",
1366
1559
  tags: ["environments"],
1367
1560
  successDescription: "The environment has been created successfully"
1368
- }).errors({
1369
- NOT_FOUND: {},
1370
- BAD_REQUEST: {}
1371
- }).input(z.object({
1561
+ }).errors({ NOT_FOUND: {} }).input(z.object({
1372
1562
  projectId: z.string().describe("The ID of the project to create the environment for"),
1373
1563
  name: z.string().min(1).describe("The name of the environment"),
1374
1564
  sourceBranch: z.string().min(1).describe("The branch used to build the environment"),
@@ -1381,7 +1571,7 @@ const createEnvironmentContractV1 = oc.route({
1381
1571
  createdAt: z.coerce.date(),
1382
1572
  projectId: z.string().describe("The ID of the project the environment belongs to")
1383
1573
  }));
1384
- const getEnvironmentContractV1 = oc.route({
1574
+ const getEnvironmentContractV1 = base.route({
1385
1575
  path: "/v1/environments/{environmentId}",
1386
1576
  method: "GET",
1387
1577
  summary: "Get an environment",
@@ -1438,7 +1628,7 @@ const projectOutputSchema = z.object({
1438
1628
  productionEnvironment: productionEnvironmentSchema.nullable(),
1439
1629
  environments: z.array(environmentSchema)
1440
1630
  });
1441
- const getProjectContractV1 = oc.route({
1631
+ const getProjectContractV1 = base.route({
1442
1632
  path: "/v1/projects/{projectId}",
1443
1633
  method: "GET",
1444
1634
  summary: "Get a project",
@@ -1446,18 +1636,15 @@ const getProjectContractV1 = oc.route({
1446
1636
  tags: ["projects"],
1447
1637
  successDescription: "The project details"
1448
1638
  }).errors({ NOT_FOUND: {} }).input(z.object({ projectId: z.string().describe("The ID of the project") })).output(projectOutputSchema);
1449
- const listProjectsContractV1 = oc.route({
1639
+ const listProjectsContractV1 = base.route({
1450
1640
  path: "/v1/projects",
1451
1641
  method: "GET",
1452
1642
  summary: "List projects",
1453
1643
  description: "List all projects for a team",
1454
1644
  tags: ["projects"],
1455
1645
  successDescription: "The list of projects"
1456
- }).errors({
1457
- NOT_FOUND: {},
1458
- BAD_REQUEST: {}
1459
- }).input(z.object({ teamId: z.string().optional() }).optional()).output(z.array(projectOutputSchema));
1460
- const createProjectContractV1 = oc.route({
1646
+ }).errors({ NOT_FOUND: {} }).input(z.object({ teamId: z.string().optional() }).optional()).output(z.array(projectOutputSchema));
1647
+ const createProjectContractV1 = base.route({
1461
1648
  path: "/v1/projects",
1462
1649
  method: "POST",
1463
1650
  summary: "Create a project",
@@ -1466,7 +1653,6 @@ const createProjectContractV1 = oc.route({
1466
1653
  successDescription: "The project has been created successfully"
1467
1654
  }).errors({
1468
1655
  NOT_FOUND: {},
1469
- BAD_REQUEST: {},
1470
1656
  FORBIDDEN: {}
1471
1657
  }).input(z.object({
1472
1658
  teamId: z.string().optional(),
@@ -1507,7 +1693,7 @@ const environmentVariableOutputSchema = z.object({
1507
1693
  isSecret: z.boolean(),
1508
1694
  createdAt: z.coerce.date()
1509
1695
  });
1510
- const listEnvironmentVariablesContractV1 = oc.route({
1696
+ const listEnvironmentVariablesContractV1 = base.route({
1511
1697
  path: "/v1/environments/{environmentId}/environment-variables",
1512
1698
  method: "GET",
1513
1699
  summary: "List environment variables",
@@ -1515,48 +1701,39 @@ const listEnvironmentVariablesContractV1 = oc.route({
1515
1701
  tags: ["environments"],
1516
1702
  successDescription: "The list of environment variables"
1517
1703
  }).errors({ NOT_FOUND: {} }).input(z.object({ environmentId: z.string().describe("The ID of the environment") })).output(z.array(environmentVariableOutputSchema));
1518
- const createEnvironmentVariablesContractV1 = oc.route({
1704
+ const createEnvironmentVariablesContractV1 = base.route({
1519
1705
  path: "/v1/environments/{environmentId}/environment-variables",
1520
1706
  method: "POST",
1521
1707
  summary: "Add environment variables",
1522
1708
  description: "Add one or more environment variables to an environment",
1523
1709
  tags: ["environments"],
1524
1710
  successDescription: "The environment variables have been added successfully"
1525
- }).errors({
1526
- NOT_FOUND: {},
1527
- BAD_REQUEST: {}
1528
- }).input(z.object({
1711
+ }).errors({ NOT_FOUND: {} }).input(z.object({
1529
1712
  environmentId: z.string().describe("The ID of the environment"),
1530
1713
  environmentVariables: environmentVariablesSchema
1531
1714
  })).output(z.object({ success: z.literal(true) }));
1532
- const updateEnvironmentVariableContractV1 = oc.route({
1715
+ const updateEnvironmentVariableContractV1 = base.route({
1533
1716
  path: "/v1/environment-variables/{environmentVariableId}",
1534
1717
  method: "PATCH",
1535
1718
  summary: "Update an environment variable",
1536
1719
  description: "Update an environment variable by ID",
1537
1720
  tags: ["environments"],
1538
1721
  successDescription: "The environment variable has been updated successfully"
1539
- }).errors({
1540
- NOT_FOUND: {},
1541
- BAD_REQUEST: {}
1542
- }).input(z.object({
1722
+ }).errors({ NOT_FOUND: {} }).input(z.object({
1543
1723
  environmentVariableId: z.string().describe("The ID of the environment variable"),
1544
1724
  key: environmentVariableSchema.shape.key,
1545
1725
  value: environmentVariableSchema.shape.value.optional(),
1546
1726
  isSecret: environmentVariableSchema.shape.isSecret.optional()
1547
1727
  })).output(z.object({ success: z.literal(true) }));
1548
- const deleteEnvironmentVariableContractV1 = oc.route({
1728
+ const deleteEnvironmentVariableContractV1 = base.route({
1549
1729
  path: "/v1/environment-variables/{environmentVariableId}",
1550
1730
  method: "DELETE",
1551
1731
  summary: "Delete an environment variable",
1552
1732
  description: "Delete an environment variable by ID",
1553
1733
  tags: ["environments"],
1554
1734
  successDescription: "The environment variable has been deleted successfully"
1555
- }).errors({
1556
- NOT_FOUND: {},
1557
- BAD_REQUEST: {}
1558
- }).input(z.object({ environmentVariableId: z.string().describe("The ID of the environment variable") })).output(z.object({ success: z.literal(true) }));
1559
- const deleteProjectContractV1 = oc.route({
1735
+ }).errors({ NOT_FOUND: {} }).input(z.object({ environmentVariableId: z.string().describe("The ID of the environment variable") })).output(z.object({ success: z.literal(true) }));
1736
+ const deleteProjectContractV1 = base.route({
1560
1737
  path: "/v1/projects/{projectId}",
1561
1738
  method: "DELETE",
1562
1739
  summary: "Delete a project",
@@ -1564,7 +1741,7 @@ const deleteProjectContractV1 = oc.route({
1564
1741
  tags: ["projects"],
1565
1742
  successDescription: "The project has been deleted successfully"
1566
1743
  }).errors({ NOT_FOUND: {} }).input(z.object({ projectId: z.string().describe("The ID of the project") })).output(z.object({ success: z.literal(true) }));
1567
- const updateProjectContractV1 = oc.route({
1744
+ const updateProjectContractV1 = base.route({
1568
1745
  path: "/v1/projects/{projectId}",
1569
1746
  method: "PATCH",
1570
1747
  summary: "Update a project",
@@ -1573,14 +1750,13 @@ const updateProjectContractV1 = oc.route({
1573
1750
  successDescription: "The project has been updated successfully"
1574
1751
  }).errors({
1575
1752
  NOT_FOUND: {},
1576
- BAD_REQUEST: {},
1577
1753
  FORBIDDEN: {}
1578
1754
  }).input(z.object({
1579
1755
  projectId: z.string().describe("The ID of the project"),
1580
1756
  name: z.string().min(1).max(100).optional().describe("The new name for the project"),
1581
1757
  sourceRepository: z.string().nullable().optional().describe("The source repository to connect to the project")
1582
1758
  })).output(projectOutputSchema);
1583
- const deployEnvironmentContractV1 = oc.route({
1759
+ const deployEnvironmentContractV1 = base.route({
1584
1760
  path: "/v1/environments/{environmentId}/deploy",
1585
1761
  method: "POST",
1586
1762
  summary: "Deploy an environment",
@@ -1589,29 +1765,25 @@ const deployEnvironmentContractV1 = oc.route({
1589
1765
  successDescription: "The environment has been deployed successfully"
1590
1766
  }).errors({
1591
1767
  NOT_FOUND: {},
1592
- BAD_REQUEST: {},
1593
1768
  CONFLICT: {}
1594
1769
  }).input(z.object({
1595
1770
  environmentId: z.string().describe("The ID of the environment to deploy"),
1596
1771
  token: z.string().describe("The token to identify the source archive").optional(),
1597
1772
  settings: buildSettingsSchema.extend({ transport: transportSchema }).optional().describe("Project settings detected by the client from the source. When provided, the server skips downloading and extracting the source archive to detect them.")
1598
1773
  })).output(deploymentSchema);
1599
- const uploadDeploymentArtifactContractV1 = oc.route({
1774
+ const uploadDeploymentArtifactContractV1 = base.route({
1600
1775
  path: "/v1/deployments/upload",
1601
1776
  method: "POST",
1602
1777
  summary: "Upload deployment artifacts",
1603
1778
  description: "Return a presigned S3 URL to upload a deployment artifact",
1604
1779
  tags: ["deployments"],
1605
1780
  successDescription: "The presigned upload URL has been generated successfully"
1606
- }).errors({
1607
- NOT_FOUND: {},
1608
- BAD_REQUEST: {}
1609
- }).input(z.object({ teamId: z.string().optional() }).optional()).output(z.object({
1781
+ }).errors({ NOT_FOUND: {} }).input(z.object({ teamId: z.string().optional() }).optional()).output(z.object({
1610
1782
  uploadUrl: z.url().describe("Presigned S3 URL to upload the source archive with HTTP PUT"),
1611
1783
  token: z.string().describe("Token to identify the source archive"),
1612
1784
  expiresAt: z.coerce.date().describe("Expiration date of the presigned URL")
1613
1785
  }));
1614
- const listDeploymentsContractV1 = oc.route({
1786
+ const listDeploymentsContractV1 = base.route({
1615
1787
  path: "/v1/projects/{projectId}/deployments",
1616
1788
  method: "GET",
1617
1789
  summary: "List project deployments",
@@ -1623,7 +1795,7 @@ const listDeploymentsContractV1 = oc.route({
1623
1795
  status: z.array(deploymentStatusSchema).optional().describe("Filter by one or more statuses"),
1624
1796
  environmentId: z.string().optional().describe("Filter by environment ID")
1625
1797
  })).output(z.array(deploymentSchema));
1626
- const getDeploymentContractV1 = oc.route({
1798
+ const getDeploymentContractV1 = base.route({
1627
1799
  path: "/v1/deployments/{deploymentId}",
1628
1800
  method: "GET",
1629
1801
  summary: "Get a deployment",
@@ -1646,17 +1818,14 @@ const logEntrySchema = z.object({
1646
1818
  method: z.string().optional(),
1647
1819
  durationInMs: z.number().optional()
1648
1820
  });
1649
- const getLogsContractV1 = oc.route({
1821
+ const getLogsContractV1 = base.route({
1650
1822
  path: "/v1/environments/{environmentId}/logs",
1651
1823
  method: "GET",
1652
1824
  summary: "Get logs",
1653
1825
  description: "Get logs for an environment",
1654
1826
  tags: ["environments"],
1655
1827
  successDescription: "The logs"
1656
- }).errors({
1657
- NOT_FOUND: {},
1658
- BAD_REQUEST: {}
1659
- }).input(z.object({
1828
+ }).errors({ NOT_FOUND: {} }).input(z.object({
1660
1829
  environmentId: z.string().describe("The ID of the environment"),
1661
1830
  since: z.string().refine(isValidLogTimeInput, { message: "Invalid time. Use relative (1h, 30m, 2d) or ISO 8601 format." }).optional().describe("Start time — ISO 8601 (2024-01-01T00:00:00Z) or relative (1h, 30m, 2d)"),
1662
1831
  until: z.string().refine(isValidLogTimeInput, { message: "Invalid time. Use relative (1h, 30m, 2d) or ISO 8601 format." }).optional().describe("End time — ISO 8601 or relative"),
@@ -1673,17 +1842,14 @@ const getLogsContractV1 = oc.route({
1673
1842
  logs: z.array(logEntrySchema),
1674
1843
  nextToken: z.string().nullable()
1675
1844
  }));
1676
- const getLatestLogsContractV1 = oc.route({
1845
+ const getLatestLogsContractV1 = base.route({
1677
1846
  path: "/v1/environments/{environmentId}/latest-logs",
1678
1847
  method: "GET",
1679
1848
  summary: "Get latest logs",
1680
1849
  description: "Get the N most recent logs for an environment",
1681
1850
  tags: ["environments"],
1682
1851
  successDescription: "The latest logs"
1683
- }).errors({
1684
- NOT_FOUND: {},
1685
- BAD_REQUEST: {}
1686
- }).input(z.object({
1852
+ }).errors({ NOT_FOUND: {} }).input(z.object({
1687
1853
  environmentId: z.string().describe("The ID of the environment"),
1688
1854
  limit: z.coerce.number().int().min(1).max(1e3).default(100).describe("Number of most recent log entries to return"),
1689
1855
  level: z.array(z.enum([
@@ -1694,7 +1860,7 @@ const getLatestLogsContractV1 = oc.route({
1694
1860
  ])).optional().describe("Filter by log level"),
1695
1861
  search: z.string().optional().describe("Filter pattern to search for in log content")
1696
1862
  })).output(z.object({ logs: z.array(logEntrySchema) }));
1697
- const getDeploymentLogsContractV1 = oc.route({
1863
+ const getDeploymentLogsContractV1 = base.route({
1698
1864
  path: "/v1/deployments/{deploymentId}/logs",
1699
1865
  method: "GET",
1700
1866
  summary: "Get deployment logs",
@@ -1721,17 +1887,14 @@ const analyticsTimeSeriesSchema = z.object({
1721
1887
  output_token_mean: z.array(analyticsDataPointSchema),
1722
1888
  task_count: z.array(analyticsDataPointSchema)
1723
1889
  });
1724
- const getProjectAnalyticsContractV1 = oc.route({
1890
+ const getProjectAnalyticsContractV1 = base.route({
1725
1891
  path: "/v1/analytics/{projectId}",
1726
1892
  method: "GET",
1727
1893
  summary: "Get project analytics",
1728
1894
  description: "Get analytics data for a project over a time range",
1729
1895
  tags: ["analytics"],
1730
1896
  successDescription: "The project analytics data"
1731
- }).errors({
1732
- NOT_FOUND: {},
1733
- BAD_REQUEST: {}
1734
- }).input(z.object({
1897
+ }).errors({ NOT_FOUND: {} }).input(z.object({
1735
1898
  projectId: z.string().describe("The ID of the project"),
1736
1899
  startTimestamp: z.coerce.number().describe("Start timestamp in milliseconds"),
1737
1900
  endTimestamp: z.coerce.number().describe("End timestamp in milliseconds"),
@@ -1746,7 +1909,7 @@ const getProjectAnalyticsContractV1 = oc.route({
1746
1909
  }),
1747
1910
  timeSeries: analyticsTimeSeriesSchema
1748
1911
  }));
1749
- const listTeamsContractV1 = oc.route({
1912
+ const listTeamsContractV1 = base.route({
1750
1913
  path: "/v1/teams",
1751
1914
  method: "GET",
1752
1915
  summary: "List teams",
@@ -1759,7 +1922,7 @@ const listTeamsContractV1 = oc.route({
1759
1922
  createdAt: z.coerce.date(),
1760
1923
  hasStripeAccount: z.boolean()
1761
1924
  })));
1762
- const getTunnelTicketContractV1 = oc.route({
1925
+ const getTunnelTicketContractV1 = base.route({
1763
1926
  path: "/v1/tunnels/ticket",
1764
1927
  method: "GET",
1765
1928
  summary: "Get a tunnel ticket",
@@ -1771,16 +1934,13 @@ const getTunnelTicketContractV1 = oc.route({
1771
1934
  ticket: z.string().describe("The signed tunnel ticket"),
1772
1935
  tunnelHost: z.string().describe("The tunnel host to connect to")
1773
1936
  }));
1774
- const publishServerContractV1 = oc.route({
1937
+ const publishServerContractV1 = base.route({
1775
1938
  path: "/v1/distribution/publish",
1776
1939
  method: "POST",
1777
1940
  summary: "Publish a server to the MCP registry",
1778
1941
  tags: ["distribution"],
1779
1942
  successDescription: "The server has been published successfully"
1780
- }).errors({
1781
- NOT_FOUND: {},
1782
- BAD_REQUEST: {}
1783
- }).input(z.object({
1943
+ }).errors({ NOT_FOUND: {} }).input(z.object({
1784
1944
  projectId: z.string(),
1785
1945
  domain: z.string(),
1786
1946
  title: z.string().min(1).max(100),
@@ -1789,17 +1949,14 @@ const publishServerContractV1 = oc.route({
1789
1949
  iconSrc: z.url().max(255).optional(),
1790
1950
  dryRun: z.boolean().optional()
1791
1951
  })).output(z.object({ serverFields: serverFieldsSchema }));
1792
- const getServerInfoContractV1 = oc.route({
1952
+ const getServerInfoContractV1 = base.route({
1793
1953
  path: "/v1/distribution/get",
1794
1954
  method: "GET",
1795
1955
  summary: "Get server info",
1796
1956
  description: "Get info about a server",
1797
1957
  tags: ["distribution"],
1798
1958
  successDescription: "The server info"
1799
- }).errors({
1800
- NOT_FOUND: {},
1801
- BAD_REQUEST: {}
1802
- }).input(z.object({
1959
+ }).errors({ NOT_FOUND: {} }).input(z.object({
1803
1960
  projectId: z.string(),
1804
1961
  domain: z.string()
1805
1962
  })).output(z.object({ serverFields: serverFieldsSchema }));
@@ -1818,7 +1975,7 @@ const playgroundOutputSchema = z.object({
1818
1975
  isPlaygroundEnabled: z.boolean(),
1819
1976
  serverMetadata: playgroundServerMetadataOutputSchema.nullable()
1820
1977
  });
1821
- const getPlaygroundContractV1 = oc.route({
1978
+ const getPlaygroundContractV1 = base.route({
1822
1979
  path: "/v1/environments/{environmentId}/playground",
1823
1980
  method: "GET",
1824
1981
  summary: "Get playground configuration",
@@ -1826,17 +1983,14 @@ const getPlaygroundContractV1 = oc.route({
1826
1983
  tags: ["environments"],
1827
1984
  successDescription: "The playground configuration"
1828
1985
  }).errors({ NOT_FOUND: {} }).input(z.object({ environmentId: z.string().describe("The ID of the environment") })).output(playgroundOutputSchema);
1829
- const upsertPlaygroundContractV1 = oc.route({
1986
+ const upsertPlaygroundContractV1 = base.route({
1830
1987
  path: "/v1/environments/{environmentId}/playground",
1831
1988
  method: "PUT",
1832
1989
  summary: "Update playground configuration",
1833
1990
  description: "Update the playground configuration for an environment. All fields are optional — only provided fields are updated.",
1834
1991
  tags: ["environments"],
1835
1992
  successDescription: "The updated playground configuration"
1836
- }).errors({
1837
- NOT_FOUND: {},
1838
- BAD_REQUEST: {}
1839
- }).input(z.object({
1993
+ }).errors({ NOT_FOUND: {} }).input(z.object({
1840
1994
  environmentId: z.string().describe("The ID of the environment"),
1841
1995
  isPlaygroundEnabled: z.boolean().optional(),
1842
1996
  name: z.string().min(1).max(100).optional(),
@@ -1844,7 +1998,7 @@ const upsertPlaygroundContractV1 = oc.route({
1844
1998
  headers: z.array(playgroundHeaderSchema).optional(),
1845
1999
  examplePrompts: z.array(playgroundExamplePromptSchema).max(5).optional()
1846
2000
  })).output(playgroundOutputSchema);
1847
- const createBeaconContractV1 = oc.route({
2001
+ const createBeaconContractV1 = base.route({
1848
2002
  path: "/v1/beacon/audits",
1849
2003
  method: "POST",
1850
2004
  summary: "Create a beacon audit",
@@ -1853,7 +2007,6 @@ const createBeaconContractV1 = oc.route({
1853
2007
  successDescription: "The audit has been created"
1854
2008
  }).errors({
1855
2009
  NOT_FOUND: {},
1856
- BAD_REQUEST: {},
1857
2010
  DNS_RESOLUTION_FAILED: { status: 400 }
1858
2011
  }).input(z.object({
1859
2012
  targetUrl: z.url().describe("The HTTPS URL of the MCP server to audit"),
@@ -1861,7 +2014,7 @@ const createBeaconContractV1 = oc.route({
1861
2014
  projectId: z.string().optional().describe("The project ID to associate the audit with"),
1862
2015
  excludeCategories: z.array(checkCategorySchema).optional().describe("Check categories to exclude from the audit")
1863
2016
  })).output(z.object({ id: z.string() }));
1864
- const getBeaconContractV1 = oc.route({
2017
+ const getBeaconContractV1 = base.route({
1865
2018
  path: "/v1/beacon/audits/{auditId}",
1866
2019
  method: "GET",
1867
2020
  summary: "Get a beacon audit",