:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 188:["Ai Now自動承認を設定"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 189:["Ai Nowプロンプトをキャンセル"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 18a:["Ai Nowセッションを閉じる"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 18b:["Ai Nowセッションイベントをストリーミング"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 18c:["Ai Nowセッションファイルを読み込む"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 18d:["Ai Nowメッセージを読み込む"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 18e:["Ai Nowメッセージを保存"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 18f:["Ai Now権限に応答"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 190:["Ai Nowセッションにプロンプト"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 191:["Ai Nowスキルプロンプトを同期"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 192:["Evolvesエッジを取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 193:["フィードイベントを取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 194:["フィードイベントを非表示"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 195:["Timelineレビューを解決"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 196:["イベントを再試行"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 197:["Timelineレビューのプレビューまたは確認"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 198:["Feedイベントの可視性の設定"," ",["$","span",null,{"className":"font-mono font-medium text-yellow-600 dark:text-yellow-400 ms-auto text-xs text-nowrap","children":"PUT"}]] 199:["質問を永続化"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 19a:["フィード入力ストリームを送信"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 19b:["メッセージを送信"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 19c:["セッションを読み込む"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 19d:["セッションを保存"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 19e:["ステータスを取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 19f:["ナレッジ処理ステータスを取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1a0:["ナレッジ処理タスクをキャンセル"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1a1:["スキルビルダーチャット"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1a2:["スキルビルダーインポート可能を検出"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1a3:["スキルビルダー本文編集"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1a4:["スキルビルダーインポート"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1a5:["スキルビルダーインポート可能をプレビュー"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1a6:["スキルビルダー提案"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1a7:["スキルビルダー改善"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1a8:["スキルビルダー改善ストリーム"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1a9:["エージェントステータスを取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1aa:["進行中タスクの概要を取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1ab:["トークン使用状況サマリーを取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1ac:["コミュニティ検出をトリガー"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1ad:["コミュニティ検出の計画"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1ae:["結晶化をトリガー"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1af:["デイリーブリーフィングをトリガー"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1b0:["減衰リフレッシュをトリガー"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1b1:["インサイト検出をトリガー"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1b2:["KG抽出をトリガー"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1b3:["KG抽出バックフィルの計画"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1b4:["ラベル統合をトリガー"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1b5:["メモリクリーンアップ候補のアーカイブ"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1b6:["メモリクリーンアップコンパクションのキューイング"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1b7:["メモリクリーンアップ候補の保持"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1b8:["メモリクリーンアップの計画"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1b9:["メモリ圧縮をトリガー"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1ba:["メモリコンパクションの計画"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1bb:["メモリ作成イベントの計画"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1bc:["ガイダンスレビューをトリガー"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1bd:["ガイダンスルールレビューのドライラン"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1be:["スキルコンパイルをトリガー"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1bf:["スキルレビューをトリガー"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1c0:["スケジュール済みエージェントコンテキストの計画"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1c1:["スレッド同期イベントの計画"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1c2:["ユニットタイプ再分類をトリガー"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1c3:["WM更新のトリガー"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1c4:["ワーキングメモリを取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1c5:["ワーキングメモリを更新"," ",["$","span",null,{"className":"font-mono font-medium text-yellow-600 dark:text-yellow-400 ms-auto text-xs text-nowrap","children":"PUT"}]] 1c6:["ワーキングメモリ履歴を取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1c7:["機能"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1c8:["コミュニティの一覧表示"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1c9:["コミュニティの詳細を取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1ca:["コンテンツストア移行ステータスを取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1cb:["レガシースレッドメッセージグラフをクリーンアップ"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1cc:["完了するまでスレッドメッセージをコピー"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1cd:["スレッドメッセージをバッチでコピー"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1ce:["スレッドメッセージを切り替え"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1cf:["スレッドメッセージアンカーを移行"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1d0:["カットオーバーを通じてスレッドメッセージを移行"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1d1:["スレッドメッセージのコピーを検証"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1d2:["Context Bundleの取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1d3:["データをチェックポイント"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1d4:["データをエクスポート"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1d5:["エクスポートデータのダウンロード"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1d6:["エクスポートステータスを取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1d7:["データをインポート"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1d8:["バックアップの内容を確認"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1d9:["インポートステータスを取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1da:["インポートデータのアップロード"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1db:["バックアップの内容を確認"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1dc:["エンティティの一覧表示"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1dd:["エンティティの削除"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 1de:["エンティティエイリアスの読み取り"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1df:["エンティティエイリアスの修正"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1e0:["エンティティ削除のプレビュー"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1e1:["エンティティのマージ"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1e2:["エンティティマージのプレビュー"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1e3:["エンティティの関係を取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1e4:["イベントストリーム"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1e5:["お気に入りメモリを取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1e6:["お気に入りスレッドを取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1e7:["Fsケイパビリティ"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1e8:["Fs Cat"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1e9:["選択したスペース内の正規のMemoryまたはCrystalパスを削除します。"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1ea:["Fs Find"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1eb:["Fs Grep"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1ec:["Fs Ls"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1ed:["Fs Recall"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1ee:["Fs Stat"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1ef:["Fs Write"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1f0:["グラフ分析の取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1f1:["拡張ジョブの一覧表示"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1f2:["PageRank更新の計画"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1f3:["拡張ジョブの開始"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1f4:["拡張状態の取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1f5:["ジョブステータスの取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1f6:["コミュニティメンバーの取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1f7:["隣接ノードの展開"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1f8:["グラフの探索"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1f9:["グラフ分析のヘルス"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1fa:["Identityを起点とするグラフを取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1fb:["ライブプレビューグラフの取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1fc:["ライブプレビュー隣接ノードの取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1fd:["ノード詳細の取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1fe:["孤立エンティティのクリーンアップ"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 1ff:["孤立エンティティの検出"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 200:["グラフ概要の取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 201:["グラフデータの取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 202:["グラフの検索"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 203:["最短経路の取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 204:["グラフ可視化"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 205:["ヘルスチェック"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 206:["強制チェックポイント"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 207:["アイデンティティカードを保存"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 208:["会話からアイデンティティカードを提案"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 209:["アイデンティティプロファイルの一覧表示"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 20a:["アイデンティティプロファイルの作成または更新"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 20b:["本人情報のプロフィールを削除"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 20c:["ラベルの一覧表示"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 20d:["ラベルを作成"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 20e:["ラベルを統合"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 20f:["ラベル統合をプレビュー"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 210:["ラベルの健全性"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 211:["ラベルを削除"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 212:["ラベルを取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 213:["ラベルを更新"," ",["$","span",null,{"className":"font-mono font-medium text-yellow-600 dark:text-yellow-400 ms-auto text-xs text-nowrap","children":"PUT"}]] 214:["ラベル削除の適用"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 215:["ラベル削除のプレビュー"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 216:["ラベルマージの適用"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 217:["ラベルマージのプレビュー"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 218:["ラベルをマージするエンドポイント"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 219:["ラベルのマージ候補"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 21a:["コミュニティの最近のメモリを取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 21b:["関連コミュニティを取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 21c:["コミュニティのサブグラフを取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 21d:["クリスタルのソースメモリを取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 21e:["ライブラリOKFエクスポートを取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 21f:["ライブラリWikiエクスポートを取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 220:["ライブラリWikiエクスポートサマリーを取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 221:["ライブラリWikiインデックスを取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 222:["Wikiページのクリスタルを取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 223:["Wikiページのエンティティを取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 224:["Wikiページのトピックを取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 225:["メモリを一覧表示"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 226:["メモリを作成"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 227:["メモリを一括削除"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 228:["メモリを一括移動"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 229:["メモリの一括移動をプレビュー"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 22a:["スレッドからメモリを蒸留"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 22b:["スレッド蒸留バッチの計画"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 22c:["Distillation計画の取得"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 22d:["Distillationのプレビュー"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 22e:["蒸留のスケジュール"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 22f:["会話のトリアージ"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 230:["Memory履歴修正の適用"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 231:["Memory履歴修正のプレビュー"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 232:["メモリのKG抽出コンテンツをプレビュー"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 233:["メモリを削除"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 234:["メモリを取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 235:["メモリを更新"," ",["$","span",null,{"className":"font-mono font-medium text-orange-600 dark:text-orange-400 ms-auto text-xs text-nowrap","children":"PATCH"}]] 236:["メモリをアーカイブ"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 237:["メモリを非推奨化"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 238:["メモリをエクスポート"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 239:["メモリのKG抽出を適用"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 23a:["メモリのKG抽出をプレビュー"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 23b:["メモリのお気に入りを切り替え"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 23c:["メモリを忘却"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 23d:["メモリアイデンティティ証拠の読み取り"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 23e:["メモリアイデンティティ出現箇所の修正"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 23f:["メモリアイデンティティの抽出または再検討"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 240:["メモリのラベルを取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 241:["メモリからラベルを削除"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 242:["メモリにラベルを割り当て"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 243:["メモリ関連を一覧表示"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 244:["メモリ関連を作成"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 245:["メモリ関連を提案"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 246:["メモリを置き換え"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 247:["メモリを一括再インデックス"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 248:["再インデックスステータスを取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 249:["メモリ関連を削除"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 24a:["メモリ関連を更新"," ",["$","span",null,{"className":"font-mono font-medium text-orange-600 dark:text-orange-400 ms-auto text-xs text-nowrap","children":"PATCH"}]] 24b:["メモリを検索"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 24c:["BGE M3のインストール"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 24d:["BGE M3ステータスの取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 24e:["モデルメモリのステータスを取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 24f:["モデルをアンロード"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 250:["NowledgeリソースURIの解決"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 251:["検索インデックスを再インデックス"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 252:["検索インデックス再インデックスのステータスを取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 253:["検索インデックスのステータスを取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 254:["エージェントプロフィールの取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 255:["エージェントプロフィールの作成"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 256:["エージェントプロフィールの削除"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 257:["エージェントプロフィールのパッチ"," ",["$","span",null,{"className":"font-mono font-medium text-orange-600 dark:text-orange-400 ms-auto text-xs text-nowrap","children":"PATCH"}]] 258:["エージェントプロフィールの更新"," ",["$","span",null,{"className":"font-mono font-medium text-yellow-600 dark:text-yellow-400 ms-auto text-xs text-nowrap","children":"PUT"}]] 259:["Agent Identityのエクスポート"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 25a:["Agent Identity使用状況の取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 25b:["Agent Identityのインポート"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 25c:["ポータブル設定のエクスポート"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 25d:["ユーザープロフィールの取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 25e:["ポータブル設定の復元"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 25f:["設定の復元をプレビュー"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 260:["ガイダンスルールの取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 261:["ガイダンスルールの作成"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 262:["ガイダンスルールの削除"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 263:["ガイダンスルールの更新"," ",["$","span",null,{"className":"font-mono font-medium text-yellow-600 dark:text-yellow-400 ms-auto text-xs text-nowrap","children":"PUT"}]] 264:["スキルを一覧表示"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 265:["スキルアクティビティを取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 266:["スキルを作成"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 267:["キュレーターのドライラン"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 268:["キュレーターの提案"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 269:["キュレーターの実行"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 26a:["スキルをマッチングエンドポイント"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 26b:["スキルホスト登録ステータス"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 26c:["スキルホストの登録を解除"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 26d:["スキルホストを登録"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 26e:["スキルホストの設定ディレクトリを設定"," ",["$","span",null,{"className":"font-mono font-medium text-yellow-600 dark:text-yellow-400 ms-auto text-xs text-nowrap","children":"PUT"}]] 26f:["スキルを取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 270:["スキルをアクティブ化"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 271:["スキルエンリッチメントを適用"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 272:["スキルバージョンを適用"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 273:["スキルをアーカイブ"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 274:["スキルを非アクティブ化"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 275:["スキルを却下"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 276:["スキルエンリッチメントを却下"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 277:["スキルの重複元"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 278:["スキルファイルを編集"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 279:["スキル評価を取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 27a:["評価ケースの一覧"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 27b:["評価ケースの追加"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 27c:["評価ケースの削除"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 27d:["評価ケースの更新"," ",["$","span",null,{"className":"font-mono font-medium text-orange-600 dark:text-orange-400 ms-auto text-xs text-nowrap","children":"PATCH"}]] 27e:["スキル評価を実行"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 27f:["スキル評価をストリーミング"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 280:["スキルを強化エンドポイント"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 281:["マージ先"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 282:["スキル結果を報告"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 283:["保留中のSkillバージョンの破棄"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 284:["Skillマージの取り消し"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 285:["代わりに強化"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 286:["ソースを一覧表示"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 287:["バッチを取り込む"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 288:["コンテンツを取り込む"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 289:["ファイルを取り込む"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 28a:["ファイルパスを取り込む"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 28b:["フォルダサマリーを取り込む"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 28c:["フォルダアップロードを取り込む"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 28d:["URLを取り込む"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 28e:["ソースを検索"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 28f:["ソースを削除"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 290:["ソース詳細を取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 291:["ソースを更新"," ",["$","span",null,{"className":"font-mono font-medium text-orange-600 dark:text-orange-400 ms-auto text-xs text-nowrap","children":"PATCH"}]] 292:["ソースコンテンツを取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 293:["ソースコンテンツを更新"," ",["$","span",null,{"className":"font-mono font-medium text-yellow-600 dark:text-yellow-400 ms-auto text-xs text-nowrap","children":"PUT"}]] 294:["ソース抽出をトリガー"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 295:["ソース画像を取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 296:["ソースラベルを取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 297:["ソースからラベルを削除"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 298:["ソースにラベルを割り当て"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 299:["ソースの生データを取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 29a:["ソースを再取得"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 29b:["スペースの取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 29c:["スペースの作成"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 29d:["スペース設定の更新"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 29e:["スペース名簿の取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 29f:["スペースの削除"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 2a0:["スペースの取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 2a1:["スペースの更新"," ",["$","span",null,{"className":"font-mono font-medium text-orange-600 dark:text-orange-400 ms-auto text-xs text-nowrap","children":"PATCH"}]] 2a2:["Spaceのマージ"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 2a3:["Spaceマージのプレビュー"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 2a4:["ストレージ情報を取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 2a5:["ストレージを最適化"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 2a6:["スレッドを一覧表示"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 2a7:["スレッドを作成"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 2a8:["スレッドの一括削除"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 2a9:["選択によるスレッドの一括削除"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 2aa:["スレッドを一括移動"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 2ab:["スレッドの一括移動をプレビュー"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 2ac:["会話を検出"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 2ad:["会話を生形式でエクスポート"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 2ae:["会話をインポート"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 2af:["会話をプレビュー"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 2b0:["スレッド履歴同期の完了をマーク"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 2b1:["会話を冪等にインポート"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 2b2:["インポート設定を取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 2b3:["インポート設定を更新"," ",["$","span",null,{"className":"font-mono font-medium text-yellow-600 dark:text-yellow-400 ms-auto text-xs text-nowrap","children":"PUT"}]] 2b4:["プロジェクトを非表示"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 2b5:["セッションを非表示"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 2b6:["プロジェクトを再表示"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 2b7:["セッションを再表示"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 2b8:["スレッドコンテンツの解析"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 2b9:["保存済み会話のプロジェクト一覧を取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 2ba:["スレッドを完全検索"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 2bb:["セッションを保存"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 2bc:["スレッドソースを取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 2bd:["スレッドサマリーを取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 2be:["スレッドを削除"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 2bf:["スレッドを取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 2c0:["スレッドにメッセージを追記"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 2c1:["スレッドカバレッジを取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 2c2:["スレッドをエクスポート"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 2c3:["スレッドのお気に入りを切り替え"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 2c4:["スレッドテールを調整"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 2c5:["保存済みThreadのタイトルを同じ記録のまま変更"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 2c6:["ウォッチャーを開始"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 2c7:["ウォッチャーステータスを取得"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 2c8:["ウォッチャーを停止"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 2c9:["埋め込みの作成"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 2ca:["アクティブな埋め込みモデルの一覧"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 2cb:["$","$L2cf","docs-sidebar-language",{"variant":"docs"}] 2cc:["$","div",null,{"className":"flex items-center gap-2 sm:gap-3","children":[["$","span",null,{"className":"site-logo-module__C8aePW__mark site-logo-module__C8aePW__docs","children":["$","$L2d0",null,{"src":"/images/nowledge-mem-logo.webp","alt":"Nowledge Mem","fill":true,"sizes":"32px","quality":100,"unoptimized":true,"className":"site-logo-module__C8aePW__image"}]}],["$","span",null,{"className":"font-sans text-lg sm:text-xl text-foreground tracking-tight whitespace-nowrap","children":[["$","span",null,{"className":"font-light","children":"Nowledge"}]," ",["$","span",null,{"className":"font-semibold","children":"Mem"}]]}]]}] 2cd:["$","$L2d1",null,{}] 2ce:["$","$L2",null,{"parallelRouterKey":"children","error":"$undefined","errorStyles":"$undefined","errorScripts":"$undefined","template":["$","$L3",null,{}],"templateStyles":"$undefined","templateScripts":"$undefined","notFound":"$undefined","forbidden":"$undefined","unauthorized":"$undefined"}] 2d9:T556,Use the target server's normal authentication and an explicit exact Space ID. No cross-Space fallback is performed. Requires a human actor with current write authority and the profile's current revision. Starting a removal also requires labs.identityGraph.enabled to be true (default false); turning it off does not block status, retries or background recovery for an already committed removal. The profile leaves active identity lists, candidates and context, and its AI Identity or member link is released; the linked AI Identity or member itself is unchanged. A permanent minimal tombstone retains the non-reusable ID, removal attribution and scoped source-matching evidence so historical references remain resolvable. Display names, aliases, context and card are cleared, while scoped former names and source IDs may remain as discovery-suppression evidence. Consuming that evidence in automatic discovery is a separate capability; this endpoint alone does not prevent rediscovery. Memories and their original text are retained; cleanup updates identity ledgers and support links. Human-confirmed mentions keep their attribution to the removed profile; machine-linked mentions become unresolved. complete: false means cleanup is pending or skipped_sources could not be rewritten; repair those sources and repeat the request. This request does not invoke a model.6:["$","$L2d2",null,{"toc":[],"full":true,"tableOfContent":{"style":"clerk"},"children":[["$","$L2d3",null,{"children":"Cut Over Thread Messages"}],["$","$L2d4",null,{"children":"$undefined"}],["$","$L2d5",null,{"lang":"en","children":[["$","div",null,{"className":"flex flex-row gap-2 items-center border-b pt-2 pb-6","children":[["$","$L2d6",null,{"markdownUrl":"/docs/api/content-store/thread-messages/cutover/post.md"}],["$","$L2d7",null,{"markdownUrl":"/docs/api/content-store/thread-messages/cutover/post.md"}]]}],["$undefined",["$","$L2d8",null,{"preloaded":{"docs":{"./openapi.json":{"components":{"schemas":{"AINowAutoApproveRequest":{"properties":{"enabled":{"default":false,"title":"Enabled","type":"boolean"}},"title":"AINowAutoApproveRequest","type":"object"},"AINowFileReadRequest":{"properties":{"path":{"title":"Path","type":"string"}},"required":["path"],"title":"AINowFileReadRequest","type":"object"},"AINowMessagesRequest":{"properties":{"messages":{"items":{"additionalProperties":true,"type":"object"},"title":"Messages","type":"array"}},"title":"AINowMessagesRequest","type":"object"},"AINowPermissionResponseRequest":{"properties":{"optionId":{"default":"reject","title":"Optionid","type":"string"}},"title":"AINowPermissionResponseRequest","type":"object"},"AINowPromptRequest":{"properties":{"attachments":{"items":{"additionalProperties":true,"type":"object"},"title":"Attachments","type":"array"},"displayContent":{"default":"","title":"Displaycontent","type":"string"},"displayMessageId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displaymessageid"},"promptBlocks":{"items":{"additionalProperties":true,"type":"object"},"title":"Promptblocks","type":"array"}},"title":"AINowPromptRequest","type":"object"},"AINowSessionCreateRequest":{"properties":{"activeSpaceId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Activespaceid"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"plugins":{"items":{"additionalProperties":true,"type":"object"},"title":"Plugins","type":"array"},"workingDir":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Workingdir"}},"title":"AINowSessionCreateRequest","type":"object"},"AINowSessionUpdateRequest":{"properties":{"activeSpaceId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Activespaceid"},"errorMessage":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Errormessage"},"llmModel":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Llmmodel"},"llmProvider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Llmprovider"},"messageCount":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Messagecount"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"plugins":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Plugins"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},"title":"AINowSessionUpdateRequest","type":"object"},"AINowSkillPromptsRequest":{"properties":{"content":{"default":"","title":"Content","type":"string"}},"title":"AINowSkillPromptsRequest","type":"object"},"AgentIdentityCard":{"properties":{"exported_at":{"type":"string"},"nowledge_identity_card":{"format":"int64","type":"integer"},"profile":{"$ref":"#/components/schemas/AgentProfileResponse"}},"required":["nowledge_identity_card","profile","exported_at"],"type":"object"},"AgentIdentityImportPayload":{"properties":{"force":{"description":"Replace an existing profile with the same canonical ID.","type":["boolean","null"]},"nowledge_identity_card":{"format":"int64","type":"integer"},"profile":{"$ref":"#/components/schemas/AgentProfileCardPayload"}},"required":["nowledge_identity_card","profile"],"type":"object"},"AgentIdentityImportResponse":{"properties":{"imported":{"type":"boolean"},"profile":{"$ref":"#/components/schemas/AgentProfileResponse"}},"required":["profile","imported"],"type":"object"},"AgentKeyUsageResponse":{"properties":{"agent_label":{"type":["string","null"]},"created_at":{"type":"string"},"key_id":{"type":"string"},"last_used_at":{"type":["string","null"]},"legacy_name_match":{"type":"boolean"},"member_id":{"type":["string","null"]},"revoked":{"type":"boolean"}},"required":["key_id","created_at","revoked","legacy_name_match"],"type":"object"},"AgentProfileCardPayload":{"additionalProperties":false,"properties":{"defaultSpaceId":{"type":["string","null"]},"description":{"type":["string","null"]},"displayName":{"type":["string","null"]},"hostAgentId":{"type":["string","null"]},"id":{"type":"string"},"instructions":{"type":["string","null"]},"role":{"type":["string","null"]},"sourceApp":{"type":["string","null"]},"tags":{"items":{"type":"string"},"type":["array","null"]}},"required":["id"],"type":"object"},"AgentProfilePatchPayload":{"additionalProperties":false,"description":"Public wire contract for a partial Agent profile update.\n\nThe runtime handler deliberately keeps a JSON map so it can distinguish an\nomitted field from a present `null` or empty value. This type is the\ncode-first OpenAPI contract for the same canonical field set.","properties":{"defaultSpaceId":{"type":["string","null"]},"description":{"type":["string","null"]},"displayName":{"type":["string","null"]},"hostAgentId":{"type":["string","null"]},"instructions":{"type":["string","null"]},"role":{"type":["string","null"]},"sourceApp":{"type":["string","null"]},"tags":{"items":{"type":"string"},"type":["array","null"]}},"type":"object"},"AgentProfilePayload":{"properties":{"defaultSpaceId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Defaultspaceid"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"displayName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayname"},"hostAgentId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hostagentid"},"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instructions"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role"},"sourceApp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sourceapp"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags"}},"title":"AgentProfilePayload","type":"object"},"AgentProfileResponse":{"properties":{"defaultSpaceId":{"type":"string"},"description":{"type":"string"},"displayName":{"type":"string"},"hostAgentId":{"type":"string"},"id":{"type":"string"},"identityReference":{"description":"Server-authored opaque scoped incarnation for content profile links.\nNull means this legacy identity has no issued reference. Copy the\nobserved value into IdentitySubject.reference; do not derive it from\nid or reuse it after replacement.","readOnly":true,"type":["string","null"]},"instructions":{"type":"string"},"origin":{"description":"How this identity was born: `minted` | `claimed` | `managed` |\n`imported` (#1276 S4). Server-authored; read-only to clients.","type":"string"},"role":{"type":"string"},"sourceApp":{"type":"string"},"tags":{"items":{"type":"string"},"type":"array"}},"required":["id","displayName","role","description","instructions","defaultSpaceId","sourceApp","hostAgentId","tags","origin"],"type":"object"},"AgentProfileUsageResponse":{"properties":{"agent_profile_id":{"type":"string"},"computed_at":{"type":"string"},"keys":{"items":{"$ref":"#/components/schemas/AgentKeyUsageResponse"},"type":"array"},"last_key_used_at":{"type":["string","null"]},"last_memory_at":{"type":["string","null"]},"memories_created":{"format":"int64","type":"integer"},"spaces_touched":{"items":{"type":"string"},"type":"array"}},"required":["agent_profile_id","memories_created","spaces_touched","keys","computed_at"],"type":"object"},"AgentProfilesResponse":{"properties":{"agentProfiles":{"items":{"$ref":"#/components/schemas/AgentProfileResponse"},"title":"Agentprofiles","type":"array"}},"title":"AgentProfilesResponse","type":"object"},"AnalysisSummaryModel":{"properties":{"network_density":{"default":0,"description":"Graph network density","title":"Network Density","type":"number"},"total_communities":{"default":0,"description":"Total number of detected communities","title":"Total Communities","type":"integer"},"total_entities":{"default":0,"description":"Total number of entities","title":"Total Entities","type":"integer"},"total_memories":{"default":0,"description":"Total number of memories","title":"Total Memories","type":"integer"},"total_relationships":{"default":0,"description":"Total number of relationships","title":"Total Relationships","type":"integer"}},"title":"AnalysisSummaryModel","type":"object"},"AppendMessagesResponse":{"additionalProperties":true,"description":"Response from appending messages to thread.","properties":{"messages_added":{"description":"Number of messages added","title":"Messages Added","type":"integer"},"success":{"description":"Whether append succeeded","title":"Success","type":"boolean"},"thread_id":{"description":"Thread ID","title":"Thread Id","type":"string"},"total_messages":{"description":"Total messages in thread","title":"Total Messages","type":"integer"}},"required":["success","thread_id","messages_added","total_messages"],"title":"AppendMessagesResponse","type":"object"},"ArgumentGrant":{"allOf":[{"$ref":"#/components/schemas/ArgumentRule"},{"properties":{"required":{"type":"boolean"}},"type":"object"}]},"ArgumentRule":{"oneOf":[{"description":"The model may choose this value per occurrence (for example note body).","properties":{"mode":{"enum":["dynamic"],"type":"string"}},"required":["mode"],"type":"object"},{"description":"The argument must equal this JSON value (for example a document ID).","properties":{"mode":{"enum":["exact"],"type":"string"},"value":{}},"required":["value","mode"],"type":"object"},{"description":"The argument must be a string under this stable resource prefix.","properties":{"mode":{"enum":["prefix"],"type":"string"},"value":{"type":"string"}},"required":["value","mode"],"type":"object"},{"description":"The argument must equal one member of this bounded set.","properties":{"mode":{"enum":["one_of"],"type":"string"},"values":{"items":{},"type":"array"}},"required":["values","mode"],"type":"object"}]},"AugmentationJobItem":{"properties":{"created_at":{"title":"Created At"},"job_id":{"title":"Job Id","type":"string"},"job_type":{"title":"Job Type","type":"string"},"message":{"title":"Message"},"progress":{"title":"Progress"},"status":{"title":"Status","type":"string"}},"required":["job_id","job_type","status","progress","message","created_at"],"title":"AugmentationJobItem","type":"object"},"AugmentationJobListResponse":{"properties":{"jobs":{"items":{"$ref":"#/components/schemas/AugmentationJobItem"},"title":"Jobs","type":"array"},"success":{"title":"Success","type":"boolean"},"total":{"title":"Total","type":"integer"}},"required":["success","jobs","total"],"title":"AugmentationJobListResponse","type":"object"},"AugmentationJobStartResponse":{"properties":{"job_id":{"title":"Job Id","type":"string"},"job_type":{"title":"Job Type","type":"string"},"message":{"title":"Message","type":"string"},"success":{"title":"Success","type":"boolean"}},"required":["success","job_id","job_type","message"],"title":"AugmentationJobStartResponse","type":"object"},"AugmentationJobStatusResponse":{"properties":{"job_status":{"additionalProperties":true,"title":"Job Status","type":"object"},"success":{"title":"Success","type":"boolean"}},"required":["success","job_status"],"title":"AugmentationJobStatusResponse","type":"object"},"AugmentationStartRequest":{"description":"Request model for starting an augmentation job.","properties":{"job_type":{"title":"Job Type","type":"string"},"parameters":{"additionalProperties":true,"title":"Parameters","type":"object"}},"required":["job_type"],"title":"AugmentationStartRequest","type":"object"},"AugmentationStateModel":{"description":"Pydantic model describing the augmentation state response.","properties":{"state":{"additionalProperties":true,"title":"State","type":"object"},"success":{"title":"Success","type":"boolean"}},"required":["success","state"],"title":"AugmentationStateModel","type":"object"},"AuthorSkillRequest":{"description":"User-authored skill: a name, an optional intent note, and optional sources.","properties":{"memory_ids":{"description":"Memories to build the skill from","items":{"type":"string"},"title":"Memory Ids","type":"array"},"name":{"description":"What the user calls the skill","title":"Name","type":"string"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"When/why the AI should use it; the seed intent for a from-scratch skill","title":"Note"},"source_ids":{"description":"Library sources (Deep Create: dropped files / URLs / pasted text) whose content seeds the compile","items":{"type":"string"},"title":"Source Ids","type":"array"},"thread_ids":{"description":"Threads to build from; resolved to their source memories","items":{"type":"string"},"title":"Thread Ids","type":"array"}},"required":["name"],"title":"AuthorSkillRequest","type":"object"},"AutoImportRuleModel":{"description":"Model for auto-import rule.","properties":{"created_at":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Creation timestamp","title":"Created At"},"enabled":{"default":true,"description":"Whether rule is enabled","title":"Enabled","type":"boolean"},"id":{"description":"Rule ID","title":"Id","type":"string"},"type":{"description":"Rule type: project, path_pattern, or source","title":"Type","type":"string"},"value":{"description":"Value to match","title":"Value","type":"string"}},"required":["id","type","value"],"title":"AutoImportRuleModel","type":"object"},"BGEM3InstallRequest":{"description":"Request model for search embedding installation.","properties":{"download_source":{"default":"auto","enum":["huggingface","modelscope","auto"],"title":"Download Source","type":"string"},"force_reinstall":{"default":false,"title":"Force Reinstall","type":"boolean"}},"title":"BGEM3InstallRequest","type":"object"},"BGEM3InstallResponse":{"description":"Response model for search embedding installation.","properties":{"message":{"title":"Message","type":"string"},"reindex_required":{"default":true,"title":"Reindex Required","type":"boolean"},"success":{"title":"Success","type":"boolean"}},"required":["success","message"],"title":"BGEM3InstallResponse","type":"object"},"BGEM3StatusResponse":{"description":"Response model for search embedding model status.","properties":{"available_for_indexing":{"default":false,"title":"Available For Indexing","type":"boolean"},"backend":{"default":"auto","title":"Backend","type":"string"},"embedding_mode":{"default":"local","enum":["local","remote"],"title":"Embedding Mode","type":"string"},"embedding_runtime":{"$ref":"#/components/schemas/EmbeddingRuntime","description":"Runtime evidence about the configured embedding provider. Always sent by servers that support it, carrying zero counts before this process has run a search; absent entirely on older servers."},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"exists":{"title":"Exists","type":"boolean"},"index_metadata_update_needed":{"default":false,"title":"Index Metadata Update Needed","type":"boolean"},"index_metadata_update_reason":{"default":"","title":"Index Metadata Update Reason","type":"string"},"integrity_ok":{"default":false,"title":"Integrity Ok","type":"boolean"},"last_verified_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Verified At"},"message":{"title":"Message","type":"string"},"model_name":{"default":"search-embedding","title":"Model Name","type":"string"},"platform":{"default":"unknown","title":"Platform","type":"string"},"projection_repair_needed":{"default":false,"title":"Projection Repair Needed","type":"boolean"},"projection_repair_reason":{"default":"","title":"Projection Repair Reason","type":"string"},"reindex_needed":{"default":false,"title":"Reindex Needed","type":"boolean"},"reindex_reason":{"default":"","title":"Reindex Reason","type":"string"},"remote_model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Remote Model"},"remote_provider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Remote Provider"},"singleton_initialized":{"default":false,"title":"Singleton Initialized","type":"boolean"},"size_mb":{"default":500,"title":"Size Mb","type":"integer"},"smoke_test_ok":{"default":false,"title":"Smoke Test Ok","type":"boolean"},"state":{"default":"not_installed","title":"State","type":"string"},"verified":{"default":false,"title":"Verified","type":"boolean"}},"required":["exists","message"],"title":"BGEM3StatusResponse","type":"object"},"BatchIngestFile":{"description":"A single file in a batch ingestion request.","properties":{"file_path":{"description":"Absolute path to the file on disk","title":"File Path","type":"string"},"relative_path":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Path relative to source folder, for hierarchy","title":"Relative Path"},"size_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Enumerated file size hint","title":"Size Bytes"}},"required":["file_path"],"title":"BatchIngestFile","type":"object"},"BatchIngestRequest":{"description":"Request body for batch file ingestion (folder import from desktop app).","properties":{"accumulated_totals":{"anyOf":[{"additionalProperties":{"type":"integer"},"type":"object"},{"type":"null"}],"description":"Override counts for feed event metadata (used by chunked imports to report full-import totals)","title":"Accumulated Totals"},"emit_feed_event":{"default":true,"description":"Emit feed event on completion (set false for intermediate chunks)","title":"Emit Feed Event","type":"boolean"},"files":{"description":"Files to ingest","items":{"$ref":"#/components/schemas/BatchIngestFile"},"title":"Files","type":"array"},"folder_name":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Source folder name (for feed event title)","title":"Folder Name"},"labels":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Label names to assign to all ingested sources","title":"Labels"},"space_id":{"default":"default","description":"Isolation space for all ingested sources","title":"Space Id","type":"string"},"user_comment":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"User comment about the batch","title":"User Comment"}},"required":["files"],"title":"BatchIngestRequest","type":"object"},"BatchIngestResponse":{"description":"Response from batch ingestion endpoint.","properties":{"folder_name":{"default":"","title":"Folder Name","type":"string"},"message":{"default":"","title":"Message","type":"string"},"results":{"items":{"$ref":"#/components/schemas/IngestResponse"},"title":"Results","type":"array"},"total_duplicates":{"default":0,"title":"Total Duplicates","type":"integer"},"total_errors":{"default":0,"title":"Total Errors","type":"integer"},"total_ingested":{"default":0,"title":"Total Ingested","type":"integer"}},"title":"BatchIngestResponse","type":"object"},"Body_import_data_upload_data_import_upload_post":{"properties":{"file":{"contentMediaType":"application/octet-stream","title":"File","type":"string"},"include_communities":{"default":true,"title":"Include Communities","type":"boolean"},"include_edges":{"default":true,"title":"Include Edges","type":"boolean"},"include_entities":{"default":true,"title":"Include Entities","type":"boolean"},"include_labels":{"default":true,"title":"Include Labels","type":"boolean"},"include_memories":{"default":true,"title":"Include Memories","type":"boolean"},"include_messages":{"default":true,"title":"Include Messages","type":"boolean"},"include_skills":{"default":true,"title":"Include Skills","type":"boolean"},"include_source_files":{"default":true,"title":"Include Source Files","type":"boolean"},"include_sources":{"default":true,"title":"Include Sources","type":"boolean"},"include_threads":{"default":true,"title":"Include Threads","type":"boolean"},"include_working_memory":{"default":true,"title":"Include Working Memory","type":"boolean"},"include_working_memory_archive":{"default":true,"title":"Include Working Memory Archive","type":"boolean"},"mode":{"default":"merge","enum":["merge","skip","overwrite"],"title":"Mode","type":"string"}},"required":["file"],"title":"Body_import_data_upload_data_import_upload_post","type":"object"},"Body_ingest_folder_upload_sources_ingest_folder_upload_post":{"properties":{"accumulated_totals":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Accumulated Totals"},"emit_feed_event":{"default":true,"title":"Emit Feed Event","type":"boolean"},"file_manifest":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Manifest"},"files":{"items":{"contentMediaType":"application/octet-stream","type":"string"},"title":"Files","type":"array"},"folder_name":{"title":"Folder Name","type":"string"},"labels":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Labels"},"space_id":{"default":"default","title":"Space Id","type":"string"},"user_comment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Comment"}},"required":["files","folder_name"],"title":"Body_ingest_folder_upload_sources_ingest_folder_upload_post","type":"object"},"BulkDeleteMemoriesRequest":{"description":"Delete selected memories inside one source space.","properties":{"cascade_delete":{"default":true,"description":"Delete related graph artifacts","title":"Cascade Delete","type":"boolean"},"selection":{"$ref":"#/components/schemas/BulkMemorySelection"}},"required":["selection"],"title":"BulkDeleteMemoriesRequest","type":"object"},"BulkDeleteMemoriesResponse":{"description":"Result for a bulk memory delete.","properties":{"cascade_delete":{"default":true,"title":"Cascade Delete","type":"boolean"},"deleted_count":{"title":"Deleted Count","type":"integer"},"failed_count":{"default":0,"title":"Failed Count","type":"integer"},"message":{"title":"Message","type":"string"},"results":{"items":{"additionalProperties":true,"type":"object"},"title":"Results","type":"array"},"source_space_id":{"title":"Source Space Id","type":"string"}},"required":["deleted_count","source_space_id","message"],"title":"BulkDeleteMemoriesResponse","type":"object"},"BulkDeleteThreadsBySelectionRequest":{"description":"Delete selected threads inside one source space.","properties":{"cascade_delete_memories":{"default":false,"description":"Delete memories extracted from these threads","title":"Cascade Delete Memories","type":"boolean"},"selection":{"$ref":"#/components/schemas/BulkThreadSelection"}},"required":["selection"],"title":"BulkDeleteThreadsBySelectionRequest","type":"object"},"BulkDeleteThreadsRequest":{"description":"Request to delete multiple threads.","properties":{"thread_ids":{"description":"List of thread IDs to delete","items":{"type":"string"},"title":"Thread Ids","type":"array"}},"required":["thread_ids"],"title":"BulkDeleteThreadsRequest","type":"object"},"BulkDeleteThreadsResponse":{"additionalProperties":true,"description":"Response from bulk deleting threads.","properties":{"cascade_deletion":{"default":false,"description":"Whether cascade deletion was requested, not proof that any Memory was deleted. Cloud currently reports zero extracted Memory deletions.","type":"boolean"},"deleted_count":{"description":"Number of threads successfully deleted","title":"Deleted Count","type":"integer"},"deletion_outcome_uncertain":{"description":"At least one submitted graph outcome could not be confirmed. Counts include only confirmed commits; refresh before retrying.","type":"boolean"},"failed_count":{"default":0,"description":"Number of threads that failed to delete","title":"Failed Count","type":"integer"},"index_repair_pending":{"description":"Known search projection repair remains pending after the reported graph outcomes.","type":"boolean"},"message":{"description":"Success message","title":"Message","type":"string"},"partial_success":{"description":"Some deletions committed while the overall operation did not fully complete. Absence is not proof of rollback.","type":"boolean"},"results":{"description":"Detailed results for each thread deletion","items":{"additionalProperties":true,"properties":{"cascade_deletion":{"default":false,"description":"Whether cascade deletion was requested, not proof that any Memory was deleted. Cloud currently reports zero extracted Memory deletions.","type":"boolean"},"deleted":{"description":"Whether the parent Thread deletion was confirmed. False with deletion_outcome_uncertain is not proof that no write committed.","type":"boolean"},"deleted_memories":{"description":"Confirmed Memory deletions, including commits before a later failure. Never inferred from the requested cascade flag.","minimum":0,"type":"integer"},"deleted_messages":{"minimum":0,"type":"integer"},"deletion_outcome_uncertain":{"description":"At least one submitted graph outcome could not be confirmed. Counts include only confirmed commits; refresh before retrying.","type":"boolean"},"error":{"type":"string"},"index_repair_pending":{"description":"Known search projection repair remains pending after the reported graph outcomes.","type":"boolean"},"partial_success":{"description":"Some deletions committed while the overall operation did not fully complete. Absence is not proof of rollback.","type":"boolean"},"thread_id":{"type":"string"}},"type":"object"},"title":"Results","type":"array"},"total_deleted_memories":{"description":"Confirmed Memory deletions, including commits before a later failure. Never inferred from the requested cascade flag.","minimum":0,"type":"integer"},"total_deleted_messages":{"default":0,"description":"Total number of messages deleted","title":"Total Deleted Messages","type":"integer"}},"required":["message","deleted_count"],"title":"BulkDeleteThreadsResponse","type":"object"},"BulkMemorySelection":{"description":"Selection descriptor for bulk memory operations.","properties":{"exclude_memory_ids":{"items":{"type":"string"},"title":"Exclude Memory Ids","type":"array"},"memory_ids":{"items":{"type":"string"},"title":"Memory Ids","type":"array"},"mode":{"default":"ids","enum":["ids","space"],"title":"Mode","type":"string"},"source_space_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Space Id"}},"title":"BulkMemorySelection","type":"object"},"BulkMoveMemoriesRequest":{"description":"Move selected memories from one space into another.","properties":{"selection":{"$ref":"#/components/schemas/BulkMemorySelection"},"target_space_id":{"description":"Target space name or storage key","title":"Target Space Id","type":"string"}},"required":["selection","target_space_id"],"title":"BulkMoveMemoriesRequest","type":"object"},"BulkMoveMemoriesResponse":{"description":"Result for a bulk memory move.","properties":{"failed_count":{"default":0,"title":"Failed Count","type":"integer"},"index_repair_needed":{"default":false,"title":"Index Repair Needed","type":"boolean"},"index_updated_count":{"default":0,"title":"Index Updated Count","type":"integer"},"message":{"title":"Message","type":"string"},"moved_count":{"title":"Moved Count","type":"integer"},"source_space_id":{"title":"Source Space Id","type":"string"},"target_space_id":{"title":"Target Space Id","type":"string"}},"required":["moved_count","source_space_id","target_space_id","message"],"title":"BulkMoveMemoriesResponse","type":"object"},"BulkMovePreviewResponse":{"description":"Preview for a bulk memory move.","properties":{"count":{"title":"Count","type":"integer"},"excluded_count":{"default":0,"title":"Excluded Count","type":"integer"},"limit_exceeded":{"title":"Limit Exceeded","type":"boolean"},"max_allowed":{"default":5000,"title":"Max Allowed","type":"integer"},"message":{"title":"Message","type":"string"},"selection_mode":{"title":"Selection Mode","type":"string"},"source_space_id":{"title":"Source Space Id","type":"string"},"target_space_id":{"title":"Target Space Id","type":"string"}},"required":["count","limit_exceeded","source_space_id","target_space_id","selection_mode","message"],"title":"BulkMovePreviewResponse","type":"object"},"BulkMoveThreadsPreviewResponse":{"description":"Preview for a bulk thread move.","properties":{"conflicts":{"items":{"additionalProperties":true,"type":"object"},"title":"Conflicts","type":"array"},"count":{"title":"Count","type":"integer"},"excluded_count":{"default":0,"title":"Excluded Count","type":"integer"},"limit_exceeded":{"title":"Limit Exceeded","type":"boolean"},"max_allowed":{"title":"Max Allowed","type":"integer"},"message":{"title":"Message","type":"string"},"selection_mode":{"title":"Selection Mode","type":"string"},"source_space_id":{"title":"Source Space Id","type":"string"},"target_space_id":{"title":"Target Space Id","type":"string"}},"required":["count","max_allowed","limit_exceeded","source_space_id","target_space_id","selection_mode","message"],"title":"BulkMoveThreadsPreviewResponse","type":"object"},"BulkMoveThreadsRequest":{"description":"Move selected threads from one space into another.","properties":{"selection":{"$ref":"#/components/schemas/BulkThreadSelection"},"target_space_id":{"description":"Target space name or storage key","title":"Target Space Id","type":"string"}},"required":["selection","target_space_id"],"title":"BulkMoveThreadsRequest","type":"object"},"BulkMoveThreadsResponse":{"description":"Result for a bulk thread move.","properties":{"conflicts":{"items":{"additionalProperties":true,"type":"object"},"title":"Conflicts","type":"array"},"failed_count":{"default":0,"title":"Failed Count","type":"integer"},"message":{"title":"Message","type":"string"},"moved_count":{"title":"Moved Count","type":"integer"},"source_space_id":{"title":"Source Space Id","type":"string"},"target_space_id":{"title":"Target Space Id","type":"string"}},"required":["moved_count","source_space_id","target_space_id","message"],"title":"BulkMoveThreadsResponse","type":"object"},"BulkThreadSelection":{"description":"Selection descriptor for bulk thread operations.","properties":{"exclude_thread_ids":{"items":{"type":"string"},"title":"Exclude Thread Ids","type":"array"},"mode":{"default":"ids","enum":["ids","space"],"title":"Mode","type":"string"},"source_space_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Space Id"},"thread_ids":{"items":{"type":"string"},"title":"Thread Ids","type":"array"}},"title":"BulkThreadSelection","type":"object"},"CancelKnowledgeProcessingTaskRequest":{"description":"Cancel a queued or running background task.","properties":{"task_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Stable task id returned by the processing status endpoint.","title":"Task Id"},"task_type":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Fallback task type selector when a task id is not available.","title":"Task Type"}},"title":"CancelKnowledgeProcessingTaskRequest","type":"object"},"CapabilityGrant":{"properties":{"granted_at":{"type":"string"},"instruction_revision":{"description":"The exact instruction revision this authority was reviewed against.","format":"int64","minimum":0,"type":"integer"},"revision":{"format":"int64","minimum":0,"type":"integer"},"tools":{"items":{"$ref":"#/components/schemas/ToolCapability"},"type":"array"},"version":{"format":"int32","minimum":0,"type":"integer"}},"required":["version","revision","instruction_revision","granted_at"],"type":"object"},"CleanupOrphansResponse":{"description":"Response for orphan cleanup operation.","properties":{"deleted_count":{"title":"Deleted Count","type":"integer"},"message":{"title":"Message","type":"string"},"success":{"title":"Success","type":"boolean"}},"required":["success","deleted_count","message"],"title":"CleanupOrphansResponse","type":"object"},"CommunityContext":{"description":"Community context attached to the queried entity.","properties":{"community_id":{"description":"Louvain community id","title":"Community Id","type":"integer"},"member_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Number of members in this community","title":"Member Count"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Community name","title":"Name"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"LLM-generated community summary (ai_summary), falls back to description","title":"Summary"}},"required":["community_id"],"title":"CommunityContext","type":"object"},"ConfirmScheduleRequest":{"properties":{"capability_grant":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/CapabilityGrant"}]}},"type":"object"},"ConnectorBinding":{"description":"Stable reference to connector-owned configuration and credentials.\n\nSchedules never persist endpoint headers, API keys, OAuth tokens, or full\nplugin definitions. The runtime resolves this id in its connector store and\ncompares the non-secret configuration fingerprint before every occurrence.","properties":{"config_fingerprint":{"type":"string"},"plugin_id":{"type":"string"},"server_name":{"type":"string"}},"required":["plugin_id","server_name","config_fingerprint"],"type":"object"},"ConnectorBindingRequest":{"properties":{"plugin_id":{"type":"string"}},"required":["plugin_id"],"type":"object"},"ContentStoreHealth":{"description":"Content Store migration and ownership status.","properties":{"cutover_completed":{"title":"Cutover Completed","type":"boolean"},"cutover_ready":{"default":false,"title":"Cutover Ready","type":"boolean"},"db_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Db Path"},"last_error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Error"},"legacy_graph_cleanup_completed":{"title":"Legacy Graph Cleanup Completed","type":"boolean"},"legacy_kuzu_anchor_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Legacy Kuzu Anchor Count"},"legacy_kuzu_anchor_scan_offset":{"default":0,"title":"Legacy Kuzu Anchor Scan Offset","type":"integer"},"legacy_kuzu_message_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Legacy Kuzu Message Count"},"schema_migration_count":{"default":0,"title":"Schema Migration Count","type":"integer"},"schema_min_supported_version":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Schema Min Supported Version"},"schema_version":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Schema Version"},"sqlite_anchor_count":{"default":0,"title":"Sqlite Anchor Count","type":"integer"},"sqlite_message_count":{"default":0,"title":"Sqlite Message Count","type":"integer"},"sqlite_ready":{"title":"Sqlite Ready","type":"boolean"},"sqlite_thread_count":{"default":0,"title":"Sqlite Thread Count","type":"integer"},"state":{"title":"State","type":"string"},"thread_message_owner":{"title":"Thread Message Owner","type":"string"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"required":["state","sqlite_ready","thread_message_owner","cutover_completed","legacy_graph_cleanup_completed"],"title":"ContentStoreHealth","type":"object"},"ConversationDiscoveryResponse":{"description":"Response from conversation discovery.","properties":{"conversations":{"additionalProperties":{"items":{"additionalProperties":true,"type":"object"},"type":"array"},"description":"Discovered conversations by source","title":"Conversations","type":"object"}},"required":["conversations"],"title":"ConversationDiscoveryResponse","type":"object"},"ConversationExportRawRequest":{"description":"Request model for exporting a raw conversation file without importing.","properties":{"format":{"default":"markdown","description":"Export format: markdown or json","title":"Format","type":"string"},"path":{"description":"Path to conversation file","title":"Path","type":"string"},"source":{"description":"Source type: claude, codex, cursor, or opencode","title":"Source","type":"string"}},"required":["path","source"],"title":"ConversationExportRawRequest","type":"object"},"ConversationImportRequestModel":{"description":"Request model for importing a conversation.","properties":{"auto_compact":{"default":false,"description":"Auto-extract memories during import","title":"Auto Compact","type":"boolean"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"description":"Metadata from discovery (e.g. storage type for OpenCode SQLite sessions)","title":"Metadata"},"path":{"description":"Path to conversation file","title":"Path","type":"string"},"preserve_timestamps":{"default":true,"description":"Preserve original timestamps","title":"Preserve Timestamps","type":"boolean"},"project":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Human-readable project name","title":"Project"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Session ID from discovery (used for thread deduplication)","title":"Session Id"},"source":{"description":"Source type: claude, codex, cursor, or opencode","title":"Source","type":"string"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional user-provided summary","title":"Summary"},"thread_id_override":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional thread ID override","title":"Thread Id Override"},"workspace":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Workspace/project directory path (used for project-level auto-sync)","title":"Workspace"}},"required":["path","source"],"title":"ConversationImportRequestModel","type":"object"},"ConversationImportResponse":{"description":"Response from conversation import.","properties":{"created_memories":{"items":{"$ref":"#/components/schemas/MemoryNode"},"title":"Created Memories","type":"array"},"import_summary":{"title":"Import Summary","type":"string"},"messages":{"items":{"$ref":"#/components/schemas/MessageNode"},"title":"Messages","type":"array"},"skipped_messages":{"default":0,"title":"Skipped Messages","type":"integer"},"thread":{"$ref":"#/components/schemas/ThreadNode"},"warnings":{"items":{"type":"string"},"title":"Warnings","type":"array"}},"required":["thread","messages","import_summary"],"title":"ConversationImportResponse","type":"object"},"ConversationPreviewMessage":{"description":"One preview message snippet for the session browser.","properties":{"content":{"description":"Preview snippet content","title":"Content","type":"string"},"role":{"description":"Message role","title":"Role","type":"string"}},"required":["role","content"],"title":"ConversationPreviewMessage","type":"object"},"ConversationPreviewRequest":{"description":"Request model for loading a richer preview for one discovered session.","properties":{"path":{"description":"Path to conversation file","title":"Path","type":"string"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional session ID for sources that multiplex multiple sessions in one file/database","title":"Session Id"},"source":{"description":"Source type: claude, codex, cursor, or opencode","title":"Source","type":"string"}},"required":["path","source"],"title":"ConversationPreviewRequest","type":"object"},"ConversationPreviewResponse":{"description":"Structured preview for one discovered conversation.","properties":{"message_count":{"description":"Total messages in the session","title":"Message Count","type":"integer"},"preview_messages":{"description":"Beginning and tail preview messages","items":{"$ref":"#/components/schemas/ConversationPreviewMessage"},"title":"Preview Messages","type":"array"}},"required":["message_count"],"title":"ConversationPreviewResponse","type":"object"},"CreateScheduleRequest":{"properties":{"capability_grant":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/CapabilityGrant"}]},"connectors":{"items":{"$ref":"#/components/schemas/ConnectorBindingRequest"},"type":"array"},"enabled_plugin_ids":{"items":{"type":"string"},"type":"array"},"instruction":{"type":"string"},"local_time":{"$ref":"#/components/schemas/WallClockTime"},"missed_run_policy":{"$ref":"#/components/schemas/MissedRunPolicy"},"model_policy":{"$ref":"#/components/schemas/ModelPolicy"},"recurrence":{"$ref":"#/components/schemas/Recurrence"},"space_id":{"type":["string","null"]},"timezone":{"type":"string"},"title":{"type":"string"}},"required":["title","instruction","recurrence","local_time","timezone"],"type":"object"},"DataExportDownloadRequest":{"description":"Export options for the download endpoint (no local path needed).","properties":{"include_communities":{"default":true,"type":"boolean"},"include_edges":{"default":true,"type":"boolean"},"include_entities":{"default":true,"type":"boolean"},"include_feed_events":{"default":true,"description":"Include durable Timeline history from feed_events/*.jsonl.","type":"boolean"},"include_labels":{"default":true,"type":"boolean"},"include_memories":{"default":true,"type":"boolean"},"include_messages":{"default":true,"type":"boolean"},"include_skills":{"default":true,"type":"boolean"},"include_source_files":{"default":true,"type":"boolean"},"include_sources":{"default":true,"type":"boolean"},"include_threads":{"default":true,"type":"boolean"},"include_working_memory":{"default":true,"type":"boolean"},"include_working_memory_archive":{"default":true,"type":"boolean"}},"title":"DataExportDownloadRequest","type":"object"},"DataExportRequest":{"description":"POST /data/export request body.","properties":{"async":{"default":false,"description":"Return a job id immediately and run the export in the background.","type":"boolean"},"compress":{"default":true,"description":"Create a .zip archive.","type":"boolean"},"export_path":{"description":"Target export directory or .zip path.","type":"string"},"include_communities":{"default":true,"type":"boolean"},"include_edges":{"default":true,"type":"boolean"},"include_entities":{"default":true,"type":"boolean"},"include_feed_events":{"default":true,"description":"Include durable Timeline history from feed_events/*.jsonl.","type":"boolean"},"include_labels":{"default":true,"type":"boolean"},"include_memories":{"default":true,"type":"boolean"},"include_messages":{"default":true,"type":"boolean"},"include_skills":{"default":true,"type":"boolean"},"include_source_files":{"default":true,"type":"boolean"},"include_sources":{"default":true,"type":"boolean"},"include_threads":{"default":true,"type":"boolean"},"include_working_memory":{"default":true,"type":"boolean"},"include_working_memory_archive":{"default":true,"type":"boolean"},"overwrite":{"default":false,"description":"Overwrite an existing export path.","type":"boolean"}},"required":["export_path"],"title":"DataExportRequest","type":"object"},"DataExportResponse":{"oneOf":[{"$ref":"#/components/schemas/DataExportSyncResponse"},{"$ref":"#/components/schemas/DataExportStartResponse"}]},"DataExportStartResponse":{"description":"Returned by POST /data/export when async is true.","properties":{"job_id":{"type":"string"},"message":{"type":"string"},"status":{"type":"string"},"success":{"type":"boolean"}},"required":["success","job_id","status","message"],"title":"DataExportStartResponse","type":"object"},"DataExportSyncResponse":{"description":"Synchronous export result when async is false.","properties":{"counts":{"type":"object"},"created_at":{"type":"string"},"export_dir":{"type":["string","null"]},"export_id":{"type":"string"},"export_path":{"type":["string","null"]},"format":{"type":"string"},"manifest_path":{"type":["string","null"]},"success":{"type":"boolean"},"version":{"format":"int64","minimum":0,"type":"integer"},"warnings":{"items":{"type":"string"},"type":"array"}},"required":["success","export_id","format","version","created_at","counts","warnings"],"title":"DataExportResult","type":"object"},"DataImportMode":{"enum":["merge","skip","overwrite"],"type":"string"},"DataImportPreview":{"properties":{"counts":{"additionalProperties":{"minimum":0,"type":"integer"},"description":"Flattened source-declared counts; not conflict predictions.","type":"object"},"export_id":{"type":["string","null"]},"exported_at":{"type":["string","null"]},"format":{"type":"string"},"format_version":{"format":"int64","minimum":0,"type":["integer","null"]},"included":{"additionalProperties":{"type":"boolean"},"type":"object"},"input_frozen":{"type":"boolean"},"inspection_only":{"type":"boolean"},"mode":{"type":"string"},"source_kind":{"type":"string"},"warnings":{"items":{"type":"string"},"type":"array"}},"required":["format","counts","included","warnings","mode","source_kind","inspection_only","input_frozen"],"type":"object"},"DataImportPreviewResponse":{"properties":{"preview":{"$ref":"#/components/schemas/DataImportPreview"},"success":{"type":"boolean"}},"required":["success","preview"],"type":"object"},"DataImportRequest":{"description":"POST /data/import request body.","properties":{"import_path":{"description":"Path to export folder or .zip.","type":"string"},"include_communities":{"default":true,"type":"boolean"},"include_edges":{"default":true,"type":"boolean"},"include_entities":{"default":true,"type":"boolean"},"include_feed_events":{"default":true,"description":"Include durable Timeline history from feed_events/*.jsonl.","type":"boolean"},"include_labels":{"default":true,"type":"boolean"},"include_memories":{"default":true,"type":"boolean"},"include_messages":{"default":true,"type":"boolean"},"include_skills":{"default":true,"type":"boolean"},"include_source_files":{"default":true,"type":"boolean"},"include_sources":{"default":true,"type":"boolean"},"include_threads":{"default":true,"type":"boolean"},"include_working_memory":{"default":true,"type":"boolean"},"include_working_memory_archive":{"default":true,"type":"boolean"},"mode":{"$ref":"#/components/schemas/DataImportMode","description":"merge | skip | overwrite."}},"required":["import_path"],"title":"DataImportRequest","type":"object"},"DataImportStartResponse":{"properties":{"job_id":{"type":"string"},"message":{"type":"string"},"status":{"type":"string"},"success":{"default":true,"type":"boolean"}},"required":["job_id","status","message"],"title":"DataImportStartResponse","type":"object"},"DataImportStatusResponse":{"description":"Status for a Data Transfer import or export background job.","properties":{"completed_at":{"type":["string","null"]},"error":{"type":["string","null"]},"job_id":{"type":"string"},"kind":{"description":"Transfer kind, usually import or export. Older jobs may omit this field.","type":["string","null"]},"result":{"type":["object","null"]},"started_at":{"type":["string","null"]},"status":{"type":"string"}},"required":["job_id","status","result"],"title":"DataTransferStatusResponse","type":"object"},"DataImportUploadRequest":{"description":"Multipart body for POST /data/import/upload.","properties":{"file":{"contentMediaType":"application/octet-stream","type":"string"},"include_communities":{"default":true,"type":"boolean"},"include_edges":{"default":true,"type":"boolean"},"include_entities":{"default":true,"type":"boolean"},"include_feed_events":{"default":true,"description":"Include durable Timeline history from feed_events/*.jsonl.","type":"boolean"},"include_labels":{"default":true,"type":"boolean"},"include_memories":{"default":true,"type":"boolean"},"include_messages":{"default":true,"type":"boolean"},"include_skills":{"default":true,"type":"boolean"},"include_source_files":{"default":true,"type":"boolean"},"include_sources":{"default":true,"type":"boolean"},"include_threads":{"default":true,"type":"boolean"},"include_working_memory":{"default":true,"type":"boolean"},"include_working_memory_archive":{"default":true,"type":"boolean"},"mode":{"$ref":"#/components/schemas/DataImportMode"}},"required":["file"],"title":"Body_import_data_upload_data_import_upload_post","type":"object"},"DataTransferCheckpointResponse":{"properties":{"checkpointed":{"type":"boolean"},"detail":{"type":["string","null"]},"success":{"type":"boolean"}},"required":["success","checkpointed"],"type":"object"},"DataTransferErrorResponse":{"properties":{"detail":{"type":"string"}},"required":["detail"],"type":"object"},"DatabaseRecoveryNotice":{"description":"Startup notice when Mem had to preserve an alternate DB copy.","properties":{"backup_db_path":{"title":"Backup Db Path","type":"string"},"backup_size_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Backup Size Bytes"},"chosen_db_path":{"title":"Chosen Db Path","type":"string"},"chosen_size_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Chosen Size Bytes"},"created_at":{"title":"Created At","type":"string"},"id":{"title":"Id","type":"string"},"reason":{"title":"Reason","type":"string"},"support_email":{"title":"Support Email","type":"string"}},"required":["id","created_at","reason","support_email","chosen_db_path","backup_db_path"],"title":"DatabaseRecoveryNotice","type":"object"},"DeleteLabelResponse":{"description":"Response model for label deletion.","properties":{"message":{"description":"Deletion status message","title":"Message","type":"string"}},"required":["message"],"title":"DeleteLabelResponse","type":"object"},"DeleteMemoryResponse":{"additionalProperties":true,"description":"Response from deleting a memory.","properties":{"deleted_entities":{"description":"Number of entities deleted","title":"Deleted Entities","type":"integer"},"deleted_relationships":{"description":"Number of relationships deleted","title":"Deleted Relationships","type":"integer"},"message":{"description":"Success message","title":"Message","type":"string"}},"required":["message","deleted_relationships","deleted_entities"],"title":"DeleteMemoryResponse","type":"object"},"DeleteThreadResponse":{"additionalProperties":true,"description":"Response from deleting a thread.","properties":{"cascade_deletion":{"default":false,"description":"Whether cascade deletion was requested, not proof that any Memory was deleted. Cloud currently reports zero extracted Memory deletions.","type":"boolean"},"deleted_memories":{"description":"Confirmed Memory deletions, including commits before a later failure. Never inferred from the requested cascade flag.","minimum":0,"type":"integer"},"deleted_messages":{"default":0,"description":"Number of messages deleted","title":"Deleted Messages","type":"integer"},"index_repair_pending":{"description":"Known search projection repair remains pending after the reported graph outcomes.","type":"boolean"},"message":{"description":"Success message","title":"Message","type":"string"},"storage_cleanup_pending":{"description":"The Thread graph deletion committed but associated content cleanup remains pending.","type":"boolean"}},"required":["message"],"title":"DeleteThreadResponse","type":"object"},"DeprecateMemoryRequest":{"description":"Mark a memory as obsolete without deleting provenance.","properties":{"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"},"replacement_memory_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Replacement Memory Id"},"space_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional isolation space guard; the memory must belong to it.","title":"Space Id"}},"title":"DeprecateMemoryRequest","type":"object"},"DiscardPendingVersionResponse":{"description":"Confirmation that only the reviewable proposal was removed.","properties":{"discarded":{"type":"boolean"},"id":{"type":"string"}},"required":["id","discarded"],"type":"object"},"DismissSkillRequest":{"description":"Why a suggestion was dismissed, so the reviewer doesn't re-suggest it.\n\nBoth fields are optional: a bare dismiss still records a sensible default\n(``not_useful`` + ``new_distinct_occasion_threshold``) so the same idea is\nsuppressed until genuinely new evidence appears.","properties":{"rejection_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"too_broad | not_recurring | duplicate | policy | one_off | stale | not_useful | user_preference","title":"Rejection Reason"},"resurface_rule":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"new_distinct_occasion_threshold | user_requested | never","title":"Resurface Rule"}},"title":"DismissSkillRequest","type":"object"},"DistillationPlanResponse":{"description":"Execution plan for a thread distillation request.","properties":{"background_delay_seconds":{"title":"Background Delay Seconds","type":"integer"},"char_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Char Count"},"direct_allowed":{"title":"Direct Allowed","type":"boolean"},"direct_char_limit":{"title":"Direct Char Limit","type":"integer"},"direct_message_limit":{"title":"Direct Message Limit","type":"integer"},"message_count":{"title":"Message Count","type":"integer"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"},"recommended_execution_mode":{"description":"Recommended execution mode: 'direct' or 'background_agent'","title":"Recommended Execution Mode","type":"string"},"thread_id":{"title":"Thread Id","type":"string"}},"required":["thread_id","direct_allowed","recommended_execution_mode","message_count","direct_message_limit","direct_char_limit","background_delay_seconds"],"title":"DistillationPlanResponse","type":"object"},"DistillationPreviewResponse":{"description":"Response for distillation preview.","properties":{"background_delay_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Background Delay Seconds"},"cache_key":{"description":"Cache key to reuse these results","title":"Cache Key","type":"string"},"char_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Char Count"},"direct_allowed":{"default":true,"title":"Direct Allowed","type":"boolean"},"direct_char_limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Direct Char Limit"},"direct_message_limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Direct Message Limit"},"distillation_type":{"title":"Distillation Type","type":"string"},"entities":{"items":{"additionalProperties":true,"type":"object"},"title":"Entities","type":"array"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"insights":{"items":{"additionalProperties":true,"type":"object"},"title":"Insights","type":"array"},"memories":{"items":{"additionalProperties":true,"type":"object"},"title":"Memories","type":"array"},"memory_relations":{"items":{"additionalProperties":true,"type":"object"},"title":"Memory Relations","type":"array"},"message_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Message Count"},"processing_time":{"title":"Processing Time","type":"number"},"recommended_execution_mode":{"default":"direct","description":"Recommended execution mode: 'direct' or 'background_agent'","title":"Recommended Execution Mode","type":"string"},"relationships":{"items":{"additionalProperties":true,"type":"object"},"title":"Relationships","type":"array"},"success":{"title":"Success","type":"boolean"},"summary":{"title":"Summary","type":"string"}},"required":["success","cache_key","distillation_type","processing_time","memories","entities","relationships","insights","summary"],"title":"DistillationPreviewResponse","type":"object"},"DistillationRequest":{"description":"Request for memory distillation from thread content.","properties":{"cache_key":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Cache key from preview to reuse results","title":"Cache Key"},"distillation_type":{"default":"simple_llm","description":"Type: 'simple_llm' or 'knowledge_graph'","title":"Distillation Type","type":"string"},"existing_memories":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"description":"Optional compact existing memories for preview-time Memory-to-Memory relation proposals.","title":"Existing Memories"},"extraction_level":{"default":"swift","description":"Extraction level: 'swift' (fast, local), 'guided' (multi-step, local), or 'expert' (remote LLM). Auto-upgrades to expert when local LLM is unavailable.","title":"Extraction Level","type":"string"},"force_distill":{"default":false,"description":"When true, bypass the strict worthiness gate because the user explicitly requested distillation","title":"Force Distill","type":"boolean"},"native_source_operation":{"$ref":"#/components/schemas/NativeSourceOperation"},"preferred_language":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"User preferred output language (ISO 639-1 code, e.g. 'en', 'zh', 'ja'), or None to follow input language","title":"Preferred Language"},"selected_message_indices":{"anyOf":[{"items":{"type":"integer"},"type":"array"},{"type":"null"}],"description":"Optional list of message indices to process; if omitted, process full thread","title":"Selected Message Indices"},"space_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional isolation space guard for the source thread.","title":"Space Id"},"thread_content":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Full thread content to distill. Optional when thread_id refers to a stored thread.","title":"Thread Content"},"thread_id":{"description":"Source thread ID","title":"Thread Id","type":"string"},"thread_title":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Thread title for context","title":"Thread Title"}},"required":["thread_id"],"title":"DistillationRequest","type":"object"},"DistillationScheduleRequest":{"description":"Request to schedule agent-backed thread distillation.","properties":{"cache_key":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Cache key from preview to reuse results","title":"Cache Key"},"delay_seconds":{"default":5,"description":"Delay before the background Knowledge Agent starts the task.","maximum":300,"minimum":1,"title":"Delay Seconds","type":"integer"},"distill_again_of_task_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional Processing task ID to distill again when its recovery state offers that action. The task's conversation and Space bind the new request.","title":"Distill Again Of Task Id"},"distillation_type":{"default":"simple_llm","description":"Type: 'simple_llm' or 'knowledge_graph'","title":"Distillation Type","type":"string"},"existing_memories":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"description":"Optional compact existing memories for preview-time Memory-to-Memory relation proposals.","title":"Existing Memories"},"extraction_level":{"default":"swift","description":"Extraction level: 'swift' (fast, local), 'guided' (multi-step, local), or 'expert' (remote LLM). Auto-upgrades to expert when local LLM is unavailable.","title":"Extraction Level","type":"string"},"force_distill":{"default":false,"description":"When true, bypass the strict worthiness gate because the user explicitly requested distillation","title":"Force Distill","type":"boolean"},"memory_policy_override":{"anyOf":[{"$ref":"#/components/schemas/MemoryPolicyPatch"},{"type":"null"}],"description":"Optional one-run Memory Policy applied after global and actual source-Thread Space settings. Does not change stored policy or routing. Omitted, null, or empty objects preserve inherited behavior. Existing force_distill semantics remain separate; set it to request re-distillation of unchanged content."},"native_source_operation":{"$ref":"#/components/schemas/NativeSourceOperation"},"preferred_language":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"User preferred output language (ISO 639-1 code, e.g. 'en', 'zh', 'ja'), or None to follow input language","title":"Preferred Language"},"selected_message_indices":{"anyOf":[{"items":{"type":"integer"},"type":"array"},{"type":"null"}],"description":"Optional list of message indices to process; if omitted, process full thread","title":"Selected Message Indices"},"space_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional isolation space guard for the source thread.","title":"Space Id"},"thread_content":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Full thread content to distill. Optional when thread_id refers to a stored thread.","title":"Thread Content"},"thread_id":{"description":"Source thread ID","title":"Thread Id","type":"string"},"thread_title":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Thread title for context","title":"Thread Title"}},"required":["thread_id"],"title":"DistillationScheduleRequest","type":"object"},"DistillationScheduleResponse":{"description":"Response from scheduling background thread distillation.","properties":{"delay_seconds":{"title":"Delay Seconds","type":"integer"},"distill_again":{"additionalProperties":false,"description":"Present only when a distill-again request is accepted; identifies the recovered run and whether this request queued it or it had already started.","properties":{"run_id":{"title":"Run Id","type":"string"},"status":{"enum":["queued","already_started"],"title":"Status","type":"string"}},"required":["run_id","status"],"type":"object"},"message":{"title":"Message","type":"string"},"recommended_execution_mode":{"default":"background_agent","title":"Recommended Execution Mode","type":"string"},"scheduled_at":{"title":"Scheduled At","type":"string"},"success":{"title":"Success","type":"boolean"},"task_id":{"title":"Task Id","type":"string"},"task_type":{"title":"Task Type","type":"string"},"thread_id":{"title":"Thread Id","type":"string"}},"required":["success","task_id","scheduled_at","delay_seconds","task_type","thread_id","message"],"title":"DistillationScheduleResponse","type":"object"},"EmbeddingInput":{"oneOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"EmbeddingRuntime":{"description":"What real searches got from the active embedding provider, since this window opened. Process-local and not persisted: a restart opens a fresh window, and so does a change of embedder identity or of the wait budget, because counts gathered under a configuration the user has left no longer describe the one in force. Present with zero counts before the first search rather than absent, so a client can judge a connection test against the wait before any search has run.","properties":{"attempted":{"description":"Query embeddings attempted in this window. Equals `succeeded + timed_out + failed`.","title":"Attempted","type":"integer"},"failed":{"description":"Attempts that ended in an error rather than a timeout: auth, quota, network and malformed responses alike. Not separated further, because the search path cannot tell them apart.","title":"Failed","type":"integer"},"identity":{"description":"The embedder these counts describe, as `provider/model`, or `local` for the on-device embedder.","title":"Identity","type":"string"},"last_success_latency_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"How long the most recent SUCCESSFUL query embedding took. Null until one succeeds in this window. Never derived from a timed-out call, whose elapsed time is the budget rather than a measurement of the provider.","title":"Last Success Latency Ms"},"succeeded":{"title":"Succeeded","type":"integer"},"timed_out":{"description":"Attempts abandoned at `wait_budget_seconds`. Each one answered the search with keyword-only results.","title":"Timed Out","type":"integer"},"wait_budget_seconds":{"description":"The wait a query embedding gets before the search degrades to keyword-only, resolved as explicit setting, then environment override, then default.","title":"Wait Budget Seconds","type":"number"},"window_started_at_unix":{"description":"Unix seconds when this window opened.","title":"Window Started At Unix","type":"integer"}},"required":["identity","attempted","succeeded","timed_out","failed","last_success_latency_ms","wait_budget_seconds","window_started_at_unix"],"title":"EmbeddingRuntime","type":"object"},"EmbeddingVector":{"oneOf":[{"items":{"format":"float","type":"number"},"type":"array"},{"type":"string"}]},"EntityAliasChangeSchema":{"properties":{"add":{"items":{"type":"string"},"type":"array"},"expected_aliases":{"items":{"type":"string"},"type":"array"},"expected_revision":{"format":"int64","minimum":0,"type":"integer"},"remove":{"items":{"type":"string"},"type":"array"}},"required":["expected_revision","expected_aliases"],"type":"object"},"EntityAliasStateSchema":{"properties":{"aliases":{"items":{"type":"string"},"type":"array"},"entity_id":{"type":"string"},"name":{"type":"string"},"rejected_aliases":{"items":{"type":"string"},"type":"array"},"revision":{"format":"int64","minimum":0,"type":"integer"}},"required":["entity_id","name","aliases","rejected_aliases","revision"],"type":"object"},"EntityDeletePlanResponse":{"properties":{"can_delete":{"type":"boolean"},"counts":{"$ref":"#/components/schemas/EntityImpactCounts"},"entity":{"$ref":"#/components/schemas/EntityLifecycleSummary"},"memories_preserved":{"type":"boolean"}},"required":["entity","counts","memories_preserved","can_delete"],"type":"object"},"EntityImpactCounts":{"properties":{"communities":{"format":"int64","minimum":0,"type":"integer"},"incoming_relations":{"format":"int64","minimum":0,"type":"integer"},"labels":{"format":"int64","minimum":0,"type":"integer"},"mentions":{"format":"int64","minimum":0,"type":"integer"},"outgoing_relations":{"format":"int64","minimum":0,"type":"integer"}},"required":["mentions","outgoing_relations","incoming_relations","labels","communities"],"type":"object"},"EntityLifecycleSummary":{"properties":{"aliases":{"items":{"type":"string"},"type":"array"},"description":{"type":"string"},"entity_type":{"type":"string"},"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name","entity_type","description","aliases"],"type":"object"},"EntityMergePlanResponse":{"properties":{"can_merge":{"type":"boolean"},"counts":{"$ref":"#/components/schemas/EntityImpactCounts"},"duplicate_mentions":{"format":"int64","minimum":0,"type":"integer"},"duplicate_relations_removed":{"format":"int64","minimum":0,"type":"integer"},"self_relations_removed":{"format":"int64","minimum":0,"type":"integer"},"source":{"$ref":"#/components/schemas/EntityLifecycleSummary"},"target":{"$ref":"#/components/schemas/EntityLifecycleSummary"}},"required":["source","target","counts","duplicate_mentions","self_relations_removed","duplicate_relations_removed","can_merge"],"type":"object"},"EntityMergeRequest":{"properties":{"confirm_source_entity_id":{"type":["string","null"]},"target_entity_id":{"type":"string"}},"required":["target_entity_id"],"type":"object"},"EntityMutationResponse":{"properties":{"action":{"type":"string"},"counts":{"$ref":"#/components/schemas/EntityImpactCounts"},"duplicate_mentions":{"format":"int64","minimum":0,"type":"integer"},"duplicate_relations_removed":{"format":"int64","minimum":0,"type":"integer"},"self_relations_removed":{"format":"int64","minimum":0,"type":"integer"},"source_entity_id":{"type":"string"},"target_entity_id":{"type":["string","null"]},"warnings":{"items":{"type":"string"},"type":"array"}},"required":["action","source_entity_id","counts","duplicate_mentions","self_relations_removed","duplicate_relations_removed","warnings"],"type":"object"},"EntityNode":{"description":"Entity node representing concepts, people, places, etc.","properties":{"aliases":{"description":"Alternative names","items":{"type":"string"},"title":"Aliases","type":"array"},"confidence":{"default":0.5,"description":"Entity confidence","maximum":1,"minimum":0,"title":"Confidence","type":"number"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Entity description","title":"Description"},"entity_created":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"When entity was created/born/founded (normalized YYYY-MM-DD)","title":"Entity Created"},"entity_ended":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"When entity died/closed/discontinued (normalized YYYY-MM-DD)","title":"Entity Ended"},"entity_type":{"description":"Entity type (person, concept, etc.)","title":"Entity Type","type":"string"},"id":{"title":"Id","type":"string"},"metadata":{"additionalProperties":true,"title":"Metadata","type":"object"},"name":{"description":"Entity name","title":"Name","type":"string"},"node_type":{"$ref":"#/components/schemas/NodeType","default":"Entity"},"temporal_confidence":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}],"description":"LLM confidence in temporal extraction (0-1)","title":"Temporal Confidence"},"temporal_context":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Temporal context: past/present/timeless","title":"Temporal Context"},"temporal_precision":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Date precision for UI display: year/month/day","title":"Temporal Precision"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"}},"required":["name","entity_type"],"title":"EntityNode","type":"object"},"EntityRelationship":{"description":"A relationship between two entities.","properties":{"depth":{"description":"Depth of traversal from source entity","title":"Depth","type":"integer"},"relationship":{"$ref":"#/components/schemas/RelationshipInfo","description":"Relationship information"},"source_entity":{"$ref":"#/components/schemas/EntitySummary","description":"Source entity"},"target_entity":{"$ref":"#/components/schemas/EntitySummary","description":"Target entity"}},"required":["source_entity","target_entity","relationship","depth"],"title":"EntityRelationship","type":"object"},"EntityRelationshipsData":{"description":"Collection of entity relationships.","properties":{"community":{"anyOf":[{"$ref":"#/components/schemas/CommunityContext"},{"type":"null"}],"description":"Community this entity belongs to, with name/summary if available"},"mentioned_in":{"description":"Memories mentioning this entity","items":{"$ref":"#/components/schemas/MemoryMention"},"title":"Mentioned In","type":"array"},"relates_to":{"description":"Entity-to-entity relationships","items":{"$ref":"#/components/schemas/EntityRelationship"},"title":"Relates To","type":"array"}},"title":"EntityRelationshipsData","type":"object"},"EntityRelationshipsMetadata":{"description":"Metadata about entity relationships query.","properties":{"limit":{"description":"Maximum results returned","title":"Limit","type":"integer"},"total_mentions":{"description":"Total number of memory mentions","title":"Total Mentions","type":"integer"},"total_relates_to":{"description":"Total number of entity relationships","title":"Total Relates To","type":"integer"},"traversal_depth":{"description":"Depth of relationship traversal","title":"Traversal Depth","type":"integer"}},"required":["total_relates_to","total_mentions","traversal_depth","limit"],"title":"EntityRelationshipsMetadata","type":"object"},"EntityRelationshipsResponse":{"description":"Response for entity relationships endpoint.","properties":{"entity":{"$ref":"#/components/schemas/EntitySummary","description":"The queried entity"},"metadata":{"$ref":"#/components/schemas/EntityRelationshipsMetadata","description":"Query metadata"},"relationships":{"$ref":"#/components/schemas/EntityRelationshipsData","description":"All relationships for this entity"}},"required":["entity","relationships","metadata"],"title":"EntityRelationshipsResponse","type":"object"},"EntitySummary":{"description":"Summary of an entity for relationship responses.\n\nThe optional fields below are populated only on the *primary* entity in a\nrelationships response (the one that was queried by id). Related/source/\ntarget entities embedded in `EntityRelationship` only carry the core\nid/name/type/description quartet to keep the payload tight.","properties":{"aliases":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Alternative names (primary entity only)","title":"Aliases"},"community_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Louvain community id, if assigned (primary entity only)","title":"Community Id"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Extraction confidence 0-1 (primary entity only)","title":"Confidence"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO timestamp of first extraction (primary entity only)","title":"Created At"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"","description":"Entity description","title":"Description"},"id":{"description":"Entity ID","title":"Id","type":"string"},"name":{"description":"Entity name","title":"Name","type":"string"},"type":{"description":"Entity type","title":"Type","type":"string"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO timestamp of last update (primary entity only)","title":"Updated At"}},"required":["id","name","type"],"title":"EntitySummary","type":"object"},"EvolvesRevisionApplyRequest":{"properties":{"authoritative_memory_id":{"type":["string","null"]},"decision":{"description":"`keep_memory`, `keep_both_linked`, or `mark_unrelated`.","type":"string"},"keep_both_relation":{"description":"`confirms` or `challenges`; required only for `keep_both_linked`.","type":["string","null"]},"memory_ids":{"items":{"type":"string"},"type":"array"},"plan_id":{"type":"string"},"reason":{"maxLength":1000,"type":["string","null"]}},"required":["memory_ids","decision","plan_id"],"type":"object"},"EvolvesRevisionEdgeResponse":{"properties":{"confidence":{"format":"double","type":"number"},"detected_by":{"type":"string"},"from_memory_id":{"type":"string"},"reason":{"type":"string"},"relation":{"type":"string"},"reviewed":{"type":"boolean"},"to_memory_id":{"type":"string"}},"required":["from_memory_id","to_memory_id","relation","confidence","reviewed","detected_by","reason"],"type":"object"},"EvolvesRevisionMemoryResponse":{"properties":{"created_at":{},"id":{"type":"string"},"is_latest":{"type":"boolean"},"lifecycle_state":{"type":"string"},"space_id":{"type":"string"},"title":{"type":"string"}},"required":["id","title","is_latest","lifecycle_state","space_id","created_at"],"type":"object"},"EvolvesRevisionPlanResponse":{"properties":{"authoritative_memory_id":{"type":["string","null"]},"can_apply":{"type":"boolean"},"cannot_apply_reason":{"type":["string","null"]},"current_edges":{"items":{"$ref":"#/components/schemas/EvolvesRevisionEdgeResponse"},"type":"array"},"decision":{"type":"string"},"memories":{"items":{"$ref":"#/components/schemas/EvolvesRevisionMemoryResponse"},"type":"array"},"memories_preserved":{"type":"boolean"},"memory_contents":{"additionalProperties":{"type":"string"},"description":"Complete authorized bodies from the plan's snapshot, keyed by Memory ID.\nPreview only; omitted from apply responses and persisted receipts.","propertyNames":{"type":"string"},"type":"object"},"plan_id":{"type":"string"},"target_relation":{"type":["string","null"]}},"required":["plan_id","decision","memories","memory_contents","current_edges","memories_preserved","can_apply"],"type":"object"},"EvolvesRevisionPreviewRequest":{"properties":{"authoritative_memory_id":{"type":["string","null"]},"decision":{"description":"`keep_memory`, `keep_both_linked`, or `mark_unrelated`.","type":"string"},"keep_both_relation":{"description":"`confirms` or `challenges`; required only for `keep_both_linked`.","type":["string","null"]},"memory_ids":{"items":{"type":"string"},"type":"array"},"reason":{"maxLength":1000,"type":["string","null"]}},"required":["memory_ids","decision"],"type":"object"},"EvolvesRevisionResultResponse":{"properties":{"already_applied":{"type":"boolean"},"authoritative_memory_id":{"type":["string","null"]},"decision":{"type":"string"},"labels_preserved":{"type":"boolean"},"memories":{"items":{"$ref":"#/components/schemas/EvolvesRevisionMemoryResponse"},"type":"array"},"plan_id":{"type":"string"},"relation":{"type":["string","null"]},"removed_edges":{"format":"int64","minimum":0,"type":"integer"}},"required":["plan_id","decision","memories","removed_edges","already_applied","labels_preserved"],"type":"object"},"ExpandNeighborsMetadata":{"properties":{"error":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Error message if failed","title":"Error"},"expansion_depth":{"description":"How far the expansion traversed in hops","title":"Expansion Depth","type":"integer"},"include_metadata":{"description":"If results include detailed metadata","title":"Include Metadata","type":"boolean"},"max_limit":{"description":"Limit on nodes returned","title":"Max Limit","type":"integer"},"query_type":{"description":"Indicates the search/query method","title":"Query Type","type":"string"}},"required":["expansion_depth","max_limit","include_metadata","query_type"],"title":"ExpandNeighborsMetadata","type":"object"},"ExpandNeighborsResponse":{"properties":{"center_node":{"description":"ID of expanded node","title":"Center Node","type":"string"},"depth":{"description":"Traversal depth used for expansion","title":"Depth","type":"integer"},"edges":{"description":"Edges connecting neighbors to center or each other","items":{},"title":"Edges","type":"array"},"metadata":{"$ref":"#/components/schemas/ExpandNeighborsMetadata"},"neighbors":{"description":"Neighbor nodes discovered in expansion","items":{},"title":"Neighbors","type":"array"},"total_edges":{"default":0,"description":"Number of edges found","title":"Total Edges","type":"integer"},"total_neighbors":{"default":0,"description":"Number of neighbors found","title":"Total Neighbors","type":"integer"}},"required":["center_node","depth","metadata"],"title":"ExpandNeighborsResponse","type":"object"},"FSDeleteRequest":{"properties":{"path":{"minLength":1,"type":"string"},"space_id":{"description":"Optional existing Space id, name or alias. Blank/omitted values may use\nthe X-Nmem-Space-Id header (legacy X-Nowledge-Space-Id). Without either,\nthe path selects its current Space; later movement prevents deletion.","type":["string","null"]}},"required":["path"],"type":"object"},"FSWriteRequest":{"properties":{"body":{"default":"","title":"Body","type":"string"},"frontmatter":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Frontmatter"},"path":{"minLength":1,"title":"Path","type":"string"},"record_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Record Version"}},"required":["path"],"title":"FSWriteRequest","type":"object"},"FeedEventVisibilityRequest":{"properties":{"hidden":{"description":"Hide this immutable Timeline event from the current viewer.","type":"boolean"}},"required":["hidden"],"type":"object"},"FeedEventVisibilityResponse":{"properties":{"event_id":{"type":"string"},"hidden":{"type":"boolean"},"success":{"type":"boolean"}},"required":["success","event_id","hidden"],"type":"object"},"FeedEventsResponse":{"properties":{"events":{"description":"Heterogeneous immutable Timeline events. Review events include a\n`review` object with state, accepted/recommended actions, unattended\nno-change resolution, and an absolute expiry timestamp.","items":{},"type":"array"},"has_more":{"type":"boolean"},"journal_incomplete":{"description":"Local journal maintenance is incomplete in the 365-day history window.\nCloud PostgreSQL workspaces can omit this field.","type":["boolean","null"]},"limit":{"format":"int64","type":"integer"},"offset":{"format":"int64","type":"integer"},"total":{"format":"int64","type":["integer","null"]}},"required":["offset","limit","has_more","events"],"type":"object"},"FeedInputRequest":{"properties":{"content":{"maxLength":10000,"minLength":1,"title":"Content","type":"string"},"persist":{"default":true,"description":"Auto-persist after streaming. False for ephemeral queries (e.g. Chat-to-Doc Q&A).","title":"Persist","type":"boolean"},"source":{"default":"feed","title":"Source","type":"string"},"space_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Memory space for persisted captures and questions","title":"Space Id"},"thread_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Thread root event ID for follow-up conversations","title":"Thread Id"}},"required":["content"],"title":"FeedInputRequest","type":"object"},"FiltersApplied":{"additionalProperties":true,"description":"Filters applied to the search.","properties":{"edge_types":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Edge types filter","title":"Edge Types"},"node_types":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Node types filter","title":"Node Types"}},"title":"FiltersApplied","type":"object"},"FolderIngestSummaryRequest":{"description":"Emit a single folder import summary event without ingesting files.","properties":{"accumulated_totals":{"additionalProperties":{"type":"integer"},"description":"Aggregate totals collected by a remote/web chunked import","title":"Accumulated Totals","type":"object"},"folder_name":{"description":"Source folder name (for feed event title)","title":"Folder Name","type":"string"},"space_id":{"default":"default","description":"Isolation space for the imported folder","title":"Space Id","type":"string"}},"required":["folder_name","accumulated_totals"],"title":"FolderIngestSummaryRequest","type":"object"},"GraphAnalysisCapabilitiesModel":{"properties":{"community_detection":{"description":"Is community detection available","title":"Community Detection","type":"boolean"},"llm_summarization":{"description":"LLM summarization supported","title":"Llm Summarization","type":"boolean"},"pagerank_calculation":{"description":"Is PageRank calculation available","title":"Pagerank Calculation","type":"boolean"},"unified_graph_analysis":{"description":"Unified graph analysis supported","title":"Unified Graph Analysis","type":"boolean"}},"required":["community_detection","pagerank_calculation","unified_graph_analysis","llm_summarization"],"title":"GraphAnalysisCapabilitiesModel","type":"object"},"GraphAnalysisHealthCheckModel":{"properties":{"algo_extension_loaded":{"title":"Algo Extension Loaded","type":"boolean"},"capabilities":{"$ref":"#/components/schemas/GraphAnalysisCapabilitiesModel"},"checked_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Checked At"},"db_connection":{"title":"Db Connection","type":"string"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"status":{"title":"Status","type":"string"}},"required":["status","algo_extension_loaded","db_connection","capabilities"],"title":"GraphAnalysisHealthCheckModel","type":"object"},"GraphAnalysisResponseModel":{"properties":{"analysis_summary":{"$ref":"#/components/schemas/AnalysisSummaryModel","description":"Summary of analysis metrics"},"centrality_measures":{"additionalProperties":true,"description":"Centrality measures","title":"Centrality Measures","type":"object"},"communities":{"description":"List of community data","items":{},"title":"Communities","type":"array"},"community_metrics":{"additionalProperties":true,"description":"Community metrics","title":"Community Metrics","type":"object"},"graph_statistics":{"additionalProperties":true,"description":"Graph statistics","title":"Graph Statistics","type":"object"},"retrieved_at":{"description":"Timestamp when data was retrieved","title":"Retrieved At"}},"required":["analysis_summary"],"title":"GraphAnalysisResponseModel","type":"object"},"GraphCommunity":{"additionalProperties":true,"description":"Community data structure.","properties":{"algorithm":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"louvain","description":"Algorithm used for detection","title":"Algorithm"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"","description":"Community description","title":"Description"},"id":{"description":"Community identifier","title":"Id","type":"string"},"member_count":{"default":0,"description":"Number of members in the community","title":"Member Count","type":"integer"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"description":"Additional community metadata","title":"Metadata"},"name":{"description":"Community name","title":"Name","type":"string"},"resolution":{"anyOf":[{"type":"number"},{"type":"null"}],"default":1,"description":"Resolution parameter used","title":"Resolution"},"strength":{"default":1,"description":"Community strength score","title":"Strength","type":"number"}},"required":["id","name"],"title":"GraphCommunity","type":"object"},"GraphCommunityHull":{"additionalProperties":true,"description":"Community hull data structure for visualization.","properties":{"color":{"default":"#9B59B6","description":"Hull color","title":"Color","type":"string"},"community_id":{"description":"Community identifier","title":"Community Id","type":"string"},"community_name":{"description":"Community name","title":"Community Name","type":"string"},"hull_type":{"default":"convex","description":"Type of hull visualization","title":"Hull Type","type":"string"},"member_count":{"description":"Number of members","title":"Member Count","type":"integer"},"member_nodes":{"description":"List of node IDs in this community","items":{"type":"string"},"title":"Member Nodes","type":"array"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"description":"Additional hull metadata","title":"Metadata"},"opacity":{"default":0.1,"description":"Hull opacity","title":"Opacity","type":"number"},"stroke_color":{"default":"#8E44AD","description":"Hull stroke color","title":"Stroke Color","type":"string"},"stroke_width":{"default":2,"description":"Hull stroke width","title":"Stroke Width","type":"integer"}},"required":["community_id","community_name","member_count"],"title":"GraphCommunityHull","type":"object"},"GraphDataResponse":{"additionalProperties":true,"description":"Graph data response for visualization.","properties":{"communities":{"description":"List of communities","items":{"$ref":"#/components/schemas/GraphCommunity"},"title":"Communities","type":"array"},"community_hulls":{"description":"List of community hulls","items":{"$ref":"#/components/schemas/GraphCommunityHull"},"title":"Community Hulls","type":"array"},"edges":{"description":"List of graph edges","items":{"$ref":"#/components/schemas/GraphEdge"},"title":"Edges","type":"array"},"metadata":{"$ref":"#/components/schemas/GraphMetadata","description":"Graph metadata"},"nodes":{"description":"List of graph nodes","items":{"$ref":"#/components/schemas/GraphNode"},"title":"Nodes","type":"array"},"visualization_config":{"$ref":"#/components/schemas/VisualizationConfig","description":"Visualization configuration"}},"title":"GraphDataResponse","type":"object"},"GraphEdge":{"additionalProperties":true,"description":"Graph edge data structure.","properties":{"edge_type":{"description":"Type of edge relationship","title":"Edge Type","type":"string"},"id":{"description":"Edge identifier","title":"Id","type":"string"},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Display label for the edge","title":"Label"},"metadata":{"$ref":"#/components/schemas/GraphEdgeMetadata","description":"Additional edge metadata"},"relevance_score":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Relevance score","title":"Relevance Score"},"source":{"description":"Source node ID","title":"Source","type":"string"},"target":{"description":"Target node ID","title":"Target","type":"string"},"weight":{"description":"Edge weight","title":"Weight","type":"number"}},"required":["id","source","target","edge_type","weight"],"title":"GraphEdge","type":"object"},"GraphEdgeMetadata":{"additionalProperties":true,"description":"Metadata for graph edges.","properties":{"conditions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conditions"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence"},"context":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Context"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"hop_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Hop Count"},"path_length":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Path Length"},"path_position":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Path Position"},"relation_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Relation Type"},"relationship_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Relationship Type"},"source_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Id"},"source_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Name"},"source_reference":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Reference"},"strength":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Strength"},"target_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Id"},"target_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Name"},"temporal_info":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Temporal Info"},"total_path_length":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Path Length"},"visualization":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Visualization"}},"title":"GraphEdgeMetadata","type":"object"},"GraphIntelligenceMessageRequest":{"properties":{"content":{"maxLength":10000,"minLength":1,"title":"Content","type":"string"},"graph_context":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Serialized GraphSessionContext (frozen snapshot from frontend).","title":"Graph Context"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Exploration session ID. If omitted, uses the shared session.","title":"Session Id"},"space_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional active memory space for space-aware tool retrieval.","title":"Space Id"}},"required":["content"],"title":"GraphIntelligenceMessageRequest","type":"object"},"GraphMetadata":{"additionalProperties":true,"description":"Metadata about the graph data.","properties":{"entity_nodes":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Number of entity nodes","title":"Entity Nodes"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Error message if any","title":"Error"},"filter_type":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter type applied","title":"Filter Type"},"memory_nodes":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Number of memory nodes","title":"Memory Nodes"},"mention_edges":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Number of MENTIONS edges","title":"Mention Edges"},"query_method":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Query method used","title":"Query Method"},"relationship_edges":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Number of RELATES_TO edges","title":"Relationship Edges"},"total_communities":{"default":0,"description":"Total number of communities","title":"Total Communities","type":"integer"},"total_edges":{"default":0,"description":"Total number of edges","title":"Total Edges","type":"integer"},"total_nodes":{"default":0,"description":"Total number of nodes","title":"Total Nodes","type":"integer"},"traversal_depth":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Traversal depth used","title":"Traversal Depth"}},"title":"GraphMetadata","type":"object"},"GraphNode":{"additionalProperties":true,"description":"Graph node data structure.","properties":{"color":{"description":"Node color for visualization","title":"Color","type":"string"},"community":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Community ID this node belongs to","title":"Community"},"hop_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Number of hops from source","title":"Hop Count"},"id":{"description":"Node identifier","title":"Id","type":"string"},"importance":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Importance score of the node","title":"Importance"},"label":{"description":"Display label for the node","title":"Label","type":"string"},"metadata":{"$ref":"#/components/schemas/GraphNodeMetadata","description":"Additional node metadata"},"node_subtype":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Subtype of the node","title":"Node Subtype"},"node_type":{"description":"Type of node (entity, memory, etc.)","title":"Node Type","type":"string"},"pagerank_score":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"PageRank score","title":"Pagerank Score"},"size":{"description":"Node size for visualization","title":"Size","type":"number"},"thread_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Thread ID if node is a thread","title":"Thread Id"}},"required":["id","label","node_type","size","color"],"title":"GraphNode","type":"object"},"GraphNodeMetadata":{"additionalProperties":true,"description":"Metadata for graph nodes.","properties":{"community_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Community Id"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence"},"content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"degree":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Degree"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"entity_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Entity Count"},"entity_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Type"},"hop_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Hop Count"},"importance":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Importance"},"pagerank_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pagerank Score"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"thread_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thread Id"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"title":"GraphNodeMetadata","type":"object"},"GraphSearchResponse":{"additionalProperties":true,"description":"Graph search response that extends GraphDataResponse with search-specific fields.","properties":{"communities":{"description":"List of communities","items":{"$ref":"#/components/schemas/GraphCommunity"},"title":"Communities","type":"array"},"community_hulls":{"description":"List of community hulls","items":{"$ref":"#/components/schemas/GraphCommunityHull"},"title":"Community Hulls","type":"array"},"edges":{"anyOf":[{"items":{"$ref":"#/components/schemas/GraphEdge"},"type":"array"},{"type":"null"}],"description":"List of graph edges","title":"Edges"},"metadata":{"anyOf":[{"$ref":"#/components/schemas/GraphMetadata"},{"type":"null"}],"description":"Graph metadata"},"nodes":{"anyOf":[{"items":{"$ref":"#/components/schemas/GraphNode"},"type":"array"},{"type":"null"}],"description":"List of graph nodes","title":"Nodes"},"query":{"description":"Search query string","title":"Query","type":"string"},"search_metadata":{"anyOf":[{"$ref":"#/components/schemas/SearchMetadata"},{"type":"null"}],"description":"Search-specific metadata"},"visualization_config":{"$ref":"#/components/schemas/VisualizationConfig","description":"Visualization configuration"}},"required":["query"],"title":"GraphSearchResponse","type":"object"},"GraphStatsSummary":{"additionalProperties":true,"description":"Summary of graph statistics.","properties":{"community_nodes":{"default":0,"description":"Number of community nodes","title":"Community Nodes","type":"integer"},"entity_nodes":{"default":0,"description":"Number of entity nodes","title":"Entity Nodes","type":"integer"},"memory_nodes":{"default":0,"description":"Number of memory nodes","title":"Memory Nodes","type":"integer"},"mention_edges":{"default":0,"description":"Number of MENTIONS edges","title":"Mention Edges","type":"integer"},"relation_edges":{"default":0,"description":"Number of RELATES_TO edges","title":"Relation Edges","type":"integer"}},"title":"GraphStatsSummary","type":"object"},"GuardedReviewLabel":{"properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"type":"object"},"GuardedReviewMemory":{"properties":{"content":{"type":"string"},"created_at":{},"evidence_fields":{"additionalProperties":{},"propertyNames":{"type":"string"},"type":"object"},"id":{"type":"string"},"is_latest":{"type":"boolean"},"labels":{"items":{"$ref":"#/components/schemas/GuardedReviewLabel"},"type":"array"},"lifecycle_state":{"type":"string"},"space_id":{"type":"string"},"title":{"type":"string"}},"required":["id","title","content","space_id","lifecycle_state","is_latest","created_at","evidence_fields","labels"],"type":"object"},"GuardedReviewPhase":{"enum":["preview","apply"],"type":"string"},"GuardedReviewPlan":{"properties":{"action":{"$ref":"#/components/schemas/TimelineReviewAction"},"can_apply":{"type":"boolean"},"cannot_apply_reason":{"type":["string","null"]},"current_edges":{"items":{},"type":"array"},"from_memory_id":{"type":"string"},"memories":{"items":{"$ref":"#/components/schemas/GuardedReviewMemory"},"type":"array"},"plan_id":{"type":"string"},"relation":{"type":"string"},"to_memory_id":{"type":"string"}},"required":["plan_id","action","memories","current_edges","from_memory_id","to_memory_id","relation","can_apply"],"type":"object"},"GuardedReviewResult":{"properties":{"action":{"type":["string","null"]},"action_result":{"description":"Original backend effect detail, never reconstructed on retry."},"already_resolved":{"type":["boolean","null"]},"event_id":{"type":"string"},"preview":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/GuardedReviewPlan"}]},"projection_pending":{"type":["boolean","null"]},"receipt":{"description":"Original semantic receipt, null for historical decisions without one."},"resolution":{"type":["string","null"]},"resolution_note":{"type":["string","null"]},"success":{"type":"boolean"}},"required":["success","event_id"],"type":"object"},"GuardedTimelineReviewRequest":{"additionalProperties":false,"description":"Documentation mirror of the protocol-only nmem-wire request. The live\nroute deserializes the shared request; contract tests compare both forms.","properties":{"action":{"$ref":"#/components/schemas/TimelineReviewAction"},"memory_ids":{"items":{"type":"string"},"type":["array","null"]},"phase":{"$ref":"#/components/schemas/GuardedReviewPhase"},"plan_id":{"description":"Exact plan displayed before applying a graph-changing decision.","type":["string","null"]},"resolution_note":{"maxLength":1000,"type":["string","null"]}},"required":["phase","action"],"type":"object"},"GuardedTimelineReviewResponse":{"properties":{"action":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/TimelineReviewAction","description":"Semantic action from the preview or stored decision, not the retry request."}]},"event_id":{"type":"string"},"message":{"type":"string"},"protocol_version":{"example":1,"format":"int32","minimum":0,"type":"integer"},"result":{"$ref":"#/components/schemas/GuardedReviewResult"},"success":{"type":"boolean"}},"required":["protocol_version","success","event_id","result","message"],"type":"object"},"GuidanceRulePayload":{"properties":{"agentProfileId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agentprofileid"},"archivedAt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Archivedat"},"archivedBy":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Archivedby"},"archivedReason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Archivedreason"},"body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Body"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence"},"evidenceMemoryIds":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Evidencememoryids"},"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"priority":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Priority"},"rationale":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rationale"},"scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scope"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"spaceId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Spaceid"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"supportCount":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Supportcount"},"supportedEvidenceMemoryIds":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Supportedevidencememoryids"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"unsupportedEvidenceMemoryIds":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Unsupportedevidencememoryids"}},"title":"GuidanceRulePayload","type":"object"},"GuidanceRuleResponse":{"description":"Owner-managed AI Context rule stored in app-settings.json.","properties":{"agentProfileId":{"default":"","title":"Agentprofileid","type":"string"},"archivedAt":{"default":"","title":"Archivedat","type":"string"},"archivedBy":{"default":"","title":"Archivedby","type":"string"},"archivedReason":{"default":"","title":"Archivedreason","type":"string"},"body":{"title":"Body","type":"string"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence"},"createdAt":{"default":"","title":"Createdat","type":"string"},"evidenceMemoryIds":{"items":{"type":"string"},"title":"Evidencememoryids","type":"array"},"id":{"title":"Id","type":"string"},"priority":{"default":50,"title":"Priority","type":"integer"},"rationale":{"default":"","title":"Rationale","type":"string"},"scope":{"default":"global","enum":["global","agent","space"],"title":"Scope","type":"string"},"source":{"default":"manual","title":"Source","type":"string"},"spaceId":{"default":"default","title":"Spaceid","type":"string"},"status":{"default":"active","enum":["draft","active","archived"],"title":"Status","type":"string"},"supportCount":{"default":0,"title":"Supportcount","type":"integer"},"supportedEvidenceMemoryIds":{"items":{"type":"string"},"title":"Supportedevidencememoryids","type":"array"},"tags":{"items":{"type":"string"},"title":"Tags","type":"array"},"title":{"title":"Title","type":"string"},"unsupportedEvidenceMemoryIds":{"items":{"type":"string"},"title":"Unsupportedevidencememoryids","type":"array"},"updatedAt":{"default":"","title":"Updatedat","type":"string"}},"required":["id","title","body"],"title":"GuidanceRuleResponse","type":"object"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"title":"Detail","type":"array"}},"title":"HTTPValidationError","type":"object"},"HealthResponse":{"description":"Health check response.","properties":{"buffer_pool_auto_cap_mb":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Buffer Pool Auto Cap Mb"},"buffer_pool_auto_escalated_mb":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Buffer Pool Auto Escalated Mb"},"buffer_pool_auto_floor_mb":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Buffer Pool Auto Floor Mb"},"buffer_pool_auto_mode":{"default":true,"title":"Buffer Pool Auto Mode","type":"boolean"},"buffer_pool_current_mb":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Buffer Pool Current Mb"},"buffer_pool_exhausted":{"default":false,"title":"Buffer Pool Exhausted","type":"boolean"},"buffer_pool_next_start_mb":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Buffer Pool Next Start Mb"},"buffer_pool_restart_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Buffer Pool Restart Reason"},"buffer_pool_restart_required":{"default":false,"title":"Buffer Pool Restart Required","type":"boolean"},"buffer_pool_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Buffer Pool Source"},"content_store":{"anyOf":[{"$ref":"#/components/schemas/ContentStoreHealth"},{"type":"null"}]},"database_connected":{"title":"Database Connected","type":"boolean"},"db_recovery_notice":{"anyOf":[{"$ref":"#/components/schemas/DatabaseRecoveryNotice"},{"type":"null"}]},"plugin_updates":{"items":{"$ref":"#/components/schemas/PluginUpdateInfo"},"title":"Plugin Updates","type":"array"},"services_ready":{"title":"Services Ready","type":"boolean"},"status":{"title":"Status","type":"string"},"timestamp":{"format":"date-time","title":"Timestamp","type":"string"},"version":{"title":"Version","type":"string"}},"required":["status","version","timestamp","database_connected","services_ready"],"title":"HealthResponse","type":"object"},"HostConfigDir":{"description":"Custom config directory for one host, or empty to clear the override.","properties":{"config_dir":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Config Dir"}},"title":"HostConfigDir","type":"object"},"IdentityCorrectionRequest":{"additionalProperties":false,"properties":{"expected_epoch":{"description":"Copy epoch from the latest IdentityEvidence.","type":"string"},"expected_generation":{"minimum":0,"type":"integer"},"expected_revision":{"minimum":0,"type":"integer"},"identity_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Required even when null: null records an explicit human-confirmed unknown decision; omission is invalid."},"mention_id":{"description":"Occurrence to correct.","type":"string"},"source_revision":{"description":"Copy from the latest IdentityEvidence.","type":"string"},"space_id":{"description":"Exact Space ID. Pass explicitly; this operation does not infer the active Space or broaden to other Spaces.","type":"string"}},"required":["space_id","source_revision","expected_epoch","expected_generation","mention_id","expected_revision","identity_id"],"type":"object"},"IdentityEvidence":{"properties":{"epoch":{"description":"Ledger incarnation; copy into expected_epoch for a correction.","type":"string"},"generation":{"minimum":0,"type":"integer"},"memory_id":{"type":"string"},"occurrences":{"items":{"$ref":"#/components/schemas/IdentityOccurrence"},"type":"array"},"source_revision":{"description":"Source fingerprint used for optimistic concurrency; copy from the latest read.","type":"string"},"space_id":{"description":"Exact Space ID. Pass explicitly; this operation does not infer the active Space or broaden to other Spaces.","type":"string"}},"required":["memory_id","space_id","source_revision","epoch","generation","occurrences"],"type":"object"},"IdentityExtractionRequest":{"additionalProperties":false,"properties":{"mention_ids":{"anyOf":[{"items":{"type":"string"},"maxItems":100,"type":"array"},{"type":"null"}],"description":"Omit or set null for initial extraction only, with no new_spans. An explicit array selects existing machine occurrences; an empty array can accompany new_spans. Human decisions cannot be overwritten."},"new_spans":{"default":[],"description":"Optional nonempty, non-overlapping source spans (start must be less than end). Requires an explicit mention_ids array. A span overlapping existing machine evidence must fully contain each overlapping occurrence and explicitly select its mention ID. Overlapping human evidence is rejected.","items":{"$ref":"#/components/schemas/IdentityExtractionSpan"},"maxItems":100,"type":"array"},"space_id":{"description":"Exact Space ID. Pass explicitly; this operation does not infer the active Space or broaden to other Spaces.","type":"string"}},"required":["space_id"],"type":"object"},"IdentityExtractionSpan":{"additionalProperties":false,"properties":{"end":{"description":"Zero-based Unicode scalar-value offsets into the current Memory text, with an exclusive end. These are not UTF-8 byte or JavaScript UTF-16 offsets.","minimum":0,"type":"integer"},"start":{"description":"Zero-based Unicode scalar-value offsets into the current Memory text, with an exclusive end. These are not UTF-8 byte or JavaScript UTF-16 offsets.","minimum":0,"type":"integer"}},"required":["start","end"],"type":"object"},"IdentityOccurrence":{"properties":{"end":{"description":"Zero-based Unicode scalar-value offsets into the current Memory text, with an exclusive end. These are not UTF-8 byte or JavaScript UTF-16 offsets.","minimum":0,"type":"integer"},"identity_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Assigned profile ID, or null for unresolved/unknown."},"mention_id":{"description":"Opaque occurrence ID from this evidence response.","type":"string"},"origin":{"enum":["machine","human"],"type":"string"},"revision":{"minimum":0,"type":"integer"},"start":{"description":"Zero-based Unicode scalar-value offsets into the current Memory text, with an exclusive end. These are not UTF-8 byte or JavaScript UTF-16 offsets.","minimum":0,"type":"integer"},"surface":{"description":"The exact source text covered by this occurrence.","type":"string"}},"required":["mention_id","start","end","surface","identity_id","origin","revision"],"type":"object"},"IdentityOperationError":{"properties":{"detail":{"description":"Safe message explaining this cause.","type":"string"},"error_code":{"description":"Registered cause identifier. Do not infer the cause from status or message text.","type":"string"},"retryable":{"description":"Whether the same operation may be retried after the transient cause clears. Evidence/profile conflicts can instead require a fresh read.","type":"boolean"},"profile_id":{"type":"string","description":"Only on POST /identity/cards when a new profile was created but its card could not be saved: retry with this profile_id instead of creating again."}},"required":["detail","error_code","retryable"],"type":"object"},"IdentityProfile":{"properties":{"context":{"items":{"type":"string"},"type":"array"},"id":{"description":"Opaque profile ID returned by this server. Same-name profiles have distinct IDs.","type":"string"},"kind":{"description":"Descriptive identity kind; it grants no account membership or permissions.","enum":["human","agent","unknown"],"type":"string"},"names":{"items":{"type":"string"},"type":"array"},"revision":{"minimum":0,"type":"integer"},"subject":{"anyOf":[{"$ref":"#/components/schemas/IdentitySubject"},{"type":"null"}],"description":"Linked AI Identity or member; null for people and Agents known only from content. A link whose AI Identity was deleted or whose member left is still returned."}},"required":["id","revision","kind","names","context"],"type":"object"},"IdentityProfileRemove":{"additionalProperties":false,"properties":{"expected_revision":{"description":"The profile's current revision; a stale revision is rejected with identity_profile_changed. To retry an incomplete removal, pass the tombstone's revision.","minimum":0,"type":"integer"},"id":{"description":"ID of the profile to remove.","type":"string"},"space_id":{"description":"Exact Space ID. Pass explicitly; this operation does not infer the active Space or broaden to other Spaces.","type":"string"}},"required":["space_id","id","expected_revision"],"type":"object"},"IdentityProfileRemoved":{"properties":{"complete":{"description":"False while machine links are still being returned to unresolved in the background, or while skipped_sources is non-zero.","type":"boolean"},"id":{"type":"string"},"revision":{"description":"The tombstone's revision; pass it as expected_revision to retry an incomplete removal.","minimum":1,"type":"integer"},"skipped_sources":{"description":"Memories whose identity metadata could not be rewritten; their machine links still name the removed profile, which keeps them hidden. Repeat the removal after repair.","minimum":0,"type":"integer"}},"required":["id","revision","complete","skipped_sources"],"type":"object"},"IdentityProfileWrite":{"additionalProperties":false,"oneOf":[{"properties":{"expected_revision":{"type":"null"},"id":{"type":"null"}}},{"properties":{"expected_revision":{"minimum":0,"type":"integer"},"id":{"type":"string"}},"required":["expected_revision"]}],"properties":{"aliases":{"items":{"description":"Nonblank alias, at most 512 UTF-8 bytes.","type":"string"},"maxItems":32,"type":"array"},"context":{"description":"Disambiguating context, at most 8192 UTF-8 bytes. An empty string is allowed.","type":"string"},"expected_revision":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"Null or omitted on creation; required and equal to the current revision on update."},"id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Required: explicit null creates a new independent profile; an existing ID updates that profile."},"kind":{"description":"Descriptive identity kind; it grants no account membership or permissions.","enum":["human","agent","unknown"],"type":"string"},"name":{"description":"Nonblank display name, at most 512 UTF-8 bytes.","type":"string"},"space_id":{"description":"Exact Space ID. Pass explicitly; this operation does not infer the active Space or broaden to other Spaces.","type":"string"},"subject":{"anyOf":[{"$ref":"#/components/schemas/IdentitySubject"},{"type":"null"}],"description":"Optional. Omit to keep the current link; null removes it; an object links the profile to an enrolled AI Identity (kind must be agent) or an active member (kind must be human). The subject must be available when set, and at most one profile per Space may link to it."}},"required":["space_id","id","name","aliases","context","kind"],"type":"object"},"IdentitySubject":{"description":"An accountable identity that a content profile denotes. Linking grants no membership or permissions. AI Identity links retain their original roster incarnation even after deletion, replacement or import.","oneOf":[{"additionalProperties":false,"properties":{"id":{"maxLength":256,"minLength":1,"type":"string"},"kind":{"const":"agent_identity","type":"string"},"reference":{"description":"Opaque scoped incarnation from AgentProfileResponse.identityReference. Copy the observed value when linking; a stale or foreign reference is rejected. Omitted/null historical references remain unverified. Explicitly linking an uninitialized legacy roster identity with null may initialize its reference.","type":["string","null"]}},"required":["kind","id"],"type":"object"},{"additionalProperties":false,"properties":{"id":{"maxLength":256,"minLength":1,"type":"string"},"kind":{"const":"member","type":"string"}},"required":["kind","id"],"type":"object"}]},"ImportConfigModel":{"description":"Model for import configuration.","properties":{"auto_import_rules":{"description":"Auto-import rules","items":{"$ref":"#/components/schemas/AutoImportRuleModel"},"title":"Auto Import Rules","type":"array"},"cursor_poll_interval":{"default":30,"description":"Seconds between Cursor polls (SQLite polling)","title":"Cursor Poll Interval","type":"number"},"dedup_window_seconds":{"default":60,"description":"Deduplication window in seconds","title":"Dedup Window Seconds","type":"integer"},"hidden_projects":{"description":"Hidden project encodings","items":{"type":"string"},"title":"Hidden Projects","type":"array"},"hidden_sessions":{"description":"Hidden session IDs","items":{"type":"string"},"title":"Hidden Sessions","type":"array"},"show_hidden_by_default":{"default":false,"description":"Show hidden by default","title":"Show Hidden By Default","type":"boolean"},"watched_platforms":{"description":"Platforms to auto-import from (e.g. claude, codex, opencode, cursor)","items":{"type":"string"},"title":"Watched Platforms","type":"array"},"watched_projects":{"description":"Encoded project paths to auto-import","items":{"type":"string"},"title":"Watched Projects","type":"array"},"watcher_enabled":{"default":false,"description":"Whether watcher is enabled","title":"Watcher Enabled","type":"boolean"}},"title":"ImportConfigModel","type":"object"},"ImportConfigUpdateRequest":{"description":"Request for updating import config.","properties":{"auto_import_rules":{"anyOf":[{"items":{"$ref":"#/components/schemas/AutoImportRuleModel"},"type":"array"},{"type":"null"}],"description":"Auto-import rules","title":"Auto Import Rules"},"cursor_poll_interval":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Seconds between Cursor polls (SQLite polling)","title":"Cursor Poll Interval"},"dedup_window_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Deduplication window","title":"Dedup Window Seconds"},"hidden_projects":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Hidden project encodings","title":"Hidden Projects"},"hidden_sessions":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Hidden session IDs","title":"Hidden Sessions"},"show_hidden_by_default":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Show hidden by default","title":"Show Hidden By Default"},"watched_platforms":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Platforms to auto-import from (e.g. claude, codex, opencode, cursor)","title":"Watched Platforms"},"watched_projects":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Encoded project paths to auto-import","title":"Watched Projects"},"watcher_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Whether watcher is enabled","title":"Watcher Enabled"}},"title":"ImportConfigUpdateRequest","type":"object"},"IngestContentRequest":{"description":"Request body for ingesting raw text content (a paste, or a text file read on\nthe client). JSON, so it works identically in desktop/web/remote without the\nmultipart + file-path plumbing — the client reads the text and posts it.","properties":{"content":{"description":"The raw text to ingest as a Library source","title":"Content","type":"string"},"labels":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Label names to assign","title":"Labels"},"name":{"description":"A display name for the source, e.g. notes.md","title":"Name","type":"string"},"space_id":{"default":"default","description":"Isolation space","title":"Space Id","type":"string"},"user_comment":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional note about it","title":"User Comment"}},"required":["name","content"],"title":"IngestContentRequest","type":"object"},"IngestFilePathRequest":{"properties":{"file_path":{"description":"Absolute path on the server host.","type":"string"},"labels":{"description":"Label names to assign to the Source.","items":{"type":"string"},"type":"array"},"pdf_render_scale":{"description":"PDFium render scale for scanned-PDF vision/OCR pages. `1.0` is 72 DPI.\nWhen omitted, remote vision uses `1.0`; an installed local vision model\nkeeps the higher-quality local default. `NMEM_PDF_VISION_RENDER_SCALE`\nprovides a process-wide override.","format":"float","maximum":2,"minimum":0.5,"type":["number","null"]},"processing_mode":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/SourceProcessingMode","description":"`interactive` returns a text-bearing PDF after native parsing without\nwaiting for optional figure enrichment. Scanned PDFs still run OCR."}]},"space_id":{"description":"Existing Space to store the Source in.","type":"string"},"user_comment":{"description":"Optional note stored with the Source.","type":["string","null"]}},"required":["file_path"],"type":"object"},"IngestFileUploadRequest":{"description":"Typed multipart body for `POST /sources/ingest/file`.","properties":{"attachment_reference":{"description":"JSON-encoded Thread attachment reference. When present, the server\nvalidates it against authoritative message metadata and authors capture\nprovenance; clients cannot supply provenance through `metadata`.","type":["string","null"]},"file":{"contentMediaType":"application/octet-stream","description":"File payload. The complete multipart request is limited to 32 MiB or the\noperator's lower process-wide request limit.","type":"string"},"labels":{"description":"Comma-separated label names.","type":["string","null"]},"metadata":{"description":"Optional JSON object merged into Source metadata.","type":["string","null"]},"pdf_render_scale":{"description":"PDFium render scale for scanned-PDF vision/OCR pages.","format":"float","maximum":2,"minimum":0.5,"type":["number","null"]},"processing_mode":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/SourceProcessingMode","description":"`interactive` prioritizes immediate native-text availability."}]},"space_id":{"description":"Existing Space to store the Source in.","type":["string","null"]},"user_comment":{"description":"Optional note stored with the Source.","type":["string","null"]}},"required":["file"],"type":"object"},"IngestResponse":{"description":"Response from ingestion endpoints.","properties":{"is_duplicate":{"default":false,"title":"Is Duplicate","type":"boolean"},"lifecycle_state":{"title":"Lifecycle State","type":"string"},"message":{"default":"","title":"Message","type":"string"},"original_name":{"title":"Original Name","type":"string"},"source_id":{"title":"Source Id","type":"string"}},"required":["source_id","original_name","lifecycle_state"],"title":"IngestResponse","type":"object"},"IngestUrlRequest":{"properties":{"labels":{"description":"Label names to assign to the Source.","items":{"type":"string"},"type":"array"},"pdf_render_scale":{"description":"PDFium render scale for scanned-PDF vision/OCR pages when the URL\nresolves to a PDF. See [`IngestFilePathRequest::pdf_render_scale`].","format":"float","maximum":2,"minimum":0.5,"type":["number","null"]},"space_id":{"description":"Existing Space to store the Source in.","type":"string"},"url":{"description":"Public URL to fetch and ingest.","type":"string"},"user_comment":{"description":"Optional note stored with the Source.","type":["string","null"]}},"required":["url"],"type":"object"},"LabelAffectedIdsResponse":{"properties":{"entities":{"items":{"type":"string"},"type":"array"},"limit_per_type":{"minimum":0,"type":"integer"},"memories":{"items":{"type":"string"},"type":"array"},"sources":{"items":{"type":"string"},"type":"array"},"threads":{"items":{"type":"string"},"type":"array"},"truncated":{"type":"boolean"}},"required":["memories","sources","entities","threads","truncated","limit_per_type"],"type":"object"},"LabelApplyRequest":{"properties":{"plan_id":{"type":"string"}},"required":["plan_id"],"type":"object"},"LabelImpactCountsResponse":{"properties":{"entities":{"format":"int64","minimum":0,"type":"integer"},"memories":{"format":"int64","minimum":0,"type":"integer"},"sources":{"format":"int64","minimum":0,"type":"integer"},"threads":{"format":"int64","minimum":0,"type":"integer"},"total":{"format":"int64","minimum":0,"type":"integer"}},"required":["memories","sources","entities","threads","total"],"type":"object"},"LabelLifecyclePlanResponse":{"properties":{"action":{"type":"string"},"affected":{"$ref":"#/components/schemas/LabelImpactCountsResponse"},"affected_ids":{"$ref":"#/components/schemas/LabelAffectedIdsResponse"},"can_apply":{"type":"boolean"},"duplicate_assignments":{"format":"int64","minimum":0,"type":"integer"},"memories_preserved":{"type":"boolean"},"plan_id":{"type":"string"},"source":{"$ref":"#/components/schemas/LabelLifecycleSummaryResponse"},"target":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/LabelLifecycleSummaryResponse"}]}},"required":["action","plan_id","source","affected","affected_ids","duplicate_assignments","memories_preserved","can_apply"],"type":"object"},"LabelLifecycleSummaryResponse":{"properties":{"canonical_name":{"type":"string"},"color":{"type":"string"},"description":{"type":"string"},"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name","canonical_name","color","description"],"type":"object"},"LabelMergeApplyRequest":{"properties":{"plan_id":{"type":"string"},"target_label_id":{"type":"string"}},"required":["target_label_id","plan_id"],"type":"object"},"LabelMergePreviewRequest":{"properties":{"target_label_id":{"type":"string"}},"required":["target_label_id"],"type":"object"},"LabelMutationResponse":{"properties":{"action":{"type":"string"},"affected":{"$ref":"#/components/schemas/LabelImpactCountsResponse"},"affected_ids":{"$ref":"#/components/schemas/LabelAffectedIdsResponse"},"already_applied":{"type":"boolean"},"duplicate_assignments":{"format":"int64","minimum":0,"type":"integer"},"plan_id":{"type":"string"},"source_label_id":{"type":"string"},"target_label_id":{"type":["string","null"]}},"required":["action","plan_id","source_label_id","affected","affected_ids","duplicate_assignments","already_applied"],"type":"object"},"LabelResponse":{"additionalProperties":true,"description":"Label response model.","properties":{"color":{"description":"Label color (hex)","title":"Color","type":"string"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Creation timestamp","title":"Created At"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Label description","title":"Description"},"id":{"description":"Label identifier","title":"Id","type":"string"},"name":{"description":"Label name","title":"Name","type":"string"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Last update timestamp","title":"Updated At"},"usage_count":{"default":0,"description":"Number of memories/entities using this label","title":"Usage Count","type":"integer"}},"required":["id","name","color"],"title":"LabelResponse","type":"object"},"LabelsResponse":{"additionalProperties":true,"description":"Response containing a list of labels (used for both memory and source label endpoints).","properties":{"labels":{"description":"List of assigned labels","items":{"additionalProperties":true,"type":"object"},"title":"Labels","type":"array"}},"title":"LabelsResponse","type":"object"},"MemoryCleanupArchiveRequest":{"properties":{"memory_ids":{"items":{"type":"string"},"maxItems":100,"title":"Memory Ids","type":"array"},"review_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Review Token"},"space_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Space Id"}},"title":"MemoryCleanupArchiveRequest","type":"object"},"MemoryCleanupCompactionRequest":{"properties":{"memory_ids":{"items":{"type":"string"},"maxItems":100,"title":"Memory Ids","type":"array"},"review_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Review Token"},"space_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Space Id"}},"title":"MemoryCleanupCompactionRequest","type":"object"},"MemoryCleanupKeepRequest":{"properties":{"memory_ids":{"items":{"type":"string"},"maxItems":100,"title":"Memory Ids","type":"array"},"review_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Review Token"},"space_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Space Id"}},"title":"MemoryCleanupKeepRequest","type":"object"},"MemoryCreateRequest":{"description":"Request to create a new Memory, or upsert one by custom ID.","properties":{"agent_id":{"description":"Portable AI Identity attribution. Identity is provenance, not auth.","type":["string","null"]},"claim_status":{"description":"Exact claim status for source-derived assessment; metadata remains supported.","type":["string","null"]},"confidence":{"default":0.5,"description":"Confidence score.","format":"double","maximum":1,"minimum":0,"type":"number"},"content":{"description":"Memory content.","maxLength":32768,"type":"string"},"event_end":{"description":"When an event range ended: `YYYY`, `YYYY-MM`, or `YYYY-MM-DD`.","type":["string","null"]},"event_start":{"description":"When the event occurred: `YYYY`, `YYYY-MM`, or `YYYY-MM-DD`.","type":["string","null"]},"host_agent_id":{"description":"Stable host-local alias for the same AI Identity.","type":["string","null"]},"id":{"description":"Optional custom ID. An existing ID is updated; an absent ID generates a UUID.","maxLength":200,"minLength":1,"type":["string","null"]},"importance":{"default":0.5,"description":"Importance score.","format":"double","maximum":1,"minimum":0,"type":"number"},"labels":{"description":"Label names to assign.","items":{"type":"string"},"type":["array","null"]},"metadata":{"additionalProperties":{},"description":"Additional metadata.","propertyNames":{"type":"string"},"type":"object"},"source":{"description":"Display/source provenance, for example `manual`, `codex`, or `claude-code`.","type":["string","null"]},"source_app":{"description":"Runtime provenance, kept separate from the display/source field.","type":["string","null"]},"source_grounding":{"description":"Exact source grounding for source-derived assessment, without display normalization.","type":["string","null"]},"source_message_id":{"description":"Compatibility form for one source message. Preserved in metadata;\ncallers that know message order should prefer `source_message_indices`.","type":["string","null"]},"source_message_indices":{"description":"Exact message order-indices used to distill this Memory.","items":{"format":"int64","type":"integer"},"type":["array","null"]},"source_message_range":{"additionalProperties":{"format":"int64","type":"integer"},"description":"Legacy Python-compatible inclusive message range\n`{start_index, end_index}`. Canonicalized to `source_message_indices`.","propertyNames":{"type":"string"},"type":["object","null"]},"source_thread_id":{"description":"Thread-distillation provenance: the source thread + the exact source\nmessage order-indices the memory was distilled from\n(`CreateMemoryParams`, `agent/knowledge_tools/memory_create_params.py`).","type":["string","null"]},"space_id":{"description":"Existing Space to store the Memory in. Defaults to the Agent profile's\nSpace when identity is present, otherwise the canonical default Space.","type":["string","null"]},"temporal_context":{"description":"Temporal context: `past`, `present`, `future`, or `timeless`.","type":["string","null"]},"title":{"description":"Optional descriptive title.","maxLength":200,"type":["string","null"]},"unit_type":{"description":"Knowledge unit type, for example `fact`, `decision`, `preference`,\n`procedure`, or `learning`.","type":["string","null"]},"write_intent":{"description":"Explicit authored or server-assessed source-derived write. source_support allows ordinary observations; human_ruling additionally requires supported human adoption. Both require authoritative selected thread/message evidence and never fall back to authored on failure. Omit for legacy authored behavior.","oneOf":[{"additionalProperties":false,"properties":{"kind":{"enum":["authored"],"type":"string"},"version":{"enum":[1],"type":"integer"}},"required":["version","kind"],"type":"object"},{"additionalProperties":false,"properties":{"assessment":{"enum":["source_support","human_ruling"],"type":"string"},"kind":{"enum":["source_derived"],"type":"string"},"source":{"additionalProperties":false,"properties":{"kind":{"enum":["thread"],"type":"string"},"message_ids":{"items":{"minLength":1,"type":"string"},"maxItems":10000,"minItems":1,"type":"array","uniqueItems":true},"thread_id":{"minLength":1,"type":"string"}},"required":["kind","thread_id","message_ids"],"type":"object"},"version":{"enum":[1],"type":"integer"}},"required":["version","kind","assessment","source"],"type":"object"}]}},"required":["content"],"type":"object"},"MemoryCreateResponse":{"description":"Response from memory creation or upsert.","properties":{"action":{"default":"created","description":"'created' for new memories, 'updated' for upsert hits","title":"Action","type":"string"},"assigned_labels":{"items":{"type":"string"},"title":"Assigned Labels","type":"array"},"created_relationships":{"default":0,"description":"Number of relationships created","title":"Created Relationships","type":"integer"},"extracted_entities":{"items":{"$ref":"#/components/schemas/EntityNode"},"title":"Extracted Entities","type":"array"},"memory":{"$ref":"#/components/schemas/MemoryNode"},"warnings":{"description":"Non-fatal follow-up issues after the memory was persisted","items":{"type":"string"},"title":"Warnings","type":"array"}},"required":["memory"],"title":"MemoryCreateResponse","type":"object"},"MemoryKGApplyRequest":{"description":"Request to apply KG extraction results to a memory.\n\nNote: memory_id is provided in the URL path, not in the request body. Exact requests reject invalid batches before writing and reject ambiguous stored identities. Older backends may ignore this field; upgrade the backend before relying on exact resolution.","properties":{"entities":{"description":"Extracted entities to save","items":{},"title":"Entities","type":"array"},"entity_resolution":{"default":"automatic","description":"Use exact for controlled external writes on a backend supporting this policy. Exact matches trimmed, case-sensitive name and type only; it does not resolve through aliases or normalize punctuation. Omitted or empty aliases preserve existing aliases. Automatic retains extraction preview matching. Exact batches allow up to 50 entities and 100 relationships, require unique names and explicit type, and require relationship endpoints to exactly match submitted names.","enum":["automatic","exact"],"type":"string"},"extraction_confidence":{"description":"Confidence of the extraction","title":"Extraction Confidence","type":"number"},"relationships":{"description":"Extracted relationships to save","items":{},"title":"Relationships","type":"array"}},"required":["entities","relationships","extraction_confidence"],"title":"MemoryKGApplyRequest","type":"object"},"MemoryKGApplyResponse":{"description":"Response from applying KG extraction to memory.","properties":{"entities_created":{"description":"Number of entities created in graph","title":"Entities Created","type":"integer"},"entity_resolution":{"description":"Present when exact resolution was applied.","enum":["exact"],"type":"string"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Error message if application failed","title":"Error"},"index_repair_needed":{"description":"Entity search projection is pending repair; graph writes may already be complete.","type":"boolean"},"memory_id":{"description":"ID of the updated memory","title":"Memory Id","type":"string"},"metadata_updated":{"description":"Whether memory metadata was updated","title":"Metadata Updated","type":"boolean"},"relationships_created":{"description":"Number of relationships created in graph","title":"Relationships Created","type":"integer"},"resolved_entities":{"description":"Graph identities successfully resolved by an exact request, including partial failure. Retain for source auditing.","items":{"properties":{"entity_type":{"type":"string"},"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name","entity_type"],"type":"object"},"type":"array"},"success":{"description":"Whether application was successful","title":"Success","type":"boolean"},"warnings":{"items":{"type":"string"},"type":"array"}},"required":["success","memory_id","entities_created","relationships_created","metadata_updated"],"title":"MemoryKGApplyResponse","type":"object"},"MemoryKGContentExtractionRequest":{"description":"Read-only KG extraction preview from explicit memory-like content.","properties":{"extraction_level":{"default":"swift","description":"Extraction level: 'swift' (fast, local), 'guided' (multi-step, local), or 'expert' (remote LLM). Auto-upgrades to expert when local LLM is unavailable.","title":"Extraction Level","type":"string"},"force_reextraction":{"default":false,"description":"Force re-extraction even if KG was already extracted","title":"Force Reextraction","type":"boolean"},"memory_content":{"description":"Preview memory content","title":"Memory Content","type":"string"},"memory_id":{"default":"preview-memory","description":"Stable caller-provided preview ID. It is not written to the graph.","title":"Memory Id","type":"string"},"memory_title":{"description":"Preview memory title","title":"Memory Title","type":"string"},"preferred_language":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"User preferred output language for descriptions (ISO 639-1 code), or None to follow source language","title":"Preferred Language"},"use_remote_llm":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Whether to use a remote LLM (via LiteLLM). Omit to keep backward-compatible server defaults; desktop clients should set this explicitly.","title":"Use Remote Llm"}},"required":["memory_title","memory_content"],"title":"MemoryKGContentExtractionRequest","type":"object"},"MemoryKGExtractionRequest":{"description":"Request for knowledge graph extraction from a memory.\n\nNote: memory_id is provided in the URL path, not in the request body.","properties":{"extraction_level":{"default":"swift","description":"Extraction level: 'swift' (fast, local), 'guided' (multi-step, local), or 'expert' (remote LLM). Auto-upgrades to expert when local LLM is unavailable.","title":"Extraction Level","type":"string"},"force_reextraction":{"default":false,"description":"Force re-extraction even if KG was already extracted","title":"Force Reextraction","type":"boolean"},"preferred_language":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"User preferred output language for descriptions (ISO 639-1 code), or None to follow source language","title":"Preferred Language"},"use_remote_llm":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Whether to use a remote LLM (via LiteLLM). Omit to keep backward-compatible server defaults; desktop clients should set this explicitly.","title":"Use Remote Llm"}},"title":"MemoryKGExtractionRequest","type":"object"},"MemoryKGExtractionResponse":{"description":"Response from memory KG extraction preview.","properties":{"can_extract":{"description":"Whether extraction is possible","title":"Can Extract","type":"boolean"},"entities":{"description":"Extracted entities","items":{"additionalProperties":true,"type":"object"},"title":"Entities","type":"array"},"entities_count":{"description":"Number of extracted entities","title":"Entities Count","type":"integer"},"extraction_confidence":{"description":"Confidence of the extraction","title":"Extraction Confidence","type":"number"},"kg_already_extracted":{"description":"Whether KG was already extracted","title":"Kg Already Extracted","type":"boolean"},"memory_content":{"description":"Content of the memory","title":"Memory Content","type":"string"},"memory_id":{"description":"ID of the memory","title":"Memory Id","type":"string"},"memory_title":{"description":"Title of the memory","title":"Memory Title","type":"string"},"relationships":{"description":"Extracted relationships","items":{"additionalProperties":true,"type":"object"},"title":"Relationships","type":"array"},"relationships_count":{"description":"Number of extracted relationships","title":"Relationships Count","type":"integer"},"write_plan":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"description":"Read-only preview of KG writes/reuse decisions.","title":"Write Plan"}},"required":["memory_id","memory_title","memory_content","entities","relationships","extraction_confidence","entities_count","relationships_count","kg_already_extracted","can_extract"],"title":"MemoryKGExtractionResponse","type":"object"},"MemoryListResponse":{"additionalProperties":true,"description":"Response from listing memories.","properties":{"memories":{"description":"List of memories","items":{"$ref":"#/components/schemas/MemoryPublic"},"title":"Memories","type":"array"},"pagination":{"$ref":"#/components/schemas/PaginationInfo","description":"Pagination info"}},"required":["pagination"],"title":"MemoryListResponse","type":"object"},"MemoryMention":{"description":"A memory mentioning an entity.","properties":{"confidence":{"description":"Confidence of the mention","title":"Confidence","type":"number"},"memory":{"$ref":"#/components/schemas/MemorySummary","description":"Memory information"},"mention_count":{"description":"Number of times entity is mentioned","title":"Mention Count","type":"integer"}},"required":["memory","confidence","mention_count"],"title":"MemoryMention","type":"object"},"MemoryNode":{"description":"Memory node representing distilled knowledge from conversations.","properties":{"access_count":{"default":0,"description":"Total number of accesses (for frequency boost)","title":"Access Count","type":"integer"},"appearances":{"default":0,"description":"Times shown in search results","title":"Appearances","type":"integer"},"clicks":{"default":0,"description":"Times clicked/opened by user","title":"Clicks","type":"integer"},"confidence":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}],"default":0.5,"description":"Confidence score","title":"Confidence"},"content":{"description":"Memory content","title":"Content","type":"string"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"crystal_title":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Human-readable crystal title (only when is_crystal=true)","title":"Crystal Title"},"decay_score_cached":{"default":1,"description":"Pre-computed decay score (0-1)","maximum":1,"minimum":0,"title":"Decay Score Cached","type":"number"},"embedding":{"anyOf":[{"items":{"type":"number"},"type":"array"},{"type":"null"}],"description":"Vector embedding","title":"Embedding"},"event_end":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Event end date (for ranges, normalized YYYY-MM-DD)","title":"Event End"},"event_start":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Event start date (normalized YYYY-MM-DD)","title":"Event Start"},"extraction_method":{"default":"manual","description":"How this memory was created: manual|llm|rule|agent","title":"Extraction Method","type":"string"},"id":{"title":"Id","type":"string"},"importance":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}],"default":0.5,"description":"Importance score","title":"Importance"},"is_crystal":{"default":false,"description":"True for crystallized knowledge synthesized from multiple sources","title":"Is Crystal","type":"boolean"},"is_latest":{"default":true,"description":"Head of EVOLVES(replaces) version chain","title":"Is Latest","type":"boolean"},"last_accessed_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"Last time memory was shown in results or clicked","title":"Last Accessed At"},"last_clicked_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"Last time user clicked/opened this memory","title":"Last Clicked At"},"last_evaluated_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"When this crystal was last checked for staleness (only when is_crystal=true)","title":"Last Evaluated At"},"last_reindexed_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"When memory was last reindexed","title":"Last Reindexed At"},"metadata":{"additionalProperties":true,"title":"Metadata","type":"object"},"node_type":{"$ref":"#/components/schemas/NodeType","default":"Memory"},"pagerank_score":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Graph centrality score from PageRank","title":"Pagerank Score"},"reindex_needed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"Whether memory needs reindexing after edits","title":"Reindex Needed"},"review_status":{"default":"","description":"User review: '' (unreviewed), 'confirmed', 'dismissed'","title":"Review Status","type":"string"},"semantic_field":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Combined title+content for optimized indexing and search","title":"Semantic Field"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Source application (cursor, chatwise, manual, etc.)","title":"Source"},"source_range":{"anyOf":[{"additionalProperties":{"type":"integer"},"type":"object"},{"type":"null"}],"description":"Source message range {start_index, end_index}","title":"Source Range"},"source_unit_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Number of source units (only when is_crystal=true)","title":"Source Unit Count"},"space_id":{"default":"default","description":"Isolation space for this memory (for example: default, work, life)","title":"Space Id","type":"string"},"temporal_confidence":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}],"description":"LLM confidence in temporal extraction (0-1)","title":"Temporal Confidence"},"temporal_context":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"timeless","description":"Temporal context: past/present/future/timeless","title":"Temporal Context"},"temporal_precision":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Date precision for UI display: year/month/day","title":"Temporal Precision"},"temporal_type":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Temporal type: exact/range/unknown","title":"Temporal Type"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Memory title/heading","title":"Title"},"total_dwell_time_ms":{"default":0,"description":"Total time spent reading (milliseconds)","title":"Total Dwell Time Ms","type":"integer"},"unit_type":{"default":"fact","description":"Knowledge unit type: fact|preference|decision|plan|procedure|learning|context|event","title":"Unit Type","type":"string"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"},"version":{"default":1,"description":"Version counter within EVOLVES chain","title":"Version","type":"integer"}},"required":["content"],"title":"MemoryNode","type":"object"},"MemoryPolicyPatch":{"additionalProperties":false,"description":"Extraction-only settings. Omitted or null fields inherit the stored policy; an explicit empty list clears the inherited list. Text is trimmed before server validation. This is not an authorization policy or a Context Rule.","properties":{"additionalInstructions":{"description":"One-run extraction guidance; cannot override source fidelity or access boundaries.","maxLength":2000,"type":["string","null"]},"density":{"description":"Maximum retained candidates: focused 1, balanced 3, comprehensive 5. Grounding and durability review still apply.","enum":["focused","balanced","comprehensive",null],"type":["string","null"]},"detail":{"enum":["concise","balanced","detailed",null],"type":["string","null"]},"exclusions":{"anyOf":[{"items":{"maxLength":200,"type":"string"},"maxItems":12,"type":"array"},{"type":"null"}]},"priorities":{"anyOf":[{"items":{"maxLength":200,"type":"string"},"maxItems":12,"type":"array"},{"type":"null"}]}},"type":"object"},"MemoryPublic":{"additionalProperties":true,"description":"Frontend memory format.","properties":{"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Confidence score","title":"Confidence"},"content":{"description":"Memory content","title":"Content","type":"string"},"id":{"description":"Memory ID","title":"Id","type":"string"},"importance":{"description":"Memory importance score from 0.0 to 1.0","title":"Importance","type":"number"},"is_favorite":{"default":false,"description":"Favorite status","title":"Is Favorite","type":"boolean"},"label_ids":{"description":"Label IDs","items":{"type":"string"},"title":"Label Ids","type":"array"},"metadata":{"additionalProperties":true,"description":"Additional metadata","title":"Metadata","type":"object"},"rating":{"description":"Rating 1-5","title":"Rating","type":"integer"},"source":{"description":"Memory source","title":"Source","type":"string"},"source_thread":{"anyOf":[{"$ref":"#/components/schemas/SourceThreadInfo"},{"type":"null"}],"description":"Source thread info"},"space_id":{"default":"default","description":"Isolation space for this memory","title":"Space Id","type":"string"},"time":{"description":"Formatted time string","title":"Time","type":"string"},"title":{"description":"Memory title","title":"Title","type":"string"},"unit_type":{"default":"fact","description":"Memory unit type","title":"Unit Type","type":"string"}},"required":["id","title","content","source","time","importance","rating"],"title":"MemoryPublic","type":"object"},"MemoryReindexRequest":{"properties":{"memory_ids":{"description":"Specific Memory IDs to refresh. When omitted, only rows carrying the\nauthoritative `reindex_needed` flag are repaired.","items":{"type":"string"},"type":["array","null"]}},"type":"object"},"MemoryReindexSample":{"properties":{"id":{"type":"string"},"last_reindexed_at":{"type":["string","null"]},"title":{"type":"string"},"updated_at":{"type":["string","null"]}},"required":["id","title"],"type":"object"},"MemoryRelationCreateRequest":{"properties":{"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"},"author_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author Id"},"bidirectional":{"default":false,"title":"Bidirectional","type":"boolean"},"confidence":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}],"default":1,"title":"Confidence"},"properties":{"additionalProperties":true,"title":"Properties","type":"object"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"},"relation_type":{"minLength":1,"title":"Relation Type","type":"string"},"reviewed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Reviewed"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"api","title":"Source"},"source_app":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source App"},"space_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Space Id"},"status":{"default":"active","enum":["active","suggested","dismissed"],"title":"Status","type":"string"},"strength":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}],"default":1,"title":"Strength"},"target_memory_id":{"minLength":1,"title":"Target Memory Id","type":"string"}},"required":["target_memory_id","relation_type"],"title":"MemoryRelationCreateRequest","type":"object"},"MemoryRelationListResponse":{"properties":{"memory_id":{"title":"Memory Id","type":"string"},"relations":{"items":{"$ref":"#/components/schemas/MemoryRelationPublic"},"title":"Relations","type":"array"},"total":{"title":"Total","type":"integer"}},"required":["memory_id","relations","total"],"title":"MemoryRelationListResponse","type":"object"},"MemoryRelationPublic":{"properties":{"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"},"author_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author Id"},"bidirectional":{"default":false,"title":"Bidirectional","type":"boolean"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence"},"created_at":{"title":"Created At"},"direction":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Direction"},"id":{"title":"Id","type":"string"},"properties":{"additionalProperties":true,"title":"Properties","type":"object"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"},"relation_type":{"title":"Relation Type","type":"string"},"reviewed":{"default":true,"title":"Reviewed","type":"boolean"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"source_app":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source App"},"source_memory_id":{"title":"Source Memory Id","type":"string"},"source_space_id":{"title":"Source Space Id","type":"string"},"source_title":{"default":"","title":"Source Title","type":"string"},"status":{"default":"active","title":"Status","type":"string"},"strength":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Strength"},"target_memory_id":{"title":"Target Memory Id","type":"string"},"target_space_id":{"title":"Target Space Id","type":"string"},"target_title":{"default":"","title":"Target Title","type":"string"},"updated_at":{"title":"Updated At"}},"required":["id","source_memory_id","source_space_id","target_memory_id","target_space_id","relation_type"],"title":"MemoryRelationPublic","type":"object"},"MemoryRelationSuggestRequest":{"properties":{"known_relation_types":{"items":{"type":"string"},"title":"Known Relation Types","type":"array"},"preferred_language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Preferred Language"},"target_memory_id":{"minLength":1,"title":"Target Memory Id","type":"string"}},"required":["target_memory_id"],"title":"MemoryRelationSuggestRequest","type":"object"},"MemoryRelationSuggestionPublic":{"properties":{"bidirectional":{"default":false,"title":"Bidirectional","type":"boolean"},"confidence":{"default":0,"title":"Confidence","type":"number"},"display_label":{"default":"","title":"Display Label","type":"string"},"reason":{"default":"","title":"Reason","type":"string"},"relation_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Relation Type"},"should_link":{"title":"Should Link","type":"boolean"}},"required":["should_link"],"title":"MemoryRelationSuggestionPublic","type":"object"},"MemoryRelationUpdateRequest":{"properties":{"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"},"author_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author Id"},"bidirectional":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Bidirectional"},"confidence":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}],"title":"Confidence"},"properties":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Properties"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"},"relation_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Relation Type"},"reviewed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Reviewed"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"source_app":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source App"},"status":{"anyOf":[{"enum":["active","suggested","dismissed","deleted"],"type":"string"},{"type":"null"}],"title":"Status"},"strength":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}],"title":"Strength"}},"title":"MemoryRelationUpdateRequest","type":"object"},"MemorySearchRequest":{"description":"Request for memory search.","properties":{"event_date_from":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by when the EVENT occurred (not when recorded). Format: YYYY, YYYY-MM, or YYYY-MM-DD","examples":["2020","2023-06","2024-01-15"],"title":"Event Date From"},"event_date_to":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Upper bound for event date. Format: YYYY, YYYY-MM, or YYYY-MM-DD","examples":["2024","2023-12","2024-12-31"],"title":"Event Date To"},"filter_labels":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Filter by label names","title":"Filter Labels"},"include_entities":{"default":true,"description":"Include related entities","title":"Include Entities","type":"boolean"},"limit":{"default":10,"description":"Maximum results","maximum":100,"minimum":1,"title":"Limit","type":"integer"},"metadata_filters":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Filter by memory metadata key=value. Repeat for AND filters; repeat the same key for OR values.","examples":[["customer=acme","purpose=contract-review"]],"title":"Metadata Filters"},"mode":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Search mode: 'deep' (default) or 'fast' (BM25+vector only)","title":"Mode"},"query":{"description":"Search query","title":"Query","type":"string"},"recorded_date_from":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by when the memory was RECORDED into the system. Format: YYYY-MM-DD","examples":["2024-11-20","2024-11-01"],"title":"Recorded Date From"},"recorded_date_to":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Upper bound for recording date. Format: YYYY-MM-DD","examples":["2024-11-24"],"title":"Recorded Date To"},"space_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Isolation space to search within. Defaults to the canonical default space on user-facing APIs.","examples":["default","work"],"title":"Space Id"},"temporal_context":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by temporal context: 'past', 'present', 'future', or 'timeless'","examples":["past","present","future","timeless"],"title":"Temporal Context"},"unit_type":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by memory unit type: fact | preference | decision | plan | procedure | learning | context | event","examples":["procedure","decision"],"title":"Unit Type"}},"required":["query"],"title":"MemorySearchRequest","type":"object"},"MemorySearchResult":{"description":"Result from memory search operations.","properties":{"evolves_context":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"description":"EVOLVES chain context: version history and relationships","title":"Evolves Context"},"memory":{"anyOf":[{"$ref":"#/components/schemas/MemoryNode"},{"type":"null"}]},"related_entities":{"items":{"$ref":"#/components/schemas/EntityNode"},"title":"Related Entities","type":"array"},"related_memory_links":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"description":"Active explicit Memory Links around this result","title":"Related Memory Links"},"relevance_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Why this memory is relevant","title":"Relevance Reason"},"similarity_score":{"description":"Semantic similarity score","maximum":1,"minimum":0,"title":"Similarity Score","type":"number"}},"required":["similarity_score"],"title":"MemorySearchResult","type":"object"},"MemorySpaceDeleteConflictResponse":{"properties":{"canPurgeWorkingMemory":{"default":false,"title":"Canpurgeworkingmemory","type":"boolean"},"message":{"title":"Message","type":"string"},"reason":{"enum":["primary_records","working_memory"],"title":"Reason","type":"string"},"spaceId":{"title":"Spaceid","type":"string"},"type":{"const":"space_delete_blocked","default":"space_delete_blocked","title":"Type","type":"string"},"usage":{"$ref":"#/components/schemas/MemorySpaceUsageResponse"}},"required":["spaceId","reason","message"],"title":"MemorySpaceDeleteConflictResponse","type":"object"},"MemorySpacePayload":{"properties":{"defaultRetrievalMode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Defaultretrievalmode"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"icon":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Icon"},"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instructions"},"key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Key"},"name":{"title":"Name","type":"string"},"sharedSpaceIds":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Sharedspaceids"}},"required":["name"],"title":"MemorySpacePayload","type":"object"},"MemorySpaceResponse":{"properties":{"aliases":{"items":{"type":"string"},"title":"Aliases","type":"array"},"defaultRetrievalMode":{"default":"strict","title":"Defaultretrievalmode","type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"hasProfile":{"default":true,"title":"Hasprofile","type":"boolean"},"icon":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Icon"},"id":{"title":"Id","type":"string"},"instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instructions"},"key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Key"},"name":{"title":"Name","type":"string"},"observed":{"default":false,"title":"Observed","type":"boolean"},"sharedSpaceIds":{"items":{"type":"string"},"title":"Sharedspaceids","type":"array"},"usage":{"$ref":"#/components/schemas/MemorySpaceUsageResponse"}},"required":["id","name"],"title":"MemorySpaceResponse","type":"object"},"MemorySpaceSettingsResponse":{"properties":{"enabled":{"default":false,"title":"Enabled","type":"boolean"},"spaces":{"items":{"$ref":"#/components/schemas/MemorySpaceResponse"},"title":"Spaces","type":"array"}},"title":"MemorySpaceSettingsResponse","type":"object"},"MemorySpaceSettingsUpdate":{"properties":{"enabled":{"title":"Enabled","type":"boolean"}},"required":["enabled"],"title":"MemorySpaceSettingsUpdate","type":"object"},"MemorySpaceUpdatePayload":{"properties":{"defaultRetrievalMode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Defaultretrievalmode"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"icon":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Icon"},"instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instructions"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"sharedSpaceIds":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Sharedspaceids"}},"title":"MemorySpaceUpdatePayload","type":"object"},"MemorySpaceUsageResponse":{"properties":{"hasWorkingMemory":{"default":false,"title":"Hasworkingmemory","type":"boolean"},"memories":{"default":0,"title":"Memories","type":"integer"},"sources":{"default":0,"title":"Sources","type":"integer"},"threads":{"default":0,"title":"Threads","type":"integer"}},"title":"MemorySpaceUsageResponse","type":"object"},"MemoryStateRequest":{"description":"Set an explicit lifecycle state for a memory.","properties":{"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"},"space_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional isolation space guard; the memory must belong to it.","title":"Space Id"}},"title":"MemoryStateRequest","type":"object"},"MemorySummary":{"description":"Summary of a memory for relationship responses.","properties":{"content":{"default":"","description":"Memory content (truncated)","title":"Content","type":"string"},"id":{"description":"Memory ID","title":"Id","type":"string"},"title":{"default":"","description":"Memory title","title":"Title","type":"string"}},"required":["id"],"title":"MemorySummary","type":"object"},"MergeIntoRequest":{"properties":{"into_skill_id":{"description":"The active skill that absorbs this one's evidence and remains","title":"Into Skill Id","type":"string"}},"required":["into_skill_id"],"title":"MergeIntoRequest","type":"object"},"MessageCreateRequest":{"description":"Request to create a message within a thread.","properties":{"content":{"description":"Message content","title":"Content","type":"string"},"metadata":{"additionalProperties":true,"title":"Metadata","type":"object"},"role":{"description":"Message role (user, assistant, system)","title":"Role","type":"string"},"timestamp":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"Message timestamp","title":"Timestamp"}},"required":["content","role"],"title":"MessageCreateRequest","type":"object"},"MessageNode":{"description":"Message node representing a single message in a conversation.","properties":{"content":{"description":"Message content","title":"Content","type":"string"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"id":{"title":"Id","type":"string"},"metadata":{"additionalProperties":true,"title":"Metadata","type":"object"},"node_type":{"$ref":"#/components/schemas/NodeType","default":"Message"},"order_index":{"description":"Order within thread","title":"Order Index","type":"integer"},"role":{"description":"Message role (user, assistant, system)","title":"Role","type":"string"},"timestamp":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"Original message timestamp","title":"Timestamp"},"token_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Approximate token count","title":"Token Count"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"}},"required":["content","role","order_index"],"title":"MessageNode","type":"object"},"MessageResponse":{"additionalProperties":true,"description":"Generic message response.","properties":{"message":{"description":"Response message","title":"Message","type":"string"}},"required":["message"],"title":"MessageResponse","type":"object"},"MissedRunPolicy":{"enum":["skip","run_once"],"type":"string"},"ModelMemoryEntry":{"properties":{"backend":{"default":"none","enum":["none","local","remote"],"title":"Backend","type":"string"},"estimated_mb":{"default":0,"title":"Estimated Mb","type":"integer"},"loaded":{"default":false,"title":"Loaded","type":"boolean"}},"title":"ModelMemoryEntry","type":"object"},"ModelMemoryStatusResponse":{"properties":{"embedding":{"$ref":"#/components/schemas/ModelMemoryEntry","default":{"backend":"none","estimated_mb":0,"loaded":false}},"llm":{"$ref":"#/components/schemas/ModelMemoryEntry","default":{"backend":"none","estimated_mb":0,"loaded":false}}},"title":"ModelMemoryStatusResponse","type":"object"},"ModelPolicy":{"properties":{"max_output_tokens":{"format":"int32","minimum":0,"type":"integer"},"max_tool_calls":{"format":"int32","minimum":0,"type":"integer"},"model":{"type":["string","null"]},"provider":{"type":["string","null"]}},"required":["max_output_tokens","max_tool_calls"],"type":"object"},"ModelUnloadResponse":{"properties":{"message":{"default":"","title":"Message","type":"string"},"model":{"title":"Model","type":"string"},"success":{"title":"Success","type":"boolean"}},"required":["success","model"],"title":"ModelUnloadResponse","type":"object"},"NativeSourceOperation":{"additionalProperties":false,"description":"Explicit scheduled native source-derived Thread operation. Recorded roles and source references do not authenticate humans or establish adoption. The host restores the original scheduled task funding and assesses each exact candidate before publication. Authored intent, inline transcript overrides, conflicting selectors and foreign/unreadable Space are rejected. Omit the field for unchanged deterministic distillation. No caller root, grant, provider or cancellation authority is accepted.","properties":{"assessment":{"enum":["source_support","human_ruling"],"type":"string"},"kind":{"enum":["source_derived"],"type":"string"},"source":{"additionalProperties":false,"properties":{"kind":{"enum":["thread"],"type":"string"},"message_ids":{"items":{"minLength":1,"type":"string"},"maxItems":10000,"minItems":1,"type":"array","uniqueItems":true},"thread_id":{"minLength":1,"type":"string"}},"required":["kind","thread_id","message_ids"],"type":"object"},"version":{"enum":[1],"type":"integer"}},"required":["version","kind","assessment","source"],"type":"object"},"NodeType":{"description":"Enumeration of node types in the graph.","enum":["Thread","Message","Memory","Entity","Label","Community","Source","Skill"],"title":"NodeType","type":"string"},"OccurrenceLease":{"properties":{"last_tool":{"type":["string","null"]},"occurrence_id":{"type":"string"},"runtime_id":{"type":"string"},"started_at":{"type":"string"},"tool_calls_started":{"format":"int32","minimum":0,"type":"integer"}},"required":["occurrence_id","runtime_id","started_at"],"type":"object"},"OccurrenceOutcome":{"properties":{"completed_at":{"type":"string"},"error_code":{"type":["string","null"]},"occurrence_id":{"type":"string"},"scheduled_for":{"type":"string"},"started_at":{"type":"string"},"status":{"$ref":"#/components/schemas/OccurrenceStatus"},"summary":{"type":"string"},"tool_calls":{"format":"int32","minimum":0,"type":"integer"}},"required":["occurrence_id","scheduled_for","status","started_at","completed_at","summary","tool_calls"],"type":"object"},"OccurrenceStatus":{"enum":["queued","running","succeeded","partial","failed","skipped","cancelled"],"type":"string"},"OpenAIEmbeddingData":{"properties":{"embedding":{"$ref":"#/components/schemas/EmbeddingVector"},"index":{"minimum":0,"type":"integer"},"object":{"type":"string"}},"required":["object","index","embedding"],"type":"object"},"OpenAIEmbeddingRequest":{"properties":{"dimensions":{"minimum":0,"type":["integer","null"]},"encoding_format":{"default":"float","type":"string"},"input":{"$ref":"#/components/schemas/EmbeddingInput"},"input_type":{"description":"Nowledge extension: `query` or `document` (default).","type":["string","null"]},"model":{"type":["string","null"]},"user":{"type":["string","null"]}},"required":["model","input"],"type":"object"},"OpenAIEmbeddingResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/OpenAIEmbeddingData"},"type":"array"},"model":{"type":"string"},"object":{"type":"string"},"usage":{"$ref":"#/components/schemas/OpenAIEmbeddingUsage"}},"required":["object","data","model","usage"],"type":"object"},"OpenAIEmbeddingUsage":{"properties":{"prompt_tokens":{"minimum":0,"type":"integer"},"total_tokens":{"minimum":0,"type":"integer"}},"required":["prompt_tokens","total_tokens"],"type":"object"},"OpenAIModelData":{"properties":{"created":{"format":"int64","minimum":0,"type":"integer"},"id":{"type":"string"},"object":{"type":"string"},"owned_by":{"type":"string"},"parent":{"type":["string","null"]},"permission":{"items":{},"type":"array"},"root":{"type":"string"}},"required":["id","object","created","owned_by","permission","root"],"type":"object"},"OpenAIModelListResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/OpenAIModelData"},"type":"array"},"object":{"type":"string"}},"required":["object","data"],"type":"object"},"OptimizeStorageResponse":{"properties":{"after_bytes":{"default":0,"title":"After Bytes","type":"integer"},"before_bytes":{"default":0,"title":"Before Bytes","type":"integer"},"checkpoint_failed":{"description":"Whether the graph database flush did not finish.","title":"Checkpoint Failed","type":"boolean"},"compacted_tables":{"description":"Search tables whose fragments were merged in this run.","items":{"type":"string"},"title":"Compacted Tables","type":"array"},"failed_tables":{"description":"Search tables that did not finish. Table names only.","items":{"type":"string"},"title":"Failed Tables","type":"array"},"fragments_after":{"minimum":0,"title":"Fragments After","type":"integer"},"fragments_before":{"minimum":0,"title":"Fragments Before","type":"integer"},"freed_bytes":{"default":0,"title":"Freed Bytes","type":"integer"},"message":{"default":"","title":"Message","type":"string"},"outcome":{"description":"Overall Optimize result.","enum":["completed","partial","refused"],"title":"Outcome","type":"string"},"reclaim_pending":{"description":"Whether compacted-away files are released after the next restart.","title":"Reclaim Pending","type":"boolean"},"refusal":{"description":"Why Optimize did not start; omitted when the run started.","enum":["shutting_down","rebuild_running","already_running"],"title":"Refusal","type":"string"},"success":{"title":"Success","type":"boolean"}},"required":["success","before_bytes","after_bytes","freed_bytes","message","outcome","compacted_tables","failed_tables","checkpoint_failed","fragments_before","fragments_after","reclaim_pending"],"title":"OptimizeStorageResponse","type":"object"},"OrphanedEntitiesResponse":{"description":"Response for orphaned entities lookup.","properties":{"count":{"title":"Count","type":"integer"},"orphaned_entities":{"items":{"$ref":"#/components/schemas/OrphanedEntityItem"},"title":"Orphaned Entities","type":"array"},"success":{"title":"Success","type":"boolean"}},"required":["success","orphaned_entities","count"],"title":"OrphanedEntitiesResponse","type":"object"},"OrphanedEntityItem":{"description":"Orphaned entity item.","properties":{"entity_id":{"title":"Entity Id","type":"string"},"entity_name":{"title":"Entity Name","type":"string"},"entity_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Type"}},"required":["entity_id","entity_name"],"title":"OrphanedEntityItem","type":"object"},"PaginationInfo":{"additionalProperties":true,"description":"Pagination metadata.","properties":{"has_more":{"description":"Whether more items available","title":"Has More","type":"boolean"},"limit":{"description":"Items per page","title":"Limit","type":"integer"},"offset":{"description":"Offset","title":"Offset","type":"integer"},"total":{"description":"Total items","title":"Total","type":"integer"}},"required":["limit","offset","total","has_more"],"title":"PaginationInfo","type":"object"},"PauseReason":{"enum":["user","permission_changed","credentials_missing","persistent_failure","recovery_required"],"type":"string"},"PersistQuestionRequest":{"properties":{"agent_response":{"maxLength":50000,"title":"Agent Response","type":"string"},"question":{"maxLength":10000,"minLength":1,"title":"Question","type":"string"},"related_memory_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Related Memory Ids"},"source":{"default":"feed","title":"Source","type":"string"},"space_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Memory space associated with this question","title":"Space Id"},"thread_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Thread root event ID for follow-up conversations","title":"Thread Id"},"tool_calls":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Tool Calls"}},"required":["question","agent_response"],"title":"PersistQuestionRequest","type":"object"},"PluginUpdateInfo":{"description":"Plugin update information for health response.","properties":{"available_version":{"title":"Available Version","type":"string"},"id":{"title":"Id","type":"string"},"installed_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Installed Version"},"name":{"title":"Name","type":"string"}},"required":["id","name","available_version"],"title":"PluginUpdateInfo","type":"object"},"PreviewScheduleRequest":{"properties":{"after":{"type":["string","null"]},"count":{"minimum":0,"type":"integer"},"local_time":{"$ref":"#/components/schemas/WallClockTime"},"recurrence":{"$ref":"#/components/schemas/Recurrence"},"timezone":{"type":"string"}},"required":["recurrence","local_time","timezone"],"type":"object"},"ReconcileTailResponse":{"additionalProperties":true,"description":"Response from safely replacing a thread tail.","properties":{"messages_added":{"description":"Number of replacement messages added","title":"Messages Added","type":"integer"},"messages_replaced":{"description":"Number of tail messages removed","title":"Messages Replaced","type":"integer"},"success":{"description":"Whether reconciliation succeeded","title":"Success","type":"boolean"},"thread_id":{"description":"Thread ID","title":"Thread Id","type":"string"},"total_messages":{"description":"Total messages in thread after reconciliation","title":"Total Messages","type":"integer"}},"required":["success","thread_id","messages_replaced","messages_added","total_messages"],"title":"ReconcileTailResponse","type":"object"},"Recurrence":{"properties":{"day_of_month":{"description":"Monthly day 1..31. Short months clamp to their last calendar day.","format":"int32","minimum":0,"type":["integer","null"]},"kind":{"$ref":"#/components/schemas/RecurrenceKind"},"weekdays":{"description":"ISO weekday numbers, Monday=1 through Sunday=7. `Weekly` accepts one;\n`SelectedWeekdays` accepts one or more.","items":{"format":"int32","minimum":0,"type":"integer"},"type":"array"}},"required":["kind"],"type":"object"},"RecurrenceKind":{"enum":["daily","weekdays","selected_weekdays","weekly","monthly"],"type":"string"},"RecurringTask":{"properties":{"capability_fingerprint":{"type":"string"},"capability_grant":{"$ref":"#/components/schemas/CapabilityGrant"},"connector_bindings":{"items":{"$ref":"#/components/schemas/ConnectorBinding"},"type":"array"},"consecutive_failures":{"format":"int32","minimum":0,"type":"integer"},"contract_version":{"format":"int32","minimum":0,"type":"integer"},"created_at":{"type":"string"},"enabled_plugin_ids":{"description":"Stable plugin ids used by the native tool gate. Contains no connector\nconfiguration or credentials.","items":{"type":"string"},"type":"array"},"id":{"type":"string"},"in_flight":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/OccurrenceLease","description":"Durable execution lease for the current occurrence. A new process may\nretry an interrupted occurrence only while `tool_calls_started == 0`.\nOnce a tool has started, the external side effect is uncertain and the\ntask must pause for review instead of replaying it."}]},"instruction":{"type":"string"},"instruction_revision":{"format":"int64","minimum":0,"type":"integer"},"last_outcome":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/OccurrenceOutcome"}]},"last_settled_at":{"type":["string","null"]},"local_time":{"$ref":"#/components/schemas/WallClockTime"},"missed_run_policy":{"$ref":"#/components/schemas/MissedRunPolicy"},"model_policy":{"$ref":"#/components/schemas/ModelPolicy"},"next_run_at":{"type":"string"},"pause_reason":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/PauseReason"}]},"project_dir":{"type":"string"},"recurrence":{"$ref":"#/components/schemas/Recurrence"},"required_grant_revision":{"description":"Minimum grant revision required before this task may become active.\nPermission-sensitive edits advance this value while preserving the old\ngrant for a human-readable diff.","format":"int64","minimum":0,"type":"integer"},"space_id":{"type":["string","null"]},"status":{"$ref":"#/components/schemas/ScheduleStatus"},"timezone":{"type":"string"},"title":{"type":"string"},"updated_at":{"type":"string"}},"required":["contract_version","id","title","status","instruction","instruction_revision","required_grant_revision","recurrence","local_time","timezone","missed_run_policy","model_policy","capability_grant","capability_fingerprint","project_dir","next_run_at","created_at","updated_at"],"type":"object"},"ReindexDetail":{"properties":{"embedding_dimension":{"minimum":0,"type":["integer","null"]},"error":{"type":["string","null"]},"memory_id":{"type":"string"},"reason":{"type":["string","null"]},"status":{"type":"string"}},"required":["memory_id","status"],"type":"object"},"ReindexResponse":{"properties":{"details":{"items":{"$ref":"#/components/schemas/ReindexDetail"},"type":"array"},"error":{"type":["string","null"]},"failed":{"minimum":0,"type":"integer"},"processed":{"minimum":0,"type":"integer"},"success":{"description":"Whether the batch request completed. Individual row failures are\nreported through `failed` and `details`, matching the legacy API.","type":"boolean"}},"required":["success","processed","failed","details"],"type":"object"},"ReindexStatusResponse":{"properties":{"all_memory_ids":{"items":{"type":"string"},"type":["array","null"]},"count_needing_reindex":{"format":"int64","type":"integer"},"has_memories_needing_reindex":{"type":"boolean"},"sample_memories":{"items":{"$ref":"#/components/schemas/MemoryReindexSample"},"type":"array"}},"required":["count_needing_reindex","sample_memories","has_memories_needing_reindex"],"type":"object"},"RelationshipInfo":{"description":"Information about a relationship between entities.","properties":{"confidence":{"description":"Confidence score of the relationship","title":"Confidence","type":"number"},"strength":{"description":"Strength of the relationship","title":"Strength","type":"number"},"type":{"description":"Relationship type (e.g., RELATES_TO)","title":"Type","type":"string"}},"required":["type","confidence","strength"],"title":"RelationshipInfo","type":"object"},"ResolvedResourceResponse":{"properties":{"body":{"description":"Rendered resource body. Some large resources (for example Threads)\nintentionally return a compact handoff card with progressive read\ninstructions rather than embedding the full payload.","type":"string"},"canonical_uri":{"description":"Normalized, safely percent-encoded Nowledge URI.","type":"string"},"frontmatter":{"description":"Structured metadata emitted by the underlying KFS renderer."},"kind":{"description":"Stable resource kind (`fs`, `memory`, `thread`, `working-memory`, or `context-bundle`).","type":"string"},"mime_type":{"description":"MIME type for the textual representation.","type":"string"},"path":{"description":"Backend path used by this resolver. Compound aliases may use a synthetic path\nor a KFS directory when the compact resource card points at subresources.","type":"string"},"requested_uri":{"description":"URI exactly as supplied by the caller.","type":"string"}},"required":["requested_uri","canonical_uri","kind","path","mime_type","body","frontmatter"],"type":"object"},"RestoreMergedSkillResponse":{"properties":{"id":{"type":"string"},"stage":{"type":"string"},"unmerged_from":{"type":"string"}},"required":["id","stage","unmerged_from"],"type":"object"},"RulesResponse":{"properties":{"rules":{"items":{"$ref":"#/components/schemas/GuidanceRuleResponse"},"title":"Rules","type":"array"}},"title":"RulesResponse","type":"object"},"SaveSessionRequest":{"properties":{"messages":{"default":[],"items":{"additionalProperties":true,"type":"object"},"maxItems":50,"title":"Messages","type":"array"}},"title":"SaveSessionRequest","type":"object"},"ScheduleDeleteResponse":{"properties":{"ok":{"type":"boolean"}},"required":["ok"],"type":"object"},"ScheduleErrorResponse":{"properties":{"detail":{"type":"string"},"error_code":{"type":["string","null"]}},"required":["detail"],"type":"object"},"ScheduleListResponse":{"properties":{"knowledge_capabilities":{"items":{"$ref":"#/components/schemas/ToolCapability"},"type":"array"},"schedules":{"items":{"$ref":"#/components/schemas/RecurringTask"},"type":"array"}},"required":["schedules","knowledge_capabilities"],"type":"object"},"SchedulePreviewResponse":{"properties":{"occurrences":{"items":{"type":"string"},"type":"array"}},"required":["occurrences"],"type":"object"},"ScheduleResponse":{"properties":{"schedule":{"$ref":"#/components/schemas/RecurringTask"}},"required":["schedule"],"type":"object"},"ScheduleRunsResponse":{"properties":{"runs":{"items":{"$ref":"#/components/schemas/OccurrenceOutcome"},"type":"array"}},"required":["runs"],"type":"object"},"ScheduleStatus":{"enum":["draft","active","paused","deleted"],"type":"string"},"SearchIndexReindexResponse":{"description":"Response for search index reindex operation.","properties":{"communities":{"default":0,"description":"Number of communities indexed","title":"Communities","type":"integer"},"entities":{"default":0,"description":"Number of entities indexed","title":"Entities","type":"integer"},"errors":{"description":"Any errors encountered","items":{"type":"string"},"title":"Errors","type":"array"},"memories":{"default":0,"description":"Number of memories indexed","title":"Memories","type":"integer"},"message":{"default":"","description":"Status message","title":"Message","type":"string"},"messages":{"default":0,"description":"Number of messages indexed","title":"Messages","type":"integer"},"restart_recommended":{"default":false,"description":"Whether desktop clients should restart the local backend after a successful rebuild to release native allocator high-water memory","title":"Restart Recommended","type":"boolean"},"source_chunks":{"default":0,"description":"Number of Library source chunks indexed","title":"Source Chunks","type":"integer"},"sources":{"default":0,"description":"Number of Library sources indexed","title":"Sources","type":"integer"},"success":{"title":"Success","type":"boolean"}},"required":["success"],"title":"SearchIndexReindexResponse","type":"object"},"SearchIndexReindexRuntimeStatusResponse":{"description":"Current or last-known full search rebuild state.","properties":{"active":{"title":"Active","type":"boolean"},"errors":{"description":"Last known rebuild errors","items":{"type":"string"},"title":"Errors","type":"array"},"finished_at":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"When the last rebuild finished (UTC)","title":"Finished At"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Current rebuild message","title":"Message"},"progress":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Best-known rebuild percentage","title":"Progress"},"run_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Current rebuild run identifier","title":"Run Id"},"stage":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Current rebuild stage","title":"Stage"},"started_at":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"When the active rebuild started (UTC)","title":"Started At"},"stats":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"description":"Last known rebuild counters","title":"Stats"},"success":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Whether the last rebuild ended successfully","title":"Success"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Last status update time (UTC)","title":"Updated At"}},"required":["active"],"title":"SearchIndexReindexRuntimeStatusResponse","type":"object"},"SearchIndexStatusResponse":{"description":"Response for search index status.","properties":{"available":{"description":"Whether search index service is available","title":"Available","type":"boolean"},"embedding_mode":{"default":"local","description":"local or remote","title":"Embedding Mode","type":"string"},"message":{"description":"Status message","title":"Message","type":"string"},"model_cached":{"description":"Whether a local search embedding model is cached","title":"Model Cached","type":"boolean"},"model_name":{"default":"","description":"Model being used (platform-specific)","title":"Model Name","type":"string"},"remote_model":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Configured remote embedding model, if any","title":"Remote Model"},"remote_provider":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Configured remote provider, if any","title":"Remote Provider"}},"required":["available","model_cached","message"],"title":"SearchIndexStatusResponse","type":"object"},"SearchMetadata":{"additionalProperties":true,"description":"Metadata specific to search operations.","properties":{"filters_applied":{"$ref":"#/components/schemas/FiltersApplied","description":"Filters applied to search"},"graph_stats":{"$ref":"#/components/schemas/GraphStatsSummary","description":"Graph statistics"},"search_method":{"description":"Method used for search","title":"Search Method","type":"string"},"search_results":{"$ref":"#/components/schemas/SearchResultsSummary","description":"Summary of search results"},"unified_query":{"default":true,"description":"Whether unified query was used","title":"Unified Query","type":"boolean"},"visualization_ready":{"default":true,"description":"Whether results are ready for visualization","title":"Visualization Ready","type":"boolean"}},"required":["search_method"],"title":"SearchMetadata","type":"object"},"SearchResultsSummary":{"additionalProperties":true,"description":"Summary of search results counts.","properties":{"communities_found":{"default":0,"description":"Number of communities found","title":"Communities Found","type":"integer"},"entities_found":{"default":0,"description":"Number of entities found","title":"Entities Found","type":"integer"},"memories_found":{"default":0,"description":"Number of memories found","title":"Memories Found","type":"integer"},"threads_found":{"default":0,"description":"Number of threads found","title":"Threads Found","type":"integer"}},"title":"SearchResultsSummary","type":"object"},"SessionSaveRequest":{"description":"Request model for saving a coding session.","properties":{"client":{"description":"Client type: 'claude-code', 'codex', or 'gemini-cli'","pattern":"^(claude-code|codex|gemini-cli)$","title":"Client","type":"string"},"persist_mode":{"default":"current","description":"Mode: 'current' (most recent session) or 'all' (all sessions)","pattern":"^(current|all)$","title":"Persist Mode","type":"string"},"project_path":{"description":"Project working directory path","title":"Project Path","type":"string"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Specific session ID (optional)","title":"Session Id"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Brief session summary (1-2 sentences)","title":"Summary"},"truncate_large_content":{"default":false,"description":"Truncate large tool results >10KB","title":"Truncate Large Content","type":"boolean"}},"required":["client","project_path"],"title":"SessionSaveRequest","type":"object"},"SessionSaveResponse":{"description":"Response from session save operation.","properties":{"client":{"description":"Client type","title":"Client","type":"string"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Error message if failed","title":"Error"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Hint for resolution","title":"Hint"},"persist_mode":{"description":"Persist mode used","title":"Persist Mode","type":"string"},"project_path":{"description":"Project path","title":"Project Path","type":"string"},"results":{"description":"Results for each session","items":{"$ref":"#/components/schemas/SessionSaveResultItem"},"title":"Results","type":"array"},"status":{"description":"Status: 'success' or 'error'","title":"Status","type":"string"}},"required":["status","client","project_path","persist_mode"],"title":"SessionSaveResponse","type":"object"},"SessionSaveResultItem":{"description":"Result of persisting a single session.","properties":{"action":{"description":"Action taken: 'created' or 'appended'","title":"Action","type":"string"},"file":{"default":"","description":"Source file name","title":"File","type":"string"},"message_count":{"description":"Total messages in thread","title":"Message Count","type":"integer"},"messages_added":{"default":0,"description":"New messages added (append only)","title":"Messages Added","type":"integer"},"session_id":{"description":"Session ID","title":"Session Id","type":"string"},"thread_id":{"description":"Thread ID","title":"Thread Id","type":"string"}},"required":["action","session_id","thread_id","message_count"],"title":"SessionSaveResultItem","type":"object"},"SettingsBackupArtifact":{"properties":{"exported_at":{"description":"RFC 3339 export time.","type":"string"},"format":{"description":"Stable artifact discriminator. Currently `nowledge-mem-settings`.","type":"string"},"omitted":{"description":"Secret and device-local sections deliberately excluded from this file.","items":{"type":"string"},"type":"array"},"providers":{"description":"Credential-free provider definitions and purpose routing."},"settings":{"description":"Whitelisted portable app preferences."},"version":{"description":"Settings artifact schema version, independent from the app version.","format":"int32","minimum":0,"type":"integer"}},"required":["format","version","exported_at","settings","providers","omitted"],"type":"object"},"SettingsRestorePreview":{"properties":{"credentials_included":{"type":"boolean"},"provider_count":{"minimum":0,"type":"integer"},"sections":{"items":{"type":"string"},"type":"array"},"valid":{"type":"boolean"},"version":{"format":"int32","minimum":0,"type":"integer"},"warnings":{"items":{"type":"string"},"type":"array"}},"required":["valid","version","sections","provider_count","credentials_included","warnings"],"type":"object"},"SettingsRestoreResponse":{"properties":{"credentials_restored":{"type":"boolean"},"provider_count":{"minimum":0,"type":"integer"},"restored":{"type":"boolean"},"sections":{"items":{"type":"string"},"type":"array"},"warnings":{"items":{"type":"string"},"type":"array"}},"required":["restored","sections","provider_count","credentials_restored","warnings"],"type":"object"},"SkillBuilderChatContext":{"description":"What's on the user's Skills screen, sent every turn (stateless copilot).","properties":{"draft_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Draft Name"},"draft_note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Draft Note"},"has_assets":{"default":false,"title":"Has Assets","type":"boolean"},"has_duplicate":{"default":false,"title":"Has Duplicate","type":"boolean"},"has_pending":{"default":false,"title":"Has Pending","type":"boolean"},"skill_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Skill Description"},"skill_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Skill Name"},"skill_stage":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Skill Stage"},"view":{"default":"overview","title":"View","type":"string"}},"title":"SkillBuilderChatContext","type":"object"},"SkillBuilderChatRequest":{"description":"A copilot turn: the user's message plus the current screen context.","properties":{"context":{"$ref":"#/components/schemas/SkillBuilderChatContext"},"history":{"items":{"additionalProperties":{"type":"string"},"type":"object"},"title":"History","type":"array"},"message":{"description":"The user's latest message","title":"Message","type":"string"},"space_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Space Id"}},"required":["message"],"title":"SkillBuilderChatRequest","type":"object"},"SkillBuilderProposeRequest":{"description":"A turn of the floating builder assistant.","properties":{"deep":{"default":false,"description":"Deep Create: surf the graph for the fuller pattern before draft","title":"Deep","type":"boolean"},"goal":{"description":"The user's intent / latest message","title":"Goal","type":"string"},"history":{"description":"Prior {role, content} turns for context","items":{"additionalProperties":{"type":"string"},"type":"object"},"title":"History","type":"array"},"space_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Space Id"}},"required":["goal"],"title":"SkillBuilderProposeRequest","type":"object"},"SkillEditBodyRequest":{"description":"The user authored a new body for a skill directly (power-user edit).","properties":{"body":{"description":"The full procedure markdown (frontmatter optional)","title":"Body","type":"string"},"rationale":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional one-line note about what they changed","title":"Rationale"},"skill_id":{"description":"The skill being edited","title":"Skill Id","type":"string"}},"required":["skill_id","body"],"title":"SkillEditBodyRequest","type":"object"},"SkillEditFileRequest":{"properties":{"content":{"description":"The full new text of that file","title":"Content","type":"string"},"path":{"description":"Bundle-relative path, e.g. references/api.md","title":"Path","type":"string"}},"required":["path","content"],"title":"SkillEditFileRequest","type":"object"},"SkillImportRequest":{"description":"Enroll the user's own skill into managed scope (the third birth).\n\nEither paste a single-file SKILL.md (``skill_md``) or point at a hand-written\nskill FOLDER on disk (``path``, from the discovery scan) to bring a multi-file\nskill in whole.","properties":{"files":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"description":"A folder's files as {relpath: base64}, read by the client. Content-based (no disk path), so it works in every client mode.","title":"Files"},"force":{"default":false,"description":"Import even when it looks like an existing active skill","title":"Force","type":"boolean"},"path":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Absolute path to a skill folder (the one with SKILL.md)","title":"Path"},"skill_md":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A full agentskills.io SKILL.md (with frontmatter)","title":"Skill Md"},"take_ownership":{"default":true,"description":"For a folder import: move the hand-written original aside when the skill is turned on (reversible), so a host shows only Mem's copy","title":"Take Ownership","type":"boolean"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A public code-host link (GitHub/GitLab/gist) to a skill; the agent resolves it and the bytes are fetched server-side","title":"Url"}},"title":"SkillImportRequest","type":"object"},"SkillOutcomeRequest":{"properties":{"deviations":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"What you changed","title":"Deviations"},"failure":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Why it failed","title":"Failure"},"missing":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A step the skill lacked","title":"Missing"},"outcome":{"description":"completed | completed_with_deviation | failed | abandoned","title":"Outcome","type":"string"},"skill_version":{"description":"The version the agent used","minimum":1,"title":"Skill Version","type":"integer"},"source":{"default":"agent","description":"agent (Tier-2) | user (Tier-3, from the UI)","title":"Source","type":"string"}},"required":["skill_version","outcome"],"title":"SkillOutcomeRequest","type":"object"},"SkillRefineRequest":{"description":"Ask the assistant to propose a sharper version of a compiled skill.","properties":{"instruction":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional user guidance for the revision","title":"Instruction"},"skill_id":{"description":"A compiled skill to re-version","title":"Skill Id","type":"string"}},"required":["skill_id"],"title":"SkillRefineRequest","type":"object"},"SourceContentResponse":{"description":"Parsed content for preview.","properties":{"content":{"title":"Content","type":"string"},"content_type":{"default":"markdown","title":"Content Type","type":"string"},"has_more":{"default":false,"title":"Has More","type":"boolean"},"offset":{"default":0,"title":"Offset","type":"integer"},"original_name":{"title":"Original Name","type":"string"},"returned_length":{"default":0,"title":"Returned Length","type":"integer"},"source_id":{"title":"Source Id","type":"string"},"total_length":{"default":0,"title":"Total Length","type":"integer"}},"required":["source_id","original_name","content"],"title":"SourceContentResponse","type":"object"},"SourceDetailResponse":{"description":"Source detail with relationships.","properties":{"memories":{"items":{"additionalProperties":true,"type":"object"},"title":"Memories","type":"array"},"revisions":{"items":{"additionalProperties":true,"type":"object"},"title":"Revisions","type":"array"},"source":{"$ref":"#/components/schemas/SourceResponse"}},"required":["source"],"title":"SourceDetailResponse","type":"object"},"SourceListResponse":{"description":"Paginated list of sources.","properties":{"sources":{"items":{"$ref":"#/components/schemas/SourceResponse"},"title":"Sources","type":"array"},"total":{"title":"Total","type":"integer"}},"required":["sources","total"],"title":"SourceListResponse","type":"object"},"SourceProcessingMode":{"enum":["complete","interactive"],"type":"string"},"SourceResponse":{"description":"Source node as returned by the API.","properties":{"chunk_count":{"default":0,"title":"Chunk Count","type":"integer"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"},"file_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Path"},"id":{"title":"Id","type":"string"},"label_ids":{"description":"Label IDs assigned to this source","items":{"type":"string"},"title":"Label Ids","type":"array"},"lifecycle_state":{"default":"ingested","title":"Lifecycle State","type":"string"},"memory_count":{"default":0,"title":"Memory Count","type":"integer"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"},"mime_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mime Type"},"original_name":{"title":"Original Name","type":"string"},"parsed_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parsed Path"},"section_tree":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Section Tree"},"sha256":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sha256"},"size_bytes":{"default":0,"title":"Size Bytes","type":"integer"},"source_type":{"title":"Source Type","type":"string"},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Url"},"space_id":{"default":"default","title":"Space Id","type":"string"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"},"version":{"default":1,"title":"Version","type":"integer"}},"required":["id","source_type","original_name"],"title":"SourceResponse","type":"object"},"SourceSearchResponse":{"description":"Search results for sources.","properties":{"results":{"items":{"additionalProperties":true,"type":"object"},"title":"Results","type":"array"},"total":{"title":"Total","type":"integer"}},"required":["results","total"],"title":"SourceSearchResponse","type":"object"},"SourceThreadInfo":{"additionalProperties":true,"description":"Source thread information.","properties":{"id":{"description":"Thread ID","title":"Id","type":"string"},"space_id":{"default":"default","description":"Isolation space for the source thread","title":"Space Id","type":"string"},"title":{"description":"Thread title","title":"Title","type":"string"}},"required":["id","title"],"title":"SourceThreadInfo","type":"object"},"SpaceMergeEntityCounts":{"properties":{"memories":{"minimum":0,"type":"integer"},"sources":{"minimum":0,"type":"integer"},"threads":{"minimum":0,"type":"integer"}},"required":["memories","threads","sources"],"title":"SpaceMergeEntityCounts","type":"object"},"SpaceMergePlan":{"properties":{"canMerge":{"type":"boolean"},"conflicts":{"items":{"additionalProperties":true,"type":"object"},"type":"array"},"counts":{"$ref":"#/components/schemas/SpaceMergeEntityCounts"},"preservesSourceAliases":{"type":"boolean"},"source":{"additionalProperties":true,"type":"object"},"target":{"additionalProperties":true,"type":"object"},"workingMemory":{"additionalProperties":true,"type":"object"}},"required":["source","target","counts","workingMemory","conflicts","canMerge","preservesSourceAliases"],"title":"SpaceMergePlan","type":"object"},"SpaceMergeRequest":{"properties":{"targetSpaceId":{"description":"Target Space name, alias, or stable ID.","title":"Target Space Id","type":"string"}},"required":["targetSpaceId"],"title":"SpaceMergeRequest","type":"object"},"SpaceMergeResult":{"properties":{"contentUpdated":{"additionalProperties":true,"type":"object"},"counts":{"$ref":"#/components/schemas/SpaceMergeEntityCounts"},"indexUpdated":{"additionalProperties":true,"type":"object"},"merged":{"type":"boolean"},"settings":{"additionalProperties":true,"type":"object"},"sourceSpaceId":{"type":"string"},"targetSpaceId":{"type":"string"},"warnings":{"items":{"type":"string"},"type":"array"},"workingMemoryMoved":{"type":"boolean"}},"required":["merged","sourceSpaceId","targetSpaceId","counts","workingMemoryMoved","warnings","settings"],"title":"SpaceMergeResult","type":"object"},"StorageInfoResponse":{"properties":{"graph_db_bytes":{"default":0,"title":"Graph Db Bytes","type":"integer"},"message_store_bytes":{"default":0,"title":"Message Store Bytes","type":"integer"},"search_index_bytes":{"default":0,"title":"Search Index Bytes","type":"integer"},"total_bytes":{"default":0,"title":"Total Bytes","type":"integer"}},"title":"StorageInfoResponse","type":"object"},"StrengthenInsteadRequest":{"properties":{"target_skill_id":{"description":"The active skill that should absorb this suggestion's evidence","title":"Target Skill Id","type":"string"}},"required":["target_skill_id"],"title":"StrengthenInsteadRequest","type":"object"},"SupersedeMemoryRequest":{"description":"Mark one memory as replaced by a newer memory.","properties":{"newer_memory_id":{"minLength":1,"title":"Newer Memory Id","type":"string"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"},"space_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional isolation space guard; the memory must belong to it.","title":"Space Id"}},"required":["newer_memory_id"],"title":"SupersedeMemoryRequest","type":"object"},"ThreadCoverageResponse":{"additionalProperties":true,"description":"Response for thread coverage report.","properties":{"covered_messages":{"description":"Messages covered by memories","title":"Covered Messages","type":"integer"},"memories":{"description":"Number of memories","title":"Memories","type":"integer"},"metadata":{"additionalProperties":true,"description":"Thread metadata","title":"Metadata","type":"object"},"thread_id":{"description":"Thread ID","title":"Thread Id","type":"string"},"total_messages":{"description":"Total messages","title":"Total Messages","type":"integer"}},"required":["thread_id","total_messages","covered_messages","memories"],"title":"ThreadCoverageResponse","type":"object"},"ThreadCreateRequest":{"description":"Request to create a new thread with messages.","properties":{"import_date":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"Import timestamp","title":"Import Date"},"messages":{"description":"Thread messages","items":{"$ref":"#/components/schemas/MessageCreateRequest"},"title":"Messages","type":"array"},"metadata":{"additionalProperties":true,"title":"Metadata","type":"object"},"participants":{"items":{"type":"string"},"title":"Participants","type":"array"},"project":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Project identifier","title":"Project"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Source system","title":"Source"},"space_id":{"default":"default","description":"Isolation space for this thread","title":"Space Id","type":"string"},"thread_id":{"description":"Human-readable thread identifier","title":"Thread Id","type":"string"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Thread title","title":"Title"},"tool_version":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Tool version","title":"Tool Version"},"workspace":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Workspace path","title":"Workspace"}},"required":["thread_id","messages"],"title":"ThreadCreateRequest","type":"object"},"ThreadCreateResponse":{"description":"Response from thread creation.","properties":{"auto_extraction_performed":{"default":false,"title":"Auto Extraction Performed","type":"boolean"},"auto_generated_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Auto Generated Summary"},"created_relationships":{"default":0,"title":"Created Relationships","type":"integer"},"extracted_memories":{"items":{"$ref":"#/components/schemas/MemoryNode"},"title":"Extracted Memories","type":"array"},"messages":{"items":{"$ref":"#/components/schemas/MessageNode"},"title":"Messages","type":"array"},"thread":{"$ref":"#/components/schemas/ThreadNode"}},"required":["thread","messages"],"title":"ThreadCreateResponse","type":"object"},"ThreadDeletionErrorResponse":{"additionalProperties":true,"description":"App deletion error. Optional progress fields preserve confirmed prior commits. Cloud and admission failures may return only detail. This is not an all-or-nothing rollback guarantee.","properties":{"deleted":{"description":"Whether the parent Thread deletion was confirmed.","type":"boolean"},"deleted_memories":{"description":"Confirmed Memory deletions, including commits before a later failure. Never inferred from the requested cascade flag.","minimum":0,"type":"integer"},"deleted_messages":{"minimum":0,"type":"integer"},"deletion_outcome_uncertain":{"description":"At least one submitted graph outcome could not be confirmed. Counts include only confirmed commits; refresh before retrying.","type":"boolean"},"detail":{"type":"string"},"index_repair_pending":{"description":"Known search projection repair remains pending after the reported graph outcomes.","type":"boolean"},"partial_success":{"description":"Some deletions committed while the overall operation did not fully complete. Absence is not proof of rollback.","type":"boolean"}},"required":["detail"],"type":"object"},"ThreadDistillationBatchPlanRequest":{"description":"Plan the next safe opt-in batch for thread distillation.","properties":{"max_messages_per_run":{"default":2000,"description":"Soft total message budget for one background wave.","maximum":50000,"minimum":100,"title":"Max Messages Per Run","type":"integer"},"max_scan":{"default":500,"description":"Maximum matching threads to inspect for this planning pass.","maximum":2000,"minimum":1,"title":"Max Scan","type":"integer"},"max_threads_per_run":{"default":3,"description":"Maximum threads to schedule in the next background wave.","maximum":20,"minimum":1,"title":"Max Threads Per Run","type":"integer"},"min_messages_for_candidate":{"default":20,"description":"Skip very small threads unless they already need anchor repair.","maximum":500,"minimum":1,"title":"Min Messages For Candidate","type":"integer"},"selection":{"$ref":"#/components/schemas/BulkThreadSelection"}},"required":["selection"],"title":"ThreadDistillationBatchPlanRequest","type":"object"},"ThreadDistillationBatchPlanResponse":{"description":"Read-only bulk distillation plan.","properties":{"message":{"title":"Message","type":"string"},"plan":{"additionalProperties":true,"title":"Plan","type":"object"},"scan_limited":{"title":"Scan Limited","type":"boolean"},"scanned_threads":{"title":"Scanned Threads","type":"integer"},"selection_count":{"title":"Selection Count","type":"integer"},"selection_mode":{"title":"Selection Mode","type":"string"},"source":{"const":"api_thread_batch_plan","default":"api_thread_batch_plan","title":"Source","type":"string"},"source_space_id":{"title":"Source Space Id","type":"string"},"version":{"default":1,"title":"Version","type":"integer"}},"required":["selection_mode","source_space_id","selection_count","scanned_threads","scan_limited","plan","message"],"title":"ThreadDistillationBatchPlanResponse","type":"object"},"ThreadFetchResponse":{"description":"Response for fetching a complete thread.","properties":{"covered_message_ids":{"items":{"type":"string"},"title":"Covered Message Ids","type":"array"},"entities":{"description":"Extracted entities from thread","items":{"type":"string"},"title":"Entities","type":"array"},"identity_is_unique":{"const":true,"description":"Present only after require_unique_identity=true established one readable target in the selected scope. Always true when present; absence does not prove uniqueness.","type":"boolean"},"identity_namespace":{"description":"Requested namespace acknowledgement. Required when the identity_namespace query parameter is supplied; omitted for legacy requests.","enum":["public","storage"],"type":"string"},"messages":{"items":{"$ref":"#/components/schemas/MessageNode"},"title":"Messages","type":"array"},"related_memories":{"items":{"$ref":"#/components/schemas/MemoryNode"},"title":"Related Memories","type":"array"},"thread":{"$ref":"#/components/schemas/ThreadNode"},"total_messages":{"title":"Total Messages","type":"integer"},"total_tokens":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Tokens"}},"required":["thread","messages","total_messages"],"title":"ThreadFetchResponse","type":"object"},"ThreadHistorySyncCompletedRequest":{"description":"Batch-level notification emitted by nmem history sync.","properties":{"client":{"description":"Local agent host, e.g. codex or hermes","title":"Client","type":"string"},"created_count":{"default":0,"description":"Threads created","minimum":0,"title":"Created Count","type":"integer"},"failed_count":{"default":0,"description":"Sessions that failed to sync","minimum":0,"title":"Failed Count","type":"integer"},"imported_count":{"default":0,"description":"Threads created or meaningfully updated","minimum":0,"title":"Imported Count","type":"integer"},"imported_message_count":{"default":0,"description":"Messages newly imported","minimum":0,"title":"Imported Message Count","type":"integer"},"space_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Target memory space","title":"Space Id"},"updated_count":{"default":0,"description":"Threads updated with new messages","minimum":0,"title":"Updated Count","type":"integer"}},"required":["client"],"title":"ThreadHistorySyncCompletedRequest","type":"object"},"ThreadImportItem":{"description":"A single thread to import; provide either `messages` or `markdown_content`\n(`schemas.ThreadImportItem`, threads_module/schemas.py:468-487).","properties":{"expected_message_count":{"description":"Optimistic checkpoint for an already-created Thread. When present, the\nserver must use the bounded checkpoint append path instead of scanning\nthe complete Thread for duplicates.","format":"int64","type":["integer","null"]},"idempotency_key":{"description":"Stable identity for retrying one checkpointed suffix.","type":["string","null"]},"markdown_content":{"type":["string","null"]},"messages":{"items":{"$ref":"#/components/schemas/ThreadImportMessage"},"type":["array","null"]},"metadata":{"additionalProperties":{},"propertyNames":{"type":"string"},"type":["object","null"]},"participants":{"items":{"type":"string"},"type":["array","null"]},"project":{"type":["string","null"]},"source":{"type":["string","null"]},"space_id":{"type":["string","null"]},"thread_id":{"type":["string","null"]},"title":{"type":["string","null"]},"tool_version":{"type":["string","null"]},"workspace":{"type":["string","null"]}},"type":"object"},"ThreadImportMessage":{"description":"A message in an imported thread (`schemas.ThreadImportMessage`,\nthreads_module/schemas.py:455-465).","properties":{"content":{"type":"string"},"metadata":{"additionalProperties":{},"propertyNames":{"type":"string"},"type":["object","null"]},"role":{"type":"string"},"timestamp":{"type":["string","null"]}},"required":["content","role"],"type":"object"},"ThreadImportRequest":{"description":"Import one or more conversation threads (`schemas.ThreadImportRequest`,\nthreads_module/schemas.py:490-525). Single mode sets the flat fields;\nbatch mode uses `threads`.","properties":{"expected_message_count":{"format":"int64","type":["integer","null"]},"idempotency_key":{"type":["string","null"]},"markdown_content":{"type":["string","null"]},"messages":{"items":{"$ref":"#/components/schemas/ThreadImportMessage"},"type":["array","null"]},"metadata":{"additionalProperties":{},"propertyNames":{"type":"string"},"type":["object","null"]},"participants":{"items":{"type":"string"},"type":["array","null"]},"project":{"type":["string","null"]},"source":{"type":["string","null"]},"space_id":{"type":["string","null"]},"thread_id":{"type":["string","null"]},"threads":{"items":{"$ref":"#/components/schemas/ThreadImportItem"},"type":["array","null"]},"title":{"type":["string","null"]},"tool_version":{"type":["string","null"]},"workspace":{"type":["string","null"]}},"type":"object"},"ThreadImportResponse":{"properties":{"auto_review":{},"failed_count":{"format":"int64","type":"integer"},"imported_count":{"format":"int64","type":"integer"},"results":{"items":{"$ref":"#/components/schemas/ThreadImportResultItem"},"type":"array"},"skipped_count":{"format":"int64","type":"integer"},"success":{"type":"boolean"}},"required":["success","imported_count","skipped_count","failed_count","results"],"type":"object"},"ThreadImportResultItem":{"description":"Result of importing a single thread (`schemas.ThreadImportResultItem`,\nthreads_module/schemas.py:528-535).","properties":{"already_existed":{"type":"boolean"},"append_mode":{"type":["string","null"]},"error":{"type":["string","null"]},"error_code":{"type":["string","null"]},"message_count":{"format":"int64","type":"integer"},"messages_added":{"format":"int64","type":"integer"},"success":{"type":"boolean"},"thread_id":{"type":"string"},"title":{"type":["string","null"]}},"required":["success","thread_id","message_count","messages_added","already_existed"],"type":"object"},"ThreadListResponse":{"additionalProperties":true,"description":"Response from listing threads.","properties":{"pagination":{"$ref":"#/components/schemas/ThreadPaginationInfo","description":"Pagination info"},"threads":{"description":"List of threads","items":{"$ref":"#/components/schemas/nowledge_graph_server__api__routers__threads_module__schemas__ThreadPublic"},"title":"Threads","type":"array"}},"required":["pagination"],"title":"ThreadListResponse","type":"object"},"ThreadNode":{"description":"Thread node representing a conversation.","properties":{"created_at":{"format":"date-time","title":"Created At","type":"string"},"id":{"title":"Id","type":"string"},"import_date":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"When thread was imported","title":"Import Date"},"message_count":{"default":0,"description":"Number of messages in thread","title":"Message Count","type":"integer"},"metadata":{"additionalProperties":true,"title":"Metadata","type":"object"},"node_type":{"$ref":"#/components/schemas/NodeType","default":"Thread"},"participants":{"description":"Thread participants","items":{"type":"string"},"title":"Participants","type":"array"},"project":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Project identifier","title":"Project"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Source system (cursor, claude, etc.)","title":"Source"},"space_id":{"default":"default","description":"Isolation space for this thread","title":"Space Id","type":"string"},"storage_id":{"description":"Optional Local physical row ID. Do not infer it from an old list id.","type":"string"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Thread summary for embedding","title":"Summary"},"thread_id":{"description":"Human-readable thread identifier","title":"Thread Id","type":"string"},"thread_reference":{"description":"Optional canonical Local stored-row URI for exact reads and handoff.","type":"string"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Thread title","title":"Title"},"tool_version":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Tool version that created this thread","title":"Tool Version"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"},"workspace":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Workspace path","title":"Workspace"}},"required":["thread_id"],"title":"ThreadNode","type":"object"},"ThreadPaginationInfo":{"additionalProperties":true,"description":"Pagination metadata for threads.","properties":{"has_more":{"description":"Whether more items available","title":"Has More","type":"boolean"},"limit":{"description":"Items per page","title":"Limit","type":"integer"},"offset":{"description":"Offset","title":"Offset","type":"integer"},"total":{"description":"Total items","title":"Total","type":"integer"}},"required":["limit","offset","total","has_more"],"title":"ThreadPaginationInfo","type":"object"},"ThreadParseRequest":{"description":"Request for parsing thread content.","properties":{"file_content":{"description":"Content of the conversation file","title":"File Content","type":"string"},"file_name":{"description":"Name of the file being parsed","title":"File Name","type":"string"}},"required":["file_content","file_name"],"title":"ThreadParseRequest","type":"object"},"ThreadParseResponse":{"description":"Response from thread parsing.","properties":{"error":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Error message if parsing failed","title":"Error"},"format_detected":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detected format","title":"Format Detected"},"parsed_thread":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"description":"Parsed thread data","title":"Parsed Thread"},"success":{"description":"Whether parsing was successful","title":"Success","type":"boolean"}},"required":["success"],"title":"ThreadParseResponse","type":"object"},"ThreadProjectListResponse":{"properties":{"pagination":{"$ref":"#/components/schemas/ThreadPaginationInfo","description":"Pagination info"},"projects":{"items":{"properties":{"count":{"minimum":0,"type":"integer"},"key":{"type":"string"},"kind":{"enum":["workspace","project","unknown"],"type":"string"},"value":{"type":["string","null"]}},"required":["key","kind","value","count"],"type":"object"},"type":"array"}},"required":["projects","pagination"],"type":"object"},"ThreadSearchMetadata":{"additionalProperties":true,"description":"Metadata for thread search results.","properties":{"error":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Error message if any","title":"Error"},"matched_messages_count":{"default":0,"description":"Total matched messages","title":"Matched Messages Count","type":"integer"},"mode":{"description":"Search mode","title":"Mode","type":"string"},"query":{"description":"Search query","title":"Query","type":"string"}},"required":["query","mode"],"title":"ThreadSearchMetadata","type":"object"},"ThreadSearchResponse":{"additionalProperties":true,"description":"Response from thread search.","properties":{"search_metadata":{"$ref":"#/components/schemas/ThreadSearchMetadata","description":"Search metadata"},"threads":{"description":"Search results","items":{"additionalProperties":true,"type":"object"},"title":"Threads","type":"array"},"total_found":{"description":"Total threads found","title":"Total Found","type":"integer"}},"required":["total_found","search_metadata"],"title":"ThreadSearchResponse","type":"object"},"ThreadSourceListResponse":{"additionalProperties":true,"description":"Response from listing thread source options.","properties":{"sources":{"description":"Global thread source options","items":{"$ref":"#/components/schemas/ThreadSourceSummary"},"title":"Sources","type":"array"}},"title":"ThreadSourceListResponse","type":"object"},"ThreadSourceSummary":{"additionalProperties":true,"description":"Global thread source option with count.","properties":{"source":{"description":"Thread source label","title":"Source","type":"string"},"thread_count":{"description":"Number of threads in this source","title":"Thread Count","type":"integer"}},"required":["source","thread_count"],"title":"ThreadSourceSummary","type":"object"},"ThreadSummariesResponse":{"additionalProperties":true,"description":"Response for thread summaries.","properties":{"summaries":{"description":"List of thread summaries","items":{"additionalProperties":true,"type":"object"},"title":"Summaries","type":"array"}},"title":"ThreadSummariesResponse","type":"object"},"ThreadTitleUpdateRequest":{"additionalProperties":false,"properties":{"expected_storage_id":{"description":"Exact immutable Thread.id proved by detail. Nonblank; checked with Space and provider ID at write time.","minLength":1,"type":"string"},"space_id":{"description":"Explicit concrete Space ID from scoped detail; nonblank. Use default for legacy blank/null Default members. Not inferred from environment/config or an aggregate scope.","minLength":1,"type":"string"},"title":{"description":"1-500 Unicode scalar values, not blank after Unicode whitespace trimming, and no control characters (U+0000-U+001F or U+007F-U+009F). No trimming, case folding or Unicode normalization of an accepted value.","maxLength":500,"minLength":1,"type":"string"}},"required":["space_id","expected_storage_id","title"],"type":"object"},"ThreadTitleUpdateResponse":{"properties":{"index_repair_pending":{"description":"Durable projection repair is outstanding; the title write has succeeded, search can lag.","type":"boolean"},"space_id":{"description":"Unchanged concrete Space ID.","type":"string"},"thread_id":{"description":"Unchanged canonical public/provider Thread ID.","type":"string"},"title":{"description":"Authoritative accepted title, including preserved whitespace.","type":"string"},"updated":{"description":"False for an identical-title no-op; no audit timestamp or manual marker change on that no-op.","type":"boolean"}},"required":["thread_id","space_id","title","updated","index_repair_pending"],"type":"object"},"TimelineReviewAction":{"enum":["keep_newer_as_latest","keep_older_as_latest","keep_both_linked","no_change_needed","dismiss","custom_note_only"],"type":"string"},"TimelineReviewResolveRequest":{"properties":{"action":{"description":"Legacy backend action retained for older app clients.","type":["string","null"]},"memory_ids":{"description":"Optional evidence IDs. Every supplied ID must belong to the event.","items":{"type":"string"},"type":["array","null"]},"plan_id":{"description":"Exact plan from the evidence the caller reviewed.","type":["string","null"]},"preview":{"description":"Return the evidence snapshot and plan without settling the event.","type":["boolean","null"]},"resolution":{"description":"Legacy resolution label retained for older app clients.","type":["string","null"]},"resolution_metadata":{"description":"Plan-backed cleanup detail retained for the existing Timeline UI."},"resolution_note":{"description":"Decision note; required for `custom_note_only`.","maxLength":1000,"type":["string","null"]},"review_action":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/TimelineReviewAction","description":"Preferred semantic action. The server validates it against the stored\nevent family before any graph mutation."}]}},"type":"object"},"TimelineReviewResolveResponse":{"properties":{"action":{"type":["string","null"]},"action_result":{},"already_resolved":{"description":"True when another client or policy resolved this immutable review first.\nThe response carries that persisted decision and performs no mutation.","type":"boolean"},"event_id":{"type":"string"},"resolution":{"type":"string"},"resolution_note":{"type":["string","null"]},"success":{"type":"boolean"}},"required":["success","event_id","resolution","already_resolved"],"type":"object"},"ToolCapability":{"properties":{"action_fingerprint":{"description":"SHA-256 of the reviewed external action contract. This is required to\nactivate connector-backed capabilities, but remains optional here so\nolder paused drafts can be loaded and reviewed safely.","type":["string","null"]},"allow_unknown_arguments":{"type":"boolean"},"arguments":{"additionalProperties":{"$ref":"#/components/schemas/ArgumentGrant"},"description":"Root JSON argument name -> rule. Undeclared arguments are rejected unless\n`allow_unknown_arguments` is explicitly true (not recommended for writes).","propertyNames":{"type":"string"},"type":"object"},"operation":{"$ref":"#/components/schemas/ToolOperation"},"resource_label":{"type":["string","null"]},"server":{"description":"`nowledge` for native tools, or the exact custom MCP server name.","type":"string"},"tool":{"type":"string"}},"required":["server","tool","operation"],"type":"object"},"ToolOperation":{"enum":["read","write"],"type":"string"},"TriageRequest":{"description":"Request for lightweight triage of conversation content.\n\nA cheap LLM call to determine whether a conversation contains\nknowledge worth distilling into structured memories.","properties":{"preferred_language":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"User preferred language (ISO 639-1 code), or None to auto-detect","title":"Preferred Language"},"thread_content":{"description":"Conversation content to triage","maxLength":50000,"title":"Thread Content","type":"string"}},"required":["thread_content"],"title":"TriageRequest","type":"object"},"UnitTypeReclassificationRequest":{"description":"Manual unit_type review request.","properties":{"dry_run":{"default":true,"description":"Preview changes without writing metadata.","title":"Dry Run","type":"boolean"},"limit":{"default":50,"description":"Maximum candidate memories to review.","maximum":500,"minimum":1,"title":"Limit","type":"integer"},"min_confidence":{"default":0.78,"description":"Minimum classifier confidence required before changing a type.","maximum":1,"minimum":0,"title":"Min Confidence","type":"number"},"scan_limit":{"default":250,"description":"Maximum weakly typed memories to scan before selecting candidates.","maximum":5000,"minimum":1,"title":"Scan Limit","type":"integer"},"space_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional space scope. Omit to scan all spaces.","title":"Space Id"},"target_unit_types":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Optional classifier target unit_type subset to apply or preview.","title":"Target Unit Types"},"unit_types":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Optional unit_type subset to scan; defaults to fact, decision, learning.","title":"Unit Types"}},"title":"UnitTypeReclassificationRequest","type":"object"},"UpdateLabelRequest":{"description":"Request body for updating a label.","properties":{"color":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Label color (hex)","title":"Color"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Label description","title":"Description"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Label name","title":"Name"}},"title":"UpdateLabelRequest","type":"object"},"UpdateScheduleRequest":{"properties":{"capability_grant":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/CapabilityGrant"}]},"connectors":{"items":{"$ref":"#/components/schemas/ConnectorBindingRequest"},"type":["array","null"]},"enabled_plugin_ids":{"items":{"type":"string"},"type":["array","null"]},"instruction":{"type":["string","null"]},"local_time":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/WallClockTime"}]},"missed_run_policy":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/MissedRunPolicy"}]},"model_policy":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/ModelPolicy"}]},"recurrence":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/Recurrence"}]},"space_id":{"type":["string","null"]},"timezone":{"type":["string","null"]},"title":{"type":["string","null"]}},"type":"object"},"UpdateSourceContentRequest":{"description":"Replace the markdown body of an editable source artifact.","properties":{"content":{"description":"New markdown body","minLength":1,"title":"Content","type":"string"}},"required":["content"],"title":"UpdateSourceContentRequest","type":"object"},"UpdateSourceRequest":{"description":"`sources_shared.py:174-183` (`UpdateSourceRequest`): legacy PATCH bodies\ncarry a lifecycle `action`. Rust also accepts a target `space_id` for source\nmoves; the query-string `space_id` remains the strict source-space guard.","properties":{"action":{"description":"Lifecycle operation: `move`, `reparse`, `ocr_reparse`, or `mark_stale`.","type":["string","null"]},"pdf_render_scale":{"description":"PDFium render scale for `ocr_reparse`. See\n[`IngestFilePathRequest::pdf_render_scale`].","format":"float","maximum":2,"minimum":0.5,"type":["number","null"]},"space_id":{"description":"Compatibility spelling for a move target.","type":["string","null"]},"target_space_id":{"description":"Space to move the Source into.","type":["string","null"]}},"type":"object"},"UpdateWorkingMemoryRequest":{"properties":{"content":{"maxLength":10000,"minLength":1,"title":"Content","type":"string"},"space_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Space Id"}},"required":["content"],"title":"UpdateWorkingMemoryRequest","type":"object"},"UpgradeActionRequest":{"properties":{"tag":{"description":"Target tag, e.g. '0.9.15'. Stable semver only.","title":"Tag","type":"string"}},"required":["tag"],"title":"UpgradeActionRequest","type":"object"},"UpgradeApplyRequest":{"properties":{"confirm":{"description":"Must equal `tag` — the type-to-confirm value the operator types.","title":"Confirm","type":"string"},"tag":{"description":"Target tag, e.g. '0.9.15'. Stable semver only.","title":"Tag","type":"string"}},"required":["tag","confirm"],"title":"UpgradeApplyRequest","type":"object"},"UpgradeCheckResponse":{"description":"Aggregated state for the UI's Update card / title-bar badge.\n\nAlways populated; sub-features degrade gracefully.","properties":{"auto_update_available":{"description":"True iff the sidecar is configured AND reachable. UI shows the Apply button only when True; otherwise renders the SSH hint.","title":"Auto Update Available","type":"boolean"},"auto_update_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Human-readable explanation when auto_update_available is False.","title":"Auto Update Reason"},"current_version":{"description":"Version the running backend reports.","title":"Current Version","type":"string"},"is_docker_deploy":{"description":"True iff this server is the headless Docker deployment (set by NOWLEDGE_HEADLESS=1 in the official image). The UI uses this to decide whether the server-update affordance applies at all: .deb / AppImage / desktop-in-remote-mode servers update through their native mechanisms, not this endpoint. When False, the UI must hide the badge and Server card entirely even if a newer Mem version exists on Docker Hub.","title":"Is Docker Deploy","type":"boolean"},"last_checked_at":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Unix timestamp of the last successful Hub fetch.","title":"Last Checked At"},"latest_version":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Newest stable semver tag on Docker Hub. None if no check has succeeded yet.","title":"Latest Version"},"pulled":{"default":false,"description":"True iff the latest image is already cached locally by the sidecar.","title":"Pulled","type":"boolean"},"registry_error":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Docker Hub fetch error (non-fatal; UI shows 'cannot check').","title":"Registry Error"},"update_available":{"description":"True iff a strictly newer stable tag exists.","title":"Update Available","type":"boolean"}},"required":["current_version","update_available","is_docker_deploy","auto_update_available"],"title":"UpgradeCheckResponse","type":"object"},"UserProfileResponse":{"description":"User profile data for external consumers (browser extension, CLI).","properties":{"aliases":{"default":"","title":"Aliases","type":"string"},"context":{"default":"","title":"Context","type":"string"},"custom_instructions":{"default":"","title":"Custom Instructions","type":"string"},"name":{"default":"","title":"Name","type":"string"},"preferred_language":{"default":"en","title":"Preferred Language","type":"string"}},"title":"UserProfileResponse","type":"object"},"ValidationError":{"properties":{"ctx":{"title":"Context","type":"object"},"input":{"title":"Input"},"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"title":"Location","type":"array"},"msg":{"title":"Message","type":"string"},"type":{"title":"Error Type","type":"string"}},"required":["loc","msg","type"],"title":"ValidationError","type":"object"},"VisualizationConfig":{"additionalProperties":true,"description":"Visualization configuration.","properties":{"edge_weight_range":{"items":{"type":"integer"},"title":"Edge Weight Range","type":"array"},"layout_recommendations":{"additionalProperties":true,"title":"Layout Recommendations","type":"object"},"node_size_range":{"items":{"type":"integer"},"title":"Node Size Range","type":"array"}},"title":"VisualizationConfig","type":"object"},"WallClockTime":{"properties":{"hour":{"format":"int32","minimum":0,"type":"integer"},"minute":{"format":"int32","minimum":0,"type":"integer"}},"required":["hour","minute"],"type":"object"},"WatcherStatusModel":{"description":"Model for watcher status.","properties":{"auto_import_count":{"default":0,"description":"Number of auto-imports","title":"Auto Import Count","type":"integer"},"errors":{"description":"Recent errors","items":{"type":"string"},"title":"Errors","type":"array"},"last_check":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Last check timestamp","title":"Last Check"},"running":{"description":"Whether watcher is running","title":"Running","type":"boolean"},"watched_paths":{"description":"Paths being watched","items":{"type":"string"},"title":"Watched Paths","type":"array"}},"required":["running"],"title":"WatcherStatusModel","type":"object"},"nowledge_graph_server__api__routers__threads_module__schemas__ThreadPublic":{"additionalProperties":true,"description":"Frontend thread format for listing.","properties":{"date":{"description":"Formatted date string","title":"Date","type":"string"},"id":{"description":"Thread ID","title":"Id","type":"string"},"is_favorite":{"default":false,"description":"Favorite status","title":"Is Favorite","type":"boolean"},"messages":{"description":"Number of messages","title":"Messages","type":"integer"},"project":{"description":"Source-provided project name; optional for historical conversations.","type":["string","null"]},"source":{"description":"Thread source","title":"Source","type":"string"},"space_id":{"default":"default","description":"Isolation space for this thread","title":"Space Id","type":"string"},"storage_id":{"description":"Optional Local physical row ID. Do not infer it from an old list id.","type":"string"},"summary":{"default":"","description":"Agent-generated thread summary","title":"Summary","type":"string"},"thread_id":{"description":"Public conversation ID. Existing id semantics are retained.","type":"string"},"thread_reference":{"description":"Optional canonical Local stored-row URI for exact reads and handoff.","type":"string"},"title":{"description":"Thread title","title":"Title","type":"string"},"workspace":{"description":"Exact source-provided workspace path; used before project name for grouping.","type":["string","null"]}},"required":["id","title","source","messages","date"],"title":"ThreadPublic","type":"object"},"nowledge_graph_server__models__memories_api__ThreadPublic":{"additionalProperties":true,"description":"Frontend thread format.","properties":{"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Creation timestamp","title":"Created At"},"date":{"description":"Formatted date string","title":"Date","type":"string"},"id":{"description":"Thread ID","title":"Id","type":"string"},"is_favorite":{"default":false,"description":"Favorite status","title":"Is Favorite","type":"boolean"},"last_activity":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Last activity timestamp","title":"Last Activity"},"messages":{"description":"Number of messages","title":"Messages","type":"integer"},"source":{"description":"Thread source","title":"Source","type":"string"},"title":{"description":"Thread title","title":"Title","type":"string"}},"required":["id","title","source","messages","date"],"title":"ThreadPublic","type":"object"},"IdentityCardContent":{"type":"object","properties":{"kind":{"type":"string","enum":["person","agent","role"],"description":"What the card describes; a role is held by people or agents, such as a repository reviewer."},"summary":{"type":"string","description":"Nonblank description, at most 1000 characters."},"responsibilities":{"type":"array","items":{"type":"string","description":"At most 200 characters."},"maxItems":10},"topics":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false},"maxItems":20},"incarnations":{"type":"array","description":"Agents and roles only: where and how they act.","items":{"type":"object","properties":{"app":{"type":"string"},"repo":{"anyOf":[{"type":"string"},{"type":"null"}]},"role":{"type":"string"}},"required":["app","role"],"additionalProperties":false},"maxItems":20},"evidence":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["thread","memory"]},"id":{"type":"string"}},"required":["kind","id"],"additionalProperties":false},"maxItems":50}},"required":["kind","summary"],"additionalProperties":false},"IdentityCard":{"type":"object","properties":{"card_revision":{"type":"integer","minimum":1},"content":{"$ref":"#/components/schemas/IdentityCardContent"},"updated_at":{"type":"string"},"updated_by":{"type":"string"}},"required":["card_revision","content","updated_at","updated_by"]},"IdentityCardDraftRequest":{"type":"object","properties":{"space_id":{"type":"string","description":"Exact Space ID. Pass explicitly; this operation does not infer the active Space or broaden to other Spaces."},"thread_id":{"type":"string","description":"Public or storage ID of an imported conversation."}},"required":["space_id","thread_id"],"additionalProperties":false},"IdentityCardDrafts":{"type":"object","properties":{"thread_id":{"type":"string","description":"Storage ID of the conversation that was read."},"drafts":{"type":"array","maxItems":8,"items":{"type":"object","properties":{"name":{"type":"string"},"aliases":{"type":"array","items":{"type":"string"}},"existing_profile_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"existing_card":{"anyOf":[{"$ref":"#/components/schemas/IdentityCard"},{"type":"null"}]},"card":{"$ref":"#/components/schemas/IdentityCardContent"},"changes":{"$ref":"#/components/schemas/IdentityCardChanges"}},"required":["name","aliases","existing_profile_id","existing_card","card"]}}},"required":["thread_id","drafts"]},"IdentityCardSave":{"type":"object","properties":{"space_id":{"type":"string","description":"Exact Space ID. Pass explicitly; this operation does not infer the active Space or broaden to other Spaces."},"profile_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Required: null creates a new profile."},"expected_card_revision":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Required when creating."},"aliases":{"type":"array","items":{"type":"string"},"maxItems":32},"card":{"$ref":"#/components/schemas/IdentityCardContent"},"remove":{"$ref":"#/components/schemas/IdentityCardRemoval"}},"required":["space_id","profile_id","card"],"additionalProperties":false,"description":""},"IdentityCardSaved":{"type":"object","properties":{"profile":{"$ref":"#/components/schemas/IdentityProfile"},"card":{"$ref":"#/components/schemas/IdentityCard"}},"required":["profile","card"]},"IdentityCardChanges":{"type":"object","description":"What a draft would add to or correct on the matched profile's current card. Saving grows the card by these; nothing confirmed is dropped.","properties":{"kind":{"description":"What the card describes; a role is held by people or agents, such as a repository reviewer.","type":"string","enum":["person","agent","role"]},"summary":{"type":"string","description":"Set when the draft changes the summary."},"responsibilities":{"type":"array","items":{"type":"string"}},"topics":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false}},"incarnations":{"type":"array","items":{"type":"object","properties":{"app":{"type":"string"},"repo":{"anyOf":[{"type":"string"},{"type":"null"}]},"role":{"type":"string"}},"required":["app","role"],"additionalProperties":false}},"evidence":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["thread","memory"]},"id":{"type":"string"}},"required":["kind","id"],"additionalProperties":false}}},"required":["responsibilities","topics","incarnations","evidence"]},"IdentityCardRemoval":{"type":"object","description":"Items a reviewer explicitly takes out of the card. Growth never removes anything on its own.","properties":{"responsibilities":{"type":"array","items":{"type":"string"}},"topics":{"type":"array","description":"Topic IDs.","items":{"type":"string"}},"incarnations":{"type":"array","items":{"type":"object","properties":{"app":{"type":"string"},"repo":{"anyOf":[{"type":"string"},{"type":"null"}]},"role":{"type":"string"}},"required":["app","role"],"additionalProperties":false}},"evidence":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["thread","memory"]},"id":{"type":"string"}},"required":["kind","id"],"additionalProperties":false}}},"additionalProperties":false}}},"info":{"contact":{"email":"hello@nowledge-labs.ai","name":"Nowledge Labs","url":"https://www.nowledge-labs.ai/"},"description":"REST API for Nowledge Mem Service","termsOfService":"https://mem.nowledge.co/privacy","title":"Nowledge Mem API","version":"0.9.15"},"openapi":"3.2.0","paths":{"/admin/upgrade/check":{"get":{"description":"Aggregated check: current vs latest, sidecar reachability, pulled status.\n\nSafe to call from any same-origin client; respects the origin guard.","operationId":"check_admin_upgrade_check_get","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpgradeCheckResponse"}}},"description":"Successful Response"}},"summary":"Check","tags":["admin-upgrade","admin","upgrade"]}},"/admin/upgrade/download":{"post":{"description":"Pre-pull a target tag into the local docker cache. Idempotent.\n\nReturns 412 if the sidecar is unreachable — the actual `docker pull`\nruns inside the sidecar, which is the only piece holding docker.sock.","operationId":"download_admin_upgrade_download_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpgradeActionRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Download Admin Upgrade Download Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Download","tags":["admin-upgrade","admin","upgrade"]}},"/admin/upgrade/install":{"post":{"description":"Snapshot + recreate the mem container on a new tag.\n\nStrict checks BEFORE forwarding to the sidecar:\n - Origin guard (default-closed).\n - Stable semver tag.\n - `confirm` matches `tag` (the type-to-confirm contract).\n - Reject downgrades and same-version applies (catch operator misclicks).\n\nThe sidecar runs free-space precheck + lock acquisition + snapshot +\nrecreate detached and returns 202 immediately. The UI polls /check\nto learn when the new tag is live.","operationId":"install_admin_upgrade_install_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpgradeApplyRequest"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Install Admin Upgrade Install Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Install","tags":["admin-upgrade","admin","upgrade"]}},"/agent/ai-now/schedules":{"get":{"operationId":"openapi_list_schedules","parameters":[{"in":"query","name":"include_deleted","required":false,"schema":{"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleListResponse"}}},"description":""}},"summary":"List recurring AI Now tasks","tags":["ai-now"]},"post":{"description":"Creates a draft only. The task cannot run unattended until it is explicitly confirmed.","operationId":"openapi_create_schedule","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateScheduleRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleResponse"}}},"description":""},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleErrorResponse"}}},"description":""}},"summary":"Create a recurring AI Now task draft","tags":["ai-now"]}},"/agent/ai-now/schedules/preview":{"post":{"operationId":"openapi_preview_schedule","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PreviewScheduleRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SchedulePreviewResponse"}}},"description":""},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleErrorResponse"}}},"description":""}},"summary":"Preview recurring task occurrences","tags":["ai-now"]}},"/agent/ai-now/schedules/{schedule_id}":{"delete":{"operationId":"openapi_delete_schedule","parameters":[{"in":"path","name":"schedule_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleDeleteResponse"}}},"description":""},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleErrorResponse"}}},"description":""}},"summary":"Delete a recurring AI Now task","tags":["ai-now"]},"get":{"operationId":"openapi_get_schedule","parameters":[{"description":"Stable recurring task ID","in":"path","name":"schedule_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleResponse"}}},"description":""},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleErrorResponse"}}},"description":""}},"summary":"Get a recurring AI Now task","tags":["ai-now"]},"patch":{"description":"Permission-sensitive changes pause an active task until it is reviewed and confirmed again.","operationId":"openapi_update_schedule","parameters":[{"in":"path","name":"schedule_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateScheduleRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleResponse"}}},"description":""},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleErrorResponse"}}},"description":""},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleErrorResponse"}}},"description":""}},"summary":"Edit a recurring AI Now task","tags":["ai-now"]}},"/agent/ai-now/schedules/{schedule_id}/confirm":{"post":{"description":"Activates only when the capability grant matches the current instruction and connector configuration.","operationId":"openapi_confirm_schedule","parameters":[{"in":"path","name":"schedule_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmScheduleRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleResponse"}}},"description":""},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleErrorResponse"}}},"description":""},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleErrorResponse"}}},"description":""}},"summary":"Confirm and activate a recurring AI Now task","tags":["ai-now"]}},"/agent/ai-now/schedules/{schedule_id}/pause":{"post":{"operationId":"openapi_pause_schedule","parameters":[{"in":"path","name":"schedule_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleResponse"}}},"description":""},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleErrorResponse"}}},"description":""},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleErrorResponse"}}},"description":""},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleErrorResponse"}}},"description":""}},"summary":"Pause a recurring task and request cancellation of its current run","tags":["ai-now"]}},"/agent/ai-now/schedules/{schedule_id}/resume":{"post":{"description":"Tasks with changed authority or uncertain external side effects must be confirmed instead.","operationId":"openapi_resume_schedule","parameters":[{"in":"path","name":"schedule_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleResponse"}}},"description":""},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleErrorResponse"}}},"description":""},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleErrorResponse"}}},"description":""}},"summary":"Resume a recurring AI Now task","tags":["ai-now"]}},"/agent/ai-now/schedules/{schedule_id}/runs":{"get":{"operationId":"openapi_schedule_runs","parameters":[{"in":"path","name":"schedule_id","required":true,"schema":{"type":"string"}},{"in":"query","name":"limit","required":false,"schema":{"minimum":0,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleRunsResponse"}}},"description":""}},"summary":"List recurring task run history","tags":["ai-now"]}},"/agent/ai-now/sessions":{"get":{"description":"List AI Now sessions.\n\nBy-id-direct. Includes backend sessions plus read-only legacy ACP sessions\nso upgrades preserve existing user conversations.","operationId":"list_ai_now_sessions_agent_ai_now_sessions_get","responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response List Ai Now Sessions Agent Ai Now Sessions Get","type":"object"}}},"description":"Successful Response"}},"summary":"List Ai Now Sessions","tags":["knowledge-agent","knowledge-agent","ai-now"]},"post":{"description":"Create a backend-owned AI Now session.\n\nSpace-scoped through ``activeSpaceId`` for Nowledge Mem MCP retrieval.","operationId":"create_ai_now_session_agent_ai_now_sessions_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AINowSessionCreateRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Create Ai Now Session Agent Ai Now Sessions Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Create Ai Now Session","tags":["knowledge-agent","knowledge-agent","ai-now"]}},"/agent/ai-now/sessions/{session_id}":{"delete":{"operationId":"delete_ai_now_session_agent_ai_now_sessions__session_id__delete","parameters":[{"in":"path","name":"session_id","required":true,"schema":{"title":"Session Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Delete Ai Now Session Agent Ai Now Sessions Session Id Delete","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Delete Ai Now Session","tags":["knowledge-agent","knowledge-agent","ai-now"]},"get":{"operationId":"get_ai_now_session_agent_ai_now_sessions__session_id__get","parameters":[{"in":"path","name":"session_id","required":true,"schema":{"title":"Session Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Get Ai Now Session Agent Ai Now Sessions Session Id Get","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Ai Now Session","tags":["knowledge-agent","knowledge-agent","ai-now"]},"patch":{"operationId":"update_ai_now_session_agent_ai_now_sessions__session_id__patch","parameters":[{"in":"path","name":"session_id","required":true,"schema":{"title":"Session Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AINowSessionUpdateRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Update Ai Now Session Agent Ai Now Sessions Session Id Patch","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Update Ai Now Session","tags":["knowledge-agent","knowledge-agent","ai-now"]}},"/agent/ai-now/sessions/{session_id}/auto-approve":{"get":{"operationId":"get_ai_now_auto_approve_agent_ai_now_sessions__session_id__auto_approve_get","parameters":[{"in":"path","name":"session_id","required":true,"schema":{"title":"Session Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Get Ai Now Auto Approve Agent Ai Now Sessions Session Id Auto Approve Get","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Ai Now Auto Approve","tags":["knowledge-agent","knowledge-agent","ai-now"]},"post":{"operationId":"set_ai_now_auto_approve_agent_ai_now_sessions__session_id__auto_approve_post","parameters":[{"in":"path","name":"session_id","required":true,"schema":{"title":"Session Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AINowAutoApproveRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Set Ai Now Auto Approve Agent Ai Now Sessions Session Id Auto Approve Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Set Ai Now Auto Approve","tags":["knowledge-agent","knowledge-agent","ai-now"]}},"/agent/ai-now/sessions/{session_id}/cancel":{"post":{"operationId":"cancel_ai_now_prompt_agent_ai_now_sessions__session_id__cancel_post","parameters":[{"in":"path","name":"session_id","required":true,"schema":{"title":"Session Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Cancel Ai Now Prompt Agent Ai Now Sessions Session Id Cancel Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Cancel Ai Now Prompt","tags":["knowledge-agent","knowledge-agent","ai-now"]}},"/agent/ai-now/sessions/{session_id}/close":{"post":{"operationId":"close_ai_now_session_agent_ai_now_sessions__session_id__close_post","parameters":[{"in":"path","name":"session_id","required":true,"schema":{"title":"Session Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Close Ai Now Session Agent Ai Now Sessions Session Id Close Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Close Ai Now Session","tags":["knowledge-agent","knowledge-agent","ai-now"]}},"/agent/ai-now/sessions/{session_id}/events":{"get":{"description":"Attach to a live prompt stream without starting a new turn.","operationId":"stream_ai_now_session_events_agent_ai_now_sessions__session_id__events_get","parameters":[{"in":"path","name":"session_id","required":true,"schema":{"title":"Session Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Stream Ai Now Session Events","tags":["knowledge-agent","knowledge-agent","ai-now"]}},"/agent/ai-now/sessions/{session_id}/files/read":{"post":{"description":"Read a text artifact generated inside an AI Now session workdir.\n\nBy-id-direct. The requested path must resolve inside the session working\ndirectory, so web/remote renderers can load generated cards without\nexposing arbitrary backend files.","operationId":"read_ai_now_session_file_agent_ai_now_sessions__session_id__files_read_post","parameters":[{"in":"path","name":"session_id","required":true,"schema":{"title":"Session Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AINowFileReadRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Read Ai Now Session File Agent Ai Now Sessions Session Id Files Read Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Read Ai Now Session File","tags":["knowledge-agent","knowledge-agent","ai-now"]}},"/agent/ai-now/sessions/{session_id}/messages":{"get":{"operationId":"load_ai_now_messages_agent_ai_now_sessions__session_id__messages_get","parameters":[{"in":"path","name":"session_id","required":true,"schema":{"title":"Session Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Load Ai Now Messages Agent Ai Now Sessions Session Id Messages Get","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Load Ai Now Messages","tags":["knowledge-agent","knowledge-agent","ai-now"]},"post":{"operationId":"save_ai_now_messages_agent_ai_now_sessions__session_id__messages_post","parameters":[{"in":"path","name":"session_id","required":true,"schema":{"title":"Session Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AINowMessagesRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Save Ai Now Messages Agent Ai Now Sessions Session Id Messages Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Save Ai Now Messages","tags":["knowledge-agent","knowledge-agent","ai-now"]}},"/agent/ai-now/sessions/{session_id}/permissions/{request_id}":{"post":{"operationId":"respond_ai_now_permission_agent_ai_now_sessions__session_id__permissions__request_id__post","parameters":[{"in":"path","name":"session_id","required":true,"schema":{"title":"Session Id","type":"string"}},{"in":"path","name":"request_id","required":true,"schema":{"title":"Request Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AINowPermissionResponseRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Respond Ai Now Permission Agent Ai Now Sessions Session Id Permissions Request Id Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Respond Ai Now Permission","tags":["knowledge-agent","knowledge-agent","ai-now"]}},"/agent/ai-now/sessions/{session_id}/prompt":{"post":{"description":"Stream a prompt turn.\n\nReturns SSE events in the existing AI Now UI event contract.","operationId":"prompt_ai_now_session_agent_ai_now_sessions__session_id__prompt_post","parameters":[{"in":"path","name":"session_id","required":true,"schema":{"title":"Session Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AINowPromptRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Prompt Ai Now Session","tags":["knowledge-agent","knowledge-agent","ai-now"]}},"/agent/ai-now/skill-prompts":{"post":{"description":"Update the server-side AI Now skill prompt injection file.\n\nBackend-owned AI Now sessions read this file when preparing their agent spec,\nso web/mobile/remote clients must sync it to the backend, not only to a\nclient-local Tauri filesystem.","operationId":"sync_ai_now_skill_prompts_agent_ai_now_skill_prompts_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AINowSkillPromptsRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Sync Ai Now Skill Prompts Agent Ai Now Skill Prompts Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Sync Ai Now Skill Prompts","tags":["knowledge-agent","knowledge-agent","ai-now"]}},"/agent/evolves":{"get":{"description":"Get memory evolution chains.\n\nShows how memories have been updated, enriched, or superseded over time. Filter by a specific `memory_id` to see its full version history. Use `offset` to paginate; `total` in the response reflects the count under the same filters.","operationId":"get_evolves_edges_agent_evolves_get","parameters":[{"in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":200,"minimum":1,"title":"Limit","type":"integer"}},{"in":"query","name":"offset","required":false,"schema":{"default":0,"minimum":0,"title":"Offset","type":"integer"}},{"in":"query","name":"content_relation","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Relation"}},{"in":"query","name":"unreviewed_only","required":false,"schema":{"default":false,"title":"Unreviewed Only","type":"boolean"}},{"description":"Filter to EVOLVES edges where this memory appears as older or newer node.","in":"query","name":"memory_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter to EVOLVES edges where this memory appears as older or newer node.","title":"Memory Id"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Get Evolves Edges Agent Evolves Get","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Evolves Edges","tags":["knowledge-agent","knowledge-agent"]}},"/agent/feed/events":{"get":{"description":"Read immutable Timeline events with bounded pagination and filters. Set review_only with unresolved_only to project the pending Memory Review Inbox; membership is determined by event type rather than presentation severity. Each pending review advertises allowed_actions, the conservative recommended_action for explicit approval, automatic_resolution=expired_no_change, and its absolute expires_at timestamp.","operationId":"get_feed_events_agent_feed_events_get","parameters":[{"description":"Maximum events returned on this page.","in":"query","name":"limit","required":false,"schema":{"default":50,"format":"int64","maximum":1000,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Zero-based result offset.","in":"query","name":"offset","required":false,"schema":{"default":0,"format":"int64","minimum":0,"title":"Offset","type":"integer"}},{"description":"Filter by presentation severity.","in":"query","name":"severity","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Severity","type":"string"}},{"description":"Filter by one exact event type.","in":"query","name":"event_type","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event Type","type":"string"}},{"description":"Return only events that have not been resolved.","in":"query","name":"unresolved_only","required":false,"schema":{"default":false,"title":"Unresolved Only","type":"boolean"}},{"description":"Project only actionable Timeline review families. Event type, not\npresentation severity, defines membership (Cloud/local parity).","in":"query","name":"review_only","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"Number of recent date partitions to scan when no explicit range is supplied.","in":"query","name":"last_n_days","required":false,"schema":{"default":90,"format":"int64","maximum":365,"minimum":1,"title":"Last N Days","type":"integer"}},{"description":"Start of date range (YYYY-MM-DD). Overrides last_n_days lower bound.","in":"query","name":"date_from","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Start of date range (YYYY-MM-DD). Overrides last_n_days lower bound.","title":"Date From","type":"string"}},{"description":"End of date range (YYYY-MM-DD, inclusive). Defaults to today.","in":"query","name":"date_to","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"End of date range (YYYY-MM-DD, inclusive). Defaults to today.","title":"Date To","type":"string"}},{"description":"Filter by metadata.source value (e.g. 'library:source_id').","in":"query","name":"source","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by metadata.source value (e.g. 'library:source_id').","title":"Source","type":"string"}},{"description":"Filter by memory space. Feed storage stays global; matching is based on event metadata or related memories.","in":"query","name":"space_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by memory space. Feed storage stays global; matching is based on event metadata or related memories.","title":"Space Id","type":"string"}},{"description":"Return an exact total count. Set false for faster first-page loading when only page data and has_more are needed.","in":"query","name":"include_total","required":false,"schema":{"default":true,"description":"Return an exact total count. Set false for faster first-page loading when only page data and has_more are needed.","title":"Include Total","type":"boolean"}},{"description":"Client IANA timezone so `date_from`/`date_to` (local day strings from the\ncalendar/timeline) compare against each event's LOCAL day, not its UTC day.\nAbsent/unknown → UTC (prior behavior).","in":"query","name":"tz","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedEventsResponse"}}},"description":"Timeline page"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Feed Events","tags":["knowledge-agent"]}},"/agent/feed/events/{event_id}":{"delete":{"description":"Compatibility endpoint that hides an immutable Timeline event from the current viewer. It does not delete the event or its evidence. Use PUT /agent/feed/events/{event_id}/visibility to hide or restore explicitly.","operationId":"delete_feed_event_agent_feed_events__event_id__delete","parameters":[{"in":"path","name":"event_id","required":true,"schema":{"title":"Event Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedEventVisibilityResponse"}}},"description":"Event hidden for the current viewer"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Hide Feed Event","tags":["knowledge-agent"]}},"/agent/feed/events/{event_id}/resolve":{"post":{"description":"Resolve one pending Memory review through the server's audited executor. Prefer review_action: the server validates the action against the stored event and performs any graph mutation before marking the event resolved. A failed action leaves the review pending. Replays are idempotent and return the persisted decision with already_resolved=true.","operationId":"resolve_event_agent_feed_events__event_id__resolve_post","parameters":[{"description":"Timeline review event id","in":"path","name":"event_id","required":true,"schema":{"title":"Event Id","type":"string"}},{"description":"Semantic review action; JSON body is preferred","in":"query","name":"review_action","required":false,"schema":{"$ref":"#/components/schemas/TimelineReviewAction"}},{"description":"Resolution type: accepted|dismissed|merged","in":"query","name":"resolution","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Resolution type: accepted|dismissed|merged","title":"Resolution","type":"string"}},{"description":"Graph action: delete_memory|keep_newer|keep_both","in":"query","name":"action","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Graph action: delete_memory|keep_newer|keep_both","title":"Action","type":"string"}},{"description":"Comma-separated memory IDs to act on","in":"query","name":"memory_ids","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated memory IDs to act on","title":"Memory Ids","type":"string"}},{"description":"Optional human/agent note explaining a custom resolution","in":"query","name":"resolution_note","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional human/agent note explaining a custom resolution","title":"Resolution Note","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/TimelineReviewResolveRequest"}]}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimelineReviewResolveResponse"}}},"description":"Review resolved"},"404":{"description":"Review not found"},"409":{"description":"Review already resolved"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Action is invalid for this review"}},"summary":"Resolve Timeline Review","tags":["knowledge-agent"]}},"/agent/feed/events/{event_id}/retry":{"post":{"description":"Retry a failed background task.\n\nRe-submits the task with high priority. The original event is marked as retried.","operationId":"retry_event_agent_feed_events__event_id__retry_post","parameters":[{"in":"path","name":"event_id","required":true,"schema":{"title":"Event Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Retry Event Agent Feed Events Event Id Retry Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Retry Event","tags":["knowledge-agent","knowledge-agent","knowledge-agent"]}},"/agent/feed/events/{event_id}/review":{"post":{"description":"Choose phase=preview to read the full authorized evidence and proposed graph effects. Show that snapshot to the person making the decision, then send phase=apply with the exact plan_id and unchanged command. A conflict requires an explicit new preview, never an invisible refresh and retry. Graph changes and their authoritative receipt commit together. An authorized retry returns the original decision, including when it differs from the requested action. Dismiss and note-only actions may use phase=apply without a plan. Older servers do not serve this endpoint; never fall back to the legacy resolve endpoint for a preview or graph confirmation.","operationId":"openapi_guarded_timeline_review","parameters":[{"description":"Timeline review event ID","in":"path","name":"event_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GuardedTimelineReviewRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GuardedTimelineReviewResponse"}}},"description":"Evidence preview or recorded decision"},"400":{"description":"Malformed request"},"403":{"description":"Current authority does not permit this review"},"404":{"description":"Review unavailable or endpoint unsupported; do not fall back"},"409":{"description":"Evidence changed; explicitly review a fresh preview"},"422":{"description":"Invalid phase, arguments or action for this review"},"428":{"description":"A displayed evidence plan is required"},"503":{"description":"Evidence or storage is unavailable"}},"summary":"Preview or Confirm Timeline Review","tags":["knowledge-agent"]}},"/agent/feed/events/{event_id}/visibility":{"put":{"description":"Hide or restore an immutable Timeline event for the current viewer. This changes personal presentation only; it does not delete the event or its evidence.","operationId":"openapi_set_feed_event_visibility","parameters":[{"description":"Timeline event id","in":"path","name":"event_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedEventVisibilityRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedEventVisibilityResponse"}}},"description":"Visibility updated"}},"summary":"Set Feed Event Visibility","tags":["knowledge-agent"]}},"/agent/feed/input/persist-question":{"post":{"description":"Save a question and its response as a feed event.\n\nCalled after agent streaming completes to persist the Q&A in the feed timeline. Does not create memories, only stores the conversation.","operationId":"persist_question_agent_feed_input_persist_question_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersistQuestionRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Persist Question Agent Feed Input Persist Question Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Persist Question","tags":["knowledge-agent","knowledge-agent","knowledge-agent"]}},"/agent/feed/input/stream":{"post":{"description":"Stream agent processing of feed input.\n\nThe agent classifies your input, searches the knowledge base for context, and streams back a response. Captures are saved as memories automatically.","operationId":"submit_feed_input_stream_agent_feed_input_stream_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedInputRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Submit Feed Input Stream","tags":["knowledge-agent","knowledge-agent","knowledge-agent"]}},"/agent/graph-intelligence/message":{"post":{"description":"Send a message to the Graph Intelligence Agent with frozen graph context.\n\nReturns an SSE stream with text, tool_call, tool_result, canvas_command,\nand done events. The graphContext is injected into the agent prompt and\nstored as user message metadata.","operationId":"send_message_agent_graph_intelligence_message_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GraphIntelligenceMessageRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Send Message","tags":["knowledge-agent","knowledge-agent","graph-intelligence"]}},"/agent/graph-intelligence/session":{"get":{"description":"Load the last chat session from disk.","operationId":"load_session_agent_graph_intelligence_session_get","responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"}},"summary":"Load Session","tags":["knowledge-agent","knowledge-agent","graph-intelligence"]},"post":{"description":"Save chat session to disk (atomic write, size-capped).","operationId":"save_session_agent_graph_intelligence_session_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaveSessionRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Save Session","tags":["knowledge-agent","knowledge-agent","graph-intelligence"]}},"/agent/graph-intelligence/status":{"get":{"description":"Check if the Graph Intelligence Agent is running.","operationId":"get_status_agent_graph_intelligence_status_get","responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"}},"summary":"Get Status","tags":["knowledge-agent","knowledge-agent","graph-intelligence"]}},"/agent/knowledge-processing/status":{"get":{"description":"Get knowledge processing settings and status.\n\nReturns current configuration, task status history, and token budget usage.","operationId":"get_knowledge_processing_status_agent_knowledge_processing_status_get","parameters":[{"in":"query","name":"include_settings","required":false,"schema":{"default":true,"title":"Include Settings","type":"boolean"}},{"in":"query","name":"include_ledgers","required":false,"schema":{"default":true,"title":"Include Ledgers","type":"boolean"}},{"in":"query","name":"include_dedup","required":false,"schema":{"default":true,"title":"Include Dedup","type":"boolean"}},{"in":"query","name":"include_usage","required":false,"schema":{"default":true,"title":"Include Usage","type":"boolean"}},{"in":"query","name":"include_history","required":false,"schema":{"default":true,"title":"Include History","type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Get Knowledge Processing Status Agent Knowledge Processing Status Get","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Knowledge Processing Status","tags":["knowledge-agent","knowledge-agent"]}},"/agent/knowledge-processing/tasks/cancel":{"post":{"description":"Cancel a queued or running Knowledge Processing task.","operationId":"cancel_knowledge_processing_task_agent_knowledge_processing_tasks_cancel_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancelKnowledgeProcessingTaskRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Cancel Knowledge Processing Task Agent Knowledge Processing Tasks Cancel Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Cancel Knowledge Processing Task","tags":["knowledge-agent","knowledge-agent"]}},"/agent/skill-builder/chat":{"post":{"description":"The Skills copilot turn (SSE). Reads the screen context, routes intent, and\nanswers, drafts a new skill, or emits one UI action.\n\nEvents: ``routing`` -> ``message`` (the reply) -> then EITHER ``action`` (a UI\ncommand the frontend applies) OR the draft sub-stream (``searching`` ->\n``knowledge`` -> ``drafting`` -> ``proposal``) -> ``done`` (or ``error``).\nCross-space when ``space_id`` is omitted.","operationId":"skill_builder_chat_agent_skill_builder_chat_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillBuilderChatRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Skill Builder Chat","tags":["knowledge-agent","knowledge-agent","skill-builder"]}},"/agent/skill-builder/discover-importable":{"get":{"description":"Hand-written skills found in the user's connected host dirs that Mem does not\nmanage — the discovery half of enroll. Read-only scan; the user selects which to\nimport. Reads local disk directly (local-only, enforced).","operationId":"skill_builder_discover_importable_agent_skill_builder_discover_importable_get","responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Skill Builder Discover Importable Agent Skill Builder Discover Importable Get","type":"object"}}},"description":"Successful Response"}},"summary":"Skill Builder Discover Importable","tags":["knowledge-agent","knowledge-agent","skill-builder"]}},"/agent/skill-builder/edit-body":{"post":{"description":"Stage a user-authored body as a pending version (the user as a third author\nof ``pending_version``, beside refine-AI and the curator).\n\nStages INSTANTLY (validate + compose + secret-scan), then computes the A/B\ntransparency proof in the BACKGROUND so the save isn't blocked on running the\nbenchmark through the model (that was the 20-second \"Saving…\"). The edit is\nINTENT (D4): the proof never refuses it, only shows it, and the user can apply\nvia ``POST /skills/{id}/apply-version`` without waiting for it.","operationId":"skill_builder_edit_body_agent_skill_builder_edit_body_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillEditBodyRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Skill Builder Edit Body Agent Skill Builder Edit Body Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Skill Builder Edit Body","tags":["knowledge-agent","knowledge-agent","skill-builder"]}},"/agent/skill-builder/import":{"post":{"description":"Import a hand-written skill as a managed draft (body verbatim, no compile).\n\nThe third way a skill is born (beside suggested + authored-from-scratch): it\nflows through the same review -> activate -> materialize -> evolve loop, gaining\nverification, self-improvement, cross-tool sync, and versioning. A folder import\nkeeps the whole tree (nested folders + binary assets) verbatim. Returns the\ncreated draft, or — when it looks like an existing active skill and ``force`` is\nfalse — the duplicate it matched, so the user can strengthen that one instead.\nLooks up by content; space-agnostic (skills list cross-space).","operationId":"skill_builder_import_agent_skill_builder_import_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillImportRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Skill Builder Import Agent Skill Builder Import Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Skill Builder Import","tags":["knowledge-agent","knowledge-agent","skill-builder"]}},"/agent/skill-builder/preview-importable":{"get":{"description":"The SKILL.md + file list for one discoverable skill, for the enroll preview\npane (read what you're bringing in before you commit). Path-validated to a host\nskills dir. Reads local disk directly (local-only, enforced).","operationId":"skill_builder_preview_importable_agent_skill_builder_preview_importable_get","parameters":[{"in":"query","name":"path","required":true,"schema":{"title":"Path","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Skill Builder Preview Importable Agent Skill Builder Preview Importable Get","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Skill Builder Preview Importable","tags":["knowledge-agent","knowledge-agent","skill-builder"]}},"/agent/skill-builder/propose":{"post":{"description":"Propose a skill draft from intent, streaming the work as it happens (SSE).\n\nEvents (``data: {json}``): ``searching`` -> ``knowledge`` (the threads + notes\nit found, shown before the draft) -> ``drafting`` -> ``proposal`` (the draft +\nwhich sources it chose) -> ``done`` (or ``error``). The UI renders this as a\nlive process timeline so the agent shows its work. Cross-space when\n``space_id`` is omitted. The proposal is the builder form's pre-fill; the user\nreviews and creates.","operationId":"skill_builder_propose_agent_skill_builder_propose_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillBuilderProposeRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Skill Builder Propose","tags":["knowledge-agent","knowledge-agent","skill-builder"]}},"/agent/skill-builder/refine":{"post":{"description":"Propose a sharper version of a compiled skill from how it has performed\n(plus optional guidance). Records it as a ``pending_version`` the user reviews\nand applies via apply-version; never auto-commits. Mirrors ProposeSkillVersion.\nNon-streaming; ``/refine/stream`` shows the work as it happens.","operationId":"skill_builder_refine_agent_skill_builder_refine_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillRefineRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Skill Builder Refine Agent Skill Builder Refine Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Skill Builder Refine","tags":["knowledge-agent","knowledge-agent","skill-builder"]}},"/agent/skill-builder/refine/stream":{"post":{"description":"Stream the refine work (SSE): ``reading`` -> ``outcomes`` -> ``drafting`` ->\n``revision`` -> ``done`` (or ``error``). The UI renders the optimize loop as a\nlive process, the same way create does.","operationId":"skill_builder_refine_stream_agent_skill_builder_refine_stream_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillRefineRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Skill Builder Refine Stream","tags":["knowledge-agent","knowledge-agent","skill-builder"]}},"/agent/status":{"get":{"description":"Get the Knowledge Agent's current status.","operationId":"get_agent_status_agent_status_get","responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Get Agent Status Agent Status Get","type":"object"}}},"description":"Successful Response"}},"summary":"Get Agent Status","tags":["knowledge-agent","knowledge-agent"]}},"/agent/tasks/overview":{"get":{"description":"Read-only projection over the three background task mechanisms: the scheduler queue, one-shot reminders, and recurring AI automations.\n\nCreates no entity and stores nothing. Every row is derived at read time from a store that already exists. This surface shows and links; pausing or resuming a recurring task belongs to `/agent/ai-now/schedules/{schedule_id}/pause` and stopping a running task belongs to `/agent/knowledge-processing/tasks/cancel`.\n\nCross-space: background work is not space-scoped on this plane, so the projection reads the whole server.","operationId":"get_in_flight_overview_agent_tasks_overview_get","responses":{"200":{"content":{"application/json":{"schema":{"properties":{"agent_running":{"description":"False means the server has no scheduler attached, so empty groups mean 'not observed', not 'nothing scheduled'.","type":"boolean"},"generated_at":{"type":"string"},"queued":{"items":{"properties":{"detail":{"description":"Optional subject line: thread title, source name, or reminder note.","type":"string"},"id":{"description":"Stable within its own mechanism.","type":"string"},"kind":{"description":"Which existing mechanism produced this row.","enum":["scheduler","reminder","recurring"],"type":"string"},"lane":{"description":"The lane / task type that owns this work.","type":"string"},"last_result":{"description":"The last settled run, when the source store recorded one.","properties":{"at":{"type":"string"},"status":{"description":"success | partial | skipped | failed | cancelled","type":"string"},"summary":{"type":"string"}},"required":["status","at"],"type":"object"},"next_run_at":{"description":"RFC 3339; set when the row has not run yet.","type":"string"},"started_at":{"description":"RFC 3339; set when the row is executing.","type":"string"},"status":{"description":"Recurring rows only. A paused or unconfirmed automation stays visible, marked.","enum":["active","paused","draft"],"type":"string"},"title":{"type":"string"}},"required":["kind","id","title","lane"],"type":"object"},"type":"array"},"recurring":{"items":{"properties":{"detail":{"description":"Optional subject line: thread title, source name, or reminder note.","type":"string"},"id":{"description":"Stable within its own mechanism.","type":"string"},"kind":{"description":"Which existing mechanism produced this row.","enum":["scheduler","reminder","recurring"],"type":"string"},"lane":{"description":"The lane / task type that owns this work.","type":"string"},"last_result":{"description":"The last settled run, when the source store recorded one.","properties":{"at":{"type":"string"},"status":{"description":"success | partial | skipped | failed | cancelled","type":"string"},"summary":{"type":"string"}},"required":["status","at"],"type":"object"},"next_run_at":{"description":"RFC 3339; set when the row has not run yet.","type":"string"},"started_at":{"description":"RFC 3339; set when the row is executing.","type":"string"},"status":{"description":"Recurring rows only. A paused or unconfirmed automation stays visible, marked.","enum":["active","paused","draft"],"type":"string"},"title":{"type":"string"}},"required":["kind","id","title","lane"],"type":"object"},"type":"array"},"running":{"items":{"properties":{"detail":{"description":"Optional subject line: thread title, source name, or reminder note.","type":"string"},"id":{"description":"Stable within its own mechanism.","type":"string"},"kind":{"description":"Which existing mechanism produced this row.","enum":["scheduler","reminder","recurring"],"type":"string"},"lane":{"description":"The lane / task type that owns this work.","type":"string"},"last_result":{"description":"The last settled run, when the source store recorded one.","properties":{"at":{"type":"string"},"status":{"description":"success | partial | skipped | failed | cancelled","type":"string"},"summary":{"type":"string"}},"required":["status","at"],"type":"object"},"next_run_at":{"description":"RFC 3339; set when the row has not run yet.","type":"string"},"started_at":{"description":"RFC 3339; set when the row is executing.","type":"string"},"status":{"description":"Recurring rows only. A paused or unconfirmed automation stays visible, marked.","enum":["active","paused","draft"],"type":"string"},"title":{"type":"string"}},"required":["kind","id","title","lane"],"type":"object"},"type":"array"},"scheduled_once":{"items":{"properties":{"detail":{"description":"Optional subject line: thread title, source name, or reminder note.","type":"string"},"id":{"description":"Stable within its own mechanism.","type":"string"},"kind":{"description":"Which existing mechanism produced this row.","enum":["scheduler","reminder","recurring"],"type":"string"},"lane":{"description":"The lane / task type that owns this work.","type":"string"},"last_result":{"description":"The last settled run, when the source store recorded one.","properties":{"at":{"type":"string"},"status":{"description":"success | partial | skipped | failed | cancelled","type":"string"},"summary":{"type":"string"}},"required":["status","at"],"type":"object"},"next_run_at":{"description":"RFC 3339; set when the row has not run yet.","type":"string"},"started_at":{"description":"RFC 3339; set when the row is executing.","type":"string"},"status":{"description":"Recurring rows only. A paused or unconfirmed automation stays visible, marked.","enum":["active","paused","draft"],"type":"string"},"title":{"type":"string"}},"required":["kind","id","title","lane"],"type":"object"},"type":"array"}},"required":["agent_running","generated_at","running","queued","scheduled_once","recurring"],"title":"InFlightOverview","type":"object"}}},"description":"Successful Response"}},"summary":"Get In Flight Overview","tags":["knowledge-agent"]}},"/agent/token-usage":{"get":{"description":"Return the local model-usage ledger for UI and enterprise integrations.","operationId":"get_token_usage_summary_agent_token_usage_get","responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Get Token Usage Summary Agent Token Usage Get","type":"object"}}},"description":"Successful Response"}},"summary":"Get Token Usage Summary","tags":["knowledge-agent","knowledge-agent"]}},"/agent/trigger/community-detection":{"post":{"description":"Detect topic clusters in the knowledge graph.\n\nGroups related entities into communities and generates AI summaries for each cluster.","operationId":"trigger_community_detection_agent_trigger_community_detection_post","parameters":[{"in":"query","name":"resolution","required":false,"schema":{"default":1,"title":"Resolution","type":"number"}},{"in":"query","name":"generate_ai_summary","required":false,"schema":{"default":true,"title":"Generate Ai Summary","type":"boolean"}},{"in":"query","name":"summary_limit","required":false,"schema":{"anyOf":[{"maximum":200,"minimum":1,"type":"integer"},{"type":"null"}],"title":"Summary Limit"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"title":"Response Trigger Community Detection Agent Trigger Community Detection Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Trigger Community Detection","tags":["knowledge-agent","knowledge-agent"]}},"/agent/trigger/community-detection/plan":{"get":{"description":"Preview a community detection refresh without scheduling work.","operationId":"plan_community_detection_agent_trigger_community_detection_plan_get","parameters":[{"in":"query","name":"resolution","required":false,"schema":{"default":1,"maximum":5,"minimum":0.1,"title":"Resolution","type":"number"}},{"in":"query","name":"generate_ai_summary","required":false,"schema":{"default":true,"title":"Generate Ai Summary","type":"boolean"}},{"in":"query","name":"scan_limit","required":false,"schema":{"default":500,"maximum":2000,"minimum":1,"title":"Scan Limit","type":"integer"}},{"in":"query","name":"summary_limit","required":false,"schema":{"anyOf":[{"maximum":200,"minimum":1,"type":"integer"},{"type":"null"}],"title":"Summary Limit"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Plan Community Detection Agent Trigger Community Detection Plan Get","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Plan Community Detection","tags":["knowledge-agent","knowledge-agent"]}},"/agent/trigger/crystallization":{"post":{"description":"Trigger a crystallization review.\n\nThe agent analyzes recent memories and synthesizes higher-level insights: patterns, recurring themes, and emerging conclusions.","operationId":"trigger_crystallization_agent_trigger_crystallization_post","responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"title":"Response Trigger Crystallization Agent Trigger Crystallization Post","type":"object"}}},"description":"Successful Response"}},"summary":"Trigger Crystallization","tags":["knowledge-agent","knowledge-agent"]}},"/agent/trigger/daily-briefing":{"post":{"description":"Manually trigger a daily briefing.","operationId":"trigger_daily_briefing_agent_trigger_daily_briefing_post","responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"title":"Response Trigger Daily Briefing Agent Trigger Daily Briefing Post","type":"object"}}},"description":"Successful Response"}},"summary":"Trigger Daily Briefing","tags":["knowledge-agent","knowledge-agent"]}},"/agent/trigger/decay-refresh":{"post":{"description":"Recalculate memory relevance scores.\n\nRefreshes the time-based relevance ranking so frequently accessed and recently updated memories surface higher in search results.","operationId":"trigger_decay_refresh_agent_trigger_decay_refresh_post","responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"title":"Response Trigger Decay Refresh Agent Trigger Decay Refresh Post","type":"object"}}},"description":"Successful Response"}},"summary":"Trigger Decay Refresh","tags":["knowledge-agent","knowledge-agent"]}},"/agent/trigger/insight-detection":{"post":{"description":"Manually trigger proactive insight detection.","operationId":"trigger_insight_detection_agent_trigger_insight_detection_post","responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"title":"Response Trigger Insight Detection Agent Trigger Insight Detection Post","type":"object"}}},"description":"Successful Response"}},"summary":"Trigger Insight Detection","tags":["knowledge-agent","knowledge-agent"]}},"/agent/trigger/kg-extraction":{"post":{"description":"Extract entities and relationships from memories.\n\nBuilds the knowledge graph by analyzing memory content. Use `backfill=true`\nto queue the next bounded backfill wave for unprocessed memories, or pass\nspecific `memory_ids` to target individual ones.","operationId":"trigger_kg_extraction_agent_trigger_kg_extraction_post","parameters":[{"in":"query","name":"backfill","required":false,"schema":{"default":false,"title":"Backfill","type":"boolean"}},{"description":"Comma-separated memory IDs for scoped extraction","in":"query","name":"memory_ids","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated memory IDs for scoped extraction","title":"Memory Ids"}},{"in":"query","name":"scan_limit","required":false,"schema":{"anyOf":[{"maximum":2000,"minimum":1,"type":"integer"},{"type":"null"}],"title":"Scan Limit"}},{"in":"query","name":"batch_size","required":false,"schema":{"anyOf":[{"maximum":10,"minimum":1,"type":"integer"},{"type":"null"}],"title":"Batch Size"}},{"description":"When backfill=true, process a bounded repair wave for memories previously marked extracted but carrying no graph facts.","in":"query","name":"repair_empty","required":false,"schema":{"default":false,"description":"When backfill=true, process a bounded repair wave for memories previously marked extracted but carrying no graph facts.","title":"Repair Empty","type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"title":"Response Trigger Kg Extraction Agent Trigger Kg Extraction Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Trigger Kg Extraction","tags":["knowledge-agent","knowledge-agent"]}},"/agent/trigger/kg-extraction/plan":{"get":{"description":"Preview a bounded KG backfill batch without scheduling work.","operationId":"plan_kg_extraction_backfill_agent_trigger_kg_extraction_plan_get","parameters":[{"in":"query","name":"scan_limit","required":false,"schema":{"default":500,"maximum":2000,"minimum":1,"title":"Scan Limit","type":"integer"}},{"in":"query","name":"batch_size","required":false,"schema":{"default":5,"maximum":10,"minimum":1,"title":"Batch Size","type":"integer"}},{"description":"When true, preview a bounded repair wave for memories previously marked extracted but carrying no graph facts.","in":"query","name":"repair_empty","required":false,"schema":{"default":false,"description":"When true, preview a bounded repair wave for memories previously marked extracted but carrying no graph facts.","title":"Repair Empty","type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Plan Kg Extraction Backfill Agent Trigger Kg Extraction Plan Get","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Plan Kg Extraction Backfill","tags":["knowledge-agent","knowledge-agent"]}},"/agent/trigger/label-consolidation":{"post":{"description":"Consolidate duplicate labels across the knowledge graph.\n\nEmbedding finds semantically-similar label pairs (including cross-language),\nan LLM judges which are the same concept, and confirmed duplicates are\nmerged into one (reversible). Pass dry_run=true to preview the LLM's\nproposed merges in the feed event without changing anything.","operationId":"trigger_label_consolidation_agent_trigger_label_consolidation_post","parameters":[{"description":"Preview proposed merges without applying them","in":"query","name":"dry_run","required":false,"schema":{"default":false,"description":"Preview proposed merges without applying them","title":"Dry Run","type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"title":"Response Trigger Label Consolidation Agent Trigger Label Consolidation Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Trigger Label Consolidation","tags":["knowledge-agent","knowledge-agent"]}},"/agent/trigger/memory-cleanup/archive":{"post":{"description":"Archive user-reviewed cleanup candidates after server-side revalidation.\n\nThe client only submits ids from the visible review. The server re-reads the\nsource-of-truth rows and re-runs the cleanup classifier so stale UI state can\nnever archive a memory that was visited, pinned, or otherwise protected after\nthe review was rendered.","operationId":"archive_memory_cleanup_candidates_agent_trigger_memory_cleanup_archive_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryCleanupArchiveRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Archive Memory Cleanup Candidates Agent Trigger Memory Cleanup Archive Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Archive Memory Cleanup Candidates","tags":["knowledge-agent","knowledge-agent"]}},"/agent/trigger/memory-cleanup/compaction":{"post":{"description":"Queue semantic compaction for user-reviewed cleanup candidates.\n\nThis is deliberately not an automatic merge. It re-reads each submitted\nmemory id, re-runs the cleanup classifier, and only queues the bounded\nMemory Compaction task for rows still in the semantic-review lane.","operationId":"queue_memory_cleanup_compaction_agent_trigger_memory_cleanup_compaction_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryCleanupCompactionRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Queue Memory Cleanup Compaction Agent Trigger Memory Cleanup Compaction Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Queue Memory Cleanup Compaction","tags":["knowledge-agent","knowledge-agent"]}},"/agent/trigger/memory-cleanup/keep":{"post":{"description":"Mark user-reviewed cleanup candidates as intentionally kept.\n\nThis is the negative-feedback side of cleanup governance. Dismissing a\nTimeline card should not make Mem ask about the same rows again next week;\nit should become an explicit retention signal on the Memory itself. The\nserver still revalidates each id so changed or hidden rows are skipped.","operationId":"keep_memory_cleanup_candidates_agent_trigger_memory_cleanup_keep_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryCleanupKeepRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Keep Memory Cleanup Candidates Agent Trigger Memory Cleanup Keep Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Keep Memory Cleanup Candidates","tags":["knowledge-agent","knowledge-agent"]}},"/agent/trigger/memory-cleanup/plan":{"get":{"description":"Preview Memory cleanup lanes without queueing or mutating anything.","operationId":"plan_memory_cleanup_agent_trigger_memory_cleanup_plan_get","parameters":[{"in":"query","name":"limit","required":false,"schema":{"default":30,"maximum":100,"minimum":1,"title":"Limit","type":"integer"}},{"in":"query","name":"scan_limit","required":false,"schema":{"default":500,"maximum":5000,"minimum":1,"title":"Scan Limit","type":"integer"}},{"in":"query","name":"space_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Space Id"}},{"in":"query","name":"emit_event","required":false,"schema":{"default":false,"title":"Emit Event","type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Plan Memory Cleanup Agent Trigger Memory Cleanup Plan Get","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Plan Memory Cleanup","tags":["knowledge-agent","knowledge-agent"]}},"/agent/trigger/memory-compaction":{"post":{"description":"Review and merge similar memories.\n\nThe agent scans for memories that cover the same topic and suggests merging duplicates or linking related ones.","operationId":"trigger_memory_compaction_agent_trigger_memory_compaction_post","responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"title":"Response Trigger Memory Compaction Agent Trigger Memory Compaction Post","type":"object"}}},"description":"Successful Response"}},"summary":"Trigger Memory Compaction","tags":["knowledge-agent","knowledge-agent"]}},"/agent/trigger/memory-compaction/plan":{"get":{"description":"Preview the exact compaction candidate context without queueing work.\n\nThis endpoint does not ask the agent to decide, does not create EVOLVES\nedges, does not create crystals, and does not enqueue the compaction task.\nIt exposes the same pre-computed candidate context the scheduled task would\ninject into the Knowledge Agent so evals can measure the real input surface.","operationId":"plan_memory_compaction_agent_trigger_memory_compaction_plan_get","parameters":[{"in":"query","name":"limit","required":false,"schema":{"default":30,"maximum":100,"minimum":1,"title":"Limit","type":"integer"}},{"in":"query","name":"space_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Space Id"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Plan Memory Compaction Agent Trigger Memory Compaction Plan Get","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Plan Memory Compaction","tags":["knowledge-agent","knowledge-agent"]}},"/agent/trigger/memory-created/plan":{"get":{"description":"Preview the next memory-created flush without mutating scheduler state.","operationId":"plan_memory_created_events_agent_trigger_memory_created_plan_get","responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Plan Memory Created Events Agent Trigger Memory Created Plan Get","type":"object"}}},"description":"Successful Response"}},"summary":"Plan Memory Created Events","tags":["knowledge-agent","knowledge-agent"]}},"/agent/trigger/rule-review":{"post":{"description":"Manually trigger learned rule candidate review.\n\nDetection only: suggests draft always-on rules from repeated memory\nevidence. Drafts are not injected into Context Bundle until the user enables\nthem.","operationId":"trigger_guidance_review_agent_trigger_rule_review_post","responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"title":"Response Trigger Guidance Review Agent Trigger Rule Review Post","type":"object"}}},"description":"Successful Response"}},"summary":"Trigger Guidance Review","tags":["knowledge-agent","knowledge-agent"]}},"/agent/trigger/rule-review/dry-run":{"get":{"description":"Preview learned Rule suggestions without writing draft Rules.\n\nThis may call the configured model to judge harvested evidence, but it does\nnot archive stale drafts, write new drafts, enqueue work, or mutate graph\nstate.","operationId":"dry_run_guidance_rule_review_agent_trigger_rule_review_dry_run_get","parameters":[{"in":"query","name":"queries","required":false,"schema":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Queries"}},{"in":"query","name":"memory_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Memory Id"}},{"in":"query","name":"memory_ids","required":false,"schema":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Memory Ids"}},{"in":"query","name":"space_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Space Id"}},{"in":"query","name":"max_evidence_results","required":false,"schema":{"default":40,"maximum":40,"minimum":2,"title":"Max Evidence Results","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Dry Run Guidance Rule Review Agent Trigger Rule Review Dry Run Get","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Dry Run Guidance Rule Review","tags":["knowledge-agent","knowledge-agent"]}},"/agent/trigger/skill-compile":{"post":{"description":"Compile one promoted candidate into a draft skill.\n\nReads the candidate's evidence and writes a SKILL.md bundle, moving the\ncandidate to 'draft' for review. Triggered after the user promotes a candidate.","operationId":"trigger_skill_compile_agent_trigger_skill_compile_post","parameters":[{"in":"query","name":"skill_id","required":true,"schema":{"title":"Skill Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"title":"Response Trigger Skill Compile Agent Trigger Skill Compile Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Trigger Skill Compile","tags":["knowledge-agent","knowledge-agent"]}},"/agent/trigger/skill-review":{"post":{"description":"Manually trigger a skill target review.\n\nSurfaces reusable procedural capabilities from recurring EVOLVES chains as\nskill candidates. Detection only: proposes candidates, never compiles skills.","operationId":"trigger_skill_review_agent_trigger_skill_review_post","responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"title":"Response Trigger Skill Review Agent Trigger Skill Review Post","type":"object"}}},"description":"Successful Response"}},"summary":"Trigger Skill Review","tags":["knowledge-agent","knowledge-agent"]}},"/agent/trigger/thread-synced/plan":{"get":{"description":"Preview the next thread-sync flush without mutating scheduler state.","operationId":"plan_thread_synced_events_agent_trigger_thread_synced_plan_get","parameters":[{"in":"query","name":"max_tasks","required":false,"schema":{"anyOf":[{"maximum":100,"minimum":0,"type":"integer"},{"type":"null"}],"title":"Max Tasks"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Plan Thread Synced Events Agent Trigger Thread Synced Plan Get","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Plan Thread Synced Events","tags":["knowledge-agent","knowledge-agent"]}},"/agent/trigger/unit-type-reclassification":{"post":{"description":"Review weak Memory unit_type metadata.\n\nThis on-demand maintenance task never changes content or embeddings. Apply\nmode updates Kuzu metadata and patches LanceDB filter metadata in place.","operationId":"trigger_unit_type_reclassification_agent_trigger_unit_type_reclassification_post","requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/UnitTypeReclassificationRequest"},{"type":"null"}],"title":"Request"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Trigger Unit Type Reclassification Agent Trigger Unit Type Reclassification Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Trigger Unit Type Reclassification","tags":["knowledge-agent","knowledge-agent"]}},"/agent/trigger/wm-refresh":{"post":{"description":"Queue a bounded Working Memory refresh.\n\nWith memory IDs, this reviews only those memories plus the current Working\nMemory. Without IDs, it is a cheap dispatch/proof run that records the\ncurrent direct path without opening a tool-using agent session.","operationId":"trigger_wm_refresh_agent_trigger_wm_refresh_post","parameters":[{"description":"Optional comma-separated memory IDs to consider.","in":"query","name":"memory_ids","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional comma-separated memory IDs to consider.","title":"Memory Ids"}},{"in":"query","name":"space_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Space Id"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Trigger Wm Refresh Agent Trigger Wm Refresh Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Trigger Wm Refresh","tags":["knowledge-agent","knowledge-agent"]}},"/agent/trigger/{task_type}/context-plan":{"get":{"description":"Preview the context injected into supported scheduled agent tasks.\n\nThis endpoint does not enqueue work, does not run the agent, and does not\nask an LLM to decide. It exposes the actual context prefix produced by the\nruntime injector so evals can audit the live input surface before any prompt\nor cadence changes are claimed as improvements.","operationId":"plan_scheduled_agent_context_agent_trigger__task_type__context_plan_get","parameters":[{"in":"path","name":"task_type","required":true,"schema":{"title":"Task Type","type":"string"}},{"in":"query","name":"space_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Space Id"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Plan Scheduled Agent Context Agent Trigger Task Type Context Plan Get","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Plan Scheduled Agent Context","tags":["knowledge-agent","knowledge-agent"]}},"/agent/working-memory":{"get":{"description":"Read the agent's working memory.\n\nReturns today's working memory by default. Pass a `date` (YYYY-MM-DD) to read an archived day instead.","operationId":"get_working_memory_agent_working_memory_get","parameters":[{"description":"YYYY-MM-DD for archived WM","in":"query","name":"date","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"YYYY-MM-DD for archived WM","title":"Date"}},{"description":"Isolation space to read","in":"query","name":"space_id","required":false,"schema":{"default":"default","description":"Isolation space to read","title":"Space Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Get Working Memory Agent Working Memory Get","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Working Memory","tags":["knowledge-agent","knowledge-agent"]},"put":{"description":"Save changes to the agent's working memory.\n\nContent must include at least a Focus Areas or Briefing section. Maximum 4 KB.","operationId":"update_working_memory_agent_working_memory_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateWorkingMemoryRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Update Working Memory Agent Working Memory Put","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Update Working Memory","tags":["knowledge-agent","knowledge-agent"]}},"/agent/working-memory/history":{"get":{"description":"List dates with archived working memory.\n\nReturns available dates newest-first. Use a specific date with the GET endpoint to read that day's content.","operationId":"get_working_memory_history_agent_working_memory_history_get","parameters":[{"in":"query","name":"limit","required":false,"schema":{"default":30,"maximum":365,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Isolation space to inspect","in":"query","name":"space_id","required":false,"schema":{"default":"default","description":"Isolation space to inspect","title":"Space Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Get Working Memory History Agent Working Memory History Get","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Working Memory History","tags":["knowledge-agent","knowledge-agent"]}},"/capabilities":{"get":{"description":"Server capabilities — unauthenticated, used by clients to adapt UI.\n\nReturns the server version and feature flags. Clients (desktop remote,\nweb /app, mobile) use this to hide features the server cannot support\nor the operator has disabled.","operationId":"capabilities_capabilities_get","responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"}},"summary":"Capabilities","tags":["health"]}},"/communities":{"get":{"description":"List knowledge communities with AI summaries.","operationId":"list_communities_communities_get","parameters":[{"in":"query","name":"limit","required":false,"schema":{"default":20,"maximum":50,"minimum":1,"title":"Limit","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"List Communities","tags":["analytics"]}},"/communities/{community_id}":{"get":{"description":"Get community details including entities and sample memories.","operationId":"get_community_details_communities__community_id__get","parameters":[{"in":"path","name":"community_id","required":true,"schema":{"title":"Community Id","type":"string"}},{"in":"query","name":"entity_limit","required":false,"schema":{"default":20,"maximum":50,"minimum":1,"title":"Entity Limit","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Community Details","tags":["analytics"]}},"/content-store/migration/status":{"get":{"description":"Return the truthful Content Store ownership and migration state.","operationId":"get_content_store_migration_status_content_store_migration_status_get","responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Get Content Store Migration Status Content Store Migration Status Get","type":"object"}}},"description":"Successful Response"}},"summary":"Get Content Store Migration Status","tags":["content-store"]}},"/content-store/thread-messages/cleanup-legacy-graph":{"post":{"description":"Preview or run bounded deletion of legacy Kuzu Message graph rows.","operationId":"cleanup_legacy_thread_message_graph_content_store_thread_messages_cleanup_legacy_graph_post","parameters":[{"in":"query","name":"batch_size","required":false,"schema":{"default":500,"maximum":1000,"minimum":1,"title":"Batch Size","type":"integer"}},{"in":"query","name":"max_batches","required":false,"schema":{"default":100,"maximum":10000,"minimum":1,"title":"Max Batches","type":"integer"}},{"in":"query","name":"dry_run","required":false,"schema":{"default":true,"title":"Dry Run","type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Cleanup Legacy Thread Message Graph Content Store Thread Messages Cleanup Legacy Graph Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Cleanup Legacy Thread Message Graph","tags":["content-store"]}},"/content-store/thread-messages/copy-all":{"post":{"description":"Copy legacy messages in bounded batches without cutting over ownership.","operationId":"copy_thread_messages_until_finished_content_store_thread_messages_copy_all_post","parameters":[{"in":"query","name":"batch_size","required":false,"schema":{"default":500,"maximum":1000,"minimum":1,"title":"Batch Size","type":"integer"}},{"in":"query","name":"max_batches","required":false,"schema":{"default":1000,"maximum":10000,"minimum":1,"title":"Max Batches","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Copy Thread Messages Until Finished Content Store Thread Messages Copy All Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Copy Thread Messages Until Finished","tags":["content-store"]}},"/content-store/thread-messages/copy-batch":{"post":{"description":"Copy one bounded legacy Kuzu Message page into SQLite.","operationId":"copy_thread_messages_batch_content_store_thread_messages_copy_batch_post","parameters":[{"in":"query","name":"batch_size","required":false,"schema":{"default":500,"maximum":1000,"minimum":1,"title":"Batch Size","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Copy Thread Messages Batch Content Store Thread Messages Copy Batch Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Copy Thread Messages Batch","tags":["content-store"]}},"/content-store/thread-messages/cutover":{"post":{"description":"Make SQLite the runtime owner after verification has marked it ready.","operationId":"cut_over_thread_messages_content_store_thread_messages_cutover_post","parameters":[{"in":"query","name":"batch_size","required":false,"schema":{"default":500,"maximum":1000,"minimum":1,"title":"Batch Size","type":"integer"}},{"in":"query","name":"max_batches","required":false,"schema":{"default":1000,"maximum":10000,"minimum":1,"title":"Max Batches","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Cut Over Thread Messages Content Store Thread Messages Cutover Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Cut Over Thread Messages","tags":["content-store"]}},"/content-store/thread-messages/migrate-anchors":{"post":{"description":"Backfill legacy Memory->Message links into SQLite content anchors.","operationId":"migrate_thread_message_anchors_content_store_thread_messages_migrate_anchors_post","parameters":[{"in":"query","name":"batch_size","required":false,"schema":{"default":500,"maximum":1000,"minimum":1,"title":"Batch Size","type":"integer"}},{"in":"query","name":"max_batches","required":false,"schema":{"default":1000,"maximum":10000,"minimum":1,"title":"Max Batches","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Migrate Thread Message Anchors Content Store Thread Messages Migrate Anchors Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Migrate Thread Message Anchors","tags":["content-store"]}},"/content-store/thread-messages/migrate-through-cutover":{"post":{"description":"Run copy, verification, anchor backfill, and non-destructive cutover.","operationId":"migrate_thread_messages_through_cutover_content_store_thread_messages_migrate_through_cutover_post","parameters":[{"in":"query","name":"batch_size","required":false,"schema":{"default":500,"maximum":1000,"minimum":1,"title":"Batch Size","type":"integer"}},{"in":"query","name":"max_batches","required":false,"schema":{"default":1000,"maximum":10000,"minimum":1,"title":"Max Batches","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Migrate Thread Messages Through Cutover Content Store Thread Messages Migrate Through Cutover Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Migrate Thread Messages Through Cutover","tags":["content-store"]}},"/content-store/thread-messages/verify":{"post":{"description":"Verify SQLite contains every legacy message and no orphan thread rows.","operationId":"verify_thread_message_copy_content_store_thread_messages_verify_post","parameters":[{"in":"query","name":"batch_size","required":false,"schema":{"default":500,"maximum":1000,"minimum":1,"title":"Batch Size","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Verify Thread Message Copy Content Store Thread Messages Verify Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Verify Thread Message Copy","tags":["content-store"]}},"/context/bundle":{"get":{"description":"Return the owner/profile/policy/scope context bundle for agents.","operationId":"get_context_bundle_context_bundle_get","parameters":[{"description":"Nowledge agent profile id/slug to resolve.","in":"query","name":"agent_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Nowledge agent profile id/slug to resolve.","title":"Agent Id"}},{"description":"Calling app/source hint, e.g. codex or hermes.","in":"query","name":"source_app","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Calling app/source hint, e.g. codex or hermes.","title":"Source App"}},{"description":"Host-local long-running agent identity, if known.","in":"query","name":"host_agent_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Host-local long-running agent identity, if known.","title":"Host Agent Id"}},{"description":"Memory space id/name to use as the active lane.","in":"query","name":"space_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Memory space id/name to use as the active lane.","title":"Space Id"}},{"description":"Include the current Working Memory preview.","in":"query","name":"include_working_memory","required":false,"schema":{"default":true,"description":"Include the current Working Memory preview.","title":"Include Working Memory","type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Context Bundle","tags":["context","context"]}},"/data/checkpoint":{"post":{"description":"Flush pending changes to disk.\n\nEnsures all recent writes are safely persisted. Called automatically before app updates, but can be triggered manually.","operationId":"checkpoint_data_data_checkpoint_post","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataTransferCheckpointResponse"}}},"description":"Checkpoint result"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataTransferErrorResponse"}}},"description":"Checkpoint failed"}},"summary":"Checkpoint Data","tags":["data-transfer"]}},"/data/export":{"post":{"description":"Export your data to a portable archive.\n\nCreates a .zip (or folder) containing memories, threads, entities, labels, sources, managed skills, and working memory. Use this for backups or migrating to another device.\n\nBy default this endpoint is synchronous for REST and CLI compatibility. Set `async` to `true` to start a background export job and poll `/data/export/status/{job_id}` until the job is completed or reports an error.","operationId":"export_data_data_export_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataExportRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataExportResponse"}}},"description":"Export result or background job"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataTransferErrorResponse"}}},"description":"Another data transfer is already running"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataTransferErrorResponse"}}},"description":"collaboration_transfer_unsupported: retained collaboration history requires a complete authority backup; not retryable"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataTransferErrorResponse"}}},"description":"Export could not be completed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataTransferErrorResponse"}}},"description":"collaboration_storage_failure: collaboration history could not be checked; retryable"}},"summary":"Export Data","tags":["data-transfer"]}},"/data/export/download":{"post":{"description":"Export data as a downloadable zip file.\n\nStreams the zip archive directly to the client. Use this from remote or web clients that cannot write to the server filesystem.","operationId":"export_data_download_data_export_download_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataExportDownloadRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{}},"application/zip":{"schema":{"type":"string"}}},"description":"Portable export archive"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataTransferErrorResponse"}}},"description":"collaboration_transfer_unsupported: retained collaboration history requires a complete authority backup; not retryable"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataTransferErrorResponse"}}},"description":"Export could not be completed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataTransferErrorResponse"}}},"description":"collaboration_storage_failure: collaboration history could not be checked; retryable"}},"summary":"Export Data Download","tags":["data-transfer"]}},"/data/export/status/{job_id}":{"get":{"description":"Check the progress of a background data export job started with `POST /data/export` and `async: true`.","operationId":"get_export_status_data_export_status__job_id__get","parameters":[{"description":"Data transfer job id","in":"path","name":"job_id","required":true,"schema":{"title":"Job Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataImportStatusResponse"}}},"description":"Export job status"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataTransferErrorResponse"}}},"description":"Data transfer job not found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Export Status","tags":["data-transfer"]}},"/data/import":{"post":{"description":"Import data from a previous export.\n\nRuns in the background. Poll `/data/import/status/{job_id}` to check progress. Supports merge (combine with existing), skip (keep existing), or overwrite modes.","operationId":"import_data_data_import_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataImportRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataImportStartResponse"}}},"description":"Import job started"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataTransferErrorResponse"}}},"description":"Another data transfer is already running"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataTransferErrorResponse"}}},"description":"Import could not be started"}},"summary":"Import Data","tags":["data-transfer"]}},"/data/import/preview":{"post":{"description":"Read the backup manifest without creating a restore job or changing destination data. Counts are source declarations, not conflict predictions. Input is not frozen; explicit restore validates it again.","operationId":"openapi_import_preview","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataImportRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataImportPreviewResponse"}}},"description":"Informational backup inventory"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataTransferErrorResponse"}}},"description":"Backup cannot be inspected"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataTransferErrorResponse"}}},"description":"Credential is no longer valid"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataTransferErrorResponse"}}},"description":"Human restore permission is required"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataTransferErrorResponse"}}},"description":"Current authorization is unavailable"}},"summary":"Inspect backup inventory","tags":["data-transfer"]}},"/data/import/status/{job_id}":{"get":{"description":"Check the progress of a data import job.","operationId":"get_import_status_data_import_status__job_id__get","parameters":[{"description":"Data transfer job id","in":"path","name":"job_id","required":true,"schema":{"title":"Job Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataImportStatusResponse"}}},"description":"Import job status"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataTransferErrorResponse"}}},"description":"Data transfer job not found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Import Status","tags":["data-transfer"]}},"/data/import/upload":{"post":{"description":"Import data from an uploaded zip file.\n\nAccepts a multipart file upload and runs the import in the background. Poll `/data/import/status/{job_id}` to check progress. Use this from remote or web clients that cannot access the server filesystem.","operationId":"import_data_upload_data_import_upload_post","requestBody":{"content":{"multipart/form-data":{"schema":{"description":"Multipart body for POST /data/import/upload.","properties":{"file":{"contentMediaType":"application/octet-stream","type":"string"},"include_communities":{"default":true,"type":"boolean"},"include_edges":{"default":true,"type":"boolean"},"include_entities":{"default":true,"type":"boolean"},"include_feed_events":{"default":true,"description":"Include durable Timeline history from feed_events/*.jsonl.","type":"boolean"},"include_labels":{"default":true,"type":"boolean"},"include_memories":{"default":true,"type":"boolean"},"include_messages":{"default":true,"type":"boolean"},"include_skills":{"default":true,"type":"boolean"},"include_source_files":{"default":true,"type":"boolean"},"include_sources":{"default":true,"type":"boolean"},"include_threads":{"default":true,"type":"boolean"},"include_working_memory":{"default":true,"type":"boolean"},"include_working_memory_archive":{"default":true,"type":"boolean"},"mode":{"$ref":"#/components/schemas/DataImportMode"}},"required":["file"],"title":"Body_import_data_upload_data_import_upload_post","type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataImportStartResponse"}}},"description":"Import job started"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataTransferErrorResponse"}}},"description":"Another data transfer is already running"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataTransferErrorResponse"}}},"description":"Upload or import could not be started"}},"summary":"Import Data Upload","tags":["data-transfer"]}},"/data/import/upload/preview":{"post":{"description":"Read the backup manifest without creating a restore job or changing destination data. Counts are source declarations, not conflict predictions. Input is not frozen; explicit restore validates it again.","operationId":"openapi_import_upload_preview","requestBody":{"content":{"multipart/form-data":{"schema":{"description":"Multipart body for POST /data/import/upload.","properties":{"file":{"contentMediaType":"application/octet-stream","type":"string"},"include_communities":{"default":true,"type":"boolean"},"include_edges":{"default":true,"type":"boolean"},"include_entities":{"default":true,"type":"boolean"},"include_feed_events":{"default":true,"description":"Include durable Timeline history from feed_events/*.jsonl.","type":"boolean"},"include_labels":{"default":true,"type":"boolean"},"include_memories":{"default":true,"type":"boolean"},"include_messages":{"default":true,"type":"boolean"},"include_skills":{"default":true,"type":"boolean"},"include_source_files":{"default":true,"type":"boolean"},"include_sources":{"default":true,"type":"boolean"},"include_threads":{"default":true,"type":"boolean"},"include_working_memory":{"default":true,"type":"boolean"},"include_working_memory_archive":{"default":true,"type":"boolean"},"mode":{"$ref":"#/components/schemas/DataImportMode"}},"required":["file"],"title":"Body_import_data_upload_data_import_upload_post","type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataImportPreviewResponse"}}},"description":"Informational backup inventory"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataTransferErrorResponse"}}},"description":"Backup cannot be inspected"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataTransferErrorResponse"}}},"description":"Credential is no longer valid"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataTransferErrorResponse"}}},"description":"Human restore permission is required"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataTransferErrorResponse"}}},"description":"Current authorization is unavailable"}},"summary":"Inspect backup inventory","tags":["data-transfer"]}},"/entities":{"get":{"description":"List entities with optional filtering.\n\nWhen ``include_stats=true`` returns\n``[{\"entity\": EntityNode, \"mention_count\": int}, ...]`` sorted by\nmention_count DESC. Otherwise returns the legacy ``List[EntityNode]``\nsorted by created_at DESC, preserving backwards compatibility for\nolder callers (Tauri commands, MCP tools).","operationId":"list_entities_entities_get","parameters":[{"in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":200,"minimum":1,"title":"Limit","type":"integer"}},{"in":"query","name":"entity_type","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Type"}},{"description":"Return entities sorted by mention_count DESC and include the count alongside each entity. Powers the Library Entities tab's signal-first ranking. When false (default), the response shape is the legacy List[EntityNode].","in":"query","name":"include_stats","required":false,"schema":{"default":false,"description":"Return entities sorted by mention_count DESC and include the count alongside each entity. Powers the Library Entities tab's signal-first ranking. When false (default), the response shape is the legacy List[EntityNode].","title":"Include Stats","type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"List Entities","tags":["entities"]}},"/entities/{entity_id}":{"delete":{"description":"Delete one Entity and its incident graph links without deleting any Memory, Source, Label, or Community. Requires an exact entity-id confirmation.","operationId":"delete_entity_handler","parameters":[{"description":"Entity id","in":"path","name":"entity_id","required":true,"schema":{"type":"string"}},{"description":"Must exactly match the entity id in the path.","in":"query","name":"confirm_entity_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntityMutationResponse"}}},"description":"Entity deleted"},"404":{"description":"Entity not found"},"422":{"description":"Confirmation does not match the entity id"}},"summary":"Delete an entity","tags":["entities"]}},"/entities/{entity_id}/aliases":{"get":{"operationId":"read_entity_aliases_handler","parameters":[{"in":"path","name":"entity_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntityAliasStateSchema"}}},"description":"Current aliases, rejected aliases and revision"},"404":{"description":"Entity missing"},"422":{"description":"Entity metadata cannot be safely corrected"}},"summary":"Read entity aliases","tags":["entities"]},"post":{"description":"Correct aliases with expected_revision and expected_aliases from GET. add explicitly restores rejected aliases; remove persistently rejects them. Neither operation changes entity identity or links.","operationId":"change_entity_aliases_handler","parameters":[{"in":"path","name":"entity_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntityAliasChangeSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntityAliasStateSchema"}}},"description":"Updated alias state"},"403":{"description":"Owner or admin user required"},"404":{"description":"Entity missing"},"409":{"description":"Alias state changed"},"422":{"description":"Invalid alias change"}},"summary":"Correct entity aliases","tags":["entities"]}},"/entities/{entity_id}/delete/preview":{"get":{"description":"Count the graph links that would be detached. Referencing memories are always preserved.","operationId":"preview_entity_delete_handler","parameters":[{"description":"Entity id","in":"path","name":"entity_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntityDeletePlanResponse"}}},"description":"Deletion impact preview"},"404":{"description":"Entity not found"}},"summary":"Preview entity deletion","tags":["entities"]}},"/entities/{entity_id}/merge":{"post":{"description":"Atomically move the source Entity's mentions, aliases, labels, topics, and custom relations to the target, then remove the source. Requires an exact source-id confirmation.","operationId":"merge_entity_handler","parameters":[{"description":"Source entity id","in":"path","name":"entity_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntityMergeRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntityMutationResponse"}}},"description":"Entities merged"},"404":{"description":"Source or target Entity not found"},"422":{"description":"Source, target, or confirmation is invalid"}},"summary":"Merge entities","tags":["entities"]}},"/entities/{entity_id}/merge/preview":{"post":{"description":"Preview moving a duplicate Entity into a canonical target, including mention and custom-relation consolidation.","operationId":"preview_entity_merge_handler","parameters":[{"description":"Source entity id","in":"path","name":"entity_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntityMergeRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntityMergePlanResponse"}}},"description":"Merge impact preview"},"404":{"description":"Source or target Entity not found"},"422":{"description":"Source and target are invalid"}},"summary":"Preview an entity merge","tags":["entities"]}},"/entities/{entity_id}/relationships":{"get":{"description":"Get relationships for a specific entity.\n\nReturns all connected entities and the memories where this entity is mentioned. Use `depth` to control how many hops to traverse.","operationId":"get_entity_relationships_entities__entity_id__relationships_get","parameters":[{"in":"path","name":"entity_id","required":true,"schema":{"title":"Entity Id","type":"string"}},{"description":"Traversal depth for relationships","in":"query","name":"depth","required":false,"schema":{"default":1,"description":"Traversal depth for relationships","maximum":3,"minimum":1,"title":"Depth","type":"integer"}},{"description":"Maximum relationships to return","in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Maximum relationships to return","maximum":200,"minimum":1,"title":"Limit","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntityRelationshipsResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Entity Relationships","tags":["entities"]}},"/events/stream":{"get":{"description":"Server-Sent Events stream for real-time updates.\n\nEmits data-change, progress, and stage events as they occur.\nConnect using the browser EventSource API or any SSE client.","operationId":"event_stream_events_stream_get","responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"}},"summary":"Event Stream","tags":["events","events"]}},"/favorites/memories":{"get":{"description":"Get all favorite memories.","operationId":"get_favorite_memories_favorites_memories_get","parameters":[{"in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":100,"minimum":1,"title":"Limit","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/MemoryPublic"},"title":"Response Get Favorite Memories Favorites Memories Get","type":"array"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Favorite Memories","tags":["memories"]}},"/favorites/threads":{"get":{"description":"Get all favorite threads.","operationId":"get_favorite_threads_favorites_threads_get","parameters":[{"in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":100,"minimum":1,"title":"Limit","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/nowledge_graph_server__models__memories_api__ThreadPublic"},"title":"Response Get Favorite Threads Favorites Threads Get","type":"array"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Favorite Threads","tags":["memories"]}},"/fs/capabilities":{"get":{"description":"Return the machine-readable Nowledge FS contract.","operationId":"fs_capabilities_fs_capabilities_get","responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"}},"summary":"Fs Capabilities","tags":["files","files"]}},"/fs/cat":{"get":{"description":"Return the rendered body of a Nowledge FS file.\n\nFor ``.md`` files this returns YAML-frontmatter markdown. For\n``messages.jsonl`` it returns one JSON object per line. Fragment\nselectors (``:page/N``, ``:section/``, etc.) are documented in\nthe design doc but land in Phase 2; passing one returns\nENOTSUP for now. ``line`` / ``lines`` are Phase 1 progressive-read\ncontrols for agents: they work for every rendered text body, including\nthread ``messages.jsonl`` where one line is one message.","operationId":"fs_cat_fs_cat_get","parameters":[{"description":"Nowledge FS file path","in":"query","name":"path","required":true,"schema":{"description":"Nowledge FS file path","title":"Path","type":"string"}},{"description":"One-based line to start reading from","in":"query","name":"line","required":false,"schema":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"description":"One-based line to start reading from","title":"Line"}},{"description":"Number of lines to return","in":"query","name":"lines","required":false,"schema":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"description":"Number of lines to return","title":"Lines"}},{"description":"Fragment selector (page|section|sheet|slide|chunk) — Phase 2","in":"query","name":"fragment","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Fragment selector (page|section|sheet|slide|chunk) — Phase 2","title":"Fragment"}},{"description":"For .source.* files: return original bytes (501 in Phase 1)","in":"query","name":"raw","required":false,"schema":{"default":false,"description":"For .source.* files: return original bytes (501 in Phase 1)","title":"Raw","type":"boolean"}},{"description":"Agent identity id/slug for /context/* files","in":"query","name":"agent_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Agent identity id/slug for /context/* files","title":"Agent Id"}},{"description":"Calling app provenance hint for /context/* files","in":"query","name":"source_app","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Calling app provenance hint for /context/* files","title":"Source App"}},{"description":"Host-local long-running agent id for /context/* files","in":"query","name":"host_agent_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Host-local long-running agent id for /context/* files","title":"Host Agent Id"}},{"description":"Active space override for /context/* files","in":"query","name":"space_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Active space override for /context/* files","title":"Space Id"}},{"description":"Include Working Memory preview in /context/* files","in":"query","name":"include_working_memory","required":false,"schema":{"default":true,"description":"Include Working Memory preview in /context/* files","title":"Include Working Memory","type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Fs Cat","tags":["files","files"]}},"/fs/delete":{"post":{"description":"A nonblank body Space wins over the ambient header. Explicit references\nmust resolve to a registered Space. A foreign or moved target is not found;\nan unscoped path still binds the target Space observed during preflight.\nWorking Memory deletion remains unsupported. Space selection is not a grant.","operationId":"fs_delete_fs_delete_post","parameters":[{"description":"Ambient Space when the body omits it.","in":"header","name":"X-Nmem-Space-Id","required":false,"schema":{"type":["string","null"]}},{"description":"Legacy ambient header; the canonical header takes precedence.","in":"header","name":"X-Nowledge-Space-Id","required":false,"schema":{"type":["string","null"]}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FSDeleteRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Authoritative deletion succeeded; index_repair_pending reports deferred search delivery."},"400":{"content":{"application/json":{"schema":{}},"text/plain":{"schema":{"type":"string"}}},"description":"Malformed JSON or invalid canonical path."},"403":{"description":"Caller authority denied (KFS EACCES) or a derived path is read-only (KFS EROFS)."},"404":{"description":"Target missing or outside the selected/observed Space (KFS ENOENT)."},"409":{"description":"An alias is read-only; use an exact canonical path (KFS EXDEV)."},"422":{"content":{"application/json":{"schema":{}},"text/plain":{"schema":{"type":"string"}}},"description":"Invalid typed request (plain text) or unknown explicit Space (KFS JSON)."},"500":{"description":"Authority state or graph storage unavailable."},"501":{"description":"Path type does not support deletion (KFS ENOTSUP)."}},"summary":"Delete a canonical Memory or Crystal path in its selected Space.","tags":["files"]}},"/fs/find":{"get":{"description":"Structural / metadata search. Returns paths.\n\nPhase 1 covers ``type``, ``unit_type``, ``label``, ``since``, ``until``,\nand ``mentions`` over ``/memories``. ``unit_type`` is also inferred from\n``/memories/by-type/``. Other roots return an empty result so\ncallers can compose without errors.","operationId":"fs_find_fs_find_get","parameters":[{"description":"Nowledge FS path scope (e.g. '/memories')","in":"query","name":"path","required":false,"schema":{"default":"/memories","description":"Nowledge FS path scope (e.g. '/memories')","title":"Path","type":"string"}},{"description":"Filter by file type: memory | crystal","in":"query","name":"type","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by file type: memory | crystal","title":"Type"}},{"description":"Filter memories by unit type; also inferred from /memories/by-type/ paths","in":"query","name":"unit_type","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter memories by unit type; also inferred from /memories/by-type/ paths","title":"Unit Type"}},{"description":"Filter by label name","in":"query","name":"label","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by label name","title":"Label"}},{"description":"Lower record-time bound (YYYY-MM-DD or ISO8601)","in":"query","name":"since","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Lower record-time bound (YYYY-MM-DD or ISO8601)","title":"Since"}},{"description":"Upper record-time bound (YYYY-MM-DD or ISO8601)","in":"query","name":"until","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Upper record-time bound (YYYY-MM-DD or ISO8601)","title":"Until"}},{"description":"Filter memories that MENTION this entity name","in":"query","name":"mentions","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter memories that MENTION this entity name","title":"Mentions"}},{"in":"query","name":"limit","required":false,"schema":{"default":200,"maximum":1000,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Opaque pagination cursor","in":"query","name":"cursor","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque pagination cursor","title":"Cursor"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Fs Find","tags":["files","files"]}},"/fs/grep":{"get":{"description":"Content search. Returns ``path:line:match`` shaped hits.\n\nPreview space contract: graph-wide projection. Phase 1 covers\nmemory/crystal bodies, thread messages, and parsed Library documents.\nMemory grep can be narrowed with ``unit_type`` or a\n``/memories/by-type/`` path.","operationId":"fs_grep_fs_grep_get","parameters":[{"description":"Fixed string or regex pattern to find","in":"query","name":"q","required":true,"schema":{"description":"Fixed string or regex pattern to find","minLength":1,"title":"Q","type":"string"}},{"description":"Nowledge FS path scope. Supports /memories, /threads, and /sources in this preview.","in":"query","name":"path","required":false,"schema":{"default":"/memories","description":"Nowledge FS path scope. Supports /memories, /threads, and /sources in this preview.","title":"Path","type":"string"}},{"description":"Filter memory grep by unit type; also inferred from /memories/by-type/ paths","in":"query","name":"unit_type","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter memory grep by unit type; also inferred from /memories/by-type/ paths","title":"Unit Type"}},{"in":"query","name":"limit","required":false,"schema":{"default":200,"maximum":1000,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Opaque pagination cursor","in":"query","name":"cursor","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque pagination cursor","title":"Cursor"}},{"description":"When false, treat q as a regular expression","in":"query","name":"literal","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"When false, treat q as a regular expression","title":"Literal"}},{"description":"Treat q as a regular expression","in":"query","name":"regex","required":false,"schema":{"default":false,"description":"Treat q as a regular expression","title":"Regex","type":"boolean"}},{"description":"Match without regard to case; true by default","in":"query","name":"ignore_case","required":false,"schema":{"default":true,"description":"Match without regard to case; true by default","title":"Ignore Case","type":"boolean"}},{"description":"Force case-sensitive matching","in":"query","name":"case_sensitive","required":false,"schema":{"default":false,"description":"Force case-sensitive matching","title":"Case Sensitive","type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Fs Grep","tags":["files","files"]}},"/fs/ls":{"get":{"description":"List a directory in Nowledge FS.\n\nPreview space contract: graph-wide projection. Pass ``cursor`` to fetch\nthe next page; agents should not peek inside the cursor payload (it's an\nopaque base64-JSON). The explicit ``/spaces/...`` lens is deferred.","operationId":"fs_ls_fs_ls_get","parameters":[{"description":"Nowledge FS path (e.g. '/memories/by-label/decisions')","in":"query","name":"path","required":false,"schema":{"default":"/","description":"Nowledge FS path (e.g. '/memories/by-label/decisions')","title":"Path","type":"string"}},{"description":"Opaque pagination cursor","in":"query","name":"cursor","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque pagination cursor","title":"Cursor"}},{"in":"query","name":"limit","required":false,"schema":{"default":200,"maximum":1000,"minimum":1,"title":"Limit","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Fs Ls","tags":["files","files"]}},"/fs/recall":{"get":{"description":"Semantic memory search. Returns paths, not search hits.\n\nReuses the existing hybrid search pipeline (the one AI Now and\nLibrary already drive) so there's no second index. Preview recall is\nmemory-backed; use ``grep`` for exact search in threads and sources.\nMemory recall can be narrowed with ``unit_type`` or a\n``/memories/by-type/`` path.\nResults are\nmaterialised as canonical Nowledge FS paths so the caller can pipe them\nstraight into ``cat``.","operationId":"fs_recall_fs_recall_get","parameters":[{"description":"Semantic query text","in":"query","name":"query","required":true,"schema":{"description":"Semantic query text","minLength":1,"title":"Query","type":"string"}},{"description":"Memory subtree to search; non-memory roots return no hits in preview","in":"query","name":"path","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Memory subtree to search; non-memory roots return no hits in preview","title":"Path"}},{"description":"Filter semantic recall by memory unit type; also inferred from /memories/by-type/ paths","in":"query","name":"unit_type","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter semantic recall by memory unit type; also inferred from /memories/by-type/ paths","title":"Unit Type"}},{"description":"How many results to return","in":"query","name":"k","required":false,"schema":{"default":20,"description":"How many results to return","maximum":100,"minimum":1,"title":"K","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Fs Recall","tags":["files","files"]}},"/fs/stat":{"get":{"description":"Return metadata for a Nowledge FS path.\n\nMirrors ``stat(2)`` shape with Mem extras: labels, mention count,\nback-reference count, importance. Preview space contract: graph-wide\nprojection, with each file returning its concrete ``space_id`` metadata.","operationId":"fs_stat_fs_stat_get","parameters":[{"description":"Nowledge FS path","in":"query","name":"path","required":true,"schema":{"description":"Nowledge FS path","title":"Path","type":"string"}},{"description":"Agent identity id/slug for /context/* files","in":"query","name":"agent_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Agent identity id/slug for /context/* files","title":"Agent Id"}},{"description":"Calling app provenance hint for /context/* files","in":"query","name":"source_app","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Calling app provenance hint for /context/* files","title":"Source App"}},{"description":"Host-local long-running agent id for /context/* files","in":"query","name":"host_agent_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Host-local long-running agent id for /context/* files","title":"Host Agent Id"}},{"description":"Active space override for /context/* files","in":"query","name":"space_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Active space override for /context/* files","title":"Space Id"}},{"description":"Include Working Memory preview in /context/* files","in":"query","name":"include_working_memory","required":false,"schema":{"default":true,"description":"Include Working Memory preview in /context/* files","title":"Include Working Memory","type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Fs Stat","tags":["files","files"]}},"/fs/write":{"post":{"description":"Write a canonical Nowledge FS file.\n\nWrites through the same concrete-space APIs as the underlying surface.\nThis bounded Phase 2 slice supports canonical\nmemory files under ``/memories/by-id/`` and\n``/working-memory/today.md``. Alias paths return ``EXDEV`` and\nderived paths return ``EROFS``.","operationId":"fs_write_fs_write_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FSWriteRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Fs Write","tags":["files","files"]}},"/graph/analysis":{"get":{"description":"Get comprehensive graph analysis including community and centrality metrics.\n\nThis endpoint provides a complete overview of the graph structure, communities,\nand centrality measures without triggering new calculations.","operationId":"get_graph_analysis_graph_analysis_get","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GraphAnalysisResponseModel"}}},"description":"Successful Response"}},"summary":"Get Graph Analysis","tags":["graph-analysis"]}},"/graph/augmentation/jobs":{"get":{"description":"List recent augmentation jobs.\n\nOptionally filter by status (pending, running, completed, failed).","operationId":"list_augmentation_jobs_graph_augmentation_jobs_get","parameters":[{"in":"query","name":"limit","required":false,"schema":{"default":10,"maximum":500,"minimum":1,"title":"Limit","type":"integer"}},{"in":"query","name":"status_filter","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status Filter"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AugmentationJobListResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"List Augmentation Jobs","tags":["graph-analysis"]}},"/graph/augmentation/pagerank/plan":{"get":{"description":"Preview a PageRank refresh without scheduling graph augmentation work.","operationId":"plan_pagerank_refresh_graph_augmentation_pagerank_plan_get","parameters":[{"in":"query","name":"force","required":false,"schema":{"default":false,"title":"Force","type":"boolean"}},{"in":"query","name":"min_nodes","required":false,"schema":{"default":2,"maximum":1000,"minimum":1,"title":"Min Nodes","type":"integer"}},{"in":"query","name":"min_edges","required":false,"schema":{"default":1,"maximum":1000000,"minimum":0,"title":"Min Edges","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Plan Pagerank Refresh Graph Augmentation Pagerank Plan Get","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Plan Pagerank Refresh","tags":["graph-analysis"]}},"/graph/augmentation/start":{"post":{"description":"Start a background graph analysis job.\n\nSupported job types:\n- **community_detection** group related entities into topic clusters.\n- **community_summary_enrichment** write missing topic summaries without\n rebuilding topic structure.\n- **pagerank_calculation** calculate entity importance scores.\n- **undo_community_detection** / **undo_pagerank_calculation** remove previous analysis results.","operationId":"start_augmentation_job_graph_augmentation_start_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AugmentationStartRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AugmentationJobStartResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Start Augmentation Job","tags":["graph-analysis"]}},"/graph/augmentation/state":{"get":{"description":"Get the current graph augmentation state.\n\nReturns information about which augmentations are currently applied,\ntheir parameters, and the last augmentation timestamp.","operationId":"get_augmentation_state_graph_augmentation_state_get","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AugmentationStateModel"}}},"description":"Successful Response"}},"summary":"Get Augmentation State","tags":["graph-analysis"]}},"/graph/augmentation/status/{job_id}":{"get":{"description":"Get the status of a specific augmentation job.\n\nReturns job progress, status, and any error messages.","operationId":"get_job_status_graph_augmentation_status__job_id__get","parameters":[{"in":"path","name":"job_id","required":true,"schema":{"title":"Job Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AugmentationJobStatusResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Job Status","tags":["graph-analysis"]}},"/graph/community-members/{community_id}":{"get":{"description":"Get all nodes belonging to a community.","operationId":"get_community_members_graph_community_members__community_id__get","parameters":[{"in":"path","name":"community_id","required":true,"schema":{"title":"Community Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Community Members","tags":["graph-analysis"]}},"/graph/expand/{node_id}":{"get":{"description":"Expand neighbors of a specific node to get connected nodes and edges with depth-based traversal.","operationId":"expand_neighbors_graph_expand__node_id__get","parameters":[{"in":"path","name":"node_id","required":true,"schema":{"title":"Node Id","type":"string"}},{"description":"Expansion depth","in":"query","name":"depth","required":false,"schema":{"default":1,"description":"Expansion depth","maximum":5,"minimum":1,"title":"Depth","type":"integer"}},{"description":"Maximum neighbors to return","in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Maximum neighbors to return","maximum":100,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Include metadata in results","in":"query","name":"include_metadata","required":false,"schema":{"default":true,"description":"Include metadata in results","title":"Include Metadata","type":"boolean"}},{"description":"Optional memory space lens for the graph","in":"query","name":"space_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional memory space lens for the graph","title":"Space Id"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpandNeighborsResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Expand Neighbors","tags":["graph-analysis"]}},"/graph/explore":{"get":{"description":"Build a visualization-ready graph neighborhood around one or more memory IDs.","operationId":"explore_graph_graph_explore_get","parameters":[{"description":"Comma-separated memory IDs to explore as graph seeds","in":"query","name":"memory_ids","required":true,"schema":{"description":"Comma-separated memory IDs to explore as graph seeds","minLength":1,"title":"Memory Ids","type":"string"}},{"description":"Traversal depth for graph expansion around the seed memories","in":"query","name":"depth","required":false,"schema":{"default":1,"description":"Traversal depth for graph expansion around the seed memories","maximum":5,"minimum":1,"title":"Depth","type":"integer"}},{"description":"Maximum path rows to inspect when building the graph neighborhood","in":"query","name":"limit","required":false,"schema":{"default":100,"description":"Maximum path rows to inspect when building the graph neighborhood","maximum":300,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Optional memory space lens for the graph","in":"query","name":"space_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional memory space lens for the graph","title":"Space Id"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GraphDataResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Explore Graph","tags":["graph-analysis"]}},"/graph/health":{"get":{"description":"Health check for graph analysis.\n\nReturns whether graph analysis features (community detection, importance scoring) are available.","operationId":"graph_analysis_health_graph_health_get","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GraphAnalysisHealthCheckModel"}}},"description":"Successful Response"}},"summary":"Graph Analysis Health","tags":["graph-analysis"]}},"/graph/identity-sample":{"get":{"description":"Connected sample of the main graph grown from identity nodes. Labs feature: 404 unless Labs → Identity graph is on.\n\nSeeds the best-connected identities (Entities carrying an identity profile), expands over every relationship for a few hops, and joins separate components by whole shortest paths inside the Space. Never more than `limit` nodes; metadata.clipped reports when neighbors or joins were left out. With a Space, PARTICIPATED edges (identity → conversation) are computed from message records when read, with roles and evidence in edge metadata; nothing is stored for them. Same node and edge shape as /graph/overview; identity nodes carry metadata.identity.","operationId":"get_identity_sample_graph_identity_sample_get","parameters":[{"description":"Optional memory space lens for the graph","in":"query","name":"space_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional memory space lens for the graph","title":"Space Id"}},{"description":"Identity nodes to seed the sample from","in":"query","name":"n","required":false,"schema":{"default":20,"maximum":100,"minimum":1,"title":"N","type":"integer"}},{"description":"Hops to expand from the seeds","in":"query","name":"hops","required":false,"schema":{"default":2,"maximum":4,"minimum":1,"title":"Hops","type":"integer"}},{"description":"Maximum nodes in the sample","in":"query","name":"limit","required":false,"schema":{"default":300,"maximum":1000,"minimum":20,"title":"Limit","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Identity Sample","tags":["graph-analysis"]}},"/graph/live-preview":{"get":{"description":"Get a compact merged 1-hop graph for feed/live preview surfaces.","operationId":"get_live_preview_graph_graph_live_preview_get","parameters":[{"description":"Comma-separated memory IDs to preview as graph seeds","in":"query","name":"node_ids","required":true,"schema":{"description":"Comma-separated memory IDs to preview as graph seeds","minLength":1,"title":"Node Ids","type":"string"}},{"description":"Maximum direct neighbors to include for each seed node","in":"query","name":"limit_per_seed","required":false,"schema":{"default":5,"description":"Maximum direct neighbors to include for each seed node","maximum":20,"minimum":1,"title":"Limit Per Seed","type":"integer"}},{"description":"Optional memory space lens for the graph","in":"query","name":"space_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional memory space lens for the graph","title":"Space Id"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GraphDataResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Live Preview Graph","tags":["graph-analysis"]}},"/graph/live-preview/{node_id}":{"get":{"description":"Get a compact 1-hop neighborhood for feed/live preview surfaces.\n\nUnlike `expand_neighbors`, this path intentionally avoids path\nmaterialization and returns only direct neighbor rows plus connecting edges.","operationId":"get_live_preview_neighbors_graph_live_preview__node_id__get","parameters":[{"in":"path","name":"node_id","required":true,"schema":{"title":"Node Id","type":"string"}},{"description":"Maximum direct neighbors to return","in":"query","name":"limit","required":false,"schema":{"default":20,"description":"Maximum direct neighbors to return","maximum":50,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Include metadata in results","in":"query","name":"include_metadata","required":false,"schema":{"default":true,"description":"Include metadata in results","title":"Include Metadata","type":"boolean"}},{"description":"Optional memory space lens for the graph","in":"query","name":"space_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional memory space lens for the graph","title":"Space Id"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpandNeighborsResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Live Preview Neighbors","tags":["graph-analysis"]}},"/graph/node-details/{node_id}":{"get":{"description":"Lazy-load full node details (properties, neighbors).","operationId":"get_node_details_graph_node_details__node_id__get","parameters":[{"in":"path","name":"node_id","required":true,"schema":{"title":"Node Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Node Details","tags":["graph-analysis"]}},"/graph/orphans":{"delete":{"description":"Remove all unconnected entities.\n\nDeletes entities that have no relationships to memories or other entities. Only affects isolated entities; your memories, labels, and communities are never touched.","operationId":"cleanup_orphaned_entities_graph_orphans_delete","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CleanupOrphansResponse"}}},"description":"Successful Response"}},"summary":"Cleanup Orphaned Entities","tags":["graph-analysis"]},"get":{"description":"Find entities with no connections.\n\nLists entities that aren't linked to any memory or other entity. These are safe to clean up without losing meaningful knowledge.","operationId":"find_orphaned_entities_graph_orphans_get","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrphanedEntitiesResponse"}}},"description":"Successful Response"}},"summary":"Find Orphaned Entities","tags":["graph-analysis"]}},"/graph/overview":{"get":{"description":"Lightweight full-graph endpoint for overview visualization.\n\nReturns all graph-overview node types (Entity, Memory, Source, Thread, Skill)\nwith minimal data (no content, no metadata, no messages) for fast full-graph\nrendering.","operationId":"get_graph_overview_graph_overview_get","parameters":[{"in":"query","name":"limit","required":false,"schema":{"default":500,"maximum":2000,"minimum":10,"title":"Limit","type":"integer"}},{"description":"Optional memory space lens for the graph","in":"query","name":"space_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional memory space lens for the graph","title":"Space Id"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Graph Overview","tags":["graph-analysis"]}},"/graph/sample":{"get":{"description":"Get a sample of the knowledge graph.\n\nReturns a representative subset of nodes and edges for visualization. Useful for exploring the graph without a specific query.","operationId":"get_graph_data_graph_sample_get","parameters":[{"in":"query","name":"filter_type","required":false,"schema":{"title":"Filter Type","type":"string"}},{"in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":500,"minimum":10,"title":"Limit","type":"integer"}},{"description":"Traversal depth for relationships","in":"query","name":"depth","required":false,"schema":{"default":1,"description":"Traversal depth for relationships","maximum":5,"minimum":1,"title":"Depth","type":"integer"}},{"description":"Optional memory space lens for the graph","in":"query","name":"space_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional memory space lens for the graph","title":"Space Id"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GraphDataResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Graph Data","tags":["graph-analysis"]}},"/graph/search":{"get":{"description":"Search the knowledge graph.\n\nFinds memories matching your query and returns them with their connections as visualization-ready graph data.","operationId":"search_graph_graph_search_get","parameters":[{"description":"Search query","in":"query","name":"query","required":true,"schema":{"description":"Search query","title":"Query","type":"string"}},{"in":"query","name":"limit","required":false,"schema":{"default":30,"maximum":100,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Traversal depth for graph search","in":"query","name":"depth","required":false,"schema":{"default":2,"description":"Traversal depth for graph search","maximum":5,"minimum":1,"title":"Depth","type":"integer"}},{"description":"Filter by node types","in":"query","name":"node_types","required":false,"schema":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Filter by node types","title":"Node Types"}},{"description":"Filter by edge types","in":"query","name":"edge_types","required":false,"schema":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Filter by edge types","title":"Edge Types"}},{"description":"Include metadata in results","in":"query","name":"include_metadata","required":false,"schema":{"default":true,"description":"Include metadata in results","title":"Include Metadata","type":"boolean"}},{"description":"Optional memory space lens for the graph","in":"query","name":"space_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional memory space lens for the graph","title":"Space Id"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GraphSearchResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Search Graph","tags":["graph-analysis"]}},"/graph/shortest-path":{"get":{"description":"Find all shortest paths between two nodes using KuzuDB ALL SHORTEST.\n\nNote: KuzuDB does not support parameter binding in recursive relationship\nbounds, so max_depth is interpolated as a validated literal (ge=2, le=20).\n\nReturns all shortest paths (same hop count, different routes) so the\nfrontend can render every connection between the two nodes. The overview\ngraph may not contain all intermediate nodes, so paths are drawn between\nvisible positions.","operationId":"get_shortest_path_graph_shortest_path_get","parameters":[{"description":"Source node ID","in":"query","name":"from_id","required":true,"schema":{"description":"Source node ID","title":"From Id","type":"string"}},{"description":"Target node ID","in":"query","name":"to_id","required":true,"schema":{"description":"Target node ID","title":"To Id","type":"string"}},{"in":"query","name":"max_depth","required":false,"schema":{"default":10,"maximum":20,"minimum":2,"title":"Max Depth","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Shortest Path","tags":["graph-analysis"]}},"/graph/vis":{"get":{"description":"Embeddable interactive graph explorer.\n\nReturns a self-contained HTML page with an interactive knowledge graph\nvisualization. The page fetches data from the REST API on load, so it\nworks standalone in any browser or embedded in your application via an\niframe.\n\n**Modes** (pick one, or omit all for a random sample):\n\n- `?query=React` search for memories matching \"React\" and visualize their connections.\n- `?memory_ids=abc,def` explore the neighborhood around specific memories.\n- *(no params)* show a random sample of the graph.\n\n**Embedding:** set `search_bar=false` to hide the top search bar for\na cleaner look when embedding in an iframe or dashboard.","operationId":"graph_vis_graph_vis_get","parameters":[{"description":"Search query to filter memories and show their connections.","in":"query","name":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Search query to filter memories and show their connections.","title":"Query"}},{"description":"Comma-separated memory IDs to explore their neighborhood.","in":"query","name":"memory_ids","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated memory IDs to explore their neighborhood.","title":"Memory Ids"}},{"description":"How many hops to traverse from each seed node.","in":"query","name":"depth","required":false,"schema":{"default":2,"description":"How many hops to traverse from each seed node.","maximum":5,"minimum":1,"title":"Depth","type":"integer"}},{"description":"Maximum number of nodes to return.","in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Maximum number of nodes to return.","maximum":300,"minimum":10,"title":"Limit","type":"integer"}},{"description":"Show the search bar. Set to false for clean embedding (e.g. iframe).","in":"query","name":"search_bar","required":false,"schema":{"default":true,"description":"Show the search bar. Set to false for clean embedding (e.g. iframe).","title":"Search Bar","type":"boolean"}}],"responses":{"200":{"content":{"text/html":{"schema":{"type":"string"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Graph Vis","tags":["graph-analysis"]}},"/health":{"get":{"description":"Health check endpoint.","operationId":"health_check_health_get","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}},"description":"Successful Response"}},"summary":"Health Check","tags":["health"]}},"/health/checkpoint":{"post":{"description":"Force a database checkpoint.\n\nFlushes pending writes before app updates.","operationId":"force_checkpoint_health_checkpoint_post","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataTransferCheckpointResponse"}}},"description":"Checkpoint result"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataTransferErrorResponse"}}},"description":"Checkpoint failed"}},"summary":"Force Checkpoint","tags":["health"]}},"/identity/profiles":{"get":{"description":"Use the target server's normal authentication and an explicit exact Space ID. No cross-Space fallback is performed. Requires current read authority. Returns independently enrolled profiles for this Space; matching names do not imply the same person. Reading does not invoke a model.","operationId":"get_identity_profiles","parameters":[{"in":"query","name":"space_id","required":true,"schema":{"description":"Exact Space ID. Pass explicitly; this operation does not infer the active Space or broaden to other Spaces.","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/IdentityProfile"},"type":"array"}}},"description":"Current committed identity data."},"400":{"description":"Malformed path or query; framework validation may return plain text."},"401":{"description":"Authentication is required by the target server."},"403":{"description":"Current actor, credential or Space authority denies this operation. Identity-specific denials use IdentityOperationError; earlier authentication gates may use their generic error format."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityOperationError"}}},"description":"The Memory, profile or Space is unavailable to this operation."},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityOperationError"}}},"description":"A current-state, capacity or concurrency condition prevents the operation. Inspect error_code; not every conflict means stale evidence."},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityOperationError"}}},"description":"Source, snapshot or profile payload exceeds the bounded operation limit."},"422":{"description":"Invalid request keys, selection or profile. Identity validation uses IdentityOperationError; malformed JSON or DTO decoding may return a framework validation response."},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityOperationError"}}},"description":"Storage or worker failure."},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityOperationError"}}},"description":"Current authorization, storage or model admission is unavailable."}},"summary":"List identity profiles","tags":["memories"]},"post":{"description":"Use the target server's normal authentication and an explicit exact Space ID. No cross-Space fallback is performed. Requires a human actor with current write authority. To create, send id: null and expected_revision: null (or omit expected_revision). To update, send both the existing ID and its current revision. Creation never coalesces profiles by name. The Space supports at most 100 profiles; bounded pending changes can reject further edits. Linking a subject is optional; omitting subject keeps any existing link. Saving queues selective background replay and may lead to later model use, but this request does not make an inline model call.","operationId":"save_identity_profile","requestBody":{"content":{"application/json":{"examples":{"create":{"summary":"Create a distinct profile","value":{"aliases":[],"context":"Reviews the design","expected_revision":null,"id":null,"kind":"human","name":"Alice","space_id":"engineering"}},"update":{"summary":"Edit using the revision returned by a read","value":{"aliases":["A."],"context":"Reviews the design","expected_revision":1,"id":"profile-id-from-this-server","kind":"human","name":"Alice","space_id":"engineering"}}},"schema":{"$ref":"#/components/schemas/IdentityProfileWrite"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityProfile"}}},"description":"Current committed identity data."},"400":{"description":"Malformed path or query; framework validation may return plain text."},"401":{"description":"Authentication is required by the target server."},"403":{"description":"Current actor, credential or Space authority denies this operation. Identity-specific denials use IdentityOperationError; earlier authentication gates may use their generic error format."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityOperationError"}}},"description":"The Memory, profile, Space or linked AI Identity/member is unavailable to this operation."},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityOperationError"}}},"description":"A current-state, capacity or concurrency condition prevents the operation, including a subject already linked to another profile in this Space. Inspect error_code; not every conflict means stale evidence."},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityOperationError"}}},"description":"Source, snapshot or profile payload exceeds the bounded operation limit."},"422":{"description":"Invalid request keys, selection or profile. Identity validation uses IdentityOperationError; malformed JSON or DTO decoding may return a framework validation response."},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityOperationError"}}},"description":"Storage or worker failure."},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityOperationError"}}},"description":"Current authorization, storage or model admission is unavailable."}},"summary":"Create or update an identity profile","tags":["memories"]}},"/identity/profiles/remove":{"post":{"description":"$2d9","operationId":"remove_identity_profile","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityProfileRemove"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityProfileRemoved"}}},"description":"The removal is committed."},"400":{"description":"Malformed path or query; framework validation may return plain text."},"401":{"description":"Authentication is required by the target server."},"403":{"description":"The actor, credential or Space authority denies this operation, or starting a new removal is disabled (feature_disabled). Identity-specific denials use IdentityOperationError; earlier authentication and feature gates may use their generic error format."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityOperationError"}}},"description":"The Memory, profile, Space or linked AI Identity/member is unavailable to this operation."},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityOperationError"}}},"description":"A current-state, capacity or concurrency condition prevents the operation, including a subject already linked to another profile in this Space. Inspect error_code; not every conflict means stale evidence."},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityOperationError"}}},"description":"Source, snapshot or profile payload exceeds the bounded operation limit."},"422":{"description":"Invalid request keys, selection or profile. Identity validation uses IdentityOperationError; malformed JSON or DTO decoding may return a framework validation response."},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityOperationError"}}},"description":"Storage or worker failure."},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityOperationError"}}},"description":"Current authorization, storage or model admission is unavailable."}},"summary":"Remove an identity profile","tags":["memories"]}},"/labels":{"get":{"description":"List labels with usage counts.\n\nPaginate with ``offset`` to read past the first ``limit`` rows; the\nvocabulary can exceed a single page (the prior no-offset cap left labels\nbeyond 1000 unreachable).","operationId":"list_labels_labels_get","parameters":[{"in":"query","name":"limit","required":false,"schema":{"default":100,"maximum":1000,"minimum":1,"title":"Limit","type":"integer"}},{"in":"query","name":"offset","required":false,"schema":{"default":0,"minimum":0,"title":"Offset","type":"integer"}},{"in":"query","name":"order_by","required":false,"schema":{"default":"name","title":"Order By","type":"string"}},{"in":"query","name":"order_desc","required":false,"schema":{"default":false,"title":"Order Desc","type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/LabelResponse"},"title":"Response List Labels Labels Get","type":"array"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"List Labels","tags":["labels"]},"post":{"description":"Create a new label.","operationId":"create_label_labels_post","parameters":[{"description":"Label name","in":"query","name":"name","required":true,"schema":{"description":"Label name","title":"Name","type":"string"}},{"description":"Label color (hex)","in":"query","name":"color","required":false,"schema":{"default":"#3b82f6","description":"Label color (hex)","title":"Color","type":"string"}},{"description":"Label description","in":"query","name":"description","required":false,"schema":{"default":"","description":"Label description","title":"Description","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabelResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Create Label","tags":["labels"]}},"/labels/consolidate":{"post":{"description":"Consolidate exact-canonical label forks into their highest-usage survivor.\n\nCross-space (graph aggregation): operates on the global label graph.\nDeterministic and safe (same canonical token = same concept). Defaults to\n``dry_run=true`` so callers preview the plan before mutating. Semantic and\ncross-language consolidation is the separate agent-judged pass.","operationId":"consolidate_labels_labels_consolidate_post","parameters":[{"description":"Preview without merging","in":"query","name":"dry_run","required":false,"schema":{"default":true,"description":"Preview without merging","title":"Dry Run","type":"boolean"}},{"in":"query","name":"max_groups","required":false,"schema":{"default":200,"maximum":5000,"minimum":1,"title":"Max Groups","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Consolidate Labels Labels Consolidate Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Consolidate Labels","tags":["labels"]}},"/labels/consolidation-preview":{"post":{"description":"Preview the full label-consolidation task without applying merges.\n\nThis is the same dry-run path as the scheduled task: deterministic\ncanonical-fork planning plus model-judged semantic/cross-language pairs.\nIt can spend model tokens, but it never mutates graph state.","operationId":"preview_label_consolidation_labels_consolidation_preview_post","parameters":[{"in":"query","name":"sim_floor","required":false,"schema":{"default":0.82,"maximum":1,"minimum":0,"title":"Sim Floor","type":"number"}},{"in":"query","name":"max_labels","required":false,"schema":{"default":2000,"maximum":5000,"minimum":2,"title":"Max Labels","type":"integer"}},{"in":"query","name":"max_pairs","required":false,"schema":{"default":40,"maximum":200,"minimum":1,"title":"Max Pairs","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Preview Label Consolidation Labels Consolidation Preview Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Preview Label Consolidation","tags":["labels"]}},"/labels/health":{"get":{"description":"Label vocabulary health report.\n\nCross-space (graph aggregation): reads the global label graph regardless of\nactive space lens. Quantifies size, labels-per-memory, coverage, singleton\nrate, and the exact-canonical fork backlog so consolidation progress is\nmeasurable.","operationId":"label_health_labels_health_get","responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Label Health Labels Health Get","type":"object"}}},"description":"Successful Response"}},"summary":"Label Health","tags":["labels"]}},"/labels/merge":{"post":{"description":"Merge one label into another: re-point every HAS_LABEL edge from source\nto target, record the merge for reversal, delete the source.\n\nCross-space (graph aggregation): operates on the global label graph. Used by\nthe manual \"merge labels\" affordance and the agentic consolidation pass.","operationId":"merge_labels_endpoint_labels_merge_post","parameters":[{"description":"Label id to merge away (deleted)","in":"query","name":"source_id","required":true,"schema":{"description":"Label id to merge away (deleted)","title":"Source Id","type":"string"}},{"description":"Label id to keep (survivor)","in":"query","name":"target_id","required":true,"schema":{"description":"Label id to keep (survivor)","title":"Target Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Merge Labels Endpoint Labels Merge Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Merge Labels Endpoint","tags":["labels"]}},"/labels/merge-candidates":{"get":{"description":"Semantically-near label pairs (candidates for merge), read-only.\n\nCross-space (graph aggregation). Surfaces near-synonym and cross-language\npairs (the embedding model is multilingual) for human/agent review. A cosine\nscore is a candidate signal, not a verdict: nothing is merged here. Exact-\ncanonical forks are excluded (handled by /labels/consolidate). Apply a\nchosen merge via POST /labels/merge.","operationId":"label_merge_candidates_labels_merge_candidates_get","parameters":[{"in":"query","name":"sim_floor","required":false,"schema":{"default":0.82,"maximum":1,"minimum":0,"title":"Sim Floor","type":"number"}},{"in":"query","name":"max_labels","required":false,"schema":{"default":2000,"maximum":5000,"minimum":2,"title":"Max Labels","type":"integer"}},{"in":"query","name":"max_pairs","required":false,"schema":{"default":100,"maximum":1000,"minimum":1,"title":"Max Pairs","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Label Merge Candidates Labels Merge Candidates Get","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Label Merge Candidates","tags":["labels"]}},"/labels/{label_id}":{"delete":{"description":"Delete a label and all its relationships.","operationId":"delete_label_labels__label_id__delete","parameters":[{"in":"path","name":"label_id","required":true,"schema":{"title":"Label Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteLabelResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Delete Label","tags":["labels"]},"get":{"description":"Get a specific label by ID.","operationId":"get_label_labels__label_id__get","parameters":[{"in":"path","name":"label_id","required":true,"schema":{"title":"Label Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabelResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Label","tags":["labels"]},"put":{"description":"Update an existing label.","operationId":"update_label_labels__label_id__put","parameters":[{"in":"path","name":"label_id","required":true,"schema":{"title":"Label Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateLabelRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabelResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Update Label","tags":["labels"]}},"/labels/{label_id}/delete/apply":{"post":{"description":"Atomically delete a label only if its current state still matches the supplied preview plan.","operationId":"apply_label_delete_handler","parameters":[{"description":"Label id","in":"path","name":"label_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabelApplyRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabelMutationResponse"}}},"description":"Label deleted"},"404":{"description":"Label not found"},"409":{"description":"Label changed after preview"}},"summary":"Apply label deletion","tags":["labels"]}},"/labels/{label_id}/delete/preview":{"post":{"description":"Return the exact resources whose label assignment would be detached. Memories and resources are preserved.","operationId":"preview_label_delete_handler","parameters":[{"description":"Label id","in":"path","name":"label_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabelLifecyclePlanResponse"}}},"description":"Deletion plan"},"404":{"description":"Label not found"}},"summary":"Preview label deletion","tags":["labels"]}},"/labels/{label_id}/merge/apply":{"post":{"description":"Atomically move assignments and remove the source label only if both labels still match the supplied preview plan.","operationId":"apply_label_merge_handler","parameters":[{"description":"Source label id","in":"path","name":"label_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabelMergeApplyRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabelMutationResponse"}}},"description":"Labels merged"},"404":{"description":"Source or target label not found"},"409":{"description":"Labels changed after preview"},"422":{"description":"Missing plan id or invalid labels"}},"summary":"Apply a label merge","tags":["labels"]}},"/labels/{label_id}/merge/preview":{"post":{"description":"Preview moving every assignment from a duplicate label to a canonical label.","operationId":"preview_label_merge_handler","parameters":[{"description":"Source label id","in":"path","name":"label_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabelMergePreviewRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabelLifecyclePlanResponse"}}},"description":"Merge plan"},"404":{"description":"Source or target label not found"},"422":{"description":"Source and target are invalid"}},"summary":"Preview a label merge","tags":["labels"]}},"/library/community/{community_id}/recent-memories":{"get":{"description":"Most recent memories mentioning any entity in this community.\n\nCross-space; reads the global graph regardless of active space lens\n(Louvain ids are global). Powers the \"Recent on this topic\" rail\non the Library wiki community panel — closes the loop between\n\"what this topic is\" (top entities + crystals) and \"what's\nhappening on it lately\" (recent memories that touch it).","operationId":"get_community_recent_memories_library_community__community_id__recent_memories_get","parameters":[{"in":"path","name":"community_id","required":true,"schema":{"title":"Community Id","type":"integer"}},{"in":"query","name":"limit","required":false,"schema":{"default":8,"maximum":20,"minimum":1,"title":"Limit","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Community Recent Memories","tags":["library-wiki"]}},"/library/community/{community_id}/related":{"get":{"description":"Return other communities sharing entity-to-entity edges with this one.\n\nCross-space; reads the global graph regardless of active space lens.\nCommunities are computed by Louvain over the global Entity projection,\nso the related-communities lens is meaningless when scoped to a single\nspace. The \"shared edge count\" is how many RELATES_TO edges run\nbetween an entity in this community and an entity in the other\ncommunity: the strongest available signal that two topic clusters\ntouch each other in the user's mind.","operationId":"get_related_communities_library_community__community_id__related_get","parameters":[{"in":"path","name":"community_id","required":true,"schema":{"title":"Community Id","type":"integer"}},{"in":"query","name":"limit","required":false,"schema":{"default":6,"maximum":20,"minimum":1,"title":"Limit","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Related Communities","tags":["library-wiki"]}},"/library/community/{community_id}/subgraph":{"get":{"description":"Return the actual subgraph for a community.\n\nCross-space; reads the global graph regardless of active space lens\n(Louvain ids are global). Returns the entities in this community\nplus their RELATES_TO edges to each other, and optionally the\nhighest-mentioned memories that touch any of these entities, so\nthe Library wiki community panel can render the cluster's true\nshape — not a 30-node live-preview sample.\n\nOutput shape matches `GraphData` (`nodes` carry `node_type` and\n`metadata`; `edges` carry `edge_type`) so the same MiniGraph\ncomponent used in the Feed Timeline can render it without an\nextra adapter.","operationId":"get_community_subgraph_library_community__community_id__subgraph_get","parameters":[{"in":"path","name":"community_id","required":true,"schema":{"title":"Community Id","type":"integer"}},{"in":"query","name":"max_entities","required":false,"schema":{"default":80,"maximum":200,"minimum":10,"title":"Max Entities","type":"integer"}},{"in":"query","name":"include_top_memories","required":false,"schema":{"default":12,"maximum":40,"minimum":0,"title":"Include Top Memories","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Community Subgraph","tags":["library-wiki"]}},"/library/crystal/{crystal_id}/source-memories":{"get":{"description":"Return the source memories a crystal was synthesized from.\n\nPowers the \"Built from N memories\" section on the Crystal page in the\nLibrary wiki. Follows the CRYSTALLIZED_FROM edge that CreateCrystal\nwrites during synthesis (one edge per source memory, with a\ncontribution_weight property). Sorted by weight descending so the\nmost-contributing memories surface first.","operationId":"get_crystal_source_memories_library_crystal__crystal_id__source_memories_get","parameters":[{"in":"path","name":"crystal_id","required":true,"schema":{"title":"Crystal Id","type":"string"}},{"in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":100,"minimum":1,"title":"Limit","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Crystal Source Memories","tags":["library-wiki"]}},"/library/okf-export":{"get":{"description":"Build an Open Knowledge Format (OKF) bundle ZIP.\n\nCross-space (graph aggregation): reads the global graph regardless of\nthe active space lens, same as `/library/wiki-export`. Returns an\nOKF-conformant bundle (markdown + frontmatter, bundle-relative links,\nper-directory index.md). See `docs/design/OKF_INTEROP.md`.","operationId":"get_library_okf_export_library_okf_export_get","parameters":[{"in":"query","name":"entity_limit","required":false,"schema":{"default":500,"maximum":2000,"minimum":1,"title":"Entity Limit","type":"integer"}},{"in":"query","name":"top_per_community","required":false,"schema":{"default":12,"maximum":30,"minimum":1,"title":"Top Per Community","type":"integer"}},{"in":"query","name":"max_mentions_per_entity","required":false,"schema":{"default":30,"maximum":100,"minimum":1,"title":"Max Mentions Per Entity","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Library Okf Export","tags":["library-wiki"]}},"/library/wiki-export":{"get":{"description":"Build the markdown wiki ZIP.","operationId":"get_library_wiki_export_library_wiki_export_get","parameters":[{"in":"query","name":"entity_limit","required":false,"schema":{"default":500,"maximum":2000,"minimum":1,"title":"Entity Limit","type":"integer"}},{"in":"query","name":"top_per_community","required":false,"schema":{"default":12,"maximum":30,"minimum":1,"title":"Top Per Community","type":"integer"}},{"in":"query","name":"max_mentions_per_entity","required":false,"schema":{"default":30,"maximum":100,"minimum":1,"title":"Max Mentions Per Entity","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Library Wiki Export","tags":["library-wiki"]}},"/library/wiki-export-summary":{"get":{"description":"Return cheap export counts before building the ZIP.","operationId":"get_library_wiki_export_summary_library_wiki_export_summary_get","responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"}},"summary":"Get Library Wiki Export Summary","tags":["library-wiki"]}},"/library/wiki-index":{"get":{"description":"Return Library topic cards for the All tab.\n\nThe response is deliberately flat: one row per community with its surfaced\nentities and crystals, so the client can render the index in one round-trip.","operationId":"get_library_wiki_index_library_wiki_index_get","parameters":[{"in":"query","name":"community_limit","required":false,"schema":{"default":20,"maximum":200,"minimum":1,"title":"Community Limit","type":"integer"}},{"in":"query","name":"top_per_community","required":false,"schema":{"default":5,"maximum":10,"minimum":1,"title":"Top Per Community","type":"integer"}},{"in":"query","name":"include_top_memories","required":false,"schema":{"anyOf":[{"maximum":8,"minimum":0,"type":"integer"},{"type":"null"}],"title":"Include Top Memories"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Library Wiki Index","tags":["library-wiki"]}},"/library/wiki-page/crystal/{crystal_id}":{"get":{"description":"Render a single crystal's wiki page as markdown. By-id-direct.","operationId":"get_wiki_page_crystal_library_wiki_page_crystal__crystal_id__get","parameters":[{"in":"path","name":"crystal_id","required":true,"schema":{"title":"Crystal Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Wiki Page Crystal","tags":["library-wiki"]}},"/library/wiki-page/entity/{id_or_name}":{"get":{"description":"Render a single entity's wiki page as markdown.\n\nCross-space (graph aggregation): looks up by id, with a case-insensitive\nname fallback. Pass either the entity UUID or its canonical name.","operationId":"get_wiki_page_entity_library_wiki_page_entity__id_or_name__get","parameters":[{"in":"path","name":"id_or_name","required":true,"schema":{"title":"Id Or Name","type":"string"}},{"in":"query","name":"mention_limit","required":false,"schema":{"default":30,"maximum":200,"minimum":1,"title":"Mention Limit","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Wiki Page Entity","tags":["library-wiki"]}},"/library/wiki-page/topic/{community_id}":{"get":{"description":"Render a single topic (community) wiki page as markdown.\n\nCross-space (graph aggregation). The community id is the Louvain\ninteger assigned by community detection.","operationId":"get_wiki_page_topic_library_wiki_page_topic__community_id__get","parameters":[{"in":"path","name":"community_id","required":true,"schema":{"title":"Community Id","type":"integer"}},{"in":"query","name":"top_per_community","required":false,"schema":{"default":12,"maximum":30,"minimum":1,"title":"Top Per Community","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Wiki Page Topic","tags":["library-wiki"]}},"/memories":{"get":{"description":"List memories with filtering and pagination.","operationId":"list_memories_memories_get","parameters":[{"in":"query","name":"limit","required":false,"schema":{"default":20,"maximum":100,"minimum":1,"title":"Limit","type":"integer"}},{"in":"query","name":"offset","required":false,"schema":{"default":0,"minimum":0,"title":"Offset","type":"integer"}},{"in":"query","name":"state","required":false,"schema":{"default":"active","title":"State","type":"string"}},{"in":"query","name":"importance_min","required":false,"schema":{"default":0,"maximum":1,"minimum":0,"title":"Importance Min","type":"number"}},{"description":"Isolation space to list","in":"query","name":"space_id","required":false,"schema":{"default":"default","description":"Isolation space to list","title":"Space Id","type":"string"}},{"description":"Filter by crystal flag: true for crystals only, false for non-crystal only, omit for both.","in":"query","name":"is_crystal","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Filter by crystal flag: true for crystals only, false for non-crystal only, omit for both.","title":"Is Crystal"}},{"description":"Filter by memory unit type: fact, preference, decision, plan, procedure, learning, context, or event.","in":"query","name":"unit_type","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by memory unit type: fact, preference, decision, plan, procedure, learning, context, or event.","title":"Unit Type"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryListResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"List Memories","tags":["memories"]},"post":{"description":"Create a new memory with automatic entity extraction.\n\nProvenance is recorded only when a caller supplies a real id it owns:\n``source_thread_id``/``source_message_id`` link the memory to its\noriginating thread/message (UI, launcher, distillation). We never infer\nprovenance, so absence is honest rather than a guess.","operationId":"create_memory_memories_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryCreateRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryCreateResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Create Memory","tags":["memories"]}},"/memories/bulk/delete":{"post":{"description":"Delete a bounded memory selection inside one source space.","operationId":"bulk_delete_memories_memories_bulk_delete_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkDeleteMemoriesRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkDeleteMemoriesResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Bulk Delete Memories","tags":["memories"]}},"/memories/bulk/move":{"post":{"description":"Move a bounded selection of memories into another space.","operationId":"bulk_move_memories_memories_bulk_move_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkMoveMemoriesRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkMoveMemoriesResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Bulk Move Memories","tags":["memories"]}},"/memories/bulk/move/preview":{"post":{"description":"Preview a bounded bulk memory move before mutating data.","operationId":"preview_bulk_move_memories_memories_bulk_move_preview_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkMoveMemoriesRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkMovePreviewResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Preview Bulk Move Memories","tags":["memories"]}},"/memories/distill":{"post":{"description":"Create memories from a conversation thread.","operationId":"distill_memories_from_thread_memories_distill_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DistillationRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryCreateResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Distill Memories From Thread","tags":["distillation"]}},"/memories/distill/batch-plan":{"post":{"description":"Build a bounded, read-only plan for bulk thread distillation.","operationId":"plan_thread_distillation_batch_memories_distill_batch_plan_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ThreadDistillationBatchPlanRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ThreadDistillationBatchPlanResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Plan Thread Distillation Batch","tags":["distillation"]}},"/memories/distill/plan":{"post":{"description":"Decide whether this thread should use direct or background distillation.","operationId":"get_distillation_plan_memories_distill_plan_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DistillationRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DistillationPlanResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Distillation Plan","tags":["distillation"]}},"/memories/distill/preview":{"post":{"description":"Preview what memories would be created from a thread.","operationId":"preview_distillation_memories_distill_preview_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DistillationRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DistillationPreviewResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Preview Distillation","tags":["distillation"]}},"/memories/distill/schedule":{"post":{"description":"Schedule agent-backed thread distillation for a large or deferred thread.","operationId":"schedule_distillation_memories_distill_schedule_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DistillationScheduleRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DistillationScheduleResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Schedule Distillation","tags":["distillation"]}},"/memories/distill/triage":{"post":{"description":"Quick check: is this conversation worth saving?","operationId":"triage_conversation_memories_distill_triage_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TriageRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Triage Conversation Memories Distill Triage Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Triage Conversation","tags":["distillation"]}},"/memories/evolves/revision/apply":{"post":{"description":"Atomically reconcile the pair's direct EVOLVES edge, recompute visibility from the remaining replacement graph, and write an idempotent governance receipt.","operationId":"apply_evolves_revision_handler","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvolvesRevisionApplyRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvolvesRevisionResultResponse"}}},"description":"Correction applied"},"409":{"description":"Pair changed after preview"},"422":{"description":"Invalid correction"}},"summary":"Apply a Memory history correction","tags":["memories"]}},"/memories/evolves/revision/preview":{"post":{"description":"Inspect the exact EVOLVES pair and bind a desired semantic state to its current topology. This never mutates raw edges or Memory visibility fields.","operationId":"preview_evolves_revision_handler","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvolvesRevisionPreviewRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvolvesRevisionPlanResponse"}}},"description":"State-bound correction plan"},"404":{"description":"Memory pair not found"},"422":{"description":"Invalid correction"}},"summary":"Preview a Memory history correction","tags":["memories"]}},"/memories/extract-kg/preview-content":{"post":{"description":"Preview KG extraction for explicit content without writing a Memory.","operationId":"preview_memory_kg_extraction_content_memories_extract_kg_preview_content_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryKGContentExtractionRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryKGExtractionResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Preview Memory Kg Extraction Content","tags":["memories"]}},"/memories/reindex":{"post":{"description":"Reindex multiple memories or all memories needing reindex.\n\nThis endpoint can work for both single and bulk reindexing:\n- If memory_ids is provided: reindex those specific memories\n- If memory_ids is None/empty: reindex all memories with reindex_needed=True","operationId":"reindex_memories_bulk_memories_reindex_post","parameters":[{"description":"Batch size for concurrent processing","in":"query","name":"batch_size","required":false,"schema":{"default":3,"description":"Batch size for concurrent processing","maximum":10,"minimum":1,"title":"Batch Size","type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryReindexRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReindexResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Reindex Memories Bulk","tags":["memories"]}},"/memories/reindex/status":{"get":{"description":"Get status of memories needing reindex.","operationId":"get_reindex_status_memories_reindex_status_get","parameters":[{"description":"Include all memory IDs needing reindex","in":"query","name":"include_ids","required":false,"schema":{"default":false,"description":"Include all memory IDs needing reindex","title":"Include Ids","type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReindexStatusResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Reindex Status","tags":["memories"]}},"/memories/relations/{relation_id}":{"delete":{"description":"Soft-delete a semantic memory relation.","operationId":"delete_memory_relation_memories_relations__relation_id__delete","parameters":[{"in":"path","name":"relation_id","required":true,"schema":{"title":"Relation Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryRelationPublic"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Delete Memory Relation","tags":["memories"]},"patch":{"description":"Update a semantic memory relation.","operationId":"update_memory_relation_memories_relations__relation_id__patch","parameters":[{"in":"path","name":"relation_id","required":true,"schema":{"title":"Relation Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryRelationUpdateRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryRelationPublic"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Update Memory Relation","tags":["memories"]}},"/memories/search":{"post":{"description":"Memory search with filtering, metadata, and reasoning support.","operationId":"search_memories_memories_search_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemorySearchRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/MemorySearchResult"},"title":"Response Search Memories Memories Search Post","type":"array"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Search Memories","tags":["memories"]}},"/memories/{memory_id}":{"delete":{"description":"Delete a memory and optionally its relationships.","operationId":"delete_memory_memories__memory_id__delete","parameters":[{"in":"path","name":"memory_id","required":true,"schema":{"title":"Memory Id","type":"string"}},{"description":"Delete related entities","in":"query","name":"cascade_delete","required":false,"schema":{"default":true,"description":"Delete related entities","title":"Cascade Delete","type":"boolean"}},{"description":"Optional isolation space guard","in":"query","name":"space_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional isolation space guard","title":"Space Id"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteMemoryResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Delete Memory","tags":["memories"]},"get":{"description":"Get a specific memory by ID with associated labels.","operationId":"get_memory_memories__memory_id__get","parameters":[{"in":"path","name":"memory_id","required":true,"schema":{"title":"Memory Id","type":"string"}},{"description":"Optional isolation space guard","in":"query","name":"space_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional isolation space guard","title":"Space Id"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryPublic"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Memory","tags":["memories"]},"patch":{"description":"Update memory properties like importance, title, and content.","operationId":"update_memory_memories__memory_id__patch","parameters":[{"in":"path","name":"memory_id","required":true,"schema":{"title":"Memory Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Request","type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryPublic"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Update Memory","tags":["memories"]}},"/memories/{memory_id}/archive":{"post":{"description":"Hide a memory from everyday recall while keeping it explicitly readable.","operationId":"archive_memory_memories__memory_id__archive_post","parameters":[{"in":"path","name":"memory_id","required":true,"schema":{"title":"Memory Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryStateRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Archive Memory Memories Memory Id Archive Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Archive Memory","tags":["memories"]}},"/memories/{memory_id}/deprecate":{"post":{"description":"Mark a memory as deprecated while preserving it for graph history.","operationId":"deprecate_memory_memories__memory_id__deprecate_post","parameters":[{"in":"path","name":"memory_id","required":true,"schema":{"title":"Memory Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeprecateMemoryRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Deprecate Memory Memories Memory Id Deprecate Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Deprecate Memory","tags":["memories"]}},"/memories/{memory_id}/export":{"get":{"description":"Export a memory in various formats.","operationId":"export_memory_memories__memory_id__export_get","parameters":[{"in":"path","name":"memory_id","required":true,"schema":{"title":"Memory Id","type":"string"}},{"description":"Export format: json, markdown, html","in":"query","name":"format","required":false,"schema":{"default":"json","description":"Export format: json, markdown, html","title":"Format","type":"string"}},{"description":"Include memory metadata","in":"query","name":"include_metadata","required":false,"schema":{"default":true,"description":"Include memory metadata","title":"Include Metadata","type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Export Memory","tags":["memories"]}},"/memories/{memory_id}/extract-kg/apply":{"post":{"description":"Apply knowledge graph extraction results to a memory.\n\nThis endpoint saves the extracted entities and relationships to the graph database\nand updates the memory's metadata to track the extraction. Exact mode isolates caller-owned entity identities from automatic alias and punctuation matching. Identity lookup/update is transactional per entity, but the batch is not atomic. On storage failure, success is false and some writes may have persisted; inspect resolved_entities before retrying. Entity replay reuses IDs; relationships retain append semantics. Existing aliases and historical graph contamination are not repaired automatically.","operationId":"apply_memory_kg_extraction_memories__memory_id__extract_kg_apply_post","parameters":[{"in":"path","name":"memory_id","required":true,"schema":{"title":"Memory Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryKGApplyRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryKGApplyResponse"}}},"description":"Successful Response"},"409":{"description":"Multiple stored entities have the same exact name and type; resolve the ambiguity before applying."},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Invalid request, unsupported resolution value, or invalid exact batch; no graph mutation."},"500":{"description":"Apply could not complete. Some writes may have persisted; inspect the graph before retrying."}},"summary":"Apply Memory Kg Extraction","tags":["memories"]}},"/memories/{memory_id}/extract-kg/preview":{"post":{"description":"Preview knowledge graph extraction for a memory.\n\nThis endpoint extracts entities and relationships from a memory's content\nusing the local LLM, providing a preview without saving to the database.","operationId":"preview_memory_kg_extraction_memories__memory_id__extract_kg_preview_post","parameters":[{"in":"path","name":"memory_id","required":true,"schema":{"title":"Memory Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryKGExtractionRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryKGExtractionResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Preview Memory Kg Extraction","tags":["memories"]}},"/memories/{memory_id}/favorite":{"post":{"description":"Toggle memory favorite status.","operationId":"toggle_memory_favorite_memories__memory_id__favorite_post","parameters":[{"in":"path","name":"memory_id","required":true,"schema":{"title":"Memory Id","type":"string"}},{"description":"Set favorite status","in":"query","name":"is_favorite","required":true,"schema":{"description":"Set favorite status","title":"Is Favorite","type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Toggle Memory Favorite","tags":["memories"]}},"/memories/{memory_id}/forget":{"post":{"description":"Remove a memory from recall and explicit by-id reads without hard-deleting graph rows.","operationId":"forget_memory_memories__memory_id__forget_post","parameters":[{"in":"path","name":"memory_id","required":true,"schema":{"title":"Memory Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryStateRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Forget Memory Memories Memory Id Forget Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Forget Memory","tags":["memories"]}},"/memories/{memory_id}/identity":{"get":{"description":"Use the target server's normal authentication and an explicit exact Space ID. No cross-Space fallback is performed. Requires current read authority. Read this response before correcting an occurrence; retain source_revision, epoch, generation and the occurrence revision. An empty occurrences array is valid and reading does not invoke a model.","operationId":"read_memory_identity","parameters":[{"description":"Memory ID returned by the target server; the Memory must belong to the exact requested Space.","in":"path","name":"memory_id","required":true,"schema":{"type":"string"}},{"in":"query","name":"space_id","required":true,"schema":{"description":"Exact Space ID. Pass explicitly; this operation does not infer the active Space or broaden to other Spaces.","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityEvidence"}}},"description":"Current committed identity data."},"400":{"description":"Malformed path or query; framework validation may return plain text."},"401":{"description":"Authentication is required by the target server."},"403":{"description":"Current actor, credential or Space authority denies this operation. Identity-specific denials use IdentityOperationError; earlier authentication gates may use their generic error format."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityOperationError"}}},"description":"The Memory, profile or Space is unavailable to this operation."},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityOperationError"}}},"description":"A current-state, capacity or concurrency condition prevents the operation. Inspect error_code; not every conflict means stale evidence."},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityOperationError"}}},"description":"Source, snapshot or profile payload exceeds the bounded operation limit."},"422":{"description":"Invalid request keys, selection or profile. Identity validation uses IdentityOperationError; malformed JSON or DTO decoding may return a framework validation response."},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityOperationError"}}},"description":"Storage or worker failure."},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityOperationError"}}},"description":"Current authorization, storage or model admission is unavailable."}},"summary":"Read memory identity evidence","tags":["memories"]}},"/memories/{memory_id}/identity/correction":{"post":{"description":"Use the target server's normal authentication and an explicit exact Space ID. No cross-Space fallback is performed. Requires a human actor with current write authority; an agent cannot mark a decision as human. Copy all concurrency fields from a fresh evidence read. Send identity_id: null to explicitly confirm unknown, or a profile ID in this Space. Omission is invalid. No model is called. If source or evidence changed, read again before choosing a correction; capacity and other conflicts require the recovery identified by error_code.","operationId":"correct_memory_identity","parameters":[{"description":"Memory ID returned by the target server; the Memory must belong to the exact requested Space.","in":"path","name":"memory_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"examples":{"confirm_unknown":{"summary":"Record an explicit human unknown decision using current evidence","value":{"expected_epoch":"epoch-from-read","expected_generation":1,"expected_revision":1,"identity_id":null,"mention_id":"mention-id-from-read","source_revision":"source-revision-from-read","space_id":"engineering"}}},"schema":{"$ref":"#/components/schemas/IdentityCorrectionRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityEvidence"}}},"description":"Current committed identity data."},"400":{"description":"Malformed path or query; framework validation may return plain text."},"401":{"description":"Authentication is required by the target server."},"403":{"description":"Current actor, credential or Space authority denies this operation. Identity-specific denials use IdentityOperationError; earlier authentication gates may use their generic error format."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityOperationError"}}},"description":"The Memory, profile or Space is unavailable to this operation."},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityOperationError"}}},"description":"A current-state, capacity or concurrency condition prevents the operation. Inspect error_code; not every conflict means stale evidence."},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityOperationError"}}},"description":"Source, snapshot or profile payload exceeds the bounded operation limit."},"422":{"description":"Invalid request keys, selection or profile. Identity validation uses IdentityOperationError; malformed JSON or DTO decoding may return a framework validation response."},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityOperationError"}}},"description":"Storage or worker failure."},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityOperationError"}}},"description":"Current authorization, storage or model admission is unavailable."}},"summary":"Correct a memory identity occurrence","tags":["memories"]}},"/memories/{memory_id}/identity/extract":{"post":{"description":"Use the target server's normal authentication and an explicit exact Space ID. No cross-Space fallback is performed. Requires current write and model authority; permitted agents may request machine extraction. Uses the configured model and applicable model billing/admission. Omit mention_ids (or use null) with no new_spans for initial extraction only when there are no existing occurrences. An eligible interactive request invokes the model, including a repeated request after an empty result; background initial-pass deduplication is separate. When occurrences already exist, use selected mode. An explicit mention_ids array selects machine occurrences, optionally with new_spans. Human-confirmed choices are preserved. This is a bounded request for one Memory, not whole-Space replay or automatic profile creation.","operationId":"extract_memory_identity","parameters":[{"description":"Memory ID returned by the target server; the Memory must belong to the exact requested Space.","in":"path","name":"memory_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"examples":{"initial":{"summary":"Initial extraction for this Memory","value":{"space_id":"engineering"}},"selected":{"summary":"Reconsider one machine occurrence","value":{"mention_ids":["machine-mention-id-from-read"],"new_spans":[],"space_id":"engineering"}}},"schema":{"$ref":"#/components/schemas/IdentityExtractionRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityEvidence"}}},"description":"Current committed identity data."},"400":{"description":"Malformed path or query; framework validation may return plain text."},"401":{"description":"Authentication is required by the target server."},"403":{"description":"Current actor, credential or Space authority denies this operation. Identity-specific denials use IdentityOperationError; earlier authentication gates may use their generic error format."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityOperationError"}}},"description":"The Memory, profile or Space is unavailable to this operation."},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityOperationError"}}},"description":"A current-state, capacity or concurrency condition prevents the operation. Inspect error_code; not every conflict means stale evidence."},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityOperationError"}}},"description":"Source, snapshot or profile payload exceeds the bounded operation limit."},"422":{"description":"Invalid request keys, selection or profile. Identity validation uses IdentityOperationError; malformed JSON or DTO decoding may return a framework validation response."},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityOperationError"}}},"description":"Storage or worker failure."},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityOperationError"}}},"description":"The configured model failed to return an acceptable result."},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityOperationError"}}},"description":"Current authorization, storage or model admission is unavailable."},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityOperationError"}}},"description":"The bounded model attempt exceeded its deadline."}},"summary":"Extract or reconsider memory identities","tags":["memories"]}},"/memories/{memory_id}/labels":{"get":{"description":"Get labels assigned to a memory.","operationId":"get_memory_labels_memories__memory_id__labels_get","parameters":[{"in":"path","name":"memory_id","required":true,"schema":{"title":"Memory Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabelsResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Memory Labels","tags":["memories"]}},"/memories/{memory_id}/labels/{label_id}":{"delete":{"description":"Remove a label from a memory.","operationId":"remove_label_from_memory_memories__memory_id__labels__label_id__delete","parameters":[{"in":"path","name":"memory_id","required":true,"schema":{"title":"Memory Id","type":"string"}},{"in":"path","name":"label_id","required":true,"schema":{"title":"Label Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Remove Label From Memory","tags":["memories"]},"post":{"description":"Assign a label to a memory.","operationId":"assign_label_to_memory_memories__memory_id__labels__label_id__post","parameters":[{"in":"path","name":"memory_id","required":true,"schema":{"title":"Memory Id","type":"string"}},{"in":"path","name":"label_id","required":true,"schema":{"title":"Label Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Assign Label To Memory","tags":["memories"]}},"/memories/{memory_id}/relations":{"get":{"description":"List semantic relations around a memory.","operationId":"list_memory_relations_memories__memory_id__relations_get","parameters":[{"in":"path","name":"memory_id","required":true,"schema":{"title":"Memory Id","type":"string"}},{"in":"query","name":"direction","required":false,"schema":{"default":"both","enum":["out","in","both"],"title":"Direction","type":"string"}},{"description":"Comma-separated relation_type filter","in":"query","name":"types","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated relation_type filter","title":"Types"}},{"description":"Comma-separated status filter, default active","in":"query","name":"status","required":false,"schema":{"default":"active","description":"Comma-separated status filter, default active","title":"Status","type":"string"}},{"in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":200,"minimum":1,"title":"Limit","type":"integer"}},{"in":"query","name":"offset","required":false,"schema":{"default":0,"minimum":0,"title":"Offset","type":"integer"}},{"in":"query","name":"space_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Space Id"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryRelationListResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"List Memory Relations","tags":["memories"]},"post":{"description":"Create or update a semantic relation from one memory to another.","operationId":"create_memory_relation_memories__memory_id__relations_post","parameters":[{"in":"path","name":"memory_id","required":true,"schema":{"title":"Memory Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryRelationCreateRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryRelationPublic"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Create Memory Relation","tags":["memories"]}},"/memories/{memory_id}/relations/suggest":{"post":{"description":"Suggest a semantic relation for two memories without writing it.","operationId":"suggest_memory_relation_memories__memory_id__relations_suggest_post","parameters":[{"in":"path","name":"memory_id","required":true,"schema":{"title":"Memory Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryRelationSuggestRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryRelationSuggestionPublic"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Suggest Memory Relation","tags":["memories"]}},"/memories/{memory_id}/supersede":{"post":{"description":"Mark a memory as replaced by a newer memory.","operationId":"supersede_memory_memories__memory_id__supersede_post","parameters":[{"in":"path","name":"memory_id","required":true,"schema":{"title":"Memory Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupersedeMemoryRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Supersede Memory Memories Memory Id Supersede Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Supersede Memory","tags":["memories"]}},"/models/bge-m3/install":{"post":{"description":"Download and install the search embedding model.\n\nThe right model for your platform is selected automatically. When the\nresponse includes `reindex_required=true`, run `/search-index/reindex` to\nrefresh existing searchable content.","operationId":"install_bge_m3_models_bge_m3_install_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BGEM3InstallRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BGEM3InstallResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Install Bge M3","tags":["models"]}},"/models/bge-m3/status":{"get":{"description":"Check the status of the search embedding model.\n\nThe embedding model powers hybrid search (combining keyword and semantic matching). The specific model is selected automatically based on your platform for best performance.","operationId":"get_bge_m3_status_models_bge_m3_status_get","parameters":[{"in":"query","name":"full_verify","required":false,"schema":{"default":false,"title":"Full Verify","type":"boolean"}},{"in":"query","name":"force_refresh","required":false,"schema":{"default":false,"title":"Force Refresh","type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BGEM3StatusResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Bge M3 Status","tags":["models"]}},"/models/memory-status":{"get":{"description":"Return which local model weights are currently resident in RAM.","operationId":"get_model_memory_status_models_memory_status_get","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelMemoryStatusResponse"}}},"description":"Successful Response"}},"summary":"Get Model Memory Status","tags":["models"]}},"/models/unload/{model_type}":{"post":{"description":"Manually unload a model from memory.\n\nThe model will reload automatically on next use.","operationId":"unload_model_models_unload__model_type__post","parameters":[{"in":"path","name":"model_type","required":true,"schema":{"enum":["embedding","llm"],"title":"Model Type","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelUnloadResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Unload Model","tags":["models"]}},"/resources/resolve":{"get":{"description":"Resolve one capability-free nowledgemem:// reference against the authenticated backend and workspace. This endpoint never fetches HTTP(S) or file URLs.","operationId":"resolve_resource_handler","parameters":[{"description":"Capability-free `nowledgemem://` URI to resolve.","in":"query","name":"uri","required":true,"schema":{"type":"string"}},{"description":"Optional agent identity used only by Context KFS renderers.","in":"query","name":"agent_id","required":false,"schema":{"type":"string"}},{"description":"Optional calling application identity used only by Context renderers.","in":"query","name":"source_app","required":false,"schema":{"type":"string"}},{"description":"Optional host-agent identity used only by Context renderers.","in":"query","name":"host_agent_id","required":false,"schema":{"type":"string"}},{"description":"Optional Space lens used only by Context renderers.","in":"query","name":"space_id","required":false,"schema":{"type":"string"}},{"description":"Include Working Memory in a resolved Context Bundle.","in":"query","name":"include_working_memory","required":false,"schema":{"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResolvedResourceResponse"}}},"description":"Rendered resource"},"400":{"description":"Invalid or unsupported resource URI"},"404":{"description":"Resource not found"},"409":{"description":"Thread identity is ambiguous within the selected Space lens"}},"summary":"Resolve a Nowledge resource URI","tags":["resources"]}},"/search-index/reindex":{"post":{"description":"Refresh the search projection from authoritative storage.\n\nMost calls perform a full semantic rebuild of:\n- All memories (with search embeddings)\n- All thread messages\n- All Library sources and source chunks\n- All communities\n- All entities\n\nIf the only pending marker is the 0.8.4 Content Store thread-message\nmigration and semantic index metadata already matches the active embedding\nbackend, this endpoint only copies/verifies messages, rebuilds the FTS-only\nmessages_index, and skips embedding initialization.\n\nThe embedding model is platform-specific:\n- macOS Apple Silicon: Qwen3-Embedding via mlx-embeddings\n- non-Apple-Silicon (Windows/Linux/macOS Intel): BGE-M3 via FastEmbed/ONNX\n\nThis is a heavy operation and should only be triggered:\n- After first downloading the search embedding model\n- After a data migration\n- When explicitly requested by the user","operationId":"reindex_search_index_search_index_reindex_post","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchIndexReindexResponse"}}},"description":"Successful Response"}},"summary":"Reindex Search Index","tags":["memories"]}},"/search-index/reindex/status":{"get":{"description":"Get the current or last-known full search rebuild runtime state.","operationId":"get_search_index_reindex_status_search_index_reindex_status_get","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchIndexReindexRuntimeStatusResponse"}}},"description":"Successful Response"}},"summary":"Get Search Index Reindex Status","tags":["memories"]}},"/search-index/status":{"get":{"description":"Get status of the search index (LanceDB + hybrid search).\n\nThe embedding model is platform-specific:\n- macOS Apple Silicon: Qwen3-Embedding via mlx-embeddings\n- non-Apple-Silicon (Windows/Linux/macOS Intel): BGE-M3 via FastEmbed/ONNX\n\nThis endpoint checks:\n- Whether the active search embedding backend is available\n- Whether the search index service is initialized","operationId":"get_search_index_status_search_index_status_get","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchIndexStatusResponse"}}},"description":"Successful Response"}},"summary":"Get Search Index Status","tags":["memories"]}},"/settings/agent-profiles":{"get":{"description":"List owner-configured long-running agent identities.","operationId":"get_agent_profiles_settings_agent_profiles_get","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentProfilesResponse"}}},"description":"Successful Response"}},"summary":"Get Agent Profiles","tags":["settings","settings"]},"post":{"description":"Create a named agent identity consumed by Context Bundle.","operationId":"create_agent_profile_settings_agent_profiles_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentProfilePayload"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentProfileResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Create Agent Profile","tags":["settings","settings"]}},"/settings/agent-profiles/import":{"post":{"description":"Enroll a versioned Agent identity card. Existing IDs return a conflict unless force is enabled.","operationId":"import_agent_profile_handler","parameters":[{"description":"Replace an existing profile with the same canonical ID","in":"query","name":"force","required":false,"schema":{"type":"boolean"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityImportPayload"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityImportResponse"}}},"description":"Imported Agent profile"},"409":{"description":"Agent profile already exists"},"422":{"description":"Invalid or unsupported identity card"}},"summary":"Import Agent Identity","tags":["settings"]}},"/settings/agent-profiles/{agent_id}":{"delete":{"description":"Delete a named agent identity.","operationId":"delete_agent_profile_settings_agent_profiles__agent_id__delete","parameters":[{"in":"path","name":"agent_id","required":true,"schema":{"title":"Agent Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentProfilesResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Delete Agent Profile","tags":["settings","settings"]},"patch":{"description":"Update only the supplied fields on an enrolled Agent identity. Omitted fields are preserved; empty or null values clear the field or restore its server default. The profile ID is immutable.","operationId":"patch_agent_profile_settings_agent_profiles__agent_id__patch","parameters":[{"description":"Canonical Agent profile ID","in":"path","name":"agent_id","required":true,"schema":{"title":"Agent Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentProfilePatchPayload"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentProfileResponse"}}},"description":"Updated Agent profile"},"404":{"description":"Agent profile not found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Empty, invalid, or identity-changing patch"}},"summary":"Patch Agent Profile","tags":["settings"]},"put":{"description":"Update an existing named agent identity.","operationId":"update_agent_profile_settings_agent_profiles__agent_id__put","parameters":[{"in":"path","name":"agent_id","required":true,"schema":{"title":"Agent Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentProfilePayload"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentProfileResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Update Agent Profile","tags":["settings","settings"]}},"/settings/agent-profiles/{agent_id}/export":{"get":{"description":"Export one enrolled Agent profile as a versioned, credential-free identity card.","operationId":"export_agent_profile_handler","parameters":[{"description":"Canonical Agent profile ID","in":"path","name":"agent_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityCard"}}},"description":"Portable Agent identity card"},"404":{"description":"Agent profile not found"}},"summary":"Export Agent Identity","tags":["settings"]}},"/settings/agent-profiles/{agent_id}/usage":{"get":{"description":"Compute current attribution and key-usage evidence for an enrolled Agent identity without mutating its profile.","operationId":"agent_profile_usage_handler","parameters":[{"description":"Canonical Agent profile ID","in":"path","name":"agent_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentProfileUsageResponse"}}},"description":"Computed Agent identity usage"},"404":{"description":"Agent profile not found"}},"summary":"Get Agent Identity Usage","tags":["settings"]}},"/settings/backup":{"get":{"description":"Export profile, Spaces, knowledge-processing preferences, and provider routing without API keys, sign-in sessions, licenses, Access Anywhere keys, or device paths.","operationId":"export_settings_backup_handler","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SettingsBackupArtifact"}}},"description":"Portable settings artifact"}},"summary":"Export portable settings","tags":["settings"]}},"/settings/profile":{"get":{"description":"Get user profile (name, aliases, context, preferred language).\n\nUsed by the browser extension and CLI to inject user identity\nand language preference into agent prompts.","operationId":"get_user_profile_settings_profile_get","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserProfileResponse"}}},"description":"Successful Response"}},"summary":"Get User Profile","tags":["settings","settings"]}},"/settings/restore":{"post":{"description":"Merge portable settings into this installation. Existing credentials survive only for an unchanged non-OAuth provider identity; secrets are never read from the artifact.","operationId":"restore_settings_handler","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SettingsBackupArtifact"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SettingsRestoreResponse"}}},"description":"Settings restored"},"422":{"description":"Invalid, unsafe, or unsupported settings artifact"}},"summary":"Restore portable settings","tags":["settings"]}},"/settings/restore/preview":{"post":{"description":"Validate a settings artifact and report its portable sections before any write.","operationId":"preview_settings_restore_handler","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SettingsBackupArtifact"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SettingsRestorePreview"}}},"description":"Valid restore preview"},"422":{"description":"Invalid, unsafe, or unsupported settings artifact"}},"summary":"Preview a settings restore","tags":["settings"]}},"/settings/rules":{"get":{"description":"List owner-managed AI Context rules consumed by Context Bundle.","operationId":"get_guidance_rules_settings_rules_get","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RulesResponse"}}},"description":"Successful Response"}},"summary":"Get Guidance Rules","tags":["settings","settings"]},"post":{"description":"Create an AI Context rule for the Context Bundle control plane.","operationId":"create_guidance_rule_settings_rules_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GuidanceRulePayload"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GuidanceRuleResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Create Guidance Rule","tags":["settings","settings"]}},"/settings/rules/{rule_id}":{"delete":{"description":"Delete an AI Context rule.","operationId":"delete_guidance_rule_settings_rules__rule_id__delete","parameters":[{"in":"path","name":"rule_id","required":true,"schema":{"title":"Rule Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RulesResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Delete Guidance Rule","tags":["settings","settings"]},"put":{"description":"Update an existing AI Context rule.","operationId":"update_guidance_rule_settings_rules__rule_id__put","parameters":[{"in":"path","name":"rule_id","required":true,"schema":{"title":"Rule Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GuidanceRulePayload"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GuidanceRuleResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Update Guidance Rule","tags":["settings","settings"]}},"/skills":{"get":{"description":"List skills. Cross-space unless ``space_id`` is given.","operationId":"list_skills_skills_get","parameters":[{"description":"Filter by lifecycle stage","in":"query","name":"stage","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by lifecycle stage","title":"Stage"}},{"description":"Scope to a space (else all)","in":"query","name":"space_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Scope to a space (else all)","title":"Space Id"}},{"in":"query","name":"limit","required":false,"schema":{"default":100,"maximum":500,"minimum":1,"title":"Limit","type":"integer"}},{"in":"query","name":"offset","required":false,"schema":{"default":0,"minimum":0,"title":"Offset","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response List Skills Skills Get","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"List Skills","tags":["skills","skills"]}},"/skills/activity":{"get":{"description":"Recent skill-use moments, newest-first — the usage proof feed.\n\nReads each skill's metadata use/outcome logs and merges them (see\nSKILL_USAGE_PROOF_FEED.md). Registered BEFORE ``/{skill_id}`` so this static path\nis not shadowed. ``skill_id`` limits to one skill (the detail-page strip); else\ncross-skill, scoped to the active space when ``space_id`` is given.","operationId":"get_skill_activity_skills_activity_get","parameters":[{"description":"Limit to one skill (else all)","in":"query","name":"skill_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Limit to one skill (else all)","title":"Skill Id"}},{"description":"Scope to a space (else all)","in":"query","name":"space_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Scope to a space (else all)","title":"Space Id"}},{"in":"query","name":"limit","required":false,"schema":{"default":20,"maximum":100,"minimum":1,"title":"Limit","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Get Skill Activity Skills Activity Get","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Skill Activity","tags":["skills","skills"]}},"/skills/author":{"post":{"description":"Create a skill the user authored deliberately (top-down), from a name plus\noptional sources (memories and/or threads) and a free-text intent note.\n\nThreads are resolved to their source memories via the ``COMPACTS_TO`` edge so\nthey flow through the same ``SYNTHESIZED_FROM`` provenance and compile context\nas auto-detected evidence. The skill is created at stage ``promotable`` (ready\nto compile); the caller then runs the normal compile to produce a reviewable\ndraft. A note-only skill (no memories/threads) is allowed: the note carries\nthe intent. Scoped to the personal lane (skills list cross-space).\nSee docs/design/SKILL_BUILDER_AND_PURPOSE.md §4.2.","operationId":"author_skill_skills_author_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthorSkillRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Author Skill Skills Author Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Author Skill","tags":["skills","skills"]}},"/skills/curator/dry-run":{"get":{"description":"Preview the scheduled skill-curator pass without staging proposals.\n\nThis runs the same read-only detection surfaces as the scheduled curator:\nrot selection for bounded hardening and staleness detection from superseded\nevidence. It does not run hardening, stage pending versions, write pending\nenrichments, emit feed events, or queue background work.","operationId":"curator_dry_run_skills_curator_dry_run_get","parameters":[{"in":"query","name":"budget","required":false,"schema":{"default":3,"maximum":20,"minimum":0,"title":"Budget","type":"integer"}},{"in":"query","name":"include_merges","required":false,"schema":{"default":false,"title":"Include Merges","type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Curator Dry Run Skills Curator Dry Run Get","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Curator Dry Run","tags":["skills","skills"]}},"/skills/curator/proposals":{"get":{"description":"What the curator would propose right now: rotting skills (failing in real\nuse, no fix staged) and near-duplicate pairs worth merging.","operationId":"curator_proposals_skills_curator_proposals_get","responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Curator Proposals Skills Curator Proposals Get","type":"object"}}},"description":"Successful Response"}},"summary":"Curator Proposals","tags":["skills","skills"]}},"/skills/curator/run":{"post":{"description":"Run one budgeted curator cycle now: stage proven refines for the worst\nrotting skills. The work happens in the background (model-heavy); the proposals\nappear as pending updates the user reviews. Manual trigger today; the scheduler\ncalls this on a cadence later (default-off for managed tiers).","operationId":"curator_run_skills_curator_run_post","parameters":[{"in":"query","name":"budget","required":false,"schema":{"default":3,"title":"Budget","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Curator Run Skills Curator Run Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Curator Run","tags":["skills","skills"]}},"/skills/match":{"get":{"description":"Rank active Skills against a task through the same semantic hybrid router used by MCP Skill discovery and routing benchmarks. When semantic embeddings are unavailable, interactive discovery remains usable through deterministic trigger matching; the response reports semantic or keyword_fallback in its routing field.","operationId":"match_skills_endpoint_skills_match_get","parameters":[{"description":"Task/query to rank skills against","in":"query","name":"q","required":true,"schema":{"description":"Task/query to rank skills against","minLength":1,"title":"Q","type":"string"}},{"in":"query","name":"limit","required":false,"schema":{"default":5,"maximum":20,"minimum":1,"title":"Limit","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Match Skills Endpoint Skills Match Get","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Match Skills Endpoint","tags":["skills","skills"]}},"/skills/registration":{"get":{"description":"Per-host registration status (installed? registered? where?). Read-only.","operationId":"skill_host_registration_status_skills_registration_get","responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Skill Host Registration Status Skills Registration Get","type":"object"}}},"description":"Successful Response"}},"summary":"Skill Host Registration Status","tags":["skills","skills","skills"]}},"/skills/registration/{host}":{"delete":{"description":"Remove our entries for one host. Leaves foreign files/links untouched.","operationId":"unregister_skill_host_skills_registration__host__delete","parameters":[{"in":"path","name":"host","required":true,"schema":{"title":"Host","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Unregister Skill Host Skills Registration Host Delete","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Unregister Skill Host","tags":["skills","skills","skills"]},"post":{"description":"Register one host, or ``all`` for every detected host. Idempotent.","operationId":"register_skill_host_skills_registration__host__post","parameters":[{"in":"path","name":"host","required":true,"schema":{"title":"Host","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Register Skill Host Skills Registration Host Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Register Skill Host","tags":["skills","skills","skills"]}},"/skills/registration/{host}/config-dir":{"put":{"description":"Point one host at a custom config dir, then re-sync if it is connected.","operationId":"set_skill_host_config_dir_skills_registration__host__config_dir_put","parameters":[{"in":"path","name":"host","required":true,"schema":{"title":"Host","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HostConfigDir"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Set Skill Host Config Dir Skills Registration Host Config Dir Put","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Set Skill Host Config Dir","tags":["skills","skills","skills"]}},"/skills/{skill_id}":{"get":{"description":"Get one Skill and optionally its procedure body or bounded portable bundle. Bundle files are returned only when explicitly requested; binary files use base64.","operationId":"get_skill_skills__skill_id__get","parameters":[{"description":"Stable Skill ID","in":"path","name":"skill_id","required":true,"schema":{"title":"Skill Id","type":"string"}},{"description":"Include the SKILL.md body","in":"query","name":"include_body","required":false,"schema":{"default":false,"description":"Include the SKILL.md body","title":"Include Body","type":"boolean"}},{"description":"Explicit opt-in for remote native-host projection. Normal UI detail\nrequests stay small and keep binary assets off the wire.","in":"query","name":"include_files","required":false,"schema":{"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Get Skill Skills Skill Id Get","type":"object"}}},"description":"Skill detail"},"404":{"description":"Skill not found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get a Skill","tags":["skills"]}},"/skills/{skill_id}/activate":{"post":{"description":"Publish a reviewed draft skill to active (the consumable surface).\n\nA manual publish: the user reviewed the SKILL.md and chose to publish. The\nmoment it goes live we fire a background verification (the entry gate), so an\nactive skill earns its trust verdict automatically rather than waiting for a\nmanual eval click — that is what makes the home a Verified Library.","operationId":"activate_skill_skills__skill_id__activate_post","parameters":[{"in":"path","name":"skill_id","required":true,"schema":{"title":"Skill Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Activate Skill Skills Skill Id Activate Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Activate Skill","tags":["skills","skills"]}},"/skills/{skill_id}/apply-enrichment":{"post":{"description":"Apply the skill's pending enrichments: link the fresh evidence the\nbackground agent found, then recompile so the body incorporates it. Clears\nthe applied enrichments. The recompile runs async; the body updates shortly.\n\nLooks up by id directly; cross-space when space_id is omitted.","operationId":"apply_skill_enrichment_skills__skill_id__apply_enrichment_post","parameters":[{"in":"path","name":"skill_id","required":true,"schema":{"title":"Skill Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Apply Skill Enrichment Skills Skill Id Apply Enrichment Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Apply Skill Enrichment","tags":["skills","skills"]}},"/skills/{skill_id}/apply-version":{"post":{"description":"Commit a proposed new version (the evolve half of the human-approval gate).\n\n``ProposeSkillVersion`` only records ``metadata.pending_version`` (body +\nrationale); the live bundle is never touched until a human reviews and calls\nthis. Applying swaps the SKILL.md body, preserves the existing assets, bumps\nthe version, and clears the proposal. Stage is unchanged: applying to an\nactive skill republishes it live (the call itself is the approval); a\ndraft/stale skill still needs a separate ``activate``.\n\nReject-on-drift: if the live bundle changed since the proposal was made\n(``base_content_hash`` no longer matches), the proposal is stale — 409, so\nthe agent re-proposes against the current body rather than silently clobbering\nan intervening recompile. Filesystem and graph are not transactional, so a\nfailed graph write restores the prior bundle.","operationId":"apply_skill_version_skills__skill_id__apply_version_post","parameters":[{"in":"path","name":"skill_id","required":true,"schema":{"title":"Skill Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Apply Skill Version Skills Skill Id Apply Version Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Apply Skill Version","tags":["skills","skills"]}},"/skills/{skill_id}/archive":{"post":{"description":"Archive a compiled skill (recoverable; the bundle is retained).","operationId":"archive_skill_skills__skill_id__archive_post","parameters":[{"in":"path","name":"skill_id","required":true,"schema":{"title":"Skill Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Archive Skill Skills Skill Id Archive Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Archive Skill","tags":["skills","skills"]}},"/skills/{skill_id}/deactivate":{"post":{"description":"Turn an active skill OFF: keep it (body, versions, outcomes) but stop your\nagents using it.\n\nThe non-destructive half of the on/off toggle. We move active -> draft (the\ncompiled-but-not-live stage) and un-materialize from host skill dirs, so agents\nstop seeing it. Nothing is lost: turning it back on is the existing ``activate``\n(draft -> active), instant and lossless. This is deliberately NOT ``archive``\n(a removal end-state) and NOT a revert to a suggestion (that would discard the\ncompiled bundle and its history). A toggle must be reversible; discarding is a\nseparate, explicit gesture.\n\nScoped by id; the active set is global, so the materializer reconciles all hosts.","operationId":"deactivate_skill_skills__skill_id__deactivate_post","parameters":[{"in":"path","name":"skill_id","required":true,"schema":{"title":"Skill Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Deactivate Skill Skills Skill Id Deactivate Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Deactivate Skill","tags":["skills","skills"]}},"/skills/{skill_id}/dismiss":{"post":{"description":"Dismiss a candidate (stamps rejected_at via the repository), recording WHY.\n\nThe reason + resurface rule are persisted in metadata so the background\nreviewer doesn't keep re-suggesting the same bad idea (audit §3 P0). A default\nis applied when the caller passes none. By-id-direct; cross-space.","operationId":"dismiss_skill_skills__skill_id__dismiss_post","parameters":[{"in":"path","name":"skill_id","required":true,"schema":{"title":"Skill Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/DismissSkillRequest"},{"type":"null"}],"title":"Req"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Dismiss Skill Skills Skill Id Dismiss Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Dismiss Skill","tags":["skills","skills"]}},"/skills/{skill_id}/dismiss-enrichment":{"post":{"description":"Dismiss the skill's pending enrichments without applying them (the evidence\nstays in the graph; it just won't strengthen this skill). Looks up by id.","operationId":"dismiss_skill_enrichment_skills__skill_id__dismiss_enrichment_post","parameters":[{"in":"path","name":"skill_id","required":true,"schema":{"title":"Skill Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Dismiss Skill Enrichment Skills Skill Id Dismiss Enrichment Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Dismiss Skill Enrichment","tags":["skills","skills"]}},"/skills/{skill_id}/duplicate-of":{"get":{"description":"The active skill this one looks like a duplicate of, or null.\n\nComputed lazily, OFF the detail hot path: it needs embeddings (which can\ncold-start slowly), so the UI fetches it separately after opening a skill — the\nsame non-blocking pattern as the benchmark — keeping skill-open instant. For a\nSUGGESTION the UI offers \"strengthen that one instead\"; for an OFF compiled skill\n(draft/stale) a read-only \"you may already have this\" hint + merge. Active skills\nARE the catalog, so they're never checked against themselves. Best-effort\n(no embeddings -> null). By-id-direct; cross-space.","operationId":"skill_duplicate_of_skills__skill_id__duplicate_of_get","parameters":[{"in":"path","name":"skill_id","required":true,"schema":{"title":"Skill Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Skill Duplicate Of Skills Skill Id Duplicate Of Get","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Skill Duplicate Of","tags":["skills","skills"]}},"/skills/{skill_id}/edit-file":{"post":{"description":"Write one of a skill's own asset files (scripts/references) directly — the\nanswer to \"4 files but I can only edit SKILL.md\". Asset files are opt-gated, so\nthe edit commits straight away (no proof gate, unlike edit-body), bumps the\nversion, and re-syncs tools. SKILL.md/evals refused. By id; cross-space.","operationId":"edit_skill_file_skills__skill_id__edit_file_post","parameters":[{"in":"path","name":"skill_id","required":true,"schema":{"title":"Skill Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillEditFileRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Edit Skill File Skills Skill Id Edit File Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Edit Skill File","tags":["skills","skills"]}},"/skills/{skill_id}/eval":{"get":{"description":"The skill's behavioral benchmark (§16): the cases it's proven on, by status.\n\nv1 returns the case inventory; the with/without run verdict is the v2\nmodel-runner. See docs/implementation/SKILL_EVAL_IMPLEMENTATION.md.","operationId":"get_skill_eval_skills__skill_id__eval_get","parameters":[{"in":"path","name":"skill_id","required":true,"schema":{"title":"Skill Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Get Skill Eval Skills Skill Id Eval Get","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Skill Eval","tags":["skills","skills"]}},"/skills/{skill_id}/eval/cases":{"get":{"description":"List the editable benchmark inventory, including each case task, expectation, deterministic checks, review status, and source. Output cases use expectation output; routing negatives use should_not_trigger and carry no output checks.","operationId":"list_eval_cases_skills__skill_id__eval_cases_get","parameters":[{"in":"path","name":"skill_id","required":true,"schema":{"title":"Skill Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response List Eval Cases Skills Skill Id Eval Cases Get","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"List Eval Cases","tags":["skills","skills"]},"post":{"description":"Add a human-authored benchmark case. Use {task, checks:[{op, arg}], status?} for an output case, or {task, expectation:\"should_not_trigger\"} for a semantic routing negative. Routing negatives assert that production Skill discovery must leave this Skill silent for the near-miss task.","operationId":"add_eval_case_skills__skill_id__eval_cases_post","parameters":[{"in":"path","name":"skill_id","required":true,"schema":{"title":"Skill Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Body","type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Add Eval Case Skills Skill Id Eval Cases Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Add Eval Case","tags":["skills","skills"]}},"/skills/{skill_id}/eval/cases/{task_id}":{"delete":{"description":"Remove a case from the benchmark.","operationId":"delete_eval_case_skills__skill_id__eval_cases__task_id__delete","parameters":[{"in":"path","name":"skill_id","required":true,"schema":{"title":"Skill Id","type":"string"}},{"in":"path","name":"task_id","required":true,"schema":{"title":"Task Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Delete Eval Case Skills Skill Id Eval Cases Task Id Delete","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Delete Eval Case","tags":["skills","skills"]},"patch":{"description":"Edit one case: any of ``{task, checks, status}``. Approving a bootstrapped\ncase is just ``{status: \"green\"}``. The task_id is preserved so a prior run's\ncoverage mapping stays stable.","operationId":"update_eval_case_skills__skill_id__eval_cases__task_id__patch","parameters":[{"in":"path","name":"skill_id","required":true,"schema":{"title":"Skill Id","type":"string"}},{"in":"path","name":"task_id","required":true,"schema":{"title":"Task Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Body","type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Update Eval Case Skills Skill Id Eval Cases Task Id Patch","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Update Eval Case","tags":["skills","skills"]}},"/skills/{skill_id}/eval/run":{"post":{"description":"Run the Skill benchmark and return its verdict. Output cases grade generated behavior; should_not_trigger cases use the production semantic Skill router and become inconclusive when semantic evidence is unavailable rather than falling back to lexical matching. A passing routing negative is a safety gate and cannot by itself prove that a Skill helps on intended work. strict=true runs the output cases through the median-of-3 with/without gate; the streaming variant is /eval/stream.","operationId":"run_skill_eval_skills__skill_id__eval_run_post","parameters":[{"in":"path","name":"skill_id","required":true,"schema":{"title":"Skill Id","type":"string"}},{"in":"query","name":"strict","required":false,"schema":{"default":false,"title":"Strict","type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Run Skill Eval Skills Skill Id Eval Run Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Run Skill Eval","tags":["skills","skills"]}},"/skills/{skill_id}/eval/stream":{"get":{"description":"Run the benchmark, streaming per-case progress (SSE): ``bootstrapping`` ->\n``start`` -> ``case_started`` / ``case_done`` (per case) -> ``summary``. Feeds\nthe 'Proven on' surface case by case. ``strict=true`` runs the Phase 2 gate.","operationId":"stream_skill_eval_skills__skill_id__eval_stream_get","parameters":[{"in":"path","name":"skill_id","required":true,"schema":{"title":"Skill Id","type":"string"}},{"in":"query","name":"strict","required":false,"schema":{"default":false,"title":"Strict","type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Stream Skill Eval","tags":["skills","skills"]}},"/skills/{skill_id}/harden":{"post":{"description":"Run the autonomous skill-hardening loop once: build/grow the harness, then each\nround propose -> prove on the held-out slice -> keep ONLY if strictly better\n(compounding), and stage ONE pending_version for the user's Apply. By-id-direct;\ncross-space. See docs/design/SKILL_AUTONOMOUS_HARDENING_LOOP.md.","operationId":"harden_skill_endpoint_skills__skill_id__harden_post","parameters":[{"in":"path","name":"skill_id","required":true,"schema":{"title":"Skill Id","type":"string"}},{"in":"query","name":"max_rounds","required":false,"schema":{"default":4,"maximum":8,"minimum":1,"title":"Max Rounds","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Harden Skill Endpoint Skills Skill Id Harden Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Harden Skill Endpoint","tags":["skills","skills"]}},"/skills/{skill_id}/merge-into":{"post":{"description":"Merge a compiled skill INTO another, leaving one canonical skill.\n\nThe generalization of strengthen-instead for two COMPILED skills (the curator's\nnear-duplicate pair, or an off draft overlapping an active one): the absorbed\nskill's evidence moves onto the kept skill as a pending enrichment (the user\nreviews + applies it; the kept body is never silently rewritten), and the\nabsorbed skill is ARCHIVED with ``merged_into`` provenance — recoverable, and\nun-materialized from hosts by the shared transition. Outcomes do NOT transfer\n(they were measured against a different body); the kept skill records\n``merged_from`` for honest provenance. A suggestion still uses strengthen-instead\n(its end-state is reject, not archive). See docs/design/SKILL_MERGE_PRIMITIVE.md.\nBy-id-direct; cross-space.","operationId":"merge_into_skills__skill_id__merge_into_post","parameters":[{"in":"path","name":"skill_id","required":true,"schema":{"title":"Skill Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MergeIntoRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Merge Into Skills Skill Id Merge Into Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Merge Into","tags":["skills","skills"]}},"/skills/{skill_id}/outcome":{"post":{"description":"Record how a skill actually performed in use (G1 Tier 2 feedback).\n\nVersion-anchored and content-bearing: the structured deviation/missing/failure\ntext is recompile + eval evidence, not a vanity rating. Updates use_count and a\ncurrent-version success_rate. A real failure also grows the skill's eval (G4),\nin the background. See SKILL_CRYSTALLIZATION.md §3.8.","operationId":"report_skill_outcome_skills__skill_id__outcome_post","parameters":[{"in":"path","name":"skill_id","required":true,"schema":{"title":"Skill Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillOutcomeRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Report Skill Outcome Skills Skill Id Outcome Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Report Skill Outcome","tags":["skills","skills"]}},"/skills/{skill_id}/pending-version":{"delete":{"description":"Remove only the reviewable pending proposal. The live Skill body and version remain unchanged.","operationId":"discard_pending_version_handler","parameters":[{"description":"Skill id","in":"path","name":"skill_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DiscardPendingVersionResponse"}}},"description":"Pending version discarded"},"404":{"description":"Skill not found"},"409":{"description":"The Skill has no pending version"}},"summary":"Discard a pending Skill version","tags":["skills"]}},"/skills/{skill_id}/restore-merge":{"post":{"description":"Restore the absorbed Skill and remove this merge's pending evidence from the kept Skill. Available only until that evidence is applied or changed.","operationId":"restore_merged_skill_handler","parameters":[{"description":"Archived Skill id returned by merge-into","in":"path","name":"skill_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RestoreMergedSkillResponse"}}},"description":"Merge undone"},"404":{"description":"Skill or merge target not found"},"409":{"description":"Skill is not a reversible merge or its evidence is no longer pending"}},"summary":"Undo a Skill merge","tags":["skills"]}},"/skills/{skill_id}/strengthen-instead":{"post":{"description":"Resolve a duplicate suggestion: move its evidence onto the existing active\nskill as a pending enrichment, then dismiss the suggestion.\n\nThe product's one-tap answer to \"this is a skill I already have\": the evidence\nis preserved — it strengthens the real skill via the same pending-enrichment\npath as SuggestSkillEnrichment — instead of being lost to a blunt dismiss. The\ncandidate is a suggestion (``_DISMISSABLE``); the target must be an active skill.\nBy-id-direct; cross-space.","operationId":"strengthen_instead_skills__skill_id__strengthen_instead_post","parameters":[{"in":"path","name":"skill_id","required":true,"schema":{"title":"Skill Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StrengthenInsteadRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Strengthen Instead Skills Skill Id Strengthen Instead Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Strengthen Instead","tags":["skills","skills"]}},"/sources":{"get":{"description":"List sources with optional filtering and pagination.","operationId":"list_sources_sources_get","parameters":[{"in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":200,"minimum":1,"title":"Limit","type":"integer"}},{"in":"query","name":"offset","required":false,"schema":{"default":0,"minimum":0,"title":"Offset","type":"integer"}},{"description":"Filter by source_type","in":"query","name":"source_type","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by source_type","title":"Source Type"}},{"description":"Filter by lifecycle_state","in":"query","name":"lifecycle_state","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by lifecycle_state","title":"Lifecycle State"}},{"description":"Filter by source label name or label_id. Repeat for AND semantics.","in":"query","name":"labels","required":false,"schema":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Filter by source label name or label_id. Repeat for AND semantics.","title":"Labels"}},{"description":"Alias for labels. Repeat for AND semantics.","in":"query","name":"label","required":false,"schema":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Alias for labels. Repeat for AND semantics.","title":"Label"}},{"description":"Filter by source metadata equality, e.g. metadata=customer=acme. Repeat for AND semantics; repeat the same key for OR values.","in":"query","name":"metadata","required":false,"schema":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Filter by source metadata equality, e.g. metadata=customer=acme. Repeat for AND semantics; repeat the same key for OR values.","title":"Metadata"}},{"description":"Isolation space to list","in":"query","name":"space_id","required":false,"schema":{"default":"default","description":"Isolation space to list","title":"Space Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceListResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"List Sources","tags":["sources"]}},"/sources/ingest/batch":{"post":{"description":"Ingest a batch of files at once.","operationId":"ingest_batch_sources_ingest_batch_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchIngestRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchIngestResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Ingest Batch","tags":["sources"]}},"/sources/ingest/content":{"post":{"description":"Ingest raw text content (a paste, or a text file the client read) as a Library\nsource. JSON-only so it works in every transport without multipart/file-path\nplumbing. The text is written to a temp file and run through the same ingest_file\npipeline, so it gets the identical Source lifecycle (parse, index, background\nextraction). Used by Deep Create's 'bring in material'.","operationId":"ingest_content_sources_ingest_content_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IngestContentRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IngestResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Ingest Content","tags":["sources"]}},"/sources/ingest/file":{"post":{"description":"Ingest a file into the library.","operationId":"ingest_file_sources_ingest_file_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/IngestFileUploadRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IngestResponse"}}},"description":"Successful Response"},"400":{"description":"Malformed multipart body or unsupported document parameters"},"408":{"description":"Upload body did not arrive before the bounded read timeout"},"413":{"description":"Upload exceeds the effective Library file limit"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"503":{"description":"Library upload processing capacity is temporarily busy"}},"summary":"Ingest File","tags":["sources"]}},"/sources/ingest/file-path":{"post":{"description":"Ingest a file by its local path.","operationId":"ingest_file_path_sources_ingest_file_path_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IngestFilePathRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IngestResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Ingest File Path","tags":["sources"]}},"/sources/ingest/folder-summary":{"post":{"description":"Emit a folder import summary event for remote/web chunked uploads.","operationId":"ingest_folder_summary_sources_ingest_folder_summary_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FolderIngestSummaryRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchIngestResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Ingest Folder Summary","tags":["sources"]}},"/sources/ingest/folder-upload":{"post":{"description":"Ingest client-uploaded folder files via multipart.\n\nThis is the remote/web-safe folder API. The server never reads a client\nfilesystem path; clients upload file bytes and provide folder-relative\npaths in ``file_manifest``.\n\nSpace-scoped: writes sources to ``space_id``, defaulting to the canonical\ndefault space when omitted.","operationId":"ingest_folder_upload_sources_ingest_folder_upload_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_ingest_folder_upload_sources_ingest_folder_upload_post"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchIngestResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Ingest Folder Upload","tags":["sources"]}},"/sources/ingest/url":{"post":{"description":"Ingest a web page into the library.","operationId":"ingest_url_sources_ingest_url_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IngestUrlRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IngestResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Ingest Url","tags":["sources"]}},"/sources/search":{"get":{"description":"Full-text search across source names and content.","operationId":"search_sources_sources_search_get","parameters":[{"description":"Search query","in":"query","name":"q","required":true,"schema":{"description":"Search query","minLength":1,"title":"Q","type":"string"}},{"in":"query","name":"limit","required":false,"schema":{"default":20,"maximum":100,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Filter by source label name or label_id. Repeat for AND semantics.","in":"query","name":"labels","required":false,"schema":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Filter by source label name or label_id. Repeat for AND semantics.","title":"Labels"}},{"description":"Alias for labels. Repeat for AND semantics.","in":"query","name":"label","required":false,"schema":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Alias for labels. Repeat for AND semantics.","title":"Label"}},{"description":"Filter by source metadata equality, e.g. metadata=customer=acme. Repeat for AND semantics; repeat the same key for OR values.","in":"query","name":"metadata","required":false,"schema":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Filter by source metadata equality, e.g. metadata=customer=acme. Repeat for AND semantics; repeat the same key for OR values.","title":"Metadata"}},{"description":"Isolation space to search","in":"query","name":"space_id","required":false,"schema":{"default":"default","description":"Isolation space to search","title":"Space Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceSearchResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Search Sources","tags":["sources"]}},"/sources/{source_id}":{"delete":{"description":"Delete a source and its search index records.","operationId":"delete_source_sources__source_id__delete","parameters":[{"in":"path","name":"source_id","required":true,"schema":{"title":"Source Id","type":"string"}},{"description":"Optional isolation space guard","in":"query","name":"space_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional isolation space guard","title":"Space Id"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Delete Source Sources Source Id Delete","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Delete Source","tags":["sources"]},"get":{"description":"Get source detail with related memories and revision chain.","operationId":"get_source_detail_sources__source_id__get","parameters":[{"in":"path","name":"source_id","required":true,"schema":{"title":"Source Id","type":"string"}},{"description":"Optional isolation space guard","in":"query","name":"space_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional isolation space guard","title":"Space Id"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceDetailResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Source Detail","tags":["sources"]},"patch":{"description":"Update a source's processing state.\n\nSupported actions:\n\n- **reparse** re-extract and re-index the content.\n- **ocr_reparse** run or retry vision OCR for deterministic candidate PDF pages.\n- **mark_stale** flag the source as needing re-processing.","operationId":"update_source_sources__source_id__patch","parameters":[{"in":"path","name":"source_id","required":true,"schema":{"title":"Source Id","type":"string"}},{"description":"Optional isolation space guard","in":"query","name":"space_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional isolation space guard","title":"Space Id"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateSourceRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Update Source","tags":["sources"]}},"/sources/{source_id}/content":{"get":{"description":"Read the parsed text content of a source.","operationId":"get_source_content_sources__source_id__content_get","parameters":[{"in":"path","name":"source_id","required":true,"schema":{"title":"Source Id","type":"string"}},{"description":"Character offset for pagination","in":"query","name":"offset","required":false,"schema":{"default":0,"description":"Character offset for pagination","minimum":0,"title":"Offset","type":"integer"}},{"description":"Maximum characters to return. Omit to read the full parsed content.","in":"query","name":"limit","required":false,"schema":{"anyOf":[{"maximum":50000,"minimum":100,"type":"integer"},{"type":"null"}],"description":"Maximum characters to return. Omit to read the full parsed content.","title":"Limit"}},{"description":"Optional isolation space guard","in":"query","name":"space_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional isolation space guard","title":"Space Id"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceContentResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Source Content","tags":["sources"]},"put":{"description":"Replace the markdown body of an editable source artifact.\n\nUsed by the Library inline editor for agent-generated artifacts (reports,\nblog drafts) and any other markdown source where editing in place makes\nsense. Re-runs chunk + index so search stays fresh.","operationId":"update_source_content_sources__source_id__content_put","parameters":[{"in":"path","name":"source_id","required":true,"schema":{"title":"Source Id","type":"string"}},{"description":"Optional isolation space guard","in":"query","name":"space_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional isolation space guard","title":"Space Id"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateSourceContentRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Update Source Content","tags":["sources"]}},"/sources/{source_id}/extract":{"post":{"description":"Queue knowledge extraction for a source. Returns 202 when the extraction task is queued or already queued; 5xx is reserved for genuine rejection.","operationId":"trigger_source_extraction_sources__source_id__extract_post","parameters":[{"in":"path","name":"source_id","required":true,"schema":{"title":"Source Id","type":"string"}},{"description":"Optional isolation space guard","in":"query","name":"space_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional isolation space guard","title":"Space Id"}}],"responses":{"202":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"SourceExtractionQueuedResponse","type":"object"}}},"description":"Extraction queued"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"SourceExtractionErrorResponse","type":"object"}}},"description":"Knowledge Agent is not running"}},"summary":"Trigger Source Extraction","tags":["sources"]}},"/sources/{source_id}/images/{filename}":{"get":{"description":"Serve an extracted image from a source's images/ directory.","operationId":"get_source_image_sources__source_id__images__filename__get","parameters":[{"in":"path","name":"source_id","required":true,"schema":{"title":"Source Id","type":"string"}},{"in":"path","name":"filename","required":true,"schema":{"title":"Filename","type":"string"}},{"description":"Optional isolation space guard","in":"query","name":"space_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional isolation space guard","title":"Space Id"}}],"responses":{"200":{"content":{"application/json":{"schema":{"title":"Response Get Source Image Sources Source Id Images Filename Get"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Source Image","tags":["sources"]}},"/sources/{source_id}/labels":{"get":{"description":"Get labels assigned to a source.","operationId":"get_source_labels_sources__source_id__labels_get","parameters":[{"in":"path","name":"source_id","required":true,"schema":{"title":"Source Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabelsResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Source Labels","tags":["sources"]}},"/sources/{source_id}/labels/{label_id}":{"delete":{"description":"Remove a label from a source.","operationId":"remove_label_from_source_sources__source_id__labels__label_id__delete","parameters":[{"in":"path","name":"source_id","required":true,"schema":{"title":"Source Id","type":"string"}},{"in":"path","name":"label_id","required":true,"schema":{"title":"Label Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Remove Label From Source","tags":["sources"]},"post":{"description":"Assign a label to a source.","operationId":"assign_label_to_source_sources__source_id__labels__label_id__post","parameters":[{"in":"path","name":"source_id","required":true,"schema":{"title":"Source Id","type":"string"}},{"in":"path","name":"label_id","required":true,"schema":{"title":"Label Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Assign Label To Source","tags":["sources"]}},"/sources/{source_id}/raw":{"get":{"description":"Serve the raw source file for native preview (PDF, DOCX, etc).","operationId":"get_source_raw_sources__source_id__raw_get","parameters":[{"in":"path","name":"source_id","required":true,"schema":{"title":"Source Id","type":"string"}},{"description":"Optional isolation space guard","in":"query","name":"space_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional isolation space guard","title":"Space Id"}}],"responses":{"200":{"content":{"application/json":{"schema":{"title":"Response Get Source Raw Sources Source Id Raw Get"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Source Raw","tags":["sources"]}},"/sources/{source_id}/refetch":{"post":{"description":"Re-fetch and re-parse a URL source.","operationId":"refetch_source_sources__source_id__refetch_post","parameters":[{"in":"path","name":"source_id","required":true,"schema":{"title":"Source Id","type":"string"}},{"description":"Optional isolation space guard","in":"query","name":"space_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional isolation space guard","title":"Space Id"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"title":"Response Refetch Source Sources Source Id Refetch Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Refetch Source","tags":["sources"]}},"/spaces":{"get":{"operationId":"get_spaces_spaces_get","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemorySpaceSettingsResponse"}}},"description":"Successful Response"}},"summary":"Get Spaces","tags":["spaces","spaces"]},"post":{"operationId":"create_space_spaces_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemorySpacePayload"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemorySpaceSettingsResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Create Space","tags":["spaces","spaces"]}},"/spaces/config":{"post":{"operationId":"update_space_settings_spaces_config_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemorySpaceSettingsUpdate"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemorySpaceSettingsResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Update Space Settings","tags":["spaces","spaces"]}},"/spaces/roster":{"get":{"operationId":"get_space_roster_spaces_roster_get","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemorySpaceSettingsResponse"}}},"description":"Successful Response"}},"summary":"Get Space Roster","tags":["spaces","spaces"]}},"/spaces/{space_ref}":{"delete":{"operationId":"delete_space_spaces__space_ref__delete","parameters":[{"in":"path","name":"space_ref","required":true,"schema":{"title":"Space Ref","type":"string"}},{"in":"query","name":"purge_working_memory","required":false,"schema":{"default":false,"title":"Purge Working Memory","type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemorySpaceSettingsResponse"}}},"description":"Successful Response"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemorySpaceDeleteConflictResponse"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Delete Space","tags":["spaces","spaces"]},"get":{"operationId":"get_space_spaces__space_ref__get","parameters":[{"in":"path","name":"space_ref","required":true,"schema":{"title":"Space Ref","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemorySpaceResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Space","tags":["spaces","spaces"]},"patch":{"operationId":"update_space_spaces__space_ref__patch","parameters":[{"in":"path","name":"space_ref","required":true,"schema":{"title":"Space Ref","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemorySpaceUpdatePayload"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemorySpaceSettingsResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Update Space","tags":["spaces","spaces"]}},"/spaces/{space_ref}/merge":{"post":{"description":"Move Memories, Threads, Library sources, and Working Memory into the target Space, retire the source profile, and preserve its references as target aliases. Apply is rejected when preview reports conflicts.","operationId":"merge_space_spaces__space_ref__merge_post","parameters":[{"in":"path","name":"space_ref","required":true,"schema":{"title":"Space Ref","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SpaceMergeRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SpaceMergeResult"}}},"description":"Successful Response"},"409":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Merge Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Merge Spaces","tags":["spaces"]}},"/spaces/{space_ref}/merge/preview":{"post":{"description":"Preview an exact, server-owned Space merge plan without changing data. Returns entity counts, Working Memory disposition, and any conflicts that must be resolved before apply.","operationId":"preview_space_merge_spaces__space_ref__merge_preview_post","parameters":[{"in":"path","name":"space_ref","required":true,"schema":{"title":"Space Ref","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SpaceMergeRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SpaceMergePlan"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Preview Space Merge","tags":["spaces"]}},"/storage/info":{"get":{"description":"Return on-disk sizes for graph, message store, and search projection.","operationId":"get_storage_info_storage_info_get","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StorageInfoResponse"}}},"description":"Successful Response"}},"summary":"Get Storage Info","tags":["memories"]}},"/storage/optimize":{"post":{"description":"Compact every search projection table's Lance fragments, prune verified old snapshots, and checkpoint the graph database. Pre-compaction snapshots remain available to existing readers and are reclaimed after the next backend start. The response reports completed, partial, or refused outcomes and safe table-level details.","operationId":"optimize_storage_storage_optimize_post","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OptimizeStorageResponse"}}},"description":"Successful Response"}},"summary":"Optimize Storage","tags":["memories"]}},"/threads":{"get":{"description":"List threads with filtering and pagination.","operationId":"list_threads_threads_get","parameters":[{"in":"query","name":"limit","required":false,"schema":{"default":20,"maximum":1000,"minimum":1,"title":"Limit","type":"integer"}},{"in":"query","name":"offset","required":false,"schema":{"default":0,"minimum":0,"title":"Offset","type":"integer"}},{"in":"query","name":"source","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"}},{"description":"Optional isolation space to list","in":"query","name":"space_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional isolation space to list","title":"Space Id"}},{"description":"Opaque exact project key returned by GET /threads/projects. Invalid keys return 422. Omit for all projects.","in":"query","name":"project_key","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ThreadListResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"List Threads","tags":["threads"]},"post":{"description":"Create a new thread with messages.","operationId":"create_thread_threads_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ThreadCreateRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ThreadCreateResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Create Thread","tags":["threads"]}},"/threads/bulk":{"delete":{"description":"Delete multiple threads and optionally their extracted memories.","operationId":"bulk_delete_threads_threads_bulk_delete","parameters":[{"description":"Delete extracted memories","in":"query","name":"cascade_delete_memories","required":false,"schema":{"default":false,"description":"Delete extracted memories","title":"Cascade Delete Memories","type":"boolean"}},{"description":"Optional isolation space guard","in":"query","name":"space_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional isolation space guard","title":"Space Id"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkDeleteThreadsRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkDeleteThreadsResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Bulk Delete Threads","tags":["threads"]}},"/threads/bulk/delete":{"post":{"description":"Delete a bounded thread selection inside one source space.","operationId":"bulk_delete_threads_by_selection_threads_bulk_delete_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkDeleteThreadsBySelectionRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkDeleteThreadsResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Bulk Delete Threads By Selection","tags":["threads"]}},"/threads/bulk/move":{"post":{"description":"Move a bounded selection of threads into another space.","operationId":"bulk_move_threads_threads_bulk_move_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkMoveThreadsRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkMoveThreadsResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Bulk Move Threads","tags":["threads"]}},"/threads/bulk/move/preview":{"post":{"description":"Preview a bounded bulk thread move before mutating data.","operationId":"preview_bulk_move_threads_threads_bulk_move_preview_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkMoveThreadsRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkMoveThreadsPreviewResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Preview Bulk Move Threads","tags":["threads"]}},"/threads/conversations/discover":{"get":{"description":"Discover conversation files from AI coding assistants.\n\nScans file system for conversation files from Claude Code, Codex, Cursor, and OpenCode.","operationId":"discover_conversations_threads_conversations_discover_get","parameters":[{"description":"Filter by source: claude, codex, cursor, opencode, or None for all","in":"query","name":"source","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by source: claude, codex, cursor, opencode, or None for all","title":"Source"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationDiscoveryResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Discover Conversations","tags":["threads"]}},"/threads/conversations/export-raw":{"post":{"description":"Export a raw conversation file as markdown or JSON without importing.\n\nParses the session file using the same parsers as import, but returns\nformatted content directly instead of creating a thread.","operationId":"export_conversation_raw_threads_conversations_export_raw_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationExportRawRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Export Conversation Raw","tags":["threads"]}},"/threads/conversations/import":{"post":{"description":"Import a conversation file into Nowledge Mem.\n\nConverts external conversation formats (Claude Code, Codex, Cursor, OpenCode) into threads.","operationId":"import_conversation_threads_conversations_import_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationImportRequestModel"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationImportResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Import Conversation","tags":["threads"]}},"/threads/conversations/preview":{"post":{"description":"Load a richer preview for one selected discovered conversation.","operationId":"preview_conversation_threads_conversations_preview_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationPreviewRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationPreviewResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Preview Conversation","tags":["threads"]}},"/threads/history-sync/completed":{"post":{"description":"Record a single Timeline card for a completed CLI history sync.","operationId":"mark_thread_history_sync_completed_threads_history_sync_completed_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ThreadHistorySyncCompletedRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Mark Thread History Sync Completed Threads History Sync Completed Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Mark Thread History Sync Completed","tags":["threads"]}},"/threads/import":{"post":{"description":"Import one conversation with the flat request fields, or use `threads` for a batch. Each item accepts parsed `messages` or conversation `markdown_content`. Provider and frontmatter identities are preserved; otherwise a stable identity is derived from the immutable conversation prefix. Exact replays succeed as already up to date, while later exports append only missing messages. See the [Conversation Markdown format](https://github.com/nowledge-co/community/blob/main/examples/conversation-markdown.md) for portable `.md` files.","operationId":"import_threads_threads_import_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ThreadImportRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ThreadImportResponse"}}},"description":"Per-conversation import results"},"400":{"description":"No import content supplied"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Import conversations idempotently","tags":["threads"]}},"/threads/import-config":{"get":{"description":"Get the current import configuration.","operationId":"get_import_config_threads_import_config_get","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImportConfigModel"}}},"description":"Successful Response"}},"summary":"Get Import Config","tags":["threads"]},"put":{"description":"Update import configuration.","operationId":"update_import_config_threads_import_config_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImportConfigUpdateRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImportConfigModel"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Update Import Config","tags":["threads"]}},"/threads/import-config/hide-project":{"post":{"description":"Hide a project from the browse view.","operationId":"hide_project_threads_import_config_hide_project_post","parameters":[{"description":"Encoded project path","in":"query","name":"project_encoded","required":true,"schema":{"description":"Encoded project path","title":"Project Encoded","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Hide Project Threads Import Config Hide Project Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Hide Project","tags":["threads"]}},"/threads/import-config/hide-session":{"post":{"description":"Hide a session from the browse view.","operationId":"hide_session_threads_import_config_hide_session_post","parameters":[{"description":"Session ID","in":"query","name":"session_id","required":true,"schema":{"description":"Session ID","title":"Session Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Hide Session Threads Import Config Hide Session Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Hide Session","tags":["threads"]}},"/threads/import-config/unhide-project":{"post":{"description":"Unhide a project.","operationId":"unhide_project_threads_import_config_unhide_project_post","parameters":[{"description":"Encoded project path","in":"query","name":"project_encoded","required":true,"schema":{"description":"Encoded project path","title":"Project Encoded","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Unhide Project Threads Import Config Unhide Project Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Unhide Project","tags":["threads"]}},"/threads/import-config/unhide-session":{"post":{"description":"Unhide a session.","operationId":"unhide_session_threads_import_config_unhide_session_post","parameters":[{"description":"Session ID","in":"query","name":"session_id","required":true,"schema":{"description":"Session ID","title":"Session Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Unhide Session Threads Import Config Unhide Session Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Unhide Session","tags":["threads"]}},"/threads/parse":{"post":{"description":"Parse thread content from various formats.","operationId":"parse_thread_content_threads_parse_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ThreadParseRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ThreadParseResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Parse Thread Content","tags":["distillation"]}},"/threads/projects":{"get":{"description":"Paginated directory over all readable saved conversations matching source and Space. Full workspace path is authoritative when present, otherwise project name, otherwise unknown. Keys preserve exact values and are passed unchanged to the thread list. Counts include logical conversations, not historical duplicate storage rows.","operationId":"list_thread_projects_threads_projects_get","parameters":[{"in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":100,"minimum":1,"title":"Limit","type":"integer"}},{"in":"query","name":"offset","required":false,"schema":{"default":0,"minimum":0,"title":"Offset","type":"integer"}},{"in":"query","name":"source","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"}},{"description":"Optional isolation space to list","in":"query","name":"space_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional isolation space to list","title":"Space Id"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ThreadProjectListResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"List Saved Conversation Projects","tags":["threads"]}},"/threads/search":{"get":{"description":"Full thread search with message matching.","operationId":"search_threads_full_threads_search_get","parameters":[{"description":"Search query","in":"query","name":"query","required":true,"schema":{"description":"Search query","title":"Query","type":"string"}},{"description":"Search mode: 'suggestions' or 'full'","in":"query","name":"mode","required":false,"schema":{"default":"full","description":"Search mode: 'suggestions' or 'full'","title":"Mode","type":"string"}},{"in":"query","name":"limit","required":false,"schema":{"default":20,"maximum":500,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Filter by source (e.g. 'openclaw', 'claude-code')","in":"query","name":"source","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by source (e.g. 'openclaw', 'claude-code')","title":"Source"}},{"description":"Optional isolation space to search","in":"query","name":"space_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional isolation space to search","title":"Space Id"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ThreadSearchResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Search Threads Full","tags":["threads"]}},"/threads/sessions/save":{"post":{"description":"Save coding session(s) as conversation thread(s).\n\nAuto-detects sessions from project_path. Creates new thread or appends to existing\n(with deduplication). Supports Claude Code, Codex, and Gemini CLI.\n\nThis endpoint assumes the backend machine can read the session files\ndirectly, so it is a local-host import surface. Remote-safe capture should\nuse ``nmem t save --from ...`` from the client machine instead.\n\nArgs:\n request: Session save request with client, project_path, and options\n\nReturns:\n SessionSaveResponse with results for each processed session","operationId":"save_session_threads_sessions_save_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionSaveRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionSaveResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Save Session","tags":["threads"]}},"/threads/sources":{"get":{"description":"Get thread source filters across the full thread set.","operationId":"get_thread_sources_threads_sources_get","parameters":[{"description":"Optional isolation space to inspect","in":"query","name":"space_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional isolation space to inspect","title":"Space Id"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ThreadSourceListResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Thread Sources","tags":["threads"]}},"/threads/summaries":{"get":{"description":"Get all thread titles/summaries.","operationId":"get_thread_summaries_threads_summaries_get","parameters":[{"description":"Optional isolation space to list","in":"query","name":"space_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional isolation space to list","title":"Space Id"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ThreadSummariesResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Thread Summaries","tags":["threads"]}},"/threads/watcher/start":{"post":{"description":"Start the session watcher for auto-importing sessions.","operationId":"start_watcher_threads_watcher_start_post","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WatcherStatusModel"}}},"description":"Successful Response"}},"summary":"Start Watcher","tags":["threads"]}},"/threads/watcher/status":{"get":{"description":"Get the current status of the session watcher.","operationId":"get_watcher_status_threads_watcher_status_get","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WatcherStatusModel"}}},"description":"Successful Response"}},"summary":"Get Watcher Status","tags":["threads"]}},"/threads/watcher/stop":{"post":{"description":"Stop the session watcher.","operationId":"stop_watcher_threads_watcher_stop_post","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WatcherStatusModel"}}},"description":"Successful Response"}},"summary":"Stop Watcher","tags":["threads"]}},"/threads/{thread_id}":{"delete":{"description":"Delete a thread and optionally its extracted memories. App cascade commits are per Memory, not one transaction with the parent Thread. Errors may report prior committed Memory deletions and uncertain outcomes. Cloud currently reports zero extracted Memory deletions even when cascade was requested.","operationId":"delete_thread_threads__thread_id__delete","parameters":[{"in":"path","name":"thread_id","required":true,"schema":{"title":"Thread Id","type":"string"}},{"description":"Delete extracted memories","in":"query","name":"cascade_delete_memories","required":false,"schema":{"default":false,"description":"Delete extracted memories","title":"Cascade Delete Memories","type":"boolean"}},{"description":"Optional isolation space guard","in":"query","name":"space_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional isolation space guard","title":"Space Id"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteThreadResponse"}}},"description":"Successful Response"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ThreadDeletionErrorResponse"}}},"description":"Caller denied. Prior authorized Memory commits, if any, are not rolled back."},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ThreadDeletionErrorResponse"}}},"description":"App target identity, Space or source linkage changed before a graph write."},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ThreadDeletionErrorResponse"}}},"description":"Deletion could not fully complete. Inspect optional progress; an error does not prove rollback."}},"summary":"Delete Thread","tags":["threads"]},"get":{"description":"Get a thread with messages. Supports pagination via limit/offset.","operationId":"get_thread_threads__thread_id__get","parameters":[{"in":"path","name":"thread_id","required":true,"schema":{"title":"Thread Id","type":"string"}},{"description":"Max messages to return; 0 returns metadata without messages","in":"query","name":"limit","required":false,"schema":{"anyOf":[{"maximum":500,"minimum":0,"type":"integer"},{"type":"null"}],"description":"Max messages to return; 0 returns metadata without messages","title":"Limit"}},{"description":"Skip first N messages","in":"query","name":"offset","required":false,"schema":{"default":0,"description":"Skip first N messages","minimum":0,"title":"Offset","type":"integer"}},{"description":"Optional isolation space guard","in":"query","name":"space_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional isolation space guard","title":"Space Id"}},{"description":"Optional canonical Local stored-row URI returned as thread_reference. Selects that exact row within the existing Space lens. It never falls back to thread_id. Hosted Cloud rejects Local stored references.","in":"query","name":"thread_reference","required":false,"schema":{"type":"string"}},{"description":"Local/self-hosted detail-only selector. public resolves the canonical public ID without a storage fallback; storage selects its immutable storage ID. Cannot be combined with thread_reference. An explicit space_id is matched exactly, including blank, whitespace, padded and literal all values.","in":"query","name":"identity_namespace","required":false,"schema":{"enum":["public","storage"],"type":"string"}},{"description":"Request exact identity proof before a mutation. More than one readable public/storage match returns thread_read_identity_ambiguous. A successful proof response includes identity_is_unique=true; older servers without that proof must not authorize an inferred-Space write. Ordinary browsing is unchanged.","in":"query","name":"require_unique_identity","required":false,"schema":{"default":false,"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ThreadFetchResponse"}}},"description":"Successful Response When require_unique_identity=true, identity_is_unique=true confirms a unique readable target in the selected scope."},"400":{"description":"Invalid or incompatible selectors, including combining identity_namespace and thread_reference. Malformed or noncanonical thread_reference (error_code: INVALID_RESOURCE_URI)"},"404":{"description":"Thread not found in the selected identity and Space scope, including a valid exact reference absent from the requested Space."},"409":{"description":"Thread identity is ambiguous within the selected scope (thread_read_identity_ambiguous)."},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"500":{"description":"Typed Thread read failure, including thread_message_ownership_conflict when message ownership validation fails. The registered error_code distinguishes the cause."}},"summary":"Get Thread","tags":["threads"]}},"/threads/{thread_id}/append":{"post":{"description":"Append messages to existing thread (for MCP integration).\n\nSupports two modes:\n1. Direct messages: `{\"messages\": [...]}`\n2. File-based: `{\"file_path\": \"...\", \"format\": \"auto\"}`\n\nOptional controls:\n- `deduplicate` (default: true)\n- `idempotency_key` (string; used to derive stable external_ids)\n- `space_id` (optional; guards appends to a specific Mem space)","operationId":"append_messages_to_thread_threads__thread_id__append_post","parameters":[{"in":"path","name":"thread_id","required":true,"schema":{"title":"Thread Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Request","type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppendMessagesResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Append Messages To Thread","tags":["threads"]}},"/threads/{thread_id}/coverage":{"get":{"description":"Read-only coverage report for debugging progress issues.","operationId":"get_thread_coverage_threads__thread_id__coverage_get","parameters":[{"in":"path","name":"thread_id","required":true,"schema":{"title":"Thread Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ThreadCoverageResponse"}}},"description":"Successful Response"},"404":{"description":"Thread not found in the selected scope."},"409":{"description":"Thread identity is ambiguous within the selected scope (thread_read_identity_ambiguous)."},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"500":{"description":"Typed Thread read failure, including thread_message_ownership_conflict when message ownership validation fails. The registered error_code distinguishes the cause."}},"summary":"Get Thread Coverage","tags":["threads"]}},"/threads/{thread_id}/export":{"get":{"description":"Export a thread in various formats.","operationId":"export_thread_threads__thread_id__export_get","parameters":[{"in":"path","name":"thread_id","required":true,"schema":{"title":"Thread Id","type":"string"}},{"description":"Export format: json, markdown, html","in":"query","name":"format","required":false,"schema":{"default":"json","description":"Export format: json, markdown, html","title":"Format","type":"string"}},{"description":"Include thread metadata","in":"query","name":"include_metadata","required":false,"schema":{"default":true,"description":"Include thread metadata","title":"Include Metadata","type":"boolean"}},{"description":"Optional canonical Local stored-row URI returned as thread_reference. Selects that exact row within the existing Space lens. It never falls back to thread_id. Hosted Cloud rejects Local stored references.","in":"query","name":"thread_reference","required":false,"schema":{"type":"string"}},{"description":"Optional exact conversation Space lens.","in":"query","name":"space_id","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response","headers":{"X-Nmem-Thread-Reference":{"description":"Present for exact-reference exports. Computed from the selected storage row; clients must verify it before saving.","schema":{"type":"string"}}}},"400":{"description":"Invalid export format or Thread reference selector. Malformed or noncanonical thread_reference (error_code: INVALID_RESOURCE_URI)"},"404":{"description":"Thread not found in the selected identity and Space scope, including a valid exact reference absent from the requested Space."},"409":{"description":"Thread identity is ambiguous within the selected scope (thread_export_identity_ambiguous)."},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"500":{"description":"Typed Thread read failure, including thread_message_ownership_conflict when message ownership validation fails. The registered error_code distinguishes the cause."}},"summary":"Export Thread","tags":["threads"]}},"/threads/{thread_id}/favorite":{"post":{"description":"Toggle favorite status for a thread.","operationId":"toggle_thread_favorite_threads__thread_id__favorite_post","parameters":[{"in":"path","name":"thread_id","required":true,"schema":{"title":"Thread Id","type":"string"}},{"description":"Set favorite status","in":"query","name":"is_favorite","required":true,"schema":{"description":"Set favorite status","title":"Is Favorite","type":"boolean"}},{"description":"Optional isolation space for disambiguating duplicate thread IDs","in":"query","name":"space_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional isolation space for disambiguating duplicate thread IDs","title":"Space Id"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Toggle Thread Favorite","tags":["memories"]}},"/threads/{thread_id}/reconcile-tail":{"post":{"description":"Safely replace the tail of a thread without changing append semantics.\n\nOptional request fields:\n- `matched_count` (required int): Number of leading messages that still match\n- `messages` (required array): Replacement tail messages\n- `expected_tail_ids` (optional string[]): Current remote tail message IDs for optimistic concurrency","operationId":"reconcile_thread_tail_threads__thread_id__reconcile_tail_post","parameters":[{"in":"path","name":"thread_id","required":true,"schema":{"title":"Thread Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Request","type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReconcileTailResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Reconcile Thread Tail","tags":["threads"]}},"/threads/{thread_id}/title":{"post":{"description":"Explicit title edit for one exact Space and immutable storage identity. The path is the canonical public/provider thread_id from a preceding scoped detail read, encoded as one opaque path segment. Requires server-owned NMEM_THREAD_TITLE_UPDATE_ENABLED=1 (default off). Same-title requests do not change timestamps or acquire manual ownership. A changed title records nmem_manual_title=true and preserves identity, Space, messages and Memory relationships. Local REST/MCP uses the legacy graph authority, including qualified legacy-authoritative HawDB mirroring; native-primary/only authority is not activated. Cloud REST/MCP retains PostgreSQL authority and delegates the bounded title decision to its Go worker. A Local adapter with an active Cloud target refuses without changing local data; use thread_title_update on the Cloud MCP target from Connect. Search repair may remain pending after the authoritative write. No UI contract is added.","operationId":"update_thread_title_threads_thread_id_title_post","parameters":[{"description":"Exact public/provider thread_id from scoped detail, percent-encoded as one path segment.","in":"path","name":"thread_id","required":true,"schema":{"minLength":1,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ThreadTitleUpdateRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ThreadTitleUpdateResponse"}}},"description":"Authoritative title result, including an identical-title no-op; index_repair_pending is not a failed write."},"400":{"description":"Malformed JSON, shape/type mismatch, unknown fields, invalid content type, blank identity/Space/title, controls, or more than 500 Unicode scalar values (thread_title_request_invalid)."},"403":{"description":"Server feature disabled (feature_disabled) or caller/Space authority refusal."},"404":{"description":"Cloud scoped Thread not found; older servers may not expose this route. Local identity mismatches use the non-leaking 409 cause."},"409":{"description":"Registered causes: thread_title_identity_changed (reread exact detail); thread_title_metadata_invalid (metadata requires review); thread_title_cloud_target_active (use the Cloud MCP target, no local write); thread_title_authority_busy (authority is changing, retry later). Status alone does not identify the cause."},"500":{"description":"Storage or projection-obligation establishment failed; preserve any structured error_code, retryable and request_id."},"502":{"description":"Cloud title worker returned an incompatible response (thread_title_engine_protocol_invalid)."},"503":{"description":"Registered backend/admission cause, or Cloud thread_title_engine_unavailable, thread_title_engine_busy, thread_title_engine_timeout. Preserve the structured cause rather than infer it from status."}},"summary":"Rename a saved Thread in place","tags":["threads"]}},"/v1/embeddings":{"post":{"description":"Generate embeddings with the active search model on this local or self-hosted server. Supports OpenAI-compatible float and base64 responses plus the optional Nowledge input_type extension. The endpoint is not available on Nowledge Cloud. If a remote embedding provider is active, calls are forwarded by this server and count toward that provider's usage.","operationId":"create_embeddings_v1_embeddings_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAIEmbeddingRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAIEmbeddingResponse"}}},"description":"Embeddings in input order"},"400":{"description":"Invalid request or model mismatch"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"500":{"description":"Embedding generation failed"},"503":{"description":"No real embedding model is active"}},"summary":"Create embeddings","tags":["openai-compatible"]}},"/v1/models":{"get":{"description":"List the active search embedding model on this local or self-hosted server. The endpoint is not available on Nowledge Cloud. If a remote embedding provider is selected in Settings, requests are forwarded by this server and count toward that provider's usage.","operationId":"list_models_v1_models_get","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAIModelListResponse"}}},"description":"Active embedding model"},"503":{"description":"No real embedding model is active"}},"summary":"List the active embedding model","tags":["openai-compatible"]}},"/identity/cards/draft":{"post":{"tags":["memories"],"summary":"Propose identity cards from a conversation","description":"Use the target server's normal authentication and an explicit exact Space ID. Requires a human actor with current write authority, re-admitted before any model work, because the request calls the configured model once. Reads one imported conversation the caller can see in that Space and proposes up to 8 identity cards (people, agents and roles taking part). Drafts that match an enrolled profile carry its ID, its current card (returned alongside the draft, not sent to the model) and `changes`: what saving the draft would add or correct. Nothing is saved; save a reviewed draft with POST /identity/cards.","operationId":"draft_identity_cards","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityCardDraftRequest"}}}},"responses":{"200":{"description":"Proposed cards; nothing is saved.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityCardDrafts"}}}},"400":{"description":"Malformed path or query; framework validation may return plain text."},"401":{"description":"Authentication is required by the target server."},"403":{"description":"Current actor, credential or Space authority denies this operation. Identity-specific denials use IdentityOperationError; earlier authentication gates may use their generic error format."},"404":{"description":"The Memory, profile, Space or linked AI Identity/member is unavailable to this operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityOperationError"}}}},"409":{"description":"A current-state, capacity or concurrency condition prevents the operation, including a subject already linked to another profile in this Space. Inspect error_code; not every conflict means stale evidence.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityOperationError"}}}},"413":{"description":"Source, snapshot or profile payload exceeds the bounded operation limit.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityOperationError"}}}},"422":{"description":"Invalid request keys, selection or profile. Identity validation uses IdentityOperationError; malformed JSON or DTO decoding may return a framework validation response."},"500":{"description":"Storage or worker failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityOperationError"}}}},"502":{"description":"The model reply could not be used.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityOperationError"}}}},"503":{"description":"Current authorization, storage or model admission is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityOperationError"}}}}}}},"/identity/cards":{"post":{"tags":["memories"],"summary":"Save an identity card","description":"Use the target server's normal authentication and an explicit exact Space ID. Requires a human actor with current write authority. With profile_id null, creates a new profile from name and aliases and attaches the card. Otherwise grows the profile's card when expected_card_revision equals its current card revision (null when it has no card): kind and summary take the new values, every list keeps its current items and adds new ones, and only `remove` takes items out (applied to the current card first, so a correction can name the old item and propose the new one). Growth that would exceed a list bound is refused with identity_card_full instead of dropping items. Saving a card never changes names, aliases or mention links and does not invoke a model. If the profile was created but the card write failed, the error body carries `profile_id`; retry with that ID instead of creating again.","operationId":"save_identity_card","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityCardSave"}}}},"responses":{"200":{"description":"Current committed identity data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityCardSaved"}}}},"400":{"description":"Malformed path or query; framework validation may return plain text."},"401":{"description":"Authentication is required by the target server."},"403":{"description":"Current actor, credential or Space authority denies this operation. Identity-specific denials use IdentityOperationError; earlier authentication gates may use their generic error format."},"404":{"description":"The Memory, profile, Space or linked AI Identity/member is unavailable to this operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityOperationError"}}}},"409":{"description":"A current-state, capacity or concurrency condition prevents the operation, including a subject already linked to another profile in this Space. Inspect error_code; not every conflict means stale evidence.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityOperationError"}}}},"413":{"description":"Source, snapshot or profile payload exceeds the bounded operation limit.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityOperationError"}}}},"422":{"description":"Invalid request keys, selection or profile. Identity validation uses IdentityOperationError; malformed JSON or DTO decoding may return a framework validation response."},"500":{"description":"Storage or worker failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityOperationError"}}}},"503":{"description":"Current authorization, storage or model admission is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityOperationError"}}}}}}}},"servers":[{"description":"Nowledge Mem API Server","url":"http://127.0.0.1:14242"}]}},"proxyUrl":"$undefined"},"document":"./openapi.json","operations":[{"path":"/content-store/thread-messages/cutover","method":"post"}],"showDescription":true}]]]}]]}]

Cut Over Thread Messages

Query Parameters

Response Body

200application/json

422application/json

`application/json`

`application/json`