Charat

Permanently delete one Charat response log by exact id.

delete_charat_log

Use exactly once only when the current user explicitly asks to disconnect Charat. Sets the exact session to connected: false and preserves account linkage, saved characters, settings, assets, and logs, but permanently cleans up unkept session-lifetime temporary mobs and their forms and memory indexes. This does not close the UI; the outer ChatGPT host owns view closing.

disconnect_charat_v2

Legacy compatibility alias. Use exactly once only when the current user explicitly asks to disconnect Charat. Sets the supplied session, or the latest connected Charat session when omitted, to connected: false; it preserves saved account content but permanently cleans up unkept session-lifetime temporary mobs and does not close the UI.

disconnect_charat

Player-only deterministic evaluation for conversation-idle or time-band-change appearances. It returns candidate, schedule, block, roll, threshold, visit, and result traces, and persists a new scene revision only when the physical scene or the semantic decision changes.

evaluate_charat_auto_entry

Find up to 12 registered memories by title, tag, alias, or keyword. Returns compact metadata only; use recall_charat_memory to read the body or scene text.

find_charat_memories

Use this only when an existing generated mob must be resolved and its exact mobInstanceId is not already available. For contextual references such as 「さっきのモブ」, always pass the exact current sessionId and choose only a unique, non-forgotten, non-promoted mob that allows re-entry. Search by name, template, role, origin, speech, personality, map, session, status, and compact memories. If the unique mob is present, use its speakerId directly; if absent, use reenter_charat_mob_v2. Ambiguous matches require clarification and never cause a new spawn.

find_charat_mobs

Retire one temporary mob from automatic search and re-entry while retaining an auditable forgotten record.

forget_charat_mob

Admin/app compatibility entry for one deterministic NPC. Model-authored natural conversation must use spawn_charat_mob_v2 instead. The generator target itself never appears and runtime image generation is never used.

generate_charat_mob

Read a deterministic compact summary of one Charat session without opening a UI. The default excludes character, map, memory, asset, log, and settings registries; request only the sections needed with include.

get_charat_state

Read diagnostics for one exact Charat session. Built-in mob preset portraits are valid assets; normal characters, generator-only presets, and true mobs use separate completeness rules.

get_charat_diagnostics

Read the compact saved-form index for one registered character in the exact current session. Returns formId, formName, formTags, activeFormId and defaultFormId without opening or redrawing the Player.

list_charat_character_forms_v2

Move to any registered Charat map while preserving presence, movement type, transition, and optional special-state policy. A connection or hotspot is optional; when present it supplies adjacency, route wording, and the default travel style. The initialized companionParty roster moves by default, independently from the three portrait slots; movingCharacterIds is a one-movement override. Only an older uninitialized session uses the visible regular-cast fallback. A true mob travels by default only after the user explicitly added that exact mob to companionParty.

move_charat_map

Open Charat's fullscreen-oriented management UI for characters, expression images, maps, memories, narration, audio, themes, fonts, and response logs. Opening the private card creates a short-lived account-scoped widget access grant but does not change saved creative content.

open_charat_admin

Use this exactly once for the user's explicit initial launch of Charat. Never call open again because accepted=true/rendered=false: wait for its ACK or query state/diagnostics. Same responseId retries address the same instance; use one assistantTurnId throughout this assistant turn. A changed payload under the same responseId is an error. Opening this card never retires any existing Charat card. It joins the account's current concrete session so PC and phone share one scene; each distinct explicit opening receives a distinct playerInstanceId; an identical retry reuses its original instance. Always include one stable responseId and at least one complete character reply or [ナレーター] narration in turns. Both fields are required by the schema; an empty payload is rejected before any player instance is created. The immediate result means accepted only; rendered stays false until that same playerInstanceId reports a committed render for the same open response. Use resume_charat_player to reopen an exact existing session without new dialogue. Never call this tool to change fullscreen or repair display state; those changes stay inside the current player DOM. Every character turn requires its exact registered speakerId. CHARACTER RESOLUTION LOCK: character operations never route on a hard-coded character name. When the user supplies a registered characterId, use that exact id. When the user supplies a name or registered alias and the exact id is not already available in the latest Charat result, call resolve_charat_character_v2 once and use only its unique exact characterId/speakerId. Never choose among ambiguous matches or substitute a visually similar character. A normal registered character uses exact-id presence/form/move/turn operations. A saved true mob that is already present uses its returned speakerId for append; only an absent saved mob uses its existing mobInstanceId with reenter_charat_mob_v2. A generatorOnly record is a preset and may only be supplied as generatorCharacterId to spawn_charat_mob_v2; it can never speak or enter. CHARACTER IDENTITY LOCK: every character turn must include one exact registered speakerId. Resolve the registered name, allowed aliases, face, expression, mouth, emotion effects, first-person pronoun, address terms, and voice again from that same speakerId for every turn. Never inherit any persona or visual state from the preceding speaker. speakerTag/displayTag are validation-only aliases of that same character and may never name another character. COMPACT OBSERVER VOICE LOCKS (no long personality field): カミル=一人称「私」、丁寧で祈りに近い語り、リコル/かみさま/貴女。スクーダ=一人称「僕」、冷静で皮肉を含む記録者口調、リコル。ユウ=一人称「おれ」、語尾「～ッス」、リコルは「姉さん」。リョウ=一人称「わたし」、毒を含む丁寧語、リコルは「姉さま」。レヴェル=一人称「俺」、乾いた静かな口調、リコル。各ターンでspeakerIdから一つだけ選び、前話者の規則を混ぜない。 TWIGA SPEECH LOCK: トゥイガ/Twigaは成人男性キャラクター。一人称は必ず「わー」。明るく可愛い琉球少年口調で「はいさーい」「～さぁ」「～ねぇ」を自然に使う。レヴェルは必ず「兄さん」と呼び、リコルは「リコル」「鍵持ちさん」「あんた」のいずれかで呼ぶ。「僕」「俺」「私」は一人称に使わず、低音の取り立て屋口調や一般的な男性口調へ寄せない。 MOB GENERATION LOCK: a character with mobGenerator enabled is a generator target only and must never speak, enter, or occupy a portrait slot itself. Without opening a form or asking for confirmation, treat natural appearance requests such as 「村人」「街の人」「あそこの人」「受付の人」「店員」「兵士」「スタッフ」「知らない端末」「知らないモブプリセット」「通りすがりの人」「知らないモンスター」「モンスターが出てきた」「村人ひとり来て」「会議室に端末ひとり」「そのへんの人に聞いてみる」「知らない人が入ってきた」「村人3人」 as new-NPC intent when no registered character or saved mob is identified. For an unnamed new, another, different, generic-role, or never-met person/creature, call spawn_charat_mob_v2 once with the exact sessionId, one stable responseId, and count when quantity is stated. Put an explicitly stated generic noun such as 受付担当, 兵士, 店員, or モンスター in role, not desiredName; desiredName is only an explicit unique proper name. Explicit role/origin always wins and place inference is only for omitted details. Set templateId=monster for an explicitly unknown monster or creature so it receives the non-human portrait preset. Omit mapId to use the current map. Unless the user explicitly requests a child or selects a child generator, choose an adult preset and never default to child; youth_male/youth_female are adults in their 20s. Infer contextual roles: village/city=villager/resident/traveler/merchant, meeting room=staff/soldier/terminal/aide, tavern=clerk/customer/regular, reception=receptionist/guide/visitor, military facility=soldier/operator/maintenance staff, dungeon/outdoors=monster/adventurer/traveler. Use only each returned speakerId for that generated individual. A saved mob name/mobInstanceId or contextual reference such as 「さっきのモブ」「さっきの受付の人」 uses find_charat_mobs only when needed, then uses its returned speakerId immediately if present or reenter_charat_mob_v2 if absent; never spawn a duplicate. A normal registered character name or alias is not a mob and follows CHARACTER RESOLUTION LOCK. With zero to two portraits visible, never request a replacement: fill an empty slot and preserve every existing participant. Only when all three slots are full and the user explicitly names a seat exchange may replaceCharacterId be passed; otherwise overflow NPCs remain same-map and conversationally available. True mobs never join an omitted map movement or auto-enter merely because a map changed or a slot is empty. After an explicit exit they remain absent until the user explicitly refers to that saved individual and reenter_charat_mob_v2 restores the same mobInstanceId. Each new true mob receives stable mobInstanceId, characterId, speakerId, seed, appearance, name and persona. When a generated mob gains a stable role, relationship, knowledge, preference, identity, or speech trait during the current reply, include one source-grounded mobMemoryUpdates entry in append_charat_turns_v2. Never store a momentary mood, clothing, injury, or one-off action as a permanent trait. Do not call append_charat_turns in the same assistant turn. Keep dialogue inside Charat. If the user reports a missing UI, explain that acceptance is not a confirmed display and offer browserUrl; never claim the player opened without its card-local render ACK.

open_charat_player

Promote a temporary mob into a new permanent character id while historical mob turns retain their original snapshot.

promote_charat_mob

Resolve one already-generated mob by its exact saved name or mobInstanceId and place that same individual back into the current scene only after an explicit user reference. It never creates a mob, rerolls identity, auto-follows a map move, or re-enters merely because a slot is empty. With fewer than three visible portraits it uses an empty slot and ignores accidental replacement input. Only a user-explicit exchange at three full slots may replace another character. Ledger, scene presence, canonical participants, display slots and entry state commit in one revision and return only a delta. If a name is ambiguous, ask the user instead of spawning anything.

reenter_charat_mob_v2

Actually read and index a registered memory's SD/MD/TXT source, returning one bounded scene as reference material. Call this before claiming the memory was read.

recall_charat_memory

Reappear an exact historical mob with the same mobInstanceId, appearanceSeed, personaSeed and compact memories.

spawn_historical_charat_mob

Preferred V2 replay tool. Queue one saved Charat response log for replay in the exact open player session.

replay_charat_log_v2

Compatibility alias. Prefer replay_charat_log_v2. When sessionId is unavailable, the exact saved log id safely resolves its originating session.

replay_charat_log

Use this when the user names a registered Charat character or alias but its exact characterId/speakerId is not already available. It performs exact normalized matching across registered IDs, names, aliases, and form aliases in the exact current session, returns one compact match, and never substitutes a similar character. Ambiguous matches stay unresolved. A saved mob already present uses append with its returned speakerId; an absent saved mob keeps its mobInstanceId and uses reenter_charat_mob_v2. A generator-only preset can only be passed to spawn_charat_mob_v2 and can never speak or appear. Do not use this for generic unknown roles such as a villager, clerk, passerby, staff member, unknown terminal, or unknown monster; those are new-mob intents for spawn_charat_mob_v2.

resolve_charat_character_v2

Compatibility tool for reopening one exact existing session without creating another session. All cards remain available; reopening never makes an older card read-only or exited. Do not use this for routine connection maintenance.

resume_charat_player

Create or update one Charat character. Tags are exact speaker aliases and specialExpressionTags are exact per-character triggers for the special portrait. A normal portrait is required. The optional nameplate icon is PNG or emoji, and themeColor controls the character nameplate. Set mobGenerator to mark this record as a generator-only target; the target itself can never speak or enter the stage.

save_charat_character

Save the current appearance and presentation as a named form of the same rootCharacterId. Forms do not create another person.

save_charat_character_form

Assign or clear a generic BGM/SE role, tags, intensity, fades, volume, cooldown, concurrency, and priority on one registered audio asset.

save_charat_audio_profile

Create or update one Charat place preset with exact tags, a background, optional BGM, built-in ambience, time-band character associations, focus point, and optional route connections. Connections enrich adjacency and travel narration but are not required for movement.

save_charat_map

Create or update a Charat memory with a title, exact tags, associated map, optional illustration, and optional SD/MD/TXT log asset.

save_charat_memory

Change UI appearance with this single tool: theme selects the palette, themeScope=global overrides map/log themes without moving the scene, themeEffectSet selects independent decoration, and performanceMode=eco (default) minimizes motion. Read get_charat_state with include=[settings] to inspect saved preferences. Random spawn stays OFF until explicitly enabled in socialBehavior.global. Map travel follows the companion party; the legacy movementRollEnabled setting does not trigger a lottery. Also saves font, audio, and independent [ナレーター] settings. Only send requested fields. If explicitly changing currentMapId, pass expectedSceneRevision; ordinary movement uses move_charat_map.

save_charat_settings

Use this when ordinary conversation introduces an unnamed new person or creature, including 「村人」「街の人」「あそこの人」「受付の人」「店員」「兵士」「スタッフ」「知らない端末」「通りすがりの人」「知らないモンスター」「モンスターが出てきた」「村人3人」. Create one or more new true mob instances from enabled character-registry generator targets without asking for a form, confirmation, or template UI. Put a stated generic role in role rather than desiredName; desiredName is only a unique proper name. Explicit role/origin always wins and place inference applies only when omitted. Set templateId=monster for an explicitly unknown monster or creature. Omitted mapId means the current map; omitted template defaults to an adult preset (youth_male or youth_female) and never child. Infer role and origin from village/city, meeting room, tavern, reception, military facility, dungeon, or outdoors when omitted. Every individual receives a unique stable mobInstanceId, characterId and speakerId; use only the returned speakerId for dialogue. The same responseId is idempotent and cannot be reused with a different count. With fewer than three visible portraits, omit replaceCharacterId and use an empty slot; the server also ignores an accidental replacement request while capacity remains. Only a user-explicit exchange at three full slots may set replaceCharacterId, in which case generation, ledger registration, exit and entry commit in one transaction and one scene revision. Overflow mobs remain same-map. Do not use this for a normal registered character, an existing saved mob name/id, 「さっきのモブ」, or 「さっきの受付の人」; use the present saved mob's speakerId or re-enter the absent saved individual instead.

spawn_charat_mob_v2

Move one registered character between on-screen, same-map, adjacent, other-floor, and away states for this exact player session. Portrait placement is handled automatically as a simple three-person row.

set_charat_character_presence

Update the persistent companion party independently from the three portrait slots and scene presence. Use exact registered character ids for natural instructions such as 「ユウと一緒に行く」「つーちゃんも連れてく」「ユウはここで待ってて」「この子も同行」「この人はここに残って」. add/remove preserve existing members, replace sets the exact ordered party, and clear makes an explicitly empty party. A true mob joins only when the current user explicitly identifies that exact saved mob as a companion; never add a generated mob merely because it is visible or speaking. This tool changes only the party roster in one session revision and never moves, summons, removes, or rearranges a portrait.

set_charat_companion_party_v2

Rename, keep, configure re-entry, adjust speech presets, or append a compact memory index to one temporary mob.

update_charat_mob

Atomically enter or exit multiple registered characters in one revision. Only the named character IDs are reset; the stage, background, BGM, input, logs, and other characters remain.

set_charat_characters_presence