docs: document uipath new project types and agent frameworks

Add the missing `new` section to the CLI reference (mkdocs-click block
plus type semantics, behaviour matrix, and function/agent examples), an
--agent-framework column and Claude Agent SDK row to the coded-agents
framework table, explicit-type notes to the agents and Studio Web
quickstarts, a --type function guarantee note to the coded-functions
guide, and uipath-claude-sdk to the Studio Web package lists.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: vldcmp-uipath

packages/uipath/docs/cli/index.md

@@ -67,6 +67,61 @@ Treat `--client-secret` as a credential. In CI, prefer reading it from a secret
 
 ---
 
+::: mkdocs-click
+    :module: uipath._cli
+    :command: new
+    :depth: 1
+    :style: table
+
+Scaffolds a project in the current directory. `--type` selects what gets created:
+
+- **`auto`** (default) — an installed agent framework integration (e.g. `uipath-langchain`) claims the scaffold and creates a coded agent project; with none installed, a coded function project is created.
+- **`function`** — always creates a coded function project, regardless of installed integrations.
+- **`agent`** — creates a coded agent project. `--agent-framework` picks the framework and defaults to the one whose integration package is installed.
+
+| Installed framework integrations | `uipath new x` (auto) | `uipath new x --type agent` |
+|----------------------------------|------------------------|------------------------------|
+| none | coded function project | error listing the integration packages |
+| one | that framework's coded agent project | that framework's coded agent project |
+| several | error: pick one explicitly | error: pick one explicitly |
+
+`--agent-framework` is only valid together with `--type agent`.
+
+Scaffold a coded function:
+
+<!-- termynal -->
+
+```shell
+> uipath new my-function --type function
+⠋ Creating new project my-function in current directory ...
+✓  Created 'main.py' file.
+✓  Created 'pyproject.toml' file.
+✓  Created 'uipath.json' file.
+💡 Initialize project: uipath init
+💡 Run project: uipath run main '{"message": "Hello World!"}'
+```
+
+Scaffold a coded agent — requires the framework's integration package in the environment:
+
+<!-- termynal -->
+
+```shell
+> uv add uipath-langchain
+Resolved 42 packages in 1.2s
+Installed 42 packages in 0.8s
+
+> uipath new my-agent --type agent
+Using the installed 'langchain' agent framework.
+⠋ Creating new agent my-agent in current directory ...
+✓  Created 'main.py' file.
+✓  Created 'langgraph.json' file.
+✓  Created 'pyproject.toml' file.
+💡 Initialize project: uipath init
+💡 Run agent: uipath run agent '{"topic": "UiPath"}'
+```
+
+---
+
 ::: mkdocs-click
     :module: uipath._cli
     :command: init

packages/uipath/docs/core/agents.md

@@ -17,14 +17,17 @@ Every coded agent is built from two layers:
 
 The `uipath` package is always required. Add one framework extension on top:
 
-| Framework | Package | Best for |
-|-----------|---------|---------|
-| LangChain / LangGraph | `uipath-langchain` | Graph-based agents, complex multi-step flows |
-| LlamaIndex | `uipath-llamaindex` | RAG-heavy agents, document reasoning |
-| OpenAI Agents SDK | `uipath-openai-agents` | OpenAI-native tool use, handoffs |
-| PydanticAI | `uipath-pydantic-ai` | Type-safe agents with Pydantic models |
-| Google ADK | `uipath-google-adk` | Gemini models, Google ecosystem |
-| UiPath Agent Framework | `uipath-agent-framework` | UiPath-native agent primitives |
+| Framework | Package | `--agent-framework` | Best for |
+|-----------|---------|---------------------|---------|
+| LangChain / LangGraph | `uipath-langchain` | `langchain` | Graph-based agents, complex multi-step flows |
+| LlamaIndex | `uipath-llamaindex` | `llamaindex` | RAG-heavy agents, document reasoning |
+| OpenAI Agents SDK | `uipath-openai-agents` | `openai-agents` | OpenAI-native tool use, handoffs |
+| PydanticAI | `uipath-pydantic-ai` | `pydantic-ai` | Type-safe agents with Pydantic models |
+| Google ADK | `uipath-google-adk` | `google-adk` | Gemini models, Google ecosystem |
+| UiPath Agent Framework | `uipath-agent-framework` | `microsoft-agent-framework` | UiPath-native agent primitives |
+| Claude Agent SDK | `uipath-claude-sdk` | `claude-sdk` | Claude models, Anthropic-native agent loop |
+
+The `--agent-framework` column is the value to pass to `uipath new --type agent` when scaffolding explicitly (see the note below the Quickstart).
 
 ---
 
@@ -85,6 +88,14 @@ The example below uses LangChain. Swap `uipath-langchain` for the framework of y
 
 ////
 
+/// info | Explicit project type and framework
+`uipath new` defaults to `--type auto`: the installed agent framework integration claims the scaffold, which is why the commands above create an agent project. To request one explicitly — required when several framework integrations are installed in the same environment — pass the type and framework:
+
+```shell
+uipath new agent --type agent --agent-framework langchain
+```
+///
+
 ---
 
 ## Project Structure

packages/uipath/docs/core/functions.md

@@ -70,6 +70,14 @@ Use coded functions for deterministic compute steps: document extraction, ERP wr
 
 ////
 
+/// info | Guaranteeing a function project
+`uipath new` defaults to `--type auto`: when an agent framework integration (e.g. `uipath-langchain`) is installed in the environment, it scaffolds a coded agent instead of a function. Pass `--type function` to always get a coded function project:
+
+```shell
+uipath new my-function --type function
+```
+///
+
 ---
 
 ## Project Structure

packages/uipath/docs/core/studio_web.md

@@ -171,6 +171,7 @@ First, install the SDK package for the framework you want to use:
 #   uipath-pydantic-ai     - PydanticAI
 #   uipath-google-adk      - Google ADK
 #   uipath-agent-framework - UiPath Agent Framework
+#   uipath-claude-sdk      - Claude Agent SDK
 > uv add uipath-langchain
 Resolved 42 packages in 1.2s
 Installed 42 packages in 0.8s
@@ -190,6 +191,7 @@ Installed 42 packages in 0.8s
 #   uipath-pydantic-ai     - PydanticAI
 #   uipath-google-adk      - Google ADK
 #   uipath-agent-framework - UiPath Agent Framework
+#   uipath-claude-sdk      - Claude Agent SDK
 > pip install uipath-langchain
 Successfully installed uipath-langchain
 ```
@@ -221,9 +223,13 @@ Selected tenant: Tenant1
 
 That's it, your agent should now be visible in Studio Web.
 
+/// info
+`uipath new` defaults to `--type auto`, which lets the installed framework integration claim the scaffold. With several integrations installed, pick one explicitly: `uipath new agent --type agent --agent-framework <framework>`.
+///
+
 #### Coded Function
 
-A coded function doesn't require an additional framework package. Authenticate, scaffold the project, and initialize it:
+A coded function doesn't require an additional framework package. Authenticate, scaffold the project, and initialize it (`--type function` guarantees a function project even when a framework integration is installed):
 
 <!-- termynal -->
 
@@ -238,7 +244,7 @@ Select tenant number: 0
 Selected tenant: Tenant1
 ✓  Authentication successful.
 
-> uipath new my-function
+> uipath new my-function --type function
 ✓  Created 'main.py' file.
 ✓  Created 'pyproject.toml' file.
 ✓  Created 'uipath.json' file.