generation_options.py

Go to the documentation of this file.

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
# oc_chat/core/generation_options.py
 
"""
Provider-neutral generation options — harness re-export shim.
 
Purpose
-------
:class:`GenerationOptions` was relocated to the shared leaf
``option_c_agent_contracts.generation_options`` by plan 154 so provider
bundles consume it without importing ``oc_chat``. This module re-exports it
unchanged so the harness call sites (``commands``, ``main``, session
metadata, …) keep their ``from oc_chat.core.generation_options import
GenerationOptions`` import byte-for-byte.
 
Responsibilities
----------------
- Re-export :class:`GenerationOptions` from the contract leaf.
 
Diagnostics
-----------
Domain: OC_CHAT.CTX
Levels:
    L2 — lifecycle events
    L3 — semantic details
    L4 — module load / deep tracing
 
Contracts
---------
- The re-exported ``GenerationOptions`` is the identical object to the
  leaf's — validation and ``model_dump`` behaviour are unchanged.
 
Dependencies
------------
- oc_diagnostics (structured debug logging via _dbg)
- option_c_agent_contracts.generation_options (the relocated model)
"""
from __future__ import annotations
 
from oc_diagnostics import _dbg
 
from option_c_agent_contracts.generation_options import GenerationOptions
 
_dbg("OC_CHAT.CTX", "module", "loaded", 4)
 
__all__ = ["GenerationOptions"]