@floegence/redevplugin-ui 0.0.0-dev

package/dist/index.d.ts

@@ -0,0 +1,665 @@
+export type BridgeLifecycleEvent = {
+    type: "ready";
+} | {
+    type: "visible";
+} | {
+    type: "hidden";
+} | {
+    type: "dispose";
+};
+export declare const pluginPlatformErrorCodes: readonly ["PLUGIN_INVALID_REQUEST", "PLUGIN_MANIFEST_INVALID", "PLUGIN_PACKAGE_INVALID", "PLUGIN_PACKAGE_TOO_LARGE", "PLUGIN_PACKAGE_PATH_FORBIDDEN", "PLUGIN_SIGNATURE_INVALID", "PLUGIN_TRUST_STATE_DENIED", "PLUGIN_TRUST_VERIFICATION_REQUIRED", "PLUGIN_TRUST_VERIFICATION_INVALID", "PLUGIN_DISABLED", "PLUGIN_DISABLED_BY_POLICY", "PLUGIN_PERMISSION_DENIED", "PLUGIN_CONFIRMATION_REQUIRED", "PLUGIN_CONFIRMATION_INVALID", "PLUGIN_TOKEN_EXPIRED", "PLUGIN_TOKEN_REPLAY", "PLUGIN_GATEWAY_TOKEN_INVALID", "PLUGIN_GATEWAY_TOKEN_REPLAYED", "PLUGIN_GATEWAY_TOKEN_CHANNEL_MISMATCH", "PLUGIN_ASSET_TICKET_INVALID", "PLUGIN_ASSET_SESSION_INVALID", "PLUGIN_STREAM_TICKET_INVALID", "PLUGIN_STREAM_CANCELLED", "PLUGIN_LEASE_INVALID", "PLUGIN_LEASE_REPLAYED", "PLUGIN_GRANT_INVALID", "PLUGIN_STORAGE_QUOTA_EXCEEDED", "PLUGIN_OPERATION_BLOCKED", "PLUGIN_OPERATION_NOT_FOUND", "PLUGIN_OPERATION_NOT_CANCELABLE", "PLUGIN_NETWORK_TARGET_DENIED", "PLUGIN_NETWORK_RATE_LIMITED", "PLUGIN_RUNTIME_UNAVAILABLE", "PLUGIN_RUNTIME_VERSION_MISMATCH", "PLUGIN_JSON_LIMIT_EXCEEDED", "PLUGIN_CONTRACT_MISMATCH", "PLUGIN_CSRF_REQUIRED", "PLUGIN_RETAINED_DATA_CLEANUP_FAILED", "PLUGIN_RETAINED_DATA_BIND_FAILED"];
+export declare const pluginBridgeErrorCodes: readonly ["PLUGIN_INVALID_REQUEST", "PLUGIN_MANIFEST_INVALID", "PLUGIN_PACKAGE_INVALID", "PLUGIN_PACKAGE_TOO_LARGE", "PLUGIN_PACKAGE_PATH_FORBIDDEN", "PLUGIN_SIGNATURE_INVALID", "PLUGIN_TRUST_STATE_DENIED", "PLUGIN_TRUST_VERIFICATION_REQUIRED", "PLUGIN_TRUST_VERIFICATION_INVALID", "PLUGIN_DISABLED", "PLUGIN_DISABLED_BY_POLICY", "PLUGIN_PERMISSION_DENIED", "PLUGIN_CONFIRMATION_REQUIRED", "PLUGIN_CONFIRMATION_INVALID", "PLUGIN_TOKEN_EXPIRED", "PLUGIN_TOKEN_REPLAY", "PLUGIN_GATEWAY_TOKEN_INVALID", "PLUGIN_GATEWAY_TOKEN_REPLAYED", "PLUGIN_GATEWAY_TOKEN_CHANNEL_MISMATCH", "PLUGIN_ASSET_TICKET_INVALID", "PLUGIN_ASSET_SESSION_INVALID", "PLUGIN_STREAM_TICKET_INVALID", "PLUGIN_STREAM_CANCELLED", "PLUGIN_LEASE_INVALID", "PLUGIN_LEASE_REPLAYED", "PLUGIN_GRANT_INVALID", "PLUGIN_STORAGE_QUOTA_EXCEEDED", "PLUGIN_OPERATION_BLOCKED", "PLUGIN_OPERATION_NOT_FOUND", "PLUGIN_OPERATION_NOT_CANCELABLE", "PLUGIN_NETWORK_TARGET_DENIED", "PLUGIN_NETWORK_RATE_LIMITED", "PLUGIN_RUNTIME_UNAVAILABLE", "PLUGIN_RUNTIME_VERSION_MISMATCH", "PLUGIN_JSON_LIMIT_EXCEEDED", "PLUGIN_CONTRACT_MISMATCH", "PLUGIN_CSRF_REQUIRED", "PLUGIN_RETAINED_DATA_CLEANUP_FAILED", "PLUGIN_RETAINED_DATA_BIND_FAILED", "PLUGIN_CONFIRMATION_REJECTED", "PLUGIN_BRIDGE_TIMEOUT", "PLUGIN_BRIDGE_DISPOSED", "PLUGIN_BRIDGE_HANDSHAKE_FAILED", "PLUGIN_BRIDGE_HANDSHAKE_REQUIRED"];
+export declare const pluginClientErrorCodes: readonly ["PLUGIN_INVALID_REQUEST", "PLUGIN_MANIFEST_INVALID", "PLUGIN_PACKAGE_INVALID", "PLUGIN_PACKAGE_TOO_LARGE", "PLUGIN_PACKAGE_PATH_FORBIDDEN", "PLUGIN_SIGNATURE_INVALID", "PLUGIN_TRUST_STATE_DENIED", "PLUGIN_TRUST_VERIFICATION_REQUIRED", "PLUGIN_TRUST_VERIFICATION_INVALID", "PLUGIN_DISABLED", "PLUGIN_DISABLED_BY_POLICY", "PLUGIN_PERMISSION_DENIED", "PLUGIN_CONFIRMATION_REQUIRED", "PLUGIN_CONFIRMATION_INVALID", "PLUGIN_TOKEN_EXPIRED", "PLUGIN_TOKEN_REPLAY", "PLUGIN_GATEWAY_TOKEN_INVALID", "PLUGIN_GATEWAY_TOKEN_REPLAYED", "PLUGIN_GATEWAY_TOKEN_CHANNEL_MISMATCH", "PLUGIN_ASSET_TICKET_INVALID", "PLUGIN_ASSET_SESSION_INVALID", "PLUGIN_STREAM_TICKET_INVALID", "PLUGIN_STREAM_CANCELLED", "PLUGIN_LEASE_INVALID", "PLUGIN_LEASE_REPLAYED", "PLUGIN_GRANT_INVALID", "PLUGIN_STORAGE_QUOTA_EXCEEDED", "PLUGIN_OPERATION_BLOCKED", "PLUGIN_OPERATION_NOT_FOUND", "PLUGIN_OPERATION_NOT_CANCELABLE", "PLUGIN_NETWORK_TARGET_DENIED", "PLUGIN_NETWORK_RATE_LIMITED", "PLUGIN_RUNTIME_UNAVAILABLE", "PLUGIN_RUNTIME_VERSION_MISMATCH", "PLUGIN_JSON_LIMIT_EXCEEDED", "PLUGIN_CONTRACT_MISMATCH", "PLUGIN_CSRF_REQUIRED", "PLUGIN_RETAINED_DATA_CLEANUP_FAILED", "PLUGIN_RETAINED_DATA_BIND_FAILED", "PLUGIN_CONFIRMATION_REJECTED", "PLUGIN_BRIDGE_TIMEOUT", "PLUGIN_BRIDGE_DISPOSED", "PLUGIN_BRIDGE_HANDSHAKE_FAILED", "PLUGIN_BRIDGE_HANDSHAKE_REQUIRED", "PLUGIN_PLATFORM_REQUEST_FAILED", "PLUGIN_STREAM_FAILED"];
+export type PluginPlatformErrorCode = typeof pluginPlatformErrorCodes[number];
+export type PluginBridgeErrorCode = typeof pluginBridgeErrorCodes[number];
+export type PluginClientErrorCode = typeof pluginClientErrorCodes[number];
+export type PluginBridgeHandshake = {
+    type: "redevplugin.bridge.handshake";
+    plugin_id: string;
+    surface_id: string;
+    surface_instance_id: string;
+    active_fingerprint: string;
+    bridge_nonce: string;
+    ui_protocol_version: "plugin-ui-v1";
+};
+export type PluginBridgeTokenRequest = {
+    bridge_channel_id: string;
+    handshake: PluginBridgeHandshake;
+    handshake_transcript_sha256: string;
+};
+export type PluginBridgeRequest = {
+    id: string;
+    method: string;
+    params?: unknown;
+};
+export type PluginBridgeResponse = {
+    type: "redevplugin.bridge.response";
+    id: string;
+    ok: true;
+    data?: unknown;
+} | {
+    type: "redevplugin.bridge.response";
+    id: string;
+    ok: false;
+    error_code: string;
+    error: string;
+};
+export type PluginBridgeCallMessage = {
+    type: "redevplugin.bridge.call";
+    request: PluginBridgeRequest;
+};
+export type PluginBridgeMessage = PluginBridgeHandshake | PluginBridgeCallMessage;
+export type PluginBridgeLifecycleMessage = {
+    type: "redevplugin.bridge.lifecycle";
+    event: BridgeLifecycleEvent;
+};
+export type PluginSurfaceBootstrap = {
+    pluginId: string;
+    surfaceId: string;
+    surfaceInstanceId: string;
+    activeFingerprint: string;
+    bridgeNonce: string;
+    parentOrigin: string;
+};
+export type PluginBridgeClientOptions = {
+    timeoutMs?: number;
+    target?: WindowLike;
+    receiver?: WindowLike;
+};
+export declare const defaultPluginSurfaceReloadMax = 2;
+export declare const defaultPluginSurfaceReloadWindowMs = 30000;
+export type PluginSurfaceReloadLimiterOptions = {
+    maxReloads?: number;
+    windowMs?: number;
+    now?: () => number;
+};
+export type PluginSurfaceReloadDecision = {
+    allowed: true;
+    attempt: number;
+    remaining: number;
+    windowStartedAtMs: number;
+} | {
+    allowed: false;
+    attempt: number;
+    remaining: 0;
+    windowStartedAtMs: number;
+    nextRetryAtMs: number;
+    reason: "reload_limit_exceeded";
+};
+export type PluginSurfaceReloadState = {
+    reloads: number;
+    remaining: number;
+    windowStartedAtMs?: number;
+    nextRetryAtMs?: number;
+};
+export type WindowLike = {
+    postMessage(message: unknown, targetOrigin: string): void;
+    addEventListener?(type: "message", listener: (event: MessageEventLike) => void): void;
+    removeEventListener?(type: "message", listener: (event: MessageEventLike) => void): void;
+};
+export type MessageEventLike = {
+    origin: string;
+    data: unknown;
+    source?: WindowLike | null;
+};
+export declare class PluginBridgeError extends Error {
+    readonly errorCode: string;
+    readonly data?: unknown;
+    readonly details?: unknown;
+    constructor(errorCode: string, message: string, data?: unknown, details?: unknown);
+}
+export declare function pluginBridgeHandshakeTranscriptSHA256(handshake: PluginBridgeHandshake, bridgeChannelID: string): Promise<string>;
+export declare class PluginSurfaceReloadLimiter {
+    #private;
+    readonly maxReloads: number;
+    readonly windowMs: number;
+    constructor(options?: PluginSurfaceReloadLimiterOptions);
+    recordCrash(nowMs?: number): PluginSurfaceReloadDecision;
+    recordHealthyLoad(): void;
+    reset(): void;
+    get state(): PluginSurfaceReloadState;
+}
+export declare class PluginBridgeClient {
+    #private;
+    readonly bootstrap: PluginSurfaceBootstrap;
+    readonly timeoutMs: number;
+    constructor(bootstrap: PluginSurfaceBootstrap, options?: PluginBridgeClientOptions);
+    handshake(): void;
+    call<T = unknown>(method: string, params?: unknown): Promise<T>;
+    onLifecycle(handler: (event: BridgeLifecycleEvent) => void): () => void;
+    dispose(): void;
+}
+export type PluginSurfaceHostBootstrap = {
+    pluginId: string;
+    pluginInstanceId: string;
+    surfaceId: string;
+    surfaceInstanceId: string;
+    activeFingerprint: string;
+    bridgeNonce: string;
+    ownerSessionHash?: string;
+    ownerUserHash?: string;
+    sessionChannelIdHash?: string;
+};
+export type PluginSurfaceHostOptions = {
+    bootstrap: PluginSurfaceHostBootstrap;
+    iframeOrigin: string;
+    iframeWindow: WindowLike;
+    parentWindow?: WindowLike;
+    bridgeChannelId?: string;
+    fetch?: FetchLike;
+    apiBaseURL?: string;
+    ownerSessionHashHeader?: string;
+    confirm?: PluginConfirmationHandler;
+    onError?: (error: PluginBridgeError) => void;
+};
+export type PluginConfirmationHandler = (intent: PluginConfirmationIntent) => Promise<PluginConfirmationDecision> | PluginConfirmationDecision;
+export declare const pluginRiskPlanSchemaVersion: "redevplugin.capability.risk_plan.v1";
+export type PluginRiskSeverity = "info" | "low" | "medium" | "high" | "critical";
+export type PluginRiskEffect = "read" | "write" | "execute" | "delete" | "admin";
+export type PluginRiskFlag = {
+    id: string;
+    severity: PluginRiskSeverity;
+    summary: string;
+    description?: string;
+    requires_confirmation?: boolean;
+    requires_admin?: boolean;
+    data_loss_risk?: boolean;
+    destructive?: boolean;
+};
+export type PluginRiskPlan = {
+    schema_version: typeof pluginRiskPlanSchemaVersion;
+    capability_id?: string;
+    binding_id?: string;
+    method?: string;
+    target_method?: string;
+    action?: string;
+    effect?: PluginRiskEffect;
+    resource_ref?: string;
+    resource_display_name?: string;
+    summary: string;
+    risk_flags: PluginRiskFlag[];
+    requires_confirmation?: boolean;
+    requires_admin?: boolean;
+    data_loss_risk?: boolean;
+    destructive?: boolean;
+    deny_reason?: string;
+    details?: Record<string, unknown>;
+};
+export type PluginConfirmationPlan = PluginRiskPlan | Record<string, unknown>;
+export declare function isPluginRiskPlan(plan: unknown): plan is PluginRiskPlan;
+export type PluginConfirmationIntent = {
+    requestId: string;
+    method: string;
+    params?: Record<string, unknown>;
+    requestHash: string;
+    planHash: string;
+    plan?: PluginConfirmationPlan;
+    confirmationTokenId: string;
+};
+export type PluginConfirmationDecision = boolean | {
+    confirmed: boolean;
+};
+export type FetchLike = (input: string, init: FetchInitLike) => Promise<FetchResponseLike>;
+export type FetchInitLike = {
+    method: string;
+    headers: Record<string, string>;
+    body?: string;
+    credentials?: "same-origin" | "include" | "omit";
+};
+export type FetchResponseLike = {
+    ok: boolean;
+    status: number;
+    json(): Promise<unknown>;
+};
+export type StreamFetchLike = (input: string, init?: StreamFetchInitLike) => Promise<StreamFetchResponseLike>;
+export type StreamFetchInitLike = {
+    method?: string;
+    headers?: Record<string, string>;
+    credentials?: "same-origin" | "include" | "omit";
+};
+export type StreamFetchResponseLike = {
+    ok: boolean;
+    status: number;
+    text(): Promise<string>;
+    json?(): Promise<unknown>;
+};
+export type PluginGatewayTokenResult = {
+    plugin_gateway_token: string;
+    plugin_gateway_token_id: string;
+    issued_at?: string;
+    expires_at?: string;
+};
+export type PluginMethodResult<T = unknown> = {
+    data?: T;
+    operation_id?: string;
+    stream_id?: string;
+    stream_ticket?: string;
+    stream_ticket_id?: string;
+    confirmation_required?: boolean;
+    confirmation_token_id?: string;
+    request_hash?: string;
+};
+export type PluginStreamEvent = {
+    stream_id: string;
+    sequence: number;
+    kind: string;
+    data?: string;
+    error?: string;
+    at: string;
+};
+export type ReadPluginStreamOptions = {
+    streamId?: string;
+    streamTicket?: string;
+    result?: PluginMethodResult;
+    fetch?: StreamFetchLike;
+    apiBaseURL?: string;
+};
+export type PluginConfirmationResult = {
+    confirmation_id: string;
+    confirmation_token_id: string;
+    request_hash: string;
+    plan_hash: string;
+    plan?: PluginConfirmationPlan;
+    expires_at?: string;
+};
+export type PluginPlatformClientOptions = {
+    fetch?: FetchLike;
+    apiBaseURL?: string;
+    ownerSessionHashHeader?: string;
+};
+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_host_protocol_version: string;
+    rust_ipc_version: string;
+    wasm_abi_version: string;
+    manifest_schema_version: string;
+    package_signature_schema_version: string;
+    token_ticket_schema_version: string;
+    bridge_schema_version: string;
+    target_classifier_version: string;
+    network_grant_schema_version: string;
+    plugin_platform_openapi_version: string;
+    compatibility_schema_version: string;
+    worker_invocation_schema_version: string;
+    error_codes_schema_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 = "bundled" | "verified" | "unsigned_local" | "untrusted" | "needs_review" | "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 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;
+    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?: Array<Record<string, unknown>>;
+    installed_at?: string;
+    enabled_at?: string;
+    updated_at?: string;
+    deleted_at?: string;
+    metadata?: Record<string, string>;
+    [key: string]: unknown;
+};
+export type PluginInstallRequest = {
+    package_base64: string;
+    trust_state?: PluginTrustState | string;
+    plugin_instance_id?: string;
+};
+export type PluginUpdateRequest = {
+    plugin_instance_id: string;
+    package_base64: string;
+    trust_state?: PluginTrustState | string;
+};
+export type PluginDowngradeRequest = {
+    plugin_instance_id: string;
+    version?: string;
+    package_hash?: string;
+};
+export type PluginEnableRequest = {
+    plugin_instance_id: string;
+};
+export type PluginDisableRequest = {
+    plugin_instance_id: string;
+    reason?: string;
+};
+export type PluginUninstallRequest = {
+    plugin_instance_id: string;
+    delete_data: boolean;
+};
+export type PluginOpenSurfaceRequest = {
+    plugin_instance_id: string;
+    surface_id: string;
+    surface_instance_id?: string;
+    owner_session_hash?: string;
+    owner_user_hash?: string;
+    session_channel_id_hash?: string;
+    sandbox_origin?: string;
+};
+export type PluginSurfaceBootstrapResult = {
+    plugin_id: string;
+    plugin_instance_id: string;
+    surface_id: string;
+    surface_instance_id: string;
+    active_fingerprint: string;
+    owner_session_hash?: string;
+    session_channel_id_hash?: string;
+    asset_ticket: string;
+    asset_ticket_id: string;
+    bridge_nonce: string;
+    issued_at: string;
+    expires_at: string;
+};
+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 PluginOperationRecord = {
+    operation_id: string;
+    plugin_id?: string;
+    plugin_instance_id: string;
+    method: string;
+    effect?: string;
+    execution: string;
+    surface_instance_id?: string;
+    session_channel_id_hash?: string;
+    bridge_channel_id?: string;
+    status: string;
+    disable_behavior?: string;
+    uninstall_behavior?: string;
+    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>;
+    owner_session_hash?: string;
+    owner_user_hash?: string;
+    session_channel_id_hash?: string;
+};
+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;
+    browser_site_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;
+};
+export declare class PluginPlatformClient {
+    #private;
+    constructor(options?: PluginPlatformClientOptions);
+    catalog(): Promise<PluginCatalogResult>;
+    getCompatibility(): Promise<PluginCompatibilityManifest>;
+    installPlugin(request: PluginInstallRequest): Promise<PluginRecord>;
+    updatePlugin(request: PluginUpdateRequest): Promise<PluginRecord>;
+    downgradePlugin(request: PluginDowngradeRequest): Promise<PluginRecord>;
+    enablePlugin(pluginInstanceIdOrRequest: string | PluginEnableRequest): Promise<PluginRecord>;
+    disablePlugin(request: PluginDisableRequest): Promise<PluginRecord>;
+    uninstallPlugin(request: PluginUninstallRequest): Promise<PluginRecord>;
+    openSurface(request: PluginOpenSurfaceRequest): Promise<PluginSurfaceBootstrapResult>;
+    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<PluginMethodResult<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>;
+}
+export declare class PluginSurfaceHost {
+    #private;
+    readonly bootstrap: PluginSurfaceHostBootstrap;
+    readonly iframeOrigin: string;
+    readonly bridgeChannelId: string;
+    constructor(options: PluginSurfaceHostOptions);
+    sendLifecycle(event: BridgeLifecycleEvent): void;
+    dispose(): void;
+}
+export declare function readPluginStream(options: ReadPluginStreamOptions): Promise<PluginStreamEvent[]>;
+export declare function decodePluginStreamText(event: PluginStreamEvent): string;