{
    "id": "read_site_page",
    "name": "Read an official public page",
    "description": "Read the current published text of a page by its slug from search_site. Includes content date, hash, headings and truncation flag. No arbitrary URL fetching.",
    "version": "2.1.0",
    "effect": "read",
    "generated": false,
    "endpoint": "https://blackorder.io/api/agent/tools/read_site_page",
    "method": "POST",
    "mcp": {
        "url": "https://blackorder.io/mcp",
        "tool": "read_site_page"
    },
    "inputSchema": {
        "type": "object",
        "properties": {
            "slug": {
                "type": "string",
                "pattern": "^[a-z0-9-]+$",
                "maxLength": 160
            },
            "language": {
                "type": "string",
                "enum": [
                    "en",
                    "it"
                ],
                "default": "en"
            }
        },
        "required": [
            "slug"
        ],
        "additionalProperties": false
    },
    "outputSchema": {
        "type": "object",
        "required": [
            "page"
        ],
        "properties": {
            "page": {
                "type": "object",
                "properties": {
                    "canonical_url": {
                        "type": "string",
                        "format": "uri"
                    },
                    "official_page_url": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "title": {
                        "type": "string"
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "version": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "minimum_os": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "architecture": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "type": "string"
                        }
                    },
                    "price": {
                        "type": [
                            "number",
                            "null"
                        ]
                    },
                    "currency": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "is_free": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    },
                    "signed": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    },
                    "notarized": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    },
                    "facts": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "object",
                            "required": [
                                "value",
                                "source",
                                "verified_at",
                                "freshness",
                                "confidence",
                                "type"
                            ],
                            "properties": {
                                "value": {},
                                "source": {
                                    "type": "object",
                                    "required": [
                                        "url",
                                        "publisher",
                                        "type"
                                    ],
                                    "properties": {
                                        "url": {
                                            "type": "string",
                                            "format": "uri"
                                        },
                                        "publisher": {
                                            "type": "string"
                                        },
                                        "type": {
                                            "type": "string"
                                        }
                                    }
                                },
                                "verified_at": {
                                    "type": "null"
                                },
                                "freshness": {
                                    "type": "object",
                                    "properties": {
                                        "retrieved_at": {
                                            "type": "string",
                                            "format": "date-time"
                                        },
                                        "max_age_seconds": {
                                            "type": "integer"
                                        }
                                    }
                                },
                                "confidence": {
                                    "enum": [
                                        "publisher_declared",
                                        "unknown"
                                    ]
                                },
                                "type": {
                                    "const": "publisher_statement"
                                },
                                "verification_scope": {
                                    "type": "string"
                                }
                            }
                        }
                    }
                },
                "additionalProperties": true
            }
        },
        "additionalProperties": true
    },
    "examples": [
        {
            "input": {
                "slug": "studio",
                "language": "it"
            },
            "expected": "Current public Studio page or explicit not-found error."
        }
    ],
    "fallback": {
        "url": "https://blackorder.io/agents/catalog",
        "text": "https://blackorder.io/llms-full.txt",
        "limitations": "Publisher catalog; automatic compatibility evaluation requires REST or MCP."
    }
}