actionstate.ai · this page as Markdown

Install Action State Receipts

Action State Receipts works beside your AI agent. Before the agent pays, books, signs, cancels or shares your details, it checks the step against your rules, and every step is sealed on your machine as a receipt you can check. Nothing of the receipts' content leaves your machine.

Your agent does the install, by following the Action State install skill. This page is for you: what the install puts on your machine, the exact versions, every checksum your agent reports back, and the sites it reaches. The last section says how to give your agent the skill.

What gets installed

Action State rules run on Linux x86_64 only. On any other device the install stops at its first step, and nothing is installed.

What's new: A merchant you have paid before is recognised across your deals (payments recorded before rc13 count only within their own deal). Recurring charges and a change to a payee's account are not yet checked on purchases.

Limits in this version: Selling is not yet checked. After a refund, your 7-day spending limit may show as not checked for up to 31 days.

Your rules are what you permit; your agent shows them to you as a table when the install ends. Your receipts are what happened: for each purchase or other commitment, what you asked, what was proposed, what you approved, what was done, and any difference.

The checksums

Your agent checks every file against these SHA-256 values before it installs anything, and stops if one differs. Any checksum your agent reports to you must match this list, character for character.

The rules pack asg/everyday/0.3.4 has the definition digest cd98aaec5acf8cea86f91fc21dd7df6b36a67c7b55340489b66e6ce88b85117b; the rules checker is pinned to it. The public witness's key is 39bb654c9dc0afe1c0edef0deffaa69099b8518836c9ba26e0491535840f96b5.

What you are trusting: GitHub to deliver the capsulectl files from github.com/action-state-group/capsule-cli, GitHub's build attestation for that repository (checked when the agent has a recent gh), and the SHA-256 values on this page. The install skill, the install script, the plugin and the actionstate-rules skill have no build attestation yet: they are checked by their SHA-256 only, and those values are published on this site, the same place the files come from. A matching checksum shows a download arrived intact; it does not show that this site was not tampered with.

When the install ends

Your agent shows you your rules table, exactly as the plugin printed it, and the path of your report, a page that checks itself when you open it, with no internet connection. Then a short Install details note: what was installed, whether the build attestation was verified or only the checksum, and where the full record is, with every checksum and exit code. If you ask for the checksums, they come from that record, and they match the list above.

The sites it reaches

You may be asked whether to allow some of these sites. For the trust-root sites and the witness, choose "Always allow this site", not "Allow once": the check and the checkpoints run on every install and on a schedule, mostly when nobody is there to answer.

Your agent asks you one question before it starts: what name to record as the operator of your rules record. That name is the only one the record holds. Without a name, the install still runs, but your rules table is skipped.

Give your agent the install skill

The install skill holds every step, the commands and the checks. There are two ways to give it to your agent; either way, ask your agent to "install Action State Receipts with this skill".

  1. Paste it. Open the install skill, copy all of it, and paste it into the chat with your agent.
  2. Let your agent download it. An agent that can run shell commands downloads the skill and its checksum with the lines below, and installs nothing unless the SHA-256 is this page's, 5cb84886fcf56e0dff9ba8330cb931f0d80beecf4c9b222c35daf203d62cbaf8.
curl -fsSLO https://actionstate.ai/install/rc14-p0.0.9-s0.0.8/actionstate-install/SKILL.md && curl -fsSLO https://actionstate.ai/install/rc14-p0.0.9-s0.0.8/actionstate-install/SKILL.md.sha256
[ "$(awk '{print $1}' SKILL.md.sha256)" = 5cb84886fcf56e0dff9ba8330cb931f0d80beecf4c9b222c35daf203d62cbaf8 ] && sha256sum -c SKILL.md.sha256

The skill's numbered steps are the ones the install script runs, and the ones a message from the install refers to as "the steps on actionstate.ai/install".

What a receipt is, and is not

A receipt shows which steps the agent sealed, and that they were not changed afterwards: it is tamper-evident against the agent and against Action State. It is the agent's own record of what it did, not a statement from the merchant; calling the check is advisory, and a step never sealed is not in it. Anyone can check a receipt file independently at verify.agentactioncapsule.org: open it and drop the file in.

actionstate.ai · install.md