compressed-context 0.1.0 → 0.2.0

package/src/compression/validate.ts

@@ -1,81 +1,81 @@
-import { isBabelSummary, isMarkdownSummary, type Summary } from "./schema.ts"
-import { summaryChars } from "./summary.ts"
-
-export const MIN_SUMMARY_CHARS = 200
-export const MIN_MERGE_SUMMARY_CHARS = 80
-export const MIN_ULTRA_SUMMARY_CHARS = 40
-export const MAX_SUMMARY_CHARS = 20_000
-
-/** 输入：层级；输出：该层允许的最短摘要字符数。 */
-export function minSummaryChars(tier: 1 | 2 | 3): number {
-  if (tier === 3) return MIN_ULTRA_SUMMARY_CHARS
-  if (tier === 2) return MIN_MERGE_SUMMARY_CHARS
-  return MIN_SUMMARY_CHARS
-}
-/** 可压缩原文的最小字符数，低于它不生成块。 */
-export const MIN_SOURCE_CHARS = 5_000
-
-export interface ValidationResult {
-  readonly ok: boolean
-  readonly fields: readonly string[]
-  readonly message: string
-}
-
-/**
- * 输入：结构化摘要或 Markdown 摘要 + 原文总字符数。
- * 输出：校验结果。
- * 预期：JSON 检查字段；Markdown 检查标题/正文/长度，且摘要必须比原文小。
- */
-export function validateSummary(
-  summary: Summary,
-  sourceChars: number,
-  minChars: number = MIN_SUMMARY_CHARS,
-  maxChars: number = MAX_SUMMARY_CHARS,
-): ValidationResult {
-  const fields: string[] = []
-  if (isBabelSummary(summary)) {
-    if (summary.title.trim().length === 0 || summary.title.length > 80) fields.push("title")
-    if (summary.goal.trim().length === 0) fields.push("goal")
-    const body = summary.text.split(/\r?\n/).slice(1).join("\n").trim()
-    if (body.length === 0) fields.push("text")
-  } else if (isMarkdownSummary(summary)) {
-    if (summary.title.trim().length === 0 || summary.title.length > 80) fields.push("title")
-    if (summary.text.trim().length === 0) fields.push("text")
-  } else {
-    if (summary.goal.trim().length === 0) fields.push("goal")
-    if (summary.title.trim().length === 0 || summary.title.length > 80) fields.push("title")
-    if (summary.constraints.some((item) => item.trim().length === 0)) fields.push("constraints")
-    if (summary.decisions.some((item) => item.trim().length === 0)) fields.push("decisions")
-    if (summary.open_items.some((item) => item.trim().length === 0)) fields.push("open_items")
-    if (summary.files.some((item) => item.trim().length === 0)) fields.push("files")
-    if (summary.facts.some((item) => item.trim().length === 0)) fields.push("facts")
-  }
-
-  if (fields.length > 0) {
-    return { ok: false, fields, message: `empty field: ${fields.join(", ")}` }
-  }
-
-  const chars = summaryChars(summary)
-  if (chars < minChars) {
-    return {
-      ok: false,
-      fields: ["summary"],
-      message: `summary too short (${chars.toString()} chars, min ${minChars.toString()})`,
-    }
-  }
-  if (chars > maxChars) {
-    return {
-      ok: false,
-      fields: ["summary"],
-      message: `summary too long (${chars.toString()} chars, max ${maxChars.toString()})`,
-    }
-  }
-  if (sourceChars > 0 && chars >= sourceChars) {
-    return {
-      ok: false,
-      fields: ["summary"],
-      message: `summary (${chars.toString()} chars) is not smaller than the source (${sourceChars.toString()} chars)`,
-    }
-  }
-  return { ok: true, fields: [], message: "ok" }
-}
+import { isBabelSummary, isMarkdownSummary, type Summary } from "./schema.ts"
+import { summaryChars } from "./summary.ts"
+
+export const MIN_SUMMARY_CHARS = 200
+export const MIN_MERGE_SUMMARY_CHARS = 80
+export const MIN_ULTRA_SUMMARY_CHARS = 40
+export const MAX_SUMMARY_CHARS = 20_000
+
+/** 输入：层级；输出：该层允许的最短摘要字符数。 */
+export function minSummaryChars(tier: 1 | 2 | 3): number {
+  if (tier === 3) return MIN_ULTRA_SUMMARY_CHARS
+  if (tier === 2) return MIN_MERGE_SUMMARY_CHARS
+  return MIN_SUMMARY_CHARS
+}
+/** 可压缩原文的最小字符数，低于它不生成块。 */
+export const MIN_SOURCE_CHARS = 5_000
+
+export interface ValidationResult {
+  readonly ok: boolean
+  readonly fields: readonly string[]
+  readonly message: string
+}
+
+/**
+ * 输入：结构化摘要或 Markdown 摘要 + 原文总字符数。
+ * 输出：校验结果。
+ * 预期：JSON 检查字段；Markdown 检查标题/正文/长度，且摘要必须比原文小。
+ */
+export function validateSummary(
+  summary: Summary,
+  sourceChars: number,
+  minChars: number = MIN_SUMMARY_CHARS,
+  maxChars: number = MAX_SUMMARY_CHARS,
+): ValidationResult {
+  const fields: string[] = []
+  if (isBabelSummary(summary)) {
+    if (summary.title.trim().length === 0 || summary.title.length > 80) fields.push("title")
+    if (summary.goal.trim().length === 0) fields.push("goal")
+    const body = summary.text.split(/\r?\n/).slice(1).join("\n").trim()
+    if (body.length === 0) fields.push("text")
+  } else if (isMarkdownSummary(summary)) {
+    if (summary.title.trim().length === 0 || summary.title.length > 80) fields.push("title")
+    if (summary.text.trim().length === 0) fields.push("text")
+  } else {
+    if (summary.goal.trim().length === 0) fields.push("goal")
+    if (summary.title.trim().length === 0 || summary.title.length > 80) fields.push("title")
+    if (summary.constraints.some((item) => item.trim().length === 0)) fields.push("constraints")
+    if (summary.decisions.some((item) => item.trim().length === 0)) fields.push("decisions")
+    if (summary.open_items.some((item) => item.trim().length === 0)) fields.push("open_items")
+    if (summary.files.some((item) => item.trim().length === 0)) fields.push("files")
+    if (summary.facts.some((item) => item.trim().length === 0)) fields.push("facts")
+  }
+
+  if (fields.length > 0) {
+    return { ok: false, fields, message: `empty field: ${fields.join(", ")}` }
+  }
+
+  const chars = summaryChars(summary)
+  if (chars < minChars) {
+    return {
+      ok: false,
+      fields: ["summary"],
+      message: `summary too short (${chars.toString()} chars, min ${minChars.toString()})`,
+    }
+  }
+  if (chars > maxChars) {
+    return {
+      ok: false,
+      fields: ["summary"],
+      message: `summary too long (${chars.toString()} chars, max ${maxChars.toString()})`,
+    }
+  }
+  if (sourceChars > 0 && chars >= sourceChars) {
+    return {
+      ok: false,
+      fields: ["summary"],
+      message: `summary (${chars.toString()} chars) is not smaller than the source (${sourceChars.toString()} chars)`,
+    }
+  }
+  return { ok: true, fields: [], message: "ok" }
+}

package/src/i18n/en.ts

@@ -1,93 +1,93 @@
-import type { Messages } from "./types.ts"
-
-/** English copy. Labels stay short so they fit the narrow sidebar. */
-export const en: Messages = {
-  title: "Context breakdown",
-  labels: {
-    system: "System",
-    tools: "Tool defs",
-    tool: "Tool I/O",
-    text: "Text",
-    recent: "Kept",
-    summaries: "Summary",
-    media: "Media",
-  },
-  approximate: "≈",
-  terminal: "Context cannot be compressed further; start a new session or use native compaction",
-  cacheTitle: "Cache",
-  cacheChart: "Chart",
-  cacheLog: "Log",
-  cacheInput: "In",
-  cacheOutput: "Out",
-  cacheCached: "Cached",
-  cacheHit: "Hit",
-  summariesTitle: "Summaries",
-  noData: "—",
-  command: {
-    title: "Compressed context settings",
-    description: "Open plugin settings",
-    group: "Plugins",
-  },
-  settings: {
-    title: "Compressed context plugin settings",
-    show: "Show panel",
-    limit: "Context limit",
-    limitAuto: "Model native",
-    limitCustom: "Custom limit…",
-    limitHint: "Upper bound; the effective window is the smaller of this value and the model's native window. Digits or a k/m suffix",
-    limitInvalid: "Enter a valid token count",
-    limitPlaceholder: "200k",
-    limitPreview: (value) => `= ${value} tokens`,
-    limitCapped: (requested, actual) => `${requested} (model max ${actual})`,
-    threshold: "Compression threshold",
-    thresholdHint: "Enter an integer between 60 and 95 (percent)",
-    thresholdInvalid: "Threshold must be between 60 and 95",
-    thresholdPreview: (value) => `= ${value}%`,
-    nudgeGrowth: "Compression reminder",
-    nudgeGrowthHint: "Remind the model after this much context growth; 0 disables it",
-    nudgeGrowthInvalid: "Enter 0, or 1k to 200k",
-    summaryBlockPercent: "Summary block limit",
-    summaryBlockPercentHint: "Max share of the window for one summary; enter 10% or 20k",
-    summaryTotalPercent: "Total summary limit",
-    summaryTotalPercentHint: "Max share of the window for all summaries; enter 50% or 100k",
-    summaryPercentInvalid: "Enter 1% to 90%, or a token count that fits the window",
-    windowKnown: (value) => `Current window: ${value}`,
-    windowUnknown: "Current window unknown (run one model request first)",
-    summaryLanguage: "Summary language",
-    summaryFormat: "Summary format",
-    summaryFormatJson: "JSON (structured)",
-    summaryFormatMarkdown: "Markdown (natural language)",
-    summaryFormatBabel: "Babel (model-to-model dense)",
-    autoCompress: "Auto compression",
-    enableCompressTool: "compress tool",
-    enableDecompressTool: "decompress tool",
-    showTimeline: "Block timeline",
-    showBlockTokens: "Block token estimate",
-    showCacheChart: "Show cache chart",
-    showCacheLog: "Show cache log",
-    showSummaries: "Show summary blocks",
-    categories: {
-      compress: "Compression",
-      summary: "Summary",
-      panel: "Panel",
-      decompress: "Decompression",
-      interface: "Interface",
-    },
-    decompressInlineMax: "Decompress inline limit",
-    decompressInlineMaxHint: "Above this many characters the content goes to a temp file; digits or a k/m suffix",
-    decompressInlineMaxInvalid: "Enter a character limit between 1k and 1m",
-    decompressTempCap: "Decompress temp file cap",
-    decompressTempCapHint: "Maximum number of decompress temp files to keep",
-    decompressTempCapInvalid: "Enter an integer between 1 and 1000",
-    decompressShowTokens: "Decompress token estimate",
-    submit: "Submit",
-    language: "Language",
-    auto: "Auto",
-    on: "On",
-    off: "Off",
-  },
-  languages: {
-    zh: "中文",
-    en: "English",
-  },
-}
+import type { Messages } from "./types.ts"
+
+/** English copy. Labels stay short so they fit the narrow sidebar. */
+export const en: Messages = {
+  title: "Context breakdown",
+  labels: {
+    system: "System",
+    tools: "Tool defs",
+    tool: "Tool I/O",
+    text: "Text",
+    recent: "Kept",
+    summaries: "Summary",
+    media: "Media",
+  },
+  approximate: "≈",
+  terminal: "Context cannot be compressed further; start a new session or use native compaction",
+  cacheTitle: "Cache",
+  cacheChart: "Chart",
+  cacheLog: "Log",
+  cacheInput: "In",
+  cacheOutput: "Out",
+  cacheCached: "Cached",
+  cacheHit: "Hit",
+  summariesTitle: "Summaries",
+  noData: "—",
+  command: {
+    title: "Compressed context settings",
+    description: "Open plugin settings",
+    group: "Plugins",
+  },
+  settings: {
+    title: "Compressed context plugin settings",
+    show: "Show panel",
+    limit: "Context limit",
+    limitAuto: "Model native",
+    limitCustom: "Custom limit…",
+    limitHint: "Upper bound; the effective window is the smaller of this value and the model's native window. Digits or a k/m suffix",
+    limitInvalid: "Enter a valid token count",
+    limitPlaceholder: "200k",
+    limitPreview: (value) => `= ${value} tokens`,
+    limitCapped: (requested, actual) => `${requested} (model max ${actual})`,
+    threshold: "Compression threshold",
+    thresholdHint: "Enter an integer between 60 and 95 (percent)",
+    thresholdInvalid: "Threshold must be between 60 and 95",
+    thresholdPreview: (value) => `= ${value}%`,
+    nudgeGrowth: "Compression reminder",
+    nudgeGrowthHint: "Remind the model after this much context growth; 0 disables it",
+    nudgeGrowthInvalid: "Enter 0, or 1k to 200k",
+    summaryBlockPercent: "Summary block limit",
+    summaryBlockPercentHint: "Max share of the window for one summary; enter 10% or 20k",
+    summaryTotalPercent: "Total summary limit",
+    summaryTotalPercentHint: "Max share of the window for all summaries; enter 50% or 100k",
+    summaryPercentInvalid: "Enter 1% to 90%, or a token count that fits the window",
+    windowKnown: (value) => `Current window: ${value}`,
+    windowUnknown: "Current window unknown (run one model request first)",
+    summaryLanguage: "Summary language",
+    summaryFormat: "Summary format",
+    summaryFormatJson: "JSON",
+    summaryFormatMarkdown: "Markdown",
+    summaryFormatBabel: "Babel",
+    autoCompress: "Auto compression",
+    enableCompressTool: "compress tool",
+    enableDecompressTool: "decompress tool",
+    showTimeline: "Block timeline",
+    showBlockTokens: "Block token estimate",
+    showCacheChart: "Show cache chart",
+    showCacheLog: "Show cache log",
+    showSummaries: "Show summary blocks",
+    categories: {
+      compress: "Compression",
+      summary: "Summary",
+      panel: "Panel",
+      decompress: "Decompression",
+      interface: "Interface",
+    },
+    decompressInlineMax: "Decompress inline limit",
+    decompressInlineMaxHint: "Above this many characters the content goes to a temp file; digits or a k/m suffix",
+    decompressInlineMaxInvalid: "Enter a character limit between 1k and 1m",
+    decompressTempCap: "Decompress temp file cap",
+    decompressTempCapHint: "Maximum number of decompress temp files to keep",
+    decompressTempCapInvalid: "Enter an integer between 1 and 1000",
+    decompressShowTokens: "Decompress token estimate",
+    submit: "Submit",
+    language: "Language",
+    auto: "Auto",
+    on: "On",
+    off: "Off",
+  },
+  languages: {
+    zh: "中文",
+    en: "English",
+  },
+}

package/src/i18n/index.ts

@@ -1,28 +1,28 @@
-import { en } from "./en.ts"
-import type { Messages } from "./types.ts"
-import { zh } from "./zh.ts"
-
-export type { Messages }
-
-/**
- * 输入：locale 字符串（可为空）。
- * 输出：对应语言的消息表。
- * 预期：`zh*` 用中文，其余一律英文；空值回退到系统 locale。
- */
-export function resolveMessages(locale: string | undefined): Messages {
-  const value = (locale ?? detectLocale()).toLowerCase()
-  return value.startsWith("zh") ? zh : en
-}
-
-/**
- * 输入：无。
- * 输出：系统 locale。
- * 预期：运行时拿不到时回退 `en`，保证始终有文案。
- */
-export function detectLocale(): string {
-  try {
-    return Intl.DateTimeFormat().resolvedOptions().locale
-  } catch {
-    return "en"
-  }
-}
+import { en } from "./en.ts"
+import type { Messages } from "./types.ts"
+import { zh } from "./zh.ts"
+
+export type { Messages }
+
+/**
+ * 输入：locale 字符串（可为空）。
+ * 输出：对应语言的消息表。
+ * 预期：`zh*` 用中文，其余一律英文；空值回退到系统 locale。
+ */
+export function resolveMessages(locale: string | undefined): Messages {
+  const value = (locale ?? detectLocale()).toLowerCase()
+  return value.startsWith("zh") ? zh : en
+}
+
+/**
+ * 输入：无。
+ * 输出：系统 locale。
+ * 预期：运行时拿不到时回退 `en`，保证始终有文案。
+ */
+export function detectLocale(): string {
+  try {
+    return Intl.DateTimeFormat().resolvedOptions().locale
+  } catch {
+    return "en"
+  }
+}

package/src/i18n/types.ts

@@ -1,89 +1,89 @@
-import type { CategoryKey } from "../shared/stats.ts"
-
-/**
- * 面板文案。
- *
- * 源码里只引用键名，所有用户可见文字都来自语言文件。
- */
-export interface Messages {
-  readonly title: string
-  readonly labels: Readonly<Record<CategoryKey, string>>
-  readonly approximate: string
-  readonly terminal: string
-  readonly cacheTitle: string
-  readonly cacheChart: string
-  readonly cacheLog: string
-  readonly cacheInput: string
-  readonly cacheOutput: string
-  readonly cacheCached: string
-  readonly cacheHit: string
-  readonly summariesTitle: string
-  readonly noData: string
-  readonly command: {
-    readonly title: string
-    readonly description: string
-    readonly group: string
-  }
-  readonly settings: {
-    readonly title: string
-    readonly show: string
-    readonly limit: string
-    readonly limitAuto: string
-    readonly limitCustom: string
-    readonly limitHint: string
-    readonly limitInvalid: string
-    readonly limitPlaceholder: string
-    readonly limitPreview: (value: string) => string
-    readonly limitCapped: (requested: string, actual: string) => string
-    readonly threshold: string
-    readonly thresholdHint: string
-    readonly thresholdInvalid: string
-    readonly thresholdPreview: (value: string) => string
-    readonly nudgeGrowth: string
-    readonly nudgeGrowthHint: string
-    readonly nudgeGrowthInvalid: string
-    readonly summaryBlockPercent: string
-    readonly summaryBlockPercentHint: string
-    readonly summaryTotalPercent: string
-    readonly summaryTotalPercentHint: string
-    readonly summaryPercentInvalid: string
-    readonly windowKnown: (value: string) => string
-    readonly windowUnknown: string
-    readonly summaryLanguage: string
-    readonly summaryFormat: string
-    readonly summaryFormatJson: string
-    readonly summaryFormatMarkdown: string
-    readonly summaryFormatBabel: string
-    readonly autoCompress: string
-    readonly enableCompressTool: string
-    readonly enableDecompressTool: string
-    readonly showTimeline: string
-    readonly showBlockTokens: string
-    readonly showCacheChart: string
-    readonly showCacheLog: string
-    readonly showSummaries: string
-    readonly categories: {
-      readonly compress: string
-      readonly summary: string
-      readonly panel: string
-      readonly decompress: string
-      readonly interface: string
-    }
-    readonly decompressInlineMax: string
-    readonly decompressInlineMaxHint: string
-    readonly decompressInlineMaxInvalid: string
-    readonly decompressTempCap: string
-    readonly decompressTempCapHint: string
-    readonly decompressTempCapInvalid: string
-    readonly decompressShowTokens: string
-    readonly submit: string
-    readonly language: string
-    readonly auto: string
-    readonly on: string
-    readonly off: string
-  }
-  readonly languages: {
-    readonly zh: string
-    readonly en: string
-  }
-}
+import type { CategoryKey } from "../shared/stats.ts"
+
+/**
+ * 面板文案。
+ *
+ * 源码里只引用键名，所有用户可见文字都来自语言文件。
+ */
+export interface Messages {
+  readonly title: string
+  readonly labels: Readonly<Record<CategoryKey, string>>
+  readonly approximate: string
+  readonly terminal: string
+  readonly cacheTitle: string
+  readonly cacheChart: string
+  readonly cacheLog: string
+  readonly cacheInput: string
+  readonly cacheOutput: string
+  readonly cacheCached: string
+  readonly cacheHit: string
+  readonly summariesTitle: string
+  readonly noData: string
+  readonly command: {
+    readonly title: string
+    readonly description: string
+    readonly group: string
+  }
+  readonly settings: {
+    readonly title: string
+    readonly show: string
+    readonly limit: string
+    readonly limitAuto: string
+    readonly limitCustom: string
+    readonly limitHint: string
+    readonly limitInvalid: string
+    readonly limitPlaceholder: string
+    readonly limitPreview: (value: string) => string
+    readonly limitCapped: (requested: string, actual: string) => string
+    readonly threshold: string
+    readonly thresholdHint: string
+    readonly thresholdInvalid: string
+    readonly thresholdPreview: (value: string) => string
+    readonly nudgeGrowth: string
+    readonly nudgeGrowthHint: string
+    readonly nudgeGrowthInvalid: string
+    readonly summaryBlockPercent: string
+    readonly summaryBlockPercentHint: string
+    readonly summaryTotalPercent: string
+    readonly summaryTotalPercentHint: string
+    readonly summaryPercentInvalid: string
+    readonly windowKnown: (value: string) => string
+    readonly windowUnknown: string
+    readonly summaryLanguage: string
+    readonly summaryFormat: string
+    readonly summaryFormatJson: string
+    readonly summaryFormatMarkdown: string
+    readonly summaryFormatBabel: string
+    readonly autoCompress: string
+    readonly enableCompressTool: string
+    readonly enableDecompressTool: string
+    readonly showTimeline: string
+    readonly showBlockTokens: string
+    readonly showCacheChart: string
+    readonly showCacheLog: string
+    readonly showSummaries: string
+    readonly categories: {
+      readonly compress: string
+      readonly summary: string
+      readonly panel: string
+      readonly decompress: string
+      readonly interface: string
+    }
+    readonly decompressInlineMax: string
+    readonly decompressInlineMaxHint: string
+    readonly decompressInlineMaxInvalid: string
+    readonly decompressTempCap: string
+    readonly decompressTempCapHint: string
+    readonly decompressTempCapInvalid: string
+    readonly decompressShowTokens: string
+    readonly submit: string
+    readonly language: string
+    readonly auto: string
+    readonly on: string
+    readonly off: string
+  }
+  readonly languages: {
+    readonly zh: string
+    readonly en: string
+  }
+}