Add explicit subpath exports for tools, resources, prompts, and utils

This PR provides an alternative to #110's wildcard export approach by
implementing explicit, well-documented subpath exports that give users
direct access to Mapbox MCP components.

## Changes

### Package Exports (via tshy)
- `@mapbox/mcp-server/tools` - Tool classes and pre-configured instances
- `@mapbox/mcp-server/resources` - Resource classes and instances
- `@mapbox/mcp-server/prompts` - Prompt classes and instances
- `@mapbox/mcp-server/utils` - HTTP pipeline utilities

All exports support both ESM and CommonJS via tshy dual builds.

### New Files
- `src/tools/index.ts` - Barrel export for tools with clean instance names
- `src/resources/index.ts` - Barrel export for resources
- `src/prompts/index.ts` - Barrel export for prompts
- `src/utils/index.ts` - Barrel export for HTTP utilities
- `docs/importing-tools.md` - Comprehensive usage guide
- `examples/import-example.ts` - Working code examples
- `test/exports.test.ts` - Test suite validating all exports
- `tsconfig.examples.json` - TypeScript config for examples

### Updated Files
- `package.json` - Added tshy exports config, updated lint/format scripts
- `tsconfig.json` - Added examples reference
- `README.md` - Added link to importing guide
- `CLAUDE.md` - Documented package exports

### Usage Examples

Simple - pre-configured instances:
```typescript
import { directions, searchAndGeocode } from '@mapbox/mcp-server/tools';
```

Advanced - custom tool instances:
```typescript
import { DirectionsTool } from '@mapbox/mcp-server/tools';
import { httpRequest } from '@mapbox/mcp-server/utils';
const tool = new DirectionsTool({ httpRequest });
```

Expert - custom HTTP pipeline:
```typescript
import { HttpPipeline, UserAgentPolicy } from '@mapbox/mcp-server/utils';
const pipeline = new HttpPipeline();
pipeline.usePolicy(new UserAgentPolicy('MyApp/1.0'));
```

## Benefits Over Wildcard Approach

1. **Explicit API surface** - Only exports intended public APIs
2. **Better discoverability** - Clear, documented entry points
3. **Type safety** - Full TypeScript support for all exports
4. **Tree-shaking friendly** - Bundlers can optimize better
5. **Future-proof** - Easy to evolve without breaking changes

## Testing

- All 611 existing tests pass
- New test suite validates all subpath exports
- Examples included in lint/format/type checking
- Documentation with working examples

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Author: mattpodwysocki

CLAUDE.md

@@ -94,3 +94,15 @@ npx plop create-tool "Search" "search_tool"
 - **Detailed Standards**: See docs/engineering_standards.md for complete guidelines
 - **Tracing Setup**: See docs/tracing.md for OpenTelemetry configuration
 - **Integration Guides**: See docs/ for Claude Desktop, VS Code, Cursor, and Goose setup
+- **Direct Imports**: See docs/importing-tools.md for using tools/resources/prompts in your own applications
+
+## Package Exports
+
+The package provides subpath exports for direct integration without running the MCP server:
+
+- `@mapbox/mcp-server/tools` - Tool classes and pre-configured instances
+- `@mapbox/mcp-server/resources` - Resource classes and instances
+- `@mapbox/mcp-server/prompts` - Prompt classes and instances
+- `@mapbox/mcp-server/utils` - HTTP pipeline utilities (httpRequest, HttpPipeline, policies)
+
+All exports support both ESM and CommonJS via tshy dual builds.

README.md

@@ -51,6 +51,7 @@ For detailed setup instructions for different integrations, refer to the followi
 - [VS Code Setup](./docs/vscode-setup.md) - Setting up a development environment in Visual Studio Code
 - [Cursor AI IDE Setup](./docs/cursor-setup.md) - Setting up a development environment in Cursor AI IDE
 - [Smolagents Integration](./docs/using-mcp-with-smolagents/README.md) - Example showing how to connect Smolagents AI agents to Mapbox's tools
+- **[Importing Tools Directly](./docs/importing-tools.md)** - Use Mapbox tools in your own applications without running the MCP server
 
 ## Example Prompts