@uipath/function-tool 1.203.0-preview.212 → 1.204.0-preview.211

package/README.md

@@ -14,7 +14,7 @@ into Studio Web.
 | Project | Needs |
 |---|---|
 | JS/TS | Node.js 20 or later. The CLI checks this for you on `new`. |
-| Python | The `uipath` Python CLI: `pip install uipath`, then `uipath auth login`. |
+| Python | The `uipath` Python CLI: `pip install uipath`, then `uipath auth login`. Run `uip function setup` once so the CLI knows where to find it. |
 
 Everything else is installed for you.
 
@@ -82,6 +82,7 @@ signature changes. JS/TS needs no equivalent — it reads your types directly.
 | `publish` | Upload the `.nupkg` to an Orchestrator feed | both |
 | `push` | Sync the project into a Studio Web project | both |
 | `runtime-install` | Prepare a runner folder — used by the platform, rarely by hand | JS/TS |
+| `setup` | Find your toolchains and remember where they are | both |
 
 `uip functions` still works as an alias for `uip function`.
 
@@ -106,6 +107,16 @@ Python scaffolds into the current directory.
 You only need `--language` for the first command in an empty directory. After
 that the project files say which language it is.
 
+For Python, `new` is forwarded with `--type function`, so an agent framework
+installed in the venv cannot claim the scaffold. The flag is sent only when the
+installed `uipath new` advertises it, which the bridge checks with one
+`uipath new --help` call.
+
+`--type` is not an option this command takes: `uip function new` always
+scaffolds a function, so passing one exits `1` with
+`--type is not a valid option.` rather than being honoured or silently
+overridden. For a coded agent, use `uip codedagent new`.
+
 ### `run [name]`
 
 ```sh
@@ -192,6 +203,26 @@ Uploads the files that changed, so it is safe to run repeatedly.
 > is never forwarded for either verb, and Python resolves the project from its
 > own config.
 
+### `setup`
+
+```sh
+uip function setup
+uip function setup --force          # probe again, ignoring what was cached
+```
+
+Finds Node.js for JS/TS, and Python plus the `uipath` package for Python, and
+remembers where they are so later commands do not look again.
+
+Missing Node is an error — JS/TS cannot run without it. Missing Python is
+reported and then ignored, because a JS/TS-only project does not need it. The
+Node half runs by itself before `new` for JS/TS, so you only run this by hand
+to add Python or to repair a stale answer.
+
+Python Functions commands fail with a `ConfigError` pointing back here until it
+has run once; there is no fallback to whatever `uipath` happens to be on your
+`PATH`. The Python answer is shared with `uip codedagent` and
+`uip context-grounding`, so running any one of their setups configures them all.
+
 ## Troubleshooting
 
 **"No Functions project detected in this directory."** You are not in a project
@@ -205,6 +236,9 @@ wanted an empty project, that is `uip function new <name> --empty`.
 on your `PATH`. After installing it, `uip function setup --force` re-runs the
 check.
 
+**"Python not configured" on a Python project.** `uip function setup` has not
+run yet, or the interpreter it found has gone. Run `uip function setup --force`.
+
 **`run` cannot find a function you just added.** Names resolve through the
 project's function list, which `run` never regenerates. Run
 `uip function pack` once, or start `uip function serve`, to refresh it.
@@ -212,5 +246,9 @@ project's function list, which `run` never regenerates. Run
 ## Known issues
 
 - **`uip function new --language py` scaffolds an agent instead of a function**
-  when `uipath-langchain` is installed. Tracked in
-  [uipath-python#1543](https://github.com/UiPath/uipath-python/issues/1543).
+  when `uipath-langchain` is installed and the venv's `uipath` predates
+  `uipath new --type` — that core's scaffold follows the installed packages
+  ([uipath-python#1543](https://github.com/UiPath/uipath-python/issues/1543)).
+  Once the core has the option, the tool forwards `--type function`, which pins
+  the scaffold; upgrade the core to get that behavior. Check yours with
+  `uipath new --help`: a listed `--type` means the pin is in effect.