clean agentex-py and codeartifact

Author: felixs8696

.gitignore

@@ -14,5 +14,3 @@ dist
 .envrc
 codegen.log
 Brewfile.lock.json
-
-.codeartifact-pip-conf

examples/tutorials/00_sync/000_hello_acp/.dockerignore

@@ -41,6 +41,3 @@ venv.bak/
 
 # Misc
 .DS_Store 
-
-# CodeArtifact configuration
-.codeartifact-pip-conf

examples/tutorials/00_sync/000_hello_acp/Dockerfile

@@ -28,10 +28,7 @@ COPY 000_hello_acp/requirements.txt /app/requirements.txt
 WORKDIR /app/
 
 # Install the required Python packages
-RUN --mount=type=secret,id=codeartifact-pip-conf,target=/etc/pip.conf \
-    export UV_INDEX_URL=$(grep -E "^index-url" /etc/pip.conf | cut -d'=' -f2- | xargs) && \
-    export UV_EXTRA_INDEX_URL=$(grep -E "^extra-index-url" /etc/pip.conf | cut -d'=' -f2- | xargs || echo "") && \
-    uv pip install --system -r requirements.txt
+RUN uv pip install --system -r requirements.txt
 
 # Copy the project code
 COPY 000_hello_acp/project /app/project

examples/tutorials/00_sync/000_hello_acp/README.md

@@ -1,128 +1,7 @@
-# hello-sync - AgentEx Starter Template
+# [Sync] Hello ACP
 
-This is a generic starter template for building agents with the AgentEx framework. It provides a basic implementation of the Agent 2 Client Protocol (ACP) to help you get started quickly.
+This is a simple AgentEx agent that just says hello and acknowledges the user's message to show which ACP methods need to be implemented for the sync ACP type.
 
-## What You'll Learn
-
-- **Tasks**: A task is a grouping mechanism for related messages. Think of it as a conversation thread or a session.
-- **Messages**: Messages are communication objects within a task. They can contain text, data, or instructions.
-- **ACP Events**: The agent responds to four main events:
-  - `task_received`: When a new task is created
-  - `task_message_received`: When a message is sent within a task
-  - `task_approved`: When a task is approved
-  - `task_canceled`: When a task is canceled
-
-## Running the Agent
-
-1. Run the agent locally:
-```bash
-agentex agents run --manifest manifest.yaml
-```
-
-The agent will start on port 8000 and print messages whenever it receives any of the ACP events.
-
-## What's Inside
-
-This template:
-- Sets up a basic ACP server
-- Handles each of the required ACP events with simple print statements
-- Provides a foundation for building more complex agents
-
-## Next Steps
-
-For more advanced agent development, check out the AgentEx tutorials:
-
-- **Tutorials 00-08**: Learn about building synchronous agents with ACP
-- **Tutorials 09-10**: Learn how to use Temporal to power asynchronous agents
-  - Tutorial 09: Basic Temporal workflow setup
-  - Tutorial 10: Advanced Temporal patterns and best practices
-
-These tutorials will help you understand:
-- How to handle long-running tasks
-- Implementing state machines
-- Managing complex workflows
-- Best practices for async agent development
-
-## The Manifest File
-
-The `manifest.yaml` file is your agent's configuration file. It defines:
-- How your agent should be built and packaged
-- What files are included in your agent's Docker image
-- Your agent's name and description
-- Local development settings (like the port your agent runs on)
-
-This file is essential for both local development and deployment of your agent.
-
-## Project Structure
-
-```
-hello_sync/
-├── project/                  # Your agent's code
-│   ├── __init__.py
-│   └── acp.py               # ACP server and event handlers
-├── Dockerfile               # Container definition
-├── manifest.yaml            # Deployment config
-└── requirements.txt         # Dependencies
-```
-
-## Development
-
-1. **Customize Event Handlers**
-   - Modify the handlers in `acp.py` to implement your agent's logic
-   - Add your own tools and capabilities
-   - Implement custom state management
-
-2. **Add Dependencies**
-   - Add required packages to `requirements.txt`
-   - Update the manifest with any needed credentials
-
-## Local Development
-
-1. **Install AgentEx**
-```bash
-cd agentex-py
-uv venv
-source .venv/bin/activate
-uv sync
-```
-
-2. **Deploy your agent**
-```bash
-# From this directory
-export ENVIRONMENT=development && agentex agents create --manifest manifest.yaml
-```
-
-4. **Interact with your agent**
-
-Option 0: CLI (deprecated - to be replaced once a new CLI is implemented - please use the web UI for now!)
-```bash
-# Submit a task via CLI
-agentex tasks submit --agent {{ agent_name }} --task "Your task here"
-```
-
-Option 1: Web UI
-```bash
-# Start the local web interface
-cd agentex-web
-make dev
-
-# Then open http://localhost:3000 in your browser to chat with your agent
-```
-
-## Development Tips
-
-1. **Local Testing**
-- Set environment variables in project/.env for any required credentials. OR you can set these in the manifest.yaml
-
-### To build the agent Docker image locally (normally not necessary):
-
-1. First, set up CodeArtifact authentication:
-```bash
-../../setup-build-codeartifact.sh
-```
-
-2. Build the agent image:
-```bash
-agentex agents build --manifest manifest.yaml --secret 'id=codeartifact-pip-conf,src=.codeartifact-pip-conf'
-```
+## Official Documentation
 
+[000 Hello ACP](https://dev.agentex.scale.com/docs/tutorials/sync/000_hello_acp)

examples/tutorials/00_sync/000_hello_acp/manifest.yaml

@@ -19,7 +19,6 @@ build:
 
     # Paths to include in the Docker build context
     # Must include:
-    # - agentex-py: The core framework (needed for agent execution)
     # - Your agent's directory (your custom agent code)
     # These paths are collected and sent to the Docker daemon for building
     include_paths:

examples/tutorials/00_sync/000_hello_acp/pyproject.toml

@@ -0,0 +1,33 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "s000-hello-acp"
+version = "0.1.0"
+description = "An AgentEx agent that just says hello and acknowledges the user's message"
+readme = "README.md"
+requires-python = ">=3.12"
+dependencies = [
+    "agentex-sdk",
+    "scale-gp",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest",
+    "black",
+    "isort",
+    "flake8",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["project"]
+
+[tool.black]
+line-length = 88
+target-version = ['py312']
+
+[tool.isort]
+profile = "black"
+line_length = 88 

examples/tutorials/00_sync/000_hello_acp/requirements.txt

@@ -41,6 +41,3 @@ venv.bak/
 
 # Misc
 .DS_Store 
-
-# CodeArtifact configuration
-.codeartifact-pip-conf

examples/tutorials/00_sync/010_multiturn/.dockerignore

@@ -28,10 +28,7 @@ COPY 010_multiturn/requirements.txt /app/requirements.txt
 WORKDIR /app/
 
 # Install the required Python packages
-RUN --mount=type=secret,id=codeartifact-pip-conf,target=/etc/pip.conf \
-    export UV_INDEX_URL=$(grep -E "^index-url" /etc/pip.conf | cut -d'=' -f2- | xargs) && \
-    export UV_EXTRA_INDEX_URL=$(grep -E "^extra-index-url" /etc/pip.conf | cut -d'=' -f2- | xargs || echo "") && \
-    uv pip install --system -r requirements.txt
+RUN uv pip install --system -r requirements.txt
 
 # Copy the project code
 COPY 010_multiturn/project /app/project

examples/tutorials/00_sync/010_multiturn/Dockerfile

@@ -1,127 +1,7 @@
-# s010-multiturn - AgentEx Starter Template
+# [Sync] Multiturn
 
-This is a generic starter template for building agents with the AgentEx framework. It provides a basic implementation of the Agent 2 Client Protocol (ACP) to help you get started quickly.
+This tutorial demonstrates how to handle multiturn conversations in AgentEx agents using the Agent 2 Client Protocol (ACP).
 
-## What You'll Learn
+## Official Documentation
 
-- **Tasks**: A task is a grouping mechanism for related messages. Think of it as a conversation thread or a session.
-- **Messages**: Messages are communication objects within a task. They can contain text, data, or instructions.
-- **ACP Events**: The agent responds to four main events:
-  - `task_received`: When a new task is created
-  - `task_message_received`: When a message is sent within a task
-  - `task_approved`: When a task is approved
-  - `task_canceled`: When a task is canceled
-
-## Running the Agent
-
-1. Run the agent locally:
-```bash
-agentex agents run --manifest manifest.yaml
-```
-
-The agent will start on port 8000 and print messages whenever it receives any of the ACP events.
-
-## What's Inside
-
-This template:
-- Sets up a basic ACP server
-- Handles each of the required ACP events with simple print statements
-- Provides a foundation for building more complex agents
-
-## Next Steps
-
-For more advanced agent development, check out the AgentEx tutorials:
-
-- **Tutorials 00-08**: Learn about building synchronous agents with ACP
-- **Tutorials 09-10**: Learn how to use Temporal to power asynchronous agents
-  - Tutorial 09: Basic Temporal workflow setup
-  - Tutorial 10: Advanced Temporal patterns and best practices
-
-These tutorials will help you understand:
-- How to handle long-running tasks
-- Implementing state machines
-- Managing complex workflows
-- Best practices for async agent development
-
-## The Manifest File
-
-The `manifest.yaml` file is your agent's configuration file. It defines:
-- How your agent should be built and packaged
-- What files are included in your agent's Docker image
-- Your agent's name and description
-- Local development settings (like the port your agent runs on)
-
-This file is essential for both local development and deployment of your agent.
-
-## Project Structure
-
-```
-s010_multiturn/
-├── project/                  # Your agent's code
-│   ├── __init__.py
-│   └── acp.py               # ACP server and event handlers
-├── Dockerfile               # Container definition
-├── manifest.yaml            # Deployment config
-└── requirements.txt         # Dependencies
-```
-
-## Development
-
-1. **Customize Event Handlers**
-   - Modify the handlers in `acp.py` to implement your agent's logic
-   - Add your own tools and capabilities
-   - Implement custom state management
-
-2. **Add Dependencies**
-   - Add required packages to `requirements.txt`
-   - Update the manifest with any needed credentials
-
-## Local Development
-
-1. **Install AgentEx**
-```bash
-cd agentex-py
-uv venv
-source .venv/bin/activate
-uv sync
-```
-
-2. **Deploy your agent**
-```bash
-# From this directory
-export ENVIRONMENT=development && agentex agents create --manifest manifest.yaml
-```
-
-4. **Interact with your agent**
-
-Option 0: CLI (deprecated - to be replaced once a new CLI is implemented - please use the web UI for now!)
-```bash
-# Submit a task via CLI
-agentex tasks submit --agent {{ agent_name }} --task "Your task here"
-```
-
-Option 1: Web UI
-```bash
-# Start the local web interface
-cd agentex-web
-make dev
-
-# Then open http://localhost:3000 in your browser to chat with your agent
-```
-
-## Development Tips
-
-1. **Local Testing**
-- Set environment variables in project/.env for any required credentials. OR you can set these in the manifest.yaml
-
-### To build the agent Docker image locally (normally not necessary):
-
-1. First, set up CodeArtifact authentication:
-```bash
-../../setup-build-codeartifact.sh
-```
-
-2. Build the agent image:
-```bash
-agentex agents build --manifest manifest.yaml --secret 'id=codeartifact-pip-conf,src=.codeartifact-pip-conf'
-```
+[010 Multiturn](https://dev.agentex.scale.com/docs/tutorials/sync/010_multiturn)