672
assert wrapped[0]["has_executor"] is True
673
674
675
+class TestLangchainReservedKeywords:
676
+ """Regression tests for PLEN-1671: ValueError when tool schema has Python reserved keywords as parameter names.
677
+
678
+ Tools from some toolkits (e.g. Intercom) have parameters named 'from',
679
+ which is a Python reserved keyword. The LangchainProvider must substitute
680
+ these names before building function signatures and reinstate them when
681
+ executing the tool.
682
+ """
683
+
684
+ def _make_tool_with_params(self, properties: dict, required: list | None = None):
685
+ """Helper: create a mock Tool whose input_parameters use the given properties."""
686
+ return Tool(
687
+ name="Test Tool",
688
+ slug="TEST_TOOL",
689
+ description="A tool for testing reserved keyword handling",
690
+ input_parameters={
691
+ "type": "object",
692
+ "title": "TestToolRequest",
693
+ "properties": properties,
694
+ "required": required or [],
695
+ },
696
+ output_parameters={},
697
+ available_versions=["12012025_00"],
698
+ version="12012025_00",
699
+ scopes=[],
700
+ status="active",
701
+ toolkit=tool_list_response.ItemToolkit(name="Test", slug="test", logo=""),
702
+ deprecated=tool_list_response.ItemDeprecated(
703
+ available_versions=["12012025_00"],
704
+ displayName="Test Tool",
705
+ version="12012025_00",
706
+ toolkit=tool_list_response.ItemDeprecatedToolkit(logo=""),
707
+ is_deprecated=False,
708
+ ),
709
+ is_deprecated=False,
710
+ no_auth=False,
711
+ tags=[],
712
+ )
713
+
714
+ def test_wrap_tool_with_from_parameter(self):
715
+ """PLEN-1671: 'from' parameter must not raise ValueError."""
716
+ from composio_langchain import LangchainProvider
717
+
718
+ provider = LangchainProvider()
719
+ tool = self._make_tool_with_params(
720
+ properties={
721
+ "from": {
722
+ "type": "string",
723
+ "description": "Starting point for listing",
724
+ },
725
+ "limit": {
726
+ "type": "integer",
727
+ "description": "Max results",
728
+ "default": 20,
729
+ },
730
+ },
731
+ )
732
+
733
+ captured = {}
734
+
735
+ def mock_execute(slug, arguments):
736
+ captured.update(arguments)
737
+ return {"data": {}, "error": None, "successful": True}
738
+
739
+ # Must not raise ValueError: 'from' is not a valid parameter name
740
+ wrapped = provider.wrap_tool(tool, mock_execute)
741
+
742
+ assert wrapped.name == "TEST_TOOL"
743
+
744
+ # Invoke the tool and verify 'from' is reinstated in the arguments
745
+ wrapped.run({"from_rs": "2024-01-01", "limit": 10})
746
+ assert captured == {"from": "2024-01-01", "limit": 10}
747
+
748
+ def test_wrap_tool_with_multiple_reserved_keywords(self):
749
+ """All Python reserved keywords used as parameter names must be handled."""
750
+ from composio_langchain import LangchainProvider
751
+
752
+ provider = LangchainProvider()
753
+ tool = self._make_tool_with_params(
754
+ properties={
755
+ "from": {
756
+ "type": "string",
757
+ "description": "Start date",
758
+ },
759
+ "for": {
760
+ "type": "string",
761
+ "description": "Recipient",
762
+ },
763
+ "import": {
764
+ "type": "string",
765
+ "description": "Import source",
766
+ },
767
+ "class": {
768
+ "type": "string",
769
+ "description": "CSS class",
770
+ },
771
+ "async": {
772
+ "type": "boolean",
773
+ "description": "Async flag",
774
+ "default": False,
775
+ },
776
+ "normal_param": {
777
+ "type": "string",
778
+ "description": "A normal parameter",
779
+ },
780
+ },
781
+ )
782
+
783
+ captured = {}
784
+
785
+ def mock_execute(slug, arguments):
786
+ captured.update(arguments)
787
+ return {"data": {}, "error": None, "successful": True}
788
+
789
+ wrapped = provider.wrap_tool(tool, mock_execute)
790
+ assert wrapped.name == "TEST_TOOL"
791
+
792
+ # Invoke with renamed parameters and verify originals are reinstated
793
+ wrapped.run(
794
+ {
795
+ "from_rs": "2024-01-01",
796
+ "for_rs": "user@example.com",
797
+ "import_rs": "csv",
798
+ "class_rs": "primary",
799
+ "async_rs": True,
800
+ "normal_param": "hello",
801
+ }
802
+ )
803
+ assert captured == {
804
+ "from": "2024-01-01",
805
+ "for": "user@example.com",
806
+ "import": "csv",
807
+ "class": "primary",
808
+ "async": True,
809
+ "normal_param": "hello",
810
+ }
811
+
812
+ def test_wrap_tool_with_required_reserved_keyword_param(self):
813
+ """Reserved keywords that are also required params must work."""
814
+ from composio_langchain import LangchainProvider
815
+
816
+ provider = LangchainProvider()
817
+ tool = self._make_tool_with_params(
818
+ properties={
819
+ "from": {
820
+ "type": "string",
821
+ "description": "Required start date",
822
+ },
823
+ },
824
+ required=["from"],
825
+ )
826
+
827
+ captured = {}
828
+
829
+ def mock_execute(slug, arguments):
830
+ captured.update(arguments)
831
+ return {"data": {}, "error": None, "successful": True}
832
+
833
+ wrapped = provider.wrap_tool(tool, mock_execute)
834
+ wrapped.run({"from_rs": "2024-01-01"})
835
+ assert captured == {"from": "2024-01-01"}
836
+
837
+
838
class TestProviderEdgeCases:
839
"""Test edge cases and error handling for providers."""
840