@hassangameryt/freeflow 0.7.1 → 0.7.3

package/pi-extension/src/settings/settings-ui.ts

@@ -19,14 +19,15 @@ import {
   type SettingsWizard,
   type SettingsWizardStep,
 } from "./settings-tui.js";
-import { supportsPiSessionModelStateApi } from "../cognitive-routing/pi-session-control.js";
 import { isPiFlowHost } from "../runtime/runtime-identity.js";
 import type {
   CognitiveRoutingCapabilityState,
+  CognitiveRoutingDelegationMode,
   CognitiveRoutingProfile,
   CognitiveRoutingProfileName,
   CognitiveRoutingThinkingLevel,
-} from "../cognitive-routing/types.js";
+} from "../cognitive-routing-v2/config.js";
+import { isWorkerProfile, workersForDelegation } from "../cognitive-routing-v2/types.js";
 
 const DEFAULT_FREEFLOW_ENABLED = true;
 const DEFAULT_CONTEXT_VIRTUALIZATION_ENABLED = false;
@@ -68,10 +69,26 @@ type SettingsItem = {
   transient?: boolean;
 };
 
+type SessionRoutingPair = {
+  provider: string;
+  modelId: string;
+  thinking: CognitiveRoutingThinkingLevel;
+};
+
 type CognitiveRoutingSettingsController = {
   state(): { effective: boolean; controlMode: string; activeProfile?: string };
-  setManualProfile(profile: "standard" | "reasoning", mechanism?: string): Promise<{ status: string; reason?: string }>;
+  sessionProfileOverrides(): Partial<Record<CognitiveRoutingProfileName, SessionRoutingPair>>;
+  setManualProfile(
+    profile: CognitiveRoutingProfileName,
+    mechanism?: string,
+  ): Promise<{ status: string; reason?: string }>;
   setAutomaticControl(mechanism?: string): Promise<{ status: string; reason?: string }>;
+  setSessionProfileOverride(
+    profile: CognitiveRoutingProfileName,
+    override: SessionRoutingPair | null,
+    mechanism?: string,
+  ): Promise<{ status: string; reason?: string }>;
+  resetSessionProfileOverrides(mechanism?: string): Promise<{ status: string; reason?: string }>;
 };
 
 type AfterChangeOptions = {
@@ -184,7 +201,7 @@ function effectiveItemValue(item: SettingsItem): SettingsValue | undefined {
 function formatCoreValue(value: unknown): string {
   if (typeof value === "boolean") return booleanValue(value);
   if (isRecord(value) && typeof value.provider === "string" && typeof value.model === "string") {
-    const effort = typeof value.thinkingLevel === "string" ? ` · ${value.thinkingLevel}` : "";
+    const effort = typeof value.thinking === "string" ? ` · ${value.thinking}` : "";
     return `${value.provider}/${value.model}${effort}`;
   }
   return String(value ?? "");
@@ -291,6 +308,79 @@ function createScopedBooleanItem(options: ScopedBooleanItemOptions): SettingsIte
   return item;
 }
 
+function createScopedDelegationItem(options: {
+  scope: Exclude<ConfigScope, "session">;
+  rawConfig: Record<string, unknown>;
+  localConfig: Record<string, unknown>;
+  effectiveValue: CognitiveRoutingDelegationMode;
+  effectiveSource: ConfigSource;
+}): SettingsItem {
+  const path = ["cognitiveRouting", "delegation"];
+  const repositoryValue = getPath(options.rawConfig, path);
+  const inheritedValue: CognitiveRoutingDelegationMode = ["executor", "helper", "both"].includes(
+    repositoryValue as string,
+  )
+    ? (repositoryValue as CognitiveRoutingDelegationMode)
+    : "executor";
+  const inheritedSource: ConfigSource = repositoryValue === undefined ? "builtin" : "repository";
+  const localValue = getPath(options.localConfig, path);
+  const descriptions = {
+    executor: "Coordinator delegates assignments to Executor.",
+    helper: "Coordinator delegates supporting assignments to Helper and keeps production implementation.",
+    both: "Coordinator chooses Helper or Executor for each assignment.",
+  };
+  const item: SettingsItem =
+    options.scope === "local"
+      ? {
+          id: "freeflow.cognitiveRouting.delegation",
+          label: "Delegation method",
+          description:
+            "Choose enabled workers for automatic routing. Inherit uses the repository value; this setting does not rank model presets.",
+          path,
+          kind: "enum",
+          value: ["executor", "helper", "both"].includes(localValue as string) ? localValue : LOCAL_INHERIT,
+          values: [LOCAL_INHERIT, "executor", "helper", "both"],
+          valueLabels: {
+            inherit: "Inherit repository",
+            executor: "Executor only",
+            helper: "Helper only",
+            both: "Helper and Executor",
+          },
+          valueDescriptions: {
+            inherit: `Use ${inheritedValue} from ${inheritedSource}.`,
+            ...descriptions,
+          },
+          configScope: "local",
+          configValues: { inherit: undefined, executor: "executor", helper: "helper", both: "both" },
+          effectiveValue: options.effectiveValue,
+          effectiveSource: options.effectiveSource,
+          inheritedValue,
+          inheritedSource,
+        }
+      : {
+          id: "freeflow.cognitiveRouting.delegation",
+          label: "Delegation method",
+          description: "Choose enabled workers for automatic routing. This edits shared .freeflow/config.json.",
+          path,
+          kind: "enum",
+          value: inheritedValue,
+          values: ["executor", "helper", "both"],
+          valueLabels: {
+            executor: "Executor only",
+            helper: "Helper only",
+            both: "Helper and Executor",
+          },
+          valueDescriptions: descriptions,
+          defaultValue: "executor",
+          configScope: "repository",
+          effectiveValue: options.effectiveValue,
+          effectiveSource: options.effectiveSource,
+          localOverrideValue: ["executor", "helper", "both"].includes(localValue as string) ? localValue : undefined,
+        };
+  item.displaySuffix = coreDisplaySuffix(item);
+  return item;
+}
+
 function resolveSettingsCoreView(
   rawConfig: Record<string, unknown>,
   layers?: Awaited<ReturnType<typeof readFreeflowConfigLayers>>,
@@ -369,6 +459,7 @@ function createSessionBooleanItem(options: {
 function sessionFreeflowItems(
   state: Awaited<ReturnType<typeof readCapabilityState>>,
   cognitiveRoutingController?: CognitiveRoutingSettingsController,
+  ctx?: any,
 ): SettingsItem[] {
   const sessionOverrides = state.sessionOverrides as Record<string, boolean>;
   const configured = state.configuredCoreConfig;
@@ -422,48 +513,79 @@ function sessionFreeflowItems(
   conversationHistoryItem.inactive = freeflowInactive;
 
   const cognitiveRoutingState = cognitiveRoutingController?.state();
+  const delegation = state.cognitiveRouting?.delegation ?? "executor";
+  const heldProfile = cognitiveRoutingState?.controlMode.startsWith("manual-")
+    ? cognitiveRoutingState.activeProfile
+    : undefined;
+  const availableProfiles: CognitiveRoutingProfileName[] = ["coordinator", ...workersForDelegation(delegation)];
+  if (heldProfile === "coordinator" || isWorkerProfile(heldProfile)) availableProfiles.push(heldProfile);
+  const manualProfiles = [...new Set(availableProfiles)];
   const cognitiveRoutingProfile =
-    cognitiveRoutingState?.controlMode === "manual-standard"
-      ? "standard"
-      : cognitiveRoutingState?.controlMode === "manual-reasoning"
-        ? "reasoning"
-        : "auto";
+    heldProfile && manualProfiles.includes(heldProfile as CognitiveRoutingProfileName) ? heldProfile : "auto";
   const cognitiveRoutingItem: SettingsItem | undefined = state.cognitiveRouting
     ? {
         id: "freeflow.cognitiveRouting.profile",
         label: "Cognitive Routing",
-        description: "Hold a profile manually or release the hold for automatic model control.",
+        description: "Hold an enabled profile manually or release the hold for automatic model control.",
         kind: "enum",
         value: cognitiveRoutingProfile,
-        values: ["auto", "standard", "reasoning"],
-        valueLabels: {
-          auto: "automatic",
-          standard: "manual · standard",
-          reasoning: "manual · reasoning",
-        },
-        valueDescriptions: {
-          auto: "Release the manual hold without forcing a model transition.",
-          standard: "Hold the standard profile until /freeflow profile auto.",
-          reasoning: "Hold the reasoning profile until /freeflow profile auto.",
-        },
+        values: ["auto", ...manualProfiles],
+        valueLabels: Object.fromEntries([
+          ["auto", "automatic"],
+          ...manualProfiles.map((profile) => [profile, `manual · ${profile}`]),
+        ]),
+        valueDescriptions: Object.fromEntries([
+          ["auto", "Release the manual hold and return to Coordinator reconciliation."],
+          ...manualProfiles.map((profile) => [profile, `Hold the ${profile} profile until /freeflow profile auto.`]),
+        ]),
         inactive: freeflowInactive || !state.cognitiveRouting.effective || cognitiveRoutingController === undefined,
         runtimeInactive: state.cognitiveRouting.blockingReason?.code === "runtime_disabled",
         displaySuffix: cognitiveRoutingState?.effective ? cognitiveRoutingProfile : "unavailable",
       }
     : undefined;
 
+  const sessionProfiles = cognitiveRoutingController?.sessionProfileOverrides();
+  const profileItems =
+    state.cognitiveRouting && cognitiveRoutingController
+      ? manualProfiles.map((name) =>
+          cognitiveRoutingProfileItem({
+            name,
+            scope: "session",
+            rawConfig: {},
+            localConfig: {},
+            capabilityState: state.cognitiveRouting as CognitiveRoutingCapabilityState,
+            ctx,
+            sessionProfiles,
+          }),
+        )
+      : [];
+  const cognitiveRoutingPresets: SettingsItem | undefined = profileItems.length
+    ? {
+        id: "freeflow.cognitiveRouting.presets",
+        label: "Cognitive Routing presets",
+        description: "Temporarily choose complete model/effort pairs for profiles enabled in this Pi session.",
+        kind: "group",
+        value: profileItems.some((item) => item.value !== LOCAL_INHERIT && item.value !== undefined),
+        displaySuffix: `${profileItems.filter((item) => item.value !== LOCAL_INHERIT && item.value !== undefined).length}/${profileItems.length} session overrides`,
+        inactive: freeflowInactive || !state.cognitiveRouting?.effective || cognitiveRoutingController === undefined,
+        children: profileItems,
+      }
+    : undefined;
+
   return [
     freeflowItem,
     ...(cognitiveRoutingItem ? [cognitiveRoutingItem] : []),
+    ...(cognitiveRoutingPresets ? [cognitiveRoutingPresets] : []),
     {
       id: "freeflow.session.reset",
       label: "Reset session overrides",
-      description: "Clear Freeflow, Context Virtualization, and Conversation History overrides for this Pi session.",
+      description:
+        "Clear Freeflow, Context Virtualization, Conversation History, and routing profile overrides for this Pi session.",
       kind: "enum",
       value: "available",
       values: ["reset"],
       valueLabels: { reset: "Reset all session overrides" },
-      valueDescriptions: { reset: "Return every session setting to its configured value." },
+      valueDescriptions: { reset: "Return every session setting and routing preset to its configured value." },
       format: () => "available",
       transient: true,
     },
@@ -517,8 +639,8 @@ function isCognitiveRoutingProfile(value: unknown): value is CognitiveRoutingPro
     isRecord(value) &&
     typeof value.provider === "string" &&
     typeof value.model === "string" &&
-    typeof value.thinkingLevel === "string" &&
-    COGNITIVE_ROUTING_THINKING_LEVELS.includes(value.thinkingLevel as CognitiveRoutingThinkingLevel)
+    typeof value.thinking === "string" &&
+    COGNITIVE_ROUTING_THINKING_LEVELS.includes(value.thinking as CognitiveRoutingThinkingLevel)
   );
 }
 
@@ -572,6 +694,7 @@ function cognitiveRoutingProfileDisplay(value: unknown): string {
 }
 
 function cognitiveRoutingSettingsSource(source: unknown): ConfigSource {
+  if (source === "session") return "session";
   if (source === "repository") return "repository";
   if (source === "personal" || source === "local") return "local";
   return "builtin";
@@ -579,6 +702,7 @@ function cognitiveRoutingSettingsSource(source: unknown): ConfigSource {
 
 function cognitiveRoutingProfileDisplaySuffix(source: unknown, scope: ConfigScope): string | undefined {
   if (!source) return undefined;
+  if (source === "session") return "(session override)";
   if (source === "personal" && scope === "repository") return "(effective personal)";
   return `(${source})`;
 }
@@ -603,6 +727,11 @@ function createCognitiveRoutingProfileWizard(
   currentValue: unknown,
   models: CognitiveRoutingModelOption[],
   allowInherit: boolean,
+  inheritChoice: { label: string; description: string; summary: string } = {
+    label: "Inherit repository preset",
+    description: "Remove the personal override without changing the repository preset.",
+    summary: "inherit repository preset",
+  },
 ): SettingsWizard {
   const currentProfile = isCognitiveRoutingProfile(currentValue) ? currentValue : undefined;
   const currentModelKey = currentProfile
@@ -614,8 +743,8 @@ function createCognitiveRoutingProfileWizard(
           {
             key: LOCAL_INHERIT,
             value: LOCAL_INHERIT,
-            label: "Inherit repository preset",
-            description: "Remove the personal override without changing the repository preset.",
+            label: inheritChoice.label,
+            description: inheritChoice.description,
           },
         ]
       : []),
@@ -650,12 +779,11 @@ function createCognitiveRoutingProfileWizard(
       if (selectedValues.length === 1) {
         const selected = selectedValues[0];
         if (selected === LOCAL_INHERIT) {
-          return cognitiveRoutingConfirmStep("inherit repository preset");
+          return cognitiveRoutingConfirmStep(inheritChoice.summary);
         }
         const model = selected as CognitiveRoutingModelOption;
         if (!model?.key || model.thinkingLevels.length === 0) return undefined;
-        const currentEffort =
-          currentProfile && currentModelKey === model.key ? currentProfile.thinkingLevel : undefined;
+        const currentEffort = currentProfile && currentModelKey === model.key ? currentProfile.thinking : undefined;
         return {
           title: `Choose effort · ${model.label}`,
           choices: model.thinkingLevels.map((level) => ({
@@ -681,7 +809,7 @@ function createCognitiveRoutingProfileWizard(
       return {
         provider: model.provider,
         model: model.model,
-        thinkingLevel: selectedValues[1] as CognitiveRoutingThinkingLevel,
+        thinking: selectedValues[1] as CognitiveRoutingThinkingLevel,
       } satisfies CognitiveRoutingProfile;
     },
   };
@@ -694,133 +822,75 @@ function cognitiveRoutingProfileItem(options: {
   localConfig: Record<string, unknown>;
   capabilityState: CognitiveRoutingCapabilityState | undefined;
   ctx: any;
+  sessionProfiles?: Partial<Record<CognitiveRoutingProfileName, SessionRoutingPair>>;
 }): SettingsItem {
   const path = ["cognitiveRouting", "profiles", options.name];
   const repositoryProfile = getPath(options.rawConfig, path);
   const localProfile = getPath(options.localConfig, path);
-  const effectiveProfile = options.capabilityState?.profiles?.[options.name] ?? repositoryProfile;
+  const configuredProfile = options.capabilityState?.profiles?.[options.name] ?? repositoryProfile;
+  const sessionPair = options.sessionProfiles?.[options.name];
+  const sessionProfile = sessionPair
+    ? { provider: sessionPair.provider, model: sessionPair.modelId, thinking: sessionPair.thinking }
+    : undefined;
+  const effectiveProfile = sessionProfile ?? configuredProfile;
   const localValue = isCognitiveRoutingProfile(localProfile) ? localProfile : LOCAL_INHERIT;
-  const value = options.scope === "local" ? localValue : repositoryProfile;
-  const source =
+  const value =
+    options.scope === "session"
+      ? (sessionProfile ?? LOCAL_INHERIT)
+      : options.scope === "local"
+        ? localValue
+        : repositoryProfile;
+  const configuredSource =
     options.capabilityState?.profileSources?.[options.name] ??
     (isCognitiveRoutingProfile(repositoryProfile) ? "repository" : undefined);
+  const source = options.scope === "session" ? (sessionProfile ? "session" : configuredSource) : configuredSource;
   const models = cognitiveRoutingModelOptions(options.ctx);
-  const inactive = options.scope === "local" && models.length === 0 && localValue !== LOCAL_INHERIT;
+  const inactive = options.scope !== "repository" && models.length === 0 && value !== LOCAL_INHERIT;
+  const inheritChoice =
+    options.scope === "session"
+      ? {
+          label: "Inherit configured preset",
+          description: "Remove the session override without changing local or repository configuration.",
+          summary: "inherit configured preset",
+        }
+      : undefined;
 
   return {
     id: `freeflow.cognitiveRouting.${options.name}`,
     label: `${options.name.charAt(0).toUpperCase()}${options.name.slice(1)} preset`,
     description:
-      "Choose an authenticated available model and one effort supported by that model. Confirming writes the complete preset; cancel leaves it unchanged.",
+      options.scope === "session"
+        ? "Temporarily choose the model and effort for this profile in the current Pi session only."
+        : "Choose an authenticated available model and one effort supported by that model. Confirming writes the complete preset; cancel leaves it unchanged.",
     path,
     kind: "string",
     value,
-    format: cognitiveRoutingProfileDisplay,
+    format: (current) => {
+      const inherits = current === LOCAL_INHERIT || (options.scope === "session" && current === undefined);
+      return inherits
+        ? options.scope === "session"
+          ? "inherit configured preset"
+          : "inherit repository preset"
+        : cognitiveRoutingProfileDisplay(current);
+    },
     configScope: options.scope,
     effectiveValue: effectiveProfile,
     effectiveSource: cognitiveRoutingSettingsSource(source),
-    inheritedValue: repositoryProfile,
-    inheritedSource: "repository",
+    inheritedValue: options.scope === "session" ? configuredProfile : repositoryProfile,
+    inheritedSource: cognitiveRoutingSettingsSource(configuredSource ?? "builtin"),
     inactive,
     displaySuffix: cognitiveRoutingProfileDisplaySuffix(source, options.scope),
-    wizard: () => createCognitiveRoutingProfileWizard(value, models, options.scope === "local"),
+    wizard: () => createCognitiveRoutingProfileWizard(value, models, options.scope !== "repository", inheritChoice),
   };
 }
 
-type CognitiveRoutingSessionStartSetting = "control" | "profile";
-
-function cognitiveRoutingSessionStartItem(options: {
-  setting: CognitiveRoutingSessionStartSetting;
-  scope: ConfigScope;
-  rawConfig: Record<string, unknown>;
-  localConfig: Record<string, unknown>;
-  capabilityState: CognitiveRoutingCapabilityState | undefined;
-}): SettingsItem {
-  const path = ["cognitiveRouting", "sessionStart", options.setting];
-  const defaultValue = options.setting === "control" ? "automatic" : "reasoning";
-  const values = options.setting === "control" ? ["automatic", "manual"] : ["standard", "reasoning"];
-  const labels = Object.fromEntries(values.map((value) => [value, value]));
-  const descriptions =
-    options.setting === "control"
-      ? {
-          automatic: "Start the new session in Reasoning; automatic delegation may use Standard during execution.",
-          manual: "Hold the selected profile for the new session until the user changes it.",
-        }
-      : {
-          standard: "Start a new manual session with the configured Standard preset.",
-          reasoning: "Start a new manual session with the configured Reasoning preset.",
-        };
-  const repositoryValue = getPath(options.rawConfig, path);
-  const localValue = getPath(options.localConfig, path);
-  const isValidValue = (value: unknown): value is string => values.includes(value as string);
-  const repositorySetting = isValidValue(repositoryValue) ? repositoryValue : undefined;
-  const localSetting = isValidValue(localValue) ? localValue : undefined;
-  const inheritedValue = repositorySetting ?? defaultValue;
-  const inheritedSource: ConfigSource = repositorySetting ? "repository" : "builtin";
-  const configuredSource =
-    options.capabilityState?.sessionStartSources?.[options.setting] ?? (repositorySetting ? "repository" : undefined);
-  const effectiveSessionStartControl =
-    options.capabilityState?.sessionStart?.control ??
-    getPath(options.localConfig, ["cognitiveRouting", "sessionStart", "control"]) ??
-    getPath(options.rawConfig, ["cognitiveRouting", "sessionStart", "control"]) ??
-    "automatic";
-  const effectiveValue =
-    options.setting === "profile" && effectiveSessionStartControl === "automatic"
-      ? "reasoning"
-      : (options.capabilityState?.sessionStart?.[options.setting] ?? inheritedValue);
-  const effectiveSource = cognitiveRoutingSettingsSource(configuredSource);
-  const label = options.setting === "control" ? "Session start control" : "Manual session-start profile";
-  const description =
-    options.setting === "control"
-      ? "Choose automatic or manual control for new sessions only; changing this does not alter the active session."
-      : "Choose the profile for manual session starts; automatic sessions always start in Reasoning.";
-
-  const item: SettingsItem =
-    options.scope === "local"
-      ? {
-          id: `freeflow.cognitiveRouting.sessionStart.${options.setting}`,
-          label,
-          description: `${description} Choose inherit to use the repository value; use /freeflow settings repo to edit shared defaults.`,
-          path,
-          kind: "enum",
-          value: localSetting ?? LOCAL_INHERIT,
-          values: [LOCAL_INHERIT, ...values],
-          valueLabels: { inherit: "Inherit repository", ...labels },
-          valueDescriptions: {
-            inherit: `Use ${inheritedValue} from ${inheritedSource}.`,
-            ...descriptions,
-          },
-          format: (value) => String(value),
-          configScope: "local",
-          configValues: { inherit: undefined },
-          effectiveValue,
-          effectiveSource,
-          inheritedValue,
-          inheritedSource,
-        }
-      : {
-          id: `freeflow.cognitiveRouting.sessionStart.${options.setting}`,
-          label,
-          description: `${description} This edits shared .freeflow/config.json.`,
-          path,
-          kind: "enum",
-          value: inheritedValue,
-          values,
-          valueLabels: labels,
-          valueDescriptions: descriptions,
-          format: (value) => String(value),
-          defaultValue,
-          configScope: "repository",
-          effectiveValue,
-          effectiveSource,
-          localOverrideValue: localSetting,
-        };
-  item.displaySuffix = coreDisplaySuffix(item);
-  return item;
-}
-
 function isCognitiveRoutingRuntimeAvailable(pi: any): boolean {
-  return isPiFlowHost(pi?.host) || supportsPiSessionModelStateApi(pi);
+  return (
+    !isPiFlowHost(pi?.host) &&
+    typeof pi?.appendEntry === "function" &&
+    typeof pi?.setModel === "function" &&
+    typeof pi?.setThinkingLevel === "function"
+  );
 }
 
 function freeflowItems(
@@ -833,7 +903,7 @@ function freeflowItems(
     runtimeAvailable?: boolean;
   } = {},
 ): SettingsItem[] {
-  const scope = options.scope ?? "repository";
+  const scope: Exclude<ConfigScope, "session"> = options.scope === "local" ? "local" : "repository";
   const layers = options.layers;
   const { localConfig, core, sources } = resolveSettingsCoreView(rawConfig, layers);
 
@@ -889,7 +959,7 @@ function freeflowItems(
       label: "Enabled",
       description: cognitiveRoutingRuntimeDisabled
         ? "Requires a host model-state control API; configuration is read-only on this host."
-        : "Allow Cognitive Routing to own the session model lease and switch the configured profiles.",
+        : "Allow Cognitive Routing to manage explicit assignments and request native profile transitions.",
       path: ["cognitiveRouting", "enabled"],
       effectiveValue: cognitiveRoutingState?.enabled ?? false,
       effectiveSource: cognitiveRoutingSettingsSource(cognitiveRoutingState?.enabledSource),
@@ -898,7 +968,33 @@ function freeflowItems(
     cognitiveRoutingEnabledItem.inactive = freeflowInactive || cognitiveRoutingRuntimeDisabled;
     cognitiveRoutingEnabledItem.runtimeInactive = cognitiveRoutingRuntimeDisabled;
 
-    const cognitiveRoutingProfiles = ["standard", "reasoning"].map((name) =>
+    const cognitiveRoutingDelegationItem = createScopedDelegationItem({
+      scope,
+      rawConfig,
+      localConfig,
+      effectiveValue: cognitiveRoutingState?.delegation ?? "executor",
+      effectiveSource: cognitiveRoutingSettingsSource(cognitiveRoutingState?.delegationSource),
+    });
+    cognitiveRoutingDelegationItem.inactive = freeflowInactive || cognitiveRoutingRuntimeDisabled;
+    cognitiveRoutingDelegationItem.runtimeInactive = cognitiveRoutingRuntimeDisabled;
+
+    const cognitiveRoutingProjectionItem = createScopedBooleanItem({
+      scope,
+      rawConfig,
+      localConfig,
+      id: "freeflow.cognitiveRouting.projection",
+      label: "Context projection",
+      description:
+        "Select worker evidence for Coordinator; disable projection to keep ordinary Pi context in all enabled profiles.",
+      path: ["cognitiveRouting", "projection"],
+      effectiveValue: cognitiveRoutingState?.projection ?? false,
+      effectiveSource: cognitiveRoutingSettingsSource(cognitiveRoutingState?.projectionSource),
+      defaultValue: false,
+    });
+    cognitiveRoutingProjectionItem.inactive = freeflowInactive || cognitiveRoutingRuntimeDisabled;
+    cognitiveRoutingProjectionItem.runtimeInactive = cognitiveRoutingRuntimeDisabled;
+
+    const cognitiveRoutingProfiles = ["coordinator", "helper", "executor"].map((name) =>
       cognitiveRoutingProfileItem({
         name: name as CognitiveRoutingProfileName,
         scope,
@@ -908,17 +1004,7 @@ function freeflowItems(
         ctx: options.ctx,
       }),
     );
-    const cognitiveRoutingSessionStart = (["control", "profile"] as CognitiveRoutingSessionStartSetting[]).map(
-      (setting) =>
-        cognitiveRoutingSessionStartItem({
-          setting,
-          scope,
-          rawConfig,
-          localConfig,
-          capabilityState: cognitiveRoutingState,
-        }),
-    );
-    for (const item of [...cognitiveRoutingProfiles, ...cognitiveRoutingSessionStart]) {
+    for (const item of cognitiveRoutingProfiles) {
       item.inactive ||= freeflowInactive || cognitiveRoutingRuntimeDisabled;
       item.runtimeInactive = cognitiveRoutingRuntimeDisabled;
     }
@@ -936,12 +1022,17 @@ function freeflowItems(
       label: "Cognitive Routing",
       description: cognitiveRoutingRuntimeDisabled
         ? "Cognitive Routing configuration is visible for inspection but requires a host model-state control API."
-        : "Configure the Standard and Reasoning profiles and choose whether Freeflow may manage model state for this repository.",
+        : "Configure Coordinator, Helper, and Executor profiles plus the workers available for delegation.",
       kind: "group" as const,
       value: cognitiveRoutingRuntimeDisabled ? false : (cognitiveRoutingState?.enabled ?? false),
       inactive: freeflowInactive,
       displaySuffix: cognitiveRoutingStatus,
-      children: [cognitiveRoutingEnabledItem, ...cognitiveRoutingProfiles, ...cognitiveRoutingSessionStart],
+      children: [
+        cognitiveRoutingEnabledItem,
+        cognitiveRoutingDelegationItem,
+        ...cognitiveRoutingProfiles,
+        cognitiveRoutingProjectionItem,
+      ],
     } satisfies SettingsItem;
   })();
 
@@ -965,6 +1056,7 @@ function pruneKnownDefaults(config: Record<string, unknown>) {
     { path: ["enabled"], value: DEFAULT_FREEFLOW_ENABLED },
     { path: ["contextVirtualization"], value: DEFAULT_CONTEXT_VIRTUALIZATION_ENABLED },
     { path: ["conversationHistory"], value: DEFAULT_CONVERSATION_HISTORY_ENABLED },
+    { path: ["cognitiveRouting", "delegation"], value: "executor" },
   ];
 
   for (const item of defaultPaths) {
@@ -1051,7 +1143,7 @@ async function updateConfig(
 }
 
 function isCognitiveRoutingProfileItem(item: SettingsItem): boolean {
-  return item.id === "freeflow.cognitiveRouting.standard" || item.id === "freeflow.cognitiveRouting.reasoning";
+  return ["coordinator", "helper", "executor"].some((profile) => item.id === `freeflow.cognitiveRouting.${profile}`);
 }
 
 function valueForDisplay(item: SettingsItem): string {
@@ -1095,10 +1187,13 @@ function refreshSettingsDerivedState(items: SettingsItem[]) {
   const freeflowInactive = freeflowItem ? effectiveItemValue(freeflowItem) !== true : false;
   const cognitiveRoutingGroup = findSettingsItem(items, "freeflow.cognitiveRouting");
   const cognitiveRoutingEnabledItem = findSettingsItem(items, "freeflow.cognitiveRouting.enabled");
-  const cognitiveRoutingProfiles = [
-    findSettingsItem(items, "freeflow.cognitiveRouting.standard"),
-    findSettingsItem(items, "freeflow.cognitiveRouting.reasoning"),
-  ];
+  const cognitiveRoutingDelegationItem = findSettingsItem(items, "freeflow.cognitiveRouting.delegation");
+  const delegation = (
+    cognitiveRoutingDelegationItem ? effectiveItemValue(cognitiveRoutingDelegationItem) : "executor"
+  ) as CognitiveRoutingDelegationMode;
+  const cognitiveRoutingProfiles = ["coordinator", ...workersForDelegation(delegation)].map((profile) =>
+    findSettingsItem(items, `freeflow.cognitiveRouting.${profile}`),
+  );
 
   if (cognitiveRoutingGroup && cognitiveRoutingEnabledItem) {
     const enabled = effectiveItemValue(cognitiveRoutingEnabledItem) === true;
@@ -1416,7 +1511,7 @@ export async function handleFreeflowCommand(
   let reconcileCognitiveRouting = settingsScope === "session";
   const items =
     settingsScope === "session"
-      ? sessionFreeflowItems(state, cognitiveRoutingController)
+      ? sessionFreeflowItems(state, cognitiveRoutingController, ctx)
       : freeflowItems(raw, {
           scope: settingsScope,
           layers,
@@ -1447,7 +1542,10 @@ export async function handleFreeflowCommand(
         const result =
           value === "auto"
             ? await cognitiveRoutingController.setAutomaticControl("profile-settings")
-            : await cognitiveRoutingController.setManualProfile(value as "standard" | "reasoning", "profile-settings");
+            : await cognitiveRoutingController.setManualProfile(
+                value as CognitiveRoutingProfileName,
+                "profile-settings",
+              );
         if ((result.status !== "automatic" && result.status !== "active") || result.reason) {
           ctx.ui.notify(
             `Cognitive Routing settings could not be applied: ${result.reason ?? result.status}.`,
@@ -1459,8 +1557,63 @@ export async function handleFreeflowCommand(
         return { changed: true, reloadRequired: false };
       }
       if (item.id === "freeflow.session.reset") {
-        const result = await resetSessionOverrides(ctx, pi);
-        return { changed: result.changed, reloadRequired: result.reloadRequired };
+        const routingResult = cognitiveRoutingController
+          ? await cognitiveRoutingController.resetSessionProfileOverrides("Reset session overrides")
+          : { status: "unchanged" };
+        if (routingResult.status === "blocked" || routingResult.reason) {
+          ctx.ui.notify(
+            `Cognitive Routing session presets could not be reset: ${routingResult.reason ?? routingResult.status}.`,
+            "warning",
+          );
+          return { changed: false, reloadRequired: false };
+        }
+        try {
+          const result = await resetSessionOverrides(ctx, pi);
+          return {
+            changed: result.changed || routingResult.status !== "unchanged",
+            reloadRequired: result.reloadRequired,
+          };
+        } catch (error) {
+          ctx.ui.notify(
+            `Routing presets were reset, but core/context session overrides could not be reset: ${
+              error instanceof Error ? error.message : String(error)
+            }`,
+            "warning",
+          );
+          return {
+            changed: routingResult.status !== "unchanged",
+            reloadRequired: false,
+          };
+        }
+      }
+      if (item.configScope === "session" && isCognitiveRoutingProfileItem(item)) {
+        if (!cognitiveRoutingController) {
+          ctx.ui.notify("Cognitive Routing is unavailable for this session.", "warning");
+          return { changed: false, reloadRequired: false };
+        }
+        const profile = item.id.split(".").at(-1) as CognitiveRoutingProfileName;
+        const override =
+          value === undefined || value === LOCAL_INHERIT
+            ? null
+            : {
+                provider: (value as CognitiveRoutingProfile).provider,
+                modelId: (value as CognitiveRoutingProfile).model,
+                thinking: (value as CognitiveRoutingProfile).thinking,
+              };
+        const result = await cognitiveRoutingController.setSessionProfileOverride(
+          profile,
+          override,
+          "Session profile settings",
+        );
+        if (result.status === "blocked" || result.reason) {
+          ctx.ui.notify(
+            `Cognitive Routing session preset could not be applied: ${result.reason ?? result.status}.`,
+            "warning",
+          );
+          return { changed: false, reloadRequired: false };
+        }
+        await afterChange(false);
+        return { changed: result.status !== "unchanged", reloadRequired: false };
       }
       if (item.configScope === "session") {
         const keyById = {