@chucky.cloud/sdk 0.1.0

package/dist/tools/McpServer.d.ts

@@ -0,0 +1,117 @@
+/**
+ * MCP Server Builder
+ *
+ * Builder pattern for creating MCP server definitions with multiple tools.
+ */
+import type { ToolDefinition, McpServerDefinition } from '../types/tools.js';
+import type { CreateToolOptions } from './tool.js';
+/**
+ * MCP Server builder for creating server definitions
+ *
+ * @example
+ * ```typescript
+ * const myServer = new McpServerBuilder('my-tools', '1.0.0')
+ *   .addTool({
+ *     name: 'greet',
+ *     description: 'Greet someone',
+ *     inputSchema: {
+ *       type: 'object',
+ *       properties: { name: { type: 'string' } },
+ *       required: ['name'],
+ *     },
+ *     handler: async ({ name }) => ({
+ *       content: [{ type: 'text', text: `Hello, ${name}!` }],
+ *     }),
+ *   })
+ *   .addTool({
+ *     name: 'farewell',
+ *     description: 'Say goodbye',
+ *     inputSchema: {
+ *       type: 'object',
+ *       properties: { name: { type: 'string' } },
+ *       required: ['name'],
+ *     },
+ *     handler: async ({ name }) => ({
+ *       content: [{ type: 'text', text: `Goodbye, ${name}!` }],
+ *     }),
+ *   })
+ *   .build();
+ * ```
+ */
+export declare class McpServerBuilder {
+    private name;
+    private version;
+    private tools;
+    /**
+     * Create a new MCP server builder
+     *
+     * @param name - Server name
+     * @param version - Server version (default: '1.0.0')
+     */
+    constructor(name: string, version?: string);
+    /**
+     * Add a tool to the server
+     *
+     * @param options - Tool configuration
+     * @returns This builder for chaining
+     */
+    addTool<TInput = Record<string, unknown>>(options: CreateToolOptions<TInput>): this;
+    /**
+     * Add an existing tool definition
+     *
+     * @param tool - Tool definition
+     * @returns This builder for chaining
+     */
+    add(tool: ToolDefinition): this;
+    /**
+     * Add multiple tools at once
+     *
+     * @param tools - Array of tool definitions
+     * @returns This builder for chaining
+     */
+    addTools(tools: ToolDefinition[]): this;
+    /**
+     * Build the MCP server definition
+     *
+     * @returns Complete MCP server definition
+     */
+    build(): McpServerDefinition;
+}
+/**
+ * Create an MCP server definition
+ *
+ * @param name - Server name
+ * @param tools - Array of tool definitions
+ * @param version - Server version
+ * @returns MCP server definition
+ *
+ * @example
+ * ```typescript
+ * const server = createMcpServer('my-server', [
+ *   tool('greet', 'Greet someone', { type: 'object', properties: { name: { type: 'string' } } }),
+ *   tool('farewell', 'Say goodbye', { type: 'object', properties: { name: { type: 'string' } } }),
+ * ]);
+ * ```
+ */
+export declare function createMcpServer(name: string, tools: ToolDefinition[], version?: string): McpServerDefinition;
+/**
+ * Create an MCP server using the builder pattern
+ *
+ * @param name - Server name
+ * @param version - Server version
+ * @returns MCP server builder
+ *
+ * @example
+ * ```typescript
+ * const server = mcpServer('my-tools')
+ *   .addTool({
+ *     name: 'hello',
+ *     description: 'Say hello',
+ *     inputSchema: { type: 'object', properties: {} },
+ *     handler: async () => ({ content: [{ type: 'text', text: 'Hello!' }] }),
+ *   })
+ *   .build();
+ * ```
+ */
+export declare function mcpServer(name: string, version?: string): McpServerBuilder;
+//# sourceMappingURL=McpServer.d.ts.map

package/dist/tools/McpServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpServer.d.ts","sourceRoot":"","sources":["../../src/tools/McpServer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAGnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAAwB;IAErC;;;;;OAKG;gBACS,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,MAAgB;IAKnD;;;;;OAKG;IACH,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,OAAO,EAAE,iBAAiB,CAAC,MAAM,CAAC,GACjC,IAAI;IAKP;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAK/B;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,IAAI;IAKvC;;;;OAIG;IACH,KAAK,IAAI,mBAAmB;CAO7B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,cAAc,EAAE,EACvB,OAAO,GAAE,MAAgB,GACxB,mBAAmB,CAMrB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAE1E"}

package/dist/tools/McpServer.js

@@ -0,0 +1,142 @@
+/**
+ * MCP Server Builder
+ *
+ * Builder pattern for creating MCP server definitions with multiple tools.
+ */
+import { createTool } from './tool.js';
+/**
+ * MCP Server builder for creating server definitions
+ *
+ * @example
+ * ```typescript
+ * const myServer = new McpServerBuilder('my-tools', '1.0.0')
+ *   .addTool({
+ *     name: 'greet',
+ *     description: 'Greet someone',
+ *     inputSchema: {
+ *       type: 'object',
+ *       properties: { name: { type: 'string' } },
+ *       required: ['name'],
+ *     },
+ *     handler: async ({ name }) => ({
+ *       content: [{ type: 'text', text: `Hello, ${name}!` }],
+ *     }),
+ *   })
+ *   .addTool({
+ *     name: 'farewell',
+ *     description: 'Say goodbye',
+ *     inputSchema: {
+ *       type: 'object',
+ *       properties: { name: { type: 'string' } },
+ *       required: ['name'],
+ *     },
+ *     handler: async ({ name }) => ({
+ *       content: [{ type: 'text', text: `Goodbye, ${name}!` }],
+ *     }),
+ *   })
+ *   .build();
+ * ```
+ */
+export class McpServerBuilder {
+    name;
+    version;
+    tools = [];
+    /**
+     * Create a new MCP server builder
+     *
+     * @param name - Server name
+     * @param version - Server version (default: '1.0.0')
+     */
+    constructor(name, version = '1.0.0') {
+        this.name = name;
+        this.version = version;
+    }
+    /**
+     * Add a tool to the server
+     *
+     * @param options - Tool configuration
+     * @returns This builder for chaining
+     */
+    addTool(options) {
+        this.tools.push(createTool(options));
+        return this;
+    }
+    /**
+     * Add an existing tool definition
+     *
+     * @param tool - Tool definition
+     * @returns This builder for chaining
+     */
+    add(tool) {
+        this.tools.push(tool);
+        return this;
+    }
+    /**
+     * Add multiple tools at once
+     *
+     * @param tools - Array of tool definitions
+     * @returns This builder for chaining
+     */
+    addTools(tools) {
+        this.tools.push(...tools);
+        return this;
+    }
+    /**
+     * Build the MCP server definition
+     *
+     * @returns Complete MCP server definition
+     */
+    build() {
+        return {
+            name: this.name,
+            version: this.version,
+            tools: this.tools,
+        };
+    }
+}
+/**
+ * Create an MCP server definition
+ *
+ * @param name - Server name
+ * @param tools - Array of tool definitions
+ * @param version - Server version
+ * @returns MCP server definition
+ *
+ * @example
+ * ```typescript
+ * const server = createMcpServer('my-server', [
+ *   tool('greet', 'Greet someone', { type: 'object', properties: { name: { type: 'string' } } }),
+ *   tool('farewell', 'Say goodbye', { type: 'object', properties: { name: { type: 'string' } } }),
+ * ]);
+ * ```
+ */
+export function createMcpServer(name, tools, version = '1.0.0') {
+    return {
+        name,
+        version,
+        tools,
+    };
+}
+/**
+ * Create an MCP server using the builder pattern
+ *
+ * @param name - Server name
+ * @param version - Server version
+ * @returns MCP server builder
+ *
+ * @example
+ * ```typescript
+ * const server = mcpServer('my-tools')
+ *   .addTool({
+ *     name: 'hello',
+ *     description: 'Say hello',
+ *     inputSchema: { type: 'object', properties: {} },
+ *     handler: async () => ({ content: [{ type: 'text', text: 'Hello!' }] }),
+ *   })
+ *   .build();
+ * ```
+ */
+export function mcpServer(name, version) {
+    return new McpServerBuilder(name, version);
+}
+//# sourceMappingURL=McpServer.js.map

package/dist/tools/McpServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpServer.js","sourceRoot":"","sources":["../../src/tools/McpServer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,OAAO,gBAAgB;IACnB,IAAI,CAAS;IACb,OAAO,CAAS;IAChB,KAAK,GAAqB,EAAE,CAAC;IAErC;;;;;OAKG;IACH,YAAY,IAAY,EAAE,UAAkB,OAAO;QACjD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;;;;OAKG;IACH,OAAO,CACL,OAAkC;QAElC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAmB,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,IAAoB;QACtB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,KAAuB;QAC9B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,KAAK;QACH,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC;IACJ,CAAC;CACF;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAY,EACZ,KAAuB,EACvB,UAAkB,OAAO;IAEzB,OAAO;QACL,IAAI;QACJ,OAAO;QACP,KAAK;KACN,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,OAAgB;IACtD,OAAO,IAAI,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC7C,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Tools Index
+ *
+ * Re-exports all tool helpers and builders.
+ */
+export { createTool, tool, browserTool, serverTool, textResult, errorResult, imageResult, } from './tool.js';
+export type { CreateToolOptions } from './tool.js';
+export { McpServerBuilder, createMcpServer, mcpServer } from './McpServer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,UAAU,EACV,IAAI,EACJ,WAAW,EACX,UAAU,EACV,UAAU,EACV,WAAW,EACX,WAAW,GACZ,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEnD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,8 @@
+/**
+ * Tools Index
+ *
+ * Re-exports all tool helpers and builders.
+ */
+export { createTool, tool, browserTool, serverTool, textResult, errorResult, imageResult, } from './tool.js';
+export { McpServerBuilder, createMcpServer, mcpServer } from './McpServer.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,UAAU,EACV,IAAI,EACJ,WAAW,EACX,UAAU,EACV,UAAU,EACV,WAAW,EACX,WAAW,GACZ,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/tools/tool.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Tool Helper
+ *
+ * Helper functions for defining tools with type safety.
+ * Supports both JSON Schema and Zod for input validation.
+ */
+import type { ToolDefinition, ToolInputSchema, ToolHandler, ToolResult, ToolExecutionLocation } from '../types/tools.js';
+/**
+ * Options for creating a tool
+ */
+export interface CreateToolOptions<TInput = Record<string, unknown>> {
+    /** Tool name (must be unique) */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** Input schema (JSON Schema or Zod schema) */
+    inputSchema: ToolInputSchema | ZodLikeSchema;
+    /** Where to execute the tool */
+    executeIn?: ToolExecutionLocation;
+    /** Handler function */
+    handler?: ToolHandler<TInput>;
+}
+/**
+ * Zod-like schema interface for compatibility
+ */
+interface ZodLikeSchema {
+    _def?: unknown;
+    shape?: unknown;
+    safeParse?: (data: unknown) => {
+        success: boolean;
+        data?: unknown;
+        error?: unknown;
+    };
+}
+/**
+ * Create a tool definition
+ *
+ * @param options - Tool configuration
+ * @returns Tool definition ready to use
+ *
+ * @example
+ * ```typescript
+ * // With JSON Schema
+ * const weatherTool = createTool({
+ *   name: 'get_weather',
+ *   description: 'Get current weather for a city',
+ *   inputSchema: {
+ *     type: 'object',
+ *     properties: {
+ *       city: { type: 'string', description: 'City name' },
+ *       unit: { type: 'string', enum: ['celsius', 'fahrenheit'] },
+ *     },
+ *     required: ['city'],
+ *   },
+ *   handler: async ({ city, unit }) => ({
+ *     content: [{ type: 'text', text: `Weather in ${city}: Sunny, 72°${unit === 'celsius' ? 'C' : 'F'}` }],
+ *   }),
+ * });
+ *
+ * // With Zod (optional peer dependency)
+ * import { z } from 'zod';
+ *
+ * const calculatorTool = createTool({
+ *   name: 'calculate',
+ *   description: 'Perform a calculation',
+ *   inputSchema: z.object({
+ *     expression: z.string().describe('Math expression to evaluate'),
+ *   }),
+ *   handler: async ({ expression }) => ({
+ *     content: [{ type: 'text', text: `Result: ${eval(expression)}` }],
+ *   }),
+ * });
+ * ```
+ */
+export declare function createTool<TInput = Record<string, unknown>>(options: CreateToolOptions<TInput>): ToolDefinition<TInput>;
+/**
+ * Shorthand for creating a tool
+ *
+ * @param name - Tool name
+ * @param description - Tool description
+ * @param inputSchema - Input schema
+ * @param handler - Handler function
+ * @returns Tool definition
+ *
+ * @example
+ * ```typescript
+ * const greetTool = tool(
+ *   'greet',
+ *   'Greet a person by name',
+ *   {
+ *     type: 'object',
+ *     properties: { name: { type: 'string' } },
+ *     required: ['name'],
+ *   },
+ *   async ({ name }) => ({
+ *     content: [{ type: 'text', text: `Hello, ${name}!` }],
+ *   })
+ * );
+ * ```
+ */
+export declare function tool<TInput = Record<string, unknown>>(name: string, description: string, inputSchema: ToolInputSchema | ZodLikeSchema, handler?: ToolHandler<TInput>): ToolDefinition<TInput>;
+/**
+ * Create a browser-executed tool
+ *
+ * @param options - Tool configuration
+ * @returns Tool definition that executes in the browser
+ *
+ * @example
+ * ```typescript
+ * const alertTool = browserTool({
+ *   name: 'show_alert',
+ *   description: 'Show an alert dialog',
+ *   inputSchema: {
+ *     type: 'object',
+ *     properties: { message: { type: 'string' } },
+ *     required: ['message'],
+ *   },
+ *   handler: async ({ message }) => {
+ *     alert(message);
+ *     return { content: [{ type: 'text', text: 'Alert shown' }] };
+ *   },
+ * });
+ * ```
+ */
+export declare function browserTool<TInput = Record<string, unknown>>(options: Omit<CreateToolOptions<TInput>, 'executeIn'>): ToolDefinition<TInput>;
+/**
+ * Create a server-executed tool
+ *
+ * @param options - Tool configuration (handler is optional for server tools)
+ * @returns Tool definition that executes on the server
+ */
+export declare function serverTool<TInput = Record<string, unknown>>(options: Omit<CreateToolOptions<TInput>, 'executeIn' | 'handler'>): ToolDefinition<TInput>;
+/**
+ * Helper to create text content for tool results
+ */
+export declare function textResult(text: string): ToolResult;
+/**
+ * Helper to create error result for tools
+ */
+export declare function errorResult(message: string): ToolResult;
+/**
+ * Helper to create image content for tool results
+ */
+export declare function imageResult(data: string, mimeType: string): ToolResult;
+export {};
+//# sourceMappingURL=tool.d.ts.map

package/dist/tools/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/tools/tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,WAAW,EACX,UAAU,EACV,qBAAqB,EAEtB,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACjE,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,WAAW,EAAE,eAAe,GAAG,aAAa,CAAC;IAC7C,gCAAgC;IAChC,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAClC,uBAAuB;IACvB,OAAO,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC/B;AAED;;GAEG;AACH,UAAU,aAAa;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CACtF;AA6GD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,UAAU,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzD,OAAO,EAAE,iBAAiB,CAAC,MAAM,CAAC,GACjC,cAAc,CAAC,MAAM,CAAC,CAgBxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnD,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,eAAe,GAAG,aAAa,EAC5C,OAAO,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GAC5B,cAAc,CAAC,MAAM,CAAC,CAExB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1D,OAAO,EAAE,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,GACpD,cAAc,CAAC,MAAM,CAAC,CAExB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzD,OAAO,EAAE,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC,GAChE,cAAc,CAAC,MAAM,CAAC,CAExB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAInD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAKvD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,CAItE"}

package/dist/tools/tool.js

@@ -0,0 +1,232 @@
+/**
+ * Tool Helper
+ *
+ * Helper functions for defining tools with type safety.
+ * Supports both JSON Schema and Zod for input validation.
+ */
+/**
+ * Check if a schema is a Zod schema
+ */
+function isZodSchema(schema) {
+    return (typeof schema === 'object' &&
+        schema !== null &&
+        ('_def' in schema || 'shape' in schema));
+}
+/**
+ * Convert Zod schema to JSON Schema (basic conversion)
+ */
+function zodToJsonSchema(zodSchema) {
+    // This is a simplified conversion - for full support, use zod-to-json-schema
+    const def = zodSchema._def;
+    if (!def) {
+        return {
+            type: 'object',
+            properties: {},
+        };
+    }
+    const typeName = def.typeName;
+    if (typeName === 'ZodObject') {
+        const shape = def.shape?.() || {};
+        const properties = {};
+        const required = [];
+        for (const [key, value] of Object.entries(shape)) {
+            const valueDef = value._def;
+            if (valueDef) {
+                const prop = zodDefToJsonSchema(valueDef);
+                if (prop) {
+                    properties[key] = prop;
+                    // Check if required (not optional)
+                    if (valueDef.typeName !== 'ZodOptional') {
+                        required.push(key);
+                    }
+                }
+            }
+        }
+        return {
+            type: 'object',
+            properties,
+            required: required.length > 0 ? required : undefined,
+        };
+    }
+    return {
+        type: 'object',
+        properties: {},
+    };
+}
+/**
+ * Convert a Zod definition to JSON Schema property
+ */
+function zodDefToJsonSchema(def) {
+    const typeName = def.typeName;
+    switch (typeName) {
+        case 'ZodString':
+            return { type: 'string', description: def.description };
+        case 'ZodNumber':
+            return { type: 'number', description: def.description };
+        case 'ZodBoolean':
+            return { type: 'boolean', description: def.description };
+        case 'ZodArray':
+            const innerDef = def.innerType?._def;
+            return {
+                type: 'array',
+                description: def.description,
+                items: innerDef ? zodDefToJsonSchema(innerDef) || { type: 'string' } : { type: 'string' },
+            };
+        case 'ZodEnum':
+            return {
+                type: 'string',
+                description: def.description,
+                enum: def.values,
+            };
+        case 'ZodOptional':
+            const innerOptDef = def.innerType?._def;
+            return innerOptDef ? zodDefToJsonSchema(innerOptDef) : null;
+        default:
+            return { type: 'string' };
+    }
+}
+/**
+ * Create a tool definition
+ *
+ * @param options - Tool configuration
+ * @returns Tool definition ready to use
+ *
+ * @example
+ * ```typescript
+ * // With JSON Schema
+ * const weatherTool = createTool({
+ *   name: 'get_weather',
+ *   description: 'Get current weather for a city',
+ *   inputSchema: {
+ *     type: 'object',
+ *     properties: {
+ *       city: { type: 'string', description: 'City name' },
+ *       unit: { type: 'string', enum: ['celsius', 'fahrenheit'] },
+ *     },
+ *     required: ['city'],
+ *   },
+ *   handler: async ({ city, unit }) => ({
+ *     content: [{ type: 'text', text: `Weather in ${city}: Sunny, 72°${unit === 'celsius' ? 'C' : 'F'}` }],
+ *   }),
+ * });
+ *
+ * // With Zod (optional peer dependency)
+ * import { z } from 'zod';
+ *
+ * const calculatorTool = createTool({
+ *   name: 'calculate',
+ *   description: 'Perform a calculation',
+ *   inputSchema: z.object({
+ *     expression: z.string().describe('Math expression to evaluate'),
+ *   }),
+ *   handler: async ({ expression }) => ({
+ *     content: [{ type: 'text', text: `Result: ${eval(expression)}` }],
+ *   }),
+ * });
+ * ```
+ */
+export function createTool(options) {
+    let inputSchema;
+    if (isZodSchema(options.inputSchema)) {
+        inputSchema = zodToJsonSchema(options.inputSchema);
+    }
+    else {
+        inputSchema = options.inputSchema;
+    }
+    return {
+        name: options.name,
+        description: options.description,
+        inputSchema,
+        executeIn: options.executeIn ?? 'server',
+        handler: options.handler,
+    };
+}
+/**
+ * Shorthand for creating a tool
+ *
+ * @param name - Tool name
+ * @param description - Tool description
+ * @param inputSchema - Input schema
+ * @param handler - Handler function
+ * @returns Tool definition
+ *
+ * @example
+ * ```typescript
+ * const greetTool = tool(
+ *   'greet',
+ *   'Greet a person by name',
+ *   {
+ *     type: 'object',
+ *     properties: { name: { type: 'string' } },
+ *     required: ['name'],
+ *   },
+ *   async ({ name }) => ({
+ *     content: [{ type: 'text', text: `Hello, ${name}!` }],
+ *   })
+ * );
+ * ```
+ */
+export function tool(name, description, inputSchema, handler) {
+    return createTool({ name, description, inputSchema, handler });
+}
+/**
+ * Create a browser-executed tool
+ *
+ * @param options - Tool configuration
+ * @returns Tool definition that executes in the browser
+ *
+ * @example
+ * ```typescript
+ * const alertTool = browserTool({
+ *   name: 'show_alert',
+ *   description: 'Show an alert dialog',
+ *   inputSchema: {
+ *     type: 'object',
+ *     properties: { message: { type: 'string' } },
+ *     required: ['message'],
+ *   },
+ *   handler: async ({ message }) => {
+ *     alert(message);
+ *     return { content: [{ type: 'text', text: 'Alert shown' }] };
+ *   },
+ * });
+ * ```
+ */
+export function browserTool(options) {
+    return createTool({ ...options, executeIn: 'browser' });
+}
+/**
+ * Create a server-executed tool
+ *
+ * @param options - Tool configuration (handler is optional for server tools)
+ * @returns Tool definition that executes on the server
+ */
+export function serverTool(options) {
+    return createTool({ ...options, executeIn: 'server' });
+}
+/**
+ * Helper to create text content for tool results
+ */
+export function textResult(text) {
+    return {
+        content: [{ type: 'text', text }],
+    };
+}
+/**
+ * Helper to create error result for tools
+ */
+export function errorResult(message) {
+    return {
+        content: [{ type: 'text', text: message }],
+        isError: true,
+    };
+}
+/**
+ * Helper to create image content for tool results
+ */
+export function imageResult(data, mimeType) {
+    return {
+        content: [{ type: 'image', data, mimeType }],
+    };
+}
+//# sourceMappingURL=tool.js.map

package/dist/tools/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/tools/tool.ts"],"names":[],"mappings":"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"}