billion-context-pi 0.1.38 → 0.1.39

package/dist/config.d.ts

@@ -12,9 +12,11 @@ export interface DelegateConfig {
      *  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 {
+/** Compression tuning fields, shared by all three levels (global, provider,
+ *  model). Percentage fields accept a ratio (0.75) or percent string ("75%").
+ *  Resolution is per-field, deepest-wins (model > provider > global); an
+ *  undefined field at a deeper level does NOT clear a shallower value. */
+export interface CompressSettings {
     /** Context usage percentage that triggers forced compression nudges
      *  (bypasses growth-gate + cadence). Accepts a ratio (0.75) or percent
      *  string ("75%"). Default: 0.75. Maps to kernel nudge.maxContextLimitPct. */
@@ -28,6 +30,23 @@ export interface CompressConfig {
      *  Maps to kernel nudge.growthFloor + nudge.growthCap. */
     nudgeGrowthTokens?: number;
 }
+/** Per-provider compression overrides. Carries the same tuning fields as the
+ *  global level, plus an optional per-model map keyed by model id. */
+export interface ProviderCompress extends CompressSettings {
+    /** Per-model overrides within this provider, keyed by model id
+     *  (e.g. "claude-sonnet-4-5"). */
+    models?: Record<string, CompressSettings>;
+}
+/** Compression tuning. Top-level fields are global defaults; `providers`
+ *  optionally narrows them per Pi provider name and per model id. The active
+ *  entry is resolved live each turn from the current model
+ *  (`ctx.model.provider` / `ctx.model.id`). */
+export interface CompressConfig extends CompressSettings {
+    /** Per-provider (and per-model) overrides, keyed by Pi provider name
+     *  (e.g. "anthropic", "openai", "zhipu") — the same name used in
+     *  models.json and `pi --provider`. */
+    providers?: Record<string, ProviderCompress>;
+}
 /**
  * Adapter configuration. Maps onto acp-kernel's `Config` plus Pi-specific knobs
  * (live model context window, protected tools, state persistence).
@@ -91,5 +110,15 @@ export declare function resolveDelegate(adapter: AdapterConfig): {
     enabled: boolean;
     displayUsage: "merged" | "separate";
 };
-export declare function resolveConfig(adapter: AdapterConfig, liveContextLimit: number): Config;
+/** 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. */
+export declare function mergeCompress(global?: CompressSettings, provider?: CompressSettings, model?: CompressSettings): CompressSettings;
+/** Resolve the effective compression settings for the active model: global →
+ *  provider (matched by Pi provider name) → model (matched by model id).
+ *  Returns a CompressSettings whose fields are undefined when nothing is set
+ *  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;
+export declare function resolveConfig(adapter: AdapterConfig, liveContextLimit: number, provider?: string, modelId?: string): Config;
 export declare function parsePercent(v: number | string): number;

package/dist/density.d.ts

@@ -0,0 +1,19 @@
+export declare const DENSITY_MIN = 0.5;
+export declare const DENSITY_MAX = 2.5;
+export declare const MIN_DELTA_EST = 50;
+export declare const CONFIRM_RATIO = 0.2;
+export declare const INITIAL_DENSITY = 1;
+export declare class DensityEstimator {
+    private models;
+    /** 重置指定模型（模型切换/会话开始时调用）。 */
+    resetModel(modelId: string): void;
+    /** 返回当前密度系数（未知模型返回初始 1）。 */
+    densityFor(modelId: string): number;
+    /**
+     * 每轮 context 事件调用。realTotal 为 provider 真实 usage（可空），
+     * estTotal 为本地估算总 token。postCompression 为压缩刚发生标志。
+     */
+    update(modelId: string, realTotal: number | null, estTotal: number, postCompression?: boolean): void;
+    /** 注入器：估算文本 token = defaultCountTokens × density。 */
+    estimateWithDensity(modelId: string, text: string): number;
+}