· 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. Its RFC 8628 Device Authorization Flow client adds a credential-acquisition surface — a deterministic polling state machine, TokenSet lifecycle, and pluggable TokenStore — protocol-only, with no terminal output of its own. 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

08Device Authorization Flow: RFC 8628 device-code grant with a deterministic polling state machine, TokenSet lifecycle, and a pluggable TokenStore — protocol only, the toolkit never writes to a terminal

09Cross-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).

View Repository PyPI Package

Install

$ pip install apcore-toolkit

Quick Start

python.py

from 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

apcore-toolkit

Features

Get Started

Related Products

apcore

apcore-mcp

apcore-a2a

apcore-cli