dsh-continual-evolve 0.15.4 → 0.15.6

package/lib/token-usage.d.ts

@@ -0,0 +1,30 @@
+/**
+ * The single accounting entry for direct LLM calls (the `token-usage.ts`
+ * the coding standard names). Observed provider payloads disagree on keys —
+ * `inputTokens`/`outputTokens` are usual, `totalTokens`, `cacheReadTokens`,
+ * `cacheWriteTokens`, and `reasoningTokens` come and go — so every call site
+ * normalizes through {@link normalizeUsage} and aggregates with
+ * {@link sumUsage}. Nothing here touches the store: aggregation over ledger
+ * rows lives in `store.reviewSummary`, which stays read-only and bounded.
+ */
+/** Token counts for one LLM call, every field present, zeros when unknown. */
+export interface UsageTotals {
+    input: number;
+    output: number;
+    cacheRead: number;
+    cacheWrite: number;
+    reasoning: number;
+    total: number;
+}
+/** The zero value: no signal, not a failure. */
+export declare function zeroUsage(): UsageTotals;
+/**
+ * Normalize one provider usage payload to full totals. Returns `null` when
+ * the payload carries no usable numeric signal at all (not an object, or an
+ * object with no recognized numeric field) — callers treat that as "no
+ * accounting for this run", never as zeros that would dilute real totals.
+ */
+export declare function normalizeUsage(raw: unknown): UsageTotals | null;
+/** Pure field-wise sum; either side may be a zero value. */
+export declare function sumUsage(a: UsageTotals, b: UsageTotals): UsageTotals;
+//# sourceMappingURL=token-usage.d.ts.map

package/lib/token-usage.js

@@ -0,0 +1,58 @@
+/**
+ * The single accounting entry for direct LLM calls (the `token-usage.ts`
+ * the coding standard names). Observed provider payloads disagree on keys —
+ * `inputTokens`/`outputTokens` are usual, `totalTokens`, `cacheReadTokens`,
+ * `cacheWriteTokens`, and `reasoningTokens` come and go — so every call site
+ * normalizes through {@link normalizeUsage} and aggregates with
+ * {@link sumUsage}. Nothing here touches the store: aggregation over ledger
+ * rows lives in `store.reviewSummary`, which stays read-only and bounded.
+ */
+/** The zero value: no signal, not a failure. */
+export function zeroUsage() {
+    return { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, reasoning: 0, total: 0 };
+}
+function num(value) {
+    return typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : 0;
+}
+/**
+ * Normalize one provider usage payload to full totals. Returns `null` when
+ * the payload carries no usable numeric signal at all (not an object, or an
+ * object with no recognized numeric field) — callers treat that as "no
+ * accounting for this run", never as zeros that would dilute real totals.
+ */
+export function normalizeUsage(raw) {
+    if (typeof raw !== "object" || raw === null) {
+        return null;
+    }
+    const payload = raw;
+    const input = num(payload.inputTokens);
+    const output = num(payload.outputTokens);
+    const cacheRead = num(payload.cacheReadTokens);
+    const cacheWrite = num(payload.cacheWriteTokens);
+    const reasoning = num(payload.reasoningTokens);
+    const recognized = [input, output, cacheRead, cacheWrite, reasoning].some((n) => n > 0);
+    const totalRaw = num(payload.totalTokens);
+    if (!recognized && totalRaw === 0) {
+        return null;
+    }
+    return {
+        input,
+        output,
+        cacheRead,
+        cacheWrite,
+        reasoning,
+        total: totalRaw > 0 ? totalRaw : input + output,
+    };
+}
+/** Pure field-wise sum; either side may be a zero value. */
+export function sumUsage(a, b) {
+    return {
+        input: a.input + b.input,
+        output: a.output + b.output,
+        cacheRead: a.cacheRead + b.cacheRead,
+        cacheWrite: a.cacheWrite + b.cacheWrite,
+        reasoning: a.reasoning + b.reasoning,
+        total: a.total + b.total,
+    };
+}
+//# sourceMappingURL=token-usage.js.map

package/locale/en.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "Workspace Memory",
-    "description": "Central SQLite memory store partitioned by workspace: session-start index injection, gated explicit writes and proposal-based extraction."
+    "description": "Central SQLite memory and skill store partitioned by workspace: session-start index injection, gated explicit writes and proposal-based extraction, skills materialized as SKILL.md."
   }
 }

package/locale/zh.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "工作区记忆",
-    "description": "中央 SQLite 记忆库，按工作区分区：开局注入索引、显式写入与提案制提取全部过代码门禁。"
+    "description": "中央 SQLite 记忆与技能库，按工作区分区：开局注入索引、显式写入与提案制提取全部过代码门禁，技能物化为 SKILL.md。"
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-continual-evolve",
-  "version": "0.15.4",
+  "version": "0.15.6",
   "description": "ZCode-style workspace memory for DeepSeek Harness: one central SQLite store partitioned by workspace, index injection, and sole-writer gated writes.",
   "license": "MIT",
   "repository": {