dsh-opencode-go 0.2.0 → 0.2.1

package/lib/types/config.d.ts

@@ -13,6 +13,10 @@ export declare const DEFAULT_REQUEST_PREPARATION_TIMEOUT_MS = 60000;
 export declare const DEFAULT_REQUEST_TIMEOUT_MS: number;
 /** Plain configuration values used by validation and direct adapter consumers. */
 export declare const PlainConfig: z<OpencodeGoConfig>;
+/** Derive defaults from the same schema used by persisted profile settings. */
+export declare const DEFAULT_CONFIG: Readonly<OpencodeGoConfig>;
+/** Fill omitted profile fields and normalize the legacy official gateway. */
+export declare function normalizeConfig(value?: Partial<OpencodeGoConfig>): OpencodeGoConfig;
 /** The Loader retains these references when profile fields change. */
 export type LiveConfig = {
     [K in keyof OpencodeGoConfig]-?: {
@@ -29,7 +33,7 @@ export declare function readConfig(config: LiveConfig): OpencodeGoConfig;
  * @param raw - the configured base URL.
  * @returns the current gateway base URL without trailing slashes.
  */
-export declare function assertBaseURL(raw: string): string;
+export declare function assertBaseURL(raw: string, field?: 'baseURL' | 'freeBaseURL'): string;
 /**
  * Reject a selected credential reference that is not a bare environment
  * variable name. The schema pattern above fails the composition layer and the

package/lib/types/contracts.d.ts

@@ -1,12 +1,20 @@
 /** Browser-safe configuration, account metadata and RPC wire contracts. */
 import type { RemoteResult, TypertRemoteContribution } from '@deepseek-ai/dsh-typert-protocol';
-import type { AnalyticsFailureReason, AnalyticsQuery, AnalyticsReport } from './analytics.ts';
 /** Public DSH route and the private SDK transport have separate identities. */
 export declare const PROVIDER_ID = "dsh-opencode-go";
 export declare const DISPLAY_NAME = "DSH OpenCode Go";
+export declare const FREE_PROVIDER_ID = "dsh-opencode-free";
+export declare const FREE_DISPLAY_NAME = "DSH OpenCode Free";
+export type ModelSource = 'go' | 'free';
+/** Go keeps its legacy keys; Free owns a separate settings namespace. */
+export declare function modelSettingsKey(model: {
+    id: string;
+    source?: ModelSource;
+}): string;
 export declare const SDK_PROVIDER_ID = "opencode-go";
 /** Public Go discovery/usage base; inference uses the documented protocol-specific siblings. */
 export declare const DEFAULT_BASE_URL = "https://opencode.ai/inference/go/v1";
+export declare const DEFAULT_FREE_BASE_URL = "https://opencode.ai/inference/v1";
 /**
  * Migrate the legacy official address before any request is constructed.
  */
@@ -17,6 +25,9 @@ export declare function assertProxyURL(raw: string | undefined): string;
 export declare const USAGE_DISPLAY_MODES: readonly ["auto", "always", "off"];
 export type UsageDisplayMode = typeof USAGE_DISPLAY_MODES[number];
 export declare const DEFAULT_USAGE_DISPLAY: UsageDisplayMode;
+export declare const USAGE_PILL_STYLES: readonly ["badge", "plain"];
+export type UsagePillStyle = typeof USAGE_PILL_STYLES[number];
+export declare const DEFAULT_USAGE_PILL_STYLE: UsagePillStyle;
 /** Client-safe account metadata. Secrets stay in the host credential service. */
 export type GoAccount = {
     id: string;
@@ -67,19 +78,19 @@ export type OpencodeGoModelLimits = Record<string, OpencodeGoModelLimit | null>;
 /** Runtime configuration for one plugin mount. */
 export interface OpencodeGoConfig {
     /**
-     * Whether this adapter serves its route at all. False withdraws the
-     * `dsh-opencode-go` route and its models from every picker without unloading the
-     * plugin, so the settings page that owns this switch stays reachable to turn
-     * it back on. Independent of the credential: a key present while this is
-     * false registers nothing.
+     * Whether this plugin serves Go and Free. False withdraws both routes and
+     * their models without unloading the settings page. Go additionally requires
+     * a usable configured key; Free supports public access.
      */
     enabled: boolean;
-    /** Usage pill visibility; auto follows this plugin's selected provider. */
+    /** Usage pill visibility; auto follows only the selected Go route. */
     usageDisplay: UsageDisplayMode;
+    /** Show quota in the sidebar independently of the selected conversation model. */
+    showSidebarQuota: boolean;
+    /** Appearance of the conversation input's quota trigger. */
+    usagePillStyle: UsagePillStyle;
     /** Per-model picker switches; absent entries default to enabled unless deprecated. */
     modelVisibility?: Record<string, boolean>;
-    /** Experimental opt-in routing; omitted/null entries follow the catalog. */
-    protocolOverrides?: GoProtocolOverrides;
     /** Legacy credential reference, kept in sync with the first/current account. */
     apiKeyEnv: string;
     /** The first account is current; subsequent accounts are tried in order. */
@@ -88,6 +99,8 @@ export interface OpencodeGoConfig {
     autoSwitch?: boolean;
     /** Discovery/usage base; the official Go gateway selects inference endpoints by protocol. */
     baseURL: string;
+    /** Platform discovery base; only explicitly free chat models are served. */
+    freeBaseURL: string;
     /** Optional HTTP(S) or SOCKS5 proxy; blank uses the default network transport. */
     proxyURL: string;
     /** Request/picker cache lifetime in minutes; explicit discovery bypasses it. */
@@ -111,13 +124,9 @@ export interface OpencodeGoConfig {
 }
 /** Settings snapshots may omit fields inherited from their base layer. */
 export type OpencodeGoSettings = Partial<OpencodeGoConfig>;
-/** The supported experimental override surface, shared with the settings UI. */
-export declare const RESPONSES_OVERRIDE_MODEL = "deepseek-v4.1-flash";
-export type GoProtocolOverrides = Partial<Record<typeof RESPONSES_OVERRIDE_MODEL, 'openai-responses' | null>>;
-/** Null selects catalog routing even when a lower settings layer overrides it. */
-export declare function assertProtocolOverrides(value: unknown): asserts value is GoProtocolOverrides | undefined;
 export interface GoModel {
     id: string;
+    source?: ModelSource;
     name?: string;
     contextWindow?: number;
     maxTokens?: number;
@@ -125,7 +134,7 @@ export interface GoModel {
     reasoningBudget?: ThinkingBudgetRange;
     deprecated?: boolean;
     releaseDate?: string;
-    /** Input modalities models.dev declares, in {@link INPUT_MODALITIES} order. */
+    /** Input modalities the gateway declares, in {@link INPUT_MODALITIES} order. */
     inputModalities?: readonly InputModality[];
     /** Advertised by the gateway but lacking a usable protocol and capability configuration. */
     configurationMissing?: boolean;
@@ -135,14 +144,13 @@ export interface ThinkingBudgetRange {
     max: number;
 }
 /**
- * Input modalities this page can name. models.dev uses these same five tokens, so
- * an unknown token is dropped rather than rendered as an untranslatable chip.
+ * Input modalities this page can name; MIME types are normalized to these tokens.
  */
 export declare const INPUT_MODALITIES: readonly ["text", "image", "audio", "video", "pdf"];
 export type InputModality = typeof INPUT_MODALITIES[number];
 /**
  * Normalize one `modalities.input` array into display order.
- * @param value - the raw declaration read from models.dev or from a Host response.
+ * @param value - the raw gateway declaration or Host response.
  * @returns the declared modalities in {@link INPUT_MODALITIES} order, or
  *   `undefined` when nothing recognizable was declared.
  */
@@ -160,12 +168,12 @@ export interface GoModelCatalog {
     readonly error?: string;
     /** Optional for clients reading an older Host response. Timestamps are Unix milliseconds. */
     readonly sources?: {
-        readonly listing: GoCatalogSourceStatus;
-        readonly metadata: GoCatalogSourceStatus;
+        readonly go: GoCatalogSourceStatus;
+        readonly free: GoCatalogSourceStatus;
     };
 }
 /** 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 isModelEnabled(model: Pick<GoModel, 'id' | 'source' | '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;
@@ -250,26 +258,73 @@ declare module '@deepseek-ai/dsh-typert-protocol' {
 }
 export declare const accountsRemote: TypertRemoteContribution;
 export type SettingsWriteResult = 'applied' | 'rejected' | 'unknown';
-export type { AnalyticsFailureReason, AnalyticsQuery, AnalyticsTotals, AnalyticsModelRow, AnalyticsDayRow, AnalyticsCoverage, AnalyticsPricing, AnalyticsReport } from './analytics.ts';
+export type AnalyticsRange = 'today' | '7d' | '30d' | '90d';
+export interface AnalyticsQuery {
+    accountRef: string;
+    range: AnalyticsRange;
+    refresh?: boolean;
+}
+/** Exact nonnegative integers on the wire; one USD is 100,000,000 micro cents. */
+export interface AnalyticsTotals {
+    requests: string;
+    inputTokens: string;
+    outputTokens: string;
+    cacheReadTokens: string;
+    cacheWrite5mTokens: string;
+    cacheWrite1hTokens: string;
+    cacheWriteTokens: string;
+    tokens: string;
+    costMicroCents: string;
+}
+export interface AnalyticsModelRow extends AnalyticsTotals {
+    provider: string;
+    model: string;
+}
+export interface AnalyticsDayRow extends AnalyticsTotals {
+    day: string;
+}
+export interface AnalyticsReport {
+    accountRef: string;
+    /** Opaque account, credential and network identity; contains no credential material. */
+    source: string;
+    generatedAt: number;
+    period: AnalyticsRange;
+    range: {
+        from: number;
+        to: number;
+    };
+    timeZone: 'UTC';
+    totals: AnalyticsTotals;
+    byModel: AnalyticsModelRow[];
+    byDay: AnalyticsDayRow[];
+}
+export interface AnalyticsExport {
+    filename: string;
+    csv: string;
+}
+export type AnalyticsFailureReason = 'invalid-query' | 'unknown-account' | 'missing-credential' | 'credential-unavailable' | 'unsupported-gateway' | 'invalid-proxy' | 'permission-denied' | 'upstream' | 'network' | 'timeout' | 'invalid-response';
 /**
- * Validate one query. Unknown fields are ignored so a newer client can add
- * optional knobs without breaking an older Host.
+ * Validate one account-scoped official history query.
  * @param value - raw RPC argument.
  * @returns the validated query.
  */
 export declare function parseAnalyticsQuery(value: unknown): AnalyticsQuery;
-/** Check the response envelope; the host constructs typed aggregate rows. */
+/** Keep the browser wire response limited to validated aggregate fields. */
 export declare function parseAnalyticsReport(value: unknown): AnalyticsReport;
+export declare function parseAnalyticsExport(value: unknown): AnalyticsExport;
 declare module '@deepseek-ai/dsh-typert-protocol' {
     interface RemoteErrorDetailsMap {
         'opencode-go/analytics-unavailable': {
             readonly reason: AnalyticsFailureReason;
             readonly retryable: boolean;
+            readonly retainPrevious?: boolean;
+            readonly source?: string;
         };
     }
     interface TypertRemoteNamespaceMap {
         opencodeGoAnalytics: {
             read(query: AnalyticsQuery, signal?: AbortSignal): Promise<RemoteResult<AnalyticsReport>>;
+            exportCsv(query: AnalyticsQuery, signal?: AbortSignal): Promise<RemoteResult<AnalyticsExport>>;
         };
     }
 }

package/lib/types/conversion.d.ts

@@ -31,7 +31,13 @@ export interface PiAiReplayResponse {
     /** Provider-native effort for historical replay; absence is preserved. */
     providerThinkingLevel?: string;
     stopReason: AssistantMessage['stopReason'];
+    /** Measured context footprint for the next turn's SDK output-token clamp. */
+    usage?: Pick<PiUsage, 'input' | 'output' | 'cacheRead' | 'cacheWrite' | 'totalTokens'>;
+    /** Fingerprint of the request prefix and this reply that the usage measured. */
+    usageContext?: string;
 }
+/** Capture one converted request before the SDK can mutate it while streaming. */
+export declare function piContextUsageKey(context: PiContext, provider: string, model: string): string;
 /**
  * Project a successful pi-ai response into the minimal durable replay state.
  * The per-block half is index-aligned with the streamed blocks (pi-ai content
@@ -40,9 +46,10 @@ export interface PiAiReplayResponse {
  * @param message - completed native pi-ai assistant response.
  * @param requestedModel - request identity stored in the assistant source; defaults to the native model.
  * @param requestedProvider - DSH route stored in the assistant source; defaults to the native provider.
+ * @param usageContext - fingerprint of the request that produced this response.
  * @returns the versioned lossless-JSON replay projection.
  */
-export declare function toPiReplayState(message: AssistantMessage, requestedModel?: string, requestedProvider?: string): ReplayEnvelope;
+export declare function toPiReplayState(message: AssistantMessage, requestedModel?: string, requestedProvider?: string, usageContext?: string): ReplayEnvelope;
 /**
  * Convert one durable Harness assistant message into pi-ai history.
  *
@@ -139,9 +146,10 @@ export declare function mapStopReason(message: AssistantMessage, contextWindow?:
  * @param requestedModel - request model identity recorded for durable replay.
  * @param requestedProvider - DSH provider identity recorded for durable replay.
  * @param reservedMaxTokens - requested output allowance before SDK context clamping.
+ * @param usageContext - fingerprint of the request whose usage may budget a later turn.
  * @returns the harness chunks, ending with measured `usage` then `finish`;
  *   failures with no measured tokens omit usage to preserve context pressure. Throws
  *   `LlmError` (`STREAM_CLOSED`) if the source ends without a terminal event.
  */
-export declare function toStreamChunks(events: AsyncIterable<AssistantMessageEvent>, contextWindow?: number, callerSignal?: AbortSignal, requestedModel?: string, requestedProvider?: string, reservedMaxTokens?: number): AsyncGenerator<StreamChunk>;
+export declare function toStreamChunks(events: AsyncIterable<AssistantMessageEvent>, contextWindow?: number, callerSignal?: AbortSignal, requestedModel?: string, requestedProvider?: string, reservedMaxTokens?: number, usageContext?: string): AsyncGenerator<StreamChunk>;
 export { DEFAULT_MAX_REQUEST_IMAGE_BYTES, DEFAULT_REQUEST_IMAGE_MAX_BYTES, DEFAULT_REQUEST_IMAGE_PIXEL_BUDGET, } from './contracts.ts';

package/lib/types/free-channel.d.ts

@@ -0,0 +1,21 @@
+import type { OpencodeGoConfig } from './contracts.ts';
+type Network = Pick<OpencodeGoConfig, 'freeBaseURL' | 'proxyURL'>;
+export interface FreeAttemptTicket {
+    key: string;
+    sequence: number;
+}
+export interface FreeAttemptResult {
+    outcome: 'success' | 'error' | 'aborted';
+    code?: string;
+    retryAt?: number;
+}
+export declare class FreeChannelState {
+    private readonly entries;
+    private sequence;
+    private key;
+    cooldownUntil(config: Network): number | undefined;
+    assertReady(config: Network): void;
+    begin(config: Network): FreeAttemptTicket;
+    finish(ticket: FreeAttemptTicket, result: FreeAttemptResult): void;
+}
+export {};

package/lib/types/free-http-worker.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/types/free-policy.d.ts

@@ -0,0 +1,4 @@
+/** Free-specific error semantics; Go account classification remains unchanged. */
+export declare function classifyFreeGatewayError(status: number, body: string): string | undefined;
+/** Parse delta-seconds or HTTP-date, accounting for a server clock when supplied. */
+export declare function retryAfterDeadline(value: string | null, now?: number, serverDate?: string | null): number | undefined;

package/lib/types/free-protocol.d.ts

@@ -0,0 +1,16 @@
+/** Private stdin/stdout protocol; request credentials never enter argv or files. */
+export interface FreeHttpRequest {
+    url: string;
+    method: string;
+    headers: [string, string][];
+    body?: string;
+    redirect: RequestRedirect;
+    proxy?: string;
+}
+export interface FreeHttpResponse {
+    status: number;
+    statusText: string;
+    headers: [string, string][];
+    url: string;
+    redirected: boolean;
+}

package/lib/types/free-runtime.d.ts

@@ -0,0 +1,2 @@
+export declare function resolveFreeRuntime(): string;
+export declare function freeWorkerPath(): string;

package/lib/types/free-socks-tunnel.d.ts

@@ -0,0 +1,4 @@
+export declare function openSocksTunnel(raw: string, signal: AbortSignal): Promise<{
+    url: string;
+    close(): Promise<void>;
+}>;

package/lib/types/free-transport.d.ts

@@ -0,0 +1,19 @@
+export declare const OPENCODE_FREE_USER_AGENT = "opencode/latest/2.2.5/cli";
+export declare class FreeBunTransport {
+    private readonly options;
+    private readonly shutdown;
+    private readonly workers;
+    private readonly requests;
+    private readonly waiters;
+    private active;
+    constructor(options?: {
+        executable?: () => string;
+        workerPath?: () => string;
+        maxConcurrent?: number;
+    });
+    forProxy(raw?: string): typeof globalThis.fetch;
+    private acquire;
+    private fetchRequest;
+    private response;
+    dispose(): Promise<void>;
+}

package/lib/types/index.d.ts

@@ -7,7 +7,7 @@ declare module '@deepseek-ai/cordis' {
 }
 export { OpencodeGoAdapter } from './adapter.ts';
 export type { OpencodeGoAdapterOptions, OpencodeGoImageAccess, GoAccountSettlement } from './adapter.ts';
-export { DEFAULT_BASE_URL, DISPLAY_NAME, PROVIDER_ID, OpencodeGoCatalog, discoverCatalogModels, readLiveModelIds, } from './catalog.ts';
+export { DEFAULT_BASE_URL, DEFAULT_FREE_BASE_URL, DISPLAY_NAME, PROVIDER_ID, FREE_DISPLAY_NAME, FREE_PROVIDER_ID, OpencodeGoCatalog, discoverCatalogModels, readLiveModelIds, } from './catalog.ts';
 export { Config, PlainConfig, assertBaseURL } from './config.ts';
 export { assertProxyURL } from './contracts.ts';
 export type { OpencodeGoConfig } from './config.ts';

package/lib/types/pricing.d.ts

@@ -0,0 +1,29 @@
+/** Strict gateway tariff validation for model discovery and Free eligibility. */
+import type { ModelCost } from './sdk-types.ts';
+type Comparison<T> = {
+    in?: T[];
+    eq?: T;
+    gt?: T;
+    gte?: T;
+    lt?: T;
+    lte?: T;
+};
+export interface PricingCondition {
+    all?: PricingCondition[];
+    any?: PricingCondition[];
+    utc_days?: Comparison<string>;
+    utc_hours?: Comparison<string>;
+    date?: Comparison<string>;
+}
+export interface PriceMultiplier {
+    when: PricingCondition;
+    factor: number;
+}
+export interface ParsedCost {
+    cost: ModelCost;
+    multipliers?: PriceMultiplier[];
+    free: boolean;
+}
+/** Missing base prices or malformed optional components invalidate the entire tariff. */
+export declare function readModelCost(value: unknown): ParsedCost | undefined;
+export {};