@alpic-ai/api 0.0.0-dev.gdf1c8f7 → 0.0.0-dev.gdf3c3a5

package/dist/index.d.mts

@@ -322,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>;
@@ -470,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;
@@ -1590,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>;
@@ -1645,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;

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",
@@ -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",
@@ -834,6 +864,10 @@ const clampStringField = (field) => {
 	const withMin = field.minLength === null ? clamped : clamped.min(field.minLength);
 	return field.description ? withMin.describe(field.description) : withMin;
 };
+const unboundedArrayField = (field) => {
+	const unbounded = z.array(field.element);
+	return field.description ? unbounded.describe(field.description) : unbounded;
+};
 const toolDefinitionSchema = z.object({
 	name: z.string(),
 	title: z.string().optional().describe("Human-friendly name for the tool, used in the UI. If not provided, `name` will be used."),
@@ -846,11 +880,19 @@ const toolDefinitionSchema = z.object({
 	}).optional()
 });
 const positiveTestCaseSchema = z.object({
-	scenario: z.string().describe("Short label for what this case demonstrates."),
-	userPrompt: z.string().describe("A realistic, standalone user message a reviewer can paste and run with no prior state or multi-turn setup. Vary phrasing and tone across cases."),
+	scenario: z.string().min(1).describe("Short label for what this case demonstrates."),
+	userPrompt: z.string().min(1).describe("A realistic, standalone user message a reviewer can paste and run with no prior state or multi-turn setup. Vary phrasing and tone across cases."),
 	toolTriggered: z.string().optional().describe("The tool this prompt should invoke."),
 	expectedOutput: z.string().optional().describe("What the user should see, including post-interaction behaviour where relevant.")
-}).partial().describe("Each case: Scenario, User prompt, Tool triggered, Expected output.");
+}).describe("Each case: Scenario, User prompt, Tool triggered, Expected output.");
+const positiveTestCaseDraftSchema = positiveTestCaseSchema.partial();
+const blankPositiveTestCase = () => ({
+	scenario: "",
+	userPrompt: "",
+	toolTriggered: "",
+	expectedOutput: ""
+});
+const toFixedLength = (entries, length, blank) => Array.from({ length }, (_, index) => entries[index] ?? blank());
 const screenshotEntrySchema = z.object({
 	prompt: z.string(),
 	url: z.url()
@@ -1163,9 +1205,14 @@ const chatgptTranslationLocaleSchema = z.enum([
 	"zh-TW"
 ]);
 const negativeTestCaseSchema = z.object({
-	scenario: z.string(),
-	userPrompt: z.string()
-}).partial().describe("Each case: Scenario + User prompt (the app should NOT trigger).");
+	scenario: z.string().min(1),
+	userPrompt: z.string().min(1)
+}).describe("Each case: Scenario + User prompt (the app should NOT trigger).");
+const negativeTestCaseDraftSchema = negativeTestCaseSchema.partial();
+const blankNegativeTestCase = () => ({
+	scenario: "",
+	userPrompt: ""
+});
 const chatgptToolJustificationSchema = z.object({
 	toolName: z.string(),
 	readOnlyJustification: z.string().describe("One sentence on what the tool reads and returns."),
@@ -1200,8 +1247,8 @@ const chatgptSubmissionFormDataSchema = z.object({
 	authentication: chatgptAuthenticationSchema.describe("OAuth 2.0 or No auth. OAuth configuration is auto-discovered from the MCP server's metadata."),
 	tools: z.array(toolDefinitionSchema).describe("List of tools exposed by the MCP server (auto-populated from the production server's manifest)."),
 	toolJustifications: z.array(chatgptToolJustificationSchema).describe("Per-tool justification of `readOnlyHint`, `openWorldHint`, and `destructiveHint` annotation values. One short, specific sentence per hint describing what the tool actually does."),
-	testCases: z.array(positiveTestCaseSchema).describe("At least 5 positive test cases. Each: Scenario, User prompt, Tool triggered, Expected output. Collectively cover the full capability across different flow stages (initial search or browse, market or locale handling, post-interaction detail, an action ChatGPT performs on the user's behalf, and a conversion or secondary tool) rather than five variations of the same first step."),
-	negativeTestCases: z.array(negativeTestCaseSchema).describe("3 negative test cases: prompts where the app should NOT trigger but the model might think it is relevant. These become production routing metadata that teaches ChatGPT when to stay silent, so pick tight near-misses: a product category the app does not carry, the right brand or domain but an intent the app does not serve, or a boundary with a sibling app."),
+	testCases: z.array(positiveTestCaseSchema).length(5).describe("Exactly 5 positive test cases. Each: Scenario, User prompt, Tool triggered, Expected output. Collectively cover the full capability across different flow stages (initial search or browse, market or locale handling, post-interaction detail, an action ChatGPT performs on the user's behalf, and a conversion or secondary tool) rather than five variations of the same first step."),
+	negativeTestCases: z.array(negativeTestCaseSchema).length(3).describe("Exactly 3 negative test cases: prompts where the app should NOT trigger but the model might think it is relevant. These become production routing metadata that teaches ChatGPT when to stay silent, so pick tight near-misses: a product category the app does not carry, the right brand or domain but an intent the app does not serve, or a boundary with a sibling app."),
 	screenshots: z.array(screenshotEntrySchema.extend({ prompt: z.string().max(75, { error: "Screenshot prompts are limited to 75 characters." }) })).max(3).describe("In-app screenshots paired with the user prompt that produced them (each prompt is 75 characters max). Widget apps must show the widget UI; non-widget apps show the model response. Min 1, max 3 entries, all public. Images: 706px wide, 400–860px tall, PNG."),
 	translations: z.array(chatgptTranslationSchema).describe("Per-locale translation of tagline + description. English (US) is the default."),
 	allowedCountries: chatgptAllowedCountriesSchema.describe("Availability: all supported countries, or an allow-list / block-list of specific ones (ISO alpha-2)."),
@@ -1216,23 +1263,34 @@ const chatgptSubmissionDraftSchema = chatgptSubmissionFormDataSchema.partial().e
 	demoRecordingUrl: z.string().optional(),
 	serverUrl: z.string().optional(),
 	screenshots: z.array(screenshotDraftEntrySchema).optional(),
+	testCases: z.array(positiveTestCaseDraftSchema).optional(),
+	negativeTestCases: z.array(negativeTestCaseDraftSchema).optional(),
 	translations: z.array(chatgptTranslationSchema.extend({ tagline: z.string() })).optional()
 });
-chatgptSubmissionFormDataSchema.pick({
+/** Source of truth for the fields `SubmissionPrefillService.prefill({ platform: "chatgpt" })` can populate. */
+const chatgptPrefillFormDataSchema = chatgptSubmissionFormDataSchema.pick({
 	appName: true,
 	developerName: true,
 	serverUrl: true,
 	tools: true,
 	authentication: true
 });
-chatgptSubmissionFormDataSchema.pick({
+/** Source of truth for `SubmissionPrefillService.generate({ platform: "chatgpt" })`. */
+const chatgptAiGeneratedFormDataSchema = chatgptSubmissionFormDataSchema.pick({
 	tagline: true,
 	description: true,
 	category: true,
 	testCases: true,
 	negativeTestCases: true,
 	toolJustifications: true
-}).extend({ tagline: clampStringField(chatgptSubmissionFormDataSchema.shape.tagline) });
+}).extend({
+	testCases: unboundedArrayField(chatgptSubmissionFormDataSchema.shape.testCases),
+	negativeTestCases: unboundedArrayField(chatgptSubmissionFormDataSchema.shape.negativeTestCases)
+}).extend({
+	tagline: clampStringField(chatgptSubmissionFormDataSchema.shape.tagline),
+	testCases: z.array(positiveTestCaseDraftSchema).transform((cases) => toFixedLength(cases, 5, blankPositiveTestCase)),
+	negativeTestCases: z.array(negativeTestCaseDraftSchema).transform((cases) => toFixedLength(cases, 3, blankNegativeTestCase))
+});
 const claudeCategorySchema = z.enum([
 	"Productivity",
 	"Communication",
@@ -1355,7 +1413,8 @@ const claudeSubmissionDraftSchema = claudeSubmissionFormDataSchema.partial().ext
 	categories: z.array(claudeCategorySchema).optional(),
 	screenshots: z.array(screenshotDraftEntrySchema).optional()
 });
-claudeSubmissionFormDataSchema.pick({
+/** Source of truth for the fields `SubmissionPrefillService.prefill({ platform: "claudeai" })` can populate. */
+const claudePrefillFormDataSchema = claudeSubmissionFormDataSchema.pick({
 	serverUrl: true,
 	name: true,
 	slug: true,
@@ -1377,10 +1436,17 @@ const claudeAiGeneratedFormDataRawSchema = z.object({
 	categories: z.array(claudeCategorySchema).describe(claudeCategoryDescription),
 	primaryUseCases: claudeSubmissionFormDataSchema.shape.primaryUseCases
 });
-claudeAiGeneratedFormDataRawSchema.extend({
+const claudeAiGeneratedFormDataSchema = claudeAiGeneratedFormDataRawSchema.extend({
 	oneLiner: clampStringField(claudeSubmissionFormDataSchema.shape.oneLiner),
 	categories: claudeAiGeneratedFormDataRawSchema.shape.categories.transform((categories) => categories.slice(0, 5))
 });
+function provenanceByField(prefillShape, aiGeneratedShape) {
+	const byField = {};
+	for (const field of Object.keys(prefillShape)) byField[field] = "prefilled";
+	for (const field of Object.keys(aiGeneratedShape)) byField[field] = "ai-generated";
+	return byField;
+}
+provenanceByField(claudePrefillFormDataSchema.shape, claudeAiGeneratedFormDataSchema.shape), provenanceByField(chatgptPrefillFormDataSchema.shape, chatgptAiGeneratedFormDataSchema.shape);
 const submissionMetaFieldsSchema = z.object({
 	id: z.string(),
 	environmentId: z.string(),
@@ -1390,20 +1456,16 @@ const submissionMetaFieldsSchema = z.object({
 });
 const claudeSubmissionSchemaInternal = submissionMetaFieldsSchema.extend({
 	platform: z.literal("claudeai"),
-	formData: claudeSubmissionDraftSchema
+	formData: claudeSubmissionDraftSchema,
+	prefillSnapshot: claudeSubmissionDraftSchema.nullable().default(null)
 });
 const chatgptSubmissionSchemaInternal = submissionMetaFieldsSchema.extend({
 	platform: z.literal("chatgpt"),
-	formData: chatgptSubmissionDraftSchema
+	formData: chatgptSubmissionDraftSchema,
+	prefillSnapshot: chatgptSubmissionDraftSchema.nullable().default(null)
 });
 z.discriminatedUnion("platform", [claudeSubmissionSchemaInternal, chatgptSubmissionSchemaInternal]);
 z.union([claudeSubmissionDraftSchema, chatgptSubmissionDraftSchema]);
-({
-	free: 1e4,
-	pro: 2e5,
-	business: 2e6,
-	enterprise: null
-}).free;
 z.literal([
 	100,
 	75,
@@ -1420,18 +1482,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 +1644,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 +1722,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 +2042,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(),
@@ -2207,6 +2337,7 @@ const contract = {
 	environments: {
 		create: { v1: createEnvironmentContractV1 },
 		get: { v1: getEnvironmentContractV1 },
+		delete: { v1: deleteEnvironmentContractV1 },
 		deploy: { v1: deployEnvironmentContractV1 },
 		getLogs: { v1: getLogsContractV1 },
 		getLatestLogs: { v1: getLatestLogsContractV1 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alpic-ai/api",
-  "version": "0.0.0-dev.gdf1c8f7",
+  "version": "0.0.0-dev.gdf3c3a5",
   "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",