@forgeax/interface 0.4.1

package/dist/package/browser/components/Bus/CapabilityOverview.d.ts

@@ -0,0 +1,3 @@
+export declare function CapabilityOverview({ refreshKey }: {
+    refreshKey: number;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/package/browser/components/Bus/CapabilityOverview.js

@@ -0,0 +1,50 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useMemo, useState } from 'react';
+import { listSharedCapabilities, } from '../../lib/extension-api';
+const KIND_ORDER = ['skill', 'command', 'mcp', 'extension', 'memory', 'tool'];
+const KIND_LABELS = {
+    skill: 'Skill',
+    command: 'Command',
+    mcp: 'MCP',
+    extension: 'Plugin',
+    memory: 'Memory',
+    tool: 'Tool',
+};
+function originLabel(capability) {
+    return `${capability.origin}/${capability.trustTier}`;
+}
+export function CapabilityOverview({ refreshKey }) {
+    const [capabilities, setCapabilities] = useState([]);
+    const [generation, setGeneration] = useState(0);
+    const [issues, setIssues] = useState([]);
+    useEffect(() => {
+        let cancelled = false;
+        void listSharedCapabilities()
+            .then((result) => {
+            if (cancelled)
+                return;
+            setCapabilities(result.capabilities);
+            setGeneration(result.generation);
+            setIssues(result.issues);
+        })
+            .catch(() => {
+            if (!cancelled) {
+                setCapabilities([]);
+                setIssues(['Capability snapshot unavailable']);
+            }
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [refreshKey]);
+    const counts = useMemo(() => {
+        const result = new Map();
+        for (const kind of KIND_ORDER)
+            result.set(kind, 0);
+        for (const capability of capabilities) {
+            result.set(capability.kind, (result.get(capability.kind) ?? 0) + 1);
+        }
+        return result;
+    }, [capabilities]);
+    return (_jsxs("section", { className: "ba-capability-overview", "aria-label": "Shared capabilities", children: [_jsxs("div", { className: "ba-capability-head", children: [_jsx("span", { className: "ba-capability-dot", "aria-hidden": true }), _jsx("span", { className: "ba-capability-label", children: "Shared capabilities" }), _jsx("span", { className: "ba-capability-count", children: capabilities.length }), _jsxs("span", { className: "ba-capability-generation", children: ["generation ", generation] })] }), _jsx("div", { className: "ba-capability-kinds", role: "list", "aria-label": "Capability kinds", children: KIND_ORDER.map((kind) => (_jsxs("span", { className: `ba-capability-kind ba-capability-kind-${kind}`, role: "listitem", children: [_jsx("span", { children: KIND_LABELS[kind] }), _jsx("strong", { children: counts.get(kind) ?? 0 })] }, kind))) }), capabilities.length > 0 && (_jsx("div", { className: "ba-capability-list", children: capabilities.map((capability) => (_jsxs("div", { className: "ba-capability-row", children: [_jsx("span", { className: `ba-capability-type ba-capability-kind-${capability.kind}`, children: KIND_LABELS[capability.kind] }), _jsx("code", { className: "ba-capability-id", children: capability.localId }), _jsx("span", { className: "ba-capability-extension", children: capability.extensionId }), _jsxs("span", { className: "ba-capability-version", children: ["v", capability.extensionVersion] }), _jsx("span", { className: `ba-capability-state is-${capability.lifecycle.state}`, children: capability.lifecycle.state }), _jsx("span", { className: "ba-capability-origin", children: originLabel(capability) }), capability.lifecycle.requiresRestart && (_jsx("span", { className: "ba-capability-restart", children: "restart" }))] }, capability.capabilityId))) })), issues.length > 0 && (_jsxs("div", { className: "ba-capability-issues", role: "status", children: [issues.length, " capability issue", issues.length === 1 ? '' : 's', " \u2014 open the snapshot API for details"] }))] }));
+}

package/dist/package/browser/components/ChatColumn/ChatColumn.d.ts

@@ -0,0 +1,2 @@
+import type { ReactElement } from 'react';
+export declare function ChatColumn(): ReactElement | null;

package/dist/package/browser/components/ChatColumn/ChatColumn.js

@@ -0,0 +1,18 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { AnchoredResizeHandle } from '@forgeax/app-shell/react';
+import { usePanelRenderers } from '../DockShell/panelRenderers';
+import { DockPanelHost } from '../DockShell/DockPanelHost';
+import { useShellStore } from '../../store';
+import { chatWidthStore, useChatWidth } from './useChatWidth';
+// Fixed shell-level chat column (right of the ActivityRail). Chat was pulled out
+// of the dockview so a shell rail can sit immediately to its left; this keeps it
+// drag-resizable via a left-edge handle. Product geometry and styling stay here;
+// App Shell owns the generic anchored pointer lifecycle.
+export function ChatColumn() {
+    const hasChat = !!usePanelRenderers().panels?.chat;
+    const collapsed = useShellStore((s) => s.chatpanelCollapsed);
+    const width = useChatWidth();
+    if (!hasChat || collapsed)
+        return null;
+    return (_jsxs("aside", { className: "studio-chat-col", "data-fx-slot": "ChatColumn", "data-tour-id": "chat", style: { width }, children: [_jsx(AnchoredResizeHandle, { orientation: "col", className: "fx-chat-resizer", ariaLabel: "Resize chat panel", direction: "subtract", readSize: chatWidthStore.getSnapshot, writeSize: chatWidthStore.setSize, resizingBodyClassName: "fx-chat-resizing" }), _jsx(DockPanelHost, { id: "chat" })] }));
+}

package/dist/package/browser/components/ChatColumn/SessionTabStrip.d.ts

@@ -0,0 +1 @@
+export declare function SessionTabStrip(): import("react/jsx-runtime").JSX.Element;

package/dist/package/browser/components/ChatColumn/SessionTabStrip.js

@@ -0,0 +1,103 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useMemo, useRef, useState } from 'react';
+import { History, MessageSquare, Plus, X } from 'lucide-react';
+import { Popover, PopoverContent, PopoverTrigger } from '../ui/popover';
+import { useTranslation } from '../../i18n';
+import { tabLabel, useShellStore } from '../../store';
+import { confirmDialog } from '../../lib/dialog';
+import { formatSessionTime } from '../../lib/session-time';
+export function SessionTabStrip() {
+    const { t } = useTranslation();
+    const tabs = useShellStore((state) => state.tabs);
+    const activeSid = useShellStore((state) => state.activeSid);
+    const activeGameSlug = useShellStore((state) => state.activeGameSlug);
+    const switchToSession = useShellStore((state) => state.switchToSession);
+    const closeSession = useShellStore((state) => state.closeSession);
+    const createNewSession = useShellStore((state) => state.createNewSession);
+    const refreshSessions = useShellStore((state) => state.refreshSessions);
+    const [historyOpen, setHistoryOpen] = useState(false);
+    const [creating, setCreating] = useState(false);
+    const [closingSid, setClosingSid] = useState(null);
+    const tabListRef = useRef(null);
+    const activeTabRef = useRef(null);
+    useEffect(() => {
+        activeTabRef.current?.scrollIntoView?.({ block: 'nearest', inline: 'nearest' });
+    }, [activeSid]);
+    useEffect(() => {
+        if (!historyOpen)
+            return;
+        void refreshSessions();
+    }, [activeGameSlug, historyOpen, refreshSessions]);
+    const sortedHistory = useMemo(() => {
+        const now = Date.now();
+        return [...tabs].sort((a, b) => {
+            const aTime = a.lastActivityAt ?? now;
+            const bTime = b.lastActivityAt ?? now;
+            if (aTime !== bTime)
+                return bTime - aTime;
+            return a.sid.localeCompare(b.sid);
+        });
+    }, [historyOpen, tabs]);
+    const selectSession = async (sid, closeHistory = false) => {
+        if (sid !== activeSid)
+            await switchToSession(sid);
+        if (closeHistory)
+            setHistoryOpen(false);
+    };
+    const createSession = async () => {
+        if (creating)
+            return;
+        setCreating(true);
+        try {
+            await createNewSession({ scope: activeGameSlug ?? undefined });
+        }
+        finally {
+            setCreating(false);
+        }
+    };
+    const deleteSession = async (sid, label) => {
+        if (closingSid)
+            return;
+        const confirmed = await confirmDialog({
+            body: t('sessionTabs.closeConfirm', { label }),
+            danger: true,
+        });
+        if (!confirmed)
+            return;
+        setClosingSid(sid);
+        try {
+            await closeSession(sid);
+        }
+        finally {
+            setClosingSid(null);
+        }
+    };
+    const moveFocus = (event, sid) => {
+        if (!['ArrowLeft', 'ArrowRight', 'Home', 'End'].includes(event.key))
+            return;
+        const tabButtons = [...(tabListRef.current?.querySelectorAll('[role="tab"]') ?? [])];
+        if (tabButtons.length === 0)
+            return;
+        const index = Math.max(0, tabs.findIndex((tab) => tab.sid === sid));
+        const nextIndex = event.key === 'Home'
+            ? 0
+            : event.key === 'End'
+                ? tabButtons.length - 1
+                : (index + (event.key === 'ArrowRight' ? 1 : -1) + tabButtons.length) % tabButtons.length;
+        event.preventDefault();
+        tabButtons[nextIndex]?.focus();
+        // Manual activation: arrows only move focus. Enter/Space/click activates
+        // the focused button, avoiding overlapping async switchToSession calls
+        // whose provider reconciliation can resolve out of order.
+    };
+    return (_jsxs("div", { className: "chat-session-tabs", "data-testid": "chat-session-tabs", children: [_jsx("div", { ref: tabListRef, className: "chat-session-tab-list", role: "tablist", "aria-label": t('sessionTabs.historyTitle'), children: tabs.map((tab) => {
+                    const active = tab.sid === activeSid;
+                    const label = tabLabel(tab);
+                    return (_jsxs("div", { ref: active ? activeTabRef : undefined, className: `chat-session-tab${active ? ' is-active' : ''}`, "data-session-id": tab.sid, children: [_jsx("button", { type: "button", className: "chat-session-tab-button no-motion-lift", role: "tab", "aria-selected": active, tabIndex: active ? 0 : -1, title: label, onClick: () => void selectSession(tab.sid), onKeyDown: (event) => moveFocus(event, tab.sid), children: _jsx("span", { className: "chat-session-tab-label", children: label }) }), active && (_jsx("button", { type: "button", className: "chat-session-tab-close no-motion-lift", "aria-label": t('sessionTabs.closeTab', { label }), title: t('sessionTabs.closeTab', { label }), disabled: closingSid === tab.sid, onClick: () => void deleteSession(tab.sid, label), children: _jsx(X, { size: 13 }) }))] }, tab.sid));
+                }) }), _jsxs("div", { className: "chat-session-tab-tools", children: [_jsx("button", { type: "button", className: "chat-session-tab-tool no-motion-lift", "aria-label": t('sessionTabs.newSession'), title: t('sessionTabs.newSession'), disabled: creating, onClick: () => void createSession(), children: _jsx(Plus, { size: 16 }) }), _jsxs(Popover, { open: historyOpen, onOpenChange: setHistoryOpen, children: [_jsx(PopoverTrigger, { asChild: true, children: _jsx("button", { type: "button", className: `chat-session-tab-tool no-motion-lift${historyOpen ? ' is-active' : ''}`, "aria-label": t('sessionTabs.history'), title: t('sessionTabs.history'), "aria-expanded": historyOpen, children: _jsx(History, { size: 16 }) }) }), _jsx(PopoverContent, { align: "end", sideOffset: 6, className: "w-auto border-0 bg-transparent p-0 shadow-none", children: _jsxs("div", { className: "chat-session-history", "data-testid": "chat-session-history", children: [_jsxs("div", { className: "chat-session-history-title", children: [_jsx(History, { size: 16 }), _jsx("span", { children: t('sessionTabs.historyTitle') })] }), _jsxs("div", { className: "chat-session-history-list", children: [sortedHistory.length === 0 && (_jsx("div", { className: "chat-session-history-empty", children: t('sessionTabs.empty') })), sortedHistory.map((tab) => {
+                                                    const label = tabLabel(tab);
+                                                    const time = formatSessionTime(tab.lastActivityAt);
+                                                    const active = tab.sid === activeSid;
+                                                    return (_jsxs("button", { type: "button", className: `chat-session-history-row no-motion-lift${active ? ' is-active' : ''}`, "data-session-id": tab.sid, "aria-current": active ? 'true' : undefined, onClick: () => void selectSession(tab.sid, true), children: [_jsx(MessageSquare, { size: 15 }), _jsx("span", { className: "chat-session-history-name", children: label }), time && _jsx("span", { className: "chat-session-history-time", children: time })] }, tab.sid));
+                                                })] })] }) })] })] })] }));
+}

package/dist/package/browser/components/ChatColumn/useChatWidth.d.ts

@@ -0,0 +1,5 @@
+export declare const CHAT_MIN_WIDTH = 280;
+export declare const CHAT_MAX_WIDTH = 720;
+export declare const CHAT_DEFAULT_WIDTH = 360;
+export declare const chatWidthStore: import("@forgeax/app-shell/react").PersistentSizeStore;
+export declare function useChatWidth(): number;

package/dist/package/browser/components/ChatColumn/useChatWidth.js

@@ -0,0 +1,13 @@
+import { createPersistentSizeStore, usePersistentSizeStore, } from '@forgeax/app-shell/react';
+export const CHAT_MIN_WIDTH = 280;
+export const CHAT_MAX_WIDTH = 720;
+export const CHAT_DEFAULT_WIDTH = 360;
+export const chatWidthStore = createPersistentSizeStore({
+    storageKey: 'forgeax:chat-width',
+    defaultSize: CHAT_DEFAULT_WIDTH,
+    minSize: CHAT_MIN_WIDTH,
+    maxSize: CHAT_MAX_WIDTH,
+});
+export function useChatWidth() {
+    return usePersistentSizeStore(chatWidthStore);
+}

package/dist/package/browser/components/CommandPalette/CommandPalette.css

@@ -0,0 +1,199 @@
+/* CommandPalette (cmdk) — 与 studio 暗色基调一致的最小样式。 */
+.fx-cmdk-overlay {
+  position: fixed;
+  inset: 0;
+  z-index: 1000;
+  background: rgba(0, 0, 0, 0.45);
+  display: flex;
+  align-items: flex-start;
+  justify-content: center;
+  padding-top: 12vh;
+}
+.fx-cmdk-panel {
+  width: min(560px, 92vw);
+  background: var(--panel-bg, #1e1e2e);
+  color: var(--panel-fg, #e0e0f0);
+  border: 1px solid rgba(120, 120, 160, 0.35);
+  border-radius: 10px;
+  box-shadow: 0 18px 50px rgba(0, 0, 0, 0.5);
+  overflow: hidden;
+}
+.fx-cmdk-panel [cmdk-input] {
+  width: 100%;
+  box-sizing: border-box;
+  padding: 12px 14px;
+  font-size: 14px;
+  background: transparent;
+  color: inherit;
+  border: none;
+  border-bottom: 1px solid rgba(120, 120, 160, 0.25);
+  outline: none;
+}
+.fx-cmdk-panel [cmdk-list] {
+  max-height: 46vh;
+  overflow-y: auto;
+  padding: 6px;
+}
+.fx-cmdk-panel [cmdk-item] {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 12px;
+  padding: 8px 10px;
+  border-radius: 6px;
+  font-size: 13px;
+  cursor: pointer;
+}
+.fx-cmdk-panel [cmdk-item][data-selected='true'] {
+  background: rgba(99, 102, 241, 0.25);
+}
+.fx-cmdk-panel [cmdk-item][data-disabled='true'] {
+  opacity: 0.45;
+  cursor: default;
+}
+.fx-cmdk-panel [cmdk-group-heading] {
+  padding: 8px 10px 2px;
+  font-size: 11px;
+  opacity: 0.6;
+}
+.fx-cmdk-panel [cmdk-empty] {
+  padding: 14px;
+  font-size: 13px;
+  opacity: 0.7;
+}
+.fx-cmdk-id,
+.fx-cmdk-reason {
+  font-size: 11px;
+  opacity: 0.55;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  max-width: 45%;
+}
+
+/* ── 参数引导子界面 ─────────────────────────────────────────────────────── */
+.fx-cmdk-form-head {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  padding: 10px 14px;
+  border-bottom: 1px solid rgba(120, 120, 160, 0.25);
+}
+.fx-cmdk-back {
+  background: transparent;
+  color: inherit;
+  border: 1px solid rgba(120, 120, 160, 0.35);
+  border-radius: 6px;
+  padding: 3px 8px;
+  font-size: 12px;
+  cursor: pointer;
+}
+.fx-cmdk-back:hover {
+  background: rgba(120, 120, 160, 0.15);
+}
+.fx-cmdk-form-head .fx-cmdk-title {
+  font-size: 14px;
+  font-weight: 600;
+}
+.fx-cmdk-guide {
+  margin: 0;
+  padding: 10px 14px;
+  font-size: 12px;
+  line-height: 1.5;
+  opacity: 0.75;
+  border-bottom: 1px solid rgba(120, 120, 160, 0.15);
+}
+.fx-cmdk-form {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+  padding: 12px 14px;
+  max-height: 52vh;
+  overflow-y: auto;
+}
+.fx-cmdk-field {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+}
+.fx-cmdk-field-label {
+  display: flex;
+  align-items: baseline;
+  gap: 8px;
+  font-size: 13px;
+  font-weight: 500;
+}
+.fx-cmdk-req {
+  color: #f87171;
+  font-style: normal;
+}
+.fx-cmdk-field-hint {
+  font-size: 11px;
+  opacity: 0.55;
+  font-weight: 400;
+}
+.fx-cmdk-field-desc {
+  font-size: 11px;
+  opacity: 0.6;
+  line-height: 1.4;
+}
+.fx-cmdk-form input,
+.fx-cmdk-form select,
+.fx-cmdk-form textarea {
+  width: 100%;
+  box-sizing: border-box;
+  background: rgba(0, 0, 0, 0.25);
+  color: inherit;
+  border: 1px solid rgba(120, 120, 160, 0.35);
+  border-radius: 6px;
+  padding: 7px 9px;
+  font-size: 13px;
+  font-family: inherit;
+  outline: none;
+}
+.fx-cmdk-form input:focus,
+.fx-cmdk-form select:focus,
+.fx-cmdk-form textarea:focus {
+  border-color: rgba(99, 102, 241, 0.7);
+}
+.fx-cmdk-form textarea {
+  resize: vertical;
+}
+.fx-cmdk-form-actions {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 10px;
+  padding-top: 4px;
+}
+.fx-cmdk-form-tip {
+  font-size: 11px;
+  opacity: 0.5;
+}
+.fx-cmdk-run {
+  background: rgba(99, 102, 241, 0.85);
+  color: #fff;
+  border: none;
+  border-radius: 6px;
+  padding: 7px 18px;
+  font-size: 13px;
+  cursor: pointer;
+}
+.fx-cmdk-run:hover {
+  background: rgba(99, 102, 241, 1);
+}
+.fx-cmdk-feedback {
+  margin: 0 14px 12px;
+  padding: 8px 10px;
+  border-radius: 6px;
+  font-size: 12px;
+  line-height: 1.4;
+}
+.fx-cmdk-feedback--ok {
+  background: rgba(34, 197, 94, 0.16);
+  color: #86efac;
+}
+.fx-cmdk-feedback--err {
+  background: rgba(248, 113, 113, 0.16);
+  color: #fca5a5;
+}

package/dist/package/browser/components/CommandPalette/CommandPalette.d.ts

@@ -0,0 +1,2 @@
+import './CommandPalette.css';
+export declare function CommandPalette(): import("react/jsx-runtime").JSX.Element | null;

package/dist/package/browser/components/CommandPalette/CommandPalette.js

@@ -0,0 +1,242 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/** CommandPalette —— cmdk 命令面板(P2-15,激活死依赖)。
+ *
+ *  数据源 = ActionRegistry(与按钮 / AI 同一张注册表,压缩公理:一表三消费者)。
+ *  执行走 `dispatchAction` 单入口(source:'human')。Ctrl/⌘+K 开合。
+ *
+ *  两段式(P2-16):选中带参数的 action 不再盲发空参被静默拒,而是进「参数引导」
+ *  子界面——用 action 的 description 作使用说明,按 schema 逐字段给输入(enum 下拉 /
+ *  布尔 / 数字 / 文本),提交后校验通过再派发。无参 action 直接执行。任何结果
+ *  (完成 / 受理 / 被拒原因)都在面板内回显,不再「点了没反应」。
+ */
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { Command } from 'cmdk';
+import { createRestartableTimeoutTaskLifecycle } from '@forgeax/app-shell/react';
+import { dispatchAction, getAction, snapshotActions, } from '../../lib/action-registry';
+import { setCommandPaletteOpen, useCommandPaletteOpen } from '../../lib/command-palette-store';
+import './CommandPalette.css';
+/** 从 action 的 JSON Schema 派生顶层参数清单(与 registry 的 validateArgs 同口径)。 */
+function paramsOf(def) {
+    const schema = def.schema;
+    if (!schema || typeof schema !== 'object')
+        return [];
+    const props = schema.properties && typeof schema.properties === 'object'
+        ? schema.properties
+        : {};
+    const required = new Set(Array.isArray(schema.required) ? schema.required.filter((k) => typeof k === 'string') : []);
+    return Object.entries(props).map(([key, p]) => ({
+        key,
+        type: typeof p?.type === 'string' ? p.type : undefined,
+        enum: Array.isArray(p?.enum) ? p.enum : undefined,
+        description: typeof p?.description === 'string' ? p.description : undefined,
+        required: required.has(key),
+    }));
+}
+/** 把表单里的字符串按声明类型转回 JS 值(布尔 / 数字 / JSON),供派发。 */
+function coerce(raw, type) {
+    if (type === 'number' || type === 'integer') {
+        const n = Number(raw);
+        if (raw.trim() === '' || Number.isNaN(n))
+            return { ok: false, err: '需要数字' };
+        if (type === 'integer' && !Number.isInteger(n))
+            return { ok: false, err: '需要整数' };
+        return { ok: true, value: n };
+    }
+    if (type === 'boolean')
+        return { ok: true, value: raw === 'true' };
+    if (type === 'object' || type === 'array') {
+        try {
+            return { ok: true, value: JSON.parse(raw) };
+        }
+        catch {
+            return { ok: false, err: '需要合法 JSON' };
+        }
+    }
+    return { ok: true, value: raw };
+}
+function typeHint(p) {
+    const bits = [];
+    if (p.enum?.length)
+        bits.push(`可选:${p.enum.map(String).join(' / ')}`);
+    else if (p.type)
+        bits.push(p.type);
+    bits.push(p.required ? '必填' : '可选');
+    return bits.join(' · ');
+}
+export function CommandPalette() {
+    const open = useCommandPaletteOpen();
+    const [rows, setRows] = useState([]);
+    const [formDef, setFormDef] = useState(null); // 非空 = 处于参数引导子界面
+    const [values, setValues] = useState({});
+    const [feedback, setFeedback] = useState(null);
+    // 动态候选:paramKey → 取值列表(undefined=还在解析,[]=解析完但无项)。
+    const [choices, setChoices] = useState({});
+    const firstFieldRef = useRef(null);
+    const closeTask = useRef(null);
+    const close = useCallback(() => {
+        closeTask.current?.cancel();
+        setCommandPaletteOpen(false);
+        setFormDef(null);
+        setValues({});
+        setFeedback(null);
+    }, []);
+    // 成功后不立刻关:先让绿色回报(含 stateDigest,如 console.clear 的 {cleared:N})显示一下再自动关。
+    const scheduleClose = useCallback(() => {
+        closeTask.current?.schedule();
+    }, []);
+    useEffect(() => {
+        const task = createRestartableTimeoutTaskLifecycle({ delayMs: 1100, task: close });
+        closeTask.current = task;
+        return () => {
+            task.dispose();
+            closeTask.current = null;
+        };
+    }, [close]);
+    // 打开时取一次注册表快照;available 的排前面。
+    useEffect(() => {
+        if (!open)
+            return;
+        const snap = snapshotActions();
+        snap.sort((a, b) => Number(b.available) - Number(a.available) || a.title.localeCompare(b.title));
+        setRows(snap);
+    }, [open]);
+    // 进入参数界面:解析动态候选(choices),就绪后把候选字段默认选到第一项,并聚焦首字段。
+    useEffect(() => {
+        if (!formDef) {
+            setChoices({});
+            return;
+        }
+        firstFieldRef.current?.focus();
+        const provs = formDef.choices ?? {};
+        const keys = Object.keys(provs);
+        if (keys.length === 0)
+            return;
+        let cancelled = false;
+        void (async () => {
+            const resolved = {};
+            await Promise.all(keys.map(async (k) => {
+                try {
+                    resolved[k] = (await provs[k]()) ?? [];
+                }
+                catch {
+                    resolved[k] = [];
+                }
+            }));
+            if (cancelled)
+                return;
+            setChoices(resolved);
+            setValues((v) => {
+                const next = { ...v };
+                for (const k of keys)
+                    if (resolved[k]?.length && !next[k])
+                        next[k] = resolved[k][0];
+                return next;
+            });
+        })();
+        return () => {
+            cancelled = true;
+        };
+    }, [formDef]);
+    /** 真正派发 + 结果回显。成功(完成/受理)返回 true,被拒返回 false。 */
+    const execute = useCallback(async (id, args) => {
+        const res = await dispatchAction(id, args, { source: 'human' });
+        if (res.status === 'rejected') {
+            setFeedback({ kind: 'err', text: res.reason ?? '执行被拒绝' });
+            return false;
+        }
+        // 带上 stateDigest 做可见回报(如 console.clear 的 {cleared:N}),避免「点了没反应」。
+        const digest = res.stateDigest !== undefined ? ` · ${JSON.stringify(res.stateDigest)}` : '';
+        setFeedback({ kind: 'ok', text: (res.status === 'accepted' ? '已受理(异步执行中)' : '已执行') + digest });
+        return true;
+    }, []);
+    /** 列表里选中一条:有参数 → 进引导;无参数 → 直接执行。 */
+    const onSelect = useCallback((id) => {
+        const def = getAction(id);
+        const params = def ? paramsOf(def) : [];
+        if (def && params.length > 0) {
+            const init = {};
+            for (const p of params) {
+                init[p.key] = p.enum?.length ? String(p.enum[0]) : p.type === 'boolean' ? 'true' : '';
+            }
+            setFeedback(null);
+            setValues(init);
+            setFormDef(def);
+            return;
+        }
+        void execute(id, {}).then((ok) => {
+            if (ok)
+                scheduleClose();
+        });
+    }, [execute, scheduleClose]);
+    const submit = useCallback(async () => {
+        if (!formDef)
+            return;
+        const args = {};
+        for (const p of paramsOf(formDef)) {
+            const raw = values[p.key] ?? '';
+            if (raw === '') {
+                if (p.required) {
+                    setFeedback({ kind: 'err', text: `「${p.key}」为必填` });
+                    return;
+                }
+                continue; // 可选留空 → 不发该键
+            }
+            const c = coerce(raw, p.type);
+            if (!c.ok) {
+                setFeedback({ kind: 'err', text: `「${p.key}」${c.err}` });
+                return;
+            }
+            args[p.key] = c.value;
+        }
+        const ok = await execute(formDef.id, args);
+        if (ok)
+            scheduleClose();
+    }, [formDef, values, execute, scheduleClose]);
+    const enabled = useMemo(() => rows.filter((r) => r.available), [rows]);
+    const disabled = useMemo(() => rows.filter((r) => !r.available), [rows]);
+    if (!open)
+        return null;
+    // ── 参数引导子界面 ────────────────────────────────────────────────────────
+    if (formDef) {
+        const params = paramsOf(formDef);
+        return (_jsx("div", { className: "fx-cmdk-overlay", onClick: close, onKeyDown: (e) => {
+                if (e.nativeEvent.isComposing)
+                    return;
+                if (e.key === 'Escape') {
+                    e.preventDefault();
+                    if (formDef) {
+                        setFormDef(null);
+                        setValues({});
+                        setFeedback(null);
+                    }
+                    else
+                        close();
+                }
+            }, tabIndex: -1, children: _jsxs("div", { className: "fx-cmdk-panel", onClick: (e) => e.stopPropagation(), children: [_jsxs("div", { className: "fx-cmdk-form-head", children: [_jsx("button", { className: "fx-cmdk-back", type: "button", onClick: () => setFormDef(null), title: "\u8FD4\u56DE\u547D\u4EE4\u5217\u8868", children: "\u2190 \u8FD4\u56DE" }), _jsx("span", { className: "fx-cmdk-title", children: formDef.title }), _jsx("span", { className: "fx-cmdk-id", children: formDef.id })] }), formDef.description && _jsx("p", { className: "fx-cmdk-guide", children: formDef.description }), _jsxs("form", { className: "fx-cmdk-form", onSubmit: (e) => {
+                            e.preventDefault();
+                            void submit();
+                        }, children: [params.map((p, i) => {
+                                const setRef = (el) => {
+                                    if (i === 0)
+                                        firstFieldRef.current = el;
+                                };
+                                const val = values[p.key] ?? '';
+                                const onChange = (v) => setValues((s) => ({ ...s, [p.key]: v }));
+                                const isDyn = !!formDef.choices?.[p.key]; // 该字段有动态候选提供器
+                                const dynList = choices[p.key]; // undefined=解析中,[]=无项,[...]=候选
+                                return (_jsxs("label", { className: "fx-cmdk-field", children: [_jsxs("span", { className: "fx-cmdk-field-label", children: [p.key, p.required && _jsx("em", { className: "fx-cmdk-req", children: "*" }), _jsx("small", { className: "fx-cmdk-field-hint", children: typeHint(p) })] }), p.enum?.length ? (_jsx("select", { ref: setRef, value: val, onChange: (e) => onChange(e.target.value), children: p.enum.map((o) => (_jsx("option", { value: String(o), children: String(o) }, String(o)))) })) : isDyn ? (dynList === undefined ? (_jsx("select", { disabled: true, ref: setRef, children: _jsx("option", { children: "\u52A0\u8F7D\u4E2D\u2026" }) })) : dynList.length === 0 ? (_jsx("select", { disabled: true, ref: setRef, children: _jsx("option", { children: "\u65E0\u53EF\u7528\u9879" }) })) : (_jsx("select", { ref: setRef, value: val, onChange: (e) => onChange(e.target.value), children: dynList.map((o) => (_jsx("option", { value: o, children: o }, o))) }))) : p.type === 'boolean' ? (_jsxs("select", { ref: setRef, value: val, onChange: (e) => onChange(e.target.value), children: [_jsx("option", { value: "true", children: "true" }), _jsx("option", { value: "false", children: "false" })] })) : p.type === 'number' || p.type === 'integer' ? (_jsx("input", { ref: setRef, type: "number", value: val, onChange: (e) => onChange(e.target.value), placeholder: p.type })) : (_jsx("textarea", { ref: setRef, rows: p.type === 'object' || p.type === 'array' ? 3 : 2, value: val, onChange: (e) => onChange(e.target.value), placeholder: p.type === 'object' || p.type === 'array' ? 'JSON…' : `输入 ${p.key}…`, onKeyDown: (e) => {
+                                                if (e.key === 'Enter' && (e.metaKey || e.ctrlKey)) {
+                                                    e.preventDefault();
+                                                    void submit();
+                                                }
+                                            } })), p.description && _jsx("small", { className: "fx-cmdk-field-desc", children: p.description })] }, p.key));
+                            }), feedback && _jsx("div", { className: `fx-cmdk-feedback fx-cmdk-feedback--${feedback.kind}`, children: feedback.text }), _jsxs("div", { className: "fx-cmdk-form-actions", children: [_jsx("span", { className: "fx-cmdk-form-tip", children: "Enter \u6267\u884C \u00B7 Esc \u8FD4\u56DE" }), _jsx("button", { type: "submit", className: "fx-cmdk-run", children: "\u6267\u884C" })] })] })] }) }));
+    }
+    // ── 命令列表 ──────────────────────────────────────────────────────────────
+    return (_jsx("div", { className: "fx-cmdk-overlay", onClick: close, onKeyDown: (e) => {
+            if (!e.nativeEvent.isComposing && e.key === 'Escape') {
+                e.preventDefault();
+                close();
+            }
+        }, tabIndex: -1, children: _jsxs("div", { className: "fx-cmdk-panel", onClick: (e) => e.stopPropagation(), children: [_jsxs(Command, { label: "\u547D\u4EE4\u9762\u677F", children: [_jsx(Command.Input, { autoFocus: true, placeholder: "\u8F93\u5165\u547D\u4EE4\u2026(\u4E0E AI \u53EF\u8C03\u7528\u7684\u529F\u80FD\u540C\u4E00\u5F20\u6CE8\u518C\u8868)" }), _jsxs(Command.List, { children: [_jsx(Command.Empty, { children: "\u6CA1\u6709\u5339\u914D\u7684\u547D\u4EE4" }), enabled.map((r) => (_jsxs(Command.Item, { value: `${r.title} ${r.id}`, onSelect: () => onSelect(r.id), children: [_jsx("span", { className: "fx-cmdk-title", children: r.title }), _jsx("span", { className: "fx-cmdk-id", children: r.id })] }, r.id))), disabled.length > 0 && (_jsx(Command.Group, { heading: "\u5F53\u524D\u4E0D\u53EF\u7528", children: disabled.map((r) => (_jsxs(Command.Item, { value: `${r.title} ${r.id}`, disabled: true, children: [_jsx("span", { className: "fx-cmdk-title", children: r.title }), _jsx("span", { className: "fx-cmdk-reason", children: r.reason })] }, r.id))) }))] })] }), feedback && _jsx("div", { className: `fx-cmdk-feedback fx-cmdk-feedback--${feedback.kind}`, children: feedback.text })] }) }));
+}

package/dist/package/browser/components/Confirm/ConfirmDialog.d.ts

@@ -0,0 +1,2 @@
+import type { ReactElement } from 'react';
+export declare function ConfirmDialog(): ReactElement | null;