billion-context-omp 0.1.0 → 0.1.2

package/dist/config.d.ts

@@ -0,0 +1,92 @@
+import { type Config, type Prompts } from "acp-kernel";
+/** Delegate sub-agent configuration. */
+export interface DelegateConfig {
+    /** Enable acp_delegate tools (delegate/wait/cancel) and their system-prompt
+     *  section. Default: true. Set `enabled: false` to skip registering them. */
+    enabled?: boolean;
+    /** How delegate usage is reported back to the main session.
+     *  "separate" (default) — delegate tokens tracked in a separate accumulator;
+     *  main session totals stay clean, delegate usage shows as its own block in
+     *  acp_status (excluded from main totals).
+     *  "merged" — delegate token usage folded into the tool-result usage field,
+     *  counted as part of the main session totals. */
+    displayUsage?: "merged" | "separate";
+}
+/** Compression tuning. All fields accept a ratio (0.75) or percent string
+ *  ("75%") where noted. */
+export interface CompressConfig {
+    maxContextLimit?: number | string;
+    emergencyThresholdPercent?: number | string;
+    nudgeGrowthTokens?: number;
+    /** Model for /compact summaries, as "provider:modelId" (e.g.
+     *  "zhipuai:glm-5.2"). Omit to use the current session model. */
+    compressModel?: string;
+}
+/**
+ * Adapter configuration. Maps onto acp-kernel's `Config` plus Pi-specific knobs
+ * (live model context window, protected tools, state persistence).
+ */
+export interface AdapterConfig {
+    /** When omitted, the adapter reads `ctx.model.contextWindow` live each turn.
+     *  Set explicitly for tests/headless runs. */
+    modelContextLimit?: number;
+    protectedTools?: string[];
+    preserveRecentMessages?: number;
+    /** Check npm for a newer billion-context-omp on startup and auto-install it. Default: true.
+     *  Disable via `autoUpdate: false` or env `ACP_AUTO_UPDATE=0` to avoid all
+     *  network calls on startup. */
+    autoUpdate?: boolean;
+    /** Enable debug-level events in the ACP log file (default ~/.omp/acp-omp.log).
+     *  Always-on events (session/turn/compress/delegate lifecycle, all errors and
+     *  warnings) are written regardless; `debug` only adds verbose diagnostics.
+     *  Default: false (or env ACP_DEBUG=1/true). */
+    debug?: boolean;
+    /** Default timeout in seconds injected into the bash tool when the model
+     *  omits `timeout`. Pi has NO built-in default, so without this a command
+     *  that the model forgets to time out can hang for thousands of seconds.
+     *  Default: 60 (catches hangs quickly). On timeout the model is guided to
+     *  re-run with a larger `timeout`. Set to 0 to disable (restore Pi's
+     *  unbounded behavior). */
+    toolBashDefaultTimeout?: number;
+    /** Hard byte cap applied to tool result text via the `tool_result` hook.
+     *  Default: 200000 (~200KB, roughly 5000 lines at ~40 bytes/line) — a
+     *  generous ceiling that stops runaway output. Pi already caps bash/read/grep
+     *  at 50KB/2000 lines (bash full output is saved to a temp file), so this
+     *  default mainly caps tools Pi doesn't cap. Set lower (e.g. 8192) for a
+     *  tighter context budget, or 0 to disable. When capped, oversized text is
+     *  head-truncated with a notice telling the model how to see the full output
+     *  (bash: read BashToolDetails.fullOutputPath). */
+    toolOutputMaxBytes?: number;
+    /** Delegate sub-agent config. Accepts a boolean shorthand (`true` →
+     *  `{ enabled: true }`, `false` → `{ enabled: false }`) or a DelegateConfig
+     *  object. Default: enabled. */
+    delegate?: boolean | DelegateConfig;
+    /** Compression tuning. */
+    compress?: CompressConfig;
+    /** Legacy flat alias for `delegate.displayUsage`. Kept for backward
+     *  compatibility with existing acp-omp.json files. Prefer `delegate.displayUsage`. */
+    displayUsage?: "merged" | "separate";
+    /** Override acp-kernel's load-bearing compression prompt rules (the 4
+     *  Prompts fields). Each set field replaces the kernel default verbatim.
+     *  Requires acknowledgePromptsRisk: true — without it, overrides are dropped
+     *  (defaults used) and a warning is logged. Set via ~/.omp/acp-omp.json. */
+    prompts?: Partial<Prompts>;
+    /** Must be true for `prompts` overrides to take effect. Acknowledges that
+     *  replacing the kernel's tuned compression rules may reduce summary quality
+     *  (lost paths/signatures/decisions → worse retrieval). */
+    acknowledgePromptsRisk?: boolean;
+    coreOverrides?: Partial<Config>;
+}
+export declare const DEFAULT_TOOL_BASH_TIMEOUT = 60;
+export declare const DEFAULT_TOOL_OUTPUT_MAX_BYTES = 200000;
+/** Resolve delegate config from the adapter, handling the boolean shorthand
+ *  and the legacy flat `displayUsage` alias.
+ *
+ *  Forward-compatible: not yet wired (AGENTS.md §7 — delegates deferred).
+ *  Retained so future wiring can consume it without re-deriving the logic. */
+export declare function resolveDelegate(adapter: AdapterConfig): {
+    enabled: boolean;
+    displayUsage: "merged" | "separate";
+};
+export declare function resolveConfig(adapter: AdapterConfig, liveContextLimit: number): Config;
+export declare function parsePercent(v: number | string): number;

package/dist/decompress-tool.d.ts

@@ -0,0 +1,15 @@
+import type { ToolDefinition } from "@oh-my-pi/pi-coding-agent";
+import type { AcpRuntime } from "./runtime.js";
+declare const DecompressParams: import("@oh-my-pi/omptype").FluentType<{
+    blockId: string;
+    full?: boolean | undefined;
+    inline?: boolean | undefined;
+    toFile?: string | undefined;
+}, {
+    blockId: string;
+    full?: boolean | undefined;
+    inline?: boolean | undefined;
+    toFile?: string | undefined;
+}>;
+export declare function makeDecompressTool(runtime: AcpRuntime): ToolDefinition<typeof DecompressParams>;
+export {};

package/dist/dump.d.ts

@@ -0,0 +1,22 @@
+export declare function dumpDir(): string;
+export interface DumpMeta {
+    sid: string;
+    injected: boolean;
+    emergency: boolean;
+}
+/** Dump the full AgentMessage[] sent to the LLM for each context event.
+ *  Only fires when debug mode is on (ACP_DEBUG=1 or debug:true in config).
+ *  Files are sequential JSON in ~/.omp/acp-omp-dumps/: 0000.json, 0001.json, ...
+ *  Diff two dumps to verify prefix stability or inspect nudge injection. */
+export declare function dumpContextMessages(messages: unknown[], meta: DumpMeta): string | null;
+/** Extract a compact summary of the provider request payload for log lines.
+ *  Captures the prefix signature (system prompt + first N messages) so cache
+ *  instability is visible as a changing hash between consecutive turns. */
+export declare function summarizeProviderPayload(payload: unknown): Record<string, unknown>;
+/** Dump the raw provider request payload — the actual bytes sent to the LLM
+ *  after ALL processing (ACP tags, omp system-reminders, message reordering).
+ *  This is the true LLM exit point via the `before_provider_request` hook.
+ *  Files: ~/.omp/acp-omp-dumps/req_NNNN.json */
+export declare function dumpProviderRequest(payload: unknown, meta: {
+    sid: string;
+}): string | null;

package/dist/footer-status.d.ts

@@ -0,0 +1,2 @@
+/** Mirrors pi's footer.js formatTokens: lowercase k/M, thresholds <1000/<10000/<1e6/<1e7. */
+export declare function formatCompactTokens(count: number): string;

package/dist/home.d.ts

@@ -0,0 +1,2 @@
+/** os.homedir() ignores HOME/USERPROFILE under Bun; respect env first. */
+export declare function homeDir(): string;

package/dist/index.d.ts

@@ -1,59 +1,5 @@
-#!/usr/bin/env node
-/**
- * billion-context-omp
- *
- * oh-my-pi (omp) client extension for billion-context.
- *
- * `billion-context` is a Node.js proxy that sits between an AI agent and its
- * model API, rewriting Anthropic/OpenAI streams with acp-kernel compression.
- * This package wires [omp](https://github.com/can1357/oh-my-pi) — the terminal
- * coding agent — into that pipeline: it builds the base_url override that
- * routes omp's traffic through a running billion-context proxy, and
- * self-disables when it detects omp is *already* behind bili (so two layers of
- * compression never stack).
- *
- * > Skeleton package. The config-building helpers below are placeholders; wire
- * > them to omp's actual provider/base_url config shape as you build it out.
- */
-/** Marker path segment bili rewrites upstream URLs under. */
-declare const BILI_PREFIX = "/bili/";
-interface BillionContextOmpOptions {
-    /**
-     * Origin of a running billion-context proxy, e.g. `http://localhost:8787`.
-     */
-    endpoint?: string;
-}
-interface OmpProviderOverride {
-    /** The provider key to override in omp's config (e.g. `openai`, `anthropic`). */
-    provider: string;
-    /** Original upstream base URL, e.g. `https://api.openai.com/v1`. */
-    upstream: string;
-}
-declare class BillionContextOmp {
-    private readonly endpoint?;
-    constructor(options?: BillionContextOmpOptions);
-    /**
-     * Detect whether a base_url is already pointing at a billion-context proxy.
-     * Client extensions use this to self-disable and avoid double compression.
-     */
-    isBiliBaseUrl(baseUrl: string): boolean;
-    /**
-     * Build the base_url omp should use so its traffic flows through bili.
-     * Result shape: `${endpoint}/bili/${upstream}`.
-     */
-    buildBaseUrl(upstream: string): string;
-    /**
-     * Produce the provider overrides omp should merge into its config to route
-     * every listed provider through bili.
-     *
-     * Skeleton — returns base_url overrides only; extend with headers / auth
-     * passthrough / model-list tweaks as needed.
-     */
-    buildConfig(providers: OmpProviderOverride[]): Record<string, {
-        base_url: string;
-    }>;
-    /** Whether the client is configured against a proxy endpoint. */
-    get hasEndpoint(): boolean;
-}
-
-export { BILI_PREFIX, BillionContextOmp, type BillionContextOmpOptions, type OmpProviderOverride, BillionContextOmp as default };
+import type { ExtensionFactory } from "@oh-my-pi/pi-coding-agent";
+import { type AdapterConfig } from "./config.js";
+export declare function createAcpExtension(adapter?: AdapterConfig): ExtensionFactory;
+declare const _default: ExtensionFactory;
+export default _default;