dsh-opencode-go 0.2.0 → 0.2.1

package/lib/types/catalog.d.ts

@@ -1,6 +1,6 @@
 import { type LlmDiscoveredModel } from '@deepseek-ai/dsh-llm';
 import type { Api, Model, ModelThinkingLevel, ThinkingBudgets, ThinkingLevelMap, Provider } from './sdk-types.ts';
-import { type ThinkingBudgetRange, type GoModel, type OpencodeGoConfig, type GoModelCatalog } from './contracts.ts';
+import { type ThinkingBudgetRange, type GoModel, type OpencodeGoConfig, type ModelSource, type GoModelCatalog } from './contracts.ts';
 import { type ProxyTransport } from './transport.ts';
 import type { Context } from '@deepseek-ai/cordis';
 import { TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
@@ -11,8 +11,6 @@ export declare const NATIVE_THINKING_FLAGS: ReadonlySet<string>;
 export declare function supportsThinkingBudget(api: Api, compat: Model<Api>['compat']): boolean;
 export declare function reasoningBudgetRange(model: Model<Api>): ThinkingBudgetRange | undefined;
 export declare function unsupportedThinkingLevels(): ThinkingLevelMap;
-/** Exact model/protocol controls verified against OpenCode Go. */
-export declare function withGatewayReasoning(model: Model<Api>): Model<Api>;
 export declare function reasoningChoices(model: Model<Api>): readonly {
     id: string;
     name: string;
@@ -42,117 +40,78 @@ export declare function reasoningRequest(intent: ReasoningIntent): {
     thinkingBudgets?: ThinkingBudgets;
     onPayload: (payload: unknown) => unknown;
 };
-export declare const MODEL_METADATA_URL = "https://models.dev/api.json";
-/** Lifecycle and capability data the online catalog adds to a gateway listing. */
 export type ModelDetails = Pick<GoModel, 'deprecated' | 'releaseDate' | 'inputModalities'> & {
-    /**
-     * Present only when the upstream cost block is missing or carries a malformed
-     * component: its zeros are then indistinguishable from a genuinely free model,
-     * so analytics must treat the model as unpriced instead of pricing it at 0.
-     * A published block with legal components stays unmarked even when all zero.
-     */
     readonly costKnown?: false;
 };
-export interface ModelMetadata {
+export interface ModelDirectory {
     readonly models: ReadonlyMap<string, Model<Api>>;
     readonly details: ReadonlyMap<string, ModelDetails>;
     readonly errors: ReadonlyMap<string, string>;
+    readonly warning?: string;
 }
-/** Select documented official protocol endpoints while preserving custom gateway prefixes. */
-export declare function modelBaseURL(api: Api, baseURL: string): string;
-/** Shared Responses defaults for declared models and explicit protocol overrides. */
-export declare function responsesCompatibility(): NonNullable<Model<'openai-responses'>['compat']>;
-/**
- * Only read the opencode-go record. Online endpoints, headers and credentials
- * are deliberately ignored: protocol endpoints are selected on the configured gateway.
- * A bad entry is isolated instead of discarding every other model.
- */
-export declare function readModelMetadata(body: unknown, baseURL: string, builtin: ReadonlyMap<string, Model<Api>>): ModelMetadata;
-export declare const MODEL_METADATA_MAX_BYTES: number;
-export interface CachedMetadata {
+/** Official listings own their protocol endpoints; custom gateways keep their prefix. */
+export declare function modelBaseURL(api: Api, baseURL: string, declared?: unknown, source?: ModelSource): string;
+export declare function readLiveModelIds(body: unknown, onInvalidRows?: (warning: string) => void): readonly string[];
+export declare function readModelDirectory(body: unknown, baseURL: string, source?: ModelSource): ModelDirectory;
+export declare const MODEL_LISTING_MAX_BYTES: number;
+export interface CachedDirectory {
     readonly body: unknown;
     readonly etag?: string;
-    /** Last successful download or HTTP 304 verification. */
     readonly savedAtMs: number;
 }
-export declare function metadataCachePath(): string;
-/** Only persist validators that can safely become an HTTP request header. */
-export declare function metadataETag(value: unknown): string | undefined;
-export declare function readMetadataCache(path: string): Promise<CachedMetadata | undefined>;
-export declare function writeMetadataCache(path: string, value: CachedMetadata): Promise<boolean>;
-/** Resolve a request's wire model without mutating the shared metadata catalog. */
-export declare function withProtocolOverride(model: Model<Api>, config: OpencodeGoConfig): Model<Api>;
-export { PROVIDER_ID, DISPLAY_NAME } from './contracts.ts';
-export { DEFAULT_BASE_URL } from './contracts.ts';
+export declare function catalogCachePath(source?: ModelSource): string;
+export declare function catalogETag(value: unknown): string | undefined;
+export declare function readCatalogCache(path: string, sourceURL: string): Promise<CachedDirectory | undefined>;
+export declare function writeCatalogCache(path: string, sourceURL: string, value: CachedDirectory): Promise<boolean>;
+export { PROVIDER_ID, DISPLAY_NAME, FREE_PROVIDER_ID, FREE_DISPLAY_NAME, DEFAULT_BASE_URL, DEFAULT_FREE_BASE_URL } from './contracts.ts';
 export interface CatalogSnapshot {
-    readonly details: ModelMetadata['details'];
+    readonly source: ModelSource;
+    readonly details: ModelDirectory['details'];
     readonly models: ReadonlyMap<string, Model<Api>>;
-    /** Advertised ids with missing/unsupported metadata stay visible with a diagnostic. */
     readonly unavailable: ReadonlyMap<string, string>;
     readonly provider: Provider;
     readonly live: boolean;
-    readonly metadataLive: boolean;
-    /** Retained for explicit discovery; runtime callers may still use the last catalog. */
-    readonly listingFailure?: unknown;
-    readonly listingWarning?: string;
-    readonly metadataFailure?: unknown;
-    /** Last successful fetch or revalidation, not the time of a failed attempt. */
-    readonly listingUpdatedAtMs?: number;
-    readonly metadataUpdatedAtMs?: number;
+    readonly failure?: unknown;
+    readonly warning?: string;
+    readonly updatedAtMs?: number;
     readonly fetchedAtMs: number;
 }
-/** A valid empty listing means the gateway serves nothing; malformed replies are failures. */
-export declare function readLiveModelIds(body: unknown, onInvalidRows?: (warning: string) => void): readonly string[];
-/** Runtime requests reuse a snapshot; discovery revalidates it. Concurrent reads coalesce. */
+/** One gateway owns its membership, disk cache, validator, refresh and failure backoff. */
 export declare class OpencodeGoCatalog {
     private readonly baseURL;
     private readonly refreshMs;
     private readonly onFallback;
-    /** Kept for API compatibility; now reports unconfigured ids rather than hiding them. */
     private readonly onOmitted;
     private readonly onRefresh;
     private readonly fetcher?;
     private readonly onWarning?;
+    readonly source: ModelSource;
     private served;
     private pending;
-    /** A cold runtime read can use disk metadata while the shared online refresh runs. */
-    private cachedPending;
     private initialized;
-    private readonly cachePath;
-    private metadata;
-    private metadataBody;
-    private metadataETag;
-    private metadataUpdatedAtMs;
-    private failures;
+    private cached;
+    private startupCache;
     private refreshAtMs;
-    constructor(baseURL: string, refreshMs: number, onFallback: (detail: {
+    private failures;
+    private readonly url;
+    private readonly cachePath;
+    constructor(baseURL: string, refreshMs: number, onFallback?: (detail: {
         url: string;
         error: unknown;
         kept: number;
-    }) => void, 
-    /** Kept for API compatibility; now reports unconfigured ids rather than hiding them. */
-    onOmitted: (ids: readonly string[]) => void, onRefresh?: () => void, fetcher?: typeof globalThis.fetch | undefined, onWarning?: ((warning: string) => void) | undefined);
+    }) => void, onOmitted?: (ids: readonly string[]) => void, onRefresh?: () => void, fetcher?: typeof globalThis.fetch | undefined, onWarning?: ((warning: string) => void) | undefined, source?: ModelSource);
     snapshot(force?: boolean, signal?: AbortSignal): Promise<CatalogSnapshot>;
-    private restoreMetadata;
-    private readSnapshot;
-    private currentSnapshot;
-    private startRefresh;
-    /** Conditional HTTP requests save bandwidth while still checking for updated metadata. */
-    private refreshMetadata;
-    private persistMetadata;
-    /** Gateway ids decide membership; online metadata decides how to call each model. */
+    private empty;
     private build;
-    /** New or previously unconfigured ids get a fresh lookup even during the runtime TTL. */
+    private restore;
+    private refresh;
     forModel(id: string, signal?: AbortSignal): Promise<CatalogSnapshot>;
 }
-/** Explicit discovery always revalidates both sources, including during the runtime TTL. */
 export declare function discoverCatalogModels(catalog: OpencodeGoCatalog): Promise<readonly LlmDiscoveredModel[]>;
-/** Settings expose the same retained catalog as requests, with a failed-refresh diagnostic. */
-export declare function discoverSettingsModels(catalog: OpencodeGoCatalog): Promise<GoModelCatalog>;
-/** One mount owns discovery; inference, settings and pickers share its snapshots. */
+export declare function discoverSettingsModels(catalog: OpencodeGoCatalog, freeCatalog?: OpencodeGoCatalog): Promise<GoModelCatalog>;
 export declare class GoCatalogManager {
     private readonly options;
-    private current;
+    private readonly current;
     constructor(options: {
         transport: ProxyTransport;
         onFallback?: (detail: {
@@ -164,13 +123,13 @@ export declare class GoCatalogManager {
         onRefresh?: () => void;
         onWarning?: (warning: string) => void;
     });
-    forConfig(config: OpencodeGoConfig): OpencodeGoCatalog;
+    forConfig(config: OpencodeGoConfig, source?: ModelSource): OpencodeGoCatalog;
 }
-/** 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;
+        freeCatalog?: () => OpencodeGoCatalog;
         onRefresh?: () => void;
     });
     read(): Promise<GoModelCatalog>;

package/lib/types/client/AnalyticsDialog.d.ts

@@ -1,25 +1,18 @@
-import type { AnalyticsQuery, AnalyticsReport, GoUsage } from '../contracts.ts';
+import type { AnalyticsExport, AnalyticsQuery, AnalyticsReport, GoAccount, GoUsage } from '../contracts.ts';
 import { type en } from './presentation.ts';
-type AnalyticsKey = keyof typeof en;
+export declare function historyNumber(value: string, locale?: string, compact?: boolean): string;
+/** Keep micro-cents exact through rounding: one dollar is 100,000,000 units. */
+export declare function historyMoney(value: string, locale?: string): string;
 export interface AnalyticsDialogProps {
     open: boolean;
     onClose: () => void;
-    /** The signal reaches the Host's cancellation parameter (review M4). */
     readAnalytics: (query: AnalyticsQuery, signal?: AbortSignal) => Promise<AnalyticsReport>;
-    readQuota?: () => Promise<GoUsage>;
-    t: (key: AnalyticsKey) => string;
+    exportAnalytics?: (query: AnalyticsQuery, signal?: AbortSignal) => Promise<AnalyticsExport>;
+    readQuota?: (ref: string) => Promise<GoUsage>;
+    accounts: readonly GoAccount[];
+    activeRef: string;
+    contextKey?: string | number;
+    t: (key: keyof typeof en) => string;
     getLocale?: () => string;
 }
-/**
- * Shared usage dashboard, opened from the composer pill and the settings card.
- * It scans only when opened or when the range asks for it; closing the modal
- * aborts the request. The window end is frozen once per open, so repeated
- * requests inside one open share the Host's dedup key (review P5/S5), a range
- * already seen in this open renders instantly and revalidates in the
- * background (review P17), and while a scan runs the previous results stay
- * visible under the newly selected range with an explicit annotation
- * (review P19). Every number shown here comes from the same Host report as
- * before; only the presentation and the palette are new.
- */
-export declare function AnalyticsDialog({ open, onClose, readAnalytics, readQuota, t, getLocale }: AnalyticsDialogProps): import("react").JSX.Element;
-export {};
+export declare function AnalyticsDialog(props: AnalyticsDialogProps): import("react").JSX.Element;

package/lib/types/client/Section.d.ts

@@ -1,6 +1,6 @@
 import { type en } from './presentation.ts';
-import { type ReactNode } from 'react';
 import type { GoAccountsActions, GoAccountsState, OpencodeGoModelLimit, OpencodeGoModelLimits, OpencodeGoModels, OpencodeGoSectionFace } from './controller.ts';
+import { type ModelSource } from '../contracts.ts';
 import type { InjectFace } from '@deepseek-ai/dsh-client-ui-slots';
 export declare function HintMark(props: {
     hint: string;
@@ -9,15 +9,6 @@ export declare function HintText(props: {
     id: string;
     hint: string;
 }): import("react").JSX.Element;
-/**
- * The one place a style is chosen: four previews, each a miniature of the
- * surface it selects, on the Settings page. The picker lives here rather than in
- * the pill or the dashboard so a working session never changes its own look.
- * @param props.t - copy lookup.
- */
-export declare function ThemePicker({ t }: {
-    t: (key: keyof typeof en) => string;
-}): import("react").JSX.Element;
 type AccountTranslate = (key: keyof typeof en, params?: Record<string, unknown>) => string;
 /**
  * The account card: a folded header that summarizes the set, and one row per
@@ -37,7 +28,8 @@ export declare function AccountsCard({ state, actions, writable, t, locale }: {
 type ModelTranslate = (key: keyof typeof en, params?: Record<string, unknown>) => string;
 export declare function hasCapacityOverride(limit: OpencodeGoModelLimit | null | undefined): boolean;
 /** Per-model switches apply immediately; capacity edits stay in the staged form. */
-export declare function ModelEditor({ models, draft, modelVisibility, t, locale, disabled, visibilitySaving, filterAction, onEdit, onModelEnabled }: {
+export declare function ModelEditor({ source, models, draft, modelVisibility, t, locale, disabled, visibilitySaving, onEdit, onModelEnabled }: {
+    source?: ModelSource;
     models: OpencodeGoModels;
     draft: OpencodeGoModelLimits;
     modelVisibility: Readonly<Record<string, boolean>>;
@@ -45,8 +37,6 @@ export declare function ModelEditor({ models, draft, modelVisibility, t, locale,
     locale?: string;
     disabled: boolean;
     visibilitySaving: boolean;
-    /** Optional control pinned to the right of the filter row, such as a refresh. */
-    filterAction?: ReactNode;
     onEdit: (next: OpencodeGoModelLimits) => void;
     onModelEnabled: (id: string, enabled: boolean) => void;
 }): import("react").JSX.Element;

package/lib/types/client/UsagePill.d.ts

@@ -1,18 +1,25 @@
 import type { SnapshotStore } from '@deepseek-ai/dsh-client-store';
 import type { ModelDirectoryState } from '@deepseek-ai/dsh-client-ui-model-selection/client';
-import { type GoUsage, type AnalyticsQuery, type AnalyticsReport } from '../contracts.ts';
+import { type GoUsage, type AnalyticsQuery, type AnalyticsReport, type AnalyticsExport } from '../contracts.ts';
 import type { ConfigForm } from '@deepseek-ai/dsh-client-ui-settings/client';
 import type { OpencodeGoSettings } from './controller.ts';
 export interface UsagePillProps {
     directory: SnapshotStore<ModelDirectoryState>;
     settings: ConfigForm<OpencodeGoSettings>;
     readUsage: () => Promise<GoUsage>;
+    readAccountUsage?: (ref: string) => Promise<GoUsage>;
     /** Optional so an embedded/test render can omit the dashboard. */
     readAnalytics?: (query: AnalyticsQuery, signal?: AbortSignal) => Promise<AnalyticsReport>;
+    exportAnalytics?: (query: AnalyticsQuery, signal?: AbortSignal) => Promise<AnalyticsExport>;
     t: (key: string) => string;
     getLocale?: () => string;
     credentialChanges?: SnapshotStore<number>;
     selectAccount?: (ref: string) => Promise<boolean>;
 }
-/** Only a visible, enabled pill mounts the usage poller. */
-export declare function UsagePill({ directory, settings, credentialChanges, ...props }: UsagePillProps): import("react").JSX.Element | null;
+/** A root sidebar entry receives its width mode from the host slot owner. */
+export type SidebarQuotaProps = Omit<UsagePillProps, 'directory'> & {
+    wide: boolean;
+};
+/** Only a visible, enabled input indicator mounts the usage poller. */
+export declare function UsagePill({ directory, ...props }: UsagePillProps): import("react").JSX.Element;
+export declare function SidebarQuota({ wide, ...props }: SidebarQuotaProps): import("react").JSX.Element;

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

@@ -2,12 +2,13 @@ import type { Context as ClientContext } from '@deepseek-ai/cordis';
 import type { RemoteResult } from '@deepseek-ai/dsh-typert-protocol';
 import { type SnapshotStore } from '@deepseek-ai/dsh-client-store';
 import type { ConfigForm } from '@deepseek-ai/dsh-client-ui-settings/client';
-import { type OpencodeGoSettings, type OpencodeGoModelLimits, type GoAccount, type GoModel, type GoModelCatalog, type GoUsage, type AnalyticsQuery, type AnalyticsReport, type AccountCommand, type SettingsWriteResult } from '../contracts.ts';
+import { type ModelSource, type OpencodeGoSettings, type OpencodeGoModelLimits, type GoAccount, type GoModel, type GoModelCatalog, type GoUsage, type AccountCommand, type SettingsWriteResult } from '../contracts.ts';
 export type { OpencodeGoSettings, OpencodeGoModelLimit, OpencodeGoModelLimits } from '../contracts.ts';
 export declare const OPENCODE_GO_NS = "llm-opencode-go";
-export declare const TEXT_FIELDS: readonly ["usageDisplay", "protocolOverrides", "baseURL", "proxyURL", "refreshMinutes", "streamIdleTimeoutMs", "maxImages", "maxRequestImageBytes", "requestImagePixelBudget", "requestImageMaxBytes"];
+export declare const TEXT_FIELDS: readonly ["usageDisplay", "usagePillStyle", "showSidebarQuota", "baseURL", "freeBaseURL", "proxyURL", "refreshMinutes", "streamIdleTimeoutMs", "maxImages", "maxRequestImageBytes", "requestImagePixelBudget", "requestImageMaxBytes"];
 export type TextField = typeof TEXT_FIELDS[number];
-export type EditableField = TextField | 'modelLimits';
+export declare const editableKeys: readonly ["usageDisplay", "usagePillStyle", "showSidebarQuota", "baseURL", "freeBaseURL", "proxyURL", "refreshMinutes", "streamIdleTimeoutMs", "maxImages", "maxRequestImageBytes", "requestImagePixelBudget", "requestImageMaxBytes", "modelLimits"];
+export type EditableField = typeof editableKeys[number];
 export interface FieldState {
     text: string;
     overridden: boolean;
@@ -58,6 +59,8 @@ export type OpencodeGoModels =
     readonly message?: string;
     readonly sources?: GoModelCatalog['sources'];
 };
+/** A failure on one source must not hide the other source's usable models. */
+export declare function modelsForSource(models: OpencodeGoModels, source: ModelSource): OpencodeGoModels;
 export type ExecuteAccountCommand = (command: AccountCommand) => Promise<SettingsWriteResult>;
 export interface GoAccountView extends GoAccount {
     configured?: boolean;
@@ -96,11 +99,13 @@ export interface OpencodeGoSectionState extends FormShell {
     accounts: GoAccountsState;
     enabled: boolean;
     usageDisplay: FieldState;
-    protocolOverrides: FieldState;
+    showSidebarQuota: FieldState;
+    usagePillStyle: FieldState;
     modelVisibility: Readonly<Record<string, boolean>>;
     pickerSaving: boolean;
     pickerFailed: boolean;
     baseURL: FieldState;
+    freeBaseURL: FieldState;
     proxyURL: FieldState;
     refreshMinutes: FieldState;
     streamIdleTimeoutMs: FieldState;
@@ -117,8 +122,6 @@ export interface OpencodeGoSectionFace extends FormActions, GoAccountsActions {
         opencodeGo: SnapshotStore<OpencodeGoSectionState>;
     };
     loadModels(): void;
-    readAnalytics(query: AnalyticsQuery, signal?: AbortSignal): Promise<AnalyticsReport>;
-    readQuota(ref: string): Promise<GoUsage>;
     setEnabled(next: boolean): void;
     setModelEnabled(id: string, next: boolean): void;
 }
@@ -129,7 +132,6 @@ export declare class OpencodeGoSectionController {
     private readonly readModels;
     private readonly readUsage;
     private readonly executeAccountCommand;
-    private readonly readAnalytics;
     private readonly drafts;
     private readonly store;
     private readonly unsubscribe;
@@ -149,7 +151,7 @@ export declare class OpencodeGoSectionController {
     private accountsLoaded;
     private disposed;
     private addition;
-    constructor(scope: ConfigForm<OpencodeGoSettings>, ctx: ClientContext, readModels?: () => Promise<RemoteResult<GoModelCatalog>>, readUsage?: (ref: string) => Promise<GoUsage>, executeAccountCommand?: ExecuteAccountCommand, readAnalytics?: (query: AnalyticsQuery, signal?: AbortSignal) => Promise<AnalyticsReport>);
+    constructor(scope: ConfigForm<OpencodeGoSettings>, ctx: ClientContext, readModels?: () => Promise<RemoteResult<GoModelCatalog>>, readUsage?: (ref: string) => Promise<GoUsage>, executeAccountCommand?: ExecuteAccountCommand);
     dispose(): void;
     private publish;
     private blocked;

package/lib/types/client/dashboard-copy.d.ts

@@ -0,0 +1,58 @@
+/** Copy local to workspace history, following the active host locale. */
+export declare const historyEn: {
+    readonly account: "Viewing account";
+    readonly noAccounts: "Add an account to view workspace history.";
+    readonly scope: "All workspace clients · UTC calendar days";
+    readonly requests: "Requests";
+    readonly tokens: "Tokens";
+    readonly amount: "Usage amount";
+    readonly cacheHit: "Cache hit rate";
+    readonly input: "Input";
+    readonly output: "Output";
+    readonly cacheRead: "Cache read";
+    readonly cacheWrite: "Cache write";
+    readonly dailyAverage: "Daily average";
+    readonly models: "models";
+    readonly activeDays: "active days";
+    readonly trend: "Daily activity";
+    readonly trendHint: "Select a day to inspect its usage.";
+    readonly tokensMode: "Token breakdown";
+    readonly requestsMode: "Request count";
+    readonly chartHelp: "Arrow keys move between days. Click or tap to pin a day; Escape clears it.";
+    readonly selectDay: "Hover, focus or tap a bar for daily details.";
+    readonly ranking: "Model distribution";
+    readonly rankingHint: "Compare models across this workspace.";
+    readonly details: "Model details";
+    readonly model: "Model";
+    readonly share: "Token share";
+    readonly allModels: "Show all models";
+    readonly fewerModels: "Show fewer models";
+    readonly export: "Export CSV";
+    readonly exporting: "Exporting…";
+    readonly exportFailed: "Could not export this range. Please retry.";
+    readonly refresh: "Refresh history";
+    readonly refreshed: "Updated";
+    readonly refreshing: "Refreshing official history…";
+    readonly stale: "Refresh failed. Showing the last successful result for this account and range.";
+    readonly loading: "Loading official workspace history…";
+    readonly empty: "No recorded usage in this range.";
+    readonly failed: "Could not load workspace history.";
+    readonly retry: "Try again";
+    readonly permission: "This key cannot read history. Check its Usage read permission in OpenCode Console.";
+    readonly credentials: "The selected account has no usable key. Update it in account settings.";
+    readonly unsupported: "History is available for the official OpenCode gateway. This account uses another gateway.";
+    readonly pending: "OpenCode is still preparing daily summaries. Please try again shortly.";
+    readonly invalid: "OpenCode returned an unreadable history response. Please retry.";
+    readonly quota: "Current allowance";
+    readonly quotaUnavailable: "Allowance unavailable";
+    readonly rolling: "5 hours";
+    readonly weekly: "Weekly";
+    readonly monthly: "Monthly";
+    readonly resets: "Resets";
+    readonly amountHint: "Official usage amount is not a receipt or an extra charge for Go.";
+    readonly lagHint: "Daily summaries may lag recent requests. Anonymous Free usage may not appear.";
+    readonly exportHint: "CSV includes member and service-account fields supplied by Console.";
+};
+export type HistoryCopy = Record<keyof typeof historyEn, string>;
+export declare const historyZh: HistoryCopy;
+export declare function historyCopy(locale?: string): HistoryCopy;

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

@@ -3,6 +3,15 @@ import type { ConfigForm } from '@deepseek-ai/dsh-client-ui-settings/client';
 import { type OpencodeGoSettings, type ExecuteAccountCommand } from './controller.ts';
 import { en } from './presentation.ts';
 declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface SlotMap {
+        'sidebar.footer.action': {
+            kind: 'list';
+            scope: 'root';
+            owner: {
+                wide: boolean;
+            };
+        };
+    }
     interface LocaleNamespaceMap {
         /** The OpenCode Go settings page copy. */
         'settings.opencode-go': keyof typeof en;

package/lib/types/client/presentation.d.ts

@@ -1,4 +1,4 @@
-/** English and Chinese copy, palette tokens and local theme preferences. */
+/** English and Chinese copy and the shared, Host-following presentation tokens. */
 import { type CSSProperties } from 'react';
 /** Copy dictionaries for the OpenCode Go settings page. English is the key-set source of truth. */
 export declare const en: {
@@ -29,6 +29,8 @@ export declare const en: {
     accountSwitchBack: string;
     accountSwitchHint: string;
     accountSwitchFailed: string;
+    sidebarNextAccount: string;
+    sidebarAnalytics: string;
     accountFallbackQuota: string;
     accountFallbackCredential: string;
     accountsSummary: string;
@@ -60,6 +62,7 @@ export declare const en: {
     usageRefreshFailed: string;
     usageLastUpdated: string;
     usageRetry: string;
+    usageRefresh: string;
     usageRefreshing: string;
     analyticsOpen: string;
     analyticsTitle: string;
@@ -74,51 +77,21 @@ export declare const en: {
     analyticsRetry: string;
     analyticsLoading: string;
     analyticsEmpty: string;
-    analyticsUnsupported: string;
     analyticsFailed: string;
     analyticsRequests: string;
     analyticsTokens: string;
     analyticsSpend: string;
-    analyticsCoverage: string;
-    analyticsSessions: string;
-    analyticsSeconds: string;
-    analyticsSummaries: string;
-    analyticsUnsettled: string;
     analyticsByModel: string;
     analyticsByDay: string;
     analyticsInput: string;
     analyticsOutput: string;
     analyticsCacheRead: string;
-    analyticsPriced: string;
-    analyticsUnpriced: string;
-    analyticsMissing: string;
-    analyticsFailedSessions: string;
-    analyticsUnattributed: string;
-    analyticsUnread: string;
-    analyticsScanSegments: string;
-    analyticsStaleResults: string;
-    analyticsTruncated: string;
-    analyticsScanMore: string;
-    analyticsPriceSource: string;
-    analyticsNotInvoice: string;
-    analyticsPricingUnavailable: string;
-    analyticsLegacy: string;
-    analyticsCardTitle: string;
-    analyticsCardHint: string;
-    analyticsBoardLabel: string;
-    analyticsOpenBoard: string;
     analyticsQuota: string;
     analyticsQuotaHint: string;
     analyticsQuotaFailed: string;
     analyticsChartSpend: string;
     analyticsChartTokens: string;
     analyticsKicker: string;
-    analyticsLead: string;
-    analyticsLeadTop: string;
-    analyticsComposition: string;
-    analyticsCompositionHint: string;
-    analyticsCompositionOther: string;
-    analyticsCompositionFree: string;
     analyticsModel: string;
     analyticsCost: string;
     analyticsShare: string;
@@ -126,12 +99,6 @@ export declare const en: {
     analyticsDailyAverage: string;
     analyticsPeak: string;
     analyticsTotal: string;
-    themeLabel: string;
-    themeSilentBlack: string;
-    themeGraphite: string;
-    themeSeaSalt: string;
-    themeWarmSand: string;
-    themeHint: string;
     nav: string;
     title: string;
     titleLabel: string;
@@ -148,18 +115,21 @@ export declare const en: {
     keyMissing: string;
     keyNotWritable: string;
     modelsLabel: string;
+    modelSourcesLabel: string;
+    modelsGoTab: string;
+    modelsFreeTab: string;
+    modelsGoSource: string;
+    modelsFreeSource: string;
     modelsRefresh: string;
     modelsLoading: string;
     modelsFailed: string;
     modelsStale: string;
-    modelsMetadataFailed: string;
-    modelsListingSource: string;
-    modelsMetadataSource: string;
     modelsSourceFailed: string;
     modelsSourceCurrent: string;
     modelsSourceNeverFetched: string;
     modelsSourceUpdated: string;
     modelsRefreshing: string;
+    modelsRefreshingShort: string;
     modelsEmpty: string;
     limitsLabel: string;
     limitsHint: string;
@@ -175,6 +145,7 @@ export declare const en: {
     thinkingBudgetAdd: string;
     thinkingBudgetRemove: string;
     capacityDefault: string;
+    capacityDefaultCapped: string;
     capacityMissing: string;
     modalityLabel: string;
     modalityText: string;
@@ -190,7 +161,6 @@ export declare const en: {
     configurationMissing: string;
     configurationMissingHint: string;
     configurationUnavailable: string;
-    configurationUnavailableHint: string;
     pickerFailed: string;
     deprecatedBadge: string;
     deprecatedHint: string;
@@ -211,7 +181,17 @@ export declare const en: {
     limitsOutputLabel: string;
     advancedResetAll: string;
     advancedLabel: string;
-    groupUsageProtocol: string;
+    groupUsage: string;
+    usageAppearanceLabel: string;
+    usageAppearanceReset: string;
+    showSidebarQuotaLabel: string;
+    showSidebarQuotaSummary: string;
+    showSidebarQuotaHint: string;
+    usagePillStyleLabel: string;
+    usagePillStyleHint: string;
+    usagePillStylePreviewHint: string;
+    usagePillStyle_badge: string;
+    usagePillStyle_plain: string;
     groupConnection: string;
     groupCacheTimeouts: string;
     groupImages: string;
@@ -221,10 +201,8 @@ export declare const en: {
     usageDisplay_auto: string;
     usageDisplay_always: string;
     usageDisplay_off: string;
-    protocolOverridesLabel: string;
-    protocolOverridesHint: string;
-    protocolOverridesAuto: string;
-    protocolOverridesResponses: string;
+    freeBaseURLLabel: string;
+    freeBaseURLHint: string;
     baseURLLabel: string;
     baseURLHint: string;
     proxyURLLabel: string;
@@ -256,7 +234,7 @@ export declare const en: {
 export declare const zh: typeof en;
 /** Every copy key this page's dictionaries must supply. */
 export type OpencodeGoKey = keyof typeof en;
-/** One palette's six theme colors plus the neutral surface steps. */
+/** Warm paper/charcoal surfaces shared by every plugin-owned view. */
 export interface GoThemeTokens {
     readonly bg: string;
     readonly surface: string;
@@ -266,43 +244,29 @@ export interface GoThemeTokens {
     readonly muted: string;
     readonly accent: string;
     readonly accent2: string;
+    readonly accentSoft: string;
+    readonly onAccent: string;
+    readonly cacheRead: string;
+    readonly cacheWrite: string;
+    readonly shadow: string;
     readonly success: string;
     readonly warning: string;
     readonly danger: string;
 }
-/** The four selectable styles. */
-export declare const GO_THEMES: readonly ["silent-black", "graphite", "sea-salt", "warm-sand"];
-export type GoThemeId = typeof GO_THEMES[number];
-/** Graphite is the default: it is the quietest match for the Host chrome. */
-export declare const DEFAULT_GO_THEME: GoThemeId;
-/** Locale key carrying each theme's display name. */
-export declare const GO_THEME_LABELS: Record<GoThemeId, keyof typeof en>;
-/** Each style in both Host color schemes. */
-export declare const GO_THEME_TOKENS: Record<GoThemeId, {
-    dark: GoThemeTokens;
-    light: GoThemeTokens;
-}>;
-/** The selected style, stable until the next write. */
-export declare function getGoTheme(): GoThemeId;
-/**
- * Select a style and persist it for this browser.
- * @param id - one of {@link GO_THEMES}; unknown ids are ignored.
- */
-export declare function setGoTheme(id: GoThemeId): void;
-/** Subscribe to style changes (for useSyncExternalStore). */
-export declare function subscribeGoTheme(listener: () => void): () => void;
-/** Read the selected style in a component. */
-export declare function useGoTheme(): GoThemeId;
+/** One visual language in the Host's two color schemes; no separate preference. */
+export declare const GO_THEME_TOKENS: Record<'dark' | 'light', GoThemeTokens>;
 /**
  * Follow the Host's light/dark scheme. The layout presenter marks a dark body
  * with `data-ds-dark-theme`; the attribute is observed so switching the Host
  * theme updates the surfaces without a reload.
  */
 export declare function useHostScheme(): 'dark' | 'light';
-/** The active style's tokens for the Host's current scheme. */
+/** The unified tokens for the Host's current scheme. */
 export declare function useGoThemeTokens(): GoThemeTokens;
 /**
- * Inline custom properties consumed by the pill and dialog styles.
+ * Inline custom properties consumed by settings, quota surfaces and history.
+ * Prefer installed Anthropic families; system fallbacks keep other machines
+ * offline-capable without distributing the user's local font files.
  * @param tokens - the active palette.
  * @returns a style object carrying every `--go-*` variable.
  */