Merge branch 'main' into stas/trace-agentex-source

Author: smoreinis

.github/workflows/ci.yml

@@ -42,7 +42,7 @@ jobs:
     permissions:
       contents: read
       id-token: write
-    runs-on: depot-ubuntu-24.04
+    runs-on: ${{ github.repository == 'stainless-sdks/agentex-sdk-python' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     steps:
       - uses: actions/checkout@v4
 

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.4.10"
+  ".": "0.4.12"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 34
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/sgp%2Fagentex-sdk-4e747d1e081a07dcd47f7aaed0a8fc18c748658d4c8875f793daf4850e74b47c.yml
-openapi_spec_hash: 3a159d7dc86cae47945e678009a197be
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/sgp%2Fagentex-sdk-6eec9554350594d13aa61f6d3c384a54cbaba95481ee06c228a9d0a0aefaeda8.yml
+openapi_spec_hash: 63770414d1be9807d9b7ebbef0ae9fee
 config_hash: aeabb3a919ad2763f5d0f41961a2520a

CHANGELOG.md

@@ -1,5 +1,43 @@
 # Changelog
 
+## 0.4.12 (2025-09-08)
+
+Full Changelog: [v0.4.11...v0.4.12](https://github.com/scaleapi/agentex-python/compare/v0.4.11...v0.4.12)
+
+### ⚠ BREAKING CHANGES
+
+* task_cancel now requires explicit agent_name/agent_id parameter to identify which agent owns the task being cancelled
+
+### Bug Fixes
+
+* task cancellation architectural bug ([f9a72a9](https://github.com/scaleapi/agentex-python/commit/f9a72a94f96afe86d3cc80f4f85ea368279d4517))
+
+## 0.4.11 (2025-09-04)
+
+Full Changelog: [v0.4.10...v0.4.11](https://github.com/scaleapi/agentex-python/compare/v0.4.10...v0.4.11)
+
+### Features
+
+* Guardrail support ([e3e9bf9](https://github.com/scaleapi/agentex-python/commit/e3e9bf9dd6cf16b9a783638690d4a31914be8139))
+* improve future compat with pydantic v3 ([f0d8624](https://github.com/scaleapi/agentex-python/commit/f0d86244065c88bb2777db8fabeb1921e7e01116))
+* multiple guardrails ([ea8f98a](https://github.com/scaleapi/agentex-python/commit/ea8f98a973ba486e854cf14528a88eb73a203cf8))
+* **templates:** add custom activity timeout guidance for temporal agents ([7658256](https://github.com/scaleapi/agentex-python/commit/765825680132677ea0351f2a9410f472ee754906))
+* **types:** replace List[str] with SequenceNotStr in params ([f319781](https://github.com/scaleapi/agentex-python/commit/f3197818637574cd92b2c1f710679155eddf5af7))
+
+
+### Bug Fixes
+
+* Adding new example for guardrails instead of using 10_agentic ([15dc44b](https://github.com/scaleapi/agentex-python/commit/15dc44b333a977564c9974cc089d5ef578840714))
+* avoid newer type syntax ([6b5c82a](https://github.com/scaleapi/agentex-python/commit/6b5c82aab9ebcf755575b641aced2b77a13a71c3))
+
+
+### Chores
+
+* **internal:** add Sequence related utils ([496034d](https://github.com/scaleapi/agentex-python/commit/496034db4d6cba361c1f392a4bb86f6ab057e878))
+* **internal:** change ci workflow machines ([7445d94](https://github.com/scaleapi/agentex-python/commit/7445d94cb860f92911ec97ecd951149557956c6a))
+* **internal:** move mypy configurations to `pyproject.toml` file ([e96cd34](https://github.com/scaleapi/agentex-python/commit/e96cd34629d5ea173446c3184fbfe28bd2b370a0))
+* **internal:** update pyright exclude list ([d952430](https://github.com/scaleapi/agentex-python/commit/d952430ab4cbc41bca06010bbcfea3eeb022073e))
+
 ## 0.4.10 (2025-08-24)
 
 Full Changelog: [v0.4.9...v0.4.10](https://github.com/scaleapi/agentex-python/compare/v0.4.9...v0.4.10)

examples/tutorials/10_agentic/10_temporal/050_agent_chat_guardrails/.dockerignore

@@ -0,0 +1,43 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Environments
+.env**
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Git
+.git
+.gitignore
+
+# Misc
+.DS_Store 

examples/tutorials/10_agentic/10_temporal/050_agent_chat_guardrails/Dockerfile

@@ -0,0 +1,46 @@
+# syntax=docker/dockerfile:1.3
+FROM python:3.12-slim
+COPY --from=ghcr.io/astral-sh/uv:0.6.4 /uv /uvx /bin/
+
+# Install system dependencies
+RUN apt-get update && apt-get install -y \
+    htop \
+    vim \
+    curl \
+    tar \
+    python3-dev \
+    postgresql-client \
+    build-essential \
+    libpq-dev \
+    gcc \
+    cmake \
+    netcat-openbsd \
+    && apt-get clean \
+    && rm -rf /var/lib/apt/lists/*
+
+# Install tctl (Temporal CLI)
+RUN curl -L https://github.com/temporalio/tctl/releases/download/v1.18.1/tctl_1.18.1_linux_arm64.tar.gz -o /tmp/tctl.tar.gz && \
+    tar -xzf /tmp/tctl.tar.gz -C /usr/local/bin && \
+    chmod +x /usr/local/bin/tctl && \
+    rm /tmp/tctl.tar.gz
+
+RUN uv pip install --system --upgrade pip setuptools wheel
+
+ENV UV_HTTP_TIMEOUT=1000
+
+# Copy just the requirements file to optimize caching
+COPY 010_agent_chat/requirements.txt /app/requirements.txt
+
+WORKDIR /app/
+
+# Install the required Python packages
+RUN uv pip install --system -r requirements.txt
+
+# Copy the project code
+COPY 010_agent_chat/project /app/project
+
+# Run the ACP server using uvicorn
+CMD ["uvicorn", "project.acp:acp", "--host", "0.0.0.0", "--port", "8000"]
+
+# When we deploy the worker, we will replace the CMD with the following
+# CMD ["python", "-m", "run_worker"] 

examples/tutorials/10_agentic/10_temporal/050_agent_chat_guardrails/README.md

@@ -0,0 +1,42 @@
+# [Agentic] Agent Chat with Guardrails
+
+This tutorial demonstrates how to implement streaming multiturn tool-enabled chat with input and output guardrails using Temporal workflows in AgentEx agents.
+
+## Overview
+
+This example extends the basic agent chat functionality by adding guardrails that can filter both user inputs and AI outputs. This is useful for content moderation, compliance, or preventing certain topics from being discussed.
+
+## Guardrails
+
+### Input Guardrails
+- **Spaghetti Guardrail**: Blocks any mention of "spaghetti" in user messages
+- **Soup Guardrail**: Blocks any mention of "soup" in user messages
+
+### Output Guardrails  
+- **Pizza Guardrail**: Prevents the AI from mentioning "pizza" in responses
+- **Sushi Guardrail**: Prevents the AI from mentioning "sushi" in responses
+
+## Testing the Guardrails
+
+To see the guardrails in action:
+
+1. **Test Input Guardrails:**
+   - Try: "Tell me about spaghetti" 
+   - Try: "What's your favorite soup?"
+   - The guardrails will block these messages before they reach the AI
+
+2. **Test Output Guardrails:**
+   - Ask: "What are popular Italian foods?" (may trigger pizza guardrail)
+   - Ask: "What are popular Japanese foods?" (may trigger sushi guardrail)
+   - The AI may generate responses containing these words, but the guardrails will block them
+
+## Implementation Details
+
+The guardrails are implemented as functions that:
+- Check the input/output for specific content
+- Return a `GuardrailFunctionOutput` with:
+  - `tripwire_triggered`: Whether to block the content
+  - `output_info`: Metadata about the check
+  - `rejection_message`: Custom message shown when content is blocked
+
+See `workflow.py` for the complete implementation.