@avallon-labs/sdk 47.5.0-staging.1084 → 48.0.0-staging.1085

package/dist/index.d.ts

@@ -2191,6 +2191,12 @@ type CreateInformationRequestBodyMetadata = {
  */
 
 type CreateInformationRequestBody = {
+    /**
+     * A short label for the question, so somebody scanning a queue of open requests can tell yours apart. Name what it is about, not what you need — no trailing punctuation.
+     * @minLength 1
+     * @maxLength 120
+     */
+    title: string;
     /**
      * The single fact you need, as one question. Write it for a person who is not watching this run: say what you were doing, what you could not determine, and what would let you continue.
      * @minLength 1
@@ -2232,6 +2238,8 @@ type InformationRequestMetadata = {
 
 interface InformationRequest {
     id: string;
+    /** Short label the asker gave the question */
+    title: string;
     /** What the asker needs to know */
     question: string;
     /** Null while the request is open */
@@ -12200,7 +12208,7 @@ type SecondParameter$c<T extends (...args: never) => unknown> = Parameters<T>[1]
 /**
  * Ask a person for a specific fact you cannot establish yourself.
 
-Use this when one missing piece of information is blocking you and only a human can supply it — which claim a document belongs to, which of two policies applies, what an ambiguous reference means. Ask one answerable question per request, and write it so it stands on its own: whoever resolves it sees your question and nothing else.
+Use this when one missing piece of information is blocking you and only a human can supply it — which claim a document belongs to, which of two policies applies, what an ambiguous reference means. Ask one answerable question per request, and write it so it stands on its own: whoever resolves it sees your title and your question and nothing else.
 
 Immediately link the request to its case with `addCaseLinks` and `entity_type: "information_request"`. That is how it reaches the person working that case; unlinked, it sits in a queue nobody is looking at. Leave it unlinked only when you genuinely cannot tell which case it belongs to.