basic-open-agent-tools 1.3.0__tar.gz → 1.3.2__tar.gz

basic_open_agent_tools-1.3.2/PKG-INFO

@@ -0,0 +1,298 @@
+Metadata-Version: 2.4
+Name: basic-open-agent-tools
+Version: 1.3.2
+Summary: An open foundational toolkit providing essential components for building AI agents with minimal dependencies for local (non-HTTP/API) actions.
+Author-email: Open Agent Tools <unseriousai@gmail.com>
+Project-URL: Homepage, https://github.com/open-agent-tools/basic-open-agent-tools
+Project-URL: Documentation, https://github.com/open-agent-tools/basic-open-agent-tools#readme
+Project-URL: Repository, https://github.com/open-agent-tools/basic-open-agent-tools
+Project-URL: Issues, https://github.com/open-agent-tools/basic-open-agent-tools/issues
+Keywords: ai,agents,toolkit,automation,local-tools
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Communications :: Chat
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: system
+Requires-Dist: psutil>=5.9.0; extra == "system"
+Provides-Extra: pdf
+Requires-Dist: PyPDF2>=3.0.0; extra == "pdf"
+Requires-Dist: reportlab>=4.0.0; extra == "pdf"
+Provides-Extra: xml
+Requires-Dist: lxml>=4.9.0; extra == "xml"
+Requires-Dist: defusedxml>=0.7.1; extra == "xml"
+Provides-Extra: word
+Requires-Dist: python-docx>=0.8.11; extra == "word"
+Provides-Extra: excel
+Requires-Dist: openpyxl>=3.1.0; extra == "excel"
+Provides-Extra: powerpoint
+Requires-Dist: python-pptx>=0.6.21; extra == "powerpoint"
+Provides-Extra: image
+Requires-Dist: Pillow>=10.0.0; extra == "image"
+Provides-Extra: data
+Requires-Dist: pyyaml>=6.0.0; extra == "data"
+Requires-Dist: tomli>=2.0.0; python_version < "3.11" and extra == "data"
+Requires-Dist: tomli-w>=1.0.0; extra == "data"
+Provides-Extra: all
+Requires-Dist: psutil>=5.9.0; extra == "all"
+Requires-Dist: PyPDF2>=3.0.0; extra == "all"
+Requires-Dist: reportlab>=4.0.0; extra == "all"
+Requires-Dist: lxml>=4.9.0; extra == "all"
+Requires-Dist: defusedxml>=0.7.1; extra == "all"
+Requires-Dist: python-docx>=0.8.11; extra == "all"
+Requires-Dist: openpyxl>=3.1.0; extra == "all"
+Requires-Dist: python-pptx>=0.6.21; extra == "all"
+Requires-Dist: Pillow>=10.0.0; extra == "all"
+Requires-Dist: pyyaml>=6.0.0; extra == "all"
+Requires-Dist: tomli>=2.0.0; python_version < "3.11" and extra == "all"
+Requires-Dist: tomli-w>=1.0.0; extra == "all"
+Provides-Extra: strands
+Requires-Dist: strands>=0.1.0; extra == "strands"
+Requires-Dist: anthropic>=0.25.0; extra == "strands"
+Requires-Dist: python-dotenv>=1.0.0; extra == "strands"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: pre-commit>=3.0.0; extra == "dev"
+Requires-Dist: freezegun>=1.2.0; extra == "dev"
+Requires-Dist: tomli>=2.0.0; python_version < "3.11" and extra == "dev"
+Requires-Dist: tomli-w>=1.0.0; extra == "dev"
+Requires-Dist: pyyaml>=6.0.0; extra == "dev"
+Requires-Dist: google-adk[eval]>=0.1.0; extra == "dev"
+Requires-Dist: psutil>=5.9.0; extra == "dev"
+Requires-Dist: PyPDF2>=3.0.0; extra == "dev"
+Requires-Dist: reportlab>=4.0.0; extra == "dev"
+Requires-Dist: lxml>=4.9.0; extra == "dev"
+Requires-Dist: defusedxml>=0.7.1; extra == "dev"
+Requires-Dist: python-docx>=0.8.11; extra == "dev"
+Requires-Dist: openpyxl>=3.1.0; extra == "dev"
+Requires-Dist: python-pptx>=0.6.21; extra == "dev"
+Requires-Dist: Pillow>=10.0.0; extra == "dev"
+Requires-Dist: strands>=0.1.0; extra == "dev"
+Requires-Dist: anthropic>=0.25.0; extra == "dev"
+Requires-Dist: python-dotenv>=1.0.0; extra == "dev"
+Provides-Extra: test
+Requires-Dist: pytest>=7.0.0; extra == "test"
+Requires-Dist: pytest-cov>=4.0.0; extra == "test"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "test"
+Requires-Dist: freezegun>=1.2.0; extra == "test"
+Requires-Dist: tomli>=2.0.0; python_version < "3.11" and extra == "test"
+Requires-Dist: tomli-w>=1.0.0; extra == "test"
+Requires-Dist: pyyaml>=6.0.0; extra == "test"
+Requires-Dist: google-adk[eval]>=0.1.0; extra == "test"
+Requires-Dist: psutil>=5.9.0; extra == "test"
+Requires-Dist: PyPDF2>=3.0.0; extra == "test"
+Requires-Dist: reportlab>=4.0.0; extra == "test"
+Requires-Dist: lxml>=4.9.0; extra == "test"
+Requires-Dist: defusedxml>=0.7.1; extra == "test"
+Requires-Dist: python-docx>=0.8.11; extra == "test"
+Requires-Dist: openpyxl>=3.1.0; extra == "test"
+Requires-Dist: python-pptx>=0.6.21; extra == "test"
+Requires-Dist: Pillow>=10.0.0; extra == "test"
+Dynamic: license-file
+
+# basic-open-agent-tools
+
+An open foundational toolkit providing essential components for building AI agents with minimal dependencies for local (non-HTTP/API) actions.
+
+## Installation
+
+```bash
+pip install basic-open-agent-tools
+```
+
+Or with UV:
+```bash
+uv add basic-open-agent-tools
+```
+
+### Optional Dependencies
+
+```bash
+pip install basic-open-agent-tools[all]          # Everything
+pip install basic-open-agent-tools[system]       # Process management, system info
+pip install basic-open-agent-tools[pdf]          # PDF reading and creation
+pip install basic-open-agent-tools[xml]          # XML parsing and validation
+pip install basic-open-agent-tools[word]         # Word document operations
+pip install basic-open-agent-tools[excel]        # Excel spreadsheet operations
+pip install basic-open-agent-tools[powerpoint]   # PowerPoint presentations
+pip install basic-open-agent-tools[image]        # Image processing
+pip install basic-open-agent-tools[data]         # YAML and TOML support
+```
+
+## Quick Start
+
+```python
+import basic_open_agent_tools as boat
+
+# Essential tools for general-purpose agents (~23 tools)
+tools = boat.load_essential()
+
+# Pre-configured loadouts for specific roles
+tools = boat.load_coder_loadout()              # ~105 tools for development
+tools = boat.load_docs_loadout()               # ~130 tools for documentation
+tools = boat.load_data_analyst_loadout()       # ~115 tools for data analysis
+tools = boat.load_web_publisher_loadout()      # ~90 tools for web content
+tools = boat.load_visual_designer_loadout()    # ~60 tools for graphics
+tools = boat.load_office_suite_loadout()       # ~80 tools for Office work
+
+# Or load everything
+tools = boat.load_all_tools()                  # All 337 functions
+
+# Use with any agent framework
+from google.adk.agents import Agent
+agent = Agent(tools=boat.load_coder_loadout())
+```
+
+## Available Modules
+
+**21 modules** with **337 total functions** — all with `@strands_tool` decorator and Google ADK compatible signatures.
+
+| Module | Count | Description |
+|--------|------:|-------------|
+| **Core Operations** | | |
+| `file_system` | 19 | File/directory operations, tree generation |
+| `text` | 10 | Text processing, case conversion, formatting |
+| `data` | 23 | JSON, CSV, YAML, TOML processing and validation |
+| `datetime` | 46 | Date/time operations, timezones, formatting, parsing |
+| **Document Processing** | | |
+| `excel` | 24 | Spreadsheet reading, writing, formatting, charts |
+| `xml` | 24 | XML parsing, authoring, validation, transformation |
+| `pdf` | 20 | PDF creation, reading, manipulation |
+| `word` | 18 | Word document operations and formatting |
+| `html` | 17 | HTML generation and parsing |
+| `diagrams` | 16 | Mermaid and PlantUML diagram generation |
+| `markdown` | 17 | Markdown generation, parsing, HTML conversion |
+| `powerpoint` | 10 | PowerPoint presentation operations |
+| **System & Network** | | |
+| `system` | 19 | Shell commands, process management, environment |
+| `network` | 4 | HTTP client, DNS lookup, port checking |
+| `utilities` | 8 | Debugging, timing, performance tools |
+| **Security & Data** | | |
+| `crypto` | 14 | Hashing, encoding, UUID/token generation |
+| `color` | 14 | Color conversion, palette generation, analysis |
+| `image` | 12 | Image manipulation and metadata reading |
+| `archive` | 9 | ZIP, TAR, GZIP, BZIP2, XZ compression |
+| **Task Management** | | |
+| `todo` | 8 | Task creation, validation, management |
+| `logging` | 5 | Structured logging and log rotation |
+
+## Key Features
+
+- **Agent-Friendly** — Simplified type signatures prevent "signature too complex" errors
+- **Minimal Dependencies** — Pure Python core; optional deps only when needed
+- **Modular** — Load only what you need
+- **Multi-Framework** — Works with Google ADK, LangChain, Strands Agents, custom frameworks
+- **Smart Confirmations** — Write/delete operations adapt to interactive, agent, or automation contexts
+- **Pre-configured Loadouts** — 6 curated tool bundles optimized for specific use cases
+
+## Loadouts
+
+Choose the right loadout for your agent's role to minimize token usage and maximize relevance:
+
+| Loadout | Tools | Best For | Includes |
+|---------|------:|----------|----------|
+| `load_coder_loadout()` | ~105 | Dev, DevOps, automation | File system, system ops, network, logging, crypto, archive, configs |
+| `load_docs_loadout()` | ~130 | Technical writing, reports | Word, PDF, Markdown, HTML, diagrams, images, text |
+| `load_data_analyst_loadout()` | ~115 | Data/financial analysis, BI | Excel, CSV, validation, diagrams, JSON, YAML, XML |
+| `load_web_publisher_loadout()` | ~90 | Web dev, content management | HTML, XML, Markdown, network, text processing |
+| `load_visual_designer_loadout()` | ~60 | Graphics, infographics | Image processing, diagrams, color tools |
+| `load_office_suite_loadout()` | ~80 | Office productivity | Excel, Word, PowerPoint, file operations |
+
+## Tool Loaders
+
+Beyond loadouts, build custom tool sets by combining loaders:
+
+```python
+import basic_open_agent_tools as boat
+
+# Use-case focused loaders
+boat.load_essential()              # ~23 most commonly needed tools
+boat.load_core_readonly()          # 28 read-only tools (filesystem, text, data parsing)
+boat.load_converters()             # 78 pure transformation tools (text, datetime, crypto, color)
+boat.load_document_readers()       # Extract content from PDF, Word, Excel, PowerPoint, images
+boat.load_writers()                # All file creation/modification tools
+boat.load_analyst_tools()          # Data analysis and validation tools
+boat.load_web_tools()              # HTML, Markdown, network operations
+boat.load_devtools()               # Debugging, logging, performance measurement
+boat.load_structured_data_tools()  # CSV, JSON, XML, YAML, TOML, INI
+boat.load_office_suite()           # Excel, Word, PowerPoint tools
+boat.load_markup_tools()           # HTML, Markdown, XML processing
+
+# Per-module loaders (21 total — one for each module)
+boat.load_all_filesystem_tools()
+boat.load_all_text_tools()
+boat.load_all_data_tools()
+# ... etc.
+
+# Combine and deduplicate
+custom = boat.merge_tool_lists(
+    boat.load_all_filesystem_tools(),
+    boat.load_all_text_tools(),
+    boat.load_all_data_tools(),
+)
+
+# Inspect available tools
+boat.list_all_available_tools()    # List all tool names
+boat.get_tool_info(some_tool)      # Get tool metadata
+```
+
+## Safety Features
+
+All write/delete operations include a `skip_confirm` parameter with three modes:
+
+| Mode | When | Behavior |
+|------|------|----------|
+| **Bypass** | `skip_confirm=True` or `BYPASS_TOOL_CONSENT=true` env var | Proceeds immediately — for CI/CD and automation |
+| **Interactive** | Terminal with `skip_confirm=False` | Prompts user with `y/n` and preview info |
+| **Agent** | Non-TTY with `skip_confirm=False` | Raises `CONFIRMATION_REQUIRED` error; LLM can ask user and retry |
+
+```python
+# Safe by default — adapts to context
+boat.file_system.write_file_from_string(
+    file_path="/tmp/example.txt",
+    content="Hello, World!",
+    skip_confirm=False  # Interactive prompt OR agent error
+)
+
+# Explicit bypass
+boat.file_system.write_file_from_string(
+    file_path="/tmp/example.txt",
+    content="Updated content",
+    skip_confirm=True
+)
+```
+
+## Documentation
+
+- **[Getting Started](docs/getting-started.md)** — Installation and setup
+- **[API Reference](docs/api-reference.md)** — Complete function reference
+- **[Examples](docs/examples.md)** — Usage examples and patterns
+- **[FAQ](docs/faq.md)** — Troubleshooting and common questions
+- **[Contributing](docs/contributing.md)** — Development guidelines
+- **[Changelog](CHANGELOG.md)** — Version history
+
+## Contributing
+
+We welcome contributions! See our [Contributing Guide](docs/contributing.md) for development setup, coding standards, and pull request process.
+
+## License
+
+MIT License — see [LICENSE](LICENSE) for details.

basic_open_agent_tools-1.3.2/README.md

@@ -0,0 +1,188 @@
+# basic-open-agent-tools
+
+An open foundational toolkit providing essential components for building AI agents with minimal dependencies for local (non-HTTP/API) actions.
+
+## Installation
+
+```bash
+pip install basic-open-agent-tools
+```
+
+Or with UV:
+```bash
+uv add basic-open-agent-tools
+```
+
+### Optional Dependencies
+
+```bash
+pip install basic-open-agent-tools[all]          # Everything
+pip install basic-open-agent-tools[system]       # Process management, system info
+pip install basic-open-agent-tools[pdf]          # PDF reading and creation
+pip install basic-open-agent-tools[xml]          # XML parsing and validation
+pip install basic-open-agent-tools[word]         # Word document operations
+pip install basic-open-agent-tools[excel]        # Excel spreadsheet operations
+pip install basic-open-agent-tools[powerpoint]   # PowerPoint presentations
+pip install basic-open-agent-tools[image]        # Image processing
+pip install basic-open-agent-tools[data]         # YAML and TOML support
+```
+
+## Quick Start
+
+```python
+import basic_open_agent_tools as boat
+
+# Essential tools for general-purpose agents (~23 tools)
+tools = boat.load_essential()
+
+# Pre-configured loadouts for specific roles
+tools = boat.load_coder_loadout()              # ~105 tools for development
+tools = boat.load_docs_loadout()               # ~130 tools for documentation
+tools = boat.load_data_analyst_loadout()       # ~115 tools for data analysis
+tools = boat.load_web_publisher_loadout()      # ~90 tools for web content
+tools = boat.load_visual_designer_loadout()    # ~60 tools for graphics
+tools = boat.load_office_suite_loadout()       # ~80 tools for Office work
+
+# Or load everything
+tools = boat.load_all_tools()                  # All 337 functions
+
+# Use with any agent framework
+from google.adk.agents import Agent
+agent = Agent(tools=boat.load_coder_loadout())
+```
+
+## Available Modules
+
+**21 modules** with **337 total functions** — all with `@strands_tool` decorator and Google ADK compatible signatures.
+
+| Module | Count | Description |
+|--------|------:|-------------|
+| **Core Operations** | | |
+| `file_system` | 19 | File/directory operations, tree generation |
+| `text` | 10 | Text processing, case conversion, formatting |
+| `data` | 23 | JSON, CSV, YAML, TOML processing and validation |
+| `datetime` | 46 | Date/time operations, timezones, formatting, parsing |
+| **Document Processing** | | |
+| `excel` | 24 | Spreadsheet reading, writing, formatting, charts |
+| `xml` | 24 | XML parsing, authoring, validation, transformation |
+| `pdf` | 20 | PDF creation, reading, manipulation |
+| `word` | 18 | Word document operations and formatting |
+| `html` | 17 | HTML generation and parsing |
+| `diagrams` | 16 | Mermaid and PlantUML diagram generation |
+| `markdown` | 17 | Markdown generation, parsing, HTML conversion |
+| `powerpoint` | 10 | PowerPoint presentation operations |
+| **System & Network** | | |
+| `system` | 19 | Shell commands, process management, environment |
+| `network` | 4 | HTTP client, DNS lookup, port checking |
+| `utilities` | 8 | Debugging, timing, performance tools |
+| **Security & Data** | | |
+| `crypto` | 14 | Hashing, encoding, UUID/token generation |
+| `color` | 14 | Color conversion, palette generation, analysis |
+| `image` | 12 | Image manipulation and metadata reading |
+| `archive` | 9 | ZIP, TAR, GZIP, BZIP2, XZ compression |
+| **Task Management** | | |
+| `todo` | 8 | Task creation, validation, management |
+| `logging` | 5 | Structured logging and log rotation |
+
+## Key Features
+
+- **Agent-Friendly** — Simplified type signatures prevent "signature too complex" errors
+- **Minimal Dependencies** — Pure Python core; optional deps only when needed
+- **Modular** — Load only what you need
+- **Multi-Framework** — Works with Google ADK, LangChain, Strands Agents, custom frameworks
+- **Smart Confirmations** — Write/delete operations adapt to interactive, agent, or automation contexts
+- **Pre-configured Loadouts** — 6 curated tool bundles optimized for specific use cases
+
+## Loadouts
+
+Choose the right loadout for your agent's role to minimize token usage and maximize relevance:
+
+| Loadout | Tools | Best For | Includes |
+|---------|------:|----------|----------|
+| `load_coder_loadout()` | ~105 | Dev, DevOps, automation | File system, system ops, network, logging, crypto, archive, configs |
+| `load_docs_loadout()` | ~130 | Technical writing, reports | Word, PDF, Markdown, HTML, diagrams, images, text |
+| `load_data_analyst_loadout()` | ~115 | Data/financial analysis, BI | Excel, CSV, validation, diagrams, JSON, YAML, XML |
+| `load_web_publisher_loadout()` | ~90 | Web dev, content management | HTML, XML, Markdown, network, text processing |
+| `load_visual_designer_loadout()` | ~60 | Graphics, infographics | Image processing, diagrams, color tools |
+| `load_office_suite_loadout()` | ~80 | Office productivity | Excel, Word, PowerPoint, file operations |
+
+## Tool Loaders
+
+Beyond loadouts, build custom tool sets by combining loaders:
+
+```python
+import basic_open_agent_tools as boat
+
+# Use-case focused loaders
+boat.load_essential()              # ~23 most commonly needed tools
+boat.load_core_readonly()          # 28 read-only tools (filesystem, text, data parsing)
+boat.load_converters()             # 78 pure transformation tools (text, datetime, crypto, color)
+boat.load_document_readers()       # Extract content from PDF, Word, Excel, PowerPoint, images
+boat.load_writers()                # All file creation/modification tools
+boat.load_analyst_tools()          # Data analysis and validation tools
+boat.load_web_tools()              # HTML, Markdown, network operations
+boat.load_devtools()               # Debugging, logging, performance measurement
+boat.load_structured_data_tools()  # CSV, JSON, XML, YAML, TOML, INI
+boat.load_office_suite()           # Excel, Word, PowerPoint tools
+boat.load_markup_tools()           # HTML, Markdown, XML processing
+
+# Per-module loaders (21 total — one for each module)
+boat.load_all_filesystem_tools()
+boat.load_all_text_tools()
+boat.load_all_data_tools()
+# ... etc.
+
+# Combine and deduplicate
+custom = boat.merge_tool_lists(
+    boat.load_all_filesystem_tools(),
+    boat.load_all_text_tools(),
+    boat.load_all_data_tools(),
+)
+
+# Inspect available tools
+boat.list_all_available_tools()    # List all tool names
+boat.get_tool_info(some_tool)      # Get tool metadata
+```
+
+## Safety Features
+
+All write/delete operations include a `skip_confirm` parameter with three modes:
+
+| Mode | When | Behavior |
+|------|------|----------|
+| **Bypass** | `skip_confirm=True` or `BYPASS_TOOL_CONSENT=true` env var | Proceeds immediately — for CI/CD and automation |
+| **Interactive** | Terminal with `skip_confirm=False` | Prompts user with `y/n` and preview info |
+| **Agent** | Non-TTY with `skip_confirm=False` | Raises `CONFIRMATION_REQUIRED` error; LLM can ask user and retry |
+
+```python
+# Safe by default — adapts to context
+boat.file_system.write_file_from_string(
+    file_path="/tmp/example.txt",
+    content="Hello, World!",
+    skip_confirm=False  # Interactive prompt OR agent error
+)
+
+# Explicit bypass
+boat.file_system.write_file_from_string(
+    file_path="/tmp/example.txt",
+    content="Updated content",
+    skip_confirm=True
+)
+```
+
+## Documentation
+
+- **[Getting Started](docs/getting-started.md)** — Installation and setup
+- **[API Reference](docs/api-reference.md)** — Complete function reference
+- **[Examples](docs/examples.md)** — Usage examples and patterns
+- **[FAQ](docs/faq.md)** — Troubleshooting and common questions
+- **[Contributing](docs/contributing.md)** — Development guidelines
+- **[Changelog](CHANGELOG.md)** — Version history
+
+## Contributing
+
+We welcome contributions! See our [Contributing Guide](docs/contributing.md) for development setup, coding standards, and pull request process.
+
+## License
+
+MIT License — see [LICENSE](LICENSE) for details.

{basic_open_agent_tools-1.3.0 → basic_open_agent_tools-1.3.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta:__legacy__"
 
 [project]
 name = "basic-open-agent-tools"
-version = "1.3.0"
+version = "1.3.2"
 description = "An open foundational toolkit providing essential components for building AI agents with minimal dependencies for local (non-HTTP/API) actions."
 readme = "README.md"
 requires-python = ">=3.9"
@@ -108,7 +108,7 @@ dev = [
     "tomli>=2.0.0; python_version < '3.11'",
     "tomli-w>=1.0.0",
     "pyyaml>=6.0.0",
-    "google-adk>=0.1.0",
+    "google-adk[eval]>=0.1.0",
     "psutil>=5.9.0",
     "PyPDF2>=3.0.0",
     "reportlab>=4.0.0",
@@ -131,7 +131,7 @@ test = [
     "tomli>=2.0.0; python_version < '3.11'",
     "tomli-w>=1.0.0",
     "pyyaml>=6.0.0",
-    "google-adk>=0.1.0",
+    "google-adk[eval]>=0.1.0",
     "psutil>=5.9.0",
     "PyPDF2>=3.0.0",
     "reportlab>=4.0.0",
@@ -191,10 +191,18 @@ warn_unused_ignores = false  # Changed: optional strands import creates unused i
 warn_no_return = true
 warn_unreachable = true
 strict_equality = true
+exclude = [
+    'venv',
+    '.venv',
+    'env',
+    '.env',
+]
 
 [[tool.mypy.overrides]]
 module = ["strands", "strands.*", "pkg_resources", "PyPDF2", "reportlab", "reportlab.*", "docx", "docx.*", "openpyxl", "openpyxl.*", "pptx", "pptx.*", "PIL", "PIL.*", "defusedxml", "defusedxml.*"]
 ignore_missing_imports = true
+follow_imports = "skip"
+ignore_errors = true
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]

{basic_open_agent_tools-1.3.0 → basic_open_agent_tools-1.3.2}/src/basic_open_agent_tools/__init__.py

@@ -4,7 +4,7 @@ An open foundational toolkit providing essential components for building AI agen
 with minimal dependencies for local (non-HTTP/API) actions.
 """
 
-__version__ = "1.3.0"
+__version__ = "1.3.2"
 
 # Modular structure
 from . import (

{basic_open_agent_tools-1.3.0 → basic_open_agent_tools-1.3.2}/src/basic_open_agent_tools/helpers.py

@@ -1163,8 +1163,9 @@ def load_essential() -> list[Callable[..., Any]]:
     Perfect for agents that need basic file operations, data processing,
     and common utilities without overwhelming them with specialized tools.
 
-    Includes (~22 essential tools):
-    - File I/O: read, write, list, check existence (7 tools)
+    Includes (~24 essential tools):
+    - File I/O: read, write, list, check existence, cwd (8 tools)
+    - Shell: execute shell commands (1 tool)
     - Data: JSON/CSV/YAML read/write (6 tools)
     - Text: whitespace cleaning (1 tool)
     - Time: current date and datetime (2 tools)
@@ -1178,7 +1179,7 @@ def load_essential() -> list[Callable[..., Any]]:
 
     Example:
         >>> essential_tools = load_essential()
-        >>> len(essential_tools) >= 20
+        >>> len(essential_tools) >= 22
         True
         >>> # Use for a general-purpose agent
         >>> agent = Agent(
@@ -1199,11 +1200,12 @@ def load_essential() -> list[Callable[..., Any]]:
         write_file_from_string,
     )
     from .network import http_request
+    from .system import execute_shell_command, get_current_directory
     from .text import clean_whitespace
 
     tools: list[Callable[..., Any]] = []
 
-    # Core file operations (7 tools)
+    # Core file operations (8 tools)
     tools.extend(
         [
             read_file_to_string,
@@ -1213,6 +1215,7 @@ def load_essential() -> list[Callable[..., Any]]:
             file_exists,
             directory_exists,
             delete_file,
+            get_current_directory,
         ]
     )
 
@@ -1237,6 +1240,9 @@ def load_essential() -> list[Callable[..., Any]]:
     # Crypto utilities (2 tools)
     tools.extend([hash_sha256, generate_uuid])
 
+    # Shell (1 tool)
+    tools.append(execute_shell_command)
+
     # Network (1 tool)
     tools.append(http_request)
 

{basic_open_agent_tools-1.3.0 → basic_open_agent_tools-1.3.2}/src/basic_open_agent_tools/todo/persistence.py

@@ -242,6 +242,9 @@ def _build_id_mapping(
 ) -> dict[int, int]:
     """Build mapping of old IDs to new IDs for renumbering.
 
+    Only renumber tasks that have ID conflicts with current tasks.
+    Non-conflicting tasks keep their original IDs.
+
     Args:
         file_tasks: Tasks from file (keyed by task ID)
         current_tasks: Current tasks in memory (keyed by task ID)
@@ -251,20 +254,26 @@ def _build_id_mapping(
         Dictionary mapping old_id -> new_id
     """
     id_mapping = {}
-    current_next_id = next_id
 
-    # Sort file tasks by ID for consistent numbering
+    # Assign IDs: conflicts get new IDs, non-conflicts keep original
     for old_id in sorted(file_tasks.keys()):
-        if old_id in current_tasks:
-            # Conflict - assign new ID
-            id_mapping[old_id] = current_next_id
-            current_next_id += 1
-        else:
+        if old_id not in current_tasks:
             # No conflict - keep original ID
             id_mapping[old_id] = old_id
-            # Update next_id if we're using a higher ID
-            if old_id >= current_next_id:
-                current_next_id = old_id + 1
+        # Conflicts will be handled in the next loop
+
+    # Now handle conflicts by assigning sequential IDs
+    used_ids = set(current_tasks.keys()) | set(id_mapping.values())
+    new_id = next_id
+
+    for old_id in sorted(file_tasks.keys()):
+        if old_id in current_tasks:
+            # Conflict - find next available ID
+            while new_id in used_ids:
+                new_id += 1
+            id_mapping[old_id] = new_id
+            used_ids.add(new_id)
+            new_id += 1
 
     return id_mapping