@alpic-ai/api 1.165.0 → 1.166.0

package/dist/index.d.mts

@@ -47,6 +47,26 @@ declare const contract: {
         BAD_REQUEST: {};
       }>, Record<never, never>>;
     };
+    getUsage: {
+      v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        teamId: z.ZodString;
+      }, z.core.$strip>, z.ZodObject<{
+        teamId: z.ZodString;
+        plan: z.ZodNullable<z.ZodEnum<{
+          pro: "pro";
+          business: "business";
+          enterprise: "enterprise";
+        }>>;
+        periodStart: z.ZodCoercedDate<unknown>;
+        periodEnd: z.ZodCoercedDate<unknown>;
+        requestCount: z.ZodNumber;
+        includedRequests: z.ZodNullable<z.ZodNumber>;
+      }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        BAD_REQUEST: {};
+      }>, {
+        NOT_FOUND: {};
+      }>, Record<never, never>>;
+    };
   };
   analytics: {
     get: {
@@ -100,6 +120,87 @@ 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>>;
+    };
+  };
+  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<{
@@ -1079,6 +1180,26 @@ declare const contractForDocs: {
         BAD_REQUEST: {};
       }>, Record<never, never>>;
     };
+    getUsage: {
+      v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        teamId: z.ZodString;
+      }, z.core.$strip>, z.ZodObject<{
+        teamId: z.ZodString;
+        plan: z.ZodNullable<z.ZodEnum<{
+          pro: "pro";
+          business: "business";
+          enterprise: "enterprise";
+        }>>;
+        periodStart: z.ZodCoercedDate<unknown>;
+        periodEnd: z.ZodCoercedDate<unknown>;
+        requestCount: z.ZodNumber;
+        includedRequests: z.ZodNullable<z.ZodNumber>;
+      }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        BAD_REQUEST: {};
+      }>, {
+        NOT_FOUND: {};
+      }>, Record<never, never>>;
+    };
   };
   analytics: {
     get: {
@@ -1132,6 +1253,87 @@ 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>>;
+    };
+  };
+  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<{

package/dist/index.mjs

@@ -402,7 +402,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(),
@@ -1398,6 +1398,17 @@ 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,
+	50
+]);
 const subscriptionPlanSchema = z.enum([
 	"pro",
 	"business",
@@ -1415,6 +1426,7 @@ const customerUsageSchema = z.object({
 	periodEnd: z.number()
 });
 const partnerDiscountSchema = z.object({ endsAt: z.number() });
+z.object({ balanceInNanoUSD: z.number() });
 z.object({
 	customerCredits: customerCreditsSchema.nullable(),
 	customerUsage: customerUsageSchema.nullable(),
@@ -1546,10 +1558,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",
@@ -1827,8 +1840,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",
@@ -1909,6 +1922,60 @@ 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 listTeamsContractV1 = base.route({
 	path: "/v1/teams",
 	method: "GET",
@@ -1922,6 +1989,21 @@ const listTeamsContractV1 = base.route({
 	createdAt: z.coerce.date(),
 	hasStripeAccount: z.boolean()
 })));
+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",
@@ -2030,8 +2112,13 @@ const getBeaconContractV1 = base.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 } },
+	feedbacks: { list: { v1: listFeedbacksContractV1 } },
 	deployments: {
 		list: { v1: listDeploymentsContractV1 },
 		get: { v1: getDeploymentContractV1 },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alpic-ai/api",
-  "version": "1.165.0",
+  "version": "1.166.0",
   "description": "Contract for the Alpic API",
   "type": "module",
   "main": "./dist/index.mjs",