Skip to content

0.8.1 - 2026-10-08

Latest

Choose a tag to compare

@github-actions github-actions released this 08 Oct 17:26
f2eae47

Release Notes

Support for Dakera server v0.12.2 (Dakera-AI/dakera#916). Compatible with v0.11.108,
v0.12.0, v0.12.1 and v0.12.2 servers; the commands below that need v0.12.2 say so on an
older server (see the README compatibility table). Built on dakera-client 0.12.2.

Added

  • dk whoami: GET /v1/auth/whoami — the key the CLI authenticates with (scope,
    grants, unrestricted, grant syntax version, inert grants).
  • dk agent create <agent_id>: POST /v1/agents — create an agent before its first
    memory; idempotent (an existing agent is reported and left unchanged).
  • dk keys edit <key_id> (alias patch): PATCH /admin/keys/{id}, or with
    -n <namespace> PATCH /v1/namespaces/{ns}/keys/{id} — --name, --namespaces a,b
    (p* prefix patterns allowed), --all-namespaces (sends null), --no-namespaces
    (sends []). Nothing to change exits 5 without a request.
  • dk keys rotate --grace <duration>: the old key keeps working for up to 7 days; the
    new key id and the old key's deadline are shown.
  • dk session touch <session_id>: POST /v1/sessions/{id}/touch — keep a quiet session
    from being ended for inactivity (an ended session is reported, never re-opened).
  • dk session start --idle-timeout <duration>: the session's own inactivity timeout
    (0 = never, at most 30 days).
  • --preview <chars> on dk agent memories, dk session memories and
    dk knowledge full-graph (content_preview_chars, 1-10000): the server cuts each content;
    the listings add CONTENT_LEN and TRUNCATED columns. --include-derived on
    dk agent memories. --offset on both memory listings, --limit on dk session memories.
  • dk admin derivations-status and dk admin derivations-drain [--timeout]:
    GET /admin/derivations/status, POST /admin/derivations/drain (global admin key).
  • dk admin session-idle-timeout [<duration>]: show or set the server-wide session
    inactivity timeout (session_idle_timeout_secs of /admin/config).
  • Durations accept s, m, h, d suffixes (3600, 90m, 8h, 7d).
  • dk session list shows ended_reason (client / idle).
  • Shell completions list the new commands.

Changed

  • dk session memories reports the server's total (it printed 0) and reads the listing
    through dakera-client 0.12.2.
  • ClientError::InvalidRequest from the SDK exits 5 (invalid input).

Fixed

  • dk keys rotate printed no new key: it looked for key, the server answers new_key.

Server behaviour changes you may hit (Dakera v0.12.2)

  • Sessions are authorized by their agent: keys no longer need a _dakera_sessions grant
    (such an entry is inert, see dk whoami); a key without grants lists no sessions;
    dk session end with a read-only key gets 403 (exit 4), and ending a session of an
    agent the key cannot reach returns the empty idempotent answer.
  • Sessions auto-end after 4 h idle by default (ended_reason: idle). Use
    dk session touch, dk session start --idle-timeout, or
    dk admin session-idle-timeout. Storing into an ended session still succeeds.
  • Stricter validation (400, exit 5, the message names the field): key namespace
    lists, agent ids (at most 241 bytes), memory metadata, reserved markers, TTLs, imports.
  • The memory content limit is in bytes (UTF-8, default 100000), also on dk memory update.
  • Listings exclude derived records unless include_derived=true: dk agent memories
    no longer shows the sentence sub-memories; add --include-derived.

Dependency

  • dakera-client 0.12.2 (crates.io).

Install dakera-cli 0.8.1

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/dakera-ai/dakera-cli/releases/download/v0.8.1/dakera-cli-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy ByPass -c "irm https://github.com/dakera-ai/dakera-cli/releases/download/v0.8.1/dakera-cli-installer.ps1 | iex"

Install prebuilt binaries via Homebrew

brew install dakera-ai/tap/dk

Download dakera-cli 0.8.1

File Platform Checksum
dakera-cli-aarch64-apple-darwin.tar.gz Apple Silicon macOS checksum
dakera-cli-x86_64-apple-darwin.tar.gz Intel macOS checksum
dakera-cli-x86_64-pc-windows-msvc.zip x64 Windows checksum
dakera-cli-x86_64-unknown-linux-gnu.tar.gz x64 Linux checksum