NoveLand

小説に新しいセクション（章）を作成する。detailはNoveLand Markdown形式で指定する

属性定義（設定項目）を削除する。紐づく全ての属性値・選択肢も連鎖的に削除される

キャラクターを削除する。 公開中、またはエピソード本文で発言者・参照・呼び名として使用中の場合は削除不可。

相関図を削除する。関連するノード・エッジも削除される。公開中の場合は削除不可。

ドキュメントを削除する。公開中のドキュメントは削除できない

エピソードを削除する。 公開中の場合は削除不可。

伏線を削除する。紐付くエピソードのリンクも同時に削除される（エピソード本文には影響しない）

用語を削除する。 公開中、またはエピソード本文で参照・呼び名として使用中の場合は削除不可。

用語カテゴリを削除する。カテゴリに所属する用語はカテゴリなしになる

セクション（章）を削除する。 stashEpisodes=true（デフォルト）: セクション内のエピソードをストックエリアに移動してから削除。 stashEpisodes=false: セクションとその中のエピソードをすべて削除。 公開中のエピソードを含むセクションは削除できない（`noveland_list_episodes(sectionId=...)` で `isPublished: true` のエピソードを特定し、非公開にしてから再実行する）。

本文中のプレーンテキストをキャラクター・用語参照に変換する。表示テキストは維持し、既存の参照・ルビ・傍点は対象外（二重適用防止）。 未登録の呼び名は nickname として自動登録して参照化する。 paragraphId で段落限定（get_episode(contentFormat="blocks") の blockId）。paragraphId と speakerScope は AND 条件。 matched_paragraph_ids は段落順・重複なしで返り、後続操作の paragraphId に再利用できる。

属性キーの使用状況を取得する。削除・改名前の影響確認に使う。 usingBaseObjects は name 昇順。type は character / object。usageCount は distinct な base_object 数。

指定したキャラクターの詳細を取得する。属性・呼び名・一人称・メモ等の全情報を返す

相関図の詳細を取得する。キャラクター/用語間の関係性を名前付きで返す

ドキュメントの詳細を取得する。本文はNoveLand Markdown形式（`:code:` でキャラクター・用語、`[[doc:id|表示名]]` でドキュメント参照）＋参照中の一覧で返される

エピソードの詳細を取得する。contentFormatで本文の形式を選択できる。 plain: 読者目線のプレーンテキスト noveland-markdown: 発言者・参照・ルビ等を含むNoveLand Markdown形式（可逆） - 段落冒頭: [p]（地の文）または [speaker:code] / [speaker:code1,code2]（セリフ・同時発話） - 段落区切り: 空行（\n\n）。空行後も必ず [p] か [speaker:...] で始める - オブジェクト参照: :code: or :code[nicknameId]: - ルビ: |漢字《ふりがな》、傍点: 《《テキスト》》 - イラスト: [illust src="url" alt="説明" appearances="code1,code2"] - シーン区切り: [scene-marker:タイトル] blocks: ブロック単位の構造化配列（paragraphId ベース編集や未整備判定に最適） - blocks[] 各要素は blockId / type / index を持つ - paragraph: text (plain) / speakerCodes / objectRefs / hasRuby / hasDots - illustration: src / alt / appearanceCodes - scene-marker: title - blocks モードでは content 文字列は返らない（blocks 配列で代替） 全 contentFormat で段落統計がトップレベルに付与される（list_episodes の includeParagraphStats と同じキー）。

**最初に呼び出すべきツール**。操作を始める前に1回呼び出す。認証中のユーザー情報と、新規作品に適用されるデフォルトAI機能レベル・そのレベルで制限される操作（blocked）を取得する。 `aiFeatureLevel` は「新しく作る作品の初期AI設定」で、作品の作成可否にも影響する。既存の作品のAI機能は作品ごとに決まるため noveland_list_novels で各作品の aiFeatureLevel を確認すること。 作品単位の操作（novelId を指定するツール）の FORBIDDEN エラーには `settingsUrl`（作品設定画面）が含まれる。デフォルト値そのものに由来する制限には付かないため `upgradeHint` の案内に従うこと。 利用実績によるAI使用判定（検出軸）は許可設定とは別軸。詳細は resource `noveland://docs/ai-usage-classification` を参照。

小説の詳細を取得する。作品全体の文字数も含む

指定した用語の詳細を取得する。属性・呼び名・メモ等の全情報を返す

セクション（章）の詳細を取得する。detailはNoveLand Markdown形式で返される

伏線とエピソードの紐付けを追加・削除する。 add は type（`setup`=張り / `payoff`=回収）必須。同じエピソードが既に紐付いている場合はエラー。 remove は type 不要。紐付けが無い場合はエラー。 同一エピソードに setup と payoff を二重に紐付け不可。type 変更は remove→add。

属性定義（設定項目）の一覧を取得する。 usageCount はそのキーを持つ base_object の distinct 数。0 なら孤立キー。詳細は noveland_get_attribute_key_usage。

指定した小説のキャラクター一覧を取得する（属性・メモは含まれない）。カーソルページネーション対応

相関図一覧を取得する。カーソルページネーション対応

ドキュメント一覧を取得する（本文は含まれない）。カーソルページネーション対応

指定した小説のエピソード一覧を取得する。sectionId/stockOnlyで絞り込み可。カーソルページネーション対応 各エピソードには整備対象の優先順位付けに使える集計値が常に含まれる: - speakerCharacterCount: 発言者キャラの distinct 数（台詞を持つキャラ） - referencedCharacterCount: 本文で :code: 参照されたキャラの distinct 数（モブ言及も含む） - referencedObjectCount: 本文で :code: 参照された用語（非キャラ）の distinct 数 - totalObjectRefCount: :code: 参照（nickname 含む）の総回数。distinct ではなく登場頻度 - isPublished: 公開中か否か（未公開ドラフトは false） includeParagraphStats=true で以下を追加（エピソードごとに Lexical パースが走るため負荷増）: - totalParagraphCount: 段落（ParagraphBlock）の総数 - paragraphsWithSpeakerCount: 発言者が 1 名以上設定された段落数

伏線一覧を取得する。episodes[].type は `setup`（張り）/ `payoff`（回収）。 payoff が無い伏線は未回収。episodes[].id は episode id と突き合わせられる。

ユーザーがアクセスできる小説の一覧を取得する。各作品の aiFeatureLevel（AI機能の利用許可レベル）も返す。カーソルページネーション対応

指定した小説の用語カテゴリ一覧を表示順で取得する

指定した小説の用語（地名・アイテム・組織などの固有名詞）一覧を取得する（属性・メモは含まれない）。カーソルページネーション対応

セクション（章）一覧を取得する。カーソルページネーション対応

エピソードをキーワード検索またはフィルタで絞り込む（PGroonga全文検索）。 検索キーワード（query）かフィルタ（sectionIds / characterIds / objectIds）のいずれかを指定する。両方併用可。 検索構文: スペース区切りでAND、ORキーワードでOR、"フレーズ"でフレーズ検索 queryを省略すると「このキャラが登場する全エピソードを物語順で一覧する」といった用途に使える。 ソート省略時: queryあり→関連度降順、なし→物語順。 sortField=relevance は query 指定時のみ、降順のみ。 各ヒットに speakers / referenced_characters / referenced_objects が常時付与される。

属性定義（設定項目）を更新する。属性名の変更やSELECT型の選択肢の追加・削除が可能。 addOptions / removeOptions は SELECT型のみ。

キャラクターを更新する。1件のみでも配列で指定。 memoはNoveLand Markdown形式（`:code:` 埋め込み、`[[doc:id|表示名]]` 参照可）。 attributesは事前に `create_attribute_key` で定義した属性キーに値を登録する。 nicknames/firstPersonNamesは id有り=更新、id無し=新規作成。削除は delete*Ids。 **all-or-nothing**: 1件でも失敗すると全体がロールバックされる。 エラー時は `failedIndex`（0-based）/`totalCount` が付く。該当アイテムを修正して再送する。

相関図のタイトルを更新する

ドキュメントのタイトルや本文を更新する。本文はNoveLand Markdown形式で指定（`:code:` でキャラクター・用語を埋め込み、`[[doc:id|表示名]]` でドキュメント参照）

エピソードのタイトル・本文・所属セクション・並び順を更新する。本文はNoveLand Markdown形式。 重要: 通常の本文段落は `[p]`（地の文）または `[speaker:code]`（セリフ）で始める必要がある。新段落は必ず段落マーカーで始める（空行の有無は結果に影響しない）。別種のブロック記法（`[scene-marker:...]` / `[illust ...]`）も使用可。詳細は resource `noveland://docs/scene-editor-syntax` を参照。 content指定時は既存本文を完全置換する。 セクション移動・ストック退避・並び順変更も本ツールで行う。 AI使用記録: このツールの実行は content 指定の有無に関わらず即時『本文生成にAIを利用（text_generated）』の判定に寄与する。詳細は resource `noveland://docs/ai-usage-classification` を参照。

伏線の名前や説明を更新する

小説のタイトルやあらすじを更新する

用語を更新する。1件のみでも配列で指定。 memoはNoveLand Markdown形式（`:code:` 埋め込み、`[[doc:id|表示名]]` 参照可）。 attributesは事前に `create_attribute_key` で定義した属性キーに値を登録する。用語カテゴリ指定時はカテゴリ外の属性キー不可。 nicknamesは id有り=更新、id無し=新規作成。削除は deleteNicknameIds。 **all-or-nothing**: 1件でも失敗すると全体がロールバックされる。 エラー時は `failedIndex`（0-based）/`totalCount` が付く。該当アイテムを修正して再送する。