driangle-agentrunner 0.0.1__tar.gz → 0.0.2__tar.gz

{driangle_agentrunner-0.0.1 → driangle_agentrunner-0.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: driangle-agentrunner
-Version: 0.0.1
+Version: 0.0.2
 Summary: Python library for programmatically invoking AI coding agents
 Project-URL: Homepage, https://github.com/driangle/agentrunner
 Project-URL: Repository, https://github.com/driangle/agentrunner
@@ -24,17 +24,17 @@ Python library for programmatically invoking AI coding agents. Part of the [agen
 
 | Runner      | CLI Version | Status |
 |-------------|-------------|--------|
-| Claude Code | >= 1.0.12   | ✅      |
+| Claude Code | >= 2.1.0   | ✅      |
 
 ## Requirements
 
 - Python >= 3.11
-- Claude Code CLI >= 1.0.12
+- Claude Code CLI >= 2.1.0
 
 ## Installation
 
 ```bash
-pip install agentrunner
+pip install driangle-agentrunner
 ```
 
 ## Quick Start
@@ -108,6 +108,8 @@ Claude-specific options (`ClaudeRunOptions` extends `RunOptions`):
 |--------------------------|-------------|------------------------------------|
 | `allowed_tools`          | `list[str]` | Tools the agent may use            |
 | `disallowed_tools`       | `list[str]` | Tools the agent may not use        |
+| `permission_mode`        | `str`       | Permission mode (wins over `dangerously_skip_permissions`) |
+| `settings`               | `str`       | Additional settings: file path or inline JSON |
 | `mcp_config`             | `str`       | Path to MCP server config          |
 | `json_schema`            | `str`       | JSON Schema for structured output  |
 | `max_budget_usd`         | `float`     | Cost limit in USD                  |
@@ -115,7 +117,6 @@ Claude-specific options (`ClaudeRunOptions` extends `RunOptions`):
 | `continue_session`       | `bool`      | Continue most recent session       |
 | `session_id`             | `str`       | Specific session ID                |
 | `include_partial_messages`| `bool`     | Stream partial/incremental messages|
-| `on_message`             | `callable`  | Callback for each streamed message |
 
 ### Result
 

{driangle_agentrunner-0.0.1 → driangle_agentrunner-0.0.2}/README.md

@@ -6,17 +6,17 @@ Python library for programmatically invoking AI coding agents. Part of the [agen
 
 | Runner      | CLI Version | Status |
 |-------------|-------------|--------|
-| Claude Code | >= 1.0.12   | ✅      |
+| Claude Code | >= 2.1.0   | ✅      |
 
 ## Requirements
 
 - Python >= 3.11
-- Claude Code CLI >= 1.0.12
+- Claude Code CLI >= 2.1.0
 
 ## Installation
 
 ```bash
-pip install agentrunner
+pip install driangle-agentrunner
 ```
 
 ## Quick Start
@@ -90,6 +90,8 @@ Claude-specific options (`ClaudeRunOptions` extends `RunOptions`):
 |--------------------------|-------------|------------------------------------|
 | `allowed_tools`          | `list[str]` | Tools the agent may use            |
 | `disallowed_tools`       | `list[str]` | Tools the agent may not use        |
+| `permission_mode`        | `str`       | Permission mode (wins over `dangerously_skip_permissions`) |
+| `settings`               | `str`       | Additional settings: file path or inline JSON |
 | `mcp_config`             | `str`       | Path to MCP server config          |
 | `json_schema`            | `str`       | JSON Schema for structured output  |
 | `max_budget_usd`         | `float`     | Cost limit in USD                  |
@@ -97,7 +99,6 @@ Claude-specific options (`ClaudeRunOptions` extends `RunOptions`):
 | `continue_session`       | `bool`      | Continue most recent session       |
 | `session_id`             | `str`       | Specific session ID                |
 | `include_partial_messages`| `bool`     | Stream partial/incremental messages|
-| `on_message`             | `callable`  | Callback for each streamed message |
 
 ### Result
 

{driangle_agentrunner-0.0.1 → driangle_agentrunner-0.0.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "driangle-agentrunner"
-version = "0.0.1"
+version = "0.0.2"
 description = "Python library for programmatically invoking AI coding agents"
 readme = "README.md"
 requires-python = ">=3.11"

{driangle_agentrunner-0.0.1 → driangle_agentrunner-0.0.2}/src/agentrunner/claudecode/args.py

@@ -22,10 +22,16 @@ def build_args(prompt: str, options: ClaudeRunOptions | None = None) -> list[str
         args.extend(["--append-system-prompt", options.append_system_prompt])
     if options.max_turns is not None and options.max_turns > 0:
         args.extend(["--max-turns", str(options.max_turns)])
-    if options.skip_permissions:
+    # permission_mode takes precedence over dangerously_skip_permissions.
+    if options.permission_mode:
+        args.extend(["--permission-mode", options.permission_mode])
+    elif options.dangerously_skip_permissions:
         args.append("--dangerously-skip-permissions")
 
     # Claude-specific options.
+    # --tools takes a single comma-separated value, not repeated flags.
+    if options.tools:
+        args.extend(["--tools", ",".join(options.tools)])
     if options.allowed_tools:
         for tool in options.allowed_tools:
             args.extend(["--allowedTools", tool])
@@ -36,6 +42,9 @@ def build_args(prompt: str, options: ClaudeRunOptions | None = None) -> list[str
         args.extend(["--mcp-config", options.mcp_config])
     if options.json_schema:
         args.extend(["--json-schema", options.json_schema])
+    # Value may be a file path or a raw JSON string; the CLI disambiguates.
+    if options.settings:
+        args.extend(["--settings", options.settings])
     if options.max_budget_usd is not None and options.max_budget_usd > 0:
         args.extend(["--max-budget-usd", str(options.max_budget_usd)])
     if options.resume:

driangle_agentrunner-0.0.2/src/agentrunner/claudecode/options.py

@@ -0,0 +1,49 @@
+"""Configuration and option types for the Claude Code runner."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Protocol
+
+from ..types import RunOptions
+
+
+class Logger(Protocol):
+    """Logger interface for debug output. Opt-in, disabled by default.
+
+    Compatible with ``logging.getLogger()``.
+    """
+
+    def debug(self, message: str, *args: object, **kwargs: object) -> None: ...
+    def error(self, message: str, *args: object, **kwargs: object) -> None: ...
+
+
+@dataclass
+class ClaudeRunOptions(RunOptions):
+    """Claude Code-specific options that extend the common RunOptions."""
+
+    allowed_tools: list[str] | None = None
+    disallowed_tools: list[str] | None = None
+    # Exclusive whitelist of built-in tools (--tools). Unlike allowed_tools,
+    # which only pre-approves tools and leaves unlisted built-ins available,
+    # --tools replaces the built-in tool set, so every unlisted built-in is
+    # denied at registration. Use [""] to disable all tools, ["default"] for
+    # the full set, or explicit names. None leaves the CLI default.
+    tools: list[str] | None = None
+    # Permission mode for the run (--permission-mode). Known modes: "default",
+    # "acceptEdits", "auto", "plan", "dontAsk", "bypassPermissions". Passed
+    # through as a plain string so new CLI modes work without a library change.
+    # When set, takes precedence over dangerously_skip_permissions.
+    permission_mode: str | None = None
+    mcp_config: str | None = None
+    json_schema: str | None = None
+    # Additional settings for the run (--settings). May be a path to a settings
+    # JSON file or a raw JSON string; passed through verbatim, the CLI
+    # disambiguates. In non-interactive mode the CLI silently ignores settings
+    # that fail validation.
+    settings: str | None = None
+    max_budget_usd: float | None = None
+    resume: str | None = None
+    continue_session: bool = False
+    session_id: str | None = None
+    include_partial_messages: bool = False

{driangle_agentrunner-0.0.1 → driangle_agentrunner-0.0.2}/src/agentrunner/claudecode/process.py

@@ -52,6 +52,7 @@ async def default_spawn(
         stdin=asyncio.subprocess.DEVNULL,
         stdout=asyncio.subprocess.PIPE,
         stderr=asyncio.subprocess.PIPE,
+        limit=10 * 1024 * 1024,  # 10 MiB — default 64 KiB is too small for large JSON lines
     )
 
 

{driangle_agentrunner-0.0.1 → driangle_agentrunner-0.0.2}/src/agentrunner/claudecode/version.py

@@ -8,7 +8,8 @@ import re
 from ..errors import NotFoundError
 
 # Supported Claude Code CLI version range.
-MIN_VERSION = "1.0.12"
+# 2.1.0 is the first release that ships --tools (verified absent in 2.0.0).
+MIN_VERSION = "2.1.0"
 
 _VERSION_RE = re.compile(r"(\d+\.\d+\.\d+)")
 

{driangle_agentrunner-0.0.1 → driangle_agentrunner-0.0.2}/src/agentrunner/types.py

@@ -148,7 +148,7 @@ class RunOptions:
     env: dict[str, str] | None = None
     max_turns: int | None = None
     timeout: float | None = None
-    skip_permissions: bool = False
+    dangerously_skip_permissions: bool = False
 
 
 @runtime_checkable

{driangle_agentrunner-0.0.1 → driangle_agentrunner-0.0.2}/tests/claudecode/test_args.py

@@ -37,8 +37,8 @@ class TestBuildArgs:
         args = build_args("hello", opts)
         assert "--max-turns" not in args
 
-    def test_skip_permissions(self):
-        opts = ClaudeRunOptions(skip_permissions=True)
+    def test_dangerously_skip_permissions(self):
+        opts = ClaudeRunOptions(dangerously_skip_permissions=True)
         args = build_args("hello", opts)
         assert "--dangerously-skip-permissions" in args
 
@@ -56,6 +56,56 @@ class TestBuildArgs:
         assert "--disallowedTools" in args
         assert args[args.index("--disallowedTools") + 1] == "Bash"
 
+    def test_tools_joined_into_single_value(self):
+        opts = ClaudeRunOptions(tools=["Read", "Grep"])
+        args = build_args("hello", opts)
+        assert args.count("--tools") == 1
+        assert args[args.index("--tools") + 1] == "Read,Grep"
+
+    def test_tools_empty_string_disables_all(self):
+        opts = ClaudeRunOptions(tools=[""])
+        args = build_args("hello", opts)
+        assert args[args.index("--tools") + 1] == ""
+
+    def test_tools_omitted_when_unset_or_empty(self):
+        assert "--tools" not in build_args("hello", ClaudeRunOptions())
+        assert "--tools" not in build_args("hello", ClaudeRunOptions(tools=[]))
+
+    def test_settings_file_path(self):
+        opts = ClaudeRunOptions(settings="/tmp/settings.json")
+        args = build_args("hello", opts)
+        assert args[args.index("--settings") + 1] == "/tmp/settings.json"
+
+    def test_settings_inline_json(self):
+        raw = '{"permissions":{"deny":["Bash"]}}'
+        opts = ClaudeRunOptions(settings=raw)
+        args = build_args("hello", opts)
+        assert args[args.index("--settings") + 1] == raw
+
+    def test_settings_omitted_when_unset(self):
+        assert "--settings" not in build_args("hello", ClaudeRunOptions())
+
+    def test_permission_mode(self):
+        opts = ClaudeRunOptions(permission_mode="auto")
+        args = build_args("hello", opts)
+        assert "--permission-mode" in args
+        assert args[args.index("--permission-mode") + 1] == "auto"
+
+    def test_permission_mode_omitted_when_unset(self):
+        assert "--permission-mode" not in build_args("hello", ClaudeRunOptions())
+
+    def test_permission_mode_takes_precedence_over_skip_permissions(self):
+        opts = ClaudeRunOptions(permission_mode="plan", dangerously_skip_permissions=True)
+        args = build_args("hello", opts)
+        assert args[args.index("--permission-mode") + 1] == "plan"
+        assert "--dangerously-skip-permissions" not in args
+
+    def test_skip_permissions_still_passed_without_permission_mode(self):
+        opts = ClaudeRunOptions(dangerously_skip_permissions=True)
+        args = build_args("hello", opts)
+        assert "--dangerously-skip-permissions" in args
+        assert "--permission-mode" not in args
+
     def test_mcp_config(self):
         opts = ClaudeRunOptions(mcp_config="/path/to/config.json")
         args = build_args("hello", opts)

driangle_agentrunner-0.0.1/src/agentrunner/claudecode/options.py

@@ -1,33 +0,0 @@
-"""Configuration and option types for the Claude Code runner."""
-
-from __future__ import annotations
-
-from dataclasses import dataclass
-from typing import Protocol
-
-from ..types import RunOptions
-
-
-class Logger(Protocol):
-    """Logger interface for debug output. Opt-in, disabled by default.
-
-    Compatible with ``logging.getLogger()``.
-    """
-
-    def debug(self, message: str, *args: object, **kwargs: object) -> None: ...
-    def error(self, message: str, *args: object, **kwargs: object) -> None: ...
-
-
-@dataclass
-class ClaudeRunOptions(RunOptions):
-    """Claude Code-specific options that extend the common RunOptions."""
-
-    allowed_tools: list[str] | None = None
-    disallowed_tools: list[str] | None = None
-    mcp_config: str | None = None
-    json_schema: str | None = None
-    max_budget_usd: float | None = None
-    resume: str | None = None
-    continue_session: bool = False
-    session_id: str | None = None
-    include_partial_messages: bool = False