@athenaintel/react 0.18.0 → 0.19.0

package/README.md

@@ -81,6 +81,11 @@ 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`.
+A `getToken` resolver is called with `{ force: true }` right after the sync
+host refuses a credential, so a caching getter must mint a fresh token then;
+the persisted command lane is scoped to the signed-in user as well as the
+host, so a shared browser never resends one user's pending sends under the
+next user's token.
 
 What the statewire transport wires up in `AthenaChat`:
 
@@ -89,14 +94,47 @@ What the statewire transport wires up in `AthenaChat`:
   (or Continue for a generic pause) and resumes the run through the statewire
   `run/input` command. Hosts that build their own thread UI should mount the
   exported `StatewireApprovalCard` themselves — without it an approval-gated
-  run stays parked with no way to answer it.
+  run stays parked with no way to answer it. Its `renderDetails`,
+  `isHandledElsewhere`, and `readOnly` seams take host-specific review UIs,
+  requests another surface answers, and viewers without edit rights; the
+  headless `useStatewireApprovalRequest` behind it is exported for hosts with
+  their own decision UI.
 - **Frontend tools:** tools in `frontendTools` with a local `execute` are
   declared to the backend as `client_tools` and executed by the mounted
   client-tool bridge, which resumes the run with each tool's result.
 - **Mid-run sends and the queue:** a message sent while a run is active
-  queues on the server. The queue panel above the composer lists queued
-  entries with remove and "Send now" (steer), plus Continue for a stopped
-  run's steer lane.
+  queues on the server. The queue panel above the composer
+  (`StatewireQueuedMessages`) lists queued entries with remove, "Send now"
+  (steer), Prioritize (`run/prioritize`), inline edit, and failed sends with
+  Retry/Discard, plus Continue for a stopped run's queue head; hosts can opt
+  into `autoContinue` for stranded queues and slot their own row renderer and
+  editor.
+- **Lean entries for hosts with their own composer:** `@athenaintel/react/chat-ui/statewire`
+  exports just the approval card, the queue tray, and the continue/run-ended
+  affordances (plus the runtime-message card and Continue pill they render),
+  and `@athenaintel/react/tools` exports the generic `ToolFallback` card with
+  its primitives (`ToolCard`, `ExpandableSection`, `NestedPtcMessages`) — so a
+  host that already ships its own composer and mention stack (Olympus) never
+  pulls the SDK's Tiptap graph into its build. Tool names, icons, categories,
+  and running copy come from the shared registry in
+  `@athenaintel/agent-runtime` (`getToolDisplayMeta`), and success/failure from
+  its `classifyToolResult`; the fallback takes host seams (`displayName`,
+  `icon`, `extraAction`, `notice`, `renderResult`, `onOpenAsset`,
+  `hideInternalIdArgs`) instead of being copied. `@athenaintel/react/super-grouping`
+  exports the grouped ("conversational") view of an assistant turn —
+  `SuperGroupingCard`, `SuperGroupingFinalText`, `CollapsibleGroup`, the
+  activity-timeline derivation, and the tool-based grouping function — with
+  slots for the host's text/tool renderers and controls (`renderHeaderActions`,
+  `renderRunningMeta`, `summaryDetails`, `waitingTools`, `expansionKey`), so
+  Olympus and the Chrome extension mount one card instead of copies.
+- **Olympus consumes the package, not the source.** `@athenaintel/react` is a
+  workspace dependency of Olympus, resolved through this package's `exports`
+  to the built `dist/` (the guarded `prepare` script builds it on a cold
+  `bun install`; `olympus/scripts/prepare-react-sdk.ts` rebuilds it before
+  `bun run ts` when sources changed; `scripts/typecheck-all.ts` emits the
+  declarations before the repo typecheck). While editing the SDK against a
+  running Olympus, run `bun run dev` here so the dist follows your edits. The
+  Chrome extension and Office add-in still alias the entries to source.
 - **Errors and connection state:** transport errors (send rejections,
   paywall refusals) render as a dismissible banner; a degraded connection
   shows a reconnect strip; a send into a thread created by the retired legacy
@@ -114,6 +152,70 @@ 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.
 
+## What's new in 0.19.0
+
+0.19.0 is a minor release with **no breaking changes**: every export that
+shipped in 0.18.0 is still exported under the same name from the same entry,
+and `<AthenaProvider>` / `<AthenaChat>` accept the same props. Bump the pin
+and re-install; there is nothing to migrate.
+
+- **Windowed history on every surface.** Each attach now declares a message
+  window (`ATHENA_SDK_MESSAGE_WINDOW`, 40 messages, sent as the
+  `x-athena-deep-agent-window` hello), so a long thread's first snapshot
+  carries the transcript's tail instead of every message. `<AthenaChat>`
+  mounts the new `StatewireHistoryEdge` row above the messages — "N earlier
+  messages", paged in as you scroll near the top (or on click) while the
+  reading position is kept — and cut tool outputs are fetched back for the
+  cards that show them. Hosts composing their own thread mount
+  `StatewireHistoryEdge` in `ChatThreadShell`'s `beforeMessages` slot (also
+  exported from `@athenaintel/react/chat-ui` and `/chat-ui/statewire`) and
+  read the tool-output store through `useStatewireToolOutputs`. Editing a
+  message below the loaded window resubmits with an anchored `run/edit`.
+- **One approval card, queue tray, and continue affordance.**
+  `StatewireApprovalCard` (`renderDetails`, `isHandledElsewhere`, `readOnly`),
+  `StatewireQueuedMessages` (`renderContent`, `renderEditor`, `autoContinue`,
+  `onEvent`), and the continue / run-ended affordances are the single
+  implementations Olympus, the Chrome extension, and the Office add-in mount;
+  the headless `useStatewireApprovalRequest` and `HITL_PENDING_RESUME_GRACE_MS`
+  are exported for hosts with their own decision UI. New lean entry:
+  `@athenaintel/react/chat-ui/statewire`.
+- **One tool display registry, result classifier, and fallback.**
+  `getToolDisplayMeta`, `classifyToolResult`, `isToolResultSuccess`,
+  `describeToolArgs`, `resultMessage`, `toolActiveLabel`, `toolCompletedLabel`
+  (re-exported from `@athenaintel/agent-runtime`), `TOOL_ICONS` / `toolIcon`,
+  the `ToolFallback` host seams (`ToolFallbackNotice`, `ToolFallbackOptions`,
+  `ToolFallbackContext`, …), `CopyToolSpecButton`, `InstallPackageToolUI`,
+  and `NestedPtcComponentsProvider` / `useNestedPtcComponents`. New lean
+  entry: `@athenaintel/react/tools`.
+- **Grouped activity card and timeline.** `SuperGroupingCard`,
+  `SuperGroupingFinalText`, `SuperGroupingProvider`, `CollapsibleGroup`,
+  `buildActivityTimeline`, `useActivityExpansion`,
+  `createToolBasedGroupingFunction`, `TOOLKIT_THEMES`, and their types are
+  exported; `<AthenaChat groupToolCalls>` renders through them. New lean
+  entry: `@athenaintel/react/super-grouping`.
+- **`rejected` is a first-class tool-result state.** A gated tool call the
+  user refused classifies as `{ state: 'rejected' }` (`ToolResultClassification`)
+  instead of an error, and reads as rejected on the tool card and in the
+  grouped timeline.
+- **Diagnostics instead of console noise.** Composer, tool-UI, and mention
+  failures now emit `composer.attachment.error`, `composer.cancel.error`,
+  `tools.schema.warning`, `tools.debug`, and `mentions.fetch.error` on the
+  diagnostics bus (`onDiagnostic` / `onError`, `__ATHENA_SDK__.diagnostics`)
+  rather than through `console.*`.
+- **`config.getToken` may be called with `{ force: true }`**
+  (`AthenaStatewireTokenGetter`) right after the statewire host refused the
+  previous credential; a getter that caches should mint a fresh token then.
+  Existing zero-argument getters keep working unchanged.
+- **Dependencies.** The assistant-ui family is pinned exactly on one release
+  train (`@assistant-ui/react` 0.15.17, `@assistant-ui/react-statewire`
+  0.24.0, `assistant-stream` 0.3.41, `statewire` 0.14.0); the SDK's internal
+  `zod` moved to v4 (it is not part of the public types).
+
+Moved, not renamed: `ToolCard`, `ExpandableSection`, `normalizeResult`,
+`truncate`, `formatToolName`, and `ToolStatus` now live in the tool
+primitives module and are exported from both `@athenaintel/react` (as before)
+and `@athenaintel/react/tools`.
+
 ## Migrating from 0.17
 
 0.18.0 deletes the legacy assistant-transport leg. Every Athena chat client