jp-lit-mcp

jp_lit_annotate_session

Record search session annotations by saving selected candidates with labels, notes, and trace of search attempts. Preserve decision history without altering unselected results or cached data.

Instructions

write: session。session_id で明示した調査セッション内で、既存の検索・書誌取得結果に候補ラベルと短いメモを保存する。未選別結果そのものや cache は変更せず、採否・保留・弱候補などの選別判断だけを追加する。調査全体の目的・未確認事項・次アクションは jp_lit_update_session_trace、単なる履歴検索には jp_lit_find_sessions / jp_lit_list_sessions を使う

Input Schema

TableJSON Schema

Name	Required	Description
`tool`	Yes	注釈対象の結果を生成した tool 名。通常は jp_lit_search または jp_lit_refine_results。
`notes`	No	この注釈 entry 全体に対する補足メモ。
`trace`	No	検索意図、判断、根拠確認範囲などの調査経過。
`cache_key`	Yes	保存済み tool 実行結果を指す cache_key。jp_lit_search や cache 一覧 tool の戻り値から渡す。
`session_id`	Yes	調査案件を識別する application state handle。jp_lit_start_session が返した値を渡す。形式は YYYY-MM-DD-HHMMSS-8桁hex（旧形式 YYYY-MM-DD-HHMMSS も可）。MCP transport の接続IDや cache_key とは別物。
`selected_items`	Yes	現在の調査セッションに保存する選別済み候補。未選別の検索結果そのものは変更しない。

Output Schema

TableJSON Schema

Name	Required	Description	Default
`session_id`	Yes
`updated_at`	Yes
`annotated_count`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedv0.14.0Sep 7, 2026

changedInput schema / properties / session_id / description

Previous value: -"調査案件を識別する application state handle。jp_lit_start_session が返した値を��す。形式は YYYY-MM-DD-HHMMSS-8桁hex（旧形式 YYYY-MM-DD-HHMMSS も可）。MCP transport の接続IDや cache_key とは別物。"New value: +"調査案件を識別する application state handle。jp_lit_start_session が返した値を渡す。形式は YYYY-MM-DD-HHMMSS-8桁hex（旧形式 YYYY-MM-DD-HHMMSS も可）。MCP transport の接続IDや cache_key とは別物。"

Changed12 schema fields changedv0.13.0Aug 31, 2026

changedInput schema / properties / selected_items / items / properties / source / enum

Previous value: -[
-  "ndl_search",
-  "ndl_catalog",
-  "ndl_digital",
-  "ndl_articles",
-  "ndl_articles_online",
-  "irdb",
-  "jdcat",
-  "jstage_articles",
-  "japan_search",
-  "cinii_articles",
-  "cinii_dissertations",
-  "cinii_books",
-  "kokkai_minutes",
-  "teikoku_minutes",
-  "nihu_bridge",
-  "national_archives",
-  "jacar",
-  "nijl_articles",
-  "kokusho",
-  "ninjal_bibliography"
-]New value: +[
+  "ndl_search",
+  "ndl_reference_books",
+  "ndl_catalog",
+  "ndl_digital",
+  "ndl_articles",
+  "ndl_articles_online",
+  "irdb",
+  "jdcat",
+  "jstage_articles",
+  "japan_search",
+  "cinii_articles",
+  "cinii_dissertations",
+  "cinii_books",
+  "kokkai_minutes",
+  "teikoku_minutes",
+  "nihu_bridge",
+  "national_archives",
+  "jacar",
+  "nijl_articles",
+  "kokusho",
+  "ninjal_bibliography"
+]

addedInput schema / properties / session_id

Added value: +{
+  "description": "調査案件を識別する application state handle。jp_lit_start_session が返した値を��す。形式は YYYY-MM-DD-HHMMSS-8桁hex（旧形式 YYYY-MM-DD-HHMMSS も可）。MCP transport の接続IDや cache_key とは別物。",
+  "pattern": "^\\d{4}-\\d{2}-\\d{2}-\\d{6}(?:-[0-9a-f]{8})?$",
+  "type": "string"
+}

removedInput schema / properties / trace / properties / decisions / items / properties / evidence_refs / items / additionalProperties
```
Removed value: -false
```

addedInput schema / properties / trace / properties / decisions / items / properties / evidence_refs / items / anyOf

Added value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "author": {
+        "description": "画面上で確認した投稿者名またはアカウント表記。",
+        "minLength": 1,
+        "type": "string"
+      },
+      "checked_at": {
+        "description": "エージェントが投稿を確認した日時。ISO 8601。",
+        "format": "date-time",
+        "type": "string"
+      },
+      "discovery_source": {
+        "description": "発見に使ったWeb検索サービス名。",
+        "minLength": 1,
+        "type": "string"
+      },
+      "evidence_type": {
+        "const": "agent_web",
+        "description": "速報Web発見の証拠種別。",
+        "type": "string"
+      },
+      "linked_urls": {
+        "description": "投稿から到達したリンク先URL。",
+        "items": {
+          "format": "uri",
+          "type": "string"
+        },
+        "minItems": 1,
+        "type": "array"
+      },
+      "published_at": {
+        "description": "画面上で確認した投稿日時。ISO 8601。",
+        "format": "date-time",
+        "type": "string"
+      },
+      "query": {
+        "description": "発見時に実際に使った検索語。",
+        "minLength": 1,
+        "type": "string"
+      },
+      "quote_or_summary": {
+        "description": "発見理由の短い要約。",
+        "minLength": 1,
+        "type": "string"
+      },
+      "stability": {
+        "const": "ephemeral",
+        "description": "消失・変更しうる一時的な発見記録。",
+        "type": "string"
+      },
+      "url": {
+        "description": "発見した投稿のURL。",
+        "format": "uri",
+        "type": "string"
+      }
+    },
+    "required": [
+      "evidence_type",
+      "stability",
+      "discovery_source",
+      "query",
+      "url",
+      "author",
+      "published_at",
+      "checked_at",
+      "linked_urls"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "cache_key": {
+        "description": "根拠を含む保存済み実行結果の cache_key。",
+        "minLength": 1,
+        "type": "string"
+      },
+      "quote_or_summary": {
+        "description": "根拠箇所の短い引用または要約。",
+        "minLength": 1,
+        "type": "string"
+      },
+      "source": {
+        "$ref": "#/properties/trace/properties/decisions/items/properties/target/properties/source"
+      },
+      "source_id": {
+        "description": "根拠となる source 内レコードID。",
+        "minLength": 1,
+        "type": "string"
+      },
+      "tool": {
+        "description": "根拠を得た tool 名。例: jp_lit_search。",
+        "minLength": 1,
+        "type": "string"
+      },
+      "url": {
+        "description": "根拠確認に使った公式 URL。",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "type": "object"
+  }
+]

removedInput schema / properties / trace / properties / decisions / items / properties / evidence_refs / items / properties

Removed value: -{
-  "cache_key": {
-    "description": "根拠を含む保存済み実行結果の cache_key。",
-    "minLength": 1,
-    "type": "string"
-  },
-  "quote_or_summary": {
-    "description": "根拠箇所の短い引用または要約。",
-    "minLength": 1,
-    "type": "string"
-  },
-  "source": {
-    "$ref": "#/properties/trace/properties/decisions/items/properties/target/properties/source"
-  },
-  "source_id": {
-    "description": "根拠となる source 内レコードID。",
-    "minLength": 1,
-    "type": "string"
-  },
-  "tool": {
-    "description": "根拠を得た tool 名。例: jp_lit_search。",
-    "minLength": 1,
-    "type": "string"
-  },
-  "url": {
-    "description": "根拠確認に使った公式 URL。",
-    "minLength": 1,
-    "type": "string"
-  }
-}

removedInput schema / properties / trace / properties / decisions / items / properties / evidence_refs / items / type
```
Removed value: -"object"
```
removedInput schema / properties / trace / properties / evidence_scope / items / properties / evidence_refs / items / additionalProperties
```
Removed value: -false
```

addedInput schema / properties / trace / properties / evidence_scope / items / properties / evidence_refs / items / anyOf

Added value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "author": {
+        "description": "画面上で確認した投稿者名またはアカウント表記。",
+        "minLength": 1,
+        "type": "string"
+      },
+      "checked_at": {
+        "description": "エージェントが投稿を確認した日時。ISO 8601。",
+        "format": "date-time",
+        "type": "string"
+      },
+      "discovery_source": {
+        "description": "発見に使ったWeb検索サービス名。",
+        "minLength": 1,
+        "type": "string"
+      },
+      "evidence_type": {
+        "const": "agent_web",
+        "description": "速報Web発見の証拠種別。",
+        "type": "string"
+      },
+      "linked_urls": {
+        "description": "投稿から到達したリンク先URL。",
+        "items": {
+          "format": "uri",
+          "type": "string"
+        },
+        "minItems": 1,
+        "type": "array"
+      },
+      "published_at": {
+        "description": "画面上で確認した投稿日時。ISO 8601。",
+        "format": "date-time",
+        "type": "string"
+      },
+      "query": {
+        "description": "発見時に実際に使った検索語。",
+        "minLength": 1,
+        "type": "string"
+      },
+      "quote_or_summary": {
+        "description": "発見理由の短い要約。",
+        "minLength": 1,
+        "type": "string"
+      },
+      "stability": {
+        "const": "ephemeral",
+        "description": "消失・変更しうる一時的な発見記録。",
+        "type": "string"
+      },
+      "url": {
+        "description": "発見した投稿のURL。",
+        "format": "uri",
+        "type": "string"
+      }
+    },
+    "required": [
+      "evidence_type",
+      "stability",
+      "discovery_source",
+      "query",
+      "url",
+      "author",
+      "published_at",
+      "checked_at",
+      "linked_urls"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "cache_key": {
+        "description": "根拠を含む保存済み実行結果の cache_key。",
+        "minLength": 1,
+        "type": "string"
+      },
+      "quote_or_summary": {
+        "description": "根拠箇所の短い引用または要約。",
+        "minLength": 1,
+        "type": "string"
+      },
+      "source": {
+        "$ref": "#/properties/trace/properties/decisions/items/properties/target/properties/source"
+      },
+      "source_id": {
+        "description": "根拠となる source 内レコードID。",
+        "minLength": 1,
+        "type": "string"
+      },
+      "tool": {
+        "description": "根拠を得た tool 名。例: jp_lit_search。",
+        "minLength": 1,
+        "type": "string"
+      },
+      "url": {
+        "description": "根拠確認に使った公式 URL。",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "type": "object"
+  }
+]

removed

Input schema / properties / trace / properties / evidence_scope / items / properties / evidence_refs / items / properties

Removed value: -{
-  "cache_key": {
-    "description": "根拠を含む保存済み実行結果の cache_key。",
-    "minLength": 1,
-    "type": "string"
-  },
-  "quote_or_summary": {
-    "description": "根拠箇所の短い引用または要約。",
-    "minLength": 1,
-    "type": "string"
-  },
-  "source": {
-    "$ref": "#/properties/trace/properties/decisions/items/properties/target/properties/source"
-  },
-  "source_id": {
-    "description": "根拠となる source 内レコードID。",
-    "minLength": 1,
-    "type": "string"
-  },
-  "tool": {
-    "description": "根拠を得た tool 名。例: jp_lit_search。",
-    "minLength": 1,
-    "type": "string"
-  },
-  "url": {
-    "description": "根拠確認に使った公式 URL。",
-    "minLength": 1,
-    "type": "string"
-  }
-}

removedInput schema / properties / trace / properties / evidence_scope / items / properties / evidence_refs / items / type
```
Removed value: -"object"
```

changedInput schema / properties / trace / properties / search_attempt / properties / source / anyOf

Previous value: -[
-  {
-    "enum": [
-      "ndl_search",
-      "ndl_catalog",
-      "ndl_digital",
-      "ndl_articles",
-      "ndl_articles_online",
-      "irdb",
-      "jdcat",
-      "jstage_articles",
-      "japan_search",
-      "cinii_articles",
-      "cinii_dissertations",
-      "cinii_books",
-      "kokkai_minutes",
-      "teikoku_minutes",
-      "nihu_bridge",
-      "national_archives",
-      "jacar",
-      "nijl_articles",
-      "kokusho",
-      "ninjal_bibliography"
-    ],
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "enum": [
+      "ndl_search",
+      "ndl_reference_books",
+      "ndl_catalog",
+      "ndl_digital",
+      "ndl_articles",
+      "ndl_articles_online",
+      "irdb",
+      "jdcat",
+      "jstage_articles",
+      "japan_search",
+      "cinii_articles",
+      "cinii_dissertations",
+      "cinii_books",
+      "kokkai_minutes",
+      "teikoku_minutes",
+      "nihu_bridge",
+      "national_archives",
+      "jacar",
+      "nijl_articles",
+      "kokusho",
+      "ninjal_bibliography"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

changedInput schema / required

Previous value: -[
-  "tool",
-  "cache_key",
-  "selected_items"
-]New value: +[
+  "session_id",
+  "tool",
+  "cache_key",
+  "selected_items"
+]

Changed2 schema fields changedv0.9.0Jul 13, 2026
- removedInput schema / properties / cache_key / minLength
```
Removed value: -1
```
- addedInput schema / properties / cache_key / pattern
```
Added value: +"^sha256-[0-9a-f]{64}$"
```

Changed2 schema fields changedv0.7.7Jun 19, 2026

changedInput schema / properties / selected_items / items / properties / source / enum

Previous value: -[
-  "ndl_search",
-  "ndl_catalog",
-  "ndl_digital",
-  "ndl_articles",
-  "ndl_articles_online",
-  "irdb",
-  "jdcat",
-  "jstage_articles",
-  "japan_search",
-  "cinii_articles",
-  "cinii_books",
-  "kokkai_minutes",
-  "teikoku_minutes",
-  "nihu_bridge",
-  "national_archives",
-  "jacar",
-  "nijl_articles",
-  "kokusho",
-  "ninjal_bibliography"
-]New value: +[
+  "ndl_search",
+  "ndl_catalog",
+  "ndl_digital",
+  "ndl_articles",
+  "ndl_articles_online",
+  "irdb",
+  "jdcat",
+  "jstage_articles",
+  "japan_search",
+  "cinii_articles",
+  "cinii_dissertations",
+  "cinii_books",
+  "kokkai_minutes",
+  "teikoku_minutes",
+  "nihu_bridge",
+  "national_archives",
+  "jacar",
+  "nijl_articles",
+  "kokusho",
+  "ninjal_bibliography"
+]

changedInput schema / properties / trace / properties / search_attempt / properties / source / anyOf

Previous value: -[
-  {
-    "enum": [
-      "ndl_search",
-      "ndl_catalog",
-      "ndl_digital",
-      "ndl_articles",
-      "ndl_articles_online",
-      "irdb",
-      "jdcat",
-      "jstage_articles",
-      "japan_search",
-      "cinii_articles",
-      "cinii_books",
-      "kokkai_minutes",
-      "teikoku_minutes",
-      "nihu_bridge",
-      "national_archives",
-      "jacar",
-      "nijl_articles",
-      "kokusho",
-      "ninjal_bibliography"
-    ],
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "enum": [
+      "ndl_search",
+      "ndl_catalog",
+      "ndl_digital",
+      "ndl_articles",
+      "ndl_articles_online",
+      "irdb",
+      "jdcat",
+      "jstage_articles",
+      "japan_search",
+      "cinii_articles",
+      "cinii_dissertations",
+      "cinii_books",
+      "kokkai_minutes",
+      "teikoku_minutes",
+      "nihu_bridge",
+      "national_archives",
+      "jacar",
+      "nijl_articles",
+      "kokusho",
+      "ninjal_bibliography"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

Changed51 schema fields changedv0.7.1Jun 3, 2026
- addedInput schema / properties / cache_key / description
```
Added value: +"保存済み tool 実行結果を指す cache_key。jp_lit_search や cache 一覧 tool の戻り値から渡す。"
```
- addedInput schema / properties / notes / description
```
Added value: +"この注釈 entry 全体に対する補足メモ。"
```
- addedInput schema / properties / selected_items / description
```
Added value: +"現在の調査セッションに保存する選別済み候補。未選別の検索結果そのものは変更しない。"
```
- addedInput schema / properties / selected_items / items / properties / label / description
```
Added value: +"候補の選別ラベル。confirmed, strong_candidate, weak_candidate のいずれか。"
```
- addedInput schema / properties / selected_items / items / properties / note / description
```
Added value: +"候補ごとの短い選別メモ。不要なら null。"
```
- addedInput schema / properties / selected_items / items / properties / source / description
```
Added value: +"検索・取得・記録対象の情報源ID。jp_lit_search の結果や source plan に含まれる source を指定する。"
```
- addedInput schema / properties / selected_items / items / properties / source_id / description
```
Added value: +"選別した候補の source 内レコードID。"
```
- addedInput schema / properties / selected_items / items / properties / title / description
```
Added value: +"選別した候補のタイトル。"
```
- addedInput schema / properties / tool / description
```
Added value: +"注釈対象の結果を生成した tool 名。通常は jp_lit_search または jp_lit_refine_results。"
```
- addedInput schema / properties / trace / description
```
Added value: +"検索意図、判断、根拠確認範囲などの調査経過。"
```
- addedInput schema / properties / trace / properties / agent_label / description
```
Added value: +"この記録を残す agent や作業者の短いラベル。"
```
- addedInput schema / properties / trace / properties / decisions / description
```
Added value: +"候補採否・重複・保留などの判断記録。"
```
- addedInput schema / properties / trace / properties / decisions / items / properties / evidence_refs / description
```
Added value: +"判断の根拠となる tool 結果や URL。"
```
- addedInput schema / properties / trace / properties / decisions / items / properties / evidence_refs / items / properties / cache_key / description
```
Added value: +"根拠を含む保存済み実行結果の cache_key。"
```
- addedInput schema / properties / trace / properties / decisions / items / properties / evidence_refs / items / properties / quote_or_summary / description
```
Added value: +"根拠箇所の短い引用または要約。"
```
- changedInput schema / properties / trace / properties / decisions / items / properties / evidence_refs / items / properties / source / $ref
```
Previous value: -"#/properties/selected_items/items/properties/source"New value: +"#/properties/trace/properties/decisions/items/properties/target/properties/source"
```
- addedInput schema / properties / trace / properties / decisions / items / properties / evidence_refs / items / properties / source_id / description
```
Added value: +"根拠となる source 内レコードID。"
```
- addedInput schema / properties / trace / properties / decisions / items / properties / evidence_refs / items / properties / tool / description
```
Added value: +"根拠を得た tool 名。例: jp_lit_search。"
```
- addedInput schema / properties / trace / properties / decisions / items / properties / evidence_refs / items / properties / url / description
```
Added value: +"根拠確認に使った公式 URL。"
```
- addedInput schema / properties / trace / properties / decisions / items / properties / kind / description
```
Added value: +"候補に対する判断種別。"
```
- addedInput schema / properties / trace / properties / decisions / items / properties / reason / description
```
Added value: +"その判断にした理由。"
```
- addedInput schema / properties / trace / properties / decisions / items / properties / target / description
```
Added value: +"判断対象の候補。"
```
- addedInput schema / properties / trace / properties / decisions / items / properties / target / properties / cache_key / description
```
Added value: +"対象候補を含む保存済み実行結果の cache_key。"
```
- changedInput schema / properties / trace / properties / decisions / items / properties / target / properties / source / $ref
```
Previous value: -"#/properties/selected_items/items/properties/source"New value: +"#/properties/trace/properties/search_attempt/properties/source/anyOf/0"
```
- addedInput schema / properties / trace / properties / decisions / items / properties / target / properties / source / description
```
Added value: +"結果を特定 source に絞る。未指定の場合は tool ごとの既定動作に従う。"
```
- addedInput schema / properties / trace / properties / decisions / items / properties / target / properties / source_id / description
```
Added value: +"対象候補の source 内レコードID。"
```
- addedInput schema / properties / trace / properties / decisions / items / properties / target / properties / title / description
```
Added value: +"対象候補のタイトル。"
```
- addedInput schema / properties / trace / properties / evidence_scope / description
```
Added value: +"候補ごとにどこまで確認したかの記録。"
```
- addedInput schema / properties / trace / properties / evidence_scope / items / properties / body_status / description
```
Added value: +"本文・実体確認の状態。"
```
- addedInput schema / properties / trace / properties / evidence_scope / items / properties / checked / description
```
Added value: +"確認した根拠の範囲。"
```
- addedInput schema / properties / trace / properties / evidence_scope / items / properties / evidence_refs / description
```
Added value: +"確認範囲の根拠となる tool 結果や URL。"
```
- addedInput schema / properties / trace / properties / evidence_scope / items / properties / evidence_refs / items / properties / cache_key / description
```
Added value: +"根拠を含む保存済み実行結果の cache_key。"
```
- addedInput schema / properties / trace / properties / evidence_scope / items / properties / evidence_refs / items / properties / quote_or_summary / description
```
Added value: +"根拠箇所の短い引用または要約。"
```
- changedInput schema / properties / trace / properties / evidence_scope / items / properties / evidence_refs / items / properties / source / $ref
```
Previous value: -"#/properties/selected_items/items/properties/source"New value: +"#/properties/trace/properties/decisions/items/properties/target/properties/source"
```
- addedInput schema / properties / trace / properties / evidence_scope / items / properties / evidence_refs / items / properties / source_id / description
```
Added value: +"根拠となる source 内レコードID。"
```
- addedInput schema / properties / trace / properties / evidence_scope / items / properties / evidence_refs / items / properties / tool / description
```
Added value: +"根拠を得た tool 名。例: jp_lit_search。"
```
- addedInput schema / properties / trace / properties / evidence_scope / items / properties / evidence_refs / items / properties / url / description
```
Added value: +"根拠確認に使った公式 URL。"
```
- addedInput schema / properties / trace / properties / evidence_scope / items / properties / note / description
```
Added value: +"確認範囲に関する短い補足。"
```
- addedInput schema / properties / trace / properties / evidence_scope / items / properties / target / description
```
Added value: +"確認範囲を記録する対象候補。"
```
- addedInput schema / properties / trace / properties / intent / description
```
Added value: +"この注釈・検索・選別の意図。"
```
- addedInput schema / properties / trace / properties / search_attempt / description
```
Added value: +"この entry に対応する検索試行の記録。"
```
- addedInput schema / properties / trace / properties / search_attempt / properties / extracted_count / description
```
Added value: +"候補として抽出・検討した件数。"
```
- addedInput schema / properties / trace / properties / search_attempt / properties / next_step / description
```
Added value: +"この検索結果を受けた次の行動。"
```
- addedInput schema / properties / trace / properties / search_attempt / properties / outcome / description
```
Added value: +"検索試行の評価。"
```
- addedInput schema / properties / trace / properties / search_attempt / properties / purpose / description
```
Added value: +"この検索を行った目的。"
```
- addedInput schema / properties / trace / properties / search_attempt / properties / query / description
```
Added value: +"実際に試した検索語。"
```
- addedInput schema / properties / trace / properties / search_attempt / properties / returned_count / description
```
Added value: +"実際に返ってきた件数。"
```
- changedInput schema / properties / trace / properties / search_attempt / properties / source / anyOf
```
Previous value: -[
-  {
-    "$ref": "#/properties/selected_items/items/properties/source"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "enum": [
+      "ndl_search",
+      "ndl_catalog",
+      "ndl_digital",
+      "ndl_articles",
+      "ndl_articles_online",
+      "irdb",
+      "jdcat",
+      "jstage_articles",
+      "japan_search",
+      "cinii_articles",
+      "cinii_books",
+      "kokkai_minutes",
+      "teikoku_minutes",
+      "nihu_bridge",
+      "national_archives",
+      "jacar",
+      "nijl_articles",
+      "kokusho",
+      "ninjal_bibliography"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]
```
- addedInput schema / properties / trace / properties / search_attempt / properties / source / description
```
Added value: +"試行した source。横断検索など特定不能な場合は null。"
```
- addedInput schema / properties / trace / properties / search_attempt / properties / total / description
```
Added value: +"tool が返した総件数。不明な場合は null。"
```
- addedInput schema / properties / trace / properties / task_scope / description
```
Added value: +"この注釈が対象とする作業範囲。"
```
Changed2 schema fields changedv0.7.0May 18, 2026
- addedInput schema / properties / trace / properties / agent_label
```
Added value: +{
+  "minLength": 1,
+  "type": "string"
+}
```
- addedInput schema / properties / trace / properties / task_scope
```
Added value: +{
+  "minLength": 1,
+  "type": "string"
+}
```

Changed1 schema field changedv0.6.0May 11, 2026

changedInput schema / properties / selected_items / items / properties / source / enum

Previous value: -[
-  "ndl_search",
-  "ndl_catalog",
-  "ndl_digital",
-  "ndl_articles",
-  "ndl_articles_online",
-  "irdb",
-  "jdcat",
-  "jstage_articles",
-  "japan_search",
-  "cinii_articles",
-  "cinii_books",
-  "kokkai_minutes",
-  "teikoku_minutes",
-  "nihu_bridge",
-  "national_archives",
-  "jacar"
-]New value: +[
+  "ndl_search",
+  "ndl_catalog",
+  "ndl_digital",
+  "ndl_articles",
+  "ndl_articles_online",
+  "irdb",
+  "jdcat",
+  "jstage_articles",
+  "japan_search",
+  "cinii_articles",
+  "cinii_books",
+  "kokkai_minutes",
+  "teikoku_minutes",
+  "nihu_bridge",
+  "national_archives",
+  "jacar",
+  "nijl_articles",
+  "kokusho",
+  "ninjal_bibliography"
+]

Changed1 schema field changedv0.4.0May 7, 2026

addedInput schema / properties / trace

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "decisions": {
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "evidence_refs": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "cache_key": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "quote_or_summary": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "source": {
+                  "$ref": "#/properties/selected_items/items/properties/source"
+                },
+                "source_id": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "tool": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "url": {
+                  "minLength": 1,
+                  "type": "string"
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "kind": {
+            "enum": [
+              "adopt",
+              "hold",
+              "reject",
+              "deduplicate",
+              "needs_followup"
+            ],
+            "type": "string"
+          },
+          "reason": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "target": {
+            "additionalProperties": false,
+            "properties": {
+              "cache_key": {
+                "minLength": 1,
+                "type": "string"
+              },
+              "source": {
+                "$ref": "#/properties/selected_items/items/properties/source"
+              },
+              "source_id": {
+                "minLength": 1,
+                "type": "string"
+              },
+              "title": {
+                "minLength": 1,
+                "type": "string"
+              }
+            },
+            "type": "object"
+          }
+        },
+        "required": [
+          "kind",
+          "target",
+          "reason",
+          "evidence_refs"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "evidence_scope": {
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "body_status": {
+            "enum": [
+              "not_checked",
+              "online_entry_unread",
+              "no_online_entry",
+              "restricted",
+              "confirmed"
+            ],
+            "type": "string"
+          },
+          "checked": {
+            "enum": [
+              "metadata",
+              "abstract",
+              "toc",
+              "fulltext_snippet",
+              "fulltext",
+              "external_review"
+            ],
+            "type": "string"
+          },
+          "evidence_refs": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "cache_key": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "quote_or_summary": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "source": {
+                  "$ref": "#/properties/selected_items/items/properties/source"
+                },
+                "source_id": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "tool": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "url": {
+                  "minLength": 1,
+                  "type": "string"
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "note": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "target": {
+            "additionalProperties": false,
+            "properties": {
+              "source": {
+                "$ref": "#/properties/trace/properties/decisions/items/properties/target/properties/source"
+              },
+              "source_id": {
+                "$ref": "#/properties/trace/properties/decisions/items/properties/target/properties/source_id"
+              },
+              "title": {
+                "$ref": "#/properties/trace/properties/decisions/items/properties/target/properties/title"
+              }
+            },
+            "type": "object"
+          }
+        },
+        "required": [
+          "target",
+          "checked",
+          "body_status",
+          "evidence_refs"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "intent": {
+      "minLength": 1,
+      "type": "string"
+    },
+    "search_attempt": {
+      "additionalProperties": false,
+      "properties": {
+        "extracted_count": {
+          "minimum": 0,
+          "type": "integer"
+        },
+        "next_step": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "outcome": {
+          "enum": [
+            "useful",
+            "partial",
+            "empty",
+            "noisy",
+            "failed"
+          ],
+          "type": "string"
+        },
+        "purpose": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "query": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "returned_count": {
+          "minimum": 0,
+          "type": "integer"
+        },
+        "source": {
+          "anyOf": [
+            {
+              "$ref": "#/properties/selected_items/items/properties/source"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "total": {
+          "anyOf": [
+            {
+              "minimum": 0,
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "required": [
+        "source",
+        "query",
+        "purpose",
+        "total",
+        "returned_count",
+        "extracted_count",
+        "outcome"
+      ],
+      "type": "object"
+    }
+  },
+  "type": "object"
+}

Changed1 schema field changedv0.3.0May 7, 2026

changedInput schema / properties / selected_items / items / properties / source / enum

Previous value: -[
-  "ndl_search",
-  "ndl_catalog",
-  "ndl_digital",
-  "ndl_articles",
-  "ndl_articles_online",
-  "irdb",
-  "jdcat",
-  "jstage_articles",
-  "japan_search",
-  "cinii_articles",
-  "cinii_books",
-  "kokkai_minutes",
-  "teikoku_minutes",
-  "nihu_bridge"
-]New value: +[
+  "ndl_search",
+  "ndl_catalog",
+  "ndl_digital",
+  "ndl_articles",
+  "ndl_articles_online",
+  "irdb",
+  "jdcat",
+  "jstage_articles",
+  "japan_search",
+  "cinii_articles",
+  "cinii_books",
+  "kokkai_minutes",
+  "teikoku_minutes",
+  "nihu_bridge",
+  "national_archives",
+  "jacar"
+]

First observedv0.1.9May 5, 2026

TDQS

A4.3/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations are present (readOnlyHint=false, destructiveHint=false) and the description adds context beyond them: it clarifies the exact modification scope ('does not change unsorted results or cache, only adds adopt/reject/hold/weak-candidate sorting judgments'). This tells the agent precisely what side effects occur and what does not change, which is valuable behavioral disclosure for a write operation. No contradiction with annotations. A small deduction because it does not describe the persistence/return behavior after writing.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is compact and front-loaded with the verb+resource, then the core purpose, then the boundary/exclusion clause, then the sibling routing. Every clause earns its place with no filler. Slightly below a 5 because it packs multiple routed alternatives into one long tail sentence, but overall it is efficient and well-ordered for a tool of this complexity.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool with 6 parameters, 4 required, and complex nested objects (trace with decisions/evidence_refs/search_attempt, selected_items with nested source enums), the description covers the core purpose, modification boundary, and alternative routing well. The output schema exists, so return-value explanation is not required. It does not elaborate on the nested trace structure or prerequisites beyond what the schema already documents, but given the extremely detailed schema descriptions, the description adds sufficient value for an agent to call the tool correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so baseline 3 applies. The description orients the agent toward the key parameters (session_id, tool, cache_key, selected_items) implicitly by describing the operation, and the schema already documents each parameter in detail (e.g., session_id format, cache_key pattern, selected_items label enum). The description does not add significant parameter-level meaning beyond the schema, which is acceptable given the full schema coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb+resource ('write: session') and states a precise function: saving candidate labels and short memos to existing search/bibliographic results within the session identified by session_id. It clearly differentiates itself from siblings by naming what it is not (jp_lit_update_session_trace for overall purpose/next actions, jp_lit_find_sessions/jp_lit_list_sessions for history search). An agent can distinguish this from jp_lit_update_session_trace without inspecting schemas.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicit when-to-use guidance is provided: annotate candidate sorting decisions within a session. It also states explicit exclusions ('does not modify unsorted results or cache') and names the exact alternatives with the conditions that select them — jp_lit_update_session_trace for overall purpose/unconfirmed items/next actions, and jp_lit_find_sessions/jp_lit_list_sessions for simple history retrieval. This is unambiguous routing with no inference required.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

jp_lit_annotate_session

Instructions

Input Schema

Output Schema

Schema Changelog

TDQS

Other Tools