plm-engine-core 1.0.2__tar.gz → 1.0.4__tar.gz

{plm_engine_core-1.0.2 → plm_engine_core-1.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plm-engine-core
-Version: 1.0.2
+Version: 1.0.4
 Summary: TracePulse PLM Engine Core — control_plane (governance, autonomy, HITL, run lifecycle, trace propagation) + agent_runtime (selector, dispatcher, retry, escalation). US-CR.1 scaffold; behaviour lands in US-CR.0+. Internal one-way import contract: control_plane MUST NOT import from agent_runtime (mechanical enforcement in US-CR.2).
 Author: TracePulse
 License: Proprietary

{plm_engine_core-1.0.2 → plm_engine_core-1.0.4}/plm_engine_core/core_host/main.py

@@ -59,6 +59,7 @@ from __future__ import annotations
 import argparse
 import logging
 import os
+from pathlib import Path
 from typing import List, Optional
 
 from fastapi import FastAPI
@@ -170,17 +171,6 @@ def _maybe_load_knowledge(host_settings: EngineHostSettings) -> None:
     # wire_default_bindings).
     from plm_shared.protocols.services.settings import settings
 
-    corpus_path = (
-        host_settings.engine_host_dictionnaries_path
-        or getattr(settings, "dictionnaries_path", "")
-    )
-    if not corpus_path:
-        raise RuntimeError(
-            "engine_host_knowledge: settings.dictionnaries_path is empty; "
-            "set ENGINE_HOST_DICTIONNARIES_PATH or configure dictionnaries_path "
-            "on the registered Settings instance."
-        )
-
     try:
         from plm_knowledge.knowledge_pack_loader import KnowledgePackLoader
         from plm_knowledge.knowledge_search_engine import (
@@ -192,7 +182,47 @@ def _maybe_load_knowledge(host_settings: EngineHostSettings) -> None:
             f"engine_host_knowledge: import failure — {exc!r}"
         ) from exc
 
-    loader = KnowledgePackLoader(corpus_path)
+    # Wave 11+ — corpus resolution chain:
+    #   1. host_settings.engine_host_dictionnaries_path (env
+    #      ENGINE_HOST_DICTIONNARIES_PATH) — explicit override
+    #   2. settings.dictionnaries_path from DI — usually populated
+    #      via DICTIONNARIES_PATH env var; legacy default
+    #      "../../01_Dictionnaries" is broken from any modern CWD and
+    #      treated as "no preference" below
+    #   3. plm-knowledge v1.1.0+ bundled corpus (KnowledgePackLoader
+    #      no-arg default resolves to <site-packages>/plm_knowledge/
+    #      dictionnaries/) — the only path with a guarantee of
+    #      existence on a fresh install
+    explicit_path = (
+        host_settings.engine_host_dictionnaries_path
+        or getattr(settings, "dictionnaries_path", "")
+    )
+    # The legacy ``../../01_Dictionnaries`` default carried by the
+    # pydantic-settings Settings class points at a monorepo layout
+    # that no longer exists; treat it as unset.
+    if explicit_path in ("", "../../01_Dictionnaries", "../01_Dictionnaries"):
+        explicit_path = ""
+    # Verify the resolved path exists; if not, fall through to bundled.
+    if explicit_path and not Path(explicit_path).exists():
+        logger.warning(
+            "engine_host_knowledge: configured path %s does not exist; "
+            "falling back to plm-knowledge bundled corpus",
+            explicit_path,
+        )
+        explicit_path = ""
+
+    if explicit_path:
+        loader = KnowledgePackLoader(explicit_path)
+        corpus_path = explicit_path
+    else:
+        # v1.1.0+ bundled corpus (no-arg default in KnowledgePackLoader)
+        loader = KnowledgePackLoader()
+        corpus_path = str(loader.root)
+        logger.info(
+            "engine_host_knowledge: using plm-knowledge bundled corpus at %s",
+            corpus_path,
+        )
+
     loader.load()
     engine = KnowledgeSearchEngine(loader)
     set_engine(engine)

plm_engine_core-1.0.4/plm_engine_core/llm_catalog/model_list.yaml

@@ -0,0 +1,57 @@
+# US-471.15: Single source of truth for the LLM model catalog.
+#
+# Adding, removing, or reconfiguring a model is a one-file pull request — no
+# Python change required. The backend dispatcher, the model picker, and the
+# pricing layer all read from here.
+#
+# Schema:
+#   id              LiteLLM-prefixed identifier; supports `${ENV_VAR}` tokens.
+#   provider        One of: azure-openai | gemini | openai
+#   api_key_env     Documentation-only: which env var gates availability.
+#   display_label   Human-readable label shown in the picker.
+#   description     Optional caption shown beneath the label.
+#   aliases         Optional alternate ids (used to resolve legacy values).
+#   is_default      At most one per provider should be marked as default.
+#   notes           Optional free text surfaced in admin tooling.
+#   cost_per_input_token / cost_per_output_token  Optional overrides used by
+#       services/pricing_service.py when LiteLLM has no price; consumed by
+#       Slice S8 (US-471.8).
+
+version: 1
+
+models:
+  # ----- Azure OpenAI -----
+  - id: azure/${AZURE_OPENAI_DEPLOYMENT}
+    provider: azure-openai
+    api_key_env: AZURE_OPENAI_API_KEY
+    display_label: Azure OpenAI (default deployment)
+    description: Primary Azure OpenAI deployment driven by AZURE_OPENAI_DEPLOYMENT
+    is_default: true
+    aliases:
+      - gpt-4  # legacy Agent.model_id
+
+  - id: azure/gpt-4o-mini
+    provider: azure-openai
+    api_key_env: AZURE_OPENAI_API_KEY
+    display_label: GPT-4o Mini (Azure)
+    description: Fast and cost-effective
+
+  # ----- Gemini -----
+  - id: gemini/gemini-1.5-flash
+    provider: gemini
+    api_key_env: GEMINI_API_KEY
+    display_label: Gemini 1.5 Flash
+    description: Fast Gemini model
+
+  - id: gemini/gemini-1.5-pro
+    provider: gemini
+    api_key_env: GEMINI_API_KEY
+    display_label: Gemini 1.5 Pro
+    description: Most capable Gemini model
+
+  # ----- OpenAI -----
+  - id: openai/gpt-4o
+    provider: openai
+    api_key_env: OPENAI_API_KEY
+    display_label: GPT-4o (OpenAI)
+    description: Most capable OpenAI model