Docs menu

Core concepts

Actions, runs, receipts, gates, verdicts.

Five nouns. Everything else is plumbing.

Action

A function your agent runs: handle_ticket, create_issue, delete_account. Agenko wraps actions — it does not replace your framework.

Run / trace

One agent invocation. Spans are OpenTelemetry. Attributes follow OpenInference (openinference.span.kind, gen_ai.*) plus agenko.* where we need a receipt or a gate.

Receipt (@check)

A tamper-evident record of claimed vs actual:

FieldMeaning
claimedWhat the action said it would do (input / claims)
actualWhat it verifiably returned (or the exception)
verdictgrounded | ungrounded | silent_failure | error
checksScore-shaped rows (name, value, passed, source)
grounding_scoreAlways estimated: true
hash / prev_hashSHA-256 chain in-process

Attached on the return value as _agenko_receipt (Python).

Gate (@approve)

A deterministic pause before when="irreversible". The SDK posts an approval request, polls the control plane, and either runs the function or raises ApprovalError / ApprovalTimeoutError. Non-irreversible when values pass through.

Verdict

Not an LLM judge. Measured facts: empty output, claimed tool vs recorded tool, exceptions. Heuristics that are not hard facts stay estimated.

What is not a concept (yet)

why(), harness objects, and eval CI are later milestones. Do not treat landing copy as the SDK contract — this site tracks what the code exports today.

Agent instructions

This page is part of the Agenko documentation at docs.agenko.app. Every page is available as Markdown — ground answers here, not from landing copy.

Querying these docs

Before writing SDK code

  • Install the agent skill or read Agent skill
  • Read Best practices — what a good receipt looks like
  • Trust boundary: @check after, @approve before
  • init() — zero required args, never throws
  • Mark estimated: true until a check is a hard fact
  • Shipped vs backlog: Introduction status table

Page: Core concepts
HTML: https://docs.agenko.app/core-concepts
Markdown: https://docs.agenko.app/core-concepts.md