Aether/crates/aether-ai/formats/src/api.rs

pub use crate::contracts::{
    core_error_background_report_kind, core_error_default_client_api_format,
    core_success_background_report_kind, implicit_sync_finalize_report_kind,
    is_openai_responses_stream_plan_kind, is_openai_responses_sync_plan_kind, AiControlPlanRequest,
    ApiOperation, ClientSurface, ExecutionRuntimeAuthContext, CLAUDE_CHAT_STREAM_PLAN_KIND,
    CLAUDE_CHAT_STREAM_SUCCESS_REPORT_KIND, CLAUDE_CHAT_SYNC_ERROR_REPORT_KIND,
    CLAUDE_CHAT_SYNC_FINALIZE_REPORT_KIND, CLAUDE_CHAT_SYNC_PLAN_KIND,
    CLAUDE_CHAT_SYNC_SUCCESS_REPORT_KIND, CLAUDE_CLI_STREAM_PLAN_KIND,
    CLAUDE_CLI_STREAM_SUCCESS_REPORT_KIND, CLAUDE_CLI_SYNC_ERROR_REPORT_KIND,
    CLAUDE_CLI_SYNC_FINALIZE_REPORT_KIND, CLAUDE_CLI_SYNC_PLAN_KIND,
    CLAUDE_CLI_SYNC_SUCCESS_REPORT_KIND, CLAUDE_COUNT_TOKENS_SYNC_PLAN_KIND,
    CLAUDE_COUNT_TOKENS_SYNC_SUCCESS_REPORT_KIND, CODEX_LIVE_STREAM_PLAN_KIND,
    EXECUTION_RUNTIME_STREAM_ACTION, EXECUTION_RUNTIME_STREAM_DECISION_ACTION,
    EXECUTION_RUNTIME_SYNC_ACTION, EXECUTION_RUNTIME_SYNC_DECISION_ACTION,
    GEMINI_CHAT_STREAM_PLAN_KIND, GEMINI_CHAT_STREAM_SUCCESS_REPORT_KIND,
    GEMINI_CHAT_SYNC_ERROR_REPORT_KIND, GEMINI_CHAT_SYNC_FINALIZE_REPORT_KIND,
    GEMINI_CHAT_SYNC_PLAN_KIND, GEMINI_CHAT_SYNC_SUCCESS_REPORT_KIND, GEMINI_CLI_STREAM_PLAN_KIND,
    GEMINI_CLI_STREAM_SUCCESS_REPORT_KIND, GEMINI_CLI_SYNC_ERROR_REPORT_KIND,
    GEMINI_CLI_SYNC_FINALIZE_REPORT_KIND, GEMINI_CLI_SYNC_PLAN_KIND,
    GEMINI_CLI_SYNC_SUCCESS_REPORT_KIND, GEMINI_EMBEDDING_SYNC_PLAN_KIND,
    GEMINI_EMBEDDING_SYNC_SUCCESS_REPORT_KIND, GEMINI_FILES_DELETE_PLAN_KIND,
    GEMINI_FILES_DOWNLOAD_PLAN_KIND, GEMINI_FILES_GET_PLAN_KIND, GEMINI_FILES_LIST_PLAN_KIND,
    GEMINI_FILES_UPLOAD_PLAN_KIND, GEMINI_INTERACTIONS_STREAM_PLAN_KIND,
    GEMINI_INTERACTIONS_STREAM_SUCCESS_REPORT_KIND, GEMINI_INTERACTIONS_SYNC_ERROR_REPORT_KIND,
    GEMINI_INTERACTIONS_SYNC_FINALIZE_REPORT_KIND, GEMINI_INTERACTIONS_SYNC_PLAN_KIND,
    GEMINI_INTERACTIONS_SYNC_SUCCESS_REPORT_KIND, GEMINI_VIDEO_CANCEL_SYNC_PLAN_KIND,
    GEMINI_VIDEO_CREATE_SYNC_FINALIZE_REPORT_KIND, GEMINI_VIDEO_CREATE_SYNC_PLAN_KIND,
    OPENAI_CHAT_STREAM_PLAN_KIND, OPENAI_CHAT_STREAM_SUCCESS_REPORT_KIND,
    OPENAI_CHAT_SYNC_ERROR_REPORT_KIND, OPENAI_CHAT_SYNC_FINALIZE_REPORT_KIND,
    OPENAI_CHAT_SYNC_PLAN_KIND, OPENAI_CHAT_SYNC_SUCCESS_REPORT_KIND,
    OPENAI_EMBEDDING_SYNC_ERROR_REPORT_KIND, OPENAI_EMBEDDING_SYNC_FINALIZE_REPORT_KIND,
    OPENAI_EMBEDDING_SYNC_PLAN_KIND, OPENAI_EMBEDDING_SYNC_SUCCESS_REPORT_KIND,
    OPENAI_IMAGE_STREAM_PLAN_KIND, OPENAI_IMAGE_STREAM_SUCCESS_REPORT_KIND,
    OPENAI_IMAGE_SYNC_ERROR_REPORT_KIND, OPENAI_IMAGE_SYNC_FINALIZE_REPORT_KIND,
    OPENAI_IMAGE_SYNC_PLAN_KIND, OPENAI_IMAGE_SYNC_SUCCESS_REPORT_KIND,
    OPENAI_REALTIME_STREAM_PLAN_KIND, OPENAI_RERANK_SYNC_PLAN_KIND,
    OPENAI_RESPONSES_COMPACT_STREAM_PLAN_KIND, OPENAI_RESPONSES_COMPACT_STREAM_SUCCESS_REPORT_KIND,
    OPENAI_RESPONSES_COMPACT_SYNC_ERROR_REPORT_KIND,
    OPENAI_RESPONSES_COMPACT_SYNC_FINALIZE_REPORT_KIND, OPENAI_RESPONSES_COMPACT_SYNC_PLAN_KIND,
    OPENAI_RESPONSES_COMPACT_SYNC_SUCCESS_REPORT_KIND, OPENAI_RESPONSES_STREAM_PLAN_KIND,
    OPENAI_RESPONSES_STREAM_SUCCESS_REPORT_KIND, OPENAI_RESPONSES_SYNC_ERROR_REPORT_KIND,
    OPENAI_RESPONSES_SYNC_FINALIZE_REPORT_KIND, OPENAI_RESPONSES_SYNC_PLAN_KIND,
    OPENAI_RESPONSES_SYNC_SUCCESS_REPORT_KIND, OPENAI_SEARCH_SYNC_PLAN_KIND,
    OPENAI_SEARCH_SYNC_SUCCESS_REPORT_KIND, OPENAI_VIDEO_CANCEL_SYNC_PLAN_KIND,
    OPENAI_VIDEO_CONTENT_PLAN_KIND, OPENAI_VIDEO_CREATE_SYNC_FINALIZE_REPORT_KIND,
    OPENAI_VIDEO_CREATE_SYNC_PLAN_KIND, OPENAI_VIDEO_DELETE_SYNC_PLAN_KIND,
    OPENAI_VIDEO_REMIX_SYNC_PLAN_KIND,
};
pub use crate::formats::claude::messages::stream::{ClaudeClientEmitter, ClaudeProviderState};
pub use crate::formats::gemini::generate_content::stream::{
    GeminiClientEmitter, GeminiProviderState,
};
pub use crate::formats::openai::chat::stream::{
    OpenAIChatClientEmitter, OpenAIChatProviderState, OpenAIResponsesClientEmitter,
    OpenAIResponsesProviderState,
};
pub use crate::formats::openai::image::stream::{
    maybe_build_openai_image_sync_finalize_product, OpenAiImageStreamState,
    OpenAiImageSyncFinalizeProduct,
};
pub use crate::formats::openai::prompt_cache::resolve_openai_prompt_cache_ttl_minutes;
pub use crate::formats::openai::shared::{
    copy_request_number_field, copy_request_number_field_as,
    map_openai_reasoning_effort_to_claude_output, map_openai_reasoning_effort_to_gemini_budget,
    parse_openai_stop_sequences, resolve_openai_chat_max_tokens, value_as_u64,
};
pub use crate::formats::openai::{
    reasoning::{
        validate_openai_reasoning_request, OpenAiReasoningContractViolation,
        OpenAiReasoningViolationKind,
    },
    request_contract::{
        finalize_openai_provider_request,
        finalize_openai_provider_request_with_codex_model_capabilities,
        finalize_openai_provider_request_with_codex_model_capabilities_and_reasoning_replay_policy,
        finalize_openai_provider_request_with_codex_model_capabilities_and_reasoning_replay_policy_for_websocket_continuation,
        validate_openai_provider_request_contract, OpenAiProviderRequestContractViolation,
        OpenAiProviderRequestFinalization,
    },
    responses::{
        normalize_openai_responses_message_item_ids, openai_responses_message_item_id,
        openai_responses_synthetic_reasoning_item_id,
        strip_incompatible_openai_responses_reasoning_items,
        strip_incompatible_openai_responses_reasoning_items_with_policy,
        OpenAiResponsesReasoningReplayPolicy,
    },
};
pub use crate::formats::shared::error_body::{
    build_core_error_body_for_client_format, is_core_error_finalize_kind, LocalCoreSyncErrorKind,
};
pub use crate::formats::shared::image_bridge::{
    build_gemini_image_request_body_from_openai_image_request,
    build_gemini_image_response_from_openai_image_response,
    build_gemini_image_response_from_openai_responses_image_response,
    build_openai_image_provider_body_from_response_stream_sync_body,
    build_openai_image_request_body_from_gemini_image_request,
    build_openai_image_response_from_gemini_response,
    build_openai_image_response_from_response_stream_sync_body, gemini_request_is_image_generation,
    resolve_requested_gemini_image_model_for_request, GeminiImageRequestForOpenAi,
    OpenAiImageRequestForGemini,
};
pub use crate::formats::shared::model_directives::{
    apply_model_directive_mapping_patch, apply_model_directive_overrides_from_model,
    apply_model_directive_overrides_from_request, claude_model_uses_adaptive_effort,
    default_model_directive_mapping_patch, default_model_directive_suffixes,
    default_model_directives_config, extract_gemini_model_from_path,
    gemini_model_uses_thinking_level, model_directive_base_model,
    model_directive_builtin_suffix_supported_for_source_model,
    model_directive_suffix_has_builtin_mapping, normalize_model_directive_model,
    openai_model_supports_prompt_cache_options, parse_model_directive,
    parse_model_directive_with_suffixes, reasoning_effort_supported_for_model, ModelDirective,
    ModelDirectiveSuffixResolution, ModelOverride, ReasoningEffort, ServiceTier,
    CROSS_PROVIDER_MODEL_DIRECTIVE_SUFFIXES, MODEL_DIRECTIVE_API_FORMATS,
    OPENAI_MODEL_DIRECTIVE_SUFFIXES,
};
pub use crate::formats::shared::passthrough::{
    resolve_stream_spec as resolve_local_same_format_stream_spec,
    resolve_sync_spec as resolve_local_same_format_sync_spec, LocalSameFormatProviderFamily,
    LocalSameFormatProviderSpec,
};
pub use crate::formats::shared::request::{
    endpoint_config_forces_upstream_stream_policy, enforce_request_body_stream_field,
    forbid_upstream_streaming_for_provider, force_upstream_streaming_for_provider,
    parse_direct_request_body, resolve_upstream_is_stream_for_provider,
    resolve_upstream_is_stream_from_endpoint_config,
};
pub use crate::formats::shared::request_matrix::{
    build_standard_request_body_from_canonical,
    build_standard_request_body_from_canonical_with_model_directives,
};
pub use crate::formats::shared::response::{
    build_generated_tool_call_id, build_local_success_background_report,
    build_local_success_conversion_background_report, canonicalize_tool_arguments,
    prepare_local_success_response_parts, prepare_local_success_response_parts_owned,
    LocalSyncReportParts,
};
pub use crate::formats::shared::routing::{
    is_matching_stream_http_request, is_matching_stream_request,
    request_path_implies_stream_request, resolve_execution_runtime_stream_plan_kind,
    resolve_execution_runtime_stream_plan_kind_with_client_surface,
    resolve_execution_runtime_sync_plan_kind,
    resolve_execution_runtime_sync_plan_kind_with_client_surface, sanitize_request_path,
    sanitize_request_path_and_query, sanitize_request_query_string,
    supports_stream_execution_decision_kind, supports_sync_execution_decision_kind,
};
pub use crate::formats::shared::sse::{encode_done_sse, encode_json_sse, map_claude_stop_reason};
pub use crate::formats::shared::standard_matrix::normalize_standard_request_to_openai_chat_request;
pub use crate::formats::shared::stream_core::common::*;
pub use crate::formats::shared::stream_core::{
    CanonicalStreamFrame, StreamingStandardFormatMatrix, StreamingStandardTerminalObserver,
};
pub use crate::formats::shared::sync_products::{
    aggregate_claude_stream_sync_response, aggregate_gemini_stream_sync_response,
    aggregate_openai_chat_stream_sync_response, aggregate_openai_responses_stream_sync_response,
    aggregate_standard_chat_stream_sync_response, aggregate_standard_cli_stream_sync_response,
    convert_standard_chat_response, convert_standard_cli_response,
    maybe_build_openai_chat_cross_format_sync_product_from_normalized_payload,
    maybe_build_openai_responses_cross_format_sync_product_from_normalized_payload,
    maybe_build_openai_responses_same_family_sync_body_from_normalized_payload,
    maybe_build_standard_cross_format_sync_product,
    maybe_build_standard_cross_format_sync_product_from_normalized_payload,
    maybe_build_standard_same_format_sync_body_from_normalized_payload,
    maybe_build_standard_sync_finalize_product_from_normalized_payload,
    StandardCrossFormatSyncProduct, StandardSyncFinalizeNormalizedProduct,
};
pub use crate::formats::shared::sync_to_stream::{
    maybe_bridge_standard_sync_json_to_stream, SyncToStreamBridgeOutcome,
};
pub use crate::formats::shared::{
    maybe_build_ai_surface_stream_rewriter, resolve_finalize_stream_rewrite_mode,
    AiSurfaceFinalizeError, AiSurfaceStreamRewriter, FinalizeStreamRewriteMode,
};
pub use crate::formats::{
    claude::messages::{
        resolve_stream_spec as resolve_claude_stream_spec,
        resolve_sync_spec as resolve_claude_sync_spec,
    },
    gemini::generate_content::{
        resolve_stream_spec as resolve_gemini_stream_spec,
        resolve_sync_spec as resolve_gemini_sync_spec,
    },
    openai::{
        embedding::spec::resolve_sync_spec as resolve_openai_embedding_sync_spec,
        responses::{
            codex::{
                apply_codex_openai_compact_terminal_headers,
                apply_codex_openai_responses_chat_body_edits,
                apply_codex_openai_responses_identity_headers,
                apply_codex_openai_responses_lite_header_for_request_body_with_capabilities,
                apply_codex_openai_responses_lite_header_with_capabilities,
                apply_codex_openai_responses_special_body_edits,
                apply_codex_openai_responses_special_body_edits_with_source_model_and_capabilities,
                apply_codex_openai_responses_websocket_continuation_body_edits_with_source_model_and_capabilities,
                apply_codex_openai_special_headers,
                apply_openai_responses_compact_special_body_edits,
                build_codex_model_catalog_metadata, parse_codex_auth_identity,
                project_codex_catalog_model_card, resolve_codex_responses_model_capabilities,
                CodexAuthIdentity, CodexResponsesModelCapabilities,
                CODEX_OPENAI_IMAGE_DEFAULT_MODEL, CODEX_OPENAI_IMAGE_DEFAULT_OUTPUT_FORMAT,
                CODEX_OPENAI_IMAGE_DEFAULT_VARIATION_MODEL,
                CODEX_OPENAI_IMAGE_DEFAULT_VARIATION_PROMPT, CODEX_OPENAI_IMAGE_INTERNAL_MODEL,
            },
            history::{
                hydrate_response_history, record_converted_response_history,
                response_history_is_loaded, response_history_storage_key, ResponseHistoryRecord,
            },
            spec::{
                resolve_stream_spec as resolve_openai_responses_stream_spec,
                resolve_sync_spec as resolve_openai_responses_sync_spec, LocalOpenAiResponsesSpec,
            },
        },
    },
    shared::{
        family::{LocalStandardSourceFamily, LocalStandardSourceMode, LocalStandardSpec},
        standard_matrix::{
            build_standard_request_body, build_standard_request_body_with_model_directives,
            build_standard_request_body_with_model_directives_and_request_headers,
            build_standard_request_body_with_model_directives_and_request_headers_and_reasoning_replay_policy,
        },
        standard_normalize::{
            build_cross_format_openai_chat_request_body,
            build_cross_format_openai_chat_request_body_with_model_directives,
            build_cross_format_openai_responses_request_body,
            build_cross_format_openai_responses_request_body_with_model_directives,
            build_cross_format_openai_responses_request_body_with_model_directives_and_history_scope,
            build_local_openai_chat_request_body,
            build_local_openai_chat_request_body_with_model_directives,
            build_local_openai_responses_request_body,
            build_local_openai_responses_request_body_with_model_directives,
            is_claude_messages_shaped_body_on_openai_chat_endpoint,
        },
    },
};
pub use crate::formats::{
    gemini::files::spec::{
        resolve_stream_spec as resolve_gemini_files_stream_spec,
        resolve_sync_spec as resolve_gemini_files_sync_spec, LocalGeminiFilesSpec,
    },
    openai::image::{
        request::{
            build_chatgpt_web_image_request_body,
            build_codex_openai_image_api_provider_request_body,
            build_openai_image_api_provider_request_body, build_openai_image_provider_request_body,
            default_model_for_openai_image_operation, is_openai_image_stream_request,
            normalize_openai_image_quality, normalize_openai_image_request,
            normalize_openai_image_request_with_options, openai_image_operation_from_path,
            project_codex_openai_image_api_request_body, project_openai_image_api_request_body,
            resolve_requested_openai_image_model_for_request, ChatGptWebImageRequestError,
            NormalizedOpenAiImageRequest, OpenAiImageNormalizeOptions, OpenAiImageOperation,
            OpenAiImageResponseFormat,
        },
        spec::{
            resolve_stream_spec as resolve_local_image_stream_spec,
            resolve_sync_spec as resolve_local_image_sync_spec, LocalOpenAiImageSpec,
        },
    },
    shared::video::{
        resolve_sync_spec as resolve_local_video_sync_spec, LocalVideoCreateFamily,
        LocalVideoCreateSpec,
    },
};
pub use crate::provider_compat::kiro_stream::{
    build_kiro_final_message_sse_events, build_kiro_initial_sse_events,
    build_kiro_stream_error_sse_events, calculate_kiro_context_input_tokens,
    encode_kiro_sse_events, estimate_kiro_tokens, find_kiro_real_thinking_end_tag,
    find_kiro_real_thinking_end_tag_at_buffer_end, find_kiro_real_thinking_start_tag, kiro_crc32,
    KiroToClaudeCliStreamState, KIRO_MAX_THINKING_BUFFER,
};
pub use crate::provider_compat::private_envelope::{
    extract_provider_private_stream_error_body, maybe_build_provider_private_stream_normalizer,
    normalize_provider_private_report_context, normalize_provider_private_response_value,
    provider_private_response_allows_sync_finalize, stream_body_contains_error_event,
    transform_provider_private_stream_line, ProviderPrivateStreamNormalizer,
};
pub use crate::provider_compat::surfaces::{
    provider_adaptation_allows_sync_finalize_envelope, provider_adaptation_anchor_api_format,
    provider_adaptation_descriptor_for_envelope, provider_adaptation_descriptor_for_provider_type,
    provider_adaptation_requires_eventstream_accept,
    provider_adaptation_should_unwrap_stream_envelope, ProviderAdaptationDescriptor,
    ProviderAdaptationSurface, ANTIGRAVITY_V1INTERNAL_ENVELOPE_NAME,
    GEMINI_CLI_V1INTERNAL_ENVELOPE_NAME, KIRO_ENVELOPE_NAME,
};
pub use aether_ai_formats::formats::conversion::request::{
    convert_openai_chat_request_to_claude_request, convert_openai_chat_request_to_gemini_request,
    convert_openai_chat_request_to_openai_responses_request, extract_openai_text_content,
    normalize_claude_request_to_openai_chat_request,
    normalize_gemini_request_to_openai_chat_request,
    normalize_openai_responses_request_to_openai_chat_request,
    normalize_openai_responses_request_to_openai_chat_request_with_history_scope,
    parse_openai_tool_result_content,
};
pub use aether_ai_formats::formats::conversion::response::{
    build_openai_responses_response, build_openai_responses_response_with_content,
    build_openai_responses_response_with_reasoning, convert_claude_chat_response_to_openai_chat,
    convert_claude_response_to_openai_responses, convert_gemini_chat_response_to_openai_chat,
    convert_gemini_response_to_openai_responses, convert_openai_chat_response_to_claude_chat,
    convert_openai_chat_response_to_gemini_chat, convert_openai_chat_response_to_openai_responses,
    convert_openai_responses_response_to_openai_chat, OpenAiResponsesResponseUsage,
};
pub use aether_ai_formats::{
    api_format_alias_matches, api_format_permission_covers, api_format_permission_storage_aliases,
    api_format_storage_aliases, intersect_api_format_allowed_lists,
    is_openai_responses_compact_format, is_openai_responses_family_format,
    is_openai_responses_format, normalize_api_format_alias,
};
pub use aether_ai_formats::{
    canonical_request_unknown_block_count, canonical_response_unknown_block_count,
    canonical_to_claude_request, canonical_to_claude_response, canonical_to_gemini_request,
    canonical_to_gemini_response, canonical_to_openai_chat_request,
    canonical_to_openai_chat_response, canonical_to_openai_responses_compact_request,
    canonical_to_openai_responses_compact_response, canonical_to_openai_responses_request,
    canonical_to_openai_responses_response, canonical_unknown_block_count, convert_request,
    convert_request_pure, convert_request_pure_with_context, convert_response,
    convert_response_pure, emit_request_pure, emit_response_pure, from_claude_to_canonical_request,
    from_claude_to_canonical_response, from_gemini_to_canonical_request,
    from_gemini_to_canonical_response, from_openai_chat_to_canonical_request,
    from_openai_chat_to_canonical_response, from_openai_responses_to_canonical_request,
    from_openai_responses_to_canonical_response, is_gemini_interactions_api_format,
    parse_request_pure, parse_response_pure, request_candidate_api_format_preference,
    request_candidate_api_formats, request_conversion_kind,
    request_conversion_requires_enable_flag, sync_chat_response_conversion_kind,
    sync_cli_response_conversion_kind, CanonicalContentBlock, CanonicalGenerationConfig,
    CanonicalInstruction, CanonicalMessage, CanonicalRequest, CanonicalResponse,
    CanonicalResponseFormat, CanonicalResponseOutput, CanonicalRole, CanonicalStopReason,
    CanonicalThinkingConfig, CanonicalToolChoice, CanonicalToolDefinition, CanonicalUsage,
    ConversionFieldRecord, ConversionFieldStatus, ConversionReport, Converted, FormatContext,
    FormatError, FormatFamily, FormatId, FormatProfile, RequestConversionKind,
    SyncChatResponseConversionKind, SyncCliResponseConversionKind,
};