dsh-qoder-connect 0.1.4 → 0.1.8

package/lib/index.d.ts

@@ -141,11 +141,13 @@ interface QoderProbeAction {
    * All are writes, which is why they share this route's in-process key
    * and loopback guards rather than the read-only status GET.
    */
-  action: 'probe' | 'clear' | 'refresh' | 'set-maximum-context-window';
+  action: 'probe' | 'clear' | 'refresh' | 'set-maximum-context-window' | 'clear-checkin-logs' | 'checkin' | 'set-models-enabled';
   /** Target model id; required for `probe`. */
   model?: string;
-  /** Requested value for `set-maximum-context-window`. */
+  /** Requested value for `set-maximum-context-window` or `set-models-enabled`. */
   enabled?: boolean;
+  /** Target model ids for `set-models-enabled` (supports single, batch, or all). */
+  models?: readonly string[];
 }
 /**
  * Where the models a card is currently showing came from.
@@ -246,6 +248,8 @@ type QoderWebStatus = {
   probe?: QoderWebProbeSection;
   /** Card preference selecting larger declared context windows. */
   useMaximumContextWindow?: boolean;
+  /** Disabled model IDs (blacklist) for this variant. */
+  disabledModels?: readonly string[];
   /**
    * The last automatic job-token refresh the self-heal performed, epoch ms.
    * Absent when no refresh has happened in this process. The card renders
@@ -259,6 +263,33 @@ type QoderWebStatus = {
    * loopback guard); it is never persisted and rotates per process.
    */
   probeKey?: string;
+  /**
+   * Daily check-in status record for this variant.
+   */
+  checkIn?: {
+    lastDate: string;
+    lastAt: number;
+    status: 'claimed' | 'already-claimed' | 'no-campaign' | 'error';
+    amount?: number | undefined;
+    message?: string | undefined;
+    /**
+     * When the scheduler's timer is next due, epoch ms.
+     *
+     * A day already claimed goes deliberately quiet, so without this the
+     * card cannot tell "scheduled and waiting" from "no timer at all" —
+     * which is exactly the doubt a missing timer created.
+     */
+    nextRunAt?: number | undefined;
+    logs?: readonly {
+      id: string;
+      date: string;
+      timestamp: number;
+      status: 'claimed' | 'already-claimed' | 'no-campaign' | 'error';
+      amount?: number | undefined;
+      campaignKey?: string | undefined;
+      message?: string | undefined;
+    }[] | undefined;
+  };
   /**
    * In-process key authorizing PAT writes, including clearing. Travels with
    * the document for the same reason `probeKey` does.
@@ -518,9 +549,13 @@ declare class QoderCatalog {
   private useMaximumContextWindow;
   /** Per-model window overrides (model id → tokens); an override wins over the preference. */
   private modelContextWindows;
+  /** Disabled model IDs (blacklist); disabled models are filtered out from current(). */
+  private disabledModels;
   constructor(initial?: readonly QoderModelInfo[]);
-  /** Current entries; empty while the variant has no usable credential. */
+  /** Current entries; empty while the variant has no usable credential, excluding disabled models. */
   current(): readonly QoderModelInfo[];
+  /** All configured entries including disabled ones; empty while the variant has no usable credential. */
+  all(): readonly QoderModelInfo[];
   /** Replace the list; callers invalidate their adapter snapshot after this. */
   set(models: readonly QoderModelInfo[]): void;
   /** Whether this variant's models are exposed at all. */
@@ -537,6 +572,13 @@ declare class QoderCatalog {
    * changed, so the caller can skip an invalidation over an identical write.
    */
   setModelContextWindows(modelContextWindows: Readonly<Record<string, number>>): boolean;
+  /**
+   * Replace the disabled model IDs wholesale. Returns whether the set
+   * changed, so the caller can skip an invalidation over an identical write.
+   */
+  setDisabledModels(disabledModels: readonly string[]): boolean;
+  /** Current disabled model IDs. */
+  getDisabledModels(): readonly string[];
   /**
    * Models to fall back to when the upstream fetch fails; ignores
    * visibility, because the caller asking for the fallback already knows the
@@ -647,6 +689,14 @@ interface QoderQuota {
 interface QoderQuotaUsage {
   userQuota?: QoderQuota | undefined;
   orgResourcePackage?: QoderQuota | undefined;
+  /**
+   * Credits granted on top of the plan — the daily campaign's 100, for one.
+   *
+   * A separate bucket upstream reports beside `userQuota`; it carries its own
+   * total and remaining, so leaving it out made the card show fewer packages
+   * than the account actually holds (two on the web, one here).
+   */
+  addOnQuota?: QoderQuota | undefined;
   totalUsagePercentage?: number | undefined;
   isQuotaExceeded?: boolean | undefined;
   expiresAt?: string | undefined;
@@ -692,6 +742,17 @@ interface QoderAccountInfo {
   updatedAt: string;
 }
 //#endregion
+//#region src/qoder/transport/checkin.d.ts
+interface QoderCheckInResult {
+  variantId: string;
+  date: string;
+  timestamp: number;
+  status: 'claimed' | 'already-claimed' | 'no-campaign' | 'error';
+  amount?: number | undefined;
+  campaignKey?: string | undefined;
+  message?: string | undefined;
+}
+//#endregion
 //#region src/qoder/transport/index.d.ts
 interface QoderTransport {
   stream(options: GenerateOptions, model?: QoderCatalogModel): AsyncIterable<StreamChunk>;
@@ -700,6 +761,7 @@ interface QoderTransport {
     force?: boolean | undefined;
     signal?: AbortSignal | undefined;
   }): Promise<QoderAccountInfo>;
+  checkIn(signal?: AbortSignal): Promise<QoderCheckInResult>;
 }
 //#endregion
 //#region src/upstream.d.ts
@@ -840,6 +902,10 @@ declare class QoderUpstreamClient {
    * account's "unlimited" state.
    */
   fetchCredits(signal?: AbortSignal): Promise<QoderCredits>;
+  /**
+   * Run daily benefit check-in for this client's variant.
+   */
+  checkIn(signal?: AbortSignal): Promise<QoderCheckInResult>;
   /**
    * Stream one translated chat-completions request.
    *
@@ -1341,10 +1407,22 @@ interface Config {
   modelContextWindows?: Record<string, number>;
   /** The China variant's per-model overrides; see {@link Config.modelContextWindows}. */
   modelContextWindowsCN?: Record<string, number>;
+  /** Models disabled for the global variant (blacklist). */
+  disabledModels?: string[];
+  /** Models disabled for the China variant (blacklist). */
+  disabledModelsCN?: string[];
   /** Show the China variant's sidebar quota card. */
   sidebarQuotaCN?: boolean;
   /** Show the global variant's sidebar quota card. */
   sidebarQuotaGlobal?: boolean;
+  /** Automatically check in daily at 10:00 (UTC+8) to claim credits for China variant. */
+  autoCheckInCN?: boolean;
+  /** Automatically check in daily at 10:00 (UTC+8) to claim credits for Global variant. */
+  autoCheckInGlobal?: boolean;
+  /** When the China variant checks in, as minutes past midnight in UTC+8 (600 = 10:00). */
+  checkInMinuteCN?: number;
+  /** When the Global variant checks in, as minutes past midnight in UTC+8 (600 = 10:00). */
+  checkInMinuteGlobal?: number;
   /**
    * Sidebar quota refresh interval in milliseconds. One shared value (both
    * cards poll on it) because the two widgets hit the same rate-limited
@@ -1363,6 +1441,21 @@ interface Config {
 declare const QUOTA_POLL_DEFAULT_MS = 300000;
 declare const QUOTA_POLL_MIN_MS = 60000;
 declare const Config: z<Config>;
+/**
+ * Every field each settings section owns, and therefore every field the live
+ * configuration has to carry through.
+ *
+ * One list per section, shared by the merge and by the test that pins it to
+ * the schema. Writing the merge out by hand is what broke auto check-in: the
+ * `qoder-quota` section grew four fields (`autoCheckInCN`, `autoCheckInGlobal`,
+ * `checkInMinuteCN`, `checkInMinuteGlobal`) while the merge kept copying only
+ * the three that predated them, so `current().autoCheckInCN` read `undefined`
+ * forever and the scheduler saw the toggle as permanently off. The card saved
+ * it, the file held it, and nothing ever acted on it.
+ */
+declare const CN_SECTION_KEYS: readonly ["probeConsent", "useMaximumContextWindowCN", "modelContextWindowsCN", "disabledModelsCN"];
+declare const GLOBAL_SECTION_KEYS: readonly ["useMaximumContextWindow", "modelContextWindows", "disabledModels"];
+declare const QUOTA_SECTION_KEYS: readonly ["sidebarQuotaCN", "sidebarQuotaGlobal", "autoCheckInCN", "autoCheckInGlobal", "checkInMinuteCN", "checkInMinuteGlobal", "quotaPollMs"];
 /**
  * Start both variants: their loopback endpoints, the `qoder` and
  * `qoder-global` providers, their configuration cards, and their
@@ -1375,4 +1468,4 @@ declare const Config: z<Config>;
  */
 declare function apply(ctx: Context, config: Config): void;
 //#endregion
-export { CHINA_VARIANT, Config, FALLBACK_QODER_MODELS, GLOBAL_VARIANT, KIND_STATUS, PROBE_EFFORT_CANDIDATES, type ProbeAttempt, type ProbeOutcome, type ProbeSender, QODER_AUTH_FILENAME, QODER_AUTH_PATH, QODER_DATA_DIR_ENV, QODER_DATA_DIR_NAME, QODER_GLOBAL_AUTH_PATH, QODER_GLOBAL_PROBE_PATH, QODER_GLOBAL_SETTINGS_NS, QODER_GLOBAL_STATUS_PATH, QODER_HOST_HEARTBEAT_FILENAME, QODER_PAT_ENV_CN, QODER_PAT_ENV_GLOBAL, QODER_PROBE_FILENAME, QODER_PROBE_PATH, QODER_PROVIDER, QODER_QUOTA_SETTINGS_NS, QODER_SETTINGS_NS, QODER_STATUS_PATH, QODER_STREAM_IDLE_TIMEOUT_MS, QODER_VARIANTS, QUOTA_POLL_DEFAULT_MS, QUOTA_POLL_MIN_MS, type QoderAdapter, type QoderAuthRequest, type QoderAuthRouteOptions, type QoderAuthSaveResult, type QoderAuthStatus, QoderCatalog, type QoderCatalogFetch, type QoderCatalogModelSnapshot, QoderCatalogStore, type QoderCatalogStoreOptions, type QoderChatResult, type QoderCredential, QoderCredentialStore, type QoderCreditAccount, type QoderCredits, type QoderEffort, type QoderHostHeartbeat, type QoderModelBilling, type QoderModelInfo, type QoderModelReasoning, type QoderPatSummary, type QoderProbeAction, type QoderProbeRecord, QoderProbeService, type QoderProbeStatus, QoderProbeStore, type QoderProbeValidation, type QoderShim, QoderUpstreamClient, type QoderVariant, type QoderVariantId, type QoderWebCatalog, type QoderWebCreditAccount, type QoderWebCredits, type QoderWebProbeModel, type QoderWebProbeSection, type QoderWebStatus, type ShimLogger, type UpstreamErrorKind, apply, classifyUpstreamError, clearHostHeartbeat, createAuthKey, createQoderAdapter, createQoderShim, fingerprintModel, inject, isHeartbeatProcessAlive, kindFromQoderFailure, modelInfoOf, name, normalizeCredits, patTail, probeModel, processStartTimeMs, qoderAuthHandler, qoderCatalogPath, qoderCredentialIdentity, qoderHostHeartbeatPath, qoderOwnAuthPath, qoderPluginDataDir, qoderProbePath, randomSentinel, readHostHeartbeat, registerQoderAuthRoute, variantFor };
+export { CHINA_VARIANT, CN_SECTION_KEYS, Config, FALLBACK_QODER_MODELS, GLOBAL_SECTION_KEYS, GLOBAL_VARIANT, KIND_STATUS, PROBE_EFFORT_CANDIDATES, type ProbeAttempt, type ProbeOutcome, type ProbeSender, QODER_AUTH_FILENAME, QODER_AUTH_PATH, QODER_DATA_DIR_ENV, QODER_DATA_DIR_NAME, QODER_GLOBAL_AUTH_PATH, QODER_GLOBAL_PROBE_PATH, QODER_GLOBAL_SETTINGS_NS, QODER_GLOBAL_STATUS_PATH, QODER_HOST_HEARTBEAT_FILENAME, QODER_PAT_ENV_CN, QODER_PAT_ENV_GLOBAL, QODER_PROBE_FILENAME, QODER_PROBE_PATH, QODER_PROVIDER, QODER_QUOTA_SETTINGS_NS, QODER_SETTINGS_NS, QODER_STATUS_PATH, QODER_STREAM_IDLE_TIMEOUT_MS, QODER_VARIANTS, QUOTA_POLL_DEFAULT_MS, QUOTA_POLL_MIN_MS, QUOTA_SECTION_KEYS, type QoderAdapter, type QoderAuthRequest, type QoderAuthRouteOptions, type QoderAuthSaveResult, type QoderAuthStatus, QoderCatalog, type QoderCatalogFetch, type QoderCatalogModelSnapshot, QoderCatalogStore, type QoderCatalogStoreOptions, type QoderChatResult, type QoderCredential, QoderCredentialStore, type QoderCreditAccount, type QoderCredits, type QoderEffort, type QoderHostHeartbeat, type QoderModelBilling, type QoderModelInfo, type QoderModelReasoning, type QoderPatSummary, type QoderProbeAction, type QoderProbeRecord, QoderProbeService, type QoderProbeStatus, QoderProbeStore, type QoderProbeValidation, type QoderShim, QoderUpstreamClient, type QoderVariant, type QoderVariantId, type QoderWebCatalog, type QoderWebCreditAccount, type QoderWebCredits, type QoderWebProbeModel, type QoderWebProbeSection, type QoderWebStatus, type ShimLogger, type UpstreamErrorKind, apply, classifyUpstreamError, clearHostHeartbeat, createAuthKey, createQoderAdapter, createQoderShim, fingerprintModel, inject, isHeartbeatProcessAlive, kindFromQoderFailure, modelInfoOf, name, normalizeCredits, patTail, probeModel, processStartTimeMs, qoderAuthHandler, qoderCatalogPath, qoderCredentialIdentity, qoderHostHeartbeatPath, qoderOwnAuthPath, qoderPluginDataDir, qoderProbePath, randomSentinel, readHostHeartbeat, registerQoderAuthRoute, variantFor };