Patch of mutable session options to apply to the running session.
| 20782 | # Experimental: this type is part of an experimental API and may change or be removed. |
| 20783 | @dataclass |
| 20784 | class SessionUpdateOptionsParams: |
| 20785 | """Patch of mutable session options to apply to the running session.""" |
| 20786 | |
| 20787 | additional_content_exclusion_policies: list[OptionsUpdateAdditionalContentExclusionPolicy] | None = None |
| 20788 | """Additional content-exclusion policies to merge into the session's policy set.""" |
| 20789 | |
| 20790 | agent_context: str | None = None |
| 20791 | """Runtime context discriminator (e.g., `cli`, `actions`).""" |
| 20792 | |
| 20793 | allow_all_mcp_server_instructions: bool | None = None |
| 20794 | """Whether to include instructions from every MCP server in the system prompt instead of |
| 20795 | only allowlisted servers. |
| 20796 | """ |
| 20797 | ask_user_disabled: bool | None = None |
| 20798 | """Whether to disable the `ask_user` tool (encourages autonomous behavior).""" |
| 20799 | |
| 20800 | available_tools: list[str] | None = None |
| 20801 | """Allowlist of tool names available to this session.""" |
| 20802 | |
| 20803 | capi: CapiSessionOptions | None = None |
| 20804 | """Options scoped to the built-in CAPI (Copilot API) provider.""" |
| 20805 | |
| 20806 | client_name: str | None = None |
| 20807 | """Identifier of the client driving the session.""" |
| 20808 | |
| 20809 | coauthor_enabled: bool | None = None |
| 20810 | """Whether to include the `Co-authored-by` trailer in commit messages.""" |
| 20811 | |
| 20812 | context_tier: OptionsUpdateContextTier | None = None |
| 20813 | """Context tier for models with tiered pricing. The session uses this to derive effective |
| 20814 | `modelCapabilitiesOverrides` so compaction, truncation, token display, and request limits |
| 20815 | honor the selected tier. |
| 20816 | """ |
| 20817 | continue_on_auto_mode: bool | None = None |
| 20818 | """Whether to allow auto-mode continuation across turns.""" |
| 20819 | |
| 20820 | copilot_url: str | None = None |
| 20821 | """Override URL for the Copilot API endpoint.""" |
| 20822 | |
| 20823 | custom_agents_local_only: bool | None = None |
| 20824 | """Whether to default custom agents to local-only execution.""" |
| 20825 | |
| 20826 | disabled_instruction_sources: list[str] | None = None |
| 20827 | """Instruction source IDs to exclude from the system prompt.""" |
| 20828 | |
| 20829 | disabled_skills: list[str] | None = None |
| 20830 | """Skill IDs that should be excluded from this session.""" |
| 20831 | |
| 20832 | enable_file_hooks: bool | None = None |
| 20833 | """Whether to enable loading of `.github/hooks/` filesystem hooks. Separate from the SDK |
| 20834 | callback hook mechanism. |
| 20835 | """ |
| 20836 | enable_host_git_operations: bool | None = None |
| 20837 | """Whether to enable host git operations (context resolution, child repo scanning, git info |
| 20838 | in system prompt). |
| 20839 | """ |
| 20840 | enable_on_demand_instruction_discovery: bool | None = None |
| 20841 | """Whether to discover custom instructions on demand after successful file views (AGENTS.md |
no outgoing calls
searching dependent graphs…