@huyooo/ai-chat-core 0.3.6 → 0.3.8

package/src/tool-manager/define-tool.ts

@@ -1,201 +0,0 @@
-/**
- * defineTool — TypeBox-only 的工具定义与执行封装
- *
- * - 编译 schema 缓存、外部 JSON Schema 参数校验
- * - 统一 governance / UI 元数据到 Tool 类型
- */
-
-import { type Static, type TSchema, type TObject } from '@sinclair/typebox';
-import { TypeCompiler, type TypeCheck } from '@sinclair/typebox/compiler';
-import type {
-  AssetApprovalPolicy,
-  AssetHostDependency,
-  AssetSideEffectLevel,
-} from '../governance/types';
-import type { JsonSchemaObject, Tool, ToolContext, ToolExecuteResult, ToolGovernanceSnapshot, ToolUI } from '../types';
-import { createResolvedOutputSchema, jsonSchemaToTypeBoxSchema, STANDARD_TOOL_ERROR_SCHEMA, throwToolError } from '../types';
-import { registerToolFormats } from './formats';
-
-// 编译后的 validator 使用 WeakMap 按 schema 对象缓存。
-// 这样同一个 schema 只编译一次，后续工具调用直接复用，
-// 同时又不会因为全局 Map 常驻而造成无界内存增长。
-const validatorCache = new WeakMap<object, TypeCheck<TSchema>>();
-// JSON Schema 需要先转成 TypeBox TObject，再编译 validator。
-// 这里同样按 schema 对象缓存转换结果，避免重复构造。
-const objectSchemaCache = new WeakMap<object, TObject>();
-
-registerToolFormats();
-
-export interface TypeBoxToolConfig<TSchema extends TObject> {
-  id?: string;
-  name: string;
-  alias?: string;
-  displayName?: string;
-  description: string;
-  inputSchema: TSchema;
-  /** 成功时 data 内的业务结构。defineTool 会生成标准 status/data/message 外围 resolvedOutputSchema。 */
-  outputSchema?: TObject;
-  /** 失败返回结构。不传时使用平台标准 ToolError schema。 */
-  errorSchema?: TObject;
-  ui?: ToolUI;
-  requiresApproval?: boolean;
-  approvalPolicy?: AssetApprovalPolicy;
-  sideEffectLevel?: AssetSideEffectLevel;
-  hostDependency?: AssetHostDependency;
-  assessInputGovernance?: (
-    args: Static<TSchema>,
-  ) => ToolGovernanceSnapshot | Promise<ToolGovernanceSnapshot | undefined> | undefined;
-  category?: string;
-  tags?: string[];
-  timeout?: number;
-  execute: (args: Static<TSchema>, context: ToolContext) => Promise<ToolExecuteResult>;
-}
-
-function getCachedValidator<TSchemaValue extends TSchema>(schema: TSchemaValue): TypeCheck<TSchemaValue> {
-  let validator = validatorCache.get(schema);
-  if (!validator) {
-    validator = TypeCompiler.Compile(schema);
-    validatorCache.set(schema, validator);
-  }
-  return validator as TypeCheck<TSchemaValue>;
-}
-
-function normalizeErrorPath(path: string): string {
-  return path.replace(/^\//, '').replace(/\//g, '.');
-}
-
-function formatValidationMessage(path: string, message: string): string {
-  return path ? `${path}: ${message}` : message;
-}
-
-function getJsonSchemaValidator(parameters: JsonSchemaObject): TypeCheck<TObject> {
-  let schema = objectSchemaCache.get(parameters);
-  if (!schema) {
-    schema = jsonSchemaToTypeBoxSchema(parameters as unknown as Record<string, unknown>) as TObject;
-    objectSchemaCache.set(parameters, schema);
-  }
-  return getCachedValidator(schema);
-}
-
-function throwValidationError(messages: string[]): never {
-  const message = messages.length > 0
-    ? messages.join('; ')
-    : '输入不符合工具参数定义';
-
-  throwToolError({
-    message: `参数校验失败: ${message}`,
-    code: 'INVALID_PARAMS',
-    suggestion: '请根据工具的 inputSchema 修正参数类型和结构后重试',
-    retryable: true,
-  });
-}
-
-export function validateTypeBoxArgs<TSchemaValue extends TObject>(
-  inputSchema: TSchemaValue,
-  rawArgs: Record<string, unknown>,
-): Static<TSchemaValue> {
-  const validator = getCachedValidator(inputSchema);
-  if (validator.Check(rawArgs)) {
-    return rawArgs as Static<TSchemaValue>;
-  }
-
-  const messages = Array.from(validator.Errors(rawArgs), error =>
-    formatValidationMessage(normalizeErrorPath(error.path), error.message),
-  );
-  throwValidationError(messages);
-}
-
-export function validateJsonSchemaArgs(
-  parameters: JsonSchemaObject,
-  rawArgs: Record<string, unknown>,
-): Record<string, unknown> {
-  const validator = getJsonSchemaValidator(parameters);
-  if (validator.Check(rawArgs)) {
-    return rawArgs;
-  }
-
-  const messages = Array.from(validator.Errors(rawArgs), error =>
-    formatValidationMessage(normalizeErrorPath(error.path), error.message),
-  );
-  throwValidationError(messages);
-}
-
-function getToolParameters<TSchemaValue extends TObject>(
-  config: TypeBoxToolConfig<TSchemaValue>,
-): JsonSchemaObject {
-  return config.inputSchema as unknown as JsonSchemaObject;
-}
-
-function getDeclaredOutputSchema<TSchemaValue extends TObject>(
-  config: TypeBoxToolConfig<TSchemaValue>,
-): JsonSchemaObject | undefined {
-  return config.outputSchema as unknown as JsonSchemaObject | undefined;
-}
-
-function getResolvedOutputSchema<TSchemaValue extends TObject>(
-  config: TypeBoxToolConfig<TSchemaValue>,
-): JsonSchemaObject | undefined {
-  const outputSchema = getDeclaredOutputSchema(config);
-  if (outputSchema) return createResolvedOutputSchema(outputSchema);
-  return undefined;
-}
-
-function validateToolArgs<TSchemaValue extends TObject>(
-  config: TypeBoxToolConfig<TSchemaValue>,
-  rawArgs: Record<string, unknown>,
-): Static<TSchemaValue> {
-  return validateTypeBoxArgs(config.inputSchema, rawArgs);
-}
-
-export function defineTool<TSchemaValue extends TObject>(
-  config: TypeBoxToolConfig<TSchemaValue>,
-): Tool {
-  if ('parameters' in (config as unknown as Record<string, unknown>)) {
-    throw new Error('defineTool 只支持 TypeBox inputSchema；不要使用 parameters JSON Schema');
-  }
-
-  const parameters = getToolParameters(config);
-
-  return {
-    /** 稳定唯一 id（可选）：注册表、遥测、去重或与外部系统对齐时用；缺省可由宿主按 name 生成 */
-    id: config.id,
-    /** 工具名：模型 function/tool 调用里使用的标识，需与宿主注册名一致 */
-    name: config.name,
-    /** 别名（可选）：兼容旧名称或同一实现的另一入口 */
-    alias: config.alias,
-    /** 展示名（可选）：UI/日志里给人看的短标题，不必与 name 相同 */
-    displayName: config.displayName,
-    /** 自然语言说明：写入模型上下文，描述工具用途、约束与典型用法 */
-    description: config.description,
-    /** 参数 JSON Schema：供模型与表单生成入参 */
-    parameters,
-    /** 成功时 data 内的业务 JSON Schema：供摘要、检索与资产元数据使用 */
-    outputSchema: getDeclaredOutputSchema(config),
-    /** 成功返回标准信封 JSON Schema：供模型在调用前理解完整结果结构 */
-    resolvedOutputSchema: getResolvedOutputSchema(config),
-    /** 失败返回 JSON Schema：默认使用平台标准错误信封 */
-    errorSchema: (config.errorSchema as unknown as JsonSchemaObject | undefined) ?? STANDARD_TOOL_ERROR_SCHEMA,
-    /** 结构化 UI 元数据（可选）：如结果卡片类型、字段映射、前端 Part 渲染提示 */
-    ui: config.ui,
-    /** 是否必须经用户显式批准后才执行（与 approvalPolicy 二选一或组合，依宿主策略） */
-    requiresApproval: config.requiresApproval,
-    /** 审批策略：auto / 始终人工 / 条件人工 等，由治理层与宿主解释 */
-    approvalPolicy: config.approvalPolicy,
-    /** 副作用级别：read / write / destructive 等，用于风险提示与默认审批策略 */
-    sideEffectLevel: config.sideEffectLevel,
-    /** 宿主依赖：是否需要网络、本地 OS、特定沙箱能力等，供环境检查与提示 */
-    hostDependency: config.hostDependency,
-    /** 执行前治理快照（可选）：对「已校验」的参数做风险分级等，供 UI 徽章与审批流 */
-    assessInputGovernance: config.assessInputGovernance
-      ? async (rawArgs) => config.assessInputGovernance?.(validateToolArgs(config, rawArgs))
-      : undefined,
-    /** 分类（可选）：设置页、工具市场或列表分组 */
-    category: config.category,
-    /** 标签（可选）：检索、过滤或能力画像 */
-    tags: config.tags,
-    /** 单次执行超时毫秒（可选）：超时后宿主应中止并返回可重试错误 */
-    timeout: config.timeout,
-    /** 实际执行：先将 rawArgs 用声明的 schema 校验，再传入业务 execute */
-    execute: async (rawArgs, context) => config.execute(validateToolArgs(config, rawArgs), context),
-  };
-}

package/src/tool-manager/formats.ts

@@ -1,146 +0,0 @@
-/**
- * 工具参数 TypeBox 自定义 format 注册表
- *
- * - TOOL_FORMATS：email / uuid / url 等常用约束名
- * - 与 defineTool 中的 schema 编译共用
- */
-
-import { FormatRegistry } from '@sinclair/typebox';
-
-export const TOOL_FORMATS = {
-  email: 'email',
-  uuidAny: 'uuid-any',
-  cuid: 'cuid',
-  cuid2: 'cuid2',
-  ulid: 'ulid',
-  nanoid: 'nanoid',
-  url: 'url',
-  uri: 'uri',
-  uuid: 'uuid',
-  ipv4: 'ipv4',
-  ipv6: 'ipv6',
-  ip: 'ip',
-  cidr: 'cidr',
-  hostname: 'hostname',
-  date: 'date',
-  time: 'time',
-  dateTime: 'date-time',
-  datetime: 'datetime',
-  duration: 'duration',
-  phone: 'phone',
-  phoneCn: 'phone-cn',
-  phoneE164: 'phone-e164',
-  objectId: 'objectid',
-  slug: 'slug',
-  base64: 'base64',
-  base64url: 'base64url',
-  jwt: 'jwt',
-  hexColor: 'hex-color',
-  rgbColor: 'rgb-color',
-  color: 'color',
-  emoji: 'emoji',
-  semver: 'semver',
-  creditCard: 'credit-card',
-} as const;
-
-export type ToolFormat = typeof TOOL_FORMATS[keyof typeof TOOL_FORMATS];
-
-const EMAIL_REGEX = /^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$/;
-const UUID_ANY_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-const CUID_REGEX = /^c[^\s-]{8,}$/i;
-const CUID2_REGEX = /^[0-9a-z]+$/;
-const ULID_REGEX = /^[0-9A-HJKMNP-TV-Z]{26}$/i;
-const NANOID_REGEX = /^[A-Za-z0-9_-]{21}$/;
-const URL_REGEX = /^https?:\/\/(?:www\.)?[-a-zA-Z0-9@:%._+~#=]{1,256}\.[a-zA-Z0-9()]{1,63}\b[-a-zA-Z0-9()@:%_+.~#?&/=]*$/;
-const UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
-const IPV4_REGEX = /^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/;
-const IPV6_REGEX = /^(?:[0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}$|^::(?:[0-9a-fA-F]{1,4}:){0,6}[0-9a-fA-F]{1,4}$|^(?:[0-9a-fA-F]{1,4}:){1,7}:$|^(?:[0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}$|^(?:[0-9a-fA-F]{1,4}:){1,5}(?::[0-9a-fA-F]{1,4}){1,2}$|^(?:[0-9a-fA-F]{1,4}:){1,4}(?::[0-9a-fA-F]{1,4}){1,3}$|^(?:[0-9a-fA-F]{1,3}:){1,3}(?::[0-9a-fA-F]{1,4}){1,4}$|^(?:[0-9a-fA-F]{1,2}:){1,2}(?::[0-9a-fA-F]{1,4}){1,5}$|^[0-9a-fA-F]{1,4}:(?::[0-9a-fA-F]{1,4}){1,6}$/;
-const CIDR_REGEX = /^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\/(?:3[0-2]|[12]?[0-9])$/;
-const HOSTNAME_REGEX = /^(?=.{1,253}$)(?:(?!-)[a-zA-Z0-9-]{1,63}(?<!-)\.)*(?!-)[a-zA-Z0-9-]{1,63}(?<!-)$/;
-const DATE_REGEX = /^\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12][0-9]|3[01])$/;
-const TIME_REGEX = /^(?:[01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](?:\.\d{1,3})?$/;
-const DATE_TIME_REGEX = /^\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12][0-9]|3[01])T(?:[01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](?:\.\d{1,3})?(?:Z|[+-](?:[01][0-9]|2[0-3]):[0-5][0-9])?$/;
-const DURATION_REGEX = /^P(?:\d+Y)?(?:\d+M)?(?:\d+W)?(?:\d+D)?(?:T(?:\d+H)?(?:\d+M)?(?:\d+(?:\.\d+)?S)?)?$/;
-const PHONE_CN_REGEX = /^1[3-9]\d{9}$/;
-const PHONE_E164_REGEX = /^\+[1-9]\d{6,14}$/;
-const OBJECTID_REGEX = /^[0-9a-fA-F]{24}$/;
-const HEX_COLOR_REGEX = /^#(?:[0-9a-fA-F]{3}){1,2}$/;
-const RGB_COLOR_REGEX = /^rgba?\(\s*(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\s*,\s*(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\s*,\s*(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)(?:\s*,\s*(?:0|1|0?\.\d+))?\s*\)$/;
-const BASE64_REGEX = /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/;
-const BASE64URL_REGEX = /^[A-Za-z0-9_-]+$/;
-const JWT_REGEX = /^[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+$/;
-const EMOJI_REGEX = /^[\p{Emoji}]+$/u;
-const SLUG_REGEX = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
-const SEMVER_REGEX = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$/;
-
-let registered = false;
-
-function isValidCreditCard(value: string): boolean {
-  const digits = value.replace(/\D/g, '');
-  if (digits.length < 13 || digits.length > 19) return false;
-
-  let sum = 0;
-  let isEven = false;
-
-  for (let i = digits.length - 1; i >= 0; i--) {
-    let digit = parseInt(digits[i], 10);
-    if (isEven) {
-      digit *= 2;
-      if (digit > 9) digit -= 9;
-    }
-    sum += digit;
-    isEven = !isEven;
-  }
-
-  return sum % 10 === 0;
-}
-
-export function registerToolFormats(): void {
-  if (registered) return;
-  registered = true;
-
-  FormatRegistry.Set(TOOL_FORMATS.email, value => EMAIL_REGEX.test(value));
-  FormatRegistry.Set(TOOL_FORMATS.uuidAny, value => UUID_ANY_REGEX.test(value));
-  FormatRegistry.Set(TOOL_FORMATS.cuid, value => CUID_REGEX.test(value));
-  FormatRegistry.Set(TOOL_FORMATS.cuid2, value => CUID2_REGEX.test(value) && value.length >= 1);
-  FormatRegistry.Set(TOOL_FORMATS.ulid, value => ULID_REGEX.test(value));
-  FormatRegistry.Set(TOOL_FORMATS.nanoid, value => NANOID_REGEX.test(value));
-  FormatRegistry.Set(TOOL_FORMATS.url, value => URL_REGEX.test(value));
-  FormatRegistry.Set(TOOL_FORMATS.uri, value => URL_REGEX.test(value));
-  FormatRegistry.Set(TOOL_FORMATS.uuid, value => UUID_REGEX.test(value));
-  FormatRegistry.Set(TOOL_FORMATS.ipv4, value => IPV4_REGEX.test(value));
-  FormatRegistry.Set(TOOL_FORMATS.ipv6, value => IPV6_REGEX.test(value));
-  FormatRegistry.Set(TOOL_FORMATS.ip, value => IPV4_REGEX.test(value) || IPV6_REGEX.test(value));
-  FormatRegistry.Set(TOOL_FORMATS.cidr, value => CIDR_REGEX.test(value));
-  FormatRegistry.Set(TOOL_FORMATS.hostname, value => HOSTNAME_REGEX.test(value));
-  FormatRegistry.Set(TOOL_FORMATS.date, value => DATE_REGEX.test(value));
-  FormatRegistry.Set(TOOL_FORMATS.time, value => TIME_REGEX.test(value));
-  FormatRegistry.Set(TOOL_FORMATS.dateTime, value => DATE_TIME_REGEX.test(value));
-  FormatRegistry.Set(TOOL_FORMATS.datetime, value => DATE_TIME_REGEX.test(value));
-  FormatRegistry.Set(TOOL_FORMATS.duration, value => DURATION_REGEX.test(value));
-  FormatRegistry.Set(TOOL_FORMATS.phone, value => PHONE_CN_REGEX.test(value));
-  FormatRegistry.Set(TOOL_FORMATS.phoneCn, value => PHONE_CN_REGEX.test(value));
-  FormatRegistry.Set(TOOL_FORMATS.phoneE164, value => PHONE_E164_REGEX.test(value));
-  FormatRegistry.Set(TOOL_FORMATS.objectId, value => OBJECTID_REGEX.test(value));
-  FormatRegistry.Set(TOOL_FORMATS.slug, value => SLUG_REGEX.test(value));
-  FormatRegistry.Set(TOOL_FORMATS.base64, value => BASE64_REGEX.test(value));
-  FormatRegistry.Set(TOOL_FORMATS.base64url, value => BASE64URL_REGEX.test(value));
-  FormatRegistry.Set(TOOL_FORMATS.jwt, value => JWT_REGEX.test(value));
-  FormatRegistry.Set(TOOL_FORMATS.hexColor, value => HEX_COLOR_REGEX.test(value));
-  FormatRegistry.Set(TOOL_FORMATS.rgbColor, value => RGB_COLOR_REGEX.test(value));
-  FormatRegistry.Set(TOOL_FORMATS.color, value => HEX_COLOR_REGEX.test(value) || RGB_COLOR_REGEX.test(value));
-  FormatRegistry.Set(TOOL_FORMATS.emoji, value => EMOJI_REGEX.test(value));
-  FormatRegistry.Set(TOOL_FORMATS.semver, value => SEMVER_REGEX.test(value));
-  FormatRegistry.Set(TOOL_FORMATS.creditCard, isValidCreditCard);
-}
-
-export function registerToolFormat(
-  name: string,
-  validator: (value: string) => boolean,
-): void {
-  FormatRegistry.Set(name, validator);
-}
-
-export function hasToolFormat(name: string): boolean {
-  return FormatRegistry.Has(name);
-}

package/src/tool-manager/identity.ts

@@ -1,80 +0,0 @@
-/**
- * 工具在运行时管理器中的命名空间与 identity
- *
- * 两段式 scoped identity：assetId / name
- * - assetId 有值 → scoped 工具：id = source:assetId:name, alias = assetId__name
- * - assetId 无值 → 独立工具：id = source:name, alias = name
- */
-
-import { STANDARD_TOOL_ERROR_SCHEMA, createResolvedOutputSchema, type Tool } from '../types';
-import type { AssetSource } from '../governance/types';
-import type { ToolDescriptor } from './types';
-
-function sanitizeAliasPart(value: string): string {
-  return value.replace(/[^a-zA-Z0-9_]/g, '_');
-}
-
-function toScopedIdentity(tool: Tool, _providerId: string, source: AssetSource) {
-  const hasScope = !!tool.assetId;
-  const assetId = sanitizeAliasPart(tool.assetId ?? tool.name);
-  const sanitizedName = sanitizeAliasPart(tool.name);
-  const alias = tool.alias
-    ?? (hasScope ? `${assetId}__${sanitizedName}` : assetId);
-  const id = tool.id
-    ?? (hasScope ? `${source}:${assetId}:${sanitizedName}` : `${source}:${assetId}`);
-
-  return { id, assetId, alias };
-}
-
-export function createToolDescriptor(
-  tool: Tool,
-  providerId: string,
-  source: AssetSource,
-  meta?: { category?: string; tags?: string[] },
-): ToolDescriptor {
-  const scoped = toScopedIdentity(tool, providerId, source);
-
-  return {
-    id: scoped.id,
-    assetId: scoped.assetId,
-    name: tool.name,
-    alias: scoped.alias,
-    displayName: tool.displayName ?? tool.name,
-    description: tool.description,
-    parameters: tool.parameters,
-    outputSchema: tool.outputSchema,
-    resolvedOutputSchema: tool.resolvedOutputSchema ?? (tool.outputSchema ? createResolvedOutputSchema(tool.outputSchema) : undefined),
-    errorSchema: tool.errorSchema ?? STANDARD_TOOL_ERROR_SCHEMA,
-    category: meta?.category ?? tool.category ?? 'general',
-    tags: meta?.tags ?? tool.tags ?? [],
-    source,
-    provider: providerId,
-    ui: tool.ui,
-    requiresApproval: tool.requiresApproval,
-    approvalPolicy: tool.approvalPolicy,
-    sideEffectLevel: tool.sideEffectLevel,
-    hostDependency: tool.hostDependency,
-  };
-}
-
-export function matchesToolDescriptorRef(descriptor: ToolDescriptor, ref: string): boolean {
-  return descriptor.id === ref || descriptor.alias === ref || (!descriptor.assetId || descriptor.assetId === descriptor.name ? descriptor.assetId === ref : false);
-}
-
-export function getToolIdentityKey(tool: Pick<Tool, 'id' | 'name' | 'assetId'>): string {
-  return tool.id
-    ?? (tool.assetId
-      ? `${tool.assetId}:${tool.name}`
-      : tool.name);
-}
-
-export function createAliasedTool(tool: Tool, descriptor: ToolDescriptor): Tool {
-  return {
-    ...tool,
-    id: descriptor.id,
-    assetId: descriptor.assetId,
-    alias: descriptor.alias,
-    displayName: descriptor.displayName,
-    name: descriptor.alias,
-  };
-}

package/src/tool-manager/in-process-provider.ts

@@ -1,164 +0,0 @@
-/**
- * InProcessProvider — 进程内工具提供者
- *
- * 管理所有在主进程中直接运行的工具（builtin + user-created）。
- *
- * 核心能力：
- * - 即时注册/卸载/热替换工具
- * - 变更事件通知
- * - 描述符缓存（避免频繁重建）
- * - 每个工具独立 source 标记
- */
-
-import type { Tool } from '../types';
-import type { AssetSource } from '../governance/types';
-import type {
-  InProcessProvider,
-  ToolDescriptor,
-  ToolChangeListener,
-  ToolChangeEvent,
-} from './types';
-import { createToolDescriptor, matchesToolDescriptorRef } from './identity';
-
-/** 内部存储：工具 + 元数据 */
-interface StoredTool {
-  tool: Tool;
-  source: AssetSource;
-  category?: string;
-  tags?: string[];
-}
-
-export function createInProcessProvider(
-  providerId: string,
-  defaultSource: AssetSource = 'bundled',
-): InProcessProvider {
-  const store = new Map<string, StoredTool>();
-  const listeners = new Set<ToolChangeListener>();
-  let cachedDescriptors: ToolDescriptor[] = [];
-
-  function emit(event: ToolChangeEvent) {
-    for (const fn of listeners) fn(event);
-  }
-
-  function toDescriptor(stored: StoredTool): ToolDescriptor {
-    return createToolDescriptor(stored.tool, providerId, stored.source, {
-      category: stored.category,
-      tags: stored.tags,
-    });
-  }
-
-  function getStoredKey(stored: StoredTool): string {
-    return toDescriptor(stored).id;
-  }
-
-  function getStoredByRef(ref: string): StoredTool | undefined {
-    for (const stored of store.values()) {
-      if (matchesToolDescriptorRef(toDescriptor(stored), ref)) return stored;
-    }
-    return undefined;
-  }
-
-  function getStoredEntryByRef(ref: string): [string, StoredTool] | undefined {
-    for (const entry of store.entries()) {
-      if (matchesToolDescriptorRef(toDescriptor(entry[1]), ref)) return entry;
-    }
-    return undefined;
-  }
-
-  function rebuildCache() {
-    cachedDescriptors = Array.from(store.values()).map(toDescriptor);
-  }
-
-  const provider: InProcessProvider = {
-    id: providerId,
-    source: defaultSource,
-
-    async init() {
-      // InProcessProvider 无异步初始化
-    },
-
-    async destroy() {
-      store.clear();
-      cachedDescriptors = [];
-      listeners.clear();
-    },
-
-    getDescriptors(): ToolDescriptor[] {
-      return cachedDescriptors.slice();
-    },
-
-    async loadTool(ref: string): Promise<Tool | null> {
-      return getStoredByRef(ref)?.tool ?? null;
-    },
-
-    addChangeListener(listener: ToolChangeListener) {
-      listeners.add(listener);
-    },
-
-    removeChangeListener(listener: ToolChangeListener) {
-      listeners.delete(listener);
-    },
-
-    register(tool: Tool, meta?: { category?: string; tags?: string[]; source?: AssetSource }) {
-      const stored: StoredTool = {
-        tool,
-        source: meta?.source ?? defaultSource,
-        category: meta?.category,
-        tags: meta?.tags,
-      };
-      store.set(getStoredKey(stored), stored);
-      rebuildCache();
-      emit({ type: 'added', tools: [toDescriptor(stored)], provider: providerId });
-    },
-
-    registerAll(toolList: Tool[], meta?: { category?: string; tags?: string[]; source?: AssetSource }) {
-      const descriptors: ToolDescriptor[] = [];
-      for (const tool of toolList) {
-        const stored: StoredTool = {
-          tool,
-          source: meta?.source ?? defaultSource,
-          category: meta?.category,
-          tags: meta?.tags,
-        };
-        store.set(getStoredKey(stored), stored);
-        descriptors.push(toDescriptor(stored));
-      }
-      rebuildCache();
-      if (descriptors.length > 0) {
-        emit({ type: 'added', tools: descriptors, provider: providerId });
-      }
-    },
-
-    unregister(ref: string) {
-      const entry = getStoredEntryByRef(ref);
-      if (!entry) return;
-      const [key, stored] = entry;
-      store.delete(key);
-      rebuildCache();
-      emit({ type: 'removed', tools: [toDescriptor(stored)], provider: providerId });
-    },
-
-    replace(tool: Tool, meta?: { category?: string; tags?: string[]; source?: AssetSource }) {
-      const existingEntry = getStoredEntryByRef(tool.id ?? tool.alias ?? tool.name);
-      const existing = existingEntry?.[1];
-      const stored: StoredTool = {
-        tool,
-        source: meta?.source ?? existing?.source ?? defaultSource,
-        category: meta?.category ?? existing?.category,
-        tags: meta?.tags ?? existing?.tags,
-      };
-      if (existingEntry) {
-        store.delete(existingEntry[0]);
-      }
-      store.set(getStoredKey(stored), stored);
-      rebuildCache();
-      emit({ type: 'updated', tools: [toDescriptor(stored)], provider: providerId });
-    },
-
-    has(ref: string): boolean {
-      return !!getStoredByRef(ref);
-    },
-  };
-
-  return provider;
-}

package/src/tool-manager/index.ts

@@ -1,63 +0,0 @@
-/**
- * 工具运行时模块导出（barrel）
- *
- * - types / providers / ToolRuntimeManager：多来源工具编排
- * - summaries：管理 API 摘要
- * - defineTool / formats：TypeBox 工具定义与外部 JSON Schema 校验
- */
-
-// ══════════════════════ 类型 ══════════════════════
-
-export type {
-  ToolDescriptor,
-  ToolChangeEvent,
-  ToolChangeListener,
-  SessionToolsChangeEvent,
-  SessionToolsChangeListener,
-  ToolProvider,
-  InProcessProvider,
-  McpProviderExtended,
-  McpServerConfig,
-  McpConnectionStatus,
-  McpConnectionInfo,
-  ConnectionStatusEvent,
-  ConnectionStatusListener,
-  ToolMiddleware,
-  ToolExecutionStats,
-  ToolSearchQuery,
-  CategorySummary,
-  ProviderInfo,
-  ToolRuntimeManager,
-} from './types';
-
-// ══════════════════════ Provider 实现 ══════════════════════
-
-export { createInProcessProvider } from './in-process-provider';
-
-export { createMcpProvider } from './mcp-provider';
-
-// ══════════════════════ 统一管理器 ══════════════════════
-
-export { createToolRuntimeManager } from './manager';
-
-// ══════════════════════ 摘要 / 详情构建 ══════════════════════
-
-export {
-  createManagedToolSummary,
-  createManagedToolDetail,
-  createManagedMcpServerSummary,
-  createManagedMcpServerDetail,
-} from './summaries';
-export type {
-  ManagedToolSummary,
-  ManagedToolDetail,
-  ManagedMcpServerSummary,
-  ManagedMcpServerDetail,
-} from './types';
-
-// ══════════════════════ TypeBox 工具 ══════════════════════
-
-export { defineTool, validateJsonSchemaArgs, validateTypeBoxArgs } from './define-tool';
-export type { TypeBoxToolConfig } from './define-tool';
-export { TOOL_FORMATS, registerToolFormats, registerToolFormat, hasToolFormat } from './formats';
-export type { ToolFormat } from './formats';