opencode-cache-engine 0.3.0 → 0.3.1

package/.opencode/opencode.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": [
+    "opencode-cache-engine"
+  ]
+}

package/.opencode/tui.json

@@ -0,0 +1,5 @@
+{
+  "plugin": [
+    "opencode-cache-engine"
+  ]
+}

package/package.json

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

package/src/cache-engine-core.mjs

@@ -481,6 +481,25 @@ export function mimoHitRate(cachedTokens, promptTokens) {
   return Math.round((100 * cachedTokens) / promptTokens)
 }
 
+// Derive a provider-neutral stable ID from the logical OpenCode session ID.
+// The full SHA-256 digest avoids intentional truncation/collapse of distinct
+// sessions. This helper only generates an identifier; it does not select a
+// provider or inject the identifier into any request transport.
+export function stableSessionIdFor(sessionID) {
+  if (typeof sessionID !== "string" || sessionID.length === 0) return null
+  return `oc-ses-${createHash("sha256").update(sessionID).digest("hex")}`
+}
+
+// OpenRouter session affinity is currently eligible only for the two policy
+// families with documented affinity use: MiMo-V2.6 and GLM-5.3. This pure
+// policy decision is separate from ID generation and transport/header injection.
+export function isOpenRouterAffinityEligible(policyFamily, providerID) {
+  return (
+    providerID === "openrouter" &&
+    (policyFamily === POLICY_MIMO26 || policyFamily === POLICY_GLM53)
+  )
+}
+
 // Derive a stable, session-scoped identifier suitable for OpenRouter's
 // documented `session_id` sticky-routing key. Pure function of the OpenCode
 // session id only: identical sessions map to identical ids, distinct sessions

package/test/cache-engine.test.mjs

@@ -28,6 +28,7 @@ import {
   glmHitRatio,
   gptCacheOptionsDelta,
   hitRatePct,
+  isOpenRouterAffinityEligible,
   loadConfig,
   mimoHitRate,
   mimoSessionIdFor,
@@ -40,6 +41,7 @@ import {
   shapeFieldDiffs,
   shorthash,
   shouldAggregate,
+  stableSessionIdFor,
   systemShapeHashes,
   toolFingerprint,
   toolWireFingerprint,
@@ -871,10 +873,22 @@ test("MiMo relocation is a no-op when start/end markers are missing", () => {
 // MiMo-V2.6: sticky-session identity (pure, derived but not injected)
 // ===========================================================================
 
+test("stableSessionIdFor: deterministic for the same logical session", () => {
+  assert.equal(stableSessionIdFor("ses_abc123"), stableSessionIdFor("ses_abc123"))
+})
+
+test("stableSessionIdFor: different logical sessions produce different ids", () => {
+  assert.notEqual(stableSessionIdFor("ses_abc"), stableSessionIdFor("ses_xyz"))
+})
+
 test("mimoSessionIdFor: deterministic + stable for the same session", () => {
   assert.equal(mimoSessionIdFor("ses_abc123"), mimoSessionIdFor("ses_abc123"))
 })
 
+test("mimoSessionIdFor preserves its existing id format", () => {
+  assert.equal(mimoSessionIdFor("ses_abc123"), `mimo-ses-${shorthash("ses_abc123")}`)
+})
+
 test("mimoSessionIdFor: distinct sessions produce distinct ids", () => {
   assert.notEqual(mimoSessionIdFor("ses_abc"), mimoSessionIdFor("ses_xyz"))
 })
@@ -898,6 +912,31 @@ test("mimoSessionIdFor: transient request fields cannot alter the id", () => {
   assert.equal(mimoSessionIdFor("ses_stable"), mimoSessionIdFor("ses_stable", { turn: 7, temperature: 0.9 }))
 })
 
+// ===========================================================================
+// OpenRouter session-affinity eligibility (pure policy decision only)
+// ===========================================================================
+
+test("OpenRouter affinity is eligible for MiMo and GLM only", () => {
+  assert.equal(isOpenRouterAffinityEligible(POLICY_MIMO26, "openrouter"), true)
+  assert.equal(isOpenRouterAffinityEligible(POLICY_GLM53, "openrouter"), true)
+})
+
+test("OpenRouter affinity is ineligible for non-OpenRouter providers", () => {
+  assert.equal(isOpenRouterAffinityEligible(POLICY_MIMO26, "xiaomi"), false)
+  assert.equal(isOpenRouterAffinityEligible(POLICY_GLM53, "zai"), false)
+  assert.equal(isOpenRouterAffinityEligible(POLICY_MIMO26, "unknown-provider"), false)
+})
+
+test("OpenRouter affinity is ineligible for DeepSeek and GPT", () => {
+  assert.equal(isOpenRouterAffinityEligible(POLICY_DEEPSEEK, "openrouter"), false)
+  assert.equal(isOpenRouterAffinityEligible(POLICY_GPT56, "openrouter"), false)
+})
+
+test("OpenRouter affinity is ineligible for unknown families and providers", () => {
+  assert.equal(isOpenRouterAffinityEligible("unknown-family", "openrouter"), false)
+  assert.equal(isOpenRouterAffinityEligible(POLICY_MIMO26, undefined), false)
+})
+
 // ===========================================================================
 // MiMo-V2.6: cached/prompt token metrics
 // ===========================================================================