@alquimia-ai/tools 2.4.0 → 2.7.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-B4IOiGfr.mjs';
+import { G as GenuiSurfaceItem, e as AlquimiaMessage, F as ToolEvent, a as AIMessageChunk, R as RatingData } from '../type-61gaZga-.mjs';
+import { T as ToolExecutionResponse } from '../types-CMVbyEv8.mjs';
+import { a as WorklogState } from '../types-lOliroPw.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-CZU_GRy5.mjs';
+import { U as UIAction } from '../actions-BjDPJdyA.mjs';
 import '@elastic/apm-rum';
 import 'ai';
 import 'zod';
@@ -74,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>>;
@@ -93,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-mx21gNgZ.js';
+import { G as GenuiSurfaceItem, e as AlquimiaMessage, F as ToolEvent, a as AIMessageChunk, R as RatingData } from '../type-D-JaSMkV.js';
+import { T as ToolExecutionResponse } from '../types-CMVbyEv8.js';
+import { a as WorklogState } from '../types-lOliroPw.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-B0hfoYRd.js';
+import { U as UIAction } from '../actions-CP1d4Ye1.js';
 import '@elastic/apm-rum';
 import 'ai';
 import 'zod';
@@ -74,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>>;
@@ -93,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,11 @@ 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;
+    // Registry version tag resolved by the runtime for this task (v0.5.1), so
+    // the tool-completion half of the turn lands on the same agentspace version.
+    this.versionTag = null;
     this.tools = [];
     this.extraInstructions = null;
     this.assistantConfig = null;
@@ -126,6 +131,19 @@ var AlquimiaSDK = class {
     this.userId = userId;
     return this;
   }
+  /**
+   * Pin inference to a cached registry version. Sent as the `version_tag`
+   * query parameter, which `POST /event/infer/{assistant_id}` accepts from
+   * **runtime v0.5.2** onward; older runtimes ignore it.
+   *
+   * Works on every version: pass a versioned assistant ref
+   * (`<agentspace>/<assistant>[:<tag>]`) as the `assistantId` instead — the
+   * runtime parses the tag out of the path itself.
+   */
+  withVersionTag(versionTag) {
+    this.versionTag = versionTag;
+    return this;
+  }
   getEnforceCharacterization() {
     return this.enforceCharacterization ?? true;
   }
@@ -141,19 +159,29 @@ var AlquimiaSDK = class {
     }
     return this.whisperProvider.speechToText(audio);
   }
-  async sendMessage(query, traceParent) {
+  async sendMessage(query, options = {}) {
     if (!this.conversationId) {
       throw new Error(
         "Conversation not initialized. Call withConversationId() before sendMessage()"
       );
     }
-    const inferUrl = this.adapter.resolveInferUrl(this.assistantId);
+    const opts = typeof options === "string" ? { traceParent: options } : options;
+    if (query === void 0 && !opts.inputAudio) {
+      throw new Error(
+        "AlquimiaSDK: sendMessage needs a query, an inputAudio blob, or both"
+      );
+    }
+    const baseInferUrl = this.adapter.resolveInferUrl(this.assistantId);
+    const inferUrl = this.versionTag ? `${baseInferUrl}${baseInferUrl.includes("?") ? "&" : "?"}version_tag=${encodeURIComponent(this.versionTag)}` : baseInferUrl;
     const adapterHeaders = this.adapter.getHeaders?.() ?? {};
     const hasClientTools = Array.isArray(this.tools) && this.tools.length > 0;
     const initMessage = {
-      query,
+      ...query !== void 0 && { query },
       session_id: this.conversationId,
       user_id: this.userId,
+      ...opts.inputAudio && { input_audio: opts.inputAudio },
+      // Only sent when set: the runtime defaults `output_audio` to true.
+      ...opts.outputAudio !== void 0 && { output_audio: opts.outputAudio },
       ...this.extraInstructions && { extra_instructions: this.extraInstructions },
       ...this.assistantConfig && { config: this.assistantConfig },
       ...hasClientTools && {
@@ -166,12 +194,14 @@ var AlquimiaSDK = class {
     const result = (await this.axiosInstance.post(inferUrl, initMessage, {
       headers: {
         "Content-Type": "application/json",
-        "x-trace-parent": traceParent || "",
+        ...opts.traceParent && { "x-trace-parent": opts.traceParent },
         ...adapterHeaders,
         ...this.buildIdentityHeaders()
       }
     })).data;
+    this.traceParent = opts.traceParent ?? null;
     this.streamId = result.taskid ?? null;
+    this.versionTag = result.versiontag ?? this.versionTag;
     this.attachmentResponses = result.attachments ?? [];
     this.attachments = [];
     return this;
@@ -198,6 +228,7 @@ var AlquimiaSDK = class {
       ...this.streamId && { taskid: this.streamId },
       ...this.conversationId && { sessionid: this.conversationId },
       ...this.userId && { userid: this.userId },
+      ...this.versionTag && { versiontag: this.versionTag },
       ...adapterHeaders
     };
     await this.axiosInstance.post(url, response, { headers });
@@ -240,18 +271,23 @@ var AlquimiaSDK = class {
   getAttachmentResponses() {
     return this.attachmentResponses;
   }
+  /**
+   * Upload a file into the session context. Returns the runtime {@link RuntimeBlob},
+   * which is what `sendMessage`'s `inputAudio` expects for audio inference.
+   */
   async uploadAttachment(file, _attachmentId) {
     const url = this.adapter.resolveBlobUploadUrl();
     const adapterHeaders = this.adapter.getHeaders?.() ?? {};
     const formData = new FormData();
     formData.append("file", file);
-    await this.axiosInstance.post(url, formData, {
+    const response = await this.axiosInstance.post(url, formData, {
       headers: {
         "Content-Type": "multipart/form-data",
         ...adapterHeaders,
         ...this.buildIdentityHeaders()
       }
     });
+    return response.data;
   }
   /**
    * Identity headers (kebab-case) required by `/context/blob/upload` and
@@ -270,7 +306,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;
@@ -279,6 +318,10 @@ var AlquimiaSDK = class {
   getTaskId() {
     return this.streamId;
   }
+  /** Registry version tag resolved by the runtime for the current task, if any. */
+  getVersionTag() {
+    return this.versionTag;
+  }
 };
 var alquimia_sdk_default = AlquimiaSDK;
 
@@ -383,6 +426,14 @@ var agentTitle = (r) => {
   return typeof name === "string" && name.length > 0 ? `Agent: ${name}` : "Agent-to-agent";
 };
 var constTitle = (label) => () => label;
+var shieldBlockTitle = (r) => {
+  const id = asRecord(r.data).shield_id;
+  return typeof id === "string" && id.length > 0 ? `Blocked by ${id}` : "Blocked by safeguard";
+};
+var knowledgeTitle = (r) => {
+  const query = asRecord(r.data).query;
+  return typeof query === "string" && query.length > 0 ? `Knowledge: ${query}` : "Knowledge retrieval";
+};
 var EVENT_REGISTRY = {
   // Run envelope
   AssistantInference: { kind: "answer", role: "run-open", title: constTitle("Inference started") },
@@ -390,6 +441,9 @@ var EVENT_REGISTRY = {
   // Safeguard
   ShieldInference: { kind: "safeguard", role: "open", title: constTitle("Safeguard") },
   ShieldInferenceResponse: { kind: "safeguard", role: "close", title: constTitle("Safeguard") },
+  // Emitted when a shield enforcement decision blocks the request (core 0.5.x).
+  // Response-only: the reducer opens it already closed when no command matched.
+  ShieldBlockedResponse: { kind: "safeguard", role: "close", title: shieldBlockTitle },
   // Reasoning
   ResponseInference: { kind: "reasoning", role: "open", title: constTitle("Reasoning") },
   ResponseInferenceResponse: { kind: "reasoning", role: "close", title: constTitle("Reasoning") },
@@ -407,6 +461,14 @@ var EVENT_REGISTRY = {
   A2AInference: { kind: "a2a", role: "open", title: agentTitle },
   AgentDiscovery: { kind: "a2a", role: "open", title: constTitle("Agent discovery") },
   AgentDiscoveryResponse: { kind: "a2a", role: "close", title: constTitle("Agent discovery") },
+  // Knowledge retrieval (RAG) — core 0.5.x
+  KnowledgeRetrieval: { kind: "knowledge", role: "open", title: knowledgeTitle },
+  KnowledgeRetrievalResponse: { kind: "knowledge", role: "close", title: knowledgeTitle },
+  // Speech pipeline — core 0.5.x
+  SpeechTranscription: { kind: "speech", role: "open", title: constTitle("Speech-to-text") },
+  SpeechTranscriptionResponse: { kind: "speech", role: "close", title: constTitle("Speech-to-text") },
+  SpeechSynthesis: { kind: "speech", role: "open", title: constTitle("Text-to-speech") },
+  SpeechSynthesisResponse: { kind: "speech", role: "close", title: constTitle("Text-to-speech") },
   // Memory / persistence
   ContextPersistence: { kind: "memory", role: "open", title: constTitle("Memory persistence") },
   ContextFlush: { kind: "memory", role: "open", title: constTitle("Memory flush") },
@@ -523,7 +585,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
   };
 }
 
@@ -732,7 +796,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 {
@@ -1395,14 +1467,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) => {
@@ -1425,7 +1497,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") {
@@ -1438,7 +1512,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 {