@criogaid/pi-codex-compaction 0.4.0 → 0.4.1

package/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## 未发布
 
+## 0.4.1
+
+- V2 模型识别改为显式 `compat.remoteCompaction` 配置优先；未配置时，`openai-responses` 或 `openai-codex-responses` 模型的 ID 包含 `gpt`（不区分大小写）即尝试 V2，不再限制服务商或官方地址；其他 API 的 GPT 模型未配置时直接使用 Pi 原生压缩，不显示失败警告。无效配置不会退回名称匹配。检查点支持保存和恢复自定义 API 标识，继续校验后端身份。
+
 ## 0.4.0
 
 - 更新压缩历史的恢复提示，明确使用当前包 `@criogaid/pi-codex-compaction`。保留旧会话摘要的精确识别与消息编辑保护，无需迁移会话文件。

package/README.md

@@ -141,9 +141,9 @@ Pi 原生压缩（文字摘要） <----------------------------+
 
 ## 自定义网关
 
-默认只有 Pi 自带的 `openai-codex` 服务商（官方地址）会尝试 V2。其他网关须本身支持 Codex Remote Compaction V2，仅兼容普通 Responses API 不够；模型的 API 类型须为 `openai-responses` 或 `openai-codex-responses`。
+模型是否尝试 V2 由 `compat.remoteCompaction` 决定：有配置时按配置判断；没有配置时，API 类型为 `openai-responses` 或 `openai-codex-responses` 且模型 ID 包含 `gpt`（不区分大小写）即尝试 V2。其他 API 的请求格式无法携带 V2 压缩，未配置时直接使用 Pi 原生压缩。服务商名称和是否使用官方地址不参与启用判断。显示名称不参与匹配。
 
-在 Pi 的 `models.json` 中为模型添加 `compat.remoteCompaction`：
+显式配置须指定 `protocol: "v2"`，可同时指定 `endpoint`。配置无效时不尝试 V2，也不会退回名称匹配。非 GPT 模型或需要覆盖端点时，可以在 Pi 的 `models.json` 中添加：
 
 ```json
 {
@@ -154,7 +154,7 @@ Pi 原生压缩（文字摘要） <----------------------------+
       "apiKey": "$CUSTOM_CODEX_API_KEY",
       "models": [
         {
-          "id": "gpt-example",
+          "id": "custom-model",
           "compat": {
             "remoteCompaction": {
               "protocol": "v2"
@@ -171,6 +171,8 @@ Pi 原生压缩（文字摘要） <----------------------------+
 
 网关的压缩请求使用其他路径时，可以在 `remoteCompaction` 内增加 `endpoint`。它的协议、主机和端口须与 Pi 认证后实际使用的 `baseUrl` 一致，且不能包含用户名、密码、查询参数（`?`）或片段（`#`）。
 
+V2 总开关仍决定是否发送新的远程压缩请求。模型名匹配只决定是否尝试；Pi 的适配器和网关仍须实际支持 V2，请求失败时按现有规则退回 Pi 原生压缩。默认端点按 API 推导：`openai-codex-responses` 使用 Codex 路径，其他 API 使用 `/responses`。检查点继续绑定实际 provider、API 和端点，防止跨后端重放。
+
 ## 注意事项
 
 - **V2 压缩结果绑定服务商。** V2 压缩后的旧记录以加密数据保存，只有原服务能读取，扩展无法还原成文字。重新打开会话或创建分支时可以继续使用，但须保持服务商、API 类型和请求地址不变。换到其他服务后，原生压缩只能根据 Pi 仍可读取的摘要和消息生成，无法包含这部分加密记录。
@@ -197,7 +199,7 @@ npm run pack:check
 <details>
 <summary><strong>发布流程</strong></summary>
 
-[Publish](.github/workflows/publish.yml) 在推送 `v*` 标签时运行。标签须与 `package.json` 的版本一致，例如版本 `0.4.0` 对应标签 `v0.4.0`。目前只发布正式版本，不接受 `-beta`、`-rc` 等预发布后缀。
+[Publish](.github/workflows/publish.yml) 在推送 `v*` 标签时运行。标签须与 `package.json` 的版本一致，例如版本 `0.4.1` 对应标签 `v0.4.1`。目前只发布正式版本，不接受 `-beta`、`-rc` 等预发布后缀。
 
 首次发布前，在仓库的 **Settings → Secrets and variables → Actions** 中添加 `NPM_TOKEN`。按 [npm 文档](https://docs.npmjs.com/creating-and-viewing-access-tokens)创建 granular access token，授予 `@criogaid` 作用域的发布权限（Read and write / publish and stage），并启用 Bypass two-factor authentication。包创建后，可以将 token 权限缩小到该包。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@criogaid/pi-codex-compaction",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Provider-aware Codex Remote Compaction V2 for Pi.",
   "type": "module",
   "repository": {

package/src/capability.ts

@@ -1,23 +1,20 @@
 // Own model eligibility and endpoint identity; authentication supplies the effective base URL.
 import type { Api, Model } from "@earendil-works/pi-ai";
-import { hasApi } from "@earendil-works/pi-ai";
 import { isObject } from "./protocol.js";
 
 export const CODEX_API = "openai-codex-responses" as const;
-export const OPENAI_RESPONSES_API = "openai-responses" as const;
-export type RemoteCompactionApi = typeof CODEX_API | typeof OPENAI_RESPONSES_API;
-const OFFICIAL_PROVIDER = "openai-codex";
-const OFFICIAL_BASE_URL = "https://chatgpt.com/backend-api";
+// Name-matched models need a Responses payload with an input array and a query-free request URL.
+const NAME_MATCH_APIS: readonly Api[] = ["openai-responses", CODEX_API];
 
 export interface ProviderIdentity {
   readonly provider: string;
-  readonly api: RemoteCompactionApi;
+  readonly api: Api;
   readonly modelId: string;
   readonly baseUrl: string;
   readonly endpoint: string;
 }
 export interface CapableModel {
-  readonly model: Model<RemoteCompactionApi>;
+  readonly model: Model<Api>;
   readonly identity: ProviderIdentity;
 }
 
@@ -30,18 +27,15 @@ export function normalizeUrl(value: string): string {
   url.pathname = url.pathname.replace(/\/+$/, "") || "/";
   return url.toString().replace(/\/$/, "");
 }
-/** Mirror Pi 0.99's resolveCodexUrl and the OpenAI SDK's `/responses` route for a normalized base URL. */
-export function deriveEndpoint(baseUrl: string, api: RemoteCompactionApi): string {
-  if (api === OPENAI_RESPONSES_API) return `${baseUrl}/responses`;
+/** Use Pi's Codex route for that adapter and the Responses route for other APIs. */
+export function deriveEndpoint(baseUrl: string, api: Api): string {
+  if (api !== CODEX_API) return `${baseUrl}/responses`;
   if (baseUrl.endsWith("/codex/responses")) return baseUrl;
   if (baseUrl.endsWith("/codex")) return `${baseUrl}/responses`;
   return `${baseUrl}/codex/responses`;
 }
 
-function configuredEndpoint(model: Model<RemoteCompactionApi>, baseUrl: string): string | undefined {
-  // Pi preserves extension metadata but its built-in compatibility type does not declare it.
-  const compat: unknown = model.compat;
-  const value = isObject(compat) ? compat.remoteCompaction : undefined;
+function configuredEndpoint(value: unknown, model: Model<Api>, baseUrl: string): string | undefined {
   if (!isObject(value) || value.protocol !== "v2" ||
       (value.endpoint !== undefined && typeof value.endpoint !== "string")) return undefined;
   try {
@@ -54,7 +48,12 @@ function configuredEndpoint(model: Model<RemoteCompactionApi>, baseUrl: string):
 }
 
 export function capableModel(model: Model<Api> | undefined, effectiveBaseUrl?: string): CapableModel | undefined {
-  if (!model || (!hasApi(model, CODEX_API) && !hasApi(model, OPENAI_RESPONSES_API))) return undefined;
+  if (!model) return undefined;
+  // Pi preserves extension metadata but its built-in compatibility type does not declare it.
+  const compat: unknown = model.compat;
+  const configured = isObject(compat) ? compat.remoteCompaction : undefined;
+  if (configured === undefined &&
+      (!NAME_MATCH_APIS.includes(model.api) || !model.id.toLowerCase().includes("gpt"))) return undefined;
   let configuredBaseUrl: string;
   let baseUrl: string;
   try {
@@ -63,8 +62,8 @@ export function capableModel(model: Model<Api> | undefined, effectiveBaseUrl?: s
   } catch {
     return undefined;
   }
-  const endpoint = model.provider === OFFICIAL_PROVIDER && hasApi(model, CODEX_API) && configuredBaseUrl === OFFICIAL_BASE_URL
-    ? deriveEndpoint(baseUrl, CODEX_API) : configuredEndpoint(model, baseUrl);
+  const endpoint = configured === undefined
+    ? deriveEndpoint(baseUrl, model.api) : configuredEndpoint(configured, model, baseUrl);
   return endpoint ? {
     model,
     identity: { provider: model.provider, api: model.api, modelId: model.id, baseUrl, endpoint },

package/src/checkpoint.ts

@@ -12,8 +12,6 @@ import {
 } from "@earendil-works/pi-coding-agent";
 import { isObject, type JsonObject, REMOTE_COMPACTION_PROTOCOL, validateCompactionItem } from "./protocol.js";
 import {
-  CODEX_API,
-  OPENAI_RESPONSES_API,
   normalizeUrl,
   type ProviderIdentity,
 } from "./capability.js";
@@ -102,7 +100,8 @@ export function parseCheckpointDetails(value: unknown): CodexCheckpointDetails |
     value.checkpointId.length < 8 ||
     typeof value.provider !== "string" ||
     !value.provider ||
-    (value.api !== CODEX_API && value.api !== OPENAI_RESPONSES_API) ||
+    typeof value.api !== "string" ||
+    !value.api ||
     typeof value.modelId !== "string" ||
     !value.modelId ||
     typeof value.baseUrl !== "string" ||

package/src/remote.ts

@@ -1,8 +1,8 @@
 // Own V2 request adaptation; Pi's model registry owns authentication and provider dispatch.
 import type { ThinkingLevel } from "@earendil-works/pi-agent-core";
-import type { Context, Model, ProviderHeaders, ThinkingBudgets, Usage } from "@earendil-works/pi-ai";
+import type { Api, Context, Model, ProviderHeaders, ThinkingBudgets, Usage } from "@earendil-works/pi-ai";
 import type { ModelRegistry } from "@earendil-works/pi-coding-agent";
-import { capableModel, deriveEndpoint, normalizeUrl, sameBackend, sameModel, type ProviderIdentity, type RemoteCompactionApi } from "./capability.js";
+import { capableModel, deriveEndpoint, normalizeUrl, sameBackend, sameModel, type ProviderIdentity } from "./capability.js";
 import { trimToolOutputsToContextWindow } from "./context-window.js";
 import { estimateImages, type ImageEstimates } from "./image-budget.js";
 import { contextUserItems, type UserItemOrigin } from "./retention-input.js";
@@ -16,7 +16,7 @@ const MISSING_PAYLOAD_MESSAGE = "Provider did not expose a request payload";
 
 export interface RemoteCompactionRequest {
   modelRegistry: Pick<ModelRegistry, "streamSimple">;
-  model: Model<RemoteCompactionApi>;
+  model: Model<Api>;
   context: Context;
   reasoning: ThinkingLevel;
   sessionId: string;