haoku.app

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "heading",
        "paragraph",
        "callout",
        "diagram",
        "comparison",
        "image"
      ]
    },
    "content": {
      "type": "object",
      "description": "Shape depends on type; see the tool description."
    },
    "markdown": {
      "type": "string",
      "description": "Raw markdown for exactly one block, instead of type + content."
    },
    "position": {
      "description": "Where the block goes: \"end\" (default), \"start\", { \"after\": block_id }, { \"before\": block_id } or { \"in_section\": heading_block_id } for the end of that section.",
      "oneOf": [
        {
          "type": "string",
          "enum": [
            "end",
            "start"
          ]
        },
        {
          "type": "object",
          "properties": {
            "after": {
              "type": "string"
            }
          },
          "required": [
            "after"
          ]
        },
        {
          "type": "object",
          "properties": {
            "before": {
              "type": "string"
            }
          },
          "required": [
            "before"
          ]
        },
        {
          "type": "object",
          "properties": {
            "in_section": {
              "type": "string"
            }
          },
          "required": [
            "in_section"
          ]
        }
      ]
    },
    "citations": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "source": {
            "type": "string",
            "description": "A source by id (from list_sources) or by file name."
          },
          "page": {
            "type": "integer",
            "minimum": 1,
            "description": "Page number as printed, starting at 1. Text sources are a single page."
          },
          "quote": {
            "type": "string",
            "description": "A passage of the source, quoted from read_source or search_sources. Spacing, line breaks and hyphenation do not matter."
          },
          "occurrence": {
            "type": "integer",
            "minimum": 1,
            "description": "Which occurrence when the quote repeats on the page. Defaults to 1."
          }
        },
        "required": [
          "source"
        ],
        "description": "Where a piece of content comes from. Give page and quote for PDFs and text; an image is cited by source alone."
      },
      "description": "Passages this block draws on, in the order the [n] marks refer to. A passage another block already cites is refused: each one backs a single block."
    },
    "use_collected": {
      "type": "boolean",
      "description": "Defaults to true: the block cites the passages the user gathered in the context and has not used yet (get_selection → gathered, the ones with free: true), before any listed here, and the basket is emptied. Pass false when the block has nothing to do with them."
    }
  }
}