@deepseek-harness-tui/dsh-tui 0.11.0 → 0.11.2

package/lib/types/deepseekPricing.d.ts

@@ -80,4 +80,78 @@ export declare function estimateSessionCostSplitCny(tokens: CostTokenBuckets, mo
  * 估算本会话花费（人民币，元）——estimateSessionCostSplitCny 的总价捷径。
  */
 export declare function estimateSessionCostCny(tokens: CostTokenBuckets, model: string): number | undefined;
+/** 一笔增量 usage（durable assistant/message.usage 的计价字段）。 */
+export type CostUsageDelta = Partial<CostTokenTotals>;
+/** 空的峰谷分桶（新模型 / 新会话累计起点）。 */
+export declare function emptyCostBuckets(): CostTokenBuckets;
+/** 深拷贝分桶，供快照镜像（调用方拿到后修改不得影响累计源）。 */
+export declare function cloneCostBuckets(buckets: CostTokenBuckets): CostTokenBuckets;
+/**
+ * 把一笔 usage 按计价时段累加进分桶（in-place）。durable 事件按发生时刻
+ * 落桶，峰/谷单价不同；cacheRead/cacheWrite 作为分项保留（cacheRead 计价
+ * 时按命中价，见 costSplit）。
+ */
+export declare function addUsageToCostBuckets(buckets: CostTokenBuckets, usage: CostUsageDelta, peak: boolean): void;
+/** 一笔待计价用量：provider 决定官方与否，model 查价目，buckets 为峰谷分桶。 */
+export interface CostBucketEntry {
+    readonly provider: string;
+    readonly model: string;
+    readonly buckets: CostTokenBuckets;
+    /** 展示分侧（主会话 / 子代理）；缺省按主会话处理（兼容旧调用）。 */
+    readonly scope?: 'main' | 'subagent';
+}
+/** 多模型桶计价选项。 */
+export interface EstimateCostOptions {
+    /** 默认 true：非官方 provider 一律不估价（只计入 unpriced）。false 时
+     *  非官方 provider 也按 model 价目估算（调用方自担口径）。 */
+    readonly officialOnly?: boolean;
+}
+/** 多模型桶计价结果：金额按展示分侧拆解，未计价 token 单独上报。 */
+export interface SessionCostEstimate {
+    /** 已计价总额（元）＝ main + subagent。 */
+    readonly total: number;
+    /** 主会话部分（元）。 */
+    readonly main: number;
+    /** 子代理部分（元）。 */
+    readonly subagent: number;
+    /** 高峰时段部分（元）。 */
+    readonly peak: number;
+    /** 空闲时段部分（元）。 */
+    readonly idle: number;
+    /** 未能计价的用量 token（非官方 provider / 价目未收录）：只展示，不计金额。 */
+    readonly unpricedTokens: number;
+}
+/**
+ * 多模型桶计价纯函数：逐条目查价求和，金额按 scope 拆成主会话/子代理，
+ * 非官方 provider 或未收录模型计入 unpriced（只上报 token，不给金额）。
+ * 所有条目都是零 token 时返回 undefined（调用方不显示金额）。
+ * 空 provider 表示旧快照/测试桩（生产契约里 provider 恒有）——不武断视为
+ * 非官方，按 model 价目估算，避免既有展示静默少算。
+ */
+export declare function estimateCostFromBucketsCny(entries: readonly CostBucketEntry[], options?: EstimateCostOptions): SessionCostEstimate | undefined;
+/** 费用估算输入：主会话按模型桶 + 子代理按 (provider, model) 桶。 */
+export interface SessionCostInput {
+    /** 主会话当前 provider（主会话条目的官方判定；空串 = 旧快照）。 */
+    readonly provider: string;
+    /** 主会话按模型分桶（ChannelState.mainCost）。 */
+    readonly main?: Readonly<Record<string, CostTokenBuckets>> | undefined;
+    /** 子代理按 (provider, model) 分桶（ChannelState.subagentCost）。 */
+    readonly subagents?: readonly {
+        readonly provider: string;
+        readonly model: string;
+        readonly buckets: CostTokenBuckets;
+    }[] | undefined;
+    /** main 缺失/为空时的回退 token（旧快照/测试桩没有 mainCost 时用
+     *  channel.tokens + 当前模型，保持既有展示不消失）。 */
+    readonly fallbackTokens?: CostTokenBuckets | undefined;
+    readonly fallbackModel?: string | undefined;
+}
+/**
+ * 汇总一次费用估算的输入条目：主会话按模型分桶优先；没有分桶的旧快照
+ * 回退到 `channel.tokens` + 当前模型（不叠加，避免双计）；子代理条目
+ * 追加在后。纯函数，不修改入参。
+ */
+export declare function collectSessionCostEntries(input: SessionCostInput): CostBucketEntry[];
+/** collectSessionCostEntries + estimateCostFromBucketsCny 的展示侧捷径。 */
+export declare function estimateSessionCostSnapshotCny(input: SessionCostInput, options?: EstimateCostOptions): SessionCostEstimate | undefined;
 //# sourceMappingURL=deepseekPricing.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"deepseekPricing.d.ts","sourceRoot":"","sources":["../../src/deepseekPricing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,uCAAuC;AACvC,MAAM,MAAM,aAAa,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAErD,kCAAkC;AAClC,MAAM,WAAW,kBAAkB;IACjC,yBAAyB;IACzB,SAAS,EAAE,aAAa,CAAA;IACxB,gBAAgB;IAChB,QAAQ,EAAE,aAAa,CAAA;IACvB,UAAU;IACV,MAAM,EAAE,aAAa,CAAA;CACtB;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAsB9E,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,EAAE,SAAS,MAAM,EAIxD,CAAA;AAED,gDAAgD;AAChD,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEpE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,GAAE,IAAiB,GAAG,OAAO,CAM3D;AAED,wCAAwC;AACxC,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAU3E;AAED,6CAA6C;AAC7C,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,eAAe,CAAA;IACrB,IAAI,EAAE,eAAe,CAAA;CACtB;AAiCD;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,MAAM,GACZ;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAc3D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,MAAM,GACZ,MAAM,GAAG,SAAS,CAEpB"}
+{"version":3,"file":"deepseekPricing.d.ts","sourceRoot":"","sources":["../../src/deepseekPricing.ts"],"names":[],"mappings":"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"}

package/lib/types/deepseekPricing.js

@@ -25,20 +25,18 @@ export const DEEPSEEK_MODEL_PRICES = {
         inputHit: [0.02, 0.04],
         output: [4.0, 8.0],
     },
+    // issue #857：官方已按 Flash 价计费 V4.1-Flash 的正式 id 与 vision 实验 id；
+    // V4-Pro 已下线，不再保留价目行（未收录 → priceForModel 返回 undefined，
+    // 界面只展示 token、不给金额）。
     'deepseek-v4-flash': {
-        inputMiss: [1.5, 3.0],
-        inputHit: [0.05, 0.10],
-        output: [4.5, 9.0],
-    },
-    'deepseek-v4-pro': {
-        inputMiss: [4.5, 9.0],
-        inputHit: [0.15, 0.30],
-        output: [13.5, 27.0],
+        inputMiss: [1.0, 2.0],
+        inputHit: [0.02, 0.04],
+        output: [4.0, 8.0],
     },
     'deepseek-v4-flash-vision-exp': {
-        inputMiss: [1.5, 3.0],
-        inputHit: [0.05, 0.10],
-        output: [4.5, 9.0],
+        inputMiss: [1.0, 2.0],
+        inputHit: [0.02, 0.04],
+        output: [4.0, 8.0],
     },
 };
 /**
@@ -138,3 +136,104 @@ export function estimateSessionCostSplitCny(tokens, model) {
 export function estimateSessionCostCny(tokens, model) {
     return estimateSessionCostSplitCny(tokens, model)?.total;
 }
+/** 空的峰谷分桶（新模型 / 新会话累计起点）。 */
+export function emptyCostBuckets() {
+    return {
+        peak: { ...EMPTY_TOTALS },
+        idle: { ...EMPTY_TOTALS },
+    };
+}
+/** 深拷贝分桶，供快照镜像（调用方拿到后修改不得影响累计源）。 */
+export function cloneCostBuckets(buckets) {
+    return {
+        peak: { ...(buckets.peak ?? EMPTY_TOTALS) },
+        idle: { ...(buckets.idle ?? EMPTY_TOTALS) },
+    };
+}
+/**
+ * 把一笔 usage 按计价时段累加进分桶（in-place）。durable 事件按发生时刻
+ * 落桶，峰/谷单价不同；cacheRead/cacheWrite 作为分项保留（cacheRead 计价
+ * 时按命中价，见 costSplit）。
+ */
+export function addUsageToCostBuckets(buckets, usage, peak) {
+    const bucket = peak ? buckets.peak : buckets.idle;
+    bucket.input += usage.input ?? 0;
+    bucket.output += usage.output ?? 0;
+    bucket.cacheRead += usage.cacheRead ?? 0;
+    bucket.cacheWrite += usage.cacheWrite ?? 0;
+}
+/** 分桶里的计价 token 总数（input 含 cacheRead，与既有显示口径一致）。 */
+function bucketTokenTotal(buckets) {
+    const peak = buckets.peak ?? EMPTY_TOTALS;
+    const idle = buckets.idle ?? EMPTY_TOTALS;
+    return peak.input + peak.output + idle.input + idle.output;
+}
+/**
+ * 多模型桶计价纯函数：逐条目查价求和，金额按 scope 拆成主会话/子代理，
+ * 非官方 provider 或未收录模型计入 unpriced（只上报 token，不给金额）。
+ * 所有条目都是零 token 时返回 undefined（调用方不显示金额）。
+ * 空 provider 表示旧快照/测试桩（生产契约里 provider 恒有）——不武断视为
+ * 非官方，按 model 价目估算，避免既有展示静默少算。
+ */
+export function estimateCostFromBucketsCny(entries, options = {}) {
+    const officialOnly = options.officialOnly !== false;
+    let total = 0;
+    let main = 0;
+    let subagent = 0;
+    let peak = 0;
+    let idle = 0;
+    let unpricedTokens = 0;
+    let tokenCount = 0;
+    for (const entry of entries) {
+        const tokens = bucketTokenTotal(entry.buckets);
+        tokenCount += tokens;
+        const priceable = !officialOnly
+            || entry.provider === ''
+            || isDeepSeekOfficialProvider(entry.provider);
+        const price = priceable ? priceForModel(entry.model) : undefined;
+        if (price === undefined) {
+            unpricedTokens += tokens;
+            continue;
+        }
+        const split = costSplit(entry.buckets, price);
+        const amount = (split.peak + split.idle) / 1_000_000;
+        total += amount;
+        peak += split.peak / 1_000_000;
+        idle += split.idle / 1_000_000;
+        if (entry.scope === 'subagent')
+            subagent += amount;
+        else
+            main += amount;
+    }
+    if (tokenCount <= 0)
+        return undefined;
+    return { total, main, subagent, peak, idle, unpricedTokens };
+}
+/**
+ * 汇总一次费用估算的输入条目：主会话按模型分桶优先；没有分桶的旧快照
+ * 回退到 `channel.tokens` + 当前模型（不叠加，避免双计）；子代理条目
+ * 追加在后。纯函数，不修改入参。
+ */
+export function collectSessionCostEntries(input) {
+    const entries = [];
+    const main = input.main ?? {};
+    const mainModels = Object.keys(main);
+    if (mainModels.length > 0) {
+        for (const model of mainModels) {
+            const buckets = main[model];
+            if (buckets !== undefined)
+                entries.push({ provider: input.provider, model, buckets, scope: 'main' });
+        }
+    }
+    else if (input.fallbackTokens !== undefined && input.fallbackModel !== undefined && input.fallbackModel !== '') {
+        entries.push({ provider: input.provider, model: input.fallbackModel, buckets: input.fallbackTokens, scope: 'main' });
+    }
+    for (const subagent of input.subagents ?? []) {
+        entries.push({ provider: subagent.provider, model: subagent.model, buckets: subagent.buckets, scope: 'subagent' });
+    }
+    return entries;
+}
+/** collectSessionCostEntries + estimateCostFromBucketsCny 的展示侧捷径。 */
+export function estimateSessionCostSnapshotCny(input, options = {}) {
+    return estimateCostFromBucketsCny(collectSessionCostEntries(input), options);
+}

package/lib/types/dsh-adapter/activity-store.d.ts

@@ -0,0 +1,221 @@
+/**
+ * Session-scoped activity snapshots for the working-status line.
+ *
+ * The line's *semantics* belong to the `dsh-working-activity` plugin: it folds
+ * durable session events and live model frames into a **session projection**
+ * (`workingActivity`) that any client can read — the browser reads it, and so
+ * does this TUI. Consuming the projection is what removes the second tracker
+ * this app used to run: one semantic owner, and a value that arrives already
+ * scoped to a session, so a background session can no longer overwrite the line
+ * of the session on screen.
+ *
+ * Two properties of the transport shape this module:
+ *
+ * 1. **It is event-driven.** A value changes when a committed event folds, never
+ *    on its own. `updatedAt` is the timestamp of the last folded event (session
+ *    time, so it survives a restart) and `live` says whether `line` counts
+ *    elapsed time. A renderer that wants the counter to move must derive it from
+ *    `turnStartedAt` / `phaseStartedAt` instead of re-rendering `line`.
+ * 2. **The value is host data, not plugin API.** The shape below is a local
+ *    structural copy of the plugin's wire value, the same discipline the channel
+ *    port already applies to the activity state: this app must not import the
+ *    plugin's internals to display a line.
+ * @module dsh-tui/dsh-adapter/activity-store
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** The projection key the activity plugin publishes. */
+export declare const ACTIVITY_PROJECTION_KEY = "workingActivity";
+/** Phases the plugin's line can be in (`idle` renders nothing). */
+export type ActivityPhase = 'idle' | 'waiting' | 'thinking' | 'tool' | 'done';
+/**
+ * One session's activity value, as the plugin publishes it.
+ *
+ * Structural copy of `dsh-working-activity`'s `WorkingActivityView`.
+ */
+export interface ActivityView {
+    readonly phase: ActivityPhase;
+    /** The line as the host rendered it at `updatedAt`. */
+    readonly line: string;
+    /** Whether `line` counts elapsed time (a renderer ticks it from the stamps). */
+    readonly live: boolean;
+    /** Tool action verb, when the line describes a running tool. */
+    readonly label?: string;
+    /** Tool detail fragment (path / command / pattern), when there is one. */
+    readonly detail?: string;
+    /** The playful phrase or `⏵` self-narration currently shown, when any. */
+    readonly phrase?: string;
+    /** Tools completed in the current turn. */
+    readonly toolCount: number;
+    /** Wall clock the current phase began. */
+    readonly phaseStartedAt: number;
+    /** Wall clock the current turn began (0 when no turn has started). */
+    readonly turnStartedAt: number;
+    /** Timestamp of the last folded event — the value's freshness signal. */
+    readonly updatedAt: number;
+    /** Language the line was rendered in. */
+    readonly lang: 'zh' | 'en';
+}
+/** The slice of the host projection registry this module uses. */
+export interface ProjectionRegistryLike {
+    onChanged(listener: (session: {
+        readonly id: unknown;
+    }, key: string, value: unknown, seq: number) => void): () => void;
+    snapshot(session: unknown, keys?: readonly string[]): {
+        readonly values: Record<string, unknown>;
+    };
+}
+/**
+ * Narrow one projection value: anything that is not an activity view is
+ * dropped rather than rendered half-formed.
+ * @param value - Raw projection value.
+ * @returns the value as an activity view, or `undefined`.
+ */
+export declare function asActivityView(value: unknown): ActivityView | undefined;
+/**
+ * The latest activity value for the session on screen, with a subscription
+ * for renderers.
+ *
+ * The store is effectively single-current: binding a session ({@link
+ * ActivityStore.seed}) names the session the UI is showing, and every other
+ * id is dropped — values, session objects and read-failure counts alike. A
+ * registry-less store (the UI's fallback, test rigs) has no current session
+ * and keeps today's accept-all behavior.
+ */
+export declare class ActivityStore {
+    private readonly values;
+    /** Session objects seen for each id, so a live value can be re-read. */
+    private readonly sessions;
+    /** Consecutive failed reads per session id; reset by a successful read. */
+    private readonly readFailures;
+    /** Sessions already warned about (see {@link noteReadFailure}): once each. */
+    private readonly warned;
+    private readonly listeners;
+    /** The session the UI is showing (the last {@link seed}); the only id kept. */
+    private currentId;
+    /** Host registry, remembered so a bind can read a baseline on demand. */
+    private registry;
+    /** Warn sink (see {@link noteReadFailure}); injected by the composition root. */
+    private readonly warn;
+    constructor(warn?: (message: string) => void);
+    /** Remember the host registry (see {@link seed} and {@link refreshLive}). */
+    attachRegistry(registry: ProjectionRegistryLike): void;
+    /**
+     * Seed one session from the registry's current snapshot and make it the
+     * current one.
+     *
+     * A value only *arrives* when it changes, so a session opened after its last
+     * change — a resume, or a window reattached to a running agent — would show
+     * nothing until the next event without this read. The bind also defines the
+     * session on screen: every other id is pruned, so a later event — or the
+     * tick — for a session the user switched away from can no longer fill this
+     * store or keep a timer armed.
+     * @param session - Session being bound.
+     */
+    seed(session: unknown): void;
+    /**
+     * Note the session object behind an id, so a live value can be re-read.
+     * Dropped for any id other than the current one (see {@link seed}). */
+    remember(sessionId: string, session: unknown): void;
+    /**
+     * Re-read the current session's value while it is still counting time.
+     *
+     * The host renders the value when it is *read*, so this is what makes the
+     * elapsed seconds advance between committed events — with the host's own copy
+     * and language, since nothing is re-rendered here. A value that has settled
+     * (`live` false: idle, or a finished turn) is deliberately skipped: its text
+     * cannot change on its own. Only the current session can be live (see
+     * {@link seed}), so the tick never polls a session the user left.
+     */
+    refreshLive(): void;
+    /** Whether the current session's value is still counting time (see {@link refreshLive}). */
+    hasLive(): boolean;
+    /** The current value for one session, stable between updates. */
+    get(sessionId: string | undefined): ActivityView | undefined;
+    /**
+     * Record one projection value. Dropped for any id other than the current
+     * one (see {@link seed}).
+     * @param sessionId - Session the value belongs to.
+     * @param view - The published value.
+     */
+    update(sessionId: string, view: ActivityView): void;
+    /** Forget one session (disposed, or left behind by a reset). */
+    clear(sessionId: string): void;
+    /** A read succeeded: this session's consecutive-failure count restarts. */
+    noteReadSuccess(sessionId: string): void;
+    /**
+     * A read failed. The failure is reported to the warn sink ONCE per session
+     * (the sink is the composition root's logger — this module stays free of
+     * cordis types), and after {@link MAX_READ_FAILURES} consecutive failures
+     * the value is cleared so the tick disarms instead of polling a registry
+     * that will never answer.
+     * @param sessionId - Session whose read failed.
+     * @param detail - What the failed read threw.
+     */
+    noteReadFailure(sessionId: string, detail: string): void;
+    /** Drop every id that is not the current one; emit when a value went. */
+    private pruneToCurrent;
+    /** Subscribe to value changes; returns the unsubscribe function. */
+    subscribe(listener: () => void): () => void;
+    private emit;
+}
+/**
+ * The change-feed listener for one store.
+ *
+ * Only this plugin's key is read, and only values that narrow to an activity
+ * view are accepted: the feed is host-wide, so every other unit's change and
+ * every malformed value must be dropped here rather than inside a renderer.
+ * @param store - Store to fill.
+ * @returns the listener to hand to `ProjectionRegistry.onChanged`.
+ */
+export declare function createActivityFeed(store: ActivityStore): (session: {
+    readonly id: unknown;
+}, key: string, value: unknown) => void;
+/** How often a value that is still counting time is re-read from the host. */
+export declare const LIVE_TICK_MS = 500;
+/**
+ * Wire one store to the host's projection registry.
+ *
+ * Registration is deferred through `inject` because the plugin that *publishes*
+ * the unit is mounted alongside this one: the registry may not exist yet, and
+ * the unit may not be registered until later still. Both absences are normal —
+ * a composition without the activity plugin simply never fills the store, and
+ * the line falls back to whatever else the UI has.
+ *
+ * The feed is event-driven, so a value only lands when a committed event folds;
+ * its elapsed text would therefore freeze for the length of a long tool. The
+ * host renders a value when it is READ, so a timer re-reads the live ones: the
+ * seconds advance, the copy and language stay the plugin's, and a settled value
+ * (idle, or a finished turn) stops the timer instead of being polled forever.
+ * @param ctx - Host context of the composition root.
+ * @param store - Store to fill.
+ */
+export declare function attachActivityProjection(ctx: Context, store: ActivityStore): void;
+/**
+ * Create the composition root's activity store and wire it to the host.
+ * @param ctx - Host context of the composition root.
+ * @param enabled - Whether the working line is shown at all (cordis.yml
+ *   `activity`; a static, config-time switch — the runtime `/activity` command
+ *   only changes the preset). With the line off, nothing attaches: no feed,
+ *   no registry, and therefore no 500ms tick for a line nobody renders.
+ * @returns the store the UI reads from.
+ */
+export declare function createActivityStore(ctx: Context, enabled: boolean): ActivityStore;
+/**
+ * Read one session's activity value in a component.
+ * @param store - Store to read.
+ * @param sessionId - Session the UI is showing.
+ * @returns the current value, or `undefined` when there is none.
+ */
+export declare function useActivity(store: ActivityStore, sessionId: string | undefined): ActivityView | undefined;
+/**
+ * Seed one session's value from the registry's current snapshot.
+ *
+ * A value only *arrives* when it changes, so a session opened after its last
+ * change — a resume, or a window reattached to a running agent — would show
+ * nothing until the next event without this read.
+ * @param registry - Host projection registry.
+ * @param store - Store to fill.
+ * @param session - Session to read.
+ */
+export declare function seedActivity(registry: ProjectionRegistryLike | undefined, store: ActivityStore, session: unknown): void;
+//# sourceMappingURL=activity-store.d.ts.map

package/lib/types/dsh-adapter/activity-store.d.ts.map

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