@ai-matrx/chat 0.3.6 → 0.3.9

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @ai-matrx/chat
 
+## 0.3.9
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/chat/v0.3.5..npm/chat/v0.3.9 -- apps/shared/chat`).
+No source changes intended and no consumer action required.
+
+## 0.3.8
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/chat/v0.3.5..npm/chat/v0.3.8 -- apps/shared/chat`).
+No source changes intended and no consumer action required.
+
+## 0.3.7 — 2026-10-07
+### Re-sync before matrx-frontend consumes the published package (P27)
+
+- Carries the matrx-frontend `packages/chat` edits after `3d7ea46a26` not already mirrored here: composer
+  output, agent variable cards, agent options menu, edit/fork message thunks, compute targets, context
+  scopes, window openers.
+- Consumer action: none.
+
 ## 0.3.6 — 2026-10-07
 ### Re-sync before matrx-frontend consumes the published package (P27)
 

package/dist/agents/components/inputs/smart-input/InputActionButtons.d.ts

@@ -10,6 +10,7 @@
  * the parent via `onVoiceBusyChange` so Enter-to-send is gated too.
  */
 import React from "react";
+import type { SourceFeature } from "@ai-matrx/agents/generated/source-attribution";
 import type { ComposerMode, ComposerSize } from "./composer/composer-types.js";
 /**
  * Shared resting (idle) tint for every toolbar button in this row. Exported so
@@ -67,6 +68,9 @@ interface InputActionButtonsProps {
          * Absent = Full's button row inside the card.
          */
         part?: "send" | "controls" | "launcher";
+        /** Attribution for a Live audio session started here. Absent = "chat". */
+        sourceFeature?: SourceFeature;
+        liveAudioStartsOn?: boolean;
     };
 }
 export declare function InputActionButtons({ conversationId, showSendButton, showVariableIcon, surfaceKey, disableSend, onVoiceBusyChange, extraRightControls, onRequestInputExpand, composer, }: InputActionButtonsProps): React.JSX.Element | null;

package/dist/agents/components/inputs/smart-input/InputActionButtons.js

@@ -4,7 +4,6 @@ import { useCallback, useState } from "react";
 import {
   CornerDownLeft,
   Braces,
-  AudioLines,
   Loader2,
   Square
 } from "lucide-react";
@@ -14,7 +13,8 @@ import {
   TooltipTrigger
 } from "@ai-matrx/design-system";
 import { useAppSelector, useAppDispatch } from "../../../../store/hooks.js";
-import { announceComingSoon } from "../../../../host/ui-slots.js";
+import { selectAgentIdFromInstance } from "../../../redux/execution-system/conversations/conversations.selectors.js";
+import { VoiceRelayBar } from "../../../../voice-agent/relay/VoiceRelayBar.js";
 import { AgentMicrophoneButton } from "./AgentMicrophoneButton.js";
 import { RunControlsMenu } from "./RunControlsMenu.js";
 import {
@@ -75,6 +75,8 @@ function InputActionButtons({
 }) {
   const dispatch = useAppDispatch();
   const [voiceBusy, setVoiceBusy] = useState(false);
+  const [liveAudioOn, setLiveAudioOn] = useState(composer.liveAudioStartsOn ?? false);
+  const agentId = useAppSelector(selectAgentIdFromInstance(conversationId)) ?? null;
   const { isExecuting, executingConversationId } = useSurfaceExecution(
     conversationId,
     surfaceKey
@@ -104,12 +106,16 @@ function InputActionButtons({
   const handleStop = useCallback(() => {
     dispatch(cancelExecution(executingConversationId ?? conversationId));
   }, [executingConversationId, conversationId, dispatch]);
-  const liveAudioButton = showSendButton ? /* @__PURE__ */ jsx(
-    InputButton,
+  const liveAudioButton = showSendButton && agentId ? /* @__PURE__ */ jsx(
+    VoiceRelayBar,
     {
-      icon: AudioLines,
-      tooltip: "Live audio",
-      onClick: () => void announceComingSoon("chat.live-audio")
+      variant: "composer",
+      enabled: liveAudioOn,
+      onEnabledChange: setLiveAudioOn,
+      primaryAgentId: agentId,
+      conversationId,
+      surfaceKey: surfaceKey ?? `composer:${conversationId}`,
+      sourceFeature: composer.sourceFeature ?? "chat"
     }
   ) : null;
   const variablesToggle = shouldShowVariables && showVariableIcon ? /* @__PURE__ */ jsx(
@@ -135,7 +141,8 @@ function InputActionButtons({
         surfaceKey,
         folded: composer.folded,
         // Compact's live audio leaves the row when narrow and rides +.
-        foldLiveAudio: composer.folded && composer.part === "controls"
+        foldLiveAudio: composer.folded && composer.part === "controls" && Boolean(liveAudioButton),
+        onLiveAudio: () => setLiveAudioOn(true)
       }
     }
   );
@@ -178,7 +185,7 @@ function InputActionButtons({
         /* @__PURE__ */ jsx(DesktopPresenceIndicator, { conversationId }),
         variablesToggle,
         micGroup,
-        composer.folded ? null : liveAudioButton,
+        composer.folded && !liveAudioOn ? null : liveAudioButton,
         composer.leading
       ] }),
       /* @__PURE__ */ jsxs("div", { className: "flex min-w-0 items-center gap-1.5", children: [

package/dist/agents/components/inputs/smart-input/RunControlsMenu.d.ts

@@ -26,6 +26,8 @@ export interface RunControlsMenuProps {
         folded?: boolean;
         /** Compact and narrow: live audio lives in the + menu too. */
         foldLiveAudio?: boolean;
+        /** The + menu's Live audio row turns the composer's voice on. */
+        onLiveAudio?: () => void;
     };
 }
 export declare function RunControlsMenu({ conversationId, variant, includeAttach, align, side, foldToolbarExtras, onRequestInputExpand, composer, }: RunControlsMenuProps): import("react").JSX.Element;

package/dist/agents/components/inputs/smart-input/RunControlsMenu.js

@@ -113,6 +113,7 @@ function RunControlsMenu({
           size: composer.size,
           folded: composer.folded,
           foldLiveAudio: composer.foldLiveAudio,
+          onLiveAudio: composer.onLiveAudio,
           side,
           surfaceKey: composer.surfaceKey,
           onRequestInputExpand
@@ -144,6 +145,7 @@ function RunControlsMenu({
         size: composer.size,
         folded: composer.folded,
         foldLiveAudio: composer.foldLiveAudio,
+        onLiveAudio: composer.onLiveAudio,
         side,
         surfaceKey: composer.surfaceKey,
         onRequestInputExpand,

package/dist/agents/components/inputs/smart-input/SmartAgentInputStacked.js

@@ -179,7 +179,7 @@ function SmartAgentInputStacked({
     surfaceKey,
     disableSend: sendBlocked
   };
-  const composerParts = { size: composer.size, mode: composer.mode, folded };
+  const composerParts = { size: composer.size, mode: composer.mode, folded, sourceFeature: composer.sourceFeature, liveAudioStartsOn: composer.liveAudioStartsOn };
   if (composer.size === "launcher") {
     return /* @__PURE__ */ jsx(
       "div",

package/dist/agents/components/inputs/smart-input/composer/ComposerAgentPill.js

@@ -53,18 +53,16 @@ function ComposerAgentPill({ conversationId, mode, size, agentControl, menuSide,
   const agentFilter = useComposerAgentFilter(conversationId);
   const showOverride = info.modelOverridden && !info.isCustom && composerShows(mode, "agent.presets");
   const overrideTitle = info.agentModelLabel ? `Agent's own model: ${info.agentModelLabel}` : "Not the agent's own model";
-  const pill = /* @__PURE__ */ jsxs(
+  const pill = /* @__PURE__ */ jsx(
     Button,
     {
       variant: "quiet",
       iconEnd: /* @__PURE__ */ jsx(ChevronDown, {}),
       "aria-label": `Agent: ${label}${showOverride ? " (model changed)" : ""}`,
       title: showOverride ? `${label} \u2014 ${overrideTitle}` : label,
-      className: "min-w-0",
-      children: [
-        label,
-        showOverride ? /* @__PURE__ */ jsx("span", { "data-testid": "composer-model-override-chip", children: " \xB7 changed" }) : null
-      ]
+      "data-model-override": showOverride ? "" : void 0,
+      className: "min-w-0 shrink",
+      children: showOverride ? `${label} \xB7 changed` : label
     }
   );
   if (folded) {

package/dist/agents/components/inputs/smart-input/composer/ComposerOutput.js

@@ -222,8 +222,8 @@ function ShapePicker({
   if (lock.status === "reading") {
     return /* @__PURE__ */ jsx("div", { className: "flex flex-col gap-1 px-2.5 py-2", "aria-label": "Checking the agent's shape", children: /* @__PURE__ */ jsx(Skeleton, { className: "h-7 w-full rounded-md" }) });
   }
-  return /* @__PURE__ */ jsxs("div", { className: "flex min-h-0 flex-col", children: [
-    /* @__PURE__ */ jsxs("div", { className: "flex items-center justify-between gap-2 px-2.5 pb-1 pt-2", children: [
+  return /* @__PURE__ */ jsxs("div", { className: "flex min-h-0 flex-1 flex-col", children: [
+    /* @__PURE__ */ jsxs("div", { className: "flex shrink-0 items-center justify-between gap-2 px-2.5 pb-1 pt-2", children: [
       /* @__PURE__ */ jsx("span", { className: "truncate text-[11px] font-medium uppercase tracking-wide text-muted-foreground", children: "Shapes" }),
       kinds.length > 0 ? /* @__PURE__ */ jsxs("span", { className: "shrink-0 text-[11px] tabular-nums text-muted-foreground", children: [
         kinds.length,
@@ -315,7 +315,7 @@ function ShapePicker({
 }
 function ComposerOutputPanel({ conversationId }) {
   const output = useComposerOutput(conversationId);
-  return /* @__PURE__ */ jsxs("div", { className: "@container flex min-h-0 flex-col", children: [
+  return /* @__PURE__ */ jsxs("div", { className: "@container flex min-h-0 flex-1 flex-col", children: [
     /* @__PURE__ */ jsx(ComposerMenuLabel, { children: "Output types" }),
     /* @__PURE__ */ jsx(TypeGrid, { types: output.types, onToggle: output.toggleType }),
     /* @__PURE__ */ jsx(ComposerMenuHelp, { children: "Narrows the agent list. Not sent to the model." }),
@@ -333,6 +333,7 @@ function ComposerOutputPill({
   menuSide
 }) {
   const [open, setOpen] = useState(false);
+  const [roomierSide, setRoomierSide] = useState(null);
   const output = useComposerOutput(conversationId);
   return /* @__PURE__ */ jsxs(Popover, { open, onOpenChange: setOpen, modal: false, children: [
     /* @__PURE__ */ jsxs(SplitButton, { className: "min-w-0", children: [
@@ -345,6 +346,10 @@ function ComposerOutputPill({
           "aria-label": `Output: ${output.label}`,
           title: output.lockWarning ?? void 0,
           className: "min-w-0",
+          onClick: (event) => {
+            const rect = event.currentTarget.getBoundingClientRect();
+            setRoomierSide(rect.top > window.innerHeight - rect.bottom ? "top" : "bottom");
+          },
           children: output.label
         }
       ) }),
@@ -353,7 +358,7 @@ function ComposerOutputPill({
     /* @__PURE__ */ jsx(
       PopoverContent,
       {
-        side: menuSide,
+        side: roomierSide ?? menuSide,
         align: "start",
         sideOffset: 8,
         className: "flex max-h-[var(--radix-popover-content-available-height)] w-[340px] max-w-[calc(100vw-1rem)] flex-col overflow-hidden p-1",

package/dist/agents/components/inputs/smart-input/composer/ComposerPlusMenu.d.ts

@@ -35,6 +35,8 @@ interface ComposerPlusMenuProps {
     folded?: boolean;
     /** Compact and narrow: live audio lives here too. */
     foldLiveAudio?: boolean;
+    /** Turns the composer's Live audio on (the row is folded, so it lives here). */
+    onLiveAudio?: () => void;
     side: "top" | "bottom";
     /** The host's surface key — auto-clear keeps its display slot in step. */
     surfaceKey?: string;
@@ -45,7 +47,7 @@ interface ComposerPlusMenuProps {
     open?: boolean;
     onOpenChange?: (open: boolean) => void;
 }
-export declare function ComposerPlusMenu({ conversationId, surfaceKey, trigger, mode, folded, foldLiveAudio, side, onRequestInputExpand, presentation, open: openProp, onOpenChange, }: ComposerPlusMenuProps): import("react").JSX.Element;
+export declare function ComposerPlusMenu({ conversationId, surfaceKey, trigger, mode, folded, foldLiveAudio, onLiveAudio, side, onRequestInputExpand, presentation, open: openProp, onOpenChange, }: ComposerPlusMenuProps): import("react").JSX.Element;
 /**
  * Environment (brief §6) — where the agent runs, as ONE flat list: Cloud, then
  * every computer and sandbox this person can use. One click chooses (Arman,

package/dist/agents/components/inputs/smart-input/composer/ComposerPlusMenu.js

@@ -81,7 +81,6 @@ import {
   ComposerMenuSwitchRow,
   ComposerSubmenu
 } from "./ComposerMenu.js";
-import { announceComingSoon } from "../../../../../host/ui-slots.js";
 import { ComposerMenuSheet } from "./ComposerMenuSheet.js";
 import { composerShows } from "./composer-mode-visibility.js";
 import { useTouchOnlyDevice } from "../../../../../ui/composer/useTouchOnlyDevice.js";
@@ -101,6 +100,7 @@ function ComposerPlusMenu({
   mode,
   folded = false,
   foldLiveAudio = false,
+  onLiveAudio,
   side,
   onRequestInputExpand,
   presentation = "popover",
@@ -360,7 +360,7 @@ function ComposerPlusMenu({
           label: "Live audio",
           onClick: () => {
             close();
-            void announceComingSoon("chat.live-audio");
+            onLiveAudio?.();
           }
         }
       ) : null

package/dist/agents/components/inputs/smart-input/composer/composer-types.d.ts

@@ -1,3 +1,4 @@
+import type { SourceFeature } from "@ai-matrx/agents/generated/source-attribution";
 import type { AnyMandateKey } from "@ai-matrx/agents/mandates";
 import type { EditableContextMenuProps } from "../../../../../host/ui-slots.js";
 import type { ApplicationScope } from "../../../../types/scope.types.js";
@@ -83,4 +84,8 @@ export interface ComposerPresentation {
     maxInputHeightPx?: number;
     /** The right-click agent menu on the textarea. Absent = no menu. */
     textMenu?: ComposerTextMenu;
+    /** Who started a Live audio session here (attribution). Absent = "chat". */
+    sourceFeature?: SourceFeature;
+    /** Live audio starts switched on (the person already chose to talk, e.g. a voice interview). */
+    liveAudioStartsOn?: boolean;
 }

package/dist/agents/components/inputs/variable-input-variations/AgentVariableCards.js

@@ -25,7 +25,7 @@ function AgentVariableInputCard({
 }) {
   const dispatch = useAppDispatch();
   const userValues = useAppSelector(selectUserVariableValues(conversationId));
-  const currentValue = userValues[variable.name];
+  const currentValue = userValues[variable.name] ?? variable.defaultValue;
   const comp = variable.customComponent;
   const type = comp?.type ?? "textarea";
   const setValue = (value) => {

package/dist/agents/components/shared/AgentOptionsMenu.js

@@ -274,7 +274,7 @@ function AgentOptionsMenu({
       setOpen(false);
     } else if (label === "Create App") {
       console.log("[AGENT OPTIONS MENU] Creating app, Agent ID:", agentId);
-      openCreateApp({ agentId: agentId ?? null });
+      openCreateApp();
       setOpen(false);
     } else if (label === "Add Data Storage Support") {
       console.log(
@@ -618,7 +618,7 @@ function MobileMenuContent({
       openFindUsages({ agentId: agentId ?? null });
       onClose();
     } else if (label === "Create App") {
-      openCreateApp({ agentId: agentId ?? null });
+      openCreateApp();
       onClose();
     } else if (label === "Add Data Storage Support") {
       openDataStorage({ agentId: agentId ?? null });

package/dist/agents/redux/execution-system/message-crud/edit-message.thunk.js

@@ -3,6 +3,7 @@ import { createAsyncThunk } from "@reduxjs/toolkit";
 import { supabase } from "../../../../host/db.js";
 import { updateMessageRecord } from "../messages/messages.slice.js";
 import { extractFlatText } from "../messages/messages.selectors.js";
+import { saveOutputFeedback } from "../../../../host/ui-slots.js";
 import {
   clearRequestEditedText,
   setRequestEditedText
@@ -165,12 +166,8 @@ const editMessage = createAsyncThunk(
     if (prevRecord.role === "assistant") {
       void (async () => {
         try {
-          const [{ saveOutputFeedback }, { extractFlatText: extractFlatText2 }] = await Promise.all([
-            import("../../../../host/ui-slots.js"),
-            import("../messages/messages.selectors.js")
-          ]);
-          const originalText = extractFlatText2(prevRecord);
-          const correctedText = extractFlatText2({
+          const originalText = extractFlatText(prevRecord);
+          const correctedText = extractFlatText({
             ...prevRecord,
             content: newContent
           });

package/dist/agents/redux/execution-system/message-crud/fork-and-resubmit-from-message.thunk.js

@@ -1,6 +1,7 @@
 import { createAsyncThunk } from "@reduxjs/toolkit";
 import { forkConversation } from "./fork-conversation.thunk.js";
 import { mergeEditedText } from "./content-blocks.util.js";
+import { toastDoor } from "../../../../host/ui-slots.js";
 const forkAndResubmitFromMessage = createAsyncThunk(
   "messages/forkAndResubmitFromMessage",
   async ({ conversationId, messageId, newContent, surfaceKey }, { dispatch, getState, rejectWithValue }) => {
@@ -48,7 +49,6 @@ const forkAndResubmitFromMessage = createAsyncThunk(
       );
     } else {
       const { toast } = await import("../../../../host/notify.js");
-      const { toastDoor } = await import("../../../../host/ui-slots.js");
       toast.success("Branch created", {
         action: toastDoor("conversation", newConversationId)
       });

package/dist/compute/targets.d.ts

@@ -116,15 +116,13 @@ export interface ChatComputeTargetsSource {
         error: string | null;
         fetchInstances: (opts?: {
             limit?: number;
-            [option: string]: unknown;
         }) => Promise<unknown>;
         createInstance: (request: {
             organization_id: string;
             template?: string;
-            tier?: string;
+            tier: "ec2" | "hosted";
             ttl_seconds?: number;
             labels?: Record<string, string>;
-            [field: string]: unknown;
         }) => Promise<{
             instance: SandboxInstance | null;
             error: string | null;
@@ -190,15 +188,13 @@ export declare const useSandboxInstances: () => {
     error: string | null;
     fetchInstances: (opts?: {
         limit?: number;
-        [option: string]: unknown;
     }) => Promise<unknown>;
     createInstance: (request: {
         organization_id: string;
         template?: string;
-        tier?: string;
+        tier: "ec2" | "hosted";
         ttl_seconds?: number;
         labels?: Record<string, string>;
-        [field: string]: unknown;
     }) => Promise<{
         instance: SandboxInstance | null;
         error: string | null;

package/dist/context/sources/scopes.d.ts

@@ -17,6 +17,7 @@
  * have no honest default and throw, naming themselves.
  */
 import type { ComponentType } from "react";
+import type { AssociationSourceEdge, AssociationTargetEdge } from "@ai-matrx/associations";
 import type { ChatDatabase, Json } from "../../host/db-types.js";
 import { type AnyComponent, type AnyFn } from "../../host/registered-source.js";
 export type ContextItemRow = ChatDatabase["context"]["Tables"]["context_items"]["Row"];
@@ -61,7 +62,6 @@ export interface ScopeTreeOrganization {
     projects?: Array<{
         id: string;
         name: string;
-        [field: string]: unknown;
     }>;
 }
 export interface ContextItemValue {
@@ -175,10 +175,10 @@ export interface AssociationEdgeRow {
 }
 export interface ChatAssociationsService {
     listForTargets(targetType: string, targetIds: string[], ...rest: any[]): Promise<ScopesRpcResult<{
-        edges: AssociationEdgeRow[];
+        edges: AssociationTargetEdge[];
     }>>;
     listForSources(sourceType: string, sourceIds: string[], ...rest: any[]): Promise<ScopesRpcResult<{
-        edges: AssociationEdgeRow[];
+        edges: AssociationSourceEdge[];
     }>>;
     add(input: any): Promise<ScopesRpcResult<any>>;
     remove(input: any): Promise<ScopesRpcResult<any>>;

package/dist/host/window-openers.d.ts

@@ -27,7 +27,7 @@ export interface OpenAgentIdWindowOptions {
     agentId?: string | null;
 }
 export type OpenAgentAdminFindUsagesWindowOptions = OpenAgentIdWindowOptions;
-export type OpenAgentCreateAppWindowOptions = OpenAgentIdWindowOptions;
+export type OpenAgentCreateAppWindowOptions = Record<string, never>;
 export type OpenAgentDataStorageWindowOptions = OpenAgentIdWindowOptions;
 export type OpenAgentFindUsagesWindowOptions = OpenAgentIdWindowOptions;
 export type OpenAgentInterfaceVariationsWindowOptions = OpenAgentIdWindowOptions;
@@ -222,7 +222,7 @@ export interface EditorPrimaryAction {
     label: string;
     variant?: "default" | "secondary" | "outline" | "destructive" | "ghost" | "link";
 }
-export interface OpenFullScreenMarkdownEditorOptions {
+interface OpenFullScreenMarkdownEditorOptionsBase {
     instanceId?: string;
     content?: string;
     mode?: unknown;
@@ -236,14 +236,29 @@ export interface OpenFullScreenMarkdownEditorOptions {
     showSaveButton?: boolean;
     showCopyButton?: boolean;
     primaryActions?: EditorPrimaryAction[];
-    onSave?: (content: string) => void | Promise<void>;
-    onAction?: (action: string, content: string) => void | Promise<void>;
+}
+type OpenFullScreenMarkdownEditorHandlers = {
+    onSave: (content: string) => Promise<void>;
+    onAction?: never;
     onEvent?: (event: {
         type: "save";
         content: string;
         action?: string;
     }) => void | Promise<void>;
-}
+} | {
+    onSave?: never;
+    onAction: (action: string, content: string) => Promise<void>;
+    onEvent?: (event: {
+        type: "save";
+        content: string;
+        action?: string;
+    }) => void | Promise<void>;
+} | {
+    onSave?: undefined;
+    onAction?: undefined;
+    onEvent?: undefined;
+};
+export type OpenFullScreenMarkdownEditorOptions = OpenFullScreenMarkdownEditorOptionsBase & OpenFullScreenMarkdownEditorHandlers;
 export interface ChatFullScreenEditorHandle {
     instanceId: string;
     callbackGroupId: string | null;
@@ -361,3 +376,4 @@ export declare function useOpenTopicalMapWindow(): (opts: OpenTopicalMapWindowOp
 export declare function useOpenScratchpadPanel(): (opts?: OpenScratchpadPanelOptions) => ChatWindowHandle;
 export declare function useOpenWorkingDocumentPanel(): (opts: OpenWorkingDocumentPanelOptions) => ChatWindowHandle;
 export declare function useOpenWorkingDocumentWindow(): (opts: OpenWorkingDocumentWindowOptions) => ChatInstanceWindowHandle;
+export {};

package/dist/voice-agent/relay/VoiceRelayBar.d.ts

@@ -16,7 +16,13 @@ export interface VoiceRelayBarProps {
     /**
      * `bar` draws the standalone section chrome. `toolbar` embeds the same
      * controls in an existing toolbar without adding another layout row.
+     * `composer` is the Smart Agent Input's "Live audio": idle it is ONE icon
+     * button beside the mic (no word, no extra width); pressed, the same live
+     * controls as `toolbar` (Arman, 2026-10-07: one voice control per surface).
      */
-    variant?: "bar" | "toolbar";
+    variant?: "bar" | "toolbar" | "composer";
+    /** Controlled on/off (the composer's + menu turns it on when the row is folded). */
+    enabled?: boolean;
+    onEnabledChange?: (enabled: boolean) => void;
 }
 export declare function VoiceRelayBar(props: VoiceRelayBarProps): import("react").JSX.Element;

package/dist/voice-agent/relay/VoiceRelayBar.js

@@ -1,6 +1,9 @@
 "use client";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-import { useState } from "react";
+import { useEffect, useRef, useState } from "react";
+import { useAppSelector } from "../../store/hooks.js";
+import { cn } from "@ai-matrx/design-system";
+import { selectVoiceInstructions } from "../state/selectors.js";
 import { Mic, Square, AudioLines } from "lucide-react";
 import { Button } from "@ai-matrx/design-system/controls";
 import { useMandate } from "../../mandates/useMandate.js";
@@ -16,7 +19,10 @@ function ActiveVoiceRelay({
   conversationId,
   surfaceKey,
   sourceFeature,
-  questionPacing
+  questionPacing,
+  onEnd,
+  autoStart,
+  variant
 }) {
   const relay = useVoiceRelaySession({
     communicatorAgentId,
@@ -27,19 +33,26 @@ function ActiveVoiceRelay({
     questionPacing
   });
   const live = relay.status !== "idle" && relay.status !== "error";
+  const instructionsReady = useAppSelector(
+    (state) => (selectVoiceInstructions(state, relay.instanceId) ?? "").trim().length > 0
+  );
+  const started = useRef(false);
+  useEffect(() => {
+    if (!autoStart || !instructionsReady || started.current) return;
+    started.current = true;
+    relay.toggle();
+  }, [autoStart, instructionsReady, relay]);
   return /* @__PURE__ */ jsxs(Fragment, { children: [
     /* @__PURE__ */ jsx(
       Button,
       {
         variant: live ? "danger" : "primary",
-        onClick: relay.toggle,
-        children: live ? /* @__PURE__ */ jsxs(Fragment, { children: [
-          /* @__PURE__ */ jsx(Square, { className: "mr-1.5 h-3.5 w-3.5" }),
-          " End voice"
-        ] }) : /* @__PURE__ */ jsxs(Fragment, { children: [
-          /* @__PURE__ */ jsx(Mic, { className: "mr-1.5 h-3.5 w-3.5" }),
-          " Talk"
-        ] })
+        icon: live ? /* @__PURE__ */ jsx(Square, {}) : /* @__PURE__ */ jsx(Mic, {}),
+        onClick: () => {
+          relay.toggle();
+          if (live) onEnd?.();
+        },
+        children: live ? "End voice" : "Talk"
       }
     ),
     live ? (
@@ -53,33 +66,86 @@ function ActiveVoiceRelay({
         }
       )
     ) : null,
-    /* @__PURE__ */ jsx("span", { className: "text-xs text-muted-foreground", children: relay.error ? relay.error.message : relay.brainBusy ? "thinking\u2026" : relay.status })
+    relay.error || relay.brainBusy || relay.status !== "idle" ? (
+      // In the composer's row it is ONE line: the full sentence on hover.
+      /* @__PURE__ */ jsx(
+        "span",
+        {
+          className: cn(
+            "text-xs",
+            relay.error ? "text-destructive" : "text-muted-foreground",
+            variant === "composer" && "min-w-0 max-w-[14rem] truncate"
+          ),
+          title: relay.error?.message,
+          children: relay.error ? variant === "composer" ? "Voice did not start" : relay.error.message : relay.brainBusy ? "thinking\u2026" : relay.status
+        }
+      )
+    ) : null
   ] });
 }
 function VoiceRelayBar(props) {
-  const [enabled, setEnabled] = useState(false);
-  const communicator = useMandate(VOICE_COMMUNICATOR_MANDATE_KEY);
+  const [ownEnabled, setOwnEnabled] = useState(false);
+  const enabled = props.enabled ?? ownEnabled;
+  const setEnabled = (next) => {
+    if (props.enabled === void 0) setOwnEnabled(next);
+    props.onEnabledChange?.(next);
+  };
+  if (!enabled && props.variant === "composer") {
+    return /* @__PURE__ */ jsx(
+      Button,
+      {
+        variant: "quiet",
+        icon: /* @__PURE__ */ jsx(AudioLines, {}),
+        "aria-label": "Live audio",
+        title: "Live audio \u2014 talk and hear the answer",
+        onClick: () => setEnabled(true)
+      }
+    );
+  }
   return /* @__PURE__ */ jsx(
     "div",
     {
-      className: props.variant === "toolbar" ? "flex items-center gap-1" : "flex items-center gap-2 border-b border-border px-3 py-1.5",
-      children: !enabled ? /* @__PURE__ */ jsx(Button, { icon: /* @__PURE__ */ jsx(AudioLines, {}), variant: "quiet", onClick: () => setEnabled(true), children: " Voice" }) : communicator.loading ? /* @__PURE__ */ jsx("span", { className: "text-xs text-muted-foreground", children: "Connecting the voice layer\u2026" }) : communicator.error || !communicator.mandate ? (
-        // An unresolvable mandate REFUSES loudly — no fallback persona, ever.
-        /* @__PURE__ */ jsxs("span", { className: "text-xs text-destructive", children: [
-          "Voice is unavailable: ",
-          communicator.error ?? "no Communicator bound",
-          /* @__PURE__ */ jsx(ErrorAlchemyMenu, { error: communicator.error })
-        ] })
-      ) : /* @__PURE__ */ jsx(
-        ActiveVoiceRelay,
+      className: props.variant === "toolbar" || props.variant === "composer" ? "flex items-center gap-1" : "flex items-center gap-2 border-b border-border px-3 py-1.5",
+      children: !enabled ? /* @__PURE__ */ jsx(Button, { icon: /* @__PURE__ */ jsx(AudioLines, {}), variant: "quiet", onClick: () => setEnabled(true), children: " Voice" }) : /* @__PURE__ */ jsx(
+        EnabledVoiceRelay,
         {
           ...props,
-          communicatorAgentId: communicator.mandate.agentId
+          onEnd: props.variant === "composer" ? () => setEnabled(false) : void 0
         }
       )
     }
   );
 }
+function EnabledVoiceRelay(props) {
+  const communicator = useMandate(VOICE_COMMUNICATOR_MANDATE_KEY);
+  if (communicator.loading) {
+    return /* @__PURE__ */ jsx("span", { className: "truncate text-xs text-muted-foreground", children: "Connecting the voice layer\u2026" });
+  }
+  if (communicator.error || !communicator.mandate) {
+    return /* @__PURE__ */ jsxs(
+      "span",
+      {
+        className: cn(
+          "flex min-w-0 items-center gap-1 text-xs text-destructive",
+          props.variant === "composer" && "max-w-[14rem]"
+        ),
+        title: `Voice is unavailable: ${communicator.error ?? "no Communicator bound"}`,
+        children: [
+          /* @__PURE__ */ jsx("span", { className: "truncate", children: props.variant === "composer" ? "Voice is unavailable" : `Voice is unavailable: ${communicator.error ?? "no Communicator bound"}` }),
+          /* @__PURE__ */ jsx(ErrorAlchemyMenu, { error: communicator.error })
+        ]
+      }
+    );
+  }
+  return /* @__PURE__ */ jsx(
+    ActiveVoiceRelay,
+    {
+      ...props,
+      communicatorAgentId: communicator.mandate.agentId,
+      autoStart: props.variant === "composer"
+    }
+  );
+}
 export {
   VoiceRelayBar
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/chat",
-  "version": "0.3.6",
+  "version": "0.3.9",
   "description": "THE one AI Matrx person-to-agent chat system: the full chat (running agents, conversations, tool calls, streaming, context, surfaces, voice) as per-module subpaths @ai-matrx/chat/<domain>/<module> over a host contract (/host, /host/react) whose only required value is a db; plus the kernel compatibility entries (., /external-store, /matrx, /react, /tools, styles.css, tokens.css) until P28.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -202,23 +202,23 @@
     "uuid": "^14.0.2",
     "zod": "^4.6.5",
     "@ai-matrx/agents": "latest",
-    "@ai-matrx/associations": "latest",
     "@ai-matrx/alchemy": "latest",
-    "@ai-matrx/browser-audio": "latest",
+    "@ai-matrx/associations": "latest",
     "@ai-matrx/canvas": "latest",
+    "@ai-matrx/browser-audio": "latest",
     "@ai-matrx/content-ir-react": "latest",
-    "@ai-matrx/diff": "latest",
+    "@ai-matrx/content-ir": "latest",
     "@ai-matrx/data": "latest",
-    "@ai-matrx/icons": "latest",
     "@ai-matrx/design-system": "latest",
-    "@ai-matrx/media": "latest",
+    "@ai-matrx/diff": "latest",
+    "@ai-matrx/icons": "latest",
     "@ai-matrx/kit": "latest",
-    "@ai-matrx/print": "latest",
+    "@ai-matrx/media": "latest",
     "@ai-matrx/realtime": "latest",
     "@ai-matrx/records": "latest",
     "@ai-matrx/records-ui": "latest",
     "@ai-matrx/tap-target": "latest",
-    "@ai-matrx/content-ir": "latest"
+    "@ai-matrx/print": "latest"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",