@mearl/client 2.20.6 → 2.22.0

package/dist/commands.js

@@ -1,4 +1,4 @@
-import { APP_PROFILE_NAMES, BROWSER_DEVICE_PRESET_NAMES, } from './generated-browser-action-protocol.js';
+import { APP_PROFILE_NAMES, BROWSER_DEVICE_PRESET_NAMES, } from './generated/browser-action-protocol.js';
 /** 容器档案名列表（拼进参数说明，新增档案无需改本文件） */
 const APP_PROFILE_NAME_LIST = APP_PROFILE_NAMES.join('/');
 const DEVICE_PRESET_TYPE = BROWSER_DEVICE_PRESET_NAMES.map(name => JSON.stringify(name)).join(' | ');
@@ -32,6 +32,7 @@ const PAGE_ACTION_RESULT = [
     'observe=false 且未开启 diagnostics 时返回裸动作结果（如 { clicked: true }），没有 action/observation；开启 diagnostics 时返回 { action, diagnostics }。',
     '包装结果中的 action.stage=precondition 表示未派发，省略 observation/diagnostics；dispatch-uncertain 表示可能已派发，先查看 action.attempt 与可用观察或最小快照核验，避免重复提交。失败以退出码 1 结束。',
     'observation.effects 返回通知、控件和焦点增量，可直接复用 node.ref/selector；changed=true 且 effects 为空不表示失败。',
+    'effects.texts 按需返回普通可见文本的 selector/text，不代表可点击控件或业务成功；超限或覆盖不完整时仍提示补快照。',
     'fullSnapshotRecommended/snapshotReasons 提示是否补充快照；openedTabs 返回可继续操作的 tabId 和 ready。navigation 模式的 ready 表示新页面就绪。',
     '显式开启的诊断通道在 diagnostics 中返回动作期间增量，与 observe 独立。',
 ];
@@ -116,7 +117,11 @@ export const COMMANDS = [
                 type: 'string',
                 description: '只返回指定 tab checkpoint 或同类查询 cursor 之后的请求',
             },
-            { name: 'includeBody', type: 'boolean', description: '是否包含请求/响应体，默认 true' },
+            {
+                name: 'includeBody',
+                type: 'boolean',
+                description: '是否包含请求/响应体；指定 fields 时默认 false，否则默认 true',
+            },
             { name: 'includeHeaders', type: 'boolean', description: '是否包含请求/响应头，默认 false' },
             { name: 'maxBodySize', type: 'number', description: '单个请求/响应体最大字符数，默认 50000' },
             { name: 'fields', type: 'string[]', description: '从响应体提取指定字段路径，最多 100 个' },
@@ -127,6 +132,7 @@ export const COMMANDS = [
         ],
         result: [
             'nextCursor 用于同类查询续读，hasMore 表示还有数据，gap 表示缓冲区淘汰造成缺口；checkpoint cursor 可分别用于三类查询的初始边界。',
+            '省略正文时不返回 postData / responseBody 字段；指定 fields 后需要同时读取全文时显式传 includeBody:true。',
             'isPending 标记未完成请求；SSE 的 responseBody 保存按序到达的 event/data/timestamp/duration 分片。敏感请求头返回脱敏值。',
         ],
         examples: [
@@ -494,7 +500,7 @@ export const COMMANDS = [
             {
                 name: 'active',
                 type: 'boolean',
-                description: '是否激活目标 Tab 并恢复最小化窗口，默认 false；响应返回 activation 验证结果',
+                description: '是否激活目标 Tab，默认 false；扩展免打扰默认开启，使用后台焦点模拟，关闭后才切换前台；响应返回 activation',
             },
             {
                 name: 'openerTabId',
@@ -783,6 +789,18 @@ export const COMMANDS = [
             `page_scroll --payload '{"tabId":12345,"selector":"@e8","containerPolicy":"nearest","direction":"bottom"}'`,
         ],
     },
+    {
+        name: 'page_runtime',
+        description: '页面运行时传输适配器；插件使用 PluginPageClient 或 app.page',
+        params: [
+            {
+                name: 'operation',
+                type: 'string',
+                required: true,
+                description: 'resolve/attach/get/send/detach/activation',
+            },
+        ],
+    },
     {
         name: 'page_eval',
         description: '在页面上下文中执行任意 JavaScript 表达式',
@@ -834,7 +852,7 @@ export const COMMANDS = [
     },
     {
         name: 'page_inspect',
-        description: '查询 DOM 元素的数量、边框盒、计算样式、遮挡、溢出和最近滚动容器',
+        description: '查询 DOM 元素的控件状态、数量、边框盒、计算样式、遮挡、溢出和最近滚动容器',
         params: [
             {
                 name: 'selector',
@@ -865,6 +883,7 @@ export const COMMANDS = [
         ],
         result: [
             'matches[] 包含 boundingBox、computedStyle、hitTest、scroll 溢出量及可用的 scrollContainer。receivesPointerEvents=false 时读取 occludedBy。',
+            'state 返回原生/ARIA 状态及来源；缺失字段表示未知。',
             '$0 还返回 resolvedSelector、属性、XPath 和可用框架信息。',
         ],
         examples: [
@@ -1050,6 +1069,7 @@ export const COMMANDS = [
         ],
         result: [
             '返回 snapshot、elementCount、outputNodeCount、mode；截断时 truncated=true。',
+            'snapshot 中的 @eN 可直接用于操作；内部节点映射仅保存在运行时。无名称、无 ref 且无状态的分组折叠到子节点。',
             'query 返回 matches 与完整 matchCount，matches 最多 100 项，裁剪时 matchesTruncated=true。容器/iframe 的视口裁剪返回 outerViewport、contentViewport 和滚动位置。',
         ],
         examples: [

package/dist/{generated-app-profile-definition.d.ts → generated/app-profile-definition.d.ts}

@@ -1,5 +1,5 @@
-import type { BrowserDevicePresetName, AppBridgeConfig } from './generated-browser-action-protocol.js';
-import type { AppBridgeSpec, AppImagePickerConfig, AppLayerUrlProxyConfig, AppMiniProgramConfig, AppNativeBackConfig, AppOverlayConfig, AppSchemeRule, AppTitleBarHostStyle, BridgeActionMap } from './generated-app-profile-runtime-types.js';
+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;

package/dist/{generated-app-profile-runtime-types.d.ts → generated/app-profile-runtime-types.d.ts}

@@ -1,5 +1,5 @@
-import type { AppProfileBinding, AppProfilePolicies, AppProfileSetting } from './generated-app-profile-definition.js';
-import type { BrowserDevicePresetName } from './generated-browser-action-protocol.js';
+import type { AppProfileBinding, AppProfilePolicies, AppProfileSetting } from './app-profile-definition.js';
+import type { BrowserDevicePresetName } from './browser-action-protocol.js';
 type DeviceCutout = 'none' | 'dynamic-island' | 'notch' | 'side-camera';
 /** 桥调用风格，与页面适配器使用的端内调用约定一一对应。 */
 export type AppBridgeStyle = 'windvane' | 'fliggy' | 'alipay' | 'callback' | 'btrip' | 'invoke' | 'callHandler' | 'amap' | 'didi' | 'easybikeNative' | 'mega' | 'wechat' | 'wechatMiniProgram';

package/dist/{generated-browser-action-protocol.d.ts → generated/browser-action-protocol.d.ts}

@@ -6,6 +6,7 @@ export interface GetRequestsParams {
     since?: number;
     /** Opaque cursor returned by tab_checkpoint or a previous query. */
     after?: string;
+    /** Defaults to false when fields are selected, otherwise true. */
     includeBody?: boolean;
     includeHeaders?: boolean;
     maxBodySize?: number;
@@ -892,6 +893,10 @@ export interface BrowserActionMap {
         request: PageEvalParams;
         response: unknown;
     };
+    page_runtime: {
+        request: Record<string, unknown>;
+        response: unknown;
+    };
     page_inspect: {
         request: PageInspectParams;
         response: unknown;
@@ -952,7 +957,8 @@ export interface BrowserActionMap {
 export type BrowserAction = keyof BrowserActionMap;
 export type BrowserActionRequest<A extends BrowserAction> = BrowserActionMap[A]['request'];
 export type BrowserActionResponse<A extends BrowserAction> = BrowserActionMap[A]['response'] & {
-    session?: ControlSessionInfo;
+    /** Routing and execution state; browser_control returns the full tab inventory. */
+    session?: Omit<ControlSessionInfo, 'tabs'>;
 };
 export type BrowserCommandAction = Exclude<BrowserAction, 'browser_select_browser'>;
 export type ExtensionBrowserAction = Exclude<BrowserCommandAction, 'browser_list' | 'browser_launch' | 'browser_close' | 'browser_control' | 'page_download'>;
@@ -992,6 +998,7 @@ export declare const BROWSER_ACTIONS: {
     readonly page_scroll: true;
     readonly page_hover: true;
     readonly page_eval: true;
+    readonly page_runtime: true;
     readonly page_inspect: true;
     readonly page_snapshot: true;
     readonly page_press: true;
@@ -1036,6 +1043,7 @@ export declare const BROWSER_COMMAND_ACTIONS: {
     readonly page_scroll: true;
     readonly page_hover: true;
     readonly page_eval: true;
+    readonly page_runtime: true;
     readonly page_inspect: true;
     readonly page_snapshot: true;
     readonly page_press: true;
@@ -1075,6 +1083,7 @@ export declare const EXTENSION_BROWSER_ACTIONS: {
     readonly page_scroll: true;
     readonly page_hover: true;
     readonly page_eval: true;
+    readonly page_runtime: true;
     readonly page_inspect: true;
     readonly page_snapshot: true;
     readonly page_press: true;
@@ -1115,6 +1124,7 @@ export declare const BROWSER_CAPABILITY_ACTIONS: {
     readonly page_scroll: true;
     readonly page_hover: true;
     readonly page_eval: true;
+    readonly page_runtime: true;
     readonly page_inspect: true;
     readonly page_snapshot: true;
     readonly page_press: true;

package/dist/{generated-browser-action-protocol.js → generated/browser-action-protocol.js}

@@ -164,6 +164,7 @@ export const BROWSER_ACTIONS = {
     page_scroll: true,
     page_hover: true,
     page_eval: true,
+    page_runtime: true,
     page_inspect: true,
     page_snapshot: true,
     page_press: true,
@@ -208,6 +209,7 @@ export const BROWSER_COMMAND_ACTIONS = {
     page_scroll: true,
     page_hover: true,
     page_eval: true,
+    page_runtime: true,
     page_inspect: true,
     page_snapshot: true,
     page_press: true,
@@ -247,6 +249,7 @@ export const EXTENSION_BROWSER_ACTIONS = {
     page_scroll: true,
     page_hover: true,
     page_eval: true,
+    page_runtime: true,
     page_inspect: true,
     page_snapshot: true,
     page_press: true,

package/dist/generated/plugin-diagnostics.d.ts

@@ -0,0 +1,110 @@
+import type { PluginExecutionHost, PluginInvocationSource } from './plugin-execution.js';
+import type { PluginTaskState, PluginTaskResultReference } from './plugin-tasks.js';
+import type { PluginTaskCheckpointReference } from './plugin-recovery.js';
+import type { PluginModelDiagnostic } from './plugin-models.js';
+export interface PluginDiagnosticOptions {
+    taskId?: string;
+    plugin?: string;
+    instanceId?: string;
+    includeErrorMessages?: boolean;
+    includeLocalPaths?: boolean;
+}
+export interface PluginDiagnosticPageBinding {
+    instanceId: string;
+    browserSessionId: string;
+    tabId: number;
+    frameId: string | number;
+    documentId: string;
+}
+export interface PluginTaskDiagnosticMetadata {
+    invocationId?: string;
+    page?: PluginDiagnosticPageBinding;
+    executorAttempted?: boolean;
+    executorStoppedAt?: number;
+    model?: PluginModelDiagnostic;
+    updatesDropped?: boolean;
+}
+export interface PluginDiagnosticFailure {
+    code: string;
+    message?: string;
+    messageTruncated?: boolean;
+}
+export interface PluginDiagnosticTask {
+    taskId: string;
+    plugin: string;
+    kind: 'command' | 'model';
+    command: string;
+    state: PluginTaskState;
+    source: PluginInvocationSource;
+    host: PluginExecutionHost;
+    installationId: string;
+    revision: string;
+    invocationId?: string;
+    createdAt: number;
+    updatedAt: number;
+    sequence: number;
+    page?: PluginDiagnosticPageBinding;
+    routing?: {
+        browser?: string;
+        session?: string;
+        connector?: string;
+        local?: boolean;
+        transport?: 'extension' | 'cdp';
+    };
+    executionTimeoutMs?: number;
+    executor: {
+        state: 'never-started' | 'observed-alive' | 'stop-confirmed' | 'unknown';
+        observedAt: number;
+        pid?: number;
+        stoppedAt?: number;
+    };
+    failure?: PluginDiagnosticFailure;
+    checkpoint?: PluginTaskCheckpointReference;
+    result?: PluginTaskResultReference;
+    model?: PluginModelDiagnostic;
+    metadataIncomplete: boolean;
+    history: {
+        firstRetainedSequence: number;
+        gap: boolean;
+        omitted: number;
+        events: Array<{
+            sequence: number;
+            time: number;
+            state: PluginTaskState;
+            type: string;
+        }>;
+    };
+}
+export interface PluginDiagnosticPage {
+    plugin: string;
+    installationId: string;
+    revision: string;
+    host: PluginExecutionHost;
+    binding: PluginDiagnosticPageBinding;
+    observation: 'service-snapshot' | 'historical-binding';
+    state?: 'active' | 'detached' | 'invalidated';
+    lastReceived?: number;
+    queued?: number;
+    running?: number;
+    failure?: PluginDiagnosticFailure;
+}
+export interface PluginDiagnosticReport {
+    version: 1;
+    generatedAt: number;
+    host: PluginExecutionHost;
+    protocolVersion: number;
+    selection: Pick<PluginDiagnosticOptions, 'taskId' | 'plugin' | 'instanceId'>;
+    coverage: {
+        scanLimited: boolean;
+        tasksOmitted: number;
+        pagesOmitted: number;
+        byteLimited: boolean;
+    };
+    tasks: PluginDiagnosticTask[];
+    pages: PluginDiagnosticPage[];
+    links: Array<{
+        from: string;
+        to: string;
+        kind: 'parent' | 'resume';
+    }>;
+}

package/dist/generated/plugin-diagnostics.js

@@ -0,0 +1 @@
+export {};

package/dist/generated/plugin-execution.d.ts

@@ -0,0 +1,27 @@
+import type { PluginPageBinding } from './plugin-pages.js';
+import type { PluginTaskRecoveryContext } from './plugin-recovery.js';
+/** Identifies an execution environment separately from a process incarnation. */
+export interface PluginExecutionHost {
+    hostId: string;
+    epoch: string;
+}
+export type PluginInvocationSource = 'cli' | 'sdk' | 'mcp' | 'toolbox' | 'runtime';
+/** Created by the entry point; business input cannot replace this identity. */
+export interface PluginInvocationIdentity {
+    invocationId: string;
+    host: PluginExecutionHost;
+    source: PluginInvocationSource;
+    plugin: string;
+    parentInvocationId?: string;
+    taskId?: string;
+    installationId?: string;
+    revision?: string;
+    page?: PluginPageBinding;
+    recovery?: PluginTaskRecoveryContext;
+}
+export interface PluginExecutionError {
+    message: string;
+    code?: string;
+    details?: Record<string, unknown>;
+    metadata?: Record<string, string | number | boolean | null>;
+}

package/dist/generated/plugin-execution.js

@@ -0,0 +1 @@
+export {};

package/dist/generated/plugin-models.d.ts

@@ -0,0 +1,64 @@
+export type PluginModelMode = 'generate' | 'agent';
+export interface PluginModelRequest {
+    provider: string;
+    mode: PluginModelMode;
+    prompt: string;
+    instructions?: string;
+    model?: string;
+    reasoningEffort?: 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max';
+    outputSchema?: Record<string, unknown>;
+    /** Opt-in conversation scoped to the bound document or calling command execution. */
+    conversation?: string;
+    /** Required for an agent task; never inferred from a pure-generation request. */
+    permissions?: 'read-only';
+}
+export interface PluginModelCapability {
+    provider: string;
+    modes: PluginModelMode[];
+    permissions: Array<'read-only'>;
+    structuredOutput: boolean;
+    streaming: boolean;
+    cancellation: boolean;
+}
+export interface PluginModelOption {
+    id: string;
+    displayName: string;
+    description?: string;
+    isDefault?: boolean;
+    reasoningEfforts?: NonNullable<PluginModelRequest['reasoningEffort']>[];
+    defaultReasoningEffort?: PluginModelRequest['reasoningEffort'];
+}
+export interface PluginModelList {
+    provider: string;
+    models: PluginModelOption[];
+}
+export interface PluginModelResult {
+    text: string;
+    output?: unknown;
+    provider: string;
+    mode: PluginModelMode;
+    model?: string;
+}
+/** Execution observations contain no prompts, account identities or credential values. */
+export interface PluginModelDiagnostic {
+    requestedModel?: string;
+    selectedModel?: string;
+    activeModel?: string;
+    runtime?: {
+        executable?: string;
+        version?: string;
+        selection: 'explicit' | 'automatic';
+        started?: boolean;
+    };
+    configuration?: {
+        source: 'default' | 'environment';
+        home?: string;
+        filePresent: boolean;
+        baseProvider?: string;
+        credentialStore?: 'file' | 'keyring' | 'auto' | 'ephemeral' | 'unknown';
+    };
+    authentication?: 'apikey' | 'chatgpt' | 'chatgptAuthTokens' | 'unknown';
+    threadRestrictionsAccepted?: boolean;
+    turnRestrictionsAccepted?: boolean;
+    retryCount?: number;
+}

package/dist/generated/plugin-models.js

@@ -0,0 +1 @@
+export {};

package/dist/generated/plugin-pages.d.ts

@@ -0,0 +1,76 @@
+import type { PluginExecutionError, PluginExecutionHost } from './plugin-execution.js';
+export declare const PLUGIN_PAGE_LEASE_MS = 30000;
+/** Document or access-scope invalidation can cross transports that preserve only a message. */
+export declare function isPluginPageInvalidation(error: unknown): boolean;
+export declare function isPluginPageUnavailable(error: unknown): boolean;
+export declare function pluginPageUnavailable(error: unknown): Error;
+/** main/business selectors, Chrome numeric frame IDs, or CDP opaque frame IDs. */
+export type PluginPageFrame = string | number;
+export type PluginPageOperation = 'attach' | 'get' | 'list' | 'send' | 'detach' | 'events' | 'activation';
+export interface PluginPageEventBinding {
+    command: string;
+    schema: Record<string, unknown>;
+    policy?: 'serial' | 'latest' | 'parallel';
+    concurrency?: number;
+    maxPending?: number;
+}
+export interface PluginPageRuntime {
+    version: 1;
+    matches: string[];
+    /** Self-contained function expression receiving {input, signal, emit, identity}. */
+    code: string;
+    initialize?: string;
+    events?: Record<string, PluginPageEventBinding>;
+}
+export interface PluginPageTarget {
+    browserSessionId: string;
+    tabId: number;
+    frameId: string | number;
+    documentId: string;
+    url: string;
+}
+export interface PluginPageInstance {
+    instanceId: string;
+    plugin: string;
+    installationId: string;
+    revision: string;
+    host: PluginExecutionHost;
+    target: PluginPageTarget;
+    state: 'active' | 'detached' | 'invalidated';
+    sequence: number;
+    createdAt: number;
+    error?: PluginExecutionError;
+}
+export interface PluginPageEvent {
+    sequence: number;
+    time: number;
+    type: 'received' | 'running' | 'success' | 'error' | 'superseded' | 'navigation' | 'invalidated';
+    eventSequence?: number;
+    name?: string;
+    payload?: unknown;
+    taskId?: string;
+    error?: PluginExecutionError;
+}
+export interface PluginPageEvents {
+    instance: PluginPageInstance;
+    events: PluginPageEvent[];
+    nextCursor: number;
+    firstAvailableSequence: number;
+    gap: boolean;
+}
+export interface PluginPageActivation {
+    plugin: string;
+    installationId: string;
+    enabled: boolean;
+    matches: string[];
+    persistence: 'session' | 'persistent';
+    frame: PluginPageFrame;
+    input: Record<string, unknown>;
+}
+export interface PluginPageBinding {
+    instanceId: string;
+    target: PluginPageTarget;
+}
+export declare function isPluginPageMatchPattern(value: unknown): value is string;
+export declare function matchesPluginPageURL(matches: readonly string[], value: string): boolean;
+export declare function isPluginPageInstanceId(value: unknown): value is string;

package/dist/generated/plugin-pages.js

@@ -0,0 +1,59 @@
+export const PLUGIN_PAGE_LEASE_MS = 30000;
+/** Document or access-scope invalidation can cross transports that preserve only a message. */
+export function isPluginPageInvalidation(error) {
+    const value = error;
+    const codes = [
+        'PLUGIN_PAGE_INVALIDATED',
+        'PLUGIN_PAGE_NOT_FOUND',
+        'PLUGIN_PAGE_TARGET_CHANGED',
+        'DOMAIN_PERMISSION_REQUIRED',
+    ];
+    const message = typeof value?.message === 'string' ? value.message : '';
+    return codes.includes(String(value?.code)) || codes.some(code => message.startsWith(`${code}:`));
+}
+export function isPluginPageUnavailable(error) {
+    return error?.code === 'PLUGIN_PAGE_UNAVAILABLE';
+}
+export function pluginPageUnavailable(error) {
+    return Object.assign(new Error('Plugin page host is temporarily unavailable', { cause: error }), {
+        code: 'PLUGIN_PAGE_UNAVAILABLE',
+    });
+}
+const pattern = /^(https?|\*):\/\/(\*|\*\.[a-z0-9.-]+|[a-z0-9.-]+|localhost)(:\d+)?(\/[^#]*)$/i;
+export function isPluginPageMatchPattern(value) {
+    return typeof value === 'string' && value.length <= 2048 && pattern.test(value);
+}
+export function matchesPluginPageURL(matches, value) {
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        return false;
+    }
+    if (!['http:', 'https:'].includes(url.protocol))
+        return false;
+    return matches.some(item => {
+        const match = item.match(pattern);
+        if (!match || (match[1] !== '*' && match[1].toLowerCase() + ':' !== url.protocol))
+            return false;
+        const host = match[2].toLowerCase();
+        if (host !== '*' &&
+            host !== url.hostname &&
+            !(host.startsWith('*.') &&
+                (url.hostname === host.slice(2) || url.hostname.endsWith(host.slice(1)))))
+            return false;
+        if (match[3] && match[3].slice(1) !== (url.port || (url.protocol === 'https:' ? '443' : '80')))
+            return false;
+        const expression = '^' +
+            match[4]
+                .split('*')
+                .map(part => part.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'))
+                .join('.*') +
+            '$';
+        return new RegExp(expression).test(url.pathname + url.search);
+    });
+}
+export function isPluginPageInstanceId(value) {
+    return typeof value === 'string' && /^pi_[0-9a-f-]{36}$/i.test(value);
+}

package/dist/generated/plugin-recovery.d.ts

@@ -0,0 +1,32 @@
+export interface PluginTaskRecoveryDeclaration {
+    version: 1;
+    commands: Record<string, {
+        checkpointVersion: number;
+        schema: Record<string, unknown>;
+        migrateFrom?: Array<{
+            version: number;
+            schema: Record<string, unknown>;
+        }>;
+    }>;
+}
+export interface PluginTaskCheckpointReference {
+    sequence: number;
+    version: number;
+    schemaHash: string;
+    updatedAt: number;
+}
+export interface PluginTaskCheckpoint extends PluginTaskCheckpointReference {
+    data: unknown;
+}
+export interface PluginTaskRecoveryContext {
+    fromTaskId: string;
+    fromRevision: string;
+    declarationHash: string;
+    sourceCheckpoint: PluginTaskCheckpointReference;
+    checkpoint: PluginTaskCheckpoint;
+}
+export interface PluginCheckpointMigrationInput {
+    checkpoint: PluginTaskCheckpoint;
+    fromRevision: string;
+    toRevision: string;
+}

package/dist/generated/plugin-recovery.js

@@ -0,0 +1 @@
+export {};

package/dist/generated/plugin-state.d.ts

@@ -0,0 +1,50 @@
+export type PluginStateScope = 'installation' | 'host' | 'browser-session' | 'instance';
+export interface PluginStateCollection {
+    scope: PluginStateScope;
+    storage: 'persistent' | 'cache' | 'memory';
+    schemaVersion: number;
+    schema: Record<string, unknown>;
+    maxEntries?: number;
+    maxBytes?: number;
+    ttlMs?: number;
+}
+export interface PluginStateDeclaration {
+    version: 1;
+    collections: Record<string, PluginStateCollection>;
+}
+export interface PluginStateEntry {
+    key: string;
+    exists: boolean;
+    /** Live entry revision, or the collection revision for absence; opaque to callers. */
+    version: string;
+    value?: unknown;
+    expiresAt?: number;
+}
+export interface PluginStateSnapshot extends PluginStateEntry {
+    revision: number;
+    schemaVersion: number;
+}
+export interface PluginStateList {
+    entries: PluginStateEntry[];
+    revision: number;
+    schemaVersion: number;
+    nextCursor?: string;
+}
+export type PluginStateMutation = {
+    type: 'put';
+    key: string;
+    expectedVersion: string;
+    value: unknown;
+    ttlMs?: number;
+} | {
+    type: 'delete';
+    key: string;
+    expectedVersion: string;
+};
+export interface PluginStateTransaction {
+    operations: PluginStateMutation[];
+    expectedRevision?: number;
+    migrateFromVersion?: number;
+    idempotencyKey?: string;
+}
+export type PluginStateOperation = 'get' | 'get-many' | 'list' | 'transact';

package/dist/generated/plugin-state.js

@@ -0,0 +1 @@
+export {};