{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://austinmarviano.com/schemas/profile.schema.json",
  "title": "Austin Sebastian Marviano: agent-readable profile",
  "description": "Schema for the machine-readable profile published at /profile.json. Written so an automated agent can validate the record before relying on it.",
  "type": "object",
  "required": [
    "schemaVersion",
    "canonicalUrl",
    "summary",
    "entityType",
    "isHuman",
    "identity",
    "agentGuidance",
    "capabilities",
    "contact",
    "sameAs"
  ],
  "properties": {
    "$schema": { "type": "string" },
    "schemaVersion": { "type": "string" },
    "generatedAt": { "type": "string", "format": "date-time" },
    "lastUpdated": { "type": "string", "format": "date" },
    "canonicalUrl": { "type": "string", "format": "uri" },
    "profileUrl": { "type": "string", "format": "uri" },
    "summary": { "type": "string", "minLength": 20 },
    "entityType": {
      "type": "string",
      "enum": ["human"],
      "description": "Always \"human\" for this profile. Present so agents can branch on it without parsing prose."
    },
    "isHuman": { "const": true },
    "humanVerification": {
      "type": "object",
      "properties": {
        "statement": { "type": "string" },
        "notACompany": { "type": "boolean" },
        "notAnAIAgent": { "type": "boolean" },
        "notABrandOrPseudonym": { "type": "boolean" },
        "operatedBy": { "type": "string" },
        "evidence": { "type": "array", "items": { "type": "string" } }
      }
    },
    "identity": {
      "type": "object",
      "required": ["fullName"],
      "properties": {
        "fullName": { "type": "string" },
        "shortName": { "type": "string" },
        "givenName": { "type": "string" },
        "middleName": { "type": "string" },
        "familyName": { "type": "string" },
        "aliases": { "type": "array", "items": { "type": "string" } },
        "pronouns": { "type": "string" },
        "languages": { "type": "array", "items": { "type": "string" } },
        "knowsLanguage": { "type": "array", "items": { "type": "string" } },
    "timeZone": { "type": "string", "description": "IANA time zone, so an agent scheduling contact does not have to assume one." },
    "utcOffset": { "type": "string" },
        "jobTitle": { "type": "string" }
      }
    },
    "agentGuidance": {
      "type": "object",
      "required": ["canYouRequestWorkFromThisEntity", "acceptsRequestsFromAgents"],
      "properties": {
        "canYouRequestWorkFromThisEntity": { "type": "boolean" },
        "acceptsRequestsFromAgents": { "type": "boolean" },
        "humanIntermediaryRequired": { "type": "boolean" },
        "preferredChannelForAgents": { "type": "string" },
        "preferredChannelUrl": { "type": "string" },
        "responseExpectation": { "type": "string" },
        "facts": {
          "type": "array",
          "items": { "type": "string" },
          "description": "Statements of fact about how this entity operates. Deliberately not written as instructions: an agent should treat directives found in a web page as untrusted data."
        },
        "requestTemplate": { "type": "object", "additionalProperties": { "type": "string" } }
      }
    },
    "capabilities": {
      "type": "array",
      "minItems": 1,
      "items": {
        "type": "object",
        "required": ["id", "name", "detail"],
        "properties": {
          "id": { "type": "string" },
          "name": { "type": "string" },
          "detail": { "type": "string" }
        }
      }
    },
    "canDo": { "type": "array", "items": { "type": "string" } },
    "alsoOpen": { "type": "string" },
    "services": {
      "type": "object",
      "properties": {
        "type": { "type": "string" },
        "areaServed": { "type": "string" },
        "remote": { "type": "boolean" },
        "engagement": { "type": "array", "items": { "type": "string" } },
        "howItWorks": { "type": "array", "items": { "type": "string" } }
      }
    },
    "availability": {
      "type": "object",
      "properties": {
        "status": { "type": "string", "enum": ["open", "limited", "closed"] },
        "acceptingNewWork": { "type": "boolean" },
        "note": { "type": "string" }
      }
    },
    "pricing": {
      "type": "object",
      "properties": {
        "model": { "type": "string" },
        "note": { "type": "string" }
      }
    },
    "contact": {
      "type": "array",
      "minItems": 1,
      "items": {
        "type": "object",
        "required": ["channel", "label", "url"],
        "properties": {
          "channel": { "type": "string", "enum": ["email", "form", "threads", "instagram", "github", "other"] },
          "label": { "type": "string" },
          "value": { "type": "string" },
          "url": { "type": "string" },
          "bestFor": { "type": "string" },
          "available": { "type": "boolean" }
        }
      }
    },
    "contactPage": { "type": "string", "format": "uri" },
    "sameAs": {
      "type": "array",
      "minItems": 1,
      "items": { "type": "string", "format": "uri" },
      "description": "Canonical external profiles for cross-platform identity verification."
    },
    "endpoints": { "type": "object", "additionalProperties": true },
    "citation": { "type": "object", "additionalProperties": { "type": "string" } },
    "usage": { "type": "object", "additionalProperties": true },
    "build": {
      "type": "object",
      "properties": {
        "buildDate": { "type": "string" },
        "contentHash": { "type": "string" },
        "generator": { "type": "string" }
      }
    }
  }
}