@love-moon/app-sdk 0.4.2 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @love-moon/app-sdk
 
+## 0.5.0
+
+### Minor Changes
+
+- 5fd165b: Align the app SDK ChatView with the Conductor web chat experience: add
+  dedicated MessageBubble and QuestionNav components, expand MessageList
+  rendering, and reset chat store state on task switch (covering restart).
+  Also ship the REST adapter task hooks and an app-sdk integration guide.
+
 ## 0.4.2
 
 ## 0.4.1

package/dist/index.d.ts

@@ -239,6 +239,18 @@ interface ChatAdapter {
     interrupt(taskId: string, opts: {
         targetReplyTo: string;
     }): Promise<void>;
+    /**
+     * Optional. Restart the task's AI session. Adapters that don't support
+     * restart may omit it — the widget hides all restart affordances (empty-
+     * state button + bubble action) when this method is absent.
+     *
+     * `restartMode` mirrors Conductor's REST contract (e.g. `'refresh_session'`
+     * to refresh the running session in place). When omitted the BFF decides
+     * the default.
+     */
+    restart?(taskId: string, opts?: {
+        restartMode?: string;
+    }): Promise<void>;
     /** Optional. Adapters that don't support attachments may omit. */
     uploadAttachment?(taskId: string, file: File | Blob, opts?: {
         signal?: AbortSignal;

package/dist/react/index.d.ts

@@ -48,29 +48,25 @@ interface SendMessageInput {
  * branch on `role` / `metadata` / `attachments` if it wants to. Return any
  * ReactNode; the SDK still wraps it in `<div class="conductor-bubble">` and
  * applies role-based alignment / pending styling.
- *
- * Returning `null` (or `undefined`) renders an empty bubble — equivalent to
- * a message with empty content. If you want to suppress the bubble entirely,
- * filter the message upstream (e.g. via your own MessageList).
  */
 type RenderMessageContent = (message: Message) => ReactNode;
 interface MessageListProps {
     labels: ChatViewLabels;
     /**
      * Optional override for how each message's content is rendered inside its
-     * bubble. Defaults to plain text (`message.content`). Pass e.g. a
-     * `react-markdown` renderer here to enable markdown formatting:
-     *
-     *   <MessageList
-     *     labels={...}
-     *     renderMessageContent={(m) => (
-     *       <ReactMarkdown remarkPlugins={[remarkGfm]}>{m.content}</ReactMarkdown>
-     *     )}
-     *   />
+     * bubble. Defaults to plain text (`message.content`).
      */
     renderMessageContent?: RenderMessageContent;
+    /** Forwarded to each bubble; see MessageBubble. */
+    showAppOriginChip?: boolean;
+    /**
+     * When true, hide mutating actions (resend / interrupt / restart, including
+     * the empty-state restart button). Copy stays available. Mirrors the
+     * `readOnly` ChatView prop.
+     */
+    readOnly?: boolean;
 }
-declare function MessageList({ labels, renderMessageContent }: MessageListProps): react_jsx_runtime.JSX.Element;
+declare function MessageList({ labels, renderMessageContent, showAppOriginChip, readOnly, }: MessageListProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Runtime status pushed by the daemon while a task is in progress.
@@ -171,6 +167,18 @@ interface ChatAdapter {
     interrupt(taskId: string, opts: {
         targetReplyTo: string;
     }): Promise<void>;
+    /**
+     * Optional. Restart the task's AI session. Adapters that don't support
+     * restart may omit it — the widget hides all restart affordances (empty-
+     * state button + bubble action) when this method is absent.
+     *
+     * `restartMode` mirrors Conductor's REST contract (e.g. `'refresh_session'`
+     * to refresh the running session in place). When omitted the BFF decides
+     * the default.
+     */
+    restart?(taskId: string, opts?: {
+        restartMode?: string;
+    }): Promise<void>;
     /** Optional. Adapters that don't support attachments may omit. */
     uploadAttachment?(taskId: string, file: File | Blob, opts?: {
         signal?: AbortSignal;
@@ -222,6 +230,8 @@ interface ChatViewProps {
     className?: string;
     /** Disable send/interact (e.g. when task is read-only). */
     readOnly?: boolean;
+    /** Focus the composer on mount / when the task changes. Default `false`. */
+    autoFocus?: boolean;
 }
 interface ChatViewLabels {
     statusThinking: string;
@@ -233,6 +243,22 @@ interface ChatViewLabels {
     interrupt: string;
     restart: string;
     loadEarlier: string;
+    /** Action-menu label: copy the message text. */
+    copy: string;
+    /** Action-menu label shown briefly after a successful copy. */
+    copied: string;
+    /** Action-menu label: re-send a user message's text. */
+    resend: string;
+    /** Accessible label for the floating "jump to latest" button. */
+    scrollToBottom: string;
+    /** Accessible label prefix for the question-anchor navigation dots. */
+    jumpToQuestion: string;
+    /** Empty-state heading shown when the task has no messages yet. */
+    emptyTitle: string;
+    /** Empty-state body copy shown below the heading. */
+    emptyBody: string;
+    /** Empty-state / action-menu button to restart the AI session. */
+    restartPending: string;
 }
 interface ChatViewTheme {
     accent?: string;
@@ -246,10 +272,12 @@ declare function ChatView(props: ChatViewProps): react_jsx_runtime.JSX.Element;
 
 interface MessageInputProps {
     labels: ChatViewLabels;
-    /** Disable the send button (useful while a turn is in progress). */
+    /** Disable the composer (e.g. read-only task). */
     disabled?: boolean;
+    /** Focus the textarea on mount / when the task changes. */
+    autoFocus?: boolean;
 }
-declare function MessageInput({ labels, disabled }: MessageInputProps): react_jsx_runtime.JSX.Element;
+declare function MessageInput({ labels, disabled, autoFocus }: MessageInputProps): react_jsx_runtime.JSX.Element;
 
 interface RuntimeStatusBarProps {
     labels: ChatViewLabels;
@@ -296,6 +324,15 @@ interface ChatContextValue {
     }) => Promise<void>;
     interrupt: () => Promise<void>;
     loadEarlier: () => Promise<void>;
+    /**
+     * Restart the task's AI session. No-op when the adapter doesn't implement
+     * `restart` — check `restartSupported` before surfacing restart UI.
+     */
+    restart: (opts?: {
+        restartMode?: string;
+    }) => Promise<void>;
+    /** True when the active adapter implements `restart`. */
+    restartSupported: boolean;
 }
 declare function useChat(): ChatContextValue;
 interface ChatProviderProps {
@@ -320,6 +357,9 @@ declare function ChatProvider(props: ChatProviderProps): react_jsx_runtime.JSX.E
  *   POST /tasks/:taskId/interrupt
  *        body: { target_reply_to }
  *        → 200
+ *   POST /tasks/:taskId/restart           (optional)
+ *        body: { restart_mode? }
+ *        → 200
  *   GET  /tasks/:taskId/events
  *        → text/event-stream emitting `data: <ChatEvent JSON>\n\n`
  *
@@ -350,6 +390,16 @@ interface RestAdapterOptions {
     eventSource?: typeof globalThis.EventSource;
     /** Per-request timeout in ms. Default 30_000. */
     timeoutMs?: number;
+    /**
+     * Enable the optional `restart()` adapter method. Default `false`.
+     *
+     * When enabled, `<ChatView>` shows restart affordances (empty-state button +
+     * bubble action). You MUST then implement `POST {baseUrl}/tasks/:id/restart`
+     * on your BFF (forward to Conductor's `POST /api/tasks/:id/restart`, or call
+     * `client.tasks.restart()`), or the control will 404. Left `false`, the
+     * widget hides all restart UI.
+     */
+    enableRestart?: boolean;
 }
 declare function createRestAdapter(options: RestAdapterOptions): ChatAdapter;