feat: add multi-project support (#110)

* feat: Implement project management store with project path validation and synchronization

- Added `useProjectsStore` for managing projects, including adding, removing, renaming, and validating project paths.
- Implemented persistence for projects and active project ID using safe storage.
- Introduced synchronization from desktop settings to keep project data consistent.
- Enhanced session store to manage sessions by directory and added new methods for session management.
- Updated todo store to fetch session todos based on the directory context.
- Refactored server code to validate and resolve project directories for various API endpoints.
- Added project entry validation and sanitization to ensure data integrity.

* feat(settings): migrate legacy project settings and update settings loading logic

* feat: enhance project management with directory-aware settings and improved agent/command source handling

* feat: enhance session and project management with directory-aware settings and improved configuration refresh logic

* feat: enhance project management with worktree manager integration and project directory resolution

* feat: enhance agent groups store with project directory resolution and loading logic

* feat: add heartbeat management and global wrapping for SSE blocks in agent and chat providers

* feat: refactor command and project handling in useCommandsStore

- Replaced useDirectoryStore with useProjectsStore to manage project paths.
- Introduced getRequestDirectory function to determine the active project directory.
- Updated command fetching to respect project-level scoping.
- Enhanced error handling and logging for command configuration fetching.
- Improved command configuration saving and updating to utilize project directory context.

feat: enhance project path normalization in useProjectsStore

- Added resolveTildePath function to expand paths starting with ~.
- Updated normalizeProjectPath to utilize home directory for path expansion.

fix: update permission handling in useSessionStore

- Changed Permission type to PermissionRequest for clarity.
- Updated respondToPermission method to use requestId instead of permissionId.

refactor: improve permission utilities

- Introduced types for PermissionAction and PermissionRule.
- Enhanced getAgentDefinition and resolveConfigStore functions for better type safety.
- Added resolvePermissionAction to streamline permission resolution logic.

feat: add agent configuration retrieval endpoint

- Implemented new API endpoint to fetch agent configuration based on project directory.
- Enhanced getAgentPermissionSource to prioritize project-level permissions.

chore: update SDK version in package.json files

- Bumped @opencode-ai/sdk version to ^1.1.1 across all relevant package.json files.

refactor: streamline bridge message handling

- Updated handleBridgeMessage to accept directory parameter for agent and command requests.
- Improved local API request handling to extract directory from query parameters and headers.

feat: enhance project configuration management

- Added functions to retrieve and merge project configuration paths.
- Improved handling of existing project configuration files for agents and commands.

* feat: enhance VSCode integration and session management

- Added support for a sticky sidebar header background in light and dark themes.
- Introduced functions to read VSCode workspace directory and check if running in VSCode.
- Implemented detailed logging for session loading and creation processes.
- Enhanced session filtering based on directory structure and canonical paths.
- Added a new method to reorder projects and prevent modifications in VSCode workspace.
- Improved error handling and logging for app initialization and markdown file parsing.
- Updated API checks and health checks to ensure readiness before proceeding.
- Refactored code for better readability and maintainability across various modules.

* feat: improve agent and branch selection logic, enhance session management, and update multi-run creation response

* feat: add worktree management actions in agent group detail and sidebar, including delete and keep only options

* fix(ui): share IME guard and cover multi-run

* fix(session): reduce maximum visible sessions in group from 7 to 5

packages/ui/src/components/multirun/AgentSelector.tsx

@@ -4,7 +4,6 @@ import {
   SelectContent,
   SelectGroup,
   SelectItem,
-  SelectLabel,
   SelectTrigger,
   SelectValue,
 } from '@/components/ui/select';
@@ -36,25 +35,51 @@ export const AgentSelector: React.FC<AgentSelectorProps> = ({
 }) => {
   const getVisibleAgents = useConfigStore((state) => state.getVisibleAgents);
   const loadAgents = useConfigStore((state) => state.loadAgents);
+  const defaultAgentName = useConfigStore((state) => state.currentAgentName);
   const agents = getVisibleAgents();
+  const selectableAgents = React.useMemo(
+    () => agents.filter((agent) => agent.mode !== 'subagent'),
+    [agents]
+  );
 
   // Load agents on mount
   React.useEffect(() => {
     loadAgents();
   }, [loadAgents]);
 
-  // Use empty string to represent "no agent" selection
-  const handleValueChange = (newValue: string) => {
-    onChange(newValue === '__none__' ? '' : newValue);
-  };
+  // Ensure we always have a valid selection (defaults to current default agent, then first selectable agent).
+  React.useEffect(() => {
+    if (disabled) {
+      return;
+    }
 
-  // Convert empty value to __none__ for the Select component (which doesn't handle empty strings well)
-  const selectValue = value || '__none__';
+    const trimmedValue = value.trim();
+    if (trimmedValue.length > 0 && selectableAgents.some((agent) => agent.name === trimmedValue)) {
+      return;
+    }
+
+    const candidateDefault =
+      typeof defaultAgentName === 'string' && defaultAgentName.trim().length > 0
+        ? defaultAgentName.trim()
+        : null;
+
+    if (candidateDefault && selectableAgents.some((agent) => agent.name === candidateDefault)) {
+      onChange(candidateDefault);
+      return;
+    }
+
+    const firstAgent = selectableAgents[0]?.name;
+    if (firstAgent) {
+      onChange(firstAgent);
+    }
+  }, [defaultAgentName, disabled, onChange, selectableAgents, value]);
+
+  const selectValue = value.trim().length > 0 ? value : undefined;
 
   return (
     <Select
       value={selectValue}
-      onValueChange={handleValueChange}
+      onValueChange={onChange}
       disabled={disabled}
     >
       <SelectTrigger
@@ -62,20 +87,12 @@ export const AgentSelector: React.FC<AgentSelectorProps> = ({
         size="lg"
         className={className ?? 'max-w-full typography-meta text-foreground'}
       >
-        <SelectValue placeholder="Select an agent (optional)" />
+        <SelectValue placeholder="Select an agent" />
       </SelectTrigger>
       <SelectContent fitContent>
-        <SelectGroup>
-          <SelectLabel>Default</SelectLabel>
-          <SelectItem value="__none__" className="w-auto whitespace-nowrap">
-            No agent (default)
-          </SelectItem>
-        </SelectGroup>
-
-        {agents.length > 0 && (
+        {selectableAgents.length > 0 && (
           <SelectGroup>
-            <SelectLabel>Agents</SelectLabel>
-            {agents.map((agent) => (
+            {selectableAgents.map((agent) => (
               <SelectItem
                 key={agent.name}
                 value={agent.name}

packages/ui/src/components/multirun/BranchSelector.tsx

@@ -126,6 +126,9 @@ export const BranchSelector: React.FC<BranchSelectorProps> = ({
   id,
 }) => {
   const { branches, isLoading, isGitRepository } = useBranchOptions(directory);
+  const selectedLabel = React.useMemo(() => {
+    return branches.find((option) => option.value === value)?.label ?? null;
+  }, [branches, value]);
 
   // Update value if it's no longer valid
   React.useEffect(() => {
@@ -149,9 +152,11 @@ export const BranchSelector: React.FC<BranchSelectorProps> = ({
           size="lg"
           className={className ?? 'max-w-full typography-meta text-foreground'}
         >
-          <SelectValue
-            placeholder={isLoading ? 'Loading branches…' : 'Select a branch'}
-          />
+          {selectedLabel ? (
+            <SelectValue>{selectedLabel}</SelectValue>
+          ) : (
+            <SelectValue placeholder={isLoading ? 'Loading branches…' : 'Select a branch'} />
+          )}
         </SelectTrigger>
         <SelectContent fitContent>
           <SelectGroup>

packages/ui/src/components/multirun/ModelMultiSelect.tsx

@@ -5,6 +5,7 @@ import { Input } from '@/components/ui/input';
 import { ScrollableOverlay } from '@/components/ui/ScrollableOverlay';
 import { ProviderLogo } from '@/components/ui/ProviderLogo';
 import { cn } from '@/lib/utils';
+import { isIMECompositionEvent } from '@/lib/ime';
 import { useConfigStore } from '@/stores/useConfigStore';
 import { useModelLists } from '@/hooks/useModelLists';
 import type { ModelMetadata } from '@/types';
@@ -325,6 +326,9 @@ export const ModelMultiSelect: React.FC<ModelMultiSelectProps> = ({
 
             // Handle keyboard navigation
             const handleKeyDown = (e: React.KeyboardEvent) => {
+              if (isIMECompositionEvent(e)) {
+                return;
+              }
               if (e.key === 'ArrowDown') {
                 e.preventDefault();
                 e.stopPropagation();

packages/ui/src/components/multirun/MultiRunLauncher.tsx

@@ -320,7 +320,7 @@ export const MultiRunLauncher: React.FC<MultiRunLauncherProps> = ({
                 id="multirun-agent"
               />
               <p className="typography-micro text-muted-foreground">
-                Optional agent to use for all runs.
+                Defaults to your configured default agent.
               </p>
             </div>