mycode-sdk 0.12.0__tar.gz → 0.13.0__tar.gz

{mycode_sdk-0.12.0 → mycode_sdk-0.13.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: mycode-sdk
-Version: 0.12.0
+Version: 0.13.0
 Summary: Lightweight Python SDK for building AI agents.
 Project-URL: Homepage, https://github.com/legibet/mycode
 Project-URL: Repository, https://github.com/legibet/mycode
@@ -42,15 +42,27 @@ pip install mycode-sdk
 
 ```python
 import asyncio
+from pathlib import Path
+
+from mycode import Agent, tool
 
-from mycode import Agent, bash_tool, read_tool
+
+@tool
+def read_file(path: str) -> str:
+    """Read a UTF-8 text file.
+
+    Args:
+        path: File path, relative to the working directory.
+    """
+
+    return Path(path).read_text(encoding="utf-8")
 
 
 async def main() -> None:
     agent = Agent(
         model="claude-sonnet-4-6",
         api_key="YOUR_API_KEY",
-        tools=[read_tool, bash_tool],
+        tools=[read_file],
     )
 
     async for event in agent.achat("Read pyproject.toml and tell me the project name."):
@@ -142,15 +154,7 @@ agent = Agent(
 
 Construct another `Agent` with the same `(session_dir, session_id)` to load the conversation history.
 
-## Built-in tools
-
-```python
-from mycode import read_tool, write_tool, edit_tool, bash_tool
-```
-
-Four tools for reading, writing, editing files, and running shell commands. Opt in by passing them to `tools=[...]`.
-
-## Custom tools
+## Tools
 
 Decorate a typed function with `@tool`:
 
@@ -176,36 +180,48 @@ agent = Agent(
 )
 ```
 
-To call a built-in tool from inside your own tool, type the first parameter as `ToolContext`:
+To call another registered tool from inside a tool, type the first parameter as `ToolContext` and dispatch by name:
 
 ```python
 from mycode import ToolContext, tool
 
 
 @tool
-def summarize_file(ctx: ToolContext, path: str) -> str:
-    """Return the first line of a text file."""
+def greet_team(ctx: ToolContext, names: list[str]) -> str:
+    """Greet several people at once."""
 
-    result = ctx.read(path)
-    return result.output.splitlines()[0] if result.output else ""
+    return "\n".join(ctx.call("greet", {"name": name}).output for name in names)
 ```
 
-Async tools use `await ctx.aread()`, `await ctx.awrite()`, `await ctx.aedit()`, and `await ctx.abash()`. Use `await ctx.acall(name, args)` to call another registered tool by name.
+Async tools use `await ctx.acall(name, args)` instead.
 
 ## Tool hooks
 
 Inspect or replace tool calls before they run. Return `None` from `before_tool` to let the tool execute, or a `ToolExecutionResult` to skip it:
 
 ```python
-from mycode import Agent, Hooks, ToolExecutionResult, bash_tool
+import os
+
+from mycode import Agent, Hooks, ToolExecutionResult, tool
 
 hooks = Hooks()
 
 
+@tool
+def delete_file(path: str) -> str:
+    """Delete a file.
+
+    Args:
+        path: Path of the file to delete.
+    """
+
+    os.remove(path)
+    return f"deleted {path}"
+
+
 @hooks.before_tool
-async def block_rm(ctx):
-    cmd = str(ctx.tool_input.get("command") or "")
-    if ctx.tool_name == "bash" and "rm -rf" in cmd:
+async def protect_dotfiles(ctx):
+    if ctx.tool_name == "delete_file" and str(ctx.tool_input.get("path") or "").startswith("."):
         return ToolExecutionResult(output="error: blocked", is_error=True)
     return None
 
@@ -213,7 +229,7 @@ async def block_rm(ctx):
 agent = Agent(
     model="claude-sonnet-4-6",
     api_key="...",
-    tools=[bash_tool],
+    tools=[delete_file],
     hooks=hooks,
 )
 ```

{mycode_sdk-0.12.0 → mycode_sdk-0.13.0}/README.md

@@ -14,15 +14,27 @@ pip install mycode-sdk
 
 ```python
 import asyncio
+from pathlib import Path
+
+from mycode import Agent, tool
 
-from mycode import Agent, bash_tool, read_tool
+
+@tool
+def read_file(path: str) -> str:
+    """Read a UTF-8 text file.
+
+    Args:
+        path: File path, relative to the working directory.
+    """
+
+    return Path(path).read_text(encoding="utf-8")
 
 
 async def main() -> None:
     agent = Agent(
         model="claude-sonnet-4-6",
         api_key="YOUR_API_KEY",
-        tools=[read_tool, bash_tool],
+        tools=[read_file],
     )
 
     async for event in agent.achat("Read pyproject.toml and tell me the project name."):
@@ -114,15 +126,7 @@ agent = Agent(
 
 Construct another `Agent` with the same `(session_dir, session_id)` to load the conversation history.
 
-## Built-in tools
-
-```python
-from mycode import read_tool, write_tool, edit_tool, bash_tool
-```
-
-Four tools for reading, writing, editing files, and running shell commands. Opt in by passing them to `tools=[...]`.
-
-## Custom tools
+## Tools
 
 Decorate a typed function with `@tool`:
 
@@ -148,36 +152,48 @@ agent = Agent(
 )
 ```
 
-To call a built-in tool from inside your own tool, type the first parameter as `ToolContext`:
+To call another registered tool from inside a tool, type the first parameter as `ToolContext` and dispatch by name:
 
 ```python
 from mycode import ToolContext, tool
 
 
 @tool
-def summarize_file(ctx: ToolContext, path: str) -> str:
-    """Return the first line of a text file."""
+def greet_team(ctx: ToolContext, names: list[str]) -> str:
+    """Greet several people at once."""
 
-    result = ctx.read(path)
-    return result.output.splitlines()[0] if result.output else ""
+    return "\n".join(ctx.call("greet", {"name": name}).output for name in names)
 ```
 
-Async tools use `await ctx.aread()`, `await ctx.awrite()`, `await ctx.aedit()`, and `await ctx.abash()`. Use `await ctx.acall(name, args)` to call another registered tool by name.
+Async tools use `await ctx.acall(name, args)` instead.
 
 ## Tool hooks
 
 Inspect or replace tool calls before they run. Return `None` from `before_tool` to let the tool execute, or a `ToolExecutionResult` to skip it:
 
 ```python
-from mycode import Agent, Hooks, ToolExecutionResult, bash_tool
+import os
+
+from mycode import Agent, Hooks, ToolExecutionResult, tool
 
 hooks = Hooks()
 
 
+@tool
+def delete_file(path: str) -> str:
+    """Delete a file.
+
+    Args:
+        path: Path of the file to delete.
+    """
+
+    os.remove(path)
+    return f"deleted {path}"
+
+
 @hooks.before_tool
-async def block_rm(ctx):
-    cmd = str(ctx.tool_input.get("command") or "")
-    if ctx.tool_name == "bash" and "rm -rf" in cmd:
+async def protect_dotfiles(ctx):
+    if ctx.tool_name == "delete_file" and str(ctx.tool_input.get("path") or "").startswith("."):
         return ToolExecutionResult(output="error: blocked", is_error=True)
     return None
 
@@ -185,7 +201,7 @@ async def block_rm(ctx):
 agent = Agent(
     model="claude-sonnet-4-6",
     api_key="...",
-    tools=[bash_tool],
+    tools=[delete_file],
     hooks=hooks,
 )
 ```

{mycode_sdk-0.12.0 → mycode_sdk-0.13.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "mycode-sdk"
-version = "0.12.0"
+version = "0.13.0"
 description = "Lightweight Python SDK for building AI agents."
 readme = "README.md"
 requires-python = ">=3.12"

{mycode_sdk-0.12.0 → mycode_sdk-0.13.0}/src/mycode/__init__.py

@@ -21,7 +21,7 @@ from mycode.messages import (
     tool_use_block,
     user_text_message,
 )
-from mycode.models import ModelMetadata, estimate_cost, resolve_model_metadata
+from mycode.models import Cost, ModelMetadata, estimate_cost, resolve_model_metadata
 from mycode.providers.base import ProviderError, StreamStartTimeoutError
 from mycode.session import SessionStore
 from mycode.tools import (
@@ -29,12 +29,7 @@ from mycode.tools import (
     ToolExecutionResult,
     ToolExecutor,
     ToolSpec,
-    bash_tool,
-    cancel_all_tools,
-    edit_tool,
-    read_tool,
     tool,
-    write_tool,
 )
 
 __version__ = metadata.version("mycode-sdk")
@@ -44,6 +39,7 @@ __all__ = [
     "Attachment",
     "ContentBlock",
     "ConversationMessage",
+    "Cost",
     "Event",
     "AfterToolHook",
     "BeforeToolHook",
@@ -63,16 +59,12 @@ __all__ = [
     "ToolSpec",
     "__version__",
     "assistant_message",
-    "bash_tool",
     "build_message",
     "build_usage",
-    "cancel_all_tools",
     "document_block",
-    "edit_tool",
     "estimate_cost",
     "flatten_message_text",
     "image_block",
-    "read_tool",
     "resolve_model_metadata",
     "text_block",
     "thinking_block",
@@ -80,5 +72,4 @@ __all__ = [
     "tool_result_block",
     "tool_use_block",
     "user_text_message",
-    "write_tool",
 ]