billion-context-dsh 0.1.0

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/state.ts","../src/tools.ts","../src/config.ts","../src/region.ts","../src/messages.ts","../src/commands.ts","../src/nudge.ts","../src/system-prompt.ts"],"sourcesContent":["/**\n * billion-context-dsh — Active Context Pruning (ACP) for the DeepSeek Harness,\n * delivered as a `CompactionEngine` backend.\n *\n * The model decides when and what to compress (pure ACP semantics):\n *  - the `compress` tool durably shadows a surface range with the model-written\n *    summary (no second LLM summarization call — the ACP cost win);\n *  - the original events stay in the append-only session log, so `decompress`,\n *    `search_context`, and replay always work;\n *  - refs are surface seqs carried by the injected nudge's range table (DSH\n *    has no in-memory message rewrite hook — see docs/dsh-porting-verification.md);\n *  - automatic policy never summarizes by itself: it nudges the model.\n *\n * Mount it wherever a compaction backend is expected:\n *\n * ```yaml\n * - id: compaction-billion-context\n *   name: 'billion-context-dsh'\n *   config:\n *     modelContextLimit: 128000\n * ```\n *\n * The package registers `ctx.compaction` plus the four model tools and the\n * `/acp` command when the hosting composition provides `ctx.tools` /\n * `ctx.commands`.\n * @module billion-context-dsh\n */\n\nimport type { Context } from '@deepseek-ai/cordis'\nimport {\n  CompactionEngine,\n  ManualCompactionError,\n  type CompactionAgentContext,\n  type CompactionResult,\n  type CompactionTrigger,\n  type ManualCompactAgentContext,\n} from '@deepseek-ai/dsh-compaction'\nimport { createCore, type CompressionCore } from 'acp-kernel'\nimport type {} from '@deepseek-ai/dsh-agent'\nimport { AcpStateStore } from './state.ts'\nimport { makeTools, type ToolEnvironment } from './tools.ts'\nimport { acpCommand } from './commands.ts'\nimport { buildNudge } from './nudge.ts'\nimport { ACP_SYSTEM_PROMPT, ACP_SYSTEM_PROMPT_ORDER } from './system-prompt.ts'\n\nexport { AcpStateStore } from './state.ts'\nexport { kernelConfigFor, type KernelConfigInput } from './config.ts'\nexport { ACP_SYSTEM_PROMPT, ACP_SYSTEM_PROMPT_ORDER } from './system-prompt.ts'\nexport { makeTools, type ToolEnvironment } from './tools.ts'\nexport { acpCommand } from './commands.ts'\nexport { buildNudge, type NudgeEnvironment, type NudgeOutcome } from './nudge.ts'\nexport {\n  rebuildBlockLedger,\n  resolveSurfaceRange,\n  runCompactionTransaction,\n  shadowedSeqsOf,\n  findOpenTurn,\n  assertNoActiveCompaction,\n  type AcpBlockLedgerEntry,\n  type CompactionTransactionInput,\n} from './region.ts'\nexport { eventsToCoreMessages, projectEvent, surfaceEventsOf, extractEventText } from './messages.ts'\n\nexport interface AcpConfig {\n  /** The context window used for pressure decisions. Default 128000. */\n  readonly modelContextLimit: number\n  /** Nudge window lower bound (usage fraction). Kernel default 0.45 — same as billion-context-pi. */\n  readonly nudgeMinContextLimitPct?: number\n  /** Nudge window upper bound (over-limit). Kernel default 0.75 — same as billion-context-pi. */\n  readonly nudgeMaxContextLimitPct?: number\n  /** Emergency nudge threshold (bypasses per-turn dedup). Kernel default 0.95 — same as billion-context-pi. */\n  readonly nudgeEmergencyThresholdPct?: number\n  /** Any other acp-kernel Config override (billion-context-pi's `coreOverrides` escape hatch). */\n  readonly coreOverrides?: Partial<import('acp-kernel').Config>\n  /** Register the four model tools on `ctx.tools`. Default true. */\n  readonly autoTools: boolean\n  /** Register the `/acp` command on `ctx.commands`. Default true. */\n  readonly autoCommand: boolean\n  /** Inject the nudge into `agent/pre-step` when the kernel recommends it. Default true. */\n  readonly autoNudge: boolean\n}\n\nconst DEFAULT_CONFIG: AcpConfig = {\n  modelContextLimit: 128000,\n  autoTools: true,\n  autoCommand: true,\n  autoNudge: true,\n}\n\nexport function resolveAcpConfig(config: Partial<AcpConfig> = {}): AcpConfig {\n  return { ...DEFAULT_CONFIG, ...config }\n}\n\n/**\n * The ACP compaction backend. Subclasses the seam exactly like\n * `dsh-compaction-basic`; swaps summarization-driven compaction for\n * model-driven block compression without touching the agent loop.\n */\nexport class AcpCompactionEngine extends CompactionEngine {\n  /** The framework-agnostic ACP compression core, reused verbatim. */\n  readonly kernel: CompressionCore\n  /** Per-session kernel state. */\n  readonly store: AcpStateStore\n  /** Resolved engine configuration. */\n  readonly config: AcpConfig\n\n  private readonly lastNudgeTurn = new Map<string, number>()\n\n  constructor(ctx: Context, config: Partial<AcpConfig> = {}) {\n    super(ctx)\n    this.config = resolveAcpConfig(config)\n    this.kernel = createCore({})\n    this.store = new AcpStateStore()\n\n    const env: ToolEnvironment = {\n      kernel: this.kernel,\n      store: this.store,\n      modelContextLimit: this.config.modelContextLimit,\n      nudgeMinContextLimitPct: this.config.nudgeMinContextLimitPct,\n      nudgeMaxContextLimitPct: this.config.nudgeMaxContextLimitPct,\n      nudgeEmergencyThresholdPct: this.config.nudgeEmergencyThresholdPct,\n      coreOverrides: this.config.coreOverrides,\n    }\n\n    if (this.config.autoTools) {\n      const tools = ctx.get('tools')\n      if (tools !== undefined) {\n        for (const tool of makeTools(env)) tools.register(tool)\n      }\n    }\n    if (this.config.autoCommand) {\n      const commands = ctx.get('commands')\n      if (commands !== undefined) commands.register(acpCommand(env))\n    }\n    if (this.config.autoNudge) {\n      ctx.on('agent/pre-step', async (payload, next) => {\n        const decision = await next()\n        if (decision.kind === 'reject') return decision\n        const outcome = buildNudge(payload.agent, env, this.lastNudgeTurn)\n        if (outcome === null) return decision\n        return { kind: 'enter', messages: [...decision.messages, outcome.message] }\n      })\n    }\n    // The load-bearing ACP guidance lives in the system prompt ONCE; nudges\n    // stay short and advisory (model-driven: the model decides).\n    const systemPrompt = ctx.get('systemPrompt')\n    if (systemPrompt !== undefined) {\n      systemPrompt.section({\n        name: 'billion-context-dsh',\n        order: ACP_SYSTEM_PROMPT_ORDER,\n        text: ACP_SYSTEM_PROMPT,\n      })\n    }\n  }\n\n  /** ACP is model-driven: automatic pressure policy never summarizes by itself. */\n  override async compactIfNeeded(\n    _agent: CompactionAgentContext,\n    _trigger: CompactionTrigger,\n    signal: AbortSignal,\n  ): Promise<CompactionResult | null> {\n    signal.throwIfAborted()\n    return null\n  }\n\n  /** Explicit idle-session compaction: ACP leaves the decision to the model. */\n  override async compactNow(\n    _agent: ManualCompactAgentContext,\n    signal: AbortSignal,\n  ): Promise<CompactionResult | null> {\n    signal.throwIfAborted()\n    return null\n  }\n\n  /**\n   * The model-driven path lands through the `compress` tool, which runs the\n   * full durable transaction directly. This seam method rejects with guidance:\n   * automatic summarization is exactly what ACP replaces.\n   */\n  override async compactRegion(\n    _start: number,\n    _end: number,\n    _agent: CompactionAgentContext,\n    signal?: AbortSignal,\n  ): Promise<CompactionResult> {\n    signal?.throwIfAborted()\n    throw new ManualCompactionError(\n      'summary',\n      'billion-context-dsh is model-driven: use the compress tool instead of automatic summarization',\n    )\n  }\n}\n\nexport default AcpCompactionEngine\n","/**\n * M2 — per-session ACP kernel state.\n *\n * The in-memory map holds the exact acp-kernel `CompressionState` while a\n * session is live. Durability does not rely on a sidecar file: every durable\n * compression writes a `compaction/summary` event whose shadowed range and\n * summary re-derive the block ledger (`rebuildBlockLedger` in region.ts), so a\n * restarted engine can answer decompress/search/status from the session log\n * alone — DSH's \"log is the source of truth\" model.\n * @module billion-context-dsh/state\n */\n\nimport type { Session } from '@deepseek-ai/dsh-session'\nimport { createInitialState, type CompressionState } from 'acp-kernel'\n\nexport class AcpStateStore {\n  private readonly states = new Map<string, CompressionState>()\n\n  /** Kernel state for one session, initialised on first access. */\n  stateFor(session: Session): CompressionState {\n    const id = session.id\n    const existing = this.states.get(id)\n    if (existing !== undefined) return existing\n    const state = createInitialState()\n    this.states.set(id, state)\n    return state\n  }\n\n  set(session: Session, state: CompressionState): void {\n    this.states.set(session.id, state)\n  }\n\n  delete(session: Session): void {\n    this.states.delete(session.id)\n  }\n}\n","/**\n * M3 — the four model tools: compress / decompress / search_context /\n * acp_status, registered through `ctx.tools` (defineTool).\n *\n * compress is the heart of ACP: the model writes the summary and the tool\n * lands it as a durable surface replacement (no second LLM summarization\n * call). decompress recovers shadowed content read-only from the log (DSH\n * keeps the originals — V5). search_context scores blocks rebuilt from the\n * log. acp_status reports the block ledger and pressure.\n * @module billion-context-dsh/tools\n */\n\nimport { defineTool, type ToolDefinition, type ToolRunContext } from '@deepseek-ai/dsh-tools'\nimport { estimateTokensFast, type CompressionCore } from 'acp-kernel'\nimport type { Agent } from '@deepseek-ai/dsh-agent'\nimport type { AcpStateStore } from './state.ts'\nimport { kernelConfigFor, type KernelConfigInput } from './config.ts'\nimport {\n  rebuildBlockLedger,\n  resolveSurfaceRange,\n  runCompactionTransaction,\n  shadowedSeqsOf,\n} from './region.ts'\nimport { eventsToCoreMessages, extractEventText, surfaceEventsOf } from './messages.ts'\n\nexport interface ToolEnvironment extends KernelConfigInput {\n  readonly kernel: CompressionCore\n  readonly store: AcpStateStore\n}\n\ninterface TextOutput {\n  text: string\n}\n\nfunction textOutput(): {\n  schema: { type: 'object'; properties: { text: { type: 'string' } }; additionalProperties: boolean }\n  render: (args: unknown, value: TextOutput) => import('@deepseek-ai/dsh-llm').ContentBlock[]\n} {\n  return {\n    schema: {\n      type: 'object',\n      properties: { text: { type: 'string' } },\n      additionalProperties: false,\n    },\n    render: (_args, value) => [{ type: 'text', text: value.text }],\n  }\n}\n\nfunction requireAgent(exec: ToolRunContext): Agent {\n  if (exec.agent === undefined) {\n    throw new Error('billion-context-dsh: tool requires an agent execution context')\n  }\n  return exec.agent\n}\n\nconst compressParameters = {\n  topic: { type: 'string' as const, description: 'Fallback topic for entries without their own.' },\n  content: {\n    type: 'array' as const,\n    required: true,\n    description: 'One or more ranges to compress, each with startSeq/endSeq boundaries (surface seqs) and a dense summary.',\n    items: {\n      type: 'object' as const,\n      properties: {\n        startSeq: {\n          oneOf: [\n            { type: 'integer' as const, description: 'First surface seq of the range.' },\n            { type: 'string' as const, description: 'Seq as text; a trailing #callId fragment is ignored.' },\n          ],\n        },\n        endSeq: {\n          oneOf: [\n            { type: 'integer' as const, description: 'Inclusive last surface seq of the range.' },\n            { type: 'string' as const, description: 'Seq as text; a trailing #callId fragment is ignored.' },\n          ],\n        },\n        summary: { type: 'string' as const, description: 'Complete technical summary replacing the range; keep paths, decisions, values verbatim. Minimum 50 characters.' },\n        topic: { type: 'string' as const, description: 'Short label (3-5 words) for this range.' },\n      },\n      additionalProperties: false,\n    },\n  },\n} as const\n\n/** Normalize a seq arg: number, \"295\", or \"295#call_00_xxx\" → 295. */\nfunction parseSeq(value: number | string): number {\n  const text = String(value).split('#')[0]!.trim()\n  const seq = Number(text)\n  if (!Number.isInteger(seq) || seq < 0) {\n    throw new Error(`billion-context-dsh: invalid seq \"${String(value)}\" — use a surface seq like 295`)\n  }\n  return seq\n}\n\ninterface CompressArgs {\n  topic?: string\n  content: Array<{ startSeq: number | string; endSeq: number | string; summary: string; topic?: string }>\n}\n\n/** Resolve seq → kernel ref, then applyCompression and land the transaction. */\nasync function handleCompress(env: ToolEnvironment, args: CompressArgs, exec: ToolRunContext): Promise<TextOutput> {\n  const agent = requireAgent(exec)\n  const session = agent.session\n  const state = env.store.stateFor(session)\n  const coreMessages = eventsToCoreMessages(surfaceEventsOf(session))\n  const tokenCount = coreMessages.reduce((sum, message) => sum + estimateTokensFast(message.text ?? ''), 0)\n  const config = kernelConfigFor(env)\n\n  // Assign refs / advance state exactly like a turn would.\n  const turn = env.kernel.processTurn({ messages: coreMessages, state, config, tokenCount })\n  env.store.set(session, turn.state)\n  const byRaw = turn.state.messageRefs.byRaw\n\n  const ranges = args.content.map((range) => {\n    const startSeq = parseSeq(range.startSeq)\n    const endSeq = parseSeq(range.endSeq)\n    const startRef = byRaw[String(startSeq)]\n    const endRef = byRaw[String(endSeq)]\n    if (startRef === undefined || endRef === undefined) {\n      throw new Error(\n        `billion-context-dsh: seq ${startSeq}..${endSeq} has no assigned ref — `\n        + 'the range must be on the current surface (run acp_status for the live seq list)',\n      )\n    }\n    return {\n      startSeq,\n      endSeq,\n      startRef,\n      endRef,\n      summary: range.summary,\n      ...(range.topic ?? args.topic) === undefined ? {} : { topic: range.topic ?? args.topic },\n    }\n  })\n\n  const applied = env.kernel.applyCompression({\n    ranges: ranges.map(({ startRef, endRef, summary, topic }) => ({ startRef, endRef, summary, topic })),\n    messages: coreMessages,\n    state: turn.state,\n    config,\n  })\n  if (applied.result.errors.length > 0) {\n    return { text: `compress failed: ${applied.result.errors.join('; ')}` }\n  }\n  env.store.set(session, applied.state)\n\n  const lines: string[] = []\n  for (let index = 0; index < ranges.length; index += 1) {\n    const range = ranges[index]!\n    const original = args.content[index]!\n    // The edges may have been nudged to the nearest tool-pairing-balanced cut;\n    // shadow exactly what resolveSurfaceRange approved.\n    const { start, end } = resolveSurfaceRange(session, range.startSeq, range.endSeq)\n    const shadowed = shadowedSeqsOf(session, start, end)\n    const { compactionId } = runCompactionTransaction(session, {\n      start,\n      end,\n      shadowedSeqs: shadowed,\n      summary: [{ type: 'text', text: original.summary }],\n      shadowedTokenCount: 0,\n      provider: agent.options.provider ?? '',\n      model: agent.options.model ?? '',\n    })\n    const adjusted = start !== range.startSeq || end !== range.endSeq\n    lines.push(\n      `  block ${compactionId.slice(0, 8)}: seqs ${start}..${end}, ${shadowed.length} messages shadowed`\n      + (adjusted ? ` (adjusted from ${range.startSeq}..${range.endSeq} to balanced edges)` : ''),\n    )\n  }\n\n  return {\n    text: `Compressed ${applied.result.blocksCreated} block(s), ~${applied.result.tokensCompressed} tokens reclaimed.\\n${lines.join('\\n')}`,\n  }\n}\n\nconst decompressParameters = {\n  blockId: { type: 'string' as const, required: true, description: 'Block id from acp_status or search_context (the compaction id).' },\n} as const\n\ninterface DecompressArgs {\n  blockId: string\n}\n\nfunction handleDecompress(_env: ToolEnvironment, args: DecompressArgs, exec: ToolRunContext): TextOutput {\n  const session = requireAgent(exec).session\n  const ledger = rebuildBlockLedger(session.events)\n  const block = ledger.find((entry) => entry.blockId.startsWith(args.blockId))\n  if (block === undefined) {\n    return { text: `decompress: block \"${args.blockId}\" not found (see acp_status for the block list)` }\n  }\n  const parts: string[] = []\n  for (const seq of block.shadowedSeqs) {\n    const event = session.events[seq]\n    const text = event === undefined ? '' : extractEventText(event)\n    if (text.length > 0) parts.push(`[seq ${seq}] ${text}`)\n  }\n  return {\n    text: `Block ${block.blockId} — ${block.summary}\\n\\n${parts.join('\\n\\n') || '(no recoverable content)'}`,\n  }\n}\n\nconst searchParameters = {\n  query: { type: 'string' as const, required: true, description: 'Search terms to find inside compressed blocks.' },\n  limit: { type: 'integer' as const, description: 'Maximum results (default 5).' },\n} as const\n\ninterface SearchArgs {\n  query: string\n  limit?: number\n}\n\nfunction handleSearch(_env: ToolEnvironment, args: SearchArgs, exec: ToolRunContext): TextOutput {\n  const session = requireAgent(exec).session\n  const ledger = rebuildBlockLedger(session.events)\n  const terms = args.query.toLowerCase().split(/\\s+/).filter(Boolean)\n  const scored: Array<{ blockId: string; score: number; summary: string }> = []\n  for (const block of ledger) {\n    const original = block.shadowedSeqs\n      .map((seq) => extractEventText(session.events[seq]!))\n      .join('\\n')\n    const haystack = `${block.summary}\\n${original}`.toLowerCase()\n    let score = 0\n    for (const term of terms) score += haystack.split(term).length - 1\n    if (score > 0) scored.push({ blockId: block.blockId, score, summary: block.summary })\n  }\n  scored.sort((a, b) => b.score - a.score)\n  const top = scored.slice(0, args.limit ?? 5)\n  if (top.length === 0) return { text: `search_context: no matches for \"${args.query}\"` }\n  return {\n    text: `Matches for \"${args.query}\":\\n`\n      + top.map((hit) => `  - ${hit.blockId} (score ${hit.score}): ${hit.summary.slice(0, 160)}`).join('\\n')\n      + '\\n\\nDecompress with: decompress({ blockId })',\n  }\n}\n\nconst statusParameters = {} as const\n\ninterface StatusArgs {\n  [key: string]: never\n}\n\nfunction handleStatus(env: ToolEnvironment, _args: StatusArgs, exec: ToolRunContext): TextOutput {\n  const session = requireAgent(exec).session\n  const ledger = rebuildBlockLedger(session.events)\n  const totalTokens = ledger.reduce((sum, block) => sum + block.shadowedTokenCount, 0)\n  const coreMessages = eventsToCoreMessages(surfaceEventsOf(session))\n  const estimated = coreMessages.reduce((sum, message) => sum + estimateTokensFast(message.text ?? ''), 0)\n  const limit = env.modelContextLimit\n  const lines = [\n    `ACP status — session ${session.id}`,\n    `  blocks: ${ledger.length}`,\n    `  tokens compressed: ${totalTokens}`,\n    `  estimated context: ${estimated} / ${limit} (${Math.round((estimated / limit) * 100)}%)`,\n  ]\n  for (const block of ledger.slice(0, 10)) {\n    lines.push(`  - ${block.blockId.slice(0, 8)}: seqs ${block.start}..${block.end} (${block.shadowedSeqs.length} msgs) — ${block.summary.slice(0, 80)}`)\n  }\n  return { text: lines.join('\\n') }\n}\n\n/** Build the four ACP model tools bound to one engine. */\nexport function makeTools(env: ToolEnvironment): ToolDefinition[] {\n  return [\n    defineTool({\n      name: 'compress',\n      description:\n        'Replace older conversation ranges with dense summaries you write. '\n        + 'Each message seq is a surface reference. Single range: compress({ content: [{ startSeq, endSeq, summary }] }). '\n        + 'Batch multiple unrelated ranges in one call. Never compress content the current step is actively using.',\n      parameters: compressParameters,\n      output: textOutput(),\n      async execute(args, exec) {\n        return handleCompress(env, args as CompressArgs, exec)\n      },\n    }),\n    defineTool({\n      name: 'decompress',\n      description: 'Recover the original content of a compressed block by its blockId (read-only; does not unshadow the range).',\n      parameters: decompressParameters,\n      output: textOutput(),\n      execute(args, exec) {\n        return Promise.resolve(handleDecompress(env, args as DecompressArgs, exec))\n      },\n    }),\n    defineTool({\n      name: 'search_context',\n      description: 'Search inside compressed blocks (summaries and original content) for information the model no longer sees in context.',\n      parameters: searchParameters,\n      output: textOutput(),\n      execute(args, exec) {\n        return Promise.resolve(handleSearch(env, args as SearchArgs, exec))\n      },\n    }),\n    defineTool({\n      name: 'acp_status',\n      description: 'Report the ACP block ledger: compressed blocks, reclaimed tokens, and current context pressure.',\n      parameters: statusParameters,\n      output: textOutput(),\n      execute(args, exec) {\n        return Promise.resolve(handleStatus(env, args as StatusArgs, exec))\n      },\n    }),\n  ]\n}\n","/**\n * Kernel configuration assembly — the DSH counterpart of billion-context-pi's\n * `resolveConfig`: build acp-kernel's `Config` from adapter-level knobs.\n *\n * Defaults are deliberately the acp-kernel `defaultConfig` values (the same\n * defaults billion-context-pi ships: nudge window 45%–75%, emergency 95%,\n * growth ratio 5%, protected last messages 5). Every knob is optional — an\n * omitted value keeps the kernel default, so the behavior matches the Pi\n * adapter exactly unless a deployment opts out.\n * @module billion-context-dsh/config\n */\n\nimport { defaultConfig, type Config } from 'acp-kernel'\n\n/** The kernel-facing knobs shared by the nudge path and the compress tool. */\nexport interface KernelConfigInput {\n  readonly modelContextLimit: number\n  /** Nudge window lower bound (usage fraction). Kernel default: 0.45. */\n  readonly nudgeMinContextLimitPct?: number\n  /** Nudge window upper bound — over-limit. Kernel default: 0.75. */\n  readonly nudgeMaxContextLimitPct?: number\n  /** Emergency nudge threshold (bypasses per-turn dedup). Kernel default: 0.95. */\n  readonly nudgeEmergencyThresholdPct?: number\n  /** Any other acp-kernel Config override (the billion-context-pi escape hatch). */\n  readonly coreOverrides?: Partial<Config>\n}\n\n/**\n * Assemble the kernel config: `defaultConfig(limit)` merged with the optional\n * nudge thresholds (merged into the defaults, never replacing them wholesale)\n * and any additional `coreOverrides`.\n */\nexport function kernelConfigFor(input: KernelConfigInput): Config {\n  const nudgePatch: Partial<Config['nudge']> = {}\n  if (input.nudgeMinContextLimitPct !== undefined) nudgePatch.minContextLimitPct = input.nudgeMinContextLimitPct\n  if (input.nudgeMaxContextLimitPct !== undefined) nudgePatch.maxContextLimitPct = input.nudgeMaxContextLimitPct\n  if (input.nudgeEmergencyThresholdPct !== undefined) nudgePatch.emergencyThresholdPct = input.nudgeEmergencyThresholdPct\n\n  const overrides: Partial<Config> = { ...input.coreOverrides }\n  if (Object.keys(nudgePatch).length > 0) {\n    overrides.nudge = { ...defaultConfig(input.modelContextLimit).nudge, ...nudgePatch }\n  }\n  return defaultConfig(input.modelContextLimit, overrides)\n}\n","/**\n * M5 — durable region transaction and the log-rebuilt block ledger.\n *\n * Modeled on `dsh-compaction-basic/src/region.ts` (which is package-internal\n * and not exported by the seam): validate the surface range and tool-call/result\n * pairing, take the durable `compaction/start` lock, record `compaction/summary`\n * as the shadow price, land the `user/message` surface replacement carrying the\n * summary under `compactCheckpointSource`, and release the lock with\n * `compaction/end`. The original events stay in the append-only log, so\n * decompress/search/status can rebuild everything from the log.\n * @module billion-context-dsh/region\n */\n\nimport { randomUUID } from 'node:crypto'\nimport type { Session, SessionEvent } from '@deepseek-ai/dsh-session'\nimport {\n  CompactionId,\n  compactCheckpointSource,\n  toolPairingBalancedAfter,\n  toolPairingBalancedBefore,\n} from '@deepseek-ai/dsh-compaction'\nimport { createUserMessage, type ContentBlock } from '@deepseek-ai/dsh-llm'\nimport { extractText } from './messages.ts'\n\n/** One durable ACP block as rebuilt from the session log. */\nexport interface AcpBlockLedgerEntry {\n  /** The compaction transaction id (stable block identity). */\n  readonly blockId: string\n  readonly summary: string\n  readonly shadowedSeqs: readonly number[]\n  readonly shadowedTokenCount: number\n  readonly start: number\n  readonly end: number\n}\n\n/** The open turn number, or null when the log ends between turns. */\nexport function findOpenTurn(events: readonly SessionEvent[]): number | null {\n  let open: number | null = null\n  for (const event of events) {\n    if (event.type === 'turn/start') open = event.data.turn\n    else if (event.type === 'turn/end' && event.data.turn === open) open = null\n  }\n  return open\n}\n\n/** Reject a second concurrent compaction for the same session. */\nexport function assertNoActiveCompaction(events: readonly SessionEvent[]): void {\n  let active = false\n  for (const event of events) {\n    if (event.type === 'compaction/start') active = true\n    else if (event.type === 'compaction/end') active = false\n  }\n  if (active) {\n    throw new Error('billion-context-dsh: another compaction is already active for this session')\n  }\n}\n\n/**\n * Validate one inclusive surface span and adjust its edges to the nearest\n * tool-pairing-balanced cuts. Missing or reversed ranges still throw; an\n * edge that sits inside a tool-call/result pair is nudged outward to the\n * closest clean cut instead (models routinely pick edges from the nudge's\n * range table that straddle a pair). The returned range is what a caller\n * should actually shadow.\n */\nexport function resolveSurfaceRange(\n  session: Session,\n  start: number,\n  end: number,\n): { start: number; end: number } {\n  const nodes = session.surface.nodes\n  let startIdx = nodes.indexOf(start)\n  let endIdx = nodes.indexOf(end)\n  if (startIdx < 0 || endIdx < 0) {\n    throw new Error(`billion-context-dsh: seq ${start}..${end} not in the current surface`)\n  }\n  if (startIdx > endIdx) {\n    throw new Error(`billion-context-dsh: reversed range ${start}..${end}`)\n  }\n  // Nudge the start forward and the end backward to the nearest balanced cuts.\n  while (startIdx <= endIdx && !toolPairingBalancedBefore(session, nodes[startIdx]!)) {\n    startIdx += 1\n  }\n  while (endIdx >= startIdx && !toolPairingBalancedAfter(session, nodes[endIdx]!)) {\n    endIdx -= 1\n  }\n  if (startIdx > endIdx) {\n    throw new Error(\n      `billion-context-dsh: no tool-pairing-balanced range inside seq ${start}..${end} — `\n      + 'narrow the range or consult acp_status for the current surface',\n    )\n  }\n  return { start: nodes[startIdx]!, end: nodes[endIdx]! }\n}\n\n/** The surface seqs shadowed by the inclusive positional span. */\nexport function shadowedSeqsOf(session: Session, start: number, end: number): number[] {\n  const nodes = session.surface.nodes\n  const startIdx = nodes.indexOf(start)\n  const endIdx = nodes.indexOf(end)\n  return nodes.slice(startIdx, endIdx + 1)\n}\n\nexport interface CompactionTransactionInput {\n  readonly start: number\n  readonly end: number\n  readonly shadowedSeqs: readonly number[]\n  readonly summary: ContentBlock[]\n  readonly shadowedTokenCount: number\n  readonly provider: string\n  readonly model: string\n}\n\n/**\n * Run one durable compression transaction. Throws on invalid state; on success\n * the four events are in the log and the surface has one summary node.\n */\nexport function runCompactionTransaction(\n  session: Session,\n  input: CompactionTransactionInput,\n): { compactionId: string; seqs: number[] } {\n  assertNoActiveCompaction(session.events)\n  const turn = findOpenTurn(session.events)\n  const compactionId = CompactionId(randomUUID())\n  const seqs: number[] = []\n\n  seqs.push(session.append('compaction/start', { compactionId, turn }).seq)\n  seqs.push(session.append('compaction/summary', {\n    compactionId,\n    summary: input.summary,\n    shadowedRange: { start: input.start, end: input.end },\n    shadowedSeqs: [...input.shadowedSeqs],\n    shadowedTokenCount: input.shadowedTokenCount,\n    provider: input.provider,\n    model: input.model,\n  }).seq)\n\n  const message = createUserMessage({\n    content: input.summary,\n    source: compactCheckpointSource(compactionId),\n  })\n  seqs.push(session.append('user/message', message, {\n    surfaceOp: { op: 'replace', start: input.start, end: input.end },\n    sourceEventSeqs: [...input.shadowedSeqs],\n  }).seq)\n\n  seqs.push(session.append('compaction/end', { compactionId, turn }).seq)\n  return { compactionId, seqs }\n}\n\n/** Rebuild the block ledger from the durable log (no kernel state needed). */\nexport function rebuildBlockLedger(events: readonly SessionEvent[]): AcpBlockLedgerEntry[] {\n  const ledger: AcpBlockLedgerEntry[] = []\n  for (const event of events) {\n    if (event.type !== 'compaction/summary') continue\n    const data = event.data\n    ledger.push({\n      blockId: data.compactionId,\n      summary: extractText(data.summary),\n      shadowedSeqs: [...data.shadowedSeqs],\n      shadowedTokenCount: data.shadowedTokenCount,\n      start: data.shadowedRange.start,\n      end: data.shadowedRange.end,\n    })\n  }\n  return ledger\n}\n","/**\n * M1 — session-log projection: DSH surface events → acp-kernel CoreMessage.\n *\n * The ACP kernel is message-array based; DSH is event-log based. This module\n * is the bridge in the direction the engine needs (projectEvent /\n * eventsToCoreMessages). The reverse direction (CoreMessage[] → session\n * appends) is the M5 region transaction's job.\n * Mirrors billion-context-pi's `projectMessage`/`entriesToCoreMessages`\n * against DSH event shapes (see V-verification: SurfaceEventType =\n * 'user/message' | 'assistant/message' | 'tool/result').\n * @module billion-context-pi-dsh/messages\n */\n\nimport type { CoreMessage } from 'acp-kernel'\nimport type { SessionEvent } from '@deepseek-ai/dsh-session'\n\n/**\n * Extract plain text from a DSH content block array or string.\n *\n * Recursive: a real DSH `tool-result` block is `{ type: 'tool-result',\n * toolCallId, content: ContentBlock[] }` — the inner `content` array holds\n * the actual `text` blocks, so a top-level-only walk would drop every tool\n * result from the projection (and with it the seq's ref assignment, breaking\n * compress boundary resolution). Nested arrays are flattened depth-first.\n */\nexport function extractText(content: unknown): string {\n  if (typeof content === 'string') return content\n  if (!Array.isArray(content)) return ''\n  const parts: string[] = []\n  for (const block of content) {\n    if (block === null || typeof block !== 'object') continue\n    const b = block as { type?: unknown; text?: unknown; content?: unknown }\n    if (b.type === 'text' && typeof b.text === 'string') {\n      parts.push(b.text)\n    } else if (Array.isArray(b.content)) {\n      parts.push(extractText(b.content))\n    }\n  }\n  return parts.join('\\n')\n}\n\ninterface ToolCallBlock {\n  type: 'tool-call'\n  id?: string\n  name?: string\n  arguments?: unknown\n}\n\nfunction toolCallsOf(content: unknown): ToolCallBlock[] {\n  if (!Array.isArray(content)) return []\n  return content.filter((b): b is ToolCallBlock => (b as { type?: string }).type === 'tool-call')\n}\n\nfunction stringifyArgs(args: unknown): string {\n  if (!args) return ''\n  if (typeof args === 'string') return args\n  try {\n    return JSON.stringify(args)\n  } catch {\n    return String(args)\n  }\n}\n\n/**\n * Project one surface message event into CoreMessage(s).\n *  - user/message      → user text (verbatim content)\n *  - assistant/message → assistant text, or one CoreMessage per tool-call\n *  - tool/result       → tool result (toolName/toolCallId, role 'tool')\n * Non-surface events project to nothing.\n */\nexport function projectEvent(event: SessionEvent): CoreMessage[] {\n  switch (event.type) {\n    case 'user/message': {\n      const text = extractText((event.data as { content?: unknown }).content)\n      return text.length > 0 ? [{ id: String(event.seq), role: 'user', contentType: 'text', text }] : []\n    }\n    case 'assistant/message': {\n      const content = (event.data as { message?: { content?: unknown } }).message?.content\n      const calls = toolCallsOf(content)\n      const text = extractText(content)\n      if (calls.length === 0) {\n        return text.trim().length > 0\n          ? [{ id: String(event.seq), role: 'assistant', contentType: 'text', text }]\n          : []\n      }\n      if (calls.length === 1) {\n        const call = calls[0]!\n        const argStr = stringifyArgs(call.arguments)\n        const body = argStr && text ? `${text}\\n${argStr}` : argStr || text\n        return [{\n          id: String(event.seq),\n          role: 'assistant',\n          contentType: 'tool-call',\n          toolName: call.name ?? '',\n          toolCallId: call.id ?? '',\n          text: body,\n        }]\n      }\n      return calls.map((call) => ({\n        id: `${event.seq}#${call.id ?? ''}`,\n        role: 'assistant' as const,\n        contentType: 'tool-call' as const,\n        toolName: call.name ?? '',\n        toolCallId: call.id ?? '',\n        text: stringifyArgs(call.arguments) || text,\n      }))\n    }\n    case 'tool/result': {\n      const message = (event.data as {\n        message?: { content?: unknown; toolName?: string; toolCallId?: string }\n      }).message\n      const text = extractText(message?.content)\n      if (text.length === 0) return []\n      return [{\n        id: String(event.seq),\n        role: 'tool',\n        contentType: 'tool-result',\n        toolName: message?.toolName ?? '',\n        toolCallId: message?.toolCallId ?? '',\n        text,\n      }]\n    }\n    default:\n      return []\n  }\n}\n\n/** Project a session's message events into CoreMessage[] in log order. */\nexport function eventsToCoreMessages(events: readonly SessionEvent[]): CoreMessage[] {\n  const out: CoreMessage[] = []\n  for (const event of events) out.push(...projectEvent(event))\n  return out\n}\n\n/** The surface-visible message events of a session, in model-visible order. */\nexport function surfaceEventsOf(session: import('@deepseek-ai/dsh-session').Session): SessionEvent[] {\n  return session.surface.nodes\n    .map((seq) => session.events[seq])\n    .filter((event): event is SessionEvent => event !== undefined)\n}\n\n/** Extract the model-facing text of any surface message event. */\nexport function extractEventText(event: SessionEvent): string {\n  switch (event.type) {\n    case 'user/message':\n      return extractText((event.data as { content?: unknown }).content)\n    case 'assistant/message':\n      return extractText((event.data as { message?: { content?: unknown } }).message?.content)\n    case 'tool/result':\n      return extractText((event.data as { message?: { content?: unknown } }).message?.content)\n    default:\n      return ''\n  }\n}\n","/**\n * M4 — the `/acp` slash command: a human-friendly window into the same\n * machinery the model tools expose (status, one-shot compress, decompress).\n * @module billion-context-dsh/commands\n */\n\nimport type { CommandDefinition } from '@deepseek-ai/dsh-commands'\nimport type { Agent } from '@deepseek-ai/dsh-agent'\nimport type { ToolEnvironment } from './tools.ts'\nimport {\n  rebuildBlockLedger,\n  resolveSurfaceRange,\n  runCompactionTransaction,\n  shadowedSeqsOf,\n} from './region.ts'\nimport { eventsToCoreMessages, extractEventText, surfaceEventsOf } from './messages.ts'\nimport { defaultConfig, estimateTokensFast } from 'acp-kernel'\n\nfunction statusText(env: ToolEnvironment, agent: Agent): string {\n  const session = agent.session\n  const ledger = rebuildBlockLedger(session.events)\n  const totalTokens = ledger.reduce((sum, block) => sum + block.shadowedTokenCount, 0)\n  const coreMessages = eventsToCoreMessages(surfaceEventsOf(session))\n  const estimated = coreMessages.reduce((sum, message) => sum + estimateTokensFast(message.text ?? ''), 0)\n  const limit = env.modelContextLimit\n  const lines = [\n    `ACP status — session ${session.id}`,\n    `  blocks: ${ledger.length}`,\n    `  tokens compressed: ${totalTokens}`,\n    `  estimated context: ${estimated} / ${limit} (${Math.round((estimated / limit) * 100)}%)`,\n  ]\n  for (const block of ledger.slice(0, 10)) {\n    lines.push(`  - ${block.blockId.slice(0, 8)}: seqs ${block.start}..${block.end} — ${block.summary.slice(0, 80)}`)\n  }\n  return lines.join('\\n')\n}\n\nfunction compressText(env: ToolEnvironment, agent: Agent, args: string[]): string {\n  if (args.length < 3) {\n    return '/acp compress <startSeq> <endSeq> <summary...>'\n  }\n  const startSeq = Number(args[0])\n  const endSeq = Number(args[1])\n  const summary = args.slice(2).join(' ')\n  if (!Number.isInteger(startSeq) || !Number.isInteger(endSeq)) {\n    return '/acp compress: startSeq and endSeq must be integers'\n  }\n  const session = agent.session\n  const { start, end } = resolveSurfaceRange(session, startSeq, endSeq)\n  const shadowed = shadowedSeqsOf(session, startSeq, endSeq)\n  const { compactionId } = runCompactionTransaction(session, {\n    start,\n    end,\n    shadowedSeqs: shadowed,\n    summary: [{ type: 'text', text: summary }],\n    shadowedTokenCount: 0,\n    provider: agent.options.provider ?? '',\n    model: agent.options.model ?? '',\n  })\n  return `Compressed seqs ${start}..${end} (${shadowed.length} messages) as block ${compactionId.slice(0, 8)}`\n}\n\nfunction decompressText(_env: ToolEnvironment, agent: Agent, args: string[]): string {\n  if (args.length < 1) return '/acp decompress <blockId>'\n  const session = agent.session\n  const ledger = rebuildBlockLedger(session.events)\n  const block = ledger.find((entry) => entry.blockId.startsWith(args[0]!))\n  if (block === undefined) return `block \"${args[0]}\" not found (see /acp status)`\n  const parts = block.shadowedSeqs\n    .map((seq) => extractEventText(session.events[seq]!))\n    .filter((text) => text.length > 0)\n  return `Block ${block.blockId} — ${block.summary}\\n\\n${parts.join('\\n\\n') || '(no recoverable content)'}`\n}\n\n/** Register the /acp command (idempotent per engine). */\nexport function acpCommand(env: ToolEnvironment): CommandDefinition {\n  return {\n    name: 'acp',\n    description:\n      'Active Context Pruning — model-driven context compression. '\n      + 'Usage: /acp status | /acp compress <startSeq> <endSeq> <summary> | /acp decompress <blockId>',\n    handler: async (invocation) => {\n      const raw = invocation.rawInput.trim()\n      if (raw === '' || raw === 'status') {\n        return { kind: 'success', text: statusText(env, invocation.agent) }\n      }\n      if (raw.startsWith('compress')) {\n        return { kind: 'success', text: compressText(env, invocation.agent, raw.slice('compress'.length).trim().split(/\\s+/) ) }\n      }\n      if (raw.startsWith('decompress')) {\n        return { kind: 'success', text: decompressText(env, invocation.agent, raw.slice('decompress'.length).trim().split(/\\s+/)) }\n      }\n      return { kind: 'error', text: `unknown /acp subcommand \"${raw.split(/\\s+/)[0]}\" — use status | compress | decompress` }\n    },\n  }\n}\n","/**\n * M4 — ACP nudge: the kernel's compression recommendation, rendered as an\n * injected user message with a seq-based compressible-range table (D1:\n * \"seq is the ref\" — DSH has no in-memory message rewrite hook, so the model\n * targets ranges by surface seq rather than by <acp> tags).\n * @module billion-context-dsh/nudge\n */\n\nimport {\n  estimateTokensFast,\n  type CompressionCore,\n  type NudgeDecision,\n} from 'acp-kernel'\nimport { createUserMessage, type UserMessage } from '@deepseek-ai/dsh-llm'\nimport type { Agent } from '@deepseek-ai/dsh-agent'\nimport { AcpStateStore } from './state.ts'\nimport { eventsToCoreMessages, surfaceEventsOf } from './messages.ts'\nimport { findOpenTurn } from './region.ts'\nimport { kernelConfigFor, type KernelConfigInput } from './config.ts'\n\n/** Kernel inputs the nudge path shares with the compress tool. */\nexport interface NudgeEnvironment extends KernelConfigInput {\n  readonly kernel: CompressionCore\n  readonly store: AcpStateStore\n}\n\nexport interface NudgeOutcome {\n  readonly message: UserMessage\n  readonly emergency: boolean\n}\n\n/** Render the compressible-range table as seq refs for the model. */\nfunction rangeTable(nudge: NudgeDecision, state: { messageRefs: { byRef: Record<string, string> } }): string {\n  const byRef = state.messageRefs.byRef\n  const lines = nudge.compressibleRanges.slice(0, 6).map((range) => {\n    const startRaw = byRef[range.startRef]\n    const endRaw = byRef[range.endRef]\n    if (startRaw === undefined || endRaw === undefined) return null\n    return `  - seq ${startRaw}..${endRaw} — ${range.count} messages, ~${range.tokens} tokens`\n  })\n  const visible = lines.filter((line): line is string => line !== null)\n  if (visible.length === 0) return ''\n  return [\n    '',\n    'Compressible ranges (refs are surface seqs):',\n    ...visible,\n    'Compress with: compress({ content: [{ startSeq, endSeq, summary }] })',\n  ].join('\\n')\n}\n\n/**\n * Decide and build one nudge message for the agent's next pre-step. Returns\n * null when the kernel recommends no nudge or one was already injected for the\n * current turn (emergency nudges always bypass the dedup). Also advances the\n * in-memory kernel state (ref assignment) so the compress tool can resolve\n * seq → mNNNNN refs.\n */\nexport function buildNudge(\n  agent: Agent,\n  env: NudgeEnvironment,\n  lastNudgeTurn: Map<string, number>,\n): NudgeOutcome | null {\n  const session = agent.session\n  const state = env.store.stateFor(session)\n  const coreMessages = eventsToCoreMessages(surfaceEventsOf(session))\n  const tokenCount = coreMessages.reduce((sum, message) => sum + estimateTokensFast(message.text ?? ''), 0)\n  const config = kernelConfigFor(env)\n  const turn = env.kernel.processTurn({ messages: coreMessages, state, config, tokenCount })\n  env.store.set(session, turn.state)\n\n  const nudge = turn.nudge\n  if (nudge === undefined || !nudge.shouldInject) return null\n  const emergency = nudge.breakdown?.emergencyOverride === 1\n\n  const turnNumber = findOpenTurn(session.events) ?? 0\n  const alreadyShown = !emergency && lastNudgeTurn.get(session.id) === turnNumber\n  if (alreadyShown) return null\n  lastNudgeTurn.set(session.id, turnNumber)\n\n  const text = buildNudgeText(nudge, emergency, turn.state)\n  const message = createUserMessage({\n    content: [{ type: 'text', text }],\n    source: { kind: 'plugin', plugin: 'acp-nudge' },\n  })\n  return { message, emergency }\n}\n\n/**\n * A short ADVISORY nudge — ACP is model-driven, the model decides whether and\n * when to compress. Full guidance (tools, philosophy, summary rules) lives in\n * the system prompt once, not in every nudge.\n */\nfunction buildNudgeText(\n  nudge: NudgeDecision,\n  emergency: boolean,\n  state: { messageRefs: { byRef: Record<string, string> } },\n): string {\n  const pct = Math.round(nudge.contextUsage * 100)\n  const frame = emergency\n    ? `⚠️ Context usage is at ${pct}% of the window — nearly full. Consider compressing consumed ranges soon so working context stays available; the choice and timing are yours.`\n    : `Context usage is at ${pct}%. This is a suggestion, not a requirement — you decide whether and when to compress.`\n  const guidance = 'Compress by need, not by percentage: replace only ranges you have genuinely consumed, with dense self-contained summaries.'\n  return [frame, '', guidance, rangeTable(nudge, state)].join('\\n')\n}\n","/**\n * M4 — the ACP system-prompt section (DSH counterpart of billion-context-pi's\n * ACP_SYSTEM_PROMPT): the load-bearing compression guidance lives here, ONCE,\n * instead of being re-sent with every nudge. The nudge itself stays a short,\n * advisory notice — ACP is model-driven, the model decides whether and when\n * to compress (never \"compress now\").\n * @module billion-context-dsh/system-prompt\n */\n\nimport { COMPRESS_PHILOSOPHY } from 'acp-kernel'\n\nexport const ACP_SYSTEM_PROMPT = `Active Context Pruning — model-driven context management\n\nYOU decide whether and when to compress context. Nothing forces you: the injected \"nudge\" is a suggestion, not an order, and you may ignore it when compression would not help. Compress only ranges you have genuinely consumed (read tool outputs, finished explorations, superseded steps) that the current work no longer needs verbatim.\n\n${COMPRESS_PHILOSOPHY}\n\nCompression tools (refs are SURFACE SEQS, not ids):\n- compress: replace a seq range with your dense self-contained summary. compress({ content: [{ startSeq, endSeq, summary }] }). Edges are auto-balanced to tool-call/result boundaries; a trailing #callId fragment in a seq is ignored. Ranges must be on the current surface — stale seqs fail with guidance.\n- decompress: recover a compressed block's original content, read-only. decompress({ blockId }).\n- search_context: find information inside compressed blocks BEFORE decompressing. search_context({ query }).\n- acp_status: current context usage and the live compressible-range list. Run it before compressing when in doubt.\n\nWhen you write a summary, it becomes the ONLY record of that range: keep file paths, signatures, exact values, decisions, and error strings verbatim so a later reader (or you, after decompress) can continue without the original. Never reuse historical seqs — the surface moves as messages land and compress; verify with acp_status.`\n\n/** System-prompt section order: tool guidance lives in 100–199. */\nexport const ACP_SYSTEM_PROMPT_ORDER = 150\n"],"mappings":"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","names":["estimateTokensFast","estimateTokensFast","createUserMessage","message","estimateTokensFast","createUserMessage"]}

package/dist/messages.d.ts

@@ -0,0 +1,38 @@
+/**
+ * M1 — session-log projection: DSH surface events → acp-kernel CoreMessage.
+ *
+ * The ACP kernel is message-array based; DSH is event-log based. This module
+ * is the bridge in the direction the engine needs (projectEvent /
+ * eventsToCoreMessages). The reverse direction (CoreMessage[] → session
+ * appends) is the M5 region transaction's job.
+ * Mirrors billion-context-pi's `projectMessage`/`entriesToCoreMessages`
+ * against DSH event shapes (see V-verification: SurfaceEventType =
+ * 'user/message' | 'assistant/message' | 'tool/result').
+ * @module billion-context-pi-dsh/messages
+ */
+import type { CoreMessage } from 'acp-kernel';
+import type { SessionEvent } from '@deepseek-ai/dsh-session';
+/**
+ * Extract plain text from a DSH content block array or string.
+ *
+ * Recursive: a real DSH `tool-result` block is `{ type: 'tool-result',
+ * toolCallId, content: ContentBlock[] }` — the inner `content` array holds
+ * the actual `text` blocks, so a top-level-only walk would drop every tool
+ * result from the projection (and with it the seq's ref assignment, breaking
+ * compress boundary resolution). Nested arrays are flattened depth-first.
+ */
+export declare function extractText(content: unknown): string;
+/**
+ * Project one surface message event into CoreMessage(s).
+ *  - user/message      → user text (verbatim content)
+ *  - assistant/message → assistant text, or one CoreMessage per tool-call
+ *  - tool/result       → tool result (toolName/toolCallId, role 'tool')
+ * Non-surface events project to nothing.
+ */
+export declare function projectEvent(event: SessionEvent): CoreMessage[];
+/** Project a session's message events into CoreMessage[] in log order. */
+export declare function eventsToCoreMessages(events: readonly SessionEvent[]): CoreMessage[];
+/** The surface-visible message events of a session, in model-visible order. */
+export declare function surfaceEventsOf(session: import('@deepseek-ai/dsh-session').Session): SessionEvent[];
+/** Extract the model-facing text of any surface message event. */
+export declare function extractEventText(event: SessionEvent): string;

package/dist/nudge.d.ts

@@ -0,0 +1,29 @@
+/**
+ * M4 — ACP nudge: the kernel's compression recommendation, rendered as an
+ * injected user message with a seq-based compressible-range table (D1:
+ * "seq is the ref" — DSH has no in-memory message rewrite hook, so the model
+ * targets ranges by surface seq rather than by <acp> tags).
+ * @module billion-context-dsh/nudge
+ */
+import { type CompressionCore } from 'acp-kernel';
+import { type UserMessage } from '@deepseek-ai/dsh-llm';
+import type { Agent } from '@deepseek-ai/dsh-agent';
+import { AcpStateStore } from './state.ts';
+import { type KernelConfigInput } from './config.ts';
+/** Kernel inputs the nudge path shares with the compress tool. */
+export interface NudgeEnvironment extends KernelConfigInput {
+    readonly kernel: CompressionCore;
+    readonly store: AcpStateStore;
+}
+export interface NudgeOutcome {
+    readonly message: UserMessage;
+    readonly emergency: boolean;
+}
+/**
+ * Decide and build one nudge message for the agent's next pre-step. Returns
+ * null when the kernel recommends no nudge or one was already injected for the
+ * current turn (emergency nudges always bypass the dedup). Also advances the
+ * in-memory kernel state (ref assignment) so the compress tool can resolve
+ * seq → mNNNNN refs.
+ */
+export declare function buildNudge(agent: Agent, env: NudgeEnvironment, lastNudgeTurn: Map<string, number>): NudgeOutcome | null;

package/dist/region.d.ts

@@ -0,0 +1,61 @@
+/**
+ * M5 — durable region transaction and the log-rebuilt block ledger.
+ *
+ * Modeled on `dsh-compaction-basic/src/region.ts` (which is package-internal
+ * and not exported by the seam): validate the surface range and tool-call/result
+ * pairing, take the durable `compaction/start` lock, record `compaction/summary`
+ * as the shadow price, land the `user/message` surface replacement carrying the
+ * summary under `compactCheckpointSource`, and release the lock with
+ * `compaction/end`. The original events stay in the append-only log, so
+ * decompress/search/status can rebuild everything from the log.
+ * @module billion-context-dsh/region
+ */
+import type { Session, SessionEvent } from '@deepseek-ai/dsh-session';
+import { type ContentBlock } from '@deepseek-ai/dsh-llm';
+/** One durable ACP block as rebuilt from the session log. */
+export interface AcpBlockLedgerEntry {
+    /** The compaction transaction id (stable block identity). */
+    readonly blockId: string;
+    readonly summary: string;
+    readonly shadowedSeqs: readonly number[];
+    readonly shadowedTokenCount: number;
+    readonly start: number;
+    readonly end: number;
+}
+/** The open turn number, or null when the log ends between turns. */
+export declare function findOpenTurn(events: readonly SessionEvent[]): number | null;
+/** Reject a second concurrent compaction for the same session. */
+export declare function assertNoActiveCompaction(events: readonly SessionEvent[]): void;
+/**
+ * Validate one inclusive surface span and adjust its edges to the nearest
+ * tool-pairing-balanced cuts. Missing or reversed ranges still throw; an
+ * edge that sits inside a tool-call/result pair is nudged outward to the
+ * closest clean cut instead (models routinely pick edges from the nudge's
+ * range table that straddle a pair). The returned range is what a caller
+ * should actually shadow.
+ */
+export declare function resolveSurfaceRange(session: Session, start: number, end: number): {
+    start: number;
+    end: number;
+};
+/** The surface seqs shadowed by the inclusive positional span. */
+export declare function shadowedSeqsOf(session: Session, start: number, end: number): number[];
+export interface CompactionTransactionInput {
+    readonly start: number;
+    readonly end: number;
+    readonly shadowedSeqs: readonly number[];
+    readonly summary: ContentBlock[];
+    readonly shadowedTokenCount: number;
+    readonly provider: string;
+    readonly model: string;
+}
+/**
+ * Run one durable compression transaction. Throws on invalid state; on success
+ * the four events are in the log and the surface has one summary node.
+ */
+export declare function runCompactionTransaction(session: Session, input: CompactionTransactionInput): {
+    compactionId: string;
+    seqs: number[];
+};
+/** Rebuild the block ledger from the durable log (no kernel state needed). */
+export declare function rebuildBlockLedger(events: readonly SessionEvent[]): AcpBlockLedgerEntry[];

package/dist/state.d.ts

@@ -0,0 +1,20 @@
+/**
+ * M2 — per-session ACP kernel state.
+ *
+ * The in-memory map holds the exact acp-kernel `CompressionState` while a
+ * session is live. Durability does not rely on a sidecar file: every durable
+ * compression writes a `compaction/summary` event whose shadowed range and
+ * summary re-derive the block ledger (`rebuildBlockLedger` in region.ts), so a
+ * restarted engine can answer decompress/search/status from the session log
+ * alone — DSH's "log is the source of truth" model.
+ * @module billion-context-dsh/state
+ */
+import type { Session } from '@deepseek-ai/dsh-session';
+import { type CompressionState } from 'acp-kernel';
+export declare class AcpStateStore {
+    private readonly states;
+    /** Kernel state for one session, initialised on first access. */
+    stateFor(session: Session): CompressionState;
+    set(session: Session, state: CompressionState): void;
+    delete(session: Session): void;
+}

package/dist/system-prompt.d.ts

@@ -0,0 +1,11 @@
+/**
+ * M4 — the ACP system-prompt section (DSH counterpart of billion-context-pi's
+ * ACP_SYSTEM_PROMPT): the load-bearing compression guidance lives here, ONCE,
+ * instead of being re-sent with every nudge. The nudge itself stays a short,
+ * advisory notice — ACP is model-driven, the model decides whether and when
+ * to compress (never "compress now").
+ * @module billion-context-dsh/system-prompt
+ */
+export declare const ACP_SYSTEM_PROMPT = "Active Context Pruning \u2014 model-driven context management\n\nYOU decide whether and when to compress context. Nothing forces you: the injected \"nudge\" is a suggestion, not an order, and you may ignore it when compression would not help. Compress only ranges you have genuinely consumed (read tool outputs, finished explorations, superseded steps) that the current work no longer needs verbatim.\n\nCompression Philosophy:\n- All compression serves the primary task, but be frugal.\n- Context capacity is precious. Save context by compressing consumed outputs, not by avoiding tools.\n- Compress by need, not by percentage.\n- Work from summaries, not raw tool outputs. All listed ranges (user prompts, tool outputs, code, logs, exploration, intermediate steps) should be compressed to summary format \u2014 the ONLY exceptions are protected content, content the current step is actively using, or critical content you cannot reconstruct.\n\nCompression tools (refs are SURFACE SEQS, not ids):\n- compress: replace a seq range with your dense self-contained summary. compress({ content: [{ startSeq, endSeq, summary }] }). Edges are auto-balanced to tool-call/result boundaries; a trailing #callId fragment in a seq is ignored. Ranges must be on the current surface \u2014 stale seqs fail with guidance.\n- decompress: recover a compressed block's original content, read-only. decompress({ blockId }).\n- search_context: find information inside compressed blocks BEFORE decompressing. search_context({ query }).\n- acp_status: current context usage and the live compressible-range list. Run it before compressing when in doubt.\n\nWhen you write a summary, it becomes the ONLY record of that range: keep file paths, signatures, exact values, decisions, and error strings verbatim so a later reader (or you, after decompress) can continue without the original. Never reuse historical seqs \u2014 the surface moves as messages land and compress; verify with acp_status.";
+/** System-prompt section order: tool guidance lives in 100–199. */
+export declare const ACP_SYSTEM_PROMPT_ORDER = 150;

package/dist/tools.d.ts

@@ -0,0 +1,21 @@
+/**
+ * M3 — the four model tools: compress / decompress / search_context /
+ * acp_status, registered through `ctx.tools` (defineTool).
+ *
+ * compress is the heart of ACP: the model writes the summary and the tool
+ * lands it as a durable surface replacement (no second LLM summarization
+ * call). decompress recovers shadowed content read-only from the log (DSH
+ * keeps the originals — V5). search_context scores blocks rebuilt from the
+ * log. acp_status reports the block ledger and pressure.
+ * @module billion-context-dsh/tools
+ */
+import { type ToolDefinition } from '@deepseek-ai/dsh-tools';
+import { type CompressionCore } from 'acp-kernel';
+import type { AcpStateStore } from './state.ts';
+import { type KernelConfigInput } from './config.ts';
+export interface ToolEnvironment extends KernelConfigInput {
+    readonly kernel: CompressionCore;
+    readonly store: AcpStateStore;
+}
+/** Build the four ACP model tools bound to one engine. */
+export declare function makeTools(env: ToolEnvironment): ToolDefinition[];

package/package.json

@@ -0,0 +1,51 @@
+{
+	"name": "billion-context-dsh",
+	"version": "0.1.0",
+	"description": "Active Context Pruning (ACP) for the DeepSeek Harness — model-driven context management as a CompactionEngine backend.",
+	"type": "module",
+	"main": "dist/index.js",
+	"types": "dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		}
+	},
+	"files": [
+		"dist",
+		"README.md",
+		"README.zh-CN.md",
+		"LICENSE"
+	],
+	"sideEffects": false,
+	"license": "MIT",
+	"engines": {
+		"node": ">=20"
+	},
+	"scripts": {
+		"typecheck": "tsc --noEmit",
+		"build": "tsup && tsc --emitDeclarationOnly",
+		"test": "node --import tsx --test tests/*.test.ts"
+	},
+	"dependencies": {
+		"acp-kernel": "0.0.23"
+	},
+	"peerDependencies": {
+		"@deepseek-ai/cordis": "^4.0.1",
+		"@deepseek-ai/dsh-compaction": "^0.1.0-rc.6"
+	},
+	"devDependencies": {
+		"@deepseek-ai/cordis": "4.0.1",
+		"@deepseek-ai/dsh-agent": "0.1.0-rc.6",
+		"@deepseek-ai/dsh-commands": "0.1.0-rc.6",
+		"@deepseek-ai/dsh-compaction": "0.1.0-rc.6",
+		"@deepseek-ai/dsh-llm": "0.1.0-rc.6",
+		"@deepseek-ai/dsh-session": "0.1.0-rc.6",
+		"@deepseek-ai/dsh-tools": "0.1.0-rc.6",
+		"@deepseek-ai/schemastery": "3.18.1",
+		"@types/node": "^26.1.2",
+		"tsup": "^8.5.1",
+		"tsx": "^4.23.1",
+		"typescript": "^7.0.2"
+	}
+}