jp-lit-mcp

jp_lit_update_session_trace

Record or update a research session log with goal, scope, source selection reasons, open questions, and next actions to maintain an audit trail of investigation progress.

Instructions

write: session trace。session_id で明示した調査セッション全体に、調査目的・確認範囲・source 選択理由・未確認事項・次アクションを追記または更新する。検索結果や選択候補そのものではなく、調査経過と判断の台帳を残すための tool。候補単位の採否メモは jp_lit_annotate_session を使う

Input Schema

TableJSON Schema

Name	Required	Description
`scope_note`	No	調査範囲、除外範囲、確認済み範囲の説明。
`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 とは別物。
`next_actions`	No	次に取るべき調査アクション。
`source_plans`	No	source ごとの利用予定・利用済み・保留・除外理由。
`research_goal`	No	指定した調査セッション全体の目的。
`open_questions`	No	未解決の確認事項。

Output Schema

TableJSON Schema

Name	Required	Description	Default
`session_id`	Yes
`updated_at`	Yes
`next_action_count`	Yes
`source_plan_count`	Yes
`open_question_count`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed14 schema fields changedv0.13.0Aug 31, 2026

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

addedInput schema / properties / next_actions / 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/open_questions/items/properties/evidence_refs/items/anyOf/1/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 / next_actions / 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/open_questions/items/properties/evidence_refs/items/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 / next_actions / items / properties / evidence_refs / items / type
```
Removed value: -"object"
```

changedInput schema / properties / next_actions / items / properties / source / $ref

Previous value: -"#/properties/open_questions/items/properties/evidence_refs/items/properties/source"New value: +"#/properties/open_questions/items/properties/evidence_refs/items/anyOf/1/properties/source"

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

addedInput schema / properties / open_questions / 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/open_questions/items/properties/related_sources/items",
+        "description": "結果を特定 source に絞る。未指定の場合は tool ごとの既定動作に従う。"
+      },
+      "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 / open_questions / 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/open_questions/items/properties/related_sources/items",
-    "description": "結果を特定 source に絞る。未指定の場合は tool ごとの既定動作に従う。"
-  },
-  "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 / open_questions / items / properties / evidence_refs / items / type
```
Removed value: -"object"
```

changedInput schema / properties / open_questions / items / properties / related_sources / items / 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"
+]

changedInput schema / properties / research_goal / description

Previous value: -"現在の調査セッション全体の目的。"New value: +"指定した調査セッション全体の目的。"

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"
+}

changedInput schema / properties / source_plans / 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 / required
```
Added value: +[
+  "session_id"
+]
```

Changed2 schema fields changedv0.7.7Jun 19, 2026

changedInput schema / properties / open_questions / items / properties / related_sources / items / 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 / source_plans / 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"
+]

Changed34 schema fields changedv0.7.1Jun 3, 2026
- addedInput schema / properties / next_actions / description
```
Added value: +"次に取るべき調査アクション。"
```
- addedInput schema / properties / next_actions / items / properties / action / description
```
Added value: +"次に行う具体的な調査アクション。"
```
- addedInput schema / properties / next_actions / items / properties / evidence_refs / description
```
Added value: +"次アクションの根拠や関連する tool 結果。"
```
- addedInput schema / properties / next_actions / items / properties / evidence_refs / items / properties / cache_key / description
```
Added value: +"根拠を含む保存済み実行結果の cache_key。"
```
- addedInput schema / properties / next_actions / items / properties / evidence_refs / items / properties / quote_or_summary / description
```
Added value: +"根拠箇所の短い引用または要約。"
```
- changedInput schema / properties / next_actions / items / properties / evidence_refs / items / properties / source / $ref
```
Previous value: -"#/properties/source_plans/items/properties/source"New value: +"#/properties/open_questions/items/properties/evidence_refs/items/properties/source"
```
- addedInput schema / properties / next_actions / items / properties / evidence_refs / items / properties / source_id / description
```
Added value: +"根拠となる source 内レコードID。"
```
- addedInput schema / properties / next_actions / items / properties / evidence_refs / items / properties / tool / description
```
Added value: +"根拠を得た tool 名。例: jp_lit_search。"
```
- addedInput schema / properties / next_actions / items / properties / evidence_refs / items / properties / url / description
```
Added value: +"根拠確認に使った公式 URL。"
```
- addedInput schema / properties / next_actions / items / properties / priority / description
```
Added value: +"次アクションの優先度。"
```
- addedInput schema / properties / next_actions / items / properties / reason / description
```
Added value: +"そのアクションが必要な理由。"
```
- changedInput schema / properties / next_actions / items / properties / source / $ref
```
Previous value: -"#/properties/source_plans/items/properties/source"New value: +"#/properties/open_questions/items/properties/evidence_refs/items/properties/source"
```
- addedInput schema / properties / open_questions / description
```
Added value: +"未解決の確認事項。"
```
- addedInput schema / properties / open_questions / items / properties / evidence_refs / description
```
Added value: +"未解決事項の根拠や関連する tool 結果。"
```
- addedInput schema / properties / open_questions / items / properties / evidence_refs / items / properties / cache_key / description
```
Added value: +"根拠を含む保存済み実行結果の cache_key。"
```
- addedInput schema / properties / open_questions / items / properties / evidence_refs / items / properties / quote_or_summary / description
```
Added value: +"根拠箇所の短い引用または要約。"
```
- changedInput schema / properties / open_questions / items / properties / evidence_refs / items / properties / source / $ref
```
Previous value: -"#/properties/source_plans/items/properties/source"New value: +"#/properties/open_questions/items/properties/related_sources/items"
```
- addedInput schema / properties / open_questions / items / properties / evidence_refs / items / properties / source / description
```
Added value: +"結果を特定 source に絞る。未指定の場合は tool ごとの既定動作に従う。"
```
- addedInput schema / properties / open_questions / items / properties / evidence_refs / items / properties / source_id / description
```
Added value: +"根拠となる source 内レコードID。"
```
- addedInput schema / properties / open_questions / items / properties / evidence_refs / items / properties / tool / description
```
Added value: +"根拠を得た tool 名。例: jp_lit_search。"
```
- addedInput schema / properties / open_questions / items / properties / evidence_refs / items / properties / url / description
```
Added value: +"根拠確認に使った公式 URL。"
```
- addedInput schema / properties / open_questions / items / properties / question / description
```
Added value: +"未解決の確認事項。"
```
- addedInput schema / properties / open_questions / items / properties / reason / description
```
Added value: +"その確認事項が残っている理由。"
```
- addedInput schema / properties / open_questions / items / properties / related_sources / description
```
Added value: +"関係する source ID の配列。"
```
- removedInput schema / properties / open_questions / items / properties / related_sources / items / $ref
```
Removed value: -"#/properties/source_plans/items/properties/source"
```
- addedInput schema / properties / open_questions / items / properties / related_sources / items / enum
```
Added 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"
+]
```
- addedInput schema / properties / open_questions / items / properties / related_sources / items / type
```
Added value: +"string"
```
- addedInput schema / properties / research_goal / description
```
Added value: +"現在の調査セッション全体の目的。"
```
- addedInput schema / properties / scope_note / description
```
Added value: +"調査範囲、除外範囲、確認済み範囲の説明。"
```
- addedInput schema / properties / source_plans / description
```
Added value: +"source ごとの利用予定・利用済み・保留・除外理由。"
```
- addedInput schema / properties / source_plans / items / properties / expected_contribution / description
```
Added value: +"その source が調査に寄与すると期待する内容。"
```
- addedInput schema / properties / source_plans / items / properties / reason / description
```
Added value: +"その source 選択または除外の理由。"
```
- addedInput schema / properties / source_plans / items / properties / source / description
```
Added value: +"検索・取得・記録対象の情報源ID。jp_lit_search の結果や source plan に含まれる source を指定する。"
```
- addedInput schema / properties / source_plans / items / properties / status / description
```
Added value: +"source を使う予定・使用済み・保留・除外のどれとして扱うか。"
```

Changed2 schema fields changedv0.7.0May 18, 2026

addedInput schema / properties / next_actions / items / properties / evidence_refs

Added value: +{
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "cache_key": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "quote_or_summary": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "source": {
+        "$ref": "#/properties/source_plans/items/properties/source"
+      },
+      "source_id": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "tool": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "url": {
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "type": "object"
+  },
+  "type": "array"
+}

addedInput schema / properties / open_questions / items / properties / evidence_refs

Added value: +{
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "cache_key": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "quote_or_summary": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "source": {
+        "$ref": "#/properties/source_plans/items/properties/source"
+      },
+      "source_id": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "tool": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "url": {
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "type": "object"
+  },
+  "type": "array"
+}

Changed1 schema field changedv0.6.0May 11, 2026

changedInput schema / properties / source_plans / 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"
+]

Addedv0.4.0May 7, 2026

TDQS

A4.4/5.0

Behavior4/5

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

Annotations already mark this as non-read-only and non-idempotent, and the description reinforces this with 'write' and '追記または更新' (append/update). It adds useful behavioral context beyond annotations by explaining that this tool maintains a ledger of investigation progress and judgments rather than raw search outcomes.

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

Conciseness5/5

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

The description is compact and front-loaded with the operation type, immediately lists what can be updated, and closes with a clear exclusion and alternative. Every sentence contributes meaning, and there is no redundant restatement of the tool name or schema fields.

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 complex session-trace tool with six parameters and detailed schema documentation, the description provides the essential purpose, scope, and sibling distinction. It could be more explicit about whether updating an existing session trace merges or replaces prior content, but the schema, annotations, and sibling guidance otherwise give the agent enough context to invoke it 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 the baseline is 3. The description summarizes the main fields (research goal, scope, source reasons, open questions, next actions) and maps them to the session-trace concept, but it does not add material parameter-level detail beyond what the input schema already documents.

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 states a specific operation and resource: append or update the session trace for the session identified by session_id, covering research goal, confirmation scope, source selection reasons, open questions, and next actions. It also explicitly distinguishes itself from jp_lit_annotate_session by clarifying that this tool is for the session-level investigation ledger, not candidate-level notes.

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?

The description gives an explicit exclusion and alternative: it is not for storing search results or selected candidates, and candidate-level accept/reject notes should use jp_lit_annotate_session. This gives the agent a clear routing rule for when to use this tool versus the most relevant sibling.

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

jp_lit_update_session_trace

Instructions

Input Schema

Output Schema

Schema Changelog

TDQS

Other Tools