@vertesia/tools-sdk 0.24.0-dev.202601221707

package/LICENSE

@@ -0,0 +1,13 @@
+Copyright 2024 Composable
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,122 @@
+# @vertesia/tools-sdk
+
+SDK for building remote tools, interactions, and skills that integrate with the Vertesia platform. Built on top of [Hono](https://hono.dev/) for lightweight, high-performance HTTP servers.
+
+## Installation
+
+```bash
+npm install @vertesia/tools-sdk hono
+# or
+pnpm add @vertesia/tools-sdk hono
+```
+
+## Quick Start
+
+```typescript
+import { createToolServer, ToolCollection } from "@vertesia/tools-sdk";
+
+// Define a tool collection
+const myTools = new ToolCollection({
+  name: "my-tools",
+  description: "My custom tools",
+  tools: [
+    {
+      name: "hello",
+      description: "Says hello",
+      parameters: {
+        type: "object",
+        properties: {
+          name: { type: "string", description: "Name to greet" },
+        },
+        required: ["name"],
+      },
+      execute: async ({ name }) => {
+        return { message: `Hello, ${name}!` };
+      },
+    },
+  ],
+});
+
+// Create the server
+const server = createToolServer({
+  title: "My Tools Server",
+  tools: [myTools],
+});
+
+export default server;
+```
+
+## Features
+
+### Tool Collections
+
+Define collections of tools that can be called remotely:
+
+```typescript
+import { ToolCollection } from "@vertesia/tools-sdk";
+
+const tools = new ToolCollection({
+  name: "utilities",
+  description: "Utility tools",
+  tools: [/* tool definitions */],
+});
+```
+
+### Skill Collections
+
+Define skills that can be executed by agents:
+
+```typescript
+import { SkillCollection } from "@vertesia/tools-sdk";
+
+const skills = new SkillCollection({
+  name: "my-skills",
+  description: "Custom skills",
+  skills: [/* skill definitions */],
+});
+```
+
+### Interaction Collections
+
+Expose interactions for execution:
+
+```typescript
+import { InteractionCollection } from "@vertesia/tools-sdk";
+
+const interactions = new InteractionCollection({
+  name: "my-interactions",
+  interactions: [/* interaction refs */],
+});
+```
+
+### Server Configuration
+
+```typescript
+const server = createToolServer({
+  title: "My Server",           // HTML page title
+  prefix: "/api",               // API route prefix (default: '/api')
+  tools: [toolCollection],      // Tool collections
+  skills: [skillCollection],    // Skill collections
+  interactions: [interactionCollection], // Interaction collections
+  disableHtml: false,           // Disable HTML documentation pages
+});
+```
+
+### Authentication
+
+The SDK includes built-in JWT authentication:
+
+```typescript
+import { authorize } from "@vertesia/tools-sdk";
+
+// In your route handler
+const session = await authorize(request);
+```
+
+## API Reference
+
+For detailed API documentation, visit [docs.vertesiahq.com](https://docs.vertesiahq.com).
+
+## License
+
+Apache-2.0

package/lib/cjs/InteractionCollection.js

@@ -0,0 +1,164 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InteractionCollection = void 0;
+exports.loadInteractionsFromDirectory = loadInteractionsFromDirectory;
+exports.readPromptFile = readPromptFile;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const url_1 = require("url");
+const utils_js_1 = require("./utils.js");
+class InteractionCollection {
+    interactions;
+    name;
+    title;
+    icon;
+    description;
+    constructor({ name, title, icon, description, interactions }) {
+        this.name = name;
+        this.title = title || (0, utils_js_1.kebabCaseToTitle)(name);
+        this.icon = icon;
+        this.description = description;
+        this.interactions = interactions;
+    }
+    addInteraction(interaction) {
+        this.interactions.push(interaction);
+    }
+    getInteractions() {
+        return this.interactions;
+    }
+    [Symbol.iterator]() {
+        let index = 0;
+        const interactions = this.interactions;
+        return {
+            next() {
+                if (index < interactions.length) {
+                    return { value: interactions[index++], done: false };
+                }
+                else {
+                    return { done: true, value: undefined };
+                }
+            }
+        };
+    }
+    map(callback) {
+        return this.interactions.map(callback);
+    }
+    getInteractionByName(name) {
+        return this.interactions.find(interaction => interaction.name === name);
+    }
+}
+exports.InteractionCollection = InteractionCollection;
+/**
+ * Load all interactions from a directory.
+ * Scans for subdirectories containing index.ts/index.js files.
+ *
+ * Directory structure:
+ * ```
+ * interactions/
+ *   nagare/
+ *     extract-fund-actuals/
+ *       index.ts       # exports default InteractionSpec
+ *       prompt.jst     # prompt template (read via readPromptFile helper)
+ *     parse-fund-document/
+ *       index.ts
+ *       prompt.md
+ * ```
+ *
+ * @param interactionsDir - Path to the interactions collection directory
+ * @returns Promise resolving to array of InteractionSpec objects
+ */
+async function loadInteractionsFromDirectory(interactionsDir) {
+    const interactions = [];
+    if (!(0, fs_1.existsSync)(interactionsDir)) {
+        console.warn(`Interactions directory not found: ${interactionsDir}`);
+        return interactions;
+    }
+    let entries;
+    try {
+        entries = (0, fs_1.readdirSync)(interactionsDir);
+    }
+    catch {
+        console.warn(`Could not read interactions directory: ${interactionsDir}`);
+        return interactions;
+    }
+    for (const entry of entries) {
+        // Skip hidden files and index files
+        if (entry.startsWith('.'))
+            continue;
+        if (entry === 'index.ts' || entry === 'index.js')
+            continue;
+        const entryPath = (0, path_1.join)(interactionsDir, entry);
+        try {
+            const stat = (0, fs_1.statSync)(entryPath);
+            if (!stat.isDirectory())
+                continue;
+            // Look for index.ts or index.js in the subdirectory
+            const indexTs = (0, path_1.join)(entryPath, 'index.ts');
+            const indexJs = (0, path_1.join)(entryPath, 'index.js');
+            const indexPath = (0, fs_1.existsSync)(indexTs) ? indexTs : (0, fs_1.existsSync)(indexJs) ? indexJs : null;
+            if (!indexPath) {
+                continue; // No index file, skip
+            }
+            // Dynamic import
+            const fileUrl = (0, url_1.pathToFileURL)(indexPath).href;
+            const module = await Promise.resolve(`${fileUrl}`).then(s => __importStar(require(s)));
+            const interaction = module.default || module.interaction;
+            if (interaction && typeof interaction.name === 'string') {
+                interactions.push(interaction);
+            }
+            else {
+                console.warn(`No valid InteractionSpec export found in ${entry}/index`);
+            }
+        }
+        catch (err) {
+            console.warn(`Error loading interaction from ${entry}:`, err);
+        }
+    }
+    return interactions;
+}
+/**
+ * Helper to read a prompt file from the same directory as the interaction.
+ * Use this in interaction index.ts files to load prompt templates.
+ *
+ * @param dirname - Pass __dirname or dirname(fileURLToPath(import.meta.url))
+ * @param filename - Prompt filename (e.g., 'prompt.jst' or 'prompt.md')
+ * @returns File contents as string
+ */
+function readPromptFile(dirname, filename) {
+    const filePath = (0, path_1.join)(dirname, filename);
+    return (0, fs_1.readFileSync)(filePath, 'utf-8');
+}
+//# sourceMappingURL=InteractionCollection.js.map

package/lib/cjs/InteractionCollection.js.map

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

package/lib/cjs/SkillCollection.js

@@ -0,0 +1,376 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SkillCollection = void 0;
+exports.parseSkillFile = parseSkillFile;
+exports.loadSkillFromFile = loadSkillFromFile;
+exports.loadSkillsFromDirectory = loadSkillsFromDirectory;
+const fs_1 = require("fs");
+const http_exception_1 = require("hono/http-exception");
+const path_1 = require("path");
+const utils_js_1 = require("./utils.js");
+/**
+ * Implements a skills collection endpoint.
+ * Skills provide contextual instructions to agents.
+ * They can be static (markdown) or dynamic (JST templates).
+ */
+class SkillCollection {
+    /**
+     * A kebab case collection name
+     */
+    name;
+    /**
+     * Optional title for UI display
+     */
+    title;
+    /**
+     * Optional icon for UI display
+     */
+    icon;
+    /**
+     * A short description
+     */
+    description;
+    /**
+     * The skills in this collection
+     */
+    skills;
+    constructor({ name, title, icon, description, skills }) {
+        this.name = name;
+        this.title = title || (0, utils_js_1.kebabCaseToTitle)(name);
+        this.icon = icon;
+        this.description = description;
+        this.skills = new Map(skills.map(s => [s.name, s]));
+    }
+    [Symbol.iterator]() {
+        return this.skills.values();
+    }
+    map(callback) {
+        return Array.from(this.skills.values()).map(callback);
+    }
+    /**
+     * Get a skill by name
+     */
+    getSkill(name) {
+        return this.skills.get(name);
+    }
+    /**
+     * Get all skill definitions
+     */
+    getSkillDefinitions() {
+        return Array.from(this.skills.values());
+    }
+    /**
+     * Get skills exposed as tool definitions.
+     * This allows skills to appear alongside regular tools.
+     * When called, they return rendered instructions.
+     * Includes related_tools for dynamic tool discovery.
+     */
+    getToolDefinitions() {
+        const defaultSchema = {
+            type: 'object',
+            properties: {
+                context: {
+                    type: "string",
+                    description: "Additional context or specific requirements for this task"
+                }
+            }
+        };
+        return Array.from(this.skills.values()).map(skill => {
+            // Build description with related tools info if available
+            let description = `[Skill] ${skill.description}. Returns contextual instructions for this task.`;
+            if (skill.related_tools && skill.related_tools.length > 0) {
+                description += ` Unlocks tools: ${skill.related_tools.join(', ')}.`;
+            }
+            return {
+                name: `learn_${skill.name}`,
+                description,
+                input_schema: skill.input_schema || defaultSchema,
+                related_tools: skill.related_tools,
+            };
+        });
+    }
+    /**
+     * Get as a tool collection definition (for listing alongside tools)
+     */
+    getAsToolCollection(baseUrl) {
+        return {
+            title: this.title || this.name,
+            description: this.description || `Skills: ${this.name}`,
+            src: `${baseUrl}/api/skills/${this.name}`,
+            tools: this.getToolDefinitions()
+        };
+    }
+    getWidgets() {
+        const out = [];
+        for (const skill of this.skills.values()) {
+            if (skill.widgets) {
+                for (const widget of skill.widgets) {
+                    out.push({
+                        name: widget,
+                        skill: skill.name,
+                    });
+                }
+            }
+        }
+        return Array.from(out);
+    }
+    /**
+     * Execute a skill - accepts standard tool execution payload.
+     * Returns rendered instructions in tool result format.
+     *
+     * @param ctx - Hono context
+     * @param preParsedPayload - Optional pre-parsed payload (used when routing from root endpoint)
+     */
+    async execute(ctx, preParsedPayload) {
+        const toolCtx = ctx;
+        let payload = preParsedPayload;
+        try {
+            if (!payload) {
+                // Check if body was already parsed and validated by middleware
+                if (toolCtx.payload) {
+                    payload = toolCtx.payload;
+                }
+                else {
+                    throw new http_exception_1.HTTPException(400, {
+                        message: 'Invalid or missing skill execution payload. Expected { tool_use: { id, tool_name, tool_input? }, metadata? }'
+                    });
+                }
+            }
+            const toolName = payload.tool_use.tool_name;
+            // Extract skill name from tool name (remove "learn_" prefix if present)
+            const skillName = toolName.startsWith('learn_')
+                ? toolName.replace('learn_', '')
+                : toolName;
+            const skill = this.skills.get(skillName);
+            if (!skill) {
+                console.warn("[SkillCollection] Skill not found", {
+                    collection: this.name,
+                    requestedSkill: skillName,
+                    toolName,
+                    availableSkills: Array.from(this.skills.keys()),
+                });
+                throw new http_exception_1.HTTPException(404, {
+                    message: `Skill not found: ${skillName}`
+                });
+            }
+            const data = payload.tool_use.tool_input || {};
+            const result = await this.renderSkill(skill, data);
+            // TODO: If skill.execution is set, run via Daytona
+            // Return in tool result format
+            return ctx.json({
+                tool_use_id: payload.tool_use.id,
+                is_error: false,
+                content: result.instructions,
+                meta: {
+                    skill_name: skill.name,
+                    content_type: skill.content_type,
+                    execution: skill.execution,
+                }
+            });
+        }
+        catch (err) {
+            const status = err.status || 500;
+            const toolName = payload?.tool_use?.tool_name;
+            const toolUseId = payload?.tool_use?.id;
+            if (status >= 500) {
+                console.error("[SkillCollection] Skill execution failed", {
+                    collection: this.name,
+                    skill: toolName,
+                    toolUseId,
+                    error: err.message,
+                    status,
+                    toolInput: payload?.tool_use?.tool_input,
+                    stack: err.stack,
+                });
+            }
+            return ctx.json({
+                tool_use_id: toolUseId || "unknown",
+                is_error: true,
+                content: err.message || "Error executing skill",
+            }, status);
+        }
+    }
+    /**
+     * Render skill instructions (static or dynamic)
+     */
+    async renderSkill(skill, _data) {
+        const instructions = skill.instructions;
+        if (skill.content_type === 'jst') {
+            // JST templates are not currently supported
+            throw new http_exception_1.HTTPException(501, {
+                message: `JST templates are not currently supported. Use 'md' content type instead.`
+            });
+        }
+        return {
+            name: skill.name,
+            instructions,
+        };
+    }
+}
+exports.SkillCollection = SkillCollection;
+/**
+ * Parse a SKILL.md or SKILL.jst file content into a SkillDefinition.
+ *
+ * Format:
+ * ```
+ * ---
+ * name: skill-name
+ * description: Short description
+ * keywords: [keyword1, keyword2]
+ * tools: [tool1, tool2]
+ * language: python
+ * packages: [numpy, pandas]
+ * ---
+ *
+ * # Instructions
+ *
+ * Your markdown/jst content here...
+ * ```
+ */
+function parseSkillFile(content, contentType) {
+    // Parse YAML frontmatter
+    const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+    if (!frontmatterMatch) {
+        throw new Error("Invalid skill file: missing YAML frontmatter");
+    }
+    const [, yamlContent, body] = frontmatterMatch;
+    const frontmatter = parseYamlFrontmatter(yamlContent);
+    const instructions = body.trim();
+    if (!frontmatter.name) {
+        throw new Error("Skill file missing required 'name' field");
+    }
+    if (!frontmatter.description) {
+        throw new Error("Skill file missing required 'description' field");
+    }
+    const skill = {
+        name: frontmatter.name,
+        title: frontmatter.title,
+        description: frontmatter.description,
+        instructions,
+        content_type: contentType,
+        widgets: frontmatter.widgets || undefined,
+        scripts: frontmatter.scripts || undefined,
+    };
+    // Build context triggers
+    if (frontmatter.keywords || frontmatter.tools || frontmatter.data_patterns) {
+        skill.context_triggers = {
+            keywords: frontmatter.keywords,
+            tool_names: frontmatter.tools,
+            data_patterns: frontmatter.data_patterns,
+        };
+    }
+    // Build execution config
+    if (frontmatter.language) {
+        skill.execution = {
+            language: frontmatter.language,
+            packages: frontmatter.packages,
+            system_packages: frontmatter.system_packages,
+        };
+        // Extract code template from instructions if present
+        const codeBlockMatch = instructions.match(/```(?:python|javascript|typescript|js|ts|py)\n([\s\S]*?)```/);
+        if (codeBlockMatch) {
+            skill.execution.template = codeBlockMatch[1].trim();
+        }
+    }
+    // Related tools from frontmatter
+    if (frontmatter.tools) {
+        skill.related_tools = frontmatter.tools;
+    }
+    return skill;
+}
+/**
+ * Simple YAML frontmatter parser (handles basic key: value and arrays)
+ */
+function parseYamlFrontmatter(yaml) {
+    const result = {};
+    const lines = yaml.split('\n');
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#'))
+            continue;
+        const colonIndex = trimmed.indexOf(':');
+        if (colonIndex === -1)
+            continue;
+        const key = trimmed.slice(0, colonIndex).trim();
+        let value = trimmed.slice(colonIndex + 1).trim();
+        // Handle array syntax: [item1, item2]
+        if (value.startsWith('[') && value.endsWith(']')) {
+            const items = value.slice(1, -1).split(',').map(s => s.trim());
+            result[key] = items.filter(s => s.length > 0);
+        }
+        else {
+            // Remove quotes if present
+            if ((value.startsWith('"') && value.endsWith('"')) ||
+                (value.startsWith("'") && value.endsWith("'"))) {
+                value = value.slice(1, -1);
+            }
+            result[key] = value;
+        }
+    }
+    return result;
+}
+/**
+ * Helper to load skill from file path (for Node.js usage)
+ */
+async function loadSkillFromFile(filePath, fs) {
+    const content = await fs.readFile(filePath, 'utf-8');
+    const contentType = filePath.endsWith('.jst') ? 'jst' : 'md';
+    return parseSkillFile(content, contentType);
+}
+/**
+ * Load all skills from a directory.
+ * Scans for subdirectories containing SKILL.md files.
+ *
+ * Directory structure:
+ * ```
+ * skills/
+ *   nagare/
+ *     fund-onboarding/
+ *       SKILL.md
+ *     monte-carlo/
+ *       SKILL.md
+ * ```
+ *
+ * @param dirPath - Path to the skills collection directory
+ * @returns Array of parsed skill definitions
+ */
+function loadSkillsFromDirectory(dirPath) {
+    const skills = [];
+    let entries;
+    try {
+        entries = (0, fs_1.readdirSync)(dirPath);
+    }
+    catch {
+        console.warn(`Could not read skills directory: ${dirPath}`);
+        return skills;
+    }
+    for (const entry of entries) {
+        const entryPath = (0, path_1.join)(dirPath, entry);
+        try {
+            const stat = (0, fs_1.statSync)(entryPath);
+            if (!stat.isDirectory())
+                continue;
+            // Look for SKILL.md or SKILL.jst
+            const mdPath = (0, path_1.join)(entryPath, "SKILL.md");
+            const jstPath = (0, path_1.join)(entryPath, "SKILL.jst");
+            let content;
+            let contentType = 'md';
+            if ((0, fs_1.existsSync)(mdPath)) {
+                content = (0, fs_1.readFileSync)(mdPath, "utf-8");
+                contentType = 'md';
+            }
+            else if ((0, fs_1.existsSync)(jstPath)) {
+                content = (0, fs_1.readFileSync)(jstPath, "utf-8");
+                contentType = 'jst';
+            }
+            if (content) {
+                skills.push(parseSkillFile(content, contentType));
+            }
+        }
+        catch (err) {
+            console.warn(`Error loading skill from ${entryPath}:`, err);
+        }
+    }
+    return skills;
+}
+//# sourceMappingURL=SkillCollection.js.map