@ljoukov/llm 7.0.6 → 7.0.8

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) {
@@ -10340,9 +10399,11 @@ var subagentInputItemSchema = z4.object({
 }).passthrough();
 var spawnAgentInputSchema = z4.object({
   prompt: z4.string().nullish().describe("Alias for message. Initial plain-text task for the new agent."),
-  message: z4.string().nullish().describe("Initial plain-text task for the new agent. Use either message or items."),
+  message: z4.string().nullish().describe(
+    "Initial plain-text task for the new agent. Combined with items when both are provided."
+  ),
   items: z4.array(subagentInputItemSchema).nullish().describe(
-    "Structured input items. Use this to pass explicit mentions (for example app:// connector paths)."
+    "Structured input items. Use this to pass explicit mentions (for example app:// connector paths). Combined with message/input when both are provided."
   ),
   agent_type: z4.string().nullish().describe(SPAWN_AGENT_TYPE_DESCRIPTION),
   fork_context: z4.boolean().nullish().describe(
@@ -10501,7 +10562,6 @@ function createSubagentToolController(options) {
         const initialPrompt = resolveCollabInputText({
           textCandidates: [{ value: input.prompt }, { value: input.message }],
           items: input.items,
-          bothError: "Provide either prompt/message or items, but not both.",
           missingError: "Provide one of: prompt/message or items.",
           emptyTextError: "Empty message can't be sent to an agent.",
           emptyItemsError: "Items can't be empty."
@@ -10554,7 +10614,6 @@ function createSubagentToolController(options) {
         const nextInput = resolveCollabInputText({
           textCandidates: [{ value: input.input }, { value: input.message }],
           items: input.items,
-          bothError: "Provide either input/message or items, but not both.",
           missingError: "Provide one of: input/message or items.",
           emptyTextError: "Empty message can't be sent to an agent.",
           emptyItemsError: "Items can't be empty."
@@ -10708,18 +10767,19 @@ function resolveCollabInputText(params) {
   );
   const hasText = Boolean(textCandidate);
   const hasItems = params.items !== void 0 && params.items !== null;
-  if (hasText && hasItems) {
-    throw new Error(params.bothError);
-  }
   if (!hasText && !hasItems) {
     throw new Error(params.missingError);
   }
+  const blocks = [];
   if (hasText) {
     const value = textCandidate?.value?.trim();
     if (!value) {
       throw new Error(params.emptyTextError);
     }
-    return value;
+    blocks.push(value);
+  }
+  if (!hasItems) {
+    return blocks.join("\n\n");
   }
   if (!params.items || params.items.length === 0) {
     throw new Error(params.emptyItemsError);
@@ -10728,7 +10788,8 @@ function resolveCollabInputText(params) {
   if (!itemText) {
     throw new Error(params.emptyItemsError);
   }
-  return itemText;
+  blocks.push(itemText);
+  return blocks.join("\n\n");
 }
 function resolveInputItemsText(items) {
   if (!items || items.length === 0) {