@opentiny/next-remoter 0.2.6 → 0.2.8

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 - present OpenTiny Authors.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/components/TinyRobotChat.vue.d.ts

@@ -1,6 +1,6 @@
 import { TrSender, PluginInfo } from '@opentiny/tiny-robot';
 import { STATUS } from '@opentiny/tiny-robot-kit';
-import { Ref, ComponentInstance } from 'vue';
+import { Ref, ComponentInstance, VNode } from 'vue';
 import { ICustomAgentModelProviderLlmConfig } from '../types/type';
 import { MenuItemConfig, McpServerConfig } from '@opentiny/next-sdk';
 import { UnifiedModelConfig } from '../types/model-config';
@@ -22,10 +22,10 @@ declare const __VLS_component: import('vue').DefineComponent<import('vue').Extra
     selectedModelId: import('vue').PropType<any>;
     genUiAble: import('vue').PropType<any>;
     enabledTools: import('vue').PropType<any>;
-    /** 必传的会话id */
+    /** 会话 id，可选；未传时仅显示「打开对话框」，不展示扫码等菜单 */
     sessionId: {
         type: StringConstructor;
-        default: string;
+        default: undefined;
     };
     /** 后端的代理服务器地址 */
     agentRoot: {
@@ -60,6 +60,21 @@ declare const __VLS_component: import('vue').DefineComponent<import('vue').Extra
     AILogoUrl: {
         type: StringConstructor;
     };
+    /** 角色user,assistant的头像配置, 值为 VNode, 比如： h(IconUser, { style: { fontSize: '32px' } }) */
+    roleAvatar: {
+        type: () => {
+            user: VNode;
+            assistant: VNode;
+        };
+        default: () => {
+            user: VNode<import('vue').RendererNode, import('vue').RendererElement, {
+                [key: string]: any;
+            }>;
+            assistant: VNode<import('vue').RendererNode, import('vue').RendererElement, {
+                [key: string]: any;
+            }>;
+        };
+    };
     /** 展示模式： 'remoter' | 'chat-dialog'
      * 遥控器模式： 自动在右下角显示一个AI图标，点击展开多个菜单项。
      * 对话框模式： 直接显示一个对话框界面
@@ -71,7 +86,10 @@ declare const __VLS_component: import('vue').DefineComponent<import('vue').Extra
     /** 大语言模型配置对象 */
     llmConfig: {
         type: () => ICustomAgentModelProviderLlmConfig | undefined;
-        default: undefined;
+        default: () => {
+            baseURL: string;
+            genuiUrl: string;
+        };
     };
     /** 设置组件运行在普通页面还是浏览器的扩展中 */
     inBrowserExt: {
@@ -112,11 +130,24 @@ declare const __VLS_component: import('vue').DefineComponent<import('vue').Extra
         type: () => "static" | "relative" | "absolute" | "fixed" | "sticky";
         default: string;
     };
+    debugStream: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /**
+     * 开启页面工具按需加载：仅当前激活路由对应的 withPageTools 工具对 LLM 可见，
+     * 并在插件面板中展示；未加载页面的工具不会暴露给模型，也不显示在面板上。
+     * 默认 false（关闭），需显式传入 :pageToolsOnDemand="true" 开启。
+     */
+    pageToolsOnDemand: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
 }>, {
     /** 大模型代理 */
     agent: import('@opentiny/next-sdk').AgentModelProvider;
     /** 欢迎图标 */
-    welcomeIcon: import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
+    welcomeIcon: VNode<import('vue').RendererNode, import('vue').RendererElement, {
         [key: string]: any;
     }>;
     /** 对话消息 */
@@ -131,7 +162,7 @@ declare const __VLS_component: import('vue').DefineComponent<import('vue').Extra
         assistant: {
             type: string;
             placement: string;
-            avatar: import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
+            avatar: VNode<import('vue').RendererNode, import('vue').RendererElement, {
                 [key: string]: any;
             }>;
             maxWidth: string;
@@ -139,14 +170,14 @@ declare const __VLS_component: import('vue').DefineComponent<import('vue').Extra
             slots: {
                 footer: ({ index }: {
                     index: number;
-                }) => "" | import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
+                }) => "" | VNode<import('vue').RendererNode, import('vue').RendererElement, {
                     [key: string]: any;
                 }>;
             };
         };
         user: {
             placement: string;
-            avatar: import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
+            avatar: VNode<import('vue').RendererNode, import('vue').RendererElement, {
                 [key: string]: any;
             }>;
             maxWidth: string;
@@ -182,16 +213,58 @@ declare const __VLS_component: import('vue').DefineComponent<import('vue').Extra
     } | null>;
     /** 添加消息 */
     addMessage: (message: import('@opentiny/tiny-robot-kit').ChatMessage | import('@opentiny/tiny-robot-kit').ChatMessage[]) => void;
+    /** 已安装的插件 */
+    installedPlugins: Ref<{
+        id: string;
+        name: string;
+        icon: string;
+        description: string;
+        enabled: boolean;
+        expanded?: boolean | undefined;
+        tools: {
+            id: string;
+            name: string;
+            description: string;
+            enabled: boolean;
+        }[];
+        addState?: import('@opentiny/tiny-robot').PluginAddState | undefined;
+        category?: string | undefined;
+    }[], PluginInfo[] | {
+        id: string;
+        name: string;
+        icon: string;
+        description: string;
+        enabled: boolean;
+        expanded?: boolean | undefined;
+        tools: {
+            id: string;
+            name: string;
+            description: string;
+            enabled: boolean;
+        }[];
+        addState?: import('@opentiny/tiny-robot').PluginAddState | undefined;
+        category?: string | undefined;
+    }[]>;
+    /** 添加插件核心方法 */
+    addPluginCore: (config: {
+        pluginId: string;
+        name: string;
+        description: string;
+        icon?: string;
+        mcpServer: McpServerConfig;
+    }) => Promise<boolean>;
+    /** 删除插件核心方法 */
+    deletePlugin: (plugin: PluginInfo) => Promise<void>;
 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
     fullscreen: import('vue').PropType<any>;
     show: import('vue').PropType<any>;
     selectedModelId: import('vue').PropType<any>;
     genUiAble: import('vue').PropType<any>;
     enabledTools: import('vue').PropType<any>;
-    /** 必传的会话id */
+    /** 会话 id，可选；未传时仅显示「打开对话框」，不展示扫码等菜单 */
     sessionId: {
         type: StringConstructor;
-        default: string;
+        default: undefined;
     };
     /** 后端的代理服务器地址 */
     agentRoot: {
@@ -226,6 +299,21 @@ declare const __VLS_component: import('vue').DefineComponent<import('vue').Extra
     AILogoUrl: {
         type: StringConstructor;
     };
+    /** 角色user,assistant的头像配置, 值为 VNode, 比如： h(IconUser, { style: { fontSize: '32px' } }) */
+    roleAvatar: {
+        type: () => {
+            user: VNode;
+            assistant: VNode;
+        };
+        default: () => {
+            user: VNode<import('vue').RendererNode, import('vue').RendererElement, {
+                [key: string]: any;
+            }>;
+            assistant: VNode<import('vue').RendererNode, import('vue').RendererElement, {
+                [key: string]: any;
+            }>;
+        };
+    };
     /** 展示模式： 'remoter' | 'chat-dialog'
      * 遥控器模式： 自动在右下角显示一个AI图标，点击展开多个菜单项。
      * 对话框模式： 直接显示一个对话框界面
@@ -237,7 +325,10 @@ declare const __VLS_component: import('vue').DefineComponent<import('vue').Extra
     /** 大语言模型配置对象 */
     llmConfig: {
         type: () => ICustomAgentModelProviderLlmConfig | undefined;
-        default: undefined;
+        default: () => {
+            baseURL: string;
+            genuiUrl: string;
+        };
     };
     /** 设置组件运行在普通页面还是浏览器的扩展中 */
     inBrowserExt: {
@@ -278,6 +369,19 @@ declare const __VLS_component: import('vue').DefineComponent<import('vue').Extra
         type: () => "static" | "relative" | "absolute" | "fixed" | "sticky";
         default: string;
     };
+    debugStream: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /**
+     * 开启页面工具按需加载：仅当前激活路由对应的 withPageTools 工具对 LLM 可见，
+     * 并在插件面板中展示；未加载页面的工具不会暴露给模型，也不显示在面板上。
+     * 默认 false（关闭），需显式传入 :pageToolsOnDemand="true" 开启。
+     */
+    pageToolsOnDemand: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
 }>> & Readonly<{}>, {
     title: string;
     systemPrompt: string;
@@ -287,12 +391,18 @@ declare const __VLS_component: import('vue').DefineComponent<import('vue').Extra
     mcpServers: Record<string, McpServerConfig>;
     agentRoot: string;
     locale: string;
+    roleAvatar: {
+        user: VNode;
+        assistant: VNode;
+    };
     inBrowserExt: boolean;
     genUiComponents: Record<string, any>;
     customMarketMcpServers: PluginInfo[];
     llmConfigs: UnifiedModelConfig[];
     skills: Record<string, string>;
     layoutMode: "absolute" | "fixed" | "static" | "relative" | "sticky";
+    debugStream: boolean;
+    pageToolsOnDemand: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, ReturnType<typeof __VLS_template>>;
 export default _default;

package/dist/composable/CustomAgentModelProvider.d.ts

@@ -1,18 +1,27 @@
 import { ChatCompletionResponse, ChatCompletionRequest, StreamHandler, BaseModelProvider, AIModelConfig } from '@opentiny/tiny-robot-kit';
 import { Ref } from 'vue';
 import { AgentModelProvider } from '@opentiny/next-sdk';
+import { getRemoteRouteState } from './useRouteBasedTools';
 import { ICustomAgentModelProviderLlmConfig } from '../types/type';
 import { ProviderV2 } from '@ai-sdk/provider';
+import { PromptManager } from './promptManager';
 
 /** Tiny-robot 所需要的自定义大语言的Provider */
 export declare class CustomAgentModelProvider extends BaseModelProvider {
     transport: any;
     /** 一个 ai-sdk agent 封装 */
     agent: AgentModelProvider;
-    systemPrompt: string;
+    promptManager: PromptManager;
     llmConfig: ICustomAgentModelProviderLlmConfig;
     /** 生成式UI启用状态 */
     isGenuiEnabled?: Ref<boolean>;
+    debugStream: boolean;
+    /** 开启页面工具按需加载 */
+    pageToolsOnDemand: boolean;
+    /** 实例级路由状态 getter，由 useRouteBasedTools 注入，实现多 remoter 隔离 */
+    private _getRouteState;
+    /** 由 useRouteBasedTools 注入实例级 getRemoteRouteState，实现多实例隔离 */
+    setRouteStateGetter(fn: () => ReturnType<typeof getRemoteRouteState>): void;
     constructor(config: AIModelConfig, systemPrompt: string, llmConfig?: ICustomAgentModelProviderLlmConfig);
     /**
      * 更新大语言模型配置
@@ -23,9 +32,10 @@ export declare class CustomAgentModelProvider extends BaseModelProvider {
      * @param providerType 提供商类型
      * @param useReActMode 是否使用 ReAct 模式
      */
-    updateLLMConfig({ modelId, baseURL, apiKey, providerType, useReActMode, llm, providerOptions, headers }: {
-        modelId: string;
+    updateLLMConfig({ model, baseURL, genuiUrl, apiKey, providerType, useReActMode, llm, providerOptions, headers }: {
+        model: string;
         baseURL?: string;
+        genuiUrl?: string;
         apiKey?: string;
         providerType?: 'deepseek' | 'openai' | ((options: any) => ProviderV2);
         useReActMode?: boolean;
@@ -35,6 +45,10 @@ export declare class CustomAgentModelProvider extends BaseModelProvider {
         /** 自定义请求 Header，透传给 ai-sdk Provider 实例 */
         headers?: Record<string, string>;
     }): void;
+    /**
+     * 清理消息数组中的 get-skill-content 工具调用结果
+     */
+    cleanGetSkillContentToolResult(messages: any[]): void;
     /**
      * 清理消息数组中的旧快照消息，只保留最新的快照
      * @param messages 消息数组

package/dist/composable/promptManager.d.ts

@@ -0,0 +1,18 @@
+export declare class PromptManager {
+    /** 固定系统提示词 */
+    private staticPrompt;
+    /** 元数据提示词 */
+    private skillMetaPrompt;
+    /** 临时系统提示词，比如： get-skill-content的返回值 */
+    private tempPrompt;
+    /** 返回全量的提示词 */
+    getSystemPrompt(): string;
+    /** 设置常驻提示词 */
+    setStatic(prompt: string): void;
+    /** 设置技能元数据提示词 */
+    setSkillMeta(prompt: string): void;
+    /** 设置临时值， 清除时传入空字符串即可，不再提供clearTemp */
+    setTemp(prompt: string): void;
+    /** 累增临时值，为多agent时预留 */
+    appendTemp(prompt: string): void;
+}

package/dist/composable/useMessageRoles.d.ts

@@ -1,29 +1,29 @@
-import { Ref } from 'vue';
+import { Ref, VNode } from 'vue';
 
 /**
  * 消息角色 UI 配置 Composable
  * 用于定义消息气泡的外观、头像、操作按钮等 UI 配置
  */
 export declare function useMessageRoles(options: {
+    props: {
+        roleAvatar: {
+            user: VNode;
+            assistant: VNode;
+        };
+    };
     messages: Ref<any[]>;
     messageState: any;
     inputMessage: Ref<string>;
     handleSendMessage: (inputValue: string, attachmentsContent?: any[]) => Promise<boolean>;
 }): {
-    aiAvatar: import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
-        [key: string]: any;
-    }>;
-    userAvatar: import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
-        [key: string]: any;
-    }>;
-    welcomeIcon: import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
+    welcomeIcon: VNode<import('vue').RendererNode, import('vue').RendererElement, {
         [key: string]: any;
     }>;
     roles: {
         assistant: {
             type: string;
             placement: string;
-            avatar: import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
+            avatar: VNode<import('vue').RendererNode, import('vue').RendererElement, {
                 [key: string]: any;
             }>;
             maxWidth: string;
@@ -31,14 +31,14 @@ export declare function useMessageRoles(options: {
             slots: {
                 footer: ({ index }: {
                     index: number;
-                }) => "" | import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
+                }) => "" | VNode<import('vue').RendererNode, import('vue').RendererElement, {
                     [key: string]: any;
                 }>;
             };
         };
         user: {
             placement: string;
-            avatar: import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
+            avatar: VNode<import('vue').RendererNode, import('vue').RendererElement, {
                 [key: string]: any;
             }>;
             maxWidth: string;

package/dist/composable/usePlugin.d.ts

@@ -74,6 +74,13 @@ export declare function usePlugin(agent: any, enabledTools: Ref<Record<string, b
     togglePlugin: (plugin: PluginInfo, enabled: boolean) => void;
     toggleTool: (plugin: PluginInfo, toolId: string, enabled: boolean) => void;
     deletePlugin: (plugin: PluginInfo) => Promise<void>;
+    addPluginCore: (config: {
+        pluginId: string;
+        name: string;
+        description: string;
+        icon?: string;
+        mcpServer: McpServerConfig;
+    }) => Promise<boolean>;
     addPluginFromMarket: (plugin: PluginInfo) => Promise<void>;
     addPluginFromScan: (sessionId: string, agentRoot: string) => Promise<boolean>;
     handleClientDisconnected: (serverName: string) => Promise<{

package/dist/composable/usePluginSession.d.ts

@@ -6,7 +6,12 @@ import { MenuItemConfig } from '@opentiny/next-sdk';
  * 用于处理 sessionId 相关的所有逻辑：扫码添加插件、识别码输入、遥控器初始化等
  */
 export declare function usePluginSession(options: {
-    sessionId: Ref<string>;
+    /**
+     * 会话 ID：
+     * - 初始为 undefined 或空字符串时：先渲染仅含「打开对话框」的 Logo
+     * - 后续变为非空字符串时：自动升级为带二维码 / 遥控器等完整菜单
+     */
+    sessionId: Ref<string | undefined>;
     agentRoot: string;
     mode: string;
     qrCodeUrl?: string;

package/dist/composable/useRouteBasedTools.d.ts

@@ -0,0 +1,39 @@
+import { Ref } from 'vue';
+import { PluginInfo } from '@opentiny/tiny-robot';
+
+/** 路由状态结构；initialized 为 true 表示已收到有效快照（如同窗口本地 map 或 iframe 收到 MSG_ROUTE_STATE_INITIAL） */
+export type RemoteRouteState = {
+    toolRouteMap: Map<string, string>;
+    activeRoutes: Set<string>;
+    /** 是否已就绪：iframe 下收到父窗口快照后为 true，未收到前为 false，用于 fail closed */
+    initialized: boolean;
+} | null;
+/**
+ * 获取跨窗口同步后的路由状态（兼容旧 API，返回默认实例的状态）
+ * @param instanceKey 可选，指定 remoter 实例 key；不传则返回默认实例（单例模式）
+ */
+export declare const getRemoteRouteState: (instanceKey?: symbol) => RemoteRouteState;
+/**
+ * 路由感知工具过滤 composable
+ *
+ * 支持两种场景：
+ * - 同窗口：业务页面与 Remoter 在同一 window，直接读取 getToolRouteMap/getActiveRoutes
+ * - iframe：Remoter 在 iframe 内，通过 remoter-ready 握手获取父窗口的路由状态，
+ *   并接收父窗口广播的 page-ready/page-leave，实现按需加载
+ *
+ * 默认关闭（enabled = false），需显式传入 :pageToolsOnDemand="true" 开启。
+ */
+export declare function useRouteBasedTools(options: {
+    /** 是否启用路由感知模式，默认 false，支持运行时动态切换 */
+    enabled: Ref<boolean>;
+    /** 仅依赖 ignoreToolnames 的最小 Agent 约束 */
+    agent: {
+        ignoreToolnames: string[];
+    };
+    /** 已安装插件列表的响应式引用，用于同步 UI 开关状态 */
+    installedPlugins: Ref<PluginInfo[]>;
+    /** 可选，CustomAgentModelProvider 实例，用于注入实例级 getRemoteRouteState，实现多实例隔离 */
+    customAgentProvider?: {
+        setRouteStateGetter: (fn: () => RemoteRouteState) => void;
+    };
+}): void;

package/dist/composable/useSkill.d.ts

@@ -4,8 +4,6 @@ import { SkillMeta } from '@opentiny/next-sdk';
 export interface UseSkillWithToolsOptions {
     /** 用户层传入的 skill .md 模块（key 路径，value 内容），由 next-sdk 处理；大模型通过 get_skill_content 自动识别并加载技能 */
     skillsRef?: Ref<Record<string, string> | undefined>;
-    /** 基础系统提示词 */
-    systemPrompt: string;
     /** CustomAgentModelProvider 实例，用于写 systemPrompt、合并 extraTools */
     customAgentProvider: any;
 }