feat: appbar pickers, multi-agent personas, threads, library, profile

Adds a substantial chrome layer atop the bare template:

Appbar
- Font-size picker (root font-size scale): S/M/L/XL
- Surface picker: tints --background/--card/--popover/--sidebar/--muted/
  --secondary/--accent across light + dark
- Background picker: 11 atmospheric gradients (Pearl, Linen, Mist, Dawn,
  Seafoam, Aurora, Sunset, Meadow, Midnight, Blush, Noir) + None
- Vivid foreground tokens for stronger text contrast; fixed dark-mode
  blue-on-blue user bubble (deeper --primary, near-white --primary-fg)

Assistant route
- Multi-agent personas (~/lib/agents.ts): Atlas, Forge, Inkwell, Pilot,
  Cursor — each with name/role/sub-prompt; per-thread persona; agent
  picker with avatar tint + handoff submenu
- Conversation threads (~/lib/threads.ts): new/switch/rename/delete,
  auto-titling from first user message, per-thread pinned indices
- Compact summarization with snapshot-based Restore that preserves
  pinned messages verbatim
- Edit & retry the last user message, Regenerate, Continue, Show
  system prompt, Copy / Export Markdown, Save to Library, Compare
  across agents (parallel completions in a side-by-side modal)
- Per-message Pin / Read aloud (Web Speech) / Edit
- Voice input via Web Speech Recognition
- Two-column Actions popover (UI Control + Conversation / Share /
  Multi-agent / Clear sections)
- Status bar: connection dot + LOCAL/API/MOCK chip + host chip +
  context progress bar
- Compactly named threads picker; New conversation
- DropdownMenuItem onSelect → onClick (base-ui Menu fires onClick)

Library
- ~/lib/library.ts store, /library route with search + detail panel
  (Copy / Download / Delete)

Profile
- /profile route + ~/lib/profile.ts (name/email/title/bio/signature/
  avatar dataURL/default agent), AppShell uses live profile for the
  appbar avatar; account menu now navigates to /profile

Settings
- Sub-sidenav (LLM / Agents / Appearance / Account / About)
- Editable system prompt with reset-to-default
- Agents CRUD panel
- Reorganized layout

UI Control
- Static action catalog in the system prompt so the assistant can
  drive controls on routes that aren't currently mounted
- Always returns to /assistant after a UI Control sequence (model-
  side rule + deterministic safety net)
- Cursor uses click-nav over direct navigate so the virtual cursor
  is visibly involved
- New ids tagged across the app (sidebar, settings, profile, library,
  assistant tools, agent handoff, thread management)

Hydration
- root.tsx: suppressHydrationWarning on html/body since the pre-mount
  script sets dark/data-bg/data-surface/data-font-scale before React

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
jules
2026-04-28 14:29:58 +10:00
parent 11b17b6b6a
commit eea5b262cb
17 changed files with 3995 additions and 271 deletions

153
app/lib/agents.ts Normal file
View File

@@ -0,0 +1,153 @@
// Agent personas — named, role-scoped sub-system prompts.
// Each persona stacks on top of the main systemPrompt to specialize the
// assistant for a task. Persisted in localStorage; reactive across tabs.
import { useEffect, useSyncExternalStore } from "react"
export type Agent = {
id: string
name: string
role: string
prompt: string
}
export const DEFAULT_AGENTS: Agent[] = [
{
id: "generalist",
name: "Atlas",
role: "Generalist",
prompt:
"You handle anything: chat, planning, summaries, casual questions. Match the user's tone. Keep replies as long as the task deserves — terse for quick questions, detailed when explaining.",
},
{
id: "coder",
name: "Forge",
role: "Software engineer",
prompt:
"You are a senior software engineer. Write idiomatic, well-typed code. Prefer concrete examples over abstract advice. When asked to fix a bug, identify root cause before patching. Use markdown code blocks with language tags. Mention edge cases briefly when relevant.",
},
{
id: "writer",
name: "Inkwell",
role: "Writer",
prompt:
"You are a prose writer. Produce vivid, well-paced text — short stories, copy, emails, essays. Vary sentence length. Show, don't tell. When the user asks for a draft, deliver the draft, not a description of it.",
},
{
id: "researcher",
name: "Pilot",
role: "Researcher",
prompt:
"You are a careful researcher. Structure answers as: claim → evidence → caveat. Distinguish what is well-established from what is uncertain. Refuse to fabricate citations — if you don't know, say so.",
},
{
id: "ui-driver",
name: "Cursor",
role: "UI Operator",
prompt:
"You specialize in driving this app's UI on the user's behalf. Prefer doing over explaining. When the user asks for an action, emit an action block immediately. When they ask a question about the app, answer concisely and offer to do it.",
},
]
const STORAGE_KEY = "crema.agents"
const ACTIVE_KEY = "crema.assistant.activeAgent"
const CHANGE_EVENT = "crema:agents-change"
function isAgent(v: unknown): v is Agent {
return (
!!v &&
typeof v === "object" &&
typeof (v as Agent).id === "string" &&
typeof (v as Agent).name === "string" &&
typeof (v as Agent).role === "string" &&
typeof (v as Agent).prompt === "string"
)
}
function readFromStorage(): Agent[] {
if (typeof window === "undefined") return DEFAULT_AGENTS
try {
const raw = localStorage.getItem(STORAGE_KEY)
if (!raw) return DEFAULT_AGENTS
const parsed = JSON.parse(raw)
if (!Array.isArray(parsed)) return DEFAULT_AGENTS
const cleaned = parsed.filter(isAgent)
return cleaned.length > 0 ? cleaned : DEFAULT_AGENTS
} catch {
return DEFAULT_AGENTS
}
}
export function loadAgents(): Agent[] {
return readFromStorage()
}
export function saveAgents(next: Agent[]) {
if (typeof window === "undefined") return
localStorage.setItem(STORAGE_KEY, JSON.stringify(next))
window.dispatchEvent(new CustomEvent(CHANGE_EVENT))
}
export function resetAgents() {
saveAgents(DEFAULT_AGENTS)
}
let cached: Agent[] | null = null
function subscribe(cb: () => void): () => void {
const onChange = () => {
cached = null
cb()
}
window.addEventListener(CHANGE_EVENT, onChange)
window.addEventListener("storage", (e) => {
if (e.key === STORAGE_KEY || e.key === ACTIVE_KEY) onChange()
})
return () => {
window.removeEventListener(CHANGE_EVENT, onChange)
}
}
function getSnapshot(): Agent[] {
if (!cached) cached = readFromStorage()
return cached
}
function getServerSnapshot(): Agent[] {
return DEFAULT_AGENTS
}
export function useAgents(): Agent[] {
const value = useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot)
useEffect(() => {
cached = null
}, [])
return value
}
export function loadActiveAgentId(): string {
if (typeof window === "undefined") return DEFAULT_AGENTS[0].id
try {
return localStorage.getItem(ACTIVE_KEY) ?? DEFAULT_AGENTS[0].id
} catch {
return DEFAULT_AGENTS[0].id
}
}
export function saveActiveAgentId(id: string) {
if (typeof window === "undefined") return
localStorage.setItem(ACTIVE_KEY, id)
window.dispatchEvent(new CustomEvent(CHANGE_EVENT))
}
export function composeSystemPrompt(
base: string,
agent: Agent | undefined,
): string {
if (!agent) return base
return `${base}\n\nActive persona: ${agent.name}${agent.role}\n${agent.prompt}`
}
export function newAgentId(): string {
return `agent-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 6)}`
}

125
app/lib/library.ts Normal file
View File

@@ -0,0 +1,125 @@
// Library — saved artifacts. Today: conversation snapshots.
// Tomorrow: snippets, prompts, generated documents.
import { useEffect, useSyncExternalStore } from "react"
export type LibraryItem = {
id: string
kind: "conversation" | "snippet"
title: string
// Free-form body. For "conversation": markdown transcript. For "snippet": text.
content: string
tags: string[]
// Optional metadata.
agentName?: string
agentRole?: string
threadId?: string
messageCount?: number
createdAt: number
}
const STORAGE_KEY = "crema.library"
const CHANGE_EVENT = "crema:library-change"
const MAX_BYTES = 1_500_000
export function newLibraryId(): string {
return `lib-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 6)}`
}
function isLibraryItem(v: unknown): v is LibraryItem {
if (!v || typeof v !== "object") return false
const x = v as LibraryItem
return (
typeof x.id === "string" &&
(x.kind === "conversation" || x.kind === "snippet") &&
typeof x.title === "string" &&
typeof x.content === "string" &&
Array.isArray(x.tags) &&
typeof x.createdAt === "number"
)
}
function readFromStorage(): LibraryItem[] {
if (typeof window === "undefined") return []
try {
const raw = localStorage.getItem(STORAGE_KEY)
if (!raw) return []
const parsed = JSON.parse(raw)
if (!Array.isArray(parsed)) return []
return parsed.filter(isLibraryItem)
} catch {
return []
}
}
function writeToStorage(items: LibraryItem[]) {
if (typeof window === "undefined") return
let trimmed = items
let serialized = JSON.stringify(trimmed)
while (serialized.length > MAX_BYTES && trimmed.length > 1) {
trimmed = trimmed.slice(0, -1)
serialized = JSON.stringify(trimmed)
}
try {
localStorage.setItem(STORAGE_KEY, serialized)
window.dispatchEvent(new CustomEvent(CHANGE_EVENT))
} catch {
/* quota — bail */
}
}
export function loadLibrary(): LibraryItem[] {
return readFromStorage()
}
export function addLibraryItem(item: Omit<LibraryItem, "id" | "createdAt">): LibraryItem {
const next: LibraryItem = {
...item,
id: newLibraryId(),
createdAt: Date.now(),
}
const items = readFromStorage()
writeToStorage([next, ...items])
return next
}
export function deleteLibraryItem(id: string) {
const items = readFromStorage().filter((x) => x.id !== id)
writeToStorage(items)
}
export function updateLibraryItem(id: string, patch: Partial<LibraryItem>) {
const items = readFromStorage().map((x) =>
x.id === id ? { ...x, ...patch } : x,
)
writeToStorage(items)
}
let cached: LibraryItem[] | null = null
function subscribe(cb: () => void): () => void {
const onChange = () => {
cached = null
cb()
}
window.addEventListener(CHANGE_EVENT, onChange)
window.addEventListener("storage", (e) => {
if (e.key === STORAGE_KEY) onChange()
})
return () => window.removeEventListener(CHANGE_EVENT, onChange)
}
function getSnapshot(): LibraryItem[] {
if (!cached) cached = readFromStorage()
return cached
}
function getServerSnapshot(): LibraryItem[] {
return []
}
export function useLibrary(): LibraryItem[] {
const value = useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot)
useEffect(() => {
cached = null
}, [])
return value
}

View File

@@ -7,12 +7,17 @@ export type LLMSettings = {
baseURL: string
contextTokens: number
responseBudget: number
systemPrompt: string
}
export const DEFAULT_SYSTEM_PROMPT =
"You are a helpful general-purpose assistant embedded in an app. Handle any request the user makes — writing, brainstorming, code, analysis, casual chat — at the length the task deserves. Use markdown when it helps. You can also drive the UI when the user toggles UI Control on."
export const DEFAULT_SETTINGS: LLMSettings = {
baseURL: "http://localhost:1234/v1",
contextTokens: 9000,
responseBudget: 512,
systemPrompt: DEFAULT_SYSTEM_PROMPT,
}
const STORAGE_KEY = "crema.llm.settings"
@@ -34,6 +39,10 @@ function readFromStorage(): LLMSettings {
Number.isFinite(parsed.responseBudget) && (parsed.responseBudget as number) > 0
? (parsed.responseBudget as number)
: DEFAULT_SETTINGS.responseBudget,
systemPrompt:
typeof parsed.systemPrompt === "string" && parsed.systemPrompt.trim().length > 0
? parsed.systemPrompt
: DEFAULT_SETTINGS.systemPrompt,
}
} catch {
return DEFAULT_SETTINGS

115
app/lib/profile.ts Normal file
View File

@@ -0,0 +1,115 @@
// User profile — name, email, title, bio, signature, default agent.
// Persisted in localStorage; reactive across tabs.
import { useEffect, useSyncExternalStore } from "react"
export type Profile = {
name: string
email: string
title: string
bio: string
signature: string
avatarUrl: string
defaultAgentId: string
}
export const DEFAULT_PROFILE: Profile = {
name: "Signed-in user",
email: "user@example.com",
title: "",
bio: "",
signature: "",
avatarUrl: "",
defaultAgentId: "",
}
const STORAGE_KEY = "crema.profile"
const CHANGE_EVENT = "crema:profile-change"
function readFromStorage(): Profile {
if (typeof window === "undefined") return DEFAULT_PROFILE
try {
const raw = localStorage.getItem(STORAGE_KEY)
if (!raw) return DEFAULT_PROFILE
const parsed = JSON.parse(raw) as Partial<Profile>
return {
name:
typeof parsed.name === "string" && parsed.name.trim().length > 0
? parsed.name
: DEFAULT_PROFILE.name,
email:
typeof parsed.email === "string" ? parsed.email : DEFAULT_PROFILE.email,
title:
typeof parsed.title === "string" ? parsed.title : DEFAULT_PROFILE.title,
bio: typeof parsed.bio === "string" ? parsed.bio : DEFAULT_PROFILE.bio,
signature:
typeof parsed.signature === "string"
? parsed.signature
: DEFAULT_PROFILE.signature,
avatarUrl:
typeof parsed.avatarUrl === "string"
? parsed.avatarUrl
: DEFAULT_PROFILE.avatarUrl,
defaultAgentId:
typeof parsed.defaultAgentId === "string"
? parsed.defaultAgentId
: DEFAULT_PROFILE.defaultAgentId,
}
} catch {
return DEFAULT_PROFILE
}
}
export function loadProfile(): Profile {
return readFromStorage()
}
export function saveProfile(next: Profile) {
if (typeof window === "undefined") return
localStorage.setItem(STORAGE_KEY, JSON.stringify(next))
window.dispatchEvent(new CustomEvent(CHANGE_EVENT))
}
export function resetProfile() {
saveProfile(DEFAULT_PROFILE)
}
export function profileInitials(name: string): string {
const words = name.trim().split(/\s+/).filter(Boolean)
if (words.length === 0) return "?"
if (words.length === 1) return words[0].slice(0, 2).toUpperCase()
return (words[0][0] + words[words.length - 1][0]).toUpperCase()
}
let cached: Profile | null = null
function subscribe(cb: () => void): () => void {
const onChange = () => {
cached = null
cb()
}
window.addEventListener(CHANGE_EVENT, onChange)
window.addEventListener("storage", (e) => {
if (e.key === STORAGE_KEY) onChange()
})
return () => {
window.removeEventListener(CHANGE_EVENT, onChange)
}
}
function getSnapshot(): Profile {
if (!cached) cached = readFromStorage()
return cached
}
function getServerSnapshot(): Profile {
return DEFAULT_PROFILE
}
export function useProfile(): Profile {
const value = useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot)
useEffect(() => {
cached = null
}, [])
return value
}

217
app/lib/threads.ts Normal file
View File

@@ -0,0 +1,217 @@
// Conversation threads — multiple named chats, each with its own history,
// active agent, and pinned message indices. Persisted in localStorage.
import { useEffect, useSyncExternalStore } from "react"
export type ThreadMessage = { role: "user" | "assistant"; content: string }
export type Thread = {
id: string
title: string
agentId: string
messages: ThreadMessage[]
pinned: number[] // indices into messages[]
createdAt: number
updatedAt: number
}
const THREADS_KEY = "crema.assistant.threads"
const ACTIVE_KEY = "crema.assistant.activeThreadId"
const SNAPSHOT_KEY_PREFIX = "crema.assistant.thread.snapshot."
const CHANGE_EVENT = "crema:threads-change"
const MAX_BYTES = 800_000
export function newThreadId(): string {
return `t-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 6)}`
}
function isThread(v: unknown): v is Thread {
if (!v || typeof v !== "object") return false
const t = v as Thread
return (
typeof t.id === "string" &&
typeof t.title === "string" &&
typeof t.agentId === "string" &&
Array.isArray(t.messages) &&
Array.isArray(t.pinned) &&
typeof t.createdAt === "number" &&
typeof t.updatedAt === "number"
)
}
function readFromStorage(): Thread[] {
if (typeof window === "undefined") return []
try {
const raw = localStorage.getItem(THREADS_KEY)
if (!raw) return []
const parsed = JSON.parse(raw)
if (!Array.isArray(parsed)) return []
return parsed.filter(isThread)
} catch {
return []
}
}
function writeToStorage(threads: Thread[]) {
if (typeof window === "undefined") return
let serialized = JSON.stringify(threads)
// Trim oldest threads if quota gets tight.
let trimmed = threads
while (serialized.length > MAX_BYTES && trimmed.length > 1) {
trimmed = trimmed.slice(0, -1)
serialized = JSON.stringify(trimmed)
}
try {
localStorage.setItem(THREADS_KEY, serialized)
window.dispatchEvent(new CustomEvent(CHANGE_EVENT))
} catch {
/* quota — bail */
}
}
export function loadThreads(): Thread[] {
return readFromStorage()
}
export function saveThreads(threads: Thread[]) {
writeToStorage(threads)
}
export function loadActiveThreadId(): string | null {
if (typeof window === "undefined") return null
return localStorage.getItem(ACTIVE_KEY)
}
export function saveActiveThreadId(id: string | null) {
if (typeof window === "undefined") return
if (id) localStorage.setItem(ACTIVE_KEY, id)
else localStorage.removeItem(ACTIVE_KEY)
window.dispatchEvent(new CustomEvent(CHANGE_EVENT))
}
let cached: Thread[] | null = null
function subscribe(cb: () => void): () => void {
const onChange = () => {
cached = null
cb()
}
window.addEventListener(CHANGE_EVENT, onChange)
window.addEventListener("storage", (e) => {
if (e.key === THREADS_KEY || e.key === ACTIVE_KEY) onChange()
})
return () => {
window.removeEventListener(CHANGE_EVENT, onChange)
}
}
function getSnapshot(): Thread[] {
if (!cached) cached = readFromStorage()
return cached
}
function getServerSnapshot(): Thread[] {
return []
}
export function useThreads(): Thread[] {
const value = useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot)
useEffect(() => {
cached = null
}, [])
return value
}
export function ensureThread(
threads: Thread[],
fallbackAgentId: string,
): { threads: Thread[]; activeId: string } {
const stored = loadActiveThreadId()
if (stored && threads.some((t) => t.id === stored))
return { threads, activeId: stored }
if (threads.length > 0) {
saveActiveThreadId(threads[0].id)
return { threads, activeId: threads[0].id }
}
const id = newThreadId()
const now = Date.now()
const fresh: Thread = {
id,
title: "New conversation",
agentId: fallbackAgentId,
messages: [],
pinned: [],
createdAt: now,
updatedAt: now,
}
saveActiveThreadId(id)
saveThreads([fresh, ...threads])
return { threads: [fresh, ...threads], activeId: id }
}
export function updateThread(id: string, patch: Partial<Thread>) {
const threads = readFromStorage()
const next = threads.map((t) =>
t.id === id ? { ...t, ...patch, updatedAt: Date.now() } : t,
)
writeToStorage(next)
}
export function createThread(agentId: string, title = "New conversation"): Thread {
const threads = readFromStorage()
const id = newThreadId()
const now = Date.now()
const fresh: Thread = {
id,
title,
agentId,
messages: [],
pinned: [],
createdAt: now,
updatedAt: now,
}
writeToStorage([fresh, ...threads])
saveActiveThreadId(id)
return fresh
}
export function deleteThread(id: string) {
const threads = readFromStorage()
const next = threads.filter((t) => t.id !== id)
writeToStorage(next)
if (loadActiveThreadId() === id) {
saveActiveThreadId(next[0]?.id ?? null)
}
}
export function snapshotThread(id: string) {
const threads = readFromStorage()
const t = threads.find((x) => x.id === id)
if (!t) return
try {
localStorage.setItem(SNAPSHOT_KEY_PREFIX + id, JSON.stringify(t))
} catch {
/* quota */
}
}
export function loadThreadSnapshot(id: string): Thread | null {
if (typeof window === "undefined") return null
try {
const raw = localStorage.getItem(SNAPSHOT_KEY_PREFIX + id)
if (!raw) return null
const parsed = JSON.parse(raw)
return isThread(parsed) ? parsed : null
} catch {
return null
}
}
export function clearThreadSnapshot(id: string) {
if (typeof window === "undefined") return
localStorage.removeItem(SNAPSHOT_KEY_PREFIX + id)
}
export function deriveTitleFromFirstMessage(text: string): string {
const trimmed = text.trim().split(/\s+/).slice(0, 8).join(" ")
return trimmed.length > 60 ? trimmed.slice(0, 57) + "…" : trimmed || "New conversation"
}