@waniwani/sdk 0.19.5 → 0.19.7

package/dist/chat/express-js/index.d.ts

@@ -68,8 +68,12 @@ interface KbClient {
  * first-class names at runtime (the widget transport passes these through
  * verbatim instead of namespacing them as custom widget events).
  */
-declare const EVENT_TYPES: readonly ["session.started", "page.viewed", "tool.called", "link.clicked", "widget_render", "user.identified", "price_shown", "prices_compared", "option_selected", "lead_qualified", "converted"];
+declare const EVENT_TYPES: readonly ["session.started", "page.viewed", "tool.called", "link.clicked", "widget_render", "user.identified", "price_shown", "prices_compared", "option_selected", "lead_qualified", "converted", "session.error"];
 type EventType = (typeof EVENT_TYPES)[number];
+declare const SESSION_ERROR_CODES: readonly ["agent_failed", "tool_failed", "upstream_failed"];
+type SessionErrorCodeType = (typeof SESSION_ERROR_CODES)[number];
+declare const ERROR_CAUSES: readonly ["timeout", "rate_limited", "upstream_4xx", "upstream_5xx", "network", "invalid_output", "flow_dead_end", "flow_unknown_node", "flow_loop", "unknown"];
+type ErrorCauseType = (typeof ERROR_CAUSES)[number];
 /**
  * Properties for `page.viewed` — emitted once when the chat widget initializes
  * on a host page (the top of the funnel). Attributed to the anonymous
@@ -96,6 +100,7 @@ interface ToolCalledProperties {
     type?: "pricing" | "product_info" | "availability" | "support" | "other";
     /** Retrieval traces for kb.search() calls made inside this tool handler. */
     kbSearch?: KbSearchTrace[];
+    cause?: ErrorCauseType;
 }
 interface LinkClickedProperties {
     url?: string;
@@ -142,6 +147,12 @@ interface ConvertedProperties {
     /** When the conversion actually happened — for backdated off-platform sales. */
     occurredAt?: string;
 }
+interface SessionErrorProperties {
+    code: SessionErrorCodeType;
+    cause: ErrorCauseType;
+    tool?: string;
+    node?: string;
+}
 interface TrackingContext {
     /**
      * MCP request metadata passed through to the API.
@@ -208,6 +219,9 @@ type TrackEvent = ({
 } & BaseTrackEvent) | ({
     event: "converted";
     properties?: ConvertedProperties;
+} & BaseTrackEvent) | ({
+    event: "session.error";
+    properties?: SessionErrorProperties;
 } & BaseTrackEvent);
 /**
  * Legacy tracking shape supported for existing integrations.

package/dist/chat/index.d.ts

@@ -22,8 +22,12 @@ interface KbSearchTrace {
  * first-class names at runtime (the widget transport passes these through
  * verbatim instead of namespacing them as custom widget events).
  */
-declare const EVENT_TYPES: readonly ["session.started", "page.viewed", "tool.called", "link.clicked", "widget_render", "user.identified", "price_shown", "prices_compared", "option_selected", "lead_qualified", "converted"];
+declare const EVENT_TYPES: readonly ["session.started", "page.viewed", "tool.called", "link.clicked", "widget_render", "user.identified", "price_shown", "prices_compared", "option_selected", "lead_qualified", "converted", "session.error"];
 type EventType = (typeof EVENT_TYPES)[number];
+declare const SESSION_ERROR_CODES: readonly ["agent_failed", "tool_failed", "upstream_failed"];
+type SessionErrorCodeType = (typeof SESSION_ERROR_CODES)[number];
+declare const ERROR_CAUSES: readonly ["timeout", "rate_limited", "upstream_4xx", "upstream_5xx", "network", "invalid_output", "flow_dead_end", "flow_unknown_node", "flow_loop", "unknown"];
+type ErrorCauseType = (typeof ERROR_CAUSES)[number];
 /**
  * Properties for `page.viewed` — emitted once when the chat widget initializes
  * on a host page (the top of the funnel). Attributed to the anonymous
@@ -50,6 +54,7 @@ interface ToolCalledProperties {
     type?: "pricing" | "product_info" | "availability" | "support" | "other";
     /** Retrieval traces for kb.search() calls made inside this tool handler. */
     kbSearch?: KbSearchTrace[];
+    cause?: ErrorCauseType;
 }
 interface LinkClickedProperties {
     url?: string;
@@ -96,6 +101,12 @@ interface ConvertedProperties {
     /** When the conversion actually happened — for backdated off-platform sales. */
     occurredAt?: string;
 }
+interface SessionErrorProperties {
+    code: SessionErrorCodeType;
+    cause: ErrorCauseType;
+    tool?: string;
+    node?: string;
+}
 interface TrackingContext {
     /**
      * MCP request metadata passed through to the API.
@@ -162,6 +173,9 @@ type TrackEvent = ({
 } & BaseTrackEvent) | ({
     event: "converted";
     properties?: ConvertedProperties;
+} & BaseTrackEvent) | ({
+    event: "session.error";
+    properties?: SessionErrorProperties;
 } & BaseTrackEvent);
 /**
  * Legacy tracking shape supported for existing integrations.
@@ -774,6 +788,14 @@ interface ChatEmbedProps extends Omit<ChatBaseProps, "api" | "onCallTool"> {
      * should leave this unset.
      */
     initializing?: boolean;
+    /**
+     * @internal
+     * Whether the chat is actually on screen. `false` suppresses
+     * `suggestions.shown` impressions, so a mount kept hidden behind other
+     * chrome (the floating dock) never reports pills the visitor cannot see.
+     * Defaults to `true`; standalone `ChatEmbed` callers should leave it unset.
+     */
+    onScreen?: boolean;
 }
 interface ChatHandle {
     /** Programmatically send a user message into the chat */