Skip to content

armgit / orca

Public Imported from GitHub
0

Orca is the place for working with a fleet of agents (e.g. Grok Bot, Claude Code). Run any coding agent with your own subscription. Available on desktop, mobile and remote runtime.

16.5 KB
Raw Blame
import type { JiraQuickFilterState } from './jira/jira-quick-filters'
import type { BrowserDevToolsDockLayout } from './browser-devtools-dock'
import type { JiraSavedFilterState } from './jira/jira-saved-filters'
import type { ReleaseChannel } from './release-channel'
import type { WorkspaceCleanupUIState } from './workspace-cleanup'
import type { FeatureTipId } from './feature-tips'
import type { ContextualTourId } from './contextual-tours'
import type { FeatureInteractionState } from './feature-interactions'
import type { UsagePercentageDisplay } from './usage-percentage-display'
import type { StatusBarUsageMode } from './status-bar-usage-mode'
import type { PersistedTrustedOrcaHooks } from './orca-yaml-hook-types'
import type { CustomPet } from './pet-types'
import type {
  ActivityGroupBy,
  AgentActivityDisplayMode,
  ManualRepoOrderEntry,
  ProjectOrderBy,
  RightSidebarExplorerView,
  RightSidebarTab,
  StatusBarItem,
  TaskResumeState,
  ThreadReadFilter,
  TopLevelView,
  VisibleWorkspaceHostIds,
  WorkspaceHostOrder,
  WorkspaceHostScope,
  WorktreeCardProperty
} from './ui-chrome-types'
import type { WorkspaceStatusDefinition } from './worktree/types'
import type { PersistedAutomationHostFilter } from './automation-host-filter'
import type { PendingRuntimeRepoRemoval } from './pending-runtime-repo-removal'

export type PersistedUIState = {
  /** Paired-server project removals still owed to their server; optional so older builds ignore it. */
  pendingRuntimeRepoRemovals?: PendingRuntimeRepoRemoval[]
  jiraSavedFilterState?: JiraSavedFilterState
  jiraQuickFilterState?: JiraQuickFilterState
  lastActiveRepoId: string | null
  lastActiveWorktreeId: string | null
  /** Active top-level view at save time, restored on relaunch; sanitized to 'terminal' if unknown or now-gated. */
  activeView: TopLevelView
  sidebarWidth: number
  sidebarOpen?: boolean
  rightSidebarOpen: boolean
  rightSidebarTab: RightSidebarTab
  rightSidebarExplorerView: RightSidebarExplorerView
  rightSidebarWidth: number
  markdownTocPanelWidth?: number
  combinedDiffFileTreeWidth?: number
  groupBy: 'none' | 'workspace-status' | 'repo' | 'pr-status'
  sortBy: 'name' | 'smart' | 'recent' | 'repo' | 'manual'
  /** Project-header order in repo grouping, independent of workspace sort: manual permits drag, recent follows visible activity. */
  projectOrderBy: ProjectOrderBy
  /** Deprecated; the Active only filter is retired and ignored on hydration. */
  showActiveOnly: boolean
  /** Hide sleeping/inactive workspaces from workspace navigation. Off by default. */
  hideSleepingWorkspaces?: boolean
  /** Which execution hosts the sidebar shows; `all` = mixed view, specific IDs focus without tearing down other hosts' sessions. */
  workspaceHostScope?: WorkspaceHostScope
  /** Which execution hosts the sidebar shows; `null` = sticky all-hosts so new hosts appear automatically. */
  visibleWorkspaceHostIds?: VisibleWorkspaceHostIds
  /** User-defined sidebar order for host sections; missing/new hosts append in discovered order. */
  workspaceHostOrder?: WorkspaceHostOrder
  /** Automations page host filter. Stores only a canonical host key; invalid values degrade to all hosts. */
  automationHostFilter?: PersistedAutomationHostFilter
  /** Desktop-owned all-host repo order; host-qualified identities keep a manual cross-host interleaving while each host owns its local permutation. */
  manualRepoOrder?: ManualRepoOrderEntry[]
  /** Deprecated legacy positive-form setting. Ignored on hydration. */
  showSleepingWorkspaces?: boolean
  /** Deprecated legacy name used by a short-lived build. Ignored on hydration. */
  showInactiveWorkspaces?: boolean
  /** Hide the repo's checked-out branch from workspace nav (sidebar, Cmd+J); folder-mode repos are unaffected (empty-branch worktrees excluded). */
  hideDefaultBranchWorkspace: boolean
  /** Hide workspaces created by automation new-per-run dispatches. */
  hideAutomationGeneratedWorkspaces?: boolean
  /** Hide workspaces created through `orca worktree create`. */
  hideCliCreatedWorkspaces?: boolean
  /** Hide workspaces sitting on a detached HEAD; folder workspaces (no head at all) are unaffected. */
  hideDetachedHeadWorkspaces?: boolean
  /** Hide workspaces with known provenance from another paired device or the host UI. */
  hideWorkspacesFromOtherDevices?: boolean
  /** Keep each project's main workspace out of the "Hide sleeping" sweep. Absent means on (#8873). */
  alwaysShowDefaultBranchWorkspace?: boolean
  /** Per-worktree Explorer dotfile visibility. Missing entries inherit the default: show. */
  _explorerDisplayRootMigrated?: boolean
  explorerDisplayRootByWorktree?: Record<string, string>
  showDotfilesByWorktree?: Record<string, boolean>
  filterRepoIds: string[]
  /** Agents host scope stays separate from navigation filters; null means all hosts. */
  agentsVisibleHostIds?: VisibleWorkspaceHostIds
  /** Agents-view project filter; empty = all projects. Separate from filterRepoIds (workspace nav). */
  agentsFilterRepoIds?: string[]
  /** Agents-view workspace-origin filters; separate from the workspace-nav hide flags. Absent means off. */
  agentsHideWorkspacesFromOtherDevices?: boolean
  agentsHideAutomationGeneratedWorkspaces?: boolean
  agentsHideCliCreatedWorkspaces?: boolean
  /** Agents-view: include child (orchestration-dispatched) agent threads. Absent means off. */
  agentsShowChildAgents?: boolean
  /** Agents-view compact thread rows. Absent means on. */
  agentsCompactMode?: boolean
  /** Agents sidebar search field visibility. Absent means on. */
  agentsShowSearch?: boolean
  /** Agents-view unread-only thread filter. Absent means 'all'. */
  agentsReadFilter?: ThreadReadFilter
  /** Agents-view thread grouping. Absent means 'status'. */
  agentsGroupBy?: ActivityGroupBy
  collapsedGroups: string[]
  uiZoomLevel: number
  editorFontZoomLevel: number
  worktreeCardProperties: WorktreeCardProperty[]
  /** One-shot migration flag for deriving card properties from the two worktree card modes. */
  _worktreeCardModeDefaulted?: boolean
  showAgentModels?: boolean
  agentActivityDisplayMode?: AgentActivityDisplayMode
  workspaceStatuses?: WorkspaceStatusDefinition[]
  workspaceBoardOpacity?: number
  workspaceBoardColumnWidth?: number
  syncTaskStatusFromWorkspaceBoard?: boolean
  /** Migrate reversed defaults once; never infer later user order from IDs/labels. */
  _workspaceStatusesDefaultOrderMigrated?: boolean
  /** One-shot repair flag for the exact default payload a short-lived build persisted in reverse workflow order. */
  _workspaceStatusesReorderedDefaultRepaired?: boolean
  /** One-shot migration flag for default status workflow labels/visuals; only exact legacy defaults migrate, customized statuses preserved. */
  _workspaceStatusesDefaultWorkflowMigrated?: boolean
  /** One-shot migration flag for the old default status visuals; once stamped, user-authored colors/icons are preserved. */
  _workspaceStatusesDefaultVisualsMigrated?: boolean
  /** One-shot migration flag for adding the default-on Ports status item. */
  _portsStatusBarDefaultAdded?: boolean
  /** One-shot migration flag for adding the default-on Kimi status item. */
  _kimiStatusBarDefaultAdded?: boolean
  /** One-shot migration flag for adding the default-on MiniMax status item. */
  _minimaxStatusBarDefaultAdded?: boolean
  /** One-shot migration flag for adding the default-on Antigravity status item. */
  _antigravityStatusBarDefaultAdded?: boolean
  /** One-shot migration flag for adding the default-on Grok status item. */
  _grokStatusBarDefaultAdded?: boolean
  /** One-shot migration flag for adding the default-on Cursor status item. */
  _cursorStatusBarDefaultAdded?: boolean
  /** One-shot migration flag for adding the default-on ZCode status item. */
  _zcodeStatusBarDefaultAdded?: boolean
  statusBarItems: StatusBarItem[]
  statusBarVisible: boolean
  /** Why: this is client-side presentation, not a provider/account or execution-host setting. */
  usagePercentageDisplay?: UsagePercentageDisplay
  /** Client-side footer presentation; verbose preserves the pre-roster all-window default. */
  statusBarUsageMode?: StatusBarUsageMode
  dismissedUpdateVersion: string | null
  /** Version when the sign-out notice was seen or dismissed; any value suppresses future appearances. */
  dismissedUnexpectedSignoutVersion?: string | null
  lastUpdateCheckAt: number | null
  /** Dev-only update channel override; absent means the build's own channel. */
  releaseChannelOverride?: ReleaseChannel | null
  pendingUpdateNudgeId?: string | null
  dismissedUpdateNudgeId?: string | null
  /** Whether Orca already tried triggering the macOS notification permission dialog; prevents re-firing every launch. */
  notificationPermissionRequested?: boolean
  /** Once the "your sessions won't be interrupted" reassurance card is seen, never show it again. */
  updateReassuranceSeen?: boolean
  /** Renderer ui:set acknowledgments by pane/turn timestamp; persist so seen rows stay read after restart. */
  acknowledgedAgentsByPaneKey?: Record<string, number>
  /** Renderer ui:set cutoffs hide events at/before the timestamp; persist so cleared rows stay hidden after restart. */
  activityClearedAtByPaneKey?: Record<string, number>
  /** Renderer ui:set explicit unread turn stamps survive restart alongside acknowledgments and cutoffs. */
  manuallyUnreadTurnsByPaneKey?: Record<string, number>
  /** User-hidden setup-guide sidebar entry; a reversible declutter pref (Help menu stays available), not completion. */
  setupGuideSidebarDismissed?: boolean
  /** One-shot marker for the browser setup-guide milestone; profiles missing it are evaluated once in the renderer (completion needs runtime probes). */
  setupGuideBrowserMilestoneMigrated?: boolean
  /** Existing users who completed/dismissed the pre-browser checklist stay complete after the browser milestone is added. */
  setupGuideBrowserMilestoneLegacyComplete?: boolean
  /** User-dismissed browser import toolbar hint; import stays available from Settings > Browser and the overflow menu. */
  browserImportHintHidden?: boolean
  /** Why: Windows-only. Set once on first hide to tray so the "Orca is still running" notice shows only once. */
  trayMinimizeNoticeShown?: boolean
  /** Set by the OSC 52 default-on migration when it overrode a persisted `false`; the renderer shows one notice and clears it. */
  osc52ClipboardDefaultOnNoticePending?: boolean
  /** User dismissed the first-run Mobile Emulator intro; reversible only by re-enabling the feature in Settings. */
  mobileEmulatorTabIntroDismissed?: boolean
  /** User deferred the in-pane Mobile Emulator CLI + skill setup guide. */
  mobileEmulatorAgentSetupDismissed?: boolean
  /** One-shot rollout notice for manual project ordering default; absent or true keeps the sidebar callout hidden. */
  projectOrderManualDefaultNoticeDismissed?: boolean
  /** One-shot notice that usage meters show percent used, not remaining; absent resolves on load (new profiles dismissed, upgraded see it once). */
  usagePercentageDisplayChangeNoticeDismissed?: boolean
  /** One-time Compact notice; load decides eligibility before filling missing preferences. */
  statusBarCompactChangeNoticeDismissed?: boolean
  /** User dismissed the Alpha notice at the top of Settings > Plugins. */
  pluginsAlphaNoticeDismissed?: boolean
  /** User-hidden empty-state usage CTA; permanently hides the "Connect AI accounts" prompt even if providers are later disconnected. */
  usageEmptyStateDismissed?: boolean
  /** One-shot toast announcing per-terminal Codex servers; set when shown, so absent means not yet seen. */
  codexTerminalServerIsolationNoticeSeen?: boolean
  /** Windows one-shot toast for Codex moving onto ~/.codex; set when shown, so absent means not yet seen. */
  codexSharedSettingsNoticeSeen?: boolean
  /** One-shot pane banner explaining Claude Code's own diff panel; set when the user closes it. */
  claudeDiffPanelNoticeSeen?: boolean
  /** Retired one-shot Claude sign-in toast; kept because a paired client from that build still sends it. */
  claudeAccountSignInNoticeSeen?: boolean
  /** URL for new browser tabs; null = blank tab. */
  browserDefaultUrl?: string | null
  browserDefaultSearchEngine?: 'google' | 'duckduckgo' | 'bing' | 'kagi' | null
  /** Electron browser zoom level applied when a new local browser tab is created. */
  browserDefaultZoomLevel?: number
  /** Optional Kagi private-session link used only when Kagi is the search engine. */
  browserKagiSessionLink?: string | null
  /** Side and size of DevTools docked in a browser pane; one choice for every page, like Chrome. */
  browserDevToolsDock?: BrowserDevToolsDockLayout
  /** Saved window bounds so the app restores last position/size instead of maximizing each launch. */
  windowBounds?: { x: number; y: number; width: number; height: number } | null
  /** Whether the window was maximized when it was last closed. */
  windowMaximized?: boolean
  /** Dashboard popout bounds, independent of main-window bounds. */
  dashboardPopoutBounds?: { x: number; y: number; width: number; height: number } | null
  /** Migrate legacy recent→smart once so later activity-based recent selections survive. */
  _sortBySmartMigrated?: boolean
  /** Rollback field only: every load stamps it, so it cannot gate migration; use _inlineAgentsDefaultedForAllUsers. */
  _inlineAgentsDefaultedForExperiment?: boolean
  /** One-shot flag for the inline-agents default-on rollout; distinct from _inlineAgentsDefaultedForExperiment, which was stamped every load and is permanently dirty. */
  _inlineAgentsDefaultedForAllUsers?: boolean
  /** One-shot migration flag for split-out card properties, set once so later deliberate unchecks of Linear issue/Ports stick across restarts. */
  _expandedWorktreeCardPropertiesDefaulted?: boolean
  /** One-shot backfill flag for 'jira-issue', which joined the defaults after the expansion migration had already stamped upgraded profiles. */
  _jiraIssueWorktreeCardPropertyDefaulted?: boolean
  /** One-shot backfill flag for 'host', which became a toggleable property after earlier profiles were already stamped. */
  _hostWorktreeCardPropertyDefaulted?: boolean
  /** Agent total when the star countdown began or was deferred; preserved across app updates. */
  starNagBaselineAgents?: number | null
  /** Legacy baseline version retained for older builds; no longer resets the countdown. */
  starNagAppVersion?: string | null
  /** Next agents-since-baseline threshold that fires the star-nag; starts at 35, doubles per dismissal without starring. */
  starNagNextThreshold?: number
  /** Once the user has starred Orca (any entry point), permanently suppress the nag. */
  starNagCompleted?: boolean
  /** Timestamp until which nonterminal dismissals suppress threshold prompts (force-show bypasses for dev/testing). */
  starNagDeferredUntil?: number | null
  /** Version that consumed the one-time value-moment ask; any saved version suppresses future attempts. Main-owned. */
  starNagAgentValueMomentAppVersion?: string | null
  trustedOrcaHooks?: PersistedTrustedOrcaHooks
  setupScriptPromptDismissedRepoIds?: string[]
  /** Pet overlay visibility, separate from the experimentalPet settings flag so "Hide pet" is a reversible dismiss; absent = true. */
  petVisible?: boolean
  /** Active pet id (bundled id or custom UUID); unknown ids fall back to the default on read so a removed custom pet doesn't blank the overlay. */
  petId?: string
  /** Metadata index for user-uploaded pet images; bytes live under legacy userData/sidekicks/custom/. */
  customPets?: CustomPet[]
  /** Pet overlay size in CSS pixels (square); clamped to [PET_SIZE_MIN, PET_SIZE_MAX] on read. */
  petSize?: number
  /** Legacy keys from before the sidekick -> pet rename; read only during migration, new writes use pet* above. */
  sidekickVisible?: boolean
  sidekickId?: string
  customSidekicks?: CustomPet[]
  sidekickSize?: number
  /** Page-position state for Tasks: only transient tabs/searches (source/repo/team/project selections use their own settings paths). */
  taskResumeState?: TaskResumeState
  workspaceCleanup?: WorkspaceCleanupUIState
  /** Feature tips already surfaced; startup opens the tips modal only when a current tip id is missing here. */
  featureTipsSeenIds?: FeatureTipId[]
  /** Feature ids the user has actually used; education surfaces skip teaching already-discovered features. */
  featureInteractions?: FeatureInteractionState
  /** Contextual tours already surfaced; unknown ids ignored on hydration for downgrade/upgrade forward-compat. */
  contextualToursSeenIds?: ContextualTourId[]
  /** Whether this profile may receive automatic contextual tours; missing = renderer hasn't classified the profile yet. */
  contextualToursAutoEligible?: boolean
}