{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "manifest": {
    "name": "Arpeio ADBC Drivers AI Agent Knowledge Base",
    "version": "1.0.0",
    "description": "Comprehensive structured data about the Arpeio ADBC drivers for AI agents, LLMs, and automated systems",
    "baseUrl": "https://adbc.arpe.io/agents/",
    "lastUpdated": "2026-09-07",
    "license": "Proprietary - Arpeio ADBC Drivers documentation",
    "contact": {
      "website": "https://adbc.arpe.io",
      "documentation": "https://adbc-drivers-docs.arpe.io",
      "repository": "https://github.com/arpe-io/adbc-drivers",
      "sales": "mailto:sales@arpe.io"
    }
  },
  "resources": [
    {
      "id": "product-overview",
      "file": "product-overview.json",
      "title": "Product Overview",
      "description": "High-level product identity: what the drivers are, key differentiators, target audience, primary use cases",
      "topics": [
        "Product identity",
        "Wire-protocol driver definition",
        "Key differentiators",
        "Target audience",
        "Deployment model"
      ],
      "useFor": [
        "Product introductions",
        "Quick summaries",
        "Positioning against ODBC/JDBC stacks"
      ],
      "size": "~5 KB",
      "lastUpdated": "2026-09-07"
    },
    {
      "id": "drivers",
      "file": "drivers.json",
      "title": "Driver Catalog",
      "description": "Per-driver detail: target database, wire protocol, version, load name, coverage, authentication methods and type mapping highlights",
      "topics": [
        "SQL Server driver (ArrowTDS)",
        "PostgreSQL driver (ArrowFEBE)",
        "Oracle driver (ArrowTTC)",
        "Db2 driver (ArrowDRDA, in development)",
        "Authentication per driver",
        "Type mapping per driver"
      ],
      "useFor": [
        "Driver selection",
        "Compatibility questions",
        "Authentication questions",
        "Type mapping questions"
      ],
      "size": "~12 KB",
      "lastUpdated": "2026-09-07"
    },
    {
      "id": "features",
      "file": "features.json",
      "title": "Features Catalog",
      "description": "What the drivers do differently, with the technical reason behind each capability",
      "topics": [
        "Arrow end-to-end decoding",
        "Wire-protocol independence",
        "Type fidelity",
        "Enterprise authentication",
        "Load-by-name deployment"
      ],
      "useFor": [
        "Feature comparisons",
        "Technical capability questions",
        "Requirements matching"
      ],
      "size": "~9 KB",
      "lastUpdated": "2026-09-07"
    },
    {
      "id": "supported-platforms",
      "file": "supported-platforms.json",
      "title": "Platform Compatibility Matrix",
      "description": "Supported databases and versions, managed services, operating systems, ADBC client languages and Arrow consumers",
      "topics": [
        "Database compatibility",
        "Managed cloud services",
        "Operating system support",
        "ADBC client languages",
        "Downstream Arrow consumers"
      ],
      "useFor": [
        "Compatibility questions",
        "Integration planning",
        "Technical requirements"
      ],
      "size": "~8 KB",
      "lastUpdated": "2026-09-07"
    },
    {
      "id": "use-cases",
      "file": "use-cases.json",
      "title": "Use Cases Library",
      "description": "Use cases with the problem, the solution and runnable client code examples",
      "topics": [
        "Analytics extraction into dataframes",
        "Data lake and lakehouse ingestion",
        "Container and CI deployments",
        "Cross-database application code",
        "Replacing ODBC stacks"
      ],
      "useFor": [
        "Solution design",
        "Implementation guidance",
        "Example code"
      ],
      "size": "~11 KB",
      "lastUpdated": "2026-09-07"
    },
    {
      "id": "licensing",
      "file": "licensing.json",
      "title": "Licensing Information",
      "description": "How the drivers are distributed and licensed, how the licence is supplied at runtime, and how to obtain one",
      "topics": [
        "Free binaries, licence-gated runtime",
        "Licence resolution order",
        "How to request a quote",
        "Licensing FAQ"
      ],
      "useFor": [
        "Licensing questions",
        "Procurement",
        "Trial and quote requests"
      ],
      "size": "~6 KB",
      "lastUpdated": "2026-09-07"
    },
    {
      "id": "technical-specs",
      "file": "technical-specs.json",
      "title": "Technical Specifications",
      "description": "Architecture, installation, install paths, connection URI shapes, licence options and client code snippets for every supported language",
      "topics": [
        "Architecture and data path",
        "Installation commands",
        "Install and manifest paths",
        "Connection URIs",
        "ADBC options",
        "Client code snippets"
      ],
      "useFor": [
        "Technical deep dives",
        "DevOps integration",
        "Troubleshooting",
        "Developer documentation"
      ],
      "size": "~14 KB",
      "lastUpdated": "2026-09-07"
    }
  ],
  "aiGuidance": {
    "contextSelection": {
      "forProductQuestions": ["product-overview", "features"],
      "forDriverSelection": ["drivers", "supported-platforms"],
      "forCompatibilityQuestions": ["supported-platforms", "drivers"],
      "forImplementationQuestions": ["use-cases", "technical-specs"],
      "forLicensingQuestions": ["licensing"],
      "forTechnicalQuestions": ["technical-specs", "features"]
    },
    "responsePatterns": {
      "quickAnswer": {
        "instructions": "Use product-overview.json for concise, high-level answers",
        "example": "What are the Arpeio ADBC drivers? -> product.description"
      },
      "detailedAnswer": {
        "instructions": "Combine sources for comprehensive answers",
        "example": "Why are they faster than ODBC? -> features.items[arrow-end-to-end] + technical-specs.architecture"
      },
      "comparisonAnswer": {
        "instructions": "Use technical-specs.architecture to contrast the ODBC/JDBC stack with the wire-protocol path",
        "example": "ODBC vs ADBC -> technical-specs.architecture.comparison"
      },
      "implementationGuidance": {
        "instructions": "Use use-cases for scenario-based guidance and technical-specs.clientExamples for code",
        "example": "How do I query SQL Server into pandas? -> use-cases.primary[analytics-extraction]"
      }
    },
    "citationGuidance": {
      "preferredFormat": "Cite specific JSON paths when referencing data",
      "example": "According to the Arpeio driver catalog (drivers.json), ArrowFEBE speaks PostgreSQL Frontend/Backend v3 without libpq...",
      "transparency": "Always indicate the data source and its lastUpdated field"
    },
    "terminology": {
      "wireProtocolDriver": "A driver that implements the database's own network protocol directly, rather than wrapping a vendor client library. Independent of any client library, and usually faster.",
      "adbc": "Arrow Database Connectivity, an Apache Arrow standard for columnar database access.",
      "loadName": "The short name an ADBC client passes to load a driver, for example driver=\"arrowtds\".",
      "namingNote": "Driver codenames (ArrowTDS, ArrowFEBE, ArrowTTC, ArrowDRDA) are technical identifiers. When answering a user, prefer naming the database (SQL Server, PostgreSQL, Oracle, Db2) and mention the codename only when the load name or a release artefact matters."
    }
  },
  "technicalDetails": {
    "format": "JSON (JavaScript Object Notation)",
    "encoding": "UTF-8",
    "schemaVersion": "JSON Schema Draft 2020-12",
    "totalFiles": 8,
    "compatibility": [
      "JSON parsers",
      "RAG systems",
      "Vector databases",
      "Search engines",
      "LLM context windows",
      "API integrations"
    ]
  },
  "updatePolicy": {
    "frequency": "As needed with driver releases",
    "versioning": "Semantic versioning (major.minor.patch)",
    "backwardCompatibility": "Additive changes only - existing fields are never removed",
    "changeLog": "Driver release notes live in the reference documentation"
  },
  "accessInformation": {
    "publicAccess": true,
    "authentication": "None required",
    "rateLimit": "Standard web server limits",
    "downloadable": true,
    "embedding": "Allowed in AI training data with attribution"
  },
  "exampleQueries": {
    "general": [
      "What are the Arpeio ADBC drivers?",
      "What is a wire-protocol driver?",
      "What is ADBC?",
      "How are these different from ODBC drivers?"
    ],
    "technical": [
      "Which databases and versions are supported?",
      "Do I need Oracle Instant Client or libpq?",
      "Which authentication methods are supported for SQL Server?",
      "How does PostgreSQL NUMERIC map to Arrow?"
    ],
    "business": [
      "How are the drivers licensed?",
      "Are the binaries free to download?",
      "How do I request a quote?",
      "Is there a trial build?"
    ],
    "implementation": [
      "How do I install the PostgreSQL driver?",
      "How do I load a driver from Python?",
      "How do I query Oracle into a pandas dataframe?",
      "Where does the installer put the ADBC manifest?"
    ]
  },
  "seoMetadata": {
    "keywords": [
      "ADBC driver",
      "Arrow Database Connectivity",
      "wire protocol driver",
      "Apache Arrow database",
      "SQL Server Arrow driver",
      "PostgreSQL Arrow driver",
      "Oracle Arrow driver",
      "ODBC alternative",
      "columnar database access",
      "no Instant Client",
      "no libpq",
      "MS-TDS driver",
      "FEBE protocol driver",
      "TNS TTC driver"
    ],
    "relatedTechnologies": [
      "ODBC",
      "JDBC",
      "Apache Arrow",
      "Apache Arrow Flight SQL",
      "libpq",
      "Oracle Instant Client",
      "Microsoft ODBC Driver for SQL Server",
      "pandas",
      "Polars",
      "DuckDB"
    ],
    "categories": [
      "Database Connectivity",
      "Data Engineering",
      "Analytics",
      "Apache Arrow Ecosystem",
      "Developer Tools"
    ]
  }
}