webloom-framework 0.2.0 → 0.4.0

package/dist/createPluginHost-ChJNBTsX.d.ts

@@ -1,1339 +0,0 @@
-/** 运行实例的作用域类型；名称由宿主定义，WebLoom 只比较和调度。 */
-type LifecycleScopeKind = string;
-/** 作用域状态；stopping 表示已撤权但异步收尾还未结束。 */
-type LifecycleScopeState = "active" | "stopping" | "stopped";
-/** 浏览器中由 WebLoom 管理的真实 JavaScript 运行空间。 */
-type RuntimeKind = "window-main" | "shared-worker";
-/** 权限动作名称；权限集合和最终 I/O allowlist 由宿主定义。 */
-type PluginPermission = string;
-/** 一个运行作用域的身份绑定；敏感句柄必须带上这些字段。 */
-interface LifecycleScopeIdentity<TAttributes extends Readonly<Record<string, unknown>> = Readonly<Record<string, unknown>>> {
-    /** 作用域唯一标识；每次重建都必须不同。 */
-    scopeId: string;
-    /** 运行实例唯一标识；A -> B -> A 也不能复用旧实例。 */
-    instanceId: string;
-    /** 作用域类型；只作为宿主提供的稳定标签。 */
-    kind: LifecycleScopeKind;
-    /** 父作用域标识；跨环境时只传标识，不传 Context。 */
-    parentScopeId?: string;
-    /** 插件标识。由 Host 绑定，调用方不可从请求参数替换。 */
-    pluginId?: string;
-    /** 宿主绑定的只读扩展元数据；不得放入私密材料。 */
-    attributes: TAttributes;
-}
-/** 释放回调；reason 是中文 UI 之外的稳定审计原因。 */
-type LifecycleCleanup = (reason: string) => void | Promise<void>;
-/** 清理阶段；Registry 等技术注册项通常在 legacy teardown 之后释放。 */
-type LifecycleCleanupPhase = "before-teardown" | "after-teardown";
-/** 作用域内一项资源的结构化快照。 */
-interface LifecycleResourceSnapshot {
-    /** 资源唯一标识。 */
-    resourceId: string;
-    /** 当前阶段。 */
-    state: "acquiring" | "active" | "released" | "pending";
-    /** 最近一次释放错误。 */
-    error?: string;
-}
-/** 释放失败或超时的结构化记录。 */
-interface LifecycleCleanupIssue {
-    /** 对应资源或清理回调标识。 */
-    resourceId: string;
-    /** 错误稳定码。 */
-    code: "lifecycle.cleanup_failed" | "lifecycle.cleanup_timeout";
-    /** 便于日志和诊断的错误文本。 */
-    message: string;
-}
-/** 作用域停止的结果；清理不完整时仍然返回，而不是伪装成功。 */
-interface LifecycleDisposeResult {
-    /** 作用域标识。 */
-    scopeId: string;
-    /** 停止后的状态。 */
-    state: "stopped";
-    /** 尝试执行的释放项数量。 */
-    attempted: number;
-    /** 已完成的释放项数量。 */
-    released: number;
-    /** 超时或仍在异步收尾的资源标识。 */
-    pending: string[];
-    /** 所有释放错误；一个错误不阻止其它项执行。 */
-    errors: LifecycleCleanupIssue[];
-    /** 是否存在未完成收尾。 */
-    cleanupIncomplete: boolean;
-}
-/** 作用域停止选项。 */
-interface LifecycleDisposeOptions {
-    /** 每一项释放允许等待的毫秒数；不填则等待到完成。 */
-    timeoutMs?: number;
-    /** 释放原因。 */
-    reason?: string;
-    /** 在 before-teardown 资源完成后执行的旧 teardown / 领域收尾。 */
-    teardown?: LifecycleCleanup;
-    /**
-     * 某项清理超过 timeoutMs 后最终成功时回调；回调只用于本地状态投影，
-     * 不改变已经完成的撤权边界。resourceId 是稳定资源标识，result 是同一
-     * 次 dispose 返回的可变快照（可能尚未生成）。
-     */
-    onLateSuccess?: (resourceId: string, result?: LifecycleDisposeResult) => void;
-    /**
-     * 某项清理在超时后最终失败时回调；调用方必须保留 cleanup-pending，
-     * 不能把失败的迟到结果当成新实例成功。
-     */
-    onLateFailure?: (resourceId: string, error: unknown, result?: LifecycleDisposeResult) => void;
-}
-/** 已登记资源的可控释放句柄。 */
-interface LifecycleResourceHandle {
-    /** 资源标识。 */
-    readonly resourceId: string;
-    /** 资源是否已经完成释放。 */
-    readonly released: boolean;
-    /** 幂等释放；重复调用不会再次执行资源释放函数。 */
-    release(reason?: string): Promise<void>;
-}
-/**
- * 作用域公开 API。
- *
- * `revoke()` 只做同步安全撤权；`dispose()` 负责异步资源收尾。业务不需要
- * 接触底层框架 Context，也不能在 stopping/stopped 作用域中注册新资源。
- */
-interface LifecycleScope {
-    readonly identity: LifecycleScopeIdentity;
-    readonly state: LifecycleScopeState;
-    readonly signal: AbortSignal;
-    /** 订阅同步撤权事件；返回值用于取消该订阅。 */
-    onRevoke(listener: (reason: string) => void): () => void;
-    /** 登记一个释放回调；返回取消登记函数。 */
-    onDispose(cleanup: LifecycleCleanup, resourceId?: string, phase?: LifecycleCleanupPhase): () => void;
-    /** 登记已有资源并返回幂等释放句柄。 */
-    track<T>(resource: T, release: (resource: T, reason: string) => void | Promise<void>, resourceId?: string): T;
-    /** 受控异步创建：停止期间才返回的资源会被立即释放且不会进入旧实例。 */
-    acquire<T>(resourceId: string, create: (signal: AbortSignal) => T | Promise<T>, release: (resource: T, reason: string) => void | Promise<void>): Promise<T>;
-    /** 创建同一运行实例下的子作用域。 */
-    child(kind: LifecycleScopeKind, metadata?: Partial<Omit<LifecycleScopeIdentity, "scopeId" | "instanceId" | "kind" | "parentScopeId">>): LifecycleScope;
-    /** 同步撤销权限、发出 signal.abort，并阻止新资源登记。 */
-    revoke(reason?: string): void;
-    /** 异步释放全部已登记资源，结果可见且幂等。 */
-    dispose(options?: LifecycleDisposeOptions): Promise<LifecycleDisposeResult>;
-    /** 作用域已撤权时抛出稳定错误。 */
-    assertActive(): void;
-    /** 只读资源快照。 */
-    resources(): readonly LifecycleResourceSnapshot[];
-}
-/** 生命周期作用域已撤权。 */
-declare class LifecycleScopeRevokedError extends Error {
-    readonly code: "lifecycle.scope_revoked";
-    constructor(message?: string);
-}
-/** 权限租约已撤销或身份不匹配。 */
-declare class PermissionLeaseRevokedError extends Error {
-    readonly code: "permission.lease_revoked";
-    constructor(message?: string);
-}
-/** 没有得到可信装配批准的权限。 */
-declare class PermissionDeniedError extends Error {
-    readonly code: "permission.denied";
-    readonly permission: PluginPermission;
-    constructor(permission: PluginPermission, message?: string);
-}
-/** 权限租约的不可变身份绑定。 */
-interface PermissionLeaseBinding extends LifecycleScopeIdentity {
-    /** 插件申请的权限；申请不等于批准。 */
-    requested: readonly PluginPermission[];
-    /** 可信装配层批准的权限。 */
-    approved: readonly PluginPermission[];
-    /** 当前会话额外允许的权限；未提供会话限制时由装配层视为全量允许。 */
-    sessionConstraints?: readonly PluginPermission[];
-    /** 内置可信策略修订；策略扩大或收窄都会触发重新发租约。 */
-    policyRevision?: number;
-    /** Connect 用户授权修订；内置插件可以省略。 */
-    grantRevision?: number;
-    /** Connect/外部授权的不可猜测授权标识；最终服务边界必须核验。 */
-    grantId?: string;
-}
-/** 最终 RPC / I/O 边界可比较的租约身份字段。 */
-type PermissionLeaseBindingExpectation = Partial<Pick<LifecycleScopeIdentity, "pluginId" | "instanceId">> & {
-    attributes?: Readonly<Record<string, unknown>>;
-} & Partial<Pick<PermissionLeaseBinding, "policyRevision" | "grantRevision" | "grantId">>;
-/** 权限租约；实现必须在最终 RPC/I/O 边界再次校验。 */
-interface PermissionLease {
-    readonly binding: PermissionLeaseBinding;
-    readonly revoked: boolean;
-    /** 当前租约是否同时满足申请、批准和作用域状态。 */
-    has(permission: PluginPermission): boolean;
-    /** 校验权限；失败抛稳定错误。 */
-    assert(permission: PluginPermission): void;
-    /** 校验绑定身份；不允许替换 owner、插件或世代。 */
-    assertBinding(expected: PermissionLeaseBindingExpectation): void;
-    /** 撤销租约；重复调用幂等。 */
-    revoke(reason?: string): void;
-}
-/** 跨 Worker 服务的可序列化引用；引用本身不是授权凭据。 */
-interface RemoteServiceReference {
-    /** 服务契约标识。 */
-    capabilityId: string;
-    /** 提供该服务的运行实例；实例重建后必须变化。 */
-    providerInstanceId: string;
-    /** 提供者所在真实 Runtime。 */
-    runtime: RuntimeKind;
-    /** 服务契约版本；第一阶段要求精确匹配。 */
-    contractVersion: string;
-    /** 提供环境的启动身份；重启后变化。 */
-    authorityInstanceId: string;
-    /** 提供者作用域身份。 */
-    scopeId: string;
-    /** 提供者所在 Coordinator 的升级接管世代；旧 Worker 引用不能跨世代使用。 */
-    handoverGeneration: number;
-    /** 宿主绑定的只读服务属性；服务桥不解释其业务含义。 */
-    attributes: Readonly<Record<string, unknown>>;
-    /** 当前服务目录状态。 */
-    status: "starting" | "ready" | "unavailable" | "failed";
-    /** 该引用所属的物理端口连接；本地服务可省略。 */
-    connectionId?: string;
-    /** 当前权威目录流修订号。 */
-    snapshotRevision: number;
-    /** 可选的外部授权标识；引用不是授权本身，Provider 仍需查权威状态。 */
-    grantId?: string;
-    /** 服务端授权策略修订；策略变化时旧引用必须失效。 */
-    authorizationRevision?: number;
-}
-/** 服务桥握手输入；connectionId 必须由实际端口连接生成。 */
-interface RemoteServiceHandshake {
-    /** 当前端口 / MessagePort 连接标识。 */
-    connectionId: string;
-    /** 对端提供环境的启动身份。 */
-    authorityInstanceId: string;
-    /** 桥协议版本。 */
-    protocolVersion: string;
-}
-/** 一次服务目录基线或增量快照。 */
-interface RemoteServiceSnapshot {
-    /** 快照来自哪条端口连接。 */
-    connectionId: string;
-    /** 快照来自哪个权威启动身份。 */
-    authorityInstanceId: string;
-    /** 同一启动身份、同一订阅范围内单调递增。 */
-    snapshotRevision: number;
-    /** 是否为包含完整订阅范围的基线。 */
-    baseline: boolean;
-    /** 当前订阅范围内的服务引用。 */
-    services: readonly RemoteServiceReference[];
-}
-/** 服务桥在独立 MessagePort 上发送的控制消息。 */
-type RemoteServicePortControlMessage = {
-    /** 控制消息类型由 codec 绑定，核心不固定产品前缀。 */
-    type: string;
-    handshake: RemoteServiceHandshake;
-} | {
-    type: string;
-    snapshot: RemoteServiceSnapshot;
-} | {
-    type: string;
-    reason?: string;
-} | {
-    type: string;
-    reason?: string;
-};
-/** MessagePort 服务消息类别；具体字符串由 codec 统一编码。 */
-type RemoteServiceMessageKind = "call" | "result" | "error" | "cancel" | "handshake" | "snapshot" | "invalidate" | "disconnect";
-/** 服务桥 wire codec；负责类型名、编解码和协议版本，不让传输层散落字符串判断。 */
-interface RemoteServiceMessageCodec {
-    /** codec 对应的协议版本。 */
-    readonly protocolVersion: string;
-    /** 各消息类别对应的 wire type。 */
-    type(kind: RemoteServiceMessageKind): string;
-    /** 将结构化消息编码为可结构化克隆的数据。 */
-    encode(message: Record<string, unknown>): unknown;
-    /** 将 wire 数据解码为对象；无效消息返回 undefined。 */
-    decode(input: unknown): Record<string, unknown> | undefined;
-}
-/** 创建默认 WebLoom codec；产品可用同一工厂绑定旧协议前缀。 */
-declare function createRemoteServiceMessageCodec(options?: {
-    prefix?: string;
-    protocolVersion?: string;
-}): RemoteServiceMessageCodec;
-/** 服务桥查询条件；不匹配时不能返回“差不多兼容”的代理。 */
-interface RemoteServiceLookup {
-    /** 要求的服务契约标识。 */
-    capabilityId: string;
-    /** 要求的精确契约版本。 */
-    contractVersion: string;
-    /** 可选的预期提供 Runtime。 */
-    runtime?: RuntimeKind;
-    /** 可选的预期作用域。 */
-    scopeId?: string;
-}
-/** 服务代理调用上下文；服务端必须在最终边界重新检查引用和租约。 */
-interface RemoteServiceCallContext {
-    /** 业务操作标识；可由调用方复用，用于审计和幂等，不作为传输关联键。 */
-    operationId?: string;
-    /** 实际建立代理的端口连接标识。 */
-    connectionId: string;
-    /** 创建代理时捕获的不可变引用。 */
-    reference: RemoteServiceReference;
-    /** 引用绑定的外部授权标识，供最终服务边界再次核验。 */
-    grantId?: string;
-    /** 同时受消费者作用域和本次请求控制的 signal。 */
-    signal: AbortSignal;
-}
-/** 跨环境传输实现；桥不负责自动重放有外部副作用的请求。 */
-interface RemoteServiceTransport {
-    call<TRequest, TResult>(request: TRequest, context: RemoteServiceCallContext): Promise<TResult>;
-}
-/** 已绑定服务引用的代理；提供者重建后旧代理永久失效。 */
-interface RemoteServiceProxy {
-    readonly reference: RemoteServiceReference;
-    readonly revoked: boolean;
-    call<TRequest, TResult>(request: TRequest, options?: {
-        signal?: AbortSignal;
-        operationId?: string; /** 旧 requestId 调用方别名；不作为传输 callId。 */
-        requestId?: string;
-    }): Promise<TResult>;
-    revoke(reason?: string): void;
-}
-type RemoteServiceBridgeState = "disconnected" | "handshaking" | "ready" | "stale";
-/** 服务桥快照结果；调用方据此决定等待、重新握手或重新同步基线。 */
-type RemoteServiceSnapshotResult = {
-    accepted: true;
-    state: RemoteServiceBridgeState;
-    snapshotRevision: number;
-} | {
-    accepted: false;
-    reason: "wrong-connection" | "wrong-authority" | "stale-revision" | "baseline-required" | "revision-gap";
-    expectedRevision?: number;
-    receivedRevision: number;
-};
-/** 跨 Worker 服务桥最小本地契约。 */
-interface RemoteServiceBridge {
-    /** 当前端口连接状态。 */
-    readonly state: RemoteServiceBridgeState;
-    /** 当前握手连接标识。 */
-    readonly connectionId?: string;
-    /** 当前权威启动身份。 */
-    readonly authorityInstanceId?: string;
-    /** 接受一次新握手；新连接会使旧代理全部失效。 */
-    handshake(input: RemoteServiceHandshake): {
-        accepted: boolean;
-        reason?: "protocol-mismatch";
-    };
-    /** 应用基线或连续增量快照；乱序和旧连接快照会被丢弃。 */
-    applySnapshot(snapshot: RemoteServiceSnapshot): RemoteServiceSnapshotResult;
-    /** 查询当前 ready 且版本精确匹配的服务代理。 */
-    getProxy(lookup: RemoteServiceLookup, scope?: LifecycleScope): RemoteServiceProxy | undefined;
-    /** 查询代理失败时抛出稳定错误。 */
-    requireProxy(lookup: RemoteServiceLookup, scope?: LifecycleScope): RemoteServiceProxy;
-    /** 同步撤下全部代理；不等待远端。 */
-    invalidate(reason?: string): void;
-    /** 端口断线；清除当前连接身份，后续快照必须等待新握手和基线。 */
-    disconnect(reason?: string): void;
-    /** 订阅桥状态和服务目录变化。 */
-    subscribe(listener: () => void): () => void;
-    /** 只读当前有效服务引用。 */
-    services(): readonly RemoteServiceReference[];
-}
-/** 服务桥未就绪或代理已失效。 */
-declare class RemoteServiceUnavailableError extends Error {
-    readonly code: "service.unavailable";
-    constructor(message?: string);
-}
-/** 首次发布采用的升级并存策略。冷切换要求旧环境先退出；两阶段允许
- * 短暂并存，但必须先在写入边界完成同一接管世代的排空。 */
-type UpgradeMode = "cold-switch" | "two-phase";
-/** 升级接管门禁状态；draining 仍可等待旧 I/O，但不接受新业务 I/O。 */
-type UpgradeGateState = "active" | "draining" | "closed";
-/** 新旧 Worker / 客户端接管握手。 */
-interface UpgradeHandshake {
-    /** 发起握手的实际连接标识；会话不能脱离这条连接转移使用。 */
-    connectionId: string;
-    /** 控制协议版本；不兼容时拒绝业务接入。 */
-    protocolVersion: string;
-    /** 构建产物标识；不同构建只有显式兼容时才可接入。 */
-    buildId: string;
-    /** 当前运行环境启动身份。 */
-    authorityInstanceId: string;
-    /** 写入接管世代；旧世代不能重新取得租约。 */
-    handoverGeneration: number;
-    /** 对端支持的精确服务契约版本。 */
-    supportedContractVersions: readonly string[];
-}
-/** 升级握手结果。 */
-type UpgradeHandshakeResult = {
-    accepted: true;
-    mode: UpgradeMode;
-    handoverGeneration: number;
-    contractVersion: string;
-    /** 只有握手返回的绑定会话才可申请 I/O 租约。 */
-    connectionId: string;
-    sessionId: string;
-    session: UpgradeSession;
-} | {
-    accepted: false;
-    reason: "protocol-mismatch" | "build-incompatible" | "stale-generation" | "future-generation" | "contract-mismatch" | "draining" | "closed";
-};
-/** 一次已获准的 I/O 接管租约；排空期间已发租约可完成，close 后失效。 */
-interface UpgradeIoLease {
-    /** 发放租约的实际连接标识。 */
-    readonly connectionId: string;
-    /** 发放该租约的握手会话。 */
-    readonly sessionId: string;
-    /** 发放租约的权威启动身份。 */
-    readonly authorityInstanceId: string;
-    /** 发放租约时的接管世代。 */
-    readonly handoverGeneration: number;
-    /** 精确匹配的服务契约版本。 */
-    readonly contractVersion: string;
-    /** 本次 I/O 类型；写入边界必须额外做领域校验。 */
-    readonly operation: "read" | "write";
-    /** 租约是否已撤销或主动释放。 */
-    readonly revoked: boolean;
-    /** 与本次 I/O 合并的取消信号。 */
-    readonly signal: AbortSignal;
-    /** 在最终提交前检查租约仍属于当前接管门禁。 */
-    assertActive(): void;
-    /** 释放租约；重复调用幂等。 */
-    release(): void;
-}
-/** 一次通过握手、绑定权威/世代/契约版本的接管会话。 */
-interface UpgradeSession {
-    /** 会话绑定的实际连接标识；换连接必须重新握手。 */
-    readonly connectionId: string;
-    /** 不可猜测的会话标识；跨端传输时作为 opaque token。 */
-    readonly sessionId: string;
-    /** 发放会话的当前权威启动身份。 */
-    readonly authorityInstanceId: string;
-    /** 发放会话时的接管世代。 */
-    readonly handoverGeneration: number;
-    /** 握手协商出的精确服务契约版本。 */
-    readonly contractVersion: string;
-    /** 会话是否已撤销。 */
-    readonly revoked: boolean;
-    /** 会话撤销信号。 */
-    readonly signal: AbortSignal;
-    /** 校验会话仍可申请 I/O。 */
-    assertActive(): void;
-    /** 只能申请握手协商出的契约版本，不接受调用方换版本。 */
-    admit(input: {
-        operation: "read" | "write";
-        signal?: AbortSignal;
-    }): UpgradeIoLease;
-    /** 关闭当前握手会话并撤销其尚未完成的 I/O。 */
-    close(reason?: string): void;
-}
-/** 升级排空结果；超时不会伪装成已排空。 */
-interface UpgradeDrainResult {
-    /** 排空时的门禁状态。 */
-    state: UpgradeGateState;
-    /** 是否确认所有已发 I/O 租约都已释放。 */
-    drained: boolean;
-    /** 仍未释放的 I/O 数量。 */
-    pending: number;
-}
-/** 接管门禁创建参数。 */
-interface CreateUpgradeGateOptions {
-    /** 当前接受的控制协议版本。 */
-    protocolVersion: string;
-    /** 当前构建产物标识。 */
-    buildId: string;
-    /** 当前 Worker / 执行环境启动身份。 */
-    authorityInstanceId: string;
-    /** 当前写入接管世代。 */
-    handoverGeneration: number;
-    /** 当前允许的精确服务契约版本集合。 */
-    supportedContractVersions: readonly string[];
-    /** 冷切换或两阶段并存；默认冷切换。 */
-    mode?: UpgradeMode;
-    /** 显式允许接入的旧构建；不填时只接受同 buildId。 */
-    compatibleBuildIds?: ReadonlySet<string>;
-    /** 更复杂部署可提供显式构建兼容规则。 */
-    isBuildCompatible?: (buildId: string) => boolean;
-}
-/** 跨 Worker 写入接管门禁。它不负责选主、不负责调度插件。 */
-interface UpgradeGate {
-    readonly state: UpgradeGateState;
-    readonly mode: UpgradeMode;
-    readonly authorityInstanceId: string;
-    readonly handoverGeneration: number;
-    /** 校验版本、构建、接管世代和精确契约版本。 */
-    handshake(input: UpgradeHandshake): UpgradeHandshakeResult;
-    /** 当前仍允许发放新业务 I/O 租约。 */
-    assertAccepting(): void;
-    /** 发放绑定当前握手会话、权威和世代的 I/O 租约。 */
-    admit(input: {
-        session: UpgradeSession;
-        operation: "read" | "write";
-        signal?: AbortSignal;
-    }): UpgradeIoLease;
-    /** 同步关闭新 I/O 入口；不等待已提交 I/O。 */
-    beginDrain(reason?: string): void;
-    /** 等待已发租约释放；超时后仍保持 draining。 */
-    drain(timeoutMs?: number): Promise<UpgradeDrainResult>;
-    /** 永久关闭并撤销尚未释放的租约。 */
-    close(reason?: string): void;
-    /** 当前已发且尚未释放的 I/O 数量。 */
-    activeIo(): number;
-}
-/** 升级门禁拒绝或租约失效。 */
-declare class UpgradeGateRejectedError extends Error {
-    readonly code: "upgrade.gate_rejected";
-    readonly reason: string;
-    constructor(reason: string, message?: string);
-}
-/** 单次插件启停控制命令；目标是绝对意图，不是 toggle。 */
-interface PluginIntentCommand {
-    /** 客户端生成的幂等命令标识。 */
-    commandId: string;
-    /** 命令发送方握手得到的控制面启动身份。 */
-    authorityInstanceId: string;
-    /** 客户端观察到的全局修订。 */
-    expectedRevision: number;
-    /** 目标产品标识。 */
-    pluginId: string;
-    /** 目标启用意图。 */
-    desiredEnabled: boolean;
-}
-/** 控制面持久化的插件意图快照。 */
-interface PluginIntentSnapshot {
-    /** 控制面全局修订。 */
-    revision: number;
-    /** 每个产品当前的绝对启用意图。 */
-    desiredEnabled: Readonly<Record<string, boolean>>;
-    /** 每个产品自己的意图修订。 */
-    desiredRevision: Readonly<Record<string, number>>;
-}
-/** 启停命令的结构化结果；accepted 只表示意图已持久化。 */
-type PluginIntentCommandResult = {
-    status: "accepted" | "duplicate";
-    commandId: string;
-    snapshot: PluginIntentSnapshot;
-    persisted: true;
-} | {
-    status: "stale-authority";
-    commandId: string;
-    expectedAuthorityInstanceId: string;
-} | {
-    status: "command-conflict";
-    commandId: string;
-    message: string;
-} | {
-    status: "revision-conflict";
-    commandId: string;
-    snapshot: PluginIntentSnapshot;
-} | {
-    status: "persistence-failed";
-    commandId: string;
-    message: string;
-    snapshot: PluginIntentSnapshot;
-};
-/** 意图 RPC 的完整结果；transport-error 不代表意图已保存。 */
-type PluginIntentSubmissionResult = PluginIntentCommandResult | {
-    status: "transport-error";
-    message: string;
-    retryable: boolean;
-};
-/** 单一控制面上的命令去重、修订比较和持久化边界。 */
-interface PluginIntentController {
-    /** 当前控制面启动身份；Worker 重启后必须更换。 */
-    readonly authorityInstanceId: string;
-    /** 当前意图快照。 */
-    snapshot(): PluginIntentSnapshot;
-    /** 串行提交一次绝对意图命令。 */
-    submit(command: PluginIntentCommand): Promise<PluginIntentCommandResult>;
-    /** 订阅持久化成功后的意图变化。 */
-    subscribe(listener: (snapshot: PluginIntentSnapshot) => void): () => void;
-}
-/** Host 使用的意图控制面适配器；生产实现位于 Coordinator client。 */
-interface PluginIntentCoordinator {
-    /** 当前 SharedWorker authority；Worker 重启后变化。 */
-    readonly authorityInstanceId: string;
-    /** 当前权威意图快照。 */
-    snapshot(): PluginIntentSnapshot;
-    /** 提交绝对启停意图；不直接承诺运行实例已启动。 */
-    submit(command: PluginIntentCommand): Promise<PluginIntentSubmissionResult>;
-    /** 接收其它页面或 Worker 广播的持久化快照。 */
-    subscribe(listener: (snapshot: PluginIntentSnapshot) => void): () => void;
-}
-/** 带实例取消信号的后台任务定义；不负责持久化外部副作用。 */
-interface ScopedTaskDefinition {
-    /** 全局唯一任务标识。 */
-    id: string;
-    /** 所属插件；默认由作用域身份提供。 */
-    pluginId?: string;
-    /** 展示名称。 */
-    label: string;
-    /** 周期；缺省表示只响应显式触发。 */
-    intervalMs?: number;
-    /** 任务执行体。 */
-    run(context: {
-        signal: AbortSignal;
-        reason: string;
-    }): void | Promise<void>;
-}
-/** 作用域任务的运行快照。 */
-interface ScopedTaskSnapshot {
-    /** 任务标识。 */
-    id: string;
-    /** 所属插件。 */
-    pluginId: string;
-    /** 展示名称。 */
-    label: string;
-    /** 当前任务状态。 */
-    state: "idle" | "queued" | "running" | "failed";
-    /** 最近一次错误。 */
-    error?: string;
-    /** 最近成功时间。 */
-    lastCompletedAt?: string;
-    /** 下一次周期触发时间。 */
-    nextRunAt?: string;
-}
-/** 绑定作用域的最小任务调度器。 */
-interface ScopedTaskScheduler {
-    /** 注册任务并返回幂等取消句柄。 */
-    register(definition: ScopedTaskDefinition): () => void;
-    /** 显式触发一次；同一任务运行中只合并一次重跑请求。 */
-    runNow(id: string, reason?: string): Promise<void>;
-    /** 取消当前任务实例并等待其退出。 */
-    cancel(id: string): Promise<void>;
-    /** 获取当前任务快照。 */
-    snapshot(): readonly ScopedTaskSnapshot[];
-    /** 订阅快照变化。 */
-    subscribe(listener: (snapshot: readonly ScopedTaskSnapshot[]) => void): () => void;
-}
-/** 作用域后台任务调度器 capability key。 */
-declare const SCOPED_TASK_SCHEDULER_CAPABILITY = "runtime.task-scheduler";
-/** 用户可见的稳定生命周期错误中文说明。 */
-declare const LIFECYCLE_ERROR_TEXT: Readonly<Record<string, string>>;
-/** 将稳定错误码映射到中文 UI 文案；未知错误返回通用提示。 */
-declare function lifecycleErrorText(code: string): string;
-
-/** runtime messageBus capability key；manifest 通过 ctx.get<...> 取出。 */
-declare const RUNTIME_MESSAGE_BUS = "webloom.messageBus";
-/** 消息调用语义。 */
-type MessageMode = "event" | "command" | "request";
-/** 消息 envelope。 */
-interface Message<TPayload = unknown> {
-    id: string;
-    type: string;
-    mode: MessageMode;
-    payload: TPayload;
-    /** 由哪个 actor mailbox 消费。缺省时同步调用 subscriber 或无 mailbox。 */
-    target?: string;
-    /** 数值越大越优先（actor 内部解读）。 */
-    priority?: number;
-    /** 超时（ms）；超时后 message 标记为超时失败。 */
-    timeoutMs?: number;
-    /**
-     * MessageBus 内部维护的 abort signal。
-     *  - 来自调用方 DispatchOptions.signal 的 upstream 取消会触发。
-     *  - 来自 MessageBus 自身的 timeout 触发。
-     *  - 来自 actor / MessageBus 内部主动 abort。
-     *  handler 应优先用此 signal 取消 fetch 等异步操作；payload.signal 仍
-     *  可保留以兼容旧调用方。
-     */
-    signal?: AbortSignal;
-    causationId?: string;
-    createdAt: number;
-}
-/** 消息 handler 签名。 */
-type MessageHandler<TPayload = unknown, TResult = unknown> = (message: Message<TPayload>) => TResult | Promise<TResult>;
-/** publish 行为：仅同步广播给订阅者，不等待异步 handler 完成。 */
-interface PublishOptions {
-    /** 关联上一条消息（同一业务动作触发的子事件）。 */
-    causationId?: string;
-    /** 自定义 message id；缺省由 MessageBus 生成。 */
-    messageId?: string;
-}
-/**
- * dispatch 行为：投递给 actor mailbox；返回 messageId。
- *  - target 必填：dispatch 期望被 actor 处理，不退化为 publish 语义。
- *  - 找到 handler 时消息会真正入 mailbox 并被 pump 串行消费。
- *  - 找不到 handler 时消息被记为 failed + lastError，但**不抛**给调用方
- *    （dispatch 不返回结果）。
- */
-interface DispatchOptions extends PublishOptions {
-    target: string;
-    priority?: number;
-    signal?: AbortSignal;
-    timeoutMs?: number;
-    /** 消息进入终态后调用一次；生命周期 facade 用它释放临时 signal 监听。 */
-    onSettled?: () => void;
-}
-/**
- * request 行为：等待 actor 返回结果；选项语义与 dispatch 完全一致。
- *  - 行为差异：request 返回 Promise<TResult>，handler reject 即 promise reject。
- *  - 找不到 handler / no target 时立即 reject。
- *  - timeoutMs 触发时会先 abort 内部 signal，再 reject 外层 promise；
- *    handler 内部应该监听 message.signal 取消 fetch。
- */
-type RequestOptions = DispatchOptions;
-/** handle 注册选项。 */
-interface HandlerOptions {
-    target?: string;
-    priority?: number;
-    /**
-     * 同 target 投递并发上限。
-     * 缺省 1：同 target actor 严格串行。
-     * 同 target 全部 handler 注册时必须使用一致 concurrency，否则
-     * MessageBus 抛 `Conflicting concurrency for target "..."`。
-     * 注意：这是 MessageBus 投递并发，不是 handler 内部副作用（如网络
-     * 请求）的并发；高并发适合"内部 actor 自己做限流"的场景（如 WOC
-     * 内部 mailbox）。
-     */
-    concurrency?: number;
-}
-/** 快照。 */
-interface MessageBusSnapshot {
-    /** 消息总数（含已完成、失败、被取消）。 */
-    total: number;
-    /** 队列中尚未处理的消息数。 */
-    queued: number;
-    /** 飞行中消息数。 */
-    inFlight: number;
-    /** 已成功完成的消息数。 */
-    completed: number;
-    /** handler 抛错或被 lastError 路径标记失败的消息数。 */
-    failed: number;
-    /** 被 abort signal 取消的消息数。 */
-    canceled: number;
-    /** 最近一次错误。 */
-    lastError?: string;
-    /** 各 target 队列长度。 */
-    byTarget: Record<string, number>;
-}
-/** 订阅事件快捷方式：仅接收 mode=event 的消息。 */
-type EventHandler<TPayload = unknown> = (payload: TPayload) => void;
-/**
- * MessageBus 契约。
- * 设计缘由：业务插件调用方只看到这一套入口。
- */
-interface MessageBus {
-    /** 事件广播：已发生的事实，不等待业务完成；同步调用 subscriber。 */
-    publish<TPayload>(type: string, payload: TPayload, options?: PublishOptions): string;
-    /** 事件订阅：仅接收 mode=event 的消息；返回取消订阅函数。 */
-    subscribe<TPayload>(type: string, handler: EventHandler<TPayload>): () => void;
-    /**
-     * 命令投递：把消息入 actor mailbox，返回 messageId。
-     *  不等待 handler 完成；handler 抛错 / 超时 / 找不到 handler 仅写
-     *  snapshot.lastError，不冒泡。
-     */
-    dispatch<TPayload>(type: string, payload: TPayload, options: DispatchOptions): string;
-    /** 请求响应：等待 actor 返回结果。 */
-    request<TPayload, TResult>(type: string, payload: TPayload, options: RequestOptions): Promise<TResult>;
-    /** 注册 handler：带 target 时进入对应 actor mailbox。 */
-    handle<TPayload, TResult>(type: string, handler: MessageHandler<TPayload, TResult>, options?: HandlerOptions): () => void;
-    /** 快照。 */
-    snapshot(): MessageBusSnapshot;
-    /** 订阅快照变更。 */
-    onSnapshot(handler: (snapshot: MessageBusSnapshot) => void): () => void;
-}
-
-/** 宿主注入的只读结构化属性；不得放入私钥、口令或 Seed。 */
-type PluginAttributes = Readonly<Record<string, unknown>>;
-/** 插件配置的默认形状；具体配置由产品通过泛型约束。 */
-type PluginConfig = Readonly<Record<string, unknown>>;
-/** 插件对宿主贡献的默认形状；具体贡献由产品通过泛型约束。 */
-type PluginContribution = unknown;
-/** 插件 Context Extension 的默认形状；领域服务只能从这里注入。 */
-type PluginContextExtension = Readonly<Record<string, unknown>>;
-/** 插件运行时上下文，由 Host 创建并传入运行单元实现。 */
-interface PluginContext<TConfig extends PluginConfig = PluginConfig, TExtension extends PluginContextExtension = PluginContextExtension> {
-    /** Host 绑定的稳定产品标识；插件不能从调用参数伪造其它标识。 */
-    readonly pluginId: string;
-    /** 本次装配生成的实例标识；重启不得复用。 */
-    readonly instanceId: string;
-    /** 稳定运行单元标识；不等于本次启动的 instanceId。 */
-    readonly unitId: string;
-    /** 当前插件实例的作用域；业务资源应登记到此作用域。 */
-    readonly scope: LifecycleScope;
-    /** 作用域撤权信号；停止、禁用和宿主关闭时触发。 */
-    readonly signal: AbortSignal;
-    /** 可信装配层批准后的权限视图；插件自声明不能扩大集合。 */
-    readonly permissions: readonly PluginPermission[];
-    /** 绑定当前实例和权限身份的租约；最终 I/O 仍需再次校验。 */
-    readonly permissionLease: PermissionLease;
-    /** 已完成握手和快照校验的远程服务桥。 */
-    readonly serviceBridge?: RemoteServiceBridge;
-    /** 绑定当前插件实例的后台任务注册面。 */
-    readonly taskScheduler?: ScopedTaskScheduler;
-    /** 宿主注入的领域扩展；只读且不能替换实例身份。 */
-    readonly extension: TExtension;
-    /** 注册在停止前运行的清理函数；重复停止必须幂等。 */
-    onDispose(cleanup: PluginTeardown): void;
-    /** 注册 capability；重复注册会抛错。 */
-    provide<T>(key: string, value: T): void;
-    /** 读取 capability；缺失会抛错。 */
-    get<T>(key: string): T;
-    /** 探测 capability 是否存在。 */
-    has(key: string): boolean;
-    /** 要求 capability 存在，否则抛错。 */
-    require(key: string): void;
-    /** 事件、命令和请求响应的统一入口。 */
-    readonly messageBus: MessageBus;
-    /** 宿主注入的只读配置；不与启停意图存储混用。 */
-    readonly config?: TConfig;
-}
-/** v1 运行时依赖；跨 Runtime 绑定必须使用精确契约版本和来源 Runtime。 */
-interface RuntimeDependency {
-    /** 依赖的 capability 标识。 */
-    capability: string;
-    /** 精确契约版本；跨 Runtime 依赖必须显式填写，本地可由 helper 推导。 */
-    contractVersion?: string;
-    /** 提供者实际运行空间；省略时由当前 Runtime 补齐。 */
-    sourceRuntime?: RuntimeKind;
-    /** 可选的人类可读诊断说明。 */
-    reason?: string;
-    /** 缺失时只关闭局部能力，不阻止主体运行。 */
-    optional?: boolean;
-}
-/** 简单插件的产品级依赖别名。 */
-type PluginDependency = RuntimeDependency;
-/** 运行单元的严格依赖描述。 */
-interface RuntimeUnitDependency {
-    /** 依赖的 capability 标识。 */
-    capability: string;
-    /** 精确契约版本；第一阶段只接受完全匹配。 */
-    contractVersion: string;
-    /** 提供者实际运行空间；跨 Runtime 依赖在 materialize/validate 边界必须补齐。 */
-    sourceRuntime: RuntimeKind;
-    /** 可选的人类可读诊断说明。 */
-    reason?: string;
-    /** 缺失时只关闭局部能力；未填写表示硬依赖。 */
-    optional?: boolean;
-}
-/** 作者入口的未归一化 unit 依赖；进入 Host 前必须补齐版本和来源 Runtime。 */
-type RuntimeUnitDependencyInput = Omit<RuntimeUnitDependency, "contractVersion" | "sourceRuntime"> & {
-    contractVersion?: string;
-    sourceRuntime?: RuntimeKind;
-};
-/** 返回稳定的 capability 契约版本。 */
-declare function runtimeCapabilityContractVersion(capability: string): string;
-/** 将依赖清单补齐为严格运行单元依赖。 */
-declare function defineRuntimeUnitDependencies(dependencies: readonly Pick<PluginDependency, "capability" | "reason" | "optional">[], defaults: {
-    sourceRuntime: RuntimeKind;
-}): RuntimeUnitDependency[];
-/** 为运行单元生成精确的 capability 契约版本表。 */
-declare function defineRuntimeUnitProvidedContracts(capabilities: readonly string[]): Record<string, string>;
-/** 插件在产品清单中的启动要求。 */
-type PluginStartupMode = "required" | "optional";
-/** 插件装配元数据；v1 不解释产品分类字段。 */
-interface PluginMeta {
-    /** 首次装配时默认是否启用。 */
-    defaultEnabled: boolean;
-    /** 是否允许产品控制面禁用。 */
-    canDisable: boolean;
-    /** 是否属于启动必需插件。 */
-    startup?: PluginStartupMode;
-}
-/** 插件 setup 返回的清理函数。 */
-type PluginTeardown = () => void | Promise<void>;
-/** 插件运行单元的无 UI 装配入口。 */
-type PluginSetup<TConfig extends PluginConfig = PluginConfig, TExtension extends PluginContextExtension = PluginContextExtension> = (ctx: PluginContext<TConfig, TExtension>) => void | Promise<void> | PluginTeardown | Promise<PluginTeardown>;
-/** 当前执行环境中按 productId + unitId 解析实现。 */
-interface RuntimeUnitImplementationRegistry<TConfig extends PluginConfig = PluginConfig, TExtension extends PluginContextExtension = PluginContextExtension> {
-    /** 未装配实现时返回 undefined。 */
-    get(pluginId: string, unitId: string): PluginSetup<TConfig, TExtension> | undefined;
-}
-/** 一个产品可以装配的运行单元。 */
-interface RuntimeUnitDescriptor<TContribution = PluginContribution, TConfig extends PluginConfig = PluginConfig> {
-    /** 稳定运行单元标识。 */
-    id: string;
-    /** 运行代码所在真实 Runtime。 */
-    runtime: RuntimeKind;
-    /** 本单元所需的精确 capability 契约。 */
-    dependencies?: RuntimeUnitDependency[];
-    /** 本单元提供的 capability。 */
-    provides?: string[];
-    /** 本单元每个 capability 的精确版本。 */
-    providedContracts?: Record<string, string>;
-    /** 宿主贡献；内容由产品泛型定义。 */
-    contribution?: TContribution;
-    /** 本单元申请的权限。 */
-    permissions?: PluginPermission[];
-    /** 单元专属只读配置声明或装配默认值。 */
-    config?: TConfig;
-}
-/** 作者入口的未归一化运行单元；runtime 可由 createWindowApp/startSharedWorkerApp 注入。 */
-type RuntimeUnitDescriptorInput<TContribution = PluginContribution, TConfig extends PluginConfig = PluginConfig> = Omit<RuntimeUnitDescriptor<TContribution, TConfig>, "runtime" | "dependencies"> & {
-    runtime?: RuntimeKind;
-    dependencies?: readonly RuntimeUnitDependencyInput[];
-};
-/** 插件清单；插件作者导出的唯一静态描述。 */
-interface PluginManifest<TContribution = PluginContribution, TConfig extends PluginConfig = PluginConfig, TExtension extends PluginContextExtension = PluginContextExtension> {
-    /** 全局稳定产品标识。 */
-    id: string;
-    /** 展示名称。 */
-    name: string;
-    /** 展示描述。 */
-    description?: string;
-    /** 简单插件的宿主贡献；复杂产品通过运行单元声明。 */
-    contribution?: TContribution;
-    /** 简单插件的兼容依赖。 */
-    dependencies?: PluginDependency[];
-    /** 简单插件声明提供的 capability；多单元插件必须放入 unit.provides。 */
-    provides?: string[];
-    /** 产品元数据。 */
-    meta: PluginMeta;
-    /** 简单插件的申请权限。 */
-    permissions?: PluginPermission[];
-    /** 多环境插件的静态运行单元描述。 */
-    units?: readonly RuntimeUnitDescriptor<TContribution, TConfig>[];
-    /** 简单插件的只读配置。 */
-    config?: TConfig;
-}
-/** 作者入口的未归一化静态清单；进入 Host 前必须 materialize 成 PluginManifest。 */
-type PluginManifestInput<TContribution = PluginContribution, TConfig extends PluginConfig = PluginConfig, TExtension extends PluginContextExtension = PluginContextExtension> = Omit<PluginManifest<TContribution, TConfig, TExtension>, "units"> & {
-    units?: readonly RuntimeUnitDescriptorInput<TContribution, TConfig>[];
-};
-/** 插件运行状态类别；registered 不代表已经运行。 */
-type PluginStateKind = "registered" | "starting" | "stopping" | "enabled" | "disabled" | "blocked" | "error-disabled" | "cleanup-pending" | "unknown";
-/** 对外稳定的产品运行语义。 */
-type PluginLifecycleState = "disabled" | "waiting" | "starting" | "running" | "stopping" | "failed";
-/** Host 查询到的插件状态。 */
-interface PluginState {
-    /** 产品标识。 */
-    id: string;
-    /** 兼容状态类别。 */
-    kind: PluginStateKind;
-    /** 稳定生命周期语义。 */
-    lifecycleState?: PluginLifecycleState;
-    /** 最近一次错误。 */
-    error?: string;
-    /** 持久化启用意图。 */
-    desiredEnabled?: boolean;
-    /** 当前产品意图修订。 */
-    desiredRevision?: number;
-    /** 当前运行实例标识。 */
-    instanceId?: string;
-    /** 当前运行单元标识。 */
-    unitId?: string;
-    /** 当前阻塞或清理原因。 */
-    blockedBy?: string[];
-    /** 最近一次结构化清理结果。 */
-    cleanup?: LifecycleDisposeResult;
-    /** 当前产品下的运行单元状态。 */
-    units?: readonly PluginUnitState[];
-}
-/** 运行单元状态；唯一身份由 product、unit 和 instance 共同组成。 */
-interface PluginUnitState {
-    /** 所属产品标识。 */
-    pluginId: string;
-    /** 稳定运行单元标识。 */
-    unitId: string;
-    /** 真实运行空间。 */
-    runtime: RuntimeKind;
-    /** 当前运行实例。 */
-    instanceId?: string;
-    /** 当前意图修订。 */
-    desiredRevision?: number;
-    /** 单元状态。 */
-    kind: PluginStateKind;
-    /** 单元失败原因。 */
-    error?: string;
-    /** 单元清理结果。 */
-    cleanup?: LifecycleDisposeResult;
-}
-/** 依赖图中的反向依赖者。 */
-interface PluginReverseDep {
-    /** 反向依赖产品标识。 */
-    pluginId: string;
-    /** 依赖者当前是否运行。 */
-    enabled: boolean;
-    /** 触发依赖的 capability。 */
-    capabilities: string[];
-}
-/** 插件依赖图快照。 */
-interface PluginGraph {
-    /** 已知产品标识列表。 */
-    plugins: string[];
-    /** 产品依赖的 capability。 */
-    dependencies: Record<string, string[]>;
-    /** 产品的可选依赖。 */
-    optionalDependencies?: Record<string, string[]>;
-    /** 产品声明提供的 capability。 */
-    provides: Record<string, string[]>;
-    /** capability 到反向依赖者。 */
-    reverse: Record<string, PluginReverseDep[]>;
-    /** capability 到声明提供者。 */
-    providers?: Record<string, string[]>;
-    /** 精确依赖描述。 */
-    dependencyDetails?: Record<string, PluginDependency[]>;
-    /** 发现的硬依赖环。 */
-    cycles?: string[][];
-    /** 当前图中的运行单元。 */
-    units?: Record<string, PluginUnitGraph>;
-}
-/** 运行单元依赖图节点。 */
-interface PluginUnitGraph {
-    /** 所属产品标识。 */
-    pluginId: string;
-    /** 稳定运行单元标识。 */
-    unitId: string;
-    /** 真实运行空间。 */
-    runtime: RuntimeKind;
-    /** capability 依赖。 */
-    dependencies: string[];
-    /** 精确依赖描述。 */
-    dependencyDetails?: RuntimeUnitDependency[];
-    /** capability 提供。 */
-    provides: string[];
-    /** capability 精确版本。 */
-    providedContracts?: Record<string, string>;
-}
-/** Host 版本或状态变化监听器。 */
-type HostListener = (snapshot: {
-    version: number;
-}) => void;
-/** 启动前能力检查的结构化详情。 */
-interface StartupCapabilityErrorDetails {
-    /** 缺失 capability 标识。 */
-    capability: string;
-    /** 已知提供者产品标识。 */
-    providerPluginId?: string;
-    /** 提供者状态。 */
-    providerState?: PluginStateKind;
-    /** 提供者错误。 */
-    providerError?: string;
-    /** 当前持久化意图。 */
-    configuredEnabled?: boolean;
-}
-/** 启动插件失败的结构化详情。 */
-interface StartupPluginErrorDetails {
-    /** 产品标识。 */
-    pluginId: string;
-    /** 失败的运行单元。 */
-    unitId?: string;
-    /** 能力列表。 */
-    capabilities: string[];
-    /** 当前状态。 */
-    state: PluginStateKind;
-    /** 最近错误。 */
-    error?: string;
-}
-
-/** 资源键：稳定、可比较且不含秘密的字符串元组。 */
-type ResourceKey = readonly [resourceId: string, ...parts: readonly string[]];
-/** 资源当前状态。 */
-type ResourceStatus = "pending" | "ready" | "stale" | "error" | "blocked";
-/** 资源快照：状态、数据、错误和单调修订。 */
-interface ResourceSnapshot<T> {
-    /** 资源键。 */
-    readonly key: ResourceKey;
-    /** 当前加载状态。 */
-    readonly status: ResourceStatus;
-    /** 当前数据；未 ready 时可以为空。 */
-    readonly data: T | undefined;
-    /** 稳定错误码和可展示错误信息。 */
-    readonly error?: {
-        readonly code: string;
-        readonly message: string;
-    };
-    /** 快照修订，每次有效变化递增。 */
-    readonly revision: number;
-}
-/** 资源读取上下文；只提供通用 capability 和宿主扩展属性。 */
-interface ResourceContext<TAttributes extends Readonly<Record<string, unknown>> = Readonly<Record<string, unknown>>> {
-    /** 读取已注入的 capability；不存在时返回 undefined。 */
-    getCapability<T>(id: string): T | undefined;
-    /** 资源定义所属的插件实例标识；由注册表绑定，插件不能伪造。 */
-    readonly ownerId: string;
-    /** 宿主绑定的当前作用域属性；资源定义不能写入。 */
-    readonly attributes: TAttributes;
-}
-/** Runtime-only metadata used to bind a definition to an owner. */
-declare const RESOURCE_OWNER: unique symbol;
-type OwnedResourceDefinition = ResourceDefinition<unknown, readonly string[]> & {
-    readonly [RESOURCE_OWNER]?: string;
-};
-/** 资源定义：描述键、加载、失效订阅与比较方式。 */
-interface ResourceDefinition<T, TArgs extends readonly string[] = readonly string[]> {
-    /** 资源唯一标识。 */
-    readonly id: string;
-    /** 资源所依附的生命周期标签，由宿主解释。 */
-    readonly scope: string;
-    /** 生成资源键。 */
-    key(args: TArgs, context: ResourceContext): ResourceKey;
-    /** 加载资源数据；实现必须响应 signal。 */
-    load(args: TArgs, context: ResourceContext, signal: AbortSignal): Promise<T>;
-    /** 订阅失效事件；只表达失效，不直接改写快照。 */
-    subscribe?(args: TArgs, context: ResourceContext, invalidate: () => void): () => void;
-    /** 语义相等判断；返回 true 时不发布新数据快照。 */
-    equals?(previous: T | undefined, next: T | undefined): boolean;
-    /** 同一事件循环内是否合并失效通知。 */
-    readonly invalidation: "immediate" | "microtask";
-}
-/** 资源定义注册表。 */
-interface ResourceRegistry {
-    /** 注册资源定义。 */
-    register<T, TArgs extends readonly string[]>(definition: ResourceDefinition<T, TArgs>): void;
-    /** 注销资源定义。 */
-    unregister(id: string): void;
-    /** 查询资源定义。 */
-    get<T, TArgs extends readonly string[]>(id: string): ResourceDefinition<T, TArgs> | undefined;
-    /** 调试和宿主清理使用的定义标识。 */
-    _ids(): string[];
-}
-/** Resource Registry 的 capability 标识。 */
-declare const RESOURCE_REGISTRY_CAPABILITY = "webloom.resource.registry";
-
-interface CapabilityRegistry {
-    provide<T>(key: string, value: T): void;
-    /**
-     * 硬切换 001：撤销一个 capability。
-     * 不存在时 no-op；存在则移除。提供方应保证自己负责的 capability
-     * 被撤销时，相关订阅/资源也被清理（这通常由 host 的 plugin teardown
-     * 流程负责）。
-     */
-    revoke(key: string): void;
-    get<T>(key: string): T;
-    has(key: string): boolean;
-    require(key: string): void;
-    /** 仅用于调试。 */
-    keys(): string[];
-}
-declare function createCapabilityRegistry(): CapabilityRegistry;
-
-/** Resource Store 公共 API。 */
-interface ResourceStoreApi {
-    /** 确保资源已加载，并返回当前快照。 */
-    ensure<T>(definitionId: string, args: readonly string[]): ResourceSnapshot<T>;
-    /** 订阅资源变更。 */
-    subscribe(definitionId: string, args: readonly string[], callback: () => void): () => void;
-    /** 读取资源快照，不触发加载。 */
-    read<T>(definitionId: string, args: readonly string[]): ResourceSnapshot<T> | undefined;
-    /** 使资源失效并重新加载。 */
-    invalidate(definitionId: string, args: readonly string[]): void;
-    /** 清理指定 owner 的所有资源记录。 */
-    disposeOwner(ownerId: string): void;
-    /** 宿主属性或 capability 变化后刷新绑定。 */
-    refreshRuntimeBindings(): void;
-    /** 订阅宿主 Context 变化。 */
-    subscribeContext(callback: () => void): () => void;
-}
-type Attributes = Readonly<Record<string, unknown>>;
-/** 创建通用 Resource Store。 */
-declare function createResourceStore(registry: ResourceRegistry, getCapability: <T>(id: string) => T | undefined, getAttributes?: (ownerId?: string) => Attributes): ResourceStoreApi;
-
-/** 插件启停意图的通用持久化端口。 */
-interface PluginConfigStore {
-    /** 读取产品级绝对启停意图。 */
-    read(): Readonly<Record<string, boolean>>;
-    /** 写入一个产品的绝对启停意图。 */
-    setEnabled(pluginId: string, enabled: boolean): void;
-    /** 订阅外部控制面带来的变化。 */
-    subscribe(listener: (snapshot: Readonly<Record<string, boolean>>) => void): () => void;
-}
-/** 创建内存配置端口；产品可通过 configStore 注入持久化实现。 */
-declare function createInMemoryPluginConfigStore(initial?: Readonly<Record<string, boolean>>, readOnly?: boolean): PluginConfigStore;
-/** 权限策略输入；申请、批准和会话约束必须分开计算。 */
-interface PermissionPolicyInput {
-    /** 产品标识。 */
-    pluginId: string;
-    /** 运行单元标识。 */
-    unitId: string;
-    /** 当前 Scope 身份。 */
-    identity: LifecycleScopeIdentity;
-    /** 清单申请的权限。 */
-    requested: readonly PluginPermission[];
-}
-/** 权限策略结果；Host 只发放三者交集。 */
-interface PermissionPolicyResult {
-    /** 可信装配批准集合；缺省为申请集合。 */
-    approved?: readonly PluginPermission[];
-    /** 当前会话的额外限制。 */
-    sessionConstraints?: readonly PluginPermission[];
-    /** 绑定到租约的策略/授权修订。 */
-    binding?: Partial<Pick<PermissionLeaseBinding, "policyRevision" | "grantRevision" | "grantId">>;
-}
-/** Context Extension 生成输入。 */
-interface ContextExtensionInput {
-    /** 产品标识。 */
-    pluginId: string;
-    /** 运行单元标识。 */
-    unitId: string;
-    /** 本次实例标识。 */
-    instanceId: string;
-    /** 实例 Scope。 */
-    scope: LifecycleScope;
-    /** 静态清单。 */
-    manifest: PluginManifest;
-}
-/** 贡献注册的运行时输入。 */
-interface ContributionAdapterInput {
-    /** 产品标识。 */
-    pluginId: string;
-    /** 运行单元标识。 */
-    unitId: string;
-    /** 实例标识。 */
-    instanceId: string;
-    /** 实例 Scope。 */
-    scope: LifecycleScope;
-    /** 泛型产品贡献。 */
-    contribution: unknown;
-    /** 完整静态清单。 */
-    manifest: PluginManifest;
-}
-/** 贡献适配器返回的同步撤权/异步清理句柄。 */
-interface ContributionHandle {
-    /** 同步撤下 UI、命令或其它入口；不能等待网络。 */
-    revoke?(): void;
-    /** 异步完成底层清理；失败必须可观察。 */
-    dispose?(): void | Promise<void>;
-}
-/** 宿主贡献适配器；具体产品可以注册多个不同领域的适配器。 */
-interface ContributionAdapter {
-    /** 适配器名称，仅用于诊断。 */
-    name?: string;
-    /** 注册一份泛型贡献。 */
-    register(input: ContributionAdapterInput): void | ContributionHandle | (() => void | Promise<void>) | Promise<void | ContributionHandle | (() => void | Promise<void>)>;
-}
-/** 运行单元可用性检查；返回稳定原因表示当前实例不能装配。 */
-interface RuntimeUnitAvailabilityInput {
-    /** 产品标识。 */
-    pluginId: string;
-    /** 运行单元标识。 */
-    unitId: string;
-    /** 真实 Runtime。 */
-    runtime: RuntimeKind;
-}
-/** 新运行单元 Scope 的身份属性输入。 */
-interface RuntimeUnitAttributesInput extends RuntimeUnitAvailabilityInput {
-    /** 静态产品清单。 */
-    manifest: PluginManifest;
-}
-/** 为运行单元选择父 Scope；未提供时运行单元直接挂在 Host 根 Scope。 */
-type RuntimeUnitParentScopeInput = RuntimeUnitAttributesInput;
-/** 通用运行单元快照；用于展示远端单元未知/恢复状态。 */
-interface RuntimeUnitSnapshot {
-    /** 产品标识。 */
-    pluginId: string;
-    /** 单元标识。 */
-    unitId: string;
-    /** 真实 Runtime。 */
-    runtime: RuntimeKind;
-    /** 远端实例标识。 */
-    instanceId?: string;
-    /** 远端当前状态。 */
-    state: PluginStateKind;
-}
-interface CreatePluginHostOptions {
-    /** 当前 Host 所在真实 Runtime。 */
-    runtime?: RuntimeKind;
-    /** 根 Scope 的宿主只读属性。 */
-    rootAttributes?: Readonly<Record<string, unknown>>;
-    /** 预注入的内建 capability；不归属于任何插件实例。 */
-    capabilities?: Readonly<Record<string, unknown>> | ReadonlyMap<string, unknown>;
-    /** 可选的资源定义注册表；适配器可把领域 facade 绑定到同一个 Store。 */
-    resourceRegistry?: ResourceRegistry;
-    /** 可选的消息总线；适配器可为 legacy capability 保持同一实例。 */
-    messageBus?: MessageBus;
-    /** builtin capability 的别名，便于适配器明确表达用途。 */
-    builtinCapabilities?: Readonly<Record<string, unknown>> | ReadonlyMap<string, unknown>;
-    /** 生成领域 Context Extension；结果会浅冻结。 */
-    contextExtension?: (input: ContextExtensionInput) => Readonly<Record<string, unknown>>;
-    /** 校验产品清单中的宿主扩展字段。 */
-    manifestValidator?: (manifest: PluginManifest) => void;
-    /** 计算权限批准与会话交集。 */
-    permissionPolicy?: (input: PermissionPolicyInput) => PermissionPolicyResult;
-    /** 启停意图持久化端口。 */
-    configStore?: PluginConfigStore;
-    /** 兼容测试的内存启停意图。 */
-    initialPluginConfig?: Readonly<Record<string, boolean>>;
-    /** 多页面唯一启停控制面。 */
-    pluginIntentCoordinator?: PluginIntentCoordinator;
-    /** 为实例绑定远程服务桥。 */
-    serviceBridgeForPlugin?: (pluginId: string, instanceId: string) => RemoteServiceBridge | undefined;
-    /** 当前执行环境的运行单元实现注册表。 */
-    runtimeUnitImplementationRegistry?: RuntimeUnitImplementationRegistry;
-    /** 当前身份/授权不允许装配时返回稳定的 blockedBy 原因。 */
-    runtimeUnitAvailability?: (input: RuntimeUnitAvailabilityInput) => string | undefined;
-    /** 为每次新建运行单元 Scope 生成当前绑定的只读属性。 */
-    runtimeUnitAttributes?: (input: RuntimeUnitAttributesInput) => Readonly<Record<string, unknown>> | undefined;
-    /** 为每次新建运行单元 Scope 选择生命周期父级；返回 undefined 使用 Host 根 Scope。 */
-    runtimeUnitParentScope?: (input: RuntimeUnitParentScopeInput) => LifecycleScope | undefined;
-    /** 贡献适配器集合。 */
-    contributionAdapters?: readonly ContributionAdapter[];
-    /** 允许每一项清理等待的时间。 */
-    lifecycleCleanupTimeoutMs?: number;
-    /** 读取远端单元真实状态。 */
-    runtimeSnapshots?: () => readonly RuntimeUnitSnapshot[];
-    /** 读取其它真实 Runtime 当前已接受的服务目录。 */
-    remoteServiceReferences?: () => readonly RemoteServiceReference[];
-    /** 允许来源 Runtime 不同且尚未出现在本地 manifest 集合中的依赖。 */
-    externalRuntimeDependencies?: boolean;
-}
-declare class StartupCapabilityError extends Error {
-    readonly details: StartupCapabilityErrorDetails[];
-    constructor(details: StartupCapabilityErrorDetails[], phase?: string);
-}
-declare class StartupPluginError extends Error {
-    readonly details: StartupPluginErrorDetails;
-    constructor(details: StartupPluginErrorDetails);
-}
-/** 创建一个只包含通用生命周期核心的 Plugin Host。 */
-declare function createPluginHost(options?: CreatePluginHostOptions): PluginHost;
-interface PluginHost {
-    /** 通用 capability 注册表。 */
-    capabilities: CapabilityRegistry;
-    /** 通用消息总线。 */
-    messageBus: MessageBus;
-    /** 通用资源定义注册表。 */
-    resourceRegistry: ResourceRegistry;
-    /** 通用资源缓存和订阅 Store。 */
-    resourceStore: ResourceStoreApi;
-    /** Host 根生命周期 Scope。 */
-    readonly rootScope: LifecycleScope;
-    /** 根 Scope 的任务调度器。 */
-    readonly taskScheduler: ScopedTaskScheduler;
-    /** 已知产品标识。 */
-    installed(): string[];
-    /** 已知产品标识；installed 的兼容别名。 */
-    manifests(): string[];
-    /** 查询产品运行状态。 */
-    state(pluginId: string): PluginState;
-    /** 查询当前实例 Scope。 */
-    scope(pluginId: string): LifecycleScope | undefined;
-    /** 让宿主重新读取远端运行单元快照。 */
-    refreshRuntimeUnitSnapshots(): void;
-    /** 让领域适配器在 Scope 身份变化后立即完成一次协调。 */
-    reconcile(): Promise<void>;
-    /** 获取依赖图。 */
-    graph(): PluginGraph;
-    /** Host 版本。 */
-    version(): number;
-    /** 订阅 Host 变化。 */
-    subscribe(listener: HostListener): () => void;
-    /** 获取清单。 */
-    getManifest(pluginId: string): PluginManifest | undefined;
-    /** 查询反向依赖。 */
-    reverseDeps(pluginId: string): PluginReverseDep[];
-    /** 校验一组清单。 */
-    validateManifestSet(manifests: readonly PluginManifest[]): void;
-    /** 注入一个不归属插件实例的内建 capability。 */
-    provide<T>(key: string, value: T): void;
-    /** 注册并按当前意图尝试启动。 */
-    register(manifest: PluginManifest): Promise<void>;
-    /** 批量注册并按依赖顺序协调。 */
-    registerAll(manifests: readonly PluginManifest[]): Promise<void>;
-    /** 启动一个插件。 */
-    enable(pluginId: string): Promise<void>;
-    /** 清除失败状态并重试。 */
-    retry(pluginId: string): Promise<void>;
-    /** 提交绝对启停意图。 */
-    submitIntent(pluginId: string, desiredEnabled: boolean): Promise<PluginIntentSubmissionResult>;
-    /** 停止一个插件及其反向依赖者。 */
-    disable(pluginId: string): Promise<{
-        ok: true;
-    } | {
-        ok: false;
-        reason: string;
-    }>;
-    /** 暂停当前实例但保留启用意图；供宿主身份世代切换时撤权重建。 */
-    suspend(pluginId: string, reason?: string): Promise<void>;
-    /** 从 Host 删除一个插件。 */
-    unregister(pluginId: string): Promise<void>;
-    /** 停止所有实例并释放根 Scope。 */
-    dispose(reason?: string): Promise<LifecycleDisposeResult>;
-    /** 启动前检查 capability。 */
-    assertCapabilities(capabilities: readonly string[], options?: {
-        phase?: string;
-    }): void;
-}
-
-export { type MessageHandler as $, type ContextExtensionInput as A, type ContributionAdapter as B, type CreatePluginHostOptions as C, type ContributionAdapterInput as D, type ContributionHandle as E, type DispatchOptions as F, type EventHandler as G, type HandlerOptions as H, type HostListener as I, LIFECYCLE_ERROR_TEXT as J, type LifecycleCleanup as K, type LifecycleDisposeResult as L, type MessageBus as M, type LifecycleCleanupIssue as N, type LifecycleCleanupPhase as O, type PluginManifest as P, type LifecycleDisposeOptions as Q, type RuntimeKind as R, type ScopedTaskScheduler as S, type LifecycleResourceHandle as T, type UpgradeGate as U, type LifecycleResourceSnapshot as V, type LifecycleScopeKind as W, LifecycleScopeRevokedError as X, type LifecycleScopeState as Y, type Message as Z, type MessageBusSnapshot as _, type PluginGraph as a, type UpgradeMode as a$, type MessageMode as a0, type OwnedResourceDefinition as a1, PermissionDeniedError as a2, type PermissionLeaseBinding as a3, type PermissionLeaseBindingExpectation as a4, PermissionLeaseRevokedError as a5, type PermissionPolicyInput as a6, type PermissionPolicyResult as a7, type PluginAttributes as a8, type PluginConfigStore as a9, type ResourceDefinition as aA, type ResourceKey as aB, type ResourceRegistry as aC, type ResourceSnapshot as aD, type ResourceStatus as aE, type ResourceStoreApi as aF, type RuntimeUnitAttributesInput as aG, type RuntimeUnitAvailabilityInput as aH, type RuntimeUnitDependency as aI, type RuntimeUnitDependencyInput as aJ, type RuntimeUnitDescriptor as aK, type RuntimeUnitImplementationRegistry as aL, type RuntimeUnitParentScopeInput as aM, type RuntimeUnitSnapshot as aN, SCOPED_TASK_SCHEDULER_CAPABILITY as aO, type ScopedTaskDefinition as aP, type ScopedTaskSnapshot as aQ, StartupCapabilityError as aR, type StartupCapabilityErrorDetails as aS, StartupPluginError as aT, type StartupPluginErrorDetails as aU, type UpgradeDrainResult as aV, UpgradeGateRejectedError as aW, type UpgradeGateState as aX, type UpgradeHandshake as aY, type UpgradeHandshakeResult as aZ, type UpgradeIoLease as a_, type PluginContext as aa, type PluginIntentCommand as ab, type PluginIntentCommandResult as ac, type PluginIntentController as ad, type PluginIntentCoordinator as ae, type PluginIntentSnapshot as af, type PluginIntentSubmissionResult as ag, type PluginLifecycleState as ah, type PluginStartupMode as ai, type PluginState as aj, type PluginTeardown as ak, type PluginUnitGraph as al, type PublishOptions as am, RESOURCE_OWNER as an, RESOURCE_REGISTRY_CAPABILITY as ao, RUNTIME_MESSAGE_BUS as ap, type RemoteServiceBridgeState as aq, type RemoteServiceCallContext as ar, type RemoteServiceLookup as as, type RemoteServiceMessageKind as at, type RemoteServicePortControlMessage as au, type RemoteServiceSnapshotResult as av, type RemoteServiceTransport as aw, RemoteServiceUnavailableError as ax, type RequestOptions as ay, type ResourceContext as az, type PluginDependency as b, type UpgradeSession as b0, createCapabilityRegistry as b1, createInMemoryPluginConfigStore as b2, createPluginHost as b3, createRemoteServiceMessageCodec as b4, createResourceStore as b5, defineRuntimeUnitDependencies as b6, defineRuntimeUnitProvidedContracts as b7, lifecycleErrorText as b8, runtimeCapabilityContractVersion as b9, type PluginReverseDep as c, type PluginContribution as d, type PluginConfig as e, type PluginContextExtension as f, type PluginManifestInput as g, type RuntimeUnitDescriptorInput as h, type PluginSetup as i, type RuntimeDependency as j, type PluginPermission as k, type PluginMeta as l, type PluginStateKind as m, type RemoteServiceReference as n, type RemoteServiceMessageCodec as o, type PluginUnitState as p, type RemoteServiceBridge as q, type RemoteServiceProxy as r, type PluginHost as s, type LifecycleScope as t, type LifecycleScopeIdentity as u, type PermissionLease as v, type CreateUpgradeGateOptions as w, type RemoteServiceHandshake as x, type RemoteServiceSnapshot as y, type CapabilityRegistry as z };