__init__.py

Go to the documentation of this file.

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
# oc_chat/__init__.py
 
"""
OC Chat — interactive CLI client with a ReAct agentic loop.
 
Purpose
-------
Top-level package marker. Features streaming chat with reasoning
(chain-of-thought), tool use, session management, context
compression, and agentic multi-step planning. Provider-agnostic
since Phase C — the active backend is selected via the
``OC_CHAT_PROVIDER`` env var (default ``deepseek``).
 
Responsibilities
----------------
- Mark ``oc_chat/`` as a Python package.
- Hold the engine subpackages: ``core`` (provider-agnostic engine),
  ``tools`` (filesystem / shell / web / memory / planner / oct),
  ``tests`` (unit + integration suites).
- Provide ``main.py`` as the REPL entry point.
 
Diagnostics
-----------
Domain: OC_CHAT.MAIN
Levels:
    L2 — lifecycle events
    L3 — semantic details
    L4 — deep tracing
 
Contracts
---------
- Module-level L4 ``_dbg`` is a diagnostics-coverage marker; it
  emits nothing at default verbosity (domain default is L2).
 
Dependencies
------------
- oc_diagnostics (structured debug logging via _dbg)
- oc_chat._env_guard (load_dotenv_guarded - loads .env at package import, refusing the security-authority vars)
"""
 
from oc_diagnostics import _dbg
 
# Load .env at package import so module-level env-var reads (e.g.
# persistence.DEFAULT_SESSIONS_DIR) see values from the repo-local
# .env file regardless of which oc_chat.* module the entry point
# imports first. Idempotent: a second call from oc_chat.core.config
# is a no-op for already-set vars.
# M8.0 (F33/F72): a workspace .env may NOT set security-authority vars
# (OC_CHAT_PROFILE, provider *_BASE_URL, OC_CHAT_ALLOW_REMOTE_ENDPOINTS,
# proxy/cert, package-index) -- those are operator-out-of-band only.
from oc_chat._env_guard import load_dotenv_guarded
load_dotenv_guarded()
 
_dbg("OC_CHAT.MAIN", "module", "loaded", 4)