@tx5dr/contracts 1.2.0

package/dist/schema/plugin.schema.d.ts

@@ -0,0 +1,1579 @@
+import { z } from 'zod';
+/**
+ * High-level plugin category.
+ *
+ * - `strategy`: owns the operator's automation runtime and is mutually
+ *   exclusive per operator.
+ * - `utility`: composes with other utility plugins to filter, score, monitor or
+ *   augment UI.
+ */
+export declare const PluginTypeSchema: z.ZodEnum<["strategy", "utility"]>;
+/**
+ * High-level plugin category used by manifests and runtime status objects.
+ */
+export type PluginType = z.infer<typeof PluginTypeSchema>;
+/**
+ * Runtime instance scope for a plugin.
+ *
+ * - `operator`: the host creates one instance per operator.
+ * - `global`: the host creates a single shared instance for the whole station.
+ */
+export declare const PluginInstanceScopeSchema: z.ZodEnum<["operator", "global"]>;
+/**
+ * Runtime instance scope for a plugin.
+ */
+export type PluginInstanceScope = z.infer<typeof PluginInstanceScopeSchema>;
+/**
+ * Explicit permission declarations requested by a plugin.
+ *
+ * Permissions let the host gate sensitive capabilities behind manifest-level
+ * intent. Plugins should request the smallest possible set.
+ */
+export declare const PluginPermissionSchema: z.ZodEnum<["network"]>;
+/**
+ * Explicit permission declarations requested by a plugin.
+ */
+export type PluginPermission = z.infer<typeof PluginPermissionSchema>;
+/**
+ * Built-in frontend renderer kinds supported by declarative plugin panels.
+ */
+export declare const PluginPanelComponentSchema: z.ZodEnum<["table", "key-value", "chart", "log", "iframe"]>;
+/**
+ * Built-in frontend renderer kinds supported by declarative plugin panels.
+ */
+export type PluginPanelComponent = z.infer<typeof PluginPanelComponentSchema>;
+/**
+ * Supported generated-form field types for plugin settings.
+ *
+ * These values control both validation expectations and default frontend
+ * rendering in plugin settings UIs.
+ */
+export declare const PluginSettingTypeSchema: z.ZodEnum<["boolean", "number", "string", "string[]", "info"]>;
+/**
+ * Supported generated-form field types for plugin settings.
+ */
+export type PluginSettingType = z.infer<typeof PluginSettingTypeSchema>;
+/**
+ * Label/value pair used by select-like plugin settings.
+ */
+export declare const PluginSettingOptionSchema: z.ZodObject<{
+    label: z.ZodString;
+    value: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    value: string;
+    label: string;
+}, {
+    value: string;
+    label: string;
+}>;
+/**
+ * Label/value pair used by select-like plugin settings.
+ */
+export type PluginSettingOption = z.infer<typeof PluginSettingOptionSchema>;
+/**
+ * Persistence and UI scope for a plugin setting.
+ *
+ * - `global`: shared by the whole station and typically edited in plugin
+ *   management views.
+ * - `operator`: isolated per operator and typically edited in operator-specific
+ *   automation settings.
+ */
+export declare const PluginSettingScopeSchema: z.ZodEnum<["global", "operator"]>;
+/**
+ * Persistence and UI scope for a plugin setting.
+ */
+export type PluginSettingScope = z.infer<typeof PluginSettingScopeSchema>;
+/**
+ * Declarative description of a persisted plugin setting.
+ *
+ * The host uses this schema to generate configuration forms, validate updates
+ * and resolve default values before injecting them into `ctx.config`.
+ */
+export declare const PluginSettingDescriptorSchema: z.ZodObject<{
+    type: z.ZodEnum<["boolean", "number", "string", "string[]", "info"]>;
+    default: z.ZodUnknown;
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    min: z.ZodOptional<z.ZodNumber>;
+    max: z.ZodOptional<z.ZodNumber>;
+    options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        value: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        label: string;
+    }, {
+        value: string;
+        label: string;
+    }>, "many">>;
+    /** 设置作用域：global（所有操作员共享）或 operator（每操作员独立），默认 global */
+    scope: z.ZodDefault<z.ZodOptional<z.ZodEnum<["global", "operator"]>>>;
+}, "strip", z.ZodTypeAny, {
+    type: "string" | "number" | "boolean" | "string[]" | "info";
+    label: string;
+    scope: "operator" | "global";
+    options?: {
+        value: string;
+        label: string;
+    }[] | undefined;
+    min?: number | undefined;
+    max?: number | undefined;
+    description?: string | undefined;
+    default?: unknown;
+}, {
+    type: "string" | "number" | "boolean" | "string[]" | "info";
+    label: string;
+    options?: {
+        value: string;
+        label: string;
+    }[] | undefined;
+    min?: number | undefined;
+    max?: number | undefined;
+    description?: string | undefined;
+    default?: unknown;
+    scope?: "operator" | "global" | undefined;
+}>;
+/**
+ * Declarative description of a persisted plugin setting.
+ *
+ * `default` is the resolved fallback value, `label`/`description` power the UI,
+ * `min` and `max` constrain numeric fields, `options` enumerates valid choices
+ * for select-like inputs, and `scope` controls whether the value is shared or
+ * operator-specific.
+ */
+export type PluginSettingDescriptor = z.infer<typeof PluginSettingDescriptorSchema>;
+/**
+ * Declarative quick-action button shown in operator-facing plugin UI.
+ *
+ * Quick actions are intended for one-shot commands and are dispatched through
+ * the plugin user-action channel when clicked.
+ */
+export declare const PluginQuickActionSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    icon: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    label: string;
+    icon?: string | undefined;
+}, {
+    id: string;
+    label: string;
+    icon?: string | undefined;
+}>;
+/**
+ * Declarative quick-action button shown in operator-facing plugin UI.
+ */
+export type PluginQuickAction = z.infer<typeof PluginQuickActionSchema>;
+/**
+ * Shortcut reference to an operator-scope setting that should be surfaced in a
+ * compact quick-settings panel.
+ */
+export declare const PluginQuickSettingSchema: z.ZodObject<{
+    settingKey: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    settingKey: string;
+}, {
+    settingKey: string;
+}>;
+/**
+ * Shortcut reference to an operator-scope setting that should be surfaced in a
+ * compact quick-settings panel.
+ */
+export type PluginQuickSetting = z.infer<typeof PluginQuickSettingSchema>;
+/**
+ * Host-derived capability tags exposed to the frontend.
+ *
+ * These tags are computed from the plugin definition so the UI can reason
+ * about plugin roles without hard-coding specific plugin names.
+ */
+export declare const PluginCapabilitySchema: z.ZodEnum<["auto_call_candidate", "auto_call_execution"]>;
+/**
+ * Host-derived capability tags exposed to the frontend.
+ */
+export type PluginCapability = z.infer<typeof PluginCapabilitySchema>;
+/**
+ * Rendering slot that determines where a panel appears in the UI.
+ *
+ * - `operator`: shown in the expanded operator card's live-panel area (default).
+ * - `automation`: shown inside the top-right automation quick-action popover.
+ */
+export declare const PluginPanelSlotSchema: z.ZodEnum<["operator", "automation"]>;
+/**
+ * Rendering slot that determines where a panel appears in the UI.
+ */
+export type PluginPanelSlot = z.infer<typeof PluginPanelSlotSchema>;
+/**
+ * Preferred width hint for plugin-owned panels.
+ *
+ * Hosts may interpret this hint differently per slot. Today the operator-card
+ * host treats `full` as "span the full row on desktop", while automation
+ * popover hosts may choose to ignore it.
+ */
+export declare const PluginPanelWidthSchema: z.ZodEnum<["half", "full"]>;
+/**
+ * Preferred width hint for plugin-owned panels.
+ */
+export type PluginPanelWidth = z.infer<typeof PluginPanelWidthSchema>;
+/**
+ * Declarative definition of a plugin-owned panel in the frontend.
+ *
+ * Panels are passive containers rendered by the host. A plugin sends data into
+ * them through `ctx.ui.send(panelId, data)`. When `component` is `'iframe'`,
+ * the panel renders a custom UI page inside a sandboxed iframe instead.
+ */
+export declare const PluginPanelDescriptorSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    component: z.ZodEnum<["table", "key-value", "chart", "log", "iframe"]>;
+    /** Required when `component` is `'iframe'`. References a page id from `ui.pages`. */
+    pageId: z.ZodOptional<z.ZodString>;
+    /** Where the panel renders. Defaults to `'operator'` (operator card live-panel area). */
+    slot: z.ZodOptional<z.ZodEnum<["operator", "automation"]>>;
+    /** Preferred width hint. Defaults to `'half'`. */
+    width: z.ZodOptional<z.ZodEnum<["half", "full"]>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    title: string;
+    component: "table" | "key-value" | "chart" | "log" | "iframe";
+    pageId?: string | undefined;
+    slot?: "operator" | "automation" | undefined;
+    width?: "full" | "half" | undefined;
+}, {
+    id: string;
+    title: string;
+    component: "table" | "key-value" | "chart" | "log" | "iframe";
+    pageId?: string | undefined;
+    slot?: "operator" | "automation" | undefined;
+    width?: "full" | "half" | undefined;
+}>;
+/**
+ * Declarative definition of a plugin-owned panel in the frontend.
+ */
+export type PluginPanelDescriptor = z.infer<typeof PluginPanelDescriptorSchema>;
+/**
+ * Declarative descriptor for a custom UI page served from a plugin's static
+ * file directory and rendered inside an iframe by the host.
+ *
+ * Pages are registered in `PluginDefinition.ui.pages` and can be consumed by
+ * any host component via `<PluginIframeHost pluginName={...} pageId={...} />`.
+ */
+export declare const PluginUIPageDescriptorSchema: z.ZodObject<{
+    /** Unique page identifier within the plugin (e.g. 'settings', 'dashboard'). */
+    id: z.ZodString;
+    /** Display title (i18n key or literal text). */
+    title: z.ZodString;
+    /** Entry HTML file path relative to the UI directory (e.g. 'settings.html'). */
+    entry: z.ZodString;
+    /** Optional icon identifier. */
+    icon: z.ZodOptional<z.ZodString>;
+    /** Who may access this page through the host iframe bridge. Defaults to admin. */
+    accessScope: z.ZodDefault<z.ZodOptional<z.ZodEnum<["admin", "operator"]>>>;
+    /** Optional resource binding enforced by the host for iframe invoke requests. */
+    resourceBinding: z.ZodDefault<z.ZodOptional<z.ZodEnum<["none", "callsign", "operator"]>>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    title: string;
+    entry: string;
+    accessScope: "operator" | "admin";
+    resourceBinding: "none" | "callsign" | "operator";
+    icon?: string | undefined;
+}, {
+    id: string;
+    title: string;
+    entry: string;
+    icon?: string | undefined;
+    accessScope?: "operator" | "admin" | undefined;
+    resourceBinding?: "none" | "callsign" | "operator" | undefined;
+}>;
+/**
+ * Declarative descriptor for a custom UI page served from a plugin's static
+ * file directory.
+ */
+export type PluginUIPageDescriptor = z.infer<typeof PluginUIPageDescriptorSchema>;
+/**
+ * Declares that a plugin provides custom UI pages hosted in an iframe.
+ */
+export declare const PluginUIConfigSchema: z.ZodObject<{
+    /** Static file directory relative to the plugin root (default: 'ui'). */
+    dir: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    /** Registered custom UI pages. */
+    pages: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        /** Unique page identifier within the plugin (e.g. 'settings', 'dashboard'). */
+        id: z.ZodString;
+        /** Display title (i18n key or literal text). */
+        title: z.ZodString;
+        /** Entry HTML file path relative to the UI directory (e.g. 'settings.html'). */
+        entry: z.ZodString;
+        /** Optional icon identifier. */
+        icon: z.ZodOptional<z.ZodString>;
+        /** Who may access this page through the host iframe bridge. Defaults to admin. */
+        accessScope: z.ZodDefault<z.ZodOptional<z.ZodEnum<["admin", "operator"]>>>;
+        /** Optional resource binding enforced by the host for iframe invoke requests. */
+        resourceBinding: z.ZodDefault<z.ZodOptional<z.ZodEnum<["none", "callsign", "operator"]>>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        title: string;
+        entry: string;
+        accessScope: "operator" | "admin";
+        resourceBinding: "none" | "callsign" | "operator";
+        icon?: string | undefined;
+    }, {
+        id: string;
+        title: string;
+        entry: string;
+        icon?: string | undefined;
+        accessScope?: "operator" | "admin" | undefined;
+        resourceBinding?: "none" | "callsign" | "operator" | undefined;
+    }>, "many">>>;
+}, "strip", z.ZodTypeAny, {
+    dir: string;
+    pages: {
+        id: string;
+        title: string;
+        entry: string;
+        accessScope: "operator" | "admin";
+        resourceBinding: "none" | "callsign" | "operator";
+        icon?: string | undefined;
+    }[];
+}, {
+    dir?: string | undefined;
+    pages?: {
+        id: string;
+        title: string;
+        entry: string;
+        icon?: string | undefined;
+        accessScope?: "operator" | "admin" | undefined;
+        resourceBinding?: "none" | "callsign" | "operator" | undefined;
+    }[] | undefined;
+}>;
+/**
+ * Declares that a plugin provides custom UI pages hosted in an iframe.
+ */
+export type PluginUIConfig = z.infer<typeof PluginUIConfigSchema>;
+/**
+ * Storage scope requested by a plugin.
+ */
+export declare const PluginStorageScopeSchema: z.ZodEnum<["global", "operator"]>;
+/**
+ * Storage scope requested by a plugin.
+ */
+export type PluginStorageScope = z.infer<typeof PluginStorageScopeSchema>;
+/**
+ * Declares which persistent storage scopes the host should provision.
+ */
+export declare const PluginStorageConfigSchema: z.ZodObject<{
+    scopes: z.ZodArray<z.ZodEnum<["global", "operator"]>, "many">;
+}, "strip", z.ZodTypeAny, {
+    scopes: ("operator" | "global")[];
+}, {
+    scopes: ("operator" | "global")[];
+}>;
+/**
+ * Declares which persistent storage scopes the host should provision.
+ */
+export type PluginStorageConfig = z.infer<typeof PluginStorageConfigSchema>;
+/**
+ * Normalized manifest describing a plugin's static metadata and declarations.
+ *
+ * This is effectively the serializable subset of a plugin definition that the
+ * host can expose to management UI and diagnostics.
+ */
+export declare const PluginManifestSchema: z.ZodObject<{
+    name: z.ZodString;
+    version: z.ZodString;
+    type: z.ZodEnum<["strategy", "utility"]>;
+    instanceScope: z.ZodDefault<z.ZodOptional<z.ZodEnum<["operator", "global"]>>>;
+    description: z.ZodOptional<z.ZodString>;
+    permissions: z.ZodOptional<z.ZodArray<z.ZodEnum<["network"]>, "many">>;
+    settings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        type: z.ZodEnum<["boolean", "number", "string", "string[]", "info"]>;
+        default: z.ZodUnknown;
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+        options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            value: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            label: string;
+        }, {
+            value: string;
+            label: string;
+        }>, "many">>;
+        /** 设置作用域：global（所有操作员共享）或 operator（每操作员独立），默认 global */
+        scope: z.ZodDefault<z.ZodOptional<z.ZodEnum<["global", "operator"]>>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "string" | "number" | "boolean" | "string[]" | "info";
+        label: string;
+        scope: "operator" | "global";
+        options?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+        min?: number | undefined;
+        max?: number | undefined;
+        description?: string | undefined;
+        default?: unknown;
+    }, {
+        type: "string" | "number" | "boolean" | "string[]" | "info";
+        label: string;
+        options?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+        min?: number | undefined;
+        max?: number | undefined;
+        description?: string | undefined;
+        default?: unknown;
+        scope?: "operator" | "global" | undefined;
+    }>>>;
+    quickActions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        icon: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        label: string;
+        icon?: string | undefined;
+    }, {
+        id: string;
+        label: string;
+        icon?: string | undefined;
+    }>, "many">>;
+    quickSettings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        settingKey: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        settingKey: string;
+    }, {
+        settingKey: string;
+    }>, "many">>;
+    panels: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        component: z.ZodEnum<["table", "key-value", "chart", "log", "iframe"]>;
+        /** Required when `component` is `'iframe'`. References a page id from `ui.pages`. */
+        pageId: z.ZodOptional<z.ZodString>;
+        /** Where the panel renders. Defaults to `'operator'` (operator card live-panel area). */
+        slot: z.ZodOptional<z.ZodEnum<["operator", "automation"]>>;
+        /** Preferred width hint. Defaults to `'half'`. */
+        width: z.ZodOptional<z.ZodEnum<["half", "full"]>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        title: string;
+        component: "table" | "key-value" | "chart" | "log" | "iframe";
+        pageId?: string | undefined;
+        slot?: "operator" | "automation" | undefined;
+        width?: "full" | "half" | undefined;
+    }, {
+        id: string;
+        title: string;
+        component: "table" | "key-value" | "chart" | "log" | "iframe";
+        pageId?: string | undefined;
+        slot?: "operator" | "automation" | undefined;
+        width?: "full" | "half" | undefined;
+    }>, "many">>;
+    storage: z.ZodOptional<z.ZodObject<{
+        scopes: z.ZodArray<z.ZodEnum<["global", "operator"]>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        scopes: ("operator" | "global")[];
+    }, {
+        scopes: ("operator" | "global")[];
+    }>>;
+    ui: z.ZodOptional<z.ZodObject<{
+        /** Static file directory relative to the plugin root (default: 'ui'). */
+        dir: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        /** Registered custom UI pages. */
+        pages: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+            /** Unique page identifier within the plugin (e.g. 'settings', 'dashboard'). */
+            id: z.ZodString;
+            /** Display title (i18n key or literal text). */
+            title: z.ZodString;
+            /** Entry HTML file path relative to the UI directory (e.g. 'settings.html'). */
+            entry: z.ZodString;
+            /** Optional icon identifier. */
+            icon: z.ZodOptional<z.ZodString>;
+            /** Who may access this page through the host iframe bridge. Defaults to admin. */
+            accessScope: z.ZodDefault<z.ZodOptional<z.ZodEnum<["admin", "operator"]>>>;
+            /** Optional resource binding enforced by the host for iframe invoke requests. */
+            resourceBinding: z.ZodDefault<z.ZodOptional<z.ZodEnum<["none", "callsign", "operator"]>>>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            title: string;
+            entry: string;
+            accessScope: "operator" | "admin";
+            resourceBinding: "none" | "callsign" | "operator";
+            icon?: string | undefined;
+        }, {
+            id: string;
+            title: string;
+            entry: string;
+            icon?: string | undefined;
+            accessScope?: "operator" | "admin" | undefined;
+            resourceBinding?: "none" | "callsign" | "operator" | undefined;
+        }>, "many">>>;
+    }, "strip", z.ZodTypeAny, {
+        dir: string;
+        pages: {
+            id: string;
+            title: string;
+            entry: string;
+            accessScope: "operator" | "admin";
+            resourceBinding: "none" | "callsign" | "operator";
+            icon?: string | undefined;
+        }[];
+    }, {
+        dir?: string | undefined;
+        pages?: {
+            id: string;
+            title: string;
+            entry: string;
+            icon?: string | undefined;
+            accessScope?: "operator" | "admin" | undefined;
+            resourceBinding?: "none" | "callsign" | "operator" | undefined;
+        }[] | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    type: "strategy" | "utility";
+    name: string;
+    version: string;
+    instanceScope: "operator" | "global";
+    description?: string | undefined;
+    ui?: {
+        dir: string;
+        pages: {
+            id: string;
+            title: string;
+            entry: string;
+            accessScope: "operator" | "admin";
+            resourceBinding: "none" | "callsign" | "operator";
+            icon?: string | undefined;
+        }[];
+    } | undefined;
+    permissions?: "network"[] | undefined;
+    settings?: Record<string, {
+        type: "string" | "number" | "boolean" | "string[]" | "info";
+        label: string;
+        scope: "operator" | "global";
+        options?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+        min?: number | undefined;
+        max?: number | undefined;
+        description?: string | undefined;
+        default?: unknown;
+    }> | undefined;
+    quickActions?: {
+        id: string;
+        label: string;
+        icon?: string | undefined;
+    }[] | undefined;
+    quickSettings?: {
+        settingKey: string;
+    }[] | undefined;
+    panels?: {
+        id: string;
+        title: string;
+        component: "table" | "key-value" | "chart" | "log" | "iframe";
+        pageId?: string | undefined;
+        slot?: "operator" | "automation" | undefined;
+        width?: "full" | "half" | undefined;
+    }[] | undefined;
+    storage?: {
+        scopes: ("operator" | "global")[];
+    } | undefined;
+}, {
+    type: "strategy" | "utility";
+    name: string;
+    version: string;
+    description?: string | undefined;
+    ui?: {
+        dir?: string | undefined;
+        pages?: {
+            id: string;
+            title: string;
+            entry: string;
+            icon?: string | undefined;
+            accessScope?: "operator" | "admin" | undefined;
+            resourceBinding?: "none" | "callsign" | "operator" | undefined;
+        }[] | undefined;
+    } | undefined;
+    instanceScope?: "operator" | "global" | undefined;
+    permissions?: "network"[] | undefined;
+    settings?: Record<string, {
+        type: "string" | "number" | "boolean" | "string[]" | "info";
+        label: string;
+        options?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+        min?: number | undefined;
+        max?: number | undefined;
+        description?: string | undefined;
+        default?: unknown;
+        scope?: "operator" | "global" | undefined;
+    }> | undefined;
+    quickActions?: {
+        id: string;
+        label: string;
+        icon?: string | undefined;
+    }[] | undefined;
+    quickSettings?: {
+        settingKey: string;
+    }[] | undefined;
+    panels?: {
+        id: string;
+        title: string;
+        component: "table" | "key-value" | "chart" | "log" | "iframe";
+        pageId?: string | undefined;
+        slot?: "operator" | "automation" | undefined;
+        width?: "full" | "half" | undefined;
+    }[] | undefined;
+    storage?: {
+        scopes: ("operator" | "global")[];
+    } | undefined;
+}>;
+/**
+ * Normalized manifest describing a plugin's static metadata and declarations.
+ */
+export type PluginManifest = z.infer<typeof PluginManifestSchema>;
+/**
+ * Runtime-facing plugin status snapshot exposed to the frontend.
+ *
+ * This extends the static manifest with host state such as whether the plugin
+ * is loaded, enabled, auto-disabled or currently assigned to operators.
+ */
+export declare const PluginStatusSchema: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodEnum<["strategy", "utility"]>;
+    instanceScope: z.ZodDefault<z.ZodOptional<z.ZodEnum<["operator", "global"]>>>;
+    version: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    isBuiltIn: z.ZodBoolean;
+    loaded: z.ZodDefault<z.ZodBoolean>;
+    enabled: z.ZodBoolean;
+    /** 是否被自动禁用（连续错误达到阈值） */
+    autoDisabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    errorCount: z.ZodNumber;
+    lastError: z.ZodOptional<z.ZodString>;
+    /** 仅对 strategy 插件有意义：当前被哪些 operator 选中 */
+    assignedOperatorIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    settings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        type: z.ZodEnum<["boolean", "number", "string", "string[]", "info"]>;
+        default: z.ZodUnknown;
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+        options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            value: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            label: string;
+        }, {
+            value: string;
+            label: string;
+        }>, "many">>;
+        /** 设置作用域：global（所有操作员共享）或 operator（每操作员独立），默认 global */
+        scope: z.ZodDefault<z.ZodOptional<z.ZodEnum<["global", "operator"]>>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "string" | "number" | "boolean" | "string[]" | "info";
+        label: string;
+        scope: "operator" | "global";
+        options?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+        min?: number | undefined;
+        max?: number | undefined;
+        description?: string | undefined;
+        default?: unknown;
+    }, {
+        type: "string" | "number" | "boolean" | "string[]" | "info";
+        label: string;
+        options?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+        min?: number | undefined;
+        max?: number | undefined;
+        description?: string | undefined;
+        default?: unknown;
+        scope?: "operator" | "global" | undefined;
+    }>>>;
+    quickActions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        icon: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        label: string;
+        icon?: string | undefined;
+    }, {
+        id: string;
+        label: string;
+        icon?: string | undefined;
+    }>, "many">>;
+    quickSettings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        settingKey: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        settingKey: string;
+    }, {
+        settingKey: string;
+    }>, "many">>;
+    panels: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        component: z.ZodEnum<["table", "key-value", "chart", "log", "iframe"]>;
+        /** Required when `component` is `'iframe'`. References a page id from `ui.pages`. */
+        pageId: z.ZodOptional<z.ZodString>;
+        /** Where the panel renders. Defaults to `'operator'` (operator card live-panel area). */
+        slot: z.ZodOptional<z.ZodEnum<["operator", "automation"]>>;
+        /** Preferred width hint. Defaults to `'half'`. */
+        width: z.ZodOptional<z.ZodEnum<["half", "full"]>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        title: string;
+        component: "table" | "key-value" | "chart" | "log" | "iframe";
+        pageId?: string | undefined;
+        slot?: "operator" | "automation" | undefined;
+        width?: "full" | "half" | undefined;
+    }, {
+        id: string;
+        title: string;
+        component: "table" | "key-value" | "chart" | "log" | "iframe";
+        pageId?: string | undefined;
+        slot?: "operator" | "automation" | undefined;
+        width?: "full" | "half" | undefined;
+    }>, "many">>;
+    permissions: z.ZodOptional<z.ZodArray<z.ZodEnum<["network"]>, "many">>;
+    capabilities: z.ZodOptional<z.ZodArray<z.ZodEnum<["auto_call_candidate", "auto_call_execution"]>, "many">>;
+    ui: z.ZodOptional<z.ZodObject<{
+        /** Static file directory relative to the plugin root (default: 'ui'). */
+        dir: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        /** Registered custom UI pages. */
+        pages: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+            /** Unique page identifier within the plugin (e.g. 'settings', 'dashboard'). */
+            id: z.ZodString;
+            /** Display title (i18n key or literal text). */
+            title: z.ZodString;
+            /** Entry HTML file path relative to the UI directory (e.g. 'settings.html'). */
+            entry: z.ZodString;
+            /** Optional icon identifier. */
+            icon: z.ZodOptional<z.ZodString>;
+            /** Who may access this page through the host iframe bridge. Defaults to admin. */
+            accessScope: z.ZodDefault<z.ZodOptional<z.ZodEnum<["admin", "operator"]>>>;
+            /** Optional resource binding enforced by the host for iframe invoke requests. */
+            resourceBinding: z.ZodDefault<z.ZodOptional<z.ZodEnum<["none", "callsign", "operator"]>>>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            title: string;
+            entry: string;
+            accessScope: "operator" | "admin";
+            resourceBinding: "none" | "callsign" | "operator";
+            icon?: string | undefined;
+        }, {
+            id: string;
+            title: string;
+            entry: string;
+            icon?: string | undefined;
+            accessScope?: "operator" | "admin" | undefined;
+            resourceBinding?: "none" | "callsign" | "operator" | undefined;
+        }>, "many">>>;
+    }, "strip", z.ZodTypeAny, {
+        dir: string;
+        pages: {
+            id: string;
+            title: string;
+            entry: string;
+            accessScope: "operator" | "admin";
+            resourceBinding: "none" | "callsign" | "operator";
+            icon?: string | undefined;
+        }[];
+    }, {
+        dir?: string | undefined;
+        pages?: {
+            id: string;
+            title: string;
+            entry: string;
+            icon?: string | undefined;
+            accessScope?: "operator" | "admin" | undefined;
+            resourceBinding?: "none" | "callsign" | "operator" | undefined;
+        }[] | undefined;
+    }>>;
+    locales: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>>>;
+}, "strip", z.ZodTypeAny, {
+    type: "strategy" | "utility";
+    name: string;
+    enabled: boolean;
+    version: string;
+    instanceScope: "operator" | "global";
+    isBuiltIn: boolean;
+    loaded: boolean;
+    autoDisabled: boolean;
+    errorCount: number;
+    description?: string | undefined;
+    ui?: {
+        dir: string;
+        pages: {
+            id: string;
+            title: string;
+            entry: string;
+            accessScope: "operator" | "admin";
+            resourceBinding: "none" | "callsign" | "operator";
+            icon?: string | undefined;
+        }[];
+    } | undefined;
+    permissions?: "network"[] | undefined;
+    settings?: Record<string, {
+        type: "string" | "number" | "boolean" | "string[]" | "info";
+        label: string;
+        scope: "operator" | "global";
+        options?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+        min?: number | undefined;
+        max?: number | undefined;
+        description?: string | undefined;
+        default?: unknown;
+    }> | undefined;
+    quickActions?: {
+        id: string;
+        label: string;
+        icon?: string | undefined;
+    }[] | undefined;
+    quickSettings?: {
+        settingKey: string;
+    }[] | undefined;
+    panels?: {
+        id: string;
+        title: string;
+        component: "table" | "key-value" | "chart" | "log" | "iframe";
+        pageId?: string | undefined;
+        slot?: "operator" | "automation" | undefined;
+        width?: "full" | "half" | undefined;
+    }[] | undefined;
+    lastError?: string | undefined;
+    assignedOperatorIds?: string[] | undefined;
+    capabilities?: ("auto_call_candidate" | "auto_call_execution")[] | undefined;
+    locales?: Record<string, Record<string, string>> | undefined;
+}, {
+    type: "strategy" | "utility";
+    name: string;
+    enabled: boolean;
+    version: string;
+    isBuiltIn: boolean;
+    errorCount: number;
+    description?: string | undefined;
+    ui?: {
+        dir?: string | undefined;
+        pages?: {
+            id: string;
+            title: string;
+            entry: string;
+            icon?: string | undefined;
+            accessScope?: "operator" | "admin" | undefined;
+            resourceBinding?: "none" | "callsign" | "operator" | undefined;
+        }[] | undefined;
+    } | undefined;
+    instanceScope?: "operator" | "global" | undefined;
+    permissions?: "network"[] | undefined;
+    settings?: Record<string, {
+        type: "string" | "number" | "boolean" | "string[]" | "info";
+        label: string;
+        options?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+        min?: number | undefined;
+        max?: number | undefined;
+        description?: string | undefined;
+        default?: unknown;
+        scope?: "operator" | "global" | undefined;
+    }> | undefined;
+    quickActions?: {
+        id: string;
+        label: string;
+        icon?: string | undefined;
+    }[] | undefined;
+    quickSettings?: {
+        settingKey: string;
+    }[] | undefined;
+    panels?: {
+        id: string;
+        title: string;
+        component: "table" | "key-value" | "chart" | "log" | "iframe";
+        pageId?: string | undefined;
+        slot?: "operator" | "automation" | undefined;
+        width?: "full" | "half" | undefined;
+    }[] | undefined;
+    loaded?: boolean | undefined;
+    autoDisabled?: boolean | undefined;
+    lastError?: string | undefined;
+    assignedOperatorIds?: string[] | undefined;
+    capabilities?: ("auto_call_candidate" | "auto_call_execution")[] | undefined;
+    locales?: Record<string, Record<string, string>> | undefined;
+}>;
+/**
+ * Runtime-facing plugin status snapshot exposed to the frontend.
+ */
+export type PluginStatus = z.infer<typeof PluginStatusSchema>;
+export declare const PluginSystemStateSchema: z.ZodEnum<["ready", "reloading", "error"]>;
+export type PluginSystemState = z.infer<typeof PluginSystemStateSchema>;
+export declare const PluginSystemSnapshotSchema: z.ZodObject<{
+    state: z.ZodEnum<["ready", "reloading", "error"]>;
+    generation: z.ZodNumber;
+    plugins: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodEnum<["strategy", "utility"]>;
+        instanceScope: z.ZodDefault<z.ZodOptional<z.ZodEnum<["operator", "global"]>>>;
+        version: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        isBuiltIn: z.ZodBoolean;
+        loaded: z.ZodDefault<z.ZodBoolean>;
+        enabled: z.ZodBoolean;
+        /** 是否被自动禁用（连续错误达到阈值） */
+        autoDisabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        errorCount: z.ZodNumber;
+        lastError: z.ZodOptional<z.ZodString>;
+        /** 仅对 strategy 插件有意义：当前被哪些 operator 选中 */
+        assignedOperatorIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        settings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            type: z.ZodEnum<["boolean", "number", "string", "string[]", "info"]>;
+            default: z.ZodUnknown;
+            label: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            min: z.ZodOptional<z.ZodNumber>;
+            max: z.ZodOptional<z.ZodNumber>;
+            options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                value: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                value: string;
+                label: string;
+            }, {
+                value: string;
+                label: string;
+            }>, "many">>;
+            /** 设置作用域：global（所有操作员共享）或 operator（每操作员独立），默认 global */
+            scope: z.ZodDefault<z.ZodOptional<z.ZodEnum<["global", "operator"]>>>;
+        }, "strip", z.ZodTypeAny, {
+            type: "string" | "number" | "boolean" | "string[]" | "info";
+            label: string;
+            scope: "operator" | "global";
+            options?: {
+                value: string;
+                label: string;
+            }[] | undefined;
+            min?: number | undefined;
+            max?: number | undefined;
+            description?: string | undefined;
+            default?: unknown;
+        }, {
+            type: "string" | "number" | "boolean" | "string[]" | "info";
+            label: string;
+            options?: {
+                value: string;
+                label: string;
+            }[] | undefined;
+            min?: number | undefined;
+            max?: number | undefined;
+            description?: string | undefined;
+            default?: unknown;
+            scope?: "operator" | "global" | undefined;
+        }>>>;
+        quickActions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            icon: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            label: string;
+            icon?: string | undefined;
+        }, {
+            id: string;
+            label: string;
+            icon?: string | undefined;
+        }>, "many">>;
+        quickSettings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            settingKey: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            settingKey: string;
+        }, {
+            settingKey: string;
+        }>, "many">>;
+        panels: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            component: z.ZodEnum<["table", "key-value", "chart", "log", "iframe"]>;
+            /** Required when `component` is `'iframe'`. References a page id from `ui.pages`. */
+            pageId: z.ZodOptional<z.ZodString>;
+            /** Where the panel renders. Defaults to `'operator'` (operator card live-panel area). */
+            slot: z.ZodOptional<z.ZodEnum<["operator", "automation"]>>;
+            /** Preferred width hint. Defaults to `'half'`. */
+            width: z.ZodOptional<z.ZodEnum<["half", "full"]>>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            title: string;
+            component: "table" | "key-value" | "chart" | "log" | "iframe";
+            pageId?: string | undefined;
+            slot?: "operator" | "automation" | undefined;
+            width?: "full" | "half" | undefined;
+        }, {
+            id: string;
+            title: string;
+            component: "table" | "key-value" | "chart" | "log" | "iframe";
+            pageId?: string | undefined;
+            slot?: "operator" | "automation" | undefined;
+            width?: "full" | "half" | undefined;
+        }>, "many">>;
+        permissions: z.ZodOptional<z.ZodArray<z.ZodEnum<["network"]>, "many">>;
+        capabilities: z.ZodOptional<z.ZodArray<z.ZodEnum<["auto_call_candidate", "auto_call_execution"]>, "many">>;
+        ui: z.ZodOptional<z.ZodObject<{
+            /** Static file directory relative to the plugin root (default: 'ui'). */
+            dir: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+            /** Registered custom UI pages. */
+            pages: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+                /** Unique page identifier within the plugin (e.g. 'settings', 'dashboard'). */
+                id: z.ZodString;
+                /** Display title (i18n key or literal text). */
+                title: z.ZodString;
+                /** Entry HTML file path relative to the UI directory (e.g. 'settings.html'). */
+                entry: z.ZodString;
+                /** Optional icon identifier. */
+                icon: z.ZodOptional<z.ZodString>;
+                /** Who may access this page through the host iframe bridge. Defaults to admin. */
+                accessScope: z.ZodDefault<z.ZodOptional<z.ZodEnum<["admin", "operator"]>>>;
+                /** Optional resource binding enforced by the host for iframe invoke requests. */
+                resourceBinding: z.ZodDefault<z.ZodOptional<z.ZodEnum<["none", "callsign", "operator"]>>>;
+            }, "strip", z.ZodTypeAny, {
+                id: string;
+                title: string;
+                entry: string;
+                accessScope: "operator" | "admin";
+                resourceBinding: "none" | "callsign" | "operator";
+                icon?: string | undefined;
+            }, {
+                id: string;
+                title: string;
+                entry: string;
+                icon?: string | undefined;
+                accessScope?: "operator" | "admin" | undefined;
+                resourceBinding?: "none" | "callsign" | "operator" | undefined;
+            }>, "many">>>;
+        }, "strip", z.ZodTypeAny, {
+            dir: string;
+            pages: {
+                id: string;
+                title: string;
+                entry: string;
+                accessScope: "operator" | "admin";
+                resourceBinding: "none" | "callsign" | "operator";
+                icon?: string | undefined;
+            }[];
+        }, {
+            dir?: string | undefined;
+            pages?: {
+                id: string;
+                title: string;
+                entry: string;
+                icon?: string | undefined;
+                accessScope?: "operator" | "admin" | undefined;
+                resourceBinding?: "none" | "callsign" | "operator" | undefined;
+            }[] | undefined;
+        }>>;
+        locales: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "strategy" | "utility";
+        name: string;
+        enabled: boolean;
+        version: string;
+        instanceScope: "operator" | "global";
+        isBuiltIn: boolean;
+        loaded: boolean;
+        autoDisabled: boolean;
+        errorCount: number;
+        description?: string | undefined;
+        ui?: {
+            dir: string;
+            pages: {
+                id: string;
+                title: string;
+                entry: string;
+                accessScope: "operator" | "admin";
+                resourceBinding: "none" | "callsign" | "operator";
+                icon?: string | undefined;
+            }[];
+        } | undefined;
+        permissions?: "network"[] | undefined;
+        settings?: Record<string, {
+            type: "string" | "number" | "boolean" | "string[]" | "info";
+            label: string;
+            scope: "operator" | "global";
+            options?: {
+                value: string;
+                label: string;
+            }[] | undefined;
+            min?: number | undefined;
+            max?: number | undefined;
+            description?: string | undefined;
+            default?: unknown;
+        }> | undefined;
+        quickActions?: {
+            id: string;
+            label: string;
+            icon?: string | undefined;
+        }[] | undefined;
+        quickSettings?: {
+            settingKey: string;
+        }[] | undefined;
+        panels?: {
+            id: string;
+            title: string;
+            component: "table" | "key-value" | "chart" | "log" | "iframe";
+            pageId?: string | undefined;
+            slot?: "operator" | "automation" | undefined;
+            width?: "full" | "half" | undefined;
+        }[] | undefined;
+        lastError?: string | undefined;
+        assignedOperatorIds?: string[] | undefined;
+        capabilities?: ("auto_call_candidate" | "auto_call_execution")[] | undefined;
+        locales?: Record<string, Record<string, string>> | undefined;
+    }, {
+        type: "strategy" | "utility";
+        name: string;
+        enabled: boolean;
+        version: string;
+        isBuiltIn: boolean;
+        errorCount: number;
+        description?: string | undefined;
+        ui?: {
+            dir?: string | undefined;
+            pages?: {
+                id: string;
+                title: string;
+                entry: string;
+                icon?: string | undefined;
+                accessScope?: "operator" | "admin" | undefined;
+                resourceBinding?: "none" | "callsign" | "operator" | undefined;
+            }[] | undefined;
+        } | undefined;
+        instanceScope?: "operator" | "global" | undefined;
+        permissions?: "network"[] | undefined;
+        settings?: Record<string, {
+            type: "string" | "number" | "boolean" | "string[]" | "info";
+            label: string;
+            options?: {
+                value: string;
+                label: string;
+            }[] | undefined;
+            min?: number | undefined;
+            max?: number | undefined;
+            description?: string | undefined;
+            default?: unknown;
+            scope?: "operator" | "global" | undefined;
+        }> | undefined;
+        quickActions?: {
+            id: string;
+            label: string;
+            icon?: string | undefined;
+        }[] | undefined;
+        quickSettings?: {
+            settingKey: string;
+        }[] | undefined;
+        panels?: {
+            id: string;
+            title: string;
+            component: "table" | "key-value" | "chart" | "log" | "iframe";
+            pageId?: string | undefined;
+            slot?: "operator" | "automation" | undefined;
+            width?: "full" | "half" | undefined;
+        }[] | undefined;
+        loaded?: boolean | undefined;
+        autoDisabled?: boolean | undefined;
+        lastError?: string | undefined;
+        assignedOperatorIds?: string[] | undefined;
+        capabilities?: ("auto_call_candidate" | "auto_call_execution")[] | undefined;
+        locales?: Record<string, Record<string, string>> | undefined;
+    }>, "many">;
+    lastError: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    state: "error" | "ready" | "reloading";
+    generation: number;
+    plugins: {
+        type: "strategy" | "utility";
+        name: string;
+        enabled: boolean;
+        version: string;
+        instanceScope: "operator" | "global";
+        isBuiltIn: boolean;
+        loaded: boolean;
+        autoDisabled: boolean;
+        errorCount: number;
+        description?: string | undefined;
+        ui?: {
+            dir: string;
+            pages: {
+                id: string;
+                title: string;
+                entry: string;
+                accessScope: "operator" | "admin";
+                resourceBinding: "none" | "callsign" | "operator";
+                icon?: string | undefined;
+            }[];
+        } | undefined;
+        permissions?: "network"[] | undefined;
+        settings?: Record<string, {
+            type: "string" | "number" | "boolean" | "string[]" | "info";
+            label: string;
+            scope: "operator" | "global";
+            options?: {
+                value: string;
+                label: string;
+            }[] | undefined;
+            min?: number | undefined;
+            max?: number | undefined;
+            description?: string | undefined;
+            default?: unknown;
+        }> | undefined;
+        quickActions?: {
+            id: string;
+            label: string;
+            icon?: string | undefined;
+        }[] | undefined;
+        quickSettings?: {
+            settingKey: string;
+        }[] | undefined;
+        panels?: {
+            id: string;
+            title: string;
+            component: "table" | "key-value" | "chart" | "log" | "iframe";
+            pageId?: string | undefined;
+            slot?: "operator" | "automation" | undefined;
+            width?: "full" | "half" | undefined;
+        }[] | undefined;
+        lastError?: string | undefined;
+        assignedOperatorIds?: string[] | undefined;
+        capabilities?: ("auto_call_candidate" | "auto_call_execution")[] | undefined;
+        locales?: Record<string, Record<string, string>> | undefined;
+    }[];
+    lastError?: string | undefined;
+}, {
+    state: "error" | "ready" | "reloading";
+    generation: number;
+    plugins: {
+        type: "strategy" | "utility";
+        name: string;
+        enabled: boolean;
+        version: string;
+        isBuiltIn: boolean;
+        errorCount: number;
+        description?: string | undefined;
+        ui?: {
+            dir?: string | undefined;
+            pages?: {
+                id: string;
+                title: string;
+                entry: string;
+                icon?: string | undefined;
+                accessScope?: "operator" | "admin" | undefined;
+                resourceBinding?: "none" | "callsign" | "operator" | undefined;
+            }[] | undefined;
+        } | undefined;
+        instanceScope?: "operator" | "global" | undefined;
+        permissions?: "network"[] | undefined;
+        settings?: Record<string, {
+            type: "string" | "number" | "boolean" | "string[]" | "info";
+            label: string;
+            options?: {
+                value: string;
+                label: string;
+            }[] | undefined;
+            min?: number | undefined;
+            max?: number | undefined;
+            description?: string | undefined;
+            default?: unknown;
+            scope?: "operator" | "global" | undefined;
+        }> | undefined;
+        quickActions?: {
+            id: string;
+            label: string;
+            icon?: string | undefined;
+        }[] | undefined;
+        quickSettings?: {
+            settingKey: string;
+        }[] | undefined;
+        panels?: {
+            id: string;
+            title: string;
+            component: "table" | "key-value" | "chart" | "log" | "iframe";
+            pageId?: string | undefined;
+            slot?: "operator" | "automation" | undefined;
+            width?: "full" | "half" | undefined;
+        }[] | undefined;
+        loaded?: boolean | undefined;
+        autoDisabled?: boolean | undefined;
+        lastError?: string | undefined;
+        assignedOperatorIds?: string[] | undefined;
+        capabilities?: ("auto_call_candidate" | "auto_call_execution")[] | undefined;
+        locales?: Record<string, Record<string, string>> | undefined;
+    }[];
+    lastError?: string | undefined;
+}>;
+export type PluginSystemSnapshot = z.infer<typeof PluginSystemSnapshotSchema>;
+export declare const PluginDistributionSchema: z.ZodEnum<["electron", "docker", "linux-service", "generic-server", "web-dev"]>;
+export type PluginDistribution = z.infer<typeof PluginDistributionSchema>;
+export declare const PluginRuntimeInfoSchema: z.ZodObject<{
+    pluginDir: z.ZodString;
+    pluginDataDir: z.ZodString;
+    dataDir: z.ZodString;
+    configDir: z.ZodString;
+    logsDir: z.ZodString;
+    cacheDir: z.ZodString;
+    distribution: z.ZodEnum<["electron", "docker", "linux-service", "generic-server", "web-dev"]>;
+    hostPluginDirHint: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    pluginDir: string;
+    pluginDataDir: string;
+    dataDir: string;
+    configDir: string;
+    logsDir: string;
+    cacheDir: string;
+    distribution: "electron" | "docker" | "linux-service" | "generic-server" | "web-dev";
+    hostPluginDirHint?: string | undefined;
+}, {
+    pluginDir: string;
+    pluginDataDir: string;
+    dataDir: string;
+    configDir: string;
+    logsDir: string;
+    cacheDir: string;
+    distribution: "electron" | "docker" | "linux-service" | "generic-server" | "web-dev";
+    hostPluginDirHint?: string | undefined;
+}>;
+export type PluginRuntimeInfo = z.infer<typeof PluginRuntimeInfoSchema>;
+/**
+ * 单个插件的持久化配置
+ */
+export declare const PluginConfigEntrySchema: z.ZodObject<{
+    enabled: z.ZodBoolean;
+    settings: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    enabled: boolean;
+    settings: Record<string, unknown>;
+}, {
+    enabled: boolean;
+    settings: Record<string, unknown>;
+}>;
+export type PluginConfigEntry = z.infer<typeof PluginConfigEntrySchema>;
+/**
+ * 所有插件的持久化配置
+ */
+export declare const PluginsConfigSchema: z.ZodObject<{
+    /** 全局插件配置（enabled 状态 + global scope settings） */
+    configs: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        enabled: z.ZodBoolean;
+        settings: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        settings: Record<string, unknown>;
+    }, {
+        enabled: boolean;
+        settings: Record<string, unknown>;
+    }>>>>;
+    /** 每操作员的策略插件选择 */
+    operatorStrategies: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>>;
+    /** 每操作员的 operator scope plugin settings：operatorId → pluginName → settings */
+    operatorSettings: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>>>;
+}, "strip", z.ZodTypeAny, {
+    configs: Record<string, {
+        enabled: boolean;
+        settings: Record<string, unknown>;
+    }>;
+    operatorStrategies: Record<string, string>;
+    operatorSettings: Record<string, Record<string, Record<string, unknown>>>;
+}, {
+    configs?: Record<string, {
+        enabled: boolean;
+        settings: Record<string, unknown>;
+    }> | undefined;
+    operatorStrategies?: Record<string, string> | undefined;
+    operatorSettings?: Record<string, Record<string, Record<string, unknown>>> | undefined;
+}>;
+export type PluginsConfig = z.infer<typeof PluginsConfigSchema>;
+/**
+ * 插件数据推送载荷（ctx.ui.send() 发送到前端）
+ */
+export declare const PluginDataPayloadSchema: z.ZodObject<{
+    pluginName: z.ZodString;
+    operatorId: z.ZodString;
+    panelId: z.ZodString;
+    data: z.ZodUnknown;
+}, "strip", z.ZodTypeAny, {
+    operatorId: string;
+    pluginName: string;
+    panelId: string;
+    data?: unknown;
+}, {
+    operatorId: string;
+    pluginName: string;
+    panelId: string;
+    data?: unknown;
+}>;
+export type PluginDataPayload = z.infer<typeof PluginDataPayloadSchema>;
+/**
+ * 插件日志条目
+ */
+export declare const PluginLogEntrySchema: z.ZodObject<{
+    pluginName: z.ZodString;
+    level: z.ZodEnum<["debug", "info", "warn", "error"]>;
+    message: z.ZodString;
+    data: z.ZodOptional<z.ZodUnknown>;
+    timestamp: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+    timestamp: number;
+    pluginName: string;
+    level: "error" | "info" | "debug" | "warn";
+    data?: unknown;
+}, {
+    message: string;
+    timestamp: number;
+    pluginName: string;
+    level: "error" | "info" | "debug" | "warn";
+    data?: unknown;
+}>;
+export type PluginLogEntry = z.infer<typeof PluginLogEntrySchema>;
+export declare const PluginRuntimeLogStageSchema: z.ZodEnum<["scan", "load", "validate", "reload", "activate"]>;
+export type PluginRuntimeLogStage = z.infer<typeof PluginRuntimeLogStageSchema>;
+/**
+ * 宿主级插件运行日志条目
+ */
+export declare const PluginRuntimeLogEntrySchema: z.ZodObject<{
+    source: z.ZodLiteral<"system">;
+    stage: z.ZodEnum<["scan", "load", "validate", "reload", "activate"]>;
+    level: z.ZodEnum<["debug", "info", "warn", "error"]>;
+    message: z.ZodString;
+    timestamp: z.ZodNumber;
+    pluginName: z.ZodOptional<z.ZodString>;
+    directoryName: z.ZodOptional<z.ZodString>;
+    details: z.ZodOptional<z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+    timestamp: number;
+    level: "error" | "info" | "debug" | "warn";
+    source: "system";
+    stage: "scan" | "load" | "validate" | "reload" | "activate";
+    pluginName?: string | undefined;
+    directoryName?: string | undefined;
+    details?: unknown;
+}, {
+    message: string;
+    timestamp: number;
+    level: "error" | "info" | "debug" | "warn";
+    source: "system";
+    stage: "scan" | "load" | "validate" | "reload" | "activate";
+    pluginName?: string | undefined;
+    directoryName?: string | undefined;
+    details?: unknown;
+}>;
+export type PluginRuntimeLogEntry = z.infer<typeof PluginRuntimeLogEntrySchema>;
+/**
+ * 宿主级插件运行日志历史响应载荷
+ */
+export declare const PluginRuntimeLogHistoryPayloadSchema: z.ZodObject<{
+    entries: z.ZodArray<z.ZodObject<{
+        source: z.ZodLiteral<"system">;
+        stage: z.ZodEnum<["scan", "load", "validate", "reload", "activate"]>;
+        level: z.ZodEnum<["debug", "info", "warn", "error"]>;
+        message: z.ZodString;
+        timestamp: z.ZodNumber;
+        pluginName: z.ZodOptional<z.ZodString>;
+        directoryName: z.ZodOptional<z.ZodString>;
+        details: z.ZodOptional<z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        message: string;
+        timestamp: number;
+        level: "error" | "info" | "debug" | "warn";
+        source: "system";
+        stage: "scan" | "load" | "validate" | "reload" | "activate";
+        pluginName?: string | undefined;
+        directoryName?: string | undefined;
+        details?: unknown;
+    }, {
+        message: string;
+        timestamp: number;
+        level: "error" | "info" | "debug" | "warn";
+        source: "system";
+        stage: "scan" | "load" | "validate" | "reload" | "activate";
+        pluginName?: string | undefined;
+        directoryName?: string | undefined;
+        details?: unknown;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    entries: {
+        message: string;
+        timestamp: number;
+        level: "error" | "info" | "debug" | "warn";
+        source: "system";
+        stage: "scan" | "load" | "validate" | "reload" | "activate";
+        pluginName?: string | undefined;
+        directoryName?: string | undefined;
+        details?: unknown;
+    }[];
+}, {
+    entries: {
+        message: string;
+        timestamp: number;
+        level: "error" | "info" | "debug" | "warn";
+        source: "system";
+        stage: "scan" | "load" | "validate" | "reload" | "activate";
+        pluginName?: string | undefined;
+        directoryName?: string | undefined;
+        details?: unknown;
+    }[];
+}>;
+export type PluginRuntimeLogHistoryPayload = z.infer<typeof PluginRuntimeLogHistoryPayloadSchema>;
+/**
+ * 插件用户操作载荷（前端 → 后端）
+ */
+export declare const PluginUserActionPayloadSchema: z.ZodObject<{
+    pluginName: z.ZodString;
+    actionId: z.ZodString;
+    operatorId: z.ZodOptional<z.ZodString>;
+    payload: z.ZodOptional<z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    pluginName: string;
+    actionId: string;
+    operatorId?: string | undefined;
+    payload?: unknown;
+}, {
+    pluginName: string;
+    actionId: string;
+    operatorId?: string | undefined;
+    payload?: unknown;
+}>;
+export type PluginUserActionPayload = z.infer<typeof PluginUserActionPayloadSchema>;
+/**
+ * 操作员维度的插件设置更新载荷
+ */
+export declare const PluginOperatorSettingsPayloadSchema: z.ZodObject<{
+    pluginName: z.ZodString;
+    operatorId: z.ZodString;
+    settings: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    operatorId: string;
+    settings: Record<string, unknown>;
+    pluginName: string;
+}, {
+    operatorId: string;
+    settings: Record<string, unknown>;
+    pluginName: string;
+}>;
+export type PluginOperatorSettingsPayload = z.infer<typeof PluginOperatorSettingsPayloadSchema>;
+//# sourceMappingURL=plugin.schema.d.ts.map