From 46d9abd98cc4fe00a8df12e225a8a987506d214d Mon Sep 17 00:00:00 2001 From: canvrno-oai Date: Mon, 4 May 2026 16:06:36 -0700 Subject: [PATCH] docs: document app list update finality --- codex-rs/app-server/README.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/codex-rs/app-server/README.md b/codex-rs/app-server/README.md index c167627257..f452f15916 100644 --- a/codex-rs/app-server/README.md +++ b/codex-rs/app-server/README.md @@ -1639,12 +1639,13 @@ When `threadId` is provided, app feature gating (`Feature::Apps`) is evaluated u `app/list` returns after both accessible apps and directory apps are loaded. Set `forceRefetch: true` to bypass app caches and fetch fresh data from sources. Cache entries are only replaced when those refetches succeed. -The server also emits `app/list/updated` notifications whenever either source (accessible apps or directory apps) finishes loading. Each notification includes the latest merged app list. +The server also emits `app/list/updated` notifications whenever either source (accessible apps or directory apps) finishes loading. Each notification includes the latest merged app list and `isFinal`, which is `false` for interim updates and `true` once both sources have loaded. ```json { "method": "app/list/updated", "params": { + "isFinal": true, "data": [ { "id": "demo-app",