@ljoukov/llm 7.0.6 → 7.0.7

package/dist/index.d.cts

@@ -341,6 +341,7 @@ type LlmFunctionTool<Schema extends z.ZodType, Output> = {
     readonly type?: "function";
     readonly description?: string;
     readonly inputSchema: Schema;
+    readonly terminal?: boolean;
     readonly execute: (input: z.output<Schema>) => Promise<Output> | Output;
 };
 type LlmCustomToolInputFormat = {
@@ -354,6 +355,7 @@ type LlmCustomTool<Output> = {
     readonly type: "custom";
     readonly description?: string;
     readonly format?: LlmCustomToolInputFormat;
+    readonly terminal?: boolean;
     readonly execute: (input: string) => Promise<Output> | Output;
 };
 type LlmExecutableTool<Schema extends z.ZodType, Output> = LlmFunctionTool<Schema, Output> | LlmCustomTool<Output>;
@@ -361,11 +363,13 @@ type LlmToolSet = Record<string, LlmExecutableTool<z.ZodType, unknown>>;
 declare function tool<Schema extends z.ZodType, Output>(options: {
     readonly description?: string;
     readonly inputSchema: Schema;
+    readonly terminal?: boolean;
     readonly execute: (input: z.output<Schema>) => Promise<Output> | Output;
 }): LlmFunctionTool<Schema, Output>;
 declare function customTool<Output>(options: {
     readonly description?: string;
     readonly format?: LlmCustomToolInputFormat;
+    readonly terminal?: boolean;
     readonly execute: (input: string) => Promise<Output> | Output;
 }): LlmCustomTool<Output>;
 type LlmToolCallResult = {

package/dist/index.d.ts

@@ -341,6 +341,7 @@ type LlmFunctionTool<Schema extends z.ZodType, Output> = {
     readonly type?: "function";
     readonly description?: string;
     readonly inputSchema: Schema;
+    readonly terminal?: boolean;
     readonly execute: (input: z.output<Schema>) => Promise<Output> | Output;
 };
 type LlmCustomToolInputFormat = {
@@ -354,6 +355,7 @@ type LlmCustomTool<Output> = {
     readonly type: "custom";
     readonly description?: string;
     readonly format?: LlmCustomToolInputFormat;
+    readonly terminal?: boolean;
     readonly execute: (input: string) => Promise<Output> | Output;
 };
 type LlmExecutableTool<Schema extends z.ZodType, Output> = LlmFunctionTool<Schema, Output> | LlmCustomTool<Output>;
@@ -361,11 +363,13 @@ type LlmToolSet = Record<string, LlmExecutableTool<z.ZodType, unknown>>;
 declare function tool<Schema extends z.ZodType, Output>(options: {
     readonly description?: string;
     readonly inputSchema: Schema;
+    readonly terminal?: boolean;
     readonly execute: (input: z.output<Schema>) => Promise<Output> | Output;
 }): LlmFunctionTool<Schema, Output>;
 declare function customTool<Output>(options: {
     readonly description?: string;
     readonly format?: LlmCustomToolInputFormat;
+    readonly terminal?: boolean;
     readonly execute: (input: string) => Promise<Output> | Output;
 }): LlmCustomTool<Output>;
 type LlmToolCallResult = {

package/dist/index.js

@@ -6955,6 +6955,41 @@ async function executeToolCall(params) {
     );
   }
 }
+function findTerminalToolCall(tools, toolCalls) {
+  for (let index = toolCalls.length - 1; index >= 0; index -= 1) {
+    const toolCall = toolCalls[index];
+    if (!toolCall) {
+      continue;
+    }
+    const toolDef = tools[toolCall.toolName];
+    if (toolDef?.terminal === true && !toolCall.error) {
+      return toolCall;
+    }
+  }
+  return null;
+}
+function terminalToolCallText(toolCall) {
+  const output = toolCall.output;
+  if (typeof output === "string") {
+    return output;
+  }
+  if (output && typeof output === "object") {
+    const record = output;
+    const summary = record.summary;
+    if (typeof summary === "string" && summary.trim().length > 0) {
+      return summary;
+    }
+    const status = record.status;
+    const title = record.presentationTitle;
+    if (typeof status === "string" && typeof title === "string" && title.trim().length > 0) {
+      return `${status}: ${title}`;
+    }
+    if (typeof status === "string" && status.trim().length > 0) {
+      return status;
+    }
+  }
+  return "";
+}
 function buildToolLogId(turn, toolIndex) {
   return `turn${turn.toString()}/tool${toolIndex.toString()}`;
 }
@@ -8866,6 +8901,7 @@ async function runToolLoop(request) {
             costUsd: stepCostUsd,
             timing
           });
+          const terminalToolCall = findTerminalToolCall(request.tools, stepToolCalls);
           const steeringInput = steeringInternal?.drainPendingContents() ?? [];
           const steeringItems = steeringInput.length > 0 ? toOpenAiInput(steeringInput, {
             defaultMediaResolution: request.mediaResolution,
@@ -8886,9 +8922,14 @@ async function runToolLoop(request) {
               responseChars: responseText.length,
               thoughtChars: reasoningSummary.length,
               toolCalls: stepToolCalls.length,
-              finalStep: false
+              finalStep: terminalToolCall !== null
             }
           });
+          if (terminalToolCall) {
+            finalText = terminalToolCallText(terminalToolCall) || responseText;
+            finalThoughts = reasoningSummary;
+            return { text: finalText, thoughts: finalThoughts, steps, totalCostUsd };
+          }
           previousResponseId = finalResponse.id;
           input = steeringItems.length > 0 ? toolOutputs.concat(steeringItems) : toolOutputs;
         } catch (error) {
@@ -9204,6 +9245,7 @@ async function runToolLoop(request) {
             costUsd: stepCostUsd,
             timing
           });
+          const terminalToolCall = findTerminalToolCall(request.tools, toolCalls);
           const steeringInput = steeringInternal?.drainPendingContents() ?? [];
           const steeringItems = steeringInput.length > 0 ? toChatGptInput(steeringInput, {
             defaultMediaResolution: request.mediaResolution,
@@ -9223,9 +9265,14 @@ async function runToolLoop(request) {
               responseChars: responseText.length,
               thoughtChars: reasoningSummaryText.length,
               toolCalls: toolCalls.length,
-              finalStep: false
+              finalStep: terminalToolCall !== null
             }
           });
+          if (terminalToolCall) {
+            finalText = terminalToolCallText(terminalToolCall) || responseText;
+            finalThoughts = reasoningSummaryText;
+            return { text: finalText, thoughts: finalThoughts, steps, totalCostUsd };
+          }
           input = steeringItems.length > 0 ? input.concat(toolOutputs, steeringItems) : input.concat(toolOutputs);
         } catch (error) {
           stepCallLogger?.fail(error, {
@@ -9489,6 +9536,7 @@ async function runToolLoop(request) {
             costUsd: stepCostUsd,
             timing
           });
+          const terminalToolCall = findTerminalToolCall(request.tools, stepToolCalls);
           stepCallLogger?.complete({
             responseText,
             toolCallText: stepToolCallText,
@@ -9504,9 +9552,14 @@ async function runToolLoop(request) {
               responseChars: responseText.length,
               thoughtChars: 0,
               toolCalls: stepToolCalls.length,
-              finalStep: false
+              finalStep: terminalToolCall !== null
             }
           });
+          if (terminalToolCall) {
+            finalText = terminalToolCallText(terminalToolCall) || responseText;
+            finalThoughts = "";
+            return { text: finalText, thoughts: finalThoughts, steps, totalCostUsd };
+          }
           messages.push({
             role: "assistant",
             ...responseText.length > 0 ? { content: responseText } : {},
@@ -9850,6 +9903,7 @@ async function runToolLoop(request) {
           costUsd: stepCostUsd,
           timing
         });
+        const terminalToolCall = findTerminalToolCall(request.tools, toolCalls);
         stepCallLogger?.complete({
           responseText,
           attachments: responseOutputAttachments,
@@ -9865,9 +9919,14 @@ async function runToolLoop(request) {
             responseChars: responseText.length,
             thoughtChars: thoughtsText.length,
             toolCalls: toolCalls.length,
-            finalStep: false
+            finalStep: terminalToolCall !== null
           }
         });
+        if (terminalToolCall) {
+          finalText = terminalToolCallText(terminalToolCall) || responseText;
+          finalThoughts = thoughtsText;
+          return { text: finalText, thoughts: finalThoughts, steps, totalCostUsd };
+        }
         geminiContents.push({ role: "user", parts: responseParts });
         const steeringInput = steeringInternal?.drainPendingContents() ?? [];
         if (steeringInput.length > 0) {