@mearl/client 2.21.0 → 2.22.1

package/dist/index.js

@@ -1,15 +1,15 @@
-export { PluginHostConnection, } from './pluginHostConnection.js';
+export { PluginHostConnection, } from './plugins/clients/pluginHostConnection.js';
 /**
  * @mearl/client — unified Mearl browser client
  *
  * Discovers browser targets on this machine and every configured cloud connector,
  * then routes actions using the global browser ids returned by browser_list.
  */
-export { PluginTaskClient, } from './pluginTasks.js';
-export { PluginPageClient } from './pluginPages.js';
-export { executeRegisteredPlugin, } from './plugin.js';
+export { PluginTaskClient, } from './plugins/clients/pluginTasks.js';
+export { PluginPageClient } from './plugins/clients/pluginPages.js';
+export { executeRegisteredPlugin, } from './plugins/sdk/plugin.js';
 export { UnifiedClient, UnifiedClient as MearlClient, decodeBrowserTarget, invoke, invokePlugin, listCloudConnectors, } from './unified.js';
-export { APP_PROFILE_NAMES, BROWSER_DEVICE_PRESET_NAMES, BROWSER_ACTIONS, BROWSER_CAPABILITY_ACTIONS, BROWSER_COMMAND_ACTIONS, EXTENSION_BROWSER_ACTIONS, PAGE_ACT_ACTIONS, SEND_REQUEST_MAX_FILES, SEND_REQUEST_MAX_TOTAL_BASE64_FILE_BYTES, SEND_REQUEST_MAX_TOTAL_FILE_BYTES, isBrowserAction, isBrowserCapabilityAction, isBrowserCommandAction, isExtensionBrowserAction, } from './generated-browser-action-protocol.js';
+export { APP_PROFILE_NAMES, BROWSER_DEVICE_PRESET_NAMES, BROWSER_ACTIONS, BROWSER_CAPABILITY_ACTIONS, BROWSER_COMMAND_ACTIONS, EXTENSION_BROWSER_ACTIONS, PAGE_ACT_ACTIONS, SEND_REQUEST_MAX_FILES, SEND_REQUEST_MAX_TOTAL_BASE64_FILE_BYTES, SEND_REQUEST_MAX_TOTAL_FILE_BYTES, isBrowserAction, isBrowserCapabilityAction, isBrowserCommandAction, isExtensionBrowserAction, } from './generated/browser-action-protocol.js';
 import { invoke } from './unified.js';
 export function tabCheckpoint(params, options) {
     return invoke('tab_checkpoint', params, options);
@@ -144,5 +144,5 @@ export async function saveArtifact(artifact, outputPath, options = {}) {
     const { exportArtifact } = await import('./artifacts.js');
     return exportArtifact({ invoke }, artifact, outputPath, options);
 }
-export { PluginStateClient } from './pluginState.js';
-export { PluginModelClient } from './pluginModels.js';
+export { PluginStateClient } from './plugins/clients/pluginState.js';
+export { PluginModelClient } from './plugins/clients/pluginModels.js';

package/dist/pageEvalArguments.d.ts

@@ -1,3 +1,3 @@
-import { type PageEvalParams } from './generated-browser-action-protocol.js';
+import { type PageEvalParams } from './generated/browser-action-protocol.js';
 /** Serialize page_eval arguments within transport limits while retaining the caller's execution world. */
 export declare function invokePageEvalWithArgs(invoke: (payload: Record<string, unknown>, transfer?: boolean) => Promise<any>, params: PageEvalParams): Promise<any>;

package/dist/pageEvalArguments.js

@@ -1,5 +1,5 @@
 import { randomUUID } from 'node:crypto';
-import { validatePageUserScriptParams, resolvePageEvalExpression, } from './generated-browser-action-protocol.js';
+import { validatePageUserScriptParams, resolvePageEvalExpression, } from './generated/browser-action-protocol.js';
 const CHUNK_CHARACTERS = 48 * 1024;
 /** Serialize page_eval arguments within transport limits while retaining the caller's execution world. */
 export async function invokePageEvalWithArgs(invoke, params) {

package/dist/plugin-task-host.js

@@ -1,4 +1,4 @@
-import { startPluginHostServer } from './pluginHostServer.js';
+import { startPluginHostServer } from './plugins/runtime/pluginHostServer.js';
 try {
     const server = await startPluginHostServer();
     const close = () => {

package/dist/plugin-worker.js

@@ -1,9 +1,9 @@
-import { supervisePluginExecutor } from './pluginExecutorSupervisor.js';
+import { supervisePluginExecutor } from './plugins/runtime/pluginExecutorSupervisor.js';
 if (process.argv[2] === '--command') {
     let command;
     // Register IPC before loading command code so startup messages retain their order.
     process.on('message', (message) => {
-        void (command ??= import('./pluginCommandWorker.js'))
+        void (command ??= import('./plugins/runtime/pluginCommandWorker.js'))
             .then(worker => worker.handlePluginWorkerMessage(message))
             .catch(error => {
             process.stderr.write(String(error));

package/dist/plugin.d.ts

@@ -1,118 +1,2 @@
-import type { PluginTaskRecoveryDeclaration, PluginTaskCheckpoint, PluginCheckpointMigrationInput } from './generated-plugin-recovery.js';
-import type { PluginStateDeclaration } from './generated-plugin-state.js';
-import type { PluginModelRequest, PluginModelResult } from './generated-plugin-models.js';
-import type { PluginPageRuntime } from './generated-plugin-pages.js';
-import type { AppProfileContribution } from './generated-app-profile-definition.js';
-export type { AppProfileContribution, AppProfileDefinition, } from './generated-app-profile-definition.js';
-export { invokePageEvalWithArgs } from './pageEvalArguments.js';
-import { type OfficialPluginInstaller } from './officialPluginInstaller.js';
-import { type PluginToolboxContribution, type PluginRegistration } from './pluginRegistry.js';
-import { type PluginCommandContext, type PluginInvocationIdentity, type PluginInvocationSource } from './pluginExecution.js';
-import type { UnifiedInvokeOptions } from './unified.js';
-export type { PluginCommandContext, PluginExecutionHost, PluginInvocationIdentity, PluginInvocationSource, } from './pluginExecution.js';
-export { executeRegisteredPlugin, type PluginExecutorOptions, type PluginExecutorDependencies, } from './pluginExecutor.js';
-export { PluginTaskClient } from './pluginTasks.js';
-export { cleanupPluginRuntime } from './pluginRuntimeCleanup.js';
-export { PluginPageClient } from './pluginPages.js';
-export { assertPluginName, findPluginDirectoryEntry, findPluginEntry, findPluginRegistration, listPluginNames, pluginDirectory, registerPlugin, resolvePluginEntry, unregisterPlugin, PluginError, readPluginPageBundleChunk, type PluginRegistration, type PluginRegistrationOptions, type PluginToolboxAgentConfig, type PluginPageBundleRegistration, type PluginToolboxContribution, type PluginToolboxLocale, type PluginToolboxSandboxPage, } from './pluginRegistry.js';
-export { findOfficialPlugin, listOfficialPluginNames, OFFICIAL_PLUGIN_MANAGER, OFFICIAL_PLUGINS, type OfficialPluginDefinition, type OfficialPluginName, } from './officialPluginCatalog.js';
-export type PluginOptions = UnifiedInvokeOptions;
-export interface StructuredPluginProgress {
-    message: string;
-    data?: Record<string, unknown>;
-}
-export type PluginProgress = string | StructuredPluginProgress;
-export interface PluginInvocation {
-    command: string;
-    input: Record<string, any>;
-}
-export interface PluginInvokeOptions extends UnifiedInvokeOptions {
-    onProgress?: (progress: PluginProgress) => void;
-    signal?: AbortSignal;
-    /** Audit label supplied by the entry point, never an authorization decision. */
-    source?: PluginInvocationSource;
-}
-export interface PluginExecutionContext {
-    runModel?(plugin: string, request: PluginModelRequest, options: Pick<PluginInvokeOptions, 'signal' | 'onProgress'>): Promise<PluginModelResult>;
-    ensurePlugin?: OfficialPluginInstaller;
-    source?: PluginInvocationSource;
-    parentInvocation?: PluginInvocationIdentity;
-    invocation?: PluginInvocationIdentity;
-    resolveRegistration?: (name: string) => PluginRegistration | undefined;
-    invoke(action: string, payload?: Record<string, any>, options?: UnifiedInvokeOptions, onProgress?: PluginInvokeOptions['onProgress']): Promise<any>;
-}
-export interface PluginApp {
-    readonly options: Readonly<PluginOptions>;
-    /** Examples omit the `mearl <plugin>` prefix, which help adds when displayed. */
-    command(signature: string, handler: PluginHandler, description?: string, examples?: string[]): void;
-    /** Registers a page-only command, also declared in toolbox.page.commands. */
-    state(collection: string, operation: string, input?: Record<string, unknown>): Promise<any>;
-    model(request: PluginModelRequest, options?: Pick<PluginInvokeOptions, 'onProgress'>): Promise<PluginModelResult>;
-    runtimeCommand(signature: string, handler: PluginHandler, description?: string, examples?: string[]): void;
-    recoveryCommand(command: string, handler: PluginHandler): void;
-    checkpointMigration(command: string, handler: (input: PluginCheckpointMigrationInput, context: PluginCommandContext) => unknown | Promise<unknown>): void;
-    checkpoint(data: unknown, expectedSequence: number): Promise<PluginTaskCheckpoint>;
-    page(operation: string, input?: Record<string, unknown>): Promise<any>;
-    toolboxCommand(signature: string, handler: PluginHandler, description?: string, examples?: string[]): void;
-    invoke(action: string, payload?: Record<string, any>, options?: UnifiedInvokeOptions): Promise<any>;
-    progress(progress: PluginProgress): void;
-}
-export type PluginHandler = (input: Record<string, any>, context: PluginCommandContext) => unknown | Promise<unknown>;
-/** 工具列表仅检查入口；页面资源只在打开对应工具时检查。 */
-export declare function refreshRegisteredPlugin(name: string, includePage?: boolean): Promise<PluginRegistration | undefined>;
-/** 注册和执行复用同一宿主能力边界；仅 handler 执行期间开放浏览器调用。 */
-export declare function loadPlugin(entry: string, context: Pick<PluginApp, 'options' | 'progress'> & {
-    invoke: PluginExecutionContext['invoke'];
-    source?: PluginInvocationSource;
-    parentInvocation?: PluginInvocationIdentity;
-    invocation?: PluginInvocationIdentity;
-    signal?: AbortSignal;
-    runModel?: PluginExecutionContext['runModel'];
-    onInvocation?: (identity: PluginInvocationIdentity | undefined) => void;
-}, pluginName?: string): Promise<{
-    name: string | undefined;
-    description: string | undefined;
-    toolbox: PluginToolboxContribution | undefined;
-    pageRuntime: PluginPageRuntime | undefined;
-    stateStorage: PluginStateDeclaration | undefined;
-    taskRecovery: PluginTaskRecoveryDeclaration | undefined;
-    appProfiles: AppProfileContribution | undefined;
-    profileSources: Record<string, string> | undefined;
-    version: string | undefined;
-    commandHelp(namespace: string): string;
-    help(namespace: string, name?: string): string;
-    run(positionals: string[], payload?: unknown, namedInput?: Record<string, unknown>): Promise<unknown>;
-    runRuntime(invocation: PluginInvocation): Promise<unknown>;
-    runRecovery(invocation: PluginInvocation): Promise<unknown>;
-    runMigration(invocation: PluginInvocation): Promise<unknown>;
-    runToolbox(invocation: PluginInvocation): Promise<unknown>;
-}>;
-export declare function loadRegisteredPlugin(name: string, context: PluginExecutionContext, options?: PluginInvokeOptions): Promise<{
-    name: string | undefined;
-    description: string | undefined;
-    toolbox: PluginToolboxContribution | undefined;
-    pageRuntime: PluginPageRuntime | undefined;
-    stateStorage: PluginStateDeclaration | undefined;
-    taskRecovery: PluginTaskRecoveryDeclaration | undefined;
-    appProfiles: AppProfileContribution | undefined;
-    profileSources: Record<string, string> | undefined;
-    version: string | undefined;
-    commandHelp(namespace: string): string;
-    help(namespace: string, name?: string): string;
-    run(positionals: string[], payload?: unknown, namedInput?: Record<string, unknown>): Promise<unknown>;
-    runRuntime(invocation: PluginInvocation): Promise<unknown>;
-    runRecovery(invocation: PluginInvocation): Promise<unknown>;
-    runMigration(invocation: PluginInvocation): Promise<unknown>;
-    runToolbox(invocation: PluginInvocation): Promise<unknown>;
-}>;
-export declare function invokeRegisteredPlugin(name: string, invocation: PluginInvocation, context: PluginExecutionContext, options?: PluginInvokeOptions): Promise<unknown>;
-/** Entry point for the native toolbox service; nested plugin calls retain public-command access. */
-export declare function invokeRegisteredToolboxPlugin(name: string, invocation: PluginInvocation, context: PluginExecutionContext, options?: PluginInvokeOptions): Promise<unknown>;
-export declare function invokeRegisteredRuntimePlugin(name: string, invocation: PluginInvocation, context: PluginExecutionContext, options?: PluginInvokeOptions): Promise<unknown>;
-export declare function invokeRegisteredRecoveryPlugin(name: string, invocation: PluginInvocation, context: PluginExecutionContext, options?: PluginInvokeOptions): Promise<unknown>;
-export { PluginStateClient } from './pluginState.js';
-export { PluginModelClient } from './pluginModels.js';
-export type * from './generated-plugin-state.js';
-export type * from './generated-plugin-models.js';
-export type * from './generated-plugin-recovery.js';
-export type * from './generated-plugin-diagnostics.js';
+export * from './plugins/sdk/plugin.js';
+export * from './plugins/skillManifest.js';