dsh-draw 0.1.0

package/package.json

@@ -0,0 +1,179 @@
+{
+  "name": "dsh-draw",
+  "version": "0.1.0",
+  "description": "Unified static-image generation router for DeepSeek Harness: one image_generate tool with standard parameters, config-driven OpenAI-compatible engine routing (OpenAI Images, Zhipu CogView, and any compatible endpoint) with health-aware fallback, durable workspace attachment results, per-session quota accounting, an in-conversation result card, and a Plugins settings panel that stores API keys as credential references.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/PerryLink/dsh-draw.git"
+  },
+  "homepage": "https://github.com/PerryLink/dsh-draw#readme",
+  "bugs": {
+    "url": "https://github.com/PerryLink/dsh-draw/issues"
+  },
+  "author": {
+    "name": "PerryLink"
+  },
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./typert": {
+      "types": "./lib/types/typert.host.d.ts",
+      "default": "./lib/typert.host.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "src",
+    "cordis.patch.yml",
+    "CHANGELOG.md",
+    "SECURITY.md",
+    "THIRD_PARTY_NOTICES.md",
+    "README.md",
+    "README.zh.md",
+    "README.es.md",
+    "README.pt.md",
+    "README.hi.md",
+    "LICENSE"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-connection",
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-slots",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-ui-tool"
+      ]
+    }
+  },
+  "dshWorkshop": {
+    "schema": "omdsh-workshop-package/v1",
+    "type": "plugin",
+    "integration": {
+      "protocol": "harness-profile",
+      "artifact": "cordis.patch.yml"
+    },
+    "install": {
+      "mode": "transactional",
+      "adapter": "profile-bundle",
+      "failurePolicy": "generation-rollback",
+      "touchesCurrentBeforeActivation": false
+    },
+    "lifecycle": {
+      "activation": "hot-reload",
+      "dispose": "supported"
+    },
+    "permissions": [
+      "network:outbound",
+      "session:append",
+      "tools:register",
+      "attachments:write"
+    ],
+    "compatibility": {
+      "dshVersions": [
+        "0.1.0-rc.6"
+      ]
+    },
+    "capability": {
+      "id": "image-generate-tool",
+      "kind": "tool",
+      "invocation": "image_generate",
+      "expected": "generates 1..4 static images from a prompt through the first healthy configured engine, saves them as durable attachments, and reports engine, size, quota usage, and per-image references; on engine failure it falls back down the configured chain"
+    },
+    "evidence": {
+      "install": null,
+      "failureIsolation": null,
+      "hotReload": null,
+      "remove": null
+    }
+  },
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "deepseek",
+    "cordis",
+    "image-generation",
+    "openai-images",
+    "cogview",
+    "zhipu",
+    "text-to-image"
+  ],
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "packageManager": "pnpm@11.7.0",
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/schemastery": "^3.18.0",
+    "@deepseek-ai/dsh-attachment": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-brand": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-credentials": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-llm": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-session": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-tools": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-typert-protocol": "0.1.0-rc.6"
+  },
+  "dependencies": {
+    "tsdown": "^0.22.14",
+    "typescript": "^7.0.2",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/schemastery": "^3.18.0",
+    "@deepseek-ai/dsh-agent": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-api-remotes": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-attachment": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-attachment-local": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-brand": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-connection": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-locale": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-runtime": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-settings": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-tool": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-credentials": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-credentials-local": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-llm": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-session": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-tools": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-typert-protocol": "0.1.0-rc.6",
+    "@types/node": "^22.19.0",
+    "@types/react": "18.3.31",
+    "jsdom": "^30.0.1",
+    "react": "18.3.1",
+    "react-dom": "18.3.1",
+    "vitest": "^4.1.10"
+  },
+  "scripts": {
+    "build": "node scripts/prepare.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.test.json --noEmit",
+    "typecheck:ci": "tsc -p tsconfig.ci.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepare": "node scripts/prepare.mjs",
+    "verify:self-contained": "node scripts/verify-self-contained.mjs",
+    "verify:artifacts": "node scripts/verify-artifacts.mjs"
+  },
+  "license": "Apache-2.0"
+}

package/src/client/DrawResultCard.tsx

@@ -0,0 +1,100 @@
+/**
+ * The keyed `image_generate` tool result card: engine/quota facts and the
+ * regenerate action. The images themselves are the attachment content blocks
+ * the shell already renders from the tool result, so the card only adds the
+ * accounting line and the action — it never duplicates image transport.
+ *
+ * The `tool.call.toolview` SlotMap member is declared locally (mirroring the
+ * harness's own ui-tool contract declaration, which its package index does not
+ * re-export): when both declarations land in one program they merge.
+ *
+ * @module dsh-draw/client/DrawResultCard
+ */
+
+import { createElement as h, useState, type ReactElement } from 'react'
+import type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots'
+import type { ToolCallBlock } from '@deepseek-ai/dsh-client-runtime/client'
+import { presentDrawResult } from './present.ts'
+
+/**
+ * Standard owner currency for one keyed tool view (mirror of the harness
+ * ui-tool contract `ToolCallOwnerProps`, which the package index does not
+ * re-export — keep the shape identical so the declarations merge).
+ */
+export interface ToolCallOwnerProps {
+  /** Tool call identity, stable across running and settled forms. */
+  callId: string
+  /** Wire tool name and keyed dispatch value. */
+  toolName: string
+  /** Frozen running call or settled result node. */
+  block: ToolCallBlock
+  /** Session workspace root for relative summaries. */
+  cwd?: string
+  /** Open a tool argument path through the host. */
+  openFile: (path: string) => void
+  /** Inspect this call in the trajectory view when available. */
+  inspect?: () => void
+}
+
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+  interface SlotMap {
+    /** Keyed atomic tool-call view, dispatched by the wire tool name. */
+    'tool.call.toolview': { kind: 'keyed'; scope: 'session'; owner: ToolCallOwnerProps }
+  }
+}
+
+/** Registration-side injected face: locale binding and the regenerate RPC. */
+export interface DrawResultCardInjected {
+  /** Re-run the generation through the host drawer; rejects on failure. */
+  regenerate: (args: Record<string, unknown>) => Promise<void>
+}
+
+/** Full component props assembled by the tool-view slot renderer. */
+export type DrawResultCardProps =
+  PropsRuntime<'tool.call.toolview'>
+  & PropsLocale<'draw'>
+  & InjectFace<DrawResultCardInjected>
+
+/**
+ * The keyed tool result card.
+ * @param props - owner currency, locale, and injected bindings.
+ * @returns the card element.
+ */
+export function DrawResultCard(props: DrawResultCardProps): ReactElement {
+  const { block, regenerate, t } = props
+  const presented = presentDrawResult(block)
+  const [busy, setBusy] = useState(false)
+  const [failed, setFailed] = useState(false)
+
+  if (presented === undefined) return h('div', null)
+
+  const runRegenerate = async (): Promise<void> => {
+    if (presented.args === undefined) return
+    setBusy(true)
+    setFailed(false)
+    try {
+      await regenerate(presented.args)
+    } catch {
+      setFailed(true)
+    } finally {
+      setBusy(false)
+    }
+  }
+
+  return h('div', { className: 'dshdraw-card' },
+    h('div', { className: 'dshdraw-meta' },
+      h('span', null, `${t('result.engine')}: ${presented.engine} (${presented.model})`),
+      ...(presented.fallbackUsed ? [h('span', null, t('result.fallback'))] : []),
+      h('span', null, `${t('result.quota')}: ${presented.quota.generations}/${presented.limits.maxGenerations} · ${presented.quota.bytes}/${presented.limits.maxBytes}`),
+    ),
+    h('div', { className: 'dshdraw-actions' },
+      h('button', {
+        className: 'dshdraw-button',
+        type: 'button',
+        disabled: busy || presented.args === undefined,
+        onClick: () => { void runRegenerate() },
+      }, busy ? t('result.regenerating') : t('result.regenerate')),
+      ...(failed ? [h('span', { className: 'dshdraw-badge warn' }, t('result.failed'))] : []),
+    ),
+  )
+}

package/src/client/DrawSettingsTab.tsx

@@ -0,0 +1,159 @@
+/**
+ * The Plugins settings tab for dsh-draw: engine chain, credential references
+ * (set/remove through the host's credential seam), probe button, and quota
+ * limits. Read-only except the credential actions; all data arrives through
+ * the `draw` Remote namespace.
+ *
+ * @module dsh-draw/client/DrawSettingsTab
+ */
+
+import { createElement as h, useEffect, useState, type ReactElement, type ReactNode } from 'react'
+import type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots'
+import type { PresentedDrawPanel } from './present.ts'
+
+/** Registration-side injected face: the panel RPCs (RemoteResult already unwrapped). */
+export interface DrawSettingsTabInjected {
+  /** Read the panel snapshot. */
+  status: () => Promise<PresentedDrawPanel>
+  /** Probe one engine's connectivity. */
+  probe: (engineId: string) => Promise<string>
+  /** Store one API key under the engine's credential reference. */
+  setCredential: (engineId: string, value: string) => Promise<string>
+  /** Remove a stored API key. */
+  unsetCredential: (engineId: string) => Promise<string>
+}
+
+/** Full component props assembled by the Settings slot renderer. */
+export type DrawSettingsTabProps =
+  PropsRuntime<'settings.plugins.tab'>
+  & PropsLocale<'draw'>
+  & InjectFace<DrawSettingsTabInjected>
+
+/**
+ * The settings tab element.
+ * @param props - locale and injected bindings.
+ * @returns the tab element.
+ */
+export function DrawSettingsTab(props: DrawSettingsTabProps): ReactElement {
+  const { t, status, probe, setCredential, unsetCredential } = props
+  const [panel, setPanel] = useState<PresentedDrawPanel | undefined>(undefined)
+  const [notes, setNotes] = useState<Record<string, string>>({})
+  const [keys, setKeys] = useState<Record<string, string>>({})
+
+  useEffect(() => {
+    let alive = true
+    const load = async (): Promise<void> => {
+      try {
+        const snapshot = await status()
+        if (alive) setPanel(snapshot)
+      } catch {
+        // Panel load failure keeps the previous snapshot; the rows stay usable.
+      }
+    }
+    void load()
+    return () => {
+      alive = false
+    }
+  }, [status])
+
+  const act = async (engineId: string, run: () => Promise<string>): Promise<void> => {
+    setNotes(current => ({ ...current, [engineId]: '' }))
+    try {
+      const note = await run()
+      setNotes(current => ({ ...current, [engineId]: note }))
+    } catch (error) {
+      setNotes(current => ({ ...current, [engineId]: `failed: ${error instanceof Error ? error.message : String(error)}` }))
+    } finally {
+      try {
+        const snapshot = await status()
+        setPanel(snapshot)
+      } catch {
+        // Refresh failure keeps the previous snapshot.
+      }
+    }
+  }
+
+  if (panel === undefined) return h('div', { className: 'dshdraw-panel' }, t('tab.engines'))
+
+  const engineCards: ReactNode[] = []
+  for (const engine of panel.engines) {
+    const headerChildren: ReactNode[] = [engine.id]
+    if (engine.preferred) headerChildren.push(h('span', { key: 'p', className: 'dshdraw-badge ok' }, t('tab.preferred')))
+    if (!engine.enabled) headerChildren.push(h('span', { key: 'd', className: 'dshdraw-badge warn' }, t('tab.disabled')))
+
+    const keyActions: ReactNode[] = []
+    if (engine.credentialWritable) {
+      keyActions.push(h('input', {
+        key: 'input',
+        className: 'dshdraw-input',
+        type: 'password',
+        placeholder: t('tab.setKey'),
+        value: keys[engine.id] ?? '',
+        onChange: (event: { target: { value: string } }) => setKeys(current => ({ ...current, [engine.id]: event.target.value })),
+      }))
+      keyActions.push(h('button', {
+        key: 'set',
+        className: 'dshdraw-button',
+        type: 'button',
+        onClick: () => {
+          void act(engine.id, async () => {
+            const note = await setCredential(engine.id, keys[engine.id] ?? '')
+            setKeys(current => ({ ...current, [engine.id]: '' }))
+            return note
+          })
+        },
+      }, t('tab.setKey')))
+      if (engine.credentialConfigured) {
+        keyActions.push(h('button', {
+          key: 'remove',
+          className: 'dshdraw-button',
+          type: 'button',
+          onClick: () => { void act(engine.id, () => unsetCredential(engine.id)) },
+        }, t('tab.removeKey')))
+      }
+    }
+
+    const healthChildren: ReactNode[] = []
+    healthChildren.push(h('label', null, t('tab.health')))
+    if (engine.coolingDown) {
+      healthChildren.push(h('span', { className: 'dshdraw-badge warn' }, `cooldown (${engine.consecutiveFailures})`))
+    } else if (engine.consecutiveFailures === 0) {
+      healthChildren.push(h('span', { className: 'dshdraw-badge ok' }, t('tab.healthOk')))
+    } else {
+      healthChildren.push(h('span', { className: 'dshdraw-badge warn' }, `${t('tab.healthError')} (${engine.consecutiveFailures})`))
+    }
+    if (engine.lastError !== null) healthChildren.push(h('span', { key: 'err' }, engine.lastError))
+    healthChildren.push(h('button', {
+      key: 'probe',
+      className: 'dshdraw-button',
+      type: 'button',
+      onClick: () => { void act(engine.id, () => probe(engine.id)) },
+    }, t('tab.probe')))
+
+    const engineChildren: ReactNode[] = [
+      h('h4', null, ...headerChildren),
+      h('div', { className: 'dshdraw-row' }, h('label', null, t('tab.engines')), h('span', null, `${engine.model} @ ${engine.baseUrl}`)),
+      h('div', { className: 'dshdraw-row' },
+        h('label', null, t('tab.keyRef')),
+        h('span', null, engine.apiKeyRef),
+        h('span', { className: engine.credentialConfigured ? 'dshdraw-badge ok' : 'dshdraw-badge warn' },
+          engine.credentialConfigured ? t('tab.credentialSet') : t('tab.credentialMissing')),
+      ),
+    ]
+    if (keyActions.length > 0) engineChildren.push(h('div', { className: 'dshdraw-row' }, ...keyActions))
+    engineChildren.push(h('div', { className: 'dshdraw-row' }, ...healthChildren))
+    const note = notes[engine.id]
+    if (note !== undefined && note !== '') engineChildren.push(h('div', { className: 'dshdraw-row' }, note))
+    engineCards.push(h('div', { key: engine.id, className: 'dshdraw-engine' }, ...engineChildren))
+  }
+
+  return h('div', { className: 'dshdraw-panel' },
+    h('div', { className: 'dshdraw-row' },
+      h('span', null, `${t('tab.quotaCalls')}: ${panel.quota.maxGenerationsPerSession}`),
+      h('span', null, `${t('tab.quotaBytes')}: ${panel.quota.maxBytesPerSession}`),
+      h('span', null, `timeout: ${panel.requestTimeoutMs} ms`),
+      h('span', null, `max: ${panel.maxImagesPerCall}`),
+    ),
+    ...engineCards,
+  )
+}

package/src/client/index.ts

@@ -0,0 +1,123 @@
+/**
+ * `dsh-draw`, browser half: mounts the `draw` Remote contribution, registers
+ * the keyed `image_generate` result card (`tool.call.toolview`, key
+ * `image_generate`), and registers the Plugins settings tab (`settings.plugins.tab`,
+ * id `draw`). All data arrives through the `remote.draw` namespace; the card
+ * and the tab hold no state beyond their local forms.
+ *
+ * @module dsh-draw/client
+ */
+
+import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client'
+import type {} from '@deepseek-ai/dsh-client-locale/client'
+// Type-only: pulls the 'settings.plugins.tab' SlotMap declaration into this
+// program so the tab registration typechecks against the real declaration.
+import type {} from '@deepseek-ai/dsh-client-ui-settings/client'
+import type {} from '@deepseek-ai/dsh-client-ui-tool'
+import type { RemoteResult } from '@deepseek-ai/dsh-typert-protocol'
+import { DrawResultCard, type DrawResultCardInjected } from './DrawResultCard.tsx'
+import { DrawSettingsTab, type DrawSettingsTabInjected } from './DrawSettingsTab.tsx'
+import { en, zh, type DrawLocaleKey } from './locales.ts'
+import { presentDrawPanel } from './present.ts'
+import { DRAW_REMOTE } from './remote.ts'
+import { installDrawStyles } from './styles.ts'
+import type { CredentialActionResult, DrawProbeResult, DrawRegenerateResult, DrawStatusSnapshot } from '../wire.ts'
+
+export type { DrawResultCardInjected, DrawResultCardProps } from './DrawResultCard.tsx'
+export type { DrawSettingsTabInjected, DrawSettingsTabProps } from './DrawSettingsTab.tsx'
+export type { DrawLocaleKey } from './locales.ts'
+export { presentDrawPanel, presentDrawResult, type PresentedDrawPanel, type PresentedDrawResult, type PresentedEngineRow } from './present.ts'
+
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+  interface LocaleNamespaceMap {
+    /** Image-generation card and panel copy. */
+    'draw': DrawLocaleKey
+  }
+}
+
+/** Dictionary namespace owned by this plugin. */
+export const NS = 'draw'
+
+/** Plugin name: matches the package name, the graph row id, and the bundle id. */
+export const name = 'dsh-draw'
+
+/** Services the browser half reads; `remote.draw` appears once the contribution mounts. */
+export const inject = ['slots', 'locale', 'remote', 'sessions']
+
+/**
+ * Browser plugin body: dictionaries, the scoped stylesheet, the Remote
+ * contribution mount, the result card, and the settings tab registration.
+ *
+ * @param ctx - client root context.
+ */
+export async function apply(ctx: ClientContext): Promise<void> {
+  ctx.effect(() => ctx.locale.register(NS, { zh, en }), 'dsh-draw: dictionaries')
+  ctx.effect(() => installDrawStyles(), 'dsh-draw: stylesheet')
+
+  // $mount registers the 'remote.draw' namespace service and owns its
+  // removal for this fiber's lifetime.
+  await ctx.remote.$mount(DRAW_REMOTE)
+
+  ctx.inject(['remote.draw'], (scope) => {
+    const t = scope.locale.bind(NS)
+    const unwrap = <T>(result: RemoteResult<T>, method: string): T => {
+      if (!result.ok) {
+        throw new Error(`draw.${method} failed: ${result.error.code}: ${result.error.message}`)
+      }
+      return result.value
+    }
+
+    scope.slots.inject('tool.call.toolview', () => scope.slots.register({
+      name: 'tool.call.toolview',
+      key: 'image_generate',
+      locale: NS,
+      inject: (): DrawResultCardInjected => ({
+        regenerate: async (args) => {
+          const sessionId = currentSessionId(scope.get('sessions'))
+          if (sessionId === undefined) throw new Error('no active session — cannot regenerate')
+          unwrap<DrawRegenerateResult>(await scope.remote.draw.regenerate(sessionId, args), 'regenerate')
+        },
+      }),
+    }, DrawResultCard))
+
+    scope.slots.inject('settings.plugins.tab', () => scope.slots.register({
+      name: 'settings.plugins.tab',
+      id: 'draw',
+      order: 40,
+      label: () => t('tab'),
+      locale: NS,
+      inject: (): DrawSettingsTabInjected => ({
+        status: async () => presentDrawPanel(unwrap<DrawStatusSnapshot>(await scope.remote.draw.status(), 'status')),
+        probe: async (engineId) => {
+          const result = unwrap<DrawProbeResult>(await scope.remote.draw.probe(engineId), 'probe')
+          return result.note
+        },
+        setCredential: async (engineId, value) => {
+          const result = unwrap<CredentialActionResult>(await scope.remote.draw.setCredential(engineId, value), 'setCredential')
+          return result.note
+        },
+        unsetCredential: async (engineId) => {
+          const result = unwrap<CredentialActionResult>(await scope.remote.draw.unsetCredential(engineId), 'unsetCredential')
+          return result.note
+        },
+      }),
+    }, DrawSettingsTab))
+  })
+}
+
+/**
+ * Read the current session id from the sessions store face (structural:
+ * the store shape differs across harness lines, so only the leaf is read).
+ */
+function currentSessionId(sessions: unknown): string | undefined {
+  try {
+    const list = (sessions as { list?: unknown } | null)?.list
+    if (typeof list !== 'object' || list === null) return undefined
+    const getSnapshot = (list as { getSnapshot?: unknown }).getSnapshot
+    if (typeof getSnapshot !== 'function') return undefined
+    const current = (getSnapshot as () => { current?: unknown })().current
+    return typeof current === 'string' ? current : undefined
+  } catch {
+    return undefined
+  }
+}

package/src/client/locales.ts

@@ -0,0 +1,84 @@
+/**
+ * UI dictionary for the dsh-draw browser half. The harness locale registry
+ * accepts only the 'en' | 'zh' UI language codes today (its LocaleDictOf
+ * face), so the client ships those two dictionaries.
+ *
+ * @module dsh-draw/client/locales
+ */
+
+/** Dictionary key union. */
+export type DrawLocaleKey =
+  | 'result.title'
+  | 'result.fallback'
+  | 'result.quota'
+  | 'result.engine'
+  | 'result.regenerate'
+  | 'result.regenerating'
+  | 'result.failed'
+  | 'tab'
+  | 'tab.engines'
+  | 'tab.preferred'
+  | 'tab.disabled'
+  | 'tab.keyRef'
+  | 'tab.credentialSet'
+  | 'tab.credentialMissing'
+  | 'tab.setKey'
+  | 'tab.removeKey'
+  | 'tab.probe'
+  | 'tab.quotaCalls'
+  | 'tab.quotaBytes'
+  | 'tab.health'
+  | 'tab.healthOk'
+  | 'tab.healthError'
+
+/** English dictionary. */
+export const en: Record<DrawLocaleKey, string> = {
+  'result.title': 'Generated image',
+  'result.fallback': 'fallback used',
+  'result.quota': 'Quota',
+  'result.engine': 'Engine',
+  'result.regenerate': 'Regenerate',
+  'result.regenerating': 'Regenerating…',
+  'result.failed': 'Regenerate failed',
+  'tab': 'Image generation',
+  'tab.engines': 'Engines',
+  'tab.preferred': 'preferred',
+  'tab.disabled': 'disabled',
+  'tab.keyRef': 'API key reference',
+  'tab.credentialSet': 'configured',
+  'tab.credentialMissing': 'not configured',
+  'tab.setKey': 'Set key',
+  'tab.removeKey': 'Remove key',
+  'tab.probe': 'Probe',
+  'tab.quotaCalls': 'Per-session call cap',
+  'tab.quotaBytes': 'Per-session byte cap',
+  'tab.health': 'Health',
+  'tab.healthOk': 'healthy',
+  'tab.healthError': 'last error',
+}
+
+/** Chinese dictionary. */
+export const zh: Record<DrawLocaleKey, string> = {
+  'result.title': '生成的图片',
+  'result.fallback': '已使用回退引擎',
+  'result.quota': '配额',
+  'result.engine': '引擎',
+  'result.regenerate': '重新生成',
+  'result.regenerating': '正在重新生成…',
+  'result.failed': '重新生成失败',
+  'tab': '图像生成',
+  'tab.engines': '引擎',
+  'tab.preferred': '首选',
+  'tab.disabled': '已禁用',
+  'tab.keyRef': 'API 密钥引用',
+  'tab.credentialSet': '已配置',
+  'tab.credentialMissing': '未配置',
+  'tab.setKey': '设置密钥',
+  'tab.removeKey': '移除密钥',
+  'tab.probe': '探测',
+  'tab.quotaCalls': '每会话调用上限',
+  'tab.quotaBytes': '每会话字节上限',
+  'tab.health': '健康状态',
+  'tab.healthOk': '正常',
+  'tab.healthError': '最近错误',
+}