@vertesia/tools-sdk 1.0.0-dev.20260305.083323Z → 1.0.0-dev.20260331.091034Z

package/src/server/interactions.ts

@@ -50,16 +50,22 @@ export function createInteractionsRoute(app: Hono, basePath: string, config: Too
         const name = c.req.param('name');
 
         const parts = name.split(':');
-        if (parts.length !== 2) {
-            throw new HTTPException(400, {
-                message: "Invalid interaction name. Expected format 'collection:interaction'"
-            });
-        }
-        const collName = parts[0];
-        const interName = parts[1];
-        const inter = interactions.find(t => t.name === collName)?.getInteractionByName(interName);
-        if (inter) {
-            return c.json({ ...inter, id: collName + ":" + interName });
+        if (parts.length === 2) {
+            // Explicit collection:interaction format
+            const collName = parts[0];
+            const interName = parts[1];
+            const inter = interactions.find(t => t.name === collName)?.getInteractionByName(interName);
+            if (inter) {
+                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 });
+                }
+            }
         }
 
         throw new HTTPException(404, {
@@ -89,6 +95,11 @@ function createInteractionEndpoints(coll: InteractionCollection): Hono {
     endpoint.get('/:name', async (c: Context) => {
         await authorize(c);
         const name = c.req.param('name');
+        if (!name) {
+            throw new HTTPException(400, {
+                message: 'Interaction name is required'
+            });
+        }
         const inter = coll.getInteractionByName(name);
         if (!inter) {
             throw new HTTPException(404, {
@@ -102,4 +113,4 @@ function createInteractionEndpoints(coll: InteractionCollection): Hono {
     });
 
     return endpoint;
-}
+}

package/src/server/site.ts

@@ -1,5 +1,6 @@
 import { Hono } from "hono";
 import {
+    activityCollectionPage,
     contentTypeCollectionPage,
     indexPage,
     interactionCollectionPage,
@@ -13,6 +14,7 @@ import { ToolServerConfig } from "./types.js";
 export function createSiteRoute(app: Hono, basePath: string, config: ToolServerConfig) {
     const {
         tools = [],
+        activities = [],
         interactions = [],
         types = [],
         skills = [],
@@ -31,6 +33,13 @@ export function createSiteRoute(app: Hono, basePath: string, config: ToolServerC
         });
     }
 
+    // Activity collection pages
+    for (const coll of activities) {
+        app.get(`${basePath}/activities/${coll.name}`, (c) => {
+            return c.html(activityCollectionPage(coll));
+        });
+    }
+
     // Skill collection pages
     for (const coll of skills) {
         app.get(`${basePath}/skills/${coll.name}`, (c) => {

package/src/server/skills.ts

@@ -95,6 +95,11 @@ function createSkillEndpoints(coll: SkillCollection): Hono {
     // Returns all scripts bundled with the skill
     endpoint.get('/:name/scripts', (c: Context) => {
         const name = c.req.param('name');
+        if (!name) {
+            throw new HTTPException(400, {
+                message: 'Skill name is required'
+            });
+        }
         const skillName = name.startsWith('learn_') ? name.slice(6) : name;
         const skill = coll.getSkill(skillName);
         if (!skill) {
@@ -113,6 +118,11 @@ function createSkillEndpoints(coll: SkillCollection): Hono {
     // 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'
+            });
+        }
         // Handle both "learn_name" and "name" formats
         const skillName = name.startsWith('learn_') ? name.slice(6) : name;
         const skill = coll.getSkill(skillName);

package/src/server/types.ts

@@ -1,4 +1,5 @@
 import { Context } from "hono";
+import { ActivityCollection } from "../ActivityCollection.js";
 import { InteractionCollection } from "../InteractionCollection.js";
 import { SkillCollection } from "../SkillCollection.js";
 import { RenderingTemplateCollection } from "../RenderingTemplateCollection.js";
@@ -49,6 +50,10 @@ export interface ToolServerConfig {
      * Tool collections to expose
      */
     tools?: ToolCollection[];
+    /**
+     * Activity collections to expose for DSL workflows
+     */
+    activities?: ActivityCollection[];
     /**
      * Interaction collections to expose
      */

package/src/server.ts

@@ -2,6 +2,7 @@ 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";
@@ -48,6 +49,7 @@ export function createToolServer(config: ToolServerConfig): Hono {
         interactions = [],
         skills = [],
         templates = [],
+        activities = [],
         mcpProviders = [],
         disableHtml = false,
     } = config;
@@ -98,6 +100,7 @@ export function createToolServer(config: ToolServerConfig): Hono {
                 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}`),
             }
         });
@@ -108,6 +111,7 @@ export function createToolServer(config: ToolServerConfig): Hono {
     createToolsRoute(app, `${prefix}/tools`, config);
     createSkillsRoute(app, `${prefix}/skills`, config);
     createWidgetsRoute(app, `${prefix}/widgets`, config);
+    createActivitiesRoute(app, `${prefix}/activities`, config);
     createInteractionsRoute(app, `${prefix}/interactions`, config);
     createTemplatesRoute(app, `${prefix}/templates`, config);
     createContentTypesRoute(app, `${prefix}/types`, config);

package/src/site/templates.ts

@@ -1,3 +1,5 @@
+import type { RemoteActivityDefinition } from "@vertesia/common";
+import type { ActivityCollection } from "../ActivityCollection.js";
 import type { InteractionCollection } from "../InteractionCollection.js";
 import { ToolServerConfig } from "../server/types.js";
 import type { SkillCollection } from "../SkillCollection.js";
@@ -35,6 +37,11 @@ const templateIcon = /*html*/`
   <polyline points="10 9 9 9 8 9"/>
 </svg>`;
 
+const activityIcon = /*html*/`
+<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+  <polyline points="22 12 18 12 15 21 9 3 6 12 2 12"/>
+</svg>`;
+
 /**
  * Extended styles for detail pages
  */
@@ -822,6 +829,7 @@ export function indexPage(
     const {
         title = 'Tools Server',
         tools = [],
+        activities = [],
         interactions = [],
         skills = [],
         templates = [],
@@ -851,10 +859,11 @@ export function indexPage(
                     <p class="hero-eyebrow">Tools Server</p>
                     <h1 class="hero-title">${title}</h1>
                     <p class="hero-tagline">
-                        Discover the tools, skills, interactions, and content types exposed by this server.
+                        Discover the tools, activities, skills, interactions, and content types exposed by this server.
                     </p>
                     <div class="hero-summary">
                         ${tools.length ? /*html*/`<span><dot></dot> ${tools.length} tool collection${tools.length !== 1 ? 's' : ''}</span>` : ''}
+                        ${activities.length ? /*html*/`<span><dot></dot> ${activities.length} activity collection${activities.length !== 1 ? 's' : ''}</span>` : ''}
                         ${skills.length ? /*html*/`<span><dot></dot> ${skills.length} skill collection${skills.length !== 1 ? 's' : ''}</span>` : ''}
                         ${interactions.length ? /*html*/`<span><dot></dot> ${interactions.length} interaction collection${interactions.length !== 1 ? 's' : ''}</span>` : ''}
                         ${types.length ? /*html*/`<span><dot></dot> ${types.length} content type collection${types.length !== 1 ? 's' : ''}</span>` : ''}
@@ -886,7 +895,7 @@ export function indexPage(
                 type="search"
                 id="collection-search"
                 class="search-input"
-                placeholder="Search tools, skills, interactions, types, templates..."
+                placeholder="Search tools, activities, skills, interactions, types, templates..."
                 aria-label="Search collections"
                 autocomplete="off"
             />
@@ -910,6 +919,22 @@ export function indexPage(
         </section>
         ` : ''}
 
+        ${activities.length > 0 ? /*html*/`
+        <section data-section="activities">
+            <hr>
+            <div class="section-header">
+                <h2>Activity Collections</h2>
+                <p class="section-subtitle">Remote activities for DSL workflows, invoked via HTTP.</p>
+            </div>
+            <div class="card-grid">
+                ${activities.map((a: ActivityCollection) => {
+        const count = a.getActivityDefinitions().length;
+        return collectionCard(a, 'activities', `${count} activit${count !== 1 ? 'ies' : 'y'}`);
+    }).join('')}
+            </div>
+        </section>
+        ` : ''}
+
         ${skills.length > 0 ? /*html*/`
         <section data-section="skills">
             <hr>
@@ -1227,3 +1252,119 @@ export function contentTypeCollectionPage(collection: ContentTypesCollection): s
 </body>
 </html>`;
 }
+
+/**
+ * Render a detailed activity card
+ */
+export function activityDetailCard(activity: RemoteActivityDefinition, collectionName: string): string {
+    const schema = activity.input_schema;
+    const properties = schema?.properties as Record<string, unknown> | undefined;
+    const required = (schema as Record<string, unknown>)?.required as string[] | undefined;
+
+    return /*html*/`
+<div class="detail-card">
+    <div class="detail-header">
+        <div>
+            <h3 class="detail-title">${activity.name}</h3>
+            <p class="detail-desc">${activity.description || 'No description'}</p>
+        </div>
+        <div class="detail-badges">
+            <span class="badge" style="background: #ec4899; color: white;">Activity</span>
+        </div>
+    </div>
+    <div class="detail-body">
+        <div class="detail-section">
+            <h4 class="detail-section-title">Endpoint</h4>
+            <div class="endpoint-box">
+                <code>POST ${activity.url || `/api/activities/${collectionName}`}</code>
+                <button class="copy-btn" onclick="navigator.clipboard.writeText('${activity.url || `/api/activities/${collectionName}`}')" title="Copy">
+                    ${copyIcon}
+                </button>
+            </div>
+        </div>
+
+        ${schema ? /*html*/`
+        <div class="detail-section">
+            <h4 class="detail-section-title">Input Schema</h4>
+            ${properties ? /*html*/`
+            <div class="info-grid" style="margin-bottom: 1rem;">
+                ${Object.entries(properties).map(([key, value]) => {
+        const prop = value as Record<string, unknown>;
+        const isRequired = required?.includes(key);
+        return /*html*/`
+                    <div class="info-item">
+                        <div class="info-label">${key}${isRequired ? ' *' : ''}</div>
+                        <div class="info-value">
+                            <code>${prop.type || 'any'}</code>
+                            ${prop.description ? `<br><span style="color: #6b7280; font-size: 0.85rem;">${prop.description}</span>` : ''}
+                        </div>
+                    </div>`;
+    }).join('')}
+            </div>
+            ` : ''}
+            <details>
+                <summary style="cursor: pointer; color: #6b7280; font-size: 0.85rem;">View full schema</summary>
+                <div class="schema-block" style="margin-top: 0.75rem;">${highlightJson(schema)}</div>
+            </details>
+        </div>
+        ` : /*html*/`
+        <div class="detail-section">
+            <div class="empty-state">No input schema defined</div>
+        </div>
+        `}
+
+        ${activity.output_schema ? /*html*/`
+        <div class="detail-section">
+            <h4 class="detail-section-title">Output Schema</h4>
+            <details>
+                <summary style="cursor: pointer; color: #6b7280; font-size: 0.85rem;">View output schema</summary>
+                <div class="schema-block" style="margin-top: 0.75rem;">${highlightJson(activity.output_schema)}</div>
+            </details>
+        </div>
+        ` : ''}
+    </div>
+</div>`;
+}
+
+/**
+ * Render an activity collection detail page
+ */
+export function activityCollectionPage(collection: ActivityCollection): string {
+    const activitiesArray = collection.getActivityDefinitions();
+    return /*html*/`
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>${collection.title || collection.name} - Activities</title>
+    <style>${detailStyles}</style>
+</head>
+<body>
+    <nav class="nav">
+        <a href="/">${backArrow} Back to all collections</a>
+    </nav>
+
+    <div class="header">
+        <div class="header-icon">${collection.icon || activityIcon}</div>
+        <div>
+            <h1>${collection.title || collection.name}</h1>
+            <p style="color: #6b7280; margin: 0.25rem 0 0 0;">${collection.description || ''}</p>
+            <div class="endpoint-box">
+                <code>/api/activities/${collection.name}</code>
+                <button class="copy-btn" onclick="navigator.clipboard.writeText(window.location.origin + '/api/activities/${collection.name}')" title="Copy endpoint URL">
+                    ${copyIcon}
+                </button>
+            </div>
+        </div>
+    </div>
+
+    <h2>${activitiesArray.length} Activit${activitiesArray.length !== 1 ? 'ies' : 'y'}</h2>
+
+    ${activitiesArray.length > 0 ?
+            activitiesArray.map(activity => activityDetailCard(activity, collection.name)).join('') :
+            '<div class="empty-state">No activities in this collection</div>'
+        }
+</body>
+</html>`;
+}