@alpic-ai/api 0.0.0-dev.gf80bbbb → 0.0.0-dev.gf881e70

package/dist/index.d.mts

@@ -170,6 +170,141 @@ declare const contract: {
       }>, Record<never, never>>;
     };
   };
+  intentCategories: {
+    list: {
+      v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        environmentId: z.ZodString;
+      }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        color: z.ZodEnum<{
+          red: "red";
+          orange: "orange";
+          yellow: "yellow";
+          green: "green";
+          blue: "blue";
+          purple: "purple";
+          pink: "pink";
+          gray: "gray";
+        }>;
+        intentCount: z.ZodNumber;
+      }, z.core.$strip>>, import("@orpc/contract").MergedErrorMap<import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        BAD_REQUEST: {};
+      }>, {
+        NOT_FOUND: {};
+      }>, Record<never, never>>;
+    };
+    create: {
+      v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        environmentId: z.ZodString;
+        name: z.ZodString;
+        color: z.ZodOptional<z.ZodEnum<{
+          red: "red";
+          orange: "orange";
+          yellow: "yellow";
+          green: "green";
+          blue: "blue";
+          purple: "purple";
+          pink: "pink";
+          gray: "gray";
+        }>>;
+        intentIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        createdAt: z.ZodCoercedDate<unknown>;
+        environmentId: z.ZodString;
+        name: z.ZodString;
+        color: z.ZodEnum<{
+          red: "red";
+          orange: "orange";
+          yellow: "yellow";
+          green: "green";
+          blue: "blue";
+          purple: "purple";
+          pink: "pink";
+          gray: "gray";
+        }>;
+      }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        BAD_REQUEST: {};
+      }>, {
+        NOT_FOUND: {};
+      }>, Record<never, never>>;
+    };
+    update: {
+      v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        environmentId: z.ZodString;
+        categoryId: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        color: z.ZodOptional<z.ZodEnum<{
+          red: "red";
+          orange: "orange";
+          yellow: "yellow";
+          green: "green";
+          blue: "blue";
+          purple: "purple";
+          pink: "pink";
+          gray: "gray";
+        }>>;
+      }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        createdAt: z.ZodCoercedDate<unknown>;
+        environmentId: z.ZodString;
+        name: z.ZodString;
+        color: z.ZodEnum<{
+          red: "red";
+          orange: "orange";
+          yellow: "yellow";
+          green: "green";
+          blue: "blue";
+          purple: "purple";
+          pink: "pink";
+          gray: "gray";
+        }>;
+      }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        BAD_REQUEST: {};
+      }>, {
+        NOT_FOUND: {};
+      }>, Record<never, never>>;
+    };
+    delete: {
+      v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        environmentId: z.ZodString;
+        categoryId: z.ZodString;
+      }, z.core.$strip>, z.ZodObject<{
+        success: z.ZodLiteral<true>;
+      }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        BAD_REQUEST: {};
+      }>, {
+        NOT_FOUND: {};
+      }>, Record<never, never>>;
+    };
+    link: {
+      v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        environmentId: z.ZodString;
+        categoryId: z.ZodString;
+        intentIds: z.ZodArray<z.ZodString>;
+      }, z.core.$strip>, z.ZodObject<{
+        success: z.ZodLiteral<true>;
+      }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        BAD_REQUEST: {};
+      }>, {
+        NOT_FOUND: {};
+      }>, Record<never, never>>;
+    };
+    unlink: {
+      v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        environmentId: z.ZodString;
+        categoryId: z.ZodString;
+        intentIds: z.ZodArray<z.ZodString>;
+      }, z.core.$strip>, z.ZodObject<{
+        success: z.ZodLiteral<true>;
+      }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        BAD_REQUEST: {};
+      }>, {
+        NOT_FOUND: {};
+      }>, Record<never, never>>;
+    };
+  };
   feedbacks: {
     list: {
       v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
@@ -187,8 +322,8 @@ declare const contract: {
           environmentId: z.ZodString;
           content: z.ZodString;
           source: z.ZodEnum<{
-            model: "model";
             user: "user";
+            model: "model";
           }>;
           clientName: z.ZodNullable<z.ZodString>;
           clientId: z.ZodNullable<z.ZodString>;
@@ -335,6 +470,17 @@ declare const contract: {
         NOT_FOUND: {};
       }>, Record<never, never>>;
     };
+    delete: {
+      v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        environmentId: z.ZodString;
+      }, z.core.$strip>, z.ZodObject<{
+        success: z.ZodLiteral<true>;
+      }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        BAD_REQUEST: {};
+      }>, {
+        NOT_FOUND: {};
+      }>, Record<never, never>>;
+    };
     deploy: {
       v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
         environmentId: z.ZodString;
@@ -1303,6 +1449,141 @@ declare const contractForDocs: {
       }>, Record<never, never>>;
     };
   };
+  intentCategories: {
+    list: {
+      v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        environmentId: z.ZodString;
+      }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        color: z.ZodEnum<{
+          red: "red";
+          orange: "orange";
+          yellow: "yellow";
+          green: "green";
+          blue: "blue";
+          purple: "purple";
+          pink: "pink";
+          gray: "gray";
+        }>;
+        intentCount: z.ZodNumber;
+      }, z.core.$strip>>, import("@orpc/contract").MergedErrorMap<import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        BAD_REQUEST: {};
+      }>, {
+        NOT_FOUND: {};
+      }>, Record<never, never>>;
+    };
+    create: {
+      v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        environmentId: z.ZodString;
+        name: z.ZodString;
+        color: z.ZodOptional<z.ZodEnum<{
+          red: "red";
+          orange: "orange";
+          yellow: "yellow";
+          green: "green";
+          blue: "blue";
+          purple: "purple";
+          pink: "pink";
+          gray: "gray";
+        }>>;
+        intentIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        createdAt: z.ZodCoercedDate<unknown>;
+        environmentId: z.ZodString;
+        name: z.ZodString;
+        color: z.ZodEnum<{
+          red: "red";
+          orange: "orange";
+          yellow: "yellow";
+          green: "green";
+          blue: "blue";
+          purple: "purple";
+          pink: "pink";
+          gray: "gray";
+        }>;
+      }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        BAD_REQUEST: {};
+      }>, {
+        NOT_FOUND: {};
+      }>, Record<never, never>>;
+    };
+    update: {
+      v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        environmentId: z.ZodString;
+        categoryId: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        color: z.ZodOptional<z.ZodEnum<{
+          red: "red";
+          orange: "orange";
+          yellow: "yellow";
+          green: "green";
+          blue: "blue";
+          purple: "purple";
+          pink: "pink";
+          gray: "gray";
+        }>>;
+      }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        createdAt: z.ZodCoercedDate<unknown>;
+        environmentId: z.ZodString;
+        name: z.ZodString;
+        color: z.ZodEnum<{
+          red: "red";
+          orange: "orange";
+          yellow: "yellow";
+          green: "green";
+          blue: "blue";
+          purple: "purple";
+          pink: "pink";
+          gray: "gray";
+        }>;
+      }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        BAD_REQUEST: {};
+      }>, {
+        NOT_FOUND: {};
+      }>, Record<never, never>>;
+    };
+    delete: {
+      v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        environmentId: z.ZodString;
+        categoryId: z.ZodString;
+      }, z.core.$strip>, z.ZodObject<{
+        success: z.ZodLiteral<true>;
+      }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        BAD_REQUEST: {};
+      }>, {
+        NOT_FOUND: {};
+      }>, Record<never, never>>;
+    };
+    link: {
+      v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        environmentId: z.ZodString;
+        categoryId: z.ZodString;
+        intentIds: z.ZodArray<z.ZodString>;
+      }, z.core.$strip>, z.ZodObject<{
+        success: z.ZodLiteral<true>;
+      }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        BAD_REQUEST: {};
+      }>, {
+        NOT_FOUND: {};
+      }>, Record<never, never>>;
+    };
+    unlink: {
+      v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        environmentId: z.ZodString;
+        categoryId: z.ZodString;
+        intentIds: z.ZodArray<z.ZodString>;
+      }, z.core.$strip>, z.ZodObject<{
+        success: z.ZodLiteral<true>;
+      }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        BAD_REQUEST: {};
+      }>, {
+        NOT_FOUND: {};
+      }>, Record<never, never>>;
+    };
+  };
   feedbacks: {
     list: {
       v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
@@ -1320,8 +1601,8 @@ declare const contractForDocs: {
           environmentId: z.ZodString;
           content: z.ZodString;
           source: z.ZodEnum<{
-            model: "model";
             user: "user";
+            model: "model";
           }>;
           clientName: z.ZodNullable<z.ZodString>;
           clientId: z.ZodNullable<z.ZodString>;
@@ -1375,6 +1656,17 @@ declare const contractForDocs: {
         NOT_FOUND: {};
       }>, Record<never, never>>;
     };
+    delete: {
+      v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        environmentId: z.ZodString;
+      }, z.core.$strip>, z.ZodObject<{
+        success: z.ZodLiteral<true>;
+      }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        BAD_REQUEST: {};
+      }>, {
+        NOT_FOUND: {};
+      }>, Record<never, never>>;
+    };
     deploy: {
       v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
         environmentId: z.ZodString;
@@ -2142,6 +2434,20 @@ type RouteAuthMeta = {
   authScope?: AuthScope;
 };
 //#endregion
+//#region ../domains/src/intents/schemas.d.ts
+declare const intentCategoryColorSchema: z.ZodEnum<{
+  red: "red";
+  orange: "orange";
+  yellow: "yellow";
+  green: "green";
+  blue: "blue";
+  purple: "purple";
+  pink: "pink";
+  gray: "gray";
+}>;
+type IntentCategoryColor = z.infer<typeof intentCategoryColorSchema>;
+declare const INTENT_CATEGORY_COLORS: ("red" | "orange" | "yellow" | "green" | "blue" | "purple" | "pink" | "gray")[];
+//#endregion
 //#region ../domains/src/platforms/schemas.d.ts
 declare const platformSchema: z.ZodEnum<{
   chatgpt: "chatgpt";
@@ -2221,4 +2527,4 @@ declare const serverFieldsSchema: z.ZodObject<{
   }, z.core.$strip>>>;
 }, z.core.$strip>;
 //#endregion
-export { AUTH_SCOPE_ANY, AUTH_SCOPE_USER, ApiContext, AuthScope, PLATFORM_LABELS, type Platform, RouteAuthMeta, RouterInput, RouterOutput, Runtime, Transport, buildSettingsSchema, contract, contractForDocs, createEnvironmentContractV1, deploymentStatusSchema, environmentVariableSchema, environmentVariablesSchema, playgroundExamplePromptSchema, playgroundHeaderSchema, runtimeSchema, serverFieldsSchema, transportSchema, updateEnvironmentVariableSchema };
+export { AUTH_SCOPE_ANY, AUTH_SCOPE_USER, ApiContext, AuthScope, INTENT_CATEGORY_COLORS, type IntentCategoryColor, PLATFORM_LABELS, type Platform, RouteAuthMeta, RouterInput, RouterOutput, Runtime, Transport, buildSettingsSchema, contract, contractForDocs, createEnvironmentContractV1, deploymentStatusSchema, environmentVariableSchema, environmentVariablesSchema, intentCategoryColorSchema, playgroundExamplePromptSchema, playgroundHeaderSchema, runtimeSchema, serverFieldsSchema, transportSchema, updateEnvironmentVariableSchema };

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.30.0_supports-color@7.2.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.5.4/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/auth.js
 /**
 * Reusable URL validation that disallows javascript: scheme
 */
@@ -179,6 +179,7 @@ const PLATFORM_LABELS = {
 };
 const WAF_PLATFORMS = [
 	"akamai",
+	"cato",
 	"cloudflare",
 	"fastly"
 ];
@@ -256,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",
@@ -424,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(),
@@ -432,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,
@@ -503,6 +523,16 @@ z.object({
 	createdAt: z.coerce.date(),
 	updatedAt: z.coerce.date()
 });
+const alpicMcpRequestLogSchema = z.object({
+	type: z.literal("mcp_request"),
+	method: z.string()
+});
+const alpicMcpErrorLogSchema = z.object({
+	type: z.literal("mcp_error"),
+	method: z.string(),
+	error: z.string()
+});
+z.union([alpicMcpRequestLogSchema, alpicMcpErrorLogSchema]);
 z.enum([
 	"INFO",
 	"WARNING",
@@ -1398,12 +1428,6 @@ const chatgptSubmissionSchemaInternal = submissionMetaFieldsSchema.extend({
 });
 z.discriminatedUnion("platform", [claudeSubmissionSchemaInternal, chatgptSubmissionSchemaInternal]);
 z.union([claudeSubmissionDraftSchema, chatgptSubmissionDraftSchema]);
-({
-	free: 1e4,
-	pro: 2e5,
-	business: 2e6,
-	enterprise: null
-}).free;
 z.literal([
 	100,
 	75,
@@ -1420,18 +1444,70 @@ const customerCreditsSchema = z.object({
 	expiresAt: z.number().nullable(),
 	currency: z.string()
 });
-const customerUsageSchema = z.object({
-	amountInCents: z.number(),
-	currency: z.string(),
-	periodEnd: z.number()
-});
 const partnerDiscountSchema = z.object({ endsAt: z.number() });
-z.object({ balanceInNanoUSD: z.number() });
 z.object({
 	customerCredits: customerCreditsSchema.nullable(),
-	customerUsage: customerUsageSchema.nullable(),
 	partnerDiscount: partnerDiscountSchema.nullable()
 });
+const metricsQueueEventSchema = z.object({
+	ts: z.number().int(),
+	method: z.string(),
+	tool: z.string().nullable(),
+	client: z.string(),
+	sessionId: z.string().nullable(),
+	durationMs: z.number().int(),
+	outputTokens: z.number().int().nullable(),
+	errorType: z.enum([
+		"mcp_error",
+		"tool_error",
+		"timeout"
+	]).nullable(),
+	errorCode: z.number().int().nullable()
+});
+z.object({
+	v: z.literal(1),
+	envId: z.string(),
+	events: z.array(metricsQueueEventSchema)
+});
+z.object({ v: z.number() });
+const telemetrySignalSchema = z.enum([
+	"logs",
+	"metrics",
+	"traces"
+]);
+const otlpProtocolSchema = z.enum(["http/protobuf", "http/json"]);
+const otlpEndpointSchema = z.string().trim().min(1).max(2048);
+const OTLP_HEADER_VALUE_MAX_LENGTH = 2048;
+const otlpHeaderNameSchema = z.string().trim().min(1, "Enter a header name").max(128).regex(/^[A-Za-z0-9!#$%&'*+\-.^_`|~]+$/, "Use letters, digits and !#$%&'*+-.^_`|~ only");
+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");
+const telemetryDestinationHeaderSchema = z.object({
+	id: z.string(),
+	name: otlpHeaderNameSchema,
+	value: otlpHeaderValueSchema,
+	isSecret: z.boolean()
+});
+const otlpPushFailureReasonSchema = z.enum([
+	"credentials",
+	"wrong-path",
+	"wrong-protocol",
+	"invalid-payload",
+	"partial-rejection",
+	"blocked-target",
+	"timeout",
+	"unreachable",
+	"receiver-error",
+	"unexpected-status"
+]);
+const telemetryDestinationStatusSchema = z.enum(["active", "suspended"]);
+z.object({
+	id: z.string(),
+	signal: telemetrySignalSchema,
+	endpoint: otlpEndpointSchema,
+	protocol: otlpProtocolSchema,
+	headers: z.array(telemetryDestinationHeaderSchema),
+	status: telemetryDestinationStatusSchema,
+	lastFailureReason: otlpPushFailureReasonSchema.nullable()
+});
 //#endregion
 //#region src/auth-scope.ts
 /** Accepts an API key or OAuth access token (default for most routes). */
@@ -1530,6 +1606,14 @@ const serverFieldsSchema = z.object({
 });
 //#endregion
 //#region src/api.contract.ts
+const isValidIanaTimeZone = (timeZone) => {
+	try {
+		new Intl.DateTimeFormat("en-US", { timeZone });
+		return true;
+	} catch {
+		return false;
+	}
+};
 const deploymentStatusSchema = z.enum([
 	"ongoing",
 	"deployed",
@@ -1600,6 +1684,14 @@ const getEnvironmentContractV1 = base.route({
 	createdAt: z.coerce.date(),
 	projectId: z.string()
 }));
+const deleteEnvironmentContractV1 = base.route({
+	path: "/v1/environments/{environmentId}",
+	method: "DELETE",
+	summary: "Delete an environment",
+	description: "All environments can be deleted except the production environment. This operation is not reversible: associated logs, analytics, and metrics are deleted as well.",
+	tags: ["environments"],
+	successDescription: "The environment has been deleted successfully"
+}).errors({ NOT_FOUND: {} }).input(z.object({ environmentId: z.string().describe("The ID of the environment") })).output(z.object({ success: z.literal(true) }));
 const domainSchema = z.object({
 	domain: z.string(),
 	status: z.enum([
@@ -1912,7 +2004,7 @@ const getProjectAnalyticsContractV1 = base.route({
 	startTimestamp: z.coerce.number().describe("Start timestamp in milliseconds"),
 	endTimestamp: z.coerce.number().describe("End timestamp in milliseconds"),
 	timeZone: z.string().describe("IANA timezone (e.g. Europe/Paris)")
-}).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({
+}).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 }) => isValidIanaTimeZone(timeZone), { message: "Time zone must be a valid IANA timezone" })).output(z.object({
 	metadata: z.object({
 		startTimestamp: z.number(),
 		endTimestamp: z.number(),
@@ -1976,6 +2068,77 @@ const listFeedbacksContractV1 = base.route({
 	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",
@@ -2118,6 +2281,14 @@ const contract = {
 	},
 	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 },
@@ -2128,6 +2299,7 @@ const contract = {
 	environments: {
 		create: { v1: createEnvironmentContractV1 },
 		get: { v1: getEnvironmentContractV1 },
+		delete: { v1: deleteEnvironmentContractV1 },
 		deploy: { v1: deployEnvironmentContractV1 },
 		getLogs: { v1: getLogsContractV1 },
 		getLatestLogs: { v1: getLatestLogsContractV1 }
@@ -2165,4 +2337,4 @@ const contractForDocs = {
 	deployments: deploymentsForDocs
 };
 //#endregion
-export { AUTH_SCOPE_ANY, AUTH_SCOPE_USER, PLATFORM_LABELS, buildSettingsSchema, contract, contractForDocs, 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 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alpic-ai/api",
-  "version": "0.0.0-dev.gf80bbbb",
+  "version": "0.0.0-dev.gf881e70",
   "description": "Contract for the Alpic API",
   "type": "module",
   "main": "./dist/index.mjs",
@@ -35,9 +35,10 @@
   "dependencies": {
     "@orpc/contract": "^1.15.0",
     "ms": "^2.1.3",
-    "zod": "^4.4.3"
+    "zod": "^4.5.4"
   },
   "devDependencies": {
+    "@alpic-ai/domains": "0.0.0",
     "@orpc/openapi": "^1.15.0",
     "@orpc/zod": "^1.15.0",
     "@total-typescript/tsconfig": "^1.0.4",
@@ -45,8 +46,7 @@
     "shx": "^0.4.0",
     "tsdown": "^0.22.14",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.10",
-    "@alpic-ai/domains": "0.0.0"
+    "vitest": "^4.1.11"
   },
   "scripts": {
     "build": "shx rm -rf dist && tsdown",