@eddyskywalker/dsh-chatgpt-subscription 0.5.0 → 0.6.5

package/lib/types/shared/workbuddy-contracts.d.ts

@@ -0,0 +1,210 @@
+/**
+ * Wire contracts between the WorkBuddy host routes and the browser settings
+ * card. Everything here is public: no credential ever crosses this boundary.
+ */
+import type { AccountPoolStatusDto, PoolAccountSummaryDto } from './account-pool-contracts.ts';
+/**
+ * Which deployment region an account belongs to.
+ *
+ * The two regions are separate backends serving overlapping-but-different model
+ * catalogs, and a model asked of the wrong region answers 400 `code 11102`
+ * ("service info not found") rather than failing over. The region is therefore
+ * a property of the credential, not of the request.
+ */
+export type WorkBuddyRegion = 'cn' | 'intl';
+/**
+ * Reasoning levels this route can name.
+ *
+ * Deliberately the widest set any model declares, so a saved default is not
+ * discarded merely because the model that suggested it is no longer selected.
+ * The settings card renders the subset the account's models actually declare.
+ */
+export type WorkBuddyReasoningEffort = 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max';
+/** Every level this route can name, in escalating order (the card's sort key). */
+export declare const WORKBUDDY_REASONING_EFFORTS: readonly WorkBuddyReasoningEffort[];
+/**
+ * Ladder of a WorkBuddy model that leaves the level choice to the gateway.
+ *
+ * `/v3/config` publishes a model's ladder in two shapes: an explicit
+ * `supportedEfforts` list, or a lone `{ effort }` field that names only the
+ * DEFAULT. Conflating them was a real bug — the lone field first became a
+ * one-entry ladder, which rejected an explicit `low`; widening it to every
+ * level this route can name then advertised `minimal`/`xhigh` on a model that
+ * has three. Measured against the live gateway, such a model accepts exactly
+ * `low`/`high`/`max` — the same three `glm-5.3-flash` and
+ * `kimi-k2.8-preview` declare explicitly — and every other value is routed
+ * into the nearest of them rather than honoured as a level of its own.
+ */
+export declare const WORKBUDDY_STANDARD_EFFORTS: readonly WorkBuddyReasoningEffort[];
+/**
+ * Snap a level onto the nearest rung a model's ladder actually exposes.
+ *
+ * The gateway names a default from a wider vocabulary than the ladder it
+ * publishes for the same model: an effort-only entry (minimax-m3, kimi-k3,
+ * `glm-5.3` in the cn region) reports `effort: 'medium'` while exposing only
+ * `low`/`high`/`max`. Letting that value through is not cosmetic — a default
+ * outside the ladder is discarded by the level-resolution step, the request
+ * then carries no `reasoning_effort`, and the model returns an EMPTY
+ * `reasoning_content` (measured on minimax-m3: 0 characters across three
+ * samples, versus 282-659 with the field). Ties resolve upward, which is the
+ * mapping the sibling Kimi line documents for `medium`. A ladder that names
+ * no level (a text-only model) yields nothing to converge to.
+ */
+export declare function convergeWorkBuddyEffort(effort: string, ladder: readonly string[]): WorkBuddyReasoningEffort | null;
+/** One model offered by the WorkBuddy subscription. */
+export interface WorkBuddyModelOption {
+    id: string;
+    name: string;
+    /** Enabled models are the ones DSH offers in the conversation model picker. */
+    enabled: boolean;
+    /** Context window this route assumes when the caller saves no override. */
+    defaultContextWindow: number;
+    /** Effective context window: the override when one is saved, else the default. */
+    contextWindow: number;
+    /** Maximum output tokens this route requests when a caller omits one. */
+    defaultMaxTokens: number;
+    /** Reasoning levels this route exposes; absent for non-reasoning models. */
+    reasoningEfforts?: string[];
+    /** Whether the model accepts image input on this route. */
+    supportsImage: boolean;
+    /** Regions that serve this model; the account's own region must be listed. */
+    regions: WorkBuddyRegion[];
+    /** One-line description shown beside the model in the settings card. */
+    description?: string;
+}
+/** One credit allowance reported by the billing service. */
+export interface WorkBuddyMeter {
+    id: string;
+    label: string;
+    /** Used fraction in [0, 1] when the service reports a bounded allowance. */
+    usedFraction: number | null;
+    /** Remaining fraction in [0, 1], when the service reports one. */
+    remainingFraction: number | null;
+    used: string | null;
+    limit: string | null;
+    /** Unix milliseconds the meter resets, when reported. */
+    resetsAt: number | null;
+    description: string | null;
+}
+/** Account identity read from the local CodeBuddy credential file. */
+export interface WorkBuddyAccount {
+    /** Stable, non-secret selection key derived from region + account identity. */
+    id: string;
+    uid: string | null;
+    nickname: string | null;
+    /** Tencent UIN, masked by the card rather than sent in full. */
+    uin: string | null;
+    /** Account kind the client reports, e.g. `personal`. */
+    accountType: string | null;
+    /** Enterprise/tenant id when the account is an enterprise one. */
+    enterpriseId: string | null;
+    region: WorkBuddyRegion;
+    /** Backend base URL this account's region resolves to. */
+    backend: string;
+    /** Auth domain recorded in the credential, e.g. `copilot.tencent.com`. */
+    domain: string;
+    /** Unix milliseconds the access token expires. */
+    expiresAt: number | null;
+    /** File the credential was read from; null for plugin-managed accounts. */
+    sourceFile: string | null;
+    /** Desktop credentials are external; managed credentials belong to this plugin. */
+    source: 'desktop' | 'managed';
+    /** Managed credentials may be deleted; desktop credentials may only be hidden. */
+    removable: boolean;
+    /** Hidden desktop accounts do not participate in automatic selection. */
+    hidden: boolean;
+}
+/** One WorkBuddy account as the shared pool card renders it. Never carries a token. */
+export interface WorkBuddyAccountSummaryDto extends PoolAccountSummaryDto {
+    region: WorkBuddyRegion;
+    /** Which store owns the credential; only managed accounts may be deleted. */
+    source: 'desktop' | 'managed';
+    /** Whether the card may offer Delete for this account. */
+    removable: boolean;
+    nickname?: string;
+    /** Tencent UIN, masked by the card rather than shown in full. */
+    uin?: string;
+    /** IDE file a desktop account was adopted from. */
+    sourceFile?: string;
+    /** Auth domain recorded in the credential, e.g. `copilot.tencent.com`. */
+    domain?: string;
+    /** Backend base URL the account's region resolves to. */
+    backend?: string;
+    /** Account kind the client reports, e.g. `personal`. */
+    accountType?: string;
+    /**
+     * Whether the plugin currently routes to this account.
+     *
+     * Distinct from the pool's `activeAccountId`: a hidden account keeps its
+     * place in the pool but is not offered for routing while hidden.
+     */
+    hidden?: boolean;
+}
+/** One point-in-time quota snapshot for the signed-in WorkBuddy account. */
+export interface WorkBuddyAccountQuota {
+    account: WorkBuddyAccount;
+    /** Package name the billing service reports, e.g. `Free Plan Subscription`. */
+    packageName: string | null;
+    /** Total credits the package grants, as reported. */
+    totalCredits: number | null;
+    /** Credits remaining in the current cycle. */
+    remainingCredits: number | null;
+    /** Credits consumed in the current cycle. */
+    cycleUsedCredits: number | null;
+    /** Cycle allowance, when the service reports a per-cycle cap. */
+    cycleCredits: number | null;
+    /** Start of the current billing cycle, as Unix milliseconds. */
+    cycleStartsAt: number | null;
+    /** End of the current billing cycle, as Unix milliseconds. */
+    cycleEndsAt: number | null;
+    meters: WorkBuddyMeter[];
+    /** When this snapshot was read. */
+    fetchedAt: number;
+    /** Billing routes that answered, for diagnostics in the settings card. */
+    sources: string[];
+}
+/** Everything the settings card and the composer badge render. */
+export interface WorkBuddyWebStatus extends Partial<AccountPoolStatusDto> {
+    enabled?: boolean;
+    authenticated: boolean;
+    hasCredentials: boolean;
+    /** Where credentials are read from; the local CodeBuddy auth directory. */
+    authDirectory: string;
+    /** Storage description for the plugin's own settings file. */
+    storagePath: string;
+    account: WorkBuddyAccount | null;
+    quota: WorkBuddyAccountQuota | null;
+    lastFetchedAt: number | null;
+    models: WorkBuddyModelOption[];
+    contextWindowOverrides: Record<string, number>;
+    defaultReasoningEffort: WorkBuddyReasoningEffort | null;
+    /** Account selected for model discovery and all requests; null means automatic. */
+    selectedAccountId: string | null;
+    /** Encrypted storage used for accounts added from this plugin. */
+    managedStoragePath: string;
+    /** Route the plugin currently serves; false when another plugin owns it. */
+    serving: boolean;
+    /** Diagnostic when the route is owned by a different adapter family. */
+    conflict: string | null;
+    /** Pool summaries the shared account card renders; empty without a pool. */
+    accounts?: WorkBuddyAccountSummaryDto[];
+}
+/** Patch accepted by the models/settings route. */
+export interface WorkBuddySettingsUpdateDto {
+    enabled?: boolean;
+    enabledModelIds?: string[];
+    contextWindowOverrides?: Record<string, number>;
+    defaultReasoningEffort?: WorkBuddyReasoningEffort | null;
+    selectedAccountId?: string | null;
+}
+/** Result of a connection test against the upstream chat endpoint. */
+export interface WorkBuddyConnectionDto {
+    connected: boolean;
+    account: WorkBuddyAccount | null;
+    /** Round-trip time of the probe request. */
+    latencyMs: number;
+    /** Model the probe asked for. */
+    model: string;
+    checkedAt: number;
+}
+//# sourceMappingURL=workbuddy-contracts.d.ts.map

package/lib/types/shared/workbuddy-contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workbuddy-contracts.d.ts","sourceRoot":"","sources":["../../../src/shared/workbuddy-contracts.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eddyskywalker/dsh-chatgpt-subscription",
-  "version": "0.5.0",
+  "version": "0.6.5",
   "description": "DSH provider plugin for Codex access through a ChatGPT subscription.",
   "author": {
     "name": "eddyskywalker",