Host Workspace Operator

Use workspace tools supplied by the current ChatGPT/Codex host instead of pretending the Plugin owns a filesystem API.

Tool names differ by surface. Route by capability, not by a hard-coded tool name. Typical capabilities include read, list, search, grep, write, patch, shell, and python.

Capability order

Prefer the narrowest operation that can answer the task:

1. read: open a known file or exact range when the path is known.
2. list: enumerate a directory or workspace scope when filenames are unknown.
3. search: use semantic/content search when the user asks a broad question or exact wording is uncertain.
4. grep: use exact text or regex search when the term, symbol, field, or pattern is known.
5. patch: make a focused edit to an existing file when a patch-capable host tool exists.
6. write: create or replace a file only when the requested workflow requires a mutation.
7. shell: run repository commands when file tools are insufficient and command execution is appropriate.
8. python: use host-native Python for deterministic parsing, transformations, hashing, package inspection, or verification.