feat: update docs

Author: eliasecchig

agents/README.md

@@ -0,0 +1,5 @@
+# Agent Templates
+
+The agent implementations in this directory are templates that are meant to be used with the Agent Starter Pack templating engine. You should not clone this repository directly to use them.
+
+Please follow the instructions in the main [README](/README.md) to install the templating engine and get started.

docs/cli/create.md

@@ -22,6 +22,7 @@ The following options will be prompted interactively if not provided via the com
 - `--deployment-target`, `-d`: Deployment target (`agent_engine` or `cloud_run`). Prompts if omitted.
 - `--datastore`, `-ds`: Datastore for RAG agents (`vertex_ai_search` or `vertex_ai_vector_search`). Prompted if `--include-data-ingestion` is specified, or if the selected agent (e.g., `agentic_rag`) requires data ingestion, and this option is omitted.
 - `--region`: GCP region for deployment (default: `us-central1`). Prompts for confirmation if not specified and `--auto-approve` is not used.
+- `--session-type`: Type of session storage to use (`in_memory` or `alloydb`). This is only applicable for agents that require session management and when the deployment target is `cloud_run`.
 
 GCP account and project ID are detected automatically (using your active `gcloud config` settings). You will be prompted to confirm or change them unless `--auto-approve` is used.
 

llm.txt

@@ -69,6 +69,7 @@ agent-starter-pack create PROJECT_NAME [OPTIONS]
 *   `-d, --deployment-target`: Target deployment environment (`cloud_run` or `agent_engine`).
 *   `-ds, --datastore`: For RAG agents, the datastore (`vertex_ai_search` or `vertex_ai_vector_search`).
 *   `-i, --include-data-ingestion`: Include data ingestion pipeline scaffolding.
+*   `--session-type`: For agents requiring session management on Cloud Run, specifies the storage type (`in_memory` or `alloydb`).
 *   `--region`: GCP region (e.g., `us-central1`).
 *   `--auto-approve`: **Skips all interactive prompts (crucial for automation).**
 *   `--debug`: Enables debug logging during creation.
@@ -186,6 +187,12 @@ uvx agent-starter-pack setup-cicd
 *   **Deploying with UI:** `make backend IAP=true`
 *   **Access Control:** After deploying with IAP, grant users the `IAP-secured Web App User` role in IAM to give them access.
 
+### Session Management
+
+For stateful agents, the starter pack supports persistent sessions.
+*   **Cloud Run:** Choose between `in_memory` (for testing) and durable `alloydb` sessions using the `--session-type` flag.
+*   **Agent Engine:** Provides session management automatically.
+
 ### Monitoring & Observability
 *   **Technology:** Uses OpenTelemetry to emit events to Google Cloud Trace and Logging.
 *   **Custom Tracer:** A custom tracer in `app/utils/tracing.py` handles large payloads by linking to GCS, overcoming default service limits.