quanttide-agent 0.2.0__tar.gz → 0.2.3__tar.gz

{quanttide_agent-0.2.0 → quanttide_agent-0.2.3}/CHANGELOG.md

@@ -1,5 +1,21 @@
 # CHANGELOG
 
+## [0.2.1] - 2026-05-20
+## [0.2.3] - 2026-05-21
+
+### Fixed
+
+- 修复 Vault 密钥认证失败问题
+- 修复 pydantic-settings 依赖版本冲突
+
+## [0.2.2] - 2026-05-20
+
+- Fix: ActionParser fallback to {} when LLM returns invalid JSON
+
+
+- Fix: ReActAgent uses `role="user"` for tool results (DeepSeek API compat)
+- Add `LLM.complete()` method, deprecate `chat()` (removed in v0.3.0)
+
 ## [0.2.0] - 2026-05-20
 
 **Breaking changes:**

{quanttide_agent-0.2.0 → quanttide_agent-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: quanttide-agent
-Version: 0.2.0
+Version: 0.2.3
 Summary: 量潮智能体标准Python工具箱
 Author-email: "QuantTide Inc." <opensource@quanttide.com>
 License: Apache 2.0

quanttide_agent-0.2.3/ROADMAP.md

@@ -0,0 +1,19 @@
+# ROADMAP
+
+## v0.2.x — 已完成
+
+- [x] `LLM.complete()` 替换 `chat()`（chat 标记废弃，v0.3.0 移除）
+- [x] `ReActAgent` + `ActionParser` + `Tool` 进入标准库
+- [x] `config` 模块 with pydantic-settings + vault 支持
+- [x] `Usage.from_api()` 标准化字段
+- [x] 100% 测试覆盖率
+- [x] 在 `qtcloud-knowl` 项目中实地验证通过
+
+## v0.3.0 计划
+
+- 移除 `LLM.chat()`（v0.2.1 标记废弃，按约定 v0.3.0 移除）
+
+## 待考察
+
+- Streaming / Async — 有需求时再实现
+- Retry 策略细化 — 遇到重试误吞时再改

{quanttide_agent-0.2.0 → quanttide_agent-0.2.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "quanttide-agent"
-version = "0.2.0"
+version = "0.2.3"
 description = "量潮智能体标准Python工具箱"
 authors = [{name = "QuantTide Inc.", email = "opensource@quanttide.com"}]
 license = {text = "Apache 2.0"}

{quanttide_agent-0.2.0 → quanttide_agent-0.2.3}/src/quanttide_agent/agent.py

@@ -53,8 +53,10 @@ class ActionParser:
         raw = m.group(2).strip()
         try:
             inp = json.loads(raw)
+            if not isinstance(inp, dict):
+                inp = {}
         except json.JSONDecodeError:
-            inp = raw
+            inp = {}
         return Action(name=name, args=inp)
 
 
@@ -88,7 +90,7 @@ class ReActAgent:
     def run(self, messages: list[Message]) -> str:
         messages = list(messages)
         for _ in range(self.max_steps):
-            resp = self.llm.chat([m.to_dict() for m in messages])
+            resp = self.llm.complete([m.to_dict() for m in messages])
             output = resp.content.strip()
 
             if "Final Answer:" in output:
@@ -106,9 +108,7 @@ class ReActAgent:
 
             tool = self._tools.get(action.name)
             result = tool.execute(action.args) if tool else f"未知工具: {action.name}"
-            messages.append(
-                Message(role="tool", tool_call_id=action.name, content=result)
-            )
+            messages.append(Message(role="user", content=result))
 
         return "达到最大步数，未得到最终答案。"
 

{quanttide_agent-0.2.0 → quanttide_agent-0.2.3}/src/quanttide_agent/llm.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import warnings
 from typing import Any, Literal
 
 import httpx
@@ -25,7 +26,7 @@ class LLM:
     Usage::
 
         llm = LLM(model="deepseek-v4-pro", api_key="sk-...")
-        resp = llm.chat("Hello")
+        resp = llm.complete("Hello")
         print(resp.content)
     """
     def __init__(
@@ -45,7 +46,7 @@ class LLM:
             timeout=120,
         )
 
-    def chat(
+    def complete(
         self,
         messages: list[Message] | list[dict] | str,
         *,
@@ -135,3 +136,8 @@ class LLM:
             tool_calls=tool_calls,
             usage=usage,
         )
+
+    def chat(self, *args, **kwargs) -> ChatResponse:
+        """Deprecated: use complete() instead. Will be removed in v0.3.0."""
+        warnings.warn("LLM.chat() is deprecated, use LLM.complete() instead", DeprecationWarning, stacklevel=2)
+        return self.complete(*args, **kwargs)

{quanttide_agent-0.2.0 → quanttide_agent-0.2.3}/tests/test_agent.py

@@ -86,14 +86,14 @@ class TestTool:
 class TestReActAgent:
     def test_direct_answer(self):
         llm = MagicMock()
-        llm.chat.return_value = ChatResponse(content="Final Answer: done", model="deepseek")
+        llm.complete.return_value = ChatResponse(content="Final Answer: done", model="deepseek")
         agent = ReActAgent(llm, [], max_steps=5)
         result = agent.run([Message(role="user", content="hi")])
         assert result == "done"
 
     def test_tool_call_loop(self):
         llm = MagicMock()
-        llm.chat.side_effect = [
+        llm.complete.side_effect = [
             ChatResponse(content="Action name: test\nAction args: {}", model="deepseek"),
             ChatResponse(content="Final Answer: ok", model="deepseek"),
         ]
@@ -106,7 +106,7 @@ class TestReActAgent:
 
     def test_max_steps(self):
         llm = MagicMock()
-        llm.chat.return_value = ChatResponse(content="Action name: test\nAction args: {}", model="deepseek")
+        llm.complete.return_value = ChatResponse(content="Action name: test\nAction args: {}", model="deepseek")
         t = Tool(name="test", executor=lambda args: "ok")
         agent = ReActAgent(llm, [t], max_steps=2)
         result = agent.run([Message(role="user", content="x")])
@@ -114,7 +114,7 @@ class TestReActAgent:
 
     def test_malformed_action(self):
         llm = MagicMock()
-        llm.chat.side_effect = [
+        llm.complete.side_effect = [
             ChatResponse(content="乱写", model="deepseek"),
             ChatResponse(content="Final Answer: fixed", model="deepseek"),
         ]

{quanttide_agent-0.2.0 → quanttide_agent-0.2.3}/tests/test_llm.py

@@ -2,6 +2,7 @@ from __future__ import annotations
 
 import copy
 import json
+from unittest.mock import patch
 
 import httpx
 import pytest
@@ -57,17 +58,17 @@ class TestLLMInit:
 class TestChatStringInput:
     def test_returns_chat_response(self):
         llm, reqs = _make_llm()
-        resp = llm.chat("Hello")
+        resp = llm.complete("Hello")
         assert isinstance(resp, ChatResponse)
 
     def test_content(self):
         llm, reqs = _make_llm()
-        resp = llm.chat("Hello")
+        resp = llm.complete("Hello")
         assert resp.content == "Hello! How can I help?"
 
     def test_sends_correct_body(self):
         llm, reqs = _make_llm()
-        llm.chat("Hello")
+        llm.complete("Hello")
         body = _body(reqs[0])
         assert body["model"] == "deepseek-v4-pro"
         assert body["messages"][0]["role"] == "user"
@@ -81,12 +82,12 @@ class TestChatListInput:
             {"role": "system", "content": "You are helpful"},
             {"role": "user", "content": "Hi"},
         ]
-        resp = llm.chat(messages)
+        resp = llm.complete(messages)
         assert resp.content == "Hello! How can I help?"
 
     def test_sends_messages_in_body(self):
         llm, reqs = _make_llm()
-        llm.chat([{"role": "user", "content": "test"}])
+        llm.complete([{"role": "user", "content": "test"}])
         body = _body(reqs[0])
         assert len(body["messages"]) == 1
         assert body["messages"][0]["role"] == "user"
@@ -96,42 +97,42 @@ class TestChatListInput:
 class TestChatParameters:
     def test_temperature(self):
         llm, reqs = _make_llm()
-        llm.chat("Hi", temperature=0.7)
+        llm.complete("Hi", temperature=0.7)
         assert _body(reqs[0])["temperature"] == 0.7
 
     def test_max_tokens(self):
         llm, reqs = _make_llm()
-        llm.chat("Hi", max_tokens=100)
+        llm.complete("Hi", max_tokens=100)
         assert _body(reqs[0])["max_tokens"] == 100
 
     def test_top_p(self):
         llm, reqs = _make_llm()
-        llm.chat("Hi", top_p=0.9)
+        llm.complete("Hi", top_p=0.9)
         assert _body(reqs[0])["top_p"] == 0.9
 
     def test_stop_string(self):
         llm, reqs = _make_llm()
-        llm.chat("Hi", stop="\n")
+        llm.complete("Hi", stop="\n")
         assert _body(reqs[0])["stop"] == "\n"
 
     def test_stop_list(self):
         llm, reqs = _make_llm()
-        llm.chat("Hi", stop=["\n", "END"])
+        llm.complete("Hi", stop=["\n", "END"])
         assert _body(reqs[0])["stop"] == ["\n", "END"]
 
     def test_frequency_penalty(self):
         llm, reqs = _make_llm()
-        llm.chat("Hi", frequency_penalty=0.5)
+        llm.complete("Hi", frequency_penalty=0.5)
         assert _body(reqs[0])["frequency_penalty"] == 0.5
 
     def test_presence_penalty(self):
         llm, reqs = _make_llm()
-        llm.chat("Hi", presence_penalty=0.5)
+        llm.complete("Hi", presence_penalty=0.5)
         assert _body(reqs[0])["presence_penalty"] == 0.5
 
     def test_model_override(self):
         llm, reqs = _make_llm()
-        llm.chat("Hi", model="deepseek-chat")
+        llm.complete("Hi", model="deepseek-chat")
         assert _body(reqs[0])["model"] == "deepseek-chat"
 
     def test_tools(self):
@@ -139,46 +140,46 @@ class TestChatParameters:
         tools = [
             ToolSchema(name="get_weather", description="Get weather", parameters={"type": "object", "properties": {"location": {"type": "string"}}, "required": ["location"]}),
         ]
-        llm.chat("Weather?", tools=tools)
+        llm.complete("Weather?", tools=tools)
         assert "tools" in _body(reqs[0])
 
     def test_tool_choice(self):
         llm, reqs = _make_llm()
-        llm.chat("Hi", tool_choice="auto")
+        llm.complete("Hi", tool_choice="auto")
         assert _body(reqs[0])["tool_choice"] == "auto"
 
     def test_response_format(self):
         llm, reqs = _make_llm()
-        llm.chat("Hi", response_format={"type": "json_object"})
+        llm.complete("Hi", response_format={"type": "json_object"})
         assert _body(reqs[0])["response_format"] == {"type": "json_object"}
 
 
 class TestThinkingMode:
     def test_thinking_enabled(self):
         llm, reqs = _make_llm()
-        llm.chat("Hi", thinking=True)
+        llm.complete("Hi", thinking=True)
         assert _body(reqs[0])["thinking"] == {"type": "enabled"}
 
     def test_thinking_disabled(self):
         llm, reqs = _make_llm()
-        llm.chat("Hi", thinking=False)
+        llm.complete("Hi", thinking=False)
         assert _body(reqs[0])["thinking"] == {"type": "disabled"}
 
     def test_reasoning_effort(self):
         llm, reqs = _make_llm()
-        llm.chat("Hi", reasoning_effort="high")
+        llm.complete("Hi", reasoning_effort="high")
         assert _body(reqs[0])["reasoning_effort"] == "high"
 
     def test_parses_reasoning_content(self):
         mock = copy.deepcopy(MOCK_CHAT_RESPONSE)
         mock["choices"][0]["message"]["reasoning_content"] = "I need to think..."
         llm, reqs = _make_llm(mock)
-        resp = llm.chat("Hi", thinking=True)
+        resp = llm.complete("Hi", thinking=True)
         assert resp.reasoning_content == "I need to think..."
 
     def test_no_reasoning_content_by_default(self):
         llm, reqs = _make_llm()
-        resp = llm.chat("Hi")
+        resp = llm.complete("Hi")
         assert resp.reasoning_content is None
 
 
@@ -194,7 +195,7 @@ class TestToolCalls:
         ]
         mock["choices"][0]["message"]["content"] = None
         llm, reqs = _make_llm(mock)
-        resp = llm.chat("Weather?")
+        resp = llm.complete("Weather?")
         assert resp.tool_calls is not None
         assert len(resp.tool_calls) == 1
         assert resp.tool_calls[0].name == "get_weather"
@@ -202,14 +203,14 @@ class TestToolCalls:
 
     def test_no_tool_calls_by_default(self):
         llm, reqs = _make_llm()
-        resp = llm.chat("Hi")
+        resp = llm.complete("Hi")
         assert resp.tool_calls is None
 
 
 class TestUsage:
     def test_parses_usage(self):
         llm, reqs = _make_llm()
-        resp = llm.chat("Hi")
+        resp = llm.complete("Hi")
         assert resp.usage is not None
         assert resp.usage.input_tokens == 10
         assert resp.usage.output_tokens == 5
@@ -217,21 +218,21 @@ class TestUsage:
 
     def test_finish_reason(self):
         llm, reqs = _make_llm()
-        resp = llm.chat("Hi")
+        resp = llm.complete("Hi")
         assert resp.finish_reason == "stop"
 
     def test_no_usage(self):
         mock = copy.deepcopy(MOCK_CHAT_RESPONSE)
         del mock["usage"]
         llm, reqs = _make_llm(mock)
-        resp = llm.chat("Hi")
+        resp = llm.complete("Hi")
         assert resp.usage is None
 
     def test_partial_usage(self):
         mock = copy.deepcopy(MOCK_CHAT_RESPONSE)
         mock["usage"] = {"prompt_tokens": 10}
         llm, reqs = _make_llm(mock)
-        resp = llm.chat("Hi")
+        resp = llm.complete("Hi")
         assert resp.usage is not None
         assert resp.usage.input_tokens == 10
         assert resp.usage.output_tokens == 0
@@ -243,21 +244,21 @@ class TestModel:
         mock = copy.deepcopy(MOCK_CHAT_RESPONSE)
         mock["model"] = "deepseek-chat"
         llm, reqs = _make_llm(mock)
-        resp = llm.chat("Hi")
+        resp = llm.complete("Hi")
         assert resp.model == "deepseek-chat"
 
     def test_model_fallback_to_constructor(self):
         mock = copy.deepcopy(MOCK_CHAT_RESPONSE)
         del mock["model"]
         llm, reqs = _make_llm(mock)
-        resp = llm.chat("Hi")
+        resp = llm.complete("Hi")
         assert resp.model == "deepseek-v4-pro"
 
 
 class TestRetry:
     def test_no_retry_on_success(self):
         llm, reqs = _make_llm()
-        llm.chat("Hi", retry=2)
+        llm.complete("Hi", retry=2)
         assert len(reqs) == 1
 
     def test_retry_then_success(self):
@@ -275,7 +276,7 @@ class TestRetry:
         transport = httpx.MockTransport(handler)
         client = httpx.Client(transport=transport, base_url="http://test")
         llm = LLM(model="deepseek-v4-pro", api_key="sk-test", _http_client=client)
-        resp = llm.chat("Hi", retry=3)
+        resp = llm.complete("Hi", retry=3)
         assert resp.content == "Hello! How can I help?"
         assert len(requests) == 3
 
@@ -287,7 +288,7 @@ class TestRetry:
         client = httpx.Client(transport=transport, base_url="http://test")
         llm = LLM(model="deepseek-v4-pro", api_key="sk-test", _http_client=client)
         with pytest.raises(LLMError, match="chat failed after retries"):
-            llm.chat("Hi", retry=2)
+            llm.complete("Hi", retry=2)
 
     def test_zero_retry_fails_once(self):
         requests: list[httpx.Request] = []
@@ -300,7 +301,7 @@ class TestRetry:
         client = httpx.Client(transport=transport, base_url="http://test")
         llm = LLM(model="deepseek-v4-pro", api_key="sk-test", _http_client=client)
         with pytest.raises(LLMError):
-            llm.chat("Hi", retry=0)
+            llm.complete("Hi", retry=0)
         assert len(requests) == 1
 
 
@@ -341,7 +342,7 @@ class TestAPIConnection:
         transport = httpx.MockTransport(handler)
         client = httpx.Client(transport=transport, base_url="http://test")
         llm = LLM(model="m", api_key="k", _http_client=client)
-        llm.chat("Hi")
+        llm.complete("Hi")
         assert requests[0].url.path == "/chat/completions"
 
 
@@ -350,12 +351,93 @@ class TestEdgeCases:
         mock = copy.deepcopy(MOCK_CHAT_RESPONSE)
         mock["choices"][0]["message"]["content"] = ""
         llm, reqs = _make_llm(mock)
-        resp = llm.chat("Hi")
+        resp = llm.complete("Hi")
         assert resp.content == ""
 
     def test_none_content_in_response(self):
         mock = copy.deepcopy(MOCK_CHAT_RESPONSE)
         mock["choices"][0]["message"]["content"] = None
         llm, reqs = _make_llm(mock)
-        resp = llm.chat("Hi")
+        resp = llm.complete("Hi")
         assert resp.content == ""
+
+
+class TestMessageInput:
+    def test_message_list(self):
+        from quanttide_agent import Message
+
+        llm, reqs = _make_llm()
+        resp = llm.complete([Message(role="user", content="Hi")])
+        assert resp.content == "Hello! How can I help?"
+        assert b"Hi" in reqs[0].read()
+
+
+class TestChatDeprecated:
+    def test_chat_warns(self):
+        llm, reqs = _make_llm()
+        import warnings
+
+        with warnings.catch_warnings(record=True) as w:
+            warnings.simplefilter("always")
+            resp = llm.chat("Hi")
+            assert len(w) == 1
+            assert issubclass(w[0].category, DeprecationWarning)
+            assert "complete()" in str(w[0].message)
+            assert resp.content == "Hello! How can I help?"
+
+
+class TestBaseUrlTrailingSlash:
+    def test_trailing_slash_stripped(self):
+        transport = httpx.MockTransport(lambda r: httpx.Response(200, json=MOCK_CHAT_RESPONSE))
+        client = httpx.Client(transport=transport, base_url="http://test")
+        llm = LLM(model="test", base_url="http://test/", api_key="k", _http_client=client)
+        assert str(llm._client.base_url) == "http://test"
+
+
+class TestActionParserEdgeCases:
+    def test_non_dict_json_fallback(self):
+        from quanttide_agent.agent import ActionParser
+
+        p = ActionParser()
+        result = p.parse('Action name: test\nAction args: []')
+        assert result is not None
+        assert result.name == "test"
+        assert result.args == {}
+
+    def test_invalid_json_fallback(self):
+        from quanttide_agent.agent import ActionParser
+
+        p = ActionParser()
+        result = p.parse('Action name: test\nAction args: not-json')
+        assert result is not None
+        assert result.name == "test"
+        assert result.args == {}
+
+
+class TestUsageFromApi:
+    def test_empty_dict(self):
+        from quanttide_agent.cost import Usage
+
+        u = Usage.from_api({"prompt_tokens": 0})
+        assert u is not None
+        assert u.input_tokens == 0
+
+    def test_none_data(self):
+        from quanttide_agent.cost import Usage
+
+        assert Usage.from_api(None) is None
+        assert Usage.from_api({}) is None
+
+
+class TestConfigVaultFallback:
+    def test_import_fallback(self):
+        import importlib
+        import sys
+
+        with patch.dict(sys.modules, {"pydantic_vault": None}):
+            if "quanttide_agent.config" in sys.modules:
+                del sys.modules["quanttide_agent.config"]
+            mod = importlib.import_module("quanttide_agent.config")
+            importlib.reload(mod)
+            assert mod._HAS_VAULT is False
+            assert mod.VaultSettingsSource is None

quanttide_agent-0.2.0/ROADMAP.md

@@ -1,26 +0,0 @@
-# ROADMAP
-
-## v0.2.x 目标
-
-- [ ] 确认 v0.2.0 在实际项目中的兼容性
-- [ ] 收集使用反馈
-
-## 待考察方向
-
-以下问题暂不排期。
-
-### Provider 特化参数
-
-`chat()` 的 `thinking` / `reasoning_effort` 参数是 DeepSeek 特化的。
-
-- 触发条件：需要支持 DeepSeek 以外的 Provider
-
-### Streaming / Async
-
-- 触发条件：有项目需要流式输出
-
-### Retry 策略
-
-当前对所有 4xx/5xx 统一重试。
-
-- 触发条件：实际遇到重试误吞问题