dsh-context 0.65.0 → 0.66.0

package/lib/index.d.ts

@@ -1,3 +1,4 @@
+
 import { z } from "zod";
 import "@deepseek-ai/dsh-session";
 import z$1 from "@deepseek-ai/schemastery";
@@ -5,16 +6,22 @@ import { Context } from "@deepseek-ai/cordis";
 //#region src/host/activity.d.ts
 /** The persisted fold state (the registry's `stateSchema` contract). */
 interface ActivityState {
-  days: Record<string, {
-    tokens: number;
-    requests: number;
-    cost?: SessionCostUsage;
-  }>;
+  days: Record<string, ActivityDay>;
   /** The route in force (last `request/header`'s config wins) — prices each settlement. */
   model?: string;
   provider?: string;
   /** The open step's start instant (armed by `step/start`, cleared by `step/end`). */
   stepStart?: number;
+  /**
+   * Pending `skill`-tool call ids (armed by `tool/call`, consumed by the
+   * pairing `tool/result`). The wrapper match alone is not trusted: a `read`
+   * of source text quoting `<skill_content name="…">` (this very file's
+   * comments, say) must not book a load — the timeline fold's pairing
+   * authority (fold.ts) applies here too. Bounded at
+   * {@link MAX_PENDING_SKILL_CALLS}; a never-answered call's id drops oldest
+   * first.
+   */
+  skillCalls?: string[];
 }
 //#endregion
 //#region src/host/headers.d.ts
@@ -118,6 +125,14 @@ interface TimelineState {
    * the first human input folds.
    */
   humanInputs?: number;
+  /**
+   * Whole-session answers tally (see Snapshot.answers): one per assistant
+   * message carrying a non-blank text block — a step that only dispatched
+   * tool calls (or projected to no message at all) is work, not a reply.
+   * Running total — never trimmed, like `humanInputs`. Absent until the first
+   * textual reply folds.
+   */
+  answers?: number;
   /**
    * The user's newest own message as a bounded one-line preview (the surface
    * node's first-text line). Last-wins — a newer human input replaces it, a
@@ -338,6 +353,15 @@ interface TimelineCounts {
   injects: number;
   compactions: number;
   prunes: number;
+  /**
+   * Distinct skills loaded this session — the unique names among the retained
+   * inject events the fold tagged `sub: 'skill'` (a user-explicit `/name`
+   * invocation's instructions or a `skill`-tool load's content). The
+   * `<available_skills>` catalog digest is injected context without a name
+   * and never counts. Additive-optional: a head served without it (a partial
+   * record re-proved at the client's boundary) reads as zero.
+   */
+  skills?: number;
 }
 /**
  * The newest retained request record's billing summary — the headline's
@@ -370,6 +394,18 @@ interface ActivityDay {
    * provider left unmetered — the usage chart degrades to tokens-only bars.
    */
   cost?: SessionCostUsage;
+  /**
+   * The day's skill loads, skill name → its tally (`n` loads, `last` load
+   * instant in epoch ms): both durable load gestures — a user-explicit
+   * `/name` invocation's `skill-invocation` injection and a `skill`-tool
+   * load's `<skill_content>` result. ADDITIVE-OPTIONAL: absent on rows folded
+   * before the field existed and on days without a load — the Insights page's
+   * skill card treats a missing record as an empty day.
+   */
+  skills?: Record<string, {
+    n: number;
+    last: number;
+  }>;
 }
 /**
  * The per-session daily activity ledger (`contextActivity` wire value):
@@ -381,11 +417,30 @@ 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.
+ * One available skill's catalog metadata, served by the plugin's
+ * `/api/dsh-context/skills` route (host/skills.ts) off the harness's skill
+ * registry: the Insights page's skill card joins it by name onto the load
+ * tallies to show what a skill IS (description, origin, on-disk path). Every
+ * field but `name` is best-effort — a registry that omits one still serves
+ * the rest, and the card renders the tally alone when the route is absent.
+ */
+interface SkillInfo {
+  /** Kebab-case identifier — the join key onto `ActivityDay.skills`. */
+  name: string;
+  /** The registry's routing description (may be empty). */
+  description: string;
+  /** Absolute instruction file path, when the provider is filesystem-backed. */
+  path?: string;
+  /** Discovery source bucket (e.g. 'project-agents', 'user-dsh', 'bundled'). */
+  source?: string;
+}
+/**
+ * The per-user display-preference vocabulary of the `dsh-context` entry —
+ * the ONE declaration both halves share: the Host's entry Config schema
+ * carries the fields as `.volatile()` preferences (host/config.ts — the
+ * Config-form generation serves them live on the Plugins page), the Client
+ * binds the form and edits fields by name (client/settings.ts). Type-only,
+ * so both bundles erase it.
  */
 type DefaultGranularity = 'step' | 'turn';
 type DefaultTrendMode = 'total' | 'delta';
@@ -447,6 +502,14 @@ interface Snapshot {
    * from older hosts; clients treat absence as zero.
    */
   humanInputs?: number;
+  /**
+   * Whole-session answers tally: one per assistant message carrying a
+   * non-blank text block — steps that only dispatched tool calls are not
+   * replies. Running total over the complete log, like `humanInputs`.
+   * Additive-optional — absent from rows folded before the field existed;
+   * clients treat absence as zero.
+   */
+  answers?: number;
   /**
    * The user's newest own message as a one-line bounded preview (first text
    * block, whitespace collapsed, ~80 chars): the session cards' footer line.
@@ -962,35 +1025,35 @@ export interface Config {
 }
 /** The cordis `Config` validator and the Config-form generation's served schema. */
 export declare const Config: z$1<Schemastery.ObjectS<NoInfer<{
-  maxRequestSteps: z$1<number, number, Mode extends "volatile" | "volatile-defined" ? "volatile-defined" : "defined">;
-  maxKeptTurns: z$1<number, number, Mode extends "volatile" | "volatile-defined" ? "volatile-defined" : "defined">;
-  maxEvents: z$1<number, number, Mode extends "volatile" | "volatile-defined" ? "volatile-defined" : "defined">;
-  maxNodes: z$1<number, number, Mode extends "volatile" | "volatile-defined" ? "volatile-defined" : "defined">;
-  maxArchiveNodes: z$1<number, number, Mode extends "volatile" | "volatile-defined" ? "volatile-defined" : "defined">;
-  maxFileOps: z$1<number, number, Mode extends "volatile" | "volatile-defined" ? "volatile-defined" : "defined">;
-  defaultPlacement: z$1<"all" | "sidebar" | "tab", "all" | "sidebar" | "tab", Mode>;
-  defaultGranularity: z$1<"step" | "turn", "step" | "turn", Mode>;
-  defaultTrendMode: z$1<"delta" | "total", "delta" | "total", Mode>;
-  defaultDeltaBase: z$1<"step" | "turn", "step" | "turn", Mode>;
-  defaultToolSort: z$1<"count" | "name" | "size", "count" | "name" | "size", Mode>;
-  defaultFileSort: z$1<"count" | "latest" | "path", "count" | "latest" | "path", Mode>;
-  insightsEntry: z$1<"hide" | "show", "hide" | "show", Mode>;
-  defaultDurationCurve: z$1<"hide" | "show", "hide" | "show", Mode>;
+  maxRequestSteps: z$1<number, number, "defined">;
+  maxKeptTurns: z$1<number, number, "defined">;
+  maxEvents: z$1<number, number, "defined">;
+  maxNodes: z$1<number, number, "defined">;
+  maxArchiveNodes: z$1<number, number, "defined">;
+  maxFileOps: z$1<number, number, "defined">;
+  defaultPlacement: z$1<"all" | "sidebar" | "tab", "all" | "sidebar" | "tab", "defined">;
+  defaultGranularity: z$1<"step" | "turn", "step" | "turn", "defined">;
+  defaultTrendMode: z$1<"delta" | "total", "delta" | "total", "defined">;
+  defaultDeltaBase: z$1<"step" | "turn", "step" | "turn", "defined">;
+  defaultToolSort: z$1<"count" | "name" | "size", "count" | "name" | "size", "defined">;
+  defaultFileSort: z$1<"count" | "latest" | "path", "count" | "latest" | "path", "defined">;
+  insightsEntry: z$1<"hide" | "show", "hide" | "show", "defined">;
+  defaultDurationCurve: z$1<"hide" | "show", "hide" | "show", "defined">;
 }>>, Schemastery.ObjectT<NoInfer<{
-  maxRequestSteps: z$1<number, number, Mode extends "volatile" | "volatile-defined" ? "volatile-defined" : "defined">;
-  maxKeptTurns: z$1<number, number, Mode extends "volatile" | "volatile-defined" ? "volatile-defined" : "defined">;
-  maxEvents: z$1<number, number, Mode extends "volatile" | "volatile-defined" ? "volatile-defined" : "defined">;
-  maxNodes: z$1<number, number, Mode extends "volatile" | "volatile-defined" ? "volatile-defined" : "defined">;
-  maxArchiveNodes: z$1<number, number, Mode extends "volatile" | "volatile-defined" ? "volatile-defined" : "defined">;
-  maxFileOps: z$1<number, number, Mode extends "volatile" | "volatile-defined" ? "volatile-defined" : "defined">;
-  defaultPlacement: z$1<"all" | "sidebar" | "tab", "all" | "sidebar" | "tab", Mode>;
-  defaultGranularity: z$1<"step" | "turn", "step" | "turn", Mode>;
-  defaultTrendMode: z$1<"delta" | "total", "delta" | "total", Mode>;
-  defaultDeltaBase: z$1<"step" | "turn", "step" | "turn", Mode>;
-  defaultToolSort: z$1<"count" | "name" | "size", "count" | "name" | "size", Mode>;
-  defaultFileSort: z$1<"count" | "latest" | "path", "count" | "latest" | "path", Mode>;
-  insightsEntry: z$1<"hide" | "show", "hide" | "show", Mode>;
-  defaultDurationCurve: z$1<"hide" | "show", "hide" | "show", Mode>;
+  maxRequestSteps: z$1<number, number, "defined">;
+  maxKeptTurns: z$1<number, number, "defined">;
+  maxEvents: z$1<number, number, "defined">;
+  maxNodes: z$1<number, number, "defined">;
+  maxArchiveNodes: z$1<number, number, "defined">;
+  maxFileOps: z$1<number, number, "defined">;
+  defaultPlacement: z$1<"all" | "sidebar" | "tab", "all" | "sidebar" | "tab", "defined">;
+  defaultGranularity: z$1<"step" | "turn", "step" | "turn", "defined">;
+  defaultTrendMode: z$1<"delta" | "total", "delta" | "total", "defined">;
+  defaultDeltaBase: z$1<"step" | "turn", "step" | "turn", "defined">;
+  defaultToolSort: z$1<"count" | "name" | "size", "count" | "name" | "size", "defined">;
+  defaultFileSort: z$1<"count" | "latest" | "path", "count" | "latest" | "path", "defined">;
+  insightsEntry: z$1<"hide" | "show", "hide" | "show", "defined">;
+  defaultDurationCurve: z$1<"hide" | "show", "hide" | "show", "defined">;
 }>>, "plain">;
 //#endregion
 //#region src/host/index.d.ts
@@ -998,4 +1061,4 @@ export declare const name = "dsh-context";
 export declare const inject: string[];
 export declare function apply(ctx: Context, config: Config): void;
 //#endregion
-export type { ActivityDay, ActivityState, Category, ContextActivity, ContextEventRecord, ContextHeaders, ContextTimeline, ContextTimelineDetail, HeaderRecord, HeaderTool, HeadersState, PlatformBalance, PlatformBalanceEntry, RequestRecord, Snapshot, SurfaceNode, TimelineCounts, TimelineLast, TimelineState };
+export type { ActivityDay, ActivityState, Category, ContextActivity, ContextEventRecord, ContextHeaders, ContextTimeline, ContextTimelineDetail, HeaderRecord, HeaderTool, HeadersState, PlatformBalance, PlatformBalanceEntry, RequestRecord, SkillInfo, Snapshot, SurfaceNode, TimelineCounts, TimelineLast, TimelineState };