ClawX/harness/specs/scenarios/acp-chat-experience.md

id, title, type, ownedPaths, requiredProfiles, conditionalProfiles, requiredRules

id	title	type	ownedPaths	requiredProfiles	conditionalProfiles	requiredRules
acp-chat-experience	ACP Chat Experience	user-visible-flow	shared/acp-chat/** shared/host-api/contract.ts shared/file-preview/** electron/services/acp-chat-service.ts electron/services/acp-session-access-registry.ts electron/services/acp-trace.ts electron/services/attachment-access.ts electron/services/attachment-open-with.ts electron/services/files-api.ts electron/main/index.ts resources/scripts/attachment-open-with.ps1 src/lib/acp/** src/lib/file-preview-client.ts src/lib/file-preview-capabilities.ts src/lib/generated-files.ts src/components/file-preview/** src/stores/acp-chat-session.ts src/pages/Chat/** tests/unit/acp-*.test.ts tests/unit/acp-*.test.tsx tests/unit/attachment-open-with.test.ts tests/unit/attachment-open-with-native.test.ts tests/e2e/chat-acp-inline-timeline.spec.ts tests/e2e/chat-acp-attachments.spec.ts tests/e2e/chat-run-state-events.spec.ts tests/e2e/chat-streamdown-rendering.spec.ts tests/e2e/chat-code-block-wrap.spec.ts tests/e2e/chat-latex-rendering.spec.ts tests/e2e/chat-assistant-markdown-plain.spec.ts tests/e2e/chat-table-header-light.spec.ts tests/e2e/hardware-acceleration.spec.ts tests/e2e/renderer-performance.spec.ts	fast comms	e2e ACP timeline presentation changes Chat Markdown rendering, syntax highlighting, or animation changes send, cancel, permission, media, or history behavior changes	renderer-main-boundary acp-chat-state-and-history acp-compatibility-content-safety attachment-access-safety diagnostics-trace-safety session-workspace-authority tool-derived-file-safety office-preview-safety ui-i18n-design-tokens markdown-rendering-safety-and-performance electron-rendering-performance comms-regression docs-sync

ACP Chat covers session load, prompt, cancel, permission, replay, timeline reduction, assistant-turn presentation and whole-turn duration, standard ACP attachments, bounded generated-media and OpenClaw MEDIA compatibility, and Chat-specific diagnostics. The user-visible attachment flow includes attachment-scoped preview, system open, selected-application open, reveal actions, and a first-position built-in Preview action for eligible local HTML, with platform discovery limited to macOS and Windows. Authorized local DOCX/PPTX attachments within the Office limit use scoped Preview; remote, legacy, and over-limit Office attachments retain scoped system/external-open behavior. User-selected directories remain system-open-only targets: Main may open the directory after session-scoped revalidation, but directory contents are not read, enumerated, previewed, or exposed to Open With.

Main owns ACP transport, routing, transcript retrieval and timing extraction, workspace grants, and session/generation-scoped attachment authorization. Renderer owns the in-memory timeline, bounded compatibility and timing alignment, attachment presentation, and display grouping, including user-image thumbnails and user-selected source-path labels. ACP replay remains authoritative for historical turns and content; transcript-derived timing may only annotate an unambiguously matched ACP turn. Standard ACP content remains preferred over compatibility projections, and incidental tool paths never enter the attachment pipeline.

The durable architecture, exceptions, access boundary, file-activity separation, Office preview behavior, Markdown rendering, Electron rendering performance policy, and validation anchors are documented in harness/reference/acp-chat.md, harness/reference/acp-generated-media-and-diagnostics.md, harness/reference/acp-attachment-access-control.md, harness/reference/openclaw-file-activity.md, harness/reference/office-document-preview.md, harness/reference/markdown-rendering.md, and harness/reference/electron-rendering-performance.md.