Repository navigation
Releases: securetron-gh/aifw
Release list
AIFW v1.5.307 - Alberta, Canada
AIFW 1.5.307
Released: 2026-10-20
Edition: Community and Enterprise
Runtime: ASP.NET Core on .NET 11 RC1 (11.0.100-rc.1 SDK, 11.0.0-rc.1 runtime)
AIFW is the AI governance and agent-trust gateway from Securetron: policy enforcement, prompt and
response inspection, routing, identity validation and audit for generative-AI traffic, without
locking you to a model provider.
Container images
| Registry | Image | Tags |
|---|---|---|
| GitHub Container Registry | ghcr.io/securetron-gh/aifw |
1.5.307, latest |
linux/amd64, runs as non-root userapp, HTTP 80 / HTTPS 443 (Endpoints:WebHttps).- Image digest:
sha256:08532520feb4feebe7a66973b9690863d9dab2101a8b4c909f840ee73e78cb40
docker run --rm -p 8080:80 \
-e ConnectionStrings__PostgreSQL="Host=<host>;Port=5432;Database=pki_remote_agent;Username=<user>;Password=<pass>" \
-e AiFw__JwtSecret="<secret>" \
-e AiFw__Ledger__Key="<quota-ledger hmac key>" \
ghcr.io/securetron-gh/aifw:1.5.307PostgreSQL is required: the container exits during startup when the database is unreachable rather than
serving from a fallback store. Health: GET /api/health · A2A discovery: GET /.well-known/agent-card.json
What's new
Microsoft Decision-1 as a policy classifier
Foundry's System One decision model is now a first-class option instead of an add-on:
- Model Inventory gains a
Microsoft Decision-1 (System One decisions, not chat)protocol. Point the
backend URL at the resource endpoint and put the deployment name in the model ID; the entry carries its
own key. - Guardrails → Classifier offers
decisionalongside the chat and embedding backends. Both the risk
stage and the flag verifier use the selected classifier, so picking once is enough. POST /v1/decisionlets agents reach a decision model through the gateway: same authentication,
same prompt inspection, same masking, same audit row and the same400+X-Gateway-Security: Violatedrefusal shape as every other endpoint.- Question mode (
semantic_question_mode) controls how the classifier is asked:per_ruleasks one
question per rule,batchedsends every rule's question in a single decision request (per-rule scores
kept, prompt billed once),singleasks one combined question.
Measured on the buried-injections corpus (726 cases: 629 attacks, 97 benign; 7 built-in rules):
| Classifier | Mode | Attacks caught | Benign blocked | p50 |
|---|---|---|---|---|
| deepseek-v4-flash | per_rule |
629/629 | 40 | 2990 ms |
| gpt-6-luna | per_rule |
629/629 | 38 | 3013 ms |
| Microsoft Decision-1 | per_rule |
323/629 | 2 | 2011 ms |
| Microsoft Decision-1 | batched |
629/629 | 4 | 274 ms |
The per_rule decision row is a throttling artefact, not a classifier result: one question per rule meant
seven calls per request and 393 429 responses, which the fail-open path counted as passes. Batched mode
recorded none. On AgentDojo v1.2.2 (949 attacks, 97 benign) Decision-1 in batched mode caught 949/949
with 5 benign blocks at 276 ms.
Flag verification that cannot hide
- The flag-verification score is recorded on blocked rows, and verdicts are attached to the exact request
that produced them, including asynchronous verification. - Blocks are judged by the rule's block threshold rather than its flag threshold, so a confirmation can
actually act on the verdict. - With verification on, a flagged prompt is refused before the answer is generated, not after.
- Rules accept configurable exemplars, and the built-in rules ship tuned thresholds.
- Blocked rows now carry the endpoint kind, so Activity says which endpoint refused.
Cursor agent hooks and IDE artifacts
POST /hooks/cursorrecords one audit row per shell invocation, with a capture mode and a configurable
repeat window for duplicate suppression.- The shim answers explicitly when the gateway is unreachable instead of failing silently.
- IDE artifacts are recorded alongside the hook events.
Skills and tool governance
- Platform skills are declared once and the A2A agent card is built from that declaration.
- Custom skills can be defined from the UI; the catalog is gated on the A2A admin role.
- Tool and skill use is governed per agent, with the compliance rule and schema fixes that go with it.
Configuration backup and restore
Versioned configuration backups, with scheduled backups and a restore path that validates the version.
Behaviour changes to plan for
-
The 30-day allowance is fixed at 10,000,000,000 tokens for every installation. The previous ceiling
and theAiFw:License:DemoCapdeployment override no longer apply; the key still parses but is ignored,
and/api/healthreportscapCeiling10,000,000,000 withcapOverrideActivefalse. An existing
deployment that relied on the override will drop to 10 billion and reach its grace window. -
semantic_question_modedefaults toper_rule. On a quota-limited decision deployment, set
batched; the endpoint needssemantic_decision_endpoint(or a registered decision model) and will
otherwise fail closed.
Fixes
- AI-FW schema DDL corrected so an existing database reaches the current shape.
- Cursor hook audit rows and transaction batches no longer lose entries.
- Flag-verification persistence and cancellation fixed for the asynchronous path.
- The guardrails model path controls reappear when flag verification is on.
- Compliance rule cells no longer render their own markup as text.
Performance
- The risk dashboard is read from a daily rollup, with risk history indexed, instead of scanning it three
times per load.
Upgrading from 1.1.264
- Review the quota: the allowance is now a fixed 10 billion tokens per rolling 30 days.
- If the semantic classifier is a decision model, set
semantic_question_mode=batchedand confirm the
decision endpoint or inventory entry is present. - Keep
AiFw__JwtSecretandAiFw__Ledger__Keystable across the upgrade. The ledger key signs the quota
hash chain, so changing it starts a new chain and the existing quorum history is no longer verifiable.
Full Changelog: Goose...Alberta
AIFW 1.1.245 - The Goose
AIFW 1.1.245
Released: 2026-09-18
Edition: Community
Runtime: ASP.NET Core on .NET 11 RC1 (11.0.0-rc.1.26425.128)
AIFW is the AI governance and agent-trust gateway from Securetron: policy enforcement, prompt and
response inspection, routing, identity validation and audit for generative-AI traffic, without
locking you to a model provider.
Container images
| Registry | Image | Tags |
|---|---|---|
| GitHub Container Registry | ghcr.io/securetron-gh/aifw |
1.1.245, latest |
| Docker Hub | securetron/aifw |
1.1.245, latest |
| Azure Container Registry | securetronlab.azurecr.io/agenttrust |
1.1.245, latest |
linux/amd64.- Runs as non-root user
app; HTTP 80, HTTPS 443 (Endpoints:WebHttps). - Image digest:
sha256:fd20b29ba3b35619ff7f721111a5162f6a0b04b99c072df747901f2ff38a9b0e
docker run --rm -p 8080:80 \
-e ConnectionStrings__PostgreSQL="Host=<host>;Port=5432;Database=pki_remote_agent;Username=<user>;Password=<pass>" \
-e AiFw__JwtSecret="<secret>" \
ghcr.io/securetron-gh/aifw:1.1.245Health: GET /api/health · A2A discovery: GET /.well-known/agent-card.json
What's new
.NET 11 RC1, pinned for reproducible builds
The stack now targets .NET 11 RC1, with the SDK and container base images pinned to exact versions.
A rebuild produces the same runtime rather than following a floating tag:
- SDK
11.0.100-rc.1.26425.128 Microsoft.AspNetCore.OpenApi11.0.0-rc.1.26425.128- Base images
mcr.microsoft.com/dotnet/sdk:11.0.100-rc.1/aspnet:11.0.0-rc.1
Better behaviour under database pressure
Transient PostgreSQL conflicts — deadlocks, serialization failures and dropped connections — are
now retried instead of surfacing as failed gateway or certificate operations. Database access
retries up to 5 times with up to 10 seconds of backoff, so a busy database slows throughput rather
than failing requests.
Usage rollups: bounded and predictable
The rollup behind organisation-wide reporting (dashboard totals, long-window trends) reads within a
bounded window and writes in batches, keeping memory use and write bursts predictable on large
installations. Every setting is optional:
| Setting | Default | Range |
|---|---|---|
AiFw:Rollups:IntervalMinutes |
60 | 5 – 1440 |
AiFw:Rollups:Days |
7 | 1 – 90 |
AiFw:Rollups:TopEntitiesPerDay |
200 | 1 – 5000 |
AiFw:Rollups:MaxTransactions |
2,000,000 | 1,000 – 20,000,000 |
AiFw:Rollups:Enabled |
true |
on / off |
Configuration sample
docker-compose.yml pins its example tag to 1.1.245 and no longer carries a placeholder secret,
so a copied sample cannot ship a published value by accident.
Upgrade notes
- No database schema changes. Replace the image; existing data and settings continue to work.
- Configuration is backward compatible. Required settings:
ConnectionStrings__PostgreSQL,
AiFw__JwtSecret, and upstream model credentials (AiFw__Llm__BackendApiKeyor per-model keys).
SetASPNETCORE_ENVIRONMENT=Productionfor real deployments. - Community Edition usage limit: up to 300,000,000 tokens per rolling 30 days (minimum 1,000),
with a 7-day grace period when the allowance is exceeded. - Without a configured database the gateway falls back to in-memory storage — nothing is retained
across restarts, so use PostgreSQL beyond a trial.
AIFW - True North Edition
AI-FW - True North Edition
AI-FW is the AI firewall and governance gateway. It sits between your AI agents and the models they call, and it identifies, authorizes, inspects, governs and audits that traffic. It runs as a container in your own environment, in front of your existing identity stack.
Start here
- Quick start: https://aifw.io/docs/getting-started/quick-start
- What AI-FW is: https://aifw.io/docs/getting-started/what-is-aifw
- Solutions (problems, not features): https://aifw.io/docs/solutions/block-prompt-injection
- Models and endpoints reference: https://aifw.io/docs/api-reference/openai-compatible-endpoints
This release includes
- The complete knowledge base: guides, tutorials, how-to recipes, API reference and admin reference, also rendered at https://aifw.io/docs
- A dashboard screenshot asset (
AI-FW-Dashboard.png) for internal reviews and briefings
Editions
- Community Edition: free and self-hosted, 100,000,000 tokens per month over a rolling 30-day window. License: https://aifw.io/community-edition/license
- Enterprise: custom token allowance, enterprise support and deployment assistance. Contact sales@aifw.io
Links
- Website: https://aifw.io
- Documentation: https://aifw.io/docs
- Media and launch video: https://aifw.io/media
- Machine-readable index for AI assistants: https://aifw.io/llms.txt
Support: support@aifw.io