@allbluecn/shared 0.3.13 → 0.4.0

package/dist/i18n/config.js

@@ -0,0 +1,2 @@
+import { a as resources, i as namespaces, n as fallbackLng, o as supportedLngs, r as isSupportedLocale, t as defaultNs } from "../config-CcbSbJoC.js";
+export { defaultNs, fallbackLng, isSupportedLocale, namespaces, resources, supportedLngs };

package/dist/i18n/detect.d.ts

@@ -0,0 +1,5 @@
+import { AppLocale } from "./config.js";
+//#region src/i18n/detect.d.ts
+declare function detectLocale(request: Request, userLocale: string | null): AppLocale;
+//#endregion
+export { detectLocale };

package/dist/i18n/detect.js

@@ -0,0 +1,35 @@
+import { r as isSupportedLocale } from "../config-CcbSbJoC.js";
+//#region src/i18n/detect.ts
+function detectLocale(request, userLocale) {
+	const queryLng = new URL(request.url).searchParams.get("lng");
+	if (queryLng && isSupportedLocale(queryLng)) return queryLng;
+	const cookieLng = parseCookieValue(request.headers.get("cookie") ?? "", "lng");
+	if (cookieLng && isSupportedLocale(cookieLng)) return cookieLng;
+	if (userLocale && isSupportedLocale(userLocale)) return userLocale;
+	const acceptLang = request.headers.get("accept-language");
+	if (acceptLang) {
+		const detected = matchBestLanguage(acceptLang);
+		if (detected) return detected;
+	}
+	return "zh";
+}
+function parseCookieValue(cookieHeader, key) {
+	const match = cookieHeader.match(new RegExp(`(?:^|;\\s*)${key}=([^;]+)`));
+	return match ? match[1] : null;
+}
+function matchBestLanguage(acceptLang) {
+	const entries = acceptLang.split(",").map((part) => {
+		const [lang, qPart] = part.trim().split(";q=");
+		return {
+			lang: lang.trim(),
+			q: qPart ? parseFloat(qPart) : 1
+		};
+	}).sort((a, b) => b.q - a.q);
+	for (const entry of entries) {
+		const base = entry.lang.split("-")[0].toLowerCase();
+		if (isSupportedLocale(base)) return base;
+	}
+	return null;
+}
+//#endregion
+export { detectLocale };

package/dist/i18n/server.d.ts

@@ -0,0 +1,6 @@
+import { AppLocale } from "./config.js";
+import { i18n } from "i18next";
+//#region src/i18n/server.d.ts
+declare function createServerI18n(locale: AppLocale): i18n;
+//#endregion
+export { createServerI18n };

package/dist/i18n/server.js

@@ -0,0 +1,19 @@
+import { a as resources, t as defaultNs } from "../config-CcbSbJoC.js";
+import i18next from "i18next";
+import { initReactI18next } from "react-i18next";
+//#region src/i18n/server.ts
+function createServerI18n(locale) {
+	const i18n = i18next.createInstance();
+	i18n.use(initReactI18next);
+	i18n.init({
+		lng: locale,
+		fallbackLng: "zh",
+		defaultNS: defaultNs,
+		resources,
+		interpolation: { escapeValue: false },
+		react: { useSuspense: false }
+	});
+	return i18n;
+}
+//#endregion
+export { createServerI18n };

package/dist/i18n/types.d.ts

@@ -0,0 +1,3 @@
+import { AppLocale, NamespaceKey } from "./config.js";
+import { i18n as I18nInstance } from "i18next";
+export type { AppLocale, I18nInstance, NamespaceKey };

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+import { DND_STICKY_THRESHOLD, LOAD_MORE_STEP, VIRTUALIZE_THRESHOLD } from "./constants/perf.js";
+import { AICommandContext, AICommandDef, AICommandHandler, AICommandResult, AllBlueModule, EntityDef, ReferenceDisplayFn } from "./interfaces/module.js";
+import { moduleRegistry } from "./modules/registry.js";
+import { registerDefaultModules } from "./modules/register-defaults.js";
+import { a as ModelCapability, i as AiProviderRow, n as AiModelMeta, o as PROVIDER_BADGE_STYLES, r as AiProviderMeta, s as ProviderCategory, t as AdapterKind } from "./types-dopOMFRC.js";
+import { a as MODEL_TABS, c as PROVIDER_CATEGORY_VALUES, i as MODEL_CAPABILITY_OPTIONS, n as ADAPTER_KIND_VALUES, o as ModelTab, r as LOBE_ICON_MAP, s as PROVIDER_CATEGORIES, t as ADAPTER_KINDS } from "./constants-C3hGP_ru.js";
+import { t as SEED_AI_PROVIDERS } from "./seed-data-BK0cl93n.js";
+import { DEFAULT_WATCHED_DEPENDENCIES, DEPENDENCY_CATEGORIES, DEPENDENCY_PRIORITIES, DependencyCategory, DependencyPriority, DependencySeed, DependencyUsage, SyncDependencyResult, ThirdPartyDependencyRow, UpdateDependencyInput, VersionStatus } from "./modules/dependencies/index.js";
+import { getClientIp, resolveIpLocation } from "./infrastructure/ip-location.js";
+import { ParsedUA, formatParsedUA, parseUserAgent } from "./infrastructure/ua-parser.js";
+import { RefDisplay, Reference, ResolvedRef, SearchResult } from "./interfaces/references.js";
+import { AiAdapter, CLIAgentInfo } from "./interfaces/ai.js";
+import { EntityUpdateEvent, RealtimeTransport } from "./interfaces/transport.js";
+import { FEATURE_KEYS, FeatureKey, FeatureMeta, FeatureRegistry, OSS_BASE_FEATURES, isOssFeature } from "./modules/billing/feature-registry.js";
+import { PlanFeatures, PlanFeaturesSchema } from "./modules/billing/plan-features-schema.js";
+import { RESOURCE_KEYS, ResourceKey, ResourceMeta, ResourceRegistry, ResourceSnapshot, ResourceSnapshots, isResourceDefined } from "./modules/billing/resource-registry.js";
+import { AvatarConfig, AvatarPart, ShapeType } from "./interfaces/avatar.js";
+export { ADAPTER_KINDS, ADAPTER_KIND_VALUES, type AICommandContext, type AICommandDef, type AICommandHandler, type AICommandResult, AdapterKind, type AiAdapter, AiModelMeta, AiProviderMeta, AiProviderRow, type AllBlueModule, type AvatarConfig, type AvatarPart, type CLIAgentInfo, DEFAULT_WATCHED_DEPENDENCIES, DEPENDENCY_CATEGORIES, DEPENDENCY_PRIORITIES, DND_STICKY_THRESHOLD, DependencyCategory, DependencyPriority, DependencySeed, DependencyUsage, type EntityDef, type EntityUpdateEvent, FEATURE_KEYS, type FeatureKey, type FeatureMeta, FeatureRegistry, LOAD_MORE_STEP, LOBE_ICON_MAP, MODEL_CAPABILITY_OPTIONS, MODEL_TABS, ModelCapability, ModelTab, OSS_BASE_FEATURES, PROVIDER_BADGE_STYLES, PROVIDER_CATEGORIES, PROVIDER_CATEGORY_VALUES, type ParsedUA, type PlanFeatures, PlanFeaturesSchema, ProviderCategory, RESOURCE_KEYS, type RealtimeTransport, type RefDisplay, type Reference, type ReferenceDisplayFn, type ResolvedRef, type ResourceKey, type ResourceMeta, ResourceRegistry, type ResourceSnapshot, type ResourceSnapshots, SEED_AI_PROVIDERS, type SearchResult, type ShapeType, SyncDependencyResult, ThirdPartyDependencyRow, UpdateDependencyInput, VIRTUALIZE_THRESHOLD, VersionStatus, formatParsedUA, getClientIp, isOssFeature, isResourceDefined, moduleRegistry, parseUserAgent, registerDefaultModules, resolveIpLocation };

package/dist/index.js

@@ -0,0 +1,14 @@
+import { moduleRegistry } from "./modules/registry.js";
+import { registerDefaultModules } from "./modules/register-defaults.js";
+import { DND_STICKY_THRESHOLD, LOAD_MORE_STEP, VIRTUALIZE_THRESHOLD } from "./constants/perf.js";
+import { PROVIDER_BADGE_STYLES } from "./modules/ai-providers/types.js";
+import { ADAPTER_KINDS, ADAPTER_KIND_VALUES, LOBE_ICON_MAP, MODEL_CAPABILITY_OPTIONS, MODEL_TABS, PROVIDER_CATEGORIES, PROVIDER_CATEGORY_VALUES } from "./modules/ai-providers/constants.js";
+import { SEED_AI_PROVIDERS } from "./modules/ai-providers/seed-data.js";
+import "./modules/ai-providers/index.js";
+import { DEFAULT_WATCHED_DEPENDENCIES, DEPENDENCY_CATEGORIES, DEPENDENCY_PRIORITIES } from "./modules/dependencies/index.js";
+import { getClientIp, resolveIpLocation } from "./infrastructure/ip-location.js";
+import { formatParsedUA, parseUserAgent } from "./infrastructure/ua-parser.js";
+import { FEATURE_KEYS, FeatureRegistry, OSS_BASE_FEATURES, isOssFeature } from "./modules/billing/feature-registry.js";
+import { PlanFeaturesSchema } from "./modules/billing/plan-features-schema.js";
+import { RESOURCE_KEYS, ResourceRegistry, isResourceDefined } from "./modules/billing/resource-registry.js";
+export { ADAPTER_KINDS, ADAPTER_KIND_VALUES, DEFAULT_WATCHED_DEPENDENCIES, DEPENDENCY_CATEGORIES, DEPENDENCY_PRIORITIES, DND_STICKY_THRESHOLD, FEATURE_KEYS, FeatureRegistry, LOAD_MORE_STEP, LOBE_ICON_MAP, MODEL_CAPABILITY_OPTIONS, MODEL_TABS, OSS_BASE_FEATURES, PROVIDER_BADGE_STYLES, PROVIDER_CATEGORIES, PROVIDER_CATEGORY_VALUES, PlanFeaturesSchema, RESOURCE_KEYS, ResourceRegistry, SEED_AI_PROVIDERS, VIRTUALIZE_THRESHOLD, formatParsedUA, getClientIp, isOssFeature, isResourceDefined, moduleRegistry, parseUserAgent, registerDefaultModules, resolveIpLocation };

package/dist/infrastructure/ai/adapter.d.ts

@@ -0,0 +1,8 @@
+import { AICommandContext } from "../../interfaces/module.js";
+import { CLIAgentInfo } from "../../interfaces/ai.js";
+//#region src/infrastructure/ai/adapter.d.ts
+declare function getActiveAgent(): string | null;
+declare function switchAgent(agentId: string): void;
+declare function executeViaAgent(agent: CLIAgentInfo, prompt: string, _ctx: AICommandContext): Promise<string>;
+//#endregion
+export { executeViaAgent, getActiveAgent, switchAgent };

package/dist/infrastructure/ai/adapter.js

@@ -0,0 +1,32 @@
+//#region src/infrastructure/ai/adapter.ts
+let activeAgentId = null;
+function getActiveAgent() {
+	return activeAgentId;
+}
+function switchAgent(agentId) {
+	activeAgentId = agentId;
+}
+async function executeViaAgent(agent, prompt, _ctx) {
+	if (agent.id === "openai-api") return (await (await fetch(`${process.env.AI_BASE_URL || "https://api.openai.com/v1"}/chat/completions`, {
+		method: "POST",
+		headers: {
+			"Content-Type": "application/json",
+			Authorization: `Bearer ${process.env.OPENAI_API_KEY}`
+		},
+		body: JSON.stringify({
+			model: process.env.AI_MODEL || "gpt-4o-mini",
+			messages: [{
+				role: "user",
+				content: prompt
+			}],
+			temperature: .7
+		})
+	})).json()).choices[0]?.message?.content || "";
+	const { execSync } = await import("child_process");
+	return execSync(`${agent.binary} -p "${prompt.replace(/"/g, "\\\"")}"`, {
+		timeout: 6e4,
+		encoding: "utf-8"
+	}).trim();
+}
+//#endregion
+export { executeViaAgent, getActiveAgent, switchAgent };

package/dist/infrastructure/ai/cli-detector.d.ts

@@ -0,0 +1,6 @@
+import { CLIAgentInfo } from "../../interfaces/ai.js";
+//#region src/infrastructure/ai/cli-detector.d.ts
+declare function detectAgents(): Promise<CLIAgentInfo[]>;
+declare function getApiAgent(): CLIAgentInfo | undefined;
+//#endregion
+export { detectAgents, getApiAgent };

package/dist/infrastructure/ai/cli-detector.js

@@ -0,0 +1,121 @@
+//#region src/infrastructure/ai/cli-detector.ts
+const KNOWN_AGENTS = [
+	{
+		id: "claude-code",
+		name: "Claude Code",
+		binary: "claude"
+	},
+	{
+		id: "claude-cli",
+		name: "Claude CLI",
+		binary: "claude"
+	},
+	{
+		id: "copilot-cli",
+		name: "GitHub Copilot CLI",
+		binary: "github-copilot-cli"
+	},
+	{
+		id: "ollama",
+		name: "Ollama",
+		binary: "ollama"
+	},
+	{
+		id: "llama-cpp",
+		name: "llama.cpp",
+		binary: "llama-cli"
+	},
+	{
+		id: "open-interpreter",
+		name: "Open Interpreter",
+		binary: "interpreter"
+	},
+	{
+		id: "aider",
+		name: "Aider",
+		binary: "aider"
+	},
+	{
+		id: "continue",
+		name: "Continue",
+		binary: "continue"
+	},
+	{
+		id: "codex-cli",
+		name: "Codex CLI",
+		binary: "codex"
+	},
+	{
+		id: "swe-agent",
+		name: "SWE-agent",
+		binary: "sweagent"
+	},
+	{
+		id: "openhands",
+		name: "OpenHands",
+		binary: "openhands"
+	},
+	{
+		id: "taskmaster",
+		name: "TaskMaster",
+		binary: "taskmaster"
+	},
+	{
+		id: "gpt-engineer",
+		name: "GPT Engineer",
+		binary: "gptengineer"
+	},
+	{
+		id: "mentat",
+		name: "Mentat",
+		binary: "mentat"
+	},
+	{
+		id: "sweep",
+		name: "Sweep",
+		binary: "sweep"
+	},
+	{
+		id: "mcp-cli",
+		name: "MCP CLI",
+		binary: "mcp"
+	}
+];
+async function detectAgents() {
+	const { execSync } = await import("child_process");
+	return KNOWN_AGENTS.map(({ id, name, binary }) => {
+		try {
+			return {
+				id,
+				name,
+				binary,
+				version: execSync(`${binary} --version 2>/dev/null || ${binary} version 2>/dev/null`, {
+					timeout: 3e3,
+					encoding: "utf-8"
+				}).trim().slice(0, 50),
+				available: true
+			};
+		} catch {
+			return {
+				id,
+				name,
+				binary,
+				version: "",
+				available: false
+			};
+		}
+	});
+}
+function getApiAgent() {
+	const key = process.env.OPENAI_API_KEY;
+	if (!key || key === "sk-your-api-key-here") return void 0;
+	return {
+		id: "openai-api",
+		name: `OpenAI (${process.env.AI_MODEL || "gpt-4o-mini"})`,
+		binary: "api",
+		version: "v1",
+		available: true
+	};
+}
+//#endregion
+export { detectAgents, getApiAgent };

package/dist/infrastructure/ip-location.d.ts

@@ -0,0 +1,9 @@
+//#region src/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
+export { getClientIp, resolveIpLocation };

package/dist/infrastructure/ip-location.js

@@ -0,0 +1,48 @@
+//#region src/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
+export { getClientIp, resolveIpLocation };

package/dist/infrastructure/references/engine.d.ts

@@ -0,0 +1,7 @@
+import { Reference, ResolvedRef, SearchResult } from "../../interfaces/references.js";
+//#region src/infrastructure/references/engine.d.ts
+declare function createReference(ref: Omit<Reference, "id">): Promise<Reference>;
+declare function resolveReferences(sourceModule: string, sourceEntityId: string): Promise<ResolvedRef[]>;
+declare function searchReferences(query: string, types?: string[]): Promise<SearchResult[]>;
+//#endregion
+export { createReference, resolveReferences, searchReferences };

package/dist/infrastructure/references/engine.js

@@ -0,0 +1,64 @@
+import { moduleRegistry } from "../../modules/registry.js";
+import { getPrismaSeam } from "../../server-seam.js";
+//#region src/infrastructure/references/engine.ts
+async function resolveDisplay(targetModule, targetEntityId, entityType) {
+	const mod = moduleRegistry.getModule(targetModule);
+	if (!mod) return { title: `[${targetModule}:${targetEntityId}]` };
+	const entity = entityType ? mod.entities.find((e) => e.type === entityType) : mod.entities[0];
+	if (!entity) return { title: `[${targetModule}:${targetEntityId}]` };
+	try {
+		const fields = [...entity.displayFields, "id"].join(", ");
+		const rows = await getPrismaSeam().$queryRawUnsafe(`SELECT ${fields} FROM \`${entity.table}\` WHERE id = ?`, targetEntityId);
+		if (!rows.length) return {
+			title: `Deleted ${entity.type}`,
+			status: "deleted"
+		};
+		return mod.referenceDisplay(entity.type, rows[0]);
+	} catch {
+		return { title: `[${targetEntityId}]` };
+	}
+}
+async function createReference(ref) {
+	return getPrismaSeam().reference.create({ data: ref });
+}
+async function resolveReferences(sourceModule, sourceEntityId) {
+	const refs = await getPrismaSeam().reference.findMany({ where: {
+		sourceModule,
+		sourceEntityId
+	} });
+	return Promise.all(refs.map(async (ref) => {
+		const display = await resolveDisplay(ref.targetModule, ref.targetEntityId);
+		return {
+			...ref,
+			display
+		};
+	}));
+}
+async function searchReferences(query, types) {
+	const searchConfigs = moduleRegistry.getSearchFields();
+	const filtered = types ? searchConfigs.filter((c) => types.includes(c.module) || types.includes(c.type)) : searchConfigs;
+	const results = [];
+	for (const config of filtered) {
+		const mod = moduleRegistry.getModule(config.module);
+		if (!mod) continue;
+		const searchField = config.fields[0];
+		const seam = getPrismaSeam();
+		try {
+			const rows = await seam.$queryRawUnsafe(`SELECT id, ${config.fields.join(", ")} FROM \`${mod.entities[0].table}\` WHERE \`${searchField}\` LIKE ? LIMIT 20`, `%${query}%`);
+			for (const row of rows) {
+				const display = mod.referenceDisplay(config.type, row);
+				results.push({
+					id: row.id,
+					module: config.module,
+					type: config.type,
+					title: display.title,
+					status: display.status,
+					url: display.url
+				});
+			}
+		} catch {}
+	}
+	return results;
+}
+//#endregion
+export { createReference, resolveReferences, searchReferences };

package/dist/infrastructure/ua-parser.d.ts

@@ -0,0 +1,20 @@
+//#region src/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
+export { ParsedUA, formatParsedUA, parseUserAgent };

package/dist/infrastructure/ua-parser.js

@@ -0,0 +1,69 @@
+//#region src/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
+export { formatParsedUA, parseUserAgent };

package/dist/interfaces/ai.d.ts

@@ -0,0 +1,27 @@
+//#region src/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
+export { AiAdapter, CLIAgentInfo };

package/dist/interfaces/avatar.d.ts

@@ -0,0 +1,6 @@
+//#region src/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
+export { AvatarConfig, AvatarPart, ShapeType };

package/dist/interfaces/module.d.ts

@@ -0,0 +1,45 @@
+//#region src/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
+export { AICommandContext, AICommandDef, AICommandHandler, AICommandResult, AllBlueModule, EntityDef, ReferenceDisplayFn };

package/dist/interfaces/references.d.ts

@@ -0,0 +1,27 @@
+//#region src/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
+export { RefDisplay, Reference, ResolvedRef, SearchResult };

package/dist/interfaces/transport.d.ts

@@ -0,0 +1,11 @@
+//#region src/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
+export { EntityUpdateEvent, RealtimeTransport };

package/dist/lib/annotation-template.d.ts

@@ -0,0 +1,9 @@
+import { Editor } from "@tiptap/react";
+//#region src/lib/annotation-template.d.ts
+/**
+ * 将 HTML 字符串转为 ProseMirror content 节点数组（用于 insertContent 的 content 字段）。
+ * 客户端调用（onAnnotate 事件触发），document 可用。
+ */
+declare function htmlToPmContent(editor: Editor, html: string): any[];
+//#endregion
+export { htmlToPmContent };