@athenaintel/react 0.42.2 → 0.43.0

package/README.md

@@ -883,6 +883,16 @@ Both use the same bearer / API key as session creation. The full recipe
 template skill `voice-session-guide.md`. `createAthenaVoiceSession` is also
 exported if you hold the bridge state yourself.
 
+## What's new in 0.43.0
+
+**Asset and citation chips look and read like Olympus's.** A chip is now Olympus's mention pill in your theme's colours (grey on the default theme, still legible on a dark one): the asset's icon, its name, then the cited place in brackets (`Q4 report [p.5]`). Like Olympus's chips, it looks the asset up and shows the asset's own title and its type's icon instead of the link's label and `type=`. The lookup is agora's `getAssetsByIds` with the chat's credentials, which returns only the assets the viewer may read. Chips that render together ask in one request. Each answer is cached for a minute per backend and per signed-in person or API key (TanStack Query, on the host's `QueryClient` when there is one); a credential that names neither shares nothing beyond its own chat. Until the answer arrives, and for an asset the viewer may not read, the chip keeps the link's label and `type=`. A chip asks only where the answer changes it: never for a repository file's catalog (the chip reads as the file either way) or for a session (agora would read its whole row, transcript ledgers included). A chip with no credential to send (no token, API key or session cookie) asks for nothing.
+
+**A repository file citation reads as the file and its lines, with GitHub's mark.** A citation of a GitHub repository's lines (`type=catalog&anchor=file_line_range`) now reads `route.ts:18-24` whatever label the model wrote: the repository's name, a long path, or a label in backticks. A long file name shortens before its lines do. The tooltip carries what the chip leaves out: the model's label when it says something else, the repository, the whole path and the cited passage.
+
+**A place is drawn once.** A label that already ends with its place (`Q4 report p.5`, `olympus/…/route.ts:18-24`) is no longer followed by the place again. Nothing to change in your app.
+
+Also first on npm in 0.43.0 (0.42.3 was tagged, not published): an asset link whose text markdown split shows its text, not `[object Object]` (#48739); a new chat's title poll waits for a session-list read already in flight (#48730); shared voice commands are scoped to their call (#48761).
+
 ## What's new in 0.42.2
 
 **A message one signed-in user queued is never sent as the next user who signs in to the same chat.** The chat keeps each conversation's unconfirmed commands in this browser under the signed-in user, so a reload can resend them. When the signed-in user changed while the chat stayed mounted (a sign-in provider of your own that signs a signed-out person in, or `AthenaSSOProvider` with `revalidateOnWindowFocus` picking up another account), the conversation moved to the new user's key and took the previous user's client id, command numbers and unsent commands with it. A message the previous user sent while offline, or that had not yet reached Athena, could then go out on the new user's connection, as the new user. With the chat connected at the time, the reverse happened: the new user's messages went out on the connection the previous user had opened, and Athena ran them as the previous user.

package/dist/agent-runtime/src/conversation-list-groups.d.ts

@@ -0,0 +1,74 @@
+import { type ConversationAttention } from "./conversation-list";
+/**
+ * Pure rules behind the session-list rows' attention affordances: Olympus's
+ * Sessions pane and Recent Conversations dropdown and Midas's sessions sidebar
+ * render the same indicator, next-action line and group placement from these,
+ * so the render tests stay thin and the surfaces cannot disagree
+ * (`docs/SESSIONS_LIST_GUIDE.md`, "Session attention").
+ */
+/** The fields a row needs to answer every rule here; a subset of `ConversationItem`. */
+export interface ConversationAttentionInput {
+    attention?: ConversationAttention | null;
+    runStatus: string | null;
+    sessionStatus: string | null;
+    state?: string | null;
+    nextAction?: string | null;
+    isFavorited?: boolean;
+    isUnread: boolean;
+    updatedAt: string;
+}
+/**
+ * The server-derived attention when the transport reports one Olympus knows,
+ * else the shared client fallback from the status planes — so a row from an
+ * older backend still reads `needs_you` on a human gate and `error` on a
+ * failed run.
+ */
+export declare function resolveConversationAttention(conversation: Pick<ConversationAttentionInput, "attention" | "runStatus" | "sessionStatus" | "state">): ConversationAttention | null;
+/**
+ * The one indicator a row shows, in precedence order: a pending action for
+ * the viewer beats a live run, which beats the unread dot, which beats
+ * "waiting on someone else", which beats a terminal error. `running` is the
+ * caller's resolved running state (the live stream signal wins for the open
+ * thread), not the attention field, so the spinner keeps today's behaviour.
+ */
+export type ConversationAttentionIndicator = "needs_you" | "running" | "unread" | "watching" | "error" | null;
+export declare function conversationAttentionIndicator({ attention, isRunning, isUnread, }: {
+    attention: ConversationAttention | null;
+    isRunning: boolean;
+    isUnread: boolean;
+}): ConversationAttentionIndicator;
+/** Tone of the next-action line, named after the design tokens that paint it. */
+export type ConversationNextActionTone = "warning" | "success" | "muted" | "destructive";
+export interface ConversationNextAction {
+    text: string;
+    tone: ConversationNextActionTone;
+}
+/**
+ * The row's second line when the server derived a next step: the text as
+ * sent (already ≤ 80 characters), toned by what the session asks — orange
+ * for `needs_you`, green for `ready`, red for `error`, muted otherwise.
+ * `null` when there is nothing to do, so the row shows its timestamp.
+ */
+export declare function conversationNextAction({ attention, nextAction, }: {
+    attention: ConversationAttention | null;
+    nextAction?: string | null;
+}): ConversationNextAction | null;
+export type ConversationTimeGroup = "Today" | "Yesterday" | "This Week" | "This Month" | "Older";
+/**
+ * Where a row lands in the Sessions pane: sessions that need the viewer
+ * first, then the viewer's pinned sessions, then everything else by when it
+ * last changed. A row appears once, in the FIRST group that applies.
+ */
+export type ConversationListGroup = "Needs you" | "Pinned" | ConversationTimeGroup;
+export declare const CONVERSATION_LIST_GROUP_ORDER: readonly ConversationListGroup[];
+export declare function conversationTimeGroup(dateStr: string, now?: Date): ConversationTimeGroup;
+export declare function conversationListGroupOf(conversation: ConversationAttentionInput, now?: Date): ConversationListGroup;
+export interface ConversationListSection<T extends ConversationAttentionInput> {
+    group: ConversationListGroup;
+    items: T[];
+}
+/**
+ * Sections in display order; empty groups are omitted and the list's own
+ * newest-first order is kept within each group.
+ */
+export declare function groupConversationsForList<T extends ConversationAttentionInput>(conversations: readonly T[], now?: Date): ConversationListSection<T>[];

package/dist/agent-runtime/src/index.d.ts

@@ -4,6 +4,7 @@ export { CLIENT_TOOL_INTERRUPT_SOURCE, clientToolCallArgs, type ClientToolCached
 export { CLIENT_TOOL_WRITE_DECLINED_MESSAGE, type ClientToolBridgeTool, type ClientToolCallSettledEvent, clientToolClaimKey, type ClientToolWriteConsentDecision, defaultMissingClientToolMessage, executeClientToolBatch, type ExecuteClientToolBatchOptions, isPendingClientToolRequest, jsonSafeClientToolResult, useStatewireClientToolBridge, type UseStatewireClientToolBridgeOptions, } from "./client-tool-bridge";
 export { conversationIndexFingerprint, conversationIndexId, conversationIndexUrlFromStatewireUrl, type ConversationIndexEntry, type ConversationWatchActivity, useConversationIndex, type UseConversationIndexOptions, type UseConversationIndexResult, watchActivityFingerprint, } from "./conversation-index";
 export { cancelConversationListCaches, CONVERSATION_ATTENTIONS, CONVERSATION_LIST_DEFAULT_SCOPE_KEY, CONVERSATION_LIST_QUERY_KEY_ROOT, type ConversationAttention, type ConversationAttentionSource, type ConversationListFetcher, type ConversationListFetchParams, type ConversationListFilter, type ConversationListPage, conversationListFilterKey, conversationListQueryKeys, type ConversationPullRequest, type ConversationSummary, type ConversationWake, deriveConversationAttention, invalidateConversationListCaches, isConversationRunning, mergeConversationIndexIntoPage, mergeConversationPages, normalizeConversationListFilter, patchConversationListCaches, patchConversationsInPage, prependConversationToPage, removeConversationFromListCaches, removeConversationFromPage, summaryFromConversationIndexEntry, } from "./conversation-list";
+export { CONVERSATION_LIST_GROUP_ORDER, type ConversationAttentionIndicator, type ConversationAttentionInput, type ConversationListGroup, type ConversationListSection, type ConversationNextAction, type ConversationNextActionTone, type ConversationTimeGroup, conversationAttentionIndicator, conversationListGroupOf, conversationNextAction, conversationTimeGroup, groupConversationsForList, resolveConversationAttention, } from "./conversation-list-groups";
 export { CATEGORY_EMOJI, defaultToolDisplayMeta, describeDelegation, describeNamed, describePackage, describePath, describeQuery, describeRange, describeSql, describeTable, describeToolArgs, describeUrl, formatToolName, getCategoryEmoji, getToolDisplayMeta, hasToolDisplayMeta, isInlineTool, knownToolNames, TOOL_DISPLAY_META, type ToolArgsDescriber, type ToolCategory, toolActiveLabel, toolCompletedLabel, type ToolDisplayMeta, type ToolDisplayMetaEntry, type ToolIconKey, toolStatusLabel, type ToolStatusLabelState, truncateLine, } from "./tool-metadata";
 export { classifyToolResult, isRecord, isRejectedToolResult, isToolResultSuccess, parseJsonRecord, readRejectedToolResult, type RejectedToolResult, resultMessage, resultRecord, stringField, type ToolCallStatusLike, toolFailure, type ToolFailure, type ToolResultClassification, type ToolResultState, } from "./tool-result";
 export { type ConversationListController, useConversationList, type UseConversationListOptions, } from "./use-conversation-list";

package/dist/agent-runtime/src/tool-metadata.cjs

@@ -105,14 +105,6 @@ const TOOL_DISPLAY_META = {
     emoji: "🔍",
     describe: describeQuery
   },
-  perplexity_search: {
-    displayName: "Web Search",
-    activeLabel: "Searching the web",
-    category: "Web",
-    icon: "search",
-    emoji: "🔍",
-    describe: describeQuery
-  },
   grounded_search: {
     displayName: "Grounded Search",
     activeLabel: "Searching",