@dan-ai-studio/dshopencodego 0.1.53 → 0.1.55

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;
@@ -1411,7 +1412,7 @@ function failureOf(error) {
   }
   return { message: "", retainPrevious: false };
 }
-var POLL_MS = 6e4;
+var POLL_MS = 5 * 6e4;
 var MAX_UNPRICED_IDS = 3;
 function formatUSD(value) {
   if (value === 0) return "$0.0000";

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;
@@ -42639,6 +42640,7 @@ var DISCOVERY_MAX_BYTES = 8 * 1024 * 1024;
 var DISCOVERY_TIMEOUT_MS = 1e4;
 var CACHE_FILE = "go-doc-paths.json";
 var CACHE_VERSION = 1;
+var DISCOVERY_COOLDOWN_MS = 60 * 6e4;
 function selectDocumentPaths(paths) {
   const selected = [];
   for (const path5 of paths) {
@@ -42699,6 +42701,31 @@ function rememberPaths(cacheDir, discovered) {
   }
   return merged;
 }
+function discoveryAllowed(cacheDir) {
+  if (cacheDir === void 0) return true;
+  try {
+    const parsed = JSON.parse(readFileSync(join2(cacheDir, CACHE_FILE), "utf8"));
+    if (typeof parsed.lastAttemptAt !== "number") return true;
+    return Date.now() - parsed.lastAttemptAt >= DISCOVERY_COOLDOWN_MS;
+  } catch {
+    return true;
+  }
+}
+function rememberAttempt(cacheDir) {
+  if (cacheDir === void 0) return;
+  try {
+    mkdirSync(cacheDir, { recursive: true });
+    const file = {
+      version: CACHE_VERSION,
+      paths: readCachedPaths(cacheDir),
+      updatedAt: Date.now(),
+      lastAttemptAt: Date.now()
+    };
+    writeFileSync(join2(cacheDir, CACHE_FILE), `${JSON.stringify(file, null, 2)}
+`, "utf8");
+  } catch {
+  }
+}
 
 // src/catalog/go-doc-cache.ts
 import { mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "node:fs";
@@ -42775,11 +42802,11 @@ function protocolOfEndpoint(endpoint) {
   return void 0;
 }
 function tableRows(lines, required) {
-  const start = lines.findIndex((line) => line.startsWith("|") && line.includes(required));
+  const start = lines.findIndex((line) => line.trimStart().startsWith("|") && line.includes(required));
   if (start < 0) return [];
   const rows = [];
   for (let index = start + 2; index < lines.length; index++) {
-    const line = lines[index] ?? "";
+    const line = (lines[index] ?? "").trimStart();
     if (!line.startsWith("|")) break;
     rows.push(line.split("|").slice(1, -1).map((entry) => entry.trim()));
   }
@@ -42862,18 +42889,23 @@ async function fetchGoDocument(signal, options = {}) {
     failures.push(...cached.failures);
   }
   const discover = options.discover ?? discoverDocumentPaths;
-  const discovered = await discover(signal);
-  if (discovered.length === 0) {
-    failures.push("the provider repository named no document");
+  if (options.discover === void 0 && !discoveryAllowed(options.cacheDir)) {
+    failures.push("the provider repository was not asked again; it was asked within the hour");
   } else {
-    const merged = rememberPaths(options.cacheDir, discovered);
-    const fresh = merged.filter((path5) => !GO_DOC_URLS.some((url) => url.endsWith(path5))).flatMap(mirrorsOf);
-    if (fresh.length === 0) {
-      failures.push("the provider repository named the path that was already tried");
+    if (options.discover === void 0) rememberAttempt(options.cacheDir);
+    const discovered = await discover(signal);
+    if (discovered.length === 0) {
+      failures.push("the provider repository named no document");
     } else {
-      const result = await readSources(fresh, signal, options.cacheDir);
-      if (result.document !== void 0) return result.document;
-      failures.push(...result.failures);
+      const merged = rememberPaths(options.cacheDir, discovered);
+      const fresh = merged.filter((path5) => !GO_DOC_URLS.some((url) => url.endsWith(path5))).flatMap(mirrorsOf);
+      if (fresh.length === 0) {
+        failures.push("the provider repository named the path that was already tried");
+      } else {
+        const result = await readSources(fresh, signal, options.cacheDir);
+        if (result.document !== void 0) return result.document;
+        failures.push(...result.failures);
+      }
     }
   }
   throw new LlmError3(
@@ -43285,6 +43317,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 +43382,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 +43476,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 +43708,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);
       });
@@ -43688,8 +43729,8 @@ function inferFamily(id) {
   return ["grok", "gpt", "muse"].some((family) => lower.startsWith(family)) ? "openai-responses" : "openai-completions";
 }
 async function discoverCatalogModels(catalog, signal) {
-  const snapshot2 = await catalog.snapshot(true, signal);
-  if (!snapshot2.live) {
+  const snapshot2 = await catalog.snapshot(false, signal);
+  if (snapshot2.listingFailure !== void 0) {
     const detail = snapshot2.listingFailure instanceof LlmError4 ? snapshot2.listingFailure.message : "the live model listing is unreachable";
     throw new LlmError4(`dshopencodego: ${detail}; refresh the model list to retry`, "DISCOVERY_FAILED", {
       cause: snapshot2.listingFailure
@@ -46198,7 +46239,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.55" : "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/go-doc-discovery.d.ts

@@ -24,6 +24,16 @@
  */
 /** A repository listing is large; the cap keeps a hostile response bounded. */
 export declare const DISCOVERY_MAX_BYTES: number;
+/**
+ * How long the repository listing waits before it is asked again.
+ *
+ * The listing is unauthenticated, and an unauthenticated GitHub API allows
+ * sixty requests an hour. The listing is also large — the provider's whole
+ * tree, thousands of entries. Asking it on every build would spend that
+ * budget on a provider that is merely unreachable, and would make every
+ * build slower for a question with the same answer.
+ */
+export declare const DISCOVERY_COOLDOWN_MS: number;
 /**
  * The repository paths a discovery run found.
  *
@@ -76,3 +86,21 @@ export declare function readCachedPaths(cacheDir: string | undefined): readonly
  * @returns the merged set, in the order it should be tried.
  */
 export declare function rememberPaths(cacheDir: string | undefined, discovered: readonly string[]): readonly string[];
+/**
+ * Whether the repository may be asked again.
+ *
+ * The question is worth at most an hour: a provider whose document has
+ * moved is found within the hour, and one that is merely down is not asked
+ * again every minute while it is down.
+ * @param cacheDir - the plugin's cache directory.
+ * @returns true when the repository may be asked.
+ */
+export declare function discoveryAllowed(cacheDir: string | undefined): boolean;
+/**
+ * Record that the repository was asked, whether or not it answered.
+ *
+ * The attempt is what the budget is spent on, so a question that came back
+ * empty counts as a question.
+ * @param cacheDir - the plugin's cache directory.
+ */
+export declare function rememberAttempt(cacheDir: string | undefined): void;

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.55",
   "description": "OpenCode Go provider for DeepSeek Harness: live gateway catalog, per-conversation session header, usage",
   "type": "module",
   "license": "MIT",