TOKN v0.3.16

TOKN v0.3.16

Queue-driven agent runs, now closed end to end.

What's new

• Send events, not just receive them. tokn events publish --source servicebus puts a message on an Azure Service Bus queue or topic, so the same tool that consumes events can produce them. Works with Microsoft Entra ID (--namespace) or a connection string — useful if your tenant disables SAS.
• Routes without an explicit mode: now work. They previously failed on every delivery and ended in the dead-letter queue. If you hit this, no config change is needed.
• tokn events validate catches a bad mode before you spend anything. It used to pass configs that could never run a message.
• Failed runs say why. The reason now appears in your console instead of only in the broker's dead-letter metadata.

Install

Download the binary for your platform, then:

chmod +x tokn_linux_amd64 && ./tokn_linux_amd64 --help

.\tokn_windows_amd64.exe --help

Verify

sha256sum -c SHA256SUMS

TOKN v0.3.15

TOKN v0.3.15

tokn events — turn a queue into agent turns.

Point TOKN at a durable queue and each message becomes an agent run, with
at-least-once delivery, per-session ordering, dedupe, and dead-letter
visibility. Two sources ship: a local on-disk queue that survives a crash,
and Azure Service Bus (queue or topic).

# .nospace/eventsource.yaml
max_concurrent: 2
routes:
  - name: build-failures
    mode: code
    filters:
      subject: build.failed

tokn events run

Three config files that were documented but never read now work.

.nospace/webhooks.yaml and .nospace/schedules.yaml were described in
--help, the README and QUICKSTART, and nothing loaded them. Both are now
read at daemon start — a missing file is silent, a malformed one stops
startup with the parse error rather than starting with your rules ignored.

Webhook hardening. /hooks/<path> ran with the same authority as
/webhook but verified no signature. It now requires one whenever a webhook
secret is configured. If you relied on unsigned calls, set
TOKN_WEBHOOK_ALLOW_UNSIGNED_HOOKS=1; TOKN will warn at startup. With no
secret configured, nothing changes.

An oversized request body is now rejected as a size problem before signature
checking, so a truncated payload no longer looks like a bad secret.

Install

Download the binary for your platform, rename it to tokn (or tokn.exe), and
put it on your PATH.

Platform	Asset
Windows x64	tokn_windows_amd64.exe
macOS Intel	tokn_darwin_amd64
macOS Apple Silicon	tokn_darwin_arm64
Linux x64	tokn_linux_amd64
Linux arm64	tokn_linux_arm64

Verify

sha256sum -c SHA256SUMS --ignore-missing
tokn version

TOKN v0.3.14

TOKN v0.3.14

--task-id now always belongs to the mode you ran in.

When you capture a trajectory with --task-id, the leading <mode>/ segment is
added for you and can no longer be set by hand. If you spell a different prefix,
TOKN re-qualifies the id under the mode you actually ran in and tells you it did.

Why it matters: tokn self-harness picks its evidence by that segment. Previously
a hand-spelled prefix could file one mode's runs into another mode's evidence, and
nothing downstream could tell. An id whose prefix named no mode at all was written
to disk and then invisible to every reader.

Your grouping still works exactly as before — two runs passing the same
--task-id still compare against each other.

Install

Download the binary for your platform, rename it to tokn (or tokn.exe), and
put it on your PATH.

Platform	Asset
Windows x64	tokn_windows_amd64.exe
macOS Intel	tokn_darwin_amd64
macOS Apple Silicon	tokn_darwin_arm64
Linux x64	tokn_linux_amd64
Linux arm64	tokn_linux_arm64

Verify

sha256sum -c SHA256SUMS --ignore-missing
tokn version

TOKN v0.3.13

TOKN v0.3.13

Learn from your own runs. TOKN can now record what actually happened during a run and compare repeated attempts at the same task, so it can tell you which approaches worked and which didn't.

• tokn agent-run --capture-trajectory records a compact log of each run: the tools used, how each step went, and how the run ended.
• tokn agent-id ... --task-id <name> gives repeated attempts at the same task a shared name, so TOKN can put them side by side and draw out what separated the good runs from the bad ones.
• Insights now state what evidence they're based on. TOKN distinguishes "this run completed without error" from "this answer was verified correct" — and never quietly presents the first as the second.
• Peer Exchange now reports authentication problems clearly instead of looking like there was simply nothing to fetch. An expired password used to be indistinguishable from an empty inbox.

Capture is opt-in and off by default.

Install

Download the binary for your platform, rename it to tokn (or tokn.exe), and put it on your PATH.

Platform	Asset
Windows (x64)	tokn_windows_amd64.exe
macOS (Apple Silicon)	tokn_darwin_arm64
macOS (Intel)	tokn_darwin_amd64
Linux (x64)	tokn_linux_amd64
Linux (arm64)	tokn_linux_arm64

On macOS and Linux, mark it executable: chmod +x tokn

Verify your download

SHA256SUMS and SHA256SUMS.sig are attached to this release.

sha256sum -c SHA256SUMS --ignore-missing

Then confirm what you're running:

tokn version

TOKN v0.3.12

TOKN v0.3.12

Internal groundwork release. No user-visible commands or flags changed in this
version — if you are on v0.3.11 and everything is working, there is no urgency to
update.

What landed is the foundation for composing evaluations across domains: a common
contract for driving a task environment, so a single run can span two domains and
be judged by both domains' existing gates rather than a new one written for the
occasion. The user-facing commands that use it come in a later release.

Install

Download the binary for your platform, rename it to tokn (or tokn.exe on
Windows), and put it on your PATH.

Platform	Asset
Windows	tokn_windows_amd64.exe
macOS (Apple Silicon)	tokn_darwin_arm64
macOS (Intel)	tokn_darwin_amd64
Linux	tokn_linux_amd64
Linux (ARM)	tokn_linux_arm64

On macOS and Linux, mark it executable:

chmod +x tokn

Verify your download

sha256sum -c SHA256SUMS --ignore-missing

SHA256SUMS.sig is the signature over that manifest, checked automatically by
tokn update.

Check it works

tokn version
tokn --help

v0.3.11

v0.3.11

Clearer answer when a license can't be verified

tokn license status could print verify: ok and, on the very next line,
reason: the installed license could not be verified. It now shows the actual
reason a license was rejected, so a bad or corrupted license file tells you what
is wrong instead of contradicting itself.

Nothing about which features you have changes. The community tier is free
forever, and TOKN still falls back to it rather than refusing to run.

Verify your download

sha256sum -c SHA256SUMS

v0.3.10

v0.3.10

/blocked — one place to answer anything waiting on you

A fleet run, a swarm branch, and a headless peer can all stop and wait for a
person. Until now each waited somewhere different. TOKN now keeps a single
session-wide registry of everything blocked on a human — approval gates,
elicitation prompts, tool-auth challenges — and /blocked lists them.

/blocked                 list everything waiting
/blocked show in-3       see the full request
/blocked answer in-3 y   answer it

Status: the registry is live, but nothing fills it yet. Approval gates are
not yet routed into it, and the reason is documented rather than hidden: the
REPL is synchronous, so you cannot type /blocked while a run is blocked.
Routing gates in before an answering surface exists would turn a prompt into a
hang. The answering surface lands first.

Audit log honesty

A tool approval that timed out was recorded as though a person had decided it.
It is now recorded as a timeout, and the approver's stated reason — previously
discarded — is kept.

Fixes

• /blocked will not accept a tool-auth token, because the terminal writes each
  line to shell history before the command runs and there is no way to suppress
  it at the current readline version.
• Non-ASCII titles no longer truncate mid-character; terminal control sequences
  in displayed text are stripped.

Verify your download

sha256sum -c SHA256SUMS

TOKN v0.3.9

TOKN v0.3.9

A documentation and maintenance release. No change to runtime behaviour from
v0.3.8 — if you are already running v0.3.8, there is nothing you need to do.

Install

Download the binary for your platform, rename it to tokn (or tokn.exe on
Windows), and put it on your PATH.

Platform	Asset
Windows (x64)	tokn_windows_amd64.exe
macOS (Apple Silicon)	tokn_darwin_arm64
macOS (Intel)	tokn_darwin_amd64
Linux (x64)	tokn_linux_amd64
Linux (arm64)	tokn_linux_arm64

Verify your download

sha256sum -c SHA256SUMS
tokn version

tokn version reports variant: public for builds from this channel. The
public build streams documentation from the hosted wiki rather than embedding
it, which is why it is substantially smaller.

TOKN v0.3.8

TOKN v0.3.8

A maintenance release. Fixes a bug that could make delegated-run history
unreadable, and stops a recurring "blocked by your IT administrator" popup on
managed Windows machines.

Fixed

• Delegated-run history (/conduct trajectories) could fail to load. It now
  reads reliably.
• On managed Windows machines, TOKN's SDK conformance checks bypassed your
  organisation's approved Python package index and reached out to the public
  one instead, which corporate security policy blocks. TOKN now respects your
  configured package index and proxy settings.

Install

Download the binary for your platform, rename it to tokn (or tokn.exe on
Windows), and put it on your PATH.

Platform	Asset
Windows (x64)	tokn_windows_amd64.exe
macOS (Apple Silicon)	tokn_darwin_arm64
macOS (Intel)	tokn_darwin_amd64
Linux (x64)	tokn_linux_amd64
Linux (arm64)	tokn_linux_arm64

Verify

sha256sum -c SHA256SUMS
tokn version

TOKN v0.3.7

TOKN v0.3.7

See your context window, and take it back.

• /context now itemizes every token in the window — instruction files, tool definitions, memory, skills, conversation — with a bar chart and a per-source breakdown. It previously counted only chat messages, so a fresh session looked empty while carrying more than 11,000 tokens.
• /context drop removes what you do not need for this task and reports the exact saving. Project docs and skills are now genuinely droppable, and reversible with --restore.
• /compact honours the focus argument it always advertised (/compact keep the API design decisions), picks a strategy, and works whether or not you are near the budget.
• /autocompact replaces silent automatic compaction with something you configure. Off by default; when on, it uses a hysteresis band so it fires once rather than repeatedly at the threshold.
• Nineteen command groups that were documented but unreachable from the interactive session — including /loop, /usage, /feedback and /org — now work.
• Large tool output spills to a file instead of flooding the window.

Learn the model behind it with /learn context.

Install

Download the binary for your platform, then:

chmod +x tokn_<os>_<arch>
./tokn_<os>_<arch> --version

Windows: tokn_windows_amd64.exe --version

Verify

sha256sum -c SHA256SUMS