@h-ai/ai 0.1.0-alpha.57 → 0.1.0-alpha.59

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@h-ai/ai",
   "type": "module",
-  "version": "0.1.0-alpha.57",
+  "version": "0.1.0-alpha.59",
   "description": "Hai Framework AI module (LLM, MCP, tools, and clients).",
   "license": "Apache-2.0",
   "exports": {
@@ -26,38 +26,38 @@
     "access": "public"
   },
   "engines": {
-    "node": ">=22.12.0"
+    "node": "^22.22.2 || ^24.15.0 || >=26.0.0"
   },
   "dependencies": {
     "@a2a-js/sdk": "^0.3.12",
-    "@modelcontextprotocol/sdk": "^1.26.0",
-    "mem0ai": "^3.0.13",
-    "nanoid": "^5.0.9",
-    "openai": "^6.17.0",
-    "undici": "^7.24.7",
-    "ws": "^8.18.3",
-    "zod": "^4.4.3",
-    "@h-ai/core": "0.1.0-alpha.57",
-    "@h-ai/api-contract": "0.1.0-alpha.57",
-    "@h-ai/datapipe": "0.1.0-alpha.57",
-    "@h-ai/vecdb": "0.1.0-alpha.57",
-    "@h-ai/reldb": "0.1.0-alpha.57"
+    "@h-ai/api-contract": "0.1.0-alpha.59",
+    "@h-ai/core": "0.1.0-alpha.59",
+    "@h-ai/datapipe": "0.1.0-alpha.59",
+    "@h-ai/reldb": "0.1.0-alpha.59",
+    "@h-ai/vecdb": "0.1.0-alpha.59",
+    "@modelcontextprotocol/sdk": "^1.32.1",
+    "mem0ai": "^3.3.1",
+    "nanoid": "^6.0.2",
+    "openai": "^7.32.0",
+    "undici": "^8.11.2",
+    "ws": "^8.22.0",
+    "zod": "^4.6.5"
   },
   "optionalDependencies": {
-    "better-sqlite3": "^12.6.2"
+    "better-sqlite3": "^12.11.1"
   },
   "devDependencies": {
-    "@types/node": "^25.9.1",
-    "@types/ws": "^8.18.1",
+    "@types/node": "^26.6.5",
+    "@types/ws": "^8.18.2",
     "rimraf": "^6.1.3",
     "tsup": "^8.5.1",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.7"
+    "vitest": "^4.1.11"
   },
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch",
-    "typecheck": "tsc --noEmit",
+    "typecheck": "node ../../scripts/typecheck.mjs --noEmit",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
     "test": "vitest run",

package/dist/{ai-reasoning-types-D9UyA9Yc.d.ts → ai-reasoning-types-DZd_6Umd.d.ts}

@@ -1,8 +1,8 @@
-import { AgentCard } from '@a2a-js/sdk';
-import { AgentExecutor } from '@a2a-js/sdk/server';
 import { HaiResult, HaiError } from '@h-ai/core';
 import { CleanOptionsInput, ChunkOptionsInput } from '@h-ai/datapipe';
 import { ZodType, z } from 'zod';
+import { AgentCard } from '@a2a-js/sdk';
+import { AgentExecutor } from '@a2a-js/sdk/server';
 import OpenAI from 'openai';
 
 /**
@@ -466,195 +466,6 @@ interface AIStoreProvider {
     close?: () => Promise<void>;
 }
 
-/**
- * @h-ai/ai — A2A（Agent-to-Agent）子功能类型
- *
- * 定义 A2A 协议集成所需的类型、SDK 类型再导出、操作接口。
- * @module ai-a2a-types
- */
-
-/** A2A 调用方身份信息 */
-interface A2ACallerIdentity {
-    /** 调用方 Agent ID（如 AgentCard.name 或自定义标识） */
-    agentId: string;
-    /** 调用方显示名 */
-    name?: string;
-    /** 调用方 URL（AgentCard 地址） */
-    url?: string;
-}
-/** A2A 消息记录（存储每条 A2A 交互） */
-interface A2AMessageRecord {
-    /** 记录 ID（自动生成） */
-    id: string;
-    /** 关联的 A2A Task ID */
-    taskId: string;
-    /** 所属会话上下文 ID（历史记录可能缺失） */
-    contextId?: string;
-    /** 消息角色：user（入站请求）/ agent（出站响应） */
-    role: 'user' | 'agent';
-    /** 消息内容（JSON 序列化的 Part[] 数组） */
-    parts: unknown[];
-    /** 调用方身份信息（仅 role=user 时） */
-    caller?: A2ACallerIdentity;
-    /** 创建时间戳（毫秒） */
-    createdAt: number;
-}
-/** A2A 上下文信息（对话/会话级别） */
-interface A2AContextInfo {
-    /** 上下文 ID（对应 SDK 的 contextId） */
-    id: string;
-    /** 关联的 Agent 标识 */
-    agentId?: string;
-    /** 上下文标题（可选） */
-    title?: string;
-    /** 创建时间戳 */
-    createdAt: number;
-    /** 最后更新时间戳 */
-    updatedAt: number;
-}
-/**
- * A2A 认证器接口
- *
- * 纯接口设计，由应用层实现，Kit 模块做胶水集成。
- * 用于验证入站 A2A 请求的身份。
- */
-interface A2AAuthenticator {
-    /**
-     * 验证入站请求
-     *
-     * @param headers - HTTP 请求头
-     * @returns 成功返回调用方身份信息，失败返回错误
-     */
-    authenticate: (headers: Record<string, string | undefined>) => Promise<HaiResult<A2ACallerIdentity>>;
-}
-/** A2A 任务查询过滤器 */
-interface A2ATaskFilter {
-    /** 按消息角色过滤（user / agent），不是任务生命周期状态 */
-    status?: string | string[];
-    /** 按上下文 ID 过滤 */
-    contextId?: string;
-    /** 按调用方 Agent ID 过滤 */
-    callerId?: string;
-    /** 时间范围起始（毫秒） */
-    since?: number;
-    /** 最大返回数 */
-    limit?: number;
-    /** 偏移量 */
-    offset?: number;
-}
-/**
- * A2A 操作接口
- *
- * 提供 Agent-to-Agent 协议能力：Agent Card 管理、请求处理、客户端调用。
- */
-interface A2AOperations {
-    /**
-     * 注册 Agent 执行器
-     *
-     * 需要先调用 `ai.init()` 并配置 `a2a` 后才能注册。
-     * 注册后 `handleRequest()`、`listMessages()` 等方法即可使用。
-     *
-     * @param executor - Agent 执行器（由应用层实现）
-     * @returns 注册成功返回 `ok(undefined)`；未配置/未初始化返回 `err(HaiAIError.*)`
-     */
-    registerExecutor: (executor: AgentExecutor) => HaiResult<void>;
-    /**
-     * 获取当前 Agent Card
-     *
-     * 配置了 a2a 后即可使用，无需注册 executor。
-     *
-     * @returns 符合 A2A 0.3 的完整 Agent Card（含能力与安全方案）
-     */
-    getAgentCard: () => HaiResult<AgentCard>;
-    /**
-     * 处理入站 JSON-RPC 请求
-     *
-     * 将 HTTP 请求体路由到 SDK 的 JsonRpcTransportHandler。
-     *
-     * @param requestBody - JSON-RPC 请求体
-     * @param context - 可信 HTTP 层认证上下文；agentId 映射为 SDK user.userName
-     * @returns JSON-RPC 响应（单条或流式）；未初始化也返回 JSON-RPC 错误，不混入 HaiResult
-     */
-    handleRequest: (requestBody: unknown, context?: Record<string, unknown>) => Promise<A2AHandleResult>;
-    /**
-     * 查询 A2A 消息列表（服务端管理接口，不自动推断调用方权限）
-     *
-     * @param filter - 查询过滤器
-     * @returns 分页的消息记录列表
-     */
-    listMessages: (filter: A2ATaskFilter) => Promise<HaiResult<StorePage<A2AMessageRecord>>>;
-    /**
-     * 作为客户端调用远端 Agent
-     *
-     * remoteUrl 只应来自受信配置。框架校验协议和内嵌凭据，应用仍须按部署环境实施来源白名单与出口策略。
-     *
-     * @param remoteUrl - 远端 Agent 的 A2A 端点 URL
-     * @param message - 发送的消息文本
-     * @param options - 调用选项
-     * @returns 远端响应
-     */
-    callRemoteAgent: (remoteUrl: string, message: string, options?: A2ACallOptions) => Promise<HaiResult<A2ACallResult>>;
-}
-/** A2A API Key 安全配置 */
-interface A2AApiKeySecurity {
-    /** API Key 的传递位置 */
-    in: 'header' | 'query';
-    /** 参数名 */
-    name: string;
-}
-/** A2A 安全认证配置 */
-interface A2ASecurityConfig {
-    /** API Key 认证配置 */
-    apiKey?: A2AApiKeySecurity;
-}
-/** Agent Card 配置（应用层提供） */
-interface A2AAgentCardConfig {
-    /** Agent 名称 */
-    name: string;
-    /** Agent 描述 */
-    description?: string;
-    /** Agent URL（对外可访问的 base URL） */
-    url: string;
-    /** Agent 版本 */
-    version?: string;
-    /** Agent 能力声明 */
-    skills?: Array<{
-        id: string;
-        name: string;
-        description?: string;
-        tags?: string[];
-    }>;
-    /** 安全认证配置（体现在 Agent Card 的 securitySchemes / security 字段） */
-    security?: A2ASecurityConfig;
-}
-/** 处理结果（单条或流式） */
-interface A2AHandleResult {
-    /** 是否为流式响应 */
-    streaming: boolean;
-    /** 单条 JSON-RPC 响应体（非流式时） */
-    body?: unknown;
-    /** 流式 JSON-RPC 响应迭代器（流式时） */
-    stream?: AsyncGenerator<unknown, void, undefined>;
-}
-/** 远端调用选项 */
-interface A2ACallOptions {
-    /** 超时时间（毫秒），默认 60 秒。 */
-    timeout?: number;
-    /** 额外请求头 */
-    headers?: Record<string, string>;
-}
-/** 远端调用结果 */
-interface A2ACallResult {
-    /** 远端任务 ID */
-    taskId?: string;
-    /** 任务最终状态 */
-    taskState?: string;
-    /** 响应消息文本 */
-    responseText?: string;
-    /** 响应消息 Part 数组 */
-    responseParts?: unknown[];
-}
-
 /**
  * @h-ai/ai — LLM 子功能类型
  *
@@ -3267,6 +3078,195 @@ type AIConfig = z.infer<typeof AIConfigSchema>;
 /** AI 配置输入类型（允许部分字段） */
 type AIConfigInput = z.input<typeof AIConfigSchema>;
 
+/**
+ * @h-ai/ai — A2A（Agent-to-Agent）子功能类型
+ *
+ * 定义 A2A 协议集成所需的类型、SDK 类型再导出、操作接口。
+ * @module ai-a2a-types
+ */
+
+/** A2A 调用方身份信息 */
+interface A2ACallerIdentity {
+    /** 调用方 Agent ID（如 AgentCard.name 或自定义标识） */
+    agentId: string;
+    /** 调用方显示名 */
+    name?: string;
+    /** 调用方 URL（AgentCard 地址） */
+    url?: string;
+}
+/** A2A 消息记录（存储每条 A2A 交互） */
+interface A2AMessageRecord {
+    /** 记录 ID（自动生成） */
+    id: string;
+    /** 关联的 A2A Task ID */
+    taskId: string;
+    /** 所属会话上下文 ID（历史记录可能缺失） */
+    contextId?: string;
+    /** 消息角色：user（入站请求）/ agent（出站响应） */
+    role: 'user' | 'agent';
+    /** 消息内容（JSON 序列化的 Part[] 数组） */
+    parts: unknown[];
+    /** 调用方身份信息（仅 role=user 时） */
+    caller?: A2ACallerIdentity;
+    /** 创建时间戳（毫秒） */
+    createdAt: number;
+}
+/** A2A 上下文信息（对话/会话级别） */
+interface A2AContextInfo {
+    /** 上下文 ID（对应 SDK 的 contextId） */
+    id: string;
+    /** 关联的 Agent 标识 */
+    agentId?: string;
+    /** 上下文标题（可选） */
+    title?: string;
+    /** 创建时间戳 */
+    createdAt: number;
+    /** 最后更新时间戳 */
+    updatedAt: number;
+}
+/**
+ * A2A 认证器接口
+ *
+ * 纯接口设计，由应用层实现，Kit 模块做胶水集成。
+ * 用于验证入站 A2A 请求的身份。
+ */
+interface A2AAuthenticator {
+    /**
+     * 验证入站请求
+     *
+     * @param headers - HTTP 请求头
+     * @returns 成功返回调用方身份信息，失败返回错误
+     */
+    authenticate: (headers: Record<string, string | undefined>) => Promise<HaiResult<A2ACallerIdentity>>;
+}
+/** A2A 任务查询过滤器 */
+interface A2ATaskFilter {
+    /** 按消息角色过滤（user / agent），不是任务生命周期状态 */
+    status?: string | string[];
+    /** 按上下文 ID 过滤 */
+    contextId?: string;
+    /** 按调用方 Agent ID 过滤 */
+    callerId?: string;
+    /** 时间范围起始（毫秒） */
+    since?: number;
+    /** 最大返回数 */
+    limit?: number;
+    /** 偏移量 */
+    offset?: number;
+}
+/**
+ * A2A 操作接口
+ *
+ * 提供 Agent-to-Agent 协议能力：Agent Card 管理、请求处理、客户端调用。
+ */
+interface A2AOperations {
+    /**
+     * 注册 Agent 执行器
+     *
+     * 需要先调用 `ai.init()` 并配置 `a2a` 后才能注册。
+     * 注册后 `handleRequest()`、`listMessages()` 等方法即可使用。
+     *
+     * @param executor - Agent 执行器（由应用层实现）
+     * @returns 注册成功返回 `ok(undefined)`；未配置/未初始化返回 `err(HaiAIError.*)`
+     */
+    registerExecutor: (executor: AgentExecutor) => HaiResult<void>;
+    /**
+     * 获取当前 Agent Card
+     *
+     * 配置了 a2a 后即可使用，无需注册 executor。
+     *
+     * @returns 符合 A2A 0.3 的完整 Agent Card（含能力与安全方案）
+     */
+    getAgentCard: () => HaiResult<AgentCard>;
+    /**
+     * 处理入站 JSON-RPC 请求
+     *
+     * 将 HTTP 请求体路由到 SDK 的 JsonRpcTransportHandler。
+     *
+     * @param requestBody - JSON-RPC 请求体
+     * @param context - 可信 HTTP 层认证上下文；agentId 映射为 SDK user.userName
+     * @returns JSON-RPC 响应（单条或流式）；未初始化也返回 JSON-RPC 错误，不混入 HaiResult
+     */
+    handleRequest: (requestBody: unknown, context?: Record<string, unknown>) => Promise<A2AHandleResult>;
+    /**
+     * 查询 A2A 消息列表（服务端管理接口，不自动推断调用方权限）
+     *
+     * @param filter - 查询过滤器
+     * @returns 分页的消息记录列表
+     */
+    listMessages: (filter: A2ATaskFilter) => Promise<HaiResult<StorePage<A2AMessageRecord>>>;
+    /**
+     * 作为客户端调用远端 Agent
+     *
+     * remoteUrl 只应来自受信配置。框架校验协议和内嵌凭据，应用仍须按部署环境实施来源白名单与出口策略。
+     *
+     * @param remoteUrl - 远端 Agent 的 A2A 端点 URL
+     * @param message - 发送的消息文本
+     * @param options - 调用选项
+     * @returns 远端响应
+     */
+    callRemoteAgent: (remoteUrl: string, message: string, options?: A2ACallOptions) => Promise<HaiResult<A2ACallResult>>;
+}
+/** A2A API Key 安全配置 */
+interface A2AApiKeySecurity {
+    /** API Key 的传递位置 */
+    in: 'header' | 'query';
+    /** 参数名 */
+    name: string;
+}
+/** A2A 安全认证配置 */
+interface A2ASecurityConfig {
+    /** API Key 认证配置 */
+    apiKey?: A2AApiKeySecurity;
+}
+/** Agent Card 配置（应用层提供） */
+interface A2AAgentCardConfig {
+    /** Agent 名称 */
+    name: string;
+    /** Agent 描述 */
+    description?: string;
+    /** Agent URL（对外可访问的 base URL） */
+    url: string;
+    /** Agent 版本 */
+    version?: string;
+    /** Agent 能力声明 */
+    skills?: Array<{
+        id: string;
+        name: string;
+        description?: string;
+        tags?: string[];
+    }>;
+    /** 安全认证配置（体现在 Agent Card 的 securitySchemes / security 字段） */
+    security?: A2ASecurityConfig;
+}
+/** 处理结果（单条或流式） */
+interface A2AHandleResult {
+    /** 是否为流式响应 */
+    streaming: boolean;
+    /** 单条 JSON-RPC 响应体（非流式时） */
+    body?: unknown;
+    /** 流式 JSON-RPC 响应迭代器（流式时） */
+    stream?: AsyncGenerator<unknown, void, undefined>;
+}
+/** 远端调用选项 */
+interface A2ACallOptions {
+    /** 超时时间（毫秒），默认 60 秒。 */
+    timeout?: number;
+    /** 额外请求头 */
+    headers?: Record<string, string>;
+}
+/** 远端调用结果 */
+interface A2ACallResult {
+    /** 远端任务 ID */
+    taskId?: string;
+    /** 任务最终状态 */
+    taskState?: string;
+    /** 响应消息文本 */
+    responseText?: string;
+    /** 响应消息 Part 数组 */
+    responseParts?: unknown[];
+}
+
 /**
  * @h-ai/ai — Audio 子功能公共类型
  *