@assistant-ui/core 0.1.7 → 0.1.9

package/dist/store/runtime-clients/composer-runtime-client.js

@@ -15,11 +15,7 @@ export const ComposerClient = resource(({ threadIdRef, messageIdRef, runtime, })
     tapEffect(() => {
         const unsubscribers = [];
         // Subscribe to composer events
-        const composerEvents = [
-            "send",
-            "attachmentAdd",
-        ];
-        for (const event of composerEvents) {
+        for (const event of ["send", "attachmentAdd"]) {
             const unsubscribe = runtime.unstable_on(event, () => {
                 emit(`composer.${event}`, {
                     threadId: threadIdRef.current,
@@ -28,6 +24,17 @@ export const ComposerClient = resource(({ threadIdRef, messageIdRef, runtime, })
             });
             unsubscribers.push(unsubscribe);
         }
+        // attachmentAddError carries the failed attachment ID
+        unsubscribers.push(runtime.unstable_on("attachmentAddError", () => {
+            const errorAttachment = runtime
+                .getState()
+                .attachments.findLast((a) => a.status.type === "incomplete" && a.status.reason === "error");
+            emit("composer.attachmentAddError", {
+                threadId: threadIdRef.current,
+                ...(messageIdRef && { messageId: messageIdRef.current }),
+                ...(errorAttachment && { attachmentId: errorAttachment.id }),
+            });
+        }));
         return () => {
             for (const unsub of unsubscribers)
                 unsub();
@@ -50,6 +57,7 @@ export const ComposerClient = resource(({ threadIdRef, messageIdRef, runtime, })
             type: runtimeState.type ?? "thread",
             dictation: runtimeState.dictation,
             quote: runtimeState.quote,
+            queue: [],
         };
     }, [runtimeState, attachments.state]);
     return {
@@ -77,6 +85,9 @@ export const ComposerClient = resource(({ threadIdRef, messageIdRef, runtime, })
                 return attachments.get(selector);
             }
         },
+        queueItem: () => {
+            throw new Error("Queue is not supported in this runtime");
+        },
         __internal_getRuntime: () => runtime,
     };
 });

package/dist/store/runtime-clients/composer-runtime-client.js.map

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

package/dist/store/scope-registration.d.ts

@@ -9,6 +9,7 @@ import type { ModelContextClientSchema } from "./scopes/model-context.js";
 import type { SuggestionsClientSchema } from "./scopes/suggestions.js";
 import type { SuggestionClientSchema } from "./scopes/suggestion.js";
 import type { ChainOfThoughtClientSchema } from "./scopes/chain-of-thought.js";
+import type { QueueItemClientSchema } from "./scopes/queue-item.js";
 declare module "@assistant-ui/store" {
     interface ScopeRegistry {
         threads: ThreadsClientSchema;
@@ -22,6 +23,7 @@ declare module "@assistant-ui/store" {
         suggestions: SuggestionsClientSchema;
         suggestion: SuggestionClientSchema;
         chainOfThought: ChainOfThoughtClientSchema;
+        queueItem: QueueItemClientSchema;
     }
 }
 //# sourceMappingURL=scope-registration.d.ts.map

package/dist/store/scope-registration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scope-registration.d.ts","sourceRoot":"","sources":["../../src/store/scope-registration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,4BAAyB;AAC5D,OAAO,KAAK,EAAE,0BAA0B,EAAE,qCAAkC;AAC5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,2BAAwB;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,4BAAyB;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,yBAAsB;AACtD,OAAO,KAAK,EAAE,oBAAoB,EAAE,6BAA0B;AAC9D,OAAO,KAAK,EAAE,sBAAsB,EAAE,+BAA4B;AAClE,OAAO,KAAK,EAAE,wBAAwB,EAAE,kCAA+B;AACvE,OAAO,KAAK,EAAE,uBAAuB,EAAE,gCAA6B;AACpE,OAAO,KAAK,EAAE,sBAAsB,EAAE,+BAA4B;AAClE,OAAO,KAAK,EAAE,0BAA0B,EAAE,qCAAkC;AAE5E,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,aAAa;QACrB,OAAO,EAAE,mBAAmB,CAAC;QAC7B,cAAc,EAAE,0BAA0B,CAAC;QAC3C,MAAM,EAAE,kBAAkB,CAAC;QAC3B,OAAO,EAAE,mBAAmB,CAAC;QAC7B,IAAI,EAAE,gBAAgB,CAAC;QACvB,QAAQ,EAAE,oBAAoB,CAAC;QAC/B,UAAU,EAAE,sBAAsB,CAAC;QACnC,YAAY,EAAE,wBAAwB,CAAC;QACvC,WAAW,EAAE,uBAAuB,CAAC;QACrC,UAAU,EAAE,sBAAsB,CAAC;QACnC,cAAc,EAAE,0BAA0B,CAAC;KAC5C;CACF"}
+{"version":3,"file":"scope-registration.d.ts","sourceRoot":"","sources":["../../src/store/scope-registration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,4BAAyB;AAC5D,OAAO,KAAK,EAAE,0BAA0B,EAAE,qCAAkC;AAC5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,2BAAwB;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,4BAAyB;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,yBAAsB;AACtD,OAAO,KAAK,EAAE,oBAAoB,EAAE,6BAA0B;AAC9D,OAAO,KAAK,EAAE,sBAAsB,EAAE,+BAA4B;AAClE,OAAO,KAAK,EAAE,wBAAwB,EAAE,kCAA+B;AACvE,OAAO,KAAK,EAAE,uBAAuB,EAAE,gCAA6B;AACpE,OAAO,KAAK,EAAE,sBAAsB,EAAE,+BAA4B;AAClE,OAAO,KAAK,EAAE,0BAA0B,EAAE,qCAAkC;AAC5E,OAAO,KAAK,EAAE,qBAAqB,EAAE,+BAA4B;AAEjE,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,aAAa;QACrB,OAAO,EAAE,mBAAmB,CAAC;QAC7B,cAAc,EAAE,0BAA0B,CAAC;QAC3C,MAAM,EAAE,kBAAkB,CAAC;QAC3B,OAAO,EAAE,mBAAmB,CAAC;QAC7B,IAAI,EAAE,gBAAgB,CAAC;QACvB,QAAQ,EAAE,oBAAoB,CAAC;QAC/B,UAAU,EAAE,sBAAsB,CAAC;QACnC,YAAY,EAAE,wBAAwB,CAAC;QACvC,WAAW,EAAE,uBAAuB,CAAC;QACrC,UAAU,EAAE,sBAAsB,CAAC;QACnC,cAAc,EAAE,0BAA0B,CAAC;QAC3C,SAAS,EAAE,qBAAqB,CAAC;KAClC;CACF"}

package/dist/store/scopes/composer.d.ts

@@ -5,6 +5,14 @@ import type { RunConfig } from "../../types/message.js";
 import type { ComposerRuntime } from "../../runtime/api/composer-runtime.js";
 import type { DictationState } from "../../runtime/interfaces/composer-runtime-core.js";
 import type { AttachmentMethods } from "./attachment.js";
+import type { QueueItemState, QueueItemMethods } from "./queue-item.js";
+export type ComposerSendOptions = {
+    /**
+     * Whether to steer (interrupt the current run and process this message immediately).
+     * When false (default), the message is queued and processed in order.
+     */
+    steer?: boolean;
+};
 export type ComposerState = {
     readonly text: string;
     readonly role: MessageRole;
@@ -25,6 +33,11 @@ export type ComposerState = {
      * Undefined when no quote is set.
      */
     readonly quote: QuoteInfo | undefined;
+    /**
+     * The queue of messages waiting to be processed.
+     * Empty when no messages are queued.
+     */
+    readonly queue: readonly QueueItemState[];
 };
 export type ComposerMethods = {
     getState(): ComposerState;
@@ -39,7 +52,7 @@ export type ComposerMethods = {
         id: string;
     }): AttachmentMethods;
     reset(): Promise<void>;
-    send(): void;
+    send(opts?: ComposerSendOptions): void;
     cancel(): void;
     beginEdit(): void;
     /**
@@ -55,6 +68,12 @@ export type ComposerMethods = {
      * Set a quote for the next message. Pass undefined to clear.
      */
     setQuote(quote: QuoteInfo | undefined): void;
+    /**
+     * Access a queue item by index.
+     */
+    queueItem(selector: {
+        index: number;
+    }): QueueItemMethods;
     __internal_getRuntime?(): ComposerRuntime;
 };
 export type ComposerMeta = {
@@ -70,6 +89,11 @@ export type ComposerEvents = {
         threadId: string;
         messageId?: string;
     };
+    "composer.attachmentAddError": {
+        threadId: string;
+        messageId?: string;
+        attachmentId?: string;
+    };
 };
 export type ComposerClientSchema = {
     methods: ComposerMethods;

package/dist/store/scopes/composer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"composer.d.ts","sourceRoot":"","sources":["../../../src/store/scopes/composer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,kCAA+B;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,+BAA4B;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,6BAA0B;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,+BAA4B;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,8CAA2C;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,0DAAuD;AACrF,OAAO,KAAK,EAAE,iBAAiB,EAAE,wBAAqB;AAEtD,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;IAC5C,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IAEjC;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,cAAc,GAAG,SAAS,CAAC;IAE/C;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,IAAI,aAAa,CAAC;IAC1B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC;IACzC,aAAa,CAAC,gBAAgB,EAAE,IAAI,GAAG,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,UAAU,CAAC,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,iBAAiB,CAAC;IAC5E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,IAAI,CAAC;IACb,MAAM,IAAI,IAAI,CAAC;IACf,SAAS,IAAI,IAAI,CAAC;IAElB;;;OAGG;IACH,cAAc,IAAI,IAAI,CAAC;IAEvB;;OAEG;IACH,aAAa,IAAI,IAAI,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,IAAI,CAAC;IAE7C,qBAAqB,CAAC,IAAI,eAAe,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,eAAe,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1D,wBAAwB,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACpE,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,eAAe,CAAC;IACzB,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,cAAc,CAAC;CACxB,CAAC"}
+{"version":3,"file":"composer.d.ts","sourceRoot":"","sources":["../../../src/store/scopes/composer.ts"],"names":[],"mappings":"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"}

package/dist/store/scopes/queue-item.d.ts

@@ -0,0 +1,20 @@
+export type QueueItemState = {
+    readonly id: string;
+    readonly prompt: string;
+};
+export type QueueItemMethods = {
+    getState(): QueueItemState;
+    steer(): void;
+    remove(): void;
+};
+export type QueueItemMeta = {
+    source: "composer";
+    query: {
+        index: number;
+    };
+};
+export type QueueItemClientSchema = {
+    methods: QueueItemMethods;
+    meta: QueueItemMeta;
+};
+//# sourceMappingURL=queue-item.d.ts.map

package/dist/store/scopes/queue-item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-item.d.ts","sourceRoot":"","sources":["../../../src/store/scopes/queue-item.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,IAAI,cAAc,CAAC;IAC3B,KAAK,IAAI,IAAI,CAAC;IACd,MAAM,IAAI,IAAI,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,IAAI,EAAE,aAAa,CAAC;CACrB,CAAC"}

package/dist/store/scopes/queue-item.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=queue-item.js.map

package/dist/store/scopes/queue-item.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,6 @@
+export type { TextMessagePart, ReasoningMessagePart, SourceMessagePart, ImageMessagePart, FileMessagePart, DataMessagePart, Unstable_AudioMessagePart, ToolCallMessagePart, ThreadUserMessagePart, ThreadAssistantMessagePart, MessagePartStatus, ToolCallMessagePartStatus, MessageStatus, MessageTiming, ThreadStep, ThreadSystemMessage, ThreadUserMessage, ThreadAssistantMessage, ThreadMessage, MessageRole, RunConfig, AppendMessage, } from "./message.js";
+export type { Attachment, PendingAttachment, CompleteAttachment, AttachmentStatus, CreateAttachment, } from "./attachment.js";
+export type { Unsubscribe } from "./unsubscribe.js";
+export type { QuoteInfo } from "./quote.js";
+export type { Unstable_MentionItem, Unstable_MentionCategory, Unstable_DirectiveSegment, Unstable_DirectiveFormatter, } from "./mention.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAEV,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,yBAAyB,EACzB,mBAAmB,EACnB,qBAAqB,EACrB,0BAA0B,EAE1B,iBAAiB,EACjB,yBAAyB,EACzB,aAAa,EAEb,aAAa,EACb,UAAU,EACV,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,aAAa,EACb,WAAW,EAEX,SAAS,EACT,aAAa,GACd,qBAAkB;AAEnB,YAAY,EACV,UAAU,EACV,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,GACjB,wBAAqB;AAEtB,YAAY,EAAE,WAAW,EAAE,yBAAsB;AAEjD,YAAY,EAAE,SAAS,EAAE,mBAAgB;AAEzC,YAAY,EACV,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,EACzB,2BAA2B,GAC5B,qBAAkB"}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

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

package/dist/types/mention.d.ts

@@ -0,0 +1,32 @@
+import type { ReadonlyJSONObject } from "assistant-stream/utils";
+export type Unstable_MentionItem = {
+    readonly id: string;
+    readonly type: string;
+    readonly label: string;
+    readonly icon?: string | undefined;
+    readonly description?: string | undefined;
+    readonly metadata?: ReadonlyJSONObject | undefined;
+};
+export type Unstable_MentionCategory = {
+    readonly id: string;
+    readonly label: string;
+    readonly icon?: string | undefined;
+};
+/** Parsed segment from directive text */
+export type Unstable_DirectiveSegment = {
+    readonly kind: "text";
+    readonly text: string;
+} | {
+    readonly kind: "mention";
+    readonly type: string;
+    readonly label: string;
+    readonly id: string;
+};
+/** Configurable formatter for mention directive serialization/parsing */
+export type Unstable_DirectiveFormatter = {
+    /** Serialize a mention item to directive text */
+    serialize(item: Unstable_MentionItem): string;
+    /** Parse text into alternating text and mention segments */
+    parse(text: string): readonly Unstable_DirectiveSegment[];
+};
+//# sourceMappingURL=mention.d.ts.map

package/dist/types/mention.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mention.d.ts","sourceRoot":"","sources":["../../src/types/mention.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAMjE,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;CACpD,CAAC;AAMF,MAAM,MAAM,wBAAwB,GAAG;IACrC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC,CAAC;AAMF,yCAAyC;AACzC,MAAM,MAAM,yBAAyB,GACjC;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAChD;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB,CAAC;AAMN,yEAAyE;AACzE,MAAM,MAAM,2BAA2B,GAAG;IACxC,iDAAiD;IACjD,SAAS,CAAC,IAAI,EAAE,oBAAoB,GAAG,MAAM,CAAC;IAC9C,4DAA4D;IAC5D,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,yBAAyB,EAAE,CAAC;CAC3D,CAAC"}

package/dist/types/mention.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mention.js.map

package/dist/types/mention.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@assistant-ui/core",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Framework-agnostic core runtime for assistant-ui",
   "keywords": [
     "assistant",
@@ -53,15 +53,15 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "assistant-stream": "^0.3.6",
-    "nanoid": "^5.1.6"
+    "assistant-stream": "^0.3.8",
+    "nanoid": "^5.1.7"
   },
   "peerDependencies": {
-    "@assistant-ui/store": "^0.2.3",
-    "@assistant-ui/tap": "^0.5.3",
+    "@assistant-ui/store": "^0.2.5",
+    "@assistant-ui/tap": "^0.5.5",
     "@types/react": "*",
     "react": "^18 || ^19",
-    "assistant-cloud": "^0.1.22",
+    "assistant-cloud": "^0.1.23",
     "zustand": "^5.0.11"
   },
   "peerDependenciesMeta": {
@@ -81,12 +81,12 @@
   "devDependencies": {
     "@types/react": "^19.2.14",
     "react": "^19.2.4",
-    "vitest": "^4.1.0",
-    "zustand": "^5.0.11",
-    "@assistant-ui/store": "0.2.3",
-    "@assistant-ui/tap": "0.5.3",
+    "vitest": "^4.1.1",
+    "zustand": "^5.0.12",
+    "@assistant-ui/store": "0.2.5",
+    "@assistant-ui/tap": "0.5.5",
     "@assistant-ui/x-buildutils": "0.0.3",
-    "assistant-cloud": "0.1.22"
+    "assistant-cloud": "0.1.23"
   },
   "publishConfig": {
     "access": "public",

package/src/adapters/attachment.ts

@@ -114,7 +114,7 @@ const getFileText = (file: File) =>
 // Composite Attachment Adapter
 // =============================================================================
 
-function fileMatchesAccept(
+export function fileMatchesAccept(
   file: { name: string; type: string },
   acceptString: string,
 ) {

package/src/adapters/index.ts

@@ -0,0 +1,34 @@
+// Attachment adapters
+export type { AttachmentAdapter } from "./attachment";
+export {
+  SimpleImageAttachmentAdapter,
+  SimpleTextAttachmentAdapter,
+  CompositeAttachmentAdapter,
+} from "./attachment";
+
+// Speech adapters
+export type { SpeechSynthesisAdapter, DictationAdapter } from "./speech";
+export {
+  WebSpeechSynthesisAdapter,
+  WebSpeechDictationAdapter,
+} from "./speech";
+
+// Feedback adapter
+export type { FeedbackAdapter } from "./feedback";
+
+// Suggestion adapter
+export type { SuggestionAdapter } from "./suggestion";
+
+// Mention adapter
+export type { Unstable_MentionAdapter } from "./mention";
+export { unstable_defaultDirectiveFormatter } from "./mention";
+
+// Thread history adapters
+export type {
+  ThreadHistoryAdapter,
+  GenericThreadHistoryAdapter,
+  MessageFormatAdapter,
+  MessageFormatItem,
+  MessageFormatRepository,
+  MessageStorageEntry,
+} from "./thread-history";

package/src/adapters/mention.ts

@@ -0,0 +1,77 @@
+import type {
+  Unstable_MentionCategory,
+  Unstable_MentionItem,
+  Unstable_DirectiveSegment,
+  Unstable_DirectiveFormatter,
+} from "../types/mention";
+
+// =============================================================================
+// Mention Adapter
+// =============================================================================
+
+/**
+ * Adapter for providing mention categories and items to the mention picker.
+ *
+ * All methods are synchronous by design — the adapter drives UI display and
+ * must return data immediately. Use external state management (e.g. React
+ * Query, SWR, or local state) to handle async data fetching, then expose
+ * the loaded results synchronously through this adapter.
+ */
+export type Unstable_MentionAdapter = {
+  /** Return the top-level categories for the mention picker. */
+  categories(): readonly Unstable_MentionCategory[];
+
+  /** Return items within a category. */
+  categoryItems(categoryId: string): readonly Unstable_MentionItem[];
+
+  /** Global search across all categories (optional). */
+  search?(query: string): readonly Unstable_MentionItem[];
+};
+
+// =============================================================================
+// Default Directive Formatter
+// =============================================================================
+
+const DIRECTIVE_RE = /:([\w-]+)\[([^\]]+)\](?:\{name=([^}]+)\})?/g;
+
+/**
+ * Default directive formatter using the `:type[label]{name=id}` syntax.
+ *
+ * When `id` equals `label`, the `{name=…}` attribute is omitted for brevity.
+ */
+export const unstable_defaultDirectiveFormatter: Unstable_DirectiveFormatter = {
+  serialize(item: Unstable_MentionItem): string {
+    const attrs = item.id !== item.label ? `{name=${item.id}}` : "";
+    return `:${item.type}[${item.label}]${attrs}`;
+  },
+
+  parse(text: string): Unstable_DirectiveSegment[] {
+    const segments: Unstable_DirectiveSegment[] = [];
+    let lastIndex = 0;
+
+    DIRECTIVE_RE.lastIndex = 0;
+    let match: RegExpExecArray | null;
+    while ((match = DIRECTIVE_RE.exec(text)) !== null) {
+      if (match.index > lastIndex) {
+        segments.push({
+          kind: "text",
+          text: text.slice(lastIndex, match.index),
+        });
+      }
+      const label = match[2]!;
+      segments.push({
+        kind: "mention",
+        type: match[1]!,
+        label,
+        id: match[3] ?? label,
+      });
+      lastIndex = DIRECTIVE_RE.lastIndex;
+    }
+
+    if (lastIndex < text.length) {
+      segments.push({ kind: "text", text: text.slice(lastIndex) });
+    }
+
+    return segments;
+  },
+};

package/src/index.ts

@@ -43,6 +43,13 @@ export type { Unsubscribe } from "./types/unsubscribe";
 
 export type { QuoteInfo } from "./types/quote";
 
+export type {
+  Unstable_MentionItem,
+  Unstable_MentionCategory,
+  Unstable_DirectiveSegment,
+  Unstable_DirectiveFormatter,
+} from "./types/mention";
+
 // === model-context ===
 
 export type {
@@ -103,6 +110,10 @@ export type { FeedbackAdapter } from "./adapters/feedback";
 // Suggestion adapter
 export type { SuggestionAdapter } from "./adapters/suggestion";
 
+// Mention adapter
+export type { Unstable_MentionAdapter } from "./adapters/mention";
+export { unstable_defaultDirectiveFormatter } from "./adapters/mention";
+
 // Thread history adapters
 export type {
   ThreadHistoryAdapter,

package/src/react/RuntimeAdapter.ts

@@ -13,15 +13,13 @@ export const RuntimeAdapter = resource((runtime: AssistantRuntime) =>
 );
 
 attachTransformScopes(RuntimeAdapter, (scopes, parent) => {
-  const result = baseRuntimeAdapterTransformScopes(scopes, parent);
+  baseRuntimeAdapterTransformScopes(scopes, parent);
 
-  if (!result.tools && parent.tools.source === null) {
-    result.tools = Tools({});
+  if (!scopes.tools && parent.tools.source === null) {
+    scopes.tools = Tools({});
   }
 
-  if (!result.dataRenderers && parent.dataRenderers.source === null) {
-    result.dataRenderers = DataRenderers();
+  if (!scopes.dataRenderers && parent.dataRenderers.source === null) {
+    scopes.dataRenderers = DataRenderers();
   }
-
-  return result;
 });