@vertesia/tools-sdk 1.0.0-dev.20260203.130115Z → 1.0.0-dev.20260225.024852Z

package/lib/cjs/server/widgets.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWidgetsRoute = createWidgetsRoute;
+function createWidgetsRoute(app, basePath, config) {
+    const { skills = [] } = config;
+    // GET /api/widgets - Returns all widgets from all skill collections
+    app.get(basePath, (c) => {
+        const url = new URL(c.req.url);
+        const widgets = {};
+        for (const coll of skills) {
+            const collWidgets = coll.getWidgets();
+            for (const widget of collWidgets) {
+                widgets[widget.name] = {
+                    collection: coll.name,
+                    skill: widget.skill,
+                    url: `${url.origin}/widgets/${widget.name}.js`,
+                };
+            }
+        }
+        return c.json({
+            title: 'All Widgets',
+            description: 'All available widgets across all skill collections',
+            widgets,
+        });
+    });
+}
+//# sourceMappingURL=widgets.js.map

package/lib/cjs/server/widgets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"widgets.js","sourceRoot":"","sources":["../../../src/server/widgets.ts"],"names":[],"mappings":";;AAKA,gDA4BC;AA5BD,SAAgB,kBAAkB,CAAC,GAAS,EAAE,QAAgB,EAAE,MAAwB;IAEpF,MAAM,EAAE,MAAM,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC;IAE/B,oEAAoE;IACpE,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE;QACpB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAE/B,MAAM,OAAO,GAAkC,EAAE,CAAC;QAClD,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;YACxB,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YACtC,KAAK,MAAM,MAAM,IAAI,WAAW,EAAE,CAAC;gBAC/B,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG;oBACnB,UAAU,EAAE,IAAI,CAAC,IAAI;oBACrB,KAAK,EAAE,MAAM,CAAC,KAAK;oBACnB,GAAG,EAAE,GAAG,GAAG,CAAC,MAAM,YAAY,MAAM,CAAC,IAAI,KAAK;iBACjD,CAAA;YACL,CAAC;QACL,CAAC;QAED,OAAO,CAAC,CAAC,IAAI,CAAC;YACV,KAAK,EAAE,aAAa;YACpB,WAAW,EAAE,oDAAoD;YACjE,OAAO;SACV,CAAC,CAAC;IAEP,CAAC,CAAC,CAAC;AAEP,CAAC"}

package/lib/cjs/server.js

@@ -0,0 +1,136 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createToolServer = createToolServer;
+exports.createDevServer = createDevServer;
+const hono_1 = require("hono");
+const cors_1 = require("hono/cors");
+const http_exception_1 = require("hono/http-exception");
+const zod_1 = require("zod");
+const interactions_js_1 = require("./server/interactions.js");
+const mcp_js_1 = require("./server/mcp.js");
+const site_js_1 = require("./server/site.js");
+const skills_js_1 = require("./server/skills.js");
+const tools_js_1 = require("./server/tools.js");
+const widgets_js_1 = require("./server/widgets.js");
+const app_package_js_1 = require("./server/app-package.js");
+const content_types_js_1 = require("./server/content-types.js");
+// Schema for tool execution payload
+const ToolExecutionPayloadSchema = zod_1.z.object({
+    tool_use: zod_1.z.object({
+        id: zod_1.z.string(),
+        tool_name: zod_1.z.string(),
+        tool_input: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).default({}),
+    }),
+    metadata: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional(),
+});
+/**
+ * Create a Hono server for tools, interactions, and skills.
+ *
+ * @example
+ * ```typescript
+ * import { createToolServer, ToolCollection, SkillCollection } from "@vertesia/tools-sdk";
+ *
+ * const server = createToolServer({
+ *     tools: [myToolCollection],
+ *     skills: [mySkillCollection],
+ * });
+ *
+ * export default server;
+ * ```
+ */
+function createToolServer(config) {
+    const { prefix = '/api', tools = [], interactions = [], skills = [], mcpProviders = [], disableHtml = false, } = config;
+    const app = new hono_1.Hono();
+    // Add CORS middleware globally
+    app.use('*', (0, cors_1.cors)({ origin: '*', allowMethods: ['GET', 'POST', 'OPTIONS'] }));
+    // Middleware to parse and validate body, store on context for reuse
+    app.use('*', async (c, next) => {
+        const ctx = c;
+        if (c.req.method === 'POST') {
+            try {
+                const text = await c.req.text();
+                const body = JSON.parse(text);
+                const result = ToolExecutionPayloadSchema.safeParse(body);
+                if (result.success) {
+                    ctx.payload = result.data;
+                    ctx.toolUseId = result.data.tool_use.id;
+                    ctx.toolName = result.data.tool_use.tool_name;
+                }
+                // If validation fails, still store raw body for error reporting
+                // but don't set payload - handlers will return validation error
+            }
+            catch {
+                // Ignore parsing errors - body might not be JSON
+            }
+        }
+        await next();
+    });
+    // HTML pages (unless disabled)
+    if (!disableHtml) {
+        (0, site_js_1.createSiteRoute)(app, '', config);
+    }
+    // Add base API route
+    app.get(prefix, (c) => {
+        // Skills are exposed as tools, so include them in the tools list
+        const allToolEndpoints = [
+            ...tools.map(col => `${prefix}/tools/${col.name}`),
+            ...skills.map(col => `${prefix}/skills/${col.name}`),
+        ];
+        return c.json({
+            message: 'Vertesia Tools API',
+            version: '1.0.0',
+            endpoints: {
+                tools: allToolEndpoints,
+                interactions: interactions.map(col => `${prefix}/interactions/${col.name}`),
+                mcp: mcpProviders.map(p => `${prefix}/mcp/${p.name}`),
+            }
+        });
+    });
+    (0, app_package_js_1.createPackageRoute)(app, `${prefix}/package`, config);
+    (0, tools_js_1.createToolsRoute)(app, `${prefix}/tools`, config);
+    (0, skills_js_1.createSkillsRoute)(app, `${prefix}/skills`, config);
+    (0, widgets_js_1.createWidgetsRoute)(app, `${prefix}/widgets`, config);
+    (0, interactions_js_1.createInteractionsRoute)(app, `${prefix}/interactions`, config);
+    (0, content_types_js_1.createContentTypesRoute)(app, `${prefix}/types`, config);
+    (0, mcp_js_1.createMcpRoute)(app, `${prefix}/mcp`, config);
+    // Global error handler - returns ToolExecutionResponseError format
+    app.onError((err, c) => {
+        const ctx = c;
+        const status = err instanceof http_exception_1.HTTPException ? err.status : 500;
+        const errorMessage = err instanceof http_exception_1.HTTPException ? err.message : 'Internal Server Error';
+        if (!(err instanceof http_exception_1.HTTPException)) {
+            console.error('Uncaught Error:', err);
+        }
+        return c.json({
+            tool_use_id: ctx.toolUseId || 'unknown',
+            status,
+            error: errorMessage,
+            data: ctx.toolName ? { tool_name: ctx.toolName } : undefined,
+        }, status);
+    });
+    // Not found handler - returns ToolExecutionResponseError format
+    app.notFound((c) => {
+        const ctx = c;
+        return c.json({
+            tool_use_id: ctx.toolUseId || 'unknown',
+            status: 404,
+            error: `Not found: ${c.req.method} ${c.req.path}`,
+            data: ctx.toolName ? { tool_name: ctx.toolName } : undefined,
+        }, 404);
+    });
+    return app;
+}
+// ================== Server Utilities ==================
+/**
+ * Simple development server with static fimesale handling
+ *
+ * @deprecated Use tools server template
+ */
+function createDevServer(config) {
+    const app = createToolServer(config);
+    if (config.staticHandler) {
+        app.use('*', config.staticHandler);
+    }
+    return app;
+}
+//# sourceMappingURL=server.js.map

package/lib/cjs/server.js.map

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