@invokehq/cli 0.2.3 → 0.2.5

package/agentify.py

@@ -1569,6 +1569,111 @@ def search_command(args: argparse.Namespace) -> int:
     return 0
 
 
+def action_payload_from_args(args: argparse.Namespace) -> dict[str, Any]:
+    if not args.action:
+        raise CliUsageError(
+            f"Missing action.\n"
+            f"Usage: invoke {args.command} <action> '<json_params>'\n"
+            f"Example: invoke {args.command} stripe.charge_customer '{{\"customer_id\":\"cust_123\",\"amount\":2400}}'"
+        )
+    try:
+        params = json.loads(args.params)
+    except json.JSONDecodeError as exc:
+        raise ValueError(f"params must be valid JSON: {exc}") from exc
+    if not isinstance(params, dict):
+        raise ValueError("params must be a JSON object")
+
+    body: dict[str, Any] = {
+        "action": args.action,
+        "params": params,
+        "agent_id": args.agent_id,
+    }
+    if args.idempotency_key:
+        body["idempotency_key"] = args.idempotency_key
+    if args.apply_safe_fixes:
+        body["apply_safe_fixes"] = True
+    if getattr(args, "preflight_only", False):
+        body["preflight_only"] = True
+    return body
+
+
+def print_preflight_summary(preflight: dict[str, Any]) -> None:
+    print(f"Risk: {preflight.get('risk_score', '-')}" + (
+        f" ({preflight.get('risk_score_numeric')})" if preflight.get("risk_score_numeric") is not None else ""
+    ))
+    subject = preflight.get("subject") if isinstance(preflight.get("subject"), dict) else {}
+    if subject.get("tool"):
+        print(f"Subject: {subject.get('tool')} [{subject.get('safety_class') or 'unknown'}]")
+    simulation = preflight.get("simulation") if isinstance(preflight.get("simulation"), dict) else {}
+    if simulation:
+        print(
+            f"Simulation: {simulation.get('similar_traces', 0)} similar traces "
+            f"via {simulation.get('source', 'patterns')}"
+        )
+
+    warnings = preflight.get("warnings") if isinstance(preflight.get("warnings"), list) else []
+    if warnings:
+        print("\nWarnings")
+        for warning in warnings:
+            print(f"- {warning.get('severity', 'warn')}: {warning.get('message')}")
+
+    guardrails = preflight.get("recommended_guardrails") if isinstance(preflight.get("recommended_guardrails"), list) else []
+    if guardrails:
+        print("\nRecommended guardrails")
+        for guardrail in guardrails:
+            applied = "applied" if guardrail.get("applied") else "pending"
+            print(f"- {guardrail.get('type')}: {guardrail.get('action')} [{applied}]")
+
+    safe_fixes = preflight.get("safe_fixes") if isinstance(preflight.get("safe_fixes"), dict) else {}
+    if safe_fixes.get("idempotency_key"):
+        print(f"\nIdempotency key: {safe_fixes.get('idempotency_key')}")
+    print(f"\nDecision: {preflight.get('decision', '-')}")
+
+
+def preflight_command(args: argparse.Namespace) -> int:
+    credentials = require_credentials(args)
+    response = api_request(
+        "POST",
+        credentials["base_url"],
+        "/v1/preflight",
+        credentials["api_key"],
+        action_payload_from_args(args),
+    )
+    if args.json:
+        print(json.dumps(response, indent=2))
+        return 0
+    print(f"Invoke preflight: {args.action}")
+    print_preflight_summary(response.get("preflight") or {})
+    return 0
+
+
+def execute_command(args: argparse.Namespace) -> int:
+    credentials = require_credentials(args)
+    response = api_request(
+        "POST",
+        credentials["base_url"],
+        "/v1/executions",
+        credentials["api_key"],
+        action_payload_from_args(args),
+    )
+    if args.json:
+        print(json.dumps(response, indent=2))
+        return 0
+
+    execution = response.get("execution") if isinstance(response.get("execution"), dict) else {}
+    certificate = response.get("certificate") if isinstance(response.get("certificate"), dict) else {}
+    print(f"Invoke execute: {args.action}")
+    preflight = response.get("preflight") if isinstance(response.get("preflight"), dict) else {}
+    if preflight:
+        print_preflight_summary(preflight)
+        print()
+    print(f"Execution ID: {certificate.get('execution_id') or execution.get('execution_id') or '-'}")
+    print(f"Decision: {certificate.get('decision') or execution.get('decision') or execution.get('status') or '-'}")
+    print(f"Final outcome: {certificate.get('final_outcome') or execution.get('final_outcome') or '-'}")
+    print("Certificate returned: yes")
+    return 0
+
+
 def workflow_command(args: argparse.Namespace) -> int:
     credentials = require_credentials(args)
     body: dict[str, Any] = {}
@@ -1728,6 +1833,29 @@ def build_parser() -> argparse.ArgumentParser:
     search.add_argument("--api-key", help="Override Invoke API key.")
     search.set_defaults(func=search_command)
 
+    preflight = subparsers.add_parser("preflight", help="Simulate an agent action before execution.")
+    preflight.add_argument("action", nargs="?", help="Action name, for example stripe.charge_customer.")
+    preflight.add_argument("params", nargs="?", default="{}", help="JSON params object.")
+    preflight.add_argument("--agent-id", default="cli_agent")
+    preflight.add_argument("--idempotency-key")
+    preflight.add_argument("--apply-safe-fixes", action="store_true", help="Apply recommended guardrails in the returned plan.")
+    preflight.add_argument("--json", action="store_true", help="Print the full JSON response.")
+    preflight.add_argument("--base-url", help="Override Invoke runtime URL.")
+    preflight.add_argument("--api-key", help="Override Invoke API key.")
+    preflight.set_defaults(func=preflight_command)
+
+    execute = subparsers.add_parser("execute", help="Execute an agent action through Invoke's control boundary.")
+    execute.add_argument("action", nargs="?", help="Action name, for example stripe.charge_customer.")
+    execute.add_argument("params", nargs="?", default="{}", help="JSON params object.")
+    execute.add_argument("--agent-id", default="cli_agent")
+    execute.add_argument("--idempotency-key")
+    execute.add_argument("--apply-safe-fixes", action="store_true", help="Apply recommended guardrails before returning the receipt.")
+    execute.add_argument("--preflight-only", action="store_true", help="Only run the pre-execution simulation.")
+    execute.add_argument("--json", action="store_true", help="Print the full JSON response.")
+    execute.add_argument("--base-url", help="Override Invoke runtime URL.")
+    execute.add_argument("--api-key", help="Override Invoke API key.")
+    execute.set_defaults(func=execute_command)
+
     workflow = subparsers.add_parser("workflow", help="Run a packaged Invoke workflow.")
     workflow.add_argument(
         "workflow",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@invokehq/cli",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "CLI for Invoke, execution reliability infrastructure for AI agents.",
   "license": "Apache-2.0",
   "bin": {