@anuma/sdk 11.0.1 → 11.2.0

package/dist/tools/index.mjs

@@ -2346,9 +2346,9 @@ function createDisplayTool(options, config) {
       description: config.description,
       arguments: config.parameters
     },
-    executor: async (args) => {
+    executor: async (args, _signal, execution) => {
       const result = await Promise.resolve(config.execute(args));
-      const context = options.getContext();
+      const context = execution?.detached ? null : options.getContext();
       if (context) {
         const interactionId = generateInteractionId(config.displayType);
         const replacesInteractionId = config.getReplacesInteractionId?.(args);
@@ -2363,11 +2363,22 @@ function createDisplayTool(options, config) {
       }
       return result;
     },
-    skipContinuation: true
+    skipContinuation: true,
+    detachedClass: "render"
   };
 }
 
 // src/tools/chart.ts
+var VALUE_FORMATS = ["number", "currency", "percent"];
+var CURRENCY_CODE = /^[A-Z]{3}$/;
+function toValueFormat(value) {
+  return VALUE_FORMATS.find((format) => format === value);
+}
+function toCurrencyCode(value) {
+  if (typeof value !== "string") return void 0;
+  const code = value.trim().toUpperCase();
+  return CURRENCY_CODE.test(code) ? code : void 0;
+}
 var NUMERIC_STRING = /^[-+]?(?:\d+\.?\d*|\.\d+)(?:e[-+]?\d+)?$/i;
 var THOUSANDS_GROUPED = /^[-+]?\d{1,3}(?:,\d{3})+(?:\.\d*)?$/;
 function toNumber(value) {
@@ -2384,7 +2395,7 @@ function toNumber(value) {
 function createChartTool(options) {
   return createDisplayTool(options, {
     name: "display_chart",
-    description: 'Render a bar, line, area, or pie chart inline \u2014 visualize data, plot a trend over time, or graph a comparison. Use whenever the user asks to chart, plot, graph, or visualize numbers (sales, prices, temperatures, metrics). You MUST pass the actual numeric values in the "data" array \u2014 they are never inferred. Do not chart price or market history (crypto, stocks, market caps) unless those values came from a tool result or a cited source earlier in this conversation; never fill a price series from memory.',
+    description: 'Render a bar, line, area, or pie chart inline \u2014 visualize data, plot a trend over time, or graph a comparison. Use whenever the user asks to chart, plot, graph, or visualize numbers (sales, prices, temperatures, metrics). You MUST pass the actual numeric values in the "data" array \u2014 they are never inferred. Do not chart price or market history (crypto, stocks, market caps) unless those values came from a tool result or a cited source earlier in this conversation; never fill a price series from memory. Set valueFormat to "currency" for prices and money, or "percent" for percentage values.',
     parameters: {
       type: "object",
       properties: {
@@ -2418,6 +2429,15 @@ function createChartTool(options) {
           type: "object",
           additionalProperties: { type: "string" },
           description: "Optional color overrides. Map of dataKey to CSS color value (e.g. { 'revenue': '#2563eb' }). If omitted, uses theme chart colors."
+        },
+        valueFormat: {
+          type: "string",
+          enum: ["number", "currency", "percent"],
+          description: 'How to display the values on the axis, tooltip and headline. "currency" for prices and money (set currency too), "percent" when values are already percentages (3.2 means 3.2%). Defaults to "number".'
+        },
+        currency: {
+          type: "string",
+          description: 'ISO 4217 currency code used when valueFormat is "currency", e.g. "USD" or "EUR". Defaults to USD.'
         }
       },
       required: ["chartType", "data", "dataKeys"]
@@ -2469,7 +2489,9 @@ function createChartTool(options) {
         data: points,
         dataKeys,
         xAxisKey: args.xAxisKey,
-        colors: args.colors
+        colors: args.colors,
+        valueFormat: toValueFormat(args.valueFormat),
+        currency: toCurrencyCode(args.currency)
       };
     }
   });

package/dist/tools/selection/index.d.mts

@@ -5,7 +5,13 @@ type LlmapiChatCompletionTool = {
 /**
  * Tool executor function type
  */
-type ToolExecutor = (args: Record<string, unknown>, signal?: AbortSignal) => Promise<unknown> | unknown;
+type ToolExecutor = (args: Record<string, unknown>, signal?: AbortSignal, context?: ToolExecutionContext) => Promise<unknown> | unknown;
+/** How the portal treats a call to this device tool while the device is away. */
+type DetachedToolClass = "render" | "deferred";
+/** Context for one executor run; `detached` marks a call from an answer finished while the device was away. */
+type ToolExecutionContext = {
+    detached?: boolean;
+};
 /**
  * Tool configuration with optional executor
  */
@@ -75,6 +81,8 @@ type ToolConfig = LlmapiChatCompletionTool & {
      * files from IndexedDB that `create_file` writes.
      */
     dependsOn?: string[];
+    /** How the portal handles a call to this tool while the device is away; unset tools pause the turn. */
+    detachedClass?: DetachedToolClass;
 };
 
 /** Tool parameters schema */

package/dist/tools/selection/index.d.ts

@@ -5,7 +5,13 @@ type LlmapiChatCompletionTool = {
 /**
  * Tool executor function type
  */
-type ToolExecutor = (args: Record<string, unknown>, signal?: AbortSignal) => Promise<unknown> | unknown;
+type ToolExecutor = (args: Record<string, unknown>, signal?: AbortSignal, context?: ToolExecutionContext) => Promise<unknown> | unknown;
+/** How the portal treats a call to this device tool while the device is away. */
+type DetachedToolClass = "render" | "deferred";
+/** Context for one executor run; `detached` marks a call from an answer finished while the device was away. */
+type ToolExecutionContext = {
+    detached?: boolean;
+};
 /**
  * Tool configuration with optional executor
  */
@@ -75,6 +81,8 @@ type ToolConfig = LlmapiChatCompletionTool & {
      * files from IndexedDB that `create_file` writes.
      */
     dependsOn?: string[];
+    /** How the portal handles a call to this tool while the device is away; unset tools pause the turn. */
+    detachedClass?: DetachedToolClass;
 };
 
 /** Tool parameters schema */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anuma/sdk",
-  "version": "11.0.1",
+  "version": "11.2.0",
   "description": "",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",