Stores

All renderer state lives in Zustand v5 stores in @openconduit/core/src/stores/.

conversationStore

Manages conversations and open tabs.

import { useConversationStore } from '@openconduit/core';

Action	Signature	Description
addConversation	(opts: { providerId, model }) => Conversation	Creates and returns a new conversation
updateConversation	(id, patch) => void	Partial update a conversation
deleteConversation	(id) => void	Deletes a conversation
openTab	(id) => void	Adds id to openTabs
closeTab	(id) => void	Removes id from openTabs

State	Type	Description
conversations	Conversation[]	All conversations
openTabs	string[]	Currently open tab ids

uiStore

UI state — active conversation, panels, modals, notifications.

import { useUiStore } from '@openconduit/core';

Action	Signature	Description
setActiveConversation	(id: string | null) => void	Sets the active conversation
setShowSettings	(v: boolean) => void	Opens/closes the settings panel
setCommandPaletteOpen	(v: boolean) => void	Opens/closes the command palette
addNotification	(payload: Omit<AppNotification, 'id' | 'timestamp' | 'read'>) => void	Fires an in-app notification
markRead	(id: string) => void	Marks a single notification as read
markAllRead	() => void	Marks all notifications as read
clearNotifications	() => void	Clears all notifications

addNotification payload

addNotification({
  title: 'Export complete',
  message: 'Conversation saved to file', // optional
  variant: 'success',                    // 'info' | 'success' | 'warning' | 'error'
  source: 'app',                         // optional, defaults to 'app'
});

Payloads are intentionally serializable (no React nodes) so that future extension callers (#38) can fire them over IPC.

settingsStore

Wraps electron-store settings via IPC.

import { useSettingsStore } from '@openconduit/core';

State	Type	Description
settings	AppSettings | null	Current settings
models	string[]	Loaded model list

Action	Signature	Description
saveSettings	(patch: Partial<AppSettings>) => void	Persists settings via IPC
loadModels	() => void	Fetches available models from the active provider

analyticsStore

Tracks token usage and cost per conversation. Persisted to localStorage under openconduit-analytics.

import { useAnalyticsStore } from '@openconduit/core';

State	Type	Description
records	UsageRecord[]	All usage records, newest first

Action	Signature	Description
addRecord	(params, pricing?) => void	Appends a UsageRecord; computes USD cost if pricing data is available
clearRecords	() => void	Wipes all records

addRecord params

addRecord(
  {
    conversationId: string;
    providerId: string;
    model: string;
    usage: TokenUsage; // { inputTokens, outputTokens }
  },
  pricing?: ModelPricing, // optional — from provider registry
)

---

tasksStore

Holds the AI-generated task list for the active conversation. The task list is extracted from <ai-tasks> XML blocks in AI responses by useChat and replaced in full on every update.

import { useTasksStore } from '@openconduit/core';

State	Type	Description
tasks	AiTask[]	Current task list
conversationId	string | null	Conversation the tasks belong to

Action	Signature	Description
setTasks	(tasks: AiTask[], conversationId: string) => void	Replace the full task list
clearTasks	() => void	Clear tasks and conversationId

AiTask

interface AiTask {
  id: string;
  text: string;
  status: 'pending' | 'in-progress' | 'done' | 'cancelled';
}

---

personasStore

Manages personas (named system-prompt presets). Persisted to localStorage under openconduit-personas. The default persona always exists and cannot be deleted.

import { usePersonasStore } from '@openconduit/core';

State	Type	Description
personas	Persona[]	All personas including defaults

Action	Signature	Description
addPersona	(partial: Omit<Persona, 'id' | 'isDefault'>) => Persona	Creates and returns a new persona
updatePersona	(id, updates) => void	Update name, color, or systemPrompt (blocked on isDefault personas)
deletePersona	(id) => void	Delete a non-default persona
duplicatePersona	(id) => Persona | null	Clone a persona with a new id
importPersonas	(personas: Persona[]) => void	Bulk-import personas (merges by id)
getPersona	(id) => Persona | undefined	Look up a persona by id

Persona

interface Persona {
  id: string;
  name: string;
  systemPrompt: string;
  color: string;   // hex color for the avatar badge
  isDefault: boolean;
}

---

useSavedFilesStore

Stores files that were saved from conversations (e.g. AI-generated artifacts). Persisted to localStorage under openconduit-files.

Note

The export name is useSavedFilesStore, not useFilesStore.

import { useSavedFilesStore } from '@openconduit/core';

State	Type	Description
files	SavedFile[]	All saved files, newest first

Action	Signature	Description
saveFile	(file: Omit<SavedFile, 'id' | 'savedAt'>) => string	Saves and returns the new file id
renameFile	(id, name) => void	Rename a file
deleteFile	(id) => void	Delete a file

SavedFile

interface SavedFile {
  id: string;
  name: string;
  content: string;
  mimeType: string;
  size: number;
  conversationId?: string;
  savedAt: number;
}