dsh-connect-trae 4.6.11 → 4.8.0

package/lib/index.d.ts

@@ -286,6 +286,43 @@ interface TraeModelInfo {
    */
   activityDiscount?: TraeActivityDiscount;
 }
+/**
+ * Conservative context capacity used when a row must be advertised with a
+ * number but states no usable one of its own. Every fallback row and every
+ * live Trae row is expected to carry its real window; this is the backstop
+ * that keeps one unsized row from failing the entire provider route
+ * (`INVALID_MODEL_CONTEXT`).
+ *
+ * APPLIED AT EVERY EXIT TOWARD DSH, NOT ONLY IN THE ADAPTER. The pi-ai
+ * profile's `defaultContextWindow` is read by the kernel's catalog-resolution
+ * step, which this plugin never runs: it builds its provider BY HAND through
+ * `createProvider({ models })`, so `Models.getModel()` returns the raw
+ * `toPiModel` row with no defaulting applied anywhere. Leaving the fallback on
+ * the profile alone is what produced
+ * `adapter returned invalid context metadata for provider "trae" model
+ * "doubao_1.8"` — a row the live directory published without a window reached
+ * DSH unsized and took the whole `trae` route down (#70).
+ *
+ * The model-DISCOVERY callback is a second exit with no adapter in between
+ * (#72): the host passes its rows through UNVALIDATED, and a settings surface
+ * adopts one verbatim into a `models` entry, where the schema demands a
+ * positive integer. So this rule guards the row PRODUCERS here as well.
+ */
+declare const FALLBACK_CONTEXT_WINDOW = 200000;
+/**
+ * The window a row is actually advertised with.
+ *
+ * Positive integers pass through untouched — a row's own window is never
+ * second-guessed. Anything else (missing, `NaN`, `0`, a negative or a
+ * fractional count from a malformed directory entry) falls back, because DSH
+ * accepts ONLY a positive integer and rejects the entire provider otherwise.
+ *
+ * The fractional case is not hypothetical: the parsers that fill these rows
+ * gate the field through `finitePositive`, which checks
+ * `Number.isFinite && > 0` and nothing about integer-ness, so a directory or
+ * wire roster publishing `200000.5` reaches here intact.
+ */
+declare function servedContextWindow(info: Pick<TraeModelInfo, 'contextWindow'>): number;
 /**
  * Bootstrap catalog: identity only where current Trae metadata has not been
  * fetched yet.
@@ -1336,6 +1373,16 @@ type TraeWebUsage = {
   /** A recognized-but-unserved region on this machine (issue #66). */
   unsupportedRegion?: TraeWebUnsupportedRegion;
   enabled?: boolean;
+  /**
+   * Whether the OPTIONAL sidebar row is switched on (`Config.sidebarPanel`).
+   *
+   * GLOBAL and present on BOTH shapes: the row belongs to the plugin, not to
+   * a region or an account, and a signed-out card is still somewhere the user
+   * may want the page it opens. Absent reads as OFF — the entry seeds its
+   * registration from this answer, and the row claims a seat every bundle
+   * shares, so a Host that cannot answer must never turn it on.
+   */
+  sidebarPanelEnabled?: boolean;
 } | {
   status: 'signed-in';
   accountId: string;
@@ -1352,6 +1399,8 @@ type TraeWebUsage = {
   region: TraeRegion;
   /** Whether this region's provider is currently offered to DSH. */
   enabled?: boolean;
+  /** See the signed-out shape: GLOBAL, absent reads as OFF. */
+  sidebarPanelEnabled?: boolean;
   accounts: readonly TraeWebAccount[];
   models: readonly TraeWebModel[];
   enabledModelIds: readonly string[];
@@ -1756,6 +1805,14 @@ declare function withContextAdaptation(api: ProviderStreams, generation: PiAiGen
 interface TraeAdapterOptions {
   shim: TraeShim;
   catalog: TraeCatalog;
+  /**
+   * The user's saved per-model level choices, region-scoped (model id -> level).
+   *
+   * Read lazily on every resolution so a settings save is picked up without
+   * rebuilding the adapter. Absent means "no overrides", which still leaves the
+   * upstream's own default in force — the feature is useful with zero choices.
+   */
+  defaultEfforts?: () => Readonly<Record<string, string | undefined>>;
   /** Provider route id this instance serves; defaults to the CN route. */
   provider?: string;
   /** pi-ai provider name and profile display name; defaults to the CN name. */
@@ -4371,6 +4428,22 @@ interface TraeUsageRouteOptions {
    * committed settings value rather than a local guess.
    */
   regionEnabled(panel: TraePanel): boolean;
+  /**
+   * Whether the OPTIONAL sidebar row is switched on, GLOBAL rather than
+   * per-panel.
+   *
+   * Optional, and `=== true` at the reading site: the row is a property of the
+   * whole plugin, not of one region, and an absent answer (an older Host, a
+   * stack that failed to build) must read as OFF — the row claims a seat every
+   * bundle shares, so a missing answer is never consent.
+   *
+   * It rides on the usage document because that is the read the browser entry
+   * already makes at apply() time: the namespace's settings mirror is
+   * documented as stale on the affected 0.1.7 deployments, so seeding the
+   * switch from the Host's own answer is what keeps a stale `false` from
+   * hiding a row the Host believes it is serving.
+   */
+  sidebarPanelEnabled?(): boolean;
   /** Re-read one region's live directory from the upstream. */
   discoverModels?(panel: TraePanel, signal?: AbortSignal): Promise<readonly TraeModelInfo[]>;
   /**
@@ -4571,6 +4644,21 @@ interface TraeRegionState {
   drawImageEnabled?: boolean;
   /** Local DSH context budget per model in this region. */
   contextBudgets?: Record<string, number>;
+  /**
+   * The user's own thinking-level choice per model, for this panel (model id ->
+   * DSH level).
+   *
+   * OPT-IN by nature: a missing key means "use whatever this model's own
+   * default is" (`reasoning.defaultEffort`, which Trae's directory publishes),
+   * i.e. the behaviour the plugin had before this field existed. Choosing a
+   * level here overrides that for good, and it is what the kernel materialises
+   * into every request that names no level — see `src/default-effort.ts`.
+   *
+   * A key can go STALE: a directory refresh may withdraw a tier, and a level the
+   * model no longer offers is then ignored rather than sent (sending it would be
+   * rejected with `UNSUPPORTED_REASONING_EFFORT`).
+   */
+  thinkingEfforts?: Record<string, string>;
   /**
    * WHERE this region's credit readout sits (learned from dsh-connect-workbuddy
    * issue #62).
@@ -4636,6 +4724,22 @@ interface Config {
    * settings form can both read and write it.
    */
   showPointsInMainUi?: boolean;
+  /**
+   * Show this plugin's own row in the DSH sidebar (`sidebar.panellist`), which
+   * opens the usage card as a full `main` page.
+   *
+   * OFF by default, for exactly the reason the sibling
+   * `dsh-connect-workbuddy` row is off by default (its PR #188 /
+   * `Config.sidebarPanel`): the sidebar's global rows are the host's own pages,
+   * the row claims a seat every installed bundle shares, and the Plugins page
+   * already reaches this same card. A row nobody asked for re-arranges a
+   * surface the plugin does not own.
+   *
+   * The card's checkbox is the only writer (see `panel-switch.ts` on the
+   * browser side, and `sidebarPanelEnabled` on the status document, which is
+   * where the entry seeds the switch at page load).
+   */
+  sidebarPanel?: boolean;
   /**
    * Per-region model state, keyed `cn` | `ai`. The CN and international apps
    * expose different rosters, so each keeps its own directory and selection
@@ -4700,6 +4804,33 @@ declare function regionEnabled(config: Config, panel: TraePanel): boolean;
  * answer for this field, so the control cannot disagree with the readout.
  */
 declare function creditPosition(config: Config, region: TraeRegion): TraeCreditPosition;
+/**
+ * The user's thinking-level choices for one panel (model id -> DSH level).
+ *
+ * Read through `regionStateOf` so the region split, the legacy CN fallback and
+ * the volatile unwrap all apply exactly once, in one place. Values are filtered
+ * to non-empty strings: an empty string is not a level, and passing one on would
+ * make the model report a default the kernel cannot name.
+ *
+ * A saved level is NOT validated against the model's current tier list here —
+ * that belongs where the tiers are known (`default-effort.ts`
+ * `defaultEffortFor`), which is also where a withdrawn tier is dropped instead
+ * of being sent.
+ */
+declare function thinkingEffortsOf(config: Config, region: TraePanel): Record<string, string>;
+/**
+ * Whether the OPTIONAL sidebar row is switched on (`Config.sidebarPanel`).
+ *
+ * `=== true` on purpose, exactly like the sibling workbuddy reader: the row
+ * claims a GLOBAL sidebar seat every installed bundle shares, so an absent,
+ * unreadable or hand-edited value must read as "the user did not ask for this",
+ * never as consent. Only an explicit boolean `true` turns the row on.
+ *
+ * Read through `unwrapVolatile` because the field is volatile on 0.1.7: the
+ * live `{get(): T}` reference would otherwise be a truthy non-boolean and every
+ * config would look switched on.
+ */
+declare function sidebarPanelEnabled(config: Config): boolean;
 /**
  * Mark a schema's field as volatile.
  *
@@ -4718,4 +4849,4 @@ declare function asVolatile<S>(schema: S): S;
 declare const Config: z<Config>;
 declare function apply(ctx: Context$1, config: Config): void;
 //#endregion
-export { Config, FALLBACK_TRAE_MODELS, FALLBACK_TRAE_MODELS_AI, MAX_PROBE_INPUT_TOKENS, type PiAiGeneration, type PiAiRuntimeInfo, REGION_GATEWAYS, type RawChatDelta, type RawChatMessage, type RawChatTool, SseDecoder, type SseEvent, TRAE_ACCOUNT_STATUS_PATH, TRAE_AI_PROVIDER, TRAE_CHANNEL_PRIORITY, TRAE_CHECKIN_PATH, TRAE_CN_AGENT_TASK_PATH, TRAE_CN_TITLE_PATH, TRAE_COMMON_FUNCTIONS, TRAE_ENTERPRISE_PROVIDER, TRAE_MODELS_TEST_PATH, TRAE_MODEL_DETAIL_FUNCTIONS, TRAE_MODEL_DETAIL_PATH, TRAE_OFFICIAL_ROSTER_PATH, TRAE_PANELS, TRAE_PAY_BASE, TRAE_PROBE_TIMEOUT_MS, TRAE_PROVIDER, TRAE_PROVIDERS, TRAE_PROVIDER_DISPLAY_NAMES, TRAE_PROVIDER_IDS, TRAE_PROVIDER_ID_DISPLAY_NAMES, TRAE_PROVIDER_ROUTES, 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, type TraeFailure, TraeFallbackUpstreamClient, type TraeFallbackUpstreamOptions, type TraeFusionRawChatEnvelope, TraeGatedUpstreamClient, type TraeGatedUpstreamOptions, type TraeIdentity, type TraeInputModality, type TraeModelDetailRequest, type TraeModelGroup, type TraeModelInfo, type TraeModelProbeVerdict, type TraeModelView, type TraeModelsTestResponse, type TraeObservedModelConfig, type TraeOfficialChannel, type TraeOfficialFilterResult, type TraeOfficialRoster, TraeOfficialRosterClient, type TraeOfficialVerdict, type TraeOrderableModel, type TraePanel, type TraeProbeResult, type TraeProbeVerdict, type TraeProviderRoute, 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 TraeWebCheckin, type TraeWebCheckinClaim, type TraeWebCredits, type TraeWebUsage, type TraeWireModel, type TraeWireTarget, UnconfiguredTraeUpstreamClient, adaptLegacyPiAiContext, adaptModernPiAiContext, apply, applyContextBudgets, applyImageSelection, applyOfficialRoster, applyReasoningEffort, asVolatile, bridgeTraeSoloStream, buildTraeAgentTaskBody, buildTraeCnHeaders, buildTraeFusionRawChatEnvelope, buildTraeModelDetailRequest, buildTraeRawChatDraft, buildTraeRawChatRuntimeConfig, classifyProbeError, classifyProbeResult, classifyTraeRawChatFailure, configuredAccountsOf, createTraeAdapter, createTraeRawGateway, createTraeShim, creditPosition, decidePiAiGeneration, decodeRawChatChunk, decodeTraeEvent, decryptTraeStorageValue, deriveCatalog, describeIdShape, describeNameShape, describeTraeFailure, discoveredCatalog, displayNameOfTraeProvider, fallbackModelsFor, filterTraeModels, generationOf, groupTraeModels, hashTraeRawChatArg, identityHeaders, inject, isEnterpriseAccount, isPromotableWireModel, legacyTraeOwnAuthPath, maskUserPath, mergeTraeModelSources, name, nextRegionCreditPosition, nextRegionEnabled, nextRegionSlots, normalizeTraeCredential, normalizeTraeToolSchema, normalizeTraeToolSchemas, normalizeTraeVersionCode, officialVerdictOf, orderTraeModels, panelOfKey, panelOfProvider, parseObservedModelConfig, parseReasoningCapability, parseTraeAuthValue, parseTraeCachedModel, parseTraeModelExtraConfigLogLine, parseTraeOfficialRoster, parseTraeRawChatBehaviorConfig, parseTraeRemoteModel, parseTraeStorageDocument, piAiRuntimeInfo, pickTraeStorageIdentity, prepareSoloBody, probeBody, probeModelsSequentially, probeOneModel, probeTraeRawChatCapability, providerOfPanel, rawCapabilityDiagnostic, rawCapabilityFingerprint, readTraeCachedModel, readTraeCliIdentity, readTraeIdentity, refreshTraeCredential, regionCreditPositionOf, regionEnabled, regionEnabledOf, regionOfCredential, regionOfEdition, regionOfHost, regionOfPanel, regionOfTraeProvider, regionOfTraeStatusUrl, regionOfUserRegion, regionStateOf, registerTraeUsageRoute, resolveTraeIdentity, resolveTraeRawRuntime, routeOfTraeProvider, sanitizeCatalog, scopeTraeModels, settingsNamespaceOf, traeEndpoint, traeInputModalities, traeModelCallChannel, traeModelDisplayName, traeModelInView, traeModelMatchesQuery, traeOwnAuthPath, traeRawChatExtraInfo, traeStateDatabaseCandidates, traeStorageCandidates, traeWebUsage, traeWindowsAppNames, unwrapVolatile, unwrapVolatileDeep, wireTargetsOf, withChatCallableFunctions, withContextAdaptation, withTraeRegion };
+export { Config, FALLBACK_CONTEXT_WINDOW, FALLBACK_TRAE_MODELS, FALLBACK_TRAE_MODELS_AI, MAX_PROBE_INPUT_TOKENS, type PiAiGeneration, type PiAiRuntimeInfo, REGION_GATEWAYS, type RawChatDelta, type RawChatMessage, type RawChatTool, SseDecoder, type SseEvent, TRAE_ACCOUNT_STATUS_PATH, TRAE_AI_PROVIDER, TRAE_CHANNEL_PRIORITY, TRAE_CHECKIN_PATH, TRAE_CN_AGENT_TASK_PATH, TRAE_CN_TITLE_PATH, TRAE_COMMON_FUNCTIONS, TRAE_ENTERPRISE_PROVIDER, TRAE_MODELS_TEST_PATH, TRAE_MODEL_DETAIL_FUNCTIONS, TRAE_MODEL_DETAIL_PATH, TRAE_OFFICIAL_ROSTER_PATH, TRAE_PANELS, TRAE_PAY_BASE, TRAE_PROBE_TIMEOUT_MS, TRAE_PROVIDER, TRAE_PROVIDERS, TRAE_PROVIDER_DISPLAY_NAMES, TRAE_PROVIDER_IDS, TRAE_PROVIDER_ID_DISPLAY_NAMES, TRAE_PROVIDER_ROUTES, 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, type TraeFailure, TraeFallbackUpstreamClient, type TraeFallbackUpstreamOptions, type TraeFusionRawChatEnvelope, TraeGatedUpstreamClient, type TraeGatedUpstreamOptions, type TraeIdentity, type TraeInputModality, type TraeModelDetailRequest, type TraeModelGroup, type TraeModelInfo, type TraeModelProbeVerdict, type TraeModelView, type TraeModelsTestResponse, type TraeObservedModelConfig, type TraeOfficialChannel, type TraeOfficialFilterResult, type TraeOfficialRoster, TraeOfficialRosterClient, type TraeOfficialVerdict, type TraeOrderableModel, type TraePanel, type TraeProbeResult, type TraeProbeVerdict, type TraeProviderRoute, 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 TraeWebCheckin, type TraeWebCheckinClaim, type TraeWebCredits, type TraeWebUsage, type TraeWireModel, type TraeWireTarget, UnconfiguredTraeUpstreamClient, adaptLegacyPiAiContext, adaptModernPiAiContext, apply, applyContextBudgets, applyImageSelection, applyOfficialRoster, applyReasoningEffort, asVolatile, bridgeTraeSoloStream, buildTraeAgentTaskBody, buildTraeCnHeaders, buildTraeFusionRawChatEnvelope, buildTraeModelDetailRequest, buildTraeRawChatDraft, buildTraeRawChatRuntimeConfig, classifyProbeError, classifyProbeResult, classifyTraeRawChatFailure, configuredAccountsOf, createTraeAdapter, createTraeRawGateway, createTraeShim, creditPosition, decidePiAiGeneration, decodeRawChatChunk, decodeTraeEvent, decryptTraeStorageValue, deriveCatalog, describeIdShape, describeNameShape, describeTraeFailure, discoveredCatalog, displayNameOfTraeProvider, fallbackModelsFor, filterTraeModels, generationOf, groupTraeModels, hashTraeRawChatArg, identityHeaders, inject, isEnterpriseAccount, isPromotableWireModel, legacyTraeOwnAuthPath, maskUserPath, mergeTraeModelSources, name, nextRegionCreditPosition, nextRegionEnabled, nextRegionSlots, normalizeTraeCredential, normalizeTraeToolSchema, normalizeTraeToolSchemas, normalizeTraeVersionCode, officialVerdictOf, orderTraeModels, panelOfKey, panelOfProvider, parseObservedModelConfig, parseReasoningCapability, parseTraeAuthValue, parseTraeCachedModel, parseTraeModelExtraConfigLogLine, parseTraeOfficialRoster, parseTraeRawChatBehaviorConfig, parseTraeRemoteModel, parseTraeStorageDocument, piAiRuntimeInfo, pickTraeStorageIdentity, prepareSoloBody, probeBody, probeModelsSequentially, probeOneModel, probeTraeRawChatCapability, providerOfPanel, rawCapabilityDiagnostic, rawCapabilityFingerprint, readTraeCachedModel, readTraeCliIdentity, readTraeIdentity, refreshTraeCredential, regionCreditPositionOf, regionEnabled, regionEnabledOf, regionOfCredential, regionOfEdition, regionOfHost, regionOfPanel, regionOfTraeProvider, regionOfTraeStatusUrl, regionOfUserRegion, regionStateOf, registerTraeUsageRoute, resolveTraeIdentity, resolveTraeRawRuntime, routeOfTraeProvider, sanitizeCatalog, scopeTraeModels, servedContextWindow, settingsNamespaceOf, sidebarPanelEnabled, thinkingEffortsOf, traeEndpoint, traeInputModalities, traeModelCallChannel, traeModelDisplayName, traeModelInView, traeModelMatchesQuery, traeOwnAuthPath, traeRawChatExtraInfo, traeStateDatabaseCandidates, traeStorageCandidates, traeWebUsage, traeWindowsAppNames, unwrapVolatile, unwrapVolatileDeep, wireTargetsOf, withChatCallableFunctions, withContextAdaptation, withTraeRegion };