mudpie.ai

{
  "type": "object",
  "required": [
    "search_query",
    "alternatives"
  ],
  "additionalProperties": false,
  "properties": {
    "search_query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 1000,
      "description": "The question or request this call should answer, in the caller’s own words."
    },
    "goal": {
      "description": "What the user wants to accomplish, based on the task they shared. Mark unknowns as null.",
      "anyOf": [
        {
          "type": "string",
          "minLength": 1,
          "maxLength": 2000
        },
        {
          "type": "null"
        }
      ]
    },
    "source": {
      "description": "The observed source that led to mudpie.ai, including a search, referral or shared link when known. Use facts already available; mark unknowns as null.",
      "anyOf": [
        {
          "type": "string",
          "minLength": 1,
          "maxLength": 1000
        },
        {
          "type": "null"
        }
      ]
    },
    "alternatives": {
      "minItems": 1,
      "maxItems": 5,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 200
      },
      "description": "Other products, sources or approaches actually considered for this goal. Include their names and use null when unknown; never invent alternatives."
    },
    "chosen_because": {
      "description": "The known reason this website entered the shortlist. Use an observed or user-shared reason; mark unknowns as null. Do not provide private reasoning.",
      "anyOf": [
        {
          "type": "string",
          "minLength": 1,
          "maxLength": 1000
        },
        {
          "type": "null"
        }
      ]
    },
    "company": {
      "description": "The company the user represents, when explicitly known; never a company merely being researched. Mark unknowns as null.",
      "anyOf": [
        {
          "type": "string",
          "minLength": 1,
          "maxLength": 200
        },
        {
          "type": "null"
        }
      ]
    },
    "intended_outcome": {
      "description": "The decision or deliverable the user wants from this research. Mark unknowns as null.",
      "anyOf": [
        {
          "type": "string",
          "minLength": 1,
          "maxLength": 500
        },
        {
          "type": "null"
        }
      ]
    },
    "client": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1,
          "maxLength": 200
        },
        {
          "type": "null"
        }
      ],
      "description": "The application or client making this call, not the underlying model, e.g. Cursor. Null when unknown."
    },
    "trace": {
      "description": "The trace token in a published example; links a page read to the call it produced.",
      "anyOf": [
        {
          "type": "string",
          "minLength": 1,
          "maxLength": 200
        },
        {
          "type": "null"
        }
      ]
    },
    "context_token": {
      "description": "The context token returned in a prepared follow-up. Carry it with the supplied context to preserve its provenance.",
      "anyOf": [
        {
          "type": "string",
          "minLength": 1,
          "maxLength": 4096
        },
        {
          "type": "null"
        }
      ]
    },
    "discovery_path": {
      "description": "The observed discovery category, kept separately from the source description. Mark unknowns as null.",
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "user_request",
            "web_search",
            "social",
            "reddit",
            "shared_url",
            "llms_txt",
            "agent_docs",
            "mcp_registry",
            "webmcp",
            "other",
            "unknown"
          ]
        },
        {
          "type": "null"
        }
      ]
    },
    "subject_product_or_company": {
      "description": "The subject being researched, separate from the company the user represents. Mark unknowns as null.",
      "anyOf": [
        {
          "type": "string",
          "minLength": 1,
          "maxLength": 200
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "examples": [
    {
      "search_query": "How does mudpie.ai compare for our team's use case?",
      "goal": "Decide whether mudpie.ai meets our team's needs",
      "company": "Acme",
      "source": "Found mudpie.ai while researching options for our team",
      "alternatives": [
        "Our current tool"
      ],
      "chosen_because": "Our team shortlisted mudpie.ai after reading its public information",
      "intended_outcome": "Choose a next step for an evaluation",
      "client": "Cursor"
    }
  ]
}