@athenaintel/react 0.60.0 → 0.61.0

package/dist/chat/chat-voice-controls.d.ts

@@ -15,9 +15,14 @@ export declare function useComposerChatVoice({ options }: {
     active: boolean;
     audioRef: import("react").RefObject<HTMLAudioElement | null>;
 };
-export declare function ChatVoiceButton({ voice, disabled, disabledReason, }: {
+export declare function ChatVoiceButton({ voice, disabled, disabledReason, appearance, }: {
     voice: UseAthenaChatVoiceReturn;
     disabled: boolean;
+    /**
+     * `send`: drawn as the composer's Send (an ink circle with a waveform), where it stands in for Send
+     * while the draft is empty (`AthenaChatComposerSlots.voiceInSend`). `icon` (default): a plain icon.
+     */
+    appearance?: 'icon' | 'send';
     /**
      * Why a voice session can't start now (Athena can't be reached): shown as the tooltip of a
      * control that stays focusable and starts nothing. A session already connecting or live keeps its

package/dist/chat/chat-voice-controls.js

@@ -1,6 +1,6 @@
 import { jsx, jsxs } from "react/jsx-runtime";
 import { useAui } from "@assistant-ui/react";
-import { Loader2Icon, MicOffIcon, MicIcon, PhoneIcon, HeadphonesIcon, XIcon } from "lucide-react";
+import { Loader2Icon, MicOffIcon, MicIcon, PhoneIcon, AudioLinesIcon, HeadphonesIcon, XIcon } from "lucide-react";
 import { useRef, useMemo, useEffect } from "react";
 import { athenaDiagnostics } from "../diagnostics/athena-diagnostics.js";
 import { createDeepAgentVoiceLiveKitAdapter } from "../voice/livekit.js";
@@ -71,7 +71,8 @@ function useComposerChatVoice({ options }) {
 function ChatVoiceButton({
   voice,
   disabled,
-  disabledReason = null
+  disabledReason = null,
+  appearance = "icon"
 }) {
   const live = voice.phase === "live";
   const connecting = voice.phase === "connecting";
@@ -87,8 +88,10 @@ function ChatVoiceButton({
       "aria-pressed": live && !voice.micMuted,
       "aria-disabled": unavailable || void 0,
       "data-unavailable": unavailable || void 0,
+      ...appearance === "send" ? { variant: "default" } : {},
       className: cn(
         "aui-composer-voice size-8 rounded-full p-0 disabled:opacity-30",
+        appearance === "send" && "aui-composer-voice-send",
         unavailable && "cursor-not-allowed opacity-30 hover:bg-transparent"
       ),
       disabled: !unavailable && !live && !connecting && disabled,
@@ -99,7 +102,7 @@ function ChatVoiceButton({
         else if (moveHere) void voice.transferHere();
         else void voice.start();
       },
-      children: connecting ? /* @__PURE__ */ jsx(Loader2Icon, { className: "size-4 animate-spin" }) : live ? voice.micMuted ? /* @__PURE__ */ jsx(MicOffIcon, { className: "size-4" }) : /* @__PURE__ */ jsx(MicIcon, { className: "size-4" }) : moveHere ? /* @__PURE__ */ jsx(PhoneIcon, { className: "size-4" }) : /* @__PURE__ */ jsx(HeadphonesIcon, { className: "size-4" })
+      children: connecting ? /* @__PURE__ */ jsx(Loader2Icon, { className: "size-4 animate-spin" }) : live ? voice.micMuted ? /* @__PURE__ */ jsx(MicOffIcon, { className: "size-4" }) : /* @__PURE__ */ jsx(MicIcon, { className: "size-4" }) : moveHere ? /* @__PURE__ */ jsx(PhoneIcon, { className: "size-4" }) : appearance === "send" ? /* @__PURE__ */ jsx(AudioLinesIcon, { className: "size-4" }) : /* @__PURE__ */ jsx(HeadphonesIcon, { className: "size-4" })
     }
   );
 }

package/dist/chat/chat-voice-controls.js.map

@@ -1 +1 @@
-{"version":3,"file":"chat-voice-controls.js","sources":["../../src/chat/chat-voice-controls.tsx"],"sourcesContent":["import { useAui } from '@assistant-ui/react';\nimport {\n  describeVoiceLiveElsewhere,\n  playVoiceMoveEarcon,\n  useVoiceElapsed,\n  useVoiceMovedNotice,\n  VOICE_CONTINUE_BY_VOICE_LABEL,\n  VOICE_LIVE_TYPED_HINT,\n  VOICE_MOVE_CALL_HERE_LABEL,\n  VOICE_MOVE_HERE_ACTION,\n} from '@athenaintel/agent-runtime';\nimport { HeadphonesIcon, Loader2Icon, MicIcon, MicOffIcon, PhoneIcon, XIcon } from 'lucide-react';\nimport { useEffect, useMemo, useRef } from 'react';\nimport { athenaDiagnostics } from '../diagnostics/athena-diagnostics';\nimport { createDeepAgentVoiceLiveKitAdapter } from '../voice/livekit';\nimport {\n  useAthenaChatVoice,\n  type UseAthenaChatVoiceOptions,\n  type UseAthenaChatVoiceReturn,\n} from '../voice/chat';\nimport { useChatVoiceEnabled } from '../voice/use-chat-voice-enabled';\nimport { cn } from '../lib/utils';\nimport { Button } from '../ui/button';\nimport { TooltipIconButton } from './tooltip-icon-button';\nimport { useMentionAuth } from '../chat-ui/mentions/suggestions/data/api-client';\nimport { credentialFingerprint, useCatalogPrincipal } from '../catalog/runtime-catalog';\n\n/**\n * `onCallMoved` replaces the move earcon a call plays when it moves to or\n * from this device (pass a no-op to keep it silent); by default the shared\n * one plays.\n */\nexport interface AthenaChatVoiceOptions\n  extends Pick<UseAthenaChatVoiceOptions, 'model' | 'livekit' | 'onDiagnostic' | 'onCallMoved'> {}\n\n/** One controller for this composer's controls, text sends and audio sink. */\nexport function useComposerChatVoice({ options }: { options: boolean | AthenaChatVoiceOptions }) {\n  const aui = useAui();\n  const auth = useMentionAuth();\n  const principal = useCatalogPrincipal();\n  const enabled = useChatVoiceEnabled({ enabled: options !== false });\n  const audioRef = useRef<HTMLAudioElement | null>(null);\n  const media = useMemo(\n    () => createDeepAgentVoiceLiveKitAdapter({ audioElement: () => audioRef.current }),\n    []\n  );\n  const config = typeof options === 'object' ? options : undefined;\n  const voice = useAthenaChatVoice({\n    transport: 'livekit',\n    livekit: config?.livekit ?? media,\n    model: config?.model,\n    onDiagnostic:\n      config?.onDiagnostic ??\n      ((entry) => athenaDiagnostics.emit('voice.chat', { data: { ...entry } })),\n    onCallMoved: config?.onCallMoved ?? playVoiceMoveEarcon,\n  });\n  const active = voice.phase === 'connecting' || voice.phase === 'live';\n  const { end, syncProfile } = voice;\n  const identity = JSON.stringify([\n    auth.backendUrl,\n    principal,\n    auth.apiKey ? credentialFingerprint({ credential: auth.apiKey }) : null,\n  ]);\n  const previousScope = useRef({ identity, workspaceId: auth.workspaceId });\n  useEffect(() => {\n    const previous = previousScope.current;\n    const changed =\n      previous.identity !== identity ||\n      Boolean(\n        previous.workspaceId && auth.workspaceId && previous.workspaceId !== auth.workspaceId\n      );\n    previousScope.current = {\n      identity,\n      workspaceId:\n        previous.identity === identity\n          ? auth.workspaceId ?? previous.workspaceId\n          : auth.workspaceId,\n    };\n    if (active && (changed || !enabled)) end();\n  }, [identity, auth.workspaceId, active, enabled, end]);\n\n  // Model/agent/toolkit/mode picks live in the ambient model context. Read it\n  // through the controller at send time, with the same debounce as other hosts.\n  const live = voice.phase === 'live';\n  useEffect(() => {\n    if (!live) return;\n    let timer: ReturnType<typeof setTimeout>;\n    const schedule = () => {\n      clearTimeout(timer);\n      timer = setTimeout(syncProfile, 800);\n    };\n    schedule();\n    const unsubscribe = aui.modelContext.subscribe?.(schedule);\n    return () => {\n      clearTimeout(timer);\n      unsubscribe?.();\n    };\n  }, [aui, live, syncProfile]);\n  return { voice, enabled, active, audioRef };\n}\n\nexport function ChatVoiceButton({\n  voice,\n  disabled,\n  disabledReason = null,\n}: {\n  voice: UseAthenaChatVoiceReturn;\n  disabled: boolean;\n  /**\n   * Why a voice session can't start now (Athena can't be reached): shown as the tooltip of a\n   * control that stays focusable and starts nothing. A session already connecting or live keeps its\n   * Cancel and Mute.\n   */\n  disabledReason?: string | null;\n}) {\n  const live = voice.phase === 'live';\n  const connecting = voice.phase === 'connecting';\n  const unavailable = Boolean(disabledReason) && !live && !connecting;\n  // The conversation's call is live on another of the person's devices.\n  const moveHere = !live && !connecting && voice.liveElsewhere !== null;\n  const label = connecting\n    ? 'Cancel voice connection'\n    : live\n    ? voice.micMuted\n      ? 'Unmute microphone'\n      : 'Mute microphone'\n    : moveHere\n    ? VOICE_MOVE_CALL_HERE_LABEL\n    : 'Start voice session';\n  return (\n    <TooltipIconButton\n      type=\"button\"\n      tooltip={unavailable && disabledReason ? disabledReason : label}\n      aria-label={label}\n      aria-pressed={live && !voice.micMuted}\n      aria-disabled={unavailable || undefined}\n      data-unavailable={unavailable || undefined}\n      className={cn(\n        'aui-composer-voice size-8 rounded-full p-0 disabled:opacity-30',\n        unavailable && 'cursor-not-allowed opacity-30 hover:bg-transparent',\n      )}\n      disabled={!unavailable && !live && !connecting && disabled}\n      onClick={() => {\n        if (unavailable) return;\n        if (connecting) voice.end();\n        else if (live) voice.setMicMuted(!voice.micMuted);\n        else if (moveHere) void voice.transferHere();\n        else void voice.start();\n      }}\n    >\n      {connecting ? (\n        <Loader2Icon className=\"size-4 animate-spin\" />\n      ) : live ? (\n        voice.micMuted ? (\n          <MicOffIcon className=\"size-4\" />\n        ) : (\n          <MicIcon className=\"size-4\" />\n        )\n      ) : moveHere ? (\n        <PhoneIcon className=\"size-4\" />\n      ) : (\n        <HeadphonesIcon className=\"size-4\" />\n      )}\n    </TooltipIconButton>\n  );\n}\n\n/**\n * A host's \"Continue by voice\" offer for the open conversation: a handover the\n * person sent in voice mode landed here. `onDone` runs once they answer it —\n * took it, dismissed it, or typed instead — so the host clears the offer.\n */\nexport interface AthenaChatContinueByVoice {\n  onDone: () => void;\n}\n\n/**\n * The one-tap \"Continue by voice\" above the composer: it starts a call whose\n * model opens by saying where things stand. Shown while voice is idle here and\n * no call is live on another of the person's devices (\"Move here\" covers that).\n * Nothing starts the microphone without the tap.\n */\nexport function ChatVoiceContinueOffer({\n  voice,\n  offer,\n  disabled = false,\n  disabledReason = null,\n}: {\n  voice: UseAthenaChatVoiceReturn;\n  offer: AthenaChatContinueByVoice | null;\n  /** Starting would capture the microphone now (dictation, an upload, no channel). */\n  disabled?: boolean;\n  /** Why voice can't start now (Athena can't be reached), as the action's tooltip. */\n  disabledReason?: string | null;\n}) {\n  if (!offer || voice.phase !== 'idle' || voice.liveElsewhere !== null) return null;\n  return (\n    <div className=\"aui-chat-voice-continue flex items-center gap-1 px-2 pb-2\">\n      <Button\n        type=\"button\"\n        variant=\"outline\"\n        size=\"xs\"\n        title={disabledReason ?? undefined}\n        disabled={disabled || Boolean(disabledReason)}\n        onClick={() => {\n          offer.onDone();\n          void voice.start({ opening: 'recap' });\n        }}\n      >\n        <MicIcon aria-hidden=\"true\" />\n        {VOICE_CONTINUE_BY_VOICE_LABEL}\n      </Button>\n      <TooltipIconButton\n        type=\"button\"\n        tooltip=\"Not now\"\n        aria-label=\"Not now\"\n        className=\"size-6 rounded-md p-0\"\n        onClick={offer.onDone}\n      >\n        <XIcon className=\"size-3\" />\n      </TooltipIconButton>\n    </div>\n  );\n}\n\nexport function ChatVoiceStatus({\n  voice,\n  offerMove = false,\n  moveDisabled = false,\n  moveDisabledReason = null,\n}: {\n  voice: UseAthenaChatVoiceReturn;\n  /** Whether this composer may take a call from another device (its voice is enabled). */\n  offerMove?: boolean;\n  /** Moving the call here would capture the microphone now (dictation, an upload, no channel). */\n  moveDisabled?: boolean;\n  /** Why the call can't move here now (Athena can't be reached), as the action's tooltip. */\n  moveDisabledReason?: string | null;\n}) {\n  const elapsed = useVoiceElapsed(voice.liveSince);\n  const movedNotice = useVoiceMovedNotice(voice.movedTo);\n  const active = voice.phase === 'connecting' || voice.phase === 'live';\n  // \"Live call on your phone · Move here\", or briefly after this composer's call moved away,\n  // \"Call moved to your phone\".\n  const elsewhere = offerMove && !active && movedNotice === null ? voice.liveElsewhere : null;\n  if (!active && !voice.error && !voice.handoffTask && movedNotice === null && elsewhere === null)\n    return null;\n  const moveUnavailable = moveDisabled || Boolean(moveDisabledReason);\n  return (\n    <div className=\"aui-chat-voice-status flex flex-col gap-1 px-2 pb-2 text-xs text-muted-foreground\">\n      {/* No end control of its own: the composer's Stop ends the session\n          (and any run), so there is one way to stop everything. */}\n      {active && (\n        <span role=\"status\">\n          {voice.phase === 'connecting'\n            ? 'Connecting voice…'\n            : `Voice ${voice.micMuted ? 'muted' : 'live'}${elapsed ? ` · ${elapsed}` : ''}`}\n        </span>\n      )}\n      {voice.phase === 'live' && <span>{VOICE_LIVE_TYPED_HINT}</span>}\n      {voice.activeTask && <span>Athena is working: {voice.activeTask.text}</span>}\n      {voice.handoffTask && (\n        <span>Voice ended. Athena is still working: {voice.handoffTask.text}</span>\n      )}\n      {voice.notice && <span role=\"status\">{voice.notice}</span>}\n      {voice.error && (\n        <span role=\"alert\" className=\"text-destructive\">\n          {voice.error}\n        </span>\n      )}\n      {movedNotice !== null && <span role=\"status\">{movedNotice}</span>}\n      {elsewhere !== null && (\n        <span className=\"aui-chat-voice-elsewhere flex items-center gap-1\">\n          <span className=\"min-w-0 truncate\">{describeVoiceLiveElsewhere(elsewhere.surface)}</span>\n          <span aria-hidden=\"true\">·</span>\n          <button\n            type=\"button\"\n            title={moveDisabledReason ?? undefined}\n            disabled={moveUnavailable}\n            onClick={() => void voice.transferHere()}\n            className=\"shrink-0 font-medium text-foreground underline-offset-2 hover:underline disabled:cursor-not-allowed disabled:opacity-50\"\n          >\n            {VOICE_MOVE_HERE_ACTION}\n          </button>\n        </span>\n      )}\n    </div>\n  );\n}\n"],"names":["useAthenaChatVoice"],"mappings":"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"}
+{"version":3,"file":"chat-voice-controls.js","sources":["../../src/chat/chat-voice-controls.tsx"],"sourcesContent":["import { useAui } from '@assistant-ui/react';\nimport {\n  describeVoiceLiveElsewhere,\n  playVoiceMoveEarcon,\n  useVoiceElapsed,\n  useVoiceMovedNotice,\n  VOICE_CONTINUE_BY_VOICE_LABEL,\n  VOICE_LIVE_TYPED_HINT,\n  VOICE_MOVE_CALL_HERE_LABEL,\n  VOICE_MOVE_HERE_ACTION,\n} from '@athenaintel/agent-runtime';\nimport {\n  AudioLinesIcon,\n  HeadphonesIcon,\n  Loader2Icon,\n  MicIcon,\n  MicOffIcon,\n  PhoneIcon,\n  XIcon,\n} from 'lucide-react';\nimport { useEffect, useMemo, useRef } from 'react';\nimport { athenaDiagnostics } from '../diagnostics/athena-diagnostics';\nimport { createDeepAgentVoiceLiveKitAdapter } from '../voice/livekit';\nimport {\n  useAthenaChatVoice,\n  type UseAthenaChatVoiceOptions,\n  type UseAthenaChatVoiceReturn,\n} from '../voice/chat';\nimport { useChatVoiceEnabled } from '../voice/use-chat-voice-enabled';\nimport { cn } from '../lib/utils';\nimport { Button } from '../ui/button';\nimport { TooltipIconButton } from './tooltip-icon-button';\nimport { useMentionAuth } from '../chat-ui/mentions/suggestions/data/api-client';\nimport { credentialFingerprint, useCatalogPrincipal } from '../catalog/runtime-catalog';\n\n/**\n * `onCallMoved` replaces the move earcon a call plays when it moves to or\n * from this device (pass a no-op to keep it silent); by default the shared\n * one plays.\n */\nexport interface AthenaChatVoiceOptions\n  extends Pick<UseAthenaChatVoiceOptions, 'model' | 'livekit' | 'onDiagnostic' | 'onCallMoved'> {}\n\n/** One controller for this composer's controls, text sends and audio sink. */\nexport function useComposerChatVoice({ options }: { options: boolean | AthenaChatVoiceOptions }) {\n  const aui = useAui();\n  const auth = useMentionAuth();\n  const principal = useCatalogPrincipal();\n  const enabled = useChatVoiceEnabled({ enabled: options !== false });\n  const audioRef = useRef<HTMLAudioElement | null>(null);\n  const media = useMemo(\n    () => createDeepAgentVoiceLiveKitAdapter({ audioElement: () => audioRef.current }),\n    []\n  );\n  const config = typeof options === 'object' ? options : undefined;\n  const voice = useAthenaChatVoice({\n    transport: 'livekit',\n    livekit: config?.livekit ?? media,\n    model: config?.model,\n    onDiagnostic:\n      config?.onDiagnostic ??\n      ((entry) => athenaDiagnostics.emit('voice.chat', { data: { ...entry } })),\n    onCallMoved: config?.onCallMoved ?? playVoiceMoveEarcon,\n  });\n  const active = voice.phase === 'connecting' || voice.phase === 'live';\n  const { end, syncProfile } = voice;\n  const identity = JSON.stringify([\n    auth.backendUrl,\n    principal,\n    auth.apiKey ? credentialFingerprint({ credential: auth.apiKey }) : null,\n  ]);\n  const previousScope = useRef({ identity, workspaceId: auth.workspaceId });\n  useEffect(() => {\n    const previous = previousScope.current;\n    const changed =\n      previous.identity !== identity ||\n      Boolean(\n        previous.workspaceId && auth.workspaceId && previous.workspaceId !== auth.workspaceId\n      );\n    previousScope.current = {\n      identity,\n      workspaceId:\n        previous.identity === identity\n          ? auth.workspaceId ?? previous.workspaceId\n          : auth.workspaceId,\n    };\n    if (active && (changed || !enabled)) end();\n  }, [identity, auth.workspaceId, active, enabled, end]);\n\n  // Model/agent/toolkit/mode picks live in the ambient model context. Read it\n  // through the controller at send time, with the same debounce as other hosts.\n  const live = voice.phase === 'live';\n  useEffect(() => {\n    if (!live) return;\n    let timer: ReturnType<typeof setTimeout>;\n    const schedule = () => {\n      clearTimeout(timer);\n      timer = setTimeout(syncProfile, 800);\n    };\n    schedule();\n    const unsubscribe = aui.modelContext.subscribe?.(schedule);\n    return () => {\n      clearTimeout(timer);\n      unsubscribe?.();\n    };\n  }, [aui, live, syncProfile]);\n  return { voice, enabled, active, audioRef };\n}\n\nexport function ChatVoiceButton({\n  voice,\n  disabled,\n  disabledReason = null,\n  appearance = 'icon',\n}: {\n  voice: UseAthenaChatVoiceReturn;\n  disabled: boolean;\n  /**\n   * `send`: drawn as the composer's Send (an ink circle with a waveform), where it stands in for Send\n   * while the draft is empty (`AthenaChatComposerSlots.voiceInSend`). `icon` (default): a plain icon.\n   */\n  appearance?: 'icon' | 'send';\n  /**\n   * Why a voice session can't start now (Athena can't be reached): shown as the tooltip of a\n   * control that stays focusable and starts nothing. A session already connecting or live keeps its\n   * Cancel and Mute.\n   */\n  disabledReason?: string | null;\n}) {\n  const live = voice.phase === 'live';\n  const connecting = voice.phase === 'connecting';\n  const unavailable = Boolean(disabledReason) && !live && !connecting;\n  // The conversation's call is live on another of the person's devices.\n  const moveHere = !live && !connecting && voice.liveElsewhere !== null;\n  const label = connecting\n    ? 'Cancel voice connection'\n    : live\n    ? voice.micMuted\n      ? 'Unmute microphone'\n      : 'Mute microphone'\n    : moveHere\n    ? VOICE_MOVE_CALL_HERE_LABEL\n    : 'Start voice session';\n  return (\n    <TooltipIconButton\n      type=\"button\"\n      tooltip={unavailable && disabledReason ? disabledReason : label}\n      aria-label={label}\n      aria-pressed={live && !voice.micMuted}\n      aria-disabled={unavailable || undefined}\n      data-unavailable={unavailable || undefined}\n      {...(appearance === 'send' ? { variant: 'default' as const } : {})}\n      className={cn(\n        'aui-composer-voice size-8 rounded-full p-0 disabled:opacity-30',\n        appearance === 'send' && 'aui-composer-voice-send',\n        unavailable && 'cursor-not-allowed opacity-30 hover:bg-transparent',\n      )}\n      disabled={!unavailable && !live && !connecting && disabled}\n      onClick={() => {\n        if (unavailable) return;\n        if (connecting) voice.end();\n        else if (live) voice.setMicMuted(!voice.micMuted);\n        else if (moveHere) void voice.transferHere();\n        else void voice.start();\n      }}\n    >\n      {connecting ? (\n        <Loader2Icon className=\"size-4 animate-spin\" />\n      ) : live ? (\n        voice.micMuted ? (\n          <MicOffIcon className=\"size-4\" />\n        ) : (\n          <MicIcon className=\"size-4\" />\n        )\n      ) : moveHere ? (\n        <PhoneIcon className=\"size-4\" />\n      ) : appearance === 'send' ? (\n        <AudioLinesIcon className=\"size-4\" />\n      ) : (\n        <HeadphonesIcon className=\"size-4\" />\n      )}\n    </TooltipIconButton>\n  );\n}\n\n/**\n * A host's \"Continue by voice\" offer for the open conversation: a handover the\n * person sent in voice mode landed here. `onDone` runs once they answer it —\n * took it, dismissed it, or typed instead — so the host clears the offer.\n */\nexport interface AthenaChatContinueByVoice {\n  onDone: () => void;\n}\n\n/**\n * The one-tap \"Continue by voice\" above the composer: it starts a call whose\n * model opens by saying where things stand. Shown while voice is idle here and\n * no call is live on another of the person's devices (\"Move here\" covers that).\n * Nothing starts the microphone without the tap.\n */\nexport function ChatVoiceContinueOffer({\n  voice,\n  offer,\n  disabled = false,\n  disabledReason = null,\n}: {\n  voice: UseAthenaChatVoiceReturn;\n  offer: AthenaChatContinueByVoice | null;\n  /** Starting would capture the microphone now (dictation, an upload, no channel). */\n  disabled?: boolean;\n  /** Why voice can't start now (Athena can't be reached), as the action's tooltip. */\n  disabledReason?: string | null;\n}) {\n  if (!offer || voice.phase !== 'idle' || voice.liveElsewhere !== null) return null;\n  return (\n    <div className=\"aui-chat-voice-continue flex items-center gap-1 px-2 pb-2\">\n      <Button\n        type=\"button\"\n        variant=\"outline\"\n        size=\"xs\"\n        title={disabledReason ?? undefined}\n        disabled={disabled || Boolean(disabledReason)}\n        onClick={() => {\n          offer.onDone();\n          void voice.start({ opening: 'recap' });\n        }}\n      >\n        <MicIcon aria-hidden=\"true\" />\n        {VOICE_CONTINUE_BY_VOICE_LABEL}\n      </Button>\n      <TooltipIconButton\n        type=\"button\"\n        tooltip=\"Not now\"\n        aria-label=\"Not now\"\n        className=\"size-6 rounded-md p-0\"\n        onClick={offer.onDone}\n      >\n        <XIcon className=\"size-3\" />\n      </TooltipIconButton>\n    </div>\n  );\n}\n\nexport function ChatVoiceStatus({\n  voice,\n  offerMove = false,\n  moveDisabled = false,\n  moveDisabledReason = null,\n}: {\n  voice: UseAthenaChatVoiceReturn;\n  /** Whether this composer may take a call from another device (its voice is enabled). */\n  offerMove?: boolean;\n  /** Moving the call here would capture the microphone now (dictation, an upload, no channel). */\n  moveDisabled?: boolean;\n  /** Why the call can't move here now (Athena can't be reached), as the action's tooltip. */\n  moveDisabledReason?: string | null;\n}) {\n  const elapsed = useVoiceElapsed(voice.liveSince);\n  const movedNotice = useVoiceMovedNotice(voice.movedTo);\n  const active = voice.phase === 'connecting' || voice.phase === 'live';\n  // \"Live call on your phone · Move here\", or briefly after this composer's call moved away,\n  // \"Call moved to your phone\".\n  const elsewhere = offerMove && !active && movedNotice === null ? voice.liveElsewhere : null;\n  if (!active && !voice.error && !voice.handoffTask && movedNotice === null && elsewhere === null)\n    return null;\n  const moveUnavailable = moveDisabled || Boolean(moveDisabledReason);\n  return (\n    <div className=\"aui-chat-voice-status flex flex-col gap-1 px-2 pb-2 text-xs text-muted-foreground\">\n      {/* No end control of its own: the composer's Stop ends the session\n          (and any run), so there is one way to stop everything. */}\n      {active && (\n        <span role=\"status\">\n          {voice.phase === 'connecting'\n            ? 'Connecting voice…'\n            : `Voice ${voice.micMuted ? 'muted' : 'live'}${elapsed ? ` · ${elapsed}` : ''}`}\n        </span>\n      )}\n      {voice.phase === 'live' && <span>{VOICE_LIVE_TYPED_HINT}</span>}\n      {voice.activeTask && <span>Athena is working: {voice.activeTask.text}</span>}\n      {voice.handoffTask && (\n        <span>Voice ended. Athena is still working: {voice.handoffTask.text}</span>\n      )}\n      {voice.notice && <span role=\"status\">{voice.notice}</span>}\n      {voice.error && (\n        <span role=\"alert\" className=\"text-destructive\">\n          {voice.error}\n        </span>\n      )}\n      {movedNotice !== null && <span role=\"status\">{movedNotice}</span>}\n      {elsewhere !== null && (\n        <span className=\"aui-chat-voice-elsewhere flex items-center gap-1\">\n          <span className=\"min-w-0 truncate\">{describeVoiceLiveElsewhere(elsewhere.surface)}</span>\n          <span aria-hidden=\"true\">·</span>\n          <button\n            type=\"button\"\n            title={moveDisabledReason ?? undefined}\n            disabled={moveUnavailable}\n            onClick={() => void voice.transferHere()}\n            className=\"shrink-0 font-medium text-foreground underline-offset-2 hover:underline disabled:cursor-not-allowed disabled:opacity-50\"\n          >\n            {VOICE_MOVE_HERE_ACTION}\n          </button>\n        </span>\n      )}\n    </div>\n  );\n}\n"],"names":["useAthenaChatVoice"],"mappings":"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"}

package/dist/chat/client-tool-write-consent.cjs

@@ -0,0 +1,122 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require$$0 = require("react");
+const athenaDiagnostics = require("../diagnostics/athena-diagnostics.cjs");
+const errors = require("../diagnostics/errors.cjs");
+function createClientToolWriteConsentStore() {
+  let pending = null;
+  let cards = 0;
+  const granted = /* @__PURE__ */ new Set();
+  const grantKey = (threadId, toolName) => `${threadId}\0${toolName}`;
+  const grantAll = (threadId, toolNames) => {
+    for (const toolName of toolNames) granted.add(grantKey(threadId, toolName));
+  };
+  const listeners = /* @__PURE__ */ new Set();
+  const notify = () => {
+    for (const listener of Array.from(listeners)) listener();
+  };
+  const settle = (decision) => {
+    const settled = pending;
+    pending = null;
+    settled == null ? void 0 : settled.resolve(decision);
+    notify();
+  };
+  return {
+    getPending: () => (pending == null ? void 0 : pending.request) ?? null,
+    subscribe(listener) {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    },
+    isGranted: ({ threadId, toolName }) => granted.has(grantKey(threadId, toolName)),
+    ask(request) {
+      if (request.tools.every((tool) => granted.has(grantKey(request.threadId, tool.name)))) {
+        return Promise.resolve("proceed");
+      }
+      if (pending) settle("abandoned");
+      if (cards === 0) {
+        athenaDiagnostics.athenaDiagnostics.emit("sdk.config.warning", {
+          level: "warn",
+          error: new errors.AthenaSdkError({
+            code: "config_invalid",
+            message: "A frontend tool is waiting for the person to allow it, and nothing on screen asks them.",
+            hint: "Render <AthenaChat> (it draws the question), mount <StatewireClientToolConsentCard>, or pass confirmClientToolWrites on <AthenaProvider>. The run stays parked until the question is answered.",
+            context: { tools: request.tools.map((tool) => tool.name) }
+          }),
+          data: { tools: request.tools.map((tool) => tool.name) }
+        });
+      }
+      return new Promise((resolve) => {
+        pending = { request, resolve };
+        notify();
+      });
+    },
+    answer({ requestId, allow }) {
+      if ((pending == null ? void 0 : pending.request.requestId) !== requestId) return;
+      if (allow) {
+        grantAll(
+          pending.request.threadId,
+          pending.request.tools.map((tool) => tool.name)
+        );
+      }
+      settle(allow ? "proceed" : "declined");
+    },
+    abandon(requestId) {
+      if ((pending == null ? void 0 : pending.request.requestId) !== requestId) return;
+      settle("abandoned");
+    },
+    grant({ threadId, toolNames }) {
+      grantAll(threadId, toolNames);
+    },
+    registerCard() {
+      cards += 1;
+      return () => {
+        cards -= 1;
+      };
+    },
+    dispose() {
+      granted.clear();
+      if (pending) settle("abandoned");
+    }
+  };
+}
+function useClientToolWriteConsentStore(scope) {
+  const [held, setHeld] = require$$0.useState(() => ({ scope, store: createClientToolWriteConsentStore() }));
+  let current = held;
+  if (held.scope !== scope) {
+    current = { scope, store: createClientToolWriteConsentStore() };
+    setHeld(current);
+  }
+  const { store } = current;
+  require$$0.useEffect(() => () => store.dispose(), [store]);
+  return store;
+}
+const ClientToolWriteConsentContext = require$$0.createContext(
+  null
+);
+const NO_SUBSCRIPTION = () => () => {
+};
+const NO_PENDING = () => null;
+function useClientToolWriteConsent() {
+  const store = require$$0.useContext(ClientToolWriteConsentContext);
+  const request = require$$0.useSyncExternalStore(
+    (store == null ? void 0 : store.subscribe) ?? NO_SUBSCRIPTION,
+    (store == null ? void 0 : store.getPending) ?? NO_PENDING,
+    NO_PENDING
+  );
+  require$$0.useEffect(() => store == null ? void 0 : store.registerCard(), [store]);
+  const requestId = request == null ? void 0 : request.requestId;
+  const allow = require$$0.useCallback(() => {
+    if (requestId !== void 0) store == null ? void 0 : store.answer({ requestId, allow: true });
+  }, [requestId, store]);
+  const decline = require$$0.useCallback(() => {
+    if (requestId !== void 0) store == null ? void 0 : store.answer({ requestId, allow: false });
+  }, [requestId, store]);
+  return { request, allow, decline };
+}
+exports.ClientToolWriteConsentContext = ClientToolWriteConsentContext;
+exports.createClientToolWriteConsentStore = createClientToolWriteConsentStore;
+exports.useClientToolWriteConsent = useClientToolWriteConsent;
+exports.useClientToolWriteConsentStore = useClientToolWriteConsentStore;
+//# sourceMappingURL=client-tool-write-consent.cjs.map

package/dist/chat/client-tool-write-consent.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-tool-write-consent.cjs","sources":["../../src/chat/client-tool-write-consent.ts"],"sourcesContent":["'use client';\n\nimport type { ClientToolWriteConsentDecision } from '@athenaintel/agent-runtime';\nimport {\n  createContext,\n  useCallback,\n  useContext,\n  useEffect,\n  useState,\n  useSyncExternalStore,\n} from 'react';\nimport { athenaDiagnostics } from '../diagnostics/athena-diagnostics';\nimport { AthenaSdkError } from '../diagnostics/errors';\n\n/*\n * Write consent for the app's own frontend tools. A tool marked with\n * `requiresWriteConsent` parks its first call in a conversation until the\n * person answers; this store holds that question between the client-tool\n * bridge (which asks) and whatever draws it (`StatewireClientToolConsentCard`\n * in `AthenaChat`, or a host's own card on `useClientToolWriteConsent`).\n *\n * Allowing covers the tools the question named, for the rest of the\n * conversation, for the person who allowed it: a yes to one tool is never a\n * yes to another. A store belongs to one signed-in person on one\n * Athena (`useClientToolWriteConsentStore`), so someone else signing in to the\n * same mounted chat is asked for themselves. Nothing is remembered across a\n * reload: the next call asks again.\n */\n\n/** One write tool of a batch waiting on the person. */\nexport interface ClientToolWriteConsentTool {\n  /** The tool's name, as the model calls it. */\n  name: string;\n  /** What it does, when the tool said (`requiresWriteConsent(…, { summary })`). */\n  summary?: string;\n}\n\n/** The question a parked batch of write calls puts to the person. */\nexport interface ClientToolWriteConsentRequest {\n  /** The parked request the answer resumes. */\n  requestId: string;\n  /** The conversation the answer covers. */\n  threadId: string;\n  /** The batch's write tools, each once. */\n  tools: readonly ClientToolWriteConsentTool[];\n  /** Who is asking, when the host named its agent (`agentUi.agentName`). */\n  agentName?: string;\n}\n\n/**\n * A host's own consent UI (`AthenaProviderProps.confirmClientToolWrites`).\n * Resolve `true` to allow the conversation's writes, `false` to decline this\n * batch. `signal` aborts when the question no longer has a call to answer\n * (the run was stopped): close the dialog then; the value is ignored.\n */\nexport type ClientToolWriteConfirmer = (\n  request: ClientToolWriteConsentRequest & { signal: AbortSignal },\n) => Promise<boolean>;\n\nexport interface ClientToolWriteConsentStore {\n  /** The question on screen, or `null`. */\n  getPending(): ClientToolWriteConsentRequest | null;\n  subscribe(listener: () => void): () => void;\n  /** Whether the person already allowed this tool in this conversation. */\n  isGranted(args: { threadId: string; toolName: string }): boolean;\n  /** Put the question to the person; resolves with their answer, or `abandoned`. */\n  ask(request: ClientToolWriteConsentRequest): Promise<ClientToolWriteConsentDecision>;\n  /** The person's answer to the pending question. */\n  answer(args: { requestId: string; allow: boolean }): void;\n  /** The pending question lost its call (stop, another conversation): close it. */\n  abandon(requestId: string): void;\n  /** Record a consent the host's own UI collected, for the tools it asked about. */\n  grant(args: { threadId: string; toolNames: readonly string[] }): void;\n  /** A mounted card registers itself, so a question nobody can see is reported. */\n  registerCard(): () => void;\n  /** The store's person is gone: close the pending question and forget every yes. */\n  dispose(): void;\n}\n\ninterface PendingConsent {\n  request: ClientToolWriteConsentRequest;\n  resolve: (decision: ClientToolWriteConsentDecision) => void;\n}\n\nexport function createClientToolWriteConsentStore(): ClientToolWriteConsentStore {\n  let pending: PendingConsent | null = null;\n  let cards = 0;\n  const granted = new Set<string>();\n  const grantKey = (threadId: string, toolName: string): string => `${threadId}\\u0000${toolName}`;\n  const grantAll = (threadId: string, toolNames: readonly string[]) => {\n    for (const toolName of toolNames) granted.add(grantKey(threadId, toolName));\n  };\n  const listeners = new Set<() => void>();\n  const notify = () => {\n    for (const listener of Array.from(listeners)) listener();\n  };\n  const settle = (decision: ClientToolWriteConsentDecision) => {\n    const settled = pending;\n    pending = null;\n    settled?.resolve(decision);\n    notify();\n  };\n\n  return {\n    getPending: () => pending?.request ?? null,\n    subscribe(listener) {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n    isGranted: ({ threadId, toolName }) => granted.has(grantKey(threadId, toolName)),\n    ask(request) {\n      if (request.tools.every((tool) => granted.has(grantKey(request.threadId, tool.name)))) {\n        return Promise.resolve('proceed');\n      }\n      // One question at a time: a newer batch replaces a question whose call\n      // the bridge has already given up on.\n      if (pending) settle('abandoned');\n      if (cards === 0) {\n        athenaDiagnostics.emit('sdk.config.warning', {\n          level: 'warn',\n          error: new AthenaSdkError({\n            code: 'config_invalid',\n            message:\n              'A frontend tool is waiting for the person to allow it, and nothing on screen asks them.',\n            hint: 'Render <AthenaChat> (it draws the question), mount <StatewireClientToolConsentCard>, or pass confirmClientToolWrites on <AthenaProvider>. The run stays parked until the question is answered.',\n            context: { tools: request.tools.map((tool) => tool.name) },\n          }),\n          data: { tools: request.tools.map((tool) => tool.name) },\n        });\n      }\n      return new Promise<ClientToolWriteConsentDecision>((resolve) => {\n        pending = { request, resolve };\n        notify();\n      });\n    },\n    answer({ requestId, allow }) {\n      if (pending?.request.requestId !== requestId) return;\n      if (allow) {\n        grantAll(\n          pending.request.threadId,\n          pending.request.tools.map((tool) => tool.name),\n        );\n      }\n      settle(allow ? 'proceed' : 'declined');\n    },\n    abandon(requestId) {\n      if (pending?.request.requestId !== requestId) return;\n      settle('abandoned');\n    },\n    grant({ threadId, toolNames }) {\n      grantAll(threadId, toolNames);\n    },\n    registerCard() {\n      cards += 1;\n      return () => {\n        cards -= 1;\n      };\n    },\n    dispose() {\n      granted.clear();\n      if (pending) settle('abandoned');\n    },\n  };\n}\n\n/**\n * The consent store for one signed-in person on one Athena. `scope` names\n * both (the provider passes the session principal and the sync host): when it\n * changes, the previous person's store is disposed (its question closed, its\n * yeses forgotten) and the next person starts with none.\n */\nexport function useClientToolWriteConsentStore(scope: string): ClientToolWriteConsentStore {\n  const [held, setHeld] = useState(() => ({ scope, store: createClientToolWriteConsentStore() }));\n  let current = held;\n  if (held.scope !== scope) {\n    // Replaced during render, so no commit ever pairs the new person with the\n    // previous person's store.\n    current = { scope, store: createClientToolWriteConsentStore() };\n    setHeld(current);\n  }\n  const { store } = current;\n  useEffect(() => () => store.dispose(), [store]);\n  return store;\n}\n\n/** Provided by `AthenaProvider`; `null` outside one. */\nexport const ClientToolWriteConsentContext = createContext<ClientToolWriteConsentStore | null>(\n  null,\n);\n\nconst NO_SUBSCRIPTION = () => () => {};\nconst NO_PENDING = () => null;\n\nexport interface ClientToolWriteConsent {\n  /** The question waiting on the person, or `null`. */\n  request: ClientToolWriteConsentRequest | null;\n  /** Allow the conversation's writes and run the waiting calls. */\n  allow: () => void;\n  /** Decline the waiting calls; the agent is told, and a later call asks again. */\n  decline: () => void;\n}\n\n/**\n * The write-consent question for the chat the nearest `AthenaProvider` shows,\n * for a host that draws its own card. Calling it marks the question as shown.\n */\nexport function useClientToolWriteConsent(): ClientToolWriteConsent {\n  const store = useContext(ClientToolWriteConsentContext);\n  const request = useSyncExternalStore(\n    store?.subscribe ?? NO_SUBSCRIPTION,\n    store?.getPending ?? NO_PENDING,\n    NO_PENDING,\n  );\n  useEffect(() => store?.registerCard(), [store]);\n  const requestId = request?.requestId;\n  const allow = useCallback(() => {\n    if (requestId !== undefined) store?.answer({ requestId, allow: true });\n  }, [requestId, store]);\n  const decline = useCallback(() => {\n    if (requestId !== undefined) store?.answer({ requestId, allow: false });\n  }, [requestId, store]);\n  return { request, allow, decline };\n}\n"],"names":["athenaDiagnostics","AthenaSdkError","useState","useEffect","createContext","useContext","useSyncExternalStore","useCallback"],"mappings":"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"}

package/dist/chat/client-tool-write-consent.d.ts

@@ -0,0 +1,79 @@
+import type { ClientToolWriteConsentDecision } from '../agent-runtime/src/index';
+/** One write tool of a batch waiting on the person. */
+export interface ClientToolWriteConsentTool {
+    /** The tool's name, as the model calls it. */
+    name: string;
+    /** What it does, when the tool said (`requiresWriteConsent(…, { summary })`). */
+    summary?: string;
+}
+/** The question a parked batch of write calls puts to the person. */
+export interface ClientToolWriteConsentRequest {
+    /** The parked request the answer resumes. */
+    requestId: string;
+    /** The conversation the answer covers. */
+    threadId: string;
+    /** The batch's write tools, each once. */
+    tools: readonly ClientToolWriteConsentTool[];
+    /** Who is asking, when the host named its agent (`agentUi.agentName`). */
+    agentName?: string;
+}
+/**
+ * A host's own consent UI (`AthenaProviderProps.confirmClientToolWrites`).
+ * Resolve `true` to allow the conversation's writes, `false` to decline this
+ * batch. `signal` aborts when the question no longer has a call to answer
+ * (the run was stopped): close the dialog then; the value is ignored.
+ */
+export type ClientToolWriteConfirmer = (request: ClientToolWriteConsentRequest & {
+    signal: AbortSignal;
+}) => Promise<boolean>;
+export interface ClientToolWriteConsentStore {
+    /** The question on screen, or `null`. */
+    getPending(): ClientToolWriteConsentRequest | null;
+    subscribe(listener: () => void): () => void;
+    /** Whether the person already allowed this tool in this conversation. */
+    isGranted(args: {
+        threadId: string;
+        toolName: string;
+    }): boolean;
+    /** Put the question to the person; resolves with their answer, or `abandoned`. */
+    ask(request: ClientToolWriteConsentRequest): Promise<ClientToolWriteConsentDecision>;
+    /** The person's answer to the pending question. */
+    answer(args: {
+        requestId: string;
+        allow: boolean;
+    }): void;
+    /** The pending question lost its call (stop, another conversation): close it. */
+    abandon(requestId: string): void;
+    /** Record a consent the host's own UI collected, for the tools it asked about. */
+    grant(args: {
+        threadId: string;
+        toolNames: readonly string[];
+    }): void;
+    /** A mounted card registers itself, so a question nobody can see is reported. */
+    registerCard(): () => void;
+    /** The store's person is gone: close the pending question and forget every yes. */
+    dispose(): void;
+}
+export declare function createClientToolWriteConsentStore(): ClientToolWriteConsentStore;
+/**
+ * The consent store for one signed-in person on one Athena. `scope` names
+ * both (the provider passes the session principal and the sync host): when it
+ * changes, the previous person's store is disposed (its question closed, its
+ * yeses forgotten) and the next person starts with none.
+ */
+export declare function useClientToolWriteConsentStore(scope: string): ClientToolWriteConsentStore;
+/** Provided by `AthenaProvider`; `null` outside one. */
+export declare const ClientToolWriteConsentContext: import("react").Context<ClientToolWriteConsentStore | null>;
+export interface ClientToolWriteConsent {
+    /** The question waiting on the person, or `null`. */
+    request: ClientToolWriteConsentRequest | null;
+    /** Allow the conversation's writes and run the waiting calls. */
+    allow: () => void;
+    /** Decline the waiting calls; the agent is told, and a later call asks again. */
+    decline: () => void;
+}
+/**
+ * The write-consent question for the chat the nearest `AthenaProvider` shows,
+ * for a host that draws its own card. Calling it marks the question as shown.
+ */
+export declare function useClientToolWriteConsent(): ClientToolWriteConsent;

package/dist/chat/client-tool-write-consent.js

@@ -0,0 +1,122 @@
+import { useContext, useSyncExternalStore, useEffect, useCallback, createContext, useState } from "react";
+import { athenaDiagnostics } from "../diagnostics/athena-diagnostics.js";
+import { AthenaSdkError } from "../diagnostics/errors.js";
+function createClientToolWriteConsentStore() {
+  let pending = null;
+  let cards = 0;
+  const granted = /* @__PURE__ */ new Set();
+  const grantKey = (threadId, toolName) => `${threadId}\0${toolName}`;
+  const grantAll = (threadId, toolNames) => {
+    for (const toolName of toolNames) granted.add(grantKey(threadId, toolName));
+  };
+  const listeners = /* @__PURE__ */ new Set();
+  const notify = () => {
+    for (const listener of Array.from(listeners)) listener();
+  };
+  const settle = (decision) => {
+    const settled = pending;
+    pending = null;
+    settled == null ? void 0 : settled.resolve(decision);
+    notify();
+  };
+  return {
+    getPending: () => (pending == null ? void 0 : pending.request) ?? null,
+    subscribe(listener) {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    },
+    isGranted: ({ threadId, toolName }) => granted.has(grantKey(threadId, toolName)),
+    ask(request) {
+      if (request.tools.every((tool) => granted.has(grantKey(request.threadId, tool.name)))) {
+        return Promise.resolve("proceed");
+      }
+      if (pending) settle("abandoned");
+      if (cards === 0) {
+        athenaDiagnostics.emit("sdk.config.warning", {
+          level: "warn",
+          error: new AthenaSdkError({
+            code: "config_invalid",
+            message: "A frontend tool is waiting for the person to allow it, and nothing on screen asks them.",
+            hint: "Render <AthenaChat> (it draws the question), mount <StatewireClientToolConsentCard>, or pass confirmClientToolWrites on <AthenaProvider>. The run stays parked until the question is answered.",
+            context: { tools: request.tools.map((tool) => tool.name) }
+          }),
+          data: { tools: request.tools.map((tool) => tool.name) }
+        });
+      }
+      return new Promise((resolve) => {
+        pending = { request, resolve };
+        notify();
+      });
+    },
+    answer({ requestId, allow }) {
+      if ((pending == null ? void 0 : pending.request.requestId) !== requestId) return;
+      if (allow) {
+        grantAll(
+          pending.request.threadId,
+          pending.request.tools.map((tool) => tool.name)
+        );
+      }
+      settle(allow ? "proceed" : "declined");
+    },
+    abandon(requestId) {
+      if ((pending == null ? void 0 : pending.request.requestId) !== requestId) return;
+      settle("abandoned");
+    },
+    grant({ threadId, toolNames }) {
+      grantAll(threadId, toolNames);
+    },
+    registerCard() {
+      cards += 1;
+      return () => {
+        cards -= 1;
+      };
+    },
+    dispose() {
+      granted.clear();
+      if (pending) settle("abandoned");
+    }
+  };
+}
+function useClientToolWriteConsentStore(scope) {
+  const [held, setHeld] = useState(() => ({ scope, store: createClientToolWriteConsentStore() }));
+  let current = held;
+  if (held.scope !== scope) {
+    current = { scope, store: createClientToolWriteConsentStore() };
+    setHeld(current);
+  }
+  const { store } = current;
+  useEffect(() => () => store.dispose(), [store]);
+  return store;
+}
+const ClientToolWriteConsentContext = createContext(
+  null
+);
+const NO_SUBSCRIPTION = () => () => {
+};
+const NO_PENDING = () => null;
+function useClientToolWriteConsent() {
+  const store = useContext(ClientToolWriteConsentContext);
+  const request = useSyncExternalStore(
+    (store == null ? void 0 : store.subscribe) ?? NO_SUBSCRIPTION,
+    (store == null ? void 0 : store.getPending) ?? NO_PENDING,
+    NO_PENDING
+  );
+  useEffect(() => store == null ? void 0 : store.registerCard(), [store]);
+  const requestId = request == null ? void 0 : request.requestId;
+  const allow = useCallback(() => {
+    if (requestId !== void 0) store == null ? void 0 : store.answer({ requestId, allow: true });
+  }, [requestId, store]);
+  const decline = useCallback(() => {
+    if (requestId !== void 0) store == null ? void 0 : store.answer({ requestId, allow: false });
+  }, [requestId, store]);
+  return { request, allow, decline };
+}
+export {
+  ClientToolWriteConsentContext,
+  createClientToolWriteConsentStore,
+  useClientToolWriteConsent,
+  useClientToolWriteConsentStore
+};
+//# sourceMappingURL=client-tool-write-consent.js.map

package/dist/chat/client-tool-write-consent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-tool-write-consent.js","sources":["../../src/chat/client-tool-write-consent.ts"],"sourcesContent":["'use client';\n\nimport type { ClientToolWriteConsentDecision } from '@athenaintel/agent-runtime';\nimport {\n  createContext,\n  useCallback,\n  useContext,\n  useEffect,\n  useState,\n  useSyncExternalStore,\n} from 'react';\nimport { athenaDiagnostics } from '../diagnostics/athena-diagnostics';\nimport { AthenaSdkError } from '../diagnostics/errors';\n\n/*\n * Write consent for the app's own frontend tools. A tool marked with\n * `requiresWriteConsent` parks its first call in a conversation until the\n * person answers; this store holds that question between the client-tool\n * bridge (which asks) and whatever draws it (`StatewireClientToolConsentCard`\n * in `AthenaChat`, or a host's own card on `useClientToolWriteConsent`).\n *\n * Allowing covers the tools the question named, for the rest of the\n * conversation, for the person who allowed it: a yes to one tool is never a\n * yes to another. A store belongs to one signed-in person on one\n * Athena (`useClientToolWriteConsentStore`), so someone else signing in to the\n * same mounted chat is asked for themselves. Nothing is remembered across a\n * reload: the next call asks again.\n */\n\n/** One write tool of a batch waiting on the person. */\nexport interface ClientToolWriteConsentTool {\n  /** The tool's name, as the model calls it. */\n  name: string;\n  /** What it does, when the tool said (`requiresWriteConsent(…, { summary })`). */\n  summary?: string;\n}\n\n/** The question a parked batch of write calls puts to the person. */\nexport interface ClientToolWriteConsentRequest {\n  /** The parked request the answer resumes. */\n  requestId: string;\n  /** The conversation the answer covers. */\n  threadId: string;\n  /** The batch's write tools, each once. */\n  tools: readonly ClientToolWriteConsentTool[];\n  /** Who is asking, when the host named its agent (`agentUi.agentName`). */\n  agentName?: string;\n}\n\n/**\n * A host's own consent UI (`AthenaProviderProps.confirmClientToolWrites`).\n * Resolve `true` to allow the conversation's writes, `false` to decline this\n * batch. `signal` aborts when the question no longer has a call to answer\n * (the run was stopped): close the dialog then; the value is ignored.\n */\nexport type ClientToolWriteConfirmer = (\n  request: ClientToolWriteConsentRequest & { signal: AbortSignal },\n) => Promise<boolean>;\n\nexport interface ClientToolWriteConsentStore {\n  /** The question on screen, or `null`. */\n  getPending(): ClientToolWriteConsentRequest | null;\n  subscribe(listener: () => void): () => void;\n  /** Whether the person already allowed this tool in this conversation. */\n  isGranted(args: { threadId: string; toolName: string }): boolean;\n  /** Put the question to the person; resolves with their answer, or `abandoned`. */\n  ask(request: ClientToolWriteConsentRequest): Promise<ClientToolWriteConsentDecision>;\n  /** The person's answer to the pending question. */\n  answer(args: { requestId: string; allow: boolean }): void;\n  /** The pending question lost its call (stop, another conversation): close it. */\n  abandon(requestId: string): void;\n  /** Record a consent the host's own UI collected, for the tools it asked about. */\n  grant(args: { threadId: string; toolNames: readonly string[] }): void;\n  /** A mounted card registers itself, so a question nobody can see is reported. */\n  registerCard(): () => void;\n  /** The store's person is gone: close the pending question and forget every yes. */\n  dispose(): void;\n}\n\ninterface PendingConsent {\n  request: ClientToolWriteConsentRequest;\n  resolve: (decision: ClientToolWriteConsentDecision) => void;\n}\n\nexport function createClientToolWriteConsentStore(): ClientToolWriteConsentStore {\n  let pending: PendingConsent | null = null;\n  let cards = 0;\n  const granted = new Set<string>();\n  const grantKey = (threadId: string, toolName: string): string => `${threadId}\\u0000${toolName}`;\n  const grantAll = (threadId: string, toolNames: readonly string[]) => {\n    for (const toolName of toolNames) granted.add(grantKey(threadId, toolName));\n  };\n  const listeners = new Set<() => void>();\n  const notify = () => {\n    for (const listener of Array.from(listeners)) listener();\n  };\n  const settle = (decision: ClientToolWriteConsentDecision) => {\n    const settled = pending;\n    pending = null;\n    settled?.resolve(decision);\n    notify();\n  };\n\n  return {\n    getPending: () => pending?.request ?? null,\n    subscribe(listener) {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n    isGranted: ({ threadId, toolName }) => granted.has(grantKey(threadId, toolName)),\n    ask(request) {\n      if (request.tools.every((tool) => granted.has(grantKey(request.threadId, tool.name)))) {\n        return Promise.resolve('proceed');\n      }\n      // One question at a time: a newer batch replaces a question whose call\n      // the bridge has already given up on.\n      if (pending) settle('abandoned');\n      if (cards === 0) {\n        athenaDiagnostics.emit('sdk.config.warning', {\n          level: 'warn',\n          error: new AthenaSdkError({\n            code: 'config_invalid',\n            message:\n              'A frontend tool is waiting for the person to allow it, and nothing on screen asks them.',\n            hint: 'Render <AthenaChat> (it draws the question), mount <StatewireClientToolConsentCard>, or pass confirmClientToolWrites on <AthenaProvider>. The run stays parked until the question is answered.',\n            context: { tools: request.tools.map((tool) => tool.name) },\n          }),\n          data: { tools: request.tools.map((tool) => tool.name) },\n        });\n      }\n      return new Promise<ClientToolWriteConsentDecision>((resolve) => {\n        pending = { request, resolve };\n        notify();\n      });\n    },\n    answer({ requestId, allow }) {\n      if (pending?.request.requestId !== requestId) return;\n      if (allow) {\n        grantAll(\n          pending.request.threadId,\n          pending.request.tools.map((tool) => tool.name),\n        );\n      }\n      settle(allow ? 'proceed' : 'declined');\n    },\n    abandon(requestId) {\n      if (pending?.request.requestId !== requestId) return;\n      settle('abandoned');\n    },\n    grant({ threadId, toolNames }) {\n      grantAll(threadId, toolNames);\n    },\n    registerCard() {\n      cards += 1;\n      return () => {\n        cards -= 1;\n      };\n    },\n    dispose() {\n      granted.clear();\n      if (pending) settle('abandoned');\n    },\n  };\n}\n\n/**\n * The consent store for one signed-in person on one Athena. `scope` names\n * both (the provider passes the session principal and the sync host): when it\n * changes, the previous person's store is disposed (its question closed, its\n * yeses forgotten) and the next person starts with none.\n */\nexport function useClientToolWriteConsentStore(scope: string): ClientToolWriteConsentStore {\n  const [held, setHeld] = useState(() => ({ scope, store: createClientToolWriteConsentStore() }));\n  let current = held;\n  if (held.scope !== scope) {\n    // Replaced during render, so no commit ever pairs the new person with the\n    // previous person's store.\n    current = { scope, store: createClientToolWriteConsentStore() };\n    setHeld(current);\n  }\n  const { store } = current;\n  useEffect(() => () => store.dispose(), [store]);\n  return store;\n}\n\n/** Provided by `AthenaProvider`; `null` outside one. */\nexport const ClientToolWriteConsentContext = createContext<ClientToolWriteConsentStore | null>(\n  null,\n);\n\nconst NO_SUBSCRIPTION = () => () => {};\nconst NO_PENDING = () => null;\n\nexport interface ClientToolWriteConsent {\n  /** The question waiting on the person, or `null`. */\n  request: ClientToolWriteConsentRequest | null;\n  /** Allow the conversation's writes and run the waiting calls. */\n  allow: () => void;\n  /** Decline the waiting calls; the agent is told, and a later call asks again. */\n  decline: () => void;\n}\n\n/**\n * The write-consent question for the chat the nearest `AthenaProvider` shows,\n * for a host that draws its own card. Calling it marks the question as shown.\n */\nexport function useClientToolWriteConsent(): ClientToolWriteConsent {\n  const store = useContext(ClientToolWriteConsentContext);\n  const request = useSyncExternalStore(\n    store?.subscribe ?? NO_SUBSCRIPTION,\n    store?.getPending ?? NO_PENDING,\n    NO_PENDING,\n  );\n  useEffect(() => store?.registerCard(), [store]);\n  const requestId = request?.requestId;\n  const allow = useCallback(() => {\n    if (requestId !== undefined) store?.answer({ requestId, allow: true });\n  }, [requestId, store]);\n  const decline = useCallback(() => {\n    if (requestId !== undefined) store?.answer({ requestId, allow: false });\n  }, [requestId, store]);\n  return { request, allow, decline };\n}\n"],"names":[],"mappings":"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"}

package/dist/chat/statewire-client-tools.cjs

@@ -3,6 +3,28 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const athenaDiagnostics = require("../diagnostics/athena-diagnostics.cjs");
 const assistantStream = require("assistant-stream");
 const clientTools = require("../agent-runtime/src/client-tools.cjs");
+const CLIENT_TOOL_WRITE_CONSENT = Symbol.for("athena.clientTool.writeConsent");
+function requiresWriteConsent(tool, options = {}) {
+  var _a;
+  const summary = (_a = options.summary) == null ? void 0 : _a.trim();
+  return { ...tool, [CLIENT_TOOL_WRITE_CONSENT]: summary ? { summary } : {} };
+}
+function clientToolWriteConsent(entry) {
+  if (!entry || typeof entry !== "object") return null;
+  const mark = entry[CLIENT_TOOL_WRITE_CONSENT];
+  if (!mark || typeof mark !== "object") return null;
+  const summary = mark.summary;
+  return typeof summary === "string" && summary ? { summary } : {};
+}
+function clientToolWriteConsentSummaries(toolkit) {
+  var _a;
+  const summaries = {};
+  for (const [name, entry] of Object.entries(toolkit ?? {})) {
+    const summary = (_a = clientToolWriteConsent(entry)) == null ? void 0 : _a.summary;
+    if (summary) summaries[name] = summary;
+  }
+  return summaries;
+}
 function hasCallableExecute(entry) {
   return !!entry && typeof entry === "object" && typeof entry.execute === "function";
 }
@@ -32,15 +54,15 @@ function collectStatewireClientTools(toolkit) {
           name,
           description: entry.description ?? "",
           parameters,
-          requiresWrite: false
+          requiresWrite: clientToolWriteConsent(entry) !== null
         },
         handler: async (args, context) => {
-          const controller = new AbortController();
           const output = await execute(args, {
-            // The bridge always supplies the parked call's id; a host invoking
-            // the handler directly has no call to correlate.
+            // The bridge always supplies the parked call's id and its signal,
+            // which aborts when the call's request goes away (the run was
+            // stopped); a host invoking the handler directly has neither.
             toolCallId: (context == null ? void 0 : context.toolCallId) ?? "",
-            abortSignal: controller.signal,
+            abortSignal: (context == null ? void 0 : context.signal) ?? new AbortController().signal,
             human: () => Promise.reject(
               new Error("Human input is not supported for statewire client tools.")
             )
@@ -73,7 +95,10 @@ function resolveClientToolSurface(appId) {
 }
 exports.CLIENT_TOOL_SURFACE_APP_IDS = CLIENT_TOOL_SURFACE_APP_IDS;
 exports.backendDeclaredFrontendToolIds = backendDeclaredFrontendToolIds;
+exports.clientToolWriteConsent = clientToolWriteConsent;
+exports.clientToolWriteConsentSummaries = clientToolWriteConsentSummaries;
 exports.collectStatewireClientTools = collectStatewireClientTools;
+exports.requiresWriteConsent = requiresWriteConsent;
 exports.resolveClientToolSurface = resolveClientToolSurface;
 exports.statewireClientToolWireEntries = statewireClientToolWireEntries;
 //# sourceMappingURL=statewire-client-tools.cjs.map

package/dist/chat/statewire-client-tools.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"statewire-client-tools.cjs","sources":["../../src/chat/statewire-client-tools.ts"],"sourcesContent":["import { athenaDiagnostics } from '../diagnostics/athena-diagnostics';\nimport type { Toolkit } from '@assistant-ui/react';\nimport {\n  type ClientToolHandlerContext,\n  clientToolRunConfigEntries,\n  type RegisteredClientTool,\n} from '@athenaintel/agent-runtime';\nimport { ToolResponse, toJSONSchema } from 'assistant-stream';\n\n/**\n * @deprecated The SDK's client tools ARE the shared `RegisteredClientTool`\n * shape from `@athenaintel/agent-runtime` (`definition` + `handler`); import\n * that type instead. Retained for one release so existing imports type-check.\n */\nexport type StatewireClientTool = RegisteredClientTool;\n\nfunction hasCallableExecute(\n  entry: unknown,\n): entry is { execute: (args: Record<string, unknown>, context: unknown) => unknown } {\n  return (\n    !!entry &&\n    typeof entry === 'object' &&\n    typeof (entry as { execute?: unknown }).execute === 'function'\n  );\n}\n\n/**\n * Collect the client-executable tools from a frontend toolkit, in the shared\n * `RegisteredClientTool` shape every statewire surface declares and executes.\n *\n * The deep-agent runtime drops frontend (`ui_*`) tool definitions, so tools\n * with a local `execute` must instead be declared through\n * `runConfig.custom.client_tools` and answered by the statewire client-tool\n * bridge. Schema conversion reuses `toJSONSchema` — the same conversion\n * primitive as the legacy assistant-transport — and a tool whose schema cannot\n * be converted is skipped with a warning rather than failing the whole set.\n * SDK tools never gate on write consent (`requiresWrite: false`): a toolkit\n * `execute` is the host app's own code.\n */\nexport function collectStatewireClientTools(toolkit: Toolkit): RegisteredClientTool[] {\n  const executable = Object.entries(toolkit).filter(([, entry]) => hasCallableExecute(entry));\n  if (executable.length === 0) return [];\n\n  return executable.flatMap(([name, entry]) => {\n    if (entry.parameters === undefined) return [];\n\n    let parameters: Record<string, unknown>;\n    try {\n      parameters = { ...toJSONSchema(entry.parameters) };\n    } catch (error) {\n      athenaDiagnostics.emit('tools.schema.warning', {\n        level: 'warn',\n        data: {\n          tool: name,\n          message: 'Frontend tool schema could not be converted for statewire; the tool is not registered',\n          error: error instanceof Error ? error.message : String(error),\n        },\n      });\n      return [];\n    }\n\n    const execute = (entry as {\n      execute: (args: Record<string, unknown>, context: unknown) => unknown;\n    }).execute;\n    return [\n      {\n        definition: {\n          name,\n          description: entry.description ?? '',\n          parameters,\n          requiresWrite: false,\n        },\n        handler: async (args, context?: ClientToolHandlerContext) => {\n          const controller = new AbortController();\n          const output = await execute(args, {\n            // The bridge always supplies the parked call's id; a host invoking\n            // the handler directly has no call to correlate.\n            toolCallId: context?.toolCallId ?? '',\n            abortSignal: controller.signal,\n            human: () =>\n              Promise.reject(\n                new Error('Human input is not supported for statewire client tools.'),\n              ),\n          });\n          return output instanceof ToolResponse ? output.result : output;\n        },\n      },\n    ];\n  });\n}\n\n/** Wire entries for `runConfig.custom.client_tools` — the shared contract from\n *  `@athenaintel/agent-runtime`, so the SDK cannot drift from the other surfaces. */\nexport function statewireClientToolWireEntries(\n  tools: readonly RegisteredClientTool[],\n): Record<string, unknown>[] {\n  return clientToolRunConfigEntries(tools);\n}\n\n/**\n * The frontend-toolkit entries that must ride `enabled_tools`: declarations\n * WITHOUT a local `execute`, which name registry tools the backend already\n * knows how to bind (Olympus's frontend-executed tool ids).\n *\n * Executable entries are deliberately left out. They are declared through\n * `client_tools`, and the run binds them by name; putting the same name into\n * `enabled_tools` would also switch on any backend toolkit that happens to\n * own a tool of that name, and the backend wins the resulting collision —\n * the client tool is dropped and the model calls the backend one instead.\n */\nexport function backendDeclaredFrontendToolIds(toolkit: Toolkit): string[] {\n  return Object.entries(toolkit)\n    .filter(([, entry]) => !hasCallableExecute(entry))\n    .map(([name]) => name);\n}\n\n/**\n * The `app_id` values the deep-agent runtime accepts as a client-tool surface.\n * Mirrors `agora/agora/graphs/athena_deep_agent/client_tools.py`: the fixed\n * first-party ids plus the `computer_asset_<uuid>` shape Athena's provisioning\n * injects into a computer-asset app. Any other `app_id` (or none) gets no\n * surface, and the runtime drops every `client_tools` declaration for the run.\n */\nexport const CLIENT_TOOL_SURFACE_APP_IDS = {\n  olympus: 'olympus',\n  officeAddin: 'athena-office-addin',\n  mobile: 'athena-mobile',\n} as const;\n\nconst SDK_APP_ID_PATTERN = /^computer_asset_[0-9a-f-]{8,64}$/;\n\nexport type ClientToolSurface = 'web' | 'office' | 'mobile' | 'sdk';\n\n/** The surface an `app_id` selects, or null when the runtime would refuse it. */\nexport function resolveClientToolSurface(appId: string | undefined | null): ClientToolSurface | null {\n  if (typeof appId !== 'string' || appId.length === 0) return null;\n  if (appId === CLIENT_TOOL_SURFACE_APP_IDS.olympus) return 'web';\n  if (appId === CLIENT_TOOL_SURFACE_APP_IDS.officeAddin) return 'office';\n  if (appId === CLIENT_TOOL_SURFACE_APP_IDS.mobile) return 'mobile';\n  if (SDK_APP_ID_PATTERN.test(appId)) return 'sdk';\n  return null;\n}\n"],"names":["toJSONSchema","athenaDiagnostics","ToolResponse","clientToolRunConfigEntries"],"mappings":";;;;;AAgBA,SAAS,mBACP,OACoF;AACpF,SACE,CAAC,CAAC,SACF,OAAO,UAAU,YACjB,OAAQ,MAAgC,YAAY;AAExD;AAeO,SAAS,4BAA4B,SAA0C;AACpF,QAAM,aAAa,OAAO,QAAQ,OAAO,EAAE,OAAO,CAAC,GAAG,KAAK,MAAM,mBAAmB,KAAK,CAAC;AAC1F,MAAI,WAAW,WAAW,EAAG,QAAO,CAAA;AAEpC,SAAO,WAAW,QAAQ,CAAC,CAAC,MAAM,KAAK,MAAM;AAC3C,QAAI,MAAM,eAAe,OAAW,QAAO,CAAA;AAE3C,QAAI;AACJ,QAAI;AACF,mBAAa,EAAE,GAAGA,gBAAAA,aAAa,MAAM,UAAU,EAAA;AAAA,IACjD,SAAS,OAAO;AACdC,wBAAAA,kBAAkB,KAAK,wBAAwB;AAAA,QAC7C,OAAO;AAAA,QACP,MAAM;AAAA,UACJ,MAAM;AAAA,UACN,SAAS;AAAA,UACT,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,QAAA;AAAA,MAC9D,CACD;AACD,aAAO,CAAA;AAAA,IACT;AAEA,UAAM,UAAW,MAEd;AACH,WAAO;AAAA,MACL;AAAA,QACE,YAAY;AAAA,UACV;AAAA,UACA,aAAa,MAAM,eAAe;AAAA,UAClC;AAAA,UACA,eAAe;AAAA,QAAA;AAAA,QAEjB,SAAS,OAAO,MAAM,YAAuC;AAC3D,gBAAM,aAAa,IAAI,gBAAA;AACvB,gBAAM,SAAS,MAAM,QAAQ,MAAM;AAAA;AAAA;AAAA,YAGjC,aAAY,mCAAS,eAAc;AAAA,YACnC,aAAa,WAAW;AAAA,YACxB,OAAO,MACL,QAAQ;AAAA,cACN,IAAI,MAAM,0DAA0D;AAAA,YAAA;AAAA,UACtE,CACH;AACD,iBAAO,kBAAkBC,gBAAAA,eAAe,OAAO,SAAS;AAAA,QAC1D;AAAA,MAAA;AAAA,IACF;AAAA,EAEJ,CAAC;AACH;AAIO,SAAS,+BACd,OAC2B;AAC3B,SAAOC,YAAAA,2BAA2B,KAAK;AACzC;AAaO,SAAS,+BAA+B,SAA4B;AACzE,SAAO,OAAO,QAAQ,OAAO,EAC1B,OAAO,CAAC,CAAA,EAAG,KAAK,MAAM,CAAC,mBAAmB,KAAK,CAAC,EAChD,IAAI,CAAC,CAAC,IAAI,MAAM,IAAI;AACzB;AASO,MAAM,8BAA8B;AAAA,EACzC,SAAS;AAAA,EACT,aAAa;AAAA,EACb,QAAQ;AACV;AAEA,MAAM,qBAAqB;AAKpB,SAAS,yBAAyB,OAA4D;AACnG,MAAI,OAAO,UAAU,YAAY,MAAM,WAAW,EAAG,QAAO;AAC5D,MAAI,UAAU,4BAA4B,QAAS,QAAO;AAC1D,MAAI,UAAU,4BAA4B,YAAa,QAAO;AAC9D,MAAI,UAAU,4BAA4B,OAAQ,QAAO;AACzD,MAAI,mBAAmB,KAAK,KAAK,EAAG,QAAO;AAC3C,SAAO;AACT;;;;;;"}
+{"version":3,"file":"statewire-client-tools.cjs","sources":["../../src/chat/statewire-client-tools.ts"],"sourcesContent":["import { athenaDiagnostics } from '../diagnostics/athena-diagnostics';\nimport type { Toolkit } from '@assistant-ui/react';\nimport {\n  type ClientToolHandlerContext,\n  clientToolRunConfigEntries,\n  type RegisteredClientTool,\n} from '@athenaintel/agent-runtime';\nimport { ToolResponse, toJSONSchema } from 'assistant-stream';\n\n/**\n * @deprecated The SDK's client tools ARE the shared `RegisteredClientTool`\n * shape from `@athenaintel/agent-runtime` (`definition` + `handler`); import\n * that type instead. Retained for one release so existing imports type-check.\n */\nexport type StatewireClientTool = RegisteredClientTool;\n\n/**\n * Marks a frontend tool as one that changes something for the person, so its\n * calls wait for their consent. Set by {@link requiresWriteConsent}. A\n * registered symbol (not a module-local one), so the mark is read by whichever\n * copy of the SDK collects the toolkit.\n */\nconst CLIENT_TOOL_WRITE_CONSENT = Symbol.for('athena.clientTool.writeConsent');\n\nexport interface ClientToolWriteConsentOptions {\n  /**\n   * What the tool does, as the rest of the sentence \"… wants to ___\" on the\n   * consent card (e.g. `\"click and type on this page\"`). The card names the\n   * tool when this is absent.\n   */\n  summary?: string;\n}\n\n/**\n * Mark a `frontendTools` entry as a write: the person is asked before its\n * first call in a conversation runs, the answer covers the rest of that\n * conversation, and a declined call answers the model with an error instead\n * of running. Unmarked tools run without asking, as before.\n *\n * ```ts\n * const frontendTools = {\n *   save_note: requiresWriteConsent(\n *     { description: '…', parameters, execute: saveNote },\n *     { summary: 'save a note on this record' },\n *   ),\n * };\n * ```\n *\n * The mark also travels to Athena (`requires_write`), which then never\n * answers the call on the person's behalf while their tab is away.\n */\nexport function requiresWriteConsent<T extends object>(\n  tool: T,\n  options: ClientToolWriteConsentOptions = {},\n): T {\n  const summary = options.summary?.trim();\n  return { ...tool, [CLIENT_TOOL_WRITE_CONSENT]: summary ? { summary } : {} };\n}\n\n/** The consent mark on a toolkit entry, or `null` for a tool that never asks. */\nexport function clientToolWriteConsent(entry: unknown): ClientToolWriteConsentOptions | null {\n  if (!entry || typeof entry !== 'object') return null;\n  const mark = (entry as Record<symbol, unknown>)[CLIENT_TOOL_WRITE_CONSENT];\n  if (!mark || typeof mark !== 'object') return null;\n  const summary = (mark as { summary?: unknown }).summary;\n  return typeof summary === 'string' && summary ? { summary } : {};\n}\n\n/** Each consent-marked tool's own words for what it does, by tool name. */\nexport function clientToolWriteConsentSummaries(\n  toolkit: Toolkit | undefined,\n): Readonly<Record<string, string>> {\n  const summaries: Record<string, string> = {};\n  for (const [name, entry] of Object.entries(toolkit ?? {})) {\n    const summary = clientToolWriteConsent(entry)?.summary;\n    if (summary) summaries[name] = summary;\n  }\n  return summaries;\n}\n\nfunction hasCallableExecute(\n  entry: unknown,\n): entry is { execute: (args: Record<string, unknown>, context: unknown) => unknown } {\n  return (\n    !!entry &&\n    typeof entry === 'object' &&\n    typeof (entry as { execute?: unknown }).execute === 'function'\n  );\n}\n\n/**\n * Collect the client-executable tools from a frontend toolkit, in the shared\n * `RegisteredClientTool` shape every statewire surface declares and executes.\n *\n * The deep-agent runtime drops frontend (`ui_*`) tool definitions, so tools\n * with a local `execute` must instead be declared through\n * `runConfig.custom.client_tools` and answered by the statewire client-tool\n * bridge. Schema conversion reuses `toJSONSchema` — the same conversion\n * primitive as the legacy assistant-transport — and a tool whose schema cannot\n * be converted is skipped with a warning rather than failing the whole set.\n * A tool gates on write consent only when its entry is marked with\n * `requiresWriteConsent`: an unmarked toolkit `execute` is the host app's own\n * code and runs without asking.\n */\nexport function collectStatewireClientTools(toolkit: Toolkit): RegisteredClientTool[] {\n  const executable = Object.entries(toolkit).filter(([, entry]) => hasCallableExecute(entry));\n  if (executable.length === 0) return [];\n\n  return executable.flatMap(([name, entry]) => {\n    if (entry.parameters === undefined) return [];\n\n    let parameters: Record<string, unknown>;\n    try {\n      parameters = { ...toJSONSchema(entry.parameters) };\n    } catch (error) {\n      athenaDiagnostics.emit('tools.schema.warning', {\n        level: 'warn',\n        data: {\n          tool: name,\n          message: 'Frontend tool schema could not be converted for statewire; the tool is not registered',\n          error: error instanceof Error ? error.message : String(error),\n        },\n      });\n      return [];\n    }\n\n    const execute = (entry as {\n      execute: (args: Record<string, unknown>, context: unknown) => unknown;\n    }).execute;\n    return [\n      {\n        definition: {\n          name,\n          description: entry.description ?? '',\n          parameters,\n          requiresWrite: clientToolWriteConsent(entry) !== null,\n        },\n        handler: async (args, context?: ClientToolHandlerContext) => {\n          const output = await execute(args, {\n            // The bridge always supplies the parked call's id and its signal,\n            // which aborts when the call's request goes away (the run was\n            // stopped); a host invoking the handler directly has neither.\n            toolCallId: context?.toolCallId ?? '',\n            abortSignal: context?.signal ?? new AbortController().signal,\n            human: () =>\n              Promise.reject(\n                new Error('Human input is not supported for statewire client tools.'),\n              ),\n          });\n          return output instanceof ToolResponse ? output.result : output;\n        },\n      },\n    ];\n  });\n}\n\n/** Wire entries for `runConfig.custom.client_tools` — the shared contract from\n *  `@athenaintel/agent-runtime`, so the SDK cannot drift from the other surfaces. */\nexport function statewireClientToolWireEntries(\n  tools: readonly RegisteredClientTool[],\n): Record<string, unknown>[] {\n  return clientToolRunConfigEntries(tools);\n}\n\n/**\n * The frontend-toolkit entries that must ride `enabled_tools`: declarations\n * WITHOUT a local `execute`, which name registry tools the backend already\n * knows how to bind (Olympus's frontend-executed tool ids).\n *\n * Executable entries are deliberately left out. They are declared through\n * `client_tools`, and the run binds them by name; putting the same name into\n * `enabled_tools` would also switch on any backend toolkit that happens to\n * own a tool of that name, and the backend wins the resulting collision —\n * the client tool is dropped and the model calls the backend one instead.\n */\nexport function backendDeclaredFrontendToolIds(toolkit: Toolkit): string[] {\n  return Object.entries(toolkit)\n    .filter(([, entry]) => !hasCallableExecute(entry))\n    .map(([name]) => name);\n}\n\n/**\n * The `app_id` values the deep-agent runtime accepts as a client-tool surface.\n * Mirrors `agora/agora/graphs/athena_deep_agent/client_tools.py`: the fixed\n * first-party ids plus the `computer_asset_<uuid>` shape Athena's provisioning\n * injects into a computer-asset app. Any other `app_id` (or none) gets no\n * surface, and the runtime drops every `client_tools` declaration for the run.\n */\nexport const CLIENT_TOOL_SURFACE_APP_IDS = {\n  olympus: 'olympus',\n  officeAddin: 'athena-office-addin',\n  mobile: 'athena-mobile',\n} as const;\n\nconst SDK_APP_ID_PATTERN = /^computer_asset_[0-9a-f-]{8,64}$/;\n\nexport type ClientToolSurface = 'web' | 'office' | 'mobile' | 'sdk';\n\n/** The surface an `app_id` selects, or null when the runtime would refuse it. */\nexport function resolveClientToolSurface(appId: string | undefined | null): ClientToolSurface | null {\n  if (typeof appId !== 'string' || appId.length === 0) return null;\n  if (appId === CLIENT_TOOL_SURFACE_APP_IDS.olympus) return 'web';\n  if (appId === CLIENT_TOOL_SURFACE_APP_IDS.officeAddin) return 'office';\n  if (appId === CLIENT_TOOL_SURFACE_APP_IDS.mobile) return 'mobile';\n  if (SDK_APP_ID_PATTERN.test(appId)) return 'sdk';\n  return null;\n}\n"],"names":["toJSONSchema","athenaDiagnostics","ToolResponse","clientToolRunConfigEntries"],"mappings":"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"}