# Engineering changelog

> Selected desktop, server, and mobile changes from the repository, grouped by the behavior they affect.

Handbook / Contribute · Checked against the source on 2026-10-05 · https://www.hbcode.ai/docs/changelog

## How to read these entries

> **Commit dates, not release dates** These entries describe engineering work committed to the repository through 30 September 2026. A change reaches the installers and the app stores later, so check your installed version when you report behavior. Work in progress is left out.

## 30 September 2026 · HB Code and one chat layer for both agents

- Renamed the product to HB Code: names, icons, and website links on the desktop and in the mobile apps.
- Separated the shared chat state from the agent adapters. The desktop code is now in chat, agents/codex, agents/claude, and agents/dispatch.
- Renamed the chat RPC methods from run.codexChat… to run.chat… for both agents. The relay now requires protocol 1.7 from every app.
- Added Claude subagents, Claude account controls, and usage history.
- Fixed races between usage-history requests.

Source: commit 8f6d69f74.

- [Where the desktop code lives](https://www.hbcode.ai/docs/contributing.md#layout): The chat layer, dispatch, the two adapters, and the allowed imports.

## 28 September 2026 · Claude sessions

- Added Claude Code as a second agent. You pick Codex or Claude when you create a session, on the desktop or on a phone.
- Ran Claude through a desktop-owned agent host with the Claude Agent SDK, including the Claude sign-in, saved conversation import, and model and access controls.
- Extended the iOS and Android session contracts to Claude sessions.
- Kept history pages bounded while complete assistant replies stay together.

Source: commit 16fb6698a.

- [The Claude Agent SDK integration](https://www.hbcode.ai/docs/claude-agent-sdk.md): The agent host, history projection, approvals, subagents, and accounts.

## 26 September 2026 · Workspace delivery and previews

- Kept an Android message that the desktop rejects, with the reason, instead of sending it again or dropping it.
- Hardened browser uploads and the isolation between server services.
- Improved timeline and command output handling.

Source: commit 3339faf0a.

- [Timeline](https://www.hbcode.ai/docs/timeline.md): History pages, the revisioned live overlay, settlement epochs, and the pagination splice contract.

## 16 September 2026 · Workspace previews and session reliability

- Added scoped preview caching and native document handling on the desktop and the phones.
- Added session access settings and timeline reliability fixes across desktop and mobile.
- Extended the shared RPC contract and its regression tests.

Source: commit 94510a616.

- [Command output, documents, and previews](https://www.hbcode.ai/docs/output-and-previews.md): Artifacts, the HTML sandbox, and file transfers.

## 15 September 2026 · Document previews and mobile reliability

- Opened local HTML files as rendered documents: the desktop with a Source view and Reload, iPhone with Reload and Done, Android as file-backed previews.
- Moved large file reads to sequential 4 MiB chunks and made desktop and mobile navigation between previews more predictable.
- Improved outbox delivery, session loading, and Git error recovery. Published this handbook on the website.
- Rebuilt the native media tools from source for both desktop platforms and updated dependency locks.

Source: commits 8deb6d413 and acaf6575f.

- [Command output, documents, and previews](https://www.hbcode.ai/docs/output-and-previews.md#html-documents): The HTML sandbox, chunked file transfers, and web pages as Markdown.

## 11 September 2026 · Desktop dictation

- Added personal OpenAI API key settings alongside Gemini for desktop dictation.
- Separated transcription quota errors from rate limits and added recording-size validation before an OpenAI upload.
- Added credential-settings and transcription recovery checks.

Source: commit 7a5749266.

- [Dictation and vocabulary](https://www.hbcode.ai/docs/tools/dictation.md#dictation): Providers, models, hint vocabularies, and the error classes.

## 10 September 2026 · iOS recording and history

- Improved recording controls and dictation feedback in the iOS workspace.
- Adjusted the initial timeline presentation and limited older-history paging to one request per user gesture.
- Added focused tests for dictation presentation and the first older-page load.

Source: commit 8aa267c67. A separate dependency update, e10d28915, patched the smol-toml denial-of-service issue.

- [iOS: chat hosts, the collection view, and the outbox](https://www.hbcode.ai/docs/ios/chat.md): Snapshots, older pages, scrolling, and the outbox on the iPhone.

## 9 September 2026 · Account and workspace recovery

- Preserved rotated refresh tokens when later validation fails, while keeping logout and account deletion serialized.
- Updated relay expiry, rate limits, and database runtime checks, and added a PostgreSQL backup playbook and Redis setup changes.
- Included iOS session, timeline, composer, and highlighting fixes, plus desktop Git and runtime integration updates.

Source: commit b437b7a6d. The commit records server and database validation and makes no claim about a production deployment or an iOS runtime test.

- [Accounts, auth, and regions](https://www.hbcode.ai/docs/accounts-and-auth.md): The PKCE handoff, token refresh, and what a region change invalidates.

## 5 September 2026 · Chat delivery and timeline stability

- Preserved retry identity and improved recovery of cancelled outbox operations.
- Kept first-message timeline updates visible and removed stale compaction progress.
- Improved sidebar search, command-output controls, and model-setting continuity through queued delivery.
- Added account-scoped desktop discovery and switcher recovery fixes.

Sources: commits c3485b2af and 9cd174076.

- [Message delivery](https://www.hbcode.ai/docs/message-delivery.md): Outbox custody, turn admission, and recovery of a lost reply.
