billion-context-omp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ranxianglei
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,61 @@
+[English](./README.md) | [中文](./README.zh-CN.md)
+
+# billion-context-omp
+
+[oh-my-pi (omp)](https://github.com/can1357/oh-my-pi) client extension for [billion-context](https://www.npmjs.com/package/billion-context).
+
+`billion-context` is a Node.js proxy that sits between any AI agent and its model API, rewriting Anthropic/OpenAI streams with [acp-kernel](https://github.com/ranxianglei/acp-kernel) compression. `billion-context-omp` wires **omp** — 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.
+
+> ⚠️ This is a **skeleton** package. The config-building helpers are placeholders.
+> Wire them to omp's actual provider/`base_url` config shape as you build it out.
+
+## Why
+
+Long coding sessions blow up context. Once you pass the context window the session degrades or dies, and every provider charges per token. Compression lets a single session run for days — billions of tokens through one window.
+
+omp already supports arbitrary providers and custom `base_url`. This package is the thin glue that points those `base_url`s at a bili proxy and keeps the `/bili/` self-detection signal consistent with the rest of the billion-context client family (`billion-context-pi`, `opencode-acp`, …).
+
+## Install
+
+```bash
+npm install billion-context-omp
+```
+
+## Quickstart
+
+```ts
+import { BillionContextOmp } from 'billion-context-omp';
+
+const omp = new BillionContextOmp({ endpoint: 'http://localhost:8787' });
+
+// Route a provider through bili:
+omp.buildBaseUrl('https://api.openai.com/v1');
+// => 'http://localhost:8787/bili/https://api.openai.com/v1'
+
+// Detect an already-routed URL (use to self-disable / avoid double compression):
+omp.isBiliBaseUrl('http://localhost:8787/bili/https://api.openai.com/v1'); // => true
+```
+
+## API
+
+### `new BillionContextOmp(options?)`
+
+| option     | type     | description                              |
+| ---------- | -------- | ---------------------------------------- |
+| `endpoint` | `string` | Origin of a running billion-context proxy. |
+
+### `omp.buildBaseUrl(upstream): string`
+
+Wrap an upstream `base_url` as `${endpoint}/bili/${upstream}`. Throws if no endpoint is configured. Passes through unchanged if already routed.
+
+### `omp.isBiliBaseUrl(baseUrl): boolean`
+
+True when the URL already carries the `/bili/` prefix — use this to self-disable when omp's `base_url` is already pointing at bili.
+
+### `omp.buildConfig(providers): Record<provider, { base_url }>`
+
+Build base_url overrides for multiple omp providers at once. _(Skeleton.)_
+
+## License
+
+MIT © [ranxianglei](https://github.com/ranxianglei)

package/README.zh-CN.md

@@ -0,0 +1,61 @@
+[English](./README.md) | [中文](./README.zh-CN.md)
+
+# billion-context-omp
+
+[oh-my-pi (omp)](https://github.com/can1357/oh-my-pi) 的 [billion-context](https://www.npmjs.com/package/billion-context) 客户端扩展。
+
+`billion-context` 是一个 Node.js 代理,架在任意 AI 助手与其模型 API 之间,用 [acp-kernel](https://github.com/ranxianglei/acp-kernel) 压缩重写 Anthropic/OpenAI 流。`billion-context-omp` 把 **omp** —— 终端编程助手 —— 接入这条链路:它生成 `base_url` 覆盖,把 omp 的流量路由到运行中的 `billion-context` 代理,并在**检测到 omp 已经位于 bili 之后时自动停用**,避免两层压缩叠加。
+
+> ⚠️ 这是一个**骨架**包,配置构建辅助函数目前是占位实现。
+> 请按 omp 实际的 provider / `base_url` 配置形态对接后再行扩展。
+
+## 为什么
+
+长编程会话会把上下文撑爆。一旦超过上下文窗口,会话质量下降甚至崩掉,而各家 provider 按 token 计费。压缩能让**一个会话连跑数天** —— 海量 token 穿过同一个窗口。
+
+omp 本就支持任意 provider 和自定义 `base_url`。本包提供薄薄一层胶水,把这些 `base_url` 指向 bili 代理,并保持 `/bili/` 自检信号与 billion-context 客户端家族(`billion-context-pi`、`opencode-acp` 等)一致。
+
+## 安装
+
+```bash
+npm install billion-context-omp
+```
+
+## 快速开始
+
+```ts
+import { BillionContextOmp } from 'billion-context-omp';
+
+const omp = new BillionContextOmp({ endpoint: 'http://localhost:8787' });
+
+// 让某个 provider 走 bili:
+omp.buildBaseUrl('https://api.openai.com/v1');
+// => 'http://localhost:8787/bili/https://api.openai.com/v1'
+
+// 检测已路由的 URL(用于自我停用 / 避免双重压缩):
+omp.isBiliBaseUrl('http://localhost:8787/bili/https://api.openai.com/v1'); // => true
+```
+
+## API
+
+### `new BillionContextOmp(options?)`
+
+| 选项       | 类型     | 说明                              |
+| ---------- | -------- | --------------------------------- |
+| `endpoint` | `string` | 运行中的 billion-context 代理地址。 |
+
+### `omp.buildBaseUrl(upstream): string`
+
+把上游 `base_url` 包成 `${endpoint}/bili/${upstream}`。未配置 endpoint 时抛错。若已是路由过的 URL 则原样返回。
+
+### `omp.isBiliBaseUrl(baseUrl): boolean`
+
+URL 含 `/bili/` 前缀时返回 true —— omp 的 `base_url` 已指向 bili 时用此方法自我停用。
+
+### `omp.buildConfig(providers): Record<provider, { base_url }>`
+
+一次性为多个 omp provider 生成 base_url 覆盖。_(骨架。)_
+
+## License
+
+MIT © [ranxianglei](https://github.com/ranxianglei)

package/dist/index.d.ts

@@ -0,0 +1,59 @@
+#!/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 };

package/dist/index.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+
+// src/index.ts
+var BILI_PREFIX = "/bili/";
+var BillionContextOmp = class {
+  endpoint;
+  constructor(options = {}) {
+    this.endpoint = options.endpoint?.replace(/\/$/, "");
+  }
+  /**
+   * 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) {
+    return baseUrl.includes(BILI_PREFIX);
+  }
+  /**
+   * Build the base_url omp should use so its traffic flows through bili.
+   * Result shape: `${endpoint}/bili/${upstream}`.
+   */
+  buildBaseUrl(upstream) {
+    if (!this.endpoint) {
+      throw new Error(
+        "billion-context-omp: cannot build base_url \u2014 no proxy endpoint configured"
+      );
+    }
+    if (this.isBiliBaseUrl(upstream)) return upstream;
+    const clean = upstream.replace(/\/$/, "");
+    return `${this.endpoint}${BILI_PREFIX}${clean}`;
+  }
+  /**
+   * 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) {
+    const out = {};
+    for (const { provider, upstream } of providers) {
+      out[provider] = { base_url: this.buildBaseUrl(upstream) };
+    }
+    return out;
+  }
+  /** Whether the client is configured against a proxy endpoint. */
+  get hasEndpoint() {
+    return this.endpoint !== void 0;
+  }
+};
+var index_default = BillionContextOmp;
+export {
+  BILI_PREFIX,
+  BillionContextOmp,
+  index_default as default
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * billion-context-omp\n *\n * oh-my-pi (omp) client extension for billion-context.\n *\n * `billion-context` is a Node.js proxy that sits between an AI agent and its\n * model API, rewriting Anthropic/OpenAI streams with acp-kernel compression.\n * This package wires [omp](https://github.com/can1357/oh-my-pi) — the terminal\n * coding agent — into that pipeline: it builds the base_url override that\n * routes omp's traffic through a running billion-context proxy, and\n * self-disables when it detects omp is *already* behind bili (so two layers of\n * compression never stack).\n *\n * > Skeleton package. The config-building helpers below are placeholders; wire\n * > them to omp's actual provider/base_url config shape as you build it out.\n */\n\n/** Marker path segment bili rewrites upstream URLs under. */\nexport const BILI_PREFIX = '/bili/';\n\nexport interface BillionContextOmpOptions {\n  /**\n   * Origin of a running billion-context proxy, e.g. `http://localhost:8787`.\n   */\n  endpoint?: string;\n}\n\nexport interface OmpProviderOverride {\n  /** The provider key to override in omp's config (e.g. `openai`, `anthropic`). */\n  provider: string;\n  /** Original upstream base URL, e.g. `https://api.openai.com/v1`. */\n  upstream: string;\n}\n\nexport class BillionContextOmp {\n  private readonly endpoint?: string;\n\n  constructor(options: BillionContextOmpOptions = {}) {\n    this.endpoint = options.endpoint?.replace(/\\/$/, '');\n  }\n\n  /**\n   * Detect whether a base_url is already pointing at a billion-context proxy.\n   * Client extensions use this to self-disable and avoid double compression.\n   */\n  isBiliBaseUrl(baseUrl: string): boolean {\n    return baseUrl.includes(BILI_PREFIX);\n  }\n\n  /**\n   * Build the base_url omp should use so its traffic flows through bili.\n   * Result shape: `${endpoint}/bili/${upstream}`.\n   */\n  buildBaseUrl(upstream: string): string {\n    if (!this.endpoint) {\n      throw new Error(\n        'billion-context-omp: cannot build base_url — no proxy endpoint configured',\n      );\n    }\n    if (this.isBiliBaseUrl(upstream)) return upstream; // already routed\n    const clean = upstream.replace(/\\/$/, '');\n    return `${this.endpoint}${BILI_PREFIX}${clean}`;\n  }\n\n  /**\n   * Produce the provider overrides omp should merge into its config to route\n   * every listed provider through bili.\n   *\n   * Skeleton — returns base_url overrides only; extend with headers / auth\n   * passthrough / model-list tweaks as needed.\n   */\n  buildConfig(providers: OmpProviderOverride[]): Record<string, { base_url: string }> {\n    const out: Record<string, { base_url: string }> = {};\n    for (const { provider, upstream } of providers) {\n      out[provider] = { base_url: this.buildBaseUrl(upstream) };\n    }\n    return out;\n  }\n\n  /** Whether the client is configured against a proxy endpoint. */\n  get hasEndpoint(): boolean {\n    return this.endpoint !== undefined;\n  }\n}\n\nexport default BillionContextOmp;\n"],"mappings":";;;AAmBO,IAAM,cAAc;AAgBpB,IAAM,oBAAN,MAAwB;AAAA,EACZ;AAAA,EAEjB,YAAY,UAAoC,CAAC,GAAG;AAClD,SAAK,WAAW,QAAQ,UAAU,QAAQ,OAAO,EAAE;AAAA,EACrD;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,cAAc,SAA0B;AACtC,WAAO,QAAQ,SAAS,WAAW;AAAA,EACrC;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,aAAa,UAA0B;AACrC,QAAI,CAAC,KAAK,UAAU;AAClB,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AACA,QAAI,KAAK,cAAc,QAAQ,EAAG,QAAO;AACzC,UAAM,QAAQ,SAAS,QAAQ,OAAO,EAAE;AACxC,WAAO,GAAG,KAAK,QAAQ,GAAG,WAAW,GAAG,KAAK;AAAA,EAC/C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,YAAY,WAAwE;AAClF,UAAM,MAA4C,CAAC;AACnD,eAAW,EAAE,UAAU,SAAS,KAAK,WAAW;AAC9C,UAAI,QAAQ,IAAI,EAAE,UAAU,KAAK,aAAa,QAAQ,EAAE;AAAA,IAC1D;AACA,WAAO;AAAA,EACT;AAAA;AAAA,EAGA,IAAI,cAAuB;AACzB,WAAO,KAAK,aAAa;AAAA,EAC3B;AACF;AAEA,IAAO,gBAAQ;","names":[]}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "billion-context-omp",
+  "version": "0.1.0",
+  "description": "oh-my-pi (omp) client extension for billion-context. Routes omp's model traffic through a running billion-context proxy for incremental, reversible, prefix-cache-friendly context compression — and self-disables when it detects omp is already behind bili.",
+  "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "bili-omp": "./dist/index.js"
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md",
+    "README.zh-CN.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit --project tsconfig.build.json",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "context",
+    "compression",
+    "proxy",
+    "acp",
+    "acp-kernel",
+    "ai",
+    "agent",
+    "omp",
+    "oh-my-pi",
+    "pi",
+    "coding-agent",
+    "cli",
+    "anthropic",
+    "openai"
+  ],
+  "license": "MIT",
+  "author": "ranxianglei",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ranxianglei/billion-context-omp.git"
+  },
+  "homepage": "https://github.com/ranxianglei/billion-context-omp#readme",
+  "bugs": {
+    "url": "https://github.com/ranxianglei/billion-context-omp/issues"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.5.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  }
+}