dinkster-api 0.0.2__py3-none-any.whl

dinkster_api/v1.py

@@ -0,0 +1,935 @@
+"""dinkster_api.v1 - the frozen extension surface, version 1.
+
+THE door for pack authors: everything a pack needs to author nodes,
+register value types and codecs, declare memory policy, and extend the
+asset system, re-exported from the internal packages in one place.
+
+The compat promise (DESIGN 3.6, enforced by tests/test_api_v1.py):
+
+- Within v1 supported extension contracts grow compatibly; breaking changes
+  require a ``v2`` module next to this one. Training-origin nodes and their
+  exclusive value identifiers are excluded from this supported surface.
+- Every name below is the internal object itself, not a wrapper - zero
+  overhead, and ``isinstance``/identity checks agree across the door.
+- Internal modules stay reachable (this is Python) but carry no promise:
+  a pack that imports them works until it doesn't, visibly, in dev
+  (isolation-by-default makes that breakage loud - DESIGN 3.6).
+
+Grouped by concern:
+
+- *Extension declarations*: scope-separated entry-point metadata, closed
+  composition modes, and immutable behavior snapshots/sha256 identity. These
+  are RPC-clean data contracts; runtime activation and enforcement are host
+  responsibilities.
+- *Node authoring*: subclass ``Node``, return ``define_schema()`` built
+  from the spec dataclasses, implement ``execute()`` over plain Python
+  values. Envelopes, workers, and caching stay invisible (hazard H9).
+- *Reporting*: ``report_progress``/``report_preview``/``report_log``/
+  ``report_event`` from inside ``execute()`` - the worker shim routes them;
+  no server or engine import needed.
+- *Logging*: ``pack_logger("mypack")`` returns a stdlib logger named
+  ``dinkster.pack.mypack`` - origin-tagged, host-controlled verbosity.
+  Logs are for humans; anything a frontend renders goes through
+  ``report_*``. Packs never install handlers or configure output.
+- *Value types and codecs*: register pack types in the ``TypeRegistry``
+  with a ``TypeSpec`` (codec, fingerprint, meta). Resource-backed types
+  (models that live in a worker) go through ``ResourceHandle``.
+- *Memory policy*: a ``ReservationPlanner`` declares what invocations
+  materialize; ``Shedder``/``ConsumerItem`` surface a pack's governed
+  memory consumers to the host governor.
+- *Assets*: ``AssetRef`` inputs resolve through the host's catalog;
+  packs may register custom ``AssetResolver`` implementations.
+  ``declared_asset("id")`` resolves the pack's own ``[[pack.assets]]``
+  declaration to a readable ref - acquired-or-loud-error, never a
+  download during execution.
+- *Golden-file testing*: ``schema_to_wire`` encodes a ``NodeSchema`` to
+  its wire form (the exact shape ``/api/nodes`` serves, self-describing
+  via ``schemaVersion``) so pack tests can pin schemas against committed
+  JSON without importing host machinery.
+"""
+
+from __future__ import annotations
+
+from importlib import import_module
+from typing import TYPE_CHECKING
+
+from dinkster_assets import (
+    ASSET_TYPE,
+    SAVE_TARGET_TYPE,
+    AssetEntry,
+    AssetError,
+    AssetIntegrityError,
+    AssetRef,
+    AssetResolver,
+    AssetVault,
+    AssetWriter,
+    FolderListing,
+    IndexedAssetResolver,
+    LocalAssetRef,
+    MountSnapshotWriter,
+    SaveTarget,
+    admit_video_source,
+    asset_selection_names,
+    asset_selection_options,
+    bind_video_value,
+    declared_asset,
+    digest_bytes,
+    digest_file,
+    is_digest,
+    mount_roots_for_kind,
+    register_asset_type,
+    register_audio_value_type,
+    register_save_target_type,
+    register_video_value_type,
+    resolve_asset_selection,
+    resolver_from_env,
+)
+from dinkster_memory import (
+    ConsumerItem,
+    FullReleaseResult,
+    InvocationView,
+    MeasuredMemory,
+    PressureSignal,
+    ReleaseCandidate,
+    ReservationPlanner,
+    ReservationRequest,
+    Shedder,
+)
+from dinkster_memory.resident import obtain_resident
+from dinkster_protocol import (
+    EXTENSION_CAPABILITIES,
+    EXTENSION_SCOPES,
+    ActiveExtension,
+    BehaviorValue,
+    CompositionMode,
+    ContributionSurfaceDescriptor,
+    ExportSnapshot,
+    ExtensionDeclaration,
+    ExtensionEntryPoints,
+    ExtensionScope,
+    ExtensionSnapshot,
+    GuidancePhase,
+    GuidancePhaseParticipation,
+    GuidanceRegistrySnapshot,
+    TrainingSessionHandle,
+    canonical_extension_snapshot,
+    current_export_snapshot,
+    extension_behavior_hash,
+    prepare_sampling_model,
+)
+from dinkster_protocol.frontend_modules import FrontendContribution, FrontendModule
+from dinkster_protocol.pack_surfaces import (
+    JsonField,
+    JsonObjectSchema,
+    PackEvent,
+    PackRoute,
+    report_pack_event,
+)
+from dinkster_schema import (
+    ABSENT,
+    BLOCKED,
+    LOG_EVENT,
+    PREVIEW_EVENT,
+    PROGRESS_EVENT,
+    SCHEMA_WIRE_VERSION,
+    AbsentOutput,
+    AbsentPolicy,
+    AssetWidget,
+    BooleanWidget,
+    ColorWidget,
+    ComboOption,
+    ComboWidget,
+    CompositorWidget,
+    ConditionalWidgetCondition,
+    ConditionalWidgetGroup,
+    ControlAfterGenerate,
+    CurveWidget,
+    Deprecation,
+    DynamicComboOption,
+    DynamicComboSpec,
+    DynamicSlotSpec,
+    Expansion,
+    ExpansionBuilder,
+    ExpansionNode,
+    ExpansionOutput,
+    InputFamilyMapping,
+    InputFamilyMember,
+    InputFamilyOptionSource,
+    InputFamilySpec,
+    InputSpec,
+    MappingSource,
+    MirrorSpec,
+    MirrorTolerance,
+    MountWidget,
+    MultiComboWidget,
+    Node,
+    NodeOutputError,
+    NodeSchema,
+    NumberWidget,
+    OutputCountSpec,
+    OutputDescriptorsSpec,
+    OutputFamilyMapping,
+    OutputFamilyMember,
+    OutputFamilySpec,
+    OutputInterface,
+    OutputKnownValue,
+    OutputProbeSpec,
+    OutputRepresents,
+    OutputSpec,
+    ReplacementCase,
+    ReplacementLink,
+    ReplacementMigration,
+    ReplacementNode,
+    ReplacementPredicate,
+    ReplacementRule,
+    RunExecutionContext,
+    SaveTargetWidget,
+    SearchVisibility,
+    SelectorSpec,
+    SlotValue,
+    SlotVariant,
+    SourceFilenameSpec,
+    StringWidget,
+    TextCompletionItem,
+    TextCompletionKind,
+    TextCompletions,
+    TypeExpr,
+    ValueTransform,
+    WidgetRepresentation,
+    WidgetRepresentations,
+    attach_saved_artifact,
+    output_descriptor_entries,
+    pack_logger,
+    publish_preview_artifact,
+    publish_saved_file_preview,
+    report_event,
+    report_log,
+    report_preview,
+    report_progress,
+    report_value_diagnostic,
+    schema_from_wire,
+    schema_signature,
+    schema_to_wire,
+)
+from dinkster_values import (
+    ARRAY_TYPE,
+    AUDIO_ENCODER_OUTPUT_TYPE,
+    AUDIO_ENCODER_TYPE,
+    AUDIO_RECORD_TYPE,
+    AUDIO_TYPE,
+    BACKGROUND_REMOVAL_TYPE,
+    BOUNDING_BOX_TYPE,
+    BOUNDING_BOXES_TYPE,
+    CAMERA_INFO_STATE_TYPE,
+    CLIP_TYPE,
+    CLIP_VISION_OUTPUT_TYPE,
+    CLIP_VISION_TYPE,
+    COLOR_TYPE,
+    COLORS_TYPE,
+    COMFY_ARRAY_TYPE,
+    COMPOSITOR_TYPE,
+    CONDITIONING_TYPE,
+    CONTEXT_WINDOWS_TYPE,
+    CONTROL_NET_TYPE,
+    CORE_BOOLEAN,
+    CORE_COMBO,
+    CORE_FLOAT,
+    CORE_INT,
+    CORE_STRING,
+    COST_META_KEY,
+    CURVE_TYPE,
+    DETECTION_TYPE,
+    DICT_TYPE,
+    ENCODED_MEDIA_LIMIT_BYTES,
+    FLOATS_TYPE,
+    GIBIBYTE,
+    GLIGEN_TYPE,
+    GUIDER_TYPE,
+    HISTOGRAM_TYPE,
+    HOOK_KEYFRAMES_TYPE,
+    HOOKS_TYPE,
+    IC_LORA_PARAMETERS_TYPE,
+    IMAGE_BATCH_MERGER_ID,
+    IMAGE_DOCUMENT_TYPE,
+    IMAGE_TYPE,
+    IMAGE_WORKING_SET_LIMIT_BYTES,
+    IMAGECOMPARE_TYPE,
+    IMPACT_BASIC_PIPE_TYPE,
+    INFERENCE_LATENT_OPERATION_TYPE,
+    INLINE_STRING_CAP,
+    INPAINT_CONDITIONING_TYPE,
+    INTERP_MODEL_TYPE,
+    LATENT_OPERATION_TYPE,
+    LATENT_TYPE,
+    LATENT_UPSCALE_MODEL_TYPE,
+    LAYERS_TYPE,
+    LENGTH_META_KEY,
+    LOAD3D_CAMERA_TYPE,
+    LOAD3D_MODEL_INFO_TYPE,
+    MASK_TYPE,
+    MAX_CURVE_POINTS,
+    MEBIBYTE,
+    MESH_TYPE,
+    MODEL3D_FILE_DECODER_ID,
+    MODEL3D_TYPE,
+    MODEL_PATCH_TYPE,
+    MODEL_TYPE,
+    MOGE_GEOMETRY_TYPE,
+    MOGE_MODEL_TYPE,
+    NOISE_TYPE,
+    OPTICAL_FLOW_TYPE,
+    PHOTOMAKER_TYPE,
+    PNG_CONTAINER_VERSION,
+    POSE_KEYPOINT_TYPE,
+    POSE_TYPE,
+    REGION_TYPE,
+    RESOLUTION_PREVIEW_TYPE,
+    RESOURCE_HANDLE_TYPE,
+    RESOURCE_ID_META_KEY,
+    RESOURCES_META_KEY,
+    SAM3_TRACK_DATA_TYPE,
+    SAMPLER_TYPE,
+    SEGMENTATION_TYPE,
+    SHAPE_SUBDIVIDES_TYPE,
+    SIGMAS_TYPE,
+    SPLAT_FILE_DECODER_ID,
+    SPLAT_PLY_MIME,
+    SPLAT_TYPE,
+    STYLE_MODEL_TYPE,
+    SVG_TYPE,
+    TIMESTEPS_RANGE_TYPE,
+    TRACKS_TYPE,
+    UPSCALE_MODEL_TYPE,
+    VAE_TYPE,
+    VECTOR_TYPE,
+    VIDEO_AUDIO_WORKING_SET_LIMIT_BYTES,
+    VIDEO_DOCUMENT_TYPE,
+    VIDEO_EDIT_TYPE,
+    VIDEO_FRAME_WORKING_SET_LIMIT_BYTES,
+    VIDEO_TYPE,
+    VOXEL_TYPE,
+    WAN_CAMERA_EMBEDDING_TYPE,
+    BufferEncoding,
+    Curve,
+    CustomWidgetDescriptor,
+    Detection,
+    ImageComponents,
+    ReadableImageSource,
+    Region,
+    Rendition,
+    RenditionSpec,
+    ResourceHandle,
+    TypeId,
+    TypeRegistry,
+    TypeSpec,
+    Value,
+    annotate_image,
+    annotate_mask,
+    array_storage_meta,
+    audio_fingerprint,
+    audio_input,
+    audio_meta,
+    byte_storage_meta,
+    coerce_audio,
+    coerce_detection,
+    coerce_region,
+    coerce_video,
+    copy_media_semantics,
+    curve,
+    decode_audio,
+    decode_detection,
+    decode_image_array,
+    decode_image_components,
+    decode_model3d,
+    decode_model3d_file,
+    decode_region,
+    decode_splat,
+    decode_splat_file,
+    decode_video,
+    detection_meta,
+    edit_video,
+    effective_video_facts,
+    encode_audio,
+    encode_detection,
+    encode_image_array,
+    encode_model3d,
+    encode_region,
+    encode_splat,
+    encode_video,
+    image_array_fingerprint,
+    image_array_meta,
+    image_input,
+    list_children,
+    mask_array_meta,
+    materialize_svg,
+    media_semantics,
+    merge_image_batches,
+    model3d_fingerprint,
+    model3d_format,
+    model3d_meta,
+    open_image_components,
+    parse_ply_splat,
+    prepare_image_array_encoding,
+    region_meta,
+    register_curve_type,
+    register_model3d_type,
+    register_resource_handle_type,
+    register_splat_type,
+    register_video_edit_type,
+    render_audio_wav,
+    render_image_png,
+    render_mask_png,
+    render_model3d_original,
+    render_splat_ply,
+    render_video_original,
+    splat_fingerprint,
+    splat_meta,
+    stable_hash,
+    storage_dtype,
+    timeline_video,
+    validate_image_encoded,
+    validate_model3d_encoded,
+    validate_splat_encoded,
+    validate_video_encoded,
+    video_document,
+    video_fingerprint,
+    video_from_source,
+    video_meta,
+    video_rendition_mime,
+)
+from dinkster_values.audio_codec import (
+    AudioWindowReader,
+    append_audio_edit,
+    audio_from_source,
+    audio_window,
+    effective_audio_facts,
+)
+from dinkster_values.audio_lazy import channel_layout as audio_channel_layout
+from dinkster_video import (
+    DITHERS,
+    FRAME_FORMATS,
+    assemble_video,
+    concatenate_video,
+    disassemble_video,
+    iter_video_pixels,
+    read_video_metadata,
+    save_frame_records,
+    save_video_frames,
+    save_video_stream,
+)
+
+_VIDEO_MODULE_EXPORTS = frozenset(
+    {"image_math", "timeline_document", "timeline_render", "timeline_runtime"}
+)
+_PACK_MEDIA_EXPORTS = {
+    "IMAGE_DOCUMENT_MEDIA_TYPE": "dinkster_image_document.format",
+    "BLEND_MODES": "dinkster_image_document.format",
+    "canonical_json": "dinkster_image_document.format",
+    "ordered_layer_ids": "dinkster_image_document.format",
+    "ImageDocument": "dinkster_image_document.document",
+    "apply_commands": "dinkster_image_document.document",
+    "append_raster": "dinkster_image_document.document",
+    "document_meta": "dinkster_image_document.document",
+    "empty_document": "dinkster_image_document.document",
+    "flatten": "dinkster_image_document.document",
+    "raster_png": "dinkster_image_document.document",
+    "blend": "dinkster_image_document.blend",
+    "dissolve_alpha": "dinkster_image_document.blend",
+    "linear_to_srgb": "dinkster_image_document.blend",
+    "srgb_to_linear": "dinkster_image_document.blend",
+    "from_comfy_layers": "dinkster_image_document.compat",
+    "register_comfy_compositor": "dinkster_image_document.compat",
+    "register_comfy_layers": "dinkster_image_document.compat",
+    "export_ora": "dinkster_image_document.interchange",
+    "export_psd": "dinkster_image_document.interchange",
+    "load_document": "dinkster_image_document.interchange",
+    "current_execution_context": "dinkster_workers.execution",
+}
+
+
+def __getattr__(name: str) -> object:
+    if name in _PACK_MEDIA_EXPORTS:
+        value = getattr(import_module(_PACK_MEDIA_EXPORTS[name]), name)
+    elif name in _VIDEO_MODULE_EXPORTS:
+        import dinkster_video
+
+        value = getattr(dinkster_video, name)
+    elif name in {"LatentStream", "MultiStreamLatent"}:
+        from dinkster_inference_wire import latents
+
+        value = getattr(latents, name)
+    elif name in {
+        "register_inference_types",
+        "materialize_audio",
+        "materialize_image",
+        "materialize_latent",
+        "materialize_clip_vision_output",
+        "materialize_splat",
+        "materialize_voxel",
+    }:
+        from dinkster_inference_wire import types
+
+        value = getattr(types, name)
+    elif name == "initialize_inference_process":
+        from dinkster_inference_wire.process import initialize_inference_process
+
+        value = initialize_inference_process
+    else:
+        raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+    globals()[name] = value
+    return value
+
+
+def __dir__() -> list[str]:
+    return sorted(
+        set(globals())
+        | _VIDEO_MODULE_EXPORTS
+        | _PACK_MEDIA_EXPORTS.keys()
+        | {
+            "LatentStream",
+            "MultiStreamLatent",
+            "register_inference_types",
+            "materialize_audio",
+            "materialize_image",
+            "materialize_latent",
+            "materialize_clip_vision_output",
+            "materialize_splat",
+            "materialize_voxel",
+            "initialize_inference_process",
+        }
+    )
+
+
+if TYPE_CHECKING:
+    from dinkster_image_document.blend import blend, dissolve_alpha, linear_to_srgb, srgb_to_linear
+    from dinkster_image_document.compat import (
+        from_comfy_layers,
+        register_comfy_compositor,
+        register_comfy_layers,
+    )
+    from dinkster_image_document.document import (
+        ImageDocument,
+        append_raster,
+        apply_commands,
+        document_meta,
+        empty_document,
+        flatten,
+        raster_png,
+    )
+    from dinkster_image_document.format import (
+        BLEND_MODES,
+        IMAGE_DOCUMENT_MEDIA_TYPE,
+        canonical_json,
+        ordered_layer_ids,
+    )
+    from dinkster_image_document.interchange import export_ora, export_psd, load_document
+    from dinkster_inference_wire.latents import LatentStream, MultiStreamLatent
+    from dinkster_inference_wire.process import initialize_inference_process
+    from dinkster_inference_wire.types import (
+        materialize_audio,
+        materialize_clip_vision_output,
+        materialize_image,
+        materialize_latent,
+        materialize_splat,
+        materialize_voxel,
+        register_inference_types,
+    )
+    from dinkster_video import document as timeline_document
+    from dinkster_video import image_math, timeline_runtime
+    from dinkster_video import timeline as timeline_render
+    from dinkster_workers.execution import current_execution_context
+
+__all__ = [
+    "IMAGE_DOCUMENT_MEDIA_TYPE",
+    "BLEND_MODES",
+    "ImageDocument",
+    "append_raster",
+    "apply_commands",
+    "blend",
+    "canonical_json",
+    "current_execution_context",
+    "dissolve_alpha",
+    "document_meta",
+    "empty_document",
+    "export_ora",
+    "export_psd",
+    "flatten",
+    "from_comfy_layers",
+    "linear_to_srgb",
+    "load_document",
+    "ordered_layer_ids",
+    "raster_png",
+    "register_comfy_compositor",
+    "register_comfy_layers",
+    "srgb_to_linear",
+    "RunExecutionContext",
+    "obtain_resident",
+    "Expansion",
+    "ExpansionBuilder",
+    "ExpansionNode",
+    "ExpansionOutput",
+    "LatentStream",
+    "MultiStreamLatent",
+    "initialize_inference_process",
+    "prepare_sampling_model",
+    "materialize_audio",
+    "materialize_clip_vision_output",
+    "materialize_image",
+    "materialize_latent",
+    "materialize_splat",
+    "materialize_svg",
+    "materialize_voxel",
+    "register_inference_types",
+    "FrontendContribution",
+    "FrontendModule",
+    "JsonField",
+    "JsonObjectSchema",
+    "PackEvent",
+    "PackRoute",
+    "report_pack_event",
+    "DITHERS",
+    "ENCODED_MEDIA_LIMIT_BYTES",
+    "FRAME_FORMATS",
+    "GIBIBYTE",
+    "IMAGE_WORKING_SET_LIMIT_BYTES",
+    "MEBIBYTE",
+    "read_video_metadata",
+    "save_video_frames",
+    "curve",
+    "timeline_video",
+    "video_document",
+    "image_math",
+    "timeline_document",
+    "timeline_render",
+    "timeline_runtime",
+    "assemble_video",
+    "concatenate_video",
+    "disassemble_video",
+    "iter_video_pixels",
+    "save_frame_records",
+    "save_video_stream",
+    "VIDEO_AUDIO_WORKING_SET_LIMIT_BYTES",
+    "VIDEO_FRAME_WORKING_SET_LIMIT_BYTES",
+    # -- extension declarations and behavior identity (dinkster-protocol)
+    "EXTENSION_CAPABILITIES",
+    "EXTENSION_SCOPES",
+    "ActiveExtension",
+    "BehaviorValue",
+    "CompositionMode",
+    "ContributionSurfaceDescriptor",
+    "ExtensionDeclaration",
+    "ExtensionEntryPoints",
+    "ExtensionScope",
+    "ExtensionSnapshot",
+    "GuidancePhase",
+    "GuidancePhaseParticipation",
+    "GuidanceRegistrySnapshot",
+    "canonical_extension_snapshot",
+    "extension_behavior_hash",
+    # -- training session boundary values (dinkster-protocol)
+    "TrainingSessionHandle",
+    "ExportSnapshot",
+    "current_export_snapshot",
+    # -- node authoring (dinkster-schema)
+    "ABSENT",
+    "BLOCKED",
+    "AbsentOutput",
+    "AbsentPolicy",
+    "BooleanWidget",
+    "ColorWidget",
+    "CompositorWidget",
+    "ConditionalWidgetCondition",
+    "ConditionalWidgetGroup",
+    "CurveWidget",
+    "ComboOption",
+    "ComboWidget",
+    "ControlAfterGenerate",
+    "CustomWidgetDescriptor",
+    "Deprecation",
+    "DynamicComboOption",
+    "DynamicComboSpec",
+    "DynamicSlotSpec",
+    "InputFamilyOptionSource",
+    "InputFamilyMapping",
+    "InputFamilyMember",
+    "InputFamilySpec",
+    "InputSpec",
+    "MirrorSpec",
+    "MirrorTolerance",
+    "MountWidget",
+    "MultiComboWidget",
+    "MappingSource",
+    "Node",
+    "NodeOutputError",
+    "NodeSchema",
+    "NumberWidget",
+    "OutputCountSpec",
+    "OutputDescriptorsSpec",
+    "OutputFamilyMapping",
+    "OutputFamilyMember",
+    "OutputFamilySpec",
+    "OutputInterface",
+    "OutputKnownValue",
+    "OutputProbeSpec",
+    "OutputRepresents",
+    "OutputSpec",
+    "ReplacementCase",
+    "ReplacementLink",
+    "ReplacementMigration",
+    "ReplacementNode",
+    "ReplacementPredicate",
+    "ReplacementRule",
+    "SearchVisibility",
+    "SelectorSpec",
+    "SlotValue",
+    "SlotVariant",
+    "SourceFilenameSpec",
+    "StringWidget",
+    "TextCompletionItem",
+    "TextCompletionKind",
+    "TextCompletions",
+    "TypeExpr",
+    "ValueTransform",
+    "WidgetRepresentation",
+    "WidgetRepresentations",
+    "SCHEMA_WIRE_VERSION",
+    "output_descriptor_entries",
+    "schema_from_wire",
+    "schema_signature",
+    "schema_to_wire",
+    # -- reporting and logging (dinkster-schema)
+    "LOG_EVENT",
+    "PREVIEW_EVENT",
+    "PROGRESS_EVENT",
+    "pack_logger",
+    "attach_saved_artifact",
+    "publish_preview_artifact",
+    "publish_saved_file_preview",
+    "report_event",
+    "report_log",
+    "report_preview",
+    "report_progress",
+    "report_value_diagnostic",
+    # -- value types and codecs (dinkster-values)
+    "CORE_BOOLEAN",
+    "CORE_COMBO",
+    "CORE_FLOAT",
+    "CORE_INT",
+    "CORE_STRING",
+    "ASSET_TYPE",
+    "AUDIO_RECORD_TYPE",
+    "AUDIO_ENCODER_OUTPUT_TYPE",
+    "AUDIO_ENCODER_TYPE",
+    "AUDIO_TYPE",
+    "ARRAY_TYPE",
+    "CAMERA_INFO_STATE_TYPE",
+    "CLIP_TYPE",
+    "CLIP_VISION_OUTPUT_TYPE",
+    "CLIP_VISION_TYPE",
+    "COLORS_TYPE",
+    "COLOR_TYPE",
+    "COMPOSITOR_TYPE",
+    "CONDITIONING_TYPE",
+    "CONTROL_NET_TYPE",
+    "COST_META_KEY",
+    "CURVE_TYPE",
+    "DETECTION_TYPE",
+    "DICT_TYPE",
+    "FLOATS_TYPE",
+    "GLIGEN_TYPE",
+    "HISTOGRAM_TYPE",
+    "PHOTOMAKER_TYPE",
+    "GUIDER_TYPE",
+    "HOOK_KEYFRAMES_TYPE",
+    "HOOKS_TYPE",
+    "IC_LORA_PARAMETERS_TYPE",
+    "IMAGE_DOCUMENT_TYPE",
+    "IMAGE_TYPE",
+    "IMPACT_BASIC_PIPE_TYPE",
+    "INFERENCE_LATENT_OPERATION_TYPE",
+    "INTERP_MODEL_TYPE",
+    "LATENT_OPERATION_TYPE",
+    "LATENT_TYPE",
+    "LATENT_UPSCALE_MODEL_TYPE",
+    "LAYERS_TYPE",
+    "LOAD3D_CAMERA_TYPE",
+    "LOAD3D_MODEL_INFO_TYPE",
+    "MASK_TYPE",
+    "MODEL3D_TYPE",
+    "MODEL_PATCH_TYPE",
+    "MODEL_TYPE",
+    "NOISE_TYPE",
+    "OPTICAL_FLOW_TYPE",
+    "POSE_KEYPOINT_TYPE",
+    "POSE_TYPE",
+    "IMAGE_BATCH_MERGER_ID",
+    "INLINE_STRING_CAP",
+    "ImageComponents",
+    "LENGTH_META_KEY",
+    "MAX_CURVE_POINTS",
+    "MODEL3D_FILE_DECODER_ID",
+    "PNG_CONTAINER_VERSION",
+    "REGION_TYPE",
+    "RESOLUTION_PREVIEW_TYPE",
+    "RESOURCE_HANDLE_TYPE",
+    "SAMPLER_TYPE",
+    "SAM3_TRACK_DATA_TYPE",
+    "SAVE_TARGET_TYPE",
+    "SEGMENTATION_TYPE",
+    "SIGMAS_TYPE",
+    "SPLAT_TYPE",
+    "STYLE_MODEL_TYPE",
+    "SVG_TYPE",
+    "TIMESTEPS_RANGE_TYPE",
+    "TRACKS_TYPE",
+    "UPSCALE_MODEL_TYPE",
+    "WAN_CAMERA_EMBEDDING_TYPE",
+    "VAE_TYPE",
+    "VECTOR_TYPE",
+    "VIDEO_DOCUMENT_TYPE",
+    "VIDEO_TYPE",
+    "VIDEO_EDIT_TYPE",
+    "VOXEL_TYPE",
+    "BACKGROUND_REMOVAL_TYPE",
+    "BOUNDING_BOX_TYPE",
+    "BOUNDING_BOXES_TYPE",
+    "IMAGECOMPARE_TYPE",
+    "COMFY_ARRAY_TYPE",
+    "CONTEXT_WINDOWS_TYPE",
+    "INPAINT_CONDITIONING_TYPE",
+    "MESH_TYPE",
+    "MOGE_GEOMETRY_TYPE",
+    "MOGE_MODEL_TYPE",
+    "SHAPE_SUBDIVIDES_TYPE",
+    "RESOURCES_META_KEY",
+    "RESOURCE_ID_META_KEY",
+    "SPLAT_FILE_DECODER_ID",
+    "SPLAT_PLY_MIME",
+    "BufferEncoding",
+    "Curve",
+    "Detection",
+    "Region",
+    "Rendition",
+    "RenditionSpec",
+    "ResourceHandle",
+    "ReadableImageSource",
+    "TypeId",
+    "TypeRegistry",
+    "TypeSpec",
+    "register_curve_type",
+    "register_video_edit_type",
+    "AudioWindowReader",
+    "append_audio_edit",
+    "audio_channel_layout",
+    "audio_fingerprint",
+    "audio_from_source",
+    "audio_meta",
+    "audio_window",
+    "array_storage_meta",
+    "audio_input",
+    "byte_storage_meta",
+    "coerce_audio",
+    "effective_audio_facts",
+    "coerce_detection",
+    "coerce_region",
+    "coerce_video",
+    "decode_audio",
+    "decode_detection",
+    "decode_image_array",
+    "decode_image_components",
+    "open_image_components",
+    "decode_model3d",
+    "decode_model3d_file",
+    "decode_region",
+    "decode_splat",
+    "decode_splat_file",
+    "decode_video",
+    "detection_meta",
+    "edit_video",
+    "effective_video_facts",
+    "encode_audio",
+    "encode_detection",
+    "encode_image_array",
+    "encode_model3d",
+    "encode_region",
+    "encode_splat",
+    "encode_video",
+    "image_array_fingerprint",
+    "image_array_meta",
+    "image_input",
+    "list_children",
+    "Value",
+    "annotate_image",
+    "annotate_mask",
+    "copy_media_semantics",
+    "mask_array_meta",
+    "media_semantics",
+    "validate_image_encoded",
+    "merge_image_batches",
+    "model3d_fingerprint",
+    "model3d_format",
+    "model3d_meta",
+    "parse_ply_splat",
+    "prepare_image_array_encoding",
+    "region_meta",
+    "register_model3d_type",
+    "register_resource_handle_type",
+    "register_splat_type",
+    "render_audio_wav",
+    "render_image_png",
+    "render_mask_png",
+    "render_model3d_original",
+    "render_splat_ply",
+    "render_video_original",
+    "splat_fingerprint",
+    "splat_meta",
+    "storage_dtype",
+    "stable_hash",
+    "validate_model3d_encoded",
+    "validate_splat_encoded",
+    "validate_video_encoded",
+    "video_fingerprint",
+    "video_from_source",
+    "video_meta",
+    "video_rendition_mime",
+    # -- memory policy (dinkster-memory)
+    "ConsumerItem",
+    "FullReleaseResult",
+    "InvocationView",
+    "MeasuredMemory",
+    "PressureSignal",
+    "ReleaseCandidate",
+    "ReservationPlanner",
+    "ReservationRequest",
+    "Shedder",
+    # -- assets (dinkster-assets)
+    "AssetEntry",
+    "AssetError",
+    "AssetIntegrityError",
+    "AssetRef",
+    "AssetResolver",
+    "AssetVault",
+    "LocalAssetRef",
+    "AssetWidget",
+    "AssetWriter",
+    "admit_video_source",
+    "bind_video_value",
+    "FolderListing",
+    "IndexedAssetResolver",
+    "MountSnapshotWriter",
+    "SaveTarget",
+    "SaveTargetWidget",
+    "declared_asset",
+    "digest_bytes",
+    "digest_file",
+    "is_digest",
+    "mount_roots_for_kind",
+    "asset_selection_names",
+    "asset_selection_options",
+    "resolve_asset_selection",
+    "register_asset_type",
+    "register_save_target_type",
+    "register_audio_value_type",
+    "register_video_value_type",
+    "resolver_from_env",
+]