@everfur/sdk 0.1.0 → 0.3.0

package/dist/client/index.d.cts

@@ -1,16 +1,21 @@
-import { a as EverfurErrorCode } from '../EverfurResult-D92-uL82.cjs';
-export { A as AUTO_RETRYABLE_CODES, B as BACKOFF_BASE_MS, b as BACKOFF_CAP_MS, c as EVERFUR_ERROR_CATEGORIES, d as EVERFUR_ERROR_CODES, e as EverfurConfigError, f as EverfurError, g as EverfurErrorCategory, E as EverfurResult, h as EverfurThrownError, M as MAX_RETRY_ATTEMPTS, i as MakeEverfurErrorOptions, R as RETRYABLE_CONTRACT_CODES, j as backoffDelayMs, k as canRecreateOnNotFound, l as categoryFor, m as err, n as fromHttpStatus, o as fromWire, p as isAutoRetryable, q as isErr, r as isOk, s as isRetryableCode, t as makeEverfurError, u as ok, v as shouldRetry, w as unwrap, x as userFacingError } from '../EverfurResult-D92-uL82.cjs';
-export { A as AcceptedFrame, b as AnalysisCompleteFrame, c as AnalysisStartedFrame, B as ByteSource, C as ClientConfigFailure, d as ClientConfigFailureReason, e as ClientConfigOutcome, D as DEFAULT_CONTRACT_VERSION, f as DeltaFrame, g as DoneFrame, h as EMPTY_FRAME_ARRAYS, i as ENV_API_BASE_URL, j as ErrorFrame, k as EventSourceFactory, l as EventSourceInit, m as EventSourceLike, n as EventSourceMessage, o as EverfurConfig, E as EverfurRequest, p as EverfurRequestBase, q as FetchInit, a as FetchLike, r as FetchResponseLike, F as Frame, s as FrameBase, t as FrameKind, H as HeartbeatFrame, u as HttpMethod, M as MultipartBody, R as RawResponse, v as ReadableStreamLike, w as ResolvedClientConfig, S as SDK_PLATFORM, x as SDK_VERSION, y as ServerRequestIdSource, z as TransportDeps, T as TransportPort, U as UnknownFrame, G as UrgencyLevel, I as acceptedFrame, J as analysisCompleteFrame, K as analysisStartedFrame, L as assertNever, N as bufferedTextByteSource, O as buildBaseHeaders, P as checkPublishableKey, Q as createHttpTransport, V as deltaFrame, W as doneFrame, X as errorFrame, Y as errorFromResponse, Z as eventSourceByteSource, _ as eventSourceRequestId, $ as fetchByteSource, a0 as getGlobalFetch, a1 as heartbeatFrame, a2 as networkError, a3 as parseSse, a4 as requestIdOf, a5 as requestJson, a6 as requestRaw, a7 as resolveApiBaseUrl, a8 as resolveClientConfig, a9 as tryResolveApiBaseUrl, aa as tryResolveClientConfig, ab as unknownFrame } from '../config-BSjBdxrZ.cjs';
-export { B as Brand, C as ClientId, a as ConversationId, D as DocumentId, J as JobId, P as PetRef, R as RecordsRequestId, b as ResponseId, U as UserRef, _ as __brand, c as conversationId, p as petRef, u as unsafeClientId, d as unsafeConversationId, e as unsafeDocumentId, f as unsafeJobId, g as unsafePetRef, h as unsafeRecordsRequestId, i as unsafeResponseId, j as unsafeUserRef, k as userRef } from '../ids-CJ1S6adf.cjs';
-export { A as AuthContext, D as DeviceAuth, I as IdentityProvider, T as TokenProvider, a as authHeaders, b as authedSend, c as createIdentityProvider, n as newSessionId, w as withAuthHeaders } from '../identity-Brl-lDd6.cjs';
-export { C as CapabilityDecision, a as CapabilityDisabled, b as CapabilityName, D as DecideOptions, c as DisabledLevel, E as EntitlementDecision, L as LevelGrant, R as ResolvedEntitlements, d as decideCapability, e as deniedDecisionsFor, r as requires, f as resolveEntitlements } from '../resolve-Dq_4_agU.cjs';
-export { C as ClientBranding, E as ENTITLEMENTS_PATH, a as EVERFUR_DARK, b as EVERFUR_LIGHT, c as EntitlementResolution, d as EverfurColorTokens, e as EverfurFontWeight, f as EverfurLetterSpacingTokens, g as EverfurLineHeightTokens, h as EverfurMotionDurationTokens, i as EverfurMotionTokens, j as EverfurRadiusTokens, k as EverfurSpaceTokens, l as EverfurSpringToken, m as EverfurTextColorTokens, n as EverfurTheme, o as EverfurThemeMeta, p as EverfurTypeSizeTokens, q as EverfurTypeTokens, r as EverfurWeightTokens, F as FetchEntitlementsArgs, P as PET_AGE_YEARS_MAX, s as PET_BREED_MAX, t as PET_NAME_MAX, u as PET_SPECIES_MAX, v as PET_WEIGHT_KG_MAX, w as PetProfileInput, x as PetsRepository, R as RegisteredPet, y as ResolveThemeInput, z as createPetsRepository, A as deepFreeze, B as fetchEntitlements, D as hardenHttpsUrl, G as isEmptyBranding, H as parseClientBranding, I as parseColor, J as readableOn, K as resolveTheme, L as withServerBranding } from '../petsRepository-BEGb97M9.cjs';
-import '../requestFunnel-DuUH-kAe.cjs';
+import { b as EverfurErrorCode } from '../EverfurResult-DN9pL2Ab.cjs';
+export { A as AUTO_RETRYABLE_CODES, B as BACKOFF_BASE_MS, k as BACKOFF_CAP_MS, l as EVERFUR_ERROR_CATEGORIES, m as EVERFUR_ERROR_CODES, d as EverfurConfigError, E as EverfurError, a as EverfurErrorCategory, c as EverfurResult, e as EverfurThrownError, M as MAX_RETRY_ATTEMPTS, n as MakeEverfurErrorOptions, R as RETRYABLE_CONTRACT_CODES, o as backoffDelayMs, p as canRecreateOnNotFound, f as categoryFor, q as err, r as fromHttpStatus, s as fromWire, t as isAutoRetryable, i as isErr, g as isOk, h as isRetryableCode, v as makeEverfurError, w as ok, x as shouldRetry, u as unwrap, j as userFacingError } from '../EverfurResult-DN9pL2Ab.cjs';
+export { A as AcceptedFrame, a as AnalysisCompleteFrame, b as AnalysisStartedFrame, B as ByteSource, C as ClientConfigFailure, k as ClientConfigFailureReason, l as ClientConfigOutcome, m as DEFAULT_CONTRACT_VERSION, D as DeltaFrame, c as DoneFrame, n as EMPTY_FRAME_ARRAYS, o as ENV_API_BASE_URL, E as ErrorFrame, p as EventSourceFactory, q as EventSourceInit, r as EventSourceLike, s as EventSourceMessage, t as EverfurConfig, d as EverfurRequest, e as EverfurRequestBase, u as FetchInit, j as FetchLike, v as FetchResponseLike, F as Frame, f as FrameBase, g as FrameKind, H as HeartbeatFrame, h as HttpMethod, M as MultipartBody, R as RawResponse, w as ReadableStreamLike, x as ResolveClientConfigOptions, y as ResolvedClientConfig, S as SDK_PLATFORM, z as SDK_VERSION, G as SdkPlatform, I as ServerRequestIdSource, J as TransportDeps, T as TransportPort, U as UnknownFrame, i as UrgencyLevel, K as acceptedFrame, L as analysisCompleteFrame, N as analysisStartedFrame, O as assertNever, P as bufferedTextByteSource, Q as buildBaseHeaders, V as checkPublishableKey, W as createHttpTransport, X as deltaFrame, Y as doneFrame, Z as errorFrame, _ as errorFromResponse, $ as eventSourceByteSource, a0 as eventSourceRequestId, a1 as fetchByteSource, a2 as getGlobalFetch, a3 as heartbeatFrame, a4 as networkError, a5 as parseSse, a6 as requestIdOf, a7 as requestJson, a8 as requestRaw, a9 as resolveApiBaseUrl, aa as resolveClientConfig, ab as tryResolveApiBaseUrl, ac as tryResolveClientConfig, ad as unknownFrame } from '../config-CzTZGlfF.cjs';
+export { B as Brand, a as ClientId, C as ConversationId, D as DocumentId, J as JobId, P as PetRef, R as RecordsRequestId, b as ResponseId, U as UserRef, _ as __brand, c as conversationId, p as petRef, d as unsafeClientId, e as unsafeConversationId, f as unsafeDocumentId, g as unsafeJobId, h as unsafePetRef, i as unsafeRecordsRequestId, j as unsafeResponseId, k as unsafeUserRef, u as userRef } from '../ids-B2GAAifq.cjs';
+export { A as AuthContext, D as DeviceAuth, I as IdentityProvider, M as MintedToken, T as TokenProvider, a as authHeaders, b as authedSend, c as createIdentityProvider, n as newSessionId, w as withAuthHeaders } from '../identity-DI4eVx9S.cjs';
+export { a as CapabilityDecision, b as CapabilityDisabled, C as CapabilityName, c as DecideOptions, D as DisabledLevel, E as EntitlementDecision, L as LevelGrant, R as ResolvedEntitlements, d as decideCapability, e as deniedDecisionsFor, r as requires, f as resolveEntitlements } from '../resolve-D4Ywz5OS.cjs';
+import { a as EverfurTheme } from '../entitlementRepository-DKdXFgTo.cjs';
+export { C as ClientBranding, D as DEFAULT_MAX_FONT_SCALE, F as EASING_CURVES, G as ENTITLEMENTS_PATH, H as EVERFUR_DARK, I as EVERFUR_LIGHT, J as EntitlementResolution, d as EverfurColorTokens, K as EverfurEasingCurve, b as EverfurFontFaceKey, e as EverfurFontFamilies, E as EverfurFontWeight, f as EverfurLetterSpacingTokens, g as EverfurLineHeightTokens, h as EverfurMotionDurationTokens, i as EverfurMotionTokens, j as EverfurRadiusTokens, k as EverfurSpaceTokens, l as EverfurSpringToken, m as EverfurTextColorTokens, L as EverfurTextScaleTier, n as EverfurThemeFontFaceKey, o as EverfurThemeFontUrlsInput, p as EverfurThemeFontsInput, c as EverfurThemeInput, q as EverfurThemeMeta, r as EverfurThemeSlot, s as EverfurThemeSlotInput, t as EverfurThemeSlotKey, u as EverfurThemeSlotName, v as EverfurThemeSlots, w as EverfurThemeSlotsInput, x as EverfurTypeSizeTokens, y as EverfurTypeTokens, z as EverfurWeightTokens, M as FetchEntitlementsArgs, N as LOCKABLE_THEME_FIELDS, O as LockableThemeField, P as MAX_FONT_SCALE_CEILING, R as RadiusScale, Q as ResolveThemeInput, U as SLOT_LOCK_PREFIX, V as SLOT_MIN_BORDER_CONTRAST, W as SLOT_MIN_CONTRAST, X as SYSTEM_FONT_FAMILY, Y as SYSTEM_MONO_FAMILY, Z as SlotGrounds, _ as SlotLockName, S as SurfaceStyle, $ as TEXT_SCALE_FLOOR, a0 as TEXT_SCALE_TIER_CAPS, a1 as THEME_SCHEMA_VERSIONS, T as THEME_SLOT_KEYS, A as THEME_SLOT_NAMES, a2 as ThemeLockName, a3 as cssCubicBezier, a4 as deepFreeze, a5 as fetchEntitlements, a6 as guardSlotContrast, a7 as hardenHttpsUrl, a8 as isEmptyBranding, a9 as isKnownBrandingSchema, aa as lockedFieldsOf, ab as mergeThemeSlots, ac as parseClientBranding, ad as parseThemeSlots, B as previewTheme, ae as resolveTheme, af as withServerBranding } from '../entitlementRepository-DKdXFgTo.cjs';
+export { F as FunnelSendOptions, R as RequestFunnel, a as RequestFunnelDeps, c as createRequestFunnel } from '../requestFunnel-L-BQfi0z.cjs';
+export { E as EverfurFaceStyle, f as face } from '../typeStyle-0TydiZ1w.cjs';
+export { e as CHECKIN_ANSWERS, f as CasesRepository, C as CheckinAnswer, a as CheckinOutcome, g as PET_AGE_YEARS_MAX, h as PET_BREED_MAX, i as PET_NAME_MAX, j as PET_SPECIES_MAX, k as PET_WEIGHT_KG_MAX, P as PetProfileInput, c as PetProfilePatch, l as PetsRepository, R as RegisteredPet, W as WatchCase, b as WidgetPet, m as createCasesRepository, n as createPetsRepository, w as widgetPetFromWire } from '../casesRepository-DHwtGRYY.cjs';
+import '../ErrorPolicyPort-CNf4uQZP.cjs';
+import '../profile-CSs1wlXT.cjs';
 
 /** Which wire shape a code arrives in. The two envelopes are different objects, not casings. */
-type ContractErrorEnvelope = "http_envelope" | "sse_frame";
+type ContractErrorEnvelope = "http_envelope" | "oauth_error" | "sse_frame";
 /** Every wire error code the contract declares, spelled EXACTLY as the server sends it. */
-type ContractWireErrorCode = "AccessDeniedException" | "AuthorizationException" | "ConflictException" | "DAILY_QUOTA_EXCEEDED" | "IDEMPOTENCY_KEY_IN_FLIGHT" | "IDEMPOTENCY_KEY_REUSED_DIFFERENT_REQUEST" | "InternalFailureException" | "NotImplementedException" | "PaymentRequiredException" | "ResourceNotFoundException" | "ServiceUnavailableException" | "TIER_UPGRADE_REQUIRED" | "ThrottlingException" | "ValidationException" | "accessDenied" | "authExpired" | "internal_error" | "invalidRequest" | "not_found" | "session_required" | "timeout" | "unavailable";
+type ContractWireErrorCode = "AccessDeniedException" | "AuthorizationException" | "ConflictException" | "DAILY_QUOTA_EXCEEDED" | "FILE_TOO_LARGE" | "IDEMPOTENCY_KEY_IN_FLIGHT" | "IDEMPOTENCY_KEY_REUSED_DIFFERENT_REQUEST" | "INVALID_CONTENT_TYPE" | "InternalFailureException" | "MethodNotAllowedException" | "NotImplementedException" | "PaymentRequiredException" | "ResourceNotFoundException" | "ServiceUnavailableException" | "TIER_UPGRADE_REQUIRED" | "ThrottlingException" | "ValidationException" | "accessDenied" | "access_denied" | "attachment_unreadable" | "authExpired" | "authRejected" | "consent_invalid" | "consent_required" | "consent_scope_wrong_route" | "device_cipher_unavailable" | "email_invalid" | "event_cursor_invalid" | "event_filter_invalid" | "event_payload_invalid" | "event_type_not_available" | "event_type_unknown" | "idempotency_key_invalid" | "idempotency_key_required" | "idempotency_key_reused" | "insufficientCapability" | "insufficient_scope" | "internal_error" | "invalidRequest" | "invalid_client" | "invalid_client_metadata" | "invalid_grant" | "invalid_redirect_uri" | "invalid_request" | "invalid_scope" | "invalid_target" | "mcp_connection_not_found" | "mcp_request_conflict" | "mcp_request_gone" | "mcp_request_not_found" | "not_found" | "partner_visit_link_conflict" | "partner_visit_owner_only" | "partner_visit_pet_already_mapped" | "payload_too_large" | "petRefInUse" | "pet_health_list_removals_unconfirmed" | "pet_health_species_unsupported" | "pet_not_registered" | "provider_unsupported" | "rateLimited" | "record_species_unsupported" | "record_subject_not_found" | "record_upload_invalid" | "records_consent_required" | "sandbox_only" | "session_required" | "share_limit_reached" | "slow_down" | "species_unsupported" | "tenant_filter_invalid" | "tenant_has_no_capabilities" | "tenant_resource_not_found" | "tenant_surface_not_enabled" | "timeout" | "token_invalid" | "unavailable" | "unsupported_grant_type" | "unsupported_response_type" | "verify_mint_rate_limited" | "verify_mint_refused" | "verify_mint_unavailable" | "verify_user_ref_invalid" | "webhook_endpoint_update_empty" | "webhook_endpoint_update_invalid" | "webhook_url_rejected";
 
 /** One registry row, reduced to the facts the SDK needs at runtime. */
 interface ContractErrorRow {
@@ -34,14 +39,23 @@ interface ContractErrorRow {
  * exhaustive, so a code added to the contract fails `tsc` here rather than silently becoming `unknown`.
  */
 declare const CONTRACT_ERROR_ROWS: readonly ContractErrorRow[];
-/** The registry row for a raw wire code, or undefined when the code is not in the contract. */
-declare function contractErrorFor(wireCode: string | null | undefined): ContractErrorRow | undefined;
+/**
+ * The registry row for a raw wire code, or undefined when the code is not in the contract.
+ *
+ * A code can ride SEVERAL envelopes as one row each (`unavailable`: the 503 body and the SSE frame a partner chat
+ * turn ends with). Pass the envelope the code arrived in when it is known (an SSE frame passes `'sse_frame'`) so
+ * such a code resolves to its own row; without one the HTTP row answers, as it did before the second row existed,
+ * and then every other envelope is searched in a fixed order. A code registered on only one envelope resolves
+ * whichever envelope is passed.
+ */
+declare function contractErrorFor(wireCode: string | null | undefined, envelope?: ContractErrorEnvelope): ContractErrorRow | undefined;
 /**
  * The registry's `doc_url` for a row. SITE-RELATIVE by construction: the contract records that there is
  * no confirmed public documentation host to prefix it with, so the SDK publishes the path and never
  * fabricates an origin. The SSE frames are namespaced (`#sse-timeout`) because a frame code and an HTTP
- * code can share a name; `tests/contract/errorRegistry.test.ts` asserts this derivation reproduces the
- * registry's own `doc_url` for all 22 rows, so the pattern cannot drift unnoticed.
+ * code can share a name, and the hosted MCP's OAuth codes the same way (`#oauth-invalid_grant`);
+ * `tests/contract/errorRegistry.test.ts` asserts this derivation reproduces the registry's own `doc_url`
+ * for every row, so the pattern cannot drift unnoticed.
  */
 declare function contractDocUrl(entry: ContractErrorRow): string;
 /**
@@ -62,4 +76,52 @@ declare const DOC_SITE_ORIGIN: string | null;
 /** The emitted `docUrl`, or null while no page exists to point at. */
 declare function publishedDocUrl(entry: ContractErrorRow): string | null;
 
-export { CONTRACT_ERROR_ROWS, type ContractErrorEnvelope, type ContractErrorRow, type ContractWireErrorCode, DOC_SITE_ORIGIN, EverfurErrorCode, contractDocUrl, contractErrorFor, publishedDocUrl };
+/**
+ * Parse a permissive colour into a normalized string (`#RRGGBB` when opaque, else `rgba(r,g,b,a)`), or null.
+ * Accepts `#RGB`, `#RRGGBB`, `#AARRGGBB`, `0xAARRGGBB` (string), a 32-bit ARGB `int`, and `rgb()/rgba()`.
+ * An empty string, whitespace, or an unrecognized value yields null.
+ */
+declare function parseColor(value: unknown): string | null;
+/**
+ * Return the more legible of near-black / white for `background` (WCAG 2.x contrast). Ported from Flutter
+ * `_readableOn`. Falls back to white for an unparseable background (never throws).
+ */
+declare function readableOn(background: string): string;
+/**
+ * The WCAG contrast ratio between two colours (1..21). A translucent colour is composited onto the other before
+ * measuring, since that is what the eye sees. An unparseable colour measures as 1 (no contrast), never throws.
+ */
+declare function contrastRatio(a: string, b: string): number;
+
+/** The SDK's dark `surfaceCream` (EVERFUR_DARK.color.surfaceCream): what the variant must read on. */
+declare const DARK_VARIANT_GROUND = "#23272C";
+/** The ratio the variant must reach on that ground and under the better of the two SDK inks (WCAG AA). */
+declare const DARK_VARIANT_TARGET_RATIO = 4.5;
+/** The tint band the lightness is clamped into, and the step it climbs by (HSL lightness, 0..1). */
+declare const DARK_VARIANT_LIGHTNESS_FLOOR = 0.6;
+declare const DARK_VARIANT_LIGHTNESS_CEILING = 0.9;
+declare const DARK_VARIANT_LIGHTNESS_STEP = 0.02;
+/**
+ * The dark-scheme twin of a light branding colour. The algorithm, step for step (the backend docstring is the
+ * reference; tests/unit/fixtures/dark_variant_vectors.json is the acceptance test):
+ *   1. parse the colour (any form `parseColor` reads; the backend takes `#RRGGBB` only);
+ *   2. HSL; keep h and s;
+ *   3. clamp l into 0.60..0.90 (a dark brand colour is lifted to the floor; a mid or light one keeps its
+ *      lightness, capped);
+ *   4. for l_i = l_dark + i * 0.02 while l_i <= 0.90, return the first candidate that reaches 4.5:1 on the dark
+ *      surface AND 4.5:1 under the better of white / near-black;
+ *   5. else the colour at the ceiling.
+ * Uppercase `#RRGGBB`; null for an unparseable colour (the backend raises there). Idempotent.
+ */
+declare function deriveDarkVariant(color: string): string | null;
+/** The ratio text and borders are pushed toward under `prefers-contrast: more` (WCAG AAA body text). */
+declare const HIGH_CONTRAST_TARGET_RATIO = 7;
+/**
+ * The high-contrast derivation of a resolved theme. Text tokens and borders reach `HIGH_CONTRAST_TARGET_RATIO` on
+ * the palette's hardest surface (pushed toward black on light, white on dark); translucent washes become solid
+ * fills over `surface`. `onPrimary`/`onAccent` are left as the resolver computed them (already the legible pole).
+ * Pure: a new deeply-frozen theme with `highContrast: true`; the input is never mutated. Idempotent.
+ */
+declare function deriveHighContrast(theme: EverfurTheme): EverfurTheme;
+
+export { CONTRACT_ERROR_ROWS, type ContractErrorEnvelope, type ContractErrorRow, type ContractWireErrorCode, DARK_VARIANT_GROUND, DARK_VARIANT_LIGHTNESS_CEILING, DARK_VARIANT_LIGHTNESS_FLOOR, DARK_VARIANT_LIGHTNESS_STEP, DARK_VARIANT_TARGET_RATIO, DOC_SITE_ORIGIN, EverfurErrorCode, EverfurTheme, HIGH_CONTRAST_TARGET_RATIO, contractDocUrl, contractErrorFor, contrastRatio, deriveDarkVariant, deriveHighContrast, parseColor, publishedDocUrl, readableOn };

package/dist/client/index.d.ts

@@ -1,16 +1,21 @@
-import { a as EverfurErrorCode } from '../EverfurResult-D92-uL82.js';
-export { A as AUTO_RETRYABLE_CODES, B as BACKOFF_BASE_MS, b as BACKOFF_CAP_MS, c as EVERFUR_ERROR_CATEGORIES, d as EVERFUR_ERROR_CODES, e as EverfurConfigError, f as EverfurError, g as EverfurErrorCategory, E as EverfurResult, h as EverfurThrownError, M as MAX_RETRY_ATTEMPTS, i as MakeEverfurErrorOptions, R as RETRYABLE_CONTRACT_CODES, j as backoffDelayMs, k as canRecreateOnNotFound, l as categoryFor, m as err, n as fromHttpStatus, o as fromWire, p as isAutoRetryable, q as isErr, r as isOk, s as isRetryableCode, t as makeEverfurError, u as ok, v as shouldRetry, w as unwrap, x as userFacingError } from '../EverfurResult-D92-uL82.js';
-export { A as AcceptedFrame, b as AnalysisCompleteFrame, c as AnalysisStartedFrame, B as ByteSource, C as ClientConfigFailure, d as ClientConfigFailureReason, e as ClientConfigOutcome, D as DEFAULT_CONTRACT_VERSION, f as DeltaFrame, g as DoneFrame, h as EMPTY_FRAME_ARRAYS, i as ENV_API_BASE_URL, j as ErrorFrame, k as EventSourceFactory, l as EventSourceInit, m as EventSourceLike, n as EventSourceMessage, o as EverfurConfig, E as EverfurRequest, p as EverfurRequestBase, q as FetchInit, a as FetchLike, r as FetchResponseLike, F as Frame, s as FrameBase, t as FrameKind, H as HeartbeatFrame, u as HttpMethod, M as MultipartBody, R as RawResponse, v as ReadableStreamLike, w as ResolvedClientConfig, S as SDK_PLATFORM, x as SDK_VERSION, y as ServerRequestIdSource, z as TransportDeps, T as TransportPort, U as UnknownFrame, G as UrgencyLevel, I as acceptedFrame, J as analysisCompleteFrame, K as analysisStartedFrame, L as assertNever, N as bufferedTextByteSource, O as buildBaseHeaders, P as checkPublishableKey, Q as createHttpTransport, V as deltaFrame, W as doneFrame, X as errorFrame, Y as errorFromResponse, Z as eventSourceByteSource, _ as eventSourceRequestId, $ as fetchByteSource, a0 as getGlobalFetch, a1 as heartbeatFrame, a2 as networkError, a3 as parseSse, a4 as requestIdOf, a5 as requestJson, a6 as requestRaw, a7 as resolveApiBaseUrl, a8 as resolveClientConfig, a9 as tryResolveApiBaseUrl, aa as tryResolveClientConfig, ab as unknownFrame } from '../config-CiJ0PVBB.js';
-export { B as Brand, C as ClientId, a as ConversationId, D as DocumentId, J as JobId, P as PetRef, R as RecordsRequestId, b as ResponseId, U as UserRef, _ as __brand, c as conversationId, p as petRef, u as unsafeClientId, d as unsafeConversationId, e as unsafeDocumentId, f as unsafeJobId, g as unsafePetRef, h as unsafeRecordsRequestId, i as unsafeResponseId, j as unsafeUserRef, k as userRef } from '../ids-CJ1S6adf.js';
-export { A as AuthContext, D as DeviceAuth, I as IdentityProvider, T as TokenProvider, a as authHeaders, b as authedSend, c as createIdentityProvider, n as newSessionId, w as withAuthHeaders } from '../identity-DK9zORrG.js';
-export { C as CapabilityDecision, a as CapabilityDisabled, b as CapabilityName, D as DecideOptions, c as DisabledLevel, E as EntitlementDecision, L as LevelGrant, R as ResolvedEntitlements, d as decideCapability, e as deniedDecisionsFor, r as requires, f as resolveEntitlements } from '../resolve-Dq_4_agU.js';
-export { C as ClientBranding, E as ENTITLEMENTS_PATH, a as EVERFUR_DARK, b as EVERFUR_LIGHT, c as EntitlementResolution, d as EverfurColorTokens, e as EverfurFontWeight, f as EverfurLetterSpacingTokens, g as EverfurLineHeightTokens, h as EverfurMotionDurationTokens, i as EverfurMotionTokens, j as EverfurRadiusTokens, k as EverfurSpaceTokens, l as EverfurSpringToken, m as EverfurTextColorTokens, n as EverfurTheme, o as EverfurThemeMeta, p as EverfurTypeSizeTokens, q as EverfurTypeTokens, r as EverfurWeightTokens, F as FetchEntitlementsArgs, P as PET_AGE_YEARS_MAX, s as PET_BREED_MAX, t as PET_NAME_MAX, u as PET_SPECIES_MAX, v as PET_WEIGHT_KG_MAX, w as PetProfileInput, x as PetsRepository, R as RegisteredPet, y as ResolveThemeInput, z as createPetsRepository, A as deepFreeze, B as fetchEntitlements, D as hardenHttpsUrl, G as isEmptyBranding, H as parseClientBranding, I as parseColor, J as readableOn, K as resolveTheme, L as withServerBranding } from '../petsRepository-Bu18r2kK.js';
-import '../requestFunnel-dio5OmR9.js';
+import { b as EverfurErrorCode } from '../EverfurResult-DN9pL2Ab.js';
+export { A as AUTO_RETRYABLE_CODES, B as BACKOFF_BASE_MS, k as BACKOFF_CAP_MS, l as EVERFUR_ERROR_CATEGORIES, m as EVERFUR_ERROR_CODES, d as EverfurConfigError, E as EverfurError, a as EverfurErrorCategory, c as EverfurResult, e as EverfurThrownError, M as MAX_RETRY_ATTEMPTS, n as MakeEverfurErrorOptions, R as RETRYABLE_CONTRACT_CODES, o as backoffDelayMs, p as canRecreateOnNotFound, f as categoryFor, q as err, r as fromHttpStatus, s as fromWire, t as isAutoRetryable, i as isErr, g as isOk, h as isRetryableCode, v as makeEverfurError, w as ok, x as shouldRetry, u as unwrap, j as userFacingError } from '../EverfurResult-DN9pL2Ab.js';
+export { A as AcceptedFrame, a as AnalysisCompleteFrame, b as AnalysisStartedFrame, B as ByteSource, C as ClientConfigFailure, k as ClientConfigFailureReason, l as ClientConfigOutcome, m as DEFAULT_CONTRACT_VERSION, D as DeltaFrame, c as DoneFrame, n as EMPTY_FRAME_ARRAYS, o as ENV_API_BASE_URL, E as ErrorFrame, p as EventSourceFactory, q as EventSourceInit, r as EventSourceLike, s as EventSourceMessage, t as EverfurConfig, d as EverfurRequest, e as EverfurRequestBase, u as FetchInit, j as FetchLike, v as FetchResponseLike, F as Frame, f as FrameBase, g as FrameKind, H as HeartbeatFrame, h as HttpMethod, M as MultipartBody, R as RawResponse, w as ReadableStreamLike, x as ResolveClientConfigOptions, y as ResolvedClientConfig, S as SDK_PLATFORM, z as SDK_VERSION, G as SdkPlatform, I as ServerRequestIdSource, J as TransportDeps, T as TransportPort, U as UnknownFrame, i as UrgencyLevel, K as acceptedFrame, L as analysisCompleteFrame, N as analysisStartedFrame, O as assertNever, P as bufferedTextByteSource, Q as buildBaseHeaders, V as checkPublishableKey, W as createHttpTransport, X as deltaFrame, Y as doneFrame, Z as errorFrame, _ as errorFromResponse, $ as eventSourceByteSource, a0 as eventSourceRequestId, a1 as fetchByteSource, a2 as getGlobalFetch, a3 as heartbeatFrame, a4 as networkError, a5 as parseSse, a6 as requestIdOf, a7 as requestJson, a8 as requestRaw, a9 as resolveApiBaseUrl, aa as resolveClientConfig, ab as tryResolveApiBaseUrl, ac as tryResolveClientConfig, ad as unknownFrame } from '../config-DW60uRb9.js';
+export { B as Brand, a as ClientId, C as ConversationId, D as DocumentId, J as JobId, P as PetRef, R as RecordsRequestId, b as ResponseId, U as UserRef, _ as __brand, c as conversationId, p as petRef, d as unsafeClientId, e as unsafeConversationId, f as unsafeDocumentId, g as unsafeJobId, h as unsafePetRef, i as unsafeRecordsRequestId, j as unsafeResponseId, k as unsafeUserRef, u as userRef } from '../ids-B2GAAifq.js';
+export { A as AuthContext, D as DeviceAuth, I as IdentityProvider, M as MintedToken, T as TokenProvider, a as authHeaders, b as authedSend, c as createIdentityProvider, n as newSessionId, w as withAuthHeaders } from '../identity-BMx2SUOM.js';
+export { a as CapabilityDecision, b as CapabilityDisabled, C as CapabilityName, c as DecideOptions, D as DisabledLevel, E as EntitlementDecision, L as LevelGrant, R as ResolvedEntitlements, d as decideCapability, e as deniedDecisionsFor, r as requires, f as resolveEntitlements } from '../resolve-D4Ywz5OS.js';
+import { a as EverfurTheme } from '../entitlementRepository-DSbzuyAW.js';
+export { C as ClientBranding, D as DEFAULT_MAX_FONT_SCALE, F as EASING_CURVES, G as ENTITLEMENTS_PATH, H as EVERFUR_DARK, I as EVERFUR_LIGHT, J as EntitlementResolution, d as EverfurColorTokens, K as EverfurEasingCurve, b as EverfurFontFaceKey, e as EverfurFontFamilies, E as EverfurFontWeight, f as EverfurLetterSpacingTokens, g as EverfurLineHeightTokens, h as EverfurMotionDurationTokens, i as EverfurMotionTokens, j as EverfurRadiusTokens, k as EverfurSpaceTokens, l as EverfurSpringToken, m as EverfurTextColorTokens, L as EverfurTextScaleTier, n as EverfurThemeFontFaceKey, o as EverfurThemeFontUrlsInput, p as EverfurThemeFontsInput, c as EverfurThemeInput, q as EverfurThemeMeta, r as EverfurThemeSlot, s as EverfurThemeSlotInput, t as EverfurThemeSlotKey, u as EverfurThemeSlotName, v as EverfurThemeSlots, w as EverfurThemeSlotsInput, x as EverfurTypeSizeTokens, y as EverfurTypeTokens, z as EverfurWeightTokens, M as FetchEntitlementsArgs, N as LOCKABLE_THEME_FIELDS, O as LockableThemeField, P as MAX_FONT_SCALE_CEILING, R as RadiusScale, Q as ResolveThemeInput, U as SLOT_LOCK_PREFIX, V as SLOT_MIN_BORDER_CONTRAST, W as SLOT_MIN_CONTRAST, X as SYSTEM_FONT_FAMILY, Y as SYSTEM_MONO_FAMILY, Z as SlotGrounds, _ as SlotLockName, S as SurfaceStyle, $ as TEXT_SCALE_FLOOR, a0 as TEXT_SCALE_TIER_CAPS, a1 as THEME_SCHEMA_VERSIONS, T as THEME_SLOT_KEYS, A as THEME_SLOT_NAMES, a2 as ThemeLockName, a3 as cssCubicBezier, a4 as deepFreeze, a5 as fetchEntitlements, a6 as guardSlotContrast, a7 as hardenHttpsUrl, a8 as isEmptyBranding, a9 as isKnownBrandingSchema, aa as lockedFieldsOf, ab as mergeThemeSlots, ac as parseClientBranding, ad as parseThemeSlots, B as previewTheme, ae as resolveTheme, af as withServerBranding } from '../entitlementRepository-DSbzuyAW.js';
+export { F as FunnelSendOptions, R as RequestFunnel, a as RequestFunnelDeps, c as createRequestFunnel } from '../requestFunnel-CjW7uDuA.js';
+export { E as EverfurFaceStyle, f as face } from '../typeStyle-CWMsoe6b.js';
+export { e as CHECKIN_ANSWERS, f as CasesRepository, C as CheckinAnswer, a as CheckinOutcome, g as PET_AGE_YEARS_MAX, h as PET_BREED_MAX, i as PET_NAME_MAX, j as PET_SPECIES_MAX, k as PET_WEIGHT_KG_MAX, P as PetProfileInput, c as PetProfilePatch, l as PetsRepository, R as RegisteredPet, W as WatchCase, b as WidgetPet, m as createCasesRepository, n as createPetsRepository, w as widgetPetFromWire } from '../casesRepository-ClLv6qMl.js';
+import '../ErrorPolicyPort-CwbfmxzJ.js';
+import '../profile-CSs1wlXT.js';
 
 /** Which wire shape a code arrives in. The two envelopes are different objects, not casings. */
-type ContractErrorEnvelope = "http_envelope" | "sse_frame";
+type ContractErrorEnvelope = "http_envelope" | "oauth_error" | "sse_frame";
 /** Every wire error code the contract declares, spelled EXACTLY as the server sends it. */
-type ContractWireErrorCode = "AccessDeniedException" | "AuthorizationException" | "ConflictException" | "DAILY_QUOTA_EXCEEDED" | "IDEMPOTENCY_KEY_IN_FLIGHT" | "IDEMPOTENCY_KEY_REUSED_DIFFERENT_REQUEST" | "InternalFailureException" | "NotImplementedException" | "PaymentRequiredException" | "ResourceNotFoundException" | "ServiceUnavailableException" | "TIER_UPGRADE_REQUIRED" | "ThrottlingException" | "ValidationException" | "accessDenied" | "authExpired" | "internal_error" | "invalidRequest" | "not_found" | "session_required" | "timeout" | "unavailable";
+type ContractWireErrorCode = "AccessDeniedException" | "AuthorizationException" | "ConflictException" | "DAILY_QUOTA_EXCEEDED" | "FILE_TOO_LARGE" | "IDEMPOTENCY_KEY_IN_FLIGHT" | "IDEMPOTENCY_KEY_REUSED_DIFFERENT_REQUEST" | "INVALID_CONTENT_TYPE" | "InternalFailureException" | "MethodNotAllowedException" | "NotImplementedException" | "PaymentRequiredException" | "ResourceNotFoundException" | "ServiceUnavailableException" | "TIER_UPGRADE_REQUIRED" | "ThrottlingException" | "ValidationException" | "accessDenied" | "access_denied" | "attachment_unreadable" | "authExpired" | "authRejected" | "consent_invalid" | "consent_required" | "consent_scope_wrong_route" | "device_cipher_unavailable" | "email_invalid" | "event_cursor_invalid" | "event_filter_invalid" | "event_payload_invalid" | "event_type_not_available" | "event_type_unknown" | "idempotency_key_invalid" | "idempotency_key_required" | "idempotency_key_reused" | "insufficientCapability" | "insufficient_scope" | "internal_error" | "invalidRequest" | "invalid_client" | "invalid_client_metadata" | "invalid_grant" | "invalid_redirect_uri" | "invalid_request" | "invalid_scope" | "invalid_target" | "mcp_connection_not_found" | "mcp_request_conflict" | "mcp_request_gone" | "mcp_request_not_found" | "not_found" | "partner_visit_link_conflict" | "partner_visit_owner_only" | "partner_visit_pet_already_mapped" | "payload_too_large" | "petRefInUse" | "pet_health_list_removals_unconfirmed" | "pet_health_species_unsupported" | "pet_not_registered" | "provider_unsupported" | "rateLimited" | "record_species_unsupported" | "record_subject_not_found" | "record_upload_invalid" | "records_consent_required" | "sandbox_only" | "session_required" | "share_limit_reached" | "slow_down" | "species_unsupported" | "tenant_filter_invalid" | "tenant_has_no_capabilities" | "tenant_resource_not_found" | "tenant_surface_not_enabled" | "timeout" | "token_invalid" | "unavailable" | "unsupported_grant_type" | "unsupported_response_type" | "verify_mint_rate_limited" | "verify_mint_refused" | "verify_mint_unavailable" | "verify_user_ref_invalid" | "webhook_endpoint_update_empty" | "webhook_endpoint_update_invalid" | "webhook_url_rejected";
 
 /** One registry row, reduced to the facts the SDK needs at runtime. */
 interface ContractErrorRow {
@@ -34,14 +39,23 @@ interface ContractErrorRow {
  * exhaustive, so a code added to the contract fails `tsc` here rather than silently becoming `unknown`.
  */
 declare const CONTRACT_ERROR_ROWS: readonly ContractErrorRow[];
-/** The registry row for a raw wire code, or undefined when the code is not in the contract. */
-declare function contractErrorFor(wireCode: string | null | undefined): ContractErrorRow | undefined;
+/**
+ * The registry row for a raw wire code, or undefined when the code is not in the contract.
+ *
+ * A code can ride SEVERAL envelopes as one row each (`unavailable`: the 503 body and the SSE frame a partner chat
+ * turn ends with). Pass the envelope the code arrived in when it is known (an SSE frame passes `'sse_frame'`) so
+ * such a code resolves to its own row; without one the HTTP row answers, as it did before the second row existed,
+ * and then every other envelope is searched in a fixed order. A code registered on only one envelope resolves
+ * whichever envelope is passed.
+ */
+declare function contractErrorFor(wireCode: string | null | undefined, envelope?: ContractErrorEnvelope): ContractErrorRow | undefined;
 /**
  * The registry's `doc_url` for a row. SITE-RELATIVE by construction: the contract records that there is
  * no confirmed public documentation host to prefix it with, so the SDK publishes the path and never
  * fabricates an origin. The SSE frames are namespaced (`#sse-timeout`) because a frame code and an HTTP
- * code can share a name; `tests/contract/errorRegistry.test.ts` asserts this derivation reproduces the
- * registry's own `doc_url` for all 22 rows, so the pattern cannot drift unnoticed.
+ * code can share a name, and the hosted MCP's OAuth codes the same way (`#oauth-invalid_grant`);
+ * `tests/contract/errorRegistry.test.ts` asserts this derivation reproduces the registry's own `doc_url`
+ * for every row, so the pattern cannot drift unnoticed.
  */
 declare function contractDocUrl(entry: ContractErrorRow): string;
 /**
@@ -62,4 +76,52 @@ declare const DOC_SITE_ORIGIN: string | null;
 /** The emitted `docUrl`, or null while no page exists to point at. */
 declare function publishedDocUrl(entry: ContractErrorRow): string | null;
 
-export { CONTRACT_ERROR_ROWS, type ContractErrorEnvelope, type ContractErrorRow, type ContractWireErrorCode, DOC_SITE_ORIGIN, EverfurErrorCode, contractDocUrl, contractErrorFor, publishedDocUrl };
+/**
+ * Parse a permissive colour into a normalized string (`#RRGGBB` when opaque, else `rgba(r,g,b,a)`), or null.
+ * Accepts `#RGB`, `#RRGGBB`, `#AARRGGBB`, `0xAARRGGBB` (string), a 32-bit ARGB `int`, and `rgb()/rgba()`.
+ * An empty string, whitespace, or an unrecognized value yields null.
+ */
+declare function parseColor(value: unknown): string | null;
+/**
+ * Return the more legible of near-black / white for `background` (WCAG 2.x contrast). Ported from Flutter
+ * `_readableOn`. Falls back to white for an unparseable background (never throws).
+ */
+declare function readableOn(background: string): string;
+/**
+ * The WCAG contrast ratio between two colours (1..21). A translucent colour is composited onto the other before
+ * measuring, since that is what the eye sees. An unparseable colour measures as 1 (no contrast), never throws.
+ */
+declare function contrastRatio(a: string, b: string): number;
+
+/** The SDK's dark `surfaceCream` (EVERFUR_DARK.color.surfaceCream): what the variant must read on. */
+declare const DARK_VARIANT_GROUND = "#23272C";
+/** The ratio the variant must reach on that ground and under the better of the two SDK inks (WCAG AA). */
+declare const DARK_VARIANT_TARGET_RATIO = 4.5;
+/** The tint band the lightness is clamped into, and the step it climbs by (HSL lightness, 0..1). */
+declare const DARK_VARIANT_LIGHTNESS_FLOOR = 0.6;
+declare const DARK_VARIANT_LIGHTNESS_CEILING = 0.9;
+declare const DARK_VARIANT_LIGHTNESS_STEP = 0.02;
+/**
+ * The dark-scheme twin of a light branding colour. The algorithm, step for step (the backend docstring is the
+ * reference; tests/unit/fixtures/dark_variant_vectors.json is the acceptance test):
+ *   1. parse the colour (any form `parseColor` reads; the backend takes `#RRGGBB` only);
+ *   2. HSL; keep h and s;
+ *   3. clamp l into 0.60..0.90 (a dark brand colour is lifted to the floor; a mid or light one keeps its
+ *      lightness, capped);
+ *   4. for l_i = l_dark + i * 0.02 while l_i <= 0.90, return the first candidate that reaches 4.5:1 on the dark
+ *      surface AND 4.5:1 under the better of white / near-black;
+ *   5. else the colour at the ceiling.
+ * Uppercase `#RRGGBB`; null for an unparseable colour (the backend raises there). Idempotent.
+ */
+declare function deriveDarkVariant(color: string): string | null;
+/** The ratio text and borders are pushed toward under `prefers-contrast: more` (WCAG AAA body text). */
+declare const HIGH_CONTRAST_TARGET_RATIO = 7;
+/**
+ * The high-contrast derivation of a resolved theme. Text tokens and borders reach `HIGH_CONTRAST_TARGET_RATIO` on
+ * the palette's hardest surface (pushed toward black on light, white on dark); translucent washes become solid
+ * fills over `surface`. `onPrimary`/`onAccent` are left as the resolver computed them (already the legible pole).
+ * Pure: a new deeply-frozen theme with `highContrast: true`; the input is never mutated. Idempotent.
+ */
+declare function deriveHighContrast(theme: EverfurTheme): EverfurTheme;
+
+export { CONTRACT_ERROR_ROWS, type ContractErrorEnvelope, type ContractErrorRow, type ContractWireErrorCode, DARK_VARIANT_GROUND, DARK_VARIANT_LIGHTNESS_CEILING, DARK_VARIANT_LIGHTNESS_FLOOR, DARK_VARIANT_LIGHTNESS_STEP, DARK_VARIANT_TARGET_RATIO, DOC_SITE_ORIGIN, EverfurErrorCode, EverfurTheme, HIGH_CONTRAST_TARGET_RATIO, contractDocUrl, contractErrorFor, contrastRatio, deriveDarkVariant, deriveHighContrast, parseColor, publishedDocUrl, readableOn };