dsh-mcp-panel 0.2.0

package/lib/types/aggregate.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Status aggregation: assemble the read-only server views from the three
+ * facts the panel is allowed to read — loader rows (config, effective
+ * disabled, fiber phase), the tool-registry snapshot, and upstream
+ * `mcp/status` observations (when the proposed seam exists).
+ *
+ * Every field is read defensively: loader configs are raw serialized data
+ * (possibly `!!js` expressions, wrong types, or absent), and upstream
+ * payloads may lack optional fields. A malformed or missing field degrades
+ * to an explicit default instead of throwing — the aggregation must never
+ * take down the panel over one broken row.
+ *
+ * Pure: statuses and reconnect counters are passed in as snapshots.
+ *
+ * @module dsh-mcp-panel/aggregate
+ */
+import { type McpToolGroup } from './grouping.ts';
+import type { McpServerStatus } from './upstream.ts';
+import type { McpFiberPhase, McpPanelSnapshot, McpServerView, McpTransport } from './wire.ts';
+/** One loader-derived mcp-client row (config is raw serialized data). */
+export interface McpLoaderRow {
+    /** Loader entry id (the patch row id). */
+    entryId: string;
+    /** Effective disabled state (parent groups and `!!js` already resolved by the Loader). */
+    disabled: boolean;
+    /** Fiber phase; null when the row has no fiber. */
+    fiberPhase: McpFiberPhase;
+    /** Raw `config` from the entry options; may be anything. */
+    config: unknown;
+}
+/** The exact module name of the official MCP client bridge. */
+export declare const MCP_CLIENT_MODULE = "@deepseek-ai/dsh-mcp-client";
+/** Marker shown for a `!!js` config value, which the panel never evaluates. */
+export declare const JS_EXPRESSION_MARKER = "<expression>";
+/** Sentinel values for "not observed" numeric fields. */
+export declare const UNKNOWN_COUNT = -1;
+/** One server namespace → its upstream observation and derived totals. */
+export interface McpStatusFacts {
+    /** Latest upstream payload per server; absent = not observed. */
+    statuses: ReadonlyMap<string, McpServerStatus>;
+    /** Cumulative reconnect attempts observed per server. */
+    reconnects: ReadonlyMap<string, number>;
+    /** Epoch ms of the latest upstream event receipt per server. */
+    observedAt: ReadonlyMap<string, number>;
+    /** Passive-probe reachability facts per server (empty when probing is off). */
+    probeStates: ReadonlyMap<string, {
+        state: 'reachable' | 'unreachable';
+        checkedAt: number;
+    }>;
+}
+/** Transport and display target derived from one raw mcp-client config. */
+export declare function deriveTarget(config: unknown): {
+    transport: McpTransport;
+    target: string;
+};
+/** Read the server namespace from raw config; absent becomes a stable fallback. */
+export declare function serverNameOf(config: unknown, fallback: string): string;
+/**
+ * Assemble one server view from loader, registry, and upstream facts.
+ * Missing upstream data degrades to `unknown`/`-1`/`null` — never fabricated.
+ *
+ * @param row - the mcp-client loader row, or `undefined` for leftover namespaces.
+ * @param serverName - the effective namespace.
+ * @param group - the tool group for this namespace (possibly empty).
+ * @param facts - upstream observations and reconnect totals.
+ * @returns the display-ready view.
+ */
+export declare function aggregateServerView(row: McpLoaderRow | undefined, serverName: string, group: McpToolGroup | undefined, facts: McpStatusFacts): McpServerView;
+/** Inputs for {@link aggregateSnapshot}; grouped so callers never mix them up. */
+export interface McpAggregateInput {
+    /** Loader mcp-client rows (raw config included). */
+    rows: readonly McpLoaderRow[];
+    /** Tool groups from {@link groupMcpTools}. */
+    groups: readonly McpToolGroup[];
+    /** Upstream status facts (may be empty). */
+    facts: McpStatusFacts;
+    /** Background probe views (may be empty). */
+    probes: McpPanelSnapshot['probes'];
+    /** Absolute profile patch-layer path, or null. */
+    patchFile: string | null;
+    /** Suggested panel refresh interval in ms (`0` = on demand). */
+    refreshIntervalMs: number;
+}
+/**
+ * Assemble the complete snapshot from loader rows, tool groups, upstream
+ * facts, and probe rows. Tolerates missing fields anywhere in the inputs.
+ *
+ * @param input - the snapshot inputs (see {@link McpAggregateInput}).
+ * @returns the wire snapshot.
+ */
+export declare function aggregateSnapshot(input: McpAggregateInput): McpPanelSnapshot;
+//# sourceMappingURL=aggregate.d.ts.map

package/lib/types/aggregate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate.d.ts","sourceRoot":"","sources":["../../src/aggregate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,eAAe,CAAA;AAEhE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AACpD,OAAO,KAAK,EAEV,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,YAAY,EACb,MAAM,WAAW,CAAA;AAElB,yEAAyE;AACzE,MAAM,WAAW,YAAY;IAC3B,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAA;IACf,0FAA0F;IAC1F,QAAQ,EAAE,OAAO,CAAA;IACjB,mDAAmD;IACnD,UAAU,EAAE,aAAa,CAAA;IACzB,4DAA4D;IAC5D,MAAM,EAAE,OAAO,CAAA;CAChB;AAED,+DAA+D;AAC/D,eAAO,MAAM,iBAAiB,gCAAgC,CAAA;AAE9D,+EAA+E;AAC/E,eAAO,MAAM,oBAAoB,iBAAiB,CAAA;AAElD,yDAAyD;AACzD,eAAO,MAAM,aAAa,KAAK,CAAA;AAE/B,0EAA0E;AAC1E,MAAM,WAAW,cAAc;IAC7B,iEAAiE;IACjE,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;IAC9C,yDAAyD;IACzD,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACvC,gEAAgE;IAChE,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACvC,+EAA+E;IAC/E,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,WAAW,GAAG,aAAa,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC5F;AAwCD,2EAA2E;AAC3E,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG;IAAE,SAAS,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAgBzF;AAED,mFAAmF;AACnF,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGtE;AA+BD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,YAAY,GAAG,SAAS,EAC7B,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,YAAY,GAAG,SAAS,EAC/B,KAAK,EAAE,cAAc,GACpB,aAAa,CAiCf;AAED,kFAAkF;AAClF,MAAM,WAAW,iBAAiB;IAChC,oDAAoD;IACpD,IAAI,EAAE,SAAS,YAAY,EAAE,CAAA;IAC7B,8CAA8C;IAC9C,MAAM,EAAE,SAAS,YAAY,EAAE,CAAA;IAC/B,4CAA4C;IAC5C,KAAK,EAAE,cAAc,CAAA;IACrB,6CAA6C;IAC7C,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAA;IAClC,kDAAkD;IAClD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,gEAAgE;IAChE,iBAAiB,EAAE,MAAM,CAAA;CAC1B;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,gBAAgB,CAqB5E"}

package/lib/types/client/McpPanelTab.d.ts

@@ -0,0 +1,16 @@
+/** The read-only MCP management tab: server rows, badges, tools, probes. */
+import { type ReactNode } from 'react';
+import type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { McpPanelSnapshot, ProbeStarted } from '../wire.ts';
+/** Registration-side injected face: the unwrapped snapshot read + probe start. */
+export interface McpPanelTabInjected {
+    /** Read the current Host snapshot (RemoteResult already unwrapped). */
+    status: () => Promise<McpPanelSnapshot>;
+    /** Start a one-shot probe of one streamable-http server (panel-only result). */
+    probe: (serverName: string) => Promise<ProbeStarted>;
+}
+/** Full component props assembled by the Settings slot renderer. */
+export type McpPanelTabProps = PropsRuntime<'settings.plugins.tab'> & PropsLocale<'settings.mcpPanel'> & InjectFace<McpPanelTabInjected>;
+/** Render the read-only MCP management tab. */
+export declare function McpPanelTab({ status, probe, t }: McpPanelTabProps): ReactNode;
+//# sourceMappingURL=McpPanelTab.d.ts.map

package/lib/types/client/McpPanelTab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpPanelTab.d.ts","sourceRoot":"","sources":["../../../src/client/McpPanelTab.tsx"],"names":[],"mappings":"AAAA,4EAA4E;AAE5E,OAAO,EAA8B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AAE7F,OAAO,KAAK,EAAE,gBAAgB,EAAgB,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9E,kFAAkF;AAClF,MAAM,WAAW,mBAAmB;IAClC,uEAAuE;IACvE,MAAM,EAAE,MAAM,OAAO,CAAC,gBAAgB,CAAC,CAAA;IACvC,gFAAgF;IAChF,KAAK,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAA;CACrD;AAED,oEAAoE;AACpE,MAAM,MAAM,gBAAgB,GAC1B,YAAY,CAAC,sBAAsB,CAAC,GAClC,WAAW,CAAC,mBAAmB,CAAC,GAChC,UAAU,CAAC,mBAAmB,CAAC,CAAA;AAuCnC,+CAA+C;AAC/C,wBAAgB,WAAW,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,gBAAgB,GAAG,SAAS,CA2L7E"}

package/lib/types/client/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * `dsh-mcp-panel`, browser half: mounts the `mcpPanel` Remote contribution,
+ * then registers a read-only "MCP" tab into the Plugins settings section
+ * (`settings.plugins.tab`, id `mcp`). All data arrives through the
+ * `remote.mcpPanel` namespace — the tab issues no other RPC and holds no
+ * state of its own beyond expansion and the last loaded snapshot.
+ *
+ * @module dsh-mcp-panel/client
+ */
+import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
+import { type McpPanelLocaleKey } from './locales.ts';
+export type { McpPanelTabInjected, McpPanelTabProps } from './McpPanelTab.tsx';
+export type { McpPanelLocaleKey } from './locales.ts';
+export { presentMcpPanel, connectionBadge, probeBadge } from './present.ts';
+export type { PresentedMcpPanel, PresentedProbeRow, PresentedServerRow, BadgeTone } from './present.ts';
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** MCP management tab copy. */
+        'settings.mcpPanel': McpPanelLocaleKey;
+    }
+}
+/** Dictionary namespace owned by this plugin. */
+export declare const NS = "settings.mcpPanel";
+/** Plugin name: matches the package name, the graph row id, and the bundle id. */
+export declare const name = "dsh-mcp-panel";
+/** Services the tab reads; `remote.mcpPanel` appears once this plugin mounts its contribution. */
+export declare const inject: string[];
+/**
+ * Browser plugin body: dictionaries, the scoped stylesheet, the Remote
+ * contribution mount, and the settings tab registration.
+ *
+ * @param ctx - client root context.
+ */
+export declare function apply(ctx: ClientContext): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAA;AAU3E,OAAO,EAAU,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAM7D,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAC9E,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AACrD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC3E,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAEvG,OAAO,QAAQ,kCAAkC,CAAC;IAChD,UAAU,kBAAkB;QAC1B,+BAA+B;QAC/B,mBAAmB,EAAE,iBAAiB,CAAA;KACvC;CACF;AAED,iDAAiD;AACjD,eAAO,MAAM,EAAE,sBAAsB,CAAA;AAErC,kFAAkF;AAClF,eAAO,MAAM,IAAI,kBAAkB,CAAA;AAEnC,kGAAkG;AAClG,eAAO,MAAM,MAAM,UAAgC,CAAA;AAEnD;;;;;GAKG;AACH,wBAAsB,KAAK,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAiC7D"}

package/lib/types/client/locales.d.ts

@@ -0,0 +1,90 @@
+/** Copy dictionaries for the MCP management Settings tab. */
+/** Simplified Chinese dictionary and key source of truth. */
+export declare const zh: {
+    tab: string;
+    loading: string;
+    error: string;
+    retry: string;
+    empty: string;
+    servers: string;
+    tools: string;
+    noTools: string;
+    status: string;
+    statusUnknown: string;
+    statusDisabled: string;
+    statusFailed: string;
+    statusConnecting: string;
+    statusConnected: string;
+    statusWaiting: string;
+    statusExhausted: string;
+    statusDisposed: string;
+    reconnects: string;
+    lastError: string;
+    none: string;
+    fiber: string;
+    configured: string;
+    retryIn: string;
+    attempt: string;
+    lastEvent: string;
+    filterTools: string;
+    ms: string;
+    derivedNote: string;
+    probes: string;
+    probeEmpty: string;
+    probeRunning: string;
+    probeCompleted: string;
+    probeFailed: string;
+    probeKilled: string;
+    probeStopping: string;
+    probeNow: string;
+    probeReachable: string;
+    probeUnreachable: string;
+    probeFailedAction: string;
+    patchHint: string;
+};
+/** MCP panel locale key union. */
+export type McpPanelLocaleKey = keyof typeof zh;
+/** English dictionary checked against the Chinese key set. */
+export declare const en: {
+    tab: string;
+    loading: string;
+    error: string;
+    retry: string;
+    empty: string;
+    servers: string;
+    tools: string;
+    noTools: string;
+    status: string;
+    statusUnknown: string;
+    statusDisabled: string;
+    statusFailed: string;
+    statusConnecting: string;
+    statusConnected: string;
+    statusWaiting: string;
+    statusExhausted: string;
+    statusDisposed: string;
+    reconnects: string;
+    lastError: string;
+    none: string;
+    fiber: string;
+    configured: string;
+    retryIn: string;
+    attempt: string;
+    lastEvent: string;
+    filterTools: string;
+    ms: string;
+    derivedNote: string;
+    probes: string;
+    probeEmpty: string;
+    probeRunning: string;
+    probeCompleted: string;
+    probeFailed: string;
+    probeKilled: string;
+    probeStopping: string;
+    probeNow: string;
+    probeReachable: string;
+    probeUnreachable: string;
+    probeFailedAction: string;
+    patchHint: string;
+};
+//# sourceMappingURL=locales.d.ts.map

package/lib/types/client/locales.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locales.d.ts","sourceRoot":"","sources":["../../../src/client/locales.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAE7D,6DAA6D;AAC7D,eAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyCmB,CAAA;AAElC,kCAAkC;AAClC,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,EAAE,CAAA;AAE/C,8DAA8D;AAC9D,eAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyC8B,CAAA"}

package/lib/types/client/present.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Pure presentation for the MCP settings tab: maps the wire snapshot onto
+ * render-ready rows and badge codes. No I/O, no clock, no random — a session
+ * replay or a test may call it any number of times and get the same result.
+ * Localization happens in the component through the locale dictionaries;
+ * this module emits stable codes only.
+ *
+ * @module dsh-mcp-panel/client/present
+ */
+import type { McpPanelSnapshot, McpServerView, McpProbeView } from '../wire.ts';
+/** Badge tones the stylesheet understands. */
+export type BadgeTone = 'ok' | 'warn' | 'error' | 'muted';
+/** Render-ready server row plus derived badge facts. */
+export interface PresentedServerRow {
+    /** The wire server view, unchanged. */
+    readonly view: McpServerView;
+    /** Badge tone for the connection state. */
+    readonly tone: BadgeTone;
+    /** Badge code: `disabled` | `failed` | a connection phase | `unknown`. */
+    readonly badge: 'disabled' | 'failed' | 'connecting' | 'connected' | 'waiting' | 'exhausted' | 'disposed' | 'unknown';
+    /** Whether the row shows an error badge (sanitized `lastError` present). */
+    readonly hasError: boolean;
+    /** Display form of the reconnect count (`-1` → null = dash). */
+    readonly reconnects: number | null;
+    /** Whole seconds since the last upstream event; `null` = never observed. */
+    readonly ageSeconds: number | null;
+    /** Whether the attempt/maxAttempts pair is displayable (either is known). */
+    readonly hasAttemptBudget: boolean;
+}
+/** Render-ready probe row. */
+export interface PresentedProbeRow {
+    /** The wire probe view, unchanged. */
+    readonly view: McpProbeView;
+    /** Badge tone for the probe state. */
+    readonly tone: BadgeTone;
+    /** Badge code for the probe state. */
+    readonly badge: 'running' | 'completed' | 'failed' | 'killed' | 'stopping';
+}
+/** The complete render-ready tab model. */
+export interface PresentedMcpPanel {
+    /** Servers in snapshot order. */
+    readonly servers: readonly PresentedServerRow[];
+    /** Probes in snapshot order (newest first). */
+    readonly probes: readonly PresentedProbeRow[];
+    /** Whether the snapshot carries any server rows. */
+    readonly empty: boolean;
+    /** Whether connection fields came from upstream or are derived. */
+    readonly observed: boolean;
+    /** Absolute profile patch-layer path for the hint line, or null. */
+    readonly patchFile: string | null;
+    /** Suggested refresh interval in ms (`0` = on demand only). */
+    readonly refreshIntervalMs: number;
+}
+/**
+ * Derive the connection badge for one server row. Order matters: the entry
+ * being disabled or its fiber failed is a configuration fact that beats the
+ * (derived or upstream) connection phase.
+ *
+ * @param view - the assembled server view.
+ * @returns the badge code and tone.
+ */
+export declare function connectionBadge(view: McpServerView): {
+    badge: PresentedServerRow['badge'];
+    tone: BadgeTone;
+};
+/** Badge for one probe state. */
+export declare function probeBadge(status: McpProbeView['status']): {
+    badge: PresentedProbeRow['badge'];
+    tone: BadgeTone;
+};
+/**
+ * Project the wire snapshot onto render-ready rows.
+ *
+ * @param snapshot - the `mcpPanel/status` value.
+ * @param now - epoch ms anchor for age computations (keeps the fold pure).
+ * @returns the tab model.
+ */
+export declare function presentMcpPanel(snapshot: McpPanelSnapshot, now?: number): PresentedMcpPanel;
+//# sourceMappingURL=present.d.ts.map

package/lib/types/client/present.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"present.d.ts","sourceRoot":"","sources":["../../../src/client/present.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE/E,8CAA8C;AAC9C,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAA;AAEzD,wDAAwD;AACxD,MAAM,WAAW,kBAAkB;IACjC,uCAAuC;IACvC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;IAC5B,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,QAAQ,GAAG,YAAY,GAAG,WAAW,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,CAAA;IACrH,4EAA4E;IAC5E,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,gEAAgE;IAChE,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,4EAA4E;IAC5E,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,6EAA6E;IAC7E,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAA;CACnC;AAED,8BAA8B;AAC9B,MAAM,WAAW,iBAAiB;IAChC,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;IAC3B,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,sCAAsC;IACtC,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAA;CAC3E;AAED,2CAA2C;AAC3C,MAAM,WAAW,iBAAiB;IAChC,iCAAiC;IACjC,QAAQ,CAAC,OAAO,EAAE,SAAS,kBAAkB,EAAE,CAAA;IAC/C,+CAA+C;IAC/C,QAAQ,CAAC,MAAM,EAAE,SAAS,iBAAiB,EAAE,CAAA;IAC7C,oDAAoD;IACpD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,oEAAoE;IACpE,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,+DAA+D;IAC/D,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;CACnC;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG;IAAE,KAAK,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAc5G;AAED,iCAAiC;AACjC,wBAAgB,UAAU,CAAC,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,GAAG;IAAE,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAQjH;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,SAAa,GAAG,iBAAiB,CAyB/F"}

package/lib/types/client/remote.d.ts

@@ -0,0 +1,119 @@
+/**
+ * The client-side Remote face of the `mcpPanel` namespace: the hand-written
+ * `TypertRemoteContribution` mounted through `ctx.remote.$mount`, plus the
+ * declaration merging that types `ctx.remote.mcpPanel`. The descriptor list
+ * is shared with the host `./typert` manifest (`../wire.ts`), so the two
+ * faces can never drift.
+ *
+ * @module dsh-mcp-panel/client/remote
+ */
+import type { RemoteResult } from '@deepseek-ai/dsh-typert-protocol';
+import type { McpPanelSnapshot, ProbeStarted } from '../wire.ts';
+declare module '@deepseek-ai/dsh-typert-protocol' {
+    interface TypertRemoteNamespace$mcpPanel {
+        /** Read the current read-only MCP snapshot. */
+        status: () => Promise<RemoteResult<McpPanelSnapshot>>;
+        /** Start a one-shot connectivity probe of one streamable-http server. */
+        probe: (serverName: string) => Promise<RemoteResult<ProbeStarted>>;
+    }
+    interface TypertRemoteMap {
+        'mcpPanel/status': () => Promise<RemoteResult<McpPanelSnapshot>>;
+        'mcpPanel/probe': (serverName: string) => Promise<RemoteResult<ProbeStarted>>;
+    }
+    interface TypertRemoteNamespaceMap {
+        mcpPanel: TypertRemoteNamespace$mcpPanel;
+    }
+}
+/** The client Remote contribution for the `mcpPanel` namespace. */
+export declare const MCP_PANEL_REMOTE: Readonly<{
+    package: string;
+    descriptors: readonly (Readonly<{
+        readonly id: "dsh-mcp-panel#mcpPanel/status";
+        readonly service: "mcpPanel";
+        readonly namespace: "mcpPanel";
+        readonly method: "status";
+        readonly invocation: Readonly<{
+            kind: "direct";
+        }>;
+        readonly parameters: readonly never[];
+        readonly result: Readonly<{
+            mode: "strict";
+            typeSymbol: "dsh-mcp-panel/types#McpPanelSnapshot";
+            schema: import("zod").ZodObject<{
+                observed: import("zod").ZodBoolean;
+                patchFile: import("zod").ZodNullable<import("zod").ZodString>;
+                refreshIntervalMs: import("zod").ZodNumber;
+                servers: import("zod").ZodArray<import("zod").ZodObject<{
+                    serverName: import("zod").ZodString;
+                    entryId: import("zod").ZodString;
+                    transport: import("zod").ZodUnion<readonly [import("zod").ZodLiteral<"stdio">, import("zod").ZodLiteral<"streamable-http">, import("zod").ZodLiteral<"unknown">]>;
+                    target: import("zod").ZodString;
+                    enabled: import("zod").ZodBoolean;
+                    fiberPhase: import("zod").ZodUnion<readonly [import("zod").ZodLiteral<"pending">, import("zod").ZodLiteral<"loading">, import("zod").ZodLiteral<"active">, import("zod").ZodLiteral<"failed">, import("zod").ZodLiteral<"unloading">, import("zod").ZodNull]>;
+                    configuredNote: import("zod").ZodNullable<import("zod").ZodString>;
+                    toolCount: import("zod").ZodNumber;
+                    tools: import("zod").ZodArray<import("zod").ZodObject<{
+                        name: import("zod").ZodString;
+                        description: import("zod").ZodString;
+                    }, import("zod/v4/core").$strip>>;
+                    phase: import("zod").ZodUnion<readonly [import("zod").ZodLiteral<"connecting">, import("zod").ZodLiteral<"connected">, import("zod").ZodLiteral<"waiting">, import("zod").ZodLiteral<"exhausted">, import("zod").ZodLiteral<"disposed">, import("zod").ZodLiteral<"unknown">]>;
+                    attempt: import("zod").ZodNumber;
+                    maxAttempts: import("zod").ZodNumber;
+                    delayMs: import("zod").ZodNullable<import("zod").ZodNumber>;
+                    reconnectCount: import("zod").ZodNumber;
+                    lastError: import("zod").ZodNullable<import("zod").ZodString>;
+                    connectedAt: import("zod").ZodNullable<import("zod").ZodNumber>;
+                    observedAt: import("zod").ZodNullable<import("zod").ZodNumber>;
+                    probeState: import("zod").ZodUnion<readonly [import("zod").ZodLiteral<"reachable">, import("zod").ZodLiteral<"unreachable">, import("zod").ZodNull]>;
+                    probeCheckedAt: import("zod").ZodNullable<import("zod").ZodNumber>;
+                    statusSource: import("zod").ZodUnion<readonly [import("zod").ZodLiteral<"upstream-event">, import("zod").ZodLiteral<"derived">]>;
+                }, import("zod/v4/core").$strip>>;
+                probes: import("zod").ZodArray<import("zod").ZodObject<{
+                    id: import("zod").ZodString;
+                    serverName: import("zod").ZodString;
+                    status: import("zod").ZodUnion<readonly [import("zod").ZodLiteral<"running">, import("zod").ZodLiteral<"stopping">, import("zod").ZodLiteral<"completed">, import("zod").ZodLiteral<"killed">, import("zod").ZodLiteral<"failed">]>;
+                    startedAt: import("zod").ZodNumber;
+                    finishedAt: import("zod").ZodNullable<import("zod").ZodNumber>;
+                    detail: import("zod").ZodNullable<import("zod").ZodString>;
+                }, import("zod/v4/core").$strip>>;
+            }, import("zod/v4/core").$strip>;
+        }>;
+        readonly sourceLocation: Readonly<{
+            file: "src/wire.ts";
+            line: 1;
+            column: 1;
+        }>;
+    }> | Readonly<{
+        readonly id: "dsh-mcp-panel#mcpPanel/probe";
+        readonly service: "mcpPanel";
+        readonly namespace: "mcpPanel";
+        readonly method: "probe";
+        readonly invocation: Readonly<{
+            kind: "direct";
+        }>;
+        readonly parameters: readonly Readonly<{
+            name: string;
+            wire: string;
+            source: "json";
+            codec: Readonly<{
+                mode: "strict";
+                typeSymbol: "dsh-mcp-panel/types#ProbeRequestServerName";
+                schema: import("zod").ZodString;
+            }>;
+        }>[];
+        readonly result: Readonly<{
+            mode: "strict";
+            typeSymbol: "dsh-mcp-panel/types#ProbeStarted";
+            schema: import("zod").ZodObject<{
+                jobId: import("zod").ZodString;
+                note: import("zod").ZodString;
+            }, import("zod/v4/core").$strip>;
+        }>;
+        readonly sourceLocation: Readonly<{
+            file: "src/wire.ts";
+            line: 1;
+            column: 1;
+        }>;
+    }>)[];
+}>;
+//# sourceMappingURL=remote.d.ts.map

package/lib/types/client/remote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../../../src/client/remote.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAA4B,MAAM,kCAAkC,CAAA;AAE9F,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAEhE,OAAO,QAAQ,kCAAkC,CAAC;IAChD,UAAU,8BAA8B;QACtC,+CAA+C;QAC/C,MAAM,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC,CAAA;QACrD,yEAAyE;QACzE,KAAK,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,CAAA;KACnE;IACD,UAAU,eAAe;QACvB,iBAAiB,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC,CAAA;QAChE,gBAAgB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,CAAA;KAC9E;IACD,UAAU,wBAAwB;QAChC,QAAQ,EAAE,8BAA8B,CAAA;KACzC;CACF;AAED,mEAAmE;AACnE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGQ,CAAA"}

package/lib/types/client/styles.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Scoped stylesheet for the MCP tab. Standalone client bundles cannot use the
+ * in-repo CSS-module pipeline, so the sheet ships as a string and is
+ * installed effect-scoped into a `<style data-dsh-mcp-panel>` element.
+ * Every selector is scoped under `[data-dsh-mcp-panel]` and uses theme
+ * design tokens only, so it follows both color schemes.
+ *
+ * @module dsh-mcp-panel/client/styles
+ */
+/** One `<style>` installation; returns the exact disposer that removes it. */
+export declare function installPanelStyles(): () => void;
+//# sourceMappingURL=styles.d.ts.map

package/lib/types/client/styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../src/client/styles.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,8EAA8E;AAC9E,wBAAgB,kBAAkB,IAAI,MAAM,IAAI,CAQ/C"}

package/lib/types/command.d.ts

@@ -0,0 +1,122 @@
+/**
+ * The `/mcp` human command over the official MCP client's observable facts.
+ * Output is a standard `CommandResult` (model-readable, logged by the
+ * commands service as `command/run` + `command/done`, so every line is
+ * reconstructable from the session log).
+ *
+ * - `/mcp` — one row per server: transport, target, tool count, connection
+ *   status (honest: `unknown` until the upstream seam ships), recent error,
+ *   reconnect count.
+ * - `/mcp <server>` — that server's row.
+ * - `/mcp <server> tools` — model-visible tool names + one-line descriptions.
+ * - `/mcp <server> disable|enable` — a controlled patch suggestion (the exact
+ *   `cordis.patch.yml` line + the reload path). The command never edits
+ *   configuration files and never fakes a runtime effect.
+ *
+ * Renderers are pure functions of the snapshot plus a message dictionary, so
+ * the output language is a config choice (`outputLanguage: en|zh`) without
+ * touching the command lifecycle.
+ *
+ * @module dsh-mcp-panel/command
+ */
+import type { CommandDefinition } from '@deepseek-ai/dsh-commands';
+import type { McpPanelService } from './service.ts';
+import type { McpPanelSnapshot, McpServerView } from './wire.ts';
+/** Display language for the `/mcp` output. */
+export type CommandLanguage = 'en' | 'zh' | 'es' | 'pt' | 'hi';
+/** Every display string the renderers emit, per language. */
+export interface CommandMessages {
+    enabled: string;
+    disabled: string;
+    status: string;
+    reconnects: string;
+    lastError: string;
+    retryIn: string;
+    cordisFiberFailed: string;
+    tools: string;
+    serversHeader: (count: number) => string;
+    noServers: string;
+    noteNoSeam: string;
+    noteProposal: string;
+    noTools: (server: string) => string;
+    toolsHeader: (server: string, count: number) => string;
+    noDescription: string;
+    patchIntro: (action: string, server: string, entryId: string, patchFile: string | null) => string;
+    patchNoRuntimeToggle: string;
+    patchReloadPath: string;
+    usage: string;
+    probeStarted: (server: string, jobId: string) => string;
+    unknownServer: (server: string, known: string) => string;
+}
+/** English output dictionary (default). */
+export declare const EN_MESSAGES: CommandMessages;
+/** Simplified Chinese output dictionary. */
+export declare const ZH_MESSAGES: CommandMessages;
+/** Spanish output dictionary. */
+export declare const ES_MESSAGES: CommandMessages;
+/** Portuguese output dictionary. */
+export declare const PT_MESSAGES: CommandMessages;
+/** Hindi output dictionary. */
+export declare const HI_MESSAGES: CommandMessages;
+/**
+ * Render one server row: `name [entryId] transport target | N tools | …`.
+ *
+ * @param view - the assembled server view.
+ * @param messages - the output dictionary.
+ * @returns the single display line.
+ */
+export declare function renderServer(view: McpServerView, messages?: CommandMessages): string;
+/**
+ * Render the no-argument listing.
+ *
+ * @param snapshot - the current snapshot.
+ * @param messages - the output dictionary.
+ * @returns the full listing text.
+ */
+export declare function renderList(snapshot: McpPanelSnapshot, messages?: CommandMessages): string;
+/**
+ * Render the tool list for one server.
+ *
+ * @param view - the assembled server view.
+ * @param messages - the output dictionary.
+ * @returns the tool listing text.
+ */
+export declare function renderTools(view: McpServerView, messages?: CommandMessages): string;
+/**
+ * Render the controlled enable/disable patch suggestion. Reads only; the user
+ * applies the line themselves. The web surface hot-reloads the profile patch
+ * layer; other surfaces apply it on restart.
+ *
+ * @param view - the assembled server view.
+ * @param action - which direction the suggestion flips.
+ * @param patchFile - absolute profile patch-layer path, or null when unknown.
+ * @param messages - the output dictionary.
+ * @returns the suggestion text.
+ */
+export declare function renderPatchSuggestion(view: McpServerView, action: 'disable' | 'enable', patchFile: string | null, messages?: CommandMessages): string;
+/** Parsed `/mcp` arguments. */
+export type McpCommandArgs = {
+    readonly kind: 'list';
+} | {
+    readonly kind: 'server';
+    readonly server: string;
+    readonly action: 'detail' | 'tools' | 'disable' | 'enable' | 'probe';
+} | {
+    readonly kind: 'usage';
+};
+/**
+ * Parse the free-form command input.
+ *
+ * @param rawInput - text after `/mcp`, including leading whitespace.
+ * @returns the parsed intent; malformed input becomes `usage`.
+ */
+export declare function parseMcpArgs(rawInput: string): McpCommandArgs;
+/**
+ * Build the `/mcp` command definition over one service instance.
+ *
+ * @param service - the panel service supplying snapshots.
+ * @param language - output language for the rendered text.
+ * @returns the registration-ready definition.
+ */
+export declare function mcpCommand(service: McpPanelService, language?: CommandLanguage): CommandDefinition;
+//# sourceMappingURL=command.d.ts.map

package/lib/types/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/command.ts"],"names":[],"mappings":"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"}