@vertesia/tools-sdk 1.0.0-dev.20260203.130115Z → 1.0.0-dev.20260227.112605Z

package/lib/types/server/types.d.ts

@@ -0,0 +1,93 @@
+import { Context } from "hono";
+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";
+/**
+ * Extended context with parsed payload for tool/skill execution
+ */
+export interface ToolContext extends Context {
+    /** The parsed request payload */
+    payload?: ToolExecutionPayload<any>;
+    /** The tool_use.id from the payload */
+    toolUseId?: string;
+    /** The tool_use.tool_name from the payload */
+    toolName?: string;
+}
+/**
+ * MCP Provider interface for server configuration
+ */
+export interface MCPProviderConfig {
+    name: string;
+    description?: string;
+    createMCPConnection: (session: any, config: Record<string, any>) => Promise<{
+        name: string;
+        url: string;
+        token: string;
+    }>;
+}
+/**
+ * Server configuration options
+ */
+export interface ToolServerConfig {
+    /**
+     * Server title for HTML pages (default: 'Tools Server')
+     */
+    title?: string;
+    /**
+     * API prefix (default: '/api')
+     */
+    prefix?: string;
+    /**
+     * Tool collections to expose
+     */
+    tools?: ToolCollection[];
+    /**
+     * Interaction collections to expose
+     */
+    interactions?: InteractionCollection[];
+    /**
+     * Content type collections to expose
+     */
+    types?: ContentTypesCollection[];
+    /**
+     * Skill collections to expose
+     */
+    skills?: SkillCollection[];
+    /**
+     * Template collections to expose
+     */
+    templates?: RenderingTemplateCollection[];
+    /**
+     * MCP providers to expose
+     */
+    mcpProviders?: MCPProviderConfig[];
+    /**
+     * A JSON schema defining settings for the application using this server
+     */
+    settings?: JSONSchema;
+    /**
+     * The UI configuration for the application using this server
+     */
+    uiConfig?: AppUIConfig;
+    /**
+     * Disable HTML pages (default: false)
+     */
+    disableHtml?: boolean;
+    /**
+     * Hide UI app links on the index page (default: false)
+     */
+    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.
+     * This allows for dynamic enabling/disabling of tools based on project settings.
+     * @param projectConfig
+     * @returns
+     */
+    toolFilter?: (projectConfig: ProjectConfiguration) => boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/types/server/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/server/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,OAAO;IACxC,iCAAiC;IACjC,OAAO,CAAC,EAAE,oBAAoB,CAAC,GAAG,CAAC,CAAC;IACpC,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC;QACxE,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;CACN;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB;;OAEG;IACH,YAAY,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACvC;;OAEG;IACH,KAAK,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACjC;;OAEG;IACH,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;IAC3B;;OAEG;IACH,SAAS,CAAC,EAAE,2BAA2B,EAAE,CAAC;IAC1C;;OAEG;IACH,YAAY,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAEnC;;OAEG;IACH,QAAQ,CAAC,EAAE,UAAU,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,EAAE,WAAW,CAAC;IAEvB;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,CAAC,aAAa,EAAE,oBAAoB,KAAK,OAAO,CAAC;CACjE"}

package/lib/types/server/widgets.d.ts

@@ -0,0 +1,4 @@
+import { Hono } from "hono";
+import { ToolServerConfig } from "./types.js";
+export declare function createWidgetsRoute(app: Hono, basePath: string, config: ToolServerConfig): void;
+//# sourceMappingURL=widgets.d.ts.map

package/lib/types/server/widgets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widgets.d.ts","sourceRoot":"","sources":["../../../src/server/widgets.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG9C,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,QA4BvF"}

package/lib/types/server.d.ts

@@ -0,0 +1,27 @@
+import { Context, Hono } from "hono";
+import { ToolServerConfig } from "./server/types.js";
+/**
+ * Create a Hono server for tools, interactions, and skills.
+ *
+ * @example
+ * ```typescript
+ * import { createToolServer, ToolCollection, SkillCollection } from "@vertesia/tools-sdk";
+ *
+ * const server = createToolServer({
+ *     tools: [myToolCollection],
+ *     skills: [mySkillCollection],
+ * });
+ *
+ * export default server;
+ * ```
+ */
+export declare function createToolServer(config: ToolServerConfig): Hono;
+/**
+ * Simple development server with static fimesale handling
+ *
+ * @deprecated Use tools server template
+ */
+export declare function createDevServer(config: ToolServerConfig & {
+    staticHandler?: (c: Context, next: () => Promise<void>) => Promise<Response | void>;
+}): Hono;
+//# sourceMappingURL=server.d.ts.map

package/lib/types/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AASrC,OAAO,EAAe,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAmBlE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAuG/D;AAMD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,GAAG;IACvD,aAAa,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;CACvF,GAAG,IAAI,CAQP"}

package/lib/types/site/styles.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Shared CSS styles for the tools server HTML pages
+ */
+export declare const baseStyles = "\n:root {\n    color-scheme: light dark;\n}\n\nbody {\n    font-family: system-ui, -apple-system, sans-serif;\n    margin: 0;\n    padding: 2.5rem 1.75rem;\n    background:\n        radial-gradient(circle at 0 0, rgba(56, 189, 248, 0.10), transparent 55%),\n        radial-gradient(circle at 100% 0, rgba(129, 140, 248, 0.12), transparent 55%),\n        #f9fafb;\n    color: #0f172a;\n    line-height: 1.5;\n}\n\n.page {\n    max-width: 1120px;\n    margin: 0 auto;\n}\n\n.hero {\n    display: flex;\n    justify-content: space-between;\n    align-items: flex-start;\n    gap: 2.25rem;\n    padding: 1.75rem 2rem;\n    margin-bottom: 2.5rem;\n    border-radius: 1.25rem;\n    background: linear-gradient(135deg, #ffffff, #f3f4ff);\n    border: 1px solid #e5e7eb;\n    box-shadow:\n        0 18px 40px rgba(15, 23, 42, 0.08),\n        0 0 0 1px rgba(248, 250, 252, 0.8);\n}\n\n.hero-main {\n    display: flex;\n    gap: 1.5rem;\n    align-items: center;\n}\n\n.hero-logo {\n    display: flex;\n    align-items: center;\n    justify-content: center;\n    width: 56px;\n    height: 56px;\n    border-radius: 999px;\n    background: radial-gradient(circle at 30% 0, #38bdf8, #6366f1);\n    box-shadow:\n        0 0 0 1px rgba(15, 23, 42, 0.85),\n        0 12px 30px rgba(37, 99, 235, 0.6);\n}\n\n.hero-logo-initial {\n    font-size: 1.1rem;\n    font-weight: 650;\n    letter-spacing: 0.08em;\n    text-transform: uppercase;\n    color: #eff6ff;\n}\n\n.hero-logo img {\n    display: block;\n    max-width: 80%;\n    max-height: 60%;\n}\n\n.logo-dark {\n    display: none;\n}\n\n.hero-meta {\n    display: flex;\n    flex-direction: column;\n    gap: 0.5rem;\n}\n\n.hero-eyebrow {\n    font-size: 0.75rem;\n    letter-spacing: 0.12em;\n    text-transform: uppercase;\n    color: #6b7280;\n}\n\n.hero-title {\n    font-size: 1.9rem;\n    font-weight: 650;\n    letter-spacing: -0.03em;\n    color: #0f172a;\n    margin: 0;\n}\n\n.hero-tagline {\n    font-size: 0.95rem;\n    color: #4b5563;\n    margin: 0.1rem 0 0 0;\n}\n\n.hero-summary {\n    display: flex;\n    flex-wrap: wrap;\n    gap: 0.5rem;\n    margin-top: 0.75rem;\n    font-size: 0.8rem;\n    color: #6b7280;\n}\n\n.hero-summary span {\n    display: inline-flex;\n    align-items: center;\n    gap: 0.35rem;\n    padding: 0.15rem 0.55rem;\n    border-radius: 999px;\n    background: #f9fafb;\n    border: 1px solid #e5e7eb;\n}\n\n.hero-summary dot {\n    width: 6px;\n    height: 6px;\n    border-radius: 999px;\n    display: inline-block;\n    background: #22c55e;\n}\n\n.search-bar {\n    display: flex;\n    flex-direction: column;\n    gap: 0.4rem;\n    margin: 0 0 1.75rem 0;\n}\n\n.search-input {\n    max-width: 360px;\n    padding: 0.55rem 0.75rem;\n    border-radius: 999px;\n    border: 1px solid #e5e7eb;\n    background: #ffffff;\n    color: #111827;\n    font-size: 0.9rem;\n    font-family: inherit;\n    box-shadow: 0 4px 10px rgba(15, 23, 42, 0.04);\n}\n\n.search-input::placeholder {\n    color: #9ca3af;\n}\n\n.search-input:focus {\n    outline: none;\n    border-color: #60a5fa;\n    box-shadow:\n        0 0 0 1px rgba(59, 130, 246, 0.4),\n        0 6px 18px rgba(37, 99, 235, 0.18);\n}\n\n.search-hint {\n    font-size: 0.75rem;\n    color: #9ca3af;\n}\n\n.search-empty {\n    margin-top: 1rem;\n    font-size: 0.85rem;\n    color: #9ca3af;\n}\n\n.hero-panel {\n    min-width: 220px;\n    max-width: 260px;\n    padding: 1.25rem 1.4rem;\n    border-radius: 1rem;\n    background: radial-gradient(circle at 0 0, rgba(59, 130, 246, 0.10), transparent 70%),\n        #eff6ff;\n    border: 1px solid #bfdbfe;\n    box-shadow: 0 16px 34px rgba(15, 23, 42, 0.10);\n    font-size: 0.8rem;\n}\n\n.hero-panel-label {\n    font-size: 0.7rem;\n    letter-spacing: 0.13em;\n    text-transform: uppercase;\n    color: #1d4ed8;\n    margin-bottom: 0.5rem;\n}\n\n.hero-panel-endpoint {\n    display: inline-flex;\n    align-items: center;\n    padding: 0.3rem 0.6rem;\n    border-radius: 0.5rem;\n    background: #f9fafb;\n    border: 1px solid #e5e7eb;\n    font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, \"Liberation Mono\", \"Courier New\", monospace;\n    font-size: 0.82rem;\n    color: #111827;\n}\n\n.hero-panel-hint {\n    margin-top: 0.6rem;\n    color: #6b7280;\n    line-height: 1.4;\n}\n\n.hero-panel-hint strong {\n    color: #111827;\n}\n\nh1, h2 {\n    margin: 0 0 1rem 0;\n    color: #0f172a;\n}\n\nh1 { font-size: 1.875rem; }\nh2 {\n    font-size: 1.4rem;\n    margin-top: 2rem;\n    letter-spacing: 0.03em;\n    text-transform: uppercase;\n    color: #6b7280;\n}\n\na {\n    color: #2563eb;\n    text-decoration: none;\n}\na:hover {\n    text-decoration: underline;\n}\n\nhr {\n    border: none;\n    border-top: 1px solid #e5e7eb;\n    margin: 2rem 0;\n}\n\n.card-grid {\n    display: grid;\n    grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));\n    gap: 1.5rem;\n}\n\n.card {\n    background: radial-gradient(circle at 0 0, rgba(56, 189, 248, 0.12), transparent 75%),\n        #ffffff;\n    padding: 1.25rem 1.35rem;\n    border-radius: 14px;\n    box-shadow:\n        0 14px 30px rgba(15, 23, 42, 0.06),\n        0 0 0 1px rgba(248, 250, 252, 0.9);\n    border: 1px solid #e5e7eb;\n    transition: transform 0.15s, box-shadow 0.15s;\n    text-decoration: none;\n    color: inherit;\n    display: block;\n}\n\n.card:hover {\n    transform: translateY(-3px);\n    box-shadow:\n        0 18px 40px rgba(15, 23, 42, 0.10),\n        0 0 0 1px rgba(59, 130, 246, 0.6);\n}\n\n.card-icon {\n    width: 48px;\n    height: 48px;\n    margin-bottom: 0.75rem;\n}\n\n.card-icon svg {\n    width: 100%;\n    height: 100%;\n}\n\n.card-title {\n    font-weight: 600;\n    font-size: 1.1rem;\n    margin-bottom: 0.25rem;\n    color: #0f172a;\n}\n\n.card-desc {\n    font-size: 0.925rem;\n    color: #6b7280;\n}\n\n.card-meta {\n    margin-top: 0.45rem;\n    font-size: 0.75rem;\n    text-transform: uppercase;\n    letter-spacing: 0.08em;\n    color: #9ca3af;\n}\n\n.item-list {\n    display: flex;\n    flex-direction: column;\n    gap: 1rem;\n}\n\n.item-card {\n    background: #ffffff;\n    padding: 1rem 1.25rem;\n    border-radius: 10px;\n    border-left: 4px solid #6366f1;\n    box-shadow:\n        0 10px 24px rgba(15, 23, 42, 0.06),\n        0 0 0 1px rgba(248, 250, 252, 0.9);\n}\n\n.item-card.skill {\n    border-left-color: #10b981;\n}\n\n.item-card.interaction {\n    border-left-color: #f59e0b;\n}\n\n.item-name {\n    font-weight: 600;\n    font-size: 1.05rem;\n}\n\n.item-desc {\n    font-size: 0.9rem;\n    color: #6b7280;\n    margin-top: 0.25rem;\n}\n\n.item-meta {\n    font-size: 0.8rem;\n    color: #9ca3af;\n    margin-top: 0.5rem;\n}\n\n.item-schema {\n    margin-top: 0.75rem;\n    font-size: 0.8rem;\n    font-family: ui-monospace, monospace;\n    background: #f3f4f6;\n    padding: 0.75rem;\n    border-radius: 6px;\n    overflow-x: auto;\n    white-space: pre-wrap;\n    color: #374151;\n}\n\n.header {\n    display: flex;\n    align-items: center;\n    gap: 1rem;\n    margin-bottom: 1.5rem;\n}\n\n.header-icon {\n    width: 64px;\n    height: 64px;\n}\n\n.header-icon svg {\n    width: 100%;\n    height: 100%;\n}\n\n.section-header {\n    display: flex;\n    align-items: baseline;\n    justify-content: space-between;\n    gap: 1rem;\n    margin-bottom: 0.75rem;\n}\n\n.section-subtitle {\n    font-size: 0.8rem;\n    color: #6b7280;\n}\n\n.endpoint-url {\n    font-size: 0.85rem;\n    color: #6b7280;\n    margin-top: 0.25rem;\n}\n\n.endpoint-url code {\n    background: #f3f4f6;\n    padding: 0.125rem 0.375rem;\n    border-radius: 4px;\n    font-family: ui-monospace, monospace;\n}\n\n.endpoint-box {\n    display: flex;\n    align-items: center;\n    gap: 0.75rem;\n    background: #f3f4f6;\n    padding: 0.75rem 1rem;\n    border-radius: 8px;\n    margin-top: 0.5rem;\n}\n\n.endpoint-box code {\n    flex: 1;\n    font-family: ui-monospace, monospace;\n    font-size: 0.875rem;\n    color: #1f2937;\n}\n\n.copy-btn {\n    background: #e5e7eb;\n    border: none;\n    padding: 0.5rem;\n    border-radius: 6px;\n    cursor: pointer;\n    color: #6b7280;\n    transition: all 0.15s;\n}\n\n.copy-btn:hover {\n    background: #d1d5db;\n    color: #374151;\n}\n\n.copy-btn svg {\n    width: 16px;\n    height: 16px;\n}\n\n.badge {\n    display: inline-block;\n    font-size: 0.75rem;\n    padding: 0.125rem 0.5rem;\n    border-radius: 9999px;\n    background: #f9fafb;\n    color: #374151;\n    border: 1px solid #e5e7eb;\n    margin-right: 0.25rem;\n}\n\n.badge.python { background: #fef3c7; color: #92400e; border-color: #facc15; }\n.badge.typescript { background: #dbeafe; color: #1e40af; border-color: #60a5fa; }\n.badge.javascript { background: #fef9c3; color: #854d0e; border-color: #facc15; }\n\n@media (max-width: 768px) {\n    body {\n        padding: 1.75rem 1.25rem;\n    }\n\n    .hero {\n        flex-direction: column;\n        padding: 1.5rem 1.35rem;\n    }\n\n    .hero-panel {\n        max-width: 100%;\n        width: 100%;\n    }\n}\n\n@media (prefers-color-scheme: dark) {\n    body {\n        background:\n            radial-gradient(circle at 0 0, rgba(56, 189, 248, 0.18), transparent 55%),\n            radial-gradient(circle at 100% 0, rgba(129, 140, 248, 0.25), transparent 55%),\n            #020617;\n        color: #e5e7eb;\n    }\n\n    .hero {\n        background: linear-gradient(135deg, rgba(15, 23, 42, 0.98), rgba(15, 23, 42, 0.92));\n        border: 1px solid rgba(148, 163, 184, 0.45);\n        box-shadow:\n            0 24px 60px rgba(15, 23, 42, 0.85),\n            0 0 0 1px rgba(15, 23, 42, 0.75);\n    }\n\n    .hero-eyebrow {\n        color: #9ca3af;\n    }\n\n    .hero-title {\n        color: #f9fafb;\n    }\n\n    .hero-tagline {\n        color: #cbd5f5;\n    }\n\n    .hero-summary {\n        color: #9ca3af;\n    }\n\n    .hero-summary span {\n        background: rgba(15, 23, 42, 0.95);\n        border-color: rgba(148, 163, 184, 0.45);\n    }\n\n    .hero-panel {\n        background: radial-gradient(circle at 0 0, rgba(56, 189, 248, 0.16), transparent 70%),\n            rgba(15, 23, 42, 0.96);\n        border: 1px solid rgba(59, 130, 246, 0.6);\n        box-shadow: 0 20px 40px rgba(15, 23, 42, 0.85);\n    }\n\n    .hero-panel-label {\n        color: #93c5fd;\n    }\n\n    .hero-panel-endpoint {\n        background: rgba(15, 23, 42, 0.98);\n        border-color: rgba(148, 163, 184, 0.6);\n        color: #e5e7eb;\n    }\n\n    .hero-panel-hint {\n        color: #9ca3af;\n    }\n\n    .hero-panel-hint strong {\n        color: #e5e7eb;\n    }\n\n    .search-input {\n        background: rgba(15, 23, 42, 0.96);\n        border-color: rgba(55, 65, 81, 0.9);\n        color: #e5e7eb;\n        box-shadow:\n            0 6px 16px rgba(15, 23, 42, 0.9),\n            0 0 0 1px rgba(15, 23, 42, 0.9);\n    }\n\n    .search-input::placeholder {\n        color: #6b7280;\n    }\n\n    .search-input:focus {\n        border-color: #60a5fa;\n        box-shadow:\n            0 0 0 1px rgba(59, 130, 246, 0.7),\n            0 10px 26px rgba(30, 64, 175, 0.7);\n    }\n\n    .search-hint,\n    .search-empty {\n        color: #9ca3af;\n    }\n\n    h1, h2 {\n        color: #e5e7eb;\n    }\n\n    h2 {\n        color: #9ca3af;\n    }\n\n    a {\n        color: #60a5fa;\n    }\n\n    hr {\n        border-top-color: rgba(148, 163, 184, 0.4);\n    }\n\n    .card {\n        background: radial-gradient(circle at 0 0, rgba(56, 189, 248, 0.12), transparent 75%),\n            rgba(15, 23, 42, 0.9);\n        box-shadow:\n            0 14px 30px rgba(15, 23, 42, 0.8),\n            0 0 0 1px rgba(15, 23, 42, 0.85);\n        border-color: rgba(148, 163, 184, 0.5);\n    }\n\n    .card:hover {\n        box-shadow:\n            0 18px 40px rgba(15, 23, 42, 0.9),\n            0 0 0 1px rgba(59, 130, 246, 0.8);\n    }\n\n    .card-title {\n        color: #e5e7eb;\n    }\n\n    .card-desc {\n        color: #9ca3af;\n    }\n\n    .card-meta {\n        color: #6b7280;\n    }\n\n    .item-card {\n        background: rgba(15, 23, 42, 0.9);\n        box-shadow:\n            0 10px 24px rgba(15, 23, 42, 0.9),\n            0 0 0 1px rgba(15, 23, 42, 0.9);\n    }\n\n    .item-desc,\n    .item-meta {\n        color: #9ca3af;\n    }\n\n    .item-schema {\n        background: rgba(15, 23, 42, 0.95);\n        color: #e5e7eb;\n    }\n\n    .endpoint-url {\n        color: #9ca3af;\n    }\n\n    .endpoint-url code {\n        background: rgba(15, 23, 42, 0.95);\n    }\n\n    .endpoint-box {\n        background: rgba(31, 41, 55, 0.95);\n    }\n\n    .endpoint-box code {\n        color: #e5e7eb;\n    }\n\n    .copy-btn {\n        background: rgba(55, 65, 81, 0.95);\n        color: #e5e7eb;\n    }\n\n    .copy-btn:hover {\n        background: rgba(75, 85, 99, 0.98);\n        color: #f9fafb;\n    }\n\n    .badge {\n        background: rgba(15, 23, 42, 0.96);\n        color: #e5e7eb;\n        border-color: rgba(148, 163, 184, 0.6);\n    }\n\n    .badge.python {\n        background: rgba(252, 211, 77, 0.12);\n        color: #facc15;\n        border-color: rgba(250, 204, 21, 0.5);\n    }\n\n    .badge.typescript {\n        background: rgba(59, 130, 246, 0.12);\n        color: #93c5fd;\n        border-color: rgba(59, 130, 246, 0.7);\n    }\n\n    .badge.javascript {\n        background: rgba(251, 191, 36, 0.12);\n        color: #fbbf24;\n        border-color: rgba(251, 191, 36, 0.55);\n    }\n\n    .logo-light {\n        display: none;\n    }\n    .logo-dark {\n        display: block;\n    }\n\n    .plugin-link-primary:hover {\n        background: #2563eb !important;\n    }\n\n    .plugin-link-secondary:hover {\n        background: #059669 !important;\n    }\n}\n\n.plugin-link-primary:hover {\n    background: #2563eb;\n}\n\n.plugin-link-secondary:hover {\n    background: #059669;\n}\n";
+//# sourceMappingURL=styles.d.ts.map

package/lib/types/site/styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../src/site/styles.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,UAAU,m9aA4qBtB,CAAC"}

package/lib/types/site/templates.d.ts

@@ -0,0 +1,71 @@
+import type { InteractionCollection } from "../InteractionCollection.js";
+import { ToolServerConfig } from "../server/types.js";
+import type { SkillCollection } from "../SkillCollection.js";
+import type { RenderingTemplateCollection } from "../RenderingTemplateCollection.js";
+import type { ToolCollection } from "../ToolCollection.js";
+import type { ContentTypesCollection } from "../ContentTypesCollection.js";
+import type { ICollection, SkillDefinition, RenderingTemplateDefinition, Tool } from "../types.js";
+type MCPProviderMeta = {
+    name: string;
+    description?: string;
+};
+/**
+ * Render a collection card for the index page
+ */
+export declare function collectionCard(collection: ICollection, pathPrefix: string, meta?: string): string;
+/**
+ * Render a tool card (simple version for lists)
+ */
+export declare function toolCard(tool: Tool<Record<string, unknown>>): string;
+/**
+ * Render an MCP provider card
+ */
+export declare function mcpProviderCard(provider: MCPProviderMeta): string;
+/**
+ * Render a detailed tool card
+ */
+export declare function toolDetailCard(tool: Tool<Record<string, unknown>>, collectionName: string): string;
+/**
+ * Render a skill card (simple version for lists)
+ */
+export declare function skillCard(skill: SkillDefinition): string;
+/**
+ * Render a detailed skill card
+ */
+export declare function skillDetailCard(skill: SkillDefinition, collection: SkillCollection): string;
+/**
+ * Render a detailed template card
+ */
+export declare function templateDetailCard(template: RenderingTemplateDefinition, collection: RenderingTemplateCollection): string;
+/**
+ * Render a template collection detail page
+ */
+export declare function templateCollectionPage(collection: RenderingTemplateCollection): string;
+/**
+ * Render the main index page
+ *
+ * Note: The fourth argument is backward compatible:
+ * - If a string is passed, it is treated as the title.
+ * - If an array is passed, it is treated as MCP providers and the fifth argument (if any) is the title.
+ * @deprecated Static templates were replaced by a React site. Do not use them anymore.
+ * Will be removed.
+ */
+export declare function indexPage(config: ToolServerConfig): string;
+/**
+ * Render a tool collection detail page
+ */
+export declare function toolCollectionPage(collection: ToolCollection): string;
+/**
+ * Render a skill collection detail page
+ */
+export declare function skillCollectionPage(collection: SkillCollection): string;
+/**
+ * Render an interaction collection detail page
+ */
+export declare function interactionCollectionPage(collection: InteractionCollection): string;
+/**
+ * Render a content type collection detail page
+ */
+export declare function contentTypeCollectionPage(collection: ContentTypesCollection): string;
+export {};
+//# sourceMappingURL=templates.d.ts.map

package/lib/types/site/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../../src/site/templates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AACrF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,2BAA2B,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAInG,KAAK,eAAe,GAAG;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAgXF;;GAEG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAQjG;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,CASpE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAMjE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CA0DlG;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAWxD;AAsBD;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,eAAe,GAAG,MAAM,CAsF3F;AA0DD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,2BAA2B,EAAE,UAAU,EAAE,2BAA2B,GAAG,MAAM,CA8BzH;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,2BAA2B,GAAG,MAAM,CAsCtF;AAoED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CACrB,MAAM,EAAE,gBAAgB,GACzB,MAAM,CAqOR;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM,CAsCrE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,eAAe,GAAG,MAAM,CAsCvE;AA4CD;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,qBAAqB,GAAG,MAAM,CAoBnF;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,sBAAsB,GAAG,MAAM,CAqBpF"}

package/lib/types/types.d.ts

@@ -0,0 +1,294 @@
+import type { ToolDefinition, ToolUse } from "@llumiverse/common";
+import { VertesiaClient } from "@vertesia/client";
+import { AgentToolDefinition, AuthTokenPayload, ProjectConfiguration, RenderingTemplateDefinition, ToolExecutionMetadata, ToolResult, ToolResultContent } from "@vertesia/common";
+export type { ToolExecutionMetadata };
+export type ICollection<T = any> = CollectionProperties & Iterable<T>;
+export interface CollectionProperties {
+    /**
+     * A kebab case collection name. Must only contains alphanumeric and dash characters,
+     * The name can be used to generate the path where the collection is exposed.
+     * Example: my-collection
+     */
+    name: string;
+    /**
+     * Optional title for UI display.
+     * If not provided the pascal case version of the name will be used
+     */
+    title?: string;
+    /**
+     * Optional icon for UI display
+     */
+    icon?: string;
+    /**
+     * A short description
+     */
+    description?: string;
+}
+export interface ToolExecutionContext {
+    /**
+     * The raw JWT token to the tool execution request
+     */
+    token: string;
+    /**
+     * The decoded JWT token
+     */
+    payload: AuthTokenPayload;
+    /**
+     * Vertesia client factory using the current auth token.
+     * @returns a vertesia client instance
+     */
+    getClient: () => Promise<VertesiaClient>;
+}
+export interface ToolExecutionResult extends ToolResultContent {
+    /**
+     * Medata can be used to return more info on the tool execution like stats or user messages.
+     */
+    meta?: Record<string, any>;
+}
+export interface ToolExecutionResponse extends ToolExecutionResult, ToolResult {
+    /**
+     * The tool use id of the tool use request. For traceability.
+     */
+    tool_use_id: string;
+}
+export interface ToolExecutionResponseError {
+    /**
+     * The tool use id of the tool use request. For traceability.
+     */
+    tool_use_id: string;
+    /**
+     * The http status code
+     */
+    status: number;
+    /**
+     * the error message
+     */
+    error: string;
+    /**
+     * Additional context information
+     */
+    data?: Record<string, any>;
+}
+export interface ToolExecutionPayload<ParamsT extends Record<string, any>> {
+    tool_use: ToolUse<ParamsT>;
+    /**
+     * Optional metadata related to the current execution request
+     */
+    metadata?: ToolExecutionMetadata;
+}
+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>;
+    /**
+     * 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
+     */
+    default?: boolean;
+    /**
+     * 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;
+}
+/**
+ * The interface that should be returned when requesting a collection endpoint using a GET
+ */
+export interface ToolCollectionDefinition {
+    title: string;
+    description: string;
+    src: string;
+    tools: AgentToolDefinition[];
+}
+export type { ToolDefinition };
+/**
+ * The details of a connection to a MCP server - including the server URL and an authentication token
+ */
+export interface MCPConnectionDetails {
+    /**
+     * The mcp server name. It will be used to prefix tool names.
+     */
+    name: string;
+    /**
+     * The target mcp server URL
+     */
+    url: string;
+    /**
+     * The bearer authentication token to use when connecting to the mcp server.
+     * 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>;
+}
+export type { RenderingTemplateDefinition };
+/**
+ * Content type for skill instructions
+ */
+export type SkillContentType = 'md' | 'jst';
+/**
+ * Context triggers for auto-injection of skills
+ */
+export interface SkillContextTriggers {
+    /**
+     * Keywords in user input that should trigger this skill
+     */
+    keywords?: string[];
+    /**
+     * If these tools are being used, suggest this skill
+     */
+    tool_names?: string[];
+    /**
+     * Regex patterns to match against input data
+     */
+    data_patterns?: string[];
+}
+/**
+ * Execution configuration for skills that need code execution
+ */
+export interface SkillExecution {
+    /**
+     * The programming language for execution
+     */
+    language: string;
+    /**
+     * Required packages to install
+     */
+    packages?: string[];
+    /**
+     * System-level packages to install (e.g., apt-get packages)
+     */
+    system_packages?: string[];
+    /**
+     * Code template to execute
+     */
+    template?: string;
+}
+/**
+ * Skill definition - parsed from SKILL.md or SKILL.jst
+ */
+export interface SkillDefinition {
+    /**
+     * Unique skill name (kebab-case)
+     */
+    name: string;
+    /**
+     * Display title
+     */
+    title?: string;
+    /**
+     * Short description for discovery
+     */
+    description: string;
+    /**
+     * The skill instructions (markdown or JST template)
+     */
+    instructions: string;
+    /**
+     * Content type: 'md' for static markdown, 'jst' for dynamic templates
+     */
+    content_type: SkillContentType;
+    /**
+     * JSON Schema for skill input parameters.
+     * Used when skill is exposed as a tool.
+     */
+    input_schema?: {
+        type: 'object';
+        properties?: Record<string, any>;
+        required?: string[];
+    };
+    /**
+     * Context triggers for auto-injection
+     */
+    context_triggers?: SkillContextTriggers;
+    /**
+     * Execution configuration for code-based skills
+     */
+    execution?: SkillExecution;
+    /**
+     * Related tools that work well with this skill
+     */
+    related_tools?: string[];
+    /**
+     * Scripts bundled with this skill (synced to sandbox when skill is used)
+     */
+    scripts?: string[];
+    /**
+     * The name of the widgets provided by this skill (if any)
+     * The name will be used to load the widget dynamically from the agent chat
+     * and must match the code block language returned by the LLM (e.g., ```my-widget)
+     * which will be rendered using the widget.
+     * 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;
+}
+/**
+ * Skill execution payload
+ */
+export interface SkillExecutionPayload {
+    /**
+     * The skill name to execute
+     */
+    skill_name: string;
+    /**
+     * Data context for JST template rendering
+     */
+    data?: Record<string, any>;
+    /**
+     * Whether to execute the code template (if present)
+     */
+    execute?: boolean;
+}
+/**
+ * Skill execution result
+ */
+export interface SkillExecutionResult {
+    /**
+     * The skill name
+     */
+    name: string;
+    /**
+     * Rendered instructions
+     */
+    instructions: string;
+    /**
+     * Execution output (if execute=true and skill has code template)
+     */
+    execution_result?: {
+        output: string;
+        files?: string[];
+        is_error: boolean;
+    };
+}
+/**
+ * Skill collection definition - returned by GET endpoint
+ */
+export interface SkillCollectionDefinition {
+    name: string;
+    title: string;
+    description: string;
+    skills: SkillDefinition[];
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/types/types.d.ts.map

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

package/lib/types/utils.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 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 declare function toPathName(name: string): string;
+export declare function kebabCaseToTitle(name: string): string;
+export declare function makeScriptUrl(origin: string, script: string): string;
+export declare function join(left: string, right: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/lib/types/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM/C;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,UAE5C;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,UAE3D;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,UAc/C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vertesia/tools-sdk",
-  "version": "1.0.0-dev.20260203.130115Z",
+  "version": "1.0.0-dev.20260227.112605Z",
   "description": "Tools SDK - utilities for building remote tools",
   "type": "module",
   "types": "./lib/types/index.d.ts",
@@ -32,9 +32,9 @@
   "dependencies": {
     "jose": "^6.0.11",
     "zod": "^4.3.5",
-    "@llumiverse/common": "1.0.0-dev.20260202.145450Z",
-    "@vertesia/common": "1.0.0-dev.20260203.130115Z",
-    "@vertesia/client": "1.0.0-dev.20260203.130115Z"
+    "@vertesia/common": "1.0.0-dev.20260227.112605Z",
+    "@vertesia/client": "1.0.0-dev.20260227.112605Z",
+    "@llumiverse/common": "1.0.0-dev.20260224.234313Z"
   },
   "repository": {
     "type": "git",

package/src/ContentTypesCollection.ts

@@ -1,12 +1,12 @@
-import { InCodeTypeDefinition } from "@vertesia/common";
+import { InCodeTypeSpec } from "@vertesia/common";
 import { CollectionProperties, ICollection } from "./types.js";
 import { kebabCaseToTitle } from "./utils.js";
 
 export interface ContentTypesCollectionProps extends CollectionProperties {
-    types: InCodeTypeDefinition[];
+    types: InCodeTypeSpec[];
 }
-export class ContentTypesCollection implements ICollection<InCodeTypeDefinition> {
-    types: InCodeTypeDefinition[];
+export class ContentTypesCollection implements ICollection<InCodeTypeSpec> {
+    types: InCodeTypeSpec[];
     name: string;
     title?: string;
     icon?: string;
@@ -25,12 +25,12 @@ export class ContentTypesCollection implements ICollection<InCodeTypeDefinition>
         return this.types;
     }
 
-    [Symbol.iterator](): Iterator<InCodeTypeDefinition> {
+    [Symbol.iterator](): Iterator<InCodeTypeSpec> {
         let index = 0;
         const types = this.types;
 
         return {
-            next(): IteratorResult<InCodeTypeDefinition> {
+            next(): IteratorResult<InCodeTypeSpec> {
                 if (index < types.length) {
                     return { value: types[index++], done: false };
                 } else {
@@ -40,11 +40,11 @@ export class ContentTypesCollection implements ICollection<InCodeTypeDefinition>
         };
     }
 
-    map<U>(callback: (type: InCodeTypeDefinition, index: number) => U): U[] {
+    map<U>(callback: (type: InCodeTypeSpec, index: number) => U): U[] {
         return this.types.map(callback);
     }
 
-    getTypeByName(name: string): InCodeTypeDefinition | undefined {
+    getTypeByName(name: string): InCodeTypeSpec | undefined {
         return this.types.find(type => type.name === name);
     }