変更前にプレビューする
dry_run=trueを使って、5つのreleased reflection action、そのcount、candidate detailを確認してから、summary、promotion、expiry、decay、archiveのwriteを許可します。
公開 MCP ツール
reflect
用途
dry-run計画とaudit evidenceを伴う、boundedなDream/Reflection maintenance passを実行し、consolidationとmemory-lifecycleの判断を報告します。選択したwriteは任意で適用できます。
適用シーン
- 認可されたoperatorまたはmaintenance workerが、最近のepisodic memoryをsemantic reflection recordに要約する場合。
- 繰り返し現れるepisodic evidenceを確認し、それをdurable semantic factにするか判断する場合。
- 認可されたowner/team/scope boundaryに対して、expiry、importance decay、archiveを明示的かつboundedに実行する場合。
非推奨シーン
- 通常のuser-requested durable factには使わないでください。rememberまたはSDK capture helperを使います。
- general search、context recall、hard delete toolとして使わないでください。recall_context、search_memory、またはgoverned forget surfaceを使います。
- callerがcandidateを評価しているだけ、またはmemoryを変更する明示的な認可がない場合はdry_runを省略しないでください。
- このtoolをより広いLight/REM/Deep Dream designやautonomous schedulerとして説明しないでください。shipped surfaceはこの5つのactionだけです。
必須スコープ
- dry_run=trueにはmemory:read、write runにはmemory:writeが必要です。
- catalogではreflectをminimal public marketplace-app toolではなくinternal maintenance surfaceとして分類しています。認可されたmaintenanceまたはdirect MCP contextからだけ使用してください。
- owner、bucket、scope、team、bound-space、agent authorizationはserverが解決します。callerのfilterでこのboundaryを広げることはできません。
パラメーター
| 名前 | 型 | 説明 |
|---|---|---|
actions_csv | string · デフォルト: summarize,promote,expire,decay,archive | comma-separated actionです。shipped actionはsummarize、promote、expire、decay、archiveで、summary、promotion、expiry、importance_decayなどのaliasはcompactorがnormalizeします。 |
dry_run | boolean · デフォルト: false | trueの場合、consolidationやlifecycle writeを行わずcandidateとcountを計算します。reviewではこれを優先してください。 |
time_window_hours | number · デフォルト: 24.0 | episodic summarize/promoteの選択に使う正のlookback windowです。指定されるとsinceが優先されます。 |
since / until | string · デフォルト: empty | reflection windowの任意のISO 8601 boundaryです。不正なtimestampは拒否されます。 |
path_filter / owner_filter | string · デフォルト: % / authenticated owner | logical pathとownerのfilterです。serverはowner filterを認証済みcontextに対して解決します。 |
bucket / scope / team_id | string · デフォルト: % / empty / empty | 任意のmemory boundary filterです。明示的なteam_idはboundまたは認証済みteam contextと一致する必要があります。 |
limit | integer · デフォルト: 500 | compactorに渡すcandidate budgetの最大値です。implementationは対応範囲内に制限します。 |
返却スキーマ
compactorはdry_run、normalized actions、filters、summaries、promotions、lifecycle details、counts.summarized/promoted/expired/decayed/archived、audit_record_idsを含むreportを構築します。MCP text responseは'### Memory Reflect Report'で始まり、Dry Run、Actions、5つすべてのcount、Audit Records、最大20件のAudit IDを表示します。
使用例
reflect({
actions_csv: "summarize,promote,expire,decay,archive",
dry_run: true,
time_window_hours: 24,
limit: 500
})reflect({
actions_csv: "archive",
dry_run: false,
bucket: "personal",
limit: 100
})エラー
- 401/403: dry_runに必要なread scope、mutating runに必要なwrite scopeがないか、要求されたowner/team/bound spaceが認可されていません。
- Validation failure: actionがunsupported、time_window_hoursがpositiveでない、since/untilがISO 8601でない、またはboundary/limit valueが無効です。
- Team authorization failure: 認可されていないteam lifecycle mutationは、暗黙に適用せず拒否されます。
- Concurrency or audit failure: memoryの変更、不完全なstatus transition、またはconsolidation auditのfailureはrollbackされるかerrorとして報告されます。
関連ツール
- recall_context — maintenanceが必要か判断する前にbounded context packを読みます。
- remember — consolidation passを実行せず、明示的に依頼されたdurable factを1件保存します。
- search_memory — lifecycle maintenanceではなくretrievalが必要なとき、認可済みmemoryを検索します。