Quill's Chronicles

Get a list of worlds the user has access to (owned or invited to campaigns within). This is typically the starting point for exploring data. Worlds the GM has finished carry completed=true.

Get details about a specific world including all its campaigns with their session counts.

Get detailed information about a specific campaign including sessions, arcs, parties, and entity counts.

Get a chronological list of sessions in a campaign with nested chapters, excerpts of each session's story digest and chapter summaries, and narrative_status. Use brief=true for minimal fields; get_session_summary returns a session's full text.

Get entities in a campaign filtered by type. Use brief=true for minimal fields.

Get comprehensive details about a wiki entity including type-specific fields.

Find an entity by name within a campaign. Useful when you know the name but not the quill_id.

Get details about a specific relationship between two entities.

Search for wiki entities by name, description, or aliases. Returns brief results — use get_entity for full details.

Get entities created within a specific temporal range. Use format "s001.c005" for temporal IDs.

Get all entities introduced in a specific session.

Get entities introduced in the last N sessions.

Get an entity's relationships sorted chronologically. Identify the entity by quillId, or by entityName plus campaignId.

Get all relationships between two specific entities. Identify each entity by its quillId, or by name plus campaignId.

Get the chapters within a specific session. Identify the session by sessionQuillId, or by campaignId plus sequenceOrder.

Get a narrative journey of an entity through the campaign. Shows appearances, relationships, and quotes. Identify the entity by quillId, or by entityName plus campaignId.

Get all entities directly connected to a given entity through relationships. Each connection carries temporal provenance: neighbor first_seen and per-edge temporal_id (world-prefixed, e.g. "w(default).s005.c002" — the trailing sNNN.cNNN segment is the session/chapter key). Identify the entity by quillId, or by entityName plus campaignId.

Get ESSENCE relationship summaries - AI-generated insights condensing all relationships between entities.

Get all entities that appeared in a specific chapter.

Get all members of a party: linked Characters (with role, status, join/leave) plus any unlinked member names recorded on the party but not yet linked to a Character node. Membership is based on the party-member edge being active, not on role — members without an assigned role are still returned. Identify the party by partyQuillId, or by partyName plus campaignId.

PC-centric relationship evolution for a party: every member's relationship events aggregated per (partner, session), with temporal provenance (first_temporal_id per cell, world-prefixed — the trailing sNNN.cNNN segment is the session/chapter key). Partner lists are capped per member by event volume; PC-to-PC rows are always kept. Identify the party by partyQuillId, or by partyName plus campaignId.

Get entities at a location, including nested locations. Identify the location by locationQuillId, or by locationName plus campaignId.

Get members and affiliates of an organization with roles and influence levels. Identify the organization by orgQuillId, or by orgName plus campaignId.

Get all entities that know a specific secret with context about how they learned it. Secrets are hidden content — only available to campaign owners and co-DMs. Identify the secret by secretQuillId, or by secretName plus campaignId.

Get comprehensive statistics about a campaign including entity counts, relationships, sessions.

Get a summary of all entities of a specific type with aggregated statistics.

Analyze the relationship network for an entity or entire campaign. Pass entityQuillId for one entity, or campaignId alone for the whole campaign.

Get the "Story Thus Far" summary for a session. Identify the session by sessionQuillId, or by campaignId plus sequenceOrder.

Find the entities with the most relationships in a campaign.

Get a timeline of when entity types were introduced throughout the campaign.

Per-speaker talk-time analytics: who talked, for how long, how many words, and the GM-vs-player split. Session form (sessionQuillId) returns one session's speakers; campaign form (campaignId) returns the per-session series for trend analysis (e.g. "who has been fading?"). DM-only, like the transcript. Multitrack sessions have millisecond-accurate timings; manual text imports return word counts only (timed:false). Each speaker carries mapped:false when its character is just a raw per-session diarization label (no speaker map) — such labels are NOT comparable across sessions, so never aggregate them by name in campaign-level analysis. Speakers carrying unknown:true are tracks the speaker map could not put a name to (the literal placeholder Unknown): pool them with mapped:false ones and never treat them as a character or a player. MEASURED vs INTERPRETED: the talk-time numbers are measured (the multitrack track IS the speaker). The session form also carries spotlight_modes when available — a MODEL'S INTERPRETATION of the session (what kind of scene each stretch was, how each character engaged, standout emotional beats), NOT a measurement; present it as a read, never as fact. It is absent when the session has no computed interpretation.

Get narrative arcs in a campaign. Lite mode (default) lists all arcs with basic info. Deep mode (provide arcQuillId) returns full arc details including involved entities and spanned chapters.

Get specific lines from a session transcript.

Get metadata about a session transcript without downloading it.

Search for a phrase or keyword within a session transcript.

Roll the d6 oracle for yes/no questions with narrative complications. Returns results like "Yes, and...", "No, but...", etc. Optionally roll for multiple threads at once (batch mode).

Roll dice using standard notation. Supports modifiers (+/-), advantage (kh = keep highest), and disadvantage (kl = keep lowest). Examples: "1d20+5", "2d20kh1+3" (advantage), "2d20kl1-2" (disadvantage), "4d6kh3" (stat rolling).

Update fields on a wiki entity. Requires owner or co-DM access to the campaign, and campaignId must match the campaign the entity actually belongs to. Its read-only companion preview_update_entity returns the before→after change without writing. Optional expected_updated_at (from preview_update_entity or a prior read) makes the update fail safely if the entity changed in the meantime.

Create a new wiki entity in a campaign. Requires owner or co-DM access. Its read-only companion preview_create_entity returns what would be created, including a warning when a same-name entity already exists.

Create a relationship (source → type → target) between two entities in the SAME campaign. Requires owner or co-DM access; both endpoints must belong to campaignId (cross-campaign relationships are rejected).

Archive (soft-delete) a relationship. Requires owner or co-DM access to the campaign both endpoints belong to; campaignId must match.

Archive (soft-delete) a wiki entity. Requires owner or co-DM access; campaignId must match the campaign the entity actually belongs to. Relationships referencing the entity are left dangling; the read-only companion preview_archive_entity reports how many. Optional expected_updated_at (from preview_archive_entity or a prior read) makes the archive fail safely if the entity changed in the meantime.

Merge one wiki entity into another: all of the secondary entity's relationships are rewired to the primary, its name and aliases are appended to the primary's aliases, and the secondary is archived. Not reversible. Requires owner or co-DM access; both entities must belong to campaignId. The read-only companion preview_merge_entities reports the impact and returns the expected_*_updated_at tokens, which make the merge fail safely if either entity changed in the meantime.

Bulk find & replace text across a campaign's wiki records (entities, relationships, sessions, chapters, quotes, and the Story Thus Far digests via the story_thus_far field — never transcripts). Requires owner or co-DM access. expected_match_count is the totalMatches returned by preview_find_replace for the same arguments; if the match set has changed since, the call fails with a conflict and nothing is written. Matches whole words only unless wholeWord is set to false; case-insensitive unless caseSensitive is set to true.

Preview a field update without making any change: the entity/campaign, each field's before → after value (and whether it actually differs), and the current updated_at to pass to update_entity as expected_updated_at. Requires owner or co-DM access. Accepts the same field arguments as update_entity.

Preview creating a new wiki entity without making any change: the campaign, the type/name/fields that would be created, and a warning if a non-archived entity with the same name already exists (a likely duplicate). Requires owner or co-DM access. Accepts the same arguments as create_entity.

Preview the impact of archiving an entity WITHOUT making any change: entity name/type, how many non-archived relationships reference it (these become dangling on archive), and its current updated_at (pass it to archive_entity as expected_updated_at). Requires owner or co-DM access to the campaign the entity belongs to.

Preview the impact of merging one entity into another WITHOUT making any change: both entities' names/types, how many relationships would rewire from the secondary to the primary, name/alias collisions, and both updated_at values (pass them to merge_entities as expected_primary_updated_at / expected_secondary_updated_at). Requires owner or co-DM access; both entities must belong to campaignId.

Preview a bulk find & replace across a campaign's wiki records without making any change: every record/field that would change, with before/after text and occurrence counts (first 100 matches shown), and totalMatches to pass to find_replace as expected_match_count. Searches entities, relationships, sessions, chapters, quotes, and the Story Thus Far digests (story_thus_far) — never transcripts. Requires owner or co-DM access. Matches whole words only unless wholeWord is set to false; case-insensitive unless caseSensitive is set to true.