Why am I seeing __models__ in my generated schema names?

This indicates a Pydantic naming collision. To fix it, ensure your model class names are unique across the entire project by prefixing them with their domain context, such as AgentHeader or EvaluatorParameter.

How do I add custom functionality to the generated SDK?

You can add custom Python modules to the overlay directory in lib/ark-sdk/gen_sdk/overlay/. These files are copied onto the generated code during the build process.

What is the ARK type pipeline?

It is a multi-step process: Kubernetes CRDs generate Python SDK types, which inform Pydantic models in the API. These models produce an OpenAPI spec used to generate TypeScript types for the dashboard.

When should I run make ark-api-build?

Run this command whenever you update Pydantic models or FastAPI routes to regenerate the openapi.json file required for dashboard type synchronization.

ARK SDK & Type Development

Name: ARK SDK & Type Development
Author: mckinsey

bymckinsey

•

305

Desarrollo de API

Manages the end-to-end type generation pipeline from Kubernetes CRDs to TypeScript for the ARK agentic framework.

Acerca de

This skill automates and debugs the multi-stage type synchronization process within the McKinsey ARK stack, ensuring consistency across Kubernetes CRDs, Python SDKs, FastAPI services, and TypeScript dashboards. It provides specialized guidance for resolving Pydantic model naming collisions, regenerating OpenAPI specifications, and implementing custom SDK functionality through Python overlays, making it an essential tool for developers building or maintaining agentic resources at scale.

Características Principales

OpenAPI specification generation from FastAPI/Pydantic models
Automated CRD-to-Python SDK type generation
TypeScript type synchronization for frontend dashboard integration
Conflict resolution for global Pydantic model naming collisions
SDK customization via Python overlay management
305 GitHub stars

Casos de Uso

Updating the dashboard when Kubernetes CRD schemas change
Exposing new agentic resource fields through the ARK API
Fixing 'Property does not exist on type' errors in TypeScript

Acerca de

Características Principales

OpenAPI specification generation from FastAPI/Pydantic models
Automated CRD-to-Python SDK type generation
TypeScript type synchronization for frontend dashboard integration
Conflict resolution for global Pydantic model naming collisions
SDK customization via Python overlay management
305 GitHub stars

Casos de Uso

Updating the dashboard when Kubernetes CRD schemas change
Exposing new agentic resource fields through the ARK API
Fixing 'Property does not exist on type' errors in TypeScript