@athenaintel/react 0.60.0 → 0.60.1

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

@@ -0,0 +1,71 @@
+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[];
+}
+/**
+ * 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 writes in this conversation. */
+    isGranted(threadId: 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. */
+    grant(threadId: 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,111 @@
+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 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) => granted.has(threadId),
+    ask(request) {
+      if (granted.has(request.threadId)) 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) granted.add(pending.request.threadId);
+      settle(allow ? "proceed" : "declined");
+    },
+    abandon(requestId) {
+      if ((pending == null ? void 0 : pending.request.requestId) !== requestId) return;
+      settle("abandoned");
+    },
+    grant(threadId) {
+      granted.add(threadId);
+    },
+    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 rest of the conversation, as Athena's own apps do, for\n * the person who allowed it: 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}\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 writes in this conversation. */\n  isGranted(threadId: 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. */\n  grant(threadId: 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 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) => granted.has(threadId),\n    ask(request) {\n      if (granted.has(request.threadId)) return Promise.resolve('proceed');\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) granted.add(pending.request.threadId);\n      settle(allow ? 'proceed' : 'declined');\n    },\n    abandon(requestId) {\n      if (pending?.request.requestId !== requestId) return;\n      settle('abandoned');\n    },\n    grant(threadId) {\n      granted.add(threadId);\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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"}

package/dist/chat/statewire-client-tools.d.ts

@@ -6,6 +6,37 @@ import { type RegisteredClientTool } from '../agent-runtime/src/index';
  * that type instead. Retained for one release so existing imports type-check.
  */
 export type StatewireClientTool = RegisteredClientTool;
+export interface ClientToolWriteConsentOptions {
+    /**
+     * What the tool does, as the rest of the sentence "… wants to ___" on the
+     * consent card (e.g. `"click and type on this page"`). The card names the
+     * tool when this is absent.
+     */
+    summary?: string;
+}
+/**
+ * Mark a `frontendTools` entry as a write: the person is asked before its
+ * first call in a conversation runs, the answer covers the rest of that
+ * conversation, and a declined call answers the model with an error instead
+ * of running. Unmarked tools run without asking, as before.
+ *
+ * ```ts
+ * const frontendTools = {
+ *   save_note: requiresWriteConsent(
+ *     { description: '…', parameters, execute: saveNote },
+ *     { summary: 'save a note on this record' },
+ *   ),
+ * };
+ * ```
+ *
+ * The mark also travels to Athena (`requires_write`), which then never
+ * answers the call on the person's behalf while their tab is away.
+ */
+export declare function requiresWriteConsent<T extends object>(tool: T, options?: ClientToolWriteConsentOptions): T;
+/** The consent mark on a toolkit entry, or `null` for a tool that never asks. */
+export declare function clientToolWriteConsent(entry: unknown): ClientToolWriteConsentOptions | null;
+/** Each consent-marked tool's own words for what it does, by tool name. */
+export declare function clientToolWriteConsentSummaries(toolkit: Toolkit | undefined): Readonly<Record<string, string>>;
 /**
  * Collect the client-executable tools from a frontend toolkit, in the shared
  * `RegisteredClientTool` shape every statewire surface declares and executes.
@@ -16,8 +47,9 @@ export type StatewireClientTool = RegisteredClientTool;
  * bridge. Schema conversion reuses `toJSONSchema` — the same conversion
  * primitive as the legacy assistant-transport — and a tool whose schema cannot
  * be converted is skipped with a warning rather than failing the whole set.
- * SDK tools never gate on write consent (`requiresWrite: false`): a toolkit
- * `execute` is the host app's own code.
+ * A tool gates on write consent only when its entry is marked with
+ * `requiresWriteConsent`: an unmarked toolkit `execute` is the host app's own
+ * code and runs without asking.
  */
 export declare function collectStatewireClientTools(toolkit: Toolkit): RegisteredClientTool[];
 /** Wire entries for `runConfig.custom.client_tools` — the shared contract from

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

@@ -1,6 +1,28 @@
 import { athenaDiagnostics } from "../diagnostics/athena-diagnostics.js";
 import { toJSONSchema, ToolResponse } from "assistant-stream";
 import { clientToolRunConfigEntries } from "../agent-runtime/src/client-tools.js";
+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";
 }
@@ -30,15 +52,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.")
             )
@@ -72,7 +94,10 @@ function resolveClientToolSurface(appId) {
 export {
   CLIENT_TOOL_SURFACE_APP_IDS,
   backendDeclaredFrontendToolIds,
+  clientToolWriteConsent,
+  clientToolWriteConsentSummaries,
   collectStatewireClientTools,
+  requiresWriteConsent,
   resolveClientToolSurface,
   statewireClientToolWireEntries
 };

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

@@ -1 +1 @@
-{"version":3,"file":"statewire-client-tools.js","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":[],"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,GAAG,aAAa,MAAM,UAAU,EAAA;AAAA,IACjD,SAAS,OAAO;AACd,wBAAkB,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,kBAAkB,eAAe,OAAO,SAAS;AAAA,QAC1D;AAAA,MAAA;AAAA,IACF;AAAA,EAEJ,CAAC;AACH;AAIO,SAAS,+BACd,OAC2B;AAC3B,SAAO,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.js","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":[],"mappings":"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"}

package/dist/chat-ui/mentions/suggestions/data/sources/asset-type-icons.cjs

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const athenaUrls = require("../../../../../lib/athena-urls.cjs");
 const assetTypeIconNames_generated = require("./asset-type-icon-names.generated.cjs");
 let hostIconBasePath = null;
 function configureAssetIconBasePath({
@@ -7,6 +8,17 @@ function configureAssetIconBasePath({
 }) {
   hostIconBasePath = basePath ? basePath.replace(/\/*$/, "/") : null;
 }
+function currentPageOrigin() {
+  return typeof window === "undefined" ? null : window.location.origin;
+}
+function assetIconAppUrl({
+  appUrl,
+  backendUrl,
+  pageOrigin = currentPageOrigin()
+}) {
+  if (!appUrl) return null;
+  return athenaUrls.athenaLinkAppUrl({ appUrl, backendUrl: backendUrl ?? "", pageOrigin });
+}
 function athenaAppAssetIconBasePath({
   appUrl
 }) {
@@ -148,6 +160,7 @@ function assetTypeToIcon(assetType) {
   if (!key || !Object.hasOwn(ASSET_TYPE_LUCIDE_FALLBACK, key)) return "file";
   return ASSET_TYPE_LUCIDE_FALLBACK[key] ?? "file";
 }
+exports.assetIconAppUrl = assetIconAppUrl;
 exports.assetTypeToIcon = assetTypeToIcon;
 exports.assetTypeToThumb = assetTypeToThumb;
 exports.athenaAppAssetIconBasePath = athenaAppAssetIconBasePath;

package/dist/chat-ui/mentions/suggestions/data/sources/asset-type-icons.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"asset-type-icons.cjs","sources":["../../../../../../src/chat-ui/mentions/suggestions/data/sources/asset-type-icons.ts"],"sourcesContent":["/**\n * Athena's asset-type icons: the SVG Olympus draws for each asset type.\n *\n * The type → icon table is Olympus's own: `ASSET_TYPE_ICON_NAMES`\n * (`asset-type-icon-names.generated.ts`), generated from its\n * `AthenaTypeToThumb` by Olympus's parity test, which writes the same table\n * into `@athenaintel/sheets` and fails when either drifts. So the `@` menu, the\n * mention chips and the drive cards draw the icon Olympus draws for every type.\n *\n * Where the SVGs load from:\n * - type glyphs (`ic-…`): a host's own copy when it names one with\n *   `configureAssetIconBasePath` (the Chrome extension), else the Athena web\n *   app the chat talks to (`appUrl`, the provider's: `useAssetIconAppUrl`),\n *   which serves the public files Olympus draws at `<appUrl>/assets/icons/files/`;\n * - brand logos (Power BI, Slack, Gmail, Outlook) sit in `apps/` beside them:\n *   from that app when the chat names one (a host's copy may carry only the\n *   glyphs), else beside the host's copy.\n *\n * With neither there is no SVG, and callers draw the type's Lucide icon\n * (`assetTypeToIcon`). `MentionIcon`, the chips and the drive cards also fall\n * back to it when an SVG cannot load (a strict CSP, offline).\n */\n\nimport {\n  ASSET_TYPE_ICON_NAMES,\n  DEFAULT_ASSET_TYPE_ICON,\n} from \"./asset-type-icon-names.generated\";\n\nlet hostIconBasePath: string | null = null;\n\n/**\n * Point the asset-type icons at the host's own copy of Olympus's\n * `assets/icons/files/` SVGs. `basePath` is resolved against the host\n * document; a trailing \"/\" is added when the caller omits it. `null` drops the\n * host copy: the icons then load from the Athena web app the chat talks to.\n */\nexport function configureAssetIconBasePath({\n  basePath,\n}: {\n  basePath: string | null;\n}): void {\n  hostIconBasePath = basePath ? basePath.replace(/\\/*$/, \"/\") : null;\n}\n\n/** Where the Athena web app at `appUrl` serves the asset-type SVGs; null for an unusable URL. */\nexport function athenaAppAssetIconBasePath({\n  appUrl,\n}: {\n  appUrl: string | null | undefined;\n}): string | null {\n  if (!appUrl?.trim()) return null;\n  try {\n    const base = new URL(\"/assets/icons/files/\", appUrl);\n    return base.protocol === \"https:\" || base.protocol === \"http:\"\n      ? base.toString()\n      : null;\n  } catch {\n    return null;\n  }\n}\n\nconst FILES_DIR = \"files/\";\n\n/** An icon's URL, from the host's copy or the chat's Athena web app (see the module doc). */\nfunction iconUrl({\n  icon,\n  appUrl,\n}: {\n  icon: string;\n  appUrl: string | null | undefined;\n}): string | undefined {\n  const appBasePath = athenaAppAssetIconBasePath({ appUrl });\n  if (/^ic[-_]/.test(icon)) {\n    const basePath = hostIconBasePath ?? appBasePath;\n    return basePath ? `${basePath}${icon}.svg` : undefined;\n  }\n  const filesBasePath = appBasePath ?? hostIconBasePath;\n  if (!filesBasePath) return undefined;\n  return filesBasePath.endsWith(`/${FILES_DIR}`)\n    ? `${filesBasePath.slice(0, -FILES_DIR.length)}apps/${icon}.svg`\n    : `${filesBasePath}${icon}.svg`;\n}\n\nfunction assetTypeIconName(assetType: string | null | undefined): string {\n  const key = assetType?.toLowerCase();\n  return key && Object.hasOwn(ASSET_TYPE_ICON_NAMES, key)\n    ? (ASSET_TYPE_ICON_NAMES[key] ?? DEFAULT_ASSET_TYPE_ICON)\n    : DEFAULT_ASSET_TYPE_ICON;\n}\n\n/**\n * The SVG URL of an asset type's icon, the one Olympus draws. `appUrl` is the\n * Athena web app the chat talks to (`useAssetIconAppUrl`); undefined when\n * neither it nor a host copy (`configureAssetIconBasePath`) is available.\n */\nexport function assetTypeToThumb(\n  assetType: string | null | undefined,\n  { appUrl }: { appUrl?: string | null } = {},\n): string | undefined {\n  return iconUrl({ icon: assetTypeIconName(assetType), appUrl });\n}\n\nconst EMAIL_ASSET_TYPES: ReadonlySet<string> = new Set([\n  \"email\",\n  \"email_draft\",\n  \"email_message\",\n  \"live_email_thread\",\n]);\n\n/** Whether rows of this type can draw their mailbox's logo (`emailProviderThumb`). */\nexport function isEmailAssetType(assetType: string | null | undefined): boolean {\n  return !!assetType && EMAIL_ASSET_TYPES.has(assetType.toLowerCase());\n}\n\nfunction recordOf(value: unknown): Record<string, unknown> | null {\n  return value && typeof value === \"object\" && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : null;\n}\n\nconst LANE_PREFIX = /^paragon_/;\nconst LANE_SUFFIX = /_(direct(_v\\d+)?|paragon|live)$/;\n\n/** Gmail or Outlook, from the provider an email asset records; null for any other or none. */\nfunction mailboxLogo(metadata: unknown): \"gmail\" | \"outlook\" | null {\n  const record = recordOf(metadata);\n  if (!record) return null;\n  const provider: unknown =\n    recordOf(record.liveAsset)?.provider ??\n    recordOf(record.email)?.provider ??\n    recordOf(record.email_draft)?.provider;\n  if (typeof provider !== \"string\") return null;\n  const name = provider.trim().toLowerCase().replace(LANE_PREFIX, \"\").replace(LANE_SUFFIX, \"\");\n  if (name === \"gmail\" || name === \"google\") return \"gmail\";\n  if (name === \"outlook\" || name === \"microsoft_graph\") return \"outlook\";\n  return null;\n}\n\n/**\n * The Gmail or Outlook logo for an email asset whose mailbox provider its\n * metadata records (`liveAsset.provider`, the `email` block agora writes\n * beside it, or a draft's `email_draft` block), as Olympus draws it;\n * undefined otherwise, for the type's mail icon.\n */\nexport function emailProviderThumb({\n  assetType,\n  metadata,\n  appUrl,\n}: {\n  assetType: string | null | undefined;\n  metadata: unknown;\n  /** The Athena web app the chat talks to (`useAssetIconAppUrl`). */\n  appUrl?: string | null;\n}): string | undefined {\n  if (!isEmailAssetType(assetType)) return undefined;\n  const logo = mailboxLogo(metadata);\n  return logo ? iconUrl({ icon: logo, appUrl }) : undefined;\n}\n\n/**\n * The Lucide icon (a `MentionIcon` name) drawn for an asset type when its SVG\n * is not available: no icon source, or the SVG failed to load.\n */\nconst ASSET_TYPE_LUCIDE_FALLBACK: Record<string, string> = {\n  aop: \"workflow\",\n  application: \"layout-grid\",\n  audio: \"headphones\",\n  automation: \"zap\",\n  browse_profile: \"globe\",\n  browse_session: \"globe\",\n  canvas: \"palette\",\n  catalog: \"database\",\n  collab_agent: \"bot\",\n  collab_source: \"database\",\n  collab_toolkit: \"package\",\n  collection: \"library\",\n  computer: \"monitor\",\n  dashboard: \"layout-dashboard\",\n  database: \"database\",\n  design_system: \"palette\",\n  desktop_session: \"monitor\",\n  device: \"smartphone\",\n  document: \"file-text\",\n  drive: \"hard-drive\",\n  email: \"mail\",\n  email_draft: \"mail\",\n  email_message: \"mail\",\n  environment: \"server\",\n  figure: \"chart-bar\",\n  folder: \"folder\",\n  gdrive_folder: \"folder\",\n  generic_doc: \"file-text\",\n  image: \"image\",\n  json: \"file-code\",\n  lakehouse_namespace: \"database\",\n  lakehouse_sync: \"workflow\",\n  lakehouse_table: \"table\",\n  live_calendar_event: \"calendar\",\n  live_email_thread: \"mail\",\n  markdown: \"file-text\",\n  meeting: \"video\",\n  mobile_session: \"smartphone\",\n  notebook: \"book-open\",\n  olympus_drive: \"hard-drive\",\n  pdf: \"file-text\",\n  person: \"user\",\n  phone_call: \"phone\",\n  playbook: \"book-open\",\n  policy: \"check-square\",\n  powerpoint_deck: \"presentation\",\n  pptx: \"presentation\",\n  presentation: \"presentation\",\n  presentation_pptx_studio: \"presentation\",\n  project: \"folder-kanban\",\n  python: \"file-code\",\n  query_snippet: \"database\",\n  script: \"file-code\",\n  secret: \"key\",\n  semantic_model: \"database\",\n  session: \"message-square\",\n  skill: \"sparkles\",\n  spreadsheet: \"sheet\",\n  table: \"table\",\n  transform_project: \"workflow\",\n  txt: \"file-text\",\n  user_interface: \"layout\",\n  video: \"video\",\n  video_session: \"video\",\n  voice_memo: \"mic\",\n  web_page: \"globe\",\n  word_document: \"file-text\",\n  yaml: \"file-code\",\n};\n\n/** The Lucide icon name for an asset type, drawn when its SVG is not available. */\nexport function assetTypeToIcon(assetType: string | null | undefined): string {\n  const key = assetType?.toLowerCase();\n  if (!key || !Object.hasOwn(ASSET_TYPE_LUCIDE_FALLBACK, key)) return \"file\";\n  return ASSET_TYPE_LUCIDE_FALLBACK[key] ?? \"file\";\n}\n\n"],"names":["ASSET_TYPE_ICON_NAMES","DEFAULT_ASSET_TYPE_ICON"],"mappings":"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"}
+{"version":3,"file":"asset-type-icons.cjs","sources":["../../../../../../src/chat-ui/mentions/suggestions/data/sources/asset-type-icons.ts"],"sourcesContent":["/**\n * Athena's asset-type icons: the SVG Olympus draws for each asset type.\n *\n * The type → icon table is Olympus's own: `ASSET_TYPE_ICON_NAMES`\n * (`asset-type-icon-names.generated.ts`), generated from its\n * `AthenaTypeToThumb` by Olympus's parity test, which writes the same table\n * into `@athenaintel/sheets` and fails when either drifts. So the `@` menu, the\n * mention chips and the drive cards draw the icon Olympus draws for every type.\n *\n * Where the SVGs load from:\n * - type glyphs (`ic-…`): a host's own copy when it names one with\n *   `configureAssetIconBasePath` (the Chrome extension), else the Athena web\n *   app the chat talks to (`appUrl`, the provider's: `useAssetIconAppUrl`),\n *   which serves the public files Olympus draws at `<appUrl>/assets/icons/files/`;\n * - brand logos (Power BI, Slack, Gmail, Outlook) sit in `apps/` beside them:\n *   from that app when the chat names one (a host's copy may carry only the\n *   glyphs), else beside the host's copy.\n *\n * With neither there is no SVG, and callers draw the type's Lucide icon\n * (`assetTypeToIcon`). `MentionIcon`, the chips and the drive cards also fall\n * back to it when an SVG cannot load (a strict CSP, offline).\n */\n\nimport { athenaLinkAppUrl } from \"../../../../../lib/athena-urls\";\nimport {\n  ASSET_TYPE_ICON_NAMES,\n  DEFAULT_ASSET_TYPE_ICON,\n} from \"./asset-type-icon-names.generated\";\n\nlet hostIconBasePath: string | null = null;\n\n/**\n * Point the asset-type icons at the host's own copy of Olympus's\n * `assets/icons/files/` SVGs. `basePath` is resolved against the host\n * document; a trailing \"/\" is added when the caller omits it. `null` drops the\n * host copy: the icons then load from the Athena web app the chat talks to.\n */\nexport function configureAssetIconBasePath({\n  basePath,\n}: {\n  basePath: string | null;\n}): void {\n  hostIconBasePath = basePath ? basePath.replace(/\\/*$/, \"/\") : null;\n}\n\nfunction currentPageOrigin(): string | null {\n  return typeof window === \"undefined\" ? null : window.location.origin;\n}\n\n/**\n * The Athena web app whose icons a chat draws: the provider's `appUrl`,\n * except in an app a computer serves, where Marathon's `/_athena/auth` mints\n * `appUrl` as the app's own origin (which serves no Athena icons) and the\n * deployment's frontend serves them, as for \"Open in Athena\" links\n * (`athenaLinkAppUrl`). Null without an `appUrl`.\n */\nexport function assetIconAppUrl({\n  appUrl,\n  backendUrl,\n  pageOrigin = currentPageOrigin(),\n}: {\n  appUrl: string | null | undefined;\n  backendUrl: string | null | undefined;\n  pageOrigin?: string | null;\n}): string | null {\n  if (!appUrl) return null;\n  return athenaLinkAppUrl({ appUrl, backendUrl: backendUrl ?? \"\", pageOrigin });\n}\n\n/** Where the Athena web app at `appUrl` serves the asset-type SVGs; null for an unusable URL. */\nexport function athenaAppAssetIconBasePath({\n  appUrl,\n}: {\n  appUrl: string | null | undefined;\n}): string | null {\n  if (!appUrl?.trim()) return null;\n  try {\n    const base = new URL(\"/assets/icons/files/\", appUrl);\n    return base.protocol === \"https:\" || base.protocol === \"http:\"\n      ? base.toString()\n      : null;\n  } catch {\n    return null;\n  }\n}\n\nconst FILES_DIR = \"files/\";\n\n/** An icon's URL, from the host's copy or the chat's Athena web app (see the module doc). */\nfunction iconUrl({\n  icon,\n  appUrl,\n}: {\n  icon: string;\n  appUrl: string | null | undefined;\n}): string | undefined {\n  const appBasePath = athenaAppAssetIconBasePath({ appUrl });\n  if (/^ic[-_]/.test(icon)) {\n    const basePath = hostIconBasePath ?? appBasePath;\n    return basePath ? `${basePath}${icon}.svg` : undefined;\n  }\n  const filesBasePath = appBasePath ?? hostIconBasePath;\n  if (!filesBasePath) return undefined;\n  return filesBasePath.endsWith(`/${FILES_DIR}`)\n    ? `${filesBasePath.slice(0, -FILES_DIR.length)}apps/${icon}.svg`\n    : `${filesBasePath}${icon}.svg`;\n}\n\nfunction assetTypeIconName(assetType: string | null | undefined): string {\n  const key = assetType?.toLowerCase();\n  return key && Object.hasOwn(ASSET_TYPE_ICON_NAMES, key)\n    ? (ASSET_TYPE_ICON_NAMES[key] ?? DEFAULT_ASSET_TYPE_ICON)\n    : DEFAULT_ASSET_TYPE_ICON;\n}\n\n/**\n * The SVG URL of an asset type's icon, the one Olympus draws. `appUrl` is the\n * Athena web app the chat talks to (`useAssetIconAppUrl`); undefined when\n * neither it nor a host copy (`configureAssetIconBasePath`) is available.\n */\nexport function assetTypeToThumb(\n  assetType: string | null | undefined,\n  { appUrl }: { appUrl?: string | null } = {},\n): string | undefined {\n  return iconUrl({ icon: assetTypeIconName(assetType), appUrl });\n}\n\nconst EMAIL_ASSET_TYPES: ReadonlySet<string> = new Set([\n  \"email\",\n  \"email_draft\",\n  \"email_message\",\n  \"live_email_thread\",\n]);\n\n/** Whether rows of this type can draw their mailbox's logo (`emailProviderThumb`). */\nexport function isEmailAssetType(assetType: string | null | undefined): boolean {\n  return !!assetType && EMAIL_ASSET_TYPES.has(assetType.toLowerCase());\n}\n\nfunction recordOf(value: unknown): Record<string, unknown> | null {\n  return value && typeof value === \"object\" && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : null;\n}\n\nconst LANE_PREFIX = /^paragon_/;\nconst LANE_SUFFIX = /_(direct(_v\\d+)?|paragon|live)$/;\n\n/** Gmail or Outlook, from the provider an email asset records; null for any other or none. */\nfunction mailboxLogo(metadata: unknown): \"gmail\" | \"outlook\" | null {\n  const record = recordOf(metadata);\n  if (!record) return null;\n  const provider: unknown =\n    recordOf(record.liveAsset)?.provider ??\n    recordOf(record.email)?.provider ??\n    recordOf(record.email_draft)?.provider;\n  if (typeof provider !== \"string\") return null;\n  const name = provider.trim().toLowerCase().replace(LANE_PREFIX, \"\").replace(LANE_SUFFIX, \"\");\n  if (name === \"gmail\" || name === \"google\") return \"gmail\";\n  if (name === \"outlook\" || name === \"microsoft_graph\") return \"outlook\";\n  return null;\n}\n\n/**\n * The Gmail or Outlook logo for an email asset whose mailbox provider its\n * metadata records (`liveAsset.provider`, the `email` block agora writes\n * beside it, or a draft's `email_draft` block), as Olympus draws it;\n * undefined otherwise, for the type's mail icon.\n */\nexport function emailProviderThumb({\n  assetType,\n  metadata,\n  appUrl,\n}: {\n  assetType: string | null | undefined;\n  metadata: unknown;\n  /** The Athena web app the chat talks to (`useAssetIconAppUrl`). */\n  appUrl?: string | null;\n}): string | undefined {\n  if (!isEmailAssetType(assetType)) return undefined;\n  const logo = mailboxLogo(metadata);\n  return logo ? iconUrl({ icon: logo, appUrl }) : undefined;\n}\n\n/**\n * The Lucide icon (a `MentionIcon` name) drawn for an asset type when its SVG\n * is not available: no icon source, or the SVG failed to load.\n */\nconst ASSET_TYPE_LUCIDE_FALLBACK: Record<string, string> = {\n  aop: \"workflow\",\n  application: \"layout-grid\",\n  audio: \"headphones\",\n  automation: \"zap\",\n  browse_profile: \"globe\",\n  browse_session: \"globe\",\n  canvas: \"palette\",\n  catalog: \"database\",\n  collab_agent: \"bot\",\n  collab_source: \"database\",\n  collab_toolkit: \"package\",\n  collection: \"library\",\n  computer: \"monitor\",\n  dashboard: \"layout-dashboard\",\n  database: \"database\",\n  design_system: \"palette\",\n  desktop_session: \"monitor\",\n  device: \"smartphone\",\n  document: \"file-text\",\n  drive: \"hard-drive\",\n  email: \"mail\",\n  email_draft: \"mail\",\n  email_message: \"mail\",\n  environment: \"server\",\n  figure: \"chart-bar\",\n  folder: \"folder\",\n  gdrive_folder: \"folder\",\n  generic_doc: \"file-text\",\n  image: \"image\",\n  json: \"file-code\",\n  lakehouse_namespace: \"database\",\n  lakehouse_sync: \"workflow\",\n  lakehouse_table: \"table\",\n  live_calendar_event: \"calendar\",\n  live_email_thread: \"mail\",\n  markdown: \"file-text\",\n  meeting: \"video\",\n  mobile_session: \"smartphone\",\n  notebook: \"book-open\",\n  olympus_drive: \"hard-drive\",\n  pdf: \"file-text\",\n  person: \"user\",\n  phone_call: \"phone\",\n  playbook: \"book-open\",\n  policy: \"check-square\",\n  powerpoint_deck: \"presentation\",\n  pptx: \"presentation\",\n  presentation: \"presentation\",\n  presentation_pptx_studio: \"presentation\",\n  project: \"folder-kanban\",\n  python: \"file-code\",\n  query_snippet: \"database\",\n  script: \"file-code\",\n  secret: \"key\",\n  semantic_model: \"database\",\n  session: \"message-square\",\n  skill: \"sparkles\",\n  spreadsheet: \"sheet\",\n  table: \"table\",\n  transform_project: \"workflow\",\n  txt: \"file-text\",\n  user_interface: \"layout\",\n  video: \"video\",\n  video_session: \"video\",\n  voice_memo: \"mic\",\n  web_page: \"globe\",\n  word_document: \"file-text\",\n  yaml: \"file-code\",\n};\n\n/** The Lucide icon name for an asset type, drawn when its SVG is not available. */\nexport function assetTypeToIcon(assetType: string | null | undefined): string {\n  const key = assetType?.toLowerCase();\n  if (!key || !Object.hasOwn(ASSET_TYPE_LUCIDE_FALLBACK, key)) return \"file\";\n  return ASSET_TYPE_LUCIDE_FALLBACK[key] ?? \"file\";\n}\n\n"],"names":["athenaLinkAppUrl","ASSET_TYPE_ICON_NAMES","DEFAULT_ASSET_TYPE_ICON"],"mappings":"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"}

package/dist/chat-ui/mentions/suggestions/data/sources/asset-type-icons.d.ts

@@ -29,6 +29,18 @@
 export declare function configureAssetIconBasePath({ basePath, }: {
     basePath: string | null;
 }): void;
+/**
+ * The Athena web app whose icons a chat draws: the provider's `appUrl`,
+ * except in an app a computer serves, where Marathon's `/_athena/auth` mints
+ * `appUrl` as the app's own origin (which serves no Athena icons) and the
+ * deployment's frontend serves them, as for "Open in Athena" links
+ * (`athenaLinkAppUrl`). Null without an `appUrl`.
+ */
+export declare function assetIconAppUrl({ appUrl, backendUrl, pageOrigin, }: {
+    appUrl: string | null | undefined;
+    backendUrl: string | null | undefined;
+    pageOrigin?: string | null;
+}): string | null;
 /** Where the Athena web app at `appUrl` serves the asset-type SVGs; null for an unusable URL. */
 export declare function athenaAppAssetIconBasePath({ appUrl, }: {
     appUrl: string | null | undefined;

package/dist/chat-ui/mentions/suggestions/data/sources/asset-type-icons.js

@@ -1,3 +1,4 @@
+import { athenaLinkAppUrl } from "../../../../../lib/athena-urls.js";
 import { ASSET_TYPE_ICON_NAMES, DEFAULT_ASSET_TYPE_ICON } from "./asset-type-icon-names.generated.js";
 let hostIconBasePath = null;
 function configureAssetIconBasePath({
@@ -5,6 +6,17 @@ function configureAssetIconBasePath({
 }) {
   hostIconBasePath = basePath ? basePath.replace(/\/*$/, "/") : null;
 }
+function currentPageOrigin() {
+  return typeof window === "undefined" ? null : window.location.origin;
+}
+function assetIconAppUrl({
+  appUrl,
+  backendUrl,
+  pageOrigin = currentPageOrigin()
+}) {
+  if (!appUrl) return null;
+  return athenaLinkAppUrl({ appUrl, backendUrl: backendUrl ?? "", pageOrigin });
+}
 function athenaAppAssetIconBasePath({
   appUrl
 }) {
@@ -147,6 +159,7 @@ function assetTypeToIcon(assetType) {
   return ASSET_TYPE_LUCIDE_FALLBACK[key] ?? "file";
 }
 export {
+  assetIconAppUrl,
   assetTypeToIcon,
   assetTypeToThumb,
   athenaAppAssetIconBasePath,