コンテンツにスキップ

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

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

session オペレーション

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

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

session.brief_delete

ユーザーから忘れるよう求められた場合に、brief_key を指定してセッションブリーフを削除します。

POST /v1/session.brief_delete · MCP loom_session_brief_delete · ロール writer · 冪等 · 監査対象 · MCP の all ツールセットには含まれません

入力フィールド 型 デフォルト 意味
org str 必須 テナント(識別タプルの最初の要素)。
namespace str 必須 この op が読み書きする名前空間。
agent str 必須 書き込みまたは読み取りを行うエージェント。op が許可する場合、'-' または '*' は任意のエージェントを意味します。
user_id str '-' 行が属するエンドユーザー。なしの場合は '-'。
session_id str '-' 行が属するセッションまたは会話。なしの場合は '-'。
run_id str '-' 呼び出しが属するエージェントの実行(タスクスコープ)。なしの場合は '-'。
brief_key str 必須 削除するブリーフ。session.brief_list に表示されるキーで指定します。
出力フィールド 型 意味
deleted bool このキーを持つ有効なブリーフがない場合(不明、または削除済み)は False。
brief_key str 入力の brief_key をそのまま返したもの。
revision int 削除時点でのブリーフのリビジョン。何も削除されなかった場合は 0。

session.brief_get

ブリーフを読み込みます。brief_key を指定した場合はそのブリーフを、指定がなければ指定したセッションが書き込んだ最新のブリーフ(from_session)を、それもなければ project の最新のブリーフを読み込みます。

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

入力フィールド 型 デフォルト 意味
org str 必須 テナント(identity タプルの最初の要素)。
namespace str 必須 この op が読み書きする名前空間。
agent str 必須 書き込みまたは読み取りを行うエージェント。op が許す場合、'-' または '*' は任意のエージェントを意味します。
user_id str '-' 行が属するエンドユーザー。なしの場合は '-'。
session_id str '-' 行が属するセッションまたは会話。なしの場合は '-'。
run_id str '-' 呼び出しが属するエージェントの実行(タスクスコープ)。なしの場合は '-'。
brief_key str '' 読み込むブリーフ。from_session と project より優先されます。
from_session str '' このセッション ID が寄与した最新のブリーフを読み込みます。
project str '' このプロジェクトの最新のブリーフを読み込みます(brief_key と from_session が空の場合に使用)。
revision int 0 0 = 現在のリビジョン。N = 履歴にあるそのリビジョン。
include_sections bool False 構造化された sections も返します。False の場合は rendered のみを返します。
full bool False クライアント自身の最後のコンパクション時の要約を、ブリーフの下にそのまま追加します(最大で約 15k 文字追加)。
出力フィールド 型 意味
found bool 一致するブリーフがない、ブリーフが削除されている、またはリビジョンが履歴にない場合は False。
brief_key str 一致したブリーフのキー。
revision int 返されたリビジョン(revision を指定しない限り現在のもの)。
rendered str テキストとしてのブリーフ。full の場合は、クライアントのコンパクション要約が末尾に追加されます。
sections BriefSections \| None 構造化されたブリーフ。include_sections を設定しない限り None。
project str ブリーフに保存されているプロジェクト。
branch str ブリーフに保存されているブランチ。
head_sha str このリビジョンが保存されたときにチェックアウトされていたコミット。
author str リビジョンの書き手:llm、deterministic、または model(呼び出したエージェント)。
trigger str リビジョンの保存のきっかけ(precompact、session_end、stop、manual、model)。
actor str リビジョンを保存したプリンシパル(human:<subject> / process:<subject>)。名前空間全体の書き込み権限を持つ書き手は、ユーザー自身の ~<user>~ ブリーフに保存できます。
source_sessions list[str] ブリーフに寄与したセッション ID(古い順、最新の 20 件)。
updated_at datetime \| None 返されたリビジョンが保存された日時。
age_seconds int updated_at からの経過秒数。
revisions int ブリーフの履歴に含まれるリビジョン数。
events_total int ブリーフの全期間でブリーフに要約されたイベント数。
source_chars int ブリーフの全期間でブリーフに要約されたイベントテキストの文字数。
brief_chars int 保存されている rendered の長さ(文字数)。
deleted bool ブリーフが書き手によって削除された場合は True。この場合、ほかには何も返されません。

session.brief_list

この名前空間のセッションブリーフを新しい順に一覧表示します。キー、リビジョン、経過時間、エージェント、ゴールを1ブリーフにつき1行で返します。

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

入力フィールド 型 デフォルト 意味
org str 必須 テナント(識別タプルの最初の要素)。
namespace str 必須 op が読み書きする名前空間。
agent str 必須 書き込みまたは読み取りを行うエージェント。op が許可する場合、'-' または '*' は任意のエージェントを意味します。
user_id str '-' 行が属するエンドユーザー。なしの場合は '-'。
session_id str '-' 行が属するセッションまたは会話。なしの場合は '-'。
run_id str '-' 呼び出しが属するエージェントの実行(タスクスコープ)。なしの場合は '-'。
project str '' このプロジェクトのブリーフのみ。空の場合はすべてのプロジェクト。
mine_only bool False True の場合は呼び出し元エージェントのブリーフのみ。デフォルトではすべてのエージェントのブリーフ。
from_session str '' このセッション ID が寄与したブリーフのみ。空の場合はセッションによる絞り込みなし。
limit int 10 返すブリーフの最大数(1-50)。
出力フィールド 型 意味
briefs list[SessionBriefSummary] 有効なブリーフ。最後に保存されたものが先頭。名前空間にブリーフがない場合は空。
rendered str ブリーフ1件につき1行。そのまま表示できる形式。

session.brief_save

ブリーフを1件更新(または新規作成)します。

POST /v1/session.brief_save · MCP loom_session_brief_save · ロール writer · 冪等 · 監査対象 · MCP の all ツールセットには含まれません

入力フィールド 型 デフォルト 意味
org str 必須 テナント(アイデンティティタプルの最初の要素)。
namespace str 必須 op が読み書きする名前空間。
agent str 必須 書き込みまたは読み取りを行うエージェント。op が許可する場合、'-' または '*' は任意のエージェントを意味します。
user_id str '-' 行が属するエンドユーザー。なしの場合は '-'。
session_id str '-' 行が属するセッションまたは会話。なしの場合は '-'。
run_id str '-' 呼び出しが属するエージェントの実行(タスクスコープ)。なしの場合は '-'。
brief_key str '' 名前空間内でのブリーフのアドレス。
project str '' 作業が属するプロジェクト。branch と合わせて自動キーを構成します。
repo str '' 作業対象のリポジトリ。ブリーフに保存されます。空の場合は保存済みの値を保持します。
branch str '' 作業中のブランチ。project と合わせて自動キーを構成します。
head_sha str '' 保存時にチェックアウトされていたコミット。空の場合は保存済みの値を保持します。
trigger Literal['precompact', 'session_end', 'stop', 'manual', 'model'] 'manual' 保存のきっかけ。manual と model は常に保存します。自動の precompact、session_end、stop は、名前空間の記録がオフの間は何も保存しません。
events list[BriefEvent] (算出) 前回の保存以降に起きたこと(最大4000件のイベント)。リビジョンにまとめられます。
sections BriefSections \| None None 呼び出し元のエージェントが自身のコンテキストから書いたブリーフ。入力されたセクションが保存済みのものを置き換えます(決定事項と行き止まりは追記されます)。
event_cursor str '' イベントが終わるクライアント側の位置を示す不透明な値(トランスクリプトの行インデックス)。
if_revision int \| None None Compare-and-set:保存済みのリビジョンがこの値でない限り拒否します(409)。
use_llm bool \| None None 決定論的ビルダーを強制する(False)か、モデルを強制する(True)か。None の場合はデプロイメントの設定に従います。
出力フィールド 型 意味
brief_key str ブリーフが保存されたキー(キー未指定の場合は解決された自動キー)。
revision int この呼び出し後のブリーフのリビジョン(変更がない場合は保存済みのもの。有効なものがない場合は 0)。
changed bool 新しいリビジョンが書き込まれた場合は True。書き込まれなかった場合は False で、理由は reason に示されます。
author str "llm"(モデルが更新)、"deterministic"(モデルが未設定、または失敗した場合。オペレーターの抽出ポリシー下では発生しません)、"model"(呼び出し元のエージェントがセクションを書いた)。
reason str 何も書き込まれなかった理由:nothing-to-save、recording_off、already-saved、not-revised(オペレーターの抽出ポリシーが有効で、ブリーフを更新するモデルがない)。changed の場合は空。
rendered str そのまま表示できるテキスト形式のブリーフ。変更がない場合は保存済みのもの。
stats SessionBriefStats この保存の集計:イベント、ウィンドウ、サイズ、トークン、使用したモデル。