dsh-context 0.54.4 → 0.55.0

package/lib/index.d.ts

@@ -1,37 +1,7 @@
 import { z } from "zod";
 import "@deepseek-ai/dsh-session";
+import z$1 from "@deepseek-ai/schemastery";
 import { Context } from "@deepseek-ai/cordis";
-//#region src/host/config.d.ts
-export interface Config {
-  /** Cap on kept per-step request records (the hard step backstop). */
-  maxRequestSteps?: number;
-  /** Newest whole-turn window kept; trimming crosses whole turns, never mid-turn. */
-  maxKeptTurns?: number;
-  maxEvents?: number;
-  /**
-   * Served surface nodes (newest carry the signal; live inject nodes are pinned — they land first and are few). Deliberately generous:
-   * auto-compaction keeps healthy surfaces far below it, so the browser effectively lists every live node; the bound is a
-   * pathological-session backstop (each push ships the whole value, ~150B/node).
-   */
-  maxNodes?: number;
-  /** Removed (shadowed) surface nodes kept for per-step reconstruction. */
-  maxArchiveNodes?: number;
-  /** Fold-derived file-operation records kept (the File Activity card's raw material). */
-  maxFileOps?: number;
-}
-/**
- * The cordis `Config` validator: strict on keys, defaults on the schema fields; tolerates `undefined` (a patch row without a `config:`
- * block — defaults win).
- */
-export declare const Config: z.ZodPreprocess<z.ZodObject<{
-  maxRequestSteps: z.ZodDefault<z.ZodNumber>;
-  maxKeptTurns: z.ZodDefault<z.ZodNumber>;
-  maxEvents: z.ZodDefault<z.ZodNumber>;
-  maxNodes: z.ZodDefault<z.ZodNumber>;
-  maxArchiveNodes: z.ZodDefault<z.ZodNumber>;
-  maxFileOps: z.ZodDefault<z.ZodNumber>;
-}, z.core.$strict>>;
-//#endregion
 //#region src/host/activity.d.ts
 /** The persisted fold state (the registry's `stateSchema` contract). */
 interface ActivityState {
@@ -73,6 +43,8 @@ interface HeadersState {
  * poisoning a bucket.
  */
 type DecodeKind = 'reasoning' | 'text' | 'toolarg';
+/** Per-kind count of opened decode blocks (see {@link decodeTallyOfStream}). */
+type DecodeCounts = Record<DecodeKind, number>;
 //#endregion
 //#region src/host/fold.d.ts
 /**
@@ -127,6 +99,16 @@ interface TimelineState {
   lastModel?: string;
   contextWindow?: number;
   requests: RequestRecord[];
+  /**
+   * The number of turn runs in `requests` (a run = consecutive records
+   * sharing one `turn`). Maintained incrementally at the single append site
+   * and recomputed when a trim replaces the array, so the retention trim's
+   * cap check stays O(1) per event instead of walking every retained
+   * request. Absent on rows folded before the field existed — the first
+   * post-restore event recomputes it once (the same additive-optional shape
+   * as `detailRev`).
+   */
+  turnRuns?: number;
   events: ContextEventRecord[];
   /**
    * Recently removed surface nodes (stamped COPIES carrying `gone`), in
@@ -188,16 +170,19 @@ interface TimelineState {
    * durations, never to unbounded state. Same arm/remove lifecycle as
    * `pendingShadowedSeqs`.
    *
-   * `decode` and `block` carry the generation split (reasoning / answer text /
-   * tool arguments — see TimingTotals): a V0 log's `assistant/chunk`
-   * `block-start` markers open `block` and close the previous one into
-   * `decode`; a V2+ log carries no such events, so `decode` stays absent and
-   * `assistant/message` reads the spans off its embedded stream instead.
+   * `decode`, `blocks` and `block` carry the generation split (reasoning /
+   * answer text / tool arguments — see TimingTotals): a V0 log's
+   * `assistant/chunk` `block-start` markers open `block`, close the previous
+   * one into `decode`, and count the opened bucket into `blocks` (the card's
+   * per-slice tally); a V2+ log carries no such events, so `decode` stays
+   * absent and `assistant/message` reads the spans and counts off its embedded
+   * stream instead.
    */
   stepStart?: {
     time: number;
     firstToken?: number;
     decode?: Record<DecodeKind, number>;
+    blocks?: DecodeCounts;
     block?: {
       kind: DecodeKind;
       since: number;
@@ -362,6 +347,23 @@ interface ActivityDay {
 interface ContextActivity {
   days: Record<string, ActivityDay>;
 }
+/**
+ * The per-user display-preference vocabulary of the `dsh-context` settings
+ * namespace — the ONE declaration both halves share: the Host registers the
+ * namespace schema against it (host/settings.ts), the Client binds the scope
+ * and edits fields by name (client/settings.ts). Type-only, so both bundles
+ * erase it.
+ */
+type DefaultGranularity = 'step' | 'turn';
+type DefaultTrendMode = 'total' | 'delta';
+/** File Activity row order: most operations first, most-recently-touched first, or path ascending. */
+type DefaultFileSort = 'count' | 'latest' | 'path';
+/** Tool-definition row order: largest schema first, most call hits first, or name ascending. */
+type DefaultToolSort = 'size' | 'count' | 'name';
+/** Where the Context view is offered: the conversation tab, the right Sidebar, or both. */
+type DefaultPlacement = 'all' | 'tab' | 'sidebar';
+/** Whether the Context Insights panel's sidebar entry is offered at all. */
+type InsightsEntry = 'show' | 'hide';
 interface Snapshot {
   ok: boolean;
   /**
@@ -634,10 +636,22 @@ interface TimingTotals {
   genMs: number;
   /** Reasoning-decode slice of `genMs` (the model's thinking). */
   reasoningMs?: number;
+  /** Counted reasoning-decode blocks (the Thinking slice's tally). */
+  reasoningBlocks?: number;
   /** Answer-text decode slice of `genMs`. */
   textMs?: number;
+  /** Counted answer-text decode blocks (the Answer slice's tally). */
+  textBlocks?: number;
   /** Tool-call-argument decode slice of `genMs`. */
   toolArgMs?: number;
+  /**
+   * Counted tool-call-argument decode blocks — one per tool call whose
+   * arguments the stream decoded (the Tool args slice's tally). The counts are
+   * ADDITIVE-OPTIONAL like their spans: a row cached before they existed (or a
+   * call whose stream framed no blocks) carries none, and the card qualifies
+   * only what was actually counted.
+   */
+  toolArgBlocks?: number;
   /**
    * The decode-throughput seat, paired exactly as the harness's own
    * session-stats fold pairs them: `speedTokens` sums provider-reported
@@ -833,6 +847,39 @@ interface PlatformBalance {
   balances: PlatformBalanceEntry[];
 }
 //#endregion
+//#region src/host/config.d.ts
+export interface Config {
+  /** Cap on kept per-step request records (the hard step backstop). */
+  maxRequestSteps?: number;
+  /** Newest whole-turn window kept; trimming crosses whole turns, never mid-turn. */
+  maxKeptTurns?: number;
+  maxEvents?: number;
+  /**
+   * Served surface nodes (newest carry the signal; live inject nodes are pinned — they land first and are few). Deliberately generous:
+   * auto-compaction keeps healthy surfaces far below it, so the browser effectively lists every live node; the bound is a
+   * pathological-session backstop (each push ships the whole value, ~150B/node).
+   */
+  maxNodes?: number;
+  /** Removed (shadowed) surface nodes kept for per-step reconstruction. */
+  maxArchiveNodes?: number;
+  /** Fold-derived file-operation records kept (the File Activity card's raw material). */
+  maxFileOps?: number;
+  /** Where the Context view is offered (the conversation tab, the right Sidebar, or both). */
+  defaultPlacement?: DefaultPlacement;
+  /** Timeline default granularity (per step or per turn). */
+  defaultGranularity?: DefaultGranularity;
+  /** Timeline default trend mode (total or delta). */
+  defaultTrendMode?: DefaultTrendMode;
+  /** Tool-definition row default order. */
+  defaultToolSort?: DefaultToolSort;
+  /** File Activity row default order. */
+  defaultFileSort?: DefaultFileSort;
+  /** Whether the Context Insights panel's sidebar entry is offered. */
+  insightsEntry?: InsightsEntry;
+}
+/** The cordis `Config` validator and the Config-form generation's served schema. */
+export declare const Config: z$1<Config>;
+//#endregion
 //#region src/host/index.d.ts
 export declare const name = "dsh-context";
 export declare const inject: string[];