fix: resolve breakpoint infinite loop in debug streaming with cyclic topologies

- Add checkpoint advancement detection to _get_breakpoint_skip() to correctly
  handle cyclic graphs (GroupChat, handoffs) where executors are visited on
  every cycle
- Merge interrupt.py contents into breakpoints.py (AgentInterruptException,
  BreakpointMiddleware)
- Add breakpoint integration tests for all sample topologies (group-chat,
  quickstart-workflow, concurrent, handoff, hitl-workflow)
- Move agent-framework-orchestrations to main dependencies
- Bump version to 0.0.5
- Fix all mypy errors across src and tests
- Add LangChain integration to root README.md
- Add .vscode/ to .gitignore

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: cristipufu

.gitignore

@@ -179,13 +179,14 @@ cython_debug/
 **/__uipath/
 .claude/settings.local.json
 
-/.vscode/launch.json
+.vscode/
 
 playground.py
 
 # Samples generated files
 **/samples/**/.agent/
 **/samples/**/.claude/
+**/samples/**/.vscode/
 **/samples/**/AGENTS.md
 **/samples/**/CLAUDE.md
 **/samples/**/bindings.json

README.md

@@ -8,10 +8,11 @@ All packages extend the [UiPath Python SDK](https://github.com/UiPath/uipath-pyt
 
 | Framework | Version | Downloads | Links |
 |---|---|---|---|
-| [LlamaIndex](https://www.llamaindex.ai/) | [![PyPI](https://img.shields.io/pypi/v/uipath-llamaindex)](https://pypi.org/project/uipath-llamaindex/) | [![Downloads](https://img.shields.io/pypi/dm/uipath-llamaindex.svg)](https://pypi.org/project/uipath-llamaindex/) | [README](packages/uipath-llamaindex/README.md) · [Docs](https://uipath.github.io/uipath-python/llamaindex/quick_start/) · [Samples](packages/uipath-llamaindex/samples/) |
-| [OpenAI Agents](https://github.com/openai/openai-agents-python) | [![PyPI](https://img.shields.io/pypi/v/uipath-openai-agents)](https://pypi.org/project/uipath-openai-agents/) | [![Downloads](https://img.shields.io/pypi/dm/uipath-openai-agents.svg)](https://pypi.org/project/uipath-openai-agents/) | [README](packages/uipath-openai-agents/README.md) · [Docs](https://uipath.github.io/uipath-python/openai-agents/quick_start/) · [Samples](packages/uipath-openai-agents/samples/) |
 | [Google ADK](https://github.com/google/adk-python) | [![PyPI](https://img.shields.io/pypi/v/uipath-google-adk)](https://pypi.org/project/uipath-google-adk/) | [![Downloads](https://img.shields.io/pypi/dm/uipath-google-adk.svg)](https://pypi.org/project/uipath-google-adk/) | [README](packages/uipath-google-adk/README.md) · [Samples](packages/uipath-google-adk/samples/) |
+| [LangChain](https://github.com/langchain-ai/langchain) | [![PyPI](https://img.shields.io/pypi/v/uipath-langchain)](https://pypi.org/project/uipath-langchain/) | [![Downloads](https://img.shields.io/pypi/dm/uipath-langchain.svg)](https://pypi.org/project/uipath-langchain/) | [README](https://github.com/UiPath/uipath-langchain-python#readme) · [Docs](https://uipath.github.io/uipath-python/langchain/quick_start/) · [Samples](https://github.com/UiPath/uipath-langchain-python/tree/main/samples) |
+| [LlamaIndex](https://www.llamaindex.ai/) | [![PyPI](https://img.shields.io/pypi/v/uipath-llamaindex)](https://pypi.org/project/uipath-llamaindex/) | [![Downloads](https://img.shields.io/pypi/dm/uipath-llamaindex.svg)](https://pypi.org/project/uipath-llamaindex/) | [README](packages/uipath-llamaindex/README.md) · [Docs](https://uipath.github.io/uipath-python/llamaindex/quick_start/) · [Samples](packages/uipath-llamaindex/samples/) |
 | [Microsoft Agent Framework](https://github.com/microsoft/agent-framework) | [![PyPI](https://img.shields.io/pypi/v/uipath-agent-framework)](https://pypi.org/project/uipath-agent-framework/) | [![Downloads](https://img.shields.io/pypi/dm/uipath-agent-framework.svg)](https://pypi.org/project/uipath-agent-framework/) | [README](packages/uipath-agent-framework/README.md) · [Samples](packages/uipath-agent-framework/samples/) |
+| [OpenAI Agents](https://github.com/openai/openai-agents-python) | [![PyPI](https://img.shields.io/pypi/v/uipath-openai-agents)](https://pypi.org/project/uipath-openai-agents/) | [![Downloads](https://img.shields.io/pypi/dm/uipath-openai-agents.svg)](https://pypi.org/project/uipath-openai-agents/) | [README](packages/uipath-openai-agents/README.md) · [Docs](https://uipath.github.io/uipath-python/openai-agents/quick_start/) · [Samples](packages/uipath-openai-agents/samples/) |
 
 
 ## Structure

packages/uipath-agent-framework/pyproject.toml

@@ -1,11 +1,12 @@
 [project]
 name = "uipath-agent-framework"
-version = "0.0.4"
+version = "0.0.5"
 description = "Python SDK that enables developers to build and deploy Microsoft Agent Framework agents to the UiPath Cloud Platform"
 readme = "README.md"
 requires-python = ">=3.11"
 dependencies = [
     "agent-framework-core>=1.0.0b260212",
+    "agent-framework-orchestrations>=1.0.0b260212",
     "aiosqlite>=0.20.0",
     "openinference-instrumentation-agent-framework>=0.1.0",
     "uipath>=2.8.41, <2.9.0",

packages/uipath-agent-framework/samples/concurrent/.vscode/settings.json

@@ -19,7 +19,3 @@ dev = [
 
 [tool.uv]
 prerelease = "allow"
-
-[tool.uv.sources]
-uipath-dev = { path = "../../../../../uipath-dev-python", editable = true }
-uipath-agent-framework = { path = "../../", editable = true }

packages/uipath-agent-framework/samples/concurrent/pyproject.toml

@@ -0,0 +1,18 @@
+flowchart TB
+  __start__(__start__)
+  __end__(__end__)
+  orchestrator(orchestrator)
+  researcher(researcher)
+  researcher_tools(tools)
+  critic(critic)
+  writer(writer)
+  researcher --> researcher_tools
+  researcher_tools --> researcher
+  __start__ --> |input|orchestrator
+  orchestrator --> researcher
+  researcher --> orchestrator
+  orchestrator --> critic
+  critic --> orchestrator
+  orchestrator --> writer
+  writer --> orchestrator
+  orchestrator --> |output|__end__

packages/uipath-agent-framework/samples/group-chat/agent.mermaid

@@ -0,0 +1,24 @@
+flowchart TB
+  __start__(__start__)
+  __end__(__end__)
+  triage(triage)
+  billing_agent(billing_agent)
+  tech_agent(tech_agent)
+  returns_agent(returns_agent)
+  __start__ --> |input|triage
+  triage --> billing_agent
+  triage --> tech_agent
+  triage --> returns_agent
+  billing_agent --> triage
+  billing_agent --> tech_agent
+  billing_agent --> returns_agent
+  tech_agent --> triage
+  tech_agent --> billing_agent
+  tech_agent --> returns_agent
+  returns_agent --> triage
+  returns_agent --> billing_agent
+  returns_agent --> tech_agent
+  triage --> |output|__end__
+  billing_agent --> |output|__end__
+  tech_agent --> |output|__end__
+  returns_agent --> |output|__end__

packages/uipath-agent-framework/samples/handoff/agent.mermaid

@@ -0,0 +1,9 @@
+flowchart TB
+  __start__(__start__)
+  __end__(__end__)
+  weather_agent(weather_agent)
+  weather_agent_tools(tools)
+  weather_agent --> weather_agent_tools
+  weather_agent_tools --> weather_agent
+  __start__ --> |input|weather_agent
+  weather_agent --> |output|__end__

packages/uipath-agent-framework/samples/quickstart-workflow/.vscode/settings.json

@@ -18,7 +18,3 @@ dev = [
 
 [tool.uv]
 prerelease = "allow"
-
-[tool.uv.sources]
-uipath-dev = { path = "../../../../../uipath-dev-python", editable = true }
-uipath-agent-framework = { path = "../../", editable = true }