hammer-ai 0.2.14 → 0.2.15

package/dist/index.d.ts

@@ -2071,24 +2071,6 @@ declare function parseResponseWithRecovery(content: string, options?: ParseRespo
  * consistent tool result truncation and safe execution wrapping.
  */
 
-/** Default maximum characters for tool result strings. */
-declare const MAX_TOOL_RESULT_CHARS = 30000;
-interface TruncateOptions {
-    /** Maximum character length (default: 30,000). */
-    maxChars?: number;
-    /**
-     * Truncation strategy:
-     * - `"head-tail"`: Keep first half + last half (preserves end of large outputs).
-     * - `"head-only"`: Keep the first N characters.
-     */
-    strategy?: "head-tail" | "head-only";
-}
-/**
- * Truncate an oversized tool result string to stay within LLM context limits.
- *
- * @returns The original string if within limit, otherwise a truncated version.
- */
-declare function truncateToolResult(resultStr: string, options?: TruncateOptions): string;
 declare function formatToolResultMessage(toolCall: ToolCall, result: ToolResult): string;
 declare function parseToolResultMessage(content: string): {
     success: boolean;
@@ -2468,4 +2450,4 @@ declare function runStructuredLLMCompaction<TMessage extends MemoryMessage, TSta
     parseState: (obj: Record<string, unknown>) => TState | null;
 }): Promise<TState | null>;
 
-export { AGENT_MACHINE_STATES, AgentLoop, type AgentLoopCallbacks, type AgentLoopDeps, type AgentMachineContext, type AgentMachineEvent, type AgentMachineState, type AgentMemoryCitation, type AgentMemoryConstraint, type AgentMemoryEvidence, type AgentMemoryFactoryOverrides, AgentMemoryLayer, type AgentMemoryLayerConfig, type AgentMemoryLogger, type AgentMemoryNote, type AgentMemoryTask, type AgentMessage, type AgentPhase, type AgentState, ApiError, type BackgroundBashAction, BackgroundBashRunCommand, BaseMemoryLayer, BaseValidationEnforcer, BashRunCommand, type BuildMemoryCompactionPromptOptions, CODE_QUALITY_RULE_LINE, CharTokenEstimator, type ChatMessage, type CommandRuntime, type CommandTargetInfo, type CompactionCursor, type CompactionLLMClient, type ConversationAdapter, type ConversationSink, type CreateWebRuntimeSetupOptions, DEFAULT_AGENT_FALLBACK_SYSTEM_PROMPT, DEFAULT_ALLOWED_RUN_TARGETS, DEFAULT_RUN_COMMAND_REGISTRY, DEFAULT_THREAD_AUTO_SCROLL_BOTTOM_THRESHOLD, DEFAULT_TOOL_MEMORY_EXTRACTOR, ERROR_RECOVERY_RULE_LINE, ERROR_TRUNCATED_RESPONSE, type EnforcerResult, type ExecuteWebLoopRunOptions, type FetchLike, type FetchResponseLike, type HammerAgentConfig, type HammerAgentProviderPreset, INCREMENTAL_TESTING_RULE_LINE, JUST_BASH_SCRIPT_EXECUTION_RESTRICTION_LINES, JUST_BASH_SHELL_NATIVE_WORKFLOW_COMMAND_EXAMPLES, LLMClient, type LLMClientResponse, type LLMProviderConfig, type LLMRequest, type LLMRequestOptions, type LLMResponse, LLMResponseSchema, type LoopOutcome, MAX_TOOL_RESULT_CHARS, type MemoryMessage, type MemoryProvenance, type MemoryStorage, PORT_CONFLICT_RULE_LINE, type ParseAgentResponseOptions, type ParsedAgentResponse, type ParsedBackgroundBashCommand, type ParsedStepInput, PendingAgentMessageBuffer, type PersistedMemoryData, type ProviderName, ProxyTool, type ProxyToolExecutor, ROOT_CAUSES_RULE_LINE, type RawMessage, RunCommand, type RunCommandParseResult, type RunCommandPromptAvailability, RunCommandRegistry, type RunInvocationTarget, type RuntimeController, type RuntimeSnapshotUpdater, type RuntimeStore, type RuntimeSubscriber, SHARED_TOOL_CALL_EXAMPLE_LINES, SHARED_TOOL_USAGE_RULE, SINGLE_TOOL_CALL_RUN_LINE_EXAMPLE, SKILL_INVOKE_READ_RULE_LINE, STANDARD_TOOL_CALL_FORMAT_RULES, SUPPORTED_RUN_TARGETS, type SkillSummaryLike, type StepResult, type StreamCallbacks, StreamingToolParser, type StreamingToolParserCallbacks, SubAgentTool, type SubAgentToolOptions, type SystemPromptBuildContext, type SystemPromptCustomizer, type SystemPromptSections, TODO_LIST_FIRST_RESPONSE_RULE_LINE, TOOL_CALL_SEPARATOR_RULE, type TodoItem, type TodoStatus, type TokenEstimator, Tool, type ToolCall, ToolCallSchema, type ToolDataPrimitive, type ToolDataSchema, type ToolDataValue, type ToolDefinition, type ToolDefinitionMetadata, type ToolExecutionResult, type ToolLike, ToolLoopAgentRuntime, type ToolLoopAgentRuntimeDeps, type ToolLoopRuntimeExecuteStepResult, type ToolLoopRuntimeHooks, type ToolLoopRuntimeInfrastructure, type ToolLoopRuntimeLLMRequest, type ToolLoopRuntimeLLMResponse, type ToolLoopRuntimeRunStepOptions, type ToolLoopRuntimeRunStepResult, type ToolLoopRuntimeSetup, type ToolLoopRuntimeStepContext, type ToolLoopStepExecutionResult, type ToolLoopStepExecutorCallbacks, type ToolLoopStepExecutorOptions, type ToolLoopStepExecutorResponse, type ToolMemoryCitationKind, type ToolMemoryEvidenceKind, type ToolMemoryEvidencePolicy, type ToolMemoryExtractor, type ToolMemoryMetadata, type ToolMemoryNoteKind, type ToolMemoryNotePolicy, type ToolMemoryNoteScope, type ToolMetadata, type ToolParameterDefinition, ToolRegistry, type ToolRegistryBeforeExecuteContext, type ToolRegistryMissingToolContext, type ToolRegistryOptions, type ToolResult, ToolRunCommand, type ToolSchema, type TruncatedToolInfo, VALIDATE_AFTER_CHANGES_RULE_LINE, type WebSearchToolActionInput, WebToolLoopAgentRuntime, type WebToolLoopAgentRuntimeConstructorOptions, type WebToolLoopRuntimeStateLike, WebValidationEnforcer, type WorkspaceCodingStaticRulesOptions, agentMachine, applyIdleWebAgentState, applyInitialWebAgentRunState, buildAgentIdentityLine, buildAgentSystemPrompt, buildCompactionEntry, buildCoreStaticRules, buildNoStructuredResponseFoundError, buildSkillAwareStaticContext, buildSkillsSection, buildStepUserMessage, buildToolLogRevealFrames, buildToolUsageExample, buildValidationErrorMessage, buildWebRuntimeRules, buildWorkspaceCodingStaticRules, canonicalizeCompactionText, coerceToolCallToDefinition, configure, containsStandaloneStructuredInvocationStart, createAgentMemoryLayer, createAppendToolsSectionCustomizer, createBackgroundBashDefinition, createConversationSink, createCustomRunCommandRegistry, createInitialWebAgentState, createRunCommandRuntimeBindings, createRuntimeStore, createToolAgentMessage, createToolRegistry, createToolsSectionOverrideCustomizer, createWebAgentMessageIdGenerator, createWebSearchToolActions, createWebToolLoopCallbacks, decodeEscapedShellText, defineRuntimeController, enrichToolResultWithUnixMetadata, executeBackgroundUnixCommandString, executeToolCallWithRunCommands, executeToolLoopStep, executeToolSafe, executeUnixCommandString, extractPrimaryCommandMetadata, extractTruncatedToolInfo, formatToolCallAsUnixCommand, formatToolDefinitions, formatToolResultMessage, formatToolsSection, formatUnixToolSurface, formatZodValidationError, getDiagnosticSummaryLine, getProviderConfig, getRunCommandPromptAvailability, getToolLogSummaryLine, isBackgroundBashToolCall, isBashToolCall, limitEntriesByRecency, machineStateToWebAgentPhase, mapConversationRoleToAgentRole, parseAgentResponse, parseResponseWithRecovery, parseStructuredAgentText, parseToolResultMessage, parseUnixToolCommand, readDiagnosticLevel, readDiagnosticSource, resolveToolDefinitionForInvocation, runStructuredLLMCompaction, selectLatestByKey, shouldAutoScrollThread, shouldSkipStepUserMessage, stripDiagnosticMessagePrefix, suppressWebValidationLog, tokenizeUnixCommand, truncateToolResult };
+export { AGENT_MACHINE_STATES, AgentLoop, type AgentLoopCallbacks, type AgentLoopDeps, type AgentMachineContext, type AgentMachineEvent, type AgentMachineState, type AgentMemoryCitation, type AgentMemoryConstraint, type AgentMemoryEvidence, type AgentMemoryFactoryOverrides, AgentMemoryLayer, type AgentMemoryLayerConfig, type AgentMemoryLogger, type AgentMemoryNote, type AgentMemoryTask, type AgentMessage, type AgentPhase, type AgentState, ApiError, type BackgroundBashAction, BackgroundBashRunCommand, BaseMemoryLayer, BaseValidationEnforcer, BashRunCommand, type BuildMemoryCompactionPromptOptions, CODE_QUALITY_RULE_LINE, CharTokenEstimator, type ChatMessage, type CommandRuntime, type CommandTargetInfo, type CompactionCursor, type CompactionLLMClient, type ConversationAdapter, type ConversationSink, type CreateWebRuntimeSetupOptions, DEFAULT_AGENT_FALLBACK_SYSTEM_PROMPT, DEFAULT_ALLOWED_RUN_TARGETS, DEFAULT_RUN_COMMAND_REGISTRY, DEFAULT_THREAD_AUTO_SCROLL_BOTTOM_THRESHOLD, DEFAULT_TOOL_MEMORY_EXTRACTOR, ERROR_RECOVERY_RULE_LINE, ERROR_TRUNCATED_RESPONSE, type EnforcerResult, type ExecuteWebLoopRunOptions, type FetchLike, type FetchResponseLike, type HammerAgentConfig, type HammerAgentProviderPreset, INCREMENTAL_TESTING_RULE_LINE, JUST_BASH_SCRIPT_EXECUTION_RESTRICTION_LINES, JUST_BASH_SHELL_NATIVE_WORKFLOW_COMMAND_EXAMPLES, LLMClient, type LLMClientResponse, type LLMProviderConfig, type LLMRequest, type LLMRequestOptions, type LLMResponse, LLMResponseSchema, type LoopOutcome, type MemoryMessage, type MemoryProvenance, type MemoryStorage, PORT_CONFLICT_RULE_LINE, type ParseAgentResponseOptions, type ParsedAgentResponse, type ParsedBackgroundBashCommand, type ParsedStepInput, PendingAgentMessageBuffer, type PersistedMemoryData, type ProviderName, ProxyTool, type ProxyToolExecutor, ROOT_CAUSES_RULE_LINE, type RawMessage, RunCommand, type RunCommandParseResult, type RunCommandPromptAvailability, RunCommandRegistry, type RunInvocationTarget, type RuntimeController, type RuntimeSnapshotUpdater, type RuntimeStore, type RuntimeSubscriber, SHARED_TOOL_CALL_EXAMPLE_LINES, SHARED_TOOL_USAGE_RULE, SINGLE_TOOL_CALL_RUN_LINE_EXAMPLE, SKILL_INVOKE_READ_RULE_LINE, STANDARD_TOOL_CALL_FORMAT_RULES, SUPPORTED_RUN_TARGETS, type SkillSummaryLike, type StepResult, type StreamCallbacks, StreamingToolParser, type StreamingToolParserCallbacks, SubAgentTool, type SubAgentToolOptions, type SystemPromptBuildContext, type SystemPromptCustomizer, type SystemPromptSections, TODO_LIST_FIRST_RESPONSE_RULE_LINE, TOOL_CALL_SEPARATOR_RULE, type TodoItem, type TodoStatus, type TokenEstimator, Tool, type ToolCall, ToolCallSchema, type ToolDataPrimitive, type ToolDataSchema, type ToolDataValue, type ToolDefinition, type ToolDefinitionMetadata, type ToolExecutionResult, type ToolLike, ToolLoopAgentRuntime, type ToolLoopAgentRuntimeDeps, type ToolLoopRuntimeExecuteStepResult, type ToolLoopRuntimeHooks, type ToolLoopRuntimeInfrastructure, type ToolLoopRuntimeLLMRequest, type ToolLoopRuntimeLLMResponse, type ToolLoopRuntimeRunStepOptions, type ToolLoopRuntimeRunStepResult, type ToolLoopRuntimeSetup, type ToolLoopRuntimeStepContext, type ToolLoopStepExecutionResult, type ToolLoopStepExecutorCallbacks, type ToolLoopStepExecutorOptions, type ToolLoopStepExecutorResponse, type ToolMemoryCitationKind, type ToolMemoryEvidenceKind, type ToolMemoryEvidencePolicy, type ToolMemoryExtractor, type ToolMemoryMetadata, type ToolMemoryNoteKind, type ToolMemoryNotePolicy, type ToolMemoryNoteScope, type ToolMetadata, type ToolParameterDefinition, ToolRegistry, type ToolRegistryBeforeExecuteContext, type ToolRegistryMissingToolContext, type ToolRegistryOptions, type ToolResult, ToolRunCommand, type ToolSchema, type TruncatedToolInfo, VALIDATE_AFTER_CHANGES_RULE_LINE, type WebSearchToolActionInput, WebToolLoopAgentRuntime, type WebToolLoopAgentRuntimeConstructorOptions, type WebToolLoopRuntimeStateLike, WebValidationEnforcer, type WorkspaceCodingStaticRulesOptions, agentMachine, applyIdleWebAgentState, applyInitialWebAgentRunState, buildAgentIdentityLine, buildAgentSystemPrompt, buildCompactionEntry, buildCoreStaticRules, buildNoStructuredResponseFoundError, buildSkillAwareStaticContext, buildSkillsSection, buildStepUserMessage, buildToolLogRevealFrames, buildToolUsageExample, buildValidationErrorMessage, buildWebRuntimeRules, buildWorkspaceCodingStaticRules, canonicalizeCompactionText, coerceToolCallToDefinition, configure, containsStandaloneStructuredInvocationStart, createAgentMemoryLayer, createAppendToolsSectionCustomizer, createBackgroundBashDefinition, createConversationSink, createCustomRunCommandRegistry, createInitialWebAgentState, createRunCommandRuntimeBindings, createRuntimeStore, createToolAgentMessage, createToolRegistry, createToolsSectionOverrideCustomizer, createWebAgentMessageIdGenerator, createWebSearchToolActions, createWebToolLoopCallbacks, decodeEscapedShellText, defineRuntimeController, enrichToolResultWithUnixMetadata, executeBackgroundUnixCommandString, executeToolCallWithRunCommands, executeToolLoopStep, executeToolSafe, executeUnixCommandString, extractPrimaryCommandMetadata, extractTruncatedToolInfo, formatToolCallAsUnixCommand, formatToolDefinitions, formatToolResultMessage, formatToolsSection, formatUnixToolSurface, formatZodValidationError, getDiagnosticSummaryLine, getProviderConfig, getRunCommandPromptAvailability, getToolLogSummaryLine, isBackgroundBashToolCall, isBashToolCall, limitEntriesByRecency, machineStateToWebAgentPhase, mapConversationRoleToAgentRole, parseAgentResponse, parseResponseWithRecovery, parseStructuredAgentText, parseToolResultMessage, parseUnixToolCommand, readDiagnosticLevel, readDiagnosticSource, resolveToolDefinitionForInvocation, runStructuredLLMCompaction, selectLatestByKey, shouldAutoScrollThread, shouldSkipStepUserMessage, stripDiagnosticMessagePrefix, suppressWebValidationLog, tokenizeUnixCommand };

package/dist/index.js

@@ -3133,31 +3133,194 @@ function extractTruncatedToolInfo(calls) {
 }
 
 // src/tool-helpers.ts
-var MAX_TOOL_RESULT_CHARS = 3e4;
-var MAX_PRESENTATION_LINES = 200;
-var MAX_PRESENTATION_CHARS = 5e4;
-function truncateToolResult(resultStr, options) {
-  const maxChars = options?.maxChars ?? MAX_TOOL_RESULT_CHARS;
-  const strategy = options?.strategy ?? "head-tail";
-  if (resultStr.length <= maxChars) return resultStr;
-  if (strategy === "head-only") {
-    return resultStr.substring(0, maxChars) + "\n...(truncated)";
-  }
-  const half = Math.floor(maxChars / 2);
-  const head = resultStr.substring(0, half);
-  const tail = resultStr.substring(resultStr.length - half);
-  const omitted = resultStr.length - maxChars;
-  return `${head}
-... [${omitted} chars truncated] ...
-${tail}`;
+var DEFAULT_MAX_LINES = 2e3;
+var DEFAULT_MAX_BYTES = 50 * 1024;
+function splitLinesForCounting(content) {
+  if (content.length === 0) {
+    return [];
+  }
+  const lines = content.split("\n");
+  if (content.endsWith("\n")) {
+    lines.pop();
+  }
+  return lines;
+}
+function truncateHead(content, options = {}) {
+  const maxLines = options.maxLines ?? DEFAULT_MAX_LINES;
+  const maxBytes = options.maxBytes ?? DEFAULT_MAX_BYTES;
+  const totalBytes = utf8ByteLength(content);
+  const lines = splitLinesForCounting(content);
+  const totalLines = lines.length;
+  if (totalLines <= maxLines && totalBytes <= maxBytes) {
+    return {
+      content,
+      truncated: false,
+      truncatedBy: null,
+      totalLines,
+      totalBytes,
+      outputLines: totalLines,
+      outputBytes: totalBytes,
+      lastLinePartial: false,
+      firstLineExceedsLimit: false,
+      maxLines,
+      maxBytes
+    };
+  }
+  if (lines.length > 0 && utf8ByteLength(lines[0]) > maxBytes) {
+    return {
+      content: "",
+      truncated: true,
+      truncatedBy: "bytes",
+      totalLines,
+      totalBytes,
+      outputLines: 0,
+      outputBytes: 0,
+      lastLinePartial: false,
+      firstLineExceedsLimit: true,
+      maxLines,
+      maxBytes
+    };
+  }
+  const outputLinesArr = [];
+  let outputBytesCount = 0;
+  let truncatedBy = "lines";
+  for (let i = 0; i < lines.length && i < maxLines; i++) {
+    const line = lines[i];
+    const lineBytes = utf8ByteLength(line) + (i > 0 ? 1 : 0);
+    if (outputBytesCount + lineBytes > maxBytes) {
+      truncatedBy = "bytes";
+      break;
+    }
+    outputLinesArr.push(line);
+    outputBytesCount += lineBytes;
+  }
+  if (outputLinesArr.length >= maxLines && outputBytesCount <= maxBytes) {
+    truncatedBy = "lines";
+  }
+  const outputContent = outputLinesArr.join("\n");
+  const finalOutputBytes = utf8ByteLength(outputContent);
+  return {
+    content: outputContent,
+    truncated: true,
+    truncatedBy,
+    totalLines,
+    totalBytes,
+    outputLines: outputLinesArr.length,
+    outputBytes: finalOutputBytes,
+    lastLinePartial: false,
+    firstLineExceedsLimit: false,
+    maxLines,
+    maxBytes
+  };
+}
+function truncateTail(content, options = {}) {
+  const maxLines = options.maxLines ?? DEFAULT_MAX_LINES;
+  const maxBytes = options.maxBytes ?? DEFAULT_MAX_BYTES;
+  const totalBytes = utf8ByteLength(content);
+  const lines = splitLinesForCounting(content);
+  const totalLines = lines.length;
+  if (totalLines <= maxLines && totalBytes <= maxBytes) {
+    return {
+      content,
+      truncated: false,
+      truncatedBy: null,
+      totalLines,
+      totalBytes,
+      outputLines: totalLines,
+      outputBytes: totalBytes,
+      lastLinePartial: false,
+      firstLineExceedsLimit: false,
+      maxLines,
+      maxBytes
+    };
+  }
+  const outputLinesArr = [];
+  let outputBytesCount = 0;
+  let truncatedBy = "lines";
+  let lastLinePartial = false;
+  for (let i = lines.length - 1; i >= 0 && outputLinesArr.length < maxLines; i--) {
+    const line = lines[i];
+    const lineBytes = utf8ByteLength(line) + (outputLinesArr.length > 0 ? 1 : 0);
+    if (outputBytesCount + lineBytes > maxBytes) {
+      truncatedBy = "bytes";
+      if (outputLinesArr.length === 0) {
+        const truncatedLine = truncateStringToBytesFromEnd(line, maxBytes);
+        outputLinesArr.unshift(truncatedLine);
+        outputBytesCount = utf8ByteLength(truncatedLine);
+        lastLinePartial = true;
+      }
+      break;
+    }
+    outputLinesArr.unshift(line);
+    outputBytesCount += lineBytes;
+  }
+  if (outputLinesArr.length >= maxLines && outputBytesCount <= maxBytes) {
+    truncatedBy = "lines";
+  }
+  const outputContent = outputLinesArr.join("\n");
+  const finalOutputBytes = utf8ByteLength(outputContent);
+  return {
+    content: outputContent,
+    truncated: true,
+    truncatedBy,
+    totalLines,
+    totalBytes,
+    outputLines: outputLinesArr.length,
+    outputBytes: finalOutputBytes,
+    lastLinePartial,
+    firstLineExceedsLimit: false,
+    maxLines,
+    maxBytes
+  };
 }
 function formatToolResultMessage(toolCall, result) {
   const exitCode = typeof result.exit_code === "number" ? result.exit_code : result.success === true ? 0 : 1;
   const durationMs = typeof result.duration_ms === "number" ? result.duration_ms : 0;
-  const command = typeof result.command === "string" && result.command.length > 0 ? result.command : formatPseudoCommand(toolCall);
-  const stdout = truncatePresentationOutput(renderToolStdout(result));
-  const stderr = renderToolStderr(result, exitCode);
-  const metaLine = buildMetaLine(toolCall, result);
+  const command = typeof result.command === "string" && result.command.length > 0 ? result.command : (() => {
+    const unixCommand = formatToolCallAsUnixCommand(toolCall);
+    if (unixCommand) {
+      return unixCommand;
+    }
+    const parts = [toolCall.name];
+    for (const [name, value] of Object.entries(toolCall.parameters ?? {})) {
+      if (value === void 0 || value === null) {
+        continue;
+      }
+      if (typeof value === "boolean") {
+        parts.push(value ? `--${name}` : `--no-${name}`);
+        continue;
+      }
+      if (typeof value === "string" && !value.includes("\n") && !/\s/.test(value)) {
+        parts.push(`--${name}`, value);
+        continue;
+      }
+      parts.push(`--${name}`, JSON.stringify(value));
+    }
+    return parts.join(" ");
+  })();
+  const stdout = truncatePresentationOutput(renderToolStdout(result), toolCall);
+  const stderr = typeof result.stderr === "string" && result.stderr.length > 0 ? result.stderr : exitCode !== 0 && typeof result.error === "string" ? result.error : "";
+  const metaLine = (() => {
+    const commandName = result.command_name;
+    const route = result.route;
+    const metadata = {
+      tool: typeof commandName === "string" ? commandName : toolCall.name,
+      route: typeof route === "string" ? route : toolCall.name
+    };
+    for (const source of [toolCall.parameters ?? {}, result]) {
+      for (const key of ["path", "url", "query", "taskId", "task_id", "pattern"]) {
+        const value = source[key];
+        if (typeof value === "string" && value.length > 0) {
+          metadata[key] = value;
+        }
+      }
+    }
+    const pairs = Object.entries(metadata);
+    if (pairs.length === 0) {
+      return "";
+    }
+    return `[meta] ${pairs.map(([key, value]) => `${key}=${typeof value === "string" ? JSON.stringify(value) : String(value)}`).join(" ")}`;
+  })();
   const lines = [`$ ${command}`];
   if (stdout) {
     lines.push(stdout);
@@ -3176,7 +3339,8 @@ ${stderr}`);
   if (metaLine) {
     lines.push(metaLine);
   }
-  lines.push(`[exit:${exitCode} | ${formatDuration(durationMs)}]`);
+  const duration = durationMs >= 1e3 ? `${(durationMs / 1e3).toFixed(1)}s` : `${Math.max(0, Math.round(durationMs))}ms`;
+  lines.push(`[exit:${exitCode} | ${duration}]`);
   return lines.join("\n");
 }
 function parseToolResultMessage(content) {
@@ -3221,7 +3385,14 @@ function parseToolResultMessage(content) {
       const exitMatch = line.match(/^\[exit:(-?\d+)\s*\|\s*([^\]]+)\]$/);
       if (exitMatch) {
         exitCode = Number(exitMatch[1]);
-        durationMs = parseDuration(exitMatch[2]);
+        const rawDuration = exitMatch[2].trim().toLowerCase();
+        if (rawDuration.endsWith("ms")) {
+          durationMs = Number(rawDuration.slice(0, -2)) || 0;
+        } else if (rawDuration.endsWith("s")) {
+          durationMs = Math.round((Number(rawDuration.slice(0, -1)) || 0) * 1e3);
+        } else {
+          durationMs = Number(rawDuration) || 0;
+        }
         inStderr = false;
         continue;
       }
@@ -3231,7 +3402,36 @@ function parseToolResultMessage(content) {
         stdoutLines.push(line);
       }
     }
-    const metadata = parseMetadata(metaLine);
+    const metadata = (() => {
+      if (!metaLine) {
+        return {};
+      }
+      const values = {};
+      const regex = /(\w+)=((?:"(?:[^"\\]|\\.)*")|\S+)/g;
+      let match;
+      while ((match = regex.exec(metaLine)) !== null) {
+        const key = match[1];
+        const rawValue = match[2];
+        if (rawValue.startsWith('"')) {
+          try {
+            values[key] = JSON.parse(rawValue);
+          } catch {
+            values[key] = rawValue.slice(1, -1);
+          }
+          continue;
+        }
+        if (rawValue === "true") {
+          values[key] = true;
+        } else if (rawValue === "false") {
+          values[key] = false;
+        } else if (!Number.isNaN(Number(rawValue))) {
+          values[key] = Number(rawValue);
+        } else {
+          values[key] = rawValue;
+        }
+      }
+      return values;
+    })();
     const stdout = stdoutLines.join("\n").trim();
     const stderr = stderrLines.join("\n").trim();
     const error = errorLine ?? (exitCode === 0 ? void 0 : stderr || void 0);
@@ -3307,116 +3507,122 @@ function renderToolStdout(result) {
   }
   return JSON.stringify(remainder, null, 2);
 }
-function renderToolStderr(result, exitCode) {
-  if (typeof result.stderr === "string" && result.stderr.length > 0) {
-    return result.stderr;
-  }
-  if (exitCode !== 0 && typeof result.error === "string") {
-    return result.error;
-  }
-  return "";
-}
-function truncatePresentationOutput(output) {
+function truncatePresentationOutput(output, toolCall) {
   if (!output) {
     return "";
   }
-  const lines = output.split(/\r?\n/);
-  if (lines.length <= MAX_PRESENTATION_LINES && output.length <= MAX_PRESENTATION_CHARS) {
+  const isBash = isBashLikeToolCall(toolCall);
+  const truncation = isBash ? truncateTail(output, { maxLines: DEFAULT_MAX_LINES, maxBytes: DEFAULT_MAX_BYTES }) : truncateHead(output, { maxLines: DEFAULT_MAX_LINES, maxBytes: DEFAULT_MAX_BYTES });
+  if (!truncation.truncated) {
     return output;
   }
-  const truncated = lines.slice(0, MAX_PRESENTATION_LINES).join("\n");
-  return `${truncated}
---- output truncated (${lines.length} lines, ${output.length} chars) ---
-Use more specific commands, filters, or line ranges to narrow the result.`;
-}
-function formatPseudoCommand(toolCall) {
-  const unixCommand = formatToolCallAsUnixCommand(toolCall);
-  if (unixCommand) {
-    return unixCommand;
+  const suffix = buildTruncationNotice(toolCall, truncation);
+  if (!suffix) {
+    return truncation.content;
   }
-  const parts = [toolCall.name];
-  for (const [name, value] of Object.entries(toolCall.parameters ?? {})) {
-    if (value === void 0 || value === null) {
-      continue;
+  if (!truncation.content) {
+    return suffix;
+  }
+  return `${truncation.content}
+
+${suffix}`;
+}
+function buildTruncationNotice(toolCall, truncation) {
+  const kind = (() => {
+    if (isBashLikeToolCall(toolCall)) {
+      return "bash";
     }
-    if (typeof value === "boolean") {
-      parts.push(value ? `--${name}` : `--no-${name}`);
-      continue;
+    const normalized = toolCall.name.toLowerCase();
+    if (normalized.includes("read")) return "read";
+    if (normalized === "ls" || normalized.includes("list")) return "ls";
+    if (normalized.includes("grep") || normalized.includes("search")) return "grep";
+    if (normalized.includes("find")) return "find";
+    return "default";
+  })();
+  if (kind === "read") {
+    if (truncation.firstLineExceedsLimit) {
+      return `[Line 1 exceeds ${formatSize(truncation.maxBytes)} limit. Use bash to read a bounded byte range.]`;
     }
-    if (typeof value === "string" && !value.includes("\n") && !/\s/.test(value)) {
-      parts.push(`--${name}`, value);
-      continue;
+    const endLine = Math.max(0, truncation.outputLines);
+    const nextOffset = endLine + 1;
+    if (truncation.truncatedBy === "lines") {
+      return `[Showing lines 1-${endLine} of ${truncation.totalLines}. Use offset=${nextOffset} to continue.]`;
     }
-    parts.push(`--${name}`, JSON.stringify(value));
+    return `[Showing lines 1-${endLine} of ${truncation.totalLines} (${formatSize(truncation.maxBytes)} limit). Use offset=${nextOffset} to continue.]`;
   }
-  return parts.join(" ");
-}
-function buildMetaLine(toolCall, result) {
-  const commandName = result.command_name;
-  const route = result.route;
-  const metadata = {
-    tool: typeof commandName === "string" ? commandName : toolCall.name,
-    route: typeof route === "string" ? route : toolCall.name
-  };
-  for (const source of [toolCall.parameters ?? {}, result]) {
-    for (const key of ["path", "url", "query", "taskId", "task_id", "pattern"]) {
-      const value = source[key];
-      if (typeof value === "string" && value.length > 0) {
-        metadata[key] = value;
-      }
+  if (kind === "bash") {
+    const startLine = truncation.totalLines - truncation.outputLines + 1;
+    const endLine = truncation.totalLines;
+    if (truncation.lastLinePartial) {
+      return `[Showing last ${formatSize(truncation.outputBytes)} of line ${endLine} (line exceeds ${formatSize(truncation.maxBytes)}).]`;
+    }
+    if (truncation.truncatedBy === "lines") {
+      return `[Showing lines ${startLine}-${endLine} of ${truncation.totalLines}.]`;
     }
+    return `[Showing lines ${startLine}-${endLine} of ${truncation.totalLines} (${formatSize(truncation.maxBytes)} limit).]`;
   }
-  const pairs = Object.entries(metadata);
-  if (pairs.length === 0) {
-    return "";
+  if (kind === "grep") {
+    return `[${formatSize(truncation.maxBytes)} limit reached. Refine pattern or narrow path.]`;
   }
-  return `[meta] ${pairs.map(([key, value]) => `${key}=${typeof value === "string" ? JSON.stringify(value) : String(value)}`).join(" ")}`;
+  if (kind === "find") {
+    return `[${formatSize(truncation.maxBytes)} limit reached. Refine pattern or increase limit.]`;
+  }
+  if (kind === "ls") {
+    return `[${formatSize(truncation.maxBytes)} limit reached. Use a narrower path.]`;
+  }
+  return `[Output truncated: showing ${truncation.outputLines} of ${truncation.totalLines} lines (${formatSize(truncation.outputBytes)} of ${formatSize(truncation.totalBytes)}).]`;
 }
-function parseMetadata(text) {
-  if (!text) {
-    return {};
+function isBashLikeToolCall(toolCall) {
+  if (toolCall.kind === "bash" || toolCall.kind === "background_bash") {
+    return true;
   }
-  const values = {};
-  const regex = /(\w+)=((?:"(?:[^"\\]|\\.)*")|\S+)/g;
-  let match;
-  while ((match = regex.exec(text)) !== null) {
-    const key = match[1];
-    const rawValue = match[2];
-    if (rawValue.startsWith('"')) {
-      try {
-        values[key] = JSON.parse(rawValue);
-      } catch {
-        values[key] = rawValue.slice(1, -1);
+  const normalized = toolCall.name.toLowerCase();
+  return normalized === "bash" || normalized === "backgroundbash";
+}
+function utf8ByteLength(text) {
+  if (!text) {
+    return 0;
+  }
+  return new TextEncoder().encode(text).length;
+}
+function truncateStringToBytesFromEnd(str, maxBytes) {
+  if (maxBytes <= 0) return "";
+  let outputBytes = 0;
+  let start = str.length;
+  for (let i = str.length; i > 0; ) {
+    let characterStart = i - 1;
+    const code = str.charCodeAt(characterStart);
+    let characterBytes;
+    if (code >= 56320 && code <= 57343 && characterStart > 0) {
+      const previous = str.charCodeAt(characterStart - 1);
+      if (previous >= 55296 && previous <= 56319) {
+        characterStart--;
+        characterBytes = 4;
+      } else {
+        characterBytes = 3;
       }
-      continue;
-    }
-    if (rawValue === "true") {
-      values[key] = true;
-    } else if (rawValue === "false") {
-      values[key] = false;
-    } else if (!Number.isNaN(Number(rawValue))) {
-      values[key] = Number(rawValue);
+    } else if (code >= 55296 && code <= 56319) {
+      characterBytes = 3;
     } else {
-      values[key] = rawValue;
+      characterBytes = code <= 127 ? 1 : code <= 2047 ? 2 : 3;
     }
+    if (outputBytes + characterBytes > maxBytes) break;
+    outputBytes += characterBytes;
+    start = characterStart;
+    i = characterStart;
   }
-  return values;
+  return str.slice(start);
 }
-function formatDuration(durationMs) {
-  if (durationMs >= 1e3) {
-    return `${(durationMs / 1e3).toFixed(1)}s`;
+function formatSize(bytes) {
+  if (bytes < 1024) {
+    return `${bytes}B`;
   }
-  return `${Math.max(0, Math.round(durationMs))}ms`;
-}
-function parseDuration(raw) {
-  const trimmed = raw.trim().toLowerCase();
-  if (trimmed.endsWith("ms")) {
-    return Number(trimmed.slice(0, -2)) || 0;
+  const kb = bytes / 1024;
+  if (kb < 1024) {
+    return `${kb.toFixed(1)}KB`;
   }
-  if (trimmed.endsWith("s")) {
-    return Math.round((Number(trimmed.slice(0, -1)) || 0) * 1e3);
-  }
-  return Number(trimmed) || 0;
+  const mb = kb / 1024;
+  return `${mb.toFixed(1)}MB`;
 }
 
 // src/agent-response-parser.ts
@@ -3788,10 +3994,7 @@ var AgentLoop = class {
         if (this.deps.formatToolResult) {
           result = this.deps.formatToolResult(result, tc.name);
         }
-        let resultStr = formatToolResultMessage(tc, result);
-        resultStr = truncateToolResult(resultStr, {
-          strategy: "head-tail"
-        });
+        const resultStr = formatToolResultMessage(tc, result);
         if (wasTruncated && this._truncatedToolInfo && i === 0) {
           this._truncatedToolInfo.executionSucceeded = result.success === true;
         }
@@ -7494,6 +7697,6 @@ async function executeToolLoopStep(options) {
   };
 }
 
-export { AGENT_MACHINE_STATES, AgentLoop, AgentMemoryLayer, ApiError, BackgroundBashRunCommand, BaseMemoryLayer, BaseValidationEnforcer, BashRunCommand, CODE_QUALITY_RULE_LINE, CharTokenEstimator, DEFAULT_AGENT_FALLBACK_SYSTEM_PROMPT, DEFAULT_ALLOWED_RUN_TARGETS, DEFAULT_RUN_COMMAND_REGISTRY, DEFAULT_THREAD_AUTO_SCROLL_BOTTOM_THRESHOLD, DEFAULT_TOOL_MEMORY_EXTRACTOR, ERROR_RECOVERY_RULE_LINE, ERROR_TRUNCATED_RESPONSE, INCREMENTAL_TESTING_RULE_LINE, JUST_BASH_SCRIPT_EXECUTION_RESTRICTION_LINES, JUST_BASH_SHELL_NATIVE_WORKFLOW_COMMAND_EXAMPLES, LLMClient, LLMResponseSchema, MAX_TOOL_RESULT_CHARS, PORT_CONFLICT_RULE_LINE, PendingAgentMessageBuffer, ProxyTool, ROOT_CAUSES_RULE_LINE, RunCommand, RunCommandRegistry, SHARED_TOOL_CALL_EXAMPLE_LINES, SHARED_TOOL_USAGE_RULE, SINGLE_TOOL_CALL_RUN_LINE_EXAMPLE, SKILL_INVOKE_READ_RULE_LINE, STANDARD_TOOL_CALL_FORMAT_RULES, SUPPORTED_RUN_TARGETS, StreamingToolParser, SubAgentTool, TODO_LIST_FIRST_RESPONSE_RULE_LINE, TOOL_CALL_SEPARATOR_RULE, Tool, ToolCallSchema, ToolLoopAgentRuntime, ToolRegistry, ToolRunCommand, VALIDATE_AFTER_CHANGES_RULE_LINE, WebToolLoopAgentRuntime, WebValidationEnforcer, agentMachine, applyIdleWebAgentState, applyInitialWebAgentRunState, buildAgentIdentityLine, buildAgentSystemPrompt, buildCompactionEntry, buildCoreStaticRules, buildNoStructuredResponseFoundError, buildSkillAwareStaticContext, buildSkillsSection, buildStepUserMessage, buildToolLogRevealFrames, buildToolUsageExample, buildValidationErrorMessage, buildWebRuntimeRules, buildWorkspaceCodingStaticRules, canonicalizeCompactionText, coerceToolCallToDefinition, configure, containsStandaloneStructuredInvocationStart, createAgentMemoryLayer, createAppendToolsSectionCustomizer, createBackgroundBashDefinition, createConversationSink, createCustomRunCommandRegistry, createInitialWebAgentState, createRunCommandRuntimeBindings, createRuntimeStore, createToolAgentMessage, createToolRegistry, createToolsSectionOverrideCustomizer, createWebAgentMessageIdGenerator, createWebSearchToolActions, createWebToolLoopCallbacks, decodeEscapedShellText, defineRuntimeController, enrichToolResultWithUnixMetadata, executeBackgroundUnixCommandString, executeToolCallWithRunCommands, executeToolLoopStep, executeToolSafe, executeUnixCommandString, extractPrimaryCommandMetadata, extractTruncatedToolInfo, formatToolCallAsUnixCommand, formatToolDefinitions, formatToolResultMessage, formatToolsSection, formatUnixToolSurface, formatZodValidationError, getDiagnosticSummaryLine, getProviderConfig, getRunCommandPromptAvailability, getToolLogSummaryLine, isBackgroundBashToolCall, isBashToolCall, limitEntriesByRecency, machineStateToWebAgentPhase, mapConversationRoleToAgentRole, parseAgentResponse, parseResponseWithRecovery, parseStructuredAgentText, parseToolResultMessage, parseUnixToolCommand, readDiagnosticLevel, readDiagnosticSource, resolveToolDefinitionForInvocation, runStructuredLLMCompaction, selectLatestByKey, shouldAutoScrollThread, shouldSkipStepUserMessage, stripDiagnosticMessagePrefix, suppressWebValidationLog, tokenizeUnixCommand, truncateToolResult };
+export { AGENT_MACHINE_STATES, AgentLoop, AgentMemoryLayer, ApiError, BackgroundBashRunCommand, BaseMemoryLayer, BaseValidationEnforcer, BashRunCommand, CODE_QUALITY_RULE_LINE, CharTokenEstimator, DEFAULT_AGENT_FALLBACK_SYSTEM_PROMPT, DEFAULT_ALLOWED_RUN_TARGETS, DEFAULT_RUN_COMMAND_REGISTRY, DEFAULT_THREAD_AUTO_SCROLL_BOTTOM_THRESHOLD, DEFAULT_TOOL_MEMORY_EXTRACTOR, ERROR_RECOVERY_RULE_LINE, ERROR_TRUNCATED_RESPONSE, INCREMENTAL_TESTING_RULE_LINE, JUST_BASH_SCRIPT_EXECUTION_RESTRICTION_LINES, JUST_BASH_SHELL_NATIVE_WORKFLOW_COMMAND_EXAMPLES, LLMClient, LLMResponseSchema, PORT_CONFLICT_RULE_LINE, PendingAgentMessageBuffer, ProxyTool, ROOT_CAUSES_RULE_LINE, RunCommand, RunCommandRegistry, SHARED_TOOL_CALL_EXAMPLE_LINES, SHARED_TOOL_USAGE_RULE, SINGLE_TOOL_CALL_RUN_LINE_EXAMPLE, SKILL_INVOKE_READ_RULE_LINE, STANDARD_TOOL_CALL_FORMAT_RULES, SUPPORTED_RUN_TARGETS, StreamingToolParser, SubAgentTool, TODO_LIST_FIRST_RESPONSE_RULE_LINE, TOOL_CALL_SEPARATOR_RULE, Tool, ToolCallSchema, ToolLoopAgentRuntime, ToolRegistry, ToolRunCommand, VALIDATE_AFTER_CHANGES_RULE_LINE, WebToolLoopAgentRuntime, WebValidationEnforcer, agentMachine, applyIdleWebAgentState, applyInitialWebAgentRunState, buildAgentIdentityLine, buildAgentSystemPrompt, buildCompactionEntry, buildCoreStaticRules, buildNoStructuredResponseFoundError, buildSkillAwareStaticContext, buildSkillsSection, buildStepUserMessage, buildToolLogRevealFrames, buildToolUsageExample, buildValidationErrorMessage, buildWebRuntimeRules, buildWorkspaceCodingStaticRules, canonicalizeCompactionText, coerceToolCallToDefinition, configure, containsStandaloneStructuredInvocationStart, createAgentMemoryLayer, createAppendToolsSectionCustomizer, createBackgroundBashDefinition, createConversationSink, createCustomRunCommandRegistry, createInitialWebAgentState, createRunCommandRuntimeBindings, createRuntimeStore, createToolAgentMessage, createToolRegistry, createToolsSectionOverrideCustomizer, createWebAgentMessageIdGenerator, createWebSearchToolActions, createWebToolLoopCallbacks, decodeEscapedShellText, defineRuntimeController, enrichToolResultWithUnixMetadata, executeBackgroundUnixCommandString, executeToolCallWithRunCommands, executeToolLoopStep, executeToolSafe, executeUnixCommandString, extractPrimaryCommandMetadata, extractTruncatedToolInfo, formatToolCallAsUnixCommand, formatToolDefinitions, formatToolResultMessage, formatToolsSection, formatUnixToolSurface, formatZodValidationError, getDiagnosticSummaryLine, getProviderConfig, getRunCommandPromptAvailability, getToolLogSummaryLine, isBackgroundBashToolCall, isBashToolCall, limitEntriesByRecency, machineStateToWebAgentPhase, mapConversationRoleToAgentRole, parseAgentResponse, parseResponseWithRecovery, parseStructuredAgentText, parseToolResultMessage, parseUnixToolCommand, readDiagnosticLevel, readDiagnosticSource, resolveToolDefinitionForInvocation, runStructuredLLMCompaction, selectLatestByKey, shouldAutoScrollThread, shouldSkipStepUserMessage, stripDiagnosticMessagePrefix, suppressWebValidationLog, tokenizeUnixCommand };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map