dsh-context 0.20.1 → 0.21.1

package/lib/client.js

@@ -67,6 +67,7 @@ var DICT_ZH = {
   "nodes.empty": "\u5F53\u524D\u6CA1\u6709\u6A21\u578B\u53EF\u89C1\u7684\u6D88\u606F",
   "loading": "\u6B63\u5728\u8BFB\u53D6\u4F1A\u8BDD\u65E5\u5FD7\u2026",
   "error": "\u4E0A\u4E0B\u6587\u6570\u636E\u8BFB\u53D6\u5931\u8D25\uFF1A",
+  "error.retry": "\u91CD\u8BD5",
   "footer": "\u4F30\u7B97\u53E3\u5F84\uFF1A\u4E0E dsh \u5185\u7F6E tokenMeter \u76F8\u540C\u7684\u56FA\u5B9A\u5BC6\u5EA6\u542F\u53D1\u5F0F\uFF08\u7EA6 4 \u5B57\u7B26 \u2248 1 token\uFF09\uFF1B\u300C\u5B9E\u9645\u300D\u4E3A\u4F9B\u5E94\u5546\u4E0A\u62A5\u7528\u91CF\u3002",
   "tip.step": "\u7B2C {t} \u8F6E \xB7 \u7B2C{s}\u6B65",
   "tip.turn": "\u7B2C {t} \u8F6E \xB7 \u5171 {n} \u6B65",
@@ -177,6 +178,7 @@ var DICT_EN = {
   "nodes.empty": "No model-visible messages right now",
   "loading": "Reading the session log\u2026",
   "error": "Failed to read context data: ",
+  "error.retry": "Retry",
   "footer": "Estimate: same fixed-density heuristic as dsh\u2019s built-in tokenMeter (~4 chars \u2248 1 token); \u201Cactual\u201D is provider-reported usage.",
   "tip.step": "Turn {t} \xB7 Step {s}",
   "tip.turn": "Turn {t} \xB7 {n} steps",
@@ -338,12 +340,60 @@ function asRecord(value) {
   if (value === null || value === void 0 || typeof value !== "object") return null;
   return value;
 }
-var timelineOf = (value) => asRecord(value);
+function numOf(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : 0;
+}
+function objectsOf(value) {
+  if (!Array.isArray(value)) return [];
+  return value.filter((v) => v !== null && typeof v === "object");
+}
+function timelineOf(value) {
+  const data = asRecord(value);
+  if (data === null) return null;
+  const current = data.current;
+  const numericBreakdown = current !== null && typeof current === "object" && ["system", "tools", "user", "inject", "assistant", "tool", "total"].every((k) => typeof current[k] === "number");
+  if (numericBreakdown && Array.isArray(data.requests) && Array.isArray(data.events) && Array.isArray(data.nodes) && Array.isArray(data.archive) && Array.isArray(data.toolList)) {
+    return data;
+  }
+  const safeCurrent = current !== null && typeof current === "object" ? current : {};
+  const cost = typeof data.cost === "object" && data.cost !== null && !Array.isArray(data.cost) ? data.cost : void 0;
+  return {
+    ok: true,
+    ...typeof data.model === "string" ? { model: data.model } : {},
+    ...typeof data.provider === "string" ? { provider: data.provider } : {},
+    ...typeof data.contextWindow === "number" ? { contextWindow: data.contextWindow } : {},
+    current: {
+      system: numOf(safeCurrent.system),
+      tools: numOf(safeCurrent.tools),
+      user: numOf(safeCurrent.user),
+      inject: numOf(safeCurrent.inject),
+      assistant: numOf(safeCurrent.assistant),
+      tool: numOf(safeCurrent.tool),
+      total: numOf(safeCurrent.total)
+    },
+    toolList: objectsOf(data.toolList),
+    requests: objectsOf(data.requests),
+    events: objectsOf(data.events),
+    nodes: objectsOf(data.nodes),
+    droppedNodes: numOf(data.droppedNodes),
+    archive: objectsOf(data.archive),
+    ...cost !== void 0 ? { cost } : {},
+    ...typeof data.surfaceFloor === "number" ? { surfaceFloor: data.surfaceFloor } : {},
+    ...typeof data.archiveFloor === "number" ? { archiveFloor: data.archiveFloor } : {}
+  };
+}
 var contextPressureOf = (value) => asRecord(value);
 var tokenUsageOf = (value) => asRecord(value);
 function headersOf(value) {
   const headers = asRecord(value);
-  return headers !== null && Array.isArray(headers.headers) ? headers : null;
+  if (headers === null || !Array.isArray(headers.headers)) return null;
+  for (const h2 of headers.headers) {
+    if (h2 === null || typeof h2 !== "object") return null;
+    const entry = h2;
+    if (!Array.isArray(entry.tools)) return null;
+    if (entry.system !== void 0 && typeof entry.system !== "string") return null;
+  }
+  return headers;
 }
 
 // src/client/assemble.ts
@@ -982,6 +1032,34 @@ function makeCurrentComposition(kit, StackedBar, Legend) {
   };
 }
 
+// src/client/components/errorBoundary.tsx
+function makeErrorBoundary(t) {
+  return class ErrorBoundary extends React.Component {
+    constructor(props) {
+      super(props);
+      this.state = { error: null };
+    }
+    static getDerivedStateFromError(error) {
+      return { error: error instanceof Error ? error : new Error(String(error)) };
+    }
+    render() {
+      const error = this.state.error;
+      if (error === null) return this.props.children;
+      return /* @__PURE__ */ React.createElement("div", { className: "lc-root" }, /* @__PURE__ */ React.createElement("div", { className: "lc-empty lc-error" }, /* @__PURE__ */ React.createElement("span", null, t("error")), /* @__PURE__ */ React.createElement("code", { className: "lc-error-msg" }, error.message), /* @__PURE__ */ React.createElement(
+        "button",
+        {
+          type: "button",
+          className: "lc-error-retry",
+          onClick: () => {
+            this.setState({ error: null });
+          }
+        },
+        t("error.retry")
+      )));
+    }
+  };
+}
+
 // src/client/components/contextModal.tsx
 function makeContextModal(ctx, kit) {
   const { t } = kit;
@@ -990,7 +1068,8 @@ function makeContextModal(ctx, kit) {
   const Legend = makeLegend(kit);
   const CurrentComposition = makeCurrentComposition(kit, StackedBar, Legend);
   const ContextBrowser = makeContextBrowser(kit, StackedBar);
-  return function ContextModal(props) {
+  const ErrorBoundary = makeErrorBoundary(t);
+  function ContextModalBody(props) {
     const sessionId = typeof props.sessionId === "string" ? props.sessionId : "";
     const open = typeof props.useContextModal === "function" ? props.useContextModal((s) => s) : false;
     const data = typeof props.useProjection === "function" ? timelineOf(props.useProjection("contextTimeline")) : null;
@@ -1051,6 +1130,9 @@ function makeContextModal(ctx, kit) {
         }
       }
     ))));
+  }
+  return function ContextModal(props) {
+    return h(ErrorBoundary, null, h(ContextModalBody, props));
   };
 }
 
@@ -1273,6 +1355,13 @@ var STYLES = [
   ".lc-node-tokens { color: var(--dsw-alias-label-secondary); }",
   ".lc-nodes-more { color: var(--dsw-alias-label-secondary); padding: 3px 0; }",
   ".lc-empty { color: var(--dsw-alias-label-secondary); padding: 18px 0; text-align: center; }",
+  // Error-boundary fallback card: the tab degrades to this instead of
+  // white-screening; the message runs in mono on a padded chip, and Retry
+  // re-mounts the subtree once a healthy value arrives.
+  ".lc-error { display: flex; flex-direction: column; align-items: center; gap: 8px; padding: 40px 16px; }",
+  ".lc-error-msg { font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size: 12px; color: var(--dsw-alias-state-error-primary); background: var(--dsw-alias-bg-layer-2); border: 1px solid var(--dsw-alias-border-l1); border-radius: 6px; padding: 4px 8px; max-width: 100%; overflow-wrap: anywhere; }",
+  ".lc-error-retry { border: 1px solid var(--dsw-alias-border-l1); background: var(--dsw-alias-bg-layer-2); color: var(--dsw-alias-label-primary); font: inherit; font-size: 12px; padding: 4px 14px; border-radius: 6px; cursor: pointer; }",
+  ".lc-error-retry:hover { border-color: var(--dsw-alias-label-primary); }",
   ".lc-foot { color: var(--dsw-alias-label-secondary); font-size: 12px; margin-top: 4px; }",
   // ---- /context modal (centered dialog; escapes the composer anchor via fixed positioning) ----
   ".lc-modal-backdrop { position: fixed; inset: 0; z-index: 200; background: rgba(0, 0, 0, 0.45); display: flex; align-items: center; justify-content: center; }",
@@ -1406,7 +1495,9 @@ function fmt(n) {
   return String(Math.round(n));
 }
 function fmtTime(t) {
-  return new Date(t).toLocaleTimeString("en-GB", { hour12: false });
+  const d = new Date(t);
+  if (isNaN(d.getTime())) return "\u2014";
+  return d.toLocaleTimeString("en-GB", { hour12: false });
 }
 
 // src/client/components/events.tsx
@@ -1472,7 +1563,7 @@ function makeEventList(kit) {
 
 // src/client/meta.ts
 var PLUGIN_NAME = "dsh-context";
-var PLUGIN_VERSION = true ? "0.20.1" : "0.0.0-dev";
+var PLUGIN_VERSION = true ? "0.21.1" : "0.0.0-dev";
 var PLUGIN_REPO = true ? "https://github.com/bowenliang123/dsh-context" : "https://github.com/bowenliang123/dsh-context";
 var PLUGIN_REPO_SHORT = PLUGIN_REPO.replace(/^https?:\/\/github\.com\//, "");
 
@@ -1563,7 +1654,7 @@ function estimateSessionCost(usage, currency) {
       const b = fam[period];
       if (b === void 0) continue;
       const p = PRICES[currency][family][period];
-      total += (b.cacheRead * p.hit + (b.uncached + b.cacheWrite) * p.miss + b.output * p.out) / 1e6;
+      total += (numOf(b.cacheRead) * p.hit + (numOf(b.uncached) + numOf(b.cacheWrite)) * p.miss + numOf(b.output) * p.out) / 1e6;
       any = true;
     }
   }
@@ -1586,9 +1677,12 @@ function formatPriceRate(amount, currency) {
 
 // src/client/components/statsBoard.tsx
 function cacheHitPercent(usage) {
-  const billed = usage.uncachedInputTokens + usage.cacheReadTokens + usage.cacheWriteTokens;
+  const uncached = numOf(usage.uncachedInputTokens);
+  const reads = numOf(usage.cacheReadTokens);
+  const writes = numOf(usage.cacheWriteTokens);
+  const billed = uncached + reads + writes;
   if (billed === 0) return null;
-  const hundredths = Math.trunc(usage.cacheReadTokens / billed * 1e4 + 1e-9);
+  const hundredths = Math.trunc(reads / billed * 1e4 + 1e-9);
   return `${Math.floor(hundredths / 100)}.${String(hundredths % 100).padStart(2, "0")}`;
 }
 function makeStatsBoard(kit) {
@@ -1811,7 +1905,8 @@ function makeContextView(ctx, kit) {
   const StatsBoard = makeStatsBoard(kit);
   const PluginInfo = makePluginInfo(kit);
   const ContextBrowser = makeContextBrowser(kit, StackedBar);
-  return function ContextView(props) {
+  const ErrorBoundary = makeErrorBoundary(t);
+  function ContextViewBody(props) {
     const sessionId = props.sessionId;
     const data = typeof props.useProjection === "function" ? timelineOf(props.useProjection("contextTimeline")) : null;
     const pressure = typeof props.useProjection === "function" ? contextPressureOf(props.useProjection("contextPressure")) : null;
@@ -1959,6 +2054,9 @@ function makeContextView(ctx, kit) {
       },
       t("kind." + k)
     )))), /* @__PURE__ */ React.createElement(EventList, { events: shownEvents })), /* @__PURE__ */ React.createElement("div", { className: "lc-card lc-col" }, /* @__PURE__ */ React.createElement("div", { className: "lc-card-title" }, /* @__PURE__ */ React.createElement("span", { className: "lc-card-title-text" }, t("nodes.title")), /* @__PURE__ */ React.createElement("span", { className: "lc-card-sub" }, t("nodes.hint"))), /* @__PURE__ */ React.createElement(NodeList, { nodes, dropped: data.droppedNodes || 0 }))), /* @__PURE__ */ React.createElement("div", { className: "lc-foot" }, t("footer")));
+  }
+  return function ContextView(props) {
+    return h(ErrorBoundary, null, h(ContextViewBody, props));
   };
 }
 

package/lib/index.js

@@ -103,6 +103,7 @@ var contextHeadersSchema = z2.object({
     tools: z2.array(headerToolSchema)
   }).strict())
 }).strict();
+var contextHeadersStateSchema = contextHeadersSchema;
 function recordOf(event) {
   if (event.type !== "request/header") return null;
   const header = event.data.header;
@@ -130,9 +131,17 @@ function recordOf(event) {
   return record;
 }
 function createContextHeadersDefinition() {
-  return {
+  const view = (state) => ({
+    headers: state.headers.map((h) => ({ ...h, tools: h.tools.map((t) => ({ ...t })) }))
+  });
+  const definition = {
     key: "contextHeaders",
+    // dsh <= 0.1.0-rc.8 contract: one schema validates the wire payload, `view` is top-level.
     schema: contextHeadersSchema,
+    view,
+    // dsh >= 0.1.1-rc.1 contract: `stateSchema` validates persisted state, the client view lives in `wire`.
+    stateSchema: contextHeadersStateSchema,
+    wire: { viewSchema: contextHeadersSchema, view },
     init: () => ({ headers: [] }),
     apply: (state, event) => {
       const record = recordOf(event);
@@ -142,11 +151,9 @@ function createContextHeadersDefinition() {
       const headers = [...state.headers, record];
       return { headers: headers.length > HEADERS_MAX ? headers.slice(-HEADERS_MAX) : headers };
     },
-    view: (state) => ({
-      headers: state.headers.map((h) => ({ ...h, tools: h.tools.map((t) => ({ ...t })) }))
-    }),
     stateVersion: 1
   };
+  return definition;
 }
 
 // src/host/timeline.ts
@@ -616,14 +623,42 @@ var contextTimelineSchema = z3.object({
   surfaceFloor: z3.number().int().nonnegative().optional(),
   archiveFloor: z3.number().int().nonnegative().optional()
 }).strict();
+var timelineStateSchema = z3.object({
+  surface: z3.array(surfaceNodeSchema),
+  sums: z3.object({
+    user: z3.number().int().nonnegative(),
+    inject: z3.number().int().nonnegative(),
+    assistant: z3.number().int().nonnegative(),
+    tool: z3.number().int().nonnegative()
+  }).strict(),
+  systemTokens: z3.number().int().nonnegative(),
+  toolsTokens: z3.number().int().nonnegative(),
+  toolList: z3.array(z3.object({ name: z3.string(), tokens: z3.number().int().nonnegative() }).strict()),
+  model: z3.string().optional(),
+  provider: z3.string().optional(),
+  lastModel: z3.string().optional(),
+  contextWindow: z3.number().optional(),
+  requests: z3.array(requestRecordSchema),
+  events: z3.array(contextEventSchema),
+  archived: z3.array(surfaceNodeSchema),
+  cost: z3.object({ flash: costFamilySchema.optional(), pro: costFamilySchema.optional() }).strict().optional(),
+  archiveFloor: z3.number().optional(),
+  callNames: z3.record(z3.string(), z3.string()),
+  pendingShadowedSeqs: z3.array(z3.number()).optional()
+});
 function createContextTimelineDefinition(config) {
   const bounds = resolveBounds(config);
-  return {
+  const view = (state) => buildTimelineView(state, bounds);
+  const definition = {
     key: "contextTimeline",
+    // dsh <= 0.1.0-rc.8 contract: one schema validates the wire payload, `view` is top-level.
     schema: contextTimelineSchema,
+    view,
+    // dsh >= 0.1.1-rc.1 contract: `stateSchema` validates persisted state, the client view lives in `wire`.
+    stateSchema: timelineStateSchema,
+    wire: { viewSchema: contextTimelineSchema, view },
     init: () => createTimelineState(),
     apply: (state, event) => applyTimeline(state, event, bounds),
-    view: (state) => buildTimelineView(state, bounds),
     // 2 since 0.11: the occupancy mirror (pressureTokens/sampledSurfaceTokens/
     // occupancyWindow) left the persisted state — the client now reads the
     // official token-meter `contextPressure` projection instead. Old cached
@@ -644,6 +679,7 @@ function createContextTimelineDefinition(config) {
     // are refolded.
     stateVersion: 5
   };
+  return definition;
 }
 
 // src/host/index.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-context",
-  "version": "0.20.1",
+  "version": "0.21.1",
   "description": "A DeepSeek Harness plugin for context insight and management, with context dashboard and context command, for understanding how the context is made of, and how it evolves.",
   "author": "bowenliang123",
   "repository": {