@opentiny/tiny-robot-kit 0.4.2-alpha.3 → 0.4.2-alpha.4

package/dist/core.d.ts

@@ -1,196 +1,9 @@
-import { ChatCompletionMessageParam, ChatCompletionMessageToolCall, ChatCompletion, ChatCompletionChunk, ChatCompletionTool } from 'openai/resources/index';
-import { M as MaybePromise } from './types-D0E0rOVi.js';
+import { z as MessageStateAdapter, J as RequestState, R as RequestProcessingState, o as ChatMessage, r as CreateMessageEngineOptions, s as MessageEngine, t as MessageEnginePlugin } from './skillPlugin-D6X-p9fQ.js';
+export { c as AfterRequestContext, d as BasePluginContext, e as BeforeRequestContext, q as CompletionChunkContext, D as DeepReadonly, I as InternalMessageState, v as MessageMutationRecipe, w as MessageRequestBody, y as MessageRuntime, F as MessageUpdateKind, G as MessageUpdateKinds, H as MutateMessageStateFn, P as PublicMessageState, K as ResponseProvider, L as RuntimeTool, S as SkillCommandExecutor, N as SkillCommandRequest, O as SkillCommandResult, Q as SkillPluginOptions, T as SkillPluginState, U as SkillRuntimeToolsOptions, Y as ToolCallContext, Z as ToolProvider, _ as ToolProviderItem, $ as ToolSource, a0 as compileSkillInstructions, a1 as createSkillRuntimeTools, a2 as skillPlugin, a3 as toolPlugin } from './skillPlugin-D6X-p9fQ.js';
 import { Ref, ComputedRef } from 'vue';
-
-type DeepReadonly<T> = T extends (...args: any[]) => any ? T : T extends Array<infer U> ? ReadonlyArray<DeepReadonly<U>> : T extends object ? {
-    readonly [K in keyof T]: DeepReadonly<T[K]>;
-} : T;
-type RequestState = 'idle' | 'processing' | 'completed' | 'aborted' | 'error';
-type RequestProcessingState = 'requesting' | 'completing' | string;
-type ChatMessage<Metadata extends object = Record<string, unknown>, State extends object = Record<string, unknown>> = ChatCompletionMessageParam & {
-    tool_calls?: Array<ChatCompletionMessageToolCall>;
-    loading?: boolean;
-    metadata?: Metadata;
-    state?: State;
-    [key: string]: any;
-};
-interface MessageRequestBody {
-    messages: Array<ChatMessage>;
-    [key: string]: any;
-}
-type ResponseProvider<T extends ChatCompletion | ChatCompletionChunk = ChatCompletion | ChatCompletionChunk> = (requestBody: MessageRequestBody, abortSignal: AbortSignal) => Promise<T> | AsyncGenerator<T> | Promise<AsyncGenerator<T>>;
-interface PublicMessageState {
-    requestState: RequestState;
-    processingState?: RequestProcessingState;
-    messages: ChatMessage[];
-    isProcessing: boolean;
-}
-interface InternalMessageState {
-    requestState: RequestState;
-    processingState?: RequestProcessingState;
-    messages: ChatMessage[];
-}
-interface MessageRuntime {
-    currentTurn: ChatMessage[];
-    customContext: Record<string, unknown>;
-    abortController: AbortController | null;
-    responseProvider: ResponseProvider;
-}
-interface MessageEngine {
-    getState(): PublicMessageState;
-    subscribe(listener: (state: PublicMessageState) => void): () => void;
-    subscribe(kinds: MessageUpdateKinds, listener: (state: PublicMessageState) => void): () => void;
-    sendMessage(content: string): Promise<void>;
-    send(...msgs: ChatMessage[]): Promise<void>;
-    abort(): Promise<void>;
-    setResponseProvider(provider: ResponseProvider): void;
-}
-type MessageUpdateKind = 'messages' | 'requestState';
-type MessageUpdateKinds = MessageUpdateKind | MessageUpdateKind[];
-type MessageMutationRecipe = (draft: InternalMessageState, skipNotify: () => void) => void;
-interface MutateMessageStateFn {
-    /**
-     * 在受控上下文中修改消息状态，并按声明的更新类型分发状态变更通知。
-     *
-     * 这里的“通知”语义对应 `subscribe` 订阅链路，用于驱动依赖 engine 状态快照的观察者；
-     * 它并不等同于具体框架的响应式更新机制。对于 Vue 等运行时，界面更新可能同时依赖
-     * 框架自身的响应式追踪与 `subscribe` 侧的状态通知，两者职责不同，不应混用。
-     */
-    (kinds: MessageUpdateKinds, recipe: MessageMutationRecipe): void;
-}
-interface MessageStateAdapter {
-    initialize(initialState: InternalMessageState): void;
-    getState(): PublicMessageState;
-    /**
-     * 创建一条适配当前运行时的消息对象。
-     *
-     * engine 和 core 插件里凡是“新建消息”的入口，都应统一走这个方法，
-     * 以便不同平台注入各自的运行时能力。
-     *
-     * 例如：
-     * - native/纯 TS 场景：直接返回原对象即可
-     *   `createMessage(message) { return message }`
-     * - Vue 场景：返回 reactive proxy，使后续对 message.content / message.state 的原地修改能够被追踪
-     *   `createMessage(message) { return reactive(message) }`
-     */
-    createMessage<T extends ChatMessage>(message: T): T;
-    mutate: MutateMessageStateFn;
-    subscribe(listener: (state: PublicMessageState) => void): () => void;
-    subscribe(kinds: MessageUpdateKinds, listener: (state: PublicMessageState) => void): () => void;
-}
-interface BasePluginContext {
-    getState(): PublicMessageState;
-    /**
-     * 创建一条适配当前运行时的消息对象。
-     *
-     * 插件在运行过程中如果需要主动创建并追加消息，应统一通过此接口构造消息实例，
-     * 而不是直接持有普通对象字面量。这样可以确保消息对象具备当前平台所要求的运行时能力。
-     *
-     * 对于采用响应式机制的平台（例如 Vue），该接口通常会返回带有响应式包装的消息实例。
-     * 如果插件绕过此接口直接创建普通对象，再参与后续的状态更新或原地字段修改，
-     * 可能导致消息内容、状态字段等变更无法被正确追踪。
-     */
-    createMessage<T extends ChatMessage>(message: T): T;
-    /**
-     * 在受控上下文中修改状态，并触发与 `subscribe` 对应的状态更新通知。
-     *
-     * 该通知机制面向 engine 的订阅接口，而不是具体框架的响应式系统本身。
-     * 因此，在需要让 `subscribe` 观察者感知到变更时，应通过此接口完成状态写入。
-     */
-    mutate: MutateMessageStateFn;
-    abortSignal: AbortSignal;
-    currentTurn: ChatMessage[];
-    customContext: Record<string, unknown>;
-    setRequestState: (state: RequestState, processingState?: RequestProcessingState) => void;
-    setCustomContext: (data: Record<string, unknown>) => void;
-}
-interface BeforeRequestContext extends BasePluginContext {
-    requestBody: MessageRequestBody;
-}
-interface AfterRequestContext extends BasePluginContext {
-    currentMessage: DeepReadonly<ChatMessage>;
-    lastChoice?: ChatCompletion.Choice | ChatCompletionChunk.Choice;
-    /**
-     * 使用 appendMessage 函数追加消息，可触发消息更新通知。
-     */
-    appendMessage: (message: ChatMessage | ChatMessage[]) => void;
-    requestNext: () => void;
-}
-interface CompletionChunkContext extends BasePluginContext {
-    /**
-     * 当前消息，只读。需要使用 updateCurrentMessage 函数修改当前消息，才能正常触发消息更新通知。
-     */
-    currentMessage: DeepReadonly<ChatMessage>;
-    /**
-     * 使用 updateCurrentMessage 函数修改当前消息，才能正常触发消息更新通知。
-     */
-    updateCurrentMessage: (recipe: (message: ChatMessage) => void) => void;
-    choice: ChatCompletion.Choice | ChatCompletionChunk.Choice;
-    chunk: ChatCompletion | ChatCompletionChunk;
-}
-interface MessageEnginePlugin {
-    /**
-     * 插件名称。
-     */
-    name?: string;
-    /**
-     * 是否禁用插件。
-     */
-    disabled?: boolean | ((context: BasePluginContext) => boolean);
-    /**
-     * 一次对话回合（turn）开始钩子：用户消息入队后、正式发起请求之前触发。
-     * 按插件注册顺序串行执行，便于做有序初始化/校验；出错则中断流程。
-     */
-    onTurnStart?: (context: BasePluginContext) => MaybePromise<void>;
-    /**
-     * 一次对话回合（turn）结束的生命周期钩子。
-     * 触发时机：本轮对话完成（成功、被中止）后。
-     * 执行策略：按插件注册顺序串行执行，有错误则中断流程。
-     */
-    onTurnEnd?: (context: BasePluginContext) => MaybePromise<void>;
-    /**
-     * 请求开始前的生命周期钩子。
-     * 触发时机：已组装 requestBody，正式发起请求之前。
-     * 执行策略：按插件注册顺序串行执行，避免并发修改 requestBody 产生冲突。
-     */
-    onBeforeRequest?: (context: BeforeRequestContext) => MaybePromise<void>;
-    /**
-     * 请求完成后的生命周期钩子。
-     * 触发时机：本次请求（含流式）结束后。
-     * 执行策略：并行执行（Promise.all）。
-     */
-    onAfterRequest?: (context: AfterRequestContext) => MaybePromise<void>;
-    /**
-     * 数据块处理钩子，在接收到每个响应数据块时触发。
-     * 无论是流式响应（多个增量数据块）还是非流式响应（单个完整数据块），都会触发此钩子。
-     */
-    onCompletionChunk?: (context: CompletionChunkContext) => void;
-    onError?: (context: BasePluginContext & {
-        error: unknown;
-    }) => void;
-    onFinally?: (context: BasePluginContext) => void;
-}
-interface CreateMessageEngineOptions {
-    initialMessages?: ChatMessage[];
-    /**
-     * 请求消息时，要包含的字段（白名单）。默认包含所有字段。
-     * 如果 `requestMessageFieldsExclude` 存在，会先取 `requestMessageFields` 中的字段，再排除 `requestMessageFieldsExclude` 中的字段
-     */
-    requestMessageFields?: string[];
-    /**
-     * 请求消息时，要排除的字段（黑名单）。默认会排除 `state`、`metadata`、`loading` 字段（这几个字段是给UI展示用的）。
-     * 如果 `requestMessageFields` 存在，会先取 `requestMessageFields` 中的字段，再排除 `requestMessageFieldsExclude` 中的字段
-     */
-    requestMessageFieldsExclude?: string[];
-    responseProvider?: ResponseProvider;
-    /**
-     * 全局的数据块处理钩子，在接收到每个响应数据块时触发。
-     * 注意：此钩子与插件中的 onCompletionChunk 有区别。
-     * 如果传入了此参数，默认的 chunk 处理逻辑不会自动执行，需要手动调用 runDefault 来执行默认处理逻辑。
-     */
-    onCompletionChunk?: (context: CompletionChunkContext, runDefault: () => void) => void;
-    plugins?: MessageEnginePlugin[];
-}
+import { b as SkillFile, S as SkillDefinition } from './types-ChCZ8jKB.js';
+export { B as BaseSkillFile, a as BinarySkillFile, c as SkillFileKind, d as SkillFileResource, T as TextSkillFile } from './types-ChCZ8jKB.js';
+import 'openai/resources';
 
 declare const createNativeMessageAdapter: () => MessageStateAdapter;
 
@@ -210,72 +23,120 @@ declare const lengthPlugin: (options?: MessageEnginePlugin & {
 
 declare const thinkingPlugin: (options?: MessageEnginePlugin) => MessageEnginePlugin;
 
-type AssistantMessageWithState = ChatMessage<Record<string, unknown>, {
-    toolCall?: Record<string, Record<string, unknown>>;
-}>;
-type ToolCallContext = BasePluginContext & {
-    assistantMessage: AssistantMessageWithState;
-    toolMessage: ChatMessage;
+declare function normalizeToAsyncGenerator<T>(result: T | Promise<T> | AsyncGenerator<T> | Promise<AsyncGenerator<T>>): AsyncGenerator<T>;
+/**
+ * Merge delta data from completion responses
+ * Handles string concatenation, object merging, and array merging by index
+ *
+ * @param target - Target object to merge into
+ * @param source - Source object to merge from
+ * @returns Merged target object
+ */
+declare const combineDeltaData: (target: Record<string, any>, source: Record<string, any>) => Record<string, any>;
+
+type BrowserFile = Pick<File, 'arrayBuffer' | 'lastModified' | 'name' | 'size' | 'text' | 'type'> & {
+    webkitRelativePath?: string;
 };
-declare const toolPlugin: (options: MessageEnginePlugin & {
-    /**
-     * 获取工具列表的函数。会在请求大模型前调用。
-     */
-    getTools: () => Promise<ChatCompletionTool[]>;
-    /**
-     * 在处理包含 tool_calls 的响应前调用。
-     */
-    beforeCallTools?: (toolCalls: ChatCompletionMessageToolCall[], context: BasePluginContext & {
-        assistantMessage: AssistantMessageWithState;
-    }) => Promise<void>;
-    /**
-     * 执行单个工具调用并返回其文本结果的函数。
-     */
-    callTool: (toolCall: ChatCompletionMessageToolCall, context: ToolCallContext) => Promise<string | Record<string, any>> | AsyncGenerator<string | Record<string, any>>;
-    /**
-     * 工具调用开始时的回调函数。
-     * 触发时机：工具消息已创建并追加后，调用 callTool 之前触发。
-     * @param toolCall - 工具调用对象
-     * @param context - 插件上下文，包含当前工具消息
-     */
-    onToolCallStart?: (toolCall: ChatCompletionMessageToolCall, context: ToolCallContext) => void;
+type BrowserFileHandle = {
+    kind: 'file';
+    name: string;
+    getFile: () => Promise<BrowserFile>;
+};
+type BrowserDirectoryHandle = {
+    kind: 'directory';
+    name: string;
+    entries: () => AsyncIterable<[string, BrowserFileHandle | BrowserDirectoryHandle]>;
+};
+/**
+ * Browser FileList 适配器，用于读取文件选择器选中的 skill 目录。
+ */
+declare const loadSkillFilesFromFileList: (fileList: ArrayLike<BrowserFile>) => Promise<SkillFile[]>;
+/**
+ * Browser FileSystemDirectoryHandle 适配器，用于读取 window.showDirectoryPicker() 选中的目录。
+ */
+declare const loadSkillFilesFromDirectoryHandle: (directoryHandle: BrowserDirectoryHandle) => Promise<SkillFile[]>;
+
+interface SkillLoaderResult {
+    /**
+     * 从源文件解析出的 skill 定义。
+     */
+    skill: SkillDefinition;
+    /**
+     * 非致命的加载警告。
+     */
+    warnings: Array<{
+        /**
+         * 用于 UI 和日志分类的警告编码。
+         */
+        code: string;
+        /**
+         * 人类可读的警告信息。
+         */
+        message: string;
+        /**
+         * 关联的 skill 文件路径。
+         */
+        path?: string;
+    }>;
+}
+interface SkillLoaderOptions {
     /**
-     * 工具调用结束时的回调函数。
-     * 触发时机：工具调用完成（成功、失败或取消）时触发。
-     * @param toolCall - 工具调用对象
-     * @param context - 插件上下文，包含当前工具消息、状态和错误信息
-     * @param context.status - 工具调用状态：'success' | 'failed' | 'cancelled'
-     * @param context.error - 当状态为 'failed' 或 'cancelled' 时，可能包含错误信息
+     * skill 入口文件名。
      */
-    onToolCallEnd?: (toolCall: ChatCompletionMessageToolCall, context: ToolCallContext & {
-        status: "success" | "failed" | "cancelled";
-        error?: Error;
-    }) => void;
+    entryFile?: string;
     /**
-     * 当请求被中止时用于工具调用取消的消息内容。
+     * 启用后，警告会直接抛出为错误。
      */
-    toolCallCancelledContent?: string;
+    strict?: boolean;
+}
+/**
+ * 将标准化后的 skill 文件转换为 SkillDefinition。
+ *
+ * 文件来源适配器负责提供 SkillFile[]；该 loader 负责解析入口文件和资源文件。
+ */
+declare class SkillLoader {
+    private entryFile;
+    private strict;
+    constructor(options?: SkillLoaderOptions);
+    load(files: SkillFile[]): SkillLoaderResult;
+    private normalizeFiles;
+    private handleWarning;
+}
+
+type SkillManagerOptions = {
     /**
-     * 当工具调用执行失败（抛错或拒绝）时使用的消息内容。
+     * 初始化时写入 manager 的 skill 列表。
      */
-    toolCallFailedContent?: string;
+    skills?: SkillDefinition[];
     /**
-     * 是否在请求前自动补充缺失的 tool 消息。
-     * 当 assistant 响应了 tool_calls 但未追加对应的 tool 消息时，
-     * 插件将自动补充"工具调用已取消"的 tool 消息。默认：false。
+     * 初始化时选中的 skill 名称。
      */
-    autoFillMissingToolMessages?: boolean;
-}) => MessageEnginePlugin;
-
-declare function normalizeToAsyncGenerator<T>(result: Promise<T> | AsyncGenerator<T> | Promise<AsyncGenerator<T>>): AsyncGenerator<T>;
+    selectedSkillNames?: string[];
+};
 /**
- * Merge delta data from completion responses
- * Handles string concatenation, object merging, and array merging by index
+ * 管理 skill 集合和选择状态。
  *
- * @param target - Target object to merge into
- * @param source - Source object to merge from
- * @returns Merged target object
+ * manager 不编译 prompt 或 tools，也不接入 message 生命周期。
  */
-declare const combineDeltaData: (target: Record<string, any>, source: Record<string, any>) => Record<string, any>;
+declare class SkillManager {
+    private skills;
+    private selectedSkillNames;
+    constructor(options?: SkillManagerOptions);
+    set(skill: SkillDefinition): SkillDefinition;
+    remove(name: string): SkillDefinition | undefined;
+    clear(): void;
+    get(name: string): SkillDefinition | undefined;
+    has(name: string): boolean;
+    list(): SkillDefinition[];
+    select(names: string | string[]): void;
+    unselect(names: string | string[]): void;
+    getSelectedSkillNames(): string[];
+    getSelectedSkills(): SkillDefinition[];
+    import(files: SkillFile[], options?: SkillLoaderOptions): SkillLoaderResult;
+}
+
+declare const normalizeSkillPath: (path: string) => string | null;
+declare const isTextSkillFilePath: (path: string) => boolean;
+declare const getExtension: (path: string) => string;
 
-export { type AfterRequestContext, type BasePluginContext, type BeforeRequestContext, type ChatMessage, type CompletionChunkContext, type CreateMessageEngineOptions, type DeepReadonly, type InternalMessageState, type MessageEngine, type MessageEnginePlugin, type MessageMutationRecipe, type MessageRequestBody, type MessageRuntime, type MessageStateAdapter, type MessageUpdateKind, type MessageUpdateKinds, type MutateMessageStateFn, type PublicMessageState, type RequestProcessingState, type RequestState, type ResponseProvider, type VueMessageStateAdapter, combineDeltaData, createMessageEngine, createNativeMessageAdapter, createVueMessageAdapter, lengthPlugin, normalizeToAsyncGenerator, thinkingPlugin, toolPlugin };
+export { type BrowserDirectoryHandle, type BrowserFile, type BrowserFileHandle, ChatMessage, CreateMessageEngineOptions, MessageEngine, MessageEnginePlugin, MessageStateAdapter, RequestProcessingState, RequestState, SkillDefinition, SkillFile, SkillLoader, type SkillLoaderOptions, type SkillLoaderResult, SkillManager, type SkillManagerOptions, type VueMessageStateAdapter, combineDeltaData, createMessageEngine, createNativeMessageAdapter, createVueMessageAdapter, getExtension, isTextSkillFilePath, lengthPlugin, loadSkillFilesFromDirectoryHandle, loadSkillFilesFromFileList, normalizeSkillPath, normalizeToAsyncGenerator, thinkingPlugin };

package/dist/core.js

@@ -1 +1,6 @@
-"use strict";var X=Object.defineProperty;var ge=Object.getOwnPropertyDescriptor;var fe=Object.getOwnPropertyNames;var de=Object.prototype.hasOwnProperty;var pe=(e,t)=>{for(var s in t)X(e,s,{get:t[s],enumerable:!0})},me=(e,t,s,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of fe(t))!de.call(e,o)&&o!==s&&X(e,o,{get:()=>t[o],enumerable:!(n=ge(t,o))||n.enumerable});return e};var Me=e=>me(X({},"__esModule",{value:!0}),e);var Te={};pe(Te,{combineDeltaData:()=>B,createMessageEngine:()=>ce,createNativeMessageAdapter:()=>he,createVueMessageAdapter:()=>ye,lengthPlugin:()=>H,normalizeToAsyncGenerator:()=>O,thinkingPlugin:()=>Q,toolPlugin:()=>le});module.exports=Me(Te);var Ce=e=>typeof e=="function"?null:Array.isArray(e)?e.length>0?new Set(e):null:new Set([e]),$=e=>{let t=new Set,s=(a,l)=>{try{a.listener(l)}catch(m){console.error("Error in message state subscriber:",m)}};return{notify:a=>{let l=new Set(Array.isArray(a)?a:[a]),m=e(),d=Array.from(t);for(let r of d){if(r.kinds){let u=!1;for(let y of r.kinds)if(l.has(y)){u=!0;break}if(!u)continue}s(r,m)}},subscribe:(a,l)=>{let m=typeof a=="function"?a:l;if(!m)throw new Error("subscribe listener is required");let d={kinds:Ce(a),listener:m};return t.add(d),s(d,e()),()=>{t.delete(d)}}}};var he=()=>{let e=!1,t,s=l=>{if(e)throw new Error("Message state adapter is already initialized");t={requestState:l.requestState,processingState:l.processingState,messages:[...l.messages]},e=!0},n=()=>{if(!e)throw new Error("Message state adapter is not initialized");return{requestState:t.requestState,processingState:t.processingState,messages:[...t.messages],isProcessing:t.requestState==="processing"}},o=$(n);return{initialize:s,getState:n,createMessage(l){return l},mutate:(l,m)=>{if(!e)throw new Error("Message state adapter is not initialized");let d=!1;m(t,()=>{d=!0}),d||o.notify(l)},subscribe:o.subscribe}};var w=require("vue");var se=e=>(0,w.reactive)(e),Y=e=>{let t=(0,w.isProxy)(e)?(0,w.toRaw)(e):e;if(Array.isArray(t))return t.map(s=>Y(s));if(t&&typeof t=="object"){let s={};for(let[n,o]of Object.entries(t))s[n]=Y(o);return s}return t},ye=()=>{let e=!1,t=(0,w.ref)("idle"),s=(0,w.ref)(void 0),n=(0,w.ref)([]),o=(0,w.computed)(()=>t.value==="processing"),a=u=>{if(e)throw new Error("Message state adapter is already initialized");t.value=u.requestState,s.value=u.processingState,n.value=u.messages.map(se),e=!0},l=u=>se(u),m=()=>{if(!e)throw new Error("Message state adapter is not initialized");return{requestState:t.value,processingState:s.value,messages:Y(n.value),isProcessing:o.value}},d=$(m);return{requestState:t,processingState:s,messages:n,isProcessing:o,initialize:a,getState:m,createMessage:l,mutate:(u,y)=>{if(!e)throw new Error("Message state adapter is not initialized");let T={get requestState(){return t.value},set requestState(S){t.value=S},get processingState(){return s.value},set processingState(S){s.value=S},get messages(){return n.value},set messages(S){n.value=S.map(l)}},p=!1;if(y(T,()=>{p=!0}),p)return;(Array.isArray(u)?u:[u]).includes("messages")&&(n.value=[...n.value]),d.notify(u)},subscribe:d.subscribe}};var H=(e={})=>{let{continueContent:t="Please continue with your previous answer.",...s}=e;return{name:"length",...s,onAfterRequest:async n=>{let{lastChoice:o,appendMessage:a,requestNext:l}=n;return o?.finish_reason==="length"&&(a({role:"user",content:t}),l()),s.onAfterRequest?.(n)}}};var Q=(e={})=>{let t=(s,n)=>!!s.thinking!==n||!!s.open!==n;return{name:"thinking",...e,onCompletionChunk(s){let{choice:n,currentMessage:o,updateCurrentMessage:a}=s,l=n,m=l?.message?.reasoning_content||l?.delta?.reasoning_content,d=typeof m=="string"&&m.trim()!=="";return d?o.state&&typeof o.state=="object"?t(o.state,d)&&a(r=>{r.state.thinking=!0,r.state.open=!0}):a(r=>{r.state={thinking:d,open:d}}):o.state&&typeof o.state=="object"&&"thinking"in o.state&&t(o.state,d)&&a(r=>{r.state.thinking=!1,r.state.open=!1}),e.onCompletionChunk?.(s)},onTurnEnd(s){let{currentTurn:n,mutate:o}=s,a=n.at(-1);return a?.state&&typeof a.state=="object"&&"thinking"in a.state&&t(a.state,!1)&&o("messages",()=>{a.state.thinking=!1,a.state.open=!1}),e.onTurnEnd?.(s)}}};var N=class extends Error{constructor(t){super(t),this.name="AbortError"}};function Se(e){if(e.aborted)return{promise:Promise.reject(new N(String(e.reason??"Aborted"))),cleanup:()=>{}};let t=null;return{promise:new Promise((o,a)=>{t=()=>{a(new N(String(e.reason??"Aborted")))},e.addEventListener("abort",t,{once:!0})}),cleanup:()=>{t&&(e.removeEventListener("abort",t),t=null)}}}function ae(e,t){let{promise:s,cleanup:n}=Se(t);return Promise.race([e,s]).finally(n)}function re(e,t){let s={};for(let n in e)t.includes(n)&&(s[n]=e[n]);return s}function ie(e,t){let s={};for(let n in e)t.includes(n)||(s[n]=e[n]);return s}async function*O(e){if(ne(e)){yield*e;return}let t=await e;if(ne(t)){yield*t;return}yield t}function ne(e){return e&&typeof e=="object"&&typeof e[Symbol.asyncIterator]=="function"}var Z=e=>typeof e=="object"&&e!==null,oe=e=>Z(e)&&typeof e.index=="number",B=(e,t)=>{for(let[s,n]of Object.entries(t)){let o=e[s];if(o)if(typeof o=="string"&&typeof n=="string")s==="type"&&o||(e[s]=o+n);else if(Array.isArray(o)&&Array.isArray(n))if(o.every(a=>oe(a))&&n.every(a=>oe(a))){let a=new Map(o.map(r=>[r.index,r])),l=new Map(n.map(r=>[r.index,r]));for(let[r,u]of l)if(a.has(r)){let y=a.get(r);a.set(r,B(y,u))}else a.set(r,u);let m=Math.max(...Array.from(a.keys()),-1)+1,d=m>o.length?Array.from({length:m}):o;for(let[r,u]of a)d[r]=u;e[s]=d}else e[s]=[...o,...n];else Z(o)&&Z(n)&&(e[s]=B(o,n));else e[s]=n}return e};function be({messages:e,cancelledContent:t,createMessage:s,mutate:n}){let o=[];for(let a=0;a<e.length;a++){let l=e[a];if(l.role==="assistant"&&l.tool_calls&&l.tool_calls.length>0){let m=new Set(l.tool_calls.map(u=>u.id)),d=new Set;for(let u=a+1;u<e.length;u++){let y=e[u];y.role==="tool"&&y.tool_call_id&&m.has(y.tool_call_id)&&d.add(y.tool_call_id)}let r=l.tool_calls.map(u=>u.id).filter(u=>!d.has(u));r.length>0&&o.push({insertAfterIndex:a,missingToolCallIds:r})}}o.length!==0&&n("messages",a=>{for(let l=o.length-1;l>=0;l--){let{insertAfterIndex:m,missingToolCallIds:d}=o[l],r=d.map(u=>s({role:"tool",tool_call_id:u,content:t}));a.messages.splice(m+1,0,...r)}})}var le=e=>{let{getTools:t,beforeCallTools:s,callTool:n,onToolCallStart:o,onToolCallEnd:a,toolCallCancelledContent:l="Tool call cancelled.",toolCallFailedContent:m="Tool call failed.",autoFillMissingToolMessages:d=!1,...r}=e,u=(p,M)=>{var C,S;return p.state??(p.state={}),(C=p.state).toolCall??(C.toolCall={}),(S=p.state.toolCall)[M]??(S[M]={}),p},y=(...p)=>{let[M,{assistantMessage:C,mutate:S}]=p;S("messages",()=>{let R=u(C,M.id);R.state.toolCall[M.id].status="running"}),o?.(...p)},T=(...p)=>{let[M,{status:C,assistantMessage:S,mutate:R}]=p;R("messages",()=>{let W=u(S,M.id);W.state.toolCall[M.id].status=C}),a?.(...p)};return{name:"tool",...r,onTurnStart:p=>{let{getState:M,createMessage:C,mutate:S}=p,R=M().messages;return d&&be({messages:R,cancelledContent:l,createMessage:C,mutate:S}),r.onTurnStart?.(p)},onBeforeRequest:async p=>{let{requestBody:M}=p,C=await t();return C&&C.length>0&&(M.tools=C),r.onBeforeRequest?.(p)},onAfterRequest:async p=>{let{currentMessage:M,lastChoice:C,appendMessage:S,abortSignal:R,setRequestState:W,requestNext:v,mutate:F,createMessage:E}=p;if(C?.finish_reason!=="tool_calls"||!M.tool_calls?.length)return;W("processing","calling-tools"),await s?.(M.tool_calls,{...p,assistantMessage:M});let U=M.tool_calls.map(async j=>{let G=Math.floor(Date.now()/1e3),J=!1,x=E({role:"tool",tool_call_id:j.id,content:"",metadata:{createdAt:G,updatedAt:G}});S(x);let K={...p,assistantMessage:M,toolMessage:x};y(j,K);try{let i=n(j,K),c=O(i);for await(let f of c)F("messages",()=>{if((typeof f=="string"&&f.length>0||f&&typeof f=="object"&&Object.keys(f).length>0)&&(J=!0),typeof f=="string")x.content+=f;else{let h={};try{let b=Array.isArray(x.content)?x.content.map(g=>g.text).join(""):x.content;h=JSON.parse(b||"{}")}catch(b){console.warn(b)}x.content=JSON.stringify(B(h,f))}x.metadata.updatedAt=Math.floor(Date.now()/1e3)});T(j,{...K,status:"success"})}catch(i){let c=i instanceof Error?i:new Error(String(i));if(R.aborted){T(j,{...K,status:"cancelled",error:c});return}console.error(i),J||F("messages",()=>{x.content=m,x.metadata.updatedAt=Math.floor(Date.now()/1e3)}),T(j,{...K,status:"failed",error:c})}});return await Promise.all(U),R.aborted||v(),r.onAfterRequest?.(p)}}};var Pe=async()=>{throw new Error("Response provider is not set")},Ae=e=>{let t=[];for(let s of e){if(s.name){let n=t.findIndex(o=>o.name===s.name);n!==-1&&t.splice(n,1)}t.push(s)}return t},z=(e,t)=>typeof e.disabled=="function"?e.disabled(t):!!e.disabled,ce=(e,t={})=>{let{initialMessages:s=[],requestMessageFields:n=[],requestMessageFieldsExclude:o=["state","metadata","loading"],responseProvider:a=Pe,onCompletionChunk:l,plugins:m=[]}=t,d={requestState:"idle",processingState:void 0,messages:[...s]};e.initialize(d);let r={currentTurn:[],customContext:{},abortController:null,responseProvider:a},u=[Q(),H()],y=Ae(u.concat(m)),T=()=>e.getState(),p=i=>e.createMessage(i),M=e.subscribe,C=e.mutate,S=i=>!i||Object.keys(i).length===0?!1:Object.values(i).some(c=>!!c),R=i=>{let c=i;return n.length&&(c=c.map(f=>re(f,n))),o.length&&(c=c.map(f=>ie(f,o))),c},W=i=>{Object.assign(r.customContext,i)},v=(i,c)=>{C("requestState",(f,h)=>{if(f.requestState===i&&f.processingState===c){h();return}f.requestState=i,f.processingState=i==="processing"?c??"requesting":void 0})},F=(...i)=>{let c=i.map(f=>p(f));return C("messages",f=>{f.messages.push(...c)}),r.currentTurn.push(...c),c},E=i=>({getState:T,createMessage:p,mutate:C,abortSignal:i,currentTurn:r.currentTurn,customContext:r.customContext,setRequestState:v,setCustomContext:W});async function U(i,c,f={}){v("processing","requesting");let h={messages:T().messages},b=E(c);for(let _ of y.filter(A=>!z(A,b)))await _.onBeforeRequest?.({...b,requestBody:h});h.messages=R(h.messages);let g={role:"assistant",content:"",loading:!0};[g]=F(g),f.setAssistantMessage?.(g);let P=i(h,c),k=O(P),I;for await(let _ of k){v("processing","completing"),C("messages",(q,V)=>{g.loading?g.loading=void 0:V()});let A=(_.choices||[]).find(q=>q.index===0)??_.choices?.[0];if(!A)continue;I=A;let D=()=>{C("messages",()=>{g.metadata||(g.metadata={});let{created:q,...V}=_;g.metadata.createdAt=q,g.metadata.updatedAt=Math.floor(Date.now()/1e3),Object.assign(g.metadata,V);let L="delta"in A&&S(A.delta)&&A.delta||"message"in A&&S(A.message)&&A.message||null;if(L?.role&&(g.role=L.role),L){let{role:xe,...ue}=L;B(g,ue)}})},ee=q=>{C("messages",()=>{q(g)})};if(l){let q=E(c);l({...q,chunk:_,choice:A,currentMessage:g,updateCurrentMessage:ee},D)}else D();let te=E(c);for(let q of y.filter(V=>!z(V,te)))q.onCompletionChunk?.({...te,abortSignal:c,chunk:_,choice:A,currentMessage:g,updateCurrentMessage:ee})}await j(g,i,c,I,f)}async function j(i,c,f,h,b){let g=!1,P=E(f),k=y.filter(I=>!z(I,P)).map(I=>{if(!I.onAfterRequest)return null;let _=D=>{F(...Array.isArray(D)?D:[D])},A=()=>{g=!0};return I.onAfterRequest({...P,currentMessage:i,lastChoice:h,appendMessage:_,requestNext:A})}).filter(I=>I!==null);await ae(Promise.all(k),f),g&&await U(c,f,b)}async function G(){let i=new AbortController;r.abortController=i,r.customContext={};let c=null,f=h=>{c=h};try{v("processing","requesting");let h=E(i.signal);for(let P of y.filter(k=>!z(k,h)))await P.onTurnStart?.(h);let b=r.responseProvider;try{await U(b,i.signal,{setAssistantMessage:f}),v("completed")}catch(P){if(i.signal.aborted||P instanceof N||P instanceof Error&&P.name==="AbortError")v("aborted");else throw P}let g=E(i.signal);for(let P of y.filter(k=>!z(k,g)))await P.onTurnEnd?.(g)}catch(h){v("error");let b=!1,g=E(i.signal);for(let P of y.filter(k=>!z(k,g)))P.onError&&(b=!0,P.onError({...g,error:h}));if(!b)throw h}finally{let h=E(i.signal);for(let b of y.filter(g=>!z(g,h)))try{b.onFinally?.(h)}catch(g){console.error(`Error in onFinally hook for plugin [${b.name||"Anonymous"}]:`,g)}r.abortController=null,r.currentTurn=[],C("messages",(b,g)=>{c?.loading?c.loading=void 0:g()})}}async function J(i){if(!i||!i.trim()){console.warn("Cannot send empty message");return}if(T().requestState==="processing"){console.warn("Cannot send message while processing is in progress");return}let c=Math.floor(Date.now()/1e3);F({role:"user",content:i.trim(),metadata:{createdAt:c,updatedAt:c}}),await G()}async function x(...i){if(T().requestState==="processing"){console.warn("Cannot send message while processing is in progress");return}F(...i),await G()}async function K(){r.abortController?.abort(),T().isProcessing&&await new Promise(i=>{let c=()=>{};c=M("requestState",f=>{f.isProcessing||(c(),i())})})}return{getState:T,subscribe:M,sendMessage:J,send:x,abort:K,setResponseProvider(i){r.responseProvider=i}}};0&&(module.exports={combineDeltaData,createMessageEngine,createNativeMessageAdapter,createVueMessageAdapter,lengthPlugin,normalizeToAsyncGenerator,thinkingPlugin,toolPlugin});
+"use strict";var re=Object.defineProperty;var ve=Object.getOwnPropertyDescriptor;var Ee=Object.getOwnPropertyNames;var qe=Object.prototype.hasOwnProperty;var Be=(e,t)=>{for(var s in t)re(e,s,{get:t[s],enumerable:!0})},_e=(e,t,s,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let i of Ee(t))!qe.call(e,i)&&i!==s&&re(e,i,{get:()=>t[i],enumerable:!(n=ve(t,i))||n.enumerable});return e};var Ie=e=>_e(re({},"__esModule",{value:!0}),e);var Ze={};Be(Ze,{SkillLoader:()=>J,SkillManager:()=>ie,combineDeltaData:()=>D,compileSkillInstructions:()=>ne,createMessageEngine:()=>Pe,createNativeMessageAdapter:()=>De,createSkillRuntimeTools:()=>se,createVueMessageAdapter:()=>ze,getExtension:()=>Q,isTextSkillFilePath:()=>U,lengthPlugin:()=>te,loadSkillFilesFromDirectoryHandle:()=>we,loadSkillFilesFromFileList:()=>xe,normalizeSkillPath:()=>V,normalizeToAsyncGenerator:()=>H,skillPlugin:()=>ye,thinkingPlugin:()=>oe,toolPlugin:()=>Te});module.exports=Ie(Ze);var Ne=e=>typeof e=="function"?null:Array.isArray(e)?e.length>0?new Set(e):null:new Set([e]),ee=e=>{let t=new Set,s=(o,r)=>{try{o.listener(r)}catch(c){console.error("Error in message state subscriber:",c)}};return{notify:o=>{let r=new Set(Array.isArray(o)?o:[o]),c=e(),p=Array.from(t);for(let a of p){if(a.kinds){let u=!1;for(let M of a.kinds)if(r.has(M)){u=!0;break}if(!u)continue}s(a,c)}},subscribe:(o,r)=>{let c=typeof o=="function"?o:r;if(!c)throw new Error("subscribe listener is required");let p={kinds:Ne(o),listener:c};return t.add(p),s(p,e()),()=>{t.delete(p)}}}};var De=()=>{let e=!1,t,s=r=>{if(e)throw new Error("Message state adapter is already initialized");t={requestState:r.requestState,processingState:r.processingState,messages:[...r.messages]},e=!0},n=()=>{if(!e)throw new Error("Message state adapter is not initialized");return{requestState:t.requestState,processingState:t.processingState,messages:[...t.messages],isProcessing:t.requestState==="processing"}},i=ee(n);return{initialize:s,getState:n,createMessage(r){return r},mutate:(r,c)=>{if(!e)throw new Error("Message state adapter is not initialized");let p=!1;c(t,()=>{p=!0}),p||i.notify(r)},subscribe:i.subscribe}};var v=require("vue");var de=e=>(0,v.reactive)(e),ae=e=>{let t=(0,v.isProxy)(e)?(0,v.toRaw)(e):e;if(Array.isArray(t))return t.map(s=>ae(s));if(t&&typeof t=="object"){let s={};for(let[n,i]of Object.entries(t))s[n]=ae(i);return s}return t},ze=()=>{let e=!1,t=(0,v.ref)("idle"),s=(0,v.ref)(void 0),n=(0,v.ref)([]),i=(0,v.computed)(()=>t.value==="processing"),o=u=>{if(e)throw new Error("Message state adapter is already initialized");t.value=u.requestState,s.value=u.processingState,n.value=u.messages.map(de),e=!0},r=u=>de(u),c=()=>{if(!e)throw new Error("Message state adapter is not initialized");return{requestState:t.value,processingState:s.value,messages:ae(n.value),isProcessing:i.value}},p=ee(c);return{requestState:t,processingState:s,messages:n,isProcessing:i,initialize:o,getState:c,createMessage:r,mutate:(u,M)=>{if(!e)throw new Error("Message state adapter is not initialized");let F={get requestState(){return t.value},set requestState(_){t.value=_},get processingState(){return s.value},set processingState(_){s.value=_},get messages(){return n.value},set messages(_){n.value=_.map(r)}},z=!1;if(M(F,()=>{z=!0}),z)return;(Array.isArray(u)?u:[u]).includes("messages")&&(n.value=[...n.value]),p.notify(u)},subscribe:p.subscribe}};var te=(e={})=>{let{continueContent:t="Please continue with your previous answer.",...s}=e;return{name:"length",...s,onAfterRequest:async n=>{let{lastChoice:i,appendMessage:o,requestNext:r}=n;return i?.finish_reason==="length"&&(o({role:"user",content:t}),r()),s.onAfterRequest?.(n)}}};var pe={listSkillFiles:"list_skill_files",readSkillFile:"read_skill_file"},Oe="execute_skill_command",fe=[{type:"function",function:{name:pe.listSkillFiles,description:"List files available from the current skills.",parameters:{type:"object",properties:{skillName:{type:"string",description:"Optional skill name. When omitted, files from all current skills are listed."}},additionalProperties:!1}}},{type:"function",function:{name:pe.readSkillFile,description:"Read a file from a current skill by skill name and relative path.",parameters:{type:"object",properties:{skillName:{type:"string",description:"Skill name that owns the file."},path:{type:"string",description:"File path relative to the skill root."}},required:["skillName","path"],additionalProperties:!1}}}],je={type:"function",function:{name:Oe,description:"Execute a command in the backend runtime environment for a selected skill.",parameters:{type:"object",properties:{skillName:{type:"string",description:"Name of the current skill that provides the command instructions."},command:{type:"string",description:"Command name to execute in the skill backend runtime."},args:{type:"array",description:"Command arguments passed as argv items.",items:{type:"string"}}},required:["skillName","command","args"],additionalProperties:!1}}},le=(e,t)=>({skillName:e,id:t.id,path:t.path,kind:t.kind,mimeType:t.mimeType,size:t.size,lastModified:t.lastModified}),ce=e=>{let t=e.function.arguments;if(!t)return{};try{let s=JSON.parse(t);return s&&typeof s=="object"&&!Array.isArray(s)?s:{}}catch{return{}}},Le=e=>Array.isArray(e)&&e.every(t=>typeof t=="string")?e:void 0,Ke=e=>{if(!e.some(n=>!!n.files?.length))return[];let s=n=>{if(!(typeof n!="string"||!n))return e.find(i=>i.name===n)};return[{tool:fe[0],handler:n=>{let i=ce(n),o=s(i.skillName);return{files:(o?[o]:e).flatMap(c=>(c.files??[]).map(p=>le(c.name,p)))}}},{tool:fe[1],handler:n=>{let i=ce(n),o=s(i.skillName),r=typeof i.path=="string"?i.path:void 0;if(!o)return{error:"skill_not_found"};if(!r)return{error:"file_path_required",skillName:o.name};let c=o.files?.find(p=>p.path===r);return c?c.kind==="binary"?{error:"binary_file_not_readable",file:le(o.name,c)}:{file:le(o.name,c),content:c.content}:{error:"file_not_found",skillName:o.name,path:r}}}]},We=(e,t)=>{if(!t||e.length===0)return[];let s=n=>{if(!(typeof n!="string"||!n))return e.find(i=>i.name===n)};return[{tool:je,handler:async n=>{let i=ce(n),o=s(i.skillName),r=typeof i.command=="string"?i.command:void 0,c=Le(i.args);return o?r?c?t({skill:o,skillName:o.name,command:r,args:c}):{error:"args_required",skillName:o.name,command:r}:{error:"command_required",skillName:o.name}:{error:"skill_not_found"}}}]},se=(e,t={})=>[...Ke(e),...We(e,t.executeSkillCommand)],ne=async e=>{let t=[];for(let s of e){let n=s.instructions?.trim();n&&t.push(`## ${s.name}
+
+${n}`)}if(t.length!==0)return{role:"system",content:["Apply these skill instructions when generating the response.",...t].join(`
+
+`)}};var ue="__tiny_robot_skill",ye=e=>{let{getSkills:t,executeSkillCommand:s,onSkillsResolved:n,...i}=e;return{name:"skill",...i,provideTools:async o=>o.customContext[ue]?.runtimeTools??[],onTurnStart:async o=>{let r=await t?.(o)??[],c={skills:r,skillNames:r.map(p=>p.name),runtimeTools:se(r,{executeSkillCommand:s&&(p=>s(p,o))})};return o.setCustomContext({[ue]:c}),await n?.(c,o),i.onTurnStart?.(o)},onBeforeRequest:async o=>{let r=o.customContext[ue];if(r){let c=await ne(r.skills);c&&(o.requestBody.messages=[c,...o.requestBody.messages])}return i.onBeforeRequest?.(o)}}};var oe=(e={})=>{let t=(s,n)=>!!s.thinking!==n||!!s.open!==n;return{name:"thinking",...e,onCompletionChunk(s){let{choice:n,currentMessage:i,updateCurrentMessage:o}=s,r=n,c=r?.message?.reasoning_content||r?.delta?.reasoning_content,p=typeof c=="string"&&c.trim()!=="";return p?i.state&&typeof i.state=="object"?t(i.state,p)&&o(a=>{a.state.thinking=!0,a.state.open=!0}):o(a=>{a.state={thinking:p,open:p}}):i.state&&typeof i.state=="object"&&"thinking"in i.state&&t(i.state,p)&&o(a=>{a.state.thinking=!1,a.state.open=!1}),e.onCompletionChunk?.(s)},onTurnEnd(s){let{currentTurn:n,mutate:i}=s,o=n.at(-1);return o?.state&&typeof o.state=="object"&&"thinking"in o.state&&t(o.state,!1)&&i("messages",()=>{o.state.thinking=!1,o.state.open=!1}),e.onTurnEnd?.(s)}}};var G=class extends Error{constructor(t){super(t),this.name="AbortError"}};function $e(e){if(e.aborted)return{promise:Promise.reject(new G(String(e.reason??"Aborted"))),cleanup:()=>{}};let t=null;return{promise:new Promise((i,o)=>{t=()=>{o(new G(String(e.reason??"Aborted")))},e.addEventListener("abort",t,{once:!0})}),cleanup:()=>{t&&(e.removeEventListener("abort",t),t=null)}}}function Se(e,t){let{promise:s,cleanup:n}=$e(t);return Promise.race([e,s]).finally(n)}function Ce(e,t){let s={};for(let n in e)t.includes(n)&&(s[n]=e[n]);return s}function Me(e,t){let s={};for(let n in e)t.includes(n)||(s[n]=e[n]);return s}async function*H(e){if(he(e)){yield*e;return}let t=await e;if(he(t)){yield*t;return}yield t}function he(e){return e&&typeof e=="object"&&typeof e[Symbol.asyncIterator]=="function"}var me=e=>typeof e=="object"&&e!==null,ke=e=>me(e)&&typeof e.index=="number",D=(e,t)=>{for(let[s,n]of Object.entries(t)){let i=e[s];if(i)if(typeof i=="string"&&typeof n=="string")s==="type"&&i||(e[s]=i+n);else if(Array.isArray(i)&&Array.isArray(n))if(i.every(o=>ke(o))&&n.every(o=>ke(o))){let o=new Map(i.map(a=>[a.index,a])),r=new Map(n.map(a=>[a.index,a]));for(let[a,u]of r)if(o.has(a)){let M=o.get(a);o.set(a,D(M,u))}else o.set(a,u);let c=Math.max(...Array.from(o.keys()),-1)+1,p=c>i.length?Array.from({length:c}):i;for(let[a,u]of o)p[a]=u;e[s]=p}else e[s]=[...i,...n];else me(i)&&me(n)&&(e[s]=D(i,n));else e[s]=n}return e};function Ge({messages:e,cancelledContent:t,createMessage:s,mutate:n}){let i=[];for(let o=0;o<e.length;o++){let r=e[o];if(r.role==="assistant"&&r.tool_calls&&r.tool_calls.length>0){let c=new Set(r.tool_calls.map(u=>u.id)),p=new Set;for(let u=o+1;u<e.length;u++){let M=e[u];M.role==="tool"&&M.tool_call_id&&c.has(M.tool_call_id)&&p.add(M.tool_call_id)}let a=r.tool_calls.map(u=>u.id).filter(u=>!p.has(u));a.length>0&&i.push({insertAfterIndex:o,missingToolCallIds:a})}}i.length!==0&&n("messages",o=>{for(let r=i.length-1;r>=0;r--){let{insertAfterIndex:c,missingToolCallIds:p}=i[r],a=p.map(u=>s({role:"tool",tool_call_id:u,content:t}));o.messages.splice(c+1,0,...a)}})}var Te=e=>{let{getTools:t,beforeCallTools:s,callTool:n,onToolCallStart:i,onToolCallEnd:o,toolCallCancelledContent:r="Tool call cancelled.",toolCallFailedContent:c="Tool call failed.",autoFillMissingToolMessages:p=!1,...a}=e,u=(m,f)=>{var S,h;return m.state??(m.state={}),(S=m.state).toolCall??(S.toolCall={}),(h=m.state.toolCall)[f]??(h[f]={}),m},M=(...m)=>{let[f,{assistantMessage:S,mutate:h}]=m;h("messages",()=>{let R=u(S,f.id);R.state.toolCall[f.id].status="running"}),i?.(...m)},F=(...m)=>{let[f,{status:S,assistantMessage:h,mutate:R}]=m;R("messages",()=>{let I=u(h,f.id);I.state.toolCall[f.id].status=S}),o?.(...m)},z=m=>m.type==="function"&&"function"in m,W=m=>!!(m&&typeof m=="object"&&"tool"in m&&"handler"in m),B=m=>{let f=m;return typeof f.provideTools=="function"?f:void 0},_=(m,f)=>typeof m.disabled=="function"?m.disabled(f):!!m.disabled,X=async(m,f=[])=>{let S=[];for(let T of m.plugins){let l=B(T);!_(T,m)&&l&&S.push(...(await l.provideTools(m)).map(d=>({item:d,source:{type:"toolProvider",pluginName:T.name}})))}let h=[...S,...(await t(m)).map(T=>({item:T,source:{type:"toolPlugin"}}))],R=[],I=new Map,O=new Map,j=new Set,$=T=>{let l=T.function.name;if(j.has(l))throw new Error(`Duplicate tool name "${l}" detected. Tool names must be unique because tool calls are routed by function.name.`);j.add(l)};f.forEach($);for(let{item:T,source:l}of h){let d=W(T)?T.tool:T;$(d),O.set(d.function.name,l),W(T)?(R.push(T.tool),I.set(T.tool.function.name,T)):R.push(T)}return{tools:R,runtimeToolMap:I,toolSourceMap:O}};return{name:"tool",...a,onTurnStart:m=>{let{getState:f,createMessage:S,mutate:h}=m,R=f().messages;return p&&Ge({messages:R,cancelledContent:r,createMessage:S,mutate:h}),a.onTurnStart?.(m)},onBeforeRequest:async m=>{let{requestBody:f}=m,S=Array.isArray(f.tools)?f.tools:[],{tools:h}=await X(m,S);return h&&h.length>0&&(f.tools=S.length?[...S,...h]:h),a.onBeforeRequest?.(m)},onAfterRequest:async m=>{let{currentMessage:f,lastChoice:S,appendMessage:h,abortSignal:R,setRequestState:I,requestNext:O,mutate:j,createMessage:$}=m;if(S?.finish_reason!=="tool_calls"||!f.tool_calls?.length)return;I("processing","calling-tools"),await s?.(f.tool_calls,{...m,assistantMessage:f});let{runtimeToolMap:T,toolSourceMap:l}=await X(m),d=f.tool_calls.map(async y=>{let C=Math.floor(Date.now()/1e3),w=!1,g=$({role:"tool",tool_call_id:y.id,content:"",metadata:{createdAt:C,updatedAt:C}});h(g);let k=z(y)?y:void 0,E=k?l.get(k.function.name)??{type:"unknown"}:{type:"unknown"},b={...m,assistantMessage:f,toolMessage:g,toolSource:E};M(y,b);try{let x=k?T.get(k.function.name):void 0,P=x&&k?x.handler(k,b):n(y,b),N=H(P);for await(let q of N)j("messages",()=>{if((typeof q=="string"&&q.length>0||q&&typeof q=="object"&&Object.keys(q).length>0)&&(w=!0),typeof q=="string")g.content+=q;else{let Y={};try{let A=Array.isArray(g.content)?g.content.map(L=>L.text).join(""):g.content;Y=JSON.parse(A||"{}")}catch(A){console.warn(A)}g.content=JSON.stringify(D(Y,q))}g.metadata.updatedAt=Math.floor(Date.now()/1e3)});F(y,{...b,status:"success"})}catch(x){let P=x instanceof Error?x:new Error(String(x));if(R.aborted){F(y,{...b,status:"cancelled",error:P});return}console.error(x),w||j("messages",()=>{g.content=c,g.metadata.updatedAt=Math.floor(Date.now()/1e3)}),F(y,{...b,status:"failed",error:P})}});return await Promise.all(d),R.aborted||O(),a.onAfterRequest?.(m)}}};var He=async()=>{throw new Error("Response provider is not set")},Ve=e=>{let t=[];for(let s of e){if(s.name){let n=t.findIndex(i=>i.name===s.name);n!==-1&&t.splice(n,1)}t.push(s)}return t},K=(e,t)=>typeof e.disabled=="function"?e.disabled(t):!!e.disabled,Pe=(e,t={})=>{let{initialMessages:s=[],requestMessageFields:n=[],requestMessageFieldsExclude:i=["state","metadata","loading"],responseProvider:o=He,onCompletionChunk:r,plugins:c=[]}=t,p={requestState:"idle",processingState:void 0,messages:[...s]};e.initialize(p);let a={currentTurn:[],customContext:{},abortController:null,responseProvider:o},u=[oe(),te()],M=Ve(u.concat(c)),F=()=>e.getState(),z=l=>e.createMessage(l),W=e.subscribe,B=e.mutate,_=l=>!l||Object.keys(l).length===0?!1:Object.values(l).some(d=>!!d),X=l=>{let d=l;return n.length&&(d=d.map(y=>Ce(y,n))),i.length&&(d=d.map(y=>Me(y,i))),d},m=l=>{Object.assign(a.customContext,l)},f=(l,d)=>{B("requestState",(y,C)=>{if(y.requestState===l&&y.processingState===d){C();return}y.requestState=l,y.processingState=l==="processing"?d??"requesting":void 0})},S=(...l)=>{let d=l.map(y=>z(y));return B("messages",y=>{y.messages.push(...d)}),a.currentTurn.push(...d),d},h=l=>({getState:F,createMessage:z,mutate:B,abortSignal:l,currentTurn:a.currentTurn,plugins:M,customContext:a.customContext,setRequestState:f,setCustomContext:m});async function R(l,d,y={}){f("processing","requesting");let C={messages:F().messages},w=h(d);for(let x of M.filter(P=>!K(P,w)))await x.onBeforeRequest?.({...w,requestBody:C});C.messages=X(C.messages);let g={role:"assistant",content:"",loading:!0};[g]=S(g),y.setAssistantMessage?.(g);let k=l(C,d),E=H(k),b;for await(let x of E){f("processing","completing"),B("messages",(A,L)=>{g.loading?g.loading=void 0:L()});let P=(x.choices||[]).find(A=>A.index===0)??x.choices?.[0];if(!P)continue;b=P;let N=()=>{B("messages",()=>{g.metadata||(g.metadata={});let{created:A,...L}=x;g.metadata.createdAt=A,g.metadata.updatedAt=Math.floor(Date.now()/1e3),Object.assign(g.metadata,L);let Z="delta"in P&&_(P.delta)&&P.delta||"message"in P&&_(P.message)&&P.message||null;if(Z?.role&&(g.role=Z.role),Z){let{role:et,...Fe}=Z;D(g,Fe)}})},q=A=>{B("messages",()=>{A(g)})};if(r){let A=h(d);r({...A,chunk:x,choice:P,currentMessage:g,updateCurrentMessage:q},N)}else N();let Y=h(d);for(let A of M.filter(L=>!K(L,Y)))A.onCompletionChunk?.({...Y,abortSignal:d,chunk:x,choice:P,currentMessage:g,updateCurrentMessage:q})}await I(g,l,d,b,y)}async function I(l,d,y,C,w){let g=!1,k=h(y),E=M.filter(b=>!K(b,k)).map(b=>{if(!b.onAfterRequest)return null;let x=N=>{S(...Array.isArray(N)?N:[N])},P=()=>{g=!0};return b.onAfterRequest({...k,currentMessage:l,lastChoice:C,appendMessage:x,requestNext:P})}).filter(b=>b!==null);await Se(Promise.all(E),y),g&&await R(d,y,w)}async function O(){let l=new AbortController;a.abortController=l,a.customContext={};let d=null,y=C=>{d=C};try{f("processing","requesting");let C=h(l.signal);for(let k of M.filter(E=>!K(E,C)))await k.onTurnStart?.(C);let w=a.responseProvider;try{await R(w,l.signal,{setAssistantMessage:y}),f("completed")}catch(k){if(l.signal.aborted||k instanceof G||k instanceof Error&&k.name==="AbortError")f("aborted");else throw k}let g=h(l.signal);for(let k of M.filter(E=>!K(E,g)))await k.onTurnEnd?.(g)}catch(C){f("error");let w=!1,g=h(l.signal);for(let k of M.filter(E=>!K(E,g)))k.onError&&(w=!0,k.onError({...g,error:C}));if(!w)throw C}finally{let C=h(l.signal);for(let w of M.filter(g=>!K(g,C)))try{w.onFinally?.(C)}catch(g){console.error(`Error in onFinally hook for plugin [${w.name||"Anonymous"}]:`,g)}a.abortController=null,a.currentTurn=[],B("messages",(w,g)=>{d?.loading?d.loading=void 0:g()})}}async function j(l){if(!l||!l.trim()){console.warn("Cannot send empty message");return}if(F().requestState==="processing"){console.warn("Cannot send message while processing is in progress");return}let d=Math.floor(Date.now()/1e3);S({role:"user",content:l.trim(),metadata:{createdAt:d,updatedAt:d}}),await O()}async function $(...l){if(F().requestState==="processing"){console.warn("Cannot send message while processing is in progress");return}S(...l),await O()}async function T(){a.abortController?.abort(),F().isProcessing&&await new Promise(l=>{let d=()=>{};d=W("requestState",y=>{y.isProcessing||(d(),l())})})}return{getState:F,subscribe:W,sendMessage:j,send:$,abort:T,setResponseProvider(l){a.responseProvider=l}}};var V=e=>{let t=e.split("\\").join("/").replace(/^\.\/+/,"");return!t||t.startsWith("/")||t.includes("\0")||t.split("/").some(s=>s===".."||s==="")?null:t},U=e=>[".md",".txt",".json"].includes(Q(e)),Q=e=>{let t=e.split("/").at(-1)||e,s=t.lastIndexOf(".");return s===-1?"":t.slice(s).toLowerCase()};var xe=async e=>{let t=Array.from({length:e.length},(s,n)=>e[n]).filter(s=>!!s);return Promise.all(t.map(s=>{let n=s.webkitRelativePath||s.name;return be(s,Ue(n))}))},we=async e=>{let t=[],s=async(n,i="")=>{for await(let[o,r]of n.entries()){let c=i?`${i}/${o}`:o;if(r.kind==="directory"){await s(r,c);continue}t.push(await be(await r.getFile(),c))}};return await s(e),t.sort((n,i)=>n.path.localeCompare(i.path))},be=async(e,t)=>{let s=V(t);if(!s)throw new Error(`Invalid skill file path: ${t}`);return U(s)?{path:s,kind:"text",content:await e.text(),mimeType:e.type,size:e.size,lastModified:e.lastModified}:{path:s,kind:"binary",content:await e.arrayBuffer(),mimeType:e.type,size:e.size,lastModified:e.lastModified}},Ue=e=>{let t=e.split("\\").join("/"),s=t.split("/").filter(Boolean);return s.length<=1?t:s.slice(1).join("/")};var Re=require("yaml");var J=class{constructor(t={}){this.entryFile=t.entryFile??"SKILL.md",this.strict=t.strict??!1}load(t){let s=[],n=this.normalizeFiles(t,s),i=n.find(u=>u.path===this.entryFile);if(!i)throw new Error(`Skill entry file "${this.entryFile}" is missing.`);if(i.kind!=="text")throw new Error(`Skill entry file "${this.entryFile}" must be a text file.`);let{frontmatter:o,body:r}=Je(i.content),c=r.trim();if(!c)throw new Error(`Skill entry file "${this.entryFile}" must contain instructions.`);let p=Ae(o.metadata),a=[];for(let u of n)if(u.path!==this.entryFile){if(u.kind==="binary"){a.push({...u,id:u.path});continue}if(!U(u.path)){s.push({code:"unsupported-text-file-ignored",message:"Only markdown, text, and json files are converted to text skill files.",path:u.path});continue}a.push({...u,id:u.path})}return{skill:{name:ge(o.name)||Xe(this.entryFile),description:ge(o.description)||"",instructions:c,files:a.length?a:void 0,metadata:{...p,homepage:ge(o.homepage),frontmatter:o}},warnings:s}}normalizeFiles(t,s){let n=[],i=new Set;for(let o of t){let r=V(o.path);if(!r){this.handleWarning(s,{code:"invalid-path",message:`Invalid skill file path: ${o.path}`,path:o.path});continue}if(i.has(r)){this.handleWarning(s,{code:"duplicate-path",message:`Duplicate skill file path: ${r}`,path:r});continue}i.add(r),n.push({...o,path:r})}return n.sort((o,r)=>o.path.localeCompare(r.path))}handleWarning(t,s){if(this.strict)throw new Error(s.path?`${s.path}: ${s.message}`:s.message);t.push(s)}},Je=e=>{if(!e.startsWith("---"))return{frontmatter:{},body:e};let t=e.indexOf(`
+---`,3);if(t===-1)return{frontmatter:{},body:e};let s=e.slice(3,t).trim(),n=e.slice(t+4);return{frontmatter:Ye(s),body:n}},Ye=e=>{let t=(0,Re.parse)(e);return Ae(t)??{}},ge=e=>typeof e=="string"?e:void 0,Ae=e=>e&&typeof e=="object"&&!Array.isArray(e)?e:void 0,Qe=e=>{let t=e.split("/").at(-1)||e,s=Q(t);return s?t.slice(0,-s.length):t},Xe=e=>Qe(e);var ie=class{constructor(t={}){this.skills=new Map;this.selectedSkillNames=new Set;for(let s of t.skills??[])this.set(s);this.select(t.selectedSkillNames??[])}set(t){return this.skills.set(t.name,t),t}remove(t){let s=this.get(t);return this.skills.delete(t),this.selectedSkillNames.delete(t),s}clear(){this.skills.clear(),this.selectedSkillNames.clear()}get(t){return this.skills.get(t)}has(t){return this.skills.has(t)}list(){return Array.from(this.skills.values())}select(t){for(let s of Array.isArray(t)?t:[t]){if(!this.skills.has(s))throw new Error(`Skill "${s}" does not exist.`);this.selectedSkillNames.add(s)}}unselect(t){for(let s of Array.isArray(t)?t:[t])this.selectedSkillNames.delete(s)}getSelectedSkillNames(){return Array.from(this.selectedSkillNames)}getSelectedSkills(){return this.getSelectedSkillNames().flatMap(t=>{let s=this.skills.get(t);return s?[s]:[]})}import(t,s={}){let n=new J(s).load(t);return this.set(n.skill),n}};0&&(module.exports={SkillLoader,SkillManager,combineDeltaData,compileSkillInstructions,createMessageEngine,createNativeMessageAdapter,createSkillRuntimeTools,createVueMessageAdapter,getExtension,isTextSkillFilePath,lengthPlugin,loadSkillFilesFromDirectoryHandle,loadSkillFilesFromFileList,normalizeSkillPath,normalizeToAsyncGenerator,skillPlugin,thinkingPlugin,toolPlugin});

package/dist/core.mjs

@@ -1 +1,2 @@
-import{a as o,b as f,c as l,d as m,e as p,f as c,g as M,h as d}from"./chunk-EES4JUCD.mjs";var w=()=>{let s=!1,t,n=e=>{if(s)throw new Error("Message state adapter is already initialized");t={requestState:e.requestState,processingState:e.processingState,messages:[...e.messages]},s=!0},a=()=>{if(!s)throw new Error("Message state adapter is not initialized");return{requestState:t.requestState,processingState:t.processingState,messages:[...t.messages],isProcessing:t.requestState==="processing"}},r=o(a);return{initialize:n,getState:a,createMessage(e){return e},mutate:(e,g)=>{if(!s)throw new Error("Message state adapter is not initialized");let i=!1;g(t,()=>{i=!0}),i||r.notify(e)},subscribe:r.subscribe}};export{c as combineDeltaData,d as createMessageEngine,w as createNativeMessageAdapter,f as createVueMessageAdapter,l as lengthPlugin,p as normalizeToAsyncGenerator,m as thinkingPlugin,M as toolPlugin};
+import{a as g,b as N,c as E,d as F,e as w,f as v,g as O,h as x,i as M,j as T,k as $}from"./chunk-6JEZBNBO.mjs";import{a as p,b as d,c as f}from"./chunk-ZO2ZONVX.mjs";var I=()=>{let i=!1,e,t=r=>{if(i)throw new Error("Message state adapter is already initialized");e={requestState:r.requestState,processingState:r.processingState,messages:[...r.messages]},i=!0},s=()=>{if(!i)throw new Error("Message state adapter is not initialized");return{requestState:e.requestState,processingState:e.processingState,messages:[...e.messages],isProcessing:e.requestState==="processing"}},o=g(s);return{initialize:t,getState:s,createMessage(r){return r},mutate:(r,a)=>{if(!i)throw new Error("Message state adapter is not initialized");let k=!1;a(e,()=>{k=!0}),k||o.notify(r)},subscribe:o.subscribe}};var b=async i=>{let e=Array.from({length:i.length},(t,s)=>i[s]).filter(t=>!!t);return Promise.all(e.map(t=>{let s=t.webkitRelativePath||t.name;return h(t,L(s))}))},R=async i=>{let e=[],t=async(s,o="")=>{for await(let[l,r]of s.entries()){let a=o?`${o}/${l}`:l;if(r.kind==="directory"){await t(r,a);continue}e.push(await h(await r.getFile(),a))}};return await t(i),e.sort((s,o)=>s.path.localeCompare(o.path))},h=async(i,e)=>{let t=p(e);if(!t)throw new Error(`Invalid skill file path: ${e}`);return d(t)?{path:t,kind:"text",content:await i.text(),mimeType:i.type,size:i.size,lastModified:i.lastModified}:{path:t,kind:"binary",content:await i.arrayBuffer(),mimeType:i.type,size:i.size,lastModified:i.lastModified}},L=i=>{let e=i.split("\\").join("/"),t=e.split("/").filter(Boolean);return t.length<=1?e:t.slice(1).join("/")};import{parse as B}from"yaml";var m=class{constructor(e={}){this.entryFile=e.entryFile??"SKILL.md",this.strict=e.strict??!1}load(e){let t=[],s=this.normalizeFiles(e,t),o=s.find(n=>n.path===this.entryFile);if(!o)throw new Error(`Skill entry file "${this.entryFile}" is missing.`);if(o.kind!=="text")throw new Error(`Skill entry file "${this.entryFile}" must be a text file.`);let{frontmatter:l,body:r}=z(o.content),a=r.trim();if(!a)throw new Error(`Skill entry file "${this.entryFile}" must contain instructions.`);let k=y(l.metadata),c=[];for(let n of s)if(n.path!==this.entryFile){if(n.kind==="binary"){c.push({...n,id:n.path});continue}if(!d(n.path)){t.push({code:"unsupported-text-file-ignored",message:"Only markdown, text, and json files are converted to text skill files.",path:n.path});continue}c.push({...n,id:n.path})}return{skill:{name:S(l.name)||P(this.entryFile),description:S(l.description)||"",instructions:a,files:c.length?c:void 0,metadata:{...k,homepage:S(l.homepage),frontmatter:l}},warnings:t}}normalizeFiles(e,t){let s=[],o=new Set;for(let l of e){let r=p(l.path);if(!r){this.handleWarning(t,{code:"invalid-path",message:`Invalid skill file path: ${l.path}`,path:l.path});continue}if(o.has(r)){this.handleWarning(t,{code:"duplicate-path",message:`Duplicate skill file path: ${r}`,path:r});continue}o.add(r),s.push({...l,path:r})}return s.sort((l,r)=>l.path.localeCompare(r.path))}handleWarning(e,t){if(this.strict)throw new Error(t.path?`${t.path}: ${t.message}`:t.message);e.push(t)}},z=i=>{if(!i.startsWith("---"))return{frontmatter:{},body:i};let e=i.indexOf(`
+---`,3);if(e===-1)return{frontmatter:{},body:i};let t=i.slice(3,e).trim(),s=i.slice(e+4);return{frontmatter:D(t),body:s}},D=i=>{let e=B(i);return y(e)??{}},S=i=>typeof i=="string"?i:void 0,y=i=>i&&typeof i=="object"&&!Array.isArray(i)?i:void 0,A=i=>{let e=i.split("/").at(-1)||i,t=f(e);return t?e.slice(0,-t.length):e},P=i=>A(i);var u=class{constructor(e={}){this.skills=new Map;this.selectedSkillNames=new Set;for(let t of e.skills??[])this.set(t);this.select(e.selectedSkillNames??[])}set(e){return this.skills.set(e.name,e),e}remove(e){let t=this.get(e);return this.skills.delete(e),this.selectedSkillNames.delete(e),t}clear(){this.skills.clear(),this.selectedSkillNames.clear()}get(e){return this.skills.get(e)}has(e){return this.skills.has(e)}list(){return Array.from(this.skills.values())}select(e){for(let t of Array.isArray(e)?e:[e]){if(!this.skills.has(t))throw new Error(`Skill "${t}" does not exist.`);this.selectedSkillNames.add(t)}}unselect(e){for(let t of Array.isArray(e)?e:[e])this.selectedSkillNames.delete(t)}getSelectedSkillNames(){return Array.from(this.selectedSkillNames)}getSelectedSkills(){return this.getSelectedSkillNames().flatMap(e=>{let t=this.skills.get(e);return t?[t]:[]})}import(e,t={}){let s=new m(t).load(e);return this.set(s.skill),s}};export{m as SkillLoader,u as SkillManager,M as combineDeltaData,w as compileSkillInstructions,$ as createMessageEngine,I as createNativeMessageAdapter,F as createSkillRuntimeTools,N as createVueMessageAdapter,f as getExtension,d as isTextSkillFilePath,E as lengthPlugin,R as loadSkillFilesFromDirectoryHandle,b as loadSkillFilesFromFileList,p as normalizeSkillPath,x as normalizeToAsyncGenerator,v as skillPlugin,O as thinkingPlugin,T as toolPlugin};

package/dist/index.d.mts

@@ -1,6 +1,8 @@
-import { A as AIModelConfig, C as ChatCompletionRequest, a as ChatCompletionResponse, S as StreamHandler, B as BaseModelProvider, b as ChatMessage, M as MaybePromise, T as ToolCall } from './types-D0E0rOVi.mjs';
-export { c as AIAdapterError, d as AIProvider, e as ChatCompletionOptions, f as ChatCompletionResponseChoice, g as ChatCompletionResponseMessage, h as ChatCompletionResponseUsage, i as ChatCompletionStreamResponse, j as ChatCompletionStreamResponseChoice, k as ChatCompletionStreamResponseDelta, l as ChatHistory, E as ErrorType, m as MessageMetadata, n as MessageRole, o as StreamEventType } from './types-D0E0rOVi.mjs';
+import { a as AIModelConfig, f as ChatCompletionRequest, g as ChatCompletionResponse, W as StreamHandler, B as BaseModelProvider, p as ChatMessage, M as MaybePromise, X as ToolCall, N as SkillCommandRequest, O as SkillCommandResult, T as SkillPluginState, $ as ToolSource, _ as ToolProviderItem } from './skillPlugin-4pC5SvPk.mjs';
+export { A as AIAdapterError, b as AIProvider, C as ChatCompletionOptions, h as ChatCompletionResponseChoice, i as ChatCompletionResponseMessage, j as ChatCompletionResponseUsage, k as ChatCompletionStreamResponse, l as ChatCompletionStreamResponseChoice, m as ChatCompletionStreamResponseDelta, n as ChatHistory, E as ErrorType, u as MessageMetadata, x as MessageRole, V as StreamEventType } from './skillPlugin-4pC5SvPk.mjs';
 import { Ref, ComputedRef } from 'vue';
+import { S as SkillDefinition } from './types-ChCZ8jKB.mjs';
+import 'openai/resources';
 
 /**
  * AI客户端类
@@ -460,10 +462,38 @@ declare const lengthPlugin: (options?: UseMessagePlugin & {
     continueContent?: string;
 }) => UseMessagePlugin;
 
+type VueSkillSource = SkillDefinition[] | undefined;
+type VueSkillSourceRef = VueSkillSource | Ref<VueSkillSource> | ComputedRef<VueSkillSource>;
+type UseMessageSkillPluginOptions = UseMessagePlugin & {
+    /**
+     * 当前请求要使用的 skills。支持普通数组、ref 或 computed。
+     */
+    skills?: VueSkillSourceRef;
+    /**
+     * 动态返回当前请求要使用的 skills。
+     */
+    getSkills?: (context: BasePluginContext) => MaybePromise<VueSkillSourceRef>;
+    /**
+     * 执行模型为某个 skill 规划的后端命令。
+     *
+     * @experimental 该 API 仍在设计和验证中，命令协议、返回结构和安全边界后续可能调整。
+     */
+    executeSkillCommand?: (request: SkillCommandRequest, context: BasePluginContext) => MaybePromise<SkillCommandResult>;
+    /**
+     * skills 解析并转换为插件状态后触发。
+     */
+    onSkillsResolved?: (state: SkillPluginState, context: BasePluginContext) => MaybePromise<void>;
+};
+declare const skillPlugin: (options: UseMessageSkillPluginOptions) => UseMessagePlugin;
+
 declare const thinkingPlugin: (options?: UseMessagePlugin) => UseMessagePlugin;
 
 interface UseMessageToolActionContext extends BasePluginContext {
     assistantMessage: ChatMessage;
+    /**
+     * 当前工具的来源。
+     */
+    toolSource?: ToolSource;
     /**
      * @deprecated use `assistantMessage` instead
      */
@@ -474,6 +504,10 @@ interface UseMessageCallToolContext extends UseMessageToolActionContext {
 }
 interface UseMessageToolCallContext extends BasePluginContext {
     assistantMessage: ChatMessage;
+    /**
+     * 当前工具的来源。
+     */
+    toolSource: ToolSource;
     /**
      * @deprecated use `assistantMessage` instead
      */
@@ -484,7 +518,7 @@ declare const toolPlugin: (options: UseMessagePlugin & {
     /**
      * 获取工具列表的函数。
      */
-    getTools: () => Promise<Tool[]>;
+    getTools: (context: BasePluginContext) => Promise<ToolProviderItem[]>;
     /**
      * 在处理包含 tool_calls 的响应前调用。
      */
@@ -530,4 +564,4 @@ declare const toolPlugin: (options: UseMessagePlugin & {
 
 declare const useMessage: (options: UseMessageOptions) => UseMessageReturn;
 
-export { AIClient, AIModelConfig, BaseModelProvider, type BasePluginContext, type ChatCompletion, ChatCompletionRequest, ChatCompletionResponse, ChatMessage, type Choice, type CompletionChoice, type Conversation, type ConversationInfo, type ConversationStorageStrategy, type DeltaChoice, type IndexedDBConfig, IndexedDBStrategy, type LocalStorageConfig, LocalStorageStrategy, MaybePromise, type MessageRequestBody, OpenAIProvider, type RequestProcessingState, type RequestState, type ResponseProvider, StreamHandler, type Tool, ToolCall, type Usage, type UseConversationOptions, type UseConversationReturn, type UseMessageCallToolContext, type UseMessageOptions, type UseMessagePlugin, type UseMessageReturn, type UseMessageToolActionContext, type UseMessageToolCallContext, extractTextFromResponse, formatMessages, handleSSEStream, indexedDBStorageStrategyFactory, lengthPlugin, localStorageStrategyFactory, sseStreamToGenerator, thinkingPlugin, toolPlugin, useConversation, useMessage };
+export { AIClient, AIModelConfig, BaseModelProvider, type BasePluginContext, type ChatCompletion, ChatCompletionRequest, ChatCompletionResponse, ChatMessage, type Choice, type CompletionChoice, type Conversation, type ConversationInfo, type ConversationStorageStrategy, type DeltaChoice, type IndexedDBConfig, IndexedDBStrategy, type LocalStorageConfig, LocalStorageStrategy, MaybePromise, type MessageRequestBody, OpenAIProvider, type RequestProcessingState, type RequestState, type ResponseProvider, StreamHandler, type Tool, ToolCall, type Usage, type UseConversationOptions, type UseConversationReturn, type UseMessageCallToolContext, type UseMessageOptions, type UseMessagePlugin, type UseMessageReturn, type UseMessageSkillPluginOptions, type UseMessageToolActionContext, type UseMessageToolCallContext, type VueSkillSource, type VueSkillSourceRef, extractTextFromResponse, formatMessages, handleSSEStream, indexedDBStorageStrategyFactory, lengthPlugin, localStorageStrategyFactory, skillPlugin, sseStreamToGenerator, thinkingPlugin, toolPlugin, useConversation, useMessage };