dsh-context-compression-improved 0.2.1 → 0.3.0

package/packages/selector/tests/runtime/public/public-runtime.spec.ts

@@ -1,7 +1,7 @@
 import { afterEach, describe, expect, it, vi } from 'vitest'
 import { Context } from '@deepseek-ai/cordis'
 import {
-  CallId,
+  ToolCallId as CallId,
   createMessage,
   createUserMessage,
   createToolResultMessage,
@@ -18,25 +18,26 @@ import BasicCompactionEngine from '@deepseek-ai/dsh-compaction-basic'
 import SessionStore, {
   Session,
   SessionId,
+  SessionSeq,
   canonicalHeader,
 } from '@deepseek-ai/dsh-session'
 import {
   agentEvents,
-  Inbox,
   type Agent,
 } from '@deepseek-ai/dsh-agent'
 import {
   SettingsProvider,
-  settingsNamespace,
   type SettingsNamespace,
 } from '@deepseek-ai/dsh-settings'
 import SystemPrompt from '@deepseek-ai/dsh-system-prompt'
+import SessionProjectionRegistry from '@deepseek-ai/dsh-session-projection'
 import TokenMeter from '@deepseek-ai/dsh-token-meter'
 import ToolRuntime from '@deepseek-ai/dsh-tools'
 import { CompactionId } from '@deepseek-ai/dsh-compaction'
 import InvariantRegistry from '@deepseek-ai/dsh-invariants'
 import * as SelectorHost from '../../../src/index.ts'
 import * as RuntimeInvariant from '../../../src/invariant.ts'
+import { sessionEvents } from '../../../src/runtime/session-events.ts'
 import ToolResultPruner, {
   CONTEXT_COMPRESSION_SETTINGS_NAMESPACE,
   DEFAULT_CUSTOM_COMPRESSION_POLICY,
@@ -130,10 +131,11 @@ class NativeSummaryAdapter extends LlmAdapter {
 async function runtimeContext(): Promise<Context> {
   const ctx = new Context()
   activeContexts.push(ctx)
-  await ctx.plugin(SessionStore)
-  await ctx.plugin(SystemPrompt)
-  await ctx.plugin(ToolRuntime)
-  await ctx.plugin(TokenMeter)
+  await ctx.plugin(SessionStore).await()
+  await ctx.plugin(SystemPrompt).await()
+  await ctx.plugin(ToolRuntime).await()
+  await ctx.plugin(SessionProjectionRegistry).await()
+  await ctx.plugin(TokenMeter).await()
   return ctx
 }
 
@@ -180,6 +182,7 @@ function appendToolTurn(
   }
   session.append('step/start', { turn, step: 1 })
   const assistant = session.append('assistant/message', {
+      stream: [],
     turn,
     step: 1,
     message: createMessage({
@@ -229,6 +232,7 @@ function appendToolBatchTurn(
   }
   session.append('step/start', { turn, step: 1 })
   const assistant = session.append('assistant/message', {
+      stream: [],
     turn,
     step: 1,
     message: createMessage({
@@ -267,12 +271,18 @@ function appendToolBatchTurn(
   return { assistantSeq: assistant.seq, resultSeqs }
 }
 
+// 0.1.5 removed the settingsNamespace() wrapper; namespaces are branded
+// strings validated at runtime by SettingsProvider.parse.
+const nsBrand = (value: string): SettingsNamespace => value as unknown as SettingsNamespace
+
 function stubAgent(ctx: Context, session: Session): Agent {
   return {
     id: session.id,
     options: {},
     session,
-    inbox: new Inbox(session, { inserted: () => {}, discarded: () => {}, claimed: () => {} }),
+    // 0.1.5 moved the durable Inbox behind the loop driver; the pruner only
+    // reads id/session, so an inert face is enough for the stub.
+    inbox: undefined as unknown as Agent['inbox'],
     status: 'idle',
     ctx,
     send: () => {},
@@ -350,16 +360,16 @@ describe('standalone runtime on published Harness APIs', () => {
     const result = pruner.pruneSession(session, { stage: 'pressure' })
 
     expect(result.pruned).toHaveLength(1)
-    const manifest = session.events.at(-2)
-    const replacement = session.events.at(-1)
+    const manifest = sessionEvents(session).at(-2)
+    const replacement = sessionEvents(session).at(-1)
     expect(manifest?.type).toBe('compaction/prune')
-    expect(session.events.some(event => event.type === ('compaction/group-trim' as string))).toBe(false)
+    expect(sessionEvents(session).some(event => event.type === ('compaction/group-trim' as string))).toBe(false)
     expect(replacement?.type).toBe('tool/result')
     if (replacement?.type !== 'tool/result') throw new Error('Native prune did not append a tool result replacement')
     expect(replacement.surfaceOp).toEqual({
       op: 'replace',
-      start: source.resultSeq,
-      end: source.resultSeq,
+      startSeq: source.resultSeq,
+      endSeq: source.resultSeq,
     })
     expect(replacement.sourceEventSeqs).toContain(source.resultSeq)
     expect(rewrites(audit.records())).toContainEqual(expect.objectContaining({
@@ -521,7 +531,7 @@ describe('standalone runtime on published Harness APIs', () => {
     await ctx.plugin(TestSettings).await()
     await ctx.plugin(SelectorHost).await()
     const audit = captureAudit(ctx)
-    const namespace = settingsNamespace(CONTEXT_COMPRESSION_SETTINGS_NAMESPACE)
+    const namespace = nsBrand(CONTEXT_COMPRESSION_SETTINGS_NAMESPACE)
 
     // A high threshold delays the micro-compact last-chance gate past the old
     // fixed 0.7 ratio: pressure between 0.7*C and D must NOT age history.
@@ -557,7 +567,7 @@ describe('standalone runtime on published Harness APIs', () => {
     await ctx.plugin(TestSettings).await()
     await ctx.plugin(SelectorHost).await()
     const audit = captureAudit(ctx)
-    const namespace = settingsNamespace(CONTEXT_COMPRESSION_SETTINGS_NAMESPACE)
+    const namespace = nsBrand(CONTEXT_COMPRESSION_SETTINGS_NAMESPACE)
 
     // A low threshold pulls the micro-compact deadline below the old fixed
     // 0.7 ratio: pressure between D and 0.7*C must age history now.
@@ -591,7 +601,7 @@ describe('standalone runtime on published Harness APIs', () => {
     await ctx.plugin(TestSettings).await()
     await ctx.plugin(SelectorHost).await()
     const audit = captureAudit(ctx)
-    const namespace = settingsNamespace(CONTEXT_COMPRESSION_SETTINGS_NAMESPACE)
+    const namespace = nsBrand(CONTEXT_COMPRESSION_SETTINGS_NAMESPACE)
     // The preset overlay captured 70% into this generation's deployment
     // config; the user then moved the global setting to 90 before the first
     // prune. Auto Compact and micro compact must both stay on 70%.
@@ -627,7 +637,7 @@ describe('standalone runtime on published Harness APIs', () => {
     await ctx.plugin(TestSettings).await()
     await ctx.plugin(SelectorHost).await()
     const audit = captureAudit(ctx)
-    const namespace = settingsNamespace(CONTEXT_COMPRESSION_SETTINGS_NAMESPACE)
+    const namespace = nsBrand(CONTEXT_COMPRESSION_SETTINGS_NAMESPACE)
     // A hand-edited store can surface a document the schema rejects (unknown
     // top-level key). The runtime must not fall back to a lossy-capable
     // profile: the session freezes effectively off and keeps every original
@@ -677,7 +687,7 @@ describe('standalone runtime on published Harness APIs', () => {
     await ctx.plugin(TestSettings).await()
     await ctx.plugin(SelectorHost).await()
     const audit = captureAudit(ctx)
-    const namespace = settingsNamespace(CONTEXT_COMPRESSION_SETTINGS_NAMESPACE)
+    const namespace = nsBrand(CONTEXT_COMPRESSION_SETTINGS_NAMESPACE)
     // Schemastery `.default(...)` would silently replace these present-but-null
     // sections with the balanced/default-v3 policy; the runtime must reject the
     // document and freeze the session losslessly instead.
@@ -714,7 +724,7 @@ describe('standalone runtime on published Harness APIs', () => {
     await ctx.plugin(TestSettings).await()
     await ctx.plugin(SelectorHost).await()
     const audit = captureAudit(ctx)
-    const namespace = settingsNamespace(CONTEXT_COMPRESSION_SETTINGS_NAMESPACE)
+    const namespace = nsBrand(CONTEXT_COMPRESSION_SETTINGS_NAMESPACE)
     const malformed = {
       profile: 'balanced' as const,
       custom: structuredClone(DEFAULT_CUSTOM_COMPRESSION_POLICY),
@@ -814,7 +824,7 @@ describe('standalone runtime on published Harness APIs', () => {
     await ctx.plugin(TestSettings).await()
     await ctx.plugin(SelectorHost).await()
     const audit = captureAudit(ctx)
-    const namespace = settingsNamespace(CONTEXT_COMPRESSION_SETTINGS_NAMESPACE)
+    const namespace = nsBrand(CONTEXT_COMPRESSION_SETTINGS_NAMESPACE)
     await ctx.settings.update(namespace, { autoCompact: { thresholdPercent: 73 } })
     await ctx.plugin(ToolResultPruner, { profile: 'balanced' }).await()
     const session = Session.create(SessionId('public-autocompact-coordination'))
@@ -911,7 +921,7 @@ describe('standalone runtime on published Harness APIs', () => {
     await ctx.plugin(TestSettings).await()
     await ctx.plugin(SelectorHost).await()
     const audit = captureAudit(ctx)
-    const namespace = settingsNamespace(CONTEXT_COMPRESSION_SETTINGS_NAMESPACE)
+    const namespace = nsBrand(CONTEXT_COMPRESSION_SETTINGS_NAMESPACE)
     await ctx.plugin(ToolResultPruner, { profile: 'balanced' }).await()
 
     const first = Session.create(SessionId('public-autocompact-freeze-first'))
@@ -975,6 +985,7 @@ describe('standalone runtime on published Harness APIs', () => {
     }), { surfaceOp: 'append' })
     session.append('step/start', { turn: 1, step: 1 })
     session.append('assistant/message', {
+      stream: [],
       turn: 1,
       step: 1,
       message: createMessage({
@@ -1002,7 +1013,7 @@ describe('standalone runtime on published Harness APIs', () => {
 
     const before = measureForCompaction(ctx, session)
     const toolResultTokens = before.measuredNodes
-      .filter(node => session.events[node.seq]?.type === 'tool/result')
+      .filter(node => sessionEvents(session)[node.seq]?.type === 'tool/result')
       .reduce((sum, node) => sum + (node.count.kind === 'exact-tokenizer' ? node.count.tokens : 0), 0)
     // Deadline D = 7000 is reached by the complete request, not by the tool
     // results, which stay far below every trigger in force.
@@ -1175,6 +1186,7 @@ describe('standalone runtime on published Harness APIs', () => {
     session.append('turn/start', { turn })
     session.append('step/start', { turn, step: 1 })
     session.append('assistant/message', {
+      stream: [],
       turn,
       step: 1,
       message: createMessage({
@@ -1224,6 +1236,7 @@ describe('standalone runtime on published Harness APIs', () => {
     })
     onlyUnsafe.append('step/start', { turn: 1, step: 1 })
     onlyUnsafe.append('assistant/message', {
+      stream: [],
       turn: 1,
       step: 1,
       message: createMessage({
@@ -1382,9 +1395,10 @@ describe('standalone runtime on published Harness APIs', () => {
   it('audits recovery-tool-unavailable when a committed batch cannot land without the recovery tool', async () => {
     const ctx = new Context()
     activeContexts.push(ctx)
-    await ctx.plugin(SessionStore)
-    await ctx.plugin(SystemPrompt)
-    await ctx.plugin(TokenMeter)
+    await ctx.plugin(SessionStore).await()
+    await ctx.plugin(SystemPrompt).await()
+    await ctx.plugin(SessionProjectionRegistry).await()
+    await ctx.plugin(TokenMeter).await()
     const audit = captureAudit(ctx)
     await ctx.plugin(ToolResultPruner, {
       profile: 'balanced',
@@ -1435,7 +1449,7 @@ describe('standalone runtime on published Harness APIs', () => {
     }
     custom.prefixPolicy = 'pressure-break'
     custom.tailTrim = { enabled: false, trigger: 700_000 }
-    await ctx.settings.update(settingsNamespace(CONTEXT_COMPRESSION_SETTINGS_NAMESPACE), {
+    await ctx.settings.update(nsBrand(CONTEXT_COMPRESSION_SETTINGS_NAMESPACE), {
       profile: 'custom',
       custom,
     })
@@ -1520,7 +1534,7 @@ describe('standalone runtime on published Harness APIs', () => {
     activeContexts.push(ctx)
     await mountAgentLoopTestDependencies(ctx)
     await ctx.plugin(AgentLoop, { agents: [] })
-    await ctx.plugin(TokenMeter)
+    await ctx.plugin(TokenMeter).await()
     const audit = captureAudit(ctx)
     ctx.llm.registerAdapter(
       ['deepseek'],
@@ -1538,7 +1552,7 @@ describe('standalone runtime on published Harness APIs', () => {
       historyMinReclaimTokens: 1,
     }).await()
 
-    const agent = ctx.agentLoop.create(SessionId('public-history-capacity-request-boundary'), {
+    const agent = await ctx.agentLoop.create(SessionId('public-history-capacity-request-boundary'), {
       provider: 'deepseek',
       model: MODEL,
     })
@@ -1604,10 +1618,11 @@ describe('standalone runtime on published Harness APIs', () => {
     activeContexts.push(ctx)
     await ctx.plugin(TestSettings).await()
     await ctx.plugin(SelectorHost).await()
-    await ctx.plugin(SessionStore)
-    await ctx.plugin(SystemPrompt)
-    await ctx.plugin(ToolRuntime)
-    await ctx.plugin(TokenMeter)
+    await ctx.plugin(SessionStore).await()
+    await ctx.plugin(SystemPrompt).await()
+    await ctx.plugin(ToolRuntime).await()
+    await ctx.plugin(SessionProjectionRegistry).await()
+    await ctx.plugin(TokenMeter).await()
     const audit = captureAudit(ctx)
 
     const firstCustom = structuredClone(DEFAULT_CUSTOM_COMPRESSION_POLICY) as CustomCompressionPolicy
@@ -1615,7 +1630,7 @@ describe('standalone runtime on published Harness APIs', () => {
     firstCustom.aggregate.enabled = false
     firstCustom.history.enabled = false
     if (firstCustom.version === 3) firstCustom.tailTrim.enabled = false
-    const namespace = settingsNamespace(CONTEXT_COMPRESSION_SETTINGS_NAMESPACE)
+    const namespace = nsBrand(CONTEXT_COMPRESSION_SETTINGS_NAMESPACE)
     await ctx.settings.update(namespace, { profile: 'custom', custom: firstCustom })
     await ctx.plugin(ToolResultPruner, {
       profile: 'off',
@@ -1665,10 +1680,11 @@ describe('standalone runtime on published Harness APIs', () => {
     activeContexts.push(ctx)
     await ctx.plugin(TestSettings).await()
     await ctx.plugin(SelectorHost).await()
-    await ctx.plugin(SessionStore)
-    await ctx.plugin(SystemPrompt)
-    await ctx.plugin(ToolRuntime)
-    await ctx.plugin(TokenMeter)
+    await ctx.plugin(SessionStore).await()
+    await ctx.plugin(SystemPrompt).await()
+    await ctx.plugin(ToolRuntime).await()
+    await ctx.plugin(SessionProjectionRegistry).await()
+    await ctx.plugin(TokenMeter).await()
     const audit = captureAudit(ctx)
 
     const policy = structuredClone(DEFAULT_CUSTOM_COMPRESSION_POLICY) as CustomCompressionPolicy
@@ -1681,7 +1697,7 @@ describe('standalone runtime on published Harness APIs', () => {
     policy.history.keepRecentTokens = 0
     policy.history.minReclaim = 1
     policy.tailTrim = { enabled: true, trigger: 8 }
-    await ctx.settings.update(settingsNamespace(CONTEXT_COMPRESSION_SETTINGS_NAMESPACE), {
+    await ctx.settings.update(nsBrand(CONTEXT_COMPRESSION_SETTINGS_NAMESPACE), {
       profile: 'custom',
       custom: policy,
     })
@@ -1697,7 +1713,7 @@ describe('standalone runtime on published Harness APIs', () => {
 
     pruner.pruneSession(session, { stage: 'pressure' })
 
-    const manifest = session.events.findLast(event => event.type === 'compaction/prune')
+    const manifest = sessionEvents(session).findLast(event => event.type === 'compaction/prune')
     expect(manifest?.type).toBe('compaction/prune')
     if (manifest?.type !== 'compaction/prune') throw new Error('TailTrim did not publish a standard prune')
     const publication = validatePublishedTailTrim(session, manifest.seq)
@@ -1732,7 +1748,7 @@ describe('standalone runtime on published Harness APIs', () => {
     expect(recoveredText).toContain('kind: tailtrim-group')
     expect(recoveredText).toContain('old candidate result')
 
-    const persistedEvents = JSON.parse(JSON.stringify(session.events))
+    const persistedEvents = JSON.parse(JSON.stringify(sessionEvents(session)))
     const replay = Session.create(session.id, persistedEvents)
     const replayPublication = validatePublishedTailTrim(replay, manifest.seq)
     expect(replayPublication?.ref).toBe(publication?.ref)
@@ -1760,10 +1776,11 @@ describe('standalone runtime on published Harness APIs', () => {
       activeContexts.push(ctx)
       await ctx.plugin(TestSettings).await()
       await ctx.plugin(SelectorHost).await()
-      await ctx.plugin(SessionStore)
-      await ctx.plugin(SystemPrompt)
-      await ctx.plugin(ToolRuntime)
-      await ctx.plugin(TokenMeter)
+      await ctx.plugin(SessionStore).await()
+      await ctx.plugin(SystemPrompt).await()
+      await ctx.plugin(ToolRuntime).await()
+      await ctx.plugin(SessionProjectionRegistry).await()
+      await ctx.plugin(TokenMeter).await()
       const audit = captureAudit(ctx)
 
       const policy = structuredClone(DEFAULT_CUSTOM_COMPRESSION_POLICY) as CustomCompressionPolicy
@@ -1776,7 +1793,7 @@ describe('standalone runtime on published Harness APIs', () => {
       policy.history.keepRecentTokens = 0
       policy.history.minReclaim = options.minReclaim
       policy.tailTrim = { enabled: true, trigger: options.trigger }
-      await ctx.settings.update(settingsNamespace(CONTEXT_COMPRESSION_SETTINGS_NAMESPACE), {
+      await ctx.settings.update(nsBrand(CONTEXT_COMPRESSION_SETTINGS_NAMESPACE), {
         profile: 'custom',
         custom: policy,
       })
@@ -1842,12 +1859,13 @@ describe('standalone runtime on published Harness APIs', () => {
     activeContexts.push(ctx)
     await ctx.plugin(TestSettings).await()
     await ctx.plugin(SelectorHost).await()
-    await ctx.plugin(SessionStore)
-    await ctx.plugin(InvariantRegistry)
-    await ctx.plugin(RuntimeInvariant)
-    await ctx.plugin(SystemPrompt)
-    await ctx.plugin(ToolRuntime)
-    await ctx.plugin(TokenMeter)
+    await ctx.plugin(SessionStore).await()
+    await ctx.plugin(InvariantRegistry).await()
+    await ctx.plugin(RuntimeInvariant).await()
+    await ctx.plugin(SystemPrompt).await()
+    await ctx.plugin(ToolRuntime).await()
+    await ctx.plugin(SessionProjectionRegistry).await()
+    await ctx.plugin(TokenMeter).await()
     const audit = captureAudit(ctx)
 
     const policy = structuredClone(DEFAULT_CUSTOM_COMPRESSION_POLICY) as CustomCompressionPolicy
@@ -1859,7 +1877,7 @@ describe('standalone runtime on published Harness APIs', () => {
     policy.history.keepRecentTokens = 0
     policy.history.minReclaim = 1
     policy.tailTrim = { enabled: true, trigger: 8 }
-    await ctx.settings.update(settingsNamespace(CONTEXT_COMPRESSION_SETTINGS_NAMESPACE), {
+    await ctx.settings.update(nsBrand(CONTEXT_COMPRESSION_SETTINGS_NAMESPACE), {
       profile: 'custom',
       custom: policy,
     })
@@ -1884,27 +1902,27 @@ describe('standalone runtime on published Harness APIs', () => {
 
     expect(() => ctx.toolResultPruner.pruneSession(session, { stage: 'pressure' })).not.toThrow()
     append.mockRestore()
-    expect(session.events.at(-1)?.type).toBe('compaction/prune')
+    expect(sessionEvents(session).at(-1)?.type).toBe('compaction/prune')
     expect(session.surface.nodes).toEqual(beforeSurface)
     expect(rewrites(audit.records())).toHaveLength(0)
     expect(audit.records()).toContainEqual(expect.objectContaining({
       kind: 'failure',
       operation: 'publication',
       component: 'tail-trim',
-      manifestSeq: session.events.length - 1,
+      manifestSeq: sessionEvents(session).length - 1,
     }))
 
     expect(() => session.append('turn/end', {
       turn: 3,
       reason: { kind: 'completed' },
     })).not.toThrow()
-    const persisted = JSON.parse(JSON.stringify(session.events))
+    const persisted = JSON.parse(JSON.stringify(sessionEvents(session)))
 
     const resumedCtx = new Context()
     activeContexts.push(resumedCtx)
-    await resumedCtx.plugin(SessionStore)
-    await resumedCtx.plugin(InvariantRegistry)
-    await resumedCtx.plugin(RuntimeInvariant)
+    await resumedCtx.plugin(SessionStore).await()
+    await resumedCtx.plugin(InvariantRegistry).await()
+    await resumedCtx.plugin(RuntimeInvariant).await()
     const resumed = resumedCtx.sessions.create(session.id, { seed: persisted })
     expect(resumed.surface.nodes).toEqual(beforeSurface)
     expect(() => resumed.append('turn/start', { turn: 4 })).not.toThrow()
@@ -1913,23 +1931,23 @@ describe('standalone runtime on published Harness APIs', () => {
   it('still rejects a malformed adjacent replacement instead of treating it as an orphan', async () => {
     const ctx = new Context()
     activeContexts.push(ctx)
-    await ctx.plugin(SessionStore)
-    await ctx.plugin(InvariantRegistry)
-    await ctx.plugin(RuntimeInvariant)
+    await ctx.plugin(SessionStore).await()
+    await ctx.plugin(InvariantRegistry).await()
+    await ctx.plugin(RuntimeInvariant).await()
     const session = ctx.sessions.create(SessionId('public-malformed-companion'))
     const source = appendToolTurn(session, 1, 'source remains intact', false)
     session.append('compaction/prune', {
-      shadowedRange: { start: source.resultSeq, end: source.resultSeq },
-      shadowedSeqs: [source.resultSeq],
+      shadowedRange: { start: SessionSeq(source.resultSeq), end: SessionSeq(source.resultSeq) },
+      shadowedSeqs: [SessionSeq(source.resultSeq)],
       shadowedTokenCount: 1,
     })
-    const result = session.events[source.resultSeq]
+    const result = sessionEvents(session)[source.resultSeq]
     if (result?.type !== 'tool/result') throw new Error('missing source result')
     const before = session.seq
 
     expect(() => session.append('tool/result', result.data, {
-      surfaceOp: { op: 'replace', start: source.assistantSeq, end: source.assistantSeq },
-      sourceEventSeqs: [source.resultSeq],
+      surfaceOp: { op: 'replace', startSeq: SessionSeq(source.assistantSeq), endSeq: SessionSeq(source.assistantSeq) },
+      sourceEventSeqs: [SessionSeq(source.resultSeq)],
     })).toThrow(/sourceEventSeqs|does not replace compaction\/prune range/)
     expect(session.seq).toBe(before)
   })
@@ -1942,7 +1960,7 @@ describe('standalone runtime on published Harness APIs', () => {
     const summary = session.append('compaction/summary', {
       compactionId: CompactionId('public-native-auto'),
       summary: [{ type: 'text', text: 'summary' }],
-      shadowedRange: { start: 0, end: 0 },
+      shadowedRange: { start: SessionSeq(0), end: SessionSeq(0) },
       shadowedSeqs: [],
       shadowedTokenCount: 321,
       provider: 'deepseek',
@@ -1968,7 +1986,7 @@ describe('standalone runtime on published Harness APIs', () => {
     activeContexts.push(ctx)
     await mountAgentLoopTestDependencies(ctx)
     await ctx.plugin(AgentLoop, { agents: [] })
-    await ctx.plugin(TokenMeter)
+    await ctx.plugin(TokenMeter).await()
     const audit = captureAudit(ctx)
     ctx.llm.registerAdapter(
       ['deepseek'],
@@ -1986,7 +2004,7 @@ describe('standalone runtime on published Harness APIs', () => {
       maxTokens: 100,
       compactionRetries: 0,
     })
-    const agent = ctx.agentLoop.create(SessionId('public-native-auto-real'), {
+    const agent = await ctx.agentLoop.create(SessionId('public-native-auto-real'), {
       provider: 'deepseek',
       model: MODEL,
     })
@@ -2003,7 +2021,7 @@ describe('standalone runtime on published Harness APIs', () => {
     await agent.whenIdle()
 
     expect(rewrites(audit.records())).toHaveLength(0)
-    const summary = agent.session.events.findLast(event => event.type === 'compaction/summary')
+    const summary = sessionEvents(agent.session).findLast(event => event.type === 'compaction/summary')
     expect(summary?.type).toBe('compaction/summary')
     expect(audit.records()).toContainEqual(expect.objectContaining({
       kind: 'native-auto-compact',
@@ -2021,11 +2039,12 @@ describe('standalone runtime on published Harness APIs', () => {
     activeContexts.push(ctx)
     await ctx.plugin(TestSettings).await()
     await ctx.plugin(SelectorHost).await()
-    await ctx.plugin(LlmRuntime)
-    await ctx.plugin(SessionStore)
-    await ctx.plugin(SystemPrompt)
-    await ctx.plugin(ToolRuntime)
-    await ctx.plugin(TokenMeter)
+    await ctx.plugin(LlmRuntime).await()
+    await ctx.plugin(SessionStore).await()
+    await ctx.plugin(SystemPrompt).await()
+    await ctx.plugin(ToolRuntime).await()
+    await ctx.plugin(SessionProjectionRegistry).await()
+    await ctx.plugin(TokenMeter).await()
     const audit = captureAudit(ctx)
 
     const policy = structuredClone(DEFAULT_CUSTOM_COMPRESSION_POLICY) as CustomCompressionPolicy
@@ -2045,7 +2064,7 @@ describe('standalone runtime on published Harness APIs', () => {
     }
     policy.prefixPolicy = 'pressure-break'
     policy.tailTrim = { enabled: true, trigger: 8 }
-    await ctx.settings.update(settingsNamespace(CONTEXT_COMPRESSION_SETTINGS_NAMESPACE), {
+    await ctx.settings.update(nsBrand(CONTEXT_COMPRESSION_SETTINGS_NAMESPACE), {
       profile: 'custom',
       custom: policy,
     })
@@ -2100,7 +2119,7 @@ describe('standalone runtime on published Harness APIs', () => {
       () => Promise.resolve({ kind: 'enter' as const, messages: [] }),
     )
     expect(decision).toEqual({ kind: 'enter', messages: [] })
-    const summary = session.events.findLast(event => event.type === 'compaction/summary')
+    const summary = sessionEvents(session).findLast(event => event.type === 'compaction/summary')
     expect(summary?.type).toBe('compaction/summary')
 
     const records = audit.records()
@@ -2123,7 +2142,7 @@ describe('standalone runtime on published Harness APIs', () => {
     expect(firstIndex('history')).toBeLessThan(firstIndex('tail-trim'))
     expect(records.findIndex(record => record.kind === 'native-auto-compact'))
       .toBeGreaterThan(firstIndex('tail-trim'))
-    expect(session.events.some(event => event.type === ('compaction/group-trim' as string))).toBe(false)
+    expect(sessionEvents(session).some(event => event.type === ('compaction/group-trim' as string))).toBe(false)
   })
 
   it('compresses text tool results exactly in a vision session that also carries a user image', async () => {
@@ -2155,6 +2174,7 @@ describe('standalone runtime on published Harness APIs', () => {
     }), { surfaceOp: 'append' })
     session.append('step/start', { turn: 1, step: 1 })
     session.append('assistant/message', {
+      stream: [],
       turn: 1,
       step: 1,
       message: createMessage({
@@ -2222,6 +2242,7 @@ describe('standalone runtime on published Harness APIs', () => {
     })
     session.append('step/start', { turn: 1, step: 1 })
     session.append('assistant/message', {
+      stream: [],
       turn: 1,
       step: 1,
       message: createMessage({
@@ -2253,7 +2274,7 @@ describe('standalone runtime on published Harness APIs', () => {
     expect(fresh.pruned).toHaveLength(0)
     expect(pressure.pruned).toHaveLength(0)
     // The original image-bearing result stays on the surface untouched.
-    const original = session.events[imageResult.seq]
+    const original = sessionEvents(session)[imageResult.seq]
     expect(original?.type).toBe('tool/result')
     expect(audit.records()).toContainEqual(expect.objectContaining({
       kind: 'component-evaluation',
@@ -2460,7 +2481,7 @@ describe('standalone runtime on published Harness APIs', () => {
     await ctx.plugin(TestSettings).await()
     await ctx.plugin(SelectorHost).await()
     const audit = captureAudit(ctx)
-    await ctx.settings.update(settingsNamespace(CONTEXT_COMPRESSION_SETTINGS_NAMESPACE), {
+    await ctx.settings.update(nsBrand(CONTEXT_COMPRESSION_SETTINGS_NAMESPACE), {
       profile: 'custom',
       custom: {
         version: 3,
@@ -2481,6 +2502,7 @@ describe('standalone runtime on published Harness APIs', () => {
     })
     session.append('step/start', { turn: 1, step: 1 })
     session.append('assistant/message', {
+      stream: [],
       turn: 1,
       step: 1,
       message: createMessage({
@@ -2511,7 +2533,7 @@ describe('standalone runtime on published Harness APIs', () => {
     expect(result.pruned).toHaveLength(0)
     expect(rewrites(audit.records()).some(record =>
       record.sessionId === String(session.id) && record.component === 'tail-trim')).toBe(false)
-    expect(session.events.some(event =>
+    expect(sessionEvents(session).some(event =>
       event.type === 'tool/result'
       && event.data.message.content.some(block => block.type === 'tool-result'
         && block.content.some(inner => inner.type === 'image')))).toBe(true)

package/packages/selector/tests/runtime/session-events.spec.ts

@@ -8,7 +8,7 @@ const EVENTS = Object.freeze([
 
 describe('sessionEvents', () => {
   it('retains the rc.2 events accessor fallback', () => {
-    const session = { events: EVENTS } as Session
+    const session = { events: EVENTS } as unknown as Session
     expect(sessionEvents(session)).toBe(EVENTS)
   })
 

package/packages/selector/tests/settings-seat.client.spec.ts

@@ -0,0 +1,86 @@
+/**
+ * Settings-seat contract pin for dsh-context-compression-improved's client.
+ *
+ * This spec locks WHERE the compression settings panel mounts: exactly ONE
+ * seat — the standalone `settings.section` entry (设置 → 上下文压缩) — and
+ * explicitly NOT the Plugins-section surfaces. History this pins against: the
+ * 0.1.5 line first lost every entry (a lazy `ctx.get` of locale/settingsScope
+ * raced the settings client and apply bailed), then showed the panel twice
+ * (item card + tab on top of the standalone section). Both were fixed by the
+ * declarative-inject + single-section shape below. When a future DSH line
+ * moves the seat again, migrate src/client/index.ts AND this file together.
+ */
+import { describe, expect, it, vi } from 'vitest'
+import type { Context as ClientContext } from '@deepseek-ai/cordis'
+import { apply, inject } from '../src/client/index.ts'
+import { ContextCompressionSettingsSection } from '../src/client/CompressionProfileSelector.tsx'
+
+vi.mock('@deepseek-ai/dsh-client-ui-primitives', () => ({
+  IconChevronDownOutline14: () => null,
+  Menu: () => null,
+}))
+
+interface CapturedRegistration {
+  readonly slot: string
+  readonly options: Record<string, unknown>
+  readonly component: unknown
+}
+
+/** Drive apply against a stub host and capture every slot registration. */
+function collectRegistrations(): { declared: string[]; registrations: CapturedRegistration[] } {
+  const declared: string[] = []
+  const registrations: CapturedRegistration[] = []
+  const ctx = {
+    locale: { register: vi.fn(() => () => {}), bind: () => (key: string) => key },
+    settingsScope: { bind: vi.fn(() => ({}) as never) },
+    slots: {
+      inject: (slot: string, factory: () => (() => void) | Generator<() => void>) => {
+        declared.push(slot)
+        const result = factory()
+        const steps: Iterable<() => void> = typeof (result as IteratorObject)?.[Symbol.iterator] === 'function'
+          ? (result as Generator<() => void>)
+          : [result as () => void]
+        for (const step of steps) { void step }
+        return () => {}
+      },
+      register: (options: Record<string, unknown>, component: unknown) => {
+        registrations.push({ slot: String(options['name']), options, component })
+        return () => {}
+      },
+    },
+  }
+  apply(ctx as unknown as ClientContext)
+  return { declared, registrations }
+}
+
+describe('settings-seat contract (standalone settings.section only)', () => {
+  it('declares the services apply consumes (cordis waits; no lazy-get race)', () => {
+    expect(inject).toEqual(['slots', 'locale', 'settingsScope'])
+  })
+
+  it('injects exactly the settings.section seat and nothing else', () => {
+    const { declared, registrations } = collectRegistrations()
+    expect(declared).toEqual(['settings.section'])
+    expect(registrations).toHaveLength(1)
+    expect(registrations[0]!.slot).toBe('settings.section')
+  })
+
+  it('pins the section identity (id/order/label/locale) and the panel component', () => {
+    const { registrations } = collectRegistrations()
+    const { options, component } = registrations[0]!
+    expect(options['id']).toBe('context-compression')
+    expect(options['order']).toBe(17)
+    expect(options['locale']).toBe('context-compression')
+    expect((options['label'] as () => string)()).toBe('nav')
+    expect(typeof options['inject']).toBe('function')
+    const face = (options['inject'] as () => Record<string, unknown>)()
+    expect(Object.keys(face).sort()).toEqual(['hooks', 'saveAutoCompact', 'saveCodeSkeleton', 'saveCustom', 'savePresetOptions', 'select', 'resetCustom'].sort())
+    expect(component).toBe(ContextCompressionSettingsSection)
+  })
+
+  it('never adds a Plugins-section card or tab alongside the standalone section', () => {
+    const { declared } = collectRegistrations()
+    expect(declared).not.toContain('settings.plugins.tab')
+    expect(declared).not.toContain('settings.plugin.item')
+  })
+})