aidevops 3.29.6 → 3.29.8

package/README.md

@@ -58,7 +58,7 @@ The result: an AI operations platform that manages projects across every busines
 [![Copyright](https://img.shields.io/badge/Copyright-Marcus%20Quinn%202025--2026-blue.svg)](https://github.com/marcusquinn)
 
 <!-- Release & Version Info -->
-[![Version](https://img.shields.io/badge/Version-3.29.6-blue.svg)](https://github.com/marcusquinn/aidevops/releases)
+[![Version](https://img.shields.io/badge/Version-3.29.8-blue.svg)](https://github.com/marcusquinn/aidevops/releases)
 [![npm version](https://img.shields.io/npm/v/aidevops)](https://www.npmjs.com/package/aidevops)
 [![Homebrew](https://img.shields.io/badge/homebrew-marcusquinn%2Ftap-orange)](https://github.com/marcusquinn/homebrew-tap)
 [![GitHub repository](https://img.shields.io/badge/github-repository-181717.svg?logo=github)](https://github.com/marcusquinn/aidevops)

package/VERSION

@@ -1 +1 @@
-3.29.6
+3.29.8

package/aidevops.sh

@@ -5,7 +5,7 @@
 # AI DevOps Framework CLI
 # Usage: aidevops <command> [options]
 #
-# Version: 3.29.6
+# Version: 3.29.8
 
 set -euo pipefail
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aidevops",
-  "version": "3.29.6",
+  "version": "3.29.8",
   "description": "AI DevOps Framework - AI-assisted development workflows, code quality, and deployment automation",
   "type": "module",
   "workspaces": [

package/packages/gui-web/src/AppWorkspace.tsx

@@ -1,11 +1,12 @@
 /* jshint esversion: 11 */
 import { type ReactElement, type ReactNode, useEffect, useState } from "react";
-import { FiAlertTriangle, FiBell, FiCheckCircle, FiChevronLeft, FiChevronRight, FiCommand, FiGlobe, FiHash, FiHelpCircle, FiInfo, FiLogOut, FiMessageSquare, FiSearch, FiSettings, FiShield, FiTerminal, FiTool, FiUser } from "react-icons/fi";
+import { FiAlertTriangle, FiBell, FiCheckCircle, FiChevronLeft, FiChevronRight, FiCommand, FiFileText, FiGlobe, FiHash, FiHelpCircle, FiInfo, FiLogOut, FiMessageSquare, FiPaperclip, FiSearch, FiSettings, FiShield, FiTerminal, FiTool, FiUser } from "react-icons/fi";
 import type { GuiFileRootId, GuiNotificationSummary, GuiStatusData } from "../../gui-shared/src";
 import { SurfaceGlyph } from "./AppNavigation";
 import type { ConversationMode, ShellMode, SurfaceId, SurfaceNavItem } from "./app-model";
 import { inventorySurfaceConfigs, surfaceIds, text } from "./app-model";
 import { CommandPalette, type CommandPaletteSelection, commandPaletteShortcutQuery } from "./CommandPalette";
+import { CommsConversationSurface } from "./CommsConversationSurface";
 import { FileExplorerSurface } from "./FileExplorerSurface";
 import { AppsSurface, EditableInventorySurface, InstallationSurface } from "./InventorySurfaces";
 import { AiProvidersSurface, LocalReposSurface, LockedVaultGate, OverviewSurface, PlannedSurface, ProjectsSurface, SecuritySurface, VaultSurface } from "./StatusSurfaces";
@@ -213,39 +214,110 @@ function ConversationWorkspace({ conversationMode, selectedLocalRepoIndex, selec
   status: GuiStatusData;
 }) {
   const selectedRepo = status.local_repos.repos[selectedLocalRepoIndex] ?? status.local_repos.repos[0];
-  const selectedSession = selectedRepo === undefined
-    ? undefined
-    : status.opencode_sessions.sessions.find((session) => session.id_ref === selectedSessionId && session.repo_path_ref === selectedRepo.path_ref) ?? status.opencode_sessions.sessions.find((session) => session.repo_path_ref === selectedRepo.path_ref);
+  const selectedSession = selectedRepo === undefined ? undefined : sessionForRepo(status, selectedRepo.path_ref, selectedSessionId);
   const title = conversationMode === "ai" ? selectedRepo?.name ?? text.opencodeSessions : text.teams;
 
+  if (conversationMode === "ai") {
+    return <AiSessionsSurface selectedRepoIndex={selectedLocalRepoIndex} selectedSessionId={selectedSession?.id_ref} status={status} />;
+  }
+
   return (
-    <section className="chat-surface" aria-label={conversationMode === "ai" ? text.opencodeSessions : "People chat"}>
-      <div className="chat-thread-panel">
+    <CommsConversationSurface mode={title === text.teams ? "people" : "channels"} />
+  );
+}
+
+function AiSessionsSurface({ selectedRepoIndex, selectedSessionId, status }: { selectedRepoIndex: number; selectedSessionId?: string; status: GuiStatusData }): ReactElement {
+  const selectedRepo = status.local_repos?.repos?.[selectedRepoIndex] ?? status.local_repos?.repos?.[0];
+  const selectedSession = selectedRepo === undefined ? undefined : sessionForRepo(status, selectedRepo.path_ref, selectedSessionId);
+  const providerOptions = status.oauth_pool?.providers?.filter((provider) => provider.configured || provider.total > 0) ?? [];
+  const sessionTitle = selectedSession?.title ?? "AI session bridge";
+  const sessionMeta = selectedSession ? `${selectedSession.model} via ${selectedSession.agent}` : "No OpenCode session metadata selected";
+
+  return (
+    <section className="chat-surface ai-sessions-surface" aria-label={text.aiSessions} data-tour="ai-sessions-surface">
+      <aside className="chat-thread-panel" aria-label="AI session controls" data-tour="ai-session-list">
         <header className="chat-thread-header">
           <div>
-            <p className="eyebrow">{conversationMode === "ai" ? text.opencodeSessions : "SimpleX channels"}</p>
-            <h2><FiHash aria-hidden="true" /> {title}</h2>
+            <p className="eyebrow">{text.aiSessions}</p>
+            <h2><FiTerminal aria-hidden="true" /> {selectedRepo?.name ?? "Local workspace"}</h2>
           </div>
           <span className="count-pill">{text.readOnly}</span>
         </header>
-        <div className="chat-message-list">
-          {conversationMode === "ai" ? <>
-            <ChatBubble speaker="assistant" title={selectedSession?.title ?? "AI session bridge"} body={selectedSession ? `Most recent OpenCode session metadata: ${selectedSession.model} via ${selectedSession.agent}, updated ${selectedSession.updated_at}. Message payloads stay out of the status API until the turbostarter/ai chat bridge lands.` : "OpenCode session creation and continuation need an audited write route. This panel is ready for the turbostarter/ai chat surface once that adapter is connected."} />
-            <ChatBubble speaker="user" title={selectedRepo?.name ?? "Local repo"} body={selectedRepo ? `Selected repo: ${selectedRepo.path_ref}. Session metadata is grouped per local repo and sorted newest first from ${status.opencode_sessions.path_ref}.` : "No local repos were discovered yet."} />
-          </> : <>
-            <ChatBubble speaker="assistant" title="SimpleX transport" body={text.simplexReady} />
-            <ChatBubble speaker="user" title="People channel" body="Teams and direct messages share the same Slack-like channel layout while protected message payloads remain behind Vault policy." />
-          </>}
+        <div className="notice compact-notice">New, rename, pin, archive, delete, share, and export are visible but disabled until audited AI session write routes land.</div>
+        <div className="sidebar-history-controls">
+          {sessionActions.map((action) => <button disabled key={action} title={`${action} needs the AI session write adapter`} type="button">{action}</button>)}
+        </div>
+        <label className="settings-form">
+          <span>Model/provider</span>
+          <select
+            disabled
+            defaultValue={providerOptions[0]?.provider ?? "local"}
+            title="Model switching needs the Turbostarter AI transport adapter."
+          >
+            {providerOptions.length === 0 ? (
+              <option value="local">Provider setup required</option>
+            ) : (
+              providerOptions.map((provider) => (
+                <option key={provider.provider} value={provider.provider}>
+                  {provider.provider} ({provider.available}/{provider.total})
+                </option>
+              ))
+            )}
+          </select>
+        </label>
+      </aside>
+      <div className="chat-thread-panel" data-tour="ai-session-transcript">
+        <header className="chat-thread-header">
+          <div>
+            <p className="eyebrow">{sessionMeta}</p>
+            <h2><FiHash aria-hidden="true" /> {sessionTitle}</h2>
+          </div>
+          <button disabled title="Convert to worker task needs dispatch backend support" type="button">Create worker task</button>
+        </header>
+        <div className="chat-message-list" data-tour="message-scroller">
+          <MessageMarker label="Session status" detail="MessageScroller-compatible transcript; auto-scroll must pause when the reader scrolls away from the latest message." />
+          <ChatBubble
+            speaker="assistant"
+            title={sessionTitle}
+            body={
+              selectedSession
+                ? `Most recent OpenCode session metadata: ${sessionMeta}, updated ${selectedSession.updated_at}. Message payloads stay out of the status API until the Turbostarter AI chat bridge lands.`
+                : "OpenCode session creation and continuation need an audited write route. This surface is ready for the Turbostarter AI adapter once connected."
+            }
+          />
+          <AttachmentCard label="Context attachment" detail={selectedRepo ? `Selected repo context: ${selectedRepo.path_ref}` : "No local repos were discovered yet."} />
+          <MessageMarker label="Reasoning" detail="Reasoning disclosure, tool status, sources, retries, errors, and token usage render here when the AI transport supplies those parts." />
+          <ToolStatusCard />
         </div>
-        <form className="chat-composer" aria-label="Chat composer">
+        <form className="chat-composer ai-composer" aria-label="AI prompt composer" data-tour="ai-composer">
+          <button disabled title="Attachments need the audited upload/context adapter" type="button"><FiPaperclip aria-hidden="true" /> Attach</button>
           <textarea disabled placeholder={text.chatInputPlaceholder} />
-          <button disabled type="button">Send</button>
+          <button disabled title="Sending needs the Turbostarter AI transport adapter" type="button">Send</button>
         </form>
       </div>
     </section>
   );
 }
 
+const sessionActions = ["New", "Rename", "Pin", "Archive", "Delete", "Share", "Export"] as const;
+
+function sessionForRepo(status: GuiStatusData, repoPathRef: string, selectedSessionId: string | undefined) {
+  const sessions = status.opencode_sessions?.sessions ?? [];
+  return sessions.find((session) => session.id_ref === selectedSessionId && session.repo_path_ref === repoPathRef) ?? sessions.find((session) => session.repo_path_ref === repoPathRef);
+}
+
+function MessageMarker({ detail, label }: { detail: string; label: string }) {
+  return <article className="chat-bubble assistant"><strong>{label}</strong><p>{detail}</p></article>;
+}
+
+function AttachmentCard({ detail, label }: { detail: string; label: string }) {
+  return <article className="chat-bubble user"><strong><FiFileText aria-hidden="true" /> {label}</strong><p>{detail}</p></article>;
+}
+
+function ToolStatusCard() {
+  return <article className="chat-bubble assistant"><strong>Tool status</strong><p>Tool calls, source citations, retries, errors, and usage metadata are reserved for the shared conversation part model.</p></article>;
+}
+
 function ChatBubble({ body, speaker, title }: { body: string; speaker: "assistant" | "user"; title: string }) {
   return (
     <article className={`chat-bubble ${speaker}`}>
@@ -304,9 +376,9 @@ function SurfaceContent({ activeItem, activeSurface, fileRoot, openSurface, stat
     notifications: <NotificationsSurface openSurface={openSurface} status={status} />,
     admin: <AdminSurface />,
     vault: <VaultSurface status={status} />,
-    aiSessions: <PlannedSurface label={text.aiSessions} detail={text.aiSessionsIntro} />,
-    channels: <PlannedSurface label={text.channels} detail={text.channelsIntro} />,
-    directMessages: <PlannedSurface label={text.directMessages} detail={text.directMessagesIntro} />,
+    aiSessions: <AiSessionsSurface selectedRepoIndex={0} status={status} />,
+    channels: <CommsConversationSurface mode="channels" />,
+    directMessages: <CommsConversationSurface mode="directMessages" />,
     workers: <PlannedSurface label={text.workers} detail={text.workersIntro} />,
     repos: <PlannedSurface label={text.repos} detail={text.reposIntro} />,
     deployments: <PlannedSurface label={text.deployments} detail={text.deploymentsIntro} />,

package/packages/gui-web/src/CommsConversationSurface.tsx

@@ -0,0 +1,93 @@
+import { FiAtSign, FiHash, FiMessageSquare, FiSearch } from "react-icons/fi";
+import { sortConversationMessageParts, sortConversationMessages, type GuiConversationMessage, type GuiConversationMessagePart, type GuiConversationThread } from "../../gui-shared/src";
+import { text } from "./app-model";
+import { conversationThreads } from "./conversation-fixtures";
+
+export function CommsConversationSurface({ mode }: { mode: "channels" | "directMessages" | "people" }) {
+  const conversations = mode === "directMessages" ? conversationThreads.filter((thread) => thread.conversation.type === "dm" || thread.conversation.type === "group_dm") : conversationThreads.filter((thread) => thread.conversation.type === "channel");
+  const selectedThread = conversations[0] ?? conversationThreads[0];
+  const partsByMessage = new Map<string, GuiConversationMessagePart[]>();
+
+  for (const part of sortConversationMessageParts(selectedThread.parts)) {
+    partsByMessage.set(part.message_id, [...(partsByMessage.get(part.message_id) ?? []), part]);
+  }
+
+  return (
+    <section className="chat-surface comms-surface" aria-label={mode === "directMessages" ? text.directMessages : text.channels} data-tour="comms-conversations">
+      <aside className="chat-thread-panel conversation-list-panel" aria-label="Conversation list">
+        <header className="chat-thread-header">
+          <div>
+            <p className="eyebrow">Unified conversation model</p>
+            <h2>{mode === "directMessages" ? <FiAtSign aria-hidden="true" /> : <FiHash aria-hidden="true" />} {mode === "directMessages" ? text.directMessages : text.channels}</h2>
+          </div>
+          <button disabled title="Creating conversations needs encrypted transport and audited write routes" type="button">Create</button>
+        </header>
+        <label className="conversation-search"><FiSearch aria-hidden="true" /><span className="sr-only">Search conversations</span><input disabled placeholder="Search channels, DMs, mentions" /></label>
+        <div className="notice compact-notice">{text.simplexReady}</div>
+        <ul className="conversation-list">
+          {conversations.map((thread) => <ConversationListItem key={thread.conversation.id} thread={thread} />)}
+        </ul>
+      </aside>
+      <div className="chat-thread-panel conversation-detail-panel">
+        <header className="chat-thread-header">
+          <div>
+            <p className="eyebrow">{selectedThread.conversation.scope.workspace_ref} · {selectedThread.conversation.status}</p>
+            <h2>{selectedThread.conversation.type === "channel" ? <FiHash aria-hidden="true" /> : <FiMessageSquare aria-hidden="true" />} {selectedThread.conversation.title}</h2>
+          </div>
+          <span className="count-pill">{participantSummary(selectedThread)}</span>
+        </header>
+        <div className="participant-strip">
+          {selectedThread.participants.map((participant) => <span key={participant.id}>{participant.display_name}<small>{participant.kind}</small></span>)}
+        </div>
+        <div className="chat-message-list" data-tour="comms-message-timeline">
+          {sortConversationMessages(selectedThread.messages).map((message) => <ConversationMessageRow key={message.id} message={message} parts={partsByMessage.get(message.id) ?? []} thread={selectedThread} />)}
+        </div>
+        <form className="chat-composer" aria-label="Conversation composer">
+          <textarea disabled placeholder={text.chatInputPlaceholder} />
+          <button disabled title="Sending messages needs the encrypted transport adapter" type="button">Send</button>
+        </form>
+      </div>
+    </section>
+  );
+}
+
+function ConversationListItem({ thread }: { thread: GuiConversationThread }) {
+  const latestMessage = sortConversationMessages(thread.messages).at(-1);
+  const unread = unreadCount(thread);
+
+  return (
+    <li>
+      <button className="surface-link" type="button">
+        <span className="surface-icon" aria-hidden="true">{thread.conversation.type === "channel" ? <FiHash /> : <FiMessageSquare />}</span>
+        <span className="surface-copy"><strong>{thread.conversation.title}</strong><small>{latestMessage ? latestMessage.created_at : "No messages yet"}</small></span>
+        {unread > 0 ? <em>{unread}</em> : null}
+      </button>
+    </li>
+  );
+}
+
+function ConversationMessageRow({ message, parts, thread }: { message: GuiConversationMessage; parts: GuiConversationMessagePart[]; thread: GuiConversationThread }) {
+  const sender = thread.participants.find((participant) => participant.id === message.sender_participant_id);
+  const reactions = thread.reactions.filter((reaction) => reaction.message_id === message.id);
+  const speaker = message.sender_kind === "human" ? "user" : "assistant";
+
+  return (
+    <article className={`chat-bubble ${speaker}`} data-sender-kind={message.sender_kind}>
+      <strong>{sender?.display_name ?? message.sender_kind}</strong>
+      {parts.map((part) => <p key={part.id}>{part.text ?? part.kind}</p>)}
+      <small>{message.status} · {message.created_at}</small>
+      {reactions.length > 0 ? <div className="reaction-row">{reactions.map((reaction) => <span key={reaction.id}>{reaction.reaction}</span>)}</div> : null}
+    </article>
+  );
+}
+
+function participantSummary(thread: GuiConversationThread): string {
+  const active = thread.participants.filter((participant) => participant.membership_state === "active").length;
+  return `${active} members`;
+}
+
+function unreadCount(thread: GuiConversationThread): number {
+  const lastSequence = Math.max(0, ...thread.messages.map((message) => message.sequence));
+  const localRead = thread.read_states[0]?.last_read_sequence ?? 0;
+  return Math.max(0, lastSequence - localRead);
+}

package/packages/gui-web/src/InventorySurfaces.tsx

@@ -1,6 +1,6 @@
 import type { GuiAppActionId, GuiAppActionJobSummary, GuiManagedAppSummary, GuiResponseEnvelope, GuiStatusData } from "@aidevops/gui-shared";
 import { type Dispatch, type ReactElement, type SetStateAction, useEffect, useState } from "react";
-import { FiDownload, FiExternalLink, FiRefreshCw, FiRepeat, FiTrash2 } from "react-icons/fi";
+import { FiChevronDown, FiDownload, FiExternalLink, FiRefreshCw, FiRepeat, FiTrash2 } from "react-icons/fi";
 import type { InventoryColumn } from "./app-model";
 import { installationRows, text } from "./app-model";
 
@@ -13,9 +13,17 @@ let draftRowCounter = 0;
 
 export function AppsSurface({ status }: { status: GuiStatusData }): ReactElement {
   const [selectedJobId, setSelectedJobId] = useState<string | null>(null);
+  const [expandedAppIds, setExpandedAppIds] = useState<Set<string>>(() => new Set(status.managed_apps.length > 0 ? [status.managed_apps[0].id] : []));
   const [jobs, setJobs] = useState<Record<string, GuiAppActionJobSummary>>({});
   const selectedJob = selectedJobId === null ? null : jobs[selectedJobId] ?? null;
 
+  useEffect(() => {
+    if (status.managed_apps.length === 0) {
+      return;
+    }
+    setExpandedAppIds((current) => current.size === 0 ? new Set([status.managed_apps[0].id]) : current);
+  }, [status.managed_apps]);
+
   useEffect(() => {
     if (selectedJob === null || selectedJob.status !== "running") {
       return undefined;
@@ -37,28 +45,51 @@ export function AppsSurface({ status }: { status: GuiStatusData }): ReactElement
       </div>
       <div className="managed-app-list">
         {status.managed_apps.map((app) => (
-          <ManagedAppRow app={app} key={app.id} onJob={(job) => { setJobs((current) => ({ ...current, [job.id]: job })); setSelectedJobId(job.id); }} />
+          <ManagedAppPanel
+            app={app}
+            expanded={expandedAppIds.has(app.id)}
+            job={jobForApp(app.id, jobs, selectedJob)}
+            key={app.id}
+            onJob={(job) => {
+              setJobs((current) => ({ ...current, [job.id]: job }));
+              setSelectedJobId(job.id);
+              setExpandedAppIds((current) => toggledAppIds(current, app.id, true));
+            }}
+            onToggle={() => setExpandedAppIds((current) => toggledAppIds(current, app.id))}
+          />
         ))}
       </div>
-      {selectedJob ? <AppActionTerminal job={selectedJob} /> : <p className="empty-state compact-notice">Install/update actions run as allowlisted background jobs and stream here. xterm.js with a node-pty bridge is the right next step for full TUI apps such as OpenCode; this view starts with non-interactive command logs.</p>}
+      <p className="empty-state compact-notice">Install/update actions run as allowlisted background jobs and stream inside each app panel. xterm.js with a node-pty bridge is the right next step for full TUI apps such as OpenCode; this view starts with non-interactive command logs.</p>
     </section>
   );
 }
 
-function ManagedAppRow({ app, onJob }: { app: GuiManagedAppSummary; onJob: (job: GuiAppActionJobSummary) => void }): ReactElement {
+function ManagedAppPanel({ app, expanded, job, onJob, onToggle }: { app: GuiManagedAppSummary; expanded: boolean; job: GuiAppActionJobSummary | null; onJob: (job: GuiAppActionJobSummary) => void; onToggle: () => void }): ReactElement {
   return (
-    <article className="managed-app-row">
-      <div className="managed-app-main">
-        <div>
-          <p className="eyebrow">{app.category}</p>
-          <h3>{app.name}</h3>
-          <p>{app.description}</p>
-        </div>
-        <div className="managed-app-links">
-          <OriginLink href={app.origin_website_url} label={text.website} />
-          <OriginLink href={app.origin_repo_url} label="Repo" />
+    <article className={expanded ? "managed-app-card expanded" : "managed-app-card"}>
+      <button aria-expanded={expanded} className="managed-app-summary" data-tooltip={`${expanded ? "Collapse" : "Expand"} ${app.name} controls`} onClick={onToggle} type="button">
+        <span className="managed-app-title-block">
+          <span className="eyebrow">{app.category}</span>
+          <strong>{app.name}</strong>
+          <span>{app.description}</span>
+        </span>
+        <span className="managed-app-summary-meta">
+          <SummaryChip label="Status" value={app.status} />
+          <SummaryChip label="Installed" value={app.installed_version} />
+          <SummaryChip label="Latest" value={app.latest_version} />
+          <FiChevronDown aria-hidden="true" className="managed-app-chevron" />
+        </span>
+      </button>
+      {expanded ? <div className="managed-app-body">
+        <div className="managed-app-toolbar">
+          <div className="managed-app-links">
+            <OriginLink href={app.origin_website_url} label={text.website} />
+            <OriginLink href={app.origin_repo_url} label="Repo" />
+          </div>
+          <div className="managed-app-actions">
+            {app.actions.map((action) => <AppActionButton action={action.id} app={app} disabled={!action.enabled} key={action.id} onJob={onJob} commandPreview={action.command_preview} />)}
+          </div>
         </div>
-      </div>
       <div className="managed-app-details">
         <ToggleSwitch checked={app.aidevops_install} label="setup installs" />
         <ToggleSwitch checked={app.aidevops_update} label="update maintains" />
@@ -67,19 +98,22 @@ function ManagedAppRow({ app, onJob }: { app: GuiManagedAppSummary; onJob: (job:
         <AppMeta label={text.path} value={app.install_path_ref} />
         <AppMeta label="Status" value={app.status} />
       </div>
-      <div className="managed-app-actions">
-        {app.actions.map((action) => <AppActionButton action={action.id} app={app} disabled={!action.enabled} key={action.id} onJob={onJob} title={action.command_preview} />)}
-      </div>
+      {job ? <AppActionTerminal job={job} /> : <p className="empty-state compact-notice">No recent command output for this app. Run an action to open this app's terminal log.</p>}
+      </div> : null}
     </article>
   );
 }
 
+function SummaryChip({ label, value }: { label: string; value: string }): ReactElement {
+  return <span className="managed-summary-chip"><small>{label}</small><span>{value}</span></span>;
+}
+
 function OriginLink({ href, label }: { href: string; label: string }): ReactElement {
   if (href.length === 0) {
     return <span className="origin-missing">{label}: source pending</span>;
   }
 
-  return <a href={href} rel="noreferrer" target="_blank">{label} <FiExternalLink aria-hidden="true" /></a>;
+  return <a data-tooltip={`Open ${label.toLowerCase()} destination`} href={href} rel="noreferrer" target="_blank">{label} <FiExternalLink aria-hidden="true" /></a>;
 }
 
 function ToggleSwitch({ checked, label }: { checked: boolean; label: string }): ReactElement {
@@ -90,7 +124,7 @@ function AppMeta({ label, value }: { label: string; value: string }): ReactEleme
   return <span className="app-meta"><small>{label}</small><strong>{value}</strong></span>;
 }
 
-function AppActionButton({ action, app, disabled, onJob, title }: { action: GuiAppActionId; app: GuiManagedAppSummary; disabled: boolean; onJob: (job: GuiAppActionJobSummary) => void; title: string }): ReactElement {
+function AppActionButton({ action, app, commandPreview, disabled, onJob }: { action: GuiAppActionId; app: GuiManagedAppSummary; commandPreview: string; disabled: boolean; onJob: (job: GuiAppActionJobSummary) => void }): ReactElement {
   const icon = action === "install" ? <FiDownload /> : action === "update" ? <FiRefreshCw /> : action === "reinstall" ? <FiRepeat /> : <FiTrash2 />;
 
   async function runAction(): Promise<void> {
@@ -106,7 +140,7 @@ function AppActionButton({ action, app, disabled, onJob, title }: { action: GuiA
     onJob(envelope.data);
   }
 
-  return <button aria-label={`${action} ${app.name}`} className="app-action-button" disabled={disabled} onClick={() => void runAction()} title={title} type="button">{icon}</button>;
+  return <button aria-label={`${action} ${app.name}`} className={action === "remove" ? "app-action-button remove" : "app-action-button"} data-tooltip={commandPreview} disabled={disabled} onClick={() => void runAction()} type="button">{icon}<span>{action}</span></button>;
 }
 
 function AppActionTerminal({ job }: { job: GuiAppActionJobSummary }): ReactElement {
@@ -127,6 +161,25 @@ async function refreshJob(jobId: string, setJobs: Dispatch<SetStateAction<Record
   setJobs((current) => ({ ...current, [envelope.data.id]: envelope.data }));
 }
 
+function jobForApp(appId: string, jobs: Record<string, GuiAppActionJobSummary>, selectedJob: GuiAppActionJobSummary | null): GuiAppActionJobSummary | null {
+  if (selectedJob?.app_id === appId) {
+    return selectedJob;
+  }
+
+  return Object.values(jobs).reverse().find((job) => job.app_id === appId) ?? null;
+}
+
+function toggledAppIds(current: Set<string>, appId: string, forceOpen = false): Set<string> {
+  const next = new Set(current);
+  if (forceOpen || !next.has(appId)) {
+    next.add(appId);
+  } else {
+    next.delete(appId);
+  }
+
+  return next;
+}
+
 export function InstallationSurface(): ReactElement {
   return (
     <section className="panel" aria-label={text.installation}>

package/packages/gui-web/src/conversation-fixtures.ts

@@ -0,0 +1,38 @@
+import type { GuiConversationThread } from "../../gui-shared/src";
+
+export const conversationThreads: GuiConversationThread[] = [
+  {
+    conversation: { id: "channel-general", type: "channel", title: "general", scope: { tenant_ref: "local", workspace_ref: "aidevops", repo_ref: null }, source_ref: "seed:channels/general", status: "read_only", created_at: "2026-06-27T00:00:00Z", updated_at: "2026-06-27T12:20:00Z" },
+    participants: [
+      { id: "participant-local", conversation_id: "channel-general", kind: "human", display_name: "Local user", identity_ref: "local:user", agent_ref: null, worker_ref: null, membership_state: "active", joined_at: "2026-06-27T00:00:00Z" },
+      { id: "participant-ai", conversation_id: "channel-general", kind: "ai_assistant", display_name: "AI DevOps", identity_ref: null, agent_ref: "aidevops", worker_ref: null, membership_state: "active", joined_at: "2026-06-27T00:00:00Z" },
+      { id: "participant-system", conversation_id: "channel-general", kind: "system_bot", display_name: "System", identity_ref: null, agent_ref: null, worker_ref: null, membership_state: "active", joined_at: "2026-06-27T00:00:00Z" },
+    ],
+    messages: [
+      { id: "message-general-1", conversation_id: "channel-general", sender_participant_id: "participant-system", sender_kind: "system", sequence: 1, status: "sent", usage: null, created_at: "2026-06-27T12:00:00Z", edited_at: null },
+      { id: "message-general-2", conversation_id: "channel-general", sender_participant_id: "participant-ai", sender_kind: "ai_assistant", sequence: 2, status: "delivered", usage: { provider_ref: "local", model_ref: "workflow-summary", input_tokens: 0, output_tokens: 0, total_tokens: 0, cost_ref: null }, created_at: "2026-06-27T12:15:00Z", edited_at: null },
+    ],
+    parts: [
+      { id: "part-general-1", message_id: "message-general-1", kind: "event_marker", ordinal: 1, text: "#general is ready for repo, deployment, review, and incident coordination.", payload_json: null, file_ref: null, source_ref: "seed" },
+      { id: "part-general-2", message_id: "message-general-2", kind: "text", ordinal: 1, text: "Mention @AI DevOps or a worker to turn a thread into an audited task once write routes land.", payload_json: null, file_ref: null, source_ref: null },
+    ],
+    reactions: [{ id: "reaction-general-1", message_id: "message-general-2", participant_id: "participant-local", reaction: "ack", created_at: "2026-06-27T12:16:00Z" }],
+    read_states: [{ conversation_id: "channel-general", participant_id: "participant-local", last_read_message_id: "message-general-1", last_read_sequence: 1, updated_at: "2026-06-27T12:10:00Z" }],
+  },
+  {
+    conversation: { id: "channel-workers", type: "channel", title: "worker-feed", scope: { tenant_ref: "local", workspace_ref: "aidevops", repo_ref: "current" }, source_ref: "seed:channels/worker-feed", status: "read_only", created_at: "2026-06-27T00:00:00Z", updated_at: "2026-06-27T12:30:00Z" },
+    participants: [{ id: "participant-worker", conversation_id: "channel-workers", kind: "worker", display_name: "Worker queue", identity_ref: null, agent_ref: null, worker_ref: "workers", membership_state: "active", joined_at: "2026-06-27T00:00:00Z" }],
+    messages: [{ id: "message-workers-1", conversation_id: "channel-workers", sender_participant_id: "participant-worker", sender_kind: "worker", sequence: 1, status: "delivered", usage: null, created_at: "2026-06-27T12:30:00Z", edited_at: null }],
+    parts: [{ id: "part-workers-1", message_id: "message-workers-1", kind: "event_marker", ordinal: 1, text: "Worker events for reviews, deployments, incidents, and releases collect here.", payload_json: null, file_ref: null, source_ref: "seed" }],
+    reactions: [],
+    read_states: [{ conversation_id: "channel-workers", participant_id: "participant-local", last_read_message_id: null, last_read_sequence: 0, updated_at: "2026-06-27T12:00:00Z" }],
+  },
+  {
+    conversation: { id: "dm-ai-devops", type: "dm", title: "AI DevOps", scope: { tenant_ref: "local", workspace_ref: "aidevops", repo_ref: null }, source_ref: "seed:dms/ai-devops", status: "read_only", created_at: "2026-06-27T00:00:00Z", updated_at: "2026-06-27T12:40:00Z" },
+    participants: [{ id: "participant-dm-local", conversation_id: "dm-ai-devops", kind: "human", display_name: "Local user", identity_ref: "local:user", agent_ref: null, worker_ref: null, membership_state: "active", joined_at: "2026-06-27T00:00:00Z" }, { id: "participant-dm-ai", conversation_id: "dm-ai-devops", kind: "ai_assistant", display_name: "AI DevOps", identity_ref: null, agent_ref: "aidevops", worker_ref: null, membership_state: "active", joined_at: "2026-06-27T00:00:00Z" }],
+    messages: [{ id: "message-dm-1", conversation_id: "dm-ai-devops", sender_participant_id: "participant-dm-ai", sender_kind: "ai_assistant", sequence: 1, status: "delivered", usage: null, created_at: "2026-06-27T12:40:00Z", edited_at: null }],
+    parts: [{ id: "part-dm-1", message_id: "message-dm-1", kind: "text", ordinal: 1, text: "Direct support threads share the same message parts, participants, reactions, and read state as channels.", payload_json: null, file_ref: null, source_ref: null }],
+    reactions: [],
+    read_states: [{ conversation_id: "dm-ai-devops", participant_id: "participant-dm-local", last_read_message_id: null, last_read_sequence: 0, updated_at: "2026-06-27T12:00:00Z" }],
+  },
+];

package/packages/gui-web/src/styles.css

@@ -69,6 +69,7 @@ body {
     radial-gradient(ellipse at top left, color-mix(in srgb, var(--accent) 16%, transparent) 0%, transparent 36%),
     var(--bg-secondary);
   color: var(--text-primary);
+  font-family: var(--font-family-app);
   line-height: 1.6;
   margin: 0;
   font-size: var(--font-size-app);
@@ -1286,11 +1287,28 @@ code {
   gap: 16px;
 }
 
+.sr-only {
+  height: 1px;
+  margin: -1px;
+  overflow: hidden;
+  position: absolute;
+  width: 1px;
+}
+
 .chat-surface {
   display: grid;
+  gap: 16px;
   min-height: 100%;
 }
 
+.ai-sessions-surface {
+  grid-template-columns: minmax(248px, 320px) minmax(0, 1fr);
+}
+
+.comms-surface {
+  grid-template-columns: minmax(260px, 340px) minmax(0, 1fr);
+}
+
 .chat-thread-panel {
   background: var(--surface-elevated);
   border: 1px solid var(--border);
@@ -1346,6 +1364,69 @@ code {
   margin: 0;
 }
 
+.chat-bubble small {
+  color: var(--text-muted);
+}
+
+.chat-bubble[data-sender-kind="system"],
+.chat-bubble[data-sender-kind="worker"] {
+  border-style: dashed;
+}
+
+.conversation-list-panel {
+  grid-template-rows: auto auto auto minmax(0, 1fr);
+}
+
+.conversation-search {
+  align-items: center;
+  background: var(--surface-muted);
+  border: 1px solid var(--border);
+  border-radius: 14px;
+  display: flex;
+  gap: 8px;
+  margin: 14px;
+  padding: 10px 12px;
+}
+
+.conversation-search input {
+  background: transparent;
+  border: 0;
+  color: var(--text-secondary);
+  min-width: 0;
+  width: 100%;
+}
+
+.conversation-list {
+  display: grid;
+  gap: 8px;
+  list-style: none;
+  margin: 0;
+  padding: 0 14px 14px;
+}
+
+.participant-strip,
+.reaction-row {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px;
+  padding: 12px 18px 0;
+}
+
+.participant-strip span,
+.reaction-row span {
+  background: var(--surface-muted);
+  border: 1px solid var(--border);
+  border-radius: 999px;
+  color: var(--text-secondary);
+  display: inline-flex;
+  gap: 6px;
+  padding: 6px 9px;
+}
+
+.participant-strip small {
+  color: var(--text-muted);
+}
+
 .chat-composer {
   border-top: 1px solid var(--border);
   display: grid;
@@ -1354,6 +1435,10 @@ code {
   padding: 14px;
 }
 
+.chat-composer.ai-composer {
+  grid-template-columns: auto minmax(0, 1fr) auto;
+}
+
 .chat-composer textarea {
   background: var(--surface-muted);
   border: 1px solid var(--border);
@@ -1365,14 +1450,33 @@ code {
 }
 
 .chat-composer button {
+  align-items: center;
   background: color-mix(in srgb, var(--accent) 16%, transparent);
   border: 1px solid color-mix(in srgb, var(--accent) 34%, transparent);
   border-radius: 14px;
   color: var(--accent);
+  display: inline-flex;
   font-weight: 900;
+  gap: 8px;
   padding: 0 18px;
 }
 
+@media (max-width: 980px) {
+  .ai-sessions-surface,
+  .comms-surface {
+    grid-template-columns: 1fr;
+  }
+
+  .chat-composer {
+    grid-template-columns: 1fr;
+  }
+
+  .chat-composer button {
+    justify-content: center;
+    min-height: 44px;
+  }
+}
+
 .hero-panel,
 .panel,
 .metric-card,
@@ -1869,38 +1973,122 @@ code {
 }
 
 .managed-app-list {
-  background: var(--surface-muted);
-  border: 1px solid var(--border);
-  border-radius: 16px;
+  gap: 12px;
   margin-bottom: 12px;
+  overflow: visible;
+}
+
+.managed-app-card {
+  background:
+    linear-gradient(135deg, color-mix(in srgb, var(--accent) 7%, transparent), transparent 34%),
+    var(--surface-muted);
+  border: 1px solid var(--border);
+  border-radius: 18px;
+  box-shadow: inset 0 1px 0 rgb(255 255 255 / 7%);
+  overflow: visible;
+}
+
+.managed-app-card.expanded {
+  border-color: color-mix(in srgb, var(--accent) 32%, var(--border));
 }
 
-.managed-app-row {
+.managed-app-summary {
+  align-items: center;
+  background: transparent;
+  border: 0;
+  color: var(--text-primary);
   display: grid;
-  gap: 14px;
-  grid-template-columns: minmax(220px, 1.3fr) minmax(260px, 1.7fr) auto;
-  padding: 14px;
+  gap: 16px;
+  grid-template-columns: minmax(0, 1fr) auto;
+  padding: 16px;
+  text-align: left;
+  width: 100%;
 }
 
-.managed-app-row + .managed-app-row {
-  border-top: 1px solid var(--border);
+.managed-app-summary:hover,
+.managed-app-summary:focus-visible {
+  background: color-mix(in srgb, var(--accent) 7%, transparent);
+  outline: none;
 }
 
-.managed-app-main,
-.managed-app-main > div,
+.managed-app-title-block,
 .app-meta {
   display: grid;
-  gap: 6px;
+  gap: 7px;
   min-width: 0;
 }
 
-.managed-app-main h3,
-.managed-app-main p {
-  margin: 0;
+.managed-app-title-block strong {
+  font-size: clamp(1.12rem, 2vw, 1.4rem);
+  letter-spacing: -0.04em;
+  line-height: 1.15;
 }
 
-.managed-app-main p:not(.eyebrow) {
+.managed-app-title-block > span:last-child {
   color: var(--text-secondary);
+  max-width: 72ch;
+}
+
+.managed-app-summary-meta {
+  align-items: center;
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px;
+  justify-content: end;
+  min-width: min(420px, 38vw);
+}
+
+.managed-summary-chip {
+  background: color-mix(in srgb, var(--surface-elevated) 92%, transparent);
+  border: 1px solid var(--border);
+  border-radius: 999px;
+  display: inline-grid;
+  gap: 1px;
+  min-width: 118px;
+  padding: 7px 11px;
+}
+
+.managed-summary-chip small {
+  color: var(--text-muted);
+  font-size: 0.66rem;
+  font-weight: 900;
+  line-height: 1;
+  text-transform: uppercase;
+}
+
+.managed-summary-chip span {
+  color: var(--text-primary);
+  font-size: 0.84rem;
+  font-weight: 800;
+  max-width: 18ch;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.managed-app-chevron {
+  color: var(--accent);
+  flex: 0 0 auto;
+  transition: transform 180ms ease;
+}
+
+.managed-app-card.expanded .managed-app-chevron {
+  transform: rotate(180deg);
+}
+
+.managed-app-body {
+  border-top: 1px solid var(--border);
+  display: grid;
+  gap: 14px;
+  padding: 0 16px 16px;
+}
+
+.managed-app-toolbar {
+  align-items: start;
+  display: grid;
+  gap: 12px;
+  grid-template-columns: minmax(0, 1fr) auto;
+  padding-top: 14px;
 }
 
 .managed-app-links,
@@ -1911,6 +2099,10 @@ code {
   gap: 8px;
 }
 
+.managed-app-actions {
+  justify-content: end;
+}
+
 .managed-app-links a,
 .origin-missing {
   align-items: center;
@@ -1921,18 +2113,28 @@ code {
   font-size: 0.78rem;
   font-weight: 800;
   gap: 4px;
+  max-width: 100%;
   padding: 6px 9px;
+  position: relative;
   text-decoration: none;
 }
 
+.managed-app-links a:hover,
+.managed-app-links a:focus-visible {
+  background: color-mix(in srgb, var(--accent) 12%, transparent);
+  border-color: color-mix(in srgb, var(--accent) 48%, var(--border));
+  color: var(--accent);
+  outline: none;
+}
+
 .origin-missing {
   color: var(--text-muted);
 }
 
 .managed-app-details {
   display: grid;
-  gap: 8px;
-  grid-template-columns: repeat(3, minmax(0, 1fr));
+  gap: 10px;
+  grid-template-columns: repeat(auto-fit, minmax(168px, 1fr));
 }
 
 .managed-toggle,
@@ -1941,7 +2143,8 @@ code {
   border: 1px solid var(--border);
   border-radius: 12px;
   min-width: 0;
-  padding: 8px 10px;
+  min-height: 64px;
+  padding: 10px 12px;
 }
 
 .managed-toggle {
@@ -1987,30 +2190,68 @@ code {
 .app-meta strong {
   color: var(--text-primary);
   font-size: 0.84rem;
+  line-height: 1.35;
   overflow-wrap: anywhere;
+  word-break: break-word;
 }
 
 .app-action-button {
   align-items: center;
-  border-radius: 12px;
+  background: color-mix(in srgb, var(--accent) 16%, var(--surface-elevated));
+  border: 1px solid color-mix(in srgb, var(--accent) 48%, var(--border));
+  border-radius: 999px;
+  color: var(--accent);
   display: inline-flex;
-  height: 38px;
+  gap: 7px;
+  min-height: 42px;
   justify-content: center;
-  padding: 0;
-  width: 38px;
+  padding: 0 12px;
+  position: relative;
+  transition: background 140ms ease, border-color 140ms ease, color 140ms ease, transform 140ms ease;
+}
+
+.app-action-button span {
+  font-size: 0.7rem;
+  font-weight: 900;
+  text-transform: uppercase;
+}
+
+.app-action-button:hover,
+.app-action-button:focus-visible {
+  background: var(--accent);
+  border-color: var(--accent);
+  color: var(--bg-primary);
+  outline: none;
+  transform: translateY(-1px);
+}
+
+.app-action-button.remove {
+  background: color-mix(in srgb, #ef4444 12%, var(--surface-elevated));
+  border-color: color-mix(in srgb, #ef4444 45%, var(--border));
+  color: #ff8a8a;
+}
+
+.app-action-button.remove:hover,
+.app-action-button.remove:focus-visible {
+  background: #ef4444;
+  border-color: #ef4444;
+  color: white;
 }
 
 .app-action-button:disabled {
   color: var(--text-muted);
   cursor: not-allowed;
   opacity: 0.45;
+  transform: none;
 }
 
 .app-terminal {
-  background: var(--code-bg);
+  background:
+    linear-gradient(180deg, rgb(255 255 255 / 4%), transparent),
+    #050806;
   border: 1px solid var(--border);
   border-radius: 16px;
-  color: var(--text-secondary);
+  color: color-mix(in srgb, var(--accent) 78%, white);
   overflow: hidden;
 }
 
@@ -2018,16 +2259,57 @@ code {
   align-items: center;
   border-bottom: 1px solid var(--border);
   display: flex;
+  gap: 12px;
   justify-content: space-between;
   padding: 10px 12px;
 }
 
+.app-terminal header span {
+  color: var(--text-muted);
+  text-align: right;
+}
+
 .app-terminal pre {
   margin: 0;
-  max-height: 360px;
+  max-height: 240px;
   overflow: auto;
   padding: 12px;
   white-space: pre-wrap;
+  word-break: break-word;
+}
+
+[data-tooltip] {
+  position: relative;
+}
+
+[data-tooltip]::after {
+  background: color-mix(in srgb, var(--surface-elevated) 94%, black);
+  border: 1px solid color-mix(in srgb, var(--accent) 36%, var(--border));
+  border-radius: 10px;
+  bottom: calc(100% + 8px);
+  box-shadow: 0 18px 46px rgb(0 0 0 / 38%);
+  color: var(--text-primary);
+  content: attr(data-tooltip);
+  font-size: 0.72rem;
+  font-weight: 700;
+  left: 50%;
+  line-height: 1.35;
+  max-width: min(320px, 72vw);
+  opacity: 0;
+  padding: 8px 10px;
+  pointer-events: none;
+  position: absolute;
+  text-align: left;
+  transform: translate(-50%, 4px);
+  transition: opacity 140ms ease, transform 140ms ease;
+  width: max-content;
+  z-index: 40;
+}
+
+[data-tooltip]:hover::after,
+[data-tooltip]:focus-visible::after {
+  opacity: 1;
+  transform: translate(-50%, 0);
 }
 
 .data-row,
@@ -2715,9 +2997,16 @@ code {
     grid-template-columns: 1fr;
   }
 
-  .managed-app-row {
+  .managed-app-summary,
+  .managed-app-toolbar {
     grid-template-columns: 1fr;
   }
+
+  .managed-app-summary-meta,
+  .managed-app-actions {
+    justify-content: start;
+    min-width: 0;
+  }
 }
 
 @media (max-width: 980px) {

package/setup.sh

@@ -12,7 +12,7 @@ shopt -s inherit_errexit 2>/dev/null || true
 # AI Assistant Server Access Framework Setup Script
 # Helps developers set up the framework for their infrastructure
 #
-# Version: 3.29.6
+# Version: 3.29.8
 #
 # Quick Install:
 #   npm install -g aidevops && aidevops update          (recommended)