athena-python-docx 0.15.4__tar.gz → 0.15.5__tar.gz

{athena_python_docx-0.15.4 → athena_python_docx-0.15.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: athena-python-docx
-Version: 0.15.4
+Version: 0.15.5
 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.15.4 → athena_python_docx-0.15.5}/docx/__init__.py

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

{athena_python_docx-0.15.4 → athena_python_docx-0.15.5}/docx/_timeouts.py

@@ -13,6 +13,13 @@ LONG_RUNNING_COMMAND_TIMEOUT_SECONDS: float = 300.0
 
 _LONG_RUNNING_COMMAND_TYPES: frozenset[str] = frozenset(
     {
+        # The first write to a large imported document can spend close to a
+        # minute opening/syncing the server-side SuperDoc session before the
+        # block creation itself is applied. These are ordinary agent primitives
+        # for "append a summary/TLDR", so give the first batch enough room.
+        "CreateHeading",
+        "CreateParagraph",
+        "CreateSectionBreak",
         "FindReplace",
         # Plain ``cell.text = value`` table fills are buffered as TableSetCell
         # commands. On dense legal documents, SuperDoc can spend well over the

{athena_python_docx-0.15.4 → athena_python_docx-0.15.5}/pyproject.toml

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

{athena_python_docx-0.15.4 → athena_python_docx-0.15.5}/tests/test_buffer.py

@@ -27,6 +27,7 @@ from docx._timeouts import DEFAULT_OP_TIMEOUT_SECONDS, LONG_RUNNING_COMMAND_TIME
 from docx.commands import (
     BlocksList,
     Command,
+    CreateHeading,
     CreateParagraph,
     FormatApply,
     Replace,
@@ -115,6 +116,23 @@ def test_pending_timeout_extends_for_table_set_cell_batches() -> None:
     buf.close()
 
 
+def test_pending_timeout_extends_for_block_creation_batches() -> None:
+    fake = _FakeClient()
+    buf = CommandBuffer(fake, "asset_1", auto_flush_seconds=0.0)
+
+    buf.call(
+        CreateHeading(
+            text="TLDR",
+            level=1,
+            at={"kind": "documentEnd"},
+            client_node_id="h_test",
+        )
+    )
+
+    assert buf.pending_timeout_seconds == LONG_RUNNING_COMMAND_TIMEOUT_SECONDS
+    buf.close()
+
+
 def test_session_pending_timeout_reads_command_buffer_budget() -> None:
     from docx.client import Session
 

{athena_python_docx-0.15.4 → athena_python_docx-0.15.5}/tests/test_http_transport.py

@@ -17,7 +17,7 @@ import requests
 from docx import __version__ as SDK_VERSION
 from docx._http_doc import HttpClient, HttpDocHandle
 from docx._timeouts import LONG_RUNNING_COMMAND_TIMEOUT_SECONDS
-from docx.commands import FindReplace, TableSetCell
+from docx.commands import CreateParagraph, FindReplace, TableSetCell
 from docx.errors import AuthenticationError, DocxError, SessionError
 
 
@@ -145,6 +145,47 @@ def test_table_set_cell_batch_uses_long_running_http_timeout() -> None:
     assert captured["timeout"] == LONG_RUNNING_COMMAND_TIMEOUT_SECONDS
 
 
+def test_block_creation_batch_uses_long_running_http_timeout() -> None:
+    captured: dict[str, Any] = {}
+
+    def _capture(url: str, **kwargs: Any) -> _FakeResponse:  # noqa: ARG001
+        captured["timeout"] = kwargs["timeout"]
+        return _FakeResponse(
+            status_code=200,
+            body=_ok_body(
+                [
+                    {
+                        "index": 0,
+                        "type": "CreateParagraph",
+                        "result": {
+                            "client_node_id": "p_test",
+                            "real_node_id": "paragraph_real",
+                        },
+                    }
+                ],
+            ),
+        )
+
+    client = HttpClient(base_url="https://example.com", api_key="bg_key")
+
+    with patch.object(client._session, "post", side_effect=_capture):
+        result = client.execute_batch(
+            "asset_test",
+            [
+                CreateParagraph(
+                    text="DLDR",
+                    at={"kind": "documentEnd"},
+                    client_node_id="p_test",
+                )
+            ],
+        )
+
+    assert result == [
+        {"client_node_id": "p_test", "real_node_id": "paragraph_real"}
+    ]
+    assert captured["timeout"] == LONG_RUNNING_COMMAND_TIMEOUT_SECONDS
+
+
 def test_release_asset_posts_to_session_release_endpoint() -> None:
     captured: dict[str, Any] = {}