@huyooo/ai-chat-core 0.3.6 → 0.3.8

package/src/governance/types.ts

@@ -1,44 +0,0 @@
-/**
- * 治理域类型定义
- *
- * - 统一描述本地/市场/系统资产的来源、作用域、运行时形态
- * - 为工具、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,426 +0,0 @@
-/**
- * @huyooo/ai-chat-core
- *
- * 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 { ChatRuntime, type RuntimeConfig } from './chat-runtime';
-
-// ==================== Family 层 ====================
-
-export {
-  MODEL_FAMILIES,
-  DOUBAO_FAMILY,
-  DEEPSEEK_FAMILY,
-  QWEN_FAMILY,
-  GEMINI_FAMILY,
-  GPT_FAMILY,
-  CLAUDE_FAMILY,
-  resolveModelFamilyConfig,
-} from './families';
-
-export type {
-  ModelFamilyId,
-  ThinkingFormat,
-  ToolCallFormat,
-  ModelFamilyConfig,
-} from './families';
-
-// ==================== 协议标识 ====================
-
-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 ====================
-
-export {
-  ArkProtocol,
-  createArkProtocol,
-  DeepSeekProtocol,
-  createDeepSeekProtocol,
-  QwenProtocol,
-  createQwenProtocol,
-  createVercelGatewayProtocol,
-  AnthropicProtocol,
-  createAnthropicProtocol,
-} from './protocols';
-
-export type {
-  Protocol,
-  ProtocolConfig,
-  ProtocolAttachment,
-  ProtocolMessage,
-  ProtocolToolDefinition,
-  RawEvent,
-  RawEventType,
-  RawOutputPart,
-  RawToolCall,
-  RawTokenUsage,
-} from './protocols';
-
-// ==================== Orchestrator ====================
-
-export { ChatOrchestrator, createOrchestrator } from './orchestrator';
-
-// ==================== 配置与类型 ====================
-
-export type {
-  AgentConfig,
-  ChatOptions,
-  ChatMode,
-  ThinkingMode,
-  AutoRunMode,
-  AutoRunConfig,
-  ToolExecutor,
-  ToolDefinition,
-  ChatMessage,
-  ResponsesApiTool,
-  Tool,
-  ToolContext,
-  DataEngineContext,
-  ToolUI,
-  RenderType,
-  ActionType,
-  ExecResult,
-  ExecOptions,
-  ToolResult,
-  ToolSuccess,
-  ToolExecuteResult,
-  ToolError,
-  ToolErrorCode,
-  ToolErrorCategory,
-  ToolPlugin,
-  ToolConfigItem,
-  ToolExecutionAuditHooks,
-  UserToolDefinition,
-  JsonSchemaObject,
-} from './types';
-
-export { 
-  resolveTools,
-  tool,
-  tools,
-  ToolException,
-  normalizeToolResult,
-  serializeToolResult,
-  isToolResult,
-  toolOk,
-  createResolvedOutputSchema,
-  STANDARD_TOOL_ERROR_SCHEMA,
-  resolveToolResultUi,
-  mergeToolGovernance,
-  resolveToolGovernanceSnapshot,
-  throwToolError,
-  isToolError,
-} from './types';
-
-// 常量
-export { DEFAULT_MODEL } from './constants';
-
-// ==================== 事件系统 ====================
-
-export type {
-  ToolCallStatus,
-  ToolCallInfo,
-  TokenUsage,
-  ErrorCategory,
-  ErrorDetails,
-  FinishReason,
-  ToolFailureReason,
-} from './events';
-
-export type {
-  ThinkingStartEvent,
-  ThinkingDeltaEvent,
-  ThinkingEndEvent,
-  ThinkingEvent
-} from './events';
-
-export type {
-  ToolCallStartEvent,
-  ToolCallResultEvent,
-  ToolCallOutputEvent,
-  ToolApprovalRequestEvent,
-  ToolCallRequestEvent,
-  ToolEvent
-} from './events';
-
-export type {
-  TextStartEvent,
-  TextDeltaEvent,
-  TextEndEvent,
-  TextEvent
-} from './events';
-
-export type {
-  DataEvent,
-} from './events';
-
-export type {
-  PlanStep,
-  PlanStepStatus,
-} from './events';
-
-export type {
-  DoneEvent,
-  ErrorEvent,
-  AbortEvent,
-  StatusEvent
-} from './events';
-
-export type {
-  StepStartEvent,
-  StepEndEvent,
-  StepEvent
-} from './events';
-
-export type {
-  ChatEvent,
-  ChatEventType,
-  AssistantSegmentReason,
-  AssistantSegmentStartEvent,
-  AssistantSegmentEvent,
-} from './events';
-
-export {
-  createThinkingStart,
-  createThinkingDelta,
-  createThinkingEnd,
-  createToolCallStart,
-  createToolCallResult,
-  createToolCallOutput,
-  createToolCallRequest,
-  createTextDelta,
-  createDone,
-  createError,
-  createApiError,
-  createRateLimitError,
-  createToolError,
-  createTimeoutError,
-  createParseError,
-  createAbort,
-  createStepStart,
-  createStepEnd,
-  createAssistantSegmentStart,
-  isThinkingEvent,
-  isToolEvent,
-  isTextEvent,
-  isStatusEvent,
-  isErrorEvent,
-  isAbortEvent,
-  isStepEvent,
-  isAssistantSegmentEvent,
-  isRetryableError,
-  CHAT_EVENT_TYPES
-} from './events';
-
-// ==================== 统一工具管理 ====================
-
-export { Type } from '@sinclair/typebox';
-export type { Static, TSchema, TObject } from '@sinclair/typebox';
-
-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';
-
-// ==================== LLM 配置（Model 中心）====================
-
-export {
-  getRouteChain,
-  resolveRouteUrl,
-  findRouteByProtocol,
-} from './llm-config';
-export type {
-  LLMConfig,
-  ModelRoute,
-  ModelConfig,
-  ModelPricing,
-  CompressionConfig,
-} from './llm-config';
-
-// ==================== UI 组件 ====================
-
-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 { initLogger, getLogger, createModuleLogger } from './logger';
-export type { LogLevel, LoggerConfig } from './logger';

package/src/internal/management-args.ts

@@ -1,39 +0,0 @@
-/**
- * 管理工具参数解析辅助（未知 → 强类型）
- *
- * - 供 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

@@ -1,60 +0,0 @@
-/**
- * 管理 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,
-  };
-}

package/src/llm-config.ts

@@ -1,137 +0,0 @@
-/**
- * LLM 配置（Model 中心）
- *
- * LLMConfig.models 是模型的唯一真相源：
- * - key = 模型 ID（自定义字符串）
- * - value = ModelConfig（路由 + 元数据）
- * - 前端只展示这里配置的模型
- * - 每个模型必须显式指定 family，不做任何隐式推导
- */
-
-import type { ProtocolFactory, Protocol, ProtocolConfig } from './protocols';
-import type { ModelFamilyConfig, ModelFamilyId } from './families';
-
-/** 模型定价（每百万 tokens） */
-export interface ModelPricing {
-  currency: 'CNY' | 'USD';
-  /** 输入价格（每百万 tokens） */
-  input: number;
-  /** 输出价格，单值或 [最低, 最高] 区间（如思考/非思考差价） */
-  output: number | [number, number];
-  /** 缓存命中价格（每百万 tokens，部分模型支持） */
-  cached?: number;
-}
-
-/** 单条模型访问路径 */
-export interface ModelRoute {
-  /** 基础 URL */
-  baseUrl: string;
-  /** 访问 key（代理 token 或厂商 key） */
-  accessKey: string;
-  /** 可选，透传给厂商的 key（BYOK，优先于 accessKey） */
-  vendorKey?: string;
-  /** 协议类型（内置或自定义 protocolId） */
-  protocol: string;
-  /** 该供应商 API 要求的 model 名 */
-  providerModelId: string;
-  /** 协议子路径，直连 ''，代理 '/openai' 等 */
-  path?: string;
-}
-
-/** 模型配置（路由 + 元数据） */
-export interface ModelConfig {
-  /** 路由链（数组顺序 = 降级优先级） */
-  routes: ModelRoute[];
-  /** 显示名称（不传则从预设库补全，再 fallback 到 modelId） */
-  displayName?: string;
-  /**
-   * 所属家族（决定 thinking/toolCall 行为）——必填，不做任何隐式推导
-   * - 字符串：引用内置 ModelFamilyId 或 LLMConfig.families 中的自定义 familyId
-   * - 对象：内联自定义家族配置
-   */
-  family: ModelFamilyId | ModelFamilyConfig;
-  /** 是否在前端模型选择器中显示（默认 true） */
-  visible?: boolean;
-  /** 是否支持深度思考（必填，不做隐式推导） */
-  supportsThinking: boolean;
-  /** 是否支持图片理解（必填，不做隐式推导） */
-  supportsVision: boolean;
-  /** 上下文窗口 token 数（必填，压缩器依赖此值计算预算，前端展示自动推导为 "256K" 格式） */
-  contextWindowTokens: number;
-  /** 定价信息（结构化，展示时自动格式化） */
-  pricing?: ModelPricing;
-  /** 最大输出 token（必填，每个模型限制不同，不做隐式推导） */
-  maxOutputTokens: number;
-}
-
-/**
- * 压缩模型配置（可选，不配则用默认值）
- *
- * 历史压缩直接复用当前对话模型，零配置。
- * 仅单条超长消息（如用户粘贴巨量文本）需要长上下文模型。
- */
-export interface CompressionConfig {
-  /** 超长内容压缩模型（默认 qwen-long） */
-  longModel?: string;
-}
-
-/** 完整 LLM 配置 */
-export interface LLMConfig {
-  /**
-   * 模型配置（唯一真相源）
-   *
-   * key = 模型 ID，value = 路由 + 元数据。
-   * 前端模型选择器只展示这里 visible !== false 的模型。
-   */
-  models: Record<string, ModelConfig>;
-
-  /**
-   * 自定义协议工厂（可插拔）
-   *
-   * key = 自定义 protocolId，value = Protocol 工厂函数。
-   * ModelRoute.protocol 引用此处的 key 或内置 protocolId。
-   */
-  protocols?: Record<string, ProtocolFactory>;
-
-  /**
-   * 自定义家族配置（可插拔）
-   *
-   * key = 自定义 familyId，value = ModelFamilyConfig。
-   * ModelConfig.family 引用此处的 key 或内置 familyId。
-   */
-  families?: Record<string, ModelFamilyConfig>;
-
-  /** 压缩模型配置（可选） */
-  compression?: CompressionConfig;
-}
-
-/** 解析 route 的完整 API URL */
-export function resolveRouteUrl(route: ModelRoute): string {
-  const p = route.path ?? '';
-  return p ? `${route.baseUrl.replace(/\/$/, '')}${p}` : route.baseUrl;
-}
-
-/**
- * 获取模型的 route 链（按优先级）
- */
-export function getRouteChain(
-  config: LLMConfig,
-  modelId: string,
-): ModelRoute[] {
-  return config.models?.[modelId]?.routes ?? [];
-}
-
-/**
- * 查找第一个支持指定 protocol 的 route
- */
-export function findRouteByProtocol(
-  config: LLMConfig,
-  protocolId: string,
-): ModelRoute | undefined {
-  for (const modelConfig of Object.values(config.models)) {
-    if (!modelConfig?.routes) continue;
-    const found = modelConfig.routes.find(r => r.protocol === protocolId);
-    if (found) return found;
-  }
-  return undefined;
-}