@alpic-ai/api 0.0.0-staging.g8fe5ee0 → 0.0.0-staging.g9082982

package/dist/index.d.mts

@@ -120,6 +120,222 @@ declare const contract: {
       }>, Record<never, never>>;
     };
   };
+  intents: {
+    list: {
+      v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        clientIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        categoryIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        sortDir: z.ZodDefault<z.ZodEnum<{
+          asc: "asc";
+          desc: "desc";
+        }>>;
+        environmentId: z.ZodString;
+        since: z.ZodDefault<z.ZodString>;
+        until: z.ZodOptional<z.ZodString>;
+        limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+        offset: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+        search: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>, z.ZodObject<{
+        intents: z.ZodArray<z.ZodObject<{
+          id: z.ZodString;
+          intentIds: z.ZodArray<z.ZodString>;
+          environmentId: z.ZodString;
+          message: z.ZodString;
+          toolName: z.ZodString;
+          createdAt: z.ZodCoercedDate<unknown>;
+          occurrenceCount: z.ZodNumber;
+          clientName: z.ZodNullable<z.ZodString>;
+          clientId: z.ZodNullable<z.ZodString>;
+          categories: 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";
+            }>;
+          }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        totalCount: z.ZodNumber;
+      }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        BAD_REQUEST: {};
+      }>, {
+        NOT_FOUND: {};
+      }>, 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<{
+        clientIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        environmentId: z.ZodString;
+        since: z.ZodDefault<z.ZodString>;
+        until: z.ZodOptional<z.ZodString>;
+        limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+        offset: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+        search: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>, z.ZodObject<{
+        feedbacks: z.ZodArray<z.ZodObject<{
+          id: z.ZodString;
+          createdAt: z.ZodCoercedDate<unknown>;
+          environmentId: z.ZodString;
+          content: z.ZodString;
+          source: z.ZodEnum<{
+            model: "model";
+            user: "user";
+          }>;
+          clientName: z.ZodNullable<z.ZodString>;
+          clientId: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        totalCount: z.ZodNumber;
+      }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        BAD_REQUEST: {};
+      }>, {
+        NOT_FOUND: {};
+      }>, Record<never, never>>;
+    };
+  };
   deployments: {
     list: {
       v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
@@ -1172,6 +1388,222 @@ declare const contractForDocs: {
       }>, Record<never, never>>;
     };
   };
+  intents: {
+    list: {
+      v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        clientIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        categoryIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        sortDir: z.ZodDefault<z.ZodEnum<{
+          asc: "asc";
+          desc: "desc";
+        }>>;
+        environmentId: z.ZodString;
+        since: z.ZodDefault<z.ZodString>;
+        until: z.ZodOptional<z.ZodString>;
+        limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+        offset: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+        search: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>, z.ZodObject<{
+        intents: z.ZodArray<z.ZodObject<{
+          id: z.ZodString;
+          intentIds: z.ZodArray<z.ZodString>;
+          environmentId: z.ZodString;
+          message: z.ZodString;
+          toolName: z.ZodString;
+          createdAt: z.ZodCoercedDate<unknown>;
+          occurrenceCount: z.ZodNumber;
+          clientName: z.ZodNullable<z.ZodString>;
+          clientId: z.ZodNullable<z.ZodString>;
+          categories: 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";
+            }>;
+          }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        totalCount: z.ZodNumber;
+      }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        BAD_REQUEST: {};
+      }>, {
+        NOT_FOUND: {};
+      }>, 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<{
+        clientIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        environmentId: z.ZodString;
+        since: z.ZodDefault<z.ZodString>;
+        until: z.ZodOptional<z.ZodString>;
+        limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+        offset: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+        search: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>, z.ZodObject<{
+        feedbacks: z.ZodArray<z.ZodObject<{
+          id: z.ZodString;
+          createdAt: z.ZodCoercedDate<unknown>;
+          environmentId: z.ZodString;
+          content: z.ZodString;
+          source: z.ZodEnum<{
+            model: "model";
+            user: "user";
+          }>;
+          clientName: z.ZodNullable<z.ZodString>;
+          clientId: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        totalCount: z.ZodNumber;
+      }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        BAD_REQUEST: {};
+      }>, {
+        NOT_FOUND: {};
+      }>, Record<never, never>>;
+    };
+  };
   environments: {
     create: {
       v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
@@ -1980,6 +2412,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";
@@ -2059,4 +2505,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

@@ -256,6 +256,16 @@ z.object({
 	clientSecret: z.string(),
 	clientScopes: z.array(z.string())
 });
+z.enum([
+	"opening_balance",
+	"free_seed",
+	"paid_conversion_floor",
+	"top_up",
+	"usage",
+	"refund",
+	"admin_adjustment"
+]);
+z.enum(["playground"]);
 const deploymentStatusSchema$1 = z.enum([
 	"ongoing",
 	"deployed",
@@ -402,7 +412,7 @@ z.object({
 	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(),
@@ -424,7 +434,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 +442,7 @@ const intentCategorySchema = z.object({
 	name: z.string(),
 	color: intentCategoryColorSchema
 });
-z.object({
+const intentCategorySummarySchema = z.object({
 	id: z.string(),
 	name: z.string(),
 	color: intentCategoryColorSchema,
@@ -1398,12 +1408,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,
@@ -1558,10 +1562,11 @@ 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 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",
@@ -1839,8 +1844,8 @@ const getLogsContractV1 = base.route({
 	successDescription: "The logs"
 }).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",
@@ -1921,6 +1926,131 @@ const getProjectAnalyticsContractV1 = base.route({
 	}),
 	timeSeries: analyticsTimeSeriesSchema
 }));
+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",
@@ -2062,6 +2192,16 @@ const contract = {
 		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 },
@@ -2108,4 +2248,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-staging.g8fe5ee0",
+  "version": "0.0.0-staging.g9082982",
   "description": "Contract for the Alpic API",
   "type": "module",
   "main": "./dist/index.mjs",
@@ -55,6 +55,6 @@
     "test:unit": "vitest run",
     "test:format": "biome check --error-on-warnings .",
     "test:type": "tsgo --noEmit",
-    "publish:npm": "pnpm publish --tag \"${NPM_TAG}\" --access public --no-git-checks"
+    "publish:npm": "../../scripts/publish-if-new.sh"
   }
 }