dsh-context-compression-improved 0.2.0 → 0.3.0

package/packages/selector/src/pruner.ts

@@ -13,6 +13,7 @@ import type { Context } from '@deepseek-ai/cordis'
 import z from '@deepseek-ai/schemastery'
 import { createUserMessage, freezeMessage } from '@deepseek-ai/dsh-llm'
 import type { ContentBlock, UserMessage } from '@deepseek-ai/dsh-llm'
+import { SessionSeq } from '@deepseek-ai/dsh-session'
 import type { Session, SessionEvent, ToolResultMessage } from '@deepseek-ai/dsh-session'
 import type {} from '@deepseek-ai/dsh-agent'
 import type {} from '@deepseek-ai/dsh-compaction'
@@ -23,7 +24,7 @@ import type {
   TokenCount,
 } from './runtime/measurement.ts'
 import { measureForCompaction } from './runtime/measurement.ts'
-import { sessionEvents } from './runtime/session-events.ts'
+import { eventBySeq, sessionEvents } from './runtime/session-events.ts'
 import { countExactCanonicalTextFields } from './runtime/token-count.ts'
 import type {} from '@deepseek-ai/dsh-tools'
 import {
@@ -45,7 +46,6 @@ import {
   recoveryMarker,
   summarize,
   emptyResult,
-  measureContent,
   pressureCost,
   nativePruneContent,
 } from './pruner/content.ts'
@@ -165,15 +165,12 @@ export type {
   PruneResult,
   PruneSessionOptions,
   PruneStage,
-  ResolvedConfig,
   ToolResultPruneConfig,
 } from './runtime/types.ts'
 
 // Re-export the canonical profile list from the type module as a runtime value.
 export { COMPRESSION_PROFILES } from './runtime/types.ts'
 
-
-
 declare module '@deepseek-ai/cordis' {
   interface Context {
     toolResultPruner: ToolResultPruner
@@ -204,6 +201,9 @@ export class ToolResultPruner extends Service {
   /** Consolidated per-session mutable state. */
   readonly state: PrunerState
 
+  /** 0.1.5-specific: per-session sets of already-audited native summary seqs. */
+  private readonly auditedNativeSummaries = new WeakMap<Session, Set<number>>()
+
   constructor(ctx: Context, config: ToolResultPruneConfig = {}) {
     super(ctx, 'toolResultPruner')
     ctx.inject(['tools', 'systemPrompt'], recoveryCtx => {
@@ -225,19 +225,9 @@ export class ToolResultPruner extends Service {
     }
 
     ctx.on('session/event', (session, event) => {
+      this.scanForSeededNativeSummary(session)
       if (event.type === 'compaction/summary') {
-        emitCompressionAudit(ctx.logger, {
-          schemaVersion: 1,
-          kind: 'native-auto-compact',
-          sessionId: String(session.id),
-          manifestEventType: 'compaction/summary',
-          manifestSeq: event.seq,
-          reducer: 'llm-summary',
-          provider: event.data.provider,
-          model: event.data.model,
-          tokensBefore: event.data.shadowedTokenCount,
-          tokensAfter: null,
-        })
+        this.emitNativeSummaryAudit(session, event.seq, event.data)
         return
       }
       if (event.type === 'compaction/end') {
@@ -271,7 +261,12 @@ export class ToolResultPruner extends Service {
             ctx.logger.warn('context-compression fresh pass failed open: %o', error)
           }
         }
-        return await next()
+        const outcome = await next()
+        // BasicCompactionEngine's own pre-step may have just landed a Native
+        // auto-compact summary (possibly through a seed-reopen that never
+        // reaches the event firehose): scan once more after the step opens.
+        this.scanForSeededNativeSummary(agent.session)
+        return outcome
       } finally {
         if (this.state.activeRequestBoundaries.get(agent.session) === boundary) {
           this.state.activeRequestBoundaries.delete(agent.session)
@@ -299,10 +294,6 @@ export class ToolResultPruner extends Service {
    * @param blocks - tool-result content to measure.
    * @returns total Unicode code points across text blocks.
    */
-  measureContent(blocks: readonly ContentBlock[]): number {
-    return measureContent(blocks)
-  }
-
   /**
    * Apply the configured native head/middle/tail transform.
    * @param blocks - original tool-result content.
@@ -326,6 +317,7 @@ export class ToolResultPruner extends Service {
    * @returns landed replacements and aggregate Unicode-code-point savings.
    */
   pruneSession(session: Session, options: PruneSessionOptions = {}): PruneResult {
+    this.scanForSeededNativeSummary(session)
     const stage = options.stage ?? 'pressure'
     // External callers (compaction-basic) do not carry routed capacity; the
     // runtime resolves it itself so the frozen Auto Compact linkage and the
@@ -491,7 +483,7 @@ export class ToolResultPruner extends Service {
     // carrying this compaction's checkpoint provenance. Newest match wins.
     let checkpointSeq: number | undefined
     for (const seq of [...session.surface.nodes].reverse()) {
-      const event = events[seq]
+      const event = eventBySeq(events, seq)
       if (event === undefined || event.type !== 'user/message') continue
       const source = (event.data as { source?: { compactionId?: unknown } }).source
       if (source === undefined || source === null) continue
@@ -518,8 +510,8 @@ export class ToolResultPruner extends Service {
       source: { kind: 'plugin', plugin: 'dsh-context-compression-improved-runtime' },
     })
     session.append('user/message', replacement, {
-      surfaceOp: { op: 'replace', start: checkpointSeq, end: checkpointSeq },
-      sourceEventSeqs: [checkpointSeq],
+      surfaceOp: { op: 'replace', startSeq: SessionSeq(checkpointSeq), endSeq: SessionSeq(checkpointSeq) },
+      sourceEventSeqs: [SessionSeq(checkpointSeq)],
     })
     emitCompressionAudit(this.ctx.logger, {
       schemaVersion: 1,
@@ -672,8 +664,6 @@ export class ToolResultPruner extends Service {
     }
   }
 
-
-
   private contextWindowForRequest(
     session: Session,
   ): number | undefined {
@@ -1115,7 +1105,7 @@ export class ToolResultPruner extends Service {
     const measured = new Map(view.measuredNodes.map(node => [node.seq, node.count]))
     const projectionPrices = new Map(view.nodes.map(node => [node.seq, node.tokens]))
     for (const seq of [...session.surface.nodes]) {
-      const event = events[seq]
+      const event = eventBySeq(events, seq)
       if (event?.type !== 'tool/result') continue
       const shadowedHeuristicTokenCount = projectionPrices.get(seq)
       if (shadowedHeuristicTokenCount === undefined) {
@@ -1636,7 +1626,7 @@ export class ToolResultPruner extends Service {
       else if (event.type === 'step/end') completedSteps.add(`${String(event.data.turn)}:${String(event.data.step)}`)
     }
     const firstCompletedSurfaceTurn = session.surface.nodes
-      .map(seq => events[seq])
+      .map(seq => eventBySeq(events, seq))
       .filter((event): event is SessionEvent<'assistant/message'> | SessionEvent<'tool/result'> =>
         (event?.type === 'assistant/message' || event?.type === 'tool/result')
           && completedTurns.has(event.data.turn))
@@ -1648,7 +1638,7 @@ export class ToolResultPruner extends Service {
     for (let index = 0; index < nodes.length; index++) {
       const assistantSeq = nodes[index]
       if (assistantSeq === undefined) continue
-      const assistant = events[assistantSeq]
+      const assistant = eventBySeq(events, assistantSeq)
       if (assistant?.type !== 'assistant/message'
         || assistant.data.interrupted === true
         || assistant.data.message.content.length === 0
@@ -1707,7 +1697,8 @@ export class ToolResultPruner extends Service {
         || stubCount.tokens <= 0
         || tokensBefore - stubCount.tokens < policy.historyMinReclaimTokens) continue
       const heuristicTokens = shadowedSeqs.reduce((sum, seq) => sum + (heuristic.get(seq) ?? 0), 0)
-      const range = { start: assistantSeq, end: resultSeqs.at(-1) ?? assistantSeq }
+      const range = { start: SessionSeq(assistantSeq), end: SessionSeq(resultSeqs.at(-1) ?? assistantSeq) }
+      const surfaceRange = { op: 'replace' as const, startSeq: range.start, endSeq: range.end }
       if (!this.reserveTailTrimBoundaryAttempt(session)) {
         this.auditComponent(session, policy, 'tail-trim', 'pressure', 'skipped',
           'already-attempted-at-request-boundary', {
@@ -1725,7 +1716,7 @@ export class ToolResultPruner extends Service {
       let replacement: SessionEvent<'user/message'>
       try {
         replacement = session.append('user/message', tailTrimMessage(stub), {
-          surfaceOp: { op: 'replace', ...range },
+          surfaceOp: surfaceRange,
           sourceEventSeqs: [manifest.seq, ...shadowedSeqs],
         })
       } catch (error) {
@@ -1857,8 +1848,8 @@ export class ToolResultPruner extends Service {
       content: [{ ...result, content: plan.content }] as [typeof result],
     })
     const manifest = session.append('compaction/prune', {
-      shadowedRange: { start: candidate.seq, end: candidate.seq },
-      shadowedSeqs: [candidate.seq],
+      shadowedRange: { start: SessionSeq(candidate.seq), end: SessionSeq(candidate.seq) },
+      shadowedSeqs: [SessionSeq(candidate.seq)],
       shadowedTokenCount: candidate.shadowedHeuristicTokenCount,
     })
     let replacement: SessionEvent<'tool/result'>
@@ -1867,8 +1858,8 @@ export class ToolResultPruner extends Service {
         ...candidate.event.data,
         message,
       }, {
-        surfaceOp: { op: 'replace', start: candidate.seq, end: candidate.seq },
-        sourceEventSeqs: [candidate.seq],
+        surfaceOp: { op: 'replace', startSeq: SessionSeq(candidate.seq), endSeq: SessionSeq(candidate.seq) },
+        sourceEventSeqs: [SessionSeq(candidate.seq)],
       })
     } catch (error) {
       this.auditPublicationFailure(
@@ -2064,6 +2055,46 @@ export class ToolResultPruner extends Service {
     })
   }
 
+  /** Emit the native-auto-compact audit for one summary manifest, once. */
+  private emitNativeSummaryAudit(
+    session: Session,
+    manifestSeq: number,
+    data: { provider?: unknown, model?: unknown, shadowedTokenCount?: unknown },
+  ): void {
+    let audited = this.auditedNativeSummaries.get(session)
+    if (audited === undefined) {
+      audited = new Set()
+      this.auditedNativeSummaries.set(session, audited)
+    }
+    if (audited.has(manifestSeq)) return
+    audited.add(manifestSeq)
+    emitCompressionAudit(this.ctx.logger, {
+      schemaVersion: 1,
+      kind: 'native-auto-compact',
+      sessionId: String(session.id),
+      manifestEventType: 'compaction/summary',
+      manifestSeq,
+      reducer: 'llm-summary',
+      provider: data.provider === undefined ? 'unknown' : String(data.provider),
+      model: data.model === undefined ? 'unknown' : String(data.model),
+      tokensBefore: typeof data.shadowedTokenCount === 'number' ? data.shadowedTokenCount : null,
+      tokensAfter: null,
+    })
+  }
+
+  /**
+   * 0.1.5 commits Native auto-compact by reopening the Session with a seed
+   * log; seed events never reach the `session/event` firehose, so scan the
+   * snapshot for summary manifests the live listener could not observe.
+   */
+  private scanForSeededNativeSummary(session: Session): void {
+    for (const event of sessionEvents(session)) {
+      if (event.type === 'compaction/summary') {
+        this.emitNativeSummaryAudit(session, event.seq, event.data)
+      }
+    }
+  }
+
   private auditFailure(
     session: Session,
     stage: PruneStage,

package/packages/selector/src/runtime/measurement.ts

@@ -3,6 +3,7 @@
 import type { Context } from '@deepseek-ai/cordis'
 import type { ContentBlock, TokenUsage } from '@deepseek-ai/dsh-llm'
 import { deriveEventMessage } from '@deepseek-ai/dsh-session'
+import { sessionEvents } from './session-events.ts'
 import type { Session } from '@deepseek-ai/dsh-session'
 import type {} from '@deepseek-ai/dsh-token-meter'
 import type { TokenMeasurement } from '@deepseek-ai/dsh-token-meter'
@@ -15,7 +16,6 @@ import {
   estimateDeepSeekVisionImageTokens,
 } from './deepseek-v4-vision-tokens.ts'
 import { unavailableTokenCount } from './token-count.ts'
-import { sessionEvents } from './session-events.ts'
 import type {
   CanonicalTextTokenCounter,
   ExactTokenizerTokenCount,
@@ -113,8 +113,12 @@ export function measureForCompaction(ctx: Context, session: Session): Compaction
   const target = header?.config
   const counter = bindCounter(target?.provider, target?.model)
   const events = sessionEvents(session)
+  // 0.1.5 surface nodes are positional and may replace earlier ranges, so
+  // their seq values are not guaranteed to equal the snapshot array index:
+  // resolve events by seq, never by position.
+  const eventsBySeq = new Map(events.map(event => [Number(event.seq), event]))
   const measuredNodes = measurement.nodes.map((node): MeasuredTokenSurfaceNode => {
-    const event = events[node.seq]
+    const event = eventsBySeq.get(Number(node.seq))
     if (event === undefined) {
       return { seq: node.seq, count: unavailableTokenCount(`surface node ${String(node.seq)} is missing`) }
     }

package/packages/selector/src/runtime/session-events.ts

@@ -13,5 +13,18 @@ export function sessionEvents(session: Session): readonly SessionEvent[] {
   const snapshot = (session as unknown as {
     snapshotEvents?: () => readonly SessionEvent[]
   }).snapshotEvents
-  return typeof snapshot === 'function' ? snapshot.call(session) : session.events
+  if (typeof snapshot === 'function') return snapshot.call(session)
+  return (session as unknown as { events?: readonly SessionEvent[] }).events ?? []
+}
+
+/**
+ * Resolve one surface-node seq to its event. 0.1.5 surface nodes are
+ * positional and may replace earlier ranges, so a node's seq is not
+ * guaranteed to equal the snapshot array index: always resolve by seq.
+ */
+export function eventBySeq(
+  events: readonly SessionEvent[],
+  seq: number | bigint | { valueOf(): number },
+): SessionEvent | undefined {
+  return events[Number(seq)]
 }

package/packages/selector/src/runtime/tail-trim.ts

@@ -69,8 +69,8 @@ export function validatePublishedTailTrim(
   if (manifest?.type !== 'compaction/prune'
     || manifest.data.shadowedSeqs.length < 2
     || manifest.data.shadowedSeqs.length > MAX_ROOTS
-    || manifest.data.shadowedSeqs[0] !== manifest.data.shadowedRange.start
-    || manifest.data.shadowedSeqs.at(-1) !== manifest.data.shadowedRange.end
+    || manifest.data.shadowedSeqs[0] !== Number(manifest.data.shadowedRange.start)
+    || manifest.data.shadowedSeqs.at(-1) !== Number(manifest.data.shadowedRange.end)
     || new Set(manifest.data.shadowedSeqs).size !== manifest.data.shadowedSeqs.length) return null
   const replacement = events[manifestSeq + 1]
   if (replacement?.type !== 'user/message'
@@ -79,8 +79,8 @@ export function validatePublishedTailTrim(
     || replacement.data.source.plugin !== 'dsh-context-compression-improved-runtime'
     || replacement.surfaceOp === undefined
     || replacement.surfaceOp === 'append'
-    || replacement.surfaceOp.start !== manifest.data.shadowedRange.start
-    || replacement.surfaceOp.end !== manifest.data.shadowedRange.end
+    || replacement.surfaceOp.startSeq !== manifest.data.shadowedRange.start
+    || replacement.surfaceOp.endSeq !== manifest.data.shadowedRange.end
     || !sameNumbers(
       replacement.sourceEventSeqs,
       [manifest.seq, ...manifest.data.shadowedSeqs],

package/packages/selector/src/runtime/tokenpilot/estimator.ts

@@ -118,6 +118,36 @@ export class Estimator {
     }
   }
 
+  /**
+   * Resolve the host LLM route. Explicit estimator provider/model win; with
+   * them empty, reuse the route the harness already has configured via the
+   * optional `agentDefaultModel` service's current selection (same seam as
+   * dsh-prime-memory's resolveModelRoute) — the user must not re-enter a
+   * provider/model the host already knows.
+   */
+  private resolveHostRoute(): { provider: string, model: string } | undefined {
+    const provider = this.options.estimatorProvider ?? ''
+    const model = this.options.estimatorModel ?? ''
+    if (provider.length > 0 && model.length > 0) return { provider, model }
+    try {
+      const defaults = this.ctx.get('agentDefaultModel' as never) as
+        | { currentSelection?: () => { provider?: string, model?: string } | undefined }
+        | undefined
+      const selected = defaults?.currentSelection?.()
+      const selectedProvider = selected?.provider ?? ''
+      const selectedModel = selected?.model ?? ''
+      if (selectedProvider.length > 0 && selectedModel.length > 0) {
+        return {
+          provider: provider.length > 0 ? provider : selectedProvider,
+          model: model.length > 0 ? model : selectedModel,
+        }
+      }
+    } catch {
+      // optional service; absence must not throw
+    }
+    return undefined
+  }
+
   private async askHost(system: string, user: string, signal: AbortSignal): Promise<string | undefined> {
     let llm: HostLlmLike | undefined
     try {
@@ -126,9 +156,10 @@ export class Estimator {
       return undefined
     }
     if (llm?.stream === undefined) return undefined
-    const provider = this.options.estimatorProvider ?? ''
-    const model = this.options.estimatorModel ?? ''
-    if (provider.length === 0 || model.length === 0) return undefined
+    const route = this.resolveHostRoute()
+    if (route === undefined) return undefined
+    const provider = route.provider
+    const model = route.model
     let text = ''
     const stream = llm.stream({
       provider,

package/packages/selector/src/runtime/types.ts

@@ -1,4 +1,4 @@
-import type { CallId } from '@deepseek-ai/dsh-llm'
+import type { ToolCallId as CallId } from '@deepseek-ai/dsh-llm'
 
 /** User-facing mixed strategy profile. */
 export const COMPRESSION_PROFILES = [

package/packages/selector/tests/auto-compact.client.spec.tsx

@@ -115,8 +115,6 @@ function mountAutoCompact(options: MountOptions = {}) {
     saveCustom: vi.fn(() => Promise.resolve()),
     resetCustom: vi.fn(() => Promise.resolve()),
     saveAutoCompact,
-    saveCodeSkeleton: vi.fn(() => Promise.resolve()),
-    savePresetOptions: vi.fn(() => Promise.resolve()),
     t,
   } as unknown as CompressionProfileSelectorProps)} />)
   return { state, saveAutoCompact }
@@ -139,17 +137,6 @@ describe('Auto Compact threshold controls', () => {
     expect(screen.getByText(/Auto Compact threshold: 80%/)).not.toBeNull()
   })
 
-  // Regression guard: the settings surface must keep BOTH section-level gates.
-  // A refactor once dropped CodeSkeletonControls from the settings section while
-  // leaving the injected save path intact, so the code-skeleton save contract
-  // stayed green with the control missing from the UI.
-  it('keeps the code-skeleton gate alongside the Auto Compact editor in the settings section', () => {
-    mountAutoCompact({ settingsSection: true })
-    expect(screen.getByRole('heading', { name: en['codeSkeleton.title'] })).not.toBeNull()
-    expect(screen.getByLabelText(en['codeSkeleton.enabled'])).not.toBeNull()
-    expect(screen.getByRole('heading', { name: en['autoCompact.title'] })).not.toBeNull()
-  })
-
   it('saves a non-quick value like 73 and reads the same value back after remount', async () => {
     const saving = vi.fn((thresholdPercent: number): Promise<void> => {
       mounted.state.update(draft => {

package/packages/selector/tests/built/client-artifact.spec.ts

@@ -34,7 +34,11 @@ describe('built Harness client artifact', () => {
     }) as { apply?: unknown, inject?: unknown }
 
     expect(exported.apply).toBeTypeOf('function')
-    expect(exported.inject).toEqual(['slots', 'locale', 'settingsScope'])
+    // 0.1.5 declares only the always-present `slots` service: `locale` and
+    // `settingsScope` are resolved lazily inside apply, because a declarative
+    // inject of an absent or late service suspends apply forever and the whole
+    // UI disappears without a trace.
+    expect(exported.inject).toEqual(['slots'])
     const style = document.querySelector<HTMLStyleElement>(
       'style[data-plugin-css="dsh-context-compression-improved/CompressionProfileSelector.module.css"]',
     )

package/packages/selector/tests/code-skeleton.client.spec.ts

@@ -1,5 +1,6 @@
 import { describe, expect, it, vi } from 'vitest'
-import type { ClientContext, SettingsScopeSnapshot } from '@deepseek-ai/dsh-client-runtime/client'
+import type { Context as ClientContext } from '@deepseek-ai/cordis'
+import type { SettingsScopeSnapshot } from '@deepseek-ai/dsh-client-ui-settings/client'
 import { DEFAULT_CUSTOM_COMPRESSION_POLICY } from '../src/profiles.ts'
 import { apply } from '../src/client/index.ts'
 import type {

package/packages/selector/tests/custom-contract.client.spec.ts

@@ -1,5 +1,6 @@
 import { describe, expect, it, vi } from 'vitest'
-import type { ClientContext, SettingsScopeSnapshot } from '@deepseek-ai/dsh-client-runtime/client'
+import type { Context as ClientContext } from '@deepseek-ai/cordis'
+import type { SettingsScopeSnapshot } from '@deepseek-ai/dsh-client-ui-settings/client'
 import {
   DEFAULT_CUSTOM_COMPRESSION_POLICY,
   isCustomCompressionPolicy,

package/packages/selector/tests/estimator-channel.client.spec.tsx

@@ -15,6 +15,16 @@ afterEach(() => {
   vi.unstubAllGlobals()
 })
 
+interface SettingsScopeSnapshot<T> {
+  status: 'loading' | 'ready' | 'unavailable'
+  value: T | undefined
+  base: T | undefined
+  user: T | undefined
+  revision: number | undefined
+  writable: boolean
+  mode: 'host' | 'memory'
+}
+
 interface SnapshotStore<T> {
   readonly getSnapshot: () => T
   readonly subscribe: (listener: () => void) => () => void
@@ -82,10 +92,10 @@ function mountEstimator(
   presetOptions: ContextCompressionSettings['presetOptions'],
   options: { readonly catalog?: unknown, readonly profile?: ContextCompressionSettings['profile'] } = {},
 ) {
-  const state = createSnapshotStore({
-    status: 'ready' as const,
+  const state = createSnapshotStore<SettingsScopeSnapshot<ContextCompressionSettings>>({
+    status: 'ready',
     value: {
-      profile: options.profile ?? ('tokenpilot-inspired' as const),
+      profile: options.profile ?? 'tokenpilot-inspired',
       custom: structuredClone(DEFAULT_CUSTOM),
       autoCompact: { thresholdPercent: 80 },
       codeSkeleton: { enabled: false },
@@ -95,12 +105,7 @@ function mountEstimator(
     user: undefined,
     revision: 0,
     writable: true,
-    mode: 'host' as const,
-  })
-  const sessions = createSnapshotStore({
-    ids: ['s1'],
-    byId: { s1: { id: 's1', agentPreset: 'standard' } },
-    current: 's1',
+    mode: 'host',
   })
   const savePresetOptions = vi.fn(() => Promise.resolve())
   if (options.catalog !== undefined) {
@@ -111,7 +116,6 @@ function mountEstimator(
   }
   render(<ContextCompressionSettingsSection {...({
     useCompression: bindSnapshotSelector(state),
-    useSessions: bindSnapshotSelector(sessions),
     select: vi.fn(() => Promise.resolve()),
     saveCustom: vi.fn(() => Promise.resolve()),
     resetCustom: vi.fn(() => Promise.resolve()),
@@ -188,7 +192,8 @@ describe('estimator channel card', () => {
     const { savePresetOptions } = mountEstimator({ estimatorMode: 'host' })
 
     const provider = screen.getByLabelText<HTMLInputElement>(PROVIDER_LABEL)
-    expect(screen.getByLabelText(MODEL_LABEL).tagName).toBe('INPUT')
+    // The model field stays present and editable without a served catalog.
+    expect(screen.getByLabelText<HTMLInputElement>(MODEL_LABEL)).toBeTruthy()
     expect(document.querySelectorAll('#estimator-provider-options option').length).toBe(0)
     expect(document.querySelectorAll('#estimator-model-options option').length).toBe(0)
     fireEvent.change(provider, { target: { value: 'manual-group' } })

package/packages/selector/tests/estimator-route-registration.host.spec.ts

@@ -173,4 +173,16 @@ describe('estimator catalog route registration', () => {
     expect(response.status).toBe(200)
     expect(JSON.parse(String(response.body))).toMatchObject({ ok: true, providers: [] })
   })
+
+  it('registers no route when the row does not opt in', async () => {
+    const routes: RegisteredRoute[] = []
+    const runtime = new Context()
+    ctx = runtime
+    await mountWebServer(runtime, routes)
+
+    apply(runtime, { presetOverlay: false })
+    await settle()
+
+    expect(routes).toHaveLength(0)
+  })
 })

package/packages/selector/tests/host-preset-overlay.host.spec.ts

@@ -5,13 +5,15 @@ import { Context, Service } from '@deepseek-ai/cordis'
 import type { AgentPreset } from '@deepseek-ai/dsh-agent-presets'
 import {
   SettingsProvider,
-  settingsNamespace,
   type SettingsNamespace,
 } from '@deepseek-ai/dsh-settings'
 import { afterEach, describe, expect, it } from 'vitest'
 import { apply } from '../src/index.ts'
 import type { OverlayableAgentPresets } from '../src/preset-overlay.ts'
 
+// 0.1.5 removed the settingsNamespace() wrapper; namespaces are validated at runtime.
+const nsBrand = (value: string): SettingsNamespace => value as unknown as SettingsNamespace
+
 let root: string | undefined
 let ctx: Context | undefined
 
@@ -97,7 +99,7 @@ describe('context compression selector Host preset integration', () => {
     const builtIn = ctx.plugin({ apply })
     await builtIn.await()
 
-    const namespace = settingsNamespace('context-compression')
+    const namespace = nsBrand('context-compression')
     const service = ctx.agentPresets as unknown as OverlayableAgentPresets
     expect((await service.mount({})).path).toBe(preset.path)
     expect(ctx.settings.describe().filter(row => row.ns === namespace)).toHaveLength(1)
@@ -133,7 +135,7 @@ describe('context compression selector Host preset integration', () => {
     await ctx.plugin(FakeAgentPresets, preset).await()
     // A settings-owning row must register the namespace before the update.
     await ctx.plugin({ apply }).await()
-    const namespace = settingsNamespace('context-compression')
+    const namespace = nsBrand('context-compression')
     await ctx.settings.update(namespace, { autoCompact: { thresholdPercent: 73 } })
 
     const bundle = ctx.plugin({ apply: (child) => {
@@ -179,7 +181,7 @@ describe('context compression selector Host preset integration', () => {
     await ctx.plugin(FakeAgentPresets, preset).await()
     // A settings-owning row must register the namespace before the update.
     await ctx.plugin({ apply }).await()
-    const namespace = settingsNamespace('context-compression')
+    const namespace = nsBrand('context-compression')
     await ctx.settings.update(namespace, { autoCompact: { thresholdPercent: 70 } })
 
     const bundle = ctx.plugin({ apply: (child) => {