ripperdoc 0.2.9__py3-none-any.whl → 0.3.0__py3-none-any.whl

{ripperdoc-0.2.9.dist-info → ripperdoc-0.3.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ripperdoc
-Version: 0.2.9
+Version: 0.3.0
 Summary: AI-powered terminal assistant for coding tasks
 Author: Ripperdoc Team
 License: Apache-2.0
@@ -23,16 +23,23 @@ Requires-Dist: python-dotenv>=1.0.0
 Requires-Dist: aiofiles>=23.0.0
 Requires-Dist: prompt-toolkit>=3.0.0
 Requires-Dist: PyYAML>=6.0.0
-Requires-Dist: mcp[cli]>=1.22.0
+Requires-Dist: mcp[cli]>=1.25.0
 Requires-Dist: json_repair>=0.54.2
 Requires-Dist: tiktoken>=0.7.0
 Requires-Dist: google-genai>=0.3.0
+Requires-Dist: charset-normalizer>=3.0.0
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
 Requires-Dist: mypy>=1.0.0; extra == "dev"
 Requires-Dist: black>=23.0.0; extra == "dev"
 Requires-Dist: ruff>=0.1.0; extra == "dev"
+Provides-Extra: anthropic
+Requires-Dist: anthropic>=0.39.0; extra == "anthropic"
+Provides-Extra: openai
+Requires-Dist: openai>=1.0.0; extra == "openai"
+Provides-Extra: gemini
+Requires-Dist: google-genai>=0.3.0; extra == "gemini"
 Dynamic: license-file
 
 <div align="center">
@@ -93,27 +100,22 @@ pip install git+https://github.com/quantmew/ripperdoc.git
 Or install from source:
 ```bash
 # Clone the repository
-git clone <repository-url>
-cd Ripperdoc
+git clone https://github.com/quantmew/ripperdoc.git
+cd ripperdoc
 
 # Install from source
 pip install -e .
 ```
 
-### Configuration
 
-Set your API key as an environment variable:
-```bash
-export OPENAI_API_KEY="your-api-key-here"
-# or for Anthropic Claude
-export ANTHROPIC_API_KEY="your-api-key-here"
-```
 
 ## Usage
 
 ### Interactive Mode (Recommended)
 ```bash
 ripperdoc
+# or use the short alias
+rd
 ```
 
 This launches an interactive session where you can:
@@ -122,6 +124,13 @@ This launches an interactive session where you can:
 - Execute commands
 - Navigate and explore files
 
+**Options:**
+- `--yolo` - Skip permission prompts (safe mode is on by default)
+- `--model <model_name>` - Specify a model (e.g., `claude-sonnet-4-20250514`, `gpt-4o`)
+- `--tools <tool_list>` - Filter available tools (comma-separated, or "" for none)
+- `--no-mcp` - Disable MCP server integration
+- `--verbose` - Enable verbose logging
+
 ### Python SDK (headless)
 
 Use Ripperdoc without the terminal UI via the new Python SDK. See [docs/SDK_USAGE.md](docs/SDK_USAGE.md) for examples of the one-shot `query` helper and the session-based `RipperdocClient`. 中文指南见 [docs/SDK_USAGE_CN.md](docs/SDK_USAGE_CN.md)。
@@ -137,38 +146,67 @@ See the [examples/](examples/) directory for complete SDK usage examples.
 
 ### Safe Mode Permissions
 
-Safe mode is the default. Use `--unsafe` to skip permission prompts. Choose `a`/`always` to allow a tool for the current session (not persisted across sessions).
+Safe mode is enabled by default. When prompted:
+- Type `y` or `yes` to allow a single operation
+- Type `a` or `always` to allow all operations of that type for the session
+- Type `n` or `no` to deny the operation
+
+Use `--yolo` flag to skip all permission prompts:
+```bash
+ripperdoc --yolo
+```
 
 ### Agent Skills
 
 Extend Ripperdoc with reusable Skill bundles:
 
-- Personal skills live in `~/.ripperdoc/skills/<skill-name>/SKILL.md`
-- Project skills live in `.ripperdoc/skills/<skill-name>/SKILL.md` and can be checked into git
-- Each `SKILL.md` starts with YAML frontmatter (`name`, `description`, optional `allowed-tools`, `model`, `max-thinking-tokens`, `disable-model-invocation`) followed by the instructions; add supporting files alongside it
-- Model and max-thinking-token hints from skills are applied automatically for the rest of the session after you load them with the `Skill` tool
-- Ripperdoc exposes skill names/descriptions in the system prompt and loads full content on demand via the `Skill` tool
+- **Personal skills**: `~/.ripperdoc/skills/<skill-name>/SKILL.md`
+- **Project skills**: `.ripperdoc/skills/<skill-name>/SKILL.md` (can be checked into git)
+- Each `SKILL.md` starts with YAML frontmatter:
+  - `name` - Skill identifier
+  - `description` - What the skill does
+  - `allowed-tools` (optional) - Restrict which tools the skill can use
+  - `model` (optional) - Suggest a specific model for this skill
+  - `max-thinking-tokens` (optional) - Control thinking budget
+  - `disable-model-invocation` (optional) - Use skill without calling the model
+- Add supporting files alongside `SKILL.md` as needed
+- Skills are auto-discovered and loaded on demand via the `Skill` tool
+
+**Built-in skills:** PDF manipulation (`pdf`), PowerPoint (`pptx`), Excel (`xlsx`)
 
 ## Examples
 
 ### Code Analysis
 ```
 > Can you explain what this function does?
+> Find all references to the `parse_config` function
 ```
 
 ### File Operations
 ```
 > Read the main.py file and suggest improvements
+> Create a new component called UserProfile.tsx
+> Update all imports to use the new package structure
 ```
 
 ### Code Generation
 ```
 > Create a new Python script that implements a REST API client
+> Generate unit tests for the auth module
+> Add error handling to the database connection code
 ```
 
 ### Project Navigation
 ```
 > Show me all the Python files in the project
+> Find where the user authentication logic is implemented
+> List all API endpoints in the project
+```
+
+### MCP Integration
+```
+> What MCP servers are available?
+> Query the context7 documentation for React hooks
 ```
 
 ## Development

ripperdoc-0.3.0.dist-info/RECORD

@@ -0,0 +1,136 @@
+ripperdoc/__init__.py,sha256=r9wkvo_s7lhTfuQG7WVFeE3Eg4HgMGHovnyZR1OVnPA,66
+ripperdoc/__main__.py,sha256=1Avq2MceBfwUlNsfasC8n4dqVL_V56Bl3DRsnY4_Nxk,370
+ripperdoc/cli/__init__.py,sha256=03wf6gXBcEgXJrDJS-W_5BEG_DdJ_ep7CxQFPML-73g,35
+ripperdoc/cli/cli.py,sha256=OZgN803jYmzdKxynHWG7VNwd7dQhM1KdYakXDyMlZT8,21826
+ripperdoc/cli/commands/__init__.py,sha256=Up-tTlq3lhxDt-YEdiOoHwfRyIdb8nlL5waECzRg-xY,4858
+ripperdoc/cli/commands/agents_cmd.py,sha256=agDTXwZWSr-fmtp_afuD1kMTA1NalMHtoKQ3eVtJMFs,15699
+ripperdoc/cli/commands/base.py,sha256=4KUjxCM04MwbSMUKVNEBph_jeAKPI8b5MHsUFoz7l5g,386
+ripperdoc/cli/commands/clear_cmd.py,sha256=iyOLWtgYwJKNjG-el2mwFRA3VWGIXrNNLl32Xdwpq9o,584
+ripperdoc/cli/commands/compact_cmd.py,sha256=uR_nB1OX7cUL1TOJoefwdO31Qfyjd0nZSSttErqUxbA,473
+ripperdoc/cli/commands/config_cmd.py,sha256=QcFYOOmNFSHmw6K2vY_wfKrYXi8PSzz6koJFREJoF_c,884
+ripperdoc/cli/commands/context_cmd.py,sha256=tM8o2ZfX-axFYaFLsWOTSER_Yevk3ANr2numHfuh2UE,5232
+ripperdoc/cli/commands/cost_cmd.py,sha256=yD9LSqgxVvYNTDPnEHxugjyLWcmbtH5dXim7DIW9zXc,2822
+ripperdoc/cli/commands/doctor_cmd.py,sha256=w-AVph1fvmlnbuTeUdAL19zikj4MmNRxmXlhcvR2SXQ,8188
+ripperdoc/cli/commands/exit_cmd.py,sha256=lEGLMVozoOM2Ea_Yw-sbaIvAbfb_Nx3UTpC49ga-MZ8,376
+ripperdoc/cli/commands/help_cmd.py,sha256=jyK6U2bsGEIwFpu08slVHKfxRyS3oblnRXdqSgU_W4w,978
+ripperdoc/cli/commands/hooks_cmd.py,sha256=-ixQhKb1CX2c7_2zDdAqXV9ThnMf31UH3a9UBERD9mw,21026
+ripperdoc/cli/commands/mcp_cmd.py,sha256=ZCnswx0TIiaiUUsIX7NpHaLZLZtvlUhBnN12s_ZtPCA,2424
+ripperdoc/cli/commands/memory_cmd.py,sha256=BsYYUosmnIs92mwgHH1e3DdzOj83iJ5_AJ8kBeSkRCw,6594
+ripperdoc/cli/commands/models_cmd.py,sha256=LYebi7s9kv6xxlSqX3Pb1AsWY9S-xp0ikdtPVECinvo,18635
+ripperdoc/cli/commands/permissions_cmd.py,sha256=aIMIvmt78nB2Q-Qa5ojqClUOsPRcoyeDIuhOJX8xg2k,11559
+ripperdoc/cli/commands/resume_cmd.py,sha256=Pil2gJIkjf9fIFrxTyVXTwS7kzsg14CVg1SNQPZYAmw,4295
+ripperdoc/cli/commands/skills_cmd.py,sha256=OFDLy2g_o_GDzdatk18E-Xv4bhVG80MQUr_PQLmTveQ,3496
+ripperdoc/cli/commands/stats_cmd.py,sha256=I6nFZndBy_VRcUAxXAjplSjIzA-5UqRK4HlQJbpHydg,7857
+ripperdoc/cli/commands/status_cmd.py,sha256=9pI_GF4mxR9cQXF-HEURZb0qO6GWp2hcy3rzaVW98II,5962
+ripperdoc/cli/commands/tasks_cmd.py,sha256=tghFKy0ENeJ9Mf0h5Waceq8l9JXP5xTLsJHP4ZkibbQ,9044
+ripperdoc/cli/commands/themes_cmd.py,sha256=b3Ti-KmRF9XVk1jtS7bkz5F8317yu1fyp1I89SSpfqI,4019
+ripperdoc/cli/commands/todos_cmd.py,sha256=7Q0B1NVqGtB3R29ndbn4m0VQQm-YQ7d4Wlk7vJ7dLQI,1848
+ripperdoc/cli/commands/tools_cmd.py,sha256=3cMi0vN4mAUhpKqJtRgNvZfcKzRPaMs_pkYYXlyvSSU,384
+ripperdoc/cli/ui/__init__.py,sha256=TxSzTYdITlrYmYVfins_w_jzPqqWRpqky5u1ikwvmtM,43
+ripperdoc/cli/ui/context_display.py,sha256=3ezdtHVwltkPQ5etYwfqUh-fjnpPu8B3P81UzrdHxZs,10020
+ripperdoc/cli/ui/file_mention_completer.py,sha256=ysNqZieQVlUb7DC4CP_FMKNeTG8AIqKLmJgl6HJBURo,13649
+ripperdoc/cli/ui/helpers.py,sha256=iM7kMb-fMTO6n4_MDVrESE1P-Y7w8PXiIhCCLp5yyA4,2618
+ripperdoc/cli/ui/interrupt_handler.py,sha256=6MwZ2wo1ZCdd4JGV5dWOzHkNDDce51z9Rhf0LdFjWTM,7107
+ripperdoc/cli/ui/message_display.py,sha256=W9VlRCpMykkamxphej5LHgmU-P4YaBfm9HPdIKlFKpg,10573
+ripperdoc/cli/ui/panels.py,sha256=kaf3sDG2AIcrdrqbASnqGYHySfSeMNozGFhqvZ4bTJs,2207
+ripperdoc/cli/ui/provider_options.py,sha256=Ic30K1ev8w2oEcha4IjDYSoxw1tyCVB4hLoQpS_Y_5E,8369
+ripperdoc/cli/ui/rich_ui.py,sha256=LZjmaCSfXf8Le5zq03e4PH2S0nlsSXW566q7mW-xWaA,76968
+ripperdoc/cli/ui/spinner.py,sha256=IlmMgyk-eA6Bk4fXDjbWs3AFL2iFPeWmnS0q28tWOgU,5175
+ripperdoc/cli/ui/thinking_spinner.py,sha256=3zmxj3vd-1njdiHF2Afsm7RGiRl7645AEc7fTLKgAbU,2805
+ripperdoc/cli/ui/tool_renderers.py,sha256=7ACcZoKU91kvFsk3YdP2TzibfI-W_F1dv-Ksr68rrYE,11280
+ripperdoc/cli/ui/wizard.py,sha256=bFKJeQStJ2Opq_ih9tgchkJP14bMvI-PX-zHVwzMiy8,7423
+ripperdoc/core/__init__.py,sha256=UemJCA-Y8df1466AX-YbRFj071zKajmqO1mi40YVW2g,40
+ripperdoc/core/agents.py,sha256=Xl1HEJz8v-xIEhzgObeysgrz-SQBYbxYVRI4CvRl-w8,20539
+ripperdoc/core/commands.py,sha256=NXCkljYbAP4dDoRy-_3semFNWxG4YAk9q82u8FTKH60,835
+ripperdoc/core/config.py,sha256=4KvaGKG4bf9wX6haPvxJllokdpPbJVvfTIMfsC0maag,29936
+ripperdoc/core/custom_commands.py,sha256=2BMYiBq15FDjl3aOa3styN6nARyfU7xFAb4ly2Vsp-w,14254
+ripperdoc/core/default_tools.py,sha256=mpb9mqmrAjMqgcmpRU_uQF1G6vpYbp8nkiwrh71KQyM,5250
+ripperdoc/core/permissions.py,sha256=yp7OK36_I_UceDnLbGmxPh6nSbIDfns4IgTVGH5Tkqs,16986
+ripperdoc/core/query.py,sha256=dC_sW2D2bPLI6nPM3VxFpTBA4fYYHHRNmE6zvy93pus,62057
+ripperdoc/core/query_utils.py,sha256=2OQYeobFD-24NG0CZnnm3D5HCJ7r8AOB08I-wpQhH1A,24888
+ripperdoc/core/skills.py,sha256=NGP_QFzL2SBkz8wZBGxNA_6Gt8qkRIZtJDnPs_DayxE,10511
+ripperdoc/core/system_prompt.py,sha256=d3GNCsJ_mdIojpWg1Wc0gRDC_gzRDI5G4tQN_gxhRdo,26752
+ripperdoc/core/theme.py,sha256=cQ0LTDxP2whFEsTRi421p1Rs7Epe9rlv-HgFirvIxzM,8427
+ripperdoc/core/tool.py,sha256=0ihPcsgr0Dz5kl9-8hCU-xaRui5_WCjIOnVTpshc8k0,8529
+ripperdoc/core/hooks/__init__.py,sha256=xw7VJQu1ZB0ENHVqL5xtruBnP3d0FNgrBH6NTL2xYgg,2735
+ripperdoc/core/hooks/config.py,sha256=wE_eMHDZu9-yHGyJ45ySL1_l2yx7B8i4jiThs78W6Zc,10085
+ripperdoc/core/hooks/events.py,sha256=UGBDdec52abi2e6ox8ncsLeDo3t9ZJesymKaPwxNDAE,18403
+ripperdoc/core/hooks/executor.py,sha256=3MdiCdc4Bn2xHcTlRT72BajrgAZ5roKck0NBnO4Re0c,16781
+ripperdoc/core/hooks/integration.py,sha256=IzkOSpaMjC397zKdKO1jTR0uyzOet-eCwPLuXwTYOts,11082
+ripperdoc/core/hooks/llm_callback.py,sha256=TsttZ8Q7c8-36ebbI8nTyYcKbA7Kr9rmY5UO2gzuL-c,1733
+ripperdoc/core/hooks/manager.py,sha256=dfHhB8f5US8ZN2a0JbzD5bQZHsnBS6Zs8xVZ2IcSsrg,25092
+ripperdoc/core/providers/__init__.py,sha256=yevsHF0AUI4b6Wiq_401NXewJ3dqe8LUUtQm0TLPPNQ,1911
+ripperdoc/core/providers/anthropic.py,sha256=B967szN1Thc0K1Iv8TvKWcVKktCevBmShftupVag8pk,28551
+ripperdoc/core/providers/base.py,sha256=HNOa3_XWszu6DbI8BYixxV0hnZb9qZ_FU4uinFVRHjU,9271
+ripperdoc/core/providers/gemini.py,sha256=Fs-dShsmIVBFfz-jg4fBjvQyrxVnZ5yx4ALcES-l5Sg,27089
+ripperdoc/core/providers/openai.py,sha256=BhvDvkDjeYJMbvI4mbswQXbjdab53oJduku-Yja1zmQ,25561
+ripperdoc/protocol/__init__.py,sha256=rSYu_Y2acRfsAE8gUTG82VnyrK3AFrIfwuJBf2cjHjs,325
+ripperdoc/protocol/models.py,sha256=goNurNKI0eGZeCGmr7KqMPkZMvMOABXWsb-8un0LDlc,7468
+ripperdoc/protocol/stdio.py,sha256=jia8cca3offyOc8kego-MnJfXsZkFwQw0cZZzfeFQqs,58933
+ripperdoc/tools/__init__.py,sha256=RBFz0DDnztDXMqv_zRxFHVY-ez2HYcncx8zh_y-BX6w,42
+ripperdoc/tools/ask_user_question_tool.py,sha256=ZWg5xAdeaRoR98KvvPuKmJH4L2dgzH87VXM4dxKcqBE,15478
+ripperdoc/tools/background_shell.py,sha256=VMJd0G7s1l7qSRvlkRaIbgWmj4N0U_sr0kLzBzVLO2A,21263
+ripperdoc/tools/bash_output_tool.py,sha256=cC5dDmKYmkOTsLCXCcTYgc0loVWtmRobPn0C-I6qO-o,3379
+ripperdoc/tools/bash_tool.py,sha256=m3jfukBBOSQUYJbntekTGGk3FIn1GKaZVvcqMWwLBYE,47598
+ripperdoc/tools/dynamic_mcp_tool.py,sha256=kxxWhp6pP9N8fK3ubu5fHQYQv7aSwxcnaa3C9ZsBbOU,15879
+ripperdoc/tools/enter_plan_mode_tool.py,sha256=LNQv43uWkohiQTYQdsrKbpAfQSJNE_FJ9Y6AM_ckjng,7976
+ripperdoc/tools/exit_plan_mode_tool.py,sha256=XxhEih5EUrcscvkRA9lel54XoVIhl_cCL2xcvMJjtVA,5756
+ripperdoc/tools/file_edit_tool.py,sha256=IHgaWbzR7NKpLJ5XOjxU24c5-RyseVJw-p3QFGtcKJQ,22190
+ripperdoc/tools/file_read_tool.py,sha256=TXEt_Q7RSaTx4qdx3_mOYP704UU6qRccL5_AqPlNFrY,13735
+ripperdoc/tools/file_write_tool.py,sha256=HqOkFYedacNsPatKxVhth0kI5fGh83tm2VxdD_pO-V0,8570
+ripperdoc/tools/glob_tool.py,sha256=eZG4fzahjJsSM8NdmTiVl5nBfDQK7egPg6P7cqOM_1Y,5948
+ripperdoc/tools/grep_tool.py,sha256=bqrliI6e-9cNKIOfxdCv6mBwHr_1BSLwAPSTbOTc4B4,18239
+ripperdoc/tools/kill_bash_tool.py,sha256=_jwnJVCPe8uXZTJd7myh4hWCD-eBuB2XDaYwRCmNSsI,4625
+ripperdoc/tools/ls_tool.py,sha256=JWQucgNOLjrGZwM7imu3GWe5YFwXxdXGoaBr50wDZCQ,15367
+ripperdoc/tools/lsp_tool.py,sha256=atpaaMqf3jld7SyNXtfdM6NkxYrp3KbYZ91oC4EqQlU,21315
+ripperdoc/tools/mcp_tools.py,sha256=BVz8MJhijNnHq1J2LLkZS89wp_pwwnOytH1HYcfkFqQ,23085
+ripperdoc/tools/multi_edit_tool.py,sha256=s9gN3oRPqeYjQxdsfnkfHSIMTrBs09ihV_TYuVqaey8,18446
+ripperdoc/tools/notebook_edit_tool.py,sha256=Y2XkQB4WDbSWeCsO3Ybnsrbcxki99aOv3o23jZ5D1Hw,14445
+ripperdoc/tools/skill_tool.py,sha256=8TcmNxpSGiBXd-ipgoD9BIopKkR13-3U56rkzozazhY,9763
+ripperdoc/tools/task_tool.py,sha256=SQW2yLM0yectI0dVBoaDF0Tp5T4yOYqvHpsFWapOE44,33979
+ripperdoc/tools/todo_tool.py,sha256=eIwF-s1117DrXJ4yXUMwkNs1gfKYNF2OlWzkJAXDzmk,20001
+ripperdoc/tools/tool_search_tool.py,sha256=AeY-tFtWr2IAHTCEnG9kvsRRBqrBd-PJ96oUnFKa3Vs,13890
+ripperdoc/utils/__init__.py,sha256=gdso60znB2hsYZ_YZBKVcuOY3QVfoqD2wHQ4pvr5lSw,37
+ripperdoc/utils/bash_constants.py,sha256=KNn8bzB6nVU5jid9jvjiH4FAu8pP3DZONJ-OknJypAQ,1641
+ripperdoc/utils/bash_output_utils.py,sha256=3Cf5wKJzRbUesmCNy5HtXIBtv0Z2BxklTfFHJ9q1T3w,1210
+ripperdoc/utils/coerce.py,sha256=KOPb4KR4p32nwHWG_6GsGHeVZunJyYc2YhC5DLmEZO8,1015
+ripperdoc/utils/context_length_errors.py,sha256=oyDVr_ME_6j97TLwVZ8bDMb6ISGQx6wEHrY7ckc0GuA,7714
+ripperdoc/utils/conversation_compaction.py,sha256=mbOYwQXXsAqiJ7mBQ25195bXtH3tb5GSU0HUNsvnl1g,18345
+ripperdoc/utils/exit_code_handlers.py,sha256=QtO1iDxVAb8Xp03D6_QixPoJC-RQlcp3ssIo_rm4two,7973
+ripperdoc/utils/file_watch.py,sha256=Oqx5elgE3_z6CSAKdTbIPna_E4SePBqDujpqqANcw9U,11823
+ripperdoc/utils/git_utils.py,sha256=Hq-Zx-KPyX4lp_i8ozhic15LyYdX_IfCRm-EyoFu59A,9047
+ripperdoc/utils/image_utils.py,sha256=52YRLN0NwPEHnL3-smYktx2T8Oh002W0nvZsxI-WFdo,3380
+ripperdoc/utils/json_utils.py,sha256=Bx1pHHu5r7GtvCqFHM3K9EoknFAtYOaCqTn9RN-5qBA,757
+ripperdoc/utils/log.py,sha256=niCsP__DSbgSAJfitmrsSkh3UjPw7NdYHURrx7DLRuU,7197
+ripperdoc/utils/lsp.py,sha256=4_zw1ZzbvMe16kn6U5EHyMyACX-m0Hr0AjoFXi1xsEQ,26844
+ripperdoc/utils/mcp.py,sha256=-8yZD6gc43BqiFmG3intZcyfVhAYusaXgoI8rJUSdGA,22621
+ripperdoc/utils/memory.py,sha256=J_kucw1BBnHQ1qG2_ZzdNysKvS1lrpuMtB5wxJDmXZU,8033
+ripperdoc/utils/message_compaction.py,sha256=FwYxjWc0B7IlzT1VPEyfhwEl8rXbDi37utbEbS5qGWw,22577
+ripperdoc/utils/message_formatting.py,sha256=9uA7c3MMuWTIp0SQAXkvuRsofKlQ_r0xRHD7ln5lR8s,7820
+ripperdoc/utils/messages.py,sha256=qX9vh81hZXQc3vHLTLfuiLrLwMkLc4XKpX7ZnTRzI7I,30987
+ripperdoc/utils/output_utils.py,sha256=R3wqFh9Dko_GK00Exx7XI0DnnldRWMsxZypYX5y6SJo,7448
+ripperdoc/utils/path_ignore.py,sha256=5VOk075Ef9Wz9LhAWjFQuXJfnypxTD0w9cZVoTGko2M,17882
+ripperdoc/utils/path_utils.py,sha256=C45Q3OeXnj-0FVEtvf_tdG5922XB6HthUzlUCvfc17Y,1626
+ripperdoc/utils/pending_messages.py,sha256=75DKO1SgVGMlzC_ycfKNJ_cktj_MFVFy60j4EXeRsM0,1683
+ripperdoc/utils/platform.py,sha256=Q-2hp0ywegEiuxK3TzE5Pg9wuHJiY8tPp9eoEMCtx4Y,5024
+ripperdoc/utils/prompt.py,sha256=zICNEsA_OtKx8t3zo9tHLXXu6G5K8rPO3jFLKz4j5tg,560
+ripperdoc/utils/safe_get_cwd.py,sha256=lYxFJAN7lomoLwTAfMZtyOueotuvhC8TN84NtrPKj1E,827
+ripperdoc/utils/sandbox_utils.py,sha256=G91P8dw2VFcCiCpjXZ4LvzbAPiO8REqMhw39eI5Z4dU,1123
+ripperdoc/utils/session_heatmap.py,sha256=o88ZlL9tFizOEbo92r6RKcfe2hscghVv7wS_REltZIw,8436
+ripperdoc/utils/session_history.py,sha256=S-z5TneMvyLvoITJG4bRKvr4bvh5LWp8rKIuekLaFA4,9716
+ripperdoc/utils/session_stats.py,sha256=xf5KKhNlzocPxMAS5fRUF6YVDH9fpqObfx_ah_iAMqA,9101
+ripperdoc/utils/session_usage.py,sha256=p8_s46zDTzV1qzP4HR4PuZmLeJvSfq9mG_Y5rCnRYyA,3213
+ripperdoc/utils/shell_token_utils.py,sha256=SduoSU-RERJdM_7gBn0urr5UXtl4XOpPgydBd2fwzWg,2500
+ripperdoc/utils/shell_utils.py,sha256=RQ0iMdvv0SQOs9vqDAaklLLOo0inC935DOjmy0iZKYc,5541
+ripperdoc/utils/todo.py,sha256=t0DJMHtwRBGf_uEx9zzDwp2K0TOoOT0NEhFXWm_YoR0,6807
+ripperdoc/utils/token_estimation.py,sha256=qPQbeUwVlafEjzsXw6qMo0hd4Vjb1gCUMAPBouYUASI,1066
+ripperdoc/utils/permissions/__init__.py,sha256=33FfOaDLepxJSkp0RLvTdVu7qBXuEcnOoTHFbEtFOt0,653
+ripperdoc/utils/permissions/path_validation_utils.py,sha256=KOegjWaph8tXU7aqwQXRAxFEzrmRuPvdLb36J1QIPDQ,5772
+ripperdoc/utils/permissions/shell_command_validation.py,sha256=BRi-1OGzr-Wiuxa00Ye6oqPctoJUZBOoRoi6dUiAsfM,33256
+ripperdoc/utils/permissions/tool_permission_utils.py,sha256=YqbYSXyR0RBbLibBtigYb9O9143mDRulsQCh_WwArvY,14653
+ripperdoc-0.3.0.dist-info/licenses/LICENSE,sha256=bRv9UhBor6GhnQDj12RciDcRfu0R7sB-lqCy1sWF75c,9242
+ripperdoc-0.3.0.dist-info/METADATA,sha256=fZifh_w_rlHCJHbkadgF5_g3oDi7bH_7M_qekoC4g1Y,8651
+ripperdoc-0.3.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+ripperdoc-0.3.0.dist-info/entry_points.txt,sha256=79aohFxFPJmrQ3-Mhain04vb3EWpuc0EyzvDDUnwAu4,81
+ripperdoc-0.3.0.dist-info/top_level.txt,sha256=u8LbdTr1a-laHgCO0Utl_R3QGFUhLxWelCDnP2ZgpCU,10
+ripperdoc-0.3.0.dist-info/RECORD,,

{ripperdoc-0.2.9.dist-info → ripperdoc-0.3.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.9.0)
+Generator: setuptools (80.10.2)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

ripperdoc/sdk/__init__.py

@@ -1,9 +0,0 @@
-"""Lightweight Python SDK for using Ripperdoc headlessly."""
-
-from ripperdoc.sdk.client import (
-    RipperdocClient,
-    RipperdocOptions,
-    query,
-)
-
-__all__ = ["RipperdocClient", "RipperdocOptions", "query"]

ripperdoc/sdk/client.py

@@ -1,333 +0,0 @@
-"""Headless Python SDK for Ripperdoc.
-
-`query` helper for simple calls and a `RipperdocClient` for long-lived
-sessions that keep conversation history.
-"""
-
-from __future__ import annotations
-
-import asyncio
-import os
-from dataclasses import dataclass, field
-from pathlib import Path
-from typing import (
-    Any,
-    AsyncIterator,
-    Awaitable,
-    Callable,
-    Dict,
-    List,
-    Optional,
-    Sequence,
-    Tuple,
-    Union,
-)
-
-from ripperdoc.core.default_tools import get_default_tools
-from ripperdoc.core.query import QueryContext, query as _core_query
-from ripperdoc.core.permissions import PermissionResult
-from ripperdoc.core.system_prompt import build_system_prompt
-from ripperdoc.core.skills import build_skill_summary, load_all_skills
-from ripperdoc.core.tool import Tool
-from ripperdoc.tools.task_tool import TaskTool
-from ripperdoc.tools.mcp_tools import load_dynamic_mcp_tools_async, merge_tools_with_dynamic
-from ripperdoc.utils.memory import build_memory_instructions
-from ripperdoc.utils.messages import (
-    AssistantMessage,
-    ProgressMessage,
-    UserMessage,
-    create_user_message,
-)
-from ripperdoc.utils.mcp import (
-    format_mcp_instructions,
-    load_mcp_servers_async,
-    shutdown_mcp_runtime,
-)
-from ripperdoc.utils.log import get_logger
-
-MessageType = Union[UserMessage, AssistantMessage, ProgressMessage]
-PermissionChecker = Callable[
-    [Tool[Any, Any], Any],
-    Union[
-        PermissionResult,
-        Dict[str, Any],
-        Tuple[bool, Optional[str]],
-        bool,
-        Awaitable[Union[PermissionResult, Dict[str, Any], Tuple[bool, Optional[str]], bool]],
-    ],
-]
-QueryRunner = Callable[
-    [
-        List[MessageType],
-        str,
-        Dict[str, str],
-        QueryContext,
-        Optional[PermissionChecker],
-    ],
-    AsyncIterator[MessageType],
-]
-
-_END_OF_STREAM = object()
-
-logger = get_logger()
-
-
-def _coerce_to_path(path: Union[str, Path]) -> Path:
-    return path if isinstance(path, Path) else Path(path)
-
-
-@dataclass
-class RipperdocOptions:
-    """Configuration for SDK usage."""
-
-    tools: Optional[Sequence[Tool[Any, Any]]] = None
-    allowed_tools: Optional[Sequence[str]] = None
-    disallowed_tools: Optional[Sequence[str]] = None
-    yolo_mode: bool = False
-    verbose: bool = False
-    model: str = "main"
-    max_thinking_tokens: int = 0
-    context: Dict[str, str] = field(default_factory=dict)
-    system_prompt: Optional[str] = None
-    additional_instructions: Optional[Union[str, Sequence[str]]] = None
-    permission_checker: Optional[PermissionChecker] = None
-    cwd: Optional[Union[str, Path]] = None
-
-    def build_tools(self) -> List[Tool[Any, Any]]:
-        """Create the tool set with allow/deny filters applied."""
-        base_tools = list(self.tools) if self.tools is not None else get_default_tools()
-        allowed = set(self.allowed_tools) if self.allowed_tools is not None else None
-        disallowed = set(self.disallowed_tools or [])
-
-        filtered: List[Tool[Any, Any]] = []
-        for tool in base_tools:
-            name = getattr(tool, "name", tool.__class__.__name__)
-            if allowed is not None and name not in allowed:
-                continue
-            if name in disallowed:
-                continue
-            filtered.append(tool)
-
-        if allowed is not None and not filtered:
-            raise ValueError("No tools remain after applying allowed_tools/disallowed_tools.")
-
-        # The default Task tool captures the original base tools. If filters are
-        # applied, recreate it so the subagent only sees the filtered set.
-        if (self.allowed_tools or self.disallowed_tools) and self.tools is None:
-            has_task = any(getattr(tool, "name", None) == "Task" for tool in filtered)
-            if has_task:
-                filtered_base = [tool for tool in filtered if getattr(tool, "name", None) != "Task"]
-
-                def _filtered_base_provider() -> List[Tool[Any, Any]]:
-                    return filtered_base
-
-                filtered = [
-                    (
-                        TaskTool(_filtered_base_provider)
-                        if getattr(tool, "name", None) == "Task"
-                        else tool
-                    )
-                    for tool in filtered
-                ]
-
-        return filtered
-
-    def extra_instructions(self) -> List[str]:
-        """Normalize additional instructions to a list."""
-        if self.additional_instructions is None:
-            return []
-        if isinstance(self.additional_instructions, str):
-            return [self.additional_instructions]
-        return [text for text in self.additional_instructions if text]
-
-
-class RipperdocClient:
-    """Persistent Ripperdoc session with conversation history."""
-
-    def __init__(
-        self,
-        options: Optional[RipperdocOptions] = None,
-        query_runner: Optional[QueryRunner] = None,
-    ) -> None:
-        self.options = options or RipperdocOptions()
-        self._tools = self.options.build_tools()
-        self._query_runner = query_runner or _core_query
-
-        self._history: List[MessageType] = []
-        self._queue: asyncio.Queue = asyncio.Queue()
-        self._current_task: Optional[asyncio.Task] = None
-        self._current_context: Optional[QueryContext] = None
-        self._connected = False
-        self._previous_cwd: Optional[Path] = None
-
-    @property
-    def tools(self) -> List[Tool[Any, Any]]:
-        return self._tools
-
-    @property
-    def history(self) -> List[MessageType]:
-        return list(self._history)
-
-    async def __aenter__(self) -> "RipperdocClient":
-        await self.connect()
-        return self
-
-    async def __aexit__(self, exc_type: Any, exc: Any, tb: Any) -> None:  # type: ignore[override]
-        await self.disconnect()
-
-    async def connect(self, prompt: Optional[str] = None) -> None:
-        """Prepare the session and optionally send an initial prompt."""
-        if not self._connected:
-            if self.options.cwd is not None:
-                self._previous_cwd = Path.cwd()
-                os.chdir(_coerce_to_path(self.options.cwd))
-            self._connected = True
-
-        if prompt:
-            await self.query(prompt)
-
-    async def disconnect(self) -> None:
-        """Tear down the session and restore the working directory."""
-        if self._current_context:
-            self._current_context.abort_controller.set()
-
-        if self._current_task and not self._current_task.done():
-            self._current_task.cancel()
-            try:
-                await self._current_task
-            except asyncio.CancelledError:
-                pass
-
-        if self._previous_cwd:
-            os.chdir(self._previous_cwd)
-            self._previous_cwd = None
-
-        self._connected = False
-        await shutdown_mcp_runtime()
-
-    async def query(self, prompt: str) -> None:
-        """Send a prompt and start streaming the response."""
-        if self._current_task and not self._current_task.done():
-            raise RuntimeError(
-                "A query is already in progress; wait for it to finish or interrupt it."
-            )
-
-        if not self._connected:
-            await self.connect()
-
-        self._queue = asyncio.Queue()
-
-        user_message = create_user_message(prompt)
-        history = list(self._history) + [user_message]
-        self._history.append(user_message)
-
-        system_prompt = await self._build_system_prompt(prompt)
-        context = dict(self.options.context)
-
-        query_context = QueryContext(
-            tools=self._tools,
-            max_thinking_tokens=self.options.max_thinking_tokens,
-            yolo_mode=self.options.yolo_mode,
-            model=self.options.model,
-            verbose=self.options.verbose,
-        )
-        self._current_context = query_context
-
-        async def _runner() -> None:
-            try:
-                async for message in self._query_runner(
-                    history,
-                    system_prompt,
-                    context,
-                    query_context,
-                    self.options.permission_checker,
-                ):
-                    if getattr(message, "type", None) in ("user", "assistant"):
-                        self._history.append(message)  # type: ignore[arg-type]
-                    await self._queue.put(message)
-            finally:
-                await self._queue.put(_END_OF_STREAM)
-
-        self._current_task = asyncio.create_task(_runner())
-
-    async def receive_messages(self) -> AsyncIterator[MessageType]:
-        """Yield messages for the active query."""
-        if self._current_task is None:
-            raise RuntimeError("No active query to receive messages from.")
-
-        while True:
-            message = await self._queue.get()
-            if message is _END_OF_STREAM:
-                break
-            yield message  # type: ignore[misc]
-
-    async def receive_response(self) -> AsyncIterator[MessageType]:
-        """Alias for receive_messages."""
-        async for message in self.receive_messages():
-            yield message
-
-    async def interrupt(self) -> None:
-        """Request cancellation of the active query."""
-        if self._current_context:
-            self._current_context.abort_controller.set()
-
-        if self._current_task and not self._current_task.done():
-            self._current_task.cancel()
-            try:
-                await self._current_task
-            except asyncio.CancelledError:
-                pass
-
-        await self._queue.put(_END_OF_STREAM)
-
-    async def _build_system_prompt(self, user_prompt: str) -> str:
-        if self.options.system_prompt:
-            return self.options.system_prompt
-
-        instructions: List[str] = []
-        project_path = _coerce_to_path(self.options.cwd or Path.cwd())
-        skill_result = load_all_skills(project_path)
-        for err in skill_result.errors:
-            logger.warning(
-                "[skills] Failed to load skill",
-                extra={"path": str(err.path), "reason": err.reason},
-            )
-        skill_instructions = build_skill_summary(skill_result.skills)
-        if skill_instructions:
-            instructions.append(skill_instructions)
-        instructions.extend(self.options.extra_instructions())
-        memory = build_memory_instructions()
-        if memory:
-            instructions.append(memory)
-
-        dynamic_tools = await load_dynamic_mcp_tools_async(project_path)
-        if dynamic_tools:
-            self._tools = merge_tools_with_dynamic(self._tools, dynamic_tools)
-
-        servers = await load_mcp_servers_async(project_path)
-        mcp_instructions = format_mcp_instructions(servers)
-
-        return build_system_prompt(
-            self._tools,
-            user_prompt,
-            dict(self.options.context),
-            instructions or None,
-            mcp_instructions=mcp_instructions,
-        )
-
-
-async def query(
-    prompt: str,
-    options: Optional[RipperdocOptions] = None,
-    query_runner: Optional[QueryRunner] = None,
-) -> AsyncIterator[MessageType]:
-    """One-shot helper: run a prompt in a fresh session."""
-    client = RipperdocClient(options=options, query_runner=query_runner)
-    await client.connect()
-    await client.query(prompt)
-
-    try:
-        async for message in client.receive_messages():
-            yield message
-    finally:
-        await client.disconnect()