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

package/src/site/templates.ts

@@ -2,6 +2,7 @@ import type { InteractionCollection } from "../InteractionCollection.js";
 import { ToolServerConfig } from "../server/types.js";
 import type { SkillCollection } from "../SkillCollection.js";
 import type { ToolCollection } from "../ToolCollection.js";
+import type { ContentTypesCollection } from "../ContentTypesCollection.js";
 import type { ICollection, SkillDefinition, Tool } from "../types.js";
 import { join } from "../utils.js";
 import { baseStyles } from "./styles.js";
@@ -230,43 +231,6 @@ ${baseStyles}
     white-space: pre-wrap;
 }
 
-.endpoint-box {
-    display: flex;
-    align-items: center;
-    gap: 0.75rem;
-    background: #f3f4f6;
-    padding: 0.75rem 1rem;
-    border-radius: 8px;
-    margin-top: 0.5rem;
-}
-
-.endpoint-box code {
-    flex: 1;
-    font-family: ui-monospace, monospace;
-    font-size: 0.875rem;
-    color: #1f2937;
-}
-
-.copy-btn {
-    background: #e5e7eb;
-    border: none;
-    padding: 0.5rem;
-    border-radius: 6px;
-    cursor: pointer;
-    color: #6b7280;
-    transition: all 0.15s;
-}
-
-.copy-btn:hover {
-    background: #d1d5db;
-    color: #374151;
-}
-
-.copy-btn svg {
-    width: 16px;
-    height: 16px;
-}
-
 .empty-state {
     text-align: center;
     padding: 3rem;
@@ -347,24 +311,6 @@ ${baseStyles}
         color: #e5e7eb;
     }
 
-    .endpoint-box {
-        background: rgba(31, 41, 55, 0.95);
-    }
-
-    .endpoint-box code {
-        color: #e5e7eb;
-    }
-
-    .copy-btn {
-        background: rgba(55, 65, 81, 0.95);
-        color: #e5e7eb;
-    }
-
-    .copy-btn:hover {
-        background: rgba(75, 85, 99, 0.98);
-        color: #f9fafb;
-    }
-
     .empty-state {
         color: #9ca3af;
     }
@@ -719,6 +665,7 @@ export function indexPage(
         tools = [],
         interactions = [],
         skills = [],
+        types = [],
         mcpProviders = [],
         hideUILinks = false,
     } = config;
@@ -744,12 +691,13 @@ export function indexPage(
                     <p class="hero-eyebrow">Tools Server</p>
                     <h1 class="hero-title">${title}</h1>
                     <p class="hero-tagline">
-                        Discover the tools, skills, and interactions exposed by this server.
+                        Discover the tools, 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>` : ''}
                         ${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>` : ''}
                         ${mcpProviders.length ? /*html*/`<span><dot></dot> ${mcpProviders.length} MCP provider${mcpProviders.length !== 1 ? 's' : ''}</span>` : ''}
                     </div>
                     ${hideUILinks ? '' : renderUILinks()}
@@ -758,6 +706,13 @@ export function indexPage(
             <aside class="hero-panel">
                 <div class="hero-panel-label">Base endpoint</div>
                 <div class="hero-panel-endpoint"><code>/api</code></div>
+                <div class="hero-panel-label" style="margin-top: 1rem;">Package endpoint</div>
+                <div class="endpoint-box" style="margin-top: 0.5rem;">
+                    <code id="package-endpoint-url">/api/package</code>
+                    <button class="copy-btn" onclick="copyPackageUrl(this)" title="Copy package endpoint URL">
+                        ${copyIcon}
+                    </button>
+                </div>
                 <p class="hero-panel-hint">
                     Use <strong>POST /api/tools/&lt;collection&gt;</strong> or
                     <strong>POST /api/skills/&lt;collection&gt;</strong> to call these from your apps or agents.
@@ -770,7 +725,7 @@ export function indexPage(
                 type="search"
                 id="collection-search"
                 class="search-input"
-                placeholder="Search tools, skills, interactions..."
+                placeholder="Search tools, skills, interactions, types..."
                 aria-label="Search collections"
                 autocomplete="off"
             />
@@ -823,6 +778,22 @@ export function indexPage(
         </section>
         ` : ''}
 
+        ${types.length > 0 ? /*html*/`
+        <section data-section="types">
+            <hr>
+            <div class="section-header">
+                <h2>Content Type Collections</h2>
+                <p class="section-subtitle">Schema definitions for structured content in the data store.</p>
+            </div>
+            <div class="card-grid">
+                ${types.map((t: ContentTypesCollection) => {
+        const count = t.getContentTypes().length;
+        return collectionCard(t, 'types', `${count} type${count !== 1 ? 's' : ''}`);
+    }).join('')}
+            </div>
+        </section>
+        ` : ''}
+
         ${mcpProviders.length > 0 ? /*html*/`
         <section data-section="mcp">
             <hr>
@@ -884,6 +855,18 @@ export function indexPage(
             update(input.value);
         });
     }());
+
+    function copyPackageUrl(btn) {
+        var url = window.location.origin + '/api/package';
+        navigator.clipboard.writeText(url);
+        var originalHtml = btn.innerHTML;
+        btn.innerHTML = '✓';
+        btn.style.color = '#10b981';
+        setTimeout(function() {
+            btn.innerHTML = originalHtml;
+            btn.style.color = '#6b7280';
+        }, 1500);
+    }
     </script>
 </body>
 </html>`;
@@ -976,19 +959,10 @@ export function skillCollectionPage(collection: SkillCollection): string {
 }
 
 /**
- * Render an interaction collection detail page
+ * Render a collection header with icon, title, description, and endpoint
  */
-export function interactionCollectionPage(collection: InteractionCollection): string {
+function collectionDetailHeader(collection: ICollection, pathPrefix: string): string {
     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} - Interactions</title>
-    <style>${detailStyles}</style>
-</head>
-<body>
     <nav class="nav">
         <a href="/">${backArrow} Back to all collections</a>
     </nav>
@@ -999,30 +973,79 @@ export function interactionCollectionPage(collection: InteractionCollection): st
             <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/interactions/${collection.name}</code>
-                <button class="copy-btn" onclick="navigator.clipboard.writeText(window.location.origin + '/api/interactions/${collection.name}')" title="Copy endpoint URL">
+                <code>/api/${pathPrefix}/${collection.name}</code>
+                <button class="copy-btn" onclick="navigator.clipboard.writeText(window.location.origin + '/api/${pathPrefix}/${collection.name}')" title="Copy endpoint URL">
                     ${copyIcon}
                 </button>
             </div>
         </div>
-    </div>
+    </div>`;
+}
+
+/**
+ * Render a simple item card with name, description, and tags
+ */
+function simpleItemCard(item: { name: string; description?: string; tags?: string[] }): string {
+    return /*html*/`
+    <div class="detail-card">
+        <div class="detail-header">
+            <div>
+                <h3 class="detail-title">${item.name}</h3>
+                <p class="detail-desc">${item.description || 'No description'}</p>
+            </div>
+            <div class="detail-badges">
+                ${item.tags?.map(tag => `<span class="badge">${tag}</span>`).join('') || ''}
+            </div>
+        </div>
+    </div>`;
+}
+
+/**
+ * Render an interaction collection detail page
+ */
+export function interactionCollectionPage(collection: InteractionCollection): string {
+    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} - Interactions</title>
+    <style>${detailStyles}</style>
+</head>
+<body>
+    ${collectionDetailHeader(collection, 'interactions')}
 
     <h2>${collection.interactions.length} Interaction${collection.interactions.length !== 1 ? 's' : ''}</h2>
 
     <div class="item-list">
-        ${collection.interactions.map(inter => /*html*/`
-        <div class="detail-card">
-            <div class="detail-header">
-                <div>
-                    <h3 class="detail-title">${inter.name}</h3>
-                    <p class="detail-desc">${inter.description || 'No description'}</p>
-                </div>
-                <div class="detail-badges">
-                    ${inter.tags?.map(tag => `<span class="badge">${tag}</span>`).join('') || ''}
-                </div>
-            </div>
-        </div>
-        `).join('')}
+        ${collection.interactions.map(inter => simpleItemCard(inter)).join('')}
+    </div>
+</body>
+</html>`;
+}
+
+/**
+ * Render a content type collection detail page
+ */
+export function contentTypeCollectionPage(collection: ContentTypesCollection): string {
+    const typesArray = collection.getContentTypes();
+    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} - Content Types</title>
+    <style>${detailStyles}</style>
+</head>
+<body>
+    ${collectionDetailHeader(collection, 'types')}
+
+    <h2>${typesArray.length} Content Type${typesArray.length !== 1 ? 's' : ''}</h2>
+
+    <div class="item-list">
+        ${typesArray.map(type => simpleItemCard(type)).join('')}
     </div>
 </body>
 </html>`;

package/src/types.ts

@@ -1,6 +1,6 @@
 import type { ToolDefinition, ToolUse } from "@llumiverse/common";
 import { VertesiaClient } from "@vertesia/client";
-import { AuthTokenPayload, ToolExecutionMetadata, ToolResult, ToolResultContent } from "@vertesia/common";
+import { AgentToolDefinition, AuthTokenPayload, ProjectConfiguration, ToolExecutionMetadata, ToolResult, ToolResultContent } from "@vertesia/common";
 
 export type { ToolExecutionMetadata };
 
@@ -87,6 +87,15 @@ export interface ToolExecutionPayload<ParamsT extends Record<string, any>> {
 
 export type ToolFn<ParamsT extends Record<string, any>> = (payload: ToolExecutionPayload<ParamsT>, context: ToolExecutionContext) => Promise<ToolExecutionResult>;
 
+export interface ToolUseContext {
+    project_id?: string,
+    account_id?: string,
+    project_name?: string,
+    project_ns?: string,
+    configuration?: ProjectConfiguration;
+    vars?: Record<string, any>;
+}
+
 export interface Tool<ParamsT extends Record<string, any>> extends ToolDefinition {
     run: ToolFn<ParamsT>;
     /**
@@ -95,25 +104,18 @@ export interface Tool<ParamsT extends Record<string, any>> extends ToolDefinitio
      * - false: Tool is only available when activated by a skill's related_tools
      */
     default?: boolean;
-}
 
-/**
- * Tool definition with optional activation control for agent exposure.
- */
-export interface ToolDefinitionWithDefault extends ToolDefinition {
     /**
-     * Whether this tool is available by default.
-     * - true/undefined: Tool is always available to agents
-     * - false: Tool is only available when activated by a skill's related_tools
+     * Optional filter to check if the tool is enabled for the given project configuration.
+     * This can be used to dynamically enable/disable tools based on project settings, environment variables, or any other logic.
+     * If no filter is provided, the tool will be enabled by default.
+     * @param payload 
+     * @returns 
      */
-    default?: boolean;
-    /**
-     * For skill tools (learn_*): list of related tool names that become available
-     * when this skill is called. Used for dynamic tool discovery.
-     */
-    related_tools?: string[];
+    isEnabled?: (payload: ToolUseContext) => boolean;
 }
 
+
 /**
  * The interface that should be returned when requesting a collection endpoint using a GET
  */
@@ -121,7 +123,7 @@ export interface ToolCollectionDefinition {
     title: string;
     description: string;
     src: string;
-    tools: ToolDefinitionWithDefault[];
+    tools: AgentToolDefinition[];
 }
 
 export type { ToolDefinition };
@@ -143,6 +145,11 @@ export interface MCPConnectionDetails {
      * If an empty string no authentication will be done
      */
     token: string;
+    /**
+     * Optional additional HTTP headers to include with requests to the MCP server.
+     * Merged with the Authorization header derived from the token.
+     */
+    headers?: Record<string, string>;
 }
 
 // ================== Skill Types ==================
@@ -250,6 +257,16 @@ export interface SkillDefinition {
      * The widget file must be located in the skill directory under the name {{widget-name}}.tsx.
      */
     widgets?: string[];
+
+    /**
+     * Optional filter to check if the tool is enabled for the given project configuration.
+     * This can be used to dynamically enable/disable tools based on project settings, environment variables, or any other logic.
+     * If no filter is provided, the tool will be enabled by default.
+     * @param payload 
+     * @returns 
+     */
+    isEnabled?: (payload: ToolUseContext) => boolean;
+
 }
 
 /**

package/src/utils.ts

@@ -1,3 +1,16 @@
+/**
+ * Convert a name to a URL-safe path segment.
+ * If the name contains spaces or underscores, convert to PascalCase.
+ * Otherwise return as-is. Any characters not in [a-zA-Z0-9$_\-@] are replaced with '-'.
+ */
+export function toPathName(name: string): string {
+    let result = name;
+    if (result.includes(' ') || result.includes('_')) {
+        result = result.split(/[\s_]+/).map(w => w.charAt(0).toUpperCase() + w.slice(1)).join('');
+    }
+    return result.replace(/[^a-zA-Z0-9$_\-@]/g, '-');
+}
+
 export function kebabCaseToTitle(name: string) {
     return name.split('-').map(p => p[0].toUpperCase() + p.substring(1)).join(' ');
 }
@@ -20,4 +33,5 @@ export function join(left: string, right: string) {
     } else {
         return left + '/' + right;
     }
-}
+}
+