@allbluecn/kernel 0.5.0 → 0.5.2

package/dist/src-K_nfYLIe.js

@@ -0,0 +1,1644 @@
+import { z } from "zod";
+import { BadgeDollarSign, BarChart3, Bell, Brain, Building2, Calendar, CircleStar, Database, Earth, FileText, Fish, Folder, GraduationCap, HandFist, Heart, HeartHandshake, Link, LoaderPinwheel, MessageSquare, Music4, Package, PartyPopper, PencilRuler, Settings, ShoppingCart, Shrimp, Sparkles, SquareChartGantt, ToolCase, Users, VenetianMask } from "lucide-react";
+//#region src/define-plugin.ts
+const PLUGIN_ID_RE = /^@[a-z0-9-]+\/[a-z0-9-]+$/;
+function definePlugin(def) {
+	if (!PLUGIN_ID_RE.test(def.id)) throw new Error(`插件 id 必须形如 '@scope/name'（小写），收到: ${def.id}`);
+	if (!/^\d+\.\d+\.\d+/.test(def.version)) throw new Error(`插件 version 必须是语义化版本，收到: ${def.version}`);
+	return deepFreeze(def);
+}
+function deepFreeze(value) {
+	if (value && typeof value === "object" && !Object.isFrozen(value)) {
+		Object.freeze(value);
+		for (const key of Object.keys(value)) deepFreeze(value[key]);
+	}
+	return value;
+}
+//#endregion
+//#region src/define-profile.ts
+const PROFILE_ID_RE = /^[a-z0-9][a-z0-9-]*$/;
+function defineProfile(profile) {
+	if (!PROFILE_ID_RE.test(profile.id)) throw new Error(`profile id 只允许小写字母/数字/连字符，收到: ${profile.id}`);
+	const seen = /* @__PURE__ */ new Set();
+	for (const plugin of profile.plugins) {
+		if (seen.has(plugin.id)) throw new Error(`profile 中存在重复插件 id: ${plugin.id}`);
+		seen.add(plugin.id);
+	}
+	return Object.freeze({
+		...profile,
+		plugins: Object.freeze([...profile.plugins])
+	});
+}
+//#endregion
+//#region src/resolve-order.ts
+function resolvePluginOrder(plugins) {
+	const byId = /* @__PURE__ */ new Map();
+	for (const plugin of plugins) {
+		if (byId.has(plugin.id)) throw new Error(`重复插件 id: ${plugin.id}`);
+		byId.set(plugin.id, plugin);
+	}
+	for (const plugin of plugins) for (const dep of plugin.dependencies ?? []) if (!byId.has(dep)) throw new Error(`插件 ${plugin.id} 依赖的 ${dep} 未在 profile 中声明`);
+	const declarationIndex = new Map(plugins.map((p, i) => [p.id, i]));
+	const inDegree = /* @__PURE__ */ new Map();
+	const dependents = /* @__PURE__ */ new Map();
+	for (const plugin of plugins) {
+		inDegree.set(plugin.id, plugin.dependencies?.length ?? 0);
+		for (const dep of plugin.dependencies ?? []) dependents.set(dep, [...dependents.get(dep) ?? [], plugin.id]);
+	}
+	const ready = plugins.filter((p) => (inDegree.get(p.id) ?? 0) === 0).sort((a, b) => declarationIndex.get(a.id) - declarationIndex.get(b.id)).map((p) => p.id);
+	const orderIds = [];
+	while (ready.length > 0) {
+		const id = ready.shift();
+		orderIds.push(id);
+		for (const dependent of dependents.get(id) ?? []) {
+			const next = (inDegree.get(dependent) ?? 0) - 1;
+			inDegree.set(dependent, next);
+			if (next === 0) ready.push(dependent);
+		}
+	}
+	if (orderIds.length !== plugins.length) {
+		const cyclePath = findCyclePath(plugins.filter((p) => !orderIds.includes(p.id)).map((p) => p.id), byId);
+		throw new Error(`检测到依赖环: ${cyclePath.join(" -> ")}`);
+	}
+	return {
+		order: orderIds.map((id) => byId.get(id)),
+		ids: orderIds
+	};
+}
+function findCyclePath(cyclicIds, byId) {
+	const start = cyclicIds[0];
+	const path = [start];
+	const visited = /* @__PURE__ */ new Set([start]);
+	let current = start;
+	while (true) {
+		const deps = byId.get(current)?.dependencies ?? [];
+		const next = deps.find((d) => cyclicIds.includes(d)) ?? deps[0];
+		if (!next) break;
+		if (next === start || visited.has(next)) {
+			path.push(next);
+			return path;
+		}
+		visited.add(next);
+		path.push(next);
+		current = next;
+	}
+	return path;
+}
+//#endregion
+//#region src/assemble-input.ts
+function parseProfileImports(source) {
+	const map = /* @__PURE__ */ new Map();
+	const re = /import\s+([A-Za-z_$][\w$]*)\s+from\s+['"]([^'"]+)['"]/g;
+	let m;
+	while ((m = re.exec(source)) !== null) map.set(m[1], m[2]);
+	return map;
+}
+function resolveImportSpecifiers(input) {
+	const byId = /* @__PURE__ */ new Map();
+	input.resolved.order.forEach((plugin, index) => {
+		const localName = input.pluginLocalNames[index];
+		if (!localName) throw new Error(`插件 ${plugin.id} 在 profile 源码中找不到对应标识符`);
+		const specifier = input.imports.get(localName);
+		if (!specifier) throw new Error(`标识符 ${localName} 没有 default import（约定：profile 中插件必须以 default import 引入）`);
+		byId.set(plugin.id, specifier);
+	});
+	return byId;
+}
+//#endregion
+//#region src/generate-assembly.ts
+function generateAssemblyCode(input) {
+	const { profileId, profileModulePath, resolved } = input;
+	const ids = resolved.ids.map((id) => `'${id}'`).join(", ");
+	return [
+		`// AUTO-GENERATED by @allbluecn/kernel — DO NOT EDIT`,
+		`// profile: ${profileId} (validated: ${resolved.order.length} plugins)`,
+		`// 拓扑序（被依赖者在前）：${resolved.ids.join(" -> ")}`,
+		`import type { ProfileDefinition } from '@allbluecn/kernel'`,
+		``,
+		`export { default as profile } from '${profileModulePath}'`,
+		``,
+		`export const pluginIds: string[] = [${ids}]`,
+		``,
+		`declare const _profile: ProfileDefinition`
+	].join("\n");
+}
+const HEADER = "// AUTO-GENERATED by @allbluecn/kernel — DO NOT EDIT";
+const ALL_FEATURES = [
+	"billing",
+	"hostedAi",
+	"sso",
+	"audit",
+	"permissions",
+	"license",
+	"versionHistory",
+	"automation",
+	"templates",
+	"analytics",
+	"globalSearch",
+	"compliance"
+];
+function generateAssemblyFiles(input) {
+	const specifiers = resolveImportSpecifiers(input);
+	const { resolved } = input;
+	const importLines = resolved.order.map((p, i) => {
+		return `import ${input.pluginLocalNames[i]} from '${specifiers.get(p.id)}'`;
+	});
+	const pluginList = input.pluginLocalNames.slice(0, resolved.order.length).join(", ");
+	const middlewareParts = resolved.order.map((p, i) => {
+		return `  ...${input.pluginLocalNames[i]}.contributes.serverMiddleware ?? [],`;
+	}).join("\n");
+	const pluginsGen = [
+		HEADER,
+		`// profile: ${input.profileId} (validated: ${resolved.order.length} plugins)`,
+		`// 拓扑序：${resolved.ids.join(" -> ")}`,
+		...importLines,
+		`import { defineProfile, type ProfileDefinition } from '@allbluecn/kernel'`,
+		``,
+		`export const profile: ProfileDefinition = defineProfile({`,
+		`  id: '${input.profileId}',`,
+		`  plugins: [${pluginList}],`,
+		`})`,
+		``,
+		`export const pluginIds: string[] = [${resolved.ids.map((i) => `'${i}'`).join(", ")}]`,
+		``,
+		`export const pluginMiddleware: unknown[] = [`,
+		middlewareParts,
+		`]`
+	].join("\n");
+	const implLines = ALL_FEATURES.map((f) => {
+		return `  ${f}: ${resolved.order.some((p) => p.contributes.services?.[f] !== void 0)},`;
+	});
+	const modulesGen = [
+		HEADER,
+		`import type { ProFeature } from '@allbluecn/kernel'`,
+		``,
+		`export const activePluginIds = [${resolved.ids.map((i) => `'${i}'`).join(", ")}] as const`,
+		`export type ActivePluginId = (typeof activePluginIds)[number]`,
+		``,
+		`export const implementedModules: Record<ProFeature, boolean> = {`,
+		...implLines,
+		`}`
+	].join("\n");
+	const uiImports = [];
+	const navItems = [];
+	const settingsTabs = [];
+	const widgets = [];
+	for (let i = 0; i < resolved.order.length; i++) {
+		const p = resolved.order[i];
+		const local = input.pluginLocalNames[i];
+		const spec = specifiers.get(p.id);
+		const slots = p.contributes.uiSlots;
+		if (!slots) continue;
+		for (const [key] of Object.entries(slots.navItems ?? {})) {
+			uiImports.push(`import { ${key} } from '${spec}/ui'`);
+			navItems.push(key);
+		}
+		if (slots.settingsTabs?.length) {
+			uiImports.push(`import { ${local}SettingsTabs } from '${spec}/ui'`);
+			settingsTabs.push(`...${local}SettingsTabs`);
+		}
+		for (const [key] of Object.entries(slots.dashboardWidgets ?? {})) {
+			uiImports.push(`import { ${key} } from '${spec}/ui'`);
+			widgets.push(key);
+		}
+	}
+	const uiGen = [
+		HEADER,
+		...uiImports,
+		`import { type ComponentType } from 'react'`,
+		`import type { SettingsTabContribution } from '@allbluecn/kernel'`,
+		``,
+		`export const navItems: ComponentType[] = [${navItems.join(", ")}]`,
+		`export const settingsTabs: SettingsTabContribution[] = [${settingsTabs.join(", ")}]`,
+		`export const dashboardWidgets: ComponentType[] = [${widgets.join(", ")}]`
+	].join("\n");
+	const routeFiles = /* @__PURE__ */ new Map();
+	for (let i = 0; i < resolved.order.length; i++) {
+		const p = resolved.order[i];
+		const spec = specifiers.get(p.id);
+		p.contributes.routes?.forEach((r, j) => {
+			const file = routeContributionToFile(r.path);
+			const varName = `${input.pluginLocalNames[i]}_route_${j}`;
+			const routePath = r.path.endsWith("/") ? r.path.slice(0, -1) : r.path;
+			const lines = [
+				HEADER,
+				`import { createFileRoute } from '@tanstack/react-router'`,
+				`import type { PluginRouteContext } from '@allbluecn/kernel'`,
+				`import { ${varName} } from '${spec}/routes'`,
+				``,
+				`export const Route = createFileRoute('${routePath}')({`,
+				...r.beforeLoad ? [`  beforeLoad: ((ctx: PluginRouteContext) => ${varName}.beforeLoad(ctx)) as any,`] : [],
+				...r.loader ? [`  loader: ((ctx: PluginRouteContext) => ${varName}.loader(ctx)) as any,`] : [],
+				...r.validateSearch ? [`  validateSearch: ${varName}.validateSearch as any,`] : [],
+				`  component: ${varName}.Component as any,`,
+				`})`
+			];
+			routeFiles.set(file, lines.join("\n"));
+		});
+	}
+	return {
+		pluginsGen,
+		modulesGen,
+		uiGen,
+		routeFiles
+	};
+}
+function routeContributionToFile(path) {
+	if (path.endsWith("/")) return `src/routes${path.slice(0, -1) || ""}/index.tsx`;
+	return `src/routes${path}/route.tsx`;
+}
+//#endregion
+//#region src/dump-modules.ts
+function dumpModules(profileId, resolved) {
+	const lines = [`profile: ${profileId} (${resolved.order.length} plugins)`];
+	for (const plugin of resolved.order) {
+		const c = plugin.contributes;
+		const parts = [];
+		if (c.routes?.length) parts.push(`routes:${c.routes.length}`);
+		if (c.serverMiddleware?.length) parts.push(`middleware:${c.serverMiddleware.length}`);
+		if (c.queryOptions && Object.keys(c.queryOptions).length) parts.push(`queries:${Object.keys(c.queryOptions).length}`);
+		if (c.uiSlots && Object.keys(c.uiSlots).length) parts.push(`ui-slots:${Object.keys(c.uiSlots).length}`);
+		if (c.features?.length) parts.push(`features:${c.features.length}`);
+		if (c.aiTools?.length) parts.push(`ai-tools:${c.aiTools.length}`);
+		if (c.prisma?.models.length) parts.push(`prisma-models:${c.prisma.models.length}`);
+		lines.push(`${plugin.id}@${plugin.version} — ${parts.length ? parts.join(" ") : "no contributions"}`);
+	}
+	return lines.join("\n");
+}
+//#endregion
+//#region src/pro-contract/billing.ts
+var BillingUnavailableError = class BillingUnavailableError extends Error {
+	constructor(message = "计费模块不可用") {
+		super(message);
+		this.name = "BillingUnavailableError";
+		Object.setPrototypeOf(this, BillingUnavailableError.prototype);
+	}
+};
+var WebhookSignatureError = class WebhookSignatureError extends Error {
+	constructor(message = "Webhook 签名验证失败") {
+		super(message);
+		this.name = "WebhookSignatureError";
+		Object.setPrototypeOf(this, WebhookSignatureError.prototype);
+	}
+};
+var SeatsExceededError = class SeatsExceededError extends Error {
+	current;
+	max;
+	constructor(current, max) {
+		super(`席位不足：当前 ${current}/${max}`);
+		this.name = "SeatsExceededError";
+		this.current = current;
+		this.max = max;
+		Object.setPrototypeOf(this, SeatsExceededError.prototype);
+	}
+};
+//#endregion
+//#region src/pro-contract/hosted-ai.ts
+var HostedAiError = class extends Error {
+	code;
+	details;
+	constructor(code, message, details) {
+		super(message);
+		this.code = code;
+		this.details = details;
+		this.name = "HostedAiError";
+	}
+};
+//#endregion
+//#region src/server-seam.ts
+let seam = null;
+function registerServerSeam(impl) {
+	seam = impl;
+}
+function getServerSeam() {
+	if (!seam) throw new Error("ServerSeam 未注册：宿主需在 start.ts 中调用 registerServerSeam()");
+	return seam;
+}
+function registerPrismaSeam(seam) {}
+//#endregion
+//#region src/contract/constants/perf.ts
+const VIRTUALIZE_THRESHOLD = 250;
+const LOAD_MORE_STEP = 200;
+const DND_STICKY_THRESHOLD = 500;
+//#endregion
+//#region src/contract/modules/ai-providers/types.ts
+/** 卡片角标的预设颜色（按文案匹配），admin 也可自由输入文案 */
+const PROVIDER_BADGE_STYLES = {
+	推荐: "bg-primary/10 text-primary border-primary/30",
+	热门: "bg-orange-500/10 text-orange-600 dark:text-orange-400 border-orange-500/30",
+	NEW: "bg-emerald-500/10 text-emerald-600 dark:text-emerald-400 border-emerald-500/30",
+	本地: "bg-blue-500/10 text-blue-600 dark:text-blue-400 border-blue-500/30"
+};
+//#endregion
+//#region src/contract/modules/ai-providers/constants.ts
+const ADAPTER_KINDS = [
+	{
+		value: "openai",
+		label: "OpenAI 官方",
+		description: "GPT 系列，OpenAI 协议"
+	},
+	{
+		value: "anthropic",
+		label: "Anthropic",
+		description: "Claude 系列，Anthropic 协议"
+	},
+	{
+		value: "gemini",
+		label: "Google Gemini",
+		description: "Gemini 系列，Google 协议"
+	},
+	{
+		value: "groq",
+		label: "Groq",
+		description: "Groq 极速推理引擎"
+	},
+	{
+		value: "grok",
+		label: "xAI Grok",
+		description: "Grok 系列，xAI 协议"
+	},
+	{
+		value: "openrouter",
+		label: "OpenRouter 聚合",
+		description: "一个 Key 访问 200+ 模型"
+	},
+	{
+		value: "ollama",
+		label: "Ollama 本地",
+		description: "本地部署开源模型，无需 API Key"
+	},
+	{
+		value: "openai-compatible",
+		label: "OpenAI 兼容",
+		description: "DeepSeek/Moonshot/Mistral 等兼容协议"
+	}
+];
+const PROVIDER_CATEGORIES = [
+	{
+		value: "recommended",
+		label: "推荐"
+	},
+	{
+		value: "popular",
+		label: "热门"
+	},
+	{
+		value: "local",
+		label: "本地"
+	}
+];
+const ADAPTER_KIND_VALUES = ADAPTER_KINDS.map((k) => k.value);
+const PROVIDER_CATEGORY_VALUES = PROVIDER_CATEGORIES.map((c) => c.value);
+const MODEL_CAPABILITY_OPTIONS = [
+	{
+		value: "text",
+		label: "文本"
+	},
+	{
+		value: "vision",
+		label: "视觉"
+	},
+	{
+		value: "tools",
+		label: "工具"
+	},
+	{
+		value: "reasoning",
+		label: "推理"
+	},
+	{
+		value: "audio",
+		label: "音频"
+	}
+];
+const MODEL_TABS = [
+	{
+		value: "all",
+		label: "全部"
+	},
+	{
+		value: "text",
+		label: "文本"
+	},
+	{
+		value: "reasoning",
+		label: "推理"
+	},
+	{
+		value: "tools",
+		label: "对话"
+	},
+	{
+		value: "vision",
+		label: "图片"
+	},
+	{
+		value: "video",
+		label: "视频"
+	}
+];
+/**
+* our providerId → @lobehub/icons PascalCase 导出名
+* 未知 providerId 返回 null，调用方 fallback 到首字母
+*/
+const LOBE_ICON_MAP = {
+	openai: "OpenAI",
+	anthropic: "Anthropic",
+	gemini: "Gemini",
+	deepseek: "DeepSeek",
+	groq: "Groq",
+	xai: "XAI",
+	openrouter: "OpenRouter",
+	mistral: "Mistral",
+	ollama: "Ollama",
+	moonshot: "Moonshot",
+	sensenova: "SenseNova",
+	agnes: "AgnesAI"
+};
+//#endregion
+//#region src/contract/modules/ai-providers/seed-data.ts
+/** 10 个最受欢迎 AI 服务商的种子数据，admin 可在其基础上增删改 */
+const SEED_AI_PROVIDERS = [
+	{
+		providerId: "openai",
+		displayName: "OpenAI",
+		brandName: "OpenAI",
+		description: "GPT 系列模型，业界领先的通用对话与推理能力",
+		category: "recommended",
+		iconSlug: "openai",
+		brandColor: "#10A37F",
+		badge: "推荐",
+		adapterKind: "openai",
+		defaultBaseUrl: "https://api.openai.com/v1",
+		keyUrl: "https://platform.openai.com/api-keys",
+		docsUrl: "https://platform.openai.com/docs",
+		keyPlaceholder: "sk-...",
+		models: [
+			{
+				id: "gpt-4o",
+				displayName: "GPT-4o",
+				contextWindow: 128e3,
+				capabilities: [
+					"text",
+					"vision",
+					"tools"
+				],
+				defaultEnabled: true
+			},
+			{
+				id: "gpt-4o-mini",
+				displayName: "GPT-4o mini",
+				contextWindow: 128e3,
+				capabilities: [
+					"text",
+					"vision",
+					"tools"
+				],
+				defaultEnabled: true
+			},
+			{
+				id: "o1",
+				displayName: "o1",
+				contextWindow: 2e5,
+				capabilities: ["text", "reasoning"]
+			},
+			{
+				id: "o1-mini",
+				displayName: "o1-mini",
+				contextWindow: 128e3,
+				capabilities: ["text", "reasoning"]
+			},
+			{
+				id: "o3-mini",
+				displayName: "o3-mini",
+				contextWindow: 2e5,
+				capabilities: [
+					"text",
+					"reasoning",
+					"tools"
+				],
+				defaultEnabled: true
+			}
+		]
+	},
+	{
+		providerId: "anthropic",
+		displayName: "Anthropic",
+		brandName: "Claude",
+		description: "Claude 系列模型，擅长长文本理解与代码生成",
+		category: "recommended",
+		iconSlug: "anthropic",
+		brandColor: "#D97757",
+		badge: "推荐",
+		adapterKind: "anthropic",
+		defaultBaseUrl: "https://api.anthropic.com",
+		keyUrl: "https://console.anthropic.com/settings/keys",
+		docsUrl: "https://docs.anthropic.com",
+		keyPlaceholder: "sk-ant-...",
+		models: [
+			{
+				id: "claude-sonnet-4-5",
+				displayName: "Claude Sonnet 4.5",
+				contextWindow: 2e5,
+				capabilities: [
+					"text",
+					"vision",
+					"tools",
+					"reasoning"
+				],
+				defaultEnabled: true
+			},
+			{
+				id: "claude-opus-4-1",
+				displayName: "Claude Opus 4.1",
+				contextWindow: 2e5,
+				capabilities: [
+					"text",
+					"vision",
+					"tools",
+					"reasoning"
+				]
+			},
+			{
+				id: "claude-haiku-4-5",
+				displayName: "Claude Haiku 4.5",
+				contextWindow: 2e5,
+				capabilities: [
+					"text",
+					"vision",
+					"tools"
+				],
+				defaultEnabled: true
+			}
+		]
+	},
+	{
+		providerId: "gemini",
+		displayName: "Google Gemini",
+		brandName: "Gemini",
+		description: "Google 推出的多模态大模型，支持文本、图像、视频",
+		category: "recommended",
+		iconSlug: "gemini",
+		brandColor: "#4285F4",
+		badge: "推荐",
+		adapterKind: "gemini",
+		defaultBaseUrl: "https://generativelanguage.googleapis.com",
+		keyUrl: "https://aistudio.google.com/apikey",
+		docsUrl: "https://ai.google.dev/gemini-api/docs",
+		keyPlaceholder: "AIza...",
+		models: [{
+			id: "gemini-2.5-pro",
+			displayName: "Gemini 2.5 Pro",
+			contextWindow: 2e6,
+			capabilities: [
+				"text",
+				"vision",
+				"tools",
+				"reasoning"
+			],
+			defaultEnabled: true
+		}, {
+			id: "gemini-2.5-flash",
+			displayName: "Gemini 2.5 Flash",
+			contextWindow: 1e6,
+			capabilities: [
+				"text",
+				"vision",
+				"tools"
+			],
+			defaultEnabled: true
+		}]
+	},
+	{
+		providerId: "deepseek",
+		displayName: "DeepSeek",
+		brandName: "DeepSeek",
+		description: "国产开源模型，性价比极高，支持推理模式",
+		category: "popular",
+		iconSlug: "deepseek",
+		brandColor: "#4D6BFE",
+		badge: "热门",
+		adapterKind: "openai-compatible",
+		defaultBaseUrl: "https://api.deepseek.com/v1",
+		keyUrl: "https://platform.deepseek.com/api_keys",
+		docsUrl: "https://api-docs.deepseek.com",
+		keyPlaceholder: "sk-...",
+		models: [{
+			id: "deepseek-chat",
+			displayName: "DeepSeek Chat (V3)",
+			contextWindow: 64e3,
+			capabilities: ["text", "tools"],
+			defaultEnabled: true
+		}, {
+			id: "deepseek-reasoner",
+			displayName: "DeepSeek Reasoner (R1)",
+			contextWindow: 64e3,
+			capabilities: ["text", "reasoning"],
+			defaultEnabled: true
+		}]
+	},
+	{
+		providerId: "groq",
+		displayName: "Groq",
+		brandName: "Groq",
+		description: "基于 LPU 的极速推理引擎，延迟低至毫秒级",
+		category: "popular",
+		iconSlug: "groq",
+		brandColor: "#F55036",
+		badge: "热门",
+		adapterKind: "groq",
+		defaultBaseUrl: "https://api.groq.com/openai/v1",
+		keyUrl: "https://console.groq.com/keys",
+		docsUrl: "https://console.groq.com/docs",
+		keyPlaceholder: "gsk_...",
+		models: [{
+			id: "llama-3.3-70b-versatile",
+			displayName: "Llama 3.3 70B",
+			contextWindow: 128e3,
+			capabilities: ["text", "tools"],
+			defaultEnabled: true
+		}, {
+			id: "llama-3.1-8b-instant",
+			displayName: "Llama 3.1 8B Instant",
+			contextWindow: 128e3,
+			capabilities: ["text"]
+		}]
+	},
+	{
+		providerId: "xai",
+		displayName: "xAI",
+		brandName: "Grok",
+		description: "Elon Musk 的 xAI 推出的 Grok 系列模型",
+		category: "popular",
+		iconSlug: "x",
+		brandColor: "#000000",
+		badge: "热门",
+		adapterKind: "grok",
+		defaultBaseUrl: "https://api.x.ai",
+		keyUrl: "https://x.ai/api",
+		docsUrl: "https://docs.x.ai",
+		keyPlaceholder: "xai-...",
+		models: [{
+			id: "grok-4",
+			displayName: "Grok 4",
+			contextWindow: 256e3,
+			capabilities: [
+				"text",
+				"vision",
+				"tools",
+				"reasoning"
+			],
+			defaultEnabled: true
+		}, {
+			id: "grok-3",
+			displayName: "Grok 3",
+			contextWindow: 131072,
+			capabilities: ["text", "tools"]
+		}]
+	},
+	{
+		providerId: "openrouter",
+		displayName: "OpenRouter",
+		brandName: "OpenRouter",
+		description: "聚合 200+ 模型的统一路由，一个 Key 访问所有厂商",
+		category: "recommended",
+		iconSlug: "openrouter",
+		brandColor: "#6467F2",
+		badge: "推荐",
+		adapterKind: "openrouter",
+		defaultBaseUrl: "https://openrouter.ai/api/v1",
+		keyUrl: "https://openrouter.ai/keys",
+		docsUrl: "https://openrouter.ai/docs",
+		keyPlaceholder: "sk-or-...",
+		models: [
+			{
+				id: "openai/gpt-4o-mini",
+				displayName: "GPT-4o mini",
+				contextWindow: 128e3,
+				capabilities: [
+					"text",
+					"vision",
+					"tools"
+				],
+				defaultEnabled: true
+			},
+			{
+				id: "openai/gpt-4o",
+				displayName: "GPT-4o",
+				contextWindow: 128e3,
+				capabilities: [
+					"text",
+					"vision",
+					"tools"
+				]
+			},
+			{
+				id: "anthropic/claude-sonnet-4.5",
+				displayName: "Claude Sonnet 4.5",
+				contextWindow: 2e5,
+				capabilities: [
+					"text",
+					"vision",
+					"tools",
+					"reasoning"
+				],
+				defaultEnabled: true
+			},
+			{
+				id: "google/gemini-2.5-flash",
+				displayName: "Gemini 2.5 Flash",
+				contextWindow: 1e6,
+				capabilities: [
+					"text",
+					"vision",
+					"tools"
+				],
+				defaultEnabled: true
+			},
+			{
+				id: "deepseek/deepseek-chat",
+				displayName: "DeepSeek V3",
+				contextWindow: 64e3,
+				capabilities: ["text", "tools"]
+			}
+		]
+	},
+	{
+		providerId: "mistral",
+		displayName: "Mistral AI",
+		brandName: "Mistral",
+		description: "欧洲开源大模型，擅长多语言与代码",
+		category: "popular",
+		iconSlug: "mistralai",
+		brandColor: "#FF7000",
+		badge: "热门",
+		adapterKind: "openai-compatible",
+		defaultBaseUrl: "https://api.mistral.ai/v1",
+		keyUrl: "https://console.mistral.ai/api-keys",
+		docsUrl: "https://docs.mistral.ai",
+		keyPlaceholder: "...",
+		models: [{
+			id: "mistral-large-latest",
+			displayName: "Mistral Large",
+			contextWindow: 128e3,
+			capabilities: [
+				"text",
+				"vision",
+				"tools"
+			],
+			defaultEnabled: true
+		}, {
+			id: "mistral-small-latest",
+			displayName: "Mistral Small",
+			contextWindow: 32e3,
+			capabilities: ["text", "tools"],
+			defaultEnabled: true
+		}]
+	},
+	{
+		providerId: "moonshot",
+		displayName: "Moonshot AI",
+		brandName: "Kimi",
+		description: "月之暗面 Kimi，国产长文本之王",
+		category: "popular",
+		iconSlug: "moonshot",
+		brandColor: "#16161A",
+		badge: "热门",
+		adapterKind: "openai-compatible",
+		defaultBaseUrl: "https://api.moonshot.cn/v1",
+		keyUrl: "https://platform.moonshot.cn/console/api-keys",
+		docsUrl: "https://platform.moonshot.cn/docs",
+		keyPlaceholder: "sk-...",
+		models: [{
+			id: "moonshot-v1-128k",
+			displayName: "Moonshot v1 128K",
+			contextWindow: 128e3,
+			capabilities: ["text", "tools"],
+			defaultEnabled: true
+		}, {
+			id: "kimi-k2-0905-preview",
+			displayName: "Kimi K2",
+			contextWindow: 128e3,
+			capabilities: ["text", "tools"],
+			defaultEnabled: true
+		}]
+	},
+	{
+		providerId: "sensenova",
+		displayName: "商汤日日新",
+		brandName: "SenseNova",
+		description: "商汤科技 SenseNova 大模型，支持文本对话与视觉理解",
+		category: "popular",
+		iconSlug: "sensenova",
+		brandColor: "#6B4EFF",
+		badge: "热门",
+		adapterKind: "openai-compatible",
+		defaultBaseUrl: "https://token.sensenova.cn/v1",
+		keyUrl: "https://platform.sensenova.cn/console/keys",
+		docsUrl: "https://platform.sensenova.cn/docs",
+		keyPlaceholder: "sk-...",
+		models: [
+			{
+				id: "SenseChat-6",
+				displayName: "SenseChat 6",
+				contextWindow: 8192,
+				capabilities: [
+					"text",
+					"vision",
+					"tools"
+				],
+				defaultEnabled: true
+			},
+			{
+				id: "SenseChat-5",
+				displayName: "SenseChat 5",
+				contextWindow: 8192,
+				capabilities: [
+					"text",
+					"vision",
+					"tools"
+				]
+			},
+			{
+				id: "SenseChat-5-Lite",
+				displayName: "SenseChat 5 Lite",
+				contextWindow: 8192,
+				capabilities: ["text", "tools"]
+			}
+		]
+	},
+	{
+		providerId: "agnes",
+		displayName: "Agnes AI",
+		brandName: "Agnes",
+		description: "Agnes AI 多模态大模型，兼容 OpenAI 接口，支持文本、图像、视频",
+		category: "popular",
+		iconSlug: "agnesai",
+		brandColor: "#7C3AED",
+		badge: "NEW",
+		adapterKind: "openai-compatible",
+		defaultBaseUrl: "https://apihub.agnes-ai.com/v1",
+		keyUrl: "https://agnes-ai.com/api-keys",
+		docsUrl: "https://wiki.agnes-ai.com/en/docs/overview.md",
+		keyPlaceholder: "sk-...",
+		models: [
+			{
+				id: "agnes-2.5-pro",
+				displayName: "Agnes 2.5 Pro",
+				contextWindow: 1e6,
+				capabilities: [
+					"text",
+					"vision",
+					"tools",
+					"reasoning"
+				],
+				defaultEnabled: true
+			},
+			{
+				id: "agnes-2.5-flash",
+				displayName: "Agnes 2.5 Flash",
+				contextWindow: 512e3,
+				capabilities: [
+					"text",
+					"vision",
+					"tools"
+				],
+				defaultEnabled: true
+			},
+			{
+				id: "agnes-2.0-flash",
+				displayName: "Agnes 2.0 Flash",
+				contextWindow: 512e3,
+				capabilities: [
+					"text",
+					"vision",
+					"tools"
+				]
+			}
+		]
+	},
+	{
+		providerId: "ollama",
+		displayName: "Ollama",
+		brandName: "Ollama",
+		description: "本地部署开源模型，零成本零延迟（需先本地安装 Ollama）",
+		category: "local",
+		iconSlug: "ollama",
+		brandColor: "#FFFFFF",
+		badge: "本地",
+		adapterKind: "ollama",
+		defaultBaseUrl: "http://localhost:11434",
+		keyUrl: "https://ollama.com/download",
+		docsUrl: "https://ollama.com/library",
+		keyPlaceholder: "本地部署无需 API Key",
+		isLocal: true,
+		models: [
+			{
+				id: "llama3.3",
+				displayName: "Llama 3.3",
+				contextWindow: 128e3,
+				capabilities: ["text", "tools"],
+				defaultEnabled: true
+			},
+			{
+				id: "qwen2.5",
+				displayName: "Qwen 2.5",
+				contextWindow: 128e3,
+				capabilities: ["text"],
+				defaultEnabled: true
+			},
+			{
+				id: "deepseek-r1",
+				displayName: "DeepSeek R1",
+				contextWindow: 128e3,
+				capabilities: ["text", "reasoning"]
+			}
+		]
+	}
+];
+//#endregion
+//#region src/contract/modules/dependencies/index.ts
+/** 依赖分类元信息 */
+const DEPENDENCY_CATEGORIES = [
+	{
+		value: "framework",
+		label: "框架核心",
+		description: "TanStack Start / React / Vite / Prisma 等基础设施"
+	},
+	{
+		value: "ui",
+		label: "UI 组件",
+		description: "radix / motion / lucide / tailwind 等界面库"
+	},
+	{
+		value: "editor",
+		label: "编辑器",
+		description: "TipTap / mind-elixir / lowlight 等富文本/思维导图"
+	},
+	{
+		value: "ai",
+		label: "AI 能力",
+		description: "@tanstack/ai / openai 等 LLM 集成"
+	},
+	{
+		value: "state",
+		label: "状态管理",
+		description: "react-query / react-form 等状态/数据层"
+	},
+	{
+		value: "auth",
+		label: "认证",
+		description: "start-authjs / @auth/core / bcryptjs"
+	},
+	{
+		value: "tool",
+		label: "工具库",
+		description: "zod / nanoid / i18next 等通用工具"
+	},
+	{
+		value: "other",
+		label: "其他",
+		description: "未分类依赖"
+	}
+];
+const DEPENDENCY_PRIORITIES = [
+	{
+		value: "high",
+		label: "高"
+	},
+	{
+		value: "normal",
+		label: "中"
+	},
+	{
+		value: "low",
+		label: "低"
+	}
+];
+const DEFAULT_WATCHED_DEPENDENCIES = [
+	{
+		name: "@tanstack/react-start",
+		displayName: "TanStack Start",
+		description: "全栈 React 框架，文件路由 + SSR/SSG",
+		homepage: "https://tanstack.com/start",
+		category: "framework",
+		priority: "high"
+	},
+	{
+		name: "@tanstack/react-router",
+		displayName: "TanStack Router",
+		description: "类型安全的路由库，支持文件路由与代码拆分",
+		homepage: "https://tanstack.com/router",
+		category: "framework",
+		priority: "high"
+	},
+	{
+		name: "vite",
+		displayName: "Vite",
+		description: "下一代前端构建工具，ESM 原生 + 极速 HMR",
+		homepage: "https://vite.dev",
+		category: "framework",
+		priority: "high"
+	},
+	{
+		name: "react",
+		displayName: "React",
+		description: "声明式 UI 库，组件化开发基础",
+		homepage: "https://react.dev",
+		category: "framework",
+		priority: "high"
+	},
+	{
+		name: "react-dom",
+		displayName: "React DOM",
+		description: "React 的 DOM 渲染器",
+		homepage: "https://react.dev",
+		category: "framework",
+		priority: "high"
+	},
+	{
+		name: "prisma",
+		displayName: "Prisma",
+		description: "TypeScript ORM，Schema 优先的数据库工具链",
+		homepage: "https://prisma.io",
+		category: "framework",
+		priority: "high"
+	},
+	{
+		name: "@prisma/client",
+		displayName: "Prisma Client",
+		description: "Prisma 自动生成的类型安全查询客户端",
+		homepage: "https://prisma.io",
+		category: "framework",
+		priority: "high"
+	},
+	{
+		name: "start-authjs",
+		displayName: "start-authjs",
+		description: "TanStack Start 的 Auth.js 集成，提供登录态管理",
+		homepage: "https://github.com/kophzeior/start-authjs",
+		category: "auth",
+		priority: "high"
+	},
+	{
+		name: "@auth/core",
+		displayName: "Auth.js Core",
+		description: "Auth.js 核心，支持 Credentials/OAuth 等多种登录方式",
+		homepage: "https://authjs.dev",
+		category: "auth",
+		priority: "normal"
+	},
+	{
+		name: "@tiptap/core",
+		displayName: "TipTap Core",
+		description: "无头（headless）富文本编辑器核心，可扩展",
+		homepage: "https://tiptap.dev",
+		category: "editor",
+		priority: "high"
+	},
+	{
+		name: "@tiptap/react",
+		displayName: "TipTap React",
+		description: "TipTap 编辑器的 React 绑定",
+		homepage: "https://tiptap.dev",
+		category: "editor",
+		priority: "high"
+	},
+	{
+		name: "@tiptap/starter-kit",
+		displayName: "TipTap Starter Kit",
+		description: "TipTap 预置扩展集合（段落/列表/历史等）",
+		homepage: "https://tiptap.dev",
+		category: "editor",
+		priority: "normal"
+	},
+	{
+		name: "mind-elixir",
+		displayName: "Mind Elixir",
+		description: "轻量思维导图库，支持节点编辑与导出",
+		homepage: "https://github.com/ssshooter/mind-elixir",
+		category: "editor",
+		priority: "high"
+	},
+	{
+		name: "lowlight",
+		displayName: "Lowlight",
+		description: "基于 highlight.js 的语法高亮解析器",
+		homepage: "https://github.com/wooorm/lowlight",
+		category: "editor",
+		priority: "normal"
+	},
+	{
+		name: "@tanstack/ai",
+		displayName: "TanStack AI",
+		description: "类型安全的 LLM SDK，支持流式输出与工具调用",
+		homepage: "https://tanstack.com/ai",
+		category: "ai",
+		priority: "high"
+	},
+	{
+		name: "@tanstack/ai-react",
+		displayName: "TanStack AI React",
+		description: "TanStack AI 的 React hooks（useChat 等）",
+		homepage: "https://tanstack.com/ai",
+		category: "ai",
+		priority: "normal"
+	},
+	{
+		name: "@tanstack/ai-openai",
+		displayName: "TanStack AI OpenAI Adapter",
+		description: "TanStack AI 的 OpenAI 官方模型适配器",
+		homepage: "https://tanstack.com/ai",
+		category: "ai",
+		priority: "normal"
+	},
+	{
+		name: "@tanstack/ai-anthropic",
+		displayName: "TanStack AI Anthropic Adapter",
+		description: "TanStack AI 的 Anthropic Claude 适配器",
+		homepage: "https://tanstack.com/ai",
+		category: "ai",
+		priority: "normal"
+	},
+	{
+		name: "@tanstack/ai-openrouter",
+		displayName: "TanStack AI OpenRouter Adapter",
+		description: "OpenRouter 多模型聚合适配器",
+		homepage: "https://tanstack.com/ai",
+		category: "ai",
+		priority: "normal"
+	},
+	{
+		name: "openai",
+		displayName: "OpenAI SDK",
+		description: "OpenAI 官方 SDK，本项目用于 embedding 生成",
+		homepage: "https://openai.com",
+		category: "ai",
+		priority: "normal"
+	},
+	{
+		name: "radix-ui",
+		displayName: "Radix UI",
+		description: "无样式可访问组件库统一入口（dialog/menu 等）",
+		homepage: "https://radix-ui.com",
+		category: "ui",
+		priority: "high"
+	},
+	{
+		name: "motion",
+		displayName: "Motion",
+		description: "React 动画库（原 framer-motion），声明式动画",
+		homepage: "https://motion.dev",
+		category: "ui",
+		priority: "normal"
+	},
+	{
+		name: "lucide-react",
+		displayName: "Lucide React",
+		description: "Lucide 图标库的 React 版本",
+		homepage: "https://lucide.dev",
+		category: "ui",
+		priority: "normal"
+	},
+	{
+		name: "next-themes",
+		displayName: "Next Themes",
+		description: "主题切换库，支持暗黑模式持久化",
+		homepage: "https://github.com/pacocoursey/next-themes",
+		category: "ui",
+		priority: "normal"
+	},
+	{
+		name: "tailwindcss",
+		displayName: "Tailwind CSS",
+		description: "原子化 CSS 框架，工具类优先",
+		homepage: "https://tailwindcss.com",
+		category: "ui",
+		priority: "high"
+	},
+	{
+		name: "shadcn",
+		displayName: "shadcn",
+		description: "可复制粘贴的组件集合 CLI，项目 UI 组件来源",
+		homepage: "https://ui.shadcn.com",
+		category: "ui",
+		priority: "normal"
+	},
+	{
+		name: "sonner",
+		displayName: "Sonner",
+		description: "Toast 通知组件，项目消息提示",
+		homepage: "https://sonner.emilkowal.ski",
+		category: "ui",
+		priority: "normal"
+	},
+	{
+		name: "@tanstack/react-query",
+		displayName: "TanStack Query",
+		description: "服务端状态管理与缓存，数据获取利器",
+		homepage: "https://tanstack.com/query",
+		category: "state",
+		priority: "high"
+	},
+	{
+		name: "@tanstack/react-form",
+		displayName: "TanStack Form",
+		description: "类型安全的表单管理库",
+		homepage: "https://tanstack.com/form",
+		category: "state",
+		priority: "normal"
+	},
+	{
+		name: "zod",
+		displayName: "Zod",
+		description: "TypeScript 优先的 Schema 校验库",
+		homepage: "https://zod.dev",
+		category: "tool",
+		priority: "high"
+	},
+	{
+		name: "i18next",
+		displayName: "i18next",
+		description: "国际化框架，多语言文案管理",
+		homepage: "https://www.i18next.com",
+		category: "tool",
+		priority: "normal"
+	},
+	{
+		name: "react-i18next",
+		displayName: "React i18next",
+		description: "i18next 的 React 绑定",
+		homepage: "https://react.i18next.com",
+		category: "tool",
+		priority: "normal"
+	},
+	{
+		name: "nanoid",
+		displayName: "Nano ID",
+		description: "轻量 URL 友好的唯一 ID 生成器",
+		homepage: "https://github.com/ai/nanoid",
+		category: "tool",
+		priority: "low"
+	},
+	{
+		name: "bcryptjs",
+		displayName: "bcryptjs",
+		description: "密码哈希库，纯 JS 实现",
+		homepage: "https://github.com/dcodeIO/bcrypt.js",
+		category: "auth",
+		priority: "normal"
+	}
+];
+//#endregion
+//#region src/contract/infrastructure/ip-location.ts
+/**
+* IP 地理位置查询工具（服务端专用）
+*
+* - 开发环境 / 内网 IP：返回「本地」
+* - 生产环境：使用 ip-api.com 免费查询（中文，每分钟 45 请求限制）
+*   失败时返回「未知」，不阻塞登录流程
+*/
+const PRIVATE_IP_PATTERNS = /^(127\.|10\.|192\.168\.|172\.(1[6-9]|2\d|3[01])\.|::1$|fc00:|fd00:|fe80:|169\.254\.|localhost)/i;
+async function resolveIpLocation(ip) {
+	if (!ip) return "Unknown";
+	if (PRIVATE_IP_PATTERNS.test(ip)) return "Local";
+	try {
+		const controller = new AbortController();
+		const timeout = setTimeout(() => controller.abort(), 3e3);
+		const res = await fetch(`http://ip-api.com/json/${encodeURIComponent(ip)}?fields=status,country,regionName,city&lang=zh-CN`, { signal: controller.signal });
+		clearTimeout(timeout);
+		if (!res.ok) return "Unknown";
+		const data = await res.json();
+		if (data.status !== "success") return "Unknown";
+		const parts = [
+			data.city,
+			data.regionName,
+			data.country
+		].filter(Boolean);
+		return parts.length > 0 ? parts.join(", ") : "Unknown";
+	} catch {
+		return "Unknown";
+	}
+}
+/**
+* 从 Request 中提取客户端真实 IP
+* 优先级：X-Forwarded-For > X-Real-IP > CF-Connecting-IP
+*/
+function getClientIp(request) {
+	const xff = request.headers.get("x-forwarded-for");
+	if (xff) {
+		const first = xff.split(",")[0]?.trim();
+		if (first) return first;
+	}
+	const xri = request.headers.get("x-real-ip");
+	if (xri) return xri.trim();
+	const cfip = request.headers.get("cf-connecting-ip");
+	if (cfip) return cfip.trim();
+	return null;
+}
+//#endregion
+//#region src/contract/infrastructure/ua-parser.ts
+function parseUserAgent(ua) {
+	if (!ua) return {
+		browser: "Unknown",
+		os: "Unknown",
+		device: "Unknown"
+	};
+	let browser = "Unknown";
+	if (ua.includes("Edg/")) {
+		const m = ua.match(/Edg\/(\d+)/);
+		browser = `Edge${m ? " " + m[1] : ""}`;
+	} else if (ua.includes("OPR/") || ua.includes("Opera")) {
+		const m = ua.match(/(?:OPR|Opera)\/(\d+)/);
+		browser = `Opera${m ? " " + m[1] : ""}`;
+	} else if (ua.includes("Firefox/")) {
+		const m = ua.match(/Firefox\/(\d+)/);
+		browser = `Firefox${m ? " " + m[1] : ""}`;
+	} else if (ua.includes("Chrome/")) {
+		const m = ua.match(/Chrome\/(\d+)/);
+		browser = `Chrome${m ? " " + m[1] : ""}`;
+	} else if (ua.includes("Safari/") && !ua.includes("Chrome")) {
+		const m = ua.match(/Version\/(\d+)/);
+		browser = `Safari${m ? " " + m[1] : ""}`;
+	}
+	let os = "Unknown";
+	if (ua.includes("Windows NT 10")) os = "Windows 10/11";
+	else if (ua.includes("Windows NT 6.3")) os = "Windows 8.1";
+	else if (ua.includes("Windows NT 6.2")) os = "Windows 8";
+	else if (ua.includes("Windows NT 6.1")) os = "Windows 7";
+	else if (ua.includes("Windows")) os = "Windows";
+	else if (ua.includes("Mac OS X") || ua.includes("Macintosh")) {
+		if (/Mac OS X 10_15/.test(ua)) os = "macOS";
+		else {
+			const m = ua.match(/Mac OS X (\d+)(?:[_.](\d+))?/);
+			if (m) {
+				const major = parseInt(m[1], 10);
+				os = major >= 11 ? `macOS ${major}` : `Mac OS X ${m[1]}.${m[2] ?? "0"}`;
+			} else os = "macOS";
+		}
+	} else if (ua.includes("Android")) {
+		const m = ua.match(/Android ([\d.]+)/);
+		os = `Android${m ? " " + m[1] : ""}`;
+	} else if (/iPhone|iPad|iPod/.test(ua)) {
+		const m = ua.match(/OS (\d+)[_ ](?:\d+)?/);
+		os = `iOS${m ? " " + m[1] : ""}`;
+	} else if (ua.includes("Linux")) os = "Linux";
+	let device = "Desktop";
+	if (ua.includes("iPad")) device = "iPad";
+	else if (ua.includes("iPhone")) device = "iPhone";
+	else if (ua.includes("Android") && ua.includes("Mobile")) device = "Android Phone";
+	else if (ua.includes("Android")) device = "Android Tablet";
+	return {
+		browser,
+		os,
+		device
+	};
+}
+/**
+* 将 ParsedUA 拼接为可读字符串，如 "Chrome 120 / Windows 10/11 / 桌面"
+*/
+function formatParsedUA(parsed) {
+	return [
+		parsed.browser,
+		parsed.os,
+		parsed.device
+	].filter((s) => s && s !== "Unknown").join(" / ");
+}
+//#endregion
+//#region src/contract/modules/billing/feature-registry.ts
+const FeatureRegistry = {
+	byokAi: {
+		tier: "oss",
+		module: null
+	},
+	hostedAi: {
+		tier: "paid",
+		module: "hostedAi"
+	},
+	multiProvider: {
+		tier: "paid",
+		module: null
+	},
+	largePageSize: {
+		tier: "paid",
+		module: null
+	},
+	versionHistory: {
+		tier: "paid",
+		module: "versionHistory"
+	},
+	automation: {
+		tier: "paid",
+		module: "automation"
+	},
+	templates: {
+		tier: "paid",
+		module: "templates"
+	},
+	globalSearch: {
+		tier: "paid",
+		module: "globalSearch"
+	},
+	analytics: {
+		tier: "enterprise",
+		module: "analytics"
+	},
+	sso: {
+		tier: "enterprise",
+		module: "sso"
+	},
+	audit: {
+		tier: "enterprise",
+		module: "audit"
+	},
+	advancedPermissions: {
+		tier: "enterprise",
+		module: "permissions"
+	},
+	compliance: {
+		tier: "enterprise",
+		module: "compliance"
+	},
+	customAgents: {
+		tier: "paid",
+		module: null
+	}
+};
+const FEATURE_KEYS = Object.keys(FeatureRegistry);
+/** OSS 部署（billing 模块缺失）的基础白名单——唯一允许「无订阅即放行」的集合 */
+const OSS_BASE_FEATURES = ["byokAi", "customAgents"];
+function isOssFeature(key) {
+	return FeatureRegistry[key].tier === "oss";
+}
+//#endregion
+//#region src/contract/modules/billing/plan-features-schema.ts
+const PlanFeaturesSchema = z.record(z.enum(FEATURE_KEYS), z.boolean());
+//#endregion
+//#region src/contract/modules/billing/resource-registry.ts
+const ResourceRegistry = {
+	seats: {
+		/** 成员席位池（billing 加购语义不变）；访客池见 guestSeats */
+		tier: "paid",
+		unit: "per-seat",
+		purchasable: true,
+		step: 1,
+		floor: "activeMembers"
+	},
+	guestSeats: {
+		tier: "paid",
+		unit: "guest-seats",
+		purchasable: false,
+		step: 1
+	},
+	aiQuotaMonthly: {
+		tier: "paid",
+		unit: "requests/month",
+		purchasable: false,
+		step: 1
+	},
+	agentQuota: {
+		tier: "paid",
+		unit: "agents",
+		purchasable: false,
+		step: 1
+	},
+	skillQuota: {
+		tier: "paid",
+		unit: "skills",
+		purchasable: false,
+		step: 1
+	},
+	workspaces: {
+		tier: "paid",
+		unit: "workspaces",
+		purchasable: false,
+		step: 1
+	}
+};
+const RESOURCE_KEYS = Object.keys(ResourceRegistry);
+function isResourceDefined(key) {
+	return key in ResourceRegistry;
+}
+//#endregion
+//#region src/contract/modules/notifications/types.ts
+const NOTIFICATION_CATEGORIES = [
+	"team",
+	"collaboration",
+	"system",
+	"billing",
+	"security"
+];
+const NOTIFICATION_FREQUENCIES = [
+	"realtime",
+	"digest-daily",
+	"digest-weekly",
+	"off"
+];
+//#endregion
+//#region src/contract/modules/notifications/index.ts
+const DEFAULT_CATEGORIES = {
+	team: "realtime",
+	collaboration: "realtime",
+	system: "realtime",
+	billing: "realtime",
+	security: "realtime"
+};
+/**
+* 归一化存储中的 categories 字段。
+* 存量数据为旧版布尔记录（true/false），读取时迁移为 frequency：
+* true → realtime，false → off；未知值回退默认 realtime。
+*/
+function normalizeCategoryFrequencies(raw) {
+	const result = { ...DEFAULT_CATEGORIES };
+	if (!raw || typeof raw !== "object") return result;
+	const record = raw;
+	const valid = NOTIFICATION_FREQUENCIES;
+	for (const c of NOTIFICATION_CATEGORIES) {
+		const v = record[c];
+		if (v === true) result[c] = "realtime";
+		else if (v === false) result[c] = "off";
+		else if (typeof v === "string" && valid.includes(v)) result[c] = v;
+	}
+	return result;
+}
+function isInDndWindow(prefs, now) {
+	if (!prefs.dndEnabled) return false;
+	const [sh, sm] = prefs.dndStart.split(":").map(Number);
+	const [eh, em] = prefs.dndEnd.split(":").map(Number);
+	const [nh, nm] = now.split(":").map(Number);
+	const start = sh * 60 + sm;
+	const end = eh * 60 + em;
+	const cur = nh * 60 + nm;
+	if (start <= end) return cur >= start && cur < end;
+	return cur >= start || cur < end;
+}
+//#endregion
+//#region src/contract/modules/registry.ts
+var ModuleRegistry = class {
+	modules = /* @__PURE__ */ new Map();
+	register(mod) {
+		if (this.modules.has(mod.id)) console.warn(`[ModuleRegistry] "${mod.id}" already registered, overwriting`);
+		this.modules.set(mod.id, mod);
+	}
+	getModule(id) {
+		return this.modules.get(id);
+	}
+	getAll() {
+		return [...this.modules.values()];
+	}
+	getAICommands() {
+		return [...this.modules.values()].flatMap((m) => m.aiCommands);
+	}
+	getSearchFields() {
+		return [...this.modules.values()].flatMap((m) => m.entities.map((e) => ({
+			module: m.id,
+			type: e.type,
+			fields: e.searchFields
+		})));
+	}
+};
+const moduleRegistry = new ModuleRegistry();
+//#endregion
+//#region src/contract/types/prototype.ts
+const DEVICE_SIZES = {
+	desktop: null,
+	tablet: 768,
+	mobile: 375
+};
+//#endregion
+//#region src/contract/types/prd.ts
+const ICON_MAP = {
+	folder: Folder,
+	file: FileText,
+	chart: BarChart3,
+	users: Users,
+	settings: Settings,
+	package: Package,
+	database: Database,
+	cart: ShoppingCart,
+	heart: Heart,
+	sparkles: Sparkles,
+	link: Link,
+	message: MessageSquare,
+	calendar: Calendar,
+	bell: Bell,
+	building2: Building2,
+	squareChartGantt: SquareChartGantt,
+	heartHandshake: HeartHandshake,
+	shrimp: Shrimp,
+	fish: Fish,
+	venetianMask: VenetianMask,
+	graduationCap: GraduationCap,
+	handFist: HandFist,
+	loaderPinwheel: LoaderPinwheel,
+	toolCase: ToolCase,
+	partyPopper: PartyPopper,
+	pencilRuler: PencilRuler,
+	circleStar: CircleStar,
+	brain: Brain,
+	badgeDollarSign: BadgeDollarSign,
+	earth: Earth,
+	music4: Music4
+};
+//#endregion
+export { PROVIDER_CATEGORIES as A, BillingUnavailableError as B, DEPENDENCY_PRIORITIES as C, LOBE_ICON_MAP as D, ADAPTER_KIND_VALUES as E, VIRTUALIZE_THRESHOLD as F, generateAssemblyFiles as G, WebhookSignatureError as H, getServerSeam as I, resolvePluginOrder as J, parseProfileImports as K, registerPrismaSeam as L, PROVIDER_BADGE_STYLES as M, DND_STICKY_THRESHOLD as N, MODEL_CAPABILITY_OPTIONS as O, LOAD_MORE_STEP as P, registerServerSeam as R, DEPENDENCY_CATEGORIES as S, ADAPTER_KINDS as T, dumpModules as U, SeatsExceededError as V, generateAssemblyCode as W, definePlugin as X, defineProfile as Y, formatParsedUA as _, isInDndWindow as a, resolveIpLocation as b, NOTIFICATION_FREQUENCIES as c, isResourceDefined as d, PlanFeaturesSchema as f, isOssFeature as g, OSS_BASE_FEATURES as h, DEFAULT_CATEGORIES as i, PROVIDER_CATEGORY_VALUES as j, MODEL_TABS as k, RESOURCE_KEYS as l, FeatureRegistry as m, DEVICE_SIZES as n, normalizeCategoryFrequencies as o, FEATURE_KEYS as p, resolveImportSpecifiers as q, moduleRegistry as r, NOTIFICATION_CATEGORIES as s, ICON_MAP as t, ResourceRegistry as u, parseUserAgent as v, SEED_AI_PROVIDERS as w, DEFAULT_WATCHED_DEPENDENCIES as x, getClientIp as y, HostedAiError as z };