@lantos1618/better-ui 0.7.1 → 0.9.0

package/dist/components/index.js

@@ -179,16 +179,24 @@ function ChatProvider({ endpoint = "/api/chat", tools, toolStateStore: externalS
   const [threads, setThreads] = (0, import_react2.useState)([]);
   const [activeThreadId, setActiveThreadId] = (0, import_react2.useState)(threadId);
   (0, import_react2.useEffect)(() => {
-    if (persistence) {
-      persistence.listThreads().then(setThreads).catch((err) => console.warn("[better-ui] persistence error:", err));
-    }
+    if (!persistence) return;
+    let cancelled = false;
+    persistence.listThreads().then((t) => {
+      if (!cancelled) setThreads(t);
+    }).catch((err) => console.warn("[better-ui] persistence error:", err));
+    return () => {
+      cancelled = true;
+    };
   }, [persistence]);
   (0, import_react2.useEffect)(() => {
-    if (persistence && activeThreadId) {
-      persistence.getMessages(activeThreadId).then((msgs) => {
-        setMessages(msgs);
-      }).catch((err) => console.warn("[better-ui] persistence error:", err));
-    }
+    if (!persistence || !activeThreadId) return;
+    let cancelled = false;
+    persistence.getMessages(activeThreadId).then((msgs) => {
+      if (!cancelled) setMessages(msgs);
+    }).catch((err) => console.warn("[better-ui] persistence error:", err));
+    return () => {
+      cancelled = true;
+    };
   }, [persistence, activeThreadId, setMessages]);
   const prevStatusRef = (0, import_react2.useRef)(status);
   (0, import_react2.useEffect)(() => {
@@ -212,9 +220,10 @@ function ChatProvider({ endpoint = "/api/chat", tools, toolStateStore: externalS
   }, [persistence, setMessages, toolStateStore]);
   const switchThreadFn = (0, import_react2.useCallback)(async (id) => {
     if (!persistence) throw new Error("Persistence not configured");
-    setActiveThreadId(id);
-    setMessages([]);
+    const msgs = await persistence.getMessages(id);
     toolStateStore.clear();
+    setMessages(msgs);
+    setActiveThreadId(id);
   }, [persistence, setMessages, toolStateStore]);
   const deleteThreadFn = (0, import_react2.useCallback)(async (id) => {
     if (!persistence) throw new Error("Persistence not configured");
@@ -237,8 +246,11 @@ function ChatProvider({ endpoint = "/api/chat", tools, toolStateStore: externalS
         stateContext[entry.toolName] = entry.output;
       }
     }
-    dirty.clear();
-    return Object.keys(stateContext).length > 0 ? stateContext : null;
+    if (Object.keys(stateContext).length > 0) {
+      dirty.clear();
+      return stateContext;
+    }
+    return null;
   }, [toolStateStore]);
   const executeToolDirect = (0, import_react2.useCallback)(async (toolName, toolInput, toolCallId) => {
     const currentVersion = (versionRef.current.get(toolCallId) || 0) + 1;
@@ -420,6 +432,33 @@ var import_ai2 = require("ai");
 // src/components/ToolResult.tsx
 var import_react4 = require("react");
 var import_jsx_runtime2 = require("react/jsx-runtime");
+var ToolViewErrorBoundary = class extends import_react4.Component {
+  constructor() {
+    super(...arguments);
+    this.state = { error: null };
+  }
+  static getDerivedStateFromError(error) {
+    return { error };
+  }
+  componentDidCatch(error, info) {
+    console.error(`[better-ui] View for tool "${this.props.toolName}" threw:`, error, info);
+  }
+  render() {
+    if (this.state.error) {
+      return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { className: "bg-[var(--bui-error-muted,rgba(220,38,38,0.08))] border border-[var(--bui-error-border,rgba(153,27,27,0.5))] rounded-xl p-4", children: [
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { className: "flex items-center gap-2", children: [
+          /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("svg", { className: "w-4 h-4 text-[var(--bui-error-fg,#f87171)] shrink-0", fill: "none", viewBox: "0 0 24 24", stroke: "currentColor", strokeWidth: 2, children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("path", { strokeLinecap: "round", strokeLinejoin: "round", d: "M12 9v3.75m9-.75a9 9 0 11-18 0 9 9 0 0118 0zm-9 3.75h.008v.008H12v-.008z" }) }),
+          /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("span", { className: "text-[var(--bui-error-fg,#f87171)] text-sm font-medium", children: [
+            this.props.toolName,
+            " view error"
+          ] })
+        ] }),
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("p", { className: "text-[var(--bui-error-fg,#f87171)]/70 text-xs mt-1", children: this.state.error.message })
+      ] });
+    }
+    return this.props.children;
+  }
+};
 function useIsFollowup(toolStateStore, toolCallId) {
   const subscribe = (0, import_react4.useCallback)(
     (listener) => toolStateStore.subscribeAll(listener),
@@ -602,7 +641,7 @@ function ToolResult({
       )
     ] });
   }
-  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("div", { className: className || "", children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("div", { className: className || "", children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(ToolViewErrorBoundary, { toolName, children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
     toolDef.View,
     {
       data: resolvedOutput,
@@ -610,7 +649,7 @@ function ToolResult({
       onAction: getOnAction(toolCallId, toolName),
       error: storeState?.error ? new Error(storeState.error) : null
     }
-  ) });
+  ) }) });
 }
 
 // src/components/Markdown.tsx

package/dist/components/index.mjs

@@ -121,16 +121,24 @@ function ChatProvider({ endpoint = "/api/chat", tools, toolStateStore: externalS
   const [threads, setThreads] = useState([]);
   const [activeThreadId, setActiveThreadId] = useState(threadId);
   useEffect(() => {
-    if (persistence) {
-      persistence.listThreads().then(setThreads).catch((err) => console.warn("[better-ui] persistence error:", err));
-    }
+    if (!persistence) return;
+    let cancelled = false;
+    persistence.listThreads().then((t) => {
+      if (!cancelled) setThreads(t);
+    }).catch((err) => console.warn("[better-ui] persistence error:", err));
+    return () => {
+      cancelled = true;
+    };
   }, [persistence]);
   useEffect(() => {
-    if (persistence && activeThreadId) {
-      persistence.getMessages(activeThreadId).then((msgs) => {
-        setMessages(msgs);
-      }).catch((err) => console.warn("[better-ui] persistence error:", err));
-    }
+    if (!persistence || !activeThreadId) return;
+    let cancelled = false;
+    persistence.getMessages(activeThreadId).then((msgs) => {
+      if (!cancelled) setMessages(msgs);
+    }).catch((err) => console.warn("[better-ui] persistence error:", err));
+    return () => {
+      cancelled = true;
+    };
   }, [persistence, activeThreadId, setMessages]);
   const prevStatusRef = useRef(status);
   useEffect(() => {
@@ -154,9 +162,10 @@ function ChatProvider({ endpoint = "/api/chat", tools, toolStateStore: externalS
   }, [persistence, setMessages, toolStateStore]);
   const switchThreadFn = useCallback2(async (id) => {
     if (!persistence) throw new Error("Persistence not configured");
-    setActiveThreadId(id);
-    setMessages([]);
+    const msgs = await persistence.getMessages(id);
     toolStateStore.clear();
+    setMessages(msgs);
+    setActiveThreadId(id);
   }, [persistence, setMessages, toolStateStore]);
   const deleteThreadFn = useCallback2(async (id) => {
     if (!persistence) throw new Error("Persistence not configured");
@@ -179,8 +188,11 @@ function ChatProvider({ endpoint = "/api/chat", tools, toolStateStore: externalS
         stateContext[entry.toolName] = entry.output;
       }
     }
-    dirty.clear();
-    return Object.keys(stateContext).length > 0 ? stateContext : null;
+    if (Object.keys(stateContext).length > 0) {
+      dirty.clear();
+      return stateContext;
+    }
+    return null;
   }, [toolStateStore]);
   const executeToolDirect = useCallback2(async (toolName, toolInput, toolCallId) => {
     const currentVersion = (versionRef.current.get(toolCallId) || 0) + 1;
@@ -364,8 +376,35 @@ import {
 } from "ai";
 
 // src/components/ToolResult.tsx
-import { useEffect as useEffect2, useRef as useRef2, useSyncExternalStore as useSyncExternalStore2, useCallback as useCallback3 } from "react";
+import { Component, useEffect as useEffect2, useRef as useRef2, useSyncExternalStore as useSyncExternalStore2, useCallback as useCallback3 } from "react";
 import { jsx as jsx2, jsxs } from "react/jsx-runtime";
+var ToolViewErrorBoundary = class extends Component {
+  constructor() {
+    super(...arguments);
+    this.state = { error: null };
+  }
+  static getDerivedStateFromError(error) {
+    return { error };
+  }
+  componentDidCatch(error, info) {
+    console.error(`[better-ui] View for tool "${this.props.toolName}" threw:`, error, info);
+  }
+  render() {
+    if (this.state.error) {
+      return /* @__PURE__ */ jsxs("div", { className: "bg-[var(--bui-error-muted,rgba(220,38,38,0.08))] border border-[var(--bui-error-border,rgba(153,27,27,0.5))] rounded-xl p-4", children: [
+        /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2", children: [
+          /* @__PURE__ */ jsx2("svg", { className: "w-4 h-4 text-[var(--bui-error-fg,#f87171)] shrink-0", fill: "none", viewBox: "0 0 24 24", stroke: "currentColor", strokeWidth: 2, children: /* @__PURE__ */ jsx2("path", { strokeLinecap: "round", strokeLinejoin: "round", d: "M12 9v3.75m9-.75a9 9 0 11-18 0 9 9 0 0118 0zm-9 3.75h.008v.008H12v-.008z" }) }),
+          /* @__PURE__ */ jsxs("span", { className: "text-[var(--bui-error-fg,#f87171)] text-sm font-medium", children: [
+            this.props.toolName,
+            " view error"
+          ] })
+        ] }),
+        /* @__PURE__ */ jsx2("p", { className: "text-[var(--bui-error-fg,#f87171)]/70 text-xs mt-1", children: this.state.error.message })
+      ] });
+    }
+    return this.props.children;
+  }
+};
 function useIsFollowup(toolStateStore, toolCallId) {
   const subscribe = useCallback3(
     (listener) => toolStateStore.subscribeAll(listener),
@@ -548,7 +587,7 @@ function ToolResult({
       )
     ] });
   }
-  return /* @__PURE__ */ jsx2("div", { className: className || "", children: /* @__PURE__ */ jsx2(
+  return /* @__PURE__ */ jsx2("div", { className: className || "", children: /* @__PURE__ */ jsx2(ToolViewErrorBoundary, { toolName, children: /* @__PURE__ */ jsx2(
     toolDef.View,
     {
       data: resolvedOutput,
@@ -556,7 +595,7 @@ function ToolResult({
       onAction: getOnAction(toolCallId, toolName),
       error: storeState?.error ? new Error(storeState.error) : null
     }
-  ) });
+  ) }) });
 }
 
 // src/components/Markdown.tsx

package/dist/mcp/index.d.mts

@@ -1,5 +1,6 @@
 import { T as Tool, g as ToolContext } from '../tool-yZTixiN2.mjs';
-import { z } from 'zod';
+export { z as zodToJsonSchema } from '../schema-DdZf6066.mjs';
+import 'zod';
 import 'react';
 
 /**
@@ -127,33 +128,4 @@ declare class MCPServer {
  */
 declare function createMCPServer(config: MCPServerConfig): MCPServer;
 
-/**
- * Lightweight Zod-to-JSON-Schema converter.
- * Handles common Zod types without requiring zod-to-json-schema dependency.
- */
-
-interface JsonSchema {
-    type?: string;
-    properties?: Record<string, JsonSchema>;
-    required?: string[];
-    items?: JsonSchema;
-    enum?: unknown[];
-    description?: string;
-    default?: unknown;
-    minimum?: number;
-    maximum?: number;
-    minLength?: number;
-    maxLength?: number;
-    pattern?: string;
-    format?: string;
-    anyOf?: JsonSchema[];
-    oneOf?: JsonSchema[];
-    nullable?: boolean;
-    additionalProperties?: boolean | JsonSchema;
-    [key: string]: unknown;
-}
-declare function zodToJsonSchema(schema: z.ZodType | {
-    [key: string]: any;
-}): JsonSchema;
-
-export { MCPServer, type MCPServerConfig, createMCPServer, zodToJsonSchema };
+export { MCPServer, type MCPServerConfig, createMCPServer };

package/dist/mcp/index.d.ts

@@ -1,5 +1,6 @@
 import { T as Tool, g as ToolContext } from '../tool-yZTixiN2.js';
-import { z } from 'zod';
+export { z as zodToJsonSchema } from '../schema-DdZf6066.js';
+import 'zod';
 import 'react';
 
 /**
@@ -127,33 +128,4 @@ declare class MCPServer {
  */
 declare function createMCPServer(config: MCPServerConfig): MCPServer;
 
-/**
- * Lightweight Zod-to-JSON-Schema converter.
- * Handles common Zod types without requiring zod-to-json-schema dependency.
- */
-
-interface JsonSchema {
-    type?: string;
-    properties?: Record<string, JsonSchema>;
-    required?: string[];
-    items?: JsonSchema;
-    enum?: unknown[];
-    description?: string;
-    default?: unknown;
-    minimum?: number;
-    maximum?: number;
-    minLength?: number;
-    maxLength?: number;
-    pattern?: string;
-    format?: string;
-    anyOf?: JsonSchema[];
-    oneOf?: JsonSchema[];
-    nullable?: boolean;
-    additionalProperties?: boolean | JsonSchema;
-    [key: string]: unknown;
-}
-declare function zodToJsonSchema(schema: z.ZodType | {
-    [key: string]: any;
-}): JsonSchema;
-
-export { MCPServer, type MCPServerConfig, createMCPServer, zodToJsonSchema };
+export { MCPServer, type MCPServerConfig, createMCPServer };

package/dist/mcp/index.js

@@ -296,7 +296,7 @@ var MCPServer = class {
       jsonrpc: "2.0",
       id: message.id,
       result: {
-        protocolVersion: "2024-11-05",
+        protocolVersion: "2025-11-25",
         capabilities: {
           tools: {}
         },

package/dist/mcp/index.mjs

@@ -133,7 +133,7 @@ var MCPServer = class {
       jsonrpc: "2.0",
       id: message.id,
       result: {
-        protocolVersion: "2024-11-05",
+        protocolVersion: "2025-11-25",
         capabilities: {
           tools: {}
         },

package/dist/openapi/index.d.mts

@@ -0,0 +1,113 @@
+import { T as Tool } from '../tool-yZTixiN2.mjs';
+import { J as JsonSchema } from '../schema-DdZf6066.mjs';
+import 'zod';
+import 'react';
+
+/**
+ * OpenAPI 3.1 spec generator for Better UI tools.
+ *
+ * Converts a tool registry into a valid OpenAPI document.
+ * Each tool becomes a POST endpoint at `/api/tools/{toolName}`.
+ *
+ * @example
+ * ```typescript
+ * import { generateOpenAPISpec } from '@lantos1618/better-ui/openapi';
+ * import { tools } from './tools';
+ *
+ * const spec = generateOpenAPISpec({
+ *   title: 'My AI Tools API',
+ *   version: '1.0.0',
+ *   tools,
+ * });
+ *
+ * // Serve as JSON
+ * app.get('/openapi.json', (req, res) => res.json(spec));
+ * ```
+ */
+
+interface OpenAPISpecConfig {
+    /** API title */
+    title: string;
+    /** API version */
+    version: string;
+    /** Tool registry */
+    tools: Record<string, Tool>;
+    /** API description */
+    description?: string;
+    /** Base URL for servers (default: '/') */
+    serverUrl?: string;
+    /** Base path prefix for tool endpoints (default: '/api/tools') */
+    basePath?: string;
+    /** Tags to group endpoints */
+    tags?: Array<{
+        name: string;
+        description?: string;
+    }>;
+}
+interface OpenAPISpec {
+    openapi: '3.1.0';
+    info: {
+        title: string;
+        version: string;
+        description?: string;
+    };
+    servers: Array<{
+        url: string;
+    }>;
+    paths: Record<string, PathItem>;
+    components: {
+        schemas: Record<string, JsonSchema>;
+    };
+    tags?: Array<{
+        name: string;
+        description?: string;
+    }>;
+}
+interface PathItem {
+    post: {
+        operationId: string;
+        summary: string;
+        description?: string;
+        tags?: string[];
+        requestBody: {
+            required: true;
+            content: {
+                'application/json': {
+                    schema: {
+                        $ref: string;
+                    };
+                };
+            };
+        };
+        responses: Record<string, {
+            description: string;
+            content?: {
+                'application/json': {
+                    schema: {
+                        $ref: string;
+                    } | JsonSchema;
+                };
+            };
+        }>;
+    };
+}
+/**
+ * Generate an OpenAPI 3.1 spec from a Better UI tool registry.
+ */
+declare function generateOpenAPISpec(config: OpenAPISpecConfig): OpenAPISpec;
+/**
+ * Create a request handler that serves the OpenAPI spec as JSON.
+ *
+ * @example
+ * ```typescript
+ * // Next.js route: app/api/openapi/route.ts
+ * export const GET = openAPIHandler({
+ *   title: 'My Tools',
+ *   version: '1.0.0',
+ *   tools,
+ * });
+ * ```
+ */
+declare function openAPIHandler(config: OpenAPISpecConfig): (req: Request) => Response;
+
+export { type OpenAPISpec, type OpenAPISpecConfig, generateOpenAPISpec, openAPIHandler };

package/dist/openapi/index.d.ts

@@ -0,0 +1,113 @@
+import { T as Tool } from '../tool-yZTixiN2.js';
+import { J as JsonSchema } from '../schema-DdZf6066.js';
+import 'zod';
+import 'react';
+
+/**
+ * OpenAPI 3.1 spec generator for Better UI tools.
+ *
+ * Converts a tool registry into a valid OpenAPI document.
+ * Each tool becomes a POST endpoint at `/api/tools/{toolName}`.
+ *
+ * @example
+ * ```typescript
+ * import { generateOpenAPISpec } from '@lantos1618/better-ui/openapi';
+ * import { tools } from './tools';
+ *
+ * const spec = generateOpenAPISpec({
+ *   title: 'My AI Tools API',
+ *   version: '1.0.0',
+ *   tools,
+ * });
+ *
+ * // Serve as JSON
+ * app.get('/openapi.json', (req, res) => res.json(spec));
+ * ```
+ */
+
+interface OpenAPISpecConfig {
+    /** API title */
+    title: string;
+    /** API version */
+    version: string;
+    /** Tool registry */
+    tools: Record<string, Tool>;
+    /** API description */
+    description?: string;
+    /** Base URL for servers (default: '/') */
+    serverUrl?: string;
+    /** Base path prefix for tool endpoints (default: '/api/tools') */
+    basePath?: string;
+    /** Tags to group endpoints */
+    tags?: Array<{
+        name: string;
+        description?: string;
+    }>;
+}
+interface OpenAPISpec {
+    openapi: '3.1.0';
+    info: {
+        title: string;
+        version: string;
+        description?: string;
+    };
+    servers: Array<{
+        url: string;
+    }>;
+    paths: Record<string, PathItem>;
+    components: {
+        schemas: Record<string, JsonSchema>;
+    };
+    tags?: Array<{
+        name: string;
+        description?: string;
+    }>;
+}
+interface PathItem {
+    post: {
+        operationId: string;
+        summary: string;
+        description?: string;
+        tags?: string[];
+        requestBody: {
+            required: true;
+            content: {
+                'application/json': {
+                    schema: {
+                        $ref: string;
+                    };
+                };
+            };
+        };
+        responses: Record<string, {
+            description: string;
+            content?: {
+                'application/json': {
+                    schema: {
+                        $ref: string;
+                    } | JsonSchema;
+                };
+            };
+        }>;
+    };
+}
+/**
+ * Generate an OpenAPI 3.1 spec from a Better UI tool registry.
+ */
+declare function generateOpenAPISpec(config: OpenAPISpecConfig): OpenAPISpec;
+/**
+ * Create a request handler that serves the OpenAPI spec as JSON.
+ *
+ * @example
+ * ```typescript
+ * // Next.js route: app/api/openapi/route.ts
+ * export const GET = openAPIHandler({
+ *   title: 'My Tools',
+ *   version: '1.0.0',
+ *   tools,
+ * });
+ * ```
+ */
+declare function openAPIHandler(config: OpenAPISpecConfig): (req: Request) => Response;
+
+export { type OpenAPISpec, type OpenAPISpecConfig, generateOpenAPISpec, openAPIHandler };

package/dist/openapi/index.js

@@ -0,0 +1,260 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/openapi/index.ts
+var openapi_exports = {};
+__export(openapi_exports, {
+  generateOpenAPISpec: () => generateOpenAPISpec,
+  openAPIHandler: () => openAPIHandler
+});
+module.exports = __toCommonJS(openapi_exports);
+
+// src/mcp/schema.ts
+function zodToJsonSchema(schema) {
+  return convert(schema);
+}
+function convert(schema) {
+  const def = schema._def;
+  const typeName = def?.typeName;
+  switch (typeName) {
+    case "ZodString":
+      return convertString(def);
+    case "ZodNumber":
+      return convertNumber(def);
+    case "ZodBoolean":
+      return { type: "boolean" };
+    case "ZodNull":
+      return { type: "null" };
+    case "ZodLiteral":
+      return { enum: [def.value] };
+    case "ZodEnum":
+      return { type: "string", enum: def.values };
+    case "ZodNativeEnum":
+      return { enum: Object.values(def.values) };
+    case "ZodObject":
+      return convertObject(def);
+    case "ZodArray":
+      return convertArray(def);
+    case "ZodOptional":
+      return convert(def.innerType);
+    case "ZodNullable": {
+      const inner = convert(def.innerType);
+      return { anyOf: [inner, { type: "null" }] };
+    }
+    case "ZodDefault":
+      return { ...convert(def.innerType), default: def.defaultValue() };
+    case "ZodUnion":
+      return { anyOf: def.options.map((o) => convert(o)) };
+    case "ZodDiscriminatedUnion":
+      return { oneOf: [...def.options.values()].map((o) => convert(o)) };
+    case "ZodRecord":
+      return {
+        type: "object",
+        additionalProperties: convert(def.valueType)
+      };
+    case "ZodTuple": {
+      const items = def.items.map((item) => convert(item));
+      return { type: "array", items: items.length === 1 ? items[0] : void 0, prefixItems: items };
+    }
+    case "ZodEffects":
+      return convert(def.schema);
+    case "ZodPipeline":
+      return convert(def.in);
+    case "ZodLazy":
+      return convert(def.getter());
+    case "ZodAny":
+      return {};
+    case "ZodUnknown":
+      return {};
+    default:
+      return {};
+  }
+}
+function convertString(def) {
+  const schema = { type: "string" };
+  if (def.checks) {
+    for (const check of def.checks) {
+      switch (check.kind) {
+        case "min":
+          schema.minLength = check.value;
+          break;
+        case "max":
+          schema.maxLength = check.value;
+          break;
+        case "email":
+          schema.format = "email";
+          break;
+        case "url":
+          schema.format = "uri";
+          break;
+        case "uuid":
+          schema.format = "uuid";
+          break;
+        case "regex":
+          schema.pattern = check.regex.source;
+          break;
+      }
+    }
+  }
+  if (def.description) schema.description = def.description;
+  return schema;
+}
+function convertNumber(def) {
+  const schema = { type: "number" };
+  if (def.checks) {
+    for (const check of def.checks) {
+      switch (check.kind) {
+        case "min":
+          schema.minimum = check.value;
+          if (check.inclusive === false) schema.exclusiveMinimum = check.value;
+          break;
+        case "max":
+          schema.maximum = check.value;
+          if (check.inclusive === false) schema.exclusiveMaximum = check.value;
+          break;
+        case "int":
+          schema.type = "integer";
+          break;
+      }
+    }
+  }
+  if (def.description) schema.description = def.description;
+  return schema;
+}
+function convertObject(def) {
+  const shape = def.shape();
+  const properties = {};
+  const required = [];
+  for (const [key, value] of Object.entries(shape)) {
+    properties[key] = convert(value);
+    const fieldDef = value._def;
+    const isOptional = fieldDef?.typeName === "ZodOptional" || fieldDef?.typeName === "ZodDefault";
+    if (!isOptional) {
+      required.push(key);
+    }
+  }
+  const schema = { type: "object", properties };
+  if (required.length > 0) schema.required = required;
+  if (def.description) schema.description = def.description;
+  return schema;
+}
+function convertArray(def) {
+  const schema = {
+    type: "array",
+    items: convert(def.type)
+  };
+  if (def.minLength) schema.minItems = def.minLength.value;
+  if (def.maxLength) schema.maxItems = def.maxLength.value;
+  if (def.description) schema.description = def.description;
+  return schema;
+}
+
+// src/openapi/index.ts
+function generateOpenAPISpec(config) {
+  const basePath = config.basePath ?? "/api/tools";
+  const paths = {};
+  const schemas = {};
+  const autoTags = /* @__PURE__ */ new Set();
+  for (const [key, tool] of Object.entries(config.tools)) {
+    const name = tool.name || key;
+    const inputSchemaName = `${name}Input`;
+    const outputSchemaName = `${name}Output`;
+    schemas[inputSchemaName] = zodToJsonSchema(tool.inputSchema);
+    if (tool.outputSchema) {
+      schemas[outputSchemaName] = zodToJsonSchema(tool.outputSchema);
+    }
+    const toolTags = tool.tags.length > 0 ? tool.tags : [name];
+    for (const t of toolTags) autoTags.add(t);
+    const responseSchema = tool.outputSchema ? { $ref: `#/components/schemas/${outputSchemaName}` } : { type: "object" };
+    const hints = [];
+    if (tool.hints.destructive) hints.push("destructive");
+    if (tool.hints.readOnly) hints.push("read-only");
+    if (tool.hints.idempotent) hints.push("idempotent");
+    if (tool.requiresConfirmation) hints.push("requires confirmation");
+    const hintsStr = hints.length > 0 ? ` [${hints.join(", ")}]` : "";
+    paths[`${basePath}/${name}`] = {
+      post: {
+        operationId: name,
+        summary: tool.description || name,
+        description: (tool.description || "") + hintsStr,
+        tags: tool.tags.length > 0 ? tool.tags : void 0,
+        requestBody: {
+          required: true,
+          content: {
+            "application/json": {
+              schema: { $ref: `#/components/schemas/${inputSchemaName}` }
+            }
+          }
+        },
+        responses: {
+          "200": {
+            description: "Successful tool execution",
+            content: {
+              "application/json": {
+                schema: {
+                  type: "object",
+                  properties: {
+                    result: responseSchema
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            description: "Invalid input (Zod validation error)"
+          },
+          "404": {
+            description: "Tool not found"
+          },
+          "500": {
+            description: "Tool execution failed"
+          }
+        }
+      }
+    };
+  }
+  const tags = config.tags ?? [...autoTags].map((t) => ({ name: t }));
+  return {
+    openapi: "3.1.0",
+    info: {
+      title: config.title,
+      version: config.version,
+      ...config.description ? { description: config.description } : {}
+    },
+    servers: [{ url: config.serverUrl ?? "/" }],
+    paths,
+    components: { schemas },
+    ...tags.length > 0 ? { tags } : {}
+  };
+}
+function openAPIHandler(config) {
+  const spec = generateOpenAPISpec(config);
+  const json = JSON.stringify(spec, null, 2);
+  return () => new Response(json, {
+    headers: {
+      "Content-Type": "application/json",
+      "Access-Control-Allow-Origin": "*"
+    }
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  generateOpenAPISpec,
+  openAPIHandler
+});

package/dist/openapi/index.mjs

@@ -0,0 +1,97 @@
+import {
+  zodToJsonSchema
+} from "../chunk-OH73K7I5.mjs";
+import "../chunk-Y6FXYEAI.mjs";
+
+// src/openapi/index.ts
+function generateOpenAPISpec(config) {
+  const basePath = config.basePath ?? "/api/tools";
+  const paths = {};
+  const schemas = {};
+  const autoTags = /* @__PURE__ */ new Set();
+  for (const [key, tool] of Object.entries(config.tools)) {
+    const name = tool.name || key;
+    const inputSchemaName = `${name}Input`;
+    const outputSchemaName = `${name}Output`;
+    schemas[inputSchemaName] = zodToJsonSchema(tool.inputSchema);
+    if (tool.outputSchema) {
+      schemas[outputSchemaName] = zodToJsonSchema(tool.outputSchema);
+    }
+    const toolTags = tool.tags.length > 0 ? tool.tags : [name];
+    for (const t of toolTags) autoTags.add(t);
+    const responseSchema = tool.outputSchema ? { $ref: `#/components/schemas/${outputSchemaName}` } : { type: "object" };
+    const hints = [];
+    if (tool.hints.destructive) hints.push("destructive");
+    if (tool.hints.readOnly) hints.push("read-only");
+    if (tool.hints.idempotent) hints.push("idempotent");
+    if (tool.requiresConfirmation) hints.push("requires confirmation");
+    const hintsStr = hints.length > 0 ? ` [${hints.join(", ")}]` : "";
+    paths[`${basePath}/${name}`] = {
+      post: {
+        operationId: name,
+        summary: tool.description || name,
+        description: (tool.description || "") + hintsStr,
+        tags: tool.tags.length > 0 ? tool.tags : void 0,
+        requestBody: {
+          required: true,
+          content: {
+            "application/json": {
+              schema: { $ref: `#/components/schemas/${inputSchemaName}` }
+            }
+          }
+        },
+        responses: {
+          "200": {
+            description: "Successful tool execution",
+            content: {
+              "application/json": {
+                schema: {
+                  type: "object",
+                  properties: {
+                    result: responseSchema
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            description: "Invalid input (Zod validation error)"
+          },
+          "404": {
+            description: "Tool not found"
+          },
+          "500": {
+            description: "Tool execution failed"
+          }
+        }
+      }
+    };
+  }
+  const tags = config.tags ?? [...autoTags].map((t) => ({ name: t }));
+  return {
+    openapi: "3.1.0",
+    info: {
+      title: config.title,
+      version: config.version,
+      ...config.description ? { description: config.description } : {}
+    },
+    servers: [{ url: config.serverUrl ?? "/" }],
+    paths,
+    components: { schemas },
+    ...tags.length > 0 ? { tags } : {}
+  };
+}
+function openAPIHandler(config) {
+  const spec = generateOpenAPISpec(config);
+  const json = JSON.stringify(spec, null, 2);
+  return () => new Response(json, {
+    headers: {
+      "Content-Type": "application/json",
+      "Access-Control-Allow-Origin": "*"
+    }
+  });
+}
+export {
+  generateOpenAPISpec,
+  openAPIHandler
+};

package/dist/schema-DdZf6066.d.mts

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+
+/**
+ * Lightweight Zod-to-JSON-Schema converter.
+ * Handles common Zod types without requiring zod-to-json-schema dependency.
+ */
+
+interface JsonSchema {
+    type?: string;
+    properties?: Record<string, JsonSchema>;
+    required?: string[];
+    items?: JsonSchema;
+    enum?: unknown[];
+    description?: string;
+    default?: unknown;
+    minimum?: number;
+    maximum?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    format?: string;
+    anyOf?: JsonSchema[];
+    oneOf?: JsonSchema[];
+    nullable?: boolean;
+    additionalProperties?: boolean | JsonSchema;
+    [key: string]: unknown;
+}
+declare function zodToJsonSchema(schema: z.ZodType | {
+    [key: string]: any;
+}): JsonSchema;
+
+export { type JsonSchema as J, zodToJsonSchema as z };

package/dist/schema-DdZf6066.d.ts

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+
+/**
+ * Lightweight Zod-to-JSON-Schema converter.
+ * Handles common Zod types without requiring zod-to-json-schema dependency.
+ */
+
+interface JsonSchema {
+    type?: string;
+    properties?: Record<string, JsonSchema>;
+    required?: string[];
+    items?: JsonSchema;
+    enum?: unknown[];
+    description?: string;
+    default?: unknown;
+    minimum?: number;
+    maximum?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    format?: string;
+    anyOf?: JsonSchema[];
+    oneOf?: JsonSchema[];
+    nullable?: boolean;
+    additionalProperties?: boolean | JsonSchema;
+    [key: string]: unknown;
+}
+declare function zodToJsonSchema(schema: z.ZodType | {
+    [key: string]: any;
+}): JsonSchema;
+
+export { type JsonSchema as J, zodToJsonSchema as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lantos1618/better-ui",
-  "version": "0.7.1",
+  "version": "0.9.0",
   "description": "A minimal, type-safe AI-first UI framework for building tools",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -41,6 +41,11 @@
       "import": "./dist/agui/index.mjs",
       "require": "./dist/agui/index.js"
     },
+    "./openapi": {
+      "types": "./dist/openapi/index.d.ts",
+      "import": "./dist/openapi/index.mjs",
+      "require": "./dist/openapi/index.js"
+    },
     "./theme.css": "./src/theme.css"
   },
   "files": [
@@ -69,7 +74,7 @@
   },
   "scripts": {
     "build": "npm run build:lib",
-    "build:lib": "tsup src/index.ts src/react/index.ts src/components/index.ts src/auth/index.ts src/persistence/index.ts src/mcp/index.ts src/agui/index.ts --format cjs,esm --dts --clean --tsconfig tsconfig.lib.json",
+    "build:lib": "tsup src/index.ts src/react/index.ts src/components/index.ts src/auth/index.ts src/persistence/index.ts src/mcp/index.ts src/agui/index.ts src/openapi/index.ts --format cjs,esm --dts --clean --tsconfig tsconfig.lib.json",
     "test": "jest",
     "type-check": "tsc --noEmit",
     "prepublishOnly": "npm run build:lib"