Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
Mirrored from https://github.com/Camo67/composio.git
Synced Nov 21, 22:15 UTC
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)