dsh-opencode-go 0.1.9 → 0.1.11

package/lib/types/client/section-controller.d.ts

@@ -10,7 +10,7 @@
  */
 import type { Context as ClientContext } from '@deepseek-ai/cordis';
 import type { RemoteResult } from '@deepseek-ai/dsh-typert-protocol';
-import type { GoModel } from '../models-contract.ts';
+import type { GoModel, GoModelCatalog } from '../models-contract.ts';
 import type { SnapshotStore } from '@deepseek-ai/dsh-client-store';
 import type { SettingsScope } from './settings.ts';
 import { type FieldState, type FormActions, type FormShell } from './staged-form.ts';
@@ -20,8 +20,8 @@ export declare const OPENCODE_GO_NS = "llm-opencode-go";
 export interface OpencodeGoSettings {
     /** Whether the adapter serves its route; false withdraws it from every picker. */
     enabled?: boolean;
-    /** Include gateway-served deprecated models in conversation pickers. */
-    showDeprecatedModels?: boolean;
+    /** Per-model switches; normal models default on, deprecated models default off. */
+    modelVisibility?: Record<string, boolean>;
     /** Credential reference naming the environment key. */
     apiKeyEnv?: string;
     /** The gateway endpoint; also the live listing base. */
@@ -64,11 +64,14 @@ export type OpencodeGoModels =
     readonly count: number;
     readonly preview: readonly string[];
     readonly entries: readonly GoModel[];
+    readonly stale?: boolean;
+    readonly message?: string;
+    readonly refreshing?: boolean;
 }
 /** The listing could not be read; `message` is the Host's own diagnostic. */
  | {
     readonly status: 'failed';
-    readonly message: string;
+    readonly message?: string;
 };
 /** What the settings page renders. */
 export interface OpencodeGoSectionState extends FormShell {
@@ -78,7 +81,7 @@ export interface OpencodeGoSectionState extends FormShell {
      * a withdrawn route is what the user is trying to observe.
      */
     enabled: boolean;
-    showDeprecatedModels: boolean;
+    modelVisibility: Readonly<Record<string, boolean>>;
     pickerSaving: boolean;
     pickerFailed: boolean;
     /** Credential reference naming the environment key. */
@@ -121,7 +124,7 @@ export interface OpencodeGoSectionFace extends FormActions {
      * @param next - the state the switch asks for.
      */
     setEnabled: (next: boolean) => void;
-    setShowDeprecatedModels: (next: boolean) => void;
+    setModelEnabled: (id: string, next: boolean) => void;
 }
 /** Bridges the `llm-opencode-go` scope and the credentials domain onto the page. */
 export declare class OpencodeGoSectionController {
@@ -142,7 +145,7 @@ export declare class OpencodeGoSectionController {
      * @param ctx - the page plugin's context, whose `remote.credentials` namespace
      *   answers for the credential the section references.
      */
-    constructor(scope: SettingsScope<OpencodeGoSettings>, ctx: ClientContext, readModels?: () => Promise<RemoteResult<readonly GoModel[]>>);
+    constructor(scope: SettingsScope<OpencodeGoSettings>, ctx: ClientContext, readModels?: () => Promise<RemoteResult<GoModelCatalog>>);
     /** Release subscriptions without disposing the host's shared form. */
     dispose(): void;
     private projection;
@@ -161,7 +164,7 @@ export declare class OpencodeGoSectionController {
     /**
      * Flip the switch by writing the field on the click itself.
      *
-     * This is the one control on the page that does not wait for Save: the point
+     * Like the per-model switches, this control does not wait for Save: the point
      * of turning it off is to watch the models leave the pickers, and the point
      * of turning it back on is to use the route again — staging either behind a
      * second gesture would report a state the Host does not hold. The write is
@@ -169,9 +172,11 @@ export declare class OpencodeGoSectionController {
      * failed save through the shared shell rather than a silent revert.
      * @param next - the state the switch asks for.
      */
-    setEnabled(next: boolean): void;
-    /** Visibility is immediate; failed writes leave the committed switch state visible. */
-    setShowDeprecatedModels(next: boolean): Promise<void>;
+    setEnabled(next: boolean): Promise<void>;
+    /** Each model switch has one committed value and takes effect without Save. */
+    setModelEnabled(id: string, next: boolean): Promise<void>;
+    /** Serialize immediate switches with form saves; refused writes retain committed values. */
+    private writePickerSetting;
     /**
      * Read the gateway's model listing through the Host's discovery for this
      * adapter. Called when the page mounts and again from its refresh control.

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

@@ -0,0 +1,11 @@
+/** 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.9",
+  "version": "0.1.11",
   "description": "OpenCode Go model provider and settings UI for DeepSeek Harness",
   "type": "module",
   "license": "MIT",