Repository navigation
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>(aliaspatch):PATCH /admin/keys/{id}, or with
-n <namespace>PATCH /v1/namespaces/{ns}/keys/{id}—--name,--namespaces a,b
(p*prefix patterns allowed),--all-namespaces(sendsnull),--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>ondk agent memories,dk session memoriesand
dk knowledge full-graph(content_preview_chars, 1-10000): the server cuts each content;
the listings addCONTENT_LENandTRUNCATEDcolumns.--include-derivedon
dk agent memories.--offseton both memory listings,--limitondk session memories.dk admin derivations-statusanddk 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_secsof/admin/config).- Durations accept
s,m,h,dsuffixes (3600,90m,8h,7d). dk session listshowsended_reason(client/idle).- Shell completions list the new commands.
Changed
dk session memoriesreports the server'stotal(it printed 0) and reads the listing
throughdakera-client0.12.2.ClientError::InvalidRequestfrom the SDK exits 5 (invalid input).
Fixed
dk keys rotateprinted no new key: it looked forkey, the server answersnew_key.
Server behaviour changes you may hit (Dakera v0.12.2)
- Sessions are authorized by their agent: keys no longer need a
_dakera_sessionsgrant
(such an entry is inert, seedk whoami); a key without grants lists no sessions;
dk session endwith a read-only key gets403(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-client0.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 | shInstall 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/dkDownload 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 |