billion-context-dsh 0.2.4 → 0.3.0

package/dist/nudge.d.ts

@@ -40,6 +40,9 @@ export declare function resolveTokenCount(agent: Agent, coreMessages: CoreMessag
  * Render the compressible-range table as seq refs for the model.
  * Computed directly from the surface (not the kernel's ref map, which can
  * drift and hide large tool results) — see buildCompressibleSeqRanges.
+ * UPSTREAM: this self-computation is a labeled workaround for kernel
+ * ref-map drift after surface replacements (AGENTS.md rule 11) — drop it and
+ * use kernel compressibleRanges once the drift is fixed upstream.
  */
 export declare function rangeTable(session: import('@deepseek-ai/dsh-session').Session, prompts?: ResolvedPrompts): string;
 /**

package/dist/region.d.ts

@@ -17,6 +17,8 @@ export interface AcpBlockLedgerEntry {
     /** The compaction transaction id (stable block identity). */
     readonly blockId: string;
     readonly summary: string;
+    /** The block's short label (kernel `CompressionBlock.topic`), when the compress request carried one. */
+    readonly topic?: string;
     readonly shadowedSeqs: readonly number[];
     readonly shadowedTokenCount: number;
     readonly start: number;
@@ -92,6 +94,8 @@ export interface CompactionTransactionInput {
     readonly shadowedTokenCount: number;
     readonly provider: string;
     readonly model: string;
+    /** Short block label (kernel `CompressionBlock.topic`) — persisted so a restarted engine rehydrates it. */
+    readonly topic?: string;
     /** Compression tier of this block (default 1). */
     readonly tier?: 1 | 2 | 3;
     /** The acp-kernel block id (`bN`) created by the kernel for this transaction. */
@@ -110,6 +114,8 @@ export interface CompactionTransactionInput {
 export interface AcpCompactionSummaryFields {
     /** Compression tier (1/2/3) — 1 = message range, 2 = distills tier-1, 3 = distills tier-2. */
     readonly tier?: 1 | 2 | 3;
+    /** Short block label (kernel `CompressionBlock.topic`) — the acp_status block title. */
+    readonly topic?: string;
     /** The acp-kernel block id (`bN`) created for this transaction. */
     readonly kernelBlockId?: string;
     /** Durable compaction ids of the blocks distilled into this one. */
@@ -142,6 +148,8 @@ export interface SeqCompressibleRange {
     readonly end: number;
     readonly count: number;
     readonly tokens: number;
+    /** Share of messages that are tool messages (tool-call or tool-result), 0-100 — kernel `toolPct` parity. */
+    readonly toolPct: number;
 }
 /**
  * Hide one successful `compress` tool's call/result pair after its tool/result
@@ -192,8 +200,11 @@ export declare function deferCompressPairHide(session: Session, callId: string,
  * kernel's ref map, which can drift after surface replacements in long
  * sessions and hide large tool results from the nudge range table. Skips the
  * recent protected tail, the last user message, and compaction checkpoints;
- * edges are then balanced through resolveSurfaceRange. Ranges are ordered by
- * size (largest reclaimed first).
+ * edges are then balanced through resolveSurfaceRange. Ranges are ordered
+ * oldest-first (stable across turns — matches the kernel's `oldest first`).
+ * UPSTREAM: this self-computation is a labeled workaround for kernel
+ * ref-map drift after surface replacements (AGENTS.md rule 11) — drop it and
+ * use kernel compressibleRanges once the drift is fixed upstream.
  */
 export declare function buildCompressibleSeqRanges(session: Session, opts?: {
     preserveRecent?: number;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "billion-context-dsh",
-	"version": "0.2.4",
+	"version": "0.3.0",
 	"description": "Active Context Pruning (ACP) for the DeepSeek Harness — model-driven context management as a CompactionEngine backend.",
 	"keywords": [
 		"deepseek",
@@ -43,16 +43,14 @@
 	"scripts": {
 		"typecheck": "tsc --noEmit",
 		"build": "tsup && tsc --emitDeclarationOnly",
-		"test": "node --import tsx --test tests/*.test.ts"
-	},
-	"dependencies": {
-		"acp-kernel": "0.0.24"
+		"test": "node --import tsx --test tests/*.test.ts tests/kernel-upstream/*.test.ts"
 	},
 	"peerDependencies": {
 		"@deepseek-ai/cordis": "^4.0.1",
 		"@deepseek-ai/dsh-compaction": "^0.1.0-rc.6"
 	},
 	"devDependencies": {
+		"acp-kernel": "0.0.29",
 		"@deepseek-ai/cordis": "4.0.1",
 		"@deepseek-ai/dsh-agent": "0.1.0-rc.6",
 		"@deepseek-ai/dsh-commands": "0.1.0-rc.6",