v1.501.0

We're excited to announce Solace Agent Mesh Helm Charts v1.501.0, featuring bug fixes and image updates.

Bug Fixes

• fix(DATAGO-136350): Default EVAL_DATA_BUCKET_NAME so Quickstart K8s installs retain eval artifacts
• fix(DATAGO-136202): Add artifact_service to platform_service config

Component Updates

Component	Previous	Current
solace-agent-mesh-enterprise	1.500.0	1.514.0
sam-agent-deployer	1.8.2	1.8.2

Helm Chart Versions

Chart	Version	Description
solace-agent-mesh	1.501.0	Main platform chart
sam-agent	1.501.0	Agent/gateway sidecar chart (used by agent deployer)

• Requirements: Helm v3.x
• Repository: solace-agent-mesh-helm-quickstart

Getting Started

For installation instructions and configuration options, refer to the documentation.

v1.500.0

We're excited to announce Solace Agent Mesh Helm Charts v1.500.0, featuring a major chart refactor, chart version alignment with the enterprise image, and a critical gateway fix.

Key Features in This Release

Chart Version Alignment

• Helm chart versions now track the enterprise image version — solace-agent-mesh and sam-agent charts are both versioned at 1.500.0, matching the bundled enterprise image. This makes it easy to know which enterprise release a given chart ships.

Component Updates

Component	Previous	Current
solace-agent-mesh-enterprise	1.211.0	1.500.0
sam-agent-deployer	1.8.2	1.8.2

Upgrade Notes

This release introduces changes to default Helm values. Before upgrading, review the Migration Guide to understand which default values have changed and update your values.yaml overrides accordingly.

Helm Chart Versions

Chart	Version	Description
solace-agent-mesh	1.500.0	Main platform chart
sam-agent	1.500.0	Agent/gateway sidecar chart (used by agent deployer)

• Requirements: Helm v3.x
• Repository: solace-agent-mesh-helm-quickstart

Getting Started

For installation instructions and configuration options, refer to the documentation.

v1.2.7

We're excited to announce Solace Agent Mesh Helm Charts v1.2.7, featuring an enterprise image update and a critical bug fix for artifact service wiring.

Key Features in This Release

Bug Fixes

• Artifact Service Fix — Wired artifact_service into the platform_service component config (DATAGO-135035). Previously, platform_service was the only top-level app in the chart without an artifact_service block, causing eval pipeline artifacts to record snapshot_failed with artifact_service_unavailable. This release fixes the omission so artifact snapshotting works correctly for all components.

Component Updates

Component	Previous	Current
solace-agent-mesh-enterprise	1.171.0	1.211.0
sam-agent-deployer	1.8.2	1.8.2

Helm Chart Versions

Chart	Version	Description
solace-agent-mesh	1.2.7	Main platform chart
sam-agent	1.2.5	Agent/gateway sidecar chart (used by agent deployer)

• Requirements: Helm v3.x
• Repository: solace-agent-mesh-helm-quickstart

Getting Started

For installation instructions and configuration options, refer to the documentation.

v1.2.6

We're excited to announce Solace Agent Mesh Helm Charts v1.2.6, featuring a major enterprise image update and internal CI/CD improvements.

Key Features in This Release

Component Updates

• Enterprise Image — Updated solace-agent-mesh-enterprise from 1.143.0 to 1.171.0, bringing 28 versions of improvements, bug fixes, and new capabilities to the platform

Bug Fixes

• Component Name — Corrected component naming (DATAGO-132663)

Component Updates

Component	Previous	Current
solace-agent-mesh-enterprise	1.143.0	1.171.0
sam-agent-deployer	1.8.2	1.8.2

Helm Chart Versions

Chart	Version	Description
solace-agent-mesh	1.2.6	Main platform chart
sam-agent	1.2.5	Agent/gateway sidecar chart (used by agent deployer)

• Requirements: Helm v3.x
• Repository: solace-agent-mesh-helm-quickstart

Getting Started

For installation instructions and configuration options, refer to the documentation.

v1.2.5

We're excited to announce Solace Agent Mesh Helm Charts v1.2.5, featuring new agent/gateway configuration options, environment variable propagation, and updated component images.

Key Features in This Release

Agent & Gateway Configuration

• Model Provider Support — Added model_provider configuration to agent and gateway definitions, enabling explicit model provider selection per agent/gateway
• Gateway Service — Added a Kubernetes Service resource for gateways in the Helm chart
• Environment Variable Propagation — Main chart environment variables are now propagated to agent pods, improving configuration consistency across deployments

Configuration

• Project Sharing — Migrated project_sharing flag to environment variable override for more flexible deployment configuration

Component Updates

Component	Previous	Current
solace-agent-mesh-enterprise	1.97.2	1.143.0
sam-agent-deployer	1.7.0	1.8.2

Helm Chart Versions

Chart	Version	Description
solace-agent-mesh	1.2.5	Main platform chart
sam-agent	1.2.5	Agent/gateway sidecar chart (used by agent deployer)

• Requirements: Helm v3.x
• Repository: solace-agent-mesh-helm-quickstart

Getting Started

For installation instructions and configuration options, refer to the documentation.

v1.2.4

We're excited to announce Solace Agent Mesh Helm Charts v1.2.4, featuring Azure and GCS object storage support, and enhanced file processing capabilities.

Key Features in This Release

Multi-Cloud Object Storage Support

• Azure Blob Storage support — Configure SAM to use Azure Blob Storage for artifact persistence
• Google Cloud Storage (GCS) support — Configure SAM to use GCS buckets for artifact persistence

Enhanced File Processing

• File processing feature flags — New configuration options for enhanced file processing capabilities

Agent Deployer Improvements

• Skip ServiceAccount creation in deployer mode — Agent chart now properly skips ServiceAccount creation when running in deployer mode

Bug Fixes

• Fixed ServiceAccount creation logic in agent chart deployer mode

Documentation

• Added documentation around global persistence namespace ID
• Fixed config.yaml key references and added deployer mode documentation

Component Updates

Component	Previous	Current
solace-agent-mesh-enterprise	1.83.1	1.97.2
sam-agent-deployer	1.6.3	1.7.0

Upgrade Notes

No breaking changes. This is a drop-in upgrade from v1.2.3.

Helm Chart Versions

Chart	Version	Description
solace-agent-mesh	1.2.4	Main platform chart
sam-agent	1.2.4	Agent/gateway sidecar chart (used by agent deployer)

• Requirements: Helm v3.x
• Repository: solace-agent-mesh-helm-quickstart

Getting Started

For installation instructions and configuration options, refer to the documentation.

v1.2.3

We're excited to announce Solace Agent Mesh Helm Charts v1.2.3, featuring a critical bug fix for agent deployments and CORS configuration improvements.

Key Features in This Release

CORS Configuration

• WebUI gateway CORS support — Added cors_allowed_origin_regex to WebUI gateway config for local development scenarios
• Fixed port-forward commands and URLs in local values files

Bug Fixes

• Fixed NAMESPACE env var in agent chart — Agent deployments now use the logical namespaceId instead of K8s namespace, preventing deployments from getting stuck when K8s namespace differs from SAM namespace
• Fixed variable naming — Updated dockerRegistrySecret to registrySecretName for consistency with sam-enterprise codebase

Component Updates

Component	Previous	Current
solace-agent-mesh-enterprise	1.78.9	1.83.1

Upgrade Notes

No breaking changes. This is a drop-in upgrade from v1.2.2.

Important: If you have agent deployments where the K8s namespace differs from your SAM namespaceId, this upgrade will fix heartbeat/deployment issues.

Helm Chart Versions

Chart	Version	Description
solace-agent-mesh	1.2.3	Main platform chart
sam-agent	1.2.3	Agent/gateway sidecar chart (used by agent deployer)

• Requirements: Helm v3.x
• Repository: solace-agent-mesh-helm-quickstart

Getting Started

For installation instructions and configuration options, refer to the documentation.

v1.2.2

We're excited to announce Solace Agent Mesh Helm Charts v1.2.2, a patch release with a template bug fix and CI improvements.

Bug Fixes

• Fixed extra end in agent deployer YAML template

CI/CD

• Added Helm lint and template validation CI workflow

Component Updates

Component	Previous	Current
solace-agent-mesh-enterprise	1.78.9	1.78.9
sam-agent-deployer	1.6.3	1.6.3

Upgrade Notes

No breaking changes. This is a drop-in upgrade from v1.2.1.

Helm Chart Versions

Chart	Version	Description
solace-agent-mesh	1.2.1	Main platform chart
sam-agent	1.2.2	Agent/gateway sidecar chart (used by agent deployer)

• Requirements: Helm v3.x
• Repository: solace-agent-mesh-helm-quickstart

Getting Started

For installation instructions and configuration options, refer to the documentation.

v1.2.1

We're excited to announce Solace Agent Mesh Helm Charts v1.2.1, a patch release with offline deployment support, updated enterprise image, and several bug fixes.

Key Features in This Release

Offline / Air-Gapped Deployment

• Bundled Agent Chart — The agent deployer now ships with a local copy of the sam-agent chart via ConfigMap, enabling deployments in air-gapped environments without internet access to Helm repositories

Project Sharing

• Project Sharing Configurations — New configuration support for project sharing features

Custom Role Mappings

• IDP Claim-to-Role Mappings — Support for custom roles and IDP claim-to-role mappings in OIDC configurations

Bug Fixes

• Fixed NAMESPACE to use logical namespaceId for broker topics
• Fixed bug with SAM role mappings
• Removed unused sam.enterprise flag from Helm chart

Component Updates

Component	Previous	Current
solace-agent-mesh-enterprise	1.65.45	1.78.9
sam-agent-deployer	1.6.3	1.6.3

Upgrade Notes

No breaking changes. This is a drop-in upgrade from v1.2.0.

Documentation

• Updated network configuration documentation
• Updated introduction page

Helm Chart Versions

Chart	Version	Description
solace-agent-mesh	1.2.1	Main platform chart
sam-agent	1.2.2	Agent/gateway sidecar chart (used by agent deployer)

• Requirements: Helm v3.x
• Repository: solace-agent-mesh-helm-quickstart

Getting Started

For installation instructions and configuration options, please refer to the documentation.

v1.2.0

We're excited to announce Solace Agent Mesh Helm Charts v1.2.0, a major release introducing unified agent and gateway deployments, platform service integration, health probes, enhanced logging, and significant infrastructure improvements.

Key Features in This Release

Unified Agent & Gateway Helm Chart

• Single Chart for Agents and Gateways - The sam-agent chart now deploys both agents and gateways, replacing the need for separate charts
• Backward Compatible - Existing agentId and config.agentYaml values continue to work alongside new id and config.yaml parameters
• Component Type Labels - Gateway deployments now include componentType labels for easier identification

Platform Service Integration

• Platform API Routing - New platform service with dedicated port (8001) and automatic ingress path configuration (/api/v1/platform/*)
• Auto-Configured Ingress Paths - New ingress.autoConfigurePaths option (enabled by default) automatically generates all required ingress rules for WebUI, Auth, and Platform services
• CORS Configuration - Added sam.cors.allowedOriginRegex for configuring cross-origin access to the Platform Service
• URL Overrides - New sam.frontendServerUrl and sam.platformServiceUrl values for local development scenarios

Kubernetes Health Probes

• HTTP Health Checks - Added HTTP-based startup, readiness, and liveness probes for both sam-core (port 8088) and agent-deployer (port 8089), replacing previous script-based checks
• Improved Reliability - Kubernetes can now automatically detect and restart unhealthy SAM pods

Pro Code Deployment

• CLI-Based Deployment - Support for deploying agents via pro code workflows alongside the existing visual builder

OAuth Token Caching

• JWT-Based Authentication - The chart now enables sam_access_token (self-signed JWT) by default, eliminating external OAuth validation calls on every API request
• Improved Performance Under Load - Prevents OAuth service saturation that previously caused timeout errors with concurrent users

Enhanced Logging

• Structured Logging - Added logging configuration via ConfigMap with JSON and simple formatters
• Configurable Log Levels - Per-module log levels for solace_ai_connector, solace_agent_mesh, and sam_trace
• Rotating File Handler - File-based logging with rotation (50 MB max, 10 backups)

Task Logging & Hybrid Buffer

• Task Logging - New sam.taskLogging configuration for tracking task status updates and file parts
• Hybrid Buffer - Buffered write support with configurable flush threshold for improved performance

Agent Deployer Improvements

• Deployer Versioning - New DEPLOYER_VERSION environment variable enables coordinated redeployments across all agents
• File-Based Configuration - Agent deployer now supports file-based configuration
• Idempotent Undeploy - UNDEPLOY_COMMAND no longer fails if the release doesn't exist

Persistence Layer Updates

• SeaweedFS Volume Exhaustion Fix - Updated persistence-layer to resolve "No writable volumes and no free volumes left" errors by increasing max volumes (8 → 100) and adjusting volume size limits
• Safe VCT Upgrades - VolumeClaimTemplate upgrades no longer cause data loss
• S3 Connector Specs Bucket - New dataStores.s3.connectorSpecBucketName for storing connector specifications separately

Security Hardening

• Non-Root Enforcement - All containers now always run as runAsUser: 999, runAsGroup: 999, runAsNonRoot: true, regardless of custom securityContext values

Component Updates

Component	Previous	Current
solace-agent-mesh-enterprise	v1.24.1	1.65.45
sam-agent-deployer	1.1.4	1.6.3
persistence-layer	1.6.0	1.7.1
sam-agent chart	1.1.0	1.2.2

Upgrade Notes

Bundled Persistence Migration (Required)

If you are upgrading from chart version ≤1.1.0 with bundled persistence, a one-time migration is required. The persistence-layer now uses minimal VolumeClaimTemplate (VCT) labels to prevent future upgrade failures. Since Kubernetes VCT labels are immutable, existing StatefulSets must be recreated.

Without this migration, helm upgrade will fail with:

StatefulSet.apps "xxx-postgresql" is invalid: spec: Forbidden: updates to statefulset spec
for fields other than 'replicas', 'ordinals', 'template', 'updateStrategy'... are forbidden

Migration steps (data is preserved):

# Step 1: Delete StatefulSets while preserving PVCs
kubectl delete sts <release>-postgresql <release>-seaweedfs --cascade=orphan -n <namespace>

# Step 2: Upgrade the Helm release
helm upgrade <release> solace-agent-mesh/solace-agent-mesh -f your-values.yaml -n <namespace>

New StatefulSets will automatically reattach to existing PVCs — no data is lost.

Ingress Configuration Changes

The ingress configuration has been simplified. The new autoConfigurePaths: true (default) automatically sets up all required routes. If you previously had custom ingress.hosts entries, the chart will continue to work, but you can simplify by switching to:

ingress:
  autoConfigurePaths: true
  host: "sam.example.com"  # optional, replaces hosts[].host

NodePort Configuration

New NodePort options have been added for the Platform Service:

service:
  nodePorts:
    platformHttp: ""
    platformHttps: ""

TLS Configuration

A new service.tls.existingSecret option allows referencing an existing Kubernetes TLS secret instead of providing cert/key inline.

sam-agent Chart: Renamed Parameters

The following parameters have been renamed (old names still work for backward compatibility):

Old	New
agentId	id
config.agentYaml	config.yaml

Documentation

• Added workflow deployment documentation
• Updated standalone deployment guide to cover both agents and gateways
• Updated S3 bucket documentation for connector specs and artifacts
• Added platform service port forwarding instructions
• Added sam_user role permissions documentation
• Added troubleshooting guide for StatefulSet VCT upgrade errors

Chart Information

• solace-agent-mesh: 1.2.0
• sam-agent: 1.2.2
• Requirements: Helm v3.x
• Repository: solace-agent-mesh-helm-quickstart

Getting Started

For installation instructions and configuration options, please refer to the documentation.