@athenaintel/react 0.13.0 → 0.14.0

package/dist/chat-ui/thread/composer-send-or-stop.d.ts

@@ -0,0 +1,44 @@
+import type { FC, RefObject } from "react";
+import { type ComposerAction } from "../composer/composer-action";
+import type { TiptapComposerHandle } from "../composer/tiptap-composer";
+export interface ComposerStopControls {
+    /**
+     * Cancels the active run via the runtime. Returns false when cancellation
+     * threw (e.g. the run already settled), so hosts can report whether their
+     * own teardown still needs to stop backend work.
+     */
+    cancelRun: () => boolean;
+}
+export interface ComposerSendOrStopProps {
+    composerRef: RefObject<TiptapComposerHandle | null>;
+    hasDraft: boolean;
+    /** Disables both send and stop (e.g. while a conversation restores). */
+    disabled?: boolean;
+    /**
+     * Blocks sending (not stopping) with this reason as the tooltip — e.g. a
+     * broken host tunnel that would make tool calls silently fail.
+     */
+    sendBlockedReason?: string | null;
+    /** Tooltip for the send/queue control while `disabled`. */
+    sendDisabledTitle?: string;
+    /** Tooltip for the stop control while `disabled`. */
+    stopDisabledTitle?: string;
+    /**
+     * Host work to run before the draft submits (per-turn bookkeeping).
+     * `action` distinguishes a fresh send from queueing into an active run.
+     */
+    onBeforeSend?: (context: {
+        action: Extract<ComposerAction, "send" | "queue">;
+    }) => void | Promise<void>;
+    /**
+     * Full custom stop sequence. Hosts that must tear down in-flight host-side
+     * work sequence it around `controls.cancelRun()`. Default: cancel the run.
+     */
+    onStop?: (controls: ComposerStopControls) => void;
+}
+/**
+ * The shared send/queue/stop control: sends the composer draft, queues it as
+ * a follow-up while a run is in flight, or stops the run when there is
+ * nothing to queue.
+ */
+export declare const ComposerSendOrStop: FC<ComposerSendOrStopProps>;