# recall_context

sessionをまたいで作業を続けるために必要な、最近のprojectとagent contextを復元します。

- Canonical: https://docs.xmemo.dev/ja/docs/tools/recall-context
- Locale: ja-JP
- Content-Locale: ja-JP
- Canonical-Content-Digest: 0767dc0a1fcb4e59857a76cce464ac0c81e3dccf483200c4310a35325dccee22
- Edition-Digest: 413f401682d271bf4d0c9eed83e4a17d8ea2f2cb121ac54df36cf4c5c7512511
- Source-Revision: sha256:0000db16929d847dd06d0f100593276843962eb54fb925e1a5f66997e039974c

## Tool Reference: `recall_context`

### Purpose

構造化されたitemとtoken budgetで制限されたcontext textを含むbounded multi-memory context packを読み取ります。何も変更しません。

### Parameters

- `query` (string, required): context packを組み立てる対象の自然言語queryです。
- `max_items` (integer, optional, default: 8): packに含めるmemoryの最大数です（1-50）。
- `max_tokens` (integer, optional, default: 1500): rendered contextの最大token長です（1-12000）。

### Returns

Public MCP profileはstructured objectではなくtextを返します。'### XMemo Context' headingと'Items: <n>' lineで始まり、resultがdropまたはshortenされた場合は'Budget: ...' lineを追加します。その後、各itemをliteral formの'Reference: <id> | Type: <type> | Location: <path>'で1行ずつ表示し、最後に'Context:' labelとbounded context bodyを続けます。一致するものがない場合は'No matching XMemo memory was found.'と表示します。referenceはopaque identifierとして扱ってください。Non-public profileはstructured pack（version、retrieval_plan、budget、items、context_text）を返せます。

### Errors

- 401/403: requestにmemory:readがない、または該当する場合にtemporary-memory read capabilityがありません。
- 422: max_items、max_tokens、または明示的なlimitが対応するbudget/candidate範囲を超えています。
- Validation failure: queryまたは任意のfilterが不正な形式です。

### Examples

#### Taskの前にcontextを復元する



```typescript
recall_context({
  query: "recent decisions on the memory-os project",
  max_items: 6,
  max_tokens: 1200
})
```

### Related Tools

- [recall](/docs/tools/recall): 1件のquick answerには軽量なbest-effort pathを選びます。
- [search_memory](/docs/tools/search): 弱いresultが安全でない場合はstrict matchingを選びます。
- [remember](/docs/tools/remember): capture policyの承認後に新しい永続contextを保存します。

## 実際に消費されたbudgetを確認する

responseはused_itemsとused_tokensを報告するため、本当に小さいanswerなのか、途中でtruncateされたanswerなのかを区別できます。

```ts
recall_context({ query: "recent decisions", max_items: 6, max_tokens: 1200 })
```