hammer-ai 0.2.0 → 0.2.1

package/dist/index.d.ts

@@ -1699,10 +1699,23 @@ interface AgentMemoryFactoryOverrides {
  */
 declare function createAgentMemoryLayer(preset: string, overrides?: AgentMemoryFactoryOverrides): AgentMemoryLayer;
 
+/**
+ * Shared structured control-segment prompt fragments used across agent loops.
+ *
+ * These helpers centralize the plain header-block response contract while
+ * letting each agent layer domain-specific constraints on top.
+ */
+declare const TOOL_CALL_SEPARATOR_RULE = "The slug header is a hard separator between prose/thought and command/action. Put all prose before the slug, put the standalone slug header on its own line, and put only the executable payload on the following line(s). There must be a newline before the slug header and a newline after the slug header.";
+declare const JUST_BASH_SHELL_NATIVE_WORKFLOW_COMMAND_EXAMPLES: string;
+declare const JUST_BASH_SCRIPT_EXECUTION_RESTRICTION_LINES: string[];
 interface BashCommandsSectionOptions {
     shellNativeWorkflowCommandExamples?: string;
     additionalGuidanceLines?: string[];
 }
+declare const STANDARD_TOOL_CALL_FORMAT_RULES: string[];
+declare const SINGLE_TOOL_CALL_RUN_LINE_EXAMPLE: string;
+declare const SHARED_TOOL_CALL_EXAMPLE_LINES: string[];
+declare const CONTINUE_TOOL_CALL_RESPONSE_EXAMPLE: string;
 
 /**
  * Shared prompt building utilities for agentic loops.
@@ -1712,6 +1725,12 @@ interface BashCommandsSectionOptions {
  */
 
 declare const DEFAULT_AGENT_FALLBACK_SYSTEM_PROMPT = "You are an AI agent.";
+declare const ERROR_RECOVERY_RULE_LINE = "**ERROR RECOVERY**: If a tool returns `success=false`, inspect the error, fix the cause, and retry.";
+declare const ROOT_CAUSES_RULE_LINE = "**ROOT CAUSES**: Fix root causes rather than suppressing symptoms.";
+declare const VALIDATE_AFTER_CHANGES_RULE_LINE = "**VALIDATE AFTER CHANGES**: Check syntax, imports, and obvious integration errors after editing.";
+declare const INCREMENTAL_TESTING_RULE_LINE = "**INCREMENTAL TESTING**: Write \u2192 test \u2192 fix before moving on. Verify deliverables actually work before finishing successfully.";
+declare const CODE_QUALITY_RULE_LINE = "**CODE QUALITY**: For TypeScript, prefer `tsc --noEmit` or the repo's build/test command after meaningful edits.";
+declare const TODO_LIST_FIRST_RESPONSE_RULE_LINE = "You MUST call the manage_todo_list tool in your very first response to plan your work before executing any other tool. Break the task into specific, actionable steps. On subsequent responses, update the todo list to reflect progress.";
 interface FormatToolsSectionOptions {
     bashAvailable?: boolean;
     backgroundBashAvailable?: boolean;
@@ -1736,6 +1755,44 @@ declare function createToolsSectionOverrideCustomizer(buildToolsSection: (contex
  * Thin wrapper over `formatToolDefinitions` with configurable bash guidance.
  */
 declare function formatToolsSection(tools: ToolDefinition[], options?: FormatToolsSectionOptions): string;
+interface SkillSummaryLike {
+    metadata: {
+        name: string;
+        description: string;
+    };
+}
+declare function buildSkillAwareStaticContext(options: {
+    allSkills: SkillSummaryLike[];
+    staticRules: string;
+}): string;
+interface WorkspaceCodingStaticRulesOptions {
+    rulesHeading?: string;
+    skillsDirectory?: string;
+    additionalRuleSections?: readonly WorkspaceCodingStaticRuleSection[];
+}
+type WorkspaceCodingStaticBuiltInSection = "workspace-safety" | "editing-strategy" | "verification" | "efficiency";
+type WorkspaceCodingStaticRuleSection = {
+    section: WorkspaceCodingStaticBuiltInSection;
+    ruleLines?: readonly string[];
+    omitRuleLines?: readonly string[];
+    heading?: never;
+} | {
+    heading: string;
+    ruleLines: readonly string[];
+    section?: never;
+    omitRuleLines?: never;
+};
+declare const PORT_CONFLICT_RULE_LINE = "**PORT CONFLICTS**: If a server fails with `EADDRINUSE` and `FreePort` is available, use it before retrying.";
+declare function buildWorkspaceCodingStaticRules(options?: WorkspaceCodingStaticRulesOptions): string;
+declare function buildAgentIdentityLine(options: {
+    identity?: string;
+    agentName?: string;
+    roleDescription?: string;
+}): string;
+declare function buildWebRuntimeRules(options?: {
+    additionalRules?: string[];
+    includeVerifiedCompletionRule?: boolean;
+}): string;
 declare function buildAgentSystemPrompt(options: {
     identityLine?: string;
     tools: ToolDefinition[];
@@ -2051,7 +2108,22 @@ type ToolSchema = ToolDefinition["parameters"];
 interface ToolMetadata extends ToolDefinitionMetadata {
     requirements: string[];
 }
-declare abstract class Tool {
+/**
+ * Structural interface for any tool that can be registered in a ToolRegistry.
+ * Using an interface lets both this class hierarchy and external class
+ * hierarchies (e.g. @shared/tools) be stored in the same registry without
+ * requiring a shared base-class inheritance chain.
+ */
+interface ToolLike {
+    execute(params: Record<string, any>): Promise<ToolResult>;
+    getName(): string;
+    getDescription(): string;
+    getSchema(): ToolSchema;
+    getUsageExample(): string | undefined;
+    getMetadata(): ToolMetadata;
+    toDefinition(): ToolDefinition;
+}
+declare abstract class Tool implements ToolLike {
     protected workspaceRoot: string;
     constructor(workspaceRoot?: string);
     /**
@@ -2094,7 +2166,7 @@ interface ToolRegistryBeforeExecuteContext {
     registry: ToolRegistry;
 }
 interface ToolRegistryOptions {
-    tools?: Iterable<Tool>;
+    tools?: Iterable<ToolLike>;
     canExecute?: boolean | (() => boolean);
     executeBash?: BashExecutor;
     executeBackgroundBash?: BackgroundBashExecutor;
@@ -2102,23 +2174,23 @@ interface ToolRegistryOptions {
     onMissingTool?: (context: ToolRegistryMissingToolContext) => Error | string;
     beforeExecute?: (context: ToolRegistryBeforeExecuteContext) => Promise<ToolResult | void> | ToolResult | void;
 }
-declare function createToolRegistry(tools?: Iterable<Tool>, options?: Omit<ToolRegistryOptions, "tools">): ToolRegistry;
+declare function createToolRegistry(tools?: Iterable<ToolLike>, options?: Omit<ToolRegistryOptions, "tools">): ToolRegistry;
 declare class ToolRegistry {
-    protected tools: Map<string, Tool>;
+    protected tools: Map<string, ToolLike>;
     private canExecuteOverride?;
     private bashExecutor?;
     private backgroundBashExecutor?;
     private runCommandRegistry;
     private onMissingTool?;
     private beforeExecute?;
-    constructor(toolsOrOptions?: Iterable<Tool> | ToolRegistryOptions);
-    registerTool(tool: Tool): void;
-    registerTools(tools: Iterable<Tool>): void;
-    replaceTools(tools: Iterable<Tool>): void;
+    constructor(toolsOrOptions?: Iterable<ToolLike> | ToolRegistryOptions);
+    registerTool(tool: ToolLike): void;
+    registerTools(tools: Iterable<ToolLike>): void;
+    replaceTools(tools: Iterable<ToolLike>): void;
     hasTool(name: string): boolean;
-    getTool(name: string): Tool;
+    getTool(name: string): ToolLike;
     protected buildMissingToolError(name: string): Error;
-    getTools(): Tool[];
+    getTools(): ToolLike[];
     executeTool(name: string, parameters: Record<string, any>): Promise<ToolResult>;
     executeToolCall(toolCall: ToolCall): Promise<ToolResult>;
     private createConcreteRuntime;
@@ -2228,4 +2300,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, 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_TRUNCATED_RESPONSE, type EnforcerResult, type ExecuteWebLoopRunOptions, type FetchLike, type FetchResponseLike, type HammerAgentConfig, type HammerAgentProviderPreset, LLMClient, type LLMClientResponse, type LLMProviderConfig, type LLMRequest, type LLMRequestOptions, type LLMResponse, type LoopOutcome, MAX_TOOL_RESULT_CHARS, type MemoryMessage, type MemoryProvenance, type MemoryStorage, type ParseAgentResponseOptions, type ParsedAgentResponse, type ParsedBackgroundBashCommand, type ParsedStepInput, PendingAgentMessageBuffer, type PersistedMemoryData, type ProviderName, ProxyTool, type ProxyToolExecutor, type RawMessage, RunCommand, type RunCommandParseResult, type RunCommandPromptAvailability, RunCommandRegistry, type RunInvocationTarget, type RuntimeController, type RuntimeSnapshotUpdater, type RuntimeStore, type RuntimeSubscriber, SUPPORTED_RUN_TARGETS, type StepResult, type StreamCallbacks, StreamingToolParser, type StreamingToolParserCallbacks, type SystemPromptCustomizer, type TodoItem, type TodoStatus, type TokenEstimator, Tool, type ToolCall, type ToolDataPrimitive, type ToolDataSchema, type ToolDataValue, type ToolDefinition, type ToolDefinitionMetadata, type ToolExecutionResult, 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, type WebSearchToolActionInput, WebToolLoopAgentRuntime, type WebToolLoopAgentRuntimeConstructorOptions, type WebToolLoopRuntimeStateLike, WebValidationEnforcer, agentMachine, applyIdleWebAgentState, applyInitialWebAgentRunState, buildAgentSystemPrompt, buildCompactionEntry, buildCoreStaticRules, buildNoStructuredResponseFoundError, buildParseFeedback, buildStepUserMessage, buildToolLogRevealFrames, buildToolUsageExample, buildValidationErrorMessage, 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, CONTINUE_TOOL_CALL_RESPONSE_EXAMPLE, 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, 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, SINGLE_TOOL_CALL_RUN_LINE_EXAMPLE, STANDARD_TOOL_CALL_FORMAT_RULES, SUPPORTED_RUN_TARGETS, type SkillSummaryLike, type StepResult, type StreamCallbacks, StreamingToolParser, type StreamingToolParserCallbacks, 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, 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, buildParseFeedback, buildSkillAwareStaticContext, 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 };

package/dist/index.js

@@ -873,11 +873,14 @@ function buildShellNativeWorkflowCommandExamples(options) {
   return commands.join(", ");
 }
 var SHELL_NATIVE_WORKFLOW_COMMAND_EXAMPLES = buildShellNativeWorkflowCommandExamples();
-buildShellNativeWorkflowCommandExamples({
+var JUST_BASH_SHELL_NATIVE_WORKFLOW_COMMAND_EXAMPLES = buildShellNativeWorkflowCommandExamples({
   includeGit: false,
   includeBun: false,
   includeCurl: false
 });
+var JUST_BASH_SCRIPT_EXECUTION_RESTRICTION_LINES = [
+  "Never try to run scripts with `python`, `python3`, `node`, `nodejs`, `bun`, or similar runtimes unless a listed tool explicitly provides that capability."
+];
 function buildBashCommandsSectionLines(options) {
   const shellNativeWorkflowCommandExamples = options?.shellNativeWorkflowCommandExamples ?? SHELL_NATIVE_WORKFLOW_COMMAND_EXAMPLES;
   const additionalGuidanceLines = (options?.additionalGuidanceLines ?? []).map((line) => line.trim()).filter((line) => line.length > 0);
@@ -927,6 +930,12 @@ function buildMultipleStructuredControlSegmentsValidationError(segmentCount) {
     `You emitted ${segmentCount} structured control blocks in one response. Emit exactly one standalone slug header per response. The slug header is the separator between prose/thought and command/action.`
   );
 }
+[
+  "The final executable control block must use one standalone header: ---tool---, ---bash---, or ---background_bash---. Put prose first, then a newline, then the standalone header on its own line, then a newline, then the payload. The header and payload must be the LAST thing in your message - never put speech after them.",
+  ...STANDARD_TOOL_CALL_FORMAT_RULES,
+  ...SLUG_FORMAT_EXAMPLE_RULE_LINES,
+  "Only call tools that are explicitly listed below. If no tools are listed and bash is unavailable, do not emit a control block."
+];
 buildBashCommandsSectionLines();
 var BACKGROUND_BASH_START_EXAMPLE_LINE = `- Start:
 ${formatStructuredControlSegment("background_bash", 'start <name> --command "<long-running server command>"')}`;
@@ -965,6 +974,10 @@ var SHARED_TOOL_CALL_EXAMPLE_LINES = [
   `    \u2717 ${INCORRECT_INLINE_PROSE_AND_TOOL_SLUG_EXAMPLE}`,
   `    \u2717 ${INCORRECT_INLINE_HEADER_AND_PAYLOAD_EXAMPLE}`
 ];
+var CONTINUE_TOOL_CALL_RESPONSE_EXAMPLE = [
+  "I need to inspect the file first.",
+  SINGLE_TOOL_CALL_RUN_LINE_EXAMPLE
+].join("\n");
 function buildBashCommandsSection(options) {
   return buildBashCommandsSectionLines(options).join("\n");
 }
@@ -2770,6 +2783,13 @@ function stripInvocations(content, invocations) {
 
 // src/prompt-helpers.ts
 var DEFAULT_AGENT_FALLBACK_SYSTEM_PROMPT = "You are an AI agent.";
+var ERROR_RECOVERY_RULE_LINE = "**ERROR RECOVERY**: If a tool returns `success=false`, inspect the error, fix the cause, and retry.";
+var ROOT_CAUSES_RULE_LINE = "**ROOT CAUSES**: Fix root causes rather than suppressing symptoms.";
+var VALIDATE_AFTER_CHANGES_RULE_LINE = "**VALIDATE AFTER CHANGES**: Check syntax, imports, and obvious integration errors after editing.";
+var INCREMENTAL_TESTING_RULE_LINE = "**INCREMENTAL TESTING**: Write \u2192 test \u2192 fix before moving on. Verify deliverables actually work before finishing successfully.";
+var CODE_QUALITY_RULE_LINE = "**CODE QUALITY**: For TypeScript, prefer `tsc --noEmit` or the repo's build/test command after meaningful edits.";
+var SKILL_INVOKE_READ_RULE_LINE = "If the user says invoke /skill-name, treat that as asking you to read the skill-name skill with ReadSkill before proceeding.";
+var TODO_LIST_FIRST_RESPONSE_RULE_LINE = "You MUST call the manage_todo_list tool in your very first response to plan your work before executing any other tool. Break the task into specific, actionable steps. On subsequent responses, update the todo list to reflect progress.";
 function createAppendToolsSectionCustomizer(block) {
   return (sections) => {
     const trimmedBlock = block.trim();
@@ -2795,6 +2815,20 @@ function applySystemPromptCustomizers(sections, context, customizers) {
     ...customizer(current, context) ?? {}
   }), sections);
 }
+function buildValidationRecoveryRuleLines(options) {
+  const includeVerifiedCompletionRule = options?.includeVerifiedCompletionRule ?? false;
+  const reservedControlHeadersRule = options?.reservedControlHeadersRule ?? "Treat the structured control headers as reserved control syntax and use them only in the final executable segment.";
+  return [
+    "If the previous response was rejected for format, do not explain the response protocol back to the system.",
+    "Recover by choosing one concrete next action.",
+    reservedControlHeadersRule,
+    TOOL_CALL_SEPARATOR_RULE,
+    ...SLUG_FORMAT_EXAMPLE_RULE_LINES,
+    ...includeVerifiedCompletionRule ? [
+      "Do not claim success until your latest tool results or observed state show the task is complete."
+    ] : []
+  ];
+}
 function formatToolsSection(tools, options) {
   const commandPromptAvailability = options?.allowedRunTargets ? getRunCommandPromptAvailability(options.allowedRunTargets) : void 0;
   let desc = formatToolDefinitions(tools, "unix");
@@ -2808,6 +2842,181 @@ function formatToolsSection(tools, options) {
   }
   return desc;
 }
+function buildSkillsSection(allSkills) {
+  if (allSkills.length === 0) {
+    return "";
+  }
+  const skillSummaries = [...allSkills].sort(
+    (left, right) => left.metadata.name.localeCompare(right.metadata.name)
+  ).map((skill) => `  \u2022 **${skill.metadata.name}**: ${skill.metadata.description}`).join("\n");
+  return `
+
+# AVAILABLE SKILLS
+
+Specialized skills provide expert workflows and domain knowledge. Each skill contains detailed instructions, examples, and best practices.
+
+${skillSummaries}
+
+These skill summaries are loaded into context automatically at the start of the run. If a skill is relevant, call ReadSkill to load the full instructions before implementing that workflow.
+
+**Skills guidance**:
+1. Review the skills above before starting implementation-heavy work
+2. If a listed skill clearly matches the task, prefer reading that skill before planning or implementing a generic approach
+3. Prefer the most specific relevant skill over a broader fallback skill when multiple skills could apply
+4. ${SKILL_INVOKE_READ_RULE_LINE}
+5. Use ReadSkill for the specific skill whose workflow you want to follow in detail before making substantive changes
+6. If a skill you read instructs you to consult another foundational skill, follow that dependency before implementation
+7. Skills are instructions, not replacements for the registered tools
+
+---
+
+`;
+}
+function buildSkillAwareStaticContext(options) {
+  return [
+    buildSkillsSection(options.allSkills).trim(),
+    options.staticRules.trim()
+  ].filter((section) => section.length > 0).join("\n\n");
+}
+function formatRuleLines(ruleLines) {
+  return ruleLines.map((rule) => rule.trim()).filter((rule) => rule.length > 0).map((rule) => `- ${rule}`).join("\n");
+}
+var PORT_CONFLICT_RULE_LINE = "**PORT CONFLICTS**: If a server fails with `EADDRINUSE` and `FreePort` is available, use it before retrying.";
+function buildDefaultWorkspaceCodingSections(skillsDirectory) {
+  return [
+    {
+      id: "workspace-safety",
+      heading: "Workspace Safety",
+      ruleLines: [
+        "**RELATIVE PATHS**: Use workspace-relative paths for file operations unless a tool explicitly requires an absolute path.",
+        `**SKILLS DIRECTORY**: Skills live in \`${skillsDirectory}/\`.`,
+        `If a skill references \`scripts/file.py\`, use \`${skillsDirectory}/{skill-name}/scripts/file.py\`.`,
+        `If a skill references \`guide.md\`, inspect \`${skillsDirectory}/{skill-name}/guide.md\` with bash or another focused tool.`,
+        "**READ BEFORE WRITE**: Inspect an existing file and nearby related files before modifying it unless you are creating a clearly new file in an empty target location.",
+        "**CREATE PARENTS BEFORE CAT**: When creating a new file with shell redirection such as `cat > path/to/file <<'EOF'`, always run `mkdir -p path/to` first because `cat` and shell redirection do not create missing parent directories."
+      ]
+    },
+    {
+      id: "editing-strategy",
+      heading: "Editing Strategy",
+      ruleLines: [
+        "**SKILL-FIRST WORKFLOWS**: When the current task clearly matches an available skill, read that skill before making substantive edits, implementation plans, or design decisions.",
+        "**FILE CHANGES VIA BASH**: Use a final `---bash---` control segment for creating, editing, appending, renaming, and normalizing files. Prefer scoped edits over blind overwrites.",
+        "**TARGETED EDITS**: When modifying an existing file, always use narrow search-and-replace or patch-style edits that touch only the necessary lines. Preserve surrounding code, formatting, and structure.",
+        "**SEARCH/REPLACE REQUIRED**: For existing files, use in-place search-and-replace commands such as `sed` or another scoped patching approach. Do not rewrite an existing file wholesale to make a fix.",
+        "**NO EXISTING-FILE CAT REWRITES**: Never regenerate or overwrite an existing file with `cat > file <<'EOF'`. Reserve `cat > file <<'EOF'` for creating a new file that does not already exist.",
+        "**ERROR FIXES SHOULD BE LOCAL**: When a compiler, linter, or runtime error points to part of an existing file, patch that local region instead of rewriting the file.",
+        "**EXPLORE, PLAN, THEN IMPLEMENT**: For ambiguous, multi-file, or unfamiliar work: explore first, form a plan, then implement.",
+        "**KEEP SCRIPTS SHORT**: Keep one-off scripts around 100 lines or less. Split larger scripts into verified steps.",
+        `**CONTEXT GATHERING**: Use bash with ${WORKSPACE_CONTEXT_GATHERING_COMMAND_EXAMPLES} to discover structure, inspect related files, and understand patterns before changing code.`,
+        `**SHALLOW DISCOVERY**: ${SHALLOW_WORKSPACE_DISCOVERY_RULE_LINE}`,
+        "**BASH SAFETY**: Avoid destructive broad-scope commands. Keep file operations tightly scoped."
+      ]
+    },
+    {
+      id: "verification",
+      heading: "Verification",
+      ruleLines: [
+        ERROR_RECOVERY_RULE_LINE,
+        ROOT_CAUSES_RULE_LINE,
+        VALIDATE_AFTER_CHANGES_RULE_LINE,
+        INCREMENTAL_TESTING_RULE_LINE,
+        CODE_QUALITY_RULE_LINE
+      ]
+    },
+    {
+      id: "efficiency",
+      heading: "Efficiency",
+      ruleLines: [
+        `**EFFICIENT FILE SEARCH**: Use bash with ${WORKSPACE_CONTEXT_GATHERING_COMMAND_EXAMPLES} to locate files and inspect focused ranges instead of repeatedly dumping whole files.`,
+        "**OUTPUT SIZE & TRUNCATION**: Keep each control-segment payload reasonably small. For large file generation, prefer a complete validated file or a sequence of coherent patch-sized edits. Use incremental append steps only when tooling or truncation constraints make that necessary.",
+        "**MINIMIZE FILE CHURN**: Avoid rewriting entire existing files when a scoped replacement will do. Smaller in-place edits reduce regressions, token waste, and repeated repair loops.",
+        "**PREFER SED-SHAPED FIXES**: When using bash to repair existing files, use `sed`-style or other search-and-replace edits instead of `cat`-based full-file regeneration.",
+        "**EFFICIENCY**: Prefer one well-composed control-segment action per response instead of fragmented follow-up steps when a single bash command or tool invocation will do. Do not re-read files already in context without a reason.",
+        PORT_CONFLICT_RULE_LINE
+      ]
+    }
+  ];
+}
+function applyWorkspaceCodingSectionOverrides(baseSections, additionalRuleSections) {
+  const resolvedSections = baseSections.map((section) => ({
+    ...section,
+    ruleLines: [...section.ruleLines]
+  }));
+  for (const override of additionalRuleSections) {
+    const trimmedRuleLines = (override.ruleLines ?? []).map((rule) => rule.trim()).filter((rule) => rule.length > 0);
+    const omittedRuleLines = new Set(
+      (override.omitRuleLines ?? []).map((rule) => rule.trim()).filter((rule) => rule.length > 0)
+    );
+    if (override.section) {
+      const targetSection = resolvedSections.find((section) => section.id === override.section);
+      if (!targetSection) {
+        continue;
+      }
+      if (omittedRuleLines.size > 0) {
+        targetSection.ruleLines = targetSection.ruleLines.filter(
+          (rule) => !omittedRuleLines.has(rule)
+        );
+      }
+      targetSection.ruleLines.push(...trimmedRuleLines);
+      continue;
+    }
+    const heading = override.heading?.trim() ?? "";
+    if (!heading || trimmedRuleLines.length === 0) {
+      continue;
+    }
+    resolvedSections.push({
+      id: `custom:${heading}`,
+      heading,
+      ruleLines: trimmedRuleLines
+    });
+  }
+  return resolvedSections;
+}
+function buildWorkspaceCodingStaticRules(options) {
+  const skillsDirectory = options?.skillsDirectory ?? ".claude/skills";
+  const rulesHeading = options?.rulesHeading ?? "WORKSPACE CODING AGENT RULES";
+  const additionalRuleSections = options?.additionalRuleSections ?? [];
+  const normalizedSections = applyWorkspaceCodingSectionOverrides(
+    buildDefaultWorkspaceCodingSections(skillsDirectory),
+    additionalRuleSections
+  ).map((section) => {
+    if (section.ruleLines.length === 0) {
+      return "";
+    }
+    return `## ${section.heading}
+
+${formatRuleLines(section.ruleLines)}`;
+  }).filter((section) => section.length > 0).join("\n\n");
+  const codingAgentRules = `
+
+# ${rulesHeading}
+
+${normalizedSections}`;
+  return buildCoreStaticRules() + codingAgentRules;
+}
+function buildAgentIdentityLine(options) {
+  const {
+    identity,
+    agentName,
+    roleDescription
+  } = options;
+  const identityLine = identity ?? (agentName && roleDescription ? `You are ${agentName}, a ${roleDescription} agent.` : null);
+  if (!identityLine) {
+    throw new Error("buildAgentIdentityLine requires either identity or both agentName and roleDescription");
+  }
+  return identityLine;
+}
+function buildWebRuntimeRules(options) {
+  const additionalRules = options?.additionalRules ?? [];
+  return [
+    ...buildValidationRecoveryRuleLines({
+      includeVerifiedCompletionRule: options?.includeVerifiedCompletionRule ?? false,
+      reservedControlHeadersRule: "Treat the structured control headers as reserved control syntax. Use them only in the final executable segment, never inside analysis or summaries."
+    }),
+    ...additionalRules
+  ].join("\n");
+}
 function buildAgentSystemPrompt(options) {
   const commandPromptAvailability = options.allowedRunTargets ? getRunCommandPromptAvailability(options.allowedRunTargets) : void 0;
   const toolsSectionOptions = {
@@ -7211,6 +7420,6 @@ async function executeToolLoopStep(options) {
   };
 }
 
-export { AGENT_MACHINE_STATES, AgentLoop, AgentMemoryLayer, ApiError, BackgroundBashRunCommand, BaseMemoryLayer, BaseValidationEnforcer, BashRunCommand, 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_TRUNCATED_RESPONSE, LLMClient, MAX_TOOL_RESULT_CHARS, PendingAgentMessageBuffer, ProxyTool, RunCommand, RunCommandRegistry, SUPPORTED_RUN_TARGETS, StreamingToolParser, Tool, ToolLoopAgentRuntime, ToolRegistry, ToolRunCommand, WebToolLoopAgentRuntime, WebValidationEnforcer, agentMachine, applyIdleWebAgentState, applyInitialWebAgentRunState, buildAgentSystemPrompt, buildCompactionEntry, buildCoreStaticRules, buildNoStructuredResponseFoundError, buildParseFeedback, buildStepUserMessage, buildToolLogRevealFrames, buildToolUsageExample, buildValidationErrorMessage, 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, CONTINUE_TOOL_CALL_RESPONSE_EXAMPLE, 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, MAX_TOOL_RESULT_CHARS, PORT_CONFLICT_RULE_LINE, PendingAgentMessageBuffer, ProxyTool, ROOT_CAUSES_RULE_LINE, RunCommand, RunCommandRegistry, SHARED_TOOL_CALL_EXAMPLE_LINES, SINGLE_TOOL_CALL_RUN_LINE_EXAMPLE, STANDARD_TOOL_CALL_FORMAT_RULES, SUPPORTED_RUN_TARGETS, StreamingToolParser, TODO_LIST_FIRST_RESPONSE_RULE_LINE, TOOL_CALL_SEPARATOR_RULE, Tool, ToolLoopAgentRuntime, ToolRegistry, ToolRunCommand, VALIDATE_AFTER_CHANGES_RULE_LINE, WebToolLoopAgentRuntime, WebValidationEnforcer, agentMachine, applyIdleWebAgentState, applyInitialWebAgentRunState, buildAgentIdentityLine, buildAgentSystemPrompt, buildCompactionEntry, buildCoreStaticRules, buildNoStructuredResponseFoundError, buildParseFeedback, buildSkillAwareStaticContext, 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 };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map