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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: applied-cli
-Version: 0.5.68
+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.68 → 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.68"
+__version__ = "0.5.70"
 
 __all__ = ["AppliedClient", "tools", "to_csv", "to_json", "__version__"]

{applied_cli-0.5.68 → applied_cli-0.5.70}/applied_cli/agent_scoped_flows.py

@@ -42,9 +42,7 @@ def _parse_json_option(value: str | None, *, option_name: str) -> dict[str, Any]
         ) from exc
 
     if not isinstance(parsed, dict):
-        raise AgentScopedFlowCLIError(
-            f"{option_name} must decode to a JSON object."
-        )
+        raise AgentScopedFlowCLIError(f"{option_name} must decode to a JSON object.")
 
     return parsed
 
@@ -123,7 +121,9 @@ async def _handle_flow_delete(
     get_client: Callable[[str | None], AppliedClient],
 ) -> int:
     client = get_client(args.shop_id)
-    flow = await _get_flow_for_agent(client, agent_id=args.agent_id, flow_id=args.flow_id)
+    flow = await _get_flow_for_agent(
+        client, agent_id=args.agent_id, flow_id=args.flow_id
+    )
     await client.delete_flow(args.flow_id)
     if args.format == "json":
         pass
@@ -139,12 +139,6 @@ async def _handle_node_create(
     client = get_client(args.shop_id)
     await _get_flow_for_agent(client, agent_id=args.agent_id, flow_id=args.flow_id)
 
-    if args.guardrail:
-        raise AgentScopedFlowCLIError(
-            "--guardrail is not supported on node create because the API does not "
-            "persist it. Create the node first, then run node update --guardrail."
-        )
-
     node = await client.create_node(
         flow_id=args.flow_id,
         name=normalize_executor_type(args.executor_type),
@@ -193,11 +187,12 @@ async def _handle_node_delete(
     get_client: Callable[[str | None], AppliedClient],
 ) -> int:
     client = get_client(args.shop_id)
-    flow = await _get_flow_for_agent(client, agent_id=args.agent_id, flow_id=args.flow_id)
+    flow = await _get_flow_for_agent(
+        client, agent_id=args.agent_id, flow_id=args.flow_id
+    )
 
     graph = flow.get("graph") or {}
     nodes = graph.get("nodes") or []
-    edges = graph.get("edges") or []
     node = next((item for item in nodes if item.get("id") == args.node_id), None)
     if node is None:
         raise AgentScopedFlowCLIError(
@@ -265,7 +260,9 @@ async def _handle_edge_delete(
     get_client: Callable[[str | None], AppliedClient],
 ) -> int:
     client = get_client(args.shop_id)
-    flow = await _get_flow_for_agent(client, agent_id=args.agent_id, flow_id=args.flow_id)
+    flow = await _get_flow_for_agent(
+        client, agent_id=args.agent_id, flow_id=args.flow_id
+    )
 
     graph = flow.get("graph") or {}
     edges = graph.get("edges") or []

{applied_cli-0.5.68 → 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.68 → 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.68 → 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.68
+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.68 → applied_cli-0.5.70}/pyproject.toml

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

{applied_cli-0.5.68 → applied_cli-0.5.70}/tests/test_agent_scoped_flows.py

@@ -282,7 +282,7 @@ async def test_node_create_prints_raw_json(capsys):
 
 
 @pytest.mark.asyncio
-async def test_node_create_rejects_guardrail_on_create():
+async def test_node_create_accepts_guardrail_on_create():
     client = StubClient()
     args = _parse_args(
         [
@@ -299,8 +299,11 @@ async def test_node_create_rejects_guardrail_on_create():
         ]
     )
 
-    with pytest.raises(AgentScopedFlowCLIError, match="not supported on node create"):
-        await _handle_node_create(args, lambda _shop_id: client)
+    exit_code = await _handle_node_create(args, lambda _shop_id: client)
+
+    assert exit_code == 0
+    assert client.created_node_args is not None
+    assert client.created_node_args["guardrail"] == "Be careful"
 
 
 @pytest.mark.asyncio
@@ -347,7 +350,11 @@ async def test_node_update_prints_raw_json(capsys):
 
     assert exit_code == 0
     assert client.updated_node_args == ("flow-1", "node-1", {"prompt": "hi"})
-    assert json.loads(capsys.readouterr().out) == {**client.node, "id": "node-1", "prompt": "hi"}
+    assert json.loads(capsys.readouterr().out) == {
+        **client.node,
+        "id": "node-1",
+        "prompt": "hi",
+    }
 
 
 @pytest.mark.asyncio