@vertesia/tools-sdk 1.3.0 → 1.4.0-dev.20260615.051508Z

package/lib/{types/types.d.ts → types.d.ts}

@@ -1,8 +1,8 @@
-import type { ToolDefinition, ToolUse } from "@llumiverse/common";
-import { VertesiaClient } from "@vertesia/client";
-import { AgentToolDefinition, AuthTokenPayload, ProjectConfiguration, RenderingTemplateDefinition, ToolExecutionMetadata, ToolResult, ToolResultContent } from "@vertesia/common";
+import type { ToolDefinition, ToolUse } from '@llumiverse/common';
+import type { VertesiaClient } from '@vertesia/client';
+import type { AgentToolDefinition, AuthTokenPayload, MCPToolAnnotations, ProjectConfiguration, RenderingTemplateDefinition, ToolExecutionMetadata, ToolResult, ToolResultContent } from '@vertesia/common';
 export type { ToolExecutionMetadata };
-export type ICollection<T = any> = CollectionProperties & Iterable<T>;
+export type ICollection<T = object> = CollectionProperties & Iterable<T>;
 export interface CollectionProperties {
     /**
      * A kebab case collection name. Must only contains alphanumeric and dash characters,
@@ -43,7 +43,7 @@ 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>;
+    meta?: Record<string, unknown>;
 }
 export interface ToolExecutionResponse extends ToolExecutionResult, ToolResult {
     /**
@@ -67,32 +67,44 @@ export interface ToolExecutionResponseError {
     /**
      * Additional context information
      */
-    data?: Record<string, any>;
+    data?: Record<string, unknown>;
 }
-export interface ToolExecutionPayload<ParamsT extends Record<string, any>> {
+export interface ToolExecutionPayload<ParamsT extends object = object> {
     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 type ToolFn<ParamsT extends object = object> = (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>;
+    vars?: Record<string, unknown>;
 }
-export interface Tool<ParamsT extends Record<string, any>> extends ToolDefinition {
-    run: ToolFn<ParamsT>;
+export interface Tool<ParamsT extends object = object> extends ToolDefinition {
+    run(payload: ToolExecutionPayload<ParamsT>, context: ToolExecutionContext): Promise<ToolExecutionResult>;
     /**
      * 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
+     * - false: Tool is only available when activated by a skill's tools
      */
     default?: boolean;
+    /**
+     * MCP-style annotations (destructiveHint, readOnlyHint, etc). Propagated
+     * into the AgentToolDefinition on catalog / package responses.
+     */
+    annotations?: MCPToolAnnotations;
+    /**
+     * When true, agents must obtain explicit user confirmation via `ask_user`
+     * (Yes/No) before invoking this tool. If the user answers No, the tool
+     * must not run. Stronger than `annotations.destructiveHint` — this is a
+     * hard contract.
+     */
+    requires_user_confirmation?: 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.
@@ -208,7 +220,7 @@ export interface SkillDefinition {
      */
     input_schema?: {
         type: 'object';
-        properties?: Record<string, any>;
+        properties?: Record<string, unknown>;
         required?: string[];
     };
     /**
@@ -220,9 +232,10 @@ export interface SkillDefinition {
      */
     execution?: SkillExecution;
     /**
-     * Related tools that work well with this skill
+     * Tool names this skill enables (unlocks) when called. Matches the
+     * `tools:` key used in SKILL.md frontmatter.
      */
-    related_tools?: string[];
+    tools?: string[];
     /**
      * Scripts bundled with this skill (synced to sandbox when skill is used)
      */
@@ -255,7 +268,7 @@ export interface SkillExecutionPayload {
     /**
      * Data context for JST template rendering
      */
-    data?: Record<string, any>;
+    data?: Record<string, unknown>;
     /**
      * Whether to execute the code template (if present)
      */

package/lib/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.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/lib/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,CAS/C;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,UAK5C;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/lib/{esm/utils.js → utils.js}

@@ -6,15 +6,21 @@
 export function toPathName(name) {
     let result = name;
     if (result.includes(' ') || result.includes('_')) {
-        result = result.split(/[\s_]+/).map(w => w.charAt(0).toUpperCase() + w.slice(1)).join('');
+        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) {
-    return name.split('-').map(p => p[0].toUpperCase() + p.substring(1)).join(' ');
+    return name
+        .split('-')
+        .map((p) => p[0].toUpperCase() + p.substring(1))
+        .join(' ');
 }
 export function makeScriptUrl(origin, script) {
-    return join(origin, join("/scripts", script));
+    return join(origin, join('/scripts', script));
 }
 export function join(left, right) {
     if (left.endsWith('/')) {
@@ -29,10 +35,10 @@ export function join(left, right) {
         return left + right;
     }
     else if (right.startsWith('./')) {
-        return left + '/' + right.slice(2);
+        return `${left}/${right.slice(2)}`;
     }
     else {
-        return left + '/' + right;
+        return `${left}/${right}`;
     }
 }
 //# sourceMappingURL=utils.js.map

package/lib/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACnC,IAAI,MAAM,GAAG,IAAI,CAAC;IAClB,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,MAAM,GAAG,MAAM;aACV,KAAK,CAAC,QAAQ,CAAC;aACf,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;aAClD,IAAI,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,MAAM,CAAC,OAAO,CAAC,oBAAoB,EAAE,GAAG,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY;IACzC,OAAO,IAAI;SACN,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;SAC/C,IAAI,CAAC,GAAG,CAAC,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,MAAc;IACxD,OAAO,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,IAAY,EAAE,KAAa;IAC5C,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,OAAO,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACjC,CAAC;aAAM,CAAC;YACJ,OAAO,IAAI,GAAG,KAAK,CAAC;QACxB,CAAC;IACL,CAAC;SAAM,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/B,OAAO,IAAI,GAAG,KAAK,CAAC;IACxB,CAAC;SAAM,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAChC,OAAO,GAAG,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACvC,CAAC;SAAM,CAAC;QACJ,OAAO,GAAG,IAAI,IAAI,KAAK,EAAE,CAAC;IAC9B,CAAC;AACL,CAAC"}

package/package.json

@@ -1,40 +1,36 @@
 {
   "name": "@vertesia/tools-sdk",
-  "version": "1.3.0",
+  "version": "1.4.0-dev.20260615.051508Z",
   "description": "Tools SDK - utilities for building remote tools",
   "type": "module",
-  "types": "./lib/types/index.d.ts",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
   "files": [
     "lib",
     "src"
   ],
   "license": "Apache-2.0",
   "exports": {
-    "types": "./lib/types/index.d.ts",
-    "import": "./lib/esm/index.js",
-    "require": "./lib/cjs/index.js"
-  },
-  "bin": {
-    "tools-sdk-copy-assets": "./lib/esm/copy-assets.js"
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    }
   },
   "devDependencies": {
-    "@types/node": "^24.1.0",
-    "ts-dual-module": "^0.6.3",
-    "typescript": "^6.0.2",
-    "vitest": "^4.0.16"
-  },
-  "ts_dual_module": {
-    "outDir": "lib"
+    "@types/node": "^24.12.4",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.8",
+    "@vertesia/tsconfig": "0.1.0"
   },
   "peerDependencies": {
-    "hono": "^4.12.14"
+    "hono": "^4.12.23"
   },
   "dependencies": {
-    "jose": "^6.0.11",
-    "zod": "^4.3.5",
+    "jose": "^6.2.3",
+    "zod": "^4.4.3",
     "@llumiverse/common": "1.3.0",
-    "@vertesia/client": "1.3.0",
-    "@vertesia/common": "1.3.0"
+    "@vertesia/client": "1.4.0-dev.20260615.051508Z",
+    "@vertesia/common": "1.4.0-dev.20260615.051508Z"
   },
   "repository": {
     "type": "git",
@@ -51,8 +47,10 @@
     "typescript"
   ],
   "scripts": {
+    "lint": "biome lint src",
     "test": "vitest run",
-    "build": "pnpm exec tsmod build",
-    "clean": "rimraf ./node_modules ./lib ./tsconfig.tsbuildinfo"
+    "typecheck:test": "tsc -p tsconfig.test.json --noEmit",
+    "build": "rm -rf ./lib ./tsconfig.tsbuildinfo && tsc",
+    "clean": "rm -rf ./node_modules ./lib ./tsconfig.tsbuildinfo"
   }
 }

package/src/ActivityCollection.test.ts

@@ -1,38 +1,45 @@
-import { RemoteActivityExecutionPayload } from "@vertesia/common";
-import { beforeEach, describe, expect, it, vi } from "vitest";
-import { ActivityCollection, ActivityDefinition } from "./ActivityCollection.js";
+import type { RemoteActivityExecutionPayload } from '@vertesia/common';
+import type { Context } from 'hono';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { ActivityCollection, type ActivityDefinition } from './ActivityCollection.js';
+
+type MockContext = Context & {
+    json: ReturnType<typeof vi.fn>;
+    req: { header: ReturnType<typeof vi.fn>; url: string };
+    set: ReturnType<typeof vi.fn>;
+};
 
-vi.mock("./auth.js", () => ({
-    authorize: vi.fn().mockResolvedValue({ token: "test-token" }),
+vi.mock('./auth.js', () => ({
+    authorize: vi.fn().mockResolvedValue({ token: 'test-token' }),
 }));
 
 const mockActivity: ActivityDefinition = {
-    name: "analyze_sentiment",
-    title: "Analyze Sentiment",
-    description: "Analyzes text sentiment",
+    name: 'analyze_sentiment',
+    title: 'Analyze Sentiment',
+    description: 'Analyzes text sentiment',
     input_schema: {
-        type: "object",
-        properties: { text: { type: "string" } },
-        required: ["text"],
+        type: 'object',
+        properties: { text: { type: 'string' } },
+        required: ['text'],
     },
     output_schema: {
-        type: "object",
-        properties: { score: { type: "number" } },
+        type: 'object',
+        properties: { score: { type: 'number' } },
     },
     run: vi.fn().mockResolvedValue({ score: 0.95 }),
 };
 
 const mockFailingActivity: ActivityDefinition = {
-    name: "fail_always",
-    description: "Always fails",
-    run: vi.fn().mockRejectedValue(new Error("Intentional failure")),
+    name: 'fail_always',
+    description: 'Always fails',
+    run: vi.fn().mockRejectedValue(new Error('Intentional failure')),
 };
 
 function createCollection(activities: ActivityDefinition[] = [mockActivity]) {
     return new ActivityCollection({
-        name: "test-collection",
-        title: "Test Collection",
-        description: "A test collection",
+        name: 'test-collection',
+        title: 'Test Collection',
+        description: 'A test collection',
         activities,
     });
 }
@@ -41,118 +48,112 @@ beforeEach(() => {
     vi.clearAllMocks();
 });
 
-describe("ActivityCollection", () => {
-    describe("getActivityDefinitions", () => {
-        it("returns correct metadata for all registered activities", () => {
+describe('ActivityCollection', () => {
+    describe('getActivityDefinitions', () => {
+        it('returns correct metadata for all registered activities', () => {
             const coll = createCollection([mockActivity, mockFailingActivity]);
             const defs = coll.getActivityDefinitions();
 
             expect(defs).toHaveLength(2);
             expect(defs[0]).toEqual({
-                name: "analyze_sentiment",
-                title: "Analyze Sentiment",
-                description: "Analyzes text sentiment",
+                name: 'analyze_sentiment',
+                title: 'Analyze Sentiment',
+                description: 'Analyzes text sentiment',
                 input_schema: mockActivity.input_schema,
                 output_schema: mockActivity.output_schema,
             });
             expect(defs[1]).toEqual({
-                name: "fail_always",
+                name: 'fail_always',
                 title: undefined,
-                description: "Always fails",
+                description: 'Always fails',
                 input_schema: undefined,
                 output_schema: undefined,
             });
         });
 
-        it("returns empty array when no activities registered", () => {
+        it('returns empty array when no activities registered', () => {
             const coll = createCollection([]);
             expect(coll.getActivityDefinitions()).toEqual([]);
         });
     });
 
-    describe("getActivity", () => {
-        it("returns the activity by name", () => {
+    describe('getActivity', () => {
+        it('returns the activity by name', () => {
             const coll = createCollection();
-            const activity = coll.getActivity("analyze_sentiment");
-            expect(activity.name).toBe("analyze_sentiment");
+            const activity = coll.getActivity('analyze_sentiment');
+            expect(activity.name).toBe('analyze_sentiment');
             expect(activity.run).toBeDefined();
         });
 
-        it("throws 404 for unknown activity name", () => {
+        it('throws 404 for unknown activity name', () => {
             const coll = createCollection();
-            expect(() => coll.getActivity("nonexistent")).toThrow();
+            expect(() => coll.getActivity('nonexistent')).toThrow();
         });
     });
 
-    describe("iterator", () => {
-        it("iterates over all activities", () => {
+    describe('iterator', () => {
+        it('iterates over all activities', () => {
             const coll = createCollection([mockActivity, mockFailingActivity]);
-            const names = [...coll].map(a => a.name);
-            expect(names).toEqual(["analyze_sentiment", "fail_always"]);
+            const names = [...coll].map((a) => a.name);
+            expect(names).toEqual(['analyze_sentiment', 'fail_always']);
         });
     });
 
-    describe("execute", () => {
-        const createMockContext = () => {
+    describe('execute', () => {
+        const createMockContext = (): MockContext => {
             const jsonFn = vi.fn().mockReturnThis();
             return {
                 json: jsonFn,
                 req: {
-                    header: vi.fn().mockReturnValue("Bearer test-token"),
-                    url: "http://localhost/api/activities",
+                    header: vi.fn().mockReturnValue('Bearer test-token'),
+                    url: 'http://localhost/api/activities',
                 },
                 set: vi.fn(),
-            } as any;
+            } as unknown as MockContext;
         };
 
         const payload: RemoteActivityExecutionPayload = {
-            activity_name: "analyze_sentiment",
-            params: { text: "Hello world" },
+            activity_name: 'analyze_sentiment',
+            params: { text: 'Hello world' },
             metadata: {
-                app_install_id: "install-1",
+                app_install_id: 'install-1',
             },
         };
 
-        it("calls the correct activity handler and returns result", async () => {
+        it('calls the correct activity handler and returns result', async () => {
             const coll = createCollection();
             const ctx = createMockContext();
 
             await coll.execute(ctx, payload);
 
-            expect(mockActivity.run).toHaveBeenCalledWith(
-                payload,
-                expect.objectContaining({ token: "test-token" }),
-            );
+            expect(mockActivity.run).toHaveBeenCalledWith(payload, expect.objectContaining({ token: 'test-token' }));
             expect(ctx.json).toHaveBeenCalledWith({
                 result: { score: 0.95 },
                 is_error: false,
             });
         });
 
-        it("returns is_error with message when activity throws", async () => {
+        it('returns is_error with message when activity throws', async () => {
             const coll = createCollection([mockFailingActivity]);
             const ctx = createMockContext();
 
             const failPayload: RemoteActivityExecutionPayload = {
                 ...payload,
-                activity_name: "fail_always",
+                activity_name: 'fail_always',
             };
 
             await coll.execute(ctx, failPayload);
 
-            expect(ctx.json).toHaveBeenCalledWith(
-                { result: null, is_error: true, error: "Intentional failure" },
-                500,
-            );
+            expect(ctx.json).toHaveBeenCalledWith({ result: null, is_error: true, error: 'Intentional failure' }, 500);
         });
 
-        it("throws 404 when activity_name is not found", async () => {
+        it('throws 404 when activity_name is not found', async () => {
             const coll = createCollection();
             const ctx = createMockContext();
 
             const unknownPayload: RemoteActivityExecutionPayload = {
                 ...payload,
-                activity_name: "nonexistent",
+                activity_name: 'nonexistent',
             };
 
             await expect(coll.execute(ctx, unknownPayload)).rejects.toThrow();

package/src/ActivityCollection.ts

@@ -1,9 +1,13 @@
-import { RemoteActivityDefinition, RemoteActivityExecutionPayload, RemoteActivityExecutionResponse } from "@vertesia/common";
-import { Context } from "hono";
-import { HTTPException } from "hono/http-exception";
-import { authorize } from "./auth.js";
-import { CollectionProperties, ICollection, ToolExecutionContext } from "./types.js";
-import { kebabCaseToTitle } from "./utils.js";
+import type {
+    RemoteActivityDefinition,
+    RemoteActivityExecutionPayload,
+    RemoteActivityExecutionResponse,
+} from '@vertesia/common';
+import type { Context } from 'hono';
+import { HTTPException } from 'hono/http-exception';
+import { authorize } from './auth.js';
+import type { CollectionProperties, ICollection, ToolExecutionContext } from './types.js';
+import { kebabCaseToTitle } from './utils.js';
 
 /**
  * Context provided to activity handlers during execution.
@@ -14,15 +18,15 @@ export type ActivityExecutionContext = ToolExecutionContext;
 /**
  * Function signature for a remote activity handler.
  */
-export type ActivityFn<ParamsT extends Record<string, any> = Record<string, any>> = (
+export type ActivityFn<ParamsT extends object = Record<string, unknown>> = (
     payload: RemoteActivityExecutionPayload<ParamsT>,
-    context: ActivityExecutionContext
-) => Promise<any>;
+    context: ActivityExecutionContext,
+) => Promise<unknown>;
 
 /**
  * An activity definition within an ActivityCollection.
  */
-export interface ActivityDefinition<ParamsT extends Record<string, any> = Record<string, any>> {
+export interface ActivityDefinition<ParamsT extends object = Record<string, unknown>> {
     /** Activity name (snake_case) */
     name: string;
     /** Display title */
@@ -30,9 +34,9 @@ export interface ActivityDefinition<ParamsT extends Record<string, any> = Record
     /** Description of what the activity does */
     description?: string;
     /** JSON Schema for the activity input parameters */
-    input_schema?: Record<string, any>;
+    input_schema?: Record<string, unknown>;
     /** JSON Schema for the activity output */
-    output_schema?: Record<string, any>;
+    output_schema?: Record<string, unknown>;
     /** The activity handler function */
     run: ActivityFn<ParamsT>;
 }
@@ -71,7 +75,7 @@ export class ActivityCollection implements ICollection<ActivityDefinition> {
                     return { value: activities[index++], done: false };
                 }
                 return { done: true, value: undefined };
-            }
+            },
         };
     }
 
@@ -79,7 +83,7 @@ export class ActivityCollection implements ICollection<ActivityDefinition> {
      * Get activity definitions for discovery (metadata only, no run function).
      */
     getActivityDefinitions(): RemoteActivityDefinition[] {
-        return Object.values(this.registry).map(activity => ({
+        return Object.values(this.registry).map((activity) => ({
             name: activity.name,
             title: activity.title,
             description: activity.description,
@@ -92,7 +96,7 @@ export class ActivityCollection implements ICollection<ActivityDefinition> {
         const activity = this.registry[name];
         if (!activity) {
             throw new HTTPException(404, {
-                message: `Activity not found: ${name}. Available: ${Object.keys(this.registry).join(', ')}`
+                message: `Activity not found: ${name}. Available: ${Object.keys(this.registry).join(', ')}`,
             });
         }
         return activity;
@@ -126,11 +130,14 @@ export class ActivityCollection implements ICollection<ActivityDefinition> {
                 metadata: payload.metadata,
                 error: message,
             });
-            return ctx.json({
-                result: null,
-                is_error: true,
-                error: message,
-            } satisfies RemoteActivityExecutionResponse, 500);
+            return ctx.json(
+                {
+                    result: null,
+                    is_error: true,
+                    error: message,
+                } satisfies RemoteActivityExecutionResponse,
+                500,
+            );
         }
     }
 }

package/src/ContentTypesCollection.ts

@@ -1,6 +1,6 @@
-import { InCodeTypeSpec } from "@vertesia/common";
-import { CollectionProperties, ICollection } from "./types.js";
-import { kebabCaseToTitle } from "./utils.js";
+import type { InCodeTypeSpec } from '@vertesia/common';
+import type { CollectionProperties, ICollection } from './types.js';
+import { kebabCaseToTitle } from './utils.js';
 
 export interface ContentTypesCollectionProps extends CollectionProperties {
     types: InCodeTypeSpec[];
@@ -11,9 +11,7 @@ export class ContentTypesCollection implements ICollection<InCodeTypeSpec> {
     title?: string;
     icon?: string;
     description?: string;
-    constructor({
-        name, title, icon, description, types
-    }: ContentTypesCollectionProps) {
+    constructor({ name, title, icon, description, types }: ContentTypesCollectionProps) {
         this.name = name;
         this.title = title || kebabCaseToTitle(name);
         this.icon = icon;
@@ -36,7 +34,7 @@ export class ContentTypesCollection implements ICollection<InCodeTypeSpec> {
                 } else {
                     return { done: true, value: undefined };
                 }
-            }
+            },
         };
     }
 
@@ -45,7 +43,6 @@ export class ContentTypesCollection implements ICollection<InCodeTypeSpec> {
     }
 
     getTypeByName(name: string): InCodeTypeSpec | undefined {
-        return this.types.find(type => type.name === name);
+        return this.types.find((type) => type.name === name);
     }
-
 }

package/src/InteractionCollection.ts

@@ -1,6 +1,6 @@
-import { InteractionSpec } from "@vertesia/common";
-import { CollectionProperties, ICollection } from "./types.js";
-import { kebabCaseToTitle } from "./utils.js";
+import type { InteractionSpec } from '@vertesia/common';
+import type { CollectionProperties, ICollection } from './types.js';
+import { kebabCaseToTitle } from './utils.js';
 
 export interface InteractionCollectionProps extends CollectionProperties {
     interactions: InteractionSpec[];
@@ -11,9 +11,7 @@ export class InteractionCollection implements ICollection<InteractionSpec> {
     title?: string;
     icon?: string;
     description?: string;
-    constructor({
-        name, title, icon, description, interactions
-    }: InteractionCollectionProps) {
+    constructor({ name, title, icon, description, interactions }: InteractionCollectionProps) {
         this.name = name;
         this.title = title || kebabCaseToTitle(name);
         this.icon = icon;
@@ -36,7 +34,7 @@ export class InteractionCollection implements ICollection<InteractionSpec> {
                 } else {
                     return { done: true, value: undefined };
                 }
-            }
+            },
         };
     }
 
@@ -45,6 +43,6 @@ export class InteractionCollection implements ICollection<InteractionSpec> {
     }
 
     getInteractionByName(name: string): InteractionSpec | undefined {
-        return this.interactions.find(interaction => interaction.name === name);
+        return this.interactions.find((interaction) => interaction.name === name);
     }
 }