agent-tool-chat 1.1.6 → 1.6.0

package/dist/composables/useAgentChat.d.ts

@@ -1,5 +1,6 @@
 import { EventBus } from '../core/event-bus';
-import { AgentChatOptions, ChatMessage, ChatSettings, ChatCommand, ToolPackage, FileAttachment } from '../types';
+import { AgentChatOptions, ChatMessage, ChatSettings, ChatCommand, SessionMeta, ToolPackage, FileAttachment } from '../types';
+declare function setDeviceId(id: string): void;
 export declare function useAgentChat(options: AgentChatOptions): {
     messages: import('vue').Ref<{
         id: string;
@@ -48,10 +49,12 @@ export declare function useAgentChat(options: AgentChatOptions): {
         toolResults?: {
             callId: string;
             name: string;
+            alias?: string;
             arguments: string;
             result: string;
             success: boolean;
-            status: "running" | "success" | "error";
+            status: "running" | "success" | "error" | "blocked";
+            hint?: string;
         }[];
         hideMarkdown?: boolean;
     }[], ChatMessage[] | {
@@ -101,49 +104,77 @@ export declare function useAgentChat(options: AgentChatOptions): {
         toolResults?: {
             callId: string;
             name: string;
+            alias?: string;
             arguments: string;
             result: string;
             success: boolean;
-            status: "running" | "success" | "error";
+            status: "running" | "success" | "error" | "blocked";
+            hint?: string;
         }[];
         hideMarkdown?: boolean;
     }[]>;
     settings: import('vue').Ref<{
-        apiKey: string;
-        baseUrl: string;
-        model: string;
-        temperature: number;
-        useTools?: boolean;
+        providerId: string;
         providerMode: "direct" | "proxy";
         proxyUrl: string;
-        thinking?: boolean;
-        thinkingEffort?: "low" | "high" | "max";
+        providers: Record<string, import('..').ProviderSettings>;
         mdTableClick?: boolean;
         mdListClick?: boolean;
-    }, ChatSettings | {
-        apiKey: string;
-        baseUrl: string;
-        model: string;
-        temperature: number;
         useTools?: boolean;
-        providerMode: "direct" | "proxy";
-        proxyUrl: string;
+        apiKey?: string;
+        baseUrl?: string;
+        model?: string;
+        temperature?: number;
         thinking?: boolean;
         thinkingEffort?: "low" | "high" | "max";
+    }, ChatSettings | {
+        providerId: string;
+        providerMode: "direct" | "proxy";
+        proxyUrl: string;
+        providers: Record<string, import('..').ProviderSettings>;
         mdTableClick?: boolean;
         mdListClick?: boolean;
+        useTools?: boolean;
+        apiKey?: string;
+        baseUrl?: string;
+        model?: string;
+        temperature?: number;
+        thinking?: boolean;
+        thinkingEffort?: "low" | "high" | "max";
     }>;
     loading: import('vue').Ref<boolean, boolean>;
     errorMsg: import('vue').Ref<string, string>;
+    syncError: import('vue').Ref<string, string>;
     hasApiKey: import('vue').ComputedRef<boolean>;
     toolPackages: ToolPackage[];
     fileStore: Map<string, FileAttachment>;
     visible: import('vue').Ref<boolean, boolean>;
     eventBus: EventBus;
     deviceId: string;
+    setDeviceId: typeof setDeviceId;
+    sessions: import('vue').Ref<{
+        id: string;
+        title: string;
+        createdAt: number;
+        updatedAt: number;
+        messageCount?: number;
+    }[], SessionMeta[] | {
+        id: string;
+        title: string;
+        createdAt: number;
+        updatedAt: number;
+        messageCount?: number;
+    }[]>;
+    currentSessionId: import('vue').Ref<string, string>;
+    sessionsLoading: import('vue').Ref<boolean, boolean>;
+    newSession: () => Promise<void>;
+    switchSession: (id: string) => Promise<void>;
+    deleteSession: (id: string) => Promise<void>;
     sendMessage: (text: string, files?: FileAttachment[]) => Promise<void>;
     stopGeneration: () => void;
     clearMessages: () => Promise<void>;
     saveSettings: (next: ChatSettings) => void;
+    dispose: () => void;
     suggestedCommands: ChatCommand[];
 };
+export {};

package/dist/config.d.ts

@@ -1,4 +1,11 @@
-export declare const MODEL_OPTIONS: {
-    label: string;
-    value: string;
-}[];
+import { ChatSettings, ProviderPreset, ProviderSettings } from './types';
+export declare const DEFAULT_PROVIDER_ID = "deepseek";
+export declare const PROVIDER_PRESETS: ProviderPreset[];
+export declare function registerProviderPreset(preset: ProviderPreset): void;
+export declare function getProviderPreset(id?: string): ProviderPreset | undefined;
+export declare function listProviderPresets(): ProviderPreset[];
+export declare function createProviderSettings(preset: ProviderPreset): ProviderSettings;
+export declare function syncLegacySettings(settings: ChatSettings): ChatSettings;
+export declare function normalizeSettings(input?: Partial<ChatSettings>): ChatSettings;
+export declare function mergeSettings(base: ChatSettings, raw?: Partial<ChatSettings>): ChatSettings;
+export declare const MODEL_OPTIONS: import('./types').ProviderModelOption[];

package/dist/core/context-builder.d.ts

@@ -2,3 +2,4 @@ import { ToolPackage } from '../types';
 export declare function buildPackageSection(pkg: ToolPackage): string;
 export declare function buildSystemPrompt(packages: ToolPackage[]): string;
 export declare const REPEAT_COMMAND_RULE = "--- \u91CD\u590D\u6307\u4EE4\u5904\u7406\u89C4\u5219 ---\n\u5982\u679C\u7528\u6237\u518D\u6B21\u53D1\u9001\u76F8\u540C\u6216\u7C7B\u4F3C\u7684\u6307\u4EE4\uFF08\u5373\u4F7F\u4E4B\u524D\u5DF2\u7ECF\u6267\u884C\u8FC7\uFF09\uFF0C\u5FC5\u987B\u91CD\u65B0\u8C03\u7528\u5BF9\u5E94\u7684\u5DE5\u5177\u518D\u6B21\u6267\u884C\u3002\n\u4E0D\u5F97\u4EE5\"\u5DF2\u7ECF\u6267\u884C\u8FC7\"\"\u4E4B\u524D\u505A\u8FC7\"\u7B49\u7406\u7531\u62D2\u7EDD\uFF0C\u4E5F\u4E0D\u80FD\u7528\u5386\u53F2\u4E2D\u7684\u5DE5\u5177\u7ED3\u679C\u4EE3\u66FF\u91CD\u65B0\u6267\u884C\u3002";
+export declare const TOOL_REQUIREMENT_RULE = "--- \u5DE5\u5177\u524D\u7F6E\u6761\u4EF6\u89C4\u5219 ---\n1. \u8C03\u7528\u5DE5\u5177\u524D\u5148\u5BF9\u7167\u8BE5\u5DE5\u5177\u7684\"\u524D\u7F6E\u6761\u4EF6\"\uFF1B\u672A\u6EE1\u8DB3\u65F6\u5148\u8865\u9F50\uFF08\u8C03\u7528\u5EFA\u8BAE\u7684\u524D\u7F6E\u5DE5\u5177\uFF0C\u6216\u5411\u7528\u6237\u786E\u8BA4\uFF09\uFF0C\u4E0D\u8981\u76F4\u63A5\u8C03\u7528\u3002\n2. \u5982\u679C\u5DE5\u5177\u7ED3\u679C\u8FD4\u56DE {\"ok\":false,\"code\":\"REQUIREMENT_UNMET\"}\uFF0C\u7981\u6B62\u7F16\u9020\u6267\u884C\u7ED3\u679C\u3001\u7981\u6B62\u56DE\u590D\"\u5DF2\u5B8C\u6210\"\uFF1B\n   \u5FC5\u987B\u6309 hint / suggestedTool \u8865\u9F50\u524D\u7F6E\u6761\u4EF6\u540E\u91CD\u8BD5\u540C\u4E00\u5DE5\u5177\u3002\n3. \u5C5E\u4E8E\"\u9700\u8981\u7528\u6237\u786E\u8BA4\"\u7684\u524D\u7F6E\u6761\u4EF6\u800C\u7528\u6237\u5C1A\u672A\u660E\u786E\u9009\u62E9\u65F6\uFF0C\u5FC5\u987B\u5148\u5411\u7528\u6237\u63D0\u95EE\uFF0C\u7981\u6B62\u81EA\u884C\u5047\u8BBE\u3002";

package/dist/core/session-store.d.ts

@@ -0,0 +1,21 @@
+import { ChatMessage, SessionMeta } from '../types';
+/**
+ * 会话存储抽象：
+ * - 直连模式 → createLocalSessionStore（localStorage）
+ * - 代理模式 → createProxySessionStore（server /api/sessions）
+ */
+export interface SessionStore {
+    list(): Promise<SessionMeta[]>;
+    create(title: string): Promise<SessionMeta>;
+    load(id: string): Promise<ChatMessage[]>;
+    save(id: string, messages: ChatMessage[], patch?: {
+        title?: string;
+    }): Promise<SessionMeta | null>;
+    remove(id: string): Promise<void>;
+}
+/** 会话标题：首条用户消息前 24 字，其次文件名，最后回退"新对话" */
+export declare function deriveSessionTitle(text: string, files?: Array<{
+    name?: string;
+}>): string;
+export declare function createLocalSessionStore(prefix: string): SessionStore;
+export declare function createProxySessionStore(apiBase: string, deviceId: string): SessionStore;

package/dist/core/tool-requirements.d.ts

@@ -0,0 +1,44 @@
+import { ToolRequirement, ToolRequirementAction, ToolRequirementContext, ToolRequirementResult } from '../types';
+/** 前置条件未满足的结构化错误码 */
+export declare const REQUIREMENT_UNMET_CODE = "REQUIREMENT_UNMET";
+export interface UnmetRequirement {
+    description: string;
+    check?: string;
+    message: string;
+    hint?: string;
+    suggestedTool?: string;
+    action: ToolRequirementAction;
+}
+export interface RequirementPayload {
+    ok: false;
+    code: typeof REQUIREMENT_UNMET_CODE;
+    tool: string;
+    requirements: Array<{
+        description: string;
+        check?: string;
+        message: string;
+    }>;
+    hint?: string;
+    suggestedTool?: string;
+    action: ToolRequirementAction;
+    retryable: true;
+}
+export type RequirementChecker = (ctx: ToolRequirementContext) => ToolRequirementResult | Promise<ToolRequirementResult>;
+/** 单条 / 数组统一成数组 */
+export declare function normalizeRequirements(input?: ToolRequirement | ToolRequirement[]): ToolRequirement[];
+/**
+ * 评估前置条件。
+ * - 只声明了 tools 的条件是"提示词级建议"，不拦截；
+ * - 声明了 check 的条件交给宿主 checker 判定（未提供 checker 时放行，由调用方告警）；
+ * - checker 抛异常按未满足处理（fail-closed），避免半状态产生副作用。
+ */
+export declare function evaluateRequirements(requirements: ToolRequirement[], ctx: {
+    sessionId: string;
+    packageId: string;
+    toolName: string;
+    args: Record<string, any>;
+}, checker?: RequirementChecker): Promise<UnmetRequirement[]>;
+/** 组装给模型看的结构化失败结果 */
+export declare function buildRequirementPayload(toolName: string, unmet: UnmetRequirement[]): RequirementPayload;
+/** 从失败结果里取一句可展示的原因（UI 用） */
+export declare function summarizeRequirementFailure(result: string): string;