@dan-ai-studio/dshopencodego 0.1.50 → 0.1.51

package/README.en.md

@@ -247,7 +247,7 @@ npm test            # contract tests against a real local HTTP mock gateway
 
 **Order matters**: `npm run build` must come before `npm test` — `tests/pack-contents.spec.ts` walks every `exports` target, and whether `lib/` exists decides whether that check runs or is silently skipped (it does not fail, it just stops protecting you). `package.json` no longer carries `prepare`, so `npm ci` will not build for you; all three CI workflows run `npm run build` explicitly.
 
-The suite covers configuration validation, the protocol ladder, gateway and online metadata, the catalog projection, the adapter on the wire (all three protocols), Remote contracts and services, session-header invariants, usage windows and the meter, the client controller and usage pill, both halves' mounting and registration, the error mapping for stream idle timeouts and aborts, the exit-code contract of the verification scripts, and several **structural invariants** (inject declarations match the source's reads, peer coverage holds both ways, the READMEs match the manifest, and the READMEs' claims about the upstream match the upstream actually installed). That is **48 test files** — a number `tests/readme-consistency.spec.ts` checks against the `tests/` directory, so it cannot drift.
+The suite covers configuration validation, the protocol ladder, gateway and online metadata, the catalog projection, the adapter on the wire (all three protocols), Remote contracts and services, session-header invariants, usage windows and the meter, the client controller and usage pill, both halves' mounting and registration, the error mapping for stream idle timeouts and aborts, the exit-code contract of the verification scripts, and several **structural invariants** (inject declarations match the source's reads, peer coverage holds both ways, the READMEs match the manifest, and the READMEs' claims about the upstream match the upstream actually installed). That is **50 test files** — a number `tests/readme-consistency.spec.ts` checks against the `tests/` directory, so it cannot drift.
 
 ## Releasing (maintainers)
 

package/README.md

@@ -247,7 +247,7 @@ npm test            # 契约测试：真实 HTTP mock 网关，断言请求头/
 
 **顺序有讲究**：`npm run build` 要排在 `npm test` 之前——`tests/pack-contents.spec.ts` 会遍历 `exports` 的每个目标，`lib/` 存在与否决定这条检查是执行还是被跳过（不报错，但会少一层保护）。`package.json` 已移除 `prepare`，因此 `npm ci` 不会再替你隐式构建；三个 CI workflow 都显式跑了 `npm run build`。
 
-测试覆盖配置校验、协议阶梯、网关与在线元数据、目录投影、适配器（三种协议的线上请求）、Remote 契约与服务、会话头不变量、用量窗口与计量、客户端控制器与用量组件、两半的挂载与登记、流空闲超时与中止的错误映射、验证脚本的退出码契约、以及几条**结构性不变量**（inject 声明与源码读取一致、peer 覆盖双向、README 与 manifest 一致、README 对上游的断言与实装的上游一致）。共 **48 个测试文件**——这个数字由 `tests/readme-consistency.spec.ts` 对着 `tests/` 目录校验，不会漂移。
+测试覆盖配置校验、协议阶梯、网关与在线元数据、目录投影、适配器（三种协议的线上请求）、Remote 契约与服务、会话头不变量、用量窗口与计量、客户端控制器与用量组件、两半的挂载与登记、流空闲超时与中止的错误映射、验证脚本的退出码契约、以及几条**结构性不变量**（inject 声明与源码读取一致、peer 覆盖双向、README 与 manifest 一致、README 对上游的断言与实装的上游一致）。共 **50 个测试文件**——这个数字由 `tests/readme-consistency.spec.ts` 对着 `tests/` 目录校验，不会漂移。
 
 ## 发布（维护者）
 

package/lib/index.js

@@ -43071,19 +43071,24 @@ function readFactsCache(cacheDir) {
       facts.set(id, fact);
     }
     if (facts.size === 0) return void 0;
-    return { facts, updatedAt: typeof parsed.updatedAt === "number" ? parsed.updatedAt : 0 };
+    return {
+      facts,
+      updatedAt: typeof parsed.updatedAt === "number" ? parsed.updatedAt : 0,
+      etag: typeof parsed.etag === "string" ? parsed.etag : void 0
+    };
   } catch {
     return void 0;
   }
 }
-function writeFactsCache(cacheDir, facts) {
+function writeFactsCache(cacheDir, facts, etag) {
   if (cacheDir === void 0 || facts.size === 0) return;
   try {
     mkdirSync2(cacheDir, { recursive: true });
     const file = {
       version: CACHE_VERSION2,
       facts: Object.fromEntries(facts),
-      updatedAt: Date.now()
+      updatedAt: Date.now(),
+      ...etag === void 0 ? {} : { etag }
     };
     writeFileSync2(join3(cacheDir, CACHE_FILE2), `${JSON.stringify(file)}
 `, "utf8");
@@ -43159,6 +43164,7 @@ var OpencodeGoCatalog = class {
     if (cached !== void 0) {
       this.cachedMetadata = { models: cached.facts, errors: /* @__PURE__ */ new Map() };
       this.cachedAt = cached.updatedAt;
+      this.metadataETag = cached.etag;
     }
   }
   /**
@@ -43382,29 +43388,40 @@ var OpencodeGoCatalog = class {
    * same document that a shell reads in half a second can take long enough
    * to outrun a budget set for kilobyte-sized documents.
    * @param builtin - the installed catalog, for the parse.
+   * @param conditional - whether to ask whether the document changed. A
+   *   conditional request the registry answers with `304` costs a round
+   *   trip and no body, which is the difference between a new session that
+   *   starts immediately and one that waits for megabytes.
    * @returns the parsed metadata.
    */
-  async readMetadataDocument(builtin) {
+  async readMetadataDocument(builtin, conditional = true) {
     const response = await fetch(MODEL_METADATA_URL, {
       redirect: "error",
       headers: {
         ...attributionHeaders3(),
         accept: "application/json",
         "cache-control": "no-cache",
-        ...this.metadataETag === void 0 ? {} : { "if-none-match": this.metadataETag }
+        ...conditional && this.metadataETag !== void 0 ? { "if-none-match": this.metadataETag } : {}
       },
       signal: AbortSignal.timeout(MODEL_METADATA_TIMEOUT_MS)
     });
-    if (response.status === 304 && this.metadataDocument !== void 0) {
+    if (response.status === 304) {
       await response.body?.cancel().catch(() => {
       });
-      const parsed2 = readOnlineMetadata(this.metadataDocument, {
-        builtin,
-        defaults: this.options.defaults,
-        overrides: this.options.overrides
-      });
-      this.lastMetadata = parsed2;
-      return parsed2;
+      if (this.metadataDocument !== void 0) {
+        const parsed2 = readOnlineMetadata(this.metadataDocument, {
+          builtin,
+          defaults: this.options.defaults,
+          overrides: this.options.overrides
+        });
+        this.lastMetadata = parsed2;
+        return parsed2;
+      }
+      if (this.cachedMetadata !== void 0) {
+        this.lastMetadata = this.cachedMetadata;
+        return this.cachedMetadata;
+      }
+      return this.readMetadataDocument(builtin, false);
     }
     if (!response.ok) {
       await response.body?.cancel().catch(() => {
@@ -43420,7 +43437,7 @@ var OpencodeGoCatalog = class {
       overrides: this.options.overrides
     });
     this.lastMetadata = parsed;
-    writeFactsCache(this.options.cacheDir, parsed.models);
+    writeFactsCache(this.options.cacheDir, parsed.models, this.metadataETag);
     return parsed;
   }
   /**
@@ -45964,7 +45981,7 @@ function createUpdateChecker(deps) {
 }
 
 // src/update/version.ts
-var PLUGIN_VERSION = true ? "0.1.50" : "0.0.0-dev";
+var PLUGIN_VERSION = true ? "0.1.51" : "0.0.0-dev";
 
 // src/update/service.ts
 import { TypertRemoteService as TypertRemoteService2 } from "@deepseek-ai/dsh-typert-protocol";
@@ -46167,6 +46184,11 @@ function apply(ctx, raw) {
     }
   });
   ctx.plugin(OpencodeGoUpdateService, { currentVersion: PLUGIN_VERSION });
+  ctx.effect(() => {
+    void adapter.catalogOf(current()).snapshot().catch(() => void 0);
+    return () => {
+    };
+  }, "dshopencodego: catalog warm-up");
   let registration;
   let visibilityFacts = JSON.stringify(current().modelVisibility);
   const applyRoute = (credentialConfigured) => {

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

@@ -221,6 +221,10 @@ export declare class OpencodeGoCatalog {
      * same document that a shell reads in half a second can take long enough
      * to outrun a budget set for kilobyte-sized documents.
      * @param builtin - the installed catalog, for the parse.
+     * @param conditional - whether to ask whether the document changed. A
+     *   conditional request the registry answers with `304` costs a round
+     *   trip and no body, which is the difference between a new session that
+     *   starts immediately and one that waits for megabytes.
      * @returns the parsed metadata.
      */
     private readMetadataDocument;

package/lib/types/catalog/metadata-cache.d.ts

@@ -24,11 +24,13 @@ import type { ModelFacts } from './metadata.ts';
  * fall back on and says so, rather than pretending the models have no
  * capabilities.
  * @param cacheDir - the plugin's cache directory.
- * @returns the remembered facts and when they were written, or undefined.
+ * @returns the remembered facts, the document's ETag, and when they were
+ *   written, or undefined.
  */
 export declare function readFactsCache(cacheDir: string | undefined): {
     readonly facts: ReadonlyMap<string, ModelFacts>;
     readonly updatedAt: number;
+    readonly etag: string | undefined;
 } | undefined;
 /**
  * Remember the facts a successful read produced.
@@ -37,5 +39,7 @@ export declare function readFactsCache(cacheDir: string | undefined): {
  * next restart, and nothing else: the run continues with what it has.
  * @param cacheDir - the plugin's cache directory.
  * @param facts - the parsed facts to remember.
+ * @param etag - the document's ETag, so the next process can ask whether the
+ *   document changed instead of downloading it again.
  */
-export declare function writeFactsCache(cacheDir: string | undefined, facts: ReadonlyMap<string, ModelFacts>): void;
+export declare function writeFactsCache(cacheDir: string | undefined, facts: ReadonlyMap<string, ModelFacts>, etag?: string): void;

package/package.json

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