@fonlan/dsh-model-parameters 0.1.0

package/lib/types/server/catalog.d.ts

@@ -0,0 +1,83 @@
+import { type ModelParametersConfig } from '../shared/config.js';
+/** Structural logger subset satisfied by cordis' LoggerService. */
+export interface CatalogLogger {
+    info(format: any, ...param: any[]): void;
+    warn(format: any, ...param: any[]): void;
+}
+/** One flattened models.dev entry. */
+export interface CatalogEntry {
+    /** models.dev provider id that carries this model. */
+    provider: string;
+    /** Full model id as models.dev keys it (may carry a vendor/ prefix). */
+    id: string;
+    /** Display name. */
+    name?: string;
+    /** Context window in tokens, when known. */
+    context?: number;
+    /** Output limit in tokens, when known. */
+    output?: number;
+    /** Whether the model reasons at all, when stated. */
+    reasoning?: boolean;
+    /** Offered reasoning effort levels (e.g. ["low","high","max"]). */
+    effortValues?: string[];
+    /** Accepted request modalities, raw from models.dev (may include pdf/audio/video). */
+    input?: string[];
+}
+export interface CatalogSnapshot {
+    /** Flattened entries in stable provider order. */
+    entries: CatalogEntry[];
+    /** Number of models.dev providers covered. */
+    providers: number;
+    /** Epoch ms the cache was last fetched (0 = never fetched). */
+    fetchedAt: number;
+}
+export declare class CatalogManager {
+    private readonly logger;
+    private snapshot;
+    private loaded;
+    private inflight;
+    private readonly dir;
+    private readonly cachePath;
+    constructor(logger: CatalogLogger, dataDir?: string);
+    /** The current snapshot (empty until the first load/fetch completes). */
+    snapshotOf(): CatalogSnapshot;
+    /**
+     * Load the disk cache once, then fetch when stale (or `force`). A failed
+     * fetch keeps the last good cache; with no cache at all the snapshot stays
+     * empty and the caller simply fills nothing. Concurrent callers share one
+     * in-flight refresh.
+     * @returns true when the snapshot may have changed.
+     */
+    ensureFresh(config: Pick<ModelParametersConfig, 'ttlDays'>, force?: boolean): Promise<boolean>;
+    /** Force a fetch now; never throws (falls back to cache or keeps empty). */
+    refresh(ttlDays: number): Promise<boolean>;
+    /**
+     * Resolve one dsh model id to the best catalog entry for its provider.
+     * @param modelId - the model id stored in the dsh provider profile.
+     * @param dshProvider - the dsh provider route id.
+     * @param config - plugin config (providerMap + officialProviders).
+     */
+    resolve(modelId: string, dshProvider: string, config: Pick<ModelParametersConfig, 'providerMap' | 'officialProviders'>): CatalogEntry | undefined;
+    /**
+     * All entries whose stripped id matches, plus any whose full id matches
+     * exactly (a dsh model id may already carry a vendor/ prefix that models.dev
+     * keys verbatim).
+     */
+    private candidatesFor;
+    private loadCache;
+    private fetchAndPersist;
+    private buildSnapshot;
+}
+/**
+ * Build the dsh `reasoningEfforts` identity dict from models.dev effort
+ * values, filtered to the levels dsh accepts. Returns undefined when nothing
+ * valid is offered (or the model does not state reasoning).
+ */
+export declare function identityReasoningEfforts(entry: CatalogEntry): Record<string, string> | undefined;
+/**
+ * The dsh-writable input modality list for one entry: models.dev values
+ * intersected with what pi-ai accepts. Returns undefined when nothing is
+ * accepted (writing an empty list is semantically "keep defaults", so absent
+ * is the honest fill).
+ */
+export declare function acceptedInputModalities(entry: CatalogEntry): ('text' | 'image')[] | undefined;

package/lib/types/server/rpc.d.ts

@@ -0,0 +1,3 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { ModelParametersService } from './service.js';
+export declare function registerApiRoutes(ctx: Context, service: ModelParametersService): () => void;

package/lib/types/server/service.d.ts

@@ -0,0 +1,66 @@
+/**
+ * The model-parameters service: owns the plugin settings namespace, watches
+ * the `llm-pi-ai` namespace for provider model writes, reconciles missing
+ * fields from the cached models.dev catalog, and tracks a fill report.
+ *
+ * Trigger model:
+ *  - any committed `llm-pi-ai` settings change (settings UI apply, manual
+ *    settings.yaml edit published by the file provider, model-router-style
+ *    external writes) runs a reconcile;
+ *  - plugin start runs a backfill reconcile over the existing configuration.
+ * Reconcile is fill-only: it never overwrites a present field, and it writes
+ * nothing when nothing is missing — so its own writes cannot re-trigger a
+ * second patch (the next event sees the fields present and produces no ops).
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import { type ModelParametersConfig } from '../shared/config.js';
+import { type CatalogSnapshot } from './catalog.js';
+/** One reconcile run's outcome, surfaced to the settings page. */
+export interface FillReport {
+    at: number;
+    /** Number of individual field fills applied. */
+    filled: number;
+    /** Number of providers whose models array was rewritten. */
+    touched: number;
+    /** Model ids (provider/model) that matched nothing in the catalog. */
+    unmatched: string[];
+}
+export declare class ModelParametersService {
+    private readonly ctx;
+    /**
+     * The settings service value captured from the inject callback. The plugin
+     * itself declares `inject: []` (settings is optional — headless profiles
+     * have no settings service), so `this.ctx.settings` is never resolvable:
+     * the context proxy only walks ancestor fibers, and the provider lives on
+     * a sibling fiber. The injected child ctx itself is only valid while its
+     * fiber is active — the provider can be reloaded (and every dependent
+     * fiber torn down) while an async reconcile is in flight — so all reads
+     * and writes go through the captured service value, which is a plain
+     * object and never walks the fiber chain.
+     */
+    private settings;
+    private scope;
+    private lastReport;
+    private readonly catalog;
+    private reconciling;
+    constructor(ctx: Context);
+    start(): void;
+    stop(): void;
+    config(): ModelParametersConfig;
+    catalogSnapshot(): CatalogSnapshot;
+    report(): FillReport | null;
+    /** Force a catalog refresh, then reconcile and report. */
+    refreshAndReconcile(): Promise<void>;
+    /** Update plugin config toggles from the settings page. */
+    updateConfig(patch: Partial<ModelParametersConfig>): Promise<void>;
+    /**
+     * Fill missing fields on every provider model from the catalog. Serialized:
+     * concurrent triggers (event + backfill) coalesce into one run. Fill-only
+     * guarantees termination: after a write the fields are present, so the next
+     * event produces no ops.
+     */
+    reconcile(): Promise<void>;
+    private runReconcile;
+    /** Fill one model entry (fill-only), returning the same object when untouched. */
+    private fillModel;
+}

package/lib/types/shared/config.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Plugin configuration and shared constants for @fonlan/dsh-model-parameters.
+ *
+ * The plugin owns the `model-parameters` settings namespace (stored in
+ * settings.yaml) and OBSERVES the `llm-pi-ai` namespace: whenever provider
+ * models are written there with missing capability fields (which is the norm
+ * for a freshly synced gateway), it patches the missing fields from the cached
+ * models.dev catalog.
+ */
+import z from '@deepseek-ai/schemastery';
+/** This plugin's own settings namespace. */
+export declare const PLUGIN_NS = "model-parameters";
+/** The namespace whose models this plugin completes: pi-ai provider profiles. */
+export declare const TARGET_NS = "llm-pi-ai";
+/** models.dev catalog endpoint. */
+export declare const CATALOG_URL = "https://models.dev/api.json";
+/** Default provider ids treated as first-party vendors (tie-break for id collisions). */
+export declare const DEFAULT_OFFICIAL_PROVIDERS: readonly string[];
+/**
+ * dsh pi-ai only accepts these request modalities; models.dev may also list
+ * pdf/audio/video, which must be filtered out before writing (schema rejects
+ * unknown modality values).
+ */
+export declare const ACCEPTED_INPUT_MODALITIES: readonly string[];
+/**
+ * Valid `reasoningEfforts` keys in pi-ai, in escalation order. models.dev
+ * effort values like `default`/`none`/empty are filtered out; only values in
+ * this set are written.
+ */
+export declare const REASONING_LEVELS: readonly string[];
+/** Plugin configuration shape. */
+export interface ModelParametersConfig {
+    /** Master switch: when off, no fills happen (listener is inert). */
+    enabled: boolean;
+    /** How many days a cached models.dev catalog is considered fresh. */
+    ttlDays: number;
+    /** Fill display name from the catalog when the entry lacks one. */
+    fillName: boolean;
+    /** Fill contextWindow when the entry lacks one. */
+    fillContext: boolean;
+    /** Fill maxTokens when the entry lacks one. */
+    fillMaxTokens: boolean;
+    /** Fill reasoningEfforts (identity dict over offered effort levels) when absent. */
+    fillReasoning: boolean;
+    /** Fill input modalities (filtered to text/image) when absent. */
+    fillInput: boolean;
+    /** dsh provider id -> models.dev provider id overrides for matching. */
+    providerMap: Record<string, string>;
+    /** models.dev provider ids treated as first-party vendors for tie-breaking. */
+    officialProviders: string[];
+}
+export declare const Config: z<ModelParametersConfig>;
+export declare const DEFAULT_CONFIG: ModelParametersConfig;

package/package.json

@@ -0,0 +1,98 @@
+{
+  "name": "@fonlan/dsh-model-parameters",
+  "version": "0.1.0",
+  "description": "DSH plugin: when a provider's model sync returns only ids, automatically fill display name, context window, max output tokens, reasoning efforts, and input modalities from the models.dev catalog (cached, TTL-refreshed), and surface a settings page with toggles, refresh, and a fill report.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fonlan/dsh-model-parameters.git"
+  },
+  "bugs": {
+    "url": "https://github.com/fonlan/dsh-model-parameters/issues"
+  },
+  "homepage": "https://github.com/fonlan/dsh-model-parameters",
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "plugin",
+    "model",
+    "models.dev",
+    "catalog",
+    "provider"
+  ],
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "src",
+    "cordis.patch.yml",
+    "README.md",
+    "README.en.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "rm -rf lib && tsc -p tsconfig.build.json && tsdown",
+    "prepare": "npm run build",
+    "typecheck": "tsc --noEmit -p tsconfig.json && tsc --noEmit -p tsconfig.client.json",
+    "watch": "tsdown --watch"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-slots",
+        "@deepseek-ai/dsh-client-ui-settings"
+      ]
+    }
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/schemastery": "^3.18.1",
+    "@deepseek-ai/dsh-settings": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-llm-pi-ai": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.6",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/react": "~18.3.1",
+    "@types/react-dom": "~18.3.0",
+    "tsdown": "^0.22.14",
+    "typescript": "^5.9.0",
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/schemastery": "^3.18.1",
+    "@deepseek-ai/dsh-settings": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-llm-pi-ai": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.6"
+  },
+  "packageManager": "pnpm@11.21.0"
+}

package/src/client/api.ts

@@ -0,0 +1,59 @@
+/** Client transport for the model-parameters settings API. */
+import type { ModelParametersConfig } from '../shared/config.js'
+
+export interface CatalogView {
+  entries: number
+  providers: number
+  fetchedAt: number
+  fresh: boolean
+  ttlDays: number
+}
+
+export interface FillReportView {
+  at: number
+  filled: number
+  touched: number
+  unmatched: string[]
+}
+
+export interface PluginState {
+  config: ModelParametersConfig
+  catalog: CatalogView
+  report: FillReportView | null
+}
+
+export class ModelParametersApiError extends Error {
+  constructor(readonly code: string, message: string) {
+    super(message)
+  }
+}
+
+async function call<T>(method: string, payload: Record<string, unknown> = {}): Promise<T> {
+  let response: Response
+  try {
+    response = await fetch(`/plugins/@fonlan/dsh-model-parameters/api/${method}`, {
+      method: 'POST',
+      headers: { 'content-type': 'application/json' },
+      body: JSON.stringify(payload),
+    })
+  } catch (error) {
+    throw new ModelParametersApiError('network', error instanceof Error ? error.message : String(error))
+  }
+  const parsed: { ok?: boolean; value?: unknown; error?: { code?: string; message?: string } } | null
+    = await response.json().catch(() => null)
+  if (!response.ok || parsed === null || parsed.ok !== true || parsed.value === undefined) {
+    throw new ModelParametersApiError(
+      parsed?.error?.code ?? 'http',
+      parsed?.error?.message ?? `HTTP ${response.status}`,
+    )
+  }
+  return parsed.value as T
+}
+
+export const api = {
+  state: () => call<PluginState>('state'),
+  refresh: () => call<PluginState>('refresh'),
+  reconcile: () => call<PluginState>('reconcile'),
+  setConfig: (patch: Partial<ModelParametersConfig>) =>
+    call<PluginState>('set-config', { patch }),
+}

package/src/client/index.tsx

@@ -0,0 +1,33 @@
+/**
+ * @fonlan/dsh-model-parameters client half: the Model Parameters settings
+ * page, registered into the settings section slot.
+ */
+import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client'
+import type {} from '@deepseek-ai/dsh-client-locale/client'
+import type {} from '@deepseek-ai/dsh-client-ui-slots'
+import type {} from '@deepseek-ai/dsh-client-ui-settings/client'
+import { LOCALE_NS, zh, en } from './locales'
+import { makeSettingsSection } from './settings-section'
+
+/** Services required before mounting (provided by the client runtime). */
+export const inject = ['slots', 'locale']
+
+/** Client plugin body. */
+export function apply(ctx: ClientContext): void {
+  const t = ctx.locale.bind(LOCALE_NS)
+  ctx.effect(() => {
+    const off = ctx.locale.register(LOCALE_NS, { zh, en })
+    return () => off()
+  }, 'model-parameters: dictionaries')
+
+  const SettingsSection = makeSettingsSection(ctx)
+  ctx.slots.inject('settings.section', () =>
+    ctx.slots.register({
+      name: 'settings.section',
+      id: 'model-parameters',
+      order: 320,
+      label: () => t('settingsTitle'),
+      locale: LOCALE_NS,
+    }, SettingsSection as never),
+  )
+}

package/src/client/locales.ts

@@ -0,0 +1,95 @@
+/**
+ * Locale dictionaries for @fonlan/dsh-model-parameters settings page.
+ * zh is the key source of truth; en must carry the exact same key set.
+ */
+export const LOCALE_NS = 'model-parameters'
+
+export const zh = {
+  settingsTitle: '模型参数补全',
+  description: '同步模型时自动从 models.dev 目录补全缺失的显示名称、最大上下文、最大输出、推理强度与输入模态。',
+  master: '启用自动补全',
+  masterDesc: '关闭后不再自动补全任何字段（已补全的值保留）。',
+  fields: '补全字段',
+  fillName: '显示名称',
+  fillNameDesc: '模型条目缺 name 时写入目录中的显示名称。',
+  fillContext: '最大上下文',
+  fillContextDesc: '缺 contextWindow 时写入目录的上下文上限。',
+  fillMaxTokens: '最大输出',
+  fillMaxTokensDesc: '缺 maxTokens 时写入目录的输出上限。',
+  fillReasoning: '推理强度',
+  fillReasoningDesc: '缺 reasoningEfforts 时按目录 effort 档位写入 identity 字典（如 {high:"high", max:"max"}）。',
+  fillInput: '输入模态',
+  fillInputDesc: '缺 input 时写入目录中的 text/image 模态。',
+  ttl: '目录更新周期（天）',
+  ttlDesc: '缓存的 models.dev 目录超过该天数后，在下次补全时自动刷新。',
+  providerMap: 'Provider 映射',
+  providerMapDesc: 'dsh provider → models.dev provider 的匹配覆盖（可选）。',
+  addMapping: '添加映射',
+  removeMapping: '移除',
+  catalog: '模型目录',
+  catalogEntries: '目录条目',
+  catalogProviders: '覆盖 Provider',
+  catalogFetched: '上次更新',
+  catalogFresh: '新鲜',
+  catalogStale: '已过期',
+  catalogNever: '尚未获取',
+  refresh: '立即更新目录并补全',
+  refreshBusy: '更新中…',
+  reconcileNow: '立即补全一次',
+  report: '最近一次补全',
+  reportNever: '尚未执行',
+  reportFilled: '补全字段',
+  reportTouched: '涉及 Provider',
+  reportUnmatched: '未匹配模型',
+  reportEmpty: '全部匹配，无未匹配项',
+  reportAt: '时间',
+  error: '加载失败',
+  saving: '保存中…',
+  officialProviders: '官方厂商优先级',
+  officialProvidersDesc: '同一模型 id 在多处出现时，优先采用这些 models.dev provider 的条目。',
+} as const
+
+export const en: Record<keyof typeof zh, string> = {
+  settingsTitle: 'Model Parameters',
+  description: 'Auto-fill missing display name, context window, max output, reasoning efforts and input modalities from the models.dev catalog when syncing models.',
+  master: 'Enable auto-fill',
+  masterDesc: 'When off, no fields are filled (already-filled values are kept).',
+  fields: 'Fields to fill',
+  fillName: 'Display name',
+  fillNameDesc: 'Write the catalog display name when a model entry lacks name.',
+  fillContext: 'Context window',
+  fillContextDesc: 'Write the catalog context limit when contextWindow is missing.',
+  fillMaxTokens: 'Max output',
+  fillMaxTokensDesc: 'Write the catalog output limit when maxTokens is missing.',
+  fillReasoning: 'Reasoning efforts',
+  fillReasoningDesc: 'Write an identity reasoningEfforts dict (e.g. {high:"high", max:"max"}) from catalog effort levels when missing.',
+  fillInput: 'Input modalities',
+  fillInputDesc: 'Write text/image modalities from the catalog when input is missing.',
+  ttl: 'Catalog refresh interval (days)',
+  ttlDesc: 'The cached models.dev catalog is refreshed on the next fill once older than this many days.',
+  providerMap: 'Provider mapping',
+  providerMapDesc: 'Optional dsh provider → models.dev provider matching overrides.',
+  addMapping: 'Add mapping',
+  removeMapping: 'Remove',
+  catalog: 'Model catalog',
+  catalogEntries: 'Catalog entries',
+  catalogProviders: 'Providers covered',
+  catalogFetched: 'Last updated',
+  catalogFresh: 'fresh',
+  catalogStale: 'stale',
+  catalogNever: 'not fetched yet',
+  refresh: 'Update catalog & fill now',
+  refreshBusy: 'Updating…',
+  reconcileNow: 'Fill now',
+  report: 'Last fill',
+  reportNever: 'never run',
+  reportFilled: 'fields filled',
+  reportTouched: 'providers touched',
+  reportUnmatched: 'unmatched models',
+  reportEmpty: 'all matched, nothing unmatched',
+  reportAt: 'time',
+  error: 'Failed to load',
+  saving: 'Saving…',
+  officialProviders: 'Official provider priority',
+  officialProvidersDesc: 'When one model id appears under several providers, prefer entries from these models.dev providers.',
+}

package/src/client/settings-section.css

@@ -0,0 +1,172 @@
+.mp-root {
+  display: flex;
+  flex-direction: column;
+  gap: 14px;
+  max-width: 720px;
+}
+
+.mp-desc {
+  margin: 0;
+  opacity: 0.85;
+  font-size: 13px;
+  line-height: 1.5;
+}
+
+.mp-card {
+  border: 1px solid var(--dsh-border-color, rgba(128, 128, 128, 0.25));
+  border-radius: 10px;
+  padding: 12px 14px;
+  display: flex;
+  flex-direction: column;
+  gap: 10px;
+  background: var(--dsh-surface-color, transparent);
+}
+
+.mp-card-title {
+  margin: 0;
+  font-size: 13px;
+  font-weight: 600;
+  opacity: 0.9;
+}
+
+.mp-toggle {
+  display: flex;
+  align-items: flex-start;
+  gap: 10px;
+  cursor: pointer;
+}
+
+.mp-toggle input[type='checkbox'] {
+  margin-top: 3px;
+  accent-color: var(--dsh-accent-color, #4f8cff);
+}
+
+.mp-toggle-sub {
+  padding-left: 22px;
+}
+
+.mp-toggle-body {
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+}
+
+.mp-toggle-label {
+  font-size: 13px;
+}
+
+.mp-toggle-desc {
+  font-size: 12px;
+  opacity: 0.65;
+}
+
+.mp-meta {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 6px 16px;
+  font-size: 13px;
+}
+
+.mp-ttl {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  font-size: 13px;
+}
+
+.mp-ttl input {
+  width: 64px;
+  padding: 3px 6px;
+  border-radius: 6px;
+  border: 1px solid var(--dsh-border-color, rgba(128, 128, 128, 0.35));
+  background: var(--dsh-input-bg, transparent);
+  color: inherit;
+}
+
+.mp-actions {
+  display: flex;
+  gap: 8px;
+  flex-wrap: wrap;
+}
+
+.mp-button {
+  padding: 6px 12px;
+  border-radius: 8px;
+  border: 1px solid var(--dsh-border-color, rgba(128, 128, 128, 0.35));
+  background: var(--dsh-accent-color, #4f8cff);
+  color: #fff;
+  font-size: 13px;
+  cursor: pointer;
+}
+
+.mp-button:disabled {
+  opacity: 0.5;
+  cursor: default;
+}
+
+.mp-button-ghost {
+  background: transparent;
+  color: inherit;
+}
+
+.mp-map-row {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+}
+
+.mp-map-row input {
+  flex: 1;
+  padding: 4px 8px;
+  border-radius: 6px;
+  border: 1px solid var(--dsh-border-color, rgba(128, 128, 128, 0.35));
+  background: var(--dsh-input-bg, transparent);
+  color: inherit;
+  font-size: 13px;
+}
+
+.mp-map-arrow {
+  opacity: 0.6;
+}
+
+.mp-report {
+  margin: 0;
+  padding-left: 18px;
+  font-size: 13px;
+  line-height: 1.7;
+}
+
+.mp-code {
+  background: var(--dsh-code-bg, rgba(128, 128, 128, 0.15));
+  border-radius: 4px;
+  padding: 1px 5px;
+  font-size: 12px;
+  word-break: break-all;
+}
+
+.mp-badge {
+  font-size: 11px;
+  padding: 1px 7px;
+  border-radius: 999px;
+  margin-left: 4px;
+}
+
+.mp-badge-ok {
+  background: rgba(52, 199, 89, 0.18);
+  color: #34c759;
+}
+
+.mp-badge-warn {
+  background: rgba(255, 149, 0, 0.18);
+  color: #ff9500;
+}
+
+.mp-muted {
+  font-size: 13px;
+  opacity: 0.6;
+}
+
+.mp-error {
+  font-size: 13px;
+  color: #ff3b30;
+}