dsh-provider-qoder 0.2.0 → 0.3.0

package/lib/index.d.ts

@@ -1,6 +1,7 @@
 import z from "@deepseek-ai/schemastery";
+import { GenerateOptions, StreamChunk } from "@deepseek-ai/dsh-llm";
+import { WebSearchProvider, WebSearchRequest, WebSearchResult } from "@deepseek-ai/dsh-web";
 import { Context } from "@deepseek-ai/cordis";
-
 //#region src/qoder/catalog.d.ts
 /** Browser-safe Qoder model catalog types and built-in fallback entries. */
 interface QoderCatalogModel {
@@ -38,12 +39,16 @@ interface QoderModelsByRegion {
   global?: QoderCatalogModel[];
   china?: QoderCatalogModel[];
 }
+type QoderWebSearchMode = 'auto' | 'always' | 'disabled';
 interface Config {
   region?: QoderRegion;
   modelsByRegion?: QoderModelsByRegion;
   /** @deprecated Migrated to modelsByRegion for the selected region. */
   models?: QoderCatalogModel[];
   streamIdleTimeoutMs?: number;
+  responseHeaderTimeoutMs?: number;
+  preserveThinking?: boolean;
+  webSearchMode?: QoderWebSearchMode;
 }
 declare const Config: z<Config>;
 //#endregion
@@ -66,9 +71,37 @@ interface QoderQuota {
   percentage: number;
   unit: string;
 }
+/**
+ * Provider copy carried verbatim across the host/client seam.
+ *
+ * The host has no browser language, so it never picks one: the language map
+ * travels intact and the client resolves it against the active UI locale.
+ */
+interface QoderLocalizedText {
+  /** Language tag (e.g. 'zh-CN', 'en-US') to copy. */
+  values: Readonly<Record<string, string>>;
+  /** Provider copy that carries no language tag; empty when absent. */
+  fallback: string;
+}
+/** One dedicated (entitlement-scoped) resource package carved out of the plan. */
+interface QoderResourcePackage {
+  id?: string;
+  title?: QoderLocalizedText;
+  description?: QoderLocalizedText;
+  total: number;
+  used: number;
+  remaining: number;
+  percentage: number;
+  unit: string;
+  /** Package expiry, distinct from the usage-level subscription expiry. */
+  expiresAt?: string;
+  available?: boolean;
+  status?: string;
+}
 interface QoderQuotaUsage {
   userQuota?: QoderQuota;
   orgResourcePackage?: QoderQuota;
+  dedicatedResourcePackages?: QoderResourcePackage[];
   totalUsagePercentage?: number;
   isQuotaExceeded?: boolean;
   expiresAt?: string;
@@ -114,4 +147,82 @@ interface QoderAccountInfo {
   updatedAt: string;
 }
 //#endregion
-export { Config, type QoderAccountInfo, type QoderCatalogModel, type QoderModelsByRegion, type QoderRegion, apply, inject, name };
+//#region src/qoder/transport/logging.d.ts
+/** Bounded, redacted diagnostics internal to the Qoder transport. */
+interface QoderLogger {
+  debug?(message: string, ...details: unknown[]): void;
+  warn?(message: string, ...details: unknown[]): void;
+  error?(message: string, ...details: unknown[]): void;
+}
+//#endregion
+//#region src/qoder/transport/endpoints.d.ts
+/** Path of the center web search route. */
+declare const qoderWebSearchPath = "/api/v1/webSearch/oneSearch";
+declare function getQoderWebSearchUrl(region?: QoderRegion): string;
+//#endregion
+//#region src/qoder/transport/wire/cosy.d.ts
+interface CosyCredentials {
+  userID: string;
+  authToken: string;
+  name: string;
+  email: string;
+  machineID?: string;
+}
+//#endregion
+//#region src/qoder/transport/search.d.ts
+interface QoderSearchClientOptions {
+  fetch?: typeof fetch;
+  region?: QoderRegion;
+  logger?: QoderLogger;
+  timeoutMs?: number;
+  resolveCredentials: (signal?: AbortSignal) => Promise<CosyCredentials>;
+  refreshCredentials?: (signal?: AbortSignal) => Promise<CosyCredentials>;
+  now?: () => number;
+}
+declare class QoderSearchClient {
+  private readonly fetchImpl;
+  private readonly region;
+  private readonly logger?;
+  private readonly timeoutMs;
+  private readonly resolveCredentials;
+  private readonly refreshCredentials?;
+  private readonly now;
+  constructor(options: QoderSearchClientOptions);
+  search(request: WebSearchRequest, signal?: AbortSignal): Promise<WebSearchResult>;
+  private attempt;
+}
+//#endregion
+//#region src/qoder/transport/index.d.ts
+interface QoderTransport {
+  stream(options: GenerateOptions, model?: QoderCatalogModel): AsyncIterable<StreamChunk>;
+  discoverModels(signal?: AbortSignal): Promise<readonly QoderCatalogModel[]>;
+  readAccount(options?: {
+    force?: boolean;
+    signal?: AbortSignal;
+  }): Promise<QoderAccountInfo>;
+  searchWeb(request: WebSearchRequest, signal?: AbortSignal): Promise<WebSearchResult>;
+}
+//#endregion
+//#region src/dsh/search-provider.d.ts
+declare const QODER_SEARCH_PROVIDER_ID = "qoder";
+interface QoderSearchProviderOptions {
+  ctx: Context;
+  resolveTransport?: () => QoderTransport;
+  searchClient?: QoderSearchClient;
+  getWebSearchMode: () => QoderWebSearchMode;
+  fallbackProvider?: WebSearchProvider;
+}
+declare class QoderSearchProvider implements WebSearchProvider {
+  readonly id = "qoder";
+  private readonly ctx;
+  private readonly resolveTransport?;
+  private readonly searchClient?;
+  private readonly getWebSearchMode;
+  private readonly fallbackProvider?;
+  constructor(options: QoderSearchProviderOptions);
+  available(): boolean;
+  search(request: WebSearchRequest, signal?: AbortSignal): Promise<WebSearchResult>;
+  private resolveFallback;
+}
+//#endregion
+export { Config, QODER_SEARCH_PROVIDER_ID, type QoderAccountInfo, type QoderCatalogModel, type QoderModelsByRegion, type QoderRegion, QoderSearchClient, type QoderSearchClientOptions, QoderSearchProvider, type QoderSearchProviderOptions, type QoderWebSearchMode, apply, getQoderWebSearchUrl, inject, name, qoderWebSearchPath };