programgarden-core 1.18.0__tar.gz → 1.19.0__tar.gz

{programgarden_core-1.18.0 → programgarden_core-1.19.0}/PKG-INFO

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

{programgarden_core-1.18.0 → programgarden_core-1.19.0}/programgarden_core/nodes/ai.py

@@ -360,6 +360,11 @@ class AIAgentNode(BaseNode):
         "max_total_tokens (default 100,000) caps total token spend per execution cycle",
     ]
     _anti_patterns: ClassVar[List[Dict[str, str]]] = [
+        {
+            "pattern": "Adding an AIAgentNode without connecting an LLMModelNode via an 'ai_model' edge",
+            "reason": "AIAgentNode CANNOT run without an LLM — the ai_model edge injects the LLM connection. With no LLMModelNode wired via an ai_model edge, the node fails at runtime (raises). The workflow validator now blocks this with an ERROR at save time.",
+            "alternative": "Always add an LLMModelNode and wire it to the AIAgentNode with an ai_model edge: {\"from\": \"<llm_node_id>\", \"to\": \"<agent_id>\", \"type\": \"ai_model\"}. A plain 'main' edge does NOT inject the LLM.",
+        },
         {
             "pattern": "Connecting a real-time node (RealMarketDataNode) directly to AIAgentNode without ThrottleNode",
             "reason": "Real-time nodes fire on every tick. Without throttling, AIAgentNode would call the LLM API thousands of times per minute, causing massive cost and rate limit errors. The workflow validator blocks this with an ERROR.",

{programgarden_core-1.18.0 → programgarden_core-1.19.0}/programgarden_core/nodes/display.py

@@ -10,7 +10,7 @@ ProgramGarden Core - Display Nodes
 - SummaryDisplayNode: JSON/요약 데이터 표시
 """
 
-from typing import Optional, List, Literal, Dict, Any, ClassVar, TYPE_CHECKING
+from typing import Optional, List, Literal, Dict, Any, Union, ClassVar, TYPE_CHECKING
 from pydantic import Field
 
 if TYPE_CHECKING:
@@ -304,9 +304,16 @@ class TableDisplayNode(BaseDisplayNode):
     _updated_at: ClassVar[str] = "2026-05-19"
     _change_note: ClassVar[Optional[str]] = None
 
-    columns: Optional[List[str]] = Field(
+    # columns 는 두 형태를 모두 받는다(스키마=코드=카탈로그 정합; 렌더러 _normalize_columns):
+    #   1) 필드명 문자열 리스트 — ["symbol", "close"]
+    #   2) {key, label} 객체 리스트 — [{"key": "close", "label": "종가"}] (현지화 헤더용)
+    # 옛 선언은 List[str] 뿐이라 객체형을 코드만 몰래 허용하는 드리프트였다.
+    columns: Optional[List[Union[str, Dict[str, Any]]]] = Field(
         default=None,
-        description="표시할 컬럼 목록 (미지정시 전체)",
+        description=(
+            "표시할 컬럼 (미지정시 전체). 필드명 문자열 리스트 [\"symbol\",\"close\"] 또는 "
+            "현지화 헤더용 객체 리스트 [{\"key\":\"close\",\"label\":\"종가\"}] 둘 다 허용."
+        ),
     )
 
     limit: Optional[int] = Field(
@@ -336,7 +343,10 @@ class TableDisplayNode(BaseDisplayNode):
             "columns": FieldSchema(
                 name="columns",
                 type=FieldType.ARRAY,
-                description="표시할 컬럼 목록",
+                description=(
+                    "표시할 컬럼. 필드명 문자열 리스트 [\"symbol\",\"close\"] 또는 "
+                    "{key,label} 객체 리스트 [{\"key\":\"close\",\"label\":\"종가\"}](현지화 헤더) 허용"
+                ),
                 category=FieldCategory.SETTINGS,
                 expression_mode=ExpressionMode.FIXED_ONLY,
                 ui_options={"multiple": True},

{programgarden_core-1.18.0 → programgarden_core-1.19.0}/programgarden_core/nodes/infra.py

@@ -457,6 +457,11 @@ class SplitNode(BaseNode):
             "reason": "Auto-iterate is implicit and handled by the executor — adding SplitNode duplicates the iteration and doubles the workload.",
             "alternative": "Bind `{{ item }}` directly on the downstream node and delete SplitNode.",
         },
+        {
+            "pattern": "Adding SplitNode without wiring its `array` input to an upstream list producer",
+            "reason": "SplitNode with no array source (no WatchlistNode/MarketUniverseNode/AccountNode/ConditionNode feeding a list, and no `array` binding) emits zero items — downstream `{{ nodes.split.item }}` resolves empty and the workflow produces silent empty results.",
+            "alternative": "Wire an upstream node that outputs an array into SplitNode, or — for a single known symbol — delete SplitNode and bind that symbol directly on the downstream node.",
+        },
         {
             "pattern": "parallel=True for order-placement loops",
             "reason": "Placing orders concurrently without delay_ms will trip LS-Sec TR rate limits and cause spurious cancellations.",
@@ -530,7 +535,7 @@ class SplitNode(BaseNode):
         },
     ]
     _node_guide: ClassVar[Dict[str, Any]] = {
-        "input_handling": "`array` input — typically bound implicitly by the upstream array output. No explicit config needed; SplitNode infers the iteration from the DAG.",
+        "input_handling": "`array` input is REQUIRED and MUST have a source: either an incoming edge from an upstream node that outputs an ARRAY (WatchlistNode/MarketUniverseNode → symbols, AccountNode → positions/held_symbols, ConditionNode → values, etc.), or an explicit `array` config binding. SplitNode has NOTHING to split if no upstream produces a list — it emits zero items and every downstream `{{ nodes.split.item }}` silently resolves empty. If you already know a single concrete symbol (e.g. 'AAPL'), do NOT add SplitNode — bind that one symbol directly on the downstream node.",
         "output_consumption": "Downstream binds `{{ nodes.split.item }}` for the current element, `{{ nodes.split.index }}` for the 0-based position, and `{{ nodes.split.total }}` for the count.",
         "common_combinations": [
             "WatchlistNode → SplitNode → OverseasStockFundamentalNode",

{programgarden_core-1.18.0 → programgarden_core-1.19.0}/pyproject.toml

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