@floegence/redevplugin-ui 0.7.27 → 1.0.0

package/dist/platform.d.ts

@@ -1,6 +1,6 @@
 import { type FetchLike } from "./http.js";
 import type { components } from "./openapi.gen.js";
-import { type PluginConfirmationHandler, type PluginSurfaceHost, type PluginSurfaceContext, type PluginSurfaceOpeningProgress, type PluginSurfaceInteractionEvent, type PluginSurfaceReloadLimiter, type PluginSurfaceSlot, type PluginTrustedMethodResult, type ReDevPluginSurfaceTransport } from "./surface.js";
+import { type PluginConfirmationHandler, type PluginSurfaceHost, type PluginSurfaceContext, type PluginSurfaceOpeningProgress, type PluginSurfaceInteractionEvent, type PluginSurfaceReloadLimiter, type PluginSurfaceSlot, type PluginMethodResult, type ReDevPluginSurfaceTransport } from "./surface.js";
 import { type PluginSurfaceScope } from "./surface-scope.js";
 export type PluginPlatformClientOptions = {
     fetch?: FetchLike;
@@ -30,19 +30,12 @@ export type PluginEnableState = PluginRecord["enable_state"];
 export type PluginPackageHashSet = PlatformSchemas["PackageHashSet"];
 export type PluginReleaseRef = PlatformSchemas["PluginReleaseRef"];
 export type PluginInstallReleaseRefRequest = PlatformSchemas["InstallReleaseRefRequest"];
-export type PluginStartReleaseInstallOperationRequest = PlatformSchemas["StartReleaseInstallOperationRequest"];
-export type PluginReleaseInstallOperation = PlatformSchemas["ReleaseInstallOperation"];
-export type PluginReleaseInstallOperationList = PlatformSchemas["ReleaseInstallOperationList"];
-export type PluginWatchReleaseInstallOperationOptions = PluginRequestOptions & {
-    onUpdate?: (operation: PluginReleaseInstallOperation) => void;
-};
 export type PluginUpdateReleaseRefRequest = PlatformSchemas["UpdateReleaseRefRequest"];
 export type PluginInspectExternalPackageRequest = PlatformSchemas["InspectExternalPackageRequest"];
 export type PluginUploadedExternalPackageIntent = PlatformSchemas["ExternalPackageIntentRequest"];
 export type PluginExternalPackageInspection = PlatformSchemas["ExternalPackageInspection"];
-export type PluginCommitExternalPackageRequest = PlatformSchemas["CommitExternalPackageRequest"];
-export type PluginQueryExternalPackageCommitRequest = PlatformSchemas["QueryExternalPackageCommitRequest"];
-export type PluginExternalPackageCommitResult = PlatformSchemas["ExternalPackageCommitResult"];
+export type PluginInstallInspectedPackageRequest = PlatformSchemas["InstallInspectedPackageRequest"];
+export type PluginInstalledExternalPackage = PlatformSchemas["InstalledExternalPackage"];
 export type PluginDowngradeRequest = PlatformSchemas["DowngradeRequest"];
 export type PluginEnableRequest = PlatformSchemas["EnableRequest"];
 export type PluginDisableRequest = PlatformSchemas["DisableRequest"];
@@ -71,7 +64,8 @@ export type PluginRuntimeLimits = Readonly<PlatformSchemas["RuntimeLimits"]>;
 export type PluginRuntimeHealth = PlatformSchemas["PluginRuntimeHealth"];
 export type PluginRuntimeShardHealth = PlatformSchemas["PluginRuntimeShardHealth"];
 export type PluginRuntimeStopResult = PlatformSchemas["PluginRuntimeStopResult"];
-export type PluginRuntimeRefreshResult = PlatformSchemas["PluginRuntimeRefreshResult"];
+export type PluginRecoverySnapshot = PlatformSchemas["RecoverySnapshot"];
+export type PluginRecoveryResult = PlatformSchemas["PluginRecoveryResult"];
 export type PluginSettingsField = PlatformSchemas["PluginSettingsField"];
 export type PluginSettingsSchema = PlatformSchemas["PluginSettingsSchema"];
 export type PluginSettingsSnapshot = PlatformSchemas["PluginSettingsSnapshot"];
@@ -85,10 +79,13 @@ export type PluginSettingsPatchRequest = PluginSettingsPatchBase & ({
     remove: [string, ...string[]];
 });
 export type PluginCapabilityContractPin = PlatformSchemas["HostCapabilityPinV1"];
-export type PluginPublicOperationBinding = PlatformSchemas["PublicOperationBinding"];
-export type PluginOperationRecord = PlatformSchemas["OperationRecord"];
-export type PluginOperationList = PlatformSchemas["PluginOperationList"];
-export type PluginOperationListOptions = PlatformSchemas["ListOperationsQueryRequest"];
+export type PluginExecution = PlatformSchemas["Execution"];
+export type PluginEvent = PlatformSchemas["Event"];
+export type PluginStartReleaseInstallExecutionRequest = PlatformSchemas["StartReleaseInstallExecutionRequest"];
+export type PluginExecutionList = PlatformSchemas["ExecutionList"];
+export type PluginExecutionEventList = PlatformSchemas["ExecutionEventList"];
+export type PluginExecutionListOptions = PlatformSchemas["ListExecutionsRequest"];
+export type PluginExecutionEventListOptions = PlatformSchemas["ListExecutionEventsRequest"];
 export type PluginIntentRecord = PlatformSchemas["PluginIntentRecord"];
 export type PluginIntentList = PlatformSchemas["PluginIntentList"];
 export type PluginIntentListOptions = PlatformSchemas["ListIntentsQueryRequest"];
@@ -135,15 +132,9 @@ export declare class PluginPlatformClient {
     features(options?: PluginRequestOptions): Promise<PluginFeatures>;
     getCompatibility(options?: PluginRequestOptions): Promise<PluginCompatibilityManifest>;
     installReleaseRef(request: PluginInstallReleaseRefRequest, options?: PluginRequestOptions): Promise<PluginRecord>;
-    startReleaseInstallOperation(request: PluginStartReleaseInstallOperationRequest, options?: PluginRequestOptions): Promise<PluginReleaseInstallOperation>;
-    listReleaseInstallOperations(options?: PluginRequestOptions): Promise<PluginReleaseInstallOperationList>;
-    getReleaseInstallOperation(operationId: string, options?: PluginRequestOptions): Promise<PluginReleaseInstallOperation>;
-    getReleaseInstallOperationByRequest(requestId: string, options?: PluginRequestOptions): Promise<PluginReleaseInstallOperation>;
-    watchReleaseInstallOperation(operationId: string, options?: PluginWatchReleaseInstallOperationOptions): Promise<PluginReleaseInstallOperation>;
     inspectExternalPackage(request: PluginInspectExternalPackageRequest, options?: PluginRequestOptions): Promise<PluginExternalPackageInspection>;
     inspectUploadedExternalPackage(intent: PluginUploadedExternalPackageIntent, packageBlob: Blob, options?: PluginRequestOptions): Promise<PluginExternalPackageInspection>;
-    commitExternalPackage(request: PluginCommitExternalPackageRequest, options?: PluginRequestOptions): Promise<PluginExternalPackageCommitResult>;
-    queryExternalPackageCommit(request: PluginQueryExternalPackageCommitRequest, options?: PluginRequestOptions): Promise<PluginExternalPackageCommitResult>;
+    installInspectedPackage(request: PluginInstallInspectedPackageRequest, options?: PluginRequestOptions): Promise<PluginInstalledExternalPackage>;
     updateReleaseRef(request: PluginUpdateReleaseRefRequest, options?: PluginRequestOptions): Promise<PluginRecord>;
     downgradePlugin(request: PluginDowngradeRequest, options?: PluginRequestOptions): Promise<PluginRecord>;
     enablePlugin(request: PluginEnableRequest, options?: PluginRequestOptions): Promise<PluginRecord>;
@@ -153,16 +144,19 @@ export declare class PluginPlatformClient {
     revokeSessionScope(options?: PluginRequestOptions): Promise<PluginSessionScopeRevokeResult>;
     startRuntime(request: PluginRuntimeStartRequest, options?: PluginRequestOptions): Promise<PluginRuntimeHealth>;
     stopRuntime(options?: PluginRequestOptions): Promise<PluginRuntimeStopResult>;
-    refreshEnabledRuntimeState(options?: PluginRequestOptions): Promise<PluginRuntimeRefreshResult>;
+    recoverEnabled(options?: PluginRequestOptions): Promise<PluginRecoverySnapshot>;
+    retryRecovery(pluginInstanceId: string, options?: PluginRequestOptions): Promise<PluginRecoveryResult>;
     runtimeHealth(options?: PluginRequestOptions): Promise<PluginRuntimeHealth>;
     getSettingsSchema(pluginInstanceId: string, scope: PluginResourceScopeKind, options?: PluginRequestOptions): Promise<PluginSettingsSchema>;
     getSettings(pluginInstanceId: string, scope: PluginResourceScopeKind, options?: PluginRequestOptions): Promise<PluginSettingsSnapshot>;
     patchSettings(pluginInstanceId: string, request: PluginSettingsPatchRequest, options?: PluginRequestOptions): Promise<PluginSettingsSnapshot>;
-    listOperations(options?: PluginOperationListOptions, requestOptions?: PluginRequestOptions): Promise<PluginOperationList>;
-    getOperation(operationId: string, options?: PluginRequestOptions): Promise<PluginOperationRecord>;
-    cancelOperation(operationId: string, reason?: string, options?: PluginRequestOptions): Promise<PluginOperationRecord>;
+    listExecutions(options?: PluginExecutionListOptions, requestOptions?: PluginRequestOptions): Promise<PluginExecutionList>;
+    startReleaseInstallExecution(request: PluginStartReleaseInstallExecutionRequest, options?: PluginRequestOptions): Promise<PluginExecution>;
+    getExecution(executionID: string, options?: PluginRequestOptions): Promise<PluginExecution>;
+    cancelExecution(executionID: string, reason?: string, options?: PluginRequestOptions): Promise<PluginExecution>;
+    listExecutionEvents(executionID: string, request: PluginExecutionEventListOptions, options?: PluginRequestOptions): Promise<PluginExecutionEventList>;
     listIntents(options?: PluginIntentListOptions, requestOptions?: PluginRequestOptions): Promise<PluginIntentList>;
-    invokeIntent<T = unknown>(request: PluginIntentInvokeRequest, options?: PluginRequestOptions): Promise<PluginTrustedMethodResult<T>>;
+    invokeIntent<T = unknown>(request: PluginIntentInvokeRequest, options?: PluginRequestOptions): Promise<PluginMethodResult<T>>;
     exportData(request: PluginDataExportRequest, options?: PluginRequestOptions): Promise<PluginDataExportResult>;
     deleteDataExport(request: PluginDataExportDeleteRequest, options?: PluginRequestOptions): Promise<PluginDataExportDeleteResult>;
     importData(request: PluginDataImportRequest, options?: PluginRequestOptions): Promise<PluginRecord>;

package/dist/platform.js

@@ -41,36 +41,6 @@ export class PluginPlatformClient {
     installReleaseRef(request, options = {}) {
         return this.#requestMutation("POST", "/_redevplugin/api/plugins/install-release-ref", request, options);
     }
-    async startReleaseInstallOperation(request, options = {}) {
-        try {
-            return await this.#requestMutation("POST", "/_redevplugin/api/plugins/release-install-operations", request, options);
-        }
-        catch (error) {
-            if (!(error instanceof PluginTransportError) || error.mutationOutcome !== "unknown" || options.signal?.aborted) {
-                throw error;
-            }
-            return this.getReleaseInstallOperationByRequest(request.request_id, options);
-        }
-    }
-    listReleaseInstallOperations(options = {}) {
-        return this.#requestGet("/_redevplugin/api/plugins/release-install-operations", options);
-    }
-    getReleaseInstallOperation(operationId, options = {}) {
-        return this.#requestGet(`/_redevplugin/api/plugins/release-install-operations/${encodeURIComponent(operationId)}`, options);
-    }
-    getReleaseInstallOperationByRequest(requestId, options = {}) {
-        return this.#requestGet(`/_redevplugin/api/plugins/release-install-operations/by-request/${encodeURIComponent(requestId)}`, options);
-    }
-    async watchReleaseInstallOperation(operationId, options = {}) {
-        for (;;) {
-            const operation = await this.getReleaseInstallOperation(operationId, options);
-            options.onUpdate?.(operation);
-            if (operation.status === "succeeded" || operation.status === "failed") {
-                return operation;
-            }
-            await waitForReleaseInstallPoll(operation.retry_after_ms, options.signal);
-        }
-    }
     async inspectExternalPackage(request, options = {}) {
         const inspection = await this.#requestMutation("POST", "/_redevplugin/api/plugins/external-packages/inspect", request, options);
         this.#externalInspectionTargets.set(inspection.inspection_id, inspection.intent.plugin_instance_id ?? "");
@@ -91,34 +61,18 @@ export class PluginPlatformClient {
         this.#externalInspectionTargets.set(inspection.inspection_id, update ? canonicalIntent.plugin_instance_id : "");
         return inspection;
     }
-    async commitExternalPackage(request, options = {}) {
+    async installInspectedPackage(request, options = {}) {
         const target = this.#externalInspectionTargets.get(request.inspection_id);
         let result;
         try {
-            result = await this.#requestMutation("POST", "/_redevplugin/api/plugins/external-packages/commit", request, options);
+            result = await this.#requestMutation("POST", "/_redevplugin/api/plugins/external-packages/install", request, options);
         }
         catch (error) {
-            await this.#handleMutationFailure(error, target || undefined, "External package commit and local surface teardown failed");
+            await this.#handleMutationFailure(error, target || undefined, "External package install and local surface teardown failed");
             throw error;
         }
-        if (result.status === "committed") {
-            await disposePluginSurfaceScope(this.#surfaceScope, result.plugin.plugin_instance_id);
-            this.#externalInspectionTargets.delete(request.inspection_id);
-        }
-        else if (result.status === "failed") {
-            this.#externalInspectionTargets.delete(request.inspection_id);
-        }
-        return result;
-    }
-    async queryExternalPackageCommit(request, options = {}) {
-        const result = await this.#requestQuery("/_redevplugin/api/plugins/external-packages/commit/query", request, options);
-        if (result.status === "committed") {
-            await disposePluginSurfaceScope(this.#surfaceScope, result.plugin.plugin_instance_id);
-            this.#externalInspectionTargets.delete(request.inspection_id);
-        }
-        else if (result.status === "failed") {
-            this.#externalInspectionTargets.delete(request.inspection_id);
-        }
+        await disposePluginSurfaceScope(this.#surfaceScope, result.plugin.plugin_instance_id);
+        this.#externalInspectionTargets.delete(request.inspection_id);
         return result;
     }
     updateReleaseRef(request, options = {}) {
@@ -193,8 +147,11 @@ export class PluginPlatformClient {
     stopRuntime(options = {}) {
         return this.#requestMutation("POST", "/_redevplugin/api/plugins/runtime/stop", {}, options);
     }
-    refreshEnabledRuntimeState(options = {}) {
-        return this.#requestMutation("POST", "/_redevplugin/api/plugins/runtime/refresh-enabled", {}, options);
+    recoverEnabled(options = {}) {
+        return this.#requestMutation("POST", "/_redevplugin/api/plugins/runtime/recover-enabled", {}, options);
+    }
+    retryRecovery(pluginInstanceId, options = {}) {
+        return this.#requestMutation("POST", "/_redevplugin/api/plugins/runtime/recover/retry", { plugin_instance_id: pluginInstanceId }, options);
     }
     runtimeHealth(options = {}) { return this.#requestQuery("/_redevplugin/api/plugins/runtime/health/query", {}, options); }
     getSettingsSchema(pluginInstanceId, scope, options = {}) {
@@ -206,14 +163,20 @@ export class PluginPlatformClient {
     patchSettings(pluginInstanceId, request, options = {}) {
         return this.#mutatePluginAt("PATCH", `/_redevplugin/api/plugins/${encodeURIComponent(pluginInstanceId)}/settings`, pluginInstanceId, request, options);
     }
-    listOperations(options = {}, requestOptions = {}) {
-        return this.#requestQuery("/_redevplugin/api/plugins/operations/query", options, requestOptions);
+    listExecutions(options = {}, requestOptions = {}) {
+        return this.#requestQuery("/_redevplugin/api/plugins/executions/query", options, requestOptions);
     }
-    getOperation(operationId, options = {}) {
-        return this.#requestQuery(`/_redevplugin/api/plugins/operations/${encodeURIComponent(operationId)}/query`, {}, options);
+    startReleaseInstallExecution(request, options = {}) {
+        return this.#requestMutation("POST", "/_redevplugin/api/plugins/executions/release-installs", request, options);
     }
-    cancelOperation(operationId, reason, options = {}) {
-        return this.#requestMutation("POST", `/_redevplugin/api/plugins/operations/${encodeURIComponent(operationId)}/cancel`, reason ? { reason } : {}, options);
+    getExecution(executionID, options = {}) {
+        return this.#requestQuery(`/_redevplugin/api/plugins/executions/${encodeURIComponent(executionID)}/query`, {}, options);
+    }
+    cancelExecution(executionID, reason, options = {}) {
+        return this.#requestMutation("POST", `/_redevplugin/api/plugins/executions/${encodeURIComponent(executionID)}/cancel`, reason ? { reason } : {}, options);
+    }
+    listExecutionEvents(executionID, request, options = {}) {
+        return this.#requestQuery(`/_redevplugin/api/plugins/executions/${encodeURIComponent(executionID)}/events/query`, request, options);
     }
     listIntents(options = {}, requestOptions = {}) {
         return this.#requestQuery("/_redevplugin/api/plugins/intents/query", options, requestOptions);
@@ -358,16 +321,6 @@ export class PluginPlatformClient {
         }, operation);
         return readPlatformResponse(response);
     }
-    async #requestGet(path, options) {
-        const operation = `GET ${path}`;
-        const response = await dispatchQueryRequest(this.#fetch, this.#apiBaseURL + path, {
-            method: "GET",
-            headers: { "Accept": "application/json" },
-            credentials: "same-origin",
-            signal: options.signal,
-        }, operation);
-        return readPlatformResponse(response);
-    }
     async #requestMutation(method, path, body, options) {
         const operation = `${method} ${path}`;
         assertMutationDispatchable(options.signal, operation);
@@ -408,25 +361,6 @@ export class PluginPlatformClient {
         return readMutationPlatformResponse(response);
     }
 }
-function waitForReleaseInstallPoll(retryAfterMs, signal) {
-    const delayMs = Number.isFinite(retryAfterMs)
-        ? Math.min(10_000, Math.max(250, Math.trunc(retryAfterMs)))
-        : 500;
-    if (signal?.aborted) {
-        return Promise.reject(new PluginTransportError("Plugin release install observation was aborted", signal.reason));
-    }
-    return new Promise((resolve, reject) => {
-        const timeout = setTimeout(() => {
-            signal?.removeEventListener("abort", onAbort);
-            resolve();
-        }, delayMs);
-        const onAbort = () => {
-            clearTimeout(timeout);
-            reject(new PluginTransportError("Plugin release install observation was aborted", signal?.reason));
-        };
-        signal?.addEventListener("abort", onAbort, { once: true });
-    });
-}
 function canonicalUploadedExternalPackageIntent(intent) {
     if (typeof intent !== "object" || intent === null || Array.isArray(intent)) {
         throw new TypeError("uploaded external package intent must be a closed install or update object");
@@ -469,12 +403,9 @@ const sessionScopeCountKeys = [
     "asset_sessions",
     "plugin_gateway_tokens",
     "confirmation_tokens",
-    "stream_tickets",
     "handle_grants",
     "confirmations",
-    "operations",
-    "streams",
-    "runtime_executions",
+    "executions",
     "active_network_requests",
     "sockets",
     "network_streams",

package/dist/plugin.d.ts

@@ -1,5 +1,5 @@
 export { PluginBridgeClient } from "./surface.js";
 export { PluginBridgeError } from "./errors.js";
 export { callCapabilityOperation, callCapabilityStream, callCapabilitySync, isCapabilityBusinessError, } from "./capability-client.js";
-export type { BridgeLifecycleEvent, MessagePortLike, PluginBridgeClientOptions, PluginBridgeRequestOptions, PluginCanvasAccessibilityState, PluginCanvasInputEvent, PluginCanvasKeyEvent, PluginCanvasPointerEvent, PluginCanvasResizeEvent, PluginCanvasSurface, PluginJSONObject, PluginJSONValue, PluginMethodResult, PluginExecutionFailureCode, PluginOperationSnapshot, PluginOperationProgress, PluginSurfaceContext, PluginStreamTerminalStatus, PluginUIActionEvent, PluginUIAttributeValue, PluginUIElementVNode, PluginUIPatchOperation, PluginUIVNode, } from "./surface.js";
-export type { PluginCapabilitySchema, PluginCapabilityEffect, PluginCapabilityOperationContract, PluginCapabilityStreamContract, PluginCapabilitySyncContract, PluginCapabilityStreamEvent, PluginCapabilityStreamReadResult, PluginOperation, PluginOperationTerminalStatus, PluginOperationWaitOptions, PluginStream, } from "./capability-client.js";
+export type { BridgeLifecycleEvent, MessagePortLike, PluginBridgeClientOptions, PluginBridgeRequestOptions, PluginCanvasAccessibilityState, PluginCanvasInputEvent, PluginCanvasKeyEvent, PluginCanvasPointerEvent, PluginCanvasResizeEvent, PluginCanvasSurface, PluginJSONObject, PluginJSONValue, PluginMethodResult, PluginExecutionFailureCode, PluginExecutionSnapshot, PluginExecutionProgress, PluginExecutionEvent, PluginExecutionEventList, PluginSurfaceContext, PluginUIActionEvent, PluginUIAttributeValue, PluginUIElementVNode, PluginUIPatchOperation, PluginUIVNode, } from "./surface.js";
+export type { PluginCapabilitySchema, PluginCapabilityEffect, PluginCapabilityOperationContract, PluginCapabilityStreamContract, PluginCapabilitySyncContract, PluginCapabilityStreamEvent, PluginCapabilityStreamReadResult, PluginExecution, PluginExecutionTerminalStatus, PluginExecutionWaitOptions, PluginStream, } from "./capability-client.js";

package/dist/surface.d.ts

@@ -1,4 +1,5 @@
 import { PluginBridgeError, type PluginMutationOutcome } from "./errors.js";
+import { pluginUIProtocolVersion } from "./contracts.gen.js";
 import { type FetchLike } from "./http.js";
 import { type PluginSurfaceScope } from "./surface-scope.js";
 import { type PluginUIVNode } from "./ui-reconciler.js";
@@ -9,7 +10,7 @@ export type PluginJSONValue = null | boolean | number | string | PluginJSONValue
 export type PluginJSONObject = {
     [key: string]: PluginJSONValue;
 };
-export type PluginUIProtocolVersion = "plugin-ui-v5" | "plugin-ui-v6" | "plugin-ui-v7";
+export type PluginUIProtocolVersion = typeof pluginUIProtocolVersion;
 export declare const pluginSurfaceContextSchemaVersion: "redevplugin.surface_context.v1";
 export type PluginSurfaceContext = Readonly<{
     schema_version: typeof pluginSurfaceContextSchemaVersion;
@@ -141,75 +142,71 @@ export type PluginCanvasPointerEvent = {
 export type PluginCanvasInputEvent = PluginCanvasFocusEvent | PluginCanvasResizeEvent | PluginCanvasKeyEvent | PluginCanvasPointerEvent;
 export type PluginMethodResult<T = unknown> = {
     data: T;
-    operation_id?: string;
-    stream_handle?: string;
+    execution_id?: string;
     confirmation_required?: boolean;
     confirmation_token_id?: string;
     request_hash?: string;
 };
-export type PluginTrustedMethodResult<T = unknown> = Omit<PluginMethodResult<T>, "stream_handle"> & {
-    stream_id?: string;
-    stream_ticket?: string;
-    stream_ticket_id?: string;
-    stream_expires_at?: string;
-};
-export type PluginStreamEvent = {
+export type PluginExecutionEvent = {
+    execution_id: string;
     sequence: number;
-    kind: string;
-    data?: string;
-    error?: string;
-    at: string;
-};
-export type PluginStreamTerminalStatus = "closed" | "canceled" | "failed" | "orphaned_after_disable" | "orphaned_after_uninstall";
-export type PluginStreamReadResult = {
-    events: PluginStreamEvent[];
-    done: false;
-    retry_after_ms: number;
-} | {
-    events: PluginStreamEvent[];
-    done: true;
-    terminal_status: PluginStreamTerminalStatus;
-    retry_after_ms: 0;
+    kind: "progress" | "data" | "diagnostic" | "terminal";
+    payload?: PluginJSONObject;
+    error?: {
+        code: string;
+        message: string;
+    };
+};
+export type PluginExecutionEventList = {
+    execution_id: string;
+    events: PluginExecutionEvent[];
+    cursor: number;
 };
 export type PluginExecutionFailureCode = "adapter_failed" | "contract_invalid" | "platform_failed" | "quota_exceeded" | "runtime_failed";
-export type PluginOperationProgress = {
+export type PluginExecutionProgress = {
     revision: number;
     phase: string;
     completed_units?: number;
     total_units?: number;
     unit?: string;
 };
-type PluginOperationSnapshotActive = {
-    operation_id: string;
+type PluginExecutionSnapshotActive = {
+    execution_id: string;
+    plugin_instance_id: string;
+    kind: "operation" | "subscription";
     status: "running" | "cancel_requested";
+    cursor: number;
     cancelable: boolean;
     created_at: string;
     updated_at: string;
-    retry_after_ms: number;
-    progress?: PluginOperationProgress;
-};
-type PluginOperationSnapshotTerminal = {
-    operation_id: string;
-    status: "completed" | "canceled" | "orphaned_after_disable" | "orphaned_after_uninstall";
+    progress?: PluginExecutionProgress;
+};
+type PluginExecutionSnapshotTerminal = {
+    execution_id: string;
+    plugin_instance_id: string;
+    kind: "operation" | "subscription";
+    status: "completed" | "canceled" | "orphaned";
+    cursor: number;
     cancelable: boolean;
     created_at: string;
     updated_at: string;
-    retry_after_ms: number;
     terminal_at: string;
-    progress?: PluginOperationProgress;
+    progress?: PluginExecutionProgress;
 };
-type PluginOperationSnapshotFailed = {
-    operation_id: string;
+type PluginExecutionSnapshotFailed = {
+    execution_id: string;
+    plugin_instance_id: string;
+    kind: "operation" | "subscription";
     status: "failed";
+    cursor: number;
     cancelable: boolean;
     created_at: string;
     updated_at: string;
-    retry_after_ms: number;
     terminal_at: string;
     failure_code: PluginExecutionFailureCode;
-    progress?: PluginOperationProgress;
+    progress?: PluginExecutionProgress;
 };
-export type PluginOperationSnapshot = PluginOperationSnapshotActive | PluginOperationSnapshotTerminal | PluginOperationSnapshotFailed;
+export type PluginExecutionSnapshot = PluginExecutionSnapshotActive | PluginExecutionSnapshotTerminal | PluginExecutionSnapshotFailed;
 export type PluginRiskSeverity = "info" | "low" | "medium" | "high" | "critical";
 export type PluginRiskEffect = "read" | "write" | "execute" | "delete" | "admin";
 export type PluginRiskFlag = {
@@ -291,9 +288,9 @@ export declare class PluginBridgeClient {
     constructor(options?: PluginBridgeClientOptions);
     ready(): Promise<void>;
     call<T = unknown>(method: string, params?: PluginJSONObject, options?: PluginBridgeRequestOptions): Promise<T>;
-    readStream(streamHandle: string, options?: PluginBridgeRequestOptions): Promise<PluginStreamReadResult>;
-    cancelOperation(operationID: string, reason?: string, options?: PluginBridgeRequestOptions): Promise<void>;
-    operationSnapshot(operationID: string, options?: PluginBridgeRequestOptions): Promise<PluginOperationSnapshot>;
+    executionEvents(executionID: string, afterCursor: number, options?: PluginBridgeRequestOptions): Promise<PluginExecutionEventList>;
+    cancelExecution(executionID: string, reason?: string, options?: PluginBridgeRequestOptions): Promise<void>;
+    executionSnapshot(executionID: string, options?: PluginBridgeRequestOptions): Promise<PluginExecutionSnapshot>;
     context(): PluginSurfaceContext | undefined;
     onContext(handler: (context: PluginSurfaceContext) => void): () => void;
     render(tree: PluginUIVNode): Promise<void>;
@@ -342,7 +339,7 @@ export declare class PluginSurfaceReloadLimiter {
     get state(): PluginSurfaceReloadState;
 }
 export declare function isPluginRiskPlan(plan: unknown): plan is PluginRiskPlan;
-export declare function decodePluginStreamText(event: PluginStreamEvent): string;
+export declare function decodePluginEventText(event: PluginExecutionEvent): string;
 export declare function trustedParentBridgeHandshakeTranscriptSHA256(handshake: TrustedParentBridgeHandshake, bridgeChannelID: string): Promise<string>;
 export type OpaqueSurfaceStyle = {
     path: string;