dsh-opencode-go 0.1.24 → 0.2.1

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

@@ -0,0 +1,178 @@
+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 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", "usagePillStyle", "showSidebarQuota", "baseURL", "freeBaseURL", "proxyURL", "refreshMinutes", "streamIdleTimeoutMs", "maxImages", "maxRequestImageBytes", "requestImagePixelBudget", "requestImageMaxBytes"];
+export type TextField = typeof TEXT_FIELDS[number];
+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;
+    invalid: boolean;
+}
+export interface FormActions {
+    edit(field: TextField, text: string): void;
+    editModelLimits(value: OpencodeGoModelLimits): void;
+    resetField(field: EditableField): void;
+    save(): void;
+    discard(): void;
+}
+interface FormShell {
+    available: boolean;
+    writable: boolean;
+    dirty: boolean;
+    invalid: boolean;
+    saving: boolean;
+    failed: boolean;
+}
+/** The gateway's model listing as the page reports it. */
+export type OpencodeGoModels = 
+/** Not asked for yet; the page asks once it mounts. */
+{
+    readonly status: 'idle';
+}
+/** A listing request is outstanding. */
+ | {
+    readonly status: 'loading';
+}
+/**
+ * The gateway answered: a count/preview for the compact summary plus every
+ * discovered entry used by the capacity editor.
+ */
+ | {
+    readonly status: 'ready';
+    readonly count: number;
+    readonly preview: readonly string[];
+    readonly entries: readonly GoModel[];
+    readonly stale?: boolean;
+    readonly message?: string;
+    readonly refreshing?: boolean;
+    readonly sources?: GoModelCatalog['sources'];
+}
+/** The listing could not be read; `message` is the Host's own diagnostic. */
+ | {
+    readonly status: 'failed';
+    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;
+    writable?: boolean;
+    usage?: GoUsage;
+    updatedAt?: number;
+    stale?: boolean;
+    loading?: boolean;
+    failed?: boolean;
+    /** Why the last quota read failed, safe to show: it carries no credential value. */
+    problem?: string;
+}
+export interface GoAccountsState {
+    entries: readonly GoAccountView[];
+    activeRef: string;
+    autoSwitch: boolean;
+    busy: boolean;
+    blocked: boolean;
+    refreshing: boolean;
+    failure?: 'write' | 'cleanup' | 'remove' | 'read';
+}
+export interface GoAccountsActions {
+    loadAccounts: () => void;
+    addAccount: (name: string, key: string) => Promise<boolean>;
+    /** A newly opened addition form owns a fresh ID; retries keep its existing ID. */
+    resetAddition?: () => void;
+    renameAccount: (ref: string, name: string) => Promise<boolean>;
+    removeAccount: (ref: string) => Promise<boolean>;
+    selectAccount: (ref: string) => Promise<boolean>;
+    setAutoSwitch: (next: boolean) => Promise<boolean>;
+    replaceAccountKey: (ref: string, key: string) => Promise<boolean>;
+    /** Move one account to a new position; the first row becomes the preferred account. */
+    moveAccount: (ref: string, toIndex: number) => Promise<boolean>;
+}
+export interface OpencodeGoSectionState extends FormShell {
+    accounts: GoAccountsState;
+    enabled: boolean;
+    usageDisplay: FieldState;
+    showSidebarQuota: FieldState;
+    usagePillStyle: FieldState;
+    modelVisibility: Readonly<Record<string, boolean>>;
+    pickerSaving: boolean;
+    pickerFailed: boolean;
+    baseURL: FieldState;
+    freeBaseURL: FieldState;
+    proxyURL: FieldState;
+    refreshMinutes: FieldState;
+    streamIdleTimeoutMs: FieldState;
+    maxImages: FieldState;
+    maxRequestImageBytes: FieldState;
+    requestImagePixelBudget: FieldState;
+    requestImageMaxBytes: FieldState;
+    models: OpencodeGoModels;
+    modelLimits: Omit<FieldState, 'text'>;
+    modelLimitDraft: OpencodeGoModelLimits;
+}
+export interface OpencodeGoSectionFace extends FormActions, GoAccountsActions {
+    hooks: {
+        opencodeGo: SnapshotStore<OpencodeGoSectionState>;
+    };
+    loadModels(): void;
+    setEnabled(next: boolean): void;
+    setModelEnabled(id: string, next: boolean): void;
+}
+/** One controller owns the page's typed drafts and immediate account operations. */
+export declare class OpencodeGoSectionController {
+    private readonly scope;
+    private readonly ctx;
+    private readonly readModels;
+    private readonly readUsage;
+    private readonly executeAccountCommand;
+    private readonly drafts;
+    private readonly store;
+    private readonly unsubscribe;
+    private saving;
+    private failed;
+    private pickerSaving;
+    private pickerFailed;
+    private models;
+    private modelsRequest;
+    private face;
+    private accountRows;
+    private accountBusy;
+    private accountRefreshing;
+    private accountFailure;
+    private accountEpoch;
+    private accountsIdentity;
+    private accountsLoaded;
+    private disposed;
+    private addition;
+    constructor(scope: ConfigForm<OpencodeGoSettings>, ctx: ClientContext, readModels?: () => Promise<RemoteResult<GoModelCatalog>>, readUsage?: (ref: string) => Promise<GoUsage>, executeAccountCommand?: ExecuteAccountCommand);
+    dispose(): void;
+    private publish;
+    private blocked;
+    private stored;
+    private value;
+    private field;
+    private plan;
+    private projection;
+    private edit;
+    save(): Promise<void>;
+    setEnabled(next: boolean): Promise<void>;
+    setModelEnabled(id: string, next: boolean): Promise<void>;
+    private writePickerSetting;
+    inject(): OpencodeGoSectionFace;
+    loadModels(): void;
+    accountState(): GoAccountsState;
+    syncAccounts(): void;
+    refreshCredential(ref: string): void;
+    refreshAccounts(): Promise<void>;
+    /** Mark every account row as unreadable with the Host's own diagnostic. */
+    private markUnreadable;
+    accountActions(): GoAccountsActions;
+    private runAccountAction;
+}

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

@@ -1,22 +1,26 @@
-/**
- * OpenCode Go settings plugin, browser half. Registers the "OpenCode Go"
- * settings page over the `llm-opencode-go` namespace: the API key (stored
- * write-only through the credentials domain), the gateway's current model
- * listing, and the adapter knobs behind the page's advanced disclosure. The
- * Host settings and credential contracts stay behind their existing wire APIs.
- */
-import type { Context as ClientContext } from '@deepseek-ai/cordis';
-import { en } from './locales.ts';
+import type { Context as ClientContext, Context } from '@deepseek-ai/cordis';
+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;
     }
 }
 export type { OpencodeGoSectionProps } from './Section.tsx';
-export type { OpencodeGoSectionState, OpencodeGoSettings } from './section-controller.ts';
-export { OPENCODE_GO_NS } from './section-controller.ts';
-export type { OpencodeGoKey } from './locales.ts';
+export type { OpencodeGoSectionState, OpencodeGoSettings } from './controller.ts';
+export { OPENCODE_GO_NS } from './controller.ts';
+export type { OpencodeGoKey } from './presentation.ts';
 /**
  * Required services (cordis fiber inject). The target slot is declared by
  * ui-settings' apply, whose activation order relative to this one is NOT
@@ -32,3 +36,5 @@ export declare const inject: string[];
  * @param ctx - client root context.
  */
 export declare function apply(ctx: ClientContext): void;
+export declare function accountCommands(ctx: Context): ExecuteAccountCommand;
+export declare function registerUsagePill(ctx: Context, settings: ConfigForm<OpencodeGoSettings>, selectAccount?: (ref: string) => Promise<boolean>): void;

package/lib/types/client/{locales.d.ts → presentation.d.ts}

@@ -1,3 +1,5 @@
+/** 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: {
     accountsTitle: string;
@@ -27,6 +29,8 @@ export declare const en: {
     accountSwitchBack: string;
     accountSwitchHint: string;
     accountSwitchFailed: string;
+    sidebarNextAccount: string;
+    sidebarAnalytics: string;
     accountFallbackQuota: string;
     accountFallbackCredential: string;
     accountsSummary: string;
@@ -58,7 +62,43 @@ export declare const en: {
     usageRefreshFailed: string;
     usageLastUpdated: string;
     usageRetry: string;
+    usageRefresh: string;
     usageRefreshing: string;
+    analyticsOpen: string;
+    analyticsTitle: string;
+    analyticsSubtitle: string;
+    analyticsClose: string;
+    analyticsRange: string;
+    analyticsRangeToday: string;
+    analyticsRange7d: string;
+    analyticsRange30d: string;
+    analyticsRange90d: string;
+    analyticsRefresh: string;
+    analyticsRetry: string;
+    analyticsLoading: string;
+    analyticsEmpty: string;
+    analyticsFailed: string;
+    analyticsRequests: string;
+    analyticsTokens: string;
+    analyticsSpend: string;
+    analyticsByModel: string;
+    analyticsByDay: string;
+    analyticsInput: string;
+    analyticsOutput: string;
+    analyticsCacheRead: string;
+    analyticsQuota: string;
+    analyticsQuotaHint: string;
+    analyticsQuotaFailed: string;
+    analyticsChartSpend: string;
+    analyticsChartTokens: string;
+    analyticsKicker: string;
+    analyticsModel: string;
+    analyticsCost: string;
+    analyticsShare: string;
+    analyticsCacheHit: string;
+    analyticsDailyAverage: string;
+    analyticsPeak: string;
+    analyticsTotal: string;
     nav: string;
     title: string;
     titleLabel: string;
@@ -75,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;
@@ -102,6 +145,7 @@ export declare const en: {
     thinkingBudgetAdd: string;
     thinkingBudgetRemove: string;
     capacityDefault: string;
+    capacityDefaultCapped: string;
     capacityMissing: string;
     modalityLabel: string;
     modalityText: string;
@@ -117,7 +161,6 @@ export declare const en: {
     configurationMissing: string;
     configurationMissingHint: string;
     configurationUnavailable: string;
-    configurationUnavailableHint: string;
     pickerFailed: string;
     deprecatedBadge: string;
     deprecatedHint: string;
@@ -138,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;
@@ -148,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;
@@ -183,3 +234,40 @@ 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;
+/** Warm paper/charcoal surfaces shared by every plugin-owned view. */
+export interface GoThemeTokens {
+    readonly bg: string;
+    readonly surface: string;
+    readonly surface2: string;
+    readonly border: string;
+    readonly text: string;
+    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;
+}
+/** 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 unified tokens for the Host's current scheme. */
+export declare function useGoThemeTokens(): GoThemeTokens;
+/**
+ * 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.
+ */
+export declare function themeStyle(tokens: GoThemeTokens): CSSProperties;

package/lib/types/config.d.ts

@@ -1,16 +1,8 @@
-/**
- * Configuration schema for the OpenCode Go adapter plugin. The section is
- * installed under the `llm-opencode-go` settings namespace on DSH 0.1.5/0.1.6.
- * DSH 0.1.7 edits the `opencode-go` profile entry through live references.
- * Both paths update field by field without a restart. Self-contained constraints
- * (URL shape, numeric bounds) fail at load for the composition layer and
- * refuse the write for the settings layer.
- *
- * @module dsh-llm-opencode-go/config
- */
+/** Live profile configuration, validation and settings presentation. */
 import z from '@deepseek-ai/schemastery';
-import type { OpencodeGoConfig } from './config-contract.ts';
-export type { OpencodeGoConfig, OpencodeGoModelLimit, OpencodeGoModelLimits } from './config-contract.ts';
+import { type OpencodeGoConfig } from './contracts.ts';
+import type { Context } from '@deepseek-ai/cordis';
+export type { OpencodeGoConfig, OpencodeGoModelLimit, OpencodeGoModelLimits } from './contracts.ts';
 /** Environment variable resolving the OpenCode API key. */
 export declare const DEFAULT_API_KEY_ENV = "OPENCODE_API_KEY";
 /** Successful refresh lifetime; failed refreshes retry sooner and explicit discovery revalidates immediately. */
@@ -19,9 +11,13 @@ export declare const DEFAULT_REFRESH_MINUTES = 60;
 export declare const DEFAULT_STREAM_IDLE_TIMEOUT_MS = 300000;
 export declare const DEFAULT_REQUEST_PREPARATION_TIMEOUT_MS = 60000;
 export declare const DEFAULT_REQUEST_TIMEOUT_MS: number;
-/** Plain values used by the adapter and by pre-0.1.7 settings documents. */
+/** Plain configuration values used by validation and direct adapter consumers. */
 export declare const PlainConfig: z<OpencodeGoConfig>;
-/** 0.1.7's Loader retains these references when profile fields change. */
+/** 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]-?: {
         get(): OpencodeGoConfig[K];
@@ -37,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
@@ -46,3 +42,6 @@ export declare function assertBaseURL(raw: string): string;
  * @param raw - the configured credential reference.
  */
 export declare function assertApiKeyEnv(raw: string): void;
+export declare function validateGoConfig(value: OpencodeGoConfig): void;
+/** DSH profile forms edit the plugin's live Config fields directly. */
+export declare function installHostSettings(ctx: Context): void;