agent-tool-chat 1.1.6 → 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,28 +87,119 @@ 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 interface ChatSettings {
+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;
+    value: string;
+}
+export interface ProviderCapabilities {
+    /** 是否支持温度参数，默认 true */
+    temperature?: boolean;
+    /** 是否显示思考模式开关 */
+    thinking?: boolean;
+    /** 是否显示思考强度选择 */
+    reasoningEffort?: boolean;
+    /** 是否支持工具调用，默认 true */
+    tools?: boolean;
+}
+export interface ProviderPreset {
+    id: string;
+    name: string;
+    protocol: 'openai-compatible';
+    defaultBaseUrl: string;
+    defaultModel: string;
+    models: ProviderModelOption[];
+    /** 允许手动输入模型名，默认 true */
+    allowCustomModel?: boolean;
+    apiKeyUrl?: string;
+    capabilities: ProviderCapabilities;
+    /** 提供方私有请求字段注入，如 DeepSeek 的 thinking */
+    buildBody?: (body: Record<string, any>, config: LLMProviderConfig) => void;
+    /** 自定义鉴权头，默认 Bearer */
+    buildHeaders?: (apiKey: string) => Record<string, string>;
+}
+export interface ProviderSettings {
     apiKey: string;
     baseUrl: string;
     model: string;
     temperature: number;
-    useTools?: boolean;
+    thinking: boolean;
+    thinkingEffort: 'low' | 'high' | 'max';
+}
+export interface ChatSettings {
+    /** 当前模型提供方 ID */
+    providerId: string;
     providerMode: 'direct' | 'proxy';
     proxyUrl: string;
-    /** 思考模式（推理/思维链）开关 */
-    thinking?: boolean;
-    /** 思考强度：低/高/最大 */
-    thinkingEffort?: 'low' | 'high' | 'max';
-    /** md 内容表格行点击选择（触发"我选择 X"回灌对话），默认关闭 */
+    /** 各提供方独立配置 */
+    providers: Record<string, ProviderSettings>;
+    /** md 内容表格行点击选择（触发"我选择 X"回灌对话），默认开启 */
     mdTableClick?: boolean;
-    /** md 内容列表项点击执行，默认关闭 */
+    /** md 内容列表项点击执行，默认开启 */
     mdListClick?: boolean;
+    /** @deprecated 预留字段，当前未实现任何行为 */
+    useTools?: boolean;
+    /** @deprecated 兼容旧代码，始终镜像当前 provider 的值 */
+    apiKey?: string;
+    /** @deprecated 兼容旧代码，始终镜像当前 provider 的值 */
+    baseUrl?: string;
+    /** @deprecated 兼容旧代码，始终镜像当前 provider 的值 */
+    model?: string;
+    /** @deprecated 兼容旧代码，始终镜像当前 provider 的值 */
+    temperature?: number;
+    /** @deprecated 兼容旧代码，始终镜像当前 provider 的值 */
+    thinking?: boolean;
+    /** @deprecated 兼容旧代码，始终镜像当前 provider 的值 */
+    thinkingEffort?: 'low' | 'high' | 'max';
 }
+export declare const DEFAULT_PROVIDER_SETTINGS: Record<string, ProviderSettings>;
 export declare const DEFAULT_SETTINGS: ChatSettings;
 export interface ChatCommand {
     label: string;
@@ -111,10 +208,17 @@ 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>;
-    /** 初始设置项：合并到 DEFAULT_SETTINGS（用户已保存的本地设置优先） */
+    /** 初始设置项：作为默认值，localStorage 中已保存的设置按字段覆盖 */
     settings?: Partial<ChatSettings>;
+    /** 扩展模型提供方预设（OpenAI 兼容协议） */
+    providerPresets?: ProviderPreset[];
     systemPrompt?: string;
     storagePrefix?: string;
     /** 上传的文件数据是否发给 LLM，默认 false（仅前端展示） */
@@ -129,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.1.6",
+  "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"
   },