Cause (Documented platform behavior): With a token, the relay waits extensionConnectionTimeout; without a token it waits indefinitely for user approval. Fix status: documented_behavior Other error fragments: - PLAYWRIGHT_MCP_EXTENSION_TOKEN matches its token. Evidence (public sou
Cause (Documented platform behavior): execpolicy chooses the most specific matching prefix rule; forbidden -> rejection, prompt -> approval request; justification text is surfaced verbatim. Fix status: documented_behavior Other error fragments: - rejected: blocked by policy - req
Cause (Documented platform behavior): Reserved names are re-checked on every load/refresh. Fix status: documented_behavior Other error fragments: - is reserved for official Anthropic marketplaces. Only repositories from 'github.com/anthropics/' can use this name. - can only be us
Cause (Documented platform behavior): Default policy blocks file: protocol navigation and restricts file access to workspace roots/output dir; --allow-unrestricted-file-access lifts both. Fix status: documented_behavior Limitations: - README notes these restrictions are not a sec
Cause (Maintainer-confirmed cause): Release notes name three triggers (sessions created before 1.0.6; sessions containing extension permission prompts; events with non-URL strings in URL/URI fields) that the resume path wrongly treated as corruption; the loading mechanism itself
Cause (Documented platform behavior): The rule validator rejects empty rules, rules over 512 chars, all-wildcard rules, colon rules with no executable, and executable-wildcard rules whose argument pattern is empty or all-wildcard. Note in the matcher a rule that fails validation
Cause (Documented platform behavior): Validator rejects base_image containing ghcr.io/openhands/agent-server and requires exactly one of the two fields. Fix status: documented_behavior Other error fragments: - Exactly one of 'base_image' or 'server_image' must be set. Evidence (p
Cause (Documented platform behavior): Before forking tsserver the extension checks fs.existsSync(tsServerPath); if missing it warns, resets the version manager and uses the bundled version. Fix status: documented_behavior Limitations: - Strings read from VS Code main-branch sourc
Cause (Documented platform behavior): Refs are only valid against the current snapshot; resolution failure throws this message. Fix status: documented_behavior Misleading approaches: - Retrying the same ref without a new snapshot Evidence (public sources, summarized; not reproduc
Cause (Documented platform behavior): Transcripts are local and retention-swept; before v2.1.223 lookup was limited to the current project and worktrees; before v2.1.216 failed picker resume hung on spinner. Fix status: documented_behavior Limitations: - -p and Agent SDK sessions
Cause (Documented platform behavior): ModelProviderInfo::api_key treats a missing or blank env var as CodexErr::EnvVar. Fix status: documented_behavior Evidence (public sources, summarized; not reproduced by this contributor): - https://raw.githubusercontent.com/openai/codex/main
Cause (Documented platform behavior): The npm package is only a loader: it resolves @github/copilot-<platform>-<arch> (on Linux it tries linuxmusl first when detect-libc reports a non-glibc libc, then linux) and spawns that native binary. If no platform package resolves, every sp
Cause (Documented platform behavior): SDK maps HTTP 502 to formatSandboxTimeoutError / format_sandbox_timeout_exception regardless of body; the 'port is not open' body indicates no listener. Fix status: documented_behavior Misleading approaches: - Raising the sandbox timeout when
Cause (Documented platform behavior): When any denylist rule exists, commands that cannot be parsed into executable commands are blocked fail-closed. Rule matching normalizes the command and supports wildcards and colon rules (executable:args pattern). Shell command analysis reli
Cause (Documented platform behavior): The field was removed; a before-validator rejects it with migration guidance. Fix status: docs_changed Evidence (public sources, summarized; not reproduced by this contributor): - https://raw.githubusercontent.com/OpenHands/software-agent-sdk
Cause (Documented platform behavior): Design choice to avoid blocking initialization with a browser flow; user must trigger auth explicitly. Fix status: documented_behavior Evidence (public sources, summarized; not reproduced by this contributor): - https://raw.githubusercontent.
Cause (Documented platform behavior): Client restarts tsserver up to 5 times; >5 restarts within 10 seconds sets 'fatally crashed' and stops restarting; within 5 minutes shows a warning. Memory is capped by --max-old-space-size from js/ts.tsserver.maxMemory (default 3072, min 128
Cause (Documented platform behavior): /security-review diffs against origin/HEAD; git creates it only on full clone when remote advertises a default branch. Fix status: documented_behavior Limitations: - --auto fails with 'Cannot determine remote HEAD' on empty remotes Other erro
Cause (Documented platform behavior): When a 429 body doesn't match a known limit type, api_bridge falls through to RetryLimitReachedError. Fix status: documented_behavior Unknowns: - Exact retry count defaults not verified in this round Evidence (public sources, summarized; not
Cause (Documented platform behavior): The identifier parser enforces a single @ and a restricted character set; extension plugin registration canonicalizes the path and rejects root/home or very shallow paths and already-registered paths. Fix status: documented_behavior Limitatio