@tangle-network/agent-app 0.43.7 → 0.43.9

package/dist/assistant/index.d.ts

@@ -15,9 +15,12 @@ import '@tangle-network/agent-interface';
  * is the source of truth for what it accepts and emits.
  */
 
+type AssistantDeliveryMode = "steering" | "queue";
 /** Request body for `POST /api/v1/assistant/chat`. */
 interface ChatRequest {
     message: string;
+    /** How to deliver text when a session may already be active. Defaults to steering. */
+    deliveryMode?: AssistantDeliveryMode;
     /** Model slug to run this turn against; omit to use the server default. */
     model?: string;
     /** Omit to start a new thread; pass to continue an existing one. */
@@ -321,6 +324,9 @@ type ConfirmResult = {
     ok: false;
     error: string;
 };
+declare class AssistantClientInputError extends Error {
+    readonly code = "INVALID_REQUEST";
+}
 /** The assistant network surface, bound to one host's transport config. */
 interface AssistantClient {
     fetchModels(signal?: AbortSignal): Promise<AssistantModelsResult>;
@@ -410,6 +416,9 @@ interface AssistantState {
  * helpers; this hook is the glue between them and the network.
  */
 
+interface AssistantSendOptions {
+    deliveryMode?: AssistantDeliveryMode;
+}
 /** Host integration callbacks for {@link useAssistantChat}. */
 interface UseAssistantChatOptions {
     /**
@@ -428,7 +437,7 @@ interface AssistantChat {
     selectedModel: string | null;
     /** Choose the model for subsequent turns (persisted per user). */
     setModel: (model: string | null) => void;
-    send: (message: string) => void;
+    send: (message: string, options?: AssistantSendOptions) => void;
     stop: () => void;
     confirm: (proposal: PendingProposal) => Promise<void>;
     cancel: (proposal: PendingProposal) => void;
@@ -621,4 +630,4 @@ declare function AssistantLauncherProvider({ children, }: {
 }): react.JSX.Element;
 declare function useAssistantLauncher(): AssistantLauncher;
 
-export { type AssistantChat, type AssistantClient, type AssistantClientConfig, AssistantClientProvider, AssistantDock, type AssistantDockProps, type AssistantLauncher, AssistantLauncherProvider, type AssistantModelOption, type AssistantModels, type AssistantModelsResult, AssistantPanel, type AssistantPanelProps, type AssistantStreamEvent, type AssistantThreadSummary, type AssistantThreads, AssistantTranscript, type AssistantTranscriptProps, type AssistantTranscriptView, type ChatMessage, type ChatRequest, type ChatRole, type ConfirmResult, type ConnectionRequirement, type ConnectionRequirementKind, type DeltaEventData, type DoneEventData, type ErrorEventData, type PendingProposal, ProposalCard, type ProposalCardProps, type ReasoningEventData, type ThreadEventData, type ThreadHistoryResult, type ToolActivityStatus, type ToolCallEventData, type ToolOutcome, type ToolProposalEventData, type ToolResultEventData, type UsageEventData, type UsageInfo, type UseAssistantChatOptions, adaptTranscript, assistantIsThinking, createAssistantClient, useAssistantChat, useAssistantClient, useAssistantLauncher, useAssistantModels, useAssistantThreads };
+export { type AssistantChat, type AssistantClient, type AssistantClientConfig, AssistantClientInputError, AssistantClientProvider, type AssistantDeliveryMode, AssistantDock, type AssistantDockProps, type AssistantLauncher, AssistantLauncherProvider, type AssistantModelOption, type AssistantModels, type AssistantModelsResult, AssistantPanel, type AssistantPanelProps, type AssistantSendOptions, type AssistantStreamEvent, type AssistantThreadSummary, type AssistantThreads, AssistantTranscript, type AssistantTranscriptProps, type AssistantTranscriptView, type ChatMessage, type ChatRequest, type ChatRole, type ConfirmResult, type ConnectionRequirement, type ConnectionRequirementKind, type DeltaEventData, type DoneEventData, type ErrorEventData, type PendingProposal, ProposalCard, type ProposalCardProps, type ReasoningEventData, type ThreadEventData, type ThreadHistoryResult, type ToolActivityStatus, type ToolCallEventData, type ToolOutcome, type ToolProposalEventData, type ToolResultEventData, type UsageEventData, type UsageInfo, type UseAssistantChatOptions, adaptTranscript, assistantIsThinking, createAssistantClient, useAssistantChat, useAssistantClient, useAssistantLauncher, useAssistantModels, useAssistantThreads };

package/dist/assistant/index.js

@@ -98,7 +98,23 @@ async function readSSEEvents(body, onEvent) {
 }
 
 // src/assistant/client.ts
+var AssistantClientInputError = class extends Error {
+  code = "INVALID_REQUEST";
+};
 var EMPTY_MODELS = { default: null, models: [] };
+var ASSISTANT_DELIVERY_MODES = /* @__PURE__ */ new Set([
+  "steering",
+  "queue"
+]);
+function resolveDeliveryMode(value) {
+  if (value === void 0) return "steering";
+  if (typeof value === "string" && ASSISTANT_DELIVERY_MODES.has(value)) {
+    return value;
+  }
+  throw new AssistantClientInputError(
+    `Invalid assistant delivery mode: ${String(value)}`
+  );
+}
 function asObject(v) {
   return v && typeof v === "object" && !Array.isArray(v) ? v : null;
 }
@@ -391,6 +407,10 @@ function createAssistantClient(config) {
       }
     },
     async streamChat(req, onEvent, signal) {
+      const body = {
+        ...req,
+        deliveryMode: resolveDeliveryMode(req.deliveryMode)
+      };
       const res = await fetch(url("/chat"), {
         method: "POST",
         headers: {
@@ -399,7 +419,7 @@ function createAssistantClient(config) {
           Accept: "text/event-stream"
         },
         credentials,
-        body: JSON.stringify(req),
+        body: JSON.stringify(body),
         signal
       });
       if (!res.ok) {
@@ -1087,6 +1107,7 @@ function useAssistantChat(userId, options) {
     }
   );
   const abortRef = useRef(null);
+  const pendingQueuedSendRef = useRef(null);
   const historyAbortRef = useRef(null);
   const hydratedUserRef = useRef(userId);
   const streamSeqRef = useRef(0);
@@ -1114,11 +1135,60 @@ function useAssistantChat(userId, options) {
   );
   const selectedModelRef = useRef(selectedModel);
   selectedModelRef.current = selectedModel;
+  const clearPendingQueuedSend = useCallback(() => {
+    pendingQueuedSendRef.current = null;
+  }, []);
+  const abortActiveStream = useCallback(() => {
+    abortRef.current?.abort();
+    abortRef.current = null;
+  }, []);
+  const startChatStream = useCallback(
+    (text, deliveryMode, model, threadId) => {
+      dispatch({
+        type: "send",
+        messageId: uuid(),
+        assistantId: uuid(),
+        text
+      });
+      const seq = ++streamSeqRef.current;
+      const ac = new AbortController();
+      abortRef.current = ac;
+      sendingRef.current = true;
+      clientRef.current.streamChat(
+        {
+          message: text,
+          deliveryMode,
+          // null → omit, so the server applies its default model.
+          model,
+          threadId,
+          turnKey: uuid()
+        },
+        (event) => {
+          if (streamSeqRef.current === seq) dispatch({ type: "stream", event });
+        },
+        ac.signal
+      ).catch((err) => {
+        if (ac.signal.aborted || streamSeqRef.current !== seq) return;
+        dispatch({
+          type: "stream_failed",
+          error: {
+            code: err instanceof AssistantClientInputError ? err.code : "NETWORK",
+            message: err instanceof Error ? err.message : "The connection failed"
+          }
+        });
+      }).finally(() => {
+        if (streamSeqRef.current === seq) sendingRef.current = false;
+        if (abortRef.current === ac) abortRef.current = null;
+      });
+    },
+    []
+  );
   useEffect(() => {
     if (hydratedUserRef.current === userId) return;
     streamSeqRef.current += 1;
     confirmSeqRef.current += 1;
-    abortRef.current?.abort();
+    abortActiveStream();
+    clearPendingQueuedSend();
     historyAbortRef.current?.abort();
     setRestoringBoth(false);
     sendingRef.current = false;
@@ -1134,7 +1204,21 @@ function useAssistantChat(userId, options) {
       threadId: loadThread(userId).threadId,
       messages: []
     });
-  }, [userId, setRestoringBoth]);
+  }, [userId, abortActiveStream, clearPendingQueuedSend, setRestoringBoth]);
+  useEffect(() => {
+    const pending = pendingQueuedSendRef.current;
+    if (!pending || state.status === "streaming") return;
+    pendingQueuedSendRef.current = null;
+    if (pending.ownerId !== userIdRef.current || state.pendingProposals.length > 0) {
+      return;
+    }
+    startChatStream(
+      pending.text,
+      "queue",
+      pending.model,
+      state.threadId ?? void 0
+    );
+  }, [state.status, state.pendingProposals.length, startChatStream]);
   useEffect(() => {
     const threadId = loadThread(userId).threadId;
     if (!userId || !threadId) return;
@@ -1169,57 +1253,46 @@ function useAssistantChat(userId, options) {
     });
   }, [state.ownerId, state.threadId, state.status]);
   useEffect(() => {
-    return () => abortRef.current?.abort();
-  }, []);
-  const send = useCallback((message) => {
-    if (sendingRef.current) return;
+    return () => {
+      abortActiveStream();
+      clearPendingQueuedSend();
+    };
+  }, [abortActiveStream, clearPendingQueuedSend]);
+  const send = useCallback((message, options2) => {
+    const deliveryMode = options2?.deliveryMode;
+    const shouldQueue = deliveryMode === "queue";
+    if (sendingRef.current && !shouldQueue) return;
+    if (!shouldQueue && pendingQueuedSendRef.current) return;
+    if (shouldQueue && pendingQueuedSendRef.current) return;
     const text = message.trim();
     const current = stateRef.current;
     if (current.ownerId !== userIdRef.current) return;
     if (restoringRef.current) return;
-    if (!text || current.status === "streaming") return;
+    if (!text) return;
     if (current.pendingProposals.length > 0) return;
-    dispatch({
-      type: "send",
-      messageId: uuid(),
-      assistantId: uuid(),
-      text
-    });
-    const seq = ++streamSeqRef.current;
-    const ac = new AbortController();
-    abortRef.current = ac;
-    sendingRef.current = true;
-    clientRef.current.streamChat(
-      {
-        message: text,
-        // null → omit, so the server applies its default model.
-        model: selectedModelRef.current ?? void 0,
-        threadId: current.threadId ?? void 0,
-        turnKey: uuid()
-      },
-      (event) => {
-        if (streamSeqRef.current === seq) dispatch({ type: "stream", event });
-      },
-      ac.signal
-    ).catch((err) => {
-      if (ac.signal.aborted || streamSeqRef.current !== seq) return;
-      dispatch({
-        type: "stream_failed",
-        error: {
-          code: "NETWORK",
-          message: err instanceof Error ? err.message : "The connection failed"
-        }
-      });
-    }).finally(() => {
-      if (streamSeqRef.current === seq) sendingRef.current = false;
-    });
-  }, []);
+    if (current.status === "streaming") {
+      if (!shouldQueue) return;
+      pendingQueuedSendRef.current = {
+        ownerId: current.ownerId,
+        text,
+        model: selectedModelRef.current ?? void 0
+      };
+      return;
+    }
+    startChatStream(
+      text,
+      deliveryMode,
+      selectedModelRef.current ?? void 0,
+      current.threadId ?? void 0
+    );
+  }, [startChatStream]);
   const stop = useCallback(() => {
     streamSeqRef.current += 1;
-    abortRef.current?.abort();
+    abortActiveStream();
+    clearPendingQueuedSend();
     sendingRef.current = false;
     dispatch({ type: "stopped" });
-  }, []);
+  }, [abortActiveStream, clearPendingQueuedSend]);
   const confirm = useCallback(async (proposal) => {
     const pid = proposal.proposalId;
     if (!pid) {
@@ -1292,14 +1365,15 @@ function useAssistantChat(userId, options) {
   const reset = useCallback(() => {
     streamSeqRef.current += 1;
     confirmSeqRef.current += 1;
-    abortRef.current?.abort();
+    abortActiveStream();
+    clearPendingQueuedSend();
     historyAbortRef.current?.abort();
     setRestoringBoth(false);
     sendingRef.current = false;
     confirmingRef.current.clear();
     setConfirmingIds(EMPTY_IDS);
     dispatch({ type: "reset" });
-  }, [setRestoringBoth]);
+  }, [abortActiveStream, clearPendingQueuedSend, setRestoringBoth]);
   const switchThread = useCallback(
     (threadId) => {
       const current = stateRef.current;
@@ -1311,7 +1385,8 @@ function useAssistantChat(userId, options) {
       }
       streamSeqRef.current += 1;
       confirmSeqRef.current += 1;
-      abortRef.current?.abort();
+      abortActiveStream();
+      clearPendingQueuedSend();
       sendingRef.current = false;
       confirmingRef.current.clear();
       setConfirmingIds(EMPTY_IDS);
@@ -1351,7 +1426,7 @@ function useAssistantChat(userId, options) {
         if (!ac.signal.aborted) setRestoringBoth(false);
       });
     },
-    [setRestoringBoth]
+    [abortActiveStream, clearPendingQueuedSend, setRestoringBoth]
   );
   const setModel = useCallback((model) => {
     selectedModelRef.current = model;
@@ -2763,6 +2838,7 @@ function AssistantDock({
   ] });
 }
 export {
+  AssistantClientInputError,
   AssistantClientProvider,
   AssistantDock,
   AssistantLauncherProvider,