edda-framework 0.9.1__py3-none-any.whl → 0.11.0__py3-none-any.whl

edda/viewer_ui/app.py

@@ -1296,6 +1296,8 @@ def start_viewer(edda_app: EddaApp, port: int = 8080, reload: bool = False) -> N
             "search_query": "",
             "started_after": None,
             "started_before": None,
+            "input_filter_key": "",
+            "input_filter_value": "",
             "instances": [],
             "next_page_token": None,
             "has_more": False,
@@ -1352,6 +1354,17 @@ def start_viewer(edda_app: EddaApp, port: int = 8080, reload: bool = False) -> N
                         "click", lambda m=date_to_menu: m.open()
                     )
 
+            # Input data filter fields
+            input_key = ui.input(
+                label="Input Key",
+                placeholder="e.g., input.order_id",
+            ).classes("w-40")
+
+            input_value = ui.input(
+                label="Input Value",
+                placeholder="e.g., ORD-123",
+            ).classes("w-36")
+
             # Refresh button
             async def handle_refresh() -> None:
                 """Handle refresh button click."""
@@ -1360,6 +1373,11 @@ def start_viewer(edda_app: EddaApp, port: int = 8080, reload: bool = False) -> N
                 pagination_state["page_size"] = page_size_select.value
                 pagination_state["started_after"] = date_from.value
                 pagination_state["started_before"] = date_to.value
+                pagination_state["input_filter_key"] = input_key.value
+                pagination_state["input_filter_value"] = input_value.value
+                # Debug output
+                print(f"DEBUG: input_key.value = '{input_key.value}'")
+                print(f"DEBUG: input_value.value = '{input_value.value}'")
                 # Reset to first page
                 pagination_state["current_token"] = None
                 pagination_state["token_stack"] = []
@@ -1389,6 +1407,13 @@ def start_viewer(edda_app: EddaApp, port: int = 8080, reload: bool = False) -> N
                         pagination_state["started_before"] + "T23:59:59"
                     )
 
+            # Build input_filters if key is provided
+            input_filters = None
+            if pagination_state["input_filter_key"]:
+                input_filters = {
+                    pagination_state["input_filter_key"]: pagination_state["input_filter_value"]
+                }
+
             result = await service.get_instances_paginated(
                 page_size=pagination_state["page_size"],
                 page_token=pagination_state["current_token"],
@@ -1396,6 +1421,7 @@ def start_viewer(edda_app: EddaApp, port: int = 8080, reload: bool = False) -> N
                 search_query=pagination_state["search_query"] or None,
                 started_after=started_after,
                 started_before=started_before,
+                input_filters=input_filters,
             )
             pagination_state["instances"] = result["instances"]
             pagination_state["next_page_token"] = result["next_page_token"]

edda/viewer_ui/data_service.py

@@ -48,6 +48,7 @@ class WorkflowDataService:
         search_query: str | None = None,
         started_after: datetime | None = None,
         started_before: datetime | None = None,
+        input_filters: dict[str, Any] | None = None,
     ) -> dict[str, Any]:
         """
         Get workflow instances with cursor-based pagination and filtering.
@@ -59,6 +60,8 @@ class WorkflowDataService:
             search_query: Search by workflow name or instance ID (partial match)
             started_after: Filter instances started after this datetime
             started_before: Filter instances started before this datetime
+            input_filters: Filter by input data values. Keys are JSON paths
+                (e.g., "order_id"), values are expected values (exact match).
 
         Returns:
             Dictionary containing:
@@ -75,6 +78,7 @@ class WorkflowDataService:
             instance_id_filter=search_query,
             started_after=started_after,
             started_before=started_before,
+            input_filters=input_filters,
         )
         return result
 

{edda_framework-0.9.1.dist-info → edda_framework-0.11.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: edda-framework
-Version: 0.9.1
+Version: 0.11.0
 Summary: Lightweight Durable Execution Framework
 Project-URL: Homepage, https://github.com/i2y/edda
 Project-URL: Documentation, https://github.com/i2y/edda#readme
@@ -28,6 +28,8 @@ Requires-Dist: httpx>=0.28.1
 Requires-Dist: pydantic>=2.0.0
 Requires-Dist: sqlalchemy[asyncio]>=2.0.0
 Requires-Dist: uvloop>=0.22.1
+Provides-Extra: cpu-monitor
+Requires-Dist: psutil>=5.9.0; extra == 'cpu-monitor'
 Provides-Extra: dev
 Requires-Dist: black>=25.9.0; extra == 'dev'
 Requires-Dist: mcp>=1.22.0; extra == 'dev'
@@ -42,12 +44,17 @@ Requires-Dist: testcontainers[postgres]>=4.0.0; extra == 'dev'
 Requires-Dist: tsuno>=0.1.3; extra == 'dev'
 Provides-Extra: mcp
 Requires-Dist: mcp>=1.22.0; extra == 'mcp'
+Provides-Extra: mirascope
+Requires-Dist: mirascope[anthropic,google,openai]>=2.0.0a0; extra == 'mirascope'
+Requires-Dist: pydantic-settings>=2.0.0; extra == 'mirascope'
 Provides-Extra: mysql
 Requires-Dist: aiomysql>=0.2.0; extra == 'mysql'
 Provides-Extra: opentelemetry
 Requires-Dist: opentelemetry-api>=1.20.0; extra == 'opentelemetry'
 Requires-Dist: opentelemetry-exporter-otlp>=1.20.0; extra == 'opentelemetry'
 Requires-Dist: opentelemetry-sdk>=1.20.0; extra == 'opentelemetry'
+Provides-Extra: postgres-notify
+Requires-Dist: asyncpg>=0.30.0; extra == 'postgres-notify'
 Provides-Extra: postgresql
 Requires-Dist: asyncpg>=0.30.0; extra == 'postgresql'
 Provides-Extra: server
@@ -87,7 +94,9 @@ For detailed documentation, visit [https://i2y.github.io/edda/](https://i2y.gith
 - ☁️ **CloudEvents Support**: Native support for CloudEvents protocol
 - ⏱️ **Event & Timer Waiting**: Free up worker resources while waiting for events or timers, resume on any available worker
 - 📬 **Channel-based Messaging**: Actor-model style communication with competing (job queue) and broadcast (fan-out) modes
+- ⚡ **Instant Notifications**: PostgreSQL LISTEN/NOTIFY for near-instant event delivery (optional)
 - 🤖 **MCP Integration**: Expose durable workflows as AI tools via Model Context Protocol
+- 🧠 **Mirascope Integration**: Durable LLM calls
 - 🌍 **ASGI/WSGI Support**: Deploy with your preferred server (uvicorn, gunicorn, uWSGI)
 
 ## Use Cases
@@ -221,6 +230,9 @@ uv add edda-framework --extra mysql
 # With Viewer UI
 uv add edda-framework --extra viewer
 
+# With PostgreSQL instant notifications (LISTEN/NOTIFY)
+uv add edda-framework --extra postgres-notify
+
 # All extras (PostgreSQL, MySQL, Viewer UI)
 uv add edda-framework --extra postgresql --extra mysql --extra viewer
 ```
@@ -272,6 +284,8 @@ pip install "git+https://github.com/i2y/edda.git[postgresql,viewer]"
 
 **Important**: For multi-process or multi-pod deployments (K8s, Docker Compose with multiple replicas, etc.), you **must** use PostgreSQL or MySQL. SQLite supports multiple async workers within a single process, but its table-level locking makes it unsuitable for multi-process/multi-pod scenarios.
 
+> **Tip**: For PostgreSQL, install the `postgres-notify` extra for near-instant event delivery using LISTEN/NOTIFY instead of polling.
+
 ### Development Installation
 
 If you want to contribute to Edda or modify the framework itself:
@@ -492,6 +506,8 @@ app = EddaApp(
     # Connection pool settings (optional)
     pool_size=5,        # Concurrent connections
     max_overflow=10,    # Additional burst capacity
+    # Batch processing (optional)
+    max_workflows_per_batch=10,  # Or "auto" / "auto:cpu" for dynamic scaling
 )
 ```
 

{edda_framework-0.9.1.dist-info → edda_framework-0.11.0.dist-info}/RECORD

@@ -1,6 +1,6 @@
 edda/__init__.py,sha256=hGC6WR2R36M8LWC97F-0Rw4Ln0QUUT_1xC-7acOy_Fk,2237
 edda/activity.py,sha256=nRm9eBrr0lFe4ZRQ2whyZ6mo5xd171ITIVhqytUhOpw,21025
-edda/app.py,sha256=11-IczlJpCR_G-jWUvV1DIr_Zwm6bDJnFiNBQsZ79Zo,44306
+edda/app.py,sha256=hoxDKp6q5qHl_dNLMkLxKhuibUC6D8FtuiWsIZkzwhA,61546
 edda/channels.py,sha256=Budi0FyxalmcAMwj50mX3WzRce5OuLKXGws0Hp_snfw,34745
 edda/compensation.py,sha256=iKLlnTxiF1YSatmYQW84EkPB1yMKUEZBtgjuGnghLtY,11824
 edda/context.py,sha256=pPn98-G5HgaOGDRzEhma58TzBulwsiTvmNEMLIu0XwI,21330
@@ -16,28 +16,35 @@ edda/integrations/__init__.py,sha256=F_CaTvlDEbldfOpPKq_U9ve1E573tS6XzqXnOtyHcXI
 edda/integrations/mcp/__init__.py,sha256=YK-8m0DIdP-RSqewlIX7xnWU7TD3NioCiW2_aZSgnn8,1232
 edda/integrations/mcp/decorators.py,sha256=31SmbDwmHEGvUNa3aaatW91hBkpnS5iN9uy47dID3J4,10037
 edda/integrations/mcp/server.py,sha256=Q5r4AbMn-9gBcy2CZocbgW7O0fn7Qb4e9CBJa1FEmzU,14507
+edda/integrations/mirascope/__init__.py,sha256=TKKIs1W2ef88qT1oNoNm0-DQZObOc7tiuw3ul38nc6U,2509
+edda/integrations/mirascope/agent.py,sha256=9y2HmyEDs5zREJgRuXI9EINjj09rWy991Khs7eDXfyY,16235
+edda/integrations/mirascope/call.py,sha256=2pSDrja8Zix6d3TM4VejLmp1DHxbUnSAdSBSg7CFC7k,5754
+edda/integrations/mirascope/decorator.py,sha256=TIK9qoR5ydaz-r33HAMuLrY4rsKJ5tsPlJJp5T_06B8,5488
+edda/integrations/mirascope/types.py,sha256=vgEAu8EFTLSd92XSAxtZpMoe5gv93fe4Rm0DaXaDlV8,9088
 edda/integrations/opentelemetry/__init__.py,sha256=x1_PyyygGDW-rxQTwoIrGzyjKErXHOOKdquFAMlCOAo,906
 edda/integrations/opentelemetry/hooks.py,sha256=rCb6K_gJJMxjQ-UoJnbIOWsafapipzu7w-YPROZKxDA,21330
 edda/outbox/__init__.py,sha256=azXG1rtheJEjOyoWmMsBeR2jp8Bz02R3wDEd5tQnaWA,424
-edda/outbox/relayer.py,sha256=2tnN1aOQ8pKWfwEGIlYwYLLwyOKXBjZ4XZsIr1HjgK4,9454
+edda/outbox/relayer.py,sha256=_yOZVpjj862lzMtEK47RMdVdbxXmL8v-FXppZWdy4Ag,10444
 edda/outbox/transactional.py,sha256=LFfUjunqRlGibaINi-efGXFFivWGO7v3mhqrqyGW6Nw,3808
 edda/serialization/__init__.py,sha256=hnOVJN-mJNIsSa_XH9jwhIydOsWvIfCaFaSd37HUplg,216
 edda/serialization/base.py,sha256=xJy2CY9gdJDCF0tmCor8NomL2Lr_w7cveVvxccuc-tA,1998
 edda/serialization/json.py,sha256=Dq96V4n1yozexjCPd_CL6Iuvh1u3jJhef6sTcNxXZeA,2842
-edda/storage/__init__.py,sha256=Q-kNJsjF8hMc2Q5MYFlLBENKExlNlKkbmUkwBOosj9I,216
+edda/storage/__init__.py,sha256=NjvAzYV3SknACrC16ZQOA-xCKOj1-s3rBIWOS1ZGCaM,407
 edda/storage/models.py,sha256=vUwjiAOvp9uFNQgLK57kEGo7uzXplDZikOfnlOyed2M,12146
-edda/storage/protocol.py,sha256=NTUuLZ5_OlBiASaJIRuz5x7NykpCOjQgDWWNrRQzong,39021
-edda/storage/sqlalchemy_storage.py,sha256=KvSGapeKJ3hhClXNxFKHByD3Key5aidxBMUjs6-EJvE,136811
+edda/storage/notify_base.py,sha256=gUb-ypG1Bo0c-KrleYmC7eKtdwQNUeqGS5k7UILlSsQ,5055
+edda/storage/pg_notify.py,sha256=to5rDIQbiqqkNNVMODye_KvY4EDqRSUQblTeoeDZv8w,11850
+edda/storage/protocol.py,sha256=vdB5GvBen8lgUA0qEfBXfQTLbVfGKeBTQuEwSUqLZtI,39463
+edda/storage/sqlalchemy_storage.py,sha256=IAc8SYHM2xoJEIVDG05_mkguWQGB3wIAALsc0QI8EcE,144484
 edda/viewer_ui/__init__.py,sha256=N1-T33SXadOXcBsDSgJJ9Iqz4y4verJngWryQu70c5c,517
-edda/viewer_ui/app.py,sha256=CqHKsUj5pcysHCk0aRfkEqV4DIV4l3GzOPKBJ5DTYOQ,95624
+edda/viewer_ui/app.py,sha256=K3c5sMeJz_AE9gh5QftxwvfDthLeJi1i2CDkP9gb4Ig,96695
 edda/viewer_ui/components.py,sha256=A0IxLwgj_Lu51O57OfzOwME8jzoJtKegEVvSnWc7uPo,45174
-edda/viewer_ui/data_service.py,sha256=yzmPz67rBoECY7eNK5nl6YS3jIZAi-haaqrP0GIgJYE,36373
+edda/viewer_ui/data_service.py,sha256=KOqnWr-Y8seH_dkJH_ejHRfxQqn7aY8Ni5C54tx2Z-E,36621
 edda/viewer_ui/theme.py,sha256=mrXoXLRzgSnvE2a58LuMcPJkhlvHEDMWVa8Smqtk4l0,8118
 edda/visualizer/__init__.py,sha256=DOpDstNhR0VcXAs_eMKxaL30p_0u4PKZ4o2ndnYhiRo,343
 edda/visualizer/ast_analyzer.py,sha256=plmx7C9X_X35xLY80jxOL3ljg3afXxBePRZubqUIkxY,13663
 edda/visualizer/mermaid_generator.py,sha256=XWa2egoOTNDfJEjPcwoxwQmblUqXf7YInWFjFRI1QGo,12457
-edda_framework-0.9.1.dist-info/METADATA,sha256=8m1LKjz9cWbmwsa7V-FAEIQdgM3_63wan3Yml58KToE,35741
-edda_framework-0.9.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-edda_framework-0.9.1.dist-info/entry_points.txt,sha256=dPH47s6UoJgUZxHoeSMqZsQkLaSE-SGLi-gh88k2WrU,48
-edda_framework-0.9.1.dist-info/licenses/LICENSE,sha256=udxb-V7_cYKTHqW7lNm48rxJ-Zpf0WAY_PyGDK9BPCo,1069
-edda_framework-0.9.1.dist-info/RECORD,,
+edda_framework-0.11.0.dist-info/METADATA,sha256=AkgFtGUJNfhOoHXzti_R7fLli1q45Bg5xO6TfpjvsO8,36587
+edda_framework-0.11.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+edda_framework-0.11.0.dist-info/entry_points.txt,sha256=dPH47s6UoJgUZxHoeSMqZsQkLaSE-SGLi-gh88k2WrU,48
+edda_framework-0.11.0.dist-info/licenses/LICENSE,sha256=udxb-V7_cYKTHqW7lNm48rxJ-Zpf0WAY_PyGDK9BPCo,1069
+edda_framework-0.11.0.dist-info/RECORD,,