feat: Upgrade Claude adapter to ACP SDK v0.22.2 (#1330)

## Problem

Claude adapter was on SDK v0.21.0 (ACP 0.15.0, agent-sdk 0.2.71)

<!-- Who is this for and what problem does it solve? -->

<!-- Closes #ISSUE_ID -->

## Changes

1. Bump @agentclientprotocol/sdk to 0.16.1 and @anthropic-ai/claude-agent-sdk to 0.2.76
2. Add SessionConfigOption union type (select + boolean) and guard all config access with type narrowing
3. Add session reuse via getExistingSessionState for resume/load flows
4. Add local-only command handling (/context, /heapdump, /extra-usage) and prompt replay tracking
5. Add model alias resolution (resolveModelPreference) for human-friendly model names
6. Add "bypass all permissions" option to ExitPlanMode and additionalRoots support
7. Clean up permission handler interrupt flags and remove /context special-case hack in sdk-to-acp

<!-- What did you change and why? -->

<!-- If there are frontend changes, include screenshots. -->

## How did you test this?

Manually

<!-- Describe what you tested -- manual steps, automated tests, or both. -->

<!-- If you're an agent, only list tests you actually ran. -->

Author: charlesvien

apps/code/src/main/services/agent/schemas.ts

@@ -82,7 +82,7 @@ const sessionConfigSelectGroupSchema = z
   })
   .passthrough();
 
-export const sessionConfigOptionSchema = z
+const sessionConfigSelectSchema = z
   .object({
     id: z.string(),
     name: z.string(),
@@ -97,6 +97,23 @@ export const sessionConfigOptionSchema = z
   })
   .passthrough();
 
+const sessionConfigBooleanSchema = z
+  .object({
+    id: z.string(),
+    name: z.string(),
+    type: z.literal("boolean"),
+    currentValue: z.boolean(),
+    category: z.string().nullish(),
+    description: z.string().nullish(),
+    _meta: z.record(z.string(), z.unknown()).nullish(),
+  })
+  .passthrough();
+
+export const sessionConfigOptionSchema = z.union([
+  sessionConfigSelectSchema,
+  sessionConfigBooleanSchema,
+]);
+
 export type SessionConfigOption = z.infer<typeof sessionConfigOptionSchema>;
 
 export const sessionResponseSchema = z.object({

apps/code/src/main/services/agent/service.ts

@@ -1022,7 +1022,10 @@ export class AgentService extends TypedEventEmitter<AgentServiceEvents> {
       const updatedModeOption = session.configOptions?.find(
         (opt) => opt.category === "mode",
       );
-      if (updatedModeOption) {
+      if (
+        updatedModeOption &&
+        typeof updatedModeOption.currentValue === "string"
+      ) {
         session.config.permissionMode = updatedModeOption.currentValue;
       }
 

apps/code/src/renderer/features/message-editor/components/AttachmentMenu.tsx

@@ -147,7 +147,10 @@ export function AttachmentMenu({
             </div>
           ) : (
             <div className="issue-picker">
-              <IssuePicker repoPath={repoPath!} onSelect={handleIssueSelect} />
+              <IssuePicker
+                repoPath={repoPath ?? ""}
+                onSelect={handleIssueSelect}
+              />
             </div>
           )}
         </Popover.Content>

apps/code/src/renderer/features/message-editor/components/ModeIndicatorInput.tsx

@@ -2,6 +2,7 @@ import type {
   SessionConfigOption,
   SessionConfigSelectGroup,
   SessionConfigSelectOption,
+  SessionConfigSelectOptions,
 } from "@agentclientprotocol/sdk";
 import {
   Circle,
@@ -60,7 +61,7 @@ interface ModeIndicatorInputProps {
 }
 
 function flattenOptions(
-  options: SessionConfigOption["options"],
+  options: SessionConfigSelectOptions,
 ): SessionConfigSelectOption[] {
   if (options.length === 0) return [];
   if ("group" in options[0]) {
@@ -75,7 +76,7 @@ export function ModeIndicatorInput({
   modeOption,
   onCycleMode,
 }: ModeIndicatorInputProps) {
-  if (!modeOption) return null;
+  if (!modeOption || modeOption.type !== "select") return null;
 
   const id = modeOption.currentValue;
 

apps/code/src/renderer/features/onboarding/components/TutorialStep.tsx

@@ -109,7 +109,8 @@ export function TutorialStep({ onComplete, onBack }: TutorialStepProps) {
   const currentExecutionMode =
     getCurrentModeFromConfigOptions(modeOption ? [modeOption] : undefined) ??
     "plan";
-  const currentReasoningLevel = thoughtOption?.currentValue;
+  const currentReasoningLevel =
+    thoughtOption?.type === "select" ? thoughtOption.currentValue : undefined;
 
   // Task creation — use whatever model the user picked
   const { isCreatingTask, canSubmit, handleSubmit } = useTaskCreation({

apps/code/src/renderer/features/sessions/components/ModelSelector.tsx

@@ -24,26 +24,33 @@ export function ModelSelector({
   const session = useSessionForTask(taskId);
   const modelOption = useModelConfigOptionForTask(taskId);
 
-  const options = modelOption ? flattenSelectOptions(modelOption.options) : [];
+  const selectOption = modelOption?.type === "select" ? modelOption : undefined;
+  const options = selectOption
+    ? flattenSelectOptions(selectOption.options)
+    : [];
   const groupedOptions = useMemo(() => {
-    if (!modelOption || modelOption.options.length === 0) return [];
-    if ("group" in modelOption.options[0]) {
-      return modelOption.options as SessionConfigSelectGroup[];
+    if (!selectOption || selectOption.options.length === 0) return [];
+    if ("group" in selectOption.options[0]) {
+      return selectOption.options as SessionConfigSelectGroup[];
     }
     return [];
-  }, [modelOption]);
+  }, [selectOption]);
 
-  if (!modelOption || options.length === 0) return null;
+  if (!selectOption || options.length === 0) return null;
 
   const handleChange = (value: string) => {
     onModelChange?.(value);
 
     if (taskId && session?.status === "connected") {
-      getSessionService().setSessionConfigOption(taskId, modelOption.id, value);
+      getSessionService().setSessionConfigOption(
+        taskId,
+        selectOption.id,
+        value,
+      );
     }
   };
 
-  const currentValue = modelOption.currentValue;
+  const currentValue = selectOption.currentValue;
   const currentLabel =
     options.find((opt) => opt.value === currentValue)?.name ?? currentValue;
 

apps/code/src/renderer/features/sessions/components/ReasoningLevelSelector.tsx

@@ -20,7 +20,7 @@ export function ReasoningLevelSelector({
   const thoughtOption = useThoughtLevelConfigOptionForTask(taskId);
   const adapter = useAdapterForTask(taskId);
 
-  if (!thoughtOption) {
+  if (!thoughtOption || thoughtOption.type !== "select") {
     return null;
   }
 

apps/code/src/renderer/features/sessions/components/UnifiedModelSelector.tsx

@@ -50,16 +50,19 @@ export function UnifiedModelSelector({
   const session = useSessionForTask(taskId);
   const modelOption = useModelConfigOptionForTask(taskId);
 
-  const options = modelOption ? flattenSelectOptions(modelOption.options) : [];
+  const selectOption = modelOption?.type === "select" ? modelOption : undefined;
+  const options = selectOption
+    ? flattenSelectOptions(selectOption.options)
+    : [];
   const groupedOptions = useMemo(() => {
-    if (!modelOption || modelOption.options.length === 0) return [];
-    if ("group" in modelOption.options[0]) {
-      return modelOption.options as SessionConfigSelectGroup[];
+    if (!selectOption || selectOption.options.length === 0) return [];
+    if ("group" in selectOption.options[0]) {
+      return selectOption.options as SessionConfigSelectGroup[];
     }
     return [];
-  }, [modelOption]);
+  }, [selectOption]);
 
-  const currentValue = modelOption?.currentValue;
+  const currentValue = selectOption?.currentValue;
   const currentLabel =
     options.find((opt) => opt.value === currentValue)?.name ?? currentValue;
 

apps/code/src/renderer/features/sessions/service/service.ts

@@ -355,10 +355,9 @@ export class SessionService {
     this.subscribeToChannel(taskRunId);
 
     try {
-      const persistedMode = getConfigOptionByCategory(
-        persistedConfigOptions,
-        "mode",
-      )?.currentValue;
+      const modeOpt = getConfigOptionByCategory(persistedConfigOptions, "mode");
+      const persistedMode =
+        modeOpt?.type === "select" ? modeOpt.currentValue : undefined;
 
       trpcClient.workspace.verify
         .query({ taskId })
@@ -429,7 +428,7 @@ export class SessionService {
                 .mutate({
                   sessionId: taskRunId,
                   configId: opt.id,
-                  value: opt.currentValue,
+                  value: String(opt.currentValue),
                 })
                 .catch((error) => {
                   log.warn(
@@ -1636,7 +1635,9 @@ export class SessionService {
 
     // Optimistic update
     const updatedOptions = configOptions.map((opt) =>
-      opt.id === configId ? { ...opt, currentValue: value } : opt,
+      opt.id === configId
+        ? ({ ...opt, currentValue: value } as SessionConfigOption)
+        : opt,
     );
     sessionStoreSetters.updateSession(session.taskRunId, {
       configOptions: updatedOptions,
@@ -1652,15 +1653,17 @@ export class SessionService {
     } catch (error) {
       // Rollback on error
       const rolledBackOptions = configOptions.map((opt) =>
-        opt.id === configId ? { ...opt, currentValue: previousValue } : opt,
+        opt.id === configId
+          ? ({ ...opt, currentValue: previousValue } as SessionConfigOption)
+          : opt,
       );
       sessionStoreSetters.updateSession(session.taskRunId, {
         configOptions: rolledBackOptions,
       });
       updatePersistedConfigOptionValue(
         session.taskRunId,
         configId,
-        previousValue,
+        String(previousValue),
       );
       log.error("Failed to set session config option", {
         taskId,
@@ -1697,7 +1700,7 @@ export class SessionService {
       track(ANALYTICS_EVENTS.SESSION_CONFIG_CHANGED, {
         task_id: taskId,
         category,
-        from_value: configOption.currentValue,
+        from_value: String(configOption.currentValue),
         to_value: value,
       });
     }

apps/code/src/renderer/features/sessions/stores/sessionConfigStore.ts

@@ -49,7 +49,9 @@ export const useSessionConfigStore = create<SessionConfigStore>()(
           if (!existing) return state;
 
           const updated = existing.map((opt) =>
-            opt.id === configId ? { ...opt, currentValue: value } : opt,
+            opt.id === configId
+              ? ({ ...opt, currentValue: value } as SessionConfigOption)
+              : opt,
           );
 
           return {