Merge remote-tracking branch 'origin/docs/i18n-batch-core' into worktree/pr344-retarget-stack

# Conflicts:
#	docs/core-data-structures/session-query.md
#	scripts/type-equiv.manifest.json
This commit is contained in:
Tianyi Cui
2026-07-24 00:00:04 +08:00
370 changed files with 12424 additions and 1360 deletions

View File

@@ -60,14 +60,14 @@ interface AskUserQuestionRequest {
## Answer
Providers return one answer per answered question id. `selected` contains selected option labels, and `custom` carries a free-form "Other" answer when the user typed one. When `custom` is present, `selected` is empty; custom text is an answer override, not a supplement to selected choices.
Providers return one answer item per question id. `selected` contains selected option labels, and `custom` carries a free-form "Other" answer when the user typed one. When `custom` is present, `selected` is empty; custom text is an answer override, not a supplement to selected choices. A UI may also use an item with empty `selected` and no `custom` to preserve a skipped question in an otherwise completed batch.
```ts type-equiv
/** Answer to one question. */
interface AskUserQuestionAnswerItem {
/** The answered question id. */
id: string
/** Selected option labels. Empty when the answer is purely custom text. */
/** Selected option labels. Empty for custom or unanswered choices. */
selected: string[]
/** Optional free-text "Other" answer. */
custom?: string