dsh-connect-trae 2.4.0 → 2.7.0

package/lib/index.d.ts

@@ -225,12 +225,22 @@ interface TraeWireModel {
  * multiplier, reasoning and multimodal flags. `wire` (from `get_detail_param`)
  * supplies the real `llm_utils_chat` `config_name` — the only id the chat
  * endpoint actually accepts — plus the authoritative post-discount credit
- * multiplier when `display_contact_config` carries one. A remote row is only
- * callable when it maps to a wire `config_name`, so a remote row with no wire
- * match is DROPPED (it would otherwise be sent as an invalid `config_name` and
- * rejected with 4001 "param is invalid"). Verified 2026-08-30: the Remote
- * directory advertises `Doubao-Seed-Code` and `glm-5.3`, neither of which is a
- * current `config_name`; both fail every request, so they must not be exposed.
+ * multiplier when `display_contact_config` carries one.
+ *
+ * A remote row with no wire match is STILL KEPT (decision 2026-10-02, issue
+ * #19). It previously was dropped, on the reasoning that a row with no
+ * `config_name` is sent as an invalid one and rejected with 4001. That
+ * reasoning holds only for the accounts and functions we can measure, and
+ * measuring is the problem: whether a roster contains a model is ACCOUNT-
+ * SCOPED, so "no wire entry on a free account" cannot prove a paying account
+ * cannot call it. Dropping on that evidence silently denied those users models
+ * their own Trae IDE offers. The row therefore ships, and its call fails
+ * honestly: the bridge now translates the in-stream refusal into a readable
+ * error (`4001` → "Trae does not serve this model under the SOLO function the
+ * request used", `4011` → "Trae refused this model under the SOLO function the
+ * request used"), so a user who picks an unusable model is told why instead of
+ * seeing nothing. This reverses the 2026-08-30 note about `Doubao-Seed-Code`,
+ * which later turned out to be callable under `chat_v3`.
  *
  * Credit multiplier precedence: the wire's `display_contact_config` rate wins
  * whenever present (it is the post-discount figure the Trae IDE renders — the
@@ -1326,6 +1336,19 @@ interface TraePayStatus {
   enableSoloBuilder: boolean;
   enableSoloCoder: boolean;
   enableSoloWeb: boolean;
+  /**
+   * The account's plan identity (`user_pay_identity`), Trae's authoritative
+   * tier number: `0` is Free. Measured 2026-10-01 on a live SG community
+   * account, which reported `0` / `"Free"`.
+   *
+   * This is a DIFFERENT question from {@link hasPackage}, which asks whether a
+   * package/entitlement object exists. A paying member can hold a plan
+   * identity without any package row, which is why issue #19 saw "No active
+   * package" on a Pro account — the card only ever read `has_package`.
+   */
+  payIdentity?: number;
+  /** The plan identity as Trae spells it (`user_pay_identity_str`), e.g. `Free`. */
+  payIdentityStr?: string;
   /** The fission (referral) program window and cap, when exposed. */
   fission?: {
     startTimeMs: number;
@@ -1492,6 +1515,13 @@ declare class TraeUsageClient {
 //#region src/status-paths.d.ts
 /** Plugin-owned usage endpoint consumed by its browser half. */
 declare const TRAE_USAGE_PATH = "/plugins/dsh-connect-trae/usage";
+/**
+ * Plugin-owned availability probe: POST the model ids to test, get one verdict
+ * per model. Unlike every read-only sibling this route SPENDS quota — a real
+ * (minimal) chat call per model — so it is user-initiated only, and the card
+ * labels the button as consuming a small amount.
+ */
+declare const TRAE_MODELS_TEST_PATH = "/plugins/dsh-connect-trae/models/test";
 /**
  * Plugin-owned daily check-in claim endpoint. POST, loopback-only, and the only
  * route in this plugin that changes upstream account state.
@@ -1548,6 +1578,34 @@ interface TraeWebModel {
    * directory did not declare it, which is not a capability claim either way.
    */
   multimodal?: boolean;
+  /**
+   * The availability verdict from the one-click test, when this card session
+   * has run one. Absent = not tested. Deliberately NOT persisted with the
+   * settings: it describes one moment on one account, and a stale verdict shown
+   * as current is worse than a blank field.
+   */
+  probe?: TraeModelProbeVerdict;
+  /** Upstream's own words for the verdict, when it gave any. */
+  probeDetail?: string;
+}
+/**
+ * One model's availability verdict from the one-click test.
+ *
+ * `unknown` is a first-class outcome, not a failure: a timeout, a proxy drop or
+ * a throttle says nothing about the model, and reporting it as unusable would
+ * make the user delete a model that works. Only an upstream refusal is negative.
+ */
+type TraeModelProbeVerdict = 'available' | 'gated' | 'unsupported' | 'rate_limited' | 'auth' | 'unknown';
+/** What the probe route answers with. */
+interface TraeModelsTestResponse {
+  /** One entry per model tested, in the order they were sent. */
+  results: {
+    id: string;
+    verdict: TraeModelProbeVerdict;
+    detail: string;
+  }[];
+  /** Models skipped because the region has no live catalog row for them. */
+  skipped?: string[];
 }
 /**
  * Daily check-in state rendered below the credit stats.
@@ -1695,6 +1753,10 @@ interface TraeWebPayStatus {
   enableSoloBuilder: boolean;
   enableSoloCoder: boolean;
   enableSoloWeb: boolean;
+  /** Trae's authoritative tier number (`user_pay_identity`); `0` means Free. */
+  payIdentity?: number;
+  /** Trae's authoritative tier label (`user_pay_identity_str`), e.g. `Free`. */
+  payIdentityStr?: string;
   fission?: {
     startTimeMs: number;
     expireTimeMs: number;
@@ -1767,6 +1829,18 @@ interface TraeUsageRouteOptions {
   regionEnabled(region: TraeRegion): boolean;
   /** Re-read one region's live directory from the upstream. */
   discoverModels?(region: TraeRegion, signal?: AbortSignal): Promise<readonly TraeModelInfo[]>;
+  /**
+   * Test the given model ids for availability, one real (minimal) chat call
+   * each. Present only when the region's chat path is wired.
+   */
+  probeModels?(region: TraeRegion, ids: readonly string[]): Promise<{
+    results: {
+      id: string;
+      verdict: string;
+      detail: string;
+    }[];
+    skipped?: string[];
+  }>;
   /** Raw-Chat capability state of the requested region. */
   rawDiagnostic?(region: TraeRegion): TraeRawDiagnostic;
 }
@@ -1781,6 +1855,64 @@ declare function traeWebUsage(deps: TraeUsageRouteOptions, region: TraeRegion):
 /** Mount the GET usage route on an optional webServer context. */
 declare function registerTraeUsageRoute(ctx: Context, deps: TraeUsageRouteOptions): void;
 //#endregion
+//#region src/model-probe.d.ts
+/** How one model answered. */
+type TraeProbeVerdict = 'available' | 'gated' | 'unsupported' | 'rate_limited' | 'auth' | 'unknown';
+interface TraeProbeResult {
+  /** The model id as the card knows it. */
+  id: string;
+  verdict: TraeProbeVerdict;
+  /** Upstream's own words (already translated), or a short note. */
+  detail: string;
+}
+/**
+ * How long one probe may take. Trae answers a one-word prompt in a few seconds;
+ * beyond this the answer is not worth waiting for and is reported as unknown.
+ */
+declare const TRAE_PROBE_TIMEOUT_MS = 30000;
+/**
+ * Classify a failure that arrived as a thrown stream error rather than a
+ * returned result.
+ *
+ * The bridge errors the stream (instead of returning a result) when a refusal
+ * interrupts an answer that had already started; its message is the same
+ * translated text, so a named code is still decisive. Anything without a
+ * recognised code — an abort, a socket reset, a proxy — stays `unknown`.
+ */
+declare function classifyProbeError(message: string): {
+  verdict: TraeProbeVerdict;
+  detail: string;
+};
+/**
+ * Classify a completed upstream call.
+ *
+ * `result` is what `TraeSoloBridge.chatStream` returned, so a refusal that
+ * arrived inside a 200 body has already been turned into a real error result
+ * (and its code translated into `message`) by the bridge — this function only
+ * has to read it back.
+ */
+declare function classifyProbeResult(result: TraeChatResult, outputSeen: boolean): {
+  verdict: TraeProbeVerdict;
+  detail: string;
+};
+/** The minimal chat call one probe makes. */
+declare function probeBody(model: string): string;
+/**
+ * Probe one model through the bridge the plugin actually chats with, so the
+ * recorded verdict describes the user's real path (same wire resolution, same
+ * function stamping, same error translation).
+ */
+declare function probeOneModel(chat: (body: string, signal?: AbortSignal) => Promise<TraeChatResult>, id: string, timeoutMs?: number): Promise<TraeProbeResult>;
+/**
+ * Probe a list of models ONE AT A TIME.
+ *
+ * Sequential on purpose: Trae throttles bursts, and a burst of parallel probes
+ * would manufacture the very `rate_limited`/`unknown` verdicts this feature
+ * must avoid. An authentication failure stops the run — every later probe would
+ * fail the same way, and spending calls to learn that again is waste.
+ */
+declare function probeModelsSequentially(chat: (body: string, signal?: AbortSignal) => Promise<TraeChatResult>, ids: readonly string[], onResult?: (result: TraeProbeResult, index: number) => void): Promise<TraeProbeResult[]>;
+//#endregion
 //#region src/index.d.ts
 declare const name = "dsh-connect-trae";
 declare const inject: string[];
@@ -1903,4 +2035,4 @@ declare function asVolatile<S>(schema: S): S;
 declare const Config: z<Config>;
 declare function apply(ctx: Context, config: Config): void;
 //#endregion
-export { Config, FALLBACK_TRAE_MODELS, FALLBACK_TRAE_MODELS_AI, REGION_GATEWAYS, type RawChatDelta, type RawChatMessage, type RawChatTool, SseDecoder, type SseEvent, TRAE_AI_PROVIDER, TRAE_CHECKIN_PATH, TRAE_CN_AGENT_TASK_PATH, TRAE_CN_TITLE_PATH, TRAE_MODEL_DETAIL_FUNCTIONS, TRAE_MODEL_DETAIL_PATH, TRAE_PAY_BASE, TRAE_PROVIDER, TRAE_PROVIDERS, TRAE_PROVIDER_DISPLAY_NAMES, TRAE_RAW_CHAT_V1_PATH, TRAE_RAW_CHAT_V2_PATH, TRAE_REASONING_EFFORTS, TRAE_REGIONS, TRAE_REGION_PARAM, TRAE_SETTINGS_NS, TRAE_SOLO_CHAT_PATH, TRAE_SOLO_FUNCTION, TRAE_SOLO_MODELS_PATH, TRAE_SOLO_REMOTE_BASE, TRAE_STATE_DB_FILENAME, TRAE_STREAM_IDLE_TIMEOUT_MS, TRAE_USAGE_PATH, TRAE_VERSION_CODE_FALLBACK, type TraeActivityRule, type TraeAdapter, type TraeCachedModelConfig, TraeCatalog, type TraeChatResult, type TraeCheckinClaim, type TraeCheckinStatus, type TraeContextBudget, type TraeCredential, TraeCredentialStore, TraeDelegatingUpstreamClient, type TraeDiscoveredModel, type TraeDiscoveredReasoning, type TraeEdition, TraeFallbackUpstreamClient, type TraeFallbackUpstreamOptions, type TraeFusionRawChatEnvelope, TraeGatedUpstreamClient, type TraeGatedUpstreamOptions, type TraeIdentity, type TraeInputModality, type TraeModelDetailRequest, type TraeModelInfo, type TraeObservedModelConfig, TraeRawCapabilityController, type TraeRawCapabilityControllerOptions, type TraeRawCapabilitySnapshot, TraeRawCapabilityState, type TraeRawChatBehaviorConfig, type TraeRawChatCapability, type TraeRawChatClientOptions, type TraeRawChatConfig, type TraeRawChatFailureReason, type TraeRawChatRuntimeConfig, TraeRawChatUpstreamClient, type TraeRawDiagnostic, type TraeRawDiagnosticState, type TraeRawGateway, type TraeRawGatewayOptions, type TraeRawResolverResult, type TraeReasoningCapability, type TraeReasoningEffort, type TraeRefreshDevice, type TraeRegion, type TraeRegionGateways, TraeRegionState, type TraeShim, TraeSoloBridge, type TraeSoloClientOptions, TraeSoloRemoteCatalogClient, type TraeSoloRemoteCatalogOptions, TraeSoloUpstreamClient, type TraeStorageCandidate, type TraeStreamEvent, type TraeUpstreamClient, TraeUsageClient, type TraeUsageOptions, type TraeUsagePack, type TraeUsageRouteOptions, type TraeUsageSnapshot, type TraeUsageSummary, type TraeUsageView, type TraeWebActivity, type TraeWebCheckin, type TraeWebCheckinClaim, type TraeWebCredits, type TraeWebUsage, type TraeWireModel, UnconfiguredTraeUpstreamClient, apply, applyContextBudgets, applyImageSelection, applyReasoningEffort, asVolatile, bridgeTraeSoloStream, buildTraeAgentTaskBody, buildTraeCnHeaders, buildTraeFusionRawChatEnvelope, buildTraeModelDetailRequest, buildTraeRawChatDraft, buildTraeRawChatRuntimeConfig, classifyTraeRawChatFailure, createTraeAdapter, createTraeRawGateway, createTraeShim, decodeRawChatChunk, decodeTraeEvent, decryptTraeStorageValue, deriveCatalog, describeIdShape, describeNameShape, discoveredCatalog, fallbackModelsFor, hashTraeRawChatArg, identityHeaders, inject, legacyTraeOwnAuthPath, maskUserPath, mergeTraeModelSources, name, nextRegionEnabled, nextRegionSlots, normalizeTraeCredential, normalizeTraeVersionCode, parseObservedModelConfig, parseReasoningCapability, parseTraeAuthValue, parseTraeCachedModel, parseTraeModelExtraConfigLogLine, parseTraeRawChatBehaviorConfig, parseTraeRemoteModel, parseTraeStorageDocument, pickTraeStorageIdentity, prepareSoloBody, probeTraeRawChatCapability, rawCapabilityDiagnostic, rawCapabilityFingerprint, readTraeCachedModel, readTraeCliIdentity, readTraeIdentity, refreshTraeCredential, regionEnabled, regionEnabledOf, regionOfCredential, regionOfEdition, regionOfHost, regionOfTraeProvider, regionOfTraeStatusUrl, regionOfUserRegion, regionStateOf, registerTraeUsageRoute, resolveTraeIdentity, resolveTraeRawRuntime, sanitizeCatalog, settingsNamespaceOf, traeEndpoint, traeInputModalities, traeModelDisplayName, traeOwnAuthPath, traeRawChatExtraInfo, traeStateDatabaseCandidates, traeStorageCandidates, traeWebUsage, traeWindowsAppNames, unwrapVolatile, unwrapVolatileDeep, withTraeRegion };
+export { Config, FALLBACK_TRAE_MODELS, FALLBACK_TRAE_MODELS_AI, REGION_GATEWAYS, type RawChatDelta, type RawChatMessage, type RawChatTool, SseDecoder, type SseEvent, TRAE_AI_PROVIDER, TRAE_CHECKIN_PATH, TRAE_CN_AGENT_TASK_PATH, TRAE_CN_TITLE_PATH, TRAE_MODELS_TEST_PATH, TRAE_MODEL_DETAIL_FUNCTIONS, TRAE_MODEL_DETAIL_PATH, TRAE_PAY_BASE, TRAE_PROBE_TIMEOUT_MS, TRAE_PROVIDER, TRAE_PROVIDERS, TRAE_PROVIDER_DISPLAY_NAMES, TRAE_RAW_CHAT_V1_PATH, TRAE_RAW_CHAT_V2_PATH, TRAE_REASONING_EFFORTS, TRAE_REGIONS, TRAE_REGION_PARAM, TRAE_SETTINGS_NS, TRAE_SOLO_CHAT_PATH, TRAE_SOLO_FUNCTION, TRAE_SOLO_MODELS_PATH, TRAE_SOLO_REMOTE_BASE, TRAE_STATE_DB_FILENAME, TRAE_STREAM_IDLE_TIMEOUT_MS, TRAE_USAGE_PATH, TRAE_VERSION_CODE_FALLBACK, type TraeActivityRule, type TraeAdapter, type TraeCachedModelConfig, TraeCatalog, type TraeChatResult, type TraeCheckinClaim, type TraeCheckinStatus, type TraeContextBudget, type TraeCredential, TraeCredentialStore, TraeDelegatingUpstreamClient, type TraeDiscoveredModel, type TraeDiscoveredReasoning, type TraeEdition, TraeFallbackUpstreamClient, type TraeFallbackUpstreamOptions, type TraeFusionRawChatEnvelope, TraeGatedUpstreamClient, type TraeGatedUpstreamOptions, type TraeIdentity, type TraeInputModality, type TraeModelDetailRequest, type TraeModelInfo, type TraeModelProbeVerdict, type TraeModelsTestResponse, type TraeObservedModelConfig, type TraeProbeResult, type TraeProbeVerdict, TraeRawCapabilityController, type TraeRawCapabilityControllerOptions, type TraeRawCapabilitySnapshot, TraeRawCapabilityState, type TraeRawChatBehaviorConfig, type TraeRawChatCapability, type TraeRawChatClientOptions, type TraeRawChatConfig, type TraeRawChatFailureReason, type TraeRawChatRuntimeConfig, TraeRawChatUpstreamClient, type TraeRawDiagnostic, type TraeRawDiagnosticState, type TraeRawGateway, type TraeRawGatewayOptions, type TraeRawResolverResult, type TraeReasoningCapability, type TraeReasoningEffort, type TraeRefreshDevice, type TraeRegion, type TraeRegionGateways, TraeRegionState, type TraeShim, TraeSoloBridge, type TraeSoloClientOptions, TraeSoloRemoteCatalogClient, type TraeSoloRemoteCatalogOptions, TraeSoloUpstreamClient, type TraeStorageCandidate, type TraeStreamEvent, type TraeUpstreamClient, TraeUsageClient, type TraeUsageOptions, type TraeUsagePack, type TraeUsageRouteOptions, type TraeUsageSnapshot, type TraeUsageSummary, type TraeUsageView, type TraeWebActivity, type TraeWebCheckin, type TraeWebCheckinClaim, type TraeWebCredits, type TraeWebUsage, type TraeWireModel, UnconfiguredTraeUpstreamClient, apply, applyContextBudgets, applyImageSelection, applyReasoningEffort, asVolatile, bridgeTraeSoloStream, buildTraeAgentTaskBody, buildTraeCnHeaders, buildTraeFusionRawChatEnvelope, buildTraeModelDetailRequest, buildTraeRawChatDraft, buildTraeRawChatRuntimeConfig, classifyProbeError, classifyProbeResult, classifyTraeRawChatFailure, createTraeAdapter, createTraeRawGateway, createTraeShim, decodeRawChatChunk, decodeTraeEvent, decryptTraeStorageValue, deriveCatalog, describeIdShape, describeNameShape, discoveredCatalog, fallbackModelsFor, hashTraeRawChatArg, identityHeaders, inject, legacyTraeOwnAuthPath, maskUserPath, mergeTraeModelSources, name, nextRegionEnabled, nextRegionSlots, normalizeTraeCredential, normalizeTraeVersionCode, parseObservedModelConfig, parseReasoningCapability, parseTraeAuthValue, parseTraeCachedModel, parseTraeModelExtraConfigLogLine, parseTraeRawChatBehaviorConfig, parseTraeRemoteModel, parseTraeStorageDocument, pickTraeStorageIdentity, prepareSoloBody, probeBody, probeModelsSequentially, probeOneModel, probeTraeRawChatCapability, rawCapabilityDiagnostic, rawCapabilityFingerprint, readTraeCachedModel, readTraeCliIdentity, readTraeIdentity, refreshTraeCredential, regionEnabled, regionEnabledOf, regionOfCredential, regionOfEdition, regionOfHost, regionOfTraeProvider, regionOfTraeStatusUrl, regionOfUserRegion, regionStateOf, registerTraeUsageRoute, resolveTraeIdentity, resolveTraeRawRuntime, sanitizeCatalog, settingsNamespaceOf, traeEndpoint, traeInputModalities, traeModelDisplayName, traeOwnAuthPath, traeRawChatExtraInfo, traeStateDatabaseCandidates, traeStorageCandidates, traeWebUsage, traeWindowsAppNames, unwrapVolatile, unwrapVolatileDeep, withTraeRegion };