@tutti-os/agent-gui 0.0.33 → 0.0.35

package/README.md

@@ -3,6 +3,11 @@
 AgentGUI renders workspace agent sessions, timelines, approvals, and composer
 UI. It is a UI package, not a host transport or business-core package.
 
+Before changing AgentGUI, AgentGuiNode, or the agent conversation module, read
+[AgentGuiNode Architecture and Troubleshooting](../../../docs/architecture/agent-gui-node.md).
+It records the source-of-truth rules, common chains, debugging playbooks, and
+the self-evolution loop for durable lessons.
+
 ## Data Source
 
 `AgentActivityRuntime` is the AgentGUI source for agent activity data.

package/dist/{AgentMessageMarkdown-Cp70W-Z2.d.ts → AgentMessageMarkdown-0sV8Biv3.d.ts}

@@ -1,8 +1,18 @@
 import { AgentActivityUsage } from '@tutti-os/agent-activity-core';
 import { A as AgentHostBatchUserInfoInput, a as AgentHostBatchUserInfoResult, b as AgentHostDeleteWorkspaceAgentSessionInput, k as AgentHostWorkspaceAgentSessionSummaryInput, j as AgentHostWorkspaceAgentSessionSummary, e as AgentHostWorkspaceAgentListInput, l as AgentHostWorkspaceAgentSnapshot, i as AgentHostWorkspaceAgentSessionMessagesInput, h as AgentHostWorkspaceAgentSessionMessages, p as WorkspaceAgentActivitySyncState } from './workspaceAgentActivityListViewModel-DwpbJGDx.js';
-import { A as AgentApprovalItemVM, a as AgentAskUserQuestionVM, b as AgentConversationPromptVM, c as AgentConversationVM, W as WorkspaceAgentSessionDetailViewModel } from './agentConversationVM-BElW2LNR.js';
+import { A as AgentApprovalItemVM, a as AgentAskUserQuestionVM, b as AgentConversationPromptVM, c as AgentConversationVM, W as WorkspaceAgentSessionDetailViewModel } from './agentConversationVM-xuzmD5IL.js';
 import { WorkspaceUserProjectService } from '@tutti-os/workspace-user-project/contracts';
 
+declare const APP_ERROR_CODES: readonly ["common.invalid_input", "common.approved_path_required", "common.unavailable", "common.unexpected", "session.not_found", "control_surface.unauthorized", "workspace.select_directory_failed", "workspace.select_files_failed", "workspace.ensure_directory_failed", "workspace.import_files_failed", "workspace.read_file_failed", "workspace.write_file_failed", "workspace.export_file_failed", "workspace.copy_path_failed", "workspace.host_unsupported", "workspace.runtime_artifact_unavailable", "runtime.guest_agent_lane_unavailable", "workspace.room_full", "workspace.room_delete_forbidden", "workspace.room_delete_not_found", "filesystem.create_directory_failed", "filesystem.read_file_bytes_failed", "filesystem.read_file_text_failed", "filesystem.write_file_text_failed", "filesystem.copy_entry_failed", "filesystem.move_entry_failed", "filesystem.rename_entry_failed", "filesystem.delete_entry_failed", "filesystem.read_directory_failed", "filesystem.stat_failed", "terminal.spawn_failed", "terminal.write_failed", "terminal.resize_failed", "terminal.close_failed", "terminal.attach_failed", "terminal.detach_failed", "terminal.snapshot_failed", "agent.list_models_failed", "agent.launch_failed", "agent.read_last_message_failed", "agent.provider_session_not_found", "agent.resume_session_not_local", "agent.resume_session_resolve_failed", "agent.settings_require_new_session", "task.suggest_title_failed", "persistence.unavailable", "persistence.quota_exceeded", "persistence.payload_too_large", "persistence.io_failed", "persistence.invalid_state", "persistence.invalid_node_id", "update.get_state_failed", "update.configure_failed", "update.check_failed", "update.download_failed", "update.install_failed", "PACKAGE_DOWNLOAD_INTERRUPTED", "PACKAGE_DOWNLOAD_HTTP_STATUS", "PACKAGE_DOWNLOAD_INVALID", "PACKAGE_DOWNLOAD_DISK_ERROR"];
+type AppErrorCode = (typeof APP_ERROR_CODES)[number];
+type AppErrorParamValue = boolean | number | string | null;
+type AppErrorParams = Record<string, AppErrorParamValue>;
+interface AppErrorDescriptor {
+    code: AppErrorCode;
+    params?: AppErrorParams;
+    debugMessage?: string;
+}
+
 type AgentHostAgentSessionProvider = "claude-code" | "codex" | "nexight" | "gemini" | "hermes" | "openclaw";
 type AgentHostAgentSessionPermissionModeSemantic = "ask-before-write" | "accept-edits" | "locked-down" | "auto" | "full-access" | "unconfigurable";
 type AgentHostAgentSessionReasoningEffort = "minimal" | "low" | "medium" | "high" | "xhigh" | string;
@@ -194,6 +204,37 @@ interface AgentHostListWorkspaceAgentProbesInput {
 }
 type AgentHostWorkspaceAgentProbesResult = AgentProbeSnapshot;
 
+type PersistWriteLevel = "full" | "no_scrollback" | "settings_only";
+type PersistWriteFailureReason = "unavailable" | "quota" | "payload_too_large" | "io" | "unknown";
+type PersistWriteResult = {
+    ok: true;
+    level: PersistWriteLevel;
+    bytes: number;
+    revision?: number;
+} | {
+    ok: false;
+    reason: PersistWriteFailureReason;
+    error: AppErrorDescriptor;
+};
+type WorkspaceAgentReadStateKind = "completed" | "failed";
+interface WorkspaceAgentReadStateBucket {
+    readIds: string[];
+    unreadIds: string[];
+}
+interface WorkspaceAgentReadStateSnapshot {
+    completed: WorkspaceAgentReadStateBucket;
+    failed: WorkspaceAgentReadStateBucket;
+}
+interface ReadWorkspaceAgentReadStateInput {
+    roomId: string;
+    userId: string;
+}
+interface WriteWorkspaceAgentReadStateInput extends ReadWorkspaceAgentReadStateInput {
+    kind: WorkspaceAgentReadStateKind;
+    readIds: string[];
+    unreadIds: string[];
+}
+
 interface ReadWorkspaceFileResult {
     bytes: Uint8Array;
 }
@@ -239,6 +280,10 @@ type AgentHostEnvironmentApi = AgentHostRecord & {
     getBaseUrl?: () => AgentHostAsyncResult<string>;
     warmupOpenclawGateway?: (input?: unknown) => AgentHostAsyncResult<unknown>;
 };
+type AgentHostPersistenceApi = AgentHostRecord & {
+    readWorkspaceAgentReadState: (input: ReadWorkspaceAgentReadStateInput) => AgentHostAsyncResult<WorkspaceAgentReadStateSnapshot>;
+    writeWorkspaceAgentReadState: (input: WriteWorkspaceAgentReadStateInput) => AgentHostAsyncResult<PersistWriteResult>;
+};
 interface AgentHostSelectedFile {
     name?: string;
     path: string;
@@ -278,6 +323,7 @@ interface AgentHostInputApi {
     filesystem: AgentHostFilesystemApi;
     meta?: AgentHostMetaApi;
     onHostEvent?: (listener: (event: any) => void) => AgentHostUnsubscribe;
+    persistence?: AgentHostPersistenceApi;
     runtime?: AgentHostEnvironmentApi;
     userProjects?: AgentHostUserProjectsApi;
     workspace: AgentHostWorkspaceApi;
@@ -424,6 +470,7 @@ interface AgentHostRuntimeApi {
     filesystem: AgentHostFilesystemApi;
     meta?: AgentHostMetaApi;
     onHostEvent?: (listener: (event: any) => void) => AgentHostUnsubscribe;
+    persistence?: AgentHostPersistenceApi;
     runtime?: AgentHostEnvironmentApi;
     userProjects?: AgentHostUserProjectsApi;
     workspace: AgentHostWorkspaceApi;
@@ -491,6 +538,7 @@ interface AgentGUIConversationSummary {
     sortTimeUnixMs?: number;
     updatedAtUnixMs: number;
     hasUnreadCompletion?: boolean;
+    unreadCompletionKey?: string | null;
     syncState?: WorkspaceAgentActivitySyncState;
 }
 type AgentGUIConversationStatus = "working" | "waiting" | "ready" | "completed" | "failed" | "canceled";
@@ -509,8 +557,6 @@ type AgentGUIInteractivePrompt = AgentGUIApprovalRequest | {
     kind: "plan-implementation";
 }>;
 
-type UsageAlertTier = "warn" | "critical";
-
 interface AgentGUISessionChrome {
     auth: {
         message: string;
@@ -638,14 +684,16 @@ interface AgentGUINodeViewModel {
     draftContent: AgentComposerDraft;
     isLoadingConversations: boolean;
     isLoadingMessages: boolean;
+    isLoadingOlderMessages: boolean;
+    hasOlderMessages: boolean;
     isCreatingConversation: boolean;
     isSubmitting: boolean;
     isInterrupting: boolean;
+    isCancelPending: boolean;
     isRespondingApproval: boolean;
     promptImagesSupported: boolean;
     compactSupported: boolean | null;
     usage: AgentActivityUsage | null;
-    usageAlert: UsageAlertTier | null;
     /** Codex plan turn finished: offer the TUI-equivalent implement prompt. */
     listError: string | null;
     isDeletingConversation: boolean;
@@ -676,4 +724,4 @@ interface AgentMessageMarkdownWorkspaceAppIcon {
     workspaceId?: string | null;
 }
 
-export type { AgentGUINodeData as A, NodeFrame as N, Point as P, AgentGUINodeViewModel as a, AgentGUIProviderSkillOption as b, AgentHostActivateAgentSessionResult as c, AgentHostAgentSessionComposerSettings as d, AgentHostAgentSessionState as e, AgentHostApi as f, AgentHostInputApi as g, AgentHostRuntimeApi as h, AgentHostSelectFilesInput as i, AgentHostUnactivateAgentSessionResult as j, AgentHostUpdateAgentSessionSettingsResult as k, AgentMessageMarkdownWorkspaceAppIcon as l, AgentProbeProvider as m, AgentProbeSnapshot as n, AgentProvider as o, AgentProviderProbeListInput as p, AgentProviderProbeListResult as q, AgentUsageQuota as r, AgentUsageSnapshot as s };
+export type { AgentGUINodeData as A, NodeFrame as N, PersistWriteResult as P, ReadWorkspaceAgentReadStateInput as R, WorkspaceAgentReadStateSnapshot as W, AgentGUINodeViewModel as a, AgentGUIProviderSkillOption as b, AgentHostActivateAgentSessionResult as c, AgentHostAgentSessionComposerSettings as d, AgentHostAgentSessionState as e, AgentHostApi as f, AgentHostInputApi as g, AgentHostRuntimeApi as h, AgentHostSelectFilesInput as i, AgentHostUnactivateAgentSessionResult as j, AgentHostUpdateAgentSessionSettingsResult as k, AgentMessageMarkdownWorkspaceAppIcon as l, AgentProbeProvider as m, AgentProbeSnapshot as n, AgentProvider as o, AgentProviderProbeListInput as p, AgentProviderProbeListResult as q, AgentUsageQuota as r, AgentUsageSnapshot as s, Point as t, WriteWorkspaceAgentReadStateInput as u };

package/dist/agent-conversation/index.d.ts

@@ -1,9 +1,9 @@
 import * as react from 'react';
 import { ReactNode, JSX } from 'react';
-import { W as WorkspaceLinkAction } from '../workspaceLinkActions-CqWZaCY4.js';
-import { b as AgentGUIProviderSkillOption, l as AgentMessageMarkdownWorkspaceAppIcon } from '../AgentMessageMarkdown-Cp70W-Z2.js';
-import { c as AgentConversationVM, W as WorkspaceAgentSessionDetailViewModel } from '../agentConversationVM-BElW2LNR.js';
-export { B as BuildWorkspaceAgentSessionDetailInput, d as buildWorkspaceAgentSessionDetailViewModel } from '../agentConversationVM-BElW2LNR.js';
+import { W as WorkspaceLinkAction } from '../workspaceLinkActions-C6POH38D.js';
+import { b as AgentGUIProviderSkillOption, l as AgentMessageMarkdownWorkspaceAppIcon } from '../AgentMessageMarkdown-0sV8Biv3.js';
+import { c as AgentConversationVM, W as WorkspaceAgentSessionDetailViewModel } from '../agentConversationVM-xuzmD5IL.js';
+export { B as BuildWorkspaceAgentSessionDetailInput, d as buildWorkspaceAgentSessionDetailViewModel } from '../agentConversationVM-xuzmD5IL.js';
 export { W as WorkspaceAgentActivityCard, n as WorkspaceAgentActivitySession, q as WorkspaceAgentActivityTimelineItem } from '../workspaceAgentActivityListViewModel-DwpbJGDx.js';
 import '@tutti-os/workspace-issue-manager/core';
 import '@tutti-os/agent-activity-core';

package/dist/agent-conversation/index.js

@@ -6,15 +6,15 @@ import {
   projectAgentConversationVM,
   reconcileProjectedAgentConversationVM,
   useProjectedAgentConversation
-} from "../chunk-GSZPMKFW.js";
-import "../chunk-AFTAFV2C.js";
-import "../chunk-A4KUAXE5.js";
+} from "../chunk-O56P2KSZ.js";
+import "../chunk-CMXRLF64.js";
+import "../chunk-VPC55T7P.js";
 import "../chunk-Y35GDLP2.js";
-import "../chunk-SGQ4C7JE.js";
+import "../chunk-2ADVHCST.js";
 import "../chunk-TYGL25EL.js";
 import {
   translate
-} from "../chunk-RQ3HEF42.js";
+} from "../chunk-KFMD33UD.js";
 import "../chunk-LUGELG5V.js";
 import "../chunk-PJP5BUU6.js";
 

package/dist/agent-message-center/index.d.ts

@@ -2,9 +2,9 @@ import * as react from 'react';
 import { JSX } from 'react';
 import { I18nRuntime } from '@tutti-os/ui-i18n-runtime';
 import { useTranslation, AgentGuiI18nLocale, TranslateFn } from '../i18n/index.js';
-import { W as WorkspaceLinkAction } from '../workspaceLinkActions-CqWZaCY4.js';
+import { W as WorkspaceLinkAction } from '../workspaceLinkActions-C6POH38D.js';
 import { AgentActivityNeedsAttentionItem, AgentActivitySnapshot } from '@tutti-os/agent-activity-core';
-import { b as AgentConversationPromptVM } from '../agentConversationVM-BElW2LNR.js';
+import { b as AgentConversationPromptVM } from '../agentConversationVM-xuzmD5IL.js';
 import { o as WorkspaceAgentActivityStatus } from '../workspaceAgentActivityListViewModel-DwpbJGDx.js';
 export { PLAN_IMPLEMENTATION_ACTION_IMPLEMENT, PLAN_IMPLEMENTATION_PROMPT } from '../plan-decision-ops.js';
 import '@tutti-os/workspace-issue-manager/core';

package/dist/agent-message-center/index.js

@@ -3,7 +3,7 @@ import {
   approvalOptionDisplayLabel,
   getPromptToolDetails,
   isPromptRequestIdTitle
-} from "../chunk-RDCBACWR.js";
+} from "../chunk-JYH2ITNL.js";
 import {
   PLAN_IMPLEMENTATION_ACTION_IMPLEMENT,
   PLAN_IMPLEMENTATION_PROMPT,
@@ -16,17 +16,17 @@ import {
   cn,
   extractAgentMcpToolTarget,
   normalizeAskUserQuestions
-} from "../chunk-AFTAFV2C.js";
+} from "../chunk-CMXRLF64.js";
 import {
   managedAgentRoundedIconUrl,
   userAvatarPlaceholderUrl,
   workspaceAgentActivityStatusLabel
-} from "../chunk-WPWZKKKV.js";
+} from "../chunk-3LEUGNCT.js";
 import "../chunk-MTFSQWZ6.js";
 import {
   resolveWorkspaceAgentSessionSortTimeUnixMs
 } from "../chunk-IBIMGLCD.js";
-import "../chunk-SGQ4C7JE.js";
+import "../chunk-2ADVHCST.js";
 import {
   workspaceAgentProviderLabel
 } from "../chunk-TYGL25EL.js";
@@ -36,7 +36,7 @@ import {
 import {
   AgentGuiI18nProvider,
   useTranslation
-} from "../chunk-RQ3HEF42.js";
+} from "../chunk-KFMD33UD.js";
 import "../chunk-PJP5BUU6.js";
 
 // agent-message-center/WorkspaceAgentMessageCenterPanel.tsx
@@ -963,6 +963,7 @@ var WorkspaceAgentMessageCenterCard = memo(
     const displayTitle = normalizeAgentTitleText(item.title);
     const summary = messageCenterVisibleSummary(item);
     const displayStatus = statusClass(item);
+    const statusTone = messageCenterStatusTone(item);
     const statusLabel = workspaceAgentActivityStatusLabel(displayStatus, t);
     return /* @__PURE__ */ jsxs(
       "article",
@@ -1004,14 +1005,17 @@ var WorkspaceAgentMessageCenterCard = memo(
             /* @__PURE__ */ jsxs(
               "span",
               {
-                className: "workspace-agent-message-center__status inline-flex shrink-0 items-center gap-1.5 text-[11px] font-semibold leading-4 text-[var(--text-secondary)]",
+                className: cn2(
+                  "workspace-agent-message-center__status inline-flex shrink-0 items-center gap-1.5 text-[11px] font-semibold leading-4",
+                  messageCenterStatusToneClass(statusTone)
+                ),
                 "data-status": displayStatus,
                 title: statusLabel,
                 children: [
                   /* @__PURE__ */ jsx2(
                     StatusDot,
                     {
-                      tone: messageCenterStatusTone(item),
+                      tone: statusTone,
                       pulse: isWaitingMessageCenterItem(item) || item.status === "working",
                       size: "sm",
                       title: statusLabel
@@ -1859,6 +1863,20 @@ function messageCenterStatusTone(item) {
   }
   return "neutral";
 }
+function messageCenterStatusToneClass(tone) {
+  switch (tone) {
+    case "amber":
+      return "text-[var(--state-warning)]";
+    case "blue":
+      return "text-[var(--status-running)]";
+    case "green":
+      return "text-[var(--state-success)]";
+    case "red":
+      return "text-[var(--state-danger)]";
+    case "neutral":
+      return "text-[var(--text-secondary)]";
+  }
+}
 
 // agent-message-center/WorkspaceAgentMessageCenterAttentionDeck.tsx
 import { jsx as jsx3, jsxs as jsxs2 } from "react/jsx-runtime";
@@ -3020,7 +3038,10 @@ function MessageCenterGroupHeading({
   return /* @__PURE__ */ jsxs4(
     "h3",
     {
-      className: "flex min-w-0 items-center gap-1.5 text-[11px] font-normal leading-4 text-[var(--text-tertiary)]",
+      className: cn5(
+        "flex min-w-0 items-center gap-1.5 text-[11px] font-normal leading-4",
+        statusSignal ? messageCenterStatusToneClass(statusSignal.tone) : "text-[var(--text-tertiary)]"
+      ),
       title: `${group.label} \xB7 ${group.items.length}`,
       children: [
         statusSignal ? /* @__PURE__ */ jsx5(