@athenaintel/react 0.57.1 → 0.59.0

package/dist/threads/use-athena-thread-agent.cjs

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require$$0 = require("react");
+const agentModelOptions = require("../catalog/agent-model-options.cjs");
+const statewireServerLaneContext = require("../runtime/statewire-server-lane-context.cjs");
+function threadAgentFromLane({
+  lane,
+  ready
+}) {
+  if (!ready || lane === null) return { agentId: null, configured: false, ready };
+  const value = lane.custom.collab_agent_id;
+  return {
+    agentId: typeof value === "string" ? agentModelOptions.agentAssetIdOf(value) : null,
+    configured: true,
+    ready
+  };
+}
+function useAthenaThreadAgent() {
+  const lane = require$$0.useContext(statewireServerLaneContext.AthenaStatewireServerLaneContext);
+  const agent = require$$0.useMemo(
+    () => lane === null ? null : threadAgentFromLane({ lane: lane.config, ready: lane.landed }),
+    [lane]
+  );
+  if (agent === null) {
+    throw new Error("[AthenaSDK] useAthenaThreadAgent must be used within <AthenaProvider>");
+  }
+  return agent;
+}
+exports.threadAgentFromLane = threadAgentFromLane;
+exports.useAthenaThreadAgent = useAthenaThreadAgent;
+//# sourceMappingURL=use-athena-thread-agent.cjs.map

package/dist/threads/use-athena-thread-agent.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-athena-thread-agent.cjs","sources":["../../src/threads/use-athena-thread-agent.ts"],"sourcesContent":["import type { DeepAgentServerConfig } from '@athenaintel/agent-runtime';\nimport { useContext, useMemo } from 'react';\nimport { agentAssetIdOf } from '../catalog/agent-model-options';\nimport { AthenaStatewireServerLaneContext } from '../runtime/statewire-server-lane-context';\n\n/**\n * The collab agent a thread runs as, read from its server config lane\n * (`state.config.custom.collab_agent_id`), plus whether there is a lane at all.\n */\nexport interface AthenaThreadAgent {\n  /**\n   * The collab agent's asset id, or `null` when the lane names none: the thread is the person's\n   * own Athena assistant's.\n   */\n  agentId: string | null;\n  /** `true` once the thread has a server config lane (version > 0). */\n  configured: boolean;\n  /**\n   * `true` once the statewire host's snapshot of this thread has arrived. Before that `agentId` is\n   * `null` and `configured` is `false` whatever the thread holds, so wait for `ready` before\n   * treating \"no agent\" as an answer.\n   */\n  ready: boolean;\n}\n\n/** {@link AthenaThreadAgent} from the lane and the landed flag. Pure. */\nexport function threadAgentFromLane({\n  lane,\n  ready,\n}: {\n  lane: DeepAgentServerConfig | null;\n  ready: boolean;\n}): AthenaThreadAgent {\n  if (!ready || lane === null) return { agentId: null, configured: false, ready };\n  const value = lane.custom.collab_agent_id;\n  return {\n    agentId: typeof value === 'string' ? agentAssetIdOf(value) : null,\n    configured: true,\n    ready,\n  };\n}\n\n/**\n * The collab agent the active thread runs as, from the thread's config lane as the statewire host\n * sent it.\n *\n * `collab_agent_id` is a key the lane owns: once a thread has run, every turn runs as the agent\n * the lane names, whatever the provider's `agent` prop says (the prop seeds a new thread's lane on\n * its first send and is dropped from later sends). Read this hook to show an open thread's real\n * agent: `{ agentId: null, configured: true }` is a thread of the person's own assistant. Wait for\n * `ready`; a never-started chat stays not ready until its first send attaches it.\n *\n * Must be used within `<AthenaProvider>`.\n */\nexport function useAthenaThreadAgent(): AthenaThreadAgent {\n  const lane = useContext(AthenaStatewireServerLaneContext);\n  const agent = useMemo(\n    () => (lane === null ? null : threadAgentFromLane({ lane: lane.config, ready: lane.landed })),\n    [lane],\n  );\n  if (agent === null) {\n    throw new Error('[AthenaSDK] useAthenaThreadAgent must be used within <AthenaProvider>');\n  }\n  return agent;\n}\n"],"names":["agentAssetIdOf","useContext","AthenaStatewireServerLaneContext","useMemo"],"mappings":";;;;;AA0BO,SAAS,oBAAoB;AAAA,EAClC;AAAA,EACA;AACF,GAGsB;AACpB,MAAI,CAAC,SAAS,SAAS,KAAM,QAAO,EAAE,SAAS,MAAM,YAAY,OAAO,MAAA;AACxE,QAAM,QAAQ,KAAK,OAAO;AAC1B,SAAO;AAAA,IACL,SAAS,OAAO,UAAU,WAAWA,kBAAAA,eAAe,KAAK,IAAI;AAAA,IAC7D,YAAY;AAAA,IACZ;AAAA,EAAA;AAEJ;AAcO,SAAS,uBAA0C;AACxD,QAAM,OAAOC,WAAAA,WAAWC,2DAAgC;AACxD,QAAM,QAAQC,WAAAA;AAAAA,IACZ,MAAO,SAAS,OAAO,OAAO,oBAAoB,EAAE,MAAM,KAAK,QAAQ,OAAO,KAAK,OAAA,CAAQ;AAAA,IAC3F,CAAC,IAAI;AAAA,EAAA;AAEP,MAAI,UAAU,MAAM;AAClB,UAAM,IAAI,MAAM,uEAAuE;AAAA,EACzF;AACA,SAAO;AACT;;;"}

package/dist/threads/use-athena-thread-agent.d.ts

@@ -0,0 +1,38 @@
+import type { DeepAgentServerConfig } from '../agent-runtime/src/index';
+/**
+ * The collab agent a thread runs as, read from its server config lane
+ * (`state.config.custom.collab_agent_id`), plus whether there is a lane at all.
+ */
+export interface AthenaThreadAgent {
+    /**
+     * The collab agent's asset id, or `null` when the lane names none: the thread is the person's
+     * own Athena assistant's.
+     */
+    agentId: string | null;
+    /** `true` once the thread has a server config lane (version > 0). */
+    configured: boolean;
+    /**
+     * `true` once the statewire host's snapshot of this thread has arrived. Before that `agentId` is
+     * `null` and `configured` is `false` whatever the thread holds, so wait for `ready` before
+     * treating "no agent" as an answer.
+     */
+    ready: boolean;
+}
+/** {@link AthenaThreadAgent} from the lane and the landed flag. Pure. */
+export declare function threadAgentFromLane({ lane, ready, }: {
+    lane: DeepAgentServerConfig | null;
+    ready: boolean;
+}): AthenaThreadAgent;
+/**
+ * The collab agent the active thread runs as, from the thread's config lane as the statewire host
+ * sent it.
+ *
+ * `collab_agent_id` is a key the lane owns: once a thread has run, every turn runs as the agent
+ * the lane names, whatever the provider's `agent` prop says (the prop seeds a new thread's lane on
+ * its first send and is dropped from later sends). Read this hook to show an open thread's real
+ * agent: `{ agentId: null, configured: true }` is a thread of the person's own assistant. Wait for
+ * `ready`; a never-started chat stays not ready until its first send attaches it.
+ *
+ * Must be used within `<AthenaProvider>`.
+ */
+export declare function useAthenaThreadAgent(): AthenaThreadAgent;

package/dist/threads/use-athena-thread-agent.js

@@ -0,0 +1,31 @@
+import { useContext, useMemo } from "react";
+import { agentAssetIdOf } from "../catalog/agent-model-options.js";
+import { AthenaStatewireServerLaneContext } from "../runtime/statewire-server-lane-context.js";
+function threadAgentFromLane({
+  lane,
+  ready
+}) {
+  if (!ready || lane === null) return { agentId: null, configured: false, ready };
+  const value = lane.custom.collab_agent_id;
+  return {
+    agentId: typeof value === "string" ? agentAssetIdOf(value) : null,
+    configured: true,
+    ready
+  };
+}
+function useAthenaThreadAgent() {
+  const lane = useContext(AthenaStatewireServerLaneContext);
+  const agent = useMemo(
+    () => lane === null ? null : threadAgentFromLane({ lane: lane.config, ready: lane.landed }),
+    [lane]
+  );
+  if (agent === null) {
+    throw new Error("[AthenaSDK] useAthenaThreadAgent must be used within <AthenaProvider>");
+  }
+  return agent;
+}
+export {
+  threadAgentFromLane,
+  useAthenaThreadAgent
+};
+//# sourceMappingURL=use-athena-thread-agent.js.map

package/dist/threads/use-athena-thread-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-athena-thread-agent.js","sources":["../../src/threads/use-athena-thread-agent.ts"],"sourcesContent":["import type { DeepAgentServerConfig } from '@athenaintel/agent-runtime';\nimport { useContext, useMemo } from 'react';\nimport { agentAssetIdOf } from '../catalog/agent-model-options';\nimport { AthenaStatewireServerLaneContext } from '../runtime/statewire-server-lane-context';\n\n/**\n * The collab agent a thread runs as, read from its server config lane\n * (`state.config.custom.collab_agent_id`), plus whether there is a lane at all.\n */\nexport interface AthenaThreadAgent {\n  /**\n   * The collab agent's asset id, or `null` when the lane names none: the thread is the person's\n   * own Athena assistant's.\n   */\n  agentId: string | null;\n  /** `true` once the thread has a server config lane (version > 0). */\n  configured: boolean;\n  /**\n   * `true` once the statewire host's snapshot of this thread has arrived. Before that `agentId` is\n   * `null` and `configured` is `false` whatever the thread holds, so wait for `ready` before\n   * treating \"no agent\" as an answer.\n   */\n  ready: boolean;\n}\n\n/** {@link AthenaThreadAgent} from the lane and the landed flag. Pure. */\nexport function threadAgentFromLane({\n  lane,\n  ready,\n}: {\n  lane: DeepAgentServerConfig | null;\n  ready: boolean;\n}): AthenaThreadAgent {\n  if (!ready || lane === null) return { agentId: null, configured: false, ready };\n  const value = lane.custom.collab_agent_id;\n  return {\n    agentId: typeof value === 'string' ? agentAssetIdOf(value) : null,\n    configured: true,\n    ready,\n  };\n}\n\n/**\n * The collab agent the active thread runs as, from the thread's config lane as the statewire host\n * sent it.\n *\n * `collab_agent_id` is a key the lane owns: once a thread has run, every turn runs as the agent\n * the lane names, whatever the provider's `agent` prop says (the prop seeds a new thread's lane on\n * its first send and is dropped from later sends). Read this hook to show an open thread's real\n * agent: `{ agentId: null, configured: true }` is a thread of the person's own assistant. Wait for\n * `ready`; a never-started chat stays not ready until its first send attaches it.\n *\n * Must be used within `<AthenaProvider>`.\n */\nexport function useAthenaThreadAgent(): AthenaThreadAgent {\n  const lane = useContext(AthenaStatewireServerLaneContext);\n  const agent = useMemo(\n    () => (lane === null ? null : threadAgentFromLane({ lane: lane.config, ready: lane.landed })),\n    [lane],\n  );\n  if (agent === null) {\n    throw new Error('[AthenaSDK] useAthenaThreadAgent must be used within <AthenaProvider>');\n  }\n  return agent;\n}\n"],"names":[],"mappings":";;;AA0BO,SAAS,oBAAoB;AAAA,EAClC;AAAA,EACA;AACF,GAGsB;AACpB,MAAI,CAAC,SAAS,SAAS,KAAM,QAAO,EAAE,SAAS,MAAM,YAAY,OAAO,MAAA;AACxE,QAAM,QAAQ,KAAK,OAAO;AAC1B,SAAO;AAAA,IACL,SAAS,OAAO,UAAU,WAAW,eAAe,KAAK,IAAI;AAAA,IAC7D,YAAY;AAAA,IACZ;AAAA,EAAA;AAEJ;AAcO,SAAS,uBAA0C;AACxD,QAAM,OAAO,WAAW,gCAAgC;AACxD,QAAM,QAAQ;AAAA,IACZ,MAAO,SAAS,OAAO,OAAO,oBAAoB,EAAE,MAAM,KAAK,QAAQ,OAAO,KAAK,OAAA,CAAQ;AAAA,IAC3F,CAAC,IAAI;AAAA,EAAA;AAEP,MAAI,UAAU,MAAM;AAClB,UAAM,IAAI,MAAM,uEAAuE;AAAA,EACzF;AACA,SAAO;AACT;"}

package/dist/threads/use-athena-thread-plan-mode.cjs

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require$$0 = require("react");
+const statewirePlanMode = require("../runtime/statewire-plan-mode.cjs");
+const statewireServerLaneContext = require("../runtime/statewire-server-lane-context.cjs");
+function useAthenaThreadPlanMode() {
+  const lane = require$$0.useContext(statewireServerLaneContext.AthenaStatewireServerLaneContext);
+  const planMode = require$$0.useMemo(
+    () => lane === null ? null : statewirePlanMode.threadPlanModeFromLane({ lane: lane.config, ready: lane.landed }),
+    [lane]
+  );
+  if (planMode === null) {
+    throw new Error("[AthenaSDK] useAthenaThreadPlanMode must be used within <AthenaProvider>");
+  }
+  return planMode;
+}
+exports.useAthenaThreadPlanMode = useAthenaThreadPlanMode;
+//# sourceMappingURL=use-athena-thread-plan-mode.cjs.map

package/dist/threads/use-athena-thread-plan-mode.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-athena-thread-plan-mode.cjs","sources":["../../src/threads/use-athena-thread-plan-mode.ts"],"sourcesContent":["import { useContext, useMemo } from 'react';\nimport { type AthenaThreadPlanMode, threadPlanModeFromLane } from '../runtime/statewire-plan-mode';\nimport { AthenaStatewireServerLaneContext } from '../runtime/statewire-server-lane-context';\n\nexport type { AthenaThreadPlanMode };\n\n/**\n * Whether the active thread's server config plans: the agent's to-do plan\n * (`write_todos`) is on unless the thread's config lane excludes it, as the\n * statewire host sent the lane.\n *\n * Once a thread has run with server config, its lane (not the provider's\n * `planMode` prop) decides, and another client (Athena on the web, a second\n * app) can change it at any time. Read this hook when a thread opens to show\n * the thread's own plan mode in a switch: `{ planMode: null, configured: false }`\n * is a thread without server config, whose turns run with what the provider\n * sends. Wait for `ready`: until the host's snapshot of the thread has arrived\n * every thread reads as unconfigured.\n *\n * Must be used within `<AthenaProvider>`.\n */\nexport function useAthenaThreadPlanMode(): AthenaThreadPlanMode {\n  const lane = useContext(AthenaStatewireServerLaneContext);\n  const planMode = useMemo(\n    () => (lane === null ? null : threadPlanModeFromLane({ lane: lane.config, ready: lane.landed })),\n    [lane],\n  );\n  if (planMode === null) {\n    throw new Error('[AthenaSDK] useAthenaThreadPlanMode must be used within <AthenaProvider>');\n  }\n  return planMode;\n}\n"],"names":["useContext","AthenaStatewireServerLaneContext","useMemo","threadPlanModeFromLane"],"mappings":";;;;;AAqBO,SAAS,0BAAgD;AAC9D,QAAM,OAAOA,WAAAA,WAAWC,2DAAgC;AACxD,QAAM,WAAWC,WAAAA;AAAAA,IACf,MAAO,SAAS,OAAO,OAAOC,kBAAAA,uBAAuB,EAAE,MAAM,KAAK,QAAQ,OAAO,KAAK,OAAA,CAAQ;AAAA,IAC9F,CAAC,IAAI;AAAA,EAAA;AAEP,MAAI,aAAa,MAAM;AACrB,UAAM,IAAI,MAAM,0EAA0E;AAAA,EAC5F;AACA,SAAO;AACT;;"}

package/dist/threads/use-athena-thread-plan-mode.d.ts

@@ -0,0 +1,18 @@
+import { type AthenaThreadPlanMode } from '../runtime/statewire-plan-mode';
+export type { AthenaThreadPlanMode };
+/**
+ * Whether the active thread's server config plans: the agent's to-do plan
+ * (`write_todos`) is on unless the thread's config lane excludes it, as the
+ * statewire host sent the lane.
+ *
+ * Once a thread has run with server config, its lane (not the provider's
+ * `planMode` prop) decides, and another client (Athena on the web, a second
+ * app) can change it at any time. Read this hook when a thread opens to show
+ * the thread's own plan mode in a switch: `{ planMode: null, configured: false }`
+ * is a thread without server config, whose turns run with what the provider
+ * sends. Wait for `ready`: until the host's snapshot of the thread has arrived
+ * every thread reads as unconfigured.
+ *
+ * Must be used within `<AthenaProvider>`.
+ */
+export declare function useAthenaThreadPlanMode(): AthenaThreadPlanMode;

package/dist/threads/use-athena-thread-plan-mode.js

@@ -0,0 +1,18 @@
+import { useContext, useMemo } from "react";
+import { threadPlanModeFromLane } from "../runtime/statewire-plan-mode.js";
+import { AthenaStatewireServerLaneContext } from "../runtime/statewire-server-lane-context.js";
+function useAthenaThreadPlanMode() {
+  const lane = useContext(AthenaStatewireServerLaneContext);
+  const planMode = useMemo(
+    () => lane === null ? null : threadPlanModeFromLane({ lane: lane.config, ready: lane.landed }),
+    [lane]
+  );
+  if (planMode === null) {
+    throw new Error("[AthenaSDK] useAthenaThreadPlanMode must be used within <AthenaProvider>");
+  }
+  return planMode;
+}
+export {
+  useAthenaThreadPlanMode
+};
+//# sourceMappingURL=use-athena-thread-plan-mode.js.map

package/dist/threads/use-athena-thread-plan-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-athena-thread-plan-mode.js","sources":["../../src/threads/use-athena-thread-plan-mode.ts"],"sourcesContent":["import { useContext, useMemo } from 'react';\nimport { type AthenaThreadPlanMode, threadPlanModeFromLane } from '../runtime/statewire-plan-mode';\nimport { AthenaStatewireServerLaneContext } from '../runtime/statewire-server-lane-context';\n\nexport type { AthenaThreadPlanMode };\n\n/**\n * Whether the active thread's server config plans: the agent's to-do plan\n * (`write_todos`) is on unless the thread's config lane excludes it, as the\n * statewire host sent the lane.\n *\n * Once a thread has run with server config, its lane (not the provider's\n * `planMode` prop) decides, and another client (Athena on the web, a second\n * app) can change it at any time. Read this hook when a thread opens to show\n * the thread's own plan mode in a switch: `{ planMode: null, configured: false }`\n * is a thread without server config, whose turns run with what the provider\n * sends. Wait for `ready`: until the host's snapshot of the thread has arrived\n * every thread reads as unconfigured.\n *\n * Must be used within `<AthenaProvider>`.\n */\nexport function useAthenaThreadPlanMode(): AthenaThreadPlanMode {\n  const lane = useContext(AthenaStatewireServerLaneContext);\n  const planMode = useMemo(\n    () => (lane === null ? null : threadPlanModeFromLane({ lane: lane.config, ready: lane.landed })),\n    [lane],\n  );\n  if (planMode === null) {\n    throw new Error('[AthenaSDK] useAthenaThreadPlanMode must be used within <AthenaProvider>');\n  }\n  return planMode;\n}\n"],"names":[],"mappings":";;;AAqBO,SAAS,0BAAgD;AAC9D,QAAM,OAAO,WAAW,gCAAgC;AACxD,QAAM,WAAW;AAAA,IACf,MAAO,SAAS,OAAO,OAAO,uBAAuB,EAAE,MAAM,KAAK,QAAQ,OAAO,KAAK,OAAA,CAAQ;AAAA,IAC9F,CAAC,IAAI;AAAA,EAAA;AAEP,MAAI,aAAa,MAAM;AACrB,UAAM,IAAI,MAAM,0EAA0E;AAAA,EAC5F;AACA,SAAO;AACT;"}

package/dist/threads/use-rest-conversation-history.d.ts

@@ -25,6 +25,7 @@ export declare function useRestConversationHistory({ backendUrl, principalId, ge
     isLoading: boolean;
     isFetching: boolean;
     hasResolvedFirstPage: boolean;
+    firstPageUpdatedAt: number;
     hasNextPage: boolean;
     isFetchingNextPage: boolean;
     isFetchNextPageError: boolean;

package/dist/tools/agent-creations.cjs

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const reactStatewire = require("@assistant-ui/react-statewire");
+const require$$0 = require("react");
+const autoOpenTools = require("./auto-open-tools.cjs");
+const statewireState = require("../agent-runtime/src/statewire-state.cjs");
+const toolNames = require("../agent-runtime/src/tool-names.cjs");
+const subagents = require("../agent-runtime/src/subagents.cjs");
+const runningToolPlaceholder = require("../agent-runtime/src/running-tool-placeholder.cjs");
+const messageText = require("../agent-runtime/src/message-text.cjs");
+const creationsByMessage = /* @__PURE__ */ new WeakMap();
+function argsByCallId(messages) {
+  const args = /* @__PURE__ */ new Map();
+  for (const message of messages) {
+    if (message.type !== "ai" || !message.tool_calls) continue;
+    for (const call of message.tool_calls) if (call.id) args.set(call.id, call.args);
+  }
+  return args;
+}
+function agentCreationsIn(messages) {
+  const args = argsByCallId(messages);
+  const made = [];
+  for (const message of messages) {
+    if (message.type !== "tool" || !message.tool_call_id || !message.name) continue;
+    if (message.name === toolNames.TASK_TOOL_NAME) {
+      made.push(...agentCreationsIn(subagents.nestedMessagesFromArtifact(message.artifact)));
+      continue;
+    }
+    if (runningToolPlaceholder.isRunningToolPlaceholder(message)) continue;
+    let creations = creationsByMessage.get(message);
+    if (creations === void 0) {
+      creations = autoOpenTools.creationsOfCall({
+        toolCallId: message.tool_call_id,
+        tool: message.name,
+        result: typeof message.content === "string" ? message.content : messageText.getMessageText(message),
+        isError: message.status === "error",
+        artifact: message.artifact,
+        args: args.get(message.tool_call_id)
+      });
+      creationsByMessage.set(message, creations);
+    }
+    made.push(...creations);
+  }
+  return made;
+}
+function latestTurn(messages) {
+  var _a;
+  for (let index = messages.length - 1; index >= 0; index -= 1) {
+    if (((_a = messages[index]) == null ? void 0 : _a.type) === "human") return messages.slice(index + 1);
+  }
+  return messages;
+}
+function createAgentCreationsReporter() {
+  let seen = null;
+  return {
+    see: ({ thread, messages }) => {
+      if (seen === null || seen.thread !== thread) {
+        seen = { thread, reported: new Set(agentCreationsIn(messages).map(({ key }) => key)) };
+        return [];
+      }
+      const reported = seen.reported;
+      const fresh = agentCreationsIn(latestTurn(messages)).filter(({ key }) => !reported.has(key));
+      for (const { key } of fresh) reported.add(key);
+      return fresh;
+    }
+  };
+}
+const selectState = (state) => state;
+function useAthenaAgentCreations({
+  onCreation,
+  enabled = true
+}) {
+  const state = reactStatewire.useStatewireState(selectState);
+  const reporter = require$$0.useRef(null);
+  const latest = require$$0.useRef(onCreation);
+  require$$0.useEffect(() => {
+    latest.current = onCreation;
+  }, [onCreation]);
+  require$$0.useEffect(() => {
+    if (!enabled) {
+      reporter.current = null;
+      return;
+    }
+    if (!statewireState.isDeepAgentStateHydrated(state)) return;
+    reporter.current ?? (reporter.current = createAgentCreationsReporter());
+    const made = reporter.current.see({
+      thread: statewireState.readDeepAgentStateThreadId(state),
+      messages: statewireState.readDeepAgentStreamValues(state).messages ?? []
+    });
+    for (const creation of made) latest.current(creation);
+  }, [state, enabled]);
+}
+exports.agentCreationsIn = agentCreationsIn;
+exports.createAgentCreationsReporter = createAgentCreationsReporter;
+exports.latestTurn = latestTurn;
+exports.useAthenaAgentCreations = useAthenaAgentCreations;
+//# sourceMappingURL=agent-creations.cjs.map

package/dist/tools/agent-creations.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-creations.cjs","sources":["../../src/tools/agent-creations.ts"],"sourcesContent":["'use client';\n\nimport type { LangChainMessage } from '@assistant-ui/react-langgraph';\nimport { useStatewireState } from '@assistant-ui/react-statewire';\nimport {\n  getMessageText,\n  isDeepAgentStateHydrated,\n  isRunningToolPlaceholder,\n  nestedMessagesFromArtifact,\n  readDeepAgentStateThreadId,\n  readDeepAgentStreamValues,\n  TASK_TOOL_NAME,\n} from '@athenaintel/agent-runtime';\nimport { useEffect, useRef } from 'react';\nimport { type AgentCreation, creationsOfCall } from './auto-open-tools';\n\n/*\n * What the agent makes, as it makes it, read off the conversation's own state: the deep agent's\n * runtime (statewire) runs no tool's `streamCall`, so the SDK's auto-open toolkit\n * (`DEFAULT_AUTO_OPEN_TOOLS`) never hears its calls answer. A host that follows the agent's work\n * (Athena's desktop app opens what it makes in a tab behind the person's) reads it here instead, as\n * Athena on the web's studio follow reads the transcript (`DeepAgentPtcStudioFollowObserver`).\n */\n\nexport type { AgentCreation } from './auto-open-tools';\n\n/** Each finished tool message's creations, kept with the message (a message never changes). */\nconst creationsByMessage = new WeakMap<object, AgentCreation[]>();\n\n/** The arguments of every tool call the AI messages in `messages` asked for, by call id. */\nfunction argsByCallId(messages: readonly LangChainMessage[]): Map<string, unknown> {\n  const args = new Map<string, unknown>();\n  for (const message of messages) {\n    if (message.type !== 'ai' || !message.tool_calls) continue;\n    for (const call of message.tool_calls) if (call.id) args.set(call.id, call.args);\n  }\n  return args;\n}\n\n/**\n * What the finished tool calls in `messages` made or showed the person (`creationsOfCall`), a\n * `task` subagent's own calls included (its transcript rides its card, running or done). A call\n * still running (its card is the backend's running placeholder) has made nothing yet.\n */\nexport function agentCreationsIn(messages: readonly LangChainMessage[]): AgentCreation[] {\n  const args = argsByCallId(messages);\n  const made: AgentCreation[] = [];\n  for (const message of messages) {\n    if (message.type !== 'tool' || !message.tool_call_id || !message.name) continue;\n    if (message.name === TASK_TOOL_NAME) {\n      made.push(...agentCreationsIn(nestedMessagesFromArtifact(message.artifact)));\n      continue;\n    }\n    if (isRunningToolPlaceholder(message)) continue;\n    let creations = creationsByMessage.get(message);\n    if (creations === undefined) {\n      creations = creationsOfCall({\n        toolCallId: message.tool_call_id,\n        tool: message.name,\n        result: typeof message.content === 'string' ? message.content : getMessageText(message),\n        isError: message.status === 'error',\n        artifact: message.artifact,\n        args: args.get(message.tool_call_id),\n      });\n      creationsByMessage.set(message, creations);\n    }\n    made.push(...creations);\n  }\n  return made;\n}\n\n/**\n * The messages of the conversation's latest turn: everything after the person's last message. What\n * the agent makes now is there; older history a page loads in never is.\n */\nexport function latestTurn(messages: readonly LangChainMessage[]): readonly LangChainMessage[] {\n  for (let index = messages.length - 1; index >= 0; index -= 1) {\n    if (messages[index]?.type === 'human') return messages.slice(index + 1);\n  }\n  return messages;\n}\n\n/** Tells a host what the agent makes, once each, from the states its conversation goes through. */\nexport interface AgentCreationsReporter {\n  /**\n   * A state of the conversation: what its latest turn made since the last one, never reported\n   * before. Everything a thread's first state holds (its history, a run already under way when it\n   * was opened) is history: nothing of it is reported. A state of another thread starts again.\n   */\n  see(params: { thread: string | null; messages: readonly LangChainMessage[] }): AgentCreation[];\n}\n\nexport function createAgentCreationsReporter(): AgentCreationsReporter {\n  let seen: { thread: string | null; reported: Set<string> } | null = null;\n  return {\n    see: ({ thread, messages }) => {\n      if (seen === null || seen.thread !== thread) {\n        seen = { thread, reported: new Set(agentCreationsIn(messages).map(({ key }) => key)) };\n        return [];\n      }\n      const reported = seen.reported;\n      const fresh = agentCreationsIn(latestTurn(messages)).filter(({ key }) => !reported.has(key));\n      for (const { key } of fresh) reported.add(key);\n      return fresh;\n    },\n  };\n}\n\nconst selectState = (state: unknown): unknown => state;\n\n/**\n * Calls `onCreation` once for each asset the agent makes in this conversation (a create tool, a\n * studio script's `Create*`) or opens for the person to see (`open_asset_in_workspace`), as its\n * call finishes: never for history, a call that failed or was refused, or a call that only read or\n * changed an asset. Render it inside `AthenaChat` (a `composer` slot, a `components` override),\n * where the conversation's state is read. Nothing is read while `enabled` is false.\n */\nexport function useAthenaAgentCreations({\n  onCreation,\n  enabled = true,\n}: {\n  onCreation: (creation: AgentCreation) => void;\n  enabled?: boolean;\n}): void {\n  const state = useStatewireState(selectState);\n  const reporter = useRef<AgentCreationsReporter | null>(null);\n  const latest = useRef(onCreation);\n  useEffect(() => {\n    latest.current = onCreation;\n  }, [onCreation]);\n  useEffect(() => {\n    if (!enabled) {\n      reporter.current = null;\n      return;\n    }\n    if (!isDeepAgentStateHydrated(state)) return;\n    reporter.current ??= createAgentCreationsReporter();\n    const made = reporter.current.see({\n      thread: readDeepAgentStateThreadId(state),\n      messages: readDeepAgentStreamValues(state).messages ?? [],\n    });\n    for (const creation of made) latest.current(creation);\n  }, [state, enabled]);\n}\n"],"names":["TASK_TOOL_NAME","nestedMessagesFromArtifact","isRunningToolPlaceholder","creationsOfCall","getMessageText","useStatewireState","useRef","useEffect","isDeepAgentStateHydrated","readDeepAgentStateThreadId","readDeepAgentStreamValues"],"mappings":"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"}

package/dist/tools/agent-creations.d.ts

@@ -0,0 +1,38 @@
+import type { LangChainMessage } from '@assistant-ui/react-langgraph';
+import { type AgentCreation } from './auto-open-tools';
+export type { AgentCreation } from './auto-open-tools';
+/**
+ * What the finished tool calls in `messages` made or showed the person (`creationsOfCall`), a
+ * `task` subagent's own calls included (its transcript rides its card, running or done). A call
+ * still running (its card is the backend's running placeholder) has made nothing yet.
+ */
+export declare function agentCreationsIn(messages: readonly LangChainMessage[]): AgentCreation[];
+/**
+ * The messages of the conversation's latest turn: everything after the person's last message. What
+ * the agent makes now is there; older history a page loads in never is.
+ */
+export declare function latestTurn(messages: readonly LangChainMessage[]): readonly LangChainMessage[];
+/** Tells a host what the agent makes, once each, from the states its conversation goes through. */
+export interface AgentCreationsReporter {
+    /**
+     * A state of the conversation: what its latest turn made since the last one, never reported
+     * before. Everything a thread's first state holds (its history, a run already under way when it
+     * was opened) is history: nothing of it is reported. A state of another thread starts again.
+     */
+    see(params: {
+        thread: string | null;
+        messages: readonly LangChainMessage[];
+    }): AgentCreation[];
+}
+export declare function createAgentCreationsReporter(): AgentCreationsReporter;
+/**
+ * Calls `onCreation` once for each asset the agent makes in this conversation (a create tool, a
+ * studio script's `Create*`) or opens for the person to see (`open_asset_in_workspace`), as its
+ * call finishes: never for history, a call that failed or was refused, or a call that only read or
+ * changed an asset. Render it inside `AthenaChat` (a `composer` slot, a `components` override),
+ * where the conversation's state is read. Nothing is read while `enabled` is false.
+ */
+export declare function useAthenaAgentCreations({ onCreation, enabled, }: {
+    onCreation: (creation: AgentCreation) => void;
+    enabled?: boolean;
+}): void;

package/dist/tools/agent-creations.js

@@ -0,0 +1,97 @@
+import { useStatewireState } from "@assistant-ui/react-statewire";
+import { useRef, useEffect } from "react";
+import { creationsOfCall } from "./auto-open-tools.js";
+import { isDeepAgentStateHydrated, readDeepAgentStreamValues, readDeepAgentStateThreadId } from "../agent-runtime/src/statewire-state.js";
+import { TASK_TOOL_NAME } from "../agent-runtime/src/tool-names.js";
+import { nestedMessagesFromArtifact } from "../agent-runtime/src/subagents.js";
+import { isRunningToolPlaceholder } from "../agent-runtime/src/running-tool-placeholder.js";
+import { getMessageText } from "../agent-runtime/src/message-text.js";
+const creationsByMessage = /* @__PURE__ */ new WeakMap();
+function argsByCallId(messages) {
+  const args = /* @__PURE__ */ new Map();
+  for (const message of messages) {
+    if (message.type !== "ai" || !message.tool_calls) continue;
+    for (const call of message.tool_calls) if (call.id) args.set(call.id, call.args);
+  }
+  return args;
+}
+function agentCreationsIn(messages) {
+  const args = argsByCallId(messages);
+  const made = [];
+  for (const message of messages) {
+    if (message.type !== "tool" || !message.tool_call_id || !message.name) continue;
+    if (message.name === TASK_TOOL_NAME) {
+      made.push(...agentCreationsIn(nestedMessagesFromArtifact(message.artifact)));
+      continue;
+    }
+    if (isRunningToolPlaceholder(message)) continue;
+    let creations = creationsByMessage.get(message);
+    if (creations === void 0) {
+      creations = creationsOfCall({
+        toolCallId: message.tool_call_id,
+        tool: message.name,
+        result: typeof message.content === "string" ? message.content : getMessageText(message),
+        isError: message.status === "error",
+        artifact: message.artifact,
+        args: args.get(message.tool_call_id)
+      });
+      creationsByMessage.set(message, creations);
+    }
+    made.push(...creations);
+  }
+  return made;
+}
+function latestTurn(messages) {
+  var _a;
+  for (let index = messages.length - 1; index >= 0; index -= 1) {
+    if (((_a = messages[index]) == null ? void 0 : _a.type) === "human") return messages.slice(index + 1);
+  }
+  return messages;
+}
+function createAgentCreationsReporter() {
+  let seen = null;
+  return {
+    see: ({ thread, messages }) => {
+      if (seen === null || seen.thread !== thread) {
+        seen = { thread, reported: new Set(agentCreationsIn(messages).map(({ key }) => key)) };
+        return [];
+      }
+      const reported = seen.reported;
+      const fresh = agentCreationsIn(latestTurn(messages)).filter(({ key }) => !reported.has(key));
+      for (const { key } of fresh) reported.add(key);
+      return fresh;
+    }
+  };
+}
+const selectState = (state) => state;
+function useAthenaAgentCreations({
+  onCreation,
+  enabled = true
+}) {
+  const state = useStatewireState(selectState);
+  const reporter = useRef(null);
+  const latest = useRef(onCreation);
+  useEffect(() => {
+    latest.current = onCreation;
+  }, [onCreation]);
+  useEffect(() => {
+    if (!enabled) {
+      reporter.current = null;
+      return;
+    }
+    if (!isDeepAgentStateHydrated(state)) return;
+    reporter.current ?? (reporter.current = createAgentCreationsReporter());
+    const made = reporter.current.see({
+      thread: readDeepAgentStateThreadId(state),
+      messages: readDeepAgentStreamValues(state).messages ?? []
+    });
+    for (const creation of made) latest.current(creation);
+  }, [state, enabled]);
+}
+export {
+  agentCreationsIn,
+  createAgentCreationsReporter,
+  latestTurn,
+  useAthenaAgentCreations
+};
+//# sourceMappingURL=agent-creations.js.map

package/dist/tools/agent-creations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-creations.js","sources":["../../src/tools/agent-creations.ts"],"sourcesContent":["'use client';\n\nimport type { LangChainMessage } from '@assistant-ui/react-langgraph';\nimport { useStatewireState } from '@assistant-ui/react-statewire';\nimport {\n  getMessageText,\n  isDeepAgentStateHydrated,\n  isRunningToolPlaceholder,\n  nestedMessagesFromArtifact,\n  readDeepAgentStateThreadId,\n  readDeepAgentStreamValues,\n  TASK_TOOL_NAME,\n} from '@athenaintel/agent-runtime';\nimport { useEffect, useRef } from 'react';\nimport { type AgentCreation, creationsOfCall } from './auto-open-tools';\n\n/*\n * What the agent makes, as it makes it, read off the conversation's own state: the deep agent's\n * runtime (statewire) runs no tool's `streamCall`, so the SDK's auto-open toolkit\n * (`DEFAULT_AUTO_OPEN_TOOLS`) never hears its calls answer. A host that follows the agent's work\n * (Athena's desktop app opens what it makes in a tab behind the person's) reads it here instead, as\n * Athena on the web's studio follow reads the transcript (`DeepAgentPtcStudioFollowObserver`).\n */\n\nexport type { AgentCreation } from './auto-open-tools';\n\n/** Each finished tool message's creations, kept with the message (a message never changes). */\nconst creationsByMessage = new WeakMap<object, AgentCreation[]>();\n\n/** The arguments of every tool call the AI messages in `messages` asked for, by call id. */\nfunction argsByCallId(messages: readonly LangChainMessage[]): Map<string, unknown> {\n  const args = new Map<string, unknown>();\n  for (const message of messages) {\n    if (message.type !== 'ai' || !message.tool_calls) continue;\n    for (const call of message.tool_calls) if (call.id) args.set(call.id, call.args);\n  }\n  return args;\n}\n\n/**\n * What the finished tool calls in `messages` made or showed the person (`creationsOfCall`), a\n * `task` subagent's own calls included (its transcript rides its card, running or done). A call\n * still running (its card is the backend's running placeholder) has made nothing yet.\n */\nexport function agentCreationsIn(messages: readonly LangChainMessage[]): AgentCreation[] {\n  const args = argsByCallId(messages);\n  const made: AgentCreation[] = [];\n  for (const message of messages) {\n    if (message.type !== 'tool' || !message.tool_call_id || !message.name) continue;\n    if (message.name === TASK_TOOL_NAME) {\n      made.push(...agentCreationsIn(nestedMessagesFromArtifact(message.artifact)));\n      continue;\n    }\n    if (isRunningToolPlaceholder(message)) continue;\n    let creations = creationsByMessage.get(message);\n    if (creations === undefined) {\n      creations = creationsOfCall({\n        toolCallId: message.tool_call_id,\n        tool: message.name,\n        result: typeof message.content === 'string' ? message.content : getMessageText(message),\n        isError: message.status === 'error',\n        artifact: message.artifact,\n        args: args.get(message.tool_call_id),\n      });\n      creationsByMessage.set(message, creations);\n    }\n    made.push(...creations);\n  }\n  return made;\n}\n\n/**\n * The messages of the conversation's latest turn: everything after the person's last message. What\n * the agent makes now is there; older history a page loads in never is.\n */\nexport function latestTurn(messages: readonly LangChainMessage[]): readonly LangChainMessage[] {\n  for (let index = messages.length - 1; index >= 0; index -= 1) {\n    if (messages[index]?.type === 'human') return messages.slice(index + 1);\n  }\n  return messages;\n}\n\n/** Tells a host what the agent makes, once each, from the states its conversation goes through. */\nexport interface AgentCreationsReporter {\n  /**\n   * A state of the conversation: what its latest turn made since the last one, never reported\n   * before. Everything a thread's first state holds (its history, a run already under way when it\n   * was opened) is history: nothing of it is reported. A state of another thread starts again.\n   */\n  see(params: { thread: string | null; messages: readonly LangChainMessage[] }): AgentCreation[];\n}\n\nexport function createAgentCreationsReporter(): AgentCreationsReporter {\n  let seen: { thread: string | null; reported: Set<string> } | null = null;\n  return {\n    see: ({ thread, messages }) => {\n      if (seen === null || seen.thread !== thread) {\n        seen = { thread, reported: new Set(agentCreationsIn(messages).map(({ key }) => key)) };\n        return [];\n      }\n      const reported = seen.reported;\n      const fresh = agentCreationsIn(latestTurn(messages)).filter(({ key }) => !reported.has(key));\n      for (const { key } of fresh) reported.add(key);\n      return fresh;\n    },\n  };\n}\n\nconst selectState = (state: unknown): unknown => state;\n\n/**\n * Calls `onCreation` once for each asset the agent makes in this conversation (a create tool, a\n * studio script's `Create*`) or opens for the person to see (`open_asset_in_workspace`), as its\n * call finishes: never for history, a call that failed or was refused, or a call that only read or\n * changed an asset. Render it inside `AthenaChat` (a `composer` slot, a `components` override),\n * where the conversation's state is read. Nothing is read while `enabled` is false.\n */\nexport function useAthenaAgentCreations({\n  onCreation,\n  enabled = true,\n}: {\n  onCreation: (creation: AgentCreation) => void;\n  enabled?: boolean;\n}): void {\n  const state = useStatewireState(selectState);\n  const reporter = useRef<AgentCreationsReporter | null>(null);\n  const latest = useRef(onCreation);\n  useEffect(() => {\n    latest.current = onCreation;\n  }, [onCreation]);\n  useEffect(() => {\n    if (!enabled) {\n      reporter.current = null;\n      return;\n    }\n    if (!isDeepAgentStateHydrated(state)) return;\n    reporter.current ??= createAgentCreationsReporter();\n    const made = reporter.current.see({\n      thread: readDeepAgentStateThreadId(state),\n      messages: readDeepAgentStreamValues(state).messages ?? [],\n    });\n    for (const creation of made) latest.current(creation);\n  }, [state, enabled]);\n}\n"],"names":[],"mappings":"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"}

package/dist/tools/agent-highlights.cjs

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const reactStatewire = require("@assistant-ui/react-statewire");
+const require$$0 = require("react");
+const agentCreations = require("./agent-creations.cjs");
+const assetUtils = require("./asset-utils.cjs");
+const statewireState = require("../agent-runtime/src/statewire-state.cjs");
+const toolNames = require("../agent-runtime/src/tool-names.cjs");
+const subagents = require("../agent-runtime/src/subagents.cjs");
+const runningToolPlaceholder = require("../agent-runtime/src/running-tool-placeholder.cjs");
+const messageText = require("../agent-runtime/src/message-text.cjs");
+const HIGHLIGHT_IN_ASSET_TOOL = "highlight_in_asset";
+const AGENT_HIGHLIGHT_MAX_MS = 3e4;
+const AGENT_HIGHLIGHT_DEFAULT_MS = 5e3;
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+function highlightOfCall({
+  toolCallId,
+  result,
+  isError
+}) {
+  if (isError) return null;
+  const data = typeof result === "string" ? assetUtils.tryParseJson(result) : result;
+  if (!isRecord(data) || data.status !== "success") return null;
+  const assetRef = typeof data.assetRef === "string" ? data.assetRef.trim() : "";
+  const assetId = assetRef.split("?")[0] ?? "";
+  if (!assetId.startsWith("asset_")) return null;
+  const content = typeof data.content === "string" && data.content.trim() ? data.content.trim() : null;
+  const asked = typeof data.durationMs === "number" && Number.isFinite(data.durationMs) ? data.durationMs : null;
+  const durationMs = Math.max(
+    0,
+    Math.min(asked ?? AGENT_HIGHLIGHT_DEFAULT_MS, AGENT_HIGHLIGHT_MAX_MS)
+  );
+  return { key: toolCallId, assetId, assetRef, content, durationMs };
+}
+function agentHighlightsIn(messages) {
+  const shown = [];
+  for (const message of messages) {
+    if (message.type !== "tool" || !message.tool_call_id || !message.name) continue;
+    if (message.name === toolNames.TASK_TOOL_NAME) {
+      shown.push(...agentHighlightsIn(subagents.nestedMessagesFromArtifact(message.artifact)));
+      continue;
+    }
+    if (message.name !== HIGHLIGHT_IN_ASSET_TOOL || runningToolPlaceholder.isRunningToolPlaceholder(message)) continue;
+    const highlight = highlightOfCall({
+      toolCallId: message.tool_call_id,
+      result: typeof message.content === "string" ? message.content : messageText.getMessageText(message),
+      isError: message.status === "error"
+    });
+    if (highlight) shown.push(highlight);
+  }
+  return shown;
+}
+function createAgentHighlightsReporter() {
+  let seen = null;
+  return {
+    see: ({ thread, messages }) => {
+      if (seen === null || seen.thread !== thread) {
+        seen = { thread, reported: new Set(agentHighlightsIn(messages).map(({ key }) => key)) };
+        return [];
+      }
+      const reported = seen.reported;
+      const fresh = agentHighlightsIn(agentCreations.latestTurn(messages)).filter(({ key }) => !reported.has(key));
+      for (const { key } of fresh) reported.add(key);
+      return fresh;
+    }
+  };
+}
+const selectState = (state) => state;
+function useAthenaAgentHighlights({
+  onHighlight,
+  enabled = true
+}) {
+  const state = reactStatewire.useStatewireState(selectState);
+  const reporter = require$$0.useRef(null);
+  const latest = require$$0.useRef(onHighlight);
+  require$$0.useEffect(() => {
+    latest.current = onHighlight;
+  }, [onHighlight]);
+  require$$0.useEffect(() => {
+    if (!enabled) {
+      reporter.current = null;
+      return;
+    }
+    if (!statewireState.isDeepAgentStateHydrated(state)) return;
+    reporter.current ?? (reporter.current = createAgentHighlightsReporter());
+    const shown = reporter.current.see({
+      thread: statewireState.readDeepAgentStateThreadId(state),
+      messages: statewireState.readDeepAgentStreamValues(state).messages ?? []
+    });
+    for (const highlight of shown) latest.current(highlight);
+  }, [state, enabled]);
+}
+exports.AGENT_HIGHLIGHT_DEFAULT_MS = AGENT_HIGHLIGHT_DEFAULT_MS;
+exports.AGENT_HIGHLIGHT_MAX_MS = AGENT_HIGHLIGHT_MAX_MS;
+exports.HIGHLIGHT_IN_ASSET_TOOL = HIGHLIGHT_IN_ASSET_TOOL;
+exports.agentHighlightsIn = agentHighlightsIn;
+exports.createAgentHighlightsReporter = createAgentHighlightsReporter;
+exports.highlightOfCall = highlightOfCall;
+exports.useAthenaAgentHighlights = useAthenaAgentHighlights;
+//# sourceMappingURL=agent-highlights.cjs.map

package/dist/tools/agent-highlights.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-highlights.cjs","sources":["../../src/tools/agent-highlights.ts"],"sourcesContent":["'use client';\n\nimport type { LangChainMessage } from '@assistant-ui/react-langgraph';\nimport { useStatewireState } from '@assistant-ui/react-statewire';\nimport {\n  getMessageText,\n  isDeepAgentStateHydrated,\n  isRunningToolPlaceholder,\n  nestedMessagesFromArtifact,\n  readDeepAgentStateThreadId,\n  readDeepAgentStreamValues,\n  TASK_TOOL_NAME,\n} from '@athenaintel/agent-runtime';\nimport { useEffect, useRef } from 'react';\nimport { latestTurn } from './agent-creations';\nimport { tryParseJson } from './asset-utils';\n\n/*\n * The places the agent shows the person (`highlight_in_asset`: \"flash and scroll the user to a\n * location inside an asset\", with a tooltip), read off the conversation's own state as the agent's\n * creations are (`agent-creations.ts`): the deep agent's runtime runs no tool's `streamCall`, so a\n * host that shows them (Athena's desktop app) reads them here. agora answers a highlight only for an\n * asset the person may view (its read gate); a refusal carries no `assetRef`, and shows nothing.\n */\n\n/** The `highlight_in_asset` tool's name. */\nexport const HIGHLIGHT_IN_ASSET_TOOL = 'highlight_in_asset';\n\n/** The longest a highlight stays, as agora clamps it. */\nexport const AGENT_HIGHLIGHT_MAX_MS = 30_000;\n/** How long a highlight stays when the answer names no duration, as agora's default. */\nexport const AGENT_HIGHLIGHT_DEFAULT_MS = 5_000;\n\n/** A place the agent showed the person in an asset, once its call answered. */\nexport interface AgentHighlight {\n  /** The call's id: a highlight is reported once. */\n  key: string;\n  /** The asset, by its bare id. */\n  assetId: string;\n  /**\n   * Where in it, as the agent named it: the id and the references grammar's anchor query\n   * (`asset_x?anchor=pm_node&node_id=…`), or the bare id for the asset itself.\n   */\n  assetRef: string;\n  /** The tooltip to show over the place, if any. */\n  content: string | null;\n  /** How long the mark and the tooltip stay, clamped to `AGENT_HIGHLIGHT_MAX_MS`. */\n  durationMs: number;\n}\n\ntype AnyRecord = Record<string, unknown>;\n\nconst isRecord = (value: unknown): value is AnyRecord =>\n  typeof value === 'object' && value !== null && !Array.isArray(value);\n\n/** The highlight one finished `highlight_in_asset` call showed, or null for a refusal or a failure. */\nexport function highlightOfCall({\n  toolCallId,\n  result,\n  isError,\n}: {\n  toolCallId: string;\n  result: unknown;\n  isError?: boolean;\n}): AgentHighlight | null {\n  if (isError) return null;\n  const data = typeof result === 'string' ? tryParseJson(result) : result;\n  if (!isRecord(data) || data.status !== 'success') return null;\n  const assetRef = typeof data.assetRef === 'string' ? data.assetRef.trim() : '';\n  const assetId = assetRef.split('?')[0] ?? '';\n  if (!assetId.startsWith('asset_')) return null;\n  const content =\n    typeof data.content === 'string' && data.content.trim() ? data.content.trim() : null;\n  const asked =\n    typeof data.durationMs === 'number' && Number.isFinite(data.durationMs) ? data.durationMs : null;\n  const durationMs = Math.max(\n    0,\n    Math.min(asked ?? AGENT_HIGHLIGHT_DEFAULT_MS, AGENT_HIGHLIGHT_MAX_MS),\n  );\n  return { key: toolCallId, assetId, assetRef, content, durationMs };\n}\n\n/**\n * What the finished `highlight_in_asset` calls in `messages` showed the person, a `task` subagent's\n * own calls included. A call still running has shown nothing yet.\n */\nexport function agentHighlightsIn(messages: readonly LangChainMessage[]): AgentHighlight[] {\n  const shown: AgentHighlight[] = [];\n  for (const message of messages) {\n    if (message.type !== 'tool' || !message.tool_call_id || !message.name) continue;\n    if (message.name === TASK_TOOL_NAME) {\n      shown.push(...agentHighlightsIn(nestedMessagesFromArtifact(message.artifact)));\n      continue;\n    }\n    if (message.name !== HIGHLIGHT_IN_ASSET_TOOL || isRunningToolPlaceholder(message)) continue;\n    const highlight = highlightOfCall({\n      toolCallId: message.tool_call_id,\n      result: typeof message.content === 'string' ? message.content : getMessageText(message),\n      isError: message.status === 'error',\n    });\n    if (highlight) shown.push(highlight);\n  }\n  return shown;\n}\n\n/** Tells a host the places the agent shows, once each, from the states its conversation goes through. */\nexport interface AgentHighlightsReporter {\n  /**\n   * A state of the conversation: the highlights its latest turn showed since the last one. A\n   * thread's first state is history (nothing of it is shown again); a state of another thread\n   * starts again.\n   */\n  see(params: { thread: string | null; messages: readonly LangChainMessage[] }): AgentHighlight[];\n}\n\nexport function createAgentHighlightsReporter(): AgentHighlightsReporter {\n  let seen: { thread: string | null; reported: Set<string> } | null = null;\n  return {\n    see: ({ thread, messages }) => {\n      if (seen === null || seen.thread !== thread) {\n        seen = { thread, reported: new Set(agentHighlightsIn(messages).map(({ key }) => key)) };\n        return [];\n      }\n      const reported = seen.reported;\n      const fresh = agentHighlightsIn(latestTurn(messages)).filter(({ key }) => !reported.has(key));\n      for (const { key } of fresh) reported.add(key);\n      return fresh;\n    },\n  };\n}\n\nconst selectState = (state: unknown): unknown => state;\n\n/**\n * Calls `onHighlight` once for each place the agent shows the person in this conversation\n * (`highlight_in_asset`), as its call answers: never for history, or a call that failed or was\n * refused. Render it inside `AthenaChat`, where the conversation's state is read. Nothing is read\n * while `enabled` is false.\n */\nexport function useAthenaAgentHighlights({\n  onHighlight,\n  enabled = true,\n}: {\n  onHighlight: (highlight: AgentHighlight) => void;\n  enabled?: boolean;\n}): void {\n  const state = useStatewireState(selectState);\n  const reporter = useRef<AgentHighlightsReporter | null>(null);\n  const latest = useRef(onHighlight);\n  useEffect(() => {\n    latest.current = onHighlight;\n  }, [onHighlight]);\n  useEffect(() => {\n    if (!enabled) {\n      reporter.current = null;\n      return;\n    }\n    if (!isDeepAgentStateHydrated(state)) return;\n    reporter.current ??= createAgentHighlightsReporter();\n    const shown = reporter.current.see({\n      thread: readDeepAgentStateThreadId(state),\n      messages: readDeepAgentStreamValues(state).messages ?? [],\n    });\n    for (const highlight of shown) latest.current(highlight);\n  }, [state, enabled]);\n}\n"],"names":["tryParseJson","TASK_TOOL_NAME","nestedMessagesFromArtifact","isRunningToolPlaceholder","getMessageText","latestTurn","useStatewireState","useRef","useEffect","isDeepAgentStateHydrated","readDeepAgentStateThreadId","readDeepAgentStreamValues"],"mappings":"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"}