dsh-opencode-go 0.1.10 → 0.1.11

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.11",
   "description": "OpenCode Go model provider and settings UI for DeepSeek Harness",
   "type": "module",
   "license": "MIT",