test: update conversation assembly coverage and docs

packages/compact/command-compact/tests/command-compact.spec.ts

@@ -4,6 +4,7 @@ import Loader from '@cordisjs/plugin-loader'
 import type { Agent } from '@deepseek-ai/dsh-agent'
 import CommandService, { type CommandResult } from '@deepseek-ai/dsh-commands'
 import {
+  CompactionId,
   CompactService,
   ManualCompactionError,
   type CompactAgentContext,
@@ -14,7 +15,10 @@ import {
 import { Session, SessionId } from '@deepseek-ai/dsh-session'
 import * as commandCompact from '@deepseek-ai/dsh-command-compact'
 
+const COMPACTION_ID = CompactionId('command-compact-test')
+
 const RESULT: CompactionResult = {
+  compactionId: COMPACTION_ID,
   startSeq: 1,
   summarySeq: 2,
   endSeq: 3,
@@ -45,18 +49,28 @@ class StubCompactService extends CompactService {
   override compactNow(
     agent: ManualCompactAgentContext,
     signal: AbortSignal,
+    sourceCommandId?: Parameters<CompactService['compactNow']>[2],
   ): Promise<CompactionResult | null> {
     this.calls.push({ agent, signal })
     if (this.operation !== undefined) return this.operation()
     return this.failure === undefined
-      ? Promise.resolve(this.result === null ? null : this.appendResult(agent, this.result))
+      ? Promise.resolve(this.result === null ? null : this.appendResult(agent, this.result, sourceCommandId))
       // oxlint-disable-next-line typescript/prefer-promise-reject-errors -- exercise arbitrary backend rejection values.
       : Promise.reject(this.failure)
   }
 
-  private appendResult(agent: ManualCompactAgentContext, result: CompactionResult): CompactionResult {
-    agent.session.append('compact/start', { turn: null })
+  private appendResult(
+    agent: ManualCompactAgentContext,
+    result: CompactionResult,
+    sourceCommandId: Parameters<CompactService['compactNow']>[2],
+  ): CompactionResult {
+    const provenance = {
+      compactionId: result.compactionId,
+      ...sourceCommandId === undefined ? {} : { sourceCommandId },
+    }
+    agent.session.append('compact/start', { ...provenance, turn: null })
     agent.session.append('compact/summary', {
+      ...provenance,
       summary: result.summary,
       shadowedRange: result.shadowedRange,
       shadowedSeqs: result.shadowedSeqs,
@@ -64,8 +78,8 @@ class StubCompactService extends CompactService {
       provider: 'command-test',
       model: 'command-test',
     })
-    agent.session.append('compact/end', { turn: null })
-    return result
+    agent.session.append('compact/end', { ...provenance, turn: null })
+    return { ...result, ...provenance }
   }
 }
 

packages/compact/command-compact/tests/loader-composition.spec.ts

@@ -9,6 +9,7 @@ import Include from '@cordisjs/plugin-include'
 import type { Agent } from '@deepseek-ai/dsh-agent'
 import CommandService from '@deepseek-ai/dsh-commands'
 import {
+  CompactionId,
   CompactService,
   type CompactAgentContext,
   type CompactionResult,
@@ -18,7 +19,10 @@ import {
 import * as commandCompact from '@deepseek-ai/dsh-command-compact'
 import { Session, SessionId } from '@deepseek-ai/dsh-session'
 
+const COMPACTION_ID = CompactionId('loader-command-compact-test')
+
 const RESULT: CompactionResult = {
+  compactionId: COMPACTION_ID,
   startSeq: 1,
   summarySeq: 2,
   endSeq: 3,
@@ -44,9 +48,15 @@ class LoaderCompactService extends CompactService {
   override compactNow(
     agent: ManualCompactAgentContext,
     _signal: AbortSignal,
+    sourceCommandId?: Parameters<CompactService['compactNow']>[2],
   ): Promise<CompactionResult | null> {
-    agent.session.append('compact/start', { turn: null })
+    const provenance = {
+      compactionId: RESULT.compactionId,
+      ...sourceCommandId === undefined ? {} : { sourceCommandId },
+    }
+    agent.session.append('compact/start', { ...provenance, turn: null })
     agent.session.append('compact/summary', {
+      ...provenance,
       summary: RESULT.summary,
       shadowedRange: RESULT.shadowedRange,
       shadowedSeqs: RESULT.shadowedSeqs,
@@ -54,8 +64,8 @@ class LoaderCompactService extends CompactService {
       provider: 'loader-test',
       model: 'loader-test',
     })
-    agent.session.append('compact/end', { turn: null })
-    return Promise.resolve(RESULT)
+    agent.session.append('compact/end', { ...provenance, turn: null })
+    return Promise.resolve({ ...RESULT, ...provenance })
   }
 }
 
@@ -132,11 +142,17 @@ describe('command-compact real Loader composition', () => {
       },
       {
         type: 'compact/start',
-        data: { turn: null },
+        data: {
+          compactionId: COMPACTION_ID,
+          sourceCommandId: execution.commandId,
+          turn: null,
+        },
       },
       {
         type: 'compact/summary',
         data: {
+          compactionId: COMPACTION_ID,
+          sourceCommandId: execution.commandId,
           summary: RESULT.summary,
           shadowedRange: RESULT.shadowedRange,
           shadowedSeqs: RESULT.shadowedSeqs,
@@ -147,7 +163,11 @@ describe('command-compact real Loader composition', () => {
       },
       {
         type: 'compact/end',
-        data: { turn: null },
+        data: {
+          compactionId: COMPACTION_ID,
+          sourceCommandId: execution.commandId,
+          turn: null,
+        },
       },
       {
         type: 'command/done',