lingomargin.andlukyane.chatgpt.site

{
  "name": "get_learning_context",
  "kind": "answer",
  "impl": "imperative",
  "description": "Read the learner's current passage, level, annotations, vocabulary status, grammar mission, review activities, and recent feedback. Use this before adapting the lesson.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  }
}

{
  "name": "create_generated_passage",
  "kind": "act",
  "impl": "imperative",
  "description": "Fulfill the learner's pending text-generation request. Compose a fresh passage at the requested language, level, topic, and length, then install it as the visible workspace with this tool.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "requestId": {
        "type": "string",
        "description": "The exact id from pendingGenerationRequest."
      },
      "title": {
        "type": "string"
      },
      "subtitle": {
        "type": "string",
        "description": "A short English gloss or framing subtitle."
      },
      "text": {
        "type": "string",
        "minLength": 80,
        "maxLength": 5000,
        "description": "The complete generated passage in the requested target language."
      }
    },
    "required": [
      "requestId",
      "title",
      "subtitle",
      "text"
    ],
    "additionalProperties": false
  }
}

{
  "name": "annotate_text",
  "kind": "act",
  "impl": "imperative",
  "description": "Add visible, anchored vocabulary, grammar, culture, or feedback notes to exact quotes in the current passage. Use selective annotations that match the learner's level.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "annotations": {
        "type": "array",
        "minItems": 1,
        "maxItems": 12,
        "items": {
          "type": "object",
          "properties": {
            "quote": {
              "type": "string",
              "description": "Exact text copied from the passage."
            },
            "kind": {
              "type": "string",
              "enum": [
                "vocabulary",
                "grammar",
                "culture",
                "feedback"
              ]
            },
            "explanation": {
              "type": "string"
            },
            "translation": {
              "type": "string"
            },
            "occurrence": {
              "type": "number",
              "description": "One-based occurrence when the quote appears more than once."
            }
          },
          "required": [
            "quote",
            "kind",
            "explanation"
          ],
          "additionalProperties": false
        }
      }
    },
    "required": [
      "annotations"
    ],
    "additionalProperties": false
  }
}

{
  "name": "create_grammar_mission",
  "kind": "act",
  "impl": "imperative",
  "description": "Create one visible Grammar Detective mission that asks the learner to find an exact phrase in the current passage. The target remains hidden until the learner attempts it.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "title": {
        "type": "string"
      },
      "prompt": {
        "type": "string"
      },
      "targetQuote": {
        "type": "string",
        "description": "Exact answer from the current passage."
      },
      "hint": {
        "type": "string"
      },
      "explanation": {
        "type": "string"
      }
    },
    "required": [
      "title",
      "prompt",
      "targetQuote",
      "hint",
      "explanation"
    ],
    "additionalProperties": false
  }
}

{
  "name": "create_activity",
  "kind": "act",
  "impl": "imperative",
  "description": "Create a visible contextual review activity from the learner's passage, annotations, mistakes, or saved vocabulary.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "type": {
        "type": "string",
        "enum": [
          "cloze",
          "multiple-choice",
          "free-response"
        ]
      },
      "prompt": {
        "type": "string"
      },
      "answer": {
        "type": "string"
      },
      "options": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "maxItems": 5
      },
      "explanation": {
        "type": "string"
      },
      "sourceTerms": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "maxItems": 8
      }
    },
    "required": [
      "type",
      "prompt",
      "answer",
      "explanation"
    ],
    "additionalProperties": false
  }
}

{
  "name": "add_feedback",
  "kind": "act",
  "impl": "imperative",
  "description": "Add visible, learner-facing feedback about an attempt or passage phrase. Use this for a concise correction, encouraging observation, or cultural insight.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "message": {
        "type": "string"
      },
      "tone": {
        "type": "string",
        "enum": [
          "encouraging",
          "correction",
          "insight"
        ]
      },
      "quote": {
        "type": "string",
        "description": "Optional exact phrase this feedback refers to."
      }
    },
    "required": [
      "message",
      "tone"
    ],
    "additionalProperties": false
  }
}