@anuma/sdk 6.27.9 → 6.28.0

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

@@ -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

@@ -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.9",
+  "version": "6.28.0",
   "description": "",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",