opencode-cache-engine 0.3.2 → 0.3.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-cache-engine",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "private": false,
   "description": "Provider-aware prompt-cache optimization and telemetry for OpenCode",
   "keywords": [

package/src/cache-engine.ts

@@ -482,17 +482,18 @@ export const CacheEngine: Plugin = async ({ client, directory }) => {
     // use a deterministic separate namespace (<root>:compact) so a compaction
     // cache write never interferes with the useful live-session cache.
     //
-    // MiMo-V2.6 + OpenRouter session affinity. Gate on the actual OpenCode
-    // provider identity as well as the detected family; a matching model slug
-    // on a direct endpoint is not sufficient. The runtime merges model.headers
-    // before this hook's output, so preserve a case-insensitive user/model or
-    // earlier-plugin x-session-id rather than silently overwriting it. Otherwise
-    // add the deterministic ID derived from the logical OpenCode session.
+    // MiMo-V2.6 / GLM-5.3 + OpenRouter session affinity. Gate on the actual
+    // OpenCode provider identity as well as the detected family; a matching
+    // model slug on a direct endpoint is not sufficient. The runtime merges
+    // model.headers before this hook's output, so preserve a case-insensitive
+    // user/model or earlier-plugin x-session-id rather than silently overwriting
+    // it. Otherwise add the deterministic ID derived from the logical session.
     "chat.headers": async (input, output) => {
       try {
         const model = input.model as unknown as ChatParamsModel
         const providerID = String(model?.providerID ?? "")
-        if (providerID !== "openrouter" || detectPolicy(model) !== POLICY_MIMO26) return
+        const family = detectPolicy(model)
+        if (providerID !== "openrouter" || (family !== POLICY_MIMO26 && family !== POLICY_GLM53)) return
 
         const hasSessionIDHeader = (headers?: Record<string, string>) =>
           Object.keys(headers ?? {}).some((name) => name.toLowerCase() === "x-session-id")

package/test/cache-engine.test.mjs

@@ -1035,10 +1035,15 @@ async function runMiMoHeaderHookProbe() {
         sessionID,
         agent: "build",
         model,
-        provider: { id: model.providerID },
+        provider: { source: "config", info: { id: model.providerID }, options: {} },
         message: { id: "msg", sessionID, role: "user", content: "probe" },
       }, output)
-      return { headers: output.headers, sameObject: output.headers === headersRef, modelHeaders: model.headers }
+      return {
+        headers: output.headers,
+        sameObject: output.headers === headersRef,
+        outputKeys: Object.keys(output),
+        modelHeaders: model.headers,
+      }
     }
     const mimoOpenRouter = {
       providerID: "openrouter",
@@ -1052,7 +1057,34 @@ async function runMiMoHeaderHookProbe() {
     const direct = await invoke({ ...mimoOpenRouter, providerID: "xiaomi" }, "ses_direct", { "User-Agent": "preserve-me" })
     const unknown = await invoke({ ...mimoOpenRouter, providerID: "unknown-provider" }, "ses_unknown")
     const missingProvider = await invoke({ ...mimoOpenRouter, providerID: undefined }, "ses_missing_provider")
-    const glm = await invoke({ providerID: "openrouter", id: "z-ai/glm-5.3", api: { id: "z-ai/glm-5.3" }, headers: {} }, "ses_glm")
+    const glmOpenRouter = { providerID: "openrouter", id: "z-ai/glm-5.3", api: { id: "z-ai/glm-5.3" }, headers: {} }
+    const glm1 = await invoke(glmOpenRouter, "ses_glm_same")
+    const glm2 = await invoke(glmOpenRouter, "ses_glm_same")
+    const glmDifferent = await invoke(glmOpenRouter, "ses_glm_other")
+    const glmDirect = await invoke({ ...glmOpenRouter, providerID: "zai" }, "ses_glm_direct", { "User-Agent": "preserve-glm" })
+    const nonOpenRouterMatrix = [
+      ["mimo-direct", { ...mimoOpenRouter, providerID: "xiaomi" }],
+      ["glm-direct", { ...glmOpenRouter, providerID: "zai" }],
+      ["deepseek-direct", { providerID: "deepseek", id: "deepseek-v4.1-flash", api: { id: "deepseek-v4.1-flash" }, headers: {} }],
+      ["gpt-openai", { providerID: "openai", id: "gpt-5.6", api: { id: "gpt-5.6", npm: "@ai-sdk/openai" }, headers: {} }],
+      ["unknown-provider", { ...mimoOpenRouter, providerID: "unknown-provider" }],
+      ["missing-provider", { ...mimoOpenRouter, providerID: undefined }],
+      ["opencode-go-mimo", { ...mimoOpenRouter, providerID: "opencode" }],
+      ["opencode-go-glm", { ...glmOpenRouter, providerID: "opencode" }],
+    ]
+    const compatibility = []
+    for (const [name, model] of nonOpenRouterMatrix) {
+      const existing = { "User-Agent": "preserve-" + name, "x-compat-test": name }
+      compatibility.push({ name, ...(await invoke(model, "ses_" + name, existing)), expected: existing })
+    }
+    const gptOutput = { options: {} }
+    await hooks["chat.params"]({
+      sessionID: "ses_gpt_native_cache",
+      agent: "build",
+      model: { providerID: "openai", id: "gpt-5.6", api: { id: "gpt-5.6", npm: "@ai-sdk/openai" } },
+      provider: { source: "config", info: { id: "openai" }, options: {} },
+      message: { id: "msg-gpt", sessionID: "ses_gpt_native_cache", role: "user", content: "probe" },
+    }, gptOutput)
     const configured = await invoke({
       ...mimoOpenRouter,
       headers: { "X-Session-Id": "user-configured-value" },
@@ -1065,12 +1097,19 @@ async function runMiMoHeaderHookProbe() {
       direct,
       unknown,
       missingProvider,
-      glm,
+      glm1,
+      glm2,
+      glmDifferent,
+      glmDirect,
+      compatibility,
+      gptOptions: gptOutput.options,
       configured,
       configuredModelHeaders: configured.modelHeaders,
       earlierPlugin,
       expectedSame: mimoSessionIdFor("ses_same"),
       expectedOther: mimoSessionIdFor("ses_other"),
+      expectedGlm: mimoSessionIdFor("ses_glm_same"),
+      expectedGlmOther: mimoSessionIdFor("ses_glm_other"),
     }
     assert.equal(configured.headers["x-session-id"], undefined)
     assert.equal(earlierPlugin.headers["X-SESSION-ID"], "earlier-plugin-value")
@@ -1117,7 +1156,33 @@ test("MiMo affinity preserves existing x-session-id values case-insensitively",
   assert.deepEqual(result.earlierPlugin.headers, { "X-SESSION-ID": "earlier-plugin-value" })
 })
 
-test("MiMo-only affinity does not add x-session-id to GLM/OpenRouter", async () => {
+test("GLM/OpenRouter attaches the deterministic session ID", async () => {
+  const result = await miMoHeaderResults()
+  assert.equal(result.glm1.headers["x-session-id"], result.expectedGlm)
+  assert.equal(result.glm2.headers["x-session-id"], result.expectedGlm)
+  assert.equal(result.glmDifferent.headers["x-session-id"], result.expectedGlmOther)
+  assert.notEqual(result.glmDifferent.headers["x-session-id"], result.glm1.headers["x-session-id"])
+})
+
+test("GLM direct Z.AI does not receive x-session-id", async () => {
+  const result = await miMoHeaderResults()
+  assert.equal(result.glmDirect.headers["x-session-id"], undefined)
+  assert.deepEqual(result.glmDirect.headers, { "User-Agent": "preserve-glm" })
+})
+
+test("non-OpenRouter endpoint matrix is x-session-id non-mutating and preserves unrelated headers", async () => {
+  const result = await miMoHeaderResults()
+  assert.equal(result.compatibility.length, 8)
+  for (const item of result.compatibility) {
+    assert.equal(item.headers["x-session-id"], undefined, `${item.name} must not receive OpenRouter affinity`)
+    assert.deepEqual(item.headers, item.expected, `${item.name} unrelated headers must remain unchanged`)
+    assert.equal(item.sameObject, true, `${item.name} headers object must be preserved`)
+    assert.deepEqual(item.outputKeys, ["headers"], `${item.name} hook output remains headers-only`)
+  }
+})
+
+test("OpenAI GPT retains its existing chat.params cache options without affinity headers", async () => {
   const result = await miMoHeaderResults()
-  assert.equal(result.glm.headers["x-session-id"], undefined)
+  assert.equal(typeof result.gptOptions.promptCacheKey, "string")
+  assert.deepEqual(result.gptOptions.promptCacheOptions, { mode: "implicit", ttl: "30m" })
 })