コンテンツにスキップ

未翻訳のページは英語で開き、英語と表示されます。

このページは英語の原文の機械翻訳です。内容は英語の原文が優先されます。 Machine-translated from the English page, which is authoritative.

context オペレーション

各 context.* オペレーションが受け取るフィールドと返すフィールドの詳細です。

すべてのオペレーションは、HTTP では POST /v1/<op>、MCP ツールでは loom_<op> として呼び出せます。ID フィールド(org、namespace、agent、user_id、session_id)は、トランスポートが対応している場合、トークンと MCP セッションから補完されます。シングルユーザーサーバーでトークンなしの HTTP 呼び出しを行う場合、code.* と tracker.* 以外のすべてのオペレーションではインストールの org が使われ(この 2 つはそれぞれのプレーンの org を維持します)、一部のオペレーションでは名前空間とエージェントも補完されます。詳しくはID と名前空間を参照してください。ロール、種別、MCP の all 一覧については、オペレーション一覧で説明しています。未知の入力フィールドは受け付けられ、ignored_args に名前が記録されます。

context.fetch

パークされた結果をキーで読み戻します。文字単位のスライス(offset/limit)か、正規表現(pattern、context_lines 付き)に一致する行のみを取得できます。

POST /v1/context.fetch · MCP loom_context_fetch · ロール viewer · 読み取り · MCP の all ツールセットには含まれません

入力フィールド 型 デフォルト 意味
org str 必須 テナント(アイデンティティタプルの最初の要素)。
namespace str 必須 op が読み書きする名前空間。
agent str 必須 書き込みまたは読み取りを行うエージェント。op が許す場合、'-' または '*' は任意のエージェントを意味します。
user_id str '-' 行が属するエンドユーザー。なしの場合は '-'。
session_id str '-' 行が属するセッションまたは会話。なしの場合は '-'。
run_id str '-' 呼び出しが属するエージェントの実行(タスクスコープ)。なしの場合は '-'。
blob_key str 必須 context.offload が返したキー。
offset int 0 スライスを開始する文字オフセット。pattern 指定時は、スキップする一致の数。
limit int 4000 1 回の呼び出しで返す内容の最大文字数(1-64000)。
pattern str '' 正規表現(RE2 構文、大文字小文字を区別しない。後方参照と先読み・後読みは不可)。
context_lines int 0 pattern 指定時に、各一致の前後に表示するコンテキスト行数(0-10)。コンテキスト行には lineno-、一致行には lineno: が付きます。
出力フィールド 型 意味
found bool 名前空間内にこのキーを持つ有効で期限切れでないブロブがない場合は false。
blob_key str 入力の blob_key のエコー。
content str 文字スライス。pattern 指定時は、一致した行を lineno: text 形式で返します。
content_type str ブロブとともに保存されたメディアタイプ。
summary str ブロブとともに保存された要約。
total_chars int 保存されたコンテンツ全体の文字数。
total_lines int 保存されたコンテンツ全体の行数。
offset int 入力の offset のエコー。
next_offset int スライス(または一致リスト)を読み尽くした場合は -1。
matched_lines int pattern 指定時は、コンテンツ全体で一致した行数。それ以外は 0。
expires_at datetime \| None ブロブが取得できなくなる時刻。見つからない場合は None。

context.offload

大きなツール結果(ログ、ページ、diff、クエリ出力)をモデルのコンテキストの外に退避します。

POST /v1/context.offload · MCP loom_context_offload · ロール writer · 冪等 · MCP の all ツールセットには含まれません

入力フィールド 型 デフォルト 意味
org str 必須 テナント(識別タプルの最初の要素)。
namespace str 必須 op が読み書きする名前空間。
agent str 必須 書き込みまたは読み取りを行うエージェント。op が許可する場合、'-' または '*' は任意のエージェントを意味します。
user_id str '-' 行が属するエンドユーザー。なしの場合は '-'。
session_id str '-' 行が属するセッションまたは会話。なしの場合は '-'。
run_id str '-' 呼び出しが属するエージェントの実行(タスクスコープ)。なしの場合は '-'。
content str 必須 退避するテキスト。LOOM_CONTEXT_OFFLOAD_MAX_BYTES(UTF-8 バイト)を超えると 413 になります。
blob_key str '' 空の場合はコンテンツアドレス方式(blob/<sha256 prefix>)になります。同じ出力を 2 回退避しても、同じキーになり、保存される行は 1 つです。
content_type str 'text/plain' コンテンツとともに保存され、context.fetch が返すメディアタイプ。
summary str '' 呼び出し側が指定する 1 行の要約(ツール名と返された内容)。
ttl_seconds int 604800 blob を取得可能な状態に保つ秒数(1 分から 90 日)。
出力フィールド 型 意味
blob_key str コンテンツを取得するためのキー。指定したキー、または blob/<sha256 prefix>。
content_bytes int 保存されたコンテンツのサイズ(UTF-8 バイト)。
content_chars int 保存されたコンテンツの文字数。
sha256 str コンテンツの SHA-256 16 進ダイジェスト。
summary str blob とともに保存された要約。指定した要約、またはコンテンツの先頭 200 文字。
expires_at datetime blob が取得できなくなる日時。
pointer str トランスクリプト内でコンテンツの代わりにそのまま使える文字列。

context.pack

タスクのメモリ、決定事項、手順:Loom のフックがこのセッションに Loom のコンテキストをすでに入れている場合を除き、各タスクの最初に呼び出します。

POST /v1/context.pack · MCP loom_context_pack · ロール viewer · 読み取り

入力フィールド 型 デフォルト 意味
org str 必須 テナント(識別タプルの最初の要素)。
namespace str 必須 op が読み書きする名前空間。
agent str 必須 書き込みまたは読み取りを行うエージェント。op が許す場合、'-' または '*' は任意のエージェントを意味します。
user_id str '-' パックの読み取り対象のユーザー。"-" の場合、memories、profile、procedures、runs の各セクションではすべてのユーザーを読み、stack と working-memory の各セクションではユーザーに紐づかない行を読みます。
session_id str '-' パックの読み取り対象のセッション。"-" の場合、memories セクションではすべてのセッションを読み、stack と working-memory の各セクションではセッションに紐づかない行を読みます。
run_id str '-' 呼び出しが属するエージェントの実行(タスクスコープ)。なしの場合は '-'。
query str '' 関連するメモリやドキュメントを選ぶために使う、任意のタスクまたは質問。
situation str '' 手順の照合に使う、任意の状況の説明。
procedure_explore_rate float \| None None procedures セクションの探索率。None は 0(探索しない)。
token_budget int 2000 レンダリングしたパック全体のサイズ上限(トークン単位、1 トークンは約 4 文字)。これより長いパックは切り詰められ、truncated が設定されます。
top_k int 5 検索に基づく各セクションが要求するヒット数(procedures と stack のナレッジ層は上限が 5)。
read_scope Literal['namespace', 'own_user', 'own_session'] 'namespace' memory.search.read_scope と同じ意味。この op の user_id / session_id に結び付きます。
mode Literal['startup', 'task', 'debug', 'handoff'] 'task' セクションの予算と検索のレシピ。どのモードでも LLM 呼び出しはありません。startup(高速な想起。query がない場合はピン留めと最近のメモリを返す)、task と handoff(バランス型)、debug(品質重視)。
include_knowledge bool False 一致するドキュメントチャンクの knowledge セクションを追加します。query が必要です。
include_conversations bool False 一致する過去のメッセージの conversations セクションを追加します。query が必要です。
include_runs bool False runs マニフェスト。この識別情報の最近のセッションを 1 件 1 行で、新しい順に runs_limit 行まで並べます(日付、実行のステータスと目標、種類別のツール呼び出しとエラー、触れたファイル、ダイジェスト)。
runs_limit int 12 include_runs を設定したときに、runs マニフェストが一覧にする最近のセッション数(1〜50)。
include_chunks bool False memories 検索のリランカープールを、最近の候補 20 件で広げます。リランカーがない場合は効果がありません。
section_token_budgets dict[str, int] (算出) モードのデフォルトを上書きする、セクション名をキーにしたセクションごとのトークン予算。セクションには最低でも 80 トークンが割り当てられます。
block_order list[str] (算出) 呼び出し側が指定する、任意のブロック順序。
session_block str '' 呼び出し側自身のセッションのしおり(session:<project>、プラグインの Stop フックのメモ)。
only_sections list[Literal['working_memory', 'memory_stack', 'profile', 'memories', 'procedures', 'decisions', 'knowledge', 'conversations', 'runs', 'namespace_health', 'namespace_guide', 'mentor']] (算出) パックをこれらのセクションに限定します。
include_decisions bool True decision 型のヒットは memories ブロックから外れ、構造化レコード(シナリオ、結果、実現した結果)を持つ、タグ付きの独立した セクションとしてレンダリングされます。
出力フィールド 型 意味
rendered str 1 つのテキストにしたパック。空でない各セクションを <name> タグで囲み、ブロック順に並べ、token_budget で切り詰めます。
sections dict[str, str] 名前ごとの各セクションの本文(ブロック順)。何もレンダリングされなかったセクションは含まれません。
blocks list[ContextBlock] 空でないセクションごとに 1 エントリ:ラベル、本文、トークン推定値、引用、ソース数、priority(ブロック順での位置)。
section_meta dict[str, dict[str, Any]] 名前ごとのセクション詳細:ソース数、引用、切り詰められたかどうか、サイズ、トークン予算、充填率(1.0 を超えると切り詰められたことを意味します)。
section_count int 何かをレンダリングしたセクションの数。
truncated bool いずれかのセクション、またはパック全体が予算に合わせて切り詰められた場合は True。
token_budget int 入力の token_budget のエコー。
mode str 入力の mode のエコー。
tokens_estimate int 予算に対する圧迫度。
fill_ratio float tokens_estimate / token_budget(小数第 3 位まで)。
stable_sections list[str] rendered の先頭から続く、query や situation に依存しない部分。この識別情報のワーキングメモリ、プロフィール、ピンが変わるまで、どの質問に対しても同じバイト列になります。
stable_prefix_chars int rendered のその先頭部分の文字数。最初のセクションがクエリに依存する場合は 0。
stable_hash str 安定した先頭部分の SHA-256。stable_prefix_chars が 0 の場合は空。
procedure_keys list[str] パックがエージェントに提示した手順:ユーティリティが必要とする台帳の「提示した」側。
procedure_keys_withheld list[str] パックが一致と判定したうえで、意図的に提示しなかった手順:同じ台帳の「提示しなかった」側。