applied-cli 0.5.69__tar.gz → 0.5.70__tar.gz

{applied_cli-0.5.69 → applied_cli-0.5.70}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: applied-cli
-Version: 0.5.69
+Version: 0.5.70
 Summary: CLI and shared client library for Applied Labs AI support agents
 Author: Applied Labs
 License-Expression: MIT

{applied_cli-0.5.69 → applied_cli-0.5.70}/applied_cli/__init__.py

@@ -4,6 +4,6 @@ from applied_cli import tools
 from applied_cli.client import AppliedClient
 from applied_cli.formatters import to_csv, to_json
 
-__version__ = "0.5.69"
+__version__ = "0.5.70"
 
 __all__ = ["AppliedClient", "tools", "to_csv", "to_json", "__version__"]

{applied_cli-0.5.69 → applied_cli-0.5.70}/applied_cli/flow_helpers.py

@@ -16,6 +16,7 @@ _CANONICAL_EXECUTOR_TYPES: tuple[str, ...] = (
     "code",
     "http_request",
     "loop",
+    "agent_loop",
     "memory",
     "search",
     "recommend",
@@ -38,6 +39,7 @@ _EXECUTOR_UI_LABELS: dict[str, str] = {
     "code": "Code",
     "http_request": "HTTP Request",
     "loop": "Loop",
+    "agent_loop": "Agent Loop",
     "memory": "Memory",
     "search": "Search",
     "recommend": "Recommend",
@@ -62,6 +64,7 @@ _EXECUTOR_ALIASES: dict[str, tuple[str, ...]] = {
         "structured completion",
     ),
     "flow": ("run flow", "run_flow", "subflow"),
+    "agent_loop": ("agent loop", "planner loop", "tool belt", "agentic loop"),
     "end_flow": (
         "end flow return",
         "end flow and return",

{applied_cli-0.5.69 → applied_cli-0.5.70}/applied_cli/tools.py

@@ -2383,6 +2383,39 @@ async def flow_node_create(
             '"position": {"x": 0, "y": 600}}\''
         )
 
+    # Validate agent_loop metadata
+    if canonical_executor_type == "agent_loop":
+        tool_belt = metadata.get("tool_belt")
+        if not tool_belt:
+            return (
+                "❌ Error: agent_loop node requires a non-empty 'tool_belt' in metadata.\n\n"
+                "💡 Required fields:\n"
+                '  - tool_belt: list of {"action_name", "flow_id", "description"} entries\n'
+                "      Each entry maps a planner action name to an operational subflow.\n"
+                "  - model: \"fast\" or \"powerful\" (optional, default \"fast\")\n"
+                "  - content: string - LLM context block (optional; auto-built from\n"
+                "      the conversation trigger when empty and include_trigger_context=true)\n"
+                "  - include_trigger_context: bool (optional, default true)\n"
+                "  - planner_schema: list of SchemaField dicts for extra planner outputs\n"
+                "  - max_steps: int >= 1 (optional, default 10)\n"
+                "  - max_parallel_actions: int >= 1 (optional, default 3)\n\n"
+                "Example:\n"
+                'metadata=\'{"model": "fast", "max_steps": 8, "tool_belt": ['
+                '{"action_name": "lookup_order", "flow_id": "<subflow-uuid>", '
+                '"description": "Fetch an order by number"}], '
+                '"position": {"x": 0, "y": 300}}\''
+            )
+        if not isinstance(tool_belt, list) or not all(
+            isinstance(entry, dict)
+            and entry.get("action_name")
+            and entry.get("flow_id")
+            for entry in tool_belt
+        ):
+            return (
+                "❌ Error: agent_loop 'tool_belt' must be a list of objects, "
+                "each with 'action_name' and 'flow_id'."
+            )
+
     # Validate mutate_ticket metadata
     is_mutate_ticket = canonical_executor_type == "mutate_ticket"
     ticket_missing_name = not metadata or "name" not in metadata
@@ -3766,6 +3799,36 @@ async def executor_list(
             },
             "output_fields": ["results", "count"],
         },
+        {
+            "name": "agent_loop",
+            "ui_label": "Agent Loop",
+            "aliases": executor_aliases("agent_loop"),
+            "description": "Planner-driven loop that dispatches tool-belt subflows until it finishes",
+            "use_case": (
+                "Let an LLM planner iteratively choose which operational "
+                "subflows to call (in parallel where safe) before replying. "
+                "Each tool-belt entry maps an action name to an operational flow; "
+                "the planner emits one or more calls per step and ends with 'finish'."
+            ),
+            "metadata_fields": {
+                "model": "string - 'fast' or 'powerful' (default 'fast')",
+                "content": "string - LLM context block; leave empty to auto-build from the conversation trigger",
+                "include_trigger_context": "bool - auto-assemble trigger context when content is empty (default true)",
+                "tool_belt": (
+                    "array (required) - list of {action_name, flow_id, description} entries; "
+                    "each flow_id must be an operational subflow"
+                ),
+                "planner_schema": "array - SchemaField dicts surfaced on the loop's output and per-step payload",
+                "max_steps": "int >= 1 - hard cap on planner iterations (default 10)",
+                "max_parallel_actions": "int >= 1 - max actions the planner may dispatch per step (default 3)",
+            },
+            "output_fields": [
+                "outcome",
+                "steps_taken",
+                "max_steps_reached",
+                "(plus fields defined by planner_schema)",
+            ],
+        },
         {
             "name": "memory",
             "ui_label": "Memory",

{applied_cli-0.5.69 → applied_cli-0.5.70}/applied_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: applied-cli
-Version: 0.5.69
+Version: 0.5.70
 Summary: CLI and shared client library for Applied Labs AI support agents
 Author: Applied Labs
 License-Expression: MIT

{applied_cli-0.5.69 → applied_cli-0.5.70}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "applied-cli"
-version = "0.5.69"
+version = "0.5.70"
 description = "CLI and shared client library for Applied Labs AI support agents"
 readme = "README.md"
 requires-python = ">=3.11"