harness-mix 0.1.0

package/src/native-ui/renderer-extension/src/agent-selection-state.ts

@@ -0,0 +1,610 @@
+import type {
+  HarnessModelRef,
+  HarnessPermissionModeId,
+  HarnessThinkingOptionId,
+} from "@codexhost/shared-contracts";
+
+export const KNOWN_RENDERER_AGENTS = [
+  "codex",
+  "pi",
+  "claude-code",
+  "deepseek-harness",
+  "opencode",
+  "grok",
+  "omp",
+  "antigravity",
+  "kiro-cli",
+  "openclaw",
+  "hermes",
+  "qoder",
+  "workbuddy",
+  "zcode",
+  "trae",
+  "codex-harness",
+] as const;
+export const DEFAULT_RENDERER_AGENTS = [
+  'codex',
+  'pi',
+  'omp',
+  'claude-code',
+  'deepseek-harness',
+  'antigravity',
+  'opencode',
+  'grok',
+  'openclaw',
+  'hermes',
+  'qoder',
+  'workbuddy',
+  'zcode',
+  'trae',
+  'codex-harness',
+] as const;
+export type RendererAgent = (typeof KNOWN_RENDERER_AGENTS)[number];
+export type ExternalRendererAgent = Exclude<RendererAgent, "codex">;
+export type RendererAgentAvailability =
+  "checking" | "ready" | "notInstalled" | "unavailable" | "error";
+export type ComposerAgentPhase = "draft" | "locked";
+
+export interface DraftComposerState {
+  agent: RendererAgent;
+  phase: ComposerAgentPhase;
+  composerId: string;
+  codexAccountId?: string;
+  piModel?: HarnessModelRef;
+  piThinkingOptionId?: HarnessThinkingOptionId;
+  claudeModel?: HarnessModelRef;
+  claudeThinkingOptionId?: HarnessThinkingOptionId;
+  deepSeekHarnessModel?: HarnessModelRef;
+  openCodeModel?: HarnessModelRef;
+  openCodeThinkingOptionId?: HarnessThinkingOptionId;
+  grokModel?: HarnessModelRef;
+  grokThinkingOptionId?: HarnessThinkingOptionId;
+  ompModel?: HarnessModelRef;
+  ompThinkingOptionId?: HarnessThinkingOptionId;
+  antigravityModel?: HarnessModelRef;
+  antigravityThinkingOptionId?: HarnessThinkingOptionId;
+  kiroCliModel?: HarnessModelRef;
+  kiroCliThinkingOptionId?: HarnessThinkingOptionId;
+  openclawModel?: HarnessModelRef;
+  openclawThinkingOptionId?: HarnessThinkingOptionId;
+  hermesModel?: HarnessModelRef;
+  hermesThinkingOptionId?: HarnessThinkingOptionId;
+  qoderModel?: HarnessModelRef;
+  qoderThinkingOptionId?: HarnessThinkingOptionId;
+  workbuddyModel?: HarnessModelRef;
+  workbuddyThinkingOptionId?: HarnessThinkingOptionId;
+  zcodeModel?: HarnessModelRef;
+  zcodeThinkingOptionId?: HarnessThinkingOptionId;
+  traeModel?: HarnessModelRef;
+  traeThinkingOptionId?: HarnessThinkingOptionId;
+  codexHarnessModel?: HarnessModelRef;
+  codexHarnessThinkingOptionId?: HarnessThinkingOptionId;
+  permissionModeByAgent?: Partial<Record<ExternalRendererAgent, HarnessPermissionModeId>>;
+}
+
+type MutableComposerState = DraftComposerState;
+
+interface ConversationState {
+  target: readonly unknown[];
+  state: MutableComposerState;
+}
+
+export interface DraftAgentControllerOptions {
+  idFactory?: (sequence: number) => string;
+  enabledAgents?: readonly RendererAgent[];
+  defaultAgent?: RendererAgent;
+}
+
+export interface DraftAgentSwitchOperations {
+  applyAgent(agent: RendererAgent): boolean;
+  clearPrewarm(): Promise<void>;
+}
+
+function defaultIdFactory(sequence: number): string {
+  return `codexhost-composer-${Date.now().toString(36)}-${sequence.toString(36)}`;
+}
+
+function isDefaultTarget(target: readonly unknown[] | null): target is readonly unknown[] {
+  return target?.[0] === "default";
+}
+
+function isConversationTarget(target: readonly unknown[] | null): target is readonly unknown[] {
+  return target?.[0] === "conversation";
+}
+
+function sameTarget(left: readonly unknown[], right: readonly unknown[]): boolean {
+  return left.length === right.length && left.every((value, index) => value === right[index]);
+}
+
+export class DraftAgentController<Composer extends object> {
+  readonly #idFactory: (sequence: number) => string;
+  readonly #defaultAgent: RendererAgent;
+  readonly #enabledAgents: ReadonlySet<RendererAgent>;
+  readonly #conversationStates: ConversationState[] = [];
+  readonly #modelRequestGenerations = new WeakMap<MutableComposerState, number>();
+  readonly #ownershipRequestGenerations = new WeakMap<MutableComposerState, number>();
+  readonly #states = new WeakMap<Composer, MutableComposerState>();
+  readonly #switching = new Set<MutableComposerState>();
+  readonly #pendingSubmissions = new Set<MutableComposerState>();
+  #composerSequence = 0;
+  #modelRequestSequence = 0;
+  #ownershipRequestSequence = 0;
+  #lastSubmittedAgent: RendererAgent;
+
+  constructor(options: DraftAgentControllerOptions = {}) {
+    this.#idFactory = options.idFactory ?? defaultIdFactory;
+    this.#enabledAgents = new Set(options.enabledAgents ?? DEFAULT_RENDERER_AGENTS);
+    if (!this.#enabledAgents.has("codex")) {
+      throw new Error("Renderer enabled Agents must include Codex");
+    }
+    this.#defaultAgent = options.defaultAgent ?? "codex";
+    if (!this.#enabledAgents.has(this.#defaultAgent)) {
+      throw new Error("Renderer default Agent must be enabled");
+    }
+    this.#lastSubmittedAgent = this.#defaultAgent;
+  }
+
+  get(composer: Composer): Readonly<DraftComposerState> {
+    return this.#state(composer);
+  }
+
+  mount(
+    composer: Composer,
+    target: readonly unknown[] | null,
+    preferredNewThreadAgent?: RendererAgent,
+  ): Readonly<DraftComposerState> {
+    const bound = this.#conversationState(target);
+    if (bound) {
+      this.#states.set(composer, bound);
+      return bound;
+    }
+    const preferredAgent =
+      preferredNewThreadAgent && this.#enabledAgents.has(preferredNewThreadAgent)
+        ? preferredNewThreadAgent
+        : this.#lastSubmittedAgent;
+    const state = this.#state(composer, isDefaultTarget(target) ? preferredAgent : "codex");
+    if (isConversationTarget(target)) {
+      this.#conversationStates.push({ target, state });
+    }
+    return state;
+  }
+
+  isSwitching(composer: Composer): boolean {
+    return this.#switching.has(this.#state(composer));
+  }
+
+  beginModelRequest(composer: Composer): number {
+    const state = this.#state(composer);
+    const generation = ++this.#modelRequestSequence;
+    this.#modelRequestGenerations.set(state, generation);
+    return generation;
+  }
+
+  invalidateModelRequests(composer: Composer): void {
+    this.beginModelRequest(composer);
+  }
+
+  isCurrentModelRequest(composer: Composer, generation: number): boolean {
+    return (this.#modelRequestGenerations.get(this.#state(composer)) ?? 0) === generation;
+  }
+
+  beginOwnershipRequest(composer: Composer): number {
+    const state = this.#state(composer);
+    const generation = ++this.#ownershipRequestSequence;
+    this.#ownershipRequestGenerations.set(state, generation);
+    return generation;
+  }
+
+  isCurrentOwnershipRequest(composer: Composer, generation: number): boolean {
+    return (this.#ownershipRequestGenerations.get(this.#state(composer)) ?? 0) === generation;
+  }
+
+  rebindConversation(
+    composer: Composer,
+    target: readonly unknown[] | null,
+  ): Readonly<DraftComposerState> | null {
+    if (!isConversationTarget(target)) return null;
+    const previous = this.#state(composer);
+    this.#pendingSubmissions.delete(previous);
+    this.#modelRequestGenerations.set(previous, ++this.#modelRequestSequence);
+    this.#ownershipRequestGenerations.set(previous, ++this.#ownershipRequestSequence);
+
+    let state = this.#conversationState(target);
+    if (!state) {
+      state = {
+        agent: "codex",
+        phase: "draft",
+        composerId: this.#idFactory(++this.#composerSequence),
+      };
+      this.#conversationStates.push({ target, state });
+    }
+    this.#states.set(composer, state);
+    this.#modelRequestGenerations.set(state, ++this.#modelRequestSequence);
+    this.#ownershipRequestGenerations.set(state, ++this.#ownershipRequestSequence);
+    return state;
+  }
+
+  restore(
+    composer: Composer,
+    agent: RendererAgent,
+    model?: HarnessModelRef,
+    thinkingOptionId?: HarnessThinkingOptionId,
+    permissionModeId?: HarnessPermissionModeId,
+    codexAccountId?: string,
+  ): Readonly<DraftComposerState> | null {
+    if (!this.#enabledAgents.has(agent)) return null;
+    const state = this.#state(composer);
+    this.#pendingSubmissions.delete(state);
+    state.agent = agent;
+    state.phase = "locked";
+    if (agent === "codex" && codexAccountId) state.codexAccountId = codexAccountId;
+    else delete state.codexAccountId;
+    if (agent === "pi" && model) state.piModel = model;
+    if (agent === "claude-code" && model) state.claudeModel = model;
+    if (agent === "deepseek-harness" && model) state.deepSeekHarnessModel = model;
+    if (agent === "opencode" && model) state.openCodeModel = model;
+    if (agent === "grok" && model) state.grokModel = model;
+    if (agent === "omp" && model) state.ompModel = model;
+    if (agent === "antigravity" && model) state.antigravityModel = model;
+    if (agent === "kiro-cli" && model) state.kiroCliModel = model;
+    if (agent === "openclaw" && model) state.openclawModel = model;
+    if (agent === "hermes" && model) state.hermesModel = model;
+    if (agent === "qoder" && model) state.qoderModel = model;
+    if (agent === "workbuddy" && model) state.workbuddyModel = model;
+    if (agent === "zcode" && model) state.zcodeModel = model;
+    if (agent === "trae" && model) state.traeModel = model;
+    if (agent === "codex-harness" && model) state.codexHarnessModel = model;
+    if (agent === "pi" && thinkingOptionId) state.piThinkingOptionId = thinkingOptionId;
+    else if (agent === "pi") delete state.piThinkingOptionId;
+    if (agent === "claude-code" && thinkingOptionId) {
+      state.claudeThinkingOptionId = thinkingOptionId;
+    } else if (agent === "claude-code") delete state.claudeThinkingOptionId;
+    if (agent === "grok" && thinkingOptionId) state.grokThinkingOptionId = thinkingOptionId;
+    else if (agent === "grok") delete state.grokThinkingOptionId;
+    if (agent === "opencode" && thinkingOptionId) {
+      state.openCodeThinkingOptionId = thinkingOptionId;
+    } else if (agent === "opencode") delete state.openCodeThinkingOptionId;
+    if (agent === "omp" && thinkingOptionId) state.ompThinkingOptionId = thinkingOptionId;
+    else if (agent === "omp") delete state.ompThinkingOptionId;
+    if (agent === "antigravity" && thinkingOptionId) {
+      state.antigravityThinkingOptionId = thinkingOptionId;
+    } else if (agent === "antigravity") delete state.antigravityThinkingOptionId;
+    if (agent === "kiro-cli" && thinkingOptionId) {
+      state.kiroCliThinkingOptionId = thinkingOptionId;
+    } else if (agent === "kiro-cli") delete state.kiroCliThinkingOptionId;
+    if (agent === "openclaw" && thinkingOptionId) {
+      state.openclawThinkingOptionId = thinkingOptionId;
+    } else if (agent === "openclaw") delete state.openclawThinkingOptionId;
+    if (agent === "hermes" && thinkingOptionId) {
+      state.hermesThinkingOptionId = thinkingOptionId;
+    } else if (agent === "hermes") delete state.hermesThinkingOptionId;
+    if (agent === "qoder" && thinkingOptionId) {
+      state.qoderThinkingOptionId = thinkingOptionId;
+    } else if (agent === "qoder") delete state.qoderThinkingOptionId;
+    if (agent === "workbuddy" && thinkingOptionId) {
+      state.workbuddyThinkingOptionId = thinkingOptionId;
+    } else if (agent === "workbuddy") delete state.workbuddyThinkingOptionId;
+    if (agent === "zcode" && thinkingOptionId) {
+      state.zcodeThinkingOptionId = thinkingOptionId;
+    } else if (agent === "zcode") delete state.zcodeThinkingOptionId;
+    if (agent === "trae" && thinkingOptionId) {
+      state.traeThinkingOptionId = thinkingOptionId;
+    } else if (agent === "trae") delete state.traeThinkingOptionId;
+    if (agent === 'codex-harness' && thinkingOptionId) state.codexHarnessThinkingOptionId = thinkingOptionId;
+    else if (agent === 'codex-harness') delete state.codexHarnessThinkingOptionId;
+    if (agent !== "codex") {
+      const permissionModeByAgent: NonNullable<DraftComposerState["permissionModeByAgent"]> = {};
+      for (const candidate of [
+        "pi",
+        "claude-code",
+        "deepseek-harness",
+        "opencode",
+        "grok",
+        "omp",
+        "antigravity",
+        "kiro-cli",
+        "openclaw",
+        "hermes",
+        "qoder",
+        "workbuddy",
+        "zcode",
+        "trae",
+        "codex-harness",
+      ] as const) {
+        const current = state.permissionModeByAgent?.[candidate];
+        if (candidate !== agent && current) permissionModeByAgent[candidate] = current;
+      }
+      if (permissionModeId) permissionModeByAgent[agent] = permissionModeId;
+      if (Object.keys(permissionModeByAgent).length > 0) {
+        state.permissionModeByAgent = permissionModeByAgent;
+      } else {
+        delete state.permissionModeByAgent;
+      }
+    }
+    return state;
+  }
+
+  modelForAgent(composer: Composer, agent: RendererAgent): HarnessModelRef | undefined {
+    const state = this.#state(composer);
+    if (agent === "pi") return state.piModel;
+    if (agent === "claude-code") return state.claudeModel;
+    if (agent === "deepseek-harness") return state.deepSeekHarnessModel;
+    if (agent === "opencode") return state.openCodeModel;
+    if (agent === "grok") return state.grokModel;
+    if (agent === "omp") return state.ompModel;
+    if (agent === "antigravity") return state.antigravityModel;
+    if (agent === "kiro-cli") return state.kiroCliModel;
+    if (agent === "openclaw") return state.openclawModel;
+    if (agent === "hermes") return state.hermesModel;
+    if (agent === "qoder") return state.qoderModel;
+    if (agent === "workbuddy") return state.workbuddyModel;
+    if (agent === "zcode") return state.zcodeModel;
+    if (agent === "trae") return state.traeModel;
+    if (agent === 'codex-harness') return state.codexHarnessModel;
+    return undefined;
+  }
+
+  thinkingOptionForAgent(
+    composer: Composer,
+    agent: ExternalRendererAgent,
+  ): HarnessThinkingOptionId | undefined {
+    const state = this.#state(composer);
+    if (agent === "pi") return state.piThinkingOptionId;
+    if (agent === "claude-code") return state.claudeThinkingOptionId;
+    if (agent === "grok") return state.grokThinkingOptionId;
+    if (agent === "opencode") return state.openCodeThinkingOptionId;
+    if (agent === "omp") return state.ompThinkingOptionId;
+    if (agent === "antigravity") return state.antigravityThinkingOptionId;
+    if (agent === "kiro-cli") return state.kiroCliThinkingOptionId;
+    if (agent === "openclaw") return state.openclawThinkingOptionId;
+    if (agent === "hermes") return state.hermesThinkingOptionId;
+    if (agent === "qoder") return state.qoderThinkingOptionId;
+    if (agent === "workbuddy") return state.workbuddyThinkingOptionId;
+    if (agent === "zcode") return state.zcodeThinkingOptionId;
+    if (agent === "trae") return state.traeThinkingOptionId;
+    if (agent === 'codex-harness') return state.codexHarnessThinkingOptionId;
+    return undefined;
+  }
+
+  permissionModeForAgent(
+    composer: Composer,
+    agent: ExternalRendererAgent,
+  ): HarnessPermissionModeId | undefined {
+    return this.#state(composer).permissionModeByAgent?.[agent];
+  }
+
+  setExternalPermissionMode(
+    composer: Composer,
+    agent: ExternalRendererAgent,
+    permissionModeId: HarnessPermissionModeId,
+  ): Readonly<DraftComposerState> {
+    const state = this.#state(composer);
+    state.permissionModeByAgent = {
+      ...state.permissionModeByAgent,
+      [agent]: permissionModeId,
+    };
+    return state;
+  }
+
+  setExternalModel(
+    composer: Composer,
+    agent: ExternalRendererAgent,
+    model: HarnessModelRef,
+  ): Readonly<DraftComposerState> {
+    const state = this.#state(composer);
+    if (agent === "pi") state.piModel = model;
+    else if (agent === "claude-code") state.claudeModel = model;
+    else if (agent === "deepseek-harness") state.deepSeekHarnessModel = model;
+    else if (agent === "opencode") state.openCodeModel = model;
+    else if (agent === "grok") state.grokModel = model;
+    else if (agent === "omp") state.ompModel = model;
+    else if (agent === "antigravity") state.antigravityModel = model;
+    else if (agent === "kiro-cli") state.kiroCliModel = model;
+    else if (agent === "openclaw") state.openclawModel = model;
+    else if (agent === "hermes") state.hermesModel = model;
+    else if (agent === "qoder") state.qoderModel = model;
+    else if (agent === "workbuddy") state.workbuddyModel = model;
+    else if (agent === "zcode") state.zcodeModel = model;
+    else if (agent === "trae") state.traeModel = model;
+    else if (agent === 'codex-harness') state.codexHarnessModel = model;
+    return state;
+  }
+
+  setPiConfiguration(
+    composer: Composer,
+    model: HarnessModelRef,
+    thinkingOptionId?: HarnessThinkingOptionId,
+  ): Readonly<DraftComposerState> {
+    const state = this.#state(composer);
+    state.piModel = model;
+    if (thinkingOptionId) state.piThinkingOptionId = thinkingOptionId;
+    else delete state.piThinkingOptionId;
+    return state;
+  }
+
+  setPiModel(composer: Composer, model: HarnessModelRef): Readonly<DraftComposerState> {
+    return this.setExternalModel(composer, "pi", model);
+  }
+
+  setExternalThinkingOption(
+    composer: Composer,
+    agent: ExternalRendererAgent,
+    thinkingOptionId?: HarnessThinkingOptionId,
+  ): Readonly<DraftComposerState> {
+    const state = this.#state(composer);
+    if (agent === "pi" && thinkingOptionId) state.piThinkingOptionId = thinkingOptionId;
+    else if (agent === "pi") delete state.piThinkingOptionId;
+    else if (agent === "claude-code" && thinkingOptionId) {
+      state.claudeThinkingOptionId = thinkingOptionId;
+    } else if (agent === "claude-code") {
+      delete state.claudeThinkingOptionId;
+    } else if (agent === "grok" && thinkingOptionId) {
+      state.grokThinkingOptionId = thinkingOptionId;
+    } else if (agent === "grok") {
+      delete state.grokThinkingOptionId;
+    } else if (agent === "opencode" && thinkingOptionId) {
+      state.openCodeThinkingOptionId = thinkingOptionId;
+    } else if (agent === "opencode") {
+      delete state.openCodeThinkingOptionId;
+    } else if (agent === "omp" && thinkingOptionId) {
+      state.ompThinkingOptionId = thinkingOptionId;
+    } else if (agent === "omp") {
+      delete state.ompThinkingOptionId;
+    } else if (agent === "antigravity" && thinkingOptionId) {
+      state.antigravityThinkingOptionId = thinkingOptionId;
+    } else if (agent === "antigravity") {
+      delete state.antigravityThinkingOptionId;
+    } else if (agent === "kiro-cli" && thinkingOptionId) {
+      state.kiroCliThinkingOptionId = thinkingOptionId;
+    } else if (agent === "kiro-cli") {
+      delete state.kiroCliThinkingOptionId;
+    } else if (agent === "openclaw" && thinkingOptionId) {
+      state.openclawThinkingOptionId = thinkingOptionId;
+    } else if (agent === "openclaw") {
+      delete state.openclawThinkingOptionId;
+    } else if (agent === "hermes" && thinkingOptionId) {
+      state.hermesThinkingOptionId = thinkingOptionId;
+    } else if (agent === "hermes") {
+      delete state.hermesThinkingOptionId;
+    } else if (agent === "qoder" && thinkingOptionId) {
+      state.qoderThinkingOptionId = thinkingOptionId;
+    } else if (agent === "qoder") {
+      delete state.qoderThinkingOptionId;
+    } else if (agent === "workbuddy" && thinkingOptionId) {
+      state.workbuddyThinkingOptionId = thinkingOptionId;
+    } else if (agent === "workbuddy") {
+      delete state.workbuddyThinkingOptionId;
+    } else if (agent === "zcode" && thinkingOptionId) {
+      state.zcodeThinkingOptionId = thinkingOptionId;
+    } else if (agent === "zcode") {
+      delete state.zcodeThinkingOptionId;
+    } else if (agent === "trae" && thinkingOptionId) {
+      state.traeThinkingOptionId = thinkingOptionId;
+    } else if (agent === "trae") {
+      delete state.traeThinkingOptionId;
+    } else if (agent === 'codex-harness' && thinkingOptionId) {
+      state.codexHarnessThinkingOptionId = thinkingOptionId;
+    } else if (agent === 'codex-harness') {
+      delete state.codexHarnessThinkingOptionId;
+    }
+    return state;
+  }
+
+  setPiThinkingOption(
+    composer: Composer,
+    thinkingOptionId: HarnessThinkingOptionId,
+  ): Readonly<DraftComposerState> {
+    return this.setExternalThinkingOption(composer, "pi", thinkingOptionId);
+  }
+
+  lock(composer: Composer): Readonly<DraftComposerState> {
+    const state = this.#state(composer);
+    this.#pendingSubmissions.delete(state);
+    state.phase = "locked";
+    return state;
+  }
+
+  markSubmissionPending(composer: Composer): Readonly<DraftComposerState> {
+    const state = this.#state(composer);
+    if (state.phase === "draft") this.#pendingSubmissions.add(state);
+    return state;
+  }
+
+  isSubmissionPending(composer: Composer): boolean {
+    return this.#pendingSubmissions.has(this.#state(composer));
+  }
+
+  clearPendingSubmission(composer: Composer): void {
+    const state = this.#state(composer);
+    this.#pendingSubmissions.delete(state);
+    if (state.phase === "draft") delete state.codexAccountId;
+  }
+
+  recordSubmission(composer: Composer, codexAccountId?: string): Readonly<DraftComposerState> {
+    const state = this.#state(composer);
+    if (
+      state.agent === "codex" &&
+      state.phase === "draft" &&
+      !state.codexAccountId &&
+      codexAccountId
+    ) {
+      state.codexAccountId = codexAccountId;
+    }
+    this.#lastSubmittedAgent = state.agent;
+    return state;
+  }
+
+  transfer(
+    source: Composer,
+    replacement: Composer,
+    target: readonly unknown[] | null = null,
+  ): boolean {
+    const state = this.#states.get(source);
+    if (!state) return false;
+    const bound = this.#conversationState(target);
+    if (bound && bound !== state) return false;
+    if (source !== replacement) {
+      if (this.#states.has(replacement)) return false;
+      this.#states.set(replacement, state);
+    }
+    if (isConversationTarget(target) && !bound) {
+      this.#conversationStates.push({ target, state });
+    }
+    if (isConversationTarget(target) && this.#pendingSubmissions.delete(state)) {
+      state.phase = "locked";
+    }
+    return true;
+  }
+
+  async switchAgent(
+    composer: Composer,
+    nextAgent: RendererAgent,
+    operations: DraftAgentSwitchOperations,
+  ): Promise<boolean> {
+    const state = this.#state(composer);
+    if (!this.#enabledAgents.has(nextAgent)) return false;
+    if (state.phase !== "draft" || this.#switching.has(state)) return false;
+    if (state.agent === nextAgent) return true;
+
+    this.#pendingSubmissions.delete(state);
+
+    this.#switching.add(state);
+    try {
+      if (!operations.applyAgent(nextAgent)) return false;
+      try {
+        await operations.clearPrewarm();
+      } catch (error) {
+        if (!operations.applyAgent(state.agent)) {
+          throw new Error("Draft Agent switch could not restore the prior Agent", {
+            cause: error,
+          });
+        }
+        return false;
+      }
+      state.agent = nextAgent;
+      return true;
+    } finally {
+      this.#switching.delete(state);
+    }
+  }
+
+  #conversationState(target: readonly unknown[] | null): MutableComposerState | null {
+    if (!isConversationTarget(target)) return null;
+    return (
+      this.#conversationStates.find((candidate) => sameTarget(candidate.target, target))?.state ??
+      null
+    );
+  }
+
+  #state(composer: Composer, initialAgent?: RendererAgent): MutableComposerState {
+    const existing = this.#states.get(composer);
+    if (existing) return existing;
+    const created: MutableComposerState = {
+      agent: initialAgent ?? this.#defaultAgent,
+      phase: "draft",
+      composerId: this.#idFactory(++this.#composerSequence),
+    };
+    this.#states.set(composer, created);
+    return created;
+  }
+}

package/src/native-ui/renderer-extension/src/assets/README.md

@@ -0,0 +1,43 @@
+# Renderer brand assets
+
+`codexhost-logo.png` is the 3:4 codexhost product logo used by the installer and
+application branding. `codexhost-icon.png` is its square crop used for the
+in-product brand mark.
+
+`codexhost-logo-transparent.png` is the white-background-free square logo
+extracted from `codexhost-logo.png`. `codex-logo.png` is the Codex X mark
+source and `codex-logo-transparent.png` is its white-background-free square
+variant. `codex-logo-bright.png` recolors that mark in the official bright
+Codex blue so it stays visible on dark surfaces and is the Renderer settings
+brand icon (settings header mark and the application-header settings trigger
+button).
+
+`codex-agent.png` is the Codex App GA mark distributed with OpenAI's official
+`openai.chatgpt` VS Code extension. It is bundled as a data URL so the Renderer
+does not depend on a local extension path or a network request.
+
+`omp-agent.svg` is the official OMP favicon mark from the Oh My Pi repository
+(`packages/collab-web/public/favicon.svg`). `opencode-agent.png` is OpenCode's
+square mark with its dark outer plate. Both are bundled locally so the Renderer
+does not depend on a network request.
+
+`kiro-agent.svg` is the unmodified official Kiro icon from
+`https://kiro.dev/icon.svg`, bundled locally as a data URL.
+
+The Agent picker uses the official Pi mark from `https://pi.dev/logo-auto.svg`
+and the Claude mark distributed in Anthropic's official `anthropic.claude-code`
+VS Code extension as inline vector paths. The DeepSeek Harness whale mark is
+the exact extract from the official `deepseek-harness` web favicon
+(`packages/client/ui-primitives/src/FishLogo.tsx` in that repo), rendered
+inline in the DeepSeek brand blue `#4D6BFE`. `grok-agent.png` is a cropped and
+resized copy of the Grok mark served by `grok.com`, provided from a captured
+first-party page asset so the Renderer does not make a network request. The
+square source is stored with transparent rounded corners so the black plate
+does not render as a hard square.
+
+`codexhost-readme.svg` embeds `codex-agent.png`, `claude-agent.svg`, and
+`pi-agent.svg` in a responsive vector composition. Its background is `#F2EDE7`.
+The README references this SVG through HTML because GitHub strips inline CSS
+background and border-radius declarations from Markdown HTML.
+
+These product names and marks remain trademarks of their respective owners.

package/src/native-ui/renderer-extension/src/assets/antigravity-agent.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="-2 -1 28 28"><path d="M21.751 22.607c1.34 1.005 3.35.335 1.508-1.508C17.73 15.74 18.904 1 12.037 1 5.17 1 6.342 15.74.815 21.1c-2.01 2.009.167 2.511 1.507 1.506 5.192-3.517 4.857-9.714 9.715-9.714 4.857 0 4.522 6.197 9.714 9.715z" fill="url(#ag)"/><defs><linearGradient id="ag" x1="2" y1="12" x2="22" y2="12" gradientUnits="userSpaceOnUse"><stop stop-color="#4285F4"/><stop offset=".33" stop-color="#EA4335"/><stop offset=".66" stop-color="#FBBC04"/><stop offset="1" stop-color="#34A853"/></linearGradient></defs></svg>

package/src/native-ui/renderer-extension/src/assets/claude-agent.svg

@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" role="img" aria-label="Claude Code">
+  <path fill="#D97757" fill-rule="nonzero" d="M4.709 15.955l4.72-2.647.08-.23-.08-.128H9.2l-.79-.048-2.698-.073-2.339-.097-2.266-.122-.571-.121L0 11.784l.055-.352.48-.321.686.06 1.52.103 2.278.158 1.652.097 2.449.255h.389l.055-.157-.134-.098-.103-.097-2.358-1.596-2.552-1.688-1.336-.972-.724-.491-.364-.462-.158-1.008.656-.722.881.06.225.061.893.686 1.908 1.476 2.491 1.833.365.304.145-.103.019-.073-.164-.274-1.355-2.446-1.446-2.49-.644-1.032-.17-.619a2.97 2.97 0 01-.104-.729L6.283.134 6.696 0l.996.134.42.364.62 1.414 1.002 2.229 1.555 3.03.456.898.243.832.091.255h.158V9.01l.128-1.706.237-2.095.23-2.695.08-.76.376-.91.747-.492.584.28.48.685-.067.444-.286 1.851-.559 2.903-.364 1.942h.212l.243-.242.985-1.306 1.652-2.064.73-.82.85-.904.547-.431h1.033l.76 1.129-.34 1.166-1.064 1.347-.881 1.142-1.264 1.7-.79 1.36.073.11.188-.02 2.856-.606 1.543-.28 1.841-.315.833.388.091.395-.328.807-1.969.486-2.309.462-3.439.813-.042.03.049.061 1.549.146.662.036h1.622l3.02.225.79.522.474.638-.079.485-1.215.62-1.64-.389-3.829-.91-1.312-.329h-.182v.11l1.093 1.068 2.006 1.81 2.509 2.33.127.578-.322.455-.34-.049-2.205-1.657-.851-.747-1.926-1.62h-.128v.17l.444.649 2.345 3.521.122 1.08-.17.353-.608.213-.668-.122-1.374-1.925-1.415-2.167-1.143-1.943-.14.08-.674 7.254-.316.37-.729.28-.607-.461-.322-.747.322-1.476.389-1.924.315-1.53.286-1.9.17-.632-.012-.042-.14.018-1.434 1.967-2.18 2.945-1.726 1.845-.414.164-.717-.37.067-.662.401-.589 2.388-3.036 1.44-1.882.93-1.086-.006-.158h-.055L4.132 18.56l-1.13.146-.487-.456.061-.746.231-.243 1.908-1.312-.006.006z"/>
+</svg>