iints-sdk-python35 1.5.8__tar.gz → 1.5.10__tar.gz

{iints_sdk_python35-1.5.8/src/iints_sdk_python35.egg-info → iints_sdk_python35-1.5.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: iints-sdk-python35
-Version: 1.5.8
+Version: 1.5.10
 Summary: A pre-clinical Edge-AI SDK for diabetes management validation.
 Author-email: Rune Bobbaers <rune.bobbaers@gmail.com>
 License-Expression: Apache-2.0
@@ -18,7 +18,7 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 License-File: NOTICE
 License-File: LICENSE-MIT-IINTS-LEGACY
-Requires-Dist: fastapi<1.0.0,>=0.115.0
+Requires-Dist: fastapi!=0.136.3,<1.0.0,>=0.115.0
 Requires-Dist: numpy<3.0.0,>=1.24.0
 Requires-Dist: pandas<3.0.0,>=2.0.0
 Requires-Dist: pydantic<3.0.0,>=2.0.0
@@ -117,13 +117,13 @@ Full documentation: [python35.github.io/IINTS-SDK](https://python35.github.io/II
 
 ## Live Demo
 
-For a Zoom call, jury walkthrough, or sponsor demo where you want to show both the code and the generated outputs in one terminal flow:
+For a Zoom call, jury walkthrough, or sponsor demo where you want the story first and code as proof:
 
 ```bash
-iints demo-live --output-dir results/live_demo
+iints demo eucys --output-dir results/live_demo
 ```
 
-That exports the showable demo script, prints the key SDK calls, runs the demo, and lists the poster plus proof artifacts to open next.
+Use `iints demo doctor` for clinical feedback conversations and `iints demo booth` for public digital-patient demos.
 
 ---
 

{iints_sdk_python35-1.5.8 → iints_sdk_python35-1.5.10}/README.md

@@ -50,13 +50,13 @@ Full documentation: [python35.github.io/IINTS-SDK](https://python35.github.io/II
 
 ## Live Demo
 
-For a Zoom call, jury walkthrough, or sponsor demo where you want to show both the code and the generated outputs in one terminal flow:
+For a Zoom call, jury walkthrough, or sponsor demo where you want the story first and code as proof:
 
 ```bash
-iints demo-live --output-dir results/live_demo
+iints demo eucys --output-dir results/live_demo
 ```
 
-That exports the showable demo script, prints the key SDK calls, runs the demo, and lists the poster plus proof artifacts to open next.
+Use `iints demo doctor` for clinical feedback conversations and `iints demo booth` for public digital-patient demos.
 
 ---
 

{iints_sdk_python35-1.5.8 → iints_sdk_python35-1.5.10}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "iints-sdk-python35" 
-version = "1.5.8"
+version = "1.5.10"
 authors = [
   { name="Rune Bobbaers", email="rune.bobbaers@gmail.com" },
 ]
@@ -24,7 +24,7 @@ classifiers = [
     "Development Status :: 5 - Production/Stable",
 ]
 dependencies = [
-    "fastapi>=0.115.0,<1.0.0",
+    "fastapi>=0.115.0,!=0.136.3,<1.0.0",
     "numpy>=1.24.0,<3.0.0",
     "pandas>=2.0.0,<3.0.0",
     "pydantic>=2.0.0,<3.0.0",
@@ -119,3 +119,8 @@ mdmp_core = [
   "keys/*.pem",
   "data/conformance/vectors/*.json",
 ]
+
+[tool.coverage.run]
+omit = [
+  "src/iints/templates/default_algorithm.py",
+]

{iints_sdk_python35-1.5.8 → iints_sdk_python35-1.5.10}/src/iints/__init__.py

@@ -11,7 +11,7 @@ except ImportError:  # pragma: no cover - Python < 3.8 fallback
 try:
     __version__ = version("iints-sdk-python35")
 except PackageNotFoundError:  # pragma: no cover - source tree fallback
-    __version__ = "1.5.8"
+    __version__ = "1.5.10"
 
 # Note to developers: this SDK is currently maintained by a single author.
 # Please report bugs via GitHub issues and feel free to contribute fixes via PRs.
@@ -211,6 +211,46 @@ def generate_demo_report(
         title="IINTS-AF Demo Report",
     )
 
+def generate_agp_report(
+    simulation_results: 'pd.DataFrame',
+    output_path: Optional[str] = None,
+    safety_report: Optional[dict] = None,
+    subject_name: str = "Research simulation",
+    summary_json_path: Optional[str] = None,
+) -> Optional[str]:
+    """
+    Generate an AGP-style research PDF report from dense CGM/simulation data.
+    """
+    if output_path is None:
+        return None
+    generator = ClinicalReportGenerator()
+    return generator.generate_agp_pdf(
+        simulation_results,
+        output_path,
+        subject_name=subject_name,
+        safety_report=safety_report or {},
+        summary_json_path=summary_json_path,
+    )
+
+def generate_agp_assets(
+    simulation_results: 'pd.DataFrame',
+    output_dir: Optional[str] = None,
+    subject_name: str = "Research simulation",
+    summary_json_path: Optional[str] = None,
+) -> Optional[dict]:
+    """
+    Export AGP-style PNG assets and summary JSON from dense CGM/simulation data.
+    """
+    if output_dir is None:
+        return None
+    generator = ClinicalReportGenerator()
+    return generator.export_agp_assets(
+        simulation_results,
+        output_dir,
+        subject_name=subject_name,
+        summary_json_path=summary_json_path,
+    )
+
 # You can also define __all__ to explicitly control what gets imported with `from iints import *`
 __all__ = [
     # API
@@ -287,6 +327,8 @@ __all__ = [
     "generate_report",
     "generate_quickstart_report",
     "generate_demo_report",
+    "generate_agp_report",
+    "generate_agp_assets",
     "generate_results_poster",
     # High-level API
     "run_simulation",

{iints_sdk_python35-1.5.8 → iints_sdk_python35-1.5.10}/src/iints/ai/__init__.py

@@ -1,7 +1,15 @@
 from .assistant import AIResponse, IINTSAssistant
 from .backends import DEFAULT_MINISTRAL_MODEL, DEFAULT_OLLAMA_HOST, OllamaBackend
 from .mdmp_guard import GuardResult, MDMPGuard
-from .model_catalog import LocalMistralModelProfile, list_local_mistral_models
+from .model_catalog import (
+    DEFAULT_MISTRAL_API_MODEL,
+    DEFAULT_MISTRAL_API_REASONING_EFFORT,
+    LocalMistralModelProfile,
+    MistralAPIMigrationProfile,
+    list_local_mistral_models,
+    list_mistral_api_migrations,
+    migrate_mistral_api_model,
+)
 from .prepare import prepare_ai_ready_artifacts
 
 __all__ = [
@@ -12,7 +20,12 @@ __all__ = [
     "OllamaBackend",
     "GuardResult",
     "MDMPGuard",
+    "DEFAULT_MISTRAL_API_MODEL",
+    "DEFAULT_MISTRAL_API_REASONING_EFFORT",
     "LocalMistralModelProfile",
+    "MistralAPIMigrationProfile",
     "list_local_mistral_models",
+    "list_mistral_api_migrations",
+    "migrate_mistral_api_model",
     "prepare_ai_ready_artifacts",
 ]

{iints_sdk_python35-1.5.8 → iints_sdk_python35-1.5.10}/src/iints/ai/assistant.py

@@ -82,12 +82,20 @@ class IINTSAssistant:
             ollama_backend.ensure_model_ready()
             return local_backend
         if requested == "api":
-            api_backend: CompletionBackend = MistralAPIBackend()
+            api_backend: CompletionBackend = MistralAPIBackend(model_name=model)
             if api_backend.available():
                 return api_backend
+            api_model = getattr(api_backend, "model_name", "mistral-small-latest")
+            api_reasoning = getattr(api_backend, "reasoning_effort", None)
+            reasoning_hint = (
+                f" with reasoning_effort='{api_reasoning}'"
+                if isinstance(api_reasoning, str) and api_reasoning.strip()
+                else ""
+            )
             raise RuntimeError(
                 "Cloud API fallback is not enabled in this SDK build yet. "
-                "Use mode='local' with Ollama."
+                "Use mode='local' with Ollama, or configure an external Mistral client with "
+                f"`{api_model}`{reasoning_hint}."
             )
         raise ValueError(f"Unsupported AI mode: {mode}")
 

iints_sdk_python35-1.5.10/src/iints/ai/backends/mistral_api.py

@@ -0,0 +1,46 @@
+from __future__ import annotations
+
+from ..model_catalog import (
+    DEFAULT_MISTRAL_API_MODEL,
+    DEFAULT_MISTRAL_API_REASONING_EFFORT,
+    migrate_mistral_api_model,
+)
+
+
+class MistralAPIBackend:
+    backend_name = "mistral_api"
+
+    def __init__(
+        self,
+        *,
+        model_name: str = DEFAULT_MISTRAL_API_MODEL,
+        reasoning_effort: str | None = DEFAULT_MISTRAL_API_REASONING_EFFORT,
+        **kwargs,
+    ) -> None:
+        migrated_model, migrated_reasoning, migrated = migrate_mistral_api_model(model_name)
+        self.requested_model_name = model_name
+        self.model_name = migrated_model
+        self.reasoning_effort = migrated_reasoning if migrated_reasoning is not None else reasoning_effort
+        self.model_was_migrated = migrated
+
+    def available(self) -> bool:
+        return False
+
+    def complete(self, *, system_prompt: str, user_prompt: str) -> str:
+        migration_hint = (
+            f" Requested deprecated model '{self.requested_model_name}' was mapped to "
+            f"'{self.model_name}'."
+            if self.model_was_migrated
+            else ""
+        )
+        reasoning_hint = (
+            f" Default Mistral reasoning_effort is '{self.reasoning_effort}'."
+            if self.reasoning_effort
+            else ""
+        )
+        raise RuntimeError(
+            "Cloud fallback is not enabled in this SDK build yet. "
+            "Use mode='local' with Ollama for the open Ministral 3 model, or configure "
+            f"your external Mistral client for '{self.model_name}'."
+            f"{reasoning_hint}{migration_hint}"
+        )

{iints_sdk_python35-1.5.8 → iints_sdk_python35-1.5.10}/src/iints/ai/cli.py

@@ -12,7 +12,13 @@ from typing_extensions import Annotated
 
 from .assistant import AIResponse, IINTSAssistant
 from .backends import DEFAULT_MINISTRAL_MODEL, OllamaBackend
-from .model_catalog import list_local_mistral_models
+from .model_catalog import (
+    DEFAULT_MISTRAL_API_MODEL,
+    DEFAULT_MISTRAL_API_REASONING_EFFORT,
+    STRONG_MISTRAL_API_MODEL,
+    list_local_mistral_models,
+    list_mistral_api_migrations,
+)
 from .prepare import prepare_ai_ready_artifacts
 
 
@@ -183,10 +189,31 @@ def models() -> None:
         )
 
     console.print(table)
+    migration_table = Table(title="Mistral Serverless Migration Guide")
+    migration_table.add_column("Deprecated", style="yellow", overflow="fold")
+    migration_table.add_column("Replacement", style="cyan", no_wrap=True)
+    migration_table.add_column("Reasoning")
+    migration_table.add_column("Retires")
+    migration_table.add_column("Use Case", overflow="fold")
+    for migration_profile in list_mistral_api_migrations():
+        reasoning = migration_profile.reasoning_effort or "n/a"
+        migration_table.add_row(
+            ", ".join(migration_profile.deprecated_models),
+            migration_profile.replacement_model,
+            reasoning,
+            migration_profile.retirement_date,
+            migration_profile.use_case,
+        )
+    console.print(migration_table)
     console.print(
         "[dim]Tip:[/dim] start with "
         f"`{DEFAULT_MINISTRAL_MODEL}` unless you know your hardware can comfortably run a larger local model."
     )
+    console.print(
+        "[dim]Serverless:[/dim] use "
+        f"`{DEFAULT_MISTRAL_API_MODEL}` with `reasoning_effort={DEFAULT_MISTRAL_API_REASONING_EFFORT}` "
+        f"for small reasoning/code tasks, or `{STRONG_MISTRAL_API_MODEL}` for stronger review."
+    )
 
 
 @app.command(name="prepare")

iints_sdk_python35-1.5.10/src/iints/ai/model_catalog.py

@@ -0,0 +1,174 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+from .backends.ollama import DEFAULT_MINISTRAL_MODEL
+
+DEFAULT_MISTRAL_API_MODEL = "mistral-small-latest"
+DEFAULT_MISTRAL_API_REASONING_EFFORT = "high"
+STRONG_MISTRAL_API_MODEL = "mistral-medium-3-5"
+DEFAULT_MISTRAL_OCR_MODEL = "mistral-ocr-latest"
+DEFAULT_MISTRAL_MODERATION_MODEL = "mistral-moderation-2603"
+DEFAULT_MISTRAL_TRANSCRIBE_MODEL = "voxtral-mini-latest"
+
+
+@dataclass(frozen=True)
+class LocalMistralModelProfile:
+    tag: str
+    label: str
+    approx_download_gb: float
+    recommended_system_ram_gb: int
+    recommended_vram_gb: int | None
+    fit: str
+    notes: str
+    aliases: tuple[str, ...] = ()
+
+
+@dataclass(frozen=True)
+class MistralAPIMigrationProfile:
+    deprecated_models: tuple[str, ...]
+    replacement_model: str
+    reasoning_effort: str | None
+    retirement_date: str
+    use_case: str
+    notes: str
+
+
+LOCAL_MISTRAL_MODEL_PROFILES: tuple[LocalMistralModelProfile, ...] = (
+    LocalMistralModelProfile(
+        tag="ministral-3:3b",
+        label="Ministral 3 3B",
+        approx_download_gb=3.0,
+        recommended_system_ram_gb=16,
+        recommended_vram_gb=6,
+        fit="Entry-level laptop / small edge box",
+        notes="Best starting point for CPU-only systems or modest GPUs. Fastest option, lowest memory pressure.",
+        aliases=("ministral-3:3b",),
+    ),
+    LocalMistralModelProfile(
+        tag=DEFAULT_MINISTRAL_MODEL,
+        label="Ministral 3 8B",
+        approx_download_gb=6.0,
+        recommended_system_ram_gb=24,
+        recommended_vram_gb=10,
+        fit="Balanced desktop / strong laptop",
+        notes="Recommended default for most users. Best trade-off between quality, speed, and local memory footprint.",
+        aliases=("ministral", "ministral-3", "ministral-3:8b"),
+    ),
+    LocalMistralModelProfile(
+        tag="ministral-3:14b",
+        label="Ministral 3 14B",
+        approx_download_gb=10.0,
+        recommended_system_ram_gb=32,
+        recommended_vram_gb=16,
+        fit="High-end workstation",
+        notes="Use when you have plenty of RAM or a strong GPU and want better reasoning depth at the cost of latency.",
+        aliases=("ministral-3:14b",),
+    ),
+)
+
+
+MISTRAL_API_MIGRATION_PROFILES: tuple[MistralAPIMigrationProfile, ...] = (
+    MistralAPIMigrationProfile(
+        deprecated_models=("devstral-small-2507", "devstral-small-latest"),
+        replacement_model=DEFAULT_MISTRAL_API_MODEL,
+        reasoning_effort=DEFAULT_MISTRAL_API_REASONING_EFFORT,
+        retirement_date="2026-05-31",
+        use_case="code and agentic helper",
+        notes="Use Mistral Small 4 through the stable latest alias.",
+    ),
+    MistralAPIMigrationProfile(
+        deprecated_models=("devstral-medium-2507", "devstral-2512", "devstral-latest"),
+        replacement_model=STRONG_MISTRAL_API_MODEL,
+        reasoning_effort=DEFAULT_MISTRAL_API_REASONING_EFFORT,
+        retirement_date="2026-05-31 / 2026-07-31",
+        use_case="strong code and research assistant",
+        notes="Use Mistral Medium 3.5 for higher-complexity code/research review.",
+    ),
+    MistralAPIMigrationProfile(
+        deprecated_models=("magistral-small-2509",),
+        replacement_model=DEFAULT_MISTRAL_API_MODEL,
+        reasoning_effort=DEFAULT_MISTRAL_API_REASONING_EFFORT,
+        retirement_date="2026-07-31",
+        use_case="small reasoning",
+        notes="Mistral Small 4 now supports adjustable reasoning.",
+    ),
+    MistralAPIMigrationProfile(
+        deprecated_models=("magistral-medium-2509", "magistral-medium-latest"),
+        replacement_model=STRONG_MISTRAL_API_MODEL,
+        reasoning_effort=DEFAULT_MISTRAL_API_REASONING_EFFORT,
+        retirement_date="2026-07-31",
+        use_case="medium reasoning",
+        notes="Mistral Medium 3.5 supports adjustable reasoning for harder tasks.",
+    ),
+    MistralAPIMigrationProfile(
+        deprecated_models=(
+            "mistral-large-2411",
+            "pixtral-large-2411",
+            "mistral-medium-2505",
+            "mistral-medium-2508",
+        ),
+        replacement_model=STRONG_MISTRAL_API_MODEL,
+        reasoning_effort=DEFAULT_MISTRAL_API_REASONING_EFFORT,
+        retirement_date="2026-05-31 / 2026-08-31",
+        use_case="general strong cloud model",
+        notes="Medium 3.5 is the current stronger general-purpose replacement.",
+    ),
+    MistralAPIMigrationProfile(
+        deprecated_models=("mistral-small-2506",),
+        replacement_model=DEFAULT_MISTRAL_API_MODEL,
+        reasoning_effort=DEFAULT_MISTRAL_API_REASONING_EFFORT,
+        retirement_date="2026-07-31",
+        use_case="small general cloud model",
+        notes="Use the Mistral Small 4 latest alias.",
+    ),
+    MistralAPIMigrationProfile(
+        deprecated_models=("open-mistral-nemo-2407",),
+        replacement_model="ministral-8b-2512",
+        reasoning_effort=None,
+        retirement_date="2026-07-31",
+        use_case="small/low-cost serverless model",
+        notes="Serverless replacement for Nemo. Local SDK defaults still use Ollama `ministral-3:8b`.",
+    ),
+    MistralAPIMigrationProfile(
+        deprecated_models=("mistral-ocr-2505",),
+        replacement_model=DEFAULT_MISTRAL_OCR_MODEL,
+        reasoning_effort=None,
+        retirement_date="2026-05-31",
+        use_case="OCR",
+        notes="Use OCR 3 through the latest alias.",
+    ),
+    MistralAPIMigrationProfile(
+        deprecated_models=("mistral-moderation-2411", "mistral-moderation-latest"),
+        replacement_model=DEFAULT_MISTRAL_MODERATION_MODEL,
+        reasoning_effort=None,
+        retirement_date="2026-06-30",
+        use_case="moderation",
+        notes="Use Mistral Moderation 2.",
+    ),
+    MistralAPIMigrationProfile(
+        deprecated_models=("voxtral-mini-2507",),
+        replacement_model=DEFAULT_MISTRAL_TRANSCRIBE_MODEL,
+        reasoning_effort=None,
+        retirement_date="2026-05-31",
+        use_case="audio transcription",
+        notes="Use Voxtral Mini Transcribe 2.0 through the latest alias.",
+    ),
+)
+
+
+def list_local_mistral_models() -> list[LocalMistralModelProfile]:
+    return list(LOCAL_MISTRAL_MODEL_PROFILES)
+
+
+def list_mistral_api_migrations() -> list[MistralAPIMigrationProfile]:
+    return list(MISTRAL_API_MIGRATION_PROFILES)
+
+
+def migrate_mistral_api_model(model_name: str) -> tuple[str, str | None, bool]:
+    requested = model_name.strip()
+    requested_key = requested.lower()
+    for profile in MISTRAL_API_MIGRATION_PROFILES:
+        if requested_key in {model.lower() for model in profile.deprecated_models}:
+            return profile.replacement_model, profile.reasoning_effort, True
+    return requested, None, False

{iints_sdk_python35-1.5.8 → iints_sdk_python35-1.5.10}/src/iints/analysis/__init__.py

@@ -40,6 +40,7 @@ from .eucys_results import (
     generate_eucys_main_figure,
     generate_eucys_results_bundle,
 )
+from .evidence_bundle import EVIDENCE_SCOPE, build_evidence_bundle
 
 
 def _missing_reports_dependency(feature: str, exc: Exception) -> None:
@@ -100,9 +101,11 @@ __all__ = [
     "analyze_study_directory",
     "build_booth_demo",
     "build_carelink_workbench",
+    "build_evidence_bundle",
     "ClinicalMetricsCalculator",
     "ClinicalMetricsResult",
     "ClinicalReportGenerator",
+    "EVIDENCE_SCOPE",
     "compute_metrics",
     "compare_studies",
     "build_eucys_abstract_draft_markdown",