@alpic-ai/api 0.0.0-dev.gf3155a7 → 0.0.0-dev.gf378a72

package/dist/index.mjs

@@ -2,7 +2,7 @@ import { z } from "zod";
 import * as z$1 from "zod/v4";
 import { oc } from "@orpc/contract";
 import ms from "ms";
-//#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/auth.js
+//#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
 /**
 * Reusable URL validation that disallows javascript: scheme
 */
@@ -169,11 +169,22 @@ z$1.object({
 	token: z$1.string(),
 	token_type_hint: z$1.string().optional()
 }).strip();
-const platformSchema = z.enum(["chatgpt", "claudeai"]);
+//#endregion
+//#region ../domains/dist/index.mjs
+const AI_PLATFORMS = ["chatgpt", "claudeai"];
+const platformSchema = z.enum(AI_PLATFORMS);
 const PLATFORM_LABELS = {
 	chatgpt: "ChatGPT",
 	claudeai: "Claude.ai"
 };
+const WAF_PLATFORMS = [
+	"akamai",
+	"cato",
+	"cloudflare",
+	"fastly"
+];
+const ALLOWED_PLATFORMS = [...AI_PLATFORMS, ...WAF_PLATFORMS];
+const allowedPlatformSchema = z.enum(ALLOWED_PLATFORMS);
 const auditStatusSchema = z.enum([
 	"pending",
 	"partial",
@@ -246,6 +257,25 @@ z.object({
 	clientSecret: z.string(),
 	clientScopes: z.array(z.string())
 });
+const creditEntryReasonSchema = z.enum([
+	"free_seed",
+	"paid_conversion_floor",
+	"top_up",
+	"usage",
+	"admin_adjustment"
+]);
+z.enum(["playground"]);
+z.number().int().min(500);
+const creditActivityEntrySchema = z.object({
+	reason: creditEntryReasonSchema,
+	day: z.number(),
+	amountInNanoUSD: z.number(),
+	messageCount: z.number().nullable()
+});
+z.object({
+	balanceInNanoUSD: z.number(),
+	recentActivity: z.array(creditActivityEntrySchema)
+});
 const deploymentStatusSchema$1 = z.enum([
 	"ongoing",
 	"deployed",
@@ -273,33 +303,18 @@ const deploymentSummarySchema = z.object({
 	createdAt: z.coerce.date(),
 	updatedAt: z.coerce.date()
 });
-/**
-* Public environment
-*
-* Answers anonymously and exposes no OAuth metadata.
-*/
+/** Public environment: answers anonymously and exposes no OAuth metadata. */
 const publicEnvironmentSchema = z.object({
 	allowsAnonymous: z.literal(true),
 	oAuthMetadata: z.strictObject({})
 });
-/**
-* Protected environment with an external resource metadata URL
-*
-* An external resource metadata URL is returned in the WWW-Authenticate header during the first 401 response.
-* Everything that follows is handled outside of the MCP server scope.
-*/
+/** 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. */
 const externalResourceMetadataEnvironmentSchema = z.object({
 	allowsAnonymous: z.boolean(),
 	oAuthMetadata: z.object({ externalResourceMetadataUrl: z.url() }),
 	scope: z.string().optional()
 });
-/**
-* Protected environment with an external authorization server URL
-*
-* The server itself exposes the /.well-known/oauth-protected-resource endpoint.
-* An external authorization server URL is returned when requesting the endpoint.
-* Everything that follows is handled outside of the MCP server scope.
-*/
+/** 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. */
 const externalAuthorizationServerEnvironmentSchema = z.object({
 	allowsAnonymous: z.boolean(),
 	oAuthMetadata: z.object({
@@ -308,12 +323,7 @@ const externalAuthorizationServerEnvironmentSchema = z.object({
 	}),
 	scope: z.string().optional()
 });
-/**
-* Standalone protected environment
-*
-* The server itself exposes the /.well-known/oauth-protected-resource endpoint.
-* The server itself exposes the /.well-known/oauth-authorization-server endpoint.
-*/
+/** Standalone protected environment: the server itself exposes both the /.well-known/oauth-protected-resource and /.well-known/oauth-authorization-server endpoints. */
 const standaloneEnvironmentSchema = z.object({
 	allowsAnonymous: z.boolean(),
 	oAuthMetadata: z.object({
@@ -322,13 +332,7 @@ const standaloneEnvironmentSchema = z.object({
 	}),
 	scope: z.string().optional()
 });
-/**
-* Protected environment without OAuth discovery
-*
-* The server enforces authentication but exposes no OAuth discovery metadata.
-* Neither /.well-known/oauth-protected-resource nor /.well-known/oauth-authorization-server
-* are advertised. Clients must obtain credentials out-of-band.
-*/
+/** Protected environment that enforces authentication but advertises no OAuth discovery metadata; clients must obtain credentials out-of-band. */
 const protectedWithoutDiscoveryEnvironmentSchema = z.object({
 	allowsAnonymous: z.literal(false),
 	oAuthMetadata: z.strictObject({}),
@@ -376,7 +380,6 @@ z.union([
 	legacyStandaloneEnvironmentSchema,
 	legacyProtectedWithoutDiscoveryEnvironmentSchema
 ]);
-const allowedPlatformSchema = platformSchema;
 const playgroundModelSchema = z.enum([
 	"global.anthropic.claude-haiku-4-5-20251001-v1:0",
 	"global.anthropic.claude-sonnet-4-5-20250929-v1:0",
@@ -416,14 +419,16 @@ z.object({
 	collectRequestPayload: z.boolean(),
 	collectResponsePayload: z.boolean(),
 	collectErrorMessage: z.boolean(),
-	collectUserData: z.boolean()
+	collectUserData: z.boolean(),
+	identityTraitKey: z.string().min(1).max(200).nullable()
 });
-z.object({
+const feedbackSchema = z.object({
 	id: z.string(),
 	createdAt: z.coerce.date(),
 	environmentId: z.string(),
 	content: z.string(),
-	source: z.enum(["model", "user"])
+	source: z.enum(["model", "user"]),
+	clientName: z.string().nullable()
 });
 z.object({
 	content: z.string(),
@@ -439,7 +444,7 @@ const intentCategoryColorSchema = z.enum([
 	"pink",
 	"gray"
 ]);
-intentCategoryColorSchema.options;
+const INTENT_CATEGORY_COLORS = intentCategoryColorSchema.options;
 const intentCategorySchema = z.object({
 	id: z.string(),
 	createdAt: z.coerce.date(),
@@ -447,7 +452,7 @@ const intentCategorySchema = z.object({
 	name: z.string(),
 	color: intentCategoryColorSchema
 });
-z.object({
+const intentCategorySummarySchema = z.object({
 	id: z.string(),
 	name: z.string(),
 	color: intentCategoryColorSchema,
@@ -459,6 +464,7 @@ z.object({
 	environmentId: z.string(),
 	toolName: z.string(),
 	message: z.string(),
+	clientName: z.string().nullable(),
 	categories: z.array(intentCategorySchema)
 });
 const signalCategorySchema = z.object({
@@ -523,6 +529,246 @@ z.enum([
 	"DEBUG",
 	"ERROR"
 ]);
+/** Only names a vendor actually ships belong here: lookalikes like `claude-code-test` are customers' own scripts. */
+const MCP_CLIENT_GROUPS = [
+	{
+		id: "claude_code",
+		label: "Claude Code",
+		vendor: "anthropic",
+		rawNames: ["claude-code", "Anthropic/ClaudeCodeDesktop"]
+	},
+	{
+		id: "claude",
+		label: "Claude",
+		vendor: "anthropic",
+		rawNames: [
+			"Anthropic/ClaudeAI",
+			"claude-ai",
+			"claude",
+			"Claude",
+			"claude-desktop",
+			"claude-desktop-3p"
+		]
+	},
+	{
+		id: "claude_mobile",
+		label: "Claude mobile",
+		vendor: "anthropic",
+		rawNames: ["claude-ios", "ClaudeAndroid"]
+	},
+	{
+		id: "claude_cowork",
+		label: "Claude Cowork",
+		vendor: "anthropic",
+		rawNames: ["Anthropic/Cowork"]
+	},
+	{
+		id: "claude_toolbox",
+		label: "Claude Toolbox",
+		vendor: "anthropic",
+		rawNames: ["Anthropic/Toolbox", "Anthropic/toolbox-bootstrap"]
+	},
+	{
+		id: "anthropic_api",
+		label: "Anthropic API",
+		vendor: "anthropic",
+		rawNames: ["Anthropic/API"]
+	},
+	{
+		id: "anthropic_connector_refresh",
+		label: "Anthropic (connector refresh)",
+		vendor: "anthropic",
+		rawNames: ["Anthropic"]
+	},
+	{
+		id: "codex",
+		label: "Codex",
+		vendor: "openai",
+		rawNames: [
+			"codex-mcp-client",
+			"codex",
+			"Codex",
+			"codex-cli",
+			"openai-mcp (Codex)"
+		]
+	},
+	{
+		id: "chatgpt",
+		label: "ChatGPT",
+		vendor: "openai",
+		rawNames: ["openai-mcp (ChatGPT)"]
+	},
+	{
+		id: "openai_responses_api",
+		label: "OpenAI Responses API",
+		vendor: "openai",
+		rawNames: ["openai-mcp (Responses API)"]
+	},
+	{
+		id: "openai_agent_builder",
+		label: "OpenAI Agent Builder",
+		vendor: "openai",
+		rawNames: ["openai-mcp (Agent Builder)"]
+	},
+	{
+		id: "openai_other",
+		label: "OpenAI Other",
+		vendor: "openai",
+		rawNames: ["openai-mcp"]
+	},
+	{
+		id: "cursor",
+		label: "Cursor",
+		vendor: "cursor",
+		rawNames: [
+			"cursor-vscode",
+			"Cursor",
+			"cursor"
+		]
+	},
+	{
+		id: "cline",
+		label: "Cline",
+		vendor: "cline",
+		rawNames: [
+			"Cline",
+			"cline",
+			"@cline/core"
+		]
+	},
+	{
+		id: "github_copilot",
+		label: "GitHub Copilot",
+		vendor: "githubCopilot",
+		rawNames: [
+			"Copilot",
+			"github-copilot-developer",
+			"Copilot MCP Gateway",
+			"Xcode/copilot-xcode"
+		]
+	},
+	{
+		id: "gemini_cli",
+		label: "Gemini CLI",
+		vendor: "google",
+		rawNames: ["gemini-cli-mcp-client", "gemini-cli"]
+	},
+	{
+		id: "antigravity",
+		label: "Antigravity",
+		vendor: "google",
+		rawNames: ["antigravity-client"]
+	},
+	{
+		id: "gemini",
+		label: "Gemini",
+		vendor: "google",
+		rawNames: ["Gemini", "google-ai-edge-gallery"]
+	},
+	{
+		id: "windsurf",
+		label: "Windsurf",
+		vendor: "windsurf",
+		rawNames: ["Windsurf", "windsurf-client"]
+	},
+	{
+		id: "mistral",
+		label: "Mistral / Le Chat",
+		vendor: "mistral",
+		rawNames: ["Mistral"],
+		rawNamePrefixes: ["connector:custom-mcp:"]
+	},
+	{
+		id: "n8n",
+		label: "n8n",
+		vendor: "n8n",
+		rawNames: [
+			"@n8n/n8n-nodes-langchain.mcpClient",
+			"@n8n/n8n-nodes-langchain.mcpClientTool",
+			"n8n"
+		]
+	},
+	{
+		id: "alpic_playground",
+		label: "Alpic Playground",
+		vendor: "alpic",
+		rawNames: ["alpic-playground", "playground"]
+	},
+	{
+		id: "opencode",
+		label: "opencode",
+		vendor: "opencode",
+		rawNames: ["opencode"]
+	},
+	{
+		id: "zed",
+		label: "Zed",
+		vendor: "zed",
+		rawNames: ["Zed", "zed"]
+	},
+	{
+		id: "zapier",
+		label: "Zapier",
+		vendor: "zapier",
+		rawNames: ["Zapier", "zapier"]
+	},
+	{
+		id: "make",
+		label: "Make",
+		vendor: "make",
+		rawNames: ["Make", "make"]
+	},
+	{
+		id: "librechat",
+		label: "LibreChat",
+		vendor: "mcp",
+		rawNames: ["LibreChat", "librechat"]
+	},
+	{
+		id: "jan",
+		label: "Jan",
+		vendor: "mcp",
+		rawNames: ["Jan", "jan"]
+	},
+	{
+		id: "goose",
+		label: "goose",
+		vendor: "mcp",
+		rawNames: ["goose", "Goose"]
+	},
+	{
+		id: "mcphost",
+		label: "mcphost",
+		vendor: "mcp",
+		rawNames: ["mcphost"]
+	},
+	{
+		id: "mcporter",
+		label: "mcporter",
+		vendor: "mcp",
+		rawNames: ["mcporter"]
+	},
+	{
+		id: "rmcp",
+		label: "rmcp",
+		vendor: "mcp",
+		rawNames: ["rmcp"]
+	},
+	{
+		id: "unnamed_client",
+		label: "Unnamed client",
+		vendor: "mcp",
+		rawNames: [
+			"mcp",
+			"unknown",
+			""
+		]
+	}
+];
+/** A source pattern, not a RegExp, because analytics renders the same rule into ClickHouse RE2, which shares this syntax. */
+const MCP_REMOTE_WRAPPER_SUFFIX = String.raw` \(via mcp-remote [^\n]+?\)$`;
+new RegExp(MCP_REMOTE_WRAPPER_SUFFIX);
+new Map(MCP_CLIENT_GROUPS.map((group) => [group.id, group]));
 const runtimeSchema = z.enum([
 	"python3.13",
 	"python3.14",
@@ -600,15 +846,7 @@ z.object({
 	serverFields: serverFieldsSchema$1,
 	source: z.enum(["registry", "defaults"])
 });
-/**
-* Returns a variant of a `maxLength`-constrained string that clamps (truncates) instead of
-* rejecting on overflow — used for AI-generated copy where the model routinely overshoots.
-*
-* NOTE: this rebuilds the schema from scratch, carrying over only `maxLength` (as a clamp),
-* `minLength`, and the description. Any other validators on the source field (`.regex()`,
-* `.email()`, custom refinements) are intentionally dropped — this helper is meant for plain
-* free-text length caps only. A field with `null` `maxLength` is returned unchanged.
-*/
+/** 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. */
 const clampStringField = (field) => {
 	const max = field.maxLength;
 	if (max === null) return field;
@@ -954,11 +1192,7 @@ const chatgptToolJustificationSchema = z.object({
 	openWorldJustification: z.string().describe("One sentence on whether the tool reaches external systems beyond your own service."),
 	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.\"")
 }).describe("Per-tool justification of each MCP annotation value (one specific sentence per hint).");
-/**
-* Base copy fields, defined once and reused by both the submission form and per-locale
-* translations so the constraints (tagline ≤ 30 chars) never drift. The translation generation
-* path wraps these in {@link clampStringField} since the LLM tends to overshoot the limit.
-*/
+/** Defined once and reused by both the submission form and per-locale translations so the tagline ≤ 30 chars constraint never drifts. */
 const chatgptTaglineSchema = z.string().max(30);
 const chatgptDescriptionSchema = z.string();
 const chatgptTranslationSchema = z.object({
@@ -967,10 +1201,7 @@ const chatgptTranslationSchema = z.object({
 	description: chatgptDescriptionSchema
 }).describe("Locale-scoped override for tagline + description. English (US) is the default.");
 chatgptTranslationSchema.extend({ tagline: clampStringField(chatgptTaglineSchema) });
-/**
-* Field order mirrors the ChatGPT (OpenAI) submission spreadsheet, grouped by section.
-* When adding/removing/reordering fields, keep this in sync with the sheet.
-*/
+/** Field order mirrors the ChatGPT (OpenAI) submission spreadsheet, grouped by section; keep it in sync with the sheet. */
 const chatgptSubmissionFormDataSchema = z.object({
 	logoLight: z.string().describe("Logo icon for light mode. Square PNG, no borders or rounded corners (clients apply circular cropping)."),
 	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."),
@@ -1067,11 +1298,7 @@ const claudePolicyAcknowledgementSchema = z.enum([
 	"My connector does not collect conversation data beyond what is needed for its function.",
 	"Public documentation for this connector will be live by the publish date."
 ]);
-/**
-* Field order mirrors the claude.ai directory submission wizard
-* (`claude.ai/admin-settings/directory/submissions/new`), grouped by step.
-* When adding/removing/reordering fields, keep this in sync with the wizard.
-*/
+/** 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. */
 const claudeSubmissionFormDataSchema = z.object({
 	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
 from the custom connector you select — the connection is used to verify the URL and the tool list at submission time.
@@ -1163,12 +1390,7 @@ claudeSubmissionFormDataSchema.pick({
 	connectionRequirements: claudeSubmissionFormDataSchema.shape.connectionRequirements.optional(),
 	testInstructions: claudeSubmissionFormDataSchema.shape.testInstructions.optional()
 });
-/**
-* Narrative fields the LLM-backed generation step produces for Claude submissions.
-* This schema accepts the slightly loose shape returned by AI generation, then normalizes it into
-* the strict form shape. Keep transforms here rather than in callers so generation leniency is
-* colocated with the Claude contract.
-*/
+/** Loose shape returned by AI generation for Claude narrative fields; transforms live here so generation leniency stays colocated with the Claude contract. */
 const claudeAiGeneratedFormDataRawSchema = z.object({
 	oneLiner: claudeSubmissionFormDataSchema.shape.oneLiner,
 	description: claudeSubmissionFormDataSchema.shape.description,
@@ -1196,6 +1418,11 @@ const chatgptSubmissionSchemaInternal = submissionMetaFieldsSchema.extend({
 });
 z.discriminatedUnion("platform", [claudeSubmissionSchemaInternal, chatgptSubmissionSchemaInternal]);
 z.union([claudeSubmissionDraftSchema, chatgptSubmissionDraftSchema]);
+z.literal([
+	100,
+	75,
+	50
+]);
 const subscriptionPlanSchema = z.enum([
 	"pro",
 	"business",
@@ -1260,7 +1487,10 @@ const RESERVED_KEYS = [
 	"BUILD_ARG_START_COMMAND",
 	"ALPIC_HOST",
 	"ALPIC_CUSTOM_DOMAINS",
-	"ALPIC_INTENT_META_KEY"
+	"ALPIC_INTENT_META_KEY",
+	"ALPIC_FEEDBACK_META_KEY",
+	"ALPIC_EVENTS_META_KEY",
+	"ALPIC_IDENTIFY_META_KEY"
 ];
 const environmentVariableSchema = z.object({
 	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"),
@@ -1341,21 +1571,20 @@ const deploymentSchema = z.object({
 	isCurrent: z.boolean(),
 	deploymentPageUrl: z.url().nullable()
 });
-const isValidLogTimeInput = (value) => {
+const isValidTimeInput = (value) => {
 	if (ms(value) !== void 0) return true;
 	return !Number.isNaN(new Date(value).getTime());
 };
-const createEnvironmentContractV1 = oc.route({
+const timeInputSchema = z.string().refine(isValidTimeInput, { message: "Invalid time. Use relative (1h, 30m, 2d) or ISO 8601 format." });
+const base = oc.errors({ BAD_REQUEST: {} });
+const createEnvironmentContractV1 = base.route({
 	path: "/v1/environments",
 	method: "POST",
 	summary: "Create an environment",
 	description: "Create an environment for a project",
 	tags: ["environments"],
 	successDescription: "The environment has been created successfully"
-}).errors({
-	NOT_FOUND: {},
-	BAD_REQUEST: {}
-}).input(z.object({
+}).errors({ NOT_FOUND: {} }).input(z.object({
 	projectId: z.string().describe("The ID of the project to create the environment for"),
 	name: z.string().min(1).describe("The name of the environment"),
 	sourceBranch: z.string().min(1).describe("The branch used to build the environment"),
@@ -1368,7 +1597,7 @@ const createEnvironmentContractV1 = oc.route({
 	createdAt: z.coerce.date(),
 	projectId: z.string().describe("The ID of the project the environment belongs to")
 }));
-const getEnvironmentContractV1 = oc.route({
+const getEnvironmentContractV1 = base.route({
 	path: "/v1/environments/{environmentId}",
 	method: "GET",
 	summary: "Get an environment",
@@ -1425,7 +1654,7 @@ const projectOutputSchema = z.object({
 	productionEnvironment: productionEnvironmentSchema.nullable(),
 	environments: z.array(environmentSchema)
 });
-const getProjectContractV1 = oc.route({
+const getProjectContractV1 = base.route({
 	path: "/v1/projects/{projectId}",
 	method: "GET",
 	summary: "Get a project",
@@ -1433,18 +1662,15 @@ const getProjectContractV1 = oc.route({
 	tags: ["projects"],
 	successDescription: "The project details"
 }).errors({ NOT_FOUND: {} }).input(z.object({ projectId: z.string().describe("The ID of the project") })).output(projectOutputSchema);
-const listProjectsContractV1 = oc.route({
+const listProjectsContractV1 = base.route({
 	path: "/v1/projects",
 	method: "GET",
 	summary: "List projects",
 	description: "List all projects for a team",
 	tags: ["projects"],
 	successDescription: "The list of projects"
-}).errors({
-	NOT_FOUND: {},
-	BAD_REQUEST: {}
-}).input(z.object({ teamId: z.string().optional() }).optional()).output(z.array(projectOutputSchema));
-const createProjectContractV1 = oc.route({
+}).errors({ NOT_FOUND: {} }).input(z.object({ teamId: z.string().optional() }).optional()).output(z.array(projectOutputSchema));
+const createProjectContractV1 = base.route({
 	path: "/v1/projects",
 	method: "POST",
 	summary: "Create a project",
@@ -1453,7 +1679,6 @@ const createProjectContractV1 = oc.route({
 	successDescription: "The project has been created successfully"
 }).errors({
 	NOT_FOUND: {},
-	BAD_REQUEST: {},
 	FORBIDDEN: {}
 }).input(z.object({
 	teamId: z.string().optional(),
@@ -1494,7 +1719,7 @@ const environmentVariableOutputSchema = z.object({
 	isSecret: z.boolean(),
 	createdAt: z.coerce.date()
 });
-const listEnvironmentVariablesContractV1 = oc.route({
+const listEnvironmentVariablesContractV1 = base.route({
 	path: "/v1/environments/{environmentId}/environment-variables",
 	method: "GET",
 	summary: "List environment variables",
@@ -1502,48 +1727,39 @@ const listEnvironmentVariablesContractV1 = oc.route({
 	tags: ["environments"],
 	successDescription: "The list of environment variables"
 }).errors({ NOT_FOUND: {} }).input(z.object({ environmentId: z.string().describe("The ID of the environment") })).output(z.array(environmentVariableOutputSchema));
-const createEnvironmentVariablesContractV1 = oc.route({
+const createEnvironmentVariablesContractV1 = base.route({
 	path: "/v1/environments/{environmentId}/environment-variables",
 	method: "POST",
 	summary: "Add environment variables",
 	description: "Add one or more environment variables to an environment",
 	tags: ["environments"],
 	successDescription: "The environment variables have been added successfully"
-}).errors({
-	NOT_FOUND: {},
-	BAD_REQUEST: {}
-}).input(z.object({
+}).errors({ NOT_FOUND: {} }).input(z.object({
 	environmentId: z.string().describe("The ID of the environment"),
 	environmentVariables: environmentVariablesSchema
 })).output(z.object({ success: z.literal(true) }));
-const updateEnvironmentVariableContractV1 = oc.route({
+const updateEnvironmentVariableContractV1 = base.route({
 	path: "/v1/environment-variables/{environmentVariableId}",
 	method: "PATCH",
 	summary: "Update an environment variable",
 	description: "Update an environment variable by ID",
 	tags: ["environments"],
 	successDescription: "The environment variable has been updated successfully"
-}).errors({
-	NOT_FOUND: {},
-	BAD_REQUEST: {}
-}).input(z.object({
+}).errors({ NOT_FOUND: {} }).input(z.object({
 	environmentVariableId: z.string().describe("The ID of the environment variable"),
 	key: environmentVariableSchema.shape.key,
 	value: environmentVariableSchema.shape.value.optional(),
 	isSecret: environmentVariableSchema.shape.isSecret.optional()
 })).output(z.object({ success: z.literal(true) }));
-const deleteEnvironmentVariableContractV1 = oc.route({
+const deleteEnvironmentVariableContractV1 = base.route({
 	path: "/v1/environment-variables/{environmentVariableId}",
 	method: "DELETE",
 	summary: "Delete an environment variable",
 	description: "Delete an environment variable by ID",
 	tags: ["environments"],
 	successDescription: "The environment variable has been deleted successfully"
-}).errors({
-	NOT_FOUND: {},
-	BAD_REQUEST: {}
-}).input(z.object({ environmentVariableId: z.string().describe("The ID of the environment variable") })).output(z.object({ success: z.literal(true) }));
-const deleteProjectContractV1 = oc.route({
+}).errors({ NOT_FOUND: {} }).input(z.object({ environmentVariableId: z.string().describe("The ID of the environment variable") })).output(z.object({ success: z.literal(true) }));
+const deleteProjectContractV1 = base.route({
 	path: "/v1/projects/{projectId}",
 	method: "DELETE",
 	summary: "Delete a project",
@@ -1551,7 +1767,7 @@ const deleteProjectContractV1 = oc.route({
 	tags: ["projects"],
 	successDescription: "The project has been deleted successfully"
 }).errors({ NOT_FOUND: {} }).input(z.object({ projectId: z.string().describe("The ID of the project") })).output(z.object({ success: z.literal(true) }));
-const updateProjectContractV1 = oc.route({
+const updateProjectContractV1 = base.route({
 	path: "/v1/projects/{projectId}",
 	method: "PATCH",
 	summary: "Update a project",
@@ -1560,14 +1776,13 @@ const updateProjectContractV1 = oc.route({
 	successDescription: "The project has been updated successfully"
 }).errors({
 	NOT_FOUND: {},
-	BAD_REQUEST: {},
 	FORBIDDEN: {}
 }).input(z.object({
 	projectId: z.string().describe("The ID of the project"),
 	name: z.string().min(1).max(100).optional().describe("The new name for the project"),
 	sourceRepository: z.string().nullable().optional().describe("The source repository to connect to the project")
 })).output(projectOutputSchema);
-const deployEnvironmentContractV1 = oc.route({
+const deployEnvironmentContractV1 = base.route({
 	path: "/v1/environments/{environmentId}/deploy",
 	method: "POST",
 	summary: "Deploy an environment",
@@ -1576,28 +1791,25 @@ const deployEnvironmentContractV1 = oc.route({
 	successDescription: "The environment has been deployed successfully"
 }).errors({
 	NOT_FOUND: {},
-	BAD_REQUEST: {}
+	CONFLICT: {}
 }).input(z.object({
 	environmentId: z.string().describe("The ID of the environment to deploy"),
 	token: z.string().describe("The token to identify the source archive").optional(),
 	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.")
 })).output(deploymentSchema);
-const uploadDeploymentArtifactContractV1 = oc.route({
+const uploadDeploymentArtifactContractV1 = base.route({
 	path: "/v1/deployments/upload",
 	method: "POST",
 	summary: "Upload deployment artifacts",
 	description: "Return a presigned S3 URL to upload a deployment artifact",
 	tags: ["deployments"],
 	successDescription: "The presigned upload URL has been generated successfully"
-}).errors({
-	NOT_FOUND: {},
-	BAD_REQUEST: {}
-}).input(z.object({ teamId: z.string().optional() }).optional()).output(z.object({
+}).errors({ NOT_FOUND: {} }).input(z.object({ teamId: z.string().optional() }).optional()).output(z.object({
 	uploadUrl: z.url().describe("Presigned S3 URL to upload the source archive with HTTP PUT"),
 	token: z.string().describe("Token to identify the source archive"),
 	expiresAt: z.coerce.date().describe("Expiration date of the presigned URL")
 }));
-const listDeploymentsContractV1 = oc.route({
+const listDeploymentsContractV1 = base.route({
 	path: "/v1/projects/{projectId}/deployments",
 	method: "GET",
 	summary: "List project deployments",
@@ -1609,7 +1821,7 @@ const listDeploymentsContractV1 = oc.route({
 	status: z.array(deploymentStatusSchema).optional().describe("Filter by one or more statuses"),
 	environmentId: z.string().optional().describe("Filter by environment ID")
 })).output(z.array(deploymentSchema));
-const getDeploymentContractV1 = oc.route({
+const getDeploymentContractV1 = base.route({
 	path: "/v1/deployments/{deploymentId}",
 	method: "GET",
 	summary: "Get a deployment",
@@ -1632,20 +1844,17 @@ const logEntrySchema = z.object({
 	method: z.string().optional(),
 	durationInMs: z.number().optional()
 });
-const getLogsContractV1 = oc.route({
+const getLogsContractV1 = base.route({
 	path: "/v1/environments/{environmentId}/logs",
 	method: "GET",
 	summary: "Get logs",
 	description: "Get logs for an environment",
 	tags: ["environments"],
 	successDescription: "The logs"
-}).errors({
-	NOT_FOUND: {},
-	BAD_REQUEST: {}
-}).input(z.object({
+}).errors({ NOT_FOUND: {} }).input(z.object({
 	environmentId: z.string().describe("The ID of the environment"),
-	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)"),
-	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"),
+	since: timeInputSchema.optional().describe("Start time — ISO 8601 (2024-01-01T00:00:00Z) or relative (1h, 30m, 2d)"),
+	until: timeInputSchema.optional().describe("End time — ISO 8601 or relative"),
 	limit: z.coerce.number().int().min(1).max(1e3).default(1e3).describe("Maximum number of log entries to return."),
 	level: z.array(z.enum([
 		"INFO",
@@ -1659,17 +1868,14 @@ const getLogsContractV1 = oc.route({
 	logs: z.array(logEntrySchema),
 	nextToken: z.string().nullable()
 }));
-const getLatestLogsContractV1 = oc.route({
+const getLatestLogsContractV1 = base.route({
 	path: "/v1/environments/{environmentId}/latest-logs",
 	method: "GET",
 	summary: "Get latest logs",
 	description: "Get the N most recent logs for an environment",
 	tags: ["environments"],
 	successDescription: "The latest logs"
-}).errors({
-	NOT_FOUND: {},
-	BAD_REQUEST: {}
-}).input(z.object({
+}).errors({ NOT_FOUND: {} }).input(z.object({
 	environmentId: z.string().describe("The ID of the environment"),
 	limit: z.coerce.number().int().min(1).max(1e3).default(100).describe("Number of most recent log entries to return"),
 	level: z.array(z.enum([
@@ -1680,7 +1886,7 @@ const getLatestLogsContractV1 = oc.route({
 	])).optional().describe("Filter by log level"),
 	search: z.string().optional().describe("Filter pattern to search for in log content")
 })).output(z.object({ logs: z.array(logEntrySchema) }));
-const getDeploymentLogsContractV1 = oc.route({
+const getDeploymentLogsContractV1 = base.route({
 	path: "/v1/deployments/{deploymentId}/logs",
 	method: "GET",
 	summary: "Get deployment logs",
@@ -1707,17 +1913,14 @@ const analyticsTimeSeriesSchema = z.object({
 	output_token_mean: z.array(analyticsDataPointSchema),
 	task_count: z.array(analyticsDataPointSchema)
 });
-const getProjectAnalyticsContractV1 = oc.route({
+const getProjectAnalyticsContractV1 = base.route({
 	path: "/v1/analytics/{projectId}",
 	method: "GET",
 	summary: "Get project analytics",
 	description: "Get analytics data for a project over a time range",
 	tags: ["analytics"],
 	successDescription: "The project analytics data"
-}).errors({
-	NOT_FOUND: {},
-	BAD_REQUEST: {}
-}).input(z.object({
+}).errors({ NOT_FOUND: {} }).input(z.object({
 	projectId: z.string().describe("The ID of the project"),
 	startTimestamp: z.coerce.number().describe("Start timestamp in milliseconds"),
 	endTimestamp: z.coerce.number().describe("End timestamp in milliseconds"),
@@ -1732,7 +1935,132 @@ const getProjectAnalyticsContractV1 = oc.route({
 	}),
 	timeSeries: analyticsTimeSeriesSchema
 }));
-const listTeamsContractV1 = oc.route({
+const paginatedInsightsInputShape = {
+	environmentId: z.string().describe("The ID of the environment"),
+	since: timeInputSchema.default("7d").describe("Start time — ISO 8601 (2024-01-01T00:00:00Z) or relative (1h, 30m, 2d)"),
+	until: timeInputSchema.optional().describe("End time — ISO 8601 or relative"),
+	limit: z.coerce.number().int().min(1).max(200).default(50),
+	offset: z.coerce.number().int().min(0).default(0),
+	search: z.string().trim().min(1).max(200).optional()
+};
+const listIntentsContractV1 = base.route({
+	path: "/v1/environments/{environmentId}/intents",
+	method: "GET",
+	summary: "List intents",
+	description: "List grouped user intents for an environment over a time range",
+	tags: ["insights"],
+	successDescription: "The grouped user intents"
+}).errors({ NOT_FOUND: {} }).input(z.object({
+	...paginatedInsightsInputShape,
+	tools: z.array(z.string().trim().min(1)).min(1).max(100).optional(),
+	clientIds: z.array(z.string().min(1)).min(1).max(100).optional(),
+	categoryIds: z.array(z.string().trim().min(1)).min(1).max(100).optional(),
+	sortDir: z.enum(["asc", "desc"]).default("desc")
+})).output(z.object({
+	intents: z.array(z.object({
+		id: z.string(),
+		intentIds: z.array(z.string()).min(1),
+		environmentId: z.string(),
+		message: z.string(),
+		toolName: z.string(),
+		createdAt: z.coerce.date(),
+		occurrenceCount: z.number().int().positive(),
+		clientName: z.string().nullable(),
+		clientId: z.string().nullable(),
+		categories: z.array(z.object({
+			id: z.string(),
+			name: z.string(),
+			color: intentCategoryColorSchema
+		}))
+	})),
+	totalCount: z.number().int().nonnegative()
+}));
+const listFeedbacksContractV1 = base.route({
+	path: "/v1/environments/{environmentId}/feedbacks",
+	method: "GET",
+	summary: "List feedbacks",
+	description: "List user feedback for an environment over a time range",
+	tags: ["insights"],
+	successDescription: "The user feedback"
+}).errors({ NOT_FOUND: {} }).input(z.object({
+	...paginatedInsightsInputShape,
+	clientIds: z.array(z.string().min(1)).min(1).max(100).optional()
+})).output(z.object({
+	feedbacks: z.array(feedbackSchema.extend({ clientId: z.string().nullable() })),
+	totalCount: z.number().int().nonnegative()
+}));
+const intentCategoryNameSchema = z.string().trim().min(1).max(100).describe("The category name");
+const categorizableIntentIdsSchema = z.array(z.string().trim().min(1)).min(1).max(100).describe("IDs of the intents to categorize");
+const listIntentCategoriesContractV1 = base.route({
+	path: "/v1/environments/{environmentId}/intent-categories",
+	method: "GET",
+	summary: "List intent categories",
+	description: "List intent categories for an environment, including how many intents each category is linked to",
+	tags: ["insights"],
+	successDescription: "The intent categories"
+}).errors({ NOT_FOUND: {} }).input(z.object({ environmentId: z.string().describe("The ID of the environment") })).output(z.array(intentCategorySummarySchema));
+const createIntentCategoryContractV1 = base.route({
+	path: "/v1/environments/{environmentId}/intent-categories",
+	method: "POST",
+	summary: "Create an intent category",
+	description: "Create an intent category, optionally linking it to existing intents",
+	tags: ["insights"],
+	successDescription: "The created intent category"
+}).errors({ NOT_FOUND: {} }).input(z.object({
+	environmentId: z.string().describe("The ID of the environment"),
+	name: intentCategoryNameSchema,
+	color: intentCategoryColorSchema.optional().describe("The category color; derived from the name when omitted"),
+	intentIds: categorizableIntentIdsSchema.optional().describe("IDs of intents to link to the new category")
+})).output(intentCategorySchema);
+const updateIntentCategoryContractV1 = base.route({
+	path: "/v1/environments/{environmentId}/intent-categories/{categoryId}",
+	method: "PATCH",
+	summary: "Update an intent category",
+	description: "Rename or recolor an intent category",
+	tags: ["insights"],
+	successDescription: "The updated intent category"
+}).errors({ NOT_FOUND: {} }).input(z.object({
+	environmentId: z.string().describe("The ID of the environment"),
+	categoryId: z.string().describe("The ID of the category"),
+	name: intentCategoryNameSchema.optional(),
+	color: intentCategoryColorSchema.optional().describe("The category color")
+}).refine(({ name, color }) => name !== void 0 || color !== void 0, { message: "At least one of name or color must be provided" })).output(intentCategorySchema);
+const deleteIntentCategoryContractV1 = base.route({
+	path: "/v1/environments/{environmentId}/intent-categories/{categoryId}",
+	method: "DELETE",
+	summary: "Delete an intent category",
+	description: "Delete an intent category; its intents are unlinked but not deleted",
+	tags: ["insights"],
+	successDescription: "The intent category has been deleted successfully"
+}).errors({ NOT_FOUND: {} }).input(z.object({
+	environmentId: z.string().describe("The ID of the environment"),
+	categoryId: z.string().describe("The ID of the category")
+})).output(z.object({ success: z.literal(true) }));
+const linkIntentCategoryContractV1 = base.route({
+	path: "/v1/environments/{environmentId}/intent-categories/{categoryId}/link",
+	method: "POST",
+	summary: "Link an intent category",
+	description: "Link an intent category to intents; already linked intents are ignored",
+	tags: ["insights"],
+	successDescription: "The intents have been linked successfully"
+}).errors({ NOT_FOUND: {} }).input(z.object({
+	environmentId: z.string().describe("The ID of the environment"),
+	categoryId: z.string().describe("The ID of the category"),
+	intentIds: categorizableIntentIdsSchema
+})).output(z.object({ success: z.literal(true) }));
+const unlinkIntentCategoryContractV1 = base.route({
+	path: "/v1/environments/{environmentId}/intent-categories/{categoryId}/unlink",
+	method: "POST",
+	summary: "Unlink an intent category",
+	description: "Unlink an intent category from intents; intents without the category are ignored",
+	tags: ["insights"],
+	successDescription: "The intents have been unlinked successfully"
+}).errors({ NOT_FOUND: {} }).input(z.object({
+	environmentId: z.string().describe("The ID of the environment"),
+	categoryId: z.string().describe("The ID of the category"),
+	intentIds: categorizableIntentIdsSchema
+})).output(z.object({ success: z.literal(true) }));
+const listTeamsContractV1 = base.route({
 	path: "/v1/teams",
 	method: "GET",
 	summary: "List teams",
@@ -1745,7 +2073,22 @@ const listTeamsContractV1 = oc.route({
 	createdAt: z.coerce.date(),
 	hasStripeAccount: z.boolean()
 })));
-const getTunnelTicketContractV1 = oc.route({
+const getTeamUsageContractV1 = base.route({
+	path: "/v1/teams/{teamId}/usage",
+	method: "GET",
+	summary: "Get team usage",
+	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.",
+	tags: ["teams"],
+	successDescription: "The current billing window usage"
+}).errors({ NOT_FOUND: {} }).input(z.object({ teamId: z.string().describe("The ID of the team") })).output(z.object({
+	teamId: z.string(),
+	plan: subscriptionPlanSchema.nullable().describe("The plan in force for the window, null on the Free plan"),
+	periodStart: z.coerce.date().describe("Start of the current billing window"),
+	periodEnd: z.coerce.date().describe("End of the current billing window"),
+	requestCount: z.number().int().describe("MCP requests settled during the current billing window"),
+	includedRequests: z.number().int().nullable().describe("Requests included in the plan for one window, null when the allowance is contract-specific")
+}));
+const getTunnelTicketContractV1 = base.route({
 	path: "/v1/tunnels/ticket",
 	method: "GET",
 	summary: "Get a tunnel ticket",
@@ -1757,16 +2100,13 @@ const getTunnelTicketContractV1 = oc.route({
 	ticket: z.string().describe("The signed tunnel ticket"),
 	tunnelHost: z.string().describe("The tunnel host to connect to")
 }));
-const publishServerContractV1 = oc.route({
+const publishServerContractV1 = base.route({
 	path: "/v1/distribution/publish",
 	method: "POST",
 	summary: "Publish a server to the MCP registry",
 	tags: ["distribution"],
 	successDescription: "The server has been published successfully"
-}).errors({
-	NOT_FOUND: {},
-	BAD_REQUEST: {}
-}).input(z.object({
+}).errors({ NOT_FOUND: {} }).input(z.object({
 	projectId: z.string(),
 	domain: z.string(),
 	title: z.string().min(1).max(100),
@@ -1775,17 +2115,14 @@ const publishServerContractV1 = oc.route({
 	iconSrc: z.url().max(255).optional(),
 	dryRun: z.boolean().optional()
 })).output(z.object({ serverFields: serverFieldsSchema }));
-const getServerInfoContractV1 = oc.route({
+const getServerInfoContractV1 = base.route({
 	path: "/v1/distribution/get",
 	method: "GET",
 	summary: "Get server info",
 	description: "Get info about a server",
 	tags: ["distribution"],
 	successDescription: "The server info"
-}).errors({
-	NOT_FOUND: {},
-	BAD_REQUEST: {}
-}).input(z.object({
+}).errors({ NOT_FOUND: {} }).input(z.object({
 	projectId: z.string(),
 	domain: z.string()
 })).output(z.object({ serverFields: serverFieldsSchema }));
@@ -1804,7 +2141,7 @@ const playgroundOutputSchema = z.object({
 	isPlaygroundEnabled: z.boolean(),
 	serverMetadata: playgroundServerMetadataOutputSchema.nullable()
 });
-const getPlaygroundContractV1 = oc.route({
+const getPlaygroundContractV1 = base.route({
 	path: "/v1/environments/{environmentId}/playground",
 	method: "GET",
 	summary: "Get playground configuration",
@@ -1812,17 +2149,14 @@ const getPlaygroundContractV1 = oc.route({
 	tags: ["environments"],
 	successDescription: "The playground configuration"
 }).errors({ NOT_FOUND: {} }).input(z.object({ environmentId: z.string().describe("The ID of the environment") })).output(playgroundOutputSchema);
-const upsertPlaygroundContractV1 = oc.route({
+const upsertPlaygroundContractV1 = base.route({
 	path: "/v1/environments/{environmentId}/playground",
 	method: "PUT",
 	summary: "Update playground configuration",
 	description: "Update the playground configuration for an environment. All fields are optional — only provided fields are updated.",
 	tags: ["environments"],
 	successDescription: "The updated playground configuration"
-}).errors({
-	NOT_FOUND: {},
-	BAD_REQUEST: {}
-}).input(z.object({
+}).errors({ NOT_FOUND: {} }).input(z.object({
 	environmentId: z.string().describe("The ID of the environment"),
 	isPlaygroundEnabled: z.boolean().optional(),
 	name: z.string().min(1).max(100).optional(),
@@ -1830,7 +2164,7 @@ const upsertPlaygroundContractV1 = oc.route({
 	headers: z.array(playgroundHeaderSchema).optional(),
 	examplePrompts: z.array(playgroundExamplePromptSchema).max(5).optional()
 })).output(playgroundOutputSchema);
-const createBeaconContractV1 = oc.route({
+const createBeaconContractV1 = base.route({
 	path: "/v1/beacon/audits",
 	method: "POST",
 	summary: "Create a beacon audit",
@@ -1839,7 +2173,6 @@ const createBeaconContractV1 = oc.route({
 	successDescription: "The audit has been created"
 }).errors({
 	NOT_FOUND: {},
-	BAD_REQUEST: {},
 	DNS_RESOLUTION_FAILED: { status: 400 }
 }).input(z.object({
 	targetUrl: z.url().describe("The HTTPS URL of the MCP server to audit"),
@@ -1847,7 +2180,7 @@ const createBeaconContractV1 = oc.route({
 	projectId: z.string().optional().describe("The project ID to associate the audit with"),
 	excludeCategories: z.array(checkCategorySchema).optional().describe("Check categories to exclude from the audit")
 })).output(z.object({ id: z.string() }));
-const getBeaconContractV1 = oc.route({
+const getBeaconContractV1 = base.route({
 	path: "/v1/beacon/audits/{auditId}",
 	method: "GET",
 	summary: "Get a beacon audit",
@@ -1863,8 +2196,21 @@ const getBeaconContractV1 = oc.route({
 	report: auditReportWithScreenshotsSchema.nullable()
 }));
 const contract = {
-	teams: { list: { v1: listTeamsContractV1 } },
+	teams: {
+		list: { v1: listTeamsContractV1 },
+		getUsage: { v1: getTeamUsageContractV1 }
+	},
 	analytics: { get: { v1: getProjectAnalyticsContractV1 } },
+	intents: { list: { v1: listIntentsContractV1 } },
+	intentCategories: {
+		list: { v1: listIntentCategoriesContractV1 },
+		create: { v1: createIntentCategoryContractV1 },
+		update: { v1: updateIntentCategoryContractV1 },
+		delete: { v1: deleteIntentCategoryContractV1 },
+		link: { v1: linkIntentCategoryContractV1 },
+		unlink: { v1: unlinkIntentCategoryContractV1 }
+	},
+	feedbacks: { list: { v1: listFeedbacksContractV1 } },
 	deployments: {
 		list: { v1: listDeploymentsContractV1 },
 		get: { v1: getDeploymentContractV1 },
@@ -1905,5 +2251,10 @@ const contract = {
 		get: { v1: getBeaconContractV1 }
 	}
 };
+const { uploadArtifact: _discard, ...deploymentsForDocs } = contract.deployments;
+const contractForDocs = {
+	...contract,
+	deployments: deploymentsForDocs
+};
 //#endregion
-export { AUTH_SCOPE_ANY, AUTH_SCOPE_USER, PLATFORM_LABELS, buildSettingsSchema, contract, createEnvironmentContractV1, deploymentStatusSchema, environmentVariableSchema, environmentVariablesSchema, playgroundExamplePromptSchema, playgroundHeaderSchema, runtimeSchema, serverFieldsSchema, transportSchema, updateEnvironmentVariableSchema };
+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 };