@anuma/sdk 6.27.8 → 6.28.0

package/dist/server/index.mjs

@@ -31547,6 +31547,23 @@ var BUILT_IN_TOOL_SETS = [
     members: ["dropbox_list_folders", "dropbox_get_file_content", "dropbox_search"],
     anchors: ["dropbox_list_folders", "dropbox_search"],
     anchorMinSimilarity: 0.53
+  },
+  {
+    // Server tools, so this set does its work through
+    // withActiveToolSetServerTools: once a restaurant tool has run, terse
+    // follow-ups ("okay", "same as before") keep the booking chain. Each tool
+    // still reaches a fresh booking request on its own description.
+    // Anchors are deliberately empty (like the client's Nearby set): the set
+    // is only for stickiness, not a new way to activate on a prompt.
+    // prompt_user_confirm is left out of members: autoFilterClientTools always
+    // sends it, and as a member any unrelated confirmation would pin this set.
+    name: "restaurant-booking",
+    members: [
+      "AnumaPaymentsMCP-anuma_find_restaurant",
+      "AnumaPaymentsMCP-anuma_check_restaurant_availability",
+      "AnumaPaymentsMCP-anuma_book_restaurant"
+    ],
+    anchors: []
   }
 ];
 function expandToolSetsAdditive(matchedNames, availableNames, scores, toolSets, activeSetNames) {
@@ -31580,6 +31597,16 @@ function activatedToolSetNames(scores, toolSets = BUILT_IN_TOOL_SETS, activeSetN
   }
   return activated;
 }
+function withActiveToolSetServerTools(selected, allServerTools, serverToolsFilter, activeToolSets = [], extraToolSets = []) {
+  if (activeToolSets.length === 0) return selected;
+  const sticky = new Set(
+    [...BUILT_IN_TOOL_SETS, ...extraToolSets].filter((ts) => activeToolSets.includes(ts.name)).flatMap((ts) => ts.members)
+  );
+  for (const name of serverToolsFilter.excludeTools ?? []) sticky.delete(name);
+  for (const tool of selected) sticky.delete(tool.name);
+  const added = allServerTools.filter((tool) => sticky.has(tool.name));
+  return added.length > 0 ? [...selected, ...added] : selected;
+}
 function toolSetSystemPrompts(selectedToolNames, toolSets = BUILT_IN_TOOL_SETS, activatedSetNames) {
   const selected = selectedToolNames instanceof Set ? selectedToolNames : new Set(selectedToolNames);
   const prompts = [];
@@ -31693,7 +31720,9 @@ async function selectServerToolsForPrompt(options) {
     embeddingModel,
     cacheExpirationMs,
     cache,
-    deferLoading
+    deferLoading,
+    activeToolSets,
+    extraToolSets
   } = options;
   if (serverToolsFilter === void 0) return [];
   if (Array.isArray(serverToolsFilter) && serverToolsFilter.length === 0) return [];
@@ -31707,7 +31736,14 @@ async function selectServerToolsForPrompt(options) {
   if (deferLoading?.enabled)
     return resolveDeferredServerTools(allServerTools, serverToolsFilter, deferLoading);
   if (typeof serverToolsFilter === "function") {
-    if (prompt.length < MIN_CONTENT_LENGTH_FOR_TOOLS) return [];
+    const withSticky = (selected) => withActiveToolSetServerTools(
+      selected,
+      allServerTools,
+      serverToolsFilter,
+      activeToolSets,
+      extraToolSets
+    );
+    if (prompt.length < MIN_CONTENT_LENGTH_FOR_TOOLS) return withSticky([]);
     let promptEmbedding;
     try {
       promptEmbedding = await generateEmbedding(prompt, {
@@ -31716,10 +31752,10 @@ async function selectServerToolsForPrompt(options) {
         model: embeddingModel
       });
     } catch {
-      return [];
+      return withSticky([]);
     }
     const names = serverToolsFilter(promptEmbedding, allServerTools);
-    return filterServerTools(allServerTools, names);
+    return withSticky(filterServerTools(allServerTools, names));
   }
   return filterServerTools(allServerTools, serverToolsFilter);
 }
@@ -33629,6 +33665,12 @@ var ToolTimeoutError = class extends Error {
     this.name = "ToolTimeoutError";
   }
 };
+var ToolCancelledError = class extends Error {
+  constructor() {
+    super("Tool execution cancelled");
+    this.name = "ToolCancelledError";
+  }
+};
 function safeJsonStringify(value) {
   try {
     return JSON.stringify(value) ?? "null";
@@ -33636,7 +33678,7 @@ function safeJsonStringify(value) {
     return String(value);
   }
 }
-async function executeToolCall(toolCall, executor, timeoutMs = TOOL_EXECUTOR_TIMEOUT_MS) {
+async function executeToolCall(toolCall, executor, timeoutMs = TOOL_EXECUTOR_TIMEOUT_MS, signal) {
   let args = {};
   if (toolCall.arguments) {
     const parsed = parseToolArguments(toolCall.arguments);
@@ -33645,28 +33687,42 @@ async function executeToolCall(toolCall, executor, timeoutMs = TOOL_EXECUTOR_TIM
     }
     args = parsed.args;
   }
+  if (signal?.aborted) {
+    return { error: "Tool execution cancelled", errorType: "cancelled" };
+  }
+  let timer;
+  let onAbort;
   try {
-    if (!isFinite(timeoutMs)) {
-      return { result: await executor(args) };
+    const racers = [];
+    if (signal) {
+      racers.push(
+        new Promise((_, reject) => {
+          onAbort = () => reject(new ToolCancelledError());
+          signal.addEventListener("abort", onAbort, { once: true });
+        })
+      );
     }
-    let timer;
-    try {
-      const result = await Promise.race([
-        executor(args),
+    racers.push(Promise.resolve(signal ? executor(args, signal) : executor(args)));
+    if (isFinite(timeoutMs)) {
+      racers.push(
         new Promise((_, reject) => {
           timer = setTimeout(() => reject(new ToolTimeoutError()), timeoutMs);
         })
-      ]);
-      return { result };
-    } finally {
-      clearTimeout(timer);
+      );
     }
+    return { result: await Promise.race(racers) };
   } catch (e) {
+    if (e instanceof ToolCancelledError) {
+      return { error: "Tool execution cancelled", errorType: "cancelled" };
+    }
     const message = e instanceof Error ? e.message : String(e);
     return {
       error: `Tool execution failed: ${message}`,
       errorType: e instanceof ToolTimeoutError ? "timeout" : "execution"
     };
+  } finally {
+    clearTimeout(timer);
+    if (onAbort) signal?.removeEventListener("abort", onAbort);
   }
 }
 function toolsToApiFormat(tools, apiType) {
@@ -36022,11 +36078,12 @@ Executing tool: ${toolInfo}
             const blockedByFailure = failedDeps.some((d) => failedNames.has(d));
             const reason = blockedByFailure ? `failed dependencies: ${failedDeps.join(", ")}` : "a dependency cycle";
             const errorMsg = `Tool "${tc.name}" was not executed due to ${reason}`;
+            const skipErrorType = combinedSignal?.aborted ? "cancelled" : "execution";
             executionResults.push({
               id: tc.id,
               name: tc.name,
               error: errorMsg,
-              errorType: "execution"
+              errorType: skipErrorType
             });
             await safeAwait(
               () => hooks?.afterToolUse?.({
@@ -36035,7 +36092,7 @@ Executing tool: ${toolInfo}
                 toolCallId: tc.id,
                 name: tc.name,
                 error: errorMsg,
-                errorType: "execution"
+                errorType: skipErrorType
               })
             );
           }
@@ -36055,7 +36112,8 @@ Executing tool: ${toolInfo}
             const { result, error, errorType } = await executeToolCall(
               toolCallForExec,
               executorConfig.executor,
-              executorConfig.executorTimeout
+              executorConfig.executorTimeout,
+              combinedSignal
             );
             await safeAwait(
               () => hooks?.afterToolUse?.({

package/dist/telemetry/index.d.mts

@@ -147,7 +147,7 @@ type ToolUseEndEvent = {
     name: string;
     result?: unknown;
     error?: string;
-    errorType?: "parse" | "timeout" | "execution";
+    errorType?: "parse" | "timeout" | "execution" | "cancelled";
 };
 type RunStartEvent = {
     runId: string;

package/dist/telemetry/index.d.ts

@@ -147,7 +147,7 @@ type ToolUseEndEvent = {
     name: string;
     result?: unknown;
     error?: string;
-    errorType?: "parse" | "timeout" | "execution";
+    errorType?: "parse" | "timeout" | "execution" | "cancelled";
 };
 type RunStartEvent = {
     runId: string;

package/dist/tools/index.cjs

@@ -515,7 +515,7 @@ function createInteractiveTool(options, config) {
       description: config.description,
       arguments: config.parameters
     },
-    executor: async (args) => {
+    executor: async (args, signal) => {
       if (config.validate && !config.validate(args)) {
         return { cancelled: true };
       }
@@ -525,6 +525,8 @@ function createInteractiveTool(options, config) {
       }
       const interactionId = generateInteractionId(config.interactionType);
       const interactionData = config.mapArgs ? config.mapArgs(args) : args;
+      const onAbort = () => context.cancelInteraction?.(interactionId);
+      signal?.addEventListener("abort", onAbort, { once: true });
       try {
         const result = await context.createInteraction(interactionId, config.interactionType, {
           ...interactionData,
@@ -536,6 +538,8 @@ function createInteractiveTool(options, config) {
         return result;
       } catch {
         return { cancelled: true };
+      } finally {
+        signal?.removeEventListener("abort", onAbort);
       }
     },
     // Interactive tools wait for user input and should not be subject

package/dist/tools/index.d.mts

@@ -2,7 +2,7 @@ type LlmapiChatCompletionTool = {
     [key: string]: unknown;
 };
 
-type ToolExecutionErrorType = "parse" | "timeout" | "execution";
+type ToolExecutionErrorType = "parse" | "timeout" | "execution" | "cancelled";
 type ToolExecutionResult = {
     result?: unknown;
     error?: string;
@@ -13,7 +13,7 @@ type ToolExecutionResult = {
 /**
  * Tool executor function type
  */
-type ToolExecutor = (args: Record<string, unknown>) => Promise<unknown> | unknown;
+type ToolExecutor = (args: Record<string, unknown>, signal?: AbortSignal) => Promise<unknown> | unknown;
 /**
  * Tool configuration with optional executor
  */
@@ -140,6 +140,8 @@ declare function createChatTools(getAccessToken: () => string | null, requestCal
  */
 type UIInteractionContext = {
     createInteraction: (id: string, type: string, data: unknown) => Promise<unknown>;
+    /** Rejects and removes a pending interaction. Optional for older contexts. */
+    cancelInteraction?: (id: string) => void;
     createDisplayInteraction: (id: string, displayType: string, data: unknown, result: unknown, toolVersion?: number, replacesInteractionId?: string) => void;
 };
 /**

package/dist/tools/index.d.ts

@@ -2,7 +2,7 @@ type LlmapiChatCompletionTool = {
     [key: string]: unknown;
 };
 
-type ToolExecutionErrorType = "parse" | "timeout" | "execution";
+type ToolExecutionErrorType = "parse" | "timeout" | "execution" | "cancelled";
 type ToolExecutionResult = {
     result?: unknown;
     error?: string;
@@ -13,7 +13,7 @@ type ToolExecutionResult = {
 /**
  * Tool executor function type
  */
-type ToolExecutor = (args: Record<string, unknown>) => Promise<unknown> | unknown;
+type ToolExecutor = (args: Record<string, unknown>, signal?: AbortSignal) => Promise<unknown> | unknown;
 /**
  * Tool configuration with optional executor
  */
@@ -140,6 +140,8 @@ declare function createChatTools(getAccessToken: () => string | null, requestCal
  */
 type UIInteractionContext = {
     createInteraction: (id: string, type: string, data: unknown) => Promise<unknown>;
+    /** Rejects and removes a pending interaction. Optional for older contexts. */
+    cancelInteraction?: (id: string) => void;
     createDisplayInteraction: (id: string, displayType: string, data: unknown, result: unknown, toolVersion?: number, replacesInteractionId?: string) => void;
 };
 /**

package/dist/tools/index.mjs

@@ -359,7 +359,7 @@ function createInteractiveTool(options, config) {
       description: config.description,
       arguments: config.parameters
     },
-    executor: async (args) => {
+    executor: async (args, signal) => {
       if (config.validate && !config.validate(args)) {
         return { cancelled: true };
       }
@@ -369,6 +369,8 @@ function createInteractiveTool(options, config) {
       }
       const interactionId = generateInteractionId(config.interactionType);
       const interactionData = config.mapArgs ? config.mapArgs(args) : args;
+      const onAbort = () => context.cancelInteraction?.(interactionId);
+      signal?.addEventListener("abort", onAbort, { once: true });
       try {
         const result = await context.createInteraction(interactionId, config.interactionType, {
           ...interactionData,
@@ -380,6 +382,8 @@ function createInteractiveTool(options, config) {
         return result;
       } catch {
         return { cancelled: true };
+      } finally {
+        signal?.removeEventListener("abort", onAbort);
       }
     },
     // Interactive tools wait for user input and should not be subject

package/dist/tools/selection/index.cjs

@@ -116,7 +116,8 @@ __export(index_exports, {
   selectServerToolsForPrompt: () => selectServerToolsForPrompt,
   shouldRefreshTools: () => shouldRefreshTools,
   stripCoercedMemoryWrite: () => stripCoercedMemoryWrite,
-  toolSetSystemPrompts: () => toolSetSystemPrompts
+  toolSetSystemPrompts: () => toolSetSystemPrompts,
+  withActiveToolSetServerTools: () => withActiveToolSetServerTools
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -1993,6 +1994,23 @@ var BUILT_IN_TOOL_SETS = [
     members: ["dropbox_list_folders", "dropbox_get_file_content", "dropbox_search"],
     anchors: ["dropbox_list_folders", "dropbox_search"],
     anchorMinSimilarity: 0.53
+  },
+  {
+    // Server tools, so this set does its work through
+    // withActiveToolSetServerTools: once a restaurant tool has run, terse
+    // follow-ups ("okay", "same as before") keep the booking chain. Each tool
+    // still reaches a fresh booking request on its own description.
+    // Anchors are deliberately empty (like the client's Nearby set): the set
+    // is only for stickiness, not a new way to activate on a prompt.
+    // prompt_user_confirm is left out of members: autoFilterClientTools always
+    // sends it, and as a member any unrelated confirmation would pin this set.
+    name: "restaurant-booking",
+    members: [
+      "AnumaPaymentsMCP-anuma_find_restaurant",
+      "AnumaPaymentsMCP-anuma_check_restaurant_availability",
+      "AnumaPaymentsMCP-anuma_book_restaurant"
+    ],
+    anchors: []
   }
 ];
 function applyToolSets(matchedNames, availableNames, scores, toolSets = BUILT_IN_TOOL_SETS, independentThreshold = 0.65) {
@@ -2055,6 +2073,16 @@ function activatedToolSetNames(scores, toolSets = BUILT_IN_TOOL_SETS, activeSetN
   }
   return activated;
 }
+function withActiveToolSetServerTools(selected, allServerTools, serverToolsFilter, activeToolSets = [], extraToolSets = []) {
+  if (activeToolSets.length === 0) return selected;
+  const sticky = new Set(
+    [...BUILT_IN_TOOL_SETS, ...extraToolSets].filter((ts) => activeToolSets.includes(ts.name)).flatMap((ts) => ts.members)
+  );
+  for (const name of serverToolsFilter.excludeTools ?? []) sticky.delete(name);
+  for (const tool of selected) sticky.delete(tool.name);
+  const added = allServerTools.filter((tool) => sticky.has(tool.name));
+  return added.length > 0 ? [...selected, ...added] : selected;
+}
 function toolSetSystemPrompts(selectedToolNames, toolSets = BUILT_IN_TOOL_SETS, activatedSetNames) {
   const selected = selectedToolNames instanceof Set ? selectedToolNames : new Set(selectedToolNames);
   const prompts = [];
@@ -2168,7 +2196,9 @@ async function selectServerToolsForPrompt(options) {
     embeddingModel,
     cacheExpirationMs,
     cache,
-    deferLoading
+    deferLoading,
+    activeToolSets,
+    extraToolSets
   } = options;
   if (serverToolsFilter === void 0) return [];
   if (Array.isArray(serverToolsFilter) && serverToolsFilter.length === 0) return [];
@@ -2182,7 +2212,14 @@ async function selectServerToolsForPrompt(options) {
   if (deferLoading?.enabled)
     return resolveDeferredServerTools(allServerTools, serverToolsFilter, deferLoading);
   if (typeof serverToolsFilter === "function") {
-    if (prompt.length < MIN_CONTENT_LENGTH_FOR_TOOLS) return [];
+    const withSticky = (selected) => withActiveToolSetServerTools(
+      selected,
+      allServerTools,
+      serverToolsFilter,
+      activeToolSets,
+      extraToolSets
+    );
+    if (prompt.length < MIN_CONTENT_LENGTH_FOR_TOOLS) return withSticky([]);
     let promptEmbedding;
     try {
       promptEmbedding = await generateEmbedding(prompt, {
@@ -2191,10 +2228,10 @@ async function selectServerToolsForPrompt(options) {
         model: embeddingModel
       });
     } catch {
-      return [];
+      return withSticky([]);
     }
     const names = serverToolsFilter(promptEmbedding, allServerTools);
-    return filterServerTools(allServerTools, names);
+    return withSticky(filterServerTools(allServerTools, names));
   }
   return filterServerTools(allServerTools, serverToolsFilter);
 }
@@ -2836,5 +2873,6 @@ async function selectCouncilClientTools(input, options) {
   selectServerToolsForPrompt,
   shouldRefreshTools,
   stripCoercedMemoryWrite,
-  toolSetSystemPrompts
+  toolSetSystemPrompts,
+  withActiveToolSetServerTools
 });

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

@@ -5,7 +5,7 @@ type LlmapiChatCompletionTool = {
 /**
  * Tool executor function type
  */
-type ToolExecutor = (args: Record<string, unknown>) => Promise<unknown> | unknown;
+type ToolExecutor = (args: Record<string, unknown>, signal?: AbortSignal) => Promise<unknown> | unknown;
 /**
  * Tool configuration with optional executor
  */
@@ -505,6 +505,25 @@ declare function expandToolSetsAdditive(matchedNames: Set<string>, availableName
  * @param activeSetNames - Set names forced active regardless of score.
  */
 declare function activatedToolSetNames(scores: ReadonlyMap<string, number>, toolSets?: ToolSet[], activeSetNames?: ReadonlySet<string>): Set<string>;
+/**
+ * Add the server-tool members of every set named in `activeToolSets` to a
+ * semantic server-tool selection.
+ *
+ * A semantic filter ranks only the latest prompt, so a terse follow-up inside a
+ * flow ("okay", "retry") drops the flow's server tools. This is the server-side
+ * half of what `autoFilterClientTools` does for client tools: an active set's
+ * members that are in the catalog are kept whatever the prompt scored, even
+ * below the short-prompt gate, where `selected` is empty. Exclusions tagged on
+ * the filter still win.
+ *
+ * @param selected - What the semantic filter picked (`[]` when it did not run).
+ * @param allServerTools - The full server-tool catalog.
+ * @param serverToolsFilter - The filter function, read only for its `excludeTools` tag.
+ * @param activeToolSets - Set names that are sticky for this conversation.
+ * @param extraToolSets - The caller's sets beyond {@link BUILT_IN_TOOL_SETS}.
+ * @returns `selected`, followed by any active-set members it was missing.
+ */
+declare function withActiveToolSetServerTools(selected: ServerTool[], allServerTools: ServerTool[], serverToolsFilter: ServerToolsFilterFunction, activeToolSets?: readonly string[], extraToolSets?: readonly ToolSet[]): ServerTool[];
 /**
  * Collect the `systemPrompt` of every tool set that activated for a request,
  * for the caller to APPEND to its base system prompt.
@@ -679,6 +698,20 @@ interface SelectServerToolsForPromptOptions {
      * {@link resolveDeferredServerTools}). Omit/disabled → today's filtered selection.
      */
     deferLoading?: DeferLoadingConfig;
+    /**
+     * Tool-set names that are sticky for this conversation — the same list you
+     * pass to `useChatStorage`'s `activeToolSets`, e.g. from
+     * `deriveActiveToolSets`. With a filter function, the server-tool members of
+     * these sets are selected whatever the prompt scored, even on a prompt too
+     * short to embed. Omit for selection from the prompt alone.
+     */
+    activeToolSets?: string[];
+    /**
+     * The caller's sets beyond {@link BUILT_IN_TOOL_SETS} — the same list you pass
+     * to `useChatStorage`'s `extraToolSets` — so a custom set named in
+     * `activeToolSets` stays sticky here too.
+     */
+    extraToolSets?: ToolSet[];
 }
 /**
  * Select server-side tools for a prompt using the same path
@@ -1443,4 +1476,4 @@ declare function resolveServerTools(descriptor: ToolIntentDescriptor, catalog: S
  */
 declare function isCoercingIntent(creation: CreationIntent, catalog: ServerToolCatalog): boolean;
 
-export { type AssembledToolsFilterFn, BUILT_IN_TOOL_SETS, CLIENT_TOOLS_MIN_SIMILARITY, CLIENT_TOOLS_RELEVANCE_RATIO, CREATION_INTENT_CLIENT_FACTORIES, CREATION_INTENT_CLIENT_FILTER, CREATION_INTENT_TOOL_SET, type CachedServerTools, type ClientFactoryBuilder, type ClientFactoryKey, type ClientToolsFilterMode, type ConnectorGuidance, type ConnectorGuidanceInput, type CouncilClientSelectionOptions, type CouncilClientToolsInput, type CreateServerToolsFilterOptions, type CreationIntent, DEFAULT_CACHE_EXPIRATION_MS, DEFAULT_EXCLUDED_SERVER_TOOLS, DEFAULT_SERVER_TOOLS_MATCH_OPTIONS, type DeferLoadingConfig, FULL_GENERATIVE_CLIENT_FACTORIES, MAX_CLIENT_TOOLS_AFTER_FILTER, MEMORY_SAVE_TOOL_NAME, MIN_CONTENT_LENGTH_FOR_TOOLS, type ParsedServerToolsResponse, type PostFilterKey, type ResolvePlanContext, SERVER_TOOL_DEPENDENCY_SETS, type SelectServerSideToolsOptions, type SelectServerToolsForPromptOptions, type SelectionLogger, type ServerTool, type ServerToolCatalog, type ServerToolCatalogEntry, type ServerToolsFilter, type ServerToolsFilterContext, type ServerToolsFilterFunction, type ServerToolsOptions, type ServerToolsResponse, TOOL_CATALOG, type ThinkingModeHint, type ToolActivationEvent, type ToolChoice, type ToolConfig, type ToolExecutor, type ToolIntentDescriptor, type ToolLane, type ToolMatchOptions, type ToolMatchResult, type ToolPlanSpec, type ToolSelectionAdapters, type ToolSet, type ToolsCacheBackend, activatedToolSetNames, applyToolSets, assembleClientTools, autoFilterClientTools, buildConnectorGuidance, buildDeniedToolsRider, clearServerToolsCache, composeCouncilClientTools, computeToolGuidance, createServerToolsFilter, defaultServerToolsFilter, deferFormattingConfig, deriveActiveToolSets, expandToolSetsAdditive, filterAssembledClientTools, filterServerTools, findMatchingTools, getCachedServerTools, getCatalogEntry, getMaxToolRounds, getServerTools, getThinkingMode, getToolDescription, getToolName, getToolsChecksum, isCoercingIntent, localStorageToolsCache, mergeActiveToolSets, mergeTools, resolveCouncilPlan, resolveCouncilServerTools, resolveDeferredServerTools, resolvePlan, resolveServerTools, resolveToolChoice, scoreTools, selectCouncilClientTools, selectServerSideTools, selectServerToolsForPrompt, shouldRefreshTools, stripCoercedMemoryWrite, toolSetSystemPrompts };
+export { type AssembledToolsFilterFn, BUILT_IN_TOOL_SETS, CLIENT_TOOLS_MIN_SIMILARITY, CLIENT_TOOLS_RELEVANCE_RATIO, CREATION_INTENT_CLIENT_FACTORIES, CREATION_INTENT_CLIENT_FILTER, CREATION_INTENT_TOOL_SET, type CachedServerTools, type ClientFactoryBuilder, type ClientFactoryKey, type ClientToolsFilterMode, type ConnectorGuidance, type ConnectorGuidanceInput, type CouncilClientSelectionOptions, type CouncilClientToolsInput, type CreateServerToolsFilterOptions, type CreationIntent, DEFAULT_CACHE_EXPIRATION_MS, DEFAULT_EXCLUDED_SERVER_TOOLS, DEFAULT_SERVER_TOOLS_MATCH_OPTIONS, type DeferLoadingConfig, FULL_GENERATIVE_CLIENT_FACTORIES, MAX_CLIENT_TOOLS_AFTER_FILTER, MEMORY_SAVE_TOOL_NAME, MIN_CONTENT_LENGTH_FOR_TOOLS, type ParsedServerToolsResponse, type PostFilterKey, type ResolvePlanContext, SERVER_TOOL_DEPENDENCY_SETS, type SelectServerSideToolsOptions, type SelectServerToolsForPromptOptions, type SelectionLogger, type ServerTool, type ServerToolCatalog, type ServerToolCatalogEntry, type ServerToolsFilter, type ServerToolsFilterContext, type ServerToolsFilterFunction, type ServerToolsOptions, type ServerToolsResponse, TOOL_CATALOG, type ThinkingModeHint, type ToolActivationEvent, type ToolChoice, type ToolConfig, type ToolExecutor, type ToolIntentDescriptor, type ToolLane, type ToolMatchOptions, type ToolMatchResult, type ToolPlanSpec, type ToolSelectionAdapters, type ToolSet, type ToolsCacheBackend, activatedToolSetNames, applyToolSets, assembleClientTools, autoFilterClientTools, buildConnectorGuidance, buildDeniedToolsRider, clearServerToolsCache, composeCouncilClientTools, computeToolGuidance, createServerToolsFilter, defaultServerToolsFilter, deferFormattingConfig, deriveActiveToolSets, expandToolSetsAdditive, filterAssembledClientTools, filterServerTools, findMatchingTools, getCachedServerTools, getCatalogEntry, getMaxToolRounds, getServerTools, getThinkingMode, getToolDescription, getToolName, getToolsChecksum, isCoercingIntent, localStorageToolsCache, mergeActiveToolSets, mergeTools, resolveCouncilPlan, resolveCouncilServerTools, resolveDeferredServerTools, resolvePlan, resolveServerTools, resolveToolChoice, scoreTools, selectCouncilClientTools, selectServerSideTools, selectServerToolsForPrompt, shouldRefreshTools, stripCoercedMemoryWrite, toolSetSystemPrompts, withActiveToolSetServerTools };

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

@@ -5,7 +5,7 @@ type LlmapiChatCompletionTool = {
 /**
  * Tool executor function type
  */
-type ToolExecutor = (args: Record<string, unknown>) => Promise<unknown> | unknown;
+type ToolExecutor = (args: Record<string, unknown>, signal?: AbortSignal) => Promise<unknown> | unknown;
 /**
  * Tool configuration with optional executor
  */
@@ -505,6 +505,25 @@ declare function expandToolSetsAdditive(matchedNames: Set<string>, availableName
  * @param activeSetNames - Set names forced active regardless of score.
  */
 declare function activatedToolSetNames(scores: ReadonlyMap<string, number>, toolSets?: ToolSet[], activeSetNames?: ReadonlySet<string>): Set<string>;
+/**
+ * Add the server-tool members of every set named in `activeToolSets` to a
+ * semantic server-tool selection.
+ *
+ * A semantic filter ranks only the latest prompt, so a terse follow-up inside a
+ * flow ("okay", "retry") drops the flow's server tools. This is the server-side
+ * half of what `autoFilterClientTools` does for client tools: an active set's
+ * members that are in the catalog are kept whatever the prompt scored, even
+ * below the short-prompt gate, where `selected` is empty. Exclusions tagged on
+ * the filter still win.
+ *
+ * @param selected - What the semantic filter picked (`[]` when it did not run).
+ * @param allServerTools - The full server-tool catalog.
+ * @param serverToolsFilter - The filter function, read only for its `excludeTools` tag.
+ * @param activeToolSets - Set names that are sticky for this conversation.
+ * @param extraToolSets - The caller's sets beyond {@link BUILT_IN_TOOL_SETS}.
+ * @returns `selected`, followed by any active-set members it was missing.
+ */
+declare function withActiveToolSetServerTools(selected: ServerTool[], allServerTools: ServerTool[], serverToolsFilter: ServerToolsFilterFunction, activeToolSets?: readonly string[], extraToolSets?: readonly ToolSet[]): ServerTool[];
 /**
  * Collect the `systemPrompt` of every tool set that activated for a request,
  * for the caller to APPEND to its base system prompt.
@@ -679,6 +698,20 @@ interface SelectServerToolsForPromptOptions {
      * {@link resolveDeferredServerTools}). Omit/disabled → today's filtered selection.
      */
     deferLoading?: DeferLoadingConfig;
+    /**
+     * Tool-set names that are sticky for this conversation — the same list you
+     * pass to `useChatStorage`'s `activeToolSets`, e.g. from
+     * `deriveActiveToolSets`. With a filter function, the server-tool members of
+     * these sets are selected whatever the prompt scored, even on a prompt too
+     * short to embed. Omit for selection from the prompt alone.
+     */
+    activeToolSets?: string[];
+    /**
+     * The caller's sets beyond {@link BUILT_IN_TOOL_SETS} — the same list you pass
+     * to `useChatStorage`'s `extraToolSets` — so a custom set named in
+     * `activeToolSets` stays sticky here too.
+     */
+    extraToolSets?: ToolSet[];
 }
 /**
  * Select server-side tools for a prompt using the same path
@@ -1443,4 +1476,4 @@ declare function resolveServerTools(descriptor: ToolIntentDescriptor, catalog: S
  */
 declare function isCoercingIntent(creation: CreationIntent, catalog: ServerToolCatalog): boolean;
 
-export { type AssembledToolsFilterFn, BUILT_IN_TOOL_SETS, CLIENT_TOOLS_MIN_SIMILARITY, CLIENT_TOOLS_RELEVANCE_RATIO, CREATION_INTENT_CLIENT_FACTORIES, CREATION_INTENT_CLIENT_FILTER, CREATION_INTENT_TOOL_SET, type CachedServerTools, type ClientFactoryBuilder, type ClientFactoryKey, type ClientToolsFilterMode, type ConnectorGuidance, type ConnectorGuidanceInput, type CouncilClientSelectionOptions, type CouncilClientToolsInput, type CreateServerToolsFilterOptions, type CreationIntent, DEFAULT_CACHE_EXPIRATION_MS, DEFAULT_EXCLUDED_SERVER_TOOLS, DEFAULT_SERVER_TOOLS_MATCH_OPTIONS, type DeferLoadingConfig, FULL_GENERATIVE_CLIENT_FACTORIES, MAX_CLIENT_TOOLS_AFTER_FILTER, MEMORY_SAVE_TOOL_NAME, MIN_CONTENT_LENGTH_FOR_TOOLS, type ParsedServerToolsResponse, type PostFilterKey, type ResolvePlanContext, SERVER_TOOL_DEPENDENCY_SETS, type SelectServerSideToolsOptions, type SelectServerToolsForPromptOptions, type SelectionLogger, type ServerTool, type ServerToolCatalog, type ServerToolCatalogEntry, type ServerToolsFilter, type ServerToolsFilterContext, type ServerToolsFilterFunction, type ServerToolsOptions, type ServerToolsResponse, TOOL_CATALOG, type ThinkingModeHint, type ToolActivationEvent, type ToolChoice, type ToolConfig, type ToolExecutor, type ToolIntentDescriptor, type ToolLane, type ToolMatchOptions, type ToolMatchResult, type ToolPlanSpec, type ToolSelectionAdapters, type ToolSet, type ToolsCacheBackend, activatedToolSetNames, applyToolSets, assembleClientTools, autoFilterClientTools, buildConnectorGuidance, buildDeniedToolsRider, clearServerToolsCache, composeCouncilClientTools, computeToolGuidance, createServerToolsFilter, defaultServerToolsFilter, deferFormattingConfig, deriveActiveToolSets, expandToolSetsAdditive, filterAssembledClientTools, filterServerTools, findMatchingTools, getCachedServerTools, getCatalogEntry, getMaxToolRounds, getServerTools, getThinkingMode, getToolDescription, getToolName, getToolsChecksum, isCoercingIntent, localStorageToolsCache, mergeActiveToolSets, mergeTools, resolveCouncilPlan, resolveCouncilServerTools, resolveDeferredServerTools, resolvePlan, resolveServerTools, resolveToolChoice, scoreTools, selectCouncilClientTools, selectServerSideTools, selectServerToolsForPrompt, shouldRefreshTools, stripCoercedMemoryWrite, toolSetSystemPrompts };
+export { type AssembledToolsFilterFn, BUILT_IN_TOOL_SETS, CLIENT_TOOLS_MIN_SIMILARITY, CLIENT_TOOLS_RELEVANCE_RATIO, CREATION_INTENT_CLIENT_FACTORIES, CREATION_INTENT_CLIENT_FILTER, CREATION_INTENT_TOOL_SET, type CachedServerTools, type ClientFactoryBuilder, type ClientFactoryKey, type ClientToolsFilterMode, type ConnectorGuidance, type ConnectorGuidanceInput, type CouncilClientSelectionOptions, type CouncilClientToolsInput, type CreateServerToolsFilterOptions, type CreationIntent, DEFAULT_CACHE_EXPIRATION_MS, DEFAULT_EXCLUDED_SERVER_TOOLS, DEFAULT_SERVER_TOOLS_MATCH_OPTIONS, type DeferLoadingConfig, FULL_GENERATIVE_CLIENT_FACTORIES, MAX_CLIENT_TOOLS_AFTER_FILTER, MEMORY_SAVE_TOOL_NAME, MIN_CONTENT_LENGTH_FOR_TOOLS, type ParsedServerToolsResponse, type PostFilterKey, type ResolvePlanContext, SERVER_TOOL_DEPENDENCY_SETS, type SelectServerSideToolsOptions, type SelectServerToolsForPromptOptions, type SelectionLogger, type ServerTool, type ServerToolCatalog, type ServerToolCatalogEntry, type ServerToolsFilter, type ServerToolsFilterContext, type ServerToolsFilterFunction, type ServerToolsOptions, type ServerToolsResponse, TOOL_CATALOG, type ThinkingModeHint, type ToolActivationEvent, type ToolChoice, type ToolConfig, type ToolExecutor, type ToolIntentDescriptor, type ToolLane, type ToolMatchOptions, type ToolMatchResult, type ToolPlanSpec, type ToolSelectionAdapters, type ToolSet, type ToolsCacheBackend, activatedToolSetNames, applyToolSets, assembleClientTools, autoFilterClientTools, buildConnectorGuidance, buildDeniedToolsRider, clearServerToolsCache, composeCouncilClientTools, computeToolGuidance, createServerToolsFilter, defaultServerToolsFilter, deferFormattingConfig, deriveActiveToolSets, expandToolSetsAdditive, filterAssembledClientTools, filterServerTools, findMatchingTools, getCachedServerTools, getCatalogEntry, getMaxToolRounds, getServerTools, getThinkingMode, getToolDescription, getToolName, getToolsChecksum, isCoercingIntent, localStorageToolsCache, mergeActiveToolSets, mergeTools, resolveCouncilPlan, resolveCouncilServerTools, resolveDeferredServerTools, resolvePlan, resolveServerTools, resolveToolChoice, scoreTools, selectCouncilClientTools, selectServerSideTools, selectServerToolsForPrompt, shouldRefreshTools, stripCoercedMemoryWrite, toolSetSystemPrompts, withActiveToolSetServerTools };

package/dist/tools/selection/index.mjs

@@ -1872,6 +1872,23 @@ var BUILT_IN_TOOL_SETS = [
     members: ["dropbox_list_folders", "dropbox_get_file_content", "dropbox_search"],
     anchors: ["dropbox_list_folders", "dropbox_search"],
     anchorMinSimilarity: 0.53
+  },
+  {
+    // Server tools, so this set does its work through
+    // withActiveToolSetServerTools: once a restaurant tool has run, terse
+    // follow-ups ("okay", "same as before") keep the booking chain. Each tool
+    // still reaches a fresh booking request on its own description.
+    // Anchors are deliberately empty (like the client's Nearby set): the set
+    // is only for stickiness, not a new way to activate on a prompt.
+    // prompt_user_confirm is left out of members: autoFilterClientTools always
+    // sends it, and as a member any unrelated confirmation would pin this set.
+    name: "restaurant-booking",
+    members: [
+      "AnumaPaymentsMCP-anuma_find_restaurant",
+      "AnumaPaymentsMCP-anuma_check_restaurant_availability",
+      "AnumaPaymentsMCP-anuma_book_restaurant"
+    ],
+    anchors: []
   }
 ];
 function applyToolSets(matchedNames, availableNames, scores, toolSets = BUILT_IN_TOOL_SETS, independentThreshold = 0.65) {
@@ -1934,6 +1951,16 @@ function activatedToolSetNames(scores, toolSets = BUILT_IN_TOOL_SETS, activeSetN
   }
   return activated;
 }
+function withActiveToolSetServerTools(selected, allServerTools, serverToolsFilter, activeToolSets = [], extraToolSets = []) {
+  if (activeToolSets.length === 0) return selected;
+  const sticky = new Set(
+    [...BUILT_IN_TOOL_SETS, ...extraToolSets].filter((ts) => activeToolSets.includes(ts.name)).flatMap((ts) => ts.members)
+  );
+  for (const name of serverToolsFilter.excludeTools ?? []) sticky.delete(name);
+  for (const tool of selected) sticky.delete(tool.name);
+  const added = allServerTools.filter((tool) => sticky.has(tool.name));
+  return added.length > 0 ? [...selected, ...added] : selected;
+}
 function toolSetSystemPrompts(selectedToolNames, toolSets = BUILT_IN_TOOL_SETS, activatedSetNames) {
   const selected = selectedToolNames instanceof Set ? selectedToolNames : new Set(selectedToolNames);
   const prompts = [];
@@ -2047,7 +2074,9 @@ async function selectServerToolsForPrompt(options) {
     embeddingModel,
     cacheExpirationMs,
     cache,
-    deferLoading
+    deferLoading,
+    activeToolSets,
+    extraToolSets
   } = options;
   if (serverToolsFilter === void 0) return [];
   if (Array.isArray(serverToolsFilter) && serverToolsFilter.length === 0) return [];
@@ -2061,7 +2090,14 @@ async function selectServerToolsForPrompt(options) {
   if (deferLoading?.enabled)
     return resolveDeferredServerTools(allServerTools, serverToolsFilter, deferLoading);
   if (typeof serverToolsFilter === "function") {
-    if (prompt.length < MIN_CONTENT_LENGTH_FOR_TOOLS) return [];
+    const withSticky = (selected) => withActiveToolSetServerTools(
+      selected,
+      allServerTools,
+      serverToolsFilter,
+      activeToolSets,
+      extraToolSets
+    );
+    if (prompt.length < MIN_CONTENT_LENGTH_FOR_TOOLS) return withSticky([]);
     let promptEmbedding;
     try {
       promptEmbedding = await generateEmbedding(prompt, {
@@ -2070,10 +2106,10 @@ async function selectServerToolsForPrompt(options) {
         model: embeddingModel
       });
     } catch {
-      return [];
+      return withSticky([]);
     }
     const names = serverToolsFilter(promptEmbedding, allServerTools);
-    return filterServerTools(allServerTools, names);
+    return withSticky(filterServerTools(allServerTools, names));
   }
   return filterServerTools(allServerTools, serverToolsFilter);
 }
@@ -2714,5 +2750,6 @@ export {
   selectServerToolsForPrompt,
   shouldRefreshTools,
   stripCoercedMemoryWrite,
-  toolSetSystemPrompts
+  toolSetSystemPrompts,
+  withActiveToolSetServerTools
 };

package/package.json

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