mycode-sdk 0.4.2__tar.gz

mycode_sdk-0.4.2/.gitignore

@@ -0,0 +1,88 @@
+# OS specific
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+*.swp
+*.swo
+*~
+
+# IDEs and Editors
+.vscode/
+!.vscode/extensions.json
+.idea/
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+
+# Environment
+.env
+.env.local
+.env.*.local
+*.local
+
+# Logs
+logs/
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.pyc
+*.pyo
+*.pyd
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.venv/
+venv/
+env/
+ENV/
+.python-version
+*.egg-info/
+dist-python/
+build/
+*.egg
+.uv-cache
+
+# Node.js / Frontend
+node_modules/
+dist/
+dist-ssr/
+.vite/
+*.tsbuildinfo
+.eslintcache
+.npm
+.yarn/cache
+.yarn/unplugged
+.yarn/build-state.yml
+.yarn/install-state.gz
+.pnp.*
+
+# Archives
+archive/
+legacy/
+
+# Local data
+/cli/src/mycode_cli/server/static/
+
+# Config with secrets (use config.example.json as template)
+config.json
+
+# AI Agents
+CLAUDE.md
+.claude/
+GEMINI.md
+.gemini/
+.pi/

mycode_sdk-0.4.2/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.

mycode_sdk-0.4.2/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,89 @@
+# 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/pyproject.toml

@@ -0,0 +1,42 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "mycode-sdk"
+version = "0.4.2"
+description = "Multi-turn tool-calling agent runtime for embedding the mycode agent loop."
+readme = "README.md"
+requires-python = ">=3.12"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "LeGibet", email = "legibetpeng@gmail.com" }]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "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", "llm", "anthropic", "openai", "gemini", "sdk"]
+dependencies = [
+    "anthropic>=0.74.0",
+    "google-genai>=1.68.0",
+    "openai>=2.11.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/legibet/mycode"
+Repository = "https://github.com/legibet/mycode"
+Issues = "https://github.com/legibet/mycode/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/mycode"]
+artifacts = ["src/mycode/models_catalog.json"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/mycode", "README.md", "LICENSE", "pyproject.toml"]
+artifacts = ["src/mycode/models_catalog.json"]

mycode_sdk-0.4.2/src/mycode/__init__.py

@@ -0,0 +1,72 @@
+"""mycode — multi-turn tool-calling agent runtime.
+
+Public API for embedding the agent loop in other Python applications. The
+runtime ships four built-in coding tools (``read``, ``write``, ``edit``,
+``bash``) exposed as :data:`read_tool`, :data:`write_tool`, :data:`edit_tool`,
+:data:`bash_tool` — pick the ones you want via ``tools=[...]`` rather than
+silently exposing file system and shell access.
+"""
+
+from mycode.agent import Agent, Event, PersistCallback
+from mycode.messages import (
+    ContentBlock,
+    ConversationMessage,
+    assistant_message,
+    build_message,
+    document_block,
+    flatten_message_text,
+    image_block,
+    text_block,
+    thinking_block,
+    tool_result_block,
+    tool_use_block,
+    user_text_message,
+)
+from mycode.session import SessionStore
+from mycode.tools import (
+    DEFAULT_TOOL_SPECS,
+    ToolContext,
+    ToolExecutionResult,
+    ToolExecutor,
+    ToolSpec,
+    cancel_all_tools,
+    tool,
+)
+
+__version__ = "0.4.0"
+
+# Built-in tool specs exposed as module-level constants so callers can pick
+# which ones to register (``tools=[read_tool, bash_tool]``) rather than
+# getting all four by default.
+read_tool, write_tool, edit_tool, bash_tool = DEFAULT_TOOL_SPECS
+
+__all__ = [
+    "Agent",
+    "ContentBlock",
+    "ConversationMessage",
+    "DEFAULT_TOOL_SPECS",
+    "Event",
+    "PersistCallback",
+    "SessionStore",
+    "ToolContext",
+    "ToolExecutionResult",
+    "ToolExecutor",
+    "ToolSpec",
+    "__version__",
+    "assistant_message",
+    "bash_tool",
+    "build_message",
+    "cancel_all_tools",
+    "document_block",
+    "edit_tool",
+    "flatten_message_text",
+    "image_block",
+    "read_tool",
+    "text_block",
+    "thinking_block",
+    "tool",
+    "tool_result_block",
+    "tool_use_block",
+    "user_text_message",
+    "write_tool",
+]