@waniwani/sdk 0.19.6 → 0.19.7

package/dist/mcp/react/skybridge.d.ts

@@ -17,8 +17,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
@@ -45,6 +49,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;
@@ -91,6 +96,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.
@@ -157,6 +168,9 @@ type TrackEvent = ({
 } & BaseTrackEvent) | ({
     event: "converted";
     properties?: ConvertedProperties;
+} & BaseTrackEvent) | ({
+    event: "session.error";
+    properties?: SessionErrorProperties;
 } & BaseTrackEvent);
 /**
  * Legacy tracking shape supported for existing integrations.

package/dist/mcp/react.d.ts

@@ -661,8 +661,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
@@ -689,6 +693,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;
@@ -735,6 +740,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.
@@ -801,6 +812,9 @@ type TrackEvent = ({
 } & BaseTrackEvent) | ({
     event: "converted";
     properties?: ConvertedProperties;
+} & BaseTrackEvent) | ({
+    event: "session.error";
+    properties?: SessionErrorProperties;
 } & BaseTrackEvent);
 /**
  * Legacy tracking shape supported for existing integrations.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@waniwani/sdk",
-  "version": "0.19.6",
+  "version": "0.19.7",
   "description": "MCP distribution SDK. Build sales funnels, lead generation, booking, and quote apps on top of your MCP server. Event tracking, flows, widgets, knowledge base.",
   "type": "module",
   "exports": {