@vertesia/tools-sdk 1.3.0 → 1.4.0-dev.20260615.051508Z

package/src/server/types.ts

@@ -1,20 +1,26 @@
-import { Context } from "hono";
-import { ActivityCollection } from "../ActivityCollection.js";
-import { InteractionCollection } from "../InteractionCollection.js";
-import { SkillCollection } from "../SkillCollection.js";
-import { RenderingTemplateCollection } from "../RenderingTemplateCollection.js";
-import { ToolCollection } from "../ToolCollection.js";
-import { ToolExecutionPayload } from "../types.js";
-import { JSONSchema } from "@llumiverse/common";
-import { AppUIConfig, ProjectConfiguration } from "@vertesia/common";
-import { ContentTypesCollection } from "../ContentTypesCollection.js";
+import type { JSONSchema } from '@llumiverse/common';
+import type {
+    AppDashboardDefinition,
+    AppUIConfig,
+    InCodeProcessDefinition,
+    ProjectConfiguration,
+} from '@vertesia/common';
+import type { Context } from 'hono';
+import type { ActivityCollection } from '../ActivityCollection.js';
+import type { AuthSession } from '../auth.js';
+import type { ContentTypesCollection } from '../ContentTypesCollection.js';
+import type { InteractionCollection } from '../InteractionCollection.js';
+import type { RenderingTemplateCollection } from '../RenderingTemplateCollection.js';
+import type { SkillCollection } from '../SkillCollection.js';
+import type { ToolCollection } from '../ToolCollection.js';
+import type { MCPConnectionDetails, ToolExecutionPayload } from '../types.js';
 
 /**
  * Extended context with parsed payload for tool/skill execution
  */
 export interface ToolContext extends Context {
     /** The parsed request payload */
-    payload?: ToolExecutionPayload<any>;
+    payload?: ToolExecutionPayload;
     /** The tool_use.id from the payload */
     toolUseId?: string;
     /** The tool_use.tool_name from the payload */
@@ -27,11 +33,7 @@ export interface ToolContext extends Context {
 export interface MCPProviderConfig {
     name: string;
     description?: string;
-    createMCPConnection: (session: any, config: Record<string, any>) => Promise<{
-        name: string;
-        url: string;
-        token: string;
-    }>;
+    createMCPConnection: (session: AuthSession, config: Record<string, unknown>) => Promise<MCPConnectionDetails>;
 }
 
 /**
@@ -62,6 +64,14 @@ export interface ToolServerConfig {
      * Content type collections to expose
      */
     types?: ContentTypesCollection[];
+    /**
+     * Process definitions to expose as app-contributed processes.
+     */
+    processes?: InCodeProcessDefinition[];
+    /**
+     * Dashboard definitions to expose as app-contributed dashboards.
+     */
+    dashboards?: AppDashboardDefinition[];
     /**
      * Skill collections to expose
      */
@@ -95,11 +105,10 @@ export interface ToolServerConfig {
     hideUILinks?: boolean;
 
     /**
-     * If a filter is provided, it will be called with the project configuration when requesting tool definitions, and can be used to filter which tools are returned based on the project configuration. 
+     * If a filter is provided, it will be called with the project configuration when requesting tool definitions, and can be used to filter which tools are returned based on the project configuration.
      * This allows for dynamic enabling/disabling of tools based on project settings.
-     * @param projectConfig 
-     * @returns 
+     * @param projectConfig
+     * @returns
      */
     toolFilter?: (projectConfig: ProjectConfiguration) => boolean;
 }
-

package/src/server/widgets.ts

@@ -1,10 +1,8 @@
-import { AppWidgetInfo } from "@vertesia/common";
-import { Hono } from "hono";
-import { ToolServerConfig } from "./types.js";
-
+import type { AppWidgetInfo } from '@vertesia/common';
+import type { Hono } from 'hono';
+import type { ToolServerConfig } from './types.js';
 
 export function createWidgetsRoute(app: Hono, basePath: string, config: ToolServerConfig) {
-
     const { skills = [] } = config;
 
     // GET /api/widgets - Returns all widgets from all skill collections
@@ -19,7 +17,7 @@ export function createWidgetsRoute(app: Hono, basePath: string, config: ToolServ
                     collection: coll.name,
                     skill: widget.skill,
                     url: `${url.origin}/widgets/${widget.name}.js`,
-                }
+                };
             }
         }
 
@@ -28,7 +26,5 @@ export function createWidgetsRoute(app: Hono, basePath: string, config: ToolServ
             description: 'All available widgets across all skill collections',
             widgets,
         });
-
     });
-
-}
+}

package/src/server.ts

@@ -1,19 +1,21 @@
-import { Context, Hono } from "hono";
-import { cors } from "hono/cors";
-import { HTTPException } from "hono/http-exception";
-import { z } from "zod";
-import { createActivitiesRoute } from "./server/activities.js";
-import { createInteractionsRoute } from "./server/interactions.js";
-import { createMcpRoute } from "./server/mcp.js";
-import { createSiteRoute } from "./server/site.js";
-import { createSkillsRoute } from "./server/skills.js";
-import { createToolsRoute } from "./server/tools.js";
-import { ToolContext, ToolServerConfig } from "./server/types.js";
-import { ToolExecutionPayload } from "./types.js";
-import { createTemplatesRoute } from "./server/templates.js";
-import { createWidgetsRoute } from "./server/widgets.js";
-import { createPackageRoute } from "./server/app-package.js";
-import { createContentTypesRoute } from "./server/content-types.js";
+import { type Context, Hono } from 'hono';
+import { cors } from 'hono/cors';
+import { HTTPException } from 'hono/http-exception';
+import { z } from 'zod';
+import { createActivitiesRoute } from './server/activities.js';
+import { createPackageRoute } from './server/app-package.js';
+import { createContentTypesRoute } from './server/content-types.js';
+import { createDashboardsRoute } from './server/dashboards.js';
+import { createInteractionsRoute } from './server/interactions.js';
+import { createMcpRoute } from './server/mcp.js';
+import { createProcessesRoute } from './server/processes.js';
+import { createSiteRoute } from './server/site.js';
+import { createSkillsRoute } from './server/skills.js';
+import { createTemplatesRoute } from './server/templates.js';
+import { createToolsRoute } from './server/tools.js';
+import type { ToolContext, ToolServerConfig } from './server/types.js';
+import { createWidgetsRoute } from './server/widgets.js';
+import type { ToolExecutionPayload } from './types.js';
 
 // Schema for tool execution payload
 const ToolExecutionPayloadSchema = z.object({
@@ -25,8 +27,6 @@ const ToolExecutionPayloadSchema = z.object({
     metadata: z.record(z.string(), z.any()).optional(),
 });
 
-
-
 /**
  * Create a Hono server for tools, interactions, and skills.
  *
@@ -50,6 +50,7 @@ export function createToolServer(config: ToolServerConfig): Hono {
         skills = [],
         templates = [],
         activities = [],
+        dashboards = [],
         mcpProviders = [],
         disableHtml = false,
     } = config;
@@ -68,7 +69,7 @@ export function createToolServer(config: ToolServerConfig): Hono {
                 const body = JSON.parse(text);
                 const result = ToolExecutionPayloadSchema.safeParse(body);
                 if (result.success) {
-                    ctx.payload = result.data as ToolExecutionPayload<any>;
+                    ctx.payload = result.data as ToolExecutionPayload;
                     ctx.toolUseId = result.data.tool_use.id;
                     ctx.toolName = result.data.tool_use.tool_name;
                 }
@@ -90,23 +91,24 @@ export function createToolServer(config: ToolServerConfig): Hono {
     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}`),
+            ...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}`),
-                templates: templates.map(col => `${prefix}/templates/${col.name}`),
-                activities: activities.map(col => `${prefix}/activities/${col.name}`),
-                mcp: mcpProviders.map(p => `${prefix}/mcp/${p.name}`),
-            }
+                interactions: interactions.map((col) => `${prefix}/interactions/${col.name}`),
+                templates: templates.map((col) => `${prefix}/templates/${col.name}`),
+                processes: `${prefix}/processes`,
+                dashboards: dashboards.length > 0 ? `${prefix}/dashboards` : undefined,
+                activities: activities.map((col) => `${prefix}/activities/${col.name}`),
+                mcp: mcpProviders.map((p) => `${prefix}/mcp/${p.name}`),
+            },
         });
     });
 
-
     createPackageRoute(app, `${prefix}/package`, config);
     createToolsRoute(app, `${prefix}/tools`, config);
     createSkillsRoute(app, `${prefix}/skills`, config);
@@ -115,9 +117,10 @@ export function createToolServer(config: ToolServerConfig): Hono {
     createInteractionsRoute(app, `${prefix}/interactions`, config);
     createTemplatesRoute(app, `${prefix}/templates`, config);
     createContentTypesRoute(app, `${prefix}/types`, config);
+    createProcessesRoute(app, `${prefix}/processes`, config);
+    createDashboardsRoute(app, `${prefix}/dashboards`, config);
     createMcpRoute(app, `${prefix}/mcp`, config);
 
-
     // Global error handler - returns ToolExecutionResponseError format
     app.onError((err, c) => {
         const ctx = c as unknown as ToolContext;
@@ -128,40 +131,46 @@ export function createToolServer(config: ToolServerConfig): Hono {
             console.error('Uncaught Error:', err);
         }
 
-        return c.json({
-            tool_use_id: ctx.toolUseId || 'unknown',
+        return c.json(
+            {
+                tool_use_id: ctx.toolUseId || 'unknown',
+                status,
+                error: errorMessage,
+                data: ctx.toolName ? { tool_name: ctx.toolName } : undefined,
+            },
             status,
-            error: errorMessage,
-            data: ctx.toolName ? { tool_name: ctx.toolName } : undefined,
-        }, status);
+        );
     });
 
     // Not found handler - returns ToolExecutionResponseError format
     app.notFound((c) => {
         const ctx = c as unknown as ToolContext;
-        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 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 
+ *
+ * @deprecated Use tools server template
  */
-export function createDevServer(config: ToolServerConfig & {
-    staticHandler?: (c: Context, next: () => Promise<void>) => Promise<Response | void>;
-}): Hono {
+export function createDevServer(
+    config: ToolServerConfig & {
+        staticHandler?: (c: Context, next: () => Promise<void>) => Promise<Response | undefined>;
+    },
+): Hono {
     const app = createToolServer(config);
 
     if (config.staticHandler) {
@@ -170,4 +179,3 @@ export function createDevServer(config: ToolServerConfig & {
 
     return app;
 }
-

package/src/site/styles.ts

@@ -1,7 +1,7 @@
 /**
  * Shared CSS styles for the tools server HTML pages
  */
-export const baseStyles = /*css*/`
+export const baseStyles = /*css*/ `
 :root {
     color-scheme: light dark;
 }