docs(agent): meta.agent Anleitungen plus Design-Guide für freie Blöcke

Ohne Repo verständlich: Routen, Lookup-Pfade, Upload-Format src/path, translationKey-Falle, SSR-Cache, Tailwind/Svelte-Regeln.
2026-10-05 18:30:22 +00:00
parent 9819e38b08
commit 7ef080ba88
6 changed files with 47 additions and 0 deletions
@@ -40,6 +40,14 @@ meta:
      muiIcon: file_document
      filter:
        file.type_like: ^(?!image/|video/|audio/).+
+  agent:
+    purpose: "Reusable uploads referenced via foreignMedia (blocks.heroImage.image, blocks.image)."
+    instructions: "Upload file as object {src:'data:<mime>;base64,...', path:'name.jpg'} (path optional). Stored as {src:'<field>/name.jpg', path, type}. Never {filename,data}, never file as plain string. Public read URL: /api/medialib/<entryId>/<src> plus ?filter=l-webp for raster images. downscale max 2048px applies on upload."
+    fieldHints:
+      file: "required, widget file, max 50MB"
+      alt: "object {de,en}, used by MedialibImage for accessibility"
+    examples: [{ title: "Demo Hero 1200", file: { src: "data:image/jpeg;base64,...", path: "demo-hero-1200.jpg" } }]
+    hints: ["list with select excluding file.data to avoid context bloat", "verify file.src starts with <field>/ after create"]

 permissions:
  public: