opencode-fixes-huihui 0.1.0

package/README.md

@@ -0,0 +1,53 @@
+# opencode-fixes-huihui
+
+opencode 单插件版本：统一处理 sticky session headers 和 `promptCacheKey`，用于稳定会话路由与缓存命中。
+
+## 安装
+
+```bash
+npm i opencode-fixes-huihui
+```
+
+## 使用
+
+```ts
+import StickySessionPlugin from "opencode-fixes-huihui";
+
+export default {
+  plugins: [StickySessionPlugin],
+};
+```
+
+也可使用具名导出：
+
+```ts
+import { StickySessionPlugin } from "opencode-fixes-huihui";
+```
+
+## 行为
+
+插件在 `chat.params` 中执行：
+
+1. 仅对 `@ai-sdk/openai` provider 生效
+2. 解析会话值优先级：
+   - `OPENCODE_PROMPT_CACHE_KEY`
+   - `OPENCODE_STICKY_SESSION_ID`
+   - 现有 headers：`x-session-id` / `conversation_id` / `session_id`
+   - `input.sessionID`
+3. 将解析值同时写入：
+   - `input.model.headers.x-session-id`
+   - `input.model.headers.conversation_id`
+   - `input.model.headers.session_id`
+   - `output.options.promptCacheKey`
+
+## 可选环境变量
+
+- `OPENCODE_PROMPT_CACHE_KEY`: 强制覆盖会话值（最高优先级）
+- `OPENCODE_STICKY_SESSION_ID`: 次优先级覆盖会话值
+
+## 开发
+
+```bash
+npm run typecheck
+npm run build
+```

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+import type { Plugin } from "@opencode-ai/plugin";
+/**
+ * set a session-scoped prompt cache key and session-scoped sticky routing headers for right.codes.
+ *
+ * Injects HTTP headers via `input.model.headers` so upstream proxies/load
+ * balancers can keep a conversation pinned to one account.
+ *
+ * Headers injected for @ai-sdk/openai providers:
+ * - x-session-id
+ * - conversation_id
+ * - session_id
+ *
+ * Source of truth (in order):
+ * - env: OPENCODE_PROMPT_CACHE_KEY (manual override)
+ * - env: OPENCODE_STICKY_SESSION_ID (manual override)
+ * - model headers (x-session-id / conversation_id / session_id)
+ * - opencode sessionID (default)
+ */
+export declare const StickySessionPlugin: Plugin;
+export default StickySessionPlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AA2BlD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAsBjC,CAAC;AAEF,eAAe,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,60 @@
+const OPENAI_PROVIDER_NPM = "@ai-sdk/openai";
+const OPENAI_PROVIDER_ID = "openai";
+const SESSION_HEADER_KEYS = ["x-session-id", "conversation_id", "session_id"];
+const normalize = (value) => (typeof value === "string" ? value.trim() : "");
+const pickHeaderSessionValue = (headers) => {
+    for (const key of SESSION_HEADER_KEYS) {
+        const value = normalize(headers[key]);
+        if (value)
+            return value;
+    }
+    return "";
+};
+const ensureHeaders = (model) => {
+    if (model.headers && typeof model.headers === "object") {
+        return model.headers;
+    }
+    const headers = {};
+    model.headers = headers;
+    return headers;
+};
+/**
+ * set a session-scoped prompt cache key and session-scoped sticky routing headers for right.codes.
+ *
+ * Injects HTTP headers via `input.model.headers` so upstream proxies/load
+ * balancers can keep a conversation pinned to one account.
+ *
+ * Headers injected for @ai-sdk/openai providers:
+ * - x-session-id
+ * - conversation_id
+ * - session_id
+ *
+ * Source of truth (in order):
+ * - env: OPENCODE_PROMPT_CACHE_KEY (manual override)
+ * - env: OPENCODE_STICKY_SESSION_ID (manual override)
+ * - model headers (x-session-id / conversation_id / session_id)
+ * - opencode sessionID (default)
+ */
+export const StickySessionPlugin = async () => {
+    const envPromptCacheKey = normalize(process.env.OPENCODE_PROMPT_CACHE_KEY);
+    const envStickySessionID = normalize(process.env.OPENCODE_STICKY_SESSION_ID);
+    const envOverride = envPromptCacheKey || envStickySessionID;
+    return {
+        "chat.params": async (input, output) => {
+            const providerNpm = normalize(input.model.api.npm);
+            const providerID = normalize(input.provider.info.id);
+            if (!providerNpm.includes(OPENAI_PROVIDER_NPM) && providerID !== OPENAI_PROVIDER_ID)
+                return;
+            const headers = ensureHeaders(input.model);
+            const sessionValue = envOverride || pickHeaderSessionValue(headers) || normalize(input.sessionID);
+            if (!sessionValue)
+                return;
+            for (const key of SESSION_HEADER_KEYS) {
+                headers[key] = sessionValue;
+            }
+            output.options.promptCacheKey = sessionValue;
+        },
+    };
+};
+export default StickySessionPlugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAEA,MAAM,mBAAmB,GAAG,gBAAgB,CAAC;AAC7C,MAAM,kBAAkB,GAAG,QAAQ,CAAC;AACpC,MAAM,mBAAmB,GAAG,CAAC,cAAc,EAAE,iBAAiB,EAAE,YAAY,CAAU,CAAC;AAIvF,MAAM,SAAS,GAAG,CAAC,KAAc,EAAU,EAAE,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAE9F,MAAM,sBAAsB,GAAG,CAAC,OAAkB,EAAU,EAAE;IAC5D,KAAK,MAAM,GAAG,IAAI,mBAAmB,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QACtC,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;IAC1B,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,CAAC,KAA4B,EAAa,EAAE;IAChE,IAAI,KAAK,CAAC,OAAO,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACvD,OAAO,KAAK,CAAC,OAAoB,CAAC;IACpC,CAAC;IACD,MAAM,OAAO,GAAc,EAAE,CAAC;IAC9B,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC;IACxB,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAW,KAAK,IAAI,EAAE;IACpD,MAAM,iBAAiB,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;IAC3E,MAAM,kBAAkB,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;IAC7E,MAAM,WAAW,GAAG,iBAAiB,IAAI,kBAAkB,CAAC;IAE5D,OAAO;QACL,aAAa,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,WAAW,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACnD,MAAM,UAAU,GAAG,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACrD,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,mBAAmB,CAAC,IAAI,UAAU,KAAK,kBAAkB;gBAAE,OAAO;YAE5F,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC3C,MAAM,YAAY,GAAG,WAAW,IAAI,sBAAsB,CAAC,OAAO,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YAClG,IAAI,CAAC,YAAY;gBAAE,OAAO;YAE1B,KAAK,MAAM,GAAG,IAAI,mBAAmB,EAAE,CAAC;gBACtC,OAAO,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC;YAC9B,CAAC;YAED,MAAM,CAAC,OAAO,CAAC,cAAc,GAAG,YAAY,CAAC;QAC/C,CAAC;KACF,CAAC;AACJ,CAAC,CAAC;AAEF,eAAe,mBAAmB,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "opencode-fixes-huihui",
+  "version": "0.1.0",
+  "description": "Unified sticky-session plugin for opencode with session headers and prompt cache key.",
+  "type": "module",
+  "private": false,
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run typecheck && npm run build"
+  },
+  "keywords": [
+    "opencode",
+    "plugin",
+    "session",
+    "sticky-session",
+    "prompt-cache"
+  ],
+  "author": "huihuimoe",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://huihui.cat/huihui/opencode-fixes-huihui.git"
+  },
+  "homepage": "https://huihui.cat/huihui/opencode-fixes-huihui",
+  "bugs": {
+    "url": "https://huihui.cat/huihui/opencode-fixes-huihui/-/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "@opencode-ai/plugin": "^1.2.6",
+    "@types/node": "^25.2.3",
+    "typescript": "^5.9.2"
+  }
+}