Merge pull request #523 from MBombeck/feat/document-auto-summary

feat(documents): persist an auto summary for uploaded documents

docs/api/openapi.yaml

@@ -29085,6 +29085,14 @@ components:
           type: array
           items:
             $ref: "#/components/schemas/ExtractedFact"
+        summary:
+          anyOf:
+            - type: string
+            - type: "null"
+        summaryGeneratedAt:
+          anyOf:
+            - type: string
+            - type: "null"
       required:
         - id
         - kind
@@ -29107,7 +29115,14 @@ components:
         - createdAt
         - updatedAt
         - facts
+        - summary
+        - summaryGeneratedAt
       additionalProperties: false
+      description: A stored document plus its staged facts. `summary` is a short (3-4 sentence) plain-language description of
+        WHAT the document is, generated once in the background right after upload when the `documentsAutoAiRead` opt-in
+        is ON (that flag is also the standing AI-egress consent); it is descriptive only, never a diagnosis, and is null
+        when auto-read is OFF, no provider is configured, or the background summary has not run yet.
+        `summaryGeneratedAt` is when it was generated (null until then).
     ExtractedFact:
       type: object
       properties: