@dan-ai-studio/dshopencodego 0.1.21 → 0.1.23

package/lib/index.js

@@ -73,7 +73,8 @@ import { attributionHeaders as attributionHeaders3, LlmError as LlmError4 } from
 // src/catalog/constants.ts
 var PROVIDER_ID = "opencode-go";
 var DISPLAY_NAME = "OpenCode Go";
-var DEFAULT_BASE_URL = "https://opencode.ai/zen/go/v1";
+var DEFAULT_BASE_URL = "https://opencode.ai/inference/go/v1";
+var CONSOLE_BASE_URL = "https://opencode.ai/inference/v1";
 var MODEL_METADATA_URL = "https://models.dev/api.json";
 var MODEL_METADATA_PROVIDER = "opencode-go";
 var METADATA_FETCH_TIMEOUT_MS = 1e4;
@@ -1177,6 +1178,7 @@ var ACCOUNT_QUOTA_CODE = "ACCOUNT_QUOTA";
 function classifyPiAiError(message) {
   if (/\b(?:401|403)\b/.test(message)) return "AUTH";
   if (isQuotaExceededError(message)) return ACCOUNT_QUOTA_CODE;
+  if (/server_error/i.test(message)) return "SERVER";
   if (/\b429\b|rate.?limit/i.test(message)) return "RATE_LIMIT";
   if (/\b413\b|payload too large|request body too large|length limit exceeded/i.test(message)) return "INVALID_REQUEST";
   if (/\b400\b|invalid.?request/i.test(message)) return "INVALID_REQUEST";
@@ -1347,7 +1349,7 @@ var SEED_QUOTAS = {
   "deepseek-v4-flash-vision-exp": { monthlyUsd: 15, monthlyRequests: 32500 },
   "hy4-preview": { monthlyUsd: 30, monthlyRequests: 6770 },
   "hy3": { monthlyUsd: 60, monthlyRequests: 21500 },
-  "space-bunny-free": { monthlyUsd: "unlimited", monthlyRequests: "unlimited" },
+  // 注意：space-bunny-free 并不在 Go 端点支持的 37 个模型列表中（请求会返回 400 错误），已依据 R-B4 予以剔除
   "grok-4.7": { monthlyUsd: 15, monthlyRequests: 845 },
   "grok-4.6": { monthlyUsd: 15, monthlyRequests: 845 },
   "gpt-6-luna": { monthlyUsd: 15, monthlyRequests: 21130 },
@@ -1396,12 +1398,15 @@ function sortModels(models, now = Date.now()) {
 import { randomUUID } from "node:crypto";
 import { attributionHeaders as attributionHeaders4 } from "@deepseek-ai/dsh-llm";
 var SESSION_HEADER = "x-opencode-session";
+var SESSION_AFFINITY_HEADER = "x-session-affinity";
 function opencodeSessionValue(sessionId) {
   return sessionId !== void 0 && sessionId.length > 0 ? sessionId : randomUUID();
 }
 function providerHeaders(sessionId) {
+  const session = opencodeSessionValue(sessionId);
   return {
-    [SESSION_HEADER]: opencodeSessionValue(sessionId),
+    [SESSION_HEADER]: session,
+    [SESSION_AFFINITY_HEADER]: session,
     ...attributionHeaders4()
   };
 }
@@ -1762,6 +1767,44 @@ var catalogRemote = {
   ]
 };
 
+// src/update/contract.ts
+function parseUpdateStatus(value) {
+  if (value === null || typeof value !== "object") throw new Error("invalid update reading");
+  const row = value;
+  if (typeof row["current"] !== "string") throw new Error("invalid update reading");
+  if (row["latest"] !== void 0 && typeof row["latest"] !== "string") throw new Error("invalid update reading");
+  if (typeof row["available"] !== "boolean") throw new Error("invalid update reading");
+  if (typeof row["checkedAt"] !== "number" || !Number.isFinite(row["checkedAt"])) {
+    throw new Error("invalid update reading");
+  }
+  return {
+    current: row["current"],
+    latest: typeof row["latest"] === "string" ? row["latest"] : void 0,
+    available: row["available"],
+    checkedAt: row["checkedAt"]
+  };
+}
+var codec2 = (typeSymbol, parse) => ({
+  mode: "strict",
+  typeSymbol,
+  schema: { parse },
+  create: () => ({ parse })
+});
+var updateRemote = {
+  package: "@dan-ai-studio/dshopencodego",
+  descriptors: [
+    {
+      id: "@dan-ai-studio/dshopencodego#opencodeGoUpdate/readUpdate",
+      service: "opencodeGoUpdate",
+      namespace: "opencodeGoUpdate",
+      method: "readUpdate",
+      invocation: { kind: "direct" },
+      parameters: [],
+      result: codec2("@dan-ai-studio/dshopencodego#UpdateStatus", parseUpdateStatus)
+    }
+  ]
+};
+
 // src/usage/contract.ts
 function parseWindow(value, key) {
   if (value === null || typeof value !== "object") throw new Error(`invalid usage window "${key}"`);
@@ -1816,7 +1859,7 @@ function parseGoMeter(value) {
     })
   };
 }
-var codec2 = (typeSymbol, parse) => ({
+var codec3 = (typeSymbol, parse) => ({
   mode: "strict",
   typeSymbol,
   schema: { parse },
@@ -1832,7 +1875,7 @@ var usageRemote = {
       method: "readWindows",
       invocation: { kind: "direct" },
       parameters: [],
-      result: codec2("@dan-ai-studio/dshopencodego#GoUsageWindows", parseUsageWindows)
+      result: codec3("@dan-ai-studio/dshopencodego#GoUsageWindows", parseUsageWindows)
     },
     {
       id: "@dan-ai-studio/dshopencodego#opencodeGoUsage/readMeter",
@@ -1841,7 +1884,7 @@ var usageRemote = {
       method: "readMeter",
       invocation: { kind: "direct" },
       parameters: [],
-      result: codec2("@dan-ai-studio/dshopencodego#GoMeter", parseGoMeter)
+      result: codec3("@dan-ai-studio/dshopencodego#GoMeter", parseGoMeter)
     }
   ]
 };
@@ -1849,7 +1892,7 @@ var usageRemote = {
 // src/remotes.ts
 var contribution = {
   package: usageRemote.package,
-  descriptors: [...usageRemote.descriptors, ...catalogRemote.descriptors]
+  descriptors: [...usageRemote.descriptors, ...catalogRemote.descriptors, ...updateRemote.descriptors]
 };
 function registerRemotes(ctx) {
   ctx.inject(["typert"], (scope) => {
@@ -1944,6 +1987,106 @@ var OpencodeGoCatalogService = class extends TypertRemoteService {
   }
 };
 
+// src/update/check.ts
+var PACKAGE_NAME = "@dan-ai-studio/dshopencodego";
+var REGISTRY_LATEST_URL = `https://registry.npmjs.org/${encodeURIComponent(PACKAGE_NAME)}/latest`;
+var CHECK_CACHE_MS = 6 * 60 * 60 * 1e3;
+var CHECK_TIMEOUT_MS = 1e4;
+function parseVersion(value) {
+  const match = /^(\d+)\.(\d+)\.(\d+)(?:-([0-9a-zA-Z.-]+))?(?:\+[0-9a-zA-Z.-]+)?$/.exec(value.trim());
+  if (match === void 0 || match === null) return void 0;
+  const [, major, minor, patch, prerelease] = match;
+  return {
+    core: [Number(major), Number(minor), Number(patch)],
+    prerelease: prerelease === void 0 ? void 0 : prerelease.split(".")
+  };
+}
+function compareVersions(left, right) {
+  const ours = parseVersion(left);
+  const theirs = parseVersion(right);
+  if (ours === void 0 || theirs === void 0) throw new Error(`dshopencodego: cannot compare versions "${left}" and "${right}"`);
+  for (let index = 0; index < 3; index += 1) {
+    const difference = (ours.core[index] ?? 0) - (theirs.core[index] ?? 0);
+    if (difference !== 0) return difference;
+  }
+  if (ours.prerelease === void 0 && theirs.prerelease === void 0) return 0;
+  if (ours.prerelease === void 0) return 1;
+  if (theirs.prerelease === void 0) return -1;
+  const width = Math.max(ours.prerelease.length, theirs.prerelease.length);
+  for (let index = 0; index < width; index += 1) {
+    const oursPart = ours.prerelease[index];
+    const theirsPart = theirs.prerelease[index];
+    if (oursPart === void 0) return -1;
+    if (theirsPart === void 0) return 1;
+    if (oursPart !== theirsPart) return oursPart < theirsPart ? -1 : 1;
+  }
+  return 0;
+}
+function isUpdateAvailable(current, latest) {
+  if (latest === void 0) return false;
+  try {
+    return compareVersions(latest, current) > 0;
+  } catch {
+    return false;
+  }
+}
+function parseLatestVersion(body) {
+  if (body === null || typeof body !== "object") return void 0;
+  const version = body["version"];
+  return typeof version === "string" && parseVersion(version) !== void 0 ? version : void 0;
+}
+function createUpdateChecker(deps) {
+  const now = deps.now ?? Date.now;
+  const fetchImpl = deps.fetchImpl ?? fetch;
+  let cached;
+  let inflight;
+  async function lookup() {
+    const checkedAt = now();
+    try {
+      const response = await fetchImpl(REGISTRY_LATEST_URL, { signal: AbortSignal.timeout(CHECK_TIMEOUT_MS) });
+      if (!response.ok) throw new Error(`registry answered ${response.status}`);
+      const latest = parseLatestVersion(await response.json());
+      return {
+        current: deps.currentVersion,
+        latest,
+        available: isUpdateAvailable(deps.currentVersion, latest),
+        checkedAt
+      };
+    } catch {
+      return { current: deps.currentVersion, latest: void 0, available: false, checkedAt };
+    }
+  }
+  return {
+    check(force = false) {
+      if (!force && cached !== void 0 && now() - cached.checkedAt < CHECK_CACHE_MS) return Promise.resolve(cached);
+      inflight ??= lookup().then((status) => {
+        cached = status;
+        inflight = void 0;
+        return status;
+      });
+      return inflight;
+    }
+  };
+}
+
+// src/update/version.ts
+var PLUGIN_VERSION = true ? "0.1.23" : "0.0.0-dev";
+
+// src/update/service.ts
+import { TypertRemoteService as TypertRemoteService2 } from "@deepseek-ai/dsh-typert-protocol";
+var OpencodeGoUpdateService = class extends TypertRemoteService2 {
+  check;
+  constructor(ctx, options) {
+    super(ctx, "opencodeGoUpdate");
+    const checker = createUpdateChecker({ currentVersion: options.currentVersion });
+    this.check = (force) => checker.check(force);
+  }
+  /** Whether a newer release is published; `force` bypasses the cache. */
+  readUpdate(force) {
+    return this.check(force);
+  }
+};
+
 // src/usage/meter.ts
 var EMPTY = {
   calls: 0,
@@ -2049,7 +2192,7 @@ async function readUsageWindows(options) {
 
 // src/usage/service.ts
 import { randomUUID as randomUUID2 } from "node:crypto";
-import { RemoteError as RemoteError2, TypertRemoteService as TypertRemoteService2 } from "@deepseek-ai/dsh-typert-protocol";
+import { RemoteError as RemoteError2, TypertRemoteService as TypertRemoteService3 } from "@deepseek-ai/dsh-typert-protocol";
 import { LlmError as LlmError11 } from "@deepseek-ai/dsh-llm";
 function usageFailure(error, source) {
   const missing = error instanceof LlmError11 && error.code === "MISSING_CREDENTIAL";
@@ -2060,7 +2203,7 @@ function usageFailure(error, source) {
     { cause: error }
   );
 }
-var OpencodeGoUsageService = class extends TypertRemoteService2 {
+var OpencodeGoUsageService = class extends TypertRemoteService3 {
   identity;
   options;
   constructor(ctx, options) {
@@ -2153,6 +2296,7 @@ function apply(ctx, raw) {
     catalog: () => adapter.catalogOf(current()),
     visibility: () => current().modelVisibility
   });
+  ctx.plugin(OpencodeGoUpdateService, { currentVersion: PLUGIN_VERSION });
   let registration;
   let visibilityFacts = JSON.stringify(current().modelVisibility);
   const applyRoute = (credentialConfigured) => {
@@ -2195,7 +2339,7 @@ function apply(ctx, raw) {
   const undiscover = ctx.llm.registerModelDiscovery(name, async (request) => {
     if (request.provider !== PROVIDER_ID && !(request.baseURL ?? "").includes("opencode.ai")) {
       throw new LlmError12(
-        "dshopencodego discovers only OpenCode zen/go endpoints; enter this provider's models by hand",
+        "dshopencodego discovers only OpenCode Go/Console endpoints; enter this provider's models by hand",
         "DISCOVERY_UNSUPPORTED"
       );
     }
@@ -2220,6 +2364,7 @@ function apply(ctx, raw) {
   ctx.logger.info(`dshopencodego: route "${PROVIDER_ID}" registered as ${DISPLAY_NAME}`);
 }
 export {
+  CONSOLE_BASE_URL,
   Config,
   DEFAULT_API_KEY_ENV,
   DEFAULT_BASE_URL,
@@ -2228,6 +2373,7 @@ export {
   OpencodeGoCatalog,
   PROVIDER_ID,
   PlainConfig,
+  SESSION_AFFINITY_HEADER,
   SESSION_HEADER,
   apply,
   assertBaseURL,

package/lib/types/catalog/constants.d.ts

@@ -4,7 +4,9 @@ export declare const PROVIDER_ID = "opencode-go";
 /** Selector label for the route. */
 export declare const DISPLAY_NAME = "OpenCode Go";
 /** Gateway base URL; `/models` and `/usage` hang off it. */
-export declare const DEFAULT_BASE_URL = "https://opencode.ai/zen/go/v1";
+export declare const DEFAULT_BASE_URL = "https://opencode.ai/inference/go/v1";
+/** Console base URL (on-demand / free models, pay-as-you-go). */
+export declare const CONSOLE_BASE_URL = "https://opencode.ai/inference/v1";
 /** Online model metadata: capability, lifecycle, and pricing per model id. */
 export declare const MODEL_METADATA_URL = "https://models.dev/api.json";
 /** The models.dev provider key this plugin reads. */

package/lib/types/catalog/constants.js

@@ -4,7 +4,9 @@ export const PROVIDER_ID = 'opencode-go';
 /** Selector label for the route. */
 export const DISPLAY_NAME = 'OpenCode Go';
 /** Gateway base URL; `/models` and `/usage` hang off it. */
-export const DEFAULT_BASE_URL = 'https://opencode.ai/zen/go/v1';
+export const DEFAULT_BASE_URL = 'https://opencode.ai/inference/go/v1';
+/** Console base URL (on-demand / free models, pay-as-you-go). */
+export const CONSOLE_BASE_URL = 'https://opencode.ai/inference/v1';
 /** Online model metadata: capability, lifecycle, and pricing per model id. */
 export const MODEL_METADATA_URL = 'https://models.dev/api.json';
 /** The models.dev provider key this plugin reads. */

package/lib/types/catalog/index.d.ts

@@ -23,7 +23,7 @@ import type { LlmDiscoveredModel } from '@deepseek-ai/dsh-llm';
 import type { GoDoc } from './go-doc.ts';
 import type { ModelDefaults, ModelFacts } from './metadata.ts';
 import type { GoQuota } from '../go-limits.ts';
-export { PROVIDER_ID, DISPLAY_NAME, DEFAULT_BASE_URL } from './constants.ts';
+export { PROVIDER_ID, DISPLAY_NAME, DEFAULT_BASE_URL, CONSOLE_BASE_URL } from './constants.ts';
 export { readModelIds, fetchModelIds } from './gateway.ts';
 export { readOnlineMetadata, toPiModel, modelBaseURL } from './metadata.ts';
 export type { ModelFacts, OnlineMetadata, ModelDefaults } from './metadata.ts';

package/lib/types/catalog/index.js

@@ -29,7 +29,7 @@ import { fetchModelIds } from "./gateway.js";
 import { fetchGoDocument, GO_DOC_URLS } from "./go-doc.js";
 import { readBoundedJson } from "./json-response.js";
 import { readOnlineMetadata, toPiModel } from "./metadata.js";
-export { PROVIDER_ID, DISPLAY_NAME, DEFAULT_BASE_URL } from "./constants.js";
+export { PROVIDER_ID, DISPLAY_NAME, DEFAULT_BASE_URL, CONSOLE_BASE_URL } from "./constants.js";
 export { readModelIds, fetchModelIds } from "./gateway.js";
 export { readOnlineMetadata, toPiModel, modelBaseURL } from "./metadata.js";
 export { decideProtocol, inferProtocol, protocolOfNpm } from "./protocol.js";

package/lib/types/conversion/stream.js

@@ -51,6 +51,12 @@ export function classifyPiAiError(message) {
         return 'AUTH';
     if (isQuotaExceededError(message))
         return ACCOUNT_QUOTA_CODE;
+    // A 429 typed as `server_error` is the gateway reporting an unavailable
+    // upstream, not the caller exceeding a rate limit: the remedy is waiting for
+    // the endpoint to recover rather than slowing down, so it classifies as
+    // SERVER even though the status code alone reads as a rate limit.
+    if (/server_error/i.test(message))
+        return 'SERVER';
     if (/\b429\b|rate.?limit/i.test(message))
         return 'RATE_LIMIT';
     if (/\b413\b|payload too large|request body too large|length limit exceeded/i.test(message))

package/lib/types/go-limits.js

@@ -58,7 +58,7 @@ export const SEED_QUOTAS = {
     'deepseek-v4-flash-vision-exp': { monthlyUsd: 15, monthlyRequests: 32_500 },
     'hy4-preview': { monthlyUsd: 30, monthlyRequests: 6_770 },
     'hy3': { monthlyUsd: 60, monthlyRequests: 21_500 },
-    'space-bunny-free': { monthlyUsd: 'unlimited', monthlyRequests: 'unlimited' },
+    // 注意：space-bunny-free 并不在 Go 端点支持的 37 个模型列表中（请求会返回 400 错误），已依据 R-B4 予以剔除
     'grok-4.7': { monthlyUsd: 15, monthlyRequests: 845 },
     'grok-4.6': { monthlyUsd: 15, monthlyRequests: 845 },
     'gpt-6-luna': { monthlyUsd: 15, monthlyRequests: 21_130 },

package/lib/types/index.d.ts

@@ -19,7 +19,7 @@
  *   config:
  *     enabled: true                             # false withdraws the route only
  *     apiKeyEnv: OPENCODE_GO_API_KEY             # default
- *     baseURL: https://opencode.ai/zen/go/v1     # default
+ *     baseURL: https://opencode.ai/inference/go/v1     # default
  *     refreshMinutes: 60                         # live catalog TTL
  *     modelProtocols:                            # last-resort protocol override
  *       some-model: openai-responses
@@ -35,10 +35,10 @@ declare module '@deepseek-ai/cordis' {
 }
 export { OpencodeGoAdapter } from './adapter.ts';
 export type { OpencodeGoAdapterOptions, OpencodeGoImageAccess } from './adapter.ts';
-export { DEFAULT_BASE_URL, DISPLAY_NAME, PROVIDER_ID, OpencodeGoCatalog, discoverCatalogModels } from './catalog/index.ts';
+export { DEFAULT_BASE_URL, CONSOLE_BASE_URL, DISPLAY_NAME, PROVIDER_ID, OpencodeGoCatalog, discoverCatalogModels } from './catalog/index.ts';
 export { Config, PlainConfig, assertBaseURL, DEFAULT_API_KEY_ENV } from './config.ts';
 export type { OpencodeGoConfig } from './config.ts';
-export { SESSION_HEADER, opencodeSessionValue, providerHeaders } from './session-header.ts';
+export { SESSION_HEADER, SESSION_AFFINITY_HEADER, opencodeSessionValue, providerHeaders } from './session-header.ts';
 export { isModelEnabled, sortModels } from './models.ts';
 export type { ModelSummary } from './models.ts';
 export declare const name = "dshopencodego";

package/lib/types/index.js

@@ -19,7 +19,7 @@
  *   config:
  *     enabled: true                             # false withdraws the route only
  *     apiKeyEnv: OPENCODE_GO_API_KEY             # default
- *     baseURL: https://opencode.ai/zen/go/v1     # default
+ *     baseURL: https://opencode.ai/inference/go/v1     # default
  *     refreshMinutes: 60                         # live catalog TTL
  *     modelProtocols:                            # last-resort protocol override
  *       some-model: openai-responses
@@ -36,11 +36,13 @@ import { DISPLAY_NAME, PROVIDER_ID, discoverCatalogModels } from "./catalog/inde
 import { assertBaseURL, PlainConfig, readConfig } from "./config.js";
 import { registerRemotes } from "./remotes.js";
 import { OpencodeGoCatalogService } from "./catalog/service.js";
+import { OpencodeGoUpdateService } from "./update/index.js";
+import { PLUGIN_VERSION } from "./update/index.js";
 import { OpencodeGoUsageService, UsageMeter } from "./usage/index.js";
 export { OpencodeGoAdapter } from "./adapter.js";
-export { DEFAULT_BASE_URL, DISPLAY_NAME, PROVIDER_ID, OpencodeGoCatalog, discoverCatalogModels } from "./catalog/index.js";
+export { DEFAULT_BASE_URL, CONSOLE_BASE_URL, DISPLAY_NAME, PROVIDER_ID, OpencodeGoCatalog, discoverCatalogModels } from "./catalog/index.js";
 export { Config, PlainConfig, assertBaseURL, DEFAULT_API_KEY_ENV } from "./config.js";
-export { SESSION_HEADER, opencodeSessionValue, providerHeaders } from "./session-header.js";
+export { SESSION_HEADER, SESSION_AFFINITY_HEADER, opencodeSessionValue, providerHeaders } from "./session-header.js";
 export { isModelEnabled, sortModels } from "./models.js";
 export const name = 'dshopencodego';
 export const inject = ['llm'];
@@ -107,6 +109,7 @@ export function apply(ctx, raw) {
         catalog: () => adapter.catalogOf(current()),
         visibility: () => current().modelVisibility,
     });
+    ctx.plugin(OpencodeGoUpdateService, { currentVersion: PLUGIN_VERSION });
     let registration;
     let visibilityFacts = JSON.stringify(current().modelVisibility);
     /**
@@ -166,7 +169,7 @@ export function apply(ctx, raw) {
     syncRoute();
     const undiscover = ctx.llm.registerModelDiscovery(name, async (request) => {
         if (request.provider !== PROVIDER_ID && !(request.baseURL ?? '').includes('opencode.ai')) {
-            throw new LlmError('dshopencodego discovers only OpenCode zen/go endpoints; enter this provider\'s models by hand', 'DISCOVERY_UNSUPPORTED');
+            throw new LlmError('dshopencodego discovers only OpenCode Go/Console endpoints; enter this provider\'s models by hand', 'DISCOVERY_UNSUPPORTED');
         }
         return discoverCatalogModels(adapter.catalogOf(current()));
     });

package/lib/types/remotes.js

@@ -8,11 +8,12 @@
  * @module @dan-ai-studio/dshopencodego/remotes
  */
 import { catalogRemote } from "./catalog/contract.js";
+import { updateRemote } from "./update/contract.js";
 import { usageRemote } from "./usage/contract.js";
 /** Every Remote method this package owns, mounted as one contribution. */
 const contribution = {
     package: usageRemote.package,
-    descriptors: [...usageRemote.descriptors, ...catalogRemote.descriptors],
+    descriptors: [...usageRemote.descriptors, ...catalogRemote.descriptors, ...updateRemote.descriptors],
 };
 /** Register this package's Remote contribution for the mount's lifetime. */
 export function registerRemotes(ctx) {

package/lib/types/session-header.d.ts

@@ -17,6 +17,8 @@
  */
 /** Header name the gateway requires. */
 export declare const SESSION_HEADER = "x-opencode-session";
+/** Session affinity header for gateway routing and prompt caching. */
+export declare const SESSION_AFFINITY_HEADER = "x-session-affinity";
 /**
  * The header value for one request.
  * @param sessionId - the request's session id, if it names one.
@@ -27,9 +29,9 @@ export declare function opencodeSessionValue(sessionId: string | undefined): str
  * Every header one provider request carries.
  *
  * The attribution `user-agent` is Harness-owned and always present; the session
- * header is added on top of it. A caller-supplied header of the same name can
- * never win, because the gateway's routing decision must follow the session,
- * not a deployment string.
+ * and affinity headers are added on top of it. A caller-supplied header of the
+ * same name can never win, because the gateway's routing decision must follow
+ * the session, not a deployment string.
  * @param sessionId - the request's session id, if it names one.
  * @returns headers for the pi-ai request options.
  */

package/lib/types/session-header.js

@@ -19,6 +19,8 @@ import { randomUUID } from 'node:crypto';
 import { attributionHeaders } from '@deepseek-ai/dsh-llm';
 /** Header name the gateway requires. */
 export const SESSION_HEADER = 'x-opencode-session';
+/** Session affinity header for gateway routing and prompt caching. */
+export const SESSION_AFFINITY_HEADER = 'x-session-affinity';
 /**
  * The header value for one request.
  * @param sessionId - the request's session id, if it names one.
@@ -31,15 +33,17 @@ export function opencodeSessionValue(sessionId) {
  * Every header one provider request carries.
  *
  * The attribution `user-agent` is Harness-owned and always present; the session
- * header is added on top of it. A caller-supplied header of the same name can
- * never win, because the gateway's routing decision must follow the session,
- * not a deployment string.
+ * and affinity headers are added on top of it. A caller-supplied header of the
+ * same name can never win, because the gateway's routing decision must follow
+ * the session, not a deployment string.
  * @param sessionId - the request's session id, if it names one.
  * @returns headers for the pi-ai request options.
  */
 export function providerHeaders(sessionId) {
+    const session = opencodeSessionValue(sessionId);
     return {
-        [SESSION_HEADER]: opencodeSessionValue(sessionId),
+        [SESSION_HEADER]: session,
+        [SESSION_AFFINITY_HEADER]: session,
         ...attributionHeaders(),
     };
 }

package/lib/types/update/check.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Self update check: is a newer release of this package published?
+ *
+ * This module only *reads*: it asks the npm registry for the latest published
+ * version and compares it with the running build. It never downloads,
+ * installs, or replaces anything — the actual update stays with the host's
+ * `pluginManager` (`removeBundle` + `installBundle`), driven by an explicit
+ * user click on the settings page. Automatic self-replacement would bypass
+ * the host's manifest lock, peer-compatibility checks, build approvals, and
+ * HMR lifecycle, so it is deliberately not implemented here.
+ *
+ * The check runs only when the settings page asks (page open or manual
+ * refresh), never on the model-request path, and fails silent: an unreachable
+ * registry simply hides the banner instead of erroring the page.
+ *
+ * @module @dan-ai-studio/dshopencodego/update/check
+ */
+/** This package as addressed on the registry. */
+export declare const PACKAGE_NAME = "@dan-ai-studio/dshopencodego";
+/** Document address answering `{ "version": "x.y.z", ... }`. */
+export declare const REGISTRY_LATEST_URL: string;
+/** How long one lookup answers for before the registry is asked again. */
+export declare const CHECK_CACHE_MS: number;
+/** Bound on one registry round trip; expiry fails silent, never throws. */
+export declare const CHECK_TIMEOUT_MS = 10000;
+/** What the settings page renders. */
+export interface UpdateStatus {
+    /** Version of the running build. */
+    readonly current: string;
+    /** Latest published version, when the registry answered. */
+    readonly latest: string | undefined;
+    /** True when the registry answered and `latest` is newer than `current`. */
+    readonly available: boolean;
+    /** Milliseconds since the epoch of the lookup backing this reading. */
+    readonly checkedAt: number;
+}
+interface ParsedVersion {
+    readonly core: readonly number[];
+    /** Absent for a release; present (lower precedence) for `1.2.3-tag.4`. */
+    readonly prerelease: readonly string[] | undefined;
+}
+/** Split `1.2.3-tag.4+build` into comparable parts; invalid input yields undefined. */
+export declare function parseVersion(value: string): ParsedVersion | undefined;
+/**
+ * Compare two version strings.
+ * @returns negative when `left` is older, positive when newer, zero when equal.
+ * @throws {Error} when either side is not a version.
+ */
+export declare function compareVersions(left: string, right: string): number;
+/** True when `latest` is a newer release than `current`. Unparsable input is never an update. */
+export declare function isUpdateAvailable(current: string, latest: string | undefined): boolean;
+/** Read the `version` field out of a registry `latest` document. */
+export declare function parseLatestVersion(body: unknown): string | undefined;
+/** Dependencies the check needs, injectable for tests. */
+export interface UpdateCheckDeps {
+    /** Running build's version (build-time constant in production). */
+    readonly currentVersion: string;
+    /** Fetch implementation; defaults to the global one. */
+    readonly fetchImpl?: typeof fetch;
+    /** Clock; defaults to `Date.now`. */
+    readonly now?: () => number;
+}
+/**
+ * Ask the registry for the latest published version, cached per process.
+ *
+ * Concurrent callers share one in-flight lookup. A lookup that fails for any
+ * reason — network, timeout, malformed document — resolves as "no update
+ * known" rather than rejecting, so the settings page never breaks because
+ * the registry is unreachable.
+ */
+export declare function createUpdateChecker(deps: UpdateCheckDeps): {
+    check(force?: boolean): Promise<UpdateStatus>;
+};
+export {};