Function _post_create_options_patch

python/copilot/_mode.py:279–316

Build the patch sent via ``session.options.update`` after create/resume. In empty mode the four overridable flags default to safe values (caller-supplied values win); ``installedPlugins=[]`` is unconditional. Returns ``None`` if no patch should be sent.

(
    mode: CopilotClientMode | None,
    skip_custom_instructions: bool | None,
    custom_agents_local_only: bool | None,
    coauthor_enabled: bool | None,
    manage_schedule_enabled: bool | None,
)

def _post_create_options_patch(
    mode: CopilotClientMode | None,
    skip_custom_instructions: bool | None,
    custom_agents_local_only: bool | None,
    coauthor_enabled: bool | None,
    manage_schedule_enabled: bool | None,
) -> dict[str, Any] | None:
    """Build the patch sent via ``session.options.update`` after create/resume.

    In empty mode the four overridable flags default to safe values
    (caller-supplied values win); ``installedPlugins=[]`` is unconditional.
    Returns ``None`` if no patch should be sent.
    """
    if mode == "empty":
        patch: dict[str, Any] = {
            "skipCustomInstructions": (
                skip_custom_instructions if skip_custom_instructions is not None else True
            ),
            "customAgentsLocalOnly": (
                custom_agents_local_only if custom_agents_local_only is not None else True
            ),
            "coauthorEnabled": coauthor_enabled if coauthor_enabled is not None else False,
            "manageScheduleEnabled": (
                manage_schedule_enabled if manage_schedule_enabled is not None else False
            ),
            "installedPlugins": [],
        }
        return patch
    patch = {}
    if skip_custom_instructions is not None:
        patch["skipCustomInstructions"] = skip_custom_instructions
    if custom_agents_local_only is not None:
        patch["customAgentsLocalOnly"] = custom_agents_local_only
    if coauthor_enabled is not None:
        patch["coauthorEnabled"] = coauthor_enabled
    if manage_schedule_enabled is not None:
        patch["manageScheduleEnabled"] = manage_schedule_enabled
    return patch or None


def _require_storage_for_empty_mode(