Nibomo

Returns the user's plan, monthly AI limits and this month's AI usage. null aiMonthlyMessages means uncapped, not zero; aiMonthlyWeightedTokens and remainingWeightedTokens are always null. The month is UTC and resets at usage.monthEndsAt.

get_usage_limits

Returns a Nibomo guide: study (explaining studying, nothing due), card_authoring (card rules, tags, duplicates, formatting, card links), bulk_authoring (large write jobs), review_flow (grading), sql_dialect (grammar, limits, examples).

get_guide

Lists the user's workspaces; isSelected marks the default used when workspaceId is omitted.

list_workspaces

Returns the next card to review (cardId, frontText, no answer) in app queue order: due cards reviewed within an hour, other due cards, then new. card:null: nothing due in that selection (all cards when unfiltered); tell nextDueAt in the learner's timezone (null: none scheduled), don't re-call, and offer adding cards or ungraded practice (get_guide(study)).

next_review_card

Creates, updates or deletes cards and decks with Nibomo SQL INSERT, UPDATE or DELETE, not full PostgreSQL; cannot write review_events or FSRS state. New cards: front_text is a recall prompt, never the answer; at least one tag. One call is an atomic batch of up to 50 semicolon-separated writes, 100 affected rows each. Arrays: ('a', 'b'), or () to clear; filter UPDATE and DELETE by tag with tags OVERLAP ('tag'); RETURNING col1, col2 returns affected rows. After saving cards, tell how many and where they are (one card: its link, get_guide(card_authoring); many: data.reviewUrl, the Review page), and offer to study them now. ok true with data.rowsOmitted or top-level truncated true: the write landed; never resend it, SELECT to check.

sql_execute

Read-only Nibomo SQL, not full PostgreSQL: SHOW TABLES, DESCRIBE, SHOW COLUMNS FROM and SELECT over workspace, cards, decks and review_events. A deck is a saved tag filter; cards have no deck_id. At most 100 rows per SELECT; paginate with ORDER BY, LIMIT, OFFSET; after data.rowsTruncated continue at OFFSET data.offset + data.rowCount. Run schema discovery in its own call. Grammar and examples: get_guide(sql_dialect).

sql_query

Returns a card's backText to compare with the learner's attempt; call it only after they answer. Changes nothing.

reveal_answer

Before the first grading in a conversation, read get_guide(review_flow) and follow it. Records the rating now and advances the card's authoritative FSRS schedule; returns the new schedule. Past reviews cannot be imported, and a saved review cannot be changed.

submit_review