@mearl/client 2.22.0 → 3.0.0-beta.0

package/dist/plugins/runtime/pluginHostServer.js

@@ -2,7 +2,7 @@ import { randomUUID } from 'node:crypto';
 import { createServer } from 'node:net';
 import { chmodSync, rmSync } from 'node:fs';
 import { claimRecord, isProcessOwnerAlive, processIdentity, readRecord, removeInvalidRecord, removeRecordIfPid, writeRecordIfPid, } from '@mearl/daemon-core';
-import { PLUGIN_TASK_PROTOCOL_VERSION } from '../../generated/plugin-tasks.js';
+import { PLUGIN_TASK_PROTOCOL_VERSION } from '@mearl/browser-core';
 import { pluginHostPaths } from './pluginHostPaths.js';
 import { PluginHost } from './pluginHost.js';
 import { readPluginTaskMessages, writePluginTaskMessage } from '../pluginTaskWire.js';

package/dist/plugins/runtime/pluginModelCatalog.d.ts

@@ -1,4 +1,4 @@
-import type { PluginModelList, PluginModelOption } from '../../generated/plugin-models.js';
+import type { PluginModelList, PluginModelOption } from '@mearl/browser-core';
 /** A bounded shared lookup avoids starting a discovery process for each open tool. */
 export declare class PluginModelCatalog {
     private readonly discover;

package/dist/plugins/runtime/pluginPageManager.d.ts

@@ -1,9 +1,9 @@
-import type { PluginDiagnosticPage } from '../../generated/plugin-diagnostics.js';
+import type { PluginDiagnosticPage } from '@mearl/browser-core';
 import type { PluginStateManager } from './pluginStateManager.js';
-import type { PluginInvocationIdentity } from '../../generated/plugin-execution.js';
+import type { PluginInvocationIdentity } from '@mearl/browser-core';
 import type { PluginRevision } from './pluginRevision.js';
 import type { PluginOptions } from '../sdk/plugin.js';
-import type { PluginPageTarget } from '../../generated/plugin-pages.js';
+import type { PluginPageTarget } from '@mearl/browser-core';
 import type { PluginTaskBridge, PluginTaskManager } from './pluginTaskManager.js';
 interface Execution {
     cwd: string;

package/dist/plugins/runtime/pluginPageManager.js

@@ -9,8 +9,8 @@ import { compilePluginPageSchema } from '../sdk/pluginPageDefinition.js';
 import { UnifiedClient, decodeBrowserTarget } from '../../unified.js';
 import { pluginHostPaths } from './pluginHostPaths.js';
 import { serializePluginExecutionError, pluginExecutionError } from './pluginExecutorProtocol.js';
-import { isPluginTaskActive } from '../../generated/plugin-tasks.js';
-import { isPluginPageInstanceId, matchesPluginPageURL, isPluginPageInvalidation, isPluginPageUnavailable, pluginPageUnavailable, PLUGIN_PAGE_LEASE_MS, } from '../../generated/plugin-pages.js';
+import { isPluginTaskActive } from '@mearl/browser-core';
+import { isPluginPageInstanceId, matchesPluginPageURL, isPluginPageInvalidation, isPluginPageUnavailable, pluginPageUnavailable, PLUGIN_PAGE_LEASE_MS, } from '@mearl/browser-core';
 function failure(code, message) {
     return Object.assign(new Error(message), { code });
 }

package/dist/plugins/runtime/pluginRevision.js

@@ -5,6 +5,7 @@ import { claimRecord, readRecord, writeRecord } from '@mearl/daemon-core';
 import { isBuiltin } from 'node:module';
 import { parse } from 'acorn';
 import { pluginHostPaths } from './pluginHostPaths.js';
+import { skillManifestPath } from '../skillManifest.js';
 import { findPluginRegistration, PluginError } from '../pluginRegistry.js';
 const MAX_REVISION_BYTES = 64 * 1024 * 1024;
 const validatedSources = new Set();
@@ -15,7 +16,7 @@ function within(root, file) {
 function sourceRoot(entry) {
     let candidate = dirname(entry);
     for (let depth = 0; depth < 6; depth++) {
-        if (existsSync(join(candidate, 'SKILL.md')))
+        if (skillManifestPath(candidate))
             return candidate;
         const parent = dirname(candidate);
         if (parent === candidate)

package/dist/plugins/runtime/pluginStateManager.d.ts

@@ -2,7 +2,7 @@ import type { PluginRevision } from './pluginRevision.js';
 import { PluginStateStore } from './pluginStateStore.js';
 import type { PluginTaskManager, PluginTaskBridge } from './pluginTaskManager.js';
 import type { PluginOptions } from '../sdk/plugin.js';
-import type { PluginPageTarget } from '../../generated/plugin-pages.js';
+import type { PluginPageTarget } from '@mearl/browser-core';
 export declare class PluginStateManager {
     private readonly tasks;
     readonly store: PluginStateStore;

package/dist/plugins/runtime/pluginStateStore.d.ts

@@ -1,4 +1,4 @@
-import type { PluginStateCollection, PluginStateEntry, PluginStateTransaction } from '../../generated/plugin-state.js';
+import type { PluginStateCollection, PluginStateEntry, PluginStateTransaction } from '@mearl/browser-core';
 export interface PluginStateNamespace {
     installationId: string;
     collection: string;

package/dist/plugins/runtime/pluginTaskManager.d.ts

@@ -1,19 +1,19 @@
 import type { PluginModelCatalog } from './pluginModelCatalog.js';
 import type { PluginStateManager } from './pluginStateManager.js';
 import type { PluginPageManager } from './pluginPageManager.js';
-import type { PluginStateDeclaration } from '../../generated/plugin-state.js';
-import type { PluginTaskCheckpoint, PluginTaskRecoveryContext, PluginTaskRecoveryDeclaration } from '../../generated/plugin-recovery.js';
+import type { PluginStateDeclaration } from '@mearl/browser-core';
+import type { PluginTaskCheckpoint, PluginTaskRecoveryContext, PluginTaskRecoveryDeclaration } from '@mearl/browser-core';
 import { executeRegisteredPlugin } from './pluginExecutor.js';
 import { capturePluginRevision } from './pluginRevision.js';
 import type { PluginRevision } from './pluginRevision.js';
 import { PluginTaskStore } from './pluginTaskStore.js';
-import type { PluginTask, PluginTaskStartResult, PluginTaskListResult } from '../../generated/plugin-tasks.js';
+import type { PluginTask, PluginTaskStartResult, PluginTaskListResult } from '@mearl/browser-core';
 import type { PluginTaskScope, PluginTaskStartRequest, PluginTaskResumeRequest } from '../pluginTaskProtocol.js';
-import type { PluginInvocationIdentity } from '../../generated/plugin-execution.js';
-import type { PluginPageTarget } from '../../generated/plugin-pages.js';
+import type { PluginInvocationIdentity } from '@mearl/browser-core';
+import type { PluginPageTarget } from '@mearl/browser-core';
 import type { PluginOptions } from '../sdk/plugin.js';
-import type { PluginPageBinding } from '../../generated/plugin-pages.js';
-import type { PluginPageRuntime } from '../../generated/plugin-pages.js';
+import type { PluginPageBinding } from '@mearl/browser-core';
+import type { PluginPageRuntime } from '@mearl/browser-core';
 export interface PluginTaskBridge {
     id: string;
     scope: PluginTaskScope;
@@ -37,7 +37,7 @@ export interface PluginTaskServices {
 export declare class PluginTaskManager {
     private readonly configuration;
     private readonly services?;
-    readonly host: import("./pluginExecution.js").PluginExecutionHost;
+    readonly host: import("@mearl/browser-core").PluginExecutionHost;
     readonly store: PluginTaskStore;
     private readonly changes;
     private readonly queue;
@@ -78,8 +78,8 @@ export declare class PluginTaskManager {
     private resumeAttempt;
     private assertExecutionTreeStopped;
     cancel(taskId: string, scope: PluginTaskScope): PluginTask;
-    events(taskId: string, scope: PluginTaskScope, cursor: number, waitMs?: number, signal?: AbortSignal): Promise<import("../../generated/plugin-tasks.js").PluginTaskEvents>;
-    resultChunk(taskId: string, scope: PluginTaskScope, index: number): import("../../generated/plugin-tasks.js").PluginTaskResultChunk;
+    events(taskId: string, scope: PluginTaskScope, cursor: number, waitMs?: number, signal?: AbortSignal): Promise<import("@mearl/browser-core").PluginTaskEvents>;
+    resultChunk(taskId: string, scope: PluginTaskScope, index: number): import("@mearl/browser-core").PluginTaskResultChunk;
     private update;
     private drain;
     private execute;

package/dist/plugins/runtime/pluginTaskManager.js

@@ -12,7 +12,7 @@ import { serializePluginExecutionError, pluginExecutionError } from './pluginExe
 import { capturePluginRevision, prunePluginRevisions, restorePluginRevision, } from './pluginRevision.js';
 import { pluginHostPaths } from './pluginHostPaths.js';
 import { PluginTaskStore, pluginTaskExecutionUnconfirmed } from './pluginTaskStore.js';
-import { isPluginTaskActive } from '../../generated/plugin-tasks.js';
+import { isPluginTaskActive } from '@mearl/browser-core';
 import { UnifiedClient, decodeBrowserTarget } from '../../unified.js';
 import { COMMAND_MAP } from '../../commands.js';
 function error(code, message) {

package/dist/plugins/runtime/pluginTaskStore.d.ts

@@ -1,6 +1,6 @@
-import type { PluginTaskDiagnosticMetadata } from '../../generated/plugin-diagnostics.js';
-import type { PluginTask, PluginTaskEvent, PluginTaskEvents, PluginTaskResultChunk } from '../../generated/plugin-tasks.js';
-import type { PluginTaskCheckpoint } from '../../generated/plugin-recovery.js';
+import type { PluginTaskDiagnosticMetadata } from '@mearl/browser-core';
+import type { PluginTask, PluginTaskEvent, PluginTaskEvents, PluginTaskResultChunk } from '@mearl/browser-core';
+import type { PluginTaskCheckpoint } from '@mearl/browser-core';
 import type { PluginOptions } from '../sdk/plugin.js';
 export declare const PLUGIN_TASK_RESULT_CHUNK_BYTES: number;
 export interface PluginTaskRecord {

package/dist/plugins/runtime/pluginTaskStore.js

@@ -1,7 +1,7 @@
 import { createHash } from 'node:crypto';
 import { closeSync, openSync, opendirSync, readFileSync, readSync, readdirSync, rmSync, statSync, } from 'node:fs';
 import { join } from 'node:path';
-import { isPluginTaskActive, isPluginTaskId } from '../../generated/plugin-tasks.js';
+import { isPluginTaskActive, isPluginTaskId } from '@mearl/browser-core';
 import { writePluginHostFile } from './pluginHostFiles.js';
 import { pluginHostPaths } from './pluginHostPaths.js';
 import { isProcessGroupAlive, isProcessOwnerAlive } from '@mearl/daemon-core';

package/dist/plugins/runtime/pythonPlugin.d.ts

@@ -28,4 +28,4 @@ export interface PythonPluginApp {
     progress(message: string): void;
 }
 export declare function describePythonPlugin(entry: string, options: Readonly<PluginOptions>): Promise<PythonPluginDescriptor>;
-export declare function runPythonPluginCommand(entry: string, command: string, input: Record<string, any> | import('../../generated/plugin-recovery.js').PluginCheckpointMigrationInput, app: PythonPluginApp, context: PluginCommandContext, recovery?: boolean | 'migration', expectedDescriptor?: PythonPluginDescriptor, runtimeOnly?: boolean): Promise<unknown>;
+export declare function runPythonPluginCommand(entry: string, command: string, input: Record<string, any> | import('@mearl/browser-core').PluginCheckpointMigrationInput, app: PythonPluginApp, context: PluginCommandContext, recovery?: boolean | 'migration', expectedDescriptor?: PythonPluginDescriptor, runtimeOnly?: boolean): Promise<unknown>;

package/dist/plugins/sdk/plugin.d.ts

@@ -1,9 +1,9 @@
-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';
+import type { PluginTaskRecoveryDeclaration, PluginTaskCheckpoint, PluginCheckpointMigrationInput } from '@mearl/browser-core';
+import type { PluginStateDeclaration } from '@mearl/browser-core';
+import type { PluginModelRequest, PluginModelResult } from '@mearl/browser-core';
+import type { PluginPageRuntime } from '@mearl/browser-core';
+import type { AppProfileContribution } from '@mearl/browser-core';
+export type { AppProfileContribution, AppProfileDefinition, } from '@mearl/browser-core';
 export { invokePageEvalWithArgs } from '../../pageEvalArguments.js';
 import { type OfficialPluginInstaller } from '../officialPluginInstaller.js';
 import { type PluginToolboxContribution, type PluginRegistration } from '../pluginRegistry.js';
@@ -14,8 +14,8 @@ export { executeRegisteredPlugin, type PluginExecutorOptions, type PluginExecuto
 export { PluginTaskClient } from '../clients/pluginTasks.js';
 export { cleanupPluginRuntime } from '../runtime/pluginRuntimeCleanup.js';
 export { PluginPageClient } from '../clients/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 { assertPluginName, findPluginDirectoryEntry, findPluginEntry, findPluginRegistration, pluginRegistrationNeedsRefresh, 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, readOfficialPluginCatalog, replaceOfficialPluginCatalog, validateOfficialPluginCatalog, type PluginCatalogSelection, type PluginCatalog, type OfficialPluginDefinition, type OfficialPluginName, } from '../officialPluginCatalog.js';
 export type PluginOptions = UnifiedInvokeOptions;
 export interface StructuredPluginProgress {
     message: string;
@@ -112,7 +112,4 @@ export declare function invokeRegisteredRuntimePlugin(name: string, invocation:
 export declare function invokeRegisteredRecoveryPlugin(name: string, invocation: PluginInvocation, context: PluginExecutionContext, options?: PluginInvokeOptions): Promise<unknown>;
 export { PluginStateClient } from '../clients/pluginState.js';
 export { PluginModelClient } from '../clients/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 type * from '@mearl/browser-core';

package/dist/plugins/sdk/plugin.js

@@ -3,7 +3,7 @@ import { normalizePluginTaskRecovery, pluginRecoverySignature, } from './pluginR
 import { normalizePluginPageRuntime } from './pluginPageDefinition.js';
 import { loadPluginAppProfiles } from './pluginAppProfiles.js';
 export { invokePageEvalWithArgs } from '../../pageEvalArguments.js';
-import { readFileSync } from 'node:fs';
+import { readInstalledSkillMetadata } from '../skillManifest.js';
 import { dirname, extname, resolve } from 'node:path';
 import { pathToFileURL } from 'node:url';
 import { Command } from 'commander';
@@ -18,14 +18,11 @@ export { executeRegisteredPlugin, } from '../runtime/pluginExecutor.js';
 export { PluginTaskClient } from '../clients/pluginTasks.js';
 export { cleanupPluginRuntime } from '../runtime/pluginRuntimeCleanup.js';
 export { PluginPageClient } from '../clients/pluginPages.js';
-export { assertPluginName, findPluginDirectoryEntry, findPluginEntry, findPluginRegistration, listPluginNames, pluginDirectory, registerPlugin, resolvePluginEntry, unregisterPlugin, PluginError, readPluginPageBundleChunk, } from '../pluginRegistry.js';
-export { findOfficialPlugin, listOfficialPluginNames, OFFICIAL_PLUGIN_MANAGER, OFFICIAL_PLUGINS, } from '../officialPluginCatalog.js';
+export { assertPluginName, findPluginDirectoryEntry, findPluginEntry, findPluginRegistration, pluginRegistrationNeedsRefresh, listPluginNames, pluginDirectory, registerPlugin, resolvePluginEntry, unregisterPlugin, PluginError, readPluginPageBundleChunk, } from '../pluginRegistry.js';
+export { findOfficialPlugin, listOfficialPluginNames, OFFICIAL_PLUGIN_MANAGER, OFFICIAL_PLUGINS, readOfficialPluginCatalog, replaceOfficialPluginCatalog, validateOfficialPluginCatalog, } from '../officialPluginCatalog.js';
 function readPluginVersion(entry) {
     try {
-        const content = readFileSync(resolve(dirname(entry), '..', 'SKILL.md'), 'utf8');
-        const frontmatter = content.match(/^---\r?\n([\s\S]*?)\r?\n---/)?.[1];
-        const versionLine = frontmatter?.split(/\r?\n/).find(line => /^version:\s*/.test(line));
-        return versionLine?.match(/^version:\s*["']?([^"'#\s]+)["']?\s*$/)?.[1];
+        return readInstalledSkillMetadata(resolve(dirname(entry), '..'))?.version;
     }
     catch {
         return undefined;

package/dist/plugins/sdk/pluginAppProfiles.d.ts

@@ -1,4 +1,4 @@
-import { type AppProfileContribution } from '../../generated/app-profile-definition.js';
+import { type AppProfileContribution } from '@mearl/browser-core';
 /** Profile resources share the Skill root and metadata refresh rules of toolbox resources. */
 export declare function loadPluginAppProfiles(entry: string, value: unknown): {
     appProfiles?: AppProfileContribution;

package/dist/plugins/sdk/pluginAppProfiles.js

@@ -1,6 +1,6 @@
 import { readFileSync, realpathSync } from 'node:fs';
 import { basename, dirname, isAbsolute, relative, resolve } from 'node:path';
-import { validateAppProfileContribution, } from '../../generated/app-profile-definition.js';
+import { validateAppProfileContribution, } from '@mearl/browser-core';
 import { pluginFileVersion } from '../pluginSource.js';
 /** Profile resources share the Skill root and metadata refresh rules of toolbox resources. */
 export function loadPluginAppProfiles(entry, value) {

package/dist/plugins/sdk/pluginModelDefinition.d.ts

@@ -1,4 +1,4 @@
-import type { PluginModelCapability, PluginModelRequest, PluginModelResult } from '../../generated/plugin-models.js';
+import type { PluginModelCapability, PluginModelRequest, PluginModelResult } from '@mearl/browser-core';
 export declare function pluginModelCapabilities(): {
     providers: PluginModelCapability[];
 };

package/dist/plugins/sdk/pluginPageDefinition.d.ts

@@ -1,3 +1,3 @@
-import type { PluginPageRuntime } from '../../generated/plugin-pages.js';
+import type { PluginPageRuntime } from '@mearl/browser-core';
 export declare function normalizePluginPageRuntime(value: unknown): PluginPageRuntime | undefined;
 export declare function compilePluginPageSchema(schema: Record<string, unknown>): import("ajv/dist/core.js").AnyValidateFunction<unknown>;

package/dist/plugins/sdk/pluginPageDefinition.js

@@ -1,6 +1,6 @@
 import { parse } from 'acorn';
 import { Ajv } from 'ajv';
-import { isPluginPageMatchPattern } from '../../generated/plugin-pages.js';
+import { isPluginPageMatchPattern } from '@mearl/browser-core';
 const validators = new WeakMap();
 export function normalizePluginPageRuntime(value) {
     if (value === undefined)

package/dist/plugins/sdk/pluginRecoveryDefinition.d.ts

@@ -1,3 +1,3 @@
-import type { PluginTaskRecoveryDeclaration } from '../../generated/plugin-recovery.js';
+import type { PluginTaskRecoveryDeclaration } from '@mearl/browser-core';
 export declare function normalizePluginTaskRecovery(value: unknown): PluginTaskRecoveryDeclaration | undefined;
 export declare function pluginRecoverySignature(value: unknown): string;

package/dist/plugins/sdk/pluginStateDefinition.d.ts

@@ -1,4 +1,4 @@
-import type { PluginStateDeclaration } from '../../generated/plugin-state.js';
+import type { PluginStateDeclaration } from '@mearl/browser-core';
 export declare function compilePluginStateSchema(schema: Record<string, unknown>): import("ajv/dist/core.js").AnyValidateFunction<unknown>;
 export declare function normalizePluginState(value: unknown): PluginStateDeclaration | undefined;
-export declare function pluginStateSignature(collection: import('../../generated/plugin-state.js').PluginStateCollection): string;
+export declare function pluginStateSignature(collection: import('@mearl/browser-core').PluginStateCollection): string;

package/dist/plugins/skillManifest.d.ts

@@ -0,0 +1,10 @@
+export declare const DISABLED_SKILL_MANIFEST = "SKILL.md.mearl-disabled";
+/** Read the identity fields used by the runtime, including disabled Skills. */
+export declare function readInstalledSkillMetadata(directory: string): {
+    name?: string;
+    version?: string;
+} | undefined;
+/** 保留的清单供工具运行时读取，但不参与 Agent 的 SKILL.md 发现。 */
+export declare function skillManifestPath(directory: string): string | undefined;
+export declare function getSkillEnabled(directory: string): boolean | undefined;
+export declare function setSkillEnabled(directory: string, enabled: boolean): void;

package/dist/plugins/skillManifest.js

@@ -0,0 +1,56 @@
+import { existsSync, lstatSync, readFileSync, renameSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+export const DISABLED_SKILL_MANIFEST = 'SKILL.md.mearl-disabled';
+/** Read the identity fields used by the runtime, including disabled Skills. */
+export function readInstalledSkillMetadata(directory) {
+    if (existsSync(join(directory, 'SKILL.md')) && existsSync(join(directory, DISABLED_SKILL_MANIFEST)))
+        throw new Error('Conflicting installed Skill manifests');
+    const file = skillManifestPath(directory);
+    if (!file)
+        return undefined;
+    const info = statSync(file);
+    if (!info.isFile() || info.size > 1024 * 1024)
+        throw new Error('Invalid installed Skill manifest');
+    const frontmatter = readFileSync(file, 'utf8').match(/^---\r?\n([\s\S]*?)\r?\n---/)?.[1];
+    if (!frontmatter)
+        return {};
+    const scalar = (key) => {
+        const lines = frontmatter.split(/\r?\n/).filter(line => line.startsWith(key + ':'));
+        if (lines.length !== 1)
+            return undefined;
+        return lines[0].match(/^[\w-]+:\s*(?:"([^"\r\n]*)"|'([^'\r\n]*)'|([^\s#"']+))\s*(?:#.*)?$/)?.slice(1).find(value => value !== undefined);
+    };
+    return { name: scalar('name'), version: scalar('version') };
+}
+/** 保留的清单供工具运行时读取，但不参与 Agent 的 SKILL.md 发现。 */
+export function skillManifestPath(directory) {
+    for (const name of ['SKILL.md', DISABLED_SKILL_MANIFEST]) {
+        const file = join(directory, name);
+        if (existsSync(file))
+            return file;
+    }
+    return undefined;
+}
+export function getSkillEnabled(directory) {
+    const manifest = skillManifestPath(directory);
+    return manifest ? manifest === join(directory, 'SKILL.md') : undefined;
+}
+export function setSkillEnabled(directory, enabled) {
+    const active = join(directory, 'SKILL.md');
+    const disabled = join(directory, DISABLED_SKILL_MANIFEST);
+    const source = enabled ? disabled : active;
+    const destination = enabled ? active : disabled;
+    const sourceStatus = lstatSync(source, { throwIfNoEntry: false });
+    const destinationStatus = lstatSync(destination, { throwIfNoEntry: false });
+    if (sourceStatus && destinationStatus) {
+        throw new Error('Skill 清单存在冲突，请检查 SKILL.md 和 SKILL.md.mearl-disabled');
+    }
+    if (!sourceStatus) {
+        if (destinationStatus?.isFile())
+            return;
+        throw new Error('找不到 Skill 清单');
+    }
+    if (!sourceStatus.isFile())
+        throw new Error('Skill 清单必须是普通文件');
+    renameSync(source, destination);
+}

package/dist/socket.d.ts

@@ -47,3 +47,5 @@ export declare function resolveLocalActionTarget(action: string, data: Record<st
  * legacy well-known socket，并在 socket 不存在或已残留时自动拉起 native host。
  */
 export declare function invoke(action: string, data?: Record<string, any>, options?: InvokeOptions): Promise<any>;
+/** Infrastructure calls stay on this machine even when an Agent has selected an external browser. */
+export declare function invokeLocalHost(action: string, data?: Record<string, any>, options?: Pick<InvokeOptions, 'timeoutSec' | 'socketPath'>): Promise<any>;

package/dist/socket.js

@@ -19,7 +19,7 @@ import { readLiveProvider } from '@mearl/provider/runtime';
 import { resolveFileRefs } from './fileRefs.js';
 import { listLiveBrowsers, findBrowser, describeBrowser, } from './browserRegistry.js';
 import { resolveActionTimeoutSec } from './actionTimeouts.js';
-import { isBrowserCapabilityAction } from './generated/browser-action-protocol.js';
+import { isBrowserCapabilityAction } from '@mearl/browser-core';
 export { CLIENT_VERSION };
 const MAX_SOCKET_BUFFER_SIZE = 64 * 1024 * 1024;
 /**
@@ -380,6 +380,15 @@ export function invoke(action, data = {}, options = {}) {
     const selector = browser ?? defaultBrowser ?? process.env.MEARL_BROWSER ?? undefined;
     return dispatchInvoke(action, resolvedData, timeoutSec, transport, selector, controlSource, options.socketPath);
 }
+/** Infrastructure calls stay on this machine even when an Agent has selected an external browser. */
+export function invokeLocalHost(action, data = {}, options = {}) {
+    const timeoutSec = options.timeoutSec ?? resolveActionTimeoutSec(action, data);
+    const socketPath = options.socketPath ?? process.env.MEARL_SOCKET_PATH?.trim();
+    const accepted = resolveFileRefs(data);
+    return socketPath
+        ? invokeOnce(action, accepted, timeoutSec, undefined, socketPath, 'local')
+        : invokeViaLegacy(action, accepted, timeoutSec, undefined, 'local', false, true);
+}
 /** Session ownership lives in the control hosts and survives individual CLI connections. */
 async function resolveControlSession(sessionId, timeoutSec, controlSource) {
     const browsers = listLiveBrowsers();
@@ -545,7 +554,7 @@ async function dispatchInvoke(action, data, timeoutSec, transport, selector, con
     return invokeViaLegacy(action, data, timeoutSec, transport, controlSource, /* isRetry */ false);
 }
 /** Legacy well-known socket, repairing a missing or stale endpoint and retrying once. */
-async function invokeViaLegacy(action, data, timeoutSec, transport, controlSource, isRetry) {
+async function invokeViaLegacy(action, data, timeoutSec, transport, controlSource, isRetry, localOnly = false) {
     const legacySocketIdentity = readOwnedLegacySocketIdentity();
     try {
         return await invokeOnce(action, data, timeoutSec, transport, SOCKET_PATH, controlSource);
@@ -561,13 +570,14 @@ async function invokeViaLegacy(action, data, timeoutSec, transport, controlSourc
                 await new Promise(r => setTimeout(r, 1200));
                 const browsers = listLiveBrowsers();
                 const target = browsers.find(browser => isConnectedBrowser(browser) &&
+                    (!localOnly || browser.transport !== 'provider') &&
                     !(transport === 'cdp' && browser.transport === 'provider') &&
                     supportsAction(browser, action, data));
                 if (target) {
                     return invokeOnce(action, data, timeoutSec, transport, target.socketPath, controlSource, target.transport === 'provider' ? target.browserId : undefined);
                 }
                 return invokeViaLegacy(action, data, timeoutSec, transport, controlSource, 
-                /* isRetry */ true);
+                /* isRetry */ true, localOnly);
             }
         }
         if (err instanceof Error && !isConnError(err) && !isSocketSandboxError(err))

package/dist/unified.d.ts

@@ -1,4 +1,4 @@
-import type { BrowserArtifact } from './generated/browser-action-protocol.js';
+import type { BrowserArtifact } from '@mearl/browser-core';
 import { type CloudConnectorListResult } from '@mearl/cloud-types';
 import type { PluginInvocation, PluginInvokeOptions } from './plugins/sdk/plugin.js';
 export interface UnifiedInvokeOptions {

package/dist/unified.js

@@ -3,7 +3,7 @@ import { stageFile, exportArtifact } from './artifacts.js';
 import WebSocket from 'ws';
 import { DEFAULT_CONNECT_TIMEOUT, DEFAULT_HEARTBEAT_INTERVAL, DEFAULT_REQUEST_TIMEOUT, MAX_BUFFER_SIZE, isHeartbeatMessage, resolveCloudConnectorSelector, } from '@mearl/cloud-types';
 import { resolveActionTimeoutSec } from './actionTimeouts.js';
-import { validateRequiredActionTabId, } from './generated/browser-action-protocol.js';
+import { validateRequiredActionTabId, } from '@mearl/browser-core';
 import { invoke as invokeLocalBrowser, resolveLocalActionTarget } from './socket.js';
 import { loadCloudServerConfig, loadLocalConnectorId } from './unifiedConfig.js';
 const RESPONSE_GRACE_MS = 1_000;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mearl/client",
-  "version": "2.22.0",
+  "version": "3.0.0-beta.0",
   "description": "Unified Mearl SDK & CLI for local and remote browsers",
   "type": "module",
   "main": "dist/index.js",
@@ -52,7 +52,7 @@
     "devtools",
     "socket-client"
   ],
-  "license": "ISC",
+  "license": "Apache-2.0",
   "engines": {
     "node": ">=22.12.0"
   },
@@ -65,10 +65,11 @@
     "commander": "^15.0.0",
     "fastest-levenshtein": "^1.0.16",
     "ws": "^8.18.0",
-    "@mearl/daemon-core": "2.22.0",
-    "@mearl/cloud-types": "2.22.0",
-    "@mearl/provider": "2.22.0",
-    "@mearl/agent-runtime": "2.22.0"
+    "@mearl/daemon-core": "3.0.0-beta.0",
+    "@mearl/cloud-types": "3.0.0-beta.0",
+    "@mearl/provider": "3.0.0-beta.0",
+    "@mearl/agent-runtime": "3.0.0-beta.0",
+    "@mearl/browser-core": "3.0.0-beta.0"
   },
   "devDependencies": {
     "@types/node": "^24.9.1",
@@ -76,9 +77,9 @@
     "typescript": "^5.8.3"
   },
   "scripts": {
-    "build": "node ../../scripts/generate-client-action-protocol.mjs --check && rm -rf dist/ && tsc && chmod +x dist/bin.js",
+    "build": "rm -rf dist/ && tsc && chmod +x dist/bin.js",
     "dev": "tsc --watch",
-    "typecheck": "node ../../scripts/generate-client-action-protocol.mjs --check && tsc --noEmit",
+    "typecheck": "tsc --noEmit",
     "test": "vitest run"
   }
 }

package/dist/generated/app-profile-definition.d.ts

@@ -1,130 +0,0 @@
-import type { BrowserDevicePresetName, AppBridgeConfig } from './browser-action-protocol.js';
-import type { AppBridgeSpec, AppImagePickerConfig, AppLayerUrlProxyConfig, AppMiniProgramConfig, AppNativeBackConfig, AppOverlayConfig, AppSchemeRule, AppTitleBarHostStyle, BridgeActionMap } from './app-profile-runtime-types.js';
-export interface AppProfilePolicies {
-    titleBar?: 'default' | 'taobao' | 'fliggy' | 'alipay' | 'wechat';
-    navigatorLanguage?: boolean;
-    networkResult?: 'default' | 'alipay';
-    languages?: string[];
-    defaultLanguage?: string;
-}
-export interface AppProfileSetting {
-    id: string;
-    label: string;
-    type: 'select' | 'boolean' | 'number' | 'text' | 'json';
-    target: {
-        option: 'language';
-    } | {
-        method: string;
-        field?: string;
-    };
-    choices?: Array<{
-        label: string;
-        value: string;
-    }>;
-    minimum?: number;
-    maximum?: number;
-}
-export interface AppProfileOptions {
-    /** Keep this definition across document navigations until explicitly refreshed. */
-    lockDefinition?: boolean;
-    os?: 'ios' | 'android';
-    appVersion?: string;
-    language?: string;
-    deviceModel?: string;
-    devicePreset?: BrowserDevicePresetName;
-    orientation?: 'portrait' | 'landscape';
-    bridgeConfig?: AppBridgeConfig;
-}
-export interface AppProfileBinding {
-    version: 1;
-    revision: string;
-    definition: AppProfileDefinition;
-    options: AppProfileOptions;
-    /** Explicit scalar choices; method overrides are always explicit and live in options.bridgeConfig. */
-    explicitOptions?: Omit<AppProfileOptions, 'bridgeConfig'>;
-}
-export interface AppProfileContribution {
-    version: 1;
-    profiles: AppProfileDefinition[];
-}
-export interface AppProfileCatalogEntry {
-    id: string;
-    label: string;
-    source: 'builtin' | 'plugin';
-    available?: boolean;
-    plugin?: string;
-    revision: string;
-    definition: AppProfileDefinition;
-}
-/** 单容器档案（纯数据） */
-export interface AppProfileDefinition {
-    name: string;
-    label: string;
-    /** 容器的应用标识，如 LX / TB / AP / WeChat */
-    appName: string;
-    defaultAppVersion: string;
-    /** UA 主体格式；默认使用 AliApp(appName/version) */
-    uaFamily?: 'aliapp' | 'wechatMiniProgram';
-    uaTemplate?: {
-        ios: string;
-        android: string;
-    };
-    policies?: AppProfilePolicies;
-    settings?: AppProfileSetting[];
-    settingsGroup?: 'fliggy' | 'alipay';
-    /** AliApp UA 主体之后追加的 token，{v} 占位会被替换为 appVersion */
-    uaTokens: string[];
-    /** 额外注入到 window 的变量（公共变量由 resolve 统一生成） */
-    globals: Record<string, string>;
-    bridges: AppBridgeSpec[];
-    /** 页面回到前台时分发到 document 的事件名（如 WV.Event.APP.Active） */
-    activeEvents: string[];
-    actions: BridgeActionMap;
-    schemes: AppSchemeRule[];
-    /** 小程序原生页面与 WebView 通信规则。 */
-    miniProgram?: AppMiniProgramConfig;
-    /** 原生图片页 scheme 的浏览器选图与上传配置 */
-    imagePicker?: AppImagePickerConfig;
-    geolocation?: {
-        reverseGeocodeApi: string;
-        version: string;
-    };
-    /**
-     * 地址栏借位同步的可选 host 白名单：容器栈顶 URL 的 host 命中时，地址栏借 top
-     * 域名同步其 path+query+hash（pushState 同源约束下保持域名不变只改 path）；
-     * 不配置则同步所有 HTTP(S) 业务层 URL。
-     */
-    urlSyncHostSuffixes?: string[];
-    /** URL / pageParams 浮层协议 */
-    overlay?: AppOverlayConfig;
-    /** URL 参数为真时以新 WebView 替换当前业务层。 */
-    popBeforeOpenParam?: string;
-    /** 跨 WebView 消息抵达 opener 时分发的 document 事件。 */
-    messageEvent?: string;
-    /** 原生返回键的页面接管协议。 */
-    nativeBack?: AppNativeBackConfig;
-    /** 开发代理 origin 下的业务层 URL 映射 */
-    layerUrlProxy?: AppLayerUrlProxyConfig;
-    /** App 框架的根 WebView 与自绘标题栏协议。 */
-    rootContainer?: {
-        statusBarHeightCookie?: {
-            name: string;
-            domain?: string;
-            path?: string;
-        };
-    };
-    /** 页面自行绘制导航区域时，不渲染模拟标题栏。 */
-    titleBarHiddenPathnames?: string[];
-    /** 页面级状态栏背景色，key 为业务 pathname。 */
-    statusBarBackgroundColors?: Record<string, string>;
-    /** 按业务根域配置标题栏与状态栏样式。 */
-    titleBarHostStyles?: AppTitleBarHostStyle[];
-    /** 桥存在时仍将 MTOP 传输固定在浏览器 H5 通道 */
-    forceH5Mtop?: boolean;
-}
-export declare const APP_BRIDGE_BEHAVIORS: readonly ["navigate", "closeAll", "closeBackData", "postMessage", "notifySubscribe", "notifyUnsubscribe", "notifyPost", "sharedFileRead", "sharedFileWrite", "sharedDataGet", "sharedDataSet", "legacyBroadcastCreate", "legacyBroadcastPost", "legacyBroadcastClose", "memoryGet", "memorySet", "memoryDelete", "availabilityMap", "userInfo", "authCode", "networkInfo", "geolocation", "permission", "imagePicker", "prefetch", "fptTrack", "mtopStream", "previewFile", "toast", "unsupportedNativeInput", "payment", "userTrack", "calendar", "networkQualityMonitor", "beaconRequest", "voiceRecognition"];
-/** Validate plain data before registration or compiling a document-start configuration. */
-export declare function validateAppProfileDefinition(value: unknown): AppProfileDefinition;
-export declare function validateAppProfileContribution(value: unknown): AppProfileContribution | undefined;
-/** Deterministic identity for immutable definitions; this identifier grants no host permissions. */
-export declare function appProfileRevision(definition: AppProfileDefinition): string;