@dudousxd/nestjs-agent-react 0.11.0 → 0.12.0

package/dist/index.d.cts

@@ -1,7 +1,8 @@
 import * as ai from 'ai';
 import { ChatTransport, UIMessage, UIMessageChunk, ToolUIPart, DynamicToolUIPart, DataUIPart, UIDataTypes } from 'ai';
 import * as _dudousxd_nestjs_agent_core from '@dudousxd/nestjs-agent-core';
-import { StoredMessage, ThreadSummary, SkillCatalogEntry, ToolCatalogEntry, ThreadDetail, MessageAttachment, QuotaView, ToolPresentation, ToolResultField, ToolResultView, ToolPresentationTone } from '@dudousxd/nestjs-agent-core';
+import { StoredMessage, ThreadSummary, SkillCatalogEntry, ToolCatalogEntry, ThreadDetail, MessageAttachment, QuotaView, ElicitationQuestion, ElicitationInputType, ToolPresentation, ToolResultField, ToolResultView, ToolPresentationTone, ElicitationInput } from '@dudousxd/nestjs-agent-core';
+export { ElicitationInput, ElicitationInputType, validateElicitationAnswer as validateAnswer, validateElicitationValue as validateAnswerValue } from '@dudousxd/nestjs-agent-core';
 import React from 'react';
 
 /** Identity surfaced by the backend's `meta` SSE frame / response headers. */
@@ -314,6 +315,26 @@ interface ChatInputProps {
  */
 declare function ChatInput({ onSubmit, disabled, placeholder, rows, enableSpeech, speechLang, sendLabel, onStop, isStreaming, stopLabel, className, textareaClassName, sendButtonClassName, micButtonClassName, stopButtonClassName, renderMic, }: ChatInputProps): React.JSX.Element;
 
+/** What a form control can hand over: a field's value, a checkbox's state, a picked date, a list. */
+type RawAnswer = string | number | boolean | Date | null | undefined | readonly RawAnswer[];
+/** The question fields {@link coerceAnswer} reads. A transcript question and a core one both fit. */
+type CoercibleQuestion = Pick<ElicitationQuestion, 'multiple'> & {
+    input?: {
+        type: ElicitationInputType;
+    } | null;
+};
+/**
+ * Turn whatever a form control produced into the `string[]` the answer route takes, in the
+ * question's canonical form: numbers as decimals, booleans as `"true"`/`"false"`, dates as
+ * `YYYY-MM-DD` (a `Date` is read as the local calendar day), trimmed where whitespace means
+ * nothing. An empty value becomes `[]` — no answer, not an empty string. A single-choice question
+ * keeps the first value.
+ *
+ * Coercion never judges: pair it with {@link validateAnswer} (the same rules the server applies) to
+ * say what is wrong before sending.
+ */
+declare function coerceAnswer(question: CoercibleQuestion, raw: RawAnswer): string[];
+
 /** Tool name → how the server said it is spoken about. */
 type ToolCatalog = Record<string, ToolPresentation>;
 /** Index `GET <base>/tools` by tool name, keeping only the tools that declared a presentation. */
@@ -669,6 +690,14 @@ interface TranscriptQuestionOption {
 interface TranscriptQuestion {
     id: string;
     prompt: string;
+    /** A line of help under the prompt; `null` when the request gave none. */
+    description: string | null;
+    /**
+     * How the answer is typed — `{ type, placeholder?, required?, min?, max?, pattern? }` — or `null`
+     * for a plain pick from `options`. Render the control from `input.type`; `select` still picks
+     * from `options`.
+     */
+    input: ElicitationInput | null;
     multiple: boolean;
     /** 1-based. The request carries every question up front, so "Question 1 of N" is honest. */
     position: number;
@@ -680,6 +709,20 @@ interface TranscriptQuestion {
      * first is recorded as `defaulted` rather than as a choice the user made.
      */
     isPristine: boolean;
+    /** The first selected value, or `''` — what a single text/number/date field shows. */
+    value: string;
+    /**
+     * Set a typed answer from whatever the control produced (a string, a number, a checkbox's
+     * boolean, a `Date`, a list); coerced to the question's canonical strings with `coerceAnswer`.
+     * `null`/`''` clears it. Does nothing once the set settled.
+     */
+    setValue: (raw: RawAnswer) => void;
+    /**
+     * Why the current selection would be refused (the server's own rules — `validateAnswer`), or
+     * `null`. A pristine required question with no default reads `requires an answer`; show it once
+     * the user tried to submit, or right away — the model does not decide that for you.
+     */
+    error: string | null;
 }
 /** How a question set settled, once it did. */
 interface TranscriptElicitationOutcome {
@@ -706,6 +749,8 @@ interface TranscriptElicitationBlock {
     questionCount: number;
     /** Still waiting on a human. */
     isPending: boolean;
+    /** Every question's current selection is acceptable (no question has an `error`). */
+    isValid: boolean;
     outcome: TranscriptElicitationOutcome | null;
     /** A failed submission — the run is still parked, so the form stays live. */
     error: string | null;
@@ -1711,4 +1756,4 @@ declare function useAgentChat(options: UseAgentChatOptions): {
     clearError: () => void;
 };
 
-export { AgentChatTransport, type AgentChatTransportOptions, AgentClient, type AgentClientOptions, AgentHttpError, type AgentStreamMeta, type AggregatedTurnUsage, type AnyToolUIPart, type ApprovalBlockOptions, type ApprovalCountdown, type ApproveOptions, type AutocompleteInputProps, type AutocompleteItem, type AutocompleteListboxProps, type AutocompleteOptionProps, type AutocompleteSource, type BackgroundRun, type BuildBlocksOptions, type CancelResult, type ChatBackground, ChatInput, type ChatInputProps, type ChatStatus, type ChatTranscript, type CompletionEdit, type ComposerAutocomplete, DEFAULT_SPEECH_LANG, type DescribeToolCallOptions, type ElicitationBlockOptions, type GroupToolActivityOptions, MessageItem, type MessageItemClassNames, type MessageItemProps, MessageItemView, type MessageItemViewProps, MessageList, type MessageListClassNames, type MessageListProps, type MessageUsageInfo, type QuotaToday, type RenderFilesFn, type RenderReasoningFn, type RenderTextFn, type RenderToolGroupFn, type RenderToolPartFn, type RenderUiFn, type ResolvedReading, type ResolvedResultView, type RetrievedPassage, SPEECH_LANGUAGES, type SettleAction, type SkillSuggestionData, type SkillsSourceOptions, type SpeechLanguage, type SpeechRecognitionHook, type StickToBottom, type StickToBottomOptions, type StoredTurnMetadata, type ThreadPatch, type TimestampInfo, type ToolActivityGroup, type ToolCallDescription, type ToolCallState, type ToolCallStatus, type ToolCatalog, type ToolCatalogState, type TranscriptActionState, type TranscriptApproval, type TranscriptApprovalStatus, type TranscriptBlock, type TranscriptCopyState, type TranscriptEditState, type TranscriptElicitationBlock, type TranscriptElicitationOutcome, type TranscriptFile, type TranscriptFilesBlock, type TranscriptItem, type TranscriptItemOptions, type TranscriptQuestion, type TranscriptQuestionOption, type TranscriptReasoningBlock, type TranscriptSettleState, type TranscriptSource, type TranscriptSourcesBlock, type TranscriptStopState, type TranscriptTextBlock, type TranscriptToolBlock, type TranscriptToolCall, type TranscriptUiBlock, type TranscriptWindow, type TriggerMatch, type TriggerPosition, type UsageSummary, type UseAgentChatOptions, type UseApprovalCountdownOptions, type UseChatTranscriptOptions, type UseComposerAutocompleteOptions, type UseElapsedOptions, type UseSpeechRecognitionOptions, type UseToolCatalogOptions, type UseTranscriptItemOptions, applyCompletion, approvalCountdown, backgroundRunsFromThread, buildTranscriptBlocks, correctedCallIds, createSkillsSource, describeTimestamp, describeToolCall, describeUsage, extractMessageText, fillTemplate, filterAutocompleteItems, findActiveTrigger, formatElapsed, formatRelativeTime, groupToolActivity, inferResultView, isActionCall, loadStoredSpeechLang, persistSpeechLang, phraseFor, readPath, readReasoningMs, resolveResultView, storedMessageToUiMessage, storedThreadToUiMessages, toolCallState, toolCatalogFrom, useAgentChat, useApprovalCountdown, useChatTranscript, useComposerAutocomplete, useElapsed, useSpeechRecognition, useStickToBottom, useToolCatalog, useTranscriptItem };
+export { AgentChatTransport, type AgentChatTransportOptions, AgentClient, type AgentClientOptions, AgentHttpError, type AgentStreamMeta, type AggregatedTurnUsage, type AnyToolUIPart, type ApprovalBlockOptions, type ApprovalCountdown, type ApproveOptions, type AutocompleteInputProps, type AutocompleteItem, type AutocompleteListboxProps, type AutocompleteOptionProps, type AutocompleteSource, type BackgroundRun, type BuildBlocksOptions, type CancelResult, type ChatBackground, ChatInput, type ChatInputProps, type ChatStatus, type ChatTranscript, type CoercibleQuestion, type CompletionEdit, type ComposerAutocomplete, DEFAULT_SPEECH_LANG, type DescribeToolCallOptions, type ElicitationBlockOptions, type GroupToolActivityOptions, MessageItem, type MessageItemClassNames, type MessageItemProps, MessageItemView, type MessageItemViewProps, MessageList, type MessageListClassNames, type MessageListProps, type MessageUsageInfo, type QuotaToday, type RawAnswer, type RenderFilesFn, type RenderReasoningFn, type RenderTextFn, type RenderToolGroupFn, type RenderToolPartFn, type RenderUiFn, type ResolvedReading, type ResolvedResultView, type RetrievedPassage, SPEECH_LANGUAGES, type SettleAction, type SkillSuggestionData, type SkillsSourceOptions, type SpeechLanguage, type SpeechRecognitionHook, type StickToBottom, type StickToBottomOptions, type StoredTurnMetadata, type ThreadPatch, type TimestampInfo, type ToolActivityGroup, type ToolCallDescription, type ToolCallState, type ToolCallStatus, type ToolCatalog, type ToolCatalogState, type TranscriptActionState, type TranscriptApproval, type TranscriptApprovalStatus, type TranscriptBlock, type TranscriptCopyState, type TranscriptEditState, type TranscriptElicitationBlock, type TranscriptElicitationOutcome, type TranscriptFile, type TranscriptFilesBlock, type TranscriptItem, type TranscriptItemOptions, type TranscriptQuestion, type TranscriptQuestionOption, type TranscriptReasoningBlock, type TranscriptSettleState, type TranscriptSource, type TranscriptSourcesBlock, type TranscriptStopState, type TranscriptTextBlock, type TranscriptToolBlock, type TranscriptToolCall, type TranscriptUiBlock, type TranscriptWindow, type TriggerMatch, type TriggerPosition, type UsageSummary, type UseAgentChatOptions, type UseApprovalCountdownOptions, type UseChatTranscriptOptions, type UseComposerAutocompleteOptions, type UseElapsedOptions, type UseSpeechRecognitionOptions, type UseToolCatalogOptions, type UseTranscriptItemOptions, applyCompletion, approvalCountdown, backgroundRunsFromThread, buildTranscriptBlocks, coerceAnswer, correctedCallIds, createSkillsSource, describeTimestamp, describeToolCall, describeUsage, extractMessageText, fillTemplate, filterAutocompleteItems, findActiveTrigger, formatElapsed, formatRelativeTime, groupToolActivity, inferResultView, isActionCall, loadStoredSpeechLang, persistSpeechLang, phraseFor, readPath, readReasoningMs, resolveResultView, storedMessageToUiMessage, storedThreadToUiMessages, toolCallState, toolCatalogFrom, useAgentChat, useApprovalCountdown, useChatTranscript, useComposerAutocomplete, useElapsed, useSpeechRecognition, useStickToBottom, useToolCatalog, useTranscriptItem };

package/dist/index.d.ts

@@ -1,7 +1,8 @@
 import * as ai from 'ai';
 import { ChatTransport, UIMessage, UIMessageChunk, ToolUIPart, DynamicToolUIPart, DataUIPart, UIDataTypes } from 'ai';
 import * as _dudousxd_nestjs_agent_core from '@dudousxd/nestjs-agent-core';
-import { StoredMessage, ThreadSummary, SkillCatalogEntry, ToolCatalogEntry, ThreadDetail, MessageAttachment, QuotaView, ToolPresentation, ToolResultField, ToolResultView, ToolPresentationTone } from '@dudousxd/nestjs-agent-core';
+import { StoredMessage, ThreadSummary, SkillCatalogEntry, ToolCatalogEntry, ThreadDetail, MessageAttachment, QuotaView, ElicitationQuestion, ElicitationInputType, ToolPresentation, ToolResultField, ToolResultView, ToolPresentationTone, ElicitationInput } from '@dudousxd/nestjs-agent-core';
+export { ElicitationInput, ElicitationInputType, validateElicitationAnswer as validateAnswer, validateElicitationValue as validateAnswerValue } from '@dudousxd/nestjs-agent-core';
 import React from 'react';
 
 /** Identity surfaced by the backend's `meta` SSE frame / response headers. */
@@ -314,6 +315,26 @@ interface ChatInputProps {
  */
 declare function ChatInput({ onSubmit, disabled, placeholder, rows, enableSpeech, speechLang, sendLabel, onStop, isStreaming, stopLabel, className, textareaClassName, sendButtonClassName, micButtonClassName, stopButtonClassName, renderMic, }: ChatInputProps): React.JSX.Element;
 
+/** What a form control can hand over: a field's value, a checkbox's state, a picked date, a list. */
+type RawAnswer = string | number | boolean | Date | null | undefined | readonly RawAnswer[];
+/** The question fields {@link coerceAnswer} reads. A transcript question and a core one both fit. */
+type CoercibleQuestion = Pick<ElicitationQuestion, 'multiple'> & {
+    input?: {
+        type: ElicitationInputType;
+    } | null;
+};
+/**
+ * Turn whatever a form control produced into the `string[]` the answer route takes, in the
+ * question's canonical form: numbers as decimals, booleans as `"true"`/`"false"`, dates as
+ * `YYYY-MM-DD` (a `Date` is read as the local calendar day), trimmed where whitespace means
+ * nothing. An empty value becomes `[]` — no answer, not an empty string. A single-choice question
+ * keeps the first value.
+ *
+ * Coercion never judges: pair it with {@link validateAnswer} (the same rules the server applies) to
+ * say what is wrong before sending.
+ */
+declare function coerceAnswer(question: CoercibleQuestion, raw: RawAnswer): string[];
+
 /** Tool name → how the server said it is spoken about. */
 type ToolCatalog = Record<string, ToolPresentation>;
 /** Index `GET <base>/tools` by tool name, keeping only the tools that declared a presentation. */
@@ -669,6 +690,14 @@ interface TranscriptQuestionOption {
 interface TranscriptQuestion {
     id: string;
     prompt: string;
+    /** A line of help under the prompt; `null` when the request gave none. */
+    description: string | null;
+    /**
+     * How the answer is typed — `{ type, placeholder?, required?, min?, max?, pattern? }` — or `null`
+     * for a plain pick from `options`. Render the control from `input.type`; `select` still picks
+     * from `options`.
+     */
+    input: ElicitationInput | null;
     multiple: boolean;
     /** 1-based. The request carries every question up front, so "Question 1 of N" is honest. */
     position: number;
@@ -680,6 +709,20 @@ interface TranscriptQuestion {
      * first is recorded as `defaulted` rather than as a choice the user made.
      */
     isPristine: boolean;
+    /** The first selected value, or `''` — what a single text/number/date field shows. */
+    value: string;
+    /**
+     * Set a typed answer from whatever the control produced (a string, a number, a checkbox's
+     * boolean, a `Date`, a list); coerced to the question's canonical strings with `coerceAnswer`.
+     * `null`/`''` clears it. Does nothing once the set settled.
+     */
+    setValue: (raw: RawAnswer) => void;
+    /**
+     * Why the current selection would be refused (the server's own rules — `validateAnswer`), or
+     * `null`. A pristine required question with no default reads `requires an answer`; show it once
+     * the user tried to submit, or right away — the model does not decide that for you.
+     */
+    error: string | null;
 }
 /** How a question set settled, once it did. */
 interface TranscriptElicitationOutcome {
@@ -706,6 +749,8 @@ interface TranscriptElicitationBlock {
     questionCount: number;
     /** Still waiting on a human. */
     isPending: boolean;
+    /** Every question's current selection is acceptable (no question has an `error`). */
+    isValid: boolean;
     outcome: TranscriptElicitationOutcome | null;
     /** A failed submission — the run is still parked, so the form stays live. */
     error: string | null;
@@ -1711,4 +1756,4 @@ declare function useAgentChat(options: UseAgentChatOptions): {
     clearError: () => void;
 };
 
-export { AgentChatTransport, type AgentChatTransportOptions, AgentClient, type AgentClientOptions, AgentHttpError, type AgentStreamMeta, type AggregatedTurnUsage, type AnyToolUIPart, type ApprovalBlockOptions, type ApprovalCountdown, type ApproveOptions, type AutocompleteInputProps, type AutocompleteItem, type AutocompleteListboxProps, type AutocompleteOptionProps, type AutocompleteSource, type BackgroundRun, type BuildBlocksOptions, type CancelResult, type ChatBackground, ChatInput, type ChatInputProps, type ChatStatus, type ChatTranscript, type CompletionEdit, type ComposerAutocomplete, DEFAULT_SPEECH_LANG, type DescribeToolCallOptions, type ElicitationBlockOptions, type GroupToolActivityOptions, MessageItem, type MessageItemClassNames, type MessageItemProps, MessageItemView, type MessageItemViewProps, MessageList, type MessageListClassNames, type MessageListProps, type MessageUsageInfo, type QuotaToday, type RenderFilesFn, type RenderReasoningFn, type RenderTextFn, type RenderToolGroupFn, type RenderToolPartFn, type RenderUiFn, type ResolvedReading, type ResolvedResultView, type RetrievedPassage, SPEECH_LANGUAGES, type SettleAction, type SkillSuggestionData, type SkillsSourceOptions, type SpeechLanguage, type SpeechRecognitionHook, type StickToBottom, type StickToBottomOptions, type StoredTurnMetadata, type ThreadPatch, type TimestampInfo, type ToolActivityGroup, type ToolCallDescription, type ToolCallState, type ToolCallStatus, type ToolCatalog, type ToolCatalogState, type TranscriptActionState, type TranscriptApproval, type TranscriptApprovalStatus, type TranscriptBlock, type TranscriptCopyState, type TranscriptEditState, type TranscriptElicitationBlock, type TranscriptElicitationOutcome, type TranscriptFile, type TranscriptFilesBlock, type TranscriptItem, type TranscriptItemOptions, type TranscriptQuestion, type TranscriptQuestionOption, type TranscriptReasoningBlock, type TranscriptSettleState, type TranscriptSource, type TranscriptSourcesBlock, type TranscriptStopState, type TranscriptTextBlock, type TranscriptToolBlock, type TranscriptToolCall, type TranscriptUiBlock, type TranscriptWindow, type TriggerMatch, type TriggerPosition, type UsageSummary, type UseAgentChatOptions, type UseApprovalCountdownOptions, type UseChatTranscriptOptions, type UseComposerAutocompleteOptions, type UseElapsedOptions, type UseSpeechRecognitionOptions, type UseToolCatalogOptions, type UseTranscriptItemOptions, applyCompletion, approvalCountdown, backgroundRunsFromThread, buildTranscriptBlocks, correctedCallIds, createSkillsSource, describeTimestamp, describeToolCall, describeUsage, extractMessageText, fillTemplate, filterAutocompleteItems, findActiveTrigger, formatElapsed, formatRelativeTime, groupToolActivity, inferResultView, isActionCall, loadStoredSpeechLang, persistSpeechLang, phraseFor, readPath, readReasoningMs, resolveResultView, storedMessageToUiMessage, storedThreadToUiMessages, toolCallState, toolCatalogFrom, useAgentChat, useApprovalCountdown, useChatTranscript, useComposerAutocomplete, useElapsed, useSpeechRecognition, useStickToBottom, useToolCatalog, useTranscriptItem };
+export { AgentChatTransport, type AgentChatTransportOptions, AgentClient, type AgentClientOptions, AgentHttpError, type AgentStreamMeta, type AggregatedTurnUsage, type AnyToolUIPart, type ApprovalBlockOptions, type ApprovalCountdown, type ApproveOptions, type AutocompleteInputProps, type AutocompleteItem, type AutocompleteListboxProps, type AutocompleteOptionProps, type AutocompleteSource, type BackgroundRun, type BuildBlocksOptions, type CancelResult, type ChatBackground, ChatInput, type ChatInputProps, type ChatStatus, type ChatTranscript, type CoercibleQuestion, type CompletionEdit, type ComposerAutocomplete, DEFAULT_SPEECH_LANG, type DescribeToolCallOptions, type ElicitationBlockOptions, type GroupToolActivityOptions, MessageItem, type MessageItemClassNames, type MessageItemProps, MessageItemView, type MessageItemViewProps, MessageList, type MessageListClassNames, type MessageListProps, type MessageUsageInfo, type QuotaToday, type RawAnswer, type RenderFilesFn, type RenderReasoningFn, type RenderTextFn, type RenderToolGroupFn, type RenderToolPartFn, type RenderUiFn, type ResolvedReading, type ResolvedResultView, type RetrievedPassage, SPEECH_LANGUAGES, type SettleAction, type SkillSuggestionData, type SkillsSourceOptions, type SpeechLanguage, type SpeechRecognitionHook, type StickToBottom, type StickToBottomOptions, type StoredTurnMetadata, type ThreadPatch, type TimestampInfo, type ToolActivityGroup, type ToolCallDescription, type ToolCallState, type ToolCallStatus, type ToolCatalog, type ToolCatalogState, type TranscriptActionState, type TranscriptApproval, type TranscriptApprovalStatus, type TranscriptBlock, type TranscriptCopyState, type TranscriptEditState, type TranscriptElicitationBlock, type TranscriptElicitationOutcome, type TranscriptFile, type TranscriptFilesBlock, type TranscriptItem, type TranscriptItemOptions, type TranscriptQuestion, type TranscriptQuestionOption, type TranscriptReasoningBlock, type TranscriptSettleState, type TranscriptSource, type TranscriptSourcesBlock, type TranscriptStopState, type TranscriptTextBlock, type TranscriptToolBlock, type TranscriptToolCall, type TranscriptUiBlock, type TranscriptWindow, type TriggerMatch, type TriggerPosition, type UsageSummary, type UseAgentChatOptions, type UseApprovalCountdownOptions, type UseChatTranscriptOptions, type UseComposerAutocompleteOptions, type UseElapsedOptions, type UseSpeechRecognitionOptions, type UseToolCatalogOptions, type UseTranscriptItemOptions, applyCompletion, approvalCountdown, backgroundRunsFromThread, buildTranscriptBlocks, coerceAnswer, correctedCallIds, createSkillsSource, describeTimestamp, describeToolCall, describeUsage, extractMessageText, fillTemplate, filterAutocompleteItems, findActiveTrigger, formatElapsed, formatRelativeTime, groupToolActivity, inferResultView, isActionCall, loadStoredSpeechLang, persistSpeechLang, phraseFor, readPath, readReasoningMs, resolveResultView, storedMessageToUiMessage, storedThreadToUiMessages, toolCallState, toolCatalogFrom, useAgentChat, useApprovalCountdown, useChatTranscript, useComposerAutocomplete, useElapsed, useSpeechRecognition, useStickToBottom, useToolCatalog, useTranscriptItem };

package/dist/index.js

@@ -978,8 +978,66 @@ import React3 from "react";
 import { useCallback as useCallback3, useEffect as useEffect5, useRef as useRef4, useState as useState5 } from "react";
 
 // src/transcript/model.ts
+import { readElicitationInput, validateElicitationAnswer as validateElicitationAnswer2 } from "@dudousxd/nestjs-agent-core";
 import { getToolName as getToolName2, isDataUIPart, isFileUIPart, isReasoningUIPart, isTextUIPart, isToolUIPart } from "ai";
 
+// src/elicitation/answers.ts
+import { validateElicitationAnswer, validateElicitationValue } from "@dudousxd/nestjs-agent-core";
+function pad(value) {
+  return String(value).padStart(2, "0");
+}
+__name(pad, "pad");
+function toDay(date) {
+  if (Number.isNaN(date.getTime())) {
+    return null;
+  }
+  return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`;
+}
+__name(toDay, "toDay");
+function coerceOne(type, raw) {
+  if (raw === null || raw === void 0) {
+    return null;
+  }
+  if (Array.isArray(raw)) {
+    return null;
+  }
+  if (raw instanceof Date) {
+    return type === "date" || type === void 0 ? toDay(raw) : raw.toISOString();
+  }
+  if (typeof raw === "boolean") {
+    return raw ? "true" : "false";
+  }
+  if (typeof raw === "number") {
+    return Number.isFinite(raw) ? String(raw) : null;
+  }
+  const text = raw;
+  switch (type) {
+    case "number":
+    case "email":
+    case "url":
+    case "date":
+      return text.trim() === "" ? null : text.trim();
+    case "boolean": {
+      const lowered = text.trim().toLowerCase();
+      if (lowered === "true" || lowered === "on" || lowered === "yes") return "true";
+      if (lowered === "false" || lowered === "off" || lowered === "no") return "false";
+      return lowered === "" ? null : text;
+    }
+    default:
+      return text === "" ? null : text;
+  }
+}
+__name(coerceOne, "coerceOne");
+function coerceAnswer(question, raw) {
+  const type = question.input?.type;
+  const items = Array.isArray(raw) ? raw : [
+    raw
+  ];
+  const values = items.map((item) => coerceOne(type, item)).filter((value) => value !== null);
+  return question.multiple === true ? values : values.slice(0, 1);
+}
+__name(coerceAnswer, "coerceAnswer");
+
 // src/presentation/tool-activity.ts
 import { getToolName } from "ai";
 
@@ -1516,11 +1574,16 @@ function readElicitationRequest(part) {
   }
   const questions = [];
   for (const candidate of input.questions) {
-    if (!isRecord2(candidate) || typeof candidate.id !== "string" || typeof candidate.prompt !== "string" || !Array.isArray(candidate.options) || candidate.options.length === 0) {
+    if (!isRecord2(candidate) || typeof candidate.id !== "string" || typeof candidate.prompt !== "string") {
+      return null;
+    }
+    const input2 = readElicitationInput(candidate.input) ?? null;
+    const rawOptions = Array.isArray(candidate.options) ? candidate.options : [];
+    if (rawOptions.length === 0 && (input2 === null || input2.type === "select")) {
       return null;
     }
     const options = [];
-    for (const option of candidate.options) {
+    for (const option of rawOptions) {
       if (!isRecord2(option) || typeof option.value !== "string" || typeof option.label !== "string") {
         return null;
       }
@@ -1533,7 +1596,10 @@ function readElicitationRequest(part) {
     questions.push({
       id: candidate.id,
       prompt: candidate.prompt,
+      description: typeof candidate.description === "string" ? candidate.description : null,
+      input: input2,
       multiple: candidate.multiple === true,
+      allowFreeText: candidate.allowFreeText === true,
       defaults: Array.isArray(candidate.defaults) ? candidate.defaults.filter((value) => typeof value === "string") : [],
       options
     });
@@ -1569,12 +1635,38 @@ function buildElicitationBlock(key, part, request, options) {
     const picked = isPending ? options.picked(toolCallId, question.id) : void 0;
     const selected = picked ?? outcome?.answers[question.id] ?? question.defaults;
     const pick = /* @__PURE__ */ __name((values) => options.pick(toolCallId, question.id, values), "pick");
+    const error = isPending ? validateElicitationAnswer2({
+      id: question.id,
+      prompt: question.prompt,
+      options: question.options.map(({ value, label }) => ({
+        value,
+        label
+      })),
+      ...question.input !== null ? {
+        input: question.input
+      } : {},
+      ...question.multiple ? {
+        multiple: true
+      } : {},
+      ...question.allowFreeText ? {
+        allowFreeText: true
+      } : {}
+    }, selected) : null;
     return {
       id: question.id,
       prompt: question.prompt,
+      description: question.description,
+      input: question.input,
       multiple: question.multiple,
       position: index + 1,
       selected,
+      value: selected[0] ?? "",
+      error,
+      setValue: /* @__PURE__ */ __name((raw) => {
+        if (isPending) {
+          pick(coerceAnswer(question, raw));
+        }
+      }, "setValue"),
       isPristine: isPending ? picked === void 0 : outcome?.defaulted.includes(question.id) ?? true,
       options: question.options.map((option) => ({
         value: option.value,
@@ -1609,6 +1701,7 @@ function buildElicitationBlock(key, part, request, options) {
     questions,
     questionCount: questions.length,
     isPending,
+    isValid: questions.every((question) => question.error === null),
     outcome,
     error: options.errorOf(toolCallId),
     answer: {
@@ -3677,6 +3770,7 @@ export {
   approvalCountdown,
   backgroundRunsFromThread,
   buildTranscriptBlocks,
+  coerceAnswer,
   correctedCallIds,
   createSkillsSource,
   describeTimestamp,
@@ -3709,6 +3803,8 @@ export {
   useSpeechRecognition,
   useStickToBottom,
   useToolCatalog,
-  useTranscriptItem
+  useTranscriptItem,
+  validateElicitationAnswer as validateAnswer,
+  validateElicitationValue as validateAnswerValue
 };
 //# sourceMappingURL=index.js.map