dsh-context-compression-improved 0.3.1 → 0.4.0-beta.1

package/packages/selector/package.json

@@ -51,7 +51,6 @@
   },
   "scripts": {
     "bundle": "tsdown --config tsdown.config.ts && tsdown --config tsdown.client.config.ts",
-    "prepack": "pnpm run bundle",
     "typecheck": "tsc --noEmit -p tsconfig.json",
     "test": "vitest run --root ../.. --config vitest.config.ts --project runtime --project selector-host --project selector-client",
     "pack:dry-run": "npm pack --dry-run"

package/packages/selector/src/client/EstimatorControls.tsx

@@ -275,3 +275,104 @@ export function EstimatorControls({ options, disabled, save, settle, t }: Estima
     </section>
   )
 }
+
+interface ReviewModeControlsProps {
+  options: PresetOptionsSettings
+  disabled: boolean
+  save: (options: PresetOptionsPatch) => Promise<void>
+  settle: (operation: () => Promise<void>) => void
+  t: (key: ContextCompressionLocaleKey) => string
+}
+
+/**
+ * TokenPilot-inspired review-mode card (beta). When enabled, edge/high-impact
+ * reduction candidates queue for manual approval and execute in one merged
+ * batch at the next turn boundary; the numeric fields tune the benefit model.
+ * Numeric drafts commit on blur and only when they parse to a value the
+ * runtime schema accepts, so an invalid keystroke never disables the panel.
+ */
+export function ReviewModeControls({ options, disabled, save, settle, t }: ReviewModeControlsProps) {
+  const [turnsDraft, setTurnsDraft] = useState(String(options.reviewTimeoutTurns ?? 6))
+  const [alphaDraft, setAlphaDraft] = useState(String(options.cacheHitDiscountAlpha ?? 0.1))
+  const [highImpactDraft, setHighImpactDraft] = useState(String(options.reviewHighImpactTokens ?? 4000))
+  const reviewMode = options.reviewMode ?? false
+  const commit = (patch: PresetOptionsPatch) => {
+    settle(() => save(patch))
+  }
+  const commitTurns = (): void => {
+    const next = Number(turnsDraft)
+    if (!Number.isSafeInteger(next) || next < 1 || next === (options.reviewTimeoutTurns ?? 6)) return
+    commit({ reviewTimeoutTurns: next })
+  }
+  const commitAlpha = (): void => {
+    const next = Number(alphaDraft)
+    if (!Number.isFinite(next) || next <= 0 || next >= 1 || next === (options.cacheHitDiscountAlpha ?? 0.1)) return
+    commit({ cacheHitDiscountAlpha: next })
+  }
+  const commitHighImpact = (): void => {
+    const next = Number(highImpactDraft)
+    if (!Number.isSafeInteger(next) || next < 0 || next === (options.reviewHighImpactTokens ?? 4000)) return
+    commit({ reviewHighImpactTokens: next })
+  }
+  return (
+    <section className={css.autoCompact} aria-labelledby="context-compression-review-title">
+      <h3 id="context-compression-review-title" className={css.autoCompactTitle}>{t('review.title')}</h3>
+      <p className={css.customNote}>{t('review.description')}</p>
+      <label className={css.field}>
+        <span>{t('review.enabled')}</span>
+        <select
+          value={reviewMode ? 'on' : 'off'}
+          disabled={disabled}
+          onChange={(event) => { settle(() => save({ reviewMode: event.currentTarget.value === 'on' })) }}
+        >
+          <option value="off">{t('review.enabled.off')}</option>
+          <option value="on">{t('review.enabled.on')}</option>
+        </select>
+      </label>
+      {reviewMode ? (
+        <>
+          <label className={css.field}>
+            <span>{t('review.timeoutTurns')}</span>
+            <input
+              type="number"
+              min={1}
+              step={1}
+              value={turnsDraft}
+              disabled={disabled}
+              onChange={(event) => { setTurnsDraft(event.currentTarget.value) }}
+              onBlur={commitTurns}
+              onKeyDown={(event) => { if (event.key === 'Enter') event.currentTarget.blur() }}
+            />
+          </label>
+          <label className={css.field}>
+            <span>{t('review.alpha')}</span>
+            <input
+              type="number"
+              min={0.01}
+              max={0.99}
+              step={0.05}
+              value={alphaDraft}
+              disabled={disabled}
+              onChange={(event) => { setAlphaDraft(event.currentTarget.value) }}
+              onBlur={commitAlpha}
+              onKeyDown={(event) => { if (event.key === 'Enter') event.currentTarget.blur() }}
+            />
+          </label>
+          <label className={css.field}>
+            <span>{t('review.highImpact')}</span>
+            <input
+              type="number"
+              min={0}
+              step={500}
+              value={highImpactDraft}
+              disabled={disabled}
+              onChange={(event) => { setHighImpactDraft(event.currentTarget.value) }}
+              onBlur={commitHighImpact}
+              onKeyDown={(event) => { if (event.key === 'Enter') event.currentTarget.blur() }}
+            />
+          </label>
+        </>
+      ) : null}
+    </section>
+  )
+}

package/packages/selector/src/client/ReviewOverlay.tsx

@@ -0,0 +1,320 @@
+/**
+ * TokenPilot-inspired R4: the review floating window.
+ *
+ * Mounted on the host `shell.overlay` slot (dsh-tidychat precedent: the layer
+ * is click-through by default and only the card opts back in), showing a
+ * bottom-right badge while any session has pending proposals and a card with
+ * the four-state summary row plus one row per proposal. Every 10s it polls the
+ * review-queue route; when the queue is empty or review mode is off the
+ * component renders null, so it never disturbs the session.
+ *
+ * Styles carry the `dsh-cc-review-` prefix and ride a one-shot style tag.
+ */
+import { useEffect, useState } from 'react'
+import type { ReactElement } from 'react'
+import type { SettingsScopeLike } from './review-scope.ts'
+
+const QUEUE_ROUTES = [
+  '/api/dsh-context-compression-improved/review-queue',
+  '/endpoint/dsh-context-compression-improved/review-queue',
+] as const
+const DECIDE_ROUTES = [
+  '/api/dsh-context-compression-improved/review-decide',
+  '/endpoint/dsh-context-compression-improved/review-decide',
+] as const
+
+export interface PendingProposal {
+  readonly sessionId: string
+  readonly id: string
+  readonly kind: string
+  readonly items: readonly { readonly seq: number, readonly tokensBefore: number, readonly tokensAfter: number }[]
+  readonly benefit: {
+    readonly recoveredTokens: number
+    readonly paybackTurns?: number
+    readonly expectedSaving?: number
+  }
+}
+
+export interface ReviewSummary {
+  readonly autoApplied: number
+  readonly reviewApplied: number
+  readonly expired: number
+  readonly voided: number
+}
+
+interface ReviewOverlayProps {
+  /** Bound settings scope; supplies the reviewMode switch. */
+  scope: SettingsScopeLike
+  t: (key: string) => string
+}
+
+const CSS = `
+.dsh-cc-review-badge {
+  position: fixed;
+  right: 20px;
+  bottom: 20px;
+  z-index: 70;
+  pointer-events: auto;
+  box-sizing: border-box;
+  min-width: 34px;
+  height: 34px;
+  padding: 0 10px;
+  border-radius: 17px;
+  border: 1px solid var(--dsw-alias-border-l2, rgba(128,128,128,0.4));
+  background: var(--dsw-alias-bg-layer-3, #fff);
+  color: var(--dsw-alias-label-primary, #222);
+  font-size: 13px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  gap: 6px;
+  cursor: pointer;
+  box-shadow: 0 6px 18px rgba(0, 0, 0, 0.14);
+}
+.dsh-cc-review-card {
+  position: fixed;
+  right: 20px;
+  bottom: 62px;
+  z-index: 70;
+  pointer-events: auto;
+  box-sizing: border-box;
+  width: min(420px, calc(100vw - 40px));
+  max-height: min(60vh, 520px);
+  overflow: auto;
+  background: var(--dsw-alias-bg-layer-3, #fff);
+  border: 1px solid var(--dsw-alias-border-l2, rgba(128,128,128,0.4));
+  border-radius: 12px;
+  box-shadow: 0 12px 32px rgba(0, 0, 0, 0.18);
+  padding: 12px 14px;
+  color: var(--dsw-alias-label-primary, #222);
+  font-size: 13px;
+}
+.dsh-cc-review-title {
+  font-weight: 600;
+  margin: 0 0 6px;
+  font-size: 13px;
+}
+.dsh-cc-review-summary {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 4px 12px;
+  color: var(--dsw-alias-label-tertiary, #888);
+  font-size: 12px;
+  margin-bottom: 8px;
+}
+.dsh-cc-review-row {
+  border-top: 1px solid var(--dsw-alias-border-l2, rgba(128,128,128,0.25));
+  padding: 8px 0;
+}
+.dsh-cc-review-row-meta {
+  color: var(--dsw-alias-label-tertiary, #888);
+  font-size: 12px;
+  margin-bottom: 4px;
+}
+.dsh-cc-review-actions {
+  display: flex;
+  gap: 8px;
+}
+.dsh-cc-review-btn {
+  appearance: none;
+  border: 1px solid var(--dsw-alias-border-l2, rgba(128,128,128,0.4));
+  background: transparent;
+  color: inherit;
+  border-radius: 6px;
+  padding: 3px 10px;
+  font-size: 12px;
+  cursor: pointer;
+}
+.dsh-cc-review-btn-primary {
+  background: var(--dsw-alias-state-business-primary, #3b82f6);
+  border-color: transparent;
+  color: #fff;
+}
+`
+
+function injectOnce(): () => void {
+  const tag = document.createElement('style')
+  tag.setAttribute('data-plugin-css', 'dsh-context-compression-improved-review')
+  tag.textContent = CSS
+  document.head.appendChild(tag)
+  return () => { tag.remove() }
+}
+
+async function fetchJson(route: string, init?: RequestInit): Promise<unknown> {
+  const response = await fetch(route, { headers: { 'cache-control': 'no-cache' }, ...init })
+  if (!response.ok) return undefined
+  return response.json()
+}
+
+async function pollQueue(): Promise<{ pending: PendingProposal[], summary?: ReviewSummary | undefined } | undefined> {
+  for (const route of QUEUE_ROUTES) {
+    const body = await fetchJson(route) as {
+      ok?: boolean
+      total?: number
+      pending?: PendingProposal[]
+      summary?: ReviewSummary
+    } | undefined
+    if (body?.ok === true) {
+      return { pending: body.pending ?? [], summary: body.summary }
+    }
+  }
+  return undefined
+}
+
+async function postDecide(proposal: PendingProposal, decision: string): Promise<boolean> {
+  for (const route of DECIDE_ROUTES) {
+    try {
+      const response = await fetch(route, {
+        method: 'POST',
+        headers: { 'content-type': 'application/json' },
+        body: JSON.stringify({ sessionId: proposal.sessionId, proposalId: proposal.id, decision }),
+      })
+      if (response.status !== 404) return response.ok
+    } catch {
+      // Try the next prefix.
+    }
+  }
+  return false
+}
+
+/**
+ * Slot factory helper: the client entry is a .ts file and cannot carry JSX,
+ * so the element construction lives here.
+ */
+export function renderReviewOverlay(
+  scope: SettingsScopeLike,
+  t: (key: string) => string,
+): ReactElement {
+  return <ReviewOverlay scope={scope} t={t} />
+}
+
+/**
+ * The floating window itself: renders null (and stays silent) while review
+ * mode is off or nothing is pending.
+ */
+export function ReviewOverlay({ scope, t }: ReviewOverlayProps) {
+  const [reviewMode, setReviewMode] = useState(false)
+  const [pending, setPending] = useState<PendingProposal[]>([])
+  const [summary, setSummary] = useState<ReviewSummary | undefined>()
+  const [expanded, setExpanded] = useState(false)
+  const [busy, setBusy] = useState(false)
+
+  useEffect(injectOnce, [])
+  useEffect(() => {
+    const pull = (): void => {
+      try {
+        const snapshot = scope.getSnapshot()
+        setReviewMode(snapshot.status === 'ready' && snapshot.value?.presetOptions?.reviewMode === true)
+      } catch {
+        setReviewMode(false)
+      }
+    }
+    pull()
+    let unsubscribe = (): void => {}
+    try {
+      unsubscribe = scope.subscribe(pull)
+    } catch {
+      unsubscribe = (): void => {}
+    }
+    return unsubscribe
+  }, [scope])
+
+  useEffect(() => {
+    if (!reviewMode) return
+    let alive = true
+    let timer: ReturnType<typeof setTimeout> | undefined
+    const tick = (): void => {
+      void pollQueue().then((result) => {
+        if (!alive) return
+        setPending(result?.pending ?? [])
+        setSummary(result?.summary)
+        timer = setTimeout(tick, 10_000)
+      })
+    }
+    tick()
+    return () => {
+      alive = false
+      if (timer !== undefined) clearTimeout(timer)
+    }
+  }, [reviewMode])
+
+  if (!reviewMode || pending.length === 0) return null
+
+  const decide = (proposal: PendingProposal, decision: string): void => {
+    setBusy(true)
+    void postDecide(proposal, decision).then(() => {
+      return pollQueue().then((result) => {
+        setPending(result?.pending ?? [])
+        setSummary(result?.summary)
+        setBusy(false)
+      })
+    }).catch(() => { setBusy(false) })
+  }
+
+  const seqRange = (proposal: PendingProposal): string => {
+    const seqs = proposal.items.map(item => item.seq)
+    const min = Math.min(...seqs)
+    const max = Math.max(...seqs)
+    return min === max ? `#${String(min)}` : `#${String(min)}–#${String(max)}`
+  }
+
+  return (
+    <>
+      {expanded ? (
+        <div className="dsh-cc-review-card">
+          <p className="dsh-cc-review-title">{t('review.title')}</p>
+          {summary !== undefined ? (
+            <div className="dsh-cc-review-summary">
+              <span>{t('review.summary.autoApplied')}: {String(summary.autoApplied)}</span>
+              <span>{t('review.summary.reviewApplied')}: {String(summary.reviewApplied)}</span>
+              <span>{t('review.summary.expired')}: {String(summary.expired)}</span>
+              <span>{t('review.summary.voided')}: {String(summary.voided)}</span>
+            </div>
+          ) : null}
+          {pending.map(proposal => (
+            <div className="dsh-cc-review-row" key={proposal.id}>
+              <div className="dsh-cc-review-row-meta">
+                {proposal.kind} · {seqRange(proposal)} · R ≈ {String(proposal.benefit.recoveredTokens)}
+                {proposal.benefit.paybackTurns !== undefined
+                  ? ` · ${t('review.row.payback')}: ${String(Math.round(proposal.benefit.paybackTurns * 100) / 100)}`
+                  : ''}
+                {proposal.benefit.expectedSaving !== undefined
+                  ? ` · ${t('review.row.expectedSaving')}: ${String(Math.round(proposal.benefit.expectedSaving))} (${t('review.row.estimated')})`
+                  : ''}
+              </div>
+              <div className="dsh-cc-review-actions">
+                <button
+                  type="button" className="dsh-cc-review-btn dsh-cc-review-btn-primary"
+                  disabled={busy}
+                  onClick={() => { decide(proposal, 'approved') }}
+                >
+                  {t('review.action.approve')}
+                </button>
+                <button
+                  type="button" className="dsh-cc-review-btn"
+                  disabled={busy}
+                  onClick={() => { decide(proposal, 'rejected') }}
+                >
+                  {t('review.action.reject')}
+                </button>
+                <button
+                  type="button" className="dsh-cc-review-btn"
+                  disabled={busy}
+                  onClick={() => { decide(proposal, 'ignored') }}
+                >
+                  {t('review.action.ignore')}
+                </button>
+              </div>
+            </div>
+          ))}
+        </div>
+      ) : null}
+      <button
+        type="button" className="dsh-cc-review-badge"
+        onClick={() => { setExpanded(value => !value) }}
+      >
+        {t('review.badge')} {String(pending.length)}
+      </button>
+    </>
+  )
+}

package/packages/selector/src/client/index.ts

@@ -12,6 +12,7 @@ import { DEFAULT_CUSTOM_COMPRESSION_POLICY } from '../profiles.ts'
 import { decodeSettings } from './decode.ts'
 import { en, zh } from './locales.ts'
 import { planPresetOptionsOps, presetOptionsOpsAccepted } from './preset-options.ts'
+import { ReviewOverlay, renderReviewOverlay } from './ReviewOverlay.tsx'
 
 /**
  * Harness 0.1.5 mounts the web core's `slots` service on the client context
@@ -141,6 +142,22 @@ export function apply(ctx: ClientContext): void {
   } catch (error) {
     console.warn('[dsh-context-compression-improved] settings.section 注册失败(新宿主已收编):', error)
   }
+
+  // TokenPilot-inspired R4：审查浮窗挂在 shell.overlay（dsh-tidychat 先例：
+  // 该层默认点击穿透，卡片自持指针事件）。reviewMode 关闭或无 pending 时组件
+  // 渲染 null —— 与 0.1.2 宿主（无此 slot）同构的降级语义：注册失败不影响设置卡。
+  // （本文件是 .ts：元素构造在 ReviewOverlay.renderReviewOverlay，不能内联 JSX。）
+  try {
+    ctx.slots.inject('shell.overlay', () => ctx.slots.register(
+      { name: 'shell.overlay', id: 'context-compression-review' },
+      () => {
+        const scope = ctx.settingsScope.bind<ContextCompressionSettings>({ namespace: NS, decode: decodeSettings })
+        return renderReviewOverlay(scope, ctx.locale.bind(NS) as (key: string) => string)
+      },
+    ))
+  } catch (error) {
+    console.warn('[dsh-context-compression-improved] shell.overlay 注册失败(宿主无浮层或已收编):', error)
+  }
 }
 
 export type {

package/packages/selector/src/client/locales.ts

@@ -35,6 +35,25 @@ export const zh = {
   'estimator.apiKey.set': '已设置 · 输入新值覆盖',
   'estimator.apiKey.clear': '清除',
   'estimator.apiKey.overwrite': '已设置保密值，输入新值并失焦即可覆盖。',
+  'review.title': '人工审查（beta）',
+  'review.description': '开启后，边缘区间与高影响的压缩候选不再自动执行，而是进入待审队列并在你批准后的下一个回合边界批量执行；未处理的提案超过过期轮数后自动作废。仅随「TokenPilot 启发模式」提供，默认关闭。',
+  'review.enabled': '审查模式',
+  'review.enabled.on': '开（提案等待人工批准）',
+  'review.enabled.off': '关（默认，全自动）',
+  'review.timeoutTurns': '提案过期轮数',
+  'review.alpha': '缓存命中折扣 α',
+  'review.highImpact': '高影响门槛（tokens）',
+  'review.badge': '待审',
+  'review.summary.autoApplied': '自动应用',
+  'review.summary.reviewApplied': '审查应用',
+  'review.summary.expired': '已过期',
+  'review.summary.voided': '已作废',
+  'review.row.payback': '回本轮数',
+  'review.row.expectedSaving': '预期节省',
+  'review.row.estimated': '估计',
+  'review.action.approve': '批准',
+  'review.action.reject': '驳回',
+  'review.action.ignore': '本会话忽略',
   'detail.tokenpilot-inspired': '在平衡模式之上叠加去重指针、恢复豁免、摘要定位块、前缀稳定与读取状态语义；估计器需另行配置端点',
   'profile.custom': 'Custom／实验模式',
   'profile.native': '原生对照',
@@ -135,6 +154,25 @@ export const en = {
   'estimator.apiKey.set': 'Set · type a new value to overwrite',
   'estimator.apiKey.clear': 'Clear',
   'estimator.apiKey.overwrite': 'A secret is stored; type a new value and blur to overwrite it.',
+  'review.title': 'Review mode (beta)',
+  'review.description': 'When enabled, edge-band and high-impact reduction candidates no longer apply automatically: they queue for manual approval and execute in one merged batch at the next turn boundary after approval. Unhandled proposals expire after the configured number of turns. Ships with the TokenPilot-inspired profile only, off by default.',
+  'review.enabled': 'Review mode',
+  'review.enabled.on': 'On (proposals wait for manual approval)',
+  'review.enabled.off': 'Off (default, fully automatic)',
+  'review.timeoutTurns': 'Proposal expiry (turns)',
+  'review.alpha': 'Cache-hit discount α',
+  'review.highImpact': 'High-impact threshold (tokens)',
+  'review.badge': 'Review',
+  'review.summary.autoApplied': 'Auto-applied',
+  'review.summary.reviewApplied': 'Review-applied',
+  'review.summary.expired': 'Expired',
+  'review.summary.voided': 'Voided',
+  'review.row.payback': 'Payback',
+  'review.row.expectedSaving': 'Expected saving',
+  'review.row.estimated': 'estimated',
+  'review.action.approve': 'Approve',
+  'review.action.reject': 'Reject',
+  'review.action.ignore': 'Ignore',
   'detail.tokenpilot-inspired': 'Layered on Balanced: dedupe pointers, recovery exemption, summary locators, prefix stabilization, and read-state semantics; the estimator needs an endpoint configured separately',
   'profile.custom': 'Custom / Experimental',
   'profile.native': 'Native baseline',

package/packages/selector/src/client/preset-options.ts

@@ -24,6 +24,7 @@ const PRESET_OPTIONS_KEY = 'presetOptions'
 const PRESET_OPTION_KEYS = [
   'dedupeToolResults', 'summaryLocator', 'prefixStabilizer', 'readState', 'estimatorMode',
   'estimatorProvider', 'estimatorModel', 'estimatorBaseUrl', 'estimatorApiKey', 'estimatorTimeoutMs',
+  'reviewMode', 'reviewTimeoutTurns', 'cacheHitDiscountAlpha', 'reviewHighImpactTokens',
 ] as const
 
 /** One partial edit of `presetOptions`; `undefined` clears the named field. */

package/packages/selector/src/client/review-scope.ts

@@ -0,0 +1,16 @@
+/**
+ * The minimal face of the bound settings scope the review overlay consumes —
+ * structural, so tests can stub it without the settings transport.
+ */
+
+export interface SettingsScopeLike {
+  getSnapshot(): {
+    status: string
+    value?: {
+      presetOptions?: {
+        reviewMode?: boolean | undefined
+      } | undefined
+    } | undefined
+  }
+  subscribe(listener: () => void): () => void
+}

package/packages/selector/src/client/settings-section.tsx

@@ -16,7 +16,7 @@ import {
 } from '../profiles.ts'
 import type { CompressionProfileSelectorProps } from './CompressionProfileSelector.tsx'
 import { AutoCompactThresholdControls, CodeSkeletonControls } from './CompressionProfileControls.tsx'
-import { EstimatorControls, EstimatorInactiveNotice } from './EstimatorControls.tsx'
+import { EstimatorControls, EstimatorInactiveNotice, ReviewModeControls } from './EstimatorControls.tsx'
 import { CustomPolicyEditor, editableCustom } from './CustomPolicyEditor.tsx'
 
 /** Full-page Settings surface backed by the same durable selector state. */
@@ -105,13 +105,22 @@ export function SettingsCompressionProfileControls({
       {current !== 'tokenpilot-inspired' ? (
         <EstimatorInactiveNotice profile={t(`profile.${current}`)} t={t} />
       ) : (
-        <EstimatorControls
-          options={state.value?.presetOptions ?? {}}
-          disabled={busy || !state.writable || !selectorAvailable}
-          save={savePresetOptions}
-          settle={settle}
-          t={t}
-        />
+        <>
+          <EstimatorControls
+            options={state.value?.presetOptions ?? {}}
+            disabled={busy || !state.writable || !selectorAvailable}
+            save={savePresetOptions}
+            settle={settle}
+            t={t}
+          />
+          <ReviewModeControls
+            options={state.value?.presetOptions ?? {}}
+            disabled={busy || !state.writable || !selectorAvailable}
+            save={savePresetOptions}
+            settle={settle}
+            t={t}
+          />
+        </>
       )}
       <div className={css.pricing}>{t('pricing.disclosure')}</div>
       {current !== 'custom' || draft === null || !selectorAvailable ? null : (