@agent-native/core 0.95.1 → 0.97.0

package/corpus/core/src/client/composer/RealtimeVoiceMode.tsx

@@ -40,6 +40,11 @@ export interface RealtimeVoiceModeCopy {
   entryButtonLabel: string;
   promptTitle: string;
   promptDescription: string;
+  setupTitle: string;
+  setupDescription: string;
+  connectBuilder: string;
+  useOpenAiKey: string;
+  startWithOpenAiKey: string;
   startVoiceMode: string;
   keepDictating: string;
   showChat: string;
@@ -63,6 +68,11 @@ export interface RealtimeVoiceModeEntryProps {
   onOpenChange?: (open: boolean) => void;
   onStartVoiceMode: () => void;
   onKeepDictating: () => void;
+  setupRequired?: boolean;
+  openAiConfigured?: boolean;
+  connectingBuilder?: boolean;
+  onConnectBuilder?: () => void;
+  onUseOpenAiKey?: () => void;
   className?: string;
 }
 
@@ -78,6 +88,11 @@ export function RealtimeVoiceModeEntry({
   onOpenChange,
   onStartVoiceMode,
   onKeepDictating,
+  setupRequired = false,
+  openAiConfigured = false,
+  connectingBuilder = false,
+  onConnectBuilder,
+  onUseOpenAiKey,
   className,
 }: RealtimeVoiceModeEntryProps) {
   const [uncontrolledOpen, setUncontrolledOpen] = useState(false);
@@ -130,17 +145,17 @@ export function RealtimeVoiceModeEntry({
         <div className="grid gap-3">
           <div className="grid gap-1">
             <h2 id={titleId} className="text-sm font-semibold text-foreground">
-              {copy.promptTitle}
+              {setupRequired ? copy.setupTitle : copy.promptTitle}
             </h2>
             <p
               id={descriptionId}
               className="text-sm leading-relaxed text-muted-foreground"
             >
-              {copy.promptDescription}
+              {setupRequired ? copy.setupDescription : copy.promptDescription}
             </p>
           </div>
 
-          <div className="flex flex-col-reverse gap-2 sm:flex-row sm:justify-end">
+          <div className="flex flex-col-reverse gap-2 sm:flex-row sm:flex-wrap sm:justify-end">
             <Button
               type="button"
               variant="ghost"
@@ -149,14 +164,40 @@ export function RealtimeVoiceModeEntry({
             >
               {copy.keepDictating}
             </Button>
-            <Button
-              type="button"
-              size="sm"
-              onClick={() => choose(onStartVoiceMode)}
-            >
-              <IconMicrophone />
-              {copy.startVoiceMode}
-            </Button>
+            {setupRequired ? (
+              <>
+                <Button
+                  type="button"
+                  variant="outline"
+                  size="sm"
+                  onClick={() => choose(onUseOpenAiKey ?? onStartVoiceMode)}
+                >
+                  {openAiConfigured
+                    ? copy.startWithOpenAiKey
+                    : copy.useOpenAiKey}
+                </Button>
+                <Button
+                  type="button"
+                  size="sm"
+                  disabled={connectingBuilder}
+                  onClick={() => choose(onConnectBuilder ?? onStartVoiceMode)}
+                >
+                  {connectingBuilder ? (
+                    <IconLoader2 className="animate-spin" />
+                  ) : null}
+                  {copy.connectBuilder}
+                </Button>
+              </>
+            ) : (
+              <Button
+                type="button"
+                size="sm"
+                onClick={() => choose(onStartVoiceMode)}
+              >
+                <IconMicrophone />
+                {copy.startVoiceMode}
+              </Button>
+            )}
           </div>
         </div>
       </PopoverContent>

package/corpus/core/src/client/composer/TiptapComposer.tsx

@@ -107,6 +107,38 @@ export function canSubmitComposerContent(options: {
   );
 }
 
+export function resolveComposerPrimaryAction(options: {
+  canSubmit: boolean;
+  hasStopButton: boolean;
+}): "send" | "stop" {
+  return !options.canSubmit && options.hasStopButton ? "stop" : "send";
+}
+
+export type ContextChipBackspaceAction =
+  | { type: "select"; key: string }
+  | { type: "remove"; key: string }
+  | null;
+
+export function resolveContextChipBackspaceAction(options: {
+  contextItemKeys: string[];
+  selectedKey: string | null;
+  cursorAtStart: boolean;
+}): ContextChipBackspaceAction {
+  if (!options.cursorAtStart || options.contextItemKeys.length === 0) {
+    return null;
+  }
+  if (
+    options.selectedKey &&
+    options.contextItemKeys.includes(options.selectedKey)
+  ) {
+    return { type: "remove", key: options.selectedKey };
+  }
+  return {
+    type: "select",
+    key: options.contextItemKeys[options.contextItemKeys.length - 1],
+  };
+}
+
 const MAX_DOCUMENT_ATTACHMENT_BYTES = 4 * 1024 * 1024;
 
 function composerReferenceFromMentionItem(
@@ -535,8 +567,13 @@ export interface TiptapComposerProps {
   onTextChange?: (text: string) => void;
   /** Custom action button (e.g. stop button) to render instead of the default send button. */
   actionButton?: React.ReactNode;
-  /** Extra button to render alongside the default send button (e.g. stop while running). */
+  /** Extra button to render alongside the primary action. */
   extraActionButton?: React.ReactNode;
+  /**
+   * Stop control shown instead of the disabled send button while the composer
+   * has no sendable content. Typing or attaching content restores send.
+   */
+  stopButton?: React.ReactNode;
   /** Custom attachment button to render instead of ComposerPrimitive.AddAttachment. */
   attachButton?: React.ReactNode;
   /** Custom host-owned control rendered next to the attachment affordance. */
@@ -824,6 +861,25 @@ function friendlyModelName(model: string): string {
   return model;
 }
 
+export function compactComposerModelName(model: string): string {
+  const gpt56Variant = model.match(
+    /^(?:openai\/)?gpt-5[.-]6[.-](sol|terra|luna)$/i,
+  )?.[1];
+  if (gpt56Variant) {
+    return gpt56Variant[0].toUpperCase() + gpt56Variant.slice(1).toLowerCase();
+  }
+  return friendlyModelName(model);
+}
+
+export function compactComposerReasoningEffortLabel(
+  effort: ReasoningEffort,
+): string {
+  if (effort === "medium" || effort === "auto") return "Med";
+  if (effort === "minimal") return "Min";
+  if (effort === "xhigh") return "XHigh";
+  return reasoningEffortLabel(effort);
+}
+
 /**
  * Deduplicate models to only the latest version per family.
  * e.g. [opus-4-7, opus-4-6, opus-4-5] → [opus-4-7]
@@ -994,12 +1050,19 @@ function ModelSelector({
         <button
           type="button"
           data-agent-composer-slot="model-button"
+          aria-label={`Model: ${friendlyModelName(model)}${
+            effortOptions.length > 0
+              ? `. Reasoning: ${reasoningEffortLabel(selectedEffort)}`
+              : ""
+          }`}
           className="agent-composer-model-button flex min-w-0 max-w-[10.5rem] shrink items-center gap-1 rounded-md px-2 py-1 text-[12px] font-medium text-muted-foreground hover:bg-accent/50 hover:text-foreground"
         >
-          <span className="min-w-0 truncate">{friendlyModelName(model)}</span>
+          <span className="min-w-0 truncate">
+            {compactComposerModelName(model)}
+          </span>
           {effortOptions.length > 0 && (
             <span className="agent-composer-model-effort min-w-0 shrink truncate text-muted-foreground/70">
-              · {reasoningEffortLabel(selectedEffort)}
+              · {compactComposerReasoningEffortLabel(selectedEffort)}
             </span>
           )}
           <IconChevronDown className="h-3 w-3 shrink-0 opacity-60" />
@@ -1247,6 +1310,7 @@ export function TiptapComposer({
   onTextChange,
   actionButton,
   extraActionButton,
+  stopButton,
   attachButton,
   modeControl,
   toolbarSlot,
@@ -1288,6 +1352,9 @@ export function TiptapComposer({
   const [slotReferences, setSlotReferences] = useState<
     AgentComposerReference[]
   >([]);
+  const [selectedContextItemKey, setSelectedContextItemKey] = useState<
+    string | null
+  >(null);
   const composerText = useComposer((state) => state.text);
   const composerAttachments = useComposer((state) => state.attachments);
   const canSend = canSubmitComposerContent({
@@ -1295,6 +1362,10 @@ export function TiptapComposer({
     attachmentCount: composerAttachments.length,
     disabled,
   });
+  const primaryAction = resolveComposerPrimaryAction({
+    canSubmit: canSend,
+    hasStopButton: Boolean(stopButton),
+  });
   const hasContextRows = contextItems.length > 0 || slotReferences.length > 0;
   const [composerMode, setComposerMode] = useState<ComposerMode | null>(null);
   const composerModeRef = useRef<ComposerMode | null>(null);
@@ -1379,9 +1450,25 @@ export function TiptapComposer({
   onSlashCommandRef.current = onSlashCommand;
   const onTextChangeRef = useRef(onTextChange);
   onTextChangeRef.current = onTextChange;
+  const contextItemsRef = useRef(contextItems);
+  contextItemsRef.current = contextItems;
+  const onRemoveContextItemRef = useRef(onRemoveContextItem);
+  onRemoveContextItemRef.current = onRemoveContextItem;
+  const selectedContextItemKeyRef = useRef<string | null>(null);
+  selectedContextItemKeyRef.current = selectedContextItemKey;
   const initialTextKeyRef = useRef<string | number | undefined>(undefined);
   const seenReferenceInsertIdsRef = useRef<Set<string>>(new Set());
 
+  useEffect(() => {
+    if (
+      selectedContextItemKey &&
+      !contextItems.some((item) => item.key === selectedContextItemKey)
+    ) {
+      selectedContextItemKeyRef.current = null;
+      setSelectedContextItemKey(null);
+    }
+  }, [contextItems, selectedContextItemKey]);
+
   const closePopover = useCallback(() => {
     setPopover(null);
     popoverStateRef.current = null;
@@ -1449,6 +1536,13 @@ export function TiptapComposer({
         } catch {}
       }, 300);
     },
+    onSelectionUpdate: ({ editor: ed }) => {
+      const { from, to } = ed.state.selection;
+      if (selectedContextItemKeyRef.current && (from !== to || from > 1)) {
+        selectedContextItemKeyRef.current = null;
+        setSelectedContextItemKey(null);
+      }
+    },
     editorProps: {
       attributes: {
         "data-agent-composer-variant": layoutVariant,
@@ -1581,9 +1675,37 @@ export function TiptapComposer({
           }
         }
 
+        const { from, to } = view.state.selection;
+        const cursorAtStart = from === to && from <= 1;
+        if (event.key === "Backspace" && onRemoveContextItemRef.current) {
+          const chipAction = resolveContextChipBackspaceAction({
+            contextItemKeys: contextItemsRef.current.map((item) => item.key),
+            selectedKey: selectedContextItemKeyRef.current,
+            cursorAtStart,
+          });
+          if (chipAction) {
+            event.preventDefault();
+            if (chipAction.type === "select") {
+              selectedContextItemKeyRef.current = chipAction.key;
+              setSelectedContextItemKey(chipAction.key);
+            } else {
+              selectedContextItemKeyRef.current = null;
+              setSelectedContextItemKey(null);
+              contextItemsRef.current = contextItemsRef.current.filter(
+                (item) => item.key !== chipAction.key,
+              );
+              onRemoveContextItemRef.current?.(chipAction.key);
+            }
+            return true;
+          }
+        }
+        if (selectedContextItemKeyRef.current) {
+          selectedContextItemKeyRef.current = null;
+          setSelectedContextItemKey(null);
+        }
+
         // Backspace removes composer mode chip when editor is empty
         if (event.key === "Backspace" && composerModeRef.current) {
-          const { from, to } = view.state.selection;
           if (
             view.state.doc.textContent.trim() === "" &&
             from === to &&
@@ -2535,13 +2657,24 @@ export function TiptapComposer({
           {contextItems.map((item) => (
             <span
               key={item.key}
-              className="inline-flex max-w-full items-center gap-1.5 rounded-md border border-border bg-muted/50 px-2 py-1 text-[11px] font-medium text-foreground"
+              data-state={
+                selectedContextItemKey === item.key ? "selected" : undefined
+              }
+              className={`inline-flex max-w-full items-center gap-1.5 rounded-md border px-2 py-1 text-[11px] font-medium text-foreground ${
+                selectedContextItemKey === item.key
+                  ? "border-ring bg-accent ring-2 ring-ring/40"
+                  : "border-border bg-muted/50"
+              }`}
             >
               <IconClipboardList className="h-3 w-3 shrink-0 text-muted-foreground" />
               <span className="min-w-0 truncate">{item.title}</span>
               <button
                 type="button"
-                onClick={() => onRemoveContextItem?.(item.key)}
+                onClick={() => {
+                  selectedContextItemKeyRef.current = null;
+                  setSelectedContextItemKey(null);
+                  onRemoveContextItem?.(item.key);
+                }}
                 aria-label={`Remove ${item.title} context`}
                 className="ms-0.5 flex h-4 w-4 shrink-0 items-center justify-center rounded text-muted-foreground hover:bg-accent hover:text-foreground"
               >
@@ -2607,20 +2740,24 @@ export function TiptapComposer({
             {voiceEnabled && (
               <VoiceButton voice={voice} isMac={isMac} disabled={disabled} />
             )}
-            <Tooltip>
-              <TooltipTrigger asChild>
-                <button
-                  type="button"
-                  onClick={() => void submitComposer("immediate")}
-                  disabled={!canSend}
-                  data-agent-composer-slot="send-button"
-                  className="agent-composer-send-button shrink-0 flex h-7 w-7 items-center justify-center rounded-md bg-primary text-primary-foreground hover:opacity-90 disabled:opacity-30 disabled:cursor-not-allowed"
-                >
-                  <IconArrowUp className="h-3.5 w-3.5" />
-                </button>
-              </TooltipTrigger>
-              <TooltipContent>Send message</TooltipContent>
-            </Tooltip>
+            {primaryAction === "stop" ? (
+              stopButton
+            ) : (
+              <Tooltip>
+                <TooltipTrigger asChild>
+                  <button
+                    type="button"
+                    onClick={() => void submitComposer("immediate")}
+                    disabled={!canSend}
+                    data-agent-composer-slot="send-button"
+                    className="agent-composer-send-button shrink-0 flex h-7 w-7 items-center justify-center rounded-md bg-primary text-primary-foreground hover:opacity-90 disabled:opacity-30 disabled:cursor-not-allowed"
+                  >
+                    <IconArrowUp className="h-3.5 w-3.5" />
+                  </button>
+                </TooltipTrigger>
+                <TooltipContent>Send message</TooltipContent>
+              </Tooltip>
+            )}
           </>
         )}
       </div>

package/corpus/core/src/client/composer/VoiceButton.tsx

@@ -20,6 +20,8 @@ import {
   TooltipContent,
   TooltipTrigger,
 } from "../components/ui/tooltip.js";
+import { useBuilderConnectFlow } from "../settings/useBuilderStatus.js";
+import { useVoiceProviderStatus } from "../voice-provider-status.js";
 import { RealtimeVoiceModeEntry } from "./RealtimeVoiceMode.js";
 import {
   useRealtimeVoiceModeCopy,
@@ -27,6 +29,16 @@ import {
 } from "./useRealtimeVoiceMode.js";
 import type { VoiceDictationApi } from "./useVoiceDictation.js";
 
+function openOpenAiKeySettings(): void {
+  window.location.hash = "#secrets:OPENAI_API_KEY";
+  window.dispatchEvent(new Event("agent-panel:open"));
+  window.dispatchEvent(
+    new CustomEvent("agent-panel:open-settings", {
+      detail: { section: "secrets" },
+    }),
+  );
+}
+
 export interface VoiceButtonProps {
   voice: VoiceDictationApi;
   isMac: boolean;
@@ -37,6 +49,12 @@ export function VoiceButton({ voice, isMac, disabled }: VoiceButtonProps) {
   const { state, start, stop, supported } = voice;
   const realtimeVoice = useRealtimeVoiceModeOptional();
   const realtimeCopy = useRealtimeVoiceModeCopy();
+  const voiceProviders = useVoiceProviderStatus();
+  const builderConnect = useBuilderConnectFlow({
+    trackingSource: "realtime_voice",
+    trackingFlow: "voice_transcription",
+    onConnected: () => voiceProviders.refresh(),
+  });
 
   if (!supported) return null;
 
@@ -50,6 +68,16 @@ export function VoiceButton({ voice, isMac, disabled }: VoiceButtonProps) {
       <RealtimeVoiceModeEntry
         copy={realtimeCopy}
         disabled={disabled}
+        setupRequired={
+          builderConnect.hasFetchedStatus && !builderConnect.configured
+        }
+        openAiConfigured={voiceProviders.status?.openai === true}
+        connectingBuilder={builderConnect.connecting}
+        onConnectBuilder={builderConnect.start}
+        onUseOpenAiKey={() => {
+          if (voiceProviders.status?.openai) void realtimeVoice.start();
+          else openOpenAiKeySettings();
+        }}
         onStartVoiceMode={() => void realtimeVoice.start()}
         onKeepDictating={() => void start()}
       />

package/corpus/core/src/client/composer/useRealtimeVoiceMode.tsx

@@ -247,6 +247,11 @@ function voiceCopy(t: ReturnType<typeof useT>): RealtimeVoiceModeCopy {
     entryButtonLabel: t("agentPanel.voiceMode.entryButtonLabel"),
     promptTitle: t("agentPanel.voiceMode.promptTitle"),
     promptDescription: t("agentPanel.voiceMode.promptDescription"),
+    setupTitle: t("agentPanel.voiceMode.setupTitle"),
+    setupDescription: t("agentPanel.voiceMode.setupDescription"),
+    connectBuilder: t("agentPanel.voiceMode.connectBuilder"),
+    useOpenAiKey: t("agentPanel.voiceMode.useOpenAiKey"),
+    startWithOpenAiKey: t("agentPanel.voiceMode.startWithOpenAiKey"),
     startVoiceMode: t("agentPanel.voiceMode.start"),
     keepDictating: t("agentPanel.voiceMode.keepDictating"),
     showChat: t("agentPanel.voiceMode.showChat"),

package/corpus/core/src/client/conversation/code-agent-transcript.ts

@@ -1,4 +1,5 @@
 import {
+  isCredentialGapCodeAgentEvent,
   normalizeCodeAgentTranscript,
   type CodeAgentTranscriptEvent as CoreCodeAgentTranscriptEvent,
   type NormalizedCodeAgentStatusEvent,
@@ -38,6 +39,7 @@ export interface CodeAgentConversationTranscriptEvent {
   artifactPath?: string;
   artifactUrl?: string;
   metadata?: Record<string, unknown>;
+  signal?: CoreCodeAgentTranscriptEvent["signal"];
 }
 
 export interface NormalizeCodeAgentTranscriptOptions {
@@ -160,6 +162,7 @@ function toCoreTranscriptEvent(
       ...(event.artifactPath ? { artifactPath: event.artifactPath } : {}),
       ...(event.artifactUrl ? { artifactUrl: event.artifactUrl } : {}),
     },
+    ...(event.signal ? { signal: event.signal } : {}),
   };
 }
 
@@ -194,7 +197,7 @@ function toConversationNotice(
   item: NormalizedCodeAgentStatusEvent,
   options: NormalizeCodeAgentTranscriptOptions,
 ): AgentConversationNotice | null {
-  if (options.hideCredentialMessages && isCredentialText(item.text))
+  if (options.hideCredentialMessages && isCredentialGapCodeAgentEvent(item))
     return null;
   if (item.level === "info" && item.statusKind !== "note") return null;
   return {
@@ -255,10 +258,6 @@ function stringMetadata(
   return typeof value === "string" && value.trim() ? value.trim() : undefined;
 }
 
-function isCredentialText(value: string): boolean {
-  return /No LLM provider key was found|Missing credentials/i.test(value);
-}
-
 function extractAttachments(
   events: CoreCodeAgentTranscriptEvent[],
 ): AgentConversationAttachment[] {

package/corpus/core/src/client/guided-questions.tsx

@@ -1067,7 +1067,8 @@ export function useGuidedQuestionFlow({
         if (
           prev &&
           guidedQuestionsFingerprint(prev.questions) ===
-            guidedQuestionsFingerprint(data.questions)
+            guidedQuestionsFingerprint(data.questions) &&
+          prev.clientResolveId === data.clientResolveId
         ) {
           return prev;
         }

package/corpus/core/src/client/index.ts

@@ -87,6 +87,7 @@ export {
 } from "./embed-auth.js";
 export {
   codeAgentTranscriptEventsToContent,
+  codeAgentTranscriptHasPendingApproval,
   createCodeAgentChatAdapter,
   type CodeAgentChatController,
   type CodeAgentChatControlResult,
@@ -107,6 +108,10 @@ export {
   type CodeAgentRunStateLike,
   type CodeAgentTranscriptOrderEvent,
 } from "../code-agents/transcript-order.js";
+export {
+  CREDENTIAL_GAP_SIGNAL,
+  isCredentialGapCodeAgentEvent,
+} from "../code-agents/transcript-normalizer.js";
 export { useSendToAgentChat } from "./use-send-to-agent-chat.js";
 export {
   useChatModels,
@@ -557,6 +562,12 @@ export {
   type ChatThreadShareState,
   type UseChatThreadsOptions,
 } from "./use-chat-threads.js";
+export {
+  ChatHistoryList,
+  type ChatHistoryItem,
+  type ChatHistorySection,
+  type ChatHistoryListProps,
+} from "./chat/ChatHistoryList.js";
 export { AgentChatHome, type AgentChatHomeProps } from "./AgentChatHome.js";
 export {
   AgentChatSurface,

package/corpus/core/src/client/use-chat-threads.ts

@@ -449,8 +449,17 @@ export function useChatThreads(
           // haven't shown up in the server list yet — the server only learns
           // about a thread when the user actually sends a message and the
           // agent run's `persistSubmittedUserMessage` writes the row.
+          //
+          // Archived threads are excluded here too: the server list omits
+          // archived threads by default, so a thread we archived this same
+          // session would otherwise look identical to a not-yet-synced
+          // optimistic thread (created this session, missing from `loaded`)
+          // and get preserved forever instead of disappearing once archived.
           const optimisticOnly = prev.filter(
-            (t) => newlyCreatedRef.current.has(t.id) && !loadedIds.has(t.id),
+            (t) =>
+              newlyCreatedRef.current.has(t.id) &&
+              !loadedIds.has(t.id) &&
+              !t.archivedAt,
           );
           // Reconcile each server thread against our local copy. If the local
           // copy has a newer updatedAt or higher messageCount, keep those

package/corpus/core/src/client/voice-provider-status.ts

@@ -0,0 +1,44 @@
+import { useCallback, useEffect, useState } from "react";
+
+import { agentNativePath } from "./api-path.js";
+
+export interface VoiceProviderStatus {
+  builder: boolean;
+  openai: boolean;
+}
+
+export async function getVoiceProviderStatus(): Promise<VoiceProviderStatus> {
+  const response = await fetch(
+    agentNativePath("/_agent-native/voice-providers/status"),
+    { credentials: "same-origin" },
+  );
+  if (!response.ok) {
+    throw new Error(`Voice provider status unavailable (${response.status})`);
+  }
+  const status = (await response.json()) as Partial<VoiceProviderStatus>;
+  return { builder: status.builder === true, openai: status.openai === true };
+}
+
+export function useVoiceProviderStatus() {
+  const [status, setStatus] = useState<VoiceProviderStatus | null>(null);
+
+  const refresh = useCallback(async () => {
+    try {
+      setStatus(await getVoiceProviderStatus());
+    } catch {
+      // Keep the last known status. The session route remains authoritative.
+    }
+  }, []);
+
+  useEffect(() => {
+    void refresh();
+    window.addEventListener("focus", refresh);
+    window.addEventListener("agent-engine:configured-changed", refresh);
+    return () => {
+      window.removeEventListener("focus", refresh);
+      window.removeEventListener("agent-engine:configured-changed", refresh);
+    };
+  }, [refresh]);
+
+  return { status, refresh };
+}