dsh-working-activity 0.2.6 → 0.3.2

package/lib/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","names":["css"],"sources":["../src/client/WorkingLine.tsx","../src/client/index.ts"],"sourcesContent":["// Working-line dock entry: one dim full-width row above the composer card\n// showing the live working-activity snapshot — phase-colored breathing\n// marker, the host-composed status line, and the turn's tool count badge.\n// Renders for every live phase (waiting/thinking/tool) and the done summary;\n// hides while idle or before the first publish.\n//\n// The 'conversation.input.dock' SlotMap declaration lives in\n// @deepseek-ai/dsh-client-ui-conversation/client (contract/slots.ts); this\n// entry contributes into it without owning it.\nimport type { PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots'\nimport css from './WorkingLine.module.css'\n\n/** Full props of the dock entry: the input-zone runtime share (session standard kit). */\nexport type WorkingLineProps = PropsRuntime<'conversation.input.dock'>\n\n/** Tool-count badge copy (no locale seat: the line text itself is host-composed). */\nconst TOOLS_LABEL = 'tools this turn'\n\n/**\n * Working-line dock entry: reads the latest activity snapshot off the\n * conversation snapshot and renders the row, or nothing when idle/absent.\n */\nexport function WorkingLine({ useSession }: WorkingLineProps) {\n  // Defensive read: the runtime patch that puts `activity` onto the\n  // conversation snapshot ships separately — on an unpatched host the field\n  // is absent (undefined), not null, and this component must render nothing\n  // instead of crashing into the slot error boundary. Same never-throw\n  // discipline as the node side's registration.js.\n  const activity = useSession(s => s.activity ?? null)\n  if (activity === null || activity.phase === 'idle' || activity.line === '') return null\n  return (\n    <div className={css.line} data-activity-phase={activity.phase}>\n      <span className={css.marker} aria-hidden=\"true\" />\n      <span className={css.text}>{activity.line}</span>\n      {activity.toolCount > 0 && (\n        <span className={css.tools} title={`${activity.toolCount} ${TOOLS_LABEL}`}>\n          {activity.toolCount}\n        </span>\n      )}\n    </div>\n  )\n}\n","/**\n * Working-activity surface plugin, browser half: the working-line entry in\n * the conversation.input.dock strip. This package's node half emits\n * `activity/status` session events; the web runtime patch narrows them into\n * the conversation snapshot's `activity` member, so this dock entry reads\n * the live frame through the standard session kit and owns no store, no\n * refresh chain, and no event listener.\n *\n * Mount contract (see the root README's \"Web UI 集成\" section): the web\n * client's client-modules host scans loader entries for `dsh.client`\n * declarations and serves this package's `./client` bundle at\n * /plugins/dsh-working-activity/client.js. The entry contributes into the\n * input dock — no official-source patch is involved.\n */\nimport type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client'\n// Type-only: pulls the ui-conversation SlotMap merge (the input.dock entry)\n// through the Client assembly boundary.\nimport type {} from '@deepseek-ai/dsh-client-ui-conversation/client'\nimport { WorkingLine } from './WorkingLine.tsx'\nimport type { ActivityPhase, ActivitySnapshot } from './activity.ts'\n\nexport { WorkingLine, type WorkingLineProps } from './WorkingLine.tsx'\nexport type { ActivityPhase, ActivitySnapshot } from './activity.ts'\n\n/** Required services for the dock registration. */\nexport const inject = ['slots']\n\n/**\n * Client plugin body: the working-line dock entry.\n * @param ctx - client root context.\n */\nexport function apply(ctx: ClientContext): void {\n  ctx.slots.inject('conversation.input.dock', () => ctx.slots.register({\n    name: 'conversation.input.dock',\n    // The pre-slots patch used the same id in ui-conversation; entries with\n    // equal order render in registration order, and goal (10) / queue (20)\n    // keep their seats — this row sits between them.\n    id: 'activity',\n    order: 15,\n    registrant: 'dsh-working-activity',\n  }, WorkingLine))\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;EAgBA,MAAM,cAAc;;;;;EAMpB,SAAgB,YAAY,EAAE,cAAgC;GAM5D,MAAM,WAAW,YAAW,MAAK,EAAE,YAAY,IAAI;GACnD,IAAI,aAAa,QAAQ,SAAS,UAAU,UAAU,SAAS,SAAS,IAAI,OAAO;GACnF,OACE,iBAAA,GAAA,kBAAA,KAAA,CAAC,OAAD;IAAK,WAAWA,+BAAI;IAAM,uBAAqB,SAAS;IAAxD,UAAA;KACE,iBAAA,GAAA,kBAAA,IAAA,CAAC,QAAD;MAAM,WAAWA,+BAAI;MAAQ,eAAY;KAAQ,CAAA;KACjD,iBAAA,GAAA,kBAAA,IAAA,CAAC,QAAD;MAAM,WAAWA,+BAAI;MAAO,UAAA,SAAS;KAAW,CAAA;KAC/C,SAAS,YAAY,KACpB,iBAAA,GAAA,kBAAA,IAAA,CAAC,QAAD;MAAM,WAAWA,+BAAI;MAAO,OAAO,GAAG,SAAS,UAAU,GAAG;MACzD,UAAA,SAAS;KACN,CAAA;IAEL;;EAET;;;;EChBA,MAAa,SAAS,CAAC,OAAO;;;;;EAM9B,SAAgB,MAAM,KAA0B;GAC9C,IAAI,MAAM,OAAO,iCAAiC,IAAI,MAAM,SAAS;IACnE,MAAM;IAIN,IAAI;IACJ,OAAO;IACP,YAAY;GACd,GAAG,WAAW,CAAC;EACjB"}
+{"version":3,"file":"client.js","names":["css"],"sources":["../src/client/WorkingLine.tsx","../src/client/index.ts"],"sourcesContent":["// Working-line dock entry: one dim full-width row above the composer card\r\n// showing the live working-activity snapshot — phase-colored breathing\r\n// marker, the host-composed status line, and the turn's tool count badge.\r\n// Renders for every live phase (waiting/thinking/tool) and the done summary;\r\n// hides while idle or before the first publish.\r\n//\r\n// The 'conversation.input.dock' SlotMap declaration lives in\r\n// @deepseek-ai/dsh-client-ui-conversation/client (contract/slots.ts); this\r\n// entry contributes into it without owning it.\r\nimport type { PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots'\r\nimport css from './WorkingLine.module.css'\r\n\r\n/** Full props of the dock entry: the input-zone runtime share (session standard kit). */\r\nexport type WorkingLineProps = PropsRuntime<'conversation.input.dock'>\r\n\r\n/** Tool-count badge copy (no locale seat: the line text itself is host-composed). */\r\nconst TOOLS_LABEL = 'tools this turn'\r\n\r\n/**\r\n * Working-line dock entry: reads the latest activity snapshot off the\r\n * conversation snapshot and renders the row, or nothing when idle/absent.\r\n */\r\nexport function WorkingLine({ useSession }: WorkingLineProps) {\r\n  // Defensive read: the runtime patch that puts `activity` onto the\r\n  // conversation snapshot ships separately — on an unpatched host the field\r\n  // is absent (undefined), not null, and this component must render nothing\r\n  // instead of crashing into the slot error boundary. Same never-throw\r\n  // discipline as the node side's registration.js.\r\n  const activity = useSession(s => s.activity ?? null)\r\n  if (activity === null || activity.phase === 'idle' || activity.line === '') return null\r\n  return (\r\n    <div className={css.line} data-activity-phase={activity.phase}>\r\n      <span className={css.marker} aria-hidden=\"true\" />\r\n      <span className={css.text}>{activity.line}</span>\r\n      {activity.toolCount > 0 && (\r\n        <span className={css.tools} title={`${activity.toolCount} ${TOOLS_LABEL}`}>\r\n          {activity.toolCount}\r\n        </span>\r\n      )}\r\n    </div>\r\n  )\r\n}\r\n","/**\r\n * Working-activity surface plugin, browser half: the working-line entry in\r\n * the conversation.input.dock strip. This package's node half emits\r\n * `activity/status` session events; the web runtime patch narrows them into\r\n * the conversation snapshot's `activity` member, so this dock entry reads\r\n * the live frame through the standard session kit and owns no store, no\r\n * refresh chain, and no event listener.\r\n *\r\n * Mount contract (see the root README's \"Web UI 集成\" section): the web\r\n * client's client-modules host scans loader entries for `dsh.client`\r\n * declarations and serves this package's `./client` bundle at\r\n * /plugins/dsh-working-activity/client.js. The entry contributes into the\r\n * input dock — no official-source patch is involved.\r\n */\r\nimport type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client'\r\n// Type-only: pulls the ui-conversation SlotMap merge (the input.dock entry)\r\n// through the Client assembly boundary.\r\nimport type {} from '@deepseek-ai/dsh-client-ui-conversation/client'\r\nimport { WorkingLine } from './WorkingLine.tsx'\r\nimport type { ActivityPhase, ActivitySnapshot } from './activity.ts'\r\n\r\nexport { WorkingLine, type WorkingLineProps } from './WorkingLine.tsx'\r\nexport type { ActivityPhase, ActivitySnapshot } from './activity.ts'\r\n\r\n/** Required services for the dock registration. */\r\nexport const inject = ['slots']\r\n\r\n/**\r\n * Client plugin body: the working-line dock entry.\r\n * @param ctx - client root context.\r\n */\r\nexport function apply(ctx: ClientContext): void {\r\n  ctx.slots.inject('conversation.input.dock', () => ctx.slots.register({\r\n    name: 'conversation.input.dock',\r\n    // The pre-slots patch used the same id in ui-conversation; entries with\r\n    // equal order render in registration order, and goal (10) / queue (20)\r\n    // keep their seats — this row sits between them.\r\n    id: 'activity',\r\n    order: 15,\r\n    registrant: 'dsh-working-activity',\r\n  }, WorkingLine))\r\n}\r\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;EAgBA,MAAM,cAAc;;;;;EAMpB,SAAgB,YAAY,EAAE,cAAgC;GAM5D,MAAM,WAAW,YAAW,MAAK,EAAE,YAAY,IAAI;GACnD,IAAI,aAAa,QAAQ,SAAS,UAAU,UAAU,SAAS,SAAS,IAAI,OAAO;GACnF,OACE,iBAAA,GAAA,kBAAA,KAAA,CAAC,OAAD;IAAK,WAAWA,+BAAI;IAAM,uBAAqB,SAAS;IAAxD,UAAA;KACE,iBAAA,GAAA,kBAAA,IAAA,CAAC,QAAD;MAAM,WAAWA,+BAAI;MAAQ,eAAY;KAAQ,CAAA;KACjD,iBAAA,GAAA,kBAAA,IAAA,CAAC,QAAD;MAAM,WAAWA,+BAAI;MAAO,UAAA,SAAS;KAAW,CAAA;KAC/C,SAAS,YAAY,KACpB,iBAAA,GAAA,kBAAA,IAAA,CAAC,QAAD;MAAM,WAAWA,+BAAI;MAAO,OAAO,GAAG,SAAS,UAAU,GAAG;MACzD,UAAA,SAAS;KACN,CAAA;IAEL;;EAET;;;;EChBA,MAAa,SAAS,CAAC,OAAO;;;;;EAM9B,SAAgB,MAAM,KAA0B;GAC9C,IAAI,MAAM,OAAO,iCAAiC,IAAI,MAAM,SAAS;IACnE,MAAM;IAIN,IAAI;IACJ,OAAO;IACP,YAAY;GACd,GAAG,WAAW,CAAC;EACjB"}

package/lib/types/config.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Working-activity user configuration, mirroring the pi extension's
+ * `~/.pi/agent/working-activity.json` shape: the UI owns the file (dsh-tui
+ * persists `frames` at `~/.dsh-tui/working-activity.json`) and consumers use
+ * the pure parser here to honor `mode` / `features` / `customPhrases` /
+ * `customActions` without duplicating validation. No I/O — filesystem
+ * ownership stays with the host.
+ * @module @deepseek-ai/dsh-working-activity/config
+ */
+/** Feature flags that can be switched independently (pi extension parity). */
+export declare const FEATURE_FLAGS: readonly ["phrases", "rareEggs", "nightPhrases", "weekend", "holidays", "combo", "failPhrases", "modelQuips", "shimmer", "continuePhrases", "cost"];
+/** Feature-flag name type. */
+export type FeatureFlag = (typeof FEATURE_FLAGS)[number];
+/** Chinese labels for the settings panel / docs. */
+export declare const FEATURE_LABELS: Record<FeatureFlag, string>;
+/** The file-based config, same keys as the pi extension. */
+export type WorkingActivityConfig = {
+    /** Frame preset name (`random` picks one per process). */
+    frames?: string;
+    /** Extra thinking phrases appended to the base pool. */
+    customPhrases?: readonly string[];
+    /** Exact tool-name → action-copy pools (case-insensitive match). */
+    customActions?: Readonly<Record<string, readonly string[]>>;
+    /** Inject the `⏵` self-narration contract into the system prompt. */
+    narrate?: boolean;
+    /** Debug logging to `working-activity-debug.log`. */
+    debugLog?: boolean;
+    /** Context usage warning threshold in percent. */
+    contextWarnAt?: number;
+    /** Context usage danger threshold in percent. */
+    contextDangerAt?: number;
+    /** Show estimated output tokens per second. */
+    showTokPerSec?: boolean;
+    /** Hourly work-reminder threshold (0–24, 0 = off). */
+    workRemindAt?: number;
+    /** lively: full flourish (default) / minimal: functional labels only. */
+    mode?: 'lively' | 'minimal';
+    /** Per-feature switches; explicit values override `mode` defaults. */
+    features?: Readonly<Record<string, boolean>>;
+};
+/** The defaults when nothing is configured. */
+export declare const DEFAULT_ACTIVITY_CONFIG: WorkingActivityConfig;
+/** Result of parsing a config file. */
+export type ConfigReadResult = {
+    readonly config: WorkingActivityConfig;
+    /** Raw parsed object, preserving unknown keys for lossless write-back. */
+    readonly raw: Record<string, unknown>;
+    /** Parse error message, when the text was not a valid config object. */
+    readonly error?: string;
+};
+/** Clamp `dangerAt` to be at least `warnAt` (percent thresholds). */
+export declare function normalizeThresholds(cfg: WorkingActivityConfig): WorkingActivityConfig;
+/**
+ * Parse a `working-activity.json` text into a validated config. Unknown keys
+ * are preserved in `raw` (for lossless write-back); invalid values are
+ * dropped. A non-object root yields the defaults plus an `error`.
+ * @param text - Raw file contents.
+ * @returns Validated config + raw object (+ optional error).
+ */
+export declare function parseWorkingActivityConfig(text: string): ConfigReadResult;
+/**
+ * Whether a feature is on. Explicit `features` entries win; otherwise
+ * `minimal` mode turns everything off (except `cost`, always on).
+ * @param config - Parsed config.
+ * @param name - Feature flag name.
+ */
+export declare function featureOn(config: WorkingActivityConfig, name: FeatureFlag): boolean;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,8EAA8E;AAC9E,eAAO,MAAM,aAAa,qJAYhB,CAAA;AAEV,8BAA8B;AAC9B,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAA;AAExD,oDAAoD;AACpD,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAYtD,CAAA;AAED,4DAA4D;AAC5D,MAAM,MAAM,qBAAqB,GAAG;IAClC,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,wDAAwD;IACxD,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,oEAAoE;IACpE,aAAa,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAA;IAC3D,qEAAqE;IACrE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,kDAAkD;IAClD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,iDAAiD;IACjD,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,+CAA+C;IAC/C,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,yEAAyE;IACzE,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAA;IAC3B,sEAAsE;IACtE,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CAC7C,CAAA;AAED,+CAA+C;AAC/C,eAAO,MAAM,uBAAuB,EAAE,qBAGrC,CAAA;AAED,uCAAuC;AACvC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAA;IACtC,0EAA0E;IAC1E,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACrC,wEAAwE;IACxE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA;AAMD,qEAAqE;AACrE,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,qBAAqB,GAAG,qBAAqB,CAIrF;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAwDzE;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,qBAAqB,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAKnF"}

package/lib/types/config.js

@@ -0,0 +1,141 @@
+/**
+ * Working-activity user configuration, mirroring the pi extension's
+ * `~/.pi/agent/working-activity.json` shape: the UI owns the file (dsh-tui
+ * persists `frames` at `~/.dsh-tui/working-activity.json`) and consumers use
+ * the pure parser here to honor `mode` / `features` / `customPhrases` /
+ * `customActions` without duplicating validation. No I/O — filesystem
+ * ownership stays with the host.
+ * @module @deepseek-ai/dsh-working-activity/config
+ */
+import { DEFAULT_PRESET, isPresetName } from './frames.js';
+/** Feature flags that can be switched independently (pi extension parity). */
+export const FEATURE_FLAGS = [
+    'phrases', // 俏皮文案池（思考/等待/收尾/工具动词）
+    'rareEggs', // 稀有彩虹彩蛋
+    'nightPhrases', // 深夜文案
+    'weekend', // 周末问候
+    'holidays', // 节假日彩蛋
+    'combo', // 连击火力全开
+    'failPhrases', // 失败文案池
+    'modelQuips', // 模型切换梗
+    'shimmer', // 文案星辉扫过/彩虹流光
+    'continuePhrases', // 打断后接梗
+    'cost', // 成本与 token 核算（结束时展示）
+];
+/** Chinese labels for the settings panel / docs. */
+export const FEATURE_LABELS = {
+    phrases: '俏皮文案',
+    rareEggs: '稀有彩蛋',
+    nightPhrases: '深夜文案',
+    weekend: '周末问候',
+    holidays: '节假日彩蛋',
+    combo: '工具连击',
+    failPhrases: '失败文案',
+    modelQuips: '模型切换梗',
+    shimmer: '星辉效果',
+    continuePhrases: '打断接梗',
+    cost: '成本与 token',
+};
+/** The defaults when nothing is configured. */
+export const DEFAULT_ACTIVITY_CONFIG = {
+    frames: DEFAULT_PRESET,
+    narrate: true,
+};
+function errorText(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/** Clamp `dangerAt` to be at least `warnAt` (percent thresholds). */
+export function normalizeThresholds(cfg) {
+    const warnAt = cfg.contextWarnAt ?? 80;
+    const dangerAt = cfg.contextDangerAt ?? 95;
+    return dangerAt < warnAt ? { ...cfg, contextDangerAt: warnAt } : cfg;
+}
+/**
+ * Parse a `working-activity.json` text into a validated config. Unknown keys
+ * are preserved in `raw` (for lossless write-back); invalid values are
+ * dropped. A non-object root yields the defaults plus an `error`.
+ * @param text - Raw file contents.
+ * @returns Validated config + raw object (+ optional error).
+ */
+export function parseWorkingActivityConfig(text) {
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch (error) {
+        return { config: { ...DEFAULT_ACTIVITY_CONFIG }, raw: {}, error: errorText(error) };
+    }
+    if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        return {
+            config: { ...DEFAULT_ACTIVITY_CONFIG },
+            raw: {},
+            error: '配置根节点必须是 JSON 对象',
+        };
+    }
+    const raw = parsed;
+    const config = { ...DEFAULT_ACTIVITY_CONFIG };
+    if (typeof raw.frames === 'string' && isPresetName(raw.frames))
+        config.frames = raw.frames;
+    if (Array.isArray(raw.customPhrases)) {
+        const phrases = raw.customPhrases.filter((s) => typeof s === 'string' && s.trim().length > 0);
+        if (phrases.length > 0)
+            config.customPhrases = phrases;
+    }
+    if (raw.customActions !== null && typeof raw.customActions === 'object' && !Array.isArray(raw.customActions)) {
+        const customActions = {};
+        for (const [key, value] of Object.entries(raw.customActions)) {
+            const actions = Array.isArray(value)
+                ? value.filter((entry) => typeof entry === 'string' && entry.trim().length > 0)
+                    .map((entry) => entry.trim())
+                : [];
+            if (key.trim().length > 0 && actions.length > 0)
+                customActions[key.trim()] = actions;
+        }
+        if (Object.keys(customActions).length > 0)
+            config.customActions = customActions;
+    }
+    if (typeof raw.narrate === 'boolean')
+        config.narrate = raw.narrate;
+    if (typeof raw.debugLog === 'boolean')
+        config.debugLog = raw.debugLog;
+    if (typeof raw.contextWarnAt === 'number' && Number.isFinite(raw.contextWarnAt)
+        && raw.contextWarnAt >= 0 && raw.contextWarnAt <= 100) {
+        config.contextWarnAt = raw.contextWarnAt;
+    }
+    if (typeof raw.contextDangerAt === 'number' && Number.isFinite(raw.contextDangerAt)
+        && raw.contextDangerAt >= 0 && raw.contextDangerAt <= 100) {
+        config.contextDangerAt = raw.contextDangerAt;
+    }
+    if (typeof raw.showTokPerSec === 'boolean')
+        config.showTokPerSec = raw.showTokPerSec;
+    if (typeof raw.workRemindAt === 'number' && Number.isFinite(raw.workRemindAt)
+        && raw.workRemindAt >= 0 && raw.workRemindAt <= 24) {
+        config.workRemindAt = raw.workRemindAt;
+    }
+    if (raw.mode === 'lively' || raw.mode === 'minimal')
+        config.mode = raw.mode;
+    if (raw.features !== null && typeof raw.features === 'object' && !Array.isArray(raw.features)) {
+        const features = {};
+        for (const [key, value] of Object.entries(raw.features)) {
+            if (typeof value === 'boolean')
+                features[key] = value;
+        }
+        if (Object.keys(features).length > 0)
+            config.features = features;
+    }
+    return { config: normalizeThresholds(config), raw };
+}
+/**
+ * Whether a feature is on. Explicit `features` entries win; otherwise
+ * `minimal` mode turns everything off (except `cost`, always on).
+ * @param config - Parsed config.
+ * @param name - Feature flag name.
+ */
+export function featureOn(config, name) {
+    const explicit = config.features?.[name];
+    if (typeof explicit === 'boolean')
+        return explicit;
+    if (name === 'cost')
+        return true;
+    return config.mode !== 'minimal';
+}

package/lib/types/frames.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Working-activity indicator frame presets — the single home for every
+ * spinner animation, ported from the pi working-activity extension
+ * (`FRAME_PRESETS`) plus the dsh-tui additions (moon8 / rainbow / whale
+ * family / clock / traffic lights). Consumers (TUI row, Web slot) render the
+ * current frame next to the live working line; the preset name is chosen by
+ * the UI and persisted in `working-activity.json` (`frames` key).
+ *
+ * `\uFE0E` forces text rendering so Windows never paints the glyphs as color
+ * emoji (the green-block problem); emoji presets (moon8, clock, whales)
+ * deliberately omit it to keep colorful rendering on modern terminals.
+ * @module @deepseek-ai/dsh-working-activity/frames
+ */
+/** One working-activity preset: the frame sequence and the per-frame interval. */
+export interface FramePreset {
+    readonly frames: readonly string[];
+    readonly intervalMs: number;
+}
+/** Named working-activity frame presets, keyed by preset name (`claude`, `moon`, `sand`, ...). */
+export declare const FRAME_PRESETS: Record<string, FramePreset>;
+/** The default preset (moon8: the smoothest of the emoji moons). */
+export declare const DEFAULT_PRESET = "moon8";
+/** Every selectable preset name, `random` first (the pi selector order). */
+export declare const PRESET_NAMES: readonly string[];
+/**
+ * Whether `name` selects a known preset or `random`.
+ * @param name - Candidate preset name.
+ * @returns True when the name resolves to a preset.
+ */
+export declare function isPresetName(name: string): boolean;
+/**
+ * Resolve a preset name (`random` picks one per process).
+ * @param name - Preset name, or undefined for the default.
+ * @returns The matching preset; unknown or absent names fall back to the default.
+ */
+export declare function resolvePreset(name: string | undefined): FramePreset;
+//# sourceMappingURL=frames.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frames.d.ts","sourceRoot":"","sources":["../../src/frames.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,kFAAkF;AAClF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAED,kGAAkG;AAClG,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAkFrD,CAAA;AAED,oEAAoE;AACpE,eAAO,MAAM,cAAc,UAAU,CAAA;AAErC,4EAA4E;AAC5E,eAAO,MAAM,YAAY,EAAE,SAAS,MAAM,EAA8C,CAAA;AAExF;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,CASnE"}

package/lib/types/frames.js

@@ -0,0 +1,126 @@
+/**
+ * Working-activity indicator frame presets — the single home for every
+ * spinner animation, ported from the pi working-activity extension
+ * (`FRAME_PRESETS`) plus the dsh-tui additions (moon8 / rainbow / whale
+ * family / clock / traffic lights). Consumers (TUI row, Web slot) render the
+ * current frame next to the live working line; the preset name is chosen by
+ * the UI and persisted in `working-activity.json` (`frames` key).
+ *
+ * `\uFE0E` forces text rendering so Windows never paints the glyphs as color
+ * emoji (the green-block problem); emoji presets (moon8, clock, whales)
+ * deliberately omit it to keep colorful rendering on modern terminals.
+ * @module @deepseek-ai/dsh-working-activity/frames
+ */
+/** Text-variant selector: keep symbols monochrome on Windows. */
+const TE = '\uFE0E';
+/** Named working-activity frame presets, keyed by preset name (`claude`, `moon`, `sand`, ...). */
+export const FRAME_PRESETS = {
+    // Claude Code's real sequence: · ✢ * ✶ ✻ ✽ forward + backward.
+    claude: {
+        frames: ['·', `✢${TE}`, '*', `✶${TE}`, `✻${TE}`, `✽${TE}`, `✻${TE}`, `✶${TE}`, '*', `✢${TE}`],
+        intervalMs: 150,
+    },
+    star2: { frames: [`✶${TE}`, `✸${TE}`, `✹${TE}`, `✺${TE}`, `✹${TE}`, `✷${TE}`], intervalMs: 140 },
+    sand: {
+        frames: ['⠁', '⠂', '⠄', '⡀', '⡈', '⡐', '⡠', '⣀', '⣁', '⣂', '⣄', '⣌', '⣔', '⣤', '⣥', '⣦', '⣮', '⣶', '⣷', '⣿', '⡿', '⠿', '⢟', '⠟', '⡛', '⠛', '⠫', '⢋', '⠋', '⠍', '⡉', '⠉', '⠑', '⠡', '⢁'],
+        intervalMs: 120,
+    },
+    triangle: { frames: ['◢', '◣', '◤', '◥'], intervalMs: 180 },
+    box: { frames: ['▖', '▘', '▝', '▗'], intervalMs: 180 },
+    box2: { frames: ['▌', '▀', '▐', '▄'], intervalMs: 180 },
+    corners: { frames: ['◰', '◳', '◲', '◱'], intervalMs: 190 },
+    point: { frames: ['∙∙∙', '●∙∙', '∙●∙', '∙∙●', '∙∙∙'], intervalMs: 190 },
+    layer: { frames: ['-', '=', '≡'], intervalMs: 220 },
+    flip: { frames: ['_', '_', '_', '-', '`', '`', "'", '´', '-', '_', '_', '_'], intervalMs: 140 },
+    aesthetic: {
+        frames: ['▰▱▱▱▱▱▱', '▰▰▱▱▱▱▱', '▰▰▰▱▱▱▱', '▰▰▰▰▱▱▱', '▰▰▰▰▰▱▱', '▰▰▰▰▰▰▱', '▰▰▰▰▰▰▰', '▰▱▱▱▱▱▱'],
+        intervalMs: 140,
+    },
+    hamburger: { frames: ['☱', '☲', '☴'], intervalMs: 220 },
+    moon: { frames: ['◐', '◓', '◑', '◒'], intervalMs: 240 },
+    // kimi-code MoonLoader 同款：8 帧 emoji 月相，120ms 一帧，比半圆版更丝滑。
+    // 不带 \uFE0E：保留彩色 emoji 渲染（Windows Terminal 等现代终端效果最佳）。
+    moon8: { frames: ['🌑', '🌒', '🌓', '🌔', '🌕', '🌖', '🌗', '🌘'], intervalMs: 120 },
+    // 鲸鱼喷水：🐳 固定，水柱升起（· → | → ║）再回落，顶珠 ° 模拟水花（对齐 pi 版）。
+    'whale-spout': {
+        frames: ['🐳  ', '🐳° ', '🐳|°', '🐳║°', '🐳|°', '🐳° ', '🐳  '],
+        intervalMs: 160,
+    },
+    // 鲸鱼转圈：🐳 + 环绕方向指示（逆时针转圈语义，对齐 pi 版）。
+    'whale-spin': {
+        frames: ['🐳→', '🐳↘', '🐳↓', '🐳↙', '🐳←', '🐳↖', '🐳↑', '🐳↗'],
+        intervalMs: 150,
+    },
+    // 鲸鱼吐泡泡：🐳 固定，泡泡从头顶冒出（大泡 ○ 先行、小泡 ∘ 跟上）向右飘走。
+    'whale-bubbles': {
+        frames: ['🐳  ', '🐳○ ', '🐳 ○', '🐳  ', '🐳∘ ', '🐳 ∘', '🐳  '],
+        intervalMs: 170,
+    },
+    // 时钟：12 个整点表盘循环（🕛 → 🕚），emoji 彩色渲染（同 moon8，不带 \uFE0E）。
+    clock: {
+        frames: ['🕛', '🕐', '🕑', '🕒', '🕓', '🕔', '🕕', '🕖', '🕗', '🕘', '🕙', '🕚'],
+        intervalMs: 300,
+    },
+    // 红绿灯：🔴 → 🟡 → 🟢 循环，一轮 1.2s，节奏从容。
+    traffic_lights: {
+        frames: ['🔴', '🟡', '🟢'],
+        intervalMs: 400,
+    },
+    comet: {
+        frames: ['●    ', ' ●   ', '  ●  ', '   ● ', '    ●', '   ● ', '  ●  ', ' ●   '],
+        intervalMs: 160,
+    },
+    breathe: { frames: ['▁', '▃', '▅', '▇', '▅', '▃'], intervalMs: 210 },
+    dots: { frames: ['⣾', '⣷', '⣯', '⣟', '⡿', '⢿', '⣻', '⣽'], intervalMs: 140 },
+    arrow: { frames: ['←', '↖', '↑', '↗', '→', '↘', '↓', '↙'], intervalMs: 160 },
+    spark: { frames: ['·', '∘', '°', '✧', '°', '∘'], intervalMs: 240 },
+    bar: { frames: ['▏', '▎', '▍', '▌', '▋', '▊', '▉', '█', '▉', '▊', '▋', '▌', '▍', '▎'], intervalMs: 120 },
+    braille: { frames: ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'], intervalMs: 120 },
+    arc: { frames: ['◜', '◠', '◝', '◞', '◡', '◟'], intervalMs: 160 },
+    circle: { frames: ['◴', '◷', '◶', '◵'], intervalMs: 190 },
+    grow: { frames: ['.', 'o', 'O', '0', 'O', 'o'], intervalMs: 210 },
+    noise: { frames: ['▓', '▒', '░', '▒'], intervalMs: 160 },
+    bounce: { frames: ['⠁', '⠂', '⠄', '⡀', '⢀', '⠠', '⠐', '⠈'], intervalMs: 140 },
+    rainbow: {
+        frames: ['▁', '▂', '▃', '▄', '▅', '▆', '▇', '█', '▇', '▆', '▅', '▄', '▃', '▂'],
+        intervalMs: 120,
+    },
+    // 双端进度条往返（pi 版独有，补全并集）。
+    bar2: {
+        frames: [
+            '[    ]', '[=   ]', '[==  ]', '[=== ]', '[ ===]',
+            '[  ==]', '[   =]', '[    ]', '[   =]', '[  ==]',
+            '[ ===]', '[=== ]', '[==  ]', '[=   ]',
+        ],
+        intervalMs: 140,
+    },
+    dqpb: { frames: ['d', 'q', 'p', 'b'], intervalMs: 210 },
+    toggle: { frames: ['⊶', '⊷'], intervalMs: 300 },
+};
+/** The default preset (moon8: the smoothest of the emoji moons). */
+export const DEFAULT_PRESET = 'moon8';
+/** Every selectable preset name, `random` first (the pi selector order). */
+export const PRESET_NAMES = ['random', ...Object.keys(FRAME_PRESETS)];
+/**
+ * Whether `name` selects a known preset or `random`.
+ * @param name - Candidate preset name.
+ * @returns True when the name resolves to a preset.
+ */
+export function isPresetName(name) {
+    return name === 'random' || Object.hasOwn(FRAME_PRESETS, name);
+}
+/**
+ * Resolve a preset name (`random` picks one per process).
+ * @param name - Preset name, or undefined for the default.
+ * @returns The matching preset; unknown or absent names fall back to the default.
+ */
+export function resolvePreset(name) {
+    if (name === 'random') {
+        const names = Object.keys(FRAME_PRESETS);
+        // FRAME_PRESETS is non-empty by construction, so any random index is in
+        // range and the lookup always lands on a preset.
+        const pick = names[Math.floor(Math.random() * names.length)];
+        return FRAME_PRESETS[pick];
+    }
+    return FRAME_PRESETS[name ?? ''] ?? FRAME_PRESETS[DEFAULT_PRESET];
+}

package/lib/types/index.d.ts

@@ -39,6 +39,22 @@ export type Config = {
     customActions?: Record<string, string[]>;
     /** Inject the `⏵` self-narration contract into the system prompt and surface it. */
     narrate?: boolean;
+    /** UI language: `auto` follows `DSH_TUI_LANG` → `~/.dsh-tui/lang.json` →
+     *  OS locale → zh; `zh`/`en` pin the copy directly. */
+    lang?: 'auto' | 'zh' | 'en';
+    /** Default frame preset name (informational for UI consumers; the TUI
+     *  resolves the persisted `frames` choice itself). */
+    frames?: string;
+    /** lively: full flourish (default) / minimal: functional labels only. */
+    mode?: 'lively' | 'minimal';
+    /** Per-feature switches; explicit values override `mode` defaults. */
+    features?: Record<string, boolean>;
+    /** Extra thinking phrases appended to the base pool. */
+    customPhrases?: string[];
+    /** Show an estimated tokens/s prefix while streaming. */
+    showTokPerSec?: boolean;
+    /** Work reminder after this many turn-hours (0 = off). */
+    workRemindAt?: number;
 };
 export declare const Config: Schemastery<Config>;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAalD,mBAAmB,aAAa,CAAA;AAEhC,eAAO,MAAM,IAAI,qBAAqB,CAAA;AAEtC,wDAAwD;AACxD,MAAM,MAAM,MAAM,GAAG;IACnB,gEAAgE;IAChE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;;;;mCAM+B;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,gFAAgF;IAChF,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,oEAAoE;IACpE,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;IACxC,oFAAoF;IACpF,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AAMD,eAAO,MAAM,MAAM,EAAE,WAAW,CAAC,MAAM,CAQrC,CAAA;AAyBF;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,MAAW,GAAG,IAAI,CA+H7D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAelD,mBAAmB,aAAa,CAAA;AAEhC,eAAO,MAAM,IAAI,qBAAqB,CAAA;AAEtC,wDAAwD;AACxD,MAAM,MAAM,MAAM,GAAG;IACnB,gEAAgE;IAChE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;;;;mCAM+B;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,gFAAgF;IAChF,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,oEAAoE;IACpE,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;IACxC,oFAAoF;IACpF,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;2DACuD;IACvD,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAA;IAC3B;0DACsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,yEAAyE;IACzE,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAA;IAC3B,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC,wDAAwD;IACxD,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB,yDAAyD;IACzD,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAMD,eAAO,MAAM,MAAM,EAAE,WAAW,CAAC,MAAM,CAerC,CAAA;AA4BF;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,MAAW,GAAG,IAAI,CAqJ7D"}

package/lib/types/index.js

@@ -17,6 +17,8 @@
 import z from '@deepseek-ai/schemastery';
 import { ActivityTracker } from './status.js';
 import { registerActivityEventType } from './registration.js';
+import { setLangOverride, t } from './lang.js';
+import { DEFAULT_PRESET } from './frames.js';
 export const name = 'working-activity';
 // Explicit annotation: the inferred z.dict output references cosmokit's
 // Dict through a pnpm-virtual path, which is not portable in declaration
@@ -30,9 +32,14 @@ export const Config = z.object({
     detailLimit: z.number().step(1).min(8).max(120).default(40),
     customActions: z.dict(z.array(z.string())).default({}),
     narrate: z.boolean().default(true),
+    lang: z.union(['auto', 'zh', 'en']).default('auto'),
+    frames: z.string().default(DEFAULT_PRESET),
+    mode: z.union(['lively', 'minimal']).default('lively'),
+    features: z.dict(z.boolean()).default({}),
+    customPhrases: z.array(z.string()).default([]),
+    showTokPerSec: z.boolean().default(false),
+    workRemindAt: z.number().min(0).max(24).default(0),
 });
-/** The self-narration contract injected into the system prompt (narrate on). */
-const NARRATE_INSTRUCTION = '[状态栏] 你有一个状态栏展示给用户。【必须】在每个步骤/子任务开始时（不只是调用工具前），在回复正文的最前面单独写一行：⏵ 你在做的具体事情（不超过20字），然后换行继续正常回复。整轮回复只写一行 ⏵，不要重复。信息为主——让人一眼知道你在干什么，风格自然、可以带点俏皮。例：⏵ 修复登录页样式、⏵ 查一下报错原因、⏵ 给补丁跑个验证。切换任务时必须更新。';
 /**
  * Wire the working-activity plugin.
  * @param ctx - Cordis context (agent loop + session services composed).
@@ -46,14 +53,26 @@ export function apply(ctx, config = {}) {
     // in processes where publishing itself is off. See registration.ts.
     registerActivityEventType();
     const resolved = {
-        phrases: config.phrases ?? true,
+        // `mode: minimal` renders functional labels only (pi extension parity).
+        phrases: config.phrases ?? config.mode !== 'minimal',
         publish: config.publish ?? false,
         tickMs: config.tickMs ?? 500,
         publishIntervalMs: config.publishIntervalMs ?? 2000,
         detailLimit: config.detailLimit ?? 40,
         narrate: config.narrate ?? true,
+        lang: config.lang ?? 'auto',
         customActions: config.customActions ?? {},
+        frames: config.frames ?? DEFAULT_PRESET,
+        mode: config.mode ?? 'lively',
+        features: config.features ?? {},
+        customPhrases: config.customPhrases ?? [],
+        showTokPerSec: config.showTokPerSec ?? false,
+        workRemindAt: config.workRemindAt ?? 0,
     };
+    // A pinned plugin-level language beats the env/file chain; releasing it on
+    // dispose restores `auto` for any other composition in the process.
+    setLangOverride(resolved.lang);
+    ctx.effect(() => () => setLangOverride('auto'), 'working-activity lang override');
     const trackers = new Map();
     let activeSession;
     let lastPublishedLine;
@@ -65,20 +84,30 @@ export function apply(ctx, config = {}) {
     const promptHandle = prompt?.register('activity', undefined);
     // The `⏵` self-narration contract rides the stable system-prompt sections:
     // injected when the systemPrompt service is composed (agent assemblies
-    // always mount it), removed with this fiber.
+    // always mount it), removed with this fiber. The text is resolved at every
+    // assembly in the live language, so a `/lang` switch applies to the next
+    // turn without rebuilding the agent.
     if (resolved.narrate) {
         ctx.inject(['systemPrompt'], (promptCtx) => {
             promptCtx.systemPrompt.section({
                 name: 'working-activity:narrate',
                 order: 60,
-                text: NARRATE_INSTRUCTION,
+                text: () => t('narrate-instruction'),
             });
         });
     }
     const trackerFor = (session) => {
         let tracker = trackers.get(session);
         if (tracker === undefined) {
-            tracker = new ActivityTracker({ phrases: resolved.phrases, detailLimit: resolved.detailLimit, showIdle: false }, Date.now, resolved.customActions);
+            tracker = new ActivityTracker({
+                phrases: resolved.phrases,
+                detailLimit: resolved.detailLimit,
+                showIdle: false,
+                features: resolved.features,
+                customPhrases: resolved.customPhrases,
+                showTokPerSec: resolved.showTokPerSec,
+                workRemindAt: resolved.workRemindAt,
+            }, Date.now, resolved.customActions);
             trackers.set(session, tracker);
         }
         return tracker;

package/lib/types/lang.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Language resolution + copy dictionary for the working-activity plugin.
+ *
+ * The plugin follows the dsh-tui UI language without importing it: the same
+ * chain dsh-tui resolves (`DSH_TUI_LANG` env → `~/.dsh-tui/lang.json` → OS
+ * locale → zh) is read here directly, so a `/lang en|zh` switch (or the
+ * /settings language pick) hot-swaps this plugin's narration and status-line
+ * copy on the next render tick.
+ *
+ * Resolution order:
+ *   1. `setLangOverride()` — a plugin-level `lang: zh|en` config key
+ *      (cordis.yml) or an explicit test pin.
+ *   2. `DSH_TUI_LANG` env var — pinned at process start.
+ *   3. `~/.dsh-tui/lang.json` — the persisted dsh-tui choice, mtime-cached
+ *      so the per-tick status render never re-reads an unchanged file.
+ *   4. OS locale guess (`LC_ALL` / `LC_MESSAGES` / `LANG`); POSIX/C means
+ *      "no locale selected" and maps to English.
+ *   5. `zh` — the original hard-coded language.
+ *
+ * The dictionary is a flat key → per-language string map; `t(key, params)`
+ * substitutes `{{name}}` placeholders. Missing keys render the key itself so
+ * a typo is visible instead of silently blank.
+ * @module @deepseek-ai/dsh-working-activity/lang
+ */
+export type Lang = 'zh' | 'en';
+/** The languages shipped with the plugin, in display order. */
+export declare const LANGS: readonly ["zh", "en"];
+declare const dict: {
+    readonly 'narrate-instruction': {
+        readonly zh: "[状态栏] 你有一个状态栏展示给用户。【必须】在每个步骤/子任务开始时（不只是调用工具前），在回复正文的最前面单独写一行：⏵ 你在做的具体事情（不超过20字），然后换行继续正常回复。整轮回复只写一行 ⏵，不要重复。信息为主——让人一眼知道你在干什么，风格自然、可以带点俏皮。例：⏵ 修复登录页样式、⏵ 查一下报错原因、⏵ 给补丁跑个验证。切换任务时必须更新。";
+        readonly en: "[Status line] You have a status line visible to the user. [Required] At the start of each step or subtask (not only before tool calls), write exactly one standalone line at the very beginning of your response: ⏵ a concrete description of what you are doing (20 words max), then continue with the normal response on the next line. Write only one ⏵ line per response and do not repeat it. Prioritize information so the user can understand the current work at a glance; keep the style natural and optionally playful. Examples: ⏵ Fixing the login page styles, ⏵ Investigating the error, ⏵ Running validation for the patch. Update it when the task changes.";
+    };
+    /** Plain (non-playful) phase labels. */
+    readonly 'waiting-label': {
+        readonly zh: "等待模型响应";
+        readonly en: "Waiting for model";
+    };
+    readonly 'thinking-label': {
+        readonly zh: "思考中";
+        readonly en: "Thinking";
+    };
+    /** Elapsed suffix: zh glues the char, en keeps a space. */
+    readonly 'line-elapsed': {
+        readonly zh: "总{{elapsed}}";
+        readonly en: "total {{elapsed}}";
+    };
+    /** Plain-mode completion prefix (playful pools pick their own). */
+    readonly 'done-prefix': {
+        readonly zh: "搞定 ✓";
+        readonly en: "Finished";
+    };
+    /** Turn-completion summary. */
+    readonly 'done-summary': {
+        readonly zh: "{{tools}} · 想{{thinking}} 干{{tooling}}";
+        readonly en: "{{tools}} · thought {{thinking}} worked {{tooling}}";
+    };
+    readonly 'tool-count-one': {
+        readonly zh: "{{count}} 工具";
+        readonly en: "{{count}} tool";
+    };
+    readonly 'tool-count-many': {
+        readonly zh: "{{count}} 工具";
+        readonly en: "{{count}} tools";
+    };
+    /** Subagent count in the done summary. */
+    readonly 'subagent-count': {
+        readonly zh: "子代理 {{count}} 个";
+        readonly en: "{{count}} subagents";
+    };
+    /** Work-reminder copy after `workRemindAt` turn-hours. */
+    readonly 'work-remind': {
+        readonly zh: "已连续工作 {{hours}} 小时，歇会儿？";
+        readonly en: "Worked {{hours}}h straight — take a break?";
+    };
+};
+export type I18nKey = keyof typeof dict;
+export type I18nParams = Record<string, string | number>;
+/** Force (or release) the active language; `auto` re-enables the chain. */
+export declare function setLangOverride(lang: Lang | 'auto'): void;
+/** The currently active language. */
+export declare function langNow(): Lang;
+/** Translate a dictionary key, substituting `{{name}}` placeholders. */
+export declare function t(key: I18nKey, params?: I18nParams): string;
+/** Is a value a valid shipped language code? */
+export declare function isLang(value: unknown): value is Lang;
+/**
+ * Read the persisted dsh-tui language choice, mtime-cached so the per-tick
+ * status render never re-reads an unchanged file. `undefined` when the file
+ * is absent or holds no valid `{ lang }` value.
+ */
+export declare function readLangFile(): Lang | undefined;
+/**
+ * Guess the language from the OS locale (`LC_ALL`, `LC_MESSAGES`, `LANG`),
+ * defaulting to `zh`. POSIX/C means "no locale selected" and conventionally
+ * maps to English (what CI runners report). An absent locale variable
+ * (typical on Windows) defaults to `zh`.
+ */
+export declare function detectLocaleLang(): Lang;
+export {};
+//# sourceMappingURL=lang.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lang.d.ts","sourceRoot":"","sources":["../../src/lang.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAMH,MAAM,MAAM,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;AAE9B,+DAA+D;AAC/D,eAAO,MAAM,KAAK,uBAAwB,CAAA;AAK1C,QAAA,MAAM,IAAI;;;;;IAQR,wCAAwC;;;;;;;;;IAGxC,2DAA2D;;;;;IAE3D,mEAAmE;;;;;IAEnE,+BAA+B;;;;;;;;;;;;;IAO/B,0CAA0C;;;;;IAE1C,0DAA0D;;;;;CAElD,CAAA;AAEV,MAAM,MAAM,OAAO,GAAG,MAAM,OAAO,IAAI,CAAA;AACvC,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAA;AAKxD,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAEzD;AAED,qCAAqC;AACrC,wBAAgB,OAAO,IAAI,IAAI,CAK9B;AAED,wEAAwE;AACxE,wBAAgB,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,UAAe,GAAG,MAAM,CAM/D;AAED,gDAAgD;AAChD,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,IAAI,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,IAAI,GAAG,SAAS,CAmB/C;AAKD;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAWvC"}