@forgeax/interface 0.4.1

package/dist/package/browser/components/SchemaForm/SchemaForm.js

@@ -0,0 +1,86 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Phase D2 — SchemaForm.
+ *
+ * Renders a JSON Schema as an HTML form. Plugin authors who write a tool's
+ * argsSchema get a working form for free, and the same schema is what AI
+ * tool-calls validate against — one source of truth, both pipelines.
+ *
+ * Coverage (07-INTERFACE-EXPOSURE.md §4):
+ *   string  → <input type=text> (with `format: 'multiline'` → <textarea>)
+ *   number/integer → <input type=number>
+ *   boolean → <input type=checkbox>
+ *   enum    → <select>
+ *   array   → repeatable list with add/remove buttons
+ *   object  → nested fieldset
+ *   x-fx-readonly / x-fx-secret / x-fx-multiline custom keywords
+ *
+ * Validation is intentionally light (required + type) — the server's
+ * Zod-derived ToolCall schema is the authoritative gate.
+ */
+import { useState, useCallback, useMemo } from 'react';
+import { defaultFor, findMissingRequired, coerceEnumValue } from './schema-form-utils';
+import { useTranslation } from '../../i18n';
+import { Input } from '../ui/input';
+import { Textarea } from '../ui/textarea';
+import { Checkbox } from '../ui/checkbox';
+import { Button } from '../ui/button';
+import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue, } from '../ui/select';
+import './SchemaForm.css';
+export { findMissingRequired } from './schema-form-utils';
+function Field({ schema, value, onChange, required, pathLabel }) {
+    const { t } = useTranslation();
+    const readonly = schema['x-fx-readonly'] === true;
+    const secret = schema['x-fx-secret'] === true;
+    const multiline = schema['x-fx-multiline'] === true || schema.format === 'multiline';
+    const label = schema.title ?? pathLabel ?? '';
+    if (schema.enum) {
+        return (_jsxs("div", { className: "fx-sf-row", children: [_jsxs("span", { className: "fx-sf-label", children: [label, required ? ' *' : ''] }), _jsxs(Select, { disabled: readonly, value: String(value ?? ''), onValueChange: (v) => onChange(coerceEnumValue(schema.enum, v)), children: [_jsx(SelectTrigger, { children: _jsx(SelectValue, {}) }), _jsx(SelectContent, { children: schema.enum.map((opt, i) => (_jsx(SelectItem, { value: String(opt), children: String(opt) }, i))) })] }), schema.description ? _jsx("span", { className: "fx-sf-hint", children: schema.description }) : null] }));
+    }
+    if (schema.type === 'boolean') {
+        return (_jsxs("label", { className: "fx-sf-row fx-sf-row-bool", children: [_jsx(Checkbox, { disabled: readonly, checked: value === true, onCheckedChange: (c) => onChange(c === true) }), _jsxs("span", { className: "fx-sf-label", children: [label, required ? ' *' : ''] }), schema.description ? _jsx("span", { className: "fx-sf-hint", children: schema.description }) : null] }));
+    }
+    if (schema.type === 'number' || schema.type === 'integer') {
+        return (_jsxs("label", { className: "fx-sf-row", children: [_jsxs("span", { className: "fx-sf-label", children: [label, required ? ' *' : ''] }), _jsx(Input, { type: "number", disabled: readonly, step: schema.type === 'integer' ? 1 : 'any', min: schema.minimum, max: schema.maximum, value: value === '' || value == null ? '' : String(value), onChange: (e) => {
+                        const raw = e.target.value;
+                        if (raw === '')
+                            onChange(undefined);
+                        else {
+                            const n = schema.type === 'integer' ? parseInt(raw, 10) : parseFloat(raw);
+                            onChange(Number.isFinite(n) ? n : undefined);
+                        }
+                    } }), schema.description ? _jsx("span", { className: "fx-sf-hint", children: schema.description }) : null] }));
+    }
+    if (schema.type === 'array') {
+        const arr = Array.isArray(value) ? value : [];
+        const item = schema.items ?? { type: 'string' };
+        return (_jsxs("fieldset", { className: "fx-sf-array", children: [_jsxs("legend", { children: [label, required ? ' *' : ''] }), schema.description ? _jsx("div", { className: "fx-sf-hint", children: schema.description }) : null, arr.map((v, i) => (_jsxs("div", { className: "fx-sf-array-row", children: [_jsx(Field, { schema: item, value: v, onChange: (next) => {
+                                const copy = [...arr];
+                                copy[i] = next;
+                                onChange(copy);
+                            }, pathLabel: `#${i}` }), _jsx(Button, { type: "button", variant: "ghost", size: "icon", className: "fx-sf-array-rm h-7 w-7 shrink-0", onClick: () => onChange(arr.filter((_, j) => j !== i)), children: "\u00D7" })] }, i))), _jsx(Button, { type: "button", variant: "outline", size: "sm", className: "fx-sf-array-add self-start", onClick: () => onChange([...arr, defaultFor(item)]), children: t('schemaForm.addItem') })] }));
+    }
+    if (schema.type === 'object') {
+        const obj = (value && typeof value === 'object') ? value : {};
+        return (_jsxs("fieldset", { className: "fx-sf-object", children: [label ? _jsxs("legend", { children: [label, required ? ' *' : ''] }) : null, schema.description ? _jsx("div", { className: "fx-sf-hint", children: schema.description }) : null, Object.entries(schema.properties ?? {}).map(([k, sub]) => (_jsx(Field, { schema: sub, value: obj[k], required: schema.required?.includes(k), pathLabel: k, onChange: (next) => onChange({ ...obj, [k]: next }) }, k)))] }));
+    }
+    // string fallback (default)
+    if (multiline) {
+        return (_jsxs("label", { className: "fx-sf-row", children: [_jsxs("span", { className: "fx-sf-label", children: [label, required ? ' *' : ''] }), _jsx(Textarea, { className: "fx-sf-textarea", disabled: readonly, value: typeof value === 'string' ? value : '', onChange: (e) => onChange(e.target.value), minLength: schema.minLength, maxLength: schema.maxLength }), schema.description ? _jsx("span", { className: "fx-sf-hint", children: schema.description }) : null] }));
+    }
+    return (_jsxs("label", { className: "fx-sf-row", children: [_jsxs("span", { className: "fx-sf-label", children: [label, required ? ' *' : ''] }), _jsx(Input, { type: secret ? 'password' : 'text', disabled: readonly, value: typeof value === 'string' ? value : '', minLength: schema.minLength, maxLength: schema.maxLength, onChange: (e) => onChange(e.target.value) }), schema.description ? _jsx("span", { className: "fx-sf-hint", children: schema.description }) : null] }));
+}
+export function SchemaForm({ schema, initialValue, onSubmit, onCancel, submitLabel, layout = 'panel', busy, }) {
+    const { t } = useTranslation();
+    const initial = useMemo(() => (initialValue !== undefined ? initialValue : defaultFor(schema)), [initialValue, schema]);
+    const [value, setValue] = useState(initial);
+    const [missing, setMissing] = useState([]);
+    const submit = useCallback((e) => {
+        e.preventDefault();
+        const m = findMissingRequired(schema, value);
+        setMissing(m);
+        if (m.length === 0)
+            onSubmit(value);
+    }, [schema, value, onSubmit]);
+    return (_jsxs("form", { className: `fx-sf fx-sf-${layout}`, onSubmit: submit, children: [_jsx(Field, { schema: schema, value: value, onChange: setValue }), missing.length > 0 ? (_jsx("div", { className: "fx-sf-error", children: t('schemaForm.missingRequired', { fields: missing.join(', ') }) })) : null, _jsxs("div", { className: "fx-sf-actions", children: [onCancel ? (_jsx(Button, { type: "button", variant: "ghost", size: "sm", onClick: onCancel, disabled: busy, children: t('common.cancel') })) : null, _jsx(Button, { type: "submit", size: "sm", disabled: busy, children: submitLabel ?? t('schemaForm.run') })] })] }));
+}

package/dist/package/browser/components/SchemaForm/schema-form-utils.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Phase D2 — SchemaForm pure helpers.
+ *
+ * Extracted so they can be unit-tested without a React/DOM runtime. The .tsx
+ * component imports `defaultFor` + `findMissingRequired` from here.
+ */
+export type JsonSchema = {
+    type?: 'string' | 'number' | 'integer' | 'boolean' | 'object' | 'array' | 'null';
+    title?: string;
+    description?: string;
+    enum?: unknown[];
+    default?: unknown;
+    properties?: Record<string, JsonSchema>;
+    required?: string[];
+    items?: JsonSchema;
+    format?: string;
+    minimum?: number;
+    maximum?: number;
+    minLength?: number;
+    maxLength?: number;
+    'x-fx-readonly'?: boolean;
+    'x-fx-secret'?: boolean;
+    'x-fx-multiline'?: boolean;
+};
+export declare function defaultFor(schema: JsonSchema): unknown;
+/** Walk a value vs schema and return the list of missing required leaves
+ *  (dotted paths, e.g. `["user.name", "user.email"]`). Empty string + null
+ *  + undefined all count as missing. */
+export declare function findMissingRequired(schema: JsonSchema, value: unknown, path?: string[]): string[];
+export declare function coerceEnumValue(opts: unknown[], raw: string): unknown;

package/dist/package/browser/components/SchemaForm/schema-form-utils.js

@@ -0,0 +1,51 @@
+/**
+ * Phase D2 — SchemaForm pure helpers.
+ *
+ * Extracted so they can be unit-tested without a React/DOM runtime. The .tsx
+ * component imports `defaultFor` + `findMissingRequired` from here.
+ */
+export function defaultFor(schema) {
+    if (schema.default !== undefined)
+        return schema.default;
+    switch (schema.type) {
+        case 'string': return '';
+        case 'number':
+        case 'integer': return 0;
+        case 'boolean': return false;
+        case 'array': return [];
+        case 'object': {
+            const o = {};
+            for (const [k, sub] of Object.entries(schema.properties ?? {})) {
+                o[k] = defaultFor(sub);
+            }
+            return o;
+        }
+        default: return null;
+    }
+}
+/** Walk a value vs schema and return the list of missing required leaves
+ *  (dotted paths, e.g. `["user.name", "user.email"]`). Empty string + null
+ *  + undefined all count as missing. */
+export function findMissingRequired(schema, value, path = []) {
+    if (schema.type !== 'object' || !schema.required)
+        return [];
+    const missing = [];
+    const obj = (value && typeof value === 'object') ? value : {};
+    for (const k of schema.required) {
+        const sub = schema.properties?.[k];
+        const v = obj[k];
+        if (v === undefined || v === null || v === '') {
+            missing.push([...path, k].join('.'));
+        }
+        else if (sub) {
+            missing.push(...findMissingRequired(sub, v, [...path, k]));
+        }
+    }
+    return missing;
+}
+export function coerceEnumValue(opts, raw) {
+    for (const opt of opts)
+        if (String(opt) === raw)
+            return opt;
+    return raw;
+}

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

@@ -0,0 +1,24 @@
+import { type ReactNode } from 'react';
+export declare function Section({ icon, title, hint, children, }: {
+    icon: ReactNode;
+    title: string;
+    hint?: string;
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function EnvField({ label, masked, placeholder, onSave, busy, visible, notSetHint, onReset, resetTitle, }: {
+    label: string;
+    masked: string | null;
+    placeholder: string;
+    onSave: (v: string) => void;
+    busy: boolean;
+    visible?: boolean;
+    /** shown instead of "Not set" when the env is empty but a built-in default applies */
+    notSetHint?: string;
+    /** Clear the override and restore the built-in default (e.g. shared upload token). */
+    onReset?: () => void;
+    /** Override the reset tooltip when the field has no built-in fallback. */
+    resetTitle?: string;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function UploadPanel({ tokenSet }: {
+    tokenSet?: boolean;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/package/browser/components/SettingsPrimitives.js

@@ -0,0 +1,145 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useEffect, useRef, useState } from 'react';
+import { createRestartableTimeoutTaskLifecycle } from '@forgeax/app-shell/react';
+import { Eye, EyeOff, UploadCloud, Copy, Check } from 'lucide-react';
+import { useTranslation } from '../i18n';
+export function Section({ icon, title, hint, children, }) {
+    return (_jsxs("div", { className: "settings-section", children: [_jsxs("div", { className: "settings-section-head", children: [_jsx("span", { className: "settings-section-icon", children: icon }), _jsx("span", { className: "settings-section-title", children: title })] }), hint && _jsx("div", { className: "settings-section-hint", children: hint }), _jsx("div", { className: "settings-section-body", children: children })] }));
+}
+export function EnvField({ label, masked, placeholder, onSave, busy, visible, notSetHint, onReset, resetTitle, }) {
+    const { t } = useTranslation();
+    const stored = masked ?? '';
+    const [value, setValue] = useState(visible ? stored : '');
+    const [revealed, setRevealed] = useState(false);
+    // Settings-panel section switches reuse this component instance at the same
+    // tree position (section nodes carry no keys), so without a reset the draft
+    // of e.g. ANTHROPIC_BASE_URL leaks into FORGEAX_UPLOAD_BRANCH. Re-key the
+    // local state on field identity.
+    useEffect(() => {
+        setValue(visible ? (masked ?? '') : '');
+        setRevealed(false);
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [label]);
+    const trimmed = value.trim();
+    const dirty = visible ? trimmed !== stored : trimmed.length > 0;
+    const slot = visible ? placeholder : (masked ? t('settings.drawer.savedMasked', { masked }) : (notSetHint ?? t('settings.drawer.envNotSet')));
+    const commit = () => {
+        if (!trimmed || !dirty || busy)
+            return;
+        onSave(trimmed);
+        if (!visible)
+            setValue('');
+        setRevealed(false);
+    };
+    const reset = () => {
+        if (!onReset || busy || !masked)
+            return;
+        onReset();
+        setValue('');
+        setRevealed(false);
+    };
+    return (_jsxs("div", { className: "settings-row", children: [_jsx("label", { className: `settings-label${label.length > 28 ? ' settings-label--long' : ''}`, title: label, children: label }), _jsxs("div", { className: `settings-input-wrap${visible ? '' : ' with-eye'}`, children: [_jsx("input", { className: "settings-input", type: visible || revealed ? 'text' : 'password', value: value, placeholder: slot ?? '', spellCheck: false, autoComplete: "off", onChange: (e) => setValue(e.target.value), onKeyDown: (e) => { if (e.key === 'Enter')
+                            commit(); }, disabled: busy }), !visible && (_jsx("button", { type: "button", className: "settings-eye-btn", onClick: () => setRevealed((v) => !v), title: revealed ? t('settings.drawer.hide') : t('settings.drawer.show'), tabIndex: -1, children: revealed ? _jsx(EyeOff, { size: 12 }) : _jsx(Eye, { size: 12 }) }))] }), onReset && (_jsx("button", { type: "button", className: "settings-cancel-btn", onClick: reset, disabled: busy || !masked, title: resetTitle ?? t('settings.upload.resetTokenTitle'), children: t('common.reset') })), _jsx("button", { className: "settings-save-btn", onClick: commit, disabled: busy || !dirty, title: dirty ? '' : (visible ? t('settings.drawer.noChanges') : t('settings.drawer.enterNewKeyHint')), children: t('common.save') })] }));
+}
+function fmtBytes(n) {
+    if (n < 1024)
+        return `${n} B`;
+    if (n < 1024 * 1024)
+        return `${(n / 1024).toFixed(1)} KB`;
+    return `${(n / (1024 * 1024)).toFixed(1)} MB`;
+}
+async function callUploadCommand(args) {
+    try {
+        const r = await fetch('/api/commands/upload/execute', {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({ args }),
+        });
+        const j = (await r.json().catch(() => null));
+        if (!j?.result)
+            return { ok: false, kind: 'transport', error: `HTTP ${r.status}` };
+        if (!j.result.ok)
+            return { ok: false, kind: 'transport', error: j.result.error ?? 'command failed' };
+        return j.result.data;
+    }
+    catch (e) {
+        return { ok: false, kind: 'network', error: e.message };
+    }
+}
+const PERSONAL_TOKEN_URL = 'https://github.com/settings/tokens/new?scopes=repo&description=ForgeaX+Upload';
+/** Full snapshot URL + copy button — the thing users paste back as feedback. */
+function SnapshotUrlRow({ url }) {
+    const { t } = useTranslation();
+    const [copied, setCopied] = useState(false);
+    const copiedResetTaskRef = useRef(null);
+    useEffect(() => {
+        const task = createRestartableTimeoutTaskLifecycle({
+            delayMs: 2000,
+            task: () => setCopied(false),
+        });
+        copiedResetTaskRef.current = task;
+        return () => {
+            copiedResetTaskRef.current = null;
+            task.dispose();
+        };
+    }, []);
+    const copy = async () => {
+        try {
+            await navigator.clipboard.writeText(url);
+        }
+        catch {
+            // clipboard API unavailable (http / permission) — legacy path
+            const ta = document.createElement('textarea');
+            ta.value = url;
+            document.body.appendChild(ta);
+            ta.select();
+            document.execCommand('copy');
+            ta.remove();
+        }
+        setCopied(true);
+        copiedResetTaskRef.current?.schedule();
+    };
+    return (_jsxs("div", { style: { display: 'flex', alignItems: 'center', gap: 6, marginTop: 6, maxWidth: '100%' }, children: [_jsx("code", { style: { overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap', flex: '0 1 auto' }, children: url }), _jsxs("button", { className: "settings-edit-btn", style: { flex: 'none' }, onClick: () => void copy(), children: [copied ? _jsx(Check, { size: 12 }) : _jsx(Copy, { size: 12 }), " ", copied ? t('settings.upload.copied') : t('settings.upload.copyUrl')] })] }));
+}
+export function UploadPanel({ tokenSet }) {
+    const { t } = useTranslation();
+    const [phase, setPhase] = useState('idle');
+    const [plan, setPlan] = useState(null);
+    const [outcome, setOutcome] = useState(null);
+    const doPlan = async () => {
+        setPhase('planning');
+        setOutcome(null);
+        setPlan(null);
+        const res = await callUploadCommand([]);
+        if (res.ok && res.kind === 'plan') {
+            setPlan(res);
+            setPhase('planned');
+        }
+        else {
+            setOutcome(res);
+            setPhase('idle');
+        }
+    };
+    const doConfirm = async () => {
+        if (!plan?.nonce)
+            return;
+        setPhase('pushing');
+        const res = await callUploadCommand(['confirm', plan.nonce]);
+        setOutcome(res.ok && res.kind === 'result' ? res : res);
+        setPlan(null);
+        setPhase('idle');
+    };
+    const cancel = () => { setPlan(null); setPhase('idle'); };
+    const running = phase === 'planning' || phase === 'pushing';
+    const btnLabel = phase === 'planning' ? t('settings.upload.btnPlanning')
+        : phase === 'pushing' ? t('settings.upload.btnPushing')
+            : t('settings.upload.btnIdle');
+    return (_jsxs("div", { style: { marginTop: 8 }, children: [phase !== 'planned' && (_jsxs("button", { className: "settings-edit-btn", onClick: () => void doPlan(), disabled: running, children: [_jsx(UploadCloud, { size: 12 }), " ", btnLabel] })), phase === 'idle' && !outcome && tokenSet === false && (_jsxs("div", { className: "settings-help", style: { marginTop: 6 }, children: [t('settings.upload.tokenHintPrefix'), ' ', _jsx("a", { href: PERSONAL_TOKEN_URL, target: "_blank", rel: "noreferrer", children: t('settings.upload.tokenHintLink') }), ' ', t('settings.upload.tokenHintSuffix')] })), phase === 'planned' && plan && (_jsxs("div", { className: "settings-help", style: { lineHeight: 1.7 }, children: [_jsxs("div", { children: [t('settings.upload.planSummary', { count: plan.fileCount, bytes: fmtBytes(plan.bytes) }), ' ', _jsx("code", { children: "workspace.tar.gz" }), " \u2192 ", _jsx("code", { children: plan.repo }), " @ ", _jsx("code", { children: plan.branch }), ' ', t('settings.upload.planPath', { namespace: plan.namespace })] }), plan.skippedSymlinks.length > 0 && (_jsx("div", { children: t('settings.upload.skippedSymlinks', { count: plan.skippedSymlinks.length }) })), plan.skippedLarge.length > 0 && (_jsx("div", { children: t('settings.upload.skippedLarge', { count: plan.skippedLarge.length }) })), plan.secretHits.length > 0 && (_jsx("div", { style: { color: 'var(--danger, #e5534b)' }, children: t('settings.upload.secretBlocked', {
+                            count: plan.secretHits.length,
+                            samples: plan.secretHits.slice(0, 3).map((h) => h.rel).join(', '),
+                        }) })), !plan.tokenConfigured && (_jsxs("div", { style: { color: 'var(--danger, #e5534b)' }, children: [t('settings.upload.tokenMissingTitle'), _jsx("br", {}), t('settings.upload.tokenMissingStep1Before'), _jsx("a", { href: PERSONAL_TOKEN_URL, target: "_blank", rel: "noreferrer", style: { color: 'inherit', textDecoration: 'underline' }, children: t('settings.upload.tokenMissingStep1Link') }), t('settings.upload.tokenMissingStep1After'), _jsx("br", {}), t('settings.upload.tokenMissingStep2'), _jsx("br", {}), t('settings.upload.tokenMissingStep3')] })), plan.fileCount === 0 && _jsx("div", { children: t('settings.upload.empty') }), _jsxs("div", { style: { display: 'flex', gap: 6, marginTop: 6 }, children: [plan.nonce && (_jsx("button", { className: "settings-edit-btn", onClick: () => void doConfirm(), children: t('settings.upload.confirm') })), _jsx("button", { className: "settings-edit-btn", onClick: cancel, children: t('settings.upload.cancel') })] })] })), outcome && (_jsx("div", { className: "settings-help", style: { marginTop: 6 }, children: outcome.ok ? (_jsxs(_Fragment, { children: [outcome.skipped ? (_jsxs("span", { children: [_jsx("span", { className: "ok-pill", children: t('settings.upload.skippedSame') }), ' ', _jsx("a", { href: `${outcome.repoUrl}/tree/${outcome.branch}/${outcome.path}`, target: "_blank", rel: "noreferrer", children: t('settings.upload.viewExisting') })] })) : (_jsxs("span", { children: [_jsx("span", { className: "ok-pill", children: t('settings.upload.uploaded', {
+                                        count: outcome.sourceFileCount,
+                                        sourceBytes: fmtBytes(outcome.sourceBytes),
+                                        archiveBytes: fmtBytes(outcome.archiveBytes),
+                                    }) }), ' ', _jsx("a", { href: `${outcome.repoUrl}/tree/${outcome.branch}/${outcome.path}`, target: "_blank", rel: "noreferrer", children: t('settings.upload.viewSnapshot') }), ' ', _jsx("a", { href: `${outcome.repoUrl}/tree/${outcome.branch}/${outcome.namespace}/data`, target: "_blank", rel: "noreferrer", children: t('settings.upload.allVersions') }), ' ', _jsxs("code", { children: ["@", outcome.commit.slice(0, 7)] })] })), _jsx(SnapshotUrlRow, { url: `${outcome.repoUrl}/raw/${outcome.branch}/${outcome.path}/workspace.tar.gz` })] })) : (_jsx("span", { className: "err-pill", style: { whiteSpace: 'normal' }, children: t('settings.upload.failed', { error: outcome.error }) })) }))] }));
+}

package/dist/package/browser/components/Sidebar/BusHealthLamp.d.ts

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

package/dist/package/browser/components/Sidebar/BusHealthLamp.js

@@ -0,0 +1,72 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useTranslation } from '../../i18n';
+import { useSharedHealth } from '../../lib/shell-live-data';
+import { useShellStore } from '../../store';
+function classify(bus) {
+    return {
+        kind: 'ok',
+        extensionCount: bus.extensionCount,
+        brokenCount: bus.brokenCount,
+        listenerCount: bus.listenerCount,
+        ringSize: bus.ringSize,
+    };
+}
+// P3.87 (2026-05-17): Upgrade BusHealthLamp from static <span> chip to
+// clickable <button> deep-link → openSettings('plugins') 钻 Bus admin tab. 0 store
+// change (reuse setMode), 0 Sidebar.tsx change (Sidebar.tsx player WIP — we
+// stay inside BusHealthLamp.tsx + Sidebar.css). When state.kind ≠ 'ok'
+// (loading / down), fall back to plain <span> so disabled visual = the same
+// as before; only the healthy chip becomes interactive.
+//
+// P4.48 (2026-05-17): Insert a sub-span `.bus-chip-sigma` rendering "Σ"
+// before the count text when state.kind === 'ok'. 5th surface of the
+// Σ-prefix muscle-memory language (after AgentsHub header P4.45 + WbGallery
+// stats P4.46 + AgentsPanel header P4.47 + BusAdminPanel summary P4.42).
+// The extension health chip is the player's most-visible at-all-times
+// indicator, so closing the gap here brings the language to the highest
+// dwell-time surface. Σ glyph only renders in the healthy ok-state to avoid
+// "Σ…" / "Σ down" clutter on loading / down chips. Inline next to the dot,
+// 0 layout shift on width (Σ adds ~6px; chip has flex room).
+export function BusHealthLamp() {
+    const { t } = useTranslation();
+    const health = useSharedHealth();
+    const openOverlay = useShellStore((s) => s.openOverlay);
+    const state = health.state === 'loading'
+        ? { kind: 'loading' }
+        : health.state === 'down'
+            ? { kind: 'down', reason: 'health request failed' }
+            : health.value.bus
+                ? classify(health.value.bus)
+                : { kind: 'down', reason: 'no bus field' };
+    const tone = state.kind === 'ok'
+        ? state.brokenCount > 0
+            ? 'warn'
+            : state.extensionCount > 0
+                ? 'ok'
+                : 'idle'
+        : state.kind === 'loading'
+            ? 'idle'
+            : 'down';
+    const baseTitle = state.kind === 'ok'
+        ? `Bus: ${state.extensionCount} plugin · ${state.brokenCount} broken · ${state.listenerCount} listener · ring ${state.ringSize}`
+        : state.kind === 'loading'
+            ? 'Bus: loading…'
+            : `Bus down: ${state.reason}`;
+    const label = state.kind === 'ok'
+        ? state.brokenCount > 0
+            ? `${state.extensionCount - state.brokenCount}/${state.extensionCount}`
+            : String(state.extensionCount)
+        : state.kind === 'loading'
+            ? '…'
+            : 'down';
+    const isLink = state.kind === 'ok';
+    const title = isLink ? t('busHealthLamp.linkTitle', { base: baseTitle }) : baseTitle;
+    // P4.48 — Σ glyph rendered only in 'ok' state. In loading/down branches
+    // the count slot reads '…' / 'down' and a Σ would read as "Σ down" which
+    // is semantically wrong (Σ implies a count). So gate strictly on isLink.
+    const showSigma = isLink;
+    if (!isLink) {
+        return (_jsxs("span", { className: `bus-chip bus-chip-${tone}`, title: title, "aria-label": title, children: [_jsx("span", { className: "bus-chip-dot" }), _jsx("span", { className: "bus-chip-text", children: label })] }));
+    }
+    return (_jsxs("button", { type: "button", className: `bus-chip bus-chip-${tone} is-link`, title: title, "aria-label": title, onClick: () => openOverlay('settings', 'plugins'), children: [_jsx("span", { className: "bus-chip-dot" }), showSigma && _jsx("span", { className: "bus-chip-sigma", "aria-hidden": "true", children: "\u03A3" }), _jsx("span", { className: "bus-chip-text", children: label }), state.kind === 'ok' && state.ringSize > 0 && (_jsxs("span", { className: "bus-chip-ring", "aria-hidden": "true", title: `event ring · ${state.ringSize} recent emits buffered`, children: ["R", state.ringSize] })), state.kind === 'ok' && (_jsxs("span", { className: "bus-chip-listeners", "aria-hidden": "true", title: `listeners · ${state.listenerCount} live subscriber${state.listenerCount === 1 ? '' : 's'} on bus`, children: ["L", state.listenerCount] })), _jsx("span", { className: "bus-chip-arrow", "aria-hidden": "true", children: "\u2192" })] }));
+}

package/dist/package/browser/components/Sidebar/FilesPanel.d.ts

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