chore(api): clarify Decisions question and answer descriptions

.castiron.stats.yml

@@ -1,8 +1,8 @@
 schema_version: 1
-generation_id: f730304b-2989-487b-be37-1492829b1366
-openapi_spec_hash: 3bb041ecc9cbf422796004cf5b50e68e
-openapi_transformed_spec_hash: 28f26a7e6601942edae980868e76e81d
+generation_id: 7843acb1-8aa3-496f-94e5-534cf4dad401
+openapi_spec_hash: 8d140aa0dc64006644485ae8bd392ef7
+openapi_transformed_spec_hash: ff03494596180c39501a59a825cfd47d
 config_hash: 687b8a0f9aff551a4cbf86b2ac82c288
-codegen_sha: 85c4d407440b410322cc3f1b4d2c343b64076b6f
-codegen_hash: 7f780401816a4fd54fc6208c7394fa6beae10a8fa1bef1324f60c4df1398a9be
-public_codegen_sha: 599a60338201a2b343e013cc31b6006f82625626
+codegen_sha: e94296866fda8d502c197ef1efa4e9c5f9c75ae1
+codegen_hash: e0a95dbd83e20df47edc0c0e07a3dc6210bc663b83ed7cf38c42db74bf217eb9
+public_codegen_sha: fcbf15119800f60318af8cc58e2e4c48638992cd

api_reference/openapi.transformed.yml

@@ -80893,7 +80893,7 @@ components:
       additionalProperties: false
       description: A user message containing text or inline images.
     DecisionInput:
-      description: Shared evidence, as a string or an array of user messages containing text and inline images. Non-user roles, function calls, function-call outputs, files, audio, and item references are not supported. At most 128 image parts are allowed across all messages in one request.
+      description: The text or images to evaluate for every question. Provide a text string or user messages containing text and inline images. Images must be inline data URLs; at most 128 images are allowed across all messages in one request. External URLs, files, audio, tools, and item references are not supported.
       anyOf:
       - type: string
         minLength: 0
@@ -80933,6 +80933,7 @@ components:
       - type
       - instructions
       additionalProperties: false
+      description: Estimate how likely it is that a statement about the input is true.
     ChoiceValueParam:
       description: 'Choice values are typed: a string and a boolean with the same text are distinct.'
       anyOf:
@@ -80981,6 +80982,7 @@ components:
       - instructions
       - choices
       additionalProperties: false
+      description: Choose from the supplied options based on the input.
     ScoreLevelParam:
       type: object
       properties:
@@ -81024,6 +81026,7 @@ components:
       - instructions
       - levels
       additionalProperties: false
+      description: Rate the input against the supplied ordered levels.
     QuestionParam:
       description: A question about the request's input, with an optional correlation name.
       discriminator:
@@ -81205,7 +81208,7 @@ components:
       - type
       - name
       additionalProperties: false
-      description: The host may decline one question without disclosing its refusal score.
+      description: The model declined to answer this question. Other questions in the same request can still receive answers.
     AnswerResource:
       description: A completed question always includes its name, including null when unnamed.
       discriminator:

src/resources/decisions.ts

@@ -117,7 +117,8 @@ export namespace Decision {
   }
 
   /**
-   * The host may decline one question without disclosing its refusal score.
+   * The model declined to answer this question. Other questions in the same request
+   * can still receive answers.
    */
   export interface AnswerResourceRefusal {
     name: string | null;
@@ -198,10 +199,10 @@ export interface DecisionInputText {
 
 export interface DecisionCreateParams {
   /**
-   * Shared evidence, as a string or an array of user messages containing text and
-   * inline images. Non-user roles, function calls, function-call outputs, files,
-   * audio, and item references are not supported. At most 128 image parts are
-   * allowed across all messages in one request.
+   * The text or images to evaluate for every question. Provide a text string or user
+   * messages containing text and inline images. Images must be inline data URLs; at
+   * most 128 images are allowed across all messages in one request. External URLs,
+   * files, audio, tools, and item references are not supported.
    */
   input: string | Array<DecisionInputMessage>;
 
@@ -221,6 +222,9 @@ export interface DecisionCreateParams {
 }
 
 export namespace DecisionCreateParams {
+  /**
+   * Estimate how likely it is that a statement about the input is true.
+   */
   export interface QuestionParamPredicate {
     instructions: string;
 
@@ -232,6 +236,9 @@ export namespace DecisionCreateParams {
     name?: string;
   }
 
+  /**
+   * Choose from the supplied options based on the input.
+   */
   export interface QuestionParamChoice {
     choices: Array<QuestionParamChoice.Choice>;
 
@@ -256,6 +263,9 @@ export namespace DecisionCreateParams {
     }
   }
 
+  /**
+   * Rate the input against the supplied ordered levels.
+   */
   export interface QuestionParamScore {
     instructions: string;