chat

Imported from gabrielmoreira/agent-skills-mirror (mirrors/repos/YishenTu@claudian/src/features/chat/AGENTS.md). Install upstream with npx skills add gabrielmoreira/agent-skills-mirror --skill chat. Copyright stays with the author.

Chat constraints

• Conversation, persisted tab shell, runtime tab, hydration, and provider execution have independent lifetimes. Layout/selection/hydration cannot create provider execution, rewrite durable identity, or cancel another tab's turn.
• Unlimited tabs do not imply unlimited warm execution. Cooling may evict only idle owners and preserves hydrated UI/resume state; unresolved interactions protect execution.
• History previews are provisional until explicit retention. Returning to compact mode must finish preview cleanup before exposing controls that could target closing tabs.
• Persist view-scoped tab shells only, never composer drafts, hydrated messages, DOM, turns, or lifecycle values. Restore inactive shells before one final activation; history warmup may perform isolated command discovery but cannot create chat sessions.
• Restore follows Obsidian's delivered state, not early onOpen synthesis. Same-instance reopen uses the finalized shutdown snapshot. Versioned snapshots reject malformed/duplicate identities as a whole; permissive normalization is legacy-only.
• Optimistic tab presentation must not enter persistence before admission/switch commit. Failed assembly/activation restores the prior committed owner; post-commit observer failure cannot undo membership.
• Close pauses intent admission reversibly until replacement/successor publication succeeds. Keep required runtime state callbacks available during preflight and drain; duplicate close/destroy must not repeat effects.
• Shutdown joins navigation and drains all admitted work before sealing final identity. While restoration is pending, its full plan remains the persistence authority, not partially assembled membership.
• Forking captures and revalidates the source binding across every await; never use whichever tab becomes current later.
• First canonical input freezes Linked content for both creation and provider context. Create failure restores the draft; post-create failure leaves a locked conversation whose retry is still the first turn. Later/steered/compact turns must not resend it through a mutable sent flag.
• Blank-tab provider transitions serialize and roll back to the last stable draft. Model-picker intents affect only the selected tab/conversation and the future-tab seed; existing tabs must not subscribe to that seed.
• Conversation authority is revalidated after session preparation immediately before provider handoff. Superseded warm preparation cannot install or publish resources.
• A temporary child conversation owns execution, rendering and settings in memory only; it never reaches conversation persistence or view-scoped tab state. Seed it with returned fork state alone, never the parent's established provider session id. Providers own native ephemeral fork support and any initial context fallback. Keep ephemeral children protected from cooling; lost native context requires a new side chat, never transcript rehydration.

Surface and input behavior

• Dynamic Main Agent sections are best-effort system configuration; failures must not block Chat. Collab references insert visible text only and cannot mutate selected Project or persist hidden entity metadata.
• Live Collab disable destroys its surface while preserving the chat tab. Plugin-lifetime composer ports reset to unavailable rather than terminal disposal; compact/dual presentation reuse one controller/tree.
• One composer serves every destination, and its target is derived from presentation state rather than a separately mutable selection. User-originated sends and cancels resolve the target when they run; internally queued main work keeps the owner it was admitted with and must never read the current target at dispatch.
• Horizontal swipes rely on native snap scrolling and scrollend. Do not cancel wheel events, classify gestures by idle/delta heuristics, or move the strip with transforms; Chromium retains the stationary pointer's wheel target through the transaction.
• Preload may prepare a drag target without activating it. Commit semantic surface state only after snap completion; the two-surface visual replica stays inert and owns no controller/state.