@huyooo/ai-chat-core 0.2.45 → 0.3.2

package/src/governance/types.ts

@@ -0,0 +1,44 @@
+/**
+ * 治理域类型定义
+ *
+ * - 统一描述本地/市场/系统资产的来源、作用域、运行时形态
+ * - 为工具、Part、Skill、MCP 提供共享的管理与审批元模型
+ */
+
+export type AssetKind = 'tool' | 'part' | 'skill' | 'mcp-server';
+
+/** 资产分发来源（所有资产类型统一） */
+export type AssetSource = 'system' | 'bundled' | 'market' | 'user';
+
+export type AssetScope = 'core' | 'local' | 'external';
+
+export type AssetRuntime = 'in-process' | 'part-render' | 'prompt-injection' | 'mcp-provider';
+
+export type AssetSideEffectLevel = 'read' | 'write' | 'destructive';
+
+export type AssetApprovalPolicy = 'auto' | 'manual' | 'destructive-only';
+
+export type AssetExecutionIsolation =
+  | 'in-process'
+  | 'subprocess'
+  | 'mcp'
+  | 'part-render'
+  | 'prompt-injection';
+
+export type AssetHostDependency = 'none' | 'local-app' | 'os-service' | 'remote-service';
+
+export interface AssetGovernance {
+  sideEffectLevel: AssetSideEffectLevel;
+  approvalPolicy: AssetApprovalPolicy;
+  executionIsolation: AssetExecutionIsolation;
+  hostDependency: AssetHostDependency;
+}
+
+export type AssetGovernanceOverrides = Partial<Omit<AssetGovernance, 'executionIsolation'>>;
+
+export interface ManagedAssetSummaryBase {
+  kind: AssetKind;
+  scope: AssetScope;
+  runtime: AssetRuntime;
+  governance?: AssetGovernance;
+}

package/src/index.ts

@@ -1,35 +1,35 @@
 /**
  * @huyooo/ai-chat-core
- * 
- * AI Chat 核心包 - 纯 Agent 逻辑，无框架依赖
- * 
- * 新架构（Protocol + Family 分离）：
- * - Model Registry: 模型注册表，管理所有模型配置
- * - Protocol Layer: 只负责 HTTP/SSE 通信
- * - Family Config: 统一管理模型行为差异
- * - UnifiedAdapter: 组合 Protocol + Family
- * - ChatOrchestrator: 统一处理工具调用循环
- * 
- * 设计优势：
- * 1. Protocol 只负责 HTTP/SSE 通信
- * 2. FamilyConfig 统一管理行为差异
- * 3. 新增模型只需在 Registry 配置，无需修改代码
- * 
- * 支持模型：
- * - ARK (豆包/DeepSeek) - 火山引擎
- * - Qwen (通义千问) - DashScope
- * - Gemini - Google AI
- * - OpenRouter - Claude/GPT 等
+ *
+ * AI Chat 核心包 — 环境无关，浏览器安全
+ *
+ * 分层架构：
+ * ┌─────────────────────────────────────────────────┐
+ * │  families/      模型行为差异（thinking/工具格式） │
+ * │  protocols/     HTTP/SSE 通信 + 协议标识          │
+ * ├─────────────────────────────────────────────────┤
+ * │  adapter/       协议路由 + 模型列表构建           │
+ * │  orchestrator/  工具调用循环 + 上下文压缩 + 类型   │
+ * ├─────────────────────────────────────────────────┤
+ * │  tool-manager/  统一工具管理（Provider + Manager） │
+ * │  skills/        技能注册表 + 管理 API             │
+ * │  parts/         UI 组件注册表 + 管理 API          │
+ * ├─────────────────────────────────────────────────┤
+ * │  governance/    资产治理策略（审批/副作用/命令安全）│
+ * │  extension/     扩展元数据类型 + 构建常量          │
+ * └─────────────────────────────────────────────────┘
+ *
+ * Node.js 宿主能力（文件操作 / 工具执行器 / LLM 配置加载）
+ * 均在 @huyooo/ai-chat-host-node 中提供。
  */
 
 // ==================== Agent ====================
 
-export { HybridAgent, type RuntimeConfig } from './agent';
+export { ChatRuntime, type RuntimeConfig } from './chat-runtime';
 
-// ==================== 模型注册表 ====================
+// ==================== Family 层 ====================
 
 export {
-  // 家族配置
   MODEL_FAMILIES,
   DOUBAO_FAMILY,
   DEEPSEEK_FAMILY,
@@ -37,39 +37,54 @@ export {
   GEMINI_FAMILY,
   GPT_FAMILY,
   CLAUDE_FAMILY,
-  
-  // 模型注册表
-  MODEL_REGISTRY,
-  
-  // 查询函数
-  getModelEntry,
-  getModelFamily,
-  getModelProtocol,
-  getVisibleModels,
-  getModelsByFamily,
-  getModelsByProtocol,
-  modelSupportsThinking,
-  modelSupportsNativeSearch,
-  getModelSearchStrategy,
-} from './providers/model-registry';
+  resolveModelFamilyConfig,
+} from './families';
 
 export type {
   ModelFamilyId,
-  ProtocolId,
   ThinkingFormat,
-  SearchStrategy,
   ToolCallFormat,
   ModelFamilyConfig,
-  ModelRegistryEntry,
-} from './providers/model-registry';
+} from './families';
 
-// ==================== 新架构：UnifiedAdapter + Protocol ====================
+// ==================== 协议标识 ====================
 
-// UnifiedAdapter - 统一适配器
-export { UnifiedAdapter, createUnifiedAdapter } from './providers/unified-adapter';
-export type { UnifiedAdapterConfig, StreamOptions } from './providers/unified-adapter';
+export type { ProtocolId } from './protocols';
+export { getBaseProtocol } from './protocols';
+
+
+// ==================== Adapter ====================
+
+export { ModelAdapter } from './adapter';
+export {
+  buildModelOptions,
+  getModelContextConfigFromLLM,
+  formatContextWindow,
+  formatPricing,
+} from './adapter';
+
+export type {
+  ModelOption,
+  ModelContextConfig,
+} from './adapter';
+
+export type {
+  ProviderAdapter,
+  AdapterConfig,
+  StreamOnceOptions,
+} from './adapter';
+
+export type {
+  OrchestratorConfig,
+  OrchestratorContext,
+  OrchestratorOptions,
+  OrchestratorToolExecutor,
+  ToolExecutionHooks,
+  GetAutoRunConfigCallback,
+} from './orchestrator';
+
+// ==================== Protocol Layer ====================
 
-// Protocol Layer
 export {
   ArkProtocol,
   createArkProtocol,
@@ -77,47 +92,27 @@ export {
   createDeepSeekProtocol,
   QwenProtocol,
   createQwenProtocol,
-  GeminiProtocol,
-  createGeminiProtocol,
-  OpenAIProtocol,
-  createOpenAIProtocol,
+  createVercelGatewayProtocol,
   AnthropicProtocol,
   createAnthropicProtocol,
-} from './providers/protocols';
+} from './protocols';
 
 export type {
   Protocol,
   ProtocolConfig,
+  ProtocolAttachment,
   ProtocolMessage,
   ProtocolToolDefinition,
-  ProtocolToolCall,
   RawEvent,
   RawEventType,
+  RawOutputPart,
   RawToolCall,
-  RawSearchResult,
-} from './providers/protocols';
-
-// Orchestrator - 统一的工具调用处理
-export { ChatOrchestrator, createOrchestrator } from './providers/orchestrator';
+  RawTokenUsage,
+} from './protocols';
 
-// 新架构类型
-export type {
-  StreamChunk,
-  StreamChunkType,
-  ToolCallRequest,
-  SearchResultItem,
-  StandardMessage,
-  ProviderAdapter,
-  AdapterConfig,
-  StreamOnceOptions,
-  OrchestratorConfig,
-  OrchestratorContext,
-  OrchestratorOptions,
-  SimpleToolDefinition,
-  ToolExecutor as OrchestratorToolExecutor,
-} from './providers/types';
+// ==================== Orchestrator ====================
 
-// Legacy Adapters 已删除，使用 UnifiedAdapter + Protocol 新架构
+export { ChatOrchestrator, createOrchestrator } from './orchestrator';
 
 // ==================== 配置与类型 ====================
 
@@ -132,38 +127,43 @@ export type {
   ToolDefinition,
   ChatMessage,
   ResponsesApiTool,
-  // 模型类型
-  ModelOption,
-  ProviderType,
-  // 工具接口
   Tool,
   ToolContext,
+  DataEngineContext,
   ToolUI,
   RenderType,
   ActionType,
   ExecResult,
+  ExecOptions,
+  ToolResult,
+  ToolSuccess,
+  ToolExecuteResult,
   ToolError,
   ToolErrorCode,
-  // 工具插件（Vite 风格）
+  ToolErrorCategory,
   ToolPlugin,
   ToolConfigItem,
-  // 用户工具（透传模式）
+  ToolExecutionAuditHooks,
   UserToolDefinition,
+  JsonSchemaObject,
 } from './types';
 
 export { 
-  // 模型列表
-  MODELS,
-  getModelByModelId,
-  // 工具解析和辅助函数
   resolveTools,
   tool,
   tools,
-  // 工具错误
+  ToolException,
+  normalizeToolResult,
+  serializeToolResult,
+  isToolResult,
+  toolOk,
+  createResolvedOutputSchema,
+  STANDARD_TOOL_ERROR_SCHEMA,
+  resolveToolResultUi,
+  mergeToolGovernance,
+  resolveToolGovernanceSnapshot,
   throwToolError,
-  rethrowToolError,
   isToolError,
-  getArg,
 } from './types';
 
 // 常量
@@ -171,21 +171,16 @@ export { DEFAULT_MODEL } from './constants';
 
 // ==================== 事件系统 ====================
 
-// 基础类型
 export type {
-  SearchResult,
   ToolCallStatus,
   ToolCallInfo,
   TokenUsage,
   ErrorCategory,
   ErrorDetails,
-  ToolErrorShape,
-  ToolUIShape,
+  FinishReason,
+  ToolFailureReason,
 } from './events';
 
-export { isThrowableToolError } from './events';
-
-// 思考事件
 export type {
   ThinkingStartEvent,
   ThinkingDeltaEvent,
@@ -193,15 +188,6 @@ export type {
   ThinkingEvent
 } from './events';
 
-// 搜索事件
-export type {
-  SearchStartEvent,
-  SearchResultEvent,
-  SearchEndEvent,
-  SearchEvent
-} from './events';
-
-// 工具事件
 export type {
   ToolCallStartEvent,
   ToolCallResultEvent,
@@ -211,19 +197,22 @@ export type {
   ToolEvent
 } from './events';
 
-// 文本事件
 export type {
+  TextStartEvent,
   TextDeltaEvent,
+  TextEndEvent,
   TextEvent
 } from './events';
 
-// 计划类型（update_plan 工具通过 ui: { type: 'render', name: 'plan' } 渲染，无专用事件）
+export type {
+  DataEvent,
+} from './events';
+
 export type {
   PlanStep,
   PlanStepStatus,
 } from './events';
 
-// 状态事件
 export type {
   DoneEvent,
   ErrorEvent,
@@ -231,34 +220,30 @@ export type {
   StatusEvent
 } from './events';
 
-// 步骤事件
 export type {
   StepStartEvent,
   StepEndEvent,
   StepEvent
 } from './events';
 
-// 聚合类型
 export type {
   ChatEvent,
-  ChatEventType
+  ChatEventType,
+  AssistantSegmentReason,
+  AssistantSegmentStartEvent,
+  AssistantSegmentEvent,
 } from './events';
 
-// 事件创建函数
 export {
   createThinkingStart,
   createThinkingDelta,
   createThinkingEnd,
-  createSearchStart,
-  createSearchResult,
-  createSearchEnd,
   createToolCallStart,
   createToolCallResult,
   createToolCallOutput,
   createToolCallRequest,
   createTextDelta,
   createDone,
-  // 错误创建函数
   createError,
   createApiError,
   createRateLimitError,
@@ -266,56 +251,176 @@ export {
   createTimeoutError,
   createParseError,
   createAbort,
-  // 步骤事件
   createStepStart,
   createStepEnd,
-  // 类型守卫
+  createAssistantSegmentStart,
   isThinkingEvent,
-  isSearchEvent,
   isToolEvent,
   isTextEvent,
   isStatusEvent,
   isErrorEvent,
   isAbortEvent,
   isStepEvent,
+  isAssistantSegmentEvent,
   isRetryableError,
   CHAT_EVENT_TYPES
 } from './events';
 
-// ==================== 工具执行器 ====================
+// ==================== 统一工具管理 ====================
 
-export { createDefaultToolExecutor } from './tools';
+export { Type } from '@sinclair/typebox';
+export type { Static, TSchema, TObject } from '@sinclair/typebox';
 
-// ==================== 工具已迁移 ====================
-//
-// 计划工具（update_plan）请使用:
-//   import { createUpdatePlanTool } from '@huyooo/ai-chat-tools-local';
-//
-// 云端工具（weather, web-search）请使用:
-//   import { getWeatherTool, createWebSearchTool } from '@huyooo/ai-chat-tools-cloud';
-// 
-// 本地工具（execute-command, ui-actions 等）请使用:
-//   import { getCwdTool, executeCommandTool, ... } from '@huyooo/ai-chat-tools-local';
-//
+export {
+  createToolRuntimeManager,
+  createInProcessProvider,
+  createMcpProvider,
+  createManagedToolSummary,
+  createManagedToolDetail,
+  createManagedMcpServerSummary,
+  createManagedMcpServerDetail,
+  defineTool,
+  TOOL_FORMATS,
+  validateJsonSchemaArgs,
+  validateTypeBoxArgs,
+  registerToolFormats,
+  registerToolFormat,
+  hasToolFormat,
+} from './tool-manager';
 
-// ==================== 路由 ====================
+export type {
+  ToolDescriptor,
+  ToolChangeEvent,
+  ToolChangeListener,
+  SessionToolsChangeEvent,
+  SessionToolsChangeListener,
+  ToolProvider,
+  InProcessProvider,
+  McpProviderExtended,
+  McpServerConfig,
+  McpConnectionStatus,
+  McpConnectionInfo,
+  ManagedToolSummary,
+  ManagedToolDetail,
+  ManagedMcpServerSummary,
+  ManagedMcpServerDetail,
+  ToolSearchQuery,
+  CategorySummary,
+  ProviderInfo,
+  ToolRuntimeManager,
+  TypeBoxToolConfig,
+  ToolFormat,
+} from './tool-manager';
+
+
+// ==================== 技能 ====================
+
+export { skillRegistry } from './skills';
+export type { SkillRegistry } from './skills';
+export type {
+  SkillMeta,
+  SkillSearchQuery,
+  ManagedSkillSummary,
+  ManagedSkillDetail,
+} from './skills';
+
+export { skillManagementPlugin } from './skills';
+export { createManagedSkillSummary, createManagedSkillDetail } from './skills';
+export type {
+  SkillManagementOptions,
+  OnSkillCreate,
+  OnSkillUpdate,
+  OnSkillDelete,
+  OnSkillSetEnabled,
+  OnSkillLoadContent,
+  OnSkillLoadReference,
+} from './skills';
 
-export type { RouteResult } from './router';
+// ==================== LLM 配置（Model 中心）====================
 
 export {
-  routeModelToProvider,
-  routeModelWithDetails,
-  getDefaultProvider,
-  isModelForProvider
-} from './router';
+  getRouteChain,
+  resolveRouteUrl,
+  findRouteByProtocol,
+} from './llm-config';
+export type {
+  LLMConfig,
+  ModelRoute,
+  ModelConfig,
+  ModelPricing,
+  CompressionConfig,
+} from './llm-config';
 
-// ==================== MCP ====================
-// McpClientManager 只在内部使用（agent.ts 直接 import），不从主入口导出
-// 避免在 renderer 中因 barrel file 加载整个模块图而引入 Node.js-only 的 MCP SDK
-// 如需外部使用，请通过 @huyooo/ai-chat-core/mcp 子路径导入
+// ==================== UI 组件 ====================
 
-export type { McpServerConfig, McpConnectionStatus, McpConnectionInfo } from './mcp';
+export { partRegistry } from './parts';
+export type {
+  PartMeta,
+  PartSearchQuery,
+  PartRegistry,
+  ManagedPartSummary,
+  ManagedPartDetail,
+} from './parts';
+
+export { createManagedPartSummary, createManagedPartDetail } from './parts';
+
+// ==================== 治理策略 ====================
+
+export {
+  analyzeCommandRisk,
+  createAssetSummaryBase,
+  createCommandGovernanceSnapshot,
+  createCommandToolMetadata,
+  createLocalMcpServerGovernance,
+  createLocalToolGovernance,
+  createPartAssetGovernance,
+  readAssetGovernanceOverrides,
+  toAssetGovernanceOverrides,
+} from './governance';
+export type {
+  AssetApprovalPolicy,
+  AssetExecutionIsolation,
+  AssetGovernance,
+  AssetGovernanceOverrides,
+  AssetHostDependency,
+  AssetKind,
+  AssetRuntime,
+  AssetScope,
+  AssetSideEffectLevel,
+  AssetSource,
+  CommandRiskAssessment,
+  CommandRiskTag,
+  CommandSafetyPolicy,
+  CommandToolMetadata,
+  ManagedAssetSummaryBase,
+} from './governance';
+
+// ==================== 扩展元数据 ====================
+
+export type {
+  AssetType,
+  AssetMeta,
+  AssetToolMeta,
+} from './extension';
+
+// ==================== 管理工具辅助（参数解析 / 结果格式化） ====================
+
+export {
+  getRequiredString,
+  getOptionalString,
+  getBooleanWithDefault,
+  getStringArray,
+  getStringRecord,
+  splitCommaSeparatedStrings,
+} from './internal/management-args';
+export {
+  createCollectionResult,
+  createInspectResult,
+  createActionResult,
+  createToggleResult,
+} from './internal/management-results';
 
-// ==================== 调试工具 ====================
+// ==================== 日志 ====================
 
-export { DebugLogger } from './utils';
+export { initLogger, getLogger, createModuleLogger } from './logger';
+export type { LogLevel, LoggerConfig } from './logger';

package/src/internal/management-args.ts

@@ -0,0 +1,39 @@
+/**
+ * 管理工具参数解析辅助（未知 → 强类型）
+ *
+ * - 供 skill/tool/mcp 管理插件从 args 提取 string、boolean、数组
+ * - 避免各处重复 typeof 判空逻辑
+ */
+
+export function getRequiredString(value: unknown): string {
+  return typeof value === 'string' ? value : '';
+}
+
+export function getOptionalString(value: unknown): string | undefined {
+  return typeof value === 'string' ? value : undefined;
+}
+
+export function getBooleanWithDefault(value: unknown, fallback: boolean): boolean {
+  return typeof value === 'boolean' ? value : fallback;
+}
+
+export function getStringArray(value: unknown): string[] | undefined {
+  if (!Array.isArray(value)) return undefined;
+  return value.filter((item): item is string => typeof item === 'string');
+}
+
+export function getStringRecord(value: unknown): Record<string, string> | undefined {
+  if (!value || typeof value !== 'object' || Array.isArray(value)) return undefined;
+
+  const entries = Object.entries(value).filter(
+    (entry): entry is [string, string] => typeof entry[0] === 'string' && typeof entry[1] === 'string',
+  );
+
+  return Object.fromEntries(entries);
+}
+
+export function splitCommaSeparatedStrings(value: unknown): string[] | undefined {
+  const raw = getOptionalString(value);
+  if (!raw) return undefined;
+  return raw.split(',').map(item => item.trim()).filter(Boolean);
+}

package/src/internal/management-results.ts

@@ -0,0 +1,60 @@
+/**
+ * 管理 API 统一返回结构构造器
+ *
+ * - list 类结果：`count` + 命名数组字段 + 可选 extra
+ * - 与各 management 插件的 JSON 形状保持一致
+ */
+
+type ResultExtra = Record<string, unknown>;
+
+export function createCollectionResult<TKey extends string, TItem>(
+  key: TKey,
+  items: TItem[],
+  extra: ResultExtra = {},
+): Record<TKey | 'count', unknown> & ResultExtra {
+  return {
+    count: items.length,
+    [key]: items,
+    ...extra,
+  } as Record<TKey | 'count', unknown> & ResultExtra;
+}
+
+export function createInspectResult<TKey extends string, TItem>(
+  key: TKey,
+  item: TItem,
+  extra: ResultExtra = {},
+): Record<TKey, unknown> & ResultExtra {
+  return {
+    [key]: item,
+    ...extra,
+  } as Record<TKey, unknown> & ResultExtra;
+}
+
+export function createActionResult<TAction extends string, TKey extends string, TItem>(
+  action: TAction,
+  key: TKey,
+  item: TItem,
+  extra: ResultExtra = {},
+): Record<'action' | TKey, unknown> & ResultExtra {
+  return {
+    action,
+    [key]: item,
+    ...extra,
+  } as Record<'action' | TKey, unknown> & ResultExtra;
+}
+
+export function createToggleResult<TResult extends { enabled: boolean; error?: string }>(
+  results: TResult[],
+  extra: ResultExtra = {},
+) {
+  const enabledCount = results.filter(item => item.enabled && !item.error).length;
+  const disabledCount = results.filter(item => !item.enabled && !item.error).length;
+
+  return {
+    action: 'enabled',
+    results,
+    enabledCount,
+    disabledCount,
+    ...extra,
+  };
+}