agent-tool-chat 1.2.0 → 1.6.0

package/dist/types.d.ts

@@ -3,8 +3,14 @@ import { CoreMessage, ToolCall, StreamResult, ToolDefinition as CoreToolDefiniti
 export type { CoreMessage, ToolCall, StreamResult, LLMProviderConfig };
 export interface ToolDefinition {
     name: string;
+    alias?: string;
     description: string;
     parameters: Record<string, any>;
+    /**
+     * 执行前置条件。声明后会写进系统提示词；
+     * 带 check 的条件由宿主 onCheckToolRequirement 权威判定，未满足时不执行工具。
+     */
+    requires?: ToolRequirement | ToolRequirement[];
     displayHints?: {
         suggestComponent?: string;
         resultFormat?: 'table' | 'card' | 'list' | 'text' | 'map' | 'none' | 'auto';
@@ -81,10 +87,53 @@ export interface ChatMessage {
 export interface ToolResult {
     callId: string;
     name: string;
+    alias?: string;
     arguments: string;
     result: string;
     success: boolean;
-    status: 'running' | 'success' | 'error';
+    status: 'running' | 'success' | 'error' | 'blocked';
+    /** 被前置条件阻断时的原因（status === 'blocked'） */
+    hint?: string;
+}
+export type ToolRequirementAction = 'call-tool' | 'ask-user' | 'block';
+export interface ToolRequirement {
+    /** 条件说明（必填，会写进系统提示词） */
+    description: string;
+    /** 建议先成功调用的工具名（仅提示词建议，不做硬拦截） */
+    tools?: string[];
+    /** 宿主校验项 id，由 onCheckToolRequirement 判定；未满足则不执行工具 */
+    check?: string;
+    /** 未满足时给模型/用户的指令 */
+    hint?: string;
+    /** 未满足时建议动作，默认：有 tools → call-tool，否则 ask-user */
+    action?: ToolRequirementAction;
+}
+export interface ToolRequirementContext {
+    sessionId: string;
+    packageId: string;
+    toolName: string;
+    args: Record<string, any>;
+    check: string;
+    description?: string;
+}
+export interface ToolRequirementResult {
+    ok: boolean;
+    /** 未满足原因（进 tool 结果与 UI） */
+    message?: string;
+    /** 覆盖声明里的 hint */
+    hint?: string;
+    /** 建议先调用的工具 */
+    suggestedTool?: string;
+    action?: ToolRequirementAction;
+}
+export interface SessionMeta {
+    id: string;
+    title: string;
+    /** 毫秒时间戳 */
+    createdAt: number;
+    /** 毫秒时间戳 */
+    updatedAt: number;
+    messageCount?: number;
 }
 export interface ProviderModelOption {
     label: string;
@@ -135,6 +184,7 @@ export interface ChatSettings {
     mdTableClick?: boolean;
     /** md 内容列表项点击执行，默认开启 */
     mdListClick?: boolean;
+    /** @deprecated 预留字段，当前未实现任何行为 */
     useTools?: boolean;
     /** @deprecated 兼容旧代码，始终镜像当前 provider 的值 */
     apiKey?: string;
@@ -158,6 +208,11 @@ export interface ChatCommand {
 export interface AgentChatOptions {
     toolPackages: ToolPackage[];
     onToolCall?: (call: ToolCallEvent) => Promise<any>;
+    /**
+     * 工具前置条件校验钩子：声明了 requires.check 的工具在执行前会调用它，
+     * 返回 ok:false 时不执行工具，并把结构化结果回给模型。
+     */
+    onCheckToolRequirement?: (ctx: ToolRequirementContext) => ToolRequirementResult | Promise<ToolRequirementResult>;
     provider?: any;
     providerConfig?: Partial<LLMProviderConfig>;
     /** 初始设置项：作为默认值，localStorage 中已保存的设置按字段覆盖 */
@@ -178,6 +233,14 @@ export interface AgentChatOptions {
     maxContextTokens?: number;
     /** 历史消息硬上限(条)，超出仅保留最近 N 条；≤0 表示不限制。默认 60(见 useAgentChat) */
     maxHistoryMessages?: number;
+    /** 单次工具结果写入模型的字符上限；0 表示不限制。默认 30000(见 useAgentChat) */
+    maxToolResultChars?: number;
+    /**
+     * 承载 chat 实例的组件卸载时是否自动 dispose（停止业务事件引擎）。
+     * 默认 false：业务事件按应用级常驻，避免宿主缓存实例后路由往返导致事件失效；
+     * 需要旧的"卸载即清理"行为时显式传 true。
+     */
+    disposeOnUnmount?: boolean;
 }
 export interface BusinessEvent {
     type: string;

package/package.json

@@ -2,7 +2,7 @@
   "name": "agent-tool-chat",
   "description": "An agent-driven chat plugin with ToolPackage architecture and host-controlled execution",
   "author": "kangjinrui <1092014304@qq.com>",
-  "version": "1.2.0",
+  "version": "1.6.0",
   "license": "MIT",
   "private": false,
   "type": "module",
@@ -26,6 +26,7 @@
   ],
   "scripts": {
     "build": "vite build && .\\copy-mp.bat",
+    "build:host": "vite build && node scripts/copy-to-host.mjs",
     "dev": "vite build --watch",
     "prepublishOnly": "npm run build"
   },