@floegence/redevplugin-ui 0.6.18 → 0.6.20

package/dist/contracts.gen.d.ts

@@ -1,10 +1,10 @@
-export declare const pluginUIProtocolVersion: "plugin-ui-v6";
-export declare const pluginHostProtocolVersion: "plugin-host-v8";
-export declare const bridgeSchemaVersion: "bridge-v6";
+export declare const pluginUIProtocolVersion: "plugin-ui-v7";
+export declare const pluginHostProtocolVersion: "plugin-host-v9";
+export declare const bridgeSchemaVersion: "bridge-v7";
 export declare const tokenTicketSchemaVersion: "token-ticket-v4";
 export declare const redevPluginContractVersions: {
-    readonly plugin_ui_protocol_version: "plugin-ui-v6";
-    readonly supported_plugin_ui_protocol_versions: readonly ["plugin-ui-v5", "plugin-ui-v6"];
+    readonly plugin_ui_protocol_version: "plugin-ui-v7";
+    readonly supported_plugin_ui_protocol_versions: readonly ["plugin-ui-v5", "plugin-ui-v6", "plugin-ui-v7"];
     readonly plugin_ui_transport_mappings: readonly [{
         readonly plugin_ui_protocol_version: "plugin-ui-v5";
         readonly opaque_surface_transport_schema_version: "opaque-surface-transport-v4";
@@ -13,13 +13,17 @@ export declare const redevPluginContractVersions: {
         readonly plugin_ui_protocol_version: "plugin-ui-v6";
         readonly opaque_surface_transport_schema_version: "opaque-surface-transport-v5";
         readonly bridge_schema_version: "bridge-v6";
+    }, {
+        readonly plugin_ui_protocol_version: "plugin-ui-v7";
+        readonly opaque_surface_transport_schema_version: "opaque-surface-transport-v6";
+        readonly bridge_schema_version: "bridge-v7";
     }];
-    readonly plugin_host_protocol_version: "plugin-host-v8";
+    readonly plugin_host_protocol_version: "plugin-host-v9";
     readonly rust_ipc_version: "rust-ipc-v6";
     readonly wasm_abi_version: "redevplugin-wasm-worker-v2";
-    readonly manifest_schema_version: "manifest-v6";
+    readonly manifest_schema_version: "manifest-v7";
     readonly package_signature_schema_version: "package-signature-v1";
-    readonly release_metadata_schema_version: "release-metadata-v6";
+    readonly release_metadata_schema_version: "release-metadata-v7";
     readonly release_root_delegation_schema_version: "release-root-delegation-v1";
     readonly release_source_policy_schema_version: "release-source-policy-v2";
     readonly release_source_policy_pointer_schema_version: "release-source-policy-pointer-v1";
@@ -34,17 +38,17 @@ export declare const redevPluginContractVersions: {
     readonly release_signing_ledger_receipt_schema_version: "release-signing-ledger-receipt-v1";
     readonly release_signing_ledger_evidence_schema_version: "release-signing-ledger-evidence-v1";
     readonly token_ticket_schema_version: "token-ticket-v4";
-    readonly bridge_schema_version: "bridge-v6";
+    readonly bridge_schema_version: "bridge-v7";
     readonly opaque_surface_document_schema_version: "opaque-surface-document-v3";
-    readonly opaque_surface_transport_schema_version: "opaque-surface-transport-v5";
+    readonly opaque_surface_transport_schema_version: "opaque-surface-transport-v6";
     readonly target_classifier_version: "target-classifier-v2";
     readonly network_grant_schema_version: "network-grant-v2";
     readonly resource_scope_schema_version: "resource-scope-v1";
     readonly session_scope_schema_version: "session-scope-v1";
     readonly session_scope_maintenance_schema_version: "session-scope-maintenance-v1";
-    readonly plugin_platform_openapi_version: "plugin-platform-v9";
-    readonly compatibility_manifest_version: "redevplugin.compatibility.v11";
-    readonly compatibility_schema_version: "compatibility-manifest-v11";
+    readonly plugin_platform_openapi_version: "plugin-platform-v10";
+    readonly compatibility_manifest_version: "redevplugin.compatibility.v12";
+    readonly compatibility_schema_version: "compatibility-manifest-v12";
     readonly worker_invocation_schema_version: "worker-invocation-v3";
     readonly host_capability_contract_schema_version: "host-capability-contract-v1";
     readonly host_capability_pin_schema_version: "host-capability-pin-v1";
@@ -76,9 +80,9 @@ export type ReDevPluginContractArtifact = {
 };
 export declare const redevPluginContractArtifacts: readonly [{
     readonly id: "compatibility-manifest-schema";
-    readonly path: "spec/plugin/compatibility-manifest-v11.schema.json";
-    readonly version: "compatibility-manifest-v11";
-    readonly sha256: "cec20e7bc5351641c031ebceec10559cad7c5f91a62f79158ace94df88fe1d0d";
+    readonly path: "spec/plugin/compatibility-manifest-v12.schema.json";
+    readonly version: "compatibility-manifest-v12";
+    readonly sha256: "e8b2536da3c2285c982464d9822cd501cea1418ef2276ce93d417df83eb41f47";
 }, {
     readonly id: "contract-registry-schema";
     readonly path: "spec/plugin/contract-registry-v2.schema.json";
@@ -121,14 +125,14 @@ export declare const redevPluginContractArtifacts: readonly [{
     readonly sha256: "88cbc1d63afb7e289ca4f8b7c76f702b8d20156f7722c1b71f3ab9138a240a5e";
 }, {
     readonly id: "iframe-bridge-schema";
-    readonly path: "spec/plugin/bridge-v6.schema.json";
-    readonly version: "bridge-v6";
-    readonly sha256: "e5d98528a96016950038e25b64ca760479452e06c13ab46e4ff06745a3e8aef4";
+    readonly path: "spec/plugin/bridge-v7.schema.json";
+    readonly version: "bridge-v7";
+    readonly sha256: "f4b5f04870b58e8e2363aaba98b273adccef3a3e9ac1eb1a2dbbc3fb4c71b300";
 }, {
     readonly id: "manifest-schema";
-    readonly path: "spec/plugin/manifest-v6.schema.json";
-    readonly version: "manifest-v6";
-    readonly sha256: "b196a328ca6e0581d3da69b8fbaed36ffb1ba13f8e2e46a34b1761cd644f1e74";
+    readonly path: "spec/plugin/manifest-v7.schema.json";
+    readonly version: "manifest-v7";
+    readonly sha256: "af73ffd8ccedcb149198f847b68ed6fc23e51366122915c7129473f9fde68e35";
 }, {
     readonly id: "network-grant-schema";
     readonly path: "spec/plugin/network-grant-v2.schema.json";
@@ -141,9 +145,9 @@ export declare const redevPluginContractArtifacts: readonly [{
     readonly sha256: "63419ff5b5a8890e14f97ca29aaae175b93daff61d4567c5bdff7f6e6a9e7450";
 }, {
     readonly id: "opaque-surface-transport-schema";
-    readonly path: "spec/plugin/opaque-surface-transport-v5.schema.json";
-    readonly version: "opaque-surface-transport-v5";
-    readonly sha256: "c9beca3ed207a8059f63e946fca684b6c8a16a9999fe076684dc086af97cf67a";
+    readonly path: "spec/plugin/opaque-surface-transport-v6.schema.json";
+    readonly version: "opaque-surface-transport-v6";
+    readonly sha256: "8f2af2669edc9413020c26765ee3f1986ef63a7d0803466861d8cdae3977ccff";
 }, {
     readonly id: "owner-scope-inventory-registry";
     readonly path: "spec/plugin/owner-scope-inventories-v1.json";
@@ -191,9 +195,9 @@ export declare const redevPluginContractArtifacts: readonly [{
     readonly sha256: "4d9979f5205ec047895b64c995312c588d998bb1c1448f6c9c559f1b7ab0d796";
 }, {
     readonly id: "plugin-platform-openapi";
-    readonly path: "spec/openapi/plugin-platform-v9.yaml";
-    readonly version: "plugin-platform-v9";
-    readonly sha256: "b5999503d24828d93f5ddaadc01ca31eaa630434bef5552aed9e6ec56c65c305";
+    readonly path: "spec/openapi/plugin-platform-v10.yaml";
+    readonly version: "plugin-platform-v10";
+    readonly sha256: "28a7311167249ec0cec1e0f2593e481c99d84c6ab0da673eb2f8e9832c243e49";
 }, {
     readonly id: "process-containment-schema";
     readonly path: "spec/plugin/process-containment-v1.schema.json";
@@ -206,9 +210,9 @@ export declare const redevPluginContractArtifacts: readonly [{
     readonly sha256: "0aced01a8d409953d5075a799ac273cae79e285ac82debe93ac4d8b706571ad1";
 }, {
     readonly id: "release-metadata-schema";
-    readonly path: "spec/plugin/release-metadata-v6.schema.json";
-    readonly version: "release-metadata-v6";
-    readonly sha256: "68700942b0bc21298270e90da940f29bb6a4d832282337587abddba9485b9938";
+    readonly path: "spec/plugin/release-metadata-v7.schema.json";
+    readonly version: "release-metadata-v7";
+    readonly sha256: "d9ceac9b8dd52288172bbe5d4dc2f158e2354ad4fe1f071617f6ba9309e21ebf";
 }, {
     readonly id: "release-revocation-pointer-schema";
     readonly path: "spec/plugin/release-revocation-pointer-v1.schema.json";

package/dist/contracts.gen.js

@@ -1,18 +1,18 @@
 // Code generated by scripts/generate_contract_registry.mjs; DO NOT EDIT.
-export const pluginUIProtocolVersion = "plugin-ui-v6";
-export const pluginHostProtocolVersion = "plugin-host-v8";
-export const bridgeSchemaVersion = "bridge-v6";
+export const pluginUIProtocolVersion = "plugin-ui-v7";
+export const pluginHostProtocolVersion = "plugin-host-v9";
+export const bridgeSchemaVersion = "bridge-v7";
 export const tokenTicketSchemaVersion = "token-ticket-v4";
 export const redevPluginContractVersions = {
-    "plugin_ui_protocol_version": "plugin-ui-v6",
-    "supported_plugin_ui_protocol_versions": ["plugin-ui-v5", "plugin-ui-v6"],
-    "plugin_ui_transport_mappings": [{ "plugin_ui_protocol_version": "plugin-ui-v5", "opaque_surface_transport_schema_version": "opaque-surface-transport-v4", "bridge_schema_version": "bridge-v5" }, { "plugin_ui_protocol_version": "plugin-ui-v6", "opaque_surface_transport_schema_version": "opaque-surface-transport-v5", "bridge_schema_version": "bridge-v6" }],
-    "plugin_host_protocol_version": "plugin-host-v8",
+    "plugin_ui_protocol_version": "plugin-ui-v7",
+    "supported_plugin_ui_protocol_versions": ["plugin-ui-v5", "plugin-ui-v6", "plugin-ui-v7"],
+    "plugin_ui_transport_mappings": [{ "plugin_ui_protocol_version": "plugin-ui-v5", "opaque_surface_transport_schema_version": "opaque-surface-transport-v4", "bridge_schema_version": "bridge-v5" }, { "plugin_ui_protocol_version": "plugin-ui-v6", "opaque_surface_transport_schema_version": "opaque-surface-transport-v5", "bridge_schema_version": "bridge-v6" }, { "plugin_ui_protocol_version": "plugin-ui-v7", "opaque_surface_transport_schema_version": "opaque-surface-transport-v6", "bridge_schema_version": "bridge-v7" }],
+    "plugin_host_protocol_version": "plugin-host-v9",
     "rust_ipc_version": "rust-ipc-v6",
     "wasm_abi_version": "redevplugin-wasm-worker-v2",
-    "manifest_schema_version": "manifest-v6",
+    "manifest_schema_version": "manifest-v7",
     "package_signature_schema_version": "package-signature-v1",
-    "release_metadata_schema_version": "release-metadata-v6",
+    "release_metadata_schema_version": "release-metadata-v7",
     "release_root_delegation_schema_version": "release-root-delegation-v1",
     "release_source_policy_schema_version": "release-source-policy-v2",
     "release_source_policy_pointer_schema_version": "release-source-policy-pointer-v1",
@@ -27,17 +27,17 @@ export const redevPluginContractVersions = {
     "release_signing_ledger_receipt_schema_version": "release-signing-ledger-receipt-v1",
     "release_signing_ledger_evidence_schema_version": "release-signing-ledger-evidence-v1",
     "token_ticket_schema_version": "token-ticket-v4",
-    "bridge_schema_version": "bridge-v6",
+    "bridge_schema_version": "bridge-v7",
     "opaque_surface_document_schema_version": "opaque-surface-document-v3",
-    "opaque_surface_transport_schema_version": "opaque-surface-transport-v5",
+    "opaque_surface_transport_schema_version": "opaque-surface-transport-v6",
     "target_classifier_version": "target-classifier-v2",
     "network_grant_schema_version": "network-grant-v2",
     "resource_scope_schema_version": "resource-scope-v1",
     "session_scope_schema_version": "session-scope-v1",
     "session_scope_maintenance_schema_version": "session-scope-maintenance-v1",
-    "plugin_platform_openapi_version": "plugin-platform-v9",
-    "compatibility_manifest_version": "redevplugin.compatibility.v11",
-    "compatibility_schema_version": "compatibility-manifest-v11",
+    "plugin_platform_openapi_version": "plugin-platform-v10",
+    "compatibility_manifest_version": "redevplugin.compatibility.v12",
+    "compatibility_schema_version": "compatibility-manifest-v12",
     "worker_invocation_schema_version": "worker-invocation-v3",
     "host_capability_contract_schema_version": "host-capability-contract-v1",
     "host_capability_pin_schema_version": "host-capability-pin-v1",
@@ -64,9 +64,9 @@ export const redevPluginContractVersions = {
 export const redevPluginContractArtifacts = [
     {
         id: "compatibility-manifest-schema",
-        path: "spec/plugin/compatibility-manifest-v11.schema.json",
-        version: "compatibility-manifest-v11",
-        sha256: "cec20e7bc5351641c031ebceec10559cad7c5f91a62f79158ace94df88fe1d0d",
+        path: "spec/plugin/compatibility-manifest-v12.schema.json",
+        version: "compatibility-manifest-v12",
+        sha256: "e8b2536da3c2285c982464d9822cd501cea1418ef2276ce93d417df83eb41f47",
     },
     {
         id: "contract-registry-schema",
@@ -118,15 +118,15 @@ export const redevPluginContractArtifacts = [
     },
     {
         id: "iframe-bridge-schema",
-        path: "spec/plugin/bridge-v6.schema.json",
-        version: "bridge-v6",
-        sha256: "e5d98528a96016950038e25b64ca760479452e06c13ab46e4ff06745a3e8aef4",
+        path: "spec/plugin/bridge-v7.schema.json",
+        version: "bridge-v7",
+        sha256: "f4b5f04870b58e8e2363aaba98b273adccef3a3e9ac1eb1a2dbbc3fb4c71b300",
     },
     {
         id: "manifest-schema",
-        path: "spec/plugin/manifest-v6.schema.json",
-        version: "manifest-v6",
-        sha256: "b196a328ca6e0581d3da69b8fbaed36ffb1ba13f8e2e46a34b1761cd644f1e74",
+        path: "spec/plugin/manifest-v7.schema.json",
+        version: "manifest-v7",
+        sha256: "af73ffd8ccedcb149198f847b68ed6fc23e51366122915c7129473f9fde68e35",
     },
     {
         id: "network-grant-schema",
@@ -142,9 +142,9 @@ export const redevPluginContractArtifacts = [
     },
     {
         id: "opaque-surface-transport-schema",
-        path: "spec/plugin/opaque-surface-transport-v5.schema.json",
-        version: "opaque-surface-transport-v5",
-        sha256: "c9beca3ed207a8059f63e946fca684b6c8a16a9999fe076684dc086af97cf67a",
+        path: "spec/plugin/opaque-surface-transport-v6.schema.json",
+        version: "opaque-surface-transport-v6",
+        sha256: "8f2af2669edc9413020c26765ee3f1986ef63a7d0803466861d8cdae3977ccff",
     },
     {
         id: "owner-scope-inventory-registry",
@@ -202,9 +202,9 @@ export const redevPluginContractArtifacts = [
     },
     {
         id: "plugin-platform-openapi",
-        path: "spec/openapi/plugin-platform-v9.yaml",
-        version: "plugin-platform-v9",
-        sha256: "b5999503d24828d93f5ddaadc01ca31eaa630434bef5552aed9e6ec56c65c305",
+        path: "spec/openapi/plugin-platform-v10.yaml",
+        version: "plugin-platform-v10",
+        sha256: "28a7311167249ec0cec1e0f2593e481c99d84c6ab0da673eb2f8e9832c243e49",
     },
     {
         id: "process-containment-schema",
@@ -220,9 +220,9 @@ export const redevPluginContractArtifacts = [
     },
     {
         id: "release-metadata-schema",
-        path: "spec/plugin/release-metadata-v6.schema.json",
-        version: "release-metadata-v6",
-        sha256: "68700942b0bc21298270e90da940f29bb6a4d832282337587abddba9485b9938",
+        path: "spec/plugin/release-metadata-v7.schema.json",
+        version: "release-metadata-v7",
+        sha256: "d9ceac9b8dd52288172bbe5d4dc2f158e2354ad4fe1f071617f6ba9309e21ebf",
     },
     {
         id: "release-revocation-pointer-schema",

package/dist/openapi.gen.d.ts

@@ -1376,7 +1376,7 @@ export interface components {
         PluginCatalogResult: {
             plugins: components["schemas"]["PluginRecord"][];
         };
-        PluginCompatibilityManifest: components["schemas"]["CompatibilityManifestV11"];
+        PluginCompatibilityManifest: components["schemas"]["CompatibilityManifestV12"];
         PluginOperationList: {
             operations: components["schemas"]["OperationRecord"][];
             next_cursor?: string;
@@ -2040,7 +2040,7 @@ export interface components {
             update_eligibility?: components["schemas"]["ExternalPackageUpdateEligibility"];
             security_summary?: components["schemas"]["ExternalPackageSecuritySummary"];
             capability_contracts?: components["schemas"]["CapabilityContractPin"][];
-            manifest: components["schemas"]["ManifestV5"] | components["schemas"]["ManifestV6"];
+            manifest: components["schemas"]["ManifestV5"] | components["schemas"]["ManifestV7"];
             package_entries: components["schemas"]["PackageEntry"][];
             runtime_requirement?: components["schemas"]["RuntimeRequirement"];
             /** Format: date-time */
@@ -2078,7 +2078,7 @@ export interface components {
             policy_revision: number;
             management_revision: number;
             revoke_epoch: number;
-            manifest: components["schemas"]["ManifestV5"] | components["schemas"]["ManifestV6"];
+            manifest: components["schemas"]["ManifestV5"] | components["schemas"]["ManifestV7"];
             package_entries: components["schemas"]["PackageEntry"][];
             runtime_requirement?: components["schemas"]["RuntimeRequirement"];
             version_history?: components["schemas"]["PluginVersion"][];
@@ -2204,7 +2204,7 @@ export interface components {
             plugin_instance_id: string;
             plugin_version: components["schemas"]["StrictSemVer"];
             /** @enum {string} */
-            ui_protocol_version: "plugin-ui-v5" | "plugin-ui-v6";
+            ui_protocol_version: "plugin-ui-v5" | "plugin-ui-v6" | "plugin-ui-v7";
             surface_id: string;
             surface_instance_id: string;
             active_fingerprint: string;
@@ -2251,7 +2251,7 @@ export interface components {
             management_revision: number;
             revoke_epoch: number;
             /** @enum {string} */
-            ui_protocol_version: "plugin-ui-v5" | "plugin-ui-v6";
+            ui_protocol_version: "plugin-ui-v5" | "plugin-ui-v6" | "plugin-ui-v7";
         };
         TrustedParentBridgeTokenRequest: {
             handshake: components["schemas"]["TrustedParentBridgeHandshake"];
@@ -2322,6 +2322,7 @@ export interface components {
             /** Format: date-time */
             updated_at: string;
             retry_after_ms: number;
+            progress?: components["schemas"]["OperationProgress"];
         } | {
             operation_id: string;
             /** @enum {string} */
@@ -2334,6 +2335,7 @@ export interface components {
             retry_after_ms: number;
             /** Format: date-time */
             terminal_at: string;
+            progress?: components["schemas"]["OperationProgress"];
         } | {
             operation_id: string;
             /** @constant */
@@ -2348,7 +2350,15 @@ export interface components {
             terminal_at: string;
             /** @enum {string} */
             failure_code: "adapter_failed" | "contract_invalid" | "platform_failed" | "quota_exceeded" | "runtime_failed";
+            progress?: components["schemas"]["OperationProgress"];
         };
+        OperationProgress: {
+            revision: number;
+            phase: string;
+            completed_units?: number;
+            total_units?: number;
+            unit?: string;
+        } & (unknown & unknown);
         RejectSurfaceConfirmationRequest: {
             plugin_instance_id: string;
             bridge_channel_id: string;
@@ -2560,6 +2570,7 @@ export interface components {
             orphaned_at?: string;
             /** Format: date-time */
             terminal_at?: string;
+            progress?: components["schemas"]["OperationProgress"];
         } & ({
             /** @constant */
             status: "failed";
@@ -2766,17 +2777,18 @@ export interface components {
             counts: components["schemas"]["SessionScopeV1RevokeCounts"];
         };
         SessionScopeV1PublicRevokeResult: components["schemas"]["SessionScopeV1CompleteRevokeResult"] | components["schemas"]["SessionScopeV1IncompleteRevokeResult"];
-        CompatibilityManifestV11: {
+        CompatibilityManifestV12: {
             /** @constant */
-            schema_version: "redevplugin.compatibility.v11";
+            schema_version: "redevplugin.compatibility.v12";
             package_set: components["schemas"]["PlatformPackageSetV1"];
             matrix: {
                 /** @constant */
-                plugin_ui_protocol_version: "plugin-ui-v6";
+                plugin_ui_protocol_version: "plugin-ui-v7";
                 /** @constant */
                 supported_plugin_ui_protocol_versions: [
                     "plugin-ui-v5",
-                    "plugin-ui-v6"
+                    "plugin-ui-v6",
+                    "plugin-ui-v7"
                 ];
                 /** @constant */
                 plugin_ui_transport_mappings: [
@@ -2789,20 +2801,25 @@ export interface components {
                         plugin_ui_protocol_version: "plugin-ui-v6";
                         opaque_surface_transport_schema_version: "opaque-surface-transport-v5";
                         bridge_schema_version: "bridge-v6";
+                    },
+                    {
+                        plugin_ui_protocol_version: "plugin-ui-v7";
+                        opaque_surface_transport_schema_version: "opaque-surface-transport-v6";
+                        bridge_schema_version: "bridge-v7";
                     }
                 ];
                 /** @constant */
-                plugin_host_protocol_version: "plugin-host-v8";
+                plugin_host_protocol_version: "plugin-host-v9";
                 /** @constant */
                 rust_ipc_version: "rust-ipc-v6";
                 /** @constant */
                 wasm_abi_version: "redevplugin-wasm-worker-v2";
                 /** @constant */
-                manifest_schema_version: "manifest-v6";
+                manifest_schema_version: "manifest-v7";
                 /** @constant */
                 package_signature_schema_version: "package-signature-v1";
                 /** @constant */
-                release_metadata_schema_version: "release-metadata-v6";
+                release_metadata_schema_version: "release-metadata-v7";
                 /** @constant */
                 release_root_delegation_schema_version: "release-root-delegation-v1";
                 /** @constant */
@@ -2832,11 +2849,11 @@ export interface components {
                 /** @constant */
                 token_ticket_schema_version: "token-ticket-v4";
                 /** @constant */
-                bridge_schema_version: "bridge-v6";
+                bridge_schema_version: "bridge-v7";
                 /** @constant */
                 opaque_surface_document_schema_version: "opaque-surface-document-v3";
                 /** @constant */
-                opaque_surface_transport_schema_version: "opaque-surface-transport-v5";
+                opaque_surface_transport_schema_version: "opaque-surface-transport-v6";
                 /** @constant */
                 target_classifier_version: "target-classifier-v2";
                 /** @constant */
@@ -2848,9 +2865,9 @@ export interface components {
                 /** @constant */
                 session_scope_maintenance_schema_version: "session-scope-maintenance-v1";
                 /** @constant */
-                plugin_platform_openapi_version: "plugin-platform-v9";
+                plugin_platform_openapi_version: "plugin-platform-v10";
                 /** @constant */
-                compatibility_schema_version: "compatibility-manifest-v11";
+                compatibility_schema_version: "compatibility-manifest-v12";
                 /** @constant */
                 worker_invocation_schema_version: "worker-invocation-v3";
                 /** @constant */
@@ -2897,9 +2914,9 @@ export interface components {
                 quarantine_cleanup_schema_version: "quarantine-cleanup-v1";
             };
             contract_set_sha256: string;
-            contracts: components["schemas"]["CompatibilityManifestV11Contract"][];
+            contracts: components["schemas"]["CompatibilityManifestV12Contract"][];
         };
-        CompatibilityManifestV11Contract: {
+        CompatibilityManifestV12Contract: {
             id: string;
             path: string;
             version: string;
@@ -3199,9 +3216,9 @@ export interface components {
         HostCapabilityPinV1ArtifactRef: string;
         HostCapabilityPinV1Sha256: string;
         HostCapabilityPinV1DecimalEpoch: string;
-        ManifestV6: {
+        ManifestV7: {
             /** @constant */
-            schema_version: "redevplugin.manifest.v6";
+            schema_version: "redevplugin.manifest.v7";
             publisher: {
                 publisher_id: string;
                 display_name?: string;
@@ -3209,12 +3226,12 @@ export interface components {
             plugin: {
                 plugin_id: string;
                 display_name: string;
-                version: components["schemas"]["ManifestV6Semver"];
+                version: components["schemas"]["ManifestV7Semver"];
                 /** @constant */
                 api_version: "plugin-v1";
-                min_runtime_version: components["schemas"]["ManifestV6Semver"];
+                min_runtime_version: components["schemas"]["ManifestV7Semver"];
                 /** @constant */
-                ui_protocol_version: "plugin-ui-v6";
+                ui_protocol_version: "plugin-ui-v7";
             };
             surfaces: {
                 surface_id: string;
@@ -3278,13 +3295,13 @@ export interface components {
                     uninstall_behavior?: "cancel_then_block_delete" | "force_cleanup_allowed";
                     ack_timeout_ms?: number;
                 } & (unknown & unknown);
-                request_schema?: components["schemas"]["ManifestV6MethodSchema"] & {
+                request_schema?: components["schemas"]["ManifestV7MethodSchema"] & {
                     /** @constant */
                     type: "object";
                     /** @constant */
                     additionalProperties: false;
                 };
-                response_schema?: components["schemas"]["ManifestV6MethodSchema"] & {
+                response_schema?: components["schemas"]["ManifestV7MethodSchema"] & {
                     /** @constant */
                     type: "object";
                     /** @constant */
@@ -3347,26 +3364,26 @@ export interface components {
                 payload_schema?: Record<string, never>;
             }[];
         };
-        ManifestV6Semver: string;
-        ManifestV6MethodSchema: false | (({
+        ManifestV7Semver: string;
+        ManifestV7MethodSchema: false | (({
             description?: string;
             readOnly?: boolean;
             writeOnly?: boolean;
             $ref?: string;
             type?: ("null" | "boolean" | "object" | "array" | "number" | "integer" | "string") | ("null" | "boolean" | "object" | "array" | "number" | "integer" | "string")[];
             properties?: {
-                [key: string]: components["schemas"]["ManifestV6MethodSchema"];
+                [key: string]: components["schemas"]["ManifestV7MethodSchema"];
             };
             patternProperties?: {
-                [key: string]: components["schemas"]["ManifestV6MethodSchema"];
+                [key: string]: components["schemas"]["ManifestV7MethodSchema"];
             };
             required?: string[];
             /** @constant */
             additionalProperties?: false;
-            items?: components["schemas"]["ManifestV6MethodSchema"];
-            allOf?: components["schemas"]["ManifestV6MethodSchema"][];
-            anyOf?: components["schemas"]["ManifestV6MethodSchema"][];
-            oneOf?: components["schemas"]["ManifestV6MethodSchema"][];
+            items?: components["schemas"]["ManifestV7MethodSchema"];
+            allOf?: components["schemas"]["ManifestV7MethodSchema"][];
+            anyOf?: components["schemas"]["ManifestV7MethodSchema"][];
+            oneOf?: components["schemas"]["ManifestV7MethodSchema"][];
             enum?: unknown[];
             const?: unknown;
             default?: unknown;

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 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 PluginTrustedMethodResult, type ReDevPluginSurfaceTransport } from "./surface.js";
 import { type PluginSurfaceScope } from "./surface-scope.js";
 export type PluginPlatformClientOptions = {
     fetch?: FetchLike;
@@ -52,6 +52,7 @@ export type PluginOpenSurfaceInSlotOptions = PluginRequestOptions & {
     onOpeningProgress?: (progress: PluginSurfaceOpeningProgress) => void;
     onInteraction?: (event: PluginSurfaceInteractionEvent) => void;
     onError?: (error: import("./errors.js").PluginBridgeError) => void;
+    surfaceContext?: PluginSurfaceContext;
 };
 export type PluginSessionScopeRevokeCounts = Readonly<PlatformSchemas["SessionScopeRevokeCounts"]>;
 export type PluginSessionScopeRevokeResult = Readonly<PlatformSchemas["SessionScopeRevokeCompleteResult"]>;

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, PluginStreamTerminalStatus, PluginUIActionEvent, PluginUIAttributeValue, PluginUIElementVNode, PluginUIPatchOperation, PluginUIVNode, } from "./surface.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";

package/dist/surface.d.ts

@@ -9,7 +9,24 @@ export type PluginJSONValue = null | boolean | number | string | PluginJSONValue
 export type PluginJSONObject = {
     [key: string]: PluginJSONValue;
 };
-export type PluginUIProtocolVersion = "plugin-ui-v5" | "plugin-ui-v6";
+export type PluginUIProtocolVersion = "plugin-ui-v5" | "plugin-ui-v6" | "plugin-ui-v7";
+export declare const pluginSurfaceContextSchemaVersion: "redevplugin.surface_context.v1";
+export type PluginSurfaceContext = Readonly<{
+    schema_version: typeof pluginSurfaceContextSchemaVersion;
+    revision: number;
+    appearance: Readonly<{
+        color_scheme: "light" | "dark";
+        colors: Readonly<Record<"canvas" | "surface" | "surface_elevated" | "text" | "text_muted" | "border" | "accent" | "accent_text" | "success" | "warning" | "danger" | "focus", string>>;
+    }>;
+    locale: Readonly<{
+        language_tag: string;
+        direction: "ltr" | "rtl";
+    }>;
+}>;
+export type PluginBridgeContextMessage = {
+    type: "redevplugin.bridge.context";
+    context: PluginSurfaceContext;
+};
 export type BridgeLifecycleEvent = {
     type: "ready";
 } | {
@@ -155,6 +172,13 @@ export type PluginStreamReadResult = {
     retry_after_ms: 0;
 };
 export type PluginExecutionFailureCode = "adapter_failed" | "contract_invalid" | "platform_failed" | "quota_exceeded" | "runtime_failed";
+export type PluginOperationProgress = {
+    revision: number;
+    phase: string;
+    completed_units?: number;
+    total_units?: number;
+    unit?: string;
+};
 type PluginOperationSnapshotActive = {
     operation_id: string;
     status: "running" | "cancel_requested";
@@ -162,6 +186,7 @@ type PluginOperationSnapshotActive = {
     created_at: string;
     updated_at: string;
     retry_after_ms: number;
+    progress?: PluginOperationProgress;
 };
 type PluginOperationSnapshotTerminal = {
     operation_id: string;
@@ -171,6 +196,7 @@ type PluginOperationSnapshotTerminal = {
     updated_at: string;
     retry_after_ms: number;
     terminal_at: string;
+    progress?: PluginOperationProgress;
 };
 type PluginOperationSnapshotFailed = {
     operation_id: string;
@@ -181,6 +207,7 @@ type PluginOperationSnapshotFailed = {
     retry_after_ms: number;
     terminal_at: string;
     failure_code: PluginExecutionFailureCode;
+    progress?: PluginOperationProgress;
 };
 export type PluginOperationSnapshot = PluginOperationSnapshotActive | PluginOperationSnapshotTerminal | PluginOperationSnapshotFailed;
 export type PluginRiskSeverity = "info" | "low" | "medium" | "high" | "critical";
@@ -267,6 +294,8 @@ export declare class PluginBridgeClient {
     readStream(streamHandle: string, options?: PluginBridgeRequestOptions): Promise<PluginStreamReadResult>;
     cancelOperation(operationID: string, reason?: string, options?: PluginBridgeRequestOptions): Promise<void>;
     operationSnapshot(operationID: string, options?: PluginBridgeRequestOptions): Promise<PluginOperationSnapshot>;
+    context(): PluginSurfaceContext | undefined;
+    onContext(handler: (context: PluginSurfaceContext) => void): () => void;
     render(tree: PluginUIVNode): Promise<void>;
     openCanvas(canvasId: string): Promise<PluginCanvasSurface>;
     updateCanvasAccessibility(canvasId: string, state: PluginCanvasAccessibilityState): Promise<void>;
@@ -376,6 +405,7 @@ export type PluginSurfaceHostBootstrap = {
     revokeEpoch: number;
     runtimeGenerationId: string;
 };
+export type PluginSurfaceHostContext = PluginSurfaceContext;
 export type PluginSurfaceOpeningProgress = {
     phase: "opening";
     elapsedMs: number;
@@ -395,6 +425,7 @@ export type PluginSurfaceHost = {
     sendLifecycle(event: Exclude<BridgeLifecycleEvent, {
         type: "ready" | "dispose";
     }>): void;
+    updateContext(context: PluginSurfaceContext): void;
     close(): Promise<PluginSurfaceCloseResult>;
     dispose(): Promise<void>;
 };
@@ -418,6 +449,7 @@ export type PluginSurfaceHostOptions = {
     onOpeningProgress?: (progress: PluginSurfaceOpeningProgress) => void;
     onInteraction?: (event: PluginSurfaceInteractionEvent) => void;
     onError?: (error: PluginBridgeError) => void;
+    surfaceContext?: PluginSurfaceContext;
 };
 type PluginSurfaceOpeningRequest = {
     pluginInstanceId: string;
@@ -473,3 +505,4 @@ export declare class PluginSurfaceSlot {
     close(): Promise<PluginSurfaceCloseResult | undefined>;
     dispose(): Promise<void>;
 }
+export declare function normalizePluginSurfaceContext(value: unknown): PluginSurfaceContext;

package/dist/surface.js

@@ -7,6 +7,7 @@ import { defaultPluginSurfaceScope, registerPluginSurface, } from "./surface-sco
 import { PluginUIReconcileError, reconcileValidatedPluginUITrees, validatePluginUITree, } from "./ui-reconciler.js";
 export const opaqueSurfaceDocumentSchemaVersion = "redevplugin.opaque_surface_document.v3";
 export const pluginRiskPlanSchemaVersion = "redevplugin.capability.risk_plan.v1";
+export const pluginSurfaceContextSchemaVersion = "redevplugin.surface_context.v1";
 const opaquePluginBridgeGlobalKey = "__redevpluginWorkerBridge";
 const maxPendingPluginBridgeRequests = 256;
 const maxPluginBridgeMessageBytes = opaqueSurfaceRenderLimits.max_message_bytes;
@@ -49,6 +50,8 @@ export class PluginBridgeClient {
     #actionHandlers = new Map();
     #canvasInputHandlers = new Map();
     #lifecycleHandlers = new Set();
+    #contextHandlers = new Set();
+    #context;
     #ready = false;
     #readyPromise;
     #resolveReady;
@@ -188,6 +191,26 @@ export class PluginBridgeClient {
             return snapshot;
         });
     }
+    context() {
+        this.#assertActive();
+        return this.#context;
+    }
+    onContext(handler) {
+        this.#assertActive();
+        if (typeof handler !== "function") {
+            throw new PluginBridgeError("PLUGIN_INVALID_REQUEST", "Plugin surface context subscription is invalid");
+        }
+        this.#contextHandlers.add(handler);
+        if (this.#context) {
+            try {
+                handler(this.#context);
+            }
+            catch {
+                // A plugin context observer cannot disrupt bridge delivery.
+            }
+        }
+        return () => this.#contextHandlers.delete(handler);
+    }
     render(tree) {
         this.#assertActive();
         let validated;
@@ -295,6 +318,8 @@ export class PluginBridgeClient {
         this.#actionHandlers.clear();
         this.#canvasInputHandlers.clear();
         this.#lifecycleHandlers.clear();
+        this.#contextHandlers.clear();
+        this.#context = undefined;
         for (const waiter of this.#pendingRender?.waiters ?? [])
             waiter.reject(disposedError);
         this.#pendingRender = undefined;
@@ -498,6 +523,21 @@ export class PluginBridgeClient {
                 pending.reject(new PluginBridgeError(data.error_code, data.error, undefined, data.error_details, data.mutation_outcome));
             return;
         }
+        if (isPluginBridgeContextMessage(data)) {
+            const context = normalizePluginSurfaceContext(data.context);
+            if (this.#context && context.revision <= this.#context.revision)
+                return;
+            this.#context = context;
+            for (const handler of this.#contextHandlers) {
+                try {
+                    handler(context);
+                }
+                catch {
+                    // A plugin context observer cannot disrupt bridge delivery.
+                }
+            }
+            return;
+        }
         if (isLifecycleMessage(data)) {
             if (data.event.type === "ready" && !this.#ready) {
                 this.#ready = true;
@@ -732,8 +772,8 @@ export function createOpaquePluginBootstrapHTML(options = {}) {
         throw new Error("scriptNonce must contain 8-128 URL-safe characters");
     }
     const uiProtocolVersion = options.uiProtocolVersion ?? pluginUIProtocolVersion;
-    if (uiProtocolVersion !== "plugin-ui-v5" && uiProtocolVersion !== "plugin-ui-v6") {
-        throw new Error("uiProtocolVersion must be plugin-ui-v5 or plugin-ui-v6");
+    if (uiProtocolVersion !== "plugin-ui-v5" && uiProtocolVersion !== "plugin-ui-v6" && uiProtocolVersion !== "plugin-ui-v7") {
+        throw new Error("uiProtocolVersion must be plugin-ui-v5, plugin-ui-v6, or plugin-ui-v7");
     }
     const csp = [
         "default-src 'none'",
@@ -863,6 +903,15 @@ export function createOpaquePluginBootstrapHTML(options = {}) {
   const validWorker = (value) => exactKeys(value, ["path", "sha256", "type", "content"]) && validPath(value.path) && validDigest(value.sha256) && value.type === "classic" && typeof value.content === "string" && value.content.length <= 4194304;
   const validAsset = (value) => exactKeys(value, ["binding_id", "logical_ids", "path", "sha256", "size", "content_type"]) && validOpaqueHandle(value.binding_id, "asset") && Array.isArray(value.logical_ids) && value.logical_ids.length > 0 && value.logical_ids.length <= 16 && value.logical_ids.every(validResourceIdentifier) && new Set(value.logical_ids).size === value.logical_ids.length && validPath(value.path) && validDigest(value.sha256) && Number.isSafeInteger(value.size) && value.size >= 0 && value.size <= maxLazyAssetBytes && typeof value.content_type === "string" && value.content_type.length > 0 && value.content_type.length <= 256;
   const validDocument = (value) => isRecord(value) && Object.keys(value).every((key) => ["schema_version", "entry_path", "entry_sha256", "title", "language", "direction", "body_html", "styles", "worker", "assets", "critical_bytes"].includes(key)) && value.schema_version === documentSchema && validPath(value.entry_path) && validDigest(value.entry_sha256) && (value.title === undefined || (typeof value.title === "string" && value.title.length <= 256)) && (value.language === undefined || (typeof value.language === "string" && value.language.length <= 64)) && (value.direction === undefined || ["ltr", "rtl", "auto"].includes(value.direction)) && typeof value.body_html === "string" && value.body_html.length <= 4194304 && Array.isArray(value.styles) && value.styles.every(validStyle) && validWorker(value.worker) && Array.isArray(value.assets) && value.assets.length <= maxLazyAssetCount && value.assets.every(validAsset) && new Set(value.assets.map((asset) => asset.binding_id)).size === value.assets.length && new Set(value.assets.map((asset) => asset.path)).size === value.assets.length && new Set(value.assets.flatMap((asset) => asset.logical_ids)).size === value.assets.reduce((total, asset) => total + asset.logical_ids.length, 0) && value.assets.reduce((total, asset) => total + asset.size, 0) <= maxLazyAssetBytes && Number.isSafeInteger(value.critical_bytes) && value.critical_bytes >= 0 && value.critical_bytes <= maxCriticalDocumentBytes;
+  const contextColorKeys = ["canvas", "surface", "surface_elevated", "text", "text_muted", "border", "accent", "accent_text", "success", "warning", "danger", "focus"];
+  const validContextColor = (value) => typeof value === "string" && /^#[0-9a-fA-F]{6}(?:[0-9a-fA-F]{2})?$/.test(value);
+  const validSurfaceContext = (value) => {
+    if (!isRecord(value) || !exactKeys(value, ["schema_version", "revision", "appearance", "locale"]) || value.schema_version !== "redevplugin.surface_context.v1" || !Number.isSafeInteger(value.revision) || value.revision < 1) return false;
+    if (!isRecord(value.appearance) || !exactKeys(value.appearance, ["color_scheme", "colors"]) || !["light", "dark"].includes(value.appearance.color_scheme) || !isRecord(value.appearance.colors) || !exactKeys(value.appearance.colors, contextColorKeys) || contextColorKeys.some((key) => !validContextColor(value.appearance.colors[key]))) return false;
+    if (!isRecord(value.locale) || !exactKeys(value.locale, ["language_tag", "direction"]) || typeof value.locale.language_tag !== "string" || value.locale.language_tag.length < 2 || value.locale.language_tag.length > 64 || !["ltr", "rtl"].includes(value.locale.direction)) return false;
+    try { if (typeof Intl !== "undefined" && Intl.getCanonicalLocales(value.locale.language_tag).length !== 1) return false; } catch { return false; }
+    return true;
+  };
   let accepted = false;
   let initialized = false;
   let parentPort;
@@ -872,6 +921,7 @@ export function createOpaquePluginBootstrapHTML(options = {}) {
   let frameGenerationID = "";
   let surfaceHandle = "";
   let currentDocument;
+  let currentContext;
   let workerReady = false;
   let workerHeartbeatSequence = 0;
   let workerHeartbeatPendingID;
@@ -1069,6 +1119,12 @@ export function createOpaquePluginBootstrapHTML(options = {}) {
       document.head.append(style);
     }
   };
+  const applySurfaceContext = (context) => {
+    document.documentElement.lang = context.locale.language_tag;
+    document.documentElement.dir = context.locale.direction;
+    document.documentElement.style.colorScheme = context.appearance.color_scheme;
+    for (const [key, value] of Object.entries(context.appearance.colors)) document.documentElement.style.setProperty("--redevplugin-color-" + key.replaceAll("_", "-"), value);
+  };
   const applyWorkerAttribute = (element, tag, name, attributeValue) => {
     const lower = name.toLowerCase();
     if (!validAttribute(tag, name, attributeValue)) throw new Error("plugin render attribute is not allowed");
@@ -1963,6 +2019,7 @@ export function createOpaquePluginBootstrapHTML(options = {}) {
     workerPort.addEventListener("message", onWorkerMessage);
     workerPort.start();
     worker.postMessage({ type: "redevplugin.worker.initialize", surface_handle: surfaceHandle, ui_protocol_version: protocolVersion, port_roles: ["runtime_control", "plugin_bridge"] }, [controlChannel.port2, pluginChannel.port2]);
+    if (currentContext) sendWorker({ type: "redevplugin.bridge.context", context: currentContext });
   };
   const validCall = (value) => exactKeys(value, ["type", "request"]) && value.type === "redevplugin.bridge.call" && isRecord(value.request) && Object.keys(value.request).every((key) => ["id", "method", "params"].includes(key)) && typeof value.request.id === "string" && value.request.id.length <= 128 && typeof value.request.method === "string" && /^[A-Za-z0-9._:-]{1,256}$/.test(value.request.method) && (value.request.params === undefined || isRecord(value.request.params));
   const requestID = (value, expectedKind) => {
@@ -2255,7 +2312,7 @@ export function createOpaquePluginBootstrapHTML(options = {}) {
     }
     if (exactKeys(message, ["type", "id", "operation_id"]) && message.type === "redevplugin.bridge.operation.snapshot" &&
         typeof message.id === "string" && validOpaqueHandle(message.operation_id, "operation")) {
-      if (protocolVersion !== "plugin-ui-v6") return rejectWorkerRequest(message.id, "plugin operation observation requires plugin-ui-v6");
+      if (protocolVersion !== "plugin-ui-v6" && protocolVersion !== "plugin-ui-v7") return rejectWorkerRequest(message.id, "plugin operation observation requires plugin-ui-v6 or plugin-ui-v7");
       if (!acceptWorkerRequest(message.id, "operation")) return rejectWorkerRequest(message.id, "duplicate, replayed, or excessive plugin request");
       const retryAfterMS = operationSnapshotRateLimit(message.operation_id, message.id);
       if (retryAfterMS > 0) {
@@ -2327,11 +2384,14 @@ export function createOpaquePluginBootstrapHTML(options = {}) {
   const onParentMessage = async (event) => {
     const message = event.data;
     if (!initialized) {
-      if (!exactKeys(message, ["type", "frame_generation_id", "surface_handle", "document"]) || message.type !== "redevplugin.surface.initialize" || message.frame_generation_id !== frameGenerationID || !validOpaqueHandle(message.surface_handle, "surface") || !validDocument(message.document)) return fail("invalid private initialize message");
+      const initKeys = ["type", "frame_generation_id", "surface_handle", "document"];
+      if (protocolVersion === "plugin-ui-v7") initKeys.push("context");
+      if (!isRecord(message) || !Object.keys(message).every((key) => initKeys.includes(key)) || !initKeys.slice(0, 4).every((key) => Object.prototype.hasOwnProperty.call(message, key)) || message.type !== "redevplugin.surface.initialize" || message.frame_generation_id !== frameGenerationID || !validOpaqueHandle(message.surface_handle, "surface") || !validDocument(message.document) || (protocolVersion === "plugin-ui-v7" && message.context !== undefined && !validSurfaceContext(message.context))) return fail("invalid private initialize message");
       initialized = true;
       surfaceHandle = message.surface_handle;
       currentDocument = message.document;
-      try { applyStaticDocument(currentDocument); startWorker(currentDocument); }
+      currentContext = protocolVersion === "plugin-ui-v7" ? message.context : undefined;
+      try { applyStaticDocument(currentDocument); if (currentContext) applySurfaceContext(currentContext); startWorker(currentDocument); }
       catch (error) { return fail(error); }
       requestAnimationFrame(() => requestAnimationFrame(() => {
         sendParent({ type: "redevplugin.surface.first_paint" });
@@ -2339,6 +2399,13 @@ export function createOpaquePluginBootstrapHTML(options = {}) {
       }));
       return;
     }
+    if (protocolVersion === "plugin-ui-v7" && isRecord(message) && exactKeys(message, ["type", "frame_generation_id", "surface_handle", "context"]) && message.type === "redevplugin.surface.context" && message.frame_generation_id === frameGenerationID && message.surface_handle === surfaceHandle && validSurfaceContext(message.context)) {
+      if (currentContext && message.context.revision <= currentContext.revision) return;
+      currentContext = message.context;
+      applySurfaceContext(currentContext);
+      sendWorker({ type: "redevplugin.bridge.context", context: currentContext });
+      return;
+    }
     if (message && message.type === "redevplugin.bridge.response" && typeof message.id === "string" && pendingWorkerRequests.has(message.id) && withinLimit(message)) {
 	  if (operationSnapshotRequests.has(message.id)) completeOperationSnapshotRequest(message.id);
 	  else completeWorkerRequest(message.id);
@@ -2395,6 +2462,7 @@ class PluginSurfaceHostImplementation {
     #transport;
     #createMessageChannel;
     #bridgeReady = false;
+    #rendererInitialized = false;
     #loadTimeoutMs;
     #requestTimeoutMs;
     #leaseRenewalLeadMs;
@@ -2415,6 +2483,7 @@ class PluginSurfaceHostImplementation {
     #assetSession;
     #assetSessionID;
     #document;
+    #surfaceContext;
     #assets = new Map();
     #streamCredentials = new Map();
     #pendingRequestControllers = new Map();
@@ -2466,6 +2535,7 @@ class PluginSurfaceHostImplementation {
         this.#onOpeningProgress = options.onOpeningProgress;
         this.#onInteraction = options.onInteraction;
         this.#onError = options.onError;
+        this.#surfaceContext = options.surfaceContext === undefined ? undefined : normalizePluginSurfaceContext(options.surfaceContext);
         hardenPluginSurfaceFrame(this.#iframe);
         this.#unregisterSurfaceScope = registerPluginSurface(options.surfaceScope ?? defaultPluginSurfaceScope, this.bootstrap.pluginInstanceId, () => this.#disposeLocal(), () => this.#invalidateLocal());
     }
@@ -2547,12 +2617,14 @@ class PluginSurfaceHostImplementation {
         const token = await this.#mintBridgeToken();
         this.#assertActive();
         this.#applyLease(token);
-        this.#postToRenderer({
+        this.#postToRenderer(removeUndefined({
             type: "redevplugin.surface.initialize",
             frame_generation_id: this.frameGenerationId,
             surface_handle: this.surfaceHandle,
             document: preparation.document,
-        });
+            context: this.bootstrap.uiProtocolVersion === "plugin-ui-v7" ? this.#surfaceContext : undefined,
+        }));
+        this.#rendererInitialized = true;
         await Promise.all([signals.firstPaint.promise, signals.workerReady.promise]);
         this.#assertActive();
         this.#bridgeReady = true;
@@ -2567,6 +2639,20 @@ class PluginSurfaceHostImplementation {
         this.#assertReady();
         this.#postToRenderer({ type: "redevplugin.bridge.lifecycle", event });
     }
+    updateContext(context) {
+        this.#assertActive();
+        if (this.bootstrap.uiProtocolVersion !== "plugin-ui-v7") {
+            throw new PluginBridgeError("PLUGIN_UI_PROTOCOL_UNSUPPORTED", "Plugin surface context requires plugin-ui-v7");
+        }
+        const normalized = normalizePluginSurfaceContext(context);
+        if (this.#surfaceContext && normalized.revision <= this.#surfaceContext.revision) {
+            throw new PluginBridgeError("PLUGIN_INVALID_REQUEST", "Plugin surface context revision must increase monotonically");
+        }
+        this.#surfaceContext = normalized;
+        if (this.#port && this.#rendererInitialized) {
+            this.#postToRenderer({ type: "redevplugin.surface.context", frame_generation_id: this.frameGenerationId, surface_handle: this.surfaceHandle, context: normalized });
+        }
+    }
     close() {
         if (this.#disposed) {
             const result = {
@@ -2631,6 +2717,7 @@ class PluginSurfaceHostImplementation {
         this.#unregisterSurfaceScope = undefined;
         this.#ready = false;
         this.#bridgeReady = false;
+        this.#rendererInitialized = false;
         if (this.#leaseRenewalTimer)
             clearTimeout(this.#leaseRenewalTimer);
         this.#leaseRenewalTimer = undefined;
@@ -2964,8 +3051,8 @@ class PluginSurfaceHostImplementation {
         }
     }
     async #handleOperationSnapshot(message) {
-        if (this.bootstrap.uiProtocolVersion !== "plugin-ui-v6") {
-            this.#postError(message.id, "PLUGIN_UI_PROTOCOL_UNSUPPORTED", "Plugin operation observation requires plugin-ui-v6");
+        if (this.bootstrap.uiProtocolVersion !== "plugin-ui-v6" && this.bootstrap.uiProtocolVersion !== "plugin-ui-v7") {
+            this.#postError(message.id, "PLUGIN_UI_PROTOCOL_UNSUPPORTED", "Plugin operation observation requires plugin-ui-v6 or plugin-ui-v7");
             return;
         }
         const controller = this.#registerPendingRequest(message.id);
@@ -3326,6 +3413,7 @@ class PluginSurfaceHostImplementation {
             return;
         this.#ready = false;
         this.#bridgeReady = false;
+        this.#rendererInitialized = false;
         this.#openSignals?.firstPaint.reject(error);
         this.#openSignals?.workerReady.reject(error);
         this.#reportError(error);
@@ -3960,7 +4048,7 @@ function validateHostBootstrap(bootstrap) {
             throw new PluginBridgeError("PLUGIN_CONTRACT_MISMATCH", "Plugin surface bootstrap is incomplete");
         }
     }
-    if (bootstrap.uiProtocolVersion !== "plugin-ui-v5" && bootstrap.uiProtocolVersion !== "plugin-ui-v6") {
+    if (bootstrap.uiProtocolVersion !== "plugin-ui-v5" && bootstrap.uiProtocolVersion !== "plugin-ui-v6" && bootstrap.uiProtocolVersion !== "plugin-ui-v7") {
         throw new PluginBridgeError("PLUGIN_CONTRACT_MISMATCH", "Plugin surface UI protocol is unsupported");
     }
     if (!Number.isSafeInteger(bootstrap.managementRevision) || bootstrap.managementRevision < 1 ||
@@ -4056,6 +4144,50 @@ function isOpaqueSurfaceDocument(value) {
         new Set(value.assets.map((asset) => asset.path)).size === value.assets.length &&
         Number.isSafeInteger(value.critical_bytes) && Number(value.critical_bytes) >= 0 && Number(value.critical_bytes) <= 8 * 1024 * 1024;
 }
+function isPluginBridgeContextMessage(value) {
+    return hasExactKeys(value, ["type", "context"]) && value.type === "redevplugin.bridge.context" && isPluginSurfaceContext(value.context);
+}
+function isPluginSurfaceContext(value) {
+    if (!isRecord(value) || !hasExactKeys(value, ["schema_version", "revision", "appearance", "locale"]) || value.schema_version !== pluginSurfaceContextSchemaVersion ||
+        !Number.isSafeInteger(value.revision) || Number(value.revision) < 1)
+        return false;
+    const appearance = value.appearance;
+    const locale = value.locale;
+    if (!isRecord(appearance) || !hasExactKeys(appearance, ["color_scheme", "colors"]) ||
+        (appearance.color_scheme !== "light" && appearance.color_scheme !== "dark") || !isRecord(appearance.colors))
+        return false;
+    const colors = appearance.colors;
+    if (!hasExactKeys(colors, surfaceContextColorKeys) || surfaceContextColorKeys.some((key) => !validSurfaceContextColor(colors[key])) ||
+        !isRecord(locale) || !hasExactKeys(locale, ["language_tag", "direction"]) || typeof locale.language_tag !== "string" ||
+        locale.language_tag.length < 2 || locale.language_tag.length > 64 || (locale.direction !== "ltr" && locale.direction !== "rtl"))
+        return false;
+    try {
+        return typeof Intl === "undefined" || Intl.getCanonicalLocales(locale.language_tag).length === 1;
+    }
+    catch {
+        return false;
+    }
+}
+const surfaceContextColorKeys = ["canvas", "surface", "surface_elevated", "text", "text_muted", "border", "accent", "accent_text", "success", "warning", "danger", "focus"];
+const surfaceContextColorPattern = new RegExp("^#[0-9a-fA-F]{6}(?:[0-9a-fA-F]{2})?$");
+const operationProgressPhasePattern = new RegExp("^[A-Za-z0-9._:-]{1,128}$");
+const operationProgressUnitPattern = new RegExp("^[A-Za-z0-9._:-]{1,64}$");
+function validSurfaceContextColor(value) {
+    return typeof value === "string" && surfaceContextColorPattern.test(value);
+}
+export function normalizePluginSurfaceContext(value) {
+    if (!isPluginSurfaceContext(value)) {
+        throw new PluginBridgeError("PLUGIN_INVALID_REQUEST", "Plugin surface context is invalid");
+    }
+    const languageTag = Intl.getCanonicalLocales(value.locale.language_tag)[0];
+    const colors = Object.fromEntries(surfaceContextColorKeys.map((key) => [key, String(value.appearance.colors[key]).toLowerCase()]));
+    return Object.freeze({
+        schema_version: pluginSurfaceContextSchemaVersion,
+        revision: Number(value.revision),
+        appearance: Object.freeze({ color_scheme: value.appearance.color_scheme, colors: Object.freeze(colors) }),
+        locale: Object.freeze({ language_tag: languageTag, direction: value.locale.direction }),
+    });
+}
 function isBridgeCallMessage(value) {
     return hasExactKeys(value, ["type", "request"]) &&
         value.type === "redevplugin.bridge.call" &&
@@ -4096,14 +4228,25 @@ function isPluginOperationSnapshot(value) {
         !validDateTime(value.created_at) || !validDateTime(value.updated_at))
         return false;
     const common = ["operation_id", "status", "cancelable", "created_at", "updated_at", "retry_after_ms"];
+    const withProgress = (keys) => hasAllowedKeys(value, [...keys, "progress"]) && (value.progress === undefined || validOperationProgress(value.progress));
     if (value.status === "running" || value.status === "cancel_requested")
-        return hasExactKeys(value, common);
+        return withProgress(common);
     if (["completed", "canceled", "orphaned_after_disable", "orphaned_after_uninstall"].includes(String(value.status))) {
-        return hasExactKeys(value, [...common, "terminal_at"]) && validDateTime(value.terminal_at);
+        return withProgress([...common, "terminal_at"]) && validDateTime(value.terminal_at);
     }
-    return value.status === "failed" && hasExactKeys(value, [...common, "terminal_at", "failure_code"]) &&
+    return value.status === "failed" && withProgress([...common, "terminal_at", "failure_code"]) &&
         validDateTime(value.terminal_at) && ["adapter_failed", "contract_invalid", "platform_failed", "quota_exceeded", "runtime_failed"].includes(String(value.failure_code));
 }
+function validOperationProgress(value) {
+    if (!isRecord(value) || !hasAllowedKeys(value, ["revision", "phase", "completed_units", "total_units", "unit"]) ||
+        !Number.isSafeInteger(value.revision) || Number(value.revision) < 1 || typeof value.phase !== "string" || !operationProgressPhasePattern.test(value.phase) ||
+        (value.unit !== undefined && (typeof value.unit !== "string" || !operationProgressUnitPattern.test(value.unit))) ||
+        (value.completed_units !== undefined && (!Number.isSafeInteger(value.completed_units) || Number(value.completed_units) < 0)) ||
+        (value.total_units !== undefined && (!Number.isSafeInteger(value.total_units) || Number(value.total_units) < 0)) ||
+        (value.completed_units === undefined) !== (value.total_units === undefined))
+        return false;
+    return value.completed_units === undefined || Number(value.completed_units) <= Number(value.total_units);
+}
 function validDateTime(value) {
     return typeof value === "string" && value.length > 0 && Number.isFinite(Date.parse(value));
 }

package/dist/trusted-parent.d.ts

@@ -2,6 +2,6 @@ export * from "./contracts.gen.js";
 export * from "./errors.js";
 export * from "./platform.js";
 export { PluginSurfaceScope, createPluginSurfaceScope } from "./surface-scope.js";
-export { PluginSurfaceReloadLimiter, PluginSurfaceSlot, createReDevPluginSurfaceTransport, defaultPluginSurfaceReloadMax, defaultPluginSurfaceReloadWindowMs, isPluginRiskPlan, opaqueSurfaceDocumentSchemaVersion, pluginRiskPlanSchemaVersion, trustedParentBridgeHandshakeTranscriptSHA256, } from "./surface.js";
-export type { BridgeLifecycleEvent, MessageChannelLike, MessageEventLike, MessagePortLike, OpaqueSurfaceAsset, OpaqueSurfaceDocument, OpaqueSurfaceStyle, OpaqueSurfaceWorker, PluginConfirmationDecision, PluginConfirmationHandler, PluginConfirmationIntent, PluginConfirmationPlan, PluginMethodResult, PluginRiskEffect, PluginRiskFlag, PluginRiskPlan, PluginRiskSeverity, PluginStreamEvent, PluginSurfaceHost, PluginSurfaceCloseResult, PluginSurfaceOpeningProgress, PluginSurfaceInteractionEvent, PluginSurfaceInteractionKind, PluginSurfaceQuiesceResult, PluginSurfaceRevocationReconciliation, PluginSurfacePreparationResult, PluginSurfaceReloadDecision, PluginSurfaceReloadLimiterOptions, PluginSurfaceReloadState, PluginSurfaceSlotOptions, PluginSurfaceSlotState, PluginTrustedMethodResult, ReDevPluginSurfaceTransport, ReDevPluginSurfaceTransportOptions, TrustedParentBridgeHandshake, TrustedParentBridgeTokenRequest, WindowLike, } from "./surface.js";
+export { PluginSurfaceReloadLimiter, PluginSurfaceSlot, createReDevPluginSurfaceTransport, defaultPluginSurfaceReloadMax, defaultPluginSurfaceReloadWindowMs, isPluginRiskPlan, opaqueSurfaceDocumentSchemaVersion, pluginSurfaceContextSchemaVersion, pluginRiskPlanSchemaVersion, trustedParentBridgeHandshakeTranscriptSHA256, } from "./surface.js";
+export type { BridgeLifecycleEvent, MessageChannelLike, MessageEventLike, MessagePortLike, OpaqueSurfaceAsset, OpaqueSurfaceDocument, OpaqueSurfaceStyle, OpaqueSurfaceWorker, PluginConfirmationDecision, PluginConfirmationHandler, PluginConfirmationIntent, PluginConfirmationPlan, PluginMethodResult, PluginRiskEffect, PluginRiskFlag, PluginRiskPlan, PluginRiskSeverity, PluginStreamEvent, PluginSurfaceHost, PluginSurfaceCloseResult, PluginSurfaceOpeningProgress, PluginSurfaceInteractionEvent, PluginSurfaceInteractionKind, PluginSurfaceQuiesceResult, PluginSurfaceRevocationReconciliation, PluginSurfacePreparationResult, PluginSurfaceContext, PluginSurfaceReloadDecision, PluginSurfaceReloadLimiterOptions, PluginSurfaceReloadState, PluginSurfaceSlotOptions, PluginSurfaceSlotState, PluginTrustedMethodResult, ReDevPluginSurfaceTransport, ReDevPluginSurfaceTransportOptions, TrustedParentBridgeHandshake, TrustedParentBridgeTokenRequest, WindowLike, } from "./surface.js";
 export type { FetchInitLike, FetchLike, FetchResponseLike, PlatformResponse } from "./http.js";

package/dist/trusted-parent.js

@@ -2,4 +2,4 @@ export * from "./contracts.gen.js";
 export * from "./errors.js";
 export * from "./platform.js";
 export { PluginSurfaceScope, createPluginSurfaceScope } from "./surface-scope.js";
-export { PluginSurfaceReloadLimiter, PluginSurfaceSlot, createReDevPluginSurfaceTransport, defaultPluginSurfaceReloadMax, defaultPluginSurfaceReloadWindowMs, isPluginRiskPlan, opaqueSurfaceDocumentSchemaVersion, pluginRiskPlanSchemaVersion, trustedParentBridgeHandshakeTranscriptSHA256, } from "./surface.js";
+export { PluginSurfaceReloadLimiter, PluginSurfaceSlot, createReDevPluginSurfaceTransport, defaultPluginSurfaceReloadMax, defaultPluginSurfaceReloadWindowMs, isPluginRiskPlan, opaqueSurfaceDocumentSchemaVersion, pluginSurfaceContextSchemaVersion, pluginRiskPlanSchemaVersion, trustedParentBridgeHandshakeTranscriptSHA256, } from "./surface.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@floegence/redevplugin-ui",
-  "version": "0.6.18",
+  "version": "0.6.20",
   "license": "MIT",
   "type": "module",
   "repository": {
@@ -32,7 +32,7 @@
     "dist"
   ],
   "dependencies": {
-    "@floegence/redevplugin-contracts": "0.6.18"
+    "@floegence/redevplugin-contracts": "0.6.20"
   },
   "publishConfig": {
     "access": "public"