@alpic-ai/api 0.0.0-staging.5a98067 → 0.0.0-staging.5aaefee

package/dist/index.d.mts

@@ -1,6 +1,6 @@
+import { z } from "zod";
 import * as _$_orpc_contract0 from "@orpc/contract";
 import { InferContractRouterInputs, InferContractRouterOutputs } from "@orpc/contract";
-import { z } from "zod";
 
 //#region src/api.contract.d.ts
 type ApiContext = {
@@ -11,9 +11,9 @@ type ApiContext = {
   };
 };
 declare const deploymentStatusSchema: z.ZodEnum<{
-  failed: "failed";
   ongoing: "ongoing";
   deployed: "deployed";
+  failed: "failed";
   canceled: "canceled";
 }>;
 declare const createEnvironmentContractV1: _$_orpc_contract0.ContractProcedureBuilderWithInputOutput<z.ZodObject<{
@@ -103,18 +103,18 @@ declare const contract: {
       v1: _$_orpc_contract0.ContractProcedureBuilderWithInputOutput<z.ZodObject<{
         projectId: z.ZodString;
         status: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-          failed: "failed";
           ongoing: "ongoing";
           deployed: "deployed";
+          failed: "failed";
           canceled: "canceled";
         }>>>;
         environmentId: z.ZodOptional<z.ZodString>;
       }, z.core.$strip>, z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         status: z.ZodEnum<{
-          failed: "failed";
           ongoing: "ongoing";
           deployed: "deployed";
+          failed: "failed";
           canceled: "canceled";
         }>;
         sourceRef: z.ZodNullable<z.ZodString>;
@@ -138,9 +138,9 @@ declare const contract: {
       }, z.core.$strip>, z.ZodObject<{
         id: z.ZodString;
         status: z.ZodEnum<{
-          failed: "failed";
           ongoing: "ongoing";
           deployed: "deployed";
+          failed: "failed";
           canceled: "canceled";
         }>;
         sourceRef: z.ZodNullable<z.ZodString>;
@@ -226,9 +226,9 @@ declare const contract: {
       }, z.core.$strip>, z.ZodObject<{
         id: z.ZodString;
         status: z.ZodEnum<{
-          failed: "failed";
           ongoing: "ongoing";
           deployed: "deployed";
+          failed: "failed";
           canceled: "canceled";
         }>;
         sourceRef: z.ZodNullable<z.ZodString>;
@@ -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>, {
@@ -371,18 +403,18 @@ declare const contract: {
           domains: z.ZodArray<z.ZodObject<{
             domain: z.ZodString;
             status: z.ZodEnum<{
-              failed: "failed";
               ongoing: "ongoing";
               deployed: "deployed";
+              failed: "failed";
             }>;
             createdAt: z.ZodCoercedDate<unknown>;
           }, z.core.$strip>>;
           latestDeployment: z.ZodNullable<z.ZodObject<{
             id: z.ZodString;
             status: z.ZodEnum<{
-              failed: "failed";
               ongoing: "ongoing";
               deployed: "deployed";
+              failed: "failed";
               canceled: "canceled";
             }>;
             sourceCommitId: z.ZodNullable<z.ZodString>;
@@ -400,9 +432,9 @@ declare const contract: {
           latestDeployment: z.ZodNullable<z.ZodObject<{
             id: z.ZodString;
             status: z.ZodEnum<{
-              failed: "failed";
               ongoing: "ongoing";
               deployed: "deployed";
+              failed: "failed";
               canceled: "canceled";
             }>;
             sourceCommitId: z.ZodNullable<z.ZodString>;
@@ -447,18 +479,18 @@ declare const contract: {
           domains: z.ZodArray<z.ZodObject<{
             domain: z.ZodString;
             status: z.ZodEnum<{
-              failed: "failed";
               ongoing: "ongoing";
               deployed: "deployed";
+              failed: "failed";
             }>;
             createdAt: z.ZodCoercedDate<unknown>;
           }, z.core.$strip>>;
           latestDeployment: z.ZodNullable<z.ZodObject<{
             id: z.ZodString;
             status: z.ZodEnum<{
-              failed: "failed";
               ongoing: "ongoing";
               deployed: "deployed";
+              failed: "failed";
               canceled: "canceled";
             }>;
             sourceCommitId: z.ZodNullable<z.ZodString>;
@@ -476,9 +508,9 @@ declare const contract: {
           latestDeployment: z.ZodNullable<z.ZodObject<{
             id: z.ZodString;
             status: z.ZodEnum<{
-              failed: "failed";
               ongoing: "ongoing";
               deployed: "deployed";
+              failed: "failed";
               canceled: "canceled";
             }>;
             sourceCommitId: z.ZodNullable<z.ZodString>;
@@ -522,18 +554,18 @@ declare const contract: {
           domains: z.ZodArray<z.ZodObject<{
             domain: z.ZodString;
             status: z.ZodEnum<{
-              failed: "failed";
               ongoing: "ongoing";
               deployed: "deployed";
+              failed: "failed";
             }>;
             createdAt: z.ZodCoercedDate<unknown>;
           }, z.core.$strip>>;
           latestDeployment: z.ZodNullable<z.ZodObject<{
             id: z.ZodString;
             status: z.ZodEnum<{
-              failed: "failed";
               ongoing: "ongoing";
               deployed: "deployed";
+              failed: "failed";
               canceled: "canceled";
             }>;
             sourceCommitId: z.ZodNullable<z.ZodString>;
@@ -551,9 +583,9 @@ declare const contract: {
           latestDeployment: z.ZodNullable<z.ZodObject<{
             id: z.ZodString;
             status: z.ZodEnum<{
-              failed: "failed";
               ongoing: "ongoing";
               deployed: "deployed";
+              failed: "failed";
               canceled: "canceled";
             }>;
             sourceCommitId: z.ZodNullable<z.ZodString>;
@@ -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<{
@@ -722,9 +816,16 @@ declare const contract: {
   beacon: {
     create: {
       v1: _$_orpc_contract0.ContractProcedureBuilderWithInputOutput<z.ZodObject<{
-        targetUrl: z.ZodString;
+        targetUrl: z.ZodURL;
         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,15 +835,15 @@ 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;
         status: z.ZodEnum<{
+          failed: "failed";
           pending: "pending";
           partial: "partial";
           completed: "completed";
-          failed: "failed";
         }>;
         durationMs: z.ZodNullable<z.ZodNumber>;
         createdAt: z.ZodCoercedDate<unknown>;
@@ -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";
@@ -802,18 +905,18 @@ declare const contract: {
             chatgpt: "chatgpt";
             claudeai: "claudeai";
           }>, z.ZodBoolean>;
-          widgetScreenshotKeys: z.ZodOptional<z.ZodObject<{
+          widgetScreenshotKeys: z.ZodObject<{
             chatgpt: z.ZodOptional<z.ZodString>;
             claudeai: z.ZodOptional<z.ZodString>;
-          }, z.core.$strip>>;
-          widgetScreenshots: z.ZodOptional<z.ZodObject<{
+          }, z.core.$strip>;
+          widgetScreenshots: z.ZodObject<{
             chatgpt: z.ZodOptional<z.ZodObject<{
               url: z.ZodString;
             }, z.core.$strip>>;
             claudeai: z.ZodOptional<z.ZodObject<{
               url: z.ZodString;
             }, z.core.$strip>>;
-          }, z.core.$strip>>;
+          }, z.core.$strip>;
         }, z.core.$strip>>;
       }, z.core.$strip>, _$_orpc_contract0.MergedErrorMap<Record<never, never>, {
         NOT_FOUND: {};
@@ -824,6 +927,14 @@ declare const contract: {
 type RouterInput = InferContractRouterInputs<typeof contract>;
 type RouterOutput = InferContractRouterOutputs<typeof contract>;
 //#endregion
+//#region ../domains/src/beacon/schemas.d.ts
+declare const platformSchema: z.ZodEnum<{
+  chatgpt: "chatgpt";
+  claudeai: "claudeai";
+}>;
+type Platform = z.infer<typeof platformSchema>;
+declare const PLATFORM_LABELS: Record<Platform, string>;
+//#endregion
 //#region src/schemas.d.ts
 declare const environmentVariableSchema: z.ZodObject<{
   key: z.ZodString;
@@ -835,6 +946,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,151 +970,16 @@ declare const transportSchema: z.ZodEnum<{
   streamablehttp: "streamablehttp";
 }>;
 type Transport = z.infer<typeof transportSchema>;
-declare const analysisStatusSchema: z.ZodEnum<{
-  pending: "pending";
-  partial: "partial";
-  completed: "completed";
-  failed: "failed";
-}>;
-declare const platformSchema: z.ZodEnum<{
-  chatgpt: "chatgpt";
-  claudeai: "claudeai";
-}>;
-type Platform = z.infer<typeof platformSchema>;
-declare const checkSeveritySchema: z.ZodEnum<{
-  error: "error";
-  warning: "warning";
-  info: "info";
-}>;
-type CheckSeverity = z.infer<typeof checkSeveritySchema>;
-declare const checkCategorySchema: z.ZodEnum<{
-  connectivity: "connectivity";
-  "tool-metadata": "tool-metadata";
-  "resource-metadata": "resource-metadata";
-  performance: "performance";
-  e2e: "e2e";
-}>;
-type CheckCategory = z.infer<typeof checkCategorySchema>;
-declare const checkScopeSchema: z.ZodEnum<{
-  server: "server";
-  view: "view";
-}>;
-type CheckScope = z.infer<typeof checkScopeSchema>;
-declare const checkDetailSchema: z.ZodObject<{
-  label: z.ZodString;
-  value: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-type CheckDetail = z.infer<typeof checkDetailSchema>;
-declare const checkResultSchema: z.ZodObject<{
-  checkId: z.ZodString;
-  status: z.ZodEnum<{
-    pending: "pending";
-    pass: "pass";
-    fail: "fail";
-    skip: "skip";
-  }>;
-  message: z.ZodString;
-  skipReason: z.ZodOptional<z.ZodString>;
-  severity: z.ZodEnum<{
-    error: "error";
-    warning: "warning";
-    info: "info";
-  }>;
-  category: z.ZodEnum<{
-    connectivity: "connectivity";
-    "tool-metadata": "tool-metadata";
-    "resource-metadata": "resource-metadata";
-    performance: "performance";
-    e2e: "e2e";
-  }>;
-  scope: z.ZodEnum<{
-    server: "server";
-    view: "view";
-  }>;
-  platforms: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodEnum<{
-    chatgpt: "chatgpt";
-    claudeai: "claudeai";
-  }>>>>;
-  durationMs: z.ZodNumber;
-  details: z.ZodOptional<z.ZodArray<z.ZodObject<{
-    label: z.ZodString;
-    value: z.ZodOptional<z.ZodString>;
-  }, z.core.$strip>>>;
-  hint: z.ZodOptional<z.ZodObject<{
-    text: z.ZodString;
-  }, z.core.$strip>>;
+declare const playgroundHeaderSchema: z.ZodObject<{
+  name: z.ZodString;
+  description: z.ZodString;
+  isRequired: z.ZodDefault<z.ZodBoolean>;
+  isSecret: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
-type CheckResult = z.infer<typeof checkResultSchema>;
-declare const auditReportSchema: z.ZodObject<{
-  schemaVersion: z.ZodString;
-  auditId: z.ZodString;
-  targetUrl: z.ZodString;
-  startedAt: z.ZodString;
-  completedAt: z.ZodString;
-  durationMs: z.ZodNumber;
-  results: z.ZodArray<z.ZodObject<{
-    checkId: z.ZodString;
-    status: z.ZodEnum<{
-      pending: "pending";
-      pass: "pass";
-      fail: "fail";
-      skip: "skip";
-    }>;
-    message: z.ZodString;
-    skipReason: z.ZodOptional<z.ZodString>;
-    severity: z.ZodEnum<{
-      error: "error";
-      warning: "warning";
-      info: "info";
-    }>;
-    category: z.ZodEnum<{
-      connectivity: "connectivity";
-      "tool-metadata": "tool-metadata";
-      "resource-metadata": "resource-metadata";
-      performance: "performance";
-      e2e: "e2e";
-    }>;
-    scope: z.ZodEnum<{
-      server: "server";
-      view: "view";
-    }>;
-    platforms: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodEnum<{
-      chatgpt: "chatgpt";
-      claudeai: "claudeai";
-    }>>>>;
-    durationMs: z.ZodNumber;
-    details: z.ZodOptional<z.ZodArray<z.ZodObject<{
-      label: z.ZodString;
-      value: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>>;
-    hint: z.ZodOptional<z.ZodObject<{
-      text: z.ZodString;
-    }, z.core.$strip>>;
-  }, z.core.$strip>>;
-  requiresAuth: z.ZodBoolean;
-  hasViewSupport: z.ZodBoolean;
-  viewPlatforms: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodEnum<{
-    chatgpt: "chatgpt";
-    claudeai: "claudeai";
-  }>>>>;
-  isReadyForPlatform: z.ZodRecord<z.ZodEnum<{
-    chatgpt: "chatgpt";
-    claudeai: "claudeai";
-  }>, z.ZodBoolean>;
-  widgetScreenshotKeys: z.ZodOptional<z.ZodObject<{
-    chatgpt: z.ZodOptional<z.ZodString>;
-    claudeai: z.ZodOptional<z.ZodString>;
-  }, z.core.$strip>>;
-  widgetScreenshots: z.ZodOptional<z.ZodObject<{
-    chatgpt: z.ZodOptional<z.ZodObject<{
-      url: z.ZodString;
-    }, z.core.$strip>>;
-    claudeai: z.ZodOptional<z.ZodObject<{
-      url: z.ZodString;
-    }, z.core.$strip>>;
-  }, z.core.$strip>>;
+declare const playgroundExamplePromptSchema: z.ZodObject<{
+  title: z.ZodString;
+  prompt: z.ZodString;
 }, z.core.$strip>;
-type AuditReport = z.infer<typeof auditReportSchema>;
 declare const serverFieldsSchema: z.ZodObject<{
   $schema: z.ZodString;
   name: z.ZodString;
@@ -1023,4 +1004,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, PLATFORM_LABELS, type Platform, RouterInput, RouterOutput, Runtime, Transport, buildSettingsSchema, contract, createEnvironmentContractV1, deploymentStatusSchema, environmentVariableSchema, environmentVariablesSchema, playgroundExamplePromptSchema, playgroundHeaderSchema, runtimeSchema, serverFieldsSchema, transportSchema, updateEnvironmentVariableSchema };

package/dist/index.mjs

@@ -1,6 +1,78 @@
+import { z } from "zod";
 import { oc } from "@orpc/contract";
 import ms from "ms";
-import { z } from "zod";
+//#region ../domains/dist/index.mjs
+const auditStatusSchema = z.enum([
+	"pending",
+	"partial",
+	"completed",
+	"failed"
+]);
+const platformSchema = z.enum(["chatgpt", "claudeai"]);
+const PLATFORM_LABELS = {
+	chatgpt: "ChatGPT",
+	claudeai: "Claude.ai"
+};
+const checkSeveritySchema = z.enum([
+	"error",
+	"warning",
+	"info"
+]);
+const checkCategorySchema = z.enum([
+	"connectivity",
+	"tool-metadata",
+	"resource-metadata",
+	"performance",
+	"e2e"
+]);
+const checkScopeSchema = z.enum(["server", "view"]);
+const checkDetailSchema = z.object({
+	label: z.string(),
+	value: z.string().optional()
+});
+const checkResultSchema = z.object({
+	checkId: z.string(),
+	checkName: z.string(),
+	description: z.string(),
+	status: z.enum([
+		"pass",
+		"fail",
+		"skip",
+		"pending"
+	]),
+	message: z.string(),
+	skipReason: z.string().optional(),
+	severity: checkSeveritySchema,
+	category: checkCategorySchema,
+	scope: checkScopeSchema,
+	platforms: z.array(platformSchema).readonly().optional(),
+	durationMs: z.number(),
+	details: z.array(checkDetailSchema).optional(),
+	hint: z.object({ text: z.string() }).optional()
+});
+const auditReportSchema = z.object({
+	schemaVersion: z.string(),
+	auditId: z.string(),
+	targetUrl: z.string(),
+	startedAt: z.string(),
+	completedAt: z.string(),
+	durationMs: z.number(),
+	results: z.array(checkResultSchema),
+	requiresAuth: z.boolean(),
+	hasViewSupport: z.boolean(),
+	viewPlatforms: z.array(platformSchema).readonly().optional(),
+	isReadyForPlatform: z.record(platformSchema, z.boolean()),
+	widgetScreenshotKeys: z.object({
+		chatgpt: z.string().optional(),
+		claudeai: z.string().optional()
+	})
+});
+const widgetScreenshotSchema = z.object({ url: z.string() });
+const auditReportWithScreenshotsSchema = auditReportSchema.extend({ widgetScreenshots: z.object({
+	chatgpt: widgetScreenshotSchema.optional(),
+	claudeai: widgetScreenshotSchema.optional()
+}) });
+//#endregion
 //#region src/schemas.ts
 const RESERVED_KEYS = [
 	"_HANDLER",
@@ -35,7 +107,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 +116,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,68 +137,15 @@ const transportSchema = z.enum([
 	"sse",
 	"streamablehttp"
 ]);
-const analysisStatusSchema = z.enum([
-	"pending",
-	"partial",
-	"completed",
-	"failed"
-]);
-const platformSchema = z.enum(["chatgpt", "claudeai"]);
-const checkSeveritySchema = z.enum([
-	"error",
-	"warning",
-	"info"
-]);
-const checkCategorySchema = z.enum([
-	"connectivity",
-	"tool-metadata",
-	"resource-metadata",
-	"performance",
-	"e2e"
-]);
-const checkScopeSchema = z.enum(["server", "view"]);
-const checkDetailSchema = z.object({
-	label: z.string(),
-	value: z.string().optional()
-});
-const checkResultSchema = z.object({
-	checkId: z.string(),
-	status: z.enum([
-		"pass",
-		"fail",
-		"skip",
-		"pending"
-	]),
-	message: z.string(),
-	skipReason: z.string().optional(),
-	severity: checkSeveritySchema,
-	category: checkCategorySchema,
-	scope: checkScopeSchema,
-	platforms: z.array(platformSchema).readonly().optional(),
-	durationMs: z.number(),
-	details: z.array(checkDetailSchema).optional(),
-	hint: z.object({ text: z.string() }).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 auditReportSchema = z.object({
-	schemaVersion: z.string(),
-	auditId: z.string(),
-	targetUrl: z.string(),
-	startedAt: z.string(),
-	completedAt: z.string(),
-	durationMs: z.number(),
-	results: z.array(checkResultSchema),
-	requiresAuth: z.boolean(),
-	hasViewSupport: z.boolean(),
-	viewPlatforms: z.array(platformSchema).readonly().optional(),
-	isReadyForPlatform: z.record(platformSchema, z.boolean()),
-	widgetScreenshotKeys: z.object({
-		chatgpt: z.string().optional(),
-		claudeai: z.string().optional()
-	}).optional(),
-	widgetScreenshots: z.object({
-		chatgpt: z.object({ url: z.string() }).optional(),
-		claudeai: z.object({ url: z.string() }).optional()
-	}).optional()
+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(),
@@ -361,7 +385,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 +505,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,35 +649,77 @@ 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.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()
+	report: auditReportWithScreenshotsSchema.nullable()
 }));
 const contract = {
 	teams: { list: { v1: listTeamsContractV1 } },
@@ -633,7 +734,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 +750,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 +765,4 @@ const contract = {
 	}
 };
 //#endregion
-export { analysisStatusSchema, auditReportSchema, buildSettingsSchema, checkDetailSchema, checkResultSchema, contract, createEnvironmentContractV1, deploymentStatusSchema, environmentVariableSchema, environmentVariablesSchema, platformSchema, runtimeSchema, serverFieldsSchema, transportSchema };
+export { PLATFORM_LABELS, buildSettingsSchema, contract, createEnvironmentContractV1, deploymentStatusSchema, environmentVariableSchema, environmentVariablesSchema, playgroundExamplePromptSchema, playgroundHeaderSchema, runtimeSchema, serverFieldsSchema, transportSchema, updateEnvironmentVariableSchema };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alpic-ai/api",
-  "version": "0.0.0-staging.5a98067",
+  "version": "0.0.0-staging.5aaefee",
   "description": "Contract for the Alpic API",
   "type": "module",
   "main": "./dist/index.mjs",
@@ -14,20 +14,32 @@
   "files": [
     "dist"
   ],
+  "nx": {
+    "targets": {
+      "build": {
+        "dependsOn": [
+          "^build"
+        ]
+      }
+    }
+  },
   "author": "Alpic",
   "license": "ISC",
   "dependencies": {
-    "@orpc/contract": "^1.13.13",
+    "@orpc/contract": "^1.14.3",
     "ms": "^2.1.3",
-    "zod": "^4.3.6"
+    "zod": "^4.4.3"
   },
   "devDependencies": {
+    "@orpc/openapi": "^1.14.3",
+    "@orpc/zod": "^1.14.3",
     "@total-typescript/tsconfig": "^1.0.4",
     "@types/ms": "^2.1.0",
     "shx": "^0.4.0",
-    "tsdown": "^0.21.7",
-    "typescript": "^5.9.3",
-    "vitest": "^4.1.2"
+    "tsdown": "^0.22.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.6",
+    "@alpic-ai/domains": "0.0.0"
   },
   "scripts": {
     "build": "shx rm -rf dist && tsdown",