@athenaintel/react 0.16.3 → 0.18.0

package/README.md

@@ -50,47 +50,37 @@ function App() {
 </AthenaProvider>
 ```
 
-`config` accepts `apiKey`, `token`, `apiUrl`, `backendUrl`, `appUrl`, `trustedParentOrigins`, `environment`, `transport`, and `statewireSyncUrl`. Top-level `apiKey`, `token`, `apiUrl`, `backendUrl`, `appUrl`, and `environment` props remain supported as compatibility aliases, but `config` is now the preferred API.
+`config` accepts `apiKey`, `token`, `getToken`, `apiUrl`, `backendUrl`, `appUrl`, `statewireSyncUrl`, `trustedParentOrigins`, `environment`, `extraRunConfig`, and `posthog`. Top-level `apiKey`, `token`, `apiUrl`, `backendUrl`, `appUrl`, and `environment` props remain supported as compatibility aliases, but `config` is now the preferred API.
 
 If `config.appUrl` is omitted, the provider resolves it from the parent bridge or from the matching Athena environment defaults. Known Athena staging and production `apiUrl` and `backendUrl` values automatically fall back to the corresponding frontend origin.
 
 Use `trustedParentOrigins` when the SDK runs inside an iframe on a private-cloud or custom parent domain and you want to explicitly allow postMessage auth/config from that parent.
 
-## Statewire Transport (default as of 0.12.0)
-
-Statewire is the default chat transport: the SDK attaches to the deep-agent
-statewire sync host, so the thread is hosted server-side and replicated live —
-history, reconnect, run scheduling, mid-run queueing, HITL approvals, and
-client tools (for recognized SDK hosts, e.g. computer-asset `app_id`s) all
-come from the server snapshot. Pass `transport: 'legacy'` to opt a deployment
-back onto the legacy Iris `/api/chat` stream:
-
-```tsx
-<AthenaProvider config={{ environment: 'staging', transport: 'legacy' }}>
-  <AthenaChat />
-</AthenaProvider>
-```
-
-**Migrating from ≤0.11.x (legacy default):**
-
-- Threads are transport-scoped: conversations created on the legacy transport
-  are read-only from statewire (and vice versa). Users keep their history but
-  continue in new threads.
-- The statewire runtime applies the deep-agent model default when no `model`
-  prop is set; pin `model` explicitly if you depended on the legacy default.
-- The `agent` prop's legacy agent names are not honored on statewire; use
-  `collab_agent:<id>` refs (with `transport: 'statewire'` semantics) or the
-  default agent.
-
-The sync endpoint defaults to the effective `apiUrl` host + `/v2/threads`
-(e.g. staging resolves to `https://iris.stg.athenaintel.com/v2/threads`, the
-same statewire base the mobile app and Chrome extension ship); pass
-`statewireSyncUrl` to override it for custom hosts whose sync mount lives on
-a different origin. If neither yields a URL (e.g. an unparseable custom
-`apiUrl`), the provider throws instead of falling back to an Athena default —
-credentials are never sent to a host you didn't configure. Auth reuses the
-provider's existing credential plumbing: tokens ride `Authorization: Bearer`
-and API keys ride `X-API-KEY`.
+## Transport (statewire only, as of 0.18.0)
+
+The SDK speaks one chat transport: **statewire**. The provider attaches to the
+deep-agent statewire sync host at `<statewireSyncUrl>/<threadId>`, so the
+thread is hosted server-side and replicated live — history, reconnect, run
+scheduling, mid-run queueing, HITL approvals, and client tools (for recognized
+SDK hosts, e.g. computer-asset `app_id`s) all come from the server snapshot.
+
+The legacy Iris `/api/chat` assistant-transport leg was deleted in 0.18.0
+along with the `transport` prop — there is nothing to opt back onto. See
+[Migrating from 0.17](#migrating-from-017).
+
+The sync endpoint resolves in this order: an explicit `statewireSyncUrl`; the
+`statewireSyncUrl` the host environment supplies (a Marathon-served computer
+asset mints it from `/_athena/auth` alongside `backendBaseUrl`, the bare Agora
+base — a trusted parent iframe can post the same fields); then the effective
+`apiUrl` host + `/v2/threads` (e.g. staging resolves to
+`https://iris.stg.athenaintel.com/v2/threads`, the same statewire base the
+mobile app and Chrome extension ship). Pass `statewireSyncUrl` to pin a custom
+host whose sync mount lives on a different origin. If nothing yields a URL
+(e.g. an unparseable custom `apiUrl`), the provider throws instead of falling
+back to an Athena default — credentials are never sent to a host you didn't
+configure. Hosts that predate the minted statewire fields keep working through
+the `apiUrl` derivation. Auth reuses the provider's existing credential
+plumbing: tokens ride `Authorization: Bearer` and API keys ride `X-API-KEY`.
 
 What the statewire transport wires up in `AthenaChat`:
 
@@ -109,17 +99,64 @@ What the statewire transport wires up in `AthenaChat`:
   run's steer lane.
 - **Errors and connection state:** transport errors (send rejections,
   paywall refusals) render as a dismissible banner; a degraded connection
-  shows a reconnect strip; a read-only pre-cutover thread shows a read-only
-  notice. Custom hosts can read all of it via `useAthenaStatewireLifecycle`.
-- **Thread list:** `enableThreadList` works with statewire. The list is the
-  same persisted Agora session list; switching threads re-attaches the
-  statewire session to the selected thread. `ThreadList` and
-  `useAthenaThreadManager` work in both modes.
-
-Remaining limitations: on statewire the `agent` prop only accepts
-`collab_agent:<asset_id>` refs (see below) — any other value is ignored,
-because the statewire host always runs the Athena deep agent. `model`
-defaults to the deep-agent default model unless a collab agent supplies one.
+  shows a reconnect strip; a send into a thread created by the retired legacy
+  runtime is refused with a dismissible read-only notice (start a new chat).
+  Custom hosts can read all of it via `useAthenaStatewireLifecycle`.
+- **Thread list:** `enableThreadList` provides the persisted Agora session
+  list; switching threads re-attaches the statewire session to the selected
+  thread. `ThreadList`, `useAthenaThreadManager`, and `useRefreshThreadList`
+  read that state (and render nothing / return `null` without it).
+
+The `agent` prop only accepts `collab_agent:<asset_id>` refs (see below),
+because the statewire host always runs the Athena deep agent. **Any other
+non-blank value throws at first render** — it is a misconfiguration, and a
+silently ignored selector would let a deployment answer as the wrong agent.
+`model` defaults to the deep-agent default model (`DEFAULT_STATEWIRE_MODEL`)
+unless a collab agent supplies one.
+
+## Migrating from 0.17
+
+0.18.0 deletes the legacy assistant-transport leg. Every Athena chat client
+now speaks the native statewire wire, and the `TAG:JSON` transport over Iris
+`/api/chat` is being removed server-side, so the SDK no longer offers it.
+
+Removed from `<AthenaProvider>`:
+
+- `transport` prop and `config.transport` — statewire is the only lane.
+- `customToolConfigs` — it only ever reached the legacy leg (the deep-agent
+  runtime has no `custom_tool_configs` reader; MCP configuration is the parsed
+  `mcp_server_configs` key).
+- `agent` no longer accepts named agents (`athena_assist_agent`, …). The only
+  accepted shape is `collab_agent:<asset_id>`; anything else throws with a
+  message naming the prop and the accepted shape. Omit the prop to run the
+  Athena deep agent. Validate ahead of time with `resolveAgentProp({ agent })`.
+
+Removed exports:
+
+- `useAthenaRuntime`, `AthenaRuntimeConfig`, `DEFAULT_API_URL`,
+  `DEFAULT_BACKEND_URL` — use `useAthenaStatewireRuntime` /
+  `buildStatewireRunConfig` for a custom chat surface.
+- `ATHENA_TRANSPORTS`, `DEFAULT_ATHENA_TRANSPORT`, `resolveAthenaTransport`,
+  `allowsMidRunSend`, `AthenaTransport`, `ResolvedAthenaTransport`, and the
+  `transport` field on `AthenaConfig` (`useAthenaConfig()`).
+- `convertLangChainToThreadMessages`, `autoCloseInFlightSubgraphMessages`,
+  `PTC_SUBCALL_DID_NOT_COMPLETE_MESSAGE` — the LangChain message converter
+  existed only for the legacy wire.
+- `StatewireLegacyReadOnlyBanner` (rendered nothing since 0.17) and the
+  no-op `onLegacyReadOnly` option of `useAthenaStatewireRuntime`. The
+  residual `legacy_thread_read_only` 409 still surfaces through
+  `StatewireErrorBanner` / `useAthenaStatewireLifecycle`.
+- `useAthenaThreadListAdapter` (the assistant-ui remote-thread-list adapter).
+  `useRefreshThreadList`, `useAthenaThreadId`, and `AthenaThreadIdContext`
+  remain and read the statewire thread-list state.
+- Error codes `stream_failed` and `config_ignored`; diagnostics events
+  `stream.connected` and `stream.error`. `sdk.transport` still fires (always
+  `statewire`).
+
+Unchanged: `apiUrl`/`backendUrl` (explicit, host-minted, or from
+`environment`) — `apiUrl`'s origin still derives the statewire sync mount when
+`statewireSyncUrl` is not set, and `backendUrl` is still the Agora REST base
+for thread lists, uploads, and asset embeds.
 
 ## Collab Agents
 
@@ -129,7 +166,6 @@ the provider at one and the chat runs **as** that agent:
 
 ```tsx
 <AthenaProvider
-  transport="statewire"
   agent="collab_agent:asset_432af46f-293d-480b-a518-30b1f42a9ef7"
   channel="askbob_web"
 >
@@ -146,7 +182,10 @@ run the agent's base configuration.
 
 ### Requirements
 
-- **`transport="statewire"`.** The legacy transport ignores `collab_agent:` refs.
+- **The ref is the only accepted `agent` shape.** `collab_agent:<asset_id>`
+  selects the agent; omitting `agent` (or a blank string) runs the Athena deep
+  agent; any other value throws at render (`resolveAgentProp` is the same check,
+  exported for hosts that validate configuration up front).
 - **Publish the agent.** Resolution reads the *published* snapshot, not the
   live draft, so a channel that exists only in the editor is rejected with
   `collab_agent_channel_unknown`.
@@ -163,7 +202,6 @@ returns a plausible answer using your config instead of theirs.
 ```tsx
 // ❌ the agent's prompt, model, and tools are all discarded
 <AthenaProvider
-  transport="statewire"
   agent="collab_agent:asset_1234"
   model="claude-opus-4-6"
   systemPrompt="You are a helpful assistant."
@@ -171,7 +209,7 @@ returns a plausible answer using your config instead of theirs.
 />
 
 // ✅ the agent's own configuration wins
-<AthenaProvider transport="statewire" agent="collab_agent:asset_1234" />
+<AthenaProvider agent="collab_agent:asset_1234" />
 ```
 
 Pass them only when you deliberately want to override the agent — an explicit

package/dist/AthenaContext-B1QMhIP-.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"AthenaContext-B1QMhIP-.cjs","sources":["../src/provider/AthenaContext.ts"],"sourcesContent":["import { createContext, useContext } from 'react';\nimport type { AthenaTransport } from '../runtime/transport';\nimport type { AthenaProviderConfig } from './config';\nimport type { AthenaCitationLinkOptions, AthenaLinkClickOptions } from './citation-links';\n\nexport interface AthenaConfig extends Pick<AthenaProviderConfig, 'apiKey' | 'token'> {\n  backendUrl: string;\n  appUrl: string;\n  enabledToolkits: string[];\n  /** Effective chat transport — the lane the provider actually mounted (the\n   *  SDK defaults to 'statewire'; see `DEFAULT_ATHENA_TRANSPORT`). Optional\n   *  only so hand-built `AthenaConfig` literals keep compiling; capability\n   *  gates treat an absent value as the conservative legacy lane (e.g.\n   *  `allowsMidRunSend(undefined)` is false). */\n  transport?: AthenaTransport;\n  linkClicks?: AthenaLinkClickOptions;\n  citationLinks?: AthenaCitationLinkOptions;\n}\n\nexport const AthenaContext = createContext<AthenaConfig | null>(null);\n\nexport function useAthenaConfig(): AthenaConfig {\n  const ctx = useContext(AthenaContext);\n  if (!ctx) {\n    throw new Error('[AthenaSDK] useAthenaConfig must be used within <AthenaProvider>');\n  }\n  return ctx;\n}\n"],"names":["createContext","useContext"],"mappings":";;AAmBO,MAAM,gBAAgBA,MAAAA,cAAmC,IAAI;AAE7D,SAAS,kBAAgC;AAC9C,QAAM,MAAMC,MAAAA,WAAW,aAAa;AACpC,MAAI,CAAC,KAAK;AACR,UAAM,IAAI,MAAM,kEAAkE;AAAA,EACpF;AACA,SAAO;AACT;;;"}
+{"version":3,"file":"AthenaContext-B1QMhIP-.cjs","sources":["../src/provider/AthenaContext.ts"],"sourcesContent":["import { createContext, useContext } from 'react';\nimport type { AthenaProviderConfig } from './config';\nimport type { AthenaCitationLinkOptions, AthenaLinkClickOptions } from './citation-links';\n\nexport interface AthenaConfig extends Pick<AthenaProviderConfig, 'apiKey' | 'token'> {\n  backendUrl: string;\n  appUrl: string;\n  enabledToolkits: string[];\n  linkClicks?: AthenaLinkClickOptions;\n  citationLinks?: AthenaCitationLinkOptions;\n}\n\nexport const AthenaContext = createContext<AthenaConfig | null>(null);\n\nexport function useAthenaConfig(): AthenaConfig {\n  const ctx = useContext(AthenaContext);\n  if (!ctx) {\n    throw new Error('[AthenaSDK] useAthenaConfig must be used within <AthenaProvider>');\n  }\n  return ctx;\n}\n"],"names":["createContext","useContext"],"mappings":";;AAYO,MAAM,gBAAgBA,MAAAA,cAAmC,IAAI;AAE7D,SAAS,kBAAgC;AAC9C,QAAM,MAAMC,MAAAA,WAAW,aAAa;AACpC,MAAI,CAAC,KAAK;AACR,UAAM,IAAI,MAAM,kEAAkE;AAAA,EACpF;AACA,SAAO;AACT;;;"}

package/dist/AthenaContext-MOslgOmE.js.map

@@ -1 +1 @@
-{"version":3,"file":"AthenaContext-MOslgOmE.js","sources":["../src/provider/AthenaContext.ts"],"sourcesContent":["import { createContext, useContext } from 'react';\nimport type { AthenaTransport } from '../runtime/transport';\nimport type { AthenaProviderConfig } from './config';\nimport type { AthenaCitationLinkOptions, AthenaLinkClickOptions } from './citation-links';\n\nexport interface AthenaConfig extends Pick<AthenaProviderConfig, 'apiKey' | 'token'> {\n  backendUrl: string;\n  appUrl: string;\n  enabledToolkits: string[];\n  /** Effective chat transport — the lane the provider actually mounted (the\n   *  SDK defaults to 'statewire'; see `DEFAULT_ATHENA_TRANSPORT`). Optional\n   *  only so hand-built `AthenaConfig` literals keep compiling; capability\n   *  gates treat an absent value as the conservative legacy lane (e.g.\n   *  `allowsMidRunSend(undefined)` is false). */\n  transport?: AthenaTransport;\n  linkClicks?: AthenaLinkClickOptions;\n  citationLinks?: AthenaCitationLinkOptions;\n}\n\nexport const AthenaContext = createContext<AthenaConfig | null>(null);\n\nexport function useAthenaConfig(): AthenaConfig {\n  const ctx = useContext(AthenaContext);\n  if (!ctx) {\n    throw new Error('[AthenaSDK] useAthenaConfig must be used within <AthenaProvider>');\n  }\n  return ctx;\n}\n"],"names":[],"mappings":";AAmBO,MAAM,gBAAgB,cAAmC,IAAI;AAE7D,SAAS,kBAAgC;AAC9C,QAAM,MAAM,WAAW,aAAa;AACpC,MAAI,CAAC,KAAK;AACR,UAAM,IAAI,MAAM,kEAAkE;AAAA,EACpF;AACA,SAAO;AACT;"}
+{"version":3,"file":"AthenaContext-MOslgOmE.js","sources":["../src/provider/AthenaContext.ts"],"sourcesContent":["import { createContext, useContext } from 'react';\nimport type { AthenaProviderConfig } from './config';\nimport type { AthenaCitationLinkOptions, AthenaLinkClickOptions } from './citation-links';\n\nexport interface AthenaConfig extends Pick<AthenaProviderConfig, 'apiKey' | 'token'> {\n  backendUrl: string;\n  appUrl: string;\n  enabledToolkits: string[];\n  linkClicks?: AthenaLinkClickOptions;\n  citationLinks?: AthenaCitationLinkOptions;\n}\n\nexport const AthenaContext = createContext<AthenaConfig | null>(null);\n\nexport function useAthenaConfig(): AthenaConfig {\n  const ctx = useContext(AthenaContext);\n  if (!ctx) {\n    throw new Error('[AthenaSDK] useAthenaConfig must be used within <AthenaProvider>');\n  }\n  return ctx;\n}\n"],"names":[],"mappings":";AAYO,MAAM,gBAAgB,cAAmC,IAAI;AAE7D,SAAS,kBAAgC;AAC9C,QAAM,MAAM,WAAW,aAAa;AACpC,MAAI,CAAC,KAAK;AACR,UAAM,IAAI,MAAM,kEAAkE;AAAA,EACpF;AACA,SAAO;AACT;"}

package/dist/chat/statewire-banners.d.ts

@@ -1,17 +1,13 @@
 import type { FC } from 'react';
 /**
- * Dismissible transport-error banner for statewire mode: send rejections,
- * paywall refusals, and command failures that would otherwise vanish into
- * the console after the composer already cleared. Renders nothing on the
- * legacy transport.
+ * Dismissible transport-error banner: send rejections (including the
+ * pre-cutover-thread dispatch fence's 409), paywall refusals, and command
+ * failures that would otherwise vanish into the console after the composer
+ * already cleared. Renders nothing outside `AthenaProvider`.
  */
 export declare const StatewireErrorBanner: FC;
 /**
  * Degraded-connection strip: shown only while the statewire channel is
- * reconnecting or gone, with a manual reconnect affordance when the
- * transport exposes one. Healthy states render nothing.
+ * degraded, with a manual reconnect affordance when the transport exposes one.
  */
 export declare const StatewireConnectionBanner: FC;
-/** Read-only notice for pre-cutover threads whose history lives under the
- *  legacy runtime; the server fences dispatch into them. */
-export declare const StatewireLegacyReadOnlyBanner: FC;

package/dist/chat-ui/index.d.ts

@@ -36,3 +36,6 @@ export { UserEditComposer } from "./messages/user-edit-composer";
 export { MessageActionsReadOnlyProvider, useMessageActionsReadOnly, } from "./messages/message-actions-config";
 export { TextShimmerLoader, ThreadRunningIndicator, } from "./messages/running-indicator";
 export { SignInCard, SignInConsent, SignInFallbackSection, SignInSecondaryButton, SignInSelect, SignInTextField, } from "./auth/sign-in-card";
+export { RuntimeMessageCard, type RuntimeMessageCardProps } from "./messages/runtime-message";
+export { ContinuePill } from "./messages/continue-pill";
+export { StatewireContinueRunAffordance, StatewireContinueRunButton, type StatewireContinueRunButtonProps, StatewireRunEndedFooter, type StatewireRunEndedFooterProps, } from "./messages/statewire-continue-run";

package/dist/chat-ui/mentions/suggestions/data/api-client.d.ts

@@ -20,6 +20,30 @@ export declare function fetchGraphQL<T = any>(auth: MentionAuthContext, query: s
 export declare const SIMPLE_SEARCH_QUERY = "\n  query SimpleSearch($input: SimpleSearchRequestInput!) {\n    simpleSearch(input: $input) {\n      assets {\n        \n  id\n  title\n  athenaOriginalType\n  athenaConvertedType\n  parentFolderId\n  updatedAt\n  isFavorited\n  isArchived\n  isHidden\n\n      }\n      totalCount\n    }\n  }\n";
 export declare const PAGINATED_ASSETS_QUERY = "\n  query GetPaginatedAssetsForWorkspace(\n    $limit: Int!\n    $offset: Int!\n    $parentFolderId: String\n    $filterTypes: [String!]\n    $filterColumns: ColumnFilter\n  ) {\n    getPaginatedAssetsForWorkspace(\n      limit: $limit\n      offset: $offset\n      parentFolderId: $parentFolderId\n      filterTypes: $filterTypes\n      filterColumns: $filterColumns\n    ) {\n      \n  id\n  title\n  athenaOriginalType\n  athenaConvertedType\n  parentFolderId\n  updatedAt\n  isFavorited\n  isArchived\n  isHidden\n\n    }\n  }\n";
 export declare const WORKSPACE_MEMBERS_QUERY = "\n  query GetUsersInWorkspace($workspaceId: String!) {\n    getUsersInWorkspace(workspaceId: $workspaceId) {\n      id\n      email\n      firstName\n      lastName\n      isAdmin\n      avatarUrl\n    }\n  }\n";
+export declare const TOOL_CATALOG_QUERY = "\n  query MentionToolCatalog {\n    getToolkitToToolsMapping {\n      tools {\n        id\n        name\n        description\n        icon\n        adminOnly\n        isMentionable\n      }\n      toolkits {\n        name\n        displayName\n        description\n        icon\n        onlyAdmin\n        hideFromMenu\n        isMentionable\n      }\n    }\n  }\n";
+export interface ToolCatalogTool {
+    id: string;
+    name: string;
+    description: string | null;
+    icon: string;
+    adminOnly: boolean;
+    isMentionable: boolean;
+}
+export interface ToolCatalogToolkit {
+    name: string;
+    displayName: string;
+    description: string;
+    icon: string;
+    onlyAdmin: boolean;
+    hideFromMenu: boolean;
+    isMentionable: boolean;
+}
+export interface ToolCatalogResult {
+    getToolkitToToolsMapping: {
+        tools: ToolCatalogTool[];
+        toolkits: ToolCatalogToolkit[];
+    };
+}
 export interface AssetResult {
     id: string;
     title: string | null;

package/dist/chat-ui/mentions/suggestions/data/sources/index.d.ts

@@ -49,6 +49,11 @@ export interface TeamConfig {
     auth: MentionAuthContext;
 }
 export declare const fetchTeam: SourceFn<TeamConfig>;
+export interface ToolCatalogConfig {
+    auth: MentionAuthContext;
+}
+export declare const fetchTools: SourceFn<ToolCatalogConfig>;
+export declare const fetchToolkits: SourceFn<ToolCatalogConfig>;
 export interface DrivesConfig {
     auth: MentionAuthContext;
 }

package/dist/chat-ui/mentions/suggestions/data/use-mention-suggestions.d.ts

@@ -21,7 +21,7 @@ export type MentionSuggestionsStore = Store<MentionSuggestionsStoreState>;
 /**
  * All mention menu categories, in display order.
  */
-export declare const ROOT_MENTION_CATEGORIES: readonly ["favorites", "assets", "projects", "browse_profiles", "folders", "team", "drives"];
+export declare const ROOT_MENTION_CATEGORIES: readonly ["favorites", "assets", "projects", "browse_profiles", "folders", "tools", "toolkits", "team", "drives"];
 export type MentionRootCategory = (typeof ROOT_MENTION_CATEGORIES)[number];
 /**
  * Creates a stable MentionSuggestionsStore.

package/dist/chat-ui/messages/continue-pill.d.ts

@@ -0,0 +1,13 @@
+import { type FC } from "react";
+/**
+ * Shared Continue action for recoverable chat states.
+ *
+ * The dispatch waits for the exit animation to paint. If the owning runtime
+ * does not leave the recoverable state (for example, the command is rejected),
+ * the control resets so the user can try again.
+ */
+export declare const ContinuePill: FC<{
+    onClick: () => void;
+    ariaLabel: string;
+    dataTestId?: string;
+}>;

package/dist/chat-ui/messages/message-components.d.ts

@@ -1,6 +1,6 @@
 import { type ToolCallMessagePartComponent } from "@assistant-ui/react";
 import "@assistant-ui/react-markdown/styles/dot.css";
-import type { ButtonHTMLAttributes, FC, ReactNode } from "react";
+import { type ButtonHTMLAttributes, type FC, type ReactNode } from "react";
 import type { ComposerAction } from "../composer/composer-action";
 export declare function IconButton({ children, tooltip, className, ...props }: ButtonHTMLAttributes<HTMLButtonElement> & {
     tooltip: string;
@@ -22,12 +22,17 @@ export interface CreateAssistantMessageOptions {
      * timelines supply their own; the default renders markdown and tool cards.
      */
     content?: FC;
+    /**
+     * Inline affordance rendered inside a runtime-ending card (e.g. a Continue
+     * button). Hosts without one leave it unset.
+     */
+    runtimeMessageAction?: ReactNode;
 }
 /**
  * Builds the assistant bubble. Call this once per host (memoized on its
  * inputs) so the returned component identity stays stable across renders.
  */
-export declare function createAssistantMessage({ toolFallback, extraActions, content: Content, }: CreateAssistantMessageOptions): FC;
+export declare function createAssistantMessage({ toolFallback, extraActions, content: Content, runtimeMessageAction, }: CreateAssistantMessageOptions): FC;
 /** Panel chrome: the thread card and the header row that sits inside it. */
 export declare const THREAD_PANEL_CLASS = "m-1 flex min-h-0 flex-1 flex-col overflow-hidden rounded-[18px] border border-dashed border-amber-500 bg-background shadow-[0_1px_10px_rgba(54,45,33,0.08)]";
 export declare const THREAD_HEADER_CLASS = "flex items-center justify-between gap-2 px-3 py-2";

package/dist/chat-ui/messages/runtime-message.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Shared DOM rendering for a runtime ending (see
+ * `@athenaintel/agent-runtime`'s `runtime-messages.ts`): the status row for a
+ * stop / pause / failure, and the banner that frames a handoff summary. Hosts
+ * that build their assistant row with `createAssistantMessage` get these for
+ * free; hosts with their own row (Olympus, mobile) render their own presenter
+ * from the same {@link AthenaRuntimeMessage} so the taxonomy cannot drift.
+ */
+import { type AthenaRuntimeMessage } from "@athenaintel/agent-runtime";
+import type { FC, ReactNode } from "react";
+export interface RuntimeMessageCardProps {
+    message: AthenaRuntimeMessage;
+    /** An inline affordance (e.g. a Continue button) rendered inside the card. */
+    action?: ReactNode;
+    className?: string;
+}
+/**
+ * The status row for a runtime ending. For `stopped` / `paused` / `failed` it
+ * replaces the assistant bubble; for `handoff` it sits above the closing
+ * summary, which keeps rendering as ordinary prose.
+ */
+export declare const RuntimeMessageCard: FC<RuntimeMessageCardProps>;

package/dist/chat-ui/messages/statewire-continue-run.d.ts

@@ -0,0 +1,41 @@
+import type { ReactElement } from "react";
+export interface StatewireContinueRunButtonProps {
+    /**
+     * Also offer Continue while the thread projects `ready`. An old snapshot
+     * can report a resting thread whose last persisted ending is still
+     * continuable; the marker row that mounts this button knows that.
+     */
+    allowReadyFallback?: boolean;
+}
+/**
+ * Dispatches the bare `run/continue` for the live Statewire thread — the
+ * heal-then-continue recovery for stopped, errored, and pod-drained runs. The
+ * command is exactly what the library's `onResume` emits, so it inherits the
+ * optimistic running-flip (the pill unmounts once the dispatch is accepted)
+ * and routes rejections to the runtime's shared `onError` policy.
+ *
+ * Requires `capabilities.continue` on the host thread and a statewire aui
+ * scope (throws outside one, like every `useStatewire*` hook).
+ */
+export declare function StatewireContinueRunButton({ allowReadyFallback, }?: StatewireContinueRunButtonProps): ReactElement | null;
+/**
+ * Recovery affordance for the latest persisted stopped/failed run marker,
+ * for the `runtimeMessageAction` slot of `createAssistantMessage`.
+ *
+ * Marker messages remain in history forever, so only the current last message
+ * may continue. The extras guard keeps Statewire hooks out of read-only or
+ * legacy runtimes where they would throw.
+ */
+export declare function StatewireContinueRunAffordance(): ReactElement | null;
+export interface StatewireRunEndedFooterProps {
+    /** Merged onto the recovery card's default classes. */
+    className?: string;
+}
+/**
+ * Recovery row for a settled run whose persisted ending is no longer the
+ * transcript tail — rendered after the messages (`renderMessages`). Rewinds,
+ * compaction, and older snapshots can all leave the durable run state
+ * recoverable without a marker row that owns the action. Renders nothing on
+ * legacy (non-statewire) threads.
+ */
+export declare function StatewireRunEndedFooter({ className, }?: StatewireRunEndedFooterProps): ReactElement | null;

package/dist/chat-ui/thread/chat-composer-dock.d.ts

@@ -23,7 +23,7 @@ export interface ChatComposerDockProps {
     editor: ReactNode;
     /** Toolbar contents before the spacer (attach buttons, pickers). */
     toolbarStart?: ReactNode;
-    /** Toolbar contents after the spacer (voice, capture, send/stop). */
+    /** Toolbar contents after the spacer (voice and send/stop controls). */
     toolbarEnd: ReactNode;
 }
 /**