studytrails 0.2.2__tar.gz → 0.2.3__tar.gz

{studytrails-0.2.2 → studytrails-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: studytrails
-Version: 0.2.2
+Version: 0.2.3
 Summary: A personal multi-subject AI study coach with tools, local progress, and an offline demo.
 License-Expression: MIT
 License-File: LICENSE
@@ -33,7 +33,9 @@ may be another provider, such as Groq. Users may configure other model families.
 
 - Interactive provider, model, and hidden API-key setup.
 - OpenAI-compatible Chat Completions endpoints with tool-calling models.
-- OpenAI and Groq address presets; custom compatible endpoints supported.
+- OpenAI, Groq, and DeepSeek presets; custom compatible endpoints supported.
+- Formatted coach answers with readable headings, lists, and code blocks.
+- Explicit y/n prompts with input validation and a safe default of no.
 - Multi-subject coaching and subject-specific note retrieval.
 - Paste notes or import UTF-8 `.md` and `.txt` files up to 200 KB.
 - Multiple-choice quizzes, explanations, and local SQLite progress.
@@ -52,6 +54,7 @@ studytrails scores
 studytrails pending
 studytrails demo
 studytrails doctor
+studytrails --version
 ```
 
 Run `studytrails doctor` to see the personal storage location. Existing source

{studytrails-0.2.2 → studytrails-0.2.3}/README.md

@@ -53,7 +53,7 @@ the command so it can run from any directory without activating a virtual enviro
 Welcome to StudyTrail!
 Learn from your notes. Practise with quizzes. Track your progress.
 
-Configure AI now? [y/N]:
+Configure AI now? [y/n] (Enter = no):
 
 1. Start learning  2. Manage notes  3. View progress
 4. Configure AI  5. Pending quizzes  6. Offline demo  0. Exit
@@ -61,7 +61,7 @@ Configure AI now? [y/N]:
 
 Choose **Configure AI** to supply:
 
-1. An OpenAI-compatible custom endpoint, or the OpenAI/Groq address preset.
+1. An OpenAI-compatible custom endpoint, or the OpenAI/Groq/DeepSeek preset.
 2. The exact model ID from your provider. It must support Chat Completions tool calling.
 3. Your API key, entered with hidden input.
 
@@ -75,10 +75,19 @@ and may consume paid quota. Skipping it saves unverified settings. Provider
 compatibility is covered with mocked HTTP tests; no live cross-provider certification
 is claimed.
 
-Keys are saved using a supported operating-system credential store. They are never
+Keys are saved using a supported operating-system credential store. They are never
 written to `config.json`. If your machine has no usable credential store, supply
 `STUDYTRAIL_API_KEY` through your environment and rerun setup. There is no plaintext
-fallback. Run `studytrails config` to change providers or models later.
+fallback. Run `studytrails config` to change providers or models later.
+
+For DeepSeek, choose **4** and press Enter to use `deepseek-flash`, or enter a
+current model ID from your DeepSeek account. Paste your DeepSeek API key at the
+hidden prompt. StudyTrail uses non-thinking mode with DeepSeek. See the
+[DeepSeek API documentation](https://api-docs.deepseek.com/) for models and pricing.
+
+Yes/no prompts display `[y/n]`: enter `y` for yes, `n` for no, or press Enter for no.
+Coach replies render Markdown headings, lists, and code blocks in both chat and
+single-question mode.
 
 **Free app does not mean free API.** Offline features need no API calls. Live
 coaching uses your provider's free allowance or paid plan. StudyTrail cannot inspect
@@ -132,8 +141,9 @@ studytrails scores
 studytrails pending
 studytrails quiz QUIZ_ID
 studytrails demo
-studytrails doctor
-studytrails --help
+studytrails doctor
+studytrails --version
+studytrails --help
 ```
 
 Add `--demo` to `scores`, `pending`, or `quiz QUIZ_ID` to use demo progress.

{studytrails-0.2.2 → studytrails-0.2.3}/docs/PYPI.md

@@ -18,7 +18,9 @@ may be another provider, such as Groq. Users may configure other model families.
 
 - Interactive provider, model, and hidden API-key setup.
 - OpenAI-compatible Chat Completions endpoints with tool-calling models.
-- OpenAI and Groq address presets; custom compatible endpoints supported.
+- OpenAI, Groq, and DeepSeek presets; custom compatible endpoints supported.
+- Formatted coach answers with readable headings, lists, and code blocks.
+- Explicit y/n prompts with input validation and a safe default of no.
 - Multi-subject coaching and subject-specific note retrieval.
 - Paste notes or import UTF-8 `.md` and `.txt` files up to 200 KB.
 - Multiple-choice quizzes, explanations, and local SQLite progress.
@@ -37,6 +39,7 @@ studytrails scores
 studytrails pending
 studytrails demo
 studytrails doctor
+studytrails --version
 ```
 
 Run `studytrails doctor` to see the personal storage location. Existing source

{studytrails-0.2.2 → studytrails-0.2.3}/docs/RELEASING.md

@@ -1,7 +1,8 @@
 # Releasing StudyTrail
 
 The distribution name is `studytrails`; the import remains `study_agent`.
-Versions 0.2.0 and 0.2.1 are published on PyPI. Version 0.2.2 is the next local candidate.
+Version 0.2.2 is published on PyPI. Version 0.2.3 is the next local candidate,
+adding a DeepSeek preset, formatted coach replies, visible y/n prompts, and `--version`.
 Build, tests, and CI do not publish a release.
 
 ## Before each release
@@ -52,7 +53,7 @@ blindly combining indexes for production installs.
 For a manual release, first review the files listed under `dist/`, then publish:
 
 ```powershell
-uv publish
+uv publish dist/studytrails-0.2.3-py3-none-any.whl dist/studytrails-0.2.3.tar.gz
 ```
 
 Supply authentication securely as documented by uv. This command publishes publicly;

{studytrails-0.2.2 → studytrails-0.2.3}/docs/SETUP.md

@@ -93,12 +93,21 @@ You will need:
 3. A model ID that your provider account can access and that supports
    OpenAI-compatible Chat Completions with tool calling.
 
-StudyTrail offers address presets for OpenAI and Groq. A preset only fills in the
-provider address; it does not provide a key or guarantee every model will work.
+StudyTrail offers presets for OpenAI, Groq, and DeepSeek. These fill in the
+provider address; they do not provide a key or guarantee every model will work.
 For another compatible service, choose the custom endpoint option and enter its
 API base URL and model ID. StudyTrail cannot use provider APIs with an incompatible
 request format in this release.
 
+For DeepSeek: choose provider **4**, press Enter at the model prompt to accept
+`deepseek-flash`, and paste your own key from
+[DeepSeek API keys](https://platform.deepseek.com/api_keys). You may enter another
+current tool-calling model ID from your account. StudyTrail uses non-thinking mode
+for DeepSeek. Its API may require paid credit; check your provider account.
+
+At every `[y/n]` prompt, type `y` for yes or `n` for no. Pressing Enter selects no.
+You can also type `yes` or `no`; other answers prompt you to try again.
+
 The key prompt is hidden while you type. Paste the key only into that prompt. Do
 not paste it into the provider number or model prompt, a command line, this guide,
 or a public issue. Setup can make an optional small connection test; the request
@@ -154,6 +163,9 @@ The macOS/Linux activation command is `source .venv/bin/activate`. If you used
 
 ## 6. Find your notes and progress
 
+Check the installed release with `studytrails --version`. This command is available
+from version 0.2.3 onward and does not require an API key.
+
 Run this command from an activated environment or uv tool installation:
 
 ```text

{studytrails-0.2.2 → studytrails-0.2.3}/docs/USER_GUIDE.md

@@ -1,6 +1,16 @@
 # StudyTrail user guide
 
-## Setup and storage
+## Setup and storage
+
+Provider 4 is DeepSeek (`https://api.deepseek.com`). Its suggested model is
+`deepseek-flash`; press Enter to accept it or enter a current model ID from your
+account. Both study requests and the optional connection test use non-thinking
+mode with DeepSeek. See [DeepSeek's tool-calling guide](https://api-docs.deepseek.com/guides/tool_calls/).
+An API key and any required account credit must be supplied by the user.
+
+All yes/no prompts display `[y/n] (Enter = no)`. They accept y/yes and n/no,
+case-insensitively, and reprompt for other input. Chat and `ask` render Markdown
+headings, lists, and code examples, retaining note citations.
 
 Run `studytrails` to open the menu, or `studytrails config` to configure AI directly.
 Choose a provider preset or enter an OpenAI-compatible Chat Completions base URL.

{studytrails-0.2.2 → studytrails-0.2.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "studytrails"
-version = "0.2.2"
+version = "0.2.3"
 description = "A personal multi-subject AI study coach with tools, local progress, and an offline demo."
 readme = "docs/PYPI.md"
 license = "MIT"

{studytrails-0.2.2 → studytrails-0.2.3}/study_agent/agent.py

@@ -7,16 +7,20 @@ from openai import OpenAI
 from pydantic import ValidationError
 
 from .config import Settings
+from .providers import chat_options
 from .tools import StudyTools, tool_definitions
 
-INSTRUCTIONS = """You are a practical personal multi-subject study coach for a beginner.
-StudyTrail was created by Yash Patil. If asked who created or made StudyTrail, say
-Yash Patil created the StudyTrail application and is learning Python and AI. The AI
-model is supplied by the provider configured by this user; credit OpenAI for an
-OpenAI model such as GPT-OSS, and name the configured provider as its API host when
-appropriate. Do not claim OpenAI created StudyTrail or guess other personal details
-about Yash Patil.
-Use plain English. Help the learner understand, practise, and improve.
+INSTRUCTIONS = """You are a practical personal multi-subject study coach for a beginner.
+StudyTrail was created by Yash Patil. If asked who created or made StudyTrail, say
+Yash Patil created the StudyTrail application and is learning Python and AI. The AI
+model is supplied by the provider configured by this user; credit OpenAI for an
+OpenAI model such as GPT-OSS, and name the configured provider as its API host when
+appropriate. Do not claim OpenAI created StudyTrail or guess other personal details
+about Yash Patil.
+Use plain English. Help the learner understand, practise, and improve.
+Format replies with short paragraphs and brief Markdown headings when helpful.
+Use bullets for steps and fenced code blocks with a language name for code examples.
+Avoid wide tables, excessive headings, and long walls of text. Keep note citations intact.
 For practice recommendations, inspect get_scores first. Search local notes for the
 chosen topic before teaching or creating a quiz. Use recent attempts as well as totals.
 If no scores exist, say so and start at beginner level. Respect the learner's chosen topic.
@@ -84,8 +88,7 @@ class StudyAgent:
                 model=self.settings.model,
                 messages=[{"role": "system", "content": self.instructions}, *messages],
                 tools=tool_definitions(),
-                parallel_tool_calls=False,
-                max_completion_tokens=2400,
+                **chat_options(self.settings.base_url),
             )
             choice = response.choices[0]
             if choice.finish_reason not in {"stop", "tool_calls"}:

{studytrails-0.2.2 → studytrails-0.2.3}/study_agent/cli.py

@@ -2,6 +2,7 @@
 
 import argparse
 import sqlite3
+from importlib.metadata import version
 
 from openai import APIConnectionError, APIError, APIStatusError, AuthenticationError, RateLimitError
 from rich.console import Console
@@ -14,12 +15,18 @@ from .onboarding import configure, ensure_notes, manage_notes, subject_slug
 from .preferences import data_root
 from .storage import Store
 from .tools import StudyTools
+from .ui import confirm, show_answer
 
 console = Console(markup=False, highlight=False)
 
 
 def trace(name: str) -> None:
-    console.print(f"  Tool: {name}", style="dim")
+    labels = {
+        "get_scores": "Checking your progress...",
+        "search_notes": "Searching your notes...",
+        "create_quiz": "Preparing your quiz...",
+    }
+    console.print(f"  {labels.get(name, name)}", style="dim")
 
 
 def show_scores(store: Store) -> None:
@@ -78,7 +85,7 @@ def offer_quizzes(tools: StudyTools) -> None:
         if tools.store.is_completed(quiz_id):
             continue
         console.print(f"Quiz ready: {quiz_id}")
-        if console.input("Take it now? [y/N]: ").strip().lower() in {"y", "yes"}:
+        if confirm(console, "Take it now?"):
             take_quiz(tools.store, quiz_id)
         else:
             console.print(f"Saved for later: studytrails quiz {quiz_id}")
@@ -134,7 +141,7 @@ def chat(settings: Settings, tools: StudyTools) -> None:
         try:
             with console.status("Coach is working..."):
                 answer = agent.run(goal)
-            console.print(f"\nCoach: {answer}")
+            show_answer(console, answer)
             offer_quizzes(tools)
         except (ValueError, RuntimeError, APIError) as exc:
             console.print(f"Error: {describe_error(exc)}", style="red")
@@ -157,6 +164,12 @@ def build_parser() -> argparse.ArgumentParser:
     parser = argparse.ArgumentParser(
         description="StudyTrail: your personal multi-subject AI study coach."
     )
+    parser.add_argument(
+        "--version",
+        action="version",
+        version=f"studytrails {version('studytrails')}",
+        help="Show the installed version and exit.",
+    )
     commands = parser.add_subparsers(dest="command")
     commands.add_parser("demo", help="Try a fixed offline quiz; no API key or network required.")
     live = commands.add_parser("chat", help="Start the live tool-using AI coach.")
@@ -188,7 +201,7 @@ def menu(settings: Settings) -> None:
     ensure_notes(settings.root)
     if not settings.api_key:
         console.print("No API key configured. Offline notes, scores, and demo remain available.")
-        if console.input("Configure AI now? [y/N]: ").strip().lower() in {"y", "yes"}:
+        if confirm(console, "Configure AI now?"):
             settings = configure(console, settings.root)
     while True:
         console.print("\n1. Start learning  2. Manage notes  3. View progress")
@@ -281,7 +294,7 @@ def main() -> int:
                 chat(settings, tools)
             case "ask":
                 answer = StudyAgent(settings, tools, trace).run(args.goal)
-                console.print(f"\nCoach: {answer}")
+                show_answer(console, answer)
                 offer_quizzes(tools)
             case "scores":
                 show_scores(store)

{studytrails-0.2.2 → studytrails-0.2.3}/study_agent/onboarding.py

@@ -9,18 +9,21 @@ from pathlib import Path
 from uuid import uuid4
 
 from openai import OpenAI
+from rich.text import Text
 
 from .config import Settings
 from .preferences import PRESETS, save_settings, validate_base_url
+from .providers import chat_options
+from .ui import confirm
 
 
 def configure(console, root: Path) -> Settings:
     console.print("\nConfigure StudyTrail | bring your own API")
-    console.print("1. OpenAI-compatible custom endpoint  2. OpenAI  3. Groq")
-    selection = console.input("Provider [1]: ").strip() or "1"
-    providers = {"1": "custom", "2": "openai", "3": "groq"}
+    console.print("1. OpenAI-compatible custom endpoint\n2. OpenAI\n3. Groq\n4. DeepSeek")
+    selection = console.input(Text("Provider [1]: ")).strip() or "1"
+    providers = {"1": "custom", "2": "openai", "3": "groq", "4": "deepseek"}
     if selection not in providers:
-        raise ValueError("Choose 1, 2, or 3.")
+        raise ValueError("Choose 1, 2, 3, or 4.")
     provider = providers[selection]
     base_url = PRESETS.get(provider)
     if base_url is None:
@@ -28,7 +31,12 @@ def configure(console, root: Path) -> Settings:
     base_url = validate_base_url(base_url)
     console.print(f"Your key and study requests will be sent to: {base_url}")
     console.print("Use a model supporting Chat Completions function/tool calling.")
-    model = console.input("Model ID from your provider: ").strip()
+    if provider == "deepseek":
+        console.print("DeepSeek API key: https://platform.deepseek.com/api_keys")
+        console.print("StudyTrail uses DeepSeek in non-thinking mode. API charges may apply.")
+        model = console.input(Text("Model ID [deepseek-flash]: ")).strip() or "deepseek-flash"
+    else:
+        model = console.input("Model ID from your provider: ").strip()
     env_key = os.getenv("STUDYTRAIL_API_KEY", "").strip()
     key = env_key
     if not key:
@@ -44,7 +52,7 @@ def configure(console, root: Path) -> Settings:
     settings = Settings(root=root, provider=provider, base_url=base_url, model=model, api_key=key)
     settings.require_api()
     console.print("An optional connection test uses API quota and may incur provider charges.")
-    if console.input("Test tool calling now? [y/N]: ").strip().lower() in {"y", "yes"}:
+    if confirm(console, "Test tool calling now?"):
         probe_provider(settings)
         console.print("Tool-calling test passed.")
     else:
@@ -76,8 +84,7 @@ def probe_provider(settings: Settings) -> None:
                 }
             ],
             tool_choice={"type": "function", "function": {"name": "connection_check"}},
-            parallel_tool_calls=False,
-            max_completion_tokens=2400,
+            **chat_options(settings.base_url),
         )
         if not result.choices or not any(
             call.function.name == "connection_check"

{studytrails-0.2.2 → studytrails-0.2.3}/study_agent/preferences.py

@@ -10,7 +10,11 @@ from keyring.errors import KeyringError
 from platformdirs import user_data_path
 
 PROJECT_ROOT = Path(__file__).resolve().parent.parent
-PRESETS = {"openai": "https://api.openai.com/v1", "groq": "https://api.groq.com/openai/v1"}
+PRESETS = {
+    "openai": "https://api.openai.com/v1",
+    "groq": "https://api.groq.com/openai/v1",
+    "deepseek": "https://api.deepseek.com",
+}
 
 
 def data_root() -> Path:

studytrails-0.2.3/study_agent/providers.py

@@ -0,0 +1,10 @@
+"""Request options for the supported Chat Completions endpoints."""
+
+from urllib.parse import urlsplit
+
+
+def chat_options(base_url: str) -> dict:
+    if urlsplit(base_url).hostname == "api.deepseek.com":
+        # DeepSeek uses max_tokens; forced tool choice needs non-thinking mode.
+        return {"max_tokens": 2400, "extra_body": {"thinking": {"type": "disabled"}}}
+    return {"max_completion_tokens": 2400, "parallel_tool_calls": False}

studytrails-0.2.3/study_agent/ui.py

@@ -0,0 +1,21 @@
+"""Shared terminal prompts and readable coach output."""
+
+from rich.console import Console
+from rich.markdown import Markdown
+from rich.text import Text
+
+
+def confirm(console: Console, question: str) -> bool:
+    while True:
+        answer = console.input(Text(f"{question} [y/n] (Enter = no): ")).strip().lower()
+        if answer in {"y", "yes"}:
+            return True
+        if answer in {"", "n", "no"}:
+            return False
+        console.print("Please enter y for yes or n for no.")
+
+
+def show_answer(console: Console, answer: str) -> None:
+    console.print("\nCoach", style="bold cyan")
+    console.print(Markdown(answer, hyperlinks=False), width=min(console.width, 100))
+    console.print()

{studytrails-0.2.2 → studytrails-0.2.3}/tests/test_agent.py

@@ -39,7 +39,7 @@ class ScriptedClient:
         return next(self.queue)
 
 
-def test_agent_uses_observations_and_creates_real_quiz(tools, quiz):
+def test_agent_uses_observations_and_creates_real_quiz(tools, quiz):
     client = ScriptedClient(
         [
             response(call("get_scores")),
@@ -56,10 +56,10 @@ def test_agent_uses_observations_and_creates_real_quiz(tools, quiz):
     assert json.loads(observations[0]["content"])["completed_quizzes"] == 0
     assert "loops.md" in observations[1]["content"]
     assert len(tools.store.pending_quizzes()) == 1
-    assert tools.store.get_scores()["completed_quizzes"] == 0
-
-
-def test_bad_tool_arguments_return_feedback_and_allow_recovery(tools):
+    assert tools.store.get_scores()["completed_quizzes"] == 0
+
+
+def test_bad_tool_arguments_return_feedback_and_allow_recovery(tools):
     client = ScriptedClient(
         [
             response(call("search_notes", "not-json")),
@@ -112,10 +112,17 @@ def test_chat_keeps_only_three_complete_turns(tools):
 
 @pytest.mark.parametrize(
     "base_url",
-    ["https://api.groq.com/openai/v1", "https://api.openai.com/v1", "https://custom.example/v1"],
+    [
+        "https://api.groq.com/openai/v1",
+        "https://api.openai.com/v1",
+        "https://custom.example/v1",
+        "https://api.deepseek.com",
+    ],
 )
 def test_actual_sdk_sends_tool_loop_to_configured_endpoint(tools, monkeypatch, base_url):
     requests = []
+    deepseek = base_url == "https://api.deepseek.com"
+    model = "deepseek-flash" if deepseek else "openai/gpt-oss-120b"
 
     def handler(request):
         assert str(request.url) == base_url + "/chat/completions"
@@ -132,7 +139,7 @@ def test_actual_sdk_sends_tool_loop_to_configured_endpoint(tools, monkeypatch, b
                 "id": f"chatcmpl_{len(requests)}",
                 "object": "chat.completion",
                 "created": 0,
-                "model": "openai/gpt-oss-120b",
+                "model": model,
                 "choices": [
                     {
                         "index": 0,
@@ -147,10 +154,21 @@ def test_actual_sdk_sends_tool_loop_to_configured_endpoint(tools, monkeypatch, b
         monkeypatch.setattr(
             "study_agent.agent.OpenAI", lambda **kwargs: OpenAI(http_client=http, **kwargs)
         )
-        agent = StudyAgent(Settings(api_key="test-not-a-real-key", base_url=base_url), tools)
+        agent = StudyAgent(
+            Settings(api_key="test-not-a-real-key", base_url=base_url, model=model), tools
+        )
         assert agent.run("Suggest practice") == "Start with loops."
-    assert requests[0]["model"] == "openai/gpt-oss-120b"
-    assert requests[0]["parallel_tool_calls"] is False
+    assert requests[0]["model"] == model
+    for request in requests:
+        if deepseek:
+            assert request["max_tokens"] == 2400
+            assert request["thinking"] == {"type": "disabled"}
+            assert "max_completion_tokens" not in request
+            assert "parallel_tool_calls" not in request
+        else:
+            assert request["parallel_tool_calls"] is False
+            assert request["max_completion_tokens"] == 2400
+            assert "thinking" not in request
     assert "input" not in requests[0]
     assert "store" not in requests[0]
     assert requests[0]["tools"][0]["function"]["name"] == "get_scores"

{studytrails-0.2.2 → studytrails-0.2.3}/tests/test_onboarding.py

@@ -131,10 +131,16 @@ def test_failed_probe_does_not_replace_config(tmp_path, monkeypatch, vault):
 
 
 @pytest.mark.parametrize("supported", [True, False])
-def test_connection_probe_checks_actual_tool_response(tmp_path, monkeypatch, supported):
+@pytest.mark.parametrize("base_url", ["https://provider.example/v1", "https://api.deepseek.com"])
+def test_connection_probe_checks_actual_tool_response(tmp_path, monkeypatch, supported, base_url):
     def handler(request):
-        assert str(request.url) == "https://provider.example/v1/chat/completions"
+        assert str(request.url) == base_url + "/chat/completions"
         payload = json.loads(request.content)
+        if base_url == "https://api.deepseek.com":
+            assert payload["thinking"] == {"type": "disabled"}
+            assert payload["max_tokens"] == 2400
+            assert "max_completion_tokens" not in payload
+            assert "parallel_tool_calls" not in payload
         assert payload["tool_choice"]["function"]["name"] == "connection_check"
         assert payload["model"] == "tool-model"
         message = {"role": "assistant", "content": "Hello"}
@@ -169,7 +175,7 @@ def test_connection_probe_checks_actual_tool_response(tmp_path, monkeypatch, sup
         )
         settings = Settings(
             root=tmp_path,
-            base_url="https://provider.example/v1",
+            base_url=base_url,
             model="tool-model",
             api_key="fake-key",
         )
@@ -269,3 +275,24 @@ def test_import_notes_and_reject_pdf(tmp_path, monkeypatch):
     answers = iter(["2", "java", "book", "book.pdf"])
     with pytest.raises(ValueError, match="UTF-8"):
         onboarding.manage_notes(console, tmp_path)
+
+
+def test_deepseek_setup_default_model_and_literal_prompts(tmp_path, monkeypatch, vault):
+    import sys
+
+    output = StringIO()
+    console = Console(file=output, width=100)
+    monkeypatch.setattr(sys, "stdin", StringIO("4\n\nmaybe\nn\n"))
+    monkeypatch.setattr(onboarding, "getpass", lambda *args: "deepseek-test-secret")
+    settings = onboarding.configure(console, tmp_path)
+    loaded = Settings.load()
+    assert loaded.provider == settings.provider == "deepseek"
+    assert loaded.base_url == "https://api.deepseek.com"
+    assert loaded.model == "deepseek-flash"
+    assert loaded.api_key == "deepseek-test-secret"
+    assert "deepseek-test-secret" not in output.getvalue()
+    assert "deepseek-test-secret" not in (tmp_path / "config.json").read_text()
+    assert "Provider [1]:" in output.getvalue()
+    assert "Model ID [deepseek-flash]:" in output.getvalue()
+    assert "[y/n] (Enter = no):" in output.getvalue()
+    assert "Please enter y for yes or n for no." in output.getvalue()

studytrails-0.2.3/tests/test_ui.py

@@ -0,0 +1,32 @@
+import sys
+from io import StringIO
+
+import pytest
+from rich.console import Console
+
+from study_agent.ui import confirm, show_answer
+
+
+@pytest.mark.parametrize(
+    ("answer", "expected"), [("y", True), ("YES", True), ("n", False), ("No", False), ("", False)]
+)
+def test_confirmation_keeps_choices_visible_and_accepts_answers(monkeypatch, answer, expected):
+    output = StringIO()
+    monkeypatch.setattr(sys, "stdin", StringIO(answer + "\n"))
+    assert confirm(Console(file=output), "Continue?") is expected
+    assert "Continue? [y/n] (Enter = no):" in output.getvalue()
+
+
+def test_markdown_reply_formats_text_but_preserves_code_and_citations():
+    output = StringIO()
+    show_answer(
+        Console(file=output, width=70, force_terminal=False),
+        "## Loops\n\n**Repeat** a task. [loops.md:3]\n\n"
+        "```python\nfor i in range(3):\n    print(i)\n```",
+    )
+    text = output.getvalue()
+    assert "Coach" in text and "Loops" in text
+    assert "**Repeat**" not in text and "Repeat" in text
+    assert "```" not in text
+    assert "[loops.md:3]" in text
+    assert "for i in range(3):" in text and "    print(i)" in text

{studytrails-0.2.2 → studytrails-0.2.3}/tests/wheel_smoke.py

@@ -4,6 +4,7 @@ import os
 import subprocess
 import sys
 import tempfile
+from importlib.metadata import version
 from pathlib import Path
 
 
@@ -34,6 +35,8 @@ def main():
             assert result.returncode == 0, result.stdout + result.stderr
             return result.stdout
 
+        assert run(["--version"]).strip() == f"studytrails {version('studytrails')}"
+        assert not (work / "personal").exists()
         assert "Welcome to StudyTrail" in run([], "n\n0\n")
         assert "API key: not configured" in run(["doctor"])
         assert "100.0%" in run(["demo"], "b\nc\nd\n")

{studytrails-0.2.2 → studytrails-0.2.3}/uv.lock

@@ -742,7 +742,7 @@ wheels = [
 
 [[package]]
 name = "studytrails"
-version = "0.2.2"
+version = "0.2.3"
 source = { editable = "." }
 dependencies = [
     { name = "keyring" },