waymark-sable.vercel.app

Last change

None yetUnchanged since first read.

Declared read-only

8 of 20

llms.txt

None

1. add_stepDoes not say

   Add a learning step (article, video, exercise, project, or quiz) to a path. Provide `why` — a one-sentence rationale shown to the user on the step card. URLs are validated server-side; dead links are rejected.

   First seen 12 Oct 2026. Unchanged since.

2. await_proposal_decisionReads only

   Wait (block) until the user accepts or declines a proposal in the page — call this right after propose_revision instead of polling. Accepted ops are already applied when this returns. Returns pending if the timeout passes first.

   First seen 12 Oct 2026. Unchanged since.

3. await_quiz_resultsReads only

   Wait (block) until the user submits a quiz in the page, then return their results — call this right after create_quiz instead of polling. Returns pending if the timeout passes first; you can call it again.

   First seen 12 Oct 2026. Unchanged since.

4. create_flashcardsDoes not say

   Attach a flashcard deck to a step for the USER to review in the page — front is the prompt, back is the answer. Good after the user finishes a concept-heavy step. Check retention later with get_review_stats.

   First seen 12 Oct 2026. Unchanged since.

5. create_pathDoes not say

   Create a new learning path for the user. Call this first when the user asks to learn a topic. Returns the path_id used by all other tools.

   First seen 12 Oct 2026. Unchanged since.

6. create_quizDoes not say

   Create a multiple-choice quiz attached to a step. The USER answers it in the page UI — do not answer it yourself. Set reveal: 'on_step_done' to author quizzes ahead of time — the page shows the quiz automatically when the user finishes the step. Give each question a `remedial` follow-up step; if the user misses that question, the page automatically proposes it (user approves) even with no agent pr

   First seen 12 Oct 2026. Unchanged since.

7. get_pathReads only

   Read the full current state of a learning path, including step order, statuses, locks, and user notes.

   First seen 12 Oct 2026. Unchanged since.

8. get_progressReads only

   Read a progress summary for a path: per-step statuses, notes, completion counts, remaining time, and days since last activity. watched_percent is measured from the embedded video player (reliable). engaged_minutes is time spent away after opening an external resource — a rough attention signal, not verified consumption. Call this on a return visit before suggesting what to do next.

   First seen 12 Oct 2026. Unchanged since.

9. get_proposal_statusReads only

   Check whether the user accepted or declined a proposal. Accepted ops are already applied — read the path with get_path afterwards. A declined proposal should be respected, not retried.

   First seen 12 Oct 2026. Unchanged since.

10. get_quiz_resultsReads only

    Read the user's answers to a quiz. Returns pending status until the user submits in the page. Use missed questions to adapt the path.

    First seen 12 Oct 2026. Unchanged since.

11. get_review_statsReads only

    Read the user's flashcard results for a deck: per-card seen/got-it counts and last result. Cards repeatedly marked 'again' signal concepts to reinforce with remedial steps or a quiz.

    First seen 12 Oct 2026. Unchanged since.

12. highlight_stepDoes not say

    Point the user at one step on the page: it scrolls into view with your short message attached. Use when telling the user where to pick up or what to look at — the message should say why.

    First seen 12 Oct 2026. Unchanged since.

13. list_pathsReads only

    List all of the user's learning paths. Call this on a return visit to re-orient yourself.

    First seen 12 Oct 2026. Unchanged since.

14. mark_stepDoes not say

    Update a step's progress status on the user's behalf, optionally attaching a note about their experience.

    First seen 12 Oct 2026. Unchanged since.

15. plan_weeksDoes not say

    Assign steps to calendar weeks (1-based) so the path fits the user's stated hours per week — each step shows its week badge in the UI. Provide an assignment for every step you want scheduled; steps omitted keep their current week.

    First seen 12 Oct 2026. Unchanged since.

16. propose_revisionDoes not say

    Propose a set of path changes for the USER to accept or decline in the page UI — use this instead of direct edits when a change is significant (inserting remedial steps after a failed quiz, restructuring a phase) or touches user-locked steps. The user's accept is their consent, so proposals MAY include locked steps. Poll get_proposal_status afterwards.

    First seen 12 Oct 2026. Unchanged since.

17. record_noteDoes not say

    Attach a note to a step on the user's behalf — their reaction to a resource, a confusion, a takeaway. Notes are shown on the step card and inform future adaptation.

    First seen 12 Oct 2026. Unchanged since.

18. remove_stepDoes not say

    Remove a step from a path. Fails if the user has locked the step — locked steps are under the user's control and must not be removed.

    First seen 12 Oct 2026. Unchanged since.

19. reorder_stepsDoes not say

    Reorder a path's steps. Provide the complete list of step ids in the new order. User-locked steps must stay at their current positions.

    First seen 12 Oct 2026. Unchanged since.

20. update_stepDoes not say

    Edit a step's title, resource URL, rationale, kind, or time estimate. Fails on user-locked steps.

    First seen 12 Oct 2026. Unchanged since.

Run this site? This page shows what your site told our crawler, ToolChronicleBot. To be left out, disallow it in robots.txt or write to hello@toolchronicle.com.