@vertesia/tools-sdk 1.2.0 → 1.4.0-dev.20260615.042549Z

package/src/server/interactions.ts

@@ -1,11 +1,11 @@
 // ================== Interaction Endpoints ==================
 
-import { CatalogInteractionRef } from "@vertesia/common";
-import { Context, Hono } from "hono";
-import { HTTPException } from "hono/http-exception";
-import { authorize } from "../auth.js";
-import { InteractionCollection } from "../InteractionCollection.js";
-import { ToolServerConfig } from "./types.js";
+import type { CatalogInteractionRef } from '@vertesia/common';
+import { type Context, Hono } from 'hono';
+import { HTTPException } from 'hono/http-exception';
+import { authorize } from '../auth.js';
+import type { InteractionCollection } from '../InteractionCollection.js';
+import type { ToolServerConfig } from './types.js';
 
 export function createInteractionsRoute(app: Hono, basePath: string, config: ToolServerConfig) {
     const { interactions = [] } = config;
@@ -17,8 +17,8 @@ export function createInteractionsRoute(app: Hono, basePath: string, config: Too
         for (const coll of interactions) {
             for (const inter of coll.interactions) {
                 allInteractions.push({
-                    type: "app",
-                    id: coll.name + ":" + inter.name,
+                    type: 'app',
+                    id: `${coll.name}:${inter.name}`,
                     name: inter.name,
                     title: inter.title || inter.name,
                     description: inter.description,
@@ -31,7 +31,7 @@ export function createInteractionsRoute(app: Hono, basePath: string, config: Too
             title: 'All Interactions',
             description: 'All available interactions across all collections',
             interactions: allInteractions,
-            collections: interactions.map(i => ({
+            collections: interactions.map((i) => ({
                 name: i.name,
                 title: i.title,
                 description: i.description,
@@ -54,42 +54,43 @@ export function createInteractionsRoute(app: Hono, basePath: string, config: Too
             // Explicit collection:interaction format
             const collName = parts[0];
             const interName = parts[1];
-            const inter = interactions.find(t => t.name === collName)?.getInteractionByName(interName);
+            const inter = interactions.find((t) => t.name === collName)?.getInteractionByName(interName);
             if (inter) {
-                return c.json({ ...inter, id: collName + ":" + interName });
+                return c.json({ ...inter, id: `${collName}:${interName}` });
             }
         } else {
             // Search all collections for the interaction by name
             for (const coll of interactions) {
                 const inter = coll.getInteractionByName(name);
                 if (inter) {
-                    return c.json({ ...inter, id: coll.name + ":" + name });
+                    return c.json({ ...inter, id: `${coll.name}:${name}` });
                 }
             }
         }
 
         throw new HTTPException(404, {
-            message: "No interaction found with name: " + name
+            message: `No interaction found with name: ${name}`,
         });
     });
-
 }
 
-
-
-
 function createInteractionEndpoints(coll: InteractionCollection): Hono {
     const endpoint = new Hono();
 
     endpoint.get('/', (c: Context) => {
-        return c.json(coll.interactions.map(inter => ({
-            type: "app",
-            id: coll.name + ":" + inter.name,
-            name: inter.name,
-            title: inter.title || inter.name,
-            description: inter.description,
-            tags: inter.tags || [],
-        } satisfies CatalogInteractionRef)));
+        return c.json(
+            coll.interactions.map(
+                (inter) =>
+                    ({
+                        type: 'app',
+                        id: `${coll.name}:${inter.name}`,
+                        name: inter.name,
+                        title: inter.title || inter.name,
+                        description: inter.description,
+                        tags: inter.tags || [],
+                    }) satisfies CatalogInteractionRef,
+            ),
+        );
     });
 
     endpoint.get('/:name', async (c: Context) => {
@@ -97,18 +98,18 @@ function createInteractionEndpoints(coll: InteractionCollection): Hono {
         const name = c.req.param('name');
         if (!name) {
             throw new HTTPException(400, {
-                message: 'Interaction name is required'
+                message: 'Interaction name is required',
             });
         }
         const inter = coll.getInteractionByName(name);
         if (!inter) {
             throw new HTTPException(404, {
-                message: "No interaction found with name: " + name
+                message: `No interaction found with name: ${name}`,
             });
         }
         return c.json({
             ...inter,
-            id: coll.name + ":" + inter.name,
+            id: `${coll.name}:${inter.name}`,
         });
     });
 

package/src/server/mcp.ts

@@ -1,12 +1,10 @@
 // ================== MCP Endpoints ==================
 
-import { Context, Hono } from "hono";
-import { HTTPException } from "hono/http-exception";
-import { authorize } from "../auth.js";
-import { ToolServerConfig } from "../index.js";
-import { MCPProviderConfig } from "./types.js";
-
-
+import { type Context, Hono } from 'hono';
+import { HTTPException } from 'hono/http-exception';
+import { authorize } from '../auth.js';
+import type { ToolServerConfig } from '../index.js';
+import type { MCPProviderConfig } from './types.js';
 
 export function createMcpRoute(app: Hono, basePath: string, config: ToolServerConfig) {
     const { mcpProviders = [] } = config;
@@ -14,7 +12,6 @@ export function createMcpRoute(app: Hono, basePath: string, config: ToolServerCo
     if (mcpProviders.length > 0) {
         app.route(basePath, createMCPEndpoints(mcpProviders));
     }
-
 }
 
 function createMCPEndpoints(providers: MCPProviderConfig[]): Hono {
@@ -28,24 +25,27 @@ function createMCPEndpoints(providers: MCPProviderConfig[]): Hono {
             return c.json(info);
         });
 
-        endpoint.get(`/${p.name}`, (c: Context) => c.json({
-            name: p.name,
-            description: p.description,
-        }));
+        endpoint.get(`/${p.name}`, (c: Context) =>
+            c.json({
+                name: p.name,
+                description: p.description,
+            }),
+        );
     }
 
     return endpoint;
 }
 
-async function readJsonBody(ctx: Context): Promise<Record<string, any>> {
+async function readJsonBody(ctx: Context): Promise<Record<string, unknown>> {
     try {
         const text = await ctx.req.text();
         const jsonContent = text?.trim() || '';
         if (!jsonContent) return {};
-        return JSON.parse(jsonContent) as Record<string, any>;
-    } catch (err: any) {
+        return JSON.parse(jsonContent) as Record<string, unknown>;
+    } catch (err: unknown) {
+        const message = err instanceof Error ? err.message : String(err);
         throw new HTTPException(400, {
-            message: "Failed to parse JSON body: " + err.message
+            message: `Failed to parse JSON body: ${message}`,
         });
     }
 }

package/src/server/processes.ts

@@ -0,0 +1,35 @@
+// ================== Process Definition Endpoints ==================
+
+import type { InCodeProcessDefinition } from '@vertesia/common';
+import type { Hono } from 'hono';
+import { HTTPException } from 'hono/http-exception';
+import type { ToolServerConfig } from './types.js';
+
+export function createProcessesRoute(app: Hono, basePath: string, config: ToolServerConfig) {
+    const { processes = [] } = config;
+
+    app.get(basePath, (c) => {
+        return c.json({
+            title: 'All Processes',
+            description: 'All available process definitions',
+            processes,
+        });
+    });
+
+    app.get(`${basePath}/:name`, (c) => {
+        const name = c.req.param('name');
+        const process = findProcess(processes, name);
+        if (!process) {
+            throw new HTTPException(404, {
+                message: `No process found with name: ${name}`,
+            });
+        }
+        return c.json(process);
+    });
+}
+
+function findProcess(processes: InCodeProcessDefinition[], name: string): InCodeProcessDefinition | undefined {
+    return processes.find(
+        (process) => process.id === name || process.name === name || process.definition.process === name,
+    );
+}

package/src/server/site.ts

@@ -1,25 +1,18 @@
-import { Hono } from "hono";
+import type { Hono } from 'hono';
 import {
     activityCollectionPage,
     contentTypeCollectionPage,
+    // biome-ignore lint/suspicious/noDeprecatedImports: index page is still served alongside the React site until that migration completes
     indexPage,
     interactionCollectionPage,
     skillCollectionPage,
     templateCollectionPage,
-    toolCollectionPage
-} from "../site/templates.js";
-import { ToolServerConfig } from "./types.js";
-
+    toolCollectionPage,
+} from '../site/templates.js';
+import type { ToolServerConfig } from './types.js';
 
 export function createSiteRoute(app: Hono, basePath: string, config: ToolServerConfig) {
-    const {
-        tools = [],
-        activities = [],
-        interactions = [],
-        types = [],
-        skills = [],
-        templates = [],
-    } = config;
+    const { tools = [], activities = [], interactions = [], types = [], skills = [], templates = [] } = config;
 
     // Index page
     app.get(`${basePath}/`, (c) => {
@@ -67,5 +60,4 @@ export function createSiteRoute(app: Hono, basePath: string, config: ToolServerC
             return c.html(contentTypeCollectionPage(coll));
         });
     }
-
-}
+}

package/src/server/skills.ts

@@ -1,11 +1,11 @@
 // ================== Skill Endpoints ==================
 
-import { Context, Hono } from "hono";
-import { HTTPException } from "hono/http-exception";
-import { SkillCollection } from "../SkillCollection.js";
-import { SkillDefinition, ToolCollectionDefinition, ToolDefinition } from "../types.js";
-import { makeScriptUrl } from "../utils.js";
-import { ToolContext, ToolServerConfig } from "./types.js";
+import { type Context, Hono } from 'hono';
+import { HTTPException } from 'hono/http-exception';
+import type { SkillCollection } from '../SkillCollection.js';
+import type { SkillDefinition, ToolCollectionDefinition, ToolDefinition } from '../types.js';
+import { makeScriptUrl } from '../utils.js';
+import type { ToolContext, ToolServerConfig } from './types.js';
 
 export function createSkillsRoute(app: Hono, basePath: string, config: ToolServerConfig) {
     const { skills = [] } = config;
@@ -34,12 +34,12 @@ export function createSkillsRoute(app: Hono, basePath: string, config: ToolServe
             title: 'All Skills',
             description: 'All available skills across all collections',
             tools: allSkills,
-            collections: skills.map(s => ({
+            collections: skills.map((s) => ({
                 name: s.name,
                 title: s.title,
                 description: s.description,
             })),
-        } satisfies ToolCollectionDefinition & { collections: any[] });
+        } satisfies ToolCollectionDefinition & { collections: unknown[] });
     });
 
     // POST /api/skills - Route to the correct collection based on tool_name
@@ -49,7 +49,8 @@ export function createSkillsRoute(app: Hono, basePath: string, config: ToolServe
         // Payload is already parsed and validated by middleware
         if (!ctx.payload) {
             throw new HTTPException(400, {
-                message: 'Invalid or missing skill execution payload. Expected { tool_use: { id, tool_name, tool_input? }, metadata? }'
+                message:
+                    'Invalid or missing skill execution payload. Expected { tool_use: { id, tool_name, tool_input? }, metadata? }',
             });
         }
 
@@ -61,7 +62,9 @@ export function createSkillsRoute(app: Hono, basePath: string, config: ToolServe
             // Extract skill name for better error message
             const skillName = toolName.startsWith('learn_') ? toolName.slice(6) : toolName;
             throw new HTTPException(404, {
-                message: `Skill not found: ${skillName}. Available skills: ${Array.from(skillToCollection.keys()).filter(k => !k.startsWith('learn_')).join(', ')}`
+                message: `Skill not found: ${skillName}. Available skills: ${Array.from(skillToCollection.keys())
+                    .filter((k) => !k.startsWith('learn_'))
+                    .join(', ')}`,
             });
         }
 
@@ -73,7 +76,6 @@ export function createSkillsRoute(app: Hono, basePath: string, config: ToolServe
     for (const coll of skills) {
         app.route(`${basePath}/${coll.name}`, createSkillEndpoints(coll));
     }
-
 }
 
 function createSkillEndpoints(coll: SkillCollection): Hono {
@@ -87,7 +89,7 @@ function createSkillEndpoints(coll: SkillCollection): Hono {
             src: `${url.origin}${url.pathname}`,
             title: coll.title || coll.name,
             description: coll.description || '',
-            tools: coll.getToolDefinitions()
+            tools: coll.getToolDefinitions(),
         } satisfies ToolCollectionDefinition);
     });
 
@@ -97,30 +99,29 @@ function createSkillEndpoints(coll: SkillCollection): Hono {
         const name = c.req.param('name');
         if (!name) {
             throw new HTTPException(400, {
-                message: 'Skill name is required'
+                message: 'Skill name is required',
             });
         }
         const skillName = name.startsWith('learn_') ? name.slice(6) : name;
         const skill = coll.getSkill(skillName);
         if (!skill) {
             throw new HTTPException(404, {
-                message: `Skill not found: ${skillName}`
+                message: `Skill not found: ${skillName}`,
             });
         }
         const url = new URL(c.req.url);
         return c.json({
             skill_name: skill.name,
-            scripts: skill.scripts ? skill.scripts.map(s => makeScriptUrl(url.origin, s)) : []
+            scripts: skill.scripts ? skill.scripts.map((s) => makeScriptUrl(url.origin, s)) : [],
         });
     });
 
-
     // Get a specific skill by name
     endpoint.get('/:name', (c: Context) => {
         const name = c.req.param('name');
         if (!name) {
             throw new HTTPException(400, {
-                message: 'Skill name is required'
+                message: 'Skill name is required',
             });
         }
         // Handle both "learn_name" and "name" formats
@@ -128,7 +129,7 @@ function createSkillEndpoints(coll: SkillCollection): Hono {
         const skill = coll.getSkill(skillName);
         if (!skill) {
             throw new HTTPException(404, {
-                message: `Skill not found: ${skillName}`
+                message: `Skill not found: ${skillName}`,
             });
         }
         return c.json(skill satisfies SkillDefinition);

package/src/server/templates.ts

@@ -1,80 +1,82 @@
-// ================== Template Endpoints ==================
-
-import { RenderingTemplateDefinition, RenderingTemplateDefinitionRef } from "@vertesia/common";
-import { Context, Hono } from "hono";
-import { HTTPException } from "hono/http-exception";
-import { RenderingTemplateCollection } from "../RenderingTemplateCollection.js";
-import { ToolServerConfig } from "./types.js";
-
-function toRef(basePath: string, collectionName: string, { instructions: _, ...ref }: RenderingTemplateDefinition): RenderingTemplateDefinitionRef {
-    return { ...ref, path: `${basePath}/${collectionName}/${ref.name}` };
-}
-
-export function createTemplatesRoute(app: Hono, basePath: string, config: ToolServerConfig) {
-    const { templates = [] } = config;
-
-    // GET /api/templates - Returns all templates from all collections (without instructions)
-    app.get(basePath, (c) => {
-        const allTemplates = templates.flatMap(coll =>
-            coll.templates.map(t => toRef(basePath, coll.name, t))
-        );
-
-        return c.json({
-            title: 'All Templates',
-            description: 'All available templates across all collections',
-            templates: allTemplates,
-            collections: templates.map(t => ({
-                name: t.name,
-                title: t.title,
-                description: t.description,
-            })),
-        });
-    });
-
-    // Create template collection endpoints
-    for (const coll of templates) {
-        app.route(`${basePath}/${coll.name}`, createTemplateEndpoints(basePath, coll));
-    }
-
-    // GET /api/templates/:name - Direct access by "collection:name" id format
-    app.get(`${basePath}/:id`, async (c) => {
-        const id = c.req.param('id');
-        const parts = id.split(':');
-        if (parts.length !== 2) {
-            throw new HTTPException(400, {
-                message: "Invalid template id. Expected format 'collection:name'"
-            });
-        }
-        const collName = parts[0];
-        const templateName = parts[1];
-        const template = templates.find(t => t.name === collName)?.getTemplate(templateName);
-        if (template) {
-            return c.json(template);
-        }
-
-        throw new HTTPException(404, {
-            message: "No template found with id: " + id
-        });
-    });
-}
-
-function createTemplateEndpoints(basePath: string, coll: RenderingTemplateCollection): Hono {
-    const endpoint = new Hono();
-
-    endpoint.get('/', (c: Context) => {
-        return c.json(coll.templates.map(t => toRef(basePath, coll.name, t)));
-    });
-
-    endpoint.get('/:name', (c: Context) => {
-        const name = c.req.param('name');
-        const template = coll.templates.find(t => t.name === name);
-        if (!template) {
-            throw new HTTPException(404, {
-                message: "No template found with name: " + name
-            });
-        }
-        return c.json(template);
-    });
-
-    return endpoint;
-}
+// ================== Template Endpoints ==================
+
+import type { RenderingTemplateDefinition, RenderingTemplateDefinitionRef } from '@vertesia/common';
+import { type Context, Hono } from 'hono';
+import { HTTPException } from 'hono/http-exception';
+import type { RenderingTemplateCollection } from '../RenderingTemplateCollection.js';
+import type { ToolServerConfig } from './types.js';
+
+function toRef(
+    basePath: string,
+    collectionName: string,
+    { instructions: _, ...ref }: RenderingTemplateDefinition,
+): RenderingTemplateDefinitionRef {
+    return { ...ref, path: `${basePath}/${collectionName}/${ref.name}` };
+}
+
+export function createTemplatesRoute(app: Hono, basePath: string, config: ToolServerConfig) {
+    const { templates = [] } = config;
+
+    // GET /api/templates - Returns all templates from all collections (without instructions)
+    app.get(basePath, (c) => {
+        const allTemplates = templates.flatMap((coll) => coll.templates.map((t) => toRef(basePath, coll.name, t)));
+
+        return c.json({
+            title: 'All Templates',
+            description: 'All available templates across all collections',
+            templates: allTemplates,
+            collections: templates.map((t) => ({
+                name: t.name,
+                title: t.title,
+                description: t.description,
+            })),
+        });
+    });
+
+    // Create template collection endpoints
+    for (const coll of templates) {
+        app.route(`${basePath}/${coll.name}`, createTemplateEndpoints(basePath, coll));
+    }
+
+    // GET /api/templates/:name - Direct access by "collection:name" id format
+    app.get(`${basePath}/:id`, async (c) => {
+        const id = c.req.param('id');
+        const parts = id.split(':');
+        if (parts.length !== 2) {
+            throw new HTTPException(400, {
+                message: "Invalid template id. Expected format 'collection:name'",
+            });
+        }
+        const collName = parts[0];
+        const templateName = parts[1];
+        const template = templates.find((t) => t.name === collName)?.getTemplate(templateName);
+        if (template) {
+            return c.json(template);
+        }
+
+        throw new HTTPException(404, {
+            message: `No template found with id: ${id}`,
+        });
+    });
+}
+
+function createTemplateEndpoints(basePath: string, coll: RenderingTemplateCollection): Hono {
+    const endpoint = new Hono();
+
+    endpoint.get('/', (c: Context) => {
+        return c.json(coll.templates.map((t) => toRef(basePath, coll.name, t)));
+    });
+
+    endpoint.get('/:name', (c: Context) => {
+        const name = c.req.param('name');
+        const template = coll.templates.find((t) => t.name === name);
+        if (!template) {
+            throw new HTTPException(404, {
+                message: `No template found with name: ${name}`,
+            });
+        }
+        return c.json(template);
+    });
+
+    return endpoint;
+}

package/src/server/tools.ts

@@ -1,8 +1,8 @@
-import { Context, Hono } from "hono";
-import { HTTPException } from "hono/http-exception";
-import { ToolCollection } from "../ToolCollection.js";
-import { ToolCollectionDefinition, ToolDefinition } from "../types.js";
-import { ToolContext, ToolServerConfig } from "./types.js";
+import { type Context, Hono } from 'hono';
+import { HTTPException } from 'hono/http-exception';
+import type { ToolCollection } from '../ToolCollection.js';
+import type { ToolCollectionDefinition, ToolDefinition } from '../types.js';
+import type { ToolContext, ToolServerConfig } from './types.js';
 
 export function createToolsRoute(app: Hono, basePath: string, config: ToolServerConfig) {
     const { tools = [] } = config;
@@ -34,12 +34,12 @@ export function createToolsRoute(app: Hono, basePath: string, config: ToolServer
             title: 'All Tools',
             description: 'All available tools across all collections',
             tools: allTools,
-            collections: tools.map(t => ({
+            collections: tools.map((t) => ({
                 name: t.name,
                 title: t.title,
                 description: t.description,
             })),
-        } satisfies ToolCollectionDefinition & { collections: any[]; reserveToolCount?: number });
+        } satisfies ToolCollectionDefinition & { collections: unknown[]; reserveToolCount?: number });
     });
 
     // POST /api/tools - Route to the correct collection based on tool_name
@@ -49,7 +49,8 @@ export function createToolsRoute(app: Hono, basePath: string, config: ToolServer
         // Payload is already parsed and validated by middleware
         if (!ctx.payload) {
             throw new HTTPException(400, {
-                message: 'Invalid or missing tool execution payload. Expected { tool_use: { id, tool_name, tool_input? }, metadata? }'
+                message:
+                    'Invalid or missing tool execution payload. Expected { tool_use: { id, tool_name, tool_input? }, metadata? }',
             });
         }
 
@@ -59,7 +60,7 @@ export function createToolsRoute(app: Hono, basePath: string, config: ToolServer
         const collection = toolToCollection.get(toolName);
         if (!collection) {
             throw new HTTPException(404, {
-                message: `Tool not found: ${toolName}. Available tools: ${Array.from(toolToCollection.keys()).join(', ')}`
+                message: `Tool not found: ${toolName}. Available tools: ${Array.from(toolToCollection.keys()).join(', ')}`,
             });
         }
 
@@ -91,12 +92,10 @@ function createToolEndpoints(coll: ToolCollection): Hono {
         const url = new URL(c.req.url);
 
         const response: ToolCollectionDefinition = {
-            src: importSourceUrl
-                ? `${url.origin}/libs/vertesia-tools-${coll.name}.js`
-                : `${url.origin}${url.pathname}`,
+            src: importSourceUrl ? `${url.origin}/libs/vertesia-tools-${coll.name}.js` : `${url.origin}${url.pathname}`,
             title: coll.title || coll.name,
             description: coll.description || '',
-            tools: coll.getToolDefinitions()
+            tools: coll.getToolDefinitions(),
         };
 
         return c.json(response);
@@ -104,6 +103,3 @@ function createToolEndpoints(coll: ToolCollection): Hono {
 
     return endpoint;
 }
-
-
-