Package

Generator Converters

The normalization layer where ontology and query semantics become SDK metadata; this is where semantic support tends to land before it becomes visible in higher layers.

package @osdk/generator-converters
first seen 2025-01
inspected version 2.8.0-beta.15
latest stable 2.7.5
status
public

Relevant code

Most revealing source snippet

published: build/esm/wireQueryTypeV2ToSdkQueryMetadata.js

packages/generator-converters/src/wireQueryTypeV2ToSdkQueryMetadata.ts

open source file ->
export function wireQueryTypeV2ToSdkQueryMetadata(input: QueryTypeV2): QueryMetadata {
	  return {
	    apiName: input.apiName,
	    version: input.version,
	    parameters: Object.fromEntries(...),
	    output: wireQueryDataTypeToQueryDataTypeDefinition(input.output),
	    rid: input.rid,
	  };
	}

Notes

Why it matters

This package is not the flashiest part of the stack, but it is essential to understanding how Palantir thinks about the compiler pipeline.

If Maker is the source language, generator converters are the normalization pass.

Watching this layer helps explain functional change, because it is where execution semantics become metadata that generators and discovery flows can consume.

The meaningful additions were not the most recent stable patch. They were changes like branch execution support, transaction IDs on queries, media query types, and interface-property metadata improvements. Those are exactly the kinds of semantics that later show up as “new SDK behavior.”

In other words, this package remains strategically important even when an individual patch release is mostly coordinated version alignment.