@floegence/redevplugin-ui 0.4.3 → 0.5.1

package/dist/platform.d.ts

@@ -1,539 +1,158 @@
 import { type FetchLike } from "./http.js";
-import type { PluginSurfaceHostBootstrap, PluginTrustedMethodResult } from "./surface.js";
+import type { components, operations } from "./openapi.gen.js";
+import { type PluginConfirmationHandler, type PluginSurfaceHost, type PluginSurfaceOpeningProgress, type PluginSurfaceReloadLimiter, type PluginSurfaceSlot, type PluginTrustedMethodResult, type ReDevPluginSurfaceTransport } from "./surface.js";
 import { type PluginSurfaceScope } from "./surface-scope.js";
 export type PluginPlatformClientOptions = {
     fetch?: FetchLike;
     apiBaseURL?: string;
     surfaceScope?: PluginSurfaceScope;
-};
-export type PluginCatalogRecord = Record<string, unknown>;
-export type PluginCatalogResult = {
-    plugins?: PluginCatalogRecord[];
-    [key: string]: unknown;
-};
-export type PluginCompatibilityMatrix = {
-    redevplugin_go_version: string;
-    redevplugin_ui_version: string;
-    redevplugin_runtime_version: string;
-    plugin_ui_protocol_version: string;
-    plugin_host_protocol_version: string;
-    rust_ipc_version: string;
-    wasm_abi_version: string;
-    manifest_schema_version: string;
-    package_signature_schema_version: string;
-    release_metadata_schema_version: string;
-    source_policy_schema_version: string;
-    source_revocations_schema_version: string;
-    token_ticket_schema_version: string;
-    bridge_schema_version: string;
-    opaque_surface_document_schema_version: string;
-    opaque_surface_transport_schema_version: string;
-    target_classifier_version: string;
-    network_grant_schema_version: string;
-    plugin_platform_openapi_version: string;
-    compatibility_schema_version: string;
-    release_manifest_schema_version: string;
-    worker_invocation_schema_version: string;
-    host_capability_contract_schema_version: string;
-    host_capability_pin_schema_version: string;
-    host_capability_manifest_schema_version: string;
-    host_capability_compatibility_schema_version: string;
-    host_capability_signature_schema_version: string;
-    host_capability_notices_schema_version: string;
-    error_codes_schema_version: string;
-    contract_registry_version: string;
-    [key: string]: unknown;
-};
-export type PluginContractArtifact = {
-    id: string;
-    path: string;
-    version: string;
-    sha256: string;
-    [key: string]: unknown;
-};
-export type PluginCompatibilityManifest = {
-    schema_version: string;
-    matrix: PluginCompatibilityMatrix;
-    contracts: PluginContractArtifact[];
-    [key: string]: unknown;
-};
-export type PluginTrustState = "verified" | "unsigned_local" | "untrusted" | "needs_review" | "trust_unavailable" | "blocked_security";
-export type PluginEnableState = "disabled" | "enabled" | "disabled_by_policy";
-export type PluginRetainedDataRecordState = "retained" | "expired" | "bound" | "deleted" | "delete_failed_retryable";
-export type PluginRetainedDataState = "none" | PluginRetainedDataRecordState;
-export type PluginTrustHashSet = {
-    package_sha256: string;
-    manifest_sha256: string;
-    entries_sha256: string;
-};
-export type PluginVerifiedSignature = {
-    algorithm: string;
-    key_id: string;
-};
-export type PluginTrustAssessment = {
-    trust_state: PluginTrustState | string;
-    reason_codes?: string[];
-    verified_hashes: PluginTrustHashSet;
-    verified_signature?: PluginVerifiedSignature;
-    trust_assessment_epoch?: string;
-    policy_epoch?: string;
-    revocation_epoch?: string;
-    metadata?: Record<string, string>;
-};
-export type PluginLocalImportProvenance = {
-    import_id: string;
-    distribution: "local_import" | string;
-    policy_epoch: string;
-    unsigned_policy: "dev_only" | "review_required" | "block" | string;
-    assessed_at: string;
-};
-export type PluginVersionRecord = {
-    version: string;
-    active_fingerprint: string;
-    package_hash: string;
-    manifest_hash: string;
-    entries_hash: string;
-    trust_state: PluginTrustState | string;
-    trust_assessment: PluginTrustAssessment;
-    source_policy_snapshot_hash?: string;
-    source_policy_snapshot?: Record<string, unknown>;
-    local_import_provenance?: PluginLocalImportProvenance;
-    metadata?: Record<string, string>;
-    [key: string]: unknown;
-};
-export type PluginRecord = {
-    plugin_instance_id: string;
-    publisher_id?: string;
-    plugin_id: string;
-    version: string;
-    active_fingerprint: string;
-    package_hash?: string;
-    manifest_hash?: string;
-    entries_hash?: string;
-    trust_state: PluginTrustState | string;
-    trust_assessment: PluginTrustAssessment;
-    source_policy_snapshot_hash?: string;
-    source_policy_snapshot?: Record<string, unknown>;
-    local_import_provenance?: PluginLocalImportProvenance;
-    enable_state: PluginEnableState | string;
-    disabled_reason?: string;
-    retained_data_state?: PluginRetainedDataState | string;
-    policy_revision?: number;
-    management_revision?: number;
-    revoke_epoch?: number;
-    manifest?: Record<string, unknown>;
-    package_entries?: Array<Record<string, unknown>>;
-    version_history?: PluginVersionRecord[];
-    installed_at?: string;
-    enabled_at?: string;
-    updated_at?: string;
-    deleted_at?: string;
-    metadata?: Record<string, string>;
-    [key: string]: unknown;
-};
-export type PluginPackageHashSet = {
-    package_sha256: string;
-    manifest_sha256: string;
-    entries_sha256: string;
-};
-export type PluginReleaseRef = {
-    source_id: string;
-    release_metadata_ref: string;
-    release_metadata_sha256: string;
-    publisher_id: string;
-    plugin_id: string;
-    version: string;
-    expected_hashes: PluginPackageHashSet;
-};
-export type PluginInstallReleaseRefRequest = {
-    release_ref: PluginReleaseRef;
-    plugin_instance_id?: string;
-    plugin_state_version: 0;
-};
-export type PluginUpdateReleaseRefRequest = {
-    plugin_instance_id: string;
-    release_ref: PluginReleaseRef;
-    plugin_state_version: number;
-};
-export type PluginDowngradeRequest = {
-    plugin_instance_id: string;
-    version?: string;
-    package_hash?: string;
-    plugin_state_version: number;
-};
-export type PluginEnableRequest = {
-    plugin_instance_id: string;
-    plugin_state_version: number;
-};
-export type PluginDisableRequest = {
-    plugin_instance_id: string;
-    plugin_state_version: number;
-    reason?: string;
-};
-export type PluginUninstallRequest = {
-    plugin_instance_id: string;
-    plugin_state_version: number;
-    delete_data: boolean;
-};
-export type PluginOpenSurfaceRequest = {
-    plugin_instance_id: string;
-    surface_id: string;
-    surface_instance_id?: string;
-    plugin_state_version: number;
-};
-export type PluginSurfaceScopeRevokeResult = {
-    revoked_surface_count: number;
-};
-export type PluginSurfaceBootstrapResult = {
-    plugin_id: string;
-    plugin_instance_id: string;
-    plugin_version: string;
-    surface_id: string;
-    surface_instance_id: string;
-    active_fingerprint: string;
-    entry_path: string;
-    entry_sha256: string;
-    asset_session_nonce: string;
-    plugin_state_version: number;
-    revoke_epoch: number;
-    runtime_generation_id: string;
-    asset_ticket: string;
-    asset_ticket_id: string;
-    bridge_nonce: string;
-    issued_at: string;
-    expires_at: string;
-};
-export declare function toPluginSurfaceHostBootstrap(value: PluginSurfaceBootstrapResult): PluginSurfaceHostBootstrap;
-export type PluginRuntimeTarget = {
-    os?: string;
-    arch?: string;
-};
-export type PluginRuntimeStartRequest = {
-    target?: PluginRuntimeTarget;
-};
-export type PluginRuntimeHealth = {
-    runtime_instance_id: string;
-    runtime_generation_id: string;
-    runtime_version?: string;
-    rust_ipc_version?: string;
-    wasm_abi_version?: string;
-    ready: boolean;
-};
-export type PluginRuntimeStopResult = {
-    stopped: boolean;
-};
-export type PluginRuntimeRefreshResult = {
-    refreshed_plugins: PluginRecord[];
-};
-export type PluginSettingsField = {
-    key: string;
-    type: string;
-    label: string;
-    scope: string;
-    default?: unknown;
-    secret_ref?: string;
-    options?: string[];
-    validation?: Record<string, unknown>;
-};
-export type PluginSettingsSchema = {
-    plugin_instance_id: string;
-    schema_version: number;
-    migration?: Record<string, unknown>;
-    fields: PluginSettingsField[];
-    settings_revision: number;
-};
-export type PluginSettingsSnapshot = {
-    plugin_instance_id: string;
-    schema_version: number;
-    settings_revision: number;
-    values: Record<string, unknown>;
-    updated_at: string;
-};
-export type PluginCapabilityContractPin = {
-    publisher_id: string;
-    contract_id: string;
-    contract_version: string;
-    artifact_ref: string;
-    artifact_sha256: string;
-    manifest_ref: string;
-    manifest_sha256: string;
-    signature_ref: string;
-    signature_sha256: string;
-    signature_key_id: string;
-    signature_policy_epoch: string;
-    signature_revocation_epoch: string;
-    compatibility_ref: string;
-    compatibility_sha256: string;
-    generated_client_ref: string;
-    generated_client_sha256: string;
-    notices_ref: string;
-    notices_sha256: string;
-};
-export type PluginExecutionBinding = {
-    invocation_id: string;
-    audit_correlation_id: string;
-    operation_id: string;
-    stream_id?: string;
-    publisher_id: string;
-    plugin_id: string;
-    plugin_instance_id: string;
-    plugin_version: string;
-    active_fingerprint: string;
-    surface_instance_id?: string;
-    owner_session_hash?: string;
-    owner_user_hash?: string;
-    session_channel_id_hash?: string;
-    bridge_channel_id?: string;
-    capability_id: string;
-    capability_version: string;
-    binding_id: string;
-    contract: PluginCapabilityContractPin;
-    method: string;
-    target_method: string;
-    effect: "read" | "write" | "execute" | "delete" | "admin";
-    execution: "operation" | "subscription";
-    permissions: {
-        required: string[];
-        granted: string[];
-    };
-    confirmation: {
-        required: boolean;
-        confirmed: boolean;
-        confirmation_id?: string;
-        request_sha256?: string;
-        plan_sha256?: string;
-        target_sha256?: string;
-    };
-    revision: {
-        policy_revision: number;
-        management_revision: number;
-        revoke_epoch: number;
-    };
-    quota: {
-        max_concurrent?: number;
-        max_duration_ms?: number;
-        max_stream_bytes?: number;
-        expires_at?: string;
-    };
-    target: {
-        kind: string;
-        fields: Record<string, unknown>;
-    };
-    target_descriptor_sha256: string;
-    stream_event_type_name?: string;
-    stream_event_schema_sha256?: string;
-};
-export type PluginOperationRecord = PluginExecutionBinding & {
-    status: "running" | "cancel_requested" | "canceled" | "completed" | "failed" | "orphaned_after_disable" | "orphaned_after_uninstall";
-    cancelable: boolean;
-    cancel_ack_timeout_ms?: number;
-    disable_behavior?: "cancel" | "orphan" | "wait";
-    uninstall_behavior?: "cancel_then_block_delete" | "force_cleanup_allowed";
-    reason?: string;
-    created_at: string;
-    updated_at: string;
-    cancel_requested_at?: string;
-    orphaned_at?: string;
-};
-export type PluginOperationList = {
-    operations?: PluginOperationRecord[];
-    [key: string]: unknown;
-};
-export type PluginIntentRecord = {
-    plugin_id: string;
-    plugin_instance_id: string;
-    publisher_id: string;
-    display_name: string;
-    version: string;
-    active_fingerprint: string;
-    intent_id: string;
-    method: string;
-    effect: string;
-    execution: string;
-    payload_schema?: Record<string, unknown>;
-};
-export type PluginIntentList = {
-    intents?: PluginIntentRecord[];
-    [key: string]: unknown;
-};
-export type PluginIntentListOptions = {
-    intent_id?: string;
-    plugin_instance_id?: string;
-};
-export type PluginIntentInvokeRequest = {
-    plugin_instance_id?: string;
-    intent_id: string;
-    params?: Record<string, unknown>;
-};
-export type PluginPermissionGrant = {
-    plugin_instance_id: string;
-    permission_id: string;
-    granted_by?: string;
-    granted_at?: string;
-    revoked_by?: string;
-    revoked_at?: string;
-    reason?: string;
-    expires_at?: string;
-    [key: string]: unknown;
-};
-export type PluginPermissionList = {
-    permissions?: PluginPermissionGrant[];
-    [key: string]: unknown;
-};
-export type PluginPermissionGrantRequest = {
-    plugin_instance_id: string;
-    permission_id: string;
-    granted_by?: string;
-    expires_at?: string;
-};
-export type PluginPermissionRevokeRequest = {
-    plugin_instance_id: string;
-    permission_id: string;
-    revoked_by?: string;
-    reason?: string;
-};
-export type PluginDataExportRequest = {
-    plugin_instance_id: string;
-    include_secrets?: boolean;
-};
-export type PluginDataExportResult = {
-    archive_ref?: string;
-    settings_archive_ref?: string;
-};
-export type PluginDataImportRequest = {
-    plugin_instance_id: string;
-    archive_ref?: string;
-    settings_archive_ref?: string;
-    delete_existing?: boolean;
-};
-export type PluginRetainedDataRecord = {
-    retained_id: string;
-    source_plugin_instance_id: string;
-    bound_plugin_instance_id?: string;
-    publisher_id: string;
-    plugin_id: string;
-    version: string;
-    package_hash: string;
-    manifest_hash: string;
-    state: PluginRetainedDataRecordState | string;
-    storage_retained?: boolean;
-    settings_retained?: boolean;
-    usage_bytes?: number;
-    delete_after?: string;
-    delete_error?: string;
-    metadata?: Record<string, string>;
-    retained_at?: string;
-    updated_at?: string;
-    bound_at?: string;
-    deleted_at?: string;
-    last_accessed_at?: string;
-    [key: string]: unknown;
-};
-export type PluginRetainedDataListOptions = {
-    publisher_id?: string;
-    plugin_id?: string;
-    source_plugin_instance_id?: string;
-    state?: PluginRetainedDataRecordState | string;
-};
-export type PluginRetainedDataList = {
-    retained_data?: PluginRetainedDataRecord[];
-    [key: string]: unknown;
-};
-export type PluginRetainedDataBindRequest = {
-    retained_id: string;
-    target_plugin_instance_id: string;
-};
-export type PluginRetainedDataCleanupRequest = {
-    retry_failed?: boolean;
-    max_records?: number;
-};
-export type PluginRetainedDataCleanupResult = {
-    deleted?: PluginRetainedDataRecord[];
-    failed?: PluginRetainedDataRecord[];
-    [key: string]: unknown;
-};
-export type PluginSecretRefRequest = {
-    plugin_instance_id: string;
-    secret_ref: string;
-    scope: string;
-};
-export type PluginAuditEvent = {
-    type: string;
-    plugin_id?: string;
-    plugin_instance_id?: string;
-    occurred_at?: string;
-    details?: Record<string, unknown>;
-    [key: string]: unknown;
-};
-export type PluginAuditEventList = {
-    audit_events?: PluginAuditEvent[];
-    [key: string]: unknown;
-};
-export type PluginAuditListOptions = {
-    plugin_id?: string;
-    plugin_instance_id?: string;
-    type?: string;
-    limit?: number;
-};
-export type PluginDiagnosticEvent = {
-    type: string;
-    severity?: string;
-    plugin_id?: string;
-    plugin_instance_id?: string;
-    surface_instance_id?: string;
-    occurred_at?: string;
-    details?: Record<string, unknown>;
-    [key: string]: unknown;
-};
-export type PluginDiagnosticEventList = {
-    diagnostic_events?: PluginDiagnosticEvent[];
-    [key: string]: unknown;
-};
-export type PluginDiagnosticListOptions = {
-    plugin_id?: string;
-    plugin_instance_id?: string;
-    surface_instance_id?: string;
-    type?: string;
-    severity?: string;
-    limit?: number;
-};
+    surfaceTransport?: ReDevPluginSurfaceTransport;
+    onMutationOutcomeUnknown?: (pluginInstanceId?: string) => void;
+};
+export type PluginRequestOptions = {
+    signal?: AbortSignal;
+};
+type PlatformSchemas = components["schemas"];
+export type PluginCatalogResult = PlatformSchemas["PluginCatalogResult"];
+export type PluginCatalogRecord = PluginCatalogResult["plugins"][number];
+export type PluginFeatures = PlatformSchemas["PluginFeaturesSuccessResponse"]["data"];
+export type PluginCompatibilityManifest = PlatformSchemas["PluginCompatibilityManifest"];
+export type PluginCompatibilityMatrix = PluginCompatibilityManifest["matrix"];
+export type PluginContractArtifact = PluginCompatibilityManifest["contracts"][number];
+export type PluginTrustState = PlatformSchemas["TrustState"];
+export type PluginTrustHashSet = PlatformSchemas["TrustHashSet"];
+export type PluginVerifiedSignature = PlatformSchemas["VerifiedSignature"];
+export type PluginTrustAssessment = PlatformSchemas["TrustAssessment"];
+export type PluginLocalImportProvenance = PlatformSchemas["LocalImportProvenance"];
+export type PluginVersionRecord = PlatformSchemas["PluginVersion"];
+export type PluginRecord = PlatformSchemas["PluginRecord"];
+export type PluginEnableState = PluginRecord["enable_state"];
+export type PluginPackageHashSet = PlatformSchemas["PackageHashSet"];
+export type PluginReleaseRef = PlatformSchemas["PluginReleaseRef"];
+export type PluginInstallReleaseRefRequest = PlatformSchemas["InstallReleaseRefRequest"];
+export type PluginUpdateReleaseRefRequest = PlatformSchemas["UpdateReleaseRefRequest"];
+export type PluginDowngradeRequest = PlatformSchemas["DowngradeRequest"];
+export type PluginEnableRequest = PlatformSchemas["EnableRequest"];
+export type PluginDisableRequest = PlatformSchemas["DisableRequest"];
+export type PluginUninstallRequest = PlatformSchemas["UninstallRequest"];
+export type PluginOpenSurfaceRequest = PlatformSchemas["OpenSurfaceRequest"];
+export type PluginOpenSurfaceInSlotOptions = PluginRequestOptions & {
+    bridgeChannelId?: string;
+    loadTimeoutMs?: number;
+    requestTimeoutMs?: number;
+    leaseRenewalLeadMs?: number;
+    reloadLimiter?: PluginSurfaceReloadLimiter;
+    confirm?: PluginConfirmationHandler;
+    onOpeningProgress?: (progress: PluginSurfaceOpeningProgress) => void;
+    onError?: (error: import("./errors.js").PluginBridgeError) => void;
+};
+export type PluginSurfaceScopeRevokeResult = PlatformSchemas["SurfaceScopeRevokeResult"];
+export type PluginSurfaceBootstrapResult = PlatformSchemas["SurfaceBootstrap"];
+export type PluginRuntimeStartRequest = PlatformSchemas["StartRuntimeRequest"];
+export type PluginRuntimeTarget = NonNullable<PluginRuntimeStartRequest["target"]>;
+/** Negotiated limits reported by runtime health; configuration is Host-owned. */
+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 PluginSettingsField = PlatformSchemas["PluginSettingsField"];
+export type PluginSettingsSchema = PlatformSchemas["PluginSettingsSchema"];
+export type PluginSettingsSnapshot = PlatformSchemas["PluginSettingsSnapshot"];
+export type PluginResourceScopeKind = PlatformSchemas["ResourceScopeKind"];
+type PluginSettingsPatchBase = Pick<PlatformSchemas["PatchSettingsRequest"], "scope" | "expected_values_revision">;
+export type PluginSettingsPatchRequest = PluginSettingsPatchBase & ({
+    set: Record<string, unknown>;
+    remove?: [string, ...string[]];
+} | {
+    set?: Record<string, unknown>;
+    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 = NonNullable<operations["listPluginOperations"]["parameters"]["query"]>;
+export type PluginIntentRecord = PlatformSchemas["PluginIntentRecord"];
+export type PluginIntentList = PlatformSchemas["PluginIntentList"];
+export type PluginIntentListOptions = NonNullable<operations["listPluginIntents"]["parameters"]["query"]>;
+export type PluginIntentInvokeRequest = PlatformSchemas["InvokeIntentRequest"];
+export type PluginPermissionGrant = PlatformSchemas["PluginPermissionGrant"];
+export type PluginPermissionMutationResult = PlatformSchemas["PluginPermissionMutationResult"];
+export type PluginPermissionList = PlatformSchemas["PluginPermissionList"];
+export type PluginPermissionListOptions = NonNullable<operations["listPluginPermissionGrants"]["parameters"]["query"]>;
+export type PluginPermissionGrantRequest = PlatformSchemas["GrantPermissionRequest"];
+export type PluginPermissionRevokeRequest = PlatformSchemas["RevokePermissionRequest"];
+export type PluginSecurityPolicy = PlatformSchemas["PluginSecurityPolicy"];
+export type PluginSecurityPolicyList = PlatformSchemas["PluginSecurityPolicyList"];
+export type PluginSecurityPolicyPutRequest = PlatformSchemas["PutSecurityPolicyRequest"];
+export type PluginSecurityPolicyDeleteRequest = PlatformSchemas["DeleteSecurityPolicyRequest"];
+export type PluginSecurityPolicyDeleteResult = PlatformSchemas["PluginSecurityPolicyDeleteResult"];
+export type PluginDataExportRequest = PlatformSchemas["ExportDataRequest"];
+export type PluginDataExportResult = PlatformSchemas["PluginDataExportResult"];
+export type PluginDataExportDeleteRequest = PlatformSchemas["DeleteDataExportRequest"];
+export type PluginDataExportDeleteResult = PlatformSchemas["PluginDataExportDeleteResult"];
+export type PluginDataImportRequest = PlatformSchemas["ImportDataRequest"];
+export type PluginDataBinding = PlatformSchemas["PluginDataBinding"];
+export type PluginRetainedDataListOptions = NonNullable<operations["listPluginRetainedData"]["parameters"]["query"]>;
+export type PluginRetainedDataList = PlatformSchemas["RetainedDataList"];
+export type PluginRetainedDataDeleteRequest = PlatformSchemas["DeleteRetainedDataRequest"];
+export type PluginRetainedDataBindRequest = PlatformSchemas["BindRetainedDataRequest"];
+export type PluginRetainedDataCleanupRequest = PlatformSchemas["CleanupExpiredRetainedDataRequest"];
+export type PluginRetainedDataCleanupResult = PlatformSchemas["RetainedDataCleanupResult"];
+export type PluginSecretRefRequest = PlatformSchemas["SecretRefRequest"];
+export type PluginSecretBindResult = PlatformSchemas["PluginSecretBindResult"];
+export type PluginSecretTestResult = PlatformSchemas["PluginSecretTestResult"];
+export type PluginSecretDeleteResult = PlatformSchemas["PluginSecretDeleteResult"];
+export type PluginDiagnosticEvent = PlatformSchemas["PluginDiagnosticEvent"];
+export type PluginDiagnosticEventList = PlatformSchemas["PluginDiagnosticEventList"];
+export type PluginDiagnosticDetails = PlatformSchemas["PluginDiagnosticDetails"];
+export type PluginDiagnosticMutationOutcome = PlatformSchemas["DiagnosticMutationOutcome"];
+export type PluginDiagnosticListOptions = NonNullable<operations["listPluginDiagnosticEvents"]["parameters"]["query"]>;
+export type PluginDiagnosticSeverity = NonNullable<PluginDiagnosticListOptions["severity"]>;
 export declare class PluginPlatformClient {
     #private;
     constructor(options?: PluginPlatformClientOptions);
-    catalog(): Promise<PluginCatalogResult>;
-    getCompatibility(): Promise<PluginCompatibilityManifest>;
-    installReleaseRef(request: PluginInstallReleaseRefRequest): Promise<PluginRecord>;
-    updateReleaseRef(request: PluginUpdateReleaseRefRequest): Promise<PluginRecord>;
-    downgradePlugin(request: PluginDowngradeRequest): Promise<PluginRecord>;
-    enablePlugin(request: PluginEnableRequest): Promise<PluginRecord>;
-    disablePlugin(request: PluginDisableRequest): Promise<PluginRecord>;
-    uninstallPlugin(request: PluginUninstallRequest): Promise<PluginRecord>;
-    openSurface(request: PluginOpenSurfaceRequest): Promise<PluginSurfaceBootstrapResult>;
-    revokeSurfaceScope(): Promise<PluginSurfaceScopeRevokeResult>;
-    startRuntime(request?: PluginRuntimeStartRequest): Promise<PluginRuntimeHealth>;
-    stopRuntime(): Promise<PluginRuntimeStopResult>;
-    refreshEnabledRuntimeState(): Promise<PluginRuntimeRefreshResult>;
-    runtimeHealth(): Promise<PluginRuntimeHealth>;
-    getSettingsSchema(pluginInstanceId: string): Promise<PluginSettingsSchema>;
-    getSettings(pluginInstanceId: string): Promise<PluginSettingsSnapshot>;
-    patchSettings(pluginInstanceId: string, values: Record<string, unknown>): Promise<PluginSettingsSnapshot>;
-    listOperations(pluginInstanceId?: string): Promise<PluginOperationList>;
-    getOperation(operationId: string): Promise<PluginOperationRecord>;
-    cancelOperation(operationId: string, reason?: string): Promise<PluginOperationRecord>;
-    listIntents(options?: PluginIntentListOptions): Promise<PluginIntentList>;
-    invokeIntent<T = unknown>(request: PluginIntentInvokeRequest): Promise<PluginTrustedMethodResult<T>>;
-    exportData(request: PluginDataExportRequest): Promise<PluginDataExportResult>;
-    importData(request: PluginDataImportRequest): Promise<Record<string, unknown>>;
-    listRetainedData(options?: PluginRetainedDataListOptions): Promise<PluginRetainedDataList>;
-    deleteRetainedData(retainedId: string): Promise<PluginRetainedDataRecord>;
-    bindRetainedData(request: PluginRetainedDataBindRequest): Promise<PluginRetainedDataRecord>;
-    cleanupExpiredRetainedData(request?: PluginRetainedDataCleanupRequest): Promise<PluginRetainedDataCleanupResult>;
-    listPermissions(pluginInstanceId?: string, activeOnly?: boolean): Promise<PluginPermissionList>;
-    grantPermission(request: PluginPermissionGrantRequest): Promise<PluginPermissionGrant>;
-    revokePermission(request: PluginPermissionRevokeRequest): Promise<PluginPermissionGrant>;
-    bindSecret(request: PluginSecretRefRequest): Promise<Record<string, unknown>>;
-    testSecret(request: PluginSecretRefRequest): Promise<Record<string, unknown>>;
-    deleteSecret(request: PluginSecretRefRequest): Promise<Record<string, unknown>>;
-    listAuditEvents(options?: PluginAuditListOptions): Promise<PluginAuditEventList>;
-    listDiagnosticEvents(options?: PluginDiagnosticListOptions): Promise<PluginDiagnosticEventList>;
+    catalog(options?: PluginRequestOptions): Promise<PluginCatalogResult>;
+    features(options?: PluginRequestOptions): Promise<PluginFeatures>;
+    getCompatibility(options?: PluginRequestOptions): Promise<PluginCompatibilityManifest>;
+    installReleaseRef(request: PluginInstallReleaseRefRequest, options?: PluginRequestOptions): Promise<PluginRecord>;
+    updateReleaseRef(request: PluginUpdateReleaseRefRequest, options?: PluginRequestOptions): Promise<PluginRecord>;
+    downgradePlugin(request: PluginDowngradeRequest, options?: PluginRequestOptions): Promise<PluginRecord>;
+    enablePlugin(request: PluginEnableRequest, options?: PluginRequestOptions): Promise<PluginRecord>;
+    disablePlugin(request: PluginDisableRequest, options?: PluginRequestOptions): Promise<PluginRecord>;
+    uninstallPlugin(request: PluginUninstallRequest, options?: PluginRequestOptions): Promise<PluginRecord>;
+    openSurfaceInSlot(slot: PluginSurfaceSlot, request: PluginOpenSurfaceRequest, options?: PluginOpenSurfaceInSlotOptions): Promise<PluginSurfaceHost>;
+    revokeSurfaceScope(options?: PluginRequestOptions): Promise<PluginSurfaceScopeRevokeResult>;
+    startRuntime(request: PluginRuntimeStartRequest, options?: PluginRequestOptions): Promise<PluginRuntimeHealth>;
+    stopRuntime(options?: PluginRequestOptions): Promise<PluginRuntimeStopResult>;
+    refreshEnabledRuntimeState(options?: PluginRequestOptions): Promise<PluginRuntimeRefreshResult>;
+    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>;
+    listIntents(options?: PluginIntentListOptions, requestOptions?: PluginRequestOptions): Promise<PluginIntentList>;
+    invokeIntent<T = unknown>(request: PluginIntentInvokeRequest, options?: PluginRequestOptions): Promise<PluginTrustedMethodResult<T>>;
+    exportData(request: PluginDataExportRequest, options?: PluginRequestOptions): Promise<PluginDataExportResult>;
+    deleteDataExport(request: PluginDataExportDeleteRequest, options?: PluginRequestOptions): Promise<PluginDataExportDeleteResult>;
+    importData(request: PluginDataImportRequest, options?: PluginRequestOptions): Promise<PluginRecord>;
+    listRetainedData(options?: PluginRetainedDataListOptions, requestOptions?: PluginRequestOptions): Promise<PluginRetainedDataList>;
+    deleteRetainedData(request: PluginRetainedDataDeleteRequest, options?: PluginRequestOptions): Promise<PluginDataBinding>;
+    bindRetainedData(request: PluginRetainedDataBindRequest, options?: PluginRequestOptions): Promise<PluginDataBinding>;
+    cleanupExpiredRetainedData(request?: PluginRetainedDataCleanupRequest, options?: PluginRequestOptions): Promise<PluginRetainedDataCleanupResult>;
+    listPermissions(options?: PluginPermissionListOptions, requestOptions?: PluginRequestOptions): Promise<PluginPermissionList>;
+    grantPermission(request: PluginPermissionGrantRequest, options?: PluginRequestOptions): Promise<PluginPermissionMutationResult>;
+    revokePermission(request: PluginPermissionRevokeRequest, options?: PluginRequestOptions): Promise<PluginPermissionMutationResult>;
+    listSecurityPolicies(options?: PluginRequestOptions): Promise<PluginSecurityPolicyList>;
+    getSecurityPolicy(pluginInstanceId: string, options?: PluginRequestOptions): Promise<PluginSecurityPolicy>;
+    putSecurityPolicy(pluginInstanceId: string, request: PluginSecurityPolicyPutRequest, options?: PluginRequestOptions): Promise<PluginSecurityPolicy>;
+    deleteSecurityPolicy(pluginInstanceId: string, request: PluginSecurityPolicyDeleteRequest, options?: PluginRequestOptions): Promise<PluginSecurityPolicyDeleteResult>;
+    bindSecret(request: PluginSecretRefRequest, options?: PluginRequestOptions): Promise<PluginSecretBindResult>;
+    testSecret(request: PluginSecretRefRequest, options?: PluginRequestOptions): Promise<PluginSecretTestResult>;
+    deleteSecret(request: PluginSecretRefRequest, options?: PluginRequestOptions): Promise<PluginSecretDeleteResult>;
+    listDiagnosticEvents(options?: PluginDiagnosticListOptions, requestOptions?: PluginRequestOptions): Promise<PluginDiagnosticEventList>;
 }
+export {};