dreampiler/kandev
1
0
Fork 0
Code Issues 43 Pull Requests Actions 6 Packages Projects Releases Wiki Activity

fix(web): show model option loading state (#2806)

Browse Source
This commit is contained in:
Carlos Florêncio
2026-08-19 17:02:50 +01:00
committed by GitHub
parent 0b10edfa22
commit f53681e607
13 changed files with 705 additions and 40 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/specs/agents/dynamic-provider-options.md
+34 -11
View File
@@ -1,6 +1,7 @@
---
status: shipped
status: implemented
created: 2026-08-07
updated: 2026-08-19
owner: kandev
---
@@ -30,6 +31,9 @@ settings surfaces that do not have a live task session:
- After a user selects a model in the workflow session override editor or an
agent profile editor, Kandev requests a model-aware capability snapshot from
the provider through a sessionless ACP probe.
- In an agent profile editor, the open model selector stays open while Kandev
resolves the selected model. The area below the model list shows a localized
loading spinner instead of stale dependent options.
- The probe applies the requested model using generic ACP session-model logic,
captures the complete post-model `config_options` response or update, and
applies the existing ACP compatibility normalization.
@@ -60,6 +64,19 @@ to a model with additional selectable options, then the profile editor uses
the same resolved snapshot as workflow settings and allows those options to be
selected and saved.
### Agent profile shows model-option progress
Given an open agent profile model selector, when the author selects a model,
then option resolution starts. The selector stays open and shows a loading
spinner in the selected model row and below the model list. The selected row
does not show its check icon while it is resolving. The selector hides stale
dependent controls until the new option snapshot arrives.
Given that the option request is complete, when Kandev shows the resolved
snapshot or an error, then the selected row restores its check icon and the
loading spinners are not visible. The existing resolved controls or retryable
error state are available.
### Model removes an option
Given a draft with a selected option for the current model, when the author
@@ -80,8 +97,9 @@ change is required for the new identifier.
Given a model selection whose capability probe times out, is unavailable, or
returns no complete post-model option snapshot, when the settings page receives
the failure, then it keeps already persisted and currently selected values,
does not offer unverified new options, shows a retryable discovery error, and
allows a model-only save when the rest of the form is valid.
does not show stale dependent controls or offer unverified new options, shows a
retryable discovery error, and allows a model-only save when the rest of the
form is valid.
### Responses arrive out of order
@@ -103,6 +121,9 @@ resolved options in either settings flow, then controls remain in a one-column
touch-friendly layout, use the existing settings scroll owner, and do not
create document-level horizontal overflow.
Given an open agent profile model selector on a phone, when model options load,
then the same loading indicators are visible and remain inside the selector.
## Data model
No durable database schema is added.
@@ -186,14 +207,14 @@ conventions and never expose provider secrets or raw process output.
Each settings surface follows this state machine for the selected resolution
context:
| State | Event | Result |
| --- | --- | --- |
| baseline | model selected | Show baseline options and start one resolver request. |
| resolving | matching response | Replace options with the complete snapshot and reconcile the draft. |
| resolving | stale response | Ignore it and keep the newer model's state. |
| resolving | timeout/error | Keep existing values, show retryable error, and do not add controls. |
| resolved | same context requested | Reuse the runtime cache. |
| resolved | refresh or baseline invalidation | Request a fresh snapshot. |
| State | Event | Result |
| --------- | -------------------------------- | -------------------------------------------------------------------- |
| baseline | model selected | Show baseline options and start one resolver request. |
| resolving | matching response | Replace options with the complete snapshot and reconcile the draft. |
| resolving | stale response | Ignore it and keep the newer model's state. |
| resolving | timeout/error | Keep existing values, show retryable error, and do not add controls. |
| resolved | same context requested | Reuse the runtime cache. |
| resolved | refresh or baseline invalidation | Request a fresh snapshot. |
An option snapshot is replaced atomically. The frontend must not merge an old
model's choices with a new model's choices.
@@ -254,5 +275,7 @@ task session, change an agent profile, or mutate provider configuration.
out-of-order response.
- Resolver failures preserve saved data and provide a retryable, localized
status.
- The agent profile model selector shows localized progress below the model
list while model-dependent options load.
- Desktop and mobile E2E coverage verifies workflow and profile behavior, with
touch sizing and overflow assertions for the mobile workflow editor.