dsh-opencode-go 0.1.10 → 0.1.12

package/lib/types/config.d.ts

@@ -11,7 +11,7 @@
 import z from '@deepseek-ai/schemastery';
 /** Environment variable resolving the OpenCode API key. */
 export declare const DEFAULT_API_KEY_ENV = "OPENCODE_API_KEY";
-/** Runtime request cache lifetime; model listing/discovery always revalidates immediately. */
+/** Requests and pickers share this cache lifetime; explicit discovery revalidates immediately. */
 export declare const DEFAULT_REFRESH_MINUTES = 60;
 /** Default maximum idle interval while a stream read is outstanding. */
 export declare const DEFAULT_STREAM_IDLE_TIMEOUT_MS = 300000;
@@ -38,13 +38,13 @@ export interface OpencodeGoConfig {
      * false registers nothing.
      */
     enabled: boolean;
-    /** Include models marked deprecated by models.dev in conversation pickers. */
-    showDeprecatedModels: boolean;
+    /** Per-model picker switches; absent entries default to enabled unless deprecated. */
+    modelVisibility?: Record<string, boolean>;
     /** Credential reference: the environment variable the key resolves from. */
     apiKeyEnv: string;
     /** The gateway endpoint; also the base of the live model listing. */
     baseURL: string;
-    /** Runtime request cache lifetime in minutes; explicit catalog reads bypass it. */
+    /** Request/picker cache lifetime in minutes; explicit discovery bypasses it. */
     refreshMinutes: number;
     /** Largest idle gap between stream events before the request fails. */
     streamIdleTimeoutMs: number;
@@ -61,7 +61,7 @@ export interface OpencodeGoConfig {
 export declare const PlainConfig: z<OpencodeGoConfig>;
 /** 0.1.7's Loader retains these references when profile fields change. */
 export type LiveConfig = {
-    [K in keyof OpencodeGoConfig]: {
+    [K in keyof OpencodeGoConfig]-?: {
         get(): OpencodeGoConfig[K];
     };
 };

package/lib/types/json-response.d.ts

@@ -1,2 +1,11 @@
-/** The limit applies both to bytes delivered by fetch and to any fallback decoder's output. */
+/** Describe transport failures without echoing credentials or upstream response text. */
+export declare function transportFailure(error: unknown): string;
+/** Keep the endpoint useful in diagnostics without user information or query secrets. */
+export declare function diagnosticURL(raw: string): string;
+/** The caller's signal covers both attempts, the retry delay, and all response reads. */
+export declare function fetchJsonResponse(url: string, init: RequestInit, maxBytes: number): Promise<{
+    response: Response;
+    body: unknown;
+}>;
+/** Fetch handles HTTP decoding; this reader bounds the bytes it delivers. */
 export declare function readJsonResponse(response: Response, maxBytes: number): Promise<unknown>;

package/lib/types/models-contract.d.ts

@@ -7,16 +7,27 @@ export interface GoModel {
     maxTokens?: number;
     deprecated?: boolean;
     releaseDate?: string;
+    /** Advertised by the gateway but lacking a usable protocol and capability configuration. */
+    configurationMissing?: boolean;
 }
+/** A failed refresh retains the Host's last successful listing with an explicit diagnostic. */
+export interface GoModelCatalog {
+    readonly models: readonly GoModel[];
+    readonly stale: boolean;
+    readonly error?: string;
+}
+/** Missing configuration cannot be enabled; configured models follow explicit switches or lifecycle defaults. */
+export declare function isModelEnabled(model: Pick<GoModel, 'id' | 'deprecated' | 'configurationMissing'>, modelVisibility?: Readonly<Record<string, boolean>>): boolean;
 export declare function validReleaseDate(value: unknown): value is string;
 /** Calendar dates are supplied without a timezone; compare UTC dates consistently. */
 export declare function isNewModel(model: GoModel, now?: number): boolean;
 export declare function sortModels(models: readonly GoModel[], now?: number): GoModel[];
 export declare function parseGoModels(value: unknown): GoModel[];
+export declare function parseGoModelCatalog(value: unknown): GoModelCatalog;
 declare module '@deepseek-ai/dsh-typert-protocol' {
     interface TypertRemoteNamespaceMap {
         opencodeGoModels: {
-            read(): Promise<RemoteResult<readonly GoModel[]>>;
+            read(): Promise<RemoteResult<GoModelCatalog>>;
         };
     }
 }

package/lib/types/models.d.ts

@@ -1,12 +1,13 @@
 import type { Context } from '@deepseek-ai/cordis';
 import { TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
 import { type OpencodeGoCatalog } from './catalog.ts';
-import type { GoModel } from './models-contract.ts';
+import type { GoModelCatalog } from './models-contract.ts';
 /** Uses the same gateway snapshot as the adapter, including models hidden from pickers. */
 export declare class GoModelsService extends TypertRemoteService {
     private readonly options;
     constructor(ctx: Context, options: {
         catalog: () => OpencodeGoCatalog;
+        onRefresh?: () => void;
     });
-    read(): Promise<readonly GoModel[]>;
+    read(): Promise<GoModelCatalog>;
 }

package/lib/types/usage-contract.d.ts

@@ -5,6 +5,8 @@ export interface UsageWindow {
     resetsAt: string;
 }
 export interface GoUsage {
+    /** Opaque Host identity for this endpoint/account; never a credential or its hash. */
+    source?: string;
     rolling: UsageWindow;
     weekly: UsageWindow;
     monthly: UsageWindow;
@@ -12,6 +14,13 @@ export interface GoUsage {
 /** Reject missing statistics rather than turning unavailable data into zero. */
 export declare function parseGoUsage(value: unknown): GoUsage;
 declare module '@deepseek-ai/dsh-typert-protocol' {
+    interface RemoteErrorDetailsMap {
+        'opencode-go/usage-unavailable': {
+            readonly retryable: boolean;
+            readonly retainPrevious: boolean;
+            readonly source?: string;
+        };
+    }
     interface TypertRemoteNamespaceMap {
         opencodeGoUsage: {
             read(): Promise<RemoteResult<GoUsage>>;

package/lib/types/usage.d.ts

@@ -8,6 +8,7 @@ interface UsageOptions {
 /** Account statistics are fetched on the Host; credentials never enter the browser. */
 export declare class GoUsageService extends TypertRemoteService {
     private readonly options;
+    private identity?;
     constructor(ctx: Context, options: UsageOptions);
     read(): Promise<GoUsage>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-opencode-go",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "OpenCode Go model provider and settings UI for DeepSeek Harness",
   "type": "module",
   "license": "MIT",
@@ -14,7 +14,7 @@
   },
   "engines": {
     "node": "^22.19.0 || >=24.0.0",
-    "dsh": ">=0.1.5-rc.1 <0.1.6-0 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2"
+    "dsh": ">=0.1.5-rc.1 <0.1.6-0 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2 || 0.1.7-rc.1 || 0.1.7-rc.2"
   },
   "main": "./lib/index.js",
   "types": "./lib/types/index.d.ts",
@@ -61,25 +61,25 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "4.0.2 || 4.0.3 || 4.0.4",
-    "@deepseek-ai/dsh-api-gateway": ">=0.1.5-rc.1 <0.1.6 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2",
-    "@deepseek-ai/dsh-api-remotes": ">=0.1.5-rc.1 <0.1.6 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2",
-    "@deepseek-ai/dsh-api-settings-controller": ">=0.1.5-rc.1 <0.1.6 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2",
-    "@deepseek-ai/dsh-attachment": ">=0.1.5-rc.1 <0.1.6 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-locale": ">=0.1.5-rc.1 <0.1.6 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-store": ">=0.1.5-rc.1 <0.1.6 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-conversation": ">=0.1.5-rc.1 <0.1.6 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-model-selection": ">=0.1.5-rc.1 <0.1.6 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-renderer": ">=0.1.5-rc.1 <0.1.6 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-settings": ">=0.1.5-rc.1 <0.1.6 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-slots": ">=0.1.5-rc.1 <0.1.6 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2",
-    "@deepseek-ai/dsh-credentials": ">=0.1.5-rc.1 <0.1.6 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2",
-    "@deepseek-ai/dsh-fs": ">=0.1.5-rc.1 <0.1.6 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2",
-    "@deepseek-ai/dsh-launch-environment": ">=0.1.5-rc.1 <0.1.6 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2",
-    "@deepseek-ai/dsh-llm": ">=0.1.5-rc.1 <0.1.6 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2",
-    "@deepseek-ai/dsh-settings": ">=0.1.5-rc.1 <0.1.6 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2",
-    "@deepseek-ai/dsh-timeout": ">=0.1.5-rc.1 <0.1.6 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2",
-    "@deepseek-ai/dsh-typert-protocol": ">=0.1.5-rc.1 <0.1.6 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2",
-    "@deepseek-ai/dsh-typert-registry": ">=0.1.5-rc.1 <0.1.6 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2"
+    "@deepseek-ai/dsh-api-gateway": ">=0.1.5-rc.1 <0.1.6 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2 || 0.1.7-rc.1 || 0.1.7-rc.2",
+    "@deepseek-ai/dsh-api-remotes": ">=0.1.5-rc.1 <0.1.6 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2 || 0.1.7-rc.1 || 0.1.7-rc.2",
+    "@deepseek-ai/dsh-api-settings-controller": ">=0.1.5-rc.1 <0.1.6 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2 || 0.1.7-rc.1 || 0.1.7-rc.2",
+    "@deepseek-ai/dsh-attachment": ">=0.1.5-rc.1 <0.1.6 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2 || 0.1.7-rc.1 || 0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-locale": ">=0.1.5-rc.1 <0.1.6 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2 || 0.1.7-rc.1 || 0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-store": ">=0.1.5-rc.1 <0.1.6 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2 || 0.1.7-rc.1 || 0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-conversation": ">=0.1.5-rc.1 <0.1.6 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2 || 0.1.7-rc.1 || 0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-model-selection": ">=0.1.5-rc.1 <0.1.6 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2 || 0.1.7-rc.1 || 0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-renderer": ">=0.1.5-rc.1 <0.1.6 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2 || 0.1.7-rc.1 || 0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings": ">=0.1.5-rc.1 <0.1.6 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2 || 0.1.7-rc.1 || 0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": ">=0.1.5-rc.1 <0.1.6 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2 || 0.1.7-rc.1 || 0.1.7-rc.2",
+    "@deepseek-ai/dsh-credentials": ">=0.1.5-rc.1 <0.1.6 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2 || 0.1.7-rc.1 || 0.1.7-rc.2",
+    "@deepseek-ai/dsh-fs": ">=0.1.5-rc.1 <0.1.6 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2 || 0.1.7-rc.1 || 0.1.7-rc.2",
+    "@deepseek-ai/dsh-launch-environment": ">=0.1.5-rc.1 <0.1.6 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2 || 0.1.7-rc.1 || 0.1.7-rc.2",
+    "@deepseek-ai/dsh-llm": ">=0.1.5-rc.1 <0.1.6 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2 || 0.1.7-rc.1 || 0.1.7-rc.2",
+    "@deepseek-ai/dsh-settings": ">=0.1.5-rc.1 <0.1.6 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2 || 0.1.7-rc.1 || 0.1.7-rc.2",
+    "@deepseek-ai/dsh-timeout": ">=0.1.5-rc.1 <0.1.6 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2 || 0.1.7-rc.1 || 0.1.7-rc.2",
+    "@deepseek-ai/dsh-typert-protocol": ">=0.1.5-rc.1 <0.1.6 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2 || 0.1.7-rc.1 || 0.1.7-rc.2",
+    "@deepseek-ai/dsh-typert-registry": ">=0.1.5-rc.1 <0.1.6 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2 || 0.1.7-rc.1 || 0.1.7-rc.2"
   },
   "dependencies": {
     "@deepseek-ai/dsh-brand": "0.1.6-alpha.1",