chore: import upstream snapshot with attribution

python/tests/agents/camel/conftest.py

@@ -0,0 +1,20 @@
+# ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+
+import importlib.util
+
+collect_ignore_glob: list[str] = []
+
+if importlib.util.find_spec("camel") is None:
+    collect_ignore_glob = ["test_*.py"]

python/tests/agents/camel/test_async.py

@@ -0,0 +1,54 @@
+# ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+
+import asyncio
+
+import pytest
+
+from mirage.agents.camel._async import AsyncRunner
+
+
+def test_run_from_sync_with_no_loop():
+    runner = AsyncRunner()
+
+    async def coro():
+        await asyncio.sleep(0)
+        return 42
+
+    assert runner.run(coro()) == 42
+    runner.close()
+
+
+def test_run_returns_exception():
+    runner = AsyncRunner()
+
+    async def boom():
+        raise ValueError("nope")
+
+    with pytest.raises(ValueError, match="nope"):
+        runner.run(boom())
+    runner.close()
+
+
+@pytest.mark.asyncio
+async def test_run_from_inside_running_loop():
+    runner = AsyncRunner()
+
+    async def coro():
+        await asyncio.sleep(0)
+        return "from-loop"
+
+    result = await asyncio.to_thread(runner.run, coro())
+    assert result == "from-loop"
+    runner.close()

python/tests/agents/camel/test_compat.py

@@ -0,0 +1,67 @@
+# ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+
+import inspect
+
+from camel.toolkits import BaseToolkit, FileToolkit, FunctionTool
+
+
+def test_base_toolkit_has_get_tools():
+    assert hasattr(BaseToolkit, "get_tools")
+
+
+def test_file_toolkit_private_hooks_exist():
+    expected = [
+        "_resolve_filepath",
+        "_resolve_existing_filepath",
+        "_resolve_search_path",
+        "_sanitize_filename",
+        "_create_backup",
+        "_write_text_file",
+        "_write_simple_text_file",
+        "_write_csv_file",
+        "_write_json_file",
+        "_write_docx_file",
+        "_write_pdf_file",
+        "_normalize_notebook_source",
+        "_build_notebook_cell",
+    ]
+    missing = [name for name in expected if not hasattr(FileToolkit, name)]
+    assert not missing, f"FileToolkit missing hooks: {missing}"
+
+
+def test_file_toolkit_public_methods_signatures():
+    public = [
+        "write_to_file",
+        "read_file",
+        "edit_file",
+        "search_files",
+        "notebook_edit_cell",
+        "glob_files",
+        "grep_files",
+    ]
+    missing = [name for name in public if not hasattr(FileToolkit, name)]
+    assert not missing, f"FileToolkit missing public methods: {missing}"
+    for name in public:
+        sig = inspect.signature(getattr(FileToolkit, name))
+        assert "self" in sig.parameters
+
+
+def test_function_tool_constructible():
+
+    def sample() -> str:
+        return "ok"
+
+    tool = FunctionTool(sample)
+    assert tool is not None

python/tests/agents/camel/test_file.py

@@ -0,0 +1,99 @@
+# ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+
+import json
+
+import pytest
+
+from mirage import MountMode, Workspace
+from mirage.agents.camel import MirageFileToolkit
+from mirage.resource.ram import RAMResource
+
+
+@pytest.fixture
+def workspace():
+    ram = RAMResource()
+    yield Workspace({"/": ram}, mode=MountMode.WRITE)
+
+
+@pytest.fixture
+def toolkit(workspace):
+    tk = MirageFileToolkit(workspace)
+    yield tk
+    tk.close()
+
+
+def _strip_markdown_code_fence(text: str) -> str:
+    text = text.strip()
+    if text.startswith("```"):
+        lines = text.splitlines()
+        return "\n".join(
+            lines[1:-1] if lines[-1].startswith("```") else lines[1:])
+    return text
+
+
+def test_write_text_file_then_read(toolkit):
+    msg = toolkit.write_to_file(title="Hello",
+                                content="hi there",
+                                filename="/notes/hello.md")
+    assert "hello.md" in msg
+    out = toolkit.read_file(file_paths="/notes/hello.md")
+    assert "hi there" in out
+
+
+def test_write_json_file_then_read(toolkit):
+    msg = toolkit.write_to_file(title="data",
+                                content={
+                                    "a": 1,
+                                    "b": [2, 3]
+                                },
+                                filename="/data.json")
+    assert "data.json" in msg
+    out = toolkit.read_file(file_paths="/data.json")
+    parsed = json.loads(_strip_markdown_code_fence(out))
+    assert parsed == {"a": 1, "b": [2, 3]}
+
+
+def test_edit_file_replaces_content(toolkit):
+    toolkit.write_to_file(title="t", content="old\nkeep\n", filename="/e.txt")
+    msg = toolkit.edit_file(file_path="/e.txt",
+                            old_content="old",
+                            new_content="new")
+    assert "successfully" in msg.lower() or "edited" in msg.lower()
+    out = toolkit.read_file(file_paths="/e.txt")
+    assert "new" in out and "keep" in out and "old" not in out.split("keep")[0]
+
+
+def test_search_files_by_name(toolkit):
+    toolkit.write_to_file(title="a", content="x", filename="/dir/a.txt")
+    toolkit.write_to_file(title="b", content="y", filename="/dir/b.md")
+    out = toolkit.search_files(file_name="a.txt", path="/dir")
+    assert "a.txt" in out
+
+
+def test_glob_files(toolkit):
+    toolkit.write_to_file(title="a", content="x", filename="/g/x.py")
+    toolkit.write_to_file(title="a", content="y", filename="/g/y.py")
+    out = toolkit.glob_files(pattern="*.py", path="/g")
+    assert "x.py" in out and "y.py" in out
+
+
+def test_grep_files(toolkit):
+    toolkit.write_to_file(title="a",
+                          content="needle here\n",
+                          filename="/q/a.txt")
+    toolkit.write_to_file(title="b", content="haystack\n", filename="/q/b.txt")
+    out = toolkit.grep_files(pattern="needle", path="/q")
+    assert "needle" in out
+    assert "a.txt" in out

python/tests/agents/camel/test_terminal.py

@@ -0,0 +1,80 @@
+# ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+
+import pytest
+
+from mirage import MountMode, Workspace
+from mirage.agents.camel import MirageTerminalToolkit
+from mirage.resource.ram import RAMResource
+
+
+@pytest.fixture
+def workspace():
+    ram = RAMResource()
+    ws = Workspace({"/": ram}, mode=MountMode.WRITE)
+    yield ws
+
+
+@pytest.fixture
+def toolkit(workspace):
+    tk = MirageTerminalToolkit(workspace)
+    yield tk
+    tk.close()
+
+
+def test_shell_exec_blocking_returns_stdout(toolkit):
+    out = toolkit.shell_exec(id="t1", command="echo hello", block=True)
+    assert "hello" in out
+
+
+def test_shell_exec_blocking_captures_stderr(toolkit):
+    out = toolkit.shell_exec(id="t1",
+                             command="ls /nonexistent-zzz",
+                             block=True)
+    assert out, "expected non-empty output for failing command"
+
+
+def test_shell_write_content_to_file(toolkit, workspace):
+    msg = toolkit.shell_write_content_to_file(content="line1\nline2\n",
+                                              file_path="/note.txt")
+    assert "note.txt" in msg
+    out = toolkit.shell_exec(id="t1", command="cat /note.txt", block=True)
+    assert "line1" in out and "line2" in out
+
+
+def test_shell_exec_nonblocking_returns_session_id(toolkit):
+    msg = toolkit.shell_exec(id="bg1", command="sleep 0.5", block=False)
+    assert "bg1" in msg
+
+
+def test_shell_view_after_completion(toolkit):
+    toolkit.shell_exec(id="bg2", command="echo done", block=False)
+    out = toolkit.shell_view(id="bg2")
+    assert "done" in out
+
+
+def test_shell_kill_unknown_session(toolkit):
+    msg = toolkit.shell_kill_process(id="never-started")
+    assert "Error" in msg
+
+
+def test_shell_write_to_process_returns_clear_error(toolkit):
+    toolkit.shell_exec(id="bg3", command="sleep 0.5", block=False)
+    msg = toolkit.shell_write_to_process(id="bg3", command="anything")
+    assert "not interactive" in msg.lower()
+
+
+def test_get_tools_returns_six(toolkit):
+    tools = toolkit.get_tools()
+    assert len(tools) == 6