mycode-cli 0.3.4__tar.gz → 0.4.3__tar.gz

{mycode_cli-0.3.4 → mycode_cli-0.4.3}/.gitignore

@@ -75,7 +75,7 @@ archive/
 legacy/
 
 # Local data
-/mycode/server/static/
+/cli/src/mycode_cli/server/static/
 
 # Config with secrets (use config.example.json as template)
 config.json

{mycode_cli-0.3.4 → mycode_cli-0.4.3}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: mycode-cli
-Version: 0.3.4
-Summary: Minimal coding agent with web UI
+Version: 0.4.3
+Summary: Minimal coding agent CLI and web UI built on mycode-sdk.
 Project-URL: Homepage, https://github.com/legibet/mycode
 Project-URL: Repository, https://github.com/legibet/mycode
 Project-URL: Issues, https://github.com/legibet/mycode/issues
@@ -21,11 +21,10 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development
 Requires-Python: >=3.12
-Requires-Dist: anthropic>=0.74.0
 Requires-Dist: fastapi>=0.115.0
-Requires-Dist: google-genai>=1.68.0
-Requires-Dist: openai>=2.11.0
+Requires-Dist: mycode-sdk==0.4.3
 Requires-Dist: prompt-toolkit>=3.0.52
+Requires-Dist: pyyaml>=6.0.0
 Requires-Dist: rich>=14.2.0
 Requires-Dist: typer>=0.24.1
 Requires-Dist: uvicorn[standard]>=0.32.0
@@ -43,6 +42,7 @@ A minimal coding agent. Inspired by [pi](https://github.com/badlogic/pi-mono).
 - Inspectable runtime, append-only JSONL sessions.
 - Native image and pdf input support.
 - Mobile-friendly web UI.
+- Lightweight `mycode-sdk` for embedding the agent in other Python apps.
 
 ## Quick Start
 
@@ -76,7 +76,7 @@ API keys are discovered automatically from environment variables (see Providers
 
 | Provider          | id            | Env var              | Default models                                     |
 | ----------------- | ------------- | -------------------- | -------------------------------------------------- |
-| Anthropic         | `anthropic`   | `ANTHROPIC_API_KEY`  | `claude-sonnet-4-6`, `claude-opus-4-6`             |
+| Anthropic         | `anthropic`   | `ANTHROPIC_API_KEY`  | `claude-sonnet-4-6`, `claude-opus-4-7`             |
 | OpenAI            | `openai`      | `OPENAI_API_KEY`     | `gpt-5.4`, `gpt-5.4-mini`                          |
 | Google Gemini     | `google`      | `GEMINI_API_KEY`     | `gemini-3.1-pro-preview`, `gemini-3-flash-preview` |
 | Moonshot          | `moonshotai`  | `MOONSHOT_API_KEY`   | `kimi-k2.5`                                        |
@@ -169,18 +169,44 @@ uv run mycode web --dev
 pnpm --dir web install && pnpm --dir web dev
 ```
 
-Rebuild packaged web assets:
+Or start both together:
 
 ```bash
-uv run --no-project python scripts/build_web.py
+just dev
 ```
 
+Other useful shortcuts: `just check` · `just test` · `just fmt`
+
 Build distributable artifacts:
 
 ```bash
-uv build
+uv build --package mycode-sdk
+uv build --package mycode-cli
+```
+
+## mycode-sdk
+
+```python
+import asyncio
+from mycode import Agent, bash_tool, read_tool
+
+async def main() -> None:
+    agent = Agent(
+        model="claude-sonnet-4-6",
+        api_key="...",
+        cwd=".",
+        system="You are a concise coding assistant.",
+        tools=[read_tool, bash_tool],
+    )
+    async for event in agent.achat("Read pyproject.toml and tell me the project name."):
+        if event.type == "text":
+            print(event.data["delta"], end="")
+
+asyncio.run(main())
 ```
 
+See `mycode/README.md` for details.
+
 ## License
 
 MIT

{mycode_cli-0.3.4 → mycode_cli-0.4.3}/README.md

@@ -10,6 +10,7 @@ A minimal coding agent. Inspired by [pi](https://github.com/badlogic/pi-mono).
 - Inspectable runtime, append-only JSONL sessions.
 - Native image and pdf input support.
 - Mobile-friendly web UI.
+- Lightweight `mycode-sdk` for embedding the agent in other Python apps.
 
 ## Quick Start
 
@@ -43,7 +44,7 @@ API keys are discovered automatically from environment variables (see Providers
 
 | Provider          | id            | Env var              | Default models                                     |
 | ----------------- | ------------- | -------------------- | -------------------------------------------------- |
-| Anthropic         | `anthropic`   | `ANTHROPIC_API_KEY`  | `claude-sonnet-4-6`, `claude-opus-4-6`             |
+| Anthropic         | `anthropic`   | `ANTHROPIC_API_KEY`  | `claude-sonnet-4-6`, `claude-opus-4-7`             |
 | OpenAI            | `openai`      | `OPENAI_API_KEY`     | `gpt-5.4`, `gpt-5.4-mini`                          |
 | Google Gemini     | `google`      | `GEMINI_API_KEY`     | `gemini-3.1-pro-preview`, `gemini-3-flash-preview` |
 | Moonshot          | `moonshotai`  | `MOONSHOT_API_KEY`   | `kimi-k2.5`                                        |
@@ -136,18 +137,44 @@ uv run mycode web --dev
 pnpm --dir web install && pnpm --dir web dev
 ```
 
-Rebuild packaged web assets:
+Or start both together:
 
 ```bash
-uv run --no-project python scripts/build_web.py
+just dev
 ```
 
+Other useful shortcuts: `just check` · `just test` · `just fmt`
+
 Build distributable artifacts:
 
 ```bash
-uv build
+uv build --package mycode-sdk
+uv build --package mycode-cli
+```
+
+## mycode-sdk
+
+```python
+import asyncio
+from mycode import Agent, bash_tool, read_tool
+
+async def main() -> None:
+    agent = Agent(
+        model="claude-sonnet-4-6",
+        api_key="...",
+        cwd=".",
+        system="You are a concise coding assistant.",
+        tools=[read_tool, bash_tool],
+    )
+    async for event in agent.achat("Read pyproject.toml and tell me the project name."):
+        if event.type == "text":
+            print(event.data["delta"], end="")
+
+asyncio.run(main())
 ```
 
+See `mycode/README.md` for details.
+
 ## License
 
 MIT

mycode_cli-0.4.3/hatch_build.py

@@ -0,0 +1,66 @@
+"""Hatch hooks for mycode-cli packaging."""
+
+from __future__ import annotations
+
+import shutil
+import subprocess
+from pathlib import Path
+from typing import Any
+
+from hatchling.builders.hooks.plugin.interface import BuildHookInterface  # noqa: E402
+from hatchling.metadata.plugin.interface import MetadataHookInterface  # noqa: E402
+
+
+def _run_pnpm(args: list[str], *, cwd: Path) -> None:
+    try:
+        _ = subprocess.run(["pnpm", *args], cwd=cwd, check=True)
+    except FileNotFoundError as exc:
+        raise RuntimeError("pnpm is required to build the web assets") from exc
+    except subprocess.CalledProcessError as exc:
+        joined = " ".join(args)
+        raise RuntimeError(f"pnpm {joined} failed with exit code {exc.returncode}") from exc
+
+
+def _build_web_assets(project_root: Path) -> None:
+    repo_root = project_root.parent
+    web_dir = repo_root / "web"
+    web_dist_dir = web_dir / "dist"
+    static_dir = project_root / "src" / "mycode_cli" / "server" / "static"
+
+    if not web_dir.is_dir():
+        if static_dir.is_dir():
+            return
+        raise RuntimeError(f"web source directory not found: {web_dir}")
+
+    _run_pnpm(["install", "--frozen-lockfile"], cwd=web_dir)
+    _run_pnpm(["build"], cwd=web_dir)
+
+    if not web_dist_dir.is_dir():
+        raise RuntimeError(f"web build output not found: {web_dist_dir}")
+
+    if static_dir.exists():
+        shutil.rmtree(static_dir)
+    _ = shutil.copytree(web_dist_dir, static_dir)
+
+
+def _readme_text(project_root: Path) -> str:
+    candidates = [project_root.parent / "README.md", project_root / "README.md"]
+    for path in candidates:
+        if path.is_file():
+            return path.read_text(encoding="utf-8")
+    searched = ", ".join(str(path) for path in candidates)
+    raise RuntimeError(f"README.md not found; checked: {searched}")
+
+
+class CustomMetadataHook(MetadataHookInterface):
+    def update(self, metadata: dict[str, Any]) -> None:
+        metadata["readme"] = {
+            "text": _readme_text(Path(self.root)),
+            "content-type": "text/markdown",
+        }
+
+
+class CustomBuildHook(BuildHookInterface[Any]):
+    def initialize(self, version: str, build_data: dict[str, Any]) -> None:
+        del version, build_data
+        _build_web_assets(Path(self.root))

mycode_cli-0.4.3/pyproject.toml

@@ -0,0 +1,63 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "mycode-cli"
+version = "0.4.3"
+description = "Minimal coding agent CLI and web UI built on mycode-sdk."
+requires-python = ">=3.12"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "LeGibet", email = "legibetpeng@gmail.com" }]
+dynamic = ["readme"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Environment :: Web Environment",
+    "Framework :: FastAPI",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development",
+]
+keywords = ["agent", "cli", "llm", "coding-agent", "fastapi"]
+dependencies = [
+    "mycode-sdk==0.4.3",
+    "fastapi>=0.115.0",
+    "uvicorn[standard]>=0.32.0",
+    "rich>=14.2.0",
+    "prompt-toolkit>=3.0.52",
+    "typer>=0.24.1",
+    "pyyaml>=6.0.0",
+]
+
+[project.scripts]
+mycode = "mycode_cli.main:main"
+
+[project.urls]
+Homepage = "https://github.com/legibet/mycode"
+Repository = "https://github.com/legibet/mycode"
+Issues = "https://github.com/legibet/mycode/issues"
+
+[tool.hatch.metadata.hooks.custom]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/mycode_cli"]
+artifacts = ["src/mycode_cli/server/static/**"]
+
+[tool.hatch.build.targets.wheel.hooks.custom]
+path = "hatch_build.py"
+
+[tool.hatch.build.targets.sdist]
+include = ["src/mycode_cli", "LICENSE", "hatch_build.py", "pyproject.toml"]
+artifacts = ["src/mycode_cli/server/static/**"]
+
+[tool.hatch.build.targets.sdist.force-include]
+"../README.md" = "README.md"
+
+[tool.hatch.build.targets.sdist.hooks.custom]
+path = "hatch_build.py"

mycode_cli-0.4.3/src/mycode_cli/__init__.py

@@ -0,0 +1 @@
+"""mycode-cli — interactive CLI and FastAPI server for the mycode agent."""

{mycode_cli-0.3.4/mycode/core → mycode_cli-0.4.3/src/mycode_cli}/config.py

@@ -13,12 +13,12 @@ import json
 import logging
 import os
 import re
-from dataclasses import dataclass, field, replace
+from dataclasses import dataclass, field
 from pathlib import Path
 from typing import Any
 
-from mycode.core.models import ModelMetadata, lookup_model_metadata
-from mycode.core.providers import (
+from mycode.models import resolve_model_metadata
+from mycode.providers import (
     get_provider_adapter,
     is_supported_provider,
     list_env_discoverable_providers,
@@ -27,11 +27,15 @@ from mycode.core.providers import (
     provider_default_models,
     provider_env_api_key_names,
 )
-from mycode.core.utils import as_bool, as_int
+from mycode.session import resolve_mycode_home
+from mycode.utils import as_bool, as_int
 
-_DEFAULT_MYCODE_HOME = "~/.mycode"
 _API_KEY_ENV_REF_RE = re.compile(r"^\$\{([A-Za-z_][A-Za-z0-9_]*)\}$")
-_VALID_REASONING_EFFORTS = ("none", "low", "medium", "high", "xhigh")
+# Full set of user-facing choices. "auto" means "do not send an explicit effort
+# to the provider" and is represented internally as `None` after normalization.
+REASONING_EFFORT_OPTIONS = ("auto", "none", "low", "medium", "high", "xhigh")
+_EFFORT_AUTO_ALIASES = frozenset({"", "auto", "default"})
+_EFFORT_OFF_ALIASES = frozenset({"off", "disabled"})
 
 
 @dataclass(frozen=True)
@@ -76,30 +80,8 @@ class ResolvedProvider:
     api_key: str | None
     api_base: str | None
     reasoning_effort: str | None
-    max_tokens: int = 16_384
-    context_window: int | None = 128_000
-    supports_reasoning: bool | None = None
-    supports_image_input: bool | None = None
-    supports_pdf_input: bool | None = None
     provider_name: str | None = None
 
-    @property
-    def provider_type(self) -> str:
-        return self.provider
-
-
-def resolve_mycode_home() -> Path:
-    """Resolve the mycode home directory."""
-
-    raw = os.environ.get("MYCODE_HOME", _DEFAULT_MYCODE_HOME)
-    return Path(raw).expanduser().resolve(strict=False)
-
-
-def resolve_sessions_dir() -> Path:
-    """Resolve the default directory used for persisted sessions."""
-
-    return resolve_mycode_home() / "sessions"
-
 
 def find_workspace_root(cwd: str) -> Path:
     """Resolve the project/workspace root for the current cwd."""
@@ -183,15 +165,28 @@ def _parse_compact_threshold(value: Any) -> float | None:
 
 
 def normalize_reasoning_effort(value: Any) -> str | None:
-    if not isinstance(value, str):
+    """Normalize a reasoning effort setting.
+
+    Returns `None` for "auto"/"default"/empty — the sentinel for "do not send an
+    explicit effort to the provider". Returns "none" for "off"/"disabled" and
+    a canonical tier string for recognized levels. Raises `ValueError` for any
+    other string (or non-string, non-None value).
+    """
+
+    if value is None:
         return None
+    if not isinstance(value, str):
+        raise ValueError(f"reasoning_effort must be a string, got {type(value).__name__}")
 
     effort = value.strip().lower()
-    if effort in {"", "auto", "default"}:
+    if effort in _EFFORT_AUTO_ALIASES:
         return None
-    if effort in {"off", "disabled"}:
+    if effort in _EFFORT_OFF_ALIASES:
         return "none"
-    return effort
+    if effort in REASONING_EFFORT_OPTIONS:
+        return effort
+    supported = ", ".join(REASONING_EFFORT_OPTIONS)
+    raise ValueError(f"unsupported reasoning_effort {value!r}; supported: {supported}")
 
 
 def _config_api_key_from_env_var(provider: ProviderConfig, *, require: bool = False) -> str | None:
@@ -453,43 +448,6 @@ def _resolve_provider_runtime(
         resolved_model = defaults[0]
 
     resolved_api_base = api_base or (provider_config.base_url if provider_config else None)
-    model_metadata = lookup_model_metadata(
-        provider_type=provider_type,
-        model=resolved_model,
-    )
-    if provider_config:
-        model_config = provider_config.models.get(resolved_model)
-        if model_config:
-            if model_metadata is None:
-                model_metadata = ModelMetadata(
-                    provider=provider_type,
-                    model=resolved_model,
-                    context_window=model_config.context_window,
-                    max_output_tokens=model_config.max_output_tokens,
-                    supports_reasoning=model_config.supports_reasoning,
-                    supports_image_input=model_config.supports_image_input,
-                    supports_pdf_input=model_config.supports_pdf_input,
-                )
-            else:
-                # Per-field: use the config override when set, keep catalog value otherwise.
-                model_metadata = replace(
-                    model_metadata,
-                    context_window=model_config.context_window
-                    if model_config.context_window is not None
-                    else model_metadata.context_window,
-                    max_output_tokens=model_config.max_output_tokens
-                    if model_config.max_output_tokens is not None
-                    else model_metadata.max_output_tokens,
-                    supports_reasoning=model_config.supports_reasoning
-                    if model_config.supports_reasoning is not None
-                    else model_metadata.supports_reasoning,
-                    supports_image_input=model_config.supports_image_input
-                    if model_config.supports_image_input is not None
-                    else model_metadata.supports_image_input,
-                    supports_pdf_input=model_config.supports_pdf_input
-                    if model_config.supports_pdf_input is not None
-                    else model_metadata.supports_pdf_input,
-                )
 
     configured_effort = (
         provider_config.reasoning_effort
@@ -497,22 +455,18 @@ def _resolve_provider_runtime(
         else settings.default_reasoning_effort
     )
 
-    if configured_effort is not None and configured_effort not in _VALID_REASONING_EFFORTS:
-        supported = ", ".join(_VALID_REASONING_EFFORTS)
-        raise ValueError(f"unsupported reasoning_effort {configured_effort!r}; supported: {supported}")
-
-    supports_reasoning = model_metadata.supports_reasoning if model_metadata else None
-    supports_image_input = model_metadata.supports_image_input if model_metadata else None
-    supports_pdf_input = model_metadata.supports_pdf_input if model_metadata else None
+    # Drop reasoning_effort when the model does not support reasoning. Config
+    # overrides win over catalog metadata.
+    model_config = provider_config.models.get(resolved_model) if provider_config else None
+    meta = resolve_model_metadata(
+        provider=provider_type,
+        model=resolved_model,
+        supports_reasoning=model_config.supports_reasoning if model_config else None,
+    )
     adapter = get_provider_adapter(provider_type)
     reasoning_effort = (
         configured_effort
-        if (
-            configured_effort is not None
-            and model_metadata is not None
-            and supports_reasoning is True
-            and adapter.supports_reasoning_effort
-        )
+        if configured_effort is not None and meta.supports_reasoning is True and adapter.supports_reasoning_effort
         else None
     )
 
@@ -536,11 +490,6 @@ def _resolve_provider_runtime(
         api_key=resolved_api_key,
         api_base=resolved_api_base,
         reasoning_effort=reasoning_effort,
-        max_tokens=(model_metadata.max_output_tokens if model_metadata else None) or 16_384,
-        context_window=(model_metadata.context_window if model_metadata else None) or 128_000,
-        supports_reasoning=supports_reasoning,
-        supports_image_input=supports_image_input,
-        supports_pdf_input=supports_pdf_input,
     )