Skip to content

Dots Brain v0.3.0-alpha.2

Pre-release
Pre-release

Choose a tag to compare

@OnFiala OnFiala released this 04 Oct 18:24
· 84 commits to main since this release

Dots Brain can now authorize OAuth clients on the same VM and SQLite database
as the memory service. The owner agent approves an identified connection and its
project scope without reading or printing bearer tokens. Existing local bearer
connections continue working.

Implemented behavior

  • Optional OAuth discovery and dynamic client registration through official MCP SDK handlers.
  • S256 PKCE, exact callbacks, resource-bound token exchange, and single-use codes.
  • Local oauth pending, approve, and deny commands for the exact initiated flow.
  • Project-scoped grants; default approval excludes deletion and can narrow requested scopes.
  • One-hour access tokens, rotating refresh tokens, and a maximum 30-day grant lifetime.
  • Client and owner revocation, persistent grants across restart, and removal of all
    OAuth flows and grants during whole-instance uninstall.
  • Bounded registration storage and request bodies, validated callback schemes,
    malformed-JSON handling, and case-insensitive HTTP Bearer scheme parsing.

No runtime dependency or paid service was added. The minimum MCP SDK version is
now the tested 1.30, within the existing major-version constraint.

Validation

66 tests passed on Python 3.11 and 3.12, with the unchanged opt-in real-model test
skipped. The 19 OAuth cases include official OAuthClientProvider discovery,
registration, browser callback simulation, CLI approval, PKCE, a memory write,
and automatic token refresh against a live local HTTP server. They also cover
concurrent code reuse, expiry, scope/project boundaries, capacity recovery,
revocation, and removal/reinstall behavior.

Lint, formatting, documentation validation, and wheel/source builds passed.
The release workflow repeats the supported-version checks for the exact tag.
All test memories and credentials are synthetic; no user account was connected.

Installation and documentation

Use the source checkout or installer ZIP with Python 3.11+ and uv, following the
setup skill. The ZIP is an installer skill package; publishing it does not
register a public ChatGPT plugin or create a shared MCP endpoint.

OAuth is enabled explicitly on an existing instance. It adds optional tables;
upgrading alone does not enable it or expose the service. Disable OAuth with an
OAuth-aware release before downgrading, so older removal code cannot leave grants behind.

Remaining alpha limits

A real public HTTPS ingress is still required. This release does not provision a
tunnel, configure a provider's web account, establish access to another device,
or verify deployment on Botter's VM. The inspected development VM has no configured
TCP destinations or VPN. A configured issuer is not evidence of public reachability.

Owner approval requires identifying the exact initiated request, not trusting a
client-supplied name. OS-owner access can still read private files, including
confidential-client registration secrets: this is not strong secret isolation.
Actual ChatGPT/Claude web clients, direct cross-origin browser MCP, conversation
capture, history import, native views, and VM persistence remain unverified or unimplemented.

MIT licensed. Memory, authentication, and local inference stay on the user's host.

This release also rejects unsupported IPv6 HTTP issuers and empty userinfo before configuration. It supersedes the alpha.1 candidate before publication; the earlier Git tag remains immutable.