compressed-context 0.1.0 → 0.2.0

package/src/shared/rpc.ts

@@ -1,145 +1,145 @@
-import { Rpc } from "@opencode/plugin/rpc"
-
-import type { SummaryBlock } from "./blocks.ts"
-import type { CacheSample } from "./cache.ts"
-import type { CompressionSettings } from "./settings.ts"
-
-const SettingsGetInputJson = {
-  type: "object",
-  properties: { sessionID: { type: "string" } },
-  additionalProperties: false,
-} as const
-
-const SettingsProperties = {
-  contextLimit: {
-    anyOf: [{ type: "string", enum: ["auto"] }, { type: "number" }],
-  },
-  triggerPercent: { type: "number" },
-  nudgeGrowthTokens: { type: "number" },
-  summaryBlockPercent: { type: "number" },
-  summaryTotalPercent: { type: "number" },
-  summaryLanguage: { type: "string", enum: ["auto", "zh", "en"] },
-  summaryFormat: { type: "string", enum: ["json", "markdown", "babel"] },
-  autoCompress: { type: "boolean" },
-  enableCompressTool: { type: "boolean" },
-  enableDecompressTool: { type: "boolean" },
-  showTimeline: { type: "boolean" },
-  showBlockTokens: { type: "boolean" },
-  decompressInlineMax: { type: "number" },
-  decompressTempCap: { type: "number" },
-  decompressShowTokens: { type: "boolean" },
-} as const
-
-const SettingsInputJson = {
-  type: "object",
-  properties: SettingsProperties,
-  required: ["contextLimit", "triggerPercent"],
-  additionalProperties: false,
-} as const
-
-/** 读取结果比写入多一个 resolvedWindow：auto 时从模型原生窗口解析出来的值。 */
-const SettingsOutputJson = {
-  type: "object",
-  properties: {
-    ...SettingsProperties,
-    resolvedWindow: { type: "number" },
-  },
-  required: ["contextLimit", "triggerPercent"],
-  additionalProperties: false,
-} as const
-
-const OkJson = {
-  type: "object",
-  properties: { ok: { type: "boolean" } },
-  required: ["ok"],
-  additionalProperties: false,
-} as const
-
-/** 需要明确指定会话的只读查询。 */
-const SessionInputJson = {
-  type: "object",
-  properties: { sessionID: { type: "string" } },
-  required: ["sessionID"],
-  additionalProperties: false,
-} as const
-
-/** 摘要块：服务端返回 active 链，body 是渲染好的 markdown。 */
-const BlockJson = {
-  type: "object",
-  properties: {
-    id: { type: "string" },
-    tier: { type: "number", enum: [1, 2, 3] },
-    format: { type: "string", enum: ["json", "markdown", "babel"] },
-    title: { type: "string" },
-    at: { type: "number" },
-    tokensBefore: { type: "number" },
-    tokensAfter: { type: "number" },
-    sourceBlockIds: { type: "array", items: { type: "string" } },
-    body: { type: "string" },
-  },
-  required: ["id", "tier", "format", "title", "at", "tokensBefore", "tokensAfter", "body"],
-  additionalProperties: false,
-} as const
-
-const BlocksOutputJson = {
-  type: "object",
-  properties: { blocks: { type: "array", items: BlockJson } },
-  required: ["blocks"],
-  additionalProperties: false,
-} as const
-
-/** 一条缓存命中样本。 */
-const CacheSampleJson = {
-  type: "object",
-  properties: {
-    messageID: { type: "string" },
-    at: { type: "number" },
-    input: { type: "number" },
-    output: { type: "number" },
-    cached: { type: "number" },
-    hitRate: { type: "number" },
-  },
-  required: ["messageID", "at", "input", "output", "cached", "hitRate"],
-  additionalProperties: false,
-} as const
-
-const CacheHistoryOutputJson = {
-  type: "object",
-  properties: { samples: { type: "array", items: CacheSampleJson } },
-  required: ["samples"],
-  additionalProperties: false,
-} as const
-
-/** TUI 与服务端共用的设置 / 面板 RPC。 */
-export const ContextRpc: Rpc.PortableDefinition = Rpc.define({
-  id: "compressed-context",
-  methods: {
-    settingsGet: { input: SettingsGetInputJson, output: SettingsOutputJson },
-    settingsSet: { input: SettingsInputJson, output: OkJson },
-    blocksGet: { input: SessionInputJson, output: BlocksOutputJson },
-    cacheHistoryGet: { input: SessionInputJson, output: CacheHistoryOutputJson },
-  },
-  events: {},
-})
-
-/** 服务端设置读取结果。 */
-export interface ContextSettingsResult extends CompressionSettings {
-  readonly resolvedWindow?: number
-}
-
-/** TUI 侧对 ContextRpc 的类型化视图。 */
-export interface ContextRpcClient {
-  settingsGet(input: { readonly sessionID?: string }): Promise<ContextSettingsResult>
-  settingsSet(input: CompressionSettings): Promise<{ readonly ok: boolean }>
-  blocksGet(input: { readonly sessionID: string }): Promise<{ readonly blocks: readonly SummaryBlock[] }>
-  cacheHistoryGet(input: {
-    readonly sessionID: string
-  }): Promise<{ readonly samples: readonly CacheSample[] }>
-}
-
-/** 输入：带 rpc 方法的 TUI client；输出：类型化 RPC 客户端。 */
-export function contextRpc(client: {
-  rpc(definition: Rpc.PortableDefinition): unknown
-}): ContextRpcClient {
-  return client.rpc(ContextRpc) as ContextRpcClient
-}
+import { Rpc } from "@opencode/plugin/rpc"
+
+import type { SummaryBlock } from "./blocks.ts"
+import type { CacheSample } from "./cache.ts"
+import type { CompressionSettings } from "./settings.ts"
+
+const SettingsGetInputJson = {
+  type: "object",
+  properties: { sessionID: { type: "string" } },
+  additionalProperties: false,
+} as const
+
+const SettingsProperties = {
+  contextLimit: {
+    anyOf: [{ type: "string", enum: ["auto"] }, { type: "number" }],
+  },
+  triggerPercent: { type: "number" },
+  nudgeGrowthTokens: { type: "number" },
+  summaryBlockPercent: { type: "number" },
+  summaryTotalPercent: { type: "number" },
+  summaryLanguage: { type: "string", enum: ["auto", "zh", "en"] },
+  summaryFormat: { type: "string", enum: ["json", "markdown", "babel"] },
+  autoCompress: { type: "boolean" },
+  enableCompressTool: { type: "boolean" },
+  enableDecompressTool: { type: "boolean" },
+  showTimeline: { type: "boolean" },
+  showBlockTokens: { type: "boolean" },
+  decompressInlineMax: { type: "number" },
+  decompressTempCap: { type: "number" },
+  decompressShowTokens: { type: "boolean" },
+} as const
+
+const SettingsInputJson = {
+  type: "object",
+  properties: SettingsProperties,
+  required: ["contextLimit", "triggerPercent"],
+  additionalProperties: false,
+} as const
+
+/** 读取结果比写入多一个 resolvedWindow：auto 时从模型原生窗口解析出来的值。 */
+const SettingsOutputJson = {
+  type: "object",
+  properties: {
+    ...SettingsProperties,
+    resolvedWindow: { type: "number" },
+  },
+  required: ["contextLimit", "triggerPercent"],
+  additionalProperties: false,
+} as const
+
+const OkJson = {
+  type: "object",
+  properties: { ok: { type: "boolean" } },
+  required: ["ok"],
+  additionalProperties: false,
+} as const
+
+/** 需要明确指定会话的只读查询。 */
+const SessionInputJson = {
+  type: "object",
+  properties: { sessionID: { type: "string" } },
+  required: ["sessionID"],
+  additionalProperties: false,
+} as const
+
+/** 摘要块：服务端返回 active 链，body 是渲染好的 markdown。 */
+const BlockJson = {
+  type: "object",
+  properties: {
+    id: { type: "string" },
+    tier: { type: "number", enum: [1, 2, 3] },
+    format: { type: "string", enum: ["json", "markdown", "babel"] },
+    title: { type: "string" },
+    at: { type: "number" },
+    tokensBefore: { type: "number" },
+    tokensAfter: { type: "number" },
+    sourceBlockIds: { type: "array", items: { type: "string" } },
+    body: { type: "string" },
+  },
+  required: ["id", "tier", "format", "title", "at", "tokensBefore", "tokensAfter", "body"],
+  additionalProperties: false,
+} as const
+
+const BlocksOutputJson = {
+  type: "object",
+  properties: { blocks: { type: "array", items: BlockJson } },
+  required: ["blocks"],
+  additionalProperties: false,
+} as const
+
+/** 一条缓存命中样本。 */
+const CacheSampleJson = {
+  type: "object",
+  properties: {
+    messageID: { type: "string" },
+    at: { type: "number" },
+    input: { type: "number" },
+    output: { type: "number" },
+    cached: { type: "number" },
+    hitRate: { type: "number" },
+  },
+  required: ["messageID", "at", "input", "output", "cached", "hitRate"],
+  additionalProperties: false,
+} as const
+
+const CacheHistoryOutputJson = {
+  type: "object",
+  properties: { samples: { type: "array", items: CacheSampleJson } },
+  required: ["samples"],
+  additionalProperties: false,
+} as const
+
+/** TUI 与服务端共用的设置 / 面板 RPC。 */
+export const ContextRpc: Rpc.PortableDefinition = Rpc.define({
+  id: "compressed-context",
+  methods: {
+    settingsGet: { input: SettingsGetInputJson, output: SettingsOutputJson },
+    settingsSet: { input: SettingsInputJson, output: OkJson },
+    blocksGet: { input: SessionInputJson, output: BlocksOutputJson },
+    cacheHistoryGet: { input: SessionInputJson, output: CacheHistoryOutputJson },
+  },
+  events: {},
+})
+
+/** 服务端设置读取结果。 */
+export interface ContextSettingsResult extends CompressionSettings {
+  readonly resolvedWindow?: number
+}
+
+/** TUI 侧对 ContextRpc 的类型化视图。 */
+export interface ContextRpcClient {
+  settingsGet(input: { readonly sessionID?: string }): Promise<ContextSettingsResult>
+  settingsSet(input: CompressionSettings): Promise<{ readonly ok: boolean }>
+  blocksGet(input: { readonly sessionID: string }): Promise<{ readonly blocks: readonly SummaryBlock[] }>
+  cacheHistoryGet(input: {
+    readonly sessionID: string
+  }): Promise<{ readonly samples: readonly CacheSample[] }>
+}
+
+/** 输入：带 rpc 方法的 TUI client；输出：类型化 RPC 客户端。 */
+export function contextRpc(client: {
+  rpc(definition: Rpc.PortableDefinition): unknown
+}): ContextRpcClient {
+  return client.rpc(ContextRpc) as ContextRpcClient
+}

package/src/shared/scan.ts

@@ -1,32 +1,32 @@
-/**
- * 输入：具备 scan 能力的 storage + 前缀 + 每条目的处理函数。
- * 输出：无。
- * 预期：按 next 游标分页遍历全部匹配条目，逐条串行 await，避免一次性把 key 全读进内存。
- */
-export interface ScanStorageLike {
-  readonly scan?: (options: { prefix: string; limit: number; after?: string }) => Promise<{
-    entries: readonly { key: string; value: unknown }[]
-    next?: string
-  }>
-}
-
-/** 输入：storage + 前缀 + 访问函数 + 每页条数；输出：无；预期：storage 无 scan 时直接返回。 */
-export async function forEachScannedEntry(
-  storage: ScanStorageLike,
-  prefix: string,
-  visit: (entry: { key: string; value: unknown }) => Promise<void>,
-  limit = 100,
-): Promise<void> {
-  if (storage.scan === undefined) return
-  let after: string | undefined
-  for (;;) {
-    const page = await storage.scan({
-      prefix,
-      limit,
-      ...(after === undefined ? {} : { after }),
-    })
-    for (const entry of page.entries) await visit(entry)
-    if (page.next === undefined) return
-    after = page.next
-  }
-}
+/**
+ * 输入：具备 scan 能力的 storage + 前缀 + 每条目的处理函数。
+ * 输出：无。
+ * 预期：按 next 游标分页遍历全部匹配条目，逐条串行 await，避免一次性把 key 全读进内存。
+ */
+export interface ScanStorageLike {
+  readonly scan?: (options: { prefix: string; limit: number; after?: string }) => Promise<{
+    entries: readonly { key: string; value: unknown }[]
+    next?: string
+  }>
+}
+
+/** 输入：storage + 前缀 + 访问函数 + 每页条数；输出：无；预期：storage 无 scan 时直接返回。 */
+export async function forEachScannedEntry(
+  storage: ScanStorageLike,
+  prefix: string,
+  visit: (entry: { key: string; value: unknown }) => Promise<void>,
+  limit = 100,
+): Promise<void> {
+  if (storage.scan === undefined) return
+  let after: string | undefined
+  for (;;) {
+    const page = await storage.scan({
+      prefix,
+      limit,
+      ...(after === undefined ? {} : { after }),
+    })
+    for (const entry of page.entries) await visit(entry)
+    if (page.next === undefined) return
+    after = page.next
+  }
+}