vtx-coding-agent 0.2.0__tar.gz → 0.2.1__tar.gz

{vtx_coding_agent-0.2.0 → vtx_coding_agent-0.2.1}/PKG-INFO

@@ -1,18 +1,15 @@
 Metadata-Version: 2.4
 Name: vtx-coding-agent
-Version: 0.2.0
-Summary: Minimalist coding agent harness with a Textual TUI and headless CLI. <1k-token system prompt, 18+ LLM providers, AGENTS.md + skills context, session tree, prompt/auto permissions.
+Version: 0.2.1
+Summary: Minimalist coding agent harness with a Textual TUI and headless CLI. Ships two agentic backends: the native vtx event loop and the advanced vtx-claw gateway loop (install the [claw] extra for multi-channel + subagent + cron features). <1k-token system prompt, 50+ LLM providers, AGENTS.md + skills context, session tree, prompt/auto permissions.
 License-File: LICENSE
+Keywords: agent-loop,cli,coding-agent,llm,tui,vtx-claw
 Requires-Python: >=3.12
 Requires-Dist: aiofiles>=25.1.0
 Requires-Dist: aiohttp>=3.13.3
 Requires-Dist: anthropic>=0.79.0
-Requires-Dist: boto3>=1.43.0
 Requires-Dist: chardet<6.0.0,>=3.0.2
-Requires-Dist: croniter<7.0.0,>=6.0.0
 Requires-Dist: curl-cffi>=0.15.0
-Requires-Dist: ddgs<10.0.0,>=9.5.5
-Requires-Dist: dingtalk-stream<1.0.0,>=0.24.0
 Requires-Dist: dulwich<1.0.0,>=0.22.0
 Requires-Dist: filelock>=3.25.2
 Requires-Dist: hammett>=0.10.0
@@ -20,11 +17,8 @@ Requires-Dist: html-to-markdown<3.4.0,>=3.3.0
 Requires-Dist: httpx<1.0.0,>=0.28.0
 Requires-Dist: jinja2<4.0.0,>=3.1.0
 Requires-Dist: json-repair<1.0.0,>=0.57.0
-Requires-Dist: lark-oapi<2.0.0,>=1.5.0
 Requires-Dist: loguru<1.0.0,>=0.7.3
 Requires-Dist: lxml-html-clean>=0.4.3
-Requires-Dist: mcp>=1.28.1
-Requires-Dist: msgpack<2.0.0,>=1.1.0
 Requires-Dist: oauth-cli-kit<1.0.0,>=0.1.3
 Requires-Dist: openai>=2.21.0
 Requires-Dist: openpyxl<4.0.0,>=3.1.0
@@ -36,26 +30,34 @@ Requires-Dist: pypdf<6.0.0,>=5.0.0
 Requires-Dist: pytest-xdist>=3.8.0
 Requires-Dist: python-docx<2.0.0,>=1.1.0
 Requires-Dist: python-pptx<2.0.0,>=1.0.0
-Requires-Dist: python-socketio<6.0.0,>=5.16.0
-Requires-Dist: python-socks[asyncio]<3.0.0,>=2.8.0; sys_platform != 'win32'
-Requires-Dist: python-telegram-bot[socks,webhooks]<23.0,>=22.6
 Requires-Dist: pyyaml>=6.0.3
-Requires-Dist: qq-botpy<2.0.0,>=1.2.0
 Requires-Dist: questionary<3.0.0,>=2.0.0
 Requires-Dist: readability-lxml>=0.8.4
 Requires-Dist: rich>=14.3.2
-Requires-Dist: slack-sdk<4.0.0,>=3.39.0
-Requires-Dist: slackify-markdown<1.0.0,>=0.2.0
-Requires-Dist: socksio<2.0.0,>=1.0.0
 Requires-Dist: textual>=8.0.0
 Requires-Dist: tiktoken<1.0.0,>=0.12.0
 Requires-Dist: typer<1.0.0,>=0.20.0
-Requires-Dist: websocket-client<2.0.0,>=1.9.0
-Requires-Dist: websockets<17.0,>=16.0
 Provides-Extra: api
 Requires-Dist: aiohttp<4.0.0,>=3.9.0; extra == 'api'
 Provides-Extra: azure
 Requires-Dist: azure-identity<2.0.0,>=1.19.0; extra == 'azure'
+Provides-Extra: claw
+Requires-Dist: boto3>=1.43.0; extra == 'claw'
+Requires-Dist: croniter<7.0.0,>=6.0.0; extra == 'claw'
+Requires-Dist: ddgs<10.0.0,>=9.5.5; extra == 'claw'
+Requires-Dist: dingtalk-stream<1.0.0,>=0.24.0; extra == 'claw'
+Requires-Dist: lark-oapi<2.0.0,>=1.5.0; extra == 'claw'
+Requires-Dist: mcp>=1.28.1; extra == 'claw'
+Requires-Dist: msgpack<2.0.0,>=1.1.0; extra == 'claw'
+Requires-Dist: python-socketio<6.0.0,>=5.16.0; extra == 'claw'
+Requires-Dist: python-socks[asyncio]<3.0.0,>=2.8.0; (sys_platform != 'win32') and extra == 'claw'
+Requires-Dist: python-telegram-bot[socks,webhooks]<23.0,>=22.6; extra == 'claw'
+Requires-Dist: qq-botpy<2.0.0,>=1.2.0; extra == 'claw'
+Requires-Dist: slack-sdk<4.0.0,>=3.39.0; extra == 'claw'
+Requires-Dist: slackify-markdown<1.0.0,>=0.2.0; extra == 'claw'
+Requires-Dist: socksio<2.0.0,>=1.0.0; extra == 'claw'
+Requires-Dist: websocket-client<2.0.0,>=1.9.0; extra == 'claw'
+Requires-Dist: websockets<17.0,>=16.0; extra == 'claw'
 Provides-Extra: discord
 Requires-Dist: discord-py<3.0.0,>=2.5.2; extra == 'discord'
 Provides-Extra: langsmith
@@ -105,6 +107,15 @@ Unlike heavy agentic frameworks that load thousands of hidden tokens, Vtx is tra
 
 By keeping the core prompt lean, Vtx leaves the model's context window open for what matters most: **your code, your project files, and your task context**.
 
+## Dual agentic backends
+
+`vtx-coding-agent` ships two agentic execution engines:
+
+- **`vtx` native event loop** (`src/vtx/loop.py`, `src/vtx/turn.py`) — the original single-session, event-stream loop. It powers the TUI and the headless CLI (`vtx -p "..."`). It handles thinking streaming, tool permissions, file edits, and compaction between turns.
+- **`vtx_claw` advanced backend** (`src/vtx_claw/agent/loop.py`, `src/vtx_claw/agent/runner.py`) — a production-grade multi-session gateway loop with concurrent tool batching, context governance, crash-checkpoint restore, mid-turn message injection, subagent orchestration, MCP servers, cron turns, and a hook lifecycle. It powers the `vtx-claw` gateway, WebUI, and 16+ chat-channel integrations.
+
+The core TUI is lightweight. The advanced gateway backend requires the **`[claw]` extra** because it pulls in channel adapters, cron, MCP, and subagent dependencies.
+
 ---
 
 ## ⚡ Key Features
@@ -144,6 +155,11 @@ Alternatively, install directly with `uv`:
 uv tool install vtx-coding-agent
 ```
 
+**Install the advanced gateway backend:**
+```bash
+uv tool install "vtx-coding-agent[claw]"
+```
+
 ### Run
 Launch the interactive Terminal UI:
 ```bash

{vtx_coding_agent-0.2.0 → vtx_coding_agent-0.2.1}/README.md

@@ -21,6 +21,15 @@ Unlike heavy agentic frameworks that load thousands of hidden tokens, Vtx is tra
 
 By keeping the core prompt lean, Vtx leaves the model's context window open for what matters most: **your code, your project files, and your task context**.
 
+## Dual agentic backends
+
+`vtx-coding-agent` ships two agentic execution engines:
+
+- **`vtx` native event loop** (`src/vtx/loop.py`, `src/vtx/turn.py`) — the original single-session, event-stream loop. It powers the TUI and the headless CLI (`vtx -p "..."`). It handles thinking streaming, tool permissions, file edits, and compaction between turns.
+- **`vtx_claw` advanced backend** (`src/vtx_claw/agent/loop.py`, `src/vtx_claw/agent/runner.py`) — a production-grade multi-session gateway loop with concurrent tool batching, context governance, crash-checkpoint restore, mid-turn message injection, subagent orchestration, MCP servers, cron turns, and a hook lifecycle. It powers the `vtx-claw` gateway, WebUI, and 16+ chat-channel integrations.
+
+The core TUI is lightweight. The advanced gateway backend requires the **`[claw]` extra** because it pulls in channel adapters, cron, MCP, and subagent dependencies.
+
 ---
 
 ## ⚡ Key Features
@@ -60,6 +69,11 @@ Alternatively, install directly with `uv`:
 uv tool install vtx-coding-agent
 ```
 
+**Install the advanced gateway backend:**
+```bash
+uv tool install "vtx-coding-agent[claw]"
+```
+
 ### Run
 Launch the interactive Terminal UI:
 ```bash

{vtx_coding_agent-0.2.0 → vtx_coding_agent-0.2.1}/docs/README.md

@@ -22,7 +22,7 @@ This folder is the reference companion to the top-level [README](../README.md).
 
 | Doc | What it covers |
 | --- | --- |
-| [architecture.md](architecture.md) | Internal module map, message types, request flow, design decisions |
+| [architecture.md](architecture.md) | Internal module map, message types, request flow, dual agentic loop design |
 | [development.md](development.md) | Build, test, lint, typecheck, and release Vtx itself |
 | [e2e-test-coverage-review.md](e2e-test-coverage-review.md) | State of the tmux e2e harness and recommended additions |
 
@@ -61,4 +61,4 @@ vtx-claw is the multi-channel AI agent gateway. Full documentation lives in [`cl
 - **Debugging sessions or compaction:** [sessions.md](sessions.md).
 - **Tuning for a local model:** [local-models.md](local-models.md) and [configuration.md](configuration.md) (the `compaction` section).
 - **Working on Vtx itself:** [development.md](development.md), then [architecture.md](architecture.md).
-- **Working on vtx-claw:** [claw/architecture.md](claw/architecture.md), then [claw/README.md](claw/README.md).
+- **Working on vtx-claw:** [architecture.md](architecture.md) (dual-loop section), then [claw/architecture.md](claw/architecture.md) and [claw/README.md](claw/README.md).

{vtx_coding_agent-0.2.0 → vtx_coding_agent-0.2.1}/docs/architecture.md

@@ -172,19 +172,22 @@ class UserMessage(BaseModel):
     role: Literal["user"]
     content: list[TextContent | ImageContent]
 
+
 class AssistantMessage(BaseModel):
     role: Literal["assistant"]
     content: list[TextContent | ThinkingContent | ToolCall]
-    stop_reason: StopReason     # STOP | LENGTH | ERROR
-    usage: Usage                # tokens
+    stop_reason: StopReason  # STOP | LENGTH | ERROR
+    usage: Usage  # tokens
     model: str
 
+
 class ToolResultMessage(BaseModel):
     role: Literal["tool_result"]
     tool_call_id: str
     content: list[TextContent | ImageContent]
     is_error: bool
 
+
 class ToolCall(BaseModel):
     id: str
     name: str
@@ -205,9 +208,68 @@ These are the only message shapes that flow between the LLM provider and the age
 
 `runtime.prepare_for_run()` returns an `AgentLoop` configured for the current settings. The loop is the consumer/producer of `AgentEvent`s.
 
-## Agent loop
+## Agent loops
+
+Vtx ships two execution engines. Both consume the same core types (`Message`, `AssistantMessage`, `ToolResultMessage`) but differ in scope, resilience, and concurrency.
+
+### Native event loop (`vtx/loop.py` + `vtx/turn.py`)
+
+The **native event loop** powers the TUI and headless CLI (`vtx -p "..."`).
+
+```
+src/vtx/
+├── loop.py   # Agent — async generator yielding typed Events
+└── turn.py   # _TurnRunner / run_single_turn — single-turn stream + tool execution
+```
+
+Turn shape:
+1. Yield `TurnStartEvent`.
+2. Call `run_single_turn()` → stream LLM parts → yield `TextDeltaEvent`, `ThinkingDeltaEvent`, `ToolStartEvent`, `ToolArgsDeltaEvent`, `ToolEndEvent`, `ToolResultEvent`.
+3. Yield `TurnEndEvent` with the final `AssistantMessage`.
+4. If the model returned tool calls, the outer `Agent.run()` loop continues to the next turn.
+
+Key properties:
+- **Event stream**: the TUI is a pure consumer of `AgentEvent`s; the headless runner is a different consumer of the same stream.
+- **Cancellation**: races each stream chunk against `cancel_event` via `asyncio.wait(FIRST_COMPLETED)` so ESC takes effect immediately.
+- **Permissions**: auto-approve read-only tools, prompt for mutating ones, and yield `ToolApprovalEvent` for the UI to resolve.
+- **Stall detection**: tool-call idle timeout (`tool_call_idle_timeout_seconds`) finalizes partial arguments instead of hanging.
+- **Compaction**: after each turn, if the most recent assistant usage exceeds the context window threshold, `generate_summary()` produces a synthetic compaction message and the loop continues with the summary in place.
+
+### Advanced backend loop (`vtx_claw/agent/loop.py` + `vtx_claw/agent/runner.py`)
+
+The **advanced backend loop** is part of the same `vtx-coding-agent` package. It powers the `vtx-claw gateway` command and the WebUI. It is a state-machine-driven, multi-session, concurrent executor.
+
+```
+src/vtx_claw/agent/
+├── loop.py     # AgentLoop — 8-state machine (RESTORE → COMPACT → ... → DONE)
+└── runner.py   # AgentRunner — inner LLM iteration with streaming + tool execution
+```
 
-`loop.py` contains the agentic loop. For each iteration:
+Turn shape (inside `AgentLoop._state_run`):
+1. `_run_agent_loop()` creates an `AgentProgressHook` (wraps streaming/progress callbacks) and composes it with any extra `AgentHook`s via `CompositeHook`.
+2. `AgentRunner.run()` iterates up to `max_iterations`:
+   - Call `_request_model()` → consume `TextPart`, `ThinkPart`, `ToolCallStart`, `ToolCallDelta`, `StreamDone` from a bridge adapter.
+   - If tools are present, execute them in concurrent batches (`asyncio.gather` for `concurrency_safe` tools).
+   - Empty-content retry (2×), length recovery (3×), malformed-tool-call retry, and injection draining between iterations.
+3. Return `(final_content, tools_used, messages, stop_reason)` to `_state_save`, then `_state_respond`.
+
+Key properties:
+- **State machine**: explicit `TurnState` enum with a `_TRANSITIONS` table and per-state trace logging.
+- **Concurrency**: per-session locks, cross-session semaphore (`VTX_CLAW_MAX_CONCURRENT_REQUESTS`), and concurrent tool batching.
+- **Resilience**: context governance (orphan-tool-result repair, block limits), runtime checkpoints for `/stop` recovery, error-isolated `CompositeHook`.
+- **Injection system**: mid-turn follow-up messages drained from a per-session pending queue, capped at `_MAX_INJECTIONS_PER_TURN`.
+- **Subagents**: `SubagentManager` spawns isolated child sessions and streams live progress back into the parent.
+- **Memory**: `Consolidator` summarizes old turns in the background; `AutoCompact` runs pre-turn compaction.
+
+### When each is used
+
+The native event loop is in the base install. The advanced `vtx_claw` backend requires the `[claw]` extra because it includes channel adapters, cron, MCP, and subagent dependencies.
+
+| Entry point | Loop used | Notes |
+|---|---|---|
+| `vtx` (TUI) | Native event loop | Interactive Textual session |
+| `vtx -p "..."` (headless) | Native event loop | Non-interactive stdout runner |
+| `vtx-claw gateway` | Advanced backend loop | Persistent multi-channel + WebUI server |
 
 1. Send the message list to the provider.
 2. Receive a stream of `LLMStream` parts.

{vtx_coding_agent-0.2.0 → vtx_coding_agent-0.2.1}/pyproject.toml

@@ -20,20 +20,17 @@ default = true
 
 [project]
 name = "vtx-coding-agent"
-version = "0.2.0"
-description = "Minimalist coding agent harness with a Textual TUI and headless CLI. <1k-token system prompt, 18+ LLM providers, AGENTS.md + skills context, session tree, prompt/auto permissions."
+version = "0.2.1"
+description = "Minimalist coding agent harness with a Textual TUI and headless CLI. Ships two agentic backends: the native vtx event loop and the advanced vtx-claw gateway loop (install the [claw] extra for multi-channel + subagent + cron features). <1k-token system prompt, 50+ LLM providers, AGENTS.md + skills context, session tree, prompt/auto permissions."
 readme = "README.md"
 requires-python = ">=3.12"
+keywords = ["coding-agent", "tui", "cli", "llm", "agent-loop", "vtx-claw"]
 dependencies = [
     "aiofiles>=25.1.0",
     "aiohttp>=3.13.3",
     "anthropic>=0.79.0",
-    "boto3>=1.43.0",
     "chardet>=3.0.2,<6.0.0",
-    "croniter>=6.0.0,<7.0.0",
     "curl-cffi>=0.15.0",
-    "ddgs>=9.5.5,<10.0.0",
-    "dingtalk-stream>=0.24.0,<1.0.0",
     "dulwich>=0.22.0,<1.0.0",
     "filelock>=3.25.2",
     "hammett>=0.10.0",
@@ -41,11 +38,8 @@ dependencies = [
     "httpx>=0.28.0,<1.0.0",
     "jinja2>=3.1.0,<4.0.0",
     "json-repair>=0.57.0,<1.0.0",
-    "lark-oapi>=1.5.0,<2.0.0",
     "loguru>=0.7.3,<1.0.0",
     "lxml-html-clean>=0.4.3",
-    "mcp>=1.28.1",
-    "msgpack>=1.1.0,<2.0.0",
     "oauth-cli-kit>=0.1.3,<1.0.0",
     "openai>=2.21.0",
     "openpyxl>=3.1.0,<4.0.0",
@@ -57,22 +51,13 @@ dependencies = [
     "pytest-xdist>=3.8.0",
     "python-docx>=1.1.0,<2.0.0",
     "python-pptx>=1.0.0,<2.0.0",
-    "python-socketio>=5.16.0,<6.0.0",
-    "python-socks[asyncio]>=2.8.0,<3.0.0; sys_platform != 'win32'",
-    "python-telegram-bot[socks,webhooks]>=22.6,<23.0",
     "pyyaml>=6.0.3",
-    "qq-botpy>=1.2.0,<2.0.0",
     "questionary>=2.0.0,<3.0.0",
     "readability-lxml>=0.8.4",
     "rich>=14.3.2",
-    "slack-sdk>=3.39.0,<4.0.0",
-    "slackify-markdown>=0.2.0,<1.0.0",
-    "socksio>=1.0.0,<2.0.0",
     "textual>=8.0.0",
     "tiktoken>=0.12.0,<1.0.0",
     "typer>=0.20.0,<1.0.0",
-    "websocket-client>=1.9.0,<2.0.0",
-    "websockets>=16.0,<17.0",
 ]
 
 [project.optional-dependencies]
@@ -115,6 +100,27 @@ pdf = [
 olostep = [
     "olostep>=0.1.0",
 ]
+# vtx_claw advanced gateway backend dependencies. These are not needed for
+# the core `vtx` TUI / headless CLI; install them only when using the
+# `vtx-claw` multi-channel gateway, WebUI, cron, MCP, or subagent features.
+claw = [
+    "boto3>=1.43.0",
+    "croniter>=6.0.0,<7.0.0",
+    "ddgs>=9.5.5,<10.0.0",
+    "dingtalk-stream>=0.24.0,<1.0.0",
+    "lark-oapi>=1.5.0,<2.0.0",
+    "mcp>=1.28.1",
+    "msgpack>=1.1.0,<2.0.0",
+    "python-socketio>=5.16.0,<6.0.0",
+    "python-telegram-bot[socks,webhooks]>=22.6,<23.0",
+    "python-socks[asyncio]>=2.8.0,<3.0.0; sys_platform != 'win32'",
+    "qq-botpy>=1.2.0,<2.0.0",
+    "slack-sdk>=3.39.0,<4.0.0",
+    "slackify-markdown>=0.2.0,<1.0.0",
+    "socksio>=1.0.0,<2.0.0",
+    "websocket-client>=1.9.0,<2.0.0",
+    "websockets>=16.0,<17.0",
+]
 
 [dependency-groups]
 dev = [

{vtx_coding_agent-0.2.0 → vtx_coding_agent-0.2.1}/src/vtx/context/agent_mds.py

@@ -21,23 +21,28 @@ class ContextFile:
     content: str
 
 
-def _find_git_root(start: Path) -> Path | None:
-    current = start
+def _find_git_root(start: Path, boundary: Path | None = None) -> Path | None:
+    if boundary is not None:
+        boundary = boundary.resolve()
+    current = start.resolve()
     while True:
         if (current / ".git").is_dir():
             return current
         parent = current.parent
         if parent == current:
             return None
+        if boundary is not None and not parent.is_relative_to(boundary):
+            return None
         current = parent
 
 
-def _get_stop_directory(cwd: Path) -> Path:
-    git_root = _find_git_root(cwd)
+def _get_stop_directory(cwd: Path, boundary: Path | None = None) -> Path:
+    home = Path.home()
+    git_root = _find_git_root(
+        cwd, boundary=boundary or (home if cwd.is_relative_to(home) else None)
+    )
     if git_root:
         return git_root
-
-    home = Path.home()
     try:
         cwd.relative_to(home)
         return home

{vtx_coding_agent-0.2.0 → vtx_coding_agent-0.2.1}/src/vtx/context/skills.py

@@ -267,14 +267,18 @@ def _load_skills_recursive(directory: Path, *, max_depth: int = 2) -> LoadSkills
     return LoadSkillsResult(skills=skills, warnings=warnings)
 
 
-def _find_git_root(start: Path) -> Path | None:
-    current = start
+def _find_git_root(start: Path, boundary: Path | None = None) -> Path | None:
+    if boundary is not None:
+        boundary = boundary.resolve()
+    current = start.resolve()
     while True:
         if (current / ".git").is_dir():
             return current
         parent = current.parent
         if parent == current:
             return None
+        if boundary is not None and not parent.is_relative_to(boundary):
+            return None
         current = parent
 
 

{vtx_coding_agent-0.2.0 → vtx_coding_agent-0.2.1}/src/vtx/version.py

@@ -19,4 +19,4 @@ PACKAGE_NAME = _get_package_name()
 try:
     VERSION = version(PACKAGE_NAME)
 except PackageNotFoundError:
-    VERSION = "0.2.0"  # Fallback version if package metadata is not available
+    VERSION = "0.2.1"  # Fallback version if package metadata is not available

{vtx_coding_agent-0.2.0 → vtx_coding_agent-0.2.1}/src/vtx_claw/__init__.py

@@ -26,7 +26,7 @@ def _resolve_version() -> str:
     try:
         return _pkg_version("vtx-claw")
     except PackageNotFoundError:
-        return _read_pyproject_version() or "0.2.2"
+        return _read_pyproject_version() or "0.2.1"
 
 
 __version__ = _resolve_version()

{vtx_coding_agent-0.2.0 → vtx_coding_agent-0.2.1}/tests/context/test_agents.py

@@ -26,7 +26,7 @@ class TestFindGitRoot:
         subdir = tmp_path / "no" / "git" / "here"
         subdir.mkdir(parents=True)
 
-        result = _find_git_root(subdir)
+        result = _find_git_root(subdir, boundary=tmp_path)
 
         assert result is None
 
@@ -86,7 +86,7 @@ class TestGetStopDirectory:
         outside = tmp_path / "mnt" / "external"
         outside.mkdir(parents=True)
 
-        result = _get_stop_directory(outside)
+        result = _get_stop_directory(outside, boundary=tmp_path)
 
         assert result == outside
 

{vtx_coding_agent-0.2.0 → vtx_coding_agent-0.2.1}/uv.lock

@@ -3376,18 +3376,14 @@ wheels = [
 
 [[package]]
 name = "vtx-coding-agent"
-version = "0.2.0"
+version = "0.2.1"
 source = { editable = "." }
 dependencies = [
     { name = "aiofiles" },
     { name = "aiohttp" },
     { name = "anthropic" },
-    { name = "boto3" },
     { name = "chardet" },
-    { name = "croniter" },
     { name = "curl-cffi" },
-    { name = "ddgs" },
-    { name = "dingtalk-stream" },
     { name = "dulwich" },
     { name = "filelock" },
     { name = "hammett" },
@@ -3395,11 +3391,8 @@ dependencies = [
     { name = "httpx" },
     { name = "jinja2" },
     { name = "json-repair" },
-    { name = "lark-oapi" },
     { name = "loguru" },
     { name = "lxml-html-clean" },
-    { name = "mcp" },
-    { name = "msgpack" },
     { name = "oauth-cli-kit" },
     { name = "openai" },
     { name = "openpyxl" },
@@ -3411,22 +3404,13 @@ dependencies = [
     { name = "pytest-xdist" },
     { name = "python-docx" },
     { name = "python-pptx" },
-    { name = "python-socketio" },
-    { name = "python-socks", marker = "sys_platform != 'win32'" },
-    { name = "python-telegram-bot", extra = ["socks", "webhooks"] },
     { name = "pyyaml" },
-    { name = "qq-botpy" },
     { name = "questionary" },
     { name = "readability-lxml" },
     { name = "rich" },
-    { name = "slack-sdk" },
-    { name = "slackify-markdown" },
-    { name = "socksio" },
     { name = "textual" },
     { name = "tiktoken" },
     { name = "typer" },
-    { name = "websocket-client" },
-    { name = "websockets" },
 ]
 
 [package.optional-dependencies]
@@ -3436,6 +3420,24 @@ api = [
 azure = [
     { name = "azure-identity" },
 ]
+claw = [
+    { name = "boto3" },
+    { name = "croniter" },
+    { name = "ddgs" },
+    { name = "dingtalk-stream" },
+    { name = "lark-oapi" },
+    { name = "mcp" },
+    { name = "msgpack" },
+    { name = "python-socketio" },
+    { name = "python-socks", marker = "sys_platform != 'win32'" },
+    { name = "python-telegram-bot", extra = ["socks", "webhooks"] },
+    { name = "qq-botpy" },
+    { name = "slack-sdk" },
+    { name = "slackify-markdown" },
+    { name = "socksio" },
+    { name = "websocket-client" },
+    { name = "websockets" },
+]
 discord = [
     { name = "discord-py" },
 ]
@@ -3487,13 +3489,13 @@ requires-dist = [
     { name = "aiohttp", marker = "extra == 'matrix'", specifier = ">=3.9.0,<4.0.0" },
     { name = "anthropic", specifier = ">=0.79.0" },
     { name = "azure-identity", marker = "extra == 'azure'", specifier = ">=1.19.0,<2.0.0" },
-    { name = "boto3", specifier = ">=1.43.0" },
+    { name = "boto3", marker = "extra == 'claw'", specifier = ">=1.43.0" },
     { name = "chardet", specifier = ">=3.0.2,<6.0.0" },
-    { name = "croniter", specifier = ">=6.0.0,<7.0.0" },
+    { name = "croniter", marker = "extra == 'claw'", specifier = ">=6.0.0,<7.0.0" },
     { name = "cryptography", marker = "extra == 'msteams'", specifier = ">=41.0" },
     { name = "curl-cffi", specifier = ">=0.15.0" },
-    { name = "ddgs", specifier = ">=9.5.5,<10.0.0" },
-    { name = "dingtalk-stream", specifier = ">=0.24.0,<1.0.0" },
+    { name = "ddgs", marker = "extra == 'claw'", specifier = ">=9.5.5,<10.0.0" },
+    { name = "dingtalk-stream", marker = "extra == 'claw'", specifier = ">=0.24.0,<1.0.0" },
     { name = "discord-py", marker = "extra == 'discord'", specifier = ">=2.5.2,<3.0.0" },
     { name = "dulwich", specifier = ">=0.22.0,<1.0.0" },
     { name = "filelock", specifier = ">=3.25.2" },
@@ -3503,13 +3505,13 @@ requires-dist = [
     { name = "jinja2", specifier = ">=3.1.0,<4.0.0" },
     { name = "json-repair", specifier = ">=0.57.0,<1.0.0" },
     { name = "langsmith", marker = "extra == 'langsmith'", specifier = ">=0.1.0" },
-    { name = "lark-oapi", specifier = ">=1.5.0,<2.0.0" },
+    { name = "lark-oapi", marker = "extra == 'claw'", specifier = ">=1.5.0,<2.0.0" },
     { name = "loguru", specifier = ">=0.7.3,<1.0.0" },
     { name = "lxml-html-clean", specifier = ">=0.4.3" },
     { name = "matrix-nio", extras = ["e2e"], marker = "sys_platform != 'win32' and extra == 'matrix'", specifier = ">=0.25.2" },
-    { name = "mcp", specifier = ">=1.28.1" },
+    { name = "mcp", marker = "extra == 'claw'", specifier = ">=1.28.1" },
     { name = "mistune", marker = "extra == 'matrix'", specifier = ">=3.0.0,<4.0.0" },
-    { name = "msgpack", specifier = ">=1.1.0,<2.0.0" },
+    { name = "msgpack", marker = "extra == 'claw'", specifier = ">=1.1.0,<2.0.0" },
     { name = "neonize", marker = "extra == 'whatsapp'", specifier = ">=0.3.18.post0,<0.4.0" },
     { name = "nh3", marker = "extra == 'matrix'", specifier = ">=0.2.17,<1.0.0" },
     { name = "oauth-cli-kit", specifier = ">=0.1.3,<1.0.0" },
@@ -3527,27 +3529,27 @@ requires-dist = [
     { name = "pytest-xdist", specifier = ">=3.8.0" },
     { name = "python-docx", specifier = ">=1.1.0,<2.0.0" },
     { name = "python-pptx", specifier = ">=1.0.0,<2.0.0" },
-    { name = "python-socketio", specifier = ">=5.16.0,<6.0.0" },
-    { name = "python-socks", extras = ["asyncio"], marker = "sys_platform != 'win32'", specifier = ">=2.8.0,<3.0.0" },
-    { name = "python-telegram-bot", extras = ["socks", "webhooks"], specifier = ">=22.6,<23.0" },
+    { name = "python-socketio", marker = "extra == 'claw'", specifier = ">=5.16.0,<6.0.0" },
+    { name = "python-socks", extras = ["asyncio"], marker = "sys_platform != 'win32' and extra == 'claw'", specifier = ">=2.8.0,<3.0.0" },
+    { name = "python-telegram-bot", extras = ["socks", "webhooks"], marker = "extra == 'claw'", specifier = ">=22.6,<23.0" },
     { name = "pyyaml", specifier = ">=6.0.3" },
-    { name = "qq-botpy", specifier = ">=1.2.0,<2.0.0" },
+    { name = "qq-botpy", marker = "extra == 'claw'", specifier = ">=1.2.0,<2.0.0" },
     { name = "qrcode", extras = ["pil"], marker = "extra == 'weixin'", specifier = ">=8.0" },
     { name = "questionary", specifier = ">=2.0.0,<3.0.0" },
     { name = "readability-lxml", specifier = ">=0.8.4" },
     { name = "rich", specifier = ">=14.3.2" },
     { name = "segno", marker = "extra == 'whatsapp'", specifier = ">=1.6.1,<2.0.0" },
-    { name = "slack-sdk", specifier = ">=3.39.0,<4.0.0" },
-    { name = "slackify-markdown", specifier = ">=0.2.0,<1.0.0" },
-    { name = "socksio", specifier = ">=1.0.0,<2.0.0" },
+    { name = "slack-sdk", marker = "extra == 'claw'", specifier = ">=3.39.0,<4.0.0" },
+    { name = "slackify-markdown", marker = "extra == 'claw'", specifier = ">=0.2.0,<1.0.0" },
+    { name = "socksio", marker = "extra == 'claw'", specifier = ">=1.0.0,<2.0.0" },
     { name = "textual", specifier = ">=8.0.0" },
     { name = "tiktoken", specifier = ">=0.12.0,<1.0.0" },
     { name = "typer", specifier = ">=0.20.0,<1.0.0" },
-    { name = "websocket-client", specifier = ">=1.9.0,<2.0.0" },
-    { name = "websockets", specifier = ">=16.0,<17.0" },
+    { name = "websocket-client", marker = "extra == 'claw'", specifier = ">=1.9.0,<2.0.0" },
+    { name = "websockets", marker = "extra == 'claw'", specifier = ">=16.0,<17.0" },
     { name = "wecom-aibot-sdk-python", marker = "extra == 'wecom'", specifier = ">=0.1.5" },
 ]
-provides-extras = ["api", "azure", "wecom", "weixin", "msteams", "matrix", "discord", "whatsapp", "langsmith", "pdf", "olostep"]
+provides-extras = ["api", "azure", "wecom", "weixin", "msteams", "matrix", "discord", "whatsapp", "langsmith", "pdf", "olostep", "claw"]
 
 [package.metadata.requires-dev]
 dev = [