@nhtio/adk

Appearance

2 min read · 491 words

@nhtio/adk/batteries/generation ​

Environment-neutral aggregate barrel for bundled media generation batteries.

Remarks ​

Aggregate barrel for the generation domain: media generation (text→image + image editing) batteries — adapter classes a consumer calls from their own BYO Tool. Mirrors @nhtio/adk/batteries/embeddings in shape: one shared option base (@nhtio/adk/batteries/generation/openai/types!BaseGenerationAdapterOptions) owned by the first engine battery, extended by every later one, plus an identical method surface (generate/edit/isAvailable/preload/reset) across engines.

Today this barrel re-exports:

  • @nhtio/adk/batteries/generation/openai — the OpenAI /v1/images/generations + /v1/images/edits battery (raw fetch, runs anywhere), and owner of the shared option base.
  • @nhtio/adk/batteries/generation/gemini — the native Gemini generativelanguagegenerateContent battery (raw fetch, runs anywhere).
  • @nhtio/adk/batteries/generation/transformers_js — EXPERIMENTAL on-device text→image via transformers.js's DeepSeek Janus (MultiModalityCausalLM.generate_images) family. No WebGPU requirement (environment-neutral, ONNX Runtime auto-selected), but a ~2GB model and minutes-per-image on WASM/CPU — prefer the OpenAI/Gemini engines unless offline is the point.
  • @nhtio/adk/batteries/generation/_shared — the structural contracts and normalization helper (GenerationMediaLike, GenerationImageInput, toBytes) shared across every engine.

_shared's toBytes is re-exported under the domain-qualified name toGenerationBytes (not a bare export *) because @nhtio/adk/batteries/specialists already threads its own structurally-identical toBytes helper through this same top-level @nhtio/adk/batteries aggregate — mirroring the validateOptions rename pattern every battery barrel already uses to stay collision-free.

References ​

BaseGenerationAdapterOptions ​

Re-exports BaseGenerationAdapterOptions

CreateTransformersJsGenerationModel ​

Re-exports CreateTransformersJsGenerationModel

CreateTransformersJsGenerationProcessor ​

Re-exports CreateTransformersJsGenerationProcessor

E_GEMINI_GENERATION_HTTP_ERROR ​

Re-exports E_GEMINI_GENERATION_HTTP_ERROR

E_GEMINI_GENERATION_MALFORMED_RESPONSE ​

Re-exports E_GEMINI_GENERATION_MALFORMED_RESPONSE

E_GEMINI_GENERATION_REQUEST_TIMEOUT ​

Re-exports E_GEMINI_GENERATION_REQUEST_TIMEOUT

E_INVALID_GEMINI_GENERATION_OPTIONS ​

Re-exports E_INVALID_GEMINI_GENERATION_OPTIONS

E_INVALID_OPENAI_GENERATION_OPTIONS ​

Re-exports E_INVALID_OPENAI_GENERATION_OPTIONS

E_INVALID_TRANSFORMERS_JS_GENERATION_OPTIONS ​

Re-exports E_INVALID_TRANSFORMERS_JS_GENERATION_OPTIONS

E_OPENAI_GENERATION_HTTP_ERROR ​

Re-exports E_OPENAI_GENERATION_HTTP_ERROR

E_OPENAI_GENERATION_MALFORMED_RESPONSE ​

Re-exports E_OPENAI_GENERATION_MALFORMED_RESPONSE

E_OPENAI_GENERATION_REQUEST_TIMEOUT ​

Re-exports E_OPENAI_GENERATION_REQUEST_TIMEOUT

E_TRANSFORMERS_JS_GENERATION_ENGINE_ERROR ​

Re-exports E_TRANSFORMERS_JS_GENERATION_ENGINE_ERROR

E_TRANSFORMERS_JS_GENERATION_UNSUPPORTED_OPERATION ​

Re-exports E_TRANSFORMERS_JS_GENERATION_UNSUPPORTED_OPERATION

EDIT_IMAGE_FIELD_NAME ​

Re-exports EDIT_IMAGE_FIELD_NAME

EditOptions ​

Re-exports EditOptions

EncodeRawImageFn ​

Re-exports EncodeRawImageFn

GeminiContent ​

Re-exports GeminiContent

GeminiEditOptions ​

Re-exports GeminiEditOptions

GeminiGenerateContentRequestBody ​

Re-exports GeminiGenerateContentRequestBody

GeminiGenerateContentResponse ​

Re-exports GeminiGenerateContentResponse

GeminiGenerateOptions ​

Re-exports GeminiGenerateOptions

GeminiGenerationAdapter ​

Re-exports GeminiGenerationAdapter

GeminiGenerationAdapterOptions ​

Re-exports GeminiGenerationAdapterOptions

GeminiGenerationConfig ​

Re-exports GeminiGenerationConfig

geminiGenerationOptionsSchema ​

Re-exports geminiGenerationOptionsSchema

GeminiRequestPart ​

Re-exports GeminiRequestPart

GeminiResponseModality ​

Re-exports GeminiResponseModality

GeminiResponsePart ​

Re-exports GeminiResponsePart

GeneratedMediaOutput ​

Re-exports GeneratedMediaOutput

GenerateOptions ​

Re-exports GenerateOptions

GenerationBytesInput ​

Re-exports GenerationBytesInput

GenerationImageInput ​

Re-exports GenerationImageInput

GenerationMediaLike ​

Re-exports GenerationMediaLike

GenerationRetryConfig ​

Re-exports GenerationRetryConfig

OpenAIEditOptions ​

Re-exports OpenAIEditOptions

OpenAIGenerateOptions ​

Re-exports OpenAIGenerateOptions

OpenAIGenerationAdapter ​

Re-exports OpenAIGenerationAdapter

OpenAIGenerationAdapterOptions ​

Re-exports OpenAIGenerationAdapterOptions

openAIGenerationOptionsSchema ​

Re-exports openAIGenerationOptionsSchema

OpenAIImagesGenerationRequestBody ​

Re-exports OpenAIImagesGenerationRequestBody

OpenAIImagesResponse ​

Re-exports OpenAIImagesResponse

toGenerationBytes ​

Renames and re-exports toBytes

TransformersJsGenerateOptions ​

Re-exports TransformersJsGenerateOptions

TransformersJsGenerationAdapter ​

Re-exports TransformersJsGenerationAdapter

TransformersJsGenerationAdapterOptions ​

Re-exports TransformersJsGenerationAdapterOptions

TransformersJsGenerationDataType ​

Re-exports TransformersJsGenerationDataType

TransformersJsGenerationDeviceType ​

Re-exports TransformersJsGenerationDeviceType

TransformersJsGenerationModel ​

Re-exports TransformersJsGenerationModel

TransformersJsGenerationModelSource ​

Re-exports TransformersJsGenerationModelSource

transformersJsGenerationOptionsSchema ​

Re-exports transformersJsGenerationOptionsSchema

TransformersJsGenerationProcessor ​

Re-exports TransformersJsGenerationProcessor

TransformersJsGenerationProgressCallback ​

Re-exports TransformersJsGenerationProgressCallback

TransformersJsRawImageLike ​

Re-exports TransformersJsRawImageLike

validateGeminiGenerationOptions ​

Renames and re-exports validateOptions

validateOpenAIGenerationOptions ​

Renames and re-exports validateOptions

validateTransformersJsGenerationOptions ​

Renames and re-exports validateOptions

Copyright © 2025-present New Horizon Technology LTD