programgarden-core 1.28.0__tar.gz → 1.28.2__tar.gz

{programgarden_core-1.28.0 → programgarden_core-1.28.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: programgarden-core
-Version: 1.28.0
+Version: 1.28.2
 Summary: ProgramGarden Core - 노드 기반 DSL 핵심 타입 정의
 License-Expression: AGPL-3.0-or-later
 Author: 프로그램동산

{programgarden_core-1.28.0 → programgarden_core-1.28.2}/programgarden_core/bases/listener.py

@@ -409,6 +409,9 @@ class WorkflowPnLEvent:
     competition_account_overseas_futures_pnl_amount: Optional[Union[Decimal, float]] = None
     competition_account_korea_stock_pnl_rate: Optional[Union[Decimal, float]] = None
     competition_account_korea_stock_pnl_amount: Optional[Union[Decimal, float]] = None
+    # Open-position money, independent of closed-trade personal metrics.
+    account_valuation: Optional[Dict[str, Any]] = None
+    workflow_valuation: Optional[Dict[str, Any]] = None
 
 
 # ============================================================

{programgarden_core-1.28.0 → programgarden_core-1.28.2}/programgarden_core/models/__init__.py

@@ -99,6 +99,11 @@ from programgarden_core.models.order_diagnostics import (
     EmptyOrderReason,
     map_reject_code,
     diagnose_missing_order_no,
+    unsupported_market_reject,
+    looks_like_otc_ticker,
+    LS_OVERSEAS_DESK_PHONE,
+    OVERSEAS_STOCK_ORDER_MARKET_CODES,
+    UNSUPPORTED_MARKET_RSP_CD,
     ORDER_ACCEPTED_RSP_CDS,
     OVERSEAS_STOCK_REJECT_CODES,
     OVERSEAS_FUTURES_REJECT_CODES,
@@ -196,6 +201,11 @@ __all__ = [
     "EmptyOrderReason",
     "map_reject_code",
     "diagnose_missing_order_no",
+    "unsupported_market_reject",
+    "looks_like_otc_ticker",
+    "LS_OVERSEAS_DESK_PHONE",
+    "OVERSEAS_STOCK_ORDER_MARKET_CODES",
+    "UNSUPPORTED_MARKET_RSP_CD",
     "ORDER_ACCEPTED_RSP_CDS",
     "OVERSEAS_STOCK_REJECT_CODES",
     "OVERSEAS_FUTURES_REJECT_CODES",

{programgarden_core-1.28.0 → programgarden_core-1.28.2}/programgarden_core/models/order_diagnostics.py

@@ -124,6 +124,12 @@ class EmptyOrderReason(str, Enum):
     (fractional balances measured on a real LS account, prod 2026-08-24)."""
 
 
+LS_OVERSEAS_DESK_PHONE = "02-3779-8888"
+"""LS Securities overseas-stock desk. An OTC holding can only be sold by calling this
+number: LS finds a local broker to take the shares during US regular hours
+(confirmed by LS support, relayed by the account owner 2026-09-14)."""
+
+
 # ---------------------------------------------------------------------------
 # Market-specific reject-code tables.
 #
@@ -160,10 +166,26 @@ OVERSEAS_STOCK_REJECT_CODES: Dict[str, Dict[str, str]] = {
             "the number may be wrong or the order may already be gone."
         ),
     },
+    # Live-verified 2026-09-14 on a real LS overseas-stock account. A held OTC
+    # issue (ZOMDF) was sent as a limit sell under BOTH accepted market codes —
+    # "82" (NASDAQ) and "81" (NYSE/AMEX) — and each came back 03053. LS support
+    # confirmed the reason by phone: **OTC issues cannot be traded through the
+    # API at all; they must be ordered by calling LS Securities.** So this code
+    # is not only "typo in the ticker" — for a symbol the account actually holds,
+    # it means the symbol is not tradable on either supported market.
     "03053": {
         "retry": RetryAdvice.DO_NOT_RETRY.value,
-        "cause": "The broker does not recognize the symbol code.",
-        "tip": "Check the symbol spelling and that it is listed on the given exchange.",
+        "cause": (
+            "The broker does not recognize the symbol on the market the order was sent to. "
+            "For a symbol the account already holds, this means it is not listed on either "
+            "market the order API accepts (NYSE/AMEX or NASDAQ) — an OTC issue, for example."
+        ),
+        "tip": (
+            "If the account does not hold this symbol, check the ticker spelling and its exchange. "
+            "If the account does hold it, the symbol is most likely OTC and the API cannot trade it "
+            f"at all — call the LS Securities overseas desk at {LS_OVERSEAS_DESK_PHONE} and ask them "
+            "to sell it; LS finds a local broker during US regular hours."
+        ),
     },
     "03759": {
         "retry": RetryAdvice.DO_NOT_RETRY.value,
@@ -211,6 +233,66 @@ KOREA_STOCK_REJECT_CODES: Dict[str, Dict[str, str]] = {
     },
 }
 
+# Markets the LS overseas-stock order TRs accept. COSAT00301's ``OrdMktCode`` and
+# g3101's ``exchcd`` are both ``Literal["81", "82"]`` — there is no third value to
+# try, so a holding on any other market cannot be ordered through this API.
+OVERSEAS_STOCK_ORDER_MARKET_CODES: Dict[str, str] = {
+    "NYSE": "81", "AMEX": "81", "NASDAQ": "82", "81": "81", "82": "82",
+}
+
+UNSUPPORTED_MARKET_RSP_CD = "PG_UNSUPPORTED_MARKET"
+"""Sentinel used in place of a broker response code.
+
+This rejection is raised by us **before** any request reaches LS, so there is no
+``rsp_cd`` to report. The sentinel keeps the field populated (never a bare "")
+and is prefixed ``PG_`` so a consumer can tell at a glance that it did not come
+from the broker.
+"""
+
+
+def looks_like_otc_ticker(symbol: object) -> bool:
+    """Heuristic from LS support: a 5-letter ticker ending in ``F`` usually means the
+    issue has moved to OTC (e.g. ``ZOMDF``).
+
+    ⚠️ LS explicitly said this is **not always true**, so it must never gate an order.
+    Use it only to make a message more helpful — the authoritative signal is the market
+    code, which the order API rejects on its own.
+    """
+    s = str(symbol or "").strip().upper()
+    return len(s) == 5 and s.endswith("F") and s.isalpha()
+
+
+def unsupported_market_reject(exchange: object, symbol: str = "") -> OrderRejectInfo:
+    """Diagnostic for a symbol whose market the order API cannot address.
+
+    Live-verified 2026-09-14: a held OTC issue is reported by the balance TR with
+    a market code outside {81, 82}, and both accepted codes are rejected with
+    ``03053``. Blocking before the request keeps the real cause visible — sending
+    a substituted code instead makes the broker answer "해당 종목번호가 없습니다",
+    which reads like a mistyped ticker and hides that the symbol is untradable.
+    """
+    shown = str(exchange) if exchange not in (None, "") else "unknown"
+    otc_hint = (
+        " The ticker is 5 letters ending in F, which usually means the issue moved to OTC."
+        if looks_like_otc_ticker(symbol) else ""
+    )
+    return OrderRejectInfo(
+        rsp_cd=UNSUPPORTED_MARKET_RSP_CD,
+        cause=(
+            f"This symbol's market ({shown}) is not one the order API can address — "
+            f"it accepts NYSE/AMEX and NASDAQ only. OTC issues arrive this way.{otc_hint}"
+        ),
+        tip=(
+            "ProgramGarden cannot place this order. Call the LS Securities overseas desk at "
+            f"{LS_OVERSEAS_DESK_PHONE} and ask them to sell it — LS finds a local broker to "
+            "take the shares during US regular hours. Automation cannot reach this symbol."
+        ),
+        raw_msg="",
+        retry=RetryAdvice.DO_NOT_RETRY,
+        known=True,
+    )
+
+
 _MARKET_TABLES: Dict[str, Dict[str, Dict[str, str]]] = {
     "overseas_stock": OVERSEAS_STOCK_REJECT_CODES,
     "overseas_futures": OVERSEAS_FUTURES_REJECT_CODES,

{programgarden_core-1.28.0 → programgarden_core-1.28.2}/programgarden_core/nodes/order.py

@@ -367,7 +367,7 @@ class OverseasStockNewOrderNode(BaseOrderNode):
         ],
         "typical_scenarios": [
             "ConditionNode.result → PositionSizingNode → OverseasStockNewOrderNode (signal-driven buy)",
-            "OverseasStockAccountNode.held_symbols → ConditionNode (stop-loss) → OverseasStockNewOrderNode (sell)",
+            "OverseasStockAccountNode.positions → ConditionNode (stop-loss) → SymbolFilterNode (intersection with positions) → OverseasStockNewOrderNode (sell, limit, price={{ item.current_price }})",
             "ScreenerNode.symbols → SplitNode → PositionSizingNode → OverseasStockNewOrderNode (basket order)",
         ],
     }
@@ -377,6 +377,8 @@ class OverseasStockNewOrderNode(BaseOrderNode):
         "Supports extended price_type options: LOO, LOC, MOO, MOC for open/close auction orders",
         "is_tool_enabled=True — AI Agent can call this node as a tool to place orders autonomously",
         "retry is disabled by default (resilience.retry.enabled=False); only pure network-connection failures may be retried, never a submitted order",
+        "US daytime (Blue Ocean) session accepts LIMIT orders only — a market order is refused at intake with rsp_cd=00891 and no order number. A workflow scheduled across both the daytime and the regular overnight session must therefore use order_type='limit' for it to work in both.",
+        "A limit order needs a price. Buy orders fall back to a current-price lookup, and so do sell orders since engine 1.37.3, but that lookup (g3101) only accepts exchange codes 81/82 — it fails for a holding listed on any other market. Prefer feeding the price the account balance already carries: price='{{ item.current_price }}'.",
     ]
     _anti_patterns: ClassVar[List[Dict[str, str]]] = [
         {
@@ -394,6 +396,16 @@ class OverseasStockNewOrderNode(BaseOrderNode):
             "reason": "Every tick would trigger an order attempt; rate-limit rules block this and raise a connection error at validation time.",
             "alternative": "Insert a ThrottleNode between the realtime source and the order node to control firing rate.",
         },
+        {
+            "pattern": "order_type='market' on a stop-loss / take-profit sell that can run during US daytime (Blue Ocean) hours",
+            "reason": "That session refuses market orders at intake (rsp_cd=00891, empty order number), so the stop-loss silently never executes while the schedule covers daytime hours.",
+            "alternative": "Use order_type='limit' and supply the price from the account snapshot: price='{{ item.current_price }}'. Note a limit order is not guaranteed to fill.",
+        },
+        {
+            "pattern": "Wiring an order node to ConditionNode.symbols or AccountNode.held_symbols for a close/sell order",
+            "reason": "`symbols` lists every evaluated symbol, not the ones that passed, and neither port carries `quantity` or `current_price` — the order node cannot build an order and skips the item.",
+            "alternative": "Use `passed_symbols` for the pass list, and to recover quantity and price put a SymbolFilterNode (operation='intersection', input_a='{{ nodes.account.positions }}', input_b='{{ nodes.cond.passed_symbols }}') in between — intersection preserves input_a's full position dicts.",
+        },
         {
             "pattern": "Using a dict-keyed positions object {symbol: {...}} from a RealAccountNode output as order input",
             "reason": "All position outputs in ProgramGarden are list[dict] with `symbol`/`exchange` keys. Dict-keyed access will fail at runtime.",

{programgarden_core-1.28.0 → programgarden_core-1.28.2}/pyproject.toml

@@ -5,7 +5,7 @@ authors = [
 homepage = "https://programgarden.com"
 requires-python = ">=3.12"
 name = "programgarden-core"
-version = "1.28.0"
+version = "1.28.2"
 license = "AGPL-3.0-or-later"
 description = "ProgramGarden Core - 노드 기반 DSL 핵심 타입 정의"
 readme = "README.md"