Agent Receipts

Agent Receipts

AI エージェントはすべてを記憶し、その記憶を証明できます。

暗号学的なレシートで裏付けられた、AI エージェント向けの永続メモリです。エージェントが学習するすべての事実は署名され、追跡可能で、第三者が独立して検証できます。クラウドは不要です。

インタラクティブデモを試す · 30 秒でインストール · 他との違い

問題点

AI エージェントを使って開発しているとします。Claude Code が認証モジュールをリファクタリングし、「完了しました。すべてのテストに合格しました」と報告します。エージェントが顧客向けの見積もりを作成し、正しい価格を適用したと言います。アシスタントは先週のあなたの好みを覚えています。しかし、なぜそう判断したのか、あるいはその判断が正しいのかを確認できません。

次の 3 つの問題があります。

1. エージェントはセッションが変わるとすべてを忘れます。 会話のたびにゼロから始まります。コンテキストが失われ、同じことを何度も説明し直すことになります。

2. エージェントが記憶していても、その中身を確認できません。 プラットフォームのメモリはブラックボックスです。何を、いつ、なぜ保存したのか確認できません。修正、エクスポート、検証もできません。

3. エージェントが実際に何をしたかを証明する方法がありません。 ログは変更可能です。エージェントは自分でログを書きます。「ファイルを 3 つ更新し、すべてのテストに合格しました」――本当にそうでしょうか。エージェント自身の作業について、その言葉を信じるしかありません。

Agent Receipts ができること

実際に使えるメモリ

エージェントはセッションをまたいで、人物、プロジェクト、ツール、設定、事実などを構造化された形で永続的に記憶できます。単純なキーと値のストアではありません。すべての事実が、それを生み出した会話に紐づく、エンティティと観察事項のグラフです。

# Your agent learns something
memory_observe → "User prefers TypeScript, uses Neovim, building a SaaS called ModQuote"

# Next session, it already knows
memory_context → loads everything: entities, observations, relationships, preferences

# You can search it
memory_recall → "what tech stack does the user prefer?" → structured results

# You can forget (and the forget itself is tracked)
memory_forget → soft delete with audit trail

システムプロンプトを追加すると、エージェントがこれを自動的に処理します。メモリを手動で管理する必要はありません。

本物の証明

メモリの観察事項やエージェントのアクションが発生するたびに、署名付き JSON ドキュメントであるレシートが生成されます。レシートには次の情報が含まれます。

• Ed25519 署名 — 改ざんを防ぎ、第三者が独立して検証できます
• 入出力のハッシュ — 何が入力され、何が出力されたかを正確に証明します（生データは保存されません）
• タイムスタンプ — 発生時刻と完了時刻
• エージェント ID — 実行したエージェント
• 来歴チェーン — あらゆるメモリを、それを生み出した会話までたどれます

これはログではありません。ログはエージェント自身が自らについて書く、変更可能なテキストファイルです。レシートは暗号学的な証明であり、あなたやサーバー、エージェントを信頼しなくても、第三者が検証できます。

すべてローカルで実行

npx @agent-receipts/mcp-server

これだけです。API キーも、アカウントも、クラウドも、月額料金も不要です。データがマシンの外に送信されることもありません。SQLite データベースは ~/.agent-receipts/ に保存されます。オフラインでも動作します。

これが必要な理由

私は ModQuote を開発していました。自動車保護施工店向けに、AI エージェントが見積もりを作成するマルチテナント SaaS です。実際のお金が動き、実際のお客様がいて、実際の法的責任が伴います。

Claude が 2,400 ドルの PPF 見積もりを作成したとき、私は答えが必要でした。どの車両データを受け取ったのか？どの価格設定ルールを適用したのか？お客様が価格に異議を唱えた場合、何が起きたのかを証明できるのか？エージェント自身が記録したログではなく、暗号学的な証明で。

既存のツールを調べました。

• Mem0 — 優れたメモリー機能がありますが、証明はできません。情報を記憶できますが、いつ、なぜ学習したのかは証明できません。メモリーは変更可能です。
• Langfuse — 優れた可観測性機能がありますが、これはトレーシングであり、証明ではありません。ログはシステム内部のもので、第三者が検証できません。
• Zep — 時系列ナレッジグラフですが、ホスト型で中身が不透明です。

どれも、次の問いには答えられませんでした。「この特定のエージェントが、この特定の入力を使って、この特定の時刻に、この特定のアクションを実行したことを、システム外部の人に証明できますか？」

そこで Agent Receipts を開発しました。今では、見積もりの生成ごとに署名付きレシートが作成されます。すべてのメモリーには来歴チェーンがあります。そして「エージェントはどうやってその金額を算出したのか？」と聞かれたとき、自分で検証できるレシートを渡せます。

何が違うのか

Agent Receipts は、これらのツールの改良版ではありません。別の種類のツールです。

Mem0 が答えるのは、「エージェントは何を記憶しているか？」 Langfuse が答えるのは、「LLM パイプラインで何が起きたか？」 Agent Receipts が答えるのは、「それを証明できますか？」

はじめに

1. MCP サーバーを追加する

Claude Code:

claude mcp add agent-receipts -- npx @agent-receipts/mcp-server

Claude Desktop（claude_desktop_config.json）／Cursor（.cursor/mcp.json）:

{
  "mcpServers": {
    "agent-receipts": {
      "command": "npx",
      "args": ["@agent-receipts/mcp-server"]
    }
  }
}

2. システムプロンプトを追加する

これにより、メモリーをいつ記録し、コンテキストをいつ呼び出し、アクションをいつ追跡するかをエージェントに指示でき、自動的に動作します。

npx @agent-receipts/cli prompts claude-code

出力をプロジェクトの指示またはシステムプロンプトにコピーします。

3. 使い始める

エージェントは次のことを行うようになります。

• セッション開始時に memory_context を呼び出し、あなたについて把握している情報を読み込む
• 記憶する価値のある情報を学んだときに memory_observe を呼び出す
• 重要なアクションを実行したときに track_action を呼び出す
• すべてに Ed25519 で署名する

4. 動作を確認する

npx @agent-receipts/dashboard    # Web UI at localhost:3274
npx @agent-receipts/cli stats    # Terminal overview
npx @agent-receipts/cli memory entities  # See what your agent remembers

5. インストール前に試す

インタラクティブデモを実行 → — メモリー、検証、バンドルのエクスポートを 60 秒で体験できます。インストールは不要です。

含まれるもの

• 24 個の MCP ツール — メモリー、アクション、検証、制約、判断、請求、バンドル
• 21 個の SDK メソッド — TypeScript API 全機能
• 14 個の CLI コマンド＋9 個のメモリーサブコマンド — ターミナル中心
• 18 個のダッシュボードページ — レシート、メモリーグラフ、チェーン、エージェント、制約、判断、請求書
• 492 個のテスト — TypeScript の any はゼロ、ESLint 警告はゼロ
• Ed25519＋SHA-256 — @noble/ed25519 を使用（監査済み、純粋な JavaScript）
• SQLite＋FTS5 — ローカル優先の全文メモリー検索

ポータブルメモリーバンドル

エージェントのメモリー全体を、検証可能な単一のファイルとしてエクスポートできます。

npx @agent-receipts/cli memory export > my-project.bundle.json

バンドルには、すべてのエンティティ、観察、関係性、それらを作成したレシート、そしてすべてを検証するために必要な公開鍵が含まれます。別のエージェント、別のチーム、または別の Agent Receipts インスタンスに渡せば、相手はあなたを信頼することなく、すべての事実を検証できます。

リンク

~/.agent-receipts/
├── keys/
│   ├── private.key    # Ed25519 private key (mode 0600)
│   └── public.key     # Ed25519 public key
├── receipts.db        # SQLite database (receipts + memory)
└── config.json        # Agent and org configuration

パッケージ

ロードマップ

• クラウドティア — チームダッシュボード、複数エージェント間のメモリー同期、組織間検証
• セマンティック検索 — 埋め込み表現を活用したメモリー検索
• フレームワークアダプター — LangChain、CrewAI、AutoGen との統合
• 組織間の信頼ブリッジ — 2 つの組織が互いのエージェントのレシートを検証

ライセンス

MIT

Amin Suleiman が開発 — ModQuote と Agent Receipts を開発しています。