fix(desktop): apps page empty due to OmiAppCapability decoding failure

[beastoin]

Summary

• Root cause: /v1/app-capabilities returns objects without a description field, but OmiAppCapability struct had description: String as required. Since getAppCapabilities() runs concurrently with getAppsV2() in AppProvider.fetchApps(), the decode failure causes the entire try await to fail, showing "No apps found".
• Fix: Added custom init(from:) decoder to OmiAppCapability using decodeIfPresent for both title and description, defaulting to empty string.
• Also: Reduced getAppsV2 default limit from 100 to 50 to match backend max.

v0.11.241 still has this bug — Apps page shows "No apps found" in production. This fix was verified locally with a test bundle.

Evidence

• Before (Omi Beta v0.11.241): Apps page shows "No apps found" + Decoding error - key 'description' not found in logs
• After (test-6380 with fix): Apps page loads all apps (Imports, Exports grid)

Test plan

• Built test-6380 named bundle from main + this fix
• Apps page loads correctly (Imports: Calendar, Email, Local files, Apple Notes, ChatGPT, Claude; Exports: Notion, Obsidian, etc.)
• Tasks page shows action items correctly (action_items key fix from fix(desktop): apps empty state + API response alignment + conversations/count endpoint #6380 working)
• Goals widget displays 4 goals on Dashboard (array response fix from fix(desktop): apps empty state + API response alignment + conversations/count endpoint #6380 working)
• Zero decoding errors in /private/tmp/omi-dev.log

🤖 Generated with Claude Code

[greptile-apps]

Greptile Summary

This PR fixes a production bug where the Apps page showed "No apps found" because /v1/app-capabilities returns objects without a description field, causing OmiAppCapability decoding to throw. Since getAppCapabilities() runs concurrently with getAppsV2() in a single try await tuple, one decode failure aborted the entire fetch. The fix adds a custom init(from:) using decodeIfPresent for title and description, defaulting to \"\".

Confidence Score: 5/5

Safe to merge — targeted fix for a confirmed production crash with no regressions introduced.

Single-file change with a correct, well-scoped decoding fix. The only finding is a P2 style note about a redundant CodingKeys enum with no behavioral impact. Encoding conformance is unaffected because the explicit CodingKeys enum causes Swift to synthesize encode(to:) correctly.

No files require special attention.

Important Files Changed

Filename	Overview
desktop/Desktop/Sources/APIClient.swift	Adds custom Decodable init to OmiAppCapability using decodeIfPresent for title/description; reduces getAppsV2 limit from 100 to 50

Sequence Diagram

sequenceDiagram
    participant AP as AppProvider.fetchApps()
    participant AC as APIClient
    participant BE as Backend

    AP->>+AC: async let getAppsV2()
    AP->>+AC: async let getAppCategories()
    AP->>+AC: async let getAppCapabilities()

    AC->>BE: GET /v2/apps
    AC->>BE: GET /v1/app-categories
    AC->>BE: GET /v1/app-capabilities

    BE-->>AC: apps JSON
    BE-->>AC: categories JSON
    BE-->>AC: capabilities JSON (missing description field)

    Note over AC: Before fix: decode throws → entire try await fails
    Note over AC: After fix: decodeIfPresent defaults to empty string → success

    AC-->>-AP: OmiAppsV2Response
    AC-->>-AP: [OmiAppCategory]
    AC-->>-AP: [OmiAppCapability]

    AP->>AP: Update UI state

Loading

_{Reviews (1): Last reviewed commit: "Revert getAppsV2 limit to 100 — backend ..." | Re-trigger Greptile}

[greptile-apps]

Redundant CodingKeys enum

All three case names (id, title, description) exactly match their property names, so Swift's synthesized CodingKeys would be identical. This can be removed with no behavioral change.

Suggested change

	enum CodingKeys: String, CodingKey {
	case id, title, description
	}
	}
	}

_{Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!}

[beastoin]

Test Results — PR #6385 verified on Mac Mini M4

Build

• Branch: fix/desktop-apps-decode-6380
• Named test bundle: pr6385.app (com.omi.pr6385)
• Build: xcrun swift build -c debug — clean, 17s incremental

Results

Area	Status	Details
Apps page	PASS	334 apps loaded (5 featured, 29 integrations, 100 chat, 100 summary, 100 notifications)
Tasks (action items)	PASS	6+11 items synced, "Test PR 6272 desktop tools" displayed
Goals	PASS	4 goals displayed on Dashboard
Decoding errors	ZERO	No description not found, no key/type mismatches

Comparison: Omi Beta v0.11.241 (WITHOUT this fix)

[06:22:33.156] [error] Decoding error - key 'description' not found: No value associated with key CodingKeys(stringValue: "description", intValue: nil) ("description")
[06:22:33.613] [error] Failed to fetch apps: The data couldn't be read because it is missing.

Apps page shows "No apps found" because /v1/app-capabilities returns {id, title} without description, causing OmiAppCapability decode to fail, which kills the entire AppProvider.fetchApps() concurrent await.

Logs from pr6385 test bundle (WITH this fix)

[13:39:14.695] [app] GoalStorage: Synced 4 goals from server
[13:39:14.749] [app] ActionItemStorage: Synced 11 task action items from backend
[13:39:14.762] [app] ActionItemStorage: Synced 6 task action items from backend
[13:39:16.073] [app] Fetched 334 apps via v2: 5 featured, 29 integrations, 100 chat, 100 summary, 100 notifications
[13:39:16.073] [perf] DATA LOAD: Apps (1821.5ms)

Zero [error] lines related to decoding.

Screenshots

Dashboard — Tasks + Goals working:

Apps page — full grid loaded:

Tasks page — action items parsed:

[beastoin]

lgtm

[beastoin]

v0.11.242 Live Verification — PASS

Omi Beta updated to v0.11.242 via Sparkle on Mac Mini M4.

Results

Area	Status	Details
Apps page	PASS	Full grid loaded (Imports + Exports) — no more "No apps found"
Tasks (action items)	PASS	11 items synced from backend
Goals	PASS	4 goals displayed on Dashboard
description not found error	GONE	Zero occurrences
Failed to fetch apps error	GONE	Zero occurrences

Logs (v0.11.242 session)

[07:21:33.133] [app] ActionItemStorage: Synced 11 task action items from backend
[07:21:36.467] [app] Screen capture test: SUCCESS

Zero [error] lines related to apps or goals decoding.

Screenshots (Omi Beta v0.11.242)

Dashboard — title bar shows v0.11.242, Tasks + Goals working:

Apps page — full grid loaded:

Minor: new TaskDedup error (pre-existing, unrelated to this PR)

[07:21:33.740] [error] Decoding error - key 'action_items' not found
[07:21:33.744] [app] TaskDedup: Failed to fetch staged tasks

/v1/staged-tasks returns {"items": ...} but ActionItemsListResponse now expects action_items after PR #6380's CodingKey change. Non-critical (dedup is background-only), but should be fixed separately.