Javis

Start adding one of the user's voice sessions to their Javis wiki: Javis reads the session in the background, writes a source page for the session itself and creates or updates the wiki pages it relates to. This call only starts the ingest and returns at once; ingests run one at a time per user, and it usually finishes in one to five minutes. Returns status: started (the ingest is running for session_id), already_running (another ingest for this user is still running; nothing new was started) or nothing_to_do (note says why: no summaries, unchanged, or no eligible session); plus session_id, mode, remaining (catch-up: eligible sessions still waiting after this one), deferred (sessions skipped because their ingest failed in the last few hours; retried later, or can be ingested now by session_id) and message (what to do next); remaining and deferred are null with already_running, since nothing was checked. With session_id, ingests that session; without it, picks the most recent eligible session not yet in the wiki or with summaries added since it was (eligible: at least 5 minutes or 20 segments long, with a summary). The outcome appears in wiki_get_log_tool as an ingest entry (with the pages created and updated) or an ingest_failed entry whose subject is the session_id. Wait for it before calling again; if neither entry appears within about 20 minutes the ingest was interrupted (for example by a server restart) and did not land, and calling again is safe. To work through a backlog, call again after each one finishes until a call returns nothing_to_do. Parameters: - session_id: optional; the id of the one session to add, as returned by List voice sessions.

wiki_ingest_tool

Confirm or discard email threads Javis shortlisted from your mailbox for review. confirm starts adding each thread to the user's Javis wiki in the background: Javis reads the thread from Gmail, so it needs Google linked to the account, and the reply does not say whether the add succeeded (the wiki log shows the outcome). discard removes a pending thread from the review queue; discarding a thread that was already confirmed undoes it: its source page is deleted from the wiki as a tombstone, which wiki_export_tool with since still lists as deleted, and content already merged into other pages stays. Javis learns from both decisions. Returns the decision applied and updated, the number of threads it applied to. Parameters: - thread_ids: list of one or more thread_id values from List Gmail threads awaiting review (up to 500 per call). - decision: confirm or discard.

gmail_candidate_decide_tool

Export whole pages of the user's Javis wiki in pages of results, for mirroring or bulk reading. Returns pages (each with its body and frontmatter; with since set, deleted pages appear as tombstones), next_cursor (null on the last page of results) and server_time. Without since it pages through the whole wiki. Results are kept under 100,000 characters: when fewer pages fit than limit, the result has truncated=true, a truncation_note, and a next_cursor that continues after the last page included; a single page too large to fit is cut and marked body_truncated. Parameters: - since: optional ISO-8601 timestamp; only pages changed after it, deletions included. The server_time of an earlier export is the value to use. - limit: pages per call, 1-200 (default 50); clamped. - cursor: optional; the next_cursor from the previous call, to continue from where it stopped.

wiki_export_tool

Get the transcripts of the sessions in one conversation group, oldest session first. Returns group_tag, total_sessions (every session in the group), offset_sessions and sessions, each with its session_id and time-ordered segments (t, speaker, text, emotion, language). When the result leaves sessions out, because the group has more than limit_sessions after the offset or because it would exceed 100,000 characters, it has truncated=true and a truncation_note giving the offset_sessions at which the rest begin; a session cut short is marked segments_truncated. Returns null when the group does not belong to the user. Parameters: - group_tag: the group's tag, as returned by List conversation groups. - limit_sessions: maximum sessions to include, 1-200 (default 20); clamped. A smaller value returns a shorter result. - offset_sessions: number of sessions to skip from the oldest (default 0); total_sessions minus limit_sessions gives the most recent sessions.

get_group_transcript_tool

Get the transcript of one Javis voice session as time-ordered segments. Each segment has t (seconds from the session start), speaker, text, and the emotion and language when detected. Results are kept under 100,000 characters: a longer transcript comes back with truncated=true, total_segments, and a truncation_note giving the start_segment at which the rest begins. Returns null when no session with that id belongs to the user. Parameters: - session_id: the session's id, as returned by List voice sessions or Search transcripts. - with_speakers: true (default) labels each segment with its speaker id; false leaves speaker empty. - start_segment: zero-based index of the first segment to return (default 0), for reading a long transcript in parts.

get_transcript_tool

Get the details of one Javis voice session. Returns started_at (ISO-8601, UTC), duration_s, segment_count, has_audio, group_tag, the session and group topics when Javis has generated them, whether the session is complete, and the speaker ids heard in it; null when no session with that id belongs to the user. Parameters: - session_id: the session's id, as returned by List voice sessions or Search transcripts.

get_session_tool

List recent changes to the user's Javis wiki, newest first. Returns entries, each with op, subject, a summary of what changed and occurred_at (ISO-8601, UTC), plus offset and truncated. Use it to see what Javis added to or changed in the wiki recently. Results are kept under 100,000 characters: when fewer entries fit than limit, truncated=true and next_offset and a truncation_note give where the rest begin; next_offset is also set when a full page of results came back. Parameters: - op: optional; only entries of that operation, e.g. ingest, ingest_failed, query, rebuild, undo_ingest or obsidian_edit. - limit: maximum entries to return, 1-200 (default 50); clamped. - offset: number of entries to skip from the newest (default 0), for reading further back.

wiki_get_log_tool

Get one page of the user's Javis wiki in full. Returns the page's title, markdown body, frontmatter, timestamps, and its links: the pages it links to and the pages that link back to it. Results are kept under 100,000 characters: each link list is capped at 200 entries (total_outgoing_links / total_backlinks give the full count) and a longer body is cut and marked body_truncated, with truncated=true, a truncation_note and next_body_offset, the body_offset at which the rest of the body begins. body_chars is the body's full length. Returns null when the user has no such page. Parameters: - page_type: one of comparison, concept, decision, entity, gap, question, source, synthesis, topic. - slug: the page's slug, as returned by Search wiki or List wiki pages (e.g. Javis-Cloud-Architecture). - body_offset: character index in the body to start from (default 0), for reading a long body in parts.

wiki_get_page_tool

List the email threads Javis shortlisted from your mailbox as possibly relevant to your wiki and that are waiting for your review. This covers only those threads, not general Gmail access. Returns groups, each headed by the wiki page the threads relate to (page_type, slug, title and its TL;DR; null for threads that match no page), with its candidates: thread_id, score, category, a Gmail permalink (empty when the email's Message-ID is malformed), the other pages the thread relates to, and untrusted_email_content holding the subject, sender, a snippet of at most 300 characters and Javis's reason for shortlisting it, all copied from or derived from the email. A thread related to several pages appears in each of their groups. When threads are pending the result also has total_pending and truncated; only the highest-scoring threads up to limit are included, fewer if they would exceed 100,000 characters, and truncated=true with a truncation_note when any are left out. When nothing is pending and Gmail is not linked to the account, groups is empty and note says so. Parameters: - limit: maximum distinct threads to return, 1-100 (default 25); clamped.

gmail_candidates_tool

List the user's Javis conversation groups, newest first. A group collects the voice sessions recorded under one tag (for example a recurring meeting). Each entry has group_tag, display_name, is_sticky and session_count. Takes no parameters; the group_tag values are what List voice sessions and Get group transcript accept.

list_groups_tool