build-tool-factory

What problem does it solve?

Adding a new capability to Claude Code requires repeating many safety-focused defaults, eager schema construction at import time, and boilerplate for permissions and metadata. The buildTool factory centralizes those defaults, enforces lazy schema initialization, and makes a tool's true behavior easy to read and review.

Core Features & Use Cases

• Safe defaults: fills in isConcurrencySafe, isReadOnly, isDestructive, checkPermissions, isEnabled, and userFacingName so authors only implement meaningful overrides.
• Lazy schemas: uses lazySchema getters to avoid expensive schema construction at module load, improving startup performance.
• Permission and metadata hooks: encourages implementing checkPermissions, strict input validation, and registration with tools.ts for production readiness.
• Use Case: convert an ad-hoc utility function into a production tool with input validation, permission checks, and concise call logic.

Quick Start

Create a new tool by calling buildTool with a lazy inputSchema, implement call and checkPermissions only as needed, and register the tool in src/tools.ts.