noveland_assign_speaker
ChatGPTAssigns or removes speakers of paragraphs in an episode, in a batch. A single change is also passed as one entry in assignments. Paragraph text is not modified. Paragraphs are identified only by paragraphId, which is the blockId returned by get_episode(contentFormat="blocks"). all-or-nothing: if any paragraphId is unknown, the whole call fails and nothing is changed. Repeating the same paragraphId is an error. updated_paragraphs is returned in input order.
noveland_create_attribute_key
ChatGPTCreates an attribute key (custom field). options is required when valueType is select and not allowed for other value types.
noveland_create_character
ChatGPTCreates characters in a novel. Pass an array, even for a single character. memo is NoveLand Markdown (supports :code: embeds and [[doc:id|label]] links, where id is a UUID returned by list_documents). attributes sets values for attribute keys, which must already exist (created with create_attribute_key). all-or-nothing: if any item fails, the whole batch is rolled back. On error, the response includes failedIndex (0-based) and totalCount; failedIndex is the position of the failed item.
noveland_create_diagram
ChatGPTCreates a relationship diagram.
noveland_create_document
ChatGPTCreates a document (author's notes not included in the body text) in a novel. The content is NoveLand Markdown (supports :code: embeds of characters and objects (worldbuilding terms), and [[doc:id|label]] links to documents, where id is a UUID returned by list_documents).
noveland_create_episode
ChatGPTCreates a new episode in a novel. content is NoveLand Markdown. Required: every body-text paragraph starts with [p] (narration) or [speaker:code] (dialogue). A new paragraph starts only at a paragraph marker; blank lines make no difference. Other block syntax ([scene-marker:...] / [illust ...]) is also allowed. Details: resource noveland://docs/scene-editor-syntax. :code: becomes a reference only for an existing code; other text between colons, such as 12:30:00, is saved as is, and no backslash escapes are needed. An unregistered :code: is saved as plain text and, unless attached to letters or digits, listed in unresolvedCodes in the response. Codes in [speaker:code] and appearances must exist; an unknown one is an error. Format example: [speaker:taro]"Hello." [p]:taro: said. NoveLand shows readers how AI was used in each novel. Calling this tool, with or without content, marks the novel as "AI used to generate body text" (text_generated) right away. Details: resource noveland://docs/ai-usage-classification. When available, the result's editorUrl is the episode's writing page in the NoveLand web editor.
noveland_create_foreshadowing
ChatGPTCreates a foreshadowing entry. Setup and payoff episodes are linked afterwards with noveland_link_foreshadowing_episode.
noveland_create_novel
ChatGPTCreates a new novel. Novels created here always start at the AI-feature level text_generated (AI can write body text). The result's aiFeatureLevel includes a notice and, when available, settingsUrl (the novel's settings page), where the author can lower the level. When available, the result's editorUrl is the novel's plot page in the NoveLand web editor, where the author continues writing it.
noveland_create_object
ChatGPTCreates objects (worldbuilding terms: proper nouns such as places, items and organizations) in a novel. Pass an array, even for a single object. memo is NoveLand Markdown (supports :code: embeds and [[doc:id|label]] links, where id is a UUID returned by list_documents). attributes sets values for attribute keys, which must already exist (created with create_attribute_key). For an object with an object type, only the keys of that object type are accepted. all-or-nothing: if any item fails, the whole batch is rolled back. On error, the response includes failedIndex (0-based) and totalCount; failedIndex is the position of the failed item.
noveland_create_object_type
ChatGPTCreates an object type (term category) in a novel. It is added at the end of the display order.
noveland_create_section
ChatGPTCreates a section (chapter) in a novel. detail is NoveLand Markdown (supports :code: embeds of characters and objects (worldbuilding terms), and [[doc:id|label]] links to documents, where id is a UUID returned by list_documents).
noveland_delete_attribute_key
ChatGPTDeletes an attribute key. All values entered for it and all its options are deleted as well.
noveland_delete_character
ChatGPTDeletes a character. A character cannot be deleted while it is published, or while episode body text uses it as a speaker, a reference, or through a nickname.
noveland_delete_diagram
ChatGPTDeletes a diagram along with its nodes and edges. A published diagram cannot be deleted.
noveland_delete_document
ChatGPTDeletes a document. A published document cannot be deleted.
noveland_delete_episode
ChatGPTDeletes an episode. A published episode cannot be deleted.
noveland_delete_foreshadowing
ChatGPTDeletes a foreshadowing entry along with its links to episodes. The body text of the episodes is not affected.
noveland_delete_object
ChatGPTDeletes an object. An object cannot be deleted while it is published, or while episode body text references it directly or through a nickname.
noveland_delete_object_type
ChatGPTDeletes an object type. Objects in it are kept without an object type. The attribute keys defined for this object type, and the values entered for them on every object, are deleted and cannot be restored.
noveland_delete_section
ChatGPTDeletes a section (chapter). stashEpisodes=true (default): the episodes in the section are moved to the stock before the section is deleted. stashEpisodes=false: the section and all its episodes are deleted. A section that contains published episodes cannot be deleted. Those episodes are the ones with isPublished: true in noveland_list_episodes(sectionId=...); the deletion succeeds after they are unpublished. With stashEpisodes=true, a section that contains scheduled episodes cannot be deleted. Those episodes are the ones with a non-null scheduledPublishAt in noveland_list_episodes(sectionId=...).
noveland_draw_chart
ChatGPTDraws elements of a novel as a bar or line chart: length per episode, appearances per character, and anything else compared by numbers. The drawing is not saved. Important: up to 100 categories, 8 series, and 300 points across all series together (exceeding a limit is an error; nothing is omitted automatically). kind is bar (side-by-side comparison) or line (a trend along the order of categories). Important: the horizontal axis is categories, and the points of each series refer to them by categoryId. An unknown categoryId, or the same categoryId twice within a series, is an error. A categoryId missing from a series is treated as missing data, not as 0 (the bar is left empty and the line breaks). Important: the server does not compute the values; the caller supplies them. Text length and the number of characters (people) appearing per episode are available in one call from noveland_list_episodes (plainTextLength / speakerCharacterCount for characters who speak / referencedCharacterCount for characters referenced with :code:, by name or by nickname). Important: real characters, objects (worldbuilding terms) and episodes are given by ID in the ref of categories; the server resolves their official names (avatars appear on the axis only for characters and objects; episodes show the official name only). Elements written with label are shown distinctly, as elements placed by the AI.
noveland_draw_family_tree
ChatGPTDraws the characters of a novel as a family tree: each generation is aligned in a row, and children descend from between their parents. Suited to an overview of blood relations and marriages. The drawing is not saved. Important: up to 60 people and 60 unions. Exceeding a limit is an error (nothing is omitted automatically). Important: a union has 1 or 2 partners (1 means a single parent). A person with several partners appears in separate unions. A person can be a child in one union only; listing them in two is an error. Important: real characters and objects (worldbuilding terms) are given by ID in ref; the server resolves their official names and avatars. Elements written with label instead of an ID are shown distinctly, as elements placed by the AI.
noveland_draw_graph
ChatGPTDraws elements of a novel as a relationship graph: relationships between characters or factions, chains of cause and effect, and anything else expressed with names and arrows. The drawing is not saved. Important: up to 60 nodes and 150 edges. Exceeding a limit is an error (nothing is omitted automatically). Important: real characters, objects (worldbuilding terms) and episodes are given by ID in ref; the server resolves their official names and avatars. Elements written with label instead of an ID are shown distinctly, as elements placed by the AI.
noveland_draw_timeline
ChatGPTDraws elements of a novel as a timeline (Gantt style). Each band stands for a character, faction or matter, and its segments show what state it was in from one episode to another. The drawing is not saved. Important: a band lists its segments in segments. A change of state is a new segment with its own label (e.g. episodes 1-5 "doubt" / 6-12 "wavering" / 13-20 "acceptance"). A period of absence is a gap between segments. Labels are optional; a band that only shows where something appears has a single segment. Labels fit inside the bar only when short (about 4-8 CJK characters, or roughly twice that in Latin letters); longer ones are readable only on hover. Important: up to 10 bands, 60 segments in total, and 30 arrows. Exceeding a limit is an error (nothing is omitted automatically). Important: the horizontal axis is story order (section order, then episode order within a section), not in-story dates. Episodes in the stock (not in any section) cannot be placed on the axis and cause an error. A segment's fromEpisodeId must not come after its toEpisodeId (both may be the same episode), and segments in the same band must not overlap. An arrow whose atEpisodeId falls outside the axis range derived from the segments is not an error, but its point in time is not drawn. Important: a band is named by its ref. Real characters, objects (worldbuilding terms) and episodes are given by ID in ref; the server resolves their official names and avatars. Elements written with label instead of an ID are shown distinctly, as elements placed by the AI.
noveland_embed_object_ref
ChatGPTConverts plain text in the body text into references to characters or objects (worldbuilding terms). The displayed text stays the same. Text that already has a reference, ruby or emphasis dots is skipped, so nothing is applied twice. items takes the conversions as a batch. They are saved at once, which is faster than one call per item and less likely to hit rate limits. The single form (targetText + objectCode) exists for backward compatibility. Passing both forms, or neither, is an error. items are applied in array order (up to 200). Placing longer text first avoids matching a substring of it by mistake. all-or-nothing: if any item is not found in the body text, the whole call fails and nothing is changed. The error message lists the items that were not found (up to 50), so they can be fixed in one retry. With items, also placing targetText / objectCode / nicknameId / paragraphId / match / speakerScope at the top level is an error. paragraphId and match go inside each item. speakerScope (filtering by speaker) exists only in the single form. Text that differs from the name of the character or object and is not yet a registered nickname is registered as a nickname and then referenced. paragraphId limits the search to one paragraph (blockId from get_episode(contentFormat="blocks")). paragraphId and speakerScope are combined with AND. matched_paragraph_ids is returned in paragraph order without duplicates, and can be reused as paragraphId in later calls.
noveland_get_attribute_key_usage
ChatGPTGets which characters and objects (worldbuilding terms) use an attribute key, to check the impact before deleting or renaming it. usingBaseObjects is sorted by name in ascending order. type is character or object. usageCount is the number of distinct characters and objects.
noveland_get_character
ChatGPTGets the full details of a character, including attribute values, nicknames, first-person pronouns and memo.
noveland_get_diagram
ChatGPTGets the details of a diagram: the characters and objects (worldbuilding terms) on it, including those without any relationship, and the relationships between them with their names.
noveland_get_document
ChatGPTGets the details of a document. The content is returned as NoveLand Markdown (:code: references characters and objects (worldbuilding terms), [[doc:id|label]] links to documents), together with the list of what it references.
noveland_get_episode
ChatGPTGets an episode's details. contentFormat selects the format of the body text. plain: plain text as readers see it noveland-markdown: NoveLand Markdown including speakers, references, ruby (reading annotations such as furigana or pinyin) and more (lossless round trip) - Paragraph start: [p] (narration) or [speaker:code] / [speaker:code1,code2] (dialogue; several speakers at once) - Paragraph break: a blank line (\n\n). The next paragraph still starts with [p] or [speaker:...] - Character or object reference: :code: or :code[nicknameId]: - Ruby: |base《reading》; emphasis dots: 《《text》》 - Illustration: [illust src="url" alt="description" appearances="code1,code2"] - Scene break: [scene-marker:title] blocks: a structured array of blocks (best for paragraphId-based edits and for finding paragraphs that still lack speakers or references) - Each blocks[] item has blockId / type / index - paragraph: text (plain) / speakerCodes / objectRefs / hasRuby / hasDots - illustration: src / alt / appearanceCodes - scene-marker: title - In blocks mode, no content string is returned (the blocks array replaces it) Every contentFormat adds paragraph stats at the top level (same keys as includeParagraphStats in list_episodes). Includes position, the episode number in story order (null in the stock).
noveland_get_me
ChatGPTGets the signed-in user's id, name, and avatar URL. AI-feature levels are set per novel; noveland_list_novels returns each novel's level as aiFeatureLevel. Operations beyond a novel's level return a FORBIDDEN error, and errors from per-novel operations (tools that take a novelId) include settingsUrl (the novel's settings page) when available. The AI-usage classification based on actual use (the detection axis) is separate from this permission setting. Details: resource noveland://docs/ai-usage-classification.
noveland_get_novel
ChatGPTGets a novel's details, including the total text length in characters across all its episodes, stock included (plainTextLength excludes whitespace; plainTextLengthIncludingWhitespace does not).
noveland_get_object
ChatGPTGets the full details of an object, including attribute values, nicknames and memo.
noveland_get_section
ChatGPTGets the details of a section (chapter). detail is returned as NoveLand Markdown.
noveland_link_foreshadowing_episode
ChatGPTAdds or removes a link between a foreshadowing entry and an episode. add requires type (setup or payoff). Linking an episode that is already linked is an error. remove does not require type (it is ignored). Removing a link that does not exist is an error. An episode cannot be linked as both setup and payoff. Changing the type is a remove followed by an add.
noveland_list_attribute_keys
ChatGPTLists the attribute keys (custom fields) of a novel. usageCount is the number of distinct characters or objects (worldbuilding terms) that have a value for the key; 0 means the key is unused. Details: noveland_get_attribute_key_usage.
noveland_list_characters
ChatGPTLists the characters in a novel. Attribute values and memos are not included. Supports cursor pagination. query narrows the list to characters whose name, nickname or code contains the given text.
noveland_list_diagrams
ChatGPTLists the relationship diagrams of a novel. Supports cursor pagination.
noveland_list_documents
ChatGPTLists the documents of a novel (content is not included). Supports cursor pagination.
noveland_list_episodes
ChatGPTLists the episodes of a novel. Filter with sectionId or stockOnly. Supports cursor pagination. Order: by section, then by order within the section. Episodes in the stock (not in any section) come last. position: episode number in story order, counted across sections (drafts included; null in the stock). It shifts when episodes move; episode IDs stay the same. brief=true: only id, title and position per episode (lighter; up to 500 per page, otherwise 100). Without brief, each episode includes counts that help decide which episodes to work on first: - speakerCharacterCount: distinct characters who speak (have dialogue) - referencedCharacterCount: distinct characters referenced with :code: in the body text, by name or by nickname (passing mentions included) - referencedObjectCount: distinct objects (worldbuilding terms other than characters) referenced with :code: in the body text, by name or by nickname - isPublished: whether the episode is published (false for unpublished drafts) - scheduledPublishAt: the date and time the episode is scheduled to be published (ISO 8601), or null when it is not scheduled. A scheduled episode cannot be moved to the stock includeParagraphStats=true adds the following (costs more, because each episode's Lexical content is parsed): - totalParagraphCount: number of paragraphs (ParagraphBlock) - paragraphsWithSpeakerCount: number of paragraphs with at least one speaker
noveland_list_foreshadowings
ChatGPTLists the foreshadowing entries of a novel. episodes[].type is setup or payoff. A foreshadowing entry without a payoff is unresolved. episodes[].id matches the episode id.
noveland_list_novels
ChatGPTLists the novels the user can access, including each novel's aiFeatureLevel (the level of AI features permitted for that novel). Supports cursor pagination.
noveland_list_object_types
ChatGPTLists the object types (term categories) of a novel in display order.
noveland_list_objects
ChatGPTLists the objects (worldbuilding terms: proper nouns such as places, items and organizations) in a novel. Attribute values and memos are not included. Supports cursor pagination. query narrows the list to objects whose name, nickname or code contains the given text.
noveland_list_sections
ChatGPTLists the sections (chapters) of a novel. Supports cursor pagination.
noveland_remove_object_ref
ChatGPTRemoves references to characters or objects (worldbuilding terms) embedded in the body text, in a batch. The displayed text stays the same; only the reference is dropped. Without paragraphId, the whole episode is searched. targetText narrows the removal to references embedded with that text. all-or-nothing: if any item matches no reference, the whole call fails and nothing is changed. Items that match the same reference are also an error. A character or object that is still embedded cannot be deleted. Deleting it requires removing its references with this tool in every episode first, and removing its speaker assignments with assign_speaker.
noveland_search_episodes
ChatGPTSearches episodes by keyword (query, PGroonga full-text search), filters (sectionIds / characterIds / objectIds), or both. Search syntax: space-separated words are combined with AND, the OR keyword combines with OR, and "quoted words" match as a phrase. Text without spaces is searched as a phrase, not split into separate AND terms. Default sort: relevance (descending) with query; story order without. characterIds matches episodes where the character speaks or is referenced by name or nickname (linked mentions only). With query, each hit has termCounts (occurrences of each term in the body text; positionsUnavailable: some could not be counted), lineCount and lines ([{n, text}]; a paragraph is one line unless it has line breaks; long lines are shortened); hits="counts" omits lines. Without query, hits="lines" gives the lines that link those targets or that the characters speak (speaks: true). context: N lines before and after each hit line (context: true), like grep -C. Lines total at most about 15,000 characters per response; when cut, next gives the offset and lineOffset to continue. With characterIds / objectIds, matches[] covers only those targets: speaks (characters; from [speaker:code] markers) and referenced (from :code: links by name or nickname). references="all" lists every speaker and reference and the episode start instead of counts and lines. limit: up to 100; up to 50 with references="all" or sectionIds alone. Includes position, the episode number in story order (null in the stock).
noveland_update_attribute_key
ChatGPTUpdates an attribute key: renames it, or adds or removes options of a key whose valueType is select. addOptions / removeOptions are accepted only when valueType is select.
noveland_update_character
ChatGPTUpdates characters. Pass an array, even for a single character. memo is NoveLand Markdown (supports :code: embeds and [[doc:id|label]] links, where id is a UUID returned by list_documents). attributes sets values for attribute keys, which must already exist (created with create_attribute_key). In nicknames / firstPersonNames, an entry with id updates it and an entry without id creates one. Deletion uses deleteIds. all-or-nothing*: if any item fails, the whole batch is rolled back. On error, the response includes failedIndex (0-based) and totalCount; failedIndex is the position of the failed item.
noveland_update_diagram
ChatGPTUpdates the title of a diagram.
noveland_update_document
ChatGPTUpdates the title or content of a document. The content is NoveLand Markdown (supports :code: embeds of characters and objects (worldbuilding terms), and [[doc:id|label]] links to documents, where id is a UUID returned by list_documents).
noveland_update_episode
ChatGPTUpdates an episode's title, body text, section, or position. The body text is NoveLand Markdown. Required: every body-text paragraph starts with [p] (narration) or [speaker:code] (dialogue). A new paragraph starts only at a paragraph marker; blank lines make no difference. Other block syntax ([scene-marker:...] / [illust ...]) is also allowed. Details: resource noveland://docs/scene-editor-syntax. :code: becomes a reference only for an existing code; other text between colons, such as 12:30:00, is saved as is, and no backslash escapes are needed. An unregistered :code: is saved as plain text and, unless attached to letters or digits, listed in unresolvedCodes in the response. Codes in [speaker:code] and appearances must exist; an unknown one is an error. When content is provided, it replaces the entire existing body text. This tool also moves an episode to another section or to the stock, and changes its position. A published or scheduled episode cannot be moved to the stock (sectionId: null). NoveLand shows readers how AI was used in each novel. Calling this tool, with or without content, marks the novel as "AI used to generate body text" (text_generated) right away. Details: resource noveland://docs/ai-usage-classification.
noveland_update_foreshadowing
ChatGPTUpdates the name or description of a foreshadowing entry.
noveland_update_novel
ChatGPTUpdates a novel's title or synopsis.
noveland_update_object
ChatGPTUpdates objects. Pass an array, even for a single object. memo is NoveLand Markdown (supports :code: embeds and [[doc:id|label]] links, where id is a UUID returned by list_documents). attributes sets values for attribute keys, which must already exist (created with create_attribute_key). For an object with an object type, only the keys of that object type are accepted. In nicknames, an entry with id updates it and an entry without id creates one. Deletion uses deleteNicknameIds. all-or-nothing: if any item fails, the whole batch is rolled back. On error, the response includes failedIndex (0-based) and totalCount; failedIndex is the position of the failed item.
noveland_update_section
ChatGPTUpdates the name, detail or position of a section. detail is NoveLand Markdown (supports :code: embeds of characters and objects (worldbuilding terms), and [[doc:id|label]] links to documents, where id is a UUID returned by list_documents).
noveland_upsert_relationship
ChatGPTAdds, updates or deletes the relationship between two characters or objects (worldbuilding terms) in a diagram. forward (fromId -> toId) and reverse (toId -> fromId) are set independently. An empty description deletes that direction. Missing nodes are created when a relationship is added. Deleting a relationship keeps the nodes. strokeWidth / strokeStyle keep their current values when omitted.
noveland_view
ChatGPTUsed only by NoveLand widgets; not a tool for the model. The result is intermediate data for rendering and is not usable as an answer in the conversation.
noveland_apply_dots
Claudenoveland_apply_ruby
Claudenoveland_assign_speaker
Claudenoveland_create_attribute_key
Claudenoveland_create_character
Claudenoveland_create_diagram
Claudenoveland_create_document
Claudenoveland_create_episode
Claudenoveland_create_foreshadowing
Claudenoveland_create_novel
Claudenoveland_create_object
Claudenoveland_create_object_type
Claudenoveland_create_section
Claudenoveland_delete_attribute_key
Claudenoveland_delete_character
Claudenoveland_delete_diagram
Claudenoveland_delete_document
Claudenoveland_delete_episode
Claudenoveland_delete_foreshadowing
Claudenoveland_delete_object
Claudenoveland_delete_object_type
Claudenoveland_delete_section
Claudenoveland_draw_chart
Claudenoveland_draw_family_tree
Claudenoveland_draw_graph
Claudenoveland_draw_timeline
Claudenoveland_embed_object_ref
Claudenoveland_get_attribute_key_usage
Claudenoveland_get_character
Claudenoveland_get_diagram
Claudenoveland_get_document
Claudenoveland_get_episode
Claudenoveland_get_map
Claudenoveland_get_me
Claudenoveland_get_novel
Claudenoveland_get_object
Claudenoveland_get_section
Claudenoveland_link_foreshadowing_episode
Claudenoveland_list_attribute_keys
Claudenoveland_list_characters
Claudenoveland_list_diagrams
Claudenoveland_list_documents
Claudenoveland_list_episodes
Claudenoveland_list_foreshadowings
Claudenoveland_list_maps
Claudenoveland_list_novels
Claudenoveland_list_object_types
Claudenoveland_list_objects
Claudenoveland_list_sections
Claudenoveland_remove_object_ref
Claudenoveland_search_episodes
Claudenoveland_update_attribute_key
Claudenoveland_update_character
Claudenoveland_update_diagram
Claudenoveland_update_document
Claudenoveland_update_episode
Claudenoveland_update_foreshadowing
Claudenoveland_update_novel
Claudenoveland_update_object
Claudenoveland_update_section
Claudenoveland_upsert_relationship
Claude
