Skip to main content

Crate tea_coding_tools

Crate tea_coding_tools 

Source
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§

BashConfig
Bounded process execution configuration owned by the host.
BashOutputDirectory
Validated protected directory for oversized command output.
BashShell
Explicit host-owned shell configuration; model arguments cannot replace it.
BashTool
Workspace-confined bounded shell executor.
DecodedFetchBody
Normalized body ready for a provider-neutral super::FetchResult.
EditTool
Workspace-confined exact-match atomic UTF-8 editor.
FetchAddressPolicy
Immutable IP-address policy applied to every DNS answer and peer address.
FetchBodyDecoder
Bounded decoder and extractor for raw HTTP response bytes.
FetchBodyLimits
Independent decoded-byte and HTML-parser limits.
FetchCacheConfig
Independently bounded TTL, entry-count, and byte limits for fetch caching.
FetchCacheScope
Cache isolation boundary supplied by the upper-layer workspace and profile.
FetchCacheStats
Non-sensitive fetch cache occupancy snapshot.
FetchHttpConfig
Complete immutable policy for the pinned HTTP transport.
FetchHttpHeaders
Redacted subset of response headers consumed by the body decoder.
FetchHttpLimits
Bounded redirect and raw-body limits for the HTTP transport.
FetchHttpResponse
One complete raw HTTP fetch after bounded manual redirects.
FetchHttpTimeouts
Bounded timeout and low-speed policy for one complete fetch.
FetchHttpTransport
HTTP transport that validates DNS, pins connections, and handles redirects.
FetchProviderError
Secret-independent client fetch failure.
FetchRedirect
One bounded redirect record.
FetchRequest
Bounded provider-neutral request passed to a client fetch backend.
FetchResult
Bounded normalized result returned by a client fetch backend.
FetchResultCache
Shared bounded in-memory cache of normalized fetch results.
FetchUrlPolicy
Immutable URL validation policy used before DNS resolution.
FileToolError
Bounded path-independent file tool error.
FindTool
Workspace-confined bounded path search.
GrepTool
Workspace-confined bounded regular-expression search.
HttpFetchProvider
Production client fetch backend composed from transport, decoding, and cache layers.
LsTool
Workspace-confined bounded directory listing.
ReadTool
Workspace-confined bounded UTF-8 text reader.
ResolvedExistingPath
Verified existing workspace target.
ResolvedMutationPath
Verified existing or prospective workspace mutation target.
SearchProviderError
Secret-independent client search failure.
SearchRequest
Bounded provider-neutral request passed to a client search backend.
SearchResponse
Bounded provider-neutral client search response.
SearchResult
One normalized client search result.
SystemFetchDnsResolver
Tokio system resolver used by the production fetch provider.
TavilyApiKey
Redacted Tavily API credential.
TavilySearchConfig
Validated Tavily HTTP endpoint and timeout policy.
TavilySearchProvider
Production Tavily implementation of SearchProvider.
ValidatedFetchAddresses
Deterministic, deduplicated set of fully validated DNS answers.
ValidatedFetchUrl
Canonical URL safe to pass into DNS and per-hop transport validation.
WebFetchTool
Client executor for the stable web_fetch tool contract.
WebSearchTool
Client executor for the stable web_search tool contract.
WorkspaceFileResourceResolver
Pure resolver mapping one validated path argument to a workspace file resource.
WorkspacePathError
Bounded path-independent error safe for model, terminal, and JSON output.
WorkspaceRoot
Validated authority to resolve tool paths beneath one canonical directory.
WriteTool
Workspace-confined atomic UTF-8 file writer.

Enums§

FetchAddressPolicyError
Address-policy failure detected before creating an HTTP connection.
FetchContentKind
Canonical response content kind retained by the fetch result.
FetchProviderErrorCode
Stable failure categories returned by client fetch backends.
FetchRequestError
Invalid provider-neutral fetch request.
FetchRetryDisposition
Whether an upper layer may explicitly retry a failed fetch operation.
FetchTruncationReason
Why a fetch body was truncated.
FetchUrlPolicyError
URL-policy failure detected before DNS or network I/O.
FetchUrlScheme
Validated HTTP scheme.
FileToolErrorCode
Stable machine-readable native file-tool failure classification.
SearchProviderErrorCode
Stable failure category returned by a client search backend.
SearchRequestError
Invalid provider-neutral search request.
WorkspacePathErrorCode
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§

FetchDnsResolver
DNS resolver port used so security tests can supply deterministic answers.
FetchProvider
Object-safe client web-fetch backend port.
SearchProvider
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, and ls tool preset.

Type Aliases§

FetchFuture
Object-safe future returned by FetchProvider.
FetchResolveFuture
Object-safe DNS future returned by FetchDnsResolver.
NativeToolRegistration
One native client-tool registration ready for a runtime or session builder.
SearchFuture
Object-safe future returned by SearchProvider.