Back to Home
· product · apcore-toolkit
apcore-toolkit
Cross-language metadata pipeline for building apcore adapters
apcore-toolkit turns framework routes, convention-based functions, or complete OpenAPI 3.x documents into canonical ScannedModule values. It then provides schema and metadata refinement, display and AI enrichment, byte-equivalent presentation contracts, binding and code generation, and direct Registry or HTTP-proxy registration. Python, TypeScript, and Rust SDKs share the same core contracts while each adapter remains responsible for framework-specific discovery.
· 01
Features
01Canonical Module Model: Normalize discovered capabilities as ScannedModule values with schemas, annotations, metadata, and targets
02Framework-Agnostic Scanning: BaseScanner utilities for filtering, deduplication, documentation extraction, and behavioral inference
03OpenAPI 3.x Scanner: Turn a complete OpenAPI 3.0 or 3.1 document into one module per operation with byte-identical module IDs across SDKs
04Schema and Reference Utilities: Merge OpenAPI parameters, extract response schemas, resolve nested $ref values, and refine model-derived schemas
05Metadata Refinement: Apply display overlays and optional AI enhancement without coupling the toolkit to a specific framework
06Portable Presentation: Generate Markdown, Skill, JSON, CSV, JSONL, and a byte-equivalent TUI view model for downstream surfaces
07Artifacts and Runtime Registration: Write YAML bindings or language-native stubs, reload bindings, register modules directly, or proxy them over HTTP
08Cross-SDK Conformance: Python, TypeScript, and Rust implementations share normative fixtures for contracts that must remain byte-equivalent
· 02
Get Started
Python · Implementation
Python utilities for building apcore adapters (Pydantic, Django, Flask).
Install
$ pip install apcore-toolkitQuick Start
python.pyfrom apcore_toolkit import OpenAPIScanner, load_spec
# Scan an OpenAPI 3.0 or 3.1 document
spec = load_spec("openapi.json")
modules = OpenAPIScanner().scan(spec)
# Export modules with YAMLWriter, or register them with a writer· related
