dsh-connect-trae 3.0.1 → 3.3.0

package/lib/index.d.ts

@@ -572,6 +572,20 @@ declare function parseTraeAuthValue(value: string): unknown;
 declare function parseTraeStorageDocument(text: string): unknown;
 //#endregion
 //#region src/identity.d.ts
+/**
+ * The per-install ECDSA P-256 keypair the official client registers with the
+ * device, and signs its token-refresh proof with.
+ *
+ * It lives in the same `storage.json` as the credential, under
+ * `iCubeAuthInfo://icube-dc:<deviceId>`, encrypted with the same codec — so the
+ * key that PROVES a device is the key stored beside the login it protects.
+ * Without it the new refresh contract cannot be satisfied at all (the server
+ * rejects a proof signed by any other key with `20403 Token device not match`).
+ */
+interface TraeDeviceKeyPair {
+  privateKeyPEM: string;
+  publicKeyPEM: string;
+}
 interface TraeIdentity {
   edition: TraeEdition;
   machineId: string;
@@ -581,6 +595,15 @@ interface TraeIdentity {
   deviceBrand?: string;
   deviceCpu?: string;
   osVersion?: string;
+  /**
+   * Device display name; the official client sends the OS account's full name.
+   * Optional because the new refresh contract does not read it.
+   */
+  deviceName?: string;
+  /** Device model, e.g. `MacBookPro18,2`. Optional; not required by the server. */
+  deviceModel?: string;
+  /** The install's registered device keypair, when `storage.json` carries one. */
+  deviceKeyPair?: TraeDeviceKeyPair;
   platform: NodeJS.Platform;
 }
 interface TraeIdentityReadOptions {
@@ -1156,16 +1179,46 @@ declare class TraeGatedUpstreamClient implements TraeUpstreamClient {
 }
 //#endregion
 //#region src/refresh.d.ts
-/** Stable device identity for the DeviceInfo body, sourced from the app's own storage. */
+/**
+ * Stable device identity for the DeviceInfo body, sourced from the app's own
+ * storage. Every field except `deviceId`/`machineId` is optional: the server
+ * requires `DeviceID`, `PlatformCode` and `DeviceType` (verified: dropping
+ * `DeviceType` yields `20403`, dropping `MachineID` does not), so a machine that
+ * cannot read the cosmetic fields must still be able to refresh.
+ */
 interface TraeRefreshDevice {
   deviceId: string;
   machineId: string;
+  deviceName?: string;
+  deviceModel?: string;
+  deviceBrand?: string;
+  deviceCpu?: string;
+  osVersion?: string;
+  appVersion?: string;
+  /**
+   * The install's registered keypair, read from `storage.json`. Its presence is
+   * exactly what decides whether the CURRENT contract can be attempted: without
+   * it there is no proof to sign, and the server would answer `20405`.
+   */
+  deviceKeyPair?: {
+    privateKeyPEM: string;
+    publicKeyPEM: string;
+  };
 }
 /**
- * Exchange a refresh token for a fresh access token, following the calling
- * edition's verified contract. `device` is only used by editions whose
- * official client sends a DeviceInfo body; when it cannot be resolved the
- * field is omitted rather than sent empty.
+ * Exchange a refresh token for a fresh access token.
+ *
+ * The CURRENT contract is attempted first whenever it is possible at all — it is
+ * what the shipped clients use. It needs the install's device keypair; without
+ * one there is nothing to sign, so the request is skipped rather than sent to be
+ * rejected with `20405`.
+ *
+ * The SUPERSEDED contract is then tried as a fallback, which is what keeps older
+ * installs and CLI-only machines working; it carries no device block but the
+ * SAME per-edition ClientID, because that split belongs to the OAuth client
+ * rather than to the endpoint (see {@link legacyBody}). When both are impossible
+ * or both fail, the error names every attempt so a "sign in again" verdict is
+ * diagnosable rather than mysterious.
  */
 declare function refreshTraeCredential(credential: TraeCredential, signal?: AbortSignal, device?: TraeRefreshDevice): Promise<TraeRefreshOutcome>;
 //#endregion
@@ -1561,9 +1614,20 @@ declare const TRAE_USAGE_PATH = "/plugins/dsh-connect-trae/usage";
  * labels the button as consuming a small amount.
  */
 declare const TRAE_MODELS_TEST_PATH = "/plugins/dsh-connect-trae/models/test";
+/**
+ * Per-account status (check-in / credits / subscription) for the account table.
+ *
+ * Each row of the account table reads its OWN state through this route — a CN
+ * row carries its check-in state and balance, an ai row its subscription.
+ * POST with the accountId in the body: one upstream read per account, paid
+ * only when the table is actually shown.
+ */
+declare const TRAE_ACCOUNT_STATUS_PATH = "/plugins/dsh-connect-trae/account-status";
 /**
  * Plugin-owned daily check-in claim endpoint. POST, loopback-only, and the only
- * route in this plugin that changes upstream account state.
+ * route in this plugin that changes upstream account state. The accountId in
+ * the body names WHICH account to claim for, so the button can sit in each
+ * account row.
  */
 declare const TRAE_CHECKIN_PATH = "/plugins/dsh-connect-trae/checkin";
 /** Query parameter naming the region a card request addresses. */
@@ -1586,6 +1650,12 @@ interface TraeWebCreditAccount {
   displayDesc: string;
   remain: number;
   size: number;
+  /**
+   * When this pack lapses, in epoch milliseconds, taken from the upstream's own
+   * `end_time`. Absent when the upstream reported no usable time (0 / missing),
+   * so a consumer can tell "no date" apart from "1970".
+   */
+  expiresAtMs?: number;
 }
 /** Aggregated usage/credit answer rendered by the plugin card. */
 interface TraeWebCredits {
@@ -1730,6 +1800,31 @@ interface TraeWebAppLogin {
   edition: 'cn' | 'sg' | 'solo' | 'solo-sg';
   region: TraeRegion;
 }
+/**
+ * The per-account state shown inside an account row of the card's table.
+ *
+ * Every locally detected account in a region is rendered as a row; the
+ * interesting per-account facts differ by region, which is why this is a union
+ * of the three surfaces the card previously showed only for the BOUND account:
+ *
+ *  - CN rows carry their own check-in state (Trae keys the daily reward per
+ *    ACCOUNT, and the one-per-device tally per DEVICE, see {@link TraeWebCheckin})
+ *    and their Work/General balances.
+ *  - ai rows carry their own subscription / trial status.
+ *
+ * Each field is optional: a read that fails keeps the row visible (perhaps
+ * without a figure) rather than dropping the account and its switch.
+ */
+interface TraeWebAccountState {
+  /** The account this state belongs to. */
+  id: string;
+  /** CN: today's check-in state of this account (absent for ai rows). */
+  checkin?: TraeWebCheckin;
+  /** CN: this account's Work/General balances (absent for ai rows). */
+  credits?: TraeWebCredits;
+  /** ai: this account's subscription / trial status (absent for CN rows). */
+  payStatus?: TraeWebPayStatus;
+}
 interface TraeWebCreditAlternative {
   id: string;
   accountName: string;
@@ -1930,6 +2025,22 @@ interface TraeUsageRouteOptions {
    * exhausted-account hint is simply not offered.
    */
   creditsOfAccount?(region: TraeRegion, accountId: string): Promise<TraeWebCredits | undefined>;
+  /**
+   * Per-account status for one row of the card's account table: CN → check-in
+   * + balances, ai → subscription. Read without changing which account is
+   * bound. Optional: when absent the account rows show no check-in/credits/
+   * subscription figures (the table still lists each account and its switch).
+   */
+  accountStateOf?(region: TraeRegion, accountId: string): Promise<TraeWebAccountState | undefined>;
+  /**
+   * Claim today's check-in reward for ONE named account, without moving the
+   * binding. Optional: absent means the per-row claim button is disabled (the
+   * check-in surface simply is not offered).
+   */
+  claimCheckinOf?(region: TraeRegion, accountId: string): Promise<{
+    claim: TraeCheckinClaim;
+    checkin: TraeCheckinStatus;
+  } | undefined>;
   /**
    * The account the Trae app is signed in to right now, when it differs from
    * the bound one (issue #29). Optional: absent means the card's follow hint
@@ -2193,4 +2304,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_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 TraeWebAppLogin, 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, configuredAccountsOf, createTraeAdapter, createTraeRawGateway, createTraeShim, decodeRawChatChunk, decodeTraeEvent, decryptTraeStorageValue, deriveCatalog, describeIdShape, describeNameShape, discoveredCatalog, fallbackModelsFor, followAppLoginEnabled, 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 };
+export { Config, FALLBACK_TRAE_MODELS, FALLBACK_TRAE_MODELS_AI, REGION_GATEWAYS, type RawChatDelta, type RawChatMessage, type RawChatTool, SseDecoder, type SseEvent, TRAE_ACCOUNT_STATUS_PATH, 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 TraeWebAccountState, type TraeWebActivity, type TraeWebAppLogin, 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, configuredAccountsOf, createTraeAdapter, createTraeRawGateway, createTraeShim, decodeRawChatChunk, decodeTraeEvent, decryptTraeStorageValue, deriveCatalog, describeIdShape, describeNameShape, discoveredCatalog, fallbackModelsFor, followAppLoginEnabled, 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 };