@askdkc/dsh-cli 0.11.6 → 0.12.0

package/node_modules/dsh-working-activity/lib/types/compat/tool-result.js

@@ -0,0 +1,136 @@
+/**
+ * Host-payload readers for `tool/result` events — the one place allowed to know
+ * how the DSH host spells a tool-call id or a tool failure.
+ *
+ * The tracker pairs every `tool/result` with the `tool/call` that opened it by
+ * exact call-id equality, so a payload shape drift does not throw: it silently
+ * resolves no id, and the UI keeps a running tool card that never settles. That
+ * is why every shape guess lives in `src/compat/*` — a drift stays a one-file
+ * fix here — and why the state machine (`src/status.ts`) must never reach into
+ * `event.data` itself. Both readers accept `unknown` and never throw, because
+ * the caller hands over raw host events.
+ *
+ * Measured on the DSH 0.1.7-rc.2 host line over 1290 real `tool/result` events
+ * (`data.message` carries `role`, `source: { kind: 'tool', callId }`,
+ * `toolCallId`, `content`, `isError`, `id`):
+ *
+ * | id source               | present   |
+ * | ----------------------- | --------- |
+ * | `message.source.callId` | 1290/1290 |
+ * | `message.toolCallId`    | 1290/1290 |
+ * | `content[0].toolCallId` | 0/1290    |
+ *
+ * The two modern fields were equal in all 1290 events, yet both stay read: the
+ * legacy logs this plugin must still replay carry neither and put the id on the
+ * content block, which is why {@link resultCallId} keeps a third tier instead
+ * of trusting the newest shape alone.
+ *
+ * Failure signalling on the same corpus is NOT one field: `data.error` was
+ * present in 15 events and `message.isError === true` in 17, with neither set
+ * containing the other — and legacy logs used a content-block `isError`. Do not
+ * "simplify" {@link resultFailed} down to a single signal.
+ *
+ * @module @deepseek-ai/dsh-working-activity/compat/tool-result
+ */
+/**
+ * The call id a `tool/result` reports, or `undefined` when the payload carries
+ * no usable id. Strict precedence, never the other way round:
+ *
+ * 1. `message.source.callId` — only while `source.kind === 'tool'`, so a source
+ *    written by another producer (or an unknown future kind) never donates its
+ *    id;
+ * 2. `message.toolCallId` — the echo the measured host line writes beside it;
+ * 3. the first `content[]` block with a usable `toolCallId` — the legacy shape,
+ *    kept last so a lower tier can never override a modern one.
+ *
+ * Ids that are empty, whitespace-only, or not strings are rejected at every
+ * tier: a truthy-but-wrong id would mis-pair a result just as silently as no id
+ * at all.
+ *
+ * @param event - Raw `tool/result` event data (or any host payload).
+ * @returns the paired call id, or `undefined` when none is usable.
+ */
+export function resultCallId(event) {
+    const message = resultMessage(event);
+    if (message === undefined)
+        return undefined;
+    const source = asRecord(message.source);
+    if (source?.kind === 'tool') {
+        const fromSource = asCallId(source.callId);
+        if (fromSource !== undefined)
+            return fromSource;
+    }
+    const fromMessage = asCallId(message.toolCallId);
+    if (fromMessage !== undefined)
+        return fromMessage;
+    for (const block of asArray(message.content) ?? []) {
+        const fromBlock = asCallId(asRecord(block)?.toolCallId);
+        if (fromBlock !== undefined)
+            return fromBlock;
+    }
+    return undefined;
+}
+/**
+ * Whether a `tool/result` reports a failed tool.
+ *
+ * Three independent signals, OR-ed on purpose (measured 15 vs 17 events on the
+ * same corpus, and neither set contains the other — see the module header):
+ *
+ * - `data.error` present at all — presence, not truthiness, so an explicitly
+ *   `undefined` field does not count as a failure;
+ * - `message.isError === true`;
+ * - any `content[]` block with `isError === true` (the legacy signal).
+ *
+ * A payload that cannot be read is reported as healthy: a missing failure flag
+ * costs a wrong badge, while treating unreadable data as failure would flag
+ * every successful tool on a shape the host has moved on from.
+ *
+ * @param event - Raw `tool/result` event data (or any host payload).
+ * @returns true when any signal fired, false for a clean or unreadable payload.
+ */
+export function resultFailed(event) {
+    const data = resultData(event);
+    if (data === undefined)
+        return false;
+    if (data.error !== undefined)
+        return true;
+    const message = asRecord(data.message);
+    if (message === undefined)
+        return false;
+    if (message.isError === true)
+        return true;
+    for (const block of asArray(message.content) ?? []) {
+        if (asRecord(block)?.isError === true)
+            return true;
+    }
+    return false;
+}
+/** The `data` record of a host event, or `undefined` for any other shape. */
+function resultData(event) {
+    return asRecord(asRecord(event)?.data);
+}
+/** The `data.message` record of a `tool/result` event, when the payload has one. */
+function resultMessage(event) {
+    return asRecord(resultData(event)?.message);
+}
+/** Narrow `unknown` to a plain record: objects only, never `null`, never an array. */
+function asRecord(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return undefined;
+    return value;
+}
+/** Narrow `unknown` to an array, or `undefined` for every non-array value. */
+function asArray(value) {
+    return Array.isArray(value) ? value : undefined;
+}
+/**
+ * A usable call id: a string holding at least one non-whitespace character,
+ * returned verbatim (trimming would break exact pairing against the
+ * `tool/call` id). Empty and whitespace-only strings are rejected so a junk
+ * value can never shadow a real id in a lower tier.
+ */
+function asCallId(value) {
+    if (typeof value !== 'string')
+        return undefined;
+    return value.trim().length > 0 ? value : undefined;
+}

package/node_modules/dsh-working-activity/lib/types/config.d.ts

@@ -0,0 +1,74 @@
+/**
+ * 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).
+ *
+ * Every name here is HONOURED by the DSH line (the tracker reads it). The pi
+ * extension's list also carries `shimmer` and `cost` — DSH has no shimmer of
+ * its own (the host renders the line) and no cost accounting, so accepting
+ * those keys here would mean silently ignoring them.
+ */
+export declare const FEATURE_FLAGS: readonly ["phrases", "rareEggs", "nightPhrases", "weekend", "holidays", "combo", "failPhrases", "modelQuips", "continuePhrases"];
+/** 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.
+ * @param config - Parsed config.
+ * @param name - Feature flag name.
+ */
+export declare function featureOn(config: WorkingActivityConfig, name: FeatureFlag): boolean;

package/node_modules/dsh-working-activity/lib/types/config.js

@@ -0,0 +1,142 @@
+/**
+ * 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).
+ *
+ * Every name here is HONOURED by the DSH line (the tracker reads it). The pi
+ * extension's list also carries `shimmer` and `cost` — DSH has no shimmer of
+ * its own (the host renders the line) and no cost accounting, so accepting
+ * those keys here would mean silently ignoring them.
+ */
+export const FEATURE_FLAGS = [
+    'phrases', // 俏皮文案池（思考/等待/收尾/工具动词）
+    'rareEggs', // 稀有彩虹彩蛋
+    'nightPhrases', // 深夜文案
+    'weekend', // 周末问候
+    'holidays', // 节假日彩蛋
+    'combo', // 连击火力全开
+    'failPhrases', // 失败文案池
+    'modelQuips', // 模型切换梗
+    'continuePhrases', // 打断后接梗
+];
+/** Chinese labels for the settings panel / docs. */
+export const FEATURE_LABELS = {
+    phrases: '俏皮文案',
+    rareEggs: '稀有彩蛋',
+    nightPhrases: '深夜文案',
+    weekend: '周末问候',
+    holidays: '节假日彩蛋',
+    combo: '工具连击',
+    failPhrases: '失败文案',
+    modelQuips: '模型切换梗',
+    continuePhrases: '打断接梗',
+};
+/** 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.
+ * @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;
+    return config.mode !== 'minimal';
+}

package/node_modules/dsh-working-activity/lib/types/events.d.ts

@@ -0,0 +1,41 @@
+/**
+ * `activity/status` session event — a log-only, non-surface snapshot of the
+ * model's current working activity, published by this plugin for any UI
+ * consumer (Web client, telemetry, …). It never enters derived model history
+ * (no `surfaceOp`), so it cannot leak into prompts; UIs render it like
+ * `todo/write` or `plan/mode`.
+ * @module @deepseek-ai/dsh-working-activity/events
+ */
+import type { ActivityPhase } from './status.js';
+/** Durable payload of one `activity/status` snapshot. */
+export interface ActivityStatusEvent {
+    /** Which activity phase the model is in. */
+    readonly phase: ActivityPhase;
+    /** Human-readable status line (plain text, no ANSI). */
+    readonly line: string;
+    /** Short label of the current work, when any. */
+    readonly label?: string;
+    /** Detail fragment (path / command / pattern), when any. */
+    readonly detail?: string;
+    /** The playful phrase currently shown, when the copy pool is on. */
+    readonly phrase?: string;
+    /** Tools completed in the current turn. */
+    readonly toolCount: number;
+    /** Milliseconds since the current turn started (0 when idle). */
+    readonly turnElapsedMs: number;
+    /** Wall-clock time (epoch ms) the current phase started, for animations. */
+    readonly phaseStartedAt: number;
+}
+/** The `activity/status` phase vocabulary, exported for wire consumers. */
+export type { ActivityPhase };
+declare module '@deepseek-ai/dsh-session/types' {
+    interface SessionEventMap {
+        /**
+         * Log-only UI snapshot of the model's working activity (thinking copy,
+         * running tool, turn elapsed). Never a surface event: UIs render it, the
+         * model never sees it.
+         * @param data - The rendered status snapshot.
+         */
+        'activity/status': ActivityStatusEvent;
+    }
+}

package/node_modules/dsh-working-activity/lib/types/events.js

@@ -0,0 +1,9 @@
+/**
+ * `activity/status` session event — a log-only, non-surface snapshot of the
+ * model's current working activity, published by this plugin for any UI
+ * consumer (Web client, telemetry, …). It never enters derived model history
+ * (no `surfaceOp`), so it cannot leak into prompts; UIs render it like
+ * `todo/write` or `plan/mode`.
+ * @module @deepseek-ai/dsh-working-activity/events
+ */
+export {};

package/node_modules/dsh-working-activity/lib/types/frames.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 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;

package/node_modules/dsh-working-activity/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/node_modules/dsh-working-activity/lib/types/index.d.ts

@@ -0,0 +1,71 @@
+/**
+ * working-activity — a live "working line" for DeepSeek Harness agents.
+ *
+ * Folds the durable session stream (turn/step/tool/stream events) plus
+ * `agent/status` into a playful real-time status line, then publishes it two
+ * ways, both optional:
+ *
+ * - TUI: registers the `${activity}` prompt slot on `ctx.tuiPrompt` when the
+ *   TUI is composed; add `${activity}` to `theme.leftPrompt` to see it.
+ * - Session log: appends log-only `activity/status` events (never surface
+ *   events) for Web and other UI consumers; replay ignores them.
+ *
+ * The state machine itself lives in `./status.ts` (pure, clock-injected); this
+ * module only wires events, the render tick, and the two sinks.
+ * @module @deepseek-ai/dsh-working-activity
+ */
+import type { Context } from '@deepseek-ai/cordis';
+export type * from './events.js';
+export declare const name = "working-activity";
+/** Configurable knobs; every key has a sane default. */
+export type Config = {
+    /** Playful copy pool; false renders plain functional labels. */
+    phrases?: boolean;
+    /** Append `activity/status` session events for UI consumers. Default OFF:
+     *  dsh-session's append() cannot mark events ignorable, and the resume
+     *  read path refuses logs containing unknown non-ignorable types — every
+     *  appended snapshot makes the whole session unresumable. Re-enable only
+     *  for a log-replaying consumer on a harness that supports ignorable
+     *  appends. The live status line (prompt slot / session events) is
+     *  unaffected by this flag. */
+    publish?: boolean;
+    /** Status render tick interval in ms. */
+    tickMs?: number;
+    /** Minimum interval in ms between published events while the line is stable. */
+    publishIntervalMs?: number;
+    /** Maximum displayed detail length (paths/commands/patterns). */
+    detailLimit?: number;
+    /** Exact tool-name → action-copy pools (case-insensitive match). */
+    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' | 'ja' | 'input';
+    /** 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;
+    /**
+     * Append a JSON trace of every distinct rendered line (phase, copy-pool
+     * inputs, slot) to the debug log — the only way to answer "why did it say
+     * THAT" after the fact, since the line is derived, not stored. Default OFF.
+     */
+    debugLog?: boolean;
+};
+export declare const Config: Schemastery<Config>;
+/**
+ * Wire the working-activity plugin.
+ * @param ctx - Cordis context (agent loop + session services composed).
+ * @param config - Validated plugin config (schema defaults applied).
+ */
+export declare function apply(ctx: Context, config?: Config): void;