Expand description
Workspace-scoped native coding tool adapters for the reference Coding CLI.
Native executors are rooted in an explicit WorkspaceRoot capability;
they never accept an unconstrained ambient current directory. Path values
from models are bounded, relative, normalized, symlink-contained, and
separated into existing-read and prospective-mutation resolutions.
Structs§
- Bash
Config - Bounded process execution configuration owned by the host.
- Bash
Output Directory - Validated protected directory for oversized command output.
- Bash
Shell - Explicit host-owned shell configuration; model arguments cannot replace it.
- Bash
Tool - Workspace-confined bounded shell executor.
- Decoded
Fetch Body - Normalized body ready for a provider-neutral
super::FetchResult. - Edit
Tool - Workspace-confined exact-match atomic UTF-8 editor.
- Fetch
Address Policy - Immutable IP-address policy applied to every DNS answer and peer address.
- Fetch
Body Decoder - Bounded decoder and extractor for raw HTTP response bytes.
- Fetch
Body Limits - Independent decoded-byte and HTML-parser limits.
- Fetch
Cache Config - Independently bounded TTL, entry-count, and byte limits for fetch caching.
- Fetch
Cache Scope - Cache isolation boundary supplied by the upper-layer workspace and profile.
- Fetch
Cache Stats - Non-sensitive fetch cache occupancy snapshot.
- Fetch
Http Config - Complete immutable policy for the pinned HTTP transport.
- Fetch
Http Headers - Redacted subset of response headers consumed by the body decoder.
- Fetch
Http Limits - Bounded redirect and raw-body limits for the HTTP transport.
- Fetch
Http Response - One complete raw HTTP fetch after bounded manual redirects.
- Fetch
Http Timeouts - Bounded timeout and low-speed policy for one complete fetch.
- Fetch
Http Transport - HTTP transport that validates DNS, pins connections, and handles redirects.
- Fetch
Provider Error - Secret-independent client fetch failure.
- Fetch
Redirect - One bounded redirect record.
- Fetch
Request - Bounded provider-neutral request passed to a client fetch backend.
- Fetch
Result - Bounded normalized result returned by a client fetch backend.
- Fetch
Result Cache - Shared bounded in-memory cache of normalized fetch results.
- Fetch
UrlPolicy - Immutable URL validation policy used before DNS resolution.
- File
Tool Error - Bounded path-independent file tool error.
- Find
Tool - Workspace-confined bounded path search.
- Grep
Tool - Workspace-confined bounded regular-expression search.
- Http
Fetch Provider - Production client fetch backend composed from transport, decoding, and cache layers.
- LsTool
- Workspace-confined bounded directory listing.
- Read
Tool - Workspace-confined bounded UTF-8 text reader.
- Resolved
Existing Path - Verified existing workspace target.
- Resolved
Mutation Path - Verified existing or prospective workspace mutation target.
- Search
Provider Error - Secret-independent client search failure.
- Search
Request - Bounded provider-neutral request passed to a client search backend.
- Search
Response - Bounded provider-neutral client search response.
- Search
Result - One normalized client search result.
- System
Fetch DnsResolver - Tokio system resolver used by the production fetch provider.
- Tavily
ApiKey - Redacted Tavily API credential.
- Tavily
Search Config - Validated Tavily HTTP endpoint and timeout policy.
- Tavily
Search Provider - Production Tavily implementation of
SearchProvider. - Validated
Fetch Addresses - Deterministic, deduplicated set of fully validated DNS answers.
- Validated
Fetch Url - Canonical URL safe to pass into DNS and per-hop transport validation.
- WebFetch
Tool - Client executor for the stable
web_fetchtool contract. - WebSearch
Tool - Client executor for the stable
web_searchtool contract. - Workspace
File Resource Resolver - Pure resolver mapping one validated
pathargument to a workspace file resource. - Workspace
Path Error - Bounded path-independent error safe for model, terminal, and JSON output.
- Workspace
Root - Validated authority to resolve tool paths beneath one canonical directory.
- Write
Tool - Workspace-confined atomic UTF-8 file writer.
Enums§
- Fetch
Address Policy Error - Address-policy failure detected before creating an HTTP connection.
- Fetch
Content Kind - Canonical response content kind retained by the fetch result.
- Fetch
Provider Error Code - Stable failure categories returned by client fetch backends.
- Fetch
Request Error - Invalid provider-neutral fetch request.
- Fetch
Retry Disposition - Whether an upper layer may explicitly retry a failed fetch operation.
- Fetch
Truncation Reason - Why a fetch body was truncated.
- Fetch
UrlPolicy Error - URL-policy failure detected before DNS or network I/O.
- Fetch
UrlScheme - Validated HTTP scheme.
- File
Tool Error Code - Stable machine-readable native file-tool failure classification.
- Search
Provider Error Code - Stable failure category returned by a client search backend.
- Search
Request Error - Invalid provider-neutral search request.
- Workspace
Path Error Code - Stable machine-readable classification for workspace capability failures.
Constants§
- DEFAULT_
FETCH_ CACHE_ ENTRIES - Default maximum number of normalized fetch cache entries.
- DEFAULT_
FETCH_ CACHE_ ENTRY_ BYTES - Default maximum logical bytes retained by one fetch cache entry.
- DEFAULT_
FETCH_ CACHE_ TOTAL_ BYTES - Default aggregate logical bytes retained by the fetch cache.
- DEFAULT_
FETCH_ CACHE_ TTL - Default lifetime of a normalized fetch cache entry.
- DEFAULT_
FETCH_ DECODED_ BYTES - Default maximum decoded response bytes accepted by the body pipeline.
- DEFAULT_
FETCH_ HTML_ BYTES - Default maximum HTML input bytes passed to the parser.
- DEFAULT_
FETCH_ HTML_ ELEMENTS - Default maximum opening-tag markers accepted before HTML parsing.
- DEFAULT_
FETCH_ MAX_ CHARS - Default number of body characters returned by the fetch tool.
- DEFAULT_
FETCH_ RESPONSE_ BYTES - Default maximum raw response bytes retained by the fetch transport.
- DEFAULT_
READ_ LINE_ LIMIT - Default maximum lines returned by one read invocation.
- DEFAULT_
SEARCH_ RESULT_ LIMIT - Default maximum number of entries returned by a search tool.
- DEFAULT_
TAVILY_ SEARCH_ ENDPOINT - Default production endpoint for the Tavily Search API.
- DEFAULT_
WEB_ SEARCH_ RESULT_ LIMIT - Default number of client search results requested from a backend.
- FETCH_
SECURITY_ POLICY_ VERSION - Version mixed into cache keys whenever fetch security semantics change.
- MAX_
FETCH_ CACHE_ ENTRIES - Absolute maximum number of normalized fetch cache entries.
- MAX_
FETCH_ CACHE_ ENTRY_ BYTES - Absolute logical byte limit for one fetch cache entry.
- MAX_
FETCH_ CACHE_ TOTAL_ BYTES - Absolute aggregate logical byte limit for the fetch cache.
- MAX_
FETCH_ CACHE_ TTL - Maximum configurable fetch cache entry lifetime.
- MAX_
FETCH_ DECODED_ BYTES - Absolute maximum decoded response bytes accepted by body configuration.
- MAX_
FETCH_ MAX_ CHARS - Maximum body characters retained by one fetch result.
- MAX_
FETCH_ MIME_ BYTES - Maximum MIME type bytes retained by one fetch result.
- MAX_
FETCH_ REDIRECTS - Maximum redirect records retained by one fetch result.
- MAX_
FETCH_ RESPONSE_ BYTES - Absolute maximum raw response bytes accepted by transport configuration.
- MAX_
FETCH_ TITLE_ BYTES - Maximum title bytes retained by one fetch result.
- MAX_
FETCH_ URL_ BYTES - Maximum UTF-8 bytes accepted in a fetch URL.
- MAX_
READ_ BYTES - Maximum source bytes accepted by the read tool.
- MAX_
READ_ LINE_ LIMIT - Maximum line limit accepted by one read invocation.
- MAX_
SEARCH_ DEPTH - Maximum recursive depth accepted by
ls. - MAX_
SEARCH_ RESULT_ LIMIT - Maximum result limit accepted by a search tool invocation.
- MAX_
WEB_ SEARCH_ QUERY_ BYTES - Maximum UTF-8 bytes accepted in one client search query.
- MAX_
WEB_ SEARCH_ RESPONSE_ BYTES - Maximum encoded response body accepted from a client search backend.
- MAX_
WEB_ SEARCH_ RESULT_ LIMIT - Maximum number of client search results retained in one invocation.
- MAX_
WORKSPACE_ ERROR_ MESSAGE_ BYTES - Maximum UTF-8 bytes exposed by a workspace-path diagnostic.
- MAX_
WORKSPACE_ PATH_ BYTES - Maximum UTF-8 bytes in a model-supplied workspace path.
- MAX_
WORKSPACE_ PATH_ COMPONENTS - Maximum components in a model-supplied workspace path.
- MAX_
WRITE_ BYTES - Maximum bytes accepted or produced by a write/edit tool.
Traits§
- Fetch
DnsResolver - DNS resolver port used so security tests can supply deterministic answers.
- Fetch
Provider - Object-safe client web-fetch backend port.
- Search
Provider - Object-safe client web-search backend port.
Functions§
- package_
version - Returns the package version embedded at compile time.
- read_
only_ workspace_ tools - Builds the workspace-confined
read,grep,find, andlstool preset.
Type Aliases§
- Fetch
Future - Object-safe future returned by
FetchProvider. - Fetch
Resolve Future - Object-safe DNS future returned by
FetchDnsResolver. - Native
Tool Registration - One native client-tool registration ready for a runtime or session builder.
- Search
Future - Object-safe future returned by
SearchProvider.