@allbluecn/kernel 0.3.0 → 0.4.0

package/dist/index.d.ts

@@ -397,7 +397,7 @@ interface AnalyticsService {
 }
 //#endregion
 //#region src/pro-contract/global-search.d.ts
-interface SearchResult {
+interface SearchResult$1 {
   id: string;
   type: 'document' | 'project' | 'story' | 'comment' | 'user' | 'tag';
   title: string;
@@ -410,13 +410,13 @@ interface SearchResult {
 interface SearchParams {
   query: string;
   workspaceId?: string | null;
-  types?: Array<SearchResult['type']>;
+  types?: Array<SearchResult$1['type']>;
   limit?: number;
   offset?: number;
 }
 interface GlobalSearchService {
   search(params: SearchParams): Promise<{
-    results: SearchResult[];
+    results: SearchResult$1[];
     total: number;
   }>;
   index(documentId: string, content: string, metadata: Record<string, unknown>): Promise<void>;
@@ -597,5 +597,1487 @@ interface ServerSeam {
 }
 declare function registerServerSeam(impl: ServerSeam): void;
 declare function getServerSeam(): ServerSeam;
+/**
+ * PrismaSeam — 注入式 prisma 接入点
+ *
+ * 解决 shared → database (prisma) → shared 的循环依赖：
+ * shared 包声明 seam 接口，database 包启动时注册实现。
+ * 复用 kernel 的 ServerSeam 注入模式。
+ */
+interface PrismaSeam {
+  reference: {
+    create: (data: unknown) => Promise<unknown>;
+    findMany: (where: unknown) => Promise<unknown[]>;
+  };
+  $queryRawUnsafe: <T = Record<string, unknown>>(sql: string, ...params: unknown[]) => Promise<T[]>;
+}
+declare function registerPrismaSeam(seam: PrismaSeam): void;
+//#endregion
+//#region src/contract/constants/perf.d.ts
+declare const VIRTUALIZE_THRESHOLD = 250;
+declare const LOAD_MORE_STEP = 200;
+declare const DND_STICKY_THRESHOLD = 500;
+//#endregion
+//#region src/contract/modules/ai-providers/types.d.ts
+type AdapterKind = 'openai' | 'anthropic' | 'gemini' | 'groq' | 'grok' | 'openrouter' | 'ollama' | 'openai-compatible';
+type ProviderCategory = 'recommended' | 'popular' | 'local';
+type ModelCapability = 'text' | 'vision' | 'tools' | 'reasoning' | 'audio';
+interface AiModelMeta {
+  /** 模型 ID（传给 adapter 的 model 字符串） */
+  id: string;
+  /** 显示名 */
+  displayName: string;
+  /** 上下文窗口（tokens） */
+  contextWindow?: number;
+  /** 能力标签 */
+  capabilities?: ModelCapability[];
+  /** 是否默认勾选 */
+  defaultEnabled?: boolean;
+  /** 模型图标 slug（后台配置，@lobehub/icons PascalCase 导出名），未配置时 fallback 到服务商图标 */
+  iconSlug?: string;
+  /** 发布日期 YYYY-MM-DD */
+  releaseDate?: string;
+  /** 输入价格（$/百万 tokens） */
+  inputPrice?: number;
+  /** 输出价格（$/百万 tokens） */
+  outputPrice?: number;
+  /** 自定义标签（如「旗舰」「快速」），区别于 capabilities 能力标签 */
+  tags?: string[];
+}
+/** 服务商完整元数据（admin 表单 + DB 行 + 前端展示共用） */
+interface AiProviderMeta {
+  /** 业务标识（"openai" "anthropic" 等），与数据库 providerId 字段对应 */
+  providerId: string;
+  displayName: string;
+  brandName: string;
+  description: string;
+  category: ProviderCategory;
+  iconSlug: string;
+  brandColor: string;
+  /** 卡片角标文案（如「推荐」「热门」「NEW」），admin 可配，留空则不显示 */
+  badge?: string;
+  adapterKind: AdapterKind;
+  defaultBaseUrl?: string;
+  keyUrl?: string;
+  docsUrl?: string;
+  keyPlaceholder?: string;
+  isLocal?: boolean;
+  models: AiModelMeta[];
+}
+/** admin 表格行：DB 行 + 关联用户配置数 */
+interface AiProviderRow extends AiProviderMeta {
+  /** DB 主键 */
+  id: string;
+  enabled: boolean;
+  sortOrder: number;
+  /** 已配置此服务商的用户数 */
+  configCount: number;
+  createdAt: string;
+  updatedAt: string;
+}
+/** 卡片角标的预设颜色（按文案匹配），admin 也可自由输入文案 */
+declare const PROVIDER_BADGE_STYLES: Record<string, string>;
+//#endregion
+//#region src/contract/modules/ai-providers/constants.d.ts
+declare const ADAPTER_KINDS: Array<{
+  value: AdapterKind;
+  label: string;
+  description: string;
+}>;
+declare const PROVIDER_CATEGORIES: Array<{
+  value: ProviderCategory;
+  label: string;
+}>;
+declare const ADAPTER_KIND_VALUES: AdapterKind[];
+declare const PROVIDER_CATEGORY_VALUES: ProviderCategory[];
+declare const MODEL_CAPABILITY_OPTIONS: Array<{
+  value: ModelCapability;
+  label: string;
+}>;
+/**
+ * 模型管理 tabs 筛选项（参考 lobehub）。
+ * value 对应 ModelCapability，'all' 为全部，'video' 暂预留（无对应 capability）。
+ */
+type ModelTab = 'all' | 'text' | 'reasoning' | 'tools' | 'vision' | 'video';
+declare const MODEL_TABS: Array<{
+  value: ModelTab;
+  label: string;
+}>;
+/**
+ * our providerId → @lobehub/icons PascalCase 导出名
+ * 未知 providerId 返回 null，调用方 fallback 到首字母
+ */
+declare const LOBE_ICON_MAP: Record<string, string>;
+//#endregion
+//#region src/contract/modules/ai-providers/seed-data.d.ts
+/** 10 个最受欢迎 AI 服务商的种子数据，admin 可在其基础上增删改 */
+declare const SEED_AI_PROVIDERS: AiProviderMeta[];
+//#endregion
+//#region src/contract/modules/dependencies/index.d.ts
+/** 依赖分类 */
+type DependencyCategory = 'framework' | 'ui' | 'editor' | 'ai' | 'state' | 'auth' | 'tool' | 'other';
+/** 优先级 */
+type DependencyPriority = 'high' | 'normal' | 'low';
+/** 版本状态（前端展示用，由 serverFn 计算） */
+type VersionStatus = 'latest' | 'patch' | 'minor' | 'major' | 'unknown';
+/** 依赖分类元信息 */
+declare const DEPENDENCY_CATEGORIES: Array<{
+  value: DependencyCategory;
+  label: string;
+  description: string;
+}>;
+declare const DEPENDENCY_PRIORITIES: Array<{
+  value: DependencyPriority;
+  label: string;
+}>;
+/** monorepo 中某个 app 的使用情况 */
+interface DependencyUsage {
+  /** 相对路径，如 "apps/web" */
+  app: string;
+  /** 该 app 的 package.json 中声明的版本（semver range，如 "^3.23.6"） */
+  declaredRange: string;
+}
+/** DB 行 + 实时聚合数据（列表页主结构） */
+interface ThirdPartyDependencyRow {
+  id: string;
+  /** npm 包名 */
+  name: string;
+  /** 展示名（默认取 name） */
+  displayName: string;
+  /** 依赖用途说明 */
+  description: string | null;
+  /** 官网 / 仓库地址 */
+  homepage: string | null;
+  /** npm 包页面地址 */
+  npmUrl: string;
+  category: DependencyCategory;
+  isWatched: boolean;
+  priority: DependencyPriority;
+  /** 项目中实际使用的版本信息（聚合 monorepo，来自 package.json，不缓存） */
+  usages: DependencyUsage[];
+  /** 当前使用版本（取 usages 中第一个 semver clean 值，便于表格直接展示） */
+  currentVersion: string | null;
+  /** 缓存的 npm registry latest 版本 */
+  latestVersion: string | null;
+  /** 最新版本的更新日志（GitHub Releases，markdown 原文） */
+  latestChangelog: string | null;
+  /** 最后同步时间（ISO） */
+  lastSyncAt: string | null;
+  /** 版本状态（由 currentVersion / latestVersion 比较得出） */
+  versionStatus: VersionStatus;
+  notes: string | null;
+  sortOrder: number;
+  updatedAt: string;
+}
+/** 编辑表单 payload */
+interface UpdateDependencyInput {
+  displayName?: string;
+  description?: string | null;
+  homepage?: string | null;
+  category?: DependencyCategory;
+  isWatched?: boolean;
+  priority?: DependencyPriority;
+  notes?: string | null;
+  sortOrder?: number;
+}
+/** 单个包同步结果 */
+interface SyncDependencyResult {
+  name: string;
+  success: boolean;
+  latestVersion?: string;
+  homepage?: string | null;
+  changelog?: string | null;
+  error?: string;
+}
+/**
+ * 预设关注列表（首次启动 seed 用）。
+ * 只放核心关注包；其余 monorepo 依赖在 list 时动态归入「全部依赖」分组。
+ * homepage 取官网或 GitHub 仓库，npmUrl 由 name 推导（不存表）。
+ */
+interface DependencySeed {
+  name: string;
+  displayName: string;
+  description: string;
+  homepage: string;
+  category: DependencyCategory;
+  priority: DependencyPriority;
+}
+declare const DEFAULT_WATCHED_DEPENDENCIES: DependencySeed[];
+//#endregion
+//#region src/contract/infrastructure/ip-location.d.ts
+declare function resolveIpLocation(ip: string | null | undefined): Promise<string>;
+/**
+ * 从 Request 中提取客户端真实 IP
+ * 优先级：X-Forwarded-For > X-Real-IP > CF-Connecting-IP
+ */
+declare function getClientIp(request: Request): string | null;
+//#endregion
+//#region src/contract/infrastructure/ua-parser.d.ts
+/**
+ * User-Agent 解析工具（轻量无依赖实现）
+ * 从 UA 字符串提取浏览器、操作系统、设备类型
+ */
+interface ParsedUA {
+  /** 浏览器名称 + 主版本号，如 "Chrome 120"、"Edge 119" */
+  browser: string;
+  /** 操作系统 + 主版本号，如 "Windows 10/11"、"macOS 14"、"iOS 17" */
+  os: string;
+  /** 设备类型：桌面 / iPhone / iPad / Android 手机 / Android 平板 */
+  device: string;
+}
+declare function parseUserAgent(ua: string | null | undefined): ParsedUA;
+/**
+ * 将 ParsedUA 拼接为可读字符串，如 "Chrome 120 / Windows 10/11 / 桌面"
+ */
+declare function formatParsedUA(parsed: ParsedUA): string;
+//#endregion
+//#region src/contract/interfaces/module.d.ts
+interface EntityDef {
+  type: string;
+  table: string;
+  searchFields: string[];
+  displayFields: string[];
+}
+interface AICommandContext {
+  entityType: string;
+  entityIds: string[];
+  userInput?: string;
+  module: AllBlueModule;
+}
+interface AICommandResult {
+  content: string;
+  actions?: {
+    type: string;
+    payload: unknown;
+  }[];
+}
+type AICommandHandler = (ctx: AICommandContext) => Promise<AICommandResult>;
+interface AICommandDef {
+  id: string;
+  label: string;
+  icon: string;
+  entityTypes: string[];
+  handler: AICommandHandler;
+}
+type ReferenceDisplayFn = (type: string, data: Record<string, unknown>) => {
+  title: string;
+  status?: string;
+  priority?: string;
+  url?: string;
+};
+interface AllBlueModule {
+  id: string;
+  name: string;
+  icon: string;
+  workspaceRoute: string;
+  entities: EntityDef[];
+  aiCommands: AICommandDef[];
+  referenceDisplay: ReferenceDisplayFn;
+}
+//#endregion
+//#region src/contract/interfaces/references.d.ts
+interface RefDisplay {
+  title: string;
+  status?: string;
+  priority?: string;
+  url?: string;
+}
+interface Reference {
+  id: string;
+  sourceModule: string;
+  sourceEntityId: string;
+  targetModule: string;
+  targetEntityId: string;
+}
+interface ResolvedRef extends Reference {
+  display: RefDisplay;
+}
+interface SearchResult {
+  id: string;
+  module: string;
+  type: string;
+  title: string;
+  status?: string;
+  url?: string;
+}
+//#endregion
+//#region src/contract/interfaces/ai.d.ts
+interface CLIAgentInfo {
+  id: string;
+  name: string;
+  binary: string;
+  version: string;
+  available: boolean;
+}
+interface AiAdapter {
+  detect(): Promise<CLIAgentInfo[]>;
+  execute(commandId: string, ctx: {
+    entityType: string;
+    entityIds: string[];
+    userInput?: string;
+  }): Promise<{
+    content: string;
+  }>;
+  stream(commandId: string, ctx: {
+    entityType: string;
+    entityIds: string[];
+    userInput?: string;
+  }): AsyncGenerator<string>;
+  getActiveAgent(): string;
+  switchAgent(agentId: string): void;
+}
+//#endregion
+//#region src/contract/interfaces/transport.d.ts
+interface EntityUpdateEvent {
+  type: string;
+  id: string;
+  fields: Record<string, unknown>;
+}
+interface RealtimeTransport {
+  subscribe(entityIds: string[], onUpdate: (event: EntityUpdateEvent) => void): () => void;
+}
+//#endregion
+//#region src/contract/interfaces/avatar.d.ts
+type AvatarPart = "face" | "eyes" | "eyebrows" | "mouth" | "nose" | "glasses" | "hair" | "accessories" | "details" | "beard";
+type AvatarConfig = Record<AvatarPart, number>;
+type ShapeType = "circle" | "rounded" | "square";
+//#endregion
+//#region src/contract/modules/billing/feature-registry.d.ts
+interface FeatureMeta {
+  /** oss = 开源免费；paid = 付费；enterprise = 企业版专属 */
+  tier: 'oss' | 'paid' | 'enterprise';
+  /** 该功能依赖的 proModule 服务名；null = 开源代码自带（仅权益门控） */
+  module: 'billing' | 'hostedAi' | 'sso' | 'audit' | 'permissions' | 'license' | 'versionHistory' | 'automation' | 'templates' | 'analytics' | 'globalSearch' | 'compliance' | null;
+}
+declare const FeatureRegistry: {
+  readonly byokAi: {
+    readonly tier: 'oss';
+    readonly module: null;
+  };
+  readonly hostedAi: {
+    readonly tier: 'paid';
+    readonly module: 'hostedAi';
+  };
+  readonly multiProvider: {
+    readonly tier: 'paid';
+    readonly module: null;
+  };
+  readonly largePageSize: {
+    readonly tier: 'paid';
+    readonly module: null;
+  };
+  readonly versionHistory: {
+    readonly tier: 'paid';
+    readonly module: 'versionHistory';
+  };
+  readonly automation: {
+    readonly tier: 'paid';
+    readonly module: 'automation';
+  };
+  readonly templates: {
+    readonly tier: 'paid';
+    readonly module: 'templates';
+  };
+  readonly globalSearch: {
+    readonly tier: 'paid';
+    readonly module: 'globalSearch';
+  };
+  readonly analytics: {
+    readonly tier: 'enterprise';
+    readonly module: 'analytics';
+  };
+  readonly sso: {
+    readonly tier: 'enterprise';
+    readonly module: 'sso';
+  };
+  readonly audit: {
+    readonly tier: 'enterprise';
+    readonly module: 'audit';
+  };
+  readonly advancedPermissions: {
+    readonly tier: 'enterprise';
+    readonly module: 'permissions';
+  };
+  readonly compliance: {
+    readonly tier: 'enterprise';
+    readonly module: 'compliance';
+  };
+  readonly customAgents: {
+    readonly tier: 'paid';
+    readonly module: null;
+  };
+};
+type FeatureKey = keyof typeof FeatureRegistry;
+declare const FEATURE_KEYS: FeatureKey[];
+/** OSS 部署（billing 模块缺失）的基础白名单——唯一允许「无订阅即放行」的集合 */
+declare const OSS_BASE_FEATURES: readonly FeatureKey[];
+declare function isOssFeature(key: FeatureKey): boolean;
+//#endregion
+//#region ../../../../../node_modules/zod/v3/helpers/typeAliases.d.cts
+type Primitive = string | number | symbol | bigint | boolean | null | undefined;
+//#endregion
+//#region ../../../../../node_modules/zod/v3/helpers/util.d.cts
+declare namespace util {
+  type AssertEqual<T, U> = (<V>() => V extends T ? 1 : 2) extends (<V>() => V extends U ? 1 : 2) ? true : false;
+  export type isAny<T> = 0 extends 1 & T ? true : false;
+  export const assertEqual: <A, B>(_: AssertEqual<A, B>) => void;
+  export function assertIs<T>(_arg: T): void;
+  export function assertNever(_x: never): never;
+  export type Omit<T, K extends keyof T> = Pick<T, Exclude<keyof T, K>>;
+  export type OmitKeys<T, K extends string> = Pick<T, Exclude<keyof T, K>>;
+  export type MakePartial<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+  export type Exactly<T, X> = T & Record<Exclude<keyof X, keyof T>, never>;
+  export type InexactPartial<T> = { [k in keyof T]?: T[k] | undefined; };
+  export const arrayToEnum: <T extends string, U extends [T, ...T[]]>(items: U) => { [k in U[number]]: k; };
+  export const getValidEnumValues: (obj: any) => any[];
+  export const objectValues: (obj: any) => any[];
+  export const objectKeys: ObjectConstructor["keys"];
+  export const find: <T>(arr: T[], checker: (arg: T) => any) => T | undefined;
+  export type identity<T> = objectUtil.identity<T>;
+  export type flatten<T> = objectUtil.flatten<T>;
+  export type noUndefined<T> = T extends undefined ? never : T;
+  export const isInteger: NumberConstructor["isInteger"];
+  export function joinValues<T extends any[]>(array: T, separator?: string): string;
+  export const jsonStringifyReplacer: (_: string, value: any) => any;
+  export {};
+}
+declare namespace objectUtil {
+  export type MergeShapes<U, V> = keyof U & keyof V extends never ? U & V : { [k in Exclude<keyof U, keyof V>]: U[k]; } & V;
+  type optionalKeys<T extends object> = { [k in keyof T]: undefined extends T[k] ? k : never; }[keyof T];
+  type requiredKeys<T extends object> = { [k in keyof T]: undefined extends T[k] ? never : k; }[keyof T];
+  export type addQuestionMarks<T extends object, _O = any> = { [K in requiredKeys<T>]: T[K]; } & { [K in optionalKeys<T>]?: T[K]; } & { [k in keyof T]?: unknown; };
+  export type identity<T> = T;
+  export type flatten<T> = identity<{ [k in keyof T]: T[k]; }>;
+  export type noNeverKeys<T> = { [k in keyof T]: [T[k]] extends [never] ? never : k; }[keyof T];
+  export type noNever<T> = identity<{ [k in noNeverKeys<T>]: k extends keyof T ? T[k] : never; }>;
+  export const mergeShapes: <U, T>(first: U, second: T) => T & U;
+  export type extendShape<A extends object, B extends object> = keyof A & keyof B extends never ? A & B : { [K in keyof A as K extends keyof B ? never : K]: A[K]; } & { [K in keyof B]: B[K]; };
+  export {};
+}
+declare const ZodParsedType: {
+  string: "string";
+  nan: "nan";
+  number: "number";
+  integer: "integer";
+  float: "float";
+  boolean: "boolean";
+  date: "date";
+  bigint: "bigint";
+  symbol: "symbol";
+  function: "function";
+  undefined: "undefined";
+  null: "null";
+  array: "array";
+  object: "object";
+  unknown: "unknown";
+  promise: "promise";
+  void: "void";
+  never: "never";
+  map: "map";
+  set: "set";
+};
+type ZodParsedType = keyof typeof ZodParsedType;
+//#endregion
+//#region ../../../../../node_modules/zod/v3/ZodError.d.cts
+type allKeys<T> = T extends any ? keyof T : never;
+type typeToFlattenedError<T, U = string> = {
+  formErrors: U[];
+  fieldErrors: { [P in allKeys<T>]?: U[]; };
+};
+declare const ZodIssueCode: {
+  invalid_type: "invalid_type";
+  invalid_literal: "invalid_literal";
+  custom: "custom";
+  invalid_union: "invalid_union";
+  invalid_union_discriminator: "invalid_union_discriminator";
+  invalid_enum_value: "invalid_enum_value";
+  unrecognized_keys: "unrecognized_keys";
+  invalid_arguments: "invalid_arguments";
+  invalid_return_type: "invalid_return_type";
+  invalid_date: "invalid_date";
+  invalid_string: "invalid_string";
+  too_small: "too_small";
+  too_big: "too_big";
+  invalid_intersection_types: "invalid_intersection_types";
+  not_multiple_of: "not_multiple_of";
+  not_finite: "not_finite";
+};
+type ZodIssueCode = keyof typeof ZodIssueCode;
+type ZodIssueBase = {
+  path: (string | number)[];
+  message?: string | undefined;
+};
+interface ZodInvalidTypeIssue extends ZodIssueBase {
+  code: typeof ZodIssueCode.invalid_type;
+  expected: ZodParsedType;
+  received: ZodParsedType;
+}
+interface ZodInvalidLiteralIssue extends ZodIssueBase {
+  code: typeof ZodIssueCode.invalid_literal;
+  expected: unknown;
+  received: unknown;
+}
+interface ZodUnrecognizedKeysIssue extends ZodIssueBase {
+  code: typeof ZodIssueCode.unrecognized_keys;
+  keys: string[];
+}
+interface ZodInvalidUnionIssue extends ZodIssueBase {
+  code: typeof ZodIssueCode.invalid_union;
+  unionErrors: ZodError[];
+}
+interface ZodInvalidUnionDiscriminatorIssue extends ZodIssueBase {
+  code: typeof ZodIssueCode.invalid_union_discriminator;
+  options: Primitive[];
+}
+interface ZodInvalidEnumValueIssue extends ZodIssueBase {
+  received: string | number;
+  code: typeof ZodIssueCode.invalid_enum_value;
+  options: (string | number)[];
+}
+interface ZodInvalidArgumentsIssue extends ZodIssueBase {
+  code: typeof ZodIssueCode.invalid_arguments;
+  argumentsError: ZodError;
+}
+interface ZodInvalidReturnTypeIssue extends ZodIssueBase {
+  code: typeof ZodIssueCode.invalid_return_type;
+  returnTypeError: ZodError;
+}
+interface ZodInvalidDateIssue extends ZodIssueBase {
+  code: typeof ZodIssueCode.invalid_date;
+}
+type StringValidation = "email" | "url" | "emoji" | "uuid" | "nanoid" | "regex" | "cuid" | "cuid2" | "ulid" | "datetime" | "date" | "time" | "duration" | "ip" | "cidr" | "base64" | "jwt" | "base64url" | {
+  includes: string;
+  position?: number | undefined;
+} | {
+  startsWith: string;
+} | {
+  endsWith: string;
+};
+interface ZodInvalidStringIssue extends ZodIssueBase {
+  code: typeof ZodIssueCode.invalid_string;
+  validation: StringValidation;
+}
+interface ZodTooSmallIssue extends ZodIssueBase {
+  code: typeof ZodIssueCode.too_small;
+  minimum: number | bigint;
+  inclusive: boolean;
+  exact?: boolean;
+  type: "array" | "string" | "number" | "set" | "date" | "bigint";
+}
+interface ZodTooBigIssue extends ZodIssueBase {
+  code: typeof ZodIssueCode.too_big;
+  maximum: number | bigint;
+  inclusive: boolean;
+  exact?: boolean;
+  type: "array" | "string" | "number" | "set" | "date" | "bigint";
+}
+interface ZodInvalidIntersectionTypesIssue extends ZodIssueBase {
+  code: typeof ZodIssueCode.invalid_intersection_types;
+}
+interface ZodNotMultipleOfIssue extends ZodIssueBase {
+  code: typeof ZodIssueCode.not_multiple_of;
+  multipleOf: number | bigint;
+}
+interface ZodNotFiniteIssue extends ZodIssueBase {
+  code: typeof ZodIssueCode.not_finite;
+}
+interface ZodCustomIssue extends ZodIssueBase {
+  code: typeof ZodIssueCode.custom;
+  params?: {
+    [k: string]: any;
+  };
+}
+type ZodIssueOptionalMessage = ZodInvalidTypeIssue | ZodInvalidLiteralIssue | ZodUnrecognizedKeysIssue | ZodInvalidUnionIssue | ZodInvalidUnionDiscriminatorIssue | ZodInvalidEnumValueIssue | ZodInvalidArgumentsIssue | ZodInvalidReturnTypeIssue | ZodInvalidDateIssue | ZodInvalidStringIssue | ZodTooSmallIssue | ZodTooBigIssue | ZodInvalidIntersectionTypesIssue | ZodNotMultipleOfIssue | ZodNotFiniteIssue | ZodCustomIssue;
+type ZodIssue = ZodIssueOptionalMessage & {
+  fatal?: boolean | undefined;
+  message: string;
+};
+type recursiveZodFormattedError<T> = T extends [any, ...any[]] ? { [K in keyof T]?: ZodFormattedError<T[K]>; } : T extends any[] ? {
+  [k: number]: ZodFormattedError<T[number]>;
+} : T extends object ? { [K in keyof T]?: ZodFormattedError<T[K]>; } : unknown;
+type ZodFormattedError<T, U = string> = {
+  _errors: U[];
+} & recursiveZodFormattedError<NonNullable<T>>;
+declare class ZodError<T = any> extends Error {
+  issues: ZodIssue[];
+  get errors(): ZodIssue[];
+  constructor(issues: ZodIssue[]);
+  format(): ZodFormattedError<T>;
+  format<U>(mapper: (issue: ZodIssue) => U): ZodFormattedError<T, U>;
+  static create: (issues: ZodIssue[]) => ZodError<any>;
+  static assert(value: unknown): asserts value is ZodError;
+  toString(): string;
+  get message(): string;
+  get isEmpty(): boolean;
+  addIssue: (sub: ZodIssue) => void;
+  addIssues: (subs?: ZodIssue[]) => void;
+  flatten(): typeToFlattenedError<T>;
+  flatten<U>(mapper?: (issue: ZodIssue) => U): typeToFlattenedError<T, U>;
+  get formErrors(): typeToFlattenedError<T, string>;
+}
+type stripPath<T extends object> = T extends any ? util.OmitKeys<T, "path"> : never;
+type IssueData = stripPath<ZodIssueOptionalMessage> & {
+  path?: (string | number)[];
+  fatal?: boolean | undefined;
+};
+type ErrorMapCtx = {
+  defaultError: string;
+  data: any;
+};
+type ZodErrorMap = (issue: ZodIssueOptionalMessage, _ctx: ErrorMapCtx) => {
+  message: string;
+};
+//#endregion
+//#region ../../../../../node_modules/zod/v3/helpers/parseUtil.d.cts
+type ParseParams = {
+  path: (string | number)[];
+  errorMap: ZodErrorMap;
+  async: boolean;
+};
+type ParsePathComponent = string | number;
+type ParsePath = ParsePathComponent[];
+interface ParseContext {
+  readonly common: {
+    readonly issues: ZodIssue[];
+    readonly contextualErrorMap?: ZodErrorMap | undefined;
+    readonly async: boolean;
+  };
+  readonly path: ParsePath;
+  readonly schemaErrorMap?: ZodErrorMap | undefined;
+  readonly parent: ParseContext | null;
+  readonly data: any;
+  readonly parsedType: ZodParsedType;
+}
+type ParseInput = {
+  data: any;
+  path: (string | number)[];
+  parent: ParseContext;
+};
+declare class ParseStatus {
+  value: "aborted" | "dirty" | "valid";
+  dirty(): void;
+  abort(): void;
+  static mergeArray(status: ParseStatus, results: SyncParseReturnType<any>[]): SyncParseReturnType;
+  static mergeObjectAsync(status: ParseStatus, pairs: {
+    key: ParseReturnType<any>;
+    value: ParseReturnType<any>;
+  }[]): Promise<SyncParseReturnType<any>>;
+  static mergeObjectSync(status: ParseStatus, pairs: {
+    key: SyncParseReturnType<any>;
+    value: SyncParseReturnType<any>;
+    alwaysSet?: boolean;
+  }[]): SyncParseReturnType;
+}
+type INVALID = {
+  status: "aborted";
+};
+declare const INVALID: INVALID;
+type DIRTY<T> = {
+  status: "dirty";
+  value: T;
+};
+declare const DIRTY: <T>(value: T) => DIRTY<T>;
+type OK<T> = {
+  status: "valid";
+  value: T;
+};
+declare const OK: <T>(value: T) => OK<T>;
+type SyncParseReturnType<T = any> = OK<T> | DIRTY<T> | INVALID;
+type AsyncParseReturnType<T> = Promise<SyncParseReturnType<T>>;
+type ParseReturnType<T> = SyncParseReturnType<T> | AsyncParseReturnType<T>;
+//#endregion
+//#region ../../../../../node_modules/zod/v3/helpers/errorUtil.d.cts
+declare namespace errorUtil {
+  type ErrMessage = string | {
+    message?: string | undefined;
+  };
+  const errToObj: (message?: ErrMessage) => {
+    message?: string | undefined;
+  };
+  const toString: (message?: ErrMessage) => string | undefined;
+}
+//#endregion
+//#region ../../../../../node_modules/zod/v3/standard-schema.d.cts
+/**
+ * The Standard Schema interface.
+ */
+type StandardSchemaV1<Input = unknown, Output = Input> = {
+  /**
+   * The Standard Schema properties.
+   */
+  readonly "~standard": StandardSchemaV1.Props<Input, Output>;
+};
+declare namespace StandardSchemaV1 {
+  /**
+   * The Standard Schema properties interface.
+   */
+  export interface Props<Input = unknown, Output = Input> {
+    /**
+     * The version number of the standard.
+     */
+    readonly version: 1;
+    /**
+     * The vendor name of the schema library.
+     */
+    readonly vendor: string;
+    /**
+     * Validates unknown input values.
+     */
+    readonly validate: (value: unknown) => Result<Output> | Promise<Result<Output>>;
+    /**
+     * Inferred types associated with the schema.
+     */
+    readonly types?: Types<Input, Output> | undefined;
+  }
+  /**
+   * The result interface of the validate function.
+   */
+  export type Result<Output> = SuccessResult<Output> | FailureResult;
+  /**
+   * The result interface if validation succeeds.
+   */
+  export interface SuccessResult<Output> {
+    /**
+     * The typed output value.
+     */
+    readonly value: Output;
+    /**
+     * The non-existent issues.
+     */
+    readonly issues?: undefined;
+  }
+  /**
+   * The result interface if validation fails.
+   */
+  export interface FailureResult {
+    /**
+     * The issues of failed validation.
+     */
+    readonly issues: ReadonlyArray<Issue>;
+  }
+  /**
+   * The issue interface of the failure output.
+   */
+  export interface Issue {
+    /**
+     * The error message of the issue.
+     */
+    readonly message: string;
+    /**
+     * The path of the issue, if any.
+     */
+    readonly path?: ReadonlyArray<PropertyKey | PathSegment> | undefined;
+  }
+  /**
+   * The path segment interface of the issue.
+   */
+  export interface PathSegment {
+    /**
+     * The key representing a path segment.
+     */
+    readonly key: PropertyKey;
+  }
+  /**
+   * The Standard Schema types interface.
+   */
+  export interface Types<Input = unknown, Output = Input> {
+    /**
+     * The input type of the schema.
+     */
+    readonly input: Input;
+    /**
+     * The output type of the schema.
+     */
+    readonly output: Output;
+  }
+  /**
+   * Infers the input type of a Standard Schema.
+   */
+  export type InferInput<Schema extends StandardSchemaV1> = NonNullable<Schema["~standard"]["types"]>["input"];
+  /**
+   * Infers the output type of a Standard Schema.
+   */
+  export type InferOutput<Schema extends StandardSchemaV1> = NonNullable<Schema["~standard"]["types"]>["output"];
+  export {};
+}
+//#endregion
+//#region ../../../../../node_modules/zod/v3/types.d.cts
+interface RefinementCtx {
+  addIssue: (arg: IssueData) => void;
+  path: (string | number)[];
+}
+type ZodTypeAny = ZodType<any, any, any>;
+type TypeOf<T extends ZodType<any, any, any>> = T["_output"];
+type input<T extends ZodType<any, any, any>> = T["_input"];
+type output<T extends ZodType<any, any, any>> = T["_output"];
+type CustomErrorParams = Partial<util.Omit<ZodCustomIssue, "code">>;
+interface ZodTypeDef {
+  errorMap?: ZodErrorMap | undefined;
+  description?: string | undefined;
+}
+type RawCreateParams = {
+  errorMap?: ZodErrorMap | undefined;
+  invalid_type_error?: string | undefined;
+  required_error?: string | undefined;
+  message?: string | undefined;
+  description?: string | undefined;
+} | undefined;
+type SafeParseSuccess<Output> = {
+  success: true;
+  data: Output;
+  error?: never;
+};
+type SafeParseError<Input> = {
+  success: false;
+  error: ZodError<Input>;
+  data?: never;
+};
+type SafeParseReturnType<Input, Output> = SafeParseSuccess<Output> | SafeParseError<Input>;
+declare abstract class ZodType<Output = any, Def extends ZodTypeDef = ZodTypeDef, Input = Output> {
+  readonly _type: Output;
+  readonly _output: Output;
+  readonly _input: Input;
+  readonly _def: Def;
+  get description(): string | undefined;
+  "~standard": StandardSchemaV1.Props<Input, Output>;
+  abstract _parse(input: ParseInput): ParseReturnType<Output>;
+  _getType(input: ParseInput): string;
+  _getOrReturnCtx(input: ParseInput, ctx?: ParseContext | undefined): ParseContext;
+  _processInputParams(input: ParseInput): {
+    status: ParseStatus;
+    ctx: ParseContext;
+  };
+  _parseSync(input: ParseInput): SyncParseReturnType<Output>;
+  _parseAsync(input: ParseInput): AsyncParseReturnType<Output>;
+  parse(data: unknown, params?: util.InexactPartial<ParseParams>): Output;
+  safeParse(data: unknown, params?: util.InexactPartial<ParseParams>): SafeParseReturnType<Input, Output>;
+  "~validate"(data: unknown): StandardSchemaV1.Result<Output> | Promise<StandardSchemaV1.Result<Output>>;
+  parseAsync(data: unknown, params?: util.InexactPartial<ParseParams>): Promise<Output>;
+  safeParseAsync(data: unknown, params?: util.InexactPartial<ParseParams>): Promise<SafeParseReturnType<Input, Output>>;
+  /** Alias of safeParseAsync */
+  spa: (data: unknown, params?: util.InexactPartial<ParseParams>) => Promise<SafeParseReturnType<Input, Output>>;
+  refine<RefinedOutput extends Output>(check: (arg: Output) => arg is RefinedOutput, message?: string | CustomErrorParams | ((arg: Output) => CustomErrorParams)): ZodEffects<this, RefinedOutput, Input>;
+  refine(check: (arg: Output) => unknown | Promise<unknown>, message?: string | CustomErrorParams | ((arg: Output) => CustomErrorParams)): ZodEffects<this, Output, Input>;
+  refinement<RefinedOutput extends Output>(check: (arg: Output) => arg is RefinedOutput, refinementData: IssueData | ((arg: Output, ctx: RefinementCtx) => IssueData)): ZodEffects<this, RefinedOutput, Input>;
+  refinement(check: (arg: Output) => boolean, refinementData: IssueData | ((arg: Output, ctx: RefinementCtx) => IssueData)): ZodEffects<this, Output, Input>;
+  _refinement(refinement: RefinementEffect<Output>["refinement"]): ZodEffects<this, Output, Input>;
+  superRefine<RefinedOutput extends Output>(refinement: (arg: Output, ctx: RefinementCtx) => arg is RefinedOutput): ZodEffects<this, RefinedOutput, Input>;
+  superRefine(refinement: (arg: Output, ctx: RefinementCtx) => void): ZodEffects<this, Output, Input>;
+  superRefine(refinement: (arg: Output, ctx: RefinementCtx) => Promise<void>): ZodEffects<this, Output, Input>;
+  constructor(def: Def);
+  optional(): ZodOptional<this>;
+  nullable(): ZodNullable<this>;
+  nullish(): ZodOptional<ZodNullable<this>>;
+  array(): ZodArray<this>;
+  promise(): ZodPromise<this>;
+  or<T extends ZodTypeAny>(option: T): ZodUnion<[this, T]>;
+  and<T extends ZodTypeAny>(incoming: T): ZodIntersection<this, T>;
+  transform<NewOut>(transform: (arg: Output, ctx: RefinementCtx) => NewOut | Promise<NewOut>): ZodEffects<this, NewOut>;
+  default(def: util.noUndefined<Input>): ZodDefault<this>;
+  default(def: () => util.noUndefined<Input>): ZodDefault<this>;
+  brand<B extends string | number | symbol>(brand?: B): ZodBranded<this, B>;
+  catch(def: Output): ZodCatch<this>;
+  catch(def: (ctx: {
+    error: ZodError;
+    input: Input;
+  }) => Output): ZodCatch<this>;
+  describe(description: string): this;
+  pipe<T extends ZodTypeAny>(target: T): ZodPipeline<this, T>;
+  readonly(): ZodReadonly<this>;
+  isOptional(): boolean;
+  isNullable(): boolean;
+}
+type IpVersion = "v4" | "v6";
+type ZodStringCheck = {
+  kind: "min";
+  value: number;
+  message?: string | undefined;
+} | {
+  kind: "max";
+  value: number;
+  message?: string | undefined;
+} | {
+  kind: "length";
+  value: number;
+  message?: string | undefined;
+} | {
+  kind: "email";
+  message?: string | undefined;
+} | {
+  kind: "url";
+  message?: string | undefined;
+} | {
+  kind: "emoji";
+  message?: string | undefined;
+} | {
+  kind: "uuid";
+  message?: string | undefined;
+} | {
+  kind: "nanoid";
+  message?: string | undefined;
+} | {
+  kind: "cuid";
+  message?: string | undefined;
+} | {
+  kind: "includes";
+  value: string;
+  position?: number | undefined;
+  message?: string | undefined;
+} | {
+  kind: "cuid2";
+  message?: string | undefined;
+} | {
+  kind: "ulid";
+  message?: string | undefined;
+} | {
+  kind: "startsWith";
+  value: string;
+  message?: string | undefined;
+} | {
+  kind: "endsWith";
+  value: string;
+  message?: string | undefined;
+} | {
+  kind: "regex";
+  regex: RegExp;
+  message?: string | undefined;
+} | {
+  kind: "trim";
+  message?: string | undefined;
+} | {
+  kind: "toLowerCase";
+  message?: string | undefined;
+} | {
+  kind: "toUpperCase";
+  message?: string | undefined;
+} | {
+  kind: "jwt";
+  alg?: string;
+  message?: string | undefined;
+} | {
+  kind: "datetime";
+  offset: boolean;
+  local: boolean;
+  precision: number | null;
+  message?: string | undefined;
+} | {
+  kind: "date";
+  message?: string | undefined;
+} | {
+  kind: "time";
+  precision: number | null;
+  message?: string | undefined;
+} | {
+  kind: "duration";
+  message?: string | undefined;
+} | {
+  kind: "ip";
+  version?: IpVersion | undefined;
+  message?: string | undefined;
+} | {
+  kind: "cidr";
+  version?: IpVersion | undefined;
+  message?: string | undefined;
+} | {
+  kind: "base64";
+  message?: string | undefined;
+} | {
+  kind: "base64url";
+  message?: string | undefined;
+};
+interface ZodStringDef extends ZodTypeDef {
+  checks: ZodStringCheck[];
+  typeName: ZodFirstPartyTypeKind.ZodString;
+  coerce: boolean;
+}
+declare class ZodString extends ZodType<string, ZodStringDef, string> {
+  _parse(input: ParseInput): ParseReturnType<string>;
+  protected _regex(regex: RegExp, validation: StringValidation, message?: errorUtil.ErrMessage): ZodEffects<this, string, string>;
+  _addCheck(check: ZodStringCheck): ZodString;
+  email(message?: errorUtil.ErrMessage): ZodString;
+  url(message?: errorUtil.ErrMessage): ZodString;
+  emoji(message?: errorUtil.ErrMessage): ZodString;
+  uuid(message?: errorUtil.ErrMessage): ZodString;
+  nanoid(message?: errorUtil.ErrMessage): ZodString;
+  cuid(message?: errorUtil.ErrMessage): ZodString;
+  cuid2(message?: errorUtil.ErrMessage): ZodString;
+  ulid(message?: errorUtil.ErrMessage): ZodString;
+  base64(message?: errorUtil.ErrMessage): ZodString;
+  base64url(message?: errorUtil.ErrMessage): ZodString;
+  jwt(options?: {
+    alg?: string;
+    message?: string | undefined;
+  }): ZodString;
+  ip(options?: string | {
+    version?: IpVersion;
+    message?: string | undefined;
+  }): ZodString;
+  cidr(options?: string | {
+    version?: IpVersion;
+    message?: string | undefined;
+  }): ZodString;
+  datetime(options?: string | {
+    message?: string | undefined;
+    precision?: number | null;
+    offset?: boolean;
+    local?: boolean;
+  }): ZodString;
+  date(message?: string): ZodString;
+  time(options?: string | {
+    message?: string | undefined;
+    precision?: number | null;
+  }): ZodString;
+  duration(message?: errorUtil.ErrMessage): ZodString;
+  regex(regex: RegExp, message?: errorUtil.ErrMessage): ZodString;
+  includes(value: string, options?: {
+    message?: string;
+    position?: number;
+  }): ZodString;
+  startsWith(value: string, message?: errorUtil.ErrMessage): ZodString;
+  endsWith(value: string, message?: errorUtil.ErrMessage): ZodString;
+  min(minLength: number, message?: errorUtil.ErrMessage): ZodString;
+  max(maxLength: number, message?: errorUtil.ErrMessage): ZodString;
+  length(len: number, message?: errorUtil.ErrMessage): ZodString;
+  /**
+   * Equivalent to `.min(1)`
+   */
+  nonempty(message?: errorUtil.ErrMessage): ZodString;
+  trim(): ZodString;
+  toLowerCase(): ZodString;
+  toUpperCase(): ZodString;
+  get isDatetime(): boolean;
+  get isDate(): boolean;
+  get isTime(): boolean;
+  get isDuration(): boolean;
+  get isEmail(): boolean;
+  get isURL(): boolean;
+  get isEmoji(): boolean;
+  get isUUID(): boolean;
+  get isNANOID(): boolean;
+  get isCUID(): boolean;
+  get isCUID2(): boolean;
+  get isULID(): boolean;
+  get isIP(): boolean;
+  get isCIDR(): boolean;
+  get isBase64(): boolean;
+  get isBase64url(): boolean;
+  get minLength(): number | null;
+  get maxLength(): number | null;
+  static create: (params?: RawCreateParams & {
+    coerce?: true;
+  }) => ZodString;
+}
+interface ZodBooleanDef extends ZodTypeDef {
+  typeName: ZodFirstPartyTypeKind.ZodBoolean;
+  coerce: boolean;
+}
+declare class ZodBoolean extends ZodType<boolean, ZodBooleanDef, boolean> {
+  _parse(input: ParseInput): ParseReturnType<boolean>;
+  static create: (params?: RawCreateParams & {
+    coerce?: boolean;
+  }) => ZodBoolean;
+}
+interface ZodArrayDef<T extends ZodTypeAny = ZodTypeAny> extends ZodTypeDef {
+  type: T;
+  typeName: ZodFirstPartyTypeKind.ZodArray;
+  exactLength: {
+    value: number;
+    message?: string | undefined;
+  } | null;
+  minLength: {
+    value: number;
+    message?: string | undefined;
+  } | null;
+  maxLength: {
+    value: number;
+    message?: string | undefined;
+  } | null;
+}
+type ArrayCardinality = "many" | "atleastone";
+type arrayOutputType<T extends ZodTypeAny, Cardinality extends ArrayCardinality = "many"> = Cardinality extends "atleastone" ? [T["_output"], ...T["_output"][]] : T["_output"][];
+declare class ZodArray<T extends ZodTypeAny, Cardinality extends ArrayCardinality = "many"> extends ZodType<arrayOutputType<T, Cardinality>, ZodArrayDef<T>, Cardinality extends "atleastone" ? [T["_input"], ...T["_input"][]] : T["_input"][]> {
+  _parse(input: ParseInput): ParseReturnType<this["_output"]>;
+  get element(): T;
+  min(minLength: number, message?: errorUtil.ErrMessage): this;
+  max(maxLength: number, message?: errorUtil.ErrMessage): this;
+  length(len: number, message?: errorUtil.ErrMessage): this;
+  nonempty(message?: errorUtil.ErrMessage): ZodArray<T, "atleastone">;
+  static create: <El extends ZodTypeAny>(schema: El, params?: RawCreateParams) => ZodArray<El>;
+}
+type ZodUnionOptions = Readonly<[ZodTypeAny, ...ZodTypeAny[]]>;
+interface ZodUnionDef<T extends ZodUnionOptions = Readonly<[ZodTypeAny, ZodTypeAny, ...ZodTypeAny[]]>> extends ZodTypeDef {
+  options: T;
+  typeName: ZodFirstPartyTypeKind.ZodUnion;
+}
+declare class ZodUnion<T extends ZodUnionOptions> extends ZodType<T[number]["_output"], ZodUnionDef<T>, T[number]["_input"]> {
+  _parse(input: ParseInput): ParseReturnType<this["_output"]>;
+  get options(): T;
+  static create: <Options extends Readonly<[ZodTypeAny, ZodTypeAny, ...ZodTypeAny[]]>>(types: Options, params?: RawCreateParams) => ZodUnion<Options>;
+}
+interface ZodIntersectionDef<T extends ZodTypeAny = ZodTypeAny, U extends ZodTypeAny = ZodTypeAny> extends ZodTypeDef {
+  left: T;
+  right: U;
+  typeName: ZodFirstPartyTypeKind.ZodIntersection;
+}
+declare class ZodIntersection<T extends ZodTypeAny, U extends ZodTypeAny> extends ZodType<T["_output"] & U["_output"], ZodIntersectionDef<T, U>, T["_input"] & U["_input"]> {
+  _parse(input: ParseInput): ParseReturnType<this["_output"]>;
+  static create: <TSchema extends ZodTypeAny, USchema extends ZodTypeAny>(left: TSchema, right: USchema, params?: RawCreateParams) => ZodIntersection<TSchema, USchema>;
+}
+interface ZodRecordDef<Key extends KeySchema = ZodString, Value extends ZodTypeAny = ZodTypeAny> extends ZodTypeDef {
+  valueType: Value;
+  keyType: Key;
+  typeName: ZodFirstPartyTypeKind.ZodRecord;
+}
+type KeySchema = ZodType<string | number | symbol, any, any>;
+type RecordType<K extends string | number | symbol, V> = [string] extends [K] ? Record<K, V> : [number] extends [K] ? Record<K, V> : [symbol] extends [K] ? Record<K, V> : [BRAND<string | number | symbol>] extends [K] ? Record<K, V> : Partial<Record<K, V>>;
+declare class ZodRecord<Key extends KeySchema = ZodString, Value extends ZodTypeAny = ZodTypeAny> extends ZodType<RecordType<Key["_output"], Value["_output"]>, ZodRecordDef<Key, Value>, RecordType<Key["_input"], Value["_input"]>> {
+  get keySchema(): Key;
+  get valueSchema(): Value;
+  _parse(input: ParseInput): ParseReturnType<this["_output"]>;
+  get element(): Value;
+  static create<Value extends ZodTypeAny>(valueType: Value, params?: RawCreateParams): ZodRecord<ZodString, Value>;
+  static create<Keys extends KeySchema, Value extends ZodTypeAny>(keySchema: Keys, valueType: Value, params?: RawCreateParams): ZodRecord<Keys, Value>;
+}
+type EnumValues<T extends string = string> = readonly [T, ...T[]];
+type Values<T extends EnumValues> = { [k in T[number]]: k; };
+interface ZodEnumDef<T extends EnumValues = EnumValues> extends ZodTypeDef {
+  values: T;
+  typeName: ZodFirstPartyTypeKind.ZodEnum;
+}
+type Writeable<T> = { -readonly [P in keyof T]: T[P]; };
+type FilterEnum<Values, ToExclude> = Values extends [] ? [] : Values extends [infer Head, ...infer Rest] ? Head extends ToExclude ? FilterEnum<Rest, ToExclude> : [Head, ...FilterEnum<Rest, ToExclude>] : never;
+type typecast<A, T> = A extends T ? A : never;
+declare function createZodEnum<U extends string, T extends Readonly<[U, ...U[]]>>(values: T, params?: RawCreateParams): ZodEnum<Writeable<T>>;
+declare function createZodEnum<U extends string, T extends [U, ...U[]]>(values: T, params?: RawCreateParams): ZodEnum<T>;
+declare class ZodEnum<T extends [string, ...string[]]> extends ZodType<T[number], ZodEnumDef<T>, T[number]> {
+  _cache: Set<T[number]> | undefined;
+  _parse(input: ParseInput): ParseReturnType<this["_output"]>;
+  get options(): T;
+  get enum(): Values<T>;
+  get Values(): Values<T>;
+  get Enum(): Values<T>;
+  extract<ToExtract extends readonly [T[number], ...T[number][]]>(values: ToExtract, newDef?: RawCreateParams): ZodEnum<Writeable<ToExtract>>;
+  exclude<ToExclude extends readonly [T[number], ...T[number][]]>(values: ToExclude, newDef?: RawCreateParams): ZodEnum<typecast<Writeable<FilterEnum<T, ToExclude[number]>>, [string, ...string[]]>>;
+  static create: typeof createZodEnum;
+}
+interface ZodPromiseDef<T extends ZodTypeAny = ZodTypeAny> extends ZodTypeDef {
+  type: T;
+  typeName: ZodFirstPartyTypeKind.ZodPromise;
+}
+declare class ZodPromise<T extends ZodTypeAny> extends ZodType<Promise<T["_output"]>, ZodPromiseDef<T>, Promise<T["_input"]>> {
+  unwrap(): T;
+  _parse(input: ParseInput): ParseReturnType<this["_output"]>;
+  static create: <Inner extends ZodTypeAny>(schema: Inner, params?: RawCreateParams) => ZodPromise<Inner>;
+}
+type RefinementEffect<T> = {
+  type: "refinement";
+  refinement: (arg: T, ctx: RefinementCtx) => any;
+};
+type TransformEffect<T> = {
+  type: "transform";
+  transform: (arg: T, ctx: RefinementCtx) => any;
+};
+type PreprocessEffect<T> = {
+  type: "preprocess";
+  transform: (arg: T, ctx: RefinementCtx) => any;
+};
+type Effect<T> = RefinementEffect<T> | TransformEffect<T> | PreprocessEffect<T>;
+interface ZodEffectsDef<T extends ZodTypeAny = ZodTypeAny> extends ZodTypeDef {
+  schema: T;
+  typeName: ZodFirstPartyTypeKind.ZodEffects;
+  effect: Effect<any>;
+}
+declare class ZodEffects<T extends ZodTypeAny, Output = output<T>, Input = input<T>> extends ZodType<Output, ZodEffectsDef<T>, Input> {
+  innerType(): T;
+  sourceType(): T;
+  _parse(input: ParseInput): ParseReturnType<this["_output"]>;
+  static create: <I extends ZodTypeAny>(schema: I, effect: Effect<I["_output"]>, params?: RawCreateParams) => ZodEffects<I, I["_output"]>;
+  static createWithPreprocess: <I extends ZodTypeAny>(preprocess: (arg: unknown, ctx: RefinementCtx) => unknown, schema: I, params?: RawCreateParams) => ZodEffects<I, I["_output"], unknown>;
+}
+interface ZodOptionalDef<T extends ZodTypeAny = ZodTypeAny> extends ZodTypeDef {
+  innerType: T;
+  typeName: ZodFirstPartyTypeKind.ZodOptional;
+}
+declare class ZodOptional<T extends ZodTypeAny> extends ZodType<T["_output"] | undefined, ZodOptionalDef<T>, T["_input"] | undefined> {
+  _parse(input: ParseInput): ParseReturnType<this["_output"]>;
+  unwrap(): T;
+  static create: <Inner extends ZodTypeAny>(type: Inner, params?: RawCreateParams) => ZodOptional<Inner>;
+}
+interface ZodNullableDef<T extends ZodTypeAny = ZodTypeAny> extends ZodTypeDef {
+  innerType: T;
+  typeName: ZodFirstPartyTypeKind.ZodNullable;
+}
+declare class ZodNullable<T extends ZodTypeAny> extends ZodType<T["_output"] | null, ZodNullableDef<T>, T["_input"] | null> {
+  _parse(input: ParseInput): ParseReturnType<this["_output"]>;
+  unwrap(): T;
+  static create: <Inner extends ZodTypeAny>(type: Inner, params?: RawCreateParams) => ZodNullable<Inner>;
+}
+interface ZodDefaultDef<T extends ZodTypeAny = ZodTypeAny> extends ZodTypeDef {
+  innerType: T;
+  defaultValue: () => util.noUndefined<T["_input"]>;
+  typeName: ZodFirstPartyTypeKind.ZodDefault;
+}
+declare class ZodDefault<T extends ZodTypeAny> extends ZodType<util.noUndefined<T["_output"]>, ZodDefaultDef<T>, T["_input"] | undefined> {
+  _parse(input: ParseInput): ParseReturnType<this["_output"]>;
+  removeDefault(): T;
+  static create: <Inner extends ZodTypeAny>(type: Inner, params: RawCreateParams & {
+    default: Inner["_input"] | (() => util.noUndefined<Inner["_input"]>);
+  }) => ZodDefault<Inner>;
+}
+interface ZodCatchDef<T extends ZodTypeAny = ZodTypeAny> extends ZodTypeDef {
+  innerType: T;
+  catchValue: (ctx: {
+    error: ZodError;
+    input: unknown;
+  }) => T["_input"];
+  typeName: ZodFirstPartyTypeKind.ZodCatch;
+}
+declare class ZodCatch<T extends ZodTypeAny> extends ZodType<T["_output"], ZodCatchDef<T>, unknown> {
+  _parse(input: ParseInput): ParseReturnType<this["_output"]>;
+  removeCatch(): T;
+  static create: <Inner extends ZodTypeAny>(type: Inner, params: RawCreateParams & {
+    catch: Inner["_output"] | (() => Inner["_output"]);
+  }) => ZodCatch<Inner>;
+}
+interface ZodBrandedDef<T extends ZodTypeAny> extends ZodTypeDef {
+  type: T;
+  typeName: ZodFirstPartyTypeKind.ZodBranded;
+}
+declare const BRAND: unique symbol;
+type BRAND<T extends string | number | symbol> = {
+  [BRAND]: { [k in T]: true; };
+};
+declare class ZodBranded<T extends ZodTypeAny, B extends string | number | symbol> extends ZodType<T["_output"] & BRAND<B>, ZodBrandedDef<T>, T["_input"]> {
+  _parse(input: ParseInput): ParseReturnType<any>;
+  unwrap(): T;
+}
+interface ZodPipelineDef<A extends ZodTypeAny, B extends ZodTypeAny> extends ZodTypeDef {
+  in: A;
+  out: B;
+  typeName: ZodFirstPartyTypeKind.ZodPipeline;
+}
+declare class ZodPipeline<A extends ZodTypeAny, B extends ZodTypeAny> extends ZodType<B["_output"], ZodPipelineDef<A, B>, A["_input"]> {
+  _parse(input: ParseInput): ParseReturnType<any>;
+  static create<ASchema extends ZodTypeAny, BSchema extends ZodTypeAny>(a: ASchema, b: BSchema): ZodPipeline<ASchema, BSchema>;
+}
+type BuiltIn = (((...args: any[]) => any) | (new (...args: any[]) => any)) | {
+  readonly [Symbol.toStringTag]: string;
+} | Date | Error | Generator | Promise<unknown> | RegExp;
+type MakeReadonly<T> = T extends Map<infer K, infer V> ? ReadonlyMap<K, V> : T extends Set<infer V> ? ReadonlySet<V> : T extends [infer Head, ...infer Tail] ? readonly [Head, ...Tail] : T extends Array<infer V> ? ReadonlyArray<V> : T extends BuiltIn ? T : Readonly<T>;
+interface ZodReadonlyDef<T extends ZodTypeAny = ZodTypeAny> extends ZodTypeDef {
+  innerType: T;
+  typeName: ZodFirstPartyTypeKind.ZodReadonly;
+}
+declare class ZodReadonly<T extends ZodTypeAny> extends ZodType<MakeReadonly<T["_output"]>, ZodReadonlyDef<T>, MakeReadonly<T["_input"]>> {
+  _parse(input: ParseInput): ParseReturnType<this["_output"]>;
+  static create: <Inner extends ZodTypeAny>(type: Inner, params?: RawCreateParams) => ZodReadonly<Inner>;
+  unwrap(): T;
+}
+declare enum ZodFirstPartyTypeKind {
+  ZodString = "ZodString",
+  ZodNumber = "ZodNumber",
+  ZodNaN = "ZodNaN",
+  ZodBigInt = "ZodBigInt",
+  ZodBoolean = "ZodBoolean",
+  ZodDate = "ZodDate",
+  ZodSymbol = "ZodSymbol",
+  ZodUndefined = "ZodUndefined",
+  ZodNull = "ZodNull",
+  ZodAny = "ZodAny",
+  ZodUnknown = "ZodUnknown",
+  ZodNever = "ZodNever",
+  ZodVoid = "ZodVoid",
+  ZodArray = "ZodArray",
+  ZodObject = "ZodObject",
+  ZodUnion = "ZodUnion",
+  ZodDiscriminatedUnion = "ZodDiscriminatedUnion",
+  ZodIntersection = "ZodIntersection",
+  ZodTuple = "ZodTuple",
+  ZodRecord = "ZodRecord",
+  ZodMap = "ZodMap",
+  ZodSet = "ZodSet",
+  ZodFunction = "ZodFunction",
+  ZodLazy = "ZodLazy",
+  ZodLiteral = "ZodLiteral",
+  ZodEnum = "ZodEnum",
+  ZodEffects = "ZodEffects",
+  ZodNativeEnum = "ZodNativeEnum",
+  ZodOptional = "ZodOptional",
+  ZodNullable = "ZodNullable",
+  ZodDefault = "ZodDefault",
+  ZodCatch = "ZodCatch",
+  ZodPromise = "ZodPromise",
+  ZodBranded = "ZodBranded",
+  ZodPipeline = "ZodPipeline",
+  ZodReadonly = "ZodReadonly"
+}
+//#endregion
+//#region src/contract/modules/billing/plan-features-schema.d.ts
+declare const PlanFeaturesSchema: ZodRecord<ZodEnum<["advancedPermissions" | "analytics" | "audit" | "automation" | "byokAi" | "compliance" | "customAgents" | "globalSearch" | "hostedAi" | "largePageSize" | "multiProvider" | "sso" | "templates" | "versionHistory", ...("advancedPermissions" | "analytics" | "audit" | "automation" | "byokAi" | "compliance" | "customAgents" | "globalSearch" | "hostedAi" | "largePageSize" | "multiProvider" | "sso" | "templates" | "versionHistory")[]]>, ZodBoolean>;
+type PlanFeatures = TypeOf<typeof PlanFeaturesSchema>;
+//#endregion
+//#region src/contract/modules/billing/resource-registry.d.ts
+interface ResourceMeta {
+  tier: 'paid' | 'enterprise';
+  unit: string;
+  purchasable: boolean | 'custom';
+  step: number;
+  /** 降购下限约束：seats 不允许降到当前活跃成员数以下 */
+  floor?: 'activeMembers';
+}
+declare const ResourceRegistry: {
+  readonly seats: {
+    /** 成员席位池（billing 加购语义不变）；访客池见 guestSeats */
+    readonly tier: 'paid';
+    readonly unit: 'per-seat';
+    readonly purchasable: true;
+    readonly step: 1;
+    readonly floor: 'activeMembers';
+  };
+  readonly guestSeats: {
+    readonly tier: 'paid';
+    readonly unit: 'guest-seats';
+    readonly purchasable: false;
+    readonly step: 1;
+  };
+  readonly aiQuotaMonthly: {
+    readonly tier: 'paid';
+    readonly unit: 'requests/month';
+    readonly purchasable: false;
+    readonly step: 1;
+  };
+  readonly agentQuota: {
+    readonly tier: 'paid';
+    readonly unit: 'agents';
+    readonly purchasable: false;
+    readonly step: 1;
+  };
+  readonly skillQuota: {
+    readonly tier: 'paid';
+    readonly unit: 'skills';
+    readonly purchasable: false;
+    readonly step: 1;
+  };
+  readonly workspaces: {
+    readonly tier: 'paid';
+    readonly unit: 'workspaces';
+    readonly purchasable: false;
+    readonly step: 1;
+  };
+};
+type ResourceKey = keyof typeof ResourceRegistry;
+declare const RESOURCE_KEYS: ResourceKey[];
+interface ResourceSnapshot {
+  limit: number | 'unlimited';
+  usage: number;
+}
+type ResourceSnapshots = Record<ResourceKey, ResourceSnapshot>;
+declare function isResourceDefined(key: string): key is ResourceKey;
+//#endregion
+//#region src/contract/modules/changelog/types.d.ts
+interface DeveloperLogEntry {
+  id: string;
+  date: string;
+  year: string;
+  title: string;
+  desc: string;
+  tags: string[];
+  commitSha?: string;
+  createdAt: string;
+  updatedAt: string;
+}
+//#endregion
+//#region src/contract/modules/notifications/types.d.ts
+declare const NOTIFICATION_CATEGORIES: readonly ['team', 'collaboration', 'system', 'billing', 'security'];
+type NotificationCategory = (typeof NOTIFICATION_CATEGORIES)[number];
+declare const NOTIFICATION_FREQUENCIES: readonly ['realtime', 'digest-daily', 'digest-weekly', 'off'];
+type NotificationFrequency = (typeof NOTIFICATION_FREQUENCIES)[number];
+interface NotificationItem {
+  id: string;
+  category: NotificationCategory;
+  type: string;
+  title: string;
+  body: string | null;
+  link: string | null;
+  readAt: string | null;
+  createdAt: string;
+}
+interface NotificationListResult {
+  items: NotificationItem[];
+  total: number;
+  hasMore: boolean;
+}
+/** 每类别投递频率（off = 关闭；旧版布尔值在读取时经 normalizeCategoryFrequencies 迁移） */
+type CategoryFrequencies = Record<NotificationCategory, NotificationFrequency>;
+interface NotificationPreferences {
+  categories: CategoryFrequencies;
+  dndEnabled: boolean;
+  dndStart: string;
+  dndEnd: string;
+}
+/** SSE 推送的自定义事件负载（AG-UI CUSTOM 事件的 value） */
+interface NotificationSsePayload {
+  kind: 'notification';
+  notification: NotificationItem;
+}
+interface UnreadSnapshotPayload {
+  kind: 'unread_snapshot';
+  count: number;
+}
+type NotificationSseValue = NotificationSsePayload | UnreadSnapshotPayload;
+//#endregion
+//#region src/contract/modules/notifications/index.d.ts
+declare const DEFAULT_CATEGORIES: CategoryFrequencies;
+/**
+ * 归一化存储中的 categories 字段。
+ * 存量数据为旧版布尔记录（true/false），读取时迁移为 frequency：
+ * true → realtime，false → off；未知值回退默认 realtime。
+ */
+declare function normalizeCategoryFrequencies(raw: unknown): CategoryFrequencies;
+declare function isInDndWindow(prefs: Pick<NotificationPreferences, 'dndEnabled' | 'dndStart' | 'dndEnd'>, now: string): boolean;
+//#endregion
+//#region src/contract/types/prototype.d.ts
+declare const DEVICE_SIZES: readonly ['mobile', 'tablet', 'desktop'];
+type DeviceSize = typeof DEVICE_SIZES[number];
+type DeviceType = {
+  size: DeviceSize;
+  label: string;
+  icon: string;
+};
+type CanvasElement = {
+  id: string;
+  type: string;
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+  props: Record<string, unknown>;
+  overrides?: Record<string, unknown>;
+  children?: CanvasElement[];
+};
+type ComponentCategory = 'basic' | 'layout' | 'data' | 'feedback' | 'navigation' | 'media' | 'form' | 'other';
+type ComponentSource = 'builtin' | 'custom' | 'imported';
+type EditableFieldType = 'text' | 'number' | 'boolean' | 'select' | 'color' | 'image' | 'json' | 'richtext';
+type EditablePropField = {
+  key: string;
+  label: string;
+  type: EditableFieldType;
+  default?: unknown;
+  options?: {
+    label: string;
+    value: unknown;
+  }[];
+};
+type PrototypeComponentConfig = {
+  type: string;
+  category: ComponentCategory;
+  label: string;
+  icon: string;
+  defaultProps: Record<string, unknown>;
+  editableFields: EditablePropField[];
+  source: ComponentSource;
+};
+type ResizeDirection = 'n' | 's' | 'e' | 'w' | 'ne' | 'nw' | 'se' | 'sw';
+type ResizeMode = 'strict' | 'free';
 //#endregion
-export { type ActivationResult, type AiQuota, type AnalyticsQuery, type AnalyticsResult, type AnalyticsService, type AssembleInput, type AssemblyFiles, type AuditLogEntry, type AuditQuery, type AuditService, type AutomationRule, type AutomationService, type BillingService, BillingUnavailableError, type CheckoutParams, type ComplianceJobSummary, type ComplianceService, type CustomDashboard, type DocumentTemplate, type DocumentVersion, type FeatureContribution, type GlobalSearchService, type HostSession, type HostedAiChatParams, type HostedAiChatResult, HostedAiError, type HostedAiModel, type HostedAiService, type InvoiceInfo, type LicenseInfo, type LicenseIssueParams, type LicenseIssueResult, type LicenseService, type LicenseStatus, type Middleware, type PermissionLevel, type PermissionsService, type PlanInfo, type PluginContributions, type PluginDefinition, type PluginRouteContext, type PortalSessionParams, type PrismaContribution, type ProEdition, type ProFeature, type ProModule, type ProServiceMap, type ProfileDefinition, type QueryFactoryMap, type ResolveResult, type RoleDefinition, type RouteContribution, type SearchParams, type SearchResult, type SeatCheckResult, SeatsExceededError, type ServerSeam, type SettingsTabContribution, type SsoProvider, type SsoService, type SubscriptionInfo, type TemplatesService, type UiSlotContributions, type VersionHistoryService, WebhookSignatureError, definePlugin, defineProfile, dumpModules, generateAssemblyCode, generateAssemblyFiles, getServerSeam, parseProfileImports, registerServerSeam, resolveImportSpecifiers, resolvePluginOrder };
+export { ADAPTER_KINDS, ADAPTER_KIND_VALUES, type AICommandContext, type AICommandDef, type AICommandHandler, type AICommandResult, type ActivationResult, AdapterKind, type AiAdapter, AiModelMeta, AiProviderMeta, AiProviderRow, type AiQuota, type AllBlueModule, type AnalyticsQuery, type AnalyticsResult, type AnalyticsService, type AssembleInput, type AssemblyFiles, type AuditLogEntry, type AuditQuery, type AuditService, type AutomationRule, type AutomationService, type AvatarConfig, type AvatarPart, type BillingService, BillingUnavailableError, type CLIAgentInfo, type CanvasElement, CategoryFrequencies, type CheckoutParams, type ComplianceJobSummary, type ComplianceService, type ComponentCategory, type ComponentSource, type CustomDashboard, DEFAULT_CATEGORIES, DEFAULT_WATCHED_DEPENDENCIES, DEPENDENCY_CATEGORIES, DEPENDENCY_PRIORITIES, type DEVICE_SIZES, DND_STICKY_THRESHOLD, DependencyCategory, DependencyPriority, DependencySeed, DependencyUsage, type DeveloperLogEntry, type DeviceType, type DocumentTemplate, type DocumentVersion, type EditableFieldType, type EditablePropField, type EntityDef, type EntityUpdateEvent, FEATURE_KEYS, type FeatureContribution, type FeatureKey, type FeatureMeta, FeatureRegistry, type GlobalSearchService, type HostSession, type HostedAiChatParams, type HostedAiChatResult, HostedAiError, type HostedAiModel, type HostedAiService, type InvoiceInfo, LOAD_MORE_STEP, LOBE_ICON_MAP, type LicenseInfo, type LicenseIssueParams, type LicenseIssueResult, type LicenseService, type LicenseStatus, MODEL_CAPABILITY_OPTIONS, MODEL_TABS, type Middleware, ModelCapability, ModelTab, NOTIFICATION_CATEGORIES, NOTIFICATION_FREQUENCIES, NotificationCategory, NotificationFrequency, NotificationItem, NotificationListResult, NotificationPreferences, NotificationSsePayload, NotificationSseValue, OSS_BASE_FEATURES, PROVIDER_BADGE_STYLES, PROVIDER_CATEGORIES, PROVIDER_CATEGORY_VALUES, type ParsedUA, type PermissionLevel, type PermissionsService, type PlanFeatures, PlanFeaturesSchema, type PlanInfo, type PluginContributions, type PluginDefinition, type PluginRouteContext, type PortalSessionParams, type PrismaContribution, type PrismaSeam, type ProEdition, type ProFeature, type ProModule, type ProServiceMap, type ProfileDefinition, type PrototypeComponentConfig, ProviderCategory, type QueryFactoryMap, RESOURCE_KEYS, type RealtimeTransport, type RefDisplay, type Reference, type ReferenceDisplayFn, type ResizeDirection, type ResizeMode, type ResolveResult, type ResolvedRef, type ResourceKey, type ResourceMeta, ResourceRegistry, type ResourceSnapshot, type ResourceSnapshots, type RoleDefinition, type RouteContribution, SEED_AI_PROVIDERS, type SearchParams, type SearchResult, type SeatCheckResult, SeatsExceededError, type ServerSeam, type SettingsTabContribution, type ShapeType, type SsoProvider, type SsoService, type SubscriptionInfo, SyncDependencyResult, type TemplatesService, ThirdPartyDependencyRow, type UiSlotContributions, UnreadSnapshotPayload, UpdateDependencyInput, VIRTUALIZE_THRESHOLD, type VersionHistoryService, VersionStatus, WebhookSignatureError, definePlugin, defineProfile, dumpModules, formatParsedUA, generateAssemblyCode, generateAssemblyFiles, getClientIp, getServerSeam, isInDndWindow, isOssFeature, isResourceDefined, normalizeCategoryFrequencies, parseProfileImports, parseUserAgent, registerPrismaSeam, registerServerSeam, resolveImportSpecifiers, resolveIpLocation, resolvePluginOrder };