dsh-lcx-codex 0.3.1 → 0.3.2

package/CHANGELOG.md

@@ -4,6 +4,13 @@
 
 ## Unreleased
 
+## 0.3.2 - 2026-08-21
+
+### Fixed
+
+- Native V2 compact 与同路由 replay 现在和 DSH/Pi 普通 Responses 请求复用相同的 session `prompt_cache_key`、缓存 retention 与会话 header，避免压缩边界额外切换 NewAPI/Sub2API 的缓存和账号粘性域；`cacheRetention: none` 时同时省略这些缓存信号。
+- 移除未被插件直接导入或注入的 `@deepseek-ai/dsh-compaction-basic` peer 声明，避免 DSH/pnpm 安装时出现误导性的宿主依赖警告；Basic fallback 继续通过 DSH `llm/stream` 的 `next()` 链调用宿主实现。
+
 ## 0.3.1 - 2026-08-21
 
 ### Fixed

package/README.md

@@ -78,7 +78,7 @@ dsh plugin --profile web add dsh-lcx-codex
 也可以下载 GitHub Release 中的 `.tgz` 安装指定版本：
 
 ```powershell
-dsh plugin --profile web add .\dsh-lcx-codex-0.3.1.tgz
+dsh plugin --profile web add .\dsh-lcx-codex-0.3.2.tgz
 ```
 
 安装后启动 DSH：

package/README_EN.md

@@ -78,7 +78,7 @@ dsh plugin --profile web add dsh-lcx-codex
 You can also install a specific `.tgz` file from a GitHub Release:
 
 ```powershell
-dsh plugin --profile web add .\dsh-lcx-codex-0.3.1.tgz
+dsh plugin --profile web add .\dsh-lcx-codex-0.3.2.tgz
 ```
 
 Start DSH after installation:

package/lib/compact-v2.js

@@ -156,7 +156,7 @@ export function mergeFeatureHeader(headers) {
   return result
 }
 
-export function buildNativeCompactionBody({ model, input, instructions, promptCacheKey, tools }) {
+export function buildNativeCompactionBody({ model, input, instructions, promptCacheKey, promptCacheRetention, tools }) {
   if (!Array.isArray(input)) throw protocolError('Native compaction input must be an array', 'LCX_COMPACT_INVALID_INPUT')
   if (input.some((item) => isObject(item) && item.type === 'compaction_trigger')) {
     throw protocolError('Native compaction input already contains compaction_trigger', 'LCX_COMPACT_DUPLICATE_TRIGGER')
@@ -170,6 +170,7 @@ export function buildNativeCompactionBody({ model, input, instructions, promptCa
     ...(nativeTools !== undefined ? { tools: nativeTools } : {}),
     ...(instructions !== undefined ? { instructions: structuredClone(instructions) } : {}),
     ...(promptCacheKey !== undefined && promptCacheKey !== null ? { prompt_cache_key: String(promptCacheKey) } : {}),
+    ...(promptCacheRetention !== undefined && promptCacheRetention !== null ? { prompt_cache_retention: String(promptCacheRetention) } : {}),
   }
 }
 
@@ -273,6 +274,7 @@ export async function requestNativeCompaction({
   input,
   instructions,
   promptCacheKey,
+  promptCacheRetention,
   idempotencyKey,
   tools,
   headers,
@@ -281,7 +283,7 @@ export async function requestNativeCompaction({
   maxAttempts,
   maxResponseBytes,
 }) {
-  const body = buildNativeCompactionBody({ model, input, instructions, promptCacheKey, tools })
+  const body = buildNativeCompactionBody({ model, input, instructions, promptCacheKey, promptCacheRetention, tools })
   const requestHeaders = { ...(headers ?? {}) }
   if (idempotencyKey !== undefined && idempotencyKey !== null && !Object.keys(requestHeaders).some((name) => name.toLowerCase() === 'idempotency-key')) {
     requestHeaders['idempotency-key'] = String(idempotencyKey)

package/lib/index.js

@@ -1,6 +1,7 @@
 import z from '@deepseek-ai/schemastery'
 import { attributionHeaders, resolveRetryPolicy } from '@deepseek-ai/dsh-llm'
 import { settingsNamespace } from '@deepseek-ai/dsh-settings'
+import { clampOpenAIPromptCacheKey } from '@earendil-works/pi-ai/api/openai-prompt-cache'
 import { randomUUID } from 'node:crypto'
 import { homedir } from 'node:os'
 import { join } from 'node:path'
@@ -135,6 +136,7 @@ function normalizeCompactTransport(value) {
 }
 
 function normalizeConfig(input = {}) {
+  const cacheRetention = ['none', 'short', 'long'].includes(input.cacheRetention) ? input.cacheRetention : 'short'
   return {
     provider: input.provider || 'lcx',
     baseURL: String(input.baseURL || 'https://api.lcxbot.com/v1').replace(/\/+$/u, ''),
@@ -142,6 +144,8 @@ function normalizeConfig(input = {}) {
     model: input.model || 'gpt-5.6-sol',
     compactTransport: normalizeCompactTransport(input.compactTransport),
     headers: input.headers && typeof input.headers === 'object' ? { ...input.headers } : {},
+    cacheRetention,
+    supportsLongCacheRetention: input.supportsLongCacheRetention !== false,
     checkpointPath: input.checkpointPath || defaultCheckpointPath(),
     portableCheckpointPath: input.portableCheckpointPath || portableCheckpointPath(input.checkpointPath || defaultCheckpointPath()),
     alphaCapabilityPath: input.alphaCapabilityPath || defaultAlphaCapabilityPath(),
@@ -186,6 +190,8 @@ function resolveResponsesRouteConfig(ctx, options, fallbackConfig) {
     baseURL,
     apiKeyEnv,
     headers: profile.headers ?? fallbackConfig.headers,
+    cacheRetention: profile.cacheRetention ?? fallbackConfig.cacheRetention,
+    supportsLongCacheRetention: profile.compat?.supportsLongCacheRetention ?? fallbackConfig.supportsLongCacheRetention,
     model: options.model,
     compactTransport: profile.compactTransport ?? fallbackConfig.compactTransport,
     timeoutMs: profile.timeoutMs ?? fallbackConfig.timeoutMs,
@@ -301,7 +307,7 @@ async function authenticatedHeaders(ctx, config, sessionId, clientRequestId) {
     ...config.headers,
     ...attributionHeaders(),
     authorization: `Bearer ${await resolveApiKey(ctx, config)}`,
-    'x-client-request-id': clientRequestId ?? randomUUID(),
+    ...(clientRequestId === null ? {} : { 'x-client-request-id': clientRequestId ?? (sessionId ? String(sessionId) : randomUUID()) }),
     ...(sessionId ? { 'session-id': String(sessionId) } : {}),
   }
 }
@@ -361,19 +367,35 @@ function routeWithSessionAncestry(ctx, route) {
   return { ...route, ancestorSessionIds: sessionAncestry(ctx, route.sessionId) }
 }
 
-function promptCacheKey(route) {
-  return route?.sessionId ? routeFingerprint(route) : undefined
+function promptCacheSessionId(route, config) {
+  if (config?.cacheRetention === 'none') return undefined
+  return route?.sessionId ? String(route.sessionId) : undefined
+}
+
+function promptCacheKey(route, config) {
+  const sessionId = promptCacheSessionId(route, config)
+  return sessionId ? clampOpenAIPromptCacheKey(sessionId) : undefined
+}
+
+function promptCacheRetention(config) {
+  return config?.cacheRetention === 'long' && config.supportsLongCacheRetention !== false ? '24h' : undefined
+}
+
+function promptCacheHeaders(ctx, config, route) {
+  const sessionId = promptCacheSessionId(route, config)
+  return authenticatedHeaders(ctx, config, sessionId, sessionId === undefined ? null : undefined)
 }
 
 async function requestRemoteCompaction(options, input, config, signal, ctx, route, preflightHeaders) {
   try {
-    const headers = preflightHeaders ?? await authenticatedHeaders(ctx, config, options.sessionId)
+    const headers = preflightHeaders ?? await promptCacheHeaders(ctx, config, route)
     return await requestNativeCompaction({
       baseURL: config.baseURL,
       model: options.model,
       input,
       instructions: options.system,
-      promptCacheKey: promptCacheKey(route),
+      promptCacheKey: promptCacheKey(route, config),
+      promptCacheRetention: promptCacheRetention(config),
       idempotencyKey: randomUUID(),
       tools: options.tools,
       headers,
@@ -731,7 +753,7 @@ function checkpointReplayRecord(messages, store) {
   return { marker, record }
 }
 
-function nativeReplayBody(options, route, nativeOutput, tailInput) {
+function nativeReplayBody(options, route, config, nativeOutput, tailInput) {
   return {
     model: options.model,
     input: [...structuredClone(nativeOutput), ...structuredClone(tailInput)],
@@ -739,7 +761,8 @@ function nativeReplayBody(options, route, nativeOutput, tailInput) {
     store: false,
     ...(options.tools !== undefined ? { tools: responsesTools(options.tools) } : {}),
     ...(options.system !== undefined ? { instructions: options.system } : {}),
-    ...(promptCacheKey(route) ? { prompt_cache_key: promptCacheKey(route) } : {}),
+    ...(promptCacheKey(route, config) ? { prompt_cache_key: promptCacheKey(route, config) } : {}),
+    ...(promptCacheRetention(config) ? { prompt_cache_retention: promptCacheRetention(config) } : {}),
   }
 }
 
@@ -762,8 +785,8 @@ async function* nativeCheckpointReplayStream(options, config, portableStore, ctx
   try {
     const response = await fetchSse(
       `${config.baseURL}/responses`,
-      nativeReplayBody(options, route, nativeOutput, tailInput),
-      mergeFeatureHeader(await authenticatedHeaders(ctx, config, options.sessionId)),
+      nativeReplayBody(options, route, config, nativeOutput, tailInput),
+      mergeFeatureHeader(await promptCacheHeaders(ctx, config, route)),
       replaySignals.signal,
       config.timeoutMs + 1000,
       { maxResponseBytes: config.maxResponseBytes },
@@ -822,7 +845,7 @@ async function prepareRemoteCompaction(options, config, portableStore, ctx, sess
   const route = currentRoute(options, config)
   const lease = sessionTracker?.capture(route.sessionId)
   lease?.assert('request-start')
-  const headers = await authenticatedHeaders(ctx, config, options.sessionId)
+  const headers = await promptCacheHeaders(ctx, config, route)
   responsesTools(options.tools)
   const llm = ctx?.llm ?? ctx?.get?.('llm')
   const imageSupport = typeof llm?.resolveModelInfo === 'function'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-lcx-codex",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "DSH web search and Responses native V2 compaction for Sub2API-proxied or NewAPI-relayed GPT models",
   "keywords": [
     "deepseek-harness",
@@ -62,7 +62,6 @@
     "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.8",
     "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.8",
     "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.8",
-    "@deepseek-ai/dsh-compaction-basic": "^0.1.0-rc.8",
     "@deepseek-ai/dsh-credentials": "^0.1.0-rc.8",
     "@deepseek-ai/dsh-llm": "^0.1.0-rc.8",
     "@deepseek-ai/dsh-settings": "^0.1.0-rc.8",