feat(tool): add toClaudeAgentSdk() method to Tools class

Add toClaudeAgentSdk() method that converts all tools in a collection
to Claude Agent SDK format, automatically creating an MCP server.

This simplifies integration with Claude Agent SDK from requiring
manual Zod schema definitions and MCP server setup to a single method
call. The method:

- Converts JSON Schema parameters to Zod schemas dynamically
- Creates Claude Agent SDK tool definitions with handlers
- Wraps tools in an MCP server via createSdkMcpServer()
- Supports configurable server name and version

Also adds toClaudeAgentSdkTool() helper method on BaseTool for
converting individual tools.

Author: ryoppippi

src/tool.ts

@@ -10,6 +10,8 @@ import { RequestBuilder } from './requestBuilder';
 import type {
 	AISDKToolDefinition,
 	AISDKToolResult,
+	ClaudeAgentSdkMcpServer,
+	ClaudeAgentSdkOptions,
 	ExecuteConfig,
 	ExecuteOptions,
 	HttpExecuteConfig,
@@ -22,6 +24,7 @@ import type {
 } from './types';
 
 import { StackOneError } from './utils/error-stackone';
+import { jsonSchemaToZod } from './utils/json-schema-to-zod';
 import { TfidfIndex } from './utils/tfidf-index';
 import { tryImport } from './utils/try-import';
 
@@ -225,6 +228,36 @@ export class BaseTool {
 		};
 	}
 
+	/**
+	 * Convert the tool to Claude Agent SDK format.
+	 * Returns a tool definition compatible with the Claude Agent SDK's tool() function.
+	 *
+	 * @see https://docs.anthropic.com/en/docs/agents-and-tools/claude-agent-sdk
+	 */
+	async toClaudeAgentSdkTool(): Promise<{
+		name: string;
+		description: string;
+		inputSchema: Record<string, unknown>;
+		handler: (
+			args: Record<string, unknown>,
+		) => Promise<{ content: Array<{ type: 'text'; text: string }> }>;
+	}> {
+		const { zodSchema } = await jsonSchemaToZod(this.toJsonSchema());
+		const execute = this.execute.bind(this);
+
+		return {
+			name: this.name,
+			description: this.description,
+			inputSchema: zodSchema,
+			handler: async (args: Record<string, unknown>) => {
+				const result = await execute(args as JsonObject);
+				return {
+					content: [{ type: 'text' as const, text: JSON.stringify(result) }],
+				};
+			},
+		};
+	}
+
 	/**
 	 * Convert the tool to AI SDK format
 	 */
@@ -395,6 +428,63 @@ export class Tools implements Iterable<BaseTool> {
 		return result;
 	}
 
+	/**
+	 * Convert all tools to Claude Agent SDK format.
+	 * Returns an MCP server configuration that can be passed to the
+	 * Claude Agent SDK query() function's mcpServers option.
+	 *
+	 * @example
+	 * ```typescript
+	 * const tools = await toolset.fetchTools();
+	 * const mcpServer = await tools.toClaudeAgentSdk();
+	 *
+	 * const result = query({
+	 *   prompt: 'Get employee info',
+	 *   options: {
+	 *     model: 'claude-sonnet-4-5-20250929',
+	 *     mcpServers: {
+	 *       'stackone-tools': mcpServer,
+	 *     },
+	 *   },
+	 * });
+	 * ```
+	 *
+	 * @see https://docs.anthropic.com/en/docs/agents-and-tools/claude-agent-sdk
+	 */
+	async toClaudeAgentSdk(options: ClaudeAgentSdkOptions = {}): Promise<ClaudeAgentSdkMcpServer> {
+		const { serverName = 'stackone-tools', serverVersion = '1.0.0' } = options;
+
+		// Import the Claude Agent SDK dynamically
+		const claudeAgentSdk = await tryImport<typeof import('@anthropic-ai/claude-agent-sdk')>(
+			'@anthropic-ai/claude-agent-sdk',
+			`npm install @anthropic-ai/claude-agent-sdk (requires ${peerDependencies['@anthropic-ai/claude-agent-sdk']})`,
+		);
+
+		// Convert all tools to Claude Agent SDK format
+		// We use type assertions here because the Zod types from our dynamic import
+		// don't perfectly match the Claude Agent SDK's expected types at compile time
+		const sdkTools = await Promise.all(
+			this.tools.map(async (baseTool) => {
+				const toolDef = await baseTool.toClaudeAgentSdkTool();
+				// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Dynamic Zod schema types
+				return claudeAgentSdk.tool(
+					toolDef.name,
+					toolDef.description,
+					toolDef.inputSchema as any,
+					toolDef.handler as any,
+				);
+			}),
+		);
+
+		// Create and return the MCP server
+		// The return type is compatible with McpServerConfig but uses our interface
+		return claudeAgentSdk.createSdkMcpServer({
+			name: serverName,
+			version: serverVersion,
+			tools: sdkTools,
+		}) as ClaudeAgentSdkMcpServer;
+	}
+
 	/**
 	 * Filter tools by a predicate function
 	 */