@thorprovider/medusa-extended 1.11.3 → 1.11.6

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { GetChannelCustomersOptions, GetChannelCustomersResponse, GetChannelApiKeysResponse, GetChannelCategoriesOptions, GetChannelCategoriesResponse, GetCategorySalesChannelsResponse, AssignCategoriesToChannelsBody, AssignCategoriesToChannelsResponse, UnassignCategoriesFromChannelsBody, UnassignCategoriesFromChannelsResponse, GetCollectionSalesChannelsResponse, AssignCollectionsToChannelsBody, AssignCollectionsToChannelsResponse, UnassignCollectionsFromChannelsBody, UnassignCollectionsFromChannelsResponse, GetAdminStorefrontConfigResponse, UpdateStorefrontConfigBody, UpdateStorefrontConfigResponse, GetAdminSiteConfigResponse, UpdateSiteConfigBody, UpdateSiteConfigResponse, GetAdminSiteConfigHistoryOptions, GetAdminSiteConfigHistoryResponse, RestoreSiteConfigResponse, ChatIntent, ChatSource, DropshipperDashboardCapabilities, GetMyProfileResponse, ChatRequest, ChatResponse, GetNotificationsOptions, GetNotificationsResponse, OnboardDropshipperBody, OnboardDropshipperResponse, GetDropshipperProductsOptions, GetDropshipperProductsResponse, ValidateCheckoutItemsRequest, ValidateCheckoutItemsResponse, CostPriceChangesCheckResponse, CostPriceChangesResponse, AcknowledgeCostPriceChangesResponse, UpdateDropshipperProductStatusBody, UpdateDropshipperProductStatusResponse, GetProductAttributesResponse, GetDropshipperAttributesResponse, UpdateDropshipperPricesBody, UpdateDropshipperPricesResponse, GetDropshipperOrdersOptions, GetDropshipperOrdersResponse, GetDropshipperOrderDetailResponse, GetDropshipperShippingOptionsParams, GetDropshipperShippingOptionsResponse, ExtendedCreateDropshipperOrderBody, ExtendedCreateDropshipperOrderResponse, SetPaymentCollectorBody, SetPaymentCollectorResponse, SetPaymentMethodBody, SetPaymentMethodResponse, CancelDropshipperOrderResponse, CreateOrderEditBody, CreateOrderEditResponse, AddOrderEditItemBody, AddOrderEditItemResponse, ConfirmOrderEditResponse, GetOrderNotesResponse, CreateOrderNoteBody, CreateOrderNoteResponse, DeleteOrderNoteResponse, GetProviderCategoriesResponse, GetDropshipperCategoriesOptions, GetDropshipperCategoriesResponse, CreateDropshipperCategoryBody, DropshipperCategory, UpdateDropshipperCategoryBody, DeleteDropshipperCategoryResponse, GetCategoryMappingsOptions, GetCategoryMappingsResponse, CreateCategoryMappingBody, CreateCategoryMappingResponse, DeleteCategoryMappingResponse, GetDropshipperCustomersOptions, GetDropshipperCustomersResponse, GetDropshipperCustomerDetailResponse, CreateDropshipperCustomerBody, CreateDropshipperCustomerResponse, UpdateDropshipperCustomerBody, UpdateDropshipperCustomerResponse, GetDropshipperAddressesResponse, DropshipperAddressBody, DropshipperAddressResponse, GetDropshipperAccountResponse, GetDropshipperPayableResponse, GetDropshipperReceivableResponse, GetSettlementsOptions, GetSettlementsResponse, GetSettlementDetailResponse, GetDropshipperAccountBalanceResponse, GetDropshipperAccountOrdersOptions, GetDropshipperAccountOrdersResponse, CreateSettlementBody, CreateSettlementResponse, ConfirmSettlementBody, UpdateSettlementStatusResponse, CancelSettlementBody, GetAdminDropshipperAccountsResponse, GetAdminAccountBalanceResponse, GetAdminPriceListsResponse, GetUserChannelResponse, GetAdminDropshipperAccountOrdersResponse, GetAdminDropshipperAccountSettlementsOptions, GetAdminDropshipperAccountSettlementsResponse, ResolveGuaranteeBody, ResolveGuaranteeResponse, CreateCompensacionBody, CreateCompensacionResponse, CreateAjusteBody, CreateAjusteResponse, CreateCobroBody, CreateCobroResponse, CreatePagoBody, CreatePagoResponse, CreateReversoBody, CreateReversoResponse, ConfirmMovementBody, ConfirmMovementResponse, CancelMovementBody, CancelMovementResponse, GetFinancialAnalysisResponse, RegisterPaymentBody, RegisterPaymentResponse, GetDropshipperPromotionsOptions, GetDropshipperPromotionsResponse, CreateDropshipperPromotionBody, DropshipperPromotion, UpdateDropshipperPromotionBody, DeleteDropshipperPromotionResponse, GetDashboardStatsOptions, GetDashboardStatsResponse, GetStorefrontDropshipperCategoriesResponse, GetDropshipperDraftOrdersOptions, GetDropshipperDraftOrdersResponse, GetDropshipperDraftOrderDetailResponse, CreateDropshipperDraftOrderBody, CreateDropshipperDraftOrderResponse, UpdateDropshipperDraftOrderBody, UpdateDropshipperDraftOrderResponse, ConvertDropshipperDraftOrderBody, ConvertDropshipperDraftOrderResponse, DeleteDropshipperDraftOrderResponse, GetGeoCountriesResponse, GetGeoProvincesResponse, GetGeoCitiesResponse } from '@thorprovider/types';
+import { GetChannelCustomersOptions, GetChannelCustomersResponse, GetChannelApiKeysResponse, GetChannelCategoriesOptions, GetChannelCategoriesResponse, GetCategorySalesChannelsResponse, AssignCategoriesToChannelsBody, AssignCategoriesToChannelsResponse, UnassignCategoriesFromChannelsBody, UnassignCategoriesFromChannelsResponse, GetCollectionSalesChannelsResponse, AssignCollectionsToChannelsBody, AssignCollectionsToChannelsResponse, UnassignCollectionsFromChannelsBody, UnassignCollectionsFromChannelsResponse, GetAdminStorefrontConfigResponse, UpdateStorefrontConfigBody, UpdateStorefrontConfigResponse, GetAdminSiteConfigResponse, UpdateSiteConfigBody, UpdateSiteConfigResponse, GetAdminSiteConfigHistoryOptions, GetAdminSiteConfigHistoryResponse, RestoreSiteConfigResponse, ChatIntent, ChatSource, DropshipperDashboardCapabilities, GetMyProfileResponse, ChatRequest, ChatResponse, ChatAssistantHealthResponse, GetNotificationsOptions, GetNotificationsResponse, OnboardDropshipperBody, OnboardDropshipperResponse, GetDropshipperProductsOptions, GetDropshipperProductsResponse, ValidateCheckoutItemsRequest, ValidateCheckoutItemsResponse, CostPriceChangesCheckResponse, CostPriceChangesResponse, AcknowledgeCostPriceChangesResponse, UpdateDropshipperProductStatusBody, UpdateDropshipperProductStatusResponse, GetProductAttributesResponse, GetDropshipperAttributesResponse, UpdateDropshipperPricesBody, UpdateDropshipperPricesResponse, GetDropshipperOrdersOptions, GetDropshipperOrdersResponse, GetDropshipperOrderDetailResponse, GetDropshipperShippingOptionsParams, GetDropshipperShippingOptionsResponse, ExtendedCreateDropshipperOrderBody, ExtendedCreateDropshipperOrderResponse, SetPaymentCollectorBody, SetPaymentCollectorResponse, SetPaymentMethodBody, SetPaymentMethodResponse, CancelDropshipperOrderResponse, CreateOrderEditBody, CreateOrderEditResponse, AddOrderEditItemBody, AddOrderEditItemResponse, ConfirmOrderEditResponse, GetOrderNotesResponse, CreateOrderNoteBody, CreateOrderNoteResponse, DeleteOrderNoteResponse, GetProviderCategoriesResponse, GetDropshipperCategoriesOptions, GetDropshipperCategoriesResponse, CreateDropshipperCategoryBody, DropshipperCategory, UpdateDropshipperCategoryBody, DeleteDropshipperCategoryResponse, GetCategoryMappingsOptions, GetCategoryMappingsResponse, CreateCategoryMappingBody, CreateCategoryMappingResponse, DeleteCategoryMappingResponse, GetDropshipperCustomersOptions, GetDropshipperCustomersResponse, GetDropshipperCustomerDetailResponse, CreateDropshipperCustomerBody, CreateDropshipperCustomerResponse, UpdateDropshipperCustomerBody, UpdateDropshipperCustomerResponse, GetDropshipperAddressesResponse, DropshipperAddressBody, DropshipperAddressResponse, GetDropshipperAccountResponse, GetDropshipperPayableResponse, GetDropshipperReceivableResponse, GetSettlementsOptions, GetSettlementsResponse, GetSettlementDetailResponse, GetDropshipperAccountBalanceResponse, GetDropshipperAccountOrdersOptions, GetDropshipperAccountOrdersResponse, CreateSettlementBody, CreateSettlementResponse, ConfirmSettlementBody, UpdateSettlementStatusResponse, CancelSettlementBody, GetAdminDropshipperAccountsResponse, GetAdminAccountBalanceResponse, GetAdminPriceListsResponse, GetUserChannelResponse, GetAdminDropshipperAccountOrdersResponse, GetAdminDropshipperAccountSettlementsOptions, GetAdminDropshipperAccountSettlementsResponse, ResolveGuaranteeBody, ResolveGuaranteeResponse, CreateCompensacionBody, CreateCompensacionResponse, CreateAjusteBody, CreateAjusteResponse, CreateCobroBody, CreateCobroResponse, CreatePagoBody, CreatePagoResponse, CreateReversoBody, CreateReversoResponse, ConfirmMovementBody, ConfirmMovementResponse, CancelMovementBody, CancelMovementResponse, GetFinancialAnalysisResponse, RegisterPaymentBody, RegisterPaymentResponse, GetDropshipperPromotionsOptions, GetDropshipperPromotionsResponse, CreateDropshipperPromotionBody, DropshipperPromotion, UpdateDropshipperPromotionBody, DeleteDropshipperPromotionResponse, GetDashboardStatsOptions, GetDashboardStatsResponse, GetStorefrontDropshipperCategoriesResponse, GetDropshipperDraftOrdersOptions, GetDropshipperDraftOrdersResponse, GetDropshipperDraftOrderDetailResponse, CreateDropshipperDraftOrderBody, CreateDropshipperDraftOrderResponse, UpdateDropshipperDraftOrderBody, UpdateDropshipperDraftOrderResponse, ConvertDropshipperDraftOrderBody, ConvertDropshipperDraftOrderResponse, DeleteDropshipperDraftOrderResponse, GetGeoCountriesResponse, GetGeoProvincesResponse, GetGeoCitiesResponse } from '@thorprovider/types';
 
 /**
  * @fileoverview Medusa Multi-Tenant Admin Client
@@ -167,8 +167,8 @@ declare class MedusaAdminClient {
  * One event from the streamed AI assistant chat (`chatAssistantStream`).
  *
  * The backend returns a UI-message stream (SSE over `text/event-stream`) for
- * catalog searches, and a plain JSON `ChatResponse` for greetings/other
- * intents. `chatAssistantStream` normalizes both into this single event type so
+ * catalog searches, and a plain JSON `ChatResponse` for `default` intents.
+ * `chatAssistantStream` normalizes both into this single event type so
  * consumers can render incremental text and update the "thinking" label as the
  * model progresses without knowing the transport details.
  */
@@ -183,7 +183,7 @@ type ChatStreamEvent = {
 } | {
     type: 'finish';
     intent: ChatIntent;
-    /** Products referenced by the answer (empty for greetings/other). */
+    /** Products referenced by the answer (empty for `default` intents). */
     sources: ChatSource[];
 } | {
     type: 'error';
@@ -261,13 +261,30 @@ declare class DropshipperClient {
      *
      * Unlike `chatAssistant`, this surfaces the model's progress: the backend
      * resolves the intent first and then streams the answer token by token
-     * (catalog searches) or returns the full answer in one shot (greetings/other).
+     * (catalog searches) or returns the full answer in one shot (`default`).
      * The response is normalized into a single `ReadableStream<ChatStreamEvent>`
      * so callers can show a live "thinking" label and render text incrementally.
      *
      * `POST /admin/thor/dropshipper/ai/chat`
      */
     chatAssistantStream(body: ChatRequest): Promise<ReadableStream<ChatStreamEvent>>;
+    /**
+     * Cheap liveness probe for the AI assistant.
+     *
+     * The backend performs no LLM or retrieval work, so this is safe to poll
+     * (e.g. from a dashboard availability indicator). Returns 200 with
+     * `available: true` when the assistant is configured; the backend answers
+     * HTTP 503 with `available: false` when `AI_GATEWAY_API_KEY` is missing.
+     *
+     * Deliberately does NOT go through `fetchBackendWithResilience`: that layer
+     * funnels every call through the SHARED `backendCircuitBreaker`, and the
+     * definitive 503 "not configured" answer would count as failures and could
+     * open the circuit, taking down all dropshipper API traffic. A health probe
+     * must stay isolated, with no retries and a short timeout.
+     *
+     * `GET /admin/thor/dropshipper/ai/health`
+     */
+    chatAssistantHealth(): Promise<ChatAssistantHealthResponse>;
     /**
      * List feed notifications for the authenticated dropshipper.
      *

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { GetChannelCustomersOptions, GetChannelCustomersResponse, GetChannelApiKeysResponse, GetChannelCategoriesOptions, GetChannelCategoriesResponse, GetCategorySalesChannelsResponse, AssignCategoriesToChannelsBody, AssignCategoriesToChannelsResponse, UnassignCategoriesFromChannelsBody, UnassignCategoriesFromChannelsResponse, GetCollectionSalesChannelsResponse, AssignCollectionsToChannelsBody, AssignCollectionsToChannelsResponse, UnassignCollectionsFromChannelsBody, UnassignCollectionsFromChannelsResponse, GetAdminStorefrontConfigResponse, UpdateStorefrontConfigBody, UpdateStorefrontConfigResponse, GetAdminSiteConfigResponse, UpdateSiteConfigBody, UpdateSiteConfigResponse, GetAdminSiteConfigHistoryOptions, GetAdminSiteConfigHistoryResponse, RestoreSiteConfigResponse, ChatIntent, ChatSource, DropshipperDashboardCapabilities, GetMyProfileResponse, ChatRequest, ChatResponse, GetNotificationsOptions, GetNotificationsResponse, OnboardDropshipperBody, OnboardDropshipperResponse, GetDropshipperProductsOptions, GetDropshipperProductsResponse, ValidateCheckoutItemsRequest, ValidateCheckoutItemsResponse, CostPriceChangesCheckResponse, CostPriceChangesResponse, AcknowledgeCostPriceChangesResponse, UpdateDropshipperProductStatusBody, UpdateDropshipperProductStatusResponse, GetProductAttributesResponse, GetDropshipperAttributesResponse, UpdateDropshipperPricesBody, UpdateDropshipperPricesResponse, GetDropshipperOrdersOptions, GetDropshipperOrdersResponse, GetDropshipperOrderDetailResponse, GetDropshipperShippingOptionsParams, GetDropshipperShippingOptionsResponse, ExtendedCreateDropshipperOrderBody, ExtendedCreateDropshipperOrderResponse, SetPaymentCollectorBody, SetPaymentCollectorResponse, SetPaymentMethodBody, SetPaymentMethodResponse, CancelDropshipperOrderResponse, CreateOrderEditBody, CreateOrderEditResponse, AddOrderEditItemBody, AddOrderEditItemResponse, ConfirmOrderEditResponse, GetOrderNotesResponse, CreateOrderNoteBody, CreateOrderNoteResponse, DeleteOrderNoteResponse, GetProviderCategoriesResponse, GetDropshipperCategoriesOptions, GetDropshipperCategoriesResponse, CreateDropshipperCategoryBody, DropshipperCategory, UpdateDropshipperCategoryBody, DeleteDropshipperCategoryResponse, GetCategoryMappingsOptions, GetCategoryMappingsResponse, CreateCategoryMappingBody, CreateCategoryMappingResponse, DeleteCategoryMappingResponse, GetDropshipperCustomersOptions, GetDropshipperCustomersResponse, GetDropshipperCustomerDetailResponse, CreateDropshipperCustomerBody, CreateDropshipperCustomerResponse, UpdateDropshipperCustomerBody, UpdateDropshipperCustomerResponse, GetDropshipperAddressesResponse, DropshipperAddressBody, DropshipperAddressResponse, GetDropshipperAccountResponse, GetDropshipperPayableResponse, GetDropshipperReceivableResponse, GetSettlementsOptions, GetSettlementsResponse, GetSettlementDetailResponse, GetDropshipperAccountBalanceResponse, GetDropshipperAccountOrdersOptions, GetDropshipperAccountOrdersResponse, CreateSettlementBody, CreateSettlementResponse, ConfirmSettlementBody, UpdateSettlementStatusResponse, CancelSettlementBody, GetAdminDropshipperAccountsResponse, GetAdminAccountBalanceResponse, GetAdminPriceListsResponse, GetUserChannelResponse, GetAdminDropshipperAccountOrdersResponse, GetAdminDropshipperAccountSettlementsOptions, GetAdminDropshipperAccountSettlementsResponse, ResolveGuaranteeBody, ResolveGuaranteeResponse, CreateCompensacionBody, CreateCompensacionResponse, CreateAjusteBody, CreateAjusteResponse, CreateCobroBody, CreateCobroResponse, CreatePagoBody, CreatePagoResponse, CreateReversoBody, CreateReversoResponse, ConfirmMovementBody, ConfirmMovementResponse, CancelMovementBody, CancelMovementResponse, GetFinancialAnalysisResponse, RegisterPaymentBody, RegisterPaymentResponse, GetDropshipperPromotionsOptions, GetDropshipperPromotionsResponse, CreateDropshipperPromotionBody, DropshipperPromotion, UpdateDropshipperPromotionBody, DeleteDropshipperPromotionResponse, GetDashboardStatsOptions, GetDashboardStatsResponse, GetStorefrontDropshipperCategoriesResponse, GetDropshipperDraftOrdersOptions, GetDropshipperDraftOrdersResponse, GetDropshipperDraftOrderDetailResponse, CreateDropshipperDraftOrderBody, CreateDropshipperDraftOrderResponse, UpdateDropshipperDraftOrderBody, UpdateDropshipperDraftOrderResponse, ConvertDropshipperDraftOrderBody, ConvertDropshipperDraftOrderResponse, DeleteDropshipperDraftOrderResponse, GetGeoCountriesResponse, GetGeoProvincesResponse, GetGeoCitiesResponse } from '@thorprovider/types';
+import { GetChannelCustomersOptions, GetChannelCustomersResponse, GetChannelApiKeysResponse, GetChannelCategoriesOptions, GetChannelCategoriesResponse, GetCategorySalesChannelsResponse, AssignCategoriesToChannelsBody, AssignCategoriesToChannelsResponse, UnassignCategoriesFromChannelsBody, UnassignCategoriesFromChannelsResponse, GetCollectionSalesChannelsResponse, AssignCollectionsToChannelsBody, AssignCollectionsToChannelsResponse, UnassignCollectionsFromChannelsBody, UnassignCollectionsFromChannelsResponse, GetAdminStorefrontConfigResponse, UpdateStorefrontConfigBody, UpdateStorefrontConfigResponse, GetAdminSiteConfigResponse, UpdateSiteConfigBody, UpdateSiteConfigResponse, GetAdminSiteConfigHistoryOptions, GetAdminSiteConfigHistoryResponse, RestoreSiteConfigResponse, ChatIntent, ChatSource, DropshipperDashboardCapabilities, GetMyProfileResponse, ChatRequest, ChatResponse, ChatAssistantHealthResponse, GetNotificationsOptions, GetNotificationsResponse, OnboardDropshipperBody, OnboardDropshipperResponse, GetDropshipperProductsOptions, GetDropshipperProductsResponse, ValidateCheckoutItemsRequest, ValidateCheckoutItemsResponse, CostPriceChangesCheckResponse, CostPriceChangesResponse, AcknowledgeCostPriceChangesResponse, UpdateDropshipperProductStatusBody, UpdateDropshipperProductStatusResponse, GetProductAttributesResponse, GetDropshipperAttributesResponse, UpdateDropshipperPricesBody, UpdateDropshipperPricesResponse, GetDropshipperOrdersOptions, GetDropshipperOrdersResponse, GetDropshipperOrderDetailResponse, GetDropshipperShippingOptionsParams, GetDropshipperShippingOptionsResponse, ExtendedCreateDropshipperOrderBody, ExtendedCreateDropshipperOrderResponse, SetPaymentCollectorBody, SetPaymentCollectorResponse, SetPaymentMethodBody, SetPaymentMethodResponse, CancelDropshipperOrderResponse, CreateOrderEditBody, CreateOrderEditResponse, AddOrderEditItemBody, AddOrderEditItemResponse, ConfirmOrderEditResponse, GetOrderNotesResponse, CreateOrderNoteBody, CreateOrderNoteResponse, DeleteOrderNoteResponse, GetProviderCategoriesResponse, GetDropshipperCategoriesOptions, GetDropshipperCategoriesResponse, CreateDropshipperCategoryBody, DropshipperCategory, UpdateDropshipperCategoryBody, DeleteDropshipperCategoryResponse, GetCategoryMappingsOptions, GetCategoryMappingsResponse, CreateCategoryMappingBody, CreateCategoryMappingResponse, DeleteCategoryMappingResponse, GetDropshipperCustomersOptions, GetDropshipperCustomersResponse, GetDropshipperCustomerDetailResponse, CreateDropshipperCustomerBody, CreateDropshipperCustomerResponse, UpdateDropshipperCustomerBody, UpdateDropshipperCustomerResponse, GetDropshipperAddressesResponse, DropshipperAddressBody, DropshipperAddressResponse, GetDropshipperAccountResponse, GetDropshipperPayableResponse, GetDropshipperReceivableResponse, GetSettlementsOptions, GetSettlementsResponse, GetSettlementDetailResponse, GetDropshipperAccountBalanceResponse, GetDropshipperAccountOrdersOptions, GetDropshipperAccountOrdersResponse, CreateSettlementBody, CreateSettlementResponse, ConfirmSettlementBody, UpdateSettlementStatusResponse, CancelSettlementBody, GetAdminDropshipperAccountsResponse, GetAdminAccountBalanceResponse, GetAdminPriceListsResponse, GetUserChannelResponse, GetAdminDropshipperAccountOrdersResponse, GetAdminDropshipperAccountSettlementsOptions, GetAdminDropshipperAccountSettlementsResponse, ResolveGuaranteeBody, ResolveGuaranteeResponse, CreateCompensacionBody, CreateCompensacionResponse, CreateAjusteBody, CreateAjusteResponse, CreateCobroBody, CreateCobroResponse, CreatePagoBody, CreatePagoResponse, CreateReversoBody, CreateReversoResponse, ConfirmMovementBody, ConfirmMovementResponse, CancelMovementBody, CancelMovementResponse, GetFinancialAnalysisResponse, RegisterPaymentBody, RegisterPaymentResponse, GetDropshipperPromotionsOptions, GetDropshipperPromotionsResponse, CreateDropshipperPromotionBody, DropshipperPromotion, UpdateDropshipperPromotionBody, DeleteDropshipperPromotionResponse, GetDashboardStatsOptions, GetDashboardStatsResponse, GetStorefrontDropshipperCategoriesResponse, GetDropshipperDraftOrdersOptions, GetDropshipperDraftOrdersResponse, GetDropshipperDraftOrderDetailResponse, CreateDropshipperDraftOrderBody, CreateDropshipperDraftOrderResponse, UpdateDropshipperDraftOrderBody, UpdateDropshipperDraftOrderResponse, ConvertDropshipperDraftOrderBody, ConvertDropshipperDraftOrderResponse, DeleteDropshipperDraftOrderResponse, GetGeoCountriesResponse, GetGeoProvincesResponse, GetGeoCitiesResponse } from '@thorprovider/types';
 
 /**
  * @fileoverview Medusa Multi-Tenant Admin Client
@@ -167,8 +167,8 @@ declare class MedusaAdminClient {
  * One event from the streamed AI assistant chat (`chatAssistantStream`).
  *
  * The backend returns a UI-message stream (SSE over `text/event-stream`) for
- * catalog searches, and a plain JSON `ChatResponse` for greetings/other
- * intents. `chatAssistantStream` normalizes both into this single event type so
+ * catalog searches, and a plain JSON `ChatResponse` for `default` intents.
+ * `chatAssistantStream` normalizes both into this single event type so
  * consumers can render incremental text and update the "thinking" label as the
  * model progresses without knowing the transport details.
  */
@@ -183,7 +183,7 @@ type ChatStreamEvent = {
 } | {
     type: 'finish';
     intent: ChatIntent;
-    /** Products referenced by the answer (empty for greetings/other). */
+    /** Products referenced by the answer (empty for `default` intents). */
     sources: ChatSource[];
 } | {
     type: 'error';
@@ -261,13 +261,30 @@ declare class DropshipperClient {
      *
      * Unlike `chatAssistant`, this surfaces the model's progress: the backend
      * resolves the intent first and then streams the answer token by token
-     * (catalog searches) or returns the full answer in one shot (greetings/other).
+     * (catalog searches) or returns the full answer in one shot (`default`).
      * The response is normalized into a single `ReadableStream<ChatStreamEvent>`
      * so callers can show a live "thinking" label and render text incrementally.
      *
      * `POST /admin/thor/dropshipper/ai/chat`
      */
     chatAssistantStream(body: ChatRequest): Promise<ReadableStream<ChatStreamEvent>>;
+    /**
+     * Cheap liveness probe for the AI assistant.
+     *
+     * The backend performs no LLM or retrieval work, so this is safe to poll
+     * (e.g. from a dashboard availability indicator). Returns 200 with
+     * `available: true` when the assistant is configured; the backend answers
+     * HTTP 503 with `available: false` when `AI_GATEWAY_API_KEY` is missing.
+     *
+     * Deliberately does NOT go through `fetchBackendWithResilience`: that layer
+     * funnels every call through the SHARED `backendCircuitBreaker`, and the
+     * definitive 503 "not configured" answer would count as failures and could
+     * open the circuit, taking down all dropshipper API traffic. A health probe
+     * must stay isolated, with no retries and a short timeout.
+     *
+     * `GET /admin/thor/dropshipper/ai/health`
+     */
+    chatAssistantHealth(): Promise<ChatAssistantHealthResponse>;
     /**
      * List feed notifications for the authenticated dropshipper.
      *

package/dist/index.js

@@ -481,7 +481,7 @@ var DropshipperClient = class {
    *
    * Unlike `chatAssistant`, this surfaces the model's progress: the backend
    * resolves the intent first and then streams the answer token by token
-   * (catalog searches) or returns the full answer in one shot (greetings/other).
+   * (catalog searches) or returns the full answer in one shot (`default`).
    * The response is normalized into a single `ReadableStream<ChatStreamEvent>`
    * so callers can show a live "thinking" label and render text incrementally.
    *
@@ -501,7 +501,10 @@ var DropshipperClient = class {
     };
     let response;
     try {
-      response = await fetchBackendWithResilience(url, init);
+      response = await fetchBackendWithResilience(url, init, {
+        timeoutMs: 6e4,
+        maxRetries: 1
+      });
     } catch (networkError) {
       throw new import_adapters3.ProviderAPIError(
         `[dropshipper] Network error on POST /admin/thor/dropshipper/ai/chat: ${networkError.message}`,
@@ -511,20 +514,36 @@ var DropshipperClient = class {
     }
     if (!response.ok) {
       let message = `HTTP ${response.status}`;
+      let errorCode;
+      let requestId;
+      let details;
       try {
         const json = await response.json();
         message = json?.message ?? message;
+        errorCode = json?.error_code ?? json?.type;
+        requestId = json?.request_id;
+        details = json?.details;
       } catch {
       }
+      this.logger.error(
+        `[dropshipper] POST /admin/thor/dropshipper/ai/chat failed status=${response.status} message=${message}` + (errorCode ? ` error_code=${errorCode}` : "") + (requestId ? ` request_id=${requestId}` : "") + (details ? ` details=${details}` : "")
+      );
       throw new import_adapters3.ProviderAPIError(
         `[dropshipper] POST /admin/thor/dropshipper/ai/chat failed: ${message}`,
         `DROPSHIPPER_API_${response.status}`,
-        response.status
+        response.status,
+        {
+          message,
+          status: response.status,
+          errorCode,
+          requestId,
+          details
+        }
       );
     }
     const contentType = response.headers.get("content-type") ?? "";
     if (contentType.includes("text/event-stream") && response.body) {
-      return mapUiMessageStreamToEvents(response.body);
+      return mapUiMessageStreamToEvents(response.body, this.logger);
     }
     const data = await response.json();
     return new ReadableStream({
@@ -540,6 +559,61 @@ var DropshipperClient = class {
       }
     });
   }
+  /**
+   * Cheap liveness probe for the AI assistant.
+   *
+   * The backend performs no LLM or retrieval work, so this is safe to poll
+   * (e.g. from a dashboard availability indicator). Returns 200 with
+   * `available: true` when the assistant is configured; the backend answers
+   * HTTP 503 with `available: false` when `AI_GATEWAY_API_KEY` is missing.
+   *
+   * Deliberately does NOT go through `fetchBackendWithResilience`: that layer
+   * funnels every call through the SHARED `backendCircuitBreaker`, and the
+   * definitive 503 "not configured" answer would count as failures and could
+   * open the circuit, taking down all dropshipper API traffic. A health probe
+   * must stay isolated, with no retries and a short timeout.
+   *
+   * `GET /admin/thor/dropshipper/ai/health`
+   */
+  async chatAssistantHealth() {
+    const url = `${this.baseUrl}/admin/thor/dropshipper/ai/health`;
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), 5e3);
+    let response;
+    try {
+      response = await fetch(url, {
+        method: "GET",
+        headers: { Authorization: `Bearer ${this.token}` },
+        signal: controller.signal,
+        cache: "no-store"
+      });
+    } catch (error) {
+      clearTimeout(timeoutId);
+      throw new import_adapters3.ProviderAPIError(
+        `[dropshipper] Network error on GET /admin/thor/dropshipper/ai/health: ${error.message}`,
+        "NETWORK_ERROR",
+        0
+      );
+    }
+    clearTimeout(timeoutId);
+    if (response.status === 503) {
+      try {
+        const body = await response.json();
+        if (body && typeof body.available === "boolean") {
+          return body;
+        }
+      } catch {
+      }
+    }
+    if (!response.ok) {
+      throw new import_adapters3.ProviderAPIError(
+        `[dropshipper] GET /admin/thor/dropshipper/ai/health failed: HTTP ${response.status}`,
+        `DROPSHIPPER_API_${response.status}`,
+        response.status
+      );
+    }
+    return response.json();
+  }
   // -------------------------------------------------------------------------
   // Notifications
   // -------------------------------------------------------------------------
@@ -1698,10 +1772,11 @@ var DropshipperClient = class {
     );
   }
 };
-async function* parseSse(stream) {
+async function* parseSse(stream, logger) {
   const reader = stream.getReader();
   const decoder = new TextDecoder();
   let buffer = "";
+  let frameIndex = 0;
   try {
     while (true) {
       const { done, value } = await reader.read();
@@ -1714,9 +1789,13 @@ async function* parseSse(stream) {
         if (!trimmed.startsWith("data:")) continue;
         const payload = trimmed.slice(5).trim();
         if (!payload || payload === "[DONE]") continue;
+        frameIndex += 1;
         try {
           yield JSON.parse(payload);
-        } catch {
+        } catch (err) {
+          logger?.warn(
+            `[dropshipper] sse-malformed-frame frame=${frameIndex} payload=${payload.slice(0, 200)}`
+          );
         }
       }
     }
@@ -1724,9 +1803,13 @@ async function* parseSse(stream) {
     if (tail.startsWith("data:")) {
       const payload = tail.slice(5).trim();
       if (payload && payload !== "[DONE]") {
+        frameIndex += 1;
         try {
           yield JSON.parse(payload);
-        } catch {
+        } catch (err) {
+          logger?.warn(
+            `[dropshipper] sse-malformed-frame frame=${frameIndex} payload=${payload.slice(0, 200)}`
+          );
         }
       }
     }
@@ -1734,10 +1817,11 @@ async function* parseSse(stream) {
     reader.releaseLock();
   }
 }
-function mapUiMessageStreamToEvents(stream) {
+function mapUiMessageStreamToEvents(stream, logger) {
   return new ReadableStream({
     async start(controller) {
-      for await (const raw of parseSse(stream)) {
+      let eventCount = 0;
+      for await (const raw of parseSse(stream, logger)) {
         const chunk = raw;
         switch (chunk.type) {
           case "start":
@@ -1745,27 +1829,39 @@ function mapUiMessageStreamToEvents(stream) {
               type: "start",
               intent: chunk.messageMetadata?.intent
             });
+            eventCount += 1;
             break;
           case "text-delta":
             if (chunk.delta !== void 0) {
               controller.enqueue({ type: "text-delta", delta: chunk.delta });
+              eventCount += 1;
             }
             break;
           case "finish":
             controller.enqueue({
               type: "finish",
-              intent: chunk.messageMetadata?.intent ?? "other",
+              intent: chunk.messageMetadata?.intent ?? "default",
               sources: chunk.messageMetadata?.sources ?? []
             });
+            eventCount += 1;
             break;
           case "error":
+            logger?.warn(
+              `[dropshipper] chat-stream-error errorText=${chunk.errorText}`
+            );
             controller.enqueue({
               type: "error",
               errorText: chunk.errorText ?? "Error inesperado del asistente."
             });
+            eventCount += 1;
             break;
+          default:
+            logger?.debug(
+              `[dropshipper] chat-stream-unknown-frame type=${chunk.type}`
+            );
         }
       }
+      logger?.debug(`[dropshipper] chat-stream-completed events=${eventCount}`);
       controller.close();
     },
     cancel() {