Compare commits

..
Author SHA1 Message Date
Bailey Dixon 4605b87c10 Merge pull request #333 from Codename-11/dev
release(server): server-v1.6.3
2026-08-11 22:00:43 -04:00
Bailey Dixon 6a91d6ee7e fix(android): complete upstream feature translations 2026-08-11 21:46:45 -04:00
Bailey Dixon 95a2813efe fix(server): validate translated media path components 2026-08-11 21:37:54 -04:00
Bailey Dixon 2ecf521c8c chore: merge main release history into dev 2026-08-11 21:35:40 -04:00
Bailey Dixon 7752c5c404 release(server): server-v1.6.3 2026-08-11 21:35:05 -04:00
Bailey Dixon e1d3764cd2 feat(android): browse sessions across profiles 2026-08-11 20:50:36 -04:00
Bailey Dixon e34171b5ad feat(android): add gateway message reactions 2026-08-11 20:48:09 -04:00
Bailey Dixon 8040cac39a feat(android): redirect running subagents 2026-08-11 20:45:33 -04:00
Bailey Dixon aab70520ca feat(android): open referenced Hermes sessions 2026-08-11 20:40:27 -04:00
Bailey Dixon 5a0cd8123c feat(android): expand Hermes management surfaces 2026-08-11 20:37:03 -04:00
Bailey Dixon 4370d9a925 feat(android): adopt richer gateway chat contracts 2026-08-11 20:30:38 -04:00
Bailey Dixon 726308d2ef fix: harden gateway recovery diagnostics 2026-08-11 20:26:05 -04:00
Bailey Dixon 1acc3a4c80 fix: align app and relay upstream contracts 2026-08-11 20:04:43 -04:00
Bailey Dixon 11ccbd6e5c Merge pull request #332 from Codename-11/dev
release(desktop): desktop-v0.4.0-alpha.7
2026-08-11 19:55:05 -04:00
Bailey Dixon d13af35357 chore: merge main release history into dev 2026-08-11 19:48:26 -04:00
Bailey Dixon e3752d43f3 release(desktop): desktop-v0.4.0-alpha.7 2026-08-11 19:48:24 -04:00
Bailey Dixon 97293b62c3 Merge pull request #331 from Codename-11/dev
release(desktop): desktop-v0.4.0-alpha.6
2026-08-11 19:33:13 -04:00
Bailey Dixon 454e770648 chore: merge main release history into dev 2026-08-11 19:26:15 -04:00
Bailey Dixon e18572e8e3 release(desktop): desktop-v0.4.0-alpha.6 2026-08-11 19:24:27 -04:00
Bailey Dixon 83f69725b9 Merge pull request #330 from Codename-11/dev
release: Desktop 0.4.0-alpha.5
2026-08-11 19:05:39 -04:00
Bailey Dixon 72aa7c3046 chore: merge main release history into dev 2026-08-11 18:59:06 -04:00
Bailey Dixon 3995c64493 release(desktop): desktop-v0.4.0-alpha.5 2026-08-11 18:59:04 -04:00
Bailey Dixon ce538ced3d Merge pull request #329 from Codename-11/dev
release: Desktop 0.4.0-alpha.4
2026-08-11 18:43:32 -04:00
Bailey Dixon 352bc5b439 chore: merge main release history into dev 2026-08-11 18:35:52 -04:00
Bailey Dixon 9ec163b27b release(desktop): desktop-v0.4.0-alpha.4 2026-08-11 18:35:32 -04:00
Bailey Dixon 7a3efa2c4d Merge pull request #328 from Codename-11/dev
release: Desktop 0.4.0-alpha.3 and Server 1.6.2
2026-08-11 18:19:36 -04:00
Bailey Dixon c28be7c92e style(desktop): format tray contract test 2026-08-11 18:03:02 -04:00
Bailey Dixon 8d1758ec8b fix(desktop): build tray assets before Rust checks 2026-08-11 18:01:17 -04:00
Bailey Dixon ce8b8702c3 test(desktop): make UI install coverage portable 2026-08-11 17:53:56 -04:00
Bailey Dixon ca0a9eb524 release(desktop): desktop-v0.4.0-alpha.3 2026-08-11 17:51:25 -04:00
Bailey Dixon b91d8c9a09 release(server): server-v1.6.2 2026-08-11 17:51:13 -04:00
Bailey Dixon bebd327816 Merge pull request #327 from Codename-11/feature/desktop-relay-management-release
feat: ship desktop management UI and paired-device identity
2026-08-11 17:49:18 -04:00
Bailey Dixon 8fa97e0b46 feat(desktop): add host management tray UI 2026-08-11 17:48:47 -04:00
Bailey Dixon 45dc82e573 feat(server): enrich paired device identity 2026-08-11 17:48:09 -04:00
dependabot[bot] 48b23f4d9e chore(deps): bump gradle-wrapper from 9.6.1 to 9.7.0 (#326)
Bumps [gradle-wrapper](https://github.com/gradle/gradle) from 9.6.1 to 9.7.0.
- [Release notes](https://github.com/gradle/gradle/releases)
- [Commits](https://github.com/gradle/gradle/compare/v9.6.1...v9.7.0)

---
updated-dependencies:
- dependency-name: gradle-wrapper
  dependency-version: 9.7.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-08-10 11:56:21 +00:00
dependabot[bot] f708ef3353 chore(deps): bump androidx.media3:media3-exoplayer from 1.10.1 to 1.11.0 (#325)
Bumps [androidx.media3:media3-exoplayer](https://github.com/androidx/media) from 1.10.1 to 1.11.0.
- [Release notes](https://github.com/androidx/media/releases)
- [Changelog](https://github.com/androidx/media/blob/release/RELEASENOTES.md)
- [Commits](https://github.com/androidx/media/compare/1.10.1...1.11.0)

---
updated-dependencies:
- dependency-name: androidx.media3:media3-exoplayer
  dependency-version: 1.11.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-08-10 11:55:39 +00:00
dependabot[bot] 3224595a46 chore(deps): bump gradle/actions from 6.2.0 to 6.3.0 (#324)
Bumps [gradle/actions](https://github.com/gradle/actions) from 6.2.0 to 6.3.0.
- [Release notes](https://github.com/gradle/actions/releases)
- [Commits](https://github.com/gradle/actions/compare/v6.2.0...v6.3.0)

---
updated-dependencies:
- dependency-name: gradle/actions
  dependency-version: 6.3.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-08-10 11:55:08 +00:00
dependabot[bot] c0453f040d chore(deps): bump the testing group with 2 updates (#323)
Bumps the testing group with 2 updates: [io.github.takahirom.roborazzi:roborazzi](https://github.com/takahirom/roborazzi) and [io.github.takahirom.roborazzi:roborazzi-compose](https://github.com/takahirom/roborazzi).


Updates `io.github.takahirom.roborazzi:roborazzi` from 1.70.0 to 1.71.0
- [Release notes](https://github.com/takahirom/roborazzi/releases)
- [Commits](https://github.com/takahirom/roborazzi/compare/1.70.0...1.71.0)

Updates `io.github.takahirom.roborazzi:roborazzi-compose` from 1.70.0 to 1.71.0
- [Release notes](https://github.com/takahirom/roborazzi/releases)
- [Commits](https://github.com/takahirom/roborazzi/compare/1.70.0...1.71.0)

---
updated-dependencies:
- dependency-name: io.github.takahirom.roborazzi:roborazzi
  dependency-version: 1.71.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: testing
- dependency-name: io.github.takahirom.roborazzi:roborazzi-compose
  dependency-version: 1.71.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: testing
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-08-10 11:54:54 +00:00
Bailey Dixon 33a0ea3216 chore: merge main back after android-v1.8.1 2026-08-10 00:05:29 -04:00
Bailey Dixon cec05ceec2 Merge pull request #322 from Codename-11/dev
release(android): android-v1.8.1
2026-08-09 23:46:51 -04:00
Bailey Dixon 0e30699fff release(android): android-v1.8.1 2026-08-09 23:20:15 -04:00
Bailey Dixon d4041e4528 chore: merge main back after android-v1.8.0 2026-08-09 23:15:39 -04:00
Bailey Dixon c5ae402cd7 fix(android): align gateway and transcript contracts 2026-08-09 23:08:26 -04:00
Bailey Dixon 56eb213bbf Merge pull request #321 from Codename-11/dev
release(android): android-v1.8.0
2026-08-09 22:53:38 -04:00
Bailey Dixon 3165ebb8ce release(android): android-v1.8.0 2026-08-09 22:03:44 -04:00
Bailey Dixon a2457a39d4 Revert "Merge branch 'feature/hermes-management-profile-detail' into dev"
This reverts commit b481f1f337, reversing
changes made to 7b61ed4758.
2026-08-09 21:35:33 -04:00
Bailey Dixon c2799082b0 Revert "Merge branch 'feature/hermes-management-detail-surfaces' into dev"
This reverts commit 2a467bc03f, reversing
changes made to 44293030c9.
2026-08-09 21:35:33 -04:00
Bailey Dixon 2a467bc03f Merge branch 'feature/hermes-management-detail-surfaces' into dev 2026-08-09 21:13:35 -04:00
Bailey Dixon a30d3dc6ed feat(android): refine Hermes management surfaces 2026-08-09 21:13:29 -04:00
Bailey Dixon 44293030c9 fix(android): contain appearance header in viewport 2026-08-09 20:50:53 -04:00
Bailey Dixon 42ac8c5589 feat(marketing): refresh product screenshots 2026-08-09 20:08:42 -04:00
Bailey Dixon b481f1f337 Merge branch 'feature/hermes-management-profile-detail' into dev 2026-08-09 19:59:56 -04:00
Bailey Dixon 62c4017eeb feat(android): refine Hermes profile management detail 2026-08-09 19:59:40 -04:00
Bailey Dixon 7b61ed4758 Merge branch 'fix/hermes-management-detail-ui' into dev 2026-08-09 19:22:30 -04:00
Bailey Dixon 21259230b2 fix(android): restore Hermes management hub 2026-08-09 19:22:20 -04:00
Bailey Dixon 7ef1e93544 fix(android): reconcile profile shelf chat status 2026-08-09 19:13:34 -04:00
Bailey Dixon 61a50dc968 Merge branch 'feature/hermes-management-ui' into dev 2026-08-09 19:13:16 -04:00
Bailey Dixon 18b9ed005b chore(marketing): refresh production UI screenshots 2026-08-09 19:13:04 -04:00
Bailey Dixon c597187fa3 Merge branch 'feature/android-profile-shelf' into dev
# Conflicts:
#	CHANGELOG.md
#	DEVLOG.md
#	app/src/main/kotlin/com/hermesandroid/relay/ui/components/ConnectionInfoSheet.kt
#	app/src/main/kotlin/com/hermesandroid/relay/ui/components/MessageBubble.kt
#	app/src/main/kotlin/com/hermesandroid/relay/ui/screens/ChatScreen.kt
#	app/src/main/res/values-b+pt+BR/strings.xml
#	app/src/main/res/values-b+zh+Hans/strings.xml
#	app/src/main/res/values-de/strings.xml
#	app/src/main/res/values-es/strings.xml
#	app/src/main/res/values-ja/strings.xml
#	app/src/main/res/values-ru/strings.xml
2026-08-09 19:11:50 -04:00
Bailey Dixon c97f3a3359 feat(android): streamline Hermes management UI 2026-08-09 19:10:45 -04:00
Bailey Dixon 2d9ccd4712 Revert "Merge branch 'feature/agent-profile-defaults' into dev"
This reverts commit 93643be844, reversing
changes made to 1132fdf576.
2026-08-09 18:37:16 -04:00
Bailey Dixon 93643be844 Merge branch 'feature/agent-profile-defaults' into dev 2026-08-09 18:18:00 -04:00
Bailey Dixon b82ee95b8f feat(android): add profile defaults editor 2026-08-09 18:17:53 -04:00
Bailey Dixon 1132fdf576 fix(android): stabilize passport scrolling and model layout 2026-08-09 18:17:31 -04:00
Bailey Dixon 04c69cd15f fix(android): preserve gateway model during api catalog loads 2026-08-09 18:05:16 -04:00
Bailey Dixon b4edcad1e7 fix(android): keep passport catalog refresh read only 2026-08-09 17:54:08 -04:00
Bailey Dixon bef9579917 fix(android): keep passport controls session scoped 2026-08-09 17:11:24 -04:00
Bailey Dixon c84e037b77 fix(android): stop message narration safely 2026-08-09 16:38:27 -04:00
Bailey Dixon 3ad33691cb fix(android): recover persisted tool activity and chat speech 2026-08-09 16:21:40 -04:00
Bailey Dixon bb0a810798 fix(android): protect chat identity from pets 2026-08-09 16:09:09 -04:00
Bailey Dixon b675c1498c Merge branch 'feature/android-clean-activity' into dev 2026-08-09 15:46:02 -04:00
Bailey Dixon 6da1ad1a99 Merge branch 'fix/android-avatar-pet-regressions' into dev 2026-08-09 15:46:01 -04:00
Bailey Dixon 380b9e918d feat(android): clean up transcript activity 2026-08-09 15:44:05 -04:00
Bailey Dixon d531b4d377 fix(android): restore chat and pet interactions 2026-08-09 15:36:57 -04:00
Bailey Dixon 8cba61d2d8 Merge branch 'fix/android-chat-input-polish' into dev 2026-08-09 13:30:59 -04:00
Bailey Dixon 4106fd4b78 fix(android): polish chat message presentation 2026-08-09 13:30:53 -04:00
Bailey Dixon 47426db290 Merge branch 'feature/appearance-customization' into dev 2026-08-09 13:21:01 -04:00
Bailey Dixon b7945b072f feat(android): enhance appearance and visual assets 2026-08-09 13:20:53 -04:00
Bailey Dixon 3aead772a0 Merge branch 'fix/android-chat-input-polish' into dev 2026-08-09 12:41:22 -04:00
Bailey Dixon ccf94e1d9d feat(android): refine chat experience 2026-08-09 12:41:17 -04:00
Bailey Dixon 6b6edc1322 Merge branch 'fix/android-pet-ui-awareness' into dev 2026-08-09 12:31:28 -04:00
Bailey Dixon 2644b94fa9 fix(android): keep floating pets clear of UI 2026-08-09 12:31:14 -04:00
Bailey Dixon 440e3d5bb9 fix(android): unbox thinking status 2026-08-08 22:40:07 -04:00
Bailey Dixon 97158bc861 fix(android): stabilize server-default shelf avatar 2026-08-08 22:35:32 -04:00
Bailey Dixon d5a313ab5d feat(android): refine profile and chat handoffs 2026-08-08 20:27:01 -04:00
Bailey Dixon 3033e331b0 chore: backmerge Android 1.7.1 and Server 1.6.1 releases 2026-08-08 20:06:51 -04:00
Bailey Dixon 07bbb16671 feat(android): add profile shelf 2026-08-08 19:25:20 -04:00
302 changed files with 22672 additions and 2692 deletions
+4 -4
View File
@@ -63,7 +63,7 @@ jobs:
java-version: 17
- name: Setup Gradle
uses: gradle/actions/setup-gradle@v6.2.0
uses: gradle/actions/setup-gradle@v6.3.0
with:
cache-read-only: ${{ github.ref != 'refs/heads/main' && github.ref != 'refs/heads/dev' }}
@@ -95,7 +95,7 @@ jobs:
java-version: 17
- name: Setup Gradle
uses: gradle/actions/setup-gradle@v6.2.0
uses: gradle/actions/setup-gradle@v6.3.0
with:
cache-read-only: ${{ github.ref != 'refs/heads/main' && github.ref != 'refs/heads/dev' }}
@@ -139,7 +139,7 @@ jobs:
java-version: 17
- name: Setup Gradle
uses: gradle/actions/setup-gradle@v6.2.0
uses: gradle/actions/setup-gradle@v6.3.0
with:
cache-read-only: ${{ github.ref != 'refs/heads/main' && github.ref != 'refs/heads/dev' }}
@@ -203,7 +203,7 @@ jobs:
java-version: 17
- name: Setup Gradle
uses: gradle/actions/setup-gradle@v6.2.0
uses: gradle/actions/setup-gradle@v6.3.0
with:
cache-read-only: ${{ github.ref != 'refs/heads/main' && github.ref != 'refs/heads/dev' }}
+4 -2
View File
@@ -100,13 +100,15 @@ jobs:
with:
node-version: '22'
cache: npm
cache-dependency-path: desktop/package-lock.json
cache-dependency-path: |
desktop/package-lock.json
desktop/tray/package-lock.json
- name: Setup Rust
uses: dtolnay/rust-toolchain@stable
- name: Install deps
run: npm ci
run: npm ci && npm --prefix tray ci
- name: Check tray formatting
run: npm run tray:fmt
+1 -1
View File
@@ -76,7 +76,7 @@ jobs:
java-version: 17
- name: Setup Gradle
uses: gradle/actions/setup-gradle@v6.2.0
uses: gradle/actions/setup-gradle@v6.3.0
with:
cache-read-only: false
+1 -1
View File
@@ -74,7 +74,7 @@ jobs:
java-version: 17
- name: Setup Gradle
uses: gradle/actions/setup-gradle@v6.2.0
uses: gradle/actions/setup-gradle@v6.3.0
with:
cache-read-only: false
+2 -2
View File
@@ -125,7 +125,7 @@ jobs:
java-version: 17
- name: Setup Gradle
uses: gradle/actions/setup-gradle@v6.2.0
uses: gradle/actions/setup-gradle@v6.3.0
with:
cache-read-only: false
@@ -163,7 +163,7 @@ jobs:
java-version: 17
- name: Setup Gradle
uses: gradle/actions/setup-gradle@v6.2.0
uses: gradle/actions/setup-gradle@v6.3.0
with:
cache-read-only: false
+149 -6
View File
@@ -168,7 +168,9 @@ jobs:
with:
node-version: '22'
cache: npm
cache-dependency-path: desktop/package-lock.json
cache-dependency-path: |
desktop/package-lock.json
desktop/tray/package-lock.json
- name: Setup Bun
uses: oven-sh/setup-bun@v2
@@ -179,7 +181,7 @@ jobs:
uses: dtolnay/rust-toolchain@stable
- name: Install deps
run: npm ci
run: npm ci && npm --prefix tray ci
- name: Type-check
run: npm run type-check
@@ -213,12 +215,153 @@ jobs:
$proc = Start-Process -FilePath tray/target/release/hermes-relay-tray.exe -WindowStyle Hidden -PassThru
Start-Sleep -Seconds 5
if ($proc.HasExited) { throw "tray app exited early with code $($proc.ExitCode)" }
$proc.Refresh()
if ($proc.MainWindowHandle -ne 0) { throw 'menu-only systray created an application window' }
$traySize = (Get-Item tray/target/release/hermes-relay-tray.exe).Length
if ($traySize -gt 5242880) { throw "tray executable exceeds 5 MiB: $traySize bytes" }
if ($traySize -le 0) { throw 'tray executable is empty' }
Stop-Process -Id $proc.Id -Force
Write-Host "menu-only tray launch smoke OK pid=$($proc.Id) bytes=$traySize"
Write-Host "management tray launch smoke OK pid=$($proc.Id) bytes=$traySize"
- name: Smoke-test packaged installer lifecycle
shell: pwsh
env:
EXPECTED_DESKTOP_VERSION: ${{ needs.validate-release.outputs.version }}
run: |
$ErrorActionPreference = 'Stop'
function Normalize-UserPath([string]$Value) {
return (@($Value -split ';' | Where-Object { $_ }) -join ';')
}
function Get-RawUserPath {
$environmentKey = [Microsoft.Win32.Registry]::CurrentUser.OpenSubKey('Environment')
if ($null -eq $environmentKey) { return '' }
try {
return [string]$environmentKey.GetValue(
'Path',
'',
[Microsoft.Win32.RegistryValueOptions]::DoNotExpandEnvironmentNames
)
} finally {
$environmentKey.Dispose()
}
}
$setup = (Resolve-Path 'dist/tray/hermes-relay-windows-x64-setup.exe').Path
$smokeRoot = Join-Path $env:RUNNER_TEMP 'hermes-installer-lifecycle-smoke'
$smokeProfile = Join-Path $smokeRoot 'profile'
$installDir = Join-Path $smokeRoot 'installed files'
$sessionDir = Join-Path $smokeProfile '.hermes'
$sessionSentinel = Join-Path $sessionDir 'remote-sessions.json'
$uninstaller = Join-Path $installDir 'uninstall-hermes-relay.exe'
$uninstallKey = 'HKCU:\Software\Microsoft\Windows\CurrentVersion\Uninstall\HermesRelay'
$productKey = 'HKCU:\Software\HermesRelay'
$startupKey = 'HKCU:\Software\Microsoft\Windows\CurrentVersion\Run'
$startMenuDir = Join-Path $env:APPDATA 'Microsoft\Windows\Start Menu\Programs\Hermes-Relay CLI'
$oldUserProfile = $env:USERPROFILE
$oldHomeEnv = $env:HOME
$environmentKey = [Microsoft.Win32.Registry]::CurrentUser.OpenSubKey('Environment', $true)
$hadUserPath = $environmentKey.GetValueNames() -contains 'Path'
$originalUserPath = Get-RawUserPath
$originalUserPathKind = if ($hadUserPath) { $environmentKey.GetValueKind('Path') } else { $null }
$userPathBefore = 'C:\Windows\System32'
$environmentKey.Dispose()
$startupBefore = (Get-ItemProperty -Path $startupKey -Name HermesRelayTray -ErrorAction SilentlyContinue).HermesRelayTray
if (Test-Path $uninstallKey) { throw 'installer smoke requires a clean HermesRelay uninstall registry key' }
if (Test-Path $productKey) { throw 'installer smoke requires a clean HermesRelay product registry key' }
if (Test-Path $smokeRoot) { Remove-Item -LiteralPath $smokeRoot -Recurse -Force }
New-Item -ItemType Directory -Force -Path $sessionDir | Out-Null
Set-Content -LiteralPath $sessionSentinel -Value '{"sentinel":"preserve-me"}' -Encoding UTF8
$env:USERPROFILE = $smokeProfile
$env:HOME = $smokeProfile
try {
$environmentKey = [Microsoft.Win32.Registry]::CurrentUser.OpenSubKey('Environment', $true)
$environmentKey.SetValue('Path', $userPathBefore, [Microsoft.Win32.RegistryValueKind]::String)
$environmentKey.Dispose()
$installProcess = Start-Process -FilePath $setup -ArgumentList @('/S', "/D=$installDir") -Wait -PassThru
if ($installProcess.ExitCode -ne 0) { throw "installer exited with code $($installProcess.ExitCode)" }
$expectedFiles = @(
'hermes-relay.exe',
'hermes-relay-tray.exe',
'hermes-relay-ui.cmd',
'hermes-relay-path.ps1',
'uninstall-hermes-relay.exe'
)
foreach ($name in $expectedFiles) {
$path = Join-Path $installDir $name
if (-not (Test-Path -LiteralPath $path -PathType Leaf)) {
throw "packaged installer did not create $path"
}
}
$cli = Join-Path $installDir 'hermes-relay.exe'
$versionOutput = (& $cli --version | Out-String).Trim()
if ($LASTEXITCODE -ne 0) { throw "installed CLI --version exited with code $LASTEXITCODE" }
if ($versionOutput -ne "hermes-relay $env:EXPECTED_DESKTOP_VERSION") {
throw "installed CLI version mismatch: expected $env:EXPECTED_DESKTOP_VERSION, got '$versionOutput'"
}
$helpOutput = (& $cli --help | Out-String)
if ($LASTEXITCODE -ne 0 -or $helpOutput -notmatch 'Usage:') {
throw 'installed CLI --help smoke failed'
}
if (-not (Test-Path -LiteralPath $sessionSentinel -PathType Leaf)) {
throw 'installer removed profile session data'
}
$uninstallProcess = Start-Process -FilePath $uninstaller -ArgumentList '/S' -Wait -PassThru
if ($uninstallProcess.ExitCode -ne 0) { throw "uninstaller exited with code $($uninstallProcess.ExitCode)" }
$deadline = [DateTime]::UtcNow.AddSeconds(20)
while ((Test-Path -LiteralPath $uninstaller) -and [DateTime]::UtcNow -lt $deadline) {
Start-Sleep -Milliseconds 250
}
foreach ($name in $expectedFiles) {
$path = Join-Path $installDir $name
if (Test-Path -LiteralPath $path) { throw "uninstaller left owned artifact $path" }
}
if (Test-Path $uninstallKey) { throw 'uninstaller left the Installed Apps registry key' }
if (Test-Path $productKey) { throw 'uninstaller left the HermesRelay product registry key' }
if (Test-Path -LiteralPath $startMenuDir) { throw "uninstaller left Start-menu artifacts at $startMenuDir" }
if (-not (Test-Path -LiteralPath $sessionSentinel -PathType Leaf)) {
throw 'uninstaller removed preserved profile session data'
}
if ((Get-Content -LiteralPath $sessionSentinel -Raw) -notmatch 'preserve-me') {
throw 'installer lifecycle modified preserved profile session data'
}
# Compare the raw registry value so expandable entries such as
# %USERPROFILE% are not resolved against the isolated smoke profile.
$userPathAfter = Normalize-UserPath (Get-RawUserPath)
if ($userPathAfter -ne $userPathBefore) {
throw "uninstaller did not restore user PATH (before='$userPathBefore', after='$userPathAfter')"
}
$startupAfter = (Get-ItemProperty -Path $startupKey -Name HermesRelayTray -ErrorAction SilentlyContinue).HermesRelayTray
if ($startupAfter -ne $startupBefore) {
throw "installer lifecycle changed the pre-existing tray startup preference"
}
Write-Host "packaged installer lifecycle smoke OK version=$versionOutput install=$installDir"
} finally {
Get-Process -Name 'hermes-relay-tray' -ErrorAction SilentlyContinue |
Stop-Process -Force -ErrorAction SilentlyContinue
if (Test-Path -LiteralPath $uninstaller) {
Start-Process -FilePath $uninstaller -ArgumentList '/S' -Wait | Out-Null
}
$env:USERPROFILE = $oldUserProfile
$env:HOME = $oldHomeEnv
$environmentKey = [Microsoft.Win32.Registry]::CurrentUser.OpenSubKey('Environment', $true)
if ($hadUserPath) {
$environmentKey.SetValue('Path', $originalUserPath, $originalUserPathKind)
} else {
$environmentKey.DeleteValue('Path', $false)
}
$environmentKey.Dispose()
if (Test-Path -LiteralPath $smokeRoot) {
Remove-Item -LiteralPath $smokeRoot -Recurse -Force -ErrorAction SilentlyContinue
}
}
- name: Upload Windows tray release asset
uses: actions/upload-artifact@v4
+86 -1
View File
@@ -8,9 +8,94 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/), and this
### Fixed
- **Issue area labels require maintainer review.** The unreliable keyword-based auto-labeling workflow no longer assigns ownership from ambiguous issue text.
- **Android keeps profile management and retained automation truthful.** Custom Endpoint list and mutation routes now follow the selected Hermes profile, while completed one-shot cron jobs show their retained outcome and expose only valid Runs/Delete actions.
- **Android and Relay recover more generated media reliably.** Android accepts upstream-valid wrapped, punctuated, adjacent, spaced, and Windows `MEDIA:` markers without consuming fenced examples, and Relay translates Docker-visible workspace, home, cache, and configured-mount paths before applying its existing credential, sandbox, and size checks.
## [1.6.3] - 2026-08-11
### Fixed
- **Relay diagnostics distinguish a prior clean stop from a crash.** Doctor and `/relay/info` expose only bounded clean, unclean, or unknown gateway-exit state with an optional suspected out-of-memory hint, without returning raw log evidence.
- **Relay reconnects spread out after shared gateway restarts.** Ordinary exponential reconnect delays use full jitter while explicit reconnects and server-directed retry timing retain their exact behavior.
## [0.4.0-alpha.7] - 2026-08-11
### Fixed
- **Installer lifecycle validation uses an isolated Windows PATH fixture.** Release smoke tests now verify add/remove cleanup against a fixed registry value and restore the runner's original value afterward, independently of the temporary profile used for session-preservation checks.
## [0.4.0-alpha.6] - 2026-08-11
### Fixed
- **Installer cleanup validation compares the unexpanded Windows PATH.** Release smoke tests now read the raw user registry value, ensuring `%USERPROFILE%` entries are verified without temporary-profile expansion changing their apparent value.
## [0.4.0-alpha.5] - 2026-08-11
### Fixed
- **Installer cleanup validation handles expandable Windows PATH entries.** Release smoke tests restore the original profile environment before comparing user PATH, avoiding false failures when unchanged `%USERPROFILE%` entries are expanded inside an isolated test profile.
## [0.4.0-alpha.4] - 2026-08-11
### Fixed
- **Windows release validation waits for installer processes.** The packaged install/uninstall lifecycle smoke now captures GUI-subsystem process exit codes reliably before validating installed files, preserved sessions, registry state, and cleanup.
## [0.4.0-alpha.3] - 2026-08-11
### Added
- **Windows tray provides focused remote-access management.** The compact host-aware popup covers connection state, per-host Ask/Trusted/Full Access, pending grant dialogs, authorized-client revocation, activity, daemon controls, and settings without adding chat, terminal, plugin, voice, or session surfaces.
- **Desktop access policy is isolated per Hermes host.** `hermes-relay hosts` lists and selects local pairings and stores fail-closed access modes independently for each canonical relay URL.
- **Windows CLI installations can add or open the management UI directly.** `hermes-relay ui install|open|status` and the installed UI shim provide a supported lifecycle for optional UI setup, discovery, and activation.
### Changed
- **Daemon connectivity no longer requires a tool grant.** Ask mode can keep an authenticated daemon connected with zero desktop tools attached; Trusted enables command/file tools with task-scoped screen/input grants, while Full Access removes those task prompts only for the selected host.
- **Windows bundle updates preserve the desktop lifecycle.** The CLI and tray coordinate one verified installer launch, restore the daemon and UI after setup, and permit same-version UI add or repair without silently downgrading a newer CLI.
### Fixed
- **Background daemon start reports real readiness.** Detached startup now waits for the spawned process to authenticate and connect, and returns actionable log evidence for configuration, authentication, early-exit, and timeout failures.
- **Local and release tray builds embed the packaged UI.** Development installs use Tauri's production protocol instead of attempting to load a missing localhost development server, and release CI exercises a silent install/uninstall lifecycle.
- **Windows-trusted certificates work in the desktop CLI.** The packaged Windows binary and newer Node runtimes add the Windows certificate store without dropping bundled or operator-supplied roots, while TLS verification and Relay certificate pinning remain enforced.
## [1.6.2] - 2026-08-11
### Fixed
- **Paired sessions use recognizable device identities.** Relay sessions preserve a client-provided hostname as the primary name, retain model and platform details, and enrich valid reconnects without requiring users to pair again.
- **Long-lived session expiry is readable.** The Dashboard presents paired-session lifetime in days or weeks with the exact local deadline available in the detail view instead of accumulating hundreds of hours.
## [Android 1.8.1] - 2026-08-09
### Fixed
- **Android preserves complete long-session transcripts.** API-server and profile-scoped Dashboard history reads now use explicit bounded pagination, retain compatibility with older unpaginated responses, and keep edit, retry, sharing, and recovery anchors stable beyond Hermes' latest-500 default window.
- **Android follows authoritative Gateway turn contracts.** Submit rejections retain the server's message without silently falling through to SSE, event envelopes reconcile consistently, and edit-and-regenerate requests send the required truncation confirmation.
## [Android 1.8.0] - 2026-08-09
### Added
- **Android chat keeps work in context and makes live turns easier to read.** Draft text, edits, quotes, and attachments stay with their connection, profile, and session; conversation search and prompt-turn navigation jump by stable message identity; message actions reveal smoothly on tap; quoted replies use linked previews without placing markup in the composer; assistant replies retain their compact high-contrast bubbles; and pending attachments support preview, removal, and accessible reordering.
- **Android reasoning and tool activity use a quieter transcript.** Live thinking opens as an inline disclosure and settles to a collapsed Thought row, while consecutive routine reads, searches, commands, browser actions, and device actions share one live activity ticker or concise completed summary. Approvals, failures, generated media, file changes, output risks, and delegated work keep their own visible lifecycle surfaces even when ordinary tool progress is hidden.
- **Android Profile Shelf makes agent switching immediate without mixing conversations.** The Chat header expands a compact, accessible shelf with ordered profile avatars, a subtle Server-default home badge on the resolved identity, last-session restoration, display hiding, lock controls, and one full switcher shared with Agent Passport.
- **Android accepts shared text as a new Chat draft.** Hermes Relay now appears in the system sharesheet for text, opens the active profile in a fresh conversation, and fills the composer for review without sending automatically.
### Changed
- **Android appearance controls are more expressive and easier to preview.** Theme presets, accent and shape customization, imported Sphere skins, and custom pet creation share one live-preview workflow while preserving separate agent, background, and companion identities.
### Fixed
- **Android restores complete Gateway activity and makes settled replies speakable.** Successful Gateway turns reconcile structured persisted tool calls even when an upstream server omits live tool lifecycle events, and a configured voice can read a completed assistant reply from its message actions without requiring Voice Mode. While that narration is active, the same message actions expose Stop without cancelling an unrelated chat turn.
- **Android chat matches standard keyboard, scrolling, and photo behavior.** Sentence capitalization is enabled, physical Enter can send or insert a newline according to a device-level setting, Ctrl/Command+Enter always submits, directional keys stay with the text caret, expanded thinking and tool content retains bottom-follow until the user scrolls away, and portrait attachments honor their EXIF orientation in previews and message viewers.
- **Android distinguishes live-turn corrections from queued follow-ups.** The composer names its current action with visible text and accessible state, successful gateway redirects show a correction lifecycle marker, and attachment-bearing follow-ups always enter the session-owned queue because the upstream redirect operation is text-only.
- **Android visibly explains quiet startup work without an empty chat bubble.** The full-size thinking animation now sits directly in the conversation lane with a stable reviewable status until the first answer text arrives, while recovery keeps its explicit reconnecting state.
- **Android keeps pets and screen chrome inside safe interaction bounds.** Floating companions avoid agent identity rows and controls during scrolling, remain touchable for their menu, and settings headers respect edge-to-edge system insets.
## [Android 1.7.1] - 2026-08-08
### Fixed
+22 -19
View File
@@ -1,35 +1,38 @@
# Hermes-Relay-CLI v__VERSION__
# Hermes-Relay CLI v__VERSION__
**Release Date:** 2026-07-13
**Release Date:** 2026-08-11
This alpha makes the desktop direction explicit: Hermes-Relay is a real CLI/TUI with an optional Windows right-click systray—not a second desktop application. The old Tauri/WebView dashboard and its embedded windows are gone. The installed CLI remains the single source of behavior for pairing, TUI, daemon management, grants, audit, diagnostics, chat, voice, and tools.
This alpha replaces the right-click-only Windows tray with the compact **Hermes-Relay CLI UI** popup while keeping Hermes-Relay's desktop boundary narrow. Chat, the remote TUI, plugins, voice, and agent sessions remain CLI or upstream desktop concerns.
**Experimental phase.** Assets are unsigned, so Windows SmartScreen and macOS Gatekeeper may warn on first launch. Standalone CLI binaries ship for Windows x64, Linux x64, and macOS x64/arm64; the optional native systray is Windows-only.
**Experimental phase.** Assets remain unsigned, so Windows SmartScreen and macOS Gatekeeper may warn on first launch. Standalone CLI binaries ship for Windows x64, Linux x64, and macOS x64/arm64; the management tray is Windows-only.
## What's changed
### Added
- **Persistent desktop-use control.** `hermes-relay computer-use status|enable|disable|cancel` stores one local preference, reports daemon privilege and active/pending grants, and can end an active task-scoped grant without relying on a GUI.
- **Headless grant review.** `hermes-relay grants` lists pending local computer-use requests and supports interactive review plus explicit `approve`, `reject`, and JSON forms for scripts.
- **Typed Relay chat option.** `chat --relay-chat` sends `chat.send` over WSS and renders typed `stream.event` v1 assistant, tool, artifact, memory, skill, and error lifecycles while preserving the existing gateway path as the default.
- **Release-parity verification.** One version contract now keeps the npm package, compiled CLI, Rust tray, lockfile, and installer metadata aligned. The Windows verification target covers TypeScript, compiled-binary smoke tests, Rust formatting/lint/check/tests, and installer packaging.
- **Compact Windows management tray.** The popup provides connection status, host selection, per-host access, pending approval dialogs, recent activity, daemon controls, startup settings, and authorized-client revocation.
- **Host-aware desktop access.** `hermes-relay hosts` lists and selects paired Hermes instances and stores independent Ask, Trusted, or Full Access policy for each canonical relay URL.
- **In-window grant decisions.** New computer-use requests bring the tray forward and show the requesting host, scope, reason, and duration with explicit Approve and Reject actions.
- **Supported UI lifecycle from the CLI.** `hermes-relay ui install|open|status` lets a CLI-only Windows installation add, reveal, or inspect the optional management UI without rerunning setup by hand.
### Changed
- **Menu-only Windows systray.** The optional tray is a small native Rust process with no application window, WebView, overlay, embedded terminal, chat view, voice view, or settings dashboard. Interactive actions open the installed CLI in a normal terminal.
- **State- and privilege-aware daemon control.** The menu reports PID-backed daemon state and User/Administrator privilege, disables invalid lifecycle actions, and requests UAC only when **Start/Restart daemon as Administrator…** is explicitly chosen. The tray itself remains unprivileged.
- **Visible desktop-use safety.** The tray shows enablement, active grant mode and expiry, warns when an Administrator control grant is active, raises a native alert for pending approvals, opens CLI grant review, and provides immediate cancellation and emergency stop.
- **Per-user Windows installation.** The default PowerShell installer downloads the checksum-verified NSIS package, installs the CLI and optional tray under `~/.hermes/bin`, adds Start-menu shortcuts and user PATH, and can start the tray at sign-in. CLI-only installation remains available with `HERMES_RELAY_INSTALL_SURFACE=cli`.
- **Daemon startup is connectivity-first.** Ask mode can keep an authenticated daemon connected with zero desktop tools attached, so starting the daemon does not itself grant authority.
- **Full Access is explicit and host-scoped.** Trusted hosts may use command and file tools while screen/input remains task-granted. Full Access also removes task prompts for screen, input, and file patches for that host, while authentication, audit, revocation, emergency stop, and UAC boundaries remain enforced.
- **Host changes apply immediately.** Selecting a different host or changing its access mode restarts an already-running daemon and the UI verifies that the daemon URL matches the selected host before showing it as connected.
- **PowerShell remains first-class.** Agents should prefer the dedicated `desktop_powershell` RPC for native Windows work; `desktop_terminal` remains cmd-compatible for existing callers.
- **CLI and UI updates share one verified installer.** Bundle updates coordinate shutdown and restart, allow same-version UI repair, and refuse accidental downgrade unless explicitly forced.
### Fixed
- **Installed-binary diagnostics.** `hermes-relay doctor` reports the physical Bun-compiled executable instead of a virtual embedded-module path, so PATH and install-directory checks describe the binary that actually launched.
- **Release guardrails.** CLI tag automation rejects version drift, tags not contained in `main`, oversized tray binaries, or a tray process that creates an application window.
- **Detached daemon start reports real readiness.** `daemon start` waits for the spawned PID to authenticate and connect, and reports configuration, authentication, early-exit, and timeout diagnostics instead of returning a false success.
- **Normal tray operation no longer requires opening a CLI for grants.** Pending requests are resolved directly in the focused management dialog.
- **Release checks match the management tray.** CI builds the React assets, validates Tauri metadata, and smoke-tests the packaged tray without obsolete menu-only size or window assertions.
- **Installed tray builds no longer depend on a localhost development server.** Local and packaged builds embed their UI assets, eliminating the `127.0.0.1 refused to connect` failure.
## Install
**Windows CLI + optional systray (PowerShell):**
**Windows CLI + management tray (PowerShell):**
```powershell
irm https://raw.githubusercontent.com/Codename-11/hermes-relay/main/desktop/scripts/install.ps1 | iex
@@ -53,11 +56,11 @@ Pin this release with `HERMES_RELAY_VERSION=__TAG__`.
```text
hermes-relay --version
hermes-relay pair --remote ws://<host>:8767 --grant-tools
hermes-relay hosts list --json
hermes-relay daemon start
hermes-relay daemon status
hermes-relay daemon status --json
```
On Windows, open **Hermes Relay Systray** from the Start menu and right-click its notification-area icon. No separate desktop window is installed.
On Windows, click the Hermes-Relay CLI UI notification-area icon to open the management popup directly above it.
See the [CLI and systray guide](https://hermes-relay.dev/docs/desktop/) for installation, commands, desktop-use safety, and troubleshooting.
See the [CLI and tray guide](https://hermes-relay.dev/docs/desktop/) for installation, access modes, grants, and troubleshooting.
+130
View File
@@ -1,5 +1,135 @@
# Hermes-Relay — Dev Log
## 2026-08-09 — Gateway activity recovery and chat speech
Successful Android Gateway turns now reconcile against their profile-owned,
structured session history. This recovers persisted tool calls when an upstream
Gateway completes a turn without emitting live tool lifecycle events; assistant
prose is never inspected for inferred activity, and the recovered calls continue
through the existing Off, Compact, and Detailed display policy.
The Speak message action now follows configured voice readiness and idle output
state instead of active Voice Mode or presentation style. A settled assistant
reply can therefore be read aloud directly from chat, while live or provider
playback still prevents overlapping output. One-shot message narration owns its
completion state outside Voice Mode and replaces Speak with Stop while active;
stopping drains only that narration pipeline and does not cancel a chat turn
started while the response was playing.
## 2026-08-09 — Quiet reasoning and grouped tool activity
Android Chat now treats reasoning and routine tools as transcript scaffolding.
Visible live reasoning opens automatically without a tinted card, then collapses
to a quiet Thought disclosure when it settles unless the reader has explicitly
chosen its state. Empty reasoning remains absent and the existing first-token
status continues to own the waiting state.
Top-level routine calls retain their source order but render as consecutive
activity runs. A live run keeps one summary and one latest-activity ticker in a
stable footprint; a settled run becomes one collapsed summary that can disclose
the original identity-preserving tool rows. File edits, approval/question tools,
generated media, failures, output-risk findings, and delegated work split runs
and retain independent surfaces. Off hides only ordinary activity runs, Compact
uses compact disclosed rows, and Detailed preserves the full per-tool detail
surface on demand. Expansion still yields bottom-follow ownership, and each run
registers its measured bounds as Chat pet terrain.
## 2026-08-09 — Android chat experience and attachment polish
The Android composer now declares sentence capitalization and a Send IME
action. A device-level setting chooses whether unmodified physical Enter sends
or inserts a newline; Shift+Enter remains a newline and Ctrl/Command+Enter
always submits. Every submit route converges on the existing live-turn owner,
so the current gateway state still decides whether content steers the active
turn or queues behind it. Directional focus traversal is cancelled while the
editor owns focus so hardware arrow keys continue to move the caret and
selection.
Conversation bottom-follow now remains owned when thinking or tool details
expand. Only an actual drag ending above the bottom yields that ownership, and
a chat first measured while the IME is already visible now captures the same
resize-follow state as a keyboard opened after composition.
Bitmap-backed attachment surfaces now apply EXIF rotation and reflection before
display. Attachment reads and Base64 conversion also leave the UI thread, so
selecting a larger photo no longer performs the full ingestion path inside the
activity-result callback.
Composer drafts now belong to the stable connection, profile, and session
identity. Text, edit context, and pending attachments restore when returning to
a chat without persisting attachment bytes. Pending attachments expose bounded,
orientation-aware previews plus explicit remove and reorder controls.
Conversation overflow now opens transcript search with previous/next matches
and a prompt-turn rail, both keyed to the same stable UI identity as the message
list. Assistant prose retains the compact bubble and subtle edge treatment that
keeps it legible above the animated chat background. Tapping a message reveals
the existing copy, quote, speak, and edit actions with reduced-motion-aware
expansion and accessible targets.
Quotes are composer-owned structured references instead of raw blockquote text.
The composer and sent message render a linked, highlighted author preview; the
transport remains ordinary Markdown so unmodified Desktop and TUI clients show
a readable quoted reply. Thinking and top-level tools continue to use their
independent compact thought bubbles and configured compact or full tool cards,
without an aggregate completion card. The composer also names Correction and
Queue states with visible labels. Gateway redirects remain text-only:
follow-ups with attachments are forced through the existing destination-owned
queue so files cannot be left behind by a correction request.
## 2026-08-08 — Standalone Android thinking status
Blank streaming assistant rows now present the full-size working animation
directly in the conversation lane above the visible `Still working…` label,
without painting an empty assistant bubble around the status. The first answer
token replaces that standalone state with the normal response bubble, while
recovery retains the distinct `Reconnecting to your answer…` wording. The
status owns one stable TalkBack description and suppresses animated child
nodes, avoiding repeated announcements without claiming measurable progress.
## 2026-08-08 — Android text-share draft handoff
The shared Android manifest now advertises a `text/*` `ACTION_SEND` target for
both app flavors. `MainActivity` accepts only non-blank single-item text shares
and places them in a process-local, identity-fenced handoff that survives cold
Compose initialization. Once the configured chat context settles, the app root
navigates to Chat and delegates draft creation and composer prefill to
`ChatViewModel`.
The ViewModel reuses the existing new-chat lifecycle, preserving Gateway
background-turn reconciliation and the active connection/profile/transport
namespace. Composer prefills use a one-consumer conflated channel so an intent
received before Chat composition is delivered once. Shared text is never
routed through message sending; the user must review and submit it explicitly.
## 2026-08-08 — Android Profile Shelf and profile-context identity
Chat profile selection now lives in a collapsible shelf directly below the top
app bar. The header toggles the shelf, the active capsule opens Agent Passport,
inactive 48 dp avatars switch context, and a pinned overflow opens the same full
switcher used by Passport. Saved ordering and hidden state drive both surfaces;
the selected hidden profile remains disclosed, while a one-identity shelf stays
out of the layout. Long-press actions expose inspection, Passport, profile lock,
and hiding without adding activity or presence claims.
The shelf uses the chat surface instead of a second elevated toolbar. A neutral
active capsule, 36 dp avatar artwork inside 48 dp targets, compact spacing, and
a contained overflow affordance keep the row visually subordinate to Chat. When
Server default resolves to a concrete profile, that profile's avatar remains
the identity and a small home badge discloses its default routing role.
Local avatar lookup remains keyed to the Server-default presentation identity,
so an image customized while that row is selected appears consistently in both
the Chat header and shelf rather than being re-keyed to whichever explicit
profile is currently active.
The Server-default sentinel is now distinct from a profile literally named
`default`. Profile selection restores the last compatible connection/profile/
transport session, otherwise leaves a fresh draft. Gateway turns detach and
reconcile in their original session, live SSE turns keep switching disabled,
and every profile transition clears session-scoped model, provider, personality,
reasoning, approval, Fast, and YOLO state before the destination session seeds
its own values. Server sticky-default state is never written.
## 2026-08-08 — Streaming reply tail follow
Android's conversation-bottom follower now reads the current immutable message
+4 -4
View File
@@ -1,8 +1,8 @@
# Hermes-Relay-Server v__VERSION__
**Release Date:** August 8, 2026
**Release Date:** August 11, 2026
This patch makes the optional Dashboard plugin's Android setup handoff reliable for hosted Hermes connections.
This patch improves gateway recovery diagnostics and prevents clients from reconnecting in lockstep after a shared restart.
Standard chat, session history, and Vanilla Hermes voice remain upstream-owned and do not require this plugin.
@@ -10,8 +10,8 @@ Standard chat, session history, and Vanilla Hermes voice remain upstream-owned a
### Fixed
- **Canonical hosted-Hermes setup handoff.** The Dashboard plugin supplies the verified Dashboard address Android needs to continue through the official system-browser authentication flow.
- **Contained dialog focus behavior.** Mobile setup dialogs retain their own focus and keyboard handling without disrupting the surrounding Dashboard.
- **Bounded prior-exit diagnostics.** Relay Doctor and `/relay/info` distinguish a clean stop, an unclean exit, and unknown history, with an optional suspected out-of-memory hint. Raw logs are never returned through the API.
- **Desynchronized recovery.** Ordinary exponential reconnect delays use full jitter so multiple Relay clients do not retry in lockstep after the gateway restarts. Explicit reconnects and server-directed retry timing remain unchanged.
## Install / update
+3 -3
View File
@@ -138,7 +138,7 @@ Full server setup, TLS, and systemd details: [docs/relay-server.md](docs/relay-s
<table>
<tr>
<td align="center" width="25%"><img src="assets/screenshots/01_startup.png" alt="Cold start" width="100%"><br><sub><b>Cold start</b></sub></td>
<td align="center" width="25%"><img src="assets/screenshots/01_voice_conversation.png" alt="Voice controls in chat" width="100%"><br><sub><b>Voice in chat</b></sub></td>
<td align="center" width="25%"><img src="assets/screenshots/02_chat.png" alt="Streaming chat" width="100%"><br><sub><b>Streaming chat</b></sub></td>
<td align="center" width="25%"><img src="assets/screenshots/03_voice.png" alt="Hands-free voice" width="100%"><br><sub><b>Hands-free voice</b></sub></td>
<td align="center" width="25%"><img src="assets/screenshots/04_sessions.png" alt="Session history" width="100%"><br><sub><b>Session history</b></sub></td>
@@ -186,7 +186,7 @@ tracked independently so community corrections remain easy to contribute.
## Hands on any machine — the Hermes-Relay CLI&nbsp;<sub>(alpha)</sub>
> **Alpha.** Self-contained CLI binaries ship for Windows x64, Linux x64, and macOS x64/arm64 — no Node required. Windows also has an optional native, menu-only systray. Assets are unsigned during the experimental phase, so SmartScreen / Gatekeeper warnings are expected.
> **Alpha.** Self-contained CLI binaries ship for Windows x64, Linux x64, and macOS x64/arm64 — no Node required. Windows also has an optional compact management tray. Assets are unsigned during the experimental phase, so SmartScreen / Gatekeeper warnings are expected.
The agent's brain stays on the host; the CLI lets it call tools **on your machine** over the same WSS relay — `read_file`, `write_file`, `terminal`, `search_files`, `screenshot`, `clipboard`, `open_in_editor`, and more — behind a one-time consent gate, interactive diff approval for patches, and a `--no-tools` kill-switch.
@@ -202,7 +202,7 @@ hermes-relay update # self-update via GitHub Releases
It pairs against the **same relay and credential store** as the Android app — pair once from either, both work. Tagged on the `desktop-v*` [release track](https://github.com/Codename-11/hermes-relay/releases?q=desktop), with historical releases still visible under `cli-v*`.
On Windows, the default installer adds the optional right-click-only systray: no dashboard or app window, just TUI launch, User/Administrator-aware daemon controls, pairing, local grant review, audit, diagnostics, logs, desktop-use status/cancellation, sign-in startup, and emergency stop.
On Windows, the default installer adds the optional compact **Hermes-Relay CLI UI** tray popup for host selection and pairing, connection and daemon state, per-host Ask/Trusted/Full Access, local grant dialogs, authorized-client revocation, activity, settings, and emergency stop. It is a management surface only—chat, TUI, plugins, voice, and agent sessions remain CLI/upstream concerns.
- **Docs:** [CLI guide](https://hermes-relay.dev/docs/desktop/) · [`desktop/README.md`](desktop/README.md)
- **AI-agent setup recipe:** `/hermes-relay-desktop-setup`
+6 -3
View File
@@ -119,9 +119,9 @@ artifacts.
### CLI / tray versioning
`desktop/package.json` is the Desktop/CLI release track's source of truth. Its version
must match the generated CLI and native Windows systray metadata. The systray is
a menu-only controller for the installed CLI; it has no application window,
WebView, embedded terminal, or separate desktop product surface. The public
must match the generated CLI and Windows tray metadata. The tray is a compact
management popup over the installed CLI and shared state; it has no chat,
embedded terminal, plugins, voice, or separate desktop product surface. The public
release remains one `Hermes-Relay-Desktop` track containing CLI binaries plus the
optional Windows installer.
@@ -132,6 +132,9 @@ optional Windows installer.
| `desktop/src/version.ts` | compiled CLI runtime version |
| `desktop/tray/Cargo.toml` | native systray package version |
| `desktop/tray/Cargo.lock` | locked systray package version |
| `desktop/tray/tauri.conf.json` | tray application and bundle version |
| `desktop/tray/package.json` | tray UI package version |
| `desktop/tray/package-lock.json` | locked tray UI package version |
Prepare a new CLI version on `dev` without creating a tag or npm-generated
commit:
+13 -23
View File
@@ -1,10 +1,10 @@
# Hermes-Relay-Android v1.7.1
# Hermes-Relay-Android v1.8.1
**Release Date:** August 8, 2026
**Release Date:** August 9, 2026
## Download
> Installing on your phone? Download `hermes-relay-1.7.1-sideload-release.apk` and tap it for the full feature set, or install the conservative build from [Google Play](https://play.google.com/store/apps/details?id=com.axiomlabs.hermesrelay).
> Installing on your phone? Download `hermes-relay-1.8.1-sideload-release.apk` and tap it for the full feature set, or install the conservative build from [Google Play](https://play.google.com/store/apps/details?id=com.axiomlabs.hermesrelay).
The `.aab` file is a Play Console upload bundle and cannot be installed by tapping it on a phone.
@@ -12,32 +12,22 @@ Verify the download against `SHA256SUMS.txt`. See the [sideload guide](https://h
## Summary
This patch tightens Android chat ownership, interaction safety, session
durability, and hosted-Hermes onboarding after the 1.7.0 release.
This patch keeps long Hermes conversations complete and aligns Android's
Gateway behavior with current upstream turn contracts.
## Fixed
- Growing streamed replies stay visible while bottom-follow is owned, and
intentional scrollback still releases that ownership.
- Completed replies transition immediately from stable live text to rendered
Markdown without reopening the session.
- Queued follow-ups retain their originating connection, profile, session,
route, attachments, and voice context through concurrent session switches.
- Approval cards remain pending until an explicit labeled response or an
authoritative upstream expiry; scrolling, navigation, and later activity
cannot silently decide them.
- Session pins and archives persist through the owning Hermes profile, with
rollback when an update fails.
- Live tool cards retain stable identity and details while a run is active, and
duplicate model inventory rows are reconciled before rendering.
- Hosted Hermes addresses complete through the official Dashboard system-browser
sign-in flow and resume the verified connection after callback.
- Agent Passport safety controls use accessible full-width choices and a
reliable close or downward-swipe path.
- Complete transcript reads page explicitly across both API-server and
profile-scoped Dashboard routes, so sessions beyond Hermes' latest-500
default retain stable history, sharing, retry, edit, and recovery anchors.
- Gateway submit rejections preserve the authoritative server message without
silently falling through to SSE.
- Gateway event envelopes reconcile consistently, and edit-and-regenerate
requests send the required truncation confirmation.
## Install / Verify
- App version: **1.7.1** (versionCode **40**).
- App version: **1.8.1** (versionCode **42**).
- Standard Chat, sessions, Manage, and Vanilla Hermes voice continue to work
against unmodified upstream Hermes.
- The optional Relay plugin is not required for standard Android chat or hosted
+24 -1
View File
@@ -6,6 +6,29 @@ For shipped work, see `DEVLOG.md`. For architectural decisions, see `docs/decisi
---
## Structured desktop hardware capabilities
Desktop command, PowerShell, process, and job tools currently execute with the
desktop daemon's OS-user authority. Add typed hardware operations for reliable
schemas, audit detail, and task-scoped approval, but do not present hardware
toggles as isolation while an enabled general shell can reach the same device.
- Define per-host capabilities for commands, files, processes, clipboard,
screen, input, connected devices, microphone, and camera. Disabled must win,
hardware-sensitive capabilities must default off, and unavailable backends
must appear unavailable rather than as inert toggles.
- Add a **Structured only** access profile that withholds shell/process escape
hatches so individual capability toggles become enforceable boundaries.
- Implement connected-device support first with typed, serial-bound ADB
operations (`list`, `shell`, `push`, `pull`, `install`, and bounded logcat)
instead of a generic device-exec wrapper.
- Add microphone and camera only with backend readiness detection, bounded local
grants, active-use indicators, audit events, and immediate cancellation.
- Reconcile legacy `desktop_screenshot` with the task-granted computer screenshot
path so screen capture follows one policy.
---
## Android Plugin Studio protocol follow-ups
The first live declarative Plugin lane is host-local: Relay tools create bounded
@@ -1274,7 +1297,7 @@ Follow-ups:
profile/skill-aware empty-state chips and the ~40-flow recomposition hotspot at
the top of `ChatScreen`.
- **Pet hot-load + in-app add/remove (shipped 2026-06-20).** Pets now live-refresh: an `avatarsRefreshTick` keys the avatar `produceState` in `RelayApp`, and Appearance re-scans `pets/` on open and after in-app import/delete — no app restart. Appearance gained "Add a pet" (SAF `.zip` import via `PetImporter`, zip-slip/zip-bomb guarded + validated through `toAvatar`) and an "Installed pets" list with per-pet remove (`PetLoader.deletePet`, confirm dialog, Sphere fallback). Remaining:
- **Sphere-skin parity.** Skins are still process-scoped + `adb push` only — the live tick and the importer cover pets, not skins. Extend the tick to `loadUserSkins` and add a `.json` skin import if hot-loading/adding skins in-app is wanted.
- **Sphere-skin parity (shipped 2026-08-09).** Appearance now imports a bounded, validated declarative `.json` skin through the system picker, hot-refreshes the shared sphere registry, and selects the imported skin without an app restart.
- `**adb push` into `Android/data` hangs on Samsung scoped storage.** Confirmed: pushing a pet pack to `/sdcard/Android/data/<pkg>/files/pets/` stalls (no bytes written) although `adb shell ls` of the dir works. In-app `.zip` import is the supported path; `/sdcard/Download` pushes fine. Consider softening `docs/pet-spec.md` + user-docs to lead with in-app import over adb.
- **On-device import/delete smoke.** Import `/sdcard/Download/lucy.zip` via Add a pet → confirm Lucy appears, selects, and animates all states; then remove it and confirm the avatar falls back to the Sphere.
- **Pet behavior model — richer state association (spec'd 2026-06-19, `docs/pet-spec.md` "Agent states &amp; pet behavior").** Shipped: the honesty clamp (declared reactivity ∩ `PET_RENDERER_CAPABILITIES`), the friendly `writing` alias, the `**working`/tool-use overlay** (pet-local sub-state from `toolCallBurst`; opt-in `working` clip drives both the swap and the Tools badge), the **one-shot reaction layer** (`greet`/`wake` on appear, `done`/`celebrate` on turn-finish — opt-in, play-once-then-revert, transition-derived; `ONE_SHOT_MAX_MS` backstop), and `**intensity` modulation** (opt-in `reactive.intensity` → live playback speedup ≤1.6× via `rememberUpdatedState`; un-clamps the Activity badge). Voice · Tools · Activity reactivity is now complete. Remaining:
+3 -2
View File
@@ -320,6 +320,7 @@ dependencies {
// Coil 3 — async image loading for generated images in chat
implementation(libs.coil.compose)
implementation(libs.coil.network.okhttp)
implementation(libs.exifinterface)
// QR Code scanning (ML Kit + CameraX)
implementation(libs.mlkit.barcode)
@@ -369,8 +370,8 @@ dependencies {
// [POC] Roborazzi host-side screenshot rendering (src/test, Robolectric).
// Renders real composables on the JVM at an exact canvas — no device, no
// status bar, no clipping. See StoreScreenshotTest.
testImplementation("io.github.takahirom.roborazzi:roborazzi:1.70.0")
testImplementation("io.github.takahirom.roborazzi:roborazzi-compose:1.70.0")
testImplementation("io.github.takahirom.roborazzi:roborazzi:1.71.0")
testImplementation("io.github.takahirom.roborazzi:roborazzi-compose:1.71.0")
testImplementation(libs.compose.ui.test.junit4)
testImplementation(libs.compose.ui.test.manifest)
testImplementation("androidx.test.ext:junit:1.3.0")
Binary file not shown.

Before

Width:  |  Height:  |  Size: 128 KiB

After

Width:  |  Height:  |  Size: 176 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 166 KiB

After

Width:  |  Height:  |  Size: 186 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 112 KiB

After

Width:  |  Height:  |  Size: 132 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 134 KiB

After

Width:  |  Height:  |  Size: 106 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 129 KiB

After

Width:  |  Height:  |  Size: 232 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 222 KiB

After

Width:  |  Height:  |  Size: 203 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 110 KiB

After

Width:  |  Height:  |  Size: 109 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 166 KiB

After

Width:  |  Height:  |  Size: 180 KiB

@@ -1 +1 @@
Growing replies now stay visible without overriding intentional scrollback, completed Markdown renders immediately, and queued follow-ups remain with their originating chat. Session pins and archives persist, approval cards require an explicit decision, Agent Passport controls are easier to use, and hosted Hermes setup completes through the official Dashboard sign-in flow.
Long sessions now retain complete history beyond Hermes' latest-500 default, keeping edit, retry, sharing, and recovery anchors stable. Gateway submit rejections preserve the server's message without unintended SSE fallback, while event envelopes and edit-and-regenerate requests follow current upstream contracts.
+7
View File
@@ -48,6 +48,13 @@
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
<!-- User-mediated text handoff. The app opens a fresh Chat draft
and fills the composer; it never sends from an external intent. -->
<intent-filter>
<action android:name="android.intent.action.SEND" />
<category android:name="android.intent.category.DEFAULT" />
<data android:mimeType="text/*" />
</intent-filter>
<!-- The loopback native-PKCE result page uses this fixed, tokenless
link only to bring the installed flavor back to the foreground.
MainActivity intentionally does not interpret the URI as an auth
+56
View File
@@ -1,5 +1,61 @@
{
"versions": [
{
"version": "1.8.1",
"title": "Complete, reliable transcripts",
"date": "2026-08-09",
"sections": [
{
"header": "Keep long sessions complete",
"bullets": [
"Android pages explicitly through complete API-server and profile-scoped Dashboard history instead of silently stopping at Hermes' latest-500 default.",
"Sharing, retry, edit, and recovery retain stable transcript anchors while bounded safety limits keep unusually large reads controlled."
]
},
{
"header": "Follow Gateway truth",
"bullets": [
"Authoritative submit rejections preserve the server's message without an unintended SSE fallback.",
"Gateway event envelopes and edit-and-regenerate truncation confirmation now follow current upstream contracts."
]
}
]
},
{
"version": "1.8.0",
"title": "Conversations with more context",
"date": "2026-08-09",
"sections": [
{
"header": "Keep the whole turn together",
"bullets": [
"Quote, edit, search, and attach or reorder files without losing the active connection, profile, or session.",
"Share text from another Android app into a fresh Chat draft for review before sending."
]
},
{
"header": "See the work without the clutter",
"bullets": [
"Live thinking settles into a compact Thought disclosure, while routine tool activity groups into concise runs.",
"Approvals, failures, generated media, file changes, risks, and delegated work remain clearly distinct."
]
},
{
"header": "Switch agents, not identities",
"bullets": [
"The Profile Shelf switches agents from Chat while restoring each profile's last session.",
"Agent Passport model and reasoning controls remain scoped to the active session instead of rewriting server defaults."
]
},
{
"header": "Make it yours",
"bullets": [
"Preview theme accents and shapes, Sphere skins, and pets in one Appearance workflow.",
"Message speech controls, pet touch targets, scrolling terrain, image rotation, and edge-to-edge settings layout are more reliable."
]
}
]
},
{
"version": "1.7.1",
"title": "Safer, steadier conversations",
+5 -6
View File
@@ -1,7 +1,6 @@
v1.7.1 - Safer, steadier conversations
v1.8.1 - Complete, reliable transcripts
* Follow growing replies without overriding intentional scrollback.
* Render completed Markdown immediately and keep live tool details expandable.
* Keep queued follow-ups with their originating chat and persist session pins and archives.
* Require explicit approval decisions and improve Agent Passport controls.
* Complete hosted Hermes setup through the official Dashboard sign-in flow.
* Keep complete history in long sessions beyond Hermes' latest-500 default.
* Preserve stable edit, retry, sharing, and recovery anchors while paging history.
* Show authoritative Gateway rejection messages without an unintended fallback.
* Reconcile Gateway events and edit-and-regenerate requests with current upstream contracts.
@@ -25,6 +25,8 @@ import com.hermesandroid.relay.notifications.TurnCompleteNotifier
import com.hermesandroid.relay.notifications.InteractionRequestNotifier
import com.hermesandroid.relay.ui.RelayApp
import com.hermesandroid.relay.util.NavRouteRequest
import com.hermesandroid.relay.util.SharedTextRequest
import com.hermesandroid.relay.util.extractSharedText
import com.hermesandroid.relay.viewmodel.ConnectionViewModel
import kotlinx.coroutines.launch
import kotlinx.coroutines.flow.collect
@@ -127,6 +129,7 @@ class MainActivity : AppCompatActivity() {
// in RelayApp's NavRouteRequest collector — we just pump the request
// into the SharedFlow here.
consumeNavRouteIntent(intent)
consumeSharedTextIntent(intent)
val consumedAssistantActivation =
com.hermesandroid.relay.assistant.AssistantSessionProtocol.consumeActivation(
this,
@@ -153,6 +156,7 @@ class MainActivity : AppCompatActivity() {
// instead of onCreate. RelayApp's collector handles both cases.
setIntent(intent)
consumeNavRouteIntent(intent)
consumeSharedTextIntent(intent)
com.hermesandroid.relay.assistant.AssistantSessionProtocol.consumeActivation(this, intent)
// === END PHASE3-safety-rails-followup ===
}
@@ -163,6 +167,15 @@ class MainActivity : AppCompatActivity() {
NavRouteRequest.tryRequest(route)
}
private fun consumeSharedTextIntent(intent: Intent?) {
val sharedText = extractSharedText(
action = intent?.action,
mimeType = intent?.type,
text = intent?.getCharSequenceExtra(Intent.EXTRA_TEXT),
) ?: return
SharedTextRequest.tryRequest(sharedText)
}
private fun configureAssistantWindow(intent: Intent?) {
if (
intent?.getBooleanExtra(
@@ -1,6 +1,7 @@
package com.hermesandroid.relay.auth
import android.content.Context
import android.provider.Settings
import android.util.Log
import com.hermesandroid.relay.data.Connection
import com.hermesandroid.relay.data.EndpointCandidate
@@ -631,7 +632,7 @@ class AuthManager(
val now = System.currentTimeMillis() / 1000L
val defaults = PairedSession(
token = token,
deviceName = android.os.Build.MODEL,
deviceName = relayDeviceName(),
expiresAt = null,
grants = emptyMap(),
transportHint = null,
@@ -651,7 +652,7 @@ class AuthManager(
val transportHint = obj["transport_hint"]?.jsonPrimitive?.contentOrNull
val firstSeen = obj["first_seen"]?.jsonPrimitive?.longOrNull ?: now
val deviceName = obj["device_name"]?.jsonPrimitive?.contentOrNull
?: android.os.Build.MODEL
?: relayDeviceName()
PairedSession(
token = token,
@@ -750,6 +751,26 @@ class AuthManager(
})
}
private fun JsonObjectBuilder.putRelayDeviceIdentity() {
val model = android.os.Build.MODEL.orEmpty().ifBlank { "Android device" }
val deviceName = relayDeviceName()
put("device_name", deviceName)
put("device_hostname", deviceName)
put("device_model", model)
put("device_platform", "Android ${android.os.Build.VERSION.RELEASE}")
put("client_surface", "android")
put("device_form_factor", "phone")
}
private fun relayDeviceName(): String {
val configured = runCatching {
Settings.Global.getString(context.contentResolver, "device_name")
}.getOrNull()?.trim().orEmpty()
return configured.ifBlank {
android.os.Build.MODEL.orEmpty().ifBlank { "Android device" }
}
}
/**
* Send auth envelope when connection is established.
*
@@ -784,7 +805,7 @@ class AuthManager(
put("refresh_token", refreshToken)
}
put("device_id", deviceId)
put("device_name", android.os.Build.MODEL)
putRelayDeviceIdentity()
putRelayClientSupports()
}
}
@@ -800,7 +821,7 @@ class AuthManager(
buildJsonObject {
put("pairing_code", codeToSend)
put("device_id", deviceId)
put("device_name", android.os.Build.MODEL)
putRelayDeviceIdentity()
putRelayClientSupports()
pendingTtlSeconds?.let { put("ttl_seconds", it) }
pendingGrants?.let { grants ->
@@ -1066,7 +1087,7 @@ class AuthManager(
val paired = PairedSession(
token = token,
deviceName = android.os.Build.MODEL,
deviceName = relayDeviceName(),
expiresAt = expiresAt,
grants = grantsMap,
transportHint = transportHint,
@@ -74,6 +74,14 @@ data class PairedDeviceInfo(
val deviceName: String = "",
@SerialName("device_id")
val deviceId: String = "",
@SerialName("device_model")
val deviceModel: String = "",
@SerialName("device_platform")
val devicePlatform: String = "",
@SerialName("client_surface")
val clientSurface: String = "",
@SerialName("device_form_factor")
val deviceFormFactor: String = "",
@SerialName("created_at")
val createdAt: Double? = null,
@SerialName("last_seen")
@@ -3,10 +3,10 @@ package com.hermesandroid.relay.data
/**
* Shared profile/personality display and request identity helpers.
*
* A null profile name is the app's explicit "Server default" state. The
* relay also advertises the root Hermes config as a synthetic profile named
* "default"; for request/session identity that row is an alias of server
* default so it does not split chat, voice, or session scope.
* A null profile name is the app's explicit "Server default" state. It is
* intentionally distinct from a real profile whose name is literally
* `default`: the former follows the server's sticky default, while the latter
* explicitly addresses the root profile.
*/
object AgentDisplay {
const val SERVER_DEFAULT_PROFILE_KEY: String = "__server_default__"
@@ -16,17 +16,16 @@ object AgentDisplay {
"hermes agent",
)
// Only an EXPLICIT pick drives request/session identity. The advertised
// "default" profile is an alias for server default, so falling back to it
// here would split chat, voice, or session scope.
// Only an explicit pick drives request identity. Server default is the null
// selection; a named `default` profile is an ordinary explicit pick.
@Suppress("UNUSED_PARAMETER")
fun effectiveProfile(
selectedProfile: Profile?,
profiles: List<Profile>,
): Profile? = selectedProfile
// Display can use the synthetic default profile's metadata without making
// it a request/session override. Verbose SOUL summaries are filtered by
// Display can use the root default profile's metadata without making it a
// request/session override. Verbose SOUL summaries are filtered by
// profileDisplayName below, so this is safe for headers/cards.
fun effectiveDisplayProfile(
selectedProfile: Profile?,
@@ -39,7 +38,7 @@ object AgentDisplay {
?.let { activeName ->
profiles.firstOrNull { it.name.equals(activeName, ignoreCase = true) }
}
?: profiles.firstOrNull { isServerDefaultAlias(it.name) }
?: profiles.firstOrNull { it.name.equals("default", ignoreCase = true) }
}
// The NAME goes in the name slot. Non-default profiles use their profile
@@ -48,7 +47,7 @@ object AgentDisplay {
// verbose SOUL summary.
fun profileDisplayName(profile: Profile?): String? {
if (profile == null) return null
if (isServerDefaultAlias(profile.name)) {
if (profile.name.equals("default", ignoreCase = true)) {
return defaultProfileDisplayName(profile)
}
return when {
@@ -135,22 +134,18 @@ object AgentDisplay {
?.takeIf { it.isNotEmpty() }
?.takeUnless { it.lowercase() in GENERIC_MODEL_ALIASES }
fun isServerDefaultAlias(profileName: String?): Boolean =
profileName?.trim()?.equals("default", ignoreCase = true) == true
fun normalizeSelection(profile: Profile?): Profile? =
if (isServerDefaultAlias(profile?.name)) null else profile
fun normalizeSelection(profile: Profile?): Profile? = profile
fun profileRequestName(profileName: String?): String? =
profileName
?.trim()
?.takeIf { it.isNotEmpty() && !isServerDefaultAlias(it) }
?.takeIf { it.isNotEmpty() && it != SERVER_DEFAULT_PROFILE_KEY }
/**
* The profile name that owns chat sessions for the current UI selection.
*
* [selectedProfileName] is null (or the synthetic `default` alias) for the
* "Server default" row. That UI sentinel must remain distinct from the
* [selectedProfileName] is null for the "Server default" row. That UI
* sentinel must remain distinct from the
* server's sticky active profile: a dashboard launched under the root home
* may still report `active=victor`, in which case upstream Gateway and
* dashboard session calls must explicitly target `victor`. The resolved
@@ -0,0 +1,147 @@
package com.hermesandroid.relay.data
import kotlinx.coroutines.flow.Flow
import kotlinx.coroutines.flow.MutableStateFlow
import kotlinx.coroutines.flow.distinctUntilChanged
import kotlinx.coroutines.flow.map
/**
* Immutable owner of one composer draft.
*
* Callers must supply stable ids rather than display labels. [sessionId] may be
* a server id or a stable client-generated id for a not-yet-created session.
* [draftId] separates the primary composer from any future named draft slot.
*/
data class ChatComposerDraftKey(
val connectionId: String,
val profileId: String,
val sessionId: String,
val draftId: String = PRIMARY_DRAFT_ID,
) {
init {
require(connectionId.isNotBlank()) { "connectionId must not be blank" }
require(profileId.isNotBlank()) { "profileId must not be blank" }
require(sessionId.isNotBlank()) { "sessionId must not be blank" }
require(draftId.isNotBlank()) { "draftId must not be blank" }
}
companion object {
const val PRIMARY_DRAFT_ID = "primary"
const val DEFAULT_PROFILE_ID = "default"
}
}
/** Message references associated with composer content. */
data class ChatComposerDraftContext(
val quotedMessageId: String? = null,
val editingMessageId: String? = null,
) {
internal fun normalized(): ChatComposerDraftContext = copy(
quotedMessageId = quotedMessageId?.takeIf(String::isNotBlank),
editingMessageId = editingMessageId?.takeIf(String::isNotBlank),
)
}
/**
* Complete restorable state for one composer.
*
* Selection offsets use the same start-inclusive/end-exclusive convention as
* Compose text fields. The store clamps them whenever the text changes so a
* restored selection can never address outside the restored string.
*/
data class ChatComposerDraft(
val text: String = "",
val selectionStart: Int = text.length,
val selectionEnd: Int = selectionStart,
val context: ChatComposerDraftContext = ChatComposerDraftContext(),
val attachments: List<Attachment> = emptyList(),
) {
val isEmpty: Boolean
get() = text.isEmpty() &&
context.quotedMessageId == null &&
context.editingMessageId == null &&
attachments.isEmpty()
internal fun normalized(): ChatComposerDraft {
val normalizedStart = selectionStart.coerceIn(0, text.length)
val normalizedEnd = selectionEnd.coerceIn(0, text.length)
return copy(
selectionStart = minOf(normalizedStart, normalizedEnd),
selectionEnd = maxOf(normalizedStart, normalizedEnd),
context = context.normalized(),
attachments = attachments.toList(),
)
}
}
/**
* Session-owned composer state.
*
* This store is deliberately memory-only: outbound [Attachment.content] can
* contain large Base64 payloads and must not enter Preferences DataStore. Keep
* one instance in the chat owner (normally its ViewModel) so drafts survive
* navigation and Activity recreation. Process death starts with empty drafts;
* a future durable implementation should persist URI grants, not attachment
* bytes.
*/
interface ChatComposerDraftStore {
fun observe(key: ChatComposerDraftKey): Flow<ChatComposerDraft>
fun snapshot(key: ChatComposerDraftKey): ChatComposerDraft
fun save(key: ChatComposerDraftKey, draft: ChatComposerDraft)
fun update(
key: ChatComposerDraftKey,
transform: (ChatComposerDraft) -> ChatComposerDraft,
)
fun remove(key: ChatComposerDraftKey)
fun removeSession(connectionId: String, profileId: String, sessionId: String)
fun clear()
}
class InMemoryChatComposerDraftStore : ChatComposerDraftStore {
private val drafts = MutableStateFlow<Map<ChatComposerDraftKey, ChatComposerDraft>>(emptyMap())
override fun observe(key: ChatComposerDraftKey): Flow<ChatComposerDraft> =
drafts
.map { it[key] ?: ChatComposerDraft() }
.distinctUntilChanged()
override fun snapshot(key: ChatComposerDraftKey): ChatComposerDraft =
drafts.value[key] ?: ChatComposerDraft()
@Synchronized
override fun save(key: ChatComposerDraftKey, draft: ChatComposerDraft) {
val normalized = draft.normalized()
drafts.value = if (normalized.isEmpty) {
drafts.value - key
} else {
drafts.value + (key to normalized)
}
}
@Synchronized
override fun update(
key: ChatComposerDraftKey,
transform: (ChatComposerDraft) -> ChatComposerDraft,
) {
save(key, transform(snapshot(key)))
}
@Synchronized
override fun remove(key: ChatComposerDraftKey) {
drafts.value = drafts.value - key
}
@Synchronized
override fun removeSession(connectionId: String, profileId: String, sessionId: String) {
drafts.value = drafts.value.filterKeys { key ->
key.connectionId != connectionId ||
key.profileId != profileId ||
key.sessionId != sessionId
}
}
@Synchronized
override fun clear() {
drafts.value = emptyMap()
}
}
@@ -0,0 +1,48 @@
package com.hermesandroid.relay.data
import android.content.Context
import androidx.datastore.core.DataStore
import androidx.datastore.preferences.core.Preferences
import androidx.datastore.preferences.core.edit
import androidx.datastore.preferences.core.stringPreferencesKey
import kotlinx.coroutines.flow.Flow
import kotlinx.coroutines.flow.distinctUntilChanged
import kotlinx.coroutines.flow.map
/** Phone-local behavior for a physical keyboard's unmodified Enter key. */
enum class PhysicalKeyboardEnterBehavior(val storedValue: String) {
SendMessage("send_message"),
InsertNewline("insert_newline"),
;
companion object {
fun fromStoredValue(value: String?): PhysicalKeyboardEnterBehavior =
entries.firstOrNull { it.storedValue == value } ?: SendMessage
}
}
/** Device-level chat input preferences shared by every Hermes profile. */
class ChatInputPreferencesRepository(
private val dataStore: DataStore<Preferences>,
) {
constructor(context: Context) : this(context.relayDataStore)
companion object {
internal val KEY_PHYSICAL_KEYBOARD_ENTER =
stringPreferencesKey("physical_keyboard_enter_behavior")
}
val physicalKeyboardEnterBehavior: Flow<PhysicalKeyboardEnterBehavior> = dataStore.data
.map { preferences ->
PhysicalKeyboardEnterBehavior.fromStoredValue(
preferences[KEY_PHYSICAL_KEYBOARD_ENTER],
)
}
.distinctUntilChanged()
suspend fun setPhysicalKeyboardEnterBehavior(behavior: PhysicalKeyboardEnterBehavior) {
dataStore.edit { preferences ->
preferences[KEY_PHYSICAL_KEYBOARD_ENTER] = behavior.storedValue
}
}
}
@@ -112,12 +112,11 @@ data class ChatMessage(
*/
val clientOnly: Boolean = false,
/**
* Delivery state for a message the user sends into an agent **Thread** over
* the relay proactive channel ([com.hermesandroid.relay.viewmodel.ChatViewModel]
* routes `source=phone` sessions here instead of the normal chat send).
* `SENDING` until the relay acks (`proactive.reply.ack`) → `DELIVERED`;
* `FAILED` on a send error. Null for ordinary chat messages — those render
* no status affix.
* Delivery state for a user-authored message. Agent **Thread** replies use
* `SENDING` until the relay acks (`proactive.reply.ack`) → `DELIVERED`,
* with `FAILED` on a send error. Ordinary chat may additionally use
* `QUEUED` and `STEERED` to make active-turn routing visible. Null keeps the
* legacy behavior of rendering no status affix.
*/
val deliveryStatus: MessageDeliveryStatus? = null,
/**
@@ -367,6 +366,8 @@ data class ToolCall(
* header can render without a separate lane registry.
*/
val taskLabel: String? = null,
/** Live upstream child id used by subagent.steer while this lane runs. */
val subagentId: String? = null,
/** Deterministic non-low output risk reported by upstream for this call. */
val outputRisk: String? = null,
/** Human-readable deterministic findings; rendered as untrusted metadata. */
@@ -388,15 +389,17 @@ enum class MessageRole {
}
/**
* Delivery state of a user reply sent into an agent Thread over the relay
* proactive channel. Only set on Thread replies; ordinary chat messages leave
* it null and show no status affix.
* Delivery state of a user-authored message. Thread replies use the relay ack
* lifecycle; ordinary chat can additionally expose queue and steer outcomes.
* Null preserves the legacy behavior of rendering no status affix.
*
* - [SENDING] handed to the relay; awaiting the per-reply ack.
* - [QUEUED] held client-side until the active turn completes.
* - [STEERED] accepted as a correction to the active turn.
* - [DELIVERED] the relay acked (`proactive.reply.ack`) — buffered for the agent.
* - [FAILED] the send errored (e.g. relay disconnected).
*/
enum class MessageDeliveryStatus { SENDING, DELIVERED, FAILED }
enum class MessageDeliveryStatus { SENDING, QUEUED, STEERED, DELIVERED, FAILED }
data class ChatSession(
val sessionId: String,
@@ -0,0 +1,66 @@
package com.hermesandroid.relay.data
import java.nio.charset.StandardCharsets
import java.util.Base64
/** Structured identity and preview for a quoted chat message. */
data class ChatQuoteReference(
val messageId: String,
val authorLabel: String,
val excerpt: String,
)
/** Parsed transport envelope: Android renders [reference] separately from [body]. */
data class ChatQuoteEnvelope(
val reference: ChatQuoteReference,
val body: String,
)
/**
* Serialize a structured quote as ordinary Markdown for unmodified Hermes clients.
* Android parses the same envelope back into a quote chip, while Desktop/TUI see
* a readable linked attribution instead of an Android-only marker.
*/
fun buildChatQuotedPrompt(body: String, reference: ChatQuoteReference?): String {
if (reference == null) return body
val encodedId = Base64.getUrlEncoder().withoutPadding().encodeToString(
reference.messageId.toByteArray(StandardCharsets.UTF_8),
)
val author = reference.authorLabel.normalizedQuoteText(MAX_AUTHOR_CHARS)
val excerpt = reference.excerpt.normalizedQuoteText(MAX_EXCERPT_CHARS)
if (encodedId.isBlank() || author.isBlank() || excerpt.isBlank()) return body
return "> **Replying to [@$author](hermes-message://$encodedId):** $excerpt\n\n$body"
}
/** Parse only the exact bounded envelope emitted by [buildChatQuotedPrompt]. */
fun parseChatQuotedPrompt(content: String): ChatQuoteEnvelope? {
val match = QUOTE_ENVELOPE.matchEntire(content) ?: return null
val author = match.groupValues[1]
val encodedId = match.groupValues[2]
val excerpt = match.groupValues[3]
val body = match.groupValues[4]
val messageId = runCatching {
String(Base64.getUrlDecoder().decode(encodedId), StandardCharsets.UTF_8)
}.getOrNull()?.takeIf { it.isNotBlank() && it.length <= MAX_MESSAGE_ID_CHARS } ?: return null
return ChatQuoteEnvelope(
reference = ChatQuoteReference(messageId, author, excerpt),
body = body,
)
}
private fun String.normalizedQuoteText(maxChars: Int): String =
replace(Regex("[\\p{Cc}\\s]+"), " ")
.replace("\\", "")
.replace("]", "")
.trim()
.take(maxChars)
private val QUOTE_ENVELOPE = Regex(
pattern = "^> \\*\\*Replying to \\[@([^]\\r\\n]{1,$MAX_AUTHOR_CHARS})]" +
"\\(hermes-message://([A-Za-z0-9_-]{1,512})\\):\\*\\* " +
"([^\\r\\n]{1,$MAX_EXCERPT_CHARS})\\n\\n([\\s\\S]*)$",
)
private const val MAX_AUTHOR_CHARS = 40
private const val MAX_EXCERPT_CHARS = 240
private const val MAX_MESSAGE_ID_CHARS = 512
@@ -26,7 +26,6 @@ object ProfilePresentationPolicy {
fun availableKeys(profiles: List<Profile>): List<String> = buildList {
add(AgentDisplay.SERVER_DEFAULT_PROFILE_KEY)
profiles.asSequence()
.filterNot { AgentDisplay.isServerDefaultAlias(it.name) }
.map(Profile::name)
.distinct()
.forEach(::add)
@@ -49,6 +48,12 @@ object ProfilePresentationPolicy {
): List<String> = orderedKeys(profiles, presentation).filter { key ->
key == selectedKey || key !in presentation.hidden
}
fun shouldShowShelf(
profiles: List<Profile>,
presentation: ProfilePresentation,
selectedKey: String,
): Boolean = visibleKeys(profiles, presentation, selectedKey).size > 1
}
class ProfilePresentationStore(
@@ -19,6 +19,7 @@ import com.hermesandroid.relay.diagnostics.NetworkDiagnosticGuidance
import com.hermesandroid.relay.network.relay.models.Envelope
import com.hermesandroid.relay.network.shared.EndpointResolver
import com.hermesandroid.relay.network.shared.EndpointSurface
import com.hermesandroid.relay.network.shared.fullJitterDelayMs
import com.hermesandroid.relay.network.shutdownOffMainThread
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
@@ -139,6 +140,8 @@ class ConnectionManager(
* non-null — the manager falls back to the single-URL path.
*/
private val deviceIdProvider: (suspend () -> String?)? = null,
/** Random source for ordinary reconnect full-jitter; exact backoffs never use it. */
private val reconnectJitterUnit: () -> Double = { kotlin.random.Random.nextDouble() },
) {
private val supervisorJob = SupervisorJob()
private val scope = CoroutineScope(supervisorJob + Dispatchers.IO)
@@ -1213,8 +1216,9 @@ class ConnectionManager(
SLOW_POLL_BACKOFF_MS
}
else -> {
val ms = (BASE_BACKOFF_MS * (1L shl minOf(reconnectAttempt - 1, 4)))
val capMs = (BASE_BACKOFF_MS * (1L shl minOf(reconnectAttempt - 1, 4)))
.coerceAtMost(MAX_BACKOFF_MS)
val ms = fullJitterDelayMs(capMs, reconnectJitterUnit())
DiagnosticsLog.record(
category = DiagnosticCategory.Relay,
severity = DiagnosticSeverity.Info,
@@ -0,0 +1,13 @@
package com.hermesandroid.relay.network.shared
import kotlin.random.Random
/** Full-jitter retry delay in the inclusive range 0..[capMs]. */
internal fun fullJitterDelayMs(
capMs: Long,
unit: Double = Random.nextDouble(),
): Long {
if (capMs <= 0L) return 0L
val boundedUnit = unit.coerceIn(0.0, Math.nextDown(1.0))
return (boundedUnit * (capMs + 1.0)).toLong().coerceAtMost(capMs)
}
@@ -90,12 +90,9 @@ class ChatHandler {
// Fallback form (no relay): `MEDIA:/absolute/path` — relay wasn't
// reachable when the tool fired, so we render an "unavailable"
// placeholder instead of attempting a fetch.
private val mediaRelayRegex = Regex("""MEDIA:hermes-relay://([A-Za-z0-9_-]+)""")
// `/.+?` (not `/\S+`) so absolute paths containing spaces — e.g.
// `MEDIA:/mnt/media/Coralee Adshade/undressher.jpg` — still match. The
// trailing `\s*$` trims any trailing whitespace; non-greedy keeps the
// capture to the path. OkHttp re-encodes the space for /media/by-path.
private val mediaBarePathRegex = Regex("""^\s*MEDIA:(/.+?)\s*$""")
private val mediaRelayPayloadRegex = Regex("""^hermes-relay://([A-Za-z0-9_-]+)$""")
private val mediaMarkerPrefixRegex = Regex("MEDIA:")
private val windowsAbsoluteMediaPathRegex = Regex("""^[A-Za-z]:[\\/].+""")
// Rich card marker — single line, full JSON object payload.
//
// Agents emit:
@@ -188,6 +185,7 @@ class ChatHandler {
* post-stream finalize reconciliation pass.
*/
private var mediaLineBuffer = StringBuilder()
private var mediaFenceDelimiter: String? = null
private val dispatchedMediaMarkers = mutableSetOf<String>()
/**
@@ -1176,12 +1174,14 @@ class ChatHandler {
// Drop any pending line buffers / dedupe state so a fresh session
// doesn't inherit leftovers from the previous one.
mediaLineBuffer.clear()
mediaFenceDelimiter = null
dispatchedMediaMarkers.clear()
annotationLineBuffer.clear()
activeAnnotationTools.clear()
cardLineBuffer.clear()
dispatchedCardMarkers.clear()
subagentLabels.clear()
subagentIds.clear()
}
/**
@@ -1771,7 +1771,7 @@ class ChatHandler {
for (line in text.lines()) {
val t = line.trim()
if (t.isEmpty()) continue
if (mediaRelayRegex.containsMatchIn(t) || mediaBarePathRegex.containsMatchIn(t)) continue
if (parseMediaMarkerLine(t).isNotEmpty()) continue
if (PersistedImageReferenceParser.parse(t).paths.isNotEmpty()) continue
if (cardMarkerRegex.containsMatchIn(t)) continue
if (sb.isNotEmpty()) sb.append('\n')
@@ -1788,6 +1788,51 @@ class ChatHandler {
data class BarePath(val path: String) : MediaMarkerHit
}
/**
* Parse one marker-only line using upstream-compatible wrappers and
* boundaries. Prose and malformed examples remain ordinary text; a whole
* inline-code or emphasis wrapper is accepted, as are adjacent markers,
* sentence-final punctuation, POSIX paths, and Windows absolute paths.
*/
private fun parseMediaMarkerLine(line: String): List<MediaMarkerHit> {
val trimmed = line.trim()
if (trimmed.isEmpty() || trimmed.startsWith("```") || trimmed.startsWith("~~~")) {
return emptyList()
}
val starts = mediaMarkerPrefixRegex.findAll(trimmed).map { it.range.first }.toList()
if (starts.isEmpty()) return emptyList()
val prefix = trimmed.substring(0, starts.first())
if (prefix.any { !it.isWhitespace() && it !in "`*_~" }) return emptyList()
val hits = ArrayList<MediaMarkerHit>(starts.size)
for ((index, start) in starts.withIndex()) {
val payloadStart = start + "MEDIA:".length
val payloadEnd = starts.getOrNull(index + 1) ?: trimmed.length
val payload = trimmed.substring(payloadStart, payloadEnd)
.trim()
.trimEnd { it in "`*_~.,;:)}]" }
.trim()
if (payload.isEmpty()) return emptyList()
val relay = mediaRelayPayloadRegex.matchEntire(payload)
when {
relay != null -> hits += MediaMarkerHit.RelayToken(relay.groupValues[1])
payload.startsWith("/") || windowsAbsoluteMediaPathRegex.matches(payload) ->
hits += MediaMarkerHit.BarePath(payload)
else -> return emptyList()
}
}
return hits
}
private fun fenceDelimiter(line: String): String? {
val trimmed = line.trimStart()
return when {
trimmed.startsWith("```") -> "```"
trimmed.startsWith("~~~") -> "~~~"
else -> null
}
}
/**
* Scan loaded (non-streaming) message content line-by-line for media
* markers, append hits to [out], and return the content with matched
@@ -1800,24 +1845,20 @@ class ChatHandler {
out: MutableList<Pair<String, MediaMarkerHit>>,
): String {
var cleaned = content
var openFence: String? = null
for (rawLine in content.lines()) {
val trimmed = rawLine.trim()
if (trimmed.isEmpty()) continue
val relayMatch = mediaRelayRegex.find(trimmed)
if (relayMatch != null) {
out.add(messageId to MediaMarkerHit.RelayToken(relayMatch.groupValues[1]))
cleaned = cleaned
.replace("\n$rawLine\n", "\n")
.replace("\n$rawLine", "")
.replace("$rawLine\n", "")
.replace(rawLine, "")
val delimiter = fenceDelimiter(rawLine)
if (delimiter != null) {
openFence = if (openFence == delimiter) null else if (openFence == null) delimiter else openFence
continue
}
if (openFence != null) continue
val bareMatch = mediaBarePathRegex.find(trimmed)
if (bareMatch != null) {
out.add(messageId to MediaMarkerHit.BarePath(bareMatch.groupValues[1]))
val hits = parseMediaMarkerLine(trimmed)
if (hits.isNotEmpty()) {
hits.forEach { out.add(messageId to it) }
cleaned = cleaned
.replace("\n$rawLine\n", "\n")
.replace("\n$rawLine", "")
@@ -1909,6 +1950,37 @@ class ChatHandler {
}
}
/**
* Returns true when structured session history contains tool lifecycle
* state that the live transcript did not receive. This is a read-only
* preflight for Gateway completion reconciliation: healthy live turns keep
* their current StateFlow list and UI identity, while omitted upstream
* tool events opt into [loadMessageHistory]. Assistant prose is never
* inspected or interpreted here.
*/
fun hasMissingPersistedToolActivity(items: List<MessageItem>): Boolean {
val toolResults = items.filter { it.role == "tool" }
.associateBy { it.toolCallId }
val persistedCalls = coalesceRenderedHistoryItems(items)
.asSequence()
.filter { it.role == "assistant" }
.flatMap { parseToolCallsFromHistory(it.toolCalls, toolResults).asSequence() }
.toList()
if (persistedCalls.isEmpty()) return false
val localCalls = _messages.value.flatMap { it.toolCalls }
return persistedCalls.any { persisted ->
val local = persisted.id?.let { id -> localCalls.firstOrNull { it.id == id } }
?: localCalls.firstOrNull {
it.id == null && it.name == persisted.name && it.args == persisted.args
}
local == null ||
(persisted.isComplete && !local.isComplete) ||
(persisted.result != null && persisted.result != local.result) ||
(persisted.success != null && persisted.success != local.success)
}
}
// --- Session management ---
fun setSessionId(sessionId: String?) {
@@ -2234,6 +2306,18 @@ class ChatHandler {
val trimmed = line.trim()
if (trimmed.isEmpty()) continue
fenceDelimiter(line)?.let { delimiter ->
mediaFenceDelimiter = if (mediaFenceDelimiter == delimiter) {
null
} else if (mediaFenceDelimiter == null) {
delimiter
} else {
mediaFenceDelimiter
}
continue
}
if (mediaFenceDelimiter != null) continue
if (tryDispatchMediaMarker(messageId, trimmed)) {
stripLineFromContent(messageId, trimmed)
}
@@ -2363,29 +2447,26 @@ class ChatHandler {
* Returns true when a marker was matched so the caller can strip the line.
*/
private fun tryDispatchMediaMarker(messageId: String, line: String): Boolean {
val relayMatch = mediaRelayRegex.find(line)
if (relayMatch != null) {
val token = relayMatch.groupValues[1]
val dedupeKey = "$messageId:relay:$token"
if (dispatchedMediaMarkers.add(dedupeKey)) {
Log.d(TAG, "Media marker (relay): token=$token")
onMediaAttachmentRequested(messageId, token)
val hits = parseMediaMarkerLine(line)
for (hit in hits) {
when (hit) {
is MediaMarkerHit.RelayToken -> {
val dedupeKey = "$messageId:relay:${hit.token}"
if (dispatchedMediaMarkers.add(dedupeKey)) {
Log.d(TAG, "Media marker (relay): token=${hit.token}")
onMediaAttachmentRequested(messageId, hit.token)
}
}
is MediaMarkerHit.BarePath -> {
val dedupeKey = "$messageId:bare:${hit.path}"
if (dispatchedMediaMarkers.add(dedupeKey)) {
Log.d(TAG, "Media marker (bare-path): ${hit.path}")
onMediaBarePathRequested(messageId, hit.path)
}
}
}
return true
}
val bareMatch = mediaBarePathRegex.find(line)
if (bareMatch != null) {
val path = bareMatch.groupValues[1]
val dedupeKey = "$messageId:bare:$path"
if (dispatchedMediaMarkers.add(dedupeKey)) {
Log.d(TAG, "Media marker (bare-path, unavailable): $path")
onMediaBarePathRequested(messageId, path)
}
return true
}
return false
return hits.isNotEmpty()
}
/**
@@ -2524,10 +2605,11 @@ class ChatHandler {
if (mediaLineBuffer.isNotEmpty()) {
val remaining = mediaLineBuffer.toString().trim()
mediaLineBuffer.clear()
if (remaining.isNotEmpty() && tryDispatchMediaMarker(messageId, remaining)) {
if (mediaFenceDelimiter == null && remaining.isNotEmpty() && tryDispatchMediaMarker(messageId, remaining)) {
stripLineFromContent(messageId, remaining)
}
}
mediaFenceDelimiter = null
// Post-stream reconciliation: re-scan the final content for markers
// that raced with stripLineFromContent during streaming.
@@ -2536,12 +2618,16 @@ class ChatHandler {
if (!msg.matchesIdentity(messageId) || msg.role != MessageRole.ASSISTANT) return@map msg
var cleaned = msg.content
var changed = false
var openFence: String? = null
for (rawLine in msg.content.lines()) {
val trimmed = rawLine.trim()
if (trimmed.isEmpty()) continue
if (mediaRelayRegex.containsMatchIn(trimmed) ||
mediaBarePathRegex.containsMatchIn(trimmed)
) {
val delimiter = fenceDelimiter(rawLine)
if (delimiter != null) {
openFence = if (openFence == delimiter) null else if (openFence == null) delimiter else openFence
continue
}
if (openFence == null && parseMediaMarkerLine(trimmed).isNotEmpty()) {
tryDispatchMediaMarker(messageId, trimmed)
cleaned = cleaned
.replace("\n$rawLine\n", "\n")
@@ -2872,6 +2958,7 @@ class ChatHandler {
* [onStreamComplete] / [clearMessages].
*/
private val subagentLabels = mutableMapOf<Int, String>()
private val subagentIds = mutableMapOf<Int, String>()
/**
* Apply one gateway `subagent.*` lifecycle event to the streaming
@@ -2887,6 +2974,9 @@ class ChatHandler {
when (event.phase) {
GatewaySubagentEvent.Phase.START -> {
if (label != null) subagentLabels[event.taskIndex] = label
event.subagentId?.takeIf(String::isNotBlank)?.let {
subagentIds[event.taskIndex] = it
}
}
GatewaySubagentEvent.Phase.TOOL -> {
@@ -2901,6 +2991,8 @@ class ChatHandler {
isComplete = false,
taskIndex = event.taskIndex,
taskLabel = laneLabel,
subagentId = event.subagentId?.takeIf(String::isNotBlank)
?: subagentIds[event.taskIndex],
)
_messages.update { messages ->
val target = messages.findLast {
@@ -2940,6 +3032,7 @@ class ChatHandler {
// "interrupted" lanes never finished — not a success either.
val failed = event.status == "failed" || event.status == "interrupted"
val laneLabel = subagentLabels.remove(event.taskIndex) ?: label
val subagentId = subagentIds.remove(event.taskIndex) ?: event.subagentId
val summaryId = "subagent-${event.taskIndex}-${syntheticToolSeq++}"
_messages.update { messages ->
messages.map { msg ->
@@ -2972,6 +3065,7 @@ class ChatHandler {
completedAt = System.currentTimeMillis(),
taskIndex = event.taskIndex,
taskLabel = laneLabel,
subagentId = subagentId,
)
}
msg.copy(toolCalls = withSummary)
@@ -3229,6 +3323,7 @@ class ChatHandler {
}
}
subagentLabels.clear()
subagentIds.clear()
}
fun onStreamError(message: String) {
@@ -3258,6 +3353,7 @@ class ChatHandler {
}
}
subagentLabels.clear()
subagentIds.clear()
}
fun onThinkingDelta(messageId: String, delta: String) {
@@ -500,6 +500,7 @@ class DashboardApiClient(
name: String,
cloneFromDefault: Boolean = true,
description: String? = null,
mcpServers: List<String> = emptyList(),
): Result<JsonObject> =
postJsonObject(
path = "/api/profiles",
@@ -507,9 +508,16 @@ class DashboardApiClient(
put("name", name)
put("clone_from_default", cloneFromDefault)
if (!description.isNullOrBlank()) put("description", description)
if (mcpServers.isNotEmpty()) {
put("mcp_servers", JsonArray(mcpServers.map(::JsonPrimitive)))
}
},
)
/** Create a host-owned Hermes backup, distinct from Android settings export. */
suspend fun createServerBackup(): Result<JsonObject> =
postJsonObject("/api/ops/backup")
suspend fun setProfileDescription(name: String, description: String): Result<JsonObject> =
putJsonObject(
path = "/api/profiles/${pathSegment(name)}/description",
@@ -605,15 +613,16 @@ class DashboardApiClient(
)
}
suspend fun getCustomEndpoints(): Result<DashboardCustomEndpoints> =
getJsonObject("/api/providers/custom-endpoints")
suspend fun getCustomEndpoints(profile: String? = null): Result<DashboardCustomEndpoints> =
getJsonObject("/api/providers/custom-endpoints${profileQuery(profile)}")
.mapCatching(::parseCustomEndpoints)
suspend fun saveCustomEndpoint(
draft: DashboardCustomEndpointDraft,
profile: String? = null,
): Result<DashboardCustomEndpoints> =
postJsonObject(
"/api/providers/custom-endpoints",
"/api/providers/custom-endpoints${profileQuery(profile)}",
customEndpointPayload(draft),
).mapCatching(::parseCustomEndpoints)
@@ -634,13 +643,19 @@ class DashboardApiClient(
suspend fun activateCustomEndpoint(
id: String,
profile: String? = null,
): Result<JsonObject> =
postJsonObject("/api/providers/custom-endpoints/${pathSegment(id)}/activate")
postJsonObject(
"/api/providers/custom-endpoints/${pathSegment(id)}/activate${profileQuery(profile)}",
)
suspend fun deleteCustomEndpoint(
id: String,
profile: String? = null,
): Result<DashboardCustomEndpoints> =
deleteJsonObject("/api/providers/custom-endpoints/${pathSegment(id)}")
deleteJsonObject(
"/api/providers/custom-endpoints/${pathSegment(id)}${profileQuery(profile)}",
)
.mapCatching(::parseCustomEndpoints)
suspend fun installMcpCatalogEntry(
@@ -752,6 +767,27 @@ class DashboardApiClient(
Result.success(sessions.values.take(limit.coerceIn(1, SESSION_LIST_WINDOW_LIMIT)))
}
/**
* Read the bounded, authoritative session window across every profile.
* Every usable row must retain its owning profile; rows without one are
* skipped rather than risking a cross-profile transcript or mutation.
*/
suspend fun listAllProfileSessions(
limit: Int = SESSION_LIST_WINDOW_LIMIT,
): Result<List<SessionItem>> = withContext(Dispatchers.IO) {
val boundedLimit = limit.coerceIn(1, SESSION_LIST_WINDOW_LIMIT)
getJson(
"/api/profiles/sessions?limit=$boundedLimit&offset=0&order=recent" +
"&min_messages=1&archived=include&profile=all",
).mapCatching { root ->
val parsed = json.decodeFromJsonElement(SessionListResponse.serializer(), root)
(parsed.sessions ?: parsed.items ?: parsed.data ?: emptyList())
.filter { it.id.isNotBlank() && !it.profile.isNullOrBlank() }
.distinctBy { "${it.profile}:${it.id}" }
.take(boundedLimit)
}
}
/**
* A session's message history, scoped to its owning profile via the dashboard
* `GET /api/sessions/{id}/messages?profile=`. Required twin of [listSessions]:
@@ -763,12 +799,24 @@ class DashboardApiClient(
suspend fun getSessionMessages(
sessionId: String,
profile: String? = null,
mode: SessionMessageLoadMode = SessionMessageLoadMode.COMPLETE,
): Result<List<MessageItem>> = withContext(Dispatchers.IO) {
val name = profile?.trim().orEmpty()
val query = if (name.isNotBlank()) "?profile=${pathSegment(name)}" else ""
getJson("/api/sessions/${pathSegment(sessionId)}/messages$query").mapCatching { root ->
val parsed = json.decodeFromJsonElement(MessageListResponse.serializer(), root)
parsed.messages ?: parsed.data ?: parsed.items ?: emptyList()
loadSessionMessages(mode) { page ->
val query = buildList {
add("limit=${page.limit}")
add("offset=${page.offset}")
add("order=${page.order}")
if (name.isNotBlank()) add("profile=${pathSegment(name)}")
}.joinToString(prefix = "?", separator = "&")
getJson("/api/sessions/${pathSegment(sessionId)}/messages$query").mapCatching { root ->
val parsed = json.decodeFromJsonElement(MessageListResponse.serializer(), root)
SessionMessagePage(
messages = parsed.messages ?: parsed.data ?: parsed.items ?: emptyList(),
pagination = parsed.pagination,
payloadChars = root.toString().length,
)
}
}
}
@@ -18,10 +18,12 @@ import kotlinx.coroutines.launch
import kotlinx.coroutines.sync.Mutex
import kotlinx.coroutines.sync.withLock
import kotlinx.coroutines.withTimeout
import com.hermesandroid.relay.network.shared.fullJitterDelayMs
import kotlinx.coroutines.withTimeoutOrNull
import kotlinx.serialization.builtins.ListSerializer
import kotlinx.serialization.json.Json
import kotlinx.serialization.json.JsonArray
import kotlinx.serialization.json.JsonNull
import kotlinx.serialization.json.JsonObject
import kotlinx.serialization.json.JsonPrimitive
import kotlinx.serialization.json.booleanOrNull
@@ -86,6 +88,8 @@ class GatewayChatClient(
private val promptSubmitTimeoutMs: Long = PROMPT_SUBMIT_REQUEST_TIMEOUT_MS,
/** Test seam — idle-progress watchdog base. Production keeps [TURN_TIMEOUT_MS]. */
private val turnIdleTimeoutMs: Long = TURN_TIMEOUT_MS,
/** Random source for ordinary reconnect full-jitter. */
private val reconnectJitterUnit: () -> Double = { kotlin.random.Random.nextDouble() },
) {
/** Existing upstream rich-chat vocabulary; do not invent a Relay-only source. */
private val sessionSource = "webui"
@@ -562,7 +566,11 @@ class GatewayChatClient(
buildJsonObject {
put("session_id", liveSessionId ?: error("no live session"))
put("text", text)
truncateBeforeUserOrdinal?.let { put("truncate_before_user_ordinal", it) }
truncateBeforeUserOrdinal?.let { ordinal ->
put("truncate_before_user_ordinal", ordinal)
put("confirm_truncate", true)
if (ordinal == 0) put("confirm_empty_truncate", true)
}
if (queuedFollowUp) put("queued", true)
},
// Long-running RPC, not a generic 15s ack — see the
@@ -588,7 +596,7 @@ class GatewayChatClient(
if (activeTurn === turn) activeTurn = null
turn.disarmWatchdog()
val submitError = submitted.exceptionOrNull()
if ((submitError as? GatewayRpcException)?.code == ACTIVE_SESSION_CAP_REJECTION) {
if (submitError.isAuthoritativePromptSubmitRejection()) {
// Authoritative policy rejection: the gateway received
// the prompt and deliberately refused to create the
// first turn. Falling back to SSE would bypass the cap
@@ -597,7 +605,7 @@ class GatewayChatClient(
// through the normal failed-turn callback instead.
turn.tracer.done("submit-rejected")
turn.callbacks.onError(
submitError.message ?: "Hermes rejected the new session",
submitError?.message ?: "Hermes rejected the new session",
)
return@launch
}
@@ -1482,6 +1490,43 @@ class GatewayChatClient(
},
)
/**
* React to the newest message for a role without guessing a transcript row
* id. This follows the upstream gateway contract, which resolves the row
* atomically inside the active session. A null emoji removes the reaction.
*/
suspend fun reactToNewest(role: String, emoji: String?): Result<JsonObject> {
require(role == "user" || role == "assistant") { "unsupported reaction role" }
val sid = liveSessionId
?: return Result.failure(GatewayRpcException("no live session"))
return rpc(
"message.react",
buildJsonObject {
put("session_id", sid)
put("newest_role", role)
if (emoji == null) put("emoji", JsonNull) else put("emoji", emoji)
put("author", "user")
},
)
}
/** Redirect one running child agent without interrupting the parent turn. */
suspend fun steerSubagent(subagentId: String, text: String): Result<JsonObject> {
val sessionId = liveSessionId
?: return Result.failure(IllegalStateException("No live gateway session"))
if (subagentId.isBlank() || text.isBlank()) {
return Result.failure(IllegalArgumentException("Subagent and instruction are required"))
}
return rpc(
"subagent.steer",
buildJsonObject {
put("session_id", sessionId)
put("subagent_id", subagentId)
put("text", text.trim())
},
)
}
/** Fetch the session/global reasoning effort and display mode. */
suspend fun getReasoningSettings(): Result<GatewayReasoningSettings> {
if (webSocket == null || readySignal?.isCompleted != true) {
@@ -2090,6 +2135,42 @@ class GatewayChatClient(
return
}
// Upstream emits session.reclaimed process-wide, so it is identified
// by payload rather than params.session_id. Retire only an exact live
// runtime we own; preserve the durable id so the next send resumes it.
if (type == "session.reclaimed") {
val reclaimedLiveId = payload?.stringField("session_id")
val reclaimedStoredId = payload?.stringField("stored_session_id")
val reason = payload?.stringField("reason")
val supportedReason = reason in setOf("idle_timeout", "lru_evict", "ws_orphan_reap")
if (!reclaimedLiveId.isNullOrBlank() && supportedReason) {
val background = backgroundTurns.remove(reclaimedLiveId)
if (background != null) {
callbackDispatcher {
unmatchedTurnCompleteListener?.invoke(
GatewayBackgroundTurnCompletion(
storedSessionId = reclaimedStoredId?.takeIf(String::isNotBlank)
?: background.storedSessionId,
liveSessionId = reclaimedLiveId,
profile = background.profile,
expectedAssistantText = null,
),
)
}
}
if (reclaimedLiveId == liveSessionId) {
liveSessionId = null
reclaimedStoredId?.takeIf(String::isNotBlank)?.let { storedSessionId = it }
val turn = activeTurn
if (turn != null && !turn.ended) {
activeTurn = null
turn.failFromTransport("Gateway reclaimed the inactive session")
}
}
}
return
}
// read_terminal is a renderer query, not a user decision. Android has
// no xterm pane on the Gateway chat surface, so mirror upstream
// desktop's no-live-pane behavior and answer with empty text instead
@@ -2408,7 +2489,7 @@ class GatewayChatClient(
Log.i(TAG, "Gateway socket rejoined for ${backgroundTurns.size} detached turn(s)")
return
}
delay(backoffMs)
delay(fullJitterDelayMs(backoffMs, reconnectJitterUnit()))
backoffMs = (backoffMs * 2).coerceAtMost(5_000L)
}
}
@@ -2501,7 +2582,7 @@ class GatewayChatClient(
)
return
}
delay(backoffMs)
delay(fullJitterDelayMs(backoffMs, reconnectJitterUnit()))
backoffMs = (backoffMs * 2).coerceAtMost(5_000L)
}
if (activeTurn === turn) activeTurn = null
@@ -3084,7 +3165,13 @@ internal class GatewayConnectAttemptException(message: String) : Exception(messa
internal class GatewayRpcException(message: String, val code: Int? = null) : Exception(message)
private const val JSONRPC_METHOD_NOT_FOUND = -32601
private const val ACTIVE_SESSION_CAP_REJECTION = 4090
private val AUTHORITATIVE_PROMPT_SUBMIT_REJECTIONS = setOf(
4028, // first-turn truncate requires explicit empty-history confirmation
4029, // every destructive truncate requires explicit confirmation
4090, // active-session capacity policy
5070, // initial session persistence failed: storage full
5071, // other authoritative initial session persistence failure
)
private const val MAX_RECOVERED_CORRECTIONS = 32
private const val MAX_RECOVERED_CORRECTION_CHARS = 32_768
private const val PET_THUMB_DATA_PREFIX = "data:image/png;base64,"
@@ -3140,6 +3227,9 @@ private fun Throwable?.isMethodNotFound(): Boolean {
msg.contains("unknown method", ignoreCase = true)
}
private fun Throwable?.isAuthoritativePromptSubmitRejection(): Boolean =
(this as? GatewayRpcException)?.code in AUTHORITATIVE_PROMPT_SUBMIT_REJECTIONS
private fun Throwable?.isApprovalModeUnsupported(): Boolean {
val rpcError = this as? GatewayRpcException ?: return false
val message = rpcError.message.orEmpty()
@@ -207,7 +207,11 @@ class GatewayEventMapper(
}
else -> syntheticToolId(name)
}
val argsPreview = payload.string("args_text")
val argsPreview = payload?.get("args")
?.takeUnless { it is JsonPrimitive && it.contentOrNull.isNullOrBlank() }
?.toString()
?.takeIf { it.isNotBlank() && it != "null" }
?: payload.string("args_text")
?.takeIf { it.isNotBlank() }
?: payload.string("context")?.takeIf { it.isNotBlank() }
callbacks.onToolCallStart(toolId, name, argsPreview)
@@ -294,6 +298,7 @@ class GatewayEventMapper(
// text; thinking/progress carry text only.
preview = payload.string("tool_preview") ?: payload.string("text"),
durationSeconds = payload.double("duration_seconds"),
subagentId = payload.string("subagent_id"),
),
)
}
@@ -270,6 +270,7 @@ data class GatewaySubagentEvent(
val toolName: String? = null,
val preview: String? = null,
val durationSeconds: Double? = null,
val subagentId: String? = null,
) {
enum class Phase { START, THINKING, TOOL, PROGRESS, COMPLETE }
}
@@ -503,6 +504,21 @@ internal fun isCurrentModelOptionsResponse(
): Boolean =
requestGeneration == currentGeneration && requestProfileKey == currentProfileKey
/**
* Selects the identity a model-options response may publish into chat UI state.
* Catalog-only requests populate picker choices without changing session identity.
*/
internal fun modelOptionsIdentityToPublish(
catalogOnly: Boolean,
hasLiveSession: Boolean,
sessionIdentity: GatewayModelIdentity?,
options: GatewayModelOptions,
): GatewayModelIdentity? = when {
catalogOnly -> null
hasLiveSession && sessionIdentity != null -> sessionIdentity
else -> GatewayModelIdentity(options.currentModel, options.currentProvider)
}
/**
* The explicit in-chat overrides to bind onto a gateway `session.create` as the
* new session's PER-SESSION overrides. Matches the upstream desktop client,
@@ -19,6 +19,7 @@ import com.hermesandroid.relay.network.upstream.models.SkillListResponse
import com.hermesandroid.relay.network.upstream.models.UsageInfo
import com.hermesandroid.relay.util.TurnLatencyTracer
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.CancellationException
import kotlinx.coroutines.withContext
import kotlinx.serialization.encodeToString
import kotlinx.serialization.Serializable
@@ -713,19 +714,34 @@ class HermesApiClient(
}
}
suspend fun getMessages(sessionId: String): List<MessageItem> = withContext(Dispatchers.IO) {
try {
val request = authRequest("$baseUrl/api/sessions/$sessionId/messages")
.get()
.build()
client.newCall(request).execute().use { response ->
if (!response.isSuccessful) return@withContext emptyList()
val body = response.body?.string() ?: return@withContext emptyList()
val parsed = json.decodeFromString<MessageListResponse>(body)
parsed.data ?: parsed.items ?: parsed.messages ?: emptyList()
suspend fun getMessages(
sessionId: String,
mode: SessionMessageLoadMode = SessionMessageLoadMode.COMPLETE,
): List<MessageItem> = withContext(Dispatchers.IO) {
loadSessionMessages(mode) { page ->
runCatching {
val url = "$baseUrl/api/sessions/$sessionId/messages".toHttpUrlOrNull()
?.newBuilder()
?.addQueryParameter("limit", page.limit.toString())
?.addQueryParameter("offset", page.offset.toString())
?.addQueryParameter("order", page.order)
?.build()
?: error("invalid session messages URL")
val request = authRequest(url.toString()).get().build()
client.newCall(request).execute().use { response ->
if (!response.isSuccessful) error("HTTP ${response.code}")
val body = response.body?.string() ?: error("empty response body")
val parsed = json.decodeFromString<MessageListResponse>(body)
SessionMessagePage(
messages = parsed.data ?: parsed.items ?: parsed.messages ?: emptyList(),
pagination = parsed.pagination,
payloadChars = body.length,
)
}
}
} catch (e: Exception) {
Log.w(TAG, "Failed to get messages: ${e.message}")
}.getOrElse { error ->
if (error is CancellationException) throw error
Log.w(TAG, "Failed to get messages: ${error.message}")
emptyList()
}
}
@@ -0,0 +1,78 @@
package com.hermesandroid.relay.network.upstream
import com.hermesandroid.relay.network.upstream.models.MessageItem
import com.hermesandroid.relay.network.upstream.models.MessagePagination
import kotlinx.coroutines.CancellationException
/** Explicit transcript read intent for Hermes' bounded messages endpoint. */
enum class SessionMessageLoadMode {
/** One bounded newest-first window, returned in chronological order. */
LATEST,
/** Every page, oldest first, subject to Android memory safety bounds. */
COMPLETE,
}
internal const val SESSION_MESSAGE_PAGE_SIZE = 500
private const val MAX_COMPLETE_TRANSCRIPT_MESSAGES = 50_000
private const val MAX_COMPLETE_TRANSCRIPT_PAYLOAD_CHARS = 32_000_000
internal data class SessionMessagePageRequest(
val limit: Int = SESSION_MESSAGE_PAGE_SIZE,
val offset: Int = 0,
val order: String,
)
internal data class SessionMessagePage(
val messages: List<MessageItem>,
val pagination: MessagePagination?,
val payloadChars: Int,
)
internal class SessionTranscriptTooLargeException(message: String) : IllegalStateException(message)
/** Shared API-server/dashboard pagination contract. Legacy unpaginated envelopes remain valid. */
internal suspend fun loadSessionMessages(
mode: SessionMessageLoadMode,
fetchPage: suspend (SessionMessagePageRequest) -> Result<SessionMessagePage>,
): Result<List<MessageItem>> {
return try {
val order = if (mode == SessionMessageLoadMode.LATEST) "latest" else "oldest"
val collected = ArrayList<MessageItem>()
var offset = 0
var payloadChars = 0L
while (true) {
val request = SessionMessagePageRequest(offset = offset, order = order)
val page = fetchPage(request).getOrThrow()
payloadChars += page.payloadChars
if (payloadChars > MAX_COMPLETE_TRANSCRIPT_PAYLOAD_CHARS) {
throw SessionTranscriptTooLargeException(
"Session transcript exceeds Android's 32 MB safe-load limit",
)
}
if (collected.size + page.messages.size > MAX_COMPLETE_TRANSCRIPT_MESSAGES) {
throw SessionTranscriptTooLargeException(
"Session transcript exceeds Android's 50,000-message safe-load limit",
)
}
collected += page.messages
if (mode == SessionMessageLoadMode.LATEST) break
// Older Hermes returned one unpaginated complete envelope. Never issue
// a speculative second request against that contract.
val pagination = page.pagination ?: break
val returned = pagination.returned ?: page.messages.size
if (page.messages.isEmpty() || returned < request.limit || page.messages.size < request.limit) break
val nextOffset = offset + page.messages.size
if (nextOffset <= offset) break
offset = nextOffset
}
Result.success(collected)
} catch (error: CancellationException) {
throw error
} catch (error: Throwable) {
Result.failure(error)
}
}
@@ -142,6 +142,8 @@ data class SessionItem(
val preview: String? = null,
val model: String? = null,
val source: String? = null,
/** Owning profile on the cross-profile `/api/profiles/sessions` endpoint. */
val profile: String? = null,
@SerialName("started_at")
@Serializable(with = FlexibleTimestampSerializer::class)
val startedAt: Double? = null,
@@ -244,7 +246,16 @@ data class MessageListResponse(
val items: List<MessageItem>? = null,
val messages: List<MessageItem>? = null, // alternate key
val data: List<MessageItem>? = null, // upstream /api/sessions/{id}/messages list envelope
val total: Int? = null
val total: Int? = null,
val pagination: MessagePagination? = null,
)
@Serializable
data class MessagePagination(
val limit: Int? = null,
val offset: Int? = null,
val order: String? = null,
val returned: Int? = null,
)
@Serializable
@@ -176,7 +176,7 @@ internal class HermesRuntimeBinder(
chat.setDisplayProfileProvider { connection.effectiveDisplayProfile.value }
chat.setDisplayAliasProvider { connection.profileDisplayAlias.value }
chat.setProfileSessionLister { connection.listProfileScopedSessions() }
chat.setProfileMessageLoader(connection::loadProfileScopedMessages)
chat.setProfileMessageLoaderWithMode(connection::loadProfileScopedMessages)
chat.setDashboardConfigLoader { connection.loadActiveDashboardConfig() }
chat.profileSessionDeleter = connection::deleteProfileScopedSession
chat.profileSessionRenamer = connection::renameProfileScopedSession
@@ -59,6 +59,7 @@ import androidx.compose.ui.draw.alpha
import androidx.compose.ui.graphics.vector.ImageVector
import androidx.compose.ui.platform.LocalConfiguration
import androidx.compose.ui.platform.LocalContext
import androidx.compose.ui.platform.LocalWindowInfo
import androidx.compose.ui.res.stringResource
import androidx.compose.ui.text.font.FontFamily
import androidx.compose.ui.unit.dp
@@ -96,13 +97,16 @@ import com.hermesandroid.relay.ui.components.avatar.LocalPetPlaybackSpeed
import com.hermesandroid.relay.ui.components.avatar.LocalPetStabilize
import com.hermesandroid.relay.ui.components.avatar.PetLoader
import com.hermesandroid.relay.ui.components.avatar.SphereAvatar
import com.hermesandroid.relay.ui.components.avatar.resolveBackgroundAvatar
import com.hermesandroid.relay.ui.components.FloatingPetCompanion
import com.hermesandroid.relay.ui.components.shouldCompactFloatingPet
import com.hermesandroid.relay.ui.components.pet.LocalPetCompanionCoordinator
import com.hermesandroid.relay.ui.components.pet.LocalPetSafeAreaRegistry
import com.hermesandroid.relay.ui.components.pet.PetCompanionCoordinator
import com.hermesandroid.relay.ui.components.pet.PetInteractionLayer
import com.hermesandroid.relay.ui.components.pet.PetSafeAreaRegistry
import com.hermesandroid.relay.ui.components.pet.petPerchSurface
import com.hermesandroid.relay.ui.components.pet.platformModalOwnsPetLayer
import com.hermesandroid.relay.ui.components.ConnectionSwitcherSheet
import com.hermesandroid.relay.ui.components.ChatTransportStatusBadge
import com.hermesandroid.relay.ui.components.ChatTransportTier
@@ -135,6 +139,7 @@ import com.hermesandroid.relay.ui.onboarding.OnboardingScreen
import com.hermesandroid.relay.ui.screens.AboutScreen
import com.hermesandroid.relay.ui.screens.AnalyticsScreen
import com.hermesandroid.relay.ui.screens.AppearanceSettingsScreen
import com.hermesandroid.relay.ui.screens.CustomPetGuideScreen
import com.hermesandroid.relay.ui.screens.PetdexBrowseScreen
import com.hermesandroid.relay.ui.screens.BridgeCoreScreen
import com.hermesandroid.relay.ui.screens.DiagnosticsScreen
@@ -465,6 +470,7 @@ sealed class Screen(
data object MediaSettings : Screen("settings/media", "Media", Icons.Filled.Settings)
data object AppearanceSettings : Screen("settings/appearance", "Appearance", Icons.Filled.Settings)
data object PetdexBrowse : Screen("settings/appearance/petdex", "Petdex", Icons.Filled.Settings)
data object CustomPetGuide : Screen("settings/appearance/custom-pet", "Create a pet", Icons.Filled.Settings)
data object Analytics : Screen("settings/analytics", "Analytics", Icons.Filled.Settings)
data object Diagnostics : Screen("settings/diagnostics", "Diagnostics", Icons.Filled.Settings)
data object DeveloperSettings : Screen("settings/developer", "Developer", Icons.Filled.Settings)
@@ -698,16 +704,20 @@ fun RelayApp() {
val appThemeId by connectionViewModel.appTheme.collectAsState()
val fontScale by connectionViewModel.fontScale.collectAsState()
val appFontId by connectionViewModel.appFont.collectAsState()
val appearanceAccent by connectionViewModel.appearanceAccent.collectAsState()
val appearanceShape by connectionViewModel.appearanceShape.collectAsState()
// Resolve the active sphere skin (built-in / adaptive / user-loaded) and
// publish it + the full available set so every MorphingSphere picks it up
// via LocalSphereSkin without per-call-site threading. Adaptive skins read
// the brand lazily inside MorphingSphere, so this can sit outside the theme.
val sphereSkinId by connectionViewModel.sphereSkin.collectAsState()
val appearanceAssetsRefreshTick by connectionViewModel.avatarsRefreshTick.collectAsState()
val sphereContext = androidx.compose.ui.platform.LocalContext.current
val availableSphereSkins by produceState(
initialValue = SphereRegistry.builtIns,
key1 = sphereContext,
key2 = appearanceAssetsRefreshTick,
) {
value = SphereRegistry.builtIns +
withContext(Dispatchers.IO) { SphereSkinLoader.loadUserSkins(sphereContext) }
@@ -720,14 +730,14 @@ fun RelayApp() {
)
}
// Ambient visualization and pet companionship are independent. Existing
// LocalAgentAvatar call sites keep rendering the sphere; a selected pet is
// published separately for the floating companion surface.
// Central/background visualization and pet companionship are independent.
// LocalAgentAvatar owns the central surfaces; LocalFloatingPet owns roaming.
val floatingPetId by connectionViewModel.floatingPet.collectAsState()
val backgroundAvatarId by connectionViewModel.backgroundAvatar.collectAsState()
// Re-scans the pets/ dir whenever the tick bumps (in-app import/delete, or the
// Appearance screen opening), so newly added/removed pets appear everywhere
// without an app restart.
val avatarsRefreshTick by connectionViewModel.avatarsRefreshTick.collectAsState()
val avatarsRefreshTick = appearanceAssetsRefreshTick
val availablePets by produceState(
initialValue = emptyList<AgentAvatar>(),
key1 = sphereContext,
@@ -738,6 +748,10 @@ fun RelayApp() {
val activeFloatingPet = remember(floatingPetId, availablePets) {
availablePets.firstOrNull { it.id == floatingPetId }
}
var floatingPetMenuExpanded by remember(activeFloatingPet?.id) { mutableStateOf(false) }
val activeBackgroundAvatar = remember(backgroundAvatarId, availablePets) {
resolveBackgroundAvatar(backgroundAvatarId, availablePets)
}
val petSpeed by connectionViewModel.petSpeed.collectAsState()
val petStabilize by connectionViewModel.petStabilize.collectAsState()
val petRoamingEnabled by connectionViewModel.petRoamingEnabled.collectAsState()
@@ -818,7 +832,7 @@ fun RelayApp() {
CompositionLocalProvider(
LocalSphereSkin provides activeSphereSkin,
LocalAvailableSphereSkins provides availableSphereSkins,
LocalAgentAvatar provides SphereAvatar,
LocalAgentAvatar provides activeBackgroundAvatar,
// Compatibility list for the existing Appearance picker during the
// transition; new companion UI consumes LocalAvailablePets.
LocalAvailableAvatars provides listOf(SphereAvatar) + availablePets,
@@ -831,11 +845,23 @@ fun RelayApp() {
LocalPetSafeAreaRegistry provides petSafeAreaRegistry,
LocalAgentIconPath provides agentIconPath,
) {
// Dialogs and modal sheets use their own focused window. Treat that
// focus handoff as an app-wide interaction layer so a dock-only pet on
// any route cannot remain visible beneath modal chrome.
PetInteractionLayer(
owner = "platform-modal-window",
active = platformModalOwnsPetLayer(
windowFocused = LocalWindowInfo.current.isWindowFocused,
petMenuExpanded = floatingPetMenuExpanded,
),
)
HermesRelayTheme(
appThemeId = appThemeId,
themePreference = themePreference,
fontScale = fontScale,
appFontId = appFontId,
accentHex = appearanceAccent,
shapeId = appearanceShape,
) {
// Surface a crash report from a previous session, if any. Renders a
// platform Dialog (own window) so tree position is z-order-agnostic;
@@ -1051,6 +1077,22 @@ fun RelayApp() {
val gatewayCurrentModel by chatViewModel.gatewayCurrentModel.collectAsState()
val appReady by connectionViewModel.isReady.collectAsState()
val initialChatSettled by chatViewModel.initialChatSettled.collectAsState()
// Android sharesheet handoff: wait until the configured chat context is
// settled, then ask ChatViewModel to own the new draft and composer
// prefill. Navigation is presentation-only; no composable writes chat
// stores or sends the shared text.
LaunchedEffect(navController, onboardingCompleted, initialChatSettled) {
if (!onboardingCompleted || !initialChatSettled) return@LaunchedEffect
com.hermesandroid.relay.util.SharedTextRequest.pending.collect { request ->
request ?: return@collect
if (chatViewModel.openSharedTextDraft(request.text)) {
navController.navigate(Screen.Chat.route(openAgentSheet = false)) {
launchSingleTop = true
}
com.hermesandroid.relay.util.SharedTextRequest.consume(request.id)
}
}
}
// The SAME readiness signal ChatScreen renders its "Connect Standard
// Hermes" CTA from (chat client exists + reachable verdict). The gate
// must release on this — releasing on the resolver's earlier
@@ -1657,9 +1699,9 @@ fun RelayApp() {
) { backStackEntry ->
// Responsive bubble width based on screen width. The "Blend"
// chat look favors wider bubbles: on compact phones the cap is
// raised so long turns fill most of the row (binding on the
// available width minus the assistant avatar gutter) instead
// of wrapping early in a narrow column.
// raised so long turns fill most of the row instead of
// wrapping early in a narrow column. Assistant identity
// stays in the group header and does not reduce this cap.
val configuration = LocalConfiguration.current
val screenWidthDp = configuration.screenWidthDp.dp
val maxBubbleWidth = when {
@@ -2475,6 +2517,7 @@ fun RelayApp() {
connectionViewModel = connectionViewModel,
onBack = { navController.popBackStack() },
onBrowsePetdex = { navController.navigate(Screen.PetdexBrowse.route) },
onCreatePet = { navController.navigate(Screen.CustomPetGuide.route) },
)
}
composable(Screen.PetdexBrowse.route) {
@@ -2483,6 +2526,20 @@ fun RelayApp() {
onBack = { navController.popBackStack() },
)
}
composable(Screen.CustomPetGuide.route) {
CustomPetGuideScreen(
connectionViewModel = connectionViewModel,
onBack = { navController.popBackStack() },
onStartNewChat = { prompt ->
chatViewModel.createNewChat()
chatViewModel.stageComposerDraft(prompt)
navController.navigate(Screen.Chat.route(openAgentSheet = false)) {
popUpTo(Screen.Chat.route) { inclusive = false }
launchSingleTop = true
}
},
)
}
composable(Screen.Analytics.route) {
AnalyticsScreen(
connectionViewModel = connectionViewModel,
@@ -2670,6 +2727,7 @@ fun RelayApp() {
onOpenAppearance = {
navController.navigate(Screen.AppearanceSettings.route) { launchSingleTop = true }
},
onMenuExpandedChanged = { floatingPetMenuExpanded = it },
onExitTerrainDebug = {
petTerrainOverlayScope.launch {
FeatureFlags.setPetTerrainOverlayEnabled(sphereContext, false)
@@ -1,15 +1,20 @@
package com.hermesandroid.relay.ui.components
import androidx.compose.foundation.Image
import androidx.compose.foundation.layout.Box
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.foundation.layout.padding
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.layout.ContentScale
import androidx.compose.ui.res.painterResource
import androidx.compose.ui.text.TextStyle
import androidx.compose.ui.unit.dp
import coil3.compose.AsyncImage
import com.hermesandroid.relay.R
import java.io.File
/**
@@ -28,6 +33,15 @@ fun AgentAvatarFace(name: String, letterStyle: TextStyle, modifier: Modifier = M
contentScale = ContentScale.Crop,
modifier = modifier.fillMaxSize(),
)
} else if (name.equals("Hermes", ignoreCase = true)) {
Image(
painter = painterResource(R.drawable.splash_icon),
contentDescription = null,
contentScale = ContentScale.Fit,
modifier = modifier
.fillMaxSize()
.padding(2.dp),
)
} else {
Box(modifier = modifier.fillMaxSize(), contentAlignment = Alignment.Center) {
Text(
@@ -332,7 +332,7 @@ private fun decodeGalleryBitmap(bytes: ByteArray): android.graphics.Bitmap? {
sample *= 2
}
val options = BitmapFactory.Options().apply { inSampleSize = sample }
return BitmapFactory.decodeByteArray(bytes, 0, bytes.size, options)
return decodeOrientedBitmap(bytes, options)
}
private const val GALLERY_COLUMNS = 2
@@ -4,7 +4,6 @@ package com.hermesandroid.relay.ui.components
import android.content.Context
import android.graphics.Bitmap
import android.graphics.BitmapFactory
import android.graphics.pdf.PdfRenderer
import android.media.audiofx.Visualizer
import android.net.Uri
@@ -697,7 +696,7 @@ private fun ImageBody(
val decoded = withContext(Dispatchers.IO) {
runCatching {
val bytes = attachmentBytes(context, attachment)
bytes?.let { BitmapFactory.decodeByteArray(it, 0, it.size)?.asImageBitmap() }
bytes?.let { decodeOrientedBitmap(it)?.asImageBitmap() }
}.getOrNull()
}
if (decoded != null) bitmap = decoded else failed = true
@@ -304,10 +304,8 @@ private fun DataUrlChatImage(image: ChatInlineImage, maxWidth: Dp) {
BitmapFactory.decodeByteArray(decoded.bytes, 0, decoded.bytes.size, bounds)
val sample = inlineImageSampleSize(bounds.outWidth, bounds.outHeight)
?: return@withInlineImageDecodeLock DataUrlImagePhase.Rejected
val bitmap = BitmapFactory.decodeByteArray(
val bitmap = decodeOrientedBitmap(
decoded.bytes,
0,
decoded.bytes.size,
BitmapFactory.Options().apply {
inSampleSize = sample
inPreferredConfig = android.graphics.Bitmap.Config.ARGB_8888
@@ -482,7 +480,7 @@ private fun RelayServerImage(
is ServerImageResult.Success -> {
val bytes = result.bytes
val bmp = runCatching {
BitmapFactory.decodeByteArray(bytes, 0, bytes.size)
decodeOrientedBitmap(bytes)
}.getOrNull()?.asImageBitmap()
if (bmp != null) {
putInlineImage(image.src, bmp, result.sensitive)
@@ -29,6 +29,8 @@ import androidx.compose.foundation.layout.widthIn
import androidx.compose.foundation.shape.CircleShape
import androidx.compose.foundation.shape.RoundedCornerShape
import androidx.compose.foundation.text.BasicTextField
import androidx.compose.foundation.text.KeyboardActions
import androidx.compose.foundation.text.KeyboardOptions
import androidx.compose.material.icons.Icons
import androidx.compose.material.icons.automirrored.filled.Send
import androidx.compose.material.icons.filled.Add
@@ -58,8 +60,18 @@ import androidx.compose.runtime.setValue
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.draw.clip
import androidx.compose.ui.focus.FocusRequester
import androidx.compose.ui.focus.focusProperties
import androidx.compose.ui.graphics.SolidColor
import androidx.compose.ui.input.key.onPreviewKeyEvent
import androidx.compose.ui.res.stringResource
import androidx.compose.ui.platform.testTag
import androidx.compose.ui.semantics.LiveRegionMode
import androidx.compose.ui.semantics.contentDescription
import androidx.compose.ui.semantics.liveRegion
import androidx.compose.ui.semantics.semantics
import androidx.compose.ui.text.input.ImeAction
import androidx.compose.ui.text.input.KeyboardCapitalization
import androidx.compose.ui.text.style.TextOverflow
import androidx.compose.ui.unit.dp
import com.hermesandroid.relay.R
@@ -84,6 +96,7 @@ enum class ChatInputTrailing { SEND, VOICE, STOP, STEER, QUEUE }
private val ChatComposerShape = RoundedCornerShape(18.dp)
private val ChatInputChipShape = RoundedCornerShape(12.dp)
internal const val CHAT_INPUT_FIELD_TEST_TAG = "chat-input-field"
data class ChatInputPickerOption(
val label: String,
@@ -174,7 +187,14 @@ fun ChatInputBar(
modifier: Modifier = Modifier,
surfaceModifier: Modifier = Modifier,
enabled: Boolean = true,
physicalEnterSends: Boolean = true,
) {
val canSubmit = enabled && trailing in setOf(
ChatInputTrailing.SEND,
ChatInputTrailing.STEER,
ChatInputTrailing.QUEUE,
)
// Keep the last caption around so the AnimatedVisibility exit doesn't
// flash an empty line while collapsing.
var lastCaption by remember { mutableStateOf<String?>(null) }
@@ -203,18 +223,57 @@ fun ChatInputBar(
}
Column(modifier = modifier.fillMaxWidth()) {
// Caption row — correct/queue hinting, single line, no buttons.
// Correction and queueing are materially different actions. Keep the
// explanation, but lead with a visible state pill so the distinction
// does not depend on the trailing icon or accent color alone.
AnimatedVisibility(visible = caption != null) {
Text(
text = caption ?: lastCaption.orEmpty(),
style = relayMetadataStyle(),
color = if (trailing == ChatInputTrailing.STEER) {
MaterialTheme.colorScheme.tertiary.copy(alpha = 0.9f)
} else {
MaterialTheme.colorScheme.onSurfaceVariant
},
modifier = Modifier.padding(horizontal = 20.dp, vertical = 2.dp),
)
val detail = caption ?: lastCaption.orEmpty()
val actionLabel = when (trailing) {
ChatInputTrailing.STEER -> stringResource(R.string.chat_input_steer_response)
ChatInputTrailing.QUEUE -> stringResource(R.string.chat_input_queue_message)
else -> null
}
Row(
modifier = Modifier
.fillMaxWidth()
.padding(horizontal = 20.dp, vertical = 2.dp)
.semantics {
liveRegion = LiveRegionMode.Polite
contentDescription = listOfNotNull(actionLabel, detail)
.joinToString(separator = ". ")
},
horizontalArrangement = Arrangement.spacedBy(8.dp),
verticalAlignment = Alignment.CenterVertically,
) {
if (actionLabel != null) {
Text(
text = actionLabel,
style = MaterialTheme.typography.labelSmall,
color = if (trailing == ChatInputTrailing.STEER) {
MaterialTheme.colorScheme.onTertiaryContainer
} else {
MaterialTheme.colorScheme.onSecondaryContainer
},
modifier = Modifier
.clip(RoundedCornerShape(999.dp))
.background(
if (trailing == ChatInputTrailing.STEER) {
MaterialTheme.colorScheme.tertiaryContainer
} else {
MaterialTheme.colorScheme.secondaryContainer
},
)
.padding(horizontal = 8.dp, vertical = 3.dp),
)
}
Text(
text = detail,
style = relayMetadataStyle(),
color = MaterialTheme.colorScheme.onSurfaceVariant,
maxLines = 1,
overflow = TextOverflow.Ellipsis,
)
}
}
// Voice hint pill — floats above the trailing button.
@@ -290,9 +349,44 @@ fun ChatInputBar(
modifier = Modifier
.fillMaxWidth()
.heightIn(min = 34.dp)
.padding(horizontal = 8.dp, vertical = 4.dp),
.padding(horizontal = 8.dp, vertical = 4.dp)
// Keep directional keys inside the editor. Compose's
// BasicTextField owns normal caret/selection movement;
// cancelling focus traversal prevents a boundary arrow
// from jumping to a neighboring composer control.
.focusProperties {
left = FocusRequester.Cancel
right = FocusRequester.Cancel
up = FocusRequester.Cancel
down = FocusRequester.Cancel
}
.onPreviewKeyEvent { event ->
val native = event.nativeKeyEvent
val isEnter = native.keyCode == android.view.KeyEvent.KEYCODE_ENTER ||
native.keyCode == android.view.KeyEvent.KEYCODE_NUMPAD_ENTER
val isSubmitShortcut = native.isCtrlPressed || native.isMetaPressed
if (native.action != android.view.KeyEvent.ACTION_DOWN || !isEnter) {
false
} else if (isSubmitShortcut || (physicalEnterSends && !native.isShiftPressed)) {
if (canSubmit) onSend()
true
} else {
// Shift+Enter always inserts a newline. When
// Enter is configured for newlines, the plain
// key also stays owned by BasicTextField.
false
}
}
.testTag(CHAT_INPUT_FIELD_TEST_TAG),
maxLines = 5,
enabled = enabled,
keyboardOptions = KeyboardOptions(
capitalization = KeyboardCapitalization.Sentences,
imeAction = ImeAction.Send,
),
keyboardActions = KeyboardActions(
onSend = { if (canSubmit) onSend() },
),
textStyle = MaterialTheme.typography.bodyLarge.copy(
color = MaterialTheme.colorScheme.onSurface,
),
@@ -314,7 +408,7 @@ fun ChatInputBar(
Row(
modifier = Modifier
.fillMaxWidth()
.heightIn(min = 40.dp),
.heightIn(min = 48.dp),
verticalAlignment = Alignment.CenterVertically,
horizontalArrangement = Arrangement.spacedBy(4.dp),
) {
@@ -324,7 +418,7 @@ fun ChatInputBar(
Box {
Box(
modifier = Modifier
.size(38.dp)
.size(48.dp)
.clip(CircleShape)
.combinedClickable(
onClick = { attachMenuExpanded = true },
@@ -0,0 +1,122 @@
package com.hermesandroid.relay.ui.components
import androidx.compose.foundation.background
import androidx.compose.foundation.clickable
import androidx.compose.foundation.layout.Box
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.Row
import androidx.compose.foundation.layout.fillMaxWidth
import androidx.compose.foundation.layout.height
import androidx.compose.foundation.layout.padding
import androidx.compose.foundation.layout.size
import androidx.compose.foundation.layout.width
import androidx.compose.foundation.shape.RoundedCornerShape
import androidx.compose.material.icons.Icons
import androidx.compose.material.icons.filled.Close
import androidx.compose.material3.Icon
import androidx.compose.material3.IconButton
import androidx.compose.material3.ColorScheme
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.Surface
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.draw.clip
import androidx.compose.ui.graphics.Color
import androidx.compose.ui.res.stringResource
import androidx.compose.ui.semantics.Role
import androidx.compose.ui.semantics.contentDescription
import androidx.compose.ui.semantics.semantics
import androidx.compose.ui.text.font.FontWeight
import androidx.compose.ui.text.style.TextOverflow
import androidx.compose.ui.unit.dp
import com.hermesandroid.relay.R
import com.hermesandroid.relay.data.ChatQuoteReference
internal data class ChatQuoteReferenceColors(
val background: Color,
val author: Color,
val excerpt: Color,
val accent: Color,
)
internal fun chatQuoteReferenceColors(colorScheme: ColorScheme) = ChatQuoteReferenceColors(
background = colorScheme.surfaceContainerHigh,
author = colorScheme.onSurface,
excerpt = colorScheme.onSurfaceVariant,
accent = colorScheme.primary,
)
/** Attachment-like quote reference used in both the composer and sent bubbles. */
@Composable
fun ChatQuoteReferenceChip(
reference: ChatQuoteReference,
modifier: Modifier = Modifier,
onOpenOriginal: (() -> Unit)? = null,
onRemove: (() -> Unit)? = null,
) {
val openDescription = stringResource(R.string.chat_quote_open, reference.authorLabel)
val colors = chatQuoteReferenceColors(MaterialTheme.colorScheme)
Surface(
modifier = modifier.fillMaxWidth(),
shape = RoundedCornerShape(8.dp),
color = colors.background,
) {
Row(
modifier = Modifier
.then(
onOpenOriginal?.let { open ->
Modifier.clickable(
role = Role.Button,
onClickLabel = openDescription,
onClick = open,
)
} ?: Modifier,
)
.semantics { contentDescription = "$openDescription. ${reference.excerpt}" }
.padding(start = 7.dp),
verticalAlignment = Alignment.CenterVertically,
) {
Box(
modifier = Modifier
.width(3.dp)
.height(32.dp)
.clip(RoundedCornerShape(99.dp))
.background(colors.accent),
)
Column(
modifier = Modifier
.weight(1f)
.padding(horizontal = 8.dp, vertical = 5.dp),
) {
Text(
text = "@${reference.authorLabel}",
style = MaterialTheme.typography.labelMedium,
fontWeight = FontWeight.Medium,
color = colors.author,
)
Text(
text = reference.excerpt,
style = MaterialTheme.typography.labelSmall,
color = colors.excerpt,
maxLines = 2,
overflow = TextOverflow.Ellipsis,
)
}
if (onRemove != null) {
IconButton(
onClick = onRemove,
modifier = Modifier.size(48.dp),
) {
Icon(
imageVector = Icons.Filled.Close,
contentDescription = stringResource(R.string.chat_quote_remove),
tint = colors.excerpt,
modifier = Modifier.size(18.dp),
)
}
}
}
}
}
@@ -64,6 +64,10 @@ data class SlashCommand(
* instead of plain text.
*/
val source: String? = null,
/** Bounded server-recorded skill usage; zero for non-skill commands. */
val usageRank: Int = 0,
/** Sanitized server skill origin such as local or bundled. */
val origin: String? = null,
) {
companion object {
const val SOURCE_SERVER = "server"
@@ -684,7 +684,6 @@ fun RelayInfoSheet(
// the Profile section footer spells out the override.
private enum class AgentPassportPicker {
Profile,
Personality,
Model,
Reasoning,
@@ -762,6 +761,7 @@ fun AgentInfoSheet(
var selectedTab by remember { mutableStateOf(0) }
var activePicker by remember { mutableStateOf<AgentPassportPicker?>(null) }
var showProfileSwitcher by remember { mutableStateOf(false) }
var showIdentityEditor by remember { mutableStateOf(false) }
var showProfileManager by remember { mutableStateOf(false) }
@@ -771,6 +771,20 @@ fun AgentInfoSheet(
val currentSession = remember(sessions, currentSessionId) {
sessions.firstOrNull { it.sessionId == currentSessionId }
}
val sessionModelState = resolveSessionModelUiState(
hasSession = currentSessionId != null,
pendingModel = selectedModel,
pendingProvider = selectedProvider,
gatewayModel = gatewayModel,
gatewayProvider = gatewayProvider,
persistedSessionModel = currentSession?.model,
profileDefaultModel = resolvedProfile?.model,
serverDefaultModel = serverModel,
)
val sessionPickerProvider = sessionModelState.pickerProvider
?: sessionModelState.pickerModel?.let { model ->
modelProviders.singleOrNull { model in it.models }?.slug
}
val agentName = AgentDisplay.agentName(
profile = resolvedProfile,
selectedPersonality = selectedPersonality,
@@ -782,25 +796,22 @@ fun AgentInfoSheet(
AgentDisplay.profileDisplayName(it) ?: it.name
} ?: stringResource(R.string.conn_info_server_default)
val serverDefaultLabel = stringResource(R.string.conn_info_server_default)
val modelLabel = AgentDisplay.displayModelName(selectedModel ?: gatewayModel)
?: AgentDisplay.displayModelName(resolvedProfile?.model)
?: AgentDisplay.displayModelName(serverModel)
val modelLabel = AgentDisplay.displayModelName(sessionModelState.model)
?: serverDefaultLabel
val serverDefaultModelLabel = AgentDisplay.displayModelName(serverModel)
?: AgentDisplay.displayModelName(resolvedProfile?.model)
val providerLabel = modelProviders
.firstOrNull { it.slug.equals(gatewayProvider, ignoreCase = true) }
.firstOrNull { it.slug.equals(sessionModelState.provider, ignoreCase = true) }
?.name
?.takeIf { it.isNotBlank() }
?: gatewayProvider.takeIf { it.isNotBlank() }
val sessionModelLabel = AgentDisplay.displayModelName(currentSession?.model)
?: modelLabel
val sessionProviderLabel = currentSession?.model
?: sessionModelState.provider
val sessionModelLabel = modelLabel
val sessionProviderLabel = sessionModelState.model
?.takeIf { it.isNotBlank() }
?.let { sessionModel ->
modelProviders.firstOrNull { sessionModel in it.models }?.name
}
?: providerLabel.takeIf { currentSession?.model.isNullOrBlank() }
?: providerLabel
val connected = chatReady
val resolvedPresence = resolvedProfile?.let {
ProfilePresenceResolver.resolve(it, connected)
@@ -851,6 +862,8 @@ fun AgentInfoSheet(
agentProfiles,
selectedModel,
selectedProvider,
sessionModelState,
sessionPickerProvider,
modelLabel,
unavailableModelLabel,
modelNeedsSetupLabel,
@@ -871,7 +884,7 @@ fun AgentInfoSheet(
label = serverDefaultLabel,
value = null,
secondary = serverDefaultModelLabel,
selected = selectedModel == null,
selected = sessionModelState.inheritsProfileDefault,
),
)
modelProviders
@@ -891,8 +904,8 @@ fun AgentInfoSheet(
provider.warning ?: modelNeedsSetupLabel
else -> null
},
selected = selectedModel == model &&
selectedProvider.equals(provider.slug, ignoreCase = true),
selected = sessionModelState.pickerModel == model &&
sessionPickerProvider.equals(provider.slug, ignoreCase = true),
enabled = !unavailable,
),
)
@@ -908,7 +921,7 @@ fun AgentInfoSheet(
value = model.id,
group = "Routes",
secondary = model.routeDetail,
selected = selectedModel == model.id,
selected = sessionModelState.pickerModel == model.id,
),
)
}
@@ -916,10 +929,10 @@ fun AgentInfoSheet(
}
LaunchedEffect(Unit) {
chatViewModel.refreshModelOptions()
chatViewModel.refreshModelOptions(catalogOnly = true)
chatViewModel.refreshApprovalMode()
chatViewModel.refreshPersonalities()
chatViewModel.refreshModels()
chatViewModel.refreshModels(catalogOnly = true)
connectionViewModel.refreshDashboardProfiles()
}
@@ -945,10 +958,7 @@ fun AgentInfoSheet(
presence = resolvedPresence,
hasSoul = resolvedProfile?.hasSoul == true,
skillCount = resolvedProfile?.skillCount ?: 0,
transportLabel = transportFriendlyName(sessionTransport.type),
sessionLabel = currentSessionId?.take(8) ?: "—",
contextLabel = contextLabel,
onProfileClick = { activePicker = AgentPassportPicker.Profile },
onProfileClick = { showProfileSwitcher = true },
)
if (showIdentityEditor) {
@@ -982,7 +992,7 @@ fun AgentInfoSheet(
) {
Column {
Text(
text = stringResource(R.string.conn_info_active_configuration),
text = stringResource(R.string.conn_info_session_title),
modifier = Modifier.padding(
start = 18.dp,
top = 17.dp,
@@ -992,25 +1002,13 @@ fun AgentInfoSheet(
style = MaterialTheme.typography.titleMedium,
fontWeight = FontWeight.SemiBold,
)
PassportConfigRow(
icon = Icons.Filled.Person,
title = stringResource(R.string.conn_info_personality_title),
value = AgentDisplay.personalityLabel(
selectedPersonality,
defaultPersonality,
),
expanded = false,
enabled = !isStreaming,
onClick = { activePicker = AgentPassportPicker.Personality },
)
PassportDivider()
PassportConfigRow(
icon = Icons.Filled.ViewInAr,
title = stringResource(R.string.conn_info_model_title),
value = selectedModel ?: if (modelLabel == serverDefaultLabel) {
serverDefaultLabel
} else {
value = if (sessionModelState.inheritsProfileDefault) {
stringResource(R.string.conn_info_server_default_model, modelLabel)
} else {
modelLabel
},
expanded = false,
enabled = !isStreaming,
@@ -1034,6 +1032,44 @@ fun AgentInfoSheet(
}
}
// Upstream personality changes persist to the active profile
// while also applying to the live session. Keep that control
// visibly separate from the session-only model/effort card so
// it cannot be mistaken for an ephemeral override.
Surface(
shape = RoundedCornerShape(22.dp),
color = MaterialTheme.colorScheme.surfaceContainer,
border = androidx.compose.foundation.BorderStroke(
1.dp,
MaterialTheme.colorScheme.outlineVariant.copy(alpha = 0.55f),
),
) {
Column {
Text(
text = stringResource(R.string.conn_info_profile),
modifier = Modifier.padding(
start = 18.dp,
top = 17.dp,
end = 18.dp,
bottom = 4.dp,
),
style = MaterialTheme.typography.titleMedium,
fontWeight = FontWeight.SemiBold,
)
PassportConfigRow(
icon = Icons.Filled.Person,
title = stringResource(R.string.conn_info_personality_title),
value = AgentDisplay.personalityLabel(
selectedPersonality,
defaultPersonality,
),
expanded = false,
enabled = !isStreaming,
onClick = { activePicker = AgentPassportPicker.Personality },
)
}
}
AgentPassportSafetyCard(
approvalMode = approvalMode,
approvalCapability = approvalCapability,
@@ -1155,49 +1191,6 @@ fun AgentInfoSheet(
}
when (activePicker) {
AgentPassportPicker.Profile -> {
val selectedProfileKey = AgentDisplay.profileSessionKey(selectedProfile?.name)
val visibleProfileKeys = ProfilePresentationPolicy.visibleKeys(
profiles = agentProfiles,
presentation = profilePresentation,
selectedKey = selectedProfileKey,
)
val options = visibleProfileKeys.mapNotNull { profileKey ->
if (profileKey == AgentDisplay.SERVER_DEFAULT_PROFILE_KEY) {
ChatInputPickerOption(
label = serverDefaultLabel,
value = null,
secondary = AgentDisplay.profileDisplayName(resolvedProfile),
selected = selectedProfile == null,
enabled = !isProfileLocked && profileSwitchEnabled,
)
} else {
agentProfiles.firstOrNull { it.name == profileKey }?.let { profile ->
ChatInputPickerOption(
label = AgentDisplay.profileDisplayName(profile)
?: profile.name.replaceFirstChar { it.uppercase() },
value = profile.name,
secondary = profile.model.takeIf { it.isNotBlank() },
selected = selectedProfile?.name == profile.name,
enabled = !isProfileLocked && profileSwitchEnabled,
)
}
}
}
OptionPickerSheet(
title = stringResource(R.string.conn_info_profile),
options = options,
onSelect = { option ->
val profile = option.value?.let { name ->
agentProfiles.firstOrNull { it.name == name }
}
connectionViewModel.selectProfile(profile)
chatViewModel.activateGatewayProfile(profile)
activePicker = null
},
onDismiss = { activePicker = null },
)
}
AgentPassportPicker.Personality -> OptionPickerSheet(
title = stringResource(R.string.conn_info_personality_title),
options = buildList {
@@ -1228,7 +1221,9 @@ fun AgentInfoSheet(
AgentPassportPicker.Model -> ModelPickerSheet(
options = passportModelOptions,
refreshing = modelOptionsRefreshing,
onRefresh = { chatViewModel.refreshModelOptions(refresh = true) },
onRefresh = {
chatViewModel.refreshModelOptions(refresh = true, catalogOnly = true)
},
onSelect = { option ->
activePicker = null
if (option.provider == null && apiModelOptions.any { it.id == option.value }) {
@@ -1274,6 +1269,31 @@ fun AgentInfoSheet(
null -> Unit
}
if (showProfileSwitcher) {
ProfileSwitcherSheet(
connectionViewModel = connectionViewModel,
profiles = agentProfiles,
selectedProfile = selectedProfile,
resolvedProfile = resolvedProfile,
presentation = profilePresentation,
isProfileLocked = isProfileLocked,
switchEnabled = profileSwitchEnabled,
onSelect = { profile ->
if (AgentDisplay.profileSessionKey(profile?.name) !=
AgentDisplay.profileSessionKey(selectedProfile?.name)
) {
connectionViewModel.selectProfile(profile)
chatViewModel.activateGatewayProfile(profile)
}
},
onManageDisplay = {
showProfileSwitcher = false
showProfileManager = true
},
onDismiss = { showProfileSwitcher = false },
)
}
if (showProfileManager) {
ProfileDisplayManagerDialog(
profiles = agentProfiles,
@@ -1303,11 +1323,11 @@ internal fun AgentPassportSheetHost(
ModalBottomSheet(
onDismissRequest = onDismiss,
sheetState = sheetState,
// Use Material's gesture owner instead of custom pointer input. The
// verticalScroll child consumes downward movement until its top
// boundary, then hands the remainder to the sheet; Material also
// follows the platform animator scale for reduced-motion users.
sheetGesturesEnabled = true,
// A full-height sheet and its long verticalScroll child otherwise
// compete for the same drag at the content boundaries. On some devices
// that repeatedly settles/re-expands the sheet and produces a visible
// vibration at the bottom. Close and system Back remain explicit.
sheetGesturesEnabled = false,
) {
Column(
modifier = Modifier
@@ -1441,9 +1461,6 @@ private fun AgentPassportHeader(
presence: ProfilePresence?,
hasSoul: Boolean,
skillCount: Int,
transportLabel: String,
sessionLabel: String,
contextLabel: String,
onProfileClick: () -> Unit,
) {
val brand = LocalBrand.current
@@ -1461,18 +1478,9 @@ private fun AgentPassportHeader(
}
}
val identityMetadata = listOfNotNull(
providerLabel,
stringResource(R.string.conn_info_soul).takeIf { hasSoul },
stringResource(R.string.conn_info_skills_count, skillCount).takeIf { skillCount > 0 },
).joinToString(" · ")
val connectionValue = listOf(
transportLabel,
if (connected) {
stringResource(R.string.conn_info_connected)
} else {
stringResource(R.string.conn_info_disconnected)
},
).joinToString(" · ")
Surface(
shape = RoundedCornerShape(24.dp),
color = MaterialTheme.colorScheme.surfaceContainer,
@@ -1565,7 +1573,7 @@ private fun AgentPassportHeader(
) {
Column(modifier = Modifier.padding(horizontal = 14.dp, vertical = 10.dp)) {
Text(
text = stringResource(R.string.conn_info_active_profile).uppercase(),
text = stringResource(R.string.profile_shelf_switch_agent).uppercase(),
style = MaterialTheme.typography.labelSmall,
color = MaterialTheme.colorScheme.primary,
)
@@ -1607,40 +1615,17 @@ private fun AgentPassportHeader(
}
}
HorizontalDivider(color = MaterialTheme.colorScheme.outlineVariant.copy(alpha = 0.5f))
Row(modifier = Modifier.fillMaxWidth()) {
PassportTechnicalField(
label = stringResource(R.string.conn_info_model_title),
value = modelLabel,
modifier = Modifier.weight(1f),
)
PassportTechnicalDivider(height = 44.dp)
PassportTechnicalField(
label = stringResource(R.string.conn_info_connection),
value = connectionValue,
valueColor = if (connected) brand.green else MaterialTheme.colorScheme.error,
modifier = Modifier.weight(1f),
)
}
HorizontalDivider(color = MaterialTheme.colorScheme.outlineVariant.copy(alpha = 0.5f))
Row(modifier = Modifier.fillMaxWidth()) {
PassportTechnicalField(
label = stringResource(R.string.conn_info_session_title),
value = sessionLabel,
modifier = Modifier.weight(1f),
)
PassportTechnicalDivider(height = 42.dp)
PassportTechnicalField(
label = stringResource(R.string.conn_info_context),
value = contextLabel,
modifier = Modifier.weight(1f),
)
PassportTechnicalDivider(height = 42.dp)
PassportTechnicalField(
label = stringResource(R.string.conn_info_transport),
value = transportLabel,
modifier = Modifier.weight(1f),
)
}
PassportTechnicalField(
label = stringResource(R.string.voice_test_label_provider),
value = providerLabel ?: "—",
modifier = Modifier.fillMaxWidth(),
)
PassportTechnicalField(
label = stringResource(R.string.conn_info_model_title),
value = modelLabel,
modifier = Modifier.fillMaxWidth(),
maxLines = 2,
)
}
}
}
@@ -1651,6 +1636,7 @@ private fun PassportTechnicalField(
value: String,
modifier: Modifier = Modifier,
valueColor: Color = MaterialTheme.colorScheme.onSurface,
maxLines: Int = 1,
) {
Column(
modifier = modifier.padding(horizontal = 8.dp),
@@ -1666,22 +1652,12 @@ private fun PassportTechnicalField(
text = value,
style = MaterialTheme.typography.labelLarge,
color = valueColor,
maxLines = 1,
maxLines = maxLines,
overflow = TextOverflow.Ellipsis,
)
}
}
@Composable
private fun PassportTechnicalDivider(height: Dp) {
Box(
modifier = Modifier
.height(height)
.widthIn(min = 1.dp, max = 1.dp)
.background(MaterialTheme.colorScheme.outlineVariant.copy(alpha = 0.5f)),
)
}
@Composable
private fun AgentPassportTabs(
selected: Int,
@@ -2290,7 +2266,7 @@ private fun LegacyAgentInfoSheet(
// Pull the gateway's curated provider/model list (model.options) when the
// sheet opens — the real switchable models, grouped by provider.
LaunchedEffect(Unit) { chatViewModel.refreshModelOptions() }
LaunchedEffect(Unit) { chatViewModel.refreshModelOptions(catalogOnly = true) }
LaunchedEffect(Unit) { chatViewModel.refreshApprovalMode() }
// Re-pull server-supplied personalities (list + default + active) on open so
// a server-side change shows without an app reload.
@@ -2298,7 +2274,7 @@ private fun LegacyAgentInfoSheet(
// Re-pull the SSE-fallback model list + skill catalog on open so server-side
// changes surface without an app reload (gateway model groups are covered by
// refreshModelOptions above; skills feed the command palette).
LaunchedEffect(Unit) { chatViewModel.refreshModels() }
LaunchedEffect(Unit) { chatViewModel.refreshModels(catalogOnly = true) }
LaunchedEffect(Unit) { chatViewModel.refreshSkills() }
// Pull the host's agent profiles from the dashboard so they appear in the
// Profile picker even on a dashboard-only (non-relay) connection.
@@ -2503,7 +2479,7 @@ private fun LegacyAgentInfoSheet(
// "default" so "Server default" vs "default" would be
// otherwise indistinguishable.
val serverDefaultProfile = agentProfiles
.firstOrNull { AgentDisplay.isServerDefaultAlias(it.name) }
.firstOrNull { it.name.equals("default", ignoreCase = true) }
val selectedKey = AgentDisplay.profileSessionKey(selectedProfile?.name)
val visibleProfileKeys = ProfilePresentationPolicy
.visibleKeys(agentProfiles, profilePresentation, selectedKey)
@@ -2526,8 +2502,7 @@ private fun LegacyAgentInfoSheet(
val lockedDisplayName = when {
lockedProfileName == null ->
stringResource(R.string.conn_info_server_default)
AgentDisplay.isServerDefaultAlias(lockedProfileName) ||
lockedProfileName == AgentDisplay.SERVER_DEFAULT_PROFILE_KEY ->
lockedProfileName == AgentDisplay.SERVER_DEFAULT_PROFILE_KEY ->
stringResource(R.string.conn_info_server_default)
else ->
agentProfiles
@@ -3615,7 +3590,7 @@ private fun LegacyAgentInfoSheet(
// --- AgentInfoSheet helpers ----------------------------------------------
@Composable
private fun ProfileDisplayManagerDialog(
internal fun ProfileDisplayManagerDialog(
profiles: List<Profile>,
presentation: ProfilePresentation,
selectedProfileName: String?,
@@ -19,6 +19,7 @@ import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.compose.runtime.CompositionLocalProvider
import androidx.compose.runtime.DisposableEffect
import androidx.compose.runtime.LaunchedEffect
import androidx.compose.runtime.getValue
import androidx.compose.runtime.key
@@ -319,6 +320,31 @@ internal fun shouldDockFloatingPet(
roamingAllowed: Boolean,
): Boolean = !roamingEnabled || !roamingAllowed
/**
* Chat gives a deliberately paused companion one stable home: the live
* composer rail. Other routes retain the user's saved free-form edge home, and
* active roaming keeps its richer settled-chat habitat hierarchy.
*/
internal fun floatingPetHomePoint(
route: String?,
roamingEnabled: Boolean,
roamingAllowed: Boolean,
manualHomePoint: PetPoint,
roamingHomePoint: PetPoint?,
pausedChatDockPoint: PetPoint?,
): PetPoint = when {
route == "chat" && roamingAllowed && !roamingEnabled && pausedChatDockPoint != null -> {
pausedChatDockPoint
}
roamingEnabled && roamingAllowed -> roamingHomePoint ?: manualHomePoint
else -> manualHomePoint
}
internal fun floatingPetAllowsVerticalMoveActions(
route: String?,
roamingEnabled: Boolean,
): Boolean = route != "chat" || roamingEnabled
internal fun petRailSupportingPoint(
rails: Iterable<PetRoamingRail>,
point: PetPoint,
@@ -465,10 +491,19 @@ fun FloatingPetCompanion(
onResetPlacement: () -> Unit,
onHide: () -> Unit,
onOpenAppearance: () -> Unit,
onMenuExpandedChanged: (Boolean) -> Unit = {},
onExitTerrainDebug: () -> Unit = {},
modifier: Modifier = Modifier,
) {
var menuExpanded by remember(pet.id) { mutableStateOf(false) }
val latestOnMenuExpandedChanged by rememberUpdatedState(onMenuExpandedChanged)
fun setMenuExpanded(expanded: Boolean) {
menuExpanded = expanded
onMenuExpandedChanged(expanded)
}
DisposableEffect(pet.id) {
onDispose { latestOnMenuExpandedChanged(false) }
}
var dragging by remember(pet.id) { mutableStateOf(false) }
var draggedPoint by remember(pet.id) { mutableStateOf<PetPoint?>(null) }
var pendingDrop by remember(pet.id) { mutableStateOf<PendingPetDrop?>(null) }
@@ -834,30 +869,47 @@ fun FloatingPetCompanion(
val requested = placement.sanitized().resolve(safeBounds, petLayoutDirection)
projectIntoSafeBounds(requested, safeBounds, registeredObstacles) ?: requested
}
val homeRail = remember(roamingRails, manualHomePoint, settledHabitat) {
val composerHomeRail = remember(composerRails, manualHomePoint) {
val distanceToHome: (PetRoamingRail) -> Float = { rail ->
rail.bounds.clamp(manualHomePoint).distanceSquaredTo(manualHomePoint)
}
composerRails.minByOrNull(distanceToHome)
}
val homeRail = remember(roamingRails, manualHomePoint, settledHabitat, composerHomeRail) {
val distanceToHome: (PetRoamingRail) -> Float = { rail ->
rail.bounds.clamp(manualHomePoint).distanceSquaredTo(manualHomePoint)
}
settledHabitat?.rail
?: roamingRails.filter { it.perchKey == CHAT_PET_WALK_REGION }.minByOrNull(distanceToHome)
?: composerHomeRail
?: roamingRails.minByOrNull(distanceToHome)
}
fun pointAtPlacementEdge(rail: PetSafeBounds): PetPoint {
val xAtEdge = if (
(placement.edge == PetLogicalEdge.Start) == (petLayoutDirection == PetLayoutDirection.Ltr)
) rail.left else rail.right
return PetPoint(xAtEdge, rail.top)
}
val roamingHomePoint = remember(placement.edge, homeRail, petLayoutDirection) {
homeRail?.bounds?.let { rail ->
homeRail?.bounds?.let(::pointAtPlacementEdge)
}
val pausedChatDockPoint = remember(placement.edge, composerHomeRail, petLayoutDirection) {
composerHomeRail?.bounds?.let { rail ->
val xAtEdge = if (
(placement.edge == PetLogicalEdge.Start) == (petLayoutDirection == PetLayoutDirection.Ltr)
) rail.left else rail.right
PetPoint(xAtEdge, rail.top)
}
}
// Enabling roaming explicitly docks onto the screen-owned safe rail. A
// manual drag or vertical accessibility action pauses roaming first, so the
// persisted free-form placement remains visible and authoritative.
val homePoint = if (roamingEnabled && roamingAllowed) {
roamingHomePoint ?: manualHomePoint
} else {
manualHomePoint
}
// Active roaming uses screen-owned terrain. Paused Chat deliberately uses
// the composer rail; other routes retain the persisted free-form edge home.
val homePoint = floatingPetHomePoint(
route = route,
roamingEnabled = roamingEnabled,
roamingAllowed = roamingAllowed,
manualHomePoint = manualHomePoint,
roamingHomePoint = roamingHomePoint,
pausedChatDockPoint = pausedChatDockPoint,
)
val heldProgress by animateFloatAsState(
targetValue = if (dragging) 1f else 0f,
@@ -1606,7 +1658,7 @@ fun FloatingPetCompanion(
// Chat roaming owns a measured composer rail. Publishing before that rail
// exists lets initialization race route registration and can strand the
// pet on transient fallback geometry until direct manipulation.
val initialTerrainReady = route != "chat" || !roamingEnabled || !roamingAllowed ||
val initialTerrainReady = route != "chat" || !roamingAllowed ||
composerRails.isNotEmpty()
LaunchedEffect(
pet.id,
@@ -2350,31 +2402,43 @@ fun FloatingPetCompanion(
enabled = floatingPetAcceptsPointerInput(positioned, surfaceScrolling),
) {
tapReactionNonce += 1
menuExpanded = true
setMenuExpanded(true)
}
.semantics(mergeDescendants = true) {
role = Role.Button
contentDescription = companionDescription
stateDescription = stateLabel
customActions = listOf(
CustomAccessibilityAction(moveStartLabel) {
customActions = buildList {
add(CustomAccessibilityAction(moveStartLabel) {
onPlacementChanged(placement.copy(edge = PetLogicalEdge.Start)); true
},
CustomAccessibilityAction(moveEndLabel) {
})
add(CustomAccessibilityAction(moveEndLabel) {
onPlacementChanged(placement.copy(edge = PetLogicalEdge.End)); true
},
CustomAccessibilityAction(moveUpLabel) {
if (roamingEnabled) onRoamingEnabledChanged(false)
onPlacementChanged(placement.copy(verticalFraction = placement.verticalFraction - 0.15f)); true
},
CustomAccessibilityAction(moveDownLabel) {
if (roamingEnabled) onRoamingEnabledChanged(false)
onPlacementChanged(placement.copy(verticalFraction = placement.verticalFraction + 0.15f)); true
},
CustomAccessibilityAction(resetLabel) { onResetPlacement(); true },
CustomAccessibilityAction(appearanceLabel) { onOpenAppearance(); true },
CustomAccessibilityAction(hideLabel) { onHide(); true },
)
})
// A paused Chat pet has no meaningful vertical free-form
// coordinate: it is deliberately attached to the composer.
// Do not expose TalkBack actions that would appear to do
// nothing; start/end still choose the dock corner.
if (floatingPetAllowsVerticalMoveActions(route, roamingEnabled)) {
add(CustomAccessibilityAction(moveUpLabel) {
if (roamingEnabled) onRoamingEnabledChanged(false)
onPlacementChanged(
placement.copy(verticalFraction = placement.verticalFraction - 0.15f),
)
true
})
add(CustomAccessibilityAction(moveDownLabel) {
if (roamingEnabled) onRoamingEnabledChanged(false)
onPlacementChanged(
placement.copy(verticalFraction = placement.verticalFraction + 0.15f),
)
true
})
}
add(CustomAccessibilityAction(resetLabel) { onResetPlacement(); true })
add(CustomAccessibilityAction(appearanceLabel) { onOpenAppearance(); true })
add(CustomAccessibilityAction(hideLabel) { onHide(); true })
}
},
contentAlignment = Alignment.Center,
) {
@@ -2419,7 +2483,7 @@ fun FloatingPetCompanion(
DropdownMenu(
expanded = menuExpanded,
onDismissRequest = { menuExpanded = false },
onDismissRequest = { setMenuExpanded(false) },
) {
DropdownMenuItem(
text = { Text("${pet.label} · $stateLabel", color = MaterialTheme.colorScheme.onSurfaceVariant) },
@@ -2436,28 +2500,28 @@ fun FloatingPetCompanion(
)
},
onClick = {
menuExpanded = false
setMenuExpanded(false)
onRoamingEnabledChanged(!roamingEnabled)
},
)
DropdownMenuItem(
text = { Text(resetLabel) },
onClick = {
menuExpanded = false
setMenuExpanded(false)
onResetPlacement()
},
)
DropdownMenuItem(
text = { Text(appearanceLabel) },
onClick = {
menuExpanded = false
setMenuExpanded(false)
onOpenAppearance()
},
)
DropdownMenuItem(
text = { Text(hideLabel) },
onClick = {
menuExpanded = false
setMenuExpanded(false)
onHide()
},
)
@@ -2,7 +2,6 @@ package com.hermesandroid.relay.ui.components
import android.content.Context
import android.graphics.Bitmap
import android.graphics.BitmapFactory
import android.graphics.pdf.PdfRenderer
import android.media.MediaMetadataRetriever
import android.net.Uri
@@ -290,7 +289,7 @@ private fun ImageRender(
android.util.Base64.decode(attachment.content, android.util.Base64.DEFAULT)
else -> null
}
bytes?.let { BitmapFactory.decodeByteArray(it, 0, it.size)?.asImageBitmap() }
bytes?.let { decodeOrientedBitmap(it)?.asImageBitmap() }
}.getOrNull()
}
if (decoded != null) bitmap = decoded else decodeFailed = true
@@ -1,6 +1,11 @@
package com.hermesandroid.relay.ui.components
import androidx.compose.animation.AnimatedVisibility
import androidx.compose.animation.animateContentSize
import androidx.compose.animation.expandVertically
import androidx.compose.animation.fadeIn
import androidx.compose.animation.fadeOut
import androidx.compose.animation.shrinkVertically
import androidx.compose.animation.core.LinearOutSlowInEasing
import androidx.compose.animation.core.RepeatMode
import androidx.compose.animation.core.animateFloat
@@ -32,15 +37,20 @@ import androidx.compose.foundation.text.selection.SelectionContainer
import androidx.compose.foundation.text.selection.DisableSelection
import androidx.compose.material.icons.Icons
import androidx.compose.material.icons.automirrored.filled.VolumeUp
import androidx.compose.material.icons.filled.ContentCopy
import androidx.compose.material.icons.filled.Edit
import androidx.compose.material.icons.filled.FormatQuote
import androidx.compose.material.icons.filled.Stop
import androidx.compose.material3.Icon
import androidx.compose.material3.IconButton
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.Surface
import androidx.compose.material3.Text
import androidx.compose.material3.TextButton
import androidx.compose.material3.DropdownMenu
import androidx.compose.material3.DropdownMenuItem
import androidx.compose.runtime.Composable
import androidx.compose.runtime.CompositionLocalProvider
import androidx.compose.runtime.LaunchedEffect
import androidx.compose.runtime.collectAsState
import androidx.compose.runtime.getValue
import androidx.compose.runtime.key
@@ -71,13 +81,16 @@ import com.hermesandroid.relay.data.HermesCardAction
import com.hermesandroid.relay.data.MediaSettingsRepository
import com.hermesandroid.relay.data.MessageDeliveryStatus
import com.hermesandroid.relay.data.MessageRole
import com.hermesandroid.relay.data.parseChatQuotedPrompt
import com.hermesandroid.relay.ui.components.pet.petObstacleSurface
import com.hermesandroid.relay.ui.components.pet.petPerchSurface
import com.hermesandroid.relay.ui.components.pet.petVisitTargetSurface
import com.hermesandroid.relay.ui.theme.leftEdgeGlow
import kotlinx.coroutines.delay
import java.text.SimpleDateFormat
import java.util.Date
internal const val CHAT_PET_IDENTITY_OBSTACLE_PREFIX = "chat-message-identity:"
@OptIn(ExperimentalFoundationApi::class)
@Composable
fun MessageBubble(
@@ -96,16 +109,23 @@ fun MessageBubble(
retainStreamingLayout: Boolean = false,
onCopyMessage: (String) -> Unit = {},
/**
* Quote this message into the input field. Null hides the Quote entry in
* the long-press menu, so legacy call sites keep the copy-only behavior.
* Select this message as a structured composer quote. Null hides Quote.
*/
onQuoteMessage: ((String) -> Unit)? = null,
onQuoteMessage: ((ChatMessage) -> Unit)? = null,
/** Navigate a rendered quote chip to its original message id. */
onNavigateToMessage: ((String) -> Unit)? = null,
/** Open an upstream @session:<profile>/<id> reference in app. */
onSessionReference: ((SessionReference) -> Unit)? = null,
/** React to the newest message for this role; null removes the reaction. */
onReact: ((String?) -> Unit)? = null,
/**
* Reads a completed assistant response through the active voice renderer.
* Null hides the entry; the owning screen uses that to limit the action to
* idle Conversation voice sessions.
*/
onSpeakMessage: ((String) -> Unit)? = null,
/** Stops a message-context narration currently owned by the voice pipeline. */
onStopSpeaking: (() -> Unit)? = null,
/**
* Invoked when the user taps a FAILED inbound attachment card.
* `attachmentIndex` is the position in [ChatMessage.attachments] so the
@@ -151,9 +171,11 @@ fun MessageBubble(
imageGenerationRotationIndex: Int = 0,
petVisitTargetKey: String? = null,
petPerchKey: String? = null,
animationEnabled: Boolean = true,
) {
val isUser = message.role == MessageRole.USER
val isSystem = message.role == MessageRole.SYSTEM
val sessionReferences = remember(message.content) { parseSessionReferences(message.content) }
// Phone/voice-origin action bubble marker.
//
@@ -204,18 +226,19 @@ fun MessageBubble(
val alignment = if (isUser) Alignment.End else Alignment.Start
val locale = LocalLocale.current.platformLocale
val timeFormat = remember(locale) { SimpleDateFormat("h:mm a", locale) }
val a11yDescription = "${message.role.name.lowercase()} message: ${message.content.take(100)}"
val quoteEnvelope = remember(message.content) { parseChatQuotedPrompt(message.content) }
val visibleMessageContent = quoteEnvelope?.body ?: message.content
val isDarkTheme = LocalBrand.current.isDark
// Pull generated/inline image links (`![alt](src)`) out of assistant
// content so they render as real images (remote URLs via Coil) or a
// graceful inline notice — not the blank element the markdown renderer
// emits for an image link. User/system bubbles keep their raw content.
val (markdownBody, inlineImages) = remember(message.content, isUser, isSystem) {
val (markdownBody, inlineImages) = remember(visibleMessageContent, isUser, isSystem) {
if (isUser || isSystem) {
message.content to emptyList()
visibleMessageContent to emptyList()
} else {
extractChatInlineImages(message.content)
extractChatInlineImages(visibleMessageContent)
}
}
val showImageGeneration = shouldShowImageGenerationPlaceholder(
@@ -223,6 +246,26 @@ fun MessageBubble(
isStreaming = message.isStreaming,
hasMediaResult = message.attachments.isNotEmpty() || inlineImages.isNotEmpty(),
)
val streamingStatusLabel = if (
!isUser &&
!isSystem &&
message.isStreaming &&
message.content.isBlank() &&
!showImageGeneration
) {
if (recoveringAnswer) {
stringResource(R.string.msg_bubble_reconnecting)
} else {
stringResource(R.string.msg_bubble_still_working)
}
} else {
null
}
val a11yDescription = buildString {
append(message.role.name.lowercase())
append(" message: ")
append(streamingStatusLabel ?: visibleMessageContent.take(100))
}
val hasImageGenerationCall = remember(message.toolCalls) {
message.toolCalls.any {
it.name.trim().lowercase() == "image_generate"
@@ -251,52 +294,36 @@ fun MessageBubble(
val blurMode by blurRepo.blurMode.collectAsState(initial = BlurMode.FLAGGED)
CompositionLocalProvider(LocalMediaBlurMode provides blurMode) {
// The active profile image is sender identity, distinct from both the
// floating pet companion and the ambient Sphere. Reserve one stable gutter
// for an assistant run and render the identity only on its first message.
Row(
Column(
modifier = modifier.fillMaxWidth(),
verticalAlignment = Alignment.Top,
horizontalAlignment = alignment,
) {
if (!isUser && !isSystem) {
Box(
modifier = Modifier.width(40.dp),
contentAlignment = Alignment.TopCenter,
) {
if (shouldShowMessageGroupAvatar(
isUser = isUser,
isSystem = isSystem,
isFirstInGroup = isFirstInGroup,
agentName = message.agentName,
)
// Keep sender identity in the first-message label rather than a
// persistent leading column. Long responses and every follow-up in the
// group therefore retain the full bubble-width allowance.
if (!isUser && !isSystem && isFirstInGroup && !message.agentName.isNullOrBlank()) {
Row(
verticalAlignment = Alignment.CenterVertically,
horizontalArrangement = Arrangement.spacedBy(6.dp),
modifier = Modifier
.padding(bottom = 3.dp, start = 4.dp)
.petObstacleSurface(
key = "$CHAT_PET_IDENTITY_OBSTACLE_PREFIX${message.uiKey}",
routes = setOf("chat"),
),
) {
Surface(
// Decorative: the adjacent visible agent name already owns
// the identity announcement, avoiding duplicate TalkBack copy.
modifier = Modifier.size(32.dp),
modifier = Modifier.size(24.dp),
shape = CircleShape,
color = MaterialTheme.colorScheme.primary,
) {
AgentAvatarFace(
name = message.agentName.orEmpty(),
letterStyle = MaterialTheme.typography.labelMedium,
letterStyle = MaterialTheme.typography.labelSmall,
)
}
}
}
}
Column(
modifier = Modifier.weight(1f),
horizontalAlignment = alignment
) {
// Agent name label sits beside the first group identity avatar. Pet
// companions never enter this row.
if (!isUser && !isSystem && isFirstInGroup && !message.agentName.isNullOrBlank()) {
Row(
verticalAlignment = Alignment.CenterVertically,
horizontalArrangement = Arrangement.spacedBy(4.dp),
modifier = Modifier.padding(bottom = 2.dp, start = 4.dp),
) {
Text(
text = localizeAgentName(message.agentName),
style = MaterialTheme.typography.labelSmall,
@@ -331,7 +358,7 @@ fun MessageBubble(
}
// Thinking block (above the bubble, only for assistant messages)
if (!isUser && showThinking && message.thinkingContent.isNotEmpty()) {
if (!isUser && showThinking && message.thinkingContent.isNotBlank()) {
ThinkingBlock(
thinkingContent = message.thinkingContent,
isStreaming = message.isThinkingStreaming,
@@ -380,12 +407,22 @@ fun MessageBubble(
// carries only thinking and/or tool calls (both rendered OUTSIDE
// this Surface — the ThinkingBlock above, the tool pills as separate
// rows) would otherwise paint a bare timestamp-only chip between the
// Thought-process block and the tool pill. Keep the bubble while
// streaming (StreamingDots is the live "working" indicator) and
// whenever there are cards/attachments to render inside it.
// Thought-process block and the tool pill. The first-token working state
// is rendered directly in the conversation
// lane below, without an opaque bubble. Cards and attachments still own
// a normal bubble even when response prose has not arrived yet.
streamingStatusLabel?.let { streamingStatus ->
StandaloneStreamingStatus(
status = streamingStatus,
accessibilityDescription = a11yDescription,
textColor = textColor,
modifier = Modifier.padding(start = 12.dp, top = 4.dp, bottom = 6.dp),
)
}
val showBubble = isUser || isSystem ||
message.content.isNotBlank() ||
message.isStreaming ||
visibleMessageContent.isNotBlank() ||
quoteEnvelope != null ||
showImageGeneration ||
message.cards.isNotEmpty() ||
message.attachments.isNotEmpty() ||
@@ -400,19 +437,25 @@ fun MessageBubble(
modifier = Modifier
.padding(top = 8.dp, bottom = 8.dp, end = 6.dp)
.width(3.dp)
.height(if (message.content.isBlank()) 14.dp else 24.dp)
.height(if (visibleMessageContent.isBlank()) 14.dp else 24.dp)
.clip(CircleShape)
.background(MaterialTheme.colorScheme.tertiary.copy(alpha = 0.85f))
)
}
// Long-press opens a compact action menu when a quote handler is
// wired; with copy as the only action it stays a direct copy so the
// one-action case doesn't pay a menu tap.
Column(horizontalAlignment = alignment) {
// A normal tap reveals the compact action strip. Long-press preserves
// the existing overflow menu (or direct-copy shortcut when Copy is the
// only available action).
var showMessageActions by remember { mutableStateOf(false) }
var showInlineActions by remember(message.uiKey) { mutableStateOf(false) }
val haptic = LocalHapticFeedback.current
val accessibleMotion = rememberAccessibleMotionState()
val animateInlineActions = animationEnabled && accessibleMotion.osAnimations &&
!accessibleMotion.touchExploration
val showEditAction = onEditMessage != null && isUser
val showSpeakAction = shouldShowSpeakResponseAction(message, onSpeakMessage != null)
if (onQuoteMessage != null || showEditAction || showSpeakAction) {
val showStopSpeakingAction = shouldShowStopSpeakingAction(message, onStopSpeaking != null)
if (onQuoteMessage != null || onReact != null || showEditAction || showSpeakAction || showStopSpeakingAction) {
DropdownMenu(
expanded = showMessageActions,
onDismissRequest = { showMessageActions = false },
@@ -421,7 +464,7 @@ fun MessageBubble(
text = { Text(stringResource(R.string.msg_bubble_copy)) },
onClick = {
showMessageActions = false
onCopyMessage(message.content)
onCopyMessage(visibleMessageContent)
},
)
if (onQuoteMessage != null) {
@@ -429,7 +472,7 @@ fun MessageBubble(
text = { Text(stringResource(R.string.msg_bubble_quote)) },
onClick = {
showMessageActions = false
onQuoteMessage(message.content)
onQuoteMessage(message.copy(content = visibleMessageContent))
},
)
}
@@ -444,7 +487,22 @@ fun MessageBubble(
},
onClick = {
showMessageActions = false
onSpeakMessage?.invoke(message.content)
onSpeakMessage?.invoke(visibleMessageContent)
},
)
}
if (showStopSpeakingAction) {
DropdownMenuItem(
text = { Text(stringResource(R.string.msg_bubble_stop_speaking)) },
leadingIcon = {
Icon(
imageVector = Icons.Filled.Stop,
contentDescription = null,
)
},
onClick = {
showMessageActions = false
onStopSpeaking?.invoke()
},
)
}
@@ -493,16 +551,19 @@ fun MessageBubble(
} else Modifier
)
.combinedClickable(
onClick = {},
onClick = { showInlineActions = !showInlineActions },
onLongClick = {
// Buzz the instant the long-press registers — opening the
// action menu is the discoverability moment, so it gets the
// same tactile confirm every chat app fires.
haptic.performHapticFeedback(HapticFeedbackType.LongPress)
if (onQuoteMessage != null || showEditAction || showSpeakAction) {
if (
onQuoteMessage != null || showEditAction || showSpeakAction ||
showStopSpeakingAction
) {
showMessageActions = true
} else {
onCopyMessage(message.content)
onCopyMessage(visibleMessageContent)
}
}
)
@@ -528,12 +589,23 @@ fun MessageBubble(
}
)
) {
Column(modifier = Modifier.padding(horizontal = 14.dp, vertical = 9.dp)) {
Column(
modifier = Modifier.padding(horizontal = 14.dp, vertical = 9.dp),
) {
quoteEnvelope?.let { envelope ->
ChatQuoteReferenceChip(
reference = envelope.reference,
onOpenOriginal = onNavigateToMessage?.let { navigate ->
{ navigate(envelope.reference.messageId) }
},
modifier = Modifier.padding(bottom = 7.dp),
)
}
val messageTextContent: @Composable () -> Unit = {
if (isUser || isSystem) {
// Plain text for user and system messages
Text(
text = message.content,
text = visibleMessageContent,
style = MaterialTheme.typography.bodyMedium.copy(
fontSize = 15.sp,
lineHeight = 21.sp,
@@ -559,7 +631,7 @@ fun MessageBubble(
// a live Text node becomes a Markdown tree, or settled
// Markdown content changes its node topology, so a handle
// cannot keep pointing at a removed selectable.
if (showSpeakAction) {
if (showSpeakAction || showStopSpeakingAction) {
DisableSelection { messageTextContent() }
} else {
key(
@@ -573,6 +645,35 @@ fun MessageBubble(
SelectionContainer { messageTextContent() }
}
}
if (onReact != null) {
listOf("👍", "❤️", "😂").forEach { emoji ->
DropdownMenuItem(
text = { Text("React $emoji") },
onClick = {
showMessageActions = false
onReact(emoji)
},
)
}
DropdownMenuItem(
text = { Text("Remove reaction") },
onClick = {
showMessageActions = false
onReact(null)
},
)
}
if (onSessionReference != null && sessionReferences.isNotEmpty()) {
sessionReferences.forEach { reference ->
TextButton(
onClick = { onSessionReference(reference) },
modifier = Modifier.padding(top = 2.dp),
) {
Text("Open ${reference.label}")
}
}
}
// Inline generated images (assistant only) — rendered OUTSIDE
// the SelectionContainer (they're not selectable text). Remote
@@ -687,64 +788,6 @@ fun MessageBubble(
}
}
// Streaming indicator — only while awaiting the first token. Once
// text starts flowing, the growing reply is itself the progress
// signal, so the pulsing dots stop (Messenger/Telegram drop the
// typing bubble the moment content appears) instead of throbbing
// under the text for the whole turn.
if (
message.isStreaming &&
message.content.isBlank() &&
!showImageGeneration
) {
// After a few seconds with no content yet, escalate the bare
// dots to a labeled "Still working…" so a slow first token
// never reads as a hang on the SSE / sessions paths.
val awaitingFirstToken = message.content.isBlank()
var showStillWorking by remember(message.id) { mutableStateOf(false) }
LaunchedEffect(message.id, awaitingFirstToken) {
showStillWorking = false
if (awaitingFirstToken) {
delay(4_000)
showStillWorking = true
}
}
val thinkingIndicator = LocalThinkingIndicator.current
Row(verticalAlignment = Alignment.CenterVertically) {
when (thinkingIndicator.style) {
ThinkingIndicatorStyle.Matrix -> DotMatrixIndicator(
// Auto follows the bubble text color; accents
// come from the brand palette. The grid modulates
// its own alpha (idle dots ≈0.18, lit dots 1.0).
color = thinkingIndicator.color.toColor(autoColor = textColor),
pattern = thinkingIndicator.pattern,
animated = thinkingIndicator.animated,
modifier = Modifier.padding(top = 4.dp),
)
ThinkingIndicatorStyle.Dots -> StreamingDots(
color = textColor.copy(alpha = 0.6f),
modifier = Modifier.padding(top = 4.dp),
)
}
// During dropped-stream answer recovery the label shows
// immediately (the 4s escalation is for a slow first
// token; a recovery is already known to be slow).
if ((showStillWorking || recoveringAnswer) && awaitingFirstToken) {
Spacer(modifier = Modifier.width(8.dp))
Text(
text = if (recoveringAnswer) {
stringResource(R.string.msg_bubble_reconnecting)
} else {
stringResource(R.string.msg_bubble_still_working)
},
style = MaterialTheme.typography.labelSmall,
color = textColor.copy(alpha = 0.6f),
modifier = Modifier.padding(top = 4.dp),
)
}
}
}
// Timestamp — only on the LAST bubble of a same-author run so a
// burst of fragments doesn't stack three near-touching time labels.
// Grouping breaks on a >5min gap (ChatScreen), so every pause still
@@ -771,23 +814,17 @@ fun MessageBubble(
// message routed over the relay proactive channel). Null on every
// ordinary chat message, which render nothing here.
message.deliveryStatus?.takeIf { isUser }?.let { status ->
val label = stringResource(
when (status) {
MessageDeliveryStatus.SENDING -> R.string.msg_bubble_sending
MessageDeliveryStatus.DELIVERED -> R.string.msg_bubble_delivered
MessageDeliveryStatus.FAILED -> R.string.msg_bubble_not_sent
}
)
val alpha = when (status) {
MessageDeliveryStatus.SENDING -> 0.5f
MessageDeliveryStatus.DELIVERED -> 0.5f
MessageDeliveryStatus.FAILED -> 0.7f
}
Spacer(modifier = Modifier.height(2.dp))
Text(
text = label,
style = MaterialTheme.typography.labelSmall,
color = textColor.copy(alpha = alpha),
MessageDeliveryIndicator(
status = status,
text = MessageDeliveryIndicatorText(
sending = stringResource(R.string.msg_bubble_sending),
queued = stringResource(R.string.msg_bubble_queued),
steered = stringResource(R.string.msg_bubble_steered),
delivered = stringResource(R.string.msg_bubble_delivered),
failed = stringResource(R.string.msg_bubble_not_sent),
tapToRetry = stringResource(R.string.chat_retry),
),
)
}
@@ -801,13 +838,127 @@ fun MessageBubble(
}
}
}
val inlineActions: @Composable () -> Unit = {
MessageInlineActions(
showQuote = onQuoteMessage != null,
showSpeak = showSpeakAction,
showStopSpeaking = showStopSpeakingAction,
showEdit = showEditAction,
onCopy = {
showInlineActions = false
onCopyMessage(visibleMessageContent)
},
onQuote = {
showInlineActions = false
onQuoteMessage?.invoke(message.copy(content = visibleMessageContent))
},
onSpeak = {
showInlineActions = false
onSpeakMessage?.invoke(visibleMessageContent)
},
onStopSpeaking = {
showInlineActions = false
onStopSpeaking?.invoke()
},
onEdit = {
showInlineActions = false
onEditMessage?.invoke(message)
},
)
}
if (animateInlineActions) {
AnimatedVisibility(
visible = showInlineActions,
enter = fadeIn(tween(120)) + expandVertically(
animationSpec = tween(180, easing = LinearOutSlowInEasing),
expandFrom = Alignment.Top,
),
exit = fadeOut(tween(90)) + shrinkVertically(
animationSpec = tween(140),
shrinkTowards = Alignment.Top,
),
) {
inlineActions()
}
} else if (showInlineActions) {
inlineActions()
}
} // end Column (bubble + revealed actions)
} // end Row (bubble + optional leading accent bar)
} // end if (showBubble)
} // end content Column
} // end Row (avatar gutter + content)
} // end CompositionLocalProvider(LocalMediaBlurMode)
}
@Composable
private fun MessageInlineActions(
showQuote: Boolean,
showSpeak: Boolean,
showStopSpeaking: Boolean,
showEdit: Boolean,
onCopy: () -> Unit,
onQuote: () -> Unit,
onSpeak: () -> Unit,
onStopSpeaking: () -> Unit,
onEdit: () -> Unit,
) {
Surface(
shape = RoundedCornerShape(12.dp),
color = MaterialTheme.colorScheme.surfaceContainerHigh,
tonalElevation = 2.dp,
modifier = Modifier.padding(top = 2.dp),
) {
Row(
verticalAlignment = Alignment.CenterVertically,
modifier = Modifier.padding(horizontal = 2.dp),
) {
IconButton(onClick = onCopy, modifier = Modifier.size(48.dp)) {
Icon(
imageVector = Icons.Filled.ContentCopy,
contentDescription = stringResource(R.string.msg_bubble_copy),
modifier = Modifier.size(18.dp),
)
}
if (showQuote) {
IconButton(onClick = onQuote, modifier = Modifier.size(48.dp)) {
Icon(
imageVector = Icons.Filled.FormatQuote,
contentDescription = stringResource(R.string.msg_bubble_quote),
modifier = Modifier.size(18.dp),
)
}
}
if (showSpeak) {
IconButton(onClick = onSpeak, modifier = Modifier.size(48.dp)) {
Icon(
imageVector = Icons.AutoMirrored.Filled.VolumeUp,
contentDescription = stringResource(R.string.msg_bubble_speak_response),
modifier = Modifier.size(18.dp),
)
}
}
if (showStopSpeaking) {
IconButton(onClick = onStopSpeaking, modifier = Modifier.size(48.dp)) {
Icon(
imageVector = Icons.Filled.Stop,
contentDescription = stringResource(R.string.msg_bubble_stop_speaking),
modifier = Modifier.size(18.dp),
)
}
}
if (showEdit) {
IconButton(onClick = onEdit, modifier = Modifier.size(48.dp)) {
Icon(
imageVector = Icons.Filled.Edit,
contentDescription = stringResource(R.string.msg_bubble_edit),
modifier = Modifier.size(18.dp),
)
}
}
}
}
}
internal data class MessageSelectionTopologyKey(
val renderer: String,
val markdownBody: String?,
@@ -881,6 +1032,15 @@ internal fun shouldShowSpeakResponseAction(
!message.isStreaming &&
message.content.isNotBlank()
internal fun shouldShowStopSpeakingAction(
message: ChatMessage,
handlerAvailable: Boolean,
): Boolean =
handlerAvailable &&
message.role == MessageRole.ASSISTANT &&
!message.isStreaming &&
message.content.isNotBlank()
internal fun shouldShowMessageGroupAvatar(
isUser: Boolean,
isSystem: Boolean,
@@ -918,6 +1078,42 @@ private fun MessagePathBadge(text: String, leadingIcon: ImageVector? = null) {
}
}
/** First-token progress rendered in the conversation lane, not inside a message bubble. */
@Composable
private fun StandaloneStreamingStatus(
status: String,
accessibilityDescription: String,
textColor: Color,
modifier: Modifier = Modifier,
) {
val thinkingIndicator = LocalThinkingIndicator.current
Column(
horizontalAlignment = Alignment.CenterHorizontally,
verticalArrangement = Arrangement.spacedBy(5.dp),
modifier = modifier.clearAndSetSemantics {
contentDescription = accessibilityDescription
},
) {
when (thinkingIndicator.style) {
ThinkingIndicatorStyle.Matrix -> DotMatrixIndicator(
color = thinkingIndicator.color.toColor(autoColor = textColor),
pattern = thinkingIndicator.pattern,
animated = thinkingIndicator.animated,
)
ThinkingIndicatorStyle.Dots -> StreamingDots(
color = textColor.copy(alpha = 0.6f),
)
}
Text(
text = status,
style = MaterialTheme.typography.labelSmall,
color = textColor.copy(alpha = 0.68f),
maxLines = 2,
overflow = TextOverflow.Ellipsis,
)
}
}
/**
* Three dots that animate opacity in sequence to indicate streaming is in progress.
*/
@@ -0,0 +1,167 @@
package com.hermesandroid.relay.ui.components
import androidx.compose.foundation.clickable
import androidx.compose.foundation.layout.Arrangement
import androidx.compose.foundation.layout.Row
import androidx.compose.foundation.layout.padding
import androidx.compose.foundation.layout.size
import androidx.compose.material.icons.Icons
import androidx.compose.material.icons.automirrored.filled.Send
import androidx.compose.material.icons.filled.Bolt
import androidx.compose.material.icons.filled.CheckCircle
import androidx.compose.material.icons.filled.ErrorOutline
import androidx.compose.material.icons.filled.Schedule
import androidx.compose.material3.Icon
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.Text
import androidx.compose.material3.minimumInteractiveComponentSize
import androidx.compose.runtime.Composable
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.graphics.vector.ImageVector
import androidx.compose.ui.semantics.LiveRegionMode
import androidx.compose.ui.semantics.Role
import androidx.compose.ui.semantics.contentDescription
import androidx.compose.ui.semantics.liveRegion
import androidx.compose.ui.semantics.semantics
import androidx.compose.ui.text.style.TextOverflow
import androidx.compose.ui.unit.dp
import com.hermesandroid.relay.data.MessageDeliveryStatus
import com.hermesandroid.relay.ui.theme.relayMetadataStyle
/**
* Localized copy for [MessageDeliveryIndicator]. Keeping copy at the call site
* lets MessageBubble use Android string resources without coupling this small
* presentation component to a particular resource catalog.
*/
data class MessageDeliveryIndicatorText(
val sending: String,
val queued: String,
val steered: String,
val delivered: String,
val failed: String,
val tapToRetry: String,
)
/**
* Compact, accessible lifecycle feedback for a user-authored chat message.
*
* Every state has both a distinct icon and a visible text label, so meaning is
* never carried by color alone. A failed state becomes a button only when
* [onRetry] is supplied; its entire 48dp row is then the retry target.
*/
@Composable
fun MessageDeliveryIndicator(
status: MessageDeliveryStatus,
text: MessageDeliveryIndicatorText,
modifier: Modifier = Modifier,
failureMessage: String? = null,
onRetry: (() -> Unit)? = null,
) {
val retryAction = onRetry.takeIf { status == MessageDeliveryStatus.FAILED }
val retryable = retryAction != null
val line = messageDeliveryStatusLine(
status = status,
text = text,
failureMessage = failureMessage,
retryable = retryable,
)
val presentation = messageDeliveryPresentation(status)
val tint = when (presentation.colorRole) {
DeliveryColorRole.NEUTRAL -> MaterialTheme.colorScheme.onSurfaceVariant
DeliveryColorRole.ACCENT -> MaterialTheme.colorScheme.primary
DeliveryColorRole.QUEUED -> MaterialTheme.colorScheme.tertiary
DeliveryColorRole.ERROR -> MaterialTheme.colorScheme.error
}
Row(
modifier = modifier
.then(
if (retryable) {
Modifier
.minimumInteractiveComponentSize()
.clickable(
role = Role.Button,
onClickLabel = text.tapToRetry,
onClick = retryAction,
)
} else {
Modifier
},
)
.semantics(mergeDescendants = true) {
contentDescription = line
liveRegion = LiveRegionMode.Polite
}
.padding(horizontal = 2.dp, vertical = 2.dp),
horizontalArrangement = Arrangement.spacedBy(4.dp),
verticalAlignment = Alignment.CenterVertically,
) {
Icon(
imageVector = presentation.icon,
contentDescription = null,
tint = tint,
modifier = Modifier.size(14.dp),
)
Text(
text = line,
style = relayMetadataStyle(),
color = tint,
maxLines = 2,
overflow = TextOverflow.Ellipsis,
)
}
}
internal fun messageDeliveryStatusLine(
status: MessageDeliveryStatus,
text: MessageDeliveryIndicatorText,
failureMessage: String? = null,
retryable: Boolean = false,
): String {
val label = when (status) {
MessageDeliveryStatus.SENDING -> text.sending
MessageDeliveryStatus.QUEUED -> text.queued
MessageDeliveryStatus.STEERED -> text.steered
MessageDeliveryStatus.DELIVERED -> text.delivered
MessageDeliveryStatus.FAILED -> text.failed
}
if (status != MessageDeliveryStatus.FAILED) return label
return buildList {
add(label)
failureMessage?.trim()?.takeIf(String::isNotEmpty)?.let(::add)
if (retryable) add(text.tapToRetry)
}.joinToString(" · ")
}
private data class DeliveryPresentation(
val icon: ImageVector,
val colorRole: DeliveryColorRole,
)
private enum class DeliveryColorRole { NEUTRAL, ACCENT, QUEUED, ERROR }
private fun messageDeliveryPresentation(status: MessageDeliveryStatus): DeliveryPresentation =
when (status) {
MessageDeliveryStatus.SENDING -> DeliveryPresentation(
icon = Icons.AutoMirrored.Filled.Send,
colorRole = DeliveryColorRole.NEUTRAL,
)
MessageDeliveryStatus.QUEUED -> DeliveryPresentation(
icon = Icons.Filled.Schedule,
colorRole = DeliveryColorRole.QUEUED,
)
MessageDeliveryStatus.STEERED -> DeliveryPresentation(
icon = Icons.Filled.Bolt,
colorRole = DeliveryColorRole.ACCENT,
)
MessageDeliveryStatus.DELIVERED -> DeliveryPresentation(
icon = Icons.Filled.CheckCircle,
colorRole = DeliveryColorRole.ACCENT,
)
MessageDeliveryStatus.FAILED -> DeliveryPresentation(
icon = Icons.Filled.ErrorOutline,
colorRole = DeliveryColorRole.ERROR,
)
}
@@ -0,0 +1,64 @@
package com.hermesandroid.relay.ui.components
import android.graphics.Bitmap
import android.graphics.BitmapFactory
import android.graphics.Matrix
import androidx.exifinterface.media.ExifInterface
import java.io.ByteArrayInputStream
internal data class ImageOrientationTransform(
val rotationDegrees: Float = 0f,
val flipHorizontal: Boolean = false,
)
internal fun imageOrientationTransform(orientation: Int): ImageOrientationTransform = when (orientation) {
ExifInterface.ORIENTATION_FLIP_HORIZONTAL -> ImageOrientationTransform(flipHorizontal = true)
ExifInterface.ORIENTATION_ROTATE_180 -> ImageOrientationTransform(rotationDegrees = 180f)
ExifInterface.ORIENTATION_FLIP_VERTICAL ->
ImageOrientationTransform(rotationDegrees = 180f, flipHorizontal = true)
ExifInterface.ORIENTATION_TRANSPOSE ->
ImageOrientationTransform(rotationDegrees = 90f, flipHorizontal = true)
ExifInterface.ORIENTATION_ROTATE_90 -> ImageOrientationTransform(rotationDegrees = 90f)
ExifInterface.ORIENTATION_TRANSVERSE ->
ImageOrientationTransform(rotationDegrees = -90f, flipHorizontal = true)
ExifInterface.ORIENTATION_ROTATE_270 -> ImageOrientationTransform(rotationDegrees = -90f)
else -> ImageOrientationTransform()
}
/**
* Decode image bytes for display and apply their EXIF orientation. BitmapFactory
* returns the stored pixel layout and otherwise leaves portrait phone photos
* sideways when the camera encoded rotation as metadata.
*/
internal fun decodeOrientedBitmap(
bytes: ByteArray,
options: BitmapFactory.Options? = null,
): Bitmap? {
if (bytes.isEmpty()) return null
val decoded = if (options == null) {
BitmapFactory.decodeByteArray(bytes, 0, bytes.size)
} else {
BitmapFactory.decodeByteArray(bytes, 0, bytes.size, options)
} ?: return null
val orientation = runCatching {
ByteArrayInputStream(bytes).use { stream ->
ExifInterface(stream).getAttributeInt(
ExifInterface.TAG_ORIENTATION,
ExifInterface.ORIENTATION_NORMAL,
)
}
}.getOrDefault(ExifInterface.ORIENTATION_NORMAL)
val transform = imageOrientationTransform(orientation)
if (transform.rotationDegrees == 0f && !transform.flipHorizontal) return decoded
val matrix = Matrix().apply {
if (transform.rotationDegrees != 0f) postRotate(transform.rotationDegrees)
if (transform.flipHorizontal) postScale(-1f, 1f)
}
return runCatching {
Bitmap.createBitmap(decoded, 0, 0, decoded.width, decoded.height, matrix, true)
}.getOrNull()?.also { oriented ->
if (oriented !== decoded) decoded.recycle()
} ?: decoded
}
@@ -0,0 +1,325 @@
package com.hermesandroid.relay.ui.components
import android.graphics.BitmapFactory
import android.util.Base64
import androidx.compose.foundation.Image
import androidx.compose.foundation.background
import androidx.compose.foundation.clickable
import androidx.compose.foundation.horizontalScroll
import androidx.compose.foundation.layout.Arrangement
import androidx.compose.foundation.layout.Box
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.Row
import androidx.compose.foundation.layout.Spacer
import androidx.compose.foundation.layout.fillMaxWidth
import androidx.compose.foundation.layout.height
import androidx.compose.foundation.layout.padding
import androidx.compose.foundation.layout.size
import androidx.compose.foundation.layout.width
import androidx.compose.foundation.rememberScrollState
import androidx.compose.foundation.shape.RoundedCornerShape
import androidx.compose.material.icons.Icons
import androidx.compose.material.icons.automirrored.filled.ArrowBack
import androidx.compose.material.icons.automirrored.filled.ArrowForward
import androidx.compose.material.icons.filled.AttachFile
import androidx.compose.material.icons.filled.BrokenImage
import androidx.compose.material.icons.filled.Close
import androidx.compose.material3.CircularProgressIndicator
import androidx.compose.material3.Icon
import androidx.compose.material3.IconButton
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.Surface
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.compose.runtime.LaunchedEffect
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.setValue
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.draw.clip
import androidx.compose.ui.graphics.ImageBitmap
import androidx.compose.ui.graphics.asImageBitmap
import androidx.compose.ui.layout.ContentScale
import androidx.compose.ui.platform.testTag
import androidx.compose.ui.res.stringResource
import androidx.compose.ui.semantics.Role
import androidx.compose.ui.semantics.contentDescription
import androidx.compose.ui.semantics.semantics
import androidx.compose.ui.text.style.TextOverflow
import androidx.compose.ui.unit.dp
import com.hermesandroid.relay.R
import com.hermesandroid.relay.data.Attachment
import com.hermesandroid.relay.data.AttachmentRenderMode
import com.hermesandroid.relay.data.AttachmentState
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.withContext
/**
* Pending files shown immediately above the chat composer.
*
* The owner keeps attachment state and handles the four stable integration
* callbacks. [onMove] receives the current and requested indices, allowing a
* ViewModel or session-owned draft store to perform one atomic reorder.
*/
@Composable
fun PendingAttachmentComposer(
attachments: List<Attachment>,
onPreview: (attachment: Attachment, index: Int) -> Unit,
onRemove: (index: Int) -> Unit,
onMove: (fromIndex: Int, toIndex: Int) -> Unit,
modifier: Modifier = Modifier,
imageDecoder: suspend (Attachment) -> ImageBitmap? = ::decodePendingAttachmentImage,
) {
if (attachments.isEmpty()) return
val attachmentLabel = stringResource(R.string.attachment_title)
Row(
modifier = modifier
.fillMaxWidth()
.horizontalScroll(rememberScrollState())
.semantics {
contentDescription = "${attachments.size} $attachmentLabel"
}
.testTag("pending-attachment-composer"),
horizontalArrangement = Arrangement.spacedBy(8.dp),
) {
attachments.forEachIndexed { index, attachment ->
PendingAttachmentItem(
attachment = attachment,
index = index,
count = attachments.size,
onPreview = { onPreview(attachment, index) },
onRemove = { onRemove(index) },
onMoveLeft = { onMove(index, index - 1) },
onMoveRight = { onMove(index, index + 1) },
imageDecoder = imageDecoder,
)
}
}
}
@Composable
private fun PendingAttachmentItem(
attachment: Attachment,
index: Int,
count: Int,
onPreview: () -> Unit,
onRemove: () -> Unit,
onMoveLeft: () -> Unit,
onMoveRight: () -> Unit,
imageDecoder: suspend (Attachment) -> ImageBitmap?,
) {
var previewState by remember(attachment.content, attachment.cachedUri, attachment.state) {
mutableStateOf(initialPreviewState(attachment))
}
LaunchedEffect(attachment.content, attachment.cachedUri, attachment.state) {
if (attachment.isImage && attachment.state == AttachmentState.LOADED) {
previewState = PendingPreviewState.Loading
previewState = imageDecoder(attachment)?.let(PendingPreviewState::Ready)
?: PendingPreviewState.Failed
}
}
val name = attachment.fileName?.takeIf(String::isNotBlank)
?: stringResource(R.string.attachment_title)
val type = attachmentTypeLabel(attachment.renderMode)
val size = attachment.fileSize?.let { formatAttachmentSize(it) }
val status = when (previewState) {
PendingPreviewState.Loading -> stringResource(R.string.pending_attachment_status_loading)
is PendingPreviewState.Ready -> stringResource(R.string.pending_attachment_status_ready)
PendingPreviewState.Failed -> attachment.errorMessage?.takeIf(String::isNotBlank)
?: stringResource(R.string.pending_attachment_status_failed)
}
val summary = listOfNotNull(name, type, size, status).joinToString(", ")
val previewEnabled = previewState is PendingPreviewState.Ready
Surface(
modifier = Modifier
.width(216.dp)
.semantics { contentDescription = summary }
.clip(RoundedCornerShape(14.dp))
.clickable(
enabled = previewEnabled,
onClickLabel = stringResource(R.string.pending_attachment_preview_named, name),
role = Role.Button,
onClick = onPreview,
)
.testTag("pending-attachment-$index"),
shape = RoundedCornerShape(14.dp),
color = MaterialTheme.colorScheme.surfaceVariant,
) {
Column(modifier = Modifier.padding(8.dp)) {
Row(verticalAlignment = Alignment.CenterVertically) {
PendingAttachmentThumbnail(previewState)
Spacer(Modifier.width(8.dp))
Column(modifier = Modifier.weight(1f)) {
Text(
text = name,
style = MaterialTheme.typography.labelLarge,
maxLines = 1,
overflow = TextOverflow.Ellipsis,
)
Text(
text = listOfNotNull(type, size).joinToString(" · "),
style = MaterialTheme.typography.labelSmall,
color = MaterialTheme.colorScheme.onSurfaceVariant,
maxLines = 1,
overflow = TextOverflow.Ellipsis,
)
Text(
text = status,
style = MaterialTheme.typography.labelSmall,
color = if (previewState == PendingPreviewState.Failed) {
MaterialTheme.colorScheme.error
} else {
MaterialTheme.colorScheme.onSurfaceVariant
},
)
}
}
Spacer(Modifier.height(4.dp))
Row(
modifier = Modifier.fillMaxWidth(),
horizontalArrangement = Arrangement.End,
) {
IconButton(
onClick = onMoveLeft,
enabled = index > 0,
modifier = Modifier
.size(48.dp)
.testTag("pending-attachment-move-left-$index"),
) {
Icon(
Icons.AutoMirrored.Filled.ArrowBack,
contentDescription = stringResource(R.string.pending_attachment_move_left, name),
)
}
IconButton(
onClick = onMoveRight,
enabled = index < count - 1,
modifier = Modifier
.size(48.dp)
.testTag("pending-attachment-move-right-$index"),
) {
Icon(
Icons.AutoMirrored.Filled.ArrowForward,
contentDescription = stringResource(R.string.pending_attachment_move_right, name),
)
}
IconButton(
onClick = onRemove,
modifier = Modifier
.size(48.dp)
.testTag("pending-attachment-remove-$index"),
) {
Icon(
Icons.Filled.Close,
contentDescription = stringResource(R.string.pending_attachment_remove, name),
)
}
}
}
}
}
@Composable
private fun PendingAttachmentThumbnail(state: PendingPreviewState) {
Box(
modifier = Modifier
.size(64.dp)
.clip(RoundedCornerShape(10.dp))
.background(MaterialTheme.colorScheme.surface),
contentAlignment = Alignment.Center,
) {
when (state) {
PendingPreviewState.Loading -> CircularProgressIndicator(
modifier = Modifier.size(24.dp),
strokeWidth = 2.dp,
)
is PendingPreviewState.Ready -> if (state.bitmap != null) {
Image(
bitmap = state.bitmap,
contentDescription = null,
contentScale = ContentScale.Crop,
modifier = Modifier.size(64.dp),
)
} else {
Icon(Icons.Filled.AttachFile, contentDescription = null)
}
PendingPreviewState.Failed -> Icon(
Icons.Filled.BrokenImage,
contentDescription = null,
tint = MaterialTheme.colorScheme.error,
)
}
}
}
@Composable
private fun attachmentTypeLabel(mode: AttachmentRenderMode): String = stringResource(
when (mode) {
AttachmentRenderMode.IMAGE -> R.string.attachment_type_image
AttachmentRenderMode.VIDEO -> R.string.attachment_type_video
AttachmentRenderMode.AUDIO -> R.string.attachment_type_audio
AttachmentRenderMode.PDF -> R.string.attachment_type_pdf
AttachmentRenderMode.TEXT -> R.string.attachment_type_text
AttachmentRenderMode.GENERIC -> R.string.attachment_type_file
},
)
private fun initialPreviewState(attachment: Attachment): PendingPreviewState = when {
attachment.state == AttachmentState.FAILED -> PendingPreviewState.Failed
attachment.state == AttachmentState.LOADING -> PendingPreviewState.Loading
attachment.isImage -> PendingPreviewState.Loading
else -> PendingPreviewState.Ready(bitmap = null)
}
@Composable
internal fun formatAttachmentSize(bytes: Long): String {
val safeBytes = bytes.coerceAtLeast(0)
return when {
safeBytes >= 1024L * 1024L * 1024L -> stringResource(
R.string.media_bytes_gb,
safeBytes / (1024.0 * 1024.0 * 1024.0),
)
safeBytes >= 1024L * 1024L -> stringResource(
R.string.media_bytes_mb,
safeBytes / (1024.0 * 1024.0),
)
safeBytes >= 1024L -> stringResource(R.string.media_bytes_kb, safeBytes / 1024.0)
else -> stringResource(R.string.media_bytes_b, safeBytes)
}
}
private suspend fun decodePendingAttachmentImage(attachment: Attachment): ImageBitmap? =
withContext(Dispatchers.IO) {
runCatching {
val bytes = Base64.decode(attachment.content, Base64.DEFAULT)
if (bytes.isEmpty()) return@runCatching null
val bounds = BitmapFactory.Options().apply { inJustDecodeBounds = true }
BitmapFactory.decodeByteArray(bytes, 0, bytes.size, bounds)
if (bounds.outWidth <= 0 || bounds.outHeight <= 0) return@runCatching null
var sample = 1
while (
bounds.outWidth / sample > PENDING_ATTACHMENT_THUMBNAIL_TARGET_PX ||
bounds.outHeight / sample > PENDING_ATTACHMENT_THUMBNAIL_TARGET_PX
) {
sample *= 2
}
decodeOrientedBitmap(
bytes,
BitmapFactory.Options().apply { inSampleSize = sample },
)?.asImageBitmap()
}.getOrNull()
}
private sealed interface PendingPreviewState {
data object Loading : PendingPreviewState
data class Ready(val bitmap: ImageBitmap?) : PendingPreviewState
data object Failed : PendingPreviewState
}
private const val PENDING_ATTACHMENT_THUMBNAIL_TARGET_PX = 256
@@ -0,0 +1,527 @@
package com.hermesandroid.relay.ui.components
import androidx.compose.foundation.BorderStroke
import androidx.compose.foundation.ExperimentalFoundationApi
import androidx.compose.foundation.combinedClickable
import androidx.compose.foundation.horizontalScroll
import androidx.compose.foundation.verticalScroll
import androidx.compose.foundation.layout.Arrangement
import androidx.compose.foundation.layout.Box
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.Row
import androidx.compose.foundation.layout.Spacer
import androidx.compose.foundation.layout.fillMaxWidth
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.foundation.layout.heightIn
import androidx.compose.foundation.layout.padding
import androidx.compose.foundation.layout.size
import androidx.compose.foundation.layout.widthIn
import androidx.compose.foundation.rememberScrollState
import androidx.compose.foundation.selection.selectable
import androidx.compose.foundation.shape.CircleShape
import androidx.compose.foundation.shape.RoundedCornerShape
import androidx.compose.material.icons.Icons
import androidx.compose.material.icons.automirrored.filled.KeyboardArrowRight
import androidx.compose.material.icons.filled.Check
import androidx.compose.material.icons.filled.Home
import androidx.compose.material.icons.filled.Lock
import androidx.compose.material.icons.filled.MoreHoriz
import androidx.compose.material.icons.filled.Person
import androidx.compose.material.icons.filled.Tune
import androidx.compose.material.icons.filled.Visibility
import androidx.compose.material.icons.filled.VisibilityOff
import androidx.compose.material3.AlertDialog
import androidx.compose.material3.ExperimentalMaterial3Api
import androidx.compose.material3.HorizontalDivider
import androidx.compose.material3.Icon
import androidx.compose.material3.IconButton
import androidx.compose.material3.ListItem
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.ModalBottomSheet
import androidx.compose.material3.Surface
import androidx.compose.material3.Text
import androidx.compose.material3.TextButton
import androidx.compose.runtime.Composable
import androidx.compose.runtime.collectAsState
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.setValue
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.draw.clip
import androidx.compose.ui.layout.ContentScale
import androidx.compose.ui.res.stringResource
import androidx.compose.ui.semantics.Role
import androidx.compose.ui.semantics.contentDescription
import androidx.compose.ui.semantics.disabled
import androidx.compose.ui.semantics.semantics
import androidx.compose.ui.text.font.FontWeight
import androidx.compose.ui.text.style.TextOverflow
import androidx.compose.ui.unit.dp
import coil3.compose.AsyncImage
import com.hermesandroid.relay.R
import com.hermesandroid.relay.data.AgentDisplay
import com.hermesandroid.relay.data.Profile
import com.hermesandroid.relay.data.ProfilePresentation
import com.hermesandroid.relay.data.ProfilePresentationPolicy
import com.hermesandroid.relay.viewmodel.ConnectionViewModel
import java.io.File
data class ProfileChoice(
val key: String,
val profile: Profile?,
) {
val isServerDefault: Boolean get() = key == AgentDisplay.SERVER_DEFAULT_PROFILE_KEY
}
object ProfileShelfPolicy {
fun choices(
profiles: List<Profile>,
presentation: ProfilePresentation,
selectedProfileName: String?,
): List<ProfileChoice> {
val selectedKey = AgentDisplay.profileSessionKey(selectedProfileName)
return ProfilePresentationPolicy
.visibleKeys(profiles, presentation, selectedKey)
.mapNotNull { key ->
if (key == AgentDisplay.SERVER_DEFAULT_PROFILE_KEY) {
ProfileChoice(key, null)
} else {
profiles.firstOrNull { it.name == key }?.let { ProfileChoice(key, it) }
}
}
}
fun canSwitch(isStreaming: Boolean, streamingEndpoint: String): Boolean =
!isStreaming || streamingEndpoint == "gateway"
fun isSelected(choice: ProfileChoice, selectedProfileName: String?): Boolean =
choice.key == AgentDisplay.profileSessionKey(selectedProfileName)
/** Local presentation assets follow the selected choice key, not the sticky profile it resolves to. */
fun iconProfileName(choice: ProfileChoice): String? = choice.profile?.name
}
@OptIn(ExperimentalFoundationApi::class)
@Composable
fun ProfileShelf(
connectionViewModel: ConnectionViewModel,
profiles: List<Profile>,
selectedProfile: Profile?,
resolvedProfile: Profile?,
presentation: ProfilePresentation,
activeDisplayName: String,
isProfileLocked: Boolean,
lockedProfileName: String?,
switchEnabled: Boolean,
onSelect: (Profile?) -> Unit,
onOpenPassport: () -> Unit,
onOpenSwitcher: () -> Unit,
onInspect: (String) -> Unit,
onLock: (Profile?) -> Unit,
onUnlock: () -> Unit,
onHide: (String?) -> Unit,
modifier: Modifier = Modifier,
) {
val choices = remember(profiles, presentation, selectedProfile?.name) {
ProfileShelfPolicy.choices(profiles, presentation, selectedProfile?.name)
}
if (choices.size <= 1) return
var actionChoice by remember { mutableStateOf<ProfileChoice?>(null) }
val lockedKey = lockedProfileName ?: AgentDisplay.SERVER_DEFAULT_PROFILE_KEY
Surface(
modifier = modifier.fillMaxWidth(),
color = MaterialTheme.colorScheme.surface,
tonalElevation = 0.dp,
) {
Column {
Row(
modifier = Modifier
.fillMaxWidth()
.heightIn(min = 55.dp)
.padding(start = 8.dp, end = 4.dp, top = 3.dp, bottom = 3.dp),
verticalAlignment = Alignment.CenterVertically,
) {
Row(
modifier = Modifier
.weight(1f)
.horizontalScroll(rememberScrollState()),
horizontalArrangement = Arrangement.spacedBy(6.dp),
verticalAlignment = Alignment.CenterVertically,
) {
choices.forEach { choice ->
val selected = ProfileShelfPolicy.isSelected(choice, selectedProfile?.name)
val label = if (selected) {
activeDisplayName
} else {
profileChoiceLabel(choice, resolvedProfile)
}
if (selected) {
val openPassportDescription = stringResource(R.string.profile_shelf_open_passport)
Box(
modifier = Modifier
.heightIn(min = 48.dp)
.widthIn(max = 190.dp)
.combinedClickable(
role = Role.Button,
onClick = onOpenPassport,
onLongClick = { actionChoice = choice },
)
.semantics {
contentDescription = "$label. $openPassportDescription"
},
contentAlignment = Alignment.Center,
) {
Surface(
shape = RoundedCornerShape(22.dp),
color = MaterialTheme.colorScheme.surfaceContainerLow,
border = BorderStroke(
1.dp,
MaterialTheme.colorScheme.primary.copy(alpha = 0.72f),
),
) {
Row(
modifier = Modifier.padding(horizontal = 7.dp, vertical = 4.dp),
verticalAlignment = Alignment.CenterVertically,
horizontalArrangement = Arrangement.spacedBy(7.dp),
) {
ProfileChoiceAvatar(
connectionViewModel,
choice,
resolvedProfile,
label,
36,
)
Text(
text = label,
modifier = Modifier.weight(1f, fill = false),
style = MaterialTheme.typography.labelLarge,
fontWeight = FontWeight.SemiBold,
maxLines = 1,
overflow = TextOverflow.Ellipsis,
)
Icon(
Icons.AutoMirrored.Filled.KeyboardArrowRight,
contentDescription = null,
modifier = Modifier.size(18.dp),
tint = MaterialTheme.colorScheme.onSurfaceVariant,
)
}
}
}
} else {
val enabled = switchEnabled && !isProfileLocked
val switchToDescription = stringResource(R.string.profile_shelf_switch_to)
Box(
modifier = Modifier
.size(48.dp)
.clip(CircleShape)
.combinedClickable(
enabled = true,
role = Role.Button,
onClick = { if (enabled) onSelect(choice.profile) },
onLongClick = { actionChoice = choice },
)
.semantics {
if (!enabled) disabled()
contentDescription = if (enabled) {
"$label. $switchToDescription"
} else {
label
}
},
contentAlignment = Alignment.Center,
) {
ProfileChoiceAvatar(
connectionViewModel,
choice,
resolvedProfile,
label,
36,
)
}
}
}
}
IconButton(
onClick = onOpenSwitcher,
modifier = Modifier.size(48.dp),
) {
Surface(
modifier = Modifier.size(40.dp),
shape = CircleShape,
color = MaterialTheme.colorScheme.surfaceContainerLow,
border = BorderStroke(
1.dp,
MaterialTheme.colorScheme.outlineVariant.copy(alpha = 0.42f),
),
) {
Box(contentAlignment = Alignment.Center) {
Icon(
Icons.Filled.MoreHoriz,
contentDescription = stringResource(R.string.profile_shelf_all_profiles),
modifier = Modifier.size(20.dp),
)
}
}
}
}
HorizontalDivider(color = MaterialTheme.colorScheme.outlineVariant.copy(alpha = 0.32f))
}
}
actionChoice?.let { choice ->
val selected = ProfileShelfPolicy.isSelected(choice, selectedProfile?.name)
val target = choice.profile ?: resolvedProfile
val label = profileChoiceLabel(choice, resolvedProfile)
ProfileShelfActionsDialog(
label = label,
canSwitch = switchEnabled && !isProfileLocked,
selected = selected,
canInspect = target != null,
lockedToChoice = isProfileLocked && lockedKey == choice.key,
onInspect = {
actionChoice = null
target?.name?.let(onInspect)
},
onPassport = {
actionChoice = null
if (!selected && switchEnabled && !isProfileLocked) onSelect(choice.profile)
onOpenPassport()
},
onToggleLock = {
actionChoice = null
if (isProfileLocked && lockedKey == choice.key) onUnlock() else onLock(choice.profile)
},
onHide = {
actionChoice = null
onHide(choice.profile?.name)
},
onDismiss = { actionChoice = null },
)
}
}
@OptIn(ExperimentalMaterial3Api::class, ExperimentalFoundationApi::class)
@Composable
fun ProfileSwitcherSheet(
connectionViewModel: ConnectionViewModel,
profiles: List<Profile>,
selectedProfile: Profile?,
resolvedProfile: Profile?,
presentation: ProfilePresentation,
isProfileLocked: Boolean,
switchEnabled: Boolean,
onSelect: (Profile?) -> Unit,
onManageDisplay: () -> Unit,
onDismiss: () -> Unit,
) {
val choices = remember(profiles, presentation, selectedProfile?.name) {
ProfileShelfPolicy.choices(profiles, presentation, selectedProfile?.name)
}
ModalBottomSheet(onDismissRequest = onDismiss) {
Column(
modifier = Modifier
.fillMaxWidth()
.heightIn(max = 560.dp)
.verticalScroll(rememberScrollState())
.padding(bottom = 24.dp),
) {
Text(
text = stringResource(R.string.profile_shelf_switch_agent),
modifier = Modifier.padding(horizontal = 24.dp, vertical = 12.dp),
style = MaterialTheme.typography.headlineSmall,
fontWeight = FontWeight.SemiBold,
)
if (isProfileLocked) {
Text(
text = stringResource(R.string.profile_shelf_locked_hint),
modifier = Modifier.padding(horizontal = 24.dp, vertical = 4.dp),
style = MaterialTheme.typography.bodySmall,
color = MaterialTheme.colorScheme.onSurfaceVariant,
)
}
choices.forEach { choice ->
val selected = ProfileShelfPolicy.isSelected(choice, selectedProfile?.name)
val label = profileChoiceLabel(choice, resolvedProfile)
val model = choice.profile?.model?.takeIf { it.isNotBlank() }
ListItem(
modifier = Modifier.selectable(
selected = selected,
enabled = selected || (switchEnabled && !isProfileLocked),
role = Role.RadioButton,
onClick = {
if (!selected) onSelect(choice.profile)
onDismiss()
},
),
headlineContent = {
Text(label, maxLines = 1, overflow = TextOverflow.Ellipsis)
},
supportingContent = if (model != null) {
{ Text(model, maxLines = 1, overflow = TextOverflow.Ellipsis) }
} else {
null
},
leadingContent = {
ProfileChoiceAvatar(connectionViewModel, choice, resolvedProfile, label, 42)
},
trailingContent = if (selected) {
{ Icon(Icons.Filled.Check, contentDescription = null) }
} else {
null
},
)
}
HorizontalDivider(modifier = Modifier.padding(top = 8.dp))
TextButton(
onClick = onManageDisplay,
modifier = Modifier
.fillMaxWidth()
.padding(horizontal = 12.dp, vertical = 4.dp),
) {
Icon(Icons.Filled.Tune, contentDescription = null)
Spacer(Modifier.size(8.dp))
Text(stringResource(R.string.conn_info_manage_profiles))
}
}
}
}
@Composable
private fun ProfileChoiceAvatar(
connectionViewModel: ConnectionViewModel,
choice: ProfileChoice,
resolvedProfile: Profile?,
label: String,
size: Int,
) {
val iconProfileName = ProfileShelfPolicy.iconProfileName(choice)
val iconPath by connectionViewModel.profileIconFlow(iconProfileName).collectAsState(initial = null)
Box(modifier = Modifier.size(size.dp)) {
Surface(
modifier = Modifier.fillMaxSize(),
shape = CircleShape,
color = MaterialTheme.colorScheme.primary,
border = BorderStroke(
1.dp,
MaterialTheme.colorScheme.outlineVariant.copy(alpha = 0.55f),
),
) {
when {
!iconPath.isNullOrBlank() -> AsyncImage(
model = File(iconPath.orEmpty()),
contentDescription = null,
contentScale = ContentScale.Crop,
modifier = Modifier.fillMaxSize(),
)
resolvedProfile == null && choice.isServerDefault -> Box(contentAlignment = Alignment.Center) {
Icon(
Icons.Filled.Home,
contentDescription = null,
modifier = Modifier.size((size * 0.48f).dp),
tint = MaterialTheme.colorScheme.onPrimary,
)
}
else -> Box(contentAlignment = Alignment.Center) {
Text(
text = label.trim().firstOrNull()?.uppercase() ?: "H",
color = MaterialTheme.colorScheme.onPrimary,
style = MaterialTheme.typography.labelLarge,
fontWeight = FontWeight.Bold,
)
}
}
}
if (choice.isServerDefault && resolvedProfile != null) {
Surface(
modifier = Modifier
.align(Alignment.BottomStart)
.size((size * 0.38f).dp),
shape = CircleShape,
color = MaterialTheme.colorScheme.surfaceContainerHighest,
border = BorderStroke(1.dp, MaterialTheme.colorScheme.surface),
) {
Box(contentAlignment = Alignment.Center) {
Icon(
Icons.Filled.Home,
contentDescription = null,
modifier = Modifier.size((size * 0.22f).dp),
tint = MaterialTheme.colorScheme.onSurface,
)
}
}
}
}
}
@Composable
private fun ProfileShelfActionsDialog(
label: String,
canSwitch: Boolean,
selected: Boolean,
canInspect: Boolean,
lockedToChoice: Boolean,
onInspect: () -> Unit,
onPassport: () -> Unit,
onToggleLock: () -> Unit,
onHide: () -> Unit,
onDismiss: () -> Unit,
) {
AlertDialog(
onDismissRequest = onDismiss,
title = { Text(label, maxLines = 1, overflow = TextOverflow.Ellipsis) },
text = {
Column {
ProfileActionRow(Icons.Filled.Visibility, stringResource(R.string.profile_shelf_inspect), canInspect, onInspect)
ProfileActionRow(
Icons.Filled.Person,
stringResource(R.string.conn_info_agent_passport),
selected || canSwitch,
onPassport,
)
ProfileActionRow(
Icons.Filled.Lock,
stringResource(if (lockedToChoice) R.string.settings_unlock else R.string.settings_profile_lock),
true,
onToggleLock,
)
ProfileActionRow(
Icons.Filled.VisibilityOff,
stringResource(R.string.profile_shelf_hide),
!selected,
onHide,
)
}
},
confirmButton = { TextButton(onClick = onDismiss) { Text(stringResource(R.string.chat_dismiss)) } },
)
}
@Composable
private fun ProfileActionRow(
icon: androidx.compose.ui.graphics.vector.ImageVector,
label: String,
enabled: Boolean,
onClick: () -> Unit,
) {
TextButton(onClick = onClick, enabled = enabled, modifier = Modifier.fillMaxWidth()) {
Icon(icon, contentDescription = null)
Spacer(Modifier.size(12.dp))
Text(label, modifier = Modifier.weight(1f))
}
}
@Composable
private fun profileChoiceLabel(choice: ProfileChoice, resolvedProfile: Profile?): String =
if (choice.isServerDefault) {
stringResource(R.string.conn_info_server_default)
} else {
choice.profile?.let(AgentDisplay::profileDisplayName)
?: choice.profile?.name?.replaceFirstChar { it.uppercase() }
?: resolvedProfile?.let(AgentDisplay::profileDisplayName)
?: stringResource(R.string.chat_agent_default)
}
@@ -99,6 +99,11 @@ internal enum class SessionDrawerFilter {
internal const val SESSION_DRAWER_LIST_TAG = "session-drawer-list"
internal const val UNPINNED_STAR_ALPHA = 0.45f
data class ProfileSessionRow(
val profile: String,
val session: ChatSession,
)
internal fun sessionPinIcon(pinned: Boolean) =
if (pinned) Icons.Filled.Star else Icons.Outlined.StarBorder
@@ -149,6 +154,10 @@ fun SessionDrawerContent(
hiddenSources: Set<String> = emptySet(),
/** Toggle a source's visibility (persisted). Null hides the source filter. */
onToggleSourceHidden: ((String, Boolean) -> Unit)? = null,
allProfileSessions: List<ProfileSessionRow> = emptyList(),
allProfileSessionsLoading: Boolean = false,
onRefreshAllProfiles: (() -> Unit)? = null,
onSelectProfileSession: ((String, String) -> Unit)? = null,
) {
var renameDialogSession by remember { mutableStateOf<ChatSession?>(null) }
var newThreadDialog by remember { mutableStateOf(false) }
@@ -157,6 +166,7 @@ fun SessionDrawerContent(
var query by remember { mutableStateOf("") }
var searchExpanded by remember { mutableStateOf(false) }
var filter by remember { mutableStateOf(SessionDrawerFilter.All) }
var allProfilesOpen by remember { mutableStateOf(false) }
val listState = rememberLazyListState()
val trimmedQuery = query.trim()
// Threads affordance shows when the capability is active OR there's already at least one
@@ -355,6 +365,16 @@ fun SessionDrawerContent(
overflow = TextOverflow.Ellipsis,
)
}
if (onRefreshAllProfiles != null && onSelectProfileSession != null) {
TextButton(
onClick = {
allProfilesOpen = true
onRefreshAllProfiles()
},
) {
Text(stringResource(R.string.drawer_all_profiles))
}
}
Spacer(modifier = Modifier.height(8.dp))
@@ -620,6 +640,72 @@ fun SessionDrawerContent(
}
)
}
if (allProfilesOpen) {
var allQuery by remember { mutableStateOf("") }
val needle = allQuery.trim()
val rows = allProfileSessions.filter { row ->
needle.isBlank() ||
row.profile.contains(needle, ignoreCase = true) ||
row.session.title.orEmpty().contains(needle, ignoreCase = true) ||
row.session.sessionId.contains(needle, ignoreCase = true)
}
AlertDialog(
onDismissRequest = { allProfilesOpen = false },
title = { Text(stringResource(R.string.drawer_all_profiles)) },
text = {
Column(modifier = Modifier.fillMaxWidth()) {
OutlinedTextField(
value = allQuery,
onValueChange = { allQuery = it },
modifier = Modifier.fillMaxWidth(),
singleLine = true,
leadingIcon = { Icon(Icons.Filled.Search, contentDescription = null) },
placeholder = { Text(stringResource(R.string.drawer_search_placeholder)) },
)
Spacer(modifier = Modifier.height(8.dp))
when {
allProfileSessionsLoading && allProfileSessions.isEmpty() ->
CircularProgressIndicator(modifier = Modifier.align(Alignment.CenterHorizontally))
rows.isEmpty() -> Text(
stringResource(R.string.drawer_no_profile_sessions),
color = MaterialTheme.colorScheme.onSurfaceVariant,
)
else -> LazyColumn(modifier = Modifier.height(420.dp)) {
items(rows, key = { "${it.profile}:${it.session.sessionId}" }) { row ->
Column(
modifier = Modifier
.fillMaxWidth()
.clickable {
allProfilesOpen = false
onSelectProfileSession?.invoke(row.profile, row.session.sessionId)
}
.padding(vertical = 10.dp, horizontal = 4.dp),
) {
Text(
row.session.title?.takeIf { it.isNotBlank() }
?: stringResource(R.string.drawer_untitled),
maxLines = 2,
overflow = TextOverflow.Ellipsis,
)
Text(
row.profile,
style = relayMetadataStyle(),
color = RelayRefresh.Relay,
)
}
}
}
}
}
},
confirmButton = {
TextButton(onClick = { allProfilesOpen = false }) {
Text(stringResource(R.string.drawer_close))
}
},
)
}
}
@Composable
@@ -0,0 +1,52 @@
package com.hermesandroid.relay.ui.components
/**
* Model identity shown by chat-scoped controls.
*
* A running/resumed session owns its runtime model. Profile and server values
* are defaults only, and may seed a fresh draft, but must never repaint an
* existing session merely because a picker or Agent Passport was opened.
*/
internal data class SessionModelUiState(
val model: String?,
val provider: String?,
val pickerModel: String?,
val pickerProvider: String?,
val inheritsProfileDefault: Boolean,
)
internal fun resolveSessionModelUiState(
hasSession: Boolean,
pendingModel: String?,
pendingProvider: String?,
gatewayModel: String?,
gatewayProvider: String?,
persistedSessionModel: String?,
profileDefaultModel: String?,
serverDefaultModel: String?,
): SessionModelUiState {
fun String?.present(): String? = this?.trim()?.takeIf(String::isNotEmpty)
val pending = pendingModel.present()
val gateway = gatewayModel.present()
val persisted = persistedSessionModel.present()
val profileDefault = profileDefaultModel.present()
val serverDefault = serverDefaultModel.present()
val effectiveModel = if (hasSession) {
pending ?: gateway ?: persisted ?: profileDefault ?: serverDefault
} else {
pending ?: profileDefault ?: gateway ?: serverDefault
}
val effectiveProvider = pendingProvider.present()
?: gatewayProvider.present()
return SessionModelUiState(
model = effectiveModel,
provider = effectiveProvider,
// A live session highlights what it is actually running. On a fresh
// draft, null remains the explicit "inherit profile default" state.
pickerModel = if (hasSession) effectiveModel else pending,
pickerProvider = if (hasSession) effectiveProvider else pendingProvider.present(),
inheritsProfileDefault = !hasSession && pending == null,
)
}
@@ -0,0 +1,41 @@
package com.hermesandroid.relay.ui.components
data class SessionReference(val profile: String, val sessionId: String) {
val label: String
get() = "$profile · ${sessionId.takeLast(10)}"
}
private val SESSION_REFERENCE = Regex("@session:([A-Za-z0-9_.-]{1,64})/([A-Za-z0-9_.:-]{1,160})")
/** Find session references outside fenced and inline code. */
internal fun parseSessionReferences(markdown: String): List<SessionReference> {
val visible = buildString(markdown.length) {
var fenced = false
markdown.lineSequence().forEach { line ->
if (line.trimStart().startsWith("```")) {
fenced = !fenced
appendLine()
} else if (fenced) {
appendLine()
} else {
var inline = false
line.forEach { char ->
if (char == '`') inline = !inline
append(if (inline || char == '`') ' ' else char)
}
appendLine()
}
}
}
return SESSION_REFERENCE.findAll(visible)
.map {
SessionReference(
it.groupValues[1],
it.groupValues[2].trimEnd('.', ',', ';', '!', '?', ')', ']', '}'),
)
}
.filter { it.sessionId.isNotBlank() }
.distinct()
.take(16)
.toList()
}
@@ -0,0 +1,96 @@
package com.hermesandroid.relay.ui.components
import android.content.Context
import android.net.Uri
import android.util.Log
import kotlinx.serialization.json.Json
import java.io.File
import java.io.InputStream
sealed interface SphereSkinImportResult {
data class Success(val id: String, val label: String) : SphereSkinImportResult
data class Failure(val reason: String) : SphereSkinImportResult
}
/** Imports one declarative sphere-skin JSON file into app-scoped local storage. */
object SphereSkinImporter {
private const val TAG = "SphereSkinImporter"
private const val MAX_BYTES = 256L * 1024L
private val json = Json {
ignoreUnknownKeys = true
isLenient = true
}
fun importUri(context: Context, uri: Uri): SphereSkinImportResult {
val input = try {
context.contentResolver.openInputStream(uri)
} catch (t: Throwable) {
Log.w(TAG, "openInputStream failed: ${t.message}")
null
} ?: return SphereSkinImportResult.Failure("Couldn't open that file.")
return input.use { importStream(it, SphereSkinLoader.userDir(context)) }
}
/** Pure import core used by tests: bounds, parses, validates, then swaps with rollback. */
internal fun importStream(input: InputStream, skinsDir: File): SphereSkinImportResult {
return try {
val bytes = readBounded(input)
?: return SphereSkinImportResult.Failure("That sphere file is too large.")
val spec = try {
json.decodeFromString(SphereSpec.serializer(), bytes.decodeToString())
} catch (_: Throwable) {
return SphereSkinImportResult.Failure("That sphere file isn't valid JSON.")
}
val resolved = spec.copy(id = spec.id.ifBlank { "custom-sphere" })
val skin = try {
resolved.toSkin()
} catch (t: Throwable) {
return SphereSkinImportResult.Failure(t.message ?: "That isn't a valid sphere skin.")
}
skinsDir.mkdirs()
val target = File(skinsDir, "${safeFileName(skin.id)}.json")
val staging = File(skinsDir, ".${target.name}.tmp")
val backup = File(skinsDir, ".${target.name}.bak")
staging.writeBytes(bytes)
if (backup.exists() && !target.exists()) backup.renameTo(target)
if (backup.exists() && target.exists()) backup.delete()
if (target.exists() && !target.renameTo(backup)) {
staging.delete()
return SphereSkinImportResult.Failure("Couldn't replace the existing sphere skin.")
}
if (!staging.renameTo(target)) {
staging.delete()
if (backup.exists()) backup.renameTo(target)
return SphereSkinImportResult.Failure("Couldn't save that sphere skin.")
}
backup.delete()
SphereSkinImportResult.Success(skin.id, skin.label)
} catch (t: Throwable) {
Log.w(TAG, "import failed: ${t.message}")
SphereSkinImportResult.Failure("Couldn't import that sphere skin.")
}
}
private fun readBounded(input: InputStream): ByteArray? {
val buffer = ByteArray(8 * 1024)
val output = java.io.ByteArrayOutputStream()
var total = 0L
while (true) {
val count = input.read(buffer)
if (count < 0) break
total += count
if (total > MAX_BYTES) return null
output.write(buffer, 0, count)
}
return output.toByteArray()
}
private fun safeFileName(id: String): String = id.trim()
.map { if (it.isLetterOrDigit() || it == '-' || it == '_' || it == '.') it else '-' }
.joinToString("")
.trim('.', '-')
.ifBlank { "custom-sphere" }
}
@@ -25,8 +25,11 @@ import androidx.compose.material.icons.filled.Close
import androidx.compose.material.icons.filled.ExpandLess
import androidx.compose.material.icons.filled.ExpandMore
import androidx.compose.material3.Icon
import androidx.compose.material3.AlertDialog
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.OutlinedTextField
import androidx.compose.material3.Text
import androidx.compose.material3.TextButton
import androidx.compose.runtime.Composable
import androidx.compose.runtime.LaunchedEffect
import androidx.compose.runtime.getValue
@@ -73,11 +76,13 @@ fun SubagentLane(
taskIndex: Int,
calls: List<ToolCall>,
modifier: Modifier = Modifier,
onSteer: ((subagentId: String, instruction: String) -> Unit)? = null,
) {
val anyRunning = calls.any { !it.isComplete }
val allComplete = calls.isNotEmpty() && calls.all { it.isComplete }
val anyFailed = calls.any { it.isComplete && it.success == false }
val runningCount = calls.count { !it.isComplete }
val steerableId = calls.firstNotNullOfOrNull { it.subagentId?.takeIf(String::isNotBlank) }
val laneLabel = calls.firstNotNullOfOrNull { call ->
call.taskLabel?.takeIf { it.isNotBlank() }
@@ -106,6 +111,8 @@ fun SubagentLane(
val failureLabel = stringResource(R.string.cd_subagent_failed)
var expanded by remember { mutableStateOf(!allComplete) }
var showSteerDialog by remember { mutableStateOf(false) }
var steerText by remember { mutableStateOf("") }
// Auto-collapse when the last child completes — same pattern as
// ToolProgressCard's LaunchedEffect(toolCall.isComplete).
@@ -162,6 +169,12 @@ fun SubagentLane(
modifier = Modifier.weight(1f),
)
if (anyRunning && steerableId != null && onSteer != null) {
TextButton(onClick = { showSteerDialog = true }) {
Text("Redirect")
}
}
Text(
text = statusMeta,
style = relayMetadataStyle(),
@@ -202,4 +215,33 @@ fun SubagentLane(
}
}
}
if (showSteerDialog && steerableId != null && onSteer != null) {
AlertDialog(
onDismissRequest = { showSteerDialog = false },
title = { Text("Redirect subagent") },
text = {
OutlinedTextField(
value = steerText,
onValueChange = { steerText = it },
label = { Text("New instruction") },
modifier = Modifier.fillMaxWidth(),
)
},
confirmButton = {
TextButton(
onClick = {
val instruction = steerText.trim()
showSteerDialog = false
steerText = ""
onSteer(steerableId, instruction)
},
enabled = steerText.isNotBlank(),
) { Text("Redirect") }
},
dismissButton = {
TextButton(onClick = { showSteerDialog = false }) { Text("Cancel") }
},
)
}
}
@@ -15,12 +15,11 @@ import androidx.compose.material.icons.Icons
import androidx.compose.material.icons.filled.ExpandLess
import androidx.compose.material.icons.filled.ExpandMore
import androidx.compose.material.icons.filled.Psychology
import androidx.compose.material3.Card
import androidx.compose.material3.CardDefaults
import androidx.compose.material3.Icon
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.compose.runtime.LaunchedEffect
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
@@ -29,6 +28,9 @@ import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.platform.LocalLocale
import androidx.compose.ui.res.stringResource
import androidx.compose.ui.semantics.Role
import androidx.compose.ui.semantics.stateDescription
import androidx.compose.ui.semantics.semantics
import com.hermesandroid.relay.R
import androidx.compose.ui.text.font.FontFamily
import androidx.compose.ui.text.style.TextOverflow
@@ -49,7 +51,12 @@ fun ThinkingBlock(
/** Stable key when this interactive block participates in Chat pet terrain. */
petObstacleKey: String? = null,
) {
if (thinkingContent.isBlank()) return
var expanded by remember { mutableStateOf(isStreaming) }
var userToggled by remember { mutableStateOf(false) }
LaunchedEffect(isStreaming) {
if (!userToggled) expanded = isStreaming
}
val locale = LocalLocale.current.platformLocale
val timeLabel = timestamp?.let {
remember(it, locale) {
@@ -57,8 +64,13 @@ fun ThinkingBlock(
.format(java.util.Date(it))
}
}
val expansionState = if (expanded) {
stringResource(R.string.tool_progress_state_expanded)
} else {
stringResource(R.string.tool_progress_state_collapsed)
}
Card(
Column(
modifier = modifier
.then(
if (petObstacleKey != null) {
@@ -71,18 +83,20 @@ fun ThinkingBlock(
},
)
.fillMaxWidth(),
colors = CardDefaults.cardColors(
containerColor = MaterialTheme.colorScheme.surfaceVariant.copy(alpha = 0.5f)
)
) {
Column(modifier = Modifier.padding(8.dp)) {
// Header row
Row(
modifier = Modifier
.fillMaxWidth()
.clickable { expanded = !expanded },
verticalAlignment = Alignment.CenterVertically
) {
Row(
modifier = Modifier
.fillMaxWidth()
.clickable(role = Role.Button) {
userToggled = true
expanded = !expanded
}
.semantics {
stateDescription = expansionState
}
.padding(horizontal = 4.dp, vertical = 3.dp),
verticalAlignment = Alignment.CenterVertically
) {
Icon(
imageVector = Icons.Filled.Psychology,
contentDescription = accessibilityLabel,
@@ -91,9 +105,13 @@ fun ThinkingBlock(
)
Spacer(modifier = Modifier.width(6.dp))
Text(
text = headerText ?: if (isStreaming) stringResource(R.string.thinking_thinking) else stringResource(R.string.thinking_title),
style = MaterialTheme.typography.labelSmall,
color = MaterialTheme.colorScheme.tertiary
text = headerText ?: if (isStreaming) {
stringResource(R.string.thinking_thinking)
} else {
stringResource(R.string.thinking_settled)
},
style = MaterialTheme.typography.labelMedium,
color = MaterialTheme.colorScheme.onSurfaceVariant
)
Spacer(modifier = Modifier.weight(1f))
if (!isStreaming && timeLabel != null) {
@@ -110,25 +128,23 @@ fun ThinkingBlock(
modifier = Modifier.size(16.dp),
tint = MaterialTheme.colorScheme.onSurfaceVariant
)
}
}
// Collapsible content
AnimatedVisibility(
visible = expanded,
enter = expandVertically(),
exit = shrinkVertically()
) {
Text(
text = thinkingContent,
style = MaterialTheme.typography.bodySmall.copy(
fontFamily = FontFamily.Default,
color = MaterialTheme.colorScheme.onSurfaceVariant
),
modifier = Modifier.padding(top = 4.dp),
maxLines = if (isStreaming) Int.MAX_VALUE else 50,
overflow = TextOverflow.Ellipsis
)
}
AnimatedVisibility(
visible = expanded,
enter = expandVertically(),
exit = shrinkVertically()
) {
Text(
text = thinkingContent,
style = MaterialTheme.typography.bodySmall.copy(
fontFamily = FontFamily.Default,
color = MaterialTheme.colorScheme.onSurfaceVariant
),
modifier = Modifier.padding(start = 26.dp, top = 2.dp, end = 4.dp, bottom = 4.dp),
maxLines = if (isStreaming) Int.MAX_VALUE else 50,
overflow = TextOverflow.Ellipsis
)
}
}
}
@@ -0,0 +1,284 @@
package com.hermesandroid.relay.ui.components
import androidx.compose.animation.AnimatedContent
import androidx.compose.animation.AnimatedVisibility
import androidx.compose.animation.expandVertically
import androidx.compose.animation.fadeIn
import androidx.compose.animation.fadeOut
import androidx.compose.animation.shrinkVertically
import androidx.compose.animation.slideInVertically
import androidx.compose.animation.slideOutVertically
import androidx.compose.animation.togetherWith
import androidx.compose.foundation.clickable
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.Row
import androidx.compose.foundation.layout.Spacer
import androidx.compose.foundation.layout.fillMaxWidth
import androidx.compose.foundation.layout.height
import androidx.compose.foundation.layout.padding
import androidx.compose.foundation.layout.size
import androidx.compose.foundation.layout.width
import androidx.compose.material.icons.Icons
import androidx.compose.material.icons.filled.ExpandLess
import androidx.compose.material.icons.filled.ExpandMore
import androidx.compose.material.icons.filled.MoreHoriz
import androidx.compose.material3.Icon
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.compose.runtime.getValue
import androidx.compose.runtime.key
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.saveable.rememberSaveable
import androidx.compose.runtime.setValue
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.platform.LocalResources
import androidx.compose.ui.res.stringResource
import androidx.compose.ui.semantics.Role
import androidx.compose.ui.semantics.contentDescription
import androidx.compose.ui.semantics.stateDescription
import androidx.compose.ui.semantics.semantics
import androidx.compose.ui.text.style.TextOverflow
import androidx.compose.ui.unit.dp
import com.hermesandroid.relay.R
import com.hermesandroid.relay.data.ToolCall
import com.hermesandroid.relay.ui.components.pet.petObstacleSurface
private val TOOL_ACTIVITY_PET_ROUTES = setOf("chat")
private val FILE_EDIT_TOOLS = setOf("edit_file", "write_file", "apply_patch", "patch")
private val ATTENTION_TOOLS = setOf(
"clarify",
"delegate_task",
"image_generate",
"approval",
"request_user_input",
"ask_user",
"sudo",
"secret",
)
internal sealed interface ToolTranscriptItem {
data class ActivityRun(val calls: List<ToolCall>) : ToolTranscriptItem
data class Standalone(val call: ToolCall) : ToolTranscriptItem
}
/** Off suppresses diagnostics, never an attention or deliverable surface. */
internal fun ToolTranscriptItem.isVisibleForToolDisplay(toolDisplay: String): Boolean =
this is ToolTranscriptItem.Standalone || toolDisplay != "off"
/**
* Preserve source order while folding only routine activity. Calls that are
* actionable, security-relevant, failed, or deliver a file/media result split
* the run and retain their own surface.
*/
internal fun groupTranscriptTools(calls: List<ToolCall>): List<ToolTranscriptItem> {
val result = mutableListOf<ToolTranscriptItem>()
val run = mutableListOf<ToolCall>()
fun flushRun() {
if (run.isNotEmpty()) {
result += ToolTranscriptItem.ActivityRun(run.toList())
run.clear()
}
}
calls.forEach { call ->
if (call.requiresStandaloneToolSurface()) {
flushRun()
result += ToolTranscriptItem.Standalone(call)
} else {
run += call
}
}
flushRun()
return result
}
internal fun ToolCall.requiresStandaloneToolSurface(): Boolean {
val normalized = name.trim().lowercase()
return success == false ||
!error.isNullOrBlank() ||
outputRisk != null ||
normalized in FILE_EDIT_TOOLS ||
normalized in ATTENTION_TOOLS
}
internal data class ToolActivityCounts(
val reads: Int = 0,
val searches: Int = 0,
val commands: Int = 0,
val browserActions: Int = 0,
val deviceActions: Int = 0,
val other: Int = 0,
)
internal fun countToolActivity(calls: List<ToolCall>): ToolActivityCounts {
var counts = ToolActivityCounts()
calls.forEach { call ->
val name = call.name.trim().lowercase()
counts = when {
name.contains("search") || name.contains("grep") || name.contains("find") ->
counts.copy(searches = counts.searches + 1)
name.contains("terminal") || name.contains("shell") || name.contains("exec") ||
name.contains("command") || name.contains("bash") || name.contains("powershell") ->
counts.copy(commands = counts.commands + 1)
name.contains("browser") || name.contains("chrome") || name.contains("playwright") ||
name.startsWith("web_") -> counts.copy(browserActions = counts.browserActions + 1)
name.contains("android") || name.contains("adb") || name.contains("device") ||
name.contains("tap") || name.contains("swipe") ->
counts.copy(deviceActions = counts.deviceActions + 1)
name.contains("read") || name.contains("list") || name.contains("glob") ||
name.contains("open") || name.contains("inspect") -> counts.copy(reads = counts.reads + 1)
else -> counts.copy(other = counts.other + 1)
}
}
return counts
}
@Composable
fun ToolActivityRun(
calls: List<ToolCall>,
live: Boolean,
detailed: Boolean,
modifier: Modifier = Modifier,
messageTimestamp: Long? = null,
petObstacleKey: String? = null,
onExpandedChange: (Boolean) -> Unit = {},
) {
if (calls.isEmpty()) return
var expanded by rememberSaveable(calls.first().uiKey) { mutableStateOf(false) }
val summary = toolActivitySummary(countToolActivity(calls), live)
val stateLabel = if (expanded) {
stringResource(R.string.tool_progress_cd_collapse)
} else {
stringResource(R.string.tool_progress_cd_expand)
}
val expansionState = if (expanded) {
stringResource(R.string.tool_progress_state_expanded)
} else {
stringResource(R.string.tool_progress_state_collapsed)
}
Column(
modifier = modifier
.then(
if (petObstacleKey != null) {
Modifier.petObstacleSurface(petObstacleKey, TOOL_ACTIVITY_PET_ROUTES)
} else {
Modifier
},
)
.fillMaxWidth(),
) {
Row(
modifier = Modifier
.fillMaxWidth()
.clickable(role = Role.Button) {
expanded = !expanded
onExpandedChange(expanded)
}
.semantics {
contentDescription = summary
stateDescription = expansionState
}
.padding(horizontal = 4.dp, vertical = 4.dp),
verticalAlignment = Alignment.CenterVertically,
) {
Icon(
imageVector = Icons.Filled.MoreHoriz,
contentDescription = null,
modifier = Modifier.size(16.dp),
tint = if (live) MaterialTheme.colorScheme.tertiary
else MaterialTheme.colorScheme.onSurfaceVariant,
)
Spacer(modifier = Modifier.width(6.dp))
Text(
text = summary,
style = MaterialTheme.typography.labelMedium,
color = MaterialTheme.colorScheme.onSurfaceVariant,
maxLines = 1,
overflow = TextOverflow.Ellipsis,
modifier = Modifier.weight(1f),
)
Icon(
imageVector = if (expanded) Icons.Filled.ExpandLess else Icons.Filled.ExpandMore,
contentDescription = stateLabel,
modifier = Modifier.size(16.dp),
tint = MaterialTheme.colorScheme.onSurfaceVariant,
)
}
if (live && !expanded) {
val latest = calls.last()
AnimatedContent(
targetState = latest.uiKey,
transitionSpec = {
(slideInVertically { it / 2 } + fadeIn()) togetherWith
(slideOutVertically { -it / 2 } + fadeOut())
},
label = "toolActivityTicker",
) { latestKey ->
val visible = calls.lastOrNull { it.uiKey == latestKey } ?: latest
Text(
text = toolActivityTickerLabel(visible),
style = MaterialTheme.typography.labelSmall,
color = MaterialTheme.colorScheme.onSurfaceVariant.copy(alpha = 0.78f),
maxLines = 1,
overflow = TextOverflow.Ellipsis,
modifier = Modifier.padding(start = 26.dp, end = 4.dp, bottom = 4.dp),
)
}
}
AnimatedVisibility(
visible = expanded,
enter = expandVertically(),
exit = shrinkVertically(),
) {
Column(modifier = Modifier.padding(start = 22.dp, top = 2.dp)) {
calls.forEach { call ->
key(call.uiKey) {
if (detailed) {
ToolProgressCard(
toolCall = call,
messageTimestamp = messageTimestamp,
onExpandedChange = onExpandedChange,
)
} else {
CompactToolCall(toolCall = call)
}
Spacer(modifier = Modifier.height(4.dp))
}
}
}
}
}
}
@Composable
private fun toolActivitySummary(counts: ToolActivityCounts, live: Boolean): String {
val resources = LocalResources.current
val clauses = buildList {
fun addClause(count: Int, liveRes: Int, settledRes: Int) {
if (count > 0) add(resources.getQuantityString(if (live) liveRes else settledRes, count, count))
}
addClause(counts.reads, R.plurals.tool_run_reading, R.plurals.tool_run_read)
addClause(counts.searches, R.plurals.tool_run_searching, R.plurals.tool_run_searched)
addClause(counts.commands, R.plurals.tool_run_running_commands, R.plurals.tool_run_ran_commands)
addClause(counts.browserActions, R.plurals.tool_run_browsing, R.plurals.tool_run_browsed)
addClause(counts.deviceActions, R.plurals.tool_run_using_device, R.plurals.tool_run_used_device)
addClause(counts.other, R.plurals.tool_run_using_tools, R.plurals.tool_run_used_tools)
}
return clauses.joinToString(" · ")
}
@Composable
private fun toolActivityTickerLabel(call: ToolCall): String {
val name = localizeToolName(call.name).ifBlank { stringResource(R.string.tool_preparing) }
return when {
call.isGenerating && !call.isComplete -> stringResource(R.string.tool_run_preparing, name)
!call.isComplete -> stringResource(R.string.tool_run_running, name)
else -> stringResource(R.string.tool_run_finished, name)
}
}
@@ -0,0 +1,368 @@
package com.hermesandroid.relay.ui.components
import androidx.compose.foundation.background
import androidx.compose.foundation.border
import androidx.compose.foundation.horizontalScroll
import androidx.compose.foundation.layout.Arrangement
import androidx.compose.foundation.layout.Box
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.Row
import androidx.compose.foundation.layout.fillMaxWidth
import androidx.compose.foundation.layout.padding
import androidx.compose.foundation.layout.size
import androidx.compose.foundation.rememberScrollState
import androidx.compose.foundation.shape.RoundedCornerShape
import androidx.compose.foundation.text.BasicTextField
import androidx.compose.foundation.text.KeyboardActions
import androidx.compose.foundation.text.KeyboardOptions
import androidx.compose.material.icons.Icons
import androidx.compose.material.icons.filled.Close
import androidx.compose.material.icons.filled.KeyboardArrowDown
import androidx.compose.material.icons.filled.KeyboardArrowUp
import androidx.compose.material.icons.filled.Search
import androidx.compose.material3.Icon
import androidx.compose.material3.IconButton
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.compose.runtime.Immutable
import androidx.compose.runtime.LaunchedEffect
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableIntStateOf
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.saveable.rememberSaveable
import androidx.compose.runtime.setValue
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.draw.clip
import androidx.compose.ui.focus.FocusRequester
import androidx.compose.ui.focus.focusRequester
import androidx.compose.ui.graphics.SolidColor
import androidx.compose.ui.platform.testTag
import androidx.compose.ui.semantics.contentDescription
import androidx.compose.ui.semantics.semantics
import androidx.compose.ui.text.input.ImeAction
import androidx.compose.ui.unit.dp
import com.hermesandroid.relay.data.ChatMessage
import com.hermesandroid.relay.data.MessageRole
import com.hermesandroid.relay.ui.theme.LocalBrand
@Immutable
data class TranscriptMatch(
val messageUiKey: String,
val messageIndex: Int,
val start: Int,
val endExclusive: Int,
)
@Immutable
data class TranscriptTurnMarker(
val messageUiKey: String,
val messageIndex: Int,
val turnNumber: Int,
val label: String,
val matchCount: Int,
val containsActiveMatch: Boolean,
)
@Immutable
data class TranscriptNavigationModel(
val matches: List<TranscriptMatch>,
val turns: List<TranscriptTurnMarker>,
)
/**
* User-facing copy is injectable so the component remains reusable and its
* eventual ChatScreen integration can supply localized resources without
* coupling the pure navigation model to Android resources.
*/
@Immutable
data class TranscriptNavigatorStrings(
val searchPlaceholder: String = "Search conversation",
val previousMatch: String = "Previous match",
val nextMatch: String = "Next match",
val closeSearch: String = "Close search",
val noResults: String = "No results",
val resultCount: (current: Int, total: Int) -> String = { current, total -> "$current of $total" },
val resultCountDescription: (current: Int, total: Int) -> String = { current, total ->
if (total == 0) "No search results" else "Search result $current of $total"
},
val turnDescription: (turn: Int, label: String, matches: Int) -> String = { turn, label, matches ->
val suffix = if (matches == 1) ", 1 match" else if (matches > 1) ", $matches matches" else ""
"Jump to turn $turn: $label$suffix"
},
)
object TranscriptNavigatorTestTags {
const val Query = "transcript-search-query"
const val ResultCount = "transcript-search-result-count"
const val Previous = "transcript-search-previous"
const val Next = "transcript-search-next"
const val Close = "transcript-search-close"
const val TurnPrefix = "transcript-turn-"
}
/**
* Compact, self-contained find bar plus prompt rail for an active transcript.
* All jump callbacks use [ChatMessage.uiKey], the same stable identity used by
* Chat's LazyColumn, so a history reconciliation cannot invalidate a target.
*/
@Composable
fun TranscriptSearchNavigator(
messages: List<ChatMessage>,
onJumpToMessage: (messageUiKey: String) -> Unit,
onClose: () -> Unit,
modifier: Modifier = Modifier,
initialQuery: String = "",
strings: TranscriptNavigatorStrings = TranscriptNavigatorStrings(),
) {
val brand = LocalBrand.current
var query by rememberSaveable { mutableStateOf(initialQuery) }
var activeMatchIndex by rememberSaveable { mutableIntStateOf(0) }
val model = remember(messages, query, activeMatchIndex) {
buildTranscriptNavigationModel(messages, query, activeMatchIndex)
}
val normalizedActiveIndex = activeMatchIndex.coerceIn(0, (model.matches.size - 1).coerceAtLeast(0))
val focusRequester = remember { FocusRequester() }
LaunchedEffect(Unit) {
runCatching { focusRequester.requestFocus() }
}
fun selectMatch(index: Int) {
if (model.matches.isEmpty()) return
val normalized = Math.floorMod(index, model.matches.size)
activeMatchIndex = normalized
onJumpToMessage(model.matches[normalized].messageUiKey)
}
Column(
modifier = modifier
.fillMaxWidth()
.background(brand.navy)
.border(1.dp, brand.line, RoundedCornerShape(14.dp))
.padding(horizontal = 8.dp, vertical = 6.dp),
verticalArrangement = Arrangement.spacedBy(2.dp),
) {
Row(
verticalAlignment = Alignment.CenterVertically,
horizontalArrangement = Arrangement.spacedBy(2.dp),
) {
Row(
modifier = Modifier
.weight(1f)
.clip(RoundedCornerShape(10.dp))
.background(brand.surfaceLow)
.border(1.dp, brand.line, RoundedCornerShape(10.dp))
.padding(horizontal = 10.dp, vertical = 8.dp),
verticalAlignment = Alignment.CenterVertically,
horizontalArrangement = Arrangement.spacedBy(8.dp),
) {
Icon(
imageVector = Icons.Filled.Search,
contentDescription = null,
tint = brand.muted,
modifier = Modifier.size(18.dp),
)
BasicTextField(
value = query,
onValueChange = {
query = it
activeMatchIndex = 0
},
modifier = Modifier
.weight(1f)
.focusRequester(focusRequester)
.testTag(TranscriptNavigatorTestTags.Query),
singleLine = true,
textStyle = MaterialTheme.typography.bodyMedium.copy(color = brand.ink),
cursorBrush = SolidColor(brand.relay),
keyboardOptions = KeyboardOptions(imeAction = ImeAction.Search),
keyboardActions = KeyboardActions(onSearch = { selectMatch(normalizedActiveIndex) }),
decorationBox = { inner ->
Box {
if (query.isEmpty()) {
Text(
text = strings.searchPlaceholder,
color = brand.dim,
style = MaterialTheme.typography.bodyMedium,
)
}
inner()
}
},
)
}
val current = if (model.matches.isEmpty()) 0 else normalizedActiveIndex + 1
Text(
text = if (model.matches.isEmpty() && query.isNotBlank()) {
strings.noResults
} else {
strings.resultCount(current, model.matches.size)
},
color = brand.muted,
style = MaterialTheme.typography.labelSmall,
maxLines = 1,
modifier = Modifier
.testTag(TranscriptNavigatorTestTags.ResultCount)
.semantics {
contentDescription = strings.resultCountDescription(current, model.matches.size)
},
)
IconButton(
onClick = { selectMatch(normalizedActiveIndex - 1) },
enabled = model.matches.isNotEmpty(),
modifier = Modifier.testTag(TranscriptNavigatorTestTags.Previous),
) {
Icon(Icons.Filled.KeyboardArrowUp, strings.previousMatch, tint = brand.ink)
}
IconButton(
onClick = { selectMatch(normalizedActiveIndex + 1) },
enabled = model.matches.isNotEmpty(),
modifier = Modifier.testTag(TranscriptNavigatorTestTags.Next),
) {
Icon(Icons.Filled.KeyboardArrowDown, strings.nextMatch, tint = brand.ink)
}
IconButton(
onClick = onClose,
modifier = Modifier.testTag(TranscriptNavigatorTestTags.Close),
) {
Icon(Icons.Filled.Close, strings.closeSearch, tint = brand.ink)
}
}
TranscriptTurnRail(
turns = model.turns,
onJumpToMessage = onJumpToMessage,
strings = strings,
)
}
}
@Composable
fun TranscriptTurnRail(
turns: List<TranscriptTurnMarker>,
onJumpToMessage: (messageUiKey: String) -> Unit,
modifier: Modifier = Modifier,
strings: TranscriptNavigatorStrings = TranscriptNavigatorStrings(),
) {
if (turns.isEmpty()) return
val brand = LocalBrand.current
Row(
modifier = modifier
.fillMaxWidth()
.horizontalScroll(rememberScrollState()),
verticalAlignment = Alignment.CenterVertically,
) {
turns.forEach { turn ->
IconButton(
onClick = { onJumpToMessage(turn.messageUiKey) },
modifier = Modifier
.testTag("${TranscriptNavigatorTestTags.TurnPrefix}${turn.messageUiKey}")
.semantics {
contentDescription = strings.turnDescription(
turn.turnNumber,
turn.label,
turn.matchCount,
)
},
) {
Box(
modifier = Modifier
.size(if (turn.containsActiveMatch) 12.dp else 8.dp)
.clip(RoundedCornerShape(50))
.background(
when {
turn.containsActiveMatch -> brand.relay
turn.matchCount > 0 -> brand.purple
else -> brand.dim
},
),
)
}
}
}
}
internal fun buildTranscriptNavigationModel(
messages: List<ChatMessage>,
query: String,
activeMatchIndex: Int = 0,
): TranscriptNavigationModel {
val needle = query.trim()
val matches = if (needle.isEmpty()) {
emptyList()
} else {
buildList {
messages.forEachIndexed { messageIndex, message ->
val text = message.searchableRenderedText()
var start = 0
while (start <= text.length - needle.length) {
val found = text.indexOf(needle, startIndex = start, ignoreCase = true)
if (found < 0) break
add(TranscriptMatch(message.uiKey, messageIndex, found, found + needle.length))
start = found + needle.length.coerceAtLeast(1)
}
}
}
}
val activeMatch = matches.getOrNull(activeMatchIndex.coerceIn(0, (matches.size - 1).coerceAtLeast(0)))
val userIndexes = messages.indices.filter { messages[it].role == MessageRole.USER }
val turns = userIndexes.mapIndexed { ordinal, messageIndex ->
val endExclusive = userIndexes.getOrNull(ordinal + 1) ?: messages.size
val turnMatches = matches.count { it.messageIndex in messageIndex until endExclusive }
val prompt = messages[messageIndex]
TranscriptTurnMarker(
messageUiKey = prompt.uiKey,
messageIndex = messageIndex,
turnNumber = ordinal + 1,
label = prompt.content.compactTranscriptLabel("Prompt ${ordinal + 1}"),
matchCount = turnMatches,
containsActiveMatch = activeMatch?.messageIndex?.let { it in messageIndex until endExclusive } == true,
)
}
return TranscriptNavigationModel(matches = matches, turns = turns)
}
internal fun ChatMessage.searchableRenderedText(): String = buildList {
add(content)
add(thinkingContent)
moaReferences.forEach {
add(it.label)
add(it.text)
}
toolCalls.forEach {
add(it.name)
add(it.taskLabel.orEmpty())
add(it.args.orEmpty())
add(it.result.orEmpty())
add(it.error.orEmpty())
}
attachments.forEach {
add(it.fileName.orEmpty())
add(it.errorMessage.orEmpty())
}
cards.forEach { card ->
add(card.title.orEmpty())
add(card.subtitle.orEmpty())
add(card.body.orEmpty())
card.fields.forEach {
add(it.label)
add(it.value)
}
card.actions.forEach { add(it.label) }
add(card.footer.orEmpty())
}
}.filter(String::isNotBlank).joinToString("\n")
private fun String.compactTranscriptLabel(fallback: String): String {
val compact = trim().replace(Regex("\\s+"), " ")
return when {
compact.isEmpty() -> fallback
compact.length <= 64 -> compact
else -> compact.take(61).trimEnd() + "…"
}
}
@@ -104,8 +104,8 @@ interface AgentAvatar {
}
/**
* Legacy ambient-visualization seam. The app now provides [SphereAvatar] here;
* floating companions are published through [LocalFloatingPet].
* Central/ambient visualization seam. The app provides the independently saved
* Sphere or pet-format background here; floating companions use [LocalFloatingPet].
*/
val LocalAgentAvatar = staticCompositionLocalOf<AgentAvatar> { SphereAvatar }
@@ -117,14 +117,20 @@ val LocalAvailableAvatars = staticCompositionLocalOf<List<AgentAvatar>> { listOf
/**
* The optional floating pet companion. Unlike [LocalAgentAvatar], this does not
* replace the ambient sphere or the active profile's identity image. `null`
* means the user has not selected a companion.
* replace the independently selected central/background visualization or the
* active profile's identity image. `null` means no companion is selected.
*/
val LocalFloatingPet = staticCompositionLocalOf<AgentAvatar?> { null }
/** User-installed pets available to the companion picker (sphere excluded). */
val LocalAvailablePets = staticCompositionLocalOf<List<AgentAvatar>> { emptyList() }
/** Resolve a central visualization without ever coupling it to floating state. */
internal fun resolveBackgroundAvatar(
selectedId: String,
availablePets: List<AgentAvatar>,
): AgentAvatar = availablePets.firstOrNull { it.id == selectedId } ?: SphereAvatar
/** Ambient sphere/background visibility, independent of the motion setting. */
val LocalBackgroundVisualizationEnabled = staticCompositionLocalOf { true }
@@ -12,6 +12,8 @@ import androidx.compose.ui.geometry.Rect
import androidx.compose.ui.layout.boundsInRoot
import androidx.compose.ui.layout.onGloballyPositioned
import androidx.compose.runtime.DisposableEffect
import androidx.compose.runtime.Composable
import androidx.compose.runtime.SideEffect
import com.hermesandroid.relay.ui.components.SphereState
import com.hermesandroid.relay.ui.components.avatar.AvatarRenderState
@@ -100,6 +102,7 @@ class PetCompanionCoordinator {
private var renderState by mutableStateOf(AvatarRenderState(SphereState.Idle))
private var visitRequestState by mutableStateOf(PetVisitRequestState())
private val surfaces = mutableStateMapOf<String, PetCompanionSurface>()
private val interactionLayers = mutableStateMapOf<String, Boolean>()
val pendingVisitRequest: PetVisitRequest?
get() = visitRequestState.pending
@@ -141,20 +144,49 @@ class PetCompanionCoordinator {
surfaces.remove(owner)
}
/** App-wide UI ownership gate for drawers and other same-window overlays. */
fun publishInteractionLayer(owner: String, active: Boolean) {
require(owner.isNotBlank()) { "Pet interaction-layer owner must not be blank." }
if (active) interactionLayers[owner] = true else interactionLayers.remove(owner)
}
fun clearInteractionLayer(owner: String) {
interactionLayers.remove(owner)
}
fun activityFor(owner: String?): PetCompanionActivity {
val surface = owner?.let(surfaces::get)
return PetCompanionActivity(
renderState = renderState,
scrolling = surface?.scrolling == true,
hidden = surface?.hidden == true,
hidden = surface?.hidden == true || interactionLayers.values.any { it },
)
}
}
private data class PetCompanionSurface(val scrolling: Boolean, val hidden: Boolean)
/** A pet-owned popup may take window focus without becoming a competing modal. */
internal fun platformModalOwnsPetLayer(
windowFocused: Boolean,
petMenuExpanded: Boolean,
): Boolean = !windowFocused && !petMenuExpanded
val LocalPetCompanionCoordinator = staticCompositionLocalOf { PetCompanionCoordinator() }
/**
* Declares that a same-window interaction layer currently owns input. Platform
* dialogs and modal sheets are covered separately by root window-focus state.
*/
@Composable
fun PetInteractionLayer(owner: String, active: Boolean) {
val coordinator = LocalPetCompanionCoordinator.current
SideEffect { coordinator.publishInteractionLayer(owner, active) }
DisposableEffect(coordinator, owner) {
onDispose { coordinator.clearInteractionLayer(owner) }
}
}
/**
* Explicit UI surfaces measured by their owners. Their top edges become
* walkable perches, matching Hermes Desktop's live-DOM ledge model without
File diff suppressed because it is too large Load Diff
File diff suppressed because it is too large Load Diff
@@ -60,6 +60,7 @@ import androidx.compose.ui.text.font.FontWeight
import androidx.compose.ui.text.style.TextAlign
import androidx.compose.ui.unit.dp
import com.hermesandroid.relay.R
import com.hermesandroid.relay.data.PhysicalKeyboardEnterBehavior
import com.hermesandroid.relay.network.upstream.GatewayAvailability
import com.hermesandroid.relay.network.upstream.ServerCapabilities
import com.hermesandroid.relay.ui.components.ChatTransportStatus
@@ -443,6 +444,48 @@ fun ChatSettingsScreen(
HorizontalDivider()
val physicalKeyboardEnterBehavior by
connectionViewModel.physicalKeyboardEnterBehavior.collectAsState()
Column(verticalArrangement = Arrangement.spacedBy(8.dp)) {
Text(
text = stringResource(R.string.chat_settings_physical_keyboard_enter),
style = MaterialTheme.typography.bodyMedium,
)
Text(
text = stringResource(R.string.chat_settings_physical_keyboard_enter_desc),
style = MaterialTheme.typography.bodySmall,
color = MaterialTheme.colorScheme.onSurfaceVariant,
)
val enterBehaviors = PhysicalKeyboardEnterBehavior.entries
SingleChoiceSegmentedButtonRow(modifier = Modifier.fillMaxWidth()) {
enterBehaviors.forEachIndexed { index, behavior ->
SegmentedButton(
shape = SegmentedButtonDefaults.itemShape(
index = index,
count = enterBehaviors.size,
),
onClick = {
connectionViewModel.setPhysicalKeyboardEnterBehavior(behavior)
},
selected = behavior == physicalKeyboardEnterBehavior,
) {
Text(
text = stringResource(
if (behavior == PhysicalKeyboardEnterBehavior.SendMessage) {
R.string.chat_input_send_message
} else {
R.string.chat_settings_insert_newline
},
),
style = MaterialTheme.typography.labelMedium,
)
}
}
}
}
HorizontalDivider()
// Background chat-alert toggle. First enable on
// API 33+ runs the POST_NOTIFICATIONS request (the
// BridgeScreen master-toggle precedent); if the user
@@ -0,0 +1,249 @@
package com.hermesandroid.relay.ui.screens
import androidx.activity.compose.rememberLauncherForActivityResult
import androidx.activity.result.contract.ActivityResultContracts
import androidx.compose.foundation.layout.Arrangement
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.ColumnScope
import androidx.compose.foundation.layout.FlowRow
import androidx.compose.foundation.layout.ExperimentalLayoutApi
import androidx.compose.foundation.layout.Row
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.foundation.layout.fillMaxWidth
import androidx.compose.foundation.layout.padding
import androidx.compose.foundation.rememberScrollState
import androidx.compose.foundation.shape.RoundedCornerShape
import androidx.compose.foundation.verticalScroll
import androidx.compose.material.icons.Icons
import androidx.compose.material.icons.automirrored.filled.ArrowBack
import androidx.compose.material.icons.filled.Add
import androidx.compose.material.icons.filled.AutoAwesome
import androidx.compose.material.icons.filled.ContentCopy
import androidx.compose.material3.Button
import androidx.compose.material3.Card
import androidx.compose.material3.CardDefaults
import androidx.compose.material3.ExperimentalMaterial3Api
import androidx.compose.material3.FilterChip
import androidx.compose.material3.Icon
import androidx.compose.material3.IconButton
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.OutlinedButton
import androidx.compose.material3.OutlinedTextField
import androidx.compose.material3.Scaffold
import androidx.compose.material3.SnackbarHost
import androidx.compose.material3.SnackbarHostState
import androidx.compose.material3.Text
import androidx.compose.material3.TopAppBar
import androidx.compose.material3.TopAppBarDefaults
import androidx.compose.runtime.Composable
import androidx.compose.runtime.LaunchedEffect
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.rememberCoroutineScope
import androidx.compose.runtime.setValue
import androidx.compose.ui.Modifier
import androidx.compose.ui.platform.LocalClipboardManager
import androidx.compose.ui.res.stringResource
import androidx.compose.ui.text.AnnotatedString
import androidx.compose.ui.unit.dp
import com.hermesandroid.relay.R
import com.hermesandroid.relay.viewmodel.ConnectionViewModel
import kotlinx.coroutines.launch
internal enum class CustomPetKind { STATIC, ANIMATED }
internal fun buildCustomPetPrompt(
name: String,
description: String,
kind: CustomPetKind,
): String {
val safeName = name.trim().ifBlank { "My Hermes companion" }
val safeDescription = description.trim().ifBlank {
"a friendly companion that remains recognizable at small mobile sizes"
}
val output = if (kind == CustomPetKind.STATIC) {
"Create one transparent PNG or WebP image. Keep the subject centered with generous edge padding."
} else {
"Create a validated Hermes pet pack ZIP using pet.json plus transparent sprite sheets. " +
"Include idle, walk-left/right, thinking or working, writing, speaking, listening, greet, done, and error where practical. " +
"Frames must show real motion while keeping the character, scale, baseline, and anchor consistent. " +
"At minimum, pet.json must use schemaVersion 1, a stable id and label, and an idle state. " +
"A frame-list state is shaped like {\"frames\":[\"idle-01.png\"],\"fps\":8}; a sheet state is shaped like " +
"{\"sheet\":\"idle.png\",\"frameWidth\":256,\"frameHeight\":256,\"frameCount\":16,\"fps\":8}. " +
"All referenced files must remain inside the pack folder."
}
return """
Help me create a custom floating pet for the Hermes Relay Android app.
Pet name: $safeName
Character direction: $safeDescription
Format: ${if (kind == CustomPetKind.STATIC) "single static image" else "animated pet pack"}
$output
Follow the current Hermes Relay pet contract above. If the repository docs/pet-spec.md or user-docs/features/custom-avatars.md are available, use them as the final authority. Use image-generation tools only if they are available in this chat. Do not upload my reference image, generated art, or pet pack anywhere except through tools I explicitly approve. Work locally where possible.
Before returning anything, validate the manifest and every referenced file, reject path traversal, verify decoded image dimensions and safe margins, and check that animated frames differ visibly without drifting. Then show me a concise review summary and attach the final PNG/WebP or ZIP for me to inspect. Do not install, publish, or share it automatically. I will review it and import it from Appearance > Floating pet.
If you need a visual reference, ask me to attach it in this chat before generating the pet.
""".trimIndent()
}
@OptIn(ExperimentalMaterial3Api::class, ExperimentalLayoutApi::class)
@Composable
fun CustomPetGuideScreen(
connectionViewModel: ConnectionViewModel,
onBack: () -> Unit,
onStartNewChat: (String) -> Unit,
) {
var name by remember { mutableStateOf("") }
var description by remember { mutableStateOf("") }
var kind by remember { mutableStateOf(CustomPetKind.ANIMATED) }
val prompt = remember(name, description, kind) { buildCustomPetPrompt(name, description, kind) }
val clipboard = LocalClipboardManager.current
val copiedMessage = stringResource(R.string.pet_creator_copied)
val snackbarHostState = remember { SnackbarHostState() }
val scope = rememberCoroutineScope()
val importLauncher = rememberLauncherForActivityResult(ActivityResultContracts.OpenDocument()) { uri ->
uri?.let(connectionViewModel::importPet)
}
LaunchedEffect(connectionViewModel) {
connectionViewModel.avatarEvents.collect { snackbarHostState.showSnackbar(it) }
}
Scaffold(
topBar = {
TopAppBar(
title = { Text(stringResource(R.string.pet_creator_title)) },
navigationIcon = {
IconButton(onClick = onBack) {
Icon(Icons.AutoMirrored.Filled.ArrowBack, stringResource(R.string.appearance_back))
}
},
colors = TopAppBarDefaults.topAppBarColors(containerColor = MaterialTheme.colorScheme.surface),
)
},
snackbarHost = { SnackbarHost(snackbarHostState) },
) { innerPadding ->
Column(
modifier = Modifier
.fillMaxSize()
.padding(innerPadding)
.verticalScroll(rememberScrollState())
.padding(16.dp),
verticalArrangement = Arrangement.spacedBy(16.dp),
) {
Text(
text = stringResource(R.string.pet_creator_intro),
style = MaterialTheme.typography.bodyLarge,
color = MaterialTheme.colorScheme.onSurfaceVariant,
)
GuideCard(step = "1", title = stringResource(R.string.pet_creator_step_idea)) {
OutlinedTextField(
value = name,
onValueChange = { name = it },
modifier = Modifier.fillMaxWidth(),
label = { Text(stringResource(R.string.pet_creator_name)) },
singleLine = true,
)
OutlinedTextField(
value = description,
onValueChange = { description = it },
modifier = Modifier.fillMaxWidth(),
label = { Text(stringResource(R.string.pet_creator_description)) },
supportingText = { Text(stringResource(R.string.pet_creator_description_hint)) },
minLines = 3,
)
FlowRow(horizontalArrangement = Arrangement.spacedBy(8.dp)) {
FilterChip(
selected = kind == CustomPetKind.ANIMATED,
onClick = { kind = CustomPetKind.ANIMATED },
label = { Text(stringResource(R.string.pet_creator_animated)) },
)
FilterChip(
selected = kind == CustomPetKind.STATIC,
onClick = { kind = CustomPetKind.STATIC },
label = { Text(stringResource(R.string.pet_creator_static)) },
)
}
}
GuideCard(step = "2", title = stringResource(R.string.pet_creator_step_create)) {
Text(
text = stringResource(R.string.pet_creator_review_copy),
style = MaterialTheme.typography.bodySmall,
color = MaterialTheme.colorScheme.onSurfaceVariant,
)
Card(
colors = CardDefaults.cardColors(containerColor = MaterialTheme.colorScheme.surface),
shape = RoundedCornerShape(12.dp),
) {
Text(
text = prompt,
modifier = Modifier.padding(14.dp),
style = MaterialTheme.typography.bodySmall,
)
}
Row(horizontalArrangement = Arrangement.spacedBy(8.dp)) {
OutlinedButton(
onClick = {
clipboard.setText(AnnotatedString(prompt))
scope.launch { snackbarHostState.showSnackbar(copiedMessage) }
},
modifier = Modifier.weight(1f),
) {
Icon(Icons.Filled.ContentCopy, null)
Text(stringResource(R.string.pet_creator_copy), modifier = Modifier.padding(start = 6.dp))
}
Button(
onClick = { onStartNewChat(prompt) },
modifier = Modifier.weight(1f),
) {
Icon(Icons.Filled.AutoAwesome, null)
Text(stringResource(R.string.pet_creator_new_chat), modifier = Modifier.padding(start = 6.dp))
}
}
}
GuideCard(step = "3", title = stringResource(R.string.pet_creator_step_review)) {
Text(
text = stringResource(R.string.pet_creator_review_desc),
style = MaterialTheme.typography.bodyMedium,
color = MaterialTheme.colorScheme.onSurfaceVariant,
)
OutlinedButton(
onClick = {
importLauncher.launch(arrayOf("application/zip", "image/*", "application/octet-stream", "*/*"))
},
modifier = Modifier.fillMaxWidth(),
) {
Icon(Icons.Filled.Add, null)
Text(stringResource(R.string.pet_creator_import), modifier = Modifier.padding(start = 6.dp))
}
}
}
}
}
@Composable
private fun GuideCard(step: String, title: String, content: @Composable ColumnScope.() -> Unit) {
Card(
modifier = Modifier.fillMaxWidth(),
colors = CardDefaults.cardColors(containerColor = MaterialTheme.colorScheme.surfaceVariant),
shape = RoundedCornerShape(16.dp),
) {
Column(
modifier = Modifier.padding(16.dp),
verticalArrangement = Arrangement.spacedBy(12.dp),
) {
Text(
text = "$step · $title",
style = MaterialTheme.typography.titleMedium,
color = MaterialTheme.colorScheme.primary,
)
content()
}
}
}
@@ -148,6 +148,10 @@ private enum class DashboardManagementSection(val path: String) {
Catalog("/api/mcp/catalog"),
CustomEndpoints("/api/providers/custom-endpoints"),
Profiles("/api/profiles"),
Memory("/api/memory"),
Learning("/api/learning/graph"),
Channels("/api/messaging/platforms"),
Operations("/api/status"),
Models("/api/model/info"),
Keys("/api/env"),
Config("/api/config/schema");
@@ -160,6 +164,10 @@ private enum class DashboardManagementSection(val path: String) {
Catalog -> stringResource(R.string.dashboard_tab_catalog)
CustomEndpoints -> stringResource(R.string.dashboard_tab_custom_endpoints)
Profiles -> stringResource(R.string.dashboard_tab_profiles)
Memory -> stringResource(R.string.dashboard_tab_memory)
Learning -> stringResource(R.string.dashboard_tab_learning)
Channels -> stringResource(R.string.dashboard_tab_channels)
Operations -> stringResource(R.string.dashboard_tab_operations)
Models -> stringResource(R.string.dashboard_tab_models)
Keys -> stringResource(R.string.dashboard_tab_keys)
Config -> stringResource(R.string.dashboard_tab_config)
@@ -174,6 +182,10 @@ private enum class DashboardManagementSection(val path: String) {
Catalog -> stringResource(R.string.dashboard_tab_catalog_lower)
CustomEndpoints -> stringResource(R.string.dashboard_tab_custom_endpoints_lower)
Profiles -> stringResource(R.string.dashboard_tab_profiles_lower)
Memory -> stringResource(R.string.dashboard_tab_memory_lower)
Learning -> stringResource(R.string.dashboard_tab_learning_lower)
Channels -> stringResource(R.string.dashboard_tab_channels_lower)
Operations -> stringResource(R.string.dashboard_tab_operations_lower)
Models -> stringResource(R.string.dashboard_tab_models_lower)
Keys -> stringResource(R.string.dashboard_tab_keys_lower)
Config -> stringResource(R.string.dashboard_tab_config_lower)
@@ -183,7 +195,15 @@ private enum class DashboardManagementSection(val path: String) {
private val managementSections: List<DashboardManagementSection> = DashboardManagementSection.entries
internal fun dashboardSectionRequestPath(path: String, profile: String?): String {
if (profile.isNullOrBlank() || path !in setOf("/api/mcp/servers", "/api/mcp/catalog")) return path
if (
profile.isNullOrBlank() ||
path !in setOf(
"/api/mcp/servers",
"/api/mcp/catalog",
"/api/providers/custom-endpoints",
"/api/learning/graph",
)
) return path
val encoded = java.net.URLEncoder.encode(profile, Charsets.UTF_8.name()).replace("+", "%20")
return "$path?profile=$encoded"
}
@@ -225,7 +245,11 @@ internal fun scopeDashboardManageItems(
profile: String?,
items: List<DashboardSummaryItem>,
): List<DashboardSummaryItem> =
if (sectionPath == "/api/mcp/servers" || sectionPath == "/api/mcp/catalog") {
if (
sectionPath == "/api/mcp/servers" ||
sectionPath == "/api/mcp/catalog" ||
sectionPath == "/api/providers/custom-endpoints"
) {
items.map { it.copy(profile = profile) }
} else {
items
@@ -350,6 +374,7 @@ private enum class DashboardSectionAction {
BrowseSkillsHub,
UpdateSkillsHub,
AddCustomEndpoint,
CreateServerBackup,
}
/** Editor session for a profile's SOUL.md — content is the FULL file from GET. */
@@ -754,7 +779,12 @@ fun DashboardManagementScreen(
}
}
fun submitCreateProfile(name: String, description: String, cloneFromDefault: Boolean) {
fun submitCreateProfile(
name: String,
description: String,
cloneFromDefault: Boolean,
mcpServers: List<String>,
) {
if (dashboardUrl.isBlank() || actionInFlight) return
val actionPayloadKey = payloadKey
actionInFlight = true
@@ -766,6 +796,7 @@ fun DashboardManagementScreen(
name = name,
cloneFromDefault = cloneFromDefault,
description = description.takeIf { it.isNotBlank() },
mcpServers = mcpServers,
)
}
} catch (e: Exception) {
@@ -785,6 +816,28 @@ fun DashboardManagementScreen(
}
}
fun runServerBackup() {
if (dashboardUrl.isBlank() || actionInFlight) return
actionInFlight = true
actionMessage = null
scope.launch {
val result = try {
withDashboardClient(clientFactory) { client -> client.createServerBackup() }
} catch (e: Exception) {
Result.failure(e)
}
actionMessage = result.fold(
onSuccess = { root ->
root.stringField("message")
?: root.stringField("filename")?.let { "Server backup ready: $it" }
?: "Server backup created."
},
onFailure = { error -> error.message ?: "Server backup failed." },
)
actionInFlight = false
}
}
LaunchedEffect(dashboardUrl, selectedTab, reloadNonce, activeConnection?.id, effectiveProfileName) {
val forceCurrent = forceReloadKey == payloadKey
loadDashboardSection(
@@ -950,6 +1003,7 @@ fun DashboardManagementScreen(
if (showCreateProfile) {
var newProfileName by remember { mutableStateOf("") }
var newProfileDescription by remember { mutableStateOf("") }
var newProfileMcpServers by remember { mutableStateOf("") }
var cloneFromDefault by remember { mutableStateOf(true) }
AlertDialog(
onDismissRequest = { showCreateProfile = false },
@@ -969,6 +1023,13 @@ fun DashboardManagementScreen(
modifier = Modifier.fillMaxWidth(),
label = { Text(stringResource(R.string.dashboard_description_optional)) },
)
OutlinedTextField(
value = newProfileMcpServers,
onValueChange = { newProfileMcpServers = it },
modifier = Modifier.fillMaxWidth(),
label = { Text(stringResource(R.string.dashboard_profile_mcp_servers_optional)) },
supportingText = { Text(stringResource(R.string.dashboard_profile_mcp_servers_help)) },
)
Row(
modifier = Modifier.fillMaxWidth(),
verticalAlignment = Alignment.CenterVertically,
@@ -991,6 +1052,12 @@ fun DashboardManagementScreen(
name = newProfileName.trim(),
description = newProfileDescription.trim(),
cloneFromDefault = cloneFromDefault,
mcpServers = newProfileMcpServers
.split(',', '\n')
.map(String::trim)
.filter(String::isNotBlank)
.distinct()
.take(64),
)
},
enabled = newProfileName.isNotBlank() && !actionInFlight,
@@ -1091,6 +1158,7 @@ fun DashboardManagementScreen(
if (showCustomEndpointEditor) {
CustomEndpointDialog(
existing = customEndpointEditor,
profile = effectiveProfileName,
clientFactory = clientFactory,
onSaved = {
showCustomEndpointEditor = false
@@ -1325,6 +1393,8 @@ fun DashboardManagementScreen(
customEndpointEditor = null
showCustomEndpointEditor = true
}
DashboardSectionAction.CreateServerBackup ->
runServerBackup()
}
},
mcpOAuthSupported = mcpOAuthStartAllowed,
@@ -1377,6 +1447,26 @@ private fun manageTileSpec(section: DashboardManagementSection): ManageTileSpec
title = stringResource(R.string.dashboard_tile_profiles_title),
subtitle = stringResource(R.string.dashboard_tile_profiles_sub),
)
DashboardManagementSection.Memory -> ManageTileSpec(
icon = Icons.Filled.AutoAwesome,
title = stringResource(R.string.dashboard_tile_memory_title),
subtitle = stringResource(R.string.dashboard_tile_memory_sub),
)
DashboardManagementSection.Learning -> ManageTileSpec(
icon = Icons.Filled.AutoAwesome,
title = stringResource(R.string.dashboard_tile_learning_title),
subtitle = stringResource(R.string.dashboard_tile_learning_sub),
)
DashboardManagementSection.Channels -> ManageTileSpec(
icon = Icons.Filled.Link,
title = stringResource(R.string.dashboard_tile_channels_title),
subtitle = stringResource(R.string.dashboard_tile_channels_sub),
)
DashboardManagementSection.Operations -> ManageTileSpec(
icon = Icons.Filled.Tune,
title = stringResource(R.string.dashboard_tile_operations_title),
subtitle = stringResource(R.string.dashboard_tile_operations_sub),
)
DashboardManagementSection.Skills -> ManageTileSpec(
icon = Icons.Filled.AutoAwesome,
title = stringResource(R.string.dashboard_tile_skills_title),
@@ -2205,6 +2295,7 @@ private fun LoadedBody(
val actionLabelBrowseHub = stringResource(R.string.dashboard_section_action_browse_hub)
val actionLabelUpdateInstalled = stringResource(R.string.dashboard_section_action_update_installed)
val actionLabelAddEndpoint = stringResource(R.string.dashboard_custom_endpoint_add)
val actionLabelServerBackup = stringResource(R.string.dashboard_section_action_server_backup)
LazyColumn(
modifier = Modifier.fillMaxSize(),
contentPadding = androidx.compose.foundation.layout.PaddingValues(
@@ -2232,6 +2323,9 @@ private fun LoadedBody(
DashboardManagementSection.CustomEndpoints -> listOf(
DashboardSectionAction.AddCustomEndpoint to actionLabelAddEndpoint,
)
DashboardManagementSection.Operations -> listOf(
DashboardSectionAction.CreateServerBackup to actionLabelServerBackup,
)
else -> emptyList()
}
if (sectionActions.isNotEmpty()) {
@@ -3479,6 +3573,7 @@ private fun McpOAuthDialog(
@Composable
private fun CustomEndpointDialog(
existing: DashboardSummaryItem?,
profile: String?,
clientFactory: () -> DashboardApiClient,
onSaved: () -> Unit,
onDismiss: () -> Unit,
@@ -3586,7 +3681,9 @@ private fun CustomEndpointDialog(
onClick = {
busy = true
scope.launch {
val result = withDashboardClient(clientFactory) { it.saveCustomEndpoint(draft()) }
val result = withDashboardClient(clientFactory) {
it.saveCustomEndpoint(draft(), profile = profile)
}
result.fold(onSuccess = { onSaved() }, onFailure = {
busy = false
message = it.message ?: context.getString(R.string.dashboard_custom_endpoint_save_failed)
@@ -3696,6 +3793,16 @@ private fun summarize(
?.map { (name, value) -> summarizeObjectItem(value, name) }
?: listOf(summarizeObjectItem(root, "Profile"))
}
DashboardManagementSection.Memory -> summarizeKeyValueOrList(root, "Memory")
DashboardManagementSection.Learning ->
root.arrayItems("nodes", "items")
?.mapIndexed { index, item -> summarizeObjectItem(item, "Node ${index + 1}") }
?: summarizeKeyValueOrList(root, "Learning")
DashboardManagementSection.Channels ->
root.arrayItems("platforms", "channels", "items")
?.mapIndexed { index, item -> summarizeObjectItem(item, "Channel ${index + 1}") }
?: summarizeKeyValueOrList(root, "Channel")
DashboardManagementSection.Operations -> summarizeKeyValueOrList(root, "Status")
DashboardManagementSection.Models -> summarizeKeyValueOrList(root, "Model")
DashboardManagementSection.Keys -> summarizeEnvVars(root)
DashboardManagementSection.Config -> summarizeKeyValueOrList(root, "Config")
@@ -3736,7 +3843,7 @@ private fun summarizeEnvVars(root: JsonElement): List<DashboardSummaryItem> {
}.sortedWith(compareByDescending<DashboardSummaryItem> { it.meta?.startsWith("set") == true }.thenBy { it.title })
}
private fun summarizeObjectItem(
internal fun summarizeObjectItem(
element: JsonElement,
fallbackTitle: String,
): DashboardSummaryItem {
@@ -3768,6 +3875,9 @@ private fun summarizeObjectItem(
obj.booleanField("installed")?.let { if (it) "installed" else "not installed" },
obj.booleanField("needs_install")?.let { if (it) "bootstrap install" else null },
status,
obj.stringField("last_status")?.let { "last: $it" },
obj.stringField("last_error")?.let { "error: $it" },
obj.stringField("last_delivery_error")?.let { "delivery: $it" },
obj.stringField("provider"),
obj.stringField("transport"),
obj.stringField("auth_type"),
@@ -3801,6 +3911,7 @@ internal fun dashboardActionsFor(obj: JsonObject): List<DashboardItemAction> {
val hasSkillUsage = obj["usage"] != null || obj.stringField("category") != null
val enabled = obj.booleanField("enabled")
val paused = obj.booleanField("paused")
val completedCron = obj.stringField("state").equals("completed", ignoreCase = true)
return when {
isCatalogEntry -> buildList {
@@ -3810,12 +3921,14 @@ internal fun dashboardActionsFor(obj: JsonObject): List<DashboardItemAction> {
}
hasSchedule -> buildList {
add(DashboardItemAction("Runs", DashboardActionKind.ViewCronRuns))
if (paused == true) {
add(DashboardItemAction("Resume", DashboardActionKind.ResumeCron))
} else {
add(DashboardItemAction("Pause", DashboardActionKind.PauseCron))
if (!completedCron) {
if (paused == true) {
add(DashboardItemAction("Resume", DashboardActionKind.ResumeCron))
} else {
add(DashboardItemAction("Pause", DashboardActionKind.PauseCron))
}
add(DashboardItemAction("Run now", DashboardActionKind.TriggerCron))
}
add(DashboardItemAction("Run now", DashboardActionKind.TriggerCron))
add(DashboardItemAction("Delete", DashboardActionKind.DeleteCron, destructive = true))
}
hasTransport -> buildList {
@@ -4107,9 +4220,10 @@ private suspend fun DashboardApiClient.runDashboardAction(
DashboardActionKind.ViewProfileSoul -> getProfileSoul(id)
DashboardActionKind.ActivateProfile -> setActiveProfile(id)
DashboardActionKind.DeleteProfile -> deleteProfile(id)
DashboardActionKind.ActivateCustomEndpoint -> activateCustomEndpoint(id)
DashboardActionKind.ActivateCustomEndpoint ->
activateCustomEndpoint(id, profile = item.profile)
DashboardActionKind.DeleteCustomEndpoint ->
deleteCustomEndpoint(id).map { JsonObject(emptyMap()) }
deleteCustomEndpoint(id, profile = item.profile).map { JsonObject(emptyMap()) }
DashboardActionKind.RevealEnvKey -> revealEnvVar(id)
DashboardActionKind.ClearEnvKey -> deleteEnvVar(id)
// Input-backed kinds are intercepted at the onAction layer and routed
@@ -572,6 +572,18 @@ private fun DeviceCard(
style = MaterialTheme.typography.titleSmall,
fontWeight = FontWeight.SemiBold
)
val deviceDetail = listOf(device.deviceModel, device.devicePlatform)
.map { it.trim() }
.filter { it.isNotBlank() }
.distinct()
.joinToString(" · ")
if (deviceDetail.isNotBlank()) {
Text(
text = deviceDetail,
style = MaterialTheme.typography.bodySmall,
color = MaterialTheme.colorScheme.onSurfaceVariant,
)
}
if (device.deviceId.isNotBlank()) {
Text(
text = device.deviceId,
@@ -424,7 +424,6 @@ fun SettingsScreen(
val lockedDisplayName: String? = when {
!isProfileLocked -> null
lockedProfileName == null ||
AgentDisplay.isServerDefaultAlias(lockedProfileName) ||
lockedProfileName == AgentDisplay.SERVER_DEFAULT_PROFILE_KEY ->
serverDefaultLabel
else ->
@@ -1055,13 +1054,12 @@ private fun ProfileLockDialog(
onUnlock: () -> Unit,
onDismiss: () -> Unit,
) {
// Selectable rows: a synthetic "Server default" sentinel + the advertised
// profiles, minus the synthetic "default" alias (folded into Server default).
val selectableProfiles = profiles.filterNot { AgentDisplay.isServerDefaultAlias(it.name) }
// Selectable rows: a synthetic "Server default" sentinel + every advertised
// profile, including a profile literally named `default`.
val selectableProfiles = profiles
// Is the stored lock target Server default (sentinel / "default" alias / null)?
// Is the stored lock target Server default (sentinel / null)?
val lockedIsServerDefault = lockedProfileName == null ||
AgentDisplay.isServerDefaultAlias(lockedProfileName) ||
lockedProfileName == AgentDisplay.SERVER_DEFAULT_PROFILE_KEY
val lockedProfile = if (lockedIsServerDefault) {
null
@@ -0,0 +1,41 @@
package com.hermesandroid.relay.ui.theme
import androidx.compose.foundation.shape.RoundedCornerShape
import androidx.compose.material3.Shapes
import androidx.compose.ui.unit.dp
enum class AppearanceShape(val id: String) {
SOFT("soft"),
BALANCED("balanced"),
SHARP("sharp");
companion object {
val DEFAULT = SOFT
fun fromId(id: String?): AppearanceShape = entries.firstOrNull { it.id == id } ?: DEFAULT
}
}
fun appearanceShapes(shapeId: String?): Shapes = when (AppearanceShape.fromId(shapeId)) {
AppearanceShape.SOFT -> Shapes(
extraSmall = RoundedCornerShape(8.dp),
small = RoundedCornerShape(12.dp),
medium = RoundedCornerShape(18.dp),
large = RoundedCornerShape(24.dp),
extraLarge = RoundedCornerShape(30.dp),
)
AppearanceShape.BALANCED -> Shapes(
extraSmall = RoundedCornerShape(5.dp),
small = RoundedCornerShape(8.dp),
medium = RoundedCornerShape(12.dp),
large = RoundedCornerShape(16.dp),
extraLarge = RoundedCornerShape(20.dp),
)
AppearanceShape.SHARP -> Shapes(
extraSmall = RoundedCornerShape(2.dp),
small = RoundedCornerShape(4.dp),
medium = RoundedCornerShape(6.dp),
large = RoundedCornerShape(8.dp),
extraLarge = RoundedCornerShape(10.dp),
)
}
@@ -7,6 +7,7 @@ import androidx.compose.runtime.Immutable
import androidx.compose.runtime.staticCompositionLocalOf
import androidx.compose.ui.graphics.Color
import androidx.compose.ui.graphics.lerp
import androidx.compose.ui.graphics.luminance
/**
* Theme-scoped brand token bundle.
@@ -79,6 +80,41 @@ val LocalBrand = staticCompositionLocalOf { BrandPalettes.HermesDark }
private fun Color.lighten(f: Float): Color = lerp(this, Color.White, f)
private fun Color.darken(f: Float): Color = lerp(this, Color.Black, f)
/** User-selectable accent seeds. Stored as stable RGB strings in DataStore. */
val AccentSwatches = listOf(
"#356CFF", "#00B5A0", "#62C51E", "#ED4E8B", "#FF4B00",
)
fun normalizeAccentHex(value: String?): String? {
val normalized = value?.trim()?.uppercase()?.let { if (it.startsWith("#")) it else "#$it" }
return normalized?.takeIf { it.matches(Regex("#[0-9A-F]{6}")) }
}
fun accentColor(value: String?): Color? = normalizeAccentHex(value)?.let {
Color(0xFF000000L or it.drop(1).toLong(16))
}
fun contrastRatio(foreground: Color, background: Color): Float {
val light = maxOf(foreground.luminance(), background.luminance())
val dark = minOf(foreground.luminance(), background.luminance())
return (light + 0.05f) / (dark + 0.05f)
}
fun readableContentColor(background: Color): Color =
listOf(Color.Black, Color.White).maxBy { contrastRatio(it, background) }
/** Apply one accent seed without changing surfaces or semantic status colors. */
fun BrandPalette.withAccent(accentHex: String?): BrandPalette {
val accent = accentColor(accentHex) ?: return this
return copy(
relay = if (isDark) accent.lighten(0.34f) else accent.darken(0.08f),
electric = accent,
electricMuted = if (isDark) accent.lighten(0.18f) else accent.lighten(0.12f),
purple = lerp(accent, purple, 0.38f),
cyan = lerp(accent, cyan, 0.45f),
)
}
/**
* Derive a complete Material 3 [ColorScheme] from the palette. Dark and light
* palettes use distinct mappings; the "text on a deep accent chip" slots use
@@ -87,15 +123,15 @@ private fun Color.darken(f: Float): Color = lerp(this, Color.Black, f)
fun BrandPalette.toColorScheme(): ColorScheme = if (isDark) {
darkColorScheme(
primary = relay,
onPrimary = background,
onPrimary = readableContentColor(relay),
primaryContainer = electric,
onPrimaryContainer = paper,
onPrimaryContainer = readableContentColor(electric),
secondary = purple,
onSecondary = paper,
onSecondary = readableContentColor(purple),
secondaryContainer = navy3,
onSecondaryContainer = paper,
tertiary = cyan,
onTertiary = background,
onTertiary = readableContentColor(cyan),
tertiaryContainer = purple.copy(alpha = 0.42f),
onTertiaryContainer = paper,
background = background,
@@ -119,15 +155,15 @@ fun BrandPalette.toColorScheme(): ColorScheme = if (isDark) {
} else {
lightColorScheme(
primary = electric,
onPrimary = Color.White,
onPrimary = readableContentColor(electric),
primaryContainer = relay.copy(alpha = 0.22f),
onPrimaryContainer = electric.darken(0.32f),
secondary = purple,
onSecondary = Color.White,
onSecondary = readableContentColor(purple),
secondaryContainer = purple.copy(alpha = 0.16f),
onSecondaryContainer = purple.darken(0.38f),
tertiary = cyan,
onTertiary = Color.White,
onTertiary = readableContentColor(cyan),
tertiaryContainer = cyan.copy(alpha = 0.16f),
onTertiaryContainer = cyan.darken(0.42f),
background = background,
@@ -24,6 +24,7 @@ import androidx.compose.ui.unit.Density
* for [ThemeMode.BOTH] themes; fixed-mode themes ignore it.
* @param appFontId id from [AppFont]; selects the body typeface for the whole
* app. Defaults to Inter. Code/metadata styles stay monospaced regardless.
* @param accentHex optional locally persisted RGB override for brand accents.
*/
@Composable
fun HermesRelayTheme(
@@ -31,12 +32,15 @@ fun HermesRelayTheme(
themePreference: String = "auto",
fontScale: Float = 1.0f,
appFontId: String = AppFont.DEFAULT.id,
accentHex: String? = null,
shapeId: String = AppearanceShape.DEFAULT.id,
content: @Composable () -> Unit
) {
val appTheme = AppThemes.byId(appThemeId)
val useDarkTheme = appTheme.resolveDark(themePreference, isSystemInDarkTheme())
val palette = appTheme.paletteFor(useDarkTheme)
val palette = appTheme.paletteFor(useDarkTheme).withAccent(accentHex)
val colorScheme = palette.toColorScheme()
val shapes = remember(shapeId) { appearanceShapes(shapeId) }
// Build the Material typography from the selected font. Remembered per id so
// a recomposition (e.g. theme/mode change) doesn't rebuild the FontFamily
@@ -60,6 +64,7 @@ fun HermesRelayTheme(
MaterialTheme(
colorScheme = colorScheme,
typography = typography,
shapes = shapes,
content = content
)
} else {
@@ -72,6 +77,7 @@ fun HermesRelayTheme(
MaterialTheme(
colorScheme = colorScheme,
typography = typography,
shapes = shapes,
content = content
)
}
@@ -0,0 +1,50 @@
package com.hermesandroid.relay.util
import android.content.Intent
import java.util.concurrent.atomic.AtomicLong
import kotlinx.coroutines.flow.MutableStateFlow
import kotlinx.coroutines.flow.StateFlow
import kotlinx.coroutines.flow.asStateFlow
import kotlinx.coroutines.flow.update
data class SharedTextDraftRequest(
val id: Long,
val text: String,
)
/**
* Process-local handoff from Android's sharesheet entry point to the app-owned
* chat runtime. A StateFlow keeps a cold-start request alive until RelayApp has
* initialized its ViewModels; [consume] is identity-checked so an older UI
* completion cannot clear a newer share intent.
*/
object SharedTextRequest {
private val nextId = AtomicLong(0L)
private val _pending = MutableStateFlow<SharedTextDraftRequest?>(null)
val pending: StateFlow<SharedTextDraftRequest?> = _pending.asStateFlow()
fun tryRequest(text: CharSequence?): Boolean {
val value = text?.toString()?.takeIf { it.isNotBlank() } ?: return false
_pending.value = SharedTextDraftRequest(
id = nextId.incrementAndGet(),
text = value,
)
return true
}
fun consume(id: Long) {
_pending.update { request -> request?.takeUnless { it.id == id } }
}
}
/** Accept only Android's single-item text share contract. */
internal fun extractSharedText(
action: String?,
mimeType: String?,
text: CharSequence?,
): String? {
if (action != Intent.ACTION_SEND) return null
if (mimeType?.startsWith("text/", ignoreCase = true) != true) return null
return text?.toString()?.takeIf { it.isNotBlank() }
}
@@ -13,6 +13,7 @@ import com.hermesandroid.relay.data.AttachmentState
import com.hermesandroid.relay.data.BackgroundTaskPhase
import com.hermesandroid.relay.data.BackgroundTaskState
import com.hermesandroid.relay.data.ChatMessage
import com.hermesandroid.relay.data.ChatComposerDraftStore
import com.hermesandroid.relay.data.ChatQueuedMessageCheckpoint
import com.hermesandroid.relay.data.ChatSession
import com.hermesandroid.relay.data.ChatTurnAskCheckpoint
@@ -24,11 +25,13 @@ import com.hermesandroid.relay.data.ChatTurnMoaReferenceCheckpoint
import com.hermesandroid.relay.data.ChatTurnToolCheckpoint
import com.hermesandroid.relay.data.ChatTurnUserCheckpoint
import com.hermesandroid.relay.data.DataStoreChatTurnCheckpointStore
import com.hermesandroid.relay.data.InMemoryChatComposerDraftStore
import com.hermesandroid.relay.data.DemoContent
import com.hermesandroid.relay.data.MediaSettings
import com.hermesandroid.relay.data.MediaSettingsRepository
import com.hermesandroid.relay.data.MessageDeliveryStatus
import com.hermesandroid.relay.data.MessageRole
import com.hermesandroid.relay.data.parseChatQuotedPrompt
import com.hermesandroid.relay.data.Profile
import com.hermesandroid.relay.data.RealtimeConversationContextMessage
import com.hermesandroid.relay.data.RealtimeTurnTrace
@@ -78,6 +81,7 @@ import com.hermesandroid.relay.network.upstream.ApiModelRoutingException
import com.hermesandroid.relay.network.upstream.ApiModelSelectionAck
import com.hermesandroid.relay.network.upstream.HermesApiClient
import com.hermesandroid.relay.network.upstream.isCurrentModelOptionsResponse
import com.hermesandroid.relay.network.upstream.modelOptionsIdentityToPublish
import com.hermesandroid.relay.network.upstream.parsePersonalityPrompts
import com.hermesandroid.relay.network.upstream.sessionTurnModelHint
import com.hermesandroid.relay.network.relay.ProactiveMessage
@@ -88,6 +92,8 @@ import com.hermesandroid.relay.network.upstream.ChatHandler
import com.hermesandroid.relay.network.shared.LocalDispatchResult
import com.hermesandroid.relay.network.upstream.formatPhoneActionResult
import com.hermesandroid.relay.network.upstream.models.MessageItem
import com.hermesandroid.relay.network.upstream.SESSION_MESSAGE_PAGE_SIZE
import com.hermesandroid.relay.network.upstream.SessionMessageLoadMode
import com.hermesandroid.relay.network.upstream.models.SessionItem
import com.hermesandroid.relay.network.upstream.models.SkillInfo
import com.hermesandroid.relay.network.upstream.models.UsageInfo
@@ -109,12 +115,14 @@ import kotlinx.coroutines.Job
import kotlinx.coroutines.CoroutineStart
import kotlinx.coroutines.delay
import kotlinx.coroutines.channels.BufferOverflow
import kotlinx.coroutines.channels.Channel
import kotlinx.coroutines.flow.MutableSharedFlow
import kotlinx.coroutines.flow.MutableStateFlow
import kotlinx.coroutines.flow.SharedFlow
import kotlinx.coroutines.flow.StateFlow
import kotlinx.coroutines.flow.asSharedFlow
import kotlinx.coroutines.flow.asStateFlow
import kotlinx.coroutines.flow.receiveAsFlow
import kotlinx.coroutines.flow.first
import kotlinx.coroutines.flow.update
import kotlinx.coroutines.launch
@@ -126,6 +134,7 @@ import kotlinx.serialization.json.JsonArray
import kotlinx.serialization.json.JsonObject
import kotlinx.serialization.json.JsonPrimitive
import kotlinx.serialization.json.contentOrNull
import kotlinx.serialization.json.intOrNull
import okhttp3.sse.EventSource
import java.util.UUID
import java.util.concurrent.ConcurrentHashMap
@@ -157,17 +166,21 @@ data class ContextWindowUsage(
/**
* A successful Sessions SSE turn still needs the server-authoritative transcript
* because that transport does not stream every persisted message boundary.
* Gateway turns already deliver the assistant, reasoning, and tool lifecycle
* directly; reloading their full transcript only republishes a healthy live turn.
* A successful socket rejoin is the exception because events emitted during the
* gap cannot be replayed.
* Gateway normally delivers the assistant, reasoning, and tool lifecycle
* directly, but upstream versions can persist tool calls without emitting the
* corresponding live lifecycle events. Inspect structured history after every
* successful Gateway turn, then reload only when activity is missing (or socket
* recovery requires it), so healthy turns keep their existing UI identity. This
* deliberately never infers tool activity from assistant text.
*/
internal fun shouldReloadHistoryAfterSuccessfulTurn(
actualTransport: String,
gatewayReconcileRequired: Boolean,
missingPersistedToolActivity: Boolean,
): Boolean =
actualTransport == "sessions" ||
(actualTransport == "gateway" && gatewayReconcileRequired)
(actualTransport == "gateway" &&
(gatewayReconcileRequired || missingPersistedToolActivity))
internal fun shouldSuppressPassiveSessionError(context: String?, error: Throwable?): Boolean {
if (context != "load_sessions" && context != "load_profile_sessions") return false
@@ -509,7 +522,7 @@ class ChatViewModel : ViewModel() {
val recentPrompts: StateFlow<List<String>> = _recentPrompts.asStateFlow()
private fun recordRecentPrompt(text: String) {
val t = text.trim()
val t = (parseChatQuotedPrompt(text)?.body ?: text).trim()
if (t.isBlank() || t.startsWith("/")) return // skip blanks + slash commands
_recentPrompts.update { prev ->
(listOf(t) + prev.filterNot { it == t }).take(RECENT_PROMPTS_LIMIT)
@@ -539,6 +552,9 @@ class ChatViewModel : ViewModel() {
private val _pendingAttachments = MutableStateFlow<List<Attachment>>(emptyList())
val pendingAttachments: StateFlow<List<Attachment>> = _pendingAttachments.asStateFlow()
/** Session-keyed composer state; intentionally memory-only for attachment privacy. */
val composerDraftStore: ChatComposerDraftStore = InMemoryChatComposerDraftStore()
fun addAttachment(attachment: Attachment) {
_pendingAttachments.update { it + attachment }
}
@@ -549,6 +565,22 @@ class ChatViewModel : ViewModel() {
}
}
fun replacePendingAttachments(attachments: List<Attachment>) {
_pendingAttachments.value = attachments.toList()
}
fun moveAttachment(fromIndex: Int, toIndex: Int) {
_pendingAttachments.update { attachments ->
if (fromIndex !in attachments.indices || toIndex !in attachments.indices) {
attachments
} else {
attachments.toMutableList().apply {
add(toIndex, removeAt(fromIndex))
}
}
}
}
fun clearAttachments() {
_pendingAttachments.value = emptyList()
}
@@ -703,9 +735,13 @@ class ChatViewModel : ViewModel() {
* Refresh the gateway's curated provider/model list (`model.options`).
* Connects the gateway on demand. No-op without a gateway client.
* [refresh] is the explicit upstream refresh path for dynamic/custom-provider catalogs;
* automatic picker opens stay on the cheap cached path.
* automatic picker opens stay on the cheap cached path. [catalogOnly] updates
* choices and capability metadata without publishing a model identity.
*/
fun refreshModelOptions(refresh: Boolean = false) {
fun refreshModelOptions(
refresh: Boolean = false,
catalogOnly: Boolean = false,
) {
val gateway = gatewayClient ?: run {
android.util.Log.i("ChatViewModel", "refreshModelOptions: no gateway client")
if (refresh) _modelOptionsRefreshing.value = false
@@ -729,8 +765,19 @@ class ChatViewModel : ViewModel() {
}
modelOptionsByProfile[profileKey] = it
_modelProviders.value = it.providers
_gatewayCurrentModel.value = it.currentModel
_gatewayCurrentProvider.value = it.currentProvider
// Opening a picker refreshes catalog metadata, not session
// identity. session.info/session.resume is canonical once a
// live session exists; do not let a profile/global catalog
// response repaint its controls.
modelOptionsIdentityToPublish(
catalogOnly = catalogOnly,
hasLiveSession = hasLiveGatewaySession(),
sessionIdentity = gateway.serverModelIdentity.value,
options = it,
)?.let { identity ->
_gatewayCurrentModel.value = identity.model
_gatewayCurrentProvider.value = identity.provider
}
refreshRelayReasoningCapabilities(refresh = refresh)
android.util.Log.i(
"ChatViewModel",
@@ -977,7 +1024,10 @@ class ChatViewModel : ViewModel() {
}
}
fun fetchModels(userInitiated: Boolean = false) {
fun fetchModels(
userInitiated: Boolean = false,
catalogOnly: Boolean = false,
) {
val client = apiClient ?: return
val generation = modelOptionsGeneration.incrementAndGet()
val profileKey = modelOptionsProfileKey()
@@ -1002,8 +1052,15 @@ class ChatViewModel : ViewModel() {
)
modelOptionsByProfile[profileKey] = options
_modelProviders.value = options.providers
_gatewayCurrentModel.value = options.currentModel
_gatewayCurrentProvider.value = options.currentProvider
modelOptionsIdentityToPublish(
catalogOnly = catalogOnly,
hasLiveSession = hasLiveGatewaySession(),
sessionIdentity = gatewayClient?.serverModelIdentity?.value,
options = options,
)?.let { identity ->
_gatewayCurrentModel.value = identity.model
_gatewayCurrentProvider.value = identity.provider
}
// Keep OpenAI route aliases visible alongside authenticated
// provider inventory. An alias remains the request id while
// its root is used only to validate the provider route.
@@ -1173,10 +1230,16 @@ class ChatViewModel : ViewModel() {
// Pill update is the confirmation — no system bubble.
// Surface only a server warning, ephemerally.
warning?.let { _transientNotice.tryEmit(it) }
gateway.modelOptions().onSuccess {
_modelProviders.value = it.providers
_gatewayCurrentModel.value = it.currentModel
_gatewayCurrentProvider.value = it.currentProvider
// Current upstream may defer the switch until the turn
// boundary. Keep the optimistic requested identity; an
// immediate model.options read still reports the old
// model and would visibly snap the picker backward.
if (!isDeferredConfigResult(result)) {
gateway.modelOptions().onSuccess {
_modelProviders.value = it.providers
_gatewayCurrentModel.value = it.currentModel
_gatewayCurrentProvider.value = it.currentProvider
}
}
},
onFailure = { e ->
@@ -1560,6 +1623,9 @@ class ChatViewModel : ViewModel() {
val backgroundProcessesLoading: StateFlow<Boolean> = gatewayProcessController.loading
val stoppingProcessIds: StateFlow<Set<String>> = gatewayProcessController.stoppingProcessIds
private val _messageReactionsSupported = MutableStateFlow(true)
val messageReactionsSupported: StateFlow<Boolean> = _messageReactionsSupported.asStateFlow()
fun refreshBackgroundProcesses() {
gatewayProcessController.refresh()
}
@@ -1586,6 +1652,7 @@ class ChatViewModel : ViewModel() {
gatewayClient = client
if (changed) {
resetApprovalModeState()
_messageReactionsSupported.value = true
gatewayProcessSource = client?.let(::GatewayChatProcessSource)
gatewayProcessController.bind(
newSource = gatewayProcessSource,
@@ -2255,17 +2322,81 @@ class ChatViewModel : ViewModel() {
private val _transientNotice = MutableSharedFlow<String>(extraBufferCapacity = 8)
val transientNotice: SharedFlow<String> = _transientNotice.asSharedFlow()
fun reactToNewest(role: MessageRole, emoji: String?) {
val gateway = gatewayClient ?: return
if (role != MessageRole.USER && role != MessageRole.ASSISTANT) return
viewModelScope.launch {
gateway.reactToNewest(role.name.lowercase(), emoji).fold(
onSuccess = {
_transientNotice.tryEmit(if (emoji == null) "Reaction removed." else "Reaction added.")
},
onFailure = { error ->
if ((error as? GatewayRpcException)?.code == -32601) {
_messageReactionsSupported.value = false
_transientNotice.tryEmit("Message reactions aren't supported by this gateway.")
} else {
_transientNotice.tryEmit("Couldn't update reaction: ${error.message ?: "unknown error"}")
}
},
)
}
}
fun steerSubagent(subagentId: String, instruction: String) {
val gateway = gatewayClient ?: return
if (subagentId.isBlank() || instruction.isBlank()) return
viewModelScope.launch {
gateway.steerSubagent(subagentId, instruction).fold(
onSuccess = { result ->
val status = result.stringValue("status") ?: "queued"
_transientNotice.tryEmit(
if (status == "rejected") "Subagent redirect was rejected."
else "Subagent redirect queued.",
)
},
onFailure = { error ->
_transientNotice.tryEmit("Couldn't redirect subagent: ${error.message ?: "unknown error"}")
},
)
}
}
/**
* Composer prefill requests from server command dispatch
* (`{type:"prefill"}` — e.g. `/undo`). ChatScreen collects and sets the
* input text.
*/
private val _composerPrefill = MutableSharedFlow<String>(
replay = 0,
extraBufferCapacity = 1,
onBufferOverflow = BufferOverflow.DROP_OLDEST,
)
val composerPrefill: SharedFlow<String> = _composerPrefill.asSharedFlow()
private val _composerPrefill = Channel<String>(capacity = Channel.CONFLATED)
val composerPrefill = _composerPrefill.receiveAsFlow()
/**
* Open a fresh draft for text received through Android's sharesheet.
* The composer event is queued until Chat is composed and is never routed
* through [sendMessage]. Existing new-chat transport and background-turn
* ownership remain authoritative.
*/
fun openSharedTextDraft(text: String): Boolean {
if (text.isBlank() || chatHandler == null) return false
val canCreateDraft =
(streamingEndpoint == "gateway" && gatewayClient != null) || apiClient != null
if (!canCreateDraft) return false
createNewChat()
return _composerPrefill.trySend(text).isSuccess
}
// Navigation-safe draft handoff for explicit in-app workflows (for example,
// custom-pet creation). StateFlow keeps the reviewed text until ChatScreen
// is mounted; consuming it never sends the message.
private val _pendingComposerDraft = MutableStateFlow<String?>(null)
val pendingComposerDraft: StateFlow<String?> = _pendingComposerDraft.asStateFlow()
fun stageComposerDraft(text: String) {
_pendingComposerDraft.value = text.takeIf { it.isNotBlank() }
}
fun consumeComposerDraft(text: String) {
_pendingComposerDraft.compareAndSet(text, null)
}
/**
* One-shot request to open the personality picker — emitted when a bare
@@ -2457,9 +2588,16 @@ class ChatViewModel : ViewModel() {
* once the drawer lists a non-default profile's sessions, opening one must
* read that profile's own DB. Returns `null` off the dashboard surface.
*/
private var profileMessageLoader: (suspend (String) -> Result<List<MessageItem>>?)? = null
private var profileMessageLoader:
(suspend (String, SessionMessageLoadMode) -> Result<List<MessageItem>>?)? = null
fun setProfileMessageLoader(loader: suspend (String) -> Result<List<MessageItem>>?) {
profileMessageLoader = { sessionId, _ -> loader(sessionId) }
}
fun setProfileMessageLoaderWithMode(
loader: suspend (String, SessionMessageLoadMode) -> Result<List<MessageItem>>?,
) {
profileMessageLoader = loader
}
@@ -2472,11 +2610,12 @@ class ChatViewModel : ViewModel() {
private suspend fun loadSessionHistory(
sessionId: String,
requireProfileScope: Boolean = false,
mode: SessionMessageLoadMode = SessionMessageLoadMode.COMPLETE,
): List<MessageItem> {
if (streamingEndpoint == "gateway") {
return loadGatewaySessionHistory(sessionId, requireProfileScope)
return loadGatewaySessionHistory(sessionId, requireProfileScope, mode)
}
return apiClient?.getMessages(sessionId) ?: emptyList()
return apiClient?.getMessages(sessionId, mode) ?: emptyList()
}
/**
@@ -2488,15 +2627,16 @@ class ChatViewModel : ViewModel() {
private suspend fun loadGatewaySessionHistory(
sessionId: String,
requireProfileScope: Boolean = false,
mode: SessionMessageLoadMode = SessionMessageLoadMode.COMPLETE,
): List<MessageItem> {
val scoped = profileMessageLoader?.invoke(sessionId)
val scoped = profileMessageLoader?.invoke(sessionId, mode)
if (scoped != null) {
// A gateway profile owns a distinct state.db. Never fall through to
// the launch/default API database when its scoped read fails: an
// empty/default transcript is not authoritative for this session.
return if (requireProfileScope) scoped.getOrThrow() else scoped.getOrElse { emptyList() }
}
return apiClient?.getMessages(sessionId) ?: emptyList()
return apiClient?.getMessages(sessionId, mode) ?: emptyList()
}
/**
@@ -3164,6 +3304,16 @@ class ChatViewModel : ViewModel() {
selectedReasoningEffortConfirmedIdentity = null
_reasoningDisplay.value = null
_selectedPersonality.value = "default"
// Model/provider overrides are session-scoped too. This reset is owned
// by the context switch (not just activateGatewayProfile) so the SSE
// path cannot carry the previous profile's explicit model into the
// restored session or fresh draft.
modelOptionsGeneration.incrementAndGet()
_modelProviders.value = emptyList()
_apiModelOptions.value = emptyList()
_availableModels.value = emptyList()
_selectedModelOverride.value = null
_selectedProviderOverride.value = null
// The agent display name was stamped above with the pre-reset persona —
// recompute it now that the overlay is cleared so the header/bubbles read
// the new profile's base identity, not the old persona.
@@ -3291,8 +3441,11 @@ class ChatViewModel : ViewModel() {
* groups refresh via [refreshModelOptions]; this covers [availableModels] used
* when no gateway model.options groups exist. Fetched once otherwise.
*/
fun refreshModels(userInitiated: Boolean = false) {
fetchModels(userInitiated)
fun refreshModels(
userInitiated: Boolean = false,
catalogOnly: Boolean = false,
) {
fetchModels(userInitiated, catalogOnly)
}
/** Clear server-owned catalogs before a different connection starts loading. */
@@ -3834,7 +3987,11 @@ class ChatViewModel : ViewModel() {
// Mid-turn: redirect on the gateway transport, queue everywhere else.
if (activeStream != null) {
if (_steerableTurn.value && streamingEndpoint == "gateway") {
if (
_steerableTurn.value &&
streamingEndpoint == "gateway" &&
_pendingAttachments.value.isEmpty()
) {
steerActiveTurn(text.trim())
} else {
enqueueMessage(text.trim())
@@ -3867,6 +4024,7 @@ class ChatViewModel : ViewModel() {
role = MessageRole.USER,
content = text,
timestamp = System.currentTimeMillis(),
deliveryStatus = MessageDeliveryStatus.STEERED,
)
)
}
@@ -4586,7 +4744,7 @@ class ChatViewModel : ViewModel() {
}
"prefill" -> {
result.stringValue("notice")?.let { handler.addSystemNotice(it) }
result.stringValue("message")?.let { _composerPrefill.tryEmit(it) }
result.stringValue("message")?.let { _composerPrefill.trySend(it) }
}
else ->
handler.addSystemNotice(result.stringValue("output") ?: "Command completed.")
@@ -5401,9 +5559,24 @@ class ChatViewModel : ViewModel() {
detail = cause,
)
// A short transcript fits in Hermes' explicit latest window and can be
// polled with one bounded request. Long transcripts retain complete
// oldest-first pagination so the positional user anchor and visible
// history cannot silently shift when the oldest rows fall outside 500.
val recoveryLoadMode = if (handler.messages.value.size < SESSION_MESSAGE_PAGE_SIZE) {
SessionMessageLoadMode.LATEST
} else {
SessionMessageLoadMode.COMPLETE
}
val recovery = ChatStreamRecovery(
scope = viewModelScope,
fetchHistory = { loadSessionHistory(checkpoint.sessionId, requireProfileScope = true) },
fetchHistory = {
loadSessionHistory(
checkpoint.sessionId,
requireProfileScope = true,
mode = recoveryLoadMode,
)
},
timing = recoveryTimingOverride ?: ChatStreamRecovery.Timing(),
)
streamRecovery = recovery
@@ -5579,9 +5752,20 @@ class ChatViewModel : ViewModel() {
val priorUserCount = (
handler.messages.value.count { it.role == MessageRole.USER } - 1
).coerceAtLeast(0)
val recoveryLoadMode = if (handler.messages.value.size < SESSION_MESSAGE_PAGE_SIZE) {
SessionMessageLoadMode.LATEST
} else {
SessionMessageLoadMode.COMPLETE
}
val recovery = ChatStreamRecovery(
scope = viewModelScope,
fetchHistory = { loadSessionHistory(sessionId, requireProfileScope = true) },
fetchHistory = {
loadSessionHistory(
sessionId,
requireProfileScope = true,
mode = recoveryLoadMode,
)
},
timing = recoveryTimingOverride ?: ChatStreamRecovery.Timing(),
)
streamRecovery = recovery
@@ -7071,13 +7255,11 @@ class ChatViewModel : ViewModel() {
refreshApprovalMode()
}
// Sessions SSE does not stream every persisted message boundary, so it
// still needs the server-authoritative transcript after success. A healthy
// Gateway turn is already authoritative in memory through its structured
// assistant/reasoning/tool events; reloading the full transcript here would
// republish the entire visible list and cause a completion flash. A Gateway
// socket rejoin explicitly flags this completion for the same profile-aware
// history reconcile because events emitted during the gap may be missing.
// Stateful transports reconcile from server-authoritative history after
// success. Gateway usually streams every structured lifecycle event, but
// some upstream versions persist tool_calls without emitting tool.start /
// tool.complete. The structured reload recovers those calls without ever
// parsing assistant prose and retains the profile-aware history boundary.
val sid = handler.currentSessionId.value
// A turn that ended in an error (gateway ❌ lifecycle → "Error" badge)
// has NO assistant message persisted server-side, so reconciling the
@@ -7087,18 +7269,24 @@ class ChatViewModel : ViewModel() {
// local error visible — but still refresh the drawer + drain the queue.
if (sid != null && (completedTransport == "sessions" || completedTransport == "gateway")) {
viewModelScope.launch {
if (!turnErrored && shouldReloadHistoryAfterSuccessfulTurn(
completedTransport,
gatewayHistoryReconcileRequired,
)
) {
if (!turnErrored) {
// Profile-aware read: a gateway turn on a non-default profile
// persists into THAT profile's own state.db, so the bare
// api_server `/api/sessions/{id}/messages` 404s → emptyList()
// → a silent wipe of the just-finished turn. loadSessionHistory
// prefers the `?profile=` dashboard loader on gateway connections.
val serverMessages = loadSessionHistory(sid)
handler.loadMessageHistory(serverMessages)
val missingPersistedToolActivity =
completedTransport == "gateway" &&
handler.hasMissingPersistedToolActivity(serverMessages)
if (shouldReloadHistoryAfterSuccessfulTurn(
actualTransport = completedTransport,
gatewayReconcileRequired = gatewayHistoryReconcileRequired,
missingPersistedToolActivity = missingPersistedToolActivity,
)
) {
handler.loadMessageHistory(serverMessages)
}
}
// Re-sync the drawer now that the turn is persisted server-side.
// The only other auto-refresh fires ~160ms after session creation
@@ -8398,7 +8586,9 @@ class ChatViewModel : ViewModel() {
}
private fun queuedPromptPreview(prompt: String, maxChars: Int = 96): String {
val compact = prompt.replace(Regex("\\s+"), " ").trim()
val compact = (parseChatQuotedPrompt(prompt)?.body ?: prompt)
.replace(Regex("\\s+"), " ")
.trim()
return if (compact.length <= maxChars) compact else compact.take(maxChars - 1).trimEnd() + "…"
}
@@ -8486,6 +8676,19 @@ internal fun parseCommandsCatalog(catalog: JsonObject): List<SlashCommand> {
}
val seen = mutableSetOf<String>()
val out = mutableListOf<SlashCommand>()
val skillMetadata = (catalog["skills"] as? JsonObject)
?.entries
?.take(MAX_CATALOG_SKILLS)
?.associate { (rawName, element) ->
val normalized = if (rawName.startsWith("/")) rawName.lowercase() else "/${rawName.lowercase()}"
val metadata = element as? JsonObject
val usage = (metadata?.get("usage") as? JsonPrimitive)?.intOrNull
?.coerceIn(0, MAX_SKILL_USAGE) ?: 0
val origin = metadata?.stringValue("origin")
?.trim()?.take(MAX_SKILL_ORIGIN_CHARS)?.takeIf { it.isNotBlank() }
normalized to (usage to origin)
}
.orEmpty()
(catalog["pairs"] as? JsonArray)?.forEach { pairElement ->
val pair = pairElement as? JsonArray ?: return@forEach
val rawName = (pair.getOrNull(0) as? JsonPrimitive)?.contentOrNull?.trim()
@@ -8494,16 +8697,35 @@ internal fun parseCommandsCatalog(catalog: JsonObject): List<SlashCommand> {
if (isUnsupportedMobileCommand(name, pair)) return@forEach
if (!seen.add(name.lowercase())) return@forEach
val description = (pair.getOrNull(1) as? JsonPrimitive)?.contentOrNull?.trim().orEmpty()
val skill = skillMetadata[name.lowercase()]
out += SlashCommand(
command = name,
description = description.ifBlank { "Server command" },
category = categoryByName[name.lowercase()] ?: SlashCommand.CATEGORY_SERVER,
source = SlashCommand.SOURCE_SERVER,
usageRank = skill?.first ?: 0,
origin = skill?.second,
)
}
return out
// Preserve every non-skill command's exact catalog position. Rank only
// entries occupying skill slots, so built-ins and quick commands do not
// jump around when usage changes.
val rankedSkills = out.filter { skillMetadata.containsKey(it.command.lowercase()) }
.sortedWith(compareByDescending<SlashCommand> { it.usageRank }.thenBy { it.command })
.iterator()
return out.map { command ->
if (skillMetadata.containsKey(command.command.lowercase())) rankedSkills.next() else command
}
}
private const val MAX_CATALOG_SKILLS = 512
private const val MAX_SKILL_USAGE = 1_000_000_000
private const val MAX_SKILL_ORIGIN_CHARS = 32
internal fun isDeferredConfigResult(result: JsonObject): Boolean =
(result["deferred"] as? JsonPrimitive)?.contentOrNull
?.trim()?.lowercase() in setOf("true", "1", "yes")
/** Dashboard `/api/config` response -> the same personality catalog as API mode. */
internal fun parseDashboardPersonalityConfig(
root: JsonObject,
@@ -14,10 +14,14 @@ import com.hermesandroid.relay.auth.AuthManager
import com.hermesandroid.relay.auth.AuthState
import com.hermesandroid.relay.ui.theme.AppFont
import com.hermesandroid.relay.ui.theme.AppThemes
import com.hermesandroid.relay.ui.theme.normalizeAccentHex
import com.hermesandroid.relay.ui.theme.AppearanceShape
import com.hermesandroid.relay.ui.components.avatar.PetImporter
import com.hermesandroid.relay.ui.components.avatar.PetImportResult
import com.hermesandroid.relay.ui.components.avatar.PetLoader
import com.hermesandroid.relay.ui.components.avatar.SphereAvatar
import com.hermesandroid.relay.ui.components.SphereSkinImportResult
import com.hermesandroid.relay.ui.components.SphereSkinImporter
import com.hermesandroid.relay.ui.components.pet.PetLogicalEdge
import com.hermesandroid.relay.ui.components.pet.PetPlacement
import com.hermesandroid.relay.auth.PairedDeviceInfo
@@ -37,6 +41,8 @@ import com.hermesandroid.relay.data.DEFAULT_PET_SIZE_SCALE
import com.hermesandroid.relay.data.PetBehaviorPreferences
import com.hermesandroid.relay.data.PetBehaviorPreferencesRepository
import com.hermesandroid.relay.data.PetTemperament
import com.hermesandroid.relay.data.ChatInputPreferencesRepository
import com.hermesandroid.relay.data.PhysicalKeyboardEnterBehavior
import com.hermesandroid.relay.data.RelayEndpoint
import com.hermesandroid.relay.data.primaryRouteUrl
import com.hermesandroid.relay.data.routeAuthority
@@ -70,6 +76,7 @@ import com.hermesandroid.relay.network.relay.ConnectionState
import com.hermesandroid.relay.network.upstream.DashboardApiClient
import com.hermesandroid.relay.network.upstream.DashboardChatDisplaySettings
import com.hermesandroid.relay.network.upstream.models.MessageItem
import com.hermesandroid.relay.network.upstream.SessionMessageLoadMode
import com.hermesandroid.relay.network.upstream.models.SessionItem
import com.hermesandroid.relay.network.upstream.mirrorDashboardSessionCookies
import com.hermesandroid.relay.network.upstream.DashboardAuthSession
@@ -343,6 +350,11 @@ internal fun profileApiCredential(
connectionKey: String,
): String = if (usesMultiplexProfileKey) profileKey.orEmpty() else connectionKey
internal fun migratedBackgroundAvatar(
storedBackgroundAvatar: String?,
legacyAgentAvatar: String?,
): String = storedBackgroundAvatar ?: legacyAgentAvatar ?: SphereAvatar.id
class ConnectionViewModel(application: Application) : AndroidViewModel(application) {
private val ctx: Context get() = getApplication()
@@ -396,6 +408,10 @@ class ConnectionViewModel(application: Application) : AndroidViewModel(applicati
// Selected app theme id (palette/personality). Orthogonal to KEY_THEME,
// which is the light/dark/auto mode axis honored by BOTH-mode themes.
private val KEY_APP_THEME = stringPreferencesKey("app_theme")
// Optional RGB accent override applied on top of the selected preset.
// Null means the preset's authored accent remains authoritative.
private val KEY_APPEARANCE_ACCENT = stringPreferencesKey("appearance_accent")
private val KEY_APPEARANCE_SHAPE = stringPreferencesKey("appearance_shape")
// Selected app font id (body typeface). Resolved against AppFont at the
// Compose theme root; defaults to Inter. Orthogonal to KEY_FONT_SCALE
// (which scales sizes); this picks the family.
@@ -403,12 +419,14 @@ class ConnectionViewModel(application: Application) : AndroidViewModel(applicati
// Selected sphere skin id. "auto" (SphereRegistry.AUTO_ID) follows the
// active theme's preferred skin; any other id pins a specific skin.
private val KEY_SPHERE_SKIN = stringPreferencesKey("sphere_skin")
// Legacy combined sphere/pet choice. Read for one release so existing
// users keep their selected pet when the concepts split.
// Legacy combined sphere/pet choice. Read during migration so existing
// users retain both their prior central visual and companion choice.
private val KEY_AGENT_AVATAR = stringPreferencesKey("agent_avatar")
// Optional floating companion id. The explicit sentinel distinguishes
// "no pet" from a preference that has not yet been migrated.
private val KEY_FLOATING_PET = stringPreferencesKey("floating_pet")
// Central visualization selection, independent from the floating pet.
private val KEY_BACKGROUND_AVATAR = stringPreferencesKey("background_avatar")
// Reserved storage sentinel. Pet ids may legitimately be ordinary words
// such as "none", so keep the no-selection marker outside that space.
private const val NO_FLOATING_PET = "__none__"
@@ -466,6 +484,8 @@ class ConnectionViewModel(application: Application) : AndroidViewModel(applicati
private val petBehaviorPreferencesRepository =
PetBehaviorPreferencesRepository(application)
private val chatInputPreferencesRepository =
ChatInputPreferencesRepository(application)
// --- Core networking components ---
@@ -1302,6 +1322,14 @@ class ConnectionViewModel(application: Application) : AndroidViewModel(applicati
}
.stateIn(viewModelScope, SharingStarted.Eagerly, AppThemes.DEFAULT_ID)
val appearanceAccent: StateFlow<String?> = application.relayDataStore.data
.map { preferences -> normalizeAccentHex(preferences[KEY_APPEARANCE_ACCENT]) }
.stateIn(viewModelScope, SharingStarted.Eagerly, null)
val appearanceShape: StateFlow<String> = application.relayDataStore.data
.map { preferences -> AppearanceShape.fromId(preferences[KEY_APPEARANCE_SHAPE]).id }
.stateIn(viewModelScope, SharingStarted.Eagerly, AppearanceShape.DEFAULT.id)
// Selected app font id (body typeface). Defaults to Inter. Resolved against
// AppFont.byId at the Compose theme root, which rebuilds Typography so the
// whole app re-themes live when this changes.
@@ -1319,8 +1347,8 @@ class ConnectionViewModel(application: Application) : AndroidViewModel(applicati
}
.stateIn(viewModelScope, SharingStarted.Eagerly, "auto")
// Optional floating companion. For one release, an absent new key reads the
// legacy combined selection: sphere -> no companion; a pet id -> companion.
// Optional floating companion. An absent split key reads the legacy combined
// selection: sphere -> no companion; a pet id -> companion.
val floatingPet: StateFlow<String?> = application.relayDataStore.data
.map { preferences ->
val selected = preferences[KEY_FLOATING_PET]
@@ -1330,6 +1358,16 @@ class ConnectionViewModel(application: Application) : AndroidViewModel(applicati
}
.stateIn(viewModelScope, SharingStarted.Eagerly, null)
/** Sphere or a validated pet-format asset rendered on central/ambient surfaces. */
val backgroundAvatar: StateFlow<String> = application.relayDataStore.data
.map { preferences ->
migratedBackgroundAvatar(
storedBackgroundAvatar = preferences[KEY_BACKGROUND_AVATAR],
legacyAgentAvatar = preferences[KEY_AGENT_AVATAR],
)
}
.stateIn(viewModelScope, SharingStarted.Eagerly, SphereAvatar.id)
/** Whether the selected companion may autonomously move between safe perches. */
val petRoamingEnabled: StateFlow<Boolean> = application.relayDataStore.data
.map { preferences -> preferences[KEY_PET_ROAMING_ENABLED] ?: false }
@@ -1455,8 +1493,13 @@ class ConnectionViewModel(application: Application) : AndroidViewModel(applicati
suspend fun listProfileScopedSessions(limit: Int = 200): Result<List<SessionItem>>? =
profileController.listProfileScopedSessions(limit)
suspend fun loadProfileScopedMessages(sessionId: String): Result<List<MessageItem>>? =
profileController.loadProfileScopedMessages(sessionId)
suspend fun listAllProfileSessions(limit: Int = 200): Result<List<SessionItem>>? =
profileController.listAllProfileSessions(limit)
suspend fun loadProfileScopedMessages(
sessionId: String,
mode: SessionMessageLoadMode = SessionMessageLoadMode.COMPLETE,
): Result<List<MessageItem>>? = profileController.loadProfileScopedMessages(sessionId, mode)
/**
* Delete a session scoped to the ACTIVE PROFILE via the dashboard
@@ -1523,6 +1566,9 @@ class ConnectionViewModel(application: Application) : AndroidViewModel(applicati
/** The active profile's local agent-icon path (client-side, never sent to Hermes). */
val profileIcon: StateFlow<String?> get() = profileController.profileIcon
/** A local icon path for a specific profile identity on the active connection. */
fun profileIconFlow(profileName: String?) = profileController.profileIconFlow(profileName)
val hostProfileIconImportState: StateFlow<ProfileController.HostIconImportState>
get() = profileController.hostIconImportState
@@ -1548,7 +1594,7 @@ class ConnectionViewModel(application: Application) : AndroidViewModel(applicati
/** Lock the active connection to [profile] (null = Server default). */
fun lockProfile(profile: Profile?) {
viewModelScope.launch { profileController.lockProfile(profile) }
profileController.lockProfile(profile)
}
/** Remove the active connection's profile lock. */
@@ -1811,8 +1857,8 @@ class ConnectionViewModel(application: Application) : AndroidViewModel(applicati
}
init {
// Materialize the split preference once. Keeping the legacy read above
// for one release also covers interrupted upgrades and older backups.
// Materialize the independent central and floating preferences. Legacy
// users retain the prior visual in both roles until they choose otherwise.
viewModelScope.launch {
getApplication<Application>().relayDataStore.edit { preferences ->
if (preferences[KEY_FLOATING_PET] == null) {
@@ -1820,6 +1866,12 @@ class ConnectionViewModel(application: Application) : AndroidViewModel(applicati
?.takeUnless { it == SphereAvatar.id }
?: NO_FLOATING_PET
}
if (preferences[KEY_BACKGROUND_AVATAR] == null) {
preferences[KEY_BACKGROUND_AVATAR] = migratedBackgroundAvatar(
storedBackgroundAvatar = null,
legacyAgentAvatar = preferences[KEY_AGENT_AVATAR],
)
}
// Before presence and motion were split, animation_enabled also
// controlled whether the Sphere was shown. Preserve that choice
// on upgrade; users can then re-enable a static Sphere separately.
@@ -1950,6 +2002,15 @@ class ConnectionViewModel(application: Application) : AndroidViewModel(applicati
}
}
fun setBackgroundAvatar(avatarId: String) {
viewModelScope.launch {
getApplication<Application>().relayDataStore.edit { preferences ->
preferences[KEY_BACKGROUND_AVATAR] = avatarId.ifBlank { SphereAvatar.id }
preferences[KEY_BACKGROUND_VISUALIZATION_ENABLED] = true
}
}
}
fun setImageGenerationStyle(value: String) {
val normalized = value.takeIf {
it in setOf("rotate", "grid", "sphere", "nodes")
@@ -2053,6 +2114,20 @@ class ConnectionViewModel(application: Application) : AndroidViewModel(applicati
}
}
val physicalKeyboardEnterBehavior: StateFlow<PhysicalKeyboardEnterBehavior> =
chatInputPreferencesRepository.physicalKeyboardEnterBehavior
.stateIn(
viewModelScope,
SharingStarted.Eagerly,
PhysicalKeyboardEnterBehavior.SendMessage,
)
fun setPhysicalKeyboardEnterBehavior(behavior: PhysicalKeyboardEnterBehavior) {
viewModelScope.launch {
chatInputPreferencesRepository.setPhysicalKeyboardEnterBehavior(behavior)
}
}
// Turn-complete notification (default ON). RelayApp mirrors this into
// ChatViewModel.notifyOnTurnComplete; ChatSettingsScreen owns the toggle
// + the POST_NOTIFICATIONS runtime request on first enable.
@@ -6435,7 +6510,10 @@ class ConnectionViewModel(application: Application) : AndroidViewModel(applicati
fun saveLastSessionId(sessionId: String?) {
_lastSessionId.value = sessionId
val connectionId = activeConnectionId.value
val profileName = profileController.resolveSessionProfileName()
// Last-session persistence follows the selected UI profile identity.
// The null Server-default sentinel stays separate from whichever named
// profile the server's sticky default currently resolves to.
val profileName = profileController.selectedProfile.value?.name
viewModelScope.launch {
if (connectionId != null) {
if (sessionId != null) {
@@ -6467,7 +6545,7 @@ class ConnectionViewModel(application: Application) : AndroidViewModel(applicati
}
}
}
if (profileName == null || AgentDisplay.isServerDefaultAlias(profileName)) {
if (profileName == null) {
getApplication<Application>().relayDataStore.edit { preferences ->
if (sessionId != null) {
preferences[KEY_LAST_SESSION_ID] = sessionId
@@ -6594,6 +6672,59 @@ class ConnectionViewModel(application: Application) : AndroidViewModel(applicati
}
}
/** Apply or reset the local accent override. Invalid values safely reset. */
fun setAppearanceAccent(accentHex: String?) {
viewModelScope.launch {
getApplication<Application>().relayDataStore.edit { preferences ->
val normalized = normalizeAccentHex(accentHex)
if (normalized == null) preferences.remove(KEY_APPEARANCE_ACCENT)
else preferences[KEY_APPEARANCE_ACCENT] = normalized
}
}
}
fun setAppearanceShape(shapeId: String) {
viewModelScope.launch {
getApplication<Application>().relayDataStore.edit { preferences ->
preferences[KEY_APPEARANCE_SHAPE] = AppearanceShape.fromId(shapeId).id
}
}
}
/** Import one declarative sphere-skin JSON file, select it, then hot-refresh Appearance. */
fun importSphereSkin(uri: Uri) {
viewModelScope.launch {
val result = withContext(Dispatchers.IO) {
SphereSkinImporter.importUri(getApplication<Application>(), uri)
}
when (result) {
is SphereSkinImportResult.Success -> {
setSphereSkin(result.id)
refreshAgentAvatars()
_avatarEvents.tryEmit("Imported “${result.label}”")
}
is SphereSkinImportResult.Failure -> _avatarEvents.tryEmit(result.reason)
}
}
}
/** Import a validated pet-format asset for the central/background renderer. */
fun importBackgroundAnimation(uri: Uri) {
viewModelScope.launch {
val result = withContext(Dispatchers.IO) {
PetImporter.importUri(getApplication<Application>(), uri)
}
when (result) {
is PetImportResult.Success -> {
setBackgroundAvatar(result.id)
refreshAgentAvatars()
_avatarEvents.tryEmit("Imported background “${result.label}”")
}
is PetImportResult.Failure -> _avatarEvents.tryEmit(result.reason)
}
}
}
/** Delete a user pet by id; clear it if it was the selected companion. */
fun deleteUserAvatar(avatarId: String, label: String) {
viewModelScope.launch {
@@ -6602,6 +6733,7 @@ class ConnectionViewModel(application: Application) : AndroidViewModel(applicati
}
if (deleted) {
if (floatingPet.value == avatarId) setFloatingPet(null)
if (backgroundAvatar.value == avatarId) setBackgroundAvatar(SphereAvatar.id)
refreshAgentAvatars()
_avatarEvents.tryEmit("Removed “$label”")
} else {
@@ -93,6 +93,16 @@ import com.hermesandroid.relay.data.VoiceAudioRoute
*/
enum class VoiceState { Idle, Listening, Transcribing, Thinking, Speaking, Error }
internal fun canSpeakSettledResponse(
state: VoiceUiState,
providerRealtimeAgentTurnActive: Boolean,
): Boolean = state.state == VoiceState.Idle && !providerRealtimeAgentTurnActive
internal fun ownsVoiceAudioCompletion(
voiceMode: Boolean,
responseSpeechActive: Boolean,
): Boolean = voiceMode || responseSpeechActive
private enum class StandardSpeechStreamState {
Idle,
Opening,
@@ -731,6 +741,10 @@ class VoiceViewModel(application: Application) : AndroidViewModel(application) {
private val _uiState = MutableStateFlow(VoiceUiState())
val uiState: StateFlow<VoiceUiState> = _uiState.asStateFlow()
/** True only for one-shot narration started from a settled chat message. */
private val _responseSpeechActive = MutableStateFlow(false)
val responseSpeechActive: StateFlow<Boolean> = _responseSpeechActive.asStateFlow()
private val _voicePreviewState = MutableStateFlow(VoicePreviewUiState())
val voicePreviewState: StateFlow<VoicePreviewUiState> = _voicePreviewState.asStateFlow()
private var voicePreviewJob: Job? = null
@@ -2233,7 +2247,7 @@ class VoiceViewModel(application: Application) : AndroidViewModel(application) {
* per-turn state, and go back to Idle ("stop" means ready to start a
* new turn on the next mic tap).
*/
fun interruptSpeaking(): Job? {
fun interruptSpeaking(cancelActiveTurn: Boolean = true): Job? {
cancelPendingListeningStart()
Log.i(
TAG,
@@ -2242,13 +2256,14 @@ class VoiceViewModel(application: Application) : AndroidViewModel(application) {
// Stop = "stop talking", not "kill my task": with a background run
// active, silence the audio pipeline below but leave the run alive —
// the chip's ✕ is the explicit cancel affordance.
val realtimeTurnWasActive =
_responseSpeechActive.value = false
val realtimeTurnWasActive = cancelActiveTurn &&
voiceEngineMode == VoiceEngineMode.RealtimeAgent && providerRealtimeAgentTurnActive.get()
val backgroundPhase = _uiState.value.backgroundRun?.phase
val backgroundRunActive = preserveRealtimeTurnOnStop(backgroundPhase)
val backgroundRunActive = cancelActiveTurn && preserveRealtimeTurnOnStop(backgroundPhase)
if (backgroundRunActive) {
Log.i(TAG, "Interrupt with background run active — stopping audio only")
} else {
} else if (cancelActiveTurn) {
cancelRealtimeAgentTurn("interrupt")
}
if (realtimeTurnWasActive && rtAssistantMessageId.isNotBlank() && !backgroundRunActive) {
@@ -2278,13 +2293,17 @@ class VoiceViewModel(application: Application) : AndroidViewModel(application) {
drainRealtimeTtsQueue()
try { player?.stop() } catch (_: Exception) { /* ignore */ }
try { realtimePcmPlayer?.stop() } catch (_: Exception) { /* ignore */ }
// Stop the upstream SSE stream so the agent quits generating tokens.
try { chatViewModel?.cancelStream() } catch (_: Exception) { /* ignore */ }
streamObserverJob?.cancel()
streamObserverJob = null
currentTurnJob?.cancel()
currentTurnJob = null
continuousLoopArmed = false
if (cancelActiveTurn) {
// Voice-mode Stop owns the turn and cancels generation. A context-
// menu narration owns audio only; stopping it must not cancel a new
// chat turn the user may have submitted while listening.
try { chatViewModel?.cancelStream() } catch (_: Exception) { /* ignore */ }
streamObserverJob?.cancel()
streamObserverJob = null
currentTurnJob?.cancel()
currentTurnJob = null
continuousLoopArmed = false
}
continuousResumeJob?.cancel()
continuousResumeJob = null
realtimeAmplitudeDecayJob?.cancel()
@@ -2336,18 +2355,22 @@ class VoiceViewModel(application: Application) : AndroidViewModel(application) {
return bargeInReaderRelease
}
/** Stop one-shot message narration without cancelling chat generation. */
fun stopResponseSpeech(): Boolean {
if (!_responseSpeechActive.value) return false
interruptSpeaking(cancelActiveTurn = false)
return true
}
/**
* Replays a completed chat response through the currently selected voice
* output. The UI exposes this only in idle Conversation mode, but the
* state checks remain here so non-UI callers cannot overlap a live turn.
* output. This is intentionally independent of Voice Mode: a configured
* voice can read a settled chat reply directly from its message menu. The
* state checks remain here so non-UI callers cannot overlap live playback.
*/
fun speakResponse(text: String): Boolean {
val state = _uiState.value
if (
!state.voiceMode ||
state.state != VoiceState.Idle ||
providerRealtimeAgentTurnActive.get()
) {
if (!canSpeakSettledResponse(state, providerRealtimeAgentTurnActive.get())) {
return false
}
@@ -2355,6 +2378,7 @@ class VoiceViewModel(application: Application) : AndroidViewModel(application) {
if (spoken.isBlank()) return false
realtimeAudioSuppressed = false
_responseSpeechActive.value = true
_uiState.update {
it.copy(
state = VoiceState.Speaking,
@@ -2365,6 +2389,7 @@ class VoiceViewModel(application: Application) : AndroidViewModel(application) {
}
val queued = enqueueSentenceForTts(spoken, immediate = true)
if (!queued) {
_responseSpeechActive.value = false
_uiState.update {
it.copy(state = VoiceState.Idle, outputAudioActive = false)
}
@@ -5435,7 +5460,9 @@ class VoiceViewModel(application: Application) : AndroidViewModel(application) {
delay(initialDelayMs.coerceIn(AUDIO_COMPLETION_RETRY_MS, AUDIO_COMPLETION_MAX_SLEEP_MS))
repeat(120) {
val state = _uiState.value
if (!state.voiceMode || isMicCaptureActive()) {
if (!ownsVoiceAudioCompletion(state.voiceMode, _responseSpeechActive.value) ||
isMicCaptureActive()
) {
return@launch
}
@@ -5483,7 +5510,10 @@ class VoiceViewModel(application: Application) : AndroidViewModel(application) {
estimate
}
return decideAgentAudioCompletion(
voiceMode = _uiState.value.voiceMode,
voiceMode = ownsVoiceAudioCompletion(
_uiState.value.voiceMode,
_responseSpeechActive.value,
),
observerStopped = streamObserverJob?.isActive != true,
pendingTtsWork = pendingInTtsQueue.get() +
if (standardSpeechStreamState == StandardSpeechStreamState.Opening ||
@@ -5501,6 +5531,7 @@ class VoiceViewModel(application: Application) : AndroidViewModel(application) {
private fun finishAgentAudioOutput() {
continuousResumeJob = null
_responseSpeechActive.value = false
stopBargeInListener()
cancelStandardSpeechStream("audio output finished")
realtimeAmplitudeDecayJob?.cancel()
@@ -18,11 +18,13 @@ import com.hermesandroid.relay.network.upstream.DashboardApiClient
import com.hermesandroid.relay.network.upstream.DashboardProfileScope
import com.hermesandroid.relay.network.upstream.GatewayAvailability
import com.hermesandroid.relay.network.upstream.models.MessageItem
import com.hermesandroid.relay.network.upstream.SessionMessageLoadMode
import com.hermesandroid.relay.network.upstream.models.SessionItem
import com.hermesandroid.relay.network.relay.RelayHttpClient
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.ExperimentalCoroutinesApi
import kotlinx.coroutines.flow.Flow
import kotlinx.coroutines.flow.MutableStateFlow
import kotlinx.coroutines.flow.SharingStarted
import kotlinx.coroutines.flow.StateFlow
@@ -181,7 +183,7 @@ class ProfileController(
// Pending state still points at a previous connection mid-switch —
// hold until this connection's restore re-stamps the pending name.
pendingConnId != connId -> false
pendingName == null || AgentDisplay.isServerDefaultAlias(pendingName) ->
pendingName == null || pendingName == AgentDisplay.SERVER_DEFAULT_PROFILE_KEY ->
serverDefaultSettled
// Non-default name pending: settled once the profile list is present
// (resolution attempted), even if the name turns out to be gone.
@@ -269,6 +271,13 @@ class ProfileController(
}
}.stateIn(scope, SharingStarted.Eagerly, null)
/** Local icon for any profile identity on the active connection. */
fun profileIconFlow(profileName: String?): Flow<String?> = activeConnectionId
.flatMapLatest { connectionId ->
if (connectionId == null) flowOf(null)
else profileIconStore.iconFlow(connectionId, profileName)
}
data class HostIconImportState(
val loading: Boolean = false,
val error: String? = null,
@@ -335,17 +344,26 @@ class ProfileController(
.listSessions(profile = profileName, limit = limit, archived = "include")
}
suspend fun listAllProfileSessions(limit: Int = 200): Result<List<SessionItem>>? {
val connectionId = activeConnectionId.value ?: return null
val dashboardUrl = activeDashboardUrlProvider() ?: return null
return dashboardClientFactory(connectionId, dashboardUrl).listAllProfileSessions(limit)
}
/**
* A session's transcript, scoped to the active profile via the dashboard
* `/api/sessions/{id}/messages?profile=`. Returns `null` off the dashboard
* surface so the caller falls back to the api_server transcript.
*/
suspend fun loadProfileScopedMessages(sessionId: String): Result<List<MessageItem>>? {
suspend fun loadProfileScopedMessages(
sessionId: String,
mode: SessionMessageLoadMode = SessionMessageLoadMode.COMPLETE,
): Result<List<MessageItem>>? {
val connectionId = activeConnectionId.value ?: return null
val dashboardUrl = activeDashboardUrlProvider() ?: return null
val profileName = resolveSessionProfileName()
return dashboardClientFactory(connectionId, dashboardUrl)
.getSessionMessages(sessionId, profileName)
.getSessionMessages(sessionId, profileName, mode)
}
suspend fun deleteProfileScopedSession(sessionId: String): Boolean {
@@ -499,8 +517,8 @@ class ProfileController(
/**
* The stored lock-token for a (possibly null) profile. Server default —
* including the synthetic "default" alias — maps to
* [AgentDisplay.SERVER_DEFAULT_PROFILE_KEY]; everything else to its name.
* A null selection maps to [AgentDisplay.SERVER_DEFAULT_PROFILE_KEY]; a
* profile literally named `default`, like every named profile, maps to its name.
* Mirrors [AgentDisplay.profileSessionKey] so the lock token and the
* session/selection key for the same profile always agree.
*/
@@ -610,11 +628,6 @@ class ProfileController(
}
val current = _selectedProfile.value
if (current != null) {
if (AgentDisplay.isServerDefaultAlias(current.name)) {
_selectedProfile.value = null
_pendingSelectedProfileName.value = null
return true
}
val refreshed = list.firstOrNull { it.name == current.name }
if (refreshed != null) {
if (refreshed != current) {
@@ -628,7 +641,7 @@ class ProfileController(
return true
}
val pendingName = _pendingSelectedProfileName.value ?: return false
if (AgentDisplay.isServerDefaultAlias(pendingName)) {
if (pendingName == AgentDisplay.SERVER_DEFAULT_PROFILE_KEY) {
_pendingSelectedProfileName.value = null
_selectedProfile.value = null
return true
@@ -652,9 +665,7 @@ class ProfileController(
* can name it and so a later list arrival can recover it.
*/
private fun resolveLockedProfileFrom(token: String, list: List<Profile>): Boolean {
if (AgentDisplay.isServerDefaultAlias(token) ||
token == AgentDisplay.SERVER_DEFAULT_PROFILE_KEY
) {
if (token == AgentDisplay.SERVER_DEFAULT_PROFILE_KEY) {
_pendingSelectedProfileName.value = null
val changed = _selectedProfile.value != null
_selectedProfile.value = null
@@ -678,22 +689,21 @@ class ProfileController(
/**
* Lock the active connection to [profile]. A `null` argument locks to
* **Server default** (stored as the [AgentDisplay.SERVER_DEFAULT_PROFILE_KEY]
* sentinel so it's distinct from "unlocked"). Persists the lock, then forces
* the selection to the locked target via the normal [selectProfile] path so
* sentinel so it's distinct from "unlocked"). Forces the selection at the
* ViewModel boundary, then persists the lock so
* the existing profile-switch machinery (fresh draft, gateway hot-swap, chat
* API rebuild) runs. Locking to the already-selected profile is effectively
* a no-op for the selection but still records the lock.
*/
suspend fun lockProfile(profile: Profile?) {
fun lockProfile(profile: Profile?) {
val connectionId = activeConnectionId.value ?: return
val normalizedProfile = AgentDisplay.normalizeSelection(profile)
val token = lockTokenFor(normalizedProfile)
// Persist the lock first, then force-select via the un-gated body so the
// switch lands even when re-locking from a different target (the
// lockedProfileName StateFlow may still hold the previous token until the
// DataStore emission propagates).
profileLockStore.setLockedProfile(connectionId, token)
// Force-select synchronously so callers can immediately detach/clear the
// old Gateway session against the new profile identity. Persistence is
// serialized by DataStore and the lock StateFlow catches up afterward.
applyProfileSelection(normalizedProfile)
scope.launch { profileLockStore.setLockedProfile(connectionId, token) }
}
/** Remove the lock for the active connection (back to free profile choice). */
@@ -729,7 +739,11 @@ class ProfileController(
// current transport can't resume is exactly what forks a session
// mid-conversation on a non-default profile.
val transport = activeSessionTransport() ?: return
val sessionProfileName = resolveSessionProfileName(profileName)
// Persist the UI selection identity, not the resolved server route.
// Server default may currently route to a sticky profile named
// `default` (or any other name), but its last-session slot must remain
// distinct from explicitly selecting that named profile.
val sessionProfileName = profileName
scope.launch {
val profileScoped = profileSessionStore
.sessionIdFlow(connectionId, sessionProfileName, transport)
@@ -738,7 +752,7 @@ class ProfileController(
// pre-transport (untransported) pointer is still resumable — surface
// it as the fallback only for the server-default context.
val legacyDefault = if (
sessionProfileName == null || AgentDisplay.isServerDefaultAlias(sessionProfileName)
sessionProfileName == null
) {
legacyDefaultSessionId()
} else {
@@ -0,0 +1,10 @@
<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="pending_attachment_preview_named">Prévia de %1$s</string>
<string name="pending_attachment_remove">Remover %1$s</string>
<string name="pending_attachment_move_left">Mover %1$s para a esquerda</string>
<string name="pending_attachment_move_right">Mover %1$s para a direita</string>
<string name="pending_attachment_status_loading">Preparando prévia</string>
<string name="pending_attachment_status_ready">Pronto</string>
<string name="pending_attachment_status_failed">Prévia indisponível</string>
</resources>
+121
View File
@@ -694,6 +694,9 @@
<string name="chat_settings_recent_prompt_chips_desc">Mostre suas mensagens recentes como chips tocáveis acima do editor para enviá-las novamente. Desativado por padrão.</string>
<string name="chat_settings_keep_keyboard_open">Manter o teclado aberto ao enviar</string>
<string name="chat_settings_keep_keyboard_open_desc">Permaneça no editor após enviar. Desative para fechar o teclado depois de cada mensagem enviada.</string>
<string name="chat_settings_physical_keyboard_enter">Tecla Enter do teclado físico</string>
<string name="chat_settings_physical_keyboard_enter_desc">Escolha se Enter envia ou insere uma nova linha. Ctrl+Enter sempre envia.</string>
<string name="chat_settings_insert_newline">Inserir nova linha</string>
<string name="chat_settings_notify_when_finishes">Alertas de chat em segundo plano</string>
<string name="chat_settings_notify_when_finishes_desc">Notifique quando o Hermes precisar de uma resposta ou terminar em segundo plano</string>
<string name="chat_settings_share_phone_status">Compartilhar o status do celular com o agente</string>
@@ -2445,6 +2448,23 @@
<string name="image_generation_rendering">Gerando imagem</string>
<string name="tool_progress_cd_collapse">Recolher</string>
<string name="tool_progress_cd_expand">Expandir</string>
<string name="tool_progress_state_expanded">Expandido</string>
<string name="tool_progress_state_collapsed">Recolhido</string>
<string name="tool_run_preparing">Preparando %1$s</string>
<string name="tool_run_running">Executando %1$s</string>
<string name="tool_run_finished">%1$s concluído</string>
<plurals name="tool_run_reading"><item quantity="one">Lendo %d item</item><item quantity="many">Lendo %d itens</item><item quantity="other">Lendo %d itens</item></plurals>
<plurals name="tool_run_read"><item quantity="one">Leu %d item</item><item quantity="many">Leu %d itens</item><item quantity="other">Leu %d itens</item></plurals>
<plurals name="tool_run_searching"><item quantity="one">Pesquisando %d fonte</item><item quantity="many">Pesquisando %d fontes</item><item quantity="other">Pesquisando %d fontes</item></plurals>
<plurals name="tool_run_searched"><item quantity="one">Pesquisou %d fonte</item><item quantity="many">Pesquisou %d fontes</item><item quantity="other">Pesquisou %d fontes</item></plurals>
<plurals name="tool_run_running_commands"><item quantity="one">Executando %d comando</item><item quantity="many">Executando %d comandos</item><item quantity="other">Executando %d comandos</item></plurals>
<plurals name="tool_run_ran_commands"><item quantity="one">Executou %d comando</item><item quantity="many">Executou %d comandos</item><item quantity="other">Executou %d comandos</item></plurals>
<plurals name="tool_run_browsing"><item quantity="one">Executando %d ação do navegador</item><item quantity="many">Executando %d ações do navegador</item><item quantity="other">Executando %d ações do navegador</item></plurals>
<plurals name="tool_run_browsed"><item quantity="one">Executou %d ação do navegador</item><item quantity="many">Executou %d ações do navegador</item><item quantity="other">Executou %d ações do navegador</item></plurals>
<plurals name="tool_run_using_device"><item quantity="one">Executando %d ação do dispositivo</item><item quantity="many">Executando %d ações do dispositivo</item><item quantity="other">Executando %d ações do dispositivo</item></plurals>
<plurals name="tool_run_used_device"><item quantity="one">Executou %d ação do dispositivo</item><item quantity="many">Executou %d ações do dispositivo</item><item quantity="other">Executou %d ações do dispositivo</item></plurals>
<plurals name="tool_run_using_tools"><item quantity="one">Usando %d ferramenta</item><item quantity="many">Usando %d ferramentas</item><item quantity="other">Usando %d ferramentas</item></plurals>
<plurals name="tool_run_used_tools"><item quantity="one">Usou %d ferramenta</item><item quantity="many">Usou %d ferramentas</item><item quantity="other">Usou %d ferramentas</item></plurals>
<!-- AgentIconRow -->
<string name="agent_icon_title">Ícone do agente</string>
<string name="agent_icon_set">Escolher arquivo</string>
@@ -3483,6 +3503,7 @@
<string name="tool_name_android">Ação no telefone</string>
<string name="timeline_no_checks">sem verificações</string>
<string name="thinking_title">Processo de raciocínio</string>
<string name="thinking_settled">Pensamento</string>
<string name="thinking_thinking_short">Pensando</string>
<string name="thinking_thinking">Pensando...</string>
<string name="task_status_working">Trabalhando</string>
@@ -3608,6 +3629,7 @@
<string name="voice_overlay_attachment_ready">Anexo pronto</string>
<string name="conn_info_active_profile">Perfil ativo</string>
<string name="msg_bubble_speak_response">Falar resposta</string>
<string name="msg_bubble_stop_speaking">Parar fala</string>
<string name="voice_overlay_engine_standard">Modo padrão</string>
<string name="voice_overlay_caption_hermes">Hermes</string>
<string name="voice_overlay_open_hermes">Abrir Hermes</string>
@@ -3726,4 +3748,103 @@
<string name="support_bundle_copied">Informações de suporte copiadas</string>
<string name="support_bundle_no_share">Informações de suporte copiadas — nenhum app encontrado para compartilhar</string>
<string name="support_bundle_share_title">Compartilhar informações de suporte do Hermes-Relay</string>
<string name="chat_search_conversation">Pesquisar conversa</string>
<string name="chat_search_close">Fechar pesquisa</string>
<string name="chat_search_no_results">Nenhum resultado</string>
<string name="chat_search_result_count">%1$d de %2$d</string>
<string name="msg_bubble_queued">Na fila</string>
<string name="msg_bubble_steered">Correção enviada</string>
<string name="chat_quote_you">Você</string>
<string name="chat_quote_hermes">Hermes</string>
<string name="chat_quote_open">Abrir mensagem original de %1$s</string>
<string name="chat_quote_remove">Remover citação</string>
<string name="profile_shelf_switch_agent">Trocar agente</string>
<string name="profile_shelf_all_profiles">Abrir todos os perfis de agente</string>
<string name="profile_shelf_open_passport">Abrir Passaporte do agente</string>
<string name="profile_shelf_switch_to">Trocar para este agente</string>
<string name="profile_shelf_locked_hint">A troca de perfil está bloqueada. Toque e segure o agente ativo para desbloquear.</string>
<string name="profile_shelf_inspect">Inspecionar perfil</string>
<string name="profile_shelf_hide">Ocultar da estante de perfis</string>
<string name="profile_shelf_expand">Expandir a estante de perfis</string>
<string name="profile_shelf_collapse">Recolher a estante de perfis</string>
<string name="appearance_intro">Escolha uma predefinição e veja o resultado ao vivo na prévia.</string>
<string name="appearance_preset_gallery">Galeria de predefinições</string>
<string name="appearance_preview_relay">Prévia · Relay</string>
<string name="appearance_preview_user_message">Dê três dicas rápidas para uma manhã focada.</string>
<string name="appearance_preview_agent">Hermes</string>
<string name="appearance_preview_agent_message">1. Escolha uma conquista real antes de conferir os feeds.\n2. Reserve os primeiros 45–90 minutos.\n3. Comece com um ritual de preparação, não com “motivação”.</string>
<string name="appearance_preview_time">19:00</string>
<string name="appearance_preview_voice">Voz</string>
<string name="appearance_preview_tool_meta">tool_executor · 206 tokens · 137,2 mil</string>
<string name="appearance_preview_message_placeholder">Mensagem…</string>
<string name="appearance_preview_gateway">Gateway · LAN · gpt-5.5 / perfil: padrão</string>
<string name="appearance_preview_live_note">Esta prévia é atualizada imediatamente com a predefinição, o modo, a fonte e a aparência da Sphere.</string>
<string name="appearance_customize_theme">Personalizar %1$s</string>
<string name="appearance_accent_preset">Cor de destaque predefinida</string>
<string name="appearance_accent_custom">Cor de destaque personalizada aplicada</string>
<string name="appearance_accent_preview_only">As alterações ficam na prévia até você aplicá-las.</string>
<string name="appearance_accent_preview_only_short">Somente prévia</string>
<string name="appearance_apply_changes">Aplicar alterações</string>
<string name="appearance_customize_summary">Destaque, superfícies, forma e densidade</string>
<string name="appearance_shape">Forma</string>
<string name="appearance_shape_soft">Suave</string>
<string name="appearance_shape_balanced">Equilibrada</string>
<string name="appearance_shape_sharp">Angular</string>
<string name="appearance_contrast_passes">Contraste aprovado</string>
<string name="appearance_contrast_fails">O contraste precisa melhorar</string>
<string name="appearance_contrast_aa">AA para texto normal</string>
<string name="appearance_typography_density">Tipografia e densidade</string>
<string name="appearance_readability">Legibilidade</string>
<string name="appearance_default">Padrão</string>
<string name="appearance_font_normal_summary">Tamanho da fonte: Normal</string>
<string name="appearance_reset_draft">Redefinir rascunho</string>
<string name="appearance_accent">Cor de destaque</string>
<string name="appearance_contrast_status">Contraste legível · %1$.1f:1</string>
<string name="appearance_typography_density_summary">A tipografia e a densidade usam os controles específicos de Fonte e Tamanho da fonte abaixo.</string>
<string name="appearance_readability_summary">Ajuste a densidade do texto aqui; escolha a tipografia na seção Fonte abaixo.</string>
<string name="appearance_reset">Redefinir</string>
<string name="appearance_apply">Aplicar</string>
<string name="appearance_background_installed">Animações instaladas</string>
<string name="appearance_import_background">Importar animação de fundo</string>
<string name="appearance_import_background_desc">Importa o mesmo ZIP seguro de pet do Relay ou formato de imagem única, mas o usa apenas na visualização central ou de fundo. Não ativa a movimentação nem altera o pet flutuante.</string>
<string name="appearance_import_sphere">Importar aparência da Sphere</string>
<string name="appearance_create_pet">Criar um pet personalizado</string>
<string name="pet_creator_title">Criar um pet personalizado</string>
<string name="pet_creator_intro">Descreva seu companheiro, revise as instruções geradas e escolha onde criá-lo. Nada é enviado até você mesmo enviar o novo chat.</string>
<string name="pet_creator_step_idea">Escolher a ideia</string>
<string name="pet_creator_name">Nome do pet</string>
<string name="pet_creator_description">Direção do personagem</string>
<string name="pet_creator_description_hint">Descreva o personagem, os materiais, as cores, o clima e qualquer imagem de referência que você pretende anexar.</string>
<string name="pet_creator_animated">Pacote animado</string>
<string name="pet_creator_static">Imagem estática</string>
<string name="pet_creator_step_create">Revisar e criar</string>
<string name="pet_creator_review_copy">Estas instruções completas incluem o formato atual de pets e os limites de validação, privacidade e revisão.</string>
<string name="pet_creator_copy">Copiar</string>
<string name="pet_creator_copied">Instruções copiadas</string>
<string name="pet_creator_new_chat">Novo chat</string>
<string name="pet_creator_step_review">Revisar e importar</string>
<string name="pet_creator_review_desc">Inspecione primeiro a imagem ou o ZIP retornado. A importação copia os arquivos validados para o armazenamento do app; ela não os publica.</string>
<string name="pet_creator_import">Importar pet concluído</string>
<string name="dashboard_tab_memory">Memória</string>
<string name="dashboard_tab_learning">Aprendizado</string>
<string name="dashboard_tab_channels">Canais</string>
<string name="dashboard_tab_operations">Operações</string>
<string name="dashboard_tab_memory_lower">memória</string>
<string name="dashboard_tab_learning_lower">aprendizado</string>
<string name="dashboard_tab_channels_lower">canais</string>
<string name="dashboard_tab_operations_lower">operações</string>
<string name="dashboard_section_action_server_backup">Criar backup do servidor</string>
<string name="dashboard_profile_mcp_servers_optional">Servidores MCP (opcional)</string>
<string name="dashboard_profile_mcp_servers_help">Nomes de servidor separados por vírgulas ou linhas. As credenciais permanecem no servidor.</string>
<string name="dashboard_tile_memory_title">Memória</string>
<string name="dashboard_tile_memory_sub">Status do provedor e configuração de memória do servidor</string>
<string name="dashboard_tile_learning_title">Grafo de aprendizado</string>
<string name="dashboard_tile_learning_sub">Inspecione os nós aprendidos do perfil ativo</string>
<string name="dashboard_tile_channels_title">Canais</string>
<string name="dashboard_tile_channels_sub">Status das plataformas de mensagens, incluindo WhatsApp</string>
<string name="dashboard_tile_operations_title">Operações do servidor</string>
<string name="dashboard_tile_operations_sub">Integridade do host e backup geral do servidor</string>
<string name="drawer_all_profiles">Todos os perfis</string>
<string name="drawer_no_profile_sessions">Nenhuma sessão de perfil correspondente.</string>
<string name="drawer_close">Fechar</string>
</resources>
@@ -0,0 +1,10 @@
<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="pending_attachment_preview_named">预览 %1$s</string>
<string name="pending_attachment_remove">移除 %1$s</string>
<string name="pending_attachment_move_left">将 %1$s 向左移动</string>
<string name="pending_attachment_move_right">将 %1$s 向右移动</string>
<string name="pending_attachment_status_loading">正在准备预览</string>
<string name="pending_attachment_status_ready">已就绪</string>
<string name="pending_attachment_status_failed">预览不可用</string>
</resources>
@@ -736,6 +736,9 @@
<string name="chat_settings_recent_prompt_chips_desc">在输入栏上方显示最近消息为可点击的标签以便重发。默认关闭。</string>
<string name="chat_settings_keep_keyboard_open">发送时保持键盘打开</string>
<string name="chat_settings_keep_keyboard_open_desc">发送后留在输入栏。关闭则在每条消息发送后收起键盘。</string>
<string name="chat_settings_physical_keyboard_enter">实体键盘 Enter 键</string>
<string name="chat_settings_physical_keyboard_enter_desc">选择按 Enter 是发送消息还是插入新行。Ctrl+Enter 始终发送。</string>
<string name="chat_settings_insert_newline">插入新行</string>
<string name="chat_settings_notify_when_finishes">后台聊天提醒</string>
<string name="chat_settings_notify_when_finishes_desc">Hermes 在后台需要输入或完成回复时通知</string>
<string name="chat_settings_share_phone_status">与代理分享手机状态</string>
@@ -2554,6 +2557,23 @@
<string name="image_generation_rendering">正在生成图像</string>
<string name="tool_progress_cd_collapse">折叠</string>
<string name="tool_progress_cd_expand">展开</string>
<string name="tool_progress_state_expanded">已展开</string>
<string name="tool_progress_state_collapsed">已折叠</string>
<string name="tool_run_preparing">正在准备%1$s</string>
<string name="tool_run_running">正在运行%1$s</string>
<string name="tool_run_finished">已完成%1$s</string>
<plurals name="tool_run_reading"><item quantity="other">正在读取 %d 项</item></plurals>
<plurals name="tool_run_read"><item quantity="other">已读取 %d 项</item></plurals>
<plurals name="tool_run_searching"><item quantity="other">正在搜索 %d 个来源</item></plurals>
<plurals name="tool_run_searched"><item quantity="other">已搜索 %d 个来源</item></plurals>
<plurals name="tool_run_running_commands"><item quantity="other">正在运行 %d 个命令</item></plurals>
<plurals name="tool_run_ran_commands"><item quantity="other">已运行 %d 个命令</item></plurals>
<plurals name="tool_run_browsing"><item quantity="other">正在执行 %d 个浏览器操作</item></plurals>
<plurals name="tool_run_browsed"><item quantity="other">已执行 %d 个浏览器操作</item></plurals>
<plurals name="tool_run_using_device"><item quantity="other">正在执行 %d 个设备操作</item></plurals>
<plurals name="tool_run_used_device"><item quantity="other">已执行 %d 个设备操作</item></plurals>
<plurals name="tool_run_using_tools"><item quantity="other">正在使用 %d 个工具</item></plurals>
<plurals name="tool_run_used_tools"><item quantity="other">已使用 %d 个工具</item></plurals>
<!-- AgentIconRow -->
<string name="agent_icon_title">代理图标</string>
@@ -3571,6 +3591,7 @@
<string name="tool_name_android">手机操作</string>
<string name="timeline_no_checks">无检查</string>
<string name="thinking_title">思考过程</string>
<string name="thinking_settled">思考</string>
<string name="thinking_thinking_short">思考中</string>
<string name="thinking_thinking">思考中…</string>
<string name="task_status_working">处理中</string>
@@ -3696,6 +3717,7 @@
<string name="voice_overlay_attachment_ready">附件已就绪</string>
<string name="conn_info_active_profile">活跃个人资料</string>
<string name="msg_bubble_speak_response">朗读回复</string>
<string name="msg_bubble_stop_speaking">停止朗读</string>
<string name="voice_overlay_engine_standard">标准模式</string>
<string name="voice_overlay_caption_hermes">Hermes</string>
<string name="voice_overlay_open_hermes">打开 Hermes</string>
@@ -3814,4 +3836,103 @@
<string name="support_bundle_copied">支持信息已复制</string>
<string name="support_bundle_no_share">支持信息已复制 — 未找到可分享的应用</string>
<string name="support_bundle_share_title">分享 Hermes-Relay 支持信息</string>
<string name="chat_search_conversation">搜索对话</string>
<string name="chat_search_close">关闭搜索</string>
<string name="chat_search_no_results">无结果</string>
<string name="chat_search_result_count">%1$d / %2$d</string>
<string name="msg_bubble_queued">已排队</string>
<string name="msg_bubble_steered">更正已发送</string>
<string name="chat_quote_you">你</string>
<string name="chat_quote_hermes">Hermes</string>
<string name="chat_quote_open">打开 %1$s 的原始消息</string>
<string name="chat_quote_remove">移除引用</string>
<string name="profile_shelf_switch_agent">切换智能体</string>
<string name="profile_shelf_all_profiles">打开所有智能体配置</string>
<string name="profile_shelf_open_passport">打开智能体护照</string>
<string name="profile_shelf_switch_to">切换到此智能体</string>
<string name="profile_shelf_locked_hint">配置切换已锁定。长按当前智能体即可解锁。</string>
<string name="profile_shelf_inspect">查看配置</string>
<string name="profile_shelf_hide">从配置架中隐藏</string>
<string name="profile_shelf_expand">展开配置架</string>
<string name="profile_shelf_collapse">收起配置架</string>
<string name="appearance_intro">选择一个预设,即时查看预览效果。</string>
<string name="appearance_preset_gallery">预设库</string>
<string name="appearance_preview_relay">预览 · Relay</string>
<string name="appearance_preview_user_message">给我三个专注开启早晨的小建议。</string>
<string name="appearance_preview_agent">Hermes</string>
<string name="appearance_preview_agent_message">1. 查看信息流之前,先选定一个真正的成果。\n2. 留出最初的 45–90 分钟。\n3. 从准备仪式开始,而不是等待“动力”。</string>
<string name="appearance_preview_time">晚上 7:00</string>
<string name="appearance_preview_voice">语音</string>
<string name="appearance_preview_tool_meta">tool_executor · 206 个 token · 137.2K</string>
<string name="appearance_preview_message_placeholder">消息…</string>
<string name="appearance_preview_gateway">Gateway · LAN · gpt-5.5 / 配置文件:默认</string>
<string name="appearance_preview_live_note">更改预设、模式、字体或 Sphere 皮肤后,此预览会立即更新。</string>
<string name="appearance_customize_theme">自定义 %1$s</string>
<string name="appearance_accent_preset">预设强调色</string>
<string name="appearance_accent_custom">已应用自定义强调色</string>
<string name="appearance_accent_preview_only">应用之前,更改只会显示在预览中。</string>
<string name="appearance_accent_preview_only_short">仅预览</string>
<string name="appearance_apply_changes">应用更改</string>
<string name="appearance_customize_summary">强调色、表面、形状和密度</string>
<string name="appearance_shape">形状</string>
<string name="appearance_shape_soft">柔和</string>
<string name="appearance_shape_balanced">均衡</string>
<string name="appearance_shape_sharp">锐利</string>
<string name="appearance_contrast_passes">对比度达标</string>
<string name="appearance_contrast_fails">对比度需要改进</string>
<string name="appearance_contrast_aa">普通文本 AA 标准</string>
<string name="appearance_typography_density">排版和密度</string>
<string name="appearance_readability">可读性</string>
<string name="appearance_default">默认</string>
<string name="appearance_font_normal_summary">字体大小:标准</string>
<string name="appearance_reset_draft">重置草稿</string>
<string name="appearance_accent">强调色</string>
<string name="appearance_contrast_status">易读对比度 · %1$.1f:1</string>
<string name="appearance_typography_density_summary">排版和密度使用下方独立的字体和字体大小控件。</string>
<string name="appearance_readability_summary">在此调整文本密度;在下方的字体部分选择字形。</string>
<string name="appearance_reset">重置</string>
<string name="appearance_apply">应用</string>
<string name="appearance_background_installed">已安装的动画</string>
<string name="appearance_import_background">导入背景动画</string>
<string name="appearance_import_background_desc">导入与安全 Relay 宠物 ZIP 或单张图片相同的格式,但仅用于中央或背景可视化。它不会启用漫游,也不会更改悬浮宠物。</string>
<string name="appearance_import_sphere">导入 Sphere 皮肤</string>
<string name="appearance_create_pet">创建自定义宠物</string>
<string name="pet_creator_title">创建自定义宠物</string>
<string name="pet_creator_intro">描述你的伙伴,检查生成的说明,然后选择创建位置。在你自行发送新聊天之前,不会发送任何内容。</string>
<string name="pet_creator_step_idea">选择构思</string>
<string name="pet_creator_name">宠物名称</string>
<string name="pet_creator_description">角色方向</string>
<string name="pet_creator_description_hint">描述角色、材质、颜色、氛围以及计划附加的参考图片。</string>
<string name="pet_creator_animated">动画包</string>
<string name="pet_creator_static">静态图片</string>
<string name="pet_creator_step_create">检查并创建</string>
<string name="pet_creator_review_copy">这些完整说明涵盖当前宠物格式、验证、隐私和审查边界。</string>
<string name="pet_creator_copy">复制</string>
<string name="pet_creator_copied">说明已复制</string>
<string name="pet_creator_new_chat">新聊天</string>
<string name="pet_creator_step_review">检查并导入</string>
<string name="pet_creator_review_desc">请先检查返回的图片或 ZIP。导入会将经过验证的文件复制到应用专属存储空间,不会发布它们。</string>
<string name="pet_creator_import">导入完成的宠物</string>
<string name="dashboard_tab_memory">记忆</string>
<string name="dashboard_tab_learning">学习</string>
<string name="dashboard_tab_channels">频道</string>
<string name="dashboard_tab_operations">运维</string>
<string name="dashboard_tab_memory_lower">记忆</string>
<string name="dashboard_tab_learning_lower">学习</string>
<string name="dashboard_tab_channels_lower">频道</string>
<string name="dashboard_tab_operations_lower">运维</string>
<string name="dashboard_section_action_server_backup">创建服务器备份</string>
<string name="dashboard_profile_mcp_servers_optional">MCP 服务器(可选)</string>
<string name="dashboard_profile_mcp_servers_help">用逗号或换行分隔服务器名称。凭据仍由服务器保管。</string>
<string name="dashboard_tile_memory_title">记忆</string>
<string name="dashboard_tile_memory_sub">提供商状态和服务器端记忆配置</string>
<string name="dashboard_tile_learning_title">学习图谱</string>
<string name="dashboard_tile_learning_sub">查看当前配置文件的已学习节点</string>
<string name="dashboard_tile_channels_title">频道</string>
<string name="dashboard_tile_channels_sub">消息平台状态,包括 WhatsApp</string>
<string name="dashboard_tile_operations_title">服务器运维</string>
<string name="dashboard_tile_operations_sub">主机健康状况和服务器整体备份</string>
<string name="drawer_all_profiles">所有配置文件</string>
<string name="drawer_no_profile_sessions">没有匹配的配置文件会话。</string>
<string name="drawer_close">关闭</string>
</resources>
@@ -0,0 +1,10 @@
<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="pending_attachment_preview_named">Vorschau für %1$s</string>
<string name="pending_attachment_remove">%1$s entfernen</string>
<string name="pending_attachment_move_left">%1$s nach links verschieben</string>
<string name="pending_attachment_move_right">%1$s nach rechts verschieben</string>
<string name="pending_attachment_status_loading">Vorschau wird vorbereitet</string>
<string name="pending_attachment_status_ready">Bereit</string>
<string name="pending_attachment_status_failed">Vorschau nicht verfügbar</string>
</resources>
+121
View File
@@ -736,6 +736,9 @@
<string name="chat_settings_recent_prompt_chips_desc">Letzte Nachrichten als antippbare Chips über dem Eingabefeld anzeigen, um sie erneut zu senden. Standardmäßig aus.</string>
<string name="chat_settings_keep_keyboard_open">Tastatur nach dem Senden geöffnet lassen</string>
<string name="chat_settings_keep_keyboard_open_desc">Nach dem Senden im Eingabefeld bleiben. Ausschalten, um die Tastatur nach jeder gesendeten Nachricht zu schließen.</string>
<string name="chat_settings_physical_keyboard_enter">Eingabetaste der physischen Tastatur</string>
<string name="chat_settings_physical_keyboard_enter_desc">Wähle, ob die Eingabetaste sendet oder eine neue Zeile einfügt. Strg+Eingabetaste sendet immer.</string>
<string name="chat_settings_insert_newline">Neue Zeile einfügen</string>
<string name="chat_settings_notify_when_finishes">Chat-Benachrichtigungen im Hintergrund</string>
<string name="chat_settings_notify_when_finishes_desc">Benachrichtigen, wenn Hermes Eingaben benötigt oder im Hintergrund fertig wird</string>
<string name="chat_settings_share_phone_status">Smartphone-Status mit Agent teilen</string>
@@ -2557,6 +2560,23 @@
<string name="image_generation_rendering">Bild wird erstellt</string>
<string name="tool_progress_cd_collapse">Einklappen</string>
<string name="tool_progress_cd_expand">Ausklappen</string>
<string name="tool_progress_state_expanded">Ausgeklappt</string>
<string name="tool_progress_state_collapsed">Eingeklappt</string>
<string name="tool_run_preparing">%1$s wird vorbereitet</string>
<string name="tool_run_running">%1$s wird ausgeführt</string>
<string name="tool_run_finished">%1$s abgeschlossen</string>
<plurals name="tool_run_reading"><item quantity="one">%d Element wird gelesen</item><item quantity="other">%d Elemente werden gelesen</item></plurals>
<plurals name="tool_run_read"><item quantity="one">%d Element gelesen</item><item quantity="other">%d Elemente gelesen</item></plurals>
<plurals name="tool_run_searching"><item quantity="one">%d Quelle wird durchsucht</item><item quantity="other">%d Quellen werden durchsucht</item></plurals>
<plurals name="tool_run_searched"><item quantity="one">%d Quelle durchsucht</item><item quantity="other">%d Quellen durchsucht</item></plurals>
<plurals name="tool_run_running_commands"><item quantity="one">%d Befehl wird ausgeführt</item><item quantity="other">%d Befehle werden ausgeführt</item></plurals>
<plurals name="tool_run_ran_commands"><item quantity="one">%d Befehl ausgeführt</item><item quantity="other">%d Befehle ausgeführt</item></plurals>
<plurals name="tool_run_browsing"><item quantity="one">%d Browseraktion wird ausgeführt</item><item quantity="other">%d Browseraktionen werden ausgeführt</item></plurals>
<plurals name="tool_run_browsed"><item quantity="one">%d Browseraktion ausgeführt</item><item quantity="other">%d Browseraktionen ausgeführt</item></plurals>
<plurals name="tool_run_using_device"><item quantity="one">%d Geräteaktion wird ausgeführt</item><item quantity="other">%d Geräteaktionen werden ausgeführt</item></plurals>
<plurals name="tool_run_used_device"><item quantity="one">%d Geräteaktion ausgeführt</item><item quantity="other">%d Geräteaktionen ausgeführt</item></plurals>
<plurals name="tool_run_using_tools"><item quantity="one">%d Werkzeug wird verwendet</item><item quantity="other">%d Werkzeuge werden verwendet</item></plurals>
<plurals name="tool_run_used_tools"><item quantity="one">%d Werkzeug verwendet</item><item quantity="other">%d Werkzeuge verwendet</item></plurals>
<!-- AgentIconRow -->
<string name="agent_icon_title">Agentensymbol</string>
@@ -3638,6 +3658,7 @@
<string name="tool_name_android">Telefonaktion</string>
<string name="timeline_no_checks">keine Prüfungen</string>
<string name="thinking_title">Denkprozess</string>
<string name="thinking_settled">Gedanke</string>
<string name="thinking_thinking_short">Denkt nach</string>
<string name="thinking_thinking">Denkt nach…</string>
<string name="task_status_working">In Arbeit</string>
@@ -3768,6 +3789,7 @@
<string name="voice_overlay_attachment_ready">Anhang bereit</string>
<string name="conn_info_active_profile">Aktives Profil</string>
<string name="msg_bubble_speak_response">Antwort vorlesen</string>
<string name="msg_bubble_stop_speaking">Wiedergabe stoppen</string>
<string name="voice_overlay_engine_standard">Standardmodus</string>
<string name="voice_overlay_caption_hermes">Hermes</string>
<string name="voice_overlay_open_hermes">Hermes öffnen</string>
@@ -3886,4 +3908,103 @@
<string name="support_bundle_copied">Supportinformationen kopiert</string>
<string name="support_bundle_no_share">Supportinformationen kopiert — keine App zum Teilen gefunden</string>
<string name="support_bundle_share_title">Hermes-Relay-Supportinformationen teilen</string>
<string name="chat_search_conversation">Unterhaltung durchsuchen</string>
<string name="chat_search_close">Suche schließen</string>
<string name="chat_search_no_results">Keine Ergebnisse</string>
<string name="chat_search_result_count">%1$d von %2$d</string>
<string name="msg_bubble_queued">In Warteschlange</string>
<string name="msg_bubble_steered">Korrektur gesendet</string>
<string name="chat_quote_you">Du</string>
<string name="chat_quote_hermes">Hermes</string>
<string name="chat_quote_open">Ursprüngliche Nachricht von %1$s öffnen</string>
<string name="chat_quote_remove">Zitat entfernen</string>
<string name="profile_shelf_switch_agent">Agent wechseln</string>
<string name="profile_shelf_all_profiles">Alle Agentenprofile öffnen</string>
<string name="profile_shelf_open_passport">Agentenpass öffnen</string>
<string name="profile_shelf_switch_to">Zu diesem Agenten wechseln</string>
<string name="profile_shelf_locked_hint">Der Profilwechsel ist gesperrt. Halten Sie den aktiven Agenten gedrückt, um die Sperre aufzuheben.</string>
<string name="profile_shelf_inspect">Profil prüfen</string>
<string name="profile_shelf_hide">Aus der Profilablage ausblenden</string>
<string name="profile_shelf_expand">Profilablage erweitern</string>
<string name="profile_shelf_collapse">Profilablage einklappen</string>
<string name="appearance_intro">Wählen Sie eine Vorlage und sehen Sie sie direkt in der Vorschau.</string>
<string name="appearance_preset_gallery">Vorlagengalerie</string>
<string name="appearance_preview_relay">Vorschau · Relay</string>
<string name="appearance_preview_user_message">Gib mir drei kurze Tipps für einen konzentrierten Morgen.</string>
<string name="appearance_preview_agent">Hermes</string>
<string name="appearance_preview_agent_message">1. Wähle einen echten Erfolg, bevor du Feeds prüfst.\n2. Blockiere die ersten 45–90 Minuten.\n3. Beginne mit einem Einrichtungsritual statt mit „Motivation“.</string>
<string name="appearance_preview_time">19:00</string>
<string name="appearance_preview_voice">Sprache</string>
<string name="appearance_preview_tool_meta">tool_executor · 206 Token · 137,2K</string>
<string name="appearance_preview_message_placeholder">Nachricht…</string>
<string name="appearance_preview_gateway">Gateway · LAN · gpt-5.5 / Profil: Standard</string>
<string name="appearance_preview_live_note">Diese Vorschau wird sofort mit Vorlage, Modus, Schrift und Sphere-Skin aktualisiert.</string>
<string name="appearance_customize_theme">%1$s anpassen</string>
<string name="appearance_accent_preset">Voreingestellte Akzentfarbe</string>
<string name="appearance_accent_custom">Eigene Akzentfarbe angewendet</string>
<string name="appearance_accent_preview_only">Änderungen bleiben in der Vorschau, bis Sie sie anwenden.</string>
<string name="appearance_accent_preview_only_short">Nur Vorschau</string>
<string name="appearance_apply_changes">Änderungen anwenden</string>
<string name="appearance_customize_summary">Akzent, Flächen, Form &amp; Dichte</string>
<string name="appearance_shape">Form</string>
<string name="appearance_shape_soft">Weich</string>
<string name="appearance_shape_balanced">Ausgewogen</string>
<string name="appearance_shape_sharp">Kantig</string>
<string name="appearance_contrast_passes">Kontrast ausreichend</string>
<string name="appearance_contrast_fails">Kontrast muss verbessert werden</string>
<string name="appearance_contrast_aa">AA für normalen Text</string>
<string name="appearance_typography_density">Typografie &amp; Dichte</string>
<string name="appearance_readability">Lesbarkeit</string>
<string name="appearance_default">Standard</string>
<string name="appearance_font_normal_summary">Schriftgröße: Normal</string>
<string name="appearance_reset_draft">Entwurf zurücksetzen</string>
<string name="appearance_accent">Akzentfarbe</string>
<string name="appearance_contrast_status">Lesbarer Kontrast · %1$.1f:1</string>
<string name="appearance_typography_density_summary">Typografie und Dichte verwenden die gezielten Einstellungen für Schrift und Schriftgröße unten.</string>
<string name="appearance_readability_summary">Passen Sie hier die Textdichte an; wählen Sie die Schriftart im Abschnitt „Schrift“ unten.</string>
<string name="appearance_reset">Zurücksetzen</string>
<string name="appearance_apply">Anwenden</string>
<string name="appearance_background_installed">Installierte Animationen</string>
<string name="appearance_import_background">Hintergrundanimation importieren</string>
<string name="appearance_import_background_desc">Importiert dasselbe sichere Relay-Pet-ZIP- oder Einzelbildformat, verwendet es aber nur für die zentrale Hintergrunddarstellung. Roaming wird nicht aktiviert und das schwebende Pet nicht geändert.</string>
<string name="appearance_import_sphere">Sphere-Skin importieren</string>
<string name="appearance_create_pet">Eigenes Pet erstellen</string>
<string name="pet_creator_title">Eigenes Pet erstellen</string>
<string name="pet_creator_intro">Beschreiben Sie Ihren Begleiter, prüfen Sie die erzeugten Anweisungen und wählen Sie dann, wo Sie ihn erstellen. Es wird nichts gesendet, bis Sie den neuen Chat selbst absenden.</string>
<string name="pet_creator_step_idea">Idee auswählen</string>
<string name="pet_creator_name">Pet-Name</string>
<string name="pet_creator_description">Charakterrichtung</string>
<string name="pet_creator_description_hint">Beschreiben Sie Charakter, Materialien, Farben, Stimmung und alle Referenzbilder, die Sie anhängen möchten.</string>
<string name="pet_creator_animated">Animiertes Paket</string>
<string name="pet_creator_static">Statisches Bild</string>
<string name="pet_creator_step_create">Prüfen und erstellen</string>
<string name="pet_creator_review_copy">Diese vollständigen Anweisungen enthalten das aktuelle Pet-Format sowie Validierungs-, Datenschutz- und Prüfgrenzen.</string>
<string name="pet_creator_copy">Kopieren</string>
<string name="pet_creator_copied">Anweisungen kopiert</string>
<string name="pet_creator_new_chat">Neuer Chat</string>
<string name="pet_creator_step_review">Prüfen und importieren</string>
<string name="pet_creator_review_desc">Prüfen Sie zuerst das zurückgegebene Bild oder ZIP. Beim Import werden die validierten Dateien in den App-Speicher kopiert; sie werden nicht veröffentlicht.</string>
<string name="pet_creator_import">Fertiges Pet importieren</string>
<string name="dashboard_tab_memory">Speicher</string>
<string name="dashboard_tab_learning">Lernen</string>
<string name="dashboard_tab_channels">Kanäle</string>
<string name="dashboard_tab_operations">Betrieb</string>
<string name="dashboard_tab_memory_lower">Speicher</string>
<string name="dashboard_tab_learning_lower">Lernen</string>
<string name="dashboard_tab_channels_lower">Kanäle</string>
<string name="dashboard_tab_operations_lower">Betrieb</string>
<string name="dashboard_section_action_server_backup">Server-Sicherung erstellen</string>
<string name="dashboard_profile_mcp_servers_optional">MCP-Server (optional)</string>
<string name="dashboard_profile_mcp_servers_help">Komma- oder zeilengetrennte Servernamen. Anmeldedaten verbleiben auf dem Server.</string>
<string name="dashboard_tile_memory_title">Speicher</string>
<string name="dashboard_tile_memory_sub">Anbieterstatus und servereigene Speicherkonfiguration</string>
<string name="dashboard_tile_learning_title">Lerngraph</string>
<string name="dashboard_tile_learning_sub">Gelernte Knoten des aktiven Profils prüfen</string>
<string name="dashboard_tile_channels_title">Kanäle</string>
<string name="dashboard_tile_channels_sub">Status der Nachrichtenplattformen einschließlich WhatsApp</string>
<string name="dashboard_tile_operations_title">Serverbetrieb</string>
<string name="dashboard_tile_operations_sub">Hostzustand und serverweite Sicherung</string>
<string name="drawer_all_profiles">Alle Profile</string>
<string name="drawer_no_profile_sessions">Keine passenden Profilsitzungen.</string>
<string name="drawer_close">Schließen</string>
</resources>
@@ -0,0 +1,10 @@
<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="pending_attachment_preview_named">Vista previa de %1$s</string>
<string name="pending_attachment_remove">Quitar %1$s</string>
<string name="pending_attachment_move_left">Mover %1$s a la izquierda</string>
<string name="pending_attachment_move_right">Mover %1$s a la derecha</string>
<string name="pending_attachment_status_loading">Preparando vista previa</string>
<string name="pending_attachment_status_ready">Listo</string>
<string name="pending_attachment_status_failed">Vista previa no disponible</string>
</resources>
+121
View File
@@ -661,6 +661,9 @@
<string name="chat_settings_recent_prompt_chips_desc">Muestre sus mensajes recientes como chips que se pueden tocar encima del redactor para enviarlos nuevamente. Desactivado de forma predeterminada.</string>
<string name="chat_settings_keep_keyboard_open">Mantener el teclado abierto al enviar</string>
<string name="chat_settings_keep_keyboard_open_desc">Permanece en el compositor después del envío. Desactívelo para descartar el teclado después de cada mensaje enviado.</string>
<string name="chat_settings_physical_keyboard_enter">Tecla Intro del teclado físico</string>
<string name="chat_settings_physical_keyboard_enter_desc">Elige si Intro envía o inserta una línea nueva. Ctrl+Intro siempre envía.</string>
<string name="chat_settings_insert_newline">Insertar línea nueva</string>
<string name="chat_settings_notify_when_finishes">Alertas de chat en segundo plano</string>
<string name="chat_settings_notify_when_finishes_desc">Notificar cuando Hermes necesite información o termine en segundo plano</string>
<string name="chat_settings_share_phone_status">Compartir el estado del teléfono con el agente</string>
@@ -2330,6 +2333,23 @@
<string name="image_generation_rendering">Generando imagen</string>
<string name="tool_progress_cd_collapse">Colapsar</string>
<string name="tool_progress_cd_expand">Expandir</string>
<string name="tool_progress_state_expanded">Expandido</string>
<string name="tool_progress_state_collapsed">Contraído</string>
<string name="tool_run_preparing">Preparando %1$s</string>
<string name="tool_run_running">Ejecutando %1$s</string>
<string name="tool_run_finished">%1$s finalizado</string>
<plurals name="tool_run_reading"><item quantity="one">Leyendo %d elemento</item><item quantity="other">Leyendo %d elementos</item></plurals>
<plurals name="tool_run_read"><item quantity="one">Se leyó %d elemento</item><item quantity="other">Se leyeron %d elementos</item></plurals>
<plurals name="tool_run_searching"><item quantity="one">Buscando en %d fuente</item><item quantity="other">Buscando en %d fuentes</item></plurals>
<plurals name="tool_run_searched"><item quantity="one">Se buscó en %d fuente</item><item quantity="other">Se buscó en %d fuentes</item></plurals>
<plurals name="tool_run_running_commands"><item quantity="one">Ejecutando %d comando</item><item quantity="other">Ejecutando %d comandos</item></plurals>
<plurals name="tool_run_ran_commands"><item quantity="one">Se ejecutó %d comando</item><item quantity="other">Se ejecutaron %d comandos</item></plurals>
<plurals name="tool_run_browsing"><item quantity="one">Ejecutando %d acción del navegador</item><item quantity="other">Ejecutando %d acciones del navegador</item></plurals>
<plurals name="tool_run_browsed"><item quantity="one">Se ejecutó %d acción del navegador</item><item quantity="other">Se ejecutaron %d acciones del navegador</item></plurals>
<plurals name="tool_run_using_device"><item quantity="one">Ejecutando %d acción del dispositivo</item><item quantity="other">Ejecutando %d acciones del dispositivo</item></plurals>
<plurals name="tool_run_used_device"><item quantity="one">Se ejecutó %d acción del dispositivo</item><item quantity="other">Se ejecutaron %d acciones del dispositivo</item></plurals>
<plurals name="tool_run_using_tools"><item quantity="one">Usando %d herramienta</item><item quantity="other">Usando %d herramientas</item></plurals>
<plurals name="tool_run_used_tools"><item quantity="one">Se usó %d herramienta</item><item quantity="other">Se usaron %d herramientas</item></plurals>
<string name="agent_icon_title">Icono de agente</string>
<string name="agent_icon_set">Elegir archivo</string>
<string name="agent_icon_change">Elegir archivo</string>
@@ -3323,6 +3343,7 @@
<string name="tool_name_android">Acción en el teléfono</string>
<string name="timeline_no_checks">sin comprobaciones</string>
<string name="thinking_title">Proceso de pensamiento</string>
<string name="thinking_settled">Pensamiento</string>
<string name="thinking_thinking_short">Pensando</string>
<string name="thinking_thinking">Pensando…</string>
<string name="task_status_working">Trabajando</string>
@@ -3453,6 +3474,7 @@
<string name="voice_overlay_attachment_ready">Adjunto listo</string>
<string name="conn_info_active_profile">Perfil activo</string>
<string name="msg_bubble_speak_response">Leer respuesta</string>
<string name="msg_bubble_stop_speaking">Detener lectura</string>
<string name="voice_overlay_engine_standard">Modo estándar</string>
<string name="voice_overlay_caption_hermes">Hermes</string>
<string name="voice_overlay_open_hermes">Abrir Hermes</string>
@@ -3571,4 +3593,103 @@
<string name="support_bundle_copied">Información de soporte copiada</string>
<string name="support_bundle_no_share">Información de soporte copiada — no se encontró una aplicación para compartir</string>
<string name="support_bundle_share_title">Compartir información de soporte de Hermes-Relay</string>
<string name="chat_search_conversation">Buscar en la conversación</string>
<string name="chat_search_close">Cerrar búsqueda</string>
<string name="chat_search_no_results">Sin resultados</string>
<string name="chat_search_result_count">%1$d de %2$d</string>
<string name="msg_bubble_queued">En cola</string>
<string name="msg_bubble_steered">Corrección enviada</string>
<string name="chat_quote_you">Tú</string>
<string name="chat_quote_hermes">Hermes</string>
<string name="chat_quote_open">Abrir mensaje original de %1$s</string>
<string name="chat_quote_remove">Quitar cita</string>
<string name="profile_shelf_switch_agent">Cambiar de agente</string>
<string name="profile_shelf_all_profiles">Abrir todos los perfiles de agente</string>
<string name="profile_shelf_open_passport">Abrir Pasaporte del agente</string>
<string name="profile_shelf_switch_to">Cambiar a este agente</string>
<string name="profile_shelf_locked_hint">El cambio de perfil está bloqueado. Mantén pulsado el agente activo para desbloquearlo.</string>
<string name="profile_shelf_inspect">Inspeccionar perfil</string>
<string name="profile_shelf_hide">Ocultar de la bandeja de perfiles</string>
<string name="profile_shelf_expand">Expandir la bandeja de perfiles</string>
<string name="profile_shelf_collapse">Contraer la bandeja de perfiles</string>
<string name="appearance_intro">Elige un ajuste predefinido y míralo al instante en la vista previa.</string>
<string name="appearance_preset_gallery">Galería de ajustes</string>
<string name="appearance_preview_relay">Vista previa · Relay</string>
<string name="appearance_preview_user_message">Dame tres consejos rápidos para una mañana productiva.</string>
<string name="appearance_preview_agent">Hermes</string>
<string name="appearance_preview_agent_message">1. Elige un logro real antes de revisar tus novedades.\n2. Reserva los primeros 45–90 minutos.\n3. Empieza con un ritual de preparación, no con «motivación».</string>
<string name="appearance_preview_time">19:00</string>
<string name="appearance_preview_voice">Voz</string>
<string name="appearance_preview_tool_meta">tool_executor · 206 tokens · 137,2K</string>
<string name="appearance_preview_message_placeholder">Mensaje…</string>
<string name="appearance_preview_gateway">Gateway · LAN · gpt-5.5 / perfil: predeterminado</string>
<string name="appearance_preview_live_note">Esta vista previa se actualiza al instante con el ajuste, modo, fuente y aspecto de Sphere.</string>
<string name="appearance_customize_theme">Personalizar %1$s</string>
<string name="appearance_accent_preset">Color de acento predefinido</string>
<string name="appearance_accent_custom">Color de acento personalizado aplicado</string>
<string name="appearance_accent_preview_only">Los cambios permanecen en la vista previa hasta que los apliques.</string>
<string name="appearance_accent_preview_only_short">Solo vista previa</string>
<string name="appearance_apply_changes">Aplicar cambios</string>
<string name="appearance_customize_summary">Acento, superficies, forma y densidad</string>
<string name="appearance_shape">Forma</string>
<string name="appearance_shape_soft">Suave</string>
<string name="appearance_shape_balanced">Equilibrada</string>
<string name="appearance_shape_sharp">Angular</string>
<string name="appearance_contrast_passes">El contraste es suficiente</string>
<string name="appearance_contrast_fails">El contraste necesita mejoras</string>
<string name="appearance_contrast_aa">AA para texto normal</string>
<string name="appearance_typography_density">Tipografía y densidad</string>
<string name="appearance_readability">Legibilidad</string>
<string name="appearance_default">Predeterminado</string>
<string name="appearance_font_normal_summary">Tamaño de fuente: Normal</string>
<string name="appearance_reset_draft">Restablecer borrador</string>
<string name="appearance_accent">Color de acento</string>
<string name="appearance_contrast_status">Contraste legible · %1$.1f:1</string>
<string name="appearance_typography_density_summary">La tipografía y la densidad usan los controles específicos de Fuente y Tamaño de fuente de abajo.</string>
<string name="appearance_readability_summary">Ajusta aquí la densidad del texto; elige la tipografía en la sección Fuente de abajo.</string>
<string name="appearance_reset">Restablecer</string>
<string name="appearance_apply">Aplicar</string>
<string name="appearance_background_installed">Animaciones instaladas</string>
<string name="appearance_import_background">Importar animación de fondo</string>
<string name="appearance_import_background_desc">Importa el mismo ZIP seguro de mascota de Relay o formato de imagen única, pero lo usa solo para la visualización central o de fondo. No activa el movimiento ni cambia tu mascota flotante.</string>
<string name="appearance_import_sphere">Importar aspecto de Sphere</string>
<string name="appearance_create_pet">Crear una mascota personalizada</string>
<string name="pet_creator_title">Crear una mascota personalizada</string>
<string name="pet_creator_intro">Describe a tu acompañante, revisa las instrucciones generadas y elige dónde crearlo. No se envía nada hasta que tú mismo envíes el nuevo chat.</string>
<string name="pet_creator_step_idea">Elegir la idea</string>
<string name="pet_creator_name">Nombre de la mascota</string>
<string name="pet_creator_description">Dirección del personaje</string>
<string name="pet_creator_description_hint">Describe el personaje, materiales, colores, ambiente y cualquier imagen de referencia que quieras adjuntar.</string>
<string name="pet_creator_animated">Paquete animado</string>
<string name="pet_creator_static">Imagen estática</string>
<string name="pet_creator_step_create">Revisar y crear</string>
<string name="pet_creator_review_copy">Estas instrucciones completas incluyen el formato actual de mascotas y los límites de validación, privacidad y revisión.</string>
<string name="pet_creator_copy">Copiar</string>
<string name="pet_creator_copied">Instrucciones copiadas</string>
<string name="pet_creator_new_chat">Nuevo chat</string>
<string name="pet_creator_step_review">Revisar e importar</string>
<string name="pet_creator_review_desc">Inspecciona primero la imagen o el ZIP recibido. Al importar se copian los archivos validados al almacenamiento de la aplicación; no se publican.</string>
<string name="pet_creator_import">Importar mascota terminada</string>
<string name="dashboard_tab_memory">Memoria</string>
<string name="dashboard_tab_learning">Aprendizaje</string>
<string name="dashboard_tab_channels">Canales</string>
<string name="dashboard_tab_operations">Operaciones</string>
<string name="dashboard_tab_memory_lower">memoria</string>
<string name="dashboard_tab_learning_lower">aprendizaje</string>
<string name="dashboard_tab_channels_lower">canales</string>
<string name="dashboard_tab_operations_lower">operaciones</string>
<string name="dashboard_section_action_server_backup">Crear copia del servidor</string>
<string name="dashboard_profile_mcp_servers_optional">Servidores MCP (opcional)</string>
<string name="dashboard_profile_mcp_servers_help">Nombres de servidor separados por comas o líneas. Las credenciales permanecen en el servidor.</string>
<string name="dashboard_tile_memory_title">Memoria</string>
<string name="dashboard_tile_memory_sub">Estado del proveedor y configuración de memoria del servidor</string>
<string name="dashboard_tile_learning_title">Grafo de aprendizaje</string>
<string name="dashboard_tile_learning_sub">Inspecciona los nodos aprendidos del perfil activo</string>
<string name="dashboard_tile_channels_title">Canales</string>
<string name="dashboard_tile_channels_sub">Estado de plataformas de mensajería, incluido WhatsApp</string>
<string name="dashboard_tile_operations_title">Operaciones del servidor</string>
<string name="dashboard_tile_operations_sub">Estado del host y copia de seguridad del servidor</string>
<string name="drawer_all_profiles">Todos los perfiles</string>
<string name="drawer_no_profile_sessions">No hay sesiones de perfil coincidentes.</string>
<string name="drawer_close">Cerrar</string>
</resources>
@@ -0,0 +1,10 @@
<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="pending_attachment_preview_named">%1$sをプレビュー</string>
<string name="pending_attachment_remove">%1$sを削除</string>
<string name="pending_attachment_move_left">%1$sを左へ移動</string>
<string name="pending_attachment_move_right">%1$sを右へ移動</string>
<string name="pending_attachment_status_loading">プレビューを準備中</string>
<string name="pending_attachment_status_ready">準備完了</string>
<string name="pending_attachment_status_failed">プレビューできません</string>
</resources>
+121
View File
@@ -736,6 +736,9 @@
<string name="chat_settings_recent_prompt_chips_desc">最近のメッセージをコンポーザーの上にタップ可能なチップとして表示し、再送信します。デフォルトではオフです。</string>
<string name="chat_settings_keep_keyboard_open">送信時にキーボードを開いたままにする</string>
<string name="chat_settings_keep_keyboard_open_desc">送信後はコンポーザー内に留まります。メッセージを送信するたびにキーボードを閉じるには、オフにします。</string>
<string name="chat_settings_physical_keyboard_enter">物理キーボードの Enter キー</string>
<string name="chat_settings_physical_keyboard_enter_desc">Enter で送信するか改行するかを選択します。Ctrl+Enter は常に送信します。</string>
<string name="chat_settings_insert_newline">改行を挿入</string>
<string name="chat_settings_notify_when_finishes">バックグラウンドのチャット通知</string>
<string name="chat_settings_notify_when_finishes_desc">バックグラウンドで Hermes が入力を必要としたとき、または完了したときに通知します</string>
<string name="chat_settings_share_phone_status">電話のステータスをエージェントと共有する</string>
@@ -2568,6 +2571,23 @@
<string name="image_generation_rendering">画像を生成中</string>
<string name="tool_progress_cd_collapse">崩壊</string>
<string name="tool_progress_cd_expand">拡大する</string>
<string name="tool_progress_state_expanded">展開済み</string>
<string name="tool_progress_state_collapsed">折りたたみ済み</string>
<string name="tool_run_preparing">%1$s を準備中</string>
<string name="tool_run_running">%1$s を実行中</string>
<string name="tool_run_finished">%1$s が完了</string>
<plurals name="tool_run_reading"><item quantity="other">%d 件を読み取り中</item></plurals>
<plurals name="tool_run_read"><item quantity="other">%d 件を読み取り</item></plurals>
<plurals name="tool_run_searching"><item quantity="other">%d 件のソースを検索中</item></plurals>
<plurals name="tool_run_searched"><item quantity="other">%d 件のソースを検索</item></plurals>
<plurals name="tool_run_running_commands"><item quantity="other">%d 件のコマンドを実行中</item></plurals>
<plurals name="tool_run_ran_commands"><item quantity="other">%d 件のコマンドを実行</item></plurals>
<plurals name="tool_run_browsing"><item quantity="other">%d 件のブラウザー操作を実行中</item></plurals>
<plurals name="tool_run_browsed"><item quantity="other">%d 件のブラウザー操作を実行</item></plurals>
<plurals name="tool_run_using_device"><item quantity="other">%d 件のデバイス操作を実行中</item></plurals>
<plurals name="tool_run_used_device"><item quantity="other">%d 件のデバイス操作を実行</item></plurals>
<plurals name="tool_run_using_tools"><item quantity="other">%d 個のツールを使用中</item></plurals>
<plurals name="tool_run_used_tools"><item quantity="other">%d 個のツールを使用</item></plurals>
<!-- AgentIconRow -->
<string name="agent_icon_title">エージェントアイコン</string>
@@ -3642,6 +3662,7 @@
<string name="tool_name_android">電話アクション</string>
<string name="timeline_no_checks">チェックなし</string>
<string name="thinking_title">思考プロセス</string>
<string name="thinking_settled">思考</string>
<string name="thinking_thinking_short">考え中</string>
<string name="thinking_thinking">考え中…</string>
<string name="task_status_working">作業中</string>
@@ -3767,6 +3788,7 @@
<string name="voice_overlay_attachment_ready">添付ファイルの準備ができました</string>
<string name="conn_info_active_profile">アクティブなプロフィール</string>
<string name="msg_bubble_speak_response">応答を読み上げる</string>
<string name="msg_bubble_stop_speaking">読み上げを停止</string>
<string name="voice_overlay_engine_standard">標準モード</string>
<string name="voice_overlay_caption_hermes">Hermes</string>
<string name="voice_overlay_open_hermes">Hermes を開く</string>
@@ -3885,4 +3907,103 @@
<string name="support_bundle_copied">サポート情報をコピーしました</string>
<string name="support_bundle_no_share">サポート情報をコピーしました — 共有できるアプリがありません</string>
<string name="support_bundle_share_title">Hermes-Relay サポート情報を共有</string>
<string name="chat_search_conversation">会話を検索</string>
<string name="chat_search_close">検索を閉じる</string>
<string name="chat_search_no_results">結果なし</string>
<string name="chat_search_result_count">%1$d / %2$d</string>
<string name="msg_bubble_queued">キュー済み</string>
<string name="msg_bubble_steered">修正を送信しました</string>
<string name="chat_quote_you">あなた</string>
<string name="chat_quote_hermes">Hermes</string>
<string name="chat_quote_open">%1$s の元のメッセージを開く</string>
<string name="chat_quote_remove">引用を削除</string>
<string name="profile_shelf_switch_agent">エージェントを切り替え</string>
<string name="profile_shelf_all_profiles">すべてのエージェントプロフィールを開く</string>
<string name="profile_shelf_open_passport">エージェントパスポートを開く</string>
<string name="profile_shelf_switch_to">このエージェントに切り替え</string>
<string name="profile_shelf_locked_hint">プロフィールの切り替えはロックされています。解除するには、使用中のエージェントを長押ししてください。</string>
<string name="profile_shelf_inspect">プロフィールを確認</string>
<string name="profile_shelf_hide">プロフィールシェルフに表示しない</string>
<string name="profile_shelf_expand">プロフィールシェルフを展開</string>
<string name="profile_shelf_collapse">プロフィールシェルフを折りたたむ</string>
<string name="appearance_intro">プリセットを選ぶと、プレビューですぐに確認できます。</string>
<string name="appearance_preset_gallery">プリセットギャラリー</string>
<string name="appearance_preview_relay">プレビュー · Relay</string>
<string name="appearance_preview_user_message">集中できる朝のための簡単なヒントを3つ教えて。</string>
<string name="appearance_preview_agent">Hermes</string>
<string name="appearance_preview_agent_message">1. フィードを見る前に、確実に達成することを1つ決めます。\n2. 最初の45〜90分を確保します。\n3. 「やる気」ではなく準備の習慣から始めます。</string>
<string name="appearance_preview_time">19:00</string>
<string name="appearance_preview_voice">音声</string>
<string name="appearance_preview_tool_meta">tool_executor · 206トークン · 137.2K</string>
<string name="appearance_preview_message_placeholder">メッセージ…</string>
<string name="appearance_preview_gateway">Gateway · LAN · gpt-5.5 / プロファイル: デフォルト</string>
<string name="appearance_preview_live_note">このプレビューには、プリセット、モード、フォント、Sphereスキンの変更がすぐに反映されます。</string>
<string name="appearance_customize_theme">%1$sをカスタマイズ</string>
<string name="appearance_accent_preset">プリセットのアクセント</string>
<string name="appearance_accent_custom">カスタムアクセントを適用済み</string>
<string name="appearance_accent_preview_only">適用するまで変更はプレビュー内だけに反映されます。</string>
<string name="appearance_accent_preview_only_short">プレビューのみ</string>
<string name="appearance_apply_changes">変更を適用</string>
<string name="appearance_customize_summary">アクセント、サーフェス、形状、密度</string>
<string name="appearance_shape">形状</string>
<string name="appearance_shape_soft">ソフト</string>
<string name="appearance_shape_balanced">バランス</string>
<string name="appearance_shape_sharp">シャープ</string>
<string name="appearance_contrast_passes">コントラスト基準を満たしています</string>
<string name="appearance_contrast_fails">コントラストの改善が必要です</string>
<string name="appearance_contrast_aa">通常テキストのAA基準</string>
<string name="appearance_typography_density">文字と密度</string>
<string name="appearance_readability">読みやすさ</string>
<string name="appearance_default">デフォルト</string>
<string name="appearance_font_normal_summary">フォントサイズ: 標準</string>
<string name="appearance_reset_draft">下書きをリセット</string>
<string name="appearance_accent">アクセントカラー</string>
<string name="appearance_contrast_status">読みやすいコントラスト · %1$.1f:1</string>
<string name="appearance_typography_density_summary">文字と密度には、下にあるフォントとフォントサイズの専用設定が使用されます。</string>
<string name="appearance_readability_summary">ここで文字の密度を調整し、下のフォントセクションで書体を選択します。</string>
<string name="appearance_reset">リセット</string>
<string name="appearance_apply">適用</string>
<string name="appearance_background_installed">インストール済みアニメーション</string>
<string name="appearance_import_background">背景アニメーションをインポート</string>
<string name="appearance_import_background_desc">安全なRelayペットZIPまたは単一画像と同じ形式を読み込み、中央または背景の表示だけに使用します。移動は有効にならず、フローティングペットも変更されません。</string>
<string name="appearance_import_sphere">Sphereスキンをインポート</string>
<string name="appearance_create_pet">カスタムペットを作成</string>
<string name="pet_creator_title">カスタムペットを作成</string>
<string name="pet_creator_intro">コンパニオンを説明し、生成された手順を確認してから作成場所を選びます。新しいチャットを自分で送信するまで何も送られません。</string>
<string name="pet_creator_step_idea">アイデアを選ぶ</string>
<string name="pet_creator_name">ペットの名前</string>
<string name="pet_creator_description">キャラクターの方向性</string>
<string name="pet_creator_description_hint">キャラクター、素材、色、雰囲気、添付予定の参照画像について説明します。</string>
<string name="pet_creator_animated">アニメーションパック</string>
<string name="pet_creator_static">静止画像</string>
<string name="pet_creator_step_create">確認して作成</string>
<string name="pet_creator_review_copy">この完全な手順には、現在のペット形式、検証、プライバシー、確認の境界が含まれています。</string>
<string name="pet_creator_copy">コピー</string>
<string name="pet_creator_copied">手順をコピーしました</string>
<string name="pet_creator_new_chat">新しいチャット</string>
<string name="pet_creator_step_review">確認してインポート</string>
<string name="pet_creator_review_desc">返された画像またはZIPを最初に確認してください。インポートすると検証済みファイルがアプリ専用ストレージにコピーされますが、公開はされません。</string>
<string name="pet_creator_import">完成したペットをインポート</string>
<string name="dashboard_tab_memory">メモリ</string>
<string name="dashboard_tab_learning">学習</string>
<string name="dashboard_tab_channels">チャンネル</string>
<string name="dashboard_tab_operations">運用</string>
<string name="dashboard_tab_memory_lower">メモリ</string>
<string name="dashboard_tab_learning_lower">学習</string>
<string name="dashboard_tab_channels_lower">チャンネル</string>
<string name="dashboard_tab_operations_lower">運用</string>
<string name="dashboard_section_action_server_backup">サーバーバックアップを作成</string>
<string name="dashboard_profile_mcp_servers_optional">MCP サーバー(任意)</string>
<string name="dashboard_profile_mcp_servers_help">サーバー名をカンマまたは改行で区切ります。認証情報はサーバー側に保持されます。</string>
<string name="dashboard_tile_memory_title">メモリ</string>
<string name="dashboard_tile_memory_sub">プロバイダーの状態とサーバー側のメモリ設定</string>
<string name="dashboard_tile_learning_title">学習グラフ</string>
<string name="dashboard_tile_learning_sub">アクティブなプロファイルの学習済みノードを確認</string>
<string name="dashboard_tile_channels_title">チャンネル</string>
<string name="dashboard_tile_channels_sub">WhatsApp を含むメッセージプラットフォームの状態</string>
<string name="dashboard_tile_operations_title">サーバー運用</string>
<string name="dashboard_tile_operations_sub">ホストの状態とサーバー全体のバックアップ</string>
<string name="drawer_all_profiles">すべてのプロファイル</string>
<string name="drawer_no_profile_sessions">一致するプロファイルセッションはありません。</string>
<string name="drawer_close">閉じる</string>
</resources>
@@ -0,0 +1,10 @@
<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="pending_attachment_preview_named">Предпросмотр: %1$s</string>
<string name="pending_attachment_remove">Удалить %1$s</string>
<string name="pending_attachment_move_left">Переместить %1$s влево</string>
<string name="pending_attachment_move_right">Переместить %1$s вправо</string>
<string name="pending_attachment_status_loading">Подготовка предпросмотра</string>
<string name="pending_attachment_status_ready">Готово</string>
<string name="pending_attachment_status_failed">Предпросмотр недоступен</string>
</resources>
+121
View File
@@ -704,6 +704,9 @@
<string name="chat_settings_recent_prompt_chips_desc">Показывать ваши недавние сообщения как нажимаемые чипы над композитором, чтобы отправить их снова. По умолчанию выключено.</string>
<string name="chat_settings_keep_keyboard_open">Оставить клавиатуру открытой при отправке</string>
<string name="chat_settings_keep_keyboard_open_desc">Оставаться в композиторе после отправки. Выключите, чтобы скрыть клавиатуру после каждого отправленного сообщения.</string>
<string name="chat_settings_physical_keyboard_enter">Клавиша Enter на физической клавиатуре</string>
<string name="chat_settings_physical_keyboard_enter_desc">Выберите, отправляет ли Enter сообщение или добавляет новую строку. Ctrl+Enter всегда отправляет.</string>
<string name="chat_settings_insert_newline">Вставить новую строку</string>
<string name="chat_settings_notify_when_finishes">Уведомления о фоновом чате</string>
<string name="chat_settings_notify_when_finishes_desc">Уведомлять, когда Гермес требует ввода или заканчивает работу, когда приложение находится в фоновом режиме</string>
<string name="chat_settings_share_phone_status">Поделиться статусом телефона с агентом</string>
@@ -2533,6 +2536,23 @@
<string name="image_generation_rendering">Рендеринг изображения</string>
<string name="tool_progress_cd_collapse">Свернуть</string>
<string name="tool_progress_cd_expand">Развернуть</string>
<string name="tool_progress_state_expanded">Развернуто</string>
<string name="tool_progress_state_collapsed">Свернуто</string>
<string name="tool_run_preparing">Подготовка: %1$s</string>
<string name="tool_run_running">Выполняется: %1$s</string>
<string name="tool_run_finished">Завершено: %1$s</string>
<plurals name="tool_run_reading"><item quantity="one">Чтение %d элемента</item><item quantity="few">Чтение %d элементов</item><item quantity="many">Чтение %d элементов</item><item quantity="other">Чтение %d элементов</item></plurals>
<plurals name="tool_run_read"><item quantity="one">Прочитан %d элемент</item><item quantity="few">Прочитано %d элемента</item><item quantity="many">Прочитано %d элементов</item><item quantity="other">Прочитано %d элементов</item></plurals>
<plurals name="tool_run_searching"><item quantity="one">Поиск в %d источнике</item><item quantity="few">Поиск в %d источниках</item><item quantity="many">Поиск в %d источниках</item><item quantity="other">Поиск в %d источниках</item></plurals>
<plurals name="tool_run_searched"><item quantity="one">Выполнен поиск в %d источнике</item><item quantity="few">Выполнен поиск в %d источниках</item><item quantity="many">Выполнен поиск в %d источниках</item><item quantity="other">Выполнен поиск в %d источниках</item></plurals>
<plurals name="tool_run_running_commands"><item quantity="one">Выполняется %d команда</item><item quantity="few">Выполняется %d команды</item><item quantity="many">Выполняется %d команд</item><item quantity="other">Выполняется %d команд</item></plurals>
<plurals name="tool_run_ran_commands"><item quantity="one">Выполнена %d команда</item><item quantity="few">Выполнено %d команды</item><item quantity="many">Выполнено %d команд</item><item quantity="other">Выполнено %d команд</item></plurals>
<plurals name="tool_run_browsing"><item quantity="one">Выполняется %d действие браузера</item><item quantity="few">Выполняется %d действия браузера</item><item quantity="many">Выполняется %d действий браузера</item><item quantity="other">Выполняется %d действий браузера</item></plurals>
<plurals name="tool_run_browsed"><item quantity="one">Выполнено %d действие браузера</item><item quantity="few">Выполнено %d действия браузера</item><item quantity="many">Выполнено %d действий браузера</item><item quantity="other">Выполнено %d действий браузера</item></plurals>
<plurals name="tool_run_using_device"><item quantity="one">Выполняется %d действие устройства</item><item quantity="few">Выполняется %d действия устройства</item><item quantity="many">Выполняется %d действий устройства</item><item quantity="other">Выполняется %d действий устройства</item></plurals>
<plurals name="tool_run_used_device"><item quantity="one">Выполнено %d действие устройства</item><item quantity="few">Выполнено %d действия устройства</item><item quantity="many">Выполнено %d действий устройства</item><item quantity="other">Выполнено %d действий устройства</item></plurals>
<plurals name="tool_run_using_tools"><item quantity="one">Используется %d инструмент</item><item quantity="few">Используется %d инструмента</item><item quantity="many">Используется %d инструментов</item><item quantity="other">Используется %d инструментов</item></plurals>
<plurals name="tool_run_used_tools"><item quantity="one">Использован %d инструмент</item><item quantity="few">Использовано %d инструмента</item><item quantity="many">Использовано %d инструментов</item><item quantity="other">Использовано %d инструментов</item></plurals>
<string name="agent_icon_title">Иконка агента</string>
<string name="agent_icon_set">Выбрать файл</string>
<string name="agent_icon_change">Выбрать файл</string>
@@ -3263,6 +3283,7 @@
</plurals>
<string name="tool_preparing">Подготовка инструмента…</string>
<string name="thinking_title">Ход мыслей</string>
<string name="thinking_settled">Мысль</string>
<string name="thinking_thinking">Обдумывает...</string>
<string name="thinking_thinking_short">Обдумывает</string>
<string name="task_background_prefix">Фоновая задача, </string>
@@ -3491,6 +3512,7 @@
<string name="voice_overlay_attachment_ready">Вложение готово</string>
<string name="conn_info_active_profile">Активный профиль</string>
<string name="msg_bubble_speak_response">Озвучить ответ</string>
<string name="msg_bubble_stop_speaking">Остановить озвучивание</string>
<string name="voice_overlay_engine_standard">Стандартный режим</string>
<string name="voice_overlay_caption_hermes">Hermes</string>
<string name="voice_overlay_open_hermes">Открыть Hermes</string>
@@ -3607,4 +3629,103 @@
<string name="support_bundle_copied">Сведения для поддержки скопированы</string>
<string name="support_bundle_no_share">Сведения для поддержки скопированы — приложение для отправки не найдено</string>
<string name="support_bundle_share_title">Поделиться сведениями поддержки Hermes-Relay</string>
<string name="chat_search_conversation">Поиск по беседе</string>
<string name="chat_search_close">Закрыть поиск</string>
<string name="chat_search_no_results">Ничего не найдено</string>
<string name="chat_search_result_count">%1$d из %2$d</string>
<string name="msg_bubble_queued">В очереди</string>
<string name="msg_bubble_steered">Исправление отправлено</string>
<string name="chat_quote_you">Вы</string>
<string name="chat_quote_hermes">Hermes</string>
<string name="chat_quote_open">Открыть исходное сообщение от %1$s</string>
<string name="chat_quote_remove">Убрать цитату</string>
<string name="profile_shelf_switch_agent">Сменить агента</string>
<string name="profile_shelf_all_profiles">Открыть все профили агентов</string>
<string name="profile_shelf_open_passport">Открыть паспорт агента</string>
<string name="profile_shelf_switch_to">Переключиться на этого агента</string>
<string name="profile_shelf_locked_hint">Переключение профилей заблокировано. Нажмите и удерживайте активного агента, чтобы снять блокировку.</string>
<string name="profile_shelf_inspect">Просмотреть профиль</string>
<string name="profile_shelf_hide">Скрыть с полки профилей</string>
<string name="profile_shelf_expand">Развернуть полку профилей</string>
<string name="profile_shelf_collapse">Свернуть полку профилей</string>
<string name="appearance_intro">Выберите шаблон и сразу посмотрите результат.</string>
<string name="appearance_preset_gallery">Галерея шаблонов</string>
<string name="appearance_preview_relay">Предпросмотр · Relay</string>
<string name="appearance_preview_user_message">Дай три коротких совета для продуктивного утра.</string>
<string name="appearance_preview_agent">Hermes</string>
<string name="appearance_preview_agent_message">1. Выберите одну реальную цель до просмотра ленты.\n2. Выделите первые 45–90 минут.\n3. Начните с ритуала подготовки, а не с «мотивации».</string>
<string name="appearance_preview_time">19:00</string>
<string name="appearance_preview_voice">Голос</string>
<string name="appearance_preview_tool_meta">tool_executor · 206 токенов · 137,2 тыс.</string>
<string name="appearance_preview_message_placeholder">Сообщение…</string>
<string name="appearance_preview_gateway">Gateway · LAN · gpt-5.5 / профиль: по умолчанию</string>
<string name="appearance_preview_live_note">Предпросмотр сразу обновляется при изменении шаблона, режима, шрифта и оформления Sphere.</string>
<string name="appearance_customize_theme">Настроить %1$s</string>
<string name="appearance_accent_preset">Предустановленный акцент</string>
<string name="appearance_accent_custom">Пользовательский акцент применён</string>
<string name="appearance_accent_preview_only">Изменения остаются в предпросмотре, пока вы их не примените.</string>
<string name="appearance_accent_preview_only_short">Только предпросмотр</string>
<string name="appearance_apply_changes">Применить изменения</string>
<string name="appearance_customize_summary">Акцент, поверхности, форма и плотность</string>
<string name="appearance_shape">Форма</string>
<string name="appearance_shape_soft">Мягкая</string>
<string name="appearance_shape_balanced">Сбалансированная</string>
<string name="appearance_shape_sharp">Угловатая</string>
<string name="appearance_contrast_passes">Контраст достаточный</string>
<string name="appearance_contrast_fails">Контраст нужно улучшить</string>
<string name="appearance_contrast_aa">AA для обычного текста</string>
<string name="appearance_typography_density">Типографика и плотность</string>
<string name="appearance_readability">Читаемость</string>
<string name="appearance_default">По умолчанию</string>
<string name="appearance_font_normal_summary">Размер шрифта: обычный</string>
<string name="appearance_reset_draft">Сбросить черновик</string>
<string name="appearance_accent">Цвет акцента</string>
<string name="appearance_contrast_status">Читаемый контраст · %1$.1f:1</string>
<string name="appearance_typography_density_summary">Типографика и плотность используют отдельные настройки шрифта и его размера ниже.</string>
<string name="appearance_readability_summary">Настройте здесь плотность текста, а гарнитуру выберите в разделе «Шрифт» ниже.</string>
<string name="appearance_reset">Сбросить</string>
<string name="appearance_apply">Применить</string>
<string name="appearance_background_installed">Установленные анимации</string>
<string name="appearance_import_background">Импортировать фоновую анимацию</string>
<string name="appearance_import_background_desc">Импортирует тот же безопасный ZIP питомца Relay или одно изображение, но использует его только для центральной или фоновой визуализации. Это не включает перемещение и не меняет плавающего питомца.</string>
<string name="appearance_import_sphere">Импортировать оформление Sphere</string>
<string name="appearance_create_pet">Создать своего питомца</string>
<string name="pet_creator_title">Создать своего питомца</string>
<string name="pet_creator_intro">Опишите спутника, проверьте созданные инструкции и выберите, где его создать. Ничего не отправляется, пока вы сами не отправите новый чат.</string>
<string name="pet_creator_step_idea">Выбрать идею</string>
<string name="pet_creator_name">Имя питомца</string>
<string name="pet_creator_description">Образ персонажа</string>
<string name="pet_creator_description_hint">Опишите персонажа, материалы, цвета, настроение и изображения-образцы, которые планируете прикрепить.</string>
<string name="pet_creator_animated">Анимированный пакет</string>
<string name="pet_creator_static">Статичное изображение</string>
<string name="pet_creator_step_create">Проверить и создать</string>
<string name="pet_creator_review_copy">Эти полные инструкции включают текущий формат питомца, проверку, конфиденциальность и границы проверки.</string>
<string name="pet_creator_copy">Копировать</string>
<string name="pet_creator_copied">Инструкции скопированы</string>
<string name="pet_creator_new_chat">Новый чат</string>
<string name="pet_creator_step_review">Проверить и импортировать</string>
<string name="pet_creator_review_desc">Сначала проверьте полученное изображение или ZIP. При импорте проверенные файлы копируются в хранилище приложения и не публикуются.</string>
<string name="pet_creator_import">Импортировать готового питомца</string>
<string name="dashboard_tab_memory">Память</string>
<string name="dashboard_tab_learning">Обучение</string>
<string name="dashboard_tab_channels">Каналы</string>
<string name="dashboard_tab_operations">Операции</string>
<string name="dashboard_tab_memory_lower">память</string>
<string name="dashboard_tab_learning_lower">обучение</string>
<string name="dashboard_tab_channels_lower">каналы</string>
<string name="dashboard_tab_operations_lower">операции</string>
<string name="dashboard_section_action_server_backup">Создать резервную копию сервера</string>
<string name="dashboard_profile_mcp_servers_optional">Серверы MCP (необязательно)</string>
<string name="dashboard_profile_mcp_servers_help">Имена серверов через запятую или с новой строки. Учётные данные остаются на сервере.</string>
<string name="dashboard_tile_memory_title">Память</string>
<string name="dashboard_tile_memory_sub">Состояние провайдера и серверная настройка памяти</string>
<string name="dashboard_tile_learning_title">Граф обучения</string>
<string name="dashboard_tile_learning_sub">Просмотр изученных узлов активного профиля</string>
<string name="dashboard_tile_channels_title">Каналы</string>
<string name="dashboard_tile_channels_sub">Состояние платформ сообщений, включая WhatsApp</string>
<string name="dashboard_tile_operations_title">Операции сервера</string>
<string name="dashboard_tile_operations_sub">Состояние хоста и резервная копия всего сервера</string>
<string name="drawer_all_profiles">Все профили</string>
<string name="drawer_no_profile_sessions">Нет подходящих сеансов профиля.</string>
<string name="drawer_close">Закрыть</string>
</resources>

Some files were not shown because too many files have changed in this diff Show More