Rhythm 2.0 Specifications

Appearance

DOM-PFM-LLM-005Jazz AI Conversation

Markdown

DOM-PFM-LLM-005

Jazz AI Conversation

Markdown
  • DocumentDraft
  • ImplementationPartially observed

Planning

Specified by
CON-PFM-LLM-005

Design

Owned by
SVC-PFM-LLM-console-agent

KindDomain objectProduct areaPlatformModuleAI Requests, Usage and the Jazz AI TeammateRevision1

Read atreact-console baf6dae3

Jazz AI Conversation ​

What It Models ​

A Jazz AI conversation is a titled message history, optionally filed in a project or attached to a query or directory. A project groups conversations and provides context for general replies. This design describes the console prototype while leaving durable ownership open.

Identity and Attributes ​

The console server generates prefixed identifiers for conversations, projects and messages. Scoped creation searches for an existing query identity or draft key. Every record uses the same sample owner, so those identifiers do not establish a real person or workspace boundary. Titles, archive times and update times support browsing.

Relationships ​

Live query refinement consumes metered query generation. Directory assistance uses local interpretation and name lookup. General chat sends a direct model request outside Platform accounting. The query workspace and directory retain their own state and save behavior.

Invariants ​

Scoped creation normally reuses and restores an existing matching conversation, but scope edits are not uniqueness constrained. Scoped conversations reject general replies. Project deletion keeps conversations and removes their filing. Archiving retains messages; message append and metadata writes remain available in the store while archived.

How It Is Stored and Shared ​

Each server process keeps a shared memory store seeded with sample records. Requests reaching that process see the same sample-owner records. Restart loses authored changes, and separate instances have independent copies. Platform stores no conversation history at this revision.

Open Design Questions ​

Product must choose durable ownership, personal or shared projects, retention, deletion, evidence handling and access policy. A proposed customer-ready boundary uses isolated durable storage and metered general replies with permission and AI-switch checks.

Relationships

ToCardinalityOwnershipCrosses a serviceOn archive or delete
DOM-PFM-LLM-001a scoped exchange may cause one metered request per refinement; general replies cause noneRequests retain their source facts; this relationship does not transfer request ownership.yes

Invariants

InvariantProtectsEnforced atProvenance
INV-DOM-PFM-LLM-005-01
Scoped creation reuses a matching query identity or draft key and clears its archive time; later scope edits do not enforce uniqueness.
consoleobserved
react-console:lib/agent/store.ts:createConversation
INV-DOM-PFM-LLM-005-02
The shared server store filters the fixed sample owner and provides no authenticated-person or workspace isolation.
consoleobserved
react-console:lib/agent/store.ts:owned
INV-DOM-PFM-LLM-005-03
General reply requests reject conversations attached to query or directory work.
consoleobserved
react-console:app/api/agent/conversations/[id]/messages/route.ts:POST
INV-DOM-PFM-LLM-005-04
Removing a project retains its conversations and clears their project association.
consoleobserved
react-console:lib/agent/store.ts:deleteProject
INV-DOM-PFM-LLM-005-05
Appending a person message replaces only the default title; the store preserves an existing title for a blank rename, although the patch schema rejects it.
consoleobserved
react-console:lib/agent/store.ts:appendMessages
INV-DOM-PFM-LLM-005-06
Archive operations preserve messages and change archive and update timestamps; restore clears the archive marker.
consoleobserved
react-console:lib/agent/store.ts:updateConversation
INV-DOM-PFM-LLM-005-07
The conversation client writes through its own routes rather than the Platform query client.
consoletest
react-console:lib/agent/__tests__/client.test.ts#never routes through the query client

The Markdown files under specs/ in rhythmsoftware/rhythm-v2-docs are the canonical source of truth. This reader is a generated, read-only projection of them.

Rhythm Software