Kuliko AI

Generate learning resources from an existing document using AI. Returns the generated resources directly. Constraints: - For flashcards, notes, summaries, and mind_maps: each source can only have resources generated once per type. If they already exist, this will fail. - For quizzes: cannot generate a new quiz if there is an active (in-progress) quiz for the same source. Complete it first.

generate_resources

Get metadata about a specific document, including title, file size, token count, tags, and timestamps.

get_document

Get the raw extracted text content of an uploaded document. Large documents may return very long text that could fill up the conversation context.

get_document_text

Get the user's learning resources of a given type.

get_learning_resources

Get the full mind map tree for a document. Returns the hierarchical topic structure with labels, descriptions, and relationships between concepts. Can be rendered as a Mermaid diagram, structured visual hierarchy, or interactive format.

get_mind_map

Get all questions for a quiz, including their Glicko-2 difficulty ratings, choices, and any existing answers.

get_quiz_questions

Get the full results of a completed quiz attempt, including score, per-question answers, performance analysis, strong areas, and areas to review.

get_quiz_results

Get the completion status of a specific quiz (new, in_progress, or completed).

get_quiz_status

Get one share group, including its members. Member objects include `member_user_id`, which is required when removing a member from the group.

get_share_group

Get the user's current subscription status and tier.

get_subscription

List the user's uploaded documents/sources.

list_documents

List documents the current user has shared. Status meanings: `pending` means the recipient has not responded; `accepted` includes `copied_source_id`; `declined`, `revoked`, and `expired` are terminal states; `failed` includes an `error` describing why the accept-copy job failed.

list_outgoing_shares

List all quiz attempts by the user, showing scores and completion status.

list_quiz_attempts

List reusable document share groups owned by the current user.

list_share_groups

List the user's subjects with names and document counts.

list_subjects

Submit a spaced-repetition rating for a flashcard. Called by the flashcard widget after the user picks Again / Hard / Good / Easy.

rate_flashcard

Remove one member from a share group. Use `get_share_group` to find the member's `member_user_id`. This affects future group shares only; existing share rows remain visible and revocable according to their own status.

remove_share_group_member

Rename an existing subject.

update_subject

Start an interactive flashcard review session. Shows due flashcards one at a time with spaced-repetition rating buttons (Again, Hard, Good, Easy). Optionally filter by source or subject.

review_flashcards

Revoke a pending outgoing share. Only pending shares can be revoked. Accepted, declined, revoked, expired, or failed shares remain in outgoing history and cannot be revoked.

revoke_share

Search across the user's uploaded documents using semantic search. Returns relevant text passages matching the query.

search_documents

Share a document with one user by email or with a share group. Provide exactly one of `recipient_email` or `group_id`. Group shares fan out into one share row per current group member. Duplicate pending shares for the same document and recipient are skipped, so a duplicate-only group share returns a note instead of an error. Users cannot share documents with themselves. Optional messages are limited to 1000 characters.

share_source

Begin a new attempt on a quiz. Called by the quiz widget when the user clicks Start. Returns the full quiz state with questions ready to answer. If an in-progress attempt already exists, resumes that one instead of creating a duplicate.

start_quiz_attempt

Upload user-supplied files to a Kuliko subject (base64 bytes). This is the upload widget's data tool: the widget reads the file the user dropped in, base64-encodes the bytes in the browser, and calls this. You normally don't call it directly — use `upload_to_subject` to open the widget so the user can pick a file. Don't use this to save text *you* (the model) wrote — you can't faithfully base64-encode bytes by hand, and binary you generate (e.g. a PDF) lives outside your context. Use `create_document` for authored content; route real binary files through the widget. Hard caps (per file, enforced server-side): 5 MB on the free tier, 20 MB on Kuliko Pro. Oversized files are rejected with a clear error.

store_documents

Save the user's quiz answers in bulk. Called by the quiz widget on Save & Exit or when the user submits the quiz — matches the frontend pattern of persisting answers only on save, not on every selection.

submit_quiz_answers

Open a quiz inline. Read-only — shows whichever state the quiz is in: completed results, an in-progress attempt the user can resume, or a Start button when no attempt exists yet. Doesn't create or modify anything; the widget calls `start_quiz_attempt` when the user clicks Start.

take_quiz

Update an artifact's fields, or move it under a different document.

update_artifact

Replace the full text of a markdown or plain-text document. Overwrites the document's content in place (the previous text is lost). Only documents with a .md, .markdown, or .txt filename are editable — other types (PDF, DOCX, images, web pages) cannot be edited and will return an error. The update is synchronous: the stored file and semantic search already reflect the new content when this returns. Call get_document_text first to read the current content, then send the complete new body. Partial edits are not supported: whatever you pass fully replaces the document.

update_document

Update a flashcard's question or answer text, or move it under a different document.

update_flashcard

Update a mind map's title/tree, or move it under a different document.

update_mind_map

Update a note's fields, or move it under a different document.

update_note

Rename a share group. Group names must be non-empty and unique for the current user. Renaming a group does not change its members or any existing share rows.

update_share_group

Update a summary's fields, or move it under a different document.

update_summary

Open a drag-and-drop upload widget for a Kuliko subject. The widget collects a file from the user and uploads it via the `store_documents` tool. Call this whenever the user wants to add a new study material (PDF, notes, etc.) to one of their subjects. The widget includes a subject picker pre-loaded with the user's subjects, plus an inline "create new subject" option — so passing `subject_id` is optional. When provided, the picker is pre-filled with that subject and the user can still change it.

upload_to_subject

View a mind map as an interactive visual diagram. Shows the hierarchical structure of topics from a document as a zoomable, pannable graph powered by React Flow.

view_mind_map