@alpic-ai/api 0.0.0-staging.a0c1343 → 0.0.0-staging.a19b079

package/dist/index.d.mts

@@ -283,6 +283,38 @@ declare const contract: {
         BAD_REQUEST: {};
       }>, Record<never, never>>;
     };
+    getLatestLogs: {
+      v1: _$_orpc_contract0.ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        environmentId: z.ZodString;
+        limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+        level: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+          INFO: "INFO";
+          ERROR: "ERROR";
+          WARNING: "WARNING";
+          DEBUG: "DEBUG";
+        }>>>;
+        search: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>, z.ZodObject<{
+        logs: z.ZodArray<z.ZodObject<{
+          timestamp: z.ZodCoercedDate<unknown>;
+          type: z.ZodEnum<{
+            INFO: "INFO";
+            ERROR: "ERROR";
+            WARNING: "WARNING";
+            DEBUG: "DEBUG";
+            START: "START";
+            END: "END";
+          }>;
+          requestId: z.ZodString;
+          content: z.ZodOptional<z.ZodString>;
+          method: z.ZodOptional<z.ZodString>;
+          durationInMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+      }, z.core.$strip>, _$_orpc_contract0.MergedErrorMap<Record<never, never>, {
+        NOT_FOUND: {};
+        BAD_REQUEST: {};
+      }>, Record<never, never>>;
+    };
   };
   environmentVariables: {
     list: {
@@ -318,7 +350,7 @@ declare const contract: {
         environmentVariableId: z.ZodString;
         key: z.ZodString;
         value: z.ZodOptional<z.ZodString>;
-        isSecret: z.ZodDefault<z.ZodBoolean>;
+        isSecret: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
       }, z.core.$strip>, z.ZodObject<{
         success: z.ZodLiteral<true>;
       }, z.core.$strip>, _$_orpc_contract0.MergedErrorMap<Record<never, never>, {
@@ -637,6 +669,68 @@ declare const contract: {
       }>, Record<never, never>>;
     };
   };
+  playground: {
+    get: {
+      v1: _$_orpc_contract0.ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        environmentId: z.ZodString;
+      }, z.core.$strip>, z.ZodObject<{
+        isPlaygroundEnabled: z.ZodBoolean;
+        serverMetadata: z.ZodNullable<z.ZodObject<{
+          name: z.ZodString;
+          description: z.ZodString;
+          headers: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodString;
+            isRequired: z.ZodBoolean;
+            isSecret: z.ZodBoolean;
+          }, z.core.$strip>>;
+          examplePrompts: z.ZodArray<z.ZodObject<{
+            title: z.ZodString;
+            prompt: z.ZodString;
+          }, z.core.$strip>>;
+        }, z.core.$strip>>;
+      }, z.core.$strip>, _$_orpc_contract0.MergedErrorMap<Record<never, never>, {
+        NOT_FOUND: {};
+      }>, Record<never, never>>;
+    };
+    upsert: {
+      v1: _$_orpc_contract0.ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        environmentId: z.ZodString;
+        isPlaygroundEnabled: z.ZodOptional<z.ZodBoolean>;
+        name: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        headers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+          name: z.ZodString;
+          description: z.ZodString;
+          isRequired: z.ZodDefault<z.ZodBoolean>;
+          isSecret: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+        examplePrompts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+          title: z.ZodString;
+          prompt: z.ZodString;
+        }, z.core.$strip>>>;
+      }, z.core.$strip>, z.ZodObject<{
+        isPlaygroundEnabled: z.ZodBoolean;
+        serverMetadata: z.ZodNullable<z.ZodObject<{
+          name: z.ZodString;
+          description: z.ZodString;
+          headers: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodString;
+            isRequired: z.ZodBoolean;
+            isSecret: z.ZodBoolean;
+          }, z.core.$strip>>;
+          examplePrompts: z.ZodArray<z.ZodObject<{
+            title: z.ZodString;
+            prompt: z.ZodString;
+          }, z.core.$strip>>;
+        }, z.core.$strip>>;
+      }, z.core.$strip>, _$_orpc_contract0.MergedErrorMap<Record<never, never>, {
+        NOT_FOUND: {};
+        BAD_REQUEST: {};
+      }>, Record<never, never>>;
+    };
+  };
   tunnels: {
     getTicket: {
       v1: _$_orpc_contract0.ContractProcedureBuilderWithOutput<_$_orpc_contract0.Schema<unknown, unknown>, z.ZodObject<{
@@ -725,6 +819,13 @@ declare const contract: {
         targetUrl: z.ZodString;
         teamId: z.ZodOptional<z.ZodString>;
         projectId: z.ZodOptional<z.ZodString>;
+        excludeCategories: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+          connectivity: "connectivity";
+          "tool-metadata": "tool-metadata";
+          "resource-metadata": "resource-metadata";
+          performance: "performance";
+          e2e: "e2e";
+        }>>>;
       }, z.core.$strip>, z.ZodObject<{
         id: z.ZodString;
       }, z.core.$strip>, _$_orpc_contract0.MergedErrorMap<Record<never, never>, {
@@ -734,7 +835,7 @@ declare const contract: {
     };
     get: {
       v1: _$_orpc_contract0.ContractProcedureBuilderWithInputOutput<z.ZodObject<{
-        analysisId: z.ZodString;
+        auditId: z.ZodString;
       }, z.core.$strip>, z.ZodObject<{
         id: z.ZodString;
         targetUrl: z.ZodString;
@@ -755,6 +856,8 @@ declare const contract: {
           durationMs: z.ZodNumber;
           results: z.ZodArray<z.ZodObject<{
             checkId: z.ZodString;
+            checkName: z.ZodString;
+            description: z.ZodString;
             status: z.ZodEnum<{
               pending: "pending";
               pass: "pass";
@@ -835,6 +938,11 @@ declare const environmentVariablesSchema: z.ZodArray<z.ZodObject<{
   value: z.ZodString;
   isSecret: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>>;
+declare const updateEnvironmentVariableSchema: z.ZodObject<{
+  key: z.ZodString;
+  value: z.ZodOptional<z.ZodString>;
+  isSecret: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+}, z.core.$strip>;
 declare const buildSettingsSchema: z.ZodObject<{
   installCommand: z.ZodOptional<z.ZodString>;
   buildCommand: z.ZodOptional<z.ZodString>;
@@ -854,7 +962,7 @@ declare const transportSchema: z.ZodEnum<{
   streamablehttp: "streamablehttp";
 }>;
 type Transport = z.infer<typeof transportSchema>;
-declare const analysisStatusSchema: z.ZodEnum<{
+declare const auditStatusSchema: z.ZodEnum<{
   pending: "pending";
   partial: "partial";
   completed: "completed";
@@ -891,6 +999,8 @@ declare const checkDetailSchema: z.ZodObject<{
 type CheckDetail = z.infer<typeof checkDetailSchema>;
 declare const checkResultSchema: z.ZodObject<{
   checkId: z.ZodString;
+  checkName: z.ZodString;
+  description: z.ZodString;
   status: z.ZodEnum<{
     pending: "pending";
     pass: "pass";
@@ -938,6 +1048,8 @@ declare const auditReportSchema: z.ZodObject<{
   durationMs: z.ZodNumber;
   results: z.ZodArray<z.ZodObject<{
     checkId: z.ZodString;
+    checkName: z.ZodString;
+    description: z.ZodString;
     status: z.ZodEnum<{
       pending: "pending";
       pass: "pass";
@@ -999,6 +1111,16 @@ declare const auditReportSchema: z.ZodObject<{
   }, z.core.$strip>>;
 }, z.core.$strip>;
 type AuditReport = z.infer<typeof auditReportSchema>;
+declare const playgroundHeaderSchema: z.ZodObject<{
+  name: z.ZodString;
+  description: z.ZodString;
+  isRequired: z.ZodDefault<z.ZodBoolean>;
+  isSecret: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+declare const playgroundExamplePromptSchema: z.ZodObject<{
+  title: z.ZodString;
+  prompt: z.ZodString;
+}, z.core.$strip>;
 declare const serverFieldsSchema: z.ZodObject<{
   $schema: z.ZodString;
   name: z.ZodString;
@@ -1023,4 +1145,4 @@ declare const serverFieldsSchema: z.ZodObject<{
   }, z.core.$strip>>>;
 }, z.core.$strip>;
 //#endregion
-export { ApiContext, AuditReport, CheckCategory, CheckDetail, CheckResult, CheckScope, CheckSeverity, Platform, RouterInput, RouterOutput, Runtime, Transport, analysisStatusSchema, auditReportSchema, buildSettingsSchema, checkDetailSchema, checkResultSchema, contract, createEnvironmentContractV1, deploymentStatusSchema, environmentVariableSchema, environmentVariablesSchema, platformSchema, runtimeSchema, serverFieldsSchema, transportSchema };
+export { ApiContext, AuditReport, CheckCategory, CheckDetail, CheckResult, CheckScope, CheckSeverity, Platform, RouterInput, RouterOutput, Runtime, Transport, auditReportSchema, auditStatusSchema, buildSettingsSchema, checkCategorySchema, checkDetailSchema, checkResultSchema, contract, createEnvironmentContractV1, deploymentStatusSchema, environmentVariableSchema, environmentVariablesSchema, platformSchema, playgroundExamplePromptSchema, playgroundHeaderSchema, runtimeSchema, serverFieldsSchema, transportSchema, updateEnvironmentVariableSchema };

package/dist/index.mjs

@@ -35,7 +35,8 @@ const RESERVED_KEYS = [
 	"BUILD_ARG_BUILD_OUTPUT_DIR",
 	"BUILD_ARG_START_COMMAND",
 	"ALPIC_HOST",
-	"ALPIC_CUSTOM_DOMAINS"
+	"ALPIC_CUSTOM_DOMAINS",
+	"ALPIC_PROMPT_META_KEY"
 ];
 const environmentVariableSchema = z.object({
 	key: z.string().min(2, "Key must be at least 2 characters").regex(/^[a-zA-Z]([a-zA-Z0-9_])+$/, "Key must start with a letter and contain only letters, numbers, and underscores").refine((key) => !RESERVED_KEYS.includes(key), "This key is reserved and cannot be used as an environment variable key"),
@@ -43,6 +44,10 @@ const environmentVariableSchema = z.object({
 	isSecret: z.boolean().default(false)
 });
 const environmentVariablesSchema = z.array(environmentVariableSchema);
+const updateEnvironmentVariableSchema = environmentVariableSchema.partial({
+	value: true,
+	isSecret: true
+});
 const buildSettingsSchema = z.object({
 	installCommand: z.string().optional(),
 	buildCommand: z.string().optional(),
@@ -60,7 +65,7 @@ const transportSchema = z.enum([
 	"sse",
 	"streamablehttp"
 ]);
-const analysisStatusSchema = z.enum([
+const auditStatusSchema = z.enum([
 	"pending",
 	"partial",
 	"completed",
@@ -86,6 +91,8 @@ const checkDetailSchema = z.object({
 });
 const checkResultSchema = z.object({
 	checkId: z.string(),
+	checkName: z.string(),
+	description: z.string(),
 	status: z.enum([
 		"pass",
 		"fail",
@@ -123,6 +130,16 @@ const auditReportSchema = z.object({
 		claudeai: z.object({ url: z.string() }).optional()
 	}).optional()
 });
+const playgroundHeaderSchema = z.object({
+	name: z.string().min(1).max(100),
+	description: z.string().max(200),
+	isRequired: z.boolean().default(false),
+	isSecret: z.boolean().default(false)
+});
+const playgroundExamplePromptSchema = z.object({
+	title: z.string().min(1).max(100),
+	prompt: z.string().min(1).max(500)
+});
 const serverFieldsSchema = z.object({
 	$schema: z.string(),
 	name: z.string(),
@@ -361,7 +378,7 @@ const updateEnvironmentVariableContractV1 = oc.route({
 	environmentVariableId: z.string().describe("The ID of the environment variable"),
 	key: environmentVariableSchema.shape.key,
 	value: environmentVariableSchema.shape.value.optional(),
-	isSecret: environmentVariableSchema.shape.isSecret
+	isSecret: environmentVariableSchema.shape.isSecret.optional()
 })).output(z.object({ success: z.literal(true) }));
 const deleteEnvironmentVariableContractV1 = oc.route({
 	path: "/v1/environment-variables/{environmentVariableId}",
@@ -481,6 +498,41 @@ const getLogsContractV1 = oc.route({
 	})),
 	nextToken: z.string().nullable()
 }));
+const getLatestLogsContractV1 = oc.route({
+	path: "/v1/environments/{environmentId}/latest-logs",
+	method: "GET",
+	summary: "Get latest logs",
+	description: "Get the N most recent logs for an environment",
+	tags: ["environments"],
+	successDescription: "The latest logs"
+}).errors({
+	NOT_FOUND: {},
+	BAD_REQUEST: {}
+}).input(z.object({
+	environmentId: z.string().describe("The ID of the environment"),
+	limit: z.coerce.number().int().min(1).max(1e3).default(100).describe("Number of most recent log entries to return"),
+	level: z.array(z.enum([
+		"INFO",
+		"ERROR",
+		"WARNING",
+		"DEBUG"
+	])).optional().describe("Filter by log level"),
+	search: z.string().optional().describe("Filter pattern to search for in log content")
+})).output(z.object({ logs: z.array(z.object({
+	timestamp: z.coerce.date(),
+	type: z.enum([
+		"START",
+		"END",
+		"INFO",
+		"ERROR",
+		"WARNING",
+		"DEBUG"
+	]),
+	requestId: z.string(),
+	content: z.string().optional(),
+	method: z.string().optional(),
+	durationInMs: z.number().optional()
+})) }));
 const getDeploymentLogsContractV1 = oc.route({
 	path: "/v1/deployments/{deploymentId}/logs",
 	method: "GET",
@@ -590,32 +642,74 @@ const getServerInfoContractV1 = oc.route({
 	projectId: z.string(),
 	domain: z.string()
 })).output(z.object({ serverFields: serverFieldsSchema }));
+const playgroundServerMetadataOutputSchema = z.object({
+	name: z.string(),
+	description: z.string(),
+	headers: z.array(z.object({
+		name: z.string(),
+		description: z.string(),
+		isRequired: z.boolean(),
+		isSecret: z.boolean()
+	})),
+	examplePrompts: z.array(playgroundExamplePromptSchema)
+});
+const playgroundOutputSchema = z.object({
+	isPlaygroundEnabled: z.boolean(),
+	serverMetadata: playgroundServerMetadataOutputSchema.nullable()
+});
+const getPlaygroundContractV1 = oc.route({
+	path: "/v1/environments/{environmentId}/playground",
+	method: "GET",
+	summary: "Get playground configuration",
+	description: "Get the playground configuration for an environment",
+	tags: ["environments"],
+	successDescription: "The playground configuration"
+}).errors({ NOT_FOUND: {} }).input(z.object({ environmentId: z.string().describe("The ID of the environment") })).output(playgroundOutputSchema);
+const upsertPlaygroundContractV1 = oc.route({
+	path: "/v1/environments/{environmentId}/playground",
+	method: "PUT",
+	summary: "Update playground configuration",
+	description: "Update the playground configuration for an environment. All fields are optional — only provided fields are updated.",
+	tags: ["environments"],
+	successDescription: "The updated playground configuration"
+}).errors({
+	NOT_FOUND: {},
+	BAD_REQUEST: {}
+}).input(z.object({
+	environmentId: z.string().describe("The ID of the environment"),
+	isPlaygroundEnabled: z.boolean().optional(),
+	name: z.string().min(1).max(100).optional(),
+	description: z.string().min(1).max(500).optional(),
+	headers: z.array(playgroundHeaderSchema).optional(),
+	examplePrompts: z.array(playgroundExamplePromptSchema).max(3).optional()
+})).output(playgroundOutputSchema);
 const createBeaconContractV1 = oc.route({
-	path: "/v1/beacon/analyses",
+	path: "/v1/beacon/audits",
 	method: "POST",
-	summary: "Create a beacon analysis",
-	description: "Analyze an MCP server for spec compliance and AI client compatibility",
+	summary: "Create a beacon audit",
+	description: "Audit an MCP server for spec compliance and AI client compatibility",
 	tags: ["beacon"],
-	successDescription: "The analysis has been created"
+	successDescription: "The audit has been created"
 }).errors({
 	NOT_FOUND: {},
 	BAD_REQUEST: {}
 }).input(z.object({
-	targetUrl: z.string().url().describe("The HTTPS URL of the MCP server to analyze"),
-	teamId: z.string().optional().describe("The team ID to associate the analysis with"),
-	projectId: z.string().optional().describe("The project ID to associate the analysis with")
+	targetUrl: z.string().url().describe("The HTTPS URL of the MCP server to audit"),
+	teamId: z.string().optional().describe("The team ID to associate the audit with"),
+	projectId: z.string().optional().describe("The project ID to associate the audit with"),
+	excludeCategories: z.array(checkCategorySchema).optional().describe("Check categories to exclude from the audit")
 })).output(z.object({ id: z.string() }));
 const getBeaconContractV1 = oc.route({
-	path: "/v1/beacon/analyses/{analysisId}",
+	path: "/v1/beacon/audits/{auditId}",
 	method: "GET",
-	summary: "Get a beacon analysis",
-	description: "Get a beacon analysis by ID, including the report if completed",
+	summary: "Get a beacon audit",
+	description: "Get a beacon audit by ID, including the report if completed",
 	tags: ["beacon"],
-	successDescription: "The analysis details"
-}).errors({ NOT_FOUND: {} }).input(z.object({ analysisId: z.string().describe("The ID of the analysis") })).output(z.object({
+	successDescription: "The audit details"
+}).errors({ NOT_FOUND: {} }).input(z.object({ auditId: z.string().describe("The ID of the audit") })).output(z.object({
 	id: z.string(),
 	targetUrl: z.string(),
-	status: analysisStatusSchema,
+	status: auditStatusSchema,
 	durationMs: z.number().nullable(),
 	createdAt: z.coerce.date(),
 	report: auditReportSchema.nullable()
@@ -633,7 +727,8 @@ const contract = {
 		create: { v1: createEnvironmentContractV1 },
 		get: { v1: getEnvironmentContractV1 },
 		deploy: { v1: deployEnvironmentContractV1 },
-		getLogs: { v1: getLogsContractV1 }
+		getLogs: { v1: getLogsContractV1 },
+		getLatestLogs: { v1: getLatestLogsContractV1 }
 	},
 	environmentVariables: {
 		list: { v1: listEnvironmentVariablesContractV1 },
@@ -648,6 +743,10 @@ const contract = {
 		create: { v1: createProjectContractV1 },
 		delete: { v1: deleteProjectContractV1 }
 	},
+	playground: {
+		get: { v1: getPlaygroundContractV1 },
+		upsert: { v1: upsertPlaygroundContractV1 }
+	},
 	tunnels: { getTicket: { v1: getTunnelTicketContractV1 } },
 	distribution: {
 		publish: { v1: publishServerContractV1 },
@@ -659,4 +758,4 @@ const contract = {
 	}
 };
 //#endregion
-export { analysisStatusSchema, auditReportSchema, buildSettingsSchema, checkDetailSchema, checkResultSchema, contract, createEnvironmentContractV1, deploymentStatusSchema, environmentVariableSchema, environmentVariablesSchema, platformSchema, runtimeSchema, serverFieldsSchema, transportSchema };
+export { auditReportSchema, auditStatusSchema, buildSettingsSchema, checkCategorySchema, checkDetailSchema, checkResultSchema, contract, createEnvironmentContractV1, deploymentStatusSchema, environmentVariableSchema, environmentVariablesSchema, platformSchema, playgroundExamplePromptSchema, playgroundHeaderSchema, runtimeSchema, serverFieldsSchema, transportSchema, updateEnvironmentVariableSchema };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alpic-ai/api",
-  "version": "0.0.0-staging.a0c1343",
+  "version": "0.0.0-staging.a19b079",
   "description": "Contract for the Alpic API",
   "type": "module",
   "main": "./dist/index.mjs",
@@ -17,7 +17,7 @@
   "author": "Alpic",
   "license": "ISC",
   "dependencies": {
-    "@orpc/contract": "^1.13.13",
+    "@orpc/contract": "^1.13.14",
     "ms": "^2.1.3",
     "zod": "^4.3.6"
   },
@@ -25,9 +25,9 @@
     "@total-typescript/tsconfig": "^1.0.4",
     "@types/ms": "^2.1.0",
     "shx": "^0.4.0",
-    "tsdown": "^0.21.7",
-    "typescript": "^6.0.2",
-    "vitest": "^4.1.2"
+    "tsdown": "^0.21.9",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.4"
   },
   "scripts": {
     "build": "shx rm -rf dist && tsdown",