athena-python-docx 0.1.1__tar.gz → 0.1.3__tar.gz

{athena_python_docx-0.1.1 → athena_python_docx-0.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: athena-python-docx
-Version: 0.1.1
+Version: 0.1.3
 Summary: Drop-in replacement for python-docx that connects to Athena's Superdoc/Keryx collaborative document stack
 Project-URL: Homepage, https://athenaintelligence.ai
 Author-email: Athena Intelligence <engineering@athenaintelligence.ai>

{athena_python_docx-0.1.1 → athena_python_docx-0.1.3}/docx/__init__.py

@@ -6,7 +6,7 @@ See CLAUDE.md for the API parity contract.
 
 from __future__ import annotations
 
-__version__ = "0.1.1"
+__version__ = "0.1.3"
 
 from docx.api import Document
 

{athena_python_docx-0.1.1 → athena_python_docx-0.1.3}/docx/client.py

@@ -172,20 +172,28 @@ class Session:
             )
         return self._doc_handle
 
-    async def save(self, *, in_place: bool = True) -> None:
-        """Flush pending mutations to Keryx and persist.
-
-        The AsyncSuperDocClient writes over WebSocket; we add a short
-        flush delay (matches superdoc_write_utils.py:227-237) to
-        ensure updates land before dispose().
+    async def save(self, *, in_place: bool = True) -> None:  # noqa: ARG002
+        """Ensure pending mutations have flushed to Keryx.
+
+        In collab mode (our only mode), the Y-Websocket provider streams
+        updates to Keryx as they happen — there's no explicit save RPC
+        to call. The underlying Superdoc SDK's ``save({"inPlace": True})``
+        targets file-backed docs and errors with "this session has no
+        source path" for collab sessions. So save() is a thin flush:
+        sleep briefly so in-flight WebSocket frames land, then return.
+
+        The ``in_place`` kwarg is accepted for python-docx parity but
+        has no effect in collab mode (there is no alternate target).
         """
         if not self._opened:
             raise SessionError("Cannot save a session that was never opened.")
         if self._closed:
             raise DocumentClosedError(f"Session {self._asset_id} is closed.")
 
-        await self._doc_handle.save({"inPlace": in_place})
-        _log_info(f"Saved {self._asset_id}")
+        # Short flush — matches superdoc_write_utils.py's 1-second pre-close
+        # delay. Keeps a single in-flight frame from being dropped on close.
+        await asyncio.sleep(1)
+        _log_info(f"Saved (flushed) {self._asset_id}")
 
     async def close(self) -> None:
         """Close the Superdoc session. Idempotent."""

{athena_python_docx-0.1.1 → athena_python_docx-0.1.3}/docx/document.py

@@ -100,22 +100,49 @@ class Document:
         from docx.text.paragraph import Paragraph
 
         self._ensure_open()
-        md: str
-        if style and style.lower().startswith("heading"):
-            try:
-                level: int = int(style.rsplit(" ", 1)[-1])
-            except ValueError:
-                level = 1
-            md = f"{'#' * level} {text}\n\n"
+
+        # Superdoc's markdown parser rejects empty input with
+        # "Markdown produced no content to insert." For an empty paragraph
+        # (python-docx's `doc.add_paragraph()` with no args), we use the
+        # text-type insert with a single space and immediately clear it —
+        # same pattern as `agora/web/api/super_docs/superdoc_write_utils.py`
+        # around line 1085.
+        result: dict
+        node_id: str
+        if not text and not (style and style.lower().startswith("heading")):
+            result = run_sync(
+                self._session.doc.insert(
+                    {"value": " ", "type": "text"},
+                ),
+            )
+            node_id = _extract_inserted_node_id(result, expected_type="paragraph")
+            if node_id:
+                # Clear the placeholder space so the paragraph reads as empty
+                # (matches python-docx semantics: a freshly-added blank paragraph
+                # has empty `.text`).
+                run_sync(
+                    self._session.doc.blocks.update_text(
+                        {"nodeId": node_id, "text": ""},
+                    ),
+                )
         else:
-            md = f"{text}\n\n"
+            md: str
+            if style and style.lower().startswith("heading"):
+                try:
+                    level: int = int(style.rsplit(" ", 1)[-1])
+                except ValueError:
+                    level = 1
+                md = f"{'#' * level} {text}\n\n"
+            else:
+                md = f"{text}\n\n"
+
+            result = run_sync(
+                self._session.doc.insert(
+                    {"value": md, "type": "markdown"},
+                ),
+            )
+            node_id = _extract_inserted_node_id(result, expected_type="paragraph")
 
-        result: dict = run_sync(
-            self._session.doc.insert(
-                {"value": md, "type": "markdown"},
-            ),
-        )
-        node_id: str = _extract_inserted_node_id(result, expected_type="paragraph")
         if not node_id:
             raise RuntimeError(
                 f"Superdoc did not return a nodeId for add_paragraph: {result!r}",

{athena_python_docx-0.1.1 → athena_python_docx-0.1.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "athena-python-docx"
-version = "0.1.1"
+version = "0.1.3"
 description = "Drop-in replacement for python-docx that connects to Athena's Superdoc/Keryx collaborative document stack"
 readme = "README.md"
 license = "MIT"