Strata

ポータブルなエージェントメモリ。追記専用レコード、検証済みの来歴、MCP ツール、セルフホスティング。

Strata は、プロジェクトを混在させず、シークレットを漏らさず、履歴を書き換えることなく、あらゆるエージェントが読み取り・更新できる、チーム向けの単一の永続メモリを提供します。人、セッション、マシン、ランタイムをまたぐ作業のために設計されています。

なぜ存在するのか

ローカルのエージェントメモリは、作業がマシン、人、ツール、または過去のセッションをまたぐと壊れます。Strata は、単一のエージェント実行を超えて残るべき事実を保持します：

• 実験結果と決定事項；

• データセットのメモ、ソースのチェックサム、抽出ステータス；

• うまくいった手順と避けるべき失敗；

• 後から参加するエージェントのためのプロジェクト引き継ぎ。

Strata は、シークレット、生のトランスクリプト、思考連鎖、API キー、プロバイダー設定を保存しません。

Related MCP server: mnemochain

同梱内容

クイックスタート

git clone https://github.com/rx6ru/strata.git
cd strata
python -m venv .venv
. .venv/bin/activate
python -m pip install -e .
strata --help

ローカルゲートウェイを起動します：

strata serve --root /tmp/strata-demo --host 127.0.0.1 --port 8787

別のシェルから確認します：

curl -fsS http://127.0.0.1:8787/healthz
curl -fsS -H 'X-Strata-Client: 1' http://127.0.0.1:8787/v1/status

パッケージをインストールする前にソースチェックアウトから実行している場合：

PYTHONPATH=. python -m strata --help
PYTHONPATH=. python -m strata root-hash --root /tmp/strata-demo

完全なセットアップガイドは docs/getting-started.md を参照してください。

エージェントの使い方

1. skills/strata/ をエージェントランタイムのスキルディレクトリにコピーします。

2. エージェントには、ゲートウェイ URL、ネームスペース、現在のタスク、SSH エイリアス、任意のライフサイクルラッパーパスなど、シークレット以外のランタイム値のみを渡します。

3. エージェントはポリシーを取得し、スコープ付きコンテキストを準備し、正規レコードを読み取り、検証済みの永続的な知識のみを書き込みます。

4. 修正は後続レコードを追記します。再編成は、移動、分割、統合、または無効化イベントを追記します。通常のエージェントは履歴をその場で編集することはありません。

このスキルは、ホスト名、IP アドレス、EC2 インスタンス ID、ユーザー名、API キー、プロジェクトネームスペース、ポリシーハッシュ、ルート、レコード ID をハードコードしません。docs/agent-skill.md を参照してください。

書き込みの整合性を保つ仕組み

Strata はコミット前にすべての書き込みをチェックします：

• コミット前に現在のポリシーハッシュが確認される；

• スキーマがレコードを検証する；

• 冪等性キーが重複リトライを防ぐ；

• 追記専用 SQLite トリガーが履歴のその場での編集をブロックする；

• コンテンツハッシュとルートマニフェストによりエクスポートを検証可能にする；

• シークレットと生トランスクリプトのスキャナーが安全でないペイロードを拒否する；

• 派生リコールは真実ではなくナビゲーションとしてラベル付けされる。

セルフホスティング

Docker スタックの場合：

./scripts/configure.sh
./scripts/control.sh start

システムサービスの場合は、インストールガイドと deploy/ 内の制約付きライフサイクルラッパーを使用してください。リモートエージェントは、status、start、stop、restart についてそのラッパーのみを呼び出す必要があります。

デフォルトのデプロイメントにはアプリレベルのユーザーはありません。ループバック、プライベートネットワーク、SSH、VPN、ファイアウォール、または独自のプロキシ/認証レイヤー上に配置してください。チームでのホスティング前に docs/security-model.md と SECURITY.md を読んでください。

REST と MCP

REST ゲートウェイは、/v1 配下に health、policy、status、search、recall、record、append、supersede、relocate、split、merge、invalidate のエンドポイントを公開します。

MCP ブリッジは、memory_policy、memory_prepare_context、memory_search、memory_get、memory_capture_verified、memory_status などの対応するツールを公開します。

評価

PYTHONPATH=. python -m strata eval --input tests/fixtures/strata_eval/cases.json

フィクスチャは、ネームスペースの分離、来歴、昇格と拒否の動作、派生リコールのラベル、禁止値の漏洩をチェックします。

ライセンス

MIT。LICENSE を参照してください。サードパーティの注記は THIRD_PARTY_NOTICES.md にあります。