mycode-sdk 0.4.2__py3-none-any.whl

mycode/utils.py

@@ -0,0 +1,38 @@
+"""Shared utilities used across core modules."""
+
+from __future__ import annotations
+
+import json
+from typing import Any
+
+
+def as_int(value: Any) -> int | None:
+    """Return value if it is a strict int (not bool), otherwise None."""
+    return None if isinstance(value, bool) or not isinstance(value, int) else value
+
+
+def as_bool(value: Any) -> bool | None:
+    """Return value if it is a bool, otherwise None."""
+    return value if isinstance(value, bool) else None
+
+
+def omit_none(d: dict[str, Any]) -> dict[str, Any]:
+    """Return a shallow copy of d with None values removed."""
+    return {k: v for k, v in d.items() if v is not None}
+
+
+def parse_tool_arguments(raw: str | None) -> dict[str, Any] | str:
+    """Parse a JSON tool-arguments string.
+
+    Returns the parsed dict, or an error string if the input is invalid.
+    Empty / None input is treated as an empty argument set.
+    """
+    if not raw or not raw.strip():
+        return {}
+    try:
+        parsed = json.loads(raw)
+    except json.JSONDecodeError:
+        return "error: invalid JSON arguments"
+    if not isinstance(parsed, dict):
+        return "error: tool arguments must decode to a JSON object"
+    return parsed

mycode_sdk-0.4.2.dist-info/METADATA

@@ -0,0 +1,114 @@
+Metadata-Version: 2.4
+Name: mycode-sdk
+Version: 0.4.2
+Summary: Multi-turn tool-calling agent runtime for embedding the mycode agent loop.
+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
+Author-email: LeGibet <legibetpeng@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agent,anthropic,gemini,llm,openai,sdk
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+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: google-genai>=1.68.0
+Requires-Dist: openai>=2.11.0
+Description-Content-Type: text/markdown
+
+# mycode-sdk
+
+Lightweight Python SDK for the mycode multi-turn tool-calling agent. Import name: `mycode`.
+
+## Install
+
+```bash
+uv add mycode-sdk
+# or
+pip install mycode-sdk
+```
+
+## Quick Start
+
+`Agent(...)` fills in sensible defaults: provider inferred from the model id, `session_id` generated, session log auto-persisted to `~/.mycode/sessions/<session_id>/`. By default no tools are registered — pick the built-ins you want or register your own via `@tool`.
+
+```python
+import asyncio
+
+from mycode import Agent, bash_tool, read_tool
+
+
+async def main() -> None:
+    agent = Agent(
+        model="claude-sonnet-4-6",
+        api_key="YOUR_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())
+```
+
+To resume a previous conversation, pass the same `session_id` (the agent loads its own history from disk).
+
+## Built-in tools
+
+Pick and combine the four bundled coding tools:
+
+```python
+from mycode import read_tool, write_tool, edit_tool, bash_tool
+```
+
+## Custom Tools
+
+`@tool` wraps a plain Python function (sync or async) as a `ToolSpec`. If the first parameter is annotated `ToolContext`, the context is injected; use `ctx.call("read", {...})` to invoke another registered tool.
+
+```python
+from mycode import Agent, ToolContext, read_tool, tool
+
+
+@tool
+def summarize_file(ctx: ToolContext, path: str) -> str:
+    """Return the first line of a text file."""
+
+    result = ctx.call("read", {"path": path})
+    return result.model_text.splitlines()[0] if result.model_text else ""
+
+
+agent = Agent(
+    model="claude-sonnet-4-6",
+    api_key="YOUR_API_KEY",
+    cwd=".",
+    tools=[read_tool, summarize_file],
+)
+```
+
+Type hints drive the JSON schema. Unknown types raise; missing docstrings raise. `async def` tools are run via `asyncio.run` on the executor's worker thread.
+
+## Disabling auto-persistence
+
+Point `session_dir` (or the implied `SessionStore` data dir) at a temporary directory if you need an ephemeral session:
+
+```python
+import tempfile
+from pathlib import Path
+
+agent = Agent(
+    model="claude-sonnet-4-6",
+    cwd=".",
+    session_dir=Path(tempfile.mkdtemp()) / "scratch",
+)
+```

mycode_sdk-0.4.2.dist-info/RECORD

@@ -0,0 +1,19 @@
+mycode/__init__.py,sha256=mH9wD-pKsJx8buBEmPMDYaSsKAValSlbDUXcoHss8wU,1804
+mycode/agent.py,sha256=eCbZQg6nlNVfHYC6n8xhSlLtQGhsuAti0YeNV2F1Lgo,23141
+mycode/messages.py,sha256=TTrEPyZ4ef0OcPtYeUpWdldBDa8vHKuoYqNNNyth6X0,5296
+mycode/models.py,sha256=xoWldezejrpB6dzEJdbbOdfseEb4hxxcrIAE5ZQIFwY,5192
+mycode/models_catalog.json,sha256=Cpmm9S2OeCr5koyFOo9zi31CFLqFCupan5BCBw0lb2I,75197
+mycode/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mycode/session.py,sha256=0d8jzkogys3pGe4JNB_6l-rSR2aP29mnRaYya0sSlbE,19528
+mycode/tools.py,sha256=iKkc9dC7t2xQeZsuJYBxvo21nkvTSpUs-VAAp73YF-s,43985
+mycode/utils.py,sha256=owQv38IWboxkF-7qcbWnkpMjK0susMRKX2QZLAznqKo,1196
+mycode/providers/__init__.py,sha256=KQbLyTwhxrTUZBELYJtUtz6LVVHit02zjbWKwiIkG2Q,2777
+mycode/providers/anthropic_like.py,sha256=Uah_QwkOmQR-JAdej4Gzrx5FuS_-3WrJLeplrkVAN2o,14948
+mycode/providers/base.py,sha256=43Ykjos2cfcRkd1fBCXfeoAGRiiMk3FA9ky0zrMUGkk,14553
+mycode/providers/gemini.py,sha256=wXaaDVxGOGscDdQcE56Am8theQO4bGg-MnMx1PP-BGo,13524
+mycode/providers/openai_chat.py,sha256=xB5OJcGrXX6389cnbgaI_ptU8UNv3hKEQQ0r0sVvDw0,14737
+mycode/providers/openai_responses.py,sha256=vp9jgI_NpI2ag33Hn8DcgAImaQ9f4_5hgAD-O8PFbrc,15426
+mycode_sdk-0.4.2.dist-info/METADATA,sha256=Ozj0BpXiH9xkdMu4SP3I4mzjIVkdOkZRR7kzkli5VIM,3365
+mycode_sdk-0.4.2.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+mycode_sdk-0.4.2.dist-info/licenses/LICENSE,sha256=DSE6T-B9WhrWypr6H7y2kTZzoF1tef5xf7veUyImQsM,1064
+mycode_sdk-0.4.2.dist-info/RECORD,,

mycode_sdk-0.4.2.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

mycode_sdk-0.4.2.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 LeGibet
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.