@tangle-network/agent-app 0.45.62 → 0.45.64

package/dist/session-shell/command-palette.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Command palette — the React-free selection half of the Cmd/Ctrl+K surface
+ * (`/web-react` holds the rendered half, `CommandPalette`).
+ *
+ * Pure and import-free beyond this module's own types: no React, no DOM, no
+ * fuse.js. A route loader or a worker can build and rank the same items the
+ * browser renders.
+ *
+ * Domain stays a parameter. The palette knows two kinds of row — a SESSION the
+ * user can jump to and an ACTION the product offers (new chat, toggle theme,
+ * open settings) — and both arrive as data. What a selection DOES is the
+ * product's business; the shell only builds, ranks, and groups.
+ *
+ * Ranking is the documented ladder, not a fuzzy library: exact > prefix >
+ * word-prefix > substring (earlier index wins) > token-order, with keyword
+ * hits ranked a fixed step below the same hit on the label. Deterministic —
+ * no index-building, no async, same input always sorts the same way.
+ */
+import { type SessionSummary } from './index';
+/** A product-supplied palette action. `hint` is the right-aligned affordance
+ *  copy (a kbd chord, a route name) — rendered verbatim, never interpreted. */
+export interface CommandPaletteAction {
+    id: string;
+    label: string;
+    description?: string;
+    hint?: string;
+    /** Extra match vocabulary that never renders (`settings` matching
+     *  "preferences"). A keyword hit ranks below the same hit on the label. */
+    keywords?: string[];
+}
+/** One selectable row. `group` is the section header it renders under. */
+export interface CommandPaletteItem {
+    id: string;
+    group: string;
+    label: string;
+    description?: string;
+    hint?: string;
+    keywords?: string[];
+    /** Recency key (ISO-8601). Breaks score ties and orders the unfiltered
+     *  list recent-first. Rows without one sort below rows with one. */
+    recentAt?: string | null;
+}
+/** One rendered section: a header plus its rows, in first-seen group order. */
+export interface CommandPaletteGroup {
+    group: string;
+    items: CommandPaletteItem[];
+}
+export declare const COMMAND_PALETTE_SESSIONS_GROUP = "Sessions";
+export declare const COMMAND_PALETTE_ACTIONS_GROUP = "Actions";
+export interface BuildCommandPaletteItemsOptions {
+    sessions?: readonly SessionSummary[];
+    actions?: readonly CommandPaletteAction[];
+    /** Section label for sessions. Default "Sessions". */
+    sessionsLabel?: string;
+    /** Section label for actions. Default "Actions". */
+    actionsLabel?: string;
+    /** Placeholder title for an untitled session. */
+    untitledLabel?: string;
+}
+/**
+ * Flatten sessions + actions into palette items, sessions group first (the
+ * jump-back-in list), actions after. Sessions order recent-first by
+ * `updatedAt` — a palette with an empty query IS the recency list, so the
+ * build order is the render order and the filter never has to re-derive it.
+ * Pinned sessions lead the recency sort, matching the rail.
+ */
+export declare function buildCommandPaletteItems({ sessions, actions, sessionsLabel, actionsLabel, untitledLabel, }: BuildCommandPaletteItemsOptions): CommandPaletteItem[];
+/**
+ * Score an item: the best label score, or the best keyword score a fixed step
+ * below. `null` when neither matches — the item is filtered out. An empty
+ * query scores every item 0 (the caller keeps build order: recent-first).
+ */
+export declare function scoreCommandPaletteItem(item: CommandPaletteItem, query: string): number | null;
+/**
+ * Filter + rank: an empty query returns the items untouched (build order is
+ * the recency order); a real query drops non-matches and sorts by score, then
+ * recency, then original position — stable and deterministic.
+ */
+export declare function filterCommandPaletteItems(items: readonly CommandPaletteItem[], query: string): CommandPaletteItem[];
+/**
+ * Fold a flat (already ordered) item list into renderable sections. Groups
+ * appear in first-seen order and each group appears ONCE — a filtered ranking
+ * interleaves sessions and actions by score, and folding only consecutive runs
+ * would render the same header twice. Within a group, rows keep the flat
+ * order. Empty groups vanish, so a filter that leaves only actions renders no
+ * "Sessions" header over nothing.
+ */
+export declare function groupCommandPaletteItems(items: readonly CommandPaletteItem[]): CommandPaletteGroup[];

package/dist/session-shell/index.d.ts

@@ -15,6 +15,7 @@
  * rather than the shell knowing any URL.
  */
 export * from './nav-guard';
+export * from './command-palette';
 /** One session as the shell needs to see it. Products map their own row
  *  (thread / session / matter) onto this before handing it over. */
 export interface SessionSummary {

package/dist/session-shell/index.js

@@ -1,13 +1,18 @@
 import {
+  COMMAND_PALETTE_ACTIONS_GROUP,
+  COMMAND_PALETTE_SESSIONS_GROUP,
   DEFAULT_RAIL_COOKIE_NAME,
   UNTITLED_SESSION_LABEL,
   activeSessionIdFromPath,
   assertNavHrefsRegistered,
+  buildCommandPaletteItems,
   buildSessionNavItem,
   buildSessionSubItems,
   checkNavHrefs,
   composeSidebarSessions,
+  filterCommandPaletteItems,
   flattenRouteTable,
+  groupCommandPaletteItems,
   mergeSessionPages,
   railCollapsedCookie,
   readRailCollapsedCookie,
@@ -16,19 +21,25 @@ import {
   resolveNavHref,
   resolveScopedActiveNavId,
   resolveSessionUnread,
+  scoreCommandPaletteItem,
   sessionLabel,
   writeRailCollapsedCookie
-} from "../chunk-PC2WYTK7.js";
+} from "../chunk-EDTWGSQT.js";
 export {
+  COMMAND_PALETTE_ACTIONS_GROUP,
+  COMMAND_PALETTE_SESSIONS_GROUP,
   DEFAULT_RAIL_COOKIE_NAME,
   UNTITLED_SESSION_LABEL,
   activeSessionIdFromPath,
   assertNavHrefsRegistered,
+  buildCommandPaletteItems,
   buildSessionNavItem,
   buildSessionSubItems,
   checkNavHrefs,
   composeSidebarSessions,
+  filterCommandPaletteItems,
   flattenRouteTable,
+  groupCommandPaletteItems,
   mergeSessionPages,
   railCollapsedCookie,
   readRailCollapsedCookie,
@@ -37,6 +48,7 @@ export {
   resolveNavHref,
   resolveScopedActiveNavId,
   resolveSessionUnread,
+  scoreCommandPaletteItem,
   sessionLabel,
   writeRailCollapsedCookie
 };

package/dist/web-react/chat-composer.d.ts

@@ -25,6 +25,7 @@
  * fallbacks when a host hasn't defined a private chat-token set.
  */
 import { type ReactNode } from 'react';
+import { type DictationAudio } from './use-dictation';
 /** Prompt-part descriptor an uploaded file carries (the upload route's
  *  `UploadedChatFile.part`), echoed back in the turn body on send. Mirrors
  *  `/chat-routes`' wire shape structurally — no server import here. */
@@ -105,6 +106,20 @@ export interface ComposerSendFailure {
      *  the notice instead. */
     restored: boolean;
 }
+/**
+ * One `/` command the composer offers. Typing `/` at position 0 opens the
+ * command menu; the rest of the token filters it (the same prefix > substring
+ * > token-order ranking as the command palette). Picking a command CLEARS the
+ * token from the draft and calls `run` — what the command does (a route, a
+ * dialog, a draft transformation) is the product's business.
+ */
+export interface SlashCommand {
+    /** Command name without the leading slash: `model`, `clear`. */
+    name: string;
+    /** One line of what it does, rendered beside the name. */
+    description: string;
+    run: () => void;
+}
 export interface ChatComposerProps {
     /** Send the trimmed, non-empty message. Attached files travel separately via
      *  `onAttach` + `pendingFiles` (the host consumes and clears them on send).
@@ -162,6 +177,19 @@ export interface ChatComposerProps {
     accept?: string;
     dropTitle?: string;
     dropDescription?: string;
+    /** `/` commands offered when the draft is exactly a leading slash token.
+     *  Omit (or pass []) and `/` types as ordinary text. */
+    slashCommands?: SlashCommand[];
+    /** Dictation is opt-in: pass `onDictate` and the action row gains a mic
+     *  button (browsers without `MediaRecorder`/`getUserMedia` render none).
+     *  Click starts the capture; the button flips to a stop control with the
+     *  running elapsed seconds; stop hands the recorded audio blob here. The
+     *  composer owns capture only — turning the audio into text (e.g. the
+     *  Whisper provider from `sequences-react`) is the host's. */
+    onDictate?: (audio: DictationAudio) => void;
+    /** Capture failures (a denied mic prompt, no device), after the composer has
+     *  shown its own dismissible notice. For hosts that log or track. */
+    onDictateError?: (message: string) => void;
     /** Cmd/Ctrl+L focuses the input and shows the hint. Default true. */
     focusShortcut?: boolean;
     /** Float the card on a soft two-layer foreground-tinted shadow (opt-in).
@@ -176,4 +204,4 @@ export interface ChatComposerProps {
     sendVariant?: 'pill' | 'icon';
     className?: string;
 }
-export declare function ChatComposer({ onSend, onSendParts, onSendFailed, sendFailureMessage, onCancel, isStreaming, disabled, placeholder, value, onValueChange, initialValue, seed, onSeedApplied, controls, controlsPlacement, onAttach, onAttachFolder, pendingFiles, onRemoveFile, accept, dropTitle, dropDescription, focusShortcut, floating, sendLabel, sendVariant, className, }: ChatComposerProps): import("react").JSX.Element;
+export declare function ChatComposer({ onSend, onSendParts, onSendFailed, sendFailureMessage, onCancel, isStreaming, disabled, placeholder, value, onValueChange, initialValue, seed, onSeedApplied, controls, controlsPlacement, onAttach, onAttachFolder, pendingFiles, onRemoveFile, accept, dropTitle, dropDescription, slashCommands, onDictate, onDictateError, focusShortcut, floating, sendLabel, sendVariant, className, }: ChatComposerProps): import("react").JSX.Element;

package/dist/web-react/command-palette.d.ts

@@ -0,0 +1,44 @@
+/**
+ * CommandPalette — the rendered half of the Cmd/Ctrl+K surface. Selection,
+ * ranking, and grouping live in `/session-shell` (`buildCommandPaletteItems`,
+ * `filterCommandPaletteItems`, `groupCommandPaletteItems`); this component is
+ * the overlay, the input, and the keyboard model.
+ *
+ * Placement follows the PopoverSurface canon (AGENTS.md "UI chrome
+ * ownership"): the panel PORTALS to `document.body` and positions in viewport
+ * coordinates (`fixed`), so no host markup — a scroll rail, a `transform`, a
+ * stacking context — can clip or trap it. Unlike the pickers it is CENTERED,
+ * not trigger-anchored: a palette has no trigger, so it does not reuse
+ * `PopoverSurface` itself, but it carries the same grammar — `bg-popover`,
+ * `border-card-edge`, `OVERLAY_SHADOW`, the stamped surface attribute.
+ *
+ * The keyboard model is the ARIA combobox pattern: focus stays in the input,
+ * ArrowUp/ArrowDown move `aria-activedescendant` across the FLAT result list
+ * (groups are presentation), Enter selects, Escape closes, and closing returns
+ * focus to whatever had it before the palette opened.
+ */
+import { type CommandPaletteItem } from '../session-shell/index';
+export type { CommandPaletteItem } from '../session-shell/index';
+export interface CommandPaletteProps {
+    /** The full item list, build-ordered (recent-first sessions, then actions).
+     *  Filtering and ranking are owned here — pass the UNFILTERED list. */
+    items: CommandPaletteItem[];
+    /** A row was chosen (click or Enter). The palette closes itself. */
+    onSelect: (item: CommandPaletteItem) => void;
+    /** Controlled open state. Omit for self-managed state toggled by the hotkey. */
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    /** Register the Cmd/Ctrl+K toggle. Default true. */
+    hotkey?: boolean;
+    /** Async source is still resolving — the input stays live, the list shows
+     *  the loading row instead of a premature empty state. */
+    loading?: boolean;
+    /** Seed for the query (uncontrolled). */
+    initialQuery?: string;
+    placeholder?: string;
+    /** Empty-state copy. Default names the query: `No results for “…”`. */
+    emptyMessage?: string;
+    /** Accessible name for the dialog. Default "Command palette". */
+    label?: string;
+}
+export declare function CommandPalette({ items, onSelect, open: controlledOpen, onOpenChange, hotkey, loading, initialQuery, placeholder, emptyMessage, label, }: CommandPaletteProps): import("react").ReactPortal | null;

package/dist/web-react/index.d.ts

@@ -53,8 +53,10 @@ export * from './sandbox-terminal';
 export * from './seat-paywall';
 export * from './session-history';
 export * from './record-grid';
+export * from './command-palette';
 export * from './sparkline';
 export * from './insight-card';
+export * from './use-dictation';
 export { usePopover, usePending, PopoverSurface, POPOVER_SURFACE_ATTR, ModelPicker, EffortPicker, EffortMeter, effortMeterFill, effortLevelLabel, effortLevelsFromIds, reconcileEffortLevels, DEFAULT_EFFORT_LEVELS, EFFORT_METER_SEGMENTS, OVERLAY_SHADOW, type ModelPickerProps, type EffortPickerProps, type EffortLevel, type PopoverSurfaceProps, } from './controls';
 export { AgentSessionControls, type AgentSessionControlsProps, } from './agent-session-controls';
 import type { CatalogModel } from '../runtime/model-catalog';

package/dist/web-react/index.js

@@ -3,6 +3,7 @@ import {
   ChatComposer,
   ChatEmptyState,
   ChatMessages,
+  CommandPalette,
   DEFAULT_INSIGHT_PAGE_SIZE,
   DEFAULT_MENTION_EMPTY_TEXT,
   DEFAULT_MENTION_LIMIT,
@@ -50,12 +51,15 @@ import {
   createSessionInteractionAttemptStore,
   describeProvenance,
   describeProvenanceSourceStatus,
+  dictationErrorMessage,
+  diffRecordGridProposal,
   dispatchChatStreamLine,
   durableChatCardsFromParts,
   fieldAnswer,
   fieldValuesFromAnswers,
   formatActivityCost,
   formatActivityDuration,
+  formatDictationElapsed,
   formatInsightDelta,
   formatModelCost,
   formatRecordGridValue,
@@ -81,6 +85,7 @@ import {
   nextRevealCount,
   parseRecordGridInput,
   pendingApprovalOf,
+  pickDictationMimeType,
   projectRecordGridRows,
   provenanceBasisMeta,
   provenanceGaps,
@@ -113,6 +118,7 @@ import {
   triggerAttachmentDownload,
   upsertChatInteraction,
   useChatInteractions,
+  useDictation,
   useDurablePlanFlow,
   useFileMentions,
   useInfiniteScroll,
@@ -131,7 +137,7 @@ import {
   withoutRecordGridCreated,
   withoutRecordGridRemoved,
   withoutRecordGridUpdate
-} from "../chunk-FOXGPGXF.js";
+} from "../chunk-OMGV3CX2.js";
 import "../chunk-FBVLEGEG.js";
 import {
   EvidenceLineageTable,
@@ -175,7 +181,7 @@ import {
   useSandboxTerminalConnection
 } from "../chunk-BATKJP3P.js";
 import "../chunk-3UBAO3N5.js";
-import "../chunk-PC2WYTK7.js";
+import "../chunk-EDTWGSQT.js";
 import "../chunk-QY4BRKRJ.js";
 import {
   ATTACHMENT_ACCEPT
@@ -238,6 +244,7 @@ export {
   ChatComposer,
   ChatEmptyState,
   ChatMessages,
+  CommandPalette,
   DEFAULT_EFFORT_LEVELS,
   DEFAULT_INSIGHT_PAGE_SIZE,
   DEFAULT_MENTION_EMPTY_TEXT,
@@ -320,6 +327,8 @@ export {
   dedupeQuestionInteractionsByContent,
   describeProvenance,
   describeProvenanceSourceStatus,
+  dictationErrorMessage,
+  diffRecordGridProposal,
   dispatchChatStreamLine,
   durableChatCardsFromParts,
   effortLevelLabel,
@@ -331,6 +340,7 @@ export {
   fileMentionsToParts,
   formatActivityCost,
   formatActivityDuration,
+  formatDictationElapsed,
   formatInsightDelta,
   formatModelCost,
   formatRecordGridValue,
@@ -375,6 +385,7 @@ export {
   parseReviewQueueItem,
   pendingApprovalOf,
   persistedPartToInteraction,
+  pickDictationMimeType,
   projectRecordGridRows,
   provenanceBasisMeta,
   provenanceGaps,
@@ -413,6 +424,7 @@ export {
   upsertChatInteraction,
   useChatInteractions,
   useComposerAttachments,
+  useDictation,
   useDurablePlanFlow,
   useFileMentions,
   useInfiniteScroll,

package/dist/web-react/insight-card.d.ts

@@ -81,6 +81,10 @@ export interface InsightAction {
     onClick: () => void;
 }
 export interface InsightCardProps {
+    /** The lane the metric belongs to ("Spend", "Missions"), set small above the
+     *  title. A deck of cards from different surfaces needs the grouping word
+     *  before the metric's own name, not after it. */
+    eyebrow?: string;
     /** What was measured, in the reader's words ("Spend today"). */
     title: string;
     /** The number that moved. A `string` renders verbatim — a total the caller
@@ -113,7 +117,7 @@ export interface InsightCardProps {
     className?: string;
     style?: CSSProperties;
 }
-export declare function InsightCard({ title, value, unit, previous, polarity, format, series, seriesLabel, description, action, live, liveLabel, className, style, }: InsightCardProps): ReactElement;
+export declare function InsightCard({ eyebrow, title, value, unit, previous, polarity, format, series, seriesLabel, description, action, live, liveLabel, className, style, }: InsightCardProps): ReactElement;
 export interface Insight extends InsightCardProps {
     /** Stable across refreshes: it keys the card. Paired with the deck holding
      *  the last loaded page across a reload, a stable id is what lets a settled

package/dist/web-react/record-grid-model.d.ts

@@ -177,6 +177,51 @@ export declare function isRecordGridCellApplicable(column: RecordGridColumn, val
 /** Value equality across the grid's value union, treating `undefined` as
  *  `null` so an absent key and an explicit null never read as a change. */
 export declare function sameRecordGridValue(a: RecordGridValue | undefined, b: RecordGridValue | undefined): boolean;
+/**
+ * A proposed change set, diffed against the live rows by
+ * {@link diffRecordGridProposal}. The grid's review mode renders exactly what
+ * this shape declares — it owns no opinion about where the proposal came from
+ * (an agent's `submit_proposal` call, a record store's pending entries).
+ */
+export interface RecordGridProposal {
+    /** Proposed new cell values for EXISTING rows: row id → column id → value.
+     *  Only cells that differ from the live value diff; an update that restates
+     *  the current value is not a change. An id with no live row is ignored —
+     *  adding a row is `additions`' job. */
+    updates?: Readonly<Record<string, Readonly<Record<string, RecordGridValue>>>>;
+    /** Proposed new rows. An addition whose id already names a live row is
+     *  ignored — changing an existing row is `updates`' job. */
+    additions?: readonly RecordGridRow[];
+    /** Live row ids proposed for removal. Unknown ids are ignored. */
+    removals?: readonly string[];
+}
+/** One cell whose proposed value differs from the live one. */
+export interface RecordGridCellDiff {
+    columnId: string;
+    /** The live value — what rejecting keeps. */
+    before: RecordGridValue;
+    /** The proposed value — what accepting writes. */
+    after: RecordGridValue;
+}
+export type RecordGridRowDiffKind = 'changed' | 'added' | 'removed';
+/** One row's verdict: what the proposal does to it. */
+export interface RecordGridRowDiff {
+    rowId: string;
+    kind: RecordGridRowDiffKind;
+    /** The differing cells. Empty for `added`/`removed` — every cell of those is
+     *  part of the change by definition. */
+    cells: readonly RecordGridCellDiff[];
+    /** The live row for `changed`/`removed`, the proposed row for `added`. */
+    row: RecordGridRow;
+}
+/**
+ * Diff a proposal against the live rows. Pure and deterministic: input order
+ * in, diff order out — updates follow `rows` order, removals follow `rows`
+ * order, additions follow the proposal's order. A row whose update bag diffs
+ * to nothing produces no entry, so a no-op proposal yields an empty diff and
+ * the grid has nothing to review.
+ */
+export declare function diffRecordGridProposal(rows: readonly RecordGridRow[], proposal: RecordGridProposal): RecordGridRowDiff[];
 /**
  * Turn what an editor control produced into a typed value. Syntax only —
  * range, length, and membership are {@link validateRecordGridCell}'s job.

package/dist/web-react/record-grid.d.ts

@@ -17,6 +17,13 @@
  *  - **Provenance per cell.** An optional quote + link + basis, so a
  *    record-backed grid shows where a value came from without the product
  *    building a second surface for it.
+ *  - **Review of a proposed change set.** Hand the grid a `proposed` patch
+ *    (`./record-grid-model`'s `diffRecordGridProposal`) and it becomes the
+ *    red/green row-diff surface a tax/legal review needs: changed cells render
+ *    the struck live value against the proposed one, added/removed rows are
+ *    marked, and every diffed row carries accept/reject — per row and for the
+ *    whole set. What accepting MEANS stays the caller's (a record-store review
+ *    write); the grid reports decisions, it does not persist them.
  *  - **Three distinct data states, on `web-react/async`'s own contract.**
  *    `state: AsyncResourceState<Row[]>` and `empty: AsyncEmptySpec` are the
  *    same types every other screen fetches through — loading, error-with-
@@ -35,7 +42,7 @@
  */
 import { type ReactNode } from 'react';
 import { type AsyncEmptySpec, type AsyncResourceState } from './async';
-import { type RecordGridColumn, type RecordGridRow, type RecordGridValue } from './record-grid-model';
+import { type RecordGridColumn, type RecordGridProposal, type RecordGridRow, type RecordGridValue } from './record-grid-model';
 export * from './record-grid-model';
 /** One committed cell edit, handed to `onUpdate`. */
 export interface RecordGridCellChange {
@@ -88,6 +95,25 @@ export interface RecordGridProps {
     onUpdate?: (change: RecordGridCellChange) => Promise<RecordGridWriteOutcome>;
     /** Delete one row. Absent → no delete affordance. */
     onDelete?: (row: RecordGridRow) => Promise<RecordGridWriteOutcome>;
+    /** A proposed change set to review against the live rows (see
+     *  `diffRecordGridProposal`). While a non-empty diff is on the table the grid
+     *  is a REVIEW surface, not an editor: cell editing, row add, and row delete
+     *  are inert; changed cells render the struck live value against the
+     *  proposed one; added/removed rows are marked; each diffed row carries
+     *  accept/reject controls. A proposal that diffs to nothing renders the grid
+     *  unchanged — there is nothing to review. */
+    proposed?: RecordGridProposal;
+    /** Accept one diffed row — write its proposed values, adopt the addition, or
+     *  confirm the removal. The caller owns what accepting MEANS (a record-store
+     *  review write); the grid reports the decision and the caller moves the row
+     *  out of `proposed`. */
+    onAcceptRow?: (rowId: string) => void;
+    /** Reject one diffed row — the live row stands. */
+    onRejectRow?: (rowId: string) => void;
+    /** Accept every remaining diffed row at once. */
+    onAcceptAll?: () => void;
+    /** Reject every remaining diffed row at once. */
+    onRejectAll?: () => void;
     /** Starting values for the add form. */
     newRowDefaults?: Readonly<Record<string, RecordGridValue>>;
     /** Label of the add control and of the add form. Defaults to `Add row`. */
@@ -105,4 +131,4 @@ export interface RecordGridProps {
  * id, so a record store's fold output maps straight on: one cell per entry,
  * its quote and link in `sources`.
  */
-export declare function RecordGrid({ columns, caption, state, empty, onCreate, onUpdate, onDelete, newRowDefaults, addLabel, locale, toolbar, loadingRowCount, className, }: RecordGridProps): import("react").JSX.Element;
+export declare function RecordGrid({ columns, caption, state, empty, onCreate, onUpdate, onDelete, proposed, onAcceptRow, onRejectRow, onAcceptAll, onRejectAll, newRowDefaults, addLabel, locale, toolbar, loadingRowCount, className, }: RecordGridProps): import("react").JSX.Element;

package/dist/web-react/use-dictation.d.ts

@@ -0,0 +1,67 @@
+/**
+ * `useDictation` — the capture half of composer dictation.
+ *
+ * Dictation splits at a clean seam: the browser owns capture (`getUserMedia` +
+ * `MediaRecorder`), the host owns what the audio MEANS (transcription —
+ * `sequences-react`'s Whisper provider — or a straight upload). This hook is
+ * the capture half and nothing else: it asks for the mic, records, ticks whole
+ * seconds while it does, and hands the assembled `Blob` to the host's
+ * `onDictate`. A hook rather than composer-private code, because a host whose
+ * composer is fully composed (hotkey, push-to-talk) needs the same capture
+ * without re-deriving it.
+ *
+ * The rules the implementation exists to hold:
+ *
+ *  - **Unsupported is a render signal, not an exception.** A browser without
+ *    `MediaRecorder`/`getUserMedia` gets `supported: false`, and the composer
+ *    renders no dead button. `start()` stays a no-op rather than throwing, so
+ *    a host that wired it to a hotkey cannot crash on such a browser.
+ *  - **The mic is released the moment recording ends.** Tracks are stopped in
+ *    every exit — stop, error, cancel-during-prompt, unmount. A red dot the
+ *    browser keeps showing after the composer says "idle" is the failure this
+ *    is written against.
+ *  - **A denied prompt is a message, not a crash.** `NotAllowedError` and a
+ *    missing device are reported through `onError` as words the composer can
+ *    show; the hook returns to idle.
+ *  - **Unmount discards.** A composer that unmounts mid-recording delivers
+ *    nothing: the host it would have called has moved on, and an arriving
+ *    transcript would land in a conversation the user left.
+ *  - **Duration is measured, not counted.** `durationSeconds` comes off the
+ *    clock at stop; the one-second ticker drives only the visible elapsed
+ *    display, so a throttled timer never falsifies the delivered figure.
+ */
+/** The audio a finished recording hands to the host. */
+export interface DictationAudio {
+    /** The assembled recording, typed with the MIME the recorder actually used. */
+    readonly blob: Blob;
+    /** `blob.type`, surfaced so a host can switch on it without touching the blob. */
+    readonly mimeType: string;
+    /** Clock-measured whole seconds between start and stop. */
+    readonly durationSeconds: number;
+}
+export interface UseDictationOptions {
+    /** The host callback: receive the recording. Transcription is the host's. */
+    onDictate: (audio: DictationAudio) => void;
+    /** Capture failures in words ("Microphone access was denied…"). Optional —
+     *  the composer shows its own notice either way; this is for hosts that log. */
+    onError?: (message: string) => void;
+}
+export interface DictationControls {
+    /** Whether this browser can record at all. When false, render no affordance. */
+    readonly supported: boolean;
+    readonly recording: boolean;
+    /** Whole seconds since the current recording started; drives the indicator. */
+    readonly elapsedSeconds: number;
+    /** Ask for the mic and start. A no-op while a recording or a prompt is open. */
+    readonly start: () => void;
+    /** Stop and deliver. Cancels a still-pending permission prompt instead. */
+    readonly stop: () => void;
+}
+/** The mime to ask the recorder for, or `undefined` to take the UA default. */
+export declare function pickDictationMimeType(): string | undefined;
+/** The failure as a sentence. The denied prompt is the common case and the one
+ *  whose generic name ("NotAllowedError") says nothing to a reader. */
+export declare function dictationErrorMessage(error: unknown): string;
+/** `0:00`, `0:09`, `1:05`, `60:00` — minutes unbounded, seconds always two digits. */
+export declare function formatDictationElapsed(totalSeconds: number): string;
+export declare function useDictation({ onDictate, onError }: UseDictationOptions): DictationControls;

package/dist/workspace-react/index.js

@@ -2,7 +2,7 @@ import {
   buildSessionNavItem,
   composeSidebarSessions,
   resolveActiveNavId
-} from "../chunk-PC2WYTK7.js";
+} from "../chunk-EDTWGSQT.js";
 
 // src/workspace-react/index.tsx
 import { SidebarLayout } from "@tangle-network/sandbox-ui/dashboard";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-app",
-  "version": "0.45.62",
+  "version": "0.45.64",
   "packageManager": "pnpm@11.17.0",
   "description": "Build agent applications with typed chat, tools, sandboxes, integrations, billing, and evaluation.",
   "keywords": [
@@ -519,15 +519,15 @@
     "@storybook/react": "^10.5.5",
     "@storybook/react-vite": "^10.5.5",
     "@tangle-network/agent-docs": "0.2.1",
-    "@tangle-network/agent-eval": "0.145.21",
+    "@tangle-network/agent-eval": "0.147.0",
     "@tangle-network/agent-integrations": "0.53.54",
-    "@tangle-network/agent-interface": "1.0.0",
-    "@tangle-network/agent-knowledge": "8.0.5",
+    "@tangle-network/agent-interface": "1.0.1",
+    "@tangle-network/agent-knowledge": "8.0.8",
     "@tangle-network/agent-profile-materialize": "0.16.0",
-    "@tangle-network/agent-runtime": "0.137.0",
+    "@tangle-network/agent-runtime": "0.141.1",
     "@tangle-network/brand": "1.5.0",
-    "@tangle-network/sandbox": "0.27.1",
-    "@tangle-network/sandbox-ui": "0.104.0",
+    "@tangle-network/sandbox": "0.27.2",
+    "@tangle-network/sandbox-ui": "0.105.0",
     "@tangle-network/ui": "^11.5.0",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.2",
@@ -571,15 +571,15 @@
     "@firecrawl/pdf-inspector-wasm": ">=0.1.3",
     "@huggingface/transformers": ">=3",
     "@radix-ui/react-dialog": ">=1.1",
-    "@tangle-network/agent-eval": ">=0.145.21",
+    "@tangle-network/agent-eval": ">=0.147.0",
     "@tangle-network/agent-integrations": ">=0.52.0",
     "@tangle-network/agent-interface": "^1.0.0",
-    "@tangle-network/agent-knowledge": ">=8.0.5",
+    "@tangle-network/agent-knowledge": ">=8.0.8",
     "@tangle-network/agent-profile-materialize": ">=0.16.0",
-    "@tangle-network/agent-runtime": ">=0.137.0",
+    "@tangle-network/agent-runtime": ">=0.141.1",
     "@tangle-network/brand": ">=1.5.0",
-    "@tangle-network/sandbox": ">=0.27.1",
-    "@tangle-network/sandbox-ui": ">=0.104.0",
+    "@tangle-network/sandbox": ">=0.27.2",
+    "@tangle-network/sandbox-ui": ">=0.105.0",
     "@tangle-network/ui": ">=11.5.0",
     "@xyflow/react": ">=12.0.0",
     "better-auth": ">=1.6.16",