@alpic-ai/api 0.0.0-staging.gee456e9 → 0.0.0-staging.gef9d36e

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/dist/index.d.mts +1522 -58
  2. package/dist/index.mjs +541 -152
  3. package/package.json +6 -6
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_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
  */
@@ -179,6 +179,7 @@ const PLATFORM_LABELS = {
179
179
  };
180
180
  const WAF_PLATFORMS = [
181
181
  "akamai",
182
+ "cato",
182
183
  "cloudflare",
183
184
  "fastly"
184
185
  ];
@@ -256,6 +257,25 @@ z.object({
256
257
  clientSecret: z.string(),
257
258
  clientScopes: z.array(z.string())
258
259
  });
260
+ const creditEntryReasonSchema = z.enum([
261
+ "free_seed",
262
+ "paid_conversion_floor",
263
+ "top_up",
264
+ "usage",
265
+ "admin_adjustment"
266
+ ]);
267
+ z.enum(["playground"]);
268
+ z.number().int().min(500);
269
+ const creditActivityEntrySchema = z.object({
270
+ reason: creditEntryReasonSchema,
271
+ day: z.number(),
272
+ amountInNanoUSD: z.number(),
273
+ messageCount: z.number().nullable()
274
+ });
275
+ z.object({
276
+ balanceInNanoUSD: z.number(),
277
+ recentActivity: z.array(creditActivityEntrySchema)
278
+ });
259
279
  const deploymentStatusSchema$1 = z.enum([
260
280
  "ongoing",
261
281
  "deployed",
@@ -283,33 +303,18 @@ const deploymentSummarySchema = z.object({
283
303
  createdAt: z.coerce.date(),
284
304
  updatedAt: z.coerce.date()
285
305
  });
286
- /**
287
- * Public environment
288
- *
289
- * Answers anonymously and exposes no OAuth metadata.
290
- */
306
+ /** Public environment: answers anonymously and exposes no OAuth metadata. */
291
307
  const publicEnvironmentSchema = z.object({
292
308
  allowsAnonymous: z.literal(true),
293
309
  oAuthMetadata: z.strictObject({})
294
310
  });
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
- */
311
+ /** 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
312
  const externalResourceMetadataEnvironmentSchema = z.object({
302
313
  allowsAnonymous: z.boolean(),
303
314
  oAuthMetadata: z.object({ externalResourceMetadataUrl: z.url() }),
304
315
  scope: z.string().optional()
305
316
  });
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
- */
317
+ /** 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
318
  const externalAuthorizationServerEnvironmentSchema = z.object({
314
319
  allowsAnonymous: z.boolean(),
315
320
  oAuthMetadata: z.object({
@@ -318,12 +323,7 @@ const externalAuthorizationServerEnvironmentSchema = z.object({
318
323
  }),
319
324
  scope: z.string().optional()
320
325
  });
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
- */
326
+ /** Standalone protected environment: the server itself exposes both the /.well-known/oauth-protected-resource and /.well-known/oauth-authorization-server endpoints. */
327
327
  const standaloneEnvironmentSchema = z.object({
328
328
  allowsAnonymous: z.boolean(),
329
329
  oAuthMetadata: z.object({
@@ -332,13 +332,7 @@ const standaloneEnvironmentSchema = z.object({
332
332
  }),
333
333
  scope: z.string().optional()
334
334
  });
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
- */
335
+ /** Protected environment that enforces authentication but advertises no OAuth discovery metadata; clients must obtain credentials out-of-band. */
342
336
  const protectedWithoutDiscoveryEnvironmentSchema = z.object({
343
337
  allowsAnonymous: z.literal(false),
344
338
  oAuthMetadata: z.strictObject({}),
@@ -425,14 +419,16 @@ z.object({
425
419
  collectRequestPayload: z.boolean(),
426
420
  collectResponsePayload: z.boolean(),
427
421
  collectErrorMessage: z.boolean(),
428
- collectUserData: z.boolean()
422
+ collectUserData: z.boolean(),
423
+ identityTraitKey: z.string().min(1).max(200).nullable()
429
424
  });
430
- z.object({
425
+ const feedbackSchema = z.object({
431
426
  id: z.string(),
432
427
  createdAt: z.coerce.date(),
433
428
  environmentId: z.string(),
434
429
  content: z.string(),
435
- source: z.enum(["model", "user"])
430
+ source: z.enum(["model", "user"]),
431
+ clientName: z.string().nullable()
436
432
  });
437
433
  z.object({
438
434
  content: z.string(),
@@ -448,7 +444,7 @@ const intentCategoryColorSchema = z.enum([
448
444
  "pink",
449
445
  "gray"
450
446
  ]);
451
- intentCategoryColorSchema.options;
447
+ const INTENT_CATEGORY_COLORS = intentCategoryColorSchema.options;
452
448
  const intentCategorySchema = z.object({
453
449
  id: z.string(),
454
450
  createdAt: z.coerce.date(),
@@ -456,7 +452,7 @@ const intentCategorySchema = z.object({
456
452
  name: z.string(),
457
453
  color: intentCategoryColorSchema
458
454
  });
459
- z.object({
455
+ const intentCategorySummarySchema = z.object({
460
456
  id: z.string(),
461
457
  name: z.string(),
462
458
  color: intentCategoryColorSchema,
@@ -468,6 +464,7 @@ z.object({
468
464
  environmentId: z.string(),
469
465
  toolName: z.string(),
470
466
  message: z.string(),
467
+ clientName: z.string().nullable(),
471
468
  categories: z.array(intentCategorySchema)
472
469
  });
473
470
  const signalCategorySchema = z.object({
@@ -526,12 +523,262 @@ z.object({
526
523
  createdAt: z.coerce.date(),
527
524
  updatedAt: z.coerce.date()
528
525
  });
526
+ const alpicMcpRequestLogSchema = z.object({
527
+ type: z.literal("mcp_request"),
528
+ method: z.string()
529
+ });
530
+ const alpicMcpErrorLogSchema = z.object({
531
+ type: z.literal("mcp_error"),
532
+ method: z.string(),
533
+ error: z.string()
534
+ });
535
+ z.union([alpicMcpRequestLogSchema, alpicMcpErrorLogSchema]);
529
536
  z.enum([
530
537
  "INFO",
531
538
  "WARNING",
532
539
  "DEBUG",
533
540
  "ERROR"
534
541
  ]);
542
+ /** Only names a vendor actually ships belong here: lookalikes like `claude-code-test` are customers' own scripts. */
543
+ const MCP_CLIENT_GROUPS = [
544
+ {
545
+ id: "claude_code",
546
+ label: "Claude Code",
547
+ vendor: "anthropic",
548
+ rawNames: ["claude-code", "Anthropic/ClaudeCodeDesktop"]
549
+ },
550
+ {
551
+ id: "claude",
552
+ label: "Claude",
553
+ vendor: "anthropic",
554
+ rawNames: [
555
+ "Anthropic/ClaudeAI",
556
+ "claude-ai",
557
+ "claude",
558
+ "Claude",
559
+ "claude-desktop",
560
+ "claude-desktop-3p"
561
+ ]
562
+ },
563
+ {
564
+ id: "claude_mobile",
565
+ label: "Claude mobile",
566
+ vendor: "anthropic",
567
+ rawNames: ["claude-ios", "ClaudeAndroid"]
568
+ },
569
+ {
570
+ id: "claude_cowork",
571
+ label: "Claude Cowork",
572
+ vendor: "anthropic",
573
+ rawNames: ["Anthropic/Cowork"]
574
+ },
575
+ {
576
+ id: "claude_toolbox",
577
+ label: "Claude Toolbox",
578
+ vendor: "anthropic",
579
+ rawNames: ["Anthropic/Toolbox", "Anthropic/toolbox-bootstrap"]
580
+ },
581
+ {
582
+ id: "anthropic_api",
583
+ label: "Anthropic API",
584
+ vendor: "anthropic",
585
+ rawNames: ["Anthropic/API"]
586
+ },
587
+ {
588
+ id: "anthropic_connector_refresh",
589
+ label: "Anthropic (connector refresh)",
590
+ vendor: "anthropic",
591
+ rawNames: ["Anthropic"]
592
+ },
593
+ {
594
+ id: "codex",
595
+ label: "Codex",
596
+ vendor: "openai",
597
+ rawNames: [
598
+ "codex-mcp-client",
599
+ "codex",
600
+ "Codex",
601
+ "codex-cli",
602
+ "openai-mcp (Codex)"
603
+ ]
604
+ },
605
+ {
606
+ id: "chatgpt",
607
+ label: "ChatGPT",
608
+ vendor: "openai",
609
+ rawNames: ["openai-mcp (ChatGPT)"]
610
+ },
611
+ {
612
+ id: "openai_responses_api",
613
+ label: "OpenAI Responses API",
614
+ vendor: "openai",
615
+ rawNames: ["openai-mcp (Responses API)"]
616
+ },
617
+ {
618
+ id: "openai_agent_builder",
619
+ label: "OpenAI Agent Builder",
620
+ vendor: "openai",
621
+ rawNames: ["openai-mcp (Agent Builder)"]
622
+ },
623
+ {
624
+ id: "openai_other",
625
+ label: "OpenAI Other",
626
+ vendor: "openai",
627
+ rawNames: ["openai-mcp"]
628
+ },
629
+ {
630
+ id: "cursor",
631
+ label: "Cursor",
632
+ vendor: "cursor",
633
+ rawNames: [
634
+ "cursor-vscode",
635
+ "Cursor",
636
+ "cursor"
637
+ ]
638
+ },
639
+ {
640
+ id: "cline",
641
+ label: "Cline",
642
+ vendor: "cline",
643
+ rawNames: [
644
+ "Cline",
645
+ "cline",
646
+ "@cline/core"
647
+ ]
648
+ },
649
+ {
650
+ id: "github_copilot",
651
+ label: "GitHub Copilot",
652
+ vendor: "githubCopilot",
653
+ rawNames: [
654
+ "Copilot",
655
+ "github-copilot-developer",
656
+ "Copilot MCP Gateway",
657
+ "Xcode/copilot-xcode"
658
+ ]
659
+ },
660
+ {
661
+ id: "gemini_cli",
662
+ label: "Gemini CLI",
663
+ vendor: "google",
664
+ rawNames: ["gemini-cli-mcp-client", "gemini-cli"]
665
+ },
666
+ {
667
+ id: "antigravity",
668
+ label: "Antigravity",
669
+ vendor: "google",
670
+ rawNames: ["antigravity-client"]
671
+ },
672
+ {
673
+ id: "gemini",
674
+ label: "Gemini",
675
+ vendor: "google",
676
+ rawNames: ["Gemini", "google-ai-edge-gallery"]
677
+ },
678
+ {
679
+ id: "windsurf",
680
+ label: "Windsurf",
681
+ vendor: "windsurf",
682
+ rawNames: ["Windsurf", "windsurf-client"]
683
+ },
684
+ {
685
+ id: "mistral",
686
+ label: "Mistral / Le Chat",
687
+ vendor: "mistral",
688
+ rawNames: ["Mistral"],
689
+ rawNamePrefixes: ["connector:custom-mcp:"]
690
+ },
691
+ {
692
+ id: "n8n",
693
+ label: "n8n",
694
+ vendor: "n8n",
695
+ rawNames: [
696
+ "@n8n/n8n-nodes-langchain.mcpClient",
697
+ "@n8n/n8n-nodes-langchain.mcpClientTool",
698
+ "n8n"
699
+ ]
700
+ },
701
+ {
702
+ id: "alpic_playground",
703
+ label: "Alpic Playground",
704
+ vendor: "alpic",
705
+ rawNames: ["alpic-playground", "playground"]
706
+ },
707
+ {
708
+ id: "opencode",
709
+ label: "opencode",
710
+ vendor: "opencode",
711
+ rawNames: ["opencode"]
712
+ },
713
+ {
714
+ id: "zed",
715
+ label: "Zed",
716
+ vendor: "zed",
717
+ rawNames: ["Zed", "zed"]
718
+ },
719
+ {
720
+ id: "zapier",
721
+ label: "Zapier",
722
+ vendor: "zapier",
723
+ rawNames: ["Zapier", "zapier"]
724
+ },
725
+ {
726
+ id: "make",
727
+ label: "Make",
728
+ vendor: "make",
729
+ rawNames: ["Make", "make"]
730
+ },
731
+ {
732
+ id: "librechat",
733
+ label: "LibreChat",
734
+ vendor: "mcp",
735
+ rawNames: ["LibreChat", "librechat"]
736
+ },
737
+ {
738
+ id: "jan",
739
+ label: "Jan",
740
+ vendor: "mcp",
741
+ rawNames: ["Jan", "jan"]
742
+ },
743
+ {
744
+ id: "goose",
745
+ label: "goose",
746
+ vendor: "mcp",
747
+ rawNames: ["goose", "Goose"]
748
+ },
749
+ {
750
+ id: "mcphost",
751
+ label: "mcphost",
752
+ vendor: "mcp",
753
+ rawNames: ["mcphost"]
754
+ },
755
+ {
756
+ id: "mcporter",
757
+ label: "mcporter",
758
+ vendor: "mcp",
759
+ rawNames: ["mcporter"]
760
+ },
761
+ {
762
+ id: "rmcp",
763
+ label: "rmcp",
764
+ vendor: "mcp",
765
+ rawNames: ["rmcp"]
766
+ },
767
+ {
768
+ id: "unnamed_client",
769
+ label: "Unnamed client",
770
+ vendor: "mcp",
771
+ rawNames: [
772
+ "mcp",
773
+ "unknown",
774
+ ""
775
+ ]
776
+ }
777
+ ];
778
+ /** A source pattern, not a RegExp, because analytics renders the same rule into ClickHouse RE2, which shares this syntax. */
779
+ const MCP_REMOTE_WRAPPER_SUFFIX = String.raw` \(via mcp-remote [^\n]+?\)$`;
780
+ new RegExp(MCP_REMOTE_WRAPPER_SUFFIX);
781
+ new Map(MCP_CLIENT_GROUPS.map((group) => [group.id, group]));
535
782
  const runtimeSchema = z.enum([
536
783
  "python3.13",
537
784
  "python3.14",
@@ -609,15 +856,7 @@ z.object({
609
856
  serverFields: serverFieldsSchema$1,
610
857
  source: z.enum(["registry", "defaults"])
611
858
  });
612
- /**
613
- * Returns a variant of a `maxLength`-constrained string that clamps (truncates) instead of
614
- * rejecting on overflow — used for AI-generated copy where the model routinely overshoots.
615
- *
616
- * NOTE: this rebuilds the schema from scratch, carrying over only `maxLength` (as a clamp),
617
- * `minLength`, and the description. Any other validators on the source field (`.regex()`,
618
- * `.email()`, custom refinements) are intentionally dropped — this helper is meant for plain
619
- * free-text length caps only. A field with `null` `maxLength` is returned unchanged.
620
- */
859
+ /** 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. */
621
860
  const clampStringField = (field) => {
622
861
  const max = field.maxLength;
623
862
  if (max === null) return field;
@@ -963,11 +1202,7 @@ const chatgptToolJustificationSchema = z.object({
963
1202
  openWorldJustification: z.string().describe("One sentence on whether the tool reaches external systems beyond your own service."),
964
1203
  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.\"")
965
1204
  }).describe("Per-tool justification of each MCP annotation value (one specific sentence per hint).");
966
- /**
967
- * Base copy fields, defined once and reused by both the submission form and per-locale
968
- * translations so the constraints (tagline ≤ 30 chars) never drift. The translation generation
969
- * path wraps these in {@link clampStringField} since the LLM tends to overshoot the limit.
970
- */
1205
+ /** Defined once and reused by both the submission form and per-locale translations so the tagline ≤ 30 chars constraint never drifts. */
971
1206
  const chatgptTaglineSchema = z.string().max(30);
972
1207
  const chatgptDescriptionSchema = z.string();
973
1208
  const chatgptTranslationSchema = z.object({
@@ -976,10 +1211,7 @@ const chatgptTranslationSchema = z.object({
976
1211
  description: chatgptDescriptionSchema
977
1212
  }).describe("Locale-scoped override for tagline + description. English (US) is the default.");
978
1213
  chatgptTranslationSchema.extend({ tagline: clampStringField(chatgptTaglineSchema) });
979
- /**
980
- * Field order mirrors the ChatGPT (OpenAI) submission spreadsheet, grouped by section.
981
- * When adding/removing/reordering fields, keep this in sync with the sheet.
982
- */
1214
+ /** Field order mirrors the ChatGPT (OpenAI) submission spreadsheet, grouped by section; keep it in sync with the sheet. */
983
1215
  const chatgptSubmissionFormDataSchema = z.object({
984
1216
  logoLight: z.string().describe("Logo icon for light mode. Square PNG, no borders or rounded corners (clients apply circular cropping)."),
985
1217
  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."),
@@ -1076,11 +1308,7 @@ const claudePolicyAcknowledgementSchema = z.enum([
1076
1308
  "My connector does not collect conversation data beyond what is needed for its function.",
1077
1309
  "Public documentation for this connector will be live by the publish date."
1078
1310
  ]);
1079
- /**
1080
- * Field order mirrors the claude.ai directory submission wizard
1081
- * (`claude.ai/admin-settings/directory/submissions/new`), grouped by step.
1082
- * When adding/removing/reordering fields, keep this in sync with the wizard.
1083
- */
1311
+ /** 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. */
1084
1312
  const claudeSubmissionFormDataSchema = z.object({
1085
1313
  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
1086
1314
  from the custom connector you select — the connection is used to verify the URL and the tool list at submission time.
@@ -1172,12 +1400,7 @@ claudeSubmissionFormDataSchema.pick({
1172
1400
  connectionRequirements: claudeSubmissionFormDataSchema.shape.connectionRequirements.optional(),
1173
1401
  testInstructions: claudeSubmissionFormDataSchema.shape.testInstructions.optional()
1174
1402
  });
1175
- /**
1176
- * Narrative fields the LLM-backed generation step produces for Claude submissions.
1177
- * This schema accepts the slightly loose shape returned by AI generation, then normalizes it into
1178
- * the strict form shape. Keep transforms here rather than in callers so generation leniency is
1179
- * colocated with the Claude contract.
1180
- */
1403
+ /** Loose shape returned by AI generation for Claude narrative fields; transforms live here so generation leniency stays colocated with the Claude contract. */
1181
1404
  const claudeAiGeneratedFormDataRawSchema = z.object({
1182
1405
  oneLiner: claudeSubmissionFormDataSchema.shape.oneLiner,
1183
1406
  description: claudeSubmissionFormDataSchema.shape.description,
@@ -1205,6 +1428,11 @@ const chatgptSubmissionSchemaInternal = submissionMetaFieldsSchema.extend({
1205
1428
  });
1206
1429
  z.discriminatedUnion("platform", [claudeSubmissionSchemaInternal, chatgptSubmissionSchemaInternal]);
1207
1430
  z.union([claudeSubmissionDraftSchema, chatgptSubmissionDraftSchema]);
1431
+ z.literal([
1432
+ 100,
1433
+ 75,
1434
+ 50
1435
+ ]);
1208
1436
  const subscriptionPlanSchema = z.enum([
1209
1437
  "pro",
1210
1438
  "business",
@@ -1227,6 +1455,44 @@ z.object({
1227
1455
  customerUsage: customerUsageSchema.nullable(),
1228
1456
  partnerDiscount: partnerDiscountSchema.nullable()
1229
1457
  });
1458
+ const telemetrySignalSchema = z.enum([
1459
+ "logs",
1460
+ "metrics",
1461
+ "traces"
1462
+ ]);
1463
+ const otlpProtocolSchema = z.enum(["http/protobuf", "http/json"]);
1464
+ const otlpEndpointSchema = z.string().trim().min(1).max(2048);
1465
+ const OTLP_HEADER_VALUE_MAX_LENGTH = 2048;
1466
+ const otlpHeaderNameSchema = z.string().trim().min(1, "Enter a header name").max(128).regex(/^[A-Za-z0-9!#$%&'*+\-.^_`|~]+$/, "Use letters, digits and !#$%&'*+-.^_`|~ only");
1467
+ const otlpHeaderValueSchema = z.string().trim().max(OTLP_HEADER_VALUE_MAX_LENGTH).refine((value) => !/[\r\n]/.test(value), "Line breaks are not allowed in a header value");
1468
+ const telemetryDestinationHeaderSchema = z.object({
1469
+ id: z.string(),
1470
+ name: otlpHeaderNameSchema,
1471
+ value: otlpHeaderValueSchema,
1472
+ isSecret: z.boolean()
1473
+ });
1474
+ const otlpPushFailureReasonSchema = z.enum([
1475
+ "credentials",
1476
+ "wrong-path",
1477
+ "wrong-protocol",
1478
+ "invalid-payload",
1479
+ "partial-rejection",
1480
+ "blocked-target",
1481
+ "timeout",
1482
+ "unreachable",
1483
+ "receiver-error",
1484
+ "unexpected-status"
1485
+ ]);
1486
+ const telemetryDestinationStatusSchema = z.enum(["active", "suspended"]);
1487
+ z.object({
1488
+ id: z.string(),
1489
+ signal: telemetrySignalSchema,
1490
+ endpoint: otlpEndpointSchema,
1491
+ protocol: otlpProtocolSchema,
1492
+ headers: z.array(telemetryDestinationHeaderSchema),
1493
+ status: telemetryDestinationStatusSchema,
1494
+ lastFailureReason: otlpPushFailureReasonSchema.nullable()
1495
+ });
1230
1496
  //#endregion
1231
1497
  //#region src/auth-scope.ts
1232
1498
  /** Accepts an API key or OAuth access token (default for most routes). */
@@ -1269,7 +1535,10 @@ const RESERVED_KEYS = [
1269
1535
  "BUILD_ARG_START_COMMAND",
1270
1536
  "ALPIC_HOST",
1271
1537
  "ALPIC_CUSTOM_DOMAINS",
1272
- "ALPIC_INTENT_META_KEY"
1538
+ "ALPIC_INTENT_META_KEY",
1539
+ "ALPIC_FEEDBACK_META_KEY",
1540
+ "ALPIC_EVENTS_META_KEY",
1541
+ "ALPIC_IDENTIFY_META_KEY"
1273
1542
  ];
1274
1543
  const environmentVariableSchema = z.object({
1275
1544
  key: z.string().min(2, "Key must be at least 2 characters").regex(/^[a-zA-Z]([a-zA-Z0-9_])+$/, "Key must start with a letter and contain only letters, numbers, and underscores").refine((key) => !RESERVED_KEYS.includes(key), "This key is reserved and cannot be used as an environment variable key"),
@@ -1350,21 +1619,20 @@ const deploymentSchema = z.object({
1350
1619
  isCurrent: z.boolean(),
1351
1620
  deploymentPageUrl: z.url().nullable()
1352
1621
  });
1353
- const isValidLogTimeInput = (value) => {
1622
+ const isValidTimeInput = (value) => {
1354
1623
  if (ms(value) !== void 0) return true;
1355
1624
  return !Number.isNaN(new Date(value).getTime());
1356
1625
  };
1357
- const createEnvironmentContractV1 = oc.route({
1626
+ const timeInputSchema = z.string().refine(isValidTimeInput, { message: "Invalid time. Use relative (1h, 30m, 2d) or ISO 8601 format." });
1627
+ const base = oc.errors({ BAD_REQUEST: {} });
1628
+ const createEnvironmentContractV1 = base.route({
1358
1629
  path: "/v1/environments",
1359
1630
  method: "POST",
1360
1631
  summary: "Create an environment",
1361
1632
  description: "Create an environment for a project",
1362
1633
  tags: ["environments"],
1363
1634
  successDescription: "The environment has been created successfully"
1364
- }).errors({
1365
- NOT_FOUND: {},
1366
- BAD_REQUEST: {}
1367
- }).input(z.object({
1635
+ }).errors({ NOT_FOUND: {} }).input(z.object({
1368
1636
  projectId: z.string().describe("The ID of the project to create the environment for"),
1369
1637
  name: z.string().min(1).describe("The name of the environment"),
1370
1638
  sourceBranch: z.string().min(1).describe("The branch used to build the environment"),
@@ -1377,7 +1645,7 @@ const createEnvironmentContractV1 = oc.route({
1377
1645
  createdAt: z.coerce.date(),
1378
1646
  projectId: z.string().describe("The ID of the project the environment belongs to")
1379
1647
  }));
1380
- const getEnvironmentContractV1 = oc.route({
1648
+ const getEnvironmentContractV1 = base.route({
1381
1649
  path: "/v1/environments/{environmentId}",
1382
1650
  method: "GET",
1383
1651
  summary: "Get an environment",
@@ -1434,7 +1702,7 @@ const projectOutputSchema = z.object({
1434
1702
  productionEnvironment: productionEnvironmentSchema.nullable(),
1435
1703
  environments: z.array(environmentSchema)
1436
1704
  });
1437
- const getProjectContractV1 = oc.route({
1705
+ const getProjectContractV1 = base.route({
1438
1706
  path: "/v1/projects/{projectId}",
1439
1707
  method: "GET",
1440
1708
  summary: "Get a project",
@@ -1442,18 +1710,15 @@ const getProjectContractV1 = oc.route({
1442
1710
  tags: ["projects"],
1443
1711
  successDescription: "The project details"
1444
1712
  }).errors({ NOT_FOUND: {} }).input(z.object({ projectId: z.string().describe("The ID of the project") })).output(projectOutputSchema);
1445
- const listProjectsContractV1 = oc.route({
1713
+ const listProjectsContractV1 = base.route({
1446
1714
  path: "/v1/projects",
1447
1715
  method: "GET",
1448
1716
  summary: "List projects",
1449
1717
  description: "List all projects for a team",
1450
1718
  tags: ["projects"],
1451
1719
  successDescription: "The list of projects"
1452
- }).errors({
1453
- NOT_FOUND: {},
1454
- BAD_REQUEST: {}
1455
- }).input(z.object({ teamId: z.string().optional() }).optional()).output(z.array(projectOutputSchema));
1456
- const createProjectContractV1 = oc.route({
1720
+ }).errors({ NOT_FOUND: {} }).input(z.object({ teamId: z.string().optional() }).optional()).output(z.array(projectOutputSchema));
1721
+ const createProjectContractV1 = base.route({
1457
1722
  path: "/v1/projects",
1458
1723
  method: "POST",
1459
1724
  summary: "Create a project",
@@ -1462,7 +1727,6 @@ const createProjectContractV1 = oc.route({
1462
1727
  successDescription: "The project has been created successfully"
1463
1728
  }).errors({
1464
1729
  NOT_FOUND: {},
1465
- BAD_REQUEST: {},
1466
1730
  FORBIDDEN: {}
1467
1731
  }).input(z.object({
1468
1732
  teamId: z.string().optional(),
@@ -1503,7 +1767,7 @@ const environmentVariableOutputSchema = z.object({
1503
1767
  isSecret: z.boolean(),
1504
1768
  createdAt: z.coerce.date()
1505
1769
  });
1506
- const listEnvironmentVariablesContractV1 = oc.route({
1770
+ const listEnvironmentVariablesContractV1 = base.route({
1507
1771
  path: "/v1/environments/{environmentId}/environment-variables",
1508
1772
  method: "GET",
1509
1773
  summary: "List environment variables",
@@ -1511,48 +1775,39 @@ const listEnvironmentVariablesContractV1 = oc.route({
1511
1775
  tags: ["environments"],
1512
1776
  successDescription: "The list of environment variables"
1513
1777
  }).errors({ NOT_FOUND: {} }).input(z.object({ environmentId: z.string().describe("The ID of the environment") })).output(z.array(environmentVariableOutputSchema));
1514
- const createEnvironmentVariablesContractV1 = oc.route({
1778
+ const createEnvironmentVariablesContractV1 = base.route({
1515
1779
  path: "/v1/environments/{environmentId}/environment-variables",
1516
1780
  method: "POST",
1517
1781
  summary: "Add environment variables",
1518
1782
  description: "Add one or more environment variables to an environment",
1519
1783
  tags: ["environments"],
1520
1784
  successDescription: "The environment variables have been added successfully"
1521
- }).errors({
1522
- NOT_FOUND: {},
1523
- BAD_REQUEST: {}
1524
- }).input(z.object({
1785
+ }).errors({ NOT_FOUND: {} }).input(z.object({
1525
1786
  environmentId: z.string().describe("The ID of the environment"),
1526
1787
  environmentVariables: environmentVariablesSchema
1527
1788
  })).output(z.object({ success: z.literal(true) }));
1528
- const updateEnvironmentVariableContractV1 = oc.route({
1789
+ const updateEnvironmentVariableContractV1 = base.route({
1529
1790
  path: "/v1/environment-variables/{environmentVariableId}",
1530
1791
  method: "PATCH",
1531
1792
  summary: "Update an environment variable",
1532
1793
  description: "Update an environment variable by ID",
1533
1794
  tags: ["environments"],
1534
1795
  successDescription: "The environment variable has been updated successfully"
1535
- }).errors({
1536
- NOT_FOUND: {},
1537
- BAD_REQUEST: {}
1538
- }).input(z.object({
1796
+ }).errors({ NOT_FOUND: {} }).input(z.object({
1539
1797
  environmentVariableId: z.string().describe("The ID of the environment variable"),
1540
1798
  key: environmentVariableSchema.shape.key,
1541
1799
  value: environmentVariableSchema.shape.value.optional(),
1542
1800
  isSecret: environmentVariableSchema.shape.isSecret.optional()
1543
1801
  })).output(z.object({ success: z.literal(true) }));
1544
- const deleteEnvironmentVariableContractV1 = oc.route({
1802
+ const deleteEnvironmentVariableContractV1 = base.route({
1545
1803
  path: "/v1/environment-variables/{environmentVariableId}",
1546
1804
  method: "DELETE",
1547
1805
  summary: "Delete an environment variable",
1548
1806
  description: "Delete an environment variable by ID",
1549
1807
  tags: ["environments"],
1550
1808
  successDescription: "The environment variable has been deleted successfully"
1551
- }).errors({
1552
- NOT_FOUND: {},
1553
- BAD_REQUEST: {}
1554
- }).input(z.object({ environmentVariableId: z.string().describe("The ID of the environment variable") })).output(z.object({ success: z.literal(true) }));
1555
- const deleteProjectContractV1 = oc.route({
1809
+ }).errors({ NOT_FOUND: {} }).input(z.object({ environmentVariableId: z.string().describe("The ID of the environment variable") })).output(z.object({ success: z.literal(true) }));
1810
+ const deleteProjectContractV1 = base.route({
1556
1811
  path: "/v1/projects/{projectId}",
1557
1812
  method: "DELETE",
1558
1813
  summary: "Delete a project",
@@ -1560,7 +1815,7 @@ const deleteProjectContractV1 = oc.route({
1560
1815
  tags: ["projects"],
1561
1816
  successDescription: "The project has been deleted successfully"
1562
1817
  }).errors({ NOT_FOUND: {} }).input(z.object({ projectId: z.string().describe("The ID of the project") })).output(z.object({ success: z.literal(true) }));
1563
- const updateProjectContractV1 = oc.route({
1818
+ const updateProjectContractV1 = base.route({
1564
1819
  path: "/v1/projects/{projectId}",
1565
1820
  method: "PATCH",
1566
1821
  summary: "Update a project",
@@ -1569,14 +1824,13 @@ const updateProjectContractV1 = oc.route({
1569
1824
  successDescription: "The project has been updated successfully"
1570
1825
  }).errors({
1571
1826
  NOT_FOUND: {},
1572
- BAD_REQUEST: {},
1573
1827
  FORBIDDEN: {}
1574
1828
  }).input(z.object({
1575
1829
  projectId: z.string().describe("The ID of the project"),
1576
1830
  name: z.string().min(1).max(100).optional().describe("The new name for the project"),
1577
1831
  sourceRepository: z.string().nullable().optional().describe("The source repository to connect to the project")
1578
1832
  })).output(projectOutputSchema);
1579
- const deployEnvironmentContractV1 = oc.route({
1833
+ const deployEnvironmentContractV1 = base.route({
1580
1834
  path: "/v1/environments/{environmentId}/deploy",
1581
1835
  method: "POST",
1582
1836
  summary: "Deploy an environment",
@@ -1585,29 +1839,25 @@ const deployEnvironmentContractV1 = oc.route({
1585
1839
  successDescription: "The environment has been deployed successfully"
1586
1840
  }).errors({
1587
1841
  NOT_FOUND: {},
1588
- BAD_REQUEST: {},
1589
1842
  CONFLICT: {}
1590
1843
  }).input(z.object({
1591
1844
  environmentId: z.string().describe("The ID of the environment to deploy"),
1592
1845
  token: z.string().describe("The token to identify the source archive").optional(),
1593
1846
  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.")
1594
1847
  })).output(deploymentSchema);
1595
- const uploadDeploymentArtifactContractV1 = oc.route({
1848
+ const uploadDeploymentArtifactContractV1 = base.route({
1596
1849
  path: "/v1/deployments/upload",
1597
1850
  method: "POST",
1598
1851
  summary: "Upload deployment artifacts",
1599
1852
  description: "Return a presigned S3 URL to upload a deployment artifact",
1600
1853
  tags: ["deployments"],
1601
1854
  successDescription: "The presigned upload URL has been generated successfully"
1602
- }).errors({
1603
- NOT_FOUND: {},
1604
- BAD_REQUEST: {}
1605
- }).input(z.object({ teamId: z.string().optional() }).optional()).output(z.object({
1855
+ }).errors({ NOT_FOUND: {} }).input(z.object({ teamId: z.string().optional() }).optional()).output(z.object({
1606
1856
  uploadUrl: z.url().describe("Presigned S3 URL to upload the source archive with HTTP PUT"),
1607
1857
  token: z.string().describe("Token to identify the source archive"),
1608
1858
  expiresAt: z.coerce.date().describe("Expiration date of the presigned URL")
1609
1859
  }));
1610
- const listDeploymentsContractV1 = oc.route({
1860
+ const listDeploymentsContractV1 = base.route({
1611
1861
  path: "/v1/projects/{projectId}/deployments",
1612
1862
  method: "GET",
1613
1863
  summary: "List project deployments",
@@ -1619,7 +1869,7 @@ const listDeploymentsContractV1 = oc.route({
1619
1869
  status: z.array(deploymentStatusSchema).optional().describe("Filter by one or more statuses"),
1620
1870
  environmentId: z.string().optional().describe("Filter by environment ID")
1621
1871
  })).output(z.array(deploymentSchema));
1622
- const getDeploymentContractV1 = oc.route({
1872
+ const getDeploymentContractV1 = base.route({
1623
1873
  path: "/v1/deployments/{deploymentId}",
1624
1874
  method: "GET",
1625
1875
  summary: "Get a deployment",
@@ -1642,20 +1892,17 @@ const logEntrySchema = z.object({
1642
1892
  method: z.string().optional(),
1643
1893
  durationInMs: z.number().optional()
1644
1894
  });
1645
- const getLogsContractV1 = oc.route({
1895
+ const getLogsContractV1 = base.route({
1646
1896
  path: "/v1/environments/{environmentId}/logs",
1647
1897
  method: "GET",
1648
1898
  summary: "Get logs",
1649
1899
  description: "Get logs for an environment",
1650
1900
  tags: ["environments"],
1651
1901
  successDescription: "The logs"
1652
- }).errors({
1653
- NOT_FOUND: {},
1654
- BAD_REQUEST: {}
1655
- }).input(z.object({
1902
+ }).errors({ NOT_FOUND: {} }).input(z.object({
1656
1903
  environmentId: z.string().describe("The ID of the environment"),
1657
- 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)"),
1658
- 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"),
1904
+ since: timeInputSchema.optional().describe("Start time — ISO 8601 (2024-01-01T00:00:00Z) or relative (1h, 30m, 2d)"),
1905
+ until: timeInputSchema.optional().describe("End time — ISO 8601 or relative"),
1659
1906
  limit: z.coerce.number().int().min(1).max(1e3).default(1e3).describe("Maximum number of log entries to return."),
1660
1907
  level: z.array(z.enum([
1661
1908
  "INFO",
@@ -1669,17 +1916,14 @@ const getLogsContractV1 = oc.route({
1669
1916
  logs: z.array(logEntrySchema),
1670
1917
  nextToken: z.string().nullable()
1671
1918
  }));
1672
- const getLatestLogsContractV1 = oc.route({
1919
+ const getLatestLogsContractV1 = base.route({
1673
1920
  path: "/v1/environments/{environmentId}/latest-logs",
1674
1921
  method: "GET",
1675
1922
  summary: "Get latest logs",
1676
1923
  description: "Get the N most recent logs for an environment",
1677
1924
  tags: ["environments"],
1678
1925
  successDescription: "The latest logs"
1679
- }).errors({
1680
- NOT_FOUND: {},
1681
- BAD_REQUEST: {}
1682
- }).input(z.object({
1926
+ }).errors({ NOT_FOUND: {} }).input(z.object({
1683
1927
  environmentId: z.string().describe("The ID of the environment"),
1684
1928
  limit: z.coerce.number().int().min(1).max(1e3).default(100).describe("Number of most recent log entries to return"),
1685
1929
  level: z.array(z.enum([
@@ -1690,7 +1934,7 @@ const getLatestLogsContractV1 = oc.route({
1690
1934
  ])).optional().describe("Filter by log level"),
1691
1935
  search: z.string().optional().describe("Filter pattern to search for in log content")
1692
1936
  })).output(z.object({ logs: z.array(logEntrySchema) }));
1693
- const getDeploymentLogsContractV1 = oc.route({
1937
+ const getDeploymentLogsContractV1 = base.route({
1694
1938
  path: "/v1/deployments/{deploymentId}/logs",
1695
1939
  method: "GET",
1696
1940
  summary: "Get deployment logs",
@@ -1717,22 +1961,19 @@ const analyticsTimeSeriesSchema = z.object({
1717
1961
  output_token_mean: z.array(analyticsDataPointSchema),
1718
1962
  task_count: z.array(analyticsDataPointSchema)
1719
1963
  });
1720
- const getProjectAnalyticsContractV1 = oc.route({
1964
+ const getProjectAnalyticsContractV1 = base.route({
1721
1965
  path: "/v1/analytics/{projectId}",
1722
1966
  method: "GET",
1723
1967
  summary: "Get project analytics",
1724
1968
  description: "Get analytics data for a project over a time range",
1725
1969
  tags: ["analytics"],
1726
1970
  successDescription: "The project analytics data"
1727
- }).errors({
1728
- NOT_FOUND: {},
1729
- BAD_REQUEST: {}
1730
- }).input(z.object({
1971
+ }).errors({ NOT_FOUND: {} }).input(z.object({
1731
1972
  projectId: z.string().describe("The ID of the project"),
1732
1973
  startTimestamp: z.coerce.number().describe("Start timestamp in milliseconds"),
1733
1974
  endTimestamp: z.coerce.number().describe("End timestamp in milliseconds"),
1734
1975
  timeZone: z.string().describe("IANA timezone (e.g. Europe/Paris)")
1735
- }).refine(({ startTimestamp, endTimestamp }) => endTimestamp - startTimestamp > 0, { message: "End date must be after start date" }).refine(({ startTimestamp, endTimestamp }) => endTimestamp - startTimestamp <= 744 * 60 * 60 * 1e3, { message: "Date range must be less than 1 month" }).refine(({ timeZone }) => Intl.supportedValuesOf("timeZone").includes(timeZone), { message: "Time zone must be a valid IANA timezone" })).output(z.object({
1976
+ }).refine(({ startTimestamp, endTimestamp }) => endTimestamp - startTimestamp > 0, { message: "End date must be after start date" }).refine(({ startTimestamp, endTimestamp }) => endTimestamp - startTimestamp <= 26784e5, { message: "Date range must be less than 1 month" }).refine(({ timeZone }) => Intl.supportedValuesOf("timeZone").includes(timeZone), { message: "Time zone must be a valid IANA timezone" })).output(z.object({
1736
1977
  metadata: z.object({
1737
1978
  startTimestamp: z.number(),
1738
1979
  endTimestamp: z.number(),
@@ -1742,7 +1983,132 @@ const getProjectAnalyticsContractV1 = oc.route({
1742
1983
  }),
1743
1984
  timeSeries: analyticsTimeSeriesSchema
1744
1985
  }));
1745
- const listTeamsContractV1 = oc.route({
1986
+ const paginatedInsightsInputShape = {
1987
+ environmentId: z.string().describe("The ID of the environment"),
1988
+ since: timeInputSchema.default("7d").describe("Start time — ISO 8601 (2024-01-01T00:00:00Z) or relative (1h, 30m, 2d)"),
1989
+ until: timeInputSchema.optional().describe("End time — ISO 8601 or relative"),
1990
+ limit: z.coerce.number().int().min(1).max(200).default(50),
1991
+ offset: z.coerce.number().int().min(0).default(0),
1992
+ search: z.string().trim().min(1).max(200).optional()
1993
+ };
1994
+ const listIntentsContractV1 = base.route({
1995
+ path: "/v1/environments/{environmentId}/intents",
1996
+ method: "GET",
1997
+ summary: "List intents",
1998
+ description: "List grouped user intents for an environment over a time range",
1999
+ tags: ["insights"],
2000
+ successDescription: "The grouped user intents"
2001
+ }).errors({ NOT_FOUND: {} }).input(z.object({
2002
+ ...paginatedInsightsInputShape,
2003
+ tools: z.array(z.string().trim().min(1)).min(1).max(100).optional(),
2004
+ clientIds: z.array(z.string().min(1)).min(1).max(100).optional(),
2005
+ categoryIds: z.array(z.string().trim().min(1)).min(1).max(100).optional(),
2006
+ sortDir: z.enum(["asc", "desc"]).default("desc")
2007
+ })).output(z.object({
2008
+ intents: z.array(z.object({
2009
+ id: z.string(),
2010
+ intentIds: z.array(z.string()).min(1),
2011
+ environmentId: z.string(),
2012
+ message: z.string(),
2013
+ toolName: z.string(),
2014
+ createdAt: z.coerce.date(),
2015
+ occurrenceCount: z.number().int().positive(),
2016
+ clientName: z.string().nullable(),
2017
+ clientId: z.string().nullable(),
2018
+ categories: z.array(z.object({
2019
+ id: z.string(),
2020
+ name: z.string(),
2021
+ color: intentCategoryColorSchema
2022
+ }))
2023
+ })),
2024
+ totalCount: z.number().int().nonnegative()
2025
+ }));
2026
+ const listFeedbacksContractV1 = base.route({
2027
+ path: "/v1/environments/{environmentId}/feedbacks",
2028
+ method: "GET",
2029
+ summary: "List feedbacks",
2030
+ description: "List user feedback for an environment over a time range",
2031
+ tags: ["insights"],
2032
+ successDescription: "The user feedback"
2033
+ }).errors({ NOT_FOUND: {} }).input(z.object({
2034
+ ...paginatedInsightsInputShape,
2035
+ clientIds: z.array(z.string().min(1)).min(1).max(100).optional()
2036
+ })).output(z.object({
2037
+ feedbacks: z.array(feedbackSchema.extend({ clientId: z.string().nullable() })),
2038
+ totalCount: z.number().int().nonnegative()
2039
+ }));
2040
+ const intentCategoryNameSchema = z.string().trim().min(1).max(100).describe("The category name");
2041
+ const categorizableIntentIdsSchema = z.array(z.string().trim().min(1)).min(1).max(100).describe("IDs of the intents to categorize");
2042
+ const listIntentCategoriesContractV1 = base.route({
2043
+ path: "/v1/environments/{environmentId}/intent-categories",
2044
+ method: "GET",
2045
+ summary: "List intent categories",
2046
+ description: "List intent categories for an environment, including how many intents each category is linked to",
2047
+ tags: ["insights"],
2048
+ successDescription: "The intent categories"
2049
+ }).errors({ NOT_FOUND: {} }).input(z.object({ environmentId: z.string().describe("The ID of the environment") })).output(z.array(intentCategorySummarySchema));
2050
+ const createIntentCategoryContractV1 = base.route({
2051
+ path: "/v1/environments/{environmentId}/intent-categories",
2052
+ method: "POST",
2053
+ summary: "Create an intent category",
2054
+ description: "Create an intent category, optionally linking it to existing intents",
2055
+ tags: ["insights"],
2056
+ successDescription: "The created intent category"
2057
+ }).errors({ NOT_FOUND: {} }).input(z.object({
2058
+ environmentId: z.string().describe("The ID of the environment"),
2059
+ name: intentCategoryNameSchema,
2060
+ color: intentCategoryColorSchema.optional().describe("The category color; derived from the name when omitted"),
2061
+ intentIds: categorizableIntentIdsSchema.optional().describe("IDs of intents to link to the new category")
2062
+ })).output(intentCategorySchema);
2063
+ const updateIntentCategoryContractV1 = base.route({
2064
+ path: "/v1/environments/{environmentId}/intent-categories/{categoryId}",
2065
+ method: "PATCH",
2066
+ summary: "Update an intent category",
2067
+ description: "Rename or recolor an intent category",
2068
+ tags: ["insights"],
2069
+ successDescription: "The updated intent category"
2070
+ }).errors({ NOT_FOUND: {} }).input(z.object({
2071
+ environmentId: z.string().describe("The ID of the environment"),
2072
+ categoryId: z.string().describe("The ID of the category"),
2073
+ name: intentCategoryNameSchema.optional(),
2074
+ color: intentCategoryColorSchema.optional().describe("The category color")
2075
+ }).refine(({ name, color }) => name !== void 0 || color !== void 0, { message: "At least one of name or color must be provided" })).output(intentCategorySchema);
2076
+ const deleteIntentCategoryContractV1 = base.route({
2077
+ path: "/v1/environments/{environmentId}/intent-categories/{categoryId}",
2078
+ method: "DELETE",
2079
+ summary: "Delete an intent category",
2080
+ description: "Delete an intent category; its intents are unlinked but not deleted",
2081
+ tags: ["insights"],
2082
+ successDescription: "The intent category has been deleted successfully"
2083
+ }).errors({ NOT_FOUND: {} }).input(z.object({
2084
+ environmentId: z.string().describe("The ID of the environment"),
2085
+ categoryId: z.string().describe("The ID of the category")
2086
+ })).output(z.object({ success: z.literal(true) }));
2087
+ const linkIntentCategoryContractV1 = base.route({
2088
+ path: "/v1/environments/{environmentId}/intent-categories/{categoryId}/link",
2089
+ method: "POST",
2090
+ summary: "Link an intent category",
2091
+ description: "Link an intent category to intents; already linked intents are ignored",
2092
+ tags: ["insights"],
2093
+ successDescription: "The intents have been linked successfully"
2094
+ }).errors({ NOT_FOUND: {} }).input(z.object({
2095
+ environmentId: z.string().describe("The ID of the environment"),
2096
+ categoryId: z.string().describe("The ID of the category"),
2097
+ intentIds: categorizableIntentIdsSchema
2098
+ })).output(z.object({ success: z.literal(true) }));
2099
+ const unlinkIntentCategoryContractV1 = base.route({
2100
+ path: "/v1/environments/{environmentId}/intent-categories/{categoryId}/unlink",
2101
+ method: "POST",
2102
+ summary: "Unlink an intent category",
2103
+ description: "Unlink an intent category from intents; intents without the category are ignored",
2104
+ tags: ["insights"],
2105
+ successDescription: "The intents have been unlinked successfully"
2106
+ }).errors({ NOT_FOUND: {} }).input(z.object({
2107
+ environmentId: z.string().describe("The ID of the environment"),
2108
+ categoryId: z.string().describe("The ID of the category"),
2109
+ intentIds: categorizableIntentIdsSchema
2110
+ })).output(z.object({ success: z.literal(true) }));
2111
+ const listTeamsContractV1 = base.route({
1746
2112
  path: "/v1/teams",
1747
2113
  method: "GET",
1748
2114
  summary: "List teams",
@@ -1755,7 +2121,22 @@ const listTeamsContractV1 = oc.route({
1755
2121
  createdAt: z.coerce.date(),
1756
2122
  hasStripeAccount: z.boolean()
1757
2123
  })));
1758
- const getTunnelTicketContractV1 = oc.route({
2124
+ const getTeamUsageContractV1 = base.route({
2125
+ path: "/v1/teams/{teamId}/usage",
2126
+ method: "GET",
2127
+ summary: "Get team usage",
2128
+ description: "Get the MCP request usage of a team for its current billing window. A team that has made no request in the window reports zero.",
2129
+ tags: ["teams"],
2130
+ successDescription: "The current billing window usage"
2131
+ }).errors({ NOT_FOUND: {} }).input(z.object({ teamId: z.string().describe("The ID of the team") })).output(z.object({
2132
+ teamId: z.string(),
2133
+ plan: subscriptionPlanSchema.nullable().describe("The plan in force for the window, null on the Free plan"),
2134
+ periodStart: z.coerce.date().describe("Start of the current billing window"),
2135
+ periodEnd: z.coerce.date().describe("End of the current billing window"),
2136
+ requestCount: z.number().int().describe("MCP requests settled during the current billing window"),
2137
+ includedRequests: z.number().int().nullable().describe("Requests included in the plan for one window, null when the allowance is contract-specific")
2138
+ }));
2139
+ const getTunnelTicketContractV1 = base.route({
1759
2140
  path: "/v1/tunnels/ticket",
1760
2141
  method: "GET",
1761
2142
  summary: "Get a tunnel ticket",
@@ -1767,16 +2148,13 @@ const getTunnelTicketContractV1 = oc.route({
1767
2148
  ticket: z.string().describe("The signed tunnel ticket"),
1768
2149
  tunnelHost: z.string().describe("The tunnel host to connect to")
1769
2150
  }));
1770
- const publishServerContractV1 = oc.route({
2151
+ const publishServerContractV1 = base.route({
1771
2152
  path: "/v1/distribution/publish",
1772
2153
  method: "POST",
1773
2154
  summary: "Publish a server to the MCP registry",
1774
2155
  tags: ["distribution"],
1775
2156
  successDescription: "The server has been published successfully"
1776
- }).errors({
1777
- NOT_FOUND: {},
1778
- BAD_REQUEST: {}
1779
- }).input(z.object({
2157
+ }).errors({ NOT_FOUND: {} }).input(z.object({
1780
2158
  projectId: z.string(),
1781
2159
  domain: z.string(),
1782
2160
  title: z.string().min(1).max(100),
@@ -1785,17 +2163,14 @@ const publishServerContractV1 = oc.route({
1785
2163
  iconSrc: z.url().max(255).optional(),
1786
2164
  dryRun: z.boolean().optional()
1787
2165
  })).output(z.object({ serverFields: serverFieldsSchema }));
1788
- const getServerInfoContractV1 = oc.route({
2166
+ const getServerInfoContractV1 = base.route({
1789
2167
  path: "/v1/distribution/get",
1790
2168
  method: "GET",
1791
2169
  summary: "Get server info",
1792
2170
  description: "Get info about a server",
1793
2171
  tags: ["distribution"],
1794
2172
  successDescription: "The server info"
1795
- }).errors({
1796
- NOT_FOUND: {},
1797
- BAD_REQUEST: {}
1798
- }).input(z.object({
2173
+ }).errors({ NOT_FOUND: {} }).input(z.object({
1799
2174
  projectId: z.string(),
1800
2175
  domain: z.string()
1801
2176
  })).output(z.object({ serverFields: serverFieldsSchema }));
@@ -1814,7 +2189,7 @@ const playgroundOutputSchema = z.object({
1814
2189
  isPlaygroundEnabled: z.boolean(),
1815
2190
  serverMetadata: playgroundServerMetadataOutputSchema.nullable()
1816
2191
  });
1817
- const getPlaygroundContractV1 = oc.route({
2192
+ const getPlaygroundContractV1 = base.route({
1818
2193
  path: "/v1/environments/{environmentId}/playground",
1819
2194
  method: "GET",
1820
2195
  summary: "Get playground configuration",
@@ -1822,17 +2197,14 @@ const getPlaygroundContractV1 = oc.route({
1822
2197
  tags: ["environments"],
1823
2198
  successDescription: "The playground configuration"
1824
2199
  }).errors({ NOT_FOUND: {} }).input(z.object({ environmentId: z.string().describe("The ID of the environment") })).output(playgroundOutputSchema);
1825
- const upsertPlaygroundContractV1 = oc.route({
2200
+ const upsertPlaygroundContractV1 = base.route({
1826
2201
  path: "/v1/environments/{environmentId}/playground",
1827
2202
  method: "PUT",
1828
2203
  summary: "Update playground configuration",
1829
2204
  description: "Update the playground configuration for an environment. All fields are optional — only provided fields are updated.",
1830
2205
  tags: ["environments"],
1831
2206
  successDescription: "The updated playground configuration"
1832
- }).errors({
1833
- NOT_FOUND: {},
1834
- BAD_REQUEST: {}
1835
- }).input(z.object({
2207
+ }).errors({ NOT_FOUND: {} }).input(z.object({
1836
2208
  environmentId: z.string().describe("The ID of the environment"),
1837
2209
  isPlaygroundEnabled: z.boolean().optional(),
1838
2210
  name: z.string().min(1).max(100).optional(),
@@ -1840,7 +2212,7 @@ const upsertPlaygroundContractV1 = oc.route({
1840
2212
  headers: z.array(playgroundHeaderSchema).optional(),
1841
2213
  examplePrompts: z.array(playgroundExamplePromptSchema).max(5).optional()
1842
2214
  })).output(playgroundOutputSchema);
1843
- const createBeaconContractV1 = oc.route({
2215
+ const createBeaconContractV1 = base.route({
1844
2216
  path: "/v1/beacon/audits",
1845
2217
  method: "POST",
1846
2218
  summary: "Create a beacon audit",
@@ -1849,7 +2221,6 @@ const createBeaconContractV1 = oc.route({
1849
2221
  successDescription: "The audit has been created"
1850
2222
  }).errors({
1851
2223
  NOT_FOUND: {},
1852
- BAD_REQUEST: {},
1853
2224
  DNS_RESOLUTION_FAILED: { status: 400 }
1854
2225
  }).input(z.object({
1855
2226
  targetUrl: z.url().describe("The HTTPS URL of the MCP server to audit"),
@@ -1857,7 +2228,7 @@ const createBeaconContractV1 = oc.route({
1857
2228
  projectId: z.string().optional().describe("The project ID to associate the audit with"),
1858
2229
  excludeCategories: z.array(checkCategorySchema).optional().describe("Check categories to exclude from the audit")
1859
2230
  })).output(z.object({ id: z.string() }));
1860
- const getBeaconContractV1 = oc.route({
2231
+ const getBeaconContractV1 = base.route({
1861
2232
  path: "/v1/beacon/audits/{auditId}",
1862
2233
  method: "GET",
1863
2234
  summary: "Get a beacon audit",
@@ -1873,8 +2244,21 @@ const getBeaconContractV1 = oc.route({
1873
2244
  report: auditReportWithScreenshotsSchema.nullable()
1874
2245
  }));
1875
2246
  const contract = {
1876
- teams: { list: { v1: listTeamsContractV1 } },
2247
+ teams: {
2248
+ list: { v1: listTeamsContractV1 },
2249
+ getUsage: { v1: getTeamUsageContractV1 }
2250
+ },
1877
2251
  analytics: { get: { v1: getProjectAnalyticsContractV1 } },
2252
+ intents: { list: { v1: listIntentsContractV1 } },
2253
+ intentCategories: {
2254
+ list: { v1: listIntentCategoriesContractV1 },
2255
+ create: { v1: createIntentCategoryContractV1 },
2256
+ update: { v1: updateIntentCategoryContractV1 },
2257
+ delete: { v1: deleteIntentCategoryContractV1 },
2258
+ link: { v1: linkIntentCategoryContractV1 },
2259
+ unlink: { v1: unlinkIntentCategoryContractV1 }
2260
+ },
2261
+ feedbacks: { list: { v1: listFeedbacksContractV1 } },
1878
2262
  deployments: {
1879
2263
  list: { v1: listDeploymentsContractV1 },
1880
2264
  get: { v1: getDeploymentContractV1 },
@@ -1915,5 +2299,10 @@ const contract = {
1915
2299
  get: { v1: getBeaconContractV1 }
1916
2300
  }
1917
2301
  };
2302
+ const { uploadArtifact: _discard, ...deploymentsForDocs } = contract.deployments;
2303
+ const contractForDocs = {
2304
+ ...contract,
2305
+ deployments: deploymentsForDocs
2306
+ };
1918
2307
  //#endregion
1919
- export { AUTH_SCOPE_ANY, AUTH_SCOPE_USER, PLATFORM_LABELS, buildSettingsSchema, contract, createEnvironmentContractV1, deploymentStatusSchema, environmentVariableSchema, environmentVariablesSchema, playgroundExamplePromptSchema, playgroundHeaderSchema, runtimeSchema, serverFieldsSchema, transportSchema, updateEnvironmentVariableSchema };
2308
+ export { AUTH_SCOPE_ANY, AUTH_SCOPE_USER, INTENT_CATEGORY_COLORS, PLATFORM_LABELS, buildSettingsSchema, contract, contractForDocs, createEnvironmentContractV1, deploymentStatusSchema, environmentVariableSchema, environmentVariablesSchema, intentCategoryColorSchema, playgroundExamplePromptSchema, playgroundHeaderSchema, runtimeSchema, serverFieldsSchema, transportSchema, updateEnvironmentVariableSchema };