Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# Zelkor Platform

[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)
[![Chart](https://img.shields.io/badge/chart-2.5.3-informational)](charts/zelkor-platform/Chart.yaml)
[![Chart](https://img.shields.io/badge/chart-2.5.4-informational)](charts/zelkor-platform/Chart.yaml)

You get **the self-hosted agent runtime** on your Kubernetes cluster: bring the agent you already wrote — it can't break out, reach unauthorized data or networks, its prompts are verified, budget controlled, and it is under observation; tenants stay isolated.

Expand All @@ -17,7 +17,7 @@ cd zelkor-platform
OPENAI_API_KEY=sk-... ./install.sh
```

`./install.sh` creates a local kind cluster, installs Zelkor Community Edition (chart `2.5.3`), and prints URLs when it finishes. Full prerequisites, other providers, and the first verification call: [Local Quickstart](docs/quickstart.md).
`./install.sh` creates a local kind cluster, installs Zelkor Community Edition (chart `2.5.4`), and prints URLs when it finishes. Full prerequisites, other providers, and the first verification call: [Local Quickstart](docs/quickstart.md).

## What you set

Expand Down
3 changes: 2 additions & 1 deletion THIRD_PARTY_NOTICES.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ updated whenever component pins change (see
`internal/plan/component_compatibility_matrix.md` for the authoritative pin
inventory; the CE-8a image scan SBOM is the exhaustive transitive list).

**As of CE `2.5.3`** (2026-11-17).
**As of CE `2.5.4`** (2026-11-17).

## Distribution paths

Expand Down Expand Up @@ -90,3 +90,4 @@ inventory; the CE-8a image scan SBOM is the exhaustive transitive list).
| 2026-11-16 | CE `2.5.0`: no third-party pin changes in shipped images or charts. Release tooling (cosign, syft, crane, Kyverno policy for opt-in admission) runs in CI or the customer's cluster and is not redistributed. |
| 2026-11-17 | CE `2.5.1`: no third-party pin changes (release workflow fix only). |
| 2026-11-17 | CE `2.5.3`: OpenTelemetry SDK/exporter 1.45.1 → 1.45.2 and instrumentation 0.66b1 → 0.66b2 in `zelkor-guardrails`, `zelkor-sidecar`, `zelkor-aegra` (CVE-2026-126360). Same license (Apache-2.0) and distribution path (embedded); CE-18 a–g unchanged. Guardrails self-check change (#133) adds no third-party component. 2.5.2 was not released. |
| 2026-11-17 | CE `2.5.4`: no third-party pin changes (guardrails self-check trace tags, timeout default, onUnavailable). |
4 changes: 2 additions & 2 deletions charts/zelkor-agent/Chart.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -2,5 +2,5 @@ apiVersion: v2
name: zelkor-agent
description: ClusterIP worker for one or more graphs in one image. Self-registers via sharedRoute HTTPRoute when host + gateway are set. CLI workers use zelkor-aegra-deep.
type: application
version: 2.5.3
appVersion: "2.5.3"
version: 2.5.4
appVersion: "2.5.4"
4 changes: 2 additions & 2 deletions charts/zelkor-agent/values.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ redis:

image:
repository: ghcr.io/devopssquaddev/zelkor-aegra
tag: "2.5.3"
tag: "2.5.4"
digest: ""
pullPolicy: ""

Expand All @@ -54,7 +54,7 @@ runtime: aegra
sidecar:
image:
repository: ghcr.io/devopssquaddev/zelkor-sidecar
tag: "2.5.3"
tag: "2.5.4"
digest: ""
pullPolicy: ""
# CE-15a-2 perimeter: run the sidecar stateless (in-memory store, no Postgres, no migrate
Expand Down
4 changes: 2 additions & 2 deletions charts/zelkor-gateway-policies/Chart.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -2,5 +2,5 @@ apiVersion: v2
name: zelkor-gateway-policies
description: Envoy Gateway pod ingress policies (K11 control 1)
type: application
version: 2.5.3
appVersion: "2.5.3"
version: 2.5.4
appVersion: "2.5.4"
4 changes: 2 additions & 2 deletions charts/zelkor-platform/Chart.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -2,5 +2,5 @@ apiVersion: v2
name: zelkor-platform
description: Unified Helm chart for the Zelkor Platform Base Tier
type: application
version: 2.5.3
appVersion: "2.5.3"
version: 2.5.4
appVersion: "2.5.4"
Original file line number Diff line number Diff line change
@@ -1,21 +1,26 @@
{{- $inMode := include "zelkor-platform.nemoSelfCheckMode" (dict "root" . "side" "input") }}
{{- $outMode := include "zelkor-platform.nemoSelfCheckMode" (dict "root" . "side" "output") }}
{{- $timeout := (.Values.guardrails.nemo.selfCheck | default dict).timeoutMs | default 1500 | int }}
{{- $sc := .Values.guardrails.nemo.selfCheck | default dict }}
{{- $timeout := $sc.timeoutMs | default 5000 | int }}
{{- $onUnavailable := $sc.onUnavailable | default "allow" | toString }}
{{- if not (has $onUnavailable (list "allow" "block")) }}
{{- fail (printf "workspace.policies.nemo.selfCheck.onUnavailable must be allow or block (got %q)" $onUnavailable) }}
{{- end }}
define bot refuse to respond
{{ .Values.guardrails.nemo.safetyRefusal | default "I can't help with that request." | quote }}
{{- if ne $inMode "none" }}

# zelkor_self_check returns {blocked, verdict, status}; blocked is true only in block mode.
# zelkor_self_check returns {blocked, verdict, status, mode, enforced}; blocked only in block mode.
define flow self check input
$verdict = execute zelkor_self_check(side="input", mode="{{ $inMode }}", timeout_ms={{ $timeout }})
$verdict = execute zelkor_self_check(side="input", mode="{{ $inMode }}", timeout_ms={{ $timeout }}, on_unavailable="{{ $onUnavailable }}")
if $verdict.blocked
bot refuse to respond
stop
{{- end }}
{{- if ne $outMode "none" }}

define flow self check output
$verdict = execute zelkor_self_check(side="output", mode="{{ $outMode }}", timeout_ms={{ $timeout }})
$verdict = execute zelkor_self_check(side="output", mode="{{ $outMode }}", timeout_ms={{ $timeout }}, on_unavailable="{{ $onUnavailable }}")
if $verdict.blocked
bot refuse to respond
stop
Expand Down
1 change: 1 addition & 0 deletions charts/zelkor-platform/scripts/generate-values-schema.rb
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,7 @@
"platform.telemetry.format" => %w[json text],
"databases.mode" => %w[in-cluster-basic operator-cr external],
"global.tier" => %w[oss pro enterprise],
"workspace.policies.nemo.selfCheck.onUnavailable" => %w[allow block],
"security.imageVerification.failureAction" => %w[Enforce Audit],
"workspace.policies.nemo.selfCheck.input" => %w[log block none],
"workspace.policies.nemo.selfCheck.output" => %w[log block none],
Expand Down
8 changes: 8 additions & 0 deletions charts/zelkor-platform/values.schema.json
Original file line number Diff line number Diff line change
Expand Up @@ -1295,6 +1295,14 @@
"string"
],
"description": "Value for workspace.policies.nemo.selfCheck.timeoutMs."
},
"onUnavailable": {
"type": "string",
"enum": [
"allow",
"block"
],
"description": "Allowed values for workspace.policies.nemo.selfCheck.onUnavailable."
}
},
"additionalProperties": false
Expand Down
19 changes: 11 additions & 8 deletions charts/zelkor-platform/values.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ perimeter:
# V2 intent API: platform.*, workspace.*, workload.* (compiled to internal templates at render).
# Substrate keys (postgresql, gateway, databases, security.sandbox, …) stay at the root.
#
# First-party images published as ghcr.io/devopssquaddev/zelkor-*:2.5.3 (Chart.yaml appVersion). Kind inherits these tags; IMAGE_TAG=dev is opt-in.
# First-party images published as ghcr.io/devopssquaddev/zelkor-*:2.5.4 (Chart.yaml appVersion). Kind inherits these tags; IMAGE_TAG=dev is opt-in.

global:
tier: oss
Expand Down Expand Up @@ -112,7 +112,7 @@ platform:
sampling: 0.1
image:
repository: ghcr.io/devopssquaddev/zelkor-langfuse-seed
tag: 2.5.3
tag: 2.5.4
digest: ''
extraProjects: []
nextauthUrl: ''
Expand Down Expand Up @@ -237,7 +237,7 @@ workspace:
replicaCount: 1
image:
repository: ghcr.io/devopssquaddev/zelkor-guardrails
tag: 2.5.3
tag: 2.5.4
digest: ''
configsDir: "/etc/nemoguardrails/configs"
defaultConfigId: content_safety
Expand All @@ -259,7 +259,10 @@ workspace:
# An unclear, slow or failed answer never refuses; it logs guardrail_unavailable/unparseable.
input: log
output: none
timeoutMs: 1500
# A check with no verdict (timeout, error, unclear answer) lets the request through. In block
# mode, onUnavailable: block refuses instead. Never applies to log mode.
timeoutMs: 5000
onUnavailable: allow
extraInputFlows: []
extraColang: ''
extraRailsConfig: {}
Expand Down Expand Up @@ -319,7 +322,7 @@ workspace:
callsPerMinute: 60
image:
repository: ghcr.io/devopssquaddev/zelkor-mcp
tag: 2.5.3
tag: 2.5.4
digest: ''
postgresMCP:
enabled: true
Expand Down Expand Up @@ -444,7 +447,7 @@ workspace:
strictIsolation: false
workerImage:
repository: ghcr.io/devopssquaddev/zelkor-sandbox-worker
tag: 2.5.3
tag: 2.5.4
digest: ''
resources:
requests:
Expand Down Expand Up @@ -576,12 +579,12 @@ workload:
enabled: false
image:
repository: ghcr.io/devopssquaddev/zelkor-aegra
tag: 2.5.3
tag: 2.5.4
digest: ''
cli:
image:
repository: ghcr.io/devopssquaddev/zelkor-aegra-cli
tag: 2.5.3
tag: 2.5.4
digest: ''
resources:
requests:
Expand Down
2 changes: 1 addition & 1 deletion docs/agent-deploy.md
Original file line number Diff line number Diff line change
Expand Up @@ -71,7 +71,7 @@ sharedRoute:

image:
repository: my-registry/my-agent
tag: "2.5.3"
tag: "2.5.4"

platform:
# The name of the platform Helm release (e.g., zelkor-platform).
Expand Down
5 changes: 4 additions & 1 deletion docs/nemo-guardrails.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,10 +23,13 @@ Custom rails go in your platform values file under `workspace.policies.nemo`. Th
| `extraColang` | Colang text appended to the `content_safety` flows file. |
| `selfCheck.input` | `log` (default): check each prompt and log the verdict (`guardrail_verdict`) without refusing. `block`: refuse with `safetyRefusal`. `none`: skip the check. |
| `selfCheck.output` | Same values for the model's answer. Default `none`, because it adds a second model call to every request. |
| `selfCheck.timeoutMs` | Time limit per check (default `1500`). An unclear, slow or failed check never refuses; it logs `guardrail_unparseable` or `guardrail_unavailable`. |
| `selfCheck.timeoutMs` | Time limit per check (default `5000`). A check with no verdict (timeout, error, unclear answer) logs `guardrail_unavailable` or `guardrail_unparseable`. |
| `selfCheck.onUnavailable` | What `block` mode does when a check has no verdict: `allow` (default) lets the request through, `block` refuses it. Ignored in `log` mode. |
| `selfCheck.model` | Model id for the self-check rails. Empty uses the NeMo model (`workspace.policies.nemo.model`, then `workspace.models.defaultModel`). Use a model id your AI Gateway routes. |
| `safetyRefusal` | Text returned when a rail blocks a request. |

Every check also adds a `guardrail self_check input` (or `output`) span to the request's trace, with `zelkor.guardrail.mode` (`log` / `block`), `verdict` (`allow` / `block` / `none`), `status` (`ok` / `timeout` / `error` / `unparseable`), `enforced` (true only when the request was refused) and `latency_ms`. In Langfuse the same fields appear as `guardrail_*` metadata, so you can filter for checks that would have blocked in `log` mode, or for timeouts.

Create an overlay file (e.g., `my-nemo-overlay.yaml`). This one blocks off-topic requests with NeMo's built-in regex input rail:

```yaml
Expand Down
2 changes: 1 addition & 1 deletion docs/quickstart.md
Original file line number Diff line number Diff line change
Expand Up @@ -61,7 +61,7 @@ What `./install.sh` does (you do not run these by hand):
1. Checks Docker, kind, helm, and kubectl
2. Creates kind cluster `zelkor` with host port `8088`
3. Installs the gVisor runtime on the kind node for sandboxed code
4. Deploys Envoy Gateway, Envoy AI Gateway, and the Zelkor platform Helm chart (`appVersion` / image tag `2.5.3`)
4. Deploys Envoy Gateway, Envoy AI Gateway, and the Zelkor platform Helm chart (`appVersion` / image tag `2.5.4`)
5. Deploys the optional FinServe example agents by default
6. Prints service URLs and a ready curl when everything is healthy

Expand Down
2 changes: 1 addition & 1 deletion examples/armored-agents/gpt-researcher/Dockerfile
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
ARG ZELKOR_AEGRA_DEEP_IMAGE=ghcr.io/devopssquaddev/zelkor-aegra-deep:2.5.3
ARG ZELKOR_AEGRA_DEEP_IMAGE=ghcr.io/devopssquaddev/zelkor-aegra-deep:2.5.4
FROM ${ZELKOR_AEGRA_DEEP_IMAGE}

LABEL org.opencontainers.image.source="https://github.com/devopssquaddev/zelkor-platform"
Expand Down
2 changes: 1 addition & 1 deletion examples/armored-agents/gpt-researcher/values.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ aegraConfig: ""

image:
repository: ghcr.io/devopssquaddev/zelkor-armored-gpt-researcher
tag: "2.5.3"
tag: "2.5.4"
digest: ""

platform:
Expand Down
10 changes: 5 additions & 5 deletions examples/finserve/chart/Chart.lock
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
dependencies:
- name: zelkor-agent
repository: file://../../../charts/zelkor-agent
version: 2.5.3
version: 2.5.4
- name: zelkor-agent
repository: file://../../../charts/zelkor-agent
version: 2.5.3
version: 2.5.4
- name: zelkor-agent
repository: file://../../../charts/zelkor-agent
version: 2.5.3
digest: sha256:279520614f9f8e80e86ec0c0ca9c9eb12bc6e009c5e0e487bb19e0737ed1c141
generated: "2026-11-17T11:59:34.427628+01:00"
version: 2.5.4
digest: sha256:d975ac30784eb337a263d6ef2aacf6827784ffb53201c036d59364967243e0e4
generated: "2026-11-17T14:08:51.624992+01:00"
10 changes: 5 additions & 5 deletions examples/finserve/chart/Chart.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -2,18 +2,18 @@ apiVersion: v2
name: finserve
description: Standalone Helm chart for the FinServe AI Wealth Management Demo
type: application
version: 2.5.3
appVersion: "2.5.3"
version: 2.5.4
appVersion: "2.5.4"
dependencies:
- name: zelkor-agent
version: "2.5.3"
version: "2.5.4"
repository: "file://../../../charts/zelkor-agent"
alias: desk
- name: zelkor-agent
version: "2.5.3"
version: "2.5.4"
repository: "file://../../../charts/zelkor-agent"
alias: quant
- name: zelkor-agent
version: "2.5.3"
version: "2.5.4"
repository: "file://../../../charts/zelkor-agent"
alias: coder
Binary file not shown.
Binary file not shown.
8 changes: 4 additions & 4 deletions examples/finserve/chart/values.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ desk:
<<: *agentsHost
image:
repository: ghcr.io/devopssquaddev/zelkor-example-finserve
tag: "2.5.3"
tag: "2.5.4"
digest: ""
platform:
<<: *platformRelease
Expand All @@ -51,7 +51,7 @@ quant:
<<: *agentsHost
image:
repository: ghcr.io/devopssquaddev/zelkor-example-finserve
tag: "2.5.3"
tag: "2.5.4"
digest: ""
platform:
<<: *platformRelease
Expand All @@ -68,7 +68,7 @@ coder:
<<: *agentsHost
image:
repository: ghcr.io/devopssquaddev/zelkor-example-finserve-coder
tag: "2.5.3"
tag: "2.5.4"
digest: ""
platform:
<<: *platformRelease
Expand Down Expand Up @@ -105,7 +105,7 @@ extraMcp:
port: 8080
image:
repository: ghcr.io/devopssquaddev/zelkor-mcp
tag: "2.5.3"
tag: "2.5.4"
digest: ""

dbInit:
Expand Down
2 changes: 1 addition & 1 deletion examples/legal-redline/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ flowchart LR
Build the image, then install the chart against your platform release.

```bash
IMAGES=zelkor-example-legal-redline IMAGE_TAG=2.5.3 ./scripts/build-images.sh --push
IMAGES=zelkor-example-legal-redline IMAGE_TAG=2.5.4 ./scripts/build-images.sh --push
helm dependency update examples/legal-redline/chart
helm upgrade --install legal-redline examples/legal-redline/chart \
--namespace <platform-namespace> \
Expand Down
6 changes: 3 additions & 3 deletions examples/legal-redline/chart/Chart.lock
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
dependencies:
- name: zelkor-agent
repository: file://../../../charts/zelkor-agent
version: 2.5.3
digest: sha256:8c665f543c7003a560174c8f6a1af20a0ccb95c467d9519ef27291b4baec3a40
generated: "2026-11-17T11:59:41.982736+01:00"
version: 2.5.4
digest: sha256:8d3099e9a6cf99c7621ef6ed2f698f1f98f35a55265ad829145c51d38c7331b5
generated: "2026-11-17T14:09:03.167346+01:00"
6 changes: 3 additions & 3 deletions examples/legal-redline/chart/Chart.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -2,10 +2,10 @@ apiVersion: v2
name: legal-redline
description: Standalone Helm chart for the legal-redline clause review example
type: application
version: 2.5.3
appVersion: "2.5.3"
version: 2.5.4
appVersion: "2.5.4"
dependencies:
- name: zelkor-agent
version: "2.5.3"
version: "2.5.4"
repository: "file://../../../charts/zelkor-agent"
alias: legalRedline
Binary file not shown.
Binary file not shown.
2 changes: 1 addition & 1 deletion examples/legal-redline/chart/values.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ legalRedline:
<<: *agentsHost
image:
repository: ghcr.io/devopssquaddev/zelkor-example-legal-redline
tag: "2.5.3"
tag: "2.5.4"
digest: ""
platform:
<<: *platformRelease
Expand Down
2 changes: 1 addition & 1 deletion examples/perimeter-github/agent/Dockerfile
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# Your agent on the stock Zelkor Pydantic AI runtime: same A2A server, plus your own tools.
FROM ghcr.io/devopssquaddev/zelkor-runtime-pydantic-ai:2.5.3
FROM ghcr.io/devopssquaddev/zelkor-runtime-pydantic-ai:2.5.4
USER root
COPY requirements.txt /tmp/requirements.txt
RUN pip install --no-cache-dir -r /tmp/requirements.txt && rm /tmp/requirements.txt
Expand Down
2 changes: 1 addition & 1 deletion images/aegra-deep/Dockerfile
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
ARG ZELKOR_AEGRA_IMAGE=ghcr.io/devopssquaddev/zelkor-aegra:2.5.3
ARG ZELKOR_AEGRA_IMAGE=ghcr.io/devopssquaddev/zelkor-aegra:2.5.4
FROM ${ZELKOR_AEGRA_IMAGE}

LABEL org.opencontainers.image.source="https://github.com/devopssquaddev/zelkor-platform"
Expand Down
2 changes: 1 addition & 1 deletion images/example-finserve-coder/Dockerfile
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
ARG ZELKOR_AEGRA_DEEP_IMAGE=ghcr.io/devopssquaddev/zelkor-aegra-deep:2.5.3
ARG ZELKOR_AEGRA_DEEP_IMAGE=ghcr.io/devopssquaddev/zelkor-aegra-deep:2.5.4
FROM ${ZELKOR_AEGRA_DEEP_IMAGE}

LABEL org.opencontainers.image.source="https://github.com/devopssquaddev/zelkor-platform"
Expand Down
2 changes: 1 addition & 1 deletion images/example-finserve/Dockerfile
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
ARG ZELKOR_AEGRA_IMAGE=ghcr.io/devopssquaddev/zelkor-aegra:2.5.3
ARG ZELKOR_AEGRA_IMAGE=ghcr.io/devopssquaddev/zelkor-aegra:2.5.4
FROM ${ZELKOR_AEGRA_IMAGE}

LABEL org.opencontainers.image.source="https://github.com/devopssquaddev/zelkor-platform"
Expand Down
2 changes: 1 addition & 1 deletion images/example-legal-redline/Dockerfile
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
ARG ZELKOR_AEGRA_IMAGE=ghcr.io/devopssquaddev/zelkor-aegra:2.5.3
ARG ZELKOR_AEGRA_IMAGE=ghcr.io/devopssquaddev/zelkor-aegra:2.5.4
FROM ${ZELKOR_AEGRA_IMAGE}

LABEL org.opencontainers.image.source="https://github.com/devopssquaddev/zelkor-platform"
Expand Down
Loading
Loading