billion-context-pi 0.1.67 → 0.1.68-pr.208.191

package/README.md

@@ -24,6 +24,12 @@ The model decides <em>when</em> and <em>what</em> to compress — not a hard lim
 
 > **Host support:** this plugin is for **Pi**. It does **not** support **OMP (oh-my-pi)** — on an OMP host it refuses to run. OMP users: use [billion-context](https://github.com/ranxianglei/billion-context) instead (`bili omp`, built-in plugin). Full client → package table: see [Which do I need?](#which-do-i-need); OMP details: [docs/omp.md](./docs/omp.md).
 
+## Community
+
+Discussion, help, and updates on QQ — one group covers all three projects (`billion-context`, `billion-context-pi`, `opencode-acp`):
+
+**QQ Group: 1056132097**
+
 ## Why?
 
 When conversations get long, the model runs out of context. Most tools hard-truncate — silently dropping earlier messages. **billion-context** gives the model a `compress` tool: the LLM decides **when** and **what** to compress into high-fidelity summaries, preserving critical details (file paths, decisions, error strings) while reclaiming context space.

package/README.zh-CN.md

@@ -22,6 +22,12 @@
 
 > **宿主支持:** 本插件面向 **Pi**。它**不支持 OMP(oh-my-pi)** —— 在 OMP 宿主上会拒绝运行。OMP 用户请直接改用 [billion-context](https://github.com/ranxianglei/billion-context)(启动命令 bili omp);其他客户端的完整对照见[该选哪个?](#该选哪个)。OMP 详细说明:[docs/omp.zh-CN.md](./docs/omp.zh-CN.md)。
 
+## 社区
+
+交流、求助与更新都在 QQ——同一个群覆盖三个项目(`billion-context`、`billion-context-pi`、`opencode-acp`):
+
+**QQ 群:1056132097**
+
 ## 为什么选择 billion-context
 
 当对话变长,模型的上下文会耗尽。多数工具采用硬截断 —— 静默丢弃早期消息。**billion-context** 把 `compress` 工具交给模型:由 LLM 决定**何时**压缩、压缩**什么**,将内容压缩成高保真摘要,在回收上下文空间的同时保留关键细节(文件路径、决策、错误字符串)。

package/dist/absorb-tool.d.ts

@@ -0,0 +1,10 @@
+import { Type } from "typebox";
+import type { ToolDefinition } from "@earendil-works/pi-coding-agent";
+import type { AcpRuntime } from "./runtime.js";
+import { type ToolPromptOverrides } from "./surface.js";
+declare const AbsorbParams: Type.TObject<{
+    ref: Type.TString;
+    summary: Type.TString;
+}>;
+export declare function makeAbsorbTool(runtime: AcpRuntime, name?: string, overrides?: ToolPromptOverrides): ToolDefinition<typeof AbsorbParams>;
+export {};

package/dist/compress-tool.d.ts

@@ -1,6 +1,8 @@
 import { Type, type Static } from "typebox";
 import type { ToolDefinition } from "@earendil-works/pi-coding-agent";
 import type { AcpRuntime } from "./runtime.js";
+import { type ToolPromptOverrides } from "./surface.js";
+import { type CompressionBlock, type CompressionState } from "acp-kernel";
 declare const RangeSpec: Type.TObject<{
     startId: Type.TString;
     endId: Type.TString;
@@ -18,10 +20,14 @@ declare const CompressParams: Type.TObject<{
     summaryMaxChars: Type.TOptional<Type.TNumber>;
 }>;
 type CompressArgs = Static<typeof CompressParams>;
-export declare function makeCompressTool(runtime: AcpRuntime): ToolDefinition<typeof CompressParams>;
+export declare function makeCompressTool(runtime: AcpRuntime, overrides?: ToolPromptOverrides): ToolDefinition<typeof CompressParams>;
 type RangeEntry = Static<typeof RangeSpec>;
 export declare function normalizeRanges(args: CompressArgs): RangeEntry[] | string;
 export declare function tailRepair(s: string): string | undefined;
+/** Panel block count, or -1 for non-panels. Accepts BOTH the legacy
+ *  "… B blocks)" form (0-block runs; historical transcripts replayed by
+ *  index/floor-stale) and the #376 "… blocks: b3=m00044–m00097*, …" form. */
+export declare function compressPanelBlocks(text: string): number;
 /** Success = completed run that created >= 1 block (partial range errors
  *  still count: progress was made). A 0-block panel must NOT be success —
  *  it would reset the retry counter while the emergency nudge re-fires,
@@ -31,4 +37,5 @@ export declare function isCompressSuccessText(text: string): boolean;
  *  range skipped). Counted as a FAILED attempt by noteCompressOutcomes so
  *  the retry cap applies. Non-panels ("No ranges provided.") stay neutral. */
 export declare function isCompressNoopText(text: string): boolean;
+export declare function blockSpanLabel(block: CompressionBlock, state: CompressionState): string;
 export {};

package/dist/config-dir.d.ts

@@ -0,0 +1 @@
+export declare const CONFIG_DIR_NAME: string;

package/dist/config.d.ts

@@ -2,6 +2,8 @@ import { type Config, type Prompts } from "acp-kernel";
 import type { CompressReasoningConfig } from "./reasoning-drop.js";
 import type { DegenerationGuardConfig } from "./degeneration.js";
 import type { ThrottleRetryConfig } from "./throttle-retry.js";
+import type { PiPromptSections } from "./system-prompt.js";
+import type { NudgeSectionsConfig, ToolPromptsConfig } from "./surface.js";
 /** Per-role delegate defaults. Lets long-lived automation pin a cheaper or
  *  more capable model and a thinking level per delegate role, so the main
  *  agent doesn't have to fill them in on every `acp_delegate()` call. */
@@ -18,6 +20,27 @@ export interface DelegateRoleConfig {
      *  value is ignored with a warning (never fails). */
     thinkingLevel?: string;
 }
+/** Instant tool-result absorption settings (small-context mode). Mirrors
+ *  acp-kernel's absorb feature: when enabled, every eligible large tool
+ *  result gets a forced [ACP absorb] prompt and the model must distill it
+ *  via the absorb tool; the original tool-call + tool-result pair is then
+ *  hidden from subsequent turns. */
+export interface AbsorbSettings {
+    /** Enable instant absorption. Default: false. */
+    enabled?: boolean;
+    /** Registered name of the absorb tool. Default: "absorb". */
+    toolName?: string;
+    /** Minimum estimated tokens of a tool result before it demands
+     *  absorption. Smaller results stay as-is. Default: 1000. */
+    minToolTokens?: number;
+    /** Context usage percentage (ratio 0.3 or percent string "30%") above
+     *  which absorption prompts fire. 0 = fire on size alone regardless of
+     *  usage. Default: 0. */
+    contextThresholdPct?: number | string;
+    /** Tool names whose results are never absorb-prompted (in addition to
+     *  ACP's own tools and protectedTools). */
+    excludeTools?: string[];
+}
 /** Delegate sub-agent configuration. */
 export interface DelegateConfig {
     /** Enable acp_delegate tools (delegate/wait/cancel) and their system-prompt
@@ -120,6 +143,13 @@ export interface CompressSettings {
      *  tool calls — see CompressReasoningConfig in src/reasoning-drop.ts.
      *  Merged field-wise (drop, threshold) across the three levels. */
     reasoning?: CompressReasoningConfig;
+    /** Active prompt pack name (see CONFIGURATION.md “Prompt packs”). Base
+     *  level; override per provider/model via `providers`. "default" or unset =
+     *  built-in defaults. Resolved per request against the live model, so
+     *  switching models mid-session switches the pack. Packs ship text-level
+     *  overrides only; a pack's `toolPrompts` follow the base selection (tool
+     *  definitions freeze at extension load, before the model is known). */
+    promptPack?: string;
 }
 /** Per-provider compression overrides. Carries the same tuning fields as the
  *  global level, plus an optional per-model map keyed by model id. */
@@ -207,6 +237,10 @@ export interface AdapterConfig {
     delegate?: boolean | DelegateConfig;
     /** Compression tuning. */
     compress?: CompressConfig;
+    /** Instant tool-result absorption (small-context mode). Accepts a boolean
+     *  shorthand (`true` → enabled with defaults) or an AbsorbSettings object.
+     *  Default: disabled. */
+    absorb?: boolean | AbsorbSettings;
     /** Provider token-throttle (Bedrock "Too many tokens, please wait before
      *  trying again.") auto-retry. Accepts a boolean shorthand (`false`
      *  disables) or a ThrottleRetryConfig object. Default: enabled, 10 retries,
@@ -232,6 +266,14 @@ export interface AdapterConfig {
      *  boolean shorthand (`false` disables) or an object. Default: enabled,
      *  minRun=200. */
     degenerationGuard?: boolean | DegenerationGuardConfig;
+    /** Host multi-session turn-boundary policy (#364). Accepts a boolean
+     *  shorthand (`true` → count host-injected custom_message entries as turn
+     *  boundaries) or a HostSessionConfig object. Default: off — pi-native
+     *  behavior where only genuine user-role messages start a turn, so existing
+     *  single-session users' nudge cadence is unchanged. Enable for inline
+     *  multi-session hosts (Prime RLM & co.) whose injected agent messages must
+     *  delimit real turns. See docs/host-adapter.md. */
+    hostSession?: boolean | HostSessionConfig;
     /** Legacy flat alias for `delegate.displayUsage`. Kept for backward
      *  compatibility with existing acp.json files. Prefer `delegate.displayUsage`. */
     displayUsage?: "merged" | "separate";
@@ -244,6 +286,21 @@ export interface AdapterConfig {
      *  replacing the kernel's tuned compression rules may reduce summary quality
      *  (lost paths/signatures/decisions → worse retrieval). */
     acknowledgePromptsRisk?: boolean;
+    /** Override structural sections of the ACP system prompt (ACP TAGS, TOOLS,
+     *  WHEN TO COMPRESS, ...). Tri-state per section: string = replace, null =
+     *  remove, omitted = default. Not risk-gated — these are documentation
+     *  sections, not compression rules. Set via acp.json. */
+    promptSections?: Partial<PiPromptSections>;
+    /** Override guidance-class nudge texts (efficiencyNote, emergencyHeader,
+     *  t2Guidance, t3Guidance). Same tri-state semantics. Not risk-gated. */
+    nudgeSections?: NudgeSectionsConfig;
+    /** Override the four ACP tool definitions' LLM-facing text (description,
+     *  paramDescriptions, promptSnippet, promptGuidelines). Read synchronously
+     *  at extension load — tool defs are frozen at registration time. */
+    toolPrompts?: ToolPromptsConfig;
+    /** Replace (string) or remove (null) the ACP_DELEGATE_NOTIFICATIONS appendix
+     *  injected when the delegate tool is enabled. */
+    delegatePrompt?: string | null;
     coreOverrides?: Partial<Config>;
 }
 export declare const DEFAULT_TOOL_BASH_TIMEOUT = 60;
@@ -267,6 +324,21 @@ export declare function resolveRepetitionGuard(adapter: AdapterConfig): {
     warn: number;
     abort: number;
 };
+/** Host multi-session turn-boundary policy (#364). See TurnBoundaryPolicy in
+ *  src/turn-boundary.ts for the semantics this resolves. */
+export interface HostSessionConfig {
+    /** Count host-injected custom_message entries (agent_message) as turn
+     *  boundaries. Default: false (pi-native behavior). */
+    countCustomMessages?: boolean;
+}
+export interface ResolvedHostSession {
+    countCustomMessages: boolean;
+}
+/** Resolve the host-session turn-boundary policy from the adapter, handling
+ *  the boolean shorthand (`true` enables countCustomMessages). Invalid values
+ *  fall back to the pi-native default (off) with a logged warning — they never
+ *  fail the session. */
+export declare function resolveHostSession(adapter: AdapterConfig): ResolvedHostSession;
 /** Per-field deepest-wins merge of the three compression levels (global →
  *  provider → model). An undefined field at a deeper level does NOT clear a
  *  value set at a shallower level — only a defined value overrides. */
@@ -277,5 +349,14 @@ export declare function mergeCompress(global?: CompressSettings, provider?: Comp
  *  at any level. The Pi adapter keys providers by name (ctx.model.provider),
  *  not URL — it never sees the upstream URL the way the proxy does. */
 export declare function resolveCompress(compress: CompressConfig | undefined, provider: string | undefined, modelId: string | undefined): CompressSettings;
+/** Resolve absorb settings from the adapter config, handling the boolean
+ *  shorthand. contextThresholdPct is parsed to a ratio when provided. */
+export declare function resolveAbsorb(adapter: AdapterConfig): {
+    enabled: boolean;
+    toolName?: string;
+    minToolTokens?: number;
+    contextThresholdPct?: number;
+    excludeTools?: string[];
+};
 export declare function resolveConfig(adapter: AdapterConfig, liveContextLimit: number, provider?: string, modelId?: string): Config;
 export declare function parsePercent(v: number | string): number;

package/dist/decompress-tool.d.ts

@@ -1,11 +1,12 @@
 import { Type } from "typebox";
 import type { ToolDefinition } from "@earendil-works/pi-coding-agent";
 import type { AcpRuntime } from "./runtime.js";
+import { type ToolPromptOverrides } from "./surface.js";
 declare const DecompressParams: Type.TObject<{
     blockId: Type.TString;
     full: Type.TOptional<Type.TBoolean>;
     toFile: Type.TOptional<Type.TString>;
     inline: Type.TOptional<Type.TBoolean>;
 }>;
-export declare function makeDecompressTool(runtime: AcpRuntime): ToolDefinition<typeof DecompressParams>;
+export declare function makeDecompressTool(runtime: AcpRuntime, overrides?: ToolPromptOverrides): ToolDefinition<typeof DecompressParams>;
 export {};

package/dist/export.d.ts

@@ -0,0 +1,20 @@
+export interface ExportOptions {
+    output?: string;
+    full?: boolean;
+}
+export interface SessionSummary {
+    id: string;
+    title?: string;
+    label?: string;
+    savedAt?: number;
+    contextTokens?: number;
+    blocks: number;
+}
+export declare function listSessions(sessionDir: string): Promise<SessionSummary[]>;
+export declare function exportSession(selector: string | undefined, opts: ExportOptions, sessionDir: string): Promise<string>;
+export declare function parseExportArgs(args: string): {
+    selector?: string;
+    full: boolean;
+    output?: string;
+    error?: string;
+};

package/dist/host.d.ts

@@ -0,0 +1,15 @@
+import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
+/** Which session-entry source API the host exposes (same precedence as readContextEntries). */
+export type EntrySourceKind = "buildContextEntries" | "getBranch";
+export declare function entrySourceOf(sm: ExtensionContext["sessionManager"]): EntrySourceKind | null;
+/**
+ * Whether the host declared itself a Pi-compatible fork via environment.
+ *
+ * The SessionManager shape alone cannot distinguish e.g. Prime from OMP — both are
+ * Pi forks exposing `getBranch()` but not `buildContextEntries()` — so an
+ * unsupported shape requires an explicit declaration before the adapter runs.
+ * Read at call time so hosts can set it per-launch. See docs/host-adapter.md.
+ */
+export declare function isDeclaredForkHost(): boolean;
+/** Unsupported host: not Pi-shaped and not declared as a fork. OMP stays blocked by default. */
+export declare function isUnsupportedHost(sm: ExtensionContext["sessionManager"]): boolean;

package/dist/index.d.ts

@@ -1,5 +1,8 @@
 import type { ExtensionFactory } from "@earendil-works/pi-coding-agent";
 import { type AdapterConfig } from "./config.js";
+export { createRuntime } from "./runtime.js";
+export type { AcpRuntime, SessionRef } from "./runtime.js";
+export { deriveChildState } from "./state.js";
 export declare function createAcpExtension(adapter?: AdapterConfig): ExtensionFactory;
 declare const _default: ExtensionFactory;
 export default _default;