@flutchai/flutch-sdk 0.7.3 → 0.7.5

package/dist/index.cjs

@@ -5990,6 +5990,10 @@ exports.LangGraphEngine = class _LangGraphEngine {
       traceEvents: trace?.events?.length || 0,
       hadError: !!streamError
     });
+    if (streamError && isRecursionLimit(streamError) && content?.text?.trim()) {
+      this.logger.warn(`[STREAM-ERROR] Recursion limit reached after the answer was written; returning the answer`);
+      return content;
+    }
     if (streamError) {
       throw streamError;
     }
@@ -6198,6 +6202,10 @@ exports.LangGraphEngine = _ts_decorate22([
     typeof config.ConfigService === "undefined" ? Object : config.ConfigService
   ])
 ], exports.LangGraphEngine);
+function isRecursionLimit(error) {
+  return error.name === "GraphRecursionError" || /Recursion limit of \d+ reached/.test(error.message);
+}
+__name(isRecursionLimit, "isRecursionLimit");
 
 // src/engines/graph-engine.factory.ts
 function _ts_decorate23(decorators, target, key, desc) {
@@ -7161,6 +7169,14 @@ function shortDescription(description) {
   return sentenceEnd > HIT_DESCRIPTION_CHARS / 2 ? cut.slice(0, sentenceEnd + 1) : `${cut.trimEnd()}\u2026`;
 }
 __name(shortDescription, "shortDescription");
+var INDEX_DESCRIPTION_CHARS = 100;
+function indexDescription(description) {
+  const flat = description.replace(/\s+/g, " ").trim();
+  const sentenceEnd = flat.search(/[.!?](\s|$)/);
+  const sentence = sentenceEnd >= 0 ? flat.slice(0, sentenceEnd) : flat;
+  return sentence.length <= INDEX_DESCRIPTION_CHARS ? sentence : `${sentence.slice(0, INDEX_DESCRIPTION_CHARS).trimEnd()}\u2026`;
+}
+__name(indexDescription, "indexDescription");
 var ToolSearchCatalog = class {
   static {
     __name(this, "ToolSearchCatalog");
@@ -7235,6 +7251,17 @@ var ToolSearchCatalog = class {
     }));
   }
   /**
+  * Every tool of the catalog on its own line: its name and the start of its
+  * description. Costs a few tokens per tool instead of a full schema, and
+  * lets the model ask for a tool by its exact name.
+  */
+  index() {
+    return this.entries.map((entry) => {
+      const brief = indexDescription(entry.description);
+      return brief ? `- ${entry.name}: ${brief}` : `- ${entry.name}`;
+    }).join("\n");
+  }
+  /**
   * What the catalog covers, as name prefixes with counts:
   * "funnel_* (4), recipe_* (5), rl_* (41)". Goes into the search tool's
   * description so the model knows a search is worth making. Sorted, so the
@@ -7329,10 +7356,13 @@ function splitTools(tools, options, extraCore = []) {
   };
 }
 __name(splitTools, "splitTools");
-function createToolSearchTool(catalog, maxResults = DEFAULT_TOOL_SEARCH_RESULTS) {
+function createToolSearchTool(catalog, maxResults = DEFAULT_TOOL_SEARCH_RESULTS, index = false) {
+  const covered = index ? `${catalog.size} more are found by search:
+${catalog.index()}
+` : `${catalog.size} more are found by search: ${catalog.summary()}. `;
   return new tools.DynamicStructuredTool({
     name: TOOL_SEARCH_NAME,
-    description: `Find more tools. You see only some of your tools; ${catalog.size} more are found by search: ${catalog.summary()}. Describe the task in a few words (what to do and with what, e.g. "customer review quotes by theme"), or give exact tool names. Found tools become callable right away and stay available for the rest of the conversation. Search before saying you cannot do something.`,
+    description: `Find more tools. You see only some of your tools; ${covered}` + (index ? "Give the exact names of the tools you need, separated by commas, or describe the task in a few words. " : 'Describe the task in a few words (what to do and with what, e.g. "customer review quotes by theme"), or give exact tool names. ') + "Found tools become callable right away and stay available for the rest of the conversation. Search before saying you cannot do something.",
     schema: zod.z.object({
       query: zod.z.string().describe("What the tool should do, in a few words, or tool names separated by commas"),
       limit: zod.z.number().int().min(1).max(20).optional().describe(`How many tools to return (default ${maxResults})`)
@@ -7614,7 +7644,11 @@ function generateModelCacheKey(modelId, temperature, maxTokens, toolsConfig, bas
   return parts.join(":");
 }
 __name(generateModelCacheKey, "generateModelCacheKey");
-function buildOpenAIModelConfig(modelName, temperature, maxTokens, apiToken) {
+function toOpenAIEffort(effort) {
+  return effort === "max" ? "xhigh" : effort;
+}
+__name(toOpenAIEffort, "toOpenAIEffort");
+function buildOpenAIModelConfig(modelName, temperature, maxTokens, apiToken, effort) {
   if (isReasoningModel(modelName)) {
     return {
       modelName,
@@ -7622,7 +7656,14 @@ function buildOpenAIModelConfig(modelName, temperature, maxTokens, apiToken) {
       maxCompletionTokens: maxTokens,
       streaming: true,
       useResponsesApi: true,
-      apiKey: apiToken
+      apiKey: apiToken,
+      // Responses API `reasoning.effort`. Omitted when unset, so the request
+      // stays what it was and the model keeps its own default.
+      ...effort && {
+        reasoning: {
+          effort: toOpenAIEffort(effort)
+        }
+      }
     };
   }
   return {
@@ -7889,8 +7930,8 @@ var ModelInitializer = class _ModelInitializer {
   }
   // Chat model creators
   chatModelCreators = {
-    [ModelProvider.OPENAI]: ({ modelName, defaultTemperature, defaultMaxTokens, apiToken, baseURL }) => {
-      const config = buildOpenAIModelConfig(modelName, defaultTemperature, defaultMaxTokens, apiToken || this.resolveApiKey(ModelProvider.OPENAI) || "");
+    [ModelProvider.OPENAI]: ({ modelName, defaultTemperature, defaultMaxTokens, apiToken, baseURL, defaultEffort }) => {
+      const config = buildOpenAIModelConfig(modelName, defaultTemperature, defaultMaxTokens, apiToken || this.resolveApiKey(ModelProvider.OPENAI) || "", defaultEffort);
       const routerURL = resolveRouterURL(baseURL);
       if (routerURL) {
         config.configuration = {
@@ -8122,7 +8163,8 @@ var ModelInitializer = class _ModelInitializer {
       ...modelConfig,
       defaultTemperature: sampling.temperature,
       defaultMaxTokens: toOptionalNumber(config.maxTokens) ?? toOptionalNumber(modelConfig.defaultMaxTokens),
-      baseURL: config.baseURL ?? modelConfig.baseURL
+      baseURL: config.baseURL ?? modelConfig.baseURL,
+      defaultEffort: config.effort ?? modelConfig.defaultEffort
     };
     const promptCacheControl = resolvePromptCacheControl([
       finalConfig.bedrockModelId,
@@ -8243,7 +8285,7 @@ var ModelInitializer = class _ModelInitializer {
               ...customTools ?? []
             ],
             deferred,
-            searchTool: createToolSearchTool(catalog, maxResults),
+            searchTool: createToolSearchTool(catalog, maxResults, toolSearch.options.index === true),
             mode,
             bindOptions: promptCacheControl ? boundOptions : void 0
           });
@@ -9194,6 +9236,7 @@ exports.sanitizeReasoningForBedrock = sanitizeReasoningForBedrock;
 exports.sanitizeTraceData = sanitizeTraceData;
 exports.splitTools = splitTools;
 exports.storeAttachmentData = storeAttachmentData;
+exports.toOpenAIEffort = toOpenAIEffort;
 exports.toOptionalNumber = toOptionalNumber;
 exports.toolSearchApplies = toolSearchApplies;
 exports.toolSearchTerms = toolSearchTerms;