dsh-auto-compaction 0.1.3 → 0.2.0

package/package.json

@@ -1,17 +1,29 @@
 {
   "name": "dsh-auto-compaction",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "type": "module",
   "main": "lib/index.js",
   "exports": {
     ".": "./lib/index.js",
-    "./lib/*": "./lib/*",
+    "./client": "./lib/client.js",
     "./package.json": "./package.json"
   },
-  "description": "A session auto-compaction plugin that is friendly to local models: compaction never makes the local engine re-read history, saving a lot of time; the trigger point and the saved content of the compacted session are user-configurable.",
+  "description": "Settings page (设置 → 会话压缩) for A session auto-compaction plugin that is friendly to local models: compaction never makes the local engine re-read history, saving a lot of time; the trigger point and the saved content of the compacted session are user-configurable.",
   "engines": {
     "node": "^22.19.0 || >=24.0.0"
   },
+  "dsh": {
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-ui-conversation"
+      ],
+      "platform": "web"
+    },
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -28,20 +40,17 @@
     "cordis",
     "plugin",
     "compaction",
-    "context",
-    "handoff",
-    "llm",
-    "local-llm"
+    "settings-ui"
   ],
   "files": [
     "lib",
-    "scripts",
+    "cordis.patch.yml",
     "README.md"
   ],
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "js-yaml": "^4.1.0"
+    "dsh-auto-compaction-engine": "^0.2.0"
   }
 }

package/lib/plan.js

@@ -1,79 +0,0 @@
-/**
- * Pure decision helpers for idle-time handoff compaction.
- * Kept free of cordis/DSH imports so they can be unit-tested directly.
- */
-
-/**
- * Threshold in tokens for a routed model.
- *
- * The ratio is applied to the *usable input budget* (window minus the output
- * tokens the routed request reserves), then clamped by the headroom safety
- * margin. That makes the whole 0-100% range monotonic: on a 250K window with a
- * 20K reservation and 10K headroom the budget is 230K and the ceiling 220K, so
- * 90% means 207K and 100% means 220K.
- *
- * @param {object} input
- * @param {number} input.contextWindow  model window in tokens
- * @param {number} [input.reservedCompletionTokens]  output tokens the routed request reserves
- * @param {number} [input.headroomTokens]  safety margin below the budget
- * @param {number} [input.thresholdRatio]  fraction of the usable budget, default 0.9
- */
-export function resolveThreshold({ contextWindow, reservedCompletionTokens = 0, headroomTokens = 0, thresholdRatio = 0.9 }) {
-  if (!Number.isFinite(contextWindow) || contextWindow <= 0) {
-    return { ok: false, reason: `contextWindow (${contextWindow}) must be a positive number` };
-  }
-  if (!Number.isFinite(reservedCompletionTokens) || reservedCompletionTokens < 0) {
-    return { ok: false, reason: `reservedCompletionTokens (${reservedCompletionTokens}) must be >= 0` };
-  }
-  if (!Number.isFinite(headroomTokens) || headroomTokens < 0) {
-    return { ok: false, reason: `headroomTokens (${headroomTokens}) must be >= 0` };
-  }
-  if (!(thresholdRatio > 0 && thresholdRatio <= 1)) {
-    return { ok: false, reason: `thresholdRatio (${thresholdRatio}) must be in (0, 1]` };
-  }
-  const budgetTokens = contextWindow - reservedCompletionTokens;
-  if (budgetTokens <= 0) {
-    return { ok: false, reason: `no input budget: window ${contextWindow} - reserved ${reservedCompletionTokens}` };
-  }
-  const ceilingTokens = budgetTokens - headroomTokens;
-  if (ceilingTokens <= 0) {
-    return { ok: false, reason: `headroom ${headroomTokens} consumes the input budget ${budgetTokens}` };
-  }
-  return {
-    ok: true,
-    thresholdTokens: Math.floor(Math.min(Math.round(budgetTokens * thresholdRatio), ceilingTokens)),
-    budgetTokens,
-    ceilingTokens,
-  };
-}
-
-/** Whether the measured session is at or above the handoff threshold. */
-export function decideTrigger(input) {
-  const spec = resolveThreshold(input);
-  if (!spec.ok) return { trigger: false, ...spec };
-  return {
-    trigger: input.totalTokens >= spec.thresholdTokens,
-    totalTokens: input.totalTokens,
-    thresholdTokens: spec.thresholdTokens,
-  };
-}
-
-/**
- * Retry gate: avoids hammering a session whose handoff keeps failing, or that
- * shrank but is still reported above the threshold.
- *
- * @param {object} input
- * @param {number} input.now  epoch ms
- * @param {{at:number,tokens:number}|undefined} input.last  previous attempt record
- * @param {number} input.tokens  current measured tokens
- * @param {number} input.thresholdTokens  current threshold
- * @param {number} [input.minIntervalMs]  minimum wall-clock gap between attempts
- * @param {number} [input.minTokenGrowth]  minimum growth since the last attempt
- */
-export function shouldAttempt({ now, last, tokens, thresholdTokens, minIntervalMs = 60_000, minTokenGrowth = 2_048 }) {
-  if (tokens < thresholdTokens) return false;
-  if (last === undefined) return true;
-  if (now - last.at < minIntervalMs) return false;
-  if (tokens - last.tokens < minTokenGrowth) return false;
-  return true;
-}

package/lib/status.js

@@ -1,52 +0,0 @@
-/**
- * Per-session compaction status sidecar.
- *
- * The engine writes one small JSON file while it prepares, summarizes and
- * commits a handoff; the UI dock polls it through the companion package's RPC
- * channel. Kept free of DSH imports so the UI's node half can reuse it.
- */
-import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
-import { homedir } from "node:os";
-import { join } from "node:path";
-
-const STATUS_DIR = process.env.DSH_HANDOFF_STATUS_DIR || join(homedir(), ".dsh-handoff-compaction", "status");
-const SESSION_ID = /^[A-Za-z0-9_-]{1,128}$/;
-
-/** Absolute status file for a session id, or undefined when the id is unsafe. */
-export function statusFileFor(sessionId) {
-  if (typeof sessionId !== "string" || !SESSION_ID.test(sessionId)) return undefined;
-  return join(STATUS_DIR, `${sessionId}.json`);
-}
-
-/** Latest status for a session, or undefined when absent/unreadable. */
-export function readStatus(sessionId) {
-  const file = statusFileFor(sessionId);
-  if (file === undefined) return undefined;
-  try {
-    const parsed = JSON.parse(readFileSync(file, "utf8"));
-    return parsed && typeof parsed === "object" ? parsed : undefined;
-  } catch {
-    return undefined;
-  }
-}
-
-/**
- * Merge one patch into the session status and replace the file atomically.
- * Returns false when the session id is unsafe or the write failed; status
- * writes must never break a compaction.
- */
-export function writeStatus(sessionId, patch) {
-  const file = statusFileFor(sessionId);
-  if (file === undefined || patch === undefined || patch === null) return false;
-  try {
-    mkdirSync(STATUS_DIR, { recursive: true });
-    const previous = readStatus(sessionId) ?? {};
-    const next = { ...previous, ...patch, sessionId, updatedAt: Date.now() };
-    const temp = `${file}.${process.pid}.${Math.random().toString(36).slice(2)}.tmp`;
-    writeFileSync(temp, JSON.stringify(next), "utf8");
-    renameSync(temp, file);
-    return true;
-  } catch {
-    return false;
-  }
-}

package/lib/summary.js

@@ -1,147 +0,0 @@
-/**
- * Pure completeness checks for the generated handoff document.
- *
- * The local models used with DSH sometimes stop early and append a literal
- * "（截断）" marker (or stop right after a heading) instead of failing the
- * request. These helpers let the engine treat such output as incomplete,
- * continue it, or rewrite it before the checkpoint is committed.
- */
-
-const FENCE = /^\s*(```|~~~)/;
-const HEADING = /^\s*(#{2,3})\s+(.+?)\s*$/;
-
-function normalizeHeading(text) {
-  return String(text ?? "")
-    .replace(/^#{2,3}\s*/, "")
-    .replace(/^\s*\d+[.、)]\s*/, "")
-    .replace(/[*_`]/g, "")
-    .replace(/[\s：:]+$/g, "")
-    .trim();
-}
-
-function headingsIn(text) {
-  const out = [];
-  let fenced = false;
-  for (const line of String(text ?? "").split(/\r?\n/)) {
-    if (FENCE.test(line)) {
-      fenced = !fenced;
-      continue;
-    }
-    if (fenced) continue;
-    const match = HEADING.exec(line);
-    if (match === null) continue;
-    const heading = normalizeHeading(match[2]);
-    if (heading.length > 0 && !out.includes(heading)) out.push(heading);
-  }
-  return out;
-}
-
-/** Section headings the template asks the model to produce. */
-export function expectedSections(templateText) {
-  return headingsIn(templateText);
-}
-
-/** Section headings actually present in a generated summary. */
-export function summarySections(summaryText) {
-  return headingsIn(summaryText);
-}
-
-/** Whether the text ends with a model-generated truncation marker. */
-export function looksTruncated(text) {
-  const tail = String(text ?? "").trimEnd();
-  if (tail.length === 0) return false;
-  if (/[（(]\s*截断\s*[)）]\s*$/.test(tail)) return true;
-  if (/[\[【]\s*截断\s*[\]】]\s*$/.test(tail)) return true;
-  const last = tail.slice(-48);
-  return /(?:输出|回答|摘要|文档|内容|响应)\s*(?:已|被)?\s*截断\s*$/.test(last);
-}
-
-/** Remove literal truncation markers the model wrote about its own output. */
-export function stripTruncationMarkers(text) {
-  return String(text ?? "")
-    .replace(/[…\.]{0,3}\s*[（(]\s*截断\s*[)）]/g, "")
-    .replace(/[…\.]{0,3}\s*[\[【]\s*截断\s*[\]】]/g, "")
-    .trimEnd();
-}
-
-/**
- * Validate one generated handoff document against the template sections.
- * `ok` is false when a section is missing, the text ends on a bare heading,
- * or the model marked its own output as truncated.
- */
-export function validateSummary(text, expected = []) {
-  const headings = headingsIn(text);
-  const missing = expected.filter(
-    (section) => !headings.some((heading) => heading.includes(section) || section.includes(heading)),
-  );
-  const truncated = looksTruncated(text);
-  const endsWithHeading = /(?:^|\n)\s*#{2,3}\s+[^\n]*\s*$/.test(String(text ?? "").trimEnd());
-  const reasons = [];
-  if (missing.length > 0) reasons.push(`missing sections: ${missing.join(", ")}`);
-  if (truncated) reasons.push("truncation marker");
-  if (endsWithHeading) reasons.push("ends on a heading");
-  return {
-    ok: missing.length === 0 && !truncated && !endsWithHeading,
-    missing,
-    truncated,
-    endsWithHeading,
-    reason: reasons.join("; "),
-  };
-}
-
-function lastHeading(text) {
-  const headings = headingsIn(text);
-  return headings.length === 0 ? undefined : headings[headings.length - 1];
-}
-
-function startsWithHeading(text) {
-  const first = String(text ?? "").trimStart().split(/\r?\n/, 1)[0] ?? "";
-  const match = HEADING.exec(first);
-  return match === null ? undefined : normalizeHeading(match[2]);
-}
-
-/** Join a partial summary and a continuation without duplicating its heading. */
-export function mergeSummary(partial, tail) {
-  const head = String(partial ?? "").trimEnd();
-  const rest = String(tail ?? "").trim();
-  if (head.length === 0) return rest;
-  if (rest.length === 0) return head;
-  const repeated = lastHeading(head);
-  const first = startsWithHeading(rest);
-  if (repeated !== undefined && first !== undefined && repeated === first) {
-    const newline = rest.indexOf("\n");
-    const body = newline === -1 ? "" : rest.slice(newline + 1).trim();
-    return body.length === 0 ? head : `${head}\n${body}`;
-  }
-  if (first !== undefined) return `${head}\n\n${rest}`;
-  const safeBreak = /[。！？.!?；;：:)\]）】]$/.test(head);
-  return safeBreak ? `${head}\n\n${rest}` : `${head}${rest}`;
-}
-
-/** User turn appended after the partial assistant document. */
-export function continuationInstruction(validation) {
-  const missing = validation?.missing ?? [];
-  const lines = [
-    "你刚才写到一半中断了。请从断点继续这份交接文档：",
-    "- 先补完断点处的句子，不要重复已经写过的内容或标题；",
-  ];
-  if (missing.length > 0) {
-    lines.push(`- 然后按模板顺序补完这些缺失小节：${missing.join("、")}；`);
-  } else {
-    lines.push("- 并完成文档剩余部分；");
-  }
-  lines.push("- 只输出 Markdown 正文，不要解释，不要写「（截断）」。");
-  return lines.join("\n");
-}
-
-/** User turn appended when a continuation still does not pass validation. */
-export function rewriteInstruction(validation, maxTokens) {
-  const missing = validation?.missing ?? [];
-  const why = missing.length > 0 ? `缺少这些小节：${missing.join("、")}` : "输出在末尾被截断";
-  return [
-    `上一次的交接文档不完整（${why}）。`,
-    "请重新完整输出整份交接文档，必须包含模板要求的全部小节；",
-    `不要因为长度自行截断，不要写「（截断）」；本任务允许输出到 ${String(maxTokens)} tokens。`,
-    "只输出 Markdown 正文。",
-  ].join("\n");
-}