aidevops 3.29.1 → 3.29.3

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.1-blue.svg)](https://github.com/marcusquinn/aidevops/releases)
+[![Version](https://img.shields.io/badge/Version-3.29.3-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.1
+3.29.3

package/aidevops.sh

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

package/package.json

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

package/packages/gui-shared/src/contracts.ts

@@ -185,6 +185,100 @@ export interface GuiOpenCodeSessionRegistrySummary {
   sessions: GuiOpenCodeSessionSummary[];
 }
 
+export type GuiConversationType = "ai_session" | "channel" | "dm" | "group_dm" | "worker_thread";
+
+export type GuiConversationParticipantKind = "human" | "ai_assistant" | "worker" | "system_bot";
+
+export type GuiConversationMessageSenderKind = GuiConversationParticipantKind | "system";
+
+export type GuiConversationMessagePartKind = "text" | "file" | "tool_call" | "source" | "tambo_component" | "approval_prompt" | "event_marker";
+
+export interface GuiConversationScope {
+  tenant_ref: string;
+  workspace_ref: string;
+  repo_ref: string | null;
+}
+
+export interface GuiConversation {
+  id: string;
+  type: GuiConversationType;
+  title: string;
+  scope: GuiConversationScope;
+  source_ref: string;
+  status: "active" | "archived" | "read_only";
+  created_at: string;
+  updated_at: string;
+}
+
+export interface GuiConversationParticipant {
+  id: string;
+  conversation_id: string;
+  kind: GuiConversationParticipantKind;
+  display_name: string;
+  identity_ref: string | null;
+  agent_ref: string | null;
+  worker_ref: string | null;
+  membership_state: "active" | "invited" | "left" | "removed";
+  joined_at: string;
+}
+
+export interface GuiConversationUsageMetadata {
+  provider_ref: string | null;
+  model_ref: string | null;
+  input_tokens: number;
+  output_tokens: number;
+  total_tokens: number;
+  cost_ref: string | null;
+}
+
+export interface GuiConversationMessage {
+  id: string;
+  conversation_id: string;
+  sender_participant_id: string | null;
+  sender_kind: GuiConversationMessageSenderKind;
+  sequence: number;
+  status: "draft" | "sent" | "delivered" | "failed" | "redacted";
+  usage: GuiConversationUsageMetadata | null;
+  created_at: string;
+  edited_at: string | null;
+}
+
+export interface GuiConversationMessagePart {
+  id: string;
+  message_id: string;
+  kind: GuiConversationMessagePartKind;
+  ordinal: number;
+  text: string | null;
+  payload_json: Record<string, unknown> | null;
+  file_ref: string | null;
+  source_ref: string | null;
+}
+
+export interface GuiConversationReaction {
+  id: string;
+  message_id: string;
+  participant_id: string;
+  reaction: string;
+  created_at: string;
+}
+
+export interface GuiConversationReadState {
+  conversation_id: string;
+  participant_id: string;
+  last_read_message_id: string | null;
+  last_read_sequence: number;
+  updated_at: string;
+}
+
+export interface GuiConversationThread {
+  conversation: GuiConversation;
+  participants: GuiConversationParticipant[];
+  messages: GuiConversationMessage[];
+  parts: GuiConversationMessagePart[];
+  reactions: GuiConversationReaction[];
+  read_states: GuiConversationReadState[];
+}
+
 export type GuiAiProviderId = "anthropic" | "openai" | "cursor" | "google";
 
 export interface GuiOAuthPoolAccountSummary {
@@ -499,3 +593,19 @@ export function assertNoSecretSentinels(value: unknown): void {
 export function isReadOnlyManifest(manifest: GuiRouteManifest): boolean {
   return manifest.method === "GET" && manifest.classification === "read";
 }
+
+export function sortConversationMessages<TMessage extends Pick<GuiConversationMessage, "sequence" | "created_at">>(messages: TMessage[]): TMessage[] {
+  return [...messages].sort((left, right) => left.sequence - right.sequence || left.created_at.localeCompare(right.created_at));
+}
+
+export function sortConversationMessageParts<TPart extends Pick<GuiConversationMessagePart, "ordinal">>(parts: TPart[]): TPart[] {
+  return [...parts].sort((left, right) => left.ordinal - right.ordinal);
+}
+
+export function participantCanReadConversation(thread: GuiConversationThread, participantId: string): boolean {
+  return thread.participants.some((participant) => participant.id === participantId && participant.membership_state === "active");
+}
+
+export function conversationHasScope(thread: GuiConversationThread, scope: GuiConversationScope): boolean {
+  return thread.conversation.scope.tenant_ref === scope.tenant_ref && thread.conversation.scope.workspace_ref === scope.workspace_ref && thread.conversation.scope.repo_ref === scope.repo_ref;
+}

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

@@ -129,7 +129,7 @@ function WorkspaceHeader({ activeItem, activeSectionLabel, activeSurface, canGoB
       </div>
       <div className="header-actions">
         <div className="header-action-menu">
-          <button aria-label="Open help" className="header-icon-button" onClick={() => openItem({ surface: "help" })} title="Help (?)" type="button">
+          <button aria-label="Open signposts and help" className="header-icon-button" onClick={() => openItem({ surface: "help" })} title="Signposts and help (?)" type="button">
             <FiHelpCircle aria-hidden="true" />
           </button>
           <button aria-expanded={notificationsOpen} aria-label="Open notifications" className="header-icon-button" onClick={() => { setNotificationsOpen((current) => !current); setProfileOpen(false); }} type="button">
@@ -283,6 +283,12 @@ function SurfaceContent({ activeItem, activeSurface, fileRoot, status }: {
     notifications: <NotificationsSurface />,
     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} />,
+    workers: <PlannedSurface label={text.workers} detail={text.workersIntro} />,
+    repos: <PlannedSurface label={text.repos} detail={text.reposIntro} />,
+    deployments: <PlannedSurface label={text.deployments} detail={text.deploymentsIntro} />,
     routines: <PlannedSurface label={text.routines} detail={text.routineDetail} />,
     devices: <PlannedSurface label={text.devices} detail={text.devicesIntro} />,
     vpnsProxies: <PlannedSurface label={text.vpnsProxies} detail={text.vpnsProxiesIntro} />,

package/packages/gui-web/src/app-model.ts

@@ -59,6 +59,12 @@ export const surfaceIds = [
   "config",
   "localSetup",
   "git",
+  "aiSessions",
+  "channels",
+  "directMessages",
+  "workers",
+  "repos",
+  "deployments",
   "routines",
   "devices",
   "vpnsProxies",
@@ -163,6 +169,10 @@ export const text = {
   hostsIntro: "Recommended and user-owned hosting providers with setup notes later.",
   addRow: "Add row",
   channel: "Channel",
+  channels: "Channels",
+  channelsIntro: "Team channels use the unified conversation model. Message payloads stay read-only placeholders until encrypted transport and audited write routes land.",
+  deployments: "Deployments",
+  deploymentsIntro: "Deployment activity, environments, releases, and rollout checks will collect here after repo/deploy adapters land.",
   installation: "Installation",
   installationIntro: "Optional aidevops setup/update components. Toggles are shown as planned controls until writes are enabled.",
   install: "Install",
@@ -220,15 +230,20 @@ export const text = {
   newSession: "New Session",
   sessionHistory: "Session history",
   opencodeSessions: "OpenCode sessions",
+  aiSessions: "AI Sessions",
+  aiSessionsIntro: "AI sessions bridge OpenCode metadata today and will adopt Turbostarter AI persistence, transport, attachments, tools, and history behind audited routes.",
   simplexReady: "SimpleX transport placeholder: encrypted channel adapters will mount here behind Vault and trust-boundary checks.",
   teams: "Teams",
   directMessages: "Direct Messages",
+  directMessagesIntro: "Direct and group DM threads share the unified conversation model while protected payloads remain gated by Vault policy.",
   chatInputPlaceholder: "Write a message when audited session write routes are enabled.",
   localRepoSelector: "Local repo selector",
   performance: "Performance",
   projectWorkIntro: "Document folders for inboxes, campaigns, cases, configuration, feedback, knowledge, maintenance, performance, and reports are planned.",
   projectWork: "Documents",
   projects: "Remote Repos",
+  repos: "Repos",
+  reposIntro: "Unified repo context for local worktrees, remote repo metadata, worker threads, and future deploy context.",
   readOnly: "Read-only",
   registrars: "Registrars",
   registrarsIntro: "Recommended and user-owned domain registrars.",
@@ -251,6 +266,8 @@ export const text = {
   socialMedia: "Social Media",
   socialMediaIntro: "Social profiles, pages, handles, audience notes, and channel ownership are planned.",
   tasks: "Tasks",
+  workers: "Workers",
+  workersIntro: "Worker activity, task handoffs, event threads, and status transitions will render here as conversation events and workflow summaries.",
   theme: "Theme",
   appearance: "Appearance",
   hue: "Hue",
@@ -309,13 +326,21 @@ export const fontSizeOptions: FontSizeOption[] = (["xs", "s", "m", "lg", "xl"] a
   cssSize: `${14 + index}px`,
 }));
 
+function plannedNavItem(id: SurfaceId, label: string, description: string, icon: SurfaceIconName): SurfaceNavItem {
+  return { id, label, description, icon, badge: text.planned };
+}
+
 export const navGroups: SurfaceNavGroup[] = [
   {
     label: text.development,
     mode: "devops",
     items: [
+      plannedNavItem("aiSessions", text.aiSessions, "AI chat and OpenCode sessions", "terminal"),
+      plannedNavItem("workers", text.workers, "Worker activity and event threads", "users"),
       { id: "git", label: text.localRepos, description: "~/Git explorer", icon: "folder" },
+      plannedNavItem("repos", text.repos, "Unified local and remote repo context", "git"),
       { id: "projects", label: text.projects, description: "repos.json summary", icon: "git" },
+      plannedNavItem("deployments", text.deployments, "Release and deployment activity", "download"),
       { id: "security", label: text.secrets, description: "Secret references and trust boundary", icon: "shield" },
       { id: "aiProviders", label: text.aiProviders, description: "OAuth account pools", icon: "users" },
     ],
@@ -367,6 +392,8 @@ export const navGroups: SurfaceNavGroup[] = [
     label: text.management,
     mode: "comms",
     items: [
+      plannedNavItem("channels", text.channels, "Team channels", "hash"),
+      plannedNavItem("directMessages", text.directMessages, "Direct and group DMs", "message"),
       { id: "emailAccounts", label: text.emailAccounts, description: "Mail account sync", icon: "mail", badge: text.planned },
       { id: "messagingAccounts", label: text.messagingAccounts, description: "Messaging account sync", icon: "message", badge: text.planned },
       { id: "events", label: text.calendars, description: "CalDAV calendar sync", icon: "calendar", badge: text.planned },
@@ -573,6 +600,7 @@ export function surfaceRecordCounts(status: GuiStatusData): SurfaceRecordCounts
   return {
     agents: status.capabilities.length,
     aiProviders: oauthAccounts,
+    aiSessions: status.opencode_sessions.sessions.length,
     apps: status.managed_apps.length || status.ai_apps.length,
     config: status.settings.key_count || status.settings.keys.length,
     git: status.local_repos.total || status.local_repos.repos.length,
@@ -580,6 +608,7 @@ export function surfaceRecordCounts(status: GuiStatusData): SurfaceRecordCounts
     installation: installationRows.length,
     localSetup: status.paths.length,
     projects: status.repos.total || status.repos.repos.length,
+    repos: (status.local_repos.total || status.local_repos.repos.length) + (status.repos.total || status.repos.repos.length),
     registrars: populatedInventoryRowCount("registrars"),
     security: status.secrets.length,
     servers: populatedInventoryRowCount("servers"),

package/packages/gui-web/src/dashboard.ts

@@ -37,13 +37,13 @@ export function renderDashboardHtml(status: GuiResponseEnvelope<GuiStatusData>):
     .map((capability) => `<li>${escapeHtml(capability.label)}: ${escapeHtml(capability.status)}</li>`)
     .join("");
   const navSections = [
-    { heading: "Development", items: ["Local Repos", "Remote Repos", "Secrets", "AI Providers"] },
+    { heading: "Development", items: ["AI Sessions", "Workers", "Local Repos", "Repos", "Remote Repos", "Deployments", "Secrets", "AI Providers"] },
     { heading: "Account", items: ["Help", "Settings", "Notifications", "Admin"] },
     { heading: "Operations", items: ["Dashboard", "Vault", "Agents file explorer", "Config", "Local Setup", "Routines"] },
     { heading: "Infrastructure", items: ["Devices", "VPNs & Proxies", "Apps", "Installation", "Registrars", "Hosts", "Servers"] },
     { heading: "Identities", items: ["Brands", "Domains", "Personas"] },
     { heading: "Sites", items: ["Websites", "Forums", "Social Media", "Marketplaces"] },
-    { heading: "Management", items: ["Email Accounts", "Messaging Accounts", "Calendars", "Addressbooks", "Tasks", "Notebooks", "Bookmarks"] },
+    { heading: "Management", items: ["Channels", "Direct Messages", "Email Accounts", "Messaging Accounts", "Calendars", "Addressbooks", "Tasks", "Notebooks", "Bookmarks"] },
     { heading: "Documents", items: ["Inbox", "Campaigns", "Cases", "Config", "Feedback", "Knowledge", "Maintenance", "Performance", "Reports"] },
   ];
   const renderedNavSections = navSections
@@ -55,7 +55,7 @@ export function renderDashboardHtml(status: GuiResponseEnvelope<GuiStatusData>):
     `<h1>aidevops app interface</h1>`,
     `<p>Made for creators.</p>`,
     `<p>AI-assisted development workflows, code quality, and deployment automation.</p>`,
-    `<p>Theme follows system preferences with light and dark overrides. Sidebar modes: DevOps and Comms. Appearance controls can be hidden or shown, and include editable Hue, icon Reset, Show borders toggle, Show counts toggle, Font size choices xs, s, m, lg, xl, and Font options: IBM Plex Mono, IBM Plex Sans, IBM Plex Serif, Inter, Menlo (default), Playpen Sans, Poppins, Source Sans, Source Serif, Tilt Neon, Ubuntu Mono. The workspace header includes a command palette, notifications menu, AI Assistant panel, and profile menu with Settings, Theme, Language, Community, Admin, and Logout entries. A desktop status bar shows local readiness, repo totals, secret reference count, provider accounts, and update state.</p>`,
+    `<p>Theme follows system preferences with light and dark overrides. Sidebar modes: DevOps and Comms. Appearance controls can be hidden or shown, and include editable Hue, icon Reset, Show borders toggle, Show counts toggle, Font size choices xs, s, m, lg, xl, and Font options: IBM Plex Mono, IBM Plex Sans, IBM Plex Serif, Inter, Menlo (default), Playpen Sans, Poppins, Source Sans, Source Serif, Tilt Neon, Ubuntu Mono. The workspace header includes a command palette, reserved signposts/help slot immediately left of notifications, notifications menu, AI Assistant panel, and profile menu with Settings, Theme, Language, Community, Admin, and Logout entries. A desktop status bar shows local readiness, repo totals, secret reference count, provider accounts, and update state.</p>`,
     `<p>Secret references stay read-only and redacted.</p>`,
     `<p>Vault surfaces show padlock indicators. Encrypted by aidevops Vault; contents visible only when unlocked through app or authorised vault commands.</p>`,
     `<p>${escapeHtml(status.data.update.message)}</p>`,

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.1
+# Version: 3.29.3
 #
 # Quick Install:
 #   npm install -g aidevops && aidevops update          (recommended)