@assistant-ui/core 0.1.11 → 0.1.13

package/src/runtime/api/composer-runtime.ts

@@ -12,9 +12,10 @@ import {
   SKIP_UPDATE,
 } from "../../subscribable/subscribable";
 import type {
-  ComposerRuntimeCore,
   ComposerRuntimeEventType,
   DictationState,
+  EditComposerRuntimeCore,
+  SendOptions,
   ThreadComposerRuntimeCore,
 } from "../interfaces/composer-runtime-core";
 import type {
@@ -68,6 +69,8 @@ export type ThreadComposerState = BaseComposerState & {
 
 export type EditComposerState = BaseComposerState & {
   readonly type: "edit";
+  readonly parentId: string | null;
+  readonly sourceId: string | null;
 };
 
 export type ComposerState = ThreadComposerState | EditComposerState;
@@ -97,7 +100,7 @@ const getThreadComposerState = (
 };
 
 const getEditComposerState = (
-  runtime: ComposerRuntimeCore | undefined,
+  runtime: EditComposerRuntimeCore | undefined,
 ): EditComposerState => {
   return Object.freeze({
     type: "edit",
@@ -114,6 +117,9 @@ const getEditComposerState = (
     dictation: runtime?.dictation,
     quote: runtime?.quote,
 
+    parentId: runtime?.parentId ?? null,
+    sourceId: runtime?.sourceId ?? null,
+
     value: runtime?.text ?? "",
   });
 };
@@ -173,8 +179,9 @@ export type ComposerRuntime = {
 
   /**
    * Send a message. This will send whatever text or attachments are in the composer.
+   * @param options Optional send options. Use `{ startRun: true }` to force starting a new run.
    */
-  send(): void;
+  send(options?: SendOptions): void;
 
   /**
    * Cancel the current run. In edit mode, this will exit edit mode.
@@ -278,10 +285,10 @@ export abstract class ComposerRuntimeImpl implements ComposerRuntime {
     return core.clearAttachments();
   }
 
-  public send() {
+  public send(options?: SendOptions) {
     const core = this._core.getState();
     if (!core) throw new Error("Composer is not available");
-    core.send();
+    core.send(options);
   }
 
   public cancel() {

package/src/runtime/base/base-composer-runtime-core.ts

@@ -17,6 +17,7 @@ import type {
   ComposerRuntimeCore,
   ComposerRuntimeEventType,
   DictationState,
+  SendOptions,
 } from "../interfaces/composer-runtime-core";
 import type { DictationAdapter } from "../../adapters/speech";
 import { generateId } from "../../utils/id";
@@ -152,7 +153,7 @@ export abstract class BaseComposerRuntimeCore
     await task;
   }
 
-  public async send() {
+  public async send(options?: SendOptions) {
     if (this.isEmpty) return;
 
     if (this._dictationSession) {
@@ -187,7 +188,7 @@ export abstract class BaseComposerRuntimeCore
       metadata: { custom: { ...(quote ? { quote } : {}) } },
     };
 
-    this.handleSend(message);
+    this.handleSend(message, options);
     this._notifyEventSubscribers("send");
   }
 
@@ -197,6 +198,7 @@ export abstract class BaseComposerRuntimeCore
 
   protected abstract handleSend(
     message: Omit<AppendMessage, "parentId" | "sourceId">,
+    options?: SendOptions,
   ): void;
   protected abstract handleCancel(): void;
 

package/src/runtime/base/default-edit-composer-runtime-core.ts

@@ -2,6 +2,7 @@ import type { AppendMessage, ThreadMessage } from "../../types/message";
 import { getThreadMessageText } from "../../utils/text";
 import type { AttachmentAdapter } from "../../adapters/attachment";
 import type { DictationAdapter } from "../../adapters/speech";
+import type { SendOptions } from "../interfaces/composer-runtime-core";
 import type { ThreadRuntimeCore } from "../interfaces/thread-runtime-core";
 import { BaseComposerRuntimeCore } from "./base-composer-runtime-core";
 
@@ -20,8 +21,8 @@ export class DefaultEditComposerRuntimeCore extends BaseComposerRuntimeCore {
 
   private _nonTextParts;
   private _previousText;
-  private _parentId;
-  private _sourceId;
+  private _parentId: string | null;
+  private _sourceId: string | null;
   constructor(
     private runtime: ThreadRuntimeCore & {
       adapters?:
@@ -48,16 +49,26 @@ export class DefaultEditComposerRuntimeCore extends BaseComposerRuntimeCore {
     this.setRunConfig({ ...runtime.composer.runConfig });
   }
 
+  public get parentId() {
+    return this._parentId;
+  }
+
+  public get sourceId() {
+    return this._sourceId;
+  }
+
   public async handleSend(
     message: Omit<AppendMessage, "parentId" | "sourceId">,
+    options?: SendOptions,
   ) {
     const text = getThreadMessageText(message as AppendMessage);
-    if (text !== this._previousText) {
+    if (text !== this._previousText || options?.startRun) {
       this.runtime.append({
         ...message,
         content: [...message.content, ...this._nonTextParts] as any,
         parentId: this._parentId,
         sourceId: this._sourceId,
+        startRun: options?.startRun,
       });
     }
 

package/src/runtime/base/default-thread-composer-runtime-core.ts

@@ -1,7 +1,10 @@
 import type { AppendMessage } from "../../types/message";
 import type { AttachmentAdapter } from "../../adapters/attachment";
 import type { DictationAdapter } from "../../adapters/speech";
-import type { ThreadComposerRuntimeCore } from "../interfaces/composer-runtime-core";
+import type {
+  SendOptions,
+  ThreadComposerRuntimeCore,
+} from "../interfaces/composer-runtime-core";
 import type { ThreadRuntimeCore } from "../interfaces/thread-runtime-core";
 import { BaseComposerRuntimeCore } from "./base-composer-runtime-core";
 
@@ -47,11 +50,13 @@ export class DefaultThreadComposerRuntimeCore
 
   public async handleSend(
     message: Omit<AppendMessage, "parentId" | "sourceId">,
+    options?: SendOptions,
   ) {
     this.runtime.append({
       ...(message as AppendMessage),
       parentId: this.runtime.messages.at(-1)?.id ?? null,
       sourceId: null,
+      startRun: options?.startRun,
     });
   }
 

package/src/runtime/interfaces/composer-runtime-core.ts

@@ -16,6 +16,10 @@ export type DictationState = {
   readonly inputDisabled?: boolean;
 };
 
+export type SendOptions = {
+  startRun?: boolean;
+};
+
 export type ComposerRuntimeCore = Readonly<{
   isEditing: boolean;
 
@@ -43,7 +47,7 @@ export type ComposerRuntimeCore = Readonly<{
   reset: () => Promise<void>;
   clearAttachments: () => Promise<void>;
 
-  send: () => void;
+  send: (options?: SendOptions) => void;
   cancel: () => void;
 
   dictation: DictationState | undefined;
@@ -59,3 +63,9 @@ export type ComposerRuntimeCore = Readonly<{
 }>;
 
 export type ThreadComposerRuntimeCore = ComposerRuntimeCore;
+
+export type EditComposerRuntimeCore = ComposerRuntimeCore &
+  Readonly<{
+    parentId: string | null;
+    sourceId: string | null;
+  }>;

package/src/runtime/interfaces/thread-runtime-core.ts

@@ -12,7 +12,7 @@ import type {
 import type { ExportedMessageRepository } from "../utils/message-repository";
 import type { ThreadMessageLike } from "../utils/thread-message-like";
 import type {
-  ComposerRuntimeCore,
+  EditComposerRuntimeCore,
   ThreadComposerRuntimeCore,
 } from "./composer-runtime-core";
 
@@ -120,7 +120,7 @@ export type ThreadRuntimeCore = Readonly<{
   getModelContext: () => ModelContext;
 
   composer: ThreadComposerRuntimeCore;
-  getEditComposer: (messageId: string) => ComposerRuntimeCore | undefined;
+  getEditComposer: (messageId: string) => EditComposerRuntimeCore | undefined;
   beginEdit: (messageId: string) => void;
 
   speech: SpeechState | undefined;

package/src/store/scopes/composer.ts

@@ -3,11 +3,14 @@ import type { MessageRole } from "../../types/message";
 import type { QuoteInfo } from "../../types/quote";
 import type { RunConfig } from "../../types/message";
 import type { ComposerRuntime } from "../../runtime/api/composer-runtime";
-import type { DictationState } from "../../runtime/interfaces/composer-runtime-core";
+import type {
+  DictationState,
+  SendOptions,
+} from "../../runtime/interfaces/composer-runtime-core";
 import type { AttachmentMethods } from "./attachment";
 import type { QueueItemState, QueueItemMethods } from "./queue-item";
 
-export type ComposerSendOptions = {
+export type ComposerSendOptions = SendOptions & {
   /**
    * Whether to steer (interrupt the current run and process this message immediately).
    * When false (default), the message is queued and processed in order.

package/src/types/index.ts

@@ -45,3 +45,8 @@ export type {
   Unstable_DirectiveSegment,
   Unstable_DirectiveFormatter,
 } from "./mention";
+
+export type {
+  Unstable_TriggerItem,
+  Unstable_TriggerCategory,
+} from "./trigger";

package/src/types/mention.ts

@@ -1,27 +1,16 @@
-import type { ReadonlyJSONObject } from "assistant-stream/utils";
+import type { Unstable_TriggerItem, Unstable_TriggerCategory } from "./trigger";
 
 // =============================================================================
-// Mention Item (user-facing definition for items that can be @-mentioned)
+// Mention Item — alias of the generic TriggerItem for backward compatibility
 // =============================================================================
 
-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_MentionItem = Unstable_TriggerItem;
 
 // =============================================================================
-// Mention Category (for hierarchical navigation)
+// Mention Category — alias of the generic TriggerCategory
 // =============================================================================
 
-export type Unstable_MentionCategory = {
-  readonly id: string;
-  readonly label: string;
-  readonly icon?: string | undefined;
-};
+export type Unstable_MentionCategory = Unstable_TriggerCategory;
 
 // =============================================================================
 // Directive Segment (parsed representation of mention directives in text)

package/src/types/trigger.ts

@@ -0,0 +1,24 @@
+import type { ReadonlyJSONObject } from "assistant-stream/utils";
+
+// =============================================================================
+// Trigger Item (generic item for any trigger-based popover: @mention, /command)
+// =============================================================================
+
+export type Unstable_TriggerItem = {
+  readonly id: string;
+  readonly type: string;
+  readonly label: string;
+  readonly icon?: string | undefined;
+  readonly description?: string | undefined;
+  readonly metadata?: ReadonlyJSONObject | undefined;
+};
+
+// =============================================================================
+// Trigger Category (for hierarchical navigation in trigger popovers)
+// =============================================================================
+
+export type Unstable_TriggerCategory = {
+  readonly id: string;
+  readonly label: string;
+  readonly icon?: string | undefined;
+};