Fix cross-host task identity and prepare v0.7.0.1 (#7)

* fix: merge new-thread mirrors without titles

* fix: harden cross-host thread identity

* release: prepare v0.7.0.1

* fix: make release checksums portable

Author: dazer1234

CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.7.0.1 - 2026-07-22
+
+- Fixed one cross-host Codex task appearing twice when a new Windows or Mac thread transitioned from its temporary renderer ID to its stable rollout ID.
+- Remember resolved temporary thread aliases across later task selections and relay reconnects so mirrored tasks remain de-duplicated.
+- Preserve the available title and context usage from either host when the rollout owner temporarily publishes incomplete renderer metadata.
+- Reserve `Not assigned` for genuinely empty agent slots; assigned titleless threads now use `New chat` while their native title is pending.
+- Keep a neutral context ring visible until a new thread publishes its first token-count event.
+- Added bidirectional Windows-to-Mac and Mac-to-Windows regression coverage for task identity, title fallback, selection changes, and reconnects.
+
 ## 0.7.0 - 2026-07-21
 
 - Added a source-distributed native SwiftUI iPhone companion that merges authenticated Mac and Windows snapshots while leaving the Stream Deck plugin independent.

README.md

@@ -178,6 +178,11 @@ npm run audit:release
 
 `npm run release:prepare` creates a versioned local release-candidate directory with the plugin package, Windows launcher ZIP, and SHA-256 checksums. The macOS ZIP must be created on macOS with `scripts/package-macos-release.sh` so executable bits survive; pass that ZIP to `scripts/prepare-release.ps1 -MacArchivePath ...`.
 
+For a four-component Stream Deck hotfix version, set
+`CODEX_DECK_RELEASE_VERSION=0.7.0.1` while running the macOS packager and pass
+`-ReleaseVersion 0.7.0.1` to `prepare-release.ps1`. The npm package keeps its
+SemVer-compatible prerelease form.
+
 Nothing is published automatically. See [CONTRIBUTING.md](CONTRIBUTING.md).
 
 ## Acknowledgements

docs/IOS_INSTALL.md

@@ -34,7 +34,7 @@ For a released build, either download **Source code (zip)** from that GitHub
 release and extract it, or clone the matching tag in Terminal:
 
 ```zsh
-git clone --branch v0.7.0 --depth 1 https://github.com/dazer1234/codex-stream-deck.git
+git clone --branch v0.7.0.1 --depth 1 https://github.com/dazer1234/codex-stream-deck.git
 cd codex-stream-deck
 ```
 

docs/RELEASE_0.7.0.1.md

@@ -0,0 +1,32 @@
+# Codex Deck v0.7.0.1
+
+This hotfix hardens mirrored task identity between Windows and macOS Codex
+instances. It does not change the launcher, watcher, iPhone pairing, or native
+Codex Micro command surface introduced in v0.7.0.
+
+## Fixes
+
+- De-duplicates a new task while Codex transitions from its temporary renderer
+  ID to the stable rollout ID visible on the other host.
+- Remembers that mapping across later task selections and relay reconnects in
+  both Windows-to-Mac and Mac-to-Windows directions.
+- Uses the title and context usage available from either mirror when one host
+  temporarily publishes incomplete metadata.
+- Shows `New chat` for an assigned titleless thread and reserves `Not assigned`
+  for a genuinely empty agent slot.
+- Keeps a neutral context ring visible until the first token-count event arrives.
+
+## Downloads
+
+- Stream Deck: `com.simeo.codex-deck.streamDeckPlugin`
+- Windows launcher: `codex-deck-launcher-windows-v0.7.0.1.zip`
+- macOS launcher: `codex-deck-launcher-macos-v0.7.0.1.zip`
+- iPhone source: use the Source code archive or clone tag `v0.7.0.1`.
+- Checksums: `SHA256SUMS.txt`
+
+Existing v0.7.0 launcher and watcher installations remain compatible. Stream
+Deck users only need to install the updated plugin. Reload the Codex Deck
+Stream Deck plugin after updating; Codex itself does not need to restart.
+
+Codex Deck is an independent community project and is not made, supported, or
+endorsed by OpenAI or Elgato.

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "codex-stream-deck",
-  "version": "0.7.0",
+  "version": "0.7.0-hotfix.1",
   "private": false,
   "type": "module",
   "description": "Unofficial Codex Micro bridge for Stream Deck on Windows and macOS, with optional multi-host relay",

package.json

@@ -2,7 +2,8 @@
 set -euo pipefail
 
 ROOT="${0:A:h:h}"
-VERSION="$(node -p "require('$ROOT/package.json').version")"
+PACKAGE_VERSION="$(node -p "require('$ROOT/package.json').version")"
+VERSION="${CODEX_DECK_RELEASE_VERSION:-$PACKAGE_VERSION}"
 OUTPUT="${1:-$ROOT/outputs/codex-deck-launcher-macos-v$VERSION.zip}"
 mkdir -p "${OUTPUT:h}"
 rm -f "$OUTPUT"

scripts/package-macos-release.sh

@@ -1,4 +1,7 @@
-param([string]$MacArchivePath)
+param(
+  [string]$MacArchivePath,
+  [string]$ReleaseVersion
+)
 
 $ErrorActionPreference = 'Stop'
 
@@ -14,7 +17,10 @@ function Get-Sha256Hex([string]$Path) {
 
 $root = [IO.Path]::GetFullPath((Join-Path $PSScriptRoot '..'))
 $package = Get-Content -LiteralPath (Join-Path $root 'package.json') -Raw | ConvertFrom-Json
-$version = [string]$package.version
+$version = if ([string]::IsNullOrWhiteSpace($ReleaseVersion)) { [string]$package.version } else { $ReleaseVersion.Trim() }
+if ($version -notmatch '^\d+\.\d+\.\d+(?:\.\d+)?(?:-[0-9A-Za-z.-]+)?$') {
+  throw "Invalid release version: $version"
+}
 $output = Join-Path $root "outputs\release-v$version"
 
 Push-Location $root
@@ -42,7 +48,8 @@ try {
   }
   $artifacts = Get-ChildItem -LiteralPath $output -File | Sort-Object Name
   $checksums = @($artifacts | ForEach-Object { "{0}  {1}" -f (Get-Sha256Hex $_.FullName), $_.Name })
-  [IO.File]::WriteAllLines((Join-Path $output 'SHA256SUMS.txt'), $checksums, [Text.UTF8Encoding]::new($false))
+  $checksumText = ($checksums -join "`n") + "`n"
+  [IO.File]::WriteAllText((Join-Path $output 'SHA256SUMS.txt'), $checksumText, [Text.UTF8Encoding]::new($false))
   Write-Host "Release candidate prepared at: $output"
 } finally {
   Pop-Location

scripts/prepare-release.ps1

@@ -415,7 +415,7 @@ export class DeckController {
     const unavailableTitle = health.state === "degraded" ? "Signals uncertain"
       : health.state === "offline" ? "Host offline"
         : health.state === "connecting" ? "Connecting" : "Not assigned";
-    const title = agent?.title ?? unavailableTitle;
+    const title = agent?.title ?? (agent?.threadKey && health.state === "ready" ? "New chat" : unavailableTitle);
     const status = agent ? visualStatusFromMicro(agent.status) : "empty";
     const theme = this.targetSnapshot()?.theme ?? this.localSnapshot?.snapshot.theme ?? "dark";
     const hostBadge = agent && this.relayClient ? (agent.host.platform === "darwin" ? "M" : "W") : undefined;

src/controller.ts

@@ -48,15 +48,18 @@ export type HostSnapshot = { host: CodexHost; snapshot: MicroSnapshot; observedA
 
 type ActivityRecord = { activityAt: number; signature: string; lastSeenAt: number };
 type SessionOwner = { input: HostSnapshot; session: HostSessionPresence };
+type TemporaryAliasRecord = { identity: string; lastSeenAt: number };
 const MIRROR_STATUS_FRESHNESS_MS = 5_000;
 const SESSION_COMPLETION_FALLBACK_MS = 5 * 60_000;
+const TEMPORARY_ALIAS_RETENTION_MS = 24 * 60 * 60_000;
 
 export class HostActivityIndex {
   private readonly activity = new Map<string, ActivityRecord>();
   private readonly acknowledgedCompletions = new Map<string, number>();
+  private readonly temporaryAliases = new Map<string, TemporaryAliasRecord>();
 
   merge(inputs: HostSnapshot[], now = Date.now(), authoritativeHostId?: string): RoutedAgentSlot[] {
-    const aliases = temporaryThreadAliases(inputs);
+    const aliases = temporaryThreadAliases(inputs, this.temporaryAliases, now);
     const routed: RoutedAgentSlot[] = [];
     for (const input of inputs) {
       for (const slot of input.snapshot.slots) {
@@ -334,10 +337,12 @@ function mergeMirrors(
   const contextCandidate = candidates.find((candidate) =>
     candidate.ownedByHost === true && candidate.contextUsedPercent != null)
     ?? candidates.find((candidate) => candidate.contextUsedPercent != null);
+  const titleCandidate = candidates.find((candidate) => normalizedTitle(candidate.title));
   return {
     ...owner,
     host: routedOwner,
     ownedByHost: sessionOwner ? true : owner.ownedByHost,
+    title: normalizedTitle(owner.title) ? owner.title : titleCandidate?.title ?? null,
     status,
     selected: statusCandidates.some((candidate) => candidate.selected),
     contextUsedPercent: sessionOwner?.session.contextUsedPercent ?? contextCandidate?.contextUsedPercent,
@@ -406,7 +411,11 @@ function threadIdentity(value: string): string {
   return value.match(/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i)?.[0]?.toLowerCase() ?? value;
 }
 
-function temporaryThreadAliases(inputs: HostSnapshot[]): Map<string, string> {
+function temporaryThreadAliases(
+  inputs: HostSnapshot[],
+  remembered: Map<string, TemporaryAliasRecord>,
+  now: number
+): Map<string, string> {
   const aliases = new Map<string, string>();
   for (const input of inputs) {
     const ownedSessions = new Set(
@@ -415,6 +424,20 @@ function temporaryThreadAliases(inputs: HostSnapshot[]): Map<string, string> {
 
     for (const slot of input.snapshot.slots) {
       if (!slot.threadKey?.toLowerCase().includes(":client-new-thread:")) continue;
+      const temporaryKey = aliasKey(input.host, threadIdentity(slot.threadKey));
+      const prior = remembered.get(temporaryKey);
+      if (prior && now - prior.lastSeenAt <= TEMPORARY_ALIAS_RETENTION_MS) {
+        aliases.set(temporaryKey, prior.identity);
+        prior.lastSeenAt = now;
+      }
+      const activeIdentity = input.snapshot.activeThreadKey
+        ? threadIdentity(input.snapshot.activeThreadKey) : null;
+      if (slot.selected && activeIdentity && ownedSessions.has(activeIdentity) &&
+        !input.snapshot.activeThreadKey?.toLowerCase().includes(":client-new-thread:")) {
+        aliases.set(temporaryKey, activeIdentity);
+        remembered.set(temporaryKey, { identity: activeIdentity, lastSeenAt: now });
+        continue;
+      }
       const title = normalizedTitle(slot.title);
       if (!title) continue;
       const matches = new Set<string>();
@@ -427,10 +450,14 @@ function temporaryThreadAliases(inputs: HostSnapshot[]): Map<string, string> {
         }
       }
       if (matches.size !== 1) continue;
-      aliases.set(
-        aliasKey(input.host, threadIdentity(slot.threadKey)), [...matches][0]!);
+      const identity = [...matches][0]!;
+      aliases.set(temporaryKey, identity);
+      remembered.set(temporaryKey, { identity, lastSeenAt: now });
     }
   }
+  for (const [key, record] of remembered) {
+    if (now - record.lastSeenAt > TEMPORARY_ALIAS_RETENTION_MS) remembered.delete(key);
+  }
   return aliases;
 }