{
    "schema_version": "1.0",
    "protocolVersion": "0.2",
    "name": "BlackOrder Catalog",
    "description": "Official machine-readable catalog of BlackOrder: macOS applications (versions, requirements, official pages, privacy facts) and the articles of The Dark Codex. Read-only, public, generated from the publisher's own data.",
    "url": "https://blackorder.io/api/agent/",
    "provider": {
        "organization": "BlackOrder",
        "url": "https://blackorder.io/"
    },
    "version": "2026.09.10",
    "documentationUrl": "https://blackorder.io/agents",
    "iconUrl": "https://blackorder.io/blog/img/onrecord-icon.png",
    "preferredTransport": "HTTP+JSON",
    "additionalInterfaces": [
        {
            "url": "https://blackorder.io/.well-known/agent.json",
            "transport": "HTTP+JSON",
            "description": "Discovery document with the full catalog"
        },
        {
            "url": "https://blackorder.io/.well-known/ai-catalog.json",
            "transport": "HTTP+JSON",
            "description": "Catalog only (apps and articles)"
        },
        {
            "url": "https://blackorder.io/llms.txt",
            "transport": "text/plain",
            "description": "Plain-text summary for language models"
        }
    ],
    "capabilities": {
        "streaming": false,
        "pushNotifications": false,
        "stateTransitionHistory": false
    },
    "authentication": {
        "schemes": []
    },
    "securitySchemes": {},
    "defaultInputModes": [
        "text/plain"
    ],
    "defaultOutputModes": [
        "application/json"
    ],
    "skills": [
        {
            "id": "search_apps",
            "name": "Search apps and articles",
            "description": "Ranked search over BlackOrder apps and articles with filters (type, category, platform, free, language, tag).",
            "tags": [
                "search",
                "catalog",
                "macOS"
            ],
            "examples": [
                "free professional audio editor for macOS",
                "coding agent workspace for Mac",
                "articles about privacy"
            ],
            "inputModes": [
                "text/plain"
            ],
            "outputModes": [
                "application/json"
            ],
            "endpoint": "https://blackorder.io/api/agent/search?q={query}"
        },
        {
            "id": "get_app_details",
            "name": "Get app details",
            "description": "Full record of one app: description, version, requirements, capabilities, privacy, official page.",
            "tags": [
                "apps"
            ],
            "examples": [
                "details of PeakLab"
            ],
            "endpoint": "https://blackorder.io/api/agent/apps/{slug}"
        },
        {
            "id": "get_article",
            "name": "Get article",
            "description": "One article of The Dark Codex with its canonical URL in English and Italian.",
            "tags": [
                "articles",
                "blog"
            ],
            "endpoint": "https://blackorder.io/api/agent/articles/{slug}"
        },
        {
            "id": "check_compatibility",
            "name": "Check compatibility",
            "description": "Whether an app runs on a given macOS version and CPU architecture.",
            "tags": [
                "compatibility",
                "macOS"
            ],
            "examples": [
                "does PeakLab run on macOS 14.5 arm64"
            ],
            "endpoint": "https://blackorder.io/api/agent/compatibility?app={slug}&os={version}&arch={arch}"
        },
        {
            "id": "get_latest_version",
            "name": "Get latest version",
            "description": "Current version, build and release notes of an app distributed through the signed update channel.",
            "tags": [
                "releases"
            ],
            "endpoint": "https://blackorder.io/api/agent/apps/{slug}"
        },
        {
            "id": "get_official_download_page",
            "name": "Get official download page",
            "description": "The official BlackOrder page (or Mac App Store page) where a person downloads the app. The API never serves files.",
            "tags": [
                "download"
            ],
            "endpoint": "https://blackorder.io/api/agent/apps/{slug}"
        }
    ],
    "publisher": "BlackOrder",
    "canonical_domain": "blackorder.io",
    "source": "official",
    "generated_at": "2026-09-10T12:55:17+00:00",
    "content_updated_at": "2026-09-10T12:54:24+00:00",
    "counts": {
        "apps": 20,
        "articles": 8
    }
}