@vurb/core 3.2.0

package/dist/domain/BaseModel.d.ts

@@ -0,0 +1,50 @@
+import { type Icon } from './Icon.js';
+/**
+ * Base class for all MCP domain model entities.
+ *
+ * Provides common metadata properties shared by all MCP domain objects
+ * (tools, resources, prompts, groups). Every entity has a `name`,
+ * optional `title`, `description`, `meta`, and `icons`.
+ *
+ * @example
+ * ```typescript
+ * // BaseModel is abstract — use concrete subclasses:
+ * const tool = new Tool('read_file');
+ * tool.title = 'Read File';
+ * tool.description = 'Read a file from the filesystem';
+ * tool.meta = new Map([['version', '1.0']]);
+ * ```
+ *
+ * @see {@link Group} for tree nodes
+ * @see {@link GroupItem} for leaf nodes (Tool, Prompt, Resource)
+ */
+export declare abstract class BaseModel {
+    /** Default separator used in fully qualified names */
+    static readonly DEFAULT_SEPARATOR: string;
+    /** Separator character for constructing fully qualified names */
+    readonly nameSeparator: string;
+    /** Unique identifier within the parent scope */
+    readonly name: string;
+    /** Human-readable display title */
+    title: string | undefined;
+    /** Detailed description of this entity's purpose */
+    description: string | undefined;
+    /** Arbitrary key-value metadata for extensibility */
+    meta: Map<string, unknown> | undefined;
+    /** Visual icons associated with this entity */
+    icons: Icon[] | undefined;
+    protected constructor(name: string, nameSeparator?: string);
+    /**
+     * Returns the fully qualified name including all ancestor paths.
+     *
+     * @example
+     * ```typescript
+     * const parent = new Group('api');
+     * const child = new Group('v2');
+     * parent.addChildGroup(child);
+     * child.getFullyQualifiedName(); // "api.v2"
+     * ```
+     */
+    abstract getFullyQualifiedName(): string;
+}
+//# sourceMappingURL=BaseModel.d.ts.map

package/dist/domain/BaseModel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseModel.d.ts","sourceRoot":"","sources":["../../src/domain/BaseModel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC;;;;;;;;;;;;;;;;;;GAkBG;AACH,8BAAsB,SAAS;IAC3B,sDAAsD;IACtD,gBAAuB,iBAAiB,EAAE,MAAM,CAAO;IAEvD,iEAAiE;IACjE,SAAgB,aAAa,EAAE,MAAM,CAAC;IACtC,gDAAgD;IAChD,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,mCAAmC;IAC5B,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,oDAAoD;IAC7C,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,qDAAqD;IAC9C,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC9C,+CAA+C;IACxC,KAAK,EAAE,IAAI,EAAE,GAAG,SAAS,CAAC;IAEjC,SAAS,aAAa,IAAI,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM;IAK1D;;;;;;;;;;OAUG;aACa,qBAAqB,IAAI,MAAM;CAClD"}

package/dist/domain/BaseModel.js

@@ -0,0 +1,41 @@
+import {} from './Icon.js';
+/**
+ * Base class for all MCP domain model entities.
+ *
+ * Provides common metadata properties shared by all MCP domain objects
+ * (tools, resources, prompts, groups). Every entity has a `name`,
+ * optional `title`, `description`, `meta`, and `icons`.
+ *
+ * @example
+ * ```typescript
+ * // BaseModel is abstract — use concrete subclasses:
+ * const tool = new Tool('read_file');
+ * tool.title = 'Read File';
+ * tool.description = 'Read a file from the filesystem';
+ * tool.meta = new Map([['version', '1.0']]);
+ * ```
+ *
+ * @see {@link Group} for tree nodes
+ * @see {@link GroupItem} for leaf nodes (Tool, Prompt, Resource)
+ */
+export class BaseModel {
+    /** Default separator used in fully qualified names */
+    static DEFAULT_SEPARATOR = ".";
+    /** Separator character for constructing fully qualified names */
+    nameSeparator;
+    /** Unique identifier within the parent scope */
+    name;
+    /** Human-readable display title */
+    title;
+    /** Detailed description of this entity's purpose */
+    description;
+    /** Arbitrary key-value metadata for extensibility */
+    meta;
+    /** Visual icons associated with this entity */
+    icons;
+    constructor(name, nameSeparator) {
+        this.name = name;
+        this.nameSeparator = nameSeparator ?? BaseModel.DEFAULT_SEPARATOR;
+    }
+}
+//# sourceMappingURL=BaseModel.js.map

package/dist/domain/BaseModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseModel.js","sourceRoot":"","sources":["../../src/domain/BaseModel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,MAAM,WAAW,CAAC;AAEtC;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAgB,SAAS;IAC3B,sDAAsD;IAC/C,MAAM,CAAU,iBAAiB,GAAW,GAAG,CAAC;IAEvD,iEAAiE;IACjD,aAAa,CAAS;IACtC,gDAAgD;IAChC,IAAI,CAAS;IAC7B,mCAAmC;IAC5B,KAAK,CAAqB;IACjC,oDAAoD;IAC7C,WAAW,CAAqB;IACvC,qDAAqD;IAC9C,IAAI,CAAmC;IAC9C,+CAA+C;IACxC,KAAK,CAAqB;IAEjC,YAAsB,IAAY,EAAE,aAAsB;QACtD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,aAAa,GAAG,aAAa,IAAI,SAAS,CAAC,iBAAiB,CAAC;IACtE,CAAC"}

package/dist/domain/Group.d.ts

@@ -0,0 +1,99 @@
+import { BaseModel } from './BaseModel.js';
+import { type Tool } from './Tool.js';
+import { type Prompt } from './Prompt.js';
+import { type Resource } from './Resource.js';
+/**
+ * Represents a hierarchical group (tree node) in the MCP domain model.
+ *
+ * Groups can contain child groups, tools, prompts, and resources.
+ * Supports fully qualified names via recursive parent traversal.
+ *
+ * @example
+ * ```typescript
+ * // Build a hierarchy
+ * const api = new Group('api');
+ * const v2 = new Group('v2');
+ * api.addChildGroup(v2);
+ *
+ * const readFile = new Tool('read_file');
+ * v2.addChildTool(readFile);
+ *
+ * v2.getFullyQualifiedName();  // "api.v2"
+ * api.isRoot();                // true
+ * v2.getRoot();                // api
+ * ```
+ *
+ * @see {@link GroupItem} for leaf nodes (Tool, Prompt, Resource)
+ * @see {@link BaseModel} for shared properties
+ */
+export declare class Group extends BaseModel {
+    /** Parent group (null if this is a root node) */
+    parent: Group | null;
+    /** Direct child groups in this container */
+    readonly childGroups: Group[];
+    /** Tools contained in this group */
+    readonly childTools: Tool[];
+    /** Prompts contained in this group */
+    readonly childPrompts: Prompt[];
+    /** Resources contained in this group */
+    readonly childResources: Resource[];
+    constructor(name: string, nameSeparator?: string);
+    private addChild;
+    private removeChild;
+    /**
+     * Traverse to the root of the tree.
+     *
+     * @returns The topmost ancestor group
+     *
+     * @example
+     * ```typescript
+     * const root = new Group('api');
+     * const child = new Group('users');
+     * root.addChildGroup(child);
+     * child.getRoot(); // root
+     * ```
+     */
+    getRoot(): Group;
+    /** Returns `true` if this group has no parent (is a root node). */
+    isRoot(): boolean;
+    /**
+     * Add a child group to this container.
+     *
+     * @param childGroup - The group to nest under this one
+     * @returns `false` if already a child, `true` if added
+     */
+    addChildGroup(childGroup: Group): boolean;
+    /**
+     * Remove a child group from this container.
+     *
+     * @param childGroup - The group to remove
+     * @returns `false` if not found, `true` if removed
+     */
+    removeChildGroup(childGroup: Group): boolean;
+    /** Add a tool to this group. Returns `false` if already present. */
+    addChildTool(childTool: Tool): boolean;
+    /** Remove a tool from this group. Returns `false` if not found. */
+    removeChildTool(childTool: Tool): boolean;
+    /** Add a prompt to this group. Returns `false` if already present. */
+    addChildPrompt(childPrompt: Prompt): boolean;
+    /** Remove a prompt from this group. Returns `false` if not found. */
+    removeChildPrompt(childPrompt: Prompt): boolean;
+    /** Add a resource to this group. Returns `false` if already present. */
+    addChildResource(childResource: Resource): boolean;
+    /** Remove a resource from this group. Returns `false` if not found. */
+    removeChildResource(childResource: Resource): boolean;
+    protected getFullyQualifiedNameRecursive(tg: Group): string;
+    /**
+     * Returns the dot-separated fully qualified name.
+     *
+     * @example
+     * ```typescript
+     * const root = new Group('api');
+     * const v2 = new Group('v2');
+     * root.addChildGroup(v2);
+     * v2.getFullyQualifiedName(); // "api.v2"
+     * ```
+     */
+    getFullyQualifiedName(): string;
+}
+//# sourceMappingURL=Group.d.ts.map

package/dist/domain/Group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Group.d.ts","sourceRoot":"","sources":["../../src/domain/Group.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAG9C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,KAAM,SAAQ,SAAS;IAChC,iDAAiD;IAC1C,MAAM,EAAE,KAAK,GAAG,IAAI,CAAQ;IACnC,4CAA4C;IAC5C,SAAgB,WAAW,EAAE,KAAK,EAAE,CAAC;IACrC,oCAAoC;IACpC,SAAgB,UAAU,EAAE,IAAI,EAAE,CAAC;IACnC,sCAAsC;IACtC,SAAgB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvC,wCAAwC;IACxC,SAAgB,cAAc,EAAE,QAAQ,EAAE,CAAC;gBAExB,IAAI,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM;IAUvD,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,WAAW;IAQnB;;;;;;;;;;;;OAYG;IACI,OAAO,IAAI,KAAK;IAIvB,mEAAmE;IAC5D,MAAM,IAAI,OAAO;IAMxB;;;;;OAKG;IACI,aAAa,CAAC,UAAU,EAAE,KAAK,GAAG,OAAO;IAyBhD;;;;;OAKG;IACI,gBAAgB,CAAC,UAAU,EAAE,KAAK,GAAG,OAAO;IAQnD,oEAAoE;IAC7D,YAAY,CAAC,SAAS,EAAE,IAAI,GAAG,OAAO;IAI7C,mEAAmE;IAC5D,eAAe,CAAC,SAAS,EAAE,IAAI,GAAG,OAAO;IAIhD,sEAAsE;IAC/D,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAInD,qEAAqE;IAC9D,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAItD,wEAAwE;IACjE,gBAAgB,CAAC,aAAa,EAAE,QAAQ,GAAG,OAAO;IAIzD,uEAAuE;IAChE,mBAAmB,CAAC,aAAa,EAAE,QAAQ,GAAG,OAAO;IAM5D,SAAS,CAAC,8BAA8B,CAAC,EAAE,EAAE,KAAK,GAAG,MAAM;IAS3D;;;;;;;;;;OAUG;IACI,qBAAqB,IAAI,MAAM;CAGzC"}

package/dist/domain/Group.js

@@ -0,0 +1,172 @@
+import { BaseModel } from './BaseModel.js';
+import {} from './GroupItem.js';
+import {} from './Tool.js';
+import {} from './Prompt.js';
+import {} from './Resource.js';
+import { removeFromArray } from './utils.js';
+/**
+ * Represents a hierarchical group (tree node) in the MCP domain model.
+ *
+ * Groups can contain child groups, tools, prompts, and resources.
+ * Supports fully qualified names via recursive parent traversal.
+ *
+ * @example
+ * ```typescript
+ * // Build a hierarchy
+ * const api = new Group('api');
+ * const v2 = new Group('v2');
+ * api.addChildGroup(v2);
+ *
+ * const readFile = new Tool('read_file');
+ * v2.addChildTool(readFile);
+ *
+ * v2.getFullyQualifiedName();  // "api.v2"
+ * api.isRoot();                // true
+ * v2.getRoot();                // api
+ * ```
+ *
+ * @see {@link GroupItem} for leaf nodes (Tool, Prompt, Resource)
+ * @see {@link BaseModel} for shared properties
+ */
+export class Group extends BaseModel {
+    /** Parent group (null if this is a root node) */
+    parent = null;
+    /** Direct child groups in this container */
+    childGroups;
+    /** Tools contained in this group */
+    childTools;
+    /** Prompts contained in this group */
+    childPrompts;
+    /** Resources contained in this group */
+    childResources;
+    constructor(name, nameSeparator) {
+        super(name, nameSeparator !== undefined ? nameSeparator : BaseModel.DEFAULT_SEPARATOR);
+        this.childGroups = [];
+        this.childTools = [];
+        this.childPrompts = [];
+        this.childResources = [];
+    }
+    // ── Private helpers to eliminate add/remove repetition ──
+    addChild(list, child) {
+        if (list.includes(child))
+            return false;
+        list.push(child);
+        child.addParentGroup(this);
+        return true;
+    }
+    removeChild(list, child) {
+        if (!removeFromArray(list, child))
+            return false;
+        child.removeParentGroup(this);
+        return true;
+    }
+    // ── Tree navigation ──
+    /**
+     * Traverse to the root of the tree.
+     *
+     * @returns The topmost ancestor group
+     *
+     * @example
+     * ```typescript
+     * const root = new Group('api');
+     * const child = new Group('users');
+     * root.addChildGroup(child);
+     * child.getRoot(); // root
+     * ```
+     */
+    getRoot() {
+        return this.parent === null ? this : this.parent.getRoot();
+    }
+    /** Returns `true` if this group has no parent (is a root node). */
+    isRoot() {
+        return this.parent === null;
+    }
+    // ── Child groups (special: sets parent, not parentGroup) ──
+    /**
+     * Add a child group to this container.
+     *
+     * @param childGroup - The group to nest under this one
+     * @returns `false` if already a child, `true` if added
+     */
+    addChildGroup(childGroup) {
+        if (this.childGroups.includes(childGroup))
+            return false;
+        // Bug #52: Cycle detection — walk the parent chain to prevent infinite recursion
+        // eslint-disable-next-line @typescript-eslint/no-this-alias
+        let ancestor = this;
+        while (ancestor !== null) {
+            if (ancestor === childGroup) {
+                throw new Error(`[Vurb] Cycle detected: adding '${childGroup.name}' as a child of '${this.name}' would create a circular reference.`);
+            }
+            ancestor = ancestor.parent;
+        }
+        // Remove from previous parent to avoid ghost references (Bug #7 fix)
+        if (childGroup.parent !== null) {
+            childGroup.parent.removeChildGroup(childGroup);
+        }
+        this.childGroups.push(childGroup);
+        childGroup.parent = this;
+        return true;
+    }
+    /**
+     * Remove a child group from this container.
+     *
+     * @param childGroup - The group to remove
+     * @returns `false` if not found, `true` if removed
+     */
+    removeChildGroup(childGroup) {
+        if (!removeFromArray(this.childGroups, childGroup))
+            return false;
+        childGroup.parent = null;
+        return true;
+    }
+    // ── Child items (delegated to helpers) ──
+    /** Add a tool to this group. Returns `false` if already present. */
+    addChildTool(childTool) {
+        return this.addChild(this.childTools, childTool);
+    }
+    /** Remove a tool from this group. Returns `false` if not found. */
+    removeChildTool(childTool) {
+        return this.removeChild(this.childTools, childTool);
+    }
+    /** Add a prompt to this group. Returns `false` if already present. */
+    addChildPrompt(childPrompt) {
+        return this.addChild(this.childPrompts, childPrompt);
+    }
+    /** Remove a prompt from this group. Returns `false` if not found. */
+    removeChildPrompt(childPrompt) {
+        return this.removeChild(this.childPrompts, childPrompt);
+    }
+    /** Add a resource to this group. Returns `false` if already present. */
+    addChildResource(childResource) {
+        return this.addChild(this.childResources, childResource);
+    }
+    /** Remove a resource from this group. Returns `false` if not found. */
+    removeChildResource(childResource) {
+        return this.removeChild(this.childResources, childResource);
+    }
+    // ── FQN ──
+    getFullyQualifiedNameRecursive(tg) {
+        const parent = tg.parent;
+        if (parent !== null) {
+            const parentName = this.getFullyQualifiedNameRecursive(parent);
+            return parentName + this.nameSeparator + tg.name;
+        }
+        return tg.name;
+    }
+    /**
+     * Returns the dot-separated fully qualified name.
+     *
+     * @example
+     * ```typescript
+     * const root = new Group('api');
+     * const v2 = new Group('v2');
+     * root.addChildGroup(v2);
+     * v2.getFullyQualifiedName(); // "api.v2"
+     * ```
+     */
+    getFullyQualifiedName() {
+        return this.getFullyQualifiedNameRecursive(this);
+    }
+}
+//# sourceMappingURL=Group.js.map

package/dist/domain/Group.js.map

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

package/dist/domain/GroupItem.d.ts

@@ -0,0 +1,46 @@
+import { BaseModel } from './BaseModel.js';
+import type { Group } from './Group.js';
+/**
+ * Base class for leaf entities that can belong to one or more Groups.
+ *
+ * {@link Tool}, {@link Prompt}, and {@link Resource} all extend this
+ * class to inherit group membership management. Supports many-to-many
+ * relationships with parent groups.
+ *
+ * @example
+ * ```typescript
+ * const tool = new Tool('read_file');
+ * const group = new Group('filesystem');
+ *
+ * group.addChildTool(tool);
+ * tool.parentGroups; // [group]
+ * ```
+ *
+ * @see {@link Group} for parent containers
+ * @see {@link Tool} for tool leaf nodes
+ * @see {@link Prompt} for prompt leaf nodes
+ * @see {@link Resource} for resource leaf nodes
+ */
+export declare class GroupItem extends BaseModel {
+    /** Groups that contain this item (many-to-many relationship) */
+    readonly parentGroups: Group[];
+    protected constructor(name: string, nameSeparator?: string);
+    /**
+     * Add this item to a parent group.
+     *
+     * @param parentGroup - The group to join
+     * @returns `false` if already a member, `true` if added
+     * @internal Use {@link Group.addChildTool} / {@link Group.addChildPrompt} / {@link Group.addChildResource} instead.
+     */
+    addParentGroup(parentGroup: Group): boolean;
+    /**
+     * Remove this item from a parent group.
+     *
+     * @param parentGroup - The group to leave
+     * @returns `false` if not found, `true` if removed
+     */
+    removeParentGroup(parentGroup: Group): boolean;
+    /** Returns the simple name (leaf items have no hierarchy prefix) */
+    getFullyQualifiedName(): string;
+}
+//# sourceMappingURL=GroupItem.d.ts.map

package/dist/domain/GroupItem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GroupItem.d.ts","sourceRoot":"","sources":["../../src/domain/GroupItem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGxC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,SAAU,SAAQ,SAAS;IACpC,gEAAgE;IAChE,SAAgB,YAAY,EAAE,KAAK,EAAE,CAAC;IAEtC,SAAS,aAAa,IAAI,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM;IAK1D;;;;;;OAMG;IACI,cAAc,CAAC,WAAW,EAAE,KAAK,GAAG,OAAO;IAMlD;;;;;OAKG;IACI,iBAAiB,CAAC,WAAW,EAAE,KAAK,GAAG,OAAO;IAIrD,oEAAoE;IAC7D,qBAAqB,IAAI,MAAM;CAGzC"}

package/dist/domain/GroupItem.js

@@ -0,0 +1,58 @@
+import { BaseModel } from './BaseModel.js';
+import { removeFromArray } from './utils.js';
+/**
+ * Base class for leaf entities that can belong to one or more Groups.
+ *
+ * {@link Tool}, {@link Prompt}, and {@link Resource} all extend this
+ * class to inherit group membership management. Supports many-to-many
+ * relationships with parent groups.
+ *
+ * @example
+ * ```typescript
+ * const tool = new Tool('read_file');
+ * const group = new Group('filesystem');
+ *
+ * group.addChildTool(tool);
+ * tool.parentGroups; // [group]
+ * ```
+ *
+ * @see {@link Group} for parent containers
+ * @see {@link Tool} for tool leaf nodes
+ * @see {@link Prompt} for prompt leaf nodes
+ * @see {@link Resource} for resource leaf nodes
+ */
+export class GroupItem extends BaseModel {
+    /** Groups that contain this item (many-to-many relationship) */
+    parentGroups;
+    constructor(name, nameSeparator) {
+        super(name, nameSeparator);
+        this.parentGroups = [];
+    }
+    /**
+     * Add this item to a parent group.
+     *
+     * @param parentGroup - The group to join
+     * @returns `false` if already a member, `true` if added
+     * @internal Use {@link Group.addChildTool} / {@link Group.addChildPrompt} / {@link Group.addChildResource} instead.
+     */
+    addParentGroup(parentGroup) {
+        if (this.parentGroups.includes(parentGroup))
+            return false;
+        this.parentGroups.push(parentGroup);
+        return true;
+    }
+    /**
+     * Remove this item from a parent group.
+     *
+     * @param parentGroup - The group to leave
+     * @returns `false` if not found, `true` if removed
+     */
+    removeParentGroup(parentGroup) {
+        return removeFromArray(this.parentGroups, parentGroup);
+    }
+    /** Returns the simple name (leaf items have no hierarchy prefix) */
+    getFullyQualifiedName() {
+        return this.name;
+    }
+}
+//# sourceMappingURL=GroupItem.js.map

package/dist/domain/GroupItem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GroupItem.js","sourceRoot":"","sources":["../../src/domain/GroupItem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAO,SAAU,SAAQ,SAAS;IACpC,gEAAgE;IAChD,YAAY,CAAU;IAEtC,YAAsB,IAAY,EAAE,aAAsB;QACtD,KAAK,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;QAC3B,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC;IAC3B,CAAC;IAED;;;;;;OAMG;IACI,cAAc,CAAC,WAAkB;QACpC,IAAI,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,WAAW,CAAC;YAAE,OAAO,KAAK,CAAC;QAC1D,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACI,iBAAiB,CAAC,WAAkB;QACvC,OAAO,eAAe,CAAC,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;IAC3D,CAAC;IAED,oEAAoE;IAC7D,qBAAqB;QACxB,OAAO,IAAI,CAAC,IAAI,CAAC;IACrB,CAAC;CACJ"}

package/dist/domain/Icon.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Icon definition for entity metadata.
+ *
+ * Icons can be associated with {@link Group}, {@link Tool},
+ * or any {@link BaseModel} entity.
+ *
+ * @example
+ * ```typescript
+ * import { createIcon } from 'vurb';
+ *
+ * const icon = createIcon({
+ *     src: 'https://example.com/icon.png',
+ *     mimeType: 'image/png',
+ *     sizes: ['32x32', '64x64'],
+ *     theme: 'dark',
+ * });
+ * ```
+ */
+export interface Icon {
+    /** URL or path to the icon image */
+    readonly src?: string;
+    /** MIME type of the icon (e.g. `"image/png"`, `"image/svg+xml"`) */
+    readonly mimeType?: string;
+    /** Available sizes (e.g. `["32x32", "64x64"]`) */
+    readonly sizes?: readonly string[];
+    /** Theme variant (e.g. `"dark"`, `"light"`) */
+    readonly theme?: string;
+}
+/**
+ * Create an Icon from partial properties.
+ *
+ * @param props - Icon properties (all optional)
+ * @returns A frozen Icon instance
+ *
+ * @example
+ * ```typescript
+ * const icon = createIcon({ src: '/icons/tool.svg', mimeType: 'image/svg+xml' });
+ * ```
+ */
+export declare function createIcon(props?: Icon): Icon;
+//# sourceMappingURL=Icon.d.ts.map

package/dist/domain/Icon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Icon.d.ts","sourceRoot":"","sources":["../../src/domain/Icon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,IAAI;IACjB,oCAAoC;IACpC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,kDAAkD;IAClD,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,KAAK,GAAE,IAAS,GAAG,IAAI,CAEjD"}

package/dist/domain/Icon.js

@@ -0,0 +1,15 @@
+/**
+ * Create an Icon from partial properties.
+ *
+ * @param props - Icon properties (all optional)
+ * @returns A frozen Icon instance
+ *
+ * @example
+ * ```typescript
+ * const icon = createIcon({ src: '/icons/tool.svg', mimeType: 'image/svg+xml' });
+ * ```
+ */
+export function createIcon(props = {}) {
+    return { ...props };
+}
+//# sourceMappingURL=Icon.js.map

package/dist/domain/Icon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Icon.js","sourceRoot":"","sources":["../../src/domain/Icon.ts"],"names":[],"mappings":"AA6BA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,UAAU,CAAC,QAAc,EAAE;IACvC,OAAO,EAAE,GAAG,KAAK,EAAE,CAAC;AACxB,CAAC"}

package/dist/domain/Prompt.d.ts

@@ -0,0 +1,49 @@
+import { GroupItem } from './GroupItem.js';
+import { type PromptArgument } from './PromptArgument.js';
+/**
+ * Represents an MCP Prompt — a reusable template for LLM interactions.
+ *
+ * Prompts are leaf nodes that define structured input templates
+ * with named arguments. They enable consistent, parameterized
+ * LLM interactions.
+ *
+ * @example
+ * ```typescript
+ * import { Prompt, PromptArgument } from 'vurb';
+ *
+ * const prompt = new Prompt('generate_summary');
+ * prompt.description = 'Generate a summary of the given text';
+ *
+ * const textArg = new PromptArgument('text');
+ * textArg.required = true;
+ * textArg.description = 'The text to summarize';
+ * prompt.addPromptArgument(textArg);
+ *
+ * const styleArg = new PromptArgument('style');
+ * styleArg.description = 'Summary style (brief, detailed)';
+ * prompt.addPromptArgument(styleArg);
+ * ```
+ *
+ * @see {@link PromptArgument} for argument definitions
+ * @see {@link GroupItem} for group membership
+ */
+export declare class Prompt extends GroupItem {
+    /** Ordered list of arguments accepted by this prompt */
+    readonly promptArguments: PromptArgument[];
+    constructor(name: string);
+    /**
+     * Add an argument to this prompt.
+     *
+     * @param promptArgument - The argument to add
+     * @returns `false` if already present, `true` if added
+     */
+    addPromptArgument(promptArgument: PromptArgument): boolean;
+    /**
+     * Remove an argument from this prompt.
+     *
+     * @param promptArgument - The argument to remove
+     * @returns `false` if not found, `true` if removed
+     */
+    removePromptArgument(promptArgument: PromptArgument): boolean;
+}
+//# sourceMappingURL=Prompt.d.ts.map

package/dist/domain/Prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Prompt.d.ts","sourceRoot":"","sources":["../../src/domain/Prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,MAAO,SAAQ,SAAS;IACjC,wDAAwD;IACxD,SAAgB,eAAe,EAAE,cAAc,EAAE,CAAM;gBAEpC,IAAI,EAAE,MAAM;IAI/B;;;;;OAKG;IACI,iBAAiB,CAAC,cAAc,EAAE,cAAc,GAAG,OAAO;IAMjE;;;;;OAKG;IACI,oBAAoB,CAAC,cAAc,EAAE,cAAc,GAAG,OAAO;CAGvE"}