@athenaintel/react 0.60.1 → 0.61.0

package/dist/agent-ui/use-agent-target.js

@@ -0,0 +1,63 @@
+import { useRef, useEffect, useMemo } from "react";
+import { agentTargetRef, registerAgentTargetHandlers, agentTarget } from "./contract.js";
+const HANDLER_KINDS = ["click", "type", "select", "toggle", "clear", "options", "value"];
+function useAgentTarget({ handlers, ...options }) {
+  var _a;
+  const ref = agentTargetRef({ id: options.id, key: options.key });
+  const latest = useRef(handlers);
+  latest.current = handlers;
+  const kinds = HANDLER_KINDS.filter((kind) => (handlers == null ? void 0 : handlers[kind]) !== void 0).join(" ");
+  useEffect(() => {
+    if (!kinds) return;
+    const has = new Set(kinds.split(" "));
+    const registered = {
+      ...has.has("click") ? { click: () => {
+        var _a2, _b;
+        return (_b = (_a2 = latest.current) == null ? void 0 : _a2.click) == null ? void 0 : _b.call(_a2);
+      } } : {},
+      ...has.has("type") ? { type: (args) => {
+        var _a2, _b;
+        return (_b = (_a2 = latest.current) == null ? void 0 : _a2.type) == null ? void 0 : _b.call(_a2, args);
+      } } : {},
+      ...has.has("select") ? { select: (args) => {
+        var _a2, _b;
+        return (_b = (_a2 = latest.current) == null ? void 0 : _a2.select) == null ? void 0 : _b.call(_a2, args);
+      } } : {},
+      ...has.has("toggle") ? { toggle: (args) => {
+        var _a2, _b;
+        return (_b = (_a2 = latest.current) == null ? void 0 : _a2.toggle) == null ? void 0 : _b.call(_a2, args);
+      } } : {},
+      ...has.has("clear") ? { clear: () => {
+        var _a2, _b;
+        return (_b = (_a2 = latest.current) == null ? void 0 : _a2.clear) == null ? void 0 : _b.call(_a2);
+      } } : {},
+      ...has.has("options") ? { options: () => {
+        var _a2, _b;
+        return ((_b = (_a2 = latest.current) == null ? void 0 : _a2.options) == null ? void 0 : _b.call(_a2)) ?? [];
+      } } : {},
+      ...has.has("value") ? { value: () => {
+        var _a2, _b;
+        return ((_b = (_a2 = latest.current) == null ? void 0 : _a2.value) == null ? void 0 : _b.call(_a2)) ?? null;
+      } } : {}
+    };
+    return registerAgentTargetHandlers({ ref, handlers: registered });
+  }, [ref, kinds]);
+  const { id, key, label, description, danger, sensitive } = options;
+  const actions = (_a = options.actions) == null ? void 0 : _a.join(" ");
+  return useMemo(
+    () => agentTarget({
+      id,
+      key,
+      label,
+      description,
+      danger,
+      sensitive,
+      ...actions === void 0 ? {} : { actions: actions.split(" ").filter(Boolean) }
+    }),
+    [id, key, label, description, actions, danger, sensitive]
+  );
+}
+export {
+  useAgentTarget
+};
+//# sourceMappingURL=use-agent-target.js.map

package/dist/agent-ui/use-agent-target.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-agent-target.js","sources":["../../src/agent-ui/use-agent-target.ts"],"sourcesContent":["'use client';\n\nimport { useEffect, useMemo, useRef } from 'react';\nimport {\n  type AgentTargetHandlers,\n  type AgentTargetOptions,\n  type AgentTargetProps,\n  agentTarget,\n  agentTargetRef,\n  registerAgentTargetHandlers,\n} from './contract';\n\nexport interface UseAgentTargetOptions extends AgentTargetOptions {\n  /**\n   * What the target does when ordinary clicks and typing cannot drive it (a\n   * custom select, a date picker). Each handler replaces the tool's own input\n   * for that action and allows the action.\n   */\n  handlers?: AgentTargetHandlers;\n}\n\nconst HANDLER_KINDS = ['click', 'type', 'select', 'toggle', 'clear', 'options', 'value'] as const;\n\n/**\n * Make an element an agent target, with types. Spread the returned props on\n * the element:\n *\n * ```tsx\n * const stage = useAgentTarget({\n *   id: 'filters.stage',\n *   label: 'Stage',\n *   description: 'Narrows the table to firms that invest at this stage.',\n *   handlers: { select: ({ option }) => setStage(option), options: () => STAGES, value: () => stage },\n * });\n * return <StagePicker {...stage} />;\n * ```\n *\n * Without `handlers` this is `agentTarget(options)`: use that directly inside\n * a loop, where a hook cannot go.\n */\nexport function useAgentTarget({ handlers, ...options }: UseAgentTargetOptions): AgentTargetProps {\n  const ref = agentTargetRef({ id: options.id, key: options.key });\n  const latest = useRef(handlers);\n  latest.current = handlers;\n  const kinds = HANDLER_KINDS.filter((kind) => handlers?.[kind] !== undefined).join(' ');\n\n  // Registered once per set of handler kinds; each call reads the newest\n  // closure, so a re-render never re-registers.\n  useEffect(() => {\n    if (!kinds) return;\n    const has = new Set(kinds.split(' '));\n    const registered: AgentTargetHandlers = {\n      ...(has.has('click') ? { click: () => latest.current?.click?.() } : {}),\n      ...(has.has('type') ? { type: (args) => latest.current?.type?.(args) } : {}),\n      ...(has.has('select') ? { select: (args) => latest.current?.select?.(args) } : {}),\n      ...(has.has('toggle') ? { toggle: (args) => latest.current?.toggle?.(args) } : {}),\n      ...(has.has('clear') ? { clear: () => latest.current?.clear?.() } : {}),\n      ...(has.has('options') ? { options: () => latest.current?.options?.() ?? [] } : {}),\n      ...(has.has('value') ? { value: () => latest.current?.value?.() ?? null } : {}),\n    };\n    return registerAgentTargetHandlers({ ref, handlers: registered });\n  }, [ref, kinds]);\n\n  const { id, key, label, description, danger, sensitive } = options;\n  const actions = options.actions?.join(' ');\n  return useMemo(\n    () =>\n      agentTarget({\n        id,\n        key,\n        label,\n        description,\n        danger,\n        sensitive,\n        ...(actions === undefined\n          ? {}\n          : { actions: actions.split(' ').filter(Boolean) as AgentTargetOptions['actions'] }),\n      }),\n    [id, key, label, description, actions, danger, sensitive],\n  );\n}\n"],"names":["_a"],"mappings":";;AAqBA,MAAM,gBAAgB,CAAC,SAAS,QAAQ,UAAU,UAAU,SAAS,WAAW,OAAO;AAmBhF,SAAS,eAAe,EAAE,UAAU,GAAG,WAAoD;;AAChG,QAAM,MAAM,eAAe,EAAE,IAAI,QAAQ,IAAI,KAAK,QAAQ,KAAK;AAC/D,QAAM,SAAS,OAAO,QAAQ;AAC9B,SAAO,UAAU;AACjB,QAAM,QAAQ,cAAc,OAAO,CAAC,UAAS,qCAAW,WAAU,MAAS,EAAE,KAAK,GAAG;AAIrF,YAAU,MAAM;AACd,QAAI,CAAC,MAAO;AACZ,UAAM,MAAM,IAAI,IAAI,MAAM,MAAM,GAAG,CAAC;AACpC,UAAM,aAAkC;AAAA,MACtC,GAAI,IAAI,IAAI,OAAO,IAAI,EAAE,OAAO,MAAA;;AAAM,sBAAAA,MAAA,OAAO,YAAP,gBAAAA,IAAgB,UAAhB,wBAAAA;AAAA,QAAwB,IAAM,CAAA;AAAA,MACpE,GAAI,IAAI,IAAI,MAAM,IAAI,EAAE,MAAM,CAAC,SAAA;;AAAS,sBAAAA,MAAA,OAAO,YAAP,gBAAAA,IAAgB,SAAhB,wBAAAA,KAAuB;AAAA,QAAI,IAAM,CAAA;AAAA,MACzE,GAAI,IAAI,IAAI,QAAQ,IAAI,EAAE,QAAQ,CAAC,SAAA;;AAAS,sBAAAA,MAAA,OAAO,YAAP,gBAAAA,IAAgB,WAAhB,wBAAAA,KAAyB;AAAA,QAAI,IAAM,CAAA;AAAA,MAC/E,GAAI,IAAI,IAAI,QAAQ,IAAI,EAAE,QAAQ,CAAC,SAAA;;AAAS,sBAAAA,MAAA,OAAO,YAAP,gBAAAA,IAAgB,WAAhB,wBAAAA,KAAyB;AAAA,QAAI,IAAM,CAAA;AAAA,MAC/E,GAAI,IAAI,IAAI,OAAO,IAAI,EAAE,OAAO,MAAA;;AAAM,sBAAAA,MAAA,OAAO,YAAP,gBAAAA,IAAgB,UAAhB,wBAAAA;AAAA,QAAwB,IAAM,CAAA;AAAA,MACpE,GAAI,IAAI,IAAI,SAAS,IAAI,EAAE,SAAS;;AAAM,uBAAAA,MAAA,OAAO,YAAP,gBAAAA,IAAgB,YAAhB,wBAAAA,SAA+B,CAAA;AAAA,QAAC,IAAM,CAAA;AAAA,MAChF,GAAI,IAAI,IAAI,OAAO,IAAI,EAAE,OAAO,MAAA;;AAAM,uBAAAA,MAAA,OAAO,YAAP,gBAAAA,IAAgB,UAAhB,wBAAAA,SAA6B;AAAA,QAAA,IAAS,CAAA;AAAA,IAAC;AAE/E,WAAO,4BAA4B,EAAE,KAAK,UAAU,YAAY;AAAA,EAClE,GAAG,CAAC,KAAK,KAAK,CAAC;AAEf,QAAM,EAAE,IAAI,KAAK,OAAO,aAAa,QAAQ,cAAc;AAC3D,QAAM,WAAU,aAAQ,YAAR,mBAAiB,KAAK;AACtC,SAAO;AAAA,IACL,MACE,YAAY;AAAA,MACV;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,GAAI,YAAY,SACZ,CAAA,IACA,EAAE,SAAS,QAAQ,MAAM,GAAG,EAAE,OAAO,OAAO,EAAA;AAAA,IAAmC,CACpF;AAAA,IACH,CAAC,IAAI,KAAK,OAAO,aAAa,SAAS,QAAQ,SAAS;AAAA,EAAA;AAE5D;"}

package/dist/agent-ui/use-agent-ui.cjs

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require$$0 = require("react");
+const tools = require("./tools.cjs");
+function useAgentUi(options = {}) {
+  const [agentUi] = require$$0.useState(() => tools.createAgentUi(options));
+  agentUi.setOptions(options);
+  const acting = options.allowActing !== false;
+  const routes = options.navigate ? options.routes ?? [] : [];
+  const routesKey = routes.map((route) => [route.id, route.label, route.description ?? ""].join("\0")).join("
");
+  const tools$1 = require$$0.useMemo(() => agentUi.tools(), [agentUi, acting, routesKey]);
+  return { agentUi, tools: tools$1 };
+}
+exports.useAgentUi = useAgentUi;
+//# sourceMappingURL=use-agent-ui.cjs.map

package/dist/agent-ui/use-agent-ui.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-agent-ui.cjs","sources":["../../src/agent-ui/use-agent-ui.ts"],"sourcesContent":["'use client';\n\nimport { useMemo, useState } from 'react';\nimport { type AgentUi, type AgentUiOptions, type AgentUiTool, createAgentUi } from './tools';\n\nexport interface UseAgentUi {\n  /** The controller: pass it to `AgentUiLayer`. */\n  agentUi: AgentUi;\n  /** The tools to hand `frontendTools`. The same object until the set of tools changes. */\n  tools: Record<string, AgentUiTool>;\n}\n\n/**\n * The agent's tools for the screen the person has open, for a host that wires\n * them itself:\n *\n * ```tsx\n * const { agentUi, tools } = useAgentUi({ agentName: 'Jichard' });\n * return (\n *   <AthenaProvider frontendTools={{ ...tools, ...myTools }}>\n *     <App />\n *     <AgentUiLayer agentUi={agentUi} />\n *   </AthenaProvider>\n * );\n * ```\n *\n * `<AthenaProvider agentUi>` does the same in one prop.\n */\nexport function useAgentUi(options: AgentUiOptions = {}): UseAgentUi {\n  const [agentUi] = useState(() => createAgentUi(options));\n  // The tools run outside render and read the options when called.\n  agentUi.setOptions(options);\n\n  const acting = options.allowActing !== false;\n  const routes = options.navigate ? (options.routes ?? []) : [];\n  const routesKey = routes\n    .map((route) => [route.id, route.label, route.description ?? ''].join('\\u0000'))\n    .join('\\u0001');\n  // The tool list is declared to Athena with every message: it changes only\n  // when a tool comes or goes, or the pages `go_to` names do.\n  // biome-ignore lint/correctness/useExhaustiveDependencies: the keys stand for the options the tools are built from\n  const tools = useMemo(() => agentUi.tools(), [agentUi, acting, routesKey]);\n  return { agentUi, tools };\n}\n"],"names":["useState","createAgentUi","tools","useMemo"],"mappings":";;;;AA4BO,SAAS,WAAW,UAA0B,IAAgB;AACnE,QAAM,CAAC,OAAO,IAAIA,WAAAA,SAAS,MAAMC,MAAAA,cAAc,OAAO,CAAC;AAEvD,UAAQ,WAAW,OAAO;AAE1B,QAAM,SAAS,QAAQ,gBAAgB;AACvC,QAAM,SAAS,QAAQ,WAAY,QAAQ,UAAU,CAAA,IAAM,CAAA;AAC3D,QAAM,YAAY,OACf,IAAI,CAAC,UAAU,CAAC,MAAM,IAAI,MAAM,OAAO,MAAM,eAAe,EAAE,EAAE,KAAK,IAAQ,CAAC,EAC9E,KAAK,GAAQ;AAIhB,QAAMC,UAAQC,mBAAQ,MAAM,QAAQ,MAAA,GAAS,CAAC,SAAS,QAAQ,SAAS,CAAC;AACzE,SAAO,EAAE,gBAASD,QAAA;AACpB;;"}

package/dist/agent-ui/use-agent-ui.d.ts

@@ -0,0 +1,24 @@
+import { type AgentUi, type AgentUiOptions, type AgentUiTool } from './tools';
+export interface UseAgentUi {
+    /** The controller: pass it to `AgentUiLayer`. */
+    agentUi: AgentUi;
+    /** The tools to hand `frontendTools`. The same object until the set of tools changes. */
+    tools: Record<string, AgentUiTool>;
+}
+/**
+ * The agent's tools for the screen the person has open, for a host that wires
+ * them itself:
+ *
+ * ```tsx
+ * const { agentUi, tools } = useAgentUi({ agentName: 'Jichard' });
+ * return (
+ *   <AthenaProvider frontendTools={{ ...tools, ...myTools }}>
+ *     <App />
+ *     <AgentUiLayer agentUi={agentUi} />
+ *   </AthenaProvider>
+ * );
+ * ```
+ *
+ * `<AthenaProvider agentUi>` does the same in one prop.
+ */
+export declare function useAgentUi(options?: AgentUiOptions): UseAgentUi;

package/dist/agent-ui/use-agent-ui.js

@@ -0,0 +1,15 @@
+import { useState, useMemo } from "react";
+import { createAgentUi } from "./tools.js";
+function useAgentUi(options = {}) {
+  const [agentUi] = useState(() => createAgentUi(options));
+  agentUi.setOptions(options);
+  const acting = options.allowActing !== false;
+  const routes = options.navigate ? options.routes ?? [] : [];
+  const routesKey = routes.map((route) => [route.id, route.label, route.description ?? ""].join("\0")).join("
");
+  const tools = useMemo(() => agentUi.tools(), [agentUi, acting, routesKey]);
+  return { agentUi, tools };
+}
+export {
+  useAgentUi
+};
+//# sourceMappingURL=use-agent-ui.js.map

package/dist/agent-ui/use-agent-ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-agent-ui.js","sources":["../../src/agent-ui/use-agent-ui.ts"],"sourcesContent":["'use client';\n\nimport { useMemo, useState } from 'react';\nimport { type AgentUi, type AgentUiOptions, type AgentUiTool, createAgentUi } from './tools';\n\nexport interface UseAgentUi {\n  /** The controller: pass it to `AgentUiLayer`. */\n  agentUi: AgentUi;\n  /** The tools to hand `frontendTools`. The same object until the set of tools changes. */\n  tools: Record<string, AgentUiTool>;\n}\n\n/**\n * The agent's tools for the screen the person has open, for a host that wires\n * them itself:\n *\n * ```tsx\n * const { agentUi, tools } = useAgentUi({ agentName: 'Jichard' });\n * return (\n *   <AthenaProvider frontendTools={{ ...tools, ...myTools }}>\n *     <App />\n *     <AgentUiLayer agentUi={agentUi} />\n *   </AthenaProvider>\n * );\n * ```\n *\n * `<AthenaProvider agentUi>` does the same in one prop.\n */\nexport function useAgentUi(options: AgentUiOptions = {}): UseAgentUi {\n  const [agentUi] = useState(() => createAgentUi(options));\n  // The tools run outside render and read the options when called.\n  agentUi.setOptions(options);\n\n  const acting = options.allowActing !== false;\n  const routes = options.navigate ? (options.routes ?? []) : [];\n  const routesKey = routes\n    .map((route) => [route.id, route.label, route.description ?? ''].join('\\u0000'))\n    .join('\\u0001');\n  // The tool list is declared to Athena with every message: it changes only\n  // when a tool comes or goes, or the pages `go_to` names do.\n  // biome-ignore lint/correctness/useExhaustiveDependencies: the keys stand for the options the tools are built from\n  const tools = useMemo(() => agentUi.tools(), [agentUi, acting, routesKey]);\n  return { agentUi, tools };\n}\n"],"names":[],"mappings":";;AA4BO,SAAS,WAAW,UAA0B,IAAgB;AACnE,QAAM,CAAC,OAAO,IAAI,SAAS,MAAM,cAAc,OAAO,CAAC;AAEvD,UAAQ,WAAW,OAAO;AAE1B,QAAM,SAAS,QAAQ,gBAAgB;AACvC,QAAM,SAAS,QAAQ,WAAY,QAAQ,UAAU,CAAA,IAAM,CAAA;AAC3D,QAAM,YAAY,OACf,IAAI,CAAC,UAAU,CAAC,MAAM,IAAI,MAAM,OAAO,MAAM,eAAe,EAAE,EAAE,KAAK,IAAQ,CAAC,EAC9E,KAAK,GAAQ;AAIhB,QAAM,QAAQ,QAAQ,MAAM,QAAQ,MAAA,GAAS,CAAC,SAAS,QAAQ,SAAS,CAAC;AACzE,SAAO,EAAE,SAAS,MAAA;AACpB;"}

package/dist/chat/AthenaChat.cjs

@@ -183,6 +183,7 @@ const AthenaChatContent = ({
   className,
   welcomeMessage = "Hello there!",
   welcomeSubtext = "What can I help you with?",
+  welcomeContent,
   maxWidth = "46rem",
   turnAnchor = "bottom",
   readOnly = false,
@@ -350,7 +351,7 @@ const AthenaChatContent = ({
         /* @__PURE__ */ jsxRuntime.jsx(handoffCursor.HandoffCursorReveal, { threadId: statewireThreadId }),
         /* @__PURE__ */ jsxRuntime.jsx(ThreadScrollToTop, {})
       ] }),
-      welcome: /* @__PURE__ */ jsxRuntime.jsx(athenaChatWelcome.AthenaChatWelcome, { welcomeMessage, welcomeSubtext }),
+      welcome: welcomeContent ?? /* @__PURE__ */ jsxRuntime.jsx(athenaChatWelcome.AthenaChatWelcome, { welcomeMessage, welcomeSubtext }),
       beforeMessages: /* @__PURE__ */ jsxRuntime.jsx(statewireHistoryEdge.StatewireHistoryEdge, { className: "aui-thread-history-edge" }),
       components: messageComponents$1,
       runningIndicator: null,
@@ -599,6 +600,10 @@ const AthenaChatComposer = ({
   const hasExtras = attachments.length > 0 || quote !== null;
   const sendStateRef = require$$0.useRef({ isRunning, liveVoice: false });
   sendStateRef.current = { isRunning, liveVoice: voice.phase === "live" && !hasExtras };
+  const voiceDisabled = isUploading || dictationCtl.isActive || !statewireLifecycle.isStatewireChannelLive(connection);
+  const voiceCallIdle = voice.phase !== "live" && voice.phase !== "connecting";
+  const voiceMerged = (slots == null ? void 0 : slots.voiceInSend) === true && voiceEnabled && voiceCallIdle;
+  const voiceAsSend = voiceMerged && !hasText && !hasExtras && !isRunning;
   const onBeforeSend = slots == null ? void 0 : slots.onBeforeSend;
   const beforeSubmit = require$$0.useCallback(
     async ({ text }) => {
@@ -931,15 +936,23 @@ const AthenaChatComposer = ({
                     disabledReason: needsConnectionReason
                   }
                 ),
-                voiceEnabled && /* @__PURE__ */ jsxRuntime.jsx(
+                voiceEnabled && !voiceMerged && /* @__PURE__ */ jsxRuntime.jsx(
                   chatVoiceControls.ChatVoiceButton,
                   {
                     voice,
-                    disabled: isUploading || dictationCtl.isActive || !statewireLifecycle.isStatewireChannelLive(connection),
+                    disabled: voiceDisabled,
                     disabledReason: needsConnectionReason
                   }
                 ),
-                /* @__PURE__ */ jsxRuntime.jsx(
+                voiceAsSend ? /* @__PURE__ */ jsxRuntime.jsx(
+                  chatVoiceControls.ChatVoiceButton,
+                  {
+                    voice,
+                    appearance: "send",
+                    disabled: voiceDisabled,
+                    disabledReason: needsConnectionReason
+                  }
+                ) : /* @__PURE__ */ jsxRuntime.jsx(
                   composerSendOrStop.ComposerSendOrStop,
                   {
                     composerRef,