@alpic-ai/api 0.0.0-dev.gef3a775 → 0.0.0-dev.gef9a9d1

package/dist/index.d.mts

@@ -948,6 +948,908 @@ declare const contract: {
     };
   };
 };
+declare const contractForDocs: {
+  deployments: {
+    list: {
+      v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        projectId: z.ZodString;
+        status: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+          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<{
+          ongoing: "ongoing";
+          deployed: "deployed";
+          failed: "failed";
+          canceled: "canceled";
+        }>;
+        sourceRef: z.ZodNullable<z.ZodString>;
+        sourceCommitId: z.ZodNullable<z.ZodString>;
+        sourceCommitMessage: z.ZodNullable<z.ZodString>;
+        authorUsername: z.ZodNullable<z.ZodString>;
+        authorAvatarUrl: z.ZodNullable<z.ZodString>;
+        startedAt: z.ZodNullable<z.ZodCoercedDate<unknown>>;
+        completedAt: z.ZodNullable<z.ZodCoercedDate<unknown>>;
+        environmentId: z.ZodString;
+        environmentName: z.ZodString;
+        isCurrent: z.ZodBoolean;
+        deploymentPageUrl: z.ZodNullable<z.ZodURL>;
+      }, z.core.$strip>>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        NOT_FOUND: {};
+      }>, Record<never, never>>;
+    };
+    get: {
+      v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        deploymentId: z.ZodString;
+      }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        status: z.ZodEnum<{
+          ongoing: "ongoing";
+          deployed: "deployed";
+          failed: "failed";
+          canceled: "canceled";
+        }>;
+        sourceRef: z.ZodNullable<z.ZodString>;
+        sourceCommitId: z.ZodNullable<z.ZodString>;
+        sourceCommitMessage: z.ZodNullable<z.ZodString>;
+        authorUsername: z.ZodNullable<z.ZodString>;
+        authorAvatarUrl: z.ZodNullable<z.ZodString>;
+        startedAt: z.ZodNullable<z.ZodCoercedDate<unknown>>;
+        completedAt: z.ZodNullable<z.ZodCoercedDate<unknown>>;
+        environmentId: z.ZodString;
+        environmentName: z.ZodString;
+        isCurrent: z.ZodBoolean;
+        deploymentPageUrl: z.ZodNullable<z.ZodURL>;
+      }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        NOT_FOUND: {};
+      }>, Record<never, never>>;
+    };
+    getLogs: {
+      v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        deploymentId: z.ZodString;
+      }, z.core.$strip>, z.ZodObject<{
+        logs: z.ZodArray<z.ZodObject<{
+          timestamp: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+          content: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        hasMoreLogs: z.ZodBoolean;
+      }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        NOT_FOUND: {};
+      }>, Record<never, never>>;
+    };
+  };
+  teams: {
+    list: {
+      v1: import("@orpc/contract").ContractProcedureBuilderWithOutput<import("@orpc/contract").Schema<unknown, unknown>, z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        createdAt: z.ZodCoercedDate<unknown>;
+        hasStripeAccount: z.ZodBoolean;
+      }, z.core.$strip>>, Record<never, never>, Record<never, never>>;
+    };
+  };
+  analytics: {
+    get: {
+      v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        projectId: z.ZodString;
+        startTimestamp: z.ZodCoercedNumber<unknown>;
+        endTimestamp: z.ZodCoercedNumber<unknown>;
+        timeZone: z.ZodString;
+      }, z.core.$strip>, z.ZodObject<{
+        metadata: z.ZodObject<{
+          startTimestamp: z.ZodNumber;
+          endTimestamp: z.ZodNumber;
+          timeZone: z.ZodString;
+          startDate: z.ZodCoercedDate<unknown>;
+          interval: z.ZodString;
+        }, z.core.$strip>;
+        timeSeries: z.ZodObject<{
+          sessions_count: z.ZodArray<z.ZodObject<{
+            timestamp: z.ZodNumber;
+            categories: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+          }, z.core.$strip>>;
+          requests_count: z.ZodArray<z.ZodObject<{
+            timestamp: z.ZodNumber;
+            categories: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+          }, z.core.$strip>>;
+          requests_latency_mean: z.ZodArray<z.ZodObject<{
+            timestamp: z.ZodNumber;
+            categories: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+          }, z.core.$strip>>;
+          tool_errors: z.ZodArray<z.ZodObject<{
+            timestamp: z.ZodNumber;
+            categories: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+          }, z.core.$strip>>;
+          mcp_errors: z.ZodArray<z.ZodObject<{
+            timestamp: z.ZodNumber;
+            categories: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+          }, z.core.$strip>>;
+          output_token_mean: z.ZodArray<z.ZodObject<{
+            timestamp: z.ZodNumber;
+            categories: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+          }, z.core.$strip>>;
+          task_count: z.ZodArray<z.ZodObject<{
+            timestamp: z.ZodNumber;
+            categories: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+          }, z.core.$strip>>;
+        }, z.core.$strip>;
+      }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        NOT_FOUND: {};
+        BAD_REQUEST: {};
+      }>, Record<never, never>>;
+    };
+  };
+  environments: {
+    create: {
+      v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        projectId: z.ZodString;
+        name: z.ZodString;
+        sourceBranch: z.ZodString;
+        environmentVariables: z.ZodDefault<z.ZodArray<z.ZodObject<{
+          key: z.ZodString;
+          value: z.ZodString;
+          isSecret: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+      }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        sourceBranch: z.ZodNullable<z.ZodString>;
+        urls: z.ZodArray<z.ZodURL>;
+        createdAt: z.ZodCoercedDate<unknown>;
+        projectId: z.ZodString;
+      }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        NOT_FOUND: {};
+        BAD_REQUEST: {};
+      }>, Record<never, never>>;
+    };
+    get: {
+      v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        environmentId: z.ZodString;
+      }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        sourceBranch: z.ZodNullable<z.ZodString>;
+        mcpServerUrl: z.ZodString;
+        domains: z.ZodArray<z.ZodCustomStringFormat<"hostname">>;
+        createdAt: z.ZodCoercedDate<unknown>;
+        projectId: z.ZodString;
+      }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        NOT_FOUND: {};
+      }>, Record<never, never>>;
+    };
+    deploy: {
+      v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        environmentId: z.ZodString;
+        token: z.ZodOptional<z.ZodString>;
+        settings: z.ZodOptional<z.ZodObject<{
+          installCommand: z.ZodOptional<z.ZodString>;
+          buildCommand: z.ZodOptional<z.ZodString>;
+          buildOutputDir: z.ZodOptional<z.ZodString>;
+          startCommand: z.ZodOptional<z.ZodString>;
+          transport: z.ZodEnum<{
+            stdio: "stdio";
+            sse: "sse";
+            streamablehttp: "streamablehttp";
+          }>;
+        }, z.core.$strip>>;
+      }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        status: z.ZodEnum<{
+          ongoing: "ongoing";
+          deployed: "deployed";
+          failed: "failed";
+          canceled: "canceled";
+        }>;
+        sourceRef: z.ZodNullable<z.ZodString>;
+        sourceCommitId: z.ZodNullable<z.ZodString>;
+        sourceCommitMessage: z.ZodNullable<z.ZodString>;
+        authorUsername: z.ZodNullable<z.ZodString>;
+        authorAvatarUrl: z.ZodNullable<z.ZodString>;
+        startedAt: z.ZodNullable<z.ZodCoercedDate<unknown>>;
+        completedAt: z.ZodNullable<z.ZodCoercedDate<unknown>>;
+        environmentId: z.ZodString;
+        environmentName: z.ZodString;
+        isCurrent: z.ZodBoolean;
+        deploymentPageUrl: z.ZodNullable<z.ZodURL>;
+      }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        NOT_FOUND: {};
+        BAD_REQUEST: {};
+        CONFLICT: {};
+      }>, Record<never, never>>;
+    };
+    getLogs: {
+      v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        environmentId: z.ZodString;
+        since: z.ZodOptional<z.ZodString>;
+        until: z.ZodOptional<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>;
+        nextToken: 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>>;
+        nextToken: z.ZodNullable<z.ZodString>;
+      }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        NOT_FOUND: {};
+        BAD_REQUEST: {};
+      }>, Record<never, never>>;
+    };
+    getLatestLogs: {
+      v1: import("@orpc/contract").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>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        NOT_FOUND: {};
+        BAD_REQUEST: {};
+      }>, Record<never, never>>;
+    };
+  };
+  environmentVariables: {
+    list: {
+      v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        environmentId: z.ZodString;
+      }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        key: z.ZodString;
+        value: z.ZodString;
+        isSecret: z.ZodBoolean;
+        createdAt: z.ZodCoercedDate<unknown>;
+      }, z.core.$strip>>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        NOT_FOUND: {};
+      }>, Record<never, never>>;
+    };
+    create: {
+      v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        environmentId: z.ZodString;
+        environmentVariables: z.ZodArray<z.ZodObject<{
+          key: z.ZodString;
+          value: z.ZodString;
+          isSecret: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
+      }, z.core.$strip>, z.ZodObject<{
+        success: z.ZodLiteral<true>;
+      }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        NOT_FOUND: {};
+        BAD_REQUEST: {};
+      }>, Record<never, never>>;
+    };
+    update: {
+      v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        environmentVariableId: z.ZodString;
+        key: z.ZodString;
+        value: z.ZodOptional<z.ZodString>;
+        isSecret: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+      }, z.core.$strip>, z.ZodObject<{
+        success: z.ZodLiteral<true>;
+      }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        NOT_FOUND: {};
+        BAD_REQUEST: {};
+      }>, Record<never, never>>;
+    };
+    delete: {
+      v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        environmentVariableId: z.ZodString;
+      }, z.core.$strip>, z.ZodObject<{
+        success: z.ZodLiteral<true>;
+      }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        NOT_FOUND: {};
+        BAD_REQUEST: {};
+      }>, Record<never, never>>;
+    };
+  };
+  projects: {
+    update: {
+      v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        projectId: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        sourceRepository: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        teamId: z.ZodString;
+        sourceRepository: z.ZodNullable<z.ZodString>;
+        runtime: z.ZodEnum<{
+          "python3.13": "python3.13";
+          "python3.14": "python3.14";
+          node22: "node22";
+          node24: "node24";
+        }>;
+        transport: z.ZodNullable<z.ZodEnum<{
+          stdio: "stdio";
+          sse: "sse";
+          streamablehttp: "streamablehttp";
+        }>>;
+        rootDirectory: z.ZodNullable<z.ZodString>;
+        buildCommand: z.ZodNullable<z.ZodString>;
+        buildOutputDir: z.ZodNullable<z.ZodString>;
+        installCommand: z.ZodNullable<z.ZodString>;
+        startCommand: z.ZodNullable<z.ZodString>;
+        createdAt: z.ZodCoercedDate<unknown>;
+        productionEnvironment: z.ZodNullable<z.ZodObject<{
+          id: z.ZodString;
+          name: z.ZodString;
+          mcpServerUrl: z.ZodString;
+          domains: z.ZodArray<z.ZodObject<{
+            domain: z.ZodString;
+            status: z.ZodEnum<{
+              ongoing: "ongoing";
+              deployed: "deployed";
+              failed: "failed";
+            }>;
+            createdAt: z.ZodCoercedDate<unknown>;
+          }, z.core.$strip>>;
+          latestDeployment: z.ZodNullable<z.ZodObject<{
+            id: z.ZodString;
+            status: z.ZodEnum<{
+              ongoing: "ongoing";
+              deployed: "deployed";
+              failed: "failed";
+              canceled: "canceled";
+            }>;
+            sourceCommitId: z.ZodNullable<z.ZodString>;
+            sourceCommitMessage: z.ZodNullable<z.ZodString>;
+            completedAt: z.ZodNullable<z.ZodCoercedDate<unknown>>;
+          }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        environments: z.ZodArray<z.ZodObject<{
+          id: z.ZodString;
+          name: z.ZodString;
+          sourceBranch: z.ZodNullable<z.ZodString>;
+          mcpServerUrl: z.ZodString;
+          createdAt: z.ZodCoercedDate<unknown>;
+          projectId: z.ZodString;
+          latestDeployment: z.ZodNullable<z.ZodObject<{
+            id: z.ZodString;
+            status: z.ZodEnum<{
+              ongoing: "ongoing";
+              deployed: "deployed";
+              failed: "failed";
+              canceled: "canceled";
+            }>;
+            sourceCommitId: z.ZodNullable<z.ZodString>;
+            sourceCommitMessage: z.ZodNullable<z.ZodString>;
+            completedAt: z.ZodNullable<z.ZodCoercedDate<unknown>>;
+          }, z.core.$strip>>;
+        }, z.core.$strip>>;
+      }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        NOT_FOUND: {};
+        BAD_REQUEST: {};
+        FORBIDDEN: {};
+      }>, Record<never, never>>;
+    };
+    get: {
+      v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        projectId: z.ZodString;
+      }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        teamId: z.ZodString;
+        sourceRepository: z.ZodNullable<z.ZodString>;
+        runtime: z.ZodEnum<{
+          "python3.13": "python3.13";
+          "python3.14": "python3.14";
+          node22: "node22";
+          node24: "node24";
+        }>;
+        transport: z.ZodNullable<z.ZodEnum<{
+          stdio: "stdio";
+          sse: "sse";
+          streamablehttp: "streamablehttp";
+        }>>;
+        rootDirectory: z.ZodNullable<z.ZodString>;
+        buildCommand: z.ZodNullable<z.ZodString>;
+        buildOutputDir: z.ZodNullable<z.ZodString>;
+        installCommand: z.ZodNullable<z.ZodString>;
+        startCommand: z.ZodNullable<z.ZodString>;
+        createdAt: z.ZodCoercedDate<unknown>;
+        productionEnvironment: z.ZodNullable<z.ZodObject<{
+          id: z.ZodString;
+          name: z.ZodString;
+          mcpServerUrl: z.ZodString;
+          domains: z.ZodArray<z.ZodObject<{
+            domain: z.ZodString;
+            status: z.ZodEnum<{
+              ongoing: "ongoing";
+              deployed: "deployed";
+              failed: "failed";
+            }>;
+            createdAt: z.ZodCoercedDate<unknown>;
+          }, z.core.$strip>>;
+          latestDeployment: z.ZodNullable<z.ZodObject<{
+            id: z.ZodString;
+            status: z.ZodEnum<{
+              ongoing: "ongoing";
+              deployed: "deployed";
+              failed: "failed";
+              canceled: "canceled";
+            }>;
+            sourceCommitId: z.ZodNullable<z.ZodString>;
+            sourceCommitMessage: z.ZodNullable<z.ZodString>;
+            completedAt: z.ZodNullable<z.ZodCoercedDate<unknown>>;
+          }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        environments: z.ZodArray<z.ZodObject<{
+          id: z.ZodString;
+          name: z.ZodString;
+          sourceBranch: z.ZodNullable<z.ZodString>;
+          mcpServerUrl: z.ZodString;
+          createdAt: z.ZodCoercedDate<unknown>;
+          projectId: z.ZodString;
+          latestDeployment: z.ZodNullable<z.ZodObject<{
+            id: z.ZodString;
+            status: z.ZodEnum<{
+              ongoing: "ongoing";
+              deployed: "deployed";
+              failed: "failed";
+              canceled: "canceled";
+            }>;
+            sourceCommitId: z.ZodNullable<z.ZodString>;
+            sourceCommitMessage: z.ZodNullable<z.ZodString>;
+            completedAt: z.ZodNullable<z.ZodCoercedDate<unknown>>;
+          }, z.core.$strip>>;
+        }, z.core.$strip>>;
+      }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        NOT_FOUND: {};
+      }>, Record<never, never>>;
+    };
+    list: {
+      v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodOptional<z.ZodObject<{
+        teamId: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>>, z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        teamId: z.ZodString;
+        sourceRepository: z.ZodNullable<z.ZodString>;
+        runtime: z.ZodEnum<{
+          "python3.13": "python3.13";
+          "python3.14": "python3.14";
+          node22: "node22";
+          node24: "node24";
+        }>;
+        transport: z.ZodNullable<z.ZodEnum<{
+          stdio: "stdio";
+          sse: "sse";
+          streamablehttp: "streamablehttp";
+        }>>;
+        rootDirectory: z.ZodNullable<z.ZodString>;
+        buildCommand: z.ZodNullable<z.ZodString>;
+        buildOutputDir: z.ZodNullable<z.ZodString>;
+        installCommand: z.ZodNullable<z.ZodString>;
+        startCommand: z.ZodNullable<z.ZodString>;
+        createdAt: z.ZodCoercedDate<unknown>;
+        productionEnvironment: z.ZodNullable<z.ZodObject<{
+          id: z.ZodString;
+          name: z.ZodString;
+          mcpServerUrl: z.ZodString;
+          domains: z.ZodArray<z.ZodObject<{
+            domain: z.ZodString;
+            status: z.ZodEnum<{
+              ongoing: "ongoing";
+              deployed: "deployed";
+              failed: "failed";
+            }>;
+            createdAt: z.ZodCoercedDate<unknown>;
+          }, z.core.$strip>>;
+          latestDeployment: z.ZodNullable<z.ZodObject<{
+            id: z.ZodString;
+            status: z.ZodEnum<{
+              ongoing: "ongoing";
+              deployed: "deployed";
+              failed: "failed";
+              canceled: "canceled";
+            }>;
+            sourceCommitId: z.ZodNullable<z.ZodString>;
+            sourceCommitMessage: z.ZodNullable<z.ZodString>;
+            completedAt: z.ZodNullable<z.ZodCoercedDate<unknown>>;
+          }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        environments: z.ZodArray<z.ZodObject<{
+          id: z.ZodString;
+          name: z.ZodString;
+          sourceBranch: z.ZodNullable<z.ZodString>;
+          mcpServerUrl: z.ZodString;
+          createdAt: z.ZodCoercedDate<unknown>;
+          projectId: z.ZodString;
+          latestDeployment: z.ZodNullable<z.ZodObject<{
+            id: z.ZodString;
+            status: z.ZodEnum<{
+              ongoing: "ongoing";
+              deployed: "deployed";
+              failed: "failed";
+              canceled: "canceled";
+            }>;
+            sourceCommitId: z.ZodNullable<z.ZodString>;
+            sourceCommitMessage: z.ZodNullable<z.ZodString>;
+            completedAt: z.ZodNullable<z.ZodCoercedDate<unknown>>;
+          }, z.core.$strip>>;
+        }, z.core.$strip>>;
+      }, z.core.$strip>>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        NOT_FOUND: {};
+        BAD_REQUEST: {};
+      }>, Record<never, never>>;
+    };
+    create: {
+      v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        teamId: z.ZodOptional<z.ZodString>;
+        name: z.ZodString;
+        sourceRepository: z.ZodOptional<z.ZodString>;
+        branchName: z.ZodOptional<z.ZodString>;
+        runtime: z.ZodEnum<{
+          "python3.13": "python3.13";
+          "python3.14": "python3.14";
+          node22: "node22";
+          node24: "node24";
+        }>;
+        transport: z.ZodOptional<z.ZodEnum<{
+          stdio: "stdio";
+          sse: "sse";
+          streamablehttp: "streamablehttp";
+        }>>;
+        rootDirectory: z.ZodOptional<z.ZodString>;
+        settings: z.ZodDefault<z.ZodObject<{
+          installCommand: z.ZodOptional<z.ZodString>;
+          buildCommand: z.ZodOptional<z.ZodString>;
+          buildOutputDir: z.ZodOptional<z.ZodString>;
+          startCommand: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        environmentVariables: z.ZodDefault<z.ZodArray<z.ZodObject<{
+          key: z.ZodString;
+          value: z.ZodString;
+          isSecret: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+      }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        teamId: z.ZodString;
+        environments: z.ZodArray<z.ZodObject<{
+          id: z.ZodString;
+          name: z.ZodString;
+        }, z.core.$strip>>;
+        productionEnvironment: z.ZodNullable<z.ZodObject<{
+          id: z.ZodString;
+          name: z.ZodString;
+        }, z.core.$strip>>;
+        sourceRepository: z.ZodNullable<z.ZodString>;
+        runtime: z.ZodEnum<{
+          "python3.13": "python3.13";
+          "python3.14": "python3.14";
+          node22: "node22";
+          node24: "node24";
+        }>;
+        transport: z.ZodNullable<z.ZodEnum<{
+          stdio: "stdio";
+          sse: "sse";
+          streamablehttp: "streamablehttp";
+        }>>;
+        rootDirectory: z.ZodNullable<z.ZodString>;
+        buildCommand: z.ZodNullable<z.ZodString>;
+        buildOutputDir: z.ZodNullable<z.ZodString>;
+        installCommand: z.ZodNullable<z.ZodString>;
+        startCommand: z.ZodNullable<z.ZodString>;
+        createdAt: z.ZodCoercedDate<unknown>;
+      }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        NOT_FOUND: {};
+        BAD_REQUEST: {};
+        FORBIDDEN: {};
+      }>, Record<never, never>>;
+    };
+    delete: {
+      v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        projectId: z.ZodString;
+      }, z.core.$strip>, z.ZodObject<{
+        success: z.ZodLiteral<true>;
+      }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        NOT_FOUND: {};
+      }>, Record<never, never>>;
+    };
+  };
+  playground: {
+    get: {
+      v1: import("@orpc/contract").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>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        NOT_FOUND: {};
+      }>, Record<never, never>>;
+    };
+    upsert: {
+      v1: import("@orpc/contract").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>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        NOT_FOUND: {};
+        BAD_REQUEST: {};
+      }>, Record<never, never>>;
+    };
+  };
+  tunnels: {
+    getTicket: {
+      v1: import("@orpc/contract").ContractProcedureBuilderWithOutput<import("@orpc/contract").Schema<unknown, unknown>, z.ZodObject<{
+        subdomain: z.ZodString;
+        ticket: z.ZodString;
+        tunnelHost: z.ZodString;
+      }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        FORBIDDEN: {};
+      }>, Record<never, never>>;
+    };
+  };
+  distribution: {
+    publish: {
+      v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        projectId: z.ZodString;
+        domain: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodString;
+        websiteUrl: z.ZodOptional<z.ZodURL>;
+        iconSrc: z.ZodOptional<z.ZodURL>;
+        dryRun: z.ZodOptional<z.ZodBoolean>;
+      }, z.core.$strip>, z.ZodObject<{
+        serverFields: z.ZodObject<{
+          $schema: z.ZodString;
+          name: z.ZodString;
+          description: z.ZodString;
+          version: z.ZodOptional<z.ZodString>;
+          title: z.ZodOptional<z.ZodString>;
+          websiteUrl: z.ZodOptional<z.ZodURL>;
+          icons: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            src: z.ZodURL;
+            mimeType: z.ZodOptional<z.ZodString>;
+            sizes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+          }, z.core.$strip>>>;
+          remotes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodString;
+            url: z.ZodOptional<z.ZodURL>;
+            headers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+              name: z.ZodString;
+              description: z.ZodString;
+              isRequired: z.ZodOptional<z.ZodBoolean>;
+              isSecret: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>>;
+          }, z.core.$strip>>>;
+        }, z.core.$strip>;
+      }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        NOT_FOUND: {};
+        BAD_REQUEST: {};
+      }>, Record<never, never>>;
+    };
+    get: {
+      v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        projectId: z.ZodString;
+        domain: z.ZodString;
+      }, z.core.$strip>, z.ZodObject<{
+        serverFields: z.ZodObject<{
+          $schema: z.ZodString;
+          name: z.ZodString;
+          description: z.ZodString;
+          version: z.ZodOptional<z.ZodString>;
+          title: z.ZodOptional<z.ZodString>;
+          websiteUrl: z.ZodOptional<z.ZodURL>;
+          icons: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            src: z.ZodURL;
+            mimeType: z.ZodOptional<z.ZodString>;
+            sizes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+          }, z.core.$strip>>>;
+          remotes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodString;
+            url: z.ZodOptional<z.ZodURL>;
+            headers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+              name: z.ZodString;
+              description: z.ZodString;
+              isRequired: z.ZodOptional<z.ZodBoolean>;
+              isSecret: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>>;
+          }, z.core.$strip>>>;
+        }, z.core.$strip>;
+      }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        NOT_FOUND: {};
+        BAD_REQUEST: {};
+      }>, Record<never, never>>;
+    };
+  };
+  beacon: {
+    create: {
+      v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        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>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        NOT_FOUND: {};
+        BAD_REQUEST: {};
+        DNS_RESOLUTION_FAILED: {
+          status: number;
+        };
+      }>, Record<never, never>>;
+    };
+    get: {
+      v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        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";
+        }>;
+        durationMs: z.ZodNullable<z.ZodNumber>;
+        createdAt: z.ZodCoercedDate<unknown>;
+        report: z.ZodNullable<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;
+            checkName: z.ZodString;
+            description: 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.ZodObject<{
+            chatgpt: z.ZodOptional<z.ZodString>;
+            claudeai: z.ZodOptional<z.ZodString>;
+          }, 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>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        NOT_FOUND: {};
+      }>, Record<never, never>>;
+    };
+  };
+};
 type RouterInput = InferContractRouterInputs<typeof contract>;
 type RouterOutput = InferContractRouterOutputs<typeof contract>;
 //#endregion
@@ -1041,4 +1943,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, createEnvironmentContractV1, deploymentStatusSchema, environmentVariableSchema, environmentVariablesSchema, playgroundExamplePromptSchema, playgroundHeaderSchema, runtimeSchema, serverFieldsSchema, transportSchema, updateEnvironmentVariableSchema };
+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 };

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.29.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.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/auth.js
 /**
 * Reusable URL validation that disallows javascript: scheme
 */
@@ -283,33 +283,18 @@ const deploymentSummarySchema = z.object({
 	createdAt: z.coerce.date(),
 	updatedAt: z.coerce.date()
 });
-/**
-* Public environment
-*
-* Answers anonymously and exposes no OAuth metadata.
-*/
+/** Public environment: answers anonymously and exposes no OAuth metadata. */
 const publicEnvironmentSchema = z.object({
 	allowsAnonymous: z.literal(true),
 	oAuthMetadata: z.strictObject({})
 });
-/**
-* Protected environment with an external resource metadata URL
-*
-* An external resource metadata URL is returned in the WWW-Authenticate header during the first 401 response.
-* Everything that follows is handled outside of the MCP server scope.
-*/
+/** Protected environment whose external resource metadata URL is returned in the WWW-Authenticate header on the first 401; everything after is handled outside the MCP server scope. */
 const externalResourceMetadataEnvironmentSchema = z.object({
 	allowsAnonymous: z.boolean(),
 	oAuthMetadata: z.object({ externalResourceMetadataUrl: z.url() }),
 	scope: z.string().optional()
 });
-/**
-* Protected environment with an external authorization server URL
-*
-* The server itself exposes the /.well-known/oauth-protected-resource endpoint.
-* An external authorization server URL is returned when requesting the endpoint.
-* Everything that follows is handled outside of the MCP server scope.
-*/
+/** Protected environment whose own /.well-known/oauth-protected-resource endpoint points at an external authorization server; everything after is handled outside the MCP server scope. */
 const externalAuthorizationServerEnvironmentSchema = z.object({
 	allowsAnonymous: z.boolean(),
 	oAuthMetadata: z.object({
@@ -318,12 +303,7 @@ const externalAuthorizationServerEnvironmentSchema = z.object({
 	}),
 	scope: z.string().optional()
 });
-/**
-* Standalone protected environment
-*
-* The server itself exposes the /.well-known/oauth-protected-resource endpoint.
-* The server itself exposes the /.well-known/oauth-authorization-server endpoint.
-*/
+/** Standalone protected environment: the server itself exposes both the /.well-known/oauth-protected-resource and /.well-known/oauth-authorization-server endpoints. */
 const standaloneEnvironmentSchema = z.object({
 	allowsAnonymous: z.boolean(),
 	oAuthMetadata: z.object({
@@ -332,13 +312,7 @@ const standaloneEnvironmentSchema = z.object({
 	}),
 	scope: z.string().optional()
 });
-/**
-* Protected environment without OAuth discovery
-*
-* The server enforces authentication but exposes no OAuth discovery metadata.
-* Neither /.well-known/oauth-protected-resource nor /.well-known/oauth-authorization-server
-* are advertised. Clients must obtain credentials out-of-band.
-*/
+/** Protected environment that enforces authentication but advertises no OAuth discovery metadata; clients must obtain credentials out-of-band. */
 const protectedWithoutDiscoveryEnvironmentSchema = z.object({
 	allowsAnonymous: z.literal(false),
 	oAuthMetadata: z.strictObject({}),
@@ -425,7 +399,8 @@ z.object({
 	collectRequestPayload: z.boolean(),
 	collectResponsePayload: z.boolean(),
 	collectErrorMessage: z.boolean(),
-	collectUserData: z.boolean()
+	collectUserData: z.boolean(),
+	identityTraitKey: z.string().min(1).max(200).nullable()
 });
 z.object({
 	id: z.string(),
@@ -532,6 +507,246 @@ z.enum([
 	"DEBUG",
 	"ERROR"
 ]);
+/** Only names a vendor actually ships belong here: lookalikes like `claude-code-test` are customers' own scripts. */
+const MCP_CLIENT_GROUPS = [
+	{
+		id: "claude_code",
+		label: "Claude Code",
+		vendor: "anthropic",
+		rawNames: ["claude-code", "Anthropic/ClaudeCodeDesktop"]
+	},
+	{
+		id: "claude",
+		label: "Claude",
+		vendor: "anthropic",
+		rawNames: [
+			"Anthropic/ClaudeAI",
+			"claude-ai",
+			"claude",
+			"Claude",
+			"claude-desktop",
+			"claude-desktop-3p"
+		]
+	},
+	{
+		id: "claude_mobile",
+		label: "Claude mobile",
+		vendor: "anthropic",
+		rawNames: ["claude-ios", "ClaudeAndroid"]
+	},
+	{
+		id: "claude_cowork",
+		label: "Claude Cowork",
+		vendor: "anthropic",
+		rawNames: ["Anthropic/Cowork"]
+	},
+	{
+		id: "claude_toolbox",
+		label: "Claude Toolbox",
+		vendor: "anthropic",
+		rawNames: ["Anthropic/Toolbox", "Anthropic/toolbox-bootstrap"]
+	},
+	{
+		id: "anthropic_api",
+		label: "Anthropic API",
+		vendor: "anthropic",
+		rawNames: ["Anthropic/API"]
+	},
+	{
+		id: "anthropic_connector_refresh",
+		label: "Anthropic (connector refresh)",
+		vendor: "anthropic",
+		rawNames: ["Anthropic"]
+	},
+	{
+		id: "codex",
+		label: "Codex",
+		vendor: "openai",
+		rawNames: [
+			"codex-mcp-client",
+			"codex",
+			"Codex",
+			"codex-cli",
+			"openai-mcp (Codex)"
+		]
+	},
+	{
+		id: "chatgpt",
+		label: "ChatGPT",
+		vendor: "openai",
+		rawNames: ["openai-mcp (ChatGPT)"]
+	},
+	{
+		id: "openai_responses_api",
+		label: "OpenAI Responses API",
+		vendor: "openai",
+		rawNames: ["openai-mcp (Responses API)"]
+	},
+	{
+		id: "openai_agent_builder",
+		label: "OpenAI Agent Builder",
+		vendor: "openai",
+		rawNames: ["openai-mcp (Agent Builder)"]
+	},
+	{
+		id: "openai_other",
+		label: "OpenAI Other",
+		vendor: "openai",
+		rawNames: ["openai-mcp"]
+	},
+	{
+		id: "cursor",
+		label: "Cursor",
+		vendor: "cursor",
+		rawNames: [
+			"cursor-vscode",
+			"Cursor",
+			"cursor"
+		]
+	},
+	{
+		id: "cline",
+		label: "Cline",
+		vendor: "cline",
+		rawNames: [
+			"Cline",
+			"cline",
+			"@cline/core"
+		]
+	},
+	{
+		id: "github_copilot",
+		label: "GitHub Copilot",
+		vendor: "githubCopilot",
+		rawNames: [
+			"Copilot",
+			"github-copilot-developer",
+			"Copilot MCP Gateway",
+			"Xcode/copilot-xcode"
+		]
+	},
+	{
+		id: "gemini_cli",
+		label: "Gemini CLI",
+		vendor: "google",
+		rawNames: ["gemini-cli-mcp-client", "gemini-cli"]
+	},
+	{
+		id: "antigravity",
+		label: "Antigravity",
+		vendor: "google",
+		rawNames: ["antigravity-client"]
+	},
+	{
+		id: "gemini",
+		label: "Gemini",
+		vendor: "google",
+		rawNames: ["Gemini", "google-ai-edge-gallery"]
+	},
+	{
+		id: "windsurf",
+		label: "Windsurf",
+		vendor: "windsurf",
+		rawNames: ["Windsurf", "windsurf-client"]
+	},
+	{
+		id: "mistral",
+		label: "Mistral / Le Chat",
+		vendor: "mistral",
+		rawNames: ["Mistral"],
+		rawNamePrefixes: ["connector:custom-mcp:"]
+	},
+	{
+		id: "n8n",
+		label: "n8n",
+		vendor: "n8n",
+		rawNames: [
+			"@n8n/n8n-nodes-langchain.mcpClient",
+			"@n8n/n8n-nodes-langchain.mcpClientTool",
+			"n8n"
+		]
+	},
+	{
+		id: "alpic_playground",
+		label: "Alpic Playground",
+		vendor: "alpic",
+		rawNames: ["alpic-playground", "playground"]
+	},
+	{
+		id: "opencode",
+		label: "opencode",
+		vendor: "opencode",
+		rawNames: ["opencode"]
+	},
+	{
+		id: "zed",
+		label: "Zed",
+		vendor: "zed",
+		rawNames: ["Zed", "zed"]
+	},
+	{
+		id: "zapier",
+		label: "Zapier",
+		vendor: "zapier",
+		rawNames: ["Zapier", "zapier"]
+	},
+	{
+		id: "make",
+		label: "Make",
+		vendor: "make",
+		rawNames: ["Make", "make"]
+	},
+	{
+		id: "librechat",
+		label: "LibreChat",
+		vendor: "mcp",
+		rawNames: ["LibreChat", "librechat"]
+	},
+	{
+		id: "jan",
+		label: "Jan",
+		vendor: "mcp",
+		rawNames: ["Jan", "jan"]
+	},
+	{
+		id: "goose",
+		label: "goose",
+		vendor: "mcp",
+		rawNames: ["goose", "Goose"]
+	},
+	{
+		id: "mcphost",
+		label: "mcphost",
+		vendor: "mcp",
+		rawNames: ["mcphost"]
+	},
+	{
+		id: "mcporter",
+		label: "mcporter",
+		vendor: "mcp",
+		rawNames: ["mcporter"]
+	},
+	{
+		id: "rmcp",
+		label: "rmcp",
+		vendor: "mcp",
+		rawNames: ["rmcp"]
+	},
+	{
+		id: "unnamed_client",
+		label: "Unnamed client",
+		vendor: "mcp",
+		rawNames: [
+			"mcp",
+			"unknown",
+			""
+		]
+	}
+];
+/** A source pattern, not a RegExp, because analytics renders the same rule into ClickHouse RE2, which shares this syntax. */
+const MCP_REMOTE_WRAPPER_SUFFIX = String.raw` \(via mcp-remote [^\n]+?\)$`;
+new RegExp(MCP_REMOTE_WRAPPER_SUFFIX);
+new Map(MCP_CLIENT_GROUPS.map((group) => [group.id, group]));
 const runtimeSchema = z.enum([
 	"python3.13",
 	"python3.14",
@@ -609,15 +824,7 @@ z.object({
 	serverFields: serverFieldsSchema$1,
 	source: z.enum(["registry", "defaults"])
 });
-/**
-* Returns a variant of a `maxLength`-constrained string that clamps (truncates) instead of
-* rejecting on overflow — used for AI-generated copy where the model routinely overshoots.
-*
-* NOTE: this rebuilds the schema from scratch, carrying over only `maxLength` (as a clamp),
-* `minLength`, and the description. Any other validators on the source field (`.regex()`,
-* `.email()`, custom refinements) are intentionally dropped — this helper is meant for plain
-* free-text length caps only. A field with `null` `maxLength` is returned unchanged.
-*/
+/** Clamps instead of rejecting on max-length overflow (for AI-generated copy that overshoots); intentionally carries over only maxLength, minLength, and description, dropping any other validators. */
 const clampStringField = (field) => {
 	const max = field.maxLength;
 	if (max === null) return field;
@@ -963,11 +1170,7 @@ const chatgptToolJustificationSchema = z.object({
 	openWorldJustification: z.string().describe("One sentence on whether the tool reaches external systems beyond your own service."),
 	destructiveJustification: z.string().describe("One sentence on whether the tool changes data. For a read-only tool, state the full triad: \"No data is created, modified, or deleted.\"")
 }).describe("Per-tool justification of each MCP annotation value (one specific sentence per hint).");
-/**
-* Base copy fields, defined once and reused by both the submission form and per-locale
-* translations so the constraints (tagline ≤ 30 chars) never drift. The translation generation
-* path wraps these in {@link clampStringField} since the LLM tends to overshoot the limit.
-*/
+/** Defined once and reused by both the submission form and per-locale translations so the tagline ≤ 30 chars constraint never drifts. */
 const chatgptTaglineSchema = z.string().max(30);
 const chatgptDescriptionSchema = z.string();
 const chatgptTranslationSchema = z.object({
@@ -976,10 +1179,7 @@ const chatgptTranslationSchema = z.object({
 	description: chatgptDescriptionSchema
 }).describe("Locale-scoped override for tagline + description. English (US) is the default.");
 chatgptTranslationSchema.extend({ tagline: clampStringField(chatgptTaglineSchema) });
-/**
-* Field order mirrors the ChatGPT (OpenAI) submission spreadsheet, grouped by section.
-* When adding/removing/reordering fields, keep this in sync with the sheet.
-*/
+/** Field order mirrors the ChatGPT (OpenAI) submission spreadsheet, grouped by section; keep it in sync with the sheet. */
 const chatgptSubmissionFormDataSchema = z.object({
 	logoLight: z.string().describe("Logo icon for light mode. Square PNG, no borders or rounded corners (clients apply circular cropping)."),
 	logoDark: z.string().optional().describe("Optional dark-mode logo icon. Square PNG, same specs as the light icon. Leave empty if the light icon also works on dark backgrounds."),
@@ -1076,11 +1276,7 @@ const claudePolicyAcknowledgementSchema = z.enum([
 	"My connector does not collect conversation data beyond what is needed for its function.",
 	"Public documentation for this connector will be live by the publish date."
 ]);
-/**
-* Field order mirrors the claude.ai directory submission wizard
-* (`claude.ai/admin-settings/directory/submissions/new`), grouped by step.
-* When adding/removing/reordering fields, keep this in sync with the wizard.
-*/
+/** Field order mirrors the claude.ai directory submission wizard (`claude.ai/admin-settings/directory/submissions/new`), grouped by step; keep it in sync with the wizard. */
 const claudeSubmissionFormDataSchema = z.object({
 	serverUrl: z.url().describe(`The full https:// URL where your MCP server is hosted and reachable. In the claude.ai wizard this is read live
 from the custom connector you select — the connection is used to verify the URL and the tool list at submission time.
@@ -1172,12 +1368,7 @@ claudeSubmissionFormDataSchema.pick({
 	connectionRequirements: claudeSubmissionFormDataSchema.shape.connectionRequirements.optional(),
 	testInstructions: claudeSubmissionFormDataSchema.shape.testInstructions.optional()
 });
-/**
-* Narrative fields the LLM-backed generation step produces for Claude submissions.
-* This schema accepts the slightly loose shape returned by AI generation, then normalizes it into
-* the strict form shape. Keep transforms here rather than in callers so generation leniency is
-* colocated with the Claude contract.
-*/
+/** Loose shape returned by AI generation for Claude narrative fields; transforms live here so generation leniency stays colocated with the Claude contract. */
 const claudeAiGeneratedFormDataRawSchema = z.object({
 	oneLiner: claudeSubmissionFormDataSchema.shape.oneLiner,
 	description: claudeSubmissionFormDataSchema.shape.description,
@@ -1269,7 +1460,10 @@ const RESERVED_KEYS = [
 	"BUILD_ARG_START_COMMAND",
 	"ALPIC_HOST",
 	"ALPIC_CUSTOM_DOMAINS",
-	"ALPIC_INTENT_META_KEY"
+	"ALPIC_INTENT_META_KEY",
+	"ALPIC_FEEDBACK_META_KEY",
+	"ALPIC_EVENTS_META_KEY",
+	"ALPIC_IDENTIFY_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"),
@@ -1915,5 +2109,10 @@ const contract = {
 		get: { v1: getBeaconContractV1 }
 	}
 };
+const { uploadArtifact: _discard, ...deploymentsForDocs } = contract.deployments;
+const contractForDocs = {
+	...contract,
+	deployments: deploymentsForDocs
+};
 //#endregion
-export { AUTH_SCOPE_ANY, AUTH_SCOPE_USER, PLATFORM_LABELS, buildSettingsSchema, contract, createEnvironmentContractV1, deploymentStatusSchema, environmentVariableSchema, environmentVariablesSchema, playgroundExamplePromptSchema, playgroundHeaderSchema, runtimeSchema, serverFieldsSchema, transportSchema, updateEnvironmentVariableSchema };
+export { AUTH_SCOPE_ANY, AUTH_SCOPE_USER, PLATFORM_LABELS, buildSettingsSchema, contract, contractForDocs, 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-dev.gef3a775",
+  "version": "0.0.0-dev.gef9a9d1",
   "description": "Contract for the Alpic API",
   "type": "module",
   "main": "./dist/index.mjs",
@@ -33,17 +33,17 @@
   "author": "Alpic",
   "license": "ISC",
   "dependencies": {
-    "@orpc/contract": "^1.14.8",
+    "@orpc/contract": "^1.14.13",
     "ms": "^2.1.3",
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@orpc/openapi": "^1.14.8",
-    "@orpc/zod": "^1.14.8",
+    "@orpc/openapi": "^1.14.13",
+    "@orpc/zod": "^1.14.13",
     "@total-typescript/tsconfig": "^1.0.4",
     "@types/ms": "^2.1.0",
     "shx": "^0.4.0",
-    "tsdown": "^0.22.9",
+    "tsdown": "^0.22.14",
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
     "@alpic-ai/domains": "0.0.0"