Qubx 1.1.3.dev8__tar.gz → 1.1.3.dev9__tar.gz

{qubx-1.1.3.dev8 → qubx-1.1.3.dev9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Qubx
-Version: 1.1.3.dev8
+Version: 1.1.3.dev9
 Summary: Qubx - Quantitative Trading Framework
 Project-URL: homepage, https://xlydian.com
 Project-URL: repository, https://github.com/xLydianSoftware/Qubx

{qubx-1.1.3.dev8 → qubx-1.1.3.dev9}/src/qubx/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '1.1.3.dev8'
-__version_tuple__ = version_tuple = (1, 1, 3, 'dev8')
+__version__ = version = '1.1.3.dev9'
+__version_tuple__ = version_tuple = (1, 1, 3, 'dev9')
 
 __commit_id__ = commit_id = None

{qubx-1.1.3.dev8 → qubx-1.1.3.dev9}/src/qubx/control/__init__.py

@@ -1,4 +1,4 @@
-from .decorator import action, collect_actions, collect_state, execute_decorated_action, state
+from .decorator import action, collect_actions, collect_state, collect_state_schema, execute_decorated_action, state
 from .interfaces import IControllable
 from .server import ControlServer
 from .types import ActionDef, ActionParam, ActionResult
@@ -13,5 +13,6 @@ __all__ = [
     "state",
     "collect_actions",
     "collect_state",
+    "collect_state_schema",
     "execute_decorated_action",
 ]

{qubx-1.1.3.dev8 → qubx-1.1.3.dev9}/src/qubx/control/builtin.py

@@ -11,7 +11,7 @@ from qubx.core.basics import Instrument, MarketType, Signal
 from qubx.core.lookups import lookup
 from qubx.utils.time import to_timedelta, to_timestamp
 
-from .decorator import collect_state
+from .decorator import collect_state, collect_state_schema
 from .types import ActionDef, ActionParam, ActionResult
 
 if TYPE_CHECKING:
@@ -512,6 +512,11 @@ def _get_health(ctx: IStrategyContext, **kwargs) -> ActionResult:
     )
 
 
+def _get_state_schema(ctx: IStrategyContext, **kwargs) -> ActionResult:
+    schema = collect_state_schema(ctx.strategy)
+    return ActionResult(status="ok", data={"fields": schema})
+
+
 # --- Trading actions ---
 
 
@@ -762,6 +767,10 @@ BUILTIN_ACTIONS: dict[str, tuple[ActionDef, Callable]] = {
         ActionDef(name="get_health", description="Get health metrics: connectivity, queue size, data latencies", category="diagnostics", read_only=True),
         _get_health,
     ),
+    "get_state_schema": (
+        ActionDef(name="get_state_schema", description="Get descriptions of custom state fields returned by get_state", category="diagnostics", read_only=True),
+        _get_state_schema,
+    ),
     "get_total_capital": (
         ActionDef(name="get_total_capital", description="Get total capital across all exchanges", category="diagnostics", read_only=True),
         _get_total_capital,

{qubx-1.1.3.dev8 → qubx-1.1.3.dev9}/src/qubx/control/decorator.py

@@ -118,6 +118,19 @@ def collect_state(strategy: Any, ctx: Any) -> dict:
     return result
 
 
+def collect_state_schema(strategy: Any) -> dict[str, str]:
+    """Scan a strategy instance for @state-decorated methods and return their descriptions."""
+    schema = {}
+    for attr_name in dir(strategy):
+        try:
+            attr = getattr(strategy, attr_name, None)
+        except Exception:
+            continue
+        if callable(attr) and hasattr(attr, "__state__"):
+            schema[attr.__name__] = attr.__state__
+    return schema
+
+
 def collect_actions(strategy: Any) -> list[ActionDef]:
     """Scan a strategy instance for @action-decorated methods."""
     actions = []