bookhand.dev

{
  "name": "get_design_context",
  "kind": "answer",
  "impl": "imperative",
  "description": "Read Bookhand’s composition guidance and the current state of its surfaces before changing how anything looks or building study material. Returns the semantic roles, accessibility floors, what each change can and cannot reach, and the reversal actions the person has. Read-only: it changes nothing and stores nothing.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "surface": {
        "type": "string",
        "enum": [
          "library",
          "reader",
          "study"
        ],
        "description": "Which surface you are about to work on. Defaults to whichever is on screen."
      }
    },
    "additionalProperties": false
  }
}

{
  "name": "list_books",
  "kind": "answer",
  "impl": "imperative",
  "description": "List the books in this person's local library, with how far through each one they are. Use this to find the book to open before reading anything.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  }
}

{
  "name": "open_book",
  "kind": "transact",
  "impl": "imperative",
  "description": "Open one book so its reading tools become available. Supply exactly ONE selector: bookId from list_books OR a distinctive title fragment. Omit the other field entirely, not an empty placeholder or null. Minimal JSON: {\"title\":\"Calculus\"}. An ambiguous title opens nothing and returns bounded candidates; select a returned bookId instead of guessing.",
  "inputSchema": {
    "type": "object",
    "oneOf": [
      {
        "required": [
          "bookId"
        ],
        "not": {
          "required": [
            "title"
          ]
        }
      },
      {
        "required": [
          "title"
        ],
        "not": {
          "required": [
            "bookId"
          ]
        }
      }
    ],
    "properties": {
      "bookId": {
        "type": "string",
        "description": "An id returned by list_books."
      },
      "title": {
        "type": "string",
        "description": "Part of the title, matched case-insensitively."
      }
    },
    "additionalProperties": false
  }
}