@athenaintel/react 0.57.1 → 0.59.0

package/dist/chat/typed-interrupts/use-statewire-typed-interrupt.js

@@ -0,0 +1,231 @@
+import { useAuiState } from "@assistant-ui/react";
+import { isTypedInterruptRequest, parseTypedInterruptPayload } from "../../agent-runtime/src/typed-interrupts.js";
+import { hasInterruptTimeout, stampTypedInterruptAnswer, isTypedApprovalInterrupt, typedAnswerLetsSomethingRun, typedInterruptCancel, stripInterruptTimeoutText, interruptTimeoutRemaining } from "../../agent-runtime/src/typed-interrupt-kinds.js";
+import { useQuery, useMutation } from "@tanstack/react-query";
+import { useState, useRef, useMemo, useEffect, useCallback } from "react";
+import { useAthenaQueryClient } from "../../lib/use-athena-rest-query.js";
+import { useStatewireApprovalRequest } from "../use-statewire-approval-request.js";
+import { useTypedInterruptConversation, readInterruptTimeoutCancelled, cancelInterruptTimeout } from "./typed-interrupt-graphql.js";
+import { HITL_PENDING_RESUME_GRACE_MS } from "../../agent-runtime/src/interrupts.js";
+import { statewireTransportOutcome, isConversationArchivedRejection, CONVERSATION_ARCHIVED_MESSAGE, statewireRejectionDetailMessage } from "../../agent-runtime/src/errors.js";
+const TYPED_INTERRUPT_ANSWER_FAILED_MESSAGE = "Your answer could not be sent. Please try again.";
+const TIMEOUT_STATUS_DELAY_MS = 500;
+const CANCEL_TIMEOUT_RETRIES = 2;
+const CANCEL_TIMEOUT_INITIAL_DELAY_MS = 500;
+function refusalMessage(error) {
+  if (isConversationArchivedRejection(error)) return CONVERSATION_ARCHIVED_MESSAGE;
+  return statewireRejectionDetailMessage(error) ?? TYPED_INTERRUPT_ANSWER_FAILED_MESSAGE;
+}
+function useStatewireTypedInterrupt(options = {}) {
+  const { confirmDecision, onResumeRejected, pendingResumeGraceMs } = options;
+  const isConversationStreaming = useAuiState((state) => state.thread.isRunning);
+  const conversation = useTypedInterruptConversation();
+  const queryClient = useAthenaQueryClient();
+  const [held, setHeld] = useState(null);
+  const lastHeldRef = useRef(null);
+  const [failure, setFailure] = useState(null);
+  const onResumeRejectedRef = useRef(onResumeRejected);
+  onResumeRejectedRef.current = onResumeRejected;
+  const confirmDecisionRef = useRef(confirmDecision);
+  confirmDecisionRef.current = confirmDecision;
+  const {
+    request,
+    requestId: liveRequestId,
+    pending,
+    resume: sendResume
+  } = useStatewireApprovalRequest({
+    interruptPredicate: isTypedInterruptRequest,
+    pendingResumeGraceMs: pendingResumeGraceMs ?? HITL_PENDING_RESUME_GRACE_MS,
+    // The host refused the answer (or the transport lost it): the fold has
+    // rolled back and the request is on screen again; say why on the card.
+    onResumeRejected: (error, refusedRequestId) => {
+      var _a;
+      setHeld(null);
+      if (statewireTransportOutcome(error) === "unmount") return;
+      setFailure({ requestId: refusedRequestId, message: refusalMessage(error) });
+      (_a = onResumeRejectedRef.current) == null ? void 0 : _a.call(onResumeRejectedRef, error, refusedRequestId);
+    },
+    // The socket dropped with the answer in flight and the lock re-sends it:
+    // a fresh hold keeps the card through the re-send.
+    onResumeRetry: (_error, retriedRequestId) => {
+      const last = lastHeldRef.current;
+      if (last && last.requestId === retriedRequestId) setHeld({ ...last });
+    }
+  });
+  const liveInterrupt = useMemo(
+    () => request ? parseTypedInterruptPayload(request.payload) : null,
+    [request]
+  );
+  useEffect(() => {
+    if (held && liveRequestId !== void 0) setHeld(null);
+  }, [held, liveRequestId]);
+  const graceMs = pendingResumeGraceMs ?? HITL_PENDING_RESUME_GRACE_MS;
+  useEffect(() => {
+    if (!held) return void 0;
+    const timer = setTimeout(() => setHeld(null), graceMs);
+    return () => clearTimeout(timer);
+  }, [held, graceMs]);
+  const holding = held !== null && liveInterrupt === null;
+  const interrupt = holding ? held.interrupt : liveInterrupt;
+  const requestId = holding ? held.requestId : liveRequestId;
+  const [confirming, setConfirming] = useState(false);
+  const currentRequestIdRef = useRef(liveRequestId);
+  currentRequestIdRef.current = liveRequestId;
+  const isLoading = pending || holding || confirming;
+  const instanceKey = interrupt ? requestId ?? null : null;
+  const [timeoutRemaining, setTimeoutRemaining] = useState(null);
+  const [isTimedOut, setIsTimedOut] = useState(false);
+  const [cancelledInstance, setCancelledInstance] = useState(null);
+  const isTimeoutCancelled = instanceKey !== null && cancelledInstance === instanceKey;
+  const timed = interrupt !== null && hasInterruptTimeout(interrupt);
+  const timeoutSeconds = (interrupt == null ? void 0 : interrupt.timeout_seconds) ?? null;
+  const timeoutAt = (interrupt == null ? void 0 : interrupt.timeout_at) ?? null;
+  useEffect(() => {
+    if (!interrupt || !timed || isTimeoutCancelled) {
+      setTimeoutRemaining(null);
+      setIsTimedOut(false);
+      return void 0;
+    }
+    const tick = () => {
+      const remaining = interruptTimeoutRemaining(interrupt);
+      setTimeoutRemaining(remaining);
+      setIsTimedOut(remaining !== null && remaining <= 0);
+    };
+    tick();
+    const interval = setInterval(tick, 1e3);
+    return () => clearInterval(interval);
+  }, [interrupt, timed, isTimeoutCancelled]);
+  const [statusReady, setStatusReady] = useState(false);
+  useEffect(() => {
+    setStatusReady(false);
+    if (!timed || !timeoutAt) return void 0;
+    const timer = setTimeout(() => setStatusReady(true), TIMEOUT_STATUS_DELAY_MS);
+    return () => clearTimeout(timer);
+  }, [timed, timeoutAt]);
+  const source = (interrupt == null ? void 0 : interrupt.source) ?? null;
+  const statusEnabled = timed && statusReady && !isTimeoutCancelled && conversation !== null && source !== null;
+  const { data: cancelledBefore } = useQuery(
+    {
+      queryKey: [
+        "athena-sdk",
+        "interrupt-timeout-status",
+        (conversation == null ? void 0 : conversation.auth.backendUrl) ?? "",
+        (conversation == null ? void 0 : conversation.principal) ?? "",
+        (conversation == null ? void 0 : conversation.threadId) ?? "",
+        source ?? "",
+        timeoutAt ?? ""
+      ],
+      queryFn: ({ signal }) => {
+        if (!conversation || !source) return false;
+        return readInterruptTimeoutCancelled(conversation, source, signal);
+      },
+      enabled: statusEnabled,
+      staleTime: Number.POSITIVE_INFINITY,
+      retry: false,
+      refetchOnWindowFocus: false
+    },
+    queryClient
+  );
+  useEffect(() => {
+    if (cancelledBefore === true && instanceKey !== null) setCancelledInstance(instanceKey);
+  }, [cancelledBefore, instanceKey]);
+  const { mutate: sendCancelTimeout } = useMutation(
+    {
+      mutationKey: ["athena-sdk", "interrupt-timeout-cancel"],
+      mutationFn: ({ interruptId }) => {
+        if (!conversation) return Promise.reject(new Error("no conversation to stop the timer of"));
+        return cancelInterruptTimeout(conversation, interruptId);
+      },
+      // The backend's timer answers at the deadline unless this lands: a
+      // blip must not let it fire while the person is answering.
+      retry: CANCEL_TIMEOUT_RETRIES,
+      retryDelay: (attempt) => {
+        const base = CANCEL_TIMEOUT_INITIAL_DELAY_MS * 2 ** attempt;
+        return base + Math.random() * base * 0.3;
+      }
+    },
+    queryClient
+  );
+  const canCancelTimeout = timed && conversation !== null;
+  const cancelRequestedRef = useRef(null);
+  const cancelTimeout = useCallback(() => {
+    if (!interrupt || !canCancelTimeout || isTimeoutCancelled || instanceKey === null) return;
+    if (cancelRequestedRef.current === instanceKey) return;
+    const instance = instanceKey;
+    cancelRequestedRef.current = instance;
+    setCancelledInstance(instance);
+    sendCancelTimeout(
+      { interruptId: interrupt.source },
+      {
+        // agora did not stop it after the retries: the countdown is true
+        // again, and Stop timer may ask once more.
+        onError: () => {
+          if (cancelRequestedRef.current === instance) cancelRequestedRef.current = null;
+          setCancelledInstance((current) => current === instance ? null : current);
+        }
+      }
+    );
+  }, [interrupt, canCancelTimeout, isTimeoutCancelled, instanceKey, sendCancelTimeout]);
+  const sendAnswer = useCallback(
+    (kind, value) => {
+      if (!interrupt || requestId === void 0) return;
+      setFailure(null);
+      const answer = stampTypedInterruptAnswer({ payload: interrupt, value });
+      const park = { interrupt, requestId };
+      const deliver = (decisionCheck) => {
+        const dispatched = sendResume(answer, decisionCheck ? { decisionCheck } : void 0);
+        if (!dispatched) return;
+        lastHeldRef.current = park;
+        setHeld(park);
+        dispatched.then(
+          () => setHeld(null),
+          () => setHeld(null)
+        );
+      };
+      const confirm = confirmDecisionRef.current;
+      if (confirm === void 0 || kind !== "resume" || !isTypedApprovalInterrupt(interrupt) || !typedAnswerLetsSomethingRun(answer)) {
+        deliver();
+        return;
+      }
+      setConfirming(true);
+      confirm({ kind: "input", requestId, value: answer }).catch(() => void 0).then((token) => {
+        setConfirming(false);
+        if (currentRequestIdRef.current !== requestId) return;
+        deliver(token);
+      });
+    },
+    [interrupt, requestId, sendResume]
+  );
+  const resume = useCallback((value) => sendAnswer("resume", value), [sendAnswer]);
+  const cancel = useCallback(() => sendAnswer("cancel", typedInterruptCancel()), [sendAnswer]);
+  const message = interrupt == null ? void 0 : interrupt.message;
+  const displayMessage = useMemo(() => {
+    if (!message) return "";
+    return isTimeoutCancelled ? stripInterruptTimeoutText(message) : message;
+  }, [message, isTimeoutCancelled]);
+  return {
+    interrupt,
+    request,
+    requestId,
+    resume,
+    cancel,
+    failure: failure !== null && failure.requestId === requestId ? failure.message : null,
+    isLoading,
+    isConversationStreaming,
+    isHiddenByRunning: isConversationStreaming && !isLoading,
+    hasTimeout: timed,
+    timeoutSeconds,
+    timeoutRemaining,
+    isTimedOut,
+    isTimeoutCancelled,
+    canCancelTimeout,
+    cancelTimeout,
+    displayMessage,
+    currentThreadId: (conversation == null ? void 0 : conversation.threadId) ?? null
+  };
+}
+export {
+  TYPED_INTERRUPT_ANSWER_FAILED_MESSAGE,
+  useStatewireTypedInterrupt
+};
+//# sourceMappingURL=use-statewire-typed-interrupt.js.map

package/dist/chat/typed-interrupts/use-statewire-typed-interrupt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-statewire-typed-interrupt.js","sources":["../../../src/chat/typed-interrupts/use-statewire-typed-interrupt.ts"],"sourcesContent":["/**\n * The typed-interrupt engine: everything a typed card renders from, and the\n * two ways it answers. The port of Olympus's `useLangGraphInterrupt` onto the\n * SDK, on the same request machine the approval card runs\n * (`useStatewireApprovalRequest`: selection, the optimistic resume lock and\n * its recovery), with ONE predicate, `isTypedInterruptRequest`, so the request\n * a card renders for is the request its answer is sent under.\n *\n * On top of the lock it adds what the cards need:\n *\n * - the parsed payload, held while the host decides an answer, so the card\n *   keeps what the person typed (react-statewire folds `run/input` away the\n *   instant it is applied, before any verdict, and a refusal brings the same\n *   request back);\n * - the stamps the raiser's stale-resume check reads (`__interrupt_id__`,\n *   `__interrupt_instance_id__`) on every answer;\n * - the passkey decision check (identity 0b.9) on an answer that approves a\n *   typed approval (`isTypedApprovalInterrupt`), through the host's\n *   `confirmDecision`, as the approval card runs it; a question's answer, a\n *   reject and a cancel never ask;\n * - the host's reason when it refuses an answer (agora holds an approving\n *   answer to a signed-in person: `person_decision_required` names where to\n *   answer instead), for the card to show;\n * - the timed-interrupt countdown (display only: the backend's timer answers),\n *   whether the person already stopped it, and stopping it.\n *\n * Requires a statewire aui scope (the SDK's statewire hooks throw outside\n * one): `StatewireTypedInterruptCard` mounts it under `StatewireApprovalCard`'s\n * extras gate.\n */\n\nimport { useAuiState } from '@assistant-ui/react';\nimport type { StatewireThread } from '@assistant-ui/react-statewire';\nimport {\n  CONVERSATION_ARCHIVED_MESSAGE,\n  HITL_PENDING_RESUME_GRACE_MS,\n  isConversationArchivedRejection,\n  statewireRejectionDetailMessage,\n  statewireTransportOutcome,\n} from '@athenaintel/agent-runtime';\nimport {\n  isTypedInterruptRequest,\n  parseTypedInterruptPayload,\n  type TypedInterruptPayload,\n} from '@athenaintel/agent-runtime/typed-interrupts';\nimport {\n  hasInterruptTimeout,\n  interruptTimeoutRemaining,\n  isTypedApprovalInterrupt,\n  stampTypedInterruptAnswer,\n  stripInterruptTimeoutText,\n  typedAnswerLetsSomethingRun,\n  typedInterruptCancel,\n} from '@athenaintel/agent-runtime/typed-interrupt-kinds';\nimport { useMutation, useQuery } from '@tanstack/react-query';\nimport type { ReadonlyJSONObject } from 'assistant-stream/utils';\nimport { useCallback, useEffect, useMemo, useRef, useState } from 'react';\nimport { useAthenaQueryClient } from '../../lib/use-athena-rest-query';\nimport type { StatewireDecisionConfirmer } from '../StatewireApprovalCard';\nimport { useStatewireApprovalRequest } from '../use-statewire-approval-request';\nimport {\n  cancelInterruptTimeout,\n  readInterruptTimeoutCancelled,\n  useTypedInterruptConversation,\n} from './typed-interrupt-graphql';\nimport type { TypedInterruptAnswer, TypedInterruptEngineSlice } from './typed-interrupt-types';\n\n/** What a card says when the host refused an answer without saying why. */\nexport const TYPED_INTERRUPT_ANSWER_FAILED_MESSAGE = 'Your answer could not be sent. Please try again.';\n\n/** The backend registers a park's timer just before it parks: ask about it a moment later. */\nconst TIMEOUT_STATUS_DELAY_MS = 500;\nconst CANCEL_TIMEOUT_RETRIES = 2;\nconst CANCEL_TIMEOUT_INITIAL_DELAY_MS = 500;\n\nexport interface UseStatewireTypedInterruptOptions {\n  /**\n   * The host's passkey decision check (identity 0b.9), as `StatewireApprovalCard`\n   * takes it: an answer that approves a typed approval is handed to it first\n   * and sent with the token it resolves.\n   */\n  confirmDecision?: StatewireDecisionConfirmer;\n  /** The host refused an answer (or the transport lost it); the card is back with its controls. */\n  onResumeRejected?: (error: unknown, requestId: string) => void;\n  /** How long a sent answer keeps the card locked when no resume run ever starts. */\n  pendingResumeGraceMs?: number;\n}\n\nexport interface StatewireTypedInterrupt extends TypedInterruptEngineSlice {\n  /** The parked typed interrupt (held while the host decides an answer), or `null`. */\n  interrupt: TypedInterruptPayload | null;\n  /** The live request (absent while an answer is held). */\n  request: StatewireThread.CustomInputRequest | undefined;\n  /**\n   * The thread moved on without this park: running, and no answer of this\n   * card's own in flight. The card stands down while it holds.\n   */\n  isHiddenByRunning: boolean;\n  /** Why the host refused this park's last answer, until the next one is sent. */\n  failure: string | null;\n  /** Answer the park with its kind's resume value. */\n  resume: (value: TypedInterruptAnswer) => void;\n  /** Answer the park with `{ action: 'cancel' }`. */\n  cancel: () => void;\n}\n\ninterface HeldPark {\n  interrupt: TypedInterruptPayload;\n  requestId: string;\n}\n\nfunction refusalMessage(error: unknown): string {\n  if (isConversationArchivedRejection(error)) return CONVERSATION_ARCHIVED_MESSAGE;\n  return statewireRejectionDetailMessage(error) ?? TYPED_INTERRUPT_ANSWER_FAILED_MESSAGE;\n}\n\nexport function useStatewireTypedInterrupt(\n  options: UseStatewireTypedInterruptOptions = {},\n): StatewireTypedInterrupt {\n  const { confirmDecision, onResumeRejected, pendingResumeGraceMs } = options;\n  const isConversationStreaming = useAuiState((state) => state.thread.isRunning);\n  const conversation = useTypedInterruptConversation();\n  const queryClient = useAthenaQueryClient();\n\n  const [held, setHeld] = useState<HeldPark | null>(null);\n  const lastHeldRef = useRef<HeldPark | null>(null);\n  const [failure, setFailure] = useState<{ requestId: string; message: string } | null>(null);\n  const onResumeRejectedRef = useRef(onResumeRejected);\n  onResumeRejectedRef.current = onResumeRejected;\n  const confirmDecisionRef = useRef(confirmDecision);\n  confirmDecisionRef.current = confirmDecision;\n\n  const {\n    request,\n    requestId: liveRequestId,\n    pending,\n    resume: sendResume,\n  } = useStatewireApprovalRequest<ReadonlyJSONObject>({\n    interruptPredicate: isTypedInterruptRequest,\n    pendingResumeGraceMs: pendingResumeGraceMs ?? HITL_PENDING_RESUME_GRACE_MS,\n    // The host refused the answer (or the transport lost it): the fold has\n    // rolled back and the request is on screen again; say why on the card.\n    onResumeRejected: (error, refusedRequestId) => {\n      setHeld(null);\n      // The surface itself went away mid-flight: nobody to tell.\n      if (statewireTransportOutcome(error) === 'unmount') return;\n      setFailure({ requestId: refusedRequestId, message: refusalMessage(error) });\n      onResumeRejectedRef.current?.(error, refusedRequestId);\n    },\n    // The socket dropped with the answer in flight and the lock re-sends it:\n    // a fresh hold keeps the card through the re-send.\n    onResumeRetry: (_error, retriedRequestId) => {\n      const last = lastHeldRef.current;\n      if (last && last.requestId === retriedRequestId) setHeld({ ...last });\n    },\n  });\n\n  // The predicate parsed the payload already; parse again for its value.\n  const liveInterrupt = useMemo(\n    () => (request ? parseTypedInterruptPayload(request.payload) : null),\n    [request],\n  );\n\n  // A hold ends with the host's verdict (below), when a park is live again\n  // (the refused one, under its id, or a new one), or after the grace window.\n  useEffect(() => {\n    if (held && liveRequestId !== undefined) setHeld(null);\n  }, [held, liveRequestId]);\n  const graceMs = pendingResumeGraceMs ?? HITL_PENDING_RESUME_GRACE_MS;\n  useEffect(() => {\n    if (!held) return undefined;\n    const timer = setTimeout(() => setHeld(null), graceMs);\n    return () => clearTimeout(timer);\n  }, [held, graceMs]);\n  const holding = held !== null && liveInterrupt === null;\n  const interrupt = holding ? held.interrupt : liveInterrupt;\n  const requestId = holding ? held.requestId : liveRequestId;\n\n  // A passkey check is open for an answer sent from here.\n  const [confirming, setConfirming] = useState(false);\n  // The park on screen now, read once a check settles: an answer confirmed for\n  // a park that is gone is never sent to whatever parked next.\n  const currentRequestIdRef = useRef(liveRequestId);\n  currentRequestIdRef.current = liveRequestId;\n  const isLoading = pending || holding || confirming;\n\n  // ── The timer (display only; the backend's timer answers at the deadline) ──\n  // Everything below is per park instance: the request id, never the source,\n  // which repeats (every toolkit selection is `toolkit_selection`).\n  const instanceKey = interrupt ? (requestId ?? null) : null;\n  const [timeoutRemaining, setTimeoutRemaining] = useState<number | null>(null);\n  const [isTimedOut, setIsTimedOut] = useState(false);\n  const [cancelledInstance, setCancelledInstance] = useState<string | null>(null);\n  const isTimeoutCancelled = instanceKey !== null && cancelledInstance === instanceKey;\n  const timed = interrupt !== null && hasInterruptTimeout(interrupt);\n  const timeoutSeconds = interrupt?.timeout_seconds ?? null;\n  const timeoutAt = interrupt?.timeout_at ?? null;\n\n  useEffect(() => {\n    if (!interrupt || !timed || isTimeoutCancelled) {\n      setTimeoutRemaining(null);\n      setIsTimedOut(false);\n      return undefined;\n    }\n    const tick = () => {\n      const remaining = interruptTimeoutRemaining(interrupt);\n      setTimeoutRemaining(remaining);\n      setIsTimedOut(remaining !== null && remaining <= 0);\n    };\n    tick();\n    const interval = setInterval(tick, 1000);\n    return () => clearInterval(interval);\n  }, [interrupt, timed, isTimeoutCancelled]);\n\n  // Whether the person stopped this park's timer before (another app, a\n  // reload): asked once per instance, a moment after it parks.\n  const [statusReady, setStatusReady] = useState(false);\n  useEffect(() => {\n    setStatusReady(false);\n    if (!timed || !timeoutAt) return undefined;\n    const timer = setTimeout(() => setStatusReady(true), TIMEOUT_STATUS_DELAY_MS);\n    return () => clearTimeout(timer);\n  }, [timed, timeoutAt]);\n  const source = interrupt?.source ?? null;\n  const statusEnabled =\n    timed && statusReady && !isTimeoutCancelled && conversation !== null && source !== null;\n  const { data: cancelledBefore } = useQuery(\n    {\n      queryKey: [\n        'athena-sdk',\n        'interrupt-timeout-status',\n        conversation?.auth.backendUrl ?? '',\n        conversation?.principal ?? '',\n        conversation?.threadId ?? '',\n        source ?? '',\n        timeoutAt ?? '',\n      ],\n      queryFn: ({ signal }) => {\n        if (!conversation || !source) return false;\n        return readInterruptTimeoutCancelled(conversation, source, signal);\n      },\n      enabled: statusEnabled,\n      staleTime: Number.POSITIVE_INFINITY,\n      retry: false,\n      refetchOnWindowFocus: false,\n    },\n    queryClient,\n  );\n  useEffect(() => {\n    if (cancelledBefore === true && instanceKey !== null) setCancelledInstance(instanceKey);\n  }, [cancelledBefore, instanceKey]);\n\n  const { mutate: sendCancelTimeout } = useMutation(\n    {\n      mutationKey: ['athena-sdk', 'interrupt-timeout-cancel'],\n      mutationFn: ({ interruptId }: { interruptId: string }) => {\n        if (!conversation) return Promise.reject(new Error('no conversation to stop the timer of'));\n        return cancelInterruptTimeout(conversation, interruptId);\n      },\n      // The backend's timer answers at the deadline unless this lands: a\n      // blip must not let it fire while the person is answering.\n      retry: CANCEL_TIMEOUT_RETRIES,\n      retryDelay: (attempt) => {\n        const base = CANCEL_TIMEOUT_INITIAL_DELAY_MS * 2 ** attempt;\n        return base + Math.random() * base * 0.3;\n      },\n    },\n    queryClient,\n  );\n\n  // Only agora can stop its timer: without the conversation (a host that\n  // names no thread) the countdown stays, and nothing offers to stop it.\n  const canCancelTimeout = timed && conversation !== null;\n  // One request per park: a press on Stop timer is also the card's first\n  // interaction, and both ask in the same tick, before a render says so.\n  const cancelRequestedRef = useRef<string | null>(null);\n  const cancelTimeout = useCallback(() => {\n    if (!interrupt || !canCancelTimeout || isTimeoutCancelled || instanceKey === null) return;\n    if (cancelRequestedRef.current === instanceKey) return;\n    const instance = instanceKey;\n    cancelRequestedRef.current = instance;\n    setCancelledInstance(instance);\n    sendCancelTimeout(\n      { interruptId: interrupt.source },\n      {\n        // agora did not stop it after the retries: the countdown is true\n        // again, and Stop timer may ask once more.\n        onError: () => {\n          if (cancelRequestedRef.current === instance) cancelRequestedRef.current = null;\n          setCancelledInstance((current) => (current === instance ? null : current));\n        },\n      },\n    );\n  }, [interrupt, canCancelTimeout, isTimeoutCancelled, instanceKey, sendCancelTimeout]);\n\n  // ── Answers ──\n  const sendAnswer = useCallback(\n    (kind: 'resume' | 'cancel', value: TypedInterruptAnswer) => {\n      if (!interrupt || requestId === undefined) return;\n      setFailure(null);\n      const answer = stampTypedInterruptAnswer({ payload: interrupt, value }) as ReadonlyJSONObject;\n      const park: HeldPark = { interrupt, requestId };\n      const deliver = (decisionCheck?: string) => {\n        const dispatched = sendResume(answer, decisionCheck ? { decisionCheck } : undefined);\n        if (!dispatched) return;\n        lastHeldRef.current = park;\n        setHeld(park);\n        // Accepted or refused, the verdict ends the hold (a refusal also\n        // brings the request back through the live selection).\n        dispatched.then(\n          () => setHeld(null),\n          () => setHeld(null),\n        );\n      };\n      const confirm = confirmDecisionRef.current;\n      if (\n        confirm === undefined ||\n        kind !== 'resume' ||\n        !isTypedApprovalInterrupt(interrupt) ||\n        !typedAnswerLetsSomethingRun(answer)\n      ) {\n        deliver();\n        return;\n      }\n      // Identity 0b.9: approving is confirmed with the person's passkey first,\n      // as the approval card does; a check that gave no token sends the\n      // answer without one, and agora decides.\n      setConfirming(true);\n      confirm({ kind: 'input', requestId, value: answer })\n        .catch(() => undefined)\n        .then((token) => {\n          setConfirming(false);\n          if (currentRequestIdRef.current !== requestId) return;\n          deliver(token);\n        });\n    },\n    [interrupt, requestId, sendResume],\n  );\n\n  const resume = useCallback((value: TypedInterruptAnswer) => sendAnswer('resume', value), [sendAnswer]);\n  const cancel = useCallback(() => sendAnswer('cancel', typedInterruptCancel()), [sendAnswer]);\n\n  const message = interrupt?.message;\n  const displayMessage = useMemo(() => {\n    if (!message) return '';\n    return isTimeoutCancelled ? stripInterruptTimeoutText(message) : message;\n  }, [message, isTimeoutCancelled]);\n\n  return {\n    interrupt,\n    request,\n    requestId,\n    resume,\n    cancel,\n    failure: failure !== null && failure.requestId === requestId ? failure.message : null,\n    isLoading,\n    isConversationStreaming,\n    isHiddenByRunning: isConversationStreaming && !isLoading,\n    hasTimeout: timed,\n    timeoutSeconds,\n    timeoutRemaining,\n    isTimedOut,\n    isTimeoutCancelled,\n    canCancelTimeout,\n    cancelTimeout,\n    displayMessage,\n    currentThreadId: conversation?.threadId ?? null,\n  };\n}\n"],"names":[],"mappings":"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"}

package/dist/chat-ui/composer/composer-named-agents.cjs

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const namedAgents = require("../../agent-runtime/src/named-agents.cjs");
+function stageComposerNamedAgents({
+  threadId,
+  text,
+  agents
+}) {
+  namedAgents.stageDeepAgentNamedAgentsForSend({ threadId, agents });
+  namedAgents.rememberDeepAgentSentNamedAgents({ threadId, text, agents });
+}
+exports.stageComposerNamedAgents = stageComposerNamedAgents;
+//# sourceMappingURL=composer-named-agents.cjs.map

package/dist/chat-ui/composer/composer-named-agents.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"composer-named-agents.cjs","sources":["../../../src/chat-ui/composer/composer-named-agents.ts"],"sourcesContent":["/**\n * The agents a composer's message names (identity v7 D13), on its way out. The names, the To line's\n * chips and how a run receives them are `@athenaintel/agent-runtime/named-agents`', the module\n * Olympus's composer runs on too; this is the composer's part of the send, used only by a composer\n * that names agents (`TiptapComposer`'s `chatAgents`, which `AthenaChat` passes when its host\n * offers the Agents category).\n */\n\nimport {\n  type DeepAgentNamedAgent,\n  rememberDeepAgentSentNamedAgents,\n  stageDeepAgentNamedAgentsForSend,\n} from \"@athenaintel/agent-runtime/named-agents\";\n\n/**\n * Right before the composer runtime sends `text`: stage the names it carries, so the message's own\n * metadata (`addressedAgents`) names exactly those agents wherever it waits and whenever it is\n * posted, and remember them with the text, so the text coming back (a refused send handed back)\n * brings its chips back. A message naming none stages nothing and\n * lets earlier staged names go. The To line keeps its chips for the next message.\n */\nexport function stageComposerNamedAgents({\n  threadId,\n  text,\n  agents,\n}: {\n  threadId: string;\n  text: string;\n  agents: readonly DeepAgentNamedAgent[];\n}): void {\n  stageDeepAgentNamedAgentsForSend({ threadId, agents });\n  rememberDeepAgentSentNamedAgents({ threadId, text, agents });\n}\n"],"names":["stageDeepAgentNamedAgentsForSend","rememberDeepAgentSentNamedAgents"],"mappings":";;;AAqBO,SAAS,yBAAyB;AAAA,EACvC;AAAA,EACA;AAAA,EACA;AACF,GAIS;AACPA,+CAAiC,EAAE,UAAU,QAAQ;AACrDC,cAAAA,iCAAiC,EAAE,UAAU,MAAM,OAAA,CAAQ;AAC7D;;"}

package/dist/chat-ui/composer/composer-named-agents.d.ts

@@ -0,0 +1,20 @@
+/**
+ * The agents a composer's message names (identity v7 D13), on its way out. The names, the To line's
+ * chips and how a run receives them are `@athenaintel/agent-runtime/named-agents`', the module
+ * Olympus's composer runs on too; this is the composer's part of the send, used only by a composer
+ * that names agents (`TiptapComposer`'s `chatAgents`, which `AthenaChat` passes when its host
+ * offers the Agents category).
+ */
+import { type DeepAgentNamedAgent } from "../../agent-runtime/src/named-agents";
+/**
+ * Right before the composer runtime sends `text`: stage the names it carries, so the message's own
+ * metadata (`addressedAgents`) names exactly those agents wherever it waits and whenever it is
+ * posted, and remember them with the text, so the text coming back (a refused send handed back)
+ * brings its chips back. A message naming none stages nothing and
+ * lets earlier staged names go. The To line keeps its chips for the next message.
+ */
+export declare function stageComposerNamedAgents({ threadId, text, agents, }: {
+    threadId: string;
+    text: string;
+    agents: readonly DeepAgentNamedAgent[];
+}): void;

package/dist/chat-ui/composer/composer-named-agents.js

@@ -0,0 +1,13 @@
+import { stageDeepAgentNamedAgentsForSend, rememberDeepAgentSentNamedAgents } from "../../agent-runtime/src/named-agents.js";
+function stageComposerNamedAgents({
+  threadId,
+  text,
+  agents
+}) {
+  stageDeepAgentNamedAgentsForSend({ threadId, agents });
+  rememberDeepAgentSentNamedAgents({ threadId, text, agents });
+}
+export {
+  stageComposerNamedAgents
+};
+//# sourceMappingURL=composer-named-agents.js.map

package/dist/chat-ui/composer/composer-named-agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composer-named-agents.js","sources":["../../../src/chat-ui/composer/composer-named-agents.ts"],"sourcesContent":["/**\n * The agents a composer's message names (identity v7 D13), on its way out. The names, the To line's\n * chips and how a run receives them are `@athenaintel/agent-runtime/named-agents`', the module\n * Olympus's composer runs on too; this is the composer's part of the send, used only by a composer\n * that names agents (`TiptapComposer`'s `chatAgents`, which `AthenaChat` passes when its host\n * offers the Agents category).\n */\n\nimport {\n  type DeepAgentNamedAgent,\n  rememberDeepAgentSentNamedAgents,\n  stageDeepAgentNamedAgentsForSend,\n} from \"@athenaintel/agent-runtime/named-agents\";\n\n/**\n * Right before the composer runtime sends `text`: stage the names it carries, so the message's own\n * metadata (`addressedAgents`) names exactly those agents wherever it waits and whenever it is\n * posted, and remember them with the text, so the text coming back (a refused send handed back)\n * brings its chips back. A message naming none stages nothing and\n * lets earlier staged names go. The To line keeps its chips for the next message.\n */\nexport function stageComposerNamedAgents({\n  threadId,\n  text,\n  agents,\n}: {\n  threadId: string;\n  text: string;\n  agents: readonly DeepAgentNamedAgent[];\n}): void {\n  stageDeepAgentNamedAgentsForSend({ threadId, agents });\n  rememberDeepAgentSentNamedAgents({ threadId, text, agents });\n}\n"],"names":[],"mappings":";AAqBO,SAAS,yBAAyB;AAAA,EACvC;AAAA,EACA;AAAA,EACA;AACF,GAIS;AACP,mCAAiC,EAAE,UAAU,QAAQ;AACrD,mCAAiC,EAAE,UAAU,MAAM,OAAA,CAAQ;AAC7D;"}

package/dist/chat-ui/composer/slash-command-menu.cjs

@@ -0,0 +1,143 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const jsxRuntime = require("react/jsx-runtime");
+const require$$0 = require("react");
+const slashCommands = require("./slash-commands.cjs");
+const cnfast = require("cnfast");
+function slashCommandRuns(command) {
+  return !command.disabledReason;
+}
+const SlashCommandMenu = require$$0.forwardRef(
+  ({ sections, onPick }, ref) => {
+    const rows = slashCommands.slashCommandRows(sections);
+    const listId = require$$0.useId();
+    const selectedRef = require$$0.useRef(null);
+    const rowsKey = rows.map((row) => row.command.name).join("\0");
+    const [selection, setSelection] = require$$0.useState({ rowsKey, index: 0 });
+    const current = selection.rowsKey === rowsKey ? Math.min(selection.index, Math.max(rows.length - 1, 0)) : 0;
+    const setSelected = (index2) => setSelection({ rowsKey, index: index2 });
+    require$$0.useEffect(() => {
+      var _a, _b;
+      (_b = (_a = selectedRef.current) == null ? void 0 : _a.scrollIntoView) == null ? void 0 : _b.call(_a, { block: "nearest" });
+    }, [current]);
+    const pick = (match) => {
+      if (match && slashCommandRuns(match.command)) onPick(match);
+    };
+    require$$0.useImperativeHandle(
+      ref,
+      () => ({
+        onKeyDown: (event) => {
+          if (rows.length === 0) return false;
+          switch (event.key) {
+            case "ArrowDown":
+              setSelected((current + 1) % rows.length);
+              return true;
+            case "ArrowUp":
+              setSelected((current - 1 + rows.length) % rows.length);
+              return true;
+            case "Enter":
+            case "NumpadEnter":
+            case "Tab":
+              if (event.isComposing) return false;
+              pick(rows[current]);
+              return true;
+            default:
+              return false;
+          }
+        }
+      }),
+      [current, rows]
+    );
+    if (rows.length === 0) return null;
+    let index = -1;
+    return /* @__PURE__ */ jsxRuntime.jsx(
+      "div",
+      {
+        id: listId,
+        role: "listbox",
+        "aria-label": "Commands",
+        "data-testid": "composer-slash-menu",
+        className: "max-h-80 min-w-[260px] max-w-[380px] overflow-y-auto rounded-md border bg-popover p-1 text-popover-foreground shadow-lg",
+        children: sections.map((section) => (
+          // A group of the listbox's options, named by its heading.
+          /* @__PURE__ */ jsxRuntime.jsxs(
+            "fieldset",
+            {
+              "aria-label": section.title ?? void 0,
+              className: "m-0 min-w-0 border-0 p-0 py-0.5",
+              children: [
+                section.title ? /* @__PURE__ */ jsxRuntime.jsx(
+                  "div",
+                  {
+                    "aria-hidden": true,
+                    className: "px-2 pb-0.5 pt-1.5 font-medium text-[11px] text-muted-foreground uppercase tracking-wide",
+                    children: section.title
+                  }
+                ) : null,
+                section.matches.map((match) => {
+                  index += 1;
+                  const rowIndex = index;
+                  const isSelected = rowIndex === current;
+                  const { command } = match;
+                  const runs = slashCommandRuns(command);
+                  const Icon = command.icon;
+                  return /* @__PURE__ */ jsxRuntime.jsxs(
+                    "div",
+                    {
+                      ref: isSelected ? selectedRef : void 0,
+                      role: "option",
+                      "aria-selected": isSelected,
+                      "aria-disabled": !runs || void 0,
+                      "data-command": command.name,
+                      tabIndex: -1,
+                      onMouseMove: () => setSelected(rowIndex),
+                      onClick: () => pick(match),
+                      onKeyDown: (event) => {
+                        if (event.key !== "Enter" && event.key !== " ") return;
+                        event.preventDefault();
+                        pick(match);
+                      },
+                      className: cnfast.cn(
+                        "flex cursor-pointer items-start gap-2 rounded px-2 py-1.5",
+                        isSelected && "bg-muted",
+                        !runs && "cursor-default"
+                      ),
+                      children: [
+                        Icon ? /* @__PURE__ */ jsxRuntime.jsx(
+                          Icon,
+                          {
+                            "aria-hidden": true,
+                            className: cnfast.cn("mt-0.5 size-4 shrink-0 text-muted-foreground", !runs && "opacity-50")
+                          }
+                        ) : null,
+                        /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "flex min-w-0 flex-1 flex-col", children: [
+                          /* @__PURE__ */ jsxRuntime.jsxs("span", { className: cnfast.cn("truncate text-sm leading-tight", !runs && "text-muted-foreground"), children: [
+                            command.label,
+                            match.args ? /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "text-muted-foreground", children: [
+                              " ",
+                              match.args
+                            ] }) : command.args ? /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "text-muted-foreground italic", children: [
+                              " ",
+                              command.args
+                            ] }) : null
+                          ] }),
+                          /* @__PURE__ */ jsxRuntime.jsx("span", { className: "mt-0.5 truncate text-muted-foreground text-xs leading-tight", children: runs ? command.description : command.disabledReason })
+                        ] })
+                      ]
+                    },
+                    command.name
+                  );
+                })
+              ]
+            },
+            section.title ?? ""
+          )
+        ))
+      }
+    );
+  }
+);
+SlashCommandMenu.displayName = "SlashCommandMenu";
+exports.SlashCommandMenu = SlashCommandMenu;
+exports.slashCommandRuns = slashCommandRuns;
+//# sourceMappingURL=slash-command-menu.cjs.map

package/dist/chat-ui/composer/slash-command-menu.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"slash-command-menu.cjs","sources":["../../../src/chat-ui/composer/slash-command-menu.tsx"],"sourcesContent":["/**\n * The composer's `/` menu: the commands what is typed finds, under their\n * groups, with the keyboard in the editor (arrows move, Enter or Tab picks,\n * Escape closes, as the `@` menu works). A command that can't run right now\n * lists greyed with its reason and picks nothing.\n */\n\nimport { forwardRef, useEffect, useId, useImperativeHandle, useRef, useState } from 'react';\nimport { cn } from '../../lib/utils';\nimport {\n  type ComposerSlashCommand,\n  type SlashCommandMatch,\n  type SlashCommandSection,\n  slashCommandRows,\n} from './slash-commands';\n\nexport interface SlashCommandMenuHandle {\n  /** A key from the editor while the menu is open; `true` when the menu took it. */\n  onKeyDown: (event: KeyboardEvent) => boolean;\n}\n\nexport interface SlashCommandMenuProps {\n  sections: readonly SlashCommandSection[];\n  /** Picks a row whose command can run. */\n  onPick: (match: SlashCommandMatch) => void;\n}\n\n/** Whether a command can run now (no reason it can't). */\nexport function slashCommandRuns(command: ComposerSlashCommand): boolean {\n  return !command.disabledReason;\n}\n\nexport const SlashCommandMenu = forwardRef<SlashCommandMenuHandle, SlashCommandMenuProps>(\n  ({ sections, onPick }, ref) => {\n    const rows = slashCommandRows(sections);\n    const listId = useId();\n    const selectedRef = useRef<HTMLDivElement>(null);\n    // The selection belongs to the rows it was made in: a query that lists\n    // other rows starts it over at the best match.\n    const rowsKey = rows.map((row) => row.command.name).join('\\u0000');\n    const [selection, setSelection] = useState({ rowsKey, index: 0 });\n    const current =\n      selection.rowsKey === rowsKey ? Math.min(selection.index, Math.max(rows.length - 1, 0)) : 0;\n    const setSelected = (index: number) => setSelection({ rowsKey, index });\n    useEffect(() => {\n      selectedRef.current?.scrollIntoView?.({ block: 'nearest' });\n    }, [current]);\n\n    const pick = (match: SlashCommandMatch | undefined) => {\n      if (match && slashCommandRuns(match.command)) onPick(match);\n    };\n\n    useImperativeHandle(\n      ref,\n      () => ({\n        onKeyDown: (event: KeyboardEvent): boolean => {\n          if (rows.length === 0) return false;\n          switch (event.key) {\n            case 'ArrowDown':\n              setSelected((current + 1) % rows.length);\n              return true;\n            case 'ArrowUp':\n              setSelected((current - 1 + rows.length) % rows.length);\n              return true;\n            case 'Enter':\n            case 'NumpadEnter':\n            case 'Tab':\n              // An input method's Enter confirms its text, never a command.\n              if (event.isComposing) return false;\n              // Taken even for a command that can't run, so it sends nothing either.\n              pick(rows[current]);\n              return true;\n            default:\n              return false;\n          }\n        },\n      }),\n      [current, rows],\n    );\n\n    if (rows.length === 0) return null;\n    let index = -1;\n    return (\n      <div\n        id={listId}\n        role=\"listbox\"\n        aria-label=\"Commands\"\n        data-testid=\"composer-slash-menu\"\n        className=\"max-h-80 min-w-[260px] max-w-[380px] overflow-y-auto rounded-md border bg-popover p-1 text-popover-foreground shadow-lg\"\n      >\n        {sections.map((section) => (\n          // A group of the listbox's options, named by its heading.\n          <fieldset\n            key={section.title ?? ''}\n            aria-label={section.title ?? undefined}\n            className=\"m-0 min-w-0 border-0 p-0 py-0.5\"\n          >\n            {section.title ? (\n              <div\n                aria-hidden\n                className=\"px-2 pb-0.5 pt-1.5 font-medium text-[11px] text-muted-foreground uppercase tracking-wide\"\n              >\n                {section.title}\n              </div>\n            ) : null}\n            {section.matches.map((match) => {\n              index += 1;\n              const rowIndex = index;\n              const isSelected = rowIndex === current;\n              const { command } = match;\n              const runs = slashCommandRuns(command);\n              const Icon = command.icon;\n              return (\n                <div\n                  key={command.name}\n                  ref={isSelected ? selectedRef : undefined}\n                  role=\"option\"\n                  aria-selected={isSelected}\n                  aria-disabled={!runs || undefined}\n                  data-command={command.name}\n                  tabIndex={-1}\n                  // Opening or scrolling the menu can place a row under a still\n                  // pointer: only a moving one takes the selection from the keyboard.\n                  onMouseMove={() => setSelected(rowIndex)}\n                  onClick={() => pick(match)}\n                  // The keyboard reaches the menu through the editor; an option\n                  // focused some other way (assistive technology) picks the same.\n                  onKeyDown={(event) => {\n                    if (event.key !== 'Enter' && event.key !== ' ') return;\n                    event.preventDefault();\n                    pick(match);\n                  }}\n                  className={cn(\n                    'flex cursor-pointer items-start gap-2 rounded px-2 py-1.5',\n                    isSelected && 'bg-muted',\n                    !runs && 'cursor-default',\n                  )}\n                >\n                  {Icon ? (\n                    <Icon\n                      aria-hidden\n                      className={cn('mt-0.5 size-4 shrink-0 text-muted-foreground', !runs && 'opacity-50')}\n                    />\n                  ) : null}\n                  <span className=\"flex min-w-0 flex-1 flex-col\">\n                    <span className={cn('truncate text-sm leading-tight', !runs && 'text-muted-foreground')}>\n                      {command.label}\n                      {match.args ? (\n                        <span className=\"text-muted-foreground\"> {match.args}</span>\n                      ) : command.args ? (\n                        <span className=\"text-muted-foreground italic\"> {command.args}</span>\n                      ) : null}\n                    </span>\n                    <span className=\"mt-0.5 truncate text-muted-foreground text-xs leading-tight\">\n                      {runs ? command.description : command.disabledReason}\n                    </span>\n                  </span>\n                </div>\n              );\n            })}\n          </fieldset>\n        ))}\n      </div>\n    );\n  },\n);\n\nSlashCommandMenu.displayName = 'SlashCommandMenu';\n"],"names":["forwardRef","slashCommandRows","useId","useRef","useState","index","useEffect","useImperativeHandle","jsx","jsxs","cn"],"mappings":"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"}

package/dist/chat-ui/composer/slash-command-menu.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The composer's `/` menu: the commands what is typed finds, under their
+ * groups, with the keyboard in the editor (arrows move, Enter or Tab picks,
+ * Escape closes, as the `@` menu works). A command that can't run right now
+ * lists greyed with its reason and picks nothing.
+ */
+import { type ComposerSlashCommand, type SlashCommandMatch, type SlashCommandSection } from './slash-commands';
+export interface SlashCommandMenuHandle {
+    /** A key from the editor while the menu is open; `true` when the menu took it. */
+    onKeyDown: (event: KeyboardEvent) => boolean;
+}
+export interface SlashCommandMenuProps {
+    sections: readonly SlashCommandSection[];
+    /** Picks a row whose command can run. */
+    onPick: (match: SlashCommandMatch) => void;
+}
+/** Whether a command can run now (no reason it can't). */
+export declare function slashCommandRuns(command: ComposerSlashCommand): boolean;
+export declare const SlashCommandMenu: import("react").ForwardRefExoticComponent<SlashCommandMenuProps & import("react").RefAttributes<SlashCommandMenuHandle>>;