@vibesdotdev/chat 0.0.0-stage → 1.0.0-rc.0

package/dist/mentions/client/mentions-client.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Mentions Runtime Client
+ *
+ * Orchestrates parse-time, resolve-time, and notify-time operations
+ * for @mention tokens in stored content.
+ */
+import { type KindContext, type VibesRuntime } from '@vibesdotdev/kernel';
+import { BaseRuntimeClient, type RuntimeClient, type RuntimeClientDescriptor } from '@vibesdotdev/kernel/client';
+import type { MentionToken, MentionResolution, MentionSource, RenderSegment } from '../schemas/index.ts';
+/**
+ * Strict resolution options.
+ */
+export interface ResolveOptions {
+    /** When true and no resolver is registered for the requested namespace, throw instead of returning unresolved. */
+    strict?: boolean;
+}
+/**
+ * Notification payload dispatched when users or agents are mentioned.
+ */
+export interface MentionNotificationPayload {
+    userId: string;
+    channel: string;
+    priority: string;
+    title: string;
+    body: string;
+    actionUrl?: string;
+    coalesceKey: string;
+}
+/**
+ * Platform notifications sender contract for mention dispatch.
+ */
+export interface MentionNotificationsClient extends RuntimeClient {
+    send(input: MentionNotificationPayload): Promise<void>;
+}
+/**
+ * Mentions client interface.
+ */
+export interface MentionsClient {
+    /**
+     * Parse mentions from text.
+     * Returns MentionToken[] with raw, slug, namespace, display, range.
+     */
+    parse(text: string): MentionToken[];
+    /**
+     * Resolve mentions via registered resolvers.
+     * Dispatches through runtime.query('mentions/resolver').
+     */
+    resolve(tokens: MentionToken[], options?: ResolveOptions): Promise<Map<MentionToken, MentionResolution>>;
+    /**
+     * Render mentions to structured segments.
+     * Uses pre-resolved resolutions or resolves on-demand.
+     */
+    render(text: string, tokens: MentionToken[], resolutions?: Map<MentionToken, MentionResolution>): Promise<RenderSegment[]>;
+    /**
+     * Send notifications for mentions.
+     * Dispatches through getVibesNotificationsClient(runtime) for resolved user/agent mentions.
+     */
+    notify(text: string, tokens: MentionToken[], fromUserId: string, source: MentionSource): Promise<void>;
+}
+/**
+ * Runtime-resolved mentions client extending BaseRuntimeClient.
+ */
+export declare class RuntimeMentionsClient extends BaseRuntimeClient implements MentionsClient {
+    private notificationClient;
+    constructor(descriptor?: RuntimeClientDescriptor, context?: KindContext, runtime?: VibesRuntime);
+    /**
+     * Parse @mentions from text.
+     * Supports: @slug, @("quoted name"), @ns:slug (namespace prefix).
+     */
+    parse(text: string): MentionToken[];
+    /**
+     * Resolve tokens via registered namespace resolvers.
+     */
+    resolve(tokens: MentionToken[], options?: ResolveOptions): Promise<Map<MentionToken, MentionResolution>>;
+    /**
+     * Render mentions to structured segments.
+     */
+    render(text: string, tokens: MentionToken[], resolutions?: Map<MentionToken, MentionResolution>): Promise<RenderSegment[]>;
+    /**
+     * Send notifications for resolved mentions.
+     */
+    notify(text: string, tokens: MentionToken[], fromUserId: string, source: MentionSource): Promise<void>;
+    private findResolverForNamespace;
+    private resolveBareToken;
+    private getNotificationsClient;
+}
+/**
+ * Parse @mentions from text.
+ *
+ * Supports:
+ *   @slug           — simple identifier (bare)
+ *   @ns:slug       — namespace-prefixed (e.g., @agent:oracle, @user:alice)
+ *   @("name with spaces") — quoted display name
+ */
+export declare function parseMentions(text: string): MentionToken[];
+/**
+ * Canonical slug derivation from display name.
+ * Used by parser, AI augment, and resolver registrations.
+ */
+export declare function displayToSlug(display: string): string;
+/**
+ * Low-level render to segments.
+ * Callers can drive resolution themselves via the resolutions map.
+ */
+export declare function renderSegments(text: string, tokens: MentionToken[], resolutions: Map<MentionToken, MentionResolution>, options?: {
+    fallback?: (token: MentionToken) => string;
+}): RenderSegment[];
+/**
+ * Simple render-to-string helper.
+ */
+export declare function renderSegmentsToString(segments: RenderSegment[]): string;
+//# sourceMappingURL=mentions-client.d.ts.map

package/dist/mentions/client/mentions-client.d.ts.map

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

package/dist/mentions/client/mentions-client.js

@@ -0,0 +1,328 @@
+/**
+ * Mentions Runtime Client
+ *
+ * Orchestrates parse-time, resolve-time, and notify-time operations
+ * for @mention tokens in stored content.
+ */
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { BaseRuntimeClient } from '@vibesdotdev/kernel/client';
+import { MentionTokenSchema } from "../schemas/index.js";
+/**
+ * Runtime-resolved mentions client extending BaseRuntimeClient.
+ */
+export class RuntimeMentionsClient extends BaseRuntimeClient {
+    notificationClient = null;
+    constructor(descriptor = { id: 'mentions', kind: 'runtime/client' }, context, runtime) {
+        super(descriptor, context, runtime);
+    }
+    /**
+     * Parse @mentions from text.
+     * Supports: @slug, @("quoted name"), @ns:slug (namespace prefix).
+     */
+    parse(text) {
+        return parseMentions(text);
+    }
+    /**
+     * Resolve tokens via registered namespace resolvers.
+     */
+    async resolve(tokens, options) {
+        const results = new Map();
+        // Group tokens by namespace (or undefined for bare tokens)
+        const byNamespace = new Map();
+        for (const token of tokens) {
+            const ns = token.namespace;
+            const list = byNamespace.get(ns) ?? [];
+            list.push(token);
+            byNamespace.set(ns, list);
+        }
+        // Resolve each group
+        for (const [namespace, groupTokens] of byNamespace) {
+            if (namespace) {
+                // Explicit namespace — find resolver by namespace
+                const resolver = await this.findResolverForNamespace(namespace, options?.strict);
+                if (resolver) {
+                    for (const token of groupTokens) {
+                        const resolution = await resolver.resolve(token);
+                        results.set(token, resolution);
+                    }
+                }
+                else {
+                    // No resolver for this namespace
+                    for (const token of groupTokens) {
+                        results.set(token, { resolved: false });
+                    }
+                }
+            }
+            else {
+                // Bare tokens — try resolvers in priority order
+                for (const token of groupTokens) {
+                    const resolution = await this.resolveBareToken(token);
+                    results.set(token, resolution);
+                }
+            }
+        }
+        return results;
+    }
+    /**
+     * Render mentions to structured segments.
+     */
+    async render(text, tokens, resolutions) {
+        const resolvedMap = resolutions ?? (await this.resolve(tokens));
+        return renderSegments(text, tokens, resolvedMap);
+    }
+    /**
+     * Send notifications for resolved mentions.
+     */
+    async notify(text, tokens, fromUserId, source) {
+        // Resolve tokens first
+        const resolutions = await this.resolve(tokens);
+        // Get unique resolved mentions by ID
+        const uniqueById = new Map();
+        for (const token of tokens) {
+            const resolution = resolutions.get(token);
+            if (resolution?.resolved && resolution.id) {
+                if (!uniqueById.has(resolution.id)) {
+                    uniqueById.set(resolution.id, { token, resolution });
+                }
+            }
+        }
+        // Get notifications client
+        const notifications = await this.getNotificationsClient();
+        if (!notifications) {
+            // Notifications not available — silently return
+            return;
+        }
+        // Send notification for each unique mention
+        for (const { resolution } of uniqueById.values()) {
+            // Only notify for user/agent/being types (not system)
+            const type = resolution.type ?? 'user';
+            if (resolution.id && (type === 'user' || type === 'agent' || type === 'being')) {
+                await notifications.send({
+                    userId: resolution.id,
+                    channel: 'in-app',
+                    priority: 'normal',
+                    title: `You were mentioned in ${source.type}`,
+                    body: text.slice(0, 200),
+                    actionUrl: source.url,
+                    coalesceKey: `mention:${source.type}:${source.id}`
+                });
+            }
+        }
+    }
+    // ------------------------------------------------------------------
+    // Internal helpers
+    // ------------------------------------------------------------------
+    async findResolverForNamespace(namespace, strict) {
+        await this.ensureLoaded();
+        if (!this.runtime.hasKind('mentions/resolver')) {
+            if (strict) {
+                throw new CapabilityError(`No mentions/resolver kind registered (strict mode)`, 'NOT_FOUND', { reason: 'mentions-resolver-kind-missing' });
+            }
+            return null;
+        }
+        // Query all resolvers and find one matching the namespace
+        const descriptors = this.runtime
+            .query('mentions/resolver')
+            .descriptors();
+        const matching = descriptors.filter((d) => d.namespace === namespace);
+        if (matching.length === 0) {
+            if (strict) {
+                throw new CapabilityError(`No resolver registered for namespace '${namespace}' (strict mode)`, 'NOT_FOUND', { reason: 'mentions-resolver-missing' });
+            }
+            return null;
+        }
+        // Sort by priority and take highest
+        const sorted = [...matching].sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0));
+        const winner = sorted[0];
+        // Resolve the implementation
+        try {
+            return await this.runtime
+                .query('mentions/resolver')
+                .withId(winner.id)
+                .resolve();
+        }
+        catch (error) {
+            if (error instanceof Error && CapabilityError.isAbsenceOf(error, 'mentions/resolver', winner.id)) {
+                return null;
+            }
+            throw error;
+        }
+    }
+    async resolveBareToken(token) {
+        await this.ensureLoaded();
+        if (!this.runtime.hasKind('mentions/resolver')) {
+            return { resolved: false };
+        }
+        // Get all resolvers sorted by priority
+        const descriptors = this.runtime
+            .query('mentions/resolver')
+            .descriptors();
+        const sorted = [...descriptors].sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0));
+        // Try each resolver in order
+        for (const descriptor of sorted) {
+            try {
+                const resolver = await this.runtime
+                    .query('mentions/resolver')
+                    .withId(descriptor.id)
+                    .resolve();
+                if (resolver) {
+                    const result = await resolver.resolve(token);
+                    if (result.resolved) {
+                        return result;
+                    }
+                }
+            }
+            catch (error) {
+                if (error instanceof Error && CapabilityError.isAbsenceOf(error, 'mentions/resolver', descriptor.id)) {
+                    continue;
+                }
+                throw error;
+            }
+        }
+        // No resolver claimed this token
+        return { resolved: false };
+    }
+    async getNotificationsClient() {
+        if (this.notificationClient)
+            return this.notificationClient;
+        await this.ensureLoaded();
+        // Lazy load notifications client
+        try {
+            const { getVibesClient } = await import('@vibesdotdev/kernel/client');
+            this.notificationClient = await getVibesClient('notifications', this.runtime);
+            return this.notificationClient;
+        }
+        catch (error) {
+            if (error instanceof Error && CapabilityError.isAbsenceOf(error, 'runtime/client', 'notifications')) {
+                return null;
+            }
+            throw error;
+        }
+    }
+}
+// ------------------------------------------------------------------
+// Parser (pure, isomorphic, synchronous)
+// ------------------------------------------------------------------
+const MENTION_RE = /(?<!\S)@(?:(?:\("([^"]+)"\))|([a-zA-Z0-9._-]+):([a-zA-Z0-9._-]+)|([a-zA-Z0-9_-]+))/g;
+/**
+ * Parse @mentions from text.
+ *
+ * Supports:
+ *   @slug           — simple identifier (bare)
+ *   @ns:slug       — namespace-prefixed (e.g., @agent:oracle, @user:alice)
+ *   @("name with spaces") — quoted display name
+ */
+export function parseMentions(text) {
+    const tokens = [];
+    let match;
+    MENTION_RE.lastIndex = 0;
+    while ((match = MENTION_RE.exec(text)) !== null) {
+        const quoted = match[1];
+        const nsPrefix = match[2];
+        const nsSlug = match[3];
+        const bare = match[4];
+        let raw;
+        let display;
+        let slug;
+        let namespace;
+        if (quoted) {
+            // Quoted form: @("name with spaces")
+            raw = match[0];
+            display = quoted;
+            slug = displayToSlug(display);
+            namespace = undefined;
+        }
+        else if (nsPrefix && nsSlug) {
+            // Namespace prefix: @ns:slug
+            raw = match[0];
+            display = nsSlug;
+            slug = displayToSlug(nsSlug);
+            namespace = nsPrefix.toLowerCase();
+        }
+        else if (bare) {
+            // Bare form: @slug
+            raw = match[0];
+            display = bare;
+            slug = displayToSlug(bare);
+            namespace = undefined;
+        }
+        else {
+            continue;
+        }
+        // Validate and create token
+        const token = MentionTokenSchema.parse({
+            raw,
+            slug,
+            namespace,
+            display,
+            index: match.index,
+            length: raw.length
+        });
+        tokens.push(token);
+    }
+    return tokens;
+}
+/**
+ * Canonical slug derivation from display name.
+ * Used by parser, AI augment, and resolver registrations.
+ */
+export function displayToSlug(display) {
+    return display
+        .toLowerCase()
+        .replace(/[^a-z0-9._-]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+// ------------------------------------------------------------------
+// Renderer
+// ------------------------------------------------------------------
+/**
+ * Low-level render to segments.
+ * Callers can drive resolution themselves via the resolutions map.
+ */
+export function renderSegments(text, tokens, resolutions, options) {
+    if (tokens.length === 0)
+        return [text];
+    const segments = [];
+    let cursor = 0;
+    // Sort by index for sequential processing
+    const sorted = [...tokens].sort((a, b) => a.index - b.index);
+    for (const token of sorted) {
+        // Text before this mention
+        if (token.index > cursor) {
+            segments.push(text.slice(cursor, token.index));
+        }
+        // Get resolution for this token
+        const resolution = resolutions.get(token);
+        if (resolution?.resolved && resolution.href) {
+            segments.push({
+                href: resolution.href,
+                label: `@${resolution.display ?? token.display}`
+            });
+        }
+        else if (options?.fallback) {
+            segments.push(options.fallback(token));
+        }
+        else {
+            // Default fallback: raw mention text
+            segments.push(token.raw);
+        }
+        cursor = token.index + token.length;
+    }
+    // Trailing text
+    if (cursor < text.length) {
+        segments.push(text.slice(cursor));
+    }
+    return segments;
+}
+function isStringSegment(seg) {
+    return typeof seg === 'string';
+}
+/**
+ * Simple render-to-string helper.
+ */
+export function renderSegmentsToString(segments) {
+    return segments
+        .map((seg) => (isStringSegment(seg) ? seg : `[${seg.label}](${seg.href})`))
+        .join('');
+}
+//# sourceMappingURL=mentions-client.js.map

package/dist/mentions/client/mentions-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mentions-client.js","sourceRoot":"","sources":["../../../src/mentions/client/mentions-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAuC,MAAM,qBAAqB,CAAC;AAC3F,OAAO,EAAE,iBAAiB,EAAoD,MAAM,4BAA4B,CAAC;AAQjH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AA4DzD;;GAEG;AACH,MAAM,OAAO,qBAAsB,SAAQ,iBAAiB;IACnD,kBAAkB,GAAsC,IAAI,CAAC;IAErE,YACC,aAAsC,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,gBAAgB,EAAE,EAChF,OAAqB,EACrB,OAAsB;QAEtB,KAAK,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAY;QACjB,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,MAAsB,EAAE,OAAwB;QAC7D,MAAM,OAAO,GAAG,IAAI,GAAG,EAAmC,CAAC;QAE3D,2DAA2D;QAC3D,MAAM,WAAW,GAAG,IAAI,GAAG,EAAsC,CAAC;QAClE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC5B,MAAM,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC;YAC3B,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;YACvC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACjB,WAAW,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAC3B,CAAC;QAED,qBAAqB;QACrB,KAAK,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,WAAW,EAAE,CAAC;YACpD,IAAI,SAAS,EAAE,CAAC;gBACf,kDAAkD;gBAClD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,wBAAwB,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;gBACjF,IAAI,QAAQ,EAAE,CAAC;oBACd,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;wBACjC,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;wBACjD,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;oBAChC,CAAC;gBACF,CAAC;qBAAM,CAAC;oBACP,iCAAiC;oBACjC,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;wBACjC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;oBACzC,CAAC;gBACF,CAAC;YACF,CAAC;iBAAM,CAAC;gBACP,gDAAgD;gBAChD,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;oBACjC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;oBACtD,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;gBAChC,CAAC;YACF,CAAC;QACF,CAAC;QAED,OAAO,OAAO,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CACX,IAAY,EACZ,MAAsB,EACtB,WAAkD;QAElD,MAAM,WAAW,GAAG,WAAW,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QAChE,OAAO,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CACX,IAAY,EACZ,MAAsB,EACtB,UAAkB,EAClB,MAAqB;QAErB,uBAAuB;QACvB,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAE/C,qCAAqC;QACrC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkE,CAAC;QAC7F,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC5B,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAC1C,IAAI,UAAU,EAAE,QAAQ,IAAI,UAAU,CAAC,EAAE,EAAE,CAAC;gBAC3C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC;oBACpC,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;gBACtD,CAAC;YACF,CAAC;QACF,CAAC;QAED,2BAA2B;QAC3B,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAC1D,IAAI,CAAC,aAAa,EAAE,CAAC;YACpB,gDAAgD;YAChD,OAAO;QACR,CAAC;QAED,4CAA4C;QAC5C,KAAK,MAAM,EAAE,UAAU,EAAE,IAAI,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC;YAClD,sDAAsD;YACtD,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,IAAI,MAAM,CAAC;YACvC,IAAI,UAAU,CAAC,EAAE,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,OAAO,CAAC,EAAE,CAAC;gBAChF,MAAM,aAAa,CAAC,IAAI,CAAC;oBACxB,MAAM,EAAE,UAAU,CAAC,EAAE;oBACrB,OAAO,EAAE,QAAQ;oBACjB,QAAQ,EAAE,QAAQ;oBAClB,KAAK,EAAE,yBAAyB,MAAM,CAAC,IAAI,EAAE;oBAC7C,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;oBACxB,SAAS,EAAE,MAAM,CAAC,GAAG;oBACrB,WAAW,EAAE,WAAW,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,EAAE,EAAE;iBAClD,CAAC,CAAC;YACJ,CAAC;QACF,CAAC;IACF,CAAC;IAED,qEAAqE;IACrE,mBAAmB;IACnB,qEAAqE;IAE7D,KAAK,CAAC,wBAAwB,CACrC,SAAiB,EACjB,MAAgB;QAEhB,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAE1B,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,CAAC;YAChD,IAAI,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,eAAe,CAAC,oDAAoD,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,gCAAgC,EAAE,CAAC,CAAC;YAC5I,CAAC;YACD,OAAO,IAAI,CAAC;QACb,CAAC;QAED,0DAA0D;QAC1D,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO;aAC9B,KAAK,CAA6C,mBAAmB,CAAC;aACtE,WAAW,EAAE,CAAC;QAChB,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC;QAEtE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,IAAI,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,eAAe,CAAC,yCAAyC,SAAS,iBAAiB,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,2BAA2B,EAAE,CAAC,CAAC;YACtJ,CAAC;YACD,OAAO,IAAI,CAAC;QACb,CAAC;QAED,oCAAoC;QACpC,MAAM,MAAM,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC;QACnF,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QAEzB,6BAA6B;QAC7B,IAAI,CAAC;YACJ,OAAO,MAAM,IAAI,CAAC,OAAO;iBACvB,KAAK,CAA6C,mBAAmB,CAAC;iBACtE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;iBACjB,OAAO,EAAE,CAAC;QACb,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,KAAK,YAAY,KAAK,IAAI,eAAe,CAAC,WAAW,CAAC,KAAK,EAAE,mBAAmB,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;gBAClG,OAAO,IAAI,CAAC;YACb,CAAC;YACD,MAAM,KAAK,CAAC;QACb,CAAC;IACF,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAAC,KAAmB;QACjD,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAE1B,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,CAAC;YAChD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;QAC5B,CAAC;QAED,uCAAuC;QACvC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO;aAC9B,KAAK,CAA6C,mBAAmB,CAAC;aACtE,WAAW,EAAE,CAAC;QAChB,MAAM,MAAM,GAAG,CAAC,GAAG,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC;QAEtF,6BAA6B;QAC7B,KAAK,MAAM,UAAU,IAAI,MAAM,EAAE,CAAC;YACjC,IAAI,CAAC;gBACJ,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO;qBACjC,KAAK,CAA6C,mBAAmB,CAAC;qBACtE,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;qBACrB,OAAO,EAAE,CAAC;gBACZ,IAAI,QAAQ,EAAE,CAAC;oBACd,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;oBAC7C,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;wBACrB,OAAO,MAAM,CAAC;oBACf,CAAC;gBACF,CAAC;YACF,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,IAAI,KAAK,YAAY,KAAK,IAAI,eAAe,CAAC,WAAW,CAAC,KAAK,EAAE,mBAAmB,EAAE,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC;oBACtG,SAAS;gBACV,CAAC;gBACD,MAAM,KAAK,CAAC;YACb,CAAC;QACF,CAAC;QAED,iCAAiC;QACjC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC5B,CAAC;IAEO,KAAK,CAAC,sBAAsB;QACnC,IAAI,IAAI,CAAC,kBAAkB;YAAE,OAAO,IAAI,CAAC,kBAAkB,CAAC;QAE5D,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAE1B,iCAAiC;QACjC,IAAI,CAAC;YACJ,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,4BAA4B,CAAC,CAAC;YACtE,IAAI,CAAC,kBAAkB,GAAG,MAAM,cAAc,CAA6B,eAAe,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YAC1G,OAAO,IAAI,CAAC,kBAAkB,CAAC;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,KAAK,YAAY,KAAK,IAAI,eAAe,CAAC,WAAW,CAAC,KAAK,EAAE,gBAAgB,EAAE,eAAe,CAAC,EAAE,CAAC;gBACrG,OAAO,IAAI,CAAC;YACb,CAAC;YACD,MAAM,KAAK,CAAC;QACb,CAAC;IACF,CAAC;CACD;AAED,qEAAqE;AACrE,yCAAyC;AACzC,qEAAqE;AAErE,MAAM,UAAU,GAAG,qFAAqF,CAAC;AAEzG;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACzC,MAAM,MAAM,GAAmB,EAAE,CAAC;IAClC,IAAI,KAA6B,CAAC;IAElC,UAAU,CAAC,SAAS,GAAG,CAAC,CAAC;IAEzB,OAAO,CAAC,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACjD,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACxB,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1B,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACxB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAEtB,IAAI,GAAW,CAAC;QAChB,IAAI,OAAe,CAAC;QACpB,IAAI,IAAY,CAAC;QACjB,IAAI,SAA6B,CAAC;QAElC,IAAI,MAAM,EAAE,CAAC;YACZ,qCAAqC;YACrC,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACf,OAAO,GAAG,MAAM,CAAC;YACjB,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;YAC9B,SAAS,GAAG,SAAS,CAAC;QACvB,CAAC;aAAM,IAAI,QAAQ,IAAI,MAAM,EAAE,CAAC;YAC/B,6BAA6B;YAC7B,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACf,OAAO,GAAG,MAAM,CAAC;YACjB,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;YAC7B,SAAS,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;QACpC,CAAC;aAAM,IAAI,IAAI,EAAE,CAAC;YACjB,mBAAmB;YACnB,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACf,OAAO,GAAG,IAAI,CAAC;YACf,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;YAC3B,SAAS,GAAG,SAAS,CAAC;QACvB,CAAC;aAAM,CAAC;YACP,SAAS;QACV,CAAC;QAED,4BAA4B;QAC5B,MAAM,KAAK,GAAG,kBAAkB,CAAC,KAAK,CAAC;YACtC,GAAG;YACH,IAAI;YACJ,SAAS;YACT,OAAO;YACP,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,MAAM,EAAE,GAAG,CAAC,MAAM;SAClB,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IAED,OAAO,MAAM,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe;IAC5C,OAAO,OAAO;SACZ,WAAW,EAAE;SACb,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC;SAC9B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AAC3B,CAAC;AAED,qEAAqE;AACrE,WAAW;AACX,qEAAqE;AAErE;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC7B,IAAY,EACZ,MAAsB,EACtB,WAAiD,EACjD,OAAwD;IAExD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvC,MAAM,QAAQ,GAAoB,EAAE,CAAC;IACrC,IAAI,MAAM,GAAG,CAAC,CAAC;IAEf,0CAA0C;IAC1C,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAE7D,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC5B,2BAA2B;QAC3B,IAAI,KAAK,CAAC,KAAK,GAAG,MAAM,EAAE,CAAC;YAC1B,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QAChD,CAAC;QAED,gCAAgC;QAChC,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAE1C,IAAI,UAAU,EAAE,QAAQ,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC;YAC7C,QAAQ,CAAC,IAAI,CAAC;gBACb,IAAI,EAAE,UAAU,CAAC,IAAI;gBACrB,KAAK,EAAE,IAAI,UAAU,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,EAAE;aAChD,CAAC,CAAC;QACJ,CAAC;aAAM,IAAI,OAAO,EAAE,QAAQ,EAAE,CAAC;YAC9B,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QACxC,CAAC;aAAM,CAAC;YACP,qCAAqC;YACrC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;QAED,MAAM,GAAG,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC;IACrC,CAAC;IAED,gBAAgB;IAChB,IAAI,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC1B,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED,SAAS,eAAe,CAAC,GAAkB;IAC1C,OAAO,OAAO,GAAG,KAAK,QAAQ,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAyB;IAC/D,OAAO,QAAQ;SACb,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,KAAK,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC;SAC1E,IAAI,CAAC,EAAE,CAAC,CAAC;AACZ,CAAC"}

package/dist/mentions/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Mention Parser
+ *
+ * Parses @mentions in text and renders them as resolved links.
+ * All types derive from Zod schemas in ./schemas.
+ */
+export { MentionTokenSchema, MentionResolutionSchema, MentionResolverDescriptorSchema, RenderSegmentSchema, MentionRenderOptionsSchema, MentionSourceSchema, NotifyMentionsOptionsSchema } from './schemas/index.ts';
+export type { MentionToken, MentionResolution, MentionResolverDescriptor, RenderSegment, MentionRenderOptions, MentionSource, NotifyMentionsOptions } from './schemas/index.ts';
+export { getVibesMentionsClient } from './client/helper.ts';
+export { RuntimeMentionsClient } from './client/mentions-client.ts';
+export type { MentionsClient, ResolveOptions } from './client/mentions-client.ts';
+export { displayToSlug, parseMentions as parseMentionsTokens } from './client/mentions-client.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/mentions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mentions/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EACN,kBAAkB,EAClB,uBAAuB,EACvB,+BAA+B,EAC/B,mBAAmB,EACnB,0BAA0B,EAC1B,mBAAmB,EACnB,2BAA2B,EAC3B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACX,YAAY,EACZ,iBAAiB,EACjB,yBAAyB,EACzB,aAAa,EACb,oBAAoB,EACpB,aAAa,EACb,qBAAqB,EACrB,MAAM,oBAAoB,CAAC;AAa5B,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAMlF,OAAO,EAAE,aAAa,EAAE,aAAa,IAAI,mBAAmB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/mentions/index.js

@@ -0,0 +1,26 @@
+/**
+ * Mention Parser
+ *
+ * Parses @mentions in text and renders them as resolved links.
+ * All types derive from Zod schemas in ./schemas.
+ */
+// ------------------------------------------------------------------
+// Schemas (Zod-based) — canonical types
+// ------------------------------------------------------------------
+export { MentionTokenSchema, MentionResolutionSchema, MentionResolverDescriptorSchema, RenderSegmentSchema, MentionRenderOptionsSchema, MentionSourceSchema, NotifyMentionsOptionsSchema } from "./schemas/index.js";
+// ------------------------------------------------------------------
+// Parser (updated for namespace prefixes)
+//
+// The canonical parser lives in ./client/mentions-client.ts as
+// parseMentionsTokens() returning MentionToken[].
+// ------------------------------------------------------------------
+// ------------------------------------------------------------------
+// Runtime Client (canonical API)
+// ------------------------------------------------------------------
+export { getVibesMentionsClient } from "./client/helper.js";
+export { RuntimeMentionsClient } from "./client/mentions-client.js";
+// ------------------------------------------------------------------
+// Low-level utilities (synchronous, isomorphic)
+// ------------------------------------------------------------------
+export { displayToSlug, parseMentions as parseMentionsTokens } from "./client/mentions-client.js";
+//# sourceMappingURL=index.js.map

package/dist/mentions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mentions/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qEAAqE;AACrE,wCAAwC;AACxC,qEAAqE;AAErE,OAAO,EACN,kBAAkB,EAClB,uBAAuB,EACvB,+BAA+B,EAC/B,mBAAmB,EACnB,0BAA0B,EAC1B,mBAAmB,EACnB,2BAA2B,EAC3B,MAAM,oBAAoB,CAAC;AAW5B,qEAAqE;AACrE,0CAA0C;AAC1C,EAAE;AACF,+DAA+D;AAC/D,kDAAkD;AAClD,qEAAqE;AAErE,qEAAqE;AACrE,iCAAiC;AACjC,qEAAqE;AAErE,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAGpE,qEAAqE;AACrE,gDAAgD;AAChD,qEAAqE;AAErE,OAAO,EAAE,aAAa,EAAE,aAAa,IAAI,mBAAmB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/mentions/kinds/mentions-resolver.kind.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Mentions Resolver Kind
+ *
+ * Runtime kind for namespace-specific mention resolvers.
+ * Each namespace owner (account, ai, brain) registers a resolver
+ * that claims tokens by namespace and returns resolved entity references.
+ */
+import * as z from 'zod/v4';
+import type { RuntimeKindDescriptor } from '@vibesdotdev/kernel/schemas/kind';
+import type { MentionToken, MentionResolution, MentionResolverDescriptor } from '../schemas/index.ts';
+export interface MentionResolver {
+    /**
+     * Resolve a mention token to an entity reference.
+     *
+     * @param token - The parsed mention token
+     * @returns Resolution result (resolved: true with id/type/href, or resolved: false)
+     */
+    resolve(token: MentionToken): Promise<MentionResolution> | MentionResolution;
+}
+export declare const KindMentionResolverDescriptorSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    hardware: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    capabilityId: z.ZodOptional<z.ZodString>;
+    requiredContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    optionalContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    config: z.ZodOptional<z.ZodUnknown>;
+    retention: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        maxAgeDays: z.ZodOptional<z.ZodNumber>;
+        maxEntries: z.ZodOptional<z.ZodNumber>;
+        maxBytes: z.ZodOptional<z.ZodNumber>;
+        cascadeFrom: z.ZodOptional<z.ZodString>;
+        ageField: z.ZodOptional<z.ZodString>;
+        reason: z.ZodString;
+        enforcedBy: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>;
+    kind: z.ZodLiteral<"mentions/resolver">;
+    namespace: z.ZodString;
+    priority: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const mentionsResolverKind: RuntimeKindDescriptor<MentionResolverDescriptor, MentionResolver>;
+export default mentionsResolverKind;
+//# sourceMappingURL=mentions-resolver.kind.d.ts.map

package/dist/mentions/kinds/mentions-resolver.kind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mentions-resolver.kind.d.ts","sourceRoot":"","sources":["../../../src/mentions/kinds/mentions-resolver.kind.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,KAAK,EAAE,qBAAqB,EAAqB,MAAM,kCAAkC,CAAC;AACjG,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAMtG,MAAM,WAAW,eAAe;IAC/B;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,iBAAiB,CAAC,GAAG,iBAAiB,CAAC;CAC7E;AAMD,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;iBAI9C,CAAC;AAUH,eAAO,MAAM,oBAAoB,EAAE,qBAAqB,CAAC,yBAAyB,EAAE,eAAe,CAiClG,CAAC;AAEF,eAAe,oBAAoB,CAAC"}

package/dist/mentions/kinds/mentions-resolver.kind.js

@@ -0,0 +1,55 @@
+/**
+ * Mentions Resolver Kind
+ *
+ * Runtime kind for namespace-specific mention resolvers.
+ * Each namespace owner (account, ai, brain) registers a resolver
+ * that claims tokens by namespace and returns resolved entity references.
+ */
+import * as z from 'zod/v4';
+import { RuntimeDescriptorSchema } from '@vibesdotdev/kernel/schemas/descriptor';
+// ------------------------------------------------------------------
+// Resolver Descriptor Schema (kind-level, extends RuntimeDescriptorSchema)
+// ------------------------------------------------------------------
+export const KindMentionResolverDescriptorSchema = RuntimeDescriptorSchema.extend({
+    kind: z.literal('mentions/resolver'),
+    namespace: z.string().min(1),
+    priority: z.number().default(0)
+});
+const MentionResolverContractSchema = z.object({
+    resolve: z.function()
+});
+// ------------------------------------------------------------------
+// Kind Descriptor
+// ------------------------------------------------------------------
+export const mentionsResolverKind = {
+    id: 'mentions/resolver',
+    descriptorSchema: KindMentionResolverDescriptorSchema,
+    /**
+     * Default implementation returns unresolved for any token.
+     */
+    defaultImplementation: class DefaultResolver {
+        resolve(_token) {
+            return {
+                resolved: false
+            };
+        }
+    },
+    /**
+     * Validate that an implementation has a resolve method.
+     */
+    validateImplementation: (impl) => MentionResolverContractSchema.safeParse(impl).success,
+    /**
+     * Resolution: by namespace claim order (priority, then registration order).
+     */
+    resolve: (candidates, _scope, _context) => {
+        const parsed = candidates.flatMap((candidate) => {
+            const result = KindMentionResolverDescriptorSchema.safeParse(candidate);
+            return result.success ? [result.data] : [];
+        });
+        // Sort by priority descending, then take first
+        const sorted = parsed.sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0));
+        return sorted[0];
+    }
+};
+export default mentionsResolverKind;
+//# sourceMappingURL=mentions-resolver.kind.js.map

package/dist/mentions/kinds/mentions-resolver.kind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mentions-resolver.kind.js","sourceRoot":"","sources":["../../../src/mentions/kinds/mentions-resolver.kind.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AAkBjF,qEAAqE;AACrE,2EAA2E;AAC3E,qEAAqE;AAErE,MAAM,CAAC,MAAM,mCAAmC,GAAG,uBAAuB,CAAC,MAAM,CAAC;IACjF,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC;IACpC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;CAC/B,CAAC,CAAC;AAEH,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CACrB,CAAC,CAAC;AAEH,qEAAqE;AACrE,kBAAkB;AAClB,qEAAqE;AAErE,MAAM,CAAC,MAAM,oBAAoB,GAAsE;IACtG,EAAE,EAAE,mBAAmB;IACvB,gBAAgB,EAAE,mCAAmC;IAErD;;OAEG;IACH,qBAAqB,EAAE,MAAM,eAAe;QAC3C,OAAO,CAAC,MAAoB;YAC3B,OAAO;gBACN,QAAQ,EAAE,KAAK;aACf,CAAC;QACH,CAAC;KACD;IAED;;OAEG;IACH,sBAAsB,EAAE,CAAC,IAAqB,EAAW,EAAE,CAC1D,6BAA6B,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,OAAO;IAEtD;;OAEG;IACH,OAAO,EAAE,CAAC,UAA+B,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE;QAC9D,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE;YAC/C,MAAM,MAAM,GAAG,mCAAmC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YACxE,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5C,CAAC,CAAC,CAAC;QACH,+CAA+C;QAC/C,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC;QAC5E,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;CACD,CAAC;AAEF,eAAe,oBAAoB,CAAC"}

package/dist/mentions/mentions.plugin.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Mentions Runtime Plugin
+ *
+ * Registers the `mentions/resolver` kind and the `runtime/client` descriptor
+ * for the mentions module.
+ */
+declare const mentionsPlugin: import("@vibesdotdev/kernel").RuntimePlugin;
+export default mentionsPlugin;
+//# sourceMappingURL=mentions.plugin.d.ts.map

package/dist/mentions/mentions.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mentions.plugin.d.ts","sourceRoot":"","sources":["../../src/mentions/mentions.plugin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,QAAA,MAAM,cAAc,6CAwBlB,CAAC;AAEH,eAAe,cAAc,CAAC"}