billion-context-dsh 0.2.23 → 0.2.25

package/dist/messages.d.ts

@@ -25,8 +25,8 @@ import type { Session, SessionEvent } from '@deepseek-ai/dsh-session';
  * one-line placeholder instead of vanishing (issue #117). An `image`/`file`
  * block used to contribute nothing, which silently made a picture-only user
  * message — or a tool result carrying a screenshot — invisible to the engine:
- * no ref (so no compress boundary), `hasPlainRef` false (so the range solver
- * shrank past it and swallowed neighbours), invisible to the kernel's
+ * no ref (so no compress boundary), `anchorsRangeEdge` false (so the range
+ * solver shrank past it and swallowed neighbours), invisible to the kernel's
  * recent/last-user protection (so the last real user turn could be compressed
  * away), priced at zero tokens, and absent from search/decompress output. The
  * host itself projects non-text references to deterministic handle text for
@@ -36,6 +36,20 @@ import type { Session, SessionEvent } from '@deepseek-ai/dsh-session';
  * across turns (cache prefix, summary text, search hits).
  */
 export declare function extractText(content: unknown): string;
+interface ToolCallBlock {
+    type: 'tool-call';
+    id?: string;
+    name?: string;
+    arguments?: unknown;
+}
+/**
+ * The tool-call blocks of one assistant content array, in CONTENT order.
+ * Shared with the range-edge layer (src/region.ts `anchorsRangeEdge`,
+ * src/tools.ts `edgeRefForSeq`): projection order IS this order (projectEvent
+ * maps the calls in sequence), so "the node's first/last sub-message id" is
+ * derivable from it without re-implementing the filter anywhere else.
+ */
+export declare function toolCallsOf(content: unknown): ToolCallBlock[];
 /**
  * The tool-call id of one tool/result surface message, or null.
  *
@@ -165,3 +179,4 @@ export declare function classifySurfaceEvent(event: SessionEvent): SurfaceEventC
  * message was left compressible while synthetic output sat safe.
  */
 export declare function isRealUserTurn(event: SessionEvent): boolean;
+export {};

package/dist/nudge.d.ts

@@ -70,7 +70,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

@@ -82,14 +82,15 @@ export interface ResolvedSurfaceRange {
 }
 /**
  * Validate one inclusive surface span and adjust its edges to a
- * tool-pairing-balanced range whose boundaries carry a bare-seq ref. Reversed
- * ranges throw. An edge that sits inside a tool-call/result pair — or on a
- * multi-tool-call assistant message that has no bare-seq ref — is first nudged
- * inward to the nearest clean cut; if that collapses the range (e.g. the model
- * asked for a SINGLE tool result, which can never be balanced alone), the
- * range EXPANDS outward to the enclosing clean pair instead — a lone tool
- * message is almost always a "consumed output" the model genuinely wants to
- * compress. The returned range is what a caller should actually shadow.
+ * tool-pairing-balanced range whose boundaries anchor (bare-`${seq}` ref,
+ * multi-call sub-id, or empty-result fallback — see anchorsRangeEdge,
+ * issue #155). Reversed ranges throw. An edge that sits inside a
+ * tool-call/result pair is first nudged inward to the nearest clean cut; if
+ * that collapses the range (e.g. the model asked for a SINGLE tool result,
+ * which can never be balanced alone), the range EXPANDS outward to the
+ * enclosing clean pair instead — a lone tool message is almost always a
+ * "consumed output" the model genuinely wants to compress. The returned range
+ * is what a caller should actually shadow.
  *
  * Missing edges are NOT an immediate error: the seqs were probably shadowed by
  * an earlier compression (stale nudge table / old compress result). The span
@@ -256,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).
  */
@@ -141,6 +141,28 @@ export declare const compressParameters: {
  */
 export declare function guardedRowsInSpan(guarded: ReadonlySet<number>, shadowed: readonly number[]): number[];
 export declare function protectedRowRejectionNote(start: number, end: number, hits: readonly number[], shadowed: readonly number[]): string;
+/**
+ * Kernel ref for one RESOLVED range edge's surface node (issue #155).
+ * Resolved edges are tool-pairing-balanced and anchorable, but NO LONGER
+ * guaranteed to carry a bare-`${seq}` ref: a multi-tool-call assistant
+ * projects to `${seq}#${callId}` sub-ids, and an empty tool result projects
+ * to nothing. Three tiers, in order:
+ *
+ *  1. the bare-seq id (user turns, single-call assistants, text-bearing results);
+ *  2. the node's sub-ids in projection (= content) order — FIRST for a start
+ *     edge (the kernel must consume the whole node from its first sub-message),
+ *     LAST for an end edge (unreachable in practice: a node with open calls
+ *     makes every cut after it unbalanced, so it can never be a resolved end
+ *     edge);
+ *  3. the nearest message-bearing LIVE node between this edge and the opposite
+ *     edge (inclusive), walked along the SURFACE — never raw-id space, where
+ *     shadowed nodes keep their refs and would anchor onto already-compressed
+ *     messages. Walking inward only also guarantees the returned ref names a
+ *     message the transaction actually shadows; a span whose interior carries
+ *     no message at all (two adjacent empty results) yields undefined and the
+ *     caller raises the existing "no assigned ref" error.
+ */
+export declare function edgeRefForSeq(session: Session, byRaw: Readonly<Record<string, string>>, seq: number, role: 'start' | 'end', oppositeSeq: number): string | undefined;
 /**
  * Build the unified SearchDoc[] from the log: one block doc per ledger entry
  * (ref = compactionId, so `decompress({ blockId })` closes the loop) plus one

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.23",
+	"version": "0.2.25",
 	"description": "Active Context Pruning (ACP) for the DeepSeek Harness — model-driven context management as a CompactionEngine backend.",
 	"keywords": [
 		"deepseek",