@vess-id/ai-identity 0.16.0-alpha.11 → 0.16.0-alpha.12

package/dist/index.d.mts

@@ -1297,6 +1297,24 @@ interface PermissionVcClaims_V3 extends Omit<PermissionVcClaims_V2, 'v'> {
      * rather than against a label the issuer wrote about itself.
      */
     issuance_mode?: 'user_approved' | 'auto_issued' | 'unrecorded';
+    /**
+     * Why this credential was requested, in the requester's own words (#955).
+     *
+     * Free text, deliberately. Narrowing it to a vocabulary would turn a
+     * description into a decision input, and Phase 1 neither records nor
+     * evaluates it (DEV-INSTRUCTIONS §256) — no gate reads it, and none should
+     * without that being a decision someone makes on purpose.
+     *
+     * SD-protected at issuance. Natural language written by a person tends to
+     * name people, accounts and circumstances, so a verifier gets it only when
+     * the holder chooses to disclose it. Keep it out of audit logs and error
+     * messages for the same reason.
+     *
+     * Optional, and permanently so: the type describes credentials already
+     * signed and in circulation, which cannot be re-issued to carry a new
+     * field.
+     */
+    intent_description?: string;
 }
 /**
  * Permission VC Claims (canonical union of v2 + v3).