@popmelt.com/core 0.18.1 → 0.18.2

package/README.md

@@ -158,6 +158,40 @@ export function Providers({ children }: { children: React.ReactNode }) {
 
 `navigate` is optional for single-page use. Pass your router's navigation function when Popmelt needs to restore annotations across routes.
 
+### Add application context to comments
+
+Use `getCommentMeta` to snapshot application-owned context whenever a human
+submits annotations or replies in a thread. Popmelt validates and detaches the
+JSON, includes it as contextual evidence for the model, and persists the same
+snapshot with the stored human turn.
+
+```tsx
+<PopmeltProvider
+  getCommentMeta={({ kind }) => ({
+    'my-app/video-ui/v1': {
+      kind,
+      generation: {
+        prompt: generation.prompt,
+        dataVersion: store.getState().version,
+      },
+      frame: {
+        assetId: video.id,
+        timeMs: Math.round(video.currentTime * 1000),
+      },
+      interactions: recorder.snapshot(),
+    },
+  })}
+>
+  {children}
+</PopmeltProvider>
+```
+
+The hook may be synchronous or asynchronous. Return a plain JSON object; use a
+namespaced, versioned key so multiple integrations can coexist. Comment
+metadata is limited to 64 KiB per human turn. Keep large binaries and long
+event logs in external storage or attachments and place their stable IDs,
+hashes, and timestamps in `meta`.
+
 ### Next.js
 
 Next.js needs both the command wrapper and the config wrapper.

package/codex-plugin/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "popmelt-core",
-  "version": "0.18.1",
+  "version": "0.18.2",
   "description": "Ambient project memory and shared understanding for Codex",
   "author": {
     "name": "Popmelt",