@devries-cameron20 / composio-1 / commits / 4718495d1
Fork 0

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

feat(python): add session.update() for partial session config updates

Mirrors the TypeScript session.update() — calls the existing PATCH endpoint and mutates the session's preload config in-place. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Abir Taheer committed May 7, 2026 at 02:07 UTC 4718495d10c0051fb4ac0cb3a85446d5ff7f8617
1 file changed +144
python/composio/core/models/tool_router_session.py
+144
@@ -55,7 +55,15 @@ from composio.core.provider.base import BaseProvider
55
56 if t.TYPE_CHECKING:
57 from composio.core.models.tool_router import (
58 + ToolRouterConfigTags,
59 + ToolRouterManageConnectionsConfig,
60 + ToolRouterMultiAccountConfig,
61 + ToolRouterPreloadConfig,
62 ToolRouterSessionExperimental,
63 + ToolRouterToolkitsDisableConfig,
64 + ToolRouterToolkitsEnableConfig,
65 + ToolRouterToolsConfig,
66 + ToolRouterWorkbenchConfig,
67 ToolkitConnectionsDetails,
68 )
69
@@ -798,3 +806,139 @@ class ToolRouterSession(t.Generic[TTool, TToolCollection]):
806 body=body,
807 parameters=parameters,
808 )
809 +
810 + def update(
811 + self,
812 + *,
813 + toolkits: t.Optional[
814 + t.Union[
815 + t.List[str],
816 + "ToolRouterToolkitsEnableConfig",
817 + "ToolRouterToolkitsDisableConfig",
818 + ]
819 + ] = None,
820 + tools: t.Optional[t.Dict[str, "ToolRouterToolsConfig"]] = None,
821 + tags: t.Optional["ToolRouterConfigTags"] = None,
822 + manage_connections: t.Optional[
823 + t.Union[bool, "ToolRouterManageConnectionsConfig", None]
824 + ] = omit, # type: ignore[assignment]
825 + auth_configs: t.Optional[t.Dict[str, str]] = None,
826 + connected_accounts: t.Optional[t.Dict[str, t.Union[str, t.List[str]]]] = None,
827 + workbench: t.Optional[t.Union["ToolRouterWorkbenchConfig", None]] = omit, # type: ignore[assignment]
828 + multi_account: t.Optional[t.Union["ToolRouterMultiAccountConfig", None]] = omit, # type: ignore[assignment]
829 + preload: t.Optional["ToolRouterPreloadConfig"] = None,
830 + ) -> None:
831 + """Partially update the session configuration.
832 +
833 + Only the fields provided will be changed; omitted fields are preserved.
834 + Mutates this session's ``preload`` in-place.
835 +
836 + Pass ``None`` for ``manage_connections``, ``workbench``, or
837 + ``multi_account`` to clear the stored value.
838 +
839 + :param toolkits: Toolkit configuration (same format as ``create``).
840 + :param tools: Per-toolkit tool configuration (same format as ``create``).
841 + :param tags: Global MCP tag filter (same format as ``create``).
842 + :param manage_connections: Connection management config, ``True``/``False``,
843 + or ``None`` to clear.
844 + :param auth_configs: Auth config overrides per toolkit.
845 + :param connected_accounts: Connected account overrides per toolkit.
846 + :param workbench: Workbench configuration or ``None`` to clear.
847 + :param multi_account: Multi-account configuration or ``None`` to clear.
848 + :param preload: Preload configuration.
849 + """
850 + from composio.core.models.tool_router import _session_preload_config
851 +
852 + patch_kwargs: t.Dict[str, t.Any] = {"session_id": self.session_id}
853 +
854 + # Transform toolkits
855 + if toolkits is not None:
856 + if isinstance(toolkits, list):
857 + patch_kwargs["toolkits"] = {"enable": toolkits}
858 + else:
859 + patch_kwargs["toolkits"] = toolkits
860 +
861 + # Transform tools
862 + if tools is not None:
863 + tools_payload: t.Dict[str, t.Any] = {}
864 + for toolkit_slug, config in tools.items():
865 + if isinstance(config, list):
866 + tools_payload[toolkit_slug] = {"enable": config}
867 + elif isinstance(config, dict):
868 + cfg = t.cast(t.Dict[str, t.Any], config)
869 + transformed: t.Dict[str, t.Any] = {}
870 + if "enable" in cfg:
871 + transformed["enable"] = cfg["enable"]
872 + if "disable" in cfg:
873 + transformed["disable"] = cfg["disable"]
874 + if "tags" in cfg:
875 + tags_val = cfg["tags"]
876 + if isinstance(tags_val, list):
877 + transformed["tags"] = {"enable": tags_val}
878 + elif isinstance(tags_val, dict):
879 + transformed["tags"] = tags_val
880 + tools_payload[toolkit_slug] = transformed
881 + patch_kwargs["tools"] = tools_payload
882 +
883 + # Transform tags
884 + if tags is not None:
885 + if isinstance(tags, list):
886 + patch_kwargs["tags"] = {"enable": tags}
887 + elif isinstance(tags, dict):
888 + patch_kwargs["tags"] = tags
889 +
890 + if auth_configs is not None:
891 + patch_kwargs["auth_configs"] = auth_configs
892 +
893 + if connected_accounts is not None:
894 + patch_kwargs["connected_accounts"] = {
895 + k: [v] if isinstance(v, str) else v
896 + for k, v in connected_accounts.items()
897 + }
898 +
899 + # Transform manage_connections (omit sentinel means "don't touch")
900 + if manage_connections is not omit:
901 + if manage_connections is None:
902 + patch_kwargs["manage_connections"] = None
903 + elif isinstance(manage_connections, bool):
904 + patch_kwargs["manage_connections"] = {"enable": manage_connections}
905 + else:
906 + mc: t.Dict[str, t.Any] = {}
907 + if "enable" in manage_connections:
908 + mc["enable"] = manage_connections["enable"]
909 + if "callback_url" in manage_connections:
910 + mc["callback_url"] = manage_connections["callback_url"]
911 + if "wait_for_connections" in manage_connections:
912 + mc["enable_wait_for_connections"] = manage_connections[
913 + "wait_for_connections"
914 + ]
915 + patch_kwargs["manage_connections"] = mc
916 +
917 + # Transform workbench (omit sentinel means "don't touch")
918 + if workbench is not omit:
919 + if workbench is None:
920 + patch_kwargs["workbench"] = None
921 + else:
922 + wb: t.Dict[str, t.Any] = {}
923 + if "enable" in workbench:
924 + wb["enable"] = workbench["enable"]
925 + if "enable_proxy_execution" in workbench:
926 + wb["enable_proxy_execution"] = workbench["enable_proxy_execution"]
927 + if "auto_offload_threshold" in workbench:
928 + wb["auto_offload_threshold"] = workbench["auto_offload_threshold"]
929 + if "sandbox_size" in workbench:
930 + wb["sandbox_size"] = workbench["sandbox_size"]
931 + patch_kwargs["workbench"] = wb
932 +
933 + # Transform multi_account (omit sentinel means "don't touch")
934 + if multi_account is not omit:
935 + if multi_account is None:
936 + patch_kwargs["multi_account"] = None
937 + else:
938 + patch_kwargs["multi_account"] = multi_account
939 +
940 + if preload is not None:
941 + patch_kwargs["preload"] = preload
942 +
943 + response = self._client.tool_router.session.patch(**patch_kwargs)
944 + self.preload = _session_preload_config(response.config.preload)