@alquimia-ai/tools 2.3.0 → 2.5.0

package/dist/hooks/index.d.mts

@@ -1,13 +1,13 @@
 import * as react from 'react';
 import { AlquimiaSDK } from '../sdk/index.mjs';
 import { AlquimiaAdapter } from '../adapters/index.mjs';
-import { W as WhisperProvider, S as StableDiffusionProvider, C as CharacterizationProvider, R as RatingsProvider, L as LoggerProvider } from '../providers-0Gi78uNQ.mjs';
-import { GenuiSurfaceItem, AlquimiaMessage, ToolEvent, AIMessageChunk, RatingData } from '../types/index.mjs';
+import { W as WhisperProvider, S as StableDiffusionProvider, C as CharacterizationProvider, R as RatingsProvider, L as LoggerProvider } from '../providers-DiR9cgyo.mjs';
+import { G as GenuiSurfaceItem, e as AlquimiaMessage, u as ToolEvent, a as AIMessageChunk, R as RatingData } from '../type-DqX3-9QS.mjs';
+import { T as ToolExecutionResponse } from '../types-CMVbyEv8.mjs';
+import { a as WorklogState } from '../types-C-6fgK1_.mjs';
 import { createMessageId } from '../utils/index.mjs';
-import { W as WorklogState } from '../types-Dvu9y4WM.mjs';
-import { T as ToolExecutionResponse } from '../types-DnfWUE9V.mjs';
 import { C as CatalogManifest } from '../registry-Bcu_ZYL1.mjs';
-import { U as UIAction } from '../actions-Ca3ro-hX.mjs';
+import { U as UIAction } from '../actions-BjDPJdyA.mjs';
 import '@elastic/apm-rum';
 import 'ai';
 import 'zod';
@@ -49,6 +49,7 @@ declare function useAlquimia(config: UseAlquimiaConfig): {
         surfaces: GenuiSurfaceItem[];
         onAgentAction: (controlId: string) => (action: UIAction) => void;
         awaitingUser: boolean;
+        dismiss: (userMessage?: string) => void;
     } | undefined;
     cleanMessages: () => void;
     createMessageId: typeof createMessageId;
@@ -73,7 +74,7 @@ declare function useAlquimia(config: UseAlquimiaConfig): {
     messages: AlquimiaMessage[];
     populateMessages: (messages: AlquimiaMessage[]) => void;
     processMessageChunk: (messageId: string, chunk: string, error_code?: string, error_detail?: string, taskid?: string, additionalInfo?: string, loading?: boolean, tooler?: ToolEvent[], thinkings?: any[]) => void;
-    sendMessage: (message: string, callBack: (chunk: AIMessageChunk) => void, traceParentId?: string, sessionId?: string) => Promise<void>;
+    sendMessage: (message: string, callBack: (_chunk: AIMessageChunk) => void, traceParentId?: string, sessionId?: string) => Promise<void>;
     sessionId: string | null;
     setActiveTool: react.Dispatch<any>;
     setSessionId: react.Dispatch<react.SetStateAction<string | null>>;
@@ -92,11 +93,11 @@ declare function useAlquimia(config: UseAlquimiaConfig): {
 interface UseRatingsParams {
     assistantId: string;
     topicId: string;
-    sendRating: (ratingData: RatingData) => Promise<any>;
-    onError?: (componentName: string, error: Error) => void;
+    sendRating: (_ratingData: RatingData) => Promise<any>;
+    onError?: (_componentName: string, _error: Error) => void;
 }
-declare function useRatings({ assistantId, sendRating, topicId }: UseRatingsParams): {
-    handleRate: (key: string, value: any | string, onHandleRateSuccess: (success: boolean, err?: string) => void) => Promise<void>;
+declare function useRatings({ assistantId, sendRating, topicId, onError }: UseRatingsParams): {
+    handleRate: (key: string, value: any | string, onHandleRateSuccess: (_success: boolean, _err?: string) => void) => Promise<void>;
     ratingStars: number;
     ratingThumbs: "" | "thumbsUp" | "thumbsDown";
     ratingComment: string;

package/dist/hooks/index.d.ts

@@ -1,13 +1,13 @@
 import * as react from 'react';
 import { AlquimiaSDK } from '../sdk/index.js';
 import { AlquimiaAdapter } from '../adapters/index.js';
-import { W as WhisperProvider, S as StableDiffusionProvider, C as CharacterizationProvider, R as RatingsProvider, L as LoggerProvider } from '../providers-BJTXCtI3.js';
-import { GenuiSurfaceItem, AlquimiaMessage, ToolEvent, AIMessageChunk, RatingData } from '../types/index.js';
+import { W as WhisperProvider, S as StableDiffusionProvider, C as CharacterizationProvider, R as RatingsProvider, L as LoggerProvider } from '../providers-b5_yMyMo.js';
+import { G as GenuiSurfaceItem, e as AlquimiaMessage, u as ToolEvent, a as AIMessageChunk, R as RatingData } from '../type-xksRnBUW.js';
+import { T as ToolExecutionResponse } from '../types-CMVbyEv8.js';
+import { a as WorklogState } from '../types-C-6fgK1_.js';
 import { createMessageId } from '../utils/index.js';
-import { W as WorklogState } from '../types-Dvu9y4WM.js';
-import { T as ToolExecutionResponse } from '../types-DnfWUE9V.js';
 import { C as CatalogManifest } from '../registry-Bcu_ZYL1.js';
-import { U as UIAction } from '../actions-BebMyGqF.js';
+import { U as UIAction } from '../actions-CP1d4Ye1.js';
 import '@elastic/apm-rum';
 import 'ai';
 import 'zod';
@@ -49,6 +49,7 @@ declare function useAlquimia(config: UseAlquimiaConfig): {
         surfaces: GenuiSurfaceItem[];
         onAgentAction: (controlId: string) => (action: UIAction) => void;
         awaitingUser: boolean;
+        dismiss: (userMessage?: string) => void;
     } | undefined;
     cleanMessages: () => void;
     createMessageId: typeof createMessageId;
@@ -73,7 +74,7 @@ declare function useAlquimia(config: UseAlquimiaConfig): {
     messages: AlquimiaMessage[];
     populateMessages: (messages: AlquimiaMessage[]) => void;
     processMessageChunk: (messageId: string, chunk: string, error_code?: string, error_detail?: string, taskid?: string, additionalInfo?: string, loading?: boolean, tooler?: ToolEvent[], thinkings?: any[]) => void;
-    sendMessage: (message: string, callBack: (chunk: AIMessageChunk) => void, traceParentId?: string, sessionId?: string) => Promise<void>;
+    sendMessage: (message: string, callBack: (_chunk: AIMessageChunk) => void, traceParentId?: string, sessionId?: string) => Promise<void>;
     sessionId: string | null;
     setActiveTool: react.Dispatch<any>;
     setSessionId: react.Dispatch<react.SetStateAction<string | null>>;
@@ -92,11 +93,11 @@ declare function useAlquimia(config: UseAlquimiaConfig): {
 interface UseRatingsParams {
     assistantId: string;
     topicId: string;
-    sendRating: (ratingData: RatingData) => Promise<any>;
-    onError?: (componentName: string, error: Error) => void;
+    sendRating: (_ratingData: RatingData) => Promise<any>;
+    onError?: (_componentName: string, _error: Error) => void;
 }
-declare function useRatings({ assistantId, sendRating, topicId }: UseRatingsParams): {
-    handleRate: (key: string, value: any | string, onHandleRateSuccess: (success: boolean, err?: string) => void) => Promise<void>;
+declare function useRatings({ assistantId, sendRating, topicId, onError }: UseRatingsParams): {
+    handleRate: (key: string, value: any | string, onHandleRateSuccess: (_success: boolean, _err?: string) => void) => Promise<void>;
     ratingStars: number;
     ratingThumbs: "" | "thumbsUp" | "thumbsDown";
     ratingComment: string;

package/dist/hooks/index.js

@@ -46,6 +46,8 @@ var AlquimiaSDK = class {
     this.sessionId = null;
     // Internal subscription id from infer (`taskid` on the wire).
     this.streamId = null;
+    // W3C traceparent for the current turn, so infer and stream share one trace.
+    this.traceParent = null;
     this.tools = [];
     this.extraInstructions = null;
     this.assistantConfig = null;
@@ -166,11 +168,12 @@ var AlquimiaSDK = class {
     const result = (await this.axiosInstance.post(inferUrl, initMessage, {
       headers: {
         "Content-Type": "application/json",
-        "x-trace-parent": traceParent || "",
+        ...traceParent && { "x-trace-parent": traceParent },
         ...adapterHeaders,
         ...this.buildIdentityHeaders()
       }
     })).data;
+    this.traceParent = traceParent ?? null;
     this.streamId = result.taskid ?? null;
     this.attachmentResponses = result.attachments ?? [];
     this.attachments = [];
@@ -270,7 +273,10 @@ var AlquimiaSDK = class {
     if (!this.streamId) {
       throw new Error("Stream ID not initialized. Call sendMessage() first");
     }
-    return this.adapter.resolveStreamUrl(this.streamId);
+    const url = this.adapter.resolveStreamUrl(this.streamId);
+    if (!this.traceParent) return url;
+    const separator = url.includes("?") ? "&" : "?";
+    return `${url}${separator}trace_parent=${encodeURIComponent(this.traceParent)}`;
   }
   getStreamId() {
     return this.streamId;
@@ -523,7 +529,9 @@ function frameToRecord(frame) {
     control_id: frame.control_id ?? null,
     data: frame.data,
     status,
-    date_submitted: typeof frame.date_submitted === "string" ? frame.date_submitted : ""
+    date_submitted: typeof frame.date_submitted === "string" ? frame.date_submitted : "",
+    entry_hash: frame.entry_hash ?? null,
+    previous_hash: frame.previous_hash ?? null
   };
 }
 
@@ -679,6 +687,25 @@ var coreCatalog = {
 };
 
 // src/genui/actions.ts
+var DISMISS_ACTION = "userDismissedSurface";
+function buildDismissResult(surfaceId, userMessage) {
+  const said = typeof userMessage === "string" ? userMessage.trim() : "";
+  return {
+    action: DISMISS_ACTION,
+    surfaceId,
+    componentId: "",
+    data: {},
+    ...said ? { userMessage: said } : {}
+  };
+}
+function buildSurfaceResult(action) {
+  return {
+    action: action.action,
+    surfaceId: action.surfaceId,
+    componentId: action.componentId,
+    data: action.payload ?? {}
+  };
+}
 var URL_LIKE = /^\s*([a-z][a-z0-9+.-]*:|\/\/)/i;
 function assertSafeActionName(name) {
   if (typeof name !== "string" || name.length === 0) {
@@ -713,7 +740,15 @@ var surfaceShape = import_zod3.z.object({
 });
 var UAX31_ID = /^[\p{XID_Start}_][\p{XID_Continue}]*$/u;
 function validateProps(node, def2) {
-  const { id, component, children, child, binding, action, ...props } = node;
+  const {
+    id,
+    component: _component,
+    children: _children,
+    child: _child,
+    binding: _binding,
+    action: _action,
+    ...props
+  } = node;
   const parsed = def2.schema.safeParse(props);
   if (parsed.success) return { ok: true, value: parsed.data, errors: [] };
   return {
@@ -850,7 +885,9 @@ function buildGenuiClause(manifest, allowlist) {
     `Components: ${names.join(", ")}.`,
     `Style each component via the semantic vocabulary (never CSS, colors, or HTML): tone (${TONES.join("/")}), size (${SIZES.join("/")}), emphasis (low/medium/high), align (start/center/end), density (compact/comfortable), plus a component-specific variant where offered.`,
     "Data components MUST carry their data: Chart takes `data` (an array of row objects) + `series` (keys to plot) + `x` (the category key); Table takes `rows` (array of row objects) + `columns` ([{ key, header }] matching the row keys); List takes `items` (array); Stat takes `label`+`value`; KeyValue takes `data` (an object). Put the data inline on the component (or in dataModel referenced via `binding`).",
-    "To collect input, add a Button with an action { name, wantResponse: true }; its result (the data model) is returned to you. A surface with no such button is display-only.",
+    "To collect input, add a Button with an action { name, wantResponse: true }. You get back { action, surfaceId, componentId, data } \u2014 `data` is the collected data model and `componentId` is the id of the component that was acted on. A surface with no such button is display-only.",
+    "When you render several options to choose from (a grid of cards, each with its own button), give every option component a MEANINGFUL id (e.g. flight-NH107, hotel-memmo-alfama): `componentId` tells you which one the user picked, so never ask them to repeat a choice they already made.",
+    'The user may ignore an interactive surface and just type instead. You then receive action "userDismissedSurface" with their words in `userMessage` \u2014 treat it as their reply, answer it directly, and do not re-render the same surface or scold them for not using it.',
     "IMPORTANT: the rendered surface IS your reply \u2014 do NOT reproduce its content as text, markdown, or ASCII; a one-line intro at most.",
     "Prefer plain text for simple replies."
   ].join(" ");
@@ -1276,15 +1313,44 @@ function useAlquimia(config) {
         control_id: controlId,
         tool_name: "render_ui",
         status: "success",
-        result: { action: action.action, surfaceId: action.surfaceId, data: action.payload }
+        // Includes componentId, so the agent can tell which element was acted on when
+        // several share one action name (a grid of option cards, say).
+        result: buildSurfaceResult(action)
       });
     },
     [completeToolExecution]
   );
+  const genuiDismiss = (0, import_react2.useCallback)(
+    (userMessage) => {
+      if (!pendingClientTool || pendingClientTool.toolName !== "render_ui") return;
+      const { controlId } = pendingClientTool;
+      const said = typeof userMessage === "string" ? userMessage.trim() : "";
+      const item = genuiSurfaces.find((s) => s.controlId === controlId);
+      setGenuiSurfaces(
+        (prev) => prev.map(
+          (s) => s.controlId === controlId ? { ...s, submitted: true, dismissedWith: said || void 0 } : s
+        )
+      );
+      if (said) setInput("");
+      void completeToolExecution(controlId, {
+        control_id: controlId,
+        tool_name: "render_ui",
+        status: "success",
+        result: buildDismissResult(item?.surface.surfaceId ?? "", said)
+      });
+    },
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [pendingClientTool, genuiSurfaces, completeToolExecution]
+  );
   const genuiAwaitingUser = !!(pendingClientTool && pendingClientTool.toolName === "render_ui" && genuiSurfaces.some(
     (s) => s.controlId === pendingClientTool.controlId && s.surface.components.some((c) => c.action?.wantResponse === true)
   ));
-  const genui = config.genui ? { surfaces: genuiSurfaces, onAgentAction: genuiOnAgentAction, awaitingUser: genuiAwaitingUser } : void 0;
+  const genui = config.genui ? {
+    surfaces: genuiSurfaces,
+    onAgentAction: genuiOnAgentAction,
+    awaitingUser: genuiAwaitingUser,
+    dismiss: genuiDismiss
+  } : void 0;
   return {
     sdk,
     activeTool,
@@ -1345,14 +1411,14 @@ function ratingReducer(state, action) {
       return state;
   }
 }
-function useRatings({ assistantId, sendRating, topicId }) {
+function useRatings({ assistantId, sendRating, topicId, onError }) {
   const [isLoading, setIsLoading] = (0, import_react3.useState)(false);
   const [hasReviewed, setHasReviewed] = (0, import_react3.useState)(false);
   const [state, dispatch] = (0, import_react3.useReducer)(ratingReducer, initialState);
   const setRatingStars = (rating) => {
     dispatch({ type: "SET_RATING_STARS", payload: rating });
   };
-  const setRatingThumbs = (rating) => {
+  const _setRatingThumbs = (rating) => {
     dispatch({ type: "SET_RATING_THUMBS", payload: rating });
   };
   const setRatingComment = (comment) => {
@@ -1375,7 +1441,9 @@ function useRatings({ assistantId, sendRating, topicId }) {
       const response = await sendRating(ratingObj);
       if (!response.success) {
         setIsLoading(false);
-        onHandleRateSuccess(false, response.error.message);
+        const error = new Error(response.error?.message ?? "Failed to send rating");
+        onHandleRateSuccess(false, error.message);
+        onError?.("useRatings", error);
         return;
       }
       if (key === "score") {
@@ -1388,7 +1456,9 @@ function useRatings({ assistantId, sendRating, topicId }) {
       onHandleRateSuccess(true);
     } catch (err) {
       setIsLoading(false);
-      onHandleRateSuccess(false, String(err));
+      const error = err instanceof Error ? err : new Error(String(err));
+      onHandleRateSuccess(false, error.message);
+      onError?.("useRatings", error);
     }
   };
   return {