clickgo 6.8.2 → 6.10.0

package/dist/lib/command/native.d.ts

@@ -0,0 +1,18 @@
+import * as lCommand from '../command';
+/** --- 主进程只发送这四种操作，不接受任意代码或函数名 --- */
+export interface IRequest {
+    'method': 'listTasks' | 'list' | 'execute' | 'cancel';
+    'id': string;
+    'taskId'?: string;
+    'name'?: string;
+    'args'?: Record<string, lCommand.TJson>;
+}
+/**
+ * --- 接收 Native MCP 请求，按目标 taskId 直接读取或执行公开命令 ---
+ * @param request 主进程发来的操作
+ * @returns 共享命令结果或发现列表
+ */
+export declare function invoke(request: IRequest): Promise<lCommand.TResult | {
+    'ok': true;
+    'data': lCommand.IInfo[] | ReturnType<typeof lCommand.listTasks>;
+}>;

package/dist/lib/command/palette.d.ts

@@ -0,0 +1,10 @@
+import * as lForm from '../form';
+/**
+ * --- 打开原生命令调试面板，也可作为界面操作型代理的可选入口 ---
+ * @param current 发起操作的 Form，创建阶段使用其原生 Loading
+ * @param options 是否只显示应用允许代理调用的命令，默认显示全部内部命令
+ * @returns 面板关闭后完成；所属实例失效或正在创建时直接返回
+ */
+export declare function showPalette(current: lForm.AbstractForm, options?: {
+    'exposedOnly'?: boolean;
+}): Promise<void>;

package/dist/lib/command/schema.d.ts

@@ -0,0 +1,31 @@
+import type { ISchema, TJson } from '../command';
+/**
+ * --- 检查可序列化值，拒绝循环、非有限数和类实例；限制嵌套深度 ---
+ * @param value 待检查值
+ * @param seen 当前路径上的对象
+ * @param depth 当前深度
+ * @returns 是否为合法 JSON
+ */
+export declare function isJson(value: unknown, seen?: Set<object>, depth?: number): value is TJson;
+/**
+ * --- 注册时检查 schema，错误约束不能静默放行 ---
+ * @param schema 当前 schema
+ * @param root 根 schema
+ * @param seen 已检查的节点
+ * @returns 错误说明，合法时返回 null
+ */
+export declare function check(schema: ISchema | boolean, root?: ISchema, seen?: Set<ISchema>): string | null;
+/**
+ * --- 校验数据，不转换类型、不补默认值、不删除额外参数 ---
+ * @param value 待校验数据
+ * @param schema 当前 schema
+ * @param root 根 schema
+ * @param path 错误字段路径
+ * @param depth 递归深度
+ * @param ancestors 当前校验路径上的 schema，防止不推进数据的循环引用
+ * @returns 错误说明，匹配时返回 null
+ */
+export declare function validate(value: TJson, schema: ISchema | boolean, root?: ISchema, path?: string, depth?: number, ancestors?: Array<{
+    'schema': ISchema;
+    'path': string;
+}>): string | null;

package/dist/lib/command.d.ts

@@ -0,0 +1,218 @@
+import type * as lCore from './core';
+export { showPalette } from './command/palette';
+/** --- 命令输入与输出可跨浏览器、Native 和协议传输的 JSON 值 --- */
+export type TJson = null | boolean | number | string | TJson[] | {
+    [key: string]: TJson;
+};
+/** --- JSON Schema 2020-12 的命令校验子集；不支持的关键字在注册时拒绝 --- */
+export interface ISchema {
+    '$schema'?: string;
+    '$ref'?: string;
+    '$defs'?: Record<string, ISchema | boolean>;
+    'title'?: string;
+    'description'?: string;
+    'default'?: TJson;
+    'examples'?: TJson[];
+    'type'?: 'object' | 'array' | 'string' | 'number' | 'integer' | 'boolean' | 'null';
+    'properties'?: Record<string, ISchema | boolean>;
+    'required'?: string[];
+    'additionalProperties'?: ISchema | boolean;
+    'items'?: ISchema | boolean;
+    'minItems'?: number;
+    'maxItems'?: number;
+    'uniqueItems'?: boolean;
+    'minLength'?: number;
+    'maxLength'?: number;
+    'pattern'?: string;
+    'minimum'?: number;
+    'maximum'?: number;
+    'exclusiveMinimum'?: number;
+    'exclusiveMaximum'?: number;
+    'enum'?: TJson[];
+    'const'?: TJson;
+    'allOf'?: Array<ISchema | boolean>;
+    'anyOf'?: Array<ISchema | boolean>;
+    'oneOf'?: Array<ISchema | boolean>;
+    'not'?: ISchema | boolean;
+}
+/** --- 所有入口共用的结果；错误码用于程序判断，message 用于说明 --- */
+export type TResult<T extends TJson = TJson> = {
+    'ok': true;
+    'data': T;
+} | {
+    'ok': false;
+    'error': {
+        'code': string;
+        'message': string;
+    };
+};
+/** --- 执行来源仅用于展示与记录，不是授权凭证 --- */
+export interface IContext {
+    'taskId': string;
+    'formId': string;
+    'panelId': string;
+    'source': 'user' | 'agent';
+    'signal': AbortSignal;
+}
+/** --- 与 MCP 工具描述对齐的公开命令元数据 --- */
+export interface IMetadata {
+    'name': string;
+    'title'?: string;
+    'description': string;
+    'inputSchema': ISchema & {
+        'type': 'object';
+    };
+    'outputSchema'?: ISchema;
+    /** --- 行为说明，不代替校验或授权 --- */
+    'annotations'?: {
+        'readOnlyHint'?: boolean;
+        'destructiveHint'?: boolean;
+        'idempotentHint'?: boolean;
+        'openWorldHint'?: boolean;
+        /** --- WebMCP 的重要或不可逆现实效果说明 --- */
+        'consequentialHint'?: boolean;
+        'untrustedContentHint'?: boolean;
+    };
+}
+/** --- 应用声明一次，界面、浏览器代理和 Native 适配器共享执行函数 --- */
+export interface IDefinition<T extends Record<string, TJson> = Record<string, TJson>> extends IMetadata {
+    /** --- 明确允许代理发现并调用；默认只允许应用内部调用 --- */
+    'exposed'?: boolean;
+    /** --- 默认拒绝同一命令并发；业务确认可并行时才开启 --- */
+    'concurrent'?: boolean;
+    /** --- 必须已经取得的框架权限；执行入口不弹授权窗 --- */
+    'permissions'?: string[];
+    /** --- true 为可用，false 或原因文本为不可用；每次执行重新检查 --- */
+    'enabled'?: () => boolean | string;
+    'execute': (args: T, context: IContext) => TResult | Promise<TResult>;
+}
+/** --- 不包含函数或内部对象的独立快照 --- */
+export interface IInfo extends IMetadata {
+    'taskId': string;
+    'formId': string;
+    'panelId': string;
+    'exposed': boolean;
+    'enabled': boolean;
+    'disabledReason': string;
+    'running': number;
+}
+/** --- 绑定一个应用实例，只能调用该实例明确公开的命令 --- */
+export interface IBridge {
+    'taskId': string;
+    'list': () => IInfo[];
+    'execute': (name: string, args?: Record<string, TJson>, options?: {
+        'signal'?: AbortSignal;
+    }) => Promise<TResult>;
+}
+/** --- 框架向网页发布的统一入口；按任务选择应用，只访问明确公开的命令 --- */
+export interface IPageBridge {
+    'listTasks': () => Array<{
+        'id': string;
+        'name': string;
+    }>;
+    'list': (taskId: string) => IInfo[];
+    'execute': (taskId: string, name: string, args?: Record<string, TJson>, options?: {
+        'signal'?: AbortSignal;
+    }) => Promise<TResult>;
+}
+/**
+ * --- 构造成功结果 ---
+ * @param data 可跨入口传输的 JSON 数据
+ * @returns 成功结果
+ */
+export declare function success<T extends TJson>(data: T): TResult<T>;
+/**
+ * --- 构造业务失败结果，不抛异常 ---
+ * @param code 稳定的业务错误码
+ * @param message 可公开的错误说明
+ * @returns 失败结果
+ */
+export declare function failure(code: string, message: string): TResult<never>;
+/**
+ * --- 注册命令；重复名称、不支持的 schema 或已销毁的实例返回 false ---
+ * @param current 所属任务/Form/Panel；销毁时自动移除其命令
+ * @param definition 元数据、可用条件与唯一业务执行函数
+ * @returns 是否注册成功
+ */
+export declare function register<T extends Record<string, TJson>>(current: lCore.TCurrent, definition: IDefinition<T>): boolean;
+/**
+ * --- 取消尚在执行的命令并解除注册；取消是协作式，不回滚已产生的业务效果 ---
+ * @param current 所属任务/Form/Panel
+ * @param name 命令名称
+ * @returns 是否找到并移除命令
+ */
+export declare function unregister(current: lCore.TCurrent, name: string): boolean;
+/**
+ * --- 清理所属 Panel、Form 或整个任务的命令 ---
+ * @param current 所属任务/Form/Panel
+ * @returns 无返回值
+ */
+export declare function clear(current: lCore.TCurrent): void;
+/**
+ * --- 框架生命周期使用的按所属范围清理入口 ---
+ * @internal
+ * @param taskId 所属任务
+ * @param formId 所属 Form，不传时清理任务
+ * @param panelId 所属 Panel，不传时清理整个 Form
+ * @returns 无返回值
+ */
+export declare function clearOwner(taskId: string, formId?: string, panelId?: string): void;
+/**
+ * --- 获取独立元数据和当前状态，不导出业务函数 ---
+ * @param current 所属应用
+ * @returns 命令列表
+ */
+export declare function list(current: lCore.TCurrent): IInfo[];
+/**
+ * --- 获取仍可调用的 App 标识与名称，供网页及 Native 代理发现目标 ---
+ * @returns 未开始退出的 App 列表
+ */
+export declare function listTasks(): Array<{
+    'id': string;
+    'name': string;
+}>;
+/**
+ * --- 应用界面直接执行已注册的业务命令 ---
+ * @param current 所属任务/Form
+ * @param name 命令名称
+ * @param args 参数，默认空对象
+ * @param options 取消信号
+ * @returns 业务结果
+ */
+export declare function execute(current: lCore.TCurrent, name: string, args?: Record<string, TJson>, options?: {
+    'signal'?: AbortSignal;
+}): Promise<TResult>;
+/**
+ * --- 代理直接按 taskId 执行公开命令，与界面共用校验和业务执行器 ---
+ * @param taskId 目标 App
+ * @param name 命令名称
+ * @param args 参数，默认空对象
+ * @param options 取消信号
+ * @returns 结构化结果；未公开或不存在的命令返回 not-found
+ */
+export declare function executeAgent(taskId: string, name: string, args?: Record<string, TJson>, options?: {
+    'signal'?: AbortSignal;
+}): Promise<TResult>;
+/**
+ * --- 创建绑定单个 App 的可复用代理接口，调用方无需反复传入 taskId ---
+ * @param current 所属应用
+ * @returns 不可修改的桥接接口
+ */
+export declare function createBridge(current: lCore.TCurrent): IBridge;
+/**
+ * --- 网页入口直接读取框架的任务及命令状态，无需应用或宿主重复发布与清理 ---
+ * @returns 不可修改的网页命令接口
+ */
+export declare function createPageBridge(): IPageBridge;
+/**
+ * --- 按能力检测接入当前 WebMCP API；没有 API 或注册失败时返回 false ---
+ * @param current 所属应用
+ * @returns 是否同步成功
+ */
+export declare function connectWebMcp(current: lCore.TCurrent): Promise<boolean>;
+/**
+ * --- 解除 WebMCP 适配器；内部命令继续可用 ---
+ * @param current 所属应用
+ * @returns 无返回值
+ */
+export declare function disconnectWebMcp(current: lCore.TCurrent): void;

package/dist/lib/core.d.ts

@@ -107,6 +107,12 @@ export declare abstract class AbstractApp {
     onTaskStarted(taskId: string): void | Promise<void>;
     /** --- 任务结束事件 --- */
     onTaskEnded(taskId: string): void | Promise<void>;
+    /**
+     * --- Launcher 显示状态改变事件 ---
+     * @param state 是否显示
+     * @returns 无返回值
+     */
+    onLauncherShowChanged(state: boolean): void | Promise<void>;
     /** --- launcher 文件夹名称修改事件 --- */
     onLauncherFolderNameChanged(id: string, name: string): void | Promise<void>;
     /** --- location hash 改变事件 --- */
@@ -238,7 +244,7 @@ export interface IAvailArea {
     'oheight': number;
 }
 /** --- 全局事件类型 --- */
-export type TGlobalEvent = 'trayCreated' | 'trayChanged' | 'trayRemoved' | 'error' | 'screenResize' | 'configChanged' | 'formCreated' | 'formRemoved' | 'formTitleChanged' | 'formIconChanged' | 'formStateMinChanged' | 'formStateMaxChanged' | 'formShowChanged' | 'formFocused' | 'formBlurred' | 'formFlash' | 'formShowInSystemTaskChange' | 'formHashChange' | 'taskStarted' | 'taskEnded' | 'launcherFolderNameChanged' | 'hashChanged' | 'keydown' | 'keyup';
+export type TGlobalEvent = 'trayCreated' | 'trayChanged' | 'trayRemoved' | 'error' | 'screenResize' | 'configChanged' | 'formCreated' | 'formRemoved' | 'formTitleChanged' | 'formIconChanged' | 'formStateMinChanged' | 'formStateMaxChanged' | 'formShowChanged' | 'formFocused' | 'formBlurred' | 'formFlash' | 'formShowInSystemTaskChange' | 'formHashChange' | 'taskStarted' | 'taskEnded' | 'launcherShowChanged' | 'launcherFolderNameChanged' | 'hashChanged' | 'keydown' | 'keyup';
 /** --- 现场下载 app 的参数 --- */
 export interface ICoreFetchAppOptions {
     'notify'?: number | {

package/dist/lib/form.d.ts

@@ -324,6 +324,12 @@ export declare abstract class AbstractForm extends AbstractCommon {
     onTaskStarted(taskId: string): void | Promise<void>;
     /** --- 任务结束事件 --- */
     onTaskEnded(taskId: string): void | Promise<void>;
+    /**
+     * --- Launcher 显示状态改变事件 ---
+     * @param state 是否显示
+     * @returns 无返回值
+     */
+    onLauncherShowChanged(state: boolean): void | Promise<void>;
     /** --- launcher 文件夹名称修改事件 --- */
     onLauncherFolderNameChanged(id: string, name: string): void | Promise<void>;
     /** --- location hash 改变事件 --- */
@@ -659,11 +665,18 @@ export declare function prompt(current: lCore.TCurrent, opt: string | IFormPromp
  */
 export declare function flash(current: lCore.TCurrent, formId: string): Promise<void>;
 /**
- * --- 显示 launcher 界面 ---
+ * --- 查询 Launcher 当前显示状态，供首次挂载时同步 ---
+ * @returns 是否显示
+ */
+export declare function getLauncherShow(): boolean;
+/**
+ * --- 显示 launcher 界面；状态变化时通知所有应用与窗体 ---
+ * @returns 无返回值
  */
 export declare function showLauncher(): void;
 /**
- * --- 隐藏 launcher 界面 ---
+ * --- 隐藏 launcher 界面；重复关闭不重复通知或安排清理 ---
+ * @returns 无返回值
  */
 export declare function hideLauncher(): void;
 export declare function init(): void;

package/dist/lib/native.d.ts

@@ -4,6 +4,18 @@ import * as lCore from './core';
  * @param id 系统级 ID
  */
 export declare function initSysId(id: string): void;
+/** --- 本地 MCP 客户端连接设置；仅向已授权 root 的 App 提供 --- */
+export interface IMcpInfo {
+    'transport': 'streamable-http';
+    'url': string;
+    'token': string;
+}
+/**
+ * --- 读取 Native 主进程启用的 MCP 连接设置 ---
+ * @param current 当前 App
+ * @returns 连接设置；未启用为 null，无权限为 false
+ */
+export declare function getMcpInfo(current: lCore.TCurrent): Promise<IMcpInfo | null | false>;
 /**
  * --- 监听 native 传输过来的事件 ---
  * @param current 当前任务 ID

package/dist/lib/task.d.ts

@@ -260,6 +260,8 @@ export interface IThread {
 }
 /** --- 运行中的任务对象 --- */
 export interface ITask {
+    /** --- 已开始退出；框架释放异步资源期间拒绝新命令 --- */
+    'ending'?: boolean;
     'id': string;
     'app': lCore.IApp;
     'class': lCore.AbstractApp;