diff --git a/.speakeasy/in.openapi.yaml b/.speakeasy/in.openapi.yaml
index 227e26f4..9b376d41 100644
--- a/.speakeasy/in.openapi.yaml
+++ b/.speakeasy/in.openapi.yaml
@@ -10960,6 +10960,7 @@ components:
         - 'box'
       type: 'object'
     DecisionsBoxQuestion:
+      description: 'Finds one target in an image in `state` and answers with one bounding box (`top`, `bottom`, `left`, `right` as fractions of the image). Served by TypeSafe Jev endpoints only; every other provider rejects a box question with `400` before anything is sent upstream.'
       properties:
         instructions:
           anyOf:
@@ -10968,7 +10969,7 @@ components:
               type: 'object'
             - items: {}
               type: 'array'
-          description: 'A plain string, or a JSON object or array of structured guidance.'
+          description: 'A description of the target to find, naming the image in `state` it is in; not a command, and no `criteria`.'
         type:
           enum:
             - 'box'
@@ -11107,7 +11108,7 @@ components:
         assets:
           additionalProperties:
             $ref: '#/components/schemas/DecisionsImageAsset'
-          description: 'Images keyed by reference string, as in TypeSafe''s API. Write a reference wherever the image belongs in `state`, `instructions`, or `criteria`; every asset must be referenced at least once. Jev reads a reference as a whole string value or inside longer text. Other Decisions models read a whole-string reference wherever they read an `image_url` part and reject a reference inside longer text.'
+          description: 'Images keyed by reference string, as in TypeSafe''s API. Write a reference wherever the image belongs in `state`, `instructions`, or `criteria`; every asset must be referenced at least once, or the request fails with `400` naming the unused key. TypeSafe Jev endpoints receive `assets` as written and read a reference as a whole string value or inside longer text. Every other provider has each whole-string reference resolved to an `image_url` part before the request is sent, so it is accepted only where that provider reads `image_url` parts (top-level `state` items), and a reference inside longer text fails with `400`. `image_url` parts and `assets` can be mixed in one request.'
           type: 'object'
         model:
           type: 'string'
@@ -36452,7 +36453,7 @@ paths:
         - 'Analytics'
   /api/alpha/decisions:
     post:
-      description: 'Submits a Decisions request to the Decisions router'
+      description: 'Asks a Decisions model typed questions (`noul`, `choice`, `score`, `box`) about the content in `state` and returns one typed answer per question with its probabilities. Images, audio and video go in `state` as `image_url`, `input_audio` and `video_url` parts; PNG and JPEG images can instead go once in `assets` and be referenced by key. Which question types, media parts and asset references an endpoint accepts depends on the provider; a request an endpoint cannot serve fails with `400` before anything is sent upstream. See the [Multimodal Decisions guide](/docs/guides/community/multimodal-decisions) for the per-provider table. Alpha: the shape may change.'
       operationId: 'createApiAlphaDecisions'
       requestBody:
         content: