Skip to content

embedded-tools-shared

Generated from plugins/embedded-tools-shared/README.md.

Pure-Python engines shared by the embedded Claude-like and Codex-like tool plugins.

The package is model-invisible: it defines no plugin descriptor or tool schemas. It owns:

  • canonical workspace path resolution;
  • bounded UTF-8 reading, writing, and exact editing;
  • bounded path enumeration and regular-expression search;
  • workspace-restricted patch application;
  • public-only HTTP(S) fetching with redirect revalidation and verified TLS.

Model-facing packages provide their own names, schemas, result formatting, and tool-use conventions.

Workspace paths are relative to a configured root. Absolute paths, traversal, and symlink escapes are rejected. Public fetching rejects local, private, link-local, multicast, and reserved destinations and pins each connection to a validated DNS result.

Development

From the repository root:

python -m pip install -e "plugins/embedded-tools-shared[dev]"
pytest plugins/embedded-tools-shared/tests -q

License

Licensed under the Apache License, Version 2.0. See LICENSE.