billion-context-dsh 0.2.24 → 0.2.26

package/dist/messages.d.ts

@@ -12,6 +12,16 @@
  */
 import type { CoreMessage } from 'acp-kernel';
 import type { Session, SessionEvent } from '@deepseek-ai/dsh-session';
+declare module '@deepseek-ai/dsh-llm/message' {
+    interface MessageSourceMap {
+        acpNudge: {
+            kind: 'plugin:acp-nudge';
+        };
+        acpPrune: {
+            kind: 'plugin:billion-context-dsh';
+        };
+    }
+}
 /**
  * Extract plain text from a DSH content block array or string.
  *
@@ -89,6 +99,21 @@ export declare function buildToolCallIndex(events: readonly SessionEvent[]): Rea
  */
 export declare const SUMMARY_FRAME_PREFIX = "[Model-written summary \u2014 not user words; re-verify any obligations before relying on them]";
 export declare function withSummaryFramePrefix(text: string): string;
+/**
+ * The lead-in of a summary the ENGINE writes itself — today only the
+ * context-overflow emergency marker (src/index.ts `compactForOverflow`).
+ * Recognition is by content, not by caller: the writer and both framing sites
+ * share this ONE literal.
+ */
+export declare const ENGINE_SUMMARY_LEAD = "[engine-written summary \u2014 context-overflow emergency compaction";
+export declare function isEngineWrittenSummary(text: string): boolean;
+/**
+ * The block summary the automatic overflow recovery writes. It is the engine's
+ * own note — not model-written text, not user words — saying which range was
+ * hidden to get the request under the window and where the originals still
+ * live (the append-only log: search_context/decompress rebuild from it).
+ */
+export declare function overflowMarkerSummary(hiddenCount: number): string;
 export declare function projectEvent(event: SessionEvent, toolNames?: ReadonlyMap<string, string>): CoreMessage[];
 /** Project a session's message events into CoreMessage[] in log order. */
 export declare function eventsToCoreMessages(events: readonly SessionEvent[], toolNames?: ReadonlyMap<string, string>): CoreMessage[];
@@ -131,40 +156,85 @@ export declare function mediaBlocksOfEvent(event: SessionEvent): readonly unknow
  * Whether a surface user message is a compaction checkpoint node (already
  * compressed). Defined here (not in region.ts) so the classifier below and
  * region.ts share ONE implementation.
+ *
+ * Recognizes BOTH host shapes (issue #168): the ≤0.1.6 wrapper
+ * `{ kind: 'plugin', plugin: 'compact', compactionId }` and the 0.1.7+
+ * producer-owned kind `{ kind: 'compact-checkpoint', compactionId }` written
+ * by dsh-compaction's `compactCheckpointSource()` (verified against the
+ * published 0.1.7-alpha.1 artifact: the marker object is exactly
+ * `{ kind: 'compact-checkpoint' }` plus `compactionId` and an optional
+ * `sourceCommandId`). The 0.1.7 V3→V4 migration rewrites pre-0.1.7 sessions
+ * to the new shape, so both shapes coexist on one surface and both must be
+ * recognized — a row that misses this predicate classifies as `real`, which
+ * double-counts its summary text in acp_status, can steal the protected-tail
+ * window, and hides it from every distillation entry point below.
  */
 export declare function isCheckpointNode(event: SessionEvent): boolean;
+/**
+ * The durable compaction id stamped on a checkpoint summary node, reading BOTH
+ * host shapes (see {@link isCheckpointNode}). Returns null when the event is
+ * not a checkpoint node or carries no id — a malformed row still CLASSIFIES
+ * as a checkpoint (it must never read as real content) but has no block to
+ * link to. Single shared extractor for the ledger index (`summarySeqIndex`),
+ * the distill-edge resolver (`blockRefForSummarySeq`) and the decompress
+ * recursion (`checkpointBlockIdOf`) — those sites must not re-derive the shape
+ * check themselves (issue #168).
+ */
+export declare function checkpointCompactionIdOf(event: SessionEvent): string | null;
 /**
  * Injection/authoring classification of one surface event — the ONE shared
  * classifier for range scanning and the protected-tail scan (never ad-hoc
  * predicates that drift apart).
  *
  * - `real` — genuine conversation content (user turns without an injected
- *   source, assistant prose/tool-calls, tool results, sub-agent relay rows).
- *   This is the only class that may win "last real user message" protection
- *   (minus relay rows, see `isRealUserTurn`).
+ *   source, assistant prose/tool-calls, tool results, sub-agent relay rows,
+ *   and host content channels in BOTH spellings: legacy plugin names and the
+ *   DSH >= 0.1.7 direct-kind renames, issue #169). This is the only class
+ *   that may win "last real user message" protection (minus all non-user
+ *   rows, see `isRealUserTurn`).
  * - `metadata` — the engine's own ephemeral rows: nudge echoes and
  *   compress-pair replacement stubs. Their content is derived from
  *   already-visible messages, so folding them into an adjacent real segment
  *   is zero-loss — this preserves main's behavior for engine-authored rows.
- * - `checkpoint` — compaction summary nodes (`plugin: 'compact'`).
+ * - `checkpoint` — compaction summary nodes (both host shapes, see
+ *   `isCheckpointNode`: legacy `plugin: 'compact'` and 0.1.7+
+ *   `kind: 'compact-checkpoint'`, issue #168).
  *   Distillation is an explicit act; never folded into any segment.
  * - `instruction` — host-authored policy/instructions: AGENTS.md injections
- *   (both host shapes), skill catalogs, and ANY unknown `kind:'plugin'` row.
- *   Folding these is unsafe (the model would lose live policy text, and the
- *   host re-injects the current AGENTS.md copy when it disappears — the
- *   compress → re-inject loop this PR fixes). Unknown plugin names fall here
- *   deliberately: a future host injection must never silently become
- *   compressible content.
+ *   (both host shapes), skill catalogs, host compaction summary rows
+ *   (`compact-basic`, issue #169), and ANY unknown `kind:'plugin'` row or
+ *   unaudited direct kind. Folding these is unsafe (the model would lose
+ *   live policy text, and the host re-injects the current AGENTS.md copy
+ *   when it disappears — the compress → re-inject loop this PR fixes).
+ *   Unknown channel names fall here deliberately in BOTH namespaces: a
+ *   future host injection must never silently become compressible content.
  */
 export type SurfaceEventClass = 'real' | 'metadata' | 'checkpoint' | 'instruction';
 /** Plugin names the engine itself authors — safe to fold into real segments. */
 export declare const METADATA_PLUGINS: ReadonlySet<string>;
 /**
- * True for AGENTS.md instruction rows in BOTH host shapes: the hook shape
- * (`kind:'agent-instructions'`, form 'instructions') and the baseline shape
- * (`kind:'plugin'` + plugin 'agent-instructions'). Shared by the newest-row
- * scan and the range scanner so protection and folding always agree on what
- * counts as an AGENTS.md row.
+ * Resolve the owning plugin name from either durable source shape: the legacy
+ * V3 wrapper `{ kind: 'plugin', plugin: '<name>' }` or the V4 producer kind
+ * `'plugin:<name>'`. DSH 0.1.7's V3→V4 migration rewrites every unregistered
+ * plugin row into the latter on file open, so both shapes coexist on a live
+ * surface until a session has been fully rewritten (issue #163). Returns
+ * undefined when neither shape is present, or when the name is missing,
+ * non-string, or empty — callers then keep their conservative fallback.
+ */
+export declare function sourcePluginOf(source: {
+    kind?: unknown;
+    plugin?: unknown;
+} | undefined): string | undefined;
+/**
+ * True for AGENTS.md instruction rows in ALL host shapes: the hook shape
+ * (`kind:'agent-instructions'`, form 'instructions'), the legacy V3 wrapper
+ * (`kind:'plugin'` + plugin 'agent-instructions'), and the V4 producer kind
+ * (`kind:'plugin:agent-instructions'`) that DSH 0.1.7's migration rewrites
+ * legacy rows into on file open (issue #163) — a migrated session must keep
+ * its newest-row pin, or the current copy becomes foldable and the
+ * compress → re-inject loop returns. Shared by the newest-row scan and the
+ * range scanner so protection and folding always agree on what counts as an
+ * AGENTS.md row.
  */
 export declare function isAgentInstructionsRow(event: SessionEvent): boolean;
 export declare function classifySurfaceEvent(event: SessionEvent): SurfaceEventClass;

package/dist/nudge.d.ts

@@ -38,6 +38,14 @@ export interface NudgeOutcome {
  *    minimal hosts that lack the token-meter service.
  */
 export declare function resolveTokenCount(agent: Agent, coreMessages: CoreMessage[]): number;
+/**
+ * Lazy per-seq media price. The FIRST lookup triggers one meter measurement, so
+ * the range walk only asks about seqs that really carry an attachment — a
+ * media-free session never pays for the measurement (issue #117, issue #110).
+ * Exported for the context-overflow recovery path, which ranks ranges with the
+ * same vocabulary as the nudge table.
+ */
+export declare function meterMediaPriceResolver(agent: Agent, session: import('@deepseek-ai/dsh-session').Session): MediaPriceOf;
 /**
  * Render the compressible-range table as seq refs for the model.
  *
@@ -70,7 +78,7 @@ export declare function rangeTable(session: import('@deepseek-ai/dsh-session').S
  * source marker). We instead count active-block summaries directly from kernel
  * state (same source `buildStatusReport` uses), and the caller must exclude
  * checkpoint summary nodes from `messages` (they are not in any block's
- * `effectiveMessageIds` and would double-count — mirror of `/acp` status's
+ * `effectiveMessageIds` and would double-count — mirror of `/acp-prune` status's
  * `isCheckpointNode` exclusion).
  */
 export declare function computeSurfaceBreakdown(state: CompressionState, messages: readonly CoreMessage[], total: number, growth: number): ContextBreakdown;

package/dist/presets.d.ts

@@ -18,7 +18,7 @@
  *
  * Presets are set at composition time (`config: { preset: 'efficient' }`).
  * Runtime hot-reload of the underlying keys rides on issue #75 Phase 1
- * (`settings.yaml` + `/acp config`); surfacing the `preset` alias through that
+ * (`settings.yaml` + `/acp-prune config`); surfacing the `preset` alias through that
  * same channel is the small follow-up once Phase 1 lands. The two knobs named in
  * the original request that are NOT first-class engine knobs today — `growthRatio`
  * (exists in acp-kernel as `nudge.growthRatio`, reachable via `coreOverrides`) and

package/dist/region.d.ts

@@ -257,7 +257,7 @@ export declare function newestInstructionSeqsOf(session: Session): Set<number>;
  * agent-instructions row of every scope, restricted to rows still visible on
  * the surface (one definition of "current" — `newestInstructionSeqsOf`).
  * `buildCompressibleSeqRanges` never OFFERS them, and both compress entry
- * points (`handleCompress` in src/tools.ts, `/acp compress` in
+ * points (`handleCompress` in src/tools.ts, `/acp-prune compress` in
  * src/commands.ts) probe the RESOLVED span against this set and HARD-REJECT a
  * covering range before the kernel applies it, so nothing durable lands and no
  * phantom block can exist. This supersedes the earlier F7 draft (warn only):

package/dist/settings.d.ts

@@ -7,7 +7,7 @@
  *
  * Layering (per key): schemastery schema default → composition-row subset
  * (the `base` layer, filtered by `filterSettingsEntry`) → user section.
- * The `/acp config` slash command reads and writes the same namespace
+ * The `/acp-prune config` slash command reads and writes the same namespace
  * through the `SettingsCommandSurface` built here.
  *
  * Deliberately NOT exposed through settings: `coreOverrides`, `countTokens`,
@@ -27,7 +27,7 @@ import type { SettingsDescriptor, SettingsProvider } from '@deepseek-ai/dsh-sett
  * (`installSection`'s `Namespace & SettingsNamespaceInput<Namespace>`).
  */
 export declare const ACP_SETTINGS_NAMESPACE = "compaction-acp";
-/** The six knobs exposed to the runtime settings layer. Order defines /acp config listing order. */
+/** The six knobs exposed to the runtime settings layer. Order defines /acp-prune config listing order. */
 export declare const SETTINGS_KEYS: readonly ['modelContextLimit', 'autoModelContextLimit', 'nudgeMinContextLimitPct', 'nudgeMaxContextLimitPct', 'nudgeEmergencyThresholdPct', 'autoNudge'];
 export type SettingsKey = (typeof SETTINGS_KEYS)[number];
 /** Resolved shape of one settings snapshot — what every consumer read returns. */
@@ -116,7 +116,7 @@ export interface SettingsChangeEffect {
 }
 /** Pure diff used by the engine's change handler (unit-testable without a context). */
 export declare function describeSettingsChange(prev: AcpSettings, next: AcpSettings): SettingsChangeEffect;
-/** Result of parsing a `/acp config set` value. `null` means "reset this key". */
+/** Result of parsing a `/acp-prune config set` value. `null` means "reset this key". */
 export type ParsedSettingValue = {
     ok: true;
     value: number | boolean | null;
@@ -125,7 +125,7 @@ export type ParsedSettingValue = {
     reason: string;
 };
 /**
- * Four-step value parser for `/acp config set` — deliberately NOT bare
+ * Four-step value parser for `/acp-prune config set` — deliberately NOT bare
  * JSON.parse, which rejects the most common human inputs (`.7` throws a
  * SyntaxError and the raw string would then fail schema validation; `null`
  * would silently mean "unset" only by convention). Order:
@@ -135,7 +135,7 @@ export type ParsedSettingValue = {
  * 4. otherwise rejected with guidance.
  */
 export declare function parseSettingValue(raw: string): ParsedSettingValue;
-/** Everything `/acp config` needs from the engine. Fakes in tests implement this directly. */
+/** Everything `/acp-prune config` needs from the engine. Fakes in tests implement this directly. */
 export interface SettingsCommandSurface {
     /** False in processes without a settings provider (plain npm-install compositions): the command degrades to advice instead of failing. */
     readonly available: boolean;

package/dist/tools.d.ts

@@ -22,7 +22,7 @@ import type { PresetName } from './presets.ts';
 export interface ToolEnvironment extends KernelConfigInput {
     readonly kernel: CompressionCore;
     readonly store: AcpStateStore;
-    /** Display-only: the named preset that produced the nudge thresholds above, if any (`/acp status` names it). Never read by the kernel path. */
+    /** Display-only: the named preset that produced the nudge thresholds above, if any (`/acp-prune status` names it). Never read by the kernel path. */
     readonly preset?: PresetName;
     /** Resolve the effective context window for an agent (optional: status falls back to modelContextLimit). */
     readonly windowFor?: (agent: Agent) => Promise<AcpWindow>;
@@ -36,7 +36,7 @@ export interface ToolEnvironment extends KernelConfigInput {
      */
     readonly compressCallIdsToHide?: Set<string>;
     /**
-     * Read/write access to the runtime settings layer for `/acp config`.
+     * Read/write access to the runtime settings layer for `/acp-prune config`.
      * Absent surfaces (never expected — the engine always builds one) would
      * degrade the command to advice text.
      */
@@ -46,7 +46,7 @@ export interface ToolEnvironment extends KernelConfigInput {
  * Resolve the effective context window for a tool or command run: probe the
  * agent's real window via `windowFor` when provided, otherwise fall back to
  * the environment's `modelContextLimit`. Shared by the compress and
- * acp_status tool handlers and the `/acp` command so the resolution logic
+ * acp_status tool handlers and the `/acp-prune` command so the resolution logic
  * lives in exactly one place (issue #63 — the tools used the 128K fallback
  * for pressure decisions even when auto-detection had found a larger window).
  */

package/dist/window.d.ts

@@ -55,7 +55,7 @@ export interface AcpWindow {
      */
     readonly outputReserved?: number;
 }
-/** Human label for an AcpWindow's source (used by /acp status). */
+/** Human label for an AcpWindow's source (used by /acp-prune status). */
 export declare function windowSourceLabel(window: AcpWindow): string;
 /**
  * Read the live context window from the host session projection
@@ -87,7 +87,7 @@ export declare function liveRoute(agent: Agent): {
  * resolved against, in ONE place: the session's live `request/context` route,
  * falling back to `agent.options` only before the session has recorded any
  * route. `windowFor` (src/index.ts), the `compress` tool (src/tools.ts) and
- * `/acp compress` (src/commands.ts) all need this exact pair; three hand-copied
+ * `/acp-prune compress` (src/commands.ts) all need this exact pair; three hand-copied
  * copies is precisely how a stale-route bug gets fixed in one call site and
  * left behind in the others.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "billion-context-dsh",
-	"version": "0.2.24",
+	"version": "0.2.26",
 	"description": "Active Context Pruning (ACP) for the DeepSeek Harness — model-driven context management as a CompactionEngine backend.",
 	"keywords": [
 		"deepseek",