@dan-ai-studio/dshopencodego 0.1.53 → 0.1.54

package/lib/client.js

@@ -27,6 +27,7 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/catalog/constants.ts
+var BACKGROUND_RETRY_BACKOFF_MS = 5 * 6e4;
 var MODEL_LISTING_MAX_BYTES = 1024 * 1024;
 var MODEL_METADATA_MAX_BYTES = 16 * 1024 * 1024;
 var UNKNOWN_MODEL_PROBE_COOLDOWN_MS = 5 * 6e4;

package/lib/index.js

@@ -42530,6 +42530,7 @@ var MODEL_METADATA_PROVIDER = "opencode-go";
 var METADATA_FETCH_TIMEOUT_MS = 1e4;
 var MODEL_METADATA_TIMEOUT_MS = 3e4;
 var METADATA_RETRY_DELAY_MS = 1500;
+var BACKGROUND_RETRY_BACKOFF_MS = 5 * 6e4;
 var MODEL_LISTING_MAX_BYTES = 1024 * 1024;
 var MODEL_METADATA_MAX_BYTES = 16 * 1024 * 1024;
 var UNKNOWN_MODEL_PROBE_COOLDOWN_MS = 5 * 6e4;
@@ -43285,6 +43286,8 @@ var OpencodeGoCatalog = class {
   probedAt = /* @__PURE__ */ new Map();
   /** The background refresh, kept so a caller can wait for it to be over. */
   backgroundRefresh;
+  /** When the last background refresh was started, for the back-off. */
+  lastRefreshAttemptAt = 0;
   constructor(options) {
     this.options = options;
     const cached = readFactsCache(options.cacheDir);
@@ -43348,7 +43351,9 @@ var OpencodeGoCatalog = class {
    */
   refreshInBackground() {
     if (this.pending !== void 0) return;
-    const refresh = this.build().then((snapshot2) => {
+    if (Date.now() - this.lastRefreshAttemptAt < BACKGROUND_RETRY_BACKOFF_MS) return;
+    this.lastRefreshAttemptAt = Date.now();
+    const refresh = this.build(void 0, false).then((snapshot2) => {
       this.served = snapshot2;
       return snapshot2;
     }).finally(() => {
@@ -43440,13 +43445,17 @@ var OpencodeGoCatalog = class {
   /**
    * Revalidate every source, reusing the metadata document when it is unchanged.
    * @param signal - caller cancellation, forwarded to the documentation read.
+   * @param retry - whether a failed metadata read is tried again. A caller
+   *   that is waiting for the answer wants it tried again; a refresh nobody
+   *   is waiting for does not, because the answer it wants is the one it
+   *   already has.
    */
-  async build(signal) {
+  async build(signal, retry = true) {
     const builtin = builtinModels(this.options.baseURL);
     const readDocument = this.options.readDocument ?? ((signal2) => fetchGoDocument(signal2, { cacheDir: this.options.cacheDir }));
     const [listing, metadata, documentation] = await Promise.allSettled([
       fetchModelIds(this.options.baseURL),
-      this.refreshMetadata(builtin),
+      this.refreshMetadata(builtin, retry),
       readDocument(signal)
     ]);
     const degradations = [];
@@ -43668,10 +43677,11 @@ var OpencodeGoCatalog = class {
    * @param builtin - the installed catalog, for the parse.
    * @returns the parsed metadata.
    */
-  async refreshMetadata(builtin) {
+  async refreshMetadata(builtin, retry) {
     try {
       return await this.readMetadataDocument(builtin);
     } catch (first) {
+      if (!retry) throw first;
       await new Promise((resolve3) => {
         setTimeout(resolve3, METADATA_RETRY_DELAY_MS);
       });
@@ -46198,7 +46208,7 @@ function createUpdateChecker(deps) {
 }
 
 // src/update/version.ts
-var PLUGIN_VERSION = true ? "0.1.53" : "0.0.0-dev";
+var PLUGIN_VERSION = true ? "0.1.54" : "0.0.0-dev";
 
 // src/update/service.ts
 import { TypertRemoteService as TypertRemoteService2 } from "@deepseek-ai/dsh-typert-protocol";

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

@@ -33,6 +33,18 @@ export declare const MODEL_METADATA_TIMEOUT_MS = 30000;
  * document still fails inside the catalog build.
  */
 export declare const METADATA_RETRY_DELAY_MS = 1500;
+/**
+ * How long a failed background refresh waits before it is tried again.
+ *
+ * A refresh that fails leaves the catalog's age where it was, so every call
+ * sees it as past its TTL and starts another. Without a back-off, a service
+ * that is down turns every model request into a full download attempt.
+ *
+ * Five minutes is short enough that a service that comes back is picked up
+ * soon, and long enough that a service that stays down is asked once, not
+ * once per request.
+ */
+export declare const BACKGROUND_RETRY_BACKOFF_MS: number;
 /** Response caps: the listing is tiny, the metadata document is not. */
 export declare const MODEL_LISTING_MAX_BYTES: number;
 export declare const MODEL_METADATA_MAX_BYTES: number;

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

@@ -160,6 +160,8 @@ export declare class OpencodeGoCatalog {
     private readonly probedAt;
     /** The background refresh, kept so a caller can wait for it to be over. */
     private backgroundRefresh;
+    /** When the last background refresh was started, for the back-off. */
+    private lastRefreshAttemptAt;
     constructor(options: CatalogOptions);
     /**
      * The cached snapshot, refreshed when it is older than the configured TTL.
@@ -237,6 +239,10 @@ export declare class OpencodeGoCatalog {
     /**
      * Revalidate every source, reusing the metadata document when it is unchanged.
      * @param signal - caller cancellation, forwarded to the documentation read.
+     * @param retry - whether a failed metadata read is tried again. A caller
+     *   that is waiting for the answer wants it tried again; a refresh nobody
+     *   is waiting for does not, because the answer it wants is the one it
+     *   already has.
      */
     private build;
     /** Merge the listing with the metadata document and the installed entries. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dan-ai-studio/dshopencodego",
-  "version": "0.1.53",
+  "version": "0.1.54",
   "description": "OpenCode Go provider for DeepSeek Harness: live gateway catalog, per-conversation session header, usage",
   "type": "module",
   "license": "MIT",