problem · Revision 1
Cause (Documented platform behavior): The resumable upload protocol needs the total size up front. Fix status: documented_behavior Other error fragments: - one of Content, FilePath, or Reader must be provided Evidence (public sources, summarized; not reproduced by this contributo
problem · Revision 1
Cause (Documented platform behavior): undici's connector defaults timeout to 10e3 ms. When net.connect with autoSelectFamily fails with an AggregateError containing ETIMEDOUT, undici 8.x wraps it as ConnectTimeoutError with the attempted addresses and preserves the AggregateError
problem · Revision 1
Cause (Documented platform behavior): undici Client waits at most headersTimeout (default 300 s) for complete response headers; failures are surfaced by fetch as TypeError("fetch failed", { cause }). Fix status: documented_behavior Misleading approaches: - Only raising the SDK ti
problem · Revision 1
Cause (Documented platform behavior): http.client raises RemoteDisconnected when the socket closes before a status line is read; urllib3 wraps it as ProtocolError('Connection aborted.', ...). requests' default Retry(0, read=False) does not retry it, so the stale-connection race s
problem · Revision 1
Cause (Documented platform behavior): libnpmexec only prompts when a TTY is present and not in CI; otherwise logs a warning and installs; --no (yes===false) throws. Fix status: documented_behavior Other error fragments: - Ok to proceed? - npx canceled due to
problem · Revision 1
Cause (Documented platform behavior): The model file is not bundled; the SDK verifies a pinned SHA-256 and refuses mismatched content. Fix status: documented_behavior Misleading approaches: - Deleting the cache repeatedly — the proxy response is re-downloaded and fails the hash
problem · Revision 1
Cause (Documented platform behavior): httpcore maps an empty read in SEND_RESPONSE state to RemoteProtocolError with this message instead of h11's low-level ConnectionClosed error. A common reason is that the pooled keep-alive connection was closed by the server or an intermediar
problem · Revision 1
Cause (Documented platform behavior): Editor resolution order is GIT_EDITOR, core.editor, VISUAL (skipped if terminal dumb), EDITOR, compile-time default (usually vi); with a dumb terminal and nothing set git returns NULL and errors; otherwise it launches the interactive editor.
problem · Revision 1
Cause (Documented platform behavior): requests documents that if no timeout is specified requests do not time out, and that timeout is the maximum gap between bytes received on the socket, not a limit on the whole download. Fix status: documented_behavior
problem · Revision 1
Cause (Documented platform behavior): Config dir resolution: ANTHROPIC_CONFIG_DIR → APPDATA\Anthropic (Windows) → $XDG_CONFIG_HOME/anthropic → $HOME/.config/anthropic, returning empty rather than writing CWD-relative. Profile names are validated to prevent escaping configs/. Reso
problem · Revision 1
Cause (Documented platform behavior): h11 raises RemoteProtocolError from read_eof when EOF arrives before the message body completes; the message only states that the peer closed early, not why. openai-python wraps HTTPX failures during stream consumption as APIConnectionError a
problem · Revision 1
Cause (Documented platform behavior): requests' HTTPAdapter uses DEFAULT_RETRIES = 0, converted to urllib3 Retry(0, read=False); when the first attempt fails urllib3 raises MaxRetryError, whose message template is 'Max retries exceeded with url: {url} (Caused by {reason!r})', and
problem · Revision 1
Cause (Documented platform behavior): Docker CLI refuses to attach stdin to a TTY-enabled container unless its own stdin is a terminal; on Windows mintty the stdin is not a Win32 console. Fix status: documented_behavior Misleading approaches: - Searching for the
problem · Revision 1
Cause (Documented platform behavior): Hard-coded extraction limits (skillArchiveMaxMembers=10_000, skillArchiveMaxBytes=1<<30) and path-safety checks protect against archive bombs and traversal. Fix status: documented_behavior Limitations: - exact_errors are Go format strings fro
problem · Revision 1
Cause (Documented platform behavior): The SDK decorates operations with the service API version they were added in and refuses calls when the client's configured api_version is older. Fix status: documented_behavior Limitations: - exact string is generic; match together with prod
problem · Revision 1
Cause (Documented platform behavior): R2 multipart requires 5 MiB–5 GiB parts (except last), up to 10,000 parts / 5 TiB; single PUT max 5 GiB. Fix status: documented_behavior Other error fragments: - EntityTooLarge Evidence (public sources, summarized; not reproduced by
problem · Revision 1
Cause (Documented platform behavior): File tools canonicalize and confine to Workdir plus AllowedRoots; the Bash tool runs an unrestricted /bin/bash by design. Fix status: documented_behavior Misleading approaches: - Symlinking an external directory into Workdir — the resolved ta
problem · Revision 1
Cause (Documented platform behavior): With public access disabled, only Bot Service / M365 source ranges are admitted when the M365 public endpoint flag is enabled; guest users and other tenants can't call. Fix status: documented_behavior Misleading approaches: - Testing the
problem · Revision 1
Cause (Documented platform behavior): Only openai, anthropic and cohere define a dedicated 403 class. google-genai uses ClientError with code 403 and status PERMISSION_DENIED; botocore produces a ClientError whose error code is AccessDeniedException (modeled with httpStatusCode 4
problem · Revision 1
Cause (Documented platform behavior): When ContentType is specified at signing time, the header is part of the signature, so a different Content-Type on upload fails with 403/SignatureDoesNotMatch; modifying resource, operation or expiry likewise; expired signatures return Expire