hammer-ai 0.2.13 → 0.2.15

package/README.md

@@ -0,0 +1,332 @@
+# hammer-ai
+
+Infrastructure for building tool-calling chat agents in TypeScript.
+
+This package gives you:
+- OpenAI-compatible LLM client with streaming support
+- Agent loop runtime for web/chat interfaces
+- Tool base class and tool registry
+- Built-in handling for tool, bash, and background_bash run targets
+- Memory and validation layers for longer multi-step workflows
+
+The examples below are based on a real production-style integration from monoslides.
+
+## Install
+
+```bash
+bun add hammer-ai
+```
+
+## Mental model
+
+```mermaid
+flowchart LR
+  UI[Chat UI] --> Runtime[WebToolLoopAgentRuntime]
+  Runtime --> LLM[LLMClient]
+  Runtime --> Registry[ToolRegistry]
+  Registry --> Local[Local Tool classes]
+  Registry --> Proxy[ProxyTool to server actions]
+  Registry --> Bash[Bash and BackgroundBash run commands]
+  Runtime --> Store[Runtime store]
+  Store --> UI
+```
+
+## 1. Configure providers (Qwen and DeepSeek)
+
+Configure once at startup. You can keep multiple named presets and choose one for your runtime.
+
+```ts
+import { configure } from "hammer-ai"
+
+configure({
+  providers: {
+    "qwen-plus": {
+      apiKey: process.env.DASHSCOPE_API_KEY!,
+      baseUrl: "https://dashscope.aliyuncs.com/compatible-mode/v1",
+      model: "qwen-plus",
+      enableThinking: false,
+    },
+    deepseek: {
+      apiKey: process.env.DEEPSEEK_API_KEY!,
+      baseUrl: "https://api.deepseek.com",
+      model: "deepseek-v4-flash",
+      enableThinking: false,
+    },
+    "deepseek-reasoner": {
+      apiKey: process.env.DEEPSEEK_API_KEY!,
+      baseUrl: "https://api.deepseek.com",
+      model: "deepseek-reasoner",
+      enableThinking: true,
+    },
+  },
+  compactionProvider: "deepseek",
+})
+```
+
+Notes:
+- For Qwen-style endpoints, enableThinking maps to enable_thinking.
+- For DeepSeek endpoints, enableThinking maps to thinking.type (enabled or disabled).
+
+## 2. Create tools
+
+Create local tools by extending Tool.
+
+```ts
+import { Tool, type ToolResult, type ToolSchema } from "hammer-ai"
+
+export class GetSlideFilePath extends Tool {
+  override getName(): string {
+    return "GetSlideFilePath"
+  }
+
+  override getDescription(): string {
+    return "Return the absolute path for the active slide SVG"
+  }
+
+  override getSchema(): ToolSchema {
+    return {
+      slideId: {
+        type: "string",
+        required: true,
+        positional: false,
+        description: "Slide identifier",
+      },
+    }
+  }
+
+  override async execute(params: Record<string, any>): Promise<ToolResult> {
+    const slideId = String(params.slideId ?? "").trim()
+    if (!slideId) return { success: false, error: "slideId is required" }
+
+    return {
+      success: true,
+      path: `/workspace/slide-${slideId}.svg`,
+    }
+  }
+}
+```
+
+## 3. Wire registry + proxy tools + bash
+
+Use createToolRegistry for a mixed tool surface:
+- local tool classes
+- proxy tools that call server actions
+- bash run command bindings
+
+```ts
+import {
+  createToolRegistry,
+  ProxyTool,
+  createRunCommandRuntimeBindings,
+  BackgroundBashRunCommand,
+} from "hammer-ai"
+import { BashRunCommand } from "hammer-ai"
+
+import { GetSlideFilePath } from "./tools/GetSlideFilePath"
+import { CreateOrReplaceSlide } from "./tools/CreateOrReplaceSlide"
+import { executeWebToolAction } from "./actions/web-tool-actions"
+
+class AppBashRunCommand extends BashRunCommand {
+  protected override async executeCommand(command: string) {
+    // Route shell execution to your sandbox/session implementation.
+    return executeInSandbox(command)
+  }
+}
+
+const registry = createToolRegistry(
+  [
+    new ProxyTool(
+      {
+        name: "BraveWebSearch",
+        description: "Search the web",
+        parameters: {
+          query: {
+            type: "string",
+            description: "Search query",
+            required: true,
+          },
+        },
+      },
+      (parameters) => executeWebToolAction({ tool: "BraveWebSearch", input: parameters }),
+    ),
+    new GetSlideFilePath(),
+    new CreateOrReplaceSlide(),
+  ],
+  createRunCommandRuntimeBindings(
+    new AppBashRunCommand(),
+    new BackgroundBashRunCommand(),
+  ),
+)
+
+const executeTool = registry.createExecutor()
+```
+
+## 4. Build a chat runtime
+
+WebToolLoopAgentRuntime is the easiest way to run a multi-step tool loop and stream content into UI state.
+
+```ts
+import {
+  createRuntimeStore,
+  createInitialWebAgentState,
+  WebToolLoopAgentRuntime,
+  LLMClient,
+  getProviderConfig,
+  buildAgentIdentityLine,
+  buildWebRuntimeRules,
+} from "hammer-ai"
+
+const runtimeStore = createRuntimeStore(() => createInitialWebAgentState())
+
+class SlidesRuntime extends WebToolLoopAgentRuntime {
+  constructor() {
+    super({
+      store: runtimeStore,
+      messageIdPrefix: "slides-msg",
+      llmClient: new LLMClient({
+        ...getProviderConfig("deepseek"),
+        enableThinking: false,
+      }),
+      getToolDefinitions: () => registry.getToolDefinitions(),
+      executeTool,
+      memoryPreset: "monoslides",
+      systemIdentity: buildAgentIdentityLine({
+        agentName: "MonoSlides",
+        roleDescription: "Slide design assistant",
+      }),
+      extraRules: buildWebRuntimeRules({
+        includeVerifiedCompletionRule: true,
+      }),
+      temperature: 0.2,
+      maxTokens: 8192,
+      allowedRunTargets: ["tool", "bash"],
+    })
+  }
+
+  async run(userTask: string): Promise<void> {
+    await this.executeDefaultWebRun(userTask, {
+      shouldSurfaceAssistantContent: (_reasoning, rawContent) => Boolean(rawContent),
+    })
+  }
+
+  abort(): void {
+    this.defaultWebAbort()
+  }
+
+  reset(): void {
+    this.defaultWebReset()
+  }
+}
+
+export const runtime = new SlidesRuntime()
+```
+
+## 5. Expose controller actions
+
+A small controller wrapper keeps runtime actions and store in one object.
+
+```ts
+import { defineRuntimeController } from "hammer-ai"
+
+export const chatController = defineRuntimeController({
+  store: runtimeStore,
+  actions: {
+    run: (prompt: string) => runtime.run(prompt),
+    abort: () => runtime.abort(),
+    reset: () => runtime.reset(),
+  },
+  refs: {} as const,
+})
+```
+
+## 6. Render in UI
+
+You can subscribe directly with useSyncExternalStore.
+
+```tsx
+import { useSyncExternalStore, useState } from "react"
+
+function useRuntimeState() {
+  return useSyncExternalStore(
+    chatController.store.subscribe,
+    chatController.store.getSnapshot,
+    chatController.store.getServerSnapshot,
+  )
+}
+
+export function ChatPanel() {
+  const state = useRuntimeState()
+  const [input, setInput] = useState("")
+  const isRunning = state.phase === "thinking" || state.phase === "tool-calling"
+
+  return (
+    <div>
+      <div>
+        {state.messages.map((message) => (
+          <div key={message.id}>{message.content}</div>
+        ))}
+        {state.streamingContent ? <div>{state.streamingContent}</div> : null}
+      </div>
+
+      <form
+        onSubmit={(event) => {
+          event.preventDefault()
+          const next = input.trim()
+          if (!next || isRunning) return
+          chatController.actions.run(next)
+          setInput("")
+        }}
+      >
+        <textarea value={input} onChange={(event) => setInput(event.target.value)} />
+        {isRunning ? (
+          <button type="button" onClick={() => chatController.actions.abort()}>Stop</button>
+        ) : (
+          <button type="submit">Send</button>
+        )}
+      </form>
+    </div>
+  )
+}
+```
+
+## 7. Recommended production patterns
+
+- Keep local, deterministic operations as Tool subclasses.
+- Wrap privileged/server-only capabilities (web calls, secrets, DB) with ProxyTool.
+- Give the model only the run targets you want via allowedRunTargets.
+- Keep strict completion rules (for example: todo list must be completed before exit).
+- Use executeDefaultWebRun for serialization, abort handling, and consistent state transitions.
+- Prefer enableThinking: false for latency-sensitive UX, and enable it only for tasks that need deeper reasoning.
+
+## 8. Minimal server action bridge example
+
+```ts
+import { createWebSearchToolActions } from "hammer-ai"
+
+const actions = createWebSearchToolActions({
+  executeWebSearch: (tool, input) => {
+    if (tool === "BochaWebSearch") return bocha.execute(input)
+    return brave.execute(input)
+  },
+})
+
+export async function executeWebToolAction(input: {
+  tool: "BraveWebSearch" | "BochaWebSearch"
+  input: Record<string, unknown>
+}) {
+  return actions.executeWebTool(input)
+}
+```
+
+## API Surface
+
+Main exports used in this guide:
+- configure, getProviderConfig
+- LLMClient
+- Tool, ProxyTool, SubAgentTool
+- createToolRegistry, createRunCommandRuntimeBindings
+- BashRunCommand, BackgroundBashRunCommand
+- WebToolLoopAgentRuntime
+- createRuntimeStore, defineRuntimeController
+- createInitialWebAgentState
+- createWebSearchToolActions

package/dist/index.d.ts

@@ -32,14 +32,14 @@ interface LLMProviderConfig {
      * Explicitly enable or disable the provider's thinking/reasoning mode.
      *
      * - `false` — disables thinking (e.g. DashScope `enable_thinking: false` for
-     *   Qwen3 models, which have thinking on by default). Prevents the silent
-     *   multi-minute server-side CoT delay before the first token streams out.
+     *   Qwen3 models, or DeepSeek `thinking: { type: "disabled" }`).
      * - `true`  — explicitly enables thinking with the provider's default budget.
      * - `undefined` — no thinking-related field is sent; the provider uses its
      *   own model default.
      *
-     * Currently maps to `enable_thinking` in the request body, which is the
-     * DashScope OpenAI-compatible API parameter for Qwen3 models.
+     * Currently maps to provider-specific request fields:
+     * - Qwen/DashScope: `enable_thinking`
+     * - DeepSeek: `thinking: { type: "enabled" | "disabled" }`
      */
     enableThinking?: boolean;
 }
@@ -176,7 +176,7 @@ interface LLMResponse {
     outcome: LoopOutcome;
     finishReason?: string;
 }
-type ProviderName = "qwen-max" | "qwen-plus" | "openrouter-claude" | "openrouter-gemini" | "minimax" | "minimax-her" | "chatglm" | "kimi" | "doubao";
+type ProviderName = "qwen-max" | "qwen-plus" | "deepseek" | "deepseek-chat" | "deepseek-reasoner" | "openrouter-claude" | "openrouter-gemini" | "minimax" | "minimax-her" | "chatglm" | "kimi" | "doubao";
 
 /**
  * configure.ts — global configuration store for hammer-agent.
@@ -195,6 +195,8 @@ interface HammerAgentProviderPreset {
     model: string;
     /** Extra headers merged into every request (e.g. HTTP-Referer for OpenRouter). */
     extraHeaders?: Record<string, string>;
+    /** Provider-specific thinking/reasoning toggle (Qwen/DeepSeek). */
+    enableThinking?: boolean;
 }
 /**
  * Options accepted by `configure()`.
@@ -2069,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;
@@ -2466,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 };